diff --git a/.coveragerc b/.coveragerc
index 6a18f761d2c4..8aff2b6744ca 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -6,7 +6,8 @@ omit =
     */_generated/*.py
     # Packages in the "google.cloud" package that we don't own.
     */google/cloud/gapic/*
-fail_under = 100
+    */google/cloud/grpc/*
+    */google/cloud/proto/*
 show_missing = True
 exclude_lines =
     # Re-enable the standard pragma
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 000000000000..fcf34e569555
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1,52 @@
+# Code owners file.
+# This file controls who is tagged for review for any given pull request.
+
+# Bu Sun Kim is the default owner for anything not explicitly
+# taken by someone else.
+*                         @busunkim96
+
+##################################
+# Storage and Database (SoDa) team 
+##################################
+bigtable/                   @tseaver @crwilcox @frankyn
+docs/bigtable/              @tseaver @crwilcox @frankyn
+
+datastore/                  @tseaver @crwilcox @frankyn      
+docs/datastore              @tseaver @crwilcox @frankyn 
+
+storage/                    @tseaver @crwilcox @frankyn
+docs/storage                @tseaver @crwilcox @frankyn
+
+firestore/                  @tseaver @crwilcox @frankyn
+docs/firestore/             @tseaver @crwilcox @frankyn
+
+spanner/                    @tseaver @crwilcox @frankyn
+docs/spanner                @tseaver @crwilcox @frankyn
+
+###############################
+# Analytics and ML (AniML) team
+###############################
+
+# BigQuery suite of APIs
+bigquery/                   @googleapis/api-bigquery
+docs/bigquery/              @googleapis/api-bigquery
+
+bigquery_datatransfer/      @googleapis/api-bigquery
+docs/bigquery_datatransfer/ @googleapis/api-bigquery
+
+bigquery_storage/           @googleapis/api-bigquery
+docs/bigquery_storage/      @googleapis/api-bigquery
+
+# Pubsub
+pubsub/                     @anguillanneuf @plamut
+docs/pubsub                 @anguillanneuf @plamut
+
+
+# Tim Swast is the primary author of Runtime Config.
+runtimeconfig/              @tswast
+docs/runtimeconfig/         @tswast
+
+
+# Doug Greiman and Angela Li are the owners of trace.
+trace/                      @liyanhui1228 @duggelz
+docs/trace/                 @liyanhui1228 @duggelz
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
new file mode 100644
index 000000000000..939e5341e74d
--- /dev/null
+++ b/.github/CONTRIBUTING.md
@@ -0,0 +1,28 @@
+# How to Contribute
+
+We'd love to accept your patches and contributions to this project. There are
+just a few small guidelines you need to follow.
+
+## Contributor License Agreement
+
+Contributions to this project must be accompanied by a Contributor License
+Agreement. You (or your employer) retain the copyright to your contribution;
+this simply gives us permission to use and redistribute your contributions as
+part of the project. Head over to <https://cla.developers.google.com/> to see
+your current agreements on file or to sign a new one.
+
+You generally only need to submit a CLA once, so if you've already submitted one
+(even if it was for a different project), you probably don't need to do it
+again.
+
+## Code reviews
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult
+[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
+information on using pull requests.
+
+## Community Guidelines
+
+This project follows [Google's Open Source Community
+Guidelines](https://opensource.google.com/conduct/).
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 000000000000..1ca956493631
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+Thanks for stopping by to let us know something could be better!
+
+**PLEASE READ**: If you have a support contract with Google, please create an issue in the [support console](https://cloud.google.com/support/) instead of filing on GitHub. This will ensure a timely response.
+
+Please run down the following list and make sure you've tried the usual "quick fixes":
+
+  - Search the issues already opened: https://github.com/googleapis/google-cloud-python/issues
+  - Check for answers on StackOverflow: http://stackoverflow.com/questions/tagged/google-cloud-python
+
+If you are still having issues, please be sure to include as much information as possible:
+
+#### Environment details
+
+1. Specify the API at the beginning of the title (for example, "BigQuery: ...")
+   General, Core, and Other are also allowed as types
+2. OS type and version
+3. Python version and virtual environment information: `python --version`
+4. google-cloud-<service> version:  `pip show google-<service>` or `pip freeze`
+
+#### Steps to reproduce
+
+  1. ?
+
+#### Code example
+
+```python
+# example
+```
+
+#### Stack trace
+```
+# example
+```
+
+Making sure to follow these steps will guarantee the quickest resolution possible.
+
+Thanks!
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 000000000000..6365857f33c6
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,18 @@
+---
+name: Feature request
+about: Suggest an idea for this library
+
+---
+
+Thanks for stopping by to let us know something could be better!
+
+**PLEASE READ**: If you have a support contract with Google, please create an issue in the [support console](https://cloud.google.com/support/) instead of filing on GitHub. This will ensure a timely response.
+
+ **Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+ **Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+ **Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+ **Additional context**
+Add any other context or screenshots about the feature request here.
diff --git a/.github/ISSUE_TEMPLATE/support_request.md b/.github/ISSUE_TEMPLATE/support_request.md
new file mode 100644
index 000000000000..995869032125
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/support_request.md
@@ -0,0 +1,7 @@
+---
+name: Support request
+about: If you have a support contract with Google, please create an issue in the Google Cloud Support console.
+
+---
+
+**PLEASE READ**: If you have a support contract with Google, please create an issue in the [support console](https://cloud.google.com/support/) instead of filing on GitHub. This will ensure a timely response.
diff --git a/.gitignore b/.gitignore
index e2eb2ef7a2e5..87a4d1890975 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,8 +25,11 @@ pip-log.txt
 
 # Unit test / coverage reports
 .coverage
+.nox
 .tox
 .cache
+.pytest_cache
+htmlcov
 
 # Translations
 *.mo
@@ -42,8 +45,14 @@ pip-log.txt
 # JetBrains
 .idea
 
+# VS Code
+.vscode
+
 # Built documentation
 docs/_build
+*/docs/_build
+docs/_build_doc2dash
+bigquery/docs/generated
 
 # Virtual environment
 env/
@@ -53,10 +62,12 @@ coverage.xml
 system_tests/local_test_setup
 
 # Make sure a generated file isn't accidentally committed.
-scripts/pylintrc_reduced
+pylintrc
+pylintrc.test
 
 # Directories used for creating generated PB2 files
 generated_python/
 cloud-bigtable-client/
 googleapis-pb/
 grpc_python_venv/
+pytype_output/
diff --git a/.kokoro/build.sh b/.kokoro/build.sh
new file mode 100755
index 000000000000..39634b7d6d52
--- /dev/null
+++ b/.kokoro/build.sh
@@ -0,0 +1,56 @@
+#!/bin/bash
+
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -eo pipefail
+
+cd github/google-cloud-python
+
+# Disable buffering, so that the logs stream through.
+export PYTHONUNBUFFERED=1
+
+# Debug: show build environment
+env | grep KOKORO
+
+# Setup firestore account credentials
+export FIRESTORE_APPLICATION_CREDENTIALS=${KOKORO_GFILE_DIR}/firebase-credentials.json
+
+# Setup service account credentials.
+export GOOGLE_APPLICATION_CREDENTIALS=${KOKORO_GFILE_DIR}/service-account.json
+
+# Setup project id.
+export PROJECT_ID=$(cat "${KOKORO_GFILE_DIR}/project-id.json")
+
+# Find out if this package was modified.
+# Temporarily use Thea's fork of ci-diff-helper w/ Kokoro support.
+python3.6 -m pip install --quiet git+https://github.com/theacodes/ci-diff-helper.git
+python3.6 test_utils/scripts/get_target_packages_kokoro.py > ~/target_packages
+cat ~/target_packages
+
+if [[ ! -n $(grep -x "$PACKAGE" ~/target_packages) ]]; then
+    echo "$PACKAGE was not modified, returning."
+    exit;
+fi
+
+cd "$PACKAGE"
+
+# Remove old nox
+python3.6 -m pip uninstall --yes --quiet nox-automation
+
+# Install nox
+python3.6 -m pip install --upgrade --quiet nox
+python3.6 -m nox --version
+
+python3.6 -m nox
diff --git a/.kokoro/continuous/api_core.cfg b/.kokoro/continuous/api_core.cfg
new file mode 100644
index 000000000000..00ae35f46e2f
--- /dev/null
+++ b/.kokoro/continuous/api_core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "api_core"
+}
diff --git a/.kokoro/continuous/asset.cfg b/.kokoro/continuous/asset.cfg
new file mode 100644
index 000000000000..61c3fa9c5b4b
--- /dev/null
+++ b/.kokoro/continuous/asset.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "asset"
+}
diff --git a/.kokoro/continuous/automl.cfg b/.kokoro/continuous/automl.cfg
new file mode 100644
index 000000000000..5081664abb56
--- /dev/null
+++ b/.kokoro/continuous/automl.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "automl"
+}
diff --git a/.kokoro/continuous/bigquery.cfg b/.kokoro/continuous/bigquery.cfg
new file mode 100644
index 000000000000..69eabb20803c
--- /dev/null
+++ b/.kokoro/continuous/bigquery.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery"
+}
diff --git a/.kokoro/continuous/bigquery_datatransfer.cfg b/.kokoro/continuous/bigquery_datatransfer.cfg
new file mode 100644
index 000000000000..47e510d21a44
--- /dev/null
+++ b/.kokoro/continuous/bigquery_datatransfer.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_datatransfer"
+}
diff --git a/.kokoro/continuous/bigquery_storage.cfg b/.kokoro/continuous/bigquery_storage.cfg
new file mode 100644
index 000000000000..7f72bfed0587
--- /dev/null
+++ b/.kokoro/continuous/bigquery_storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_storage"
+}
diff --git a/.kokoro/continuous/bigtable.cfg b/.kokoro/continuous/bigtable.cfg
new file mode 100644
index 000000000000..de67c4844de9
--- /dev/null
+++ b/.kokoro/continuous/bigtable.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigtable"
+}
diff --git a/.kokoro/continuous/common.cfg b/.kokoro/continuous/common.cfg
new file mode 100644
index 000000000000..5dec06191476
--- /dev/null
+++ b/.kokoro/continuous/common.cfg
@@ -0,0 +1,27 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Download resources for system tests (service account key, etc.)
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/google-cloud-python"
+
+# Use the trampoline script to run in docker.
+build_file: "google-cloud-python/.kokoro/trampoline.sh"
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-multi"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-cloud-python/.kokoro/build.sh"
+}
diff --git a/.kokoro/continuous/container.cfg b/.kokoro/continuous/container.cfg
new file mode 100644
index 000000000000..8d06b5285bf2
--- /dev/null
+++ b/.kokoro/continuous/container.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "container"
+}
diff --git a/.kokoro/continuous/containeranalysis.cfg b/.kokoro/continuous/containeranalysis.cfg
new file mode 100644
index 000000000000..ae80ed8d8bc6
--- /dev/null
+++ b/.kokoro/continuous/containeranalysis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "containeranalysis"
+}
diff --git a/.kokoro/continuous/core.cfg b/.kokoro/continuous/core.cfg
new file mode 100644
index 000000000000..68b0d504429c
--- /dev/null
+++ b/.kokoro/continuous/core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "core"
+}
diff --git a/.kokoro/continuous/datacatalog.cfg b/.kokoro/continuous/datacatalog.cfg
new file mode 100644
index 000000000000..fc0371e5eb11
--- /dev/null
+++ b/.kokoro/continuous/datacatalog.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datacatalog"
+}
diff --git a/.kokoro/continuous/datalabeling.cfg b/.kokoro/continuous/datalabeling.cfg
new file mode 100644
index 000000000000..a1c53b81884b
--- /dev/null
+++ b/.kokoro/continuous/datalabeling.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datalabeling"
+}
diff --git a/.kokoro/continuous/dataproc.cfg b/.kokoro/continuous/dataproc.cfg
new file mode 100644
index 000000000000..d9ea2e670aea
--- /dev/null
+++ b/.kokoro/continuous/dataproc.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dataproc"
+}
diff --git a/.kokoro/continuous/datastore.cfg b/.kokoro/continuous/datastore.cfg
new file mode 100644
index 000000000000..7cf6a9c0dc8f
--- /dev/null
+++ b/.kokoro/continuous/datastore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datastore"
+}
diff --git a/.kokoro/continuous/dlp.cfg b/.kokoro/continuous/dlp.cfg
new file mode 100644
index 000000000000..931126d3e719
--- /dev/null
+++ b/.kokoro/continuous/dlp.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dlp"
+}
diff --git a/.kokoro/continuous/dns.cfg b/.kokoro/continuous/dns.cfg
new file mode 100644
index 000000000000..845e3e148060
--- /dev/null
+++ b/.kokoro/continuous/dns.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dns"
+}
diff --git a/.kokoro/continuous/error_reporting.cfg b/.kokoro/continuous/error_reporting.cfg
new file mode 100644
index 000000000000..99a86c522b9a
--- /dev/null
+++ b/.kokoro/continuous/error_reporting.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "error_reporting"
+}
diff --git a/.kokoro/continuous/firestore.cfg b/.kokoro/continuous/firestore.cfg
new file mode 100644
index 000000000000..9c5b0c53ab2d
--- /dev/null
+++ b/.kokoro/continuous/firestore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "firestore"
+}
diff --git a/.kokoro/continuous/grafeas.cfg b/.kokoro/continuous/grafeas.cfg
new file mode 100644
index 000000000000..8f0e2f271518
--- /dev/null
+++ b/.kokoro/continuous/grafeas.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "grafeas"
+}
diff --git a/.kokoro/continuous/iam.cfg b/.kokoro/continuous/iam.cfg
new file mode 100644
index 000000000000..812d891c07f8
--- /dev/null
+++ b/.kokoro/continuous/iam.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iam"
+}
diff --git a/.kokoro/continuous/iot.cfg b/.kokoro/continuous/iot.cfg
new file mode 100644
index 000000000000..dd388a8323e7
--- /dev/null
+++ b/.kokoro/continuous/iot.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iot"
+}
diff --git a/.kokoro/continuous/irm.cfg b/.kokoro/continuous/irm.cfg
new file mode 100644
index 000000000000..ec847dd64e83
--- /dev/null
+++ b/.kokoro/continuous/irm.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "irm"
+}
diff --git a/.kokoro/continuous/kms.cfg b/.kokoro/continuous/kms.cfg
new file mode 100644
index 000000000000..ba634573085e
--- /dev/null
+++ b/.kokoro/continuous/kms.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "kms"
+}
diff --git a/.kokoro/continuous/language.cfg b/.kokoro/continuous/language.cfg
new file mode 100644
index 000000000000..c7ee4e650ca3
--- /dev/null
+++ b/.kokoro/continuous/language.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "language"
+}
diff --git a/.kokoro/continuous/logging.cfg b/.kokoro/continuous/logging.cfg
new file mode 100644
index 000000000000..cf274e2d626b
--- /dev/null
+++ b/.kokoro/continuous/logging.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "logging"
+}
diff --git a/.kokoro/continuous/monitoring.cfg b/.kokoro/continuous/monitoring.cfg
new file mode 100644
index 000000000000..80d261740e6f
--- /dev/null
+++ b/.kokoro/continuous/monitoring.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "monitoring"
+}
diff --git a/.kokoro/continuous/oslogin.cfg b/.kokoro/continuous/oslogin.cfg
new file mode 100644
index 000000000000..9ca9766f6e3a
--- /dev/null
+++ b/.kokoro/continuous/oslogin.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "oslogin"
+}
diff --git a/.kokoro/continuous/phishingprotection.cfg b/.kokoro/continuous/phishingprotection.cfg
new file mode 100644
index 000000000000..e21bd50ab4f1
--- /dev/null
+++ b/.kokoro/continuous/phishingprotection.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "phishingprotection"
+}
diff --git a/.kokoro/continuous/pubsub.cfg b/.kokoro/continuous/pubsub.cfg
new file mode 100644
index 000000000000..16c7ed3c175c
--- /dev/null
+++ b/.kokoro/continuous/pubsub.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "pubsub"
+}
diff --git a/.kokoro/continuous/redis.cfg b/.kokoro/continuous/redis.cfg
new file mode 100644
index 000000000000..268bc06a7101
--- /dev/null
+++ b/.kokoro/continuous/redis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "redis"
+}
diff --git a/.kokoro/continuous/resource_manager.cfg b/.kokoro/continuous/resource_manager.cfg
new file mode 100644
index 000000000000..7a3976aef6cd
--- /dev/null
+++ b/.kokoro/continuous/resource_manager.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "resource_manager"
+}
diff --git a/.kokoro/continuous/runtimeconfig.cfg b/.kokoro/continuous/runtimeconfig.cfg
new file mode 100644
index 000000000000..2900b3c7e91a
--- /dev/null
+++ b/.kokoro/continuous/runtimeconfig.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "runtimeconfig"
+}
diff --git a/.kokoro/continuous/scheduler.cfg b/.kokoro/continuous/scheduler.cfg
new file mode 100644
index 000000000000..0701399853ef
--- /dev/null
+++ b/.kokoro/continuous/scheduler.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "scheduler"
+}
diff --git a/.kokoro/continuous/securitycenter.cfg b/.kokoro/continuous/securitycenter.cfg
new file mode 100644
index 000000000000..17dc427dae15
--- /dev/null
+++ b/.kokoro/continuous/securitycenter.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "securitycenter"
+}
diff --git a/.kokoro/continuous/spanner.cfg b/.kokoro/continuous/spanner.cfg
new file mode 100644
index 000000000000..d986f9d137f9
--- /dev/null
+++ b/.kokoro/continuous/spanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "spanner"
+}
diff --git a/.kokoro/continuous/speech.cfg b/.kokoro/continuous/speech.cfg
new file mode 100644
index 000000000000..b178b790be8d
--- /dev/null
+++ b/.kokoro/continuous/speech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "speech"
+}
diff --git a/.kokoro/continuous/storage.cfg b/.kokoro/continuous/storage.cfg
new file mode 100644
index 000000000000..6bd9371ff99d
--- /dev/null
+++ b/.kokoro/continuous/storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "storage"
+}
diff --git a/.kokoro/continuous/talent.cfg b/.kokoro/continuous/talent.cfg
new file mode 100644
index 000000000000..abafead62769
--- /dev/null
+++ b/.kokoro/continuous/talent.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "talent"
+}
diff --git a/.kokoro/continuous/tasks.cfg b/.kokoro/continuous/tasks.cfg
new file mode 100644
index 000000000000..2ae5c581b88d
--- /dev/null
+++ b/.kokoro/continuous/tasks.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "tasks"
+}
diff --git a/.kokoro/continuous/texttospeech.cfg b/.kokoro/continuous/texttospeech.cfg
new file mode 100644
index 000000000000..9e7d6d7f7980
--- /dev/null
+++ b/.kokoro/continuous/texttospeech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "texttospeech"
+}
diff --git a/.kokoro/continuous/trace.cfg b/.kokoro/continuous/trace.cfg
new file mode 100644
index 000000000000..9169296e4753
--- /dev/null
+++ b/.kokoro/continuous/trace.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "trace"
+}
diff --git a/.kokoro/continuous/translate.cfg b/.kokoro/continuous/translate.cfg
new file mode 100644
index 000000000000..807c96195b41
--- /dev/null
+++ b/.kokoro/continuous/translate.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "translate"
+}
diff --git a/.kokoro/continuous/videointelligence.cfg b/.kokoro/continuous/videointelligence.cfg
new file mode 100644
index 000000000000..77d1d3fc49e6
--- /dev/null
+++ b/.kokoro/continuous/videointelligence.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "videointelligence"
+}
diff --git a/.kokoro/continuous/vision.cfg b/.kokoro/continuous/vision.cfg
new file mode 100644
index 000000000000..4f686b3abf42
--- /dev/null
+++ b/.kokoro/continuous/vision.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "vision"
+}
diff --git a/.kokoro/continuous/webrisk.cfg b/.kokoro/continuous/webrisk.cfg
new file mode 100644
index 000000000000..36b06f0b0b55
--- /dev/null
+++ b/.kokoro/continuous/webrisk.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "webrisk"
+}
diff --git a/.kokoro/continuous/websecurityscanner.cfg b/.kokoro/continuous/websecurityscanner.cfg
new file mode 100644
index 000000000000..221d1fc23d6b
--- /dev/null
+++ b/.kokoro/continuous/websecurityscanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "websecurityscanner"
+}
diff --git a/.kokoro/docs/api_core.cfg b/.kokoro/docs/api_core.cfg
new file mode 100644
index 000000000000..00ae35f46e2f
--- /dev/null
+++ b/.kokoro/docs/api_core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "api_core"
+}
diff --git a/.kokoro/docs/asset.cfg b/.kokoro/docs/asset.cfg
new file mode 100644
index 000000000000..61c3fa9c5b4b
--- /dev/null
+++ b/.kokoro/docs/asset.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "asset"
+}
diff --git a/.kokoro/docs/automl.cfg b/.kokoro/docs/automl.cfg
new file mode 100644
index 000000000000..093775c51065
--- /dev/null
+++ b/.kokoro/docs/automl.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "automl"
+}
\ No newline at end of file
diff --git a/.kokoro/docs/bigquery.cfg b/.kokoro/docs/bigquery.cfg
new file mode 100644
index 000000000000..69eabb20803c
--- /dev/null
+++ b/.kokoro/docs/bigquery.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery"
+}
diff --git a/.kokoro/docs/bigquery_datatransfer.cfg b/.kokoro/docs/bigquery_datatransfer.cfg
new file mode 100644
index 000000000000..47e510d21a44
--- /dev/null
+++ b/.kokoro/docs/bigquery_datatransfer.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_datatransfer"
+}
diff --git a/.kokoro/docs/bigquery_storage.cfg b/.kokoro/docs/bigquery_storage.cfg
new file mode 100644
index 000000000000..7f72bfed0587
--- /dev/null
+++ b/.kokoro/docs/bigquery_storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_storage"
+}
diff --git a/.kokoro/docs/bigtable.cfg b/.kokoro/docs/bigtable.cfg
new file mode 100644
index 000000000000..de67c4844de9
--- /dev/null
+++ b/.kokoro/docs/bigtable.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigtable"
+}
diff --git a/.kokoro/docs/common.cfg b/.kokoro/docs/common.cfg
new file mode 100644
index 000000000000..96e9740dd889
--- /dev/null
+++ b/.kokoro/docs/common.cfg
@@ -0,0 +1,48 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Use the trampoline script to run in docker.
+build_file: "google-cloud-python/.kokoro/trampoline.sh"
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-multi"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-cloud-python/.kokoro/publish-docs.sh"
+}
+
+env_vars: {
+    key: "STAGING_BUCKET"
+    value: "docs-staging"
+}
+
+# Fetch the token needed for reporting release status to GitHub
+before_action {
+  fetch_keystore {
+    keystore_resource {
+      keystore_config_id: 73713
+      keyname: "yoshi-automation-github-key"
+    }
+  }
+}
+
+before_action {
+  fetch_keystore {
+    keystore_resource {
+      keystore_config_id: 73713
+      keyname: "docuploader_service_account"
+    }
+  }
+}
\ No newline at end of file
diff --git a/.kokoro/docs/container.cfg b/.kokoro/docs/container.cfg
new file mode 100644
index 000000000000..8d06b5285bf2
--- /dev/null
+++ b/.kokoro/docs/container.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "container"
+}
diff --git a/.kokoro/docs/containeranalysis.cfg b/.kokoro/docs/containeranalysis.cfg
new file mode 100644
index 000000000000..ae80ed8d8bc6
--- /dev/null
+++ b/.kokoro/docs/containeranalysis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "containeranalysis"
+}
diff --git a/.kokoro/docs/core.cfg b/.kokoro/docs/core.cfg
new file mode 100644
index 000000000000..68b0d504429c
--- /dev/null
+++ b/.kokoro/docs/core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "core"
+}
diff --git a/.kokoro/docs/datacatalog.cfg b/.kokoro/docs/datacatalog.cfg
new file mode 100644
index 000000000000..fc0371e5eb11
--- /dev/null
+++ b/.kokoro/docs/datacatalog.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datacatalog"
+}
diff --git a/.kokoro/docs/datalabeling.cfg b/.kokoro/docs/datalabeling.cfg
new file mode 100644
index 000000000000..a1c53b81884b
--- /dev/null
+++ b/.kokoro/docs/datalabeling.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datalabeling"
+}
diff --git a/.kokoro/docs/dataproc.cfg b/.kokoro/docs/dataproc.cfg
new file mode 100644
index 000000000000..d9ea2e670aea
--- /dev/null
+++ b/.kokoro/docs/dataproc.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dataproc"
+}
diff --git a/.kokoro/docs/datastore.cfg b/.kokoro/docs/datastore.cfg
new file mode 100644
index 000000000000..7cf6a9c0dc8f
--- /dev/null
+++ b/.kokoro/docs/datastore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datastore"
+}
diff --git a/.kokoro/docs/dlp.cfg b/.kokoro/docs/dlp.cfg
new file mode 100644
index 000000000000..931126d3e719
--- /dev/null
+++ b/.kokoro/docs/dlp.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dlp"
+}
diff --git a/.kokoro/docs/dns.cfg b/.kokoro/docs/dns.cfg
new file mode 100644
index 000000000000..845e3e148060
--- /dev/null
+++ b/.kokoro/docs/dns.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dns"
+}
diff --git a/.kokoro/docs/error_reporting.cfg b/.kokoro/docs/error_reporting.cfg
new file mode 100644
index 000000000000..99a86c522b9a
--- /dev/null
+++ b/.kokoro/docs/error_reporting.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "error_reporting"
+}
diff --git a/.kokoro/docs/firestore.cfg b/.kokoro/docs/firestore.cfg
new file mode 100644
index 000000000000..9c5b0c53ab2d
--- /dev/null
+++ b/.kokoro/docs/firestore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "firestore"
+}
diff --git a/.kokoro/docs/grafeas.cfg b/.kokoro/docs/grafeas.cfg
new file mode 100644
index 000000000000..8f0e2f271518
--- /dev/null
+++ b/.kokoro/docs/grafeas.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "grafeas"
+}
diff --git a/.kokoro/docs/iam.cfg b/.kokoro/docs/iam.cfg
new file mode 100644
index 000000000000..812d891c07f8
--- /dev/null
+++ b/.kokoro/docs/iam.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iam"
+}
diff --git a/.kokoro/docs/iot.cfg b/.kokoro/docs/iot.cfg
new file mode 100644
index 000000000000..114c8da20d77
--- /dev/null
+++ b/.kokoro/docs/iot.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iot"
+}
\ No newline at end of file
diff --git a/.kokoro/docs/irm.cfg b/.kokoro/docs/irm.cfg
new file mode 100644
index 000000000000..ec847dd64e83
--- /dev/null
+++ b/.kokoro/docs/irm.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "irm"
+}
diff --git a/.kokoro/docs/kms.cfg b/.kokoro/docs/kms.cfg
new file mode 100644
index 000000000000..ba634573085e
--- /dev/null
+++ b/.kokoro/docs/kms.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "kms"
+}
diff --git a/.kokoro/docs/language.cfg b/.kokoro/docs/language.cfg
new file mode 100644
index 000000000000..c7ee4e650ca3
--- /dev/null
+++ b/.kokoro/docs/language.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "language"
+}
diff --git a/.kokoro/docs/logging.cfg b/.kokoro/docs/logging.cfg
new file mode 100644
index 000000000000..cf274e2d626b
--- /dev/null
+++ b/.kokoro/docs/logging.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "logging"
+}
diff --git a/.kokoro/docs/monitoring.cfg b/.kokoro/docs/monitoring.cfg
new file mode 100644
index 000000000000..80d261740e6f
--- /dev/null
+++ b/.kokoro/docs/monitoring.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "monitoring"
+}
diff --git a/.kokoro/docs/oslogin.cfg b/.kokoro/docs/oslogin.cfg
new file mode 100644
index 000000000000..9ca9766f6e3a
--- /dev/null
+++ b/.kokoro/docs/oslogin.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "oslogin"
+}
diff --git a/.kokoro/docs/phishingprotection.cfg b/.kokoro/docs/phishingprotection.cfg
new file mode 100644
index 000000000000..e21bd50ab4f1
--- /dev/null
+++ b/.kokoro/docs/phishingprotection.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "phishingprotection"
+}
diff --git a/.kokoro/docs/pubsub.cfg b/.kokoro/docs/pubsub.cfg
new file mode 100644
index 000000000000..16c7ed3c175c
--- /dev/null
+++ b/.kokoro/docs/pubsub.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "pubsub"
+}
diff --git a/.kokoro/docs/redis.cfg b/.kokoro/docs/redis.cfg
new file mode 100644
index 000000000000..268bc06a7101
--- /dev/null
+++ b/.kokoro/docs/redis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "redis"
+}
diff --git a/.kokoro/docs/resource_manager.cfg b/.kokoro/docs/resource_manager.cfg
new file mode 100644
index 000000000000..7a3976aef6cd
--- /dev/null
+++ b/.kokoro/docs/resource_manager.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "resource_manager"
+}
diff --git a/.kokoro/docs/runtimeconfig.cfg b/.kokoro/docs/runtimeconfig.cfg
new file mode 100644
index 000000000000..2900b3c7e91a
--- /dev/null
+++ b/.kokoro/docs/runtimeconfig.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "runtimeconfig"
+}
diff --git a/.kokoro/docs/scheduler.cfg b/.kokoro/docs/scheduler.cfg
new file mode 100644
index 000000000000..0701399853ef
--- /dev/null
+++ b/.kokoro/docs/scheduler.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "scheduler"
+}
diff --git a/.kokoro/docs/securitycenter.cfg b/.kokoro/docs/securitycenter.cfg
new file mode 100644
index 000000000000..17dc427dae15
--- /dev/null
+++ b/.kokoro/docs/securitycenter.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "securitycenter"
+}
diff --git a/.kokoro/docs/spanner.cfg b/.kokoro/docs/spanner.cfg
new file mode 100644
index 000000000000..d986f9d137f9
--- /dev/null
+++ b/.kokoro/docs/spanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "spanner"
+}
diff --git a/.kokoro/docs/speech.cfg b/.kokoro/docs/speech.cfg
new file mode 100644
index 000000000000..b178b790be8d
--- /dev/null
+++ b/.kokoro/docs/speech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "speech"
+}
diff --git a/.kokoro/docs/storage.cfg b/.kokoro/docs/storage.cfg
new file mode 100644
index 000000000000..6bd9371ff99d
--- /dev/null
+++ b/.kokoro/docs/storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "storage"
+}
diff --git a/.kokoro/docs/talent.cfg b/.kokoro/docs/talent.cfg
new file mode 100644
index 000000000000..abafead62769
--- /dev/null
+++ b/.kokoro/docs/talent.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "talent"
+}
diff --git a/.kokoro/docs/tasks.cfg b/.kokoro/docs/tasks.cfg
new file mode 100644
index 000000000000..2ae5c581b88d
--- /dev/null
+++ b/.kokoro/docs/tasks.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "tasks"
+}
diff --git a/.kokoro/docs/texttospeech.cfg b/.kokoro/docs/texttospeech.cfg
new file mode 100644
index 000000000000..9e7d6d7f7980
--- /dev/null
+++ b/.kokoro/docs/texttospeech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "texttospeech"
+}
diff --git a/.kokoro/docs/trace.cfg b/.kokoro/docs/trace.cfg
new file mode 100644
index 000000000000..9169296e4753
--- /dev/null
+++ b/.kokoro/docs/trace.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "trace"
+}
diff --git a/.kokoro/docs/translate.cfg b/.kokoro/docs/translate.cfg
new file mode 100644
index 000000000000..807c96195b41
--- /dev/null
+++ b/.kokoro/docs/translate.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "translate"
+}
diff --git a/.kokoro/docs/videointelligence.cfg b/.kokoro/docs/videointelligence.cfg
new file mode 100644
index 000000000000..77d1d3fc49e6
--- /dev/null
+++ b/.kokoro/docs/videointelligence.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "videointelligence"
+}
diff --git a/.kokoro/docs/vision.cfg b/.kokoro/docs/vision.cfg
new file mode 100644
index 000000000000..4f686b3abf42
--- /dev/null
+++ b/.kokoro/docs/vision.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "vision"
+}
diff --git a/.kokoro/docs/webrisk.cfg b/.kokoro/docs/webrisk.cfg
new file mode 100644
index 000000000000..36b06f0b0b55
--- /dev/null
+++ b/.kokoro/docs/webrisk.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "webrisk"
+}
diff --git a/.kokoro/docs/websecurityscanner.cfg b/.kokoro/docs/websecurityscanner.cfg
new file mode 100644
index 000000000000..221d1fc23d6b
--- /dev/null
+++ b/.kokoro/docs/websecurityscanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "websecurityscanner"
+}
diff --git a/.kokoro/presubmit/api_core.cfg b/.kokoro/presubmit/api_core.cfg
new file mode 100644
index 000000000000..00ae35f46e2f
--- /dev/null
+++ b/.kokoro/presubmit/api_core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "api_core"
+}
diff --git a/.kokoro/presubmit/asset.cfg b/.kokoro/presubmit/asset.cfg
new file mode 100644
index 000000000000..61c3fa9c5b4b
--- /dev/null
+++ b/.kokoro/presubmit/asset.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "asset"
+}
diff --git a/.kokoro/presubmit/automl.cfg b/.kokoro/presubmit/automl.cfg
new file mode 100644
index 000000000000..5081664abb56
--- /dev/null
+++ b/.kokoro/presubmit/automl.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "automl"
+}
diff --git a/.kokoro/presubmit/bigquery.cfg b/.kokoro/presubmit/bigquery.cfg
new file mode 100644
index 000000000000..69eabb20803c
--- /dev/null
+++ b/.kokoro/presubmit/bigquery.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery"
+}
diff --git a/.kokoro/presubmit/bigquery_datatransfer.cfg b/.kokoro/presubmit/bigquery_datatransfer.cfg
new file mode 100644
index 000000000000..47e510d21a44
--- /dev/null
+++ b/.kokoro/presubmit/bigquery_datatransfer.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_datatransfer"
+}
diff --git a/.kokoro/presubmit/bigquery_storage.cfg b/.kokoro/presubmit/bigquery_storage.cfg
new file mode 100644
index 000000000000..7f72bfed0587
--- /dev/null
+++ b/.kokoro/presubmit/bigquery_storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_storage"
+}
diff --git a/.kokoro/presubmit/bigtable.cfg b/.kokoro/presubmit/bigtable.cfg
new file mode 100644
index 000000000000..de67c4844de9
--- /dev/null
+++ b/.kokoro/presubmit/bigtable.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigtable"
+}
diff --git a/.kokoro/presubmit/common.cfg b/.kokoro/presubmit/common.cfg
new file mode 100644
index 000000000000..5dec06191476
--- /dev/null
+++ b/.kokoro/presubmit/common.cfg
@@ -0,0 +1,27 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Download resources for system tests (service account key, etc.)
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/google-cloud-python"
+
+# Use the trampoline script to run in docker.
+build_file: "google-cloud-python/.kokoro/trampoline.sh"
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-multi"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-cloud-python/.kokoro/build.sh"
+}
diff --git a/.kokoro/presubmit/container.cfg b/.kokoro/presubmit/container.cfg
new file mode 100644
index 000000000000..8d06b5285bf2
--- /dev/null
+++ b/.kokoro/presubmit/container.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "container"
+}
diff --git a/.kokoro/presubmit/containeranalysis.cfg b/.kokoro/presubmit/containeranalysis.cfg
new file mode 100644
index 000000000000..ae80ed8d8bc6
--- /dev/null
+++ b/.kokoro/presubmit/containeranalysis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "containeranalysis"
+}
diff --git a/.kokoro/presubmit/core.cfg b/.kokoro/presubmit/core.cfg
new file mode 100644
index 000000000000..68b0d504429c
--- /dev/null
+++ b/.kokoro/presubmit/core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "core"
+}
diff --git a/.kokoro/presubmit/datacatalog.cfg b/.kokoro/presubmit/datacatalog.cfg
new file mode 100644
index 000000000000..fc0371e5eb11
--- /dev/null
+++ b/.kokoro/presubmit/datacatalog.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datacatalog"
+}
diff --git a/.kokoro/presubmit/datalabeling.cfg b/.kokoro/presubmit/datalabeling.cfg
new file mode 100644
index 000000000000..a1c53b81884b
--- /dev/null
+++ b/.kokoro/presubmit/datalabeling.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datalabeling"
+}
diff --git a/.kokoro/presubmit/dataproc.cfg b/.kokoro/presubmit/dataproc.cfg
new file mode 100644
index 000000000000..d9ea2e670aea
--- /dev/null
+++ b/.kokoro/presubmit/dataproc.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dataproc"
+}
diff --git a/.kokoro/presubmit/datastore.cfg b/.kokoro/presubmit/datastore.cfg
new file mode 100644
index 000000000000..7cf6a9c0dc8f
--- /dev/null
+++ b/.kokoro/presubmit/datastore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datastore"
+}
diff --git a/.kokoro/presubmit/dlp.cfg b/.kokoro/presubmit/dlp.cfg
new file mode 100644
index 000000000000..931126d3e719
--- /dev/null
+++ b/.kokoro/presubmit/dlp.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dlp"
+}
diff --git a/.kokoro/presubmit/dns.cfg b/.kokoro/presubmit/dns.cfg
new file mode 100644
index 000000000000..845e3e148060
--- /dev/null
+++ b/.kokoro/presubmit/dns.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dns"
+}
diff --git a/.kokoro/presubmit/error_reporting.cfg b/.kokoro/presubmit/error_reporting.cfg
new file mode 100644
index 000000000000..99a86c522b9a
--- /dev/null
+++ b/.kokoro/presubmit/error_reporting.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "error_reporting"
+}
diff --git a/.kokoro/presubmit/firestore.cfg b/.kokoro/presubmit/firestore.cfg
new file mode 100644
index 000000000000..9c5b0c53ab2d
--- /dev/null
+++ b/.kokoro/presubmit/firestore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "firestore"
+}
diff --git a/.kokoro/presubmit/grafeas.cfg b/.kokoro/presubmit/grafeas.cfg
new file mode 100644
index 000000000000..8f0e2f271518
--- /dev/null
+++ b/.kokoro/presubmit/grafeas.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "grafeas"
+}
diff --git a/.kokoro/presubmit/iam.cfg b/.kokoro/presubmit/iam.cfg
new file mode 100644
index 000000000000..812d891c07f8
--- /dev/null
+++ b/.kokoro/presubmit/iam.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iam"
+}
diff --git a/.kokoro/presubmit/iot.cfg b/.kokoro/presubmit/iot.cfg
new file mode 100644
index 000000000000..dd388a8323e7
--- /dev/null
+++ b/.kokoro/presubmit/iot.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iot"
+}
diff --git a/.kokoro/presubmit/irm.cfg b/.kokoro/presubmit/irm.cfg
new file mode 100644
index 000000000000..ec847dd64e83
--- /dev/null
+++ b/.kokoro/presubmit/irm.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "irm"
+}
diff --git a/.kokoro/presubmit/kms.cfg b/.kokoro/presubmit/kms.cfg
new file mode 100644
index 000000000000..ba634573085e
--- /dev/null
+++ b/.kokoro/presubmit/kms.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "kms"
+}
diff --git a/.kokoro/presubmit/language.cfg b/.kokoro/presubmit/language.cfg
new file mode 100644
index 000000000000..c7ee4e650ca3
--- /dev/null
+++ b/.kokoro/presubmit/language.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "language"
+}
diff --git a/.kokoro/presubmit/logging.cfg b/.kokoro/presubmit/logging.cfg
new file mode 100644
index 000000000000..cf274e2d626b
--- /dev/null
+++ b/.kokoro/presubmit/logging.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "logging"
+}
diff --git a/.kokoro/presubmit/monitoring.cfg b/.kokoro/presubmit/monitoring.cfg
new file mode 100644
index 000000000000..80d261740e6f
--- /dev/null
+++ b/.kokoro/presubmit/monitoring.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "monitoring"
+}
diff --git a/.kokoro/presubmit/oslogin.cfg b/.kokoro/presubmit/oslogin.cfg
new file mode 100644
index 000000000000..9ca9766f6e3a
--- /dev/null
+++ b/.kokoro/presubmit/oslogin.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "oslogin"
+}
diff --git a/.kokoro/presubmit/phishingprotection.cfg b/.kokoro/presubmit/phishingprotection.cfg
new file mode 100644
index 000000000000..e21bd50ab4f1
--- /dev/null
+++ b/.kokoro/presubmit/phishingprotection.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "phishingprotection"
+}
diff --git a/.kokoro/presubmit/pubsub.cfg b/.kokoro/presubmit/pubsub.cfg
new file mode 100644
index 000000000000..16c7ed3c175c
--- /dev/null
+++ b/.kokoro/presubmit/pubsub.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "pubsub"
+}
diff --git a/.kokoro/presubmit/redis.cfg b/.kokoro/presubmit/redis.cfg
new file mode 100644
index 000000000000..268bc06a7101
--- /dev/null
+++ b/.kokoro/presubmit/redis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "redis"
+}
diff --git a/.kokoro/presubmit/resource_manager.cfg b/.kokoro/presubmit/resource_manager.cfg
new file mode 100644
index 000000000000..7a3976aef6cd
--- /dev/null
+++ b/.kokoro/presubmit/resource_manager.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "resource_manager"
+}
diff --git a/.kokoro/presubmit/runtimeconfig.cfg b/.kokoro/presubmit/runtimeconfig.cfg
new file mode 100644
index 000000000000..2900b3c7e91a
--- /dev/null
+++ b/.kokoro/presubmit/runtimeconfig.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "runtimeconfig"
+}
diff --git a/.kokoro/presubmit/scheduler.cfg b/.kokoro/presubmit/scheduler.cfg
new file mode 100644
index 000000000000..0701399853ef
--- /dev/null
+++ b/.kokoro/presubmit/scheduler.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "scheduler"
+}
diff --git a/.kokoro/presubmit/securitycenter.cfg b/.kokoro/presubmit/securitycenter.cfg
new file mode 100644
index 000000000000..17dc427dae15
--- /dev/null
+++ b/.kokoro/presubmit/securitycenter.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "securitycenter"
+}
diff --git a/.kokoro/presubmit/spanner.cfg b/.kokoro/presubmit/spanner.cfg
new file mode 100644
index 000000000000..d986f9d137f9
--- /dev/null
+++ b/.kokoro/presubmit/spanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "spanner"
+}
diff --git a/.kokoro/presubmit/speech.cfg b/.kokoro/presubmit/speech.cfg
new file mode 100644
index 000000000000..b178b790be8d
--- /dev/null
+++ b/.kokoro/presubmit/speech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "speech"
+}
diff --git a/.kokoro/presubmit/storage.cfg b/.kokoro/presubmit/storage.cfg
new file mode 100644
index 000000000000..6bd9371ff99d
--- /dev/null
+++ b/.kokoro/presubmit/storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "storage"
+}
diff --git a/.kokoro/presubmit/talent.cfg b/.kokoro/presubmit/talent.cfg
new file mode 100644
index 000000000000..abafead62769
--- /dev/null
+++ b/.kokoro/presubmit/talent.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "talent"
+}
diff --git a/.kokoro/presubmit/tasks.cfg b/.kokoro/presubmit/tasks.cfg
new file mode 100644
index 000000000000..2ae5c581b88d
--- /dev/null
+++ b/.kokoro/presubmit/tasks.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "tasks"
+}
diff --git a/.kokoro/presubmit/texttospeech.cfg b/.kokoro/presubmit/texttospeech.cfg
new file mode 100644
index 000000000000..9e7d6d7f7980
--- /dev/null
+++ b/.kokoro/presubmit/texttospeech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "texttospeech"
+}
diff --git a/.kokoro/presubmit/trace.cfg b/.kokoro/presubmit/trace.cfg
new file mode 100644
index 000000000000..9169296e4753
--- /dev/null
+++ b/.kokoro/presubmit/trace.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "trace"
+}
diff --git a/.kokoro/presubmit/translate.cfg b/.kokoro/presubmit/translate.cfg
new file mode 100644
index 000000000000..807c96195b41
--- /dev/null
+++ b/.kokoro/presubmit/translate.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "translate"
+}
diff --git a/.kokoro/presubmit/videointelligence.cfg b/.kokoro/presubmit/videointelligence.cfg
new file mode 100644
index 000000000000..77d1d3fc49e6
--- /dev/null
+++ b/.kokoro/presubmit/videointelligence.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "videointelligence"
+}
diff --git a/.kokoro/presubmit/vision.cfg b/.kokoro/presubmit/vision.cfg
new file mode 100644
index 000000000000..4f686b3abf42
--- /dev/null
+++ b/.kokoro/presubmit/vision.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "vision"
+}
diff --git a/.kokoro/presubmit/webrisk.cfg b/.kokoro/presubmit/webrisk.cfg
new file mode 100644
index 000000000000..36b06f0b0b55
--- /dev/null
+++ b/.kokoro/presubmit/webrisk.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "webrisk"
+}
diff --git a/.kokoro/presubmit/websecurityscanner.cfg b/.kokoro/presubmit/websecurityscanner.cfg
new file mode 100644
index 000000000000..221d1fc23d6b
--- /dev/null
+++ b/.kokoro/presubmit/websecurityscanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "websecurityscanner"
+}
diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh
new file mode 100755
index 000000000000..d6762b5ed6f9
--- /dev/null
+++ b/.kokoro/publish-docs.sh
@@ -0,0 +1,42 @@
+#!/bin/bash
+
+set -eo pipefail
+
+# Disable buffering, so that the logs stream through.
+export PYTHONUNBUFFERED=1
+
+cd github/google-cloud-python/${PACKAGE}
+
+# Remove old nox
+python3.6 -m pip uninstall --yes --quiet nox-automation
+
+# Install nox
+python3.6 -m pip install --upgrade --quiet nox
+python3.6 -m nox --version
+
+# build docs
+nox -s docs
+
+python3 -m pip install gcp-docuploader
+
+# install a json parser
+sudo apt-get update
+sudo apt-get -y install software-properties-common
+sudo add-apt-repository universe
+sudo apt-get update
+sudo apt-get -y install jq
+
+# create metadata
+python3 -m docuploader create-metadata \
+  --name=$(jq --raw-output '.name // empty' .repo-metadata.json) \
+  --version=$(python3 setup.py --version) \
+  --language=$(jq --raw-output '.language // empty' .repo-metadata.json) \
+  --distribution-name=$(python3 setup.py --name) \
+  --product-page=$(jq --raw-output '.product_documentation // empty' .repo-metadata.json) \
+  --github-repository=$(jq --raw-output '.repo // empty' .repo-metadata.json) \
+  --issue-tracker=$(jq --raw-output '.issue_tracker // empty' .repo-metadata.json)
+
+cat docs.metadata
+
+# upload docs
+python3 -m docuploader upload docs/_build/html --metadata-file docs.metadata --staging-bucket docs-staging
\ No newline at end of file
diff --git a/.kokoro/release.sh b/.kokoro/release.sh
new file mode 100755
index 000000000000..6909ae880d8b
--- /dev/null
+++ b/.kokoro/release.sh
@@ -0,0 +1,19 @@
+#!/bin/bash
+
+set -eo pipefail
+
+# Start the releasetool reporter
+python3 -m pip install gcp-releasetool
+python3 -m releasetool publish-reporter-script > /tmp/publisher-script; source /tmp/publisher-script
+
+# Ensure that we have the latest versions of Twine, Wheel, and Setuptools.
+python3 -m pip install --upgrade twine wheel setuptools
+
+# Disable buffering, so that the logs stream through.
+export PYTHONUNBUFFERED=1
+
+# Move into the package, build the distribution and upload.
+TWINE_PASSWORD=$(cat "${KOKORO_KEYSTORE_DIR}/73713_google_cloud_pypi_password")
+cd github/google-cloud-python/${PACKAGE}
+python3 setup.py sdist bdist_wheel
+twine upload --username gcloudpypi --password "${TWINE_PASSWORD}" dist/*
diff --git a/.kokoro/release/api_core.cfg b/.kokoro/release/api_core.cfg
new file mode 100644
index 000000000000..00ae35f46e2f
--- /dev/null
+++ b/.kokoro/release/api_core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "api_core"
+}
diff --git a/.kokoro/release/asset.cfg b/.kokoro/release/asset.cfg
new file mode 100644
index 000000000000..61c3fa9c5b4b
--- /dev/null
+++ b/.kokoro/release/asset.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "asset"
+}
diff --git a/.kokoro/release/automl.cfg b/.kokoro/release/automl.cfg
new file mode 100644
index 000000000000..5081664abb56
--- /dev/null
+++ b/.kokoro/release/automl.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "automl"
+}
diff --git a/.kokoro/release/bigquery.cfg b/.kokoro/release/bigquery.cfg
new file mode 100644
index 000000000000..69eabb20803c
--- /dev/null
+++ b/.kokoro/release/bigquery.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery"
+}
diff --git a/.kokoro/release/bigquery_datatransfer.cfg b/.kokoro/release/bigquery_datatransfer.cfg
new file mode 100644
index 000000000000..47e510d21a44
--- /dev/null
+++ b/.kokoro/release/bigquery_datatransfer.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_datatransfer"
+}
diff --git a/.kokoro/release/bigquery_storage.cfg b/.kokoro/release/bigquery_storage.cfg
new file mode 100644
index 000000000000..7f72bfed0587
--- /dev/null
+++ b/.kokoro/release/bigquery_storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_storage"
+}
diff --git a/.kokoro/release/bigtable.cfg b/.kokoro/release/bigtable.cfg
new file mode 100644
index 000000000000..de67c4844de9
--- /dev/null
+++ b/.kokoro/release/bigtable.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigtable"
+}
diff --git a/.kokoro/release/common.cfg b/.kokoro/release/common.cfg
new file mode 100644
index 000000000000..7456ab5604ef
--- /dev/null
+++ b/.kokoro/release/common.cfg
@@ -0,0 +1,64 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Build logs will be here
+action {
+  define_artifacts {
+    regex: "**/*sponge_log.xml"
+  }
+}
+
+# Download trampoline resources.
+gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline"
+
+# Use the trampoline script to run in docker.
+build_file: "google-cloud-python/.kokoro/trampoline.sh"
+
+# Configure the docker image for kokoro-trampoline.
+env_vars: {
+    key: "TRAMPOLINE_IMAGE"
+    value: "gcr.io/cloud-devrel-kokoro-resources/python-multi"
+}
+env_vars: {
+    key: "TRAMPOLINE_BUILD_FILE"
+    value: "github/google-cloud-python/.kokoro/release.sh"
+}
+
+# Fetch the token needed for reporting release status to GitHub
+before_action {
+  fetch_keystore {
+    keystore_resource {
+      keystore_config_id: 73713
+      keyname: "yoshi-automation-github-key"
+    }
+  }
+}
+
+# Fetch PyPI password
+before_action {
+  fetch_keystore {
+    keystore_resource {
+      keystore_config_id: 73713
+      keyname: "google_cloud_pypi_password"
+    }
+  }
+}
+
+# Fetch magictoken to use with Magic Github Proxy 
+before_action {
+  fetch_keystore {
+    keystore_resource {
+      keystore_config_id: 73713
+      keyname: "releasetool-magictoken"
+    }
+  }
+}
+
+# Fetch api key to use with Magic Github Proxy 
+before_action {
+  fetch_keystore {
+    keystore_resource {
+      keystore_config_id: 73713
+      keyname: "magic-github-proxy-api-key"
+    }
+  }
+}
diff --git a/.kokoro/release/container.cfg b/.kokoro/release/container.cfg
new file mode 100644
index 000000000000..8d06b5285bf2
--- /dev/null
+++ b/.kokoro/release/container.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "container"
+}
diff --git a/.kokoro/release/containeranalysis.cfg b/.kokoro/release/containeranalysis.cfg
new file mode 100644
index 000000000000..ae80ed8d8bc6
--- /dev/null
+++ b/.kokoro/release/containeranalysis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "containeranalysis"
+}
diff --git a/.kokoro/release/core.cfg b/.kokoro/release/core.cfg
new file mode 100644
index 000000000000..68b0d504429c
--- /dev/null
+++ b/.kokoro/release/core.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "core"
+}
diff --git a/.kokoro/release/datacatalog.cfg b/.kokoro/release/datacatalog.cfg
new file mode 100644
index 000000000000..fc0371e5eb11
--- /dev/null
+++ b/.kokoro/release/datacatalog.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datacatalog"
+}
diff --git a/.kokoro/release/datalabeling.cfg b/.kokoro/release/datalabeling.cfg
new file mode 100644
index 000000000000..a1c53b81884b
--- /dev/null
+++ b/.kokoro/release/datalabeling.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datalabeling"
+}
diff --git a/.kokoro/release/dataproc.cfg b/.kokoro/release/dataproc.cfg
new file mode 100644
index 000000000000..d9ea2e670aea
--- /dev/null
+++ b/.kokoro/release/dataproc.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dataproc"
+}
diff --git a/.kokoro/release/datastore.cfg b/.kokoro/release/datastore.cfg
new file mode 100644
index 000000000000..7cf6a9c0dc8f
--- /dev/null
+++ b/.kokoro/release/datastore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "datastore"
+}
diff --git a/.kokoro/release/dlp.cfg b/.kokoro/release/dlp.cfg
new file mode 100644
index 000000000000..931126d3e719
--- /dev/null
+++ b/.kokoro/release/dlp.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dlp"
+}
diff --git a/.kokoro/release/dns.cfg b/.kokoro/release/dns.cfg
new file mode 100644
index 000000000000..845e3e148060
--- /dev/null
+++ b/.kokoro/release/dns.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "dns"
+}
diff --git a/.kokoro/release/error_reporting.cfg b/.kokoro/release/error_reporting.cfg
new file mode 100644
index 000000000000..99a86c522b9a
--- /dev/null
+++ b/.kokoro/release/error_reporting.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "error_reporting"
+}
diff --git a/.kokoro/release/firestore.cfg b/.kokoro/release/firestore.cfg
new file mode 100644
index 000000000000..9c5b0c53ab2d
--- /dev/null
+++ b/.kokoro/release/firestore.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "firestore"
+}
diff --git a/.kokoro/release/grafeas.cfg b/.kokoro/release/grafeas.cfg
new file mode 100644
index 000000000000..8f0e2f271518
--- /dev/null
+++ b/.kokoro/release/grafeas.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "grafeas"
+}
diff --git a/.kokoro/release/iam.cfg b/.kokoro/release/iam.cfg
new file mode 100644
index 000000000000..812d891c07f8
--- /dev/null
+++ b/.kokoro/release/iam.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iam"
+}
diff --git a/.kokoro/release/iot.cfg b/.kokoro/release/iot.cfg
new file mode 100644
index 000000000000..dd388a8323e7
--- /dev/null
+++ b/.kokoro/release/iot.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "iot"
+}
diff --git a/.kokoro/release/irm.cfg b/.kokoro/release/irm.cfg
new file mode 100644
index 000000000000..ec847dd64e83
--- /dev/null
+++ b/.kokoro/release/irm.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "irm"
+}
diff --git a/.kokoro/release/kms.cfg b/.kokoro/release/kms.cfg
new file mode 100644
index 000000000000..ba634573085e
--- /dev/null
+++ b/.kokoro/release/kms.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "kms"
+}
diff --git a/.kokoro/release/language.cfg b/.kokoro/release/language.cfg
new file mode 100644
index 000000000000..c7ee4e650ca3
--- /dev/null
+++ b/.kokoro/release/language.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "language"
+}
diff --git a/.kokoro/release/logging.cfg b/.kokoro/release/logging.cfg
new file mode 100644
index 000000000000..cf274e2d626b
--- /dev/null
+++ b/.kokoro/release/logging.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "logging"
+}
diff --git a/.kokoro/release/monitoring.cfg b/.kokoro/release/monitoring.cfg
new file mode 100644
index 000000000000..80d261740e6f
--- /dev/null
+++ b/.kokoro/release/monitoring.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "monitoring"
+}
diff --git a/.kokoro/release/oslogin.cfg b/.kokoro/release/oslogin.cfg
new file mode 100644
index 000000000000..9ca9766f6e3a
--- /dev/null
+++ b/.kokoro/release/oslogin.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "oslogin"
+}
diff --git a/.kokoro/release/phishingprotection.cfg b/.kokoro/release/phishingprotection.cfg
new file mode 100644
index 000000000000..e21bd50ab4f1
--- /dev/null
+++ b/.kokoro/release/phishingprotection.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "phishingprotection"
+}
diff --git a/.kokoro/release/pubsub.cfg b/.kokoro/release/pubsub.cfg
new file mode 100644
index 000000000000..16c7ed3c175c
--- /dev/null
+++ b/.kokoro/release/pubsub.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "pubsub"
+}
diff --git a/.kokoro/release/redis.cfg b/.kokoro/release/redis.cfg
new file mode 100644
index 000000000000..268bc06a7101
--- /dev/null
+++ b/.kokoro/release/redis.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "redis"
+}
diff --git a/.kokoro/release/resource_manager.cfg b/.kokoro/release/resource_manager.cfg
new file mode 100644
index 000000000000..7a3976aef6cd
--- /dev/null
+++ b/.kokoro/release/resource_manager.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "resource_manager"
+}
diff --git a/.kokoro/release/runtimeconfig.cfg b/.kokoro/release/runtimeconfig.cfg
new file mode 100644
index 000000000000..2900b3c7e91a
--- /dev/null
+++ b/.kokoro/release/runtimeconfig.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "runtimeconfig"
+}
diff --git a/.kokoro/release/scheduler.cfg b/.kokoro/release/scheduler.cfg
new file mode 100644
index 000000000000..0701399853ef
--- /dev/null
+++ b/.kokoro/release/scheduler.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "scheduler"
+}
diff --git a/.kokoro/release/securitycenter.cfg b/.kokoro/release/securitycenter.cfg
new file mode 100644
index 000000000000..17dc427dae15
--- /dev/null
+++ b/.kokoro/release/securitycenter.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "securitycenter"
+}
diff --git a/.kokoro/release/spanner.cfg b/.kokoro/release/spanner.cfg
new file mode 100644
index 000000000000..d986f9d137f9
--- /dev/null
+++ b/.kokoro/release/spanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "spanner"
+}
diff --git a/.kokoro/release/speech.cfg b/.kokoro/release/speech.cfg
new file mode 100644
index 000000000000..b178b790be8d
--- /dev/null
+++ b/.kokoro/release/speech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "speech"
+}
diff --git a/.kokoro/release/storage.cfg b/.kokoro/release/storage.cfg
new file mode 100644
index 000000000000..6bd9371ff99d
--- /dev/null
+++ b/.kokoro/release/storage.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "storage"
+}
diff --git a/.kokoro/release/talent.cfg b/.kokoro/release/talent.cfg
new file mode 100644
index 000000000000..abafead62769
--- /dev/null
+++ b/.kokoro/release/talent.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "talent"
+}
diff --git a/.kokoro/release/tasks.cfg b/.kokoro/release/tasks.cfg
new file mode 100644
index 000000000000..2ae5c581b88d
--- /dev/null
+++ b/.kokoro/release/tasks.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "tasks"
+}
diff --git a/.kokoro/release/texttospeech.cfg b/.kokoro/release/texttospeech.cfg
new file mode 100644
index 000000000000..9e7d6d7f7980
--- /dev/null
+++ b/.kokoro/release/texttospeech.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "texttospeech"
+}
diff --git a/.kokoro/release/trace.cfg b/.kokoro/release/trace.cfg
new file mode 100644
index 000000000000..9169296e4753
--- /dev/null
+++ b/.kokoro/release/trace.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "trace"
+}
diff --git a/.kokoro/release/translate.cfg b/.kokoro/release/translate.cfg
new file mode 100644
index 000000000000..807c96195b41
--- /dev/null
+++ b/.kokoro/release/translate.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "translate"
+}
diff --git a/.kokoro/release/videointelligence.cfg b/.kokoro/release/videointelligence.cfg
new file mode 100644
index 000000000000..77d1d3fc49e6
--- /dev/null
+++ b/.kokoro/release/videointelligence.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "videointelligence"
+}
diff --git a/.kokoro/release/vision.cfg b/.kokoro/release/vision.cfg
new file mode 100644
index 000000000000..4f686b3abf42
--- /dev/null
+++ b/.kokoro/release/vision.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "vision"
+}
diff --git a/.kokoro/release/webrisk.cfg b/.kokoro/release/webrisk.cfg
new file mode 100644
index 000000000000..36b06f0b0b55
--- /dev/null
+++ b/.kokoro/release/webrisk.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "webrisk"
+}
diff --git a/.kokoro/release/websecurityscanner.cfg b/.kokoro/release/websecurityscanner.cfg
new file mode 100644
index 000000000000..221d1fc23d6b
--- /dev/null
+++ b/.kokoro/release/websecurityscanner.cfg
@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "websecurityscanner"
+}
diff --git a/.kokoro/trampoline.sh b/.kokoro/trampoline.sh
new file mode 100755
index 000000000000..e8c4251f3ed4
--- /dev/null
+++ b/.kokoro/trampoline.sh
@@ -0,0 +1,23 @@
+#!/bin/bash
+# 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.
+
+set -eo pipefail
+
+python3 "${KOKORO_GFILE_DIR}/trampoline_v1.py"  || ret_code=$?
+
+chmod +x ${KOKORO_GFILE_DIR}/trampoline_cleanup.sh
+${KOKORO_GFILE_DIR}/trampoline_cleanup.sh || true
+
+exit ${ret_code}
diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 000000000000..607de497679a
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,5 @@
+requirements_file: docs/requirements.txt
+build:
+  image: latest
+python:
+  version: 3.6
diff --git a/.settings/org.eclipse.core.resources.prefs b/.settings/org.eclipse.core.resources.prefs
new file mode 100644
index 000000000000..86179f70d44f
--- /dev/null
+++ b/.settings/org.eclipse.core.resources.prefs
@@ -0,0 +1,2 @@
+eclipse.preferences.version=1
+encoding//bigtable/docs/conf.py=utf-8
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index b222923baf11..000000000000
--- a/.travis.yml
+++ /dev/null
@@ -1,33 +0,0 @@
-language: python
-sudo: false
-
-install:
-  - pip install --upgrade pip tox
-
-script:
-  - tox -e py27
-  - tox -e py34
-  - tox -e lint
-  - tox -e cover
-  - tox -e system-tests
-  - tox -e system-tests3
-  - scripts/update_docs.sh
-
-after_success:
-  - tox -e coveralls
-
-deploy:
-  provider: pypi
-  user: gcloudpypi
-  password:
-    secure: LR0i9Oeu6kpLTYS5xK/zCng4gmdtPvFfD/XYdQhyY5jBibQkC2WUQU6nJA9bDXRxhBP5bUwXFGkbhOcOJgHNrUfmyPzpDbM8BR29KfY0WfdYv72gsGZOaekqCReFmHbqLE7qOQtHR5U3ey6ivcgw+hZO72Uu6qDCc9B8qwoBfAs=
-  on:
-    tags: true
-    repo: GoogleCloudPlatform/google-cloud-python
-    all_branches: true
-  # 'bdist_wheel' builds disabled until #1879 et al. are resolved.
-  distributions: "sdist"
-
-cache:
-  directories:
-    - ${HOME}/.cache/pip
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 000000000000..7301a860a45c
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,73 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud/#history
+
+## 0.32.0
+
+Packages newly added to the `google-cloud` umbrella package:
+
+- [`google-cloud-bigquery-datatransfer==0.1.0`](https://pypi.org/project/google-cloud-bigquery-datatransfer/0.1.0/)
+- [`google-cloud-container==0.1.0`](https://pypi.org/project/google-cloud-container/0.1.0/)
+
+Feature / bugfix release for the following packages:
+
+- [`google-api-core==0.1.2`](https://pypi.org/project/google-api-core/0.1.2/)
+- [`google-cloud-bigtable==0.28.1`](https://pypi.org/project/google-cloud-bigtable/0.28.1/)
+- [`google-cloud-pubsub==0.30.0`](https://pypi.org/project/google-cloud-pubsub/0.30.0/)
+- [`google-cloud-trace==0.17.0`](https://pypi.org/project/google-cloud-trace/0.17.0/)
+- [`google-cloud-vision==0.29.0`](https://pypi.org/project/google-cloud-vision/0.29.0/)
+
+## 0.31.0
+
+Feature / bugfix release for the following packages:
+
+  *  [`google-cloud-pubsub==0.29.1`](https://pypi.org/project/google-cloud-pubsub/0.29.1/)
+  *  [`google-cloud-videointelligence==1.0.0`](https://pypi.org/project/google-cloud-videointelligence/1.0.0/)
+
+## 0.30.0
+
+Feature / bugfix release for the following package:
+
+  *  [`google-cloud-language==1.0.0`](https://pypi.org/project/google-cloud-language/1.0.0/)
+
+## 0.29.0
+
+Feature / bugfix release for the following package:
+
+- [`google-cloud-language==0.31.0`](https://pypi.org/project/google-cloud-language/0.31.0/)
+
+## 0.28.0
+
+Packages newly added to the `google-cloud` umbrella package:
+
+- [`google-api-core==0.1.1`](https://pypi.org/project/google-api-core/0.1.1/)
+- [`google-cloud-firestore==0.28.0`](https://pypi.org/project/google-cloud-firestore/0.28.0/)
+- [`google-cloud-trace==0.16.0`](https://pypi.org/project/google-cloud-trace/0.16.0/)
+- [`google-cloud-videointelligence=0.28.0`](https://pypi.org/project/google-cloud-videointelligence/0.28.0/)
+
+Feature / bugfix releases for the following packages:
+
+- [`google-cloud-bigquery==0.28.0`](https://pypi.org/project/google-cloud-bigquery/0.28.0/)
+- [`google-cloud-core==0.28.0`](https://pypi.org/project/google-cloud-core/0.28.0/)
+- [`google-cloud-datastore==1.4.0`](https://pypi.org/project/google-cloud-datastore/1.4.0/)
+- [`google-cloud-logging==1.4.0`](https://pypi.org/project/google-cloud-logging/1.4.0/)
+- [`google-cloud-pubsub==0.29.0`](https://pypi.org/project/google-cloud-pubsub/0.29.0/)
+- [`google-cloud-spanner==0.29.0`](https://pypi.org/project/google-cloud-spanner/0.29.0/)
+- [`google-cloud-translate==1.3.0`](https://pypi.org/project/google-cloud-translate/1.3.0/)
+- [`google-cloud-vision==0.28.0`](https://pypi.org/project/google-cloud-vision/0.28.0/)
+
+Dependency-only / user-invisible changes to the following packages:
+
+- [`google-cloud-bigtable==0.28.0`](https://pypi.org/project/google-cloud-bigtable/0.28.0/)
+- [`google-cloud-dns==0.28.0`](https://pypi.org/project/google-cloud-dns/0.28.0/)
+- [`google-cloud-error-reporting==0.28.0`](https://pypi.org/project/google-cloud-error-reporting/0.28.0/)
+- [`google-cloud-language==0.30.0`](https://pypi.org/project/google-cloud-language/0.30.0/)
+- [`google-cloud-monitoring==0.28.0`](https://pypi.org/project/google-cloud-monitoring/0.28.0/)
+- [`google-cloud-resource-manager==0.28.0`](https://pypi.org/project/google-cloud-resource-manager/0.28.0/)
+- [`google-cloud-runtimeconfig==0.28.0`](https://pypi.org/project/google-cloud-runtimeconfig/0.28.0/)
+- [`google-cloud-speech==0.30.0`](https://pypi.org/project/google-cloud-speech/0.30.0/)
+- [`google-cloud-storage==1.6.0`](https://pypi.org/project/google-cloud-storage/1.6.0/)
+
+PyPI: https://pypi.org/project/google-cloud/0.28.0/
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 9cb07618962e..b05875c89e81 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -1,37 +1,55 @@
+############
 Contributing
-============================
+############
 
 #. **Please sign one of the contributor license agreements below.**
 #. Fork the repo, develop and test your code changes, add docs.
 #. Make sure that your commit messages clearly describe the changes.
-#. Send a pull request.
+#. Send a pull request. (Please Read: `Faster Pull Request Reviews`_)
 
-Here are some guidelines for hacking on ``google-cloud-python``.
+.. _Faster Pull Request Reviews: https://github.com/kubernetes/community/blob/master/contributors/guide/pull-requests.md#best-practices-for-faster-reviews
 
-Using a Development Checkout
-----------------------------
+.. contents:: Here are some guidelines for hacking on ``google-cloud-python``.
+
+***************
+Adding Features
+***************
+
+In order to add a feature to ``google-cloud-python``:
+
+- The feature must be documented in both the API and narrative
+  documentation (in ``docs/``).
+
+- The feature must work fully on the following CPython versions:  2.7,
+  3.5, 3.6, and 3.7 on both UNIX and Windows.
 
-You'll have to create a development environment to hack on ``google-cloud-python``,
-using a Git checkout:
+- The feature must not add unnecessary dependencies (where
+  "unnecessary" is of course subjective, but new dependencies should
+  be discussed).
 
-- While logged into your GitHub account, navigate to the ``google-cloud-python`` repo
-  on GitHub.
+****************************
+Using a Development Checkout
+****************************
 
-  https://github.com/GoogleCloudPlatform/google-cloud-python
+You'll have to create a development environment to hack on
+``google-cloud-python``, using a Git checkout:
+
+- While logged into your GitHub account, navigate to the
+  ``google-cloud-python`` `repo`_ on GitHub.
 
 - Fork and clone the ``google-cloud-python`` repository to your GitHub account by
   clicking the "Fork" button.
 
 - Clone your fork of ``google-cloud-python`` from your GitHub account to your local
   computer, substituting your account username and specifying the destination
-  as "hack-on-google-cloud-python".  E.g.::
+  as ``hack-on-google-cloud-python``.  E.g.::
 
-   $ cd ~
+   $ cd ${HOME}
    $ git clone git@github.com:USERNAME/google-cloud-python.git hack-on-google-cloud-python
    $ cd hack-on-google-cloud-python
    # Configure remotes such that you can pull changes from the google-cloud-python
    # repository into your local repository.
-   $ git remote add upstream https://github.com:GoogleCloudPlatform/google-cloud-python
+   $ git remote add upstream git@github.com:GoogleCloudPlatform/google-cloud-python.git
    # fetch and merge changes from upstream into master
    $ git fetch upstream
    $ git merge upstream/master
@@ -39,69 +57,82 @@ using a Git checkout:
 Now your local repo is set up such that you will push changes to your GitHub
 repo, from which you can submit a pull request.
 
-- Create a virtualenv in which to install ``google-cloud-python``::
+To work on the codebase and run the tests, we recommend using ``nox``,
+but you can also use a ``virtualenv`` of your own creation.
 
-   $ cd ~/hack-on-google-cloud-python
-   $ virtualenv --python python2.7 env
+.. _repo: https://github.com/GoogleCloudPlatform/google-cloud-python
 
-  Note that very old versions of virtualenv (virtualenv versions below, say,
-  1.10 or thereabouts) require you to pass a ``--no-site-packages`` flag to
-  get a completely isolated environment.
+Using ``nox``
+=============
 
-  You can choose which Python version you want to use by passing a ``--python``
-  flag to ``virtualenv``.  For example, ``virtualenv --python python2.7``
-  chooses the Python 2.7 interpreter to be installed.
+We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
-  From here on in within these instructions, the ``~/hack-on-google-cloud-python/env``
-  virtual environment you created above will be referred to as ``$VENV``.
-  To use the instructions in the steps that follow literally, use the
-  ``export VENV=~/hack-on-google-cloud-python/env`` command.
+- To test your changes, run unit tests with ``nox``::
 
-- Install ``google-cloud-python`` from the checkout into the virtualenv using
-  ``setup.py develop``.  Running ``setup.py develop`` *must* be done while
-  the current working directory is the ``google-cloud-python`` checkout directory::
+    $ nox -f datastore/noxfile.py -s unit-2.7
+    $ nox -f datastore/noxfile.py -s unit-3.7
+    $ ...
 
-   $ cd ~/hack-on-google-cloud-python
-   $ $VENV/bin/python setup.py develop
+  .. note::
 
-I'm getting weird errors... Can you help?
------------------------------------------
+    The unit tests and system tests are contained in the individual
+    ``nox.py`` files in each directory; substitute ``datastore`` in the
+    example above with the package of your choice.
 
-If the error mentions ``Python.h`` not being found,
-install ``python-dev`` and try again.
-On Debian/Ubuntu::
 
-  $ sudo apt-get install python-dev
+  Alternatively, you can just navigate directly to the package you are
+  currently developing and run tests there::
 
-Adding Features
----------------
+    $ export GIT_ROOT=$(pwd)
+    $ cd ${GIT_ROOT}/datastore/
+    $ nox -s "unit(py='3.7')"
 
-In order to add a feature to ``google-cloud-python``:
+.. nox: https://pypi.org/project/nox-automation/
 
-- The feature must be documented in both the API and narrative
-  documentation (in ``docs/``).
+Note on Editable Installs / Develop Mode
+========================================
 
-- The feature must work fully on the following CPython versions:  2.7,
-  3.4, and 3.5 on both UNIX and Windows.
+- As mentioned previously, using ``setuptools`` in `develop mode`_
+  or a ``pip`` `editable install`_ is not possible with this
+  library. This is because this library uses `namespace packages`_.
+  For context see `Issue #2316`_ and the relevant `PyPA issue`_.
 
-- The feature must not add unnecessary dependencies (where
-  "unnecessary" is of course subjective, but new dependencies should
-  be discussed).
+  Since ``editable`` / ``develop`` mode can't be used, packages
+  need to be installed directly. Hence your changes to the source
+  tree don't get incorporated into the **already installed**
+  package.
+
+.. _namespace packages: https://www.python.org/dev/peps/pep-0420/
+.. _Issue #2316: https://github.com/GoogleCloudPlatform/google-cloud-python/issues/2316
+.. _PyPA issue: https://github.com/pypa/packaging-problems/issues/12
+.. _develop mode: https://setuptools.readthedocs.io/en/latest/setuptools.html#development-mode
+.. _editable install: https://pip.pypa.io/en/stable/reference/pip_install/#editable-installs
 
+*****************************************
+I'm getting weird errors... Can you help?
+*****************************************
+
+If the error mentions ``Python.h`` not being found,
+install ``python-dev`` and try again.
+On Debian/Ubuntu::
+
+  $ sudo apt-get install python-dev
+
+************
 Coding Style
-------------
+************
 
-- PEP8 compliance, with exceptions defined in ``tox.ini``.
-  If you have ``tox`` installed, you can test that you have not introduced
+- PEP8 compliance, with exceptions defined in the linter configuration.
+  If you have ``nox`` installed, you can test that you have not introduced
   any non-compliant code via::
 
-   $ tox -e lint
+   $ nox -s lint
 
-- In order to make ``tox -e lint`` run faster, you can set some environment
+- In order to make ``nox -s lint`` run faster, you can set some environment
   variables::
 
-   export GOOGLE_CLOUD_REMOTE_FOR_LINT="upstream"
-   export GOOGLE_CLOUD_BRANCH_FOR_LINT="master"
+   export GOOGLE_CLOUD_TESTING_REMOTE="upstream"
+   export GOOGLE_CLOUD_TESTING_BRANCH="master"
 
   By doing this, you are specifying the location of the most up-to-date
   version of ``google-cloud-python``. The the suggested remote name ``upstream``
@@ -110,47 +141,24 @@ Coding Style
 
 Exceptions to PEP8:
 
-- Many unit tests use a helper method, ``_callFUT`` ("FUT" is short for
+- Many unit tests use a helper method, ``_call_fut`` ("FUT" is short for
   "Function-Under-Test"), which is PEP8-incompliant, but more readable.
   Some also use a local variable, ``MUT`` (short for "Module-Under-Test").
 
-Running Tests
---------------
-
-- To run all tests for ``google-cloud-python`` on a single Python version, run
-  ``py.test`` from your development virtualenv (See
-  *Using a Development Checkout* above).
-
-- To run the full set of ``google-cloud-python`` tests on all platforms, install
-  ``tox`` (https://testrun.org/tox/) into a system Python.  The ``tox`` console
-  script will be installed into the scripts location for that Python.  While
-  ``cd``'ed to the ``google-cloud-python`` checkout root directory (it contains
-  ``tox.ini``), invoke the ``tox`` console script.  This will read the
-  ``tox.ini`` file and execute the tests on multiple Python versions and
-  platforms; while it runs, it creates a virtualenv for each version/platform
-  combination.  For example::
-
-   $ sudo /usr/bin/pip install tox
-   $ cd ~/hack-on-google-cloud-python/
-   $ /usr/bin/tox
-
+********************
 Running System Tests
---------------------
+********************
 
-- To run system tests you can execute::
+- To run system tests for a given package, you can execute::
 
-   $ tox -e system-tests
-   $ tox -e system-tests3
+   $ nox -f datastore/noxfile.py -s system-3.7
+   $ nox -f datastore/noxfile.py -s system-2.7
 
-  or run only system tests for a particular package via::
+  .. note::
 
-   $ python system_tests/run_system_test.py --package {package}
-   $ python3 system_tests/run_system_test.py --package {package}
-
-  To run a subset of the system tests::
-
-   $ tox -e system-tests -- datastore storage
-   $ python system_tests/attempt_system_tests.py datastore storage
+      System tests are only configured to run under Python 2.7 and
+      Python 3.7. For expediency, we do not run them in older versions
+      of Python 3.
 
   This alone will not run the tests. You'll need to change some local
   auth settings and change some configuration in your project to
@@ -161,20 +169,20 @@ Running System Tests
   authentication to your project:
 
   - ``GOOGLE_APPLICATION_CREDENTIALS``: The path to a JSON key file;
-    see ``system_tests/app_credentials.json.sample`` as an example. Such a file
-    can be downloaded directly from the developer's console by clicking
+    Such a file can be downloaded directly from the developer's console by clicking
     "Generate new JSON key". See private key
     `docs <https://cloud.google.com/storage/docs/authentication#generating-a-private-key>`__
-    for more details. In order for Logging system tests to work, the Service Account
-    will also have to be made a project Owner. This can be changed under "IAM & Admin".
-  - ``GOOGLE_CLOUD_TESTS_API_KEY``: The API key for your project with
-    the Google Translate API (and others) enabled.
+    for more details.
 
-- Examples of these can be found in ``system_tests/local_test_setup.sample``. We
-  recommend copying this to ``system_tests/local_test_setup``, editing the
-  values and sourcing them into your environment::
+  - In order for Logging system tests to work, the Service Account
+    will also have to be made a project ``Owner``. This can be changed under
+    "IAM & Admin". Additionally, ``cloud-logs@google.com`` must be given
+    ``Editor`` permissions on the project.
 
-   $ source system_tests/local_test_setup
+- Once you have downloaded your json keys, set the environment variable 
+  ``GOOGLE_APPLICATION_CREDENTIALS`` to the absolute path of the json file::
+
+   $ export GOOGLE_APPLICATION_CREDENTIALS="/Users/<your_username>/path/to/app_credentials.json"
 
 - For datastore tests, you'll need to create composite
   `indexes <https://cloud.google.com/datastore/docs/tools/indexconfig>`__
@@ -182,11 +190,7 @@ Running System Tests
   `tool <https://developers.google.com/cloud/sdk/gcloud/>`__::
 
    # Install the app (App Engine Command Line Interface) component.
-   $ gcloud components update app
-
-   # See https://cloud.google.com/sdk/crypto for details on PyOpenSSL and
-   # http://stackoverflow.com/a/25067729/1068170 for why we must persist.
-   $ export CLOUDSDK_PYTHON_SITEPACKAGES=1
+   $ gcloud components install app-engine-python
 
    # Authenticate the gcloud tool with your account.
    $ GOOGLE_APPLICATION_CREDENTIALS="path/to/app_credentials.json"
@@ -194,132 +198,66 @@ Running System Tests
    > --key-file=${GOOGLE_APPLICATION_CREDENTIALS}
 
    # Create the indexes
-   $ gcloud preview datastore create-indexes system_tests/data/index.yaml
-
-   # Restore your environment to its previous state.
-   $ unset CLOUDSDK_PYTHON_SITEPACKAGES
+   $ gcloud datastore indexes create datastore/tests/system/index.yaml
 
 - For datastore query tests, you'll need stored data in your dataset.
   To populate this data, run::
 
-   $ python system_tests/populate_datastore.py
+   $ python datastore/tests/system/utils/populate_datastore.py
 
 - If you make a mistake during development (i.e. a failing test that
   prevents clean-up) you can clear all system test data from your
   datastore instance via::
 
-   $ python system_tests/clear_datastore.py
-
-- System tests can also be run against local `emulators`_ that mock
-  the production services. To run the system tests with the
-  ``datastore`` emulator::
-
-   $ tox -e datastore-emulator
-   $ GOOGLE_CLOUD_DISABLE_GRPC=true tox -e datastore-emulator
-
-  This also requires that the ``gcloud`` command line tool is
-  installed. If you'd like to run them directly (outside of a
-  ``tox`` environment), first start the emulator and
-  take note of the process ID::
-
-   $ gcloud beta emulators datastore start --no-legacy 2>&1 > log.txt &
-   [1] 33333
-
-  then determine the environment variables needed to interact with
-  the emulator::
-
-   $ gcloud beta emulators datastore env-init
-   export DATASTORE_LOCAL_HOST=localhost:8417
-   export DATASTORE_HOST=http://localhost:8417
-   export DATASTORE_DATASET=google-cloud-settings-app-id
-   export DATASTORE_PROJECT_ID=google-cloud-settings-app-id
-
-  using these environment variables run the emulator::
-
-   $ DATASTORE_HOST=http://localhost:8471 \
-   >   DATASTORE_DATASET=google-cloud-settings-app-id \
-   >   GOOGLE_CLOUD_NO_PRINT=true \
-   >   python system_tests/run_system_test.py \
-   >   --package=datastore --ignore-requirements
+   $ python datastore/tests/system/utils/clear_datastore.py
 
-  and after completion stop the emulator and any child
-  processes it spawned::
-
-   $ kill -- -33333
-
-.. _emulators: https://cloud.google.com/sdk/gcloud/reference/beta/emulators/
-
-- To run the system tests with the ``pubsub`` emulator::
-
-   $ tox -e pubsub-emulator
-   $ GOOGLE_CLOUD_DISABLE_GRPC=true tox -e pubsub-emulator
-
-  If you'd like to run them directly (outside of a ``tox`` environment), first
-  start the emulator and take note of the process ID::
-
-   $ gcloud beta emulators pubsub start 2>&1 > log.txt &
-   [1] 44444
-
-  then determine the environment variables needed to interact with
-  the emulator::
-
-   $ gcloud beta emulators pubsub env-init
-   export PUBSUB_EMULATOR_HOST=localhost:8897
-
-  using these environment variables run the emulator::
-
-   $ PUBSUB_EMULATOR_HOST=localhost:8897 \
-   >   python system_tests/run_system_test.py \
-   >   --package=pubsub
-
-  and after completion stop the emulator and any child
-  processes it spawned::
-
-   $ kill -- -44444
 
+*************
 Test Coverage
--------------
+*************
 
 - The codebase *must* have 100% test statement coverage after each commit.
-  You can test coverage via ``tox -e cover``.
+  You can test coverage via ``nox -s cover``.
 
+******************************************************
 Documentation Coverage and Building HTML Documentation
-------------------------------------------------------
+******************************************************
 
 If you fix a bug, and the bug requires an API or behavior modification, all
 documentation in this package which references that API or behavior must be
 changed to reflect the bug fix, ideally in the same commit that fixes the bug
 or adds the feature.
 
-To build and review docs (where ``$VENV`` refers to the virtualenv you're
+To build and review docs (where ``${VENV}`` refers to the virtualenv you're
 using to develop ``google-cloud-python``):
 
-1. After following the steps above in "Using a Development Checkout", install
+#. After following the steps above in "Using a Development Checkout", install
    Sphinx and all development requirements in your virtualenv::
 
-     $ cd ~/hack-on-google-cloud-python
-     $ $VENV/bin/pip install Sphinx
+     $ cd ${HOME}/hack-on-google-cloud-python
+     $ ${VENV}/bin/pip install Sphinx
 
-2. Change into the ``docs`` directory within your ``google-cloud-python`` checkout and
+#. Change into the ``docs`` directory within your ``google-cloud-python`` checkout and
    execute the ``make`` command with some flags::
 
-     $ cd ~/hack-on-google-cloud-python/google-cloud-python/docs
-     $ make clean html SPHINXBUILD=$VENV/bin/sphinx-build
+     $ cd ${HOME}/hack-on-google-cloud-python/google-cloud-python/docs
+     $ make clean html SPHINXBUILD=${VENV}/bin/sphinx-build
 
    The ``SPHINXBUILD=...`` argument tells Sphinx to use the virtualenv Python,
    which will have both Sphinx and ``google-cloud-python`` (for API documentation
    generation) installed.
 
-3. Open the ``docs/_build/html/index.html`` file to see the resulting HTML
+#. Open the ``docs/_build/html/index.html`` file to see the resulting HTML
    rendering.
 
-As an alternative to 1. and 2. above, if you have ``tox`` installed, you
+As an alternative to 1. and 2. above, if you have ``nox`` installed, you
 can build the docs via::
 
-   $ tox -e docs
+   $ nox -s docs
 
+********************************************
 Note About ``README`` as it pertains to PyPI
---------------------------------------------
+********************************************
 
 The `description on PyPI`_ for the project comes directly from the
 ``README``. Due to the reStructuredText (``rst``) parser used by
@@ -328,58 +266,51 @@ instead of
 ``https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/CONTRIBUTING.rst``)
 may cause problems creating links or rendering the description.
 
-.. _description on PyPI: https://pypi.python.org/pypi/google-cloud
-
-Travis Configuration and Build Optimizations
---------------------------------------------
+.. _description on PyPI: https://pypi.org/project/google-cloud/
 
-All build scripts in the ``.travis.yml`` configuration file which have
-Python dependencies are specified in the ``tox.ini`` configuration.
-They are executed in the Travis build via ``tox -e {ENV}`` where
-``{ENV}`` is the environment being tested.
+**********************
+CircleCI Configuration
+**********************
 
-If new ``tox`` environments are added to be run in a Travis build, they
-should be listed in ``[tox].envlist`` as a default environment.
+All build scripts in the ``.circleci/config.yml`` configuration file which have
+Python dependencies are specified in the ``nox.py`` configuration.
+They are executed in the Travis build via ``nox -s ${ENV}`` where
+``${ENV}`` is the environment being tested.
 
-We speed up builds by using the Travis `caching feature`_.
-
-.. _caching feature: https://docs.travis-ci.com/user/caching/#pip-cache
-
-We intentionally **do not** cache the ``.tox/`` directory. Instead, we
-allow the ``tox`` environments to be re-built for every build. This
-way, we'll always get the latest versions of our dependencies and any
-caching or wheel optimization to be done will be handled automatically
-by ``pip``.
 
+*************************
 Supported Python Versions
--------------------------
+*************************
 
 We support:
 
--  `Python 2.7`_
--  `Python 3.4`_
 -  `Python 3.5`_
+-  `Python 3.6`_
+-  `Python 3.7`_
 
-.. _Python 2.7: https://docs.python.org/2.7/
-.. _Python 3.4: https://docs.python.org/3.4/
 .. _Python 3.5: https://docs.python.org/3.5/
+.. _Python 3.6: https://docs.python.org/3.6/
+.. _Python 3.7: https://docs.python.org/3.7/
 
-Supported versions can be found in our ``tox.ini`` `config`_.
 
-.. _config: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/tox.ini
+Supported versions can be found in our ``noxfile.py`` `config`_.
+
+.. _config: https://github.com/googleapis/google-cloud-python/blob/master/noxfile.py
 
 We explicitly decided not to support `Python 2.5`_ due to `decreased usage`_
 and lack of continuous integration `support`_.
 
 .. _Python 2.5: https://docs.python.org/2.5/
 .. _decreased usage: https://caremad.io/2013/10/a-look-at-pypi-downloads/
-.. _support: http://blog.travis-ci.com/2013-11-18-upcoming-build-environment-updates/
+.. _support: https://blog.travis-ci.com/2013-11-18-upcoming-build-environment-updates/
 
 We have `dropped 2.6`_ as a supported version as well since Python 2.6 is no
 longer supported by the core development team.
 
+Python 2.7 support is deprecated. All code changes should maintain Python 2.7 compatibility until January 1, 2020.
+
 We also explicitly decided to support Python 3 beginning with version
-3.4. Reasons for this include:
+3.5. Reasons for this include:
 
 -  Encouraging use of newest versions of Python 3
 -  Taking the lead of `prominent`_ open-source `projects`_
@@ -389,25 +320,33 @@ We also explicitly decided to support Python 3 beginning with version
 .. _prominent: https://docs.djangoproject.com/en/1.9/faq/install/#what-python-version-can-i-use-with-django
 .. _projects: http://flask.pocoo.org/docs/0.10/python3/
 .. _Unicode literal support: https://www.python.org/dev/peps/pep-0414/
-.. _dropped 2.6: https://github.com/GoogleCloudPlatform/google-cloud-python/issues/995
+.. _dropped 2.6: https://github.com/googleapis/google-cloud-python/issues/995
 
+**********
 Versioning
-----------
+**********
 
 This library follows `Semantic Versioning`_.
 
 .. _Semantic Versioning: http://semver.org/
 
-It is currently in major version zero (``0.y.z``), which means that anything
-may change at any time and the public API should not be considered
+Some packages are currently in major version zero (``0.y.z``), which means that
+anything may change at any time and the public API should not be considered
 stable.
 
+******************************
 Contributor License Agreements
-------------------------------
+******************************
 
-Before we can accept your pull requests you'll need to sign a Contributor License Agreement (CLA):
+Before we can accept your pull requests you'll need to sign a Contributor
+License Agreement (CLA):
 
-- **If you are an individual writing original source code** and **you own the intellectual property**, then you'll need to sign an `individual CLA <https://developers.google.com/open-source/cla/individual>`__.
-- **If you work for a company that wants to allow you to contribute your work**, then you'll need to sign a `corporate CLA <https://developers.google.com/open-source/cla/corporate>`__.
+- **If you are an individual writing original source code** and **you own the
+  intellectual property**, then you'll need to sign an
+  `individual CLA <https://developers.google.com/open-source/cla/individual>`__.
+- **If you work for a company that wants to allow you to contribute your work**,
+  then you'll need to sign a
+  `corporate CLA <https://developers.google.com/open-source/cla/corporate>`__.
 
-You can sign these electronically (just scroll to the bottom). After that, we'll be able to accept your pull requests.
+You can sign these electronically (just scroll to the bottom). After that,
+we'll be able to accept your pull requests.
diff --git a/MANIFEST.in b/MANIFEST.in
deleted file mode 100644
index ae20b86a84fd..000000000000
--- a/MANIFEST.in
+++ /dev/null
@@ -1,3 +0,0 @@
-include README.rst
-graft google
-global-exclude *.pyc
diff --git a/Makefile.bigtable_v2 b/Makefile.bigtable_v2
index 46a958cf4234..b739053e0116 100644
--- a/Makefile.bigtable_v2
+++ b/Makefile.bigtable_v2
@@ -1,15 +1,15 @@
 GRPCIO_VIRTUALENV=$(shell pwd)/grpc_python_venv
 GENERATED_DIR=$(shell pwd)/generated_python
 GENERATED_SUBDIR=_generated
-BIGTABLE_DIR=$(shell pwd)/google/cloud/bigtable/$(GENERATED_SUBDIR)
+BIGTABLE_DIR=$(shell pwd)/bigtable/google/cloud/bigtable/$(GENERATED_SUBDIR)
 PROTOC_CMD=$(GRPCIO_VIRTUALENV)/bin/python -m grpc.tools.protoc
 GOOGLEAPIS_PROTOS_DIR=$(shell pwd)/googleapis-pb
 
 help:
-	@echo 'Makefile for google-cloud-python Bigtable protos                      '
-	@echo '                                                                '
-	@echo '   make generate                 Generates the protobuf modules '
-	@echo '   make clean                    Clean generated files          '
+	@echo 'Makefile for google-cloud-python Bigtable protos      '
+	@echo '                                                      '
+	@echo '   make generate        Generates the protobuf modules'
+	@echo '   make clean           Clean generated files         '
 
 generate:
 	# Ensure we have a virtualenv w/ up-to-date grpcio/grpcio-tools
@@ -44,7 +44,6 @@ generate:
 	# Copy over the *.proto files into our library.
 	cp $(GOOGLEAPIS_PROTOS_DIR)/google/bigtable/v2/*.proto $(BIGTABLE_DIR)
 	cp $(GOOGLEAPIS_PROTOS_DIR)/google/bigtable/admin/v2/*.proto $(BIGTABLE_DIR)
-	cp $(GOOGLEAPIS_PROTOS_DIR)/google/longrunning/operations.proto $(BIGTABLE_DIR)
 	# Rename all *.proto files in our library with an
 	# underscore and remove executable bit.
 	cd $(BIGTABLE_DIR) && \
@@ -52,12 +51,7 @@ generate:
 	        chmod -x $$filename ; \
 	        mv $$filename _$$filename ; \
 	    done
-	# Separate the gRPC parts of the operations service from the
-	# non-gRPC parts so that the protos from `googleapis-common-protos`
-	# can be used without gRPC.
 	GRPCIO_VIRTUALENV="$(GRPCIO_VIRTUALENV)" \
-	GENERATED_SUBDIR=$(GENERATED_SUBDIR) \
-		python scripts/make_operations_grpc.py
 	# Rewrite the imports in the generated *_pb2.py files.
 	python scripts/rewrite_imports.py $(BIGTABLE_DIR)/*pb2.py
 
diff --git a/Makefile.datastore b/Makefile.datastore
deleted file mode 100644
index 837f5ba26390..000000000000
--- a/Makefile.datastore
+++ /dev/null
@@ -1,53 +0,0 @@
-GRPCIO_VIRTUALENV=$(shell pwd)/grpc_python_venv
-GENERATED_DIR=$(shell pwd)/generated_python
-DATASTORE_DIR=$(shell pwd)/google/cloud/datastore/_generated
-PROTOC_CMD=$(GRPCIO_VIRTUALENV)/bin/python -m grpc.tools.protoc
-GOOGLEAPIS_PROTOS_DIR=$(shell pwd)/googleapis-pb
-
-help:
-	@echo 'Makefile for google-cloud-python Bigtable protos                      '
-	@echo '                                                                '
-	@echo '   make generate                 Generates the protobuf modules '
-	@echo '   make clean                    Clean generated files          '
-
-generate:
-	# Ensure we have a virtualenv w/ up-to-date grpcio/grpcio-tools
-	[ -d $(GRPCIO_VIRTUALENV) ] || python2.7 -m virtualenv $(GRPCIO_VIRTUALENV)
-	$(GRPCIO_VIRTUALENV)/bin/pip install --upgrade grpcio grpcio-tools
-	# Retrieve git repos that have our *.proto files.
-	[ -d googleapis-pb ] || git clone https://github.com/googleapis/googleapis googleapis-pb --depth=1
-	cd googleapis-pb && git pull origin master
-	# Make the directory where our *_pb2.py files will go.
-	mkdir -p $(GENERATED_DIR)
-	# Generate all *_pb2.py files that do not require gRPC.
-	$(PROTOC_CMD) \
-	    --proto_path=$(GOOGLEAPIS_PROTOS_DIR) \
-	    --python_out=$(GENERATED_DIR) \
-	    $(GOOGLEAPIS_PROTOS_DIR)/google/datastore/v1/datastore.proto \
-	    $(GOOGLEAPIS_PROTOS_DIR)/google/datastore/v1/entity.proto \
-	    $(GOOGLEAPIS_PROTOS_DIR)/google/datastore/v1/query.proto
-	# Move the newly generated *_pb2.py files into our library.
-	cp $(GENERATED_DIR)/google/datastore/v1/* $(DATASTORE_DIR)
-	# Remove all existing *.proto files before we replace
-	rm -f $(DATASTORE_DIR)/*.proto
-	# Copy over the *.proto files into our library.
-	cp $(GOOGLEAPIS_PROTOS_DIR)/google/datastore/v1/*.proto $(DATASTORE_DIR)
-	# Rename all *.proto files in our library with an
-	# underscore and remove executable bit.
-	cd $(DATASTORE_DIR) && \
-	    for filename in *.proto; do \
-	        chmod -x $$filename ; \
-	        mv $$filename _$$filename ; \
-	    done
-	# Separate the gRPC parts of the datastore service from the
-	# non-gRPC parts so that the protos can be used without gRPC.
-	GRPCIO_VIRTUALENV="$(GRPCIO_VIRTUALENV)" \
-	GENERATED_SUBDIR=$(GENERATED_SUBDIR) \
-		python scripts/make_datastore_grpc.py
-	# Rewrite the imports in the generated *_pb2.py files.
-	python scripts/rewrite_imports.py $(DATASTORE_DIR)/*pb2.py
-
-clean:
-	rm -fr $(GENERATED_DIR)
-
-.PHONY: generate clean
diff --git a/README.rst b/README.rst
index 39568ec8a5a8..f0820498cc21 100644
--- a/README.rst
+++ b/README.rst
@@ -1,47 +1,170 @@
 Google Cloud Python Client
 ==========================
 
-    Python idiomatic client for `Google Cloud Platform`_ services.
+Python idiomatic clients for `Google Cloud Platform`_ services.
 
 .. _Google Cloud Platform: https://cloud.google.com/
 
-|pypi| |build| |appveyor| |coverage| |versions|
+**Heads up**! These libraries are supported on App Engine standard's `Python 3 runtime`_ but are *not* supported on App Engine's `Python 2 runtime`_.
 
--  `Homepage`_
--  `API Documentation`_
+.. _Python 3 runtime: https://cloud.google.com/appengine/docs/standard/python3
+.. _Python 2 runtime: https://cloud.google.com/appengine/docs/standard/python
 
-.. _Homepage: https://googlecloudplatform.github.io/google-cloud-python/
-.. _API Documentation: http://googlecloudplatform.github.io/google-cloud-python/
-
-This client supports the following Google Cloud Platform services:
+General Availability
+--------------------
 
--  `Google Cloud Datastore`_
--  `Google Cloud Storage`_
--  `Google Cloud Pub/Sub`_
--  `Google BigQuery`_
--  `Google Cloud Resource Manager`_
--  `Google Stackdriver Logging`_
--  `Google Stackdriver Monitoring`_
+**GA** (general availability) indicates that the client library for a
+particular service is stable, and that the code surface will not change in
+backwards-incompatible ways unless either absolutely necessary (e.g. because
+of critical security issues) or with an extensive deprecation period.
+Issues and requests against GA libraries are addressed with the highest
+priority.
+
+.. note::
+
+    Sub-components of GA libraries explicitly marked as beta in the
+    import path (e.g. ``google.cloud.language_v1beta2``) should be considered
+    to be beta.
+
+The following client libraries have **GA** support:
+
+-  `Google BigQuery`_ (`BigQuery README`_)
+-  `Google Cloud Datastore`_ (`Datastore README`_)
+-  `Google Cloud KMS`_ (`KMS README`_)
+-  `Google Cloud Natural Language`_ (`Natural Language README`_)
+-  `Google Cloud Scheduler`_ (`Scheduler README`_)
+-  `Google Cloud Spanner`_ (`Spanner README`_)
+-  `Google Cloud Speech`_ (`Speech README`_)
+-  `Google Cloud Storage`_ (`Storage README`_)
+-  `Google Cloud Tasks`_ (`Tasks README`_)
+-  `Google Cloud Translation`_ (`Translation README`_)
+-  `Stackdriver Logging`_ (`Logging README`_)
+
+.. _Google BigQuery: https://pypi.org/project/google-cloud-bigquery/
+.. _BigQuery README: https://github.com/googleapis/google-cloud-python/tree/master/bigquery
+.. _Google Cloud Datastore: https://pypi.org/project/google-cloud-datastore/
+.. _Datastore README: https://github.com/googleapis/google-cloud-python/tree/master/datastore
+.. _Google Cloud KMS: https://pypi.org/project/google-cloud-kms/
+.. _KMS README: https://github.com/googleapis/google-cloud-python/tree/master/kms
+.. _Google Cloud Natural Language: https://pypi.org/project/google-cloud-language/
+.. _Natural Language README: https://github.com/googleapis/google-cloud-python/tree/master/language
+.. _Google Cloud Spanner: https://pypi.org/project/google-cloud-spanner
+.. _Spanner README: https://github.com/googleapis/google-cloud-python/tree/master/spanner
+.. _Google Cloud Speech: https://pypi.org/project/google-cloud-speech/
+.. _Speech README: https://github.com/googleapis/google-cloud-python/tree/master/speech
+.. _Google Cloud Storage: https://pypi.org/project/google-cloud-storage/
+.. _Storage README: https://github.com/googleapis/google-cloud-python/tree/master/storage
+.. _Google Cloud Tasks: https://pypi.org/project/google-cloud-tasks/
+.. _Tasks README: https://github.com/googleapis/google-cloud-python/tree/master/tasks
+.. _Google Cloud Translation: https://pypi.org/project/google-cloud-translate/
+.. _Translation README: https://github.com/googleapis/google-cloud-python/tree/master/translate
+.. _Google Cloud Scheduler: https://pypi.org/project/google-cloud-scheduler/
+.. _Scheduler README: https://github.com/googleapis/google-cloud-python/tree/master/scheduler
+.. _Stackdriver Logging: https://pypi.org/project/google-cloud-logging/
+.. _Logging README: https://github.com/googleapis/google-cloud-python/tree/master/logging
+
+Beta Support
+------------
 
-.. _Google Cloud Datastore: https://github.com/GoogleCloudPlatform/google-cloud-python#google-cloud-datastore
-.. _Google Cloud Storage: https://github.com/GoogleCloudPlatform/google-cloud-python#google-cloud-storage
-.. _Google Cloud Pub/Sub: https://github.com/GoogleCloudPlatform/google-cloud-python#google-cloud-pubsub
-.. _Google BigQuery: https://github.com/GoogleCloudPlatform/google-cloud-python#google-bigquery
-.. _Google Cloud Resource Manager: https://github.com/GoogleCloudPlatform/google-cloud-python#google-cloud-resource-manager
-.. _Google Stackdriver Logging: https://github.com/GoogleCloudPlatform/google-cloud-python#google-stackdriver-logging
-.. _Google Stackdriver Monitoring: https://github.com/GoogleCloudPlatform/google-cloud-python#google-stackdriver-monitoring
+**Beta** indicates that the client library for a particular service is
+mostly stable and is being prepared for release. Issues and requests
+against beta libraries are addressed with a higher priority.
+
+The following client libraries have **beta** support:
+
+-  `Google Cloud Bigtable`_ (`Bigtable README`_)
+-  `Google Cloud Firestore`_ (`Firestore README`_)
+-  `Google Cloud Pub/Sub`_ (`Pub/Sub README`_)
+-  `Google Cloud Video Intelligence`_ (`Video Intelligence README`_)
+-  `Google Cloud Vision`_ (`Vision README`_)
+
+.. _Google Cloud Bigtable: https://pypi.org/project/google-cloud-bigtable/
+.. _Bigtable README: https://github.com/googleapis/google-cloud-python/tree/master/bigtable
+.. _Google Cloud Firestore: https://pypi.org/project/google-cloud-firestore/
+.. _Firestore README: https://github.com/googleapis/google-cloud-python/tree/master/firestore
+.. _Google Cloud Pub/Sub: https://pypi.org/project/google-cloud-pubsub/
+.. _Pub/Sub README: https://github.com/googleapis/google-cloud-python/tree/master/pubsub
+.. _Google Cloud Video Intelligence: https://pypi.org/project/google-cloud-videointelligence
+.. _Video Intelligence README: https://github.com/googleapis/google-cloud-python/tree/master/videointelligence
+.. _Google Cloud Vision: https://pypi.org/project/google-cloud-vision/
+.. _Vision README: https://github.com/googleapis/google-cloud-python/tree/master/vision
+
+
+Alpha Support
+-------------
+
+**Alpha** indicates that the client library for a particular service is
+still a work-in-progress and is more likely to get backwards-incompatible
+updates. See `versioning`_ for more details.
+
+The following client libraries have **alpha** support:
+
+-  `Google Cloud Asset`_ (`Asset README`_)
+-  `Google Cloud AutoML`_ (`AutoML README`_)
+-  `Google BigQuery Data Transfer`_ (`BigQuery Data Transfer README`_)
+-  `Google Cloud Bigtable - HappyBase`_ (`HappyBase README`_)
+-  `Google Cloud Container`_ (`Container README`_)
+-  `Google Cloud Container Analysis`_ (`Container Analysis README`_)
+-  `Google Cloud Dataproc`_ (`Dataproc README`_)
+-  `Google Cloud DLP`_ (`DLP README`_)
+-  `Google Cloud DNS`_ (`DNS README`_)
+-  `Google Cloud IoT`_ (`IoT README`_)
+-  `Google Cloud Memorystore for Redis`_ (`Redis README`_)
+-  `Google Cloud Resource Manager`_ (`Resource Manager README`_)
+-  `Google Cloud Runtime Configuration`_ (`Runtime Config README`_)
+-  `Google Cloud Security Scanner`_ (`Security Scanner README`_ )
+-  `Google Cloud Trace`_ (`Trace README`_)
+-  `Google Cloud Text-to-Speech`_ (`Text-to-Speech README`_)
+-  `Grafeas`_ (`Grafeas README`_)
+-  `Stackdriver Error Reporting`_ (`Error Reporting README`_)
+-  `Stackdriver Monitoring`_ (`Monitoring README`_)
+
+.. _Google Cloud Asset: https://pypi.org/project/google-cloud-asset/
+.. _Asset README: https://github.com/googleapis/google-cloud-python/blob/master/asset
+.. _Google Cloud AutoML: https://pypi.org/project/google-cloud-automl/
+.. _AutoML README: https://github.com/googleapis/google-cloud-python/blob/master/automl
+.. _Google BigQuery Data Transfer: https://pypi.org/project/google-cloud-bigquery-datatransfer/
+.. _BigQuery Data Transfer README: https://github.com/googleapis/google-cloud-python/tree/master/bigquery_datatransfer
+.. _Google Cloud Bigtable - HappyBase: https://pypi.org/project/google-cloud-happybase/
+.. _HappyBase README: https://github.com/googleapis/google-cloud-python-happybase
+.. _Google Cloud Container: https://pypi.org/project/google-cloud-container/
+.. _Container README: https://github.com/googleapis/google-cloud-python/tree/master/container
+.. _Google Cloud Container Analysis: https://pypi.org/project/google-cloud-containeranalysis/
+.. _Container Analysis README: https://github.com/googleapis/google-cloud-python/tree/master/containeranalysis
+.. _Google Cloud Dataproc: https://pypi.org/project/google-cloud-dataproc/
+.. _Dataproc README: https://github.com/googleapis/google-cloud-python/tree/master/dataproc
+.. _Google Cloud DLP: https://pypi.org/project/google-cloud-dlp/
+.. _DLP README: https://github.com/googleapis/google-cloud-python/tree/master/dlp
+.. _Google Cloud DNS: https://pypi.org/project/google-cloud-dns/
+.. _DNS README: https://github.com/googleapis/google-cloud-python/tree/master/dns
+.. _Google Cloud IoT: https://pypi.org/project/google-cloud-iot/
+.. _IoT README: https://github.com/googleapis/google-cloud-python/tree/master/iot
+.. _Google Cloud Memorystore for Redis: https://pypi.org/project/google-cloud-redis/
+.. _Redis README: https://github.com/googleapis/google-cloud-python/tree/master/redis
+.. _Google Cloud Resource Manager: https://pypi.org/project/google-cloud-resource-manager/
+.. _Resource Manager README: https://github.com/googleapis/google-cloud-python/tree/master/resource_manager
+.. _Google Cloud Runtime Configuration: https://pypi.org/project/google-cloud-runtimeconfig/
+.. _Runtime Config README: https://github.com/googleapis/google-cloud-python/tree/master/runtimeconfig
+.. _Google Cloud Security Scanner: https://pypi.org/project/google-cloud-websecurityscanner/
+.. _Security Scanner README: https://github.com/googleapis/google-cloud-python/blob/master/websecurityscanner
+.. _Google Cloud Text-to-Speech: https://pypi.org/project/google-cloud-texttospeech/
+.. _Text-to-Speech README: https://github.com/googleapis/google-cloud-python/tree/master/texttospeech
+.. _Google Cloud Trace: https://pypi.org/project/google-cloud-trace/
+.. _Trace README: https://github.com/googleapis/google-cloud-python/tree/master/trace
+.. _Grafeas: https://pypi.org/project/grafeas/
+.. _Grafeas README: https://github.com/googleapis/google-cloud-python/tree/master/grafeas
+.. _Stackdriver Error Reporting: https://pypi.org/project/google-cloud-error-reporting/
+.. _Error Reporting README: https://github.com/googleapis/google-cloud-python/tree/master/error_reporting
+.. _Stackdriver Monitoring: https://pypi.org/project/google-cloud-monitoring/
+.. _Monitoring README: https://github.com/googleapis/google-cloud-python/tree/master/monitoring
+
+.. _versioning: https://github.com/googleapis/google-cloud-python/blob/master/CONTRIBUTING.rst#versioning
 
 If you need support for other Google APIs, check out the
 `Google APIs Python Client library`_.
 
 .. _Google APIs Python Client library: https://github.com/google/google-api-python-client
 
-Quick Start
------------
-
-::
-
-    $ pip install --upgrade google-cloud
 
 Example Applications
 --------------------
@@ -53,6 +176,7 @@ Example Applications
 .. _tutorial: https://cloud.google.com/python
 .. _google-cloud-python-expenses-demo: https://github.com/GoogleCloudPlatform/google-cloud-python-expenses-demo
 
+
 Authentication
 --------------
 
@@ -61,276 +185,32 @@ Check out the `Authentication section`_ in our documentation to learn more.
 You may also find the `authentication document`_ shared by all the
 ``google-cloud-*`` libraries to be helpful.
 
-.. _Authentication section: http://google-cloud-python.readthedocs.io/en/latest/google-cloud-auth.html
-.. _authentication document: https://github.com/GoogleCloudPlatform/gcloud-common/tree/master/authentication
-
-Google Cloud Datastore
-----------------------
-
-Google `Cloud Datastore`_ (`Datastore API docs`_) is a fully managed, schemaless
-database for storing non-relational data. Cloud Datastore automatically scales
-with your users and supports ACID transactions, high availability of reads and
-writes, strong consistency for reads and ancestor queries, and eventual
-consistency for all other queries.
-
-.. _Cloud Datastore: https://cloud.google.com/datastore/docs
-.. _Datastore API docs: https://cloud.google.com/datastore/docs/
-
-See the ``google-cloud-python`` API `datastore documentation`_ to learn how to
-interact with the Cloud Datastore using this Client Library.
-
-.. _datastore documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/datastore-client.html
-
-See the `official Google Cloud Datastore documentation`_ for more details on how
-to activate Cloud Datastore for your project.
-
-.. _official Google Cloud Datastore documentation: https://cloud.google.com/datastore/docs/activate
-
-.. code:: python
-
-    from google.cloud import datastore
-    # Create, populate and persist an entity
-    entity = datastore.Entity(key=datastore.Key('EntityKind'))
-    entity.update({
-        'foo': u'bar',
-        'baz': 1337,
-        'qux': False,
-    })
-    # Then query for entities
-    query = datastore.Query(kind='EntityKind')
-    for result in query.fetch():
-        print result
-
-Google Cloud Storage
---------------------
-
-Google `Cloud Storage`_ (`Storage API docs`_) allows you to store data on Google
-infrastructure with very high reliability, performance and availability, and can
-be used to distribute large data objects to users via direct download.
-
-.. _Cloud Storage: https://cloud.google.com/storage/docs
-.. _Storage API docs: https://cloud.google.com/storage/docs/json_api/v1
-
-See the ``google-cloud-python`` API `storage documentation`_ to learn how to connect
-to Cloud Storage using this Client Library.
-
-.. _storage documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/storage-client.html
-
-You need to create a Google Cloud Storage bucket to use this client library.
-Follow along with the `official Google Cloud Storage documentation`_ to learn
-how to create a bucket.
-
-.. _official Google Cloud Storage documentation: https://cloud.google.com/storage/docs/cloud-console#_creatingbuckets
-
-.. code:: python
-
-    from google.cloud import storage
-    client = storage.Client()
-    bucket = client.get_bucket('bucket-id-here')
-    # Then do other things...
-    blob = bucket.get_blob('remote/path/to/file.txt')
-    print blob.download_as_string()
-    blob.upload_from_string('New contents!')
-    blob2 = bucket.blob('remote/path/storage.txt')
-    blob2.upload_from_filename(filename='/local/path.txt')
-
-Google Cloud Pub/Sub
---------------------
-
-Google `Cloud Pub/Sub`_ (`Pub/Sub API docs`_) is designed to provide reliable,
-many-to-many, asynchronous messaging between applications. Publisher
-applications can send messages to a ``topic`` and other applications can
-subscribe to that topic to receive the messages. By decoupling senders and
-receivers, Google Cloud Pub/Sub allows developers to communicate between
-independently written applications.
-
-.. _Cloud Pub/Sub: https://cloud.google.com/pubsub/docs
-.. _Pub/Sub API docs: https://cloud.google.com/pubsub/reference/rest/
-
-See the ``google-cloud-python`` API `Pub/Sub documentation`_ to learn how to connect
-to Cloud Pub/Sub using this Client Library.
-
-.. _Pub/Sub documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/pubsub-usage.html
-
-To get started with this API, you'll need to create
-
-.. code:: python
-
-    from google.cloud import pubsub
-
-    client = pubsub.Client()
-    topic = client.topic('topic_name')
-    topic.create()
-
-    topic.publish('this is the message_payload',
-                  attr1='value1', attr2='value2')
-
-Google BigQuery
----------------
-
-Querying massive datasets can be time consuming and expensive without the
-right hardware and infrastructure. Google `BigQuery`_ (`BigQuery API docs`_)
-solves this problem by enabling super-fast, SQL-like queries against
-append-only tables, using the processing power of Google's infrastructure.
-
-.. _BigQuery: https://cloud.google.com/bigquery/what-is-bigquery
-.. _BigQuery API docs: https://cloud.google.com/bigquery/docs/reference/v2/
-
-This package is still being implemented, but it is almost complete!
-
-Load data from CSV
-~~~~~~~~~~~~~~~~~~
-
-.. code:: python
+.. _Authentication section: https://google-cloud-python.readthedocs.io/en/latest/core/auth.html
+.. _authentication document: https://github.com/googleapis/google-cloud-common/tree/master/authentication
 
-    import csv
-
-    from google.cloud import bigquery
-    from google.cloud.bigquery import SchemaField
-
-    client = bigquery.Client()
-
-    dataset = client.dataset('dataset_name')
-    dataset.create()  # API request
-
-    SCHEMA = [
-        SchemaField('full_name', 'STRING', mode='required'),
-        SchemaField('age', 'INTEGER', mode='required'),
-    ]
-    table = dataset.table('table_name', SCHEMA)
-    table.create()
-
-    with open('csv_file', 'rb') as readable:
-        table.upload_from_file(
-            readable, source_format='CSV', skip_leading_rows=1)
-
-Perform a synchronous query
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code:: python
-
-    # Perform a synchronous query.
-    QUERY = (
-        'SELECT name FROM [bigquery-public-data:usa_names.usa_1910_2013] '
-        'WHERE state = "TX"')
-    query = client.run_sync_query('%s LIMIT 100' % QUERY)
-    query.timeout_ms = TIMEOUT_MS
-    query.run()
-
-    for row in query.rows:
-        print row
-
-
-See the ``google-cloud-python`` API `BigQuery documentation`_ to learn how to connect
-to BigQuery using this Client Library.
-
-.. _BigQuery documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/bigquery-usage.html
-
-Google Cloud Resource Manager
------------------------------
-
-The Cloud `Resource Manager`_ API (`Resource Manager API docs`_) provides
-methods that you can use to programmatically manage your projects in the
-Google Cloud Platform.
-
-.. _Resource Manager: https://cloud.google.com/resource-manager/
-.. _Resource Manager API docs: https://cloud.google.com/resource-manager/reference/rest/
-
-See the ``google-cloud-python`` API `Resource Manager documentation`_ to learn how to
-manage projects using this Client Library.
-
-.. _Resource Manager documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/resource-manager-api.html
-
-Google Stackdriver Logging
---------------------------
-
-`Stackdriver Logging`_ API (`Logging API docs`_) allows you to store, search,
-analyze, monitor, and alert on log data and events from Google Cloud Platform.
-
-.. _Stackdriver Logging: https://cloud.google.com/logging/
-.. _Logging API docs: https://cloud.google.com/logging/docs/
-
-.. code:: python
-
-    from google.cloud import logging
-    client = logging.Client()
-    logger = client.logger('log_name')
-    logger.log_text("A simple entry")  # API call
-
-Example of fetching entries:
-
-.. code:: python
-
-    entries, token = logger.list_entries()
-    for entry in entries:
-        print entry.payload
-
-See the ``google-cloud-python`` API `logging documentation`_ to learn how to connect
-to Stackdriver Logging using this Client Library.
-
-.. _logging documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/logging-usage.html
-
-Google Stackdriver Monitoring
------------------------------
-
-`Stackdriver Monitoring`_ (`Monitoring API docs`_) collects metrics,
-events, and metadata from Google Cloud Platform, Amazon Web Services (AWS),
-hosted uptime probes, application instrumentation, and a variety of common
-application components including Cassandra, Nginx, Apache Web Server,
-Elasticsearch and many others. Stackdriver ingests that data and generates
-insights via dashboards, charts, and alerts.
-
-This package currently supports all Monitoring API operations other than
-writing custom metrics.
-
-.. _Stackdriver Monitoring: https://cloud.google.com/monitoring/
-.. _Monitoring API docs: https://cloud.google.com/monitoring/api/ref_v3/rest/
-
-List available metric types:
-
-.. code:: python
-
-    from google.cloud import monitoring
-    client = monitoring.Client()
-    for descriptor in client.list_metric_descriptors():
-        print(descriptor.type)
-
-Display CPU utilization across your GCE instances during the last five minutes:
+Contributing
+------------
 
-.. code:: python
+Contributions to this library are always welcome and highly encouraged.
 
-    metric = 'compute.googleapis.com/instance/cpu/utilization'
-    query = client.query(metric, minutes=5)
-    print(query.as_dataframe())
+See the `CONTRIBUTING doc`_ for more information on how to get started.
 
-See the ``google-cloud-python`` API `monitoring documentation`_ to learn how to connect
-to Stackdriver Monitoring using this Client Library.
+.. _CONTRIBUTING doc: https://github.com/googleapis/google-cloud-python/blob/master/CONTRIBUTING.rst
 
-.. _monitoring documentation: https://googlecloudplatform.github.io/google-cloud-python/stable/monitoring-usage.html
 
-Contributing
-------------
+Community
+---------
 
-Contributions to this library are always welcome and highly encouraged.
+Google Cloud Platform Python developers hang out in `Slack`_ in the ``#python``
+channel, click here to `get an invitation`_.
 
-See `CONTRIBUTING`_ for more information on how to get started.
+.. _Slack: https://googlecloud-community.slack.com
+.. _get an invitation: https://gcp-slack.appspot.com/
 
-.. _CONTRIBUTING: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/CONTRIBUTING.rst
 
 License
 -------
 
-Apache 2.0 - See `LICENSE`_ for more information.
-
-.. _LICENSE: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/LICENSE
+Apache 2.0 - See `the LICENSE`_ for more information.
 
-.. |build| image:: https://travis-ci.org/GoogleCloudPlatform/google-cloud-python.svg?branch=master
-   :target: https://travis-ci.org/GoogleCloudPlatform/google-cloud-python
-.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/googlecloudplatform/google-cloud-python?branch=master&svg=true
-   :target: https://ci.appveyor.com/project/GoogleCloudPlatform/google-cloud-python
-.. |coverage| image:: https://coveralls.io/repos/GoogleCloudPlatform/google-cloud-python/badge.png?branch=master
-   :target: https://coveralls.io/r/GoogleCloudPlatform/google-cloud-python?branch=master
-.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud.svg
-   :target: https://pypi.python.org/pypi/google-cloud
-.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud.svg
-   :target: https://pypi.python.org/pypi/google-cloud
+.. _the LICENSE: https://github.com/googleapis/google-cloud-python/blob/master/LICENSE
diff --git a/api_core/.coveragerc b/api_core/.coveragerc
new file mode 100644
index 000000000000..d097511c3124
--- /dev/null
+++ b/api_core/.coveragerc
@@ -0,0 +1,13 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
diff --git a/api_core/.flake8 b/api_core/.flake8
new file mode 100644
index 000000000000..3da787cdfbf3
--- /dev/null
+++ b/api_core/.flake8
@@ -0,0 +1,11 @@
+[flake8]
+import-order-style=google
+# Note: this forces all google imports to be in the third group. See
+# https://github.com/PyCQA/flake8-import-order/issues/111
+application-import-names=google
+ignore = E203, E266, E501, W503
+exclude =
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/api_core/.repo-metadata.json b/api_core/.repo-metadata.json
new file mode 100644
index 000000000000..6a5f3f53359f
--- /dev/null
+++ b/api_core/.repo-metadata.json
@@ -0,0 +1,9 @@
+{
+  "name": "google-api-core",
+  "name_pretty": "Google API client core library",
+  "client_documentation": "https://googleapis.dev/python/google-api-core/latest",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-api-core"
+}
\ No newline at end of file
diff --git a/api_core/CHANGELOG.md b/api_core/CHANGELOG.md
new file mode 100644
index 000000000000..74ab16564dbc
--- /dev/null
+++ b/api_core/CHANGELOG.md
@@ -0,0 +1,349 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-api-core/#history
+
+## 1.14.2
+
+07-30-2019 14:08 PDT
+
+
+### Documentation
+- Add client_options documentation. ([#8834](https://github.com/googleapis/google-cloud-python/pull/8834))
+
+## 1.14.1
+
+07-30-2019 12:24 PDT
+
+
+### Implementation Changes
+- Remove error log entry on clean BiDi shutdown. ([#8806](https://github.com/googleapis/google-cloud-python/pull/8806))
+- Forward 'timeout' arg from 'exception' to `_blocking_poll`. ([#8735](https://github.com/googleapis/google-cloud-python/pull/8735))
+
+### Documentation
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+
+## 1.14.0
+
+07-17-2019 13:16 PDT
+
+
+### New Features
+- Firestore: Add `should_terminate` predicate for clean BiDi shutdown. ([#8650](https://github.com/googleapis/google-cloud-python/pull/8650))
+
+### Dependencies
+- Update pins of 'googleapis-common-protos. ([#8688](https://github.com/googleapis/google-cloud-python/pull/8688))
+
+### Documentation
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 1.13.0
+
+06-24-2019 10:34 PDT
+
+### New Features
+- Add `client_options.ClientOptions` object. ([#8265](https://github.com/googleapis/google-cloud-python/pull/8265))
+
+## 1.12.0
+
+06-18-2019 12:37 PDT
+
+
+### New Features
+- Add Throttling to Bidi Reopening. Mitigates ResumableBidiRpc consuming 100% CPU ([#8193](https://github.com/googleapis/google-cloud-python/pull/8193))
+
+## 1.11.1
+
+05-28-2019 11:19 PDT
+
+
+### Implementation Changes
+- Classify 503 Service Unavailable errors as transient. ([#8182](https://github.com/googleapis/google-cloud-python/pull/8182))
+
+### Dependencies
+- Pin `grpcio < 2.0dev`. ([#8182](https://github.com/googleapis/google-cloud-python/pull/8182))
+
+### Internal / Testing Changes
+- Add parameterized test for `from_rfc3339` with nanos ([#7675](https://github.com/googleapis/google-cloud-python/pull/7675))
+- Unbreak pytype by silencing a false positive. ([#8106](https://github.com/googleapis/google-cloud-python/pull/8106))
+
+## 1.11.0
+
+05-15-2019 10:29 PDT
+
+### New Features
+
+- Refactor 'client_info' support. ([#7849](https://github.com/googleapis/google-cloud-python/pull/7849))
+
+## 1.10.0
+
+04-29-2019 10:12 PDT
+
+### Implementation Changes
+
+- Append leading zeros for nanosecond precision DateTimes
+  ([#7663](https://github.com/googleapis/google-cloud-python/pull/7663))
+
+### New Features
+
+- Add `user_agent` property to `ClientInfo`
+  ([#7799](https://github.com/googleapis/google-cloud-python/pull/7799))
+
+## 1.9.0
+
+04-05-2019 10:38 PDT
+
+
+### Implementation Changes
+- Allow passing metadata as part of creating a bidi ([#7514](https://github.com/googleapis/google-cloud-python/pull/7514))
+
+### Internal / Testing Changes
+- Update setup.py
+- API Core: specify a pytype output directory in setup.cfg. ([#7639](https://github.com/googleapis/google-cloud-python/pull/7639))
+
+## 1.8.2
+
+03-22-2019 16:27 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### Internal / Testing Changes
+- When re-opening a `ResumableBidiRPC` set `_request_queue_generator` to `None`. ([#7548](https://github.com/googleapis/google-cloud-python/pull/7548))
+
+## 1.8.1
+
+03-12-2019 12:45 PDT
+
+### Implementation Changes
+- Protect the creation of a background thread in BackgroundConsumer and wait on it starting. ([#7499](https://github.com/googleapis/google-cloud-python/pull/7499))
+
+## 1.8.0
+
+02-23-2019 15:46 PST
+
+
+### New Features
+- Add support to unwrap Anys into wrapped pb2 objects. ([#7430](https://github.com/googleapis/google-cloud-python/pull/7430))
+- Add `Operation.deserialize`. ([#7427](https://github.com/googleapis/google-cloud-python/pull/7427))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+- Fix new lint failure. ([#7382](https://github.com/googleapis/google-cloud-python/pull/7382))
+
+## 1.7.0
+
+12-17-2018 13:56 PST
+
+### New Features
+- Support converting `DatetimeWithNanos` to / from `google.protobuf.timestamp_pb2.Timestamp`. ([#6919](https://github.com/googleapis/google-cloud-python/pull/6919))
+
+### Documentation
+- Document Python 2 deprecation. ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Add usage example for `google.api_core.iam.Polcy`. ([#6855](https://github.com/googleapis/google-cloud-python/pull/6855))
+
+### Internal / Testing Changes
+- Work around pytype big for `ABCMeta.register`. ([#6873](https://github.com/googleapis/google-cloud-python/pull/6873))
+
+## 1.6.0
+
+11-30-2018 12:45 PST
+
+
+### Implementation Changes
+- Import stdlib ABCs from 'collections.abc' rather than 'collections'. ([#6451](https://github.com/googleapis/google-cloud-python/pull/6451))
+
+### New Features
+- Move google.cloud.iam (core) to google.api_core.iam ([#6740](https://github.com/googleapis/google-cloud-python/pull/6740))
+- Add bidi support to api_core. ([#6191](https://github.com/googleapis/google-cloud-python/pull/6191))
+
+### Documentation
+- Fix typo ([#6532](https://github.com/googleapis/google-cloud-python/pull/6532))
+
+### Internal / Testing Changes
+- blacken api_core and core ([#6668](https://github.com/googleapis/google-cloud-python/pull/6668))
+
+## 1.5.2
+
+11-09-2018 14:22 PST
+
+
+### Implementation Changes
+- Retry transient errors in 'PollingFuture.result'. ([#6305](https://github.com/googleapis/google-cloud-python/pull/6305))
+
+### Dependencies
+- Remove hyphen from named extra in api_core. ([#6468](https://github.com/googleapis/google-cloud-python/pull/6468))
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+## 1.5.1
+
+10-29-2018 13:29 PDT
+
+### Implementation Changes
+- Don't URL-encode slashes in gRPC request headers. ([#6310](https://github.com/googleapis/google-cloud-python/pull/6310))
+
+### Internal / Testing Changes
+- Back out changes from [#6267](https://github.com/googleapis/google-cloud-python/pull/6267) / `api_core-1.6.0a1` release. ([#6328](https://github.com/googleapis/google-cloud-python/pull/6328))
+
+## 1.5.0
+
+### New Features
+- Add bidi, Bidirection Streaming, to api-core ([#6211](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6211))
+
+### Internal / Testing Changes
+- Use new Nox ([#6175](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6175))
+
+## 1.4.1
+
+### Dependencies
+- Pin minimum protobuf dependency to 3.4.0. ([#6132](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6132))
+
+### Internal / Testing Changes
+- Add type-checking via pytype to api_core. ([#6116](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6116))
+
+## 1.4.0
+
+### Dependencies
+
+- Add support for gRPC connection management (available when using optional grpc_gcp dependency) ([#5553](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5553)) ([#5904](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5904))
+- Update classifiers to drop Python 3.4 and add Python 3.7 ([#5702](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5702))
+
+## 1.3.0
+
+### New Features
+
+- Add protobuf_helpers.field_mask to calculate a field mask from two messages (#5320)
+
+## 1.2.1
+
+### Implementation Changes
+- Make client_info work without gRPC installed. (#5075)
+- Rename `x-goog-header-params` to `x-goog-request-params` (#5495)
+
+## 1.2.0
+
+### Implementation Changes
+- Add close method to grpc Channel (#5333)
+
+### Internal / Testing Changes
+- Fix tests after grpcio update (#5333)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+
+## 1.1.2
+
+### Packaging
+- Update setuptools before packaging (#5265)
+
+## 1.1.1
+
+### Internal / Testing Changes
+- Use `install_requires` for platform dependencies instead of `extras_require` (#4991)
+- Update trove classifer to '5 - Production/Stable'
+
+## 1.1.0
+
+### Interface additions
+
+- Add `datetime_helpers.DatetimeWithNanoSeconds` (#4979)
+
+### Implementation changes
+
+- Use a class to wrap grpc streaming errors instead of monkey-patching (#4995)
+
+## 1.0.0
+
+This is the stable v1.0.0 release of google-api-core for Python. Releases after
+this will not contain breaking changes.
+
+### Interface changes and additions
+
+- Made `api_core.page_iterator.PageIterator.item_to_value` public
+- Added ability to specify retry for `Operation` and `polling.Future`. (#4922)
+
+## 0.1.4
+
+### New Features
+
+- Add `ChannelStub` to `grpc_helpers` for testing gRPC-based clients. (#4705)
+
+### Notable Implementation Changes
+
+- Fix handling of gapic metadata when specified as `None`. (#4701)
+
+## 0.1.3
+
+### Notable Implementation Changes
+
+- Apply scopes to explicitly provided credentials if needed (#4594).
+- Removing `google.api_core.gapic_v1.method.METRICS_METADATA_KEY`. It
+  can be accessed via
+  `google.api_core.gapic_v1.client_info.METRICS_METADATA_KEY` (#4588).
+
+### Dependencies
+
+- Upgrading to latest `grpcio==1.8.2` (#4642). For details, see
+  related gRPC [bug](https://github.com/grpc/grpc/issues/9688)
+  and [fix](https://github.com/grpc/grpc/pull/13665).
+
+PyPI: https://pypi.org/project/google-api-core/0.1.3/
+
+## 0.1.2
+
+- Upgrading `concurrent.futures` backport from `>= 3.0.0`
+  to `>= 3.2.0` (#4521).
+- Moved `datetime`-related helpers from `google.cloud.core` to
+  `google.api_core.datetime_helpers` (#4399).
+- Added missing `client_info` to `gapic_v1/__init__.py`'s
+  `__all__` (#4567).
+- Added helpers for routing headers to `gapic_v1` (#4336).
+
+PyPI: https://pypi.org/project/google-api-core/0.1.2/
+
+## 0.1.1
+
+### Dependencies
+
+- Upgrading `grpcio` dependency from `1.2.0, < 1.6dev` to `>= 1.7.0` (#4280)
+
+PyPI: https://pypi.org/project/google-api-core/0.1.1/
+
+## 0.1.0
+
+Initial release
+
+Prior to being separated, this package was developed in `google-cloud-core`, so
+relevant changes from that package are included here.
+
+- Add google.api.core.gapic_v1.config (#4022)
+- Add google.api.core.helpers.grpc_helpers (#4041)
+- Add google.api.core.gapic_v1.method (#4057)
+- Add wrap_with_paging (#4067)
+- Add grpc_helpers.create_channel (#4069)
+- Add DEFAULT sentinel for gapic_v1.method (#4079)
+- Remove `googleapis-common-protos` from deps in non-`core` packages. (#4098)
+- Add google.api.core.operations_v1 (#4081)
+- Fix test assertion in test_wrap_method_with_overriding_retry_deadline (#4131)
+- Add google.api.core.helpers.general_helpers.wraps (#4166)
+- Update Docs with Python Setup Guide (#4187)
+- Move modules in google.api.core.helpers up one level, delete google.api.core.helpers. (#4196)
+- Clarify that PollingFuture timeout is in seconds. (#4201)
+- Add api_core package (#4210)
+- Replace usage of google.api.core with google.api_core (#4221)
+- Add google.api_core.gapic_v2.client_info (#4225)
+- Fix how api_core.operation populates exception errors (#4231)
+- Fix bare except (#4250)
+- Fix parsing of API errors with Unicode err message (#4251)
+- Port gax proto helper methods (#4249)
+- Remove gapic_v1.method.wrap_with_paging (#4257)
+- Add final set of protobuf helpers to api_core (#4259)
+
+PyPI: https://pypi.org/project/google-api-core/0.1.0/
diff --git a/api_core/LICENSE b/api_core/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/api_core/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/api_core/MANIFEST.in b/api_core/MANIFEST.in
new file mode 100644
index 000000000000..1fbc0d0b321e
--- /dev/null
+++ b/api_core/MANIFEST.in
@@ -0,0 +1,3 @@
+include README.rst LICENSE
+recursive-include tests *
+global-exclude *.pyc __pycache__
diff --git a/api_core/README.rst b/api_core/README.rst
new file mode 100644
index 000000000000..244043ea61b3
--- /dev/null
+++ b/api_core/README.rst
@@ -0,0 +1,23 @@
+Core Library for Google Client Libraries
+========================================
+
+|pypi| |versions| 
+
+This library is not meant to stand-alone. Instead it defines
+common helpers used by all Google API clients. For more information, see the
+`documentation`_.
+
+.. |pypi| image:: https://img.shields.io/pypi/v/google-api_core.svg
+   :target: https://pypi.org/project/google-api_core/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-api_core.svg
+   :target: https://pypi.org/project/google-api_core/
+.. _documentation: https://googleapis.dev/python/google-api-core/latest
+
+
+Supported Python Versions
+-------------------------
+Python >= 3.5
+
+Deprecated Python Versions
+--------------------------
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
diff --git a/api_core/docs/auth.rst b/api_core/docs/auth.rst
new file mode 100644
index 000000000000..f309a3a018ec
--- /dev/null
+++ b/api_core/docs/auth.rst
@@ -0,0 +1,301 @@
+Authentication
+**************
+
+.. _Overview:
+
+Overview
+========
+
+*   **If you're running in Compute Engine or App Engine**,
+    authentication should "just work".
+
+*   **If you're developing locally**,
+    the easiest way to authenticate is using the `Google Cloud SDK`_:
+
+    .. code-block:: bash
+
+        $ gcloud auth application-default login
+
+    Note that this command generates credentials for client libraries. To authenticate the CLI itself, use:
+
+    .. code-block:: bash
+
+        $ gcloud auth login
+
+    Previously, ``gcloud auth login`` was used for both use cases. If
+    your ``gcloud`` installation does not support the new command,
+    please update it:
+
+    .. code-block:: bash
+
+        $ gcloud components update
+
+.. _Google Cloud SDK: http://cloud.google.com/sdk
+
+
+*   **If you're running your application elsewhere**,
+    you should download a `service account`_ JSON keyfile
+    and point to it using an environment variable:
+
+    .. code-block:: bash
+
+        $ export GOOGLE_APPLICATION_CREDENTIALS="/path/to/keyfile.json"
+
+.. _service account: https://cloud.google.com/storage/docs/authentication#generating-a-private-key
+
+Client-Provided Authentication
+==============================
+
+Every package uses a :class:`Client <google.cloud.client.Client>`
+as a base for interacting with an API.
+For example:
+
+.. code-block:: python
+
+    from google.cloud import datastore
+    client = datastore.Client()
+
+Passing no arguments at all will "just work" if you've followed the
+instructions in the :ref:`Overview`.
+The credentials are inferred from your local environment by using
+Google `Application Default Credentials`_.
+
+.. _Application Default Credentials: https://developers.google.com/identity/protocols/application-default-credentials
+
+.. _Precedence:
+
+Credential Discovery Precedence
+-------------------------------
+
+When loading the `Application Default Credentials`_,
+the library will check for credentials in your environment by following the
+precedence outlined by :func:`google.auth.default`.
+
+Explicit Credentials
+====================
+
+The Application Default Credentials discussed above can be useful
+if your code needs to run in many different environments or
+if you just don't want authentication to be a focus in your code.
+
+However, you may want to be explicit because
+
+* your code will only run in one place
+* you may have code which needs to be run as a specific service account
+  every time (rather than with the locally inferred credentials)
+* you may want to use two separate accounts to simultaneously access data
+  from different projects
+
+In these situations, you can create an explicit
+:class:`~google.auth.credentials.Credentials` object suited to your environment.
+After creation, you can pass it directly to a :class:`Client <google.cloud.client.Client>`:
+
+.. code:: python
+
+    client = Client(credentials=credentials)
+
+.. tip::
+    To create a credentials object, follow the `google-auth-guide`_.
+
+.. _google-auth-guide: https://google-auth.readthedocs.io/en/latest/user-guide.html#service-account-private-key-files
+
+
+Google App Engine Environment
+-----------------------------
+
+To create
+:class:`credentials <google.auth.app_engine.Credentials>`
+just for Google App Engine:
+
+.. code:: python
+
+    from google.auth import app_engine
+    credentials = app_engine.Credentials()
+
+Google Compute Engine Environment
+---------------------------------
+
+To create
+:class:`credentials <google.auth.compute_engine.Credentials>`
+just for Google Compute Engine:
+
+.. code:: python
+
+    from google.auth import compute_engine
+    credentials = compute_engine.Credentials()
+
+Service Accounts
+----------------
+
+A `service account`_ is stored in a JSON keyfile.
+
+The
+:meth:`from_service_account_json() <google.cloud.client.Client.from_service_account_json>`
+factory can be used to create a :class:`Client <google.cloud.client.Client>` with
+service account credentials.
+
+For example, with a JSON keyfile:
+
+.. code:: python
+
+    client = Client.from_service_account_json('/path/to/keyfile.json')
+
+.. tip::
+
+    Previously the Google Cloud Console would issue a PKCS12/P12 key for your
+    service account. This library does not support that key format. You can
+    generate a new JSON key for the same service account from the console.
+
+User Accounts (3-legged OAuth 2.0) with a refresh token
+-------------------------------------------------------
+
+The majority of cases are intended to authenticate machines or
+workers rather than actual user accounts. However, it's also
+possible to call Google Cloud APIs with a user account via
+`OAuth 2.0`_.
+
+.. _OAuth 2.0: https://developers.google.com/identity/protocols/OAuth2
+
+.. tip::
+
+    A production application should **use a service account**,
+    but you may wish to use your own personal user account when first
+    getting started with the ``google-cloud-python`` library.
+
+The simplest way to use credentials from a user account is via
+Application Default Credentials using ``gcloud auth login``
+(as mentioned above) and :func:`google.auth.default`:
+
+.. code:: python
+
+    import google.auth
+
+    credentials, project = google.auth.default()
+
+This will still follow the :ref:`precedence <Precedence>`
+described above,
+so be sure none of the other possible environments conflict
+with your user provided credentials.
+
+Advanced users of `oauth2client`_ can also use custom flows to
+create credentials using `client secrets`_ or using a
+`webserver flow`_.
+After creation, :class:`Credentials <oauth2client.client.Credentials>`
+can be serialized with
+:meth:`to_json() <oauth2client.client.Credentials.to_json>`
+and stored in a file and then and deserialized with
+:meth:`from_json() <oauth2client.client.Credentials.from_json>`. In order
+to use ``oauth2client``'s credentials with this library, you'll need to
+`convert them`_.
+
+.. _oauth2client: https://github.com/Google/oauth2client.
+.. _client secrets: https://developers.google.com/api-client-library/python/guide/aaa_oauth#flow_from_clientsecrets
+.. _webserver flow: https://developers.google.com/api-client-library/python/guide/aaa_oauth#OAuth2WebServerFlow
+.. _convert them: http://google-auth.readthedocs.io/en/stable/user-guide.html#user-credentials
+
+Troubleshooting
+===============
+
+Setting up a Service Account
+----------------------------
+
+If your application is not running on Google Compute Engine,
+you need a `Google Developers Service Account`_.
+
+#. Visit the `Google Developers Console`_.
+
+#. Create a new project or click on an existing project.
+
+#. Navigate to **APIs & auth** > **APIs** and enable the APIs
+   that your application requires.
+
+   .. raw:: html
+
+     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/google-cloud-common/master/authentication/enable-apis.png"/>
+
+  .. note::
+
+      You may need to enable billing in order to use these services.
+
+      * **BigQuery**
+
+        * BigQuery API
+
+      * **Datastore**
+
+        * Google Cloud Datastore API
+
+      * **Pub/Sub**
+
+        * Google Cloud Pub/Sub
+
+      * **Storage**
+
+        * Google Cloud Storage
+        * Google Cloud Storage JSON API
+
+#. Navigate to **APIs & auth** > **Credentials**.
+
+   You should see a screen like one of the following:
+
+   .. raw:: html
+
+     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/google-cloud-common/master/authentication/create-new-service-account.png">
+
+   .. raw:: html
+
+     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/google-cloud-common/master/authentication/create-new-service-account-existing-keys.png">
+
+  Find the "Add credentials" drop down and select "Service account" to be
+  guided through downloading a new JSON keyfile.
+
+  If you want to re-use an existing service account,
+  you can easily generate a new keyfile.
+  Just select the account you wish to re-use,
+  and click **Generate new JSON key**:
+
+   .. raw:: html
+
+     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/google-cloud-common/master/authentication/reuse-service-account.png">
+
+.. _Google Developers Console: https://console.developers.google.com/project
+.. _Google Developers Service Account: https://developers.google.com/accounts/docs/OAuth2ServiceAccount
+
+Using Google Compute Engine
+---------------------------
+
+If your code is running on Google Compute Engine,
+using the inferred Google `Application Default Credentials`_
+will be sufficient for retrieving credentials.
+
+However, by default your credentials may not grant you
+access to the services you intend to use.
+Be sure when you `set up the GCE instance`_,
+you add the correct scopes for the APIs you want to access:
+
+* **All APIs**
+
+    * ``https://www.googleapis.com/auth/cloud-platform``
+    * ``https://www.googleapis.com/auth/cloud-platform.read-only``
+
+* **BigQuery**
+
+    * ``https://www.googleapis.com/auth/bigquery``
+    * ``https://www.googleapis.com/auth/bigquery.insertdata``
+
+* **Datastore**
+
+    * ``https://www.googleapis.com/auth/datastore``
+    * ``https://www.googleapis.com/auth/userinfo.email``
+
+* **Pub/Sub**
+
+    * ``https://www.googleapis.com/auth/pubsub``
+
+* **Storage**
+
+    * ``https://www.googleapis.com/auth/devstorage.full_control``
+    * ``https://www.googleapis.com/auth/devstorage.read_only``
+    * ``https://www.googleapis.com/auth/devstorage.read_write``
+
+.. _set up the GCE instance: https://cloud.google.com/compute/docs/authentication#using
diff --git a/api_core/docs/changelog.md b/api_core/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/api_core/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/api_core/docs/client_info.rst b/api_core/docs/client_info.rst
new file mode 100644
index 000000000000..e976b1863c7c
--- /dev/null
+++ b/api_core/docs/client_info.rst
@@ -0,0 +1,11 @@
+Client Information Helpers
+==========================
+
+.. automodule:: google.api_core.client_info
+  :members:
+  :show-inheritance:
+
+.. automodule:: google.api_core.gapic_v1.client_info
+  :members:
+  :show-inheritance:
+
diff --git a/api_core/docs/client_options.rst b/api_core/docs/client_options.rst
new file mode 100644
index 000000000000..da7c9a339bbd
--- /dev/null
+++ b/api_core/docs/client_options.rst
@@ -0,0 +1,6 @@
+Client Options
+==========================
+
+.. automodule:: google.api_core.client_options
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/conf.py b/api_core/docs/conf.py
new file mode 100644
index 000000000000..60b1f7a3f0b9
--- /dev/null
+++ b/api_core/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-api-core documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-api-core"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-api-core-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-api-core.tex",
+        u"google-api-core Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-api-core", u"google-api-core Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-api-core",
+        u"google-api-core Documentation",
+        author,
+        "google-api-core",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/api_core/docs/exceptions.rst b/api_core/docs/exceptions.rst
new file mode 100644
index 000000000000..d671f4e02046
--- /dev/null
+++ b/api_core/docs/exceptions.rst
@@ -0,0 +1,6 @@
+Exceptions
+==========
+
+.. automodule:: google.api_core.exceptions
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/futures.rst b/api_core/docs/futures.rst
new file mode 100644
index 000000000000..7a43da9de291
--- /dev/null
+++ b/api_core/docs/futures.rst
@@ -0,0 +1,10 @@
+Futures
+=======================
+
+.. automodule:: google.api_core.future
+  :members:
+  :show-inheritance:
+
+.. automodule:: google.api_core.future.polling
+  :members:
+  :show-inheritance:
\ No newline at end of file
diff --git a/api_core/docs/helpers.rst b/api_core/docs/helpers.rst
new file mode 100644
index 000000000000..6f72df9561ef
--- /dev/null
+++ b/api_core/docs/helpers.rst
@@ -0,0 +1,26 @@
+Helpers
+=======
+
+
+General Helpers
+---------------
+
+.. automodule:: google.api_core.general_helpers
+  :members:
+  :show-inheritance:
+
+
+Datetime Helpers
+----------------
+
+.. automodule:: google.api_core.datetime_helpers
+  :members:
+  :show-inheritance:
+
+
+gRPC Helpers
+------------
+
+.. automodule:: google.api_core.grpc_helpers
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/iam.rst b/api_core/docs/iam.rst
new file mode 100644
index 000000000000..bb80ae3c5798
--- /dev/null
+++ b/api_core/docs/iam.rst
@@ -0,0 +1,7 @@
+Identity and Access Management
+==============================
+
+.. automodule:: google.api_core.iam
+  :members:
+  :show-inheritance:
+  :member-order: bysource
diff --git a/api_core/docs/index.rst b/api_core/docs/index.rst
new file mode 100644
index 000000000000..67572a0bbf96
--- /dev/null
+++ b/api_core/docs/index.rst
@@ -0,0 +1,30 @@
+The ``google-cloud-core`` package contains helpers common to all
+``google-cloud-*`` packages. In an attempt to reach a stable API,
+much of the functionality has been split out into this package,
+``google-api-core``.
+
+Core
+====
+
+.. toctree::
+    auth
+    client_info
+    client_options
+    exceptions
+    futures
+    helpers
+    iam
+    operation
+    operations_client
+    page_iterator
+    path_template
+    retry
+    timeout
+
+Changelog
+~~~~~~~~~
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
diff --git a/api_core/docs/operation.rst b/api_core/docs/operation.rst
new file mode 100644
index 000000000000..c5e676621318
--- /dev/null
+++ b/api_core/docs/operation.rst
@@ -0,0 +1,6 @@
+Long-Running Operations
+=======================
+
+.. automodule:: google.api_core.operation
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/operations_client.rst b/api_core/docs/operations_client.rst
new file mode 100644
index 000000000000..be466d3fbf43
--- /dev/null
+++ b/api_core/docs/operations_client.rst
@@ -0,0 +1,6 @@
+Long-Running Operations Client
+==============================
+
+.. automodule:: google.api_core.operations_v1
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/page_iterator.rst b/api_core/docs/page_iterator.rst
new file mode 100644
index 000000000000..28842da2a76d
--- /dev/null
+++ b/api_core/docs/page_iterator.rst
@@ -0,0 +1,6 @@
+Page Iterators
+==============
+
+.. automodule:: google.api_core.page_iterator
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/path_template.rst b/api_core/docs/path_template.rst
new file mode 100644
index 000000000000..220779e3ba9f
--- /dev/null
+++ b/api_core/docs/path_template.rst
@@ -0,0 +1,6 @@
+Path Templates
+==============
+
+.. automodule:: google.api_core.path_template
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/retry.rst b/api_core/docs/retry.rst
new file mode 100644
index 000000000000..23a7d70f3431
--- /dev/null
+++ b/api_core/docs/retry.rst
@@ -0,0 +1,6 @@
+Retry
+=====
+
+.. automodule:: google.api_core.retry
+  :members:
+  :show-inheritance:
diff --git a/api_core/docs/timeout.rst b/api_core/docs/timeout.rst
new file mode 100644
index 000000000000..943d42508997
--- /dev/null
+++ b/api_core/docs/timeout.rst
@@ -0,0 +1,6 @@
+Timeout
+=======
+
+.. automodule:: google.api_core.timeout
+  :members:
+  :show-inheritance:
diff --git a/api_core/google/__init__.py b/api_core/google/__init__.py
new file mode 100644
index 000000000000..0d0a4c3ab273
--- /dev/null
+++ b/api_core/google/__init__.py
@@ -0,0 +1,24 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google namespace package."""
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/api_core/google/api_core/__init__.py b/api_core/google/api_core/__init__.py
new file mode 100644
index 000000000000..c762e18309db
--- /dev/null
+++ b/api_core/google/api_core/__init__.py
@@ -0,0 +1,23 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google API Core.
+
+This package contains common code and utilties used by Google client libraries.
+"""
+
+from pkg_resources import get_distribution
+
+
+__version__ = get_distribution("google-api-core").version
diff --git a/api_core/google/api_core/bidi.py b/api_core/google/api_core/bidi.py
new file mode 100644
index 000000000000..f73c7c9dfabc
--- /dev/null
+++ b/api_core/google/api_core/bidi.py
@@ -0,0 +1,727 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Bi-directional streaming RPC helpers."""
+
+import collections
+import datetime
+import logging
+import threading
+import time
+
+from six.moves import queue
+
+from google.api_core import exceptions
+
+_LOGGER = logging.getLogger(__name__)
+_BIDIRECTIONAL_CONSUMER_NAME = "Thread-ConsumeBidirectionalStream"
+
+
+class _RequestQueueGenerator(object):
+    """A helper for sending requests to a gRPC stream from a Queue.
+
+    This generator takes requests off a given queue and yields them to gRPC.
+
+    This helper is useful when you have an indeterminate, indefinite, or
+    otherwise open-ended set of requests to send through a request-streaming
+    (or bidirectional) RPC.
+
+    The reason this is necessary is because gRPC takes an iterator as the
+    request for request-streaming RPCs. gRPC consumes this iterator in another
+    thread to allow it to block while generating requests for the stream.
+    However, if the generator blocks indefinitely gRPC will not be able to
+    clean up the thread as it'll be blocked on `next(iterator)` and not be able
+    to check the channel status to stop iterating. This helper mitigates that
+    by waiting on the queue with a timeout and checking the RPC state before
+    yielding.
+
+    Finally, it allows for retrying without swapping queues because if it does
+    pull an item off the queue when the RPC is inactive, it'll immediately put
+    it back and then exit. This is necessary because yielding the item in this
+    case will cause gRPC to discard it. In practice, this means that the order
+    of messages is not guaranteed. If such a thing is necessary it would be
+    easy to use a priority queue.
+
+    Example::
+
+        requests = request_queue_generator(q)
+        call = stub.StreamingRequest(iter(requests))
+        requests.call = call
+
+        for response in call:
+            print(response)
+            q.put(...)
+
+    Note that it is possible to accomplish this behavior without "spinning"
+    (using a queue timeout). One possible way would be to use more threads to
+    multiplex the grpc end event with the queue, another possible way is to
+    use selectors and a custom event/queue object. Both of these approaches
+    are significant from an engineering perspective for small benefit - the
+    CPU consumed by spinning is pretty minuscule.
+
+    Args:
+        queue (queue.Queue): The request queue.
+        period (float): The number of seconds to wait for items from the queue
+            before checking if the RPC is cancelled. In practice, this
+            determines the maximum amount of time the request consumption
+            thread will live after the RPC is cancelled.
+        initial_request (Union[protobuf.Message,
+                Callable[None, protobuf.Message]]): The initial request to
+            yield. This is done independently of the request queue to allow fo
+            easily restarting streams that require some initial configuration
+            request.
+    """
+
+    def __init__(self, queue, period=1, initial_request=None):
+        self._queue = queue
+        self._period = period
+        self._initial_request = initial_request
+        self.call = None
+
+    def _is_active(self):
+        # Note: there is a possibility that this starts *before* the call
+        # property is set. So we have to check if self.call is set before
+        # seeing if it's active.
+        if self.call is not None and not self.call.is_active():
+            return False
+        else:
+            return True
+
+    def __iter__(self):
+        if self._initial_request is not None:
+            if callable(self._initial_request):
+                yield self._initial_request()
+            else:
+                yield self._initial_request
+
+        while True:
+            try:
+                item = self._queue.get(timeout=self._period)
+            except queue.Empty:
+                if not self._is_active():
+                    _LOGGER.debug(
+                        "Empty queue and inactive call, exiting request " "generator."
+                    )
+                    return
+                else:
+                    # call is still active, keep waiting for queue items.
+                    continue
+
+            # The consumer explicitly sent "None", indicating that the request
+            # should end.
+            if item is None:
+                _LOGGER.debug("Cleanly exiting request generator.")
+                return
+
+            if not self._is_active():
+                # We have an item, but the call is closed. We should put the
+                # item back on the queue so that the next call can consume it.
+                self._queue.put(item)
+                _LOGGER.debug(
+                    "Inactive call, replacing item on queue and exiting "
+                    "request generator."
+                )
+                return
+
+            yield item
+
+
+class _Throttle(object):
+    """A context manager limiting the total entries in a sliding time window.
+
+    If more than ``access_limit`` attempts are made to enter the context manager
+    instance in the last ``time window`` interval, the exceeding requests block
+    until enough time elapses.
+
+    The context manager instances are thread-safe and can be shared between
+    multiple threads. If multiple requests are blocked and waiting to enter,
+    the exact order in which they are allowed to proceed is not determined.
+
+    Example::
+
+        max_three_per_second = _Throttle(
+            access_limit=3, time_window=datetime.timedelta(seconds=1)
+        )
+
+        for i in range(5):
+            with max_three_per_second as time_waited:
+                print("{}: Waited {} seconds to enter".format(i, time_waited))
+
+    Args:
+        access_limit (int): the maximum number of entries allowed in the time window
+        time_window (datetime.timedelta): the width of the sliding time window
+    """
+
+    def __init__(self, access_limit, time_window):
+        if access_limit < 1:
+            raise ValueError("access_limit argument must be positive")
+
+        if time_window <= datetime.timedelta(0):
+            raise ValueError("time_window argument must be a positive timedelta")
+
+        self._time_window = time_window
+        self._access_limit = access_limit
+        self._past_entries = collections.deque(maxlen=access_limit)  # least recent first
+        self._entry_lock = threading.Lock()
+
+    def __enter__(self):
+        with self._entry_lock:
+            cutoff_time = datetime.datetime.now() - self._time_window
+
+            # drop the entries that are too old, as they are no longer relevant
+            while self._past_entries and self._past_entries[0] < cutoff_time:
+                self._past_entries.popleft()
+
+            if len(self._past_entries) < self._access_limit:
+                self._past_entries.append(datetime.datetime.now())
+                return 0.0  # no waiting was needed
+
+            to_wait = (self._past_entries[0] - cutoff_time).total_seconds()
+            time.sleep(to_wait)
+
+            self._past_entries.append(datetime.datetime.now())
+            return to_wait
+
+    def __exit__(self, *_):
+        pass
+
+    def __repr__(self):
+        return "{}(access_limit={}, time_window={})".format(
+            self.__class__.__name__,
+            self._access_limit,
+            repr(self._time_window),
+        )
+
+
+class BidiRpc(object):
+    """A helper for consuming a bi-directional streaming RPC.
+
+    This maps gRPC's built-in interface which uses a request iterator and a
+    response iterator into a socket-like :func:`send` and :func:`recv`. This
+    is a more useful pattern for long-running or asymmetric streams (streams
+    where there is not a direct correlation between the requests and
+    responses).
+
+    Example::
+
+        initial_request = example_pb2.StreamingRpcRequest(
+            setting='example')
+        rpc = BidiRpc(
+            stub.StreamingRpc,
+            initial_request=initial_request,
+            metadata=[('name', 'value')]
+        )
+
+        rpc.open()
+
+        while rpc.is_active():
+            print(rpc.recv())
+            rpc.send(example_pb2.StreamingRpcRequest(
+                data='example'))
+
+    This does *not* retry the stream on errors. See :class:`ResumableBidiRpc`.
+
+    Args:
+        start_rpc (grpc.StreamStreamMultiCallable): The gRPC method used to
+            start the RPC.
+        initial_request (Union[protobuf.Message,
+                Callable[None, protobuf.Message]]): The initial request to
+            yield. This is useful if an initial request is needed to start the
+            stream.
+        metadata (Sequence[Tuple(str, str)]): RPC metadata to include in
+            the request.
+    """
+
+    def __init__(self, start_rpc, initial_request=None, metadata=None):
+        self._start_rpc = start_rpc
+        self._initial_request = initial_request
+        self._rpc_metadata = metadata
+        self._request_queue = queue.Queue()
+        self._request_generator = None
+        self._is_active = False
+        self._callbacks = []
+        self.call = None
+
+    def add_done_callback(self, callback):
+        """Adds a callback that will be called when the RPC terminates.
+
+        This occurs when the RPC errors or is successfully terminated.
+
+        Args:
+            callback (Callable[[grpc.Future], None]): The callback to execute.
+                It will be provided with the same gRPC future as the underlying
+                stream which will also be a :class:`grpc.Call`.
+        """
+        self._callbacks.append(callback)
+
+    def _on_call_done(self, future):
+        for callback in self._callbacks:
+            callback(future)
+
+    def open(self):
+        """Opens the stream."""
+        if self.is_active:
+            raise ValueError("Can not open an already open stream.")
+
+        request_generator = _RequestQueueGenerator(
+            self._request_queue, initial_request=self._initial_request
+        )
+        call = self._start_rpc(iter(request_generator), metadata=self._rpc_metadata)
+
+        request_generator.call = call
+
+        # TODO: api_core should expose the future interface for wrapped
+        # callables as well.
+        if hasattr(call, "_wrapped"):  # pragma: NO COVER
+            call._wrapped.add_done_callback(self._on_call_done)
+        else:
+            call.add_done_callback(self._on_call_done)
+
+        self._request_generator = request_generator
+        self.call = call
+
+    def close(self):
+        """Closes the stream."""
+        if self.call is None:
+            return
+
+        self._request_queue.put(None)
+        self.call.cancel()
+        self._request_generator = None
+        # Don't set self.call to None. Keep it around so that send/recv can
+        # raise the error.
+
+    def send(self, request):
+        """Queue a message to be sent on the stream.
+
+        Send is non-blocking.
+
+        If the underlying RPC has been closed, this will raise.
+
+        Args:
+            request (protobuf.Message): The request to send.
+        """
+        if self.call is None:
+            raise ValueError("Can not send() on an RPC that has never been open()ed.")
+
+        # Don't use self.is_active(), as ResumableBidiRpc will overload it
+        # to mean something semantically different.
+        if self.call.is_active():
+            self._request_queue.put(request)
+        else:
+            # calling next should cause the call to raise.
+            next(self.call)
+
+    def recv(self):
+        """Wait for a message to be returned from the stream.
+
+        Recv is blocking.
+
+        If the underlying RPC has been closed, this will raise.
+
+        Returns:
+            protobuf.Message: The received message.
+        """
+        if self.call is None:
+            raise ValueError("Can not recv() on an RPC that has never been open()ed.")
+
+        return next(self.call)
+
+    @property
+    def is_active(self):
+        """bool: True if this stream is currently open and active."""
+        return self.call is not None and self.call.is_active()
+
+    @property
+    def pending_requests(self):
+        """int: Returns an estimate of the number of queued requests."""
+        return self._request_queue.qsize()
+
+
+def _never_terminate(future_or_error):
+    """By default, no errors cause BiDi termination."""
+    return False
+
+
+class ResumableBidiRpc(BidiRpc):
+    """A :class:`BidiRpc` that can automatically resume the stream on errors.
+
+    It uses the ``should_recover`` arg to determine if it should re-establish
+    the stream on error.
+
+    Example::
+
+        def should_recover(exc):
+            return (
+                isinstance(exc, grpc.RpcError) and
+                exc.code() == grpc.StatusCode.UNVAILABLE)
+
+        initial_request = example_pb2.StreamingRpcRequest(
+            setting='example')
+
+        metadata = [('header_name', 'value')]
+
+        rpc = ResumableBidiRpc(
+            stub.StreamingRpc,
+            should_recover=should_recover,
+            initial_request=initial_request,
+            metadata=metadata
+        )
+
+        rpc.open()
+
+        while rpc.is_active():
+            print(rpc.recv())
+            rpc.send(example_pb2.StreamingRpcRequest(
+                data='example'))
+
+    Args:
+        start_rpc (grpc.StreamStreamMultiCallable): The gRPC method used to
+            start the RPC.
+        initial_request (Union[protobuf.Message,
+                Callable[None, protobuf.Message]]): The initial request to
+            yield. This is useful if an initial request is needed to start the
+            stream.
+        should_recover (Callable[[Exception], bool]): A function that returns
+            True if the stream should be recovered. This will be called
+            whenever an error is encountered on the stream.
+        should_terminate (Callable[[Exception], bool]): A function that returns
+            True if the stream should be terminated. This will be called
+            whenever an error is encountered on the stream.
+        metadata Sequence[Tuple(str, str)]: RPC metadata to include in
+            the request.
+        throttle_reopen (bool): If ``True``, throttling will be applied to
+            stream reopen calls. Defaults to ``False``.
+    """
+
+    def __init__(
+        self,
+        start_rpc,
+        should_recover,
+        should_terminate=_never_terminate,
+        initial_request=None,
+        metadata=None,
+        throttle_reopen=False,
+    ):
+        super(ResumableBidiRpc, self).__init__(start_rpc, initial_request, metadata)
+        self._should_recover = should_recover
+        self._should_terminate = should_terminate
+        self._operational_lock = threading.RLock()
+        self._finalized = False
+        self._finalize_lock = threading.Lock()
+
+        if throttle_reopen:
+            self._reopen_throttle = _Throttle(
+                access_limit=5, time_window=datetime.timedelta(seconds=10),
+            )
+        else:
+            self._reopen_throttle = None
+
+    def _finalize(self, result):
+        with self._finalize_lock:
+            if self._finalized:
+                return
+
+            for callback in self._callbacks:
+                callback(result)
+
+            self._finalized = True
+
+    def _on_call_done(self, future):
+        # Unlike the base class, we only execute the callbacks on a terminal
+        # error, not for errors that we can recover from. Note that grpc's
+        # "future" here is also a grpc.RpcError.
+        with self._operational_lock:
+            if self._should_terminate(future):
+                self._finalize(future)
+            elif not self._should_recover(future):
+                self._finalize(future)
+            else:
+                _LOGGER.debug("Re-opening stream from gRPC callback.")
+                self._reopen()
+
+    def _reopen(self):
+        with self._operational_lock:
+            # Another thread already managed to re-open this stream.
+            if self.call is not None and self.call.is_active():
+                _LOGGER.debug("Stream was already re-established.")
+                return
+
+            self.call = None
+            # Request generator should exit cleanly since the RPC its bound to
+            # has exited.
+            self._request_generator = None
+
+            # Note: we do not currently do any sort of backoff here. The
+            # assumption is that re-establishing the stream under normal
+            # circumstances will happen in intervals greater than 60s.
+            # However, it is possible in a degenerative case that the server
+            # closes the stream rapidly which would lead to thrashing here,
+            # but hopefully in those cases the server would return a non-
+            # retryable error.
+
+            try:
+                if self._reopen_throttle:
+                    with self._reopen_throttle:
+                        self.open()
+                else:
+                    self.open()
+            # If re-opening or re-calling the method fails for any reason,
+            # consider it a terminal error and finalize the stream.
+            except Exception as exc:
+                _LOGGER.debug("Failed to re-open stream due to %s", exc)
+                self._finalize(exc)
+                raise
+
+            _LOGGER.info("Re-established stream")
+
+    def _recoverable(self, method, *args, **kwargs):
+        """Wraps a method to recover the stream and retry on error.
+
+        If a retryable error occurs while making the call, then the stream will
+        be re-opened and the method will be retried. This happens indefinitely
+        so long as the error is a retryable one. If an error occurs while
+        re-opening the stream, then this method will raise immediately and
+        trigger finalization of this object.
+
+        Args:
+            method (Callable[..., Any]): The method to call.
+            args: The args to pass to the method.
+            kwargs: The kwargs to pass to the method.
+        """
+        while True:
+            try:
+                return method(*args, **kwargs)
+
+            except Exception as exc:
+                with self._operational_lock:
+                    _LOGGER.debug("Call to retryable %r caused %s.", method, exc)
+
+                    if self._should_terminate(exc):
+                        self.close()
+                        _LOGGER.debug("Terminating %r due to %s.", method, exc)
+                        self._finalize(exc)
+                        break
+
+                    if not self._should_recover(exc):
+                        self.close()
+                        _LOGGER.debug("Not retrying %r due to %s.", method, exc)
+                        self._finalize(exc)
+                        raise exc
+
+                    _LOGGER.debug("Re-opening stream from retryable %r.", method)
+                    self._reopen()
+
+    def _send(self, request):
+        # Grab a reference to the RPC call. Because another thread (notably
+        # the gRPC error thread) can modify self.call (by invoking reopen),
+        # we should ensure our reference can not change underneath us.
+        # If self.call is modified (such as replaced with a new RPC call) then
+        # this will use the "old" RPC, which should result in the same
+        # exception passed into gRPC's error handler being raised here, which
+        # will be handled by the usual error handling in retryable.
+        with self._operational_lock:
+            call = self.call
+
+        if call is None:
+            raise ValueError("Can not send() on an RPC that has never been open()ed.")
+
+        # Don't use self.is_active(), as ResumableBidiRpc will overload it
+        # to mean something semantically different.
+        if call.is_active():
+            self._request_queue.put(request)
+            pass
+        else:
+            # calling next should cause the call to raise.
+            next(call)
+
+    def send(self, request):
+        return self._recoverable(self._send, request)
+
+    def _recv(self):
+        with self._operational_lock:
+            call = self.call
+
+        if call is None:
+            raise ValueError("Can not recv() on an RPC that has never been open()ed.")
+
+        return next(call)
+
+    def recv(self):
+        return self._recoverable(self._recv)
+
+    @property
+    def is_active(self):
+        """bool: True if this stream is currently open and active."""
+        # Use the operational lock. It's entirely possible for something
+        # to check the active state *while* the RPC is being retried.
+        # Also, use finalized to track the actual terminal state here.
+        # This is because if the stream is re-established by the gRPC thread
+        # it's technically possible to check this between when gRPC marks the
+        # RPC as inactive and when gRPC executes our callback that re-opens
+        # the stream.
+        with self._operational_lock:
+            return self.call is not None and not self._finalized
+
+
+class BackgroundConsumer(object):
+    """A bi-directional stream consumer that runs in a separate thread.
+
+    This maps the consumption of a stream into a callback-based model. It also
+    provides :func:`pause` and :func:`resume` to allow for flow-control.
+
+    Example::
+
+        def should_recover(exc):
+            return (
+                isinstance(exc, grpc.RpcError) and
+                exc.code() == grpc.StatusCode.UNVAILABLE)
+
+        initial_request = example_pb2.StreamingRpcRequest(
+            setting='example')
+
+        rpc = ResumeableBidiRpc(
+            stub.StreamingRpc,
+            initial_request=initial_request,
+            should_recover=should_recover)
+
+        def on_response(response):
+            print(response)
+
+        consumer = BackgroundConsumer(rpc, on_response)
+        consumer.start()
+
+    Note that error handling *must* be done by using the provided
+    ``bidi_rpc``'s ``add_done_callback``. This helper will automatically exit
+    whenever the RPC itself exits and will not provide any error details.
+
+    Args:
+        bidi_rpc (BidiRpc): The RPC to consume. Should not have been
+            ``open()``ed yet.
+        on_response (Callable[[protobuf.Message], None]): The callback to
+            be called for every response on the stream.
+    """
+
+    def __init__(self, bidi_rpc, on_response):
+        self._bidi_rpc = bidi_rpc
+        self._on_response = on_response
+        self._paused = False
+        self._wake = threading.Condition()
+        self._thread = None
+        self._operational_lock = threading.Lock()
+
+    def _on_call_done(self, future):
+        # Resume the thread if it's paused, this prevents blocking forever
+        # when the RPC has terminated.
+        self.resume()
+
+    def _thread_main(self, ready):
+        try:
+            ready.set()
+            self._bidi_rpc.add_done_callback(self._on_call_done)
+            self._bidi_rpc.open()
+
+            while self._bidi_rpc.is_active:
+                # Do not allow the paused status to change at all during this
+                # section. There is a condition where we could be resumed
+                # between checking if we are paused and calling wake.wait(),
+                # which means that we will miss the notification to wake up
+                # (oops!) and wait for a notification that will never come.
+                # Keeping the lock throughout avoids that.
+                # In the future, we could use `Condition.wait_for` if we drop
+                # Python 2.7.
+                with self._wake:
+                    while self._paused:
+                        _LOGGER.debug("paused, waiting for waking.")
+                        self._wake.wait()
+                        _LOGGER.debug("woken.")
+
+                _LOGGER.debug("waiting for recv.")
+                response = self._bidi_rpc.recv()
+                _LOGGER.debug("recved response.")
+                self._on_response(response)
+
+        except exceptions.GoogleAPICallError as exc:
+            _LOGGER.debug(
+                "%s caught error %s and will exit. Generally this is due to "
+                "the RPC itself being cancelled and the error will be "
+                "surfaced to the calling code.",
+                _BIDIRECTIONAL_CONSUMER_NAME,
+                exc,
+                exc_info=True,
+            )
+
+        except Exception as exc:
+            _LOGGER.exception(
+                "%s caught unexpected exception %s and will exit.",
+                _BIDIRECTIONAL_CONSUMER_NAME,
+                exc,
+            )
+
+        _LOGGER.info("%s exiting", _BIDIRECTIONAL_CONSUMER_NAME)
+
+    def start(self):
+        """Start the background thread and begin consuming the thread."""
+        with self._operational_lock:
+            ready = threading.Event()
+            thread = threading.Thread(
+                name=_BIDIRECTIONAL_CONSUMER_NAME,
+                target=self._thread_main,
+                args=(ready,),
+            )
+            thread.daemon = True
+            thread.start()
+            # Other parts of the code rely on `thread.is_alive` which
+            # isn't sufficient to know if a thread is active, just that it may
+            # soon be active. This can cause races. Further protect
+            # against races by using a ready event and wait on it to be set.
+            ready.wait()
+            self._thread = thread
+            _LOGGER.debug("Started helper thread %s", thread.name)
+
+    def stop(self):
+        """Stop consuming the stream and shutdown the background thread."""
+        with self._operational_lock:
+            self._bidi_rpc.close()
+
+            if self._thread is not None:
+                # Resume the thread to wake it up in case it is sleeping.
+                self.resume()
+                self._thread.join()
+
+            self._thread = None
+
+    @property
+    def is_active(self):
+        """bool: True if the background thread is active."""
+        return self._thread is not None and self._thread.is_alive()
+
+    def pause(self):
+        """Pauses the response stream.
+
+        This does *not* pause the request stream.
+        """
+        with self._wake:
+            self._paused = True
+
+    def resume(self):
+        """Resumes the response stream."""
+        with self._wake:
+            self._paused = False
+            self._wake.notifyAll()
+
+    @property
+    def is_paused(self):
+        """bool: True if the response stream is paused."""
+        return self._paused
diff --git a/api_core/google/api_core/client_info.py b/api_core/google/api_core/client_info.py
new file mode 100644
index 000000000000..b196b7a987e4
--- /dev/null
+++ b/api_core/google/api_core/client_info.py
@@ -0,0 +1,96 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for providing client information.
+
+Client information is used to send information about the calling client,
+such as the library and Python version, to API services.
+"""
+
+import platform
+
+import pkg_resources
+
+_PY_VERSION = platform.python_version()
+_API_CORE_VERSION = pkg_resources.get_distribution("google-api-core").version
+
+try:
+    _GRPC_VERSION = pkg_resources.get_distribution("grpcio").version
+except pkg_resources.DistributionNotFound:  # pragma: NO COVER
+    _GRPC_VERSION = None
+
+
+class ClientInfo(object):
+    """Client information used to generate a user-agent for API calls.
+
+    This user-agent information is sent along with API calls to allow the
+    receiving service to do analytics on which versions of Python and Google
+    libraries are being used.
+
+    Args:
+        python_version (str): The Python interpreter version, for example,
+            ``'2.7.13'``.
+        grpc_version (Optional[str]): The gRPC library version.
+        api_core_version (str): The google-api-core library version.
+        gapic_version (Optional[str]): The sversion of gapic-generated client
+            library, if the library was generated by gapic.
+        client_library_version (Optional[str]): The version of the client
+            library, generally used if the client library was not generated
+            by gapic or if additional functionality was built on top of
+            a gapic client library.
+        user_agent (Optional[str]): Prefix to the user agent header. This is
+            used to supply information such as application name or partner tool.
+            Recommended format: ``application-or-tool-ID/major.minor.version``.
+    """
+
+    def __init__(
+        self,
+        python_version=_PY_VERSION,
+        grpc_version=_GRPC_VERSION,
+        api_core_version=_API_CORE_VERSION,
+        gapic_version=None,
+        client_library_version=None,
+        user_agent=None,
+    ):
+        self.python_version = python_version
+        self.grpc_version = grpc_version
+        self.api_core_version = api_core_version
+        self.gapic_version = gapic_version
+        self.client_library_version = client_library_version
+        self.user_agent = user_agent
+
+    def to_user_agent(self):
+        """Returns the user-agent string for this client info."""
+
+        # Note: the order here is important as the internal metrics system
+        # expects these items to be in specific locations.
+        ua = ""
+
+        if self.user_agent is not None:
+            ua += "{user_agent} "
+
+        ua += "gl-python/{python_version} "
+
+        if self.grpc_version is not None:
+            ua += "grpc/{grpc_version} "
+
+        ua += "gax/{api_core_version} "
+
+        if self.gapic_version is not None:
+            ua += "gapic/{gapic_version} "
+
+        if self.client_library_version is not None:
+            ua += "gccl/{client_library_version} "
+
+        return ua.format(**self.__dict__).strip()
diff --git a/api_core/google/api_core/client_options.py b/api_core/google/api_core/client_options.py
new file mode 100644
index 000000000000..1144d2f62a37
--- /dev/null
+++ b/api_core/google/api_core/client_options.py
@@ -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.
+
+"""Client options class.
+
+Client options provide a consistent interface for user options to be defined
+across clients.
+
+You can pass a client options object to a client.
+
+.. code-block:: python
+
+    from google.api_core.client_options import ClientOptions
+    from google.cloud.vision_v1 import ImageAnnotatorClient
+
+    options = ClientOptions(api_endpoint="foo.googleapis.com")
+
+    client = ImageAnnotatorClient(client_options=options)
+
+You can also pass a dictionary.
+
+.. code-block:: python
+
+    from google.cloud.vision_v1 import ImageAnnotatorClient
+
+    client = ImageAnnotatorClient(client_options={"api_endpoint": "foo.googleapis.com"})
+
+
+"""
+
+
+class ClientOptions(object):
+    """Client Options used to set options on clients.
+
+    Args:
+        api_endpoint (str): The desired API endpoint, e.g., compute.googleapis.com
+    """
+
+    def __init__(self, api_endpoint=None):
+        self.api_endpoint = api_endpoint
+
+
+def from_dict(options):
+    """Construct a client options object from a dictionary.
+
+    Args:
+        options (dict): A dictionary with client options.
+    """
+
+    client_options = ClientOptions()
+
+    for key, value in options.items():
+        if hasattr(client_options, key):
+            setattr(client_options, key, value)
+        else:
+            raise ValueError("ClientOptions does not accept an option '" + key + "'")
+
+    return client_options
diff --git a/api_core/google/api_core/datetime_helpers.py b/api_core/google/api_core/datetime_helpers.py
new file mode 100644
index 000000000000..84c1bb7f512c
--- /dev/null
+++ b/api_core/google/api_core/datetime_helpers.py
@@ -0,0 +1,303 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for :mod:`datetime`."""
+
+import calendar
+import datetime
+import re
+
+import pytz
+
+from google.protobuf import timestamp_pb2
+
+
+_UTC_EPOCH = datetime.datetime.utcfromtimestamp(0).replace(tzinfo=pytz.utc)
+_RFC3339_MICROS = "%Y-%m-%dT%H:%M:%S.%fZ"
+_RFC3339_NO_FRACTION = "%Y-%m-%dT%H:%M:%S"
+# datetime.strptime cannot handle nanosecond precision:  parse w/ regex
+_RFC3339_NANOS = re.compile(
+    r"""
+    (?P<no_fraction>
+        \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}  # YYYY-MM-DDTHH:MM:SS
+    )
+    (                                        # Optional decimal part
+     \.                                      # decimal point
+     (?P<nanos>\d{1,9})                      # nanoseconds, maybe truncated
+    )?
+    Z                                        # Zulu
+""",
+    re.VERBOSE,
+)
+
+
+def utcnow():
+    """A :meth:`datetime.datetime.utcnow()` alias to allow mocking in tests."""
+    return datetime.datetime.utcnow()
+
+
+def to_milliseconds(value):
+    """Convert a zone-aware datetime to milliseconds since the unix epoch.
+
+    Args:
+        value (datetime.datetime): The datetime to covert.
+
+    Returns:
+        int: Milliseconds since the unix epoch.
+    """
+    micros = to_microseconds(value)
+    return micros // 1000
+
+
+def from_microseconds(value):
+    """Convert timestamp in microseconds since the unix epoch to datetime.
+
+    Args:
+        value (float): The timestamp to convert, in microseconds.
+
+    Returns:
+        datetime.datetime: The datetime object equivalent to the timestamp in
+            UTC.
+    """
+    return _UTC_EPOCH + datetime.timedelta(microseconds=value)
+
+
+def to_microseconds(value):
+    """Convert a datetime to microseconds since the unix epoch.
+
+    Args:
+        value (datetime.datetime): The datetime to covert.
+
+    Returns:
+        int: Microseconds since the unix epoch.
+    """
+    if not value.tzinfo:
+        value = value.replace(tzinfo=pytz.utc)
+    # Regardless of what timezone is on the value, convert it to UTC.
+    value = value.astimezone(pytz.utc)
+    # Convert the datetime to a microsecond timestamp.
+    return int(calendar.timegm(value.timetuple()) * 1e6) + value.microsecond
+
+
+def from_iso8601_date(value):
+    """Convert a ISO8601 date string to a date.
+
+    Args:
+        value (str): The ISO8601 date string.
+
+    Returns:
+        datetime.date: A date equivalent to the date string.
+    """
+    return datetime.datetime.strptime(value, "%Y-%m-%d").date()
+
+
+def from_iso8601_time(value):
+    """Convert a zoneless ISO8601 time string to a time.
+
+    Args:
+        value (str): The ISO8601 time string.
+
+    Returns:
+        datetime.time: A time equivalent to the time string.
+    """
+    return datetime.datetime.strptime(value, "%H:%M:%S").time()
+
+
+def from_rfc3339(value):
+    """Convert a microsecond-precision timestamp to datetime.
+
+    Args:
+        value (str): The RFC3339 string to convert.
+
+    Returns:
+        datetime.datetime: The datetime object equivalent to the timestamp in
+            UTC.
+    """
+    return datetime.datetime.strptime(value, _RFC3339_MICROS).replace(tzinfo=pytz.utc)
+
+
+def from_rfc3339_nanos(value):
+    """Convert a nanosecond-precision timestamp to a native datetime.
+
+    .. note::
+        Python datetimes do not support nanosecond precision; this function
+        therefore truncates such values to microseconds.
+
+    Args:
+        value (str): The RFC3339 string to convert.
+
+    Returns:
+        datetime.datetime: The datetime object equivalent to the timestamp in
+            UTC.
+
+    Raises:
+        ValueError: If the timestamp does not match the RFC 3339
+            regular expression.
+    """
+    with_nanos = _RFC3339_NANOS.match(value)
+
+    if with_nanos is None:
+        raise ValueError(
+            "Timestamp: {!r}, does not match pattern: {!r}".format(
+                value, _RFC3339_NANOS.pattern
+            )
+        )
+
+    bare_seconds = datetime.datetime.strptime(
+        with_nanos.group("no_fraction"), _RFC3339_NO_FRACTION
+    )
+    fraction = with_nanos.group("nanos")
+
+    if fraction is None:
+        micros = 0
+    else:
+        scale = 9 - len(fraction)
+        nanos = int(fraction) * (10 ** scale)
+        micros = nanos // 1000
+
+    return bare_seconds.replace(microsecond=micros, tzinfo=pytz.utc)
+
+
+def to_rfc3339(value, ignore_zone=True):
+    """Convert a datetime to an RFC3339 timestamp string.
+
+    Args:
+        value (datetime.datetime):
+            The datetime object to be converted to a string.
+        ignore_zone (bool): If True, then the timezone (if any) of the
+            datetime object is ignored and the datetime is treated as UTC.
+
+    Returns:
+        str: The RFC3339 formated string representing the datetime.
+    """
+    if not ignore_zone and value.tzinfo is not None:
+        # Convert to UTC and remove the time zone info.
+        value = value.replace(tzinfo=None) - value.utcoffset()
+
+    return value.strftime(_RFC3339_MICROS)
+
+
+class DatetimeWithNanoseconds(datetime.datetime):
+    """Track nanosecond in addition to normal datetime attrs.
+
+    Nanosecond can be passed only as a keyword argument.
+    """
+
+    __slots__ = ("_nanosecond",)
+
+    # pylint: disable=arguments-differ
+    def __new__(cls, *args, **kw):
+        nanos = kw.pop("nanosecond", 0)
+        if nanos > 0:
+            if "microsecond" in kw:
+                raise TypeError("Specify only one of 'microsecond' or 'nanosecond'")
+            kw["microsecond"] = nanos // 1000
+        inst = datetime.datetime.__new__(cls, *args, **kw)
+        inst._nanosecond = nanos or 0
+        return inst
+
+    # pylint: disable=arguments-differ
+
+    @property
+    def nanosecond(self):
+        """Read-only: nanosecond precision."""
+        return self._nanosecond
+
+    def rfc3339(self):
+        """Return an RFC 3339-compliant timestamp.
+
+        Returns:
+            (str): Timestamp string according to RFC 3339 spec.
+        """
+        if self._nanosecond == 0:
+            return to_rfc3339(self)
+        nanos = str(self._nanosecond).rjust(9, '0').rstrip("0")
+        return "{}.{}Z".format(self.strftime(_RFC3339_NO_FRACTION), nanos)
+
+    @classmethod
+    def from_rfc3339(cls, stamp):
+        """Parse RFC 3339-compliant timestamp, preserving nanoseconds.
+
+        Args:
+            stamp (str): RFC 3339 stamp, with up to nanosecond precision
+
+        Returns:
+            :class:`DatetimeWithNanoseconds`:
+                an instance matching the timestamp string
+
+        Raises:
+            ValueError: if `stamp` does not match the expected format
+        """
+        with_nanos = _RFC3339_NANOS.match(stamp)
+        if with_nanos is None:
+            raise ValueError(
+                "Timestamp: {}, does not match pattern: {}".format(
+                    stamp, _RFC3339_NANOS.pattern
+                )
+            )
+        bare = datetime.datetime.strptime(
+            with_nanos.group("no_fraction"), _RFC3339_NO_FRACTION
+        )
+        fraction = with_nanos.group("nanos")
+        if fraction is None:
+            nanos = 0
+        else:
+            scale = 9 - len(fraction)
+            nanos = int(fraction) * (10 ** scale)
+        return cls(
+            bare.year,
+            bare.month,
+            bare.day,
+            bare.hour,
+            bare.minute,
+            bare.second,
+            nanosecond=nanos,
+            tzinfo=pytz.UTC,
+        )
+
+    def timestamp_pb(self):
+        """Return a timestamp message.
+
+        Returns:
+            (:class:`~google.protobuf.timestamp_pb2.Timestamp`): Timestamp message
+        """
+        inst = self if self.tzinfo is not None else self.replace(tzinfo=pytz.UTC)
+        delta = inst - _UTC_EPOCH
+        seconds = int(delta.total_seconds())
+        nanos = self._nanosecond or self.microsecond * 1000
+        return timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
+
+    @classmethod
+    def from_timestamp_pb(cls, stamp):
+        """Parse RFC 3339-compliant timestamp, preserving nanoseconds.
+
+        Args:
+            stamp (:class:`~google.protobuf.timestamp_pb2.Timestamp`): timestamp message
+
+        Returns:
+            :class:`DatetimeWithNanoseconds`:
+                an instance matching the timestamp message
+        """
+        microseconds = int(stamp.seconds * 1e6)
+        bare = from_microseconds(microseconds)
+        return cls(
+            bare.year,
+            bare.month,
+            bare.day,
+            bare.hour,
+            bare.minute,
+            bare.second,
+            nanosecond=stamp.nanos,
+            tzinfo=pytz.UTC,
+        )
diff --git a/api_core/google/api_core/exceptions.py b/api_core/google/api_core/exceptions.py
new file mode 100644
index 000000000000..eed4ee40eee5
--- /dev/null
+++ b/api_core/google/api_core/exceptions.py
@@ -0,0 +1,462 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Exceptions raised by Google API core & clients.
+
+This module provides base classes for all errors raised by libraries based
+on :mod:`google.api_core`, including both HTTP and gRPC clients.
+"""
+
+from __future__ import absolute_import
+from __future__ import unicode_literals
+
+import six
+from six.moves import http_client
+
+try:
+    import grpc
+except ImportError:  # pragma: NO COVER
+    grpc = None
+
+# Lookup tables for mapping exceptions from HTTP and gRPC transports.
+# Populated by _APICallErrorMeta
+_HTTP_CODE_TO_EXCEPTION = {}
+_GRPC_CODE_TO_EXCEPTION = {}
+
+
+class GoogleAPIError(Exception):
+    """Base class for all exceptions raised by Google API Clients."""
+
+    pass
+
+
+@six.python_2_unicode_compatible
+class RetryError(GoogleAPIError):
+    """Raised when a function has exhausted all of its available retries.
+
+    Args:
+        message (str): The exception message.
+        cause (Exception): The last exception raised when retring the
+            function.
+    """
+
+    def __init__(self, message, cause):
+        super(RetryError, self).__init__(message)
+        self.message = message
+        self._cause = cause
+
+    @property
+    def cause(self):
+        """The last exception raised when retrying the function."""
+        return self._cause
+
+    def __str__(self):
+        return "{}, last exception: {}".format(self.message, self.cause)
+
+
+class _GoogleAPICallErrorMeta(type):
+    """Metaclass for registering GoogleAPICallError subclasses."""
+
+    def __new__(mcs, name, bases, class_dict):
+        cls = type.__new__(mcs, name, bases, class_dict)
+        if cls.code is not None:
+            _HTTP_CODE_TO_EXCEPTION.setdefault(cls.code, cls)
+        if cls.grpc_status_code is not None:
+            _GRPC_CODE_TO_EXCEPTION.setdefault(cls.grpc_status_code, cls)
+        return cls
+
+
+@six.python_2_unicode_compatible
+@six.add_metaclass(_GoogleAPICallErrorMeta)
+class GoogleAPICallError(GoogleAPIError):
+    """Base class for exceptions raised by calling API methods.
+
+    Args:
+        message (str): The exception message.
+        errors (Sequence[Any]): An optional list of error details.
+        response (Union[requests.Request, grpc.Call]): The response or
+            gRPC call metadata.
+    """
+
+    code = None
+    """Optional[int]: The HTTP status code associated with this error.
+
+    This may be ``None`` if the exception does not have a direct mapping
+    to an HTTP error.
+
+    See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
+    """
+
+    grpc_status_code = None
+    """Optional[grpc.StatusCode]: The gRPC status code associated with this
+    error.
+
+    This may be ``None`` if the exception does not match up to a gRPC error.
+    """
+
+    def __init__(self, message, errors=(), response=None):
+        super(GoogleAPICallError, self).__init__(message)
+        self.message = message
+        """str: The exception message."""
+        self._errors = errors
+        self._response = response
+
+    def __str__(self):
+        return "{} {}".format(self.code, self.message)
+
+    @property
+    def errors(self):
+        """Detailed error information.
+
+        Returns:
+            Sequence[Any]: A list of additional error details.
+        """
+        return list(self._errors)
+
+    @property
+    def response(self):
+        """Optional[Union[requests.Request, grpc.Call]]: The response or
+        gRPC call metadata."""
+        return self._response
+
+
+class Redirection(GoogleAPICallError):
+    """Base class for for all redirection (HTTP 3xx) responses."""
+
+
+class MovedPermanently(Redirection):
+    """Exception mapping a ``301 Moved Permanently`` response."""
+
+    code = http_client.MOVED_PERMANENTLY
+
+
+class NotModified(Redirection):
+    """Exception mapping a ``304 Not Modified`` response."""
+
+    code = http_client.NOT_MODIFIED
+
+
+class TemporaryRedirect(Redirection):
+    """Exception mapping a ``307 Temporary Redirect`` response."""
+
+    code = http_client.TEMPORARY_REDIRECT
+
+
+class ResumeIncomplete(Redirection):
+    """Exception mapping a ``308 Resume Incomplete`` response.
+
+    .. note:: :attr:`http_client.PERMANENT_REDIRECT` is ``308``, but Google
+        APIs differ in their use of this status code.
+    """
+
+    code = 308
+
+
+class ClientError(GoogleAPICallError):
+    """Base class for all client error (HTTP 4xx) responses."""
+
+
+class BadRequest(ClientError):
+    """Exception mapping a ``400 Bad Request`` response."""
+
+    code = http_client.BAD_REQUEST
+
+
+class InvalidArgument(BadRequest):
+    """Exception mapping a :attr:`grpc.StatusCode.INVALID_ARGUMENT` error."""
+
+    grpc_status_code = grpc.StatusCode.INVALID_ARGUMENT if grpc is not None else None
+
+
+class FailedPrecondition(BadRequest):
+    """Exception mapping a :attr:`grpc.StatusCode.FAILED_PRECONDITION`
+    error."""
+
+    grpc_status_code = grpc.StatusCode.FAILED_PRECONDITION if grpc is not None else None
+
+
+class OutOfRange(BadRequest):
+    """Exception mapping a :attr:`grpc.StatusCode.OUT_OF_RANGE` error."""
+
+    grpc_status_code = grpc.StatusCode.OUT_OF_RANGE if grpc is not None else None
+
+
+class Unauthorized(ClientError):
+    """Exception mapping a ``401 Unauthorized`` response."""
+
+    code = http_client.UNAUTHORIZED
+
+
+class Unauthenticated(Unauthorized):
+    """Exception mapping a :attr:`grpc.StatusCode.UNAUTHENTICATED` error."""
+
+    grpc_status_code = grpc.StatusCode.UNAUTHENTICATED if grpc is not None else None
+
+
+class Forbidden(ClientError):
+    """Exception mapping a ``403 Forbidden`` response."""
+
+    code = http_client.FORBIDDEN
+
+
+class PermissionDenied(Forbidden):
+    """Exception mapping a :attr:`grpc.StatusCode.PERMISSION_DENIED` error."""
+
+    grpc_status_code = grpc.StatusCode.PERMISSION_DENIED if grpc is not None else None
+
+
+class NotFound(ClientError):
+    """Exception mapping a ``404 Not Found`` response or a
+    :attr:`grpc.StatusCode.NOT_FOUND` error."""
+
+    code = http_client.NOT_FOUND
+    grpc_status_code = grpc.StatusCode.NOT_FOUND if grpc is not None else None
+
+
+class MethodNotAllowed(ClientError):
+    """Exception mapping a ``405 Method Not Allowed`` response."""
+
+    code = http_client.METHOD_NOT_ALLOWED
+
+
+class Conflict(ClientError):
+    """Exception mapping a ``409 Conflict`` response."""
+
+    code = http_client.CONFLICT
+
+
+class AlreadyExists(Conflict):
+    """Exception mapping a :attr:`grpc.StatusCode.ALREADY_EXISTS` error."""
+
+    grpc_status_code = grpc.StatusCode.ALREADY_EXISTS if grpc is not None else None
+
+
+class Aborted(Conflict):
+    """Exception mapping a :attr:`grpc.StatusCode.ABORTED` error."""
+
+    grpc_status_code = grpc.StatusCode.ABORTED if grpc is not None else None
+
+
+class LengthRequired(ClientError):
+    """Exception mapping a ``411 Length Required`` response."""
+
+    code = http_client.LENGTH_REQUIRED
+
+
+class PreconditionFailed(ClientError):
+    """Exception mapping a ``412 Precondition Failed`` response."""
+
+    code = http_client.PRECONDITION_FAILED
+
+
+class RequestRangeNotSatisfiable(ClientError):
+    """Exception mapping a ``416 Request Range Not Satisfiable`` response."""
+
+    code = http_client.REQUESTED_RANGE_NOT_SATISFIABLE
+
+
+class TooManyRequests(ClientError):
+    """Exception mapping a ``429 Too Many Requests`` response."""
+
+    # http_client does not define a constant for this in Python 2.
+    code = 429
+
+
+class ResourceExhausted(TooManyRequests):
+    """Exception mapping a :attr:`grpc.StatusCode.RESOURCE_EXHAUSTED` error."""
+
+    grpc_status_code = grpc.StatusCode.RESOURCE_EXHAUSTED if grpc is not None else None
+
+
+class Cancelled(ClientError):
+    """Exception mapping a :attr:`grpc.StatusCode.CANCELLED` error."""
+
+    # This maps to HTTP status code 499. See
+    # https://github.com/googleapis/googleapis/blob/master/google/rpc\
+    # /code.proto
+    code = 499
+    grpc_status_code = grpc.StatusCode.CANCELLED if grpc is not None else None
+
+
+class ServerError(GoogleAPICallError):
+    """Base for 5xx responses."""
+
+
+class InternalServerError(ServerError):
+    """Exception mapping a ``500 Internal Server Error`` response. or a
+    :attr:`grpc.StatusCode.INTERNAL` error."""
+
+    code = http_client.INTERNAL_SERVER_ERROR
+    grpc_status_code = grpc.StatusCode.INTERNAL if grpc is not None else None
+
+
+class Unknown(ServerError):
+    """Exception mapping a :attr:`grpc.StatusCode.UNKNOWN` error."""
+
+    grpc_status_code = grpc.StatusCode.UNKNOWN if grpc is not None else None
+
+
+class DataLoss(ServerError):
+    """Exception mapping a :attr:`grpc.StatusCode.DATA_LOSS` error."""
+
+    grpc_status_code = grpc.StatusCode.DATA_LOSS if grpc is not None else None
+
+
+class MethodNotImplemented(ServerError):
+    """Exception mapping a ``501 Not Implemented`` response or a
+    :attr:`grpc.StatusCode.UNIMPLEMENTED` error."""
+
+    code = http_client.NOT_IMPLEMENTED
+    grpc_status_code = grpc.StatusCode.UNIMPLEMENTED if grpc is not None else None
+
+
+class BadGateway(ServerError):
+    """Exception mapping a ``502 Bad Gateway`` response."""
+
+    code = http_client.BAD_GATEWAY
+
+
+class ServiceUnavailable(ServerError):
+    """Exception mapping a ``503 Service Unavailable`` response or a
+    :attr:`grpc.StatusCode.UNAVAILABLE` error."""
+
+    code = http_client.SERVICE_UNAVAILABLE
+    grpc_status_code = grpc.StatusCode.UNAVAILABLE if grpc is not None else None
+
+
+class GatewayTimeout(ServerError):
+    """Exception mapping a ``504 Gateway Timeout`` response."""
+
+    code = http_client.GATEWAY_TIMEOUT
+
+
+class DeadlineExceeded(GatewayTimeout):
+    """Exception mapping a :attr:`grpc.StatusCode.DEADLINE_EXCEEDED` error."""
+
+    grpc_status_code = grpc.StatusCode.DEADLINE_EXCEEDED if grpc is not None else None
+
+
+def exception_class_for_http_status(status_code):
+    """Return the exception class for a specific HTTP status code.
+
+    Args:
+        status_code (int): The HTTP status code.
+
+    Returns:
+        :func:`type`: the appropriate subclass of :class:`GoogleAPICallError`.
+    """
+    return _HTTP_CODE_TO_EXCEPTION.get(status_code, GoogleAPICallError)
+
+
+def from_http_status(status_code, message, **kwargs):
+    """Create a :class:`GoogleAPICallError` from an HTTP status code.
+
+    Args:
+        status_code (int): The HTTP status code.
+        message (str): The exception message.
+        kwargs: Additional arguments passed to the :class:`GoogleAPICallError`
+            constructor.
+
+    Returns:
+        GoogleAPICallError: An instance of the appropriate subclass of
+            :class:`GoogleAPICallError`.
+    """
+    error_class = exception_class_for_http_status(status_code)
+    error = error_class(message, **kwargs)
+
+    if error.code is None:
+        error.code = status_code
+
+    return error
+
+
+def from_http_response(response):
+    """Create a :class:`GoogleAPICallError` from a :class:`requests.Response`.
+
+    Args:
+        response (requests.Response): The HTTP response.
+
+    Returns:
+        GoogleAPICallError: An instance of the appropriate subclass of
+            :class:`GoogleAPICallError`, with the message and errors populated
+            from the response.
+    """
+    try:
+        payload = response.json()
+    except ValueError:
+        payload = {"error": {"message": response.text or "unknown error"}}
+
+    error_message = payload.get("error", {}).get("message", "unknown error")
+    errors = payload.get("error", {}).get("errors", ())
+
+    message = "{method} {url}: {error}".format(
+        method=response.request.method, url=response.request.url, error=error_message
+    )
+
+    exception = from_http_status(
+        response.status_code, message, errors=errors, response=response
+    )
+    return exception
+
+
+def exception_class_for_grpc_status(status_code):
+    """Return the exception class for a specific :class:`grpc.StatusCode`.
+
+    Args:
+        status_code (grpc.StatusCode): The gRPC status code.
+
+    Returns:
+        :func:`type`: the appropriate subclass of :class:`GoogleAPICallError`.
+    """
+    return _GRPC_CODE_TO_EXCEPTION.get(status_code, GoogleAPICallError)
+
+
+def from_grpc_status(status_code, message, **kwargs):
+    """Create a :class:`GoogleAPICallError` from a :class:`grpc.StatusCode`.
+
+    Args:
+        status_code (grpc.StatusCode): The gRPC status code.
+        message (str): The exception message.
+        kwargs: Additional arguments passed to the :class:`GoogleAPICallError`
+            constructor.
+
+    Returns:
+        GoogleAPICallError: An instance of the appropriate subclass of
+            :class:`GoogleAPICallError`.
+    """
+    error_class = exception_class_for_grpc_status(status_code)
+    error = error_class(message, **kwargs)
+
+    if error.grpc_status_code is None:
+        error.grpc_status_code = status_code
+
+    return error
+
+
+def from_grpc_error(rpc_exc):
+    """Create a :class:`GoogleAPICallError` from a :class:`grpc.RpcError`.
+
+    Args:
+        rpc_exc (grpc.RpcError): The gRPC error.
+
+    Returns:
+        GoogleAPICallError: An instance of the appropriate subclass of
+            :class:`GoogleAPICallError`.
+    """
+    if isinstance(rpc_exc, grpc.Call):
+        return from_grpc_status(
+            rpc_exc.code(), rpc_exc.details(), errors=(rpc_exc,), response=rpc_exc
+        )
+    else:
+        return GoogleAPICallError(str(rpc_exc), errors=(rpc_exc,), response=rpc_exc)
diff --git a/api_core/google/api_core/future/__init__.py b/api_core/google/api_core/future/__init__.py
new file mode 100644
index 000000000000..3768b2c53f53
--- /dev/null
+++ b/api_core/google/api_core/future/__init__.py
@@ -0,0 +1,19 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Futures for dealing with asynchronous operations."""
+
+from google.api_core.future.base import Future
+
+__all__ = ["Future"]
diff --git a/api_core/google/api_core/future/_helpers.py b/api_core/google/api_core/future/_helpers.py
new file mode 100644
index 000000000000..9e88ca9d561d
--- /dev/null
+++ b/api_core/google/api_core/future/_helpers.py
@@ -0,0 +1,39 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Private helpers for futures."""
+
+import logging
+import threading
+
+
+_LOGGER = logging.getLogger(__name__)
+
+
+def start_daemon_thread(*args, **kwargs):
+    """Starts a thread and marks it as a daemon thread."""
+    thread = threading.Thread(*args, **kwargs)
+    thread.daemon = True
+    thread.start()
+    return thread
+
+
+def safe_invoke_callback(callback, *args, **kwargs):
+    """Invoke a callback, swallowing and logging any exceptions."""
+    # pylint: disable=bare-except
+    # We intentionally want to swallow all exceptions.
+    try:
+        return callback(*args, **kwargs)
+    except Exception:
+        _LOGGER.exception("Error while executing Future callback.")
diff --git a/api_core/google/api_core/future/base.py b/api_core/google/api_core/future/base.py
new file mode 100644
index 000000000000..e7888ca3b07b
--- /dev/null
+++ b/api_core/google/api_core/future/base.py
@@ -0,0 +1,67 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Abstract and helper bases for Future implementations."""
+
+import abc
+
+import six
+
+
+@six.add_metaclass(abc.ABCMeta)
+class Future(object):
+    # pylint: disable=missing-docstring
+    # We inherit the interfaces here from concurrent.futures.
+
+    """Future interface.
+
+    This interface is based on :class:`concurrent.futures.Future`.
+    """
+
+    @abc.abstractmethod
+    def cancel(self):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def cancelled(self):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def running(self):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def done(self):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def result(self, timeout=None):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def exception(self, timeout=None):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def add_done_callback(self, fn):
+        # pylint: disable=invalid-name
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def set_result(self, result):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def set_exception(self, exception):
+        raise NotImplementedError()
diff --git a/api_core/google/api_core/future/polling.py b/api_core/google/api_core/future/polling.py
new file mode 100644
index 000000000000..4266e9e721e3
--- /dev/null
+++ b/api_core/google/api_core/future/polling.py
@@ -0,0 +1,183 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Abstract and helper bases for Future implementations."""
+
+import abc
+import concurrent.futures
+
+from google.api_core import exceptions
+from google.api_core import retry
+from google.api_core.future import _helpers
+from google.api_core.future import base
+
+
+class _OperationNotComplete(Exception):
+    """Private exception used for polling via retry."""
+
+    pass
+
+
+RETRY_PREDICATE = retry.if_exception_type(
+    _OperationNotComplete,
+    exceptions.TooManyRequests,
+    exceptions.InternalServerError,
+    exceptions.BadGateway,
+)
+DEFAULT_RETRY = retry.Retry(predicate=RETRY_PREDICATE)
+
+
+class PollingFuture(base.Future):
+    """A Future that needs to poll some service to check its status.
+
+    The :meth:`done` method should be implemented by subclasses. The polling
+    behavior will repeatedly call ``done`` until it returns True.
+
+    .. note: Privacy here is intended to prevent the final class from
+      overexposing, not to prevent subclasses from accessing methods.
+
+    Args:
+        retry (google.api_core.retry.Retry): The retry configuration used
+            when polling. This can be used to control how often :meth:`done`
+            is polled. Regardless of the retry's ``deadline``, it will be
+            overridden by the ``timeout`` argument to :meth:`result`.
+    """
+
+    def __init__(self, retry=DEFAULT_RETRY):
+        super(PollingFuture, self).__init__()
+        self._retry = retry
+        self._result = None
+        self._exception = None
+        self._result_set = False
+        """bool: Set to True when the result has been set via set_result or
+        set_exception."""
+        self._polling_thread = None
+        self._done_callbacks = []
+
+    @abc.abstractmethod
+    def done(self):
+        """Checks to see if the operation is complete.
+
+        Returns:
+            bool: True if the operation is complete, False otherwise.
+        """
+        # pylint: disable=redundant-returns-doc, missing-raises-doc
+        raise NotImplementedError()
+
+    def _done_or_raise(self):
+        """Check if the future is done and raise if it's not."""
+        if not self.done():
+            raise _OperationNotComplete()
+
+    def running(self):
+        """True if the operation is currently running."""
+        return not self.done()
+
+    def _blocking_poll(self, timeout=None):
+        """Poll and wait for the Future to be resolved.
+
+        Args:
+            timeout (int):
+                How long (in seconds) to wait for the operation to complete.
+                If None, wait indefinitely.
+        """
+        if self._result_set:
+            return
+
+        retry_ = self._retry.with_deadline(timeout)
+
+        try:
+            retry_(self._done_or_raise)()
+        except exceptions.RetryError:
+            raise concurrent.futures.TimeoutError(
+                "Operation did not complete within the designated " "timeout."
+            )
+
+    def result(self, timeout=None):
+        """Get the result of the operation, blocking if necessary.
+
+        Args:
+            timeout (int):
+                How long (in seconds) to wait for the operation to complete.
+                If None, wait indefinitely.
+
+        Returns:
+            google.protobuf.Message: The Operation's result.
+
+        Raises:
+            google.api_core.GoogleAPICallError: If the operation errors or if
+                the timeout is reached before the operation completes.
+        """
+        self._blocking_poll(timeout=timeout)
+
+        if self._exception is not None:
+            # pylint: disable=raising-bad-type
+            # Pylint doesn't recognize that this is valid in this case.
+            raise self._exception
+
+        return self._result
+
+    def exception(self, timeout=None):
+        """Get the exception from the operation, blocking if necessary.
+
+        Args:
+            timeout (int): How long to wait for the operation to complete.
+                If None, wait indefinitely.
+
+        Returns:
+            Optional[google.api_core.GoogleAPICallError]: The operation's
+                error.
+        """
+        self._blocking_poll(timeout=timeout)
+        return self._exception
+
+    def add_done_callback(self, fn):
+        """Add a callback to be executed when the operation is complete.
+
+        If the operation is not already complete, this will start a helper
+        thread to poll for the status of the operation in the background.
+
+        Args:
+            fn (Callable[Future]): The callback to execute when the operation
+                is complete.
+        """
+        if self._result_set:
+            _helpers.safe_invoke_callback(fn, self)
+            return
+
+        self._done_callbacks.append(fn)
+
+        if self._polling_thread is None:
+            # The polling thread will exit on its own as soon as the operation
+            # is done.
+            self._polling_thread = _helpers.start_daemon_thread(
+                target=self._blocking_poll
+            )
+
+    def _invoke_callbacks(self, *args, **kwargs):
+        """Invoke all done callbacks."""
+        for callback in self._done_callbacks:
+            _helpers.safe_invoke_callback(callback, *args, **kwargs)
+
+    def set_result(self, result):
+        """Set the Future's result."""
+        self._result = result
+        self._result_set = True
+        self._invoke_callbacks(self)
+
+    def set_exception(self, exception):
+        """Set the Future's exception."""
+        self._exception = exception
+        self._result_set = True
+        self._invoke_callbacks(self)
diff --git a/api_core/google/api_core/gapic_v1/__init__.py b/api_core/google/api_core/gapic_v1/__init__.py
new file mode 100644
index 000000000000..e7a7a686f58e
--- /dev/null
+++ b/api_core/google/api_core/gapic_v1/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.api_core.gapic_v1 import client_info
+from google.api_core.gapic_v1 import config
+from google.api_core.gapic_v1 import method
+from google.api_core.gapic_v1 import routing_header
+
+__all__ = ["client_info", "config", "method", "routing_header"]
diff --git a/api_core/google/api_core/gapic_v1/client_info.py b/api_core/google/api_core/gapic_v1/client_info.py
new file mode 100644
index 000000000000..bdc2ce440de3
--- /dev/null
+++ b/api_core/google/api_core/gapic_v1/client_info.py
@@ -0,0 +1,55 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for providing client information.
+
+Client information is used to send information about the calling client,
+such as the library and Python version, to API services.
+"""
+
+from google.api_core import client_info
+
+
+METRICS_METADATA_KEY = "x-goog-api-client"
+
+
+class ClientInfo(client_info.ClientInfo):
+    """Client information used to generate a user-agent for API calls.
+
+    This user-agent information is sent along with API calls to allow the
+    receiving service to do analytics on which versions of Python and Google
+    libraries are being used.
+
+    Args:
+        python_version (str): The Python interpreter version, for example,
+            ``'2.7.13'``.
+        grpc_version (Optional[str]): The gRPC library version.
+        api_core_version (str): The google-api-core library version.
+        gapic_version (Optional[str]): The sversion of gapic-generated client
+            library, if the library was generated by gapic.
+        client_library_version (Optional[str]): The version of the client
+            library, generally used if the client library was not generated
+            by gapic or if additional functionality was built on top of
+            a gapic client library.
+        user_agent (Optional[str]): Prefix to the user agent header. This is
+            used to supply information such as application name or partner tool.
+            Recommended format: ``application-or-tool-ID/major.minor.version``.
+    """
+
+    def to_grpc_metadata(self):
+        """Returns the gRPC metadata for this client info."""
+        return (METRICS_METADATA_KEY, self.to_user_agent())
+
+
+DEFAULT_CLIENT_INFO = ClientInfo()
diff --git a/api_core/google/api_core/gapic_v1/config.py b/api_core/google/api_core/gapic_v1/config.py
new file mode 100644
index 000000000000..3a3eb15fdd44
--- /dev/null
+++ b/api_core/google/api_core/gapic_v1/config.py
@@ -0,0 +1,167 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for loading gapic configuration data.
+
+The Google API generator creates supplementary configuration for each RPC
+method to tell the client library how to deal with retries and timeouts.
+"""
+
+import collections
+
+import grpc
+import six
+
+from google.api_core import exceptions
+from google.api_core import retry
+from google.api_core import timeout
+
+
+_MILLIS_PER_SECOND = 1000.0
+
+
+def _exception_class_for_grpc_status_name(name):
+    """Returns the Google API exception class for a gRPC error code name.
+
+    Args:
+        name (str): The name of the gRPC status code, for example,
+            ``UNAVAILABLE``.
+
+    Returns:
+        :func:`type`: The appropriate subclass of
+            :class:`google.api_core.exceptions.GoogleAPICallError`.
+    """
+    return exceptions.exception_class_for_grpc_status(getattr(grpc.StatusCode, name))
+
+
+def _retry_from_retry_config(retry_params, retry_codes):
+    """Creates a Retry object given a gapic retry configuration.
+
+    Args:
+        retry_params (dict): The retry parameter values, for example::
+
+            {
+                "initial_retry_delay_millis": 1000,
+                "retry_delay_multiplier": 2.5,
+                "max_retry_delay_millis": 120000,
+                "initial_rpc_timeout_millis": 120000,
+                "rpc_timeout_multiplier": 1.0,
+                "max_rpc_timeout_millis": 120000,
+                "total_timeout_millis": 600000
+            }
+
+        retry_codes (sequence[str]): The list of retryable gRPC error code
+            names.
+
+    Returns:
+        google.api_core.retry.Retry: The default retry object for the method.
+    """
+    exception_classes = [
+        _exception_class_for_grpc_status_name(code) for code in retry_codes
+    ]
+    return retry.Retry(
+        retry.if_exception_type(*exception_classes),
+        initial=(retry_params["initial_retry_delay_millis"] / _MILLIS_PER_SECOND),
+        maximum=(retry_params["max_retry_delay_millis"] / _MILLIS_PER_SECOND),
+        multiplier=retry_params["retry_delay_multiplier"],
+        deadline=retry_params["total_timeout_millis"] / _MILLIS_PER_SECOND,
+    )
+
+
+def _timeout_from_retry_config(retry_params):
+    """Creates a ExponentialTimeout object given a gapic retry configuration.
+
+    Args:
+        retry_params (dict): The retry parameter values, for example::
+
+            {
+                "initial_retry_delay_millis": 1000,
+                "retry_delay_multiplier": 2.5,
+                "max_retry_delay_millis": 120000,
+                "initial_rpc_timeout_millis": 120000,
+                "rpc_timeout_multiplier": 1.0,
+                "max_rpc_timeout_millis": 120000,
+                "total_timeout_millis": 600000
+            }
+
+    Returns:
+        google.api_core.retry.ExponentialTimeout: The default time object for
+            the method.
+    """
+    return timeout.ExponentialTimeout(
+        initial=(retry_params["initial_rpc_timeout_millis"] / _MILLIS_PER_SECOND),
+        maximum=(retry_params["max_rpc_timeout_millis"] / _MILLIS_PER_SECOND),
+        multiplier=retry_params["rpc_timeout_multiplier"],
+        deadline=(retry_params["total_timeout_millis"] / _MILLIS_PER_SECOND),
+    )
+
+
+MethodConfig = collections.namedtuple("MethodConfig", ["retry", "timeout"])
+
+
+def parse_method_configs(interface_config):
+    """Creates default retry and timeout objects for each method in a gapic
+    interface config.
+
+    Args:
+        interface_config (Mapping): The interface config section of the full
+            gapic library config. For example, If the full configuration has
+            an interface named ``google.example.v1.ExampleService`` you would
+            pass in just that interface's configuration, for example
+            ``gapic_config['interfaces']['google.example.v1.ExampleService']``.
+
+    Returns:
+        Mapping[str, MethodConfig]: A mapping of RPC method names to their
+            configuration.
+    """
+    # Grab all the retry codes
+    retry_codes_map = {
+        name: retry_codes
+        for name, retry_codes in six.iteritems(interface_config.get("retry_codes", {}))
+    }
+
+    # Grab all of the retry params
+    retry_params_map = {
+        name: retry_params
+        for name, retry_params in six.iteritems(
+            interface_config.get("retry_params", {})
+        )
+    }
+
+    # Iterate through all the API methods and create a flat MethodConfig
+    # instance for each one.
+    method_configs = {}
+
+    for method_name, method_params in six.iteritems(
+        interface_config.get("methods", {})
+    ):
+        retry_params_name = method_params.get("retry_params_name")
+
+        if retry_params_name is not None:
+            retry_params = retry_params_map[retry_params_name]
+            retry_ = _retry_from_retry_config(
+                retry_params, retry_codes_map[method_params["retry_codes_name"]]
+            )
+            timeout_ = _timeout_from_retry_config(retry_params)
+
+        # No retry config, so this is a non-retryable method.
+        else:
+            retry_ = None
+            timeout_ = timeout.ConstantTimeout(
+                method_params["timeout_millis"] / _MILLIS_PER_SECOND
+            )
+
+        method_configs[method_name] = MethodConfig(retry=retry_, timeout=timeout_)
+
+    return method_configs
diff --git a/api_core/google/api_core/gapic_v1/method.py b/api_core/google/api_core/gapic_v1/method.py
new file mode 100644
index 000000000000..49982c0306cb
--- /dev/null
+++ b/api_core/google/api_core/gapic_v1/method.py
@@ -0,0 +1,242 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for wrapping low-level gRPC methods with common functionality.
+
+This is used by gapic clients to provide common error mapping, retry, timeout,
+pagination, and long-running operations to gRPC methods.
+"""
+
+from google.api_core import general_helpers
+from google.api_core import grpc_helpers
+from google.api_core import timeout
+from google.api_core.gapic_v1 import client_info
+
+USE_DEFAULT_METADATA = object()
+DEFAULT = object()
+"""Sentinel value indicating that a retry or timeout argument was unspecified,
+so the default should be used."""
+
+
+def _is_not_none_or_false(value):
+    return value is not None and value is not False
+
+
+def _apply_decorators(func, decorators):
+    """Apply a list of decorators to a given function.
+
+    ``decorators`` may contain items that are ``None`` or ``False`` which will
+    be ignored.
+    """
+    decorators = filter(_is_not_none_or_false, reversed(decorators))
+
+    for decorator in decorators:
+        func = decorator(func)
+
+    return func
+
+
+def _determine_timeout(default_timeout, specified_timeout, retry):
+    """Determines how timeout should be applied to a wrapped method.
+
+    Args:
+        default_timeout (Optional[Timeout]): The default timeout specified
+            at method creation time.
+        specified_timeout (Optional[Timeout]): The timeout specified at
+            invocation time. If :attr:`DEFAULT`, this will be set to
+            the ``default_timeout``.
+        retry (Optional[Retry]): The retry specified at invocation time.
+
+    Returns:
+        Optional[Timeout]: The timeout to apply to the method or ``None``.
+    """
+    if specified_timeout is DEFAULT:
+        specified_timeout = default_timeout
+
+    if specified_timeout is default_timeout:
+        # If timeout is the default and the default timeout is exponential and
+        # a non-default retry is specified, make sure the timeout's deadline
+        # matches the retry's. This handles the case where the user leaves
+        # the timeout default but specifies a lower deadline via the retry.
+        if (
+            retry
+            and retry is not DEFAULT
+            and isinstance(default_timeout, timeout.ExponentialTimeout)
+        ):
+            return default_timeout.with_deadline(retry._deadline)
+        else:
+            return default_timeout
+
+    # If timeout is specified as a number instead of a Timeout instance,
+    # convert it to a ConstantTimeout.
+    if isinstance(specified_timeout, (int, float)):
+        return timeout.ConstantTimeout(specified_timeout)
+    else:
+        return specified_timeout
+
+
+class _GapicCallable(object):
+    """Callable that applies retry, timeout, and metadata logic.
+
+    Args:
+        target (Callable): The low-level RPC method.
+        retry (google.api_core.retry.Retry): The default retry for the
+            callable. If ``None``, this callable will not retry by default
+        timeout (google.api_core.timeout.Timeout): The default timeout
+            for the callable. If ``None``, this callable will not specify
+            a timeout argument to the low-level RPC method by default.
+        metadata (Sequence[Tuple[str, str]]): Additional metadata that is
+            provided to the RPC method on every invocation. This is merged with
+            any metadata specified during invocation. If ``None``, no
+            additional metadata will be passed to the RPC method.
+    """
+
+    def __init__(self, target, retry, timeout, metadata=None):
+        self._target = target
+        self._retry = retry
+        self._timeout = timeout
+        self._metadata = metadata
+
+    def __call__(self, *args, **kwargs):
+        """Invoke the low-level RPC with retry, timeout, and metadata."""
+        # Note: Due to Python 2 lacking keyword-only arguments we use kwargs to
+        # extract the retry and timeout params.
+        timeout_ = _determine_timeout(
+            self._timeout,
+            kwargs.pop("timeout", self._timeout),
+            # Use only the invocation-specified retry only for this, as we only
+            # want to adjust the timeout deadline if the *user* specified
+            # a different retry.
+            kwargs.get("retry", None),
+        )
+
+        retry = kwargs.pop("retry", self._retry)
+
+        if retry is DEFAULT:
+            retry = self._retry
+
+        # Apply all applicable decorators.
+        wrapped_func = _apply_decorators(self._target, [retry, timeout_])
+
+        # Add the user agent metadata to the call.
+        if self._metadata is not None:
+            metadata = kwargs.get("metadata", [])
+            # Due to the nature of invocation, None should be treated the same
+            # as not specified.
+            if metadata is None:
+                metadata = []
+            metadata = list(metadata)
+            metadata.extend(self._metadata)
+            kwargs["metadata"] = metadata
+
+        return wrapped_func(*args, **kwargs)
+
+
+def wrap_method(
+    func,
+    default_retry=None,
+    default_timeout=None,
+    client_info=client_info.DEFAULT_CLIENT_INFO,
+):
+    """Wrap an RPC method with common behavior.
+
+    This applies common error wrapping, retry, and timeout behavior a function.
+    The wrapped function will take optional ``retry`` and ``timeout``
+    arguments.
+
+    For example::
+
+        import google.api_core.gapic_v1.method
+        from google.api_core import retry
+        from google.api_core import timeout
+
+        # The original RPC method.
+        def get_topic(name, timeout=None):
+            request = publisher_v2.GetTopicRequest(name=name)
+            return publisher_stub.GetTopic(request, timeout=timeout)
+
+        default_retry = retry.Retry(deadline=60)
+        default_timeout = timeout.Timeout(deadline=60)
+        wrapped_get_topic = google.api_core.gapic_v1.method.wrap_method(
+            get_topic, default_retry)
+
+        # Execute get_topic with default retry and timeout:
+        response = wrapped_get_topic()
+
+        # Execute get_topic without doing any retying but with the default
+        # timeout:
+        response = wrapped_get_topic(retry=None)
+
+        # Execute get_topic but only retry on 5xx errors:
+        my_retry = retry.Retry(retry.if_exception_type(
+            exceptions.InternalServerError))
+        response = wrapped_get_topic(retry=my_retry)
+
+    The way this works is by late-wrapping the given function with the retry
+    and timeout decorators. Essentially, when ``wrapped_get_topic()`` is
+    called:
+
+    * ``get_topic()`` is first wrapped with the ``timeout`` into
+      ``get_topic_with_timeout``.
+    * ``get_topic_with_timeout`` is wrapped with the ``retry`` into
+      ``get_topic_with_timeout_and_retry()``.
+    * The final ``get_topic_with_timeout_and_retry`` is called passing through
+      the ``args``  and ``kwargs``.
+
+    The callstack is therefore::
+
+        method.__call__() ->
+            Retry.__call__() ->
+                Timeout.__call__() ->
+                    wrap_errors() ->
+                        get_topic()
+
+    Note that if ``timeout`` or ``retry`` is ``None``, then they are not
+    applied to the function. For example,
+    ``wrapped_get_topic(timeout=None, retry=None)`` is more or less
+    equivalent to just calling ``get_topic`` but with error re-mapping.
+
+    Args:
+        func (Callable[Any]): The function to wrap. It should accept an
+            optional ``timeout`` argument. If ``metadata`` is not ``None``, it
+            should accept a ``metadata`` argument.
+        default_retry (Optional[google.api_core.Retry]): The default retry
+            strategy. If ``None``, the method will not retry by default.
+        default_timeout (Optional[google.api_core.Timeout]): The default
+            timeout strategy. Can also be specified as an int or float. If
+            ``None``, the method will not have timeout specified by default.
+        client_info
+            (Optional[google.api_core.gapic_v1.client_info.ClientInfo]):
+                Client information used to create a user-agent string that's
+                passed as gRPC metadata to the method. If unspecified, then
+                a sane default will be used. If ``None``, then no user agent
+                metadata will be provided to the RPC method.
+
+    Returns:
+        Callable: A new callable that takes optional ``retry`` and ``timeout``
+            arguments and applies the common error mapping, retry, timeout,
+            and metadata behavior to the low-level RPC method.
+    """
+    func = grpc_helpers.wrap_errors(func)
+
+    if client_info is not None:
+        user_agent_metadata = [client_info.to_grpc_metadata()]
+    else:
+        user_agent_metadata = None
+
+    return general_helpers.wraps(func)(
+        _GapicCallable(
+            func, default_retry, default_timeout, metadata=user_agent_metadata
+        )
+    )
diff --git a/api_core/google/api_core/gapic_v1/routing_header.py b/api_core/google/api_core/gapic_v1/routing_header.py
new file mode 100644
index 000000000000..3fb12a6f8e26
--- /dev/null
+++ b/api_core/google/api_core/gapic_v1/routing_header.py
@@ -0,0 +1,62 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for constructing routing headers.
+
+These headers are used by Google infrastructure to determine how to route
+requests, especially for services that are regional.
+
+Generally, these headers are specified as gRPC metadata.
+"""
+
+import sys
+
+from six.moves.urllib.parse import urlencode
+
+ROUTING_METADATA_KEY = "x-goog-request-params"
+
+
+def to_routing_header(params):
+    """Returns a routing header string for the given request parameters.
+
+    Args:
+        params (Mapping[str, Any]): A dictionary containing the request
+            parameters used for routing.
+
+    Returns:
+        str: The routing header string.
+    """
+    if sys.version_info[0] < 3:
+        # Python 2 does not have the "safe" parameter for urlencode.
+        return urlencode(params).replace("%2F", "/")
+    return urlencode(
+        params,
+        # Per Google API policy (go/api-url-encoding), / is not encoded.
+        safe="/",
+    )
+
+
+def to_grpc_metadata(params):
+    """Returns the gRPC metadata containing the routing headers for the given
+    request parameters.
+
+    Args:
+        params (Mapping[str, Any]): A dictionary containing the request
+            parameters used for routing.
+
+    Returns:
+        Tuple(str, str): The gRPC metadata containing the routing header key
+            and value.
+    """
+    return (ROUTING_METADATA_KEY, to_routing_header(params))
diff --git a/api_core/google/api_core/general_helpers.py b/api_core/google/api_core/general_helpers.py
new file mode 100644
index 000000000000..d2d0c4402311
--- /dev/null
+++ b/api_core/google/api_core/general_helpers.py
@@ -0,0 +1,33 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for general Python functionality."""
+
+import functools
+
+import six
+
+
+# functools.partial objects lack several attributes present on real function
+# objects. In Python 2 wraps fails on this so use a restricted set instead.
+_PARTIAL_VALID_ASSIGNMENTS = ("__doc__",)
+
+
+def wraps(wrapped):
+    """A functools.wraps helper that handles partial objects on Python 2."""
+    # https://github.com/google/pytype/issues/322
+    if isinstance(wrapped, functools.partial):  # pytype: disable=wrong-arg-types
+        return six.wraps(wrapped, assigned=_PARTIAL_VALID_ASSIGNMENTS)
+    else:
+        return six.wraps(wrapped)
diff --git a/api_core/google/api_core/grpc_helpers.py b/api_core/google/api_core/grpc_helpers.py
new file mode 100644
index 000000000000..4d63beb36910
--- /dev/null
+++ b/api_core/google/api_core/grpc_helpers.py
@@ -0,0 +1,384 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for :mod:`grpc`."""
+
+import collections
+
+import grpc
+import six
+
+from google.api_core import exceptions
+from google.api_core import general_helpers
+import google.auth
+import google.auth.credentials
+import google.auth.transport.grpc
+import google.auth.transport.requests
+
+try:
+    import grpc_gcp
+
+    HAS_GRPC_GCP = True
+except ImportError:
+    HAS_GRPC_GCP = False
+
+# The list of gRPC Callable interfaces that return iterators.
+_STREAM_WRAP_CLASSES = (grpc.UnaryStreamMultiCallable, grpc.StreamStreamMultiCallable)
+
+
+def _patch_callable_name(callable_):
+    """Fix-up gRPC callable attributes.
+
+    gRPC callable lack the ``__name__`` attribute which causes
+    :func:`functools.wraps` to error. This adds the attribute if needed.
+    """
+    if not hasattr(callable_, "__name__"):
+        callable_.__name__ = callable_.__class__.__name__
+
+
+def _wrap_unary_errors(callable_):
+    """Map errors for Unary-Unary and Stream-Unary gRPC callables."""
+    _patch_callable_name(callable_)
+
+    @six.wraps(callable_)
+    def error_remapped_callable(*args, **kwargs):
+        try:
+            return callable_(*args, **kwargs)
+        except grpc.RpcError as exc:
+            six.raise_from(exceptions.from_grpc_error(exc), exc)
+
+    return error_remapped_callable
+
+
+class _StreamingResponseIterator(grpc.Call):
+    def __init__(self, wrapped):
+        self._wrapped = wrapped
+
+    def __iter__(self):
+        """This iterator is also an iterable that returns itself."""
+        return self
+
+    def next(self):
+        """Get the next response from the stream.
+
+        Returns:
+            protobuf.Message: A single response from the stream.
+        """
+        try:
+            return six.next(self._wrapped)
+        except grpc.RpcError as exc:
+            six.raise_from(exceptions.from_grpc_error(exc), exc)
+
+    # Alias needed for Python 2/3 support.
+    __next__ = next
+
+    # grpc.Call & grpc.RpcContext interface
+
+    def add_callback(self, callback):
+        return self._wrapped.add_callback(callback)
+
+    def cancel(self):
+        return self._wrapped.cancel()
+
+    def code(self):
+        return self._wrapped.code()
+
+    def details(self):
+        return self._wrapped.details()
+
+    def initial_metadata(self):
+        return self._wrapped.initial_metadata()
+
+    def is_active(self):
+        return self._wrapped.is_active()
+
+    def time_remaining(self):
+        return self._wrapped.time_remaining()
+
+    def trailing_metadata(self):
+        return self._wrapped.trailing_metadata()
+
+
+def _wrap_stream_errors(callable_):
+    """Wrap errors for Unary-Stream and Stream-Stream gRPC callables.
+
+    The callables that return iterators require a bit more logic to re-map
+    errors when iterating. This wraps both the initial invocation and the
+    iterator of the return value to re-map errors.
+    """
+    _patch_callable_name(callable_)
+
+    @general_helpers.wraps(callable_)
+    def error_remapped_callable(*args, **kwargs):
+        try:
+            result = callable_(*args, **kwargs)
+            return _StreamingResponseIterator(result)
+        except grpc.RpcError as exc:
+            six.raise_from(exceptions.from_grpc_error(exc), exc)
+
+    return error_remapped_callable
+
+
+def wrap_errors(callable_):
+    """Wrap a gRPC callable and map :class:`grpc.RpcErrors` to friendly error
+    classes.
+
+    Errors raised by the gRPC callable are mapped to the appropriate
+    :class:`google.api_core.exceptions.GoogleAPICallError` subclasses.
+    The original `grpc.RpcError` (which is usually also a `grpc.Call`) is
+    available from the ``response`` property on the mapped exception. This
+    is useful for extracting metadata from the original error.
+
+    Args:
+        callable_ (Callable): A gRPC callable.
+
+    Returns:
+        Callable: The wrapped gRPC callable.
+    """
+    if isinstance(callable_, _STREAM_WRAP_CLASSES):
+        return _wrap_stream_errors(callable_)
+    else:
+        return _wrap_unary_errors(callable_)
+
+
+def create_channel(
+    target, credentials=None, scopes=None, ssl_credentials=None, **kwargs
+):
+    """Create a secure channel with credentials.
+
+    Args:
+        target (str): The target service address in the format 'hostname:port'.
+        credentials (google.auth.credentials.Credentials): The credentials. If
+            not specified, then this function will attempt to ascertain the
+            credentials from the environment using :func:`google.auth.default`.
+        scopes (Sequence[str]): A optional list of scopes needed for this
+            service. These are only used when credentials are not specified and
+            are passed to :func:`google.auth.default`.
+        ssl_credentials (grpc.ChannelCredentials): Optional SSL channel
+            credentials. This can be used to specify different certificates.
+        kwargs: Additional key-word args passed to
+            :func:`grpc_gcp.secure_channel` or :func:`grpc.secure_channel`.
+
+    Returns:
+        grpc.Channel: The created channel.
+    """
+    if credentials is None:
+        credentials, _ = google.auth.default(scopes=scopes)
+    else:
+        credentials = google.auth.credentials.with_scopes_if_required(
+            credentials, scopes
+        )
+
+    request = google.auth.transport.requests.Request()
+
+    # Create the metadata plugin for inserting the authorization header.
+    metadata_plugin = google.auth.transport.grpc.AuthMetadataPlugin(
+        credentials, request
+    )
+
+    # Create a set of grpc.CallCredentials using the metadata plugin.
+    google_auth_credentials = grpc.metadata_call_credentials(metadata_plugin)
+
+    if ssl_credentials is None:
+        ssl_credentials = grpc.ssl_channel_credentials()
+
+    # Combine the ssl credentials and the authorization credentials.
+    composite_credentials = grpc.composite_channel_credentials(
+        ssl_credentials, google_auth_credentials
+    )
+
+    if HAS_GRPC_GCP:
+        # If grpc_gcp module is available use grpc_gcp.secure_channel,
+        # otherwise, use grpc.secure_channel to create grpc channel.
+        return grpc_gcp.secure_channel(target, composite_credentials, **kwargs)
+    else:
+        return grpc.secure_channel(target, composite_credentials, **kwargs)
+
+
+_MethodCall = collections.namedtuple(
+    "_MethodCall", ("request", "timeout", "metadata", "credentials")
+)
+
+_ChannelRequest = collections.namedtuple("_ChannelRequest", ("method", "request"))
+
+
+class _CallableStub(object):
+    """Stub for the grpc.*MultiCallable interfaces."""
+
+    def __init__(self, method, channel):
+        self._method = method
+        self._channel = channel
+        self.response = None
+        """Union[protobuf.Message, Callable[protobuf.Message], exception]:
+        The response to give when invoking this callable. If this is a
+        callable, it will be invoked with the request protobuf. If it's an
+        exception, the exception will be raised when this is invoked.
+        """
+        self.responses = None
+        """Iterator[
+            Union[protobuf.Message, Callable[protobuf.Message], exception]]:
+        An iterator of responses. If specified, self.response will be populated
+        on each invocation by calling ``next(self.responses)``."""
+        self.requests = []
+        """List[protobuf.Message]: All requests sent to this callable."""
+        self.calls = []
+        """List[Tuple]: All invocations of this callable. Each tuple is the
+        request, timeout, metadata, and credentials."""
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self._channel.requests.append(_ChannelRequest(self._method, request))
+        self.calls.append(_MethodCall(request, timeout, metadata, credentials))
+        self.requests.append(request)
+
+        response = self.response
+        if self.responses is not None:
+            if response is None:
+                response = next(self.responses)
+            else:
+                raise ValueError(
+                    "{method}.response and {method}.responses are mutually "
+                    "exclusive.".format(method=self._method)
+                )
+
+        if callable(response):
+            return response(request)
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response is not None:
+            return response
+
+        raise ValueError('Method stub for "{}" has no response.'.format(self._method))
+
+
+def _simplify_method_name(method):
+    """Simplifies a gRPC method name.
+
+    When gRPC invokes the channel to create a callable, it gives a full
+    method name like "/google.pubsub.v1.Publisher/CreateTopic". This
+    returns just the name of the method, in this case "CreateTopic".
+
+    Args:
+        method (str): The name of the method.
+
+    Returns:
+        str: The simplified name of the method.
+    """
+    return method.rsplit("/", 1).pop()
+
+
+class ChannelStub(grpc.Channel):
+    """A testing stub for the grpc.Channel interface.
+
+    This can be used to test any client that eventually uses a gRPC channel
+    to communicate. By passing in a channel stub, you can configure which
+    responses are returned and track which requests are made.
+
+    For example:
+
+    .. code-block:: python
+
+        channel_stub = grpc_helpers.ChannelStub()
+        client = FooClient(channel=channel_stub)
+
+        channel_stub.GetFoo.response = foo_pb2.Foo(name='bar')
+
+        foo = client.get_foo(labels=['baz'])
+
+        assert foo.name == 'bar'
+        assert channel_stub.GetFoo.requests[0].labels = ['baz']
+
+    Each method on the stub can be accessed and configured on the channel.
+    Here's some examples of various configurations:
+
+    .. code-block:: python
+
+        # Return a basic response:
+
+        channel_stub.GetFoo.response = foo_pb2.Foo(name='bar')
+        assert client.get_foo().name == 'bar'
+
+        # Raise an exception:
+        channel_stub.GetFoo.response = NotFound('...')
+
+        with pytest.raises(NotFound):
+            client.get_foo()
+
+        # Use a sequence of responses:
+        channel_stub.GetFoo.responses = iter([
+            foo_pb2.Foo(name='bar'),
+            foo_pb2.Foo(name='baz'),
+        ])
+
+        assert client.get_foo().name == 'bar'
+        assert client.get_foo().name == 'baz'
+
+        # Use a callable
+
+        def on_get_foo(request):
+            return foo_pb2.Foo(name='bar' + request.id)
+
+        channel_stub.GetFoo.response = on_get_foo
+
+        assert client.get_foo(id='123').name == 'bar123'
+    """
+
+    def __init__(self, responses=[]):
+        self.requests = []
+        """Sequence[Tuple[str, protobuf.Message]]: A list of all requests made
+        on this channel in order. The tuple is of method name, request
+        message."""
+        self._method_stubs = {}
+
+    def _stub_for_method(self, method):
+        method = _simplify_method_name(method)
+        self._method_stubs[method] = _CallableStub(method, self)
+        return self._method_stubs[method]
+
+    def __getattr__(self, key):
+        try:
+            return self._method_stubs[key]
+        except KeyError:
+            raise AttributeError
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        """grpc.Channel.unary_unary implementation."""
+        return self._stub_for_method(method)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        """grpc.Channel.unary_stream implementation."""
+        return self._stub_for_method(method)
+
+    def stream_unary(self, method, request_serializer=None, response_deserializer=None):
+        """grpc.Channel.stream_unary implementation."""
+        return self._stub_for_method(method)
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        """grpc.Channel.stream_stream implementation."""
+        return self._stub_for_method(method)
+
+    def subscribe(self, callback, try_to_connect=False):
+        """grpc.Channel.subscribe implementation."""
+        pass
+
+    def unsubscribe(self, callback):
+        """grpc.Channel.unsubscribe implementation."""
+        pass
+
+    def close(self):
+        """grpc.Channel.close implementation."""
+        pass
diff --git a/api_core/google/api_core/iam.py b/api_core/google/api_core/iam.py
new file mode 100644
index 000000000000..0e108a30679a
--- /dev/null
+++ b/api_core/google/api_core/iam.py
@@ -0,0 +1,273 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Non-API-specific IAM policy definitions
+
+For allowed roles / permissions, see:
+https://cloud.google.com/iam/docs/understanding-roles
+
+Example usage:
+
+.. code-block:: python
+
+   # ``get_iam_policy`` returns a :class:'~google.api_core.iam.Policy`.
+   policy = resource.get_iam_policy()
+
+   phred = policy.user("phred@example.com")
+   admin_group = policy.group("admins@groups.example.com")
+   account = policy.service_account("account-1234@accounts.example.com")
+   policy["roles/owner"] = [phred, admin_group, account]
+   policy["roles/editor"] = policy.authenticated_users()
+   policy["roles/viewer"] = policy.all_users()
+
+   resource.set_iam_policy(policy)
+"""
+
+import collections
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+import warnings
+
+# Generic IAM roles
+
+OWNER_ROLE = "roles/owner"
+"""Generic role implying all rights to an object."""
+
+EDITOR_ROLE = "roles/editor"
+"""Generic role implying rights to modify an object."""
+
+VIEWER_ROLE = "roles/viewer"
+"""Generic role implying rights to access an object."""
+
+_ASSIGNMENT_DEPRECATED_MSG = """\
+Assigning to '{}' is deprecated.  Replace with 'policy[{}] = members."""
+
+
+class Policy(collections_abc.MutableMapping):
+    """IAM Policy
+
+    See
+    https://cloud.google.com/iam/reference/rest/v1/Policy
+
+    Args:
+        etag (Optional[str]): ETag used to identify a unique of the policy
+        version (Optional[int]): unique version of the policy
+    """
+
+    _OWNER_ROLES = (OWNER_ROLE,)
+    """Roles mapped onto our ``owners`` attribute."""
+
+    _EDITOR_ROLES = (EDITOR_ROLE,)
+    """Roles mapped onto our ``editors`` attribute."""
+
+    _VIEWER_ROLES = (VIEWER_ROLE,)
+    """Roles mapped onto our ``viewers`` attribute."""
+
+    def __init__(self, etag=None, version=None):
+        self.etag = etag
+        self.version = version
+        self._bindings = collections.defaultdict(set)
+
+    def __iter__(self):
+        return iter(self._bindings)
+
+    def __len__(self):
+        return len(self._bindings)
+
+    def __getitem__(self, key):
+        return self._bindings[key]
+
+    def __setitem__(self, key, value):
+        self._bindings[key] = set(value)
+
+    def __delitem__(self, key):
+        del self._bindings[key]
+
+    @property
+    def owners(self):
+        """Legacy access to owner role.
+
+        DEPRECATED:  use ``policy["roles/owners"]`` instead."""
+        result = set()
+        for role in self._OWNER_ROLES:
+            for member in self._bindings.get(role, ()):
+                result.add(member)
+        return frozenset(result)
+
+    @owners.setter
+    def owners(self, value):
+        """Update owners.
+
+        DEPRECATED:  use ``policy["roles/owners"] = value`` instead."""
+        warnings.warn(
+            _ASSIGNMENT_DEPRECATED_MSG.format("owners", OWNER_ROLE), DeprecationWarning
+        )
+        self[OWNER_ROLE] = value
+
+    @property
+    def editors(self):
+        """Legacy access to editor role.
+
+        DEPRECATED:  use ``policy["roles/editors"]`` instead."""
+        result = set()
+        for role in self._EDITOR_ROLES:
+            for member in self._bindings.get(role, ()):
+                result.add(member)
+        return frozenset(result)
+
+    @editors.setter
+    def editors(self, value):
+        """Update editors.
+
+        DEPRECATED:  use ``policy["roles/editors"] = value`` instead."""
+        warnings.warn(
+            _ASSIGNMENT_DEPRECATED_MSG.format("editors", EDITOR_ROLE),
+            DeprecationWarning,
+        )
+        self[EDITOR_ROLE] = value
+
+    @property
+    def viewers(self):
+        """Legacy access to viewer role.
+
+        DEPRECATED:  use ``policy["roles/viewers"]`` instead
+        """
+        result = set()
+        for role in self._VIEWER_ROLES:
+            for member in self._bindings.get(role, ()):
+                result.add(member)
+        return frozenset(result)
+
+    @viewers.setter
+    def viewers(self, value):
+        """Update viewers.
+
+        DEPRECATED:  use ``policy["roles/viewers"] = value`` instead.
+        """
+        warnings.warn(
+            _ASSIGNMENT_DEPRECATED_MSG.format("viewers", VIEWER_ROLE),
+            DeprecationWarning,
+        )
+        self[VIEWER_ROLE] = value
+
+    @staticmethod
+    def user(email):
+        """Factory method for a user member.
+
+        Args:
+            email (str): E-mail for this particular user.
+
+        Returns:
+            str: A member string corresponding to the given user.
+        """
+        return "user:%s" % (email,)
+
+    @staticmethod
+    def service_account(email):
+        """Factory method for a service account member.
+
+        Args:
+            email (str): E-mail for this particular service account.
+
+        Returns:
+            str: A member string corresponding to the given service account.
+        """
+        return "serviceAccount:%s" % (email,)
+
+    @staticmethod
+    def group(email):
+        """Factory method for a group member.
+
+        Args:
+            email (str): An id or e-mail for this particular group.
+
+        Returns:
+            str: A member string corresponding to the given group.
+        """
+        return "group:%s" % (email,)
+
+    @staticmethod
+    def domain(domain):
+        """Factory method for a domain member.
+
+        Args:
+            domain (str): The domain for this member.
+
+        Returns:
+            str: A member string corresponding to the given domain.
+        """
+        return "domain:%s" % (domain,)
+
+    @staticmethod
+    def all_users():
+        """Factory method for a member representing all users.
+
+        Returns:
+            str: A member string representing all users.
+        """
+        return "allUsers"
+
+    @staticmethod
+    def authenticated_users():
+        """Factory method for a member representing all authenticated users.
+
+        Returns:
+            str: A member string representing all authenticated users.
+        """
+        return "allAuthenticatedUsers"
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: create a policy from a JSON resource.
+
+        Args:
+            resource (dict): policy resource returned by ``getIamPolicy`` API.
+
+        Returns:
+            :class:`Policy`: the parsed policy
+        """
+        version = resource.get("version")
+        etag = resource.get("etag")
+        policy = cls(etag, version)
+        for binding in resource.get("bindings", ()):
+            role = binding["role"]
+            members = sorted(binding["members"])
+            policy[role] = members
+        return policy
+
+    def to_api_repr(self):
+        """Render a JSON policy resource.
+
+        Returns:
+            dict: a resource to be passed to the ``setIamPolicy`` API.
+        """
+        resource = {}
+
+        if self.etag is not None:
+            resource["etag"] = self.etag
+
+        if self.version is not None:
+            resource["version"] = self.version
+
+        if self._bindings:
+            bindings = resource["bindings"] = []
+            for role, members in sorted(self._bindings.items()):
+                if members:
+                    bindings.append({"role": role, "members": sorted(set(members))})
+
+            if not bindings:
+                del resource["bindings"]
+
+        return resource
diff --git a/api_core/google/api_core/operation.py b/api_core/google/api_core/operation.py
new file mode 100644
index 000000000000..87f42a973e1b
--- /dev/null
+++ b/api_core/google/api_core/operation.py
@@ -0,0 +1,320 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Futures for long-running operations returned from Google Cloud APIs.
+
+These futures can be used to synchronously wait for the result of a
+long-running operation using :meth:`Operation.result`:
+
+
+.. code-block:: python
+
+    operation = my_api_client.long_running_method()
+    result = operation.result()
+
+Or asynchronously using callbacks and :meth:`Operation.add_done_callback`:
+
+.. code-block:: python
+
+    operation = my_api_client.long_running_method()
+
+    def my_callback(future):
+        result = future.result()
+
+    operation.add_done_callback(my_callback)
+
+"""
+
+import functools
+import threading
+
+from google.api_core import exceptions
+from google.api_core import protobuf_helpers
+from google.api_core.future import polling
+from google.longrunning import operations_pb2
+from google.protobuf import json_format
+from google.rpc import code_pb2
+
+
+class Operation(polling.PollingFuture):
+    """A Future for interacting with a Google API Long-Running Operation.
+
+    Args:
+        operation (google.longrunning.operations_pb2.Operation): The
+            initial operation.
+        refresh (Callable[[], ~.api_core.operation.Operation]): A callable that
+            returns the latest state of the operation.
+        cancel (Callable[[], None]): A callable that tries to cancel
+            the operation.
+        result_type (func:`type`): The protobuf type for the operation's
+            result.
+        metadata_type (func:`type`): The protobuf type for the operation's
+            metadata.
+        retry (google.api_core.retry.Retry): The retry configuration used
+            when polling. This can be used to control how often :meth:`done`
+            is polled. Regardless of the retry's ``deadline``, it will be
+            overridden by the ``timeout`` argument to :meth:`result`.
+    """
+
+    def __init__(
+        self,
+        operation,
+        refresh,
+        cancel,
+        result_type,
+        metadata_type=None,
+        retry=polling.DEFAULT_RETRY,
+    ):
+        super(Operation, self).__init__(retry=retry)
+        self._operation = operation
+        self._refresh = refresh
+        self._cancel = cancel
+        self._result_type = result_type
+        self._metadata_type = metadata_type
+        self._completion_lock = threading.Lock()
+        # Invoke this in case the operation came back already complete.
+        self._set_result_from_operation()
+
+    @property
+    def operation(self):
+        """google.longrunning.Operation: The current long-running operation."""
+        return self._operation
+
+    @property
+    def metadata(self):
+        """google.protobuf.Message: the current operation metadata."""
+        if not self._operation.HasField("metadata"):
+            return None
+
+        return protobuf_helpers.from_any_pb(
+            self._metadata_type, self._operation.metadata
+        )
+
+    @classmethod
+    def deserialize(self, payload):
+        """Deserialize a ``google.longrunning.Operation`` protocol buffer.
+
+        Args:
+            payload (bytes): A serialized operation protocol buffer.
+
+        Returns:
+            ~.operations_pb2.Operation: An Operation protobuf object.
+        """
+        return operations_pb2.Operation.FromString(payload)
+
+    def _set_result_from_operation(self):
+        """Set the result or exception from the operation if it is complete."""
+        # This must be done in a lock to prevent the polling thread
+        # and main thread from both executing the completion logic
+        # at the same time.
+        with self._completion_lock:
+            # If the operation isn't complete or if the result has already been
+            # set, do not call set_result/set_exception again.
+            # Note: self._result_set is set to True in set_result and
+            # set_exception, in case those methods are invoked directly.
+            if not self._operation.done or self._result_set:
+                return
+
+            if self._operation.HasField("response"):
+                response = protobuf_helpers.from_any_pb(
+                    self._result_type, self._operation.response
+                )
+                self.set_result(response)
+            elif self._operation.HasField("error"):
+                exception = exceptions.GoogleAPICallError(
+                    self._operation.error.message,
+                    errors=(self._operation.error,),
+                    response=self._operation,
+                )
+                self.set_exception(exception)
+            else:
+                exception = exceptions.GoogleAPICallError(
+                    "Unexpected state: Long-running operation had neither "
+                    "response nor error set."
+                )
+                self.set_exception(exception)
+
+    def _refresh_and_update(self):
+        """Refresh the operation and update the result if needed."""
+        # If the currently cached operation is done, no need to make another
+        # RPC as it will not change once done.
+        if not self._operation.done:
+            self._operation = self._refresh()
+            self._set_result_from_operation()
+
+    def done(self):
+        """Checks to see if the operation is complete.
+
+        Returns:
+            bool: True if the operation is complete, False otherwise.
+        """
+        self._refresh_and_update()
+        return self._operation.done
+
+    def cancel(self):
+        """Attempt to cancel the operation.
+
+        Returns:
+            bool: True if the cancel RPC was made, False if the operation is
+                already complete.
+        """
+        if self.done():
+            return False
+
+        self._cancel()
+        return True
+
+    def cancelled(self):
+        """True if the operation was cancelled."""
+        self._refresh_and_update()
+        return (
+            self._operation.HasField("error")
+            and self._operation.error.code == code_pb2.CANCELLED
+        )
+
+
+def _refresh_http(api_request, operation_name):
+    """Refresh an operation using a JSON/HTTP client.
+
+    Args:
+        api_request (Callable): A callable used to make an API request. This
+            should generally be
+            :meth:`google.cloud._http.Connection.api_request`.
+        operation_name (str): The name of the operation.
+
+    Returns:
+        google.longrunning.operations_pb2.Operation: The operation.
+    """
+    path = "operations/{}".format(operation_name)
+    api_response = api_request(method="GET", path=path)
+    return json_format.ParseDict(api_response, operations_pb2.Operation())
+
+
+def _cancel_http(api_request, operation_name):
+    """Cancel an operation using a JSON/HTTP client.
+
+    Args:
+        api_request (Callable): A callable used to make an API request. This
+            should generally be
+            :meth:`google.cloud._http.Connection.api_request`.
+        operation_name (str): The name of the operation.
+    """
+    path = "operations/{}:cancel".format(operation_name)
+    api_request(method="POST", path=path)
+
+
+def from_http_json(operation, api_request, result_type, **kwargs):
+    """Create an operation future using a HTTP/JSON client.
+
+    This interacts with the long-running operations `service`_ (specific
+    to a given API) via `HTTP/JSON`_.
+
+    .. _HTTP/JSON: https://cloud.google.com/speech/reference/rest/\
+            v1beta1/operations#Operation
+
+    Args:
+        operation (dict): Operation as a dictionary.
+        api_request (Callable): A callable used to make an API request. This
+            should generally be
+            :meth:`google.cloud._http.Connection.api_request`.
+        result_type (:func:`type`): The protobuf result type.
+        kwargs: Keyword args passed into the :class:`Operation` constructor.
+
+    Returns:
+        ~.api_core.operation.Operation: The operation future to track the given
+            operation.
+    """
+    operation_proto = json_format.ParseDict(operation, operations_pb2.Operation())
+    refresh = functools.partial(_refresh_http, api_request, operation_proto.name)
+    cancel = functools.partial(_cancel_http, api_request, operation_proto.name)
+    return Operation(operation_proto, refresh, cancel, result_type, **kwargs)
+
+
+def _refresh_grpc(operations_stub, operation_name):
+    """Refresh an operation using a gRPC client.
+
+    Args:
+        operations_stub (google.longrunning.operations_pb2.OperationsStub):
+            The gRPC operations stub.
+        operation_name (str): The name of the operation.
+
+    Returns:
+        google.longrunning.operations_pb2.Operation: The operation.
+    """
+    request_pb = operations_pb2.GetOperationRequest(name=operation_name)
+    return operations_stub.GetOperation(request_pb)
+
+
+def _cancel_grpc(operations_stub, operation_name):
+    """Cancel an operation using a gRPC client.
+
+    Args:
+        operations_stub (google.longrunning.operations_pb2.OperationsStub):
+            The gRPC operations stub.
+        operation_name (str): The name of the operation.
+    """
+    request_pb = operations_pb2.CancelOperationRequest(name=operation_name)
+    operations_stub.CancelOperation(request_pb)
+
+
+def from_grpc(operation, operations_stub, result_type, **kwargs):
+    """Create an operation future using a gRPC client.
+
+    This interacts with the long-running operations `service`_ (specific
+    to a given API) via gRPC.
+
+    .. _service: https://github.com/googleapis/googleapis/blob/\
+                 050400df0fdb16f63b63e9dee53819044bffc857/\
+                 google/longrunning/operations.proto#L38
+
+    Args:
+        operation (google.longrunning.operations_pb2.Operation): The operation.
+        operations_stub (google.longrunning.operations_pb2.OperationsStub):
+            The operations stub.
+        result_type (:func:`type`): The protobuf result type.
+        kwargs: Keyword args passed into the :class:`Operation` constructor.
+
+    Returns:
+        ~.api_core.operation.Operation: The operation future to track the given
+            operation.
+    """
+    refresh = functools.partial(_refresh_grpc, operations_stub, operation.name)
+    cancel = functools.partial(_cancel_grpc, operations_stub, operation.name)
+    return Operation(operation, refresh, cancel, result_type, **kwargs)
+
+
+def from_gapic(operation, operations_client, result_type, **kwargs):
+    """Create an operation future from a gapic client.
+
+    This interacts with the long-running operations `service`_ (specific
+    to a given API) via a gapic client.
+
+    .. _service: https://github.com/googleapis/googleapis/blob/\
+                 050400df0fdb16f63b63e9dee53819044bffc857/\
+                 google/longrunning/operations.proto#L38
+
+    Args:
+        operation (google.longrunning.operations_pb2.Operation): The operation.
+        operations_client (google.api_core.operations_v1.OperationsClient):
+            The operations client.
+        result_type (:func:`type`): The protobuf result type.
+        kwargs: Keyword args passed into the :class:`Operation` constructor.
+
+    Returns:
+        ~.api_core.operation.Operation: The operation future to track the given
+            operation.
+    """
+    refresh = functools.partial(operations_client.get_operation, operation.name)
+    cancel = functools.partial(operations_client.cancel_operation, operation.name)
+    return Operation(operation, refresh, cancel, result_type, **kwargs)
diff --git a/api_core/google/api_core/operations_v1/__init__.py b/api_core/google/api_core/operations_v1/__init__.py
new file mode 100644
index 000000000000..f0549561b6ff
--- /dev/null
+++ b/api_core/google/api_core/operations_v1/__init__.py
@@ -0,0 +1,19 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Package for interacting with the google.longrunning.operations meta-API."""
+
+from google.api_core.operations_v1.operations_client import OperationsClient
+
+__all__ = ["OperationsClient"]
diff --git a/api_core/google/api_core/operations_v1/operations_client.py b/api_core/google/api_core/operations_v1/operations_client.py
new file mode 100644
index 000000000000..cd2923bb9d09
--- /dev/null
+++ b/api_core/google/api_core/operations_v1/operations_client.py
@@ -0,0 +1,288 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A client for the google.longrunning.operations meta-API.
+
+This is a client that deals with long-running operations that follow the
+pattern outlined by the `Google API Style Guide`_.
+
+When an API method normally takes long time to complete, it can be designed to
+return ``Operation`` to the client, and the client can use this interface to
+receive the real response asynchronously by polling the operation resource to
+receive the response.
+
+It is not a separate service, but rather an interface implemented by a larger
+service. The protocol-level definition is available at
+`google/longrunning/operations.proto`_. Typically, this will be constructed
+automatically by another client class to deal with operations.
+
+.. _Google API Style Guide:
+    https://cloud.google.com/apis/design/design_pattern
+    s#long_running_operations
+.. _google/longrunning/operations.proto:
+    https://github.com/googleapis/googleapis/blob/master/google/longrunning
+    /operations.proto
+"""
+
+import functools
+
+from google.api_core import gapic_v1
+from google.api_core import page_iterator
+from google.api_core.operations_v1 import operations_client_config
+from google.longrunning import operations_pb2
+
+
+class OperationsClient(object):
+    """Client for interacting with long-running operations within a service.
+
+    Args:
+        channel (grpc.Channel): The gRPC channel associated with the service
+            that implements the ``google.longrunning.operations`` interface.
+        client_config (dict):
+            A dictionary of call options for each method. If not specified
+            the default configuration is used.
+    """
+
+    def __init__(self, channel, client_config=operations_client_config.config):
+        # Create the gRPC client stub.
+        self.operations_stub = operations_pb2.OperationsStub(channel)
+
+        # Create all wrapped methods using the interface configuration.
+        # The interface config contains all of the default settings for retry
+        # and timeout for each RPC method.
+        interfaces = client_config["interfaces"]
+        interface_config = interfaces["google.longrunning.Operations"]
+        method_configs = gapic_v1.config.parse_method_configs(interface_config)
+
+        self._get_operation = gapic_v1.method.wrap_method(
+            self.operations_stub.GetOperation,
+            default_retry=method_configs["GetOperation"].retry,
+            default_timeout=method_configs["GetOperation"].timeout,
+        )
+
+        self._list_operations = gapic_v1.method.wrap_method(
+            self.operations_stub.ListOperations,
+            default_retry=method_configs["ListOperations"].retry,
+            default_timeout=method_configs["ListOperations"].timeout,
+        )
+
+        self._cancel_operation = gapic_v1.method.wrap_method(
+            self.operations_stub.CancelOperation,
+            default_retry=method_configs["CancelOperation"].retry,
+            default_timeout=method_configs["CancelOperation"].timeout,
+        )
+
+        self._delete_operation = gapic_v1.method.wrap_method(
+            self.operations_stub.DeleteOperation,
+            default_retry=method_configs["DeleteOperation"].retry,
+            default_timeout=method_configs["DeleteOperation"].timeout,
+        )
+
+    # Service calls
+    def get_operation(
+        self, name, retry=gapic_v1.method.DEFAULT, timeout=gapic_v1.method.DEFAULT
+    ):
+        """Gets the latest state of a long-running operation.
+
+        Clients can use this method to poll the operation result at intervals
+        as recommended by the API service.
+
+        Example:
+            >>> from google.api_core import operations_v1
+            >>> api = operations_v1.OperationsClient()
+            >>> name = ''
+            >>> response = api.get_operation(name)
+
+        Args:
+            name (str): The name of the operation resource.
+            retry (google.api_core.retry.Retry): The retry strategy to use
+                when invoking the RPC. If unspecified, the default retry from
+                the client configuration will be used. If ``None``, then this
+                method will not retry the RPC at all.
+            timeout (float): The amount of time in seconds to wait for the RPC
+                to complete. Note that if ``retry`` is used, this timeout
+                applies to each individual attempt and the overall time it
+                takes for this method to complete may be longer. If
+                unspecified, the the default timeout in the client
+                configuration is used. If ``None``, then the RPC method will
+                not time out.
+
+        Returns:
+            google.longrunning.operations_pb2.Operation: The state of the
+                operation.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If an error occurred
+                while invoking the RPC, the appropriate ``GoogleAPICallError``
+                subclass will be raised.
+        """
+        request = operations_pb2.GetOperationRequest(name=name)
+        return self._get_operation(request, retry=retry, timeout=timeout)
+
+    def list_operations(
+        self,
+        name,
+        filter_,
+        retry=gapic_v1.method.DEFAULT,
+        timeout=gapic_v1.method.DEFAULT,
+    ):
+        """
+        Lists operations that match the specified filter in the request.
+
+        Example:
+            >>> from google.api_core import operations_v1
+            >>> api = operations_v1.OperationsClient()
+            >>> name = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for operation in api.list_operations(name):
+            >>>   # process operation
+            >>>   pass
+            >>>
+            >>> # Or iterate over results one page at a time
+            >>> iter = api.list_operations(name)
+            >>> for page in iter.pages:
+            >>>   for operation in page:
+            >>>     # process operation
+            >>>     pass
+
+        Args:
+            name (str): The name of the operation collection.
+            filter_ (str): The standard list filter.
+            retry (google.api_core.retry.Retry): The retry strategy to use
+                when invoking the RPC. If unspecified, the default retry from
+                the client configuration will be used. If ``None``, then this
+                method will not retry the RPC at all.
+            timeout (float): The amount of time in seconds to wait for the RPC
+                to complete. Note that if ``retry`` is used, this timeout
+                applies to each individual attempt and the overall time it
+                takes for this method to complete may be longer. If
+                unspecified, the the default timeout in the client
+                configuration is used. If ``None``, then the RPC method will
+                not time out.
+
+        Returns:
+            google.api_core.page_iterator.Iterator: An iterator that yields
+                :class:`google.longrunning.operations_pb2.Operation` instances.
+
+        Raises:
+            google.api_core.exceptions.MethodNotImplemented: If the server
+                does not support this method. Services are not required to
+                implement this method.
+            google.api_core.exceptions.GoogleAPICallError: If an error occurred
+                while invoking the RPC, the appropriate ``GoogleAPICallError``
+                subclass will be raised.
+        """
+        # Create the request object.
+        request = operations_pb2.ListOperationsRequest(name=name, filter=filter_)
+
+        # Create the method used to fetch pages
+        method = functools.partial(self._list_operations, retry=retry, timeout=timeout)
+
+        iterator = page_iterator.GRPCIterator(
+            client=None,
+            method=method,
+            request=request,
+            items_field="operations",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+
+        return iterator
+
+    def cancel_operation(
+        self, name, retry=gapic_v1.method.DEFAULT, timeout=gapic_v1.method.DEFAULT
+    ):
+        """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 :meth:`get_operation` or service-
+        specific 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`` of ``1``, corresponding to
+        ``Code.CANCELLED``.
+
+        Example:
+            >>> from google.api_core import operations_v1
+            >>> api = operations_v1.OperationsClient()
+            >>> name = ''
+            >>> api.cancel_operation(name)
+
+        Args:
+            name (str): The name of the operation resource to be cancelled.
+            retry (google.api_core.retry.Retry): The retry strategy to use
+                when invoking the RPC. If unspecified, the default retry from
+                the client configuration will be used. If ``None``, then this
+                method will not retry the RPC at all.
+            timeout (float): The amount of time in seconds to wait for the RPC
+                to complete. Note that if ``retry`` is used, this timeout
+                applies to each individual attempt and the overall time it
+                takes for this method to complete may be longer. If
+                unspecified, the the default timeout in the client
+                configuration is used. If ``None``, then the RPC method will
+                not time out.
+
+        Raises:
+            google.api_core.exceptions.MethodNotImplemented: If the server
+                does not support this method. Services are not required to
+                implement this method.
+            google.api_core.exceptions.GoogleAPICallError: If an error occurred
+                while invoking the RPC, the appropriate ``GoogleAPICallError``
+                subclass will be raised.
+        """
+        # Create the request object.
+        request = operations_pb2.CancelOperationRequest(name=name)
+        self._cancel_operation(request, retry=retry, timeout=timeout)
+
+    def delete_operation(
+        self, name, retry=gapic_v1.method.DEFAULT, timeout=gapic_v1.method.DEFAULT
+    ):
+        """Deletes a long-running operation.
+
+        This method indicates that the client is no longer interested in the
+        operation result. It does not cancel the operation.
+
+        Example:
+            >>> from google.api_core import operations_v1
+            >>> api = operations_v1.OperationsClient()
+            >>> name = ''
+            >>> api.delete_operation(name)
+
+        Args:
+            name (str): The name of the operation resource to be deleted.
+            retry (google.api_core.retry.Retry): The retry strategy to use
+                when invoking the RPC. If unspecified, the default retry from
+                the client configuration will be used. If ``None``, then this
+                method will not retry the RPC at all.
+            timeout (float): The amount of time in seconds to wait for the RPC
+                to complete. Note that if ``retry`` is used, this timeout
+                applies to each individual attempt and the overall time it
+                takes for this method to complete may be longer. If
+                unspecified, the the default timeout in the client
+                configuration is used. If ``None``, then the RPC method will
+                not time out.
+
+        Raises:
+            google.api_core.exceptions.MethodNotImplemented: If the server
+                does not support this method. Services are not required to
+                implement this method.
+            google.api_core.exceptions.GoogleAPICallError: If an error occurred
+                while invoking the RPC, the appropriate ``GoogleAPICallError``
+                subclass will be raised.
+        """
+        # Create the request object.
+        request = operations_pb2.DeleteOperationRequest(name=name)
+        self._delete_operation(request, retry=retry, timeout=timeout)
diff --git a/api_core/google/api_core/operations_v1/operations_client_config.py b/api_core/google/api_core/operations_v1/operations_client_config.py
new file mode 100644
index 000000000000..6cf95753f4be
--- /dev/null
+++ b/api_core/google/api_core/operations_v1/operations_client_config.py
@@ -0,0 +1,59 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""gapic configuration for the googe.longrunning.operations client."""
+
+config = {
+    "interfaces": {
+        "google.longrunning.Operations": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 600000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "GetOperation": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListOperations": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelOperation": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteOperation": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/api_core/google/api_core/page_iterator.py b/api_core/google/api_core/page_iterator.py
new file mode 100644
index 000000000000..3ac5904399b0
--- /dev/null
+++ b/api_core/google/api_core/page_iterator.py
@@ -0,0 +1,549 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Iterators for paging through paged API methods.
+
+These iterators simplify the process of paging through API responses
+where the request takes a page token and the response is a list of results with
+a token for the next page. See `list pagination`_ in the Google API Style Guide
+for more details.
+
+.. _list pagination:
+    https://cloud.google.com/apis/design/design_patterns#list_pagination
+
+API clients that have methods that follow the list pagination pattern can
+return an :class:`.Iterator`. You can use this iterator to get **all** of
+the results across all pages::
+
+    >>> results_iterator = client.list_resources()
+    >>> list(results_iterator)  # Convert to a list (consumes all values).
+
+Or you can walk your way through items and call off the search early if
+you find what you're looking for (resulting in possibly fewer requests)::
+
+    >>> for resource in results_iterator:
+    ...     print(resource.name)
+    ...     if not resource.is_valid:
+    ...         break
+
+At any point, you may check the number of items consumed by referencing the
+``num_results`` property of the iterator::
+
+    >>> for my_item in results_iterator:
+    ...     if results_iterator.num_results >= 10:
+    ...         break
+
+When iterating, not every new item will send a request to the server.
+To iterate based on each page of items (where a page corresponds to
+a request)::
+
+    >>> for page in results_iterator.pages:
+    ...     print('=' * 20)
+    ...     print('    Page number: {:d}'.format(iterator.page_number))
+    ...     print('  Items in page: {:d}'.format(page.num_items))
+    ...     print('     First item: {!r}'.format(next(page)))
+    ...     print('Items remaining: {:d}'.format(page.remaining))
+    ...     print('Next page token: {}'.format(iterator.next_page_token))
+    ====================
+        Page number: 1
+      Items in page: 1
+         First item: <MyItemClass at 0x7f1d3cccf690>
+    Items remaining: 0
+    Next page token: eav1OzQB0OM8rLdGXOEsyQWSG
+    ====================
+        Page number: 2
+      Items in page: 19
+         First item: <MyItemClass at 0x7f1d3cccffd0>
+    Items remaining: 18
+    Next page token: None
+
+Then, for each page you can get all the resources on that page by iterating
+through it or using :func:`list`::
+
+    >>> list(page)
+    [
+        <MyItemClass at 0x7fd64a098ad0>,
+        <MyItemClass at 0x7fd64a098ed0>,
+        <MyItemClass at 0x7fd64a098e90>,
+    ]
+"""
+
+import abc
+
+import six
+
+
+class Page(object):
+    """Single page of results in an iterator.
+
+    Args:
+        parent (google.api_core.page_iterator.Iterator): The iterator that owns
+            the current page.
+        items (Sequence[Any]): An iterable (that also defines __len__) of items
+            from a raw API response.
+        item_to_value (Callable[google.api_core.page_iterator.Iterator, Any]):
+            Callable to convert an item from the type in the raw API response
+            into the native object. Will be called with the iterator and a
+            single item.
+    """
+
+    def __init__(self, parent, items, item_to_value):
+        self._parent = parent
+        self._num_items = len(items)
+        self._remaining = self._num_items
+        self._item_iter = iter(items)
+        self._item_to_value = item_to_value
+
+    @property
+    def num_items(self):
+        """int: Total items in the page."""
+        return self._num_items
+
+    @property
+    def remaining(self):
+        """int: Remaining items in the page."""
+        return self._remaining
+
+    def __iter__(self):
+        """The :class:`Page` is an iterator of items."""
+        return self
+
+    def next(self):
+        """Get the next value in the page."""
+        item = six.next(self._item_iter)
+        result = self._item_to_value(self._parent, item)
+        # Since we've successfully got the next value from the
+        # iterator, we update the number of remaining.
+        self._remaining -= 1
+        return result
+
+    # Alias needed for Python 2/3 support.
+    __next__ = next
+
+
+def _item_to_value_identity(iterator, item):
+    """An item to value transformer that returns the item un-changed."""
+    # pylint: disable=unused-argument
+    # We are conforming to the interface defined by Iterator.
+    return item
+
+
+@six.add_metaclass(abc.ABCMeta)
+class Iterator(object):
+    """A generic class for iterating through API list responses.
+
+    Args:
+        client(google.cloud.client.Client): The API client.
+        item_to_value (Callable[google.api_core.page_iterator.Iterator, Any]):
+            Callable to convert an item from the type in the raw API response
+            into the native object. Will be called with the iterator and a
+            single item.
+        page_token (str): A token identifying a page in a result set to start
+            fetching results from.
+        max_results (int): The maximum number of results to fetch.
+    """
+
+    def __init__(
+        self,
+        client,
+        item_to_value=_item_to_value_identity,
+        page_token=None,
+        max_results=None,
+    ):
+        self._started = False
+        self.client = client
+        """Optional[Any]: The client that created this iterator."""
+        self.item_to_value = item_to_value
+        """Callable[Iterator, Any]: Callable to convert an item from the type
+            in the raw API response into the native object. Will be called with
+            the iterator and a
+            single item.
+        """
+        self.max_results = max_results
+        """int: The maximum number of results to fetch."""
+
+        # The attributes below will change over the life of the iterator.
+        self.page_number = 0
+        """int: The current page of results."""
+        self.next_page_token = page_token
+        """str: The token for the next page of results. If this is set before
+            the iterator starts, it effectively offsets the iterator to a
+            specific starting point."""
+        self.num_results = 0
+        """int: The total number of results fetched so far."""
+
+    @property
+    def pages(self):
+        """Iterator of pages in the response.
+
+        returns:
+            types.GeneratorType[google.api_core.page_iterator.Page]: A
+                generator of page instances.
+
+        raises:
+            ValueError: If the iterator has already been started.
+        """
+        if self._started:
+            raise ValueError("Iterator has already started", self)
+        self._started = True
+        return self._page_iter(increment=True)
+
+    def _items_iter(self):
+        """Iterator for each item returned."""
+        for page in self._page_iter(increment=False):
+            for item in page:
+                self.num_results += 1
+                yield item
+
+    def __iter__(self):
+        """Iterator for each item returned.
+
+        Returns:
+            types.GeneratorType[Any]: A generator of items from the API.
+
+        Raises:
+            ValueError: If the iterator has already been started.
+        """
+        if self._started:
+            raise ValueError("Iterator has already started", self)
+        self._started = True
+        return self._items_iter()
+
+    def _page_iter(self, increment):
+        """Generator of pages of API responses.
+
+        Args:
+            increment (bool): Flag indicating if the total number of results
+                should be incremented on each page. This is useful since a page
+                iterator will want to increment by results per page while an
+                items iterator will want to increment per item.
+
+        Yields:
+            Page: each page of items from the API.
+        """
+        page = self._next_page()
+        while page is not None:
+            self.page_number += 1
+            if increment:
+                self.num_results += page.num_items
+            yield page
+            page = self._next_page()
+
+    @abc.abstractmethod
+    def _next_page(self):
+        """Get the next page in the iterator.
+
+        This does nothing and is intended to be over-ridden by subclasses
+        to return the next :class:`Page`.
+
+        Raises:
+            NotImplementedError: Always, this method is abstract.
+        """
+        raise NotImplementedError
+
+
+def _do_nothing_page_start(iterator, page, response):
+    """Helper to provide custom behavior after a :class:`Page` is started.
+
+    This is a do-nothing stand-in as the default value.
+
+    Args:
+        iterator (Iterator): An iterator that holds some request info.
+        page (Page): The page that was just created.
+        response (Any): The API response for a page.
+    """
+    # pylint: disable=unused-argument
+    pass
+
+
+class HTTPIterator(Iterator):
+    """A generic class for iterating through HTTP/JSON API list responses.
+
+    To make an iterator work, you'll need to provide a way to convert a JSON
+    item returned from the API into the object of your choice (via
+    ``item_to_value``). You also may need to specify a custom ``items_key`` so
+    that a given response (containing a page of results) can be parsed into an
+    iterable page of the actual objects you want.
+
+    Args:
+        client (google.cloud.client.Client): The API client.
+        api_request (Callable): The function to use to make API requests.
+            Generally, this will be
+            :meth:`google.cloud._http.JSONConnection.api_request`.
+        path (str): The method path to query for the list of items.
+        item_to_value (Callable[google.api_core.page_iterator.Iterator, Any]):
+            Callable to convert an item from the type in the JSON response into
+            a native object. Will be called with the iterator and a single
+            item.
+        items_key (str): The key in the API response where the list of items
+            can be found.
+        page_token (str): A token identifying a page in a result set to start
+            fetching results from.
+        max_results (int): The maximum number of results to fetch.
+        extra_params (dict): Extra query string parameters for the
+            API call.
+        page_start (Callable[
+            google.api_core.page_iterator.Iterator,
+            google.api_core.page_iterator.Page, dict]): Callable to provide
+            any special behavior after a new page has been created. Assumed
+            signature takes the :class:`.Iterator` that started the page,
+            the :class:`.Page` that was started and the dictionary containing
+            the page response.
+        next_token (str): The name of the field used in the response for page
+            tokens.
+
+    .. autoattribute:: pages
+    """
+
+    _DEFAULT_ITEMS_KEY = "items"
+    _PAGE_TOKEN = "pageToken"
+    _MAX_RESULTS = "maxResults"
+    _NEXT_TOKEN = "nextPageToken"
+    _RESERVED_PARAMS = frozenset([_PAGE_TOKEN])
+    _HTTP_METHOD = "GET"
+
+    def __init__(
+        self,
+        client,
+        api_request,
+        path,
+        item_to_value,
+        items_key=_DEFAULT_ITEMS_KEY,
+        page_token=None,
+        max_results=None,
+        extra_params=None,
+        page_start=_do_nothing_page_start,
+        next_token=_NEXT_TOKEN,
+    ):
+        super(HTTPIterator, self).__init__(
+            client, item_to_value, page_token=page_token, max_results=max_results
+        )
+        self.api_request = api_request
+        self.path = path
+        self._items_key = items_key
+        self.extra_params = extra_params
+        self._page_start = page_start
+        self._next_token = next_token
+        # Verify inputs / provide defaults.
+        if self.extra_params is None:
+            self.extra_params = {}
+        self._verify_params()
+
+    def _verify_params(self):
+        """Verifies the parameters don't use any reserved parameter.
+
+        Raises:
+            ValueError: If a reserved parameter is used.
+        """
+        reserved_in_use = self._RESERVED_PARAMS.intersection(self.extra_params)
+        if reserved_in_use:
+            raise ValueError("Using a reserved parameter", reserved_in_use)
+
+    def _next_page(self):
+        """Get the next page in the iterator.
+
+        Returns:
+            Optional[Page]: The next page in the iterator or :data:`None` if
+                there are no pages left.
+        """
+        if self._has_next_page():
+            response = self._get_next_page_response()
+            items = response.get(self._items_key, ())
+            page = Page(self, items, self.item_to_value)
+            self._page_start(self, page, response)
+            self.next_page_token = response.get(self._next_token)
+            return page
+        else:
+            return None
+
+    def _has_next_page(self):
+        """Determines whether or not there are more pages with results.
+
+        Returns:
+            bool: Whether the iterator has more pages.
+        """
+        if self.page_number == 0:
+            return True
+
+        if self.max_results is not None:
+            if self.num_results >= self.max_results:
+                return False
+
+        return self.next_page_token is not None
+
+    def _get_query_params(self):
+        """Getter for query parameters for the next request.
+
+        Returns:
+            dict: A dictionary of query parameters.
+        """
+        result = {}
+        if self.next_page_token is not None:
+            result[self._PAGE_TOKEN] = self.next_page_token
+        if self.max_results is not None:
+            result[self._MAX_RESULTS] = self.max_results - self.num_results
+        result.update(self.extra_params)
+        return result
+
+    def _get_next_page_response(self):
+        """Requests the next page from the path provided.
+
+        Returns:
+            dict: The parsed JSON response of the next page's contents.
+
+        Raises:
+            ValueError: If the HTTP method is not ``GET`` or ``POST``.
+        """
+        params = self._get_query_params()
+        if self._HTTP_METHOD == "GET":
+            return self.api_request(
+                method=self._HTTP_METHOD, path=self.path, query_params=params
+            )
+        elif self._HTTP_METHOD == "POST":
+            return self.api_request(
+                method=self._HTTP_METHOD, path=self.path, data=params
+            )
+        else:
+            raise ValueError("Unexpected HTTP method", self._HTTP_METHOD)
+
+
+class _GAXIterator(Iterator):
+    """A generic class for iterating through Cloud gRPC APIs list responses.
+
+    Any:
+        client (google.cloud.client.Client): The API client.
+        page_iter (google.gax.PageIterator): A GAX page iterator to be wrapped
+            to conform to the :class:`Iterator` interface.
+        item_to_value (Callable[Iterator, Any]): Callable to convert an item
+            from the the protobuf response into a native object. Will
+            be called with the iterator and a single item.
+        max_results (int): The maximum number of results to fetch.
+
+    .. autoattribute:: pages
+    """
+
+    def __init__(self, client, page_iter, item_to_value, max_results=None):
+        super(_GAXIterator, self).__init__(
+            client,
+            item_to_value,
+            page_token=page_iter.page_token,
+            max_results=max_results,
+        )
+        self._gax_page_iter = page_iter
+
+    def _next_page(self):
+        """Get the next page in the iterator.
+
+        Wraps the response from the :class:`~google.gax.PageIterator` in a
+        :class:`Page` instance and captures some state at each page.
+
+        Returns:
+            Optional[Page]: The next page in the iterator or :data:`None` if
+                  there are no pages left.
+        """
+        try:
+            items = six.next(self._gax_page_iter)
+            page = Page(self, items, self.item_to_value)
+            self.next_page_token = self._gax_page_iter.page_token or None
+            return page
+        except StopIteration:
+            return None
+
+
+class GRPCIterator(Iterator):
+    """A generic class for iterating through gRPC list responses.
+
+    .. note:: The class does not take a ``page_token`` argument because it can
+        just be specified in the ``request``.
+
+    Args:
+        client (google.cloud.client.Client): The API client. This unused by
+            this class, but kept to satisfy the :class:`Iterator` interface.
+        method (Callable[protobuf.Message]): A bound gRPC method that should
+            take a single message for the request.
+        request (protobuf.Message): The request message.
+        items_field (str): The field in the response message that has the
+            items for the page.
+        item_to_value (Callable[GRPCIterator, Any]): Callable to convert an
+            item from the type in the JSON response into a native object. Will
+            be called with the iterator and a single item.
+        request_token_field (str): The field in the request message used to
+            specify the page token.
+        response_token_field (str): The field in the response message that has
+            the token for the next page.
+        max_results (int): The maximum number of results to fetch.
+
+    .. autoattribute:: pages
+    """
+
+    _DEFAULT_REQUEST_TOKEN_FIELD = "page_token"
+    _DEFAULT_RESPONSE_TOKEN_FIELD = "next_page_token"
+
+    def __init__(
+        self,
+        client,
+        method,
+        request,
+        items_field,
+        item_to_value=_item_to_value_identity,
+        request_token_field=_DEFAULT_REQUEST_TOKEN_FIELD,
+        response_token_field=_DEFAULT_RESPONSE_TOKEN_FIELD,
+        max_results=None,
+    ):
+        super(GRPCIterator, self).__init__(
+            client, item_to_value, max_results=max_results
+        )
+        self._method = method
+        self._request = request
+        self._items_field = items_field
+        self._request_token_field = request_token_field
+        self._response_token_field = response_token_field
+
+    def _next_page(self):
+        """Get the next page in the iterator.
+
+        Returns:
+            Page: The next page in the iterator or :data:`None` if
+                there are no pages left.
+        """
+        if not self._has_next_page():
+            return None
+
+        if self.next_page_token is not None:
+            setattr(self._request, self._request_token_field, self.next_page_token)
+
+        response = self._method(self._request)
+
+        self.next_page_token = getattr(response, self._response_token_field)
+        items = getattr(response, self._items_field)
+        page = Page(self, items, self.item_to_value)
+
+        return page
+
+    def _has_next_page(self):
+        """Determines whether or not there are more pages with results.
+
+        Returns:
+            bool: Whether the iterator has more pages.
+        """
+        if self.page_number == 0:
+            return True
+
+        if self.max_results is not None:
+            if self.num_results >= self.max_results:
+                return False
+
+        # Note: intentionally a falsy check instead of a None check. The RPC
+        # can return an empty string indicating no more pages.
+        return True if self.next_page_token else False
diff --git a/api_core/google/api_core/path_template.py b/api_core/google/api_core/path_template.py
new file mode 100644
index 000000000000..bb549356d284
--- /dev/null
+++ b/api_core/google/api_core/path_template.py
@@ -0,0 +1,197 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Expand and validate URL path templates.
+
+This module provides the :func:`expand` and :func:`validate` functions for
+interacting with Google-style URL `path templates`_ which are commonly used
+in Google APIs for `resource names`_.
+
+.. _path templates: https://github.com/googleapis/googleapis/blob
+    /57e2d376ac7ef48681554204a3ba78a414f2c533/google/api/http.proto#L212
+.. _resource names: https://cloud.google.com/apis/design/resource_names
+"""
+
+from __future__ import unicode_literals
+
+import functools
+import re
+
+import six
+
+# Regular expression for extracting variable parts from a path template.
+# The variables can be expressed as:
+#
+# - "*": a single-segment positional variable, for example: "books/*"
+# - "**": a multi-segment positional variable, for example: "shelf/**/book/*"
+# - "{name}": a single-segment wildcard named variable, for example
+#   "books/{name}"
+# - "{name=*}: same as above.
+# - "{name=**}": a multi-segment wildcard named variable, for example
+#   "shelf/{name=**}"
+# - "{name=/path/*/**}": a multi-segment named variable with a sub-template.
+_VARIABLE_RE = re.compile(
+    r"""
+    (  # Capture the entire variable expression
+        (?P<positional>\*\*?)  # Match & capture * and ** positional variables.
+        |
+        # Match & capture named variables {name}
+        {
+            (?P<name>[^/]+?)
+            # Optionally match and capture the named variable's template.
+            (?:=(?P<template>.+?))?
+        }
+    )
+    """,
+    re.VERBOSE,
+)
+
+# Segment expressions used for validating paths against a template.
+_SINGLE_SEGMENT_PATTERN = r"([^/]+)"
+_MULTI_SEGMENT_PATTERN = r"(.+)"
+
+
+def _expand_variable_match(positional_vars, named_vars, match):
+    """Expand a matched variable with its value.
+
+    Args:
+        positional_vars (list): A list of positonal variables. This list will
+            be modified.
+        named_vars (dict): A dictionary of named variables.
+        match (re.Match): A regular expression match.
+
+    Returns:
+        str: The expanded variable to replace the match.
+
+    Raises:
+        ValueError: If a positional or named variable is required by the
+            template but not specified or if an unexpected template expression
+            is encountered.
+    """
+    positional = match.group("positional")
+    name = match.group("name")
+    if name is not None:
+        try:
+            return six.text_type(named_vars[name])
+        except KeyError:
+            raise ValueError(
+                "Named variable '{}' not specified and needed by template "
+                "`{}` at position {}".format(name, match.string, match.start())
+            )
+    elif positional is not None:
+        try:
+            return six.text_type(positional_vars.pop(0))
+        except IndexError:
+            raise ValueError(
+                "Positional variable not specified and needed by template "
+                "`{}` at position {}".format(match.string, match.start())
+            )
+    else:
+        raise ValueError("Unknown template expression {}".format(match.group(0)))
+
+
+def expand(tmpl, *args, **kwargs):
+    """Expand a path template with the given variables.
+
+    ..code-block:: python
+
+        >>> expand('users/*/messages/*', 'me', '123')
+        users/me/messages/123
+        >>> expand('/v1/{name=shelves/*/books/*}', name='shelves/1/books/3')
+        /v1/shelves/1/books/3
+
+    Args:
+        tmpl (str): The path template.
+        args: The positional variables for the path.
+        kwargs: The named variables for the path.
+
+    Returns:
+        str: The expanded path
+
+    Raises:
+        ValueError: If a positional or named variable is required by the
+            template but not specified or if an unexpected template expression
+            is encountered.
+    """
+    replacer = functools.partial(_expand_variable_match, list(args), kwargs)
+    return _VARIABLE_RE.sub(replacer, tmpl)
+
+
+def _replace_variable_with_pattern(match):
+    """Replace a variable match with a pattern that can be used to validate it.
+
+    Args:
+        match (re.Match): A regular expression match
+
+    Returns:
+        str: A regular expression pattern that can be used to validate the
+            variable in an expanded path.
+
+    Raises:
+        ValueError: If an unexpected template expression is encountered.
+    """
+    positional = match.group("positional")
+    name = match.group("name")
+    template = match.group("template")
+    if name is not None:
+        if not template:
+            return _SINGLE_SEGMENT_PATTERN.format(name)
+        elif template == "**":
+            return _MULTI_SEGMENT_PATTERN.format(name)
+        else:
+            return _generate_pattern_for_template(template)
+    elif positional == "*":
+        return _SINGLE_SEGMENT_PATTERN
+    elif positional == "**":
+        return _MULTI_SEGMENT_PATTERN
+    else:
+        raise ValueError("Unknown template expression {}".format(match.group(0)))
+
+
+def _generate_pattern_for_template(tmpl):
+    """Generate a pattern that can validate a path template.
+
+    Args:
+        tmpl (str): The path template
+
+    Returns:
+        str: A regular expression pattern that can be used to validate an
+            expanded path template.
+    """
+    return _VARIABLE_RE.sub(_replace_variable_with_pattern, tmpl)
+
+
+def validate(tmpl, path):
+    """Validate a path against the path template.
+
+    .. code-block:: python
+
+        >>> validate('users/*/messages/*', 'users/me/messages/123')
+        True
+        >>> validate('users/*/messages/*', 'users/me/drafts/123')
+        False
+        >>> validate('/v1/{name=shelves/*/books/*}', /v1/shelves/1/books/3)
+        True
+        >>> validate('/v1/{name=shelves/*/books/*}', /v1/shelves/1/tapes/3)
+        False
+
+    Args:
+        tmpl (str): The path template.
+        path (str): The expanded path.
+
+    Returns:
+        bool: True if the path matches.
+    """
+    pattern = _generate_pattern_for_template(tmpl) + "$"
+    return True if re.match(pattern, path) is not None else False
diff --git a/api_core/google/api_core/protobuf_helpers.py b/api_core/google/api_core/protobuf_helpers.py
new file mode 100644
index 000000000000..aec6b3620743
--- /dev/null
+++ b/api_core/google/api_core/protobuf_helpers.py
@@ -0,0 +1,368 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for :mod:`protobuf`."""
+
+import collections
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+import copy
+import inspect
+
+from google.protobuf import field_mask_pb2
+from google.protobuf import message
+from google.protobuf import wrappers_pb2
+
+_SENTINEL = object()
+_WRAPPER_TYPES = (
+    wrappers_pb2.BoolValue,
+    wrappers_pb2.BytesValue,
+    wrappers_pb2.DoubleValue,
+    wrappers_pb2.FloatValue,
+    wrappers_pb2.Int32Value,
+    wrappers_pb2.Int64Value,
+    wrappers_pb2.StringValue,
+    wrappers_pb2.UInt32Value,
+    wrappers_pb2.UInt64Value,
+)
+
+
+def from_any_pb(pb_type, any_pb):
+    """Converts an ``Any`` protobuf to the specified message type.
+
+    Args:
+        pb_type (type): the type of the message that any_pb stores an instance
+            of.
+        any_pb (google.protobuf.any_pb2.Any): the object to be converted.
+
+    Returns:
+        pb_type: An instance of the pb_type message.
+
+    Raises:
+        TypeError: if the message could not be converted.
+    """
+    msg = pb_type()
+
+    # Unwrap proto-plus wrapped messages.
+    if callable(getattr(pb_type, "pb", None)):
+        msg_pb = pb_type.pb(msg)
+    else:
+        msg_pb = msg
+
+    # Unpack the Any object and populate the protobuf message instance.
+    if not any_pb.Unpack(msg_pb):
+        raise TypeError(
+            "Could not convert {} to {}".format(
+                any_pb.__class__.__name__, pb_type.__name__
+            )
+        )
+
+    # Done; return the message.
+    return msg
+
+
+def check_oneof(**kwargs):
+    """Raise ValueError if more than one keyword argument is not ``None``.
+
+    Args:
+        kwargs (dict): The keyword arguments sent to the function.
+
+    Raises:
+        ValueError: If more than one entry in ``kwargs`` is not ``None``.
+    """
+    # Sanity check: If no keyword arguments were sent, this is fine.
+    if not kwargs:
+        return
+
+    not_nones = [val for val in kwargs.values() if val is not None]
+    if len(not_nones) > 1:
+        raise ValueError(
+            "Only one of {fields} should be set.".format(
+                fields=", ".join(sorted(kwargs.keys()))
+            )
+        )
+
+
+def get_messages(module):
+    """Discovers all protobuf Message classes in a given import module.
+
+    Args:
+        module (module): A Python module; :func:`dir` will be run against this
+            module to find Message subclasses.
+
+    Returns:
+        dict[str, google.protobuf.message.Message]: A dictionary with the
+            Message class names as keys, and the Message subclasses themselves
+            as values.
+    """
+    answer = collections.OrderedDict()
+    for name in dir(module):
+        candidate = getattr(module, name)
+        if inspect.isclass(candidate) and issubclass(candidate, message.Message):
+            answer[name] = candidate
+    return answer
+
+
+def _resolve_subkeys(key, separator="."):
+    """Resolve a potentially nested key.
+
+    If the key contains the ``separator`` (e.g. ``.``) then the key will be
+    split on the first instance of the subkey::
+
+       >>> _resolve_subkeys('a.b.c')
+       ('a', 'b.c')
+       >>> _resolve_subkeys('d|e|f', separator='|')
+       ('d', 'e|f')
+
+    If not, the subkey will be :data:`None`::
+
+        >>> _resolve_subkeys('foo')
+        ('foo', None)
+
+    Args:
+        key (str): A string that may or may not contain the separator.
+        separator (str): The namespace separator. Defaults to `.`.
+
+    Returns:
+        Tuple[str, str]: The key and subkey(s).
+    """
+    parts = key.split(separator, 1)
+
+    if len(parts) > 1:
+        return parts
+    else:
+        return parts[0], None
+
+
+def get(msg_or_dict, key, default=_SENTINEL):
+    """Retrieve a key's value from a protobuf Message or dictionary.
+
+    Args:
+        mdg_or_dict (Union[~google.protobuf.message.Message, Mapping]): the
+            object.
+        key (str): The key to retrieve from the object.
+        default (Any): If the key is not present on the object, and a default
+            is set, returns that default instead. A type-appropriate falsy
+            default is generally recommended, as protobuf messages almost
+            always have default values for unset values and it is not always
+            possible to tell the difference between a falsy value and an
+            unset one. If no default is set then :class:`KeyError` will be
+            raised if the key is not present in the object.
+
+    Returns:
+        Any: The return value from the underlying Message or dict.
+
+    Raises:
+        KeyError: If the key is not found. Note that, for unset values,
+            messages and dictionaries may not have consistent behavior.
+        TypeError: If ``msg_or_dict`` is not a Message or Mapping.
+    """
+    # We may need to get a nested key. Resolve this.
+    key, subkey = _resolve_subkeys(key)
+
+    # Attempt to get the value from the two types of objects we know about.
+    # If we get something else, complain.
+    if isinstance(msg_or_dict, message.Message):
+        answer = getattr(msg_or_dict, key, default)
+    elif isinstance(msg_or_dict, collections_abc.Mapping):
+        answer = msg_or_dict.get(key, default)
+    else:
+        raise TypeError(
+            "get() expected a dict or protobuf message, got {!r}.".format(
+                type(msg_or_dict)
+            )
+        )
+
+    # If the object we got back is our sentinel, raise KeyError; this is
+    # a "not found" case.
+    if answer is _SENTINEL:
+        raise KeyError(key)
+
+    # If a subkey exists, call this method recursively against the answer.
+    if subkey is not None and answer is not default:
+        return get(answer, subkey, default=default)
+
+    return answer
+
+
+def _set_field_on_message(msg, key, value):
+    """Set helper for protobuf Messages."""
+    # Attempt to set the value on the types of objects we know how to deal
+    # with.
+    if isinstance(value, (collections_abc.MutableSequence, tuple)):
+        # Clear the existing repeated protobuf message of any elements
+        # currently inside it.
+        while getattr(msg, key):
+            getattr(msg, key).pop()
+
+        # Write our new elements to the repeated field.
+        for item in value:
+            if isinstance(item, collections_abc.Mapping):
+                getattr(msg, key).add(**item)
+            else:
+                # protobuf's RepeatedCompositeContainer doesn't support
+                # append.
+                getattr(msg, key).extend([item])
+    elif isinstance(value, collections_abc.Mapping):
+        # Assign the dictionary values to the protobuf message.
+        for item_key, item_value in value.items():
+            set(getattr(msg, key), item_key, item_value)
+    elif isinstance(value, message.Message):
+        getattr(msg, key).CopyFrom(value)
+    else:
+        setattr(msg, key, value)
+
+
+def set(msg_or_dict, key, value):
+    """Set a key's value on a protobuf Message or dictionary.
+
+    Args:
+        msg_or_dict (Union[~google.protobuf.message.Message, Mapping]): the
+            object.
+        key (str): The key to set.
+        value (Any): The value to set.
+
+    Raises:
+        TypeError: If ``msg_or_dict`` is not a Message or dictionary.
+    """
+    # Sanity check: Is our target object valid?
+    if not isinstance(msg_or_dict, (collections_abc.MutableMapping, message.Message)):
+        raise TypeError(
+            "set() expected a dict or protobuf message, got {!r}.".format(
+                type(msg_or_dict)
+            )
+        )
+
+    # We may be setting a nested key. Resolve this.
+    basekey, subkey = _resolve_subkeys(key)
+
+    # If a subkey exists, then get that object and call this method
+    # recursively against it using the subkey.
+    if subkey is not None:
+        if isinstance(msg_or_dict, collections_abc.MutableMapping):
+            msg_or_dict.setdefault(basekey, {})
+        set(get(msg_or_dict, basekey), subkey, value)
+        return
+
+    if isinstance(msg_or_dict, collections_abc.MutableMapping):
+        msg_or_dict[key] = value
+    else:
+        _set_field_on_message(msg_or_dict, key, value)
+
+
+def setdefault(msg_or_dict, key, value):
+    """Set the key on a protobuf Message or dictionary to a given value if the
+    current value is falsy.
+
+    Because protobuf Messages do not distinguish between unset values and
+    falsy ones particularly well (by design), this method treats any falsy
+    value (e.g. 0, empty list) as a target to be overwritten, on both Messages
+    and dictionaries.
+
+    Args:
+        msg_or_dict (Union[~google.protobuf.message.Message, Mapping]): the
+            object.
+        key (str): The key on the object in question.
+        value (Any): The value to set.
+
+    Raises:
+        TypeError: If ``msg_or_dict`` is not a Message or dictionary.
+    """
+    if not get(msg_or_dict, key, default=None):
+        set(msg_or_dict, key, value)
+
+
+def field_mask(original, modified):
+    """Create a field mask by comparing two messages.
+
+    Args:
+        original (~google.protobuf.message.Message): the original message.
+            If set to None, this field will be interpretted as an empty
+            message.
+        modified (~google.protobuf.message.Message): the modified message.
+            If set to None, this field will be interpretted as an empty
+            message.
+
+    Returns:
+        google.protobuf.field_mask_pb2.FieldMask: field mask that contains
+        the list of field names that have different values between the two
+        messages. If the messages are equivalent, then the field mask is empty.
+
+    Raises:
+        ValueError: If the ``original`` or ``modified`` are not the same type.
+    """
+    if original is None and modified is None:
+        return field_mask_pb2.FieldMask()
+
+    if original is None and modified is not None:
+        original = copy.deepcopy(modified)
+        original.Clear()
+
+    if modified is None and original is not None:
+        modified = copy.deepcopy(original)
+        modified.Clear()
+
+    if type(original) != type(modified):
+        raise ValueError(
+            "expected that both original and modified should be of the "
+            'same type, received "{!r}" and "{!r}".'.format(
+                type(original), type(modified)
+            )
+        )
+
+    return field_mask_pb2.FieldMask(paths=_field_mask_helper(original, modified))
+
+
+def _field_mask_helper(original, modified, current=""):
+    answer = []
+
+    for name in original.DESCRIPTOR.fields_by_name:
+        field_path = _get_path(current, name)
+
+        original_val = getattr(original, name)
+        modified_val = getattr(modified, name)
+
+        if _is_message(original_val) or _is_message(modified_val):
+            if original_val != modified_val:
+                # Wrapper types do not need to include the .value part of the
+                # path.
+                if _is_wrapper(original_val) or _is_wrapper(modified_val):
+                    answer.append(field_path)
+                elif not modified_val.ListFields():
+                    answer.append(field_path)
+                else:
+                    answer.extend(
+                        _field_mask_helper(original_val, modified_val, field_path)
+                    )
+        else:
+            if original_val != modified_val:
+                answer.append(field_path)
+
+    return answer
+
+
+def _get_path(current, name):
+    if not current:
+        return name
+    return "%s.%s" % (current, name)
+
+
+def _is_message(value):
+    return isinstance(value, message.Message)
+
+
+def _is_wrapper(value):
+    return type(value) in _WRAPPER_TYPES
diff --git a/api_core/google/api_core/retry.py b/api_core/google/api_core/retry.py
new file mode 100644
index 000000000000..79343bad3471
--- /dev/null
+++ b/api_core/google/api_core/retry.py
@@ -0,0 +1,351 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for retrying functions with exponential back-off.
+
+The :class:`Retry` decorator can be used to retry functions that raise
+exceptions using exponential backoff. Because a exponential sleep algorithm is
+used, the retry is limited by a `deadline`. The deadline is the maxmimum amount
+of time a method can block. This is used instead of total number of retries
+because it is difficult to ascertain the amount of time a function can block
+when using total number of retries and exponential backoff.
+
+By default, this decorator will retry transient
+API errors (see :func:`if_transient_error`). For example:
+
+.. code-block:: python
+
+    @retry.Retry()
+    def call_flaky_rpc():
+        return client.flaky_rpc()
+
+    # Will retry flaky_rpc() if it raises transient API errors.
+    result = call_flaky_rpc()
+
+You can pass a custom predicate to retry on different exceptions, such as
+waiting for an eventually consistent item to be available:
+
+.. code-block:: python
+
+    @retry.Retry(predicate=if_exception_type(exceptions.NotFound))
+    def check_if_exists():
+        return client.does_thing_exist()
+
+    is_available = check_if_exists()
+
+Some client library methods apply retry automatically. These methods can accept
+a ``retry`` parameter that allows you to configure the behavior:
+
+.. code-block:: python
+
+    my_retry = retry.Retry(deadline=60)
+    result = client.some_method(retry=my_retry)
+
+"""
+
+from __future__ import unicode_literals
+
+import datetime
+import functools
+import logging
+import random
+import time
+
+import six
+
+from google.api_core import datetime_helpers
+from google.api_core import exceptions
+from google.api_core import general_helpers
+
+_LOGGER = logging.getLogger(__name__)
+_DEFAULT_INITIAL_DELAY = 1.0  # seconds
+_DEFAULT_MAXIMUM_DELAY = 60.0  # seconds
+_DEFAULT_DELAY_MULTIPLIER = 2.0
+_DEFAULT_DEADLINE = 60.0 * 2.0  # seconds
+
+
+def if_exception_type(*exception_types):
+    """Creates a predicate to check if the exception is of a given type.
+
+    Args:
+        exception_types (Sequence[:func:`type`]): The exception types to check
+            for.
+
+    Returns:
+        Callable[Exception]: A predicate that returns True if the provided
+            exception is of the given type(s).
+    """
+
+    def if_exception_type_predicate(exception):
+        """Bound predicate for checking an exception type."""
+        return isinstance(exception, exception_types)
+
+    return if_exception_type_predicate
+
+
+# pylint: disable=invalid-name
+# Pylint sees this as a constant, but it is also an alias that should be
+# considered a function.
+if_transient_error = if_exception_type(
+    exceptions.InternalServerError,
+    exceptions.TooManyRequests,
+    exceptions.ServiceUnavailable,
+)
+"""A predicate that checks if an exception is a transient API error.
+
+The following server errors are considered transient:
+
+- :class:`google.api_core.exceptions.InternalServerError` - HTTP 500, gRPC
+    ``INTERNAL(13)`` and its subclasses.
+- :class:`google.api_core.exceptions.TooManyRequests` - HTTP 429
+- :class:`google.api_core.exceptions.ServiceUnavailable` - HTTP 503
+- :class:`google.api_core.exceptions.ResourceExhausted` - gRPC
+    ``RESOURCE_EXHAUSTED(8)``
+"""
+# pylint: enable=invalid-name
+
+
+def exponential_sleep_generator(initial, maximum, multiplier=_DEFAULT_DELAY_MULTIPLIER):
+    """Generates sleep intervals based on the exponential back-off algorithm.
+
+    This implements the `Truncated Exponential Back-off`_ algorithm.
+
+    .. _Truncated Exponential Back-off:
+        https://cloud.google.com/storage/docs/exponential-backoff
+
+    Args:
+        initial (float): The minimum amout of time to delay. This must
+            be greater than 0.
+        maximum (float): The maximum amout of time to delay.
+        multiplier (float): The multiplier applied to the delay.
+
+    Yields:
+        float: successive sleep intervals.
+    """
+    delay = initial
+    while True:
+        # Introduce jitter by yielding a delay that is uniformly distributed
+        # to average out to the delay time.
+        yield min(random.uniform(0.0, delay * 2.0), maximum)
+        delay = delay * multiplier
+
+
+def retry_target(target, predicate, sleep_generator, deadline, on_error=None):
+    """Call a function and retry if it fails.
+
+    This is the lowest-level retry helper. Generally, you'll use the
+    higher-level retry helper :class:`Retry`.
+
+    Args:
+        target(Callable): The function to call and retry. This must be a
+            nullary function - apply arguments with `functools.partial`.
+        predicate (Callable[Exception]): A callable used to determine if an
+            exception raised by the target should be considered retryable.
+            It should return True to retry or False otherwise.
+        sleep_generator (Iterable[float]): An infinite iterator that determines
+            how long to sleep between retries.
+        deadline (float): How long to keep retrying the target.
+        on_error (Callable): A function to call while processing a retryable
+            exception.  Any error raised by this function will *not* be
+            caught.
+
+    Returns:
+        Any: the return value of the target function.
+
+    Raises:
+        google.api_core.RetryError: If the deadline is exceeded while retrying.
+        ValueError: If the sleep generator stops yielding values.
+        Exception: If the target raises a method that isn't retryable.
+    """
+    if deadline is not None:
+        deadline_datetime = datetime_helpers.utcnow() + datetime.timedelta(
+            seconds=deadline
+        )
+    else:
+        deadline_datetime = None
+
+    last_exc = None
+
+    for sleep in sleep_generator:
+        try:
+            return target()
+
+        # pylint: disable=broad-except
+        # This function explicitly must deal with broad exceptions.
+        except Exception as exc:
+            if not predicate(exc):
+                raise
+            last_exc = exc
+            if on_error is not None:
+                on_error(exc)
+
+        now = datetime_helpers.utcnow()
+        if deadline_datetime is not None and deadline_datetime < now:
+            six.raise_from(
+                exceptions.RetryError(
+                    "Deadline of {:.1f}s exceeded while calling {}".format(
+                        deadline, target
+                    ),
+                    last_exc,
+                ),
+                last_exc,
+            )
+
+        _LOGGER.debug(
+            "Retrying due to {}, sleeping {:.1f}s ...".format(last_exc, sleep)
+        )
+        time.sleep(sleep)
+
+    raise ValueError("Sleep generator stopped yielding sleep values.")
+
+
+@six.python_2_unicode_compatible
+class Retry(object):
+    """Exponential retry decorator.
+
+    This class is a decorator used to add exponential back-off retry behavior
+    to an RPC call.
+
+    Although the default behavior is to retry transient API errors, a
+    different predicate can be provided to retry other exceptions.
+
+    Args:
+        predicate (Callable[Exception]): A callable that should return ``True``
+            if the given exception is retryable.
+        initial (float): The minimum a,out of time to delay in seconds. This
+            must be greater than 0.
+        maximum (float): The maximum amout of time to delay in seconds.
+        multiplier (float): The multiplier applied to the delay.
+        deadline (float): How long to keep retrying in seconds.
+    """
+
+    def __init__(
+        self,
+        predicate=if_transient_error,
+        initial=_DEFAULT_INITIAL_DELAY,
+        maximum=_DEFAULT_MAXIMUM_DELAY,
+        multiplier=_DEFAULT_DELAY_MULTIPLIER,
+        deadline=_DEFAULT_DEADLINE,
+        on_error=None
+    ):
+        self._predicate = predicate
+        self._initial = initial
+        self._multiplier = multiplier
+        self._maximum = maximum
+        self._deadline = deadline
+        self._on_error = on_error
+
+    def __call__(self, func, on_error=None):
+        """Wrap a callable with retry behavior.
+
+        Args:
+            func (Callable): The callable to add retry behavior to.
+            on_error (Callable): A function to call while processing a
+                retryable exception.  Any error raised by this function will
+                *not* be caught.
+
+        Returns:
+            Callable: A callable that will invoke ``func`` with retry
+                behavior.
+        """
+        if self._on_error is not None:
+            on_error = self._on_error
+
+        @general_helpers.wraps(func)
+        def retry_wrapped_func(*args, **kwargs):
+            """A wrapper that calls target function with retry."""
+            target = functools.partial(func, *args, **kwargs)
+            sleep_generator = exponential_sleep_generator(
+                self._initial, self._maximum, multiplier=self._multiplier
+            )
+            return retry_target(
+                target,
+                self._predicate,
+                sleep_generator,
+                self._deadline,
+                on_error=on_error,
+            )
+
+        return retry_wrapped_func
+
+    def with_deadline(self, deadline):
+        """Return a copy of this retry with the given deadline.
+
+        Args:
+            deadline (float): How long to keep retrying.
+
+        Returns:
+            Retry: A new retry instance with the given deadline.
+        """
+        return Retry(
+            predicate=self._predicate,
+            initial=self._initial,
+            maximum=self._maximum,
+            multiplier=self._multiplier,
+            deadline=deadline,
+            on_error=self._on_error,
+        )
+
+    def with_predicate(self, predicate):
+        """Return a copy of this retry with the given predicate.
+
+        Args:
+            predicate (Callable[Exception]): A callable that should return
+                ``True`` if the given exception is retryable.
+
+        Returns:
+            Retry: A new retry instance with the given predicate.
+        """
+        return Retry(
+            predicate=predicate,
+            initial=self._initial,
+            maximum=self._maximum,
+            multiplier=self._multiplier,
+            deadline=self._deadline,
+            on_error=self._on_error,
+        )
+
+    def with_delay(self, initial=None, maximum=None, multiplier=None):
+        """Return a copy of this retry with the given delay options.
+
+        Args:
+            initial (float): The minimum amout of time to delay. This must
+                be greater than 0.
+            maximum (float): The maximum amout of time to delay.
+            multiplier (float): The multiplier applied to the delay.
+
+        Returns:
+            Retry: A new retry instance with the given predicate.
+        """
+        return Retry(
+            predicate=self._predicate,
+            initial=initial if initial is not None else self._initial,
+            maximum=maximum if maximum is not None else self._maximum,
+            multiplier=multiplier if maximum is not None else self._multiplier,
+            deadline=self._deadline,
+            on_error=self._on_error,
+        )
+
+    def __str__(self):
+        return (
+            "<Retry predicate={}, initial={:.1f}, maximum={:.1f}, "
+            "multiplier={:.1f}, deadline={:.1f}, on_error={}>".format(
+                self._predicate,
+                self._initial,
+                self._maximum,
+                self._multiplier,
+                self._deadline,
+                self._on_error,
+            )
+        )
diff --git a/api_core/google/api_core/timeout.py b/api_core/google/api_core/timeout.py
new file mode 100644
index 000000000000..17c1beabb3c5
--- /dev/null
+++ b/api_core/google/api_core/timeout.py
@@ -0,0 +1,224 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Decorators for applying timeout arguments to functions.
+
+These decorators are used to wrap API methods to apply either a constant
+or exponential timeout argument.
+
+For example, imagine an API method that can take a while to return results,
+such as one that might block until a resource is ready:
+
+.. code-block:: python
+
+    def is_thing_ready(timeout=None):
+        response = requests.get('https://example.com/is_thing_ready')
+        response.raise_for_status()
+        return response.json()
+
+This module allows a function like this to be wrapped so that timeouts are
+automatically determined, for example:
+
+.. code-block:: python
+
+    timeout_ = timeout.ExponentialTimeout()
+    is_thing_ready_with_timeout = timeout_(is_thing_ready)
+
+    for n in range(10):
+        try:
+            is_thing_ready_with_timeout({'example': 'data'})
+        except:
+            pass
+
+In this example the first call to ``is_thing_ready`` will have a relatively
+small timeout (like 1 second). If the resource is available and the request
+completes quickly, the loop exits. But, if the resource isn't yet available
+and the request times out, it'll be retried - this time with a larger timeout.
+
+In the broader context these decorators are typically combined with
+:mod:`google.api_core.retry` to implement API methods with a signature that
+matches ``api_method(request, timeout=None, retry=None)``.
+"""
+
+from __future__ import unicode_literals
+
+import datetime
+
+import six
+
+from google.api_core import datetime_helpers
+from google.api_core import general_helpers
+
+_DEFAULT_INITIAL_TIMEOUT = 5.0  # seconds
+_DEFAULT_MAXIMUM_TIMEOUT = 30.0  # seconds
+_DEFAULT_TIMEOUT_MULTIPLIER = 2.0
+# If specified, must be in seconds. If none, deadline is not used in the
+# timeout calculation.
+_DEFAULT_DEADLINE = None
+
+
+@six.python_2_unicode_compatible
+class ConstantTimeout(object):
+    """A decorator that adds a constant timeout argument.
+
+    This is effectively equivalent to
+    ``functools.partial(func, timeout=timeout)``.
+
+    Args:
+        timeout (Optional[float]): the timeout (in seconds) to applied to the
+            wrapped function. If `None`, the target function is expected to
+            never timeout.
+    """
+
+    def __init__(self, timeout=None):
+        self._timeout = timeout
+
+    def __call__(self, func):
+        """Apply the timeout decorator.
+
+        Args:
+            func (Callable): The function to apply the timeout argument to.
+                This function must accept a timeout keyword argument.
+
+        Returns:
+            Callable: The wrapped function.
+        """
+
+        @general_helpers.wraps(func)
+        def func_with_timeout(*args, **kwargs):
+            """Wrapped function that adds timeout."""
+            kwargs["timeout"] = self._timeout
+            return func(*args, **kwargs)
+
+        return func_with_timeout
+
+    def __str__(self):
+        return "<ConstantTimeout timeout={:.1f}>".format(self._timeout)
+
+
+def _exponential_timeout_generator(initial, maximum, multiplier, deadline):
+    """A generator that yields exponential timeout values.
+
+    Args:
+        initial (float): The initial timeout.
+        maximum (float): The maximum timeout.
+        multiplier (float): The multiplier applied to the timeout.
+        deadline (float): The overall deadline across all invocations.
+
+    Yields:
+        float: A timeout value.
+    """
+    if deadline is not None:
+        deadline_datetime = datetime_helpers.utcnow() + datetime.timedelta(
+            seconds=deadline
+        )
+    else:
+        deadline_datetime = datetime.datetime.max
+
+    timeout = initial
+    while True:
+        now = datetime_helpers.utcnow()
+        yield min(
+            # The calculated timeout based on invocations.
+            timeout,
+            # The set maximum timeout.
+            maximum,
+            # The remaining time before the deadline is reached.
+            float((deadline_datetime - now).seconds),
+        )
+        timeout = timeout * multiplier
+
+
+@six.python_2_unicode_compatible
+class ExponentialTimeout(object):
+    """A decorator that adds an exponentially increasing timeout argument.
+
+    This is useful if a function is called multiple times. Each time the
+    function is called this decorator will calculate a new timeout parameter
+    based on the the number of times the function has been called.
+
+    For example
+
+    .. code-block:: python
+
+    Args:
+        initial (float): The initial timeout to pass.
+        maximum (float): The maximum timeout for any one call.
+        multiplier (float): The multiplier applied to the timeout for each
+            invocation.
+        deadline (Optional[float]): The overall deadline across all
+            invocations. This is used to prevent a very large calculated
+            timeout from pushing the overall execution time over the deadline.
+            This is especially useful in conjuction with
+            :mod:`google.api_core.retry`. If ``None``, the timeouts will not
+            be adjusted to accomodate an overall deadline.
+    """
+
+    def __init__(
+        self,
+        initial=_DEFAULT_INITIAL_TIMEOUT,
+        maximum=_DEFAULT_MAXIMUM_TIMEOUT,
+        multiplier=_DEFAULT_TIMEOUT_MULTIPLIER,
+        deadline=_DEFAULT_DEADLINE,
+    ):
+        self._initial = initial
+        self._maximum = maximum
+        self._multiplier = multiplier
+        self._deadline = deadline
+
+    def with_deadline(self, deadline):
+        """Return a copy of this teimout with the given deadline.
+
+        Args:
+            deadline (float): The overall deadline across all invocations.
+
+        Returns:
+            ExponentialTimeout: A new instance with the given deadline.
+        """
+        return ExponentialTimeout(
+            initial=self._initial,
+            maximum=self._maximum,
+            multiplier=self._multiplier,
+            deadline=deadline,
+        )
+
+    def __call__(self, func):
+        """Apply the timeout decorator.
+
+        Args:
+            func (Callable): The function to apply the timeout argument to.
+                This function must accept a timeout keyword argument.
+
+        Returns:
+            Callable: The wrapped function.
+        """
+        timeouts = _exponential_timeout_generator(
+            self._initial, self._maximum, self._multiplier, self._deadline
+        )
+
+        @general_helpers.wraps(func)
+        def func_with_timeout(*args, **kwargs):
+            """Wrapped function that adds timeout."""
+            kwargs["timeout"] = next(timeouts)
+            return func(*args, **kwargs)
+
+        return func_with_timeout
+
+    def __str__(self):
+        return (
+            "<ExponentialTimeout initial={:.1f}, maximum={:.1f}, "
+            "multiplier={:.1f}, deadline={:.1f}>".format(
+                self._initial, self._maximum, self._multiplier, self._deadline
+            )
+        )
diff --git a/api_core/noxfile.py b/api_core/noxfile.py
new file mode 100644
index 000000000000..5e70db20dcd1
--- /dev/null
+++ b/api_core/noxfile.py
@@ -0,0 +1,129 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+# https://github.com/google/importlab/issues/25
+import nox  # pytype: disable=import-error
+
+
+def default(session):
+    """Default unit test session.
+
+    This is intended to be run **without** an interpreter set, so
+    that the current ``python`` (on the ``PATH``) or the version of
+    Python corresponding to the ``nox`` binary the ``PATH`` can
+    run the tests.
+    """
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov", "grpcio >= 1.0.2")
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.api_core",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit_grpc_gcp(session):
+    """Run the unit test suite with grpcio-gcp installed."""
+
+    # Install grpcio-gcp
+    session.install("grpcio-gcp")
+
+    default(session)
+
+
+@nox.session(python="3.6")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "flake8-import-order")
+    session.install(".")
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+
+    session.install("docutils", "Pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+# No 2.7 due to https://github.com/google/importlab/issues/26.
+# No 3.7 because pytype supports up to 3.6 only.
+@nox.session(python="3.6")
+def pytype(session):
+    """Run type-checking."""
+    session.install(
+        ".", "grpcio >= 1.8.2", "grpcio-gcp >= 0.2.2", "pytype >= 2019.3.21"
+    )
+    session.run("pytype")
+
+
+@nox.session(python="3.6")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install(".", "grpcio >= 1.8.2", "grpcio-gcp >= 0.2.2")
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
\ No newline at end of file
diff --git a/api_core/setup.cfg b/api_core/setup.cfg
new file mode 100644
index 000000000000..5c32e1664d2c
--- /dev/null
+++ b/api_core/setup.cfg
@@ -0,0 +1,12 @@
+[bdist_wheel]
+universal = 1
+
+[pytype]
+python_version = 3.6
+inputs =
+    google/
+exclude =
+    tests/
+output = pytype_output/
+# Workaround for https://github.com/google/pytype/issues/150
+disable = pyi-error
diff --git a/api_core/setup.py b/api_core/setup.py
new file mode 100644
index 000000000000..25b7072d91f2
--- /dev/null
+++ b/api_core/setup.py
@@ -0,0 +1,99 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-api-core"
+description = "Google API client core library"
+version = "1.14.2"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "googleapis-common-protos >= 1.6.0, < 2.0dev",
+    "protobuf >= 3.4.0",
+    "google-auth >= 0.4.0, < 2.0dev",
+    "requests >= 2.18.0, < 3.0.0dev",
+    "setuptools >= 34.0.0",
+    "six >= 1.10.0",
+    "pytz",
+    'futures >= 3.2.0; python_version < "3.2"',
+]
+extras = {
+    "grpc": "grpcio >= 1.8.2, < 2.0dev",
+    "grpcgcp": "grpcio-gcp >= 0.2.2",
+    "grpcio-gcp": "grpcio-gcp >= 0.2.2",
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/api_core/tests/__init__.py b/api_core/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/api_core/tests/unit/__init__.py b/api_core/tests/unit/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/api_core/tests/unit/future/__init__.py b/api_core/tests/unit/future/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/api_core/tests/unit/future/test__helpers.py b/api_core/tests/unit/future/test__helpers.py
new file mode 100644
index 000000000000..98afc599f84e
--- /dev/null
+++ b/api_core/tests/unit/future/test__helpers.py
@@ -0,0 +1,37 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import mock
+
+from google.api_core.future import _helpers
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start_deamon_thread(unused_thread):
+    deamon_thread = _helpers.start_daemon_thread(target=mock.sentinel.target)
+    assert deamon_thread.daemon is True
+
+
+def test_safe_invoke_callback():
+    callback = mock.Mock(spec=["__call__"], return_value=42)
+    result = _helpers.safe_invoke_callback(callback, "a", b="c")
+    assert result == 42
+    callback.assert_called_once_with("a", b="c")
+
+
+def test_safe_invoke_callback_exception():
+    callback = mock.Mock(spec=["__call__"], side_effect=ValueError())
+    result = _helpers.safe_invoke_callback(callback, "a", b="c")
+    assert result is None
+    callback.assert_called_once_with("a", b="c")
diff --git a/api_core/tests/unit/future/test_polling.py b/api_core/tests/unit/future/test_polling.py
new file mode 100644
index 000000000000..c67de064add5
--- /dev/null
+++ b/api_core/tests/unit/future/test_polling.py
@@ -0,0 +1,194 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import concurrent.futures
+import threading
+import time
+
+import mock
+import pytest
+
+from google.api_core import exceptions
+from google.api_core.future import polling
+
+
+class PollingFutureImpl(polling.PollingFuture):
+    def done(self):
+        return False
+
+    def cancel(self):
+        return True
+
+    def cancelled(self):
+        return False
+
+    def running(self):
+        return True
+
+
+def test_polling_future_constructor():
+    future = PollingFutureImpl()
+    assert not future.done()
+    assert not future.cancelled()
+    assert future.running()
+    assert future.cancel()
+
+
+def test_set_result():
+    future = PollingFutureImpl()
+    callback = mock.Mock()
+
+    future.set_result(1)
+
+    assert future.result() == 1
+    future.add_done_callback(callback)
+    callback.assert_called_once_with(future)
+
+
+def test_set_exception():
+    future = PollingFutureImpl()
+    exception = ValueError("meep")
+
+    future.set_exception(exception)
+
+    assert future.exception() == exception
+    with pytest.raises(ValueError):
+        future.result()
+
+    callback = mock.Mock()
+    future.add_done_callback(callback)
+    callback.assert_called_once_with(future)
+
+
+def test_invoke_callback_exception():
+    future = PollingFutureImplWithPoll()
+    future.set_result(42)
+
+    # This should not raise, despite the callback causing an exception.
+    callback = mock.Mock(side_effect=ValueError)
+    future.add_done_callback(callback)
+    callback.assert_called_once_with(future)
+
+
+class PollingFutureImplWithPoll(PollingFutureImpl):
+    def __init__(self):
+        super(PollingFutureImplWithPoll, self).__init__()
+        self.poll_count = 0
+        self.event = threading.Event()
+
+    def done(self):
+        self.poll_count += 1
+        self.event.wait()
+        self.set_result(42)
+        return True
+
+
+def test_result_with_polling():
+    future = PollingFutureImplWithPoll()
+
+    future.event.set()
+    result = future.result()
+
+    assert result == 42
+    assert future.poll_count == 1
+    # Repeated calls should not cause additional polling
+    assert future.result() == result
+    assert future.poll_count == 1
+
+
+class PollingFutureImplTimeout(PollingFutureImplWithPoll):
+    def done(self):
+        time.sleep(1)
+        return False
+
+
+def test_result_timeout():
+    future = PollingFutureImplTimeout()
+    with pytest.raises(concurrent.futures.TimeoutError):
+        future.result(timeout=1)
+
+
+def test_exception_timeout():
+    future = PollingFutureImplTimeout()
+    with pytest.raises(concurrent.futures.TimeoutError):
+        future.exception(timeout=1)
+
+
+class PollingFutureImplTransient(PollingFutureImplWithPoll):
+    def __init__(self, errors):
+        super(PollingFutureImplTransient, self).__init__()
+        self._errors = errors
+
+    def done(self):
+        if self._errors:
+            error, self._errors = self._errors[0], self._errors[1:]
+            raise error("testing")
+        self.poll_count += 1
+        self.set_result(42)
+        return True
+
+
+def test_result_transient_error():
+    future = PollingFutureImplTransient(
+        (
+            exceptions.TooManyRequests,
+            exceptions.InternalServerError,
+            exceptions.BadGateway,
+        )
+    )
+    result = future.result()
+    assert result == 42
+    assert future.poll_count == 1
+    # Repeated calls should not cause additional polling
+    assert future.result() == result
+    assert future.poll_count == 1
+
+
+def test_callback_background_thread():
+    future = PollingFutureImplWithPoll()
+    callback = mock.Mock()
+
+    future.add_done_callback(callback)
+
+    assert future._polling_thread is not None
+
+    # Give the thread a second to poll
+    time.sleep(1)
+    assert future.poll_count == 1
+
+    future.event.set()
+    future._polling_thread.join()
+
+    callback.assert_called_once_with(future)
+
+
+def test_double_callback_background_thread():
+    future = PollingFutureImplWithPoll()
+    callback = mock.Mock()
+    callback2 = mock.Mock()
+
+    future.add_done_callback(callback)
+    current_thread = future._polling_thread
+    assert current_thread is not None
+
+    # only one polling thread should be created.
+    future.add_done_callback(callback2)
+    assert future._polling_thread is current_thread
+
+    future.event.set()
+    future._polling_thread.join()
+
+    assert future.poll_count == 1
+    callback.assert_called_once_with(future)
+    callback2.assert_called_once_with(future)
diff --git a/api_core/tests/unit/gapic/test_client_info.py b/api_core/tests/unit/gapic/test_client_info.py
new file mode 100644
index 000000000000..64080ffdbccd
--- /dev/null
+++ b/api_core/tests/unit/gapic/test_client_info.py
@@ -0,0 +1,24 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from google.api_core.gapic_v1 import client_info
+
+
+def test_to_grpc_metadata():
+    info = client_info.ClientInfo()
+
+    metadata = info.to_grpc_metadata()
+
+    assert metadata == (client_info.METRICS_METADATA_KEY, info.to_user_agent())
diff --git a/api_core/tests/unit/gapic/test_config.py b/api_core/tests/unit/gapic/test_config.py
new file mode 100644
index 000000000000..1c15261da0dd
--- /dev/null
+++ b/api_core/tests/unit/gapic/test_config.py
@@ -0,0 +1,87 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.api_core import exceptions
+from google.api_core.gapic_v1 import config
+
+
+INTERFACE_CONFIG = {
+    "retry_codes": {
+        "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+        "other": ["FAILED_PRECONDITION"],
+        "non_idempotent": [],
+    },
+    "retry_params": {
+        "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.0,
+            "max_rpc_timeout_millis": 120000,
+            "total_timeout_millis": 600000,
+        },
+        "other": {
+            "initial_retry_delay_millis": 1000,
+            "retry_delay_multiplier": 1,
+            "max_retry_delay_millis": 1000,
+            "initial_rpc_timeout_millis": 1000,
+            "rpc_timeout_multiplier": 1,
+            "max_rpc_timeout_millis": 1000,
+            "total_timeout_millis": 1000,
+        },
+    },
+    "methods": {
+        "AnnotateVideo": {
+            "timeout_millis": 60000,
+            "retry_codes_name": "idempotent",
+            "retry_params_name": "default",
+        },
+        "Other": {
+            "timeout_millis": 60000,
+            "retry_codes_name": "other",
+            "retry_params_name": "other",
+        },
+        "Plain": {"timeout_millis": 30000},
+    },
+}
+
+
+def test_create_method_configs():
+    method_configs = config.parse_method_configs(INTERFACE_CONFIG)
+
+    retry, timeout = method_configs["AnnotateVideo"]
+    assert retry._predicate(exceptions.DeadlineExceeded(None))
+    assert retry._predicate(exceptions.ServiceUnavailable(None))
+    assert retry._initial == 1.0
+    assert retry._multiplier == 2.5
+    assert retry._maximum == 120.0
+    assert retry._deadline == 600.0
+    assert timeout._initial == 120.0
+    assert timeout._multiplier == 1.0
+    assert timeout._maximum == 120.0
+
+    retry, timeout = method_configs["Other"]
+    assert retry._predicate(exceptions.FailedPrecondition(None))
+    assert retry._initial == 1.0
+    assert retry._multiplier == 1.0
+    assert retry._maximum == 1.0
+    assert retry._deadline == 1.0
+    assert timeout._initial == 1.0
+    assert timeout._multiplier == 1.0
+    assert timeout._maximum == 1.0
+
+    retry, timeout = method_configs["Plain"]
+    assert retry is None
+    assert timeout._timeout == 30.0
diff --git a/api_core/tests/unit/gapic/test_method.py b/api_core/tests/unit/gapic/test_method.py
new file mode 100644
index 000000000000..0f9bee934924
--- /dev/null
+++ b/api_core/tests/unit/gapic/test_method.py
@@ -0,0 +1,216 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+
+import mock
+
+from google.api_core import exceptions
+from google.api_core import retry
+from google.api_core import timeout
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.method
+import google.api_core.page_iterator
+
+
+def _utcnow_monotonic():
+    curr_value = datetime.datetime.min
+    delta = datetime.timedelta(seconds=0.5)
+    while True:
+        yield curr_value
+        curr_value += delta
+
+
+def test_wrap_method_basic():
+    method = mock.Mock(spec=["__call__"], return_value=42)
+
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(method)
+
+    result = wrapped_method(1, 2, meep="moop")
+
+    assert result == 42
+    method.assert_called_once_with(1, 2, meep="moop", metadata=mock.ANY)
+
+    # Check that the default client info was specified in the metadata.
+    metadata = method.call_args[1]["metadata"]
+    assert len(metadata) == 1
+    client_info = google.api_core.gapic_v1.client_info.DEFAULT_CLIENT_INFO
+    user_agent_metadata = client_info.to_grpc_metadata()
+    assert user_agent_metadata in metadata
+
+
+def test_wrap_method_with_no_client_info():
+    method = mock.Mock(spec=["__call__"])
+
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, client_info=None
+    )
+
+    wrapped_method(1, 2, meep="moop")
+
+    method.assert_called_once_with(1, 2, meep="moop")
+
+
+def test_wrap_method_with_custom_client_info():
+    client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+        python_version=1,
+        grpc_version=2,
+        api_core_version=3,
+        gapic_version=4,
+        client_library_version=5,
+    )
+    method = mock.Mock(spec=["__call__"])
+
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, client_info=client_info
+    )
+
+    wrapped_method(1, 2, meep="moop")
+
+    method.assert_called_once_with(1, 2, meep="moop", metadata=mock.ANY)
+
+    # Check that the custom client info was specified in the metadata.
+    metadata = method.call_args[1]["metadata"]
+    assert client_info.to_grpc_metadata() in metadata
+
+
+def test_invoke_wrapped_method_with_metadata():
+    method = mock.Mock(spec=["__call__"])
+
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(method)
+
+    wrapped_method(mock.sentinel.request, metadata=[("a", "b")])
+
+    method.assert_called_once_with(mock.sentinel.request, metadata=mock.ANY)
+    metadata = method.call_args[1]["metadata"]
+    # Metadata should have two items: the client info metadata and our custom
+    # metadata.
+    assert len(metadata) == 2
+    assert ("a", "b") in metadata
+
+
+def test_invoke_wrapped_method_with_metadata_as_none():
+    method = mock.Mock(spec=["__call__"])
+
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(method)
+
+    wrapped_method(mock.sentinel.request, metadata=None)
+
+    method.assert_called_once_with(mock.sentinel.request, metadata=mock.ANY)
+    metadata = method.call_args[1]["metadata"]
+    # Metadata should have just one items: the client info metadata.
+    assert len(metadata) == 1
+
+
+@mock.patch("time.sleep")
+def test_wrap_method_with_default_retry_and_timeout(unusued_sleep):
+    method = mock.Mock(
+        spec=["__call__"], side_effect=[exceptions.InternalServerError(None), 42]
+    )
+    default_retry = retry.Retry()
+    default_timeout = timeout.ConstantTimeout(60)
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, default_retry, default_timeout
+    )
+
+    result = wrapped_method()
+
+    assert result == 42
+    assert method.call_count == 2
+    method.assert_called_with(timeout=60, metadata=mock.ANY)
+
+
+@mock.patch("time.sleep")
+def test_wrap_method_with_default_retry_and_timeout_using_sentinel(unusued_sleep):
+    method = mock.Mock(
+        spec=["__call__"], side_effect=[exceptions.InternalServerError(None), 42]
+    )
+    default_retry = retry.Retry()
+    default_timeout = timeout.ConstantTimeout(60)
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, default_retry, default_timeout
+    )
+
+    result = wrapped_method(
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+    )
+
+    assert result == 42
+    assert method.call_count == 2
+    method.assert_called_with(timeout=60, metadata=mock.ANY)
+
+
+@mock.patch("time.sleep")
+def test_wrap_method_with_overriding_retry_and_timeout(unusued_sleep):
+    method = mock.Mock(spec=["__call__"], side_effect=[exceptions.NotFound(None), 42])
+    default_retry = retry.Retry()
+    default_timeout = timeout.ConstantTimeout(60)
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, default_retry, default_timeout
+    )
+
+    result = wrapped_method(
+        retry=retry.Retry(retry.if_exception_type(exceptions.NotFound)),
+        timeout=timeout.ConstantTimeout(22),
+    )
+
+    assert result == 42
+    assert method.call_count == 2
+    method.assert_called_with(timeout=22, metadata=mock.ANY)
+
+
+@mock.patch("time.sleep")
+@mock.patch(
+    "google.api_core.datetime_helpers.utcnow",
+    side_effect=_utcnow_monotonic(),
+    autospec=True,
+)
+def test_wrap_method_with_overriding_retry_deadline(utcnow, unused_sleep):
+    method = mock.Mock(
+        spec=["__call__"],
+        side_effect=([exceptions.InternalServerError(None)] * 4) + [42],
+    )
+    default_retry = retry.Retry()
+    default_timeout = timeout.ExponentialTimeout(deadline=60)
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, default_retry, default_timeout
+    )
+
+    # Overriding only the retry's deadline should also override the timeout's
+    # deadline.
+    result = wrapped_method(retry=default_retry.with_deadline(30))
+
+    assert result == 42
+    timeout_args = [call[1]["timeout"] for call in method.call_args_list]
+    assert timeout_args == [5.0, 10.0, 20.0, 26.0, 25.0]
+    assert utcnow.call_count == (
+        1
+        + 5  # First to set the deadline.
+        + 5  # One for each min(timeout, maximum, (DEADLINE - NOW).seconds)
+    )
+
+
+def test_wrap_method_with_overriding_timeout_as_a_number():
+    method = mock.Mock(spec=["__call__"], return_value=42)
+    default_retry = retry.Retry()
+    default_timeout = timeout.ConstantTimeout(60)
+    wrapped_method = google.api_core.gapic_v1.method.wrap_method(
+        method, default_retry, default_timeout
+    )
+
+    result = wrapped_method(timeout=22)
+
+    assert result == 42
+    method.assert_called_once_with(timeout=22, metadata=mock.ANY)
diff --git a/api_core/tests/unit/gapic/test_routing_header.py b/api_core/tests/unit/gapic/test_routing_header.py
new file mode 100644
index 000000000000..77300e8739d7
--- /dev/null
+++ b/api_core/tests/unit/gapic/test_routing_header.py
@@ -0,0 +1,34 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from google.api_core.gapic_v1 import routing_header
+
+
+def test_to_routing_header():
+    params = [("name", "meep"), ("book.read", "1")]
+    value = routing_header.to_routing_header(params)
+    assert value == "name=meep&book.read=1"
+
+
+def test_to_routing_header_with_slashes():
+    params = [("name", "me/ep"), ("book.read", "1&2")]
+    value = routing_header.to_routing_header(params)
+    assert value == "name=me/ep&book.read=1%262"
+
+
+def test_to_grpc_metadata():
+    params = [("name", "meep"), ("book.read", "1")]
+    metadata = routing_header.to_grpc_metadata(params)
+    assert metadata == (routing_header.ROUTING_METADATA_KEY, "name=meep&book.read=1")
diff --git a/api_core/tests/unit/operations_v1/__init__.py b/api_core/tests/unit/operations_v1/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/api_core/tests/unit/operations_v1/test_operations_client.py b/api_core/tests/unit/operations_v1/test_operations_client.py
new file mode 100644
index 000000000000..cc5746123cc0
--- /dev/null
+++ b/api_core/tests/unit/operations_v1/test_operations_client.py
@@ -0,0 +1,75 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.api_core import grpc_helpers
+from google.api_core import operations_v1
+from google.api_core import page_iterator
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+def test_get_operation():
+    channel = grpc_helpers.ChannelStub()
+    client = operations_v1.OperationsClient(channel)
+    channel.GetOperation.response = operations_pb2.Operation(name="meep")
+
+    response = client.get_operation("name")
+
+    assert len(channel.GetOperation.requests) == 1
+    assert channel.GetOperation.requests[0].name == "name"
+    assert response == channel.GetOperation.response
+
+
+def test_list_operations():
+    channel = grpc_helpers.ChannelStub()
+    client = operations_v1.OperationsClient(channel)
+    operations = [
+        operations_pb2.Operation(name="1"),
+        operations_pb2.Operation(name="2"),
+    ]
+    list_response = operations_pb2.ListOperationsResponse(operations=operations)
+    channel.ListOperations.response = list_response
+
+    response = client.list_operations("name", "filter")
+
+    assert isinstance(response, page_iterator.Iterator)
+    assert list(response) == operations
+
+    assert len(channel.ListOperations.requests) == 1
+    request = channel.ListOperations.requests[0]
+    assert isinstance(request, operations_pb2.ListOperationsRequest)
+    assert request.name == "name"
+    assert request.filter == "filter"
+
+
+def test_delete_operation():
+    channel = grpc_helpers.ChannelStub()
+    client = operations_v1.OperationsClient(channel)
+    channel.DeleteOperation.response = empty_pb2.Empty()
+
+    client.delete_operation("name")
+
+    assert len(channel.DeleteOperation.requests) == 1
+    assert channel.DeleteOperation.requests[0].name == "name"
+
+
+def test_cancel_operation():
+    channel = grpc_helpers.ChannelStub()
+    client = operations_v1.OperationsClient(channel)
+    channel.CancelOperation.response = empty_pb2.Empty()
+
+    client.cancel_operation("name")
+
+    assert len(channel.CancelOperation.requests) == 1
+    assert channel.CancelOperation.requests[0].name == "name"
diff --git a/api_core/tests/unit/test_bidi.py b/api_core/tests/unit/test_bidi.py
new file mode 100644
index 000000000000..4d185d3158e4
--- /dev/null
+++ b/api_core/tests/unit/test_bidi.py
@@ -0,0 +1,847 @@
+# Copyright 2018, Google LLC 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.
+
+import datetime
+import logging
+import threading
+
+import grpc
+import mock
+import pytest
+from six.moves import queue
+
+from google.api_core import bidi
+from google.api_core import exceptions
+
+
+class Test_RequestQueueGenerator(object):
+    def test_bounded_consume(self):
+        call = mock.create_autospec(grpc.Call, instance=True)
+        call.is_active.return_value = True
+
+        def queue_generator(rpc):
+            yield mock.sentinel.A
+            yield queue.Empty()
+            yield mock.sentinel.B
+            rpc.is_active.return_value = False
+            yield mock.sentinel.C
+
+        q = mock.create_autospec(queue.Queue, instance=True)
+        q.get.side_effect = queue_generator(call)
+
+        generator = bidi._RequestQueueGenerator(q)
+        generator.call = call
+
+        items = list(generator)
+
+        assert items == [mock.sentinel.A, mock.sentinel.B]
+
+    def test_yield_initial_and_exit(self):
+        q = mock.create_autospec(queue.Queue, instance=True)
+        q.get.side_effect = queue.Empty()
+        call = mock.create_autospec(grpc.Call, instance=True)
+        call.is_active.return_value = False
+
+        generator = bidi._RequestQueueGenerator(q, initial_request=mock.sentinel.A)
+        generator.call = call
+
+        items = list(generator)
+
+        assert items == [mock.sentinel.A]
+
+    def test_yield_initial_callable_and_exit(self):
+        q = mock.create_autospec(queue.Queue, instance=True)
+        q.get.side_effect = queue.Empty()
+        call = mock.create_autospec(grpc.Call, instance=True)
+        call.is_active.return_value = False
+
+        generator = bidi._RequestQueueGenerator(
+            q, initial_request=lambda: mock.sentinel.A
+        )
+        generator.call = call
+
+        items = list(generator)
+
+        assert items == [mock.sentinel.A]
+
+    def test_exit_when_inactive_with_item(self):
+        q = mock.create_autospec(queue.Queue, instance=True)
+        q.get.side_effect = [mock.sentinel.A, queue.Empty()]
+        call = mock.create_autospec(grpc.Call, instance=True)
+        call.is_active.return_value = False
+
+        generator = bidi._RequestQueueGenerator(q)
+        generator.call = call
+
+        items = list(generator)
+
+        assert items == []
+        # Make sure it put the item back.
+        q.put.assert_called_once_with(mock.sentinel.A)
+
+    def test_exit_when_inactive_empty(self):
+        q = mock.create_autospec(queue.Queue, instance=True)
+        q.get.side_effect = queue.Empty()
+        call = mock.create_autospec(grpc.Call, instance=True)
+        call.is_active.return_value = False
+
+        generator = bidi._RequestQueueGenerator(q)
+        generator.call = call
+
+        items = list(generator)
+
+        assert items == []
+
+    def test_exit_with_stop(self):
+        q = mock.create_autospec(queue.Queue, instance=True)
+        q.get.side_effect = [None, queue.Empty()]
+        call = mock.create_autospec(grpc.Call, instance=True)
+        call.is_active.return_value = True
+
+        generator = bidi._RequestQueueGenerator(q)
+        generator.call = call
+
+        items = list(generator)
+
+        assert items == []
+
+
+class Test_Throttle(object):
+    def test_repr(self):
+        delta = datetime.timedelta(seconds=4.5)
+        instance = bidi._Throttle(access_limit=42, time_window=delta)
+        assert repr(instance) == \
+            "_Throttle(access_limit=42, time_window={})".format(repr(delta))
+
+    def test_raises_error_on_invalid_init_arguments(self):
+        with pytest.raises(ValueError) as exc_info:
+            bidi._Throttle(
+                access_limit=10, time_window=datetime.timedelta(seconds=0.0)
+            )
+        assert "time_window" in str(exc_info.value)
+        assert "must be a positive timedelta" in str(exc_info.value)
+
+        with pytest.raises(ValueError) as exc_info:
+            bidi._Throttle(
+                access_limit=0, time_window=datetime.timedelta(seconds=10)
+            )
+        assert "access_limit" in str(exc_info.value)
+        assert "must be positive" in str(exc_info.value)
+
+    def test_does_not_delay_entry_attempts_under_threshold(self):
+        throttle = bidi._Throttle(
+            access_limit=3, time_window=datetime.timedelta(seconds=1)
+        )
+        entries = []
+
+        for _ in range(3):
+            with throttle as time_waited:
+                entry_info = {
+                    "entered_at": datetime.datetime.now(),
+                    "reported_wait": time_waited,
+                }
+                entries.append(entry_info)
+
+        # check the reported wait times ...
+        assert all(entry["reported_wait"] == 0.0 for entry in entries)
+
+        # .. and the actual wait times
+        delta = entries[1]["entered_at"] - entries[0]["entered_at"]
+        assert delta.total_seconds() < 0.1
+        delta = entries[2]["entered_at"] - entries[1]["entered_at"]
+        assert delta.total_seconds() < 0.1
+
+    def test_delays_entry_attempts_above_threshold(self):
+        throttle = bidi._Throttle(
+            access_limit=3, time_window=datetime.timedelta(seconds=1)
+        )
+        entries = []
+
+        for _ in range(6):
+            with throttle as time_waited:
+                entry_info = {
+                    "entered_at": datetime.datetime.now(),
+                    "reported_wait": time_waited,
+                }
+                entries.append(entry_info)
+
+        # For each group of 4 consecutive entries the time difference between
+        # the first and the last entry must have been greater than time_window,
+        # because a maximum of 3 are allowed in each time_window.
+        for i, entry in enumerate(entries[3:], start=3):
+            first_entry = entries[i - 3]
+            delta = entry["entered_at"] - first_entry["entered_at"]
+            assert delta.total_seconds() > 1.0
+
+        # check the reported wait times
+        # (NOTE: not using assert all(...), b/c the coverage check would complain)
+        for i, entry in enumerate(entries):
+            if i != 3:
+                assert entry["reported_wait"] == 0.0
+
+        # The delayed entry is expected to have been delayed for a significant
+        # chunk of the full second, and the actual and reported delay times
+        # should reflect that.
+        assert entries[3]["reported_wait"] > 0.7
+        delta = entries[3]["entered_at"] - entries[2]["entered_at"]
+        assert delta.total_seconds() > 0.7
+
+
+class _CallAndFuture(grpc.Call, grpc.Future):
+    pass
+
+
+def make_rpc():
+    """Makes a mock RPC used to test Bidi classes."""
+    call = mock.create_autospec(_CallAndFuture, instance=True)
+    rpc = mock.create_autospec(grpc.StreamStreamMultiCallable, instance=True)
+
+    def rpc_side_effect(request, metadata=None):
+        call.is_active.return_value = True
+        call.request = request
+        call.metadata = metadata
+        return call
+
+    rpc.side_effect = rpc_side_effect
+
+    def cancel_side_effect():
+        call.is_active.return_value = False
+
+    call.cancel.side_effect = cancel_side_effect
+
+    return rpc, call
+
+
+class ClosedCall(object):
+    # NOTE: This is needed because defining `.next` on an **instance**
+    #       rather than the **class** will not be iterable in Python 2.
+    #       This is problematic since a `Mock` just sets members.
+
+    def __init__(self, exception):
+        self.exception = exception
+
+    def __next__(self):
+        raise self.exception
+
+    next = __next__  # Python 2
+
+    def is_active(self):
+        return False
+
+
+class TestBidiRpc(object):
+    def test_initial_state(self):
+        bidi_rpc = bidi.BidiRpc(None)
+
+        assert bidi_rpc.is_active is False
+
+    def test_done_callbacks(self):
+        bidi_rpc = bidi.BidiRpc(None)
+        callback = mock.Mock(spec=["__call__"])
+
+        bidi_rpc.add_done_callback(callback)
+        bidi_rpc._on_call_done(mock.sentinel.future)
+
+        callback.assert_called_once_with(mock.sentinel.future)
+
+    def test_metadata(self):
+        rpc, call = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc, metadata=mock.sentinel.A)
+        assert bidi_rpc._rpc_metadata == mock.sentinel.A
+
+        bidi_rpc.open()
+        assert bidi_rpc.call == call
+        assert bidi_rpc.call.metadata == mock.sentinel.A
+
+    def test_open(self):
+        rpc, call = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc)
+
+        bidi_rpc.open()
+
+        assert bidi_rpc.call == call
+        assert bidi_rpc.is_active
+        call.add_done_callback.assert_called_once_with(bidi_rpc._on_call_done)
+
+    def test_open_error_already_open(self):
+        rpc, _ = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc)
+
+        bidi_rpc.open()
+
+        with pytest.raises(ValueError):
+            bidi_rpc.open()
+
+    def test_close(self):
+        rpc, call = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc)
+        bidi_rpc.open()
+
+        bidi_rpc.close()
+
+        call.cancel.assert_called_once()
+        assert bidi_rpc.call == call
+        assert bidi_rpc.is_active is False
+        # ensure the request queue was signaled to stop.
+        assert bidi_rpc.pending_requests == 1
+        assert bidi_rpc._request_queue.get() is None
+
+    def test_close_no_rpc(self):
+        bidi_rpc = bidi.BidiRpc(None)
+        bidi_rpc.close()
+
+    def test_send(self):
+        rpc, call = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc)
+        bidi_rpc.open()
+
+        bidi_rpc.send(mock.sentinel.request)
+
+        assert bidi_rpc.pending_requests == 1
+        assert bidi_rpc._request_queue.get() is mock.sentinel.request
+
+    def test_send_not_open(self):
+        rpc, call = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc)
+
+        with pytest.raises(ValueError):
+            bidi_rpc.send(mock.sentinel.request)
+
+    def test_send_dead_rpc(self):
+        error = ValueError()
+        bidi_rpc = bidi.BidiRpc(None)
+        bidi_rpc.call = ClosedCall(error)
+
+        with pytest.raises(ValueError) as exc_info:
+            bidi_rpc.send(mock.sentinel.request)
+
+        assert exc_info.value == error
+
+    def test_recv(self):
+        bidi_rpc = bidi.BidiRpc(None)
+        bidi_rpc.call = iter([mock.sentinel.response])
+
+        response = bidi_rpc.recv()
+
+        assert response == mock.sentinel.response
+
+    def test_recv_not_open(self):
+        rpc, call = make_rpc()
+        bidi_rpc = bidi.BidiRpc(rpc)
+
+        with pytest.raises(ValueError):
+            bidi_rpc.recv()
+
+
+class CallStub(object):
+    def __init__(self, values, active=True):
+        self.values = iter(values)
+        self._is_active = active
+        self.cancelled = False
+
+    def __next__(self):
+        item = next(self.values)
+        if isinstance(item, Exception):
+            self._is_active = False
+            raise item
+        return item
+
+    next = __next__  # Python 2
+
+    def is_active(self):
+        return self._is_active
+
+    def add_done_callback(self, callback):
+        pass
+
+    def cancel(self):
+        self.cancelled = True
+
+
+class TestResumableBidiRpc(object):
+    def test_ctor_defaults(self):
+        start_rpc = mock.Mock()
+        should_recover = mock.Mock()
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+
+        assert bidi_rpc.is_active is False
+        assert bidi_rpc._finalized is False
+        assert bidi_rpc._start_rpc is start_rpc
+        assert bidi_rpc._should_recover is should_recover
+        assert bidi_rpc._should_terminate is bidi._never_terminate
+        assert bidi_rpc._initial_request is None
+        assert bidi_rpc._rpc_metadata is None
+        assert bidi_rpc._reopen_throttle is None
+
+    def test_ctor_explicit(self):
+        start_rpc = mock.Mock()
+        should_recover = mock.Mock()
+        should_terminate = mock.Mock()
+        initial_request = mock.Mock()
+        metadata = {"x-foo": "bar"}
+        bidi_rpc = bidi.ResumableBidiRpc(
+            start_rpc,
+            should_recover,
+            should_terminate=should_terminate,
+            initial_request=initial_request,
+            metadata=metadata,
+            throttle_reopen=True,
+        )
+
+        assert bidi_rpc.is_active is False
+        assert bidi_rpc._finalized is False
+        assert bidi_rpc._should_recover is should_recover
+        assert bidi_rpc._should_terminate is should_terminate
+        assert bidi_rpc._initial_request is initial_request
+        assert bidi_rpc._rpc_metadata == metadata
+        assert isinstance(bidi_rpc._reopen_throttle, bidi._Throttle)
+
+    def test_done_callbacks_terminate(self):
+        cancellation = mock.Mock()
+        start_rpc = mock.Mock()
+        should_recover = mock.Mock(spec=["__call__"], return_value=True)
+        should_terminate = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(
+            start_rpc, should_recover, should_terminate=should_terminate
+        )
+        callback = mock.Mock(spec=["__call__"])
+
+        bidi_rpc.add_done_callback(callback)
+        bidi_rpc._on_call_done(cancellation)
+
+        should_terminate.assert_called_once_with(cancellation)
+        should_recover.assert_not_called()
+        callback.assert_called_once_with(cancellation)
+        assert not bidi_rpc.is_active
+
+    def test_done_callbacks_recoverable(self):
+        start_rpc = mock.create_autospec(grpc.StreamStreamMultiCallable, instance=True)
+        should_recover = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+        callback = mock.Mock(spec=["__call__"])
+
+        bidi_rpc.add_done_callback(callback)
+        bidi_rpc._on_call_done(mock.sentinel.future)
+
+        callback.assert_not_called()
+        start_rpc.assert_called_once()
+        should_recover.assert_called_once_with(mock.sentinel.future)
+        assert bidi_rpc.is_active
+
+    def test_done_callbacks_non_recoverable(self):
+        start_rpc = mock.create_autospec(grpc.StreamStreamMultiCallable, instance=True)
+        should_recover = mock.Mock(spec=["__call__"], return_value=False)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+        callback = mock.Mock(spec=["__call__"])
+
+        bidi_rpc.add_done_callback(callback)
+        bidi_rpc._on_call_done(mock.sentinel.future)
+
+        callback.assert_called_once_with(mock.sentinel.future)
+        should_recover.assert_called_once_with(mock.sentinel.future)
+        assert not bidi_rpc.is_active
+
+    def test_send_terminate(self):
+        cancellation = ValueError()
+        call_1 = CallStub([cancellation], active=False)
+        call_2 = CallStub([])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, side_effect=[call_1, call_2]
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=False)
+        should_terminate = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover, should_terminate=should_terminate)
+
+        bidi_rpc.open()
+
+        bidi_rpc.send(mock.sentinel.request)
+
+        assert bidi_rpc.pending_requests == 1
+        assert bidi_rpc._request_queue.get() is None
+
+        should_recover.assert_not_called()
+        should_terminate.assert_called_once_with(cancellation)
+        assert bidi_rpc.call == call_1
+        assert bidi_rpc.is_active is False
+        assert call_1.cancelled is True
+
+    def test_send_recover(self):
+        error = ValueError()
+        call_1 = CallStub([error], active=False)
+        call_2 = CallStub([])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, side_effect=[call_1, call_2]
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+
+        bidi_rpc.open()
+
+        bidi_rpc.send(mock.sentinel.request)
+
+        assert bidi_rpc.pending_requests == 1
+        assert bidi_rpc._request_queue.get() is mock.sentinel.request
+
+        should_recover.assert_called_once_with(error)
+        assert bidi_rpc.call == call_2
+        assert bidi_rpc.is_active is True
+
+    def test_send_failure(self):
+        error = ValueError()
+        call = CallStub([error], active=False)
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, return_value=call
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=False)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+
+        bidi_rpc.open()
+
+        with pytest.raises(ValueError) as exc_info:
+            bidi_rpc.send(mock.sentinel.request)
+
+        assert exc_info.value == error
+        should_recover.assert_called_once_with(error)
+        assert bidi_rpc.call == call
+        assert bidi_rpc.is_active is False
+        assert call.cancelled is True
+        assert bidi_rpc.pending_requests == 1
+        assert bidi_rpc._request_queue.get() is None
+
+    def test_recv_terminate(self):
+        cancellation = ValueError()
+        call = CallStub([cancellation])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, return_value=call
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=False)
+        should_terminate = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover, should_terminate=should_terminate)
+
+        bidi_rpc.open()
+
+        bidi_rpc.recv()
+
+        should_recover.assert_not_called()
+        should_terminate.assert_called_once_with(cancellation)
+        assert bidi_rpc.call == call
+        assert bidi_rpc.is_active is False
+        assert call.cancelled is True
+
+    def test_recv_recover(self):
+        error = ValueError()
+        call_1 = CallStub([1, error])
+        call_2 = CallStub([2, 3])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, side_effect=[call_1, call_2]
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+
+        bidi_rpc.open()
+
+        values = []
+        for n in range(3):
+            values.append(bidi_rpc.recv())
+
+        assert values == [1, 2, 3]
+        should_recover.assert_called_once_with(error)
+        assert bidi_rpc.call == call_2
+        assert bidi_rpc.is_active is True
+
+    def test_recv_recover_already_recovered(self):
+        call_1 = CallStub([])
+        call_2 = CallStub([])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, side_effect=[call_1, call_2]
+        )
+        callback = mock.Mock()
+        callback.return_value = True
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, callback)
+
+        bidi_rpc.open()
+
+        bidi_rpc._reopen()
+
+        assert bidi_rpc.call is call_1
+        assert bidi_rpc.is_active is True
+
+    def test_recv_failure(self):
+        error = ValueError()
+        call = CallStub([error])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, return_value=call
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=False)
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+
+        bidi_rpc.open()
+
+        with pytest.raises(ValueError) as exc_info:
+            bidi_rpc.recv()
+
+        assert exc_info.value == error
+        should_recover.assert_called_once_with(error)
+        assert bidi_rpc.call == call
+        assert bidi_rpc.is_active is False
+        assert call.cancelled is True
+
+    def test_reopen_failure_on_rpc_restart(self):
+        error1 = ValueError("1")
+        error2 = ValueError("2")
+        call = CallStub([error1])
+        # Invoking start RPC a second time will trigger an error.
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, side_effect=[call, error2]
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=True)
+        callback = mock.Mock(spec=["__call__"])
+
+        bidi_rpc = bidi.ResumableBidiRpc(start_rpc, should_recover)
+        bidi_rpc.add_done_callback(callback)
+
+        bidi_rpc.open()
+
+        with pytest.raises(ValueError) as exc_info:
+            bidi_rpc.recv()
+
+        assert exc_info.value == error2
+        should_recover.assert_called_once_with(error1)
+        assert bidi_rpc.call is None
+        assert bidi_rpc.is_active is False
+        callback.assert_called_once_with(error2)
+
+    def test_using_throttle_on_reopen_requests(self):
+        call = CallStub([])
+        start_rpc = mock.create_autospec(
+            grpc.StreamStreamMultiCallable, instance=True, return_value=call
+        )
+        should_recover = mock.Mock(spec=["__call__"], return_value=True)
+        bidi_rpc = bidi.ResumableBidiRpc(
+            start_rpc, should_recover, throttle_reopen=True
+        )
+
+        patcher = mock.patch.object(bidi_rpc._reopen_throttle.__class__, "__enter__")
+        with patcher as mock_enter:
+            bidi_rpc._reopen()
+
+        mock_enter.assert_called_once()
+
+    def test_send_not_open(self):
+        bidi_rpc = bidi.ResumableBidiRpc(None, lambda _: False)
+
+        with pytest.raises(ValueError):
+            bidi_rpc.send(mock.sentinel.request)
+
+    def test_recv_not_open(self):
+        bidi_rpc = bidi.ResumableBidiRpc(None, lambda _: False)
+
+        with pytest.raises(ValueError):
+            bidi_rpc.recv()
+
+    def test_finalize_idempotent(self):
+        error1 = ValueError("1")
+        error2 = ValueError("2")
+        callback = mock.Mock(spec=["__call__"])
+        should_recover = mock.Mock(spec=["__call__"], return_value=False)
+
+        bidi_rpc = bidi.ResumableBidiRpc(mock.sentinel.start_rpc, should_recover)
+
+        bidi_rpc.add_done_callback(callback)
+
+        bidi_rpc._on_call_done(error1)
+        bidi_rpc._on_call_done(error2)
+
+        callback.assert_called_once_with(error1)
+
+
+class TestBackgroundConsumer(object):
+    def test_consume_once_then_exit(self):
+        bidi_rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+        bidi_rpc.is_active = True
+        bidi_rpc.recv.side_effect = [mock.sentinel.response_1]
+        recved = threading.Event()
+
+        def on_response(response):
+            assert response == mock.sentinel.response_1
+            bidi_rpc.is_active = False
+            recved.set()
+
+        consumer = bidi.BackgroundConsumer(bidi_rpc, on_response)
+
+        consumer.start()
+
+        recved.wait()
+
+        bidi_rpc.recv.assert_called_once()
+        assert bidi_rpc.is_active is False
+
+        consumer.stop()
+
+        bidi_rpc.close.assert_called_once()
+        assert consumer.is_active is False
+
+    def test_pause_resume_and_close(self):
+        # This test is relatively complex. It attempts to start the consumer,
+        # consume one item, pause the consumer, check the state of the world,
+        # then resume the consumer. Doing this in a deterministic fashion
+        # requires a bit more mocking and patching than usual.
+
+        bidi_rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+        bidi_rpc.is_active = True
+
+        def close_side_effect():
+            bidi_rpc.is_active = False
+
+        bidi_rpc.close.side_effect = close_side_effect
+
+        # These are used to coordinate the two threads to ensure deterministic
+        # execution.
+        should_continue = threading.Event()
+        responses_and_events = {
+            mock.sentinel.response_1: threading.Event(),
+            mock.sentinel.response_2: threading.Event(),
+        }
+        bidi_rpc.recv.side_effect = [mock.sentinel.response_1, mock.sentinel.response_2]
+
+        recved_responses = []
+        consumer = None
+
+        def on_response(response):
+            if response == mock.sentinel.response_1:
+                consumer.pause()
+
+            recved_responses.append(response)
+            responses_and_events[response].set()
+            should_continue.wait()
+
+        consumer = bidi.BackgroundConsumer(bidi_rpc, on_response)
+
+        consumer.start()
+
+        # Wait for the first response to be recved.
+        responses_and_events[mock.sentinel.response_1].wait()
+
+        # Ensure only one item has been recved and that the consumer is paused.
+        assert recved_responses == [mock.sentinel.response_1]
+        assert consumer.is_paused is True
+        assert consumer.is_active is True
+
+        # Unpause the consumer, wait for the second item, then close the
+        # consumer.
+        should_continue.set()
+        consumer.resume()
+
+        responses_and_events[mock.sentinel.response_2].wait()
+
+        assert recved_responses == [mock.sentinel.response_1, mock.sentinel.response_2]
+
+        consumer.stop()
+
+        assert consumer.is_active is False
+
+    def test_wake_on_error(self):
+        should_continue = threading.Event()
+
+        bidi_rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+        bidi_rpc.is_active = True
+        bidi_rpc.add_done_callback.side_effect = lambda _: should_continue.set()
+
+        consumer = bidi.BackgroundConsumer(bidi_rpc, mock.sentinel.on_response)
+
+        # Start the consumer paused, which should immediately put it into wait
+        # state.
+        consumer.pause()
+        consumer.start()
+
+        # Wait for add_done_callback to be called
+        should_continue.wait()
+        bidi_rpc.add_done_callback.assert_called_once_with(consumer._on_call_done)
+
+        # The consumer should now be blocked on waiting to be unpaused.
+        assert consumer.is_active
+        assert consumer.is_paused
+
+        # Trigger the done callback, it should unpause the consumer and cause
+        # it to exit.
+        bidi_rpc.is_active = False
+        consumer._on_call_done(bidi_rpc)
+
+        # It may take a few cycles for the thread to exit.
+        while consumer.is_active:
+            pass
+
+    def test_consumer_expected_error(self, caplog):
+        caplog.set_level(logging.DEBUG)
+
+        bidi_rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+        bidi_rpc.is_active = True
+        bidi_rpc.recv.side_effect = exceptions.ServiceUnavailable("Gone away")
+
+        on_response = mock.Mock(spec=["__call__"])
+
+        consumer = bidi.BackgroundConsumer(bidi_rpc, on_response)
+
+        consumer.start()
+
+        # Wait for the consumer's thread to exit.
+        while consumer.is_active:
+            pass
+
+        on_response.assert_not_called()
+        bidi_rpc.recv.assert_called_once()
+        assert "caught error" in caplog.text
+
+    def test_consumer_unexpected_error(self, caplog):
+        caplog.set_level(logging.DEBUG)
+
+        bidi_rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+        bidi_rpc.is_active = True
+        bidi_rpc.recv.side_effect = ValueError()
+
+        on_response = mock.Mock(spec=["__call__"])
+
+        consumer = bidi.BackgroundConsumer(bidi_rpc, on_response)
+
+        consumer.start()
+
+        # Wait for the consumer's thread to exit.
+        while consumer.is_active:
+            pass
+
+        on_response.assert_not_called()
+        bidi_rpc.recv.assert_called_once()
+        assert "caught unexpected exception" in caplog.text
+
+    def test_double_stop(self, caplog):
+        caplog.set_level(logging.DEBUG)
+        bidi_rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+        bidi_rpc.is_active = True
+        on_response = mock.Mock(spec=["__call__"])
+
+        def close_side_effect():
+            bidi_rpc.is_active = False
+
+        bidi_rpc.close.side_effect = close_side_effect
+
+        consumer = bidi.BackgroundConsumer(bidi_rpc, on_response)
+
+        consumer.start()
+        assert consumer.is_active is True
+
+        consumer.stop()
+        assert consumer.is_active is False
+
+        # calling stop twice should not result in an error.
+        consumer.stop()
diff --git a/api_core/tests/unit/test_client_info.py b/api_core/tests/unit/test_client_info.py
new file mode 100644
index 000000000000..0eb17c5feb1c
--- /dev/null
+++ b/api_core/tests/unit/test_client_info.py
@@ -0,0 +1,69 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from google.api_core import client_info
+
+
+def test_constructor_defaults():
+    info = client_info.ClientInfo()
+
+    assert info.python_version is not None
+    assert info.grpc_version is not None
+    assert info.api_core_version is not None
+    assert info.gapic_version is None
+    assert info.client_library_version is None
+
+
+def test_constructor_options():
+    info = client_info.ClientInfo(
+        python_version="1",
+        grpc_version="2",
+        api_core_version="3",
+        gapic_version="4",
+        client_library_version="5",
+        user_agent="6"
+    )
+
+    assert info.python_version == "1"
+    assert info.grpc_version == "2"
+    assert info.api_core_version == "3"
+    assert info.gapic_version == "4"
+    assert info.client_library_version == "5"
+    assert info.user_agent == "6"
+
+
+def test_to_user_agent_minimal():
+    info = client_info.ClientInfo(
+        python_version="1", api_core_version="2", grpc_version=None
+    )
+
+    user_agent = info.to_user_agent()
+
+    assert user_agent == "gl-python/1 gax/2"
+
+
+def test_to_user_agent_full():
+    info = client_info.ClientInfo(
+        python_version="1",
+        grpc_version="2",
+        api_core_version="3",
+        gapic_version="4",
+        client_library_version="5",
+        user_agent="app-name/1.0",
+    )
+
+    user_agent = info.to_user_agent()
+
+    assert user_agent == "app-name/1.0 gl-python/1 grpc/2 gax/3 gapic/4 gccl/5"
diff --git a/api_core/tests/unit/test_client_options.py b/api_core/tests/unit/test_client_options.py
new file mode 100644
index 000000000000..14cae9f24bfb
--- /dev/null
+++ b/api_core/tests/unit/test_client_options.py
@@ -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.
+
+import pytest
+
+from google.api_core import client_options
+
+
+def test_constructor():
+    options = client_options.ClientOptions(api_endpoint="foo.googleapis.com")
+
+    assert options.api_endpoint == "foo.googleapis.com"
+
+
+def test_from_dict():
+    options = client_options.from_dict({"api_endpoint": "foo.googleapis.com"})
+
+    assert options.api_endpoint == "foo.googleapis.com"
+
+
+def test_from_dict_bad_argument():
+    with pytest.raises(ValueError):
+        client_options.from_dict(
+            {"api_endpoint": "foo.googleapis.com", "bad_arg": "1234"}
+        )
diff --git a/api_core/tests/unit/test_datetime_helpers.py b/api_core/tests/unit/test_datetime_helpers.py
new file mode 100644
index 000000000000..4d138c88a80c
--- /dev/null
+++ b/api_core/tests/unit/test_datetime_helpers.py
@@ -0,0 +1,351 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import calendar
+import datetime
+
+import pytest
+import pytz
+
+from google.api_core import datetime_helpers
+from google.protobuf import timestamp_pb2
+
+
+ONE_MINUTE_IN_MICROSECONDS = 60 * 1e6
+
+
+def test_utcnow():
+    result = datetime_helpers.utcnow()
+    assert isinstance(result, datetime.datetime)
+
+
+def test_to_milliseconds():
+    dt = datetime.datetime(1970, 1, 1, 0, 0, 1, tzinfo=pytz.utc)
+    assert datetime_helpers.to_milliseconds(dt) == 1000
+
+
+def test_to_microseconds():
+    microseconds = 314159
+    dt = datetime.datetime(1970, 1, 1, 0, 0, 0, microsecond=microseconds)
+    assert datetime_helpers.to_microseconds(dt) == microseconds
+
+
+def test_to_microseconds_non_utc():
+    zone = pytz.FixedOffset(-1)
+    dt = datetime.datetime(1970, 1, 1, 0, 0, 0, tzinfo=zone)
+    assert datetime_helpers.to_microseconds(dt) == ONE_MINUTE_IN_MICROSECONDS
+
+
+def test_to_microseconds_naive():
+    microseconds = 314159
+    dt = datetime.datetime(1970, 1, 1, 0, 0, 0, microsecond=microseconds, tzinfo=None)
+    assert datetime_helpers.to_microseconds(dt) == microseconds
+
+
+def test_from_microseconds():
+    five_mins_from_epoch_in_microseconds = 5 * ONE_MINUTE_IN_MICROSECONDS
+    five_mins_from_epoch_datetime = datetime.datetime(
+        1970, 1, 1, 0, 5, 0, tzinfo=pytz.utc
+    )
+
+    result = datetime_helpers.from_microseconds(five_mins_from_epoch_in_microseconds)
+
+    assert result == five_mins_from_epoch_datetime
+
+
+def test_from_iso8601_date():
+    today = datetime.date.today()
+    iso_8601_today = today.strftime("%Y-%m-%d")
+
+    assert datetime_helpers.from_iso8601_date(iso_8601_today) == today
+
+
+def test_from_iso8601_time():
+    assert datetime_helpers.from_iso8601_time("12:09:42") == datetime.time(12, 9, 42)
+
+
+def test_from_rfc3339():
+    value = "2009-12-17T12:44:32.123456Z"
+    assert datetime_helpers.from_rfc3339(value) == datetime.datetime(
+        2009, 12, 17, 12, 44, 32, 123456, pytz.utc
+    )
+
+
+def test_from_rfc3339_with_bad_tz():
+    value = "2009-12-17T12:44:32.123456BAD"
+
+    with pytest.raises(ValueError):
+        datetime_helpers.from_rfc3339(value)
+
+
+def test_from_rfc3339_with_nanos():
+    value = "2009-12-17T12:44:32.123456789Z"
+
+    with pytest.raises(ValueError):
+        datetime_helpers.from_rfc3339(value)
+
+
+def test_from_rfc3339_nanos_without_nanos():
+    value = "2009-12-17T12:44:32Z"
+    assert datetime_helpers.from_rfc3339_nanos(value) == datetime.datetime(
+        2009, 12, 17, 12, 44, 32, 0, pytz.utc
+    )
+
+
+def test_from_rfc3339_nanos_with_bad_tz():
+    value = "2009-12-17T12:44:32.123456789BAD"
+
+    with pytest.raises(ValueError):
+        datetime_helpers.from_rfc3339_nanos(value)
+
+
+@pytest.mark.parametrize(
+    "truncated, micros",
+    [
+        ("12345678", 123456),
+        ("1234567", 123456),
+        ("123456", 123456),
+        ("12345", 123450),
+        ("1234", 123400),
+        ("123", 123000),
+        ("12", 120000),
+        ("1", 100000),
+    ],
+)
+def test_from_rfc3339_nanos_with_truncated_nanos(truncated, micros):
+    value = "2009-12-17T12:44:32.{}Z".format(truncated)
+    assert datetime_helpers.from_rfc3339_nanos(value) == datetime.datetime(
+        2009, 12, 17, 12, 44, 32, micros, pytz.utc
+    )
+
+
+def test_to_rfc3339():
+    value = datetime.datetime(2016, 4, 5, 13, 30, 0)
+    expected = "2016-04-05T13:30:00.000000Z"
+    assert datetime_helpers.to_rfc3339(value) == expected
+
+
+def test_to_rfc3339_with_utc():
+    value = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=pytz.utc)
+    expected = "2016-04-05T13:30:00.000000Z"
+    assert datetime_helpers.to_rfc3339(value, ignore_zone=False) == expected
+
+
+def test_to_rfc3339_with_non_utc():
+    zone = pytz.FixedOffset(-60)
+    value = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=zone)
+    expected = "2016-04-05T14:30:00.000000Z"
+    assert datetime_helpers.to_rfc3339(value, ignore_zone=False) == expected
+
+
+def test_to_rfc3339_with_non_utc_ignore_zone():
+    zone = pytz.FixedOffset(-60)
+    value = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=zone)
+    expected = "2016-04-05T13:30:00.000000Z"
+    assert datetime_helpers.to_rfc3339(value, ignore_zone=True) == expected
+
+
+class Test_DateTimeWithNanos(object):
+
+    @staticmethod
+    def test_ctor_wo_nanos():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(2016, 12, 20, 21, 13, 47, 123456)
+        assert stamp.year == 2016
+        assert stamp.month == 12
+        assert stamp.day == 20
+        assert stamp.hour == 21
+        assert stamp.minute == 13
+        assert stamp.second == 47
+        assert stamp.microsecond == 123456
+        assert stamp.nanosecond == 0
+
+    @staticmethod
+    def test_ctor_w_nanos():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=123456789
+        )
+        assert stamp.year == 2016
+        assert stamp.month == 12
+        assert stamp.day == 20
+        assert stamp.hour == 21
+        assert stamp.minute == 13
+        assert stamp.second == 47
+        assert stamp.microsecond == 123456
+        assert stamp.nanosecond == 123456789
+
+    @staticmethod
+    def test_ctor_w_micros_positional_and_nanos():
+        with pytest.raises(TypeError):
+            datetime_helpers.DatetimeWithNanoseconds(
+                2016, 12, 20, 21, 13, 47, 123456, nanosecond=123456789
+            )
+
+    @staticmethod
+    def test_ctor_w_micros_keyword_and_nanos():
+        with pytest.raises(TypeError):
+            datetime_helpers.DatetimeWithNanoseconds(
+                2016, 12, 20, 21, 13, 47, microsecond=123456, nanosecond=123456789
+            )
+
+    @staticmethod
+    def test_rfc3339_wo_nanos():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(2016, 12, 20, 21, 13, 47, 123456)
+        assert stamp.rfc3339() == "2016-12-20T21:13:47.123456Z"
+
+    @staticmethod
+    def test_rfc3339_wo_nanos_w_leading_zero():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(2016, 12, 20, 21, 13, 47, 1234)
+        assert stamp.rfc3339() == "2016-12-20T21:13:47.001234Z"
+
+    @staticmethod
+    def test_rfc3339_w_nanos():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=123456789
+        )
+        assert stamp.rfc3339() == "2016-12-20T21:13:47.123456789Z"
+
+    @staticmethod
+    def test_rfc3339_w_nanos_w_leading_zero():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=1234567
+        )
+        assert stamp.rfc3339() == "2016-12-20T21:13:47.001234567Z"
+
+    @staticmethod
+    def test_rfc3339_w_nanos_no_trailing_zeroes():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=100000000
+        )
+        assert stamp.rfc3339() == "2016-12-20T21:13:47.1Z"
+
+    @staticmethod
+    def test_rfc3339_w_nanos_w_leading_zero_and_no_trailing_zeros():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=1234500
+        )
+        assert stamp.rfc3339() == "2016-12-20T21:13:47.0012345Z"
+
+    @staticmethod
+    def test_from_rfc3339_w_invalid():
+        stamp = "2016-12-20T21:13:47"
+        with pytest.raises(ValueError):
+            datetime_helpers.DatetimeWithNanoseconds.from_rfc3339(stamp)
+
+    @staticmethod
+    def test_from_rfc3339_wo_fraction():
+        timestamp = "2016-12-20T21:13:47Z"
+        expected = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, tzinfo=pytz.UTC
+        )
+        stamp = datetime_helpers.DatetimeWithNanoseconds.from_rfc3339(timestamp)
+        assert stamp == expected
+
+    @staticmethod
+    def test_from_rfc3339_w_partial_precision():
+        timestamp = "2016-12-20T21:13:47.1Z"
+        expected = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, microsecond=100000, tzinfo=pytz.UTC
+        )
+        stamp = datetime_helpers.DatetimeWithNanoseconds.from_rfc3339(timestamp)
+        assert stamp == expected
+
+    @staticmethod
+    def test_from_rfc3339_w_full_precision():
+        timestamp = "2016-12-20T21:13:47.123456789Z"
+        expected = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=123456789, tzinfo=pytz.UTC
+        )
+        stamp = datetime_helpers.DatetimeWithNanoseconds.from_rfc3339(timestamp)
+        assert stamp == expected
+
+    @staticmethod
+    @pytest.mark.parametrize(
+        "fractional, nanos",
+        [
+            ("12345678", 123456780),
+            ("1234567", 123456700),
+            ("123456", 123456000),
+            ("12345", 123450000),
+            ("1234", 123400000),
+            ("123", 123000000),
+            ("12", 120000000),
+            ("1", 100000000),
+        ],
+    )
+    def test_from_rfc3339_test_nanoseconds(fractional, nanos):
+        value = "2009-12-17T12:44:32.{}Z".format(fractional)
+        assert datetime_helpers.DatetimeWithNanoseconds.from_rfc3339(value).nanosecond == nanos
+
+    @staticmethod
+    def test_timestamp_pb_wo_nanos_naive():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, 123456)
+        delta = stamp.replace(tzinfo=pytz.UTC) - datetime_helpers._UTC_EPOCH
+        seconds = int(delta.total_seconds())
+        nanos = 123456000
+        timestamp = timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
+        assert stamp.timestamp_pb() == timestamp
+
+    @staticmethod
+    def test_timestamp_pb_w_nanos():
+        stamp = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=123456789, tzinfo=pytz.UTC
+        )
+        delta = stamp - datetime_helpers._UTC_EPOCH
+        timestamp = timestamp_pb2.Timestamp(
+            seconds=int(delta.total_seconds()), nanos=123456789)
+        assert stamp.timestamp_pb() == timestamp
+
+    @staticmethod
+    def test_from_timestamp_pb_wo_nanos():
+        when = datetime.datetime(2016, 12, 20, 21, 13, 47, 123456, tzinfo=pytz.UTC)
+        delta = when - datetime_helpers._UTC_EPOCH
+        seconds = int(delta.total_seconds())
+        timestamp = timestamp_pb2.Timestamp(seconds=seconds)
+
+        stamp = datetime_helpers.DatetimeWithNanoseconds.from_timestamp_pb(
+            timestamp)
+
+        assert _to_seconds(when) == _to_seconds(stamp)
+        assert stamp.microsecond == 0
+        assert stamp.nanosecond == 0
+        assert stamp.tzinfo == pytz.UTC
+
+    @staticmethod
+    def test_from_timestamp_pb_w_nanos():
+        when = datetime.datetime(2016, 12, 20, 21, 13, 47, 123456, tzinfo=pytz.UTC)
+        delta = when - datetime_helpers._UTC_EPOCH
+        seconds = int(delta.total_seconds())
+        timestamp = timestamp_pb2.Timestamp(seconds=seconds, nanos=123456789)
+
+        stamp = datetime_helpers.DatetimeWithNanoseconds.from_timestamp_pb(
+            timestamp)
+
+        assert _to_seconds(when) == _to_seconds(stamp)
+        assert stamp.microsecond == 123456
+        assert stamp.nanosecond == 123456789
+        assert stamp.tzinfo == pytz.UTC
+
+
+def _to_seconds(value):
+    """Convert a datetime to seconds since the unix epoch.
+
+    Args:
+        value (datetime.datetime): The datetime to covert.
+
+    Returns:
+        int: Microseconds since the unix epoch.
+    """
+    assert value.tzinfo is pytz.UTC
+    return calendar.timegm(value.timetuple())
diff --git a/api_core/tests/unit/test_exceptions.py b/api_core/tests/unit/test_exceptions.py
new file mode 100644
index 000000000000..040ac8ac1d7c
--- /dev/null
+++ b/api_core/tests/unit/test_exceptions.py
@@ -0,0 +1,214 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+
+import grpc
+import mock
+import requests
+from six.moves import http_client
+
+from google.api_core import exceptions
+
+
+def test_create_google_cloud_error():
+    exception = exceptions.GoogleAPICallError("Testing")
+    exception.code = 600
+    assert str(exception) == "600 Testing"
+    assert exception.message == "Testing"
+    assert exception.errors == []
+    assert exception.response is None
+
+
+def test_create_google_cloud_error_with_args():
+    error = {
+        "domain": "global",
+        "location": "test",
+        "locationType": "testing",
+        "message": "Testing",
+        "reason": "test",
+    }
+    response = mock.sentinel.response
+    exception = exceptions.GoogleAPICallError("Testing", [error], response=response)
+    exception.code = 600
+    assert str(exception) == "600 Testing"
+    assert exception.message == "Testing"
+    assert exception.errors == [error]
+    assert exception.response == response
+
+
+def test_from_http_status():
+    message = "message"
+    exception = exceptions.from_http_status(http_client.NOT_FOUND, message)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == message
+    assert exception.errors == []
+
+
+def test_from_http_status_with_errors_and_response():
+    message = "message"
+    errors = ["1", "2"]
+    response = mock.sentinel.response
+    exception = exceptions.from_http_status(
+        http_client.NOT_FOUND, message, errors=errors, response=response
+    )
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == message
+    assert exception.errors == errors
+    assert exception.response == response
+
+
+def test_from_http_status_unknown_code():
+    message = "message"
+    status_code = 156
+    exception = exceptions.from_http_status(status_code, message)
+    assert exception.code == status_code
+    assert exception.message == message
+
+
+def make_response(content):
+    response = requests.Response()
+    response._content = content
+    response.status_code = http_client.NOT_FOUND
+    response.request = requests.Request(
+        method="POST", url="https://example.com"
+    ).prepare()
+    return response
+
+
+def test_from_http_response_no_content():
+    response = make_response(None)
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: unknown error"
+    assert exception.response == response
+
+
+def test_from_http_response_text_content():
+    response = make_response(b"message")
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: message"
+
+
+def test_from_http_response_json_content():
+    response = make_response(
+        json.dumps({"error": {"message": "json message", "errors": ["1", "2"]}}).encode(
+            "utf-8"
+        )
+    )
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: json message"
+    assert exception.errors == ["1", "2"]
+
+
+def test_from_http_response_bad_json_content():
+    response = make_response(json.dumps({"meep": "moop"}).encode("utf-8"))
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: unknown error"
+
+
+def test_from_http_response_json_unicode_content():
+    response = make_response(
+        json.dumps(
+            {"error": {"message": u"\u2019 message", "errors": ["1", "2"]}}
+        ).encode("utf-8")
+    )
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == u"POST https://example.com/: \u2019 message"
+    assert exception.errors == ["1", "2"]
+
+
+def test_from_grpc_status():
+    message = "message"
+    exception = exceptions.from_grpc_status(grpc.StatusCode.OUT_OF_RANGE, message)
+    assert isinstance(exception, exceptions.BadRequest)
+    assert isinstance(exception, exceptions.OutOfRange)
+    assert exception.code == http_client.BAD_REQUEST
+    assert exception.grpc_status_code == grpc.StatusCode.OUT_OF_RANGE
+    assert exception.message == message
+    assert exception.errors == []
+
+
+def test_from_grpc_status_with_errors_and_response():
+    message = "message"
+    response = mock.sentinel.response
+    errors = ["1", "2"]
+    exception = exceptions.from_grpc_status(
+        grpc.StatusCode.OUT_OF_RANGE, message, errors=errors, response=response
+    )
+
+    assert isinstance(exception, exceptions.OutOfRange)
+    assert exception.message == message
+    assert exception.errors == errors
+    assert exception.response == response
+
+
+def test_from_grpc_status_unknown_code():
+    message = "message"
+    exception = exceptions.from_grpc_status(grpc.StatusCode.OK, message)
+    assert exception.grpc_status_code == grpc.StatusCode.OK
+    assert exception.message == message
+
+
+def test_from_grpc_error():
+    message = "message"
+    error = mock.create_autospec(grpc.Call, instance=True)
+    error.code.return_value = grpc.StatusCode.INVALID_ARGUMENT
+    error.details.return_value = message
+
+    exception = exceptions.from_grpc_error(error)
+
+    assert isinstance(exception, exceptions.BadRequest)
+    assert isinstance(exception, exceptions.InvalidArgument)
+    assert exception.code == http_client.BAD_REQUEST
+    assert exception.grpc_status_code == grpc.StatusCode.INVALID_ARGUMENT
+    assert exception.message == message
+    assert exception.errors == [error]
+    assert exception.response == error
+
+
+def test_from_grpc_error_non_call():
+    message = "message"
+    error = mock.create_autospec(grpc.RpcError, instance=True)
+    error.__str__.return_value = message
+
+    exception = exceptions.from_grpc_error(error)
+
+    assert isinstance(exception, exceptions.GoogleAPICallError)
+    assert exception.code is None
+    assert exception.grpc_status_code is None
+    assert exception.message == message
+    assert exception.errors == [error]
+    assert exception.response == error
diff --git a/api_core/tests/unit/test_general_helpers.py b/api_core/tests/unit/test_general_helpers.py
new file mode 100644
index 000000000000..027d4892ba09
--- /dev/null
+++ b/api_core/tests/unit/test_general_helpers.py
@@ -0,0 +1,41 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+
+from google.api_core import general_helpers
+
+
+def test_wraps_normal_func():
+    def func():
+        return 42
+
+    @general_helpers.wraps(func)
+    def replacement():
+        return func()
+
+    assert replacement() == 42
+
+
+def test_wraps_partial():
+    def func():
+        return 42
+
+    partial = functools.partial(func)
+
+    @general_helpers.wraps(partial)
+    def replacement():
+        return func()
+
+    assert replacement() == 42
diff --git a/api_core/tests/unit/test_grpc_helpers.py b/api_core/tests/unit/test_grpc_helpers.py
new file mode 100644
index 000000000000..c37c3eedbe83
--- /dev/null
+++ b/api_core/tests/unit/test_grpc_helpers.py
@@ -0,0 +1,460 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import grpc
+import mock
+import pytest
+
+from google.api_core import exceptions
+from google.api_core import grpc_helpers
+import google.auth.credentials
+from google.longrunning import operations_pb2
+
+
+def test__patch_callable_name():
+    callable = mock.Mock(spec=["__class__"])
+    callable.__class__ = mock.Mock(spec=["__name__"])
+    callable.__class__.__name__ = "TestCallable"
+
+    grpc_helpers._patch_callable_name(callable)
+
+    assert callable.__name__ == "TestCallable"
+
+
+def test__patch_callable_name_no_op():
+    callable = mock.Mock(spec=["__name__"])
+    callable.__name__ = "test_callable"
+
+    grpc_helpers._patch_callable_name(callable)
+
+    assert callable.__name__ == "test_callable"
+
+
+class RpcErrorImpl(grpc.RpcError, grpc.Call):
+    def __init__(self, code):
+        super(RpcErrorImpl, self).__init__()
+        self._code = code
+
+    def code(self):
+        return self._code
+
+    def details(self):
+        return None
+
+
+def test_wrap_unary_errors():
+    grpc_error = RpcErrorImpl(grpc.StatusCode.INVALID_ARGUMENT)
+    callable_ = mock.Mock(spec=["__call__"], side_effect=grpc_error)
+
+    wrapped_callable = grpc_helpers._wrap_unary_errors(callable_)
+
+    with pytest.raises(exceptions.InvalidArgument) as exc_info:
+        wrapped_callable(1, 2, three="four")
+
+    callable_.assert_called_once_with(1, 2, three="four")
+    assert exc_info.value.response == grpc_error
+
+
+def test_wrap_stream_okay():
+    expected_responses = [1, 2, 3]
+    callable_ = mock.Mock(spec=["__call__"], return_value=iter(expected_responses))
+
+    wrapped_callable = grpc_helpers._wrap_stream_errors(callable_)
+
+    got_iterator = wrapped_callable(1, 2, three="four")
+
+    responses = list(got_iterator)
+
+    callable_.assert_called_once_with(1, 2, three="four")
+    assert responses == expected_responses
+
+
+def test_wrap_stream_iterable_iterface():
+    response_iter = mock.create_autospec(grpc.Call, instance=True)
+    callable_ = mock.Mock(spec=["__call__"], return_value=response_iter)
+
+    wrapped_callable = grpc_helpers._wrap_stream_errors(callable_)
+
+    got_iterator = wrapped_callable()
+
+    callable_.assert_called_once_with()
+
+    # Check each aliased method in the grpc.Call interface
+    got_iterator.add_callback(mock.sentinel.callback)
+    response_iter.add_callback.assert_called_once_with(mock.sentinel.callback)
+
+    got_iterator.cancel()
+    response_iter.cancel.assert_called_once_with()
+
+    got_iterator.code()
+    response_iter.code.assert_called_once_with()
+
+    got_iterator.details()
+    response_iter.details.assert_called_once_with()
+
+    got_iterator.initial_metadata()
+    response_iter.initial_metadata.assert_called_once_with()
+
+    got_iterator.is_active()
+    response_iter.is_active.assert_called_once_with()
+
+    got_iterator.time_remaining()
+    response_iter.time_remaining.assert_called_once_with()
+
+    got_iterator.trailing_metadata()
+    response_iter.trailing_metadata.assert_called_once_with()
+
+
+def test_wrap_stream_errors_invocation():
+    grpc_error = RpcErrorImpl(grpc.StatusCode.INVALID_ARGUMENT)
+    callable_ = mock.Mock(spec=["__call__"], side_effect=grpc_error)
+
+    wrapped_callable = grpc_helpers._wrap_stream_errors(callable_)
+
+    with pytest.raises(exceptions.InvalidArgument) as exc_info:
+        wrapped_callable(1, 2, three="four")
+
+    callable_.assert_called_once_with(1, 2, three="four")
+    assert exc_info.value.response == grpc_error
+
+
+class RpcResponseIteratorImpl(object):
+    def __init__(self, exception):
+        self._exception = exception
+
+    def next(self):
+        raise self._exception
+
+    __next__ = next
+
+
+def test_wrap_stream_errors_iterator():
+    grpc_error = RpcErrorImpl(grpc.StatusCode.UNAVAILABLE)
+    response_iter = RpcResponseIteratorImpl(grpc_error)
+    callable_ = mock.Mock(spec=["__call__"], return_value=response_iter)
+
+    wrapped_callable = grpc_helpers._wrap_stream_errors(callable_)
+
+    got_iterator = wrapped_callable(1, 2, three="four")
+
+    with pytest.raises(exceptions.ServiceUnavailable) as exc_info:
+        next(got_iterator)
+
+    callable_.assert_called_once_with(1, 2, three="four")
+    assert exc_info.value.response == grpc_error
+
+
+@mock.patch("google.api_core.grpc_helpers._wrap_unary_errors")
+def test_wrap_errors_non_streaming(wrap_unary_errors):
+    callable_ = mock.create_autospec(grpc.UnaryUnaryMultiCallable)
+
+    result = grpc_helpers.wrap_errors(callable_)
+
+    assert result == wrap_unary_errors.return_value
+    wrap_unary_errors.assert_called_once_with(callable_)
+
+
+@mock.patch("google.api_core.grpc_helpers._wrap_stream_errors")
+def test_wrap_errors_streaming(wrap_stream_errors):
+    callable_ = mock.create_autospec(grpc.UnaryStreamMultiCallable)
+
+    result = grpc_helpers.wrap_errors(callable_)
+
+    assert result == wrap_stream_errors.return_value
+    wrap_stream_errors.assert_called_once_with(callable_)
+
+
+@mock.patch("grpc.composite_channel_credentials")
+@mock.patch(
+    "google.auth.default",
+    return_value=(mock.sentinel.credentials, mock.sentinel.projet),
+)
+@mock.patch("grpc.secure_channel")
+def test_create_channel_implicit(grpc_secure_channel, default, composite_creds_call):
+    target = "example.com:443"
+    composite_creds = composite_creds_call.return_value
+
+    channel = grpc_helpers.create_channel(target)
+
+    assert channel is grpc_secure_channel.return_value
+    default.assert_called_once_with(scopes=None)
+    if grpc_helpers.HAS_GRPC_GCP:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds, None)
+    else:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds)
+
+
+@mock.patch("grpc.composite_channel_credentials")
+@mock.patch(
+    "google.auth.default",
+    return_value=(mock.sentinel.credentials, mock.sentinel.projet),
+)
+@mock.patch("grpc.secure_channel")
+def test_create_channel_implicit_with_ssl_creds(
+    grpc_secure_channel, default, composite_creds_call
+):
+    target = "example.com:443"
+
+    ssl_creds = grpc.ssl_channel_credentials()
+
+    grpc_helpers.create_channel(target, ssl_credentials=ssl_creds)
+
+    default.assert_called_once_with(scopes=None)
+    composite_creds_call.assert_called_once_with(ssl_creds, mock.ANY)
+    composite_creds = composite_creds_call.return_value
+    if grpc_helpers.HAS_GRPC_GCP:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds, None)
+    else:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds)
+
+
+@mock.patch("grpc.composite_channel_credentials")
+@mock.patch(
+    "google.auth.default",
+    return_value=(mock.sentinel.credentials, mock.sentinel.projet),
+)
+@mock.patch("grpc.secure_channel")
+def test_create_channel_implicit_with_scopes(
+    grpc_secure_channel, default, composite_creds_call
+):
+    target = "example.com:443"
+    composite_creds = composite_creds_call.return_value
+
+    channel = grpc_helpers.create_channel(target, scopes=["one", "two"])
+
+    assert channel is grpc_secure_channel.return_value
+    default.assert_called_once_with(scopes=["one", "two"])
+    if grpc_helpers.HAS_GRPC_GCP:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds, None)
+    else:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds)
+
+
+@mock.patch("grpc.composite_channel_credentials")
+@mock.patch("google.auth.credentials.with_scopes_if_required")
+@mock.patch("grpc.secure_channel")
+def test_create_channel_explicit(grpc_secure_channel, auth_creds, composite_creds_call):
+    target = "example.com:443"
+    composite_creds = composite_creds_call.return_value
+
+    channel = grpc_helpers.create_channel(target, credentials=mock.sentinel.credentials)
+
+    auth_creds.assert_called_once_with(mock.sentinel.credentials, None)
+    assert channel is grpc_secure_channel.return_value
+    if grpc_helpers.HAS_GRPC_GCP:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds, None)
+    else:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds)
+
+
+@mock.patch("grpc.composite_channel_credentials")
+@mock.patch("grpc.secure_channel")
+def test_create_channel_explicit_scoped(grpc_secure_channel, composite_creds_call):
+    target = "example.com:443"
+    scopes = ["1", "2"]
+    composite_creds = composite_creds_call.return_value
+
+    credentials = mock.create_autospec(google.auth.credentials.Scoped, instance=True)
+    credentials.requires_scopes = True
+
+    channel = grpc_helpers.create_channel(
+        target, credentials=credentials, scopes=scopes
+    )
+
+    credentials.with_scopes.assert_called_once_with(scopes)
+    assert channel is grpc_secure_channel.return_value
+    if grpc_helpers.HAS_GRPC_GCP:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds, None)
+    else:
+        grpc_secure_channel.assert_called_once_with(target, composite_creds)
+
+
+@pytest.mark.skipif(
+    not grpc_helpers.HAS_GRPC_GCP, reason="grpc_gcp module not available"
+)
+@mock.patch("grpc_gcp.secure_channel")
+def test_create_channel_with_grpc_gcp(grpc_gcp_secure_channel):
+    target = "example.com:443"
+    scopes = ["test_scope"]
+
+    credentials = mock.create_autospec(google.auth.credentials.Scoped, instance=True)
+    credentials.requires_scopes = True
+
+    grpc_helpers.create_channel(target, credentials=credentials, scopes=scopes)
+    grpc_gcp_secure_channel.assert_called()
+    credentials.with_scopes.assert_called_once_with(scopes)
+
+
+@pytest.mark.skipif(grpc_helpers.HAS_GRPC_GCP, reason="grpc_gcp module not available")
+@mock.patch("grpc.secure_channel")
+def test_create_channel_without_grpc_gcp(grpc_secure_channel):
+    target = "example.com:443"
+    scopes = ["test_scope"]
+
+    credentials = mock.create_autospec(google.auth.credentials.Scoped, instance=True)
+    credentials.requires_scopes = True
+
+    grpc_helpers.create_channel(target, credentials=credentials, scopes=scopes)
+    grpc_secure_channel.assert_called()
+    credentials.with_scopes.assert_called_once_with(scopes)
+
+
+class TestChannelStub(object):
+    def test_single_response(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        expected_request = operations_pb2.GetOperationRequest(name="meep")
+        expected_response = operations_pb2.Operation(name="moop")
+
+        channel.GetOperation.response = expected_response
+
+        response = stub.GetOperation(expected_request)
+
+        assert response == expected_response
+        assert channel.requests == [("GetOperation", expected_request)]
+        assert channel.GetOperation.requests == [expected_request]
+
+    def test_no_response(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        expected_request = operations_pb2.GetOperationRequest(name="meep")
+
+        with pytest.raises(ValueError) as exc_info:
+            stub.GetOperation(expected_request)
+
+        assert exc_info.match("GetOperation")
+
+    def test_missing_method(self):
+        channel = grpc_helpers.ChannelStub()
+
+        with pytest.raises(AttributeError):
+            channel.DoesNotExist.response
+
+    def test_exception_response(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        expected_request = operations_pb2.GetOperationRequest(name="meep")
+
+        channel.GetOperation.response = RuntimeError()
+
+        with pytest.raises(RuntimeError):
+            stub.GetOperation(expected_request)
+
+    def test_callable_response(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        expected_request = operations_pb2.GetOperationRequest(name="meep")
+        expected_response = operations_pb2.Operation(name="moop")
+
+        on_get_operation = mock.Mock(spec=("__call__",), return_value=expected_response)
+
+        channel.GetOperation.response = on_get_operation
+
+        response = stub.GetOperation(expected_request)
+
+        assert response == expected_response
+        on_get_operation.assert_called_once_with(expected_request)
+
+    def test_multiple_responses(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        expected_request = operations_pb2.GetOperationRequest(name="meep")
+        expected_responses = [
+            operations_pb2.Operation(name="foo"),
+            operations_pb2.Operation(name="bar"),
+            operations_pb2.Operation(name="baz"),
+        ]
+
+        channel.GetOperation.responses = iter(expected_responses)
+
+        response1 = stub.GetOperation(expected_request)
+        response2 = stub.GetOperation(expected_request)
+        response3 = stub.GetOperation(expected_request)
+
+        assert response1 == expected_responses[0]
+        assert response2 == expected_responses[1]
+        assert response3 == expected_responses[2]
+        assert channel.requests == [("GetOperation", expected_request)] * 3
+        assert channel.GetOperation.requests == [expected_request] * 3
+
+        with pytest.raises(StopIteration):
+            stub.GetOperation(expected_request)
+
+    def test_multiple_responses_and_single_response_error(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        channel.GetOperation.responses = []
+        channel.GetOperation.response = mock.sentinel.response
+
+        with pytest.raises(ValueError):
+            stub.GetOperation(operations_pb2.GetOperationRequest())
+
+    def test_call_info(self):
+        channel = grpc_helpers.ChannelStub()
+        stub = operations_pb2.OperationsStub(channel)
+        expected_request = operations_pb2.GetOperationRequest(name="meep")
+        expected_response = operations_pb2.Operation(name="moop")
+        expected_metadata = [("red", "blue"), ("two", "shoe")]
+        expected_credentials = mock.sentinel.credentials
+        channel.GetOperation.response = expected_response
+
+        response = stub.GetOperation(
+            expected_request,
+            timeout=42,
+            metadata=expected_metadata,
+            credentials=expected_credentials,
+        )
+
+        assert response == expected_response
+        assert channel.requests == [("GetOperation", expected_request)]
+        assert channel.GetOperation.calls == [
+            (expected_request, 42, expected_metadata, expected_credentials)
+        ]
+
+    def test_unary_unary(self):
+        channel = grpc_helpers.ChannelStub()
+        method_name = "GetOperation"
+        callable_stub = channel.unary_unary(method_name)
+        assert callable_stub._method == method_name
+        assert callable_stub._channel == channel
+
+    def test_unary_stream(self):
+        channel = grpc_helpers.ChannelStub()
+        method_name = "GetOperation"
+        callable_stub = channel.unary_stream(method_name)
+        assert callable_stub._method == method_name
+        assert callable_stub._channel == channel
+
+    def test_stream_unary(self):
+        channel = grpc_helpers.ChannelStub()
+        method_name = "GetOperation"
+        callable_stub = channel.stream_unary(method_name)
+        assert callable_stub._method == method_name
+        assert callable_stub._channel == channel
+
+    def test_stream_stream(self):
+        channel = grpc_helpers.ChannelStub()
+        method_name = "GetOperation"
+        callable_stub = channel.stream_stream(method_name)
+        assert callable_stub._method == method_name
+        assert callable_stub._channel == channel
+
+    def test_subscribe_unsubscribe(self):
+        channel = grpc_helpers.ChannelStub()
+        assert channel.subscribe(None) is None
+        assert channel.unsubscribe(None) is None
+
+    def test_close(self):
+        channel = grpc_helpers.ChannelStub()
+        assert channel.close() is None
diff --git a/api_core/tests/unit/test_iam.py b/api_core/tests/unit/test_iam.py
new file mode 100644
index 000000000000..199c38907983
--- /dev/null
+++ b/api_core/tests/unit/test_iam.py
@@ -0,0 +1,288 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pytest
+
+
+class TestPolicy:
+    @staticmethod
+    def _get_target_class():
+        from google.api_core.iam import Policy
+
+        return Policy
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        empty = frozenset()
+        policy = self._make_one()
+        assert policy.etag is None
+        assert policy.version is None
+        assert policy.owners == empty
+        assert policy.editors == empty
+        assert policy.viewers == empty
+        assert len(policy) == 0
+        assert dict(policy) == {}
+
+    def test_ctor_explicit(self):
+        VERSION = 17
+        ETAG = "ETAG"
+        empty = frozenset()
+        policy = self._make_one(ETAG, VERSION)
+        assert policy.etag == ETAG
+        assert policy.version == VERSION
+        assert policy.owners == empty
+        assert policy.editors == empty
+        assert policy.viewers == empty
+        assert len(policy) == 0
+        assert dict(policy) == {}
+
+    def test___getitem___miss(self):
+        policy = self._make_one()
+        assert policy["nonesuch"] == set()
+
+    def test___setitem__(self):
+        USER = "user:phred@example.com"
+        PRINCIPALS = set([USER])
+        policy = self._make_one()
+        policy["rolename"] = [USER]
+        assert policy["rolename"] == PRINCIPALS
+        assert len(policy) == 1
+        assert dict(policy) == {"rolename": PRINCIPALS}
+
+    def test___delitem___hit(self):
+        policy = self._make_one()
+        policy._bindings["rolename"] = ["phred@example.com"]
+        del policy["rolename"]
+        assert len(policy) == 0
+        assert dict(policy) == {}
+
+    def test___delitem___miss(self):
+        policy = self._make_one()
+        with pytest.raises(KeyError):
+            del policy["nonesuch"]
+
+    def test_owners_getter(self):
+        from google.api_core.iam import OWNER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[OWNER_ROLE] = [MEMBER]
+        assert policy.owners == expected
+
+    def test_owners_setter(self):
+        import warnings
+        from google.api_core.iam import OWNER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = set([MEMBER])
+        policy = self._make_one()
+
+        with warnings.catch_warnings(record=True) as warned:
+            policy.owners = [MEMBER]
+
+        warning, = warned
+        assert warning.category is DeprecationWarning
+        assert policy[OWNER_ROLE] == expected
+
+    def test_editors_getter(self):
+        from google.api_core.iam import EDITOR_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[EDITOR_ROLE] = [MEMBER]
+        assert policy.editors == expected
+
+    def test_editors_setter(self):
+        import warnings
+        from google.api_core.iam import EDITOR_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = set([MEMBER])
+        policy = self._make_one()
+
+        with warnings.catch_warnings(record=True) as warned:
+            policy.editors = [MEMBER]
+
+        warning, = warned
+        assert warning.category is DeprecationWarning
+        assert policy[EDITOR_ROLE] == expected
+
+    def test_viewers_getter(self):
+        from google.api_core.iam import VIEWER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[VIEWER_ROLE] = [MEMBER]
+        assert policy.viewers == expected
+
+    def test_viewers_setter(self):
+        import warnings
+        from google.api_core.iam import VIEWER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = set([MEMBER])
+        policy = self._make_one()
+
+        with warnings.catch_warnings(record=True) as warned:
+            policy.viewers = [MEMBER]
+
+        warning, = warned
+        assert warning.category is DeprecationWarning
+        assert policy[VIEWER_ROLE] == expected
+
+    def test_user(self):
+        EMAIL = "phred@example.com"
+        MEMBER = "user:%s" % (EMAIL,)
+        policy = self._make_one()
+        assert policy.user(EMAIL) == MEMBER
+
+    def test_service_account(self):
+        EMAIL = "phred@example.com"
+        MEMBER = "serviceAccount:%s" % (EMAIL,)
+        policy = self._make_one()
+        assert policy.service_account(EMAIL) == MEMBER
+
+    def test_group(self):
+        EMAIL = "phred@example.com"
+        MEMBER = "group:%s" % (EMAIL,)
+        policy = self._make_one()
+        assert policy.group(EMAIL) == MEMBER
+
+    def test_domain(self):
+        DOMAIN = "example.com"
+        MEMBER = "domain:%s" % (DOMAIN,)
+        policy = self._make_one()
+        assert policy.domain(DOMAIN) == MEMBER
+
+    def test_all_users(self):
+        policy = self._make_one()
+        assert policy.all_users() == "allUsers"
+
+    def test_authenticated_users(self):
+        policy = self._make_one()
+        assert policy.authenticated_users() == "allAuthenticatedUsers"
+
+    def test_from_api_repr_only_etag(self):
+        empty = frozenset()
+        RESOURCE = {"etag": "ACAB"}
+        klass = self._get_target_class()
+        policy = klass.from_api_repr(RESOURCE)
+        assert policy.etag == "ACAB"
+        assert policy.version is None
+        assert policy.owners == empty
+        assert policy.editors == empty
+        assert policy.viewers == empty
+        assert dict(policy) == {}
+
+    def test_from_api_repr_complete(self):
+        from google.api_core.iam import OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE
+
+        OWNER1 = "group:cloud-logs@google.com"
+        OWNER2 = "user:phred@example.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        RESOURCE = {
+            "etag": "DEADBEEF",
+            "version": 17,
+            "bindings": [
+                {"role": OWNER_ROLE, "members": [OWNER1, OWNER2]},
+                {"role": EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+                {"role": VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+            ],
+        }
+        klass = self._get_target_class()
+        policy = klass.from_api_repr(RESOURCE)
+        assert policy.etag == "DEADBEEF"
+        assert policy.version == 17
+        assert policy.owners, frozenset([OWNER1 == OWNER2])
+        assert policy.editors, frozenset([EDITOR1 == EDITOR2])
+        assert policy.viewers, frozenset([VIEWER1 == VIEWER2])
+        assert dict(policy) == {
+            OWNER_ROLE: set([OWNER1, OWNER2]),
+            EDITOR_ROLE: set([EDITOR1, EDITOR2]),
+            VIEWER_ROLE: set([VIEWER1, VIEWER2]),
+        }
+
+    def test_from_api_repr_unknown_role(self):
+        USER = "user:phred@example.com"
+        GROUP = "group:cloud-logs@google.com"
+        RESOURCE = {
+            "etag": "DEADBEEF",
+            "version": 17,
+            "bindings": [{"role": "unknown", "members": [USER, GROUP]}],
+        }
+        klass = self._get_target_class()
+        policy = klass.from_api_repr(RESOURCE)
+        assert policy.etag == "DEADBEEF"
+        assert policy.version == 17
+        assert dict(policy), {"unknown": set([GROUP == USER])}
+
+    def test_to_api_repr_defaults(self):
+        policy = self._make_one()
+        assert policy.to_api_repr() == {}
+
+    def test_to_api_repr_only_etag(self):
+        policy = self._make_one("DEADBEEF")
+        assert policy.to_api_repr() == {"etag": "DEADBEEF"}
+
+    def test_to_api_repr_binding_wo_members(self):
+        policy = self._make_one()
+        policy["empty"] = []
+        assert policy.to_api_repr() == {}
+
+    def test_to_api_repr_binding_w_duplicates(self):
+        import warnings
+        from google.api_core.iam import OWNER_ROLE
+
+        OWNER = "group:cloud-logs@google.com"
+        policy = self._make_one()
+        with warnings.catch_warnings(record=True):
+            policy.owners = [OWNER, OWNER]
+        assert policy.to_api_repr() == {
+            "bindings": [{"role": OWNER_ROLE, "members": [OWNER]}]
+        }
+
+    def test_to_api_repr_full(self):
+        import operator
+        import warnings
+        from google.api_core.iam import OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE
+
+        OWNER1 = "group:cloud-logs@google.com"
+        OWNER2 = "user:phred@example.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        BINDINGS = [
+            {"role": OWNER_ROLE, "members": [OWNER1, OWNER2]},
+            {"role": EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+            {"role": VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+        ]
+        policy = self._make_one("DEADBEEF", 17)
+        with warnings.catch_warnings(record=True):
+            policy.owners = [OWNER1, OWNER2]
+            policy.editors = [EDITOR1, EDITOR2]
+            policy.viewers = [VIEWER1, VIEWER2]
+        resource = policy.to_api_repr()
+        assert resource["etag"] == "DEADBEEF"
+        assert resource["version"] == 17
+        key = operator.itemgetter("role")
+        assert sorted(resource["bindings"], key=key) == sorted(BINDINGS, key=key)
diff --git a/api_core/tests/unit/test_operation.py b/api_core/tests/unit/test_operation.py
new file mode 100644
index 000000000000..a5346a706422
--- /dev/null
+++ b/api_core/tests/unit/test_operation.py
@@ -0,0 +1,241 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import mock
+
+from google.api_core import operation
+from google.api_core import operations_v1
+from google.longrunning import operations_pb2
+from google.protobuf import struct_pb2
+from google.rpc import code_pb2
+from google.rpc import status_pb2
+
+TEST_OPERATION_NAME = "test/operation"
+
+
+def make_operation_proto(
+    name=TEST_OPERATION_NAME, metadata=None, response=None, error=None, **kwargs
+):
+    operation_proto = operations_pb2.Operation(name=name, **kwargs)
+
+    if metadata is not None:
+        operation_proto.metadata.Pack(metadata)
+
+    if response is not None:
+        operation_proto.response.Pack(response)
+
+    if error is not None:
+        operation_proto.error.CopyFrom(error)
+
+    return operation_proto
+
+
+def make_operation_future(client_operations_responses=None):
+    if client_operations_responses is None:
+        client_operations_responses = [make_operation_proto()]
+
+    refresh = mock.Mock(spec=["__call__"], side_effect=client_operations_responses)
+    refresh.responses = client_operations_responses
+    cancel = mock.Mock(spec=["__call__"])
+    operation_future = operation.Operation(
+        client_operations_responses[0],
+        refresh,
+        cancel,
+        result_type=struct_pb2.Struct,
+        metadata_type=struct_pb2.Struct,
+    )
+
+    return operation_future, refresh, cancel
+
+
+def test_constructor():
+    future, refresh, _ = make_operation_future()
+
+    assert future.operation == refresh.responses[0]
+    assert future.operation.done is False
+    assert future.operation.name == TEST_OPERATION_NAME
+    assert future.metadata is None
+    assert future.running()
+
+
+def test_metadata():
+    expected_metadata = struct_pb2.Struct()
+    future, _, _ = make_operation_future(
+        [make_operation_proto(metadata=expected_metadata)]
+    )
+
+    assert future.metadata == expected_metadata
+
+
+def test_cancellation():
+    responses = [
+        make_operation_proto(),
+        # Second response indicates that the operation was cancelled.
+        make_operation_proto(
+            done=True, error=status_pb2.Status(code=code_pb2.CANCELLED)
+        ),
+    ]
+    future, _, cancel = make_operation_future(responses)
+
+    assert future.cancel()
+    assert future.cancelled()
+    cancel.assert_called_once_with()
+
+    # Cancelling twice should have no effect.
+    assert not future.cancel()
+    cancel.assert_called_once_with()
+
+
+def test_result():
+    expected_result = struct_pb2.Struct()
+    responses = [
+        make_operation_proto(),
+        # Second operation response includes the result.
+        make_operation_proto(done=True, response=expected_result),
+    ]
+    future, _, _ = make_operation_future(responses)
+
+    result = future.result()
+
+    assert result == expected_result
+    assert future.done()
+
+
+def test_exception():
+    expected_exception = status_pb2.Status(message="meep")
+    responses = [
+        make_operation_proto(),
+        # Second operation response includes the error.
+        make_operation_proto(done=True, error=expected_exception),
+    ]
+    future, _, _ = make_operation_future(responses)
+
+    exception = future.exception()
+
+    assert expected_exception.message in "{!r}".format(exception)
+
+
+def test_unexpected_result():
+    responses = [
+        make_operation_proto(),
+        # Second operation response is done, but has not error or response.
+        make_operation_proto(done=True),
+    ]
+    future, _, _ = make_operation_future(responses)
+
+    exception = future.exception()
+
+    assert "Unexpected state" in "{!r}".format(exception)
+
+
+def test__refresh_http():
+    api_request = mock.Mock(return_value={"name": TEST_OPERATION_NAME, "done": True})
+
+    result = operation._refresh_http(api_request, TEST_OPERATION_NAME)
+
+    assert result.name == TEST_OPERATION_NAME
+    assert result.done is True
+    api_request.assert_called_once_with(
+        method="GET", path="operations/{}".format(TEST_OPERATION_NAME)
+    )
+
+
+def test__cancel_http():
+    api_request = mock.Mock()
+
+    operation._cancel_http(api_request, TEST_OPERATION_NAME)
+
+    api_request.assert_called_once_with(
+        method="POST", path="operations/{}:cancel".format(TEST_OPERATION_NAME)
+    )
+
+
+def test_from_http_json():
+    operation_json = {"name": TEST_OPERATION_NAME, "done": True}
+    api_request = mock.sentinel.api_request
+
+    future = operation.from_http_json(
+        operation_json, api_request, struct_pb2.Struct, metadata_type=struct_pb2.Struct
+    )
+
+    assert future._result_type == struct_pb2.Struct
+    assert future._metadata_type == struct_pb2.Struct
+    assert future.operation.name == TEST_OPERATION_NAME
+    assert future.done
+
+
+def test__refresh_grpc():
+    operations_stub = mock.Mock(spec=["GetOperation"])
+    expected_result = make_operation_proto(done=True)
+    operations_stub.GetOperation.return_value = expected_result
+
+    result = operation._refresh_grpc(operations_stub, TEST_OPERATION_NAME)
+
+    assert result == expected_result
+    expected_request = operations_pb2.GetOperationRequest(name=TEST_OPERATION_NAME)
+    operations_stub.GetOperation.assert_called_once_with(expected_request)
+
+
+def test__cancel_grpc():
+    operations_stub = mock.Mock(spec=["CancelOperation"])
+
+    operation._cancel_grpc(operations_stub, TEST_OPERATION_NAME)
+
+    expected_request = operations_pb2.CancelOperationRequest(name=TEST_OPERATION_NAME)
+    operations_stub.CancelOperation.assert_called_once_with(expected_request)
+
+
+def test_from_grpc():
+    operation_proto = make_operation_proto(done=True)
+    operations_stub = mock.sentinel.operations_stub
+
+    future = operation.from_grpc(
+        operation_proto,
+        operations_stub,
+        struct_pb2.Struct,
+        metadata_type=struct_pb2.Struct,
+    )
+
+    assert future._result_type == struct_pb2.Struct
+    assert future._metadata_type == struct_pb2.Struct
+    assert future.operation.name == TEST_OPERATION_NAME
+    assert future.done
+
+
+def test_from_gapic():
+    operation_proto = make_operation_proto(done=True)
+    operations_client = mock.create_autospec(
+        operations_v1.OperationsClient, instance=True
+    )
+
+    future = operation.from_gapic(
+        operation_proto,
+        operations_client,
+        struct_pb2.Struct,
+        metadata_type=struct_pb2.Struct,
+    )
+
+    assert future._result_type == struct_pb2.Struct
+    assert future._metadata_type == struct_pb2.Struct
+    assert future.operation.name == TEST_OPERATION_NAME
+    assert future.done
+
+
+def test_deserialize():
+    op = make_operation_proto(name="foobarbaz")
+    serialized = op.SerializeToString()
+    deserialized_op = operation.Operation.deserialize(serialized)
+    assert op.name == deserialized_op.name
+    assert type(op) is type(deserialized_op)
diff --git a/api_core/tests/unit/test_page_iterator.py b/api_core/tests/unit/test_page_iterator.py
new file mode 100644
index 000000000000..6335001bcf41
--- /dev/null
+++ b/api_core/tests/unit/test_page_iterator.py
@@ -0,0 +1,570 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import types
+
+import mock
+import pytest
+import six
+
+from google.api_core import page_iterator
+
+
+def test__do_nothing_page_start():
+    assert page_iterator._do_nothing_page_start(None, None, None) is None
+
+
+class TestPage(object):
+    def test_constructor(self):
+        parent = mock.sentinel.parent
+        item_to_value = mock.sentinel.item_to_value
+
+        page = page_iterator.Page(parent, (1, 2, 3), item_to_value)
+
+        assert page.num_items == 3
+        assert page.remaining == 3
+        assert page._parent is parent
+        assert page._item_to_value is item_to_value
+
+    def test___iter__(self):
+        page = page_iterator.Page(None, (), None)
+        assert iter(page) is page
+
+    def test_iterator_calls_parent_item_to_value(self):
+        parent = mock.sentinel.parent
+
+        item_to_value = mock.Mock(
+            side_effect=lambda iterator, value: value, spec=["__call__"]
+        )
+
+        page = page_iterator.Page(parent, (10, 11, 12), item_to_value)
+        page._remaining = 100
+
+        assert item_to_value.call_count == 0
+        assert page.remaining == 100
+
+        assert six.next(page) == 10
+        assert item_to_value.call_count == 1
+        item_to_value.assert_called_with(parent, 10)
+        assert page.remaining == 99
+
+        assert six.next(page) == 11
+        assert item_to_value.call_count == 2
+        item_to_value.assert_called_with(parent, 11)
+        assert page.remaining == 98
+
+        assert six.next(page) == 12
+        assert item_to_value.call_count == 3
+        item_to_value.assert_called_with(parent, 12)
+        assert page.remaining == 97
+
+
+class PageIteratorImpl(page_iterator.Iterator):
+    def _next_page(self):
+        return mock.create_autospec(page_iterator.Page, instance=True)
+
+
+class TestIterator(object):
+    def test_constructor(self):
+        client = mock.sentinel.client
+        item_to_value = mock.sentinel.item_to_value
+        token = "ab13nceor03"
+        max_results = 1337
+
+        iterator = PageIteratorImpl(
+            client, item_to_value, page_token=token, max_results=max_results
+        )
+
+        assert not iterator._started
+        assert iterator.client is client
+        assert iterator.item_to_value == item_to_value
+        assert iterator.max_results == max_results
+        # Changing attributes.
+        assert iterator.page_number == 0
+        assert iterator.next_page_token == token
+        assert iterator.num_results == 0
+
+    def test_pages_property_starts(self):
+        iterator = PageIteratorImpl(None, None)
+
+        assert not iterator._started
+
+        assert isinstance(iterator.pages, types.GeneratorType)
+
+        assert iterator._started
+
+    def test_pages_property_restart(self):
+        iterator = PageIteratorImpl(None, None)
+
+        assert iterator.pages
+
+        # Make sure we cannot restart.
+        with pytest.raises(ValueError):
+            assert iterator.pages
+
+    def test__page_iter_increment(self):
+        iterator = PageIteratorImpl(None, None)
+        page = page_iterator.Page(
+            iterator, ("item",), page_iterator._item_to_value_identity
+        )
+        iterator._next_page = mock.Mock(side_effect=[page, None])
+
+        assert iterator.num_results == 0
+
+        page_iter = iterator._page_iter(increment=True)
+        next(page_iter)
+
+        assert iterator.num_results == 1
+
+    def test__page_iter_no_increment(self):
+        iterator = PageIteratorImpl(None, None)
+
+        assert iterator.num_results == 0
+
+        page_iter = iterator._page_iter(increment=False)
+        next(page_iter)
+
+        # results should still be 0 after fetching a page.
+        assert iterator.num_results == 0
+
+    def test__items_iter(self):
+        # Items to be returned.
+        item1 = 17
+        item2 = 100
+        item3 = 211
+
+        # Make pages from mock responses
+        parent = mock.sentinel.parent
+        page1 = page_iterator.Page(
+            parent, (item1, item2), page_iterator._item_to_value_identity
+        )
+        page2 = page_iterator.Page(
+            parent, (item3,), page_iterator._item_to_value_identity
+        )
+
+        iterator = PageIteratorImpl(None, None)
+        iterator._next_page = mock.Mock(side_effect=[page1, page2, None])
+
+        items_iter = iterator._items_iter()
+
+        assert isinstance(items_iter, types.GeneratorType)
+
+        # Consume items and check the state of the iterator.
+        assert iterator.num_results == 0
+
+        assert six.next(items_iter) == item1
+        assert iterator.num_results == 1
+
+        assert six.next(items_iter) == item2
+        assert iterator.num_results == 2
+
+        assert six.next(items_iter) == item3
+        assert iterator.num_results == 3
+
+        with pytest.raises(StopIteration):
+            six.next(items_iter)
+
+    def test___iter__(self):
+        iterator = PageIteratorImpl(None, None)
+        iterator._next_page = mock.Mock(side_effect=[(1, 2), (3,), None])
+
+        assert not iterator._started
+
+        result = list(iterator)
+
+        assert result == [1, 2, 3]
+        assert iterator._started
+
+    def test___iter__restart(self):
+        iterator = PageIteratorImpl(None, None)
+
+        iter(iterator)
+
+        # Make sure we cannot restart.
+        with pytest.raises(ValueError):
+            iter(iterator)
+
+    def test___iter___restart_after_page(self):
+        iterator = PageIteratorImpl(None, None)
+
+        assert iterator.pages
+
+        # Make sure we cannot restart after starting the page iterator
+        with pytest.raises(ValueError):
+            iter(iterator)
+
+
+class TestHTTPIterator(object):
+    def test_constructor(self):
+        client = mock.sentinel.client
+        path = "/foo"
+        iterator = page_iterator.HTTPIterator(
+            client, mock.sentinel.api_request, path, mock.sentinel.item_to_value
+        )
+
+        assert not iterator._started
+        assert iterator.client is client
+        assert iterator.path == path
+        assert iterator.item_to_value is mock.sentinel.item_to_value
+        assert iterator._items_key == "items"
+        assert iterator.max_results is None
+        assert iterator.extra_params == {}
+        assert iterator._page_start == page_iterator._do_nothing_page_start
+        # Changing attributes.
+        assert iterator.page_number == 0
+        assert iterator.next_page_token is None
+        assert iterator.num_results == 0
+
+    def test_constructor_w_extra_param_collision(self):
+        extra_params = {"pageToken": "val"}
+
+        with pytest.raises(ValueError):
+            page_iterator.HTTPIterator(
+                mock.sentinel.client,
+                mock.sentinel.api_request,
+                mock.sentinel.path,
+                mock.sentinel.item_to_value,
+                extra_params=extra_params,
+            )
+
+    def test_iterate(self):
+        path = "/foo"
+        item1 = {"name": "1"}
+        item2 = {"name": "2"}
+        api_request = mock.Mock(return_value={"items": [item1, item2]})
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            api_request,
+            path=path,
+            item_to_value=page_iterator._item_to_value_identity,
+        )
+
+        assert iterator.num_results == 0
+
+        items_iter = iter(iterator)
+
+        val1 = six.next(items_iter)
+        assert val1 == item1
+        assert iterator.num_results == 1
+
+        val2 = six.next(items_iter)
+        assert val2 == item2
+        assert iterator.num_results == 2
+
+        with pytest.raises(StopIteration):
+            six.next(items_iter)
+
+        api_request.assert_called_once_with(method="GET", path=path, query_params={})
+
+    def test__has_next_page_new(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+        )
+
+        # The iterator should *always* indicate that it has a next page
+        # when created so that it can fetch the initial page.
+        assert iterator._has_next_page()
+
+    def test__has_next_page_without_token(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+        )
+
+        iterator.page_number = 1
+
+        # The iterator should not indicate that it has a new page if the
+        # initial page has been requested and there's no page token.
+        assert not iterator._has_next_page()
+
+    def test__has_next_page_w_number_w_token(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+        )
+
+        iterator.page_number = 1
+        iterator.next_page_token = mock.sentinel.token
+
+        # The iterator should indicate that it has a new page if the
+        # initial page has been requested and there's is a page token.
+        assert iterator._has_next_page()
+
+    def test__has_next_page_w_max_results_not_done(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+            max_results=3,
+            page_token=mock.sentinel.token,
+        )
+
+        iterator.page_number = 1
+
+        # The iterator should indicate that it has a new page if there
+        # is a page token and it has not consumed more than max_results.
+        assert iterator.num_results < iterator.max_results
+        assert iterator._has_next_page()
+
+    def test__has_next_page_w_max_results_done(self):
+
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+            max_results=3,
+            page_token=mock.sentinel.token,
+        )
+
+        iterator.page_number = 1
+        iterator.num_results = 3
+
+        # The iterator should not indicate that it has a new page if there
+        # if it has consumed more than max_results.
+        assert iterator.num_results == iterator.max_results
+        assert not iterator._has_next_page()
+
+    def test__get_query_params_no_token(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+        )
+
+        assert iterator._get_query_params() == {}
+
+    def test__get_query_params_w_token(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+        )
+        iterator.next_page_token = "token"
+
+        assert iterator._get_query_params() == {"pageToken": iterator.next_page_token}
+
+    def test__get_query_params_w_max_results(self):
+        max_results = 3
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+            max_results=max_results,
+        )
+
+        iterator.num_results = 1
+        local_max = max_results - iterator.num_results
+
+        assert iterator._get_query_params() == {"maxResults": local_max}
+
+    def test__get_query_params_extra_params(self):
+        extra_params = {"key": "val"}
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+            extra_params=extra_params,
+        )
+
+        assert iterator._get_query_params() == extra_params
+
+    def test__get_next_page_response_with_post(self):
+        path = "/foo"
+        page_response = {"items": ["one", "two"]}
+        api_request = mock.Mock(return_value=page_response)
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            api_request,
+            path=path,
+            item_to_value=page_iterator._item_to_value_identity,
+        )
+        iterator._HTTP_METHOD = "POST"
+
+        response = iterator._get_next_page_response()
+
+        assert response == page_response
+
+        api_request.assert_called_once_with(method="POST", path=path, data={})
+
+    def test__get_next_page_bad_http_method(self):
+        iterator = page_iterator.HTTPIterator(
+            mock.sentinel.client,
+            mock.sentinel.api_request,
+            mock.sentinel.path,
+            mock.sentinel.item_to_value,
+        )
+        iterator._HTTP_METHOD = "NOT-A-VERB"
+
+        with pytest.raises(ValueError):
+            iterator._get_next_page_response()
+
+
+class TestGRPCIterator(object):
+    def test_constructor(self):
+        client = mock.sentinel.client
+        items_field = "items"
+        iterator = page_iterator.GRPCIterator(
+            client, mock.sentinel.method, mock.sentinel.request, items_field
+        )
+
+        assert not iterator._started
+        assert iterator.client is client
+        assert iterator.max_results is None
+        assert iterator.item_to_value is page_iterator._item_to_value_identity
+        assert iterator._method == mock.sentinel.method
+        assert iterator._request == mock.sentinel.request
+        assert iterator._items_field == items_field
+        assert (
+            iterator._request_token_field
+            == page_iterator.GRPCIterator._DEFAULT_REQUEST_TOKEN_FIELD
+        )
+        assert (
+            iterator._response_token_field
+            == page_iterator.GRPCIterator._DEFAULT_RESPONSE_TOKEN_FIELD
+        )
+        # Changing attributes.
+        assert iterator.page_number == 0
+        assert iterator.next_page_token is None
+        assert iterator.num_results == 0
+
+    def test_constructor_options(self):
+        client = mock.sentinel.client
+        items_field = "items"
+        request_field = "request"
+        response_field = "response"
+        iterator = page_iterator.GRPCIterator(
+            client,
+            mock.sentinel.method,
+            mock.sentinel.request,
+            items_field,
+            item_to_value=mock.sentinel.item_to_value,
+            request_token_field=request_field,
+            response_token_field=response_field,
+            max_results=42,
+        )
+
+        assert iterator.client is client
+        assert iterator.max_results == 42
+        assert iterator.item_to_value is mock.sentinel.item_to_value
+        assert iterator._method == mock.sentinel.method
+        assert iterator._request == mock.sentinel.request
+        assert iterator._items_field == items_field
+        assert iterator._request_token_field == request_field
+        assert iterator._response_token_field == response_field
+
+    def test_iterate(self):
+        request = mock.Mock(spec=["page_token"], page_token=None)
+        response1 = mock.Mock(items=["a", "b"], next_page_token="1")
+        response2 = mock.Mock(items=["c"], next_page_token="2")
+        response3 = mock.Mock(items=["d"], next_page_token="")
+        method = mock.Mock(side_effect=[response1, response2, response3])
+        iterator = page_iterator.GRPCIterator(
+            mock.sentinel.client, method, request, "items"
+        )
+
+        assert iterator.num_results == 0
+
+        items = list(iterator)
+        assert items == ["a", "b", "c", "d"]
+
+        method.assert_called_with(request)
+        assert method.call_count == 3
+        assert request.page_token == "2"
+
+    def test_iterate_with_max_results(self):
+        request = mock.Mock(spec=["page_token"], page_token=None)
+        response1 = mock.Mock(items=["a", "b"], next_page_token="1")
+        response2 = mock.Mock(items=["c"], next_page_token="2")
+        response3 = mock.Mock(items=["d"], next_page_token="")
+        method = mock.Mock(side_effect=[response1, response2, response3])
+        iterator = page_iterator.GRPCIterator(
+            mock.sentinel.client, method, request, "items", max_results=3
+        )
+
+        assert iterator.num_results == 0
+
+        items = list(iterator)
+
+        assert items == ["a", "b", "c"]
+        assert iterator.num_results == 3
+
+        method.assert_called_with(request)
+        assert method.call_count == 2
+        assert request.page_token == "1"
+
+
+class GAXPageIterator(object):
+    """Fake object that matches gax.PageIterator"""
+
+    def __init__(self, pages, page_token=None):
+        self._pages = iter(pages)
+        self.page_token = page_token
+
+    def next(self):
+        return six.next(self._pages)
+
+    __next__ = next
+
+
+class TestGAXIterator(object):
+    def test_constructor(self):
+        client = mock.sentinel.client
+        token = "zzzyy78kl"
+        page_iter = GAXPageIterator((), page_token=token)
+        item_to_value = page_iterator._item_to_value_identity
+        max_results = 1337
+        iterator = page_iterator._GAXIterator(
+            client, page_iter, item_to_value, max_results=max_results
+        )
+
+        assert not iterator._started
+        assert iterator.client is client
+        assert iterator.item_to_value is item_to_value
+        assert iterator.max_results == max_results
+        assert iterator._gax_page_iter is page_iter
+        # Changing attributes.
+        assert iterator.page_number == 0
+        assert iterator.next_page_token == token
+        assert iterator.num_results == 0
+
+    def test__next_page(self):
+        page_items = (29, 31)
+        page_token = "2sde98ds2s0hh"
+        page_iter = GAXPageIterator([page_items], page_token=page_token)
+        iterator = page_iterator._GAXIterator(
+            mock.sentinel.client, page_iter, page_iterator._item_to_value_identity
+        )
+
+        page = iterator._next_page()
+
+        assert iterator.next_page_token == page_token
+        assert isinstance(page, page_iterator.Page)
+        assert list(page) == list(page_items)
+
+        next_page = iterator._next_page()
+
+        assert next_page is None
diff --git a/api_core/tests/unit/test_path_template.py b/api_core/tests/unit/test_path_template.py
new file mode 100644
index 000000000000..4c8a7c5e7e7f
--- /dev/null
+++ b/api_core/tests/unit/test_path_template.py
@@ -0,0 +1,115 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import unicode_literals
+
+import mock
+import pytest
+
+from google.api_core import path_template
+
+
+@pytest.mark.parametrize(
+    "tmpl, args, kwargs, expected_result",
+    [
+        # Basic positional params
+        ["/v1/*", ["a"], {}, "/v1/a"],
+        ["/v1/**", ["a/b"], {}, "/v1/a/b"],
+        ["/v1/*/*", ["a", "b"], {}, "/v1/a/b"],
+        ["/v1/*/*/**", ["a", "b", "c/d"], {}, "/v1/a/b/c/d"],
+        # Basic named params
+        ["/v1/{name}", [], {"name": "parent"}, "/v1/parent"],
+        ["/v1/{name=**}", [], {"name": "parent/child"}, "/v1/parent/child"],
+        # Named params with a sub-template
+        ["/v1/{name=parent/*}", [], {"name": "parent/child"}, "/v1/parent/child"],
+        [
+            "/v1/{name=parent/**}",
+            [],
+            {"name": "parent/child/object"},
+            "/v1/parent/child/object",
+        ],
+        # Combining positional and named params
+        ["/v1/*/{name}", ["a"], {"name": "parent"}, "/v1/a/parent"],
+        ["/v1/{name}/*", ["a"], {"name": "parent"}, "/v1/parent/a"],
+        [
+            "/v1/{parent}/*/{child}/*",
+            ["a", "b"],
+            {"parent": "thor", "child": "thorson"},
+            "/v1/thor/a/thorson/b",
+        ],
+        ["/v1/{name}/**", ["a/b"], {"name": "parent"}, "/v1/parent/a/b"],
+        # Combining positional and named params with sub-templates.
+        [
+            "/v1/{name=parent/*}/*",
+            ["a"],
+            {"name": "parent/child"},
+            "/v1/parent/child/a",
+        ],
+        [
+            "/v1/*/{name=parent/**}",
+            ["a"],
+            {"name": "parent/child/object"},
+            "/v1/a/parent/child/object",
+        ],
+    ],
+)
+def test_expand_success(tmpl, args, kwargs, expected_result):
+    result = path_template.expand(tmpl, *args, **kwargs)
+    assert result == expected_result
+    assert path_template.validate(tmpl, result)
+
+
+@pytest.mark.parametrize(
+    "tmpl, args, kwargs, exc_match",
+    [
+        # Missing positional arg.
+        ["v1/*", [], {}, "Positional"],
+        # Missing named arg.
+        ["v1/{name}", [], {}, "Named"],
+    ],
+)
+def test_expanded_failure(tmpl, args, kwargs, exc_match):
+    with pytest.raises(ValueError, match=exc_match):
+        path_template.expand(tmpl, *args, **kwargs)
+
+
+@pytest.mark.parametrize(
+    "tmpl, path",
+    [
+        # Single segment template, but multi segment value
+        ["v1/*", "v1/a/b"],
+        ["v1/*/*", "v1/a/b/c"],
+        # Single segement named template, but multi segment value
+        ["v1/{name}", "v1/a/b"],
+        ["v1/{name}/{value}", "v1/a/b/c"],
+        # Named value with a sub-template but invalid value
+        ["v1/{name=parent/*}", "v1/grandparent/child"],
+    ],
+)
+def test_validate_failure(tmpl, path):
+    assert not path_template.validate(tmpl, path)
+
+
+def test__expand_variable_match_unexpected():
+    match = mock.Mock(spec=["group"])
+    match.group.return_value = None
+    with pytest.raises(ValueError, match="Unknown"):
+        path_template._expand_variable_match([], {}, match)
+
+
+def test__replace_variable_with_pattern():
+    match = mock.Mock(spec=["group"])
+    match.group.return_value = None
+    with pytest.raises(ValueError, match="Unknown"):
+        path_template._replace_variable_with_pattern(match)
diff --git a/api_core/tests/unit/test_protobuf_helpers.py b/api_core/tests/unit/test_protobuf_helpers.py
new file mode 100644
index 000000000000..db972383120a
--- /dev/null
+++ b/api_core/tests/unit/test_protobuf_helpers.py
@@ -0,0 +1,474 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pytest
+
+from google.api import http_pb2
+from google.api_core import protobuf_helpers
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import message
+from google.protobuf import source_context_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import type_pb2
+from google.protobuf import wrappers_pb2
+from google.type import color_pb2
+from google.type import date_pb2
+from google.type import timeofday_pb2
+
+
+def test_from_any_pb_success():
+    in_message = date_pb2.Date(year=1990)
+    in_message_any = any_pb2.Any()
+    in_message_any.Pack(in_message)
+    out_message = protobuf_helpers.from_any_pb(date_pb2.Date, in_message_any)
+
+    assert in_message == out_message
+
+
+def test_from_any_pb_wrapped_success():
+    # Declare a message class conforming to wrapped messages.
+    class WrappedDate(object):
+        def __init__(self, **kwargs):
+            self._pb = date_pb2.Date(**kwargs)
+
+        def __eq__(self, other):
+            return self._pb == other
+
+        @classmethod
+        def pb(cls, msg):
+            return msg._pb
+
+    # Run the same test as `test_from_any_pb_success`, but using the
+    # wrapped class.
+    in_message = date_pb2.Date(year=1990)
+    in_message_any = any_pb2.Any()
+    in_message_any.Pack(in_message)
+    out_message = protobuf_helpers.from_any_pb(WrappedDate, in_message_any)
+
+    assert out_message == in_message
+
+
+def test_from_any_pb_failure():
+    in_message = any_pb2.Any()
+    in_message.Pack(date_pb2.Date(year=1990))
+
+    with pytest.raises(TypeError):
+        protobuf_helpers.from_any_pb(timeofday_pb2.TimeOfDay, in_message)
+
+
+def test_check_protobuf_helpers_ok():
+    assert protobuf_helpers.check_oneof() is None
+    assert protobuf_helpers.check_oneof(foo="bar") is None
+    assert protobuf_helpers.check_oneof(foo="bar", baz=None) is None
+    assert protobuf_helpers.check_oneof(foo=None, baz="bacon") is None
+    assert protobuf_helpers.check_oneof(foo="bar", spam=None, eggs=None) is None
+
+
+def test_check_protobuf_helpers_failures():
+    with pytest.raises(ValueError):
+        protobuf_helpers.check_oneof(foo="bar", spam="eggs")
+    with pytest.raises(ValueError):
+        protobuf_helpers.check_oneof(foo="bar", baz="bacon", spam="eggs")
+    with pytest.raises(ValueError):
+        protobuf_helpers.check_oneof(foo="bar", spam=0, eggs=None)
+
+
+def test_get_messages():
+    answer = protobuf_helpers.get_messages(date_pb2)
+
+    # Ensure that Date was exported properly.
+    assert answer["Date"] is date_pb2.Date
+
+    # Ensure that no non-Message objects were exported.
+    for value in answer.values():
+        assert issubclass(value, message.Message)
+
+
+def test_get_dict_absent():
+    with pytest.raises(KeyError):
+        assert protobuf_helpers.get({}, "foo")
+
+
+def test_get_dict_present():
+    assert protobuf_helpers.get({"foo": "bar"}, "foo") == "bar"
+
+
+def test_get_dict_default():
+    assert protobuf_helpers.get({}, "foo", default="bar") == "bar"
+
+
+def test_get_dict_nested():
+    assert protobuf_helpers.get({"foo": {"bar": "baz"}}, "foo.bar") == "baz"
+
+
+def test_get_dict_nested_default():
+    assert protobuf_helpers.get({}, "foo.baz", default="bacon") == "bacon"
+    assert protobuf_helpers.get({"foo": {}}, "foo.baz", default="bacon") == "bacon"
+
+
+def test_get_msg_sentinel():
+    msg = timestamp_pb2.Timestamp()
+    with pytest.raises(KeyError):
+        assert protobuf_helpers.get(msg, "foo")
+
+
+def test_get_msg_present():
+    msg = timestamp_pb2.Timestamp(seconds=42)
+    assert protobuf_helpers.get(msg, "seconds") == 42
+
+
+def test_get_msg_default():
+    msg = timestamp_pb2.Timestamp()
+    assert protobuf_helpers.get(msg, "foo", default="bar") == "bar"
+
+
+def test_invalid_object():
+    with pytest.raises(TypeError):
+        protobuf_helpers.get(object(), "foo", "bar")
+
+
+def test_set_dict():
+    mapping = {}
+    protobuf_helpers.set(mapping, "foo", "bar")
+    assert mapping == {"foo": "bar"}
+
+
+def test_set_msg():
+    msg = timestamp_pb2.Timestamp()
+    protobuf_helpers.set(msg, "seconds", 42)
+    assert msg.seconds == 42
+
+
+def test_set_dict_nested():
+    mapping = {}
+    protobuf_helpers.set(mapping, "foo.bar", "baz")
+    assert mapping == {"foo": {"bar": "baz"}}
+
+
+def test_set_invalid_object():
+    with pytest.raises(TypeError):
+        protobuf_helpers.set(object(), "foo", "bar")
+
+
+def test_set_list():
+    list_ops_response = operations_pb2.ListOperationsResponse()
+
+    protobuf_helpers.set(
+        list_ops_response,
+        "operations",
+        [{"name": "foo"}, operations_pb2.Operation(name="bar")],
+    )
+
+    assert len(list_ops_response.operations) == 2
+
+    for operation in list_ops_response.operations:
+        assert isinstance(operation, operations_pb2.Operation)
+
+    assert list_ops_response.operations[0].name == "foo"
+    assert list_ops_response.operations[1].name == "bar"
+
+
+def test_set_list_clear_existing():
+    list_ops_response = operations_pb2.ListOperationsResponse(
+        operations=[{"name": "baz"}]
+    )
+
+    protobuf_helpers.set(
+        list_ops_response,
+        "operations",
+        [{"name": "foo"}, operations_pb2.Operation(name="bar")],
+    )
+
+    assert len(list_ops_response.operations) == 2
+    for operation in list_ops_response.operations:
+        assert isinstance(operation, operations_pb2.Operation)
+    assert list_ops_response.operations[0].name == "foo"
+    assert list_ops_response.operations[1].name == "bar"
+
+
+def test_set_msg_with_msg_field():
+    rule = http_pb2.HttpRule()
+    pattern = http_pb2.CustomHttpPattern(kind="foo", path="bar")
+
+    protobuf_helpers.set(rule, "custom", pattern)
+
+    assert rule.custom.kind == "foo"
+    assert rule.custom.path == "bar"
+
+
+def test_set_msg_with_dict_field():
+    rule = http_pb2.HttpRule()
+    pattern = {"kind": "foo", "path": "bar"}
+
+    protobuf_helpers.set(rule, "custom", pattern)
+
+    assert rule.custom.kind == "foo"
+    assert rule.custom.path == "bar"
+
+
+def test_set_msg_nested_key():
+    rule = http_pb2.HttpRule(custom=http_pb2.CustomHttpPattern(kind="foo", path="bar"))
+
+    protobuf_helpers.set(rule, "custom.kind", "baz")
+
+    assert rule.custom.kind == "baz"
+    assert rule.custom.path == "bar"
+
+
+def test_setdefault_dict_unset():
+    mapping = {}
+    protobuf_helpers.setdefault(mapping, "foo", "bar")
+    assert mapping == {"foo": "bar"}
+
+
+def test_setdefault_dict_falsy():
+    mapping = {"foo": None}
+    protobuf_helpers.setdefault(mapping, "foo", "bar")
+    assert mapping == {"foo": "bar"}
+
+
+def test_setdefault_dict_truthy():
+    mapping = {"foo": "bar"}
+    protobuf_helpers.setdefault(mapping, "foo", "baz")
+    assert mapping == {"foo": "bar"}
+
+
+def test_setdefault_pb2_falsy():
+    operation = operations_pb2.Operation()
+    protobuf_helpers.setdefault(operation, "name", "foo")
+    assert operation.name == "foo"
+
+
+def test_setdefault_pb2_truthy():
+    operation = operations_pb2.Operation(name="bar")
+    protobuf_helpers.setdefault(operation, "name", "foo")
+    assert operation.name == "bar"
+
+
+def test_field_mask_invalid_args():
+    with pytest.raises(ValueError):
+        protobuf_helpers.field_mask("foo", any_pb2.Any())
+    with pytest.raises(ValueError):
+        protobuf_helpers.field_mask(any_pb2.Any(), "bar")
+    with pytest.raises(ValueError):
+        protobuf_helpers.field_mask(any_pb2.Any(), operations_pb2.Operation())
+
+
+def test_field_mask_equal_values():
+    assert protobuf_helpers.field_mask(None, None).paths == []
+
+    original = struct_pb2.Value(number_value=1.0)
+    modified = struct_pb2.Value(number_value=1.0)
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    modified = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = struct_pb2.ListValue(values=[struct_pb2.Value(number_value=1.0)])
+    modified = struct_pb2.ListValue(values=[struct_pb2.Value(number_value=1.0)])
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = struct_pb2.Struct(fields={"bar": struct_pb2.Value(number_value=1.0)})
+    modified = struct_pb2.Struct(fields={"bar": struct_pb2.Value(number_value=1.0)})
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+
+def test_field_mask_zero_values():
+    # Singular Values
+    original = color_pb2.Color(red=0.0)
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = None
+    modified = color_pb2.Color(red=0.0)
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    # Repeated Values
+    original = struct_pb2.ListValue(values=[])
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = None
+    modified = struct_pb2.ListValue(values=[])
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    # Maps
+    original = struct_pb2.Struct(fields={})
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = None
+    modified = struct_pb2.Struct(fields={})
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    # Oneofs
+    original = struct_pb2.Value(number_value=0.0)
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+    original = None
+    modified = struct_pb2.Value(number_value=0.0)
+    assert protobuf_helpers.field_mask(original, modified).paths == []
+
+
+def test_field_mask_singular_field_diffs():
+    original = type_pb2.Type(name="name")
+    modified = type_pb2.Type()
+    assert protobuf_helpers.field_mask(original, modified).paths == ["name"]
+
+    original = type_pb2.Type(name="name")
+    modified = type_pb2.Type()
+    assert protobuf_helpers.field_mask(original, modified).paths == ["name"]
+
+    original = None
+    modified = type_pb2.Type(name="name")
+    assert protobuf_helpers.field_mask(original, modified).paths == ["name"]
+
+    original = type_pb2.Type(name="name")
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == ["name"]
+
+
+def test_field_mask_message_diffs():
+    original = type_pb2.Type()
+    modified = type_pb2.Type(
+        source_context=source_context_pb2.SourceContext(file_name="name")
+    )
+    assert protobuf_helpers.field_mask(original, modified).paths == [
+        "source_context.file_name"
+    ]
+
+    original = type_pb2.Type(
+        source_context=source_context_pb2.SourceContext(file_name="name")
+    )
+    modified = type_pb2.Type()
+    assert protobuf_helpers.field_mask(original, modified).paths == ["source_context"]
+
+    original = type_pb2.Type(
+        source_context=source_context_pb2.SourceContext(file_name="name")
+    )
+    modified = type_pb2.Type(
+        source_context=source_context_pb2.SourceContext(file_name="other_name")
+    )
+    assert protobuf_helpers.field_mask(original, modified).paths == [
+        "source_context.file_name"
+    ]
+
+    original = None
+    modified = type_pb2.Type(
+        source_context=source_context_pb2.SourceContext(file_name="name")
+    )
+    assert protobuf_helpers.field_mask(original, modified).paths == [
+        "source_context.file_name"
+    ]
+
+    original = type_pb2.Type(
+        source_context=source_context_pb2.SourceContext(file_name="name")
+    )
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == ["source_context"]
+
+
+def test_field_mask_wrapper_type_diffs():
+    original = color_pb2.Color()
+    modified = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    assert protobuf_helpers.field_mask(original, modified).paths == ["alpha"]
+
+    original = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    modified = color_pb2.Color()
+    assert protobuf_helpers.field_mask(original, modified).paths == ["alpha"]
+
+    original = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    modified = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=2.0))
+    assert protobuf_helpers.field_mask(original, modified).paths == ["alpha"]
+
+    original = None
+    modified = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=2.0))
+    assert protobuf_helpers.field_mask(original, modified).paths == ["alpha"]
+
+    original = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == ["alpha"]
+
+
+def test_field_mask_repeated_diffs():
+    original = struct_pb2.ListValue()
+    modified = struct_pb2.ListValue(
+        values=[struct_pb2.Value(number_value=1.0), struct_pb2.Value(number_value=2.0)]
+    )
+    assert protobuf_helpers.field_mask(original, modified).paths == ["values"]
+
+    original = struct_pb2.ListValue(
+        values=[struct_pb2.Value(number_value=1.0), struct_pb2.Value(number_value=2.0)]
+    )
+    modified = struct_pb2.ListValue()
+    assert protobuf_helpers.field_mask(original, modified).paths == ["values"]
+
+    original = None
+    modified = struct_pb2.ListValue(
+        values=[struct_pb2.Value(number_value=1.0), struct_pb2.Value(number_value=2.0)]
+    )
+    assert protobuf_helpers.field_mask(original, modified).paths == ["values"]
+
+    original = struct_pb2.ListValue(
+        values=[struct_pb2.Value(number_value=1.0), struct_pb2.Value(number_value=2.0)]
+    )
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == ["values"]
+
+    original = struct_pb2.ListValue(
+        values=[struct_pb2.Value(number_value=1.0), struct_pb2.Value(number_value=2.0)]
+    )
+    modified = struct_pb2.ListValue(
+        values=[struct_pb2.Value(number_value=2.0), struct_pb2.Value(number_value=1.0)]
+    )
+    assert protobuf_helpers.field_mask(original, modified).paths == ["values"]
+
+
+def test_field_mask_map_diffs():
+    original = struct_pb2.Struct()
+    modified = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=1.0)})
+    assert protobuf_helpers.field_mask(original, modified).paths == ["fields"]
+
+    original = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=1.0)})
+    modified = struct_pb2.Struct()
+    assert protobuf_helpers.field_mask(original, modified).paths == ["fields"]
+
+    original = None
+    modified = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=1.0)})
+    assert protobuf_helpers.field_mask(original, modified).paths == ["fields"]
+
+    original = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=1.0)})
+    modified = None
+    assert protobuf_helpers.field_mask(original, modified).paths == ["fields"]
+
+    original = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=1.0)})
+    modified = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=2.0)})
+    assert protobuf_helpers.field_mask(original, modified).paths == ["fields"]
+
+    original = struct_pb2.Struct(fields={"foo": struct_pb2.Value(number_value=1.0)})
+    modified = struct_pb2.Struct(fields={"bar": struct_pb2.Value(number_value=1.0)})
+    assert protobuf_helpers.field_mask(original, modified).paths == ["fields"]
+
+
+def test_field_mask_different_level_diffs():
+    original = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=1.0))
+    modified = color_pb2.Color(alpha=wrappers_pb2.FloatValue(value=2.0), red=1.0)
+    assert sorted(protobuf_helpers.field_mask(original, modified).paths) == [
+        "alpha",
+        "red",
+    ]
diff --git a/api_core/tests/unit/test_retry.py b/api_core/tests/unit/test_retry.py
new file mode 100644
index 000000000000..5b5e59b8eb40
--- /dev/null
+++ b/api_core/tests/unit/test_retry.py
@@ -0,0 +1,312 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import itertools
+import re
+
+import mock
+import pytest
+
+from google.api_core import exceptions
+from google.api_core import retry
+
+
+def test_if_exception_type():
+    predicate = retry.if_exception_type(ValueError)
+
+    assert predicate(ValueError())
+    assert not predicate(TypeError())
+
+
+def test_if_exception_type_multiple():
+    predicate = retry.if_exception_type(ValueError, TypeError)
+
+    assert predicate(ValueError())
+    assert predicate(TypeError())
+    assert not predicate(RuntimeError())
+
+
+def test_if_transient_error():
+    assert retry.if_transient_error(exceptions.InternalServerError(""))
+    assert retry.if_transient_error(exceptions.TooManyRequests(""))
+    assert retry.if_transient_error(exceptions.ServiceUnavailable(""))
+    assert not retry.if_transient_error(exceptions.InvalidArgument(""))
+
+
+# Make uniform return half of its maximum, which will be the calculated
+# sleep time.
+@mock.patch("random.uniform", autospec=True, side_effect=lambda m, n: n / 2.0)
+def test_exponential_sleep_generator_base_2(uniform):
+    gen = retry.exponential_sleep_generator(1, 60, multiplier=2)
+
+    result = list(itertools.islice(gen, 8))
+    assert result == [1, 2, 4, 8, 16, 32, 60, 60]
+
+
+@mock.patch("time.sleep", autospec=True)
+@mock.patch(
+    "google.api_core.datetime_helpers.utcnow",
+    return_value=datetime.datetime.min,
+    autospec=True,
+)
+def test_retry_target_success(utcnow, sleep):
+    predicate = retry.if_exception_type(ValueError)
+    call_count = [0]
+
+    def target():
+        call_count[0] += 1
+        if call_count[0] < 3:
+            raise ValueError()
+        return 42
+
+    result = retry.retry_target(target, predicate, range(10), None)
+
+    assert result == 42
+    assert call_count[0] == 3
+    sleep.assert_has_calls([mock.call(0), mock.call(1)])
+
+
+@mock.patch("time.sleep", autospec=True)
+@mock.patch(
+    "google.api_core.datetime_helpers.utcnow",
+    return_value=datetime.datetime.min,
+    autospec=True,
+)
+def test_retry_target_w_on_error(utcnow, sleep):
+    predicate = retry.if_exception_type(ValueError)
+    call_count = {"target": 0}
+    to_raise = ValueError()
+
+    def target():
+        call_count["target"] += 1
+        if call_count["target"] < 3:
+            raise to_raise
+        return 42
+
+    on_error = mock.Mock()
+
+    result = retry.retry_target(target, predicate, range(10), None, on_error=on_error)
+
+    assert result == 42
+    assert call_count["target"] == 3
+
+    on_error.assert_has_calls([mock.call(to_raise), mock.call(to_raise)])
+    sleep.assert_has_calls([mock.call(0), mock.call(1)])
+
+
+@mock.patch("time.sleep", autospec=True)
+@mock.patch(
+    "google.api_core.datetime_helpers.utcnow",
+    return_value=datetime.datetime.min,
+    autospec=True,
+)
+def test_retry_target_non_retryable_error(utcnow, sleep):
+    predicate = retry.if_exception_type(ValueError)
+    exception = TypeError()
+    target = mock.Mock(side_effect=exception)
+
+    with pytest.raises(TypeError) as exc_info:
+        retry.retry_target(target, predicate, range(10), None)
+
+    assert exc_info.value == exception
+    sleep.assert_not_called()
+
+
+@mock.patch("time.sleep", autospec=True)
+@mock.patch("google.api_core.datetime_helpers.utcnow", autospec=True)
+def test_retry_target_deadline_exceeded(utcnow, sleep):
+    predicate = retry.if_exception_type(ValueError)
+    exception = ValueError("meep")
+    target = mock.Mock(side_effect=exception)
+    # Setup the timeline so that the first call takes 5 seconds but the second
+    # call takes 6, which puts the retry over the deadline.
+    utcnow.side_effect = [
+        # The first call to utcnow establishes the start of the timeline.
+        datetime.datetime.min,
+        datetime.datetime.min + datetime.timedelta(seconds=5),
+        datetime.datetime.min + datetime.timedelta(seconds=11),
+    ]
+
+    with pytest.raises(exceptions.RetryError) as exc_info:
+        retry.retry_target(target, predicate, range(10), deadline=10)
+
+    assert exc_info.value.cause == exception
+    assert exc_info.match("Deadline of 10.0s exceeded")
+    assert exc_info.match("last exception: meep")
+    assert target.call_count == 2
+
+
+def test_retry_target_bad_sleep_generator():
+    with pytest.raises(ValueError, match="Sleep generator"):
+        retry.retry_target(mock.sentinel.target, mock.sentinel.predicate, [], None)
+
+
+class TestRetry(object):
+    def test_constructor_defaults(self):
+        retry_ = retry.Retry()
+        assert retry_._predicate == retry.if_transient_error
+        assert retry_._initial == 1
+        assert retry_._maximum == 60
+        assert retry_._multiplier == 2
+        assert retry_._deadline == 120
+        assert retry_._on_error is None
+
+    def test_constructor_options(self):
+        _some_function = mock.Mock()
+
+        retry_ = retry.Retry(
+            predicate=mock.sentinel.predicate,
+            initial=1,
+            maximum=2,
+            multiplier=3,
+            deadline=4,
+            on_error=_some_function,
+        )
+        assert retry_._predicate == mock.sentinel.predicate
+        assert retry_._initial == 1
+        assert retry_._maximum == 2
+        assert retry_._multiplier == 3
+        assert retry_._deadline == 4
+        assert retry_._on_error is _some_function
+
+    def test_with_deadline(self):
+        retry_ = retry.Retry()
+        new_retry = retry_.with_deadline(42)
+        assert retry_ is not new_retry
+        assert new_retry._deadline == 42
+
+    def test_with_predicate(self):
+        retry_ = retry.Retry()
+        new_retry = retry_.with_predicate(mock.sentinel.predicate)
+        assert retry_ is not new_retry
+        assert new_retry._predicate == mock.sentinel.predicate
+
+    def test_with_delay_noop(self):
+        retry_ = retry.Retry()
+        new_retry = retry_.with_delay()
+        assert retry_ is not new_retry
+        assert new_retry._initial == retry_._initial
+        assert new_retry._maximum == retry_._maximum
+        assert new_retry._multiplier == retry_._multiplier
+
+    def test_with_delay(self):
+        retry_ = retry.Retry()
+        new_retry = retry_.with_delay(initial=1, maximum=2, multiplier=3)
+        assert retry_ is not new_retry
+        assert new_retry._initial == 1
+        assert new_retry._maximum == 2
+        assert new_retry._multiplier == 3
+
+    def test___str__(self):
+        retry_ = retry.Retry()
+        assert re.match(
+            (
+                r"<Retry predicate=<function.*?if_exception_type.*?>, "
+                r"initial=1.0, maximum=60.0, multiplier=2.0, deadline=120.0, "
+                r"on_error=None>"
+            ),
+            str(retry_),
+        )
+
+    @mock.patch("time.sleep", autospec=True)
+    def test___call___and_execute_success(self, sleep):
+        retry_ = retry.Retry()
+        target = mock.Mock(spec=["__call__"], return_value=42)
+        # __name__ is needed by functools.partial.
+        target.__name__ = "target"
+
+        decorated = retry_(target)
+        target.assert_not_called()
+
+        result = decorated("meep")
+
+        assert result == 42
+        target.assert_called_once_with("meep")
+        sleep.assert_not_called()
+
+    # Make uniform return half of its maximum, which is the calculated sleep time.
+    @mock.patch("random.uniform", autospec=True, side_effect=lambda m, n: n / 2.0)
+    @mock.patch("time.sleep", autospec=True)
+    def test___call___and_execute_retry(self, sleep, uniform):
+
+        on_error = mock.Mock(spec=["__call__"], side_effect=[None])
+        retry_ = retry.Retry(predicate=retry.if_exception_type(ValueError))
+
+        target = mock.Mock(spec=["__call__"], side_effect=[ValueError(), 42])
+        # __name__ is needed by functools.partial.
+        target.__name__ = "target"
+
+        decorated = retry_(target, on_error=on_error)
+        target.assert_not_called()
+
+        result = decorated("meep")
+
+        assert result == 42
+        assert target.call_count == 2
+        target.assert_has_calls([mock.call("meep"), mock.call("meep")])
+        sleep.assert_called_once_with(retry_._initial)
+        assert on_error.call_count == 1
+
+    @mock.patch("time.sleep", autospec=True)
+    def test___init___without_retry_executed(self, sleep):
+        _some_function = mock.Mock()
+
+        retry_ = retry.Retry(
+            predicate=retry.if_exception_type(ValueError), on_error=_some_function
+        )
+        # check the proper creation of the class
+        assert retry_._on_error is _some_function
+
+        target = mock.Mock(spec=["__call__"], side_effect=[42])
+        # __name__ is needed by functools.partial.
+        target.__name__ = "target"
+
+        wrapped = retry_(target)
+
+        result = wrapped("meep")
+
+        assert result == 42
+        target.assert_called_once_with("meep")
+        sleep.assert_not_called()
+        _some_function.assert_not_called()
+
+    # Make uniform return half of its maximum, which is the calculated sleep time.
+    @mock.patch("random.uniform", autospec=True, side_effect=lambda m, n: n / 2.0)
+    @mock.patch("time.sleep", autospec=True)
+    def test___init___when_retry_is_executed(self, sleep, uniform):
+        _some_function = mock.Mock()
+
+        retry_ = retry.Retry(
+            predicate=retry.if_exception_type(ValueError), on_error=_some_function
+        )
+        # check the proper creation of the class
+        assert retry_._on_error is _some_function
+
+        target = mock.Mock(
+            spec=["__call__"], side_effect=[ValueError(), ValueError(), 42]
+        )
+        # __name__ is needed by functools.partial.
+        target.__name__ = "target"
+
+        wrapped = retry_(target)
+        target.assert_not_called()
+
+        result = wrapped("meep")
+
+        assert result == 42
+        assert target.call_count == 3
+        assert _some_function.call_count == 2
+        target.assert_has_calls([mock.call("meep"), mock.call("meep")])
+        sleep.assert_any_call(retry_._initial)
diff --git a/api_core/tests/unit/test_timeout.py b/api_core/tests/unit/test_timeout.py
new file mode 100644
index 000000000000..30d624e2c0c4
--- /dev/null
+++ b/api_core/tests/unit/test_timeout.py
@@ -0,0 +1,129 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import itertools
+
+import mock
+
+from google.api_core import timeout
+
+
+def test__exponential_timeout_generator_base_2():
+    gen = timeout._exponential_timeout_generator(1.0, 60.0, 2.0, deadline=None)
+
+    result = list(itertools.islice(gen, 8))
+    assert result == [1, 2, 4, 8, 16, 32, 60, 60]
+
+
+@mock.patch("google.api_core.datetime_helpers.utcnow", autospec=True)
+def test__exponential_timeout_generator_base_deadline(utcnow):
+    # Make each successive call to utcnow() advance one second.
+    utcnow.side_effect = [
+        datetime.datetime.min + datetime.timedelta(seconds=n) for n in range(15)
+    ]
+
+    gen = timeout._exponential_timeout_generator(1.0, 60.0, 2.0, deadline=30.0)
+
+    result = list(itertools.islice(gen, 14))
+    # Should grow until the cumulative time is > 30s, then start decreasing as
+    # the cumulative time approaches 60s.
+    assert result == [1, 2, 4, 8, 16, 24, 23, 22, 21, 20, 19, 18, 17, 16]
+
+
+class TestConstantTimeout(object):
+    def test_constructor(self):
+        timeout_ = timeout.ConstantTimeout()
+        assert timeout_._timeout is None
+
+    def test_constructor_args(self):
+        timeout_ = timeout.ConstantTimeout(42.0)
+        assert timeout_._timeout == 42.0
+
+    def test___str__(self):
+        timeout_ = timeout.ConstantTimeout(1)
+        assert str(timeout_) == "<ConstantTimeout timeout=1.0>"
+
+    def test_apply(self):
+        target = mock.Mock(spec=["__call__", "__name__"], __name__="target")
+        timeout_ = timeout.ConstantTimeout(42.0)
+        wrapped = timeout_(target)
+
+        wrapped()
+
+        target.assert_called_once_with(timeout=42.0)
+
+    def test_apply_passthrough(self):
+        target = mock.Mock(spec=["__call__", "__name__"], __name__="target")
+        timeout_ = timeout.ConstantTimeout(42.0)
+        wrapped = timeout_(target)
+
+        wrapped(1, 2, meep="moop")
+
+        target.assert_called_once_with(1, 2, meep="moop", timeout=42.0)
+
+
+class TestExponentialTimeout(object):
+    def test_constructor(self):
+        timeout_ = timeout.ExponentialTimeout()
+        assert timeout_._initial == timeout._DEFAULT_INITIAL_TIMEOUT
+        assert timeout_._maximum == timeout._DEFAULT_MAXIMUM_TIMEOUT
+        assert timeout_._multiplier == timeout._DEFAULT_TIMEOUT_MULTIPLIER
+        assert timeout_._deadline == timeout._DEFAULT_DEADLINE
+
+    def test_constructor_args(self):
+        timeout_ = timeout.ExponentialTimeout(1, 2, 3, 4)
+        assert timeout_._initial == 1
+        assert timeout_._maximum == 2
+        assert timeout_._multiplier == 3
+        assert timeout_._deadline == 4
+
+    def test_with_timeout(self):
+        original_timeout = timeout.ExponentialTimeout()
+        timeout_ = original_timeout.with_deadline(42)
+        assert original_timeout is not timeout_
+        assert timeout_._initial == timeout._DEFAULT_INITIAL_TIMEOUT
+        assert timeout_._maximum == timeout._DEFAULT_MAXIMUM_TIMEOUT
+        assert timeout_._multiplier == timeout._DEFAULT_TIMEOUT_MULTIPLIER
+        assert timeout_._deadline == 42
+
+    def test___str__(self):
+        timeout_ = timeout.ExponentialTimeout(1, 2, 3, 4)
+        assert str(timeout_) == (
+            "<ExponentialTimeout initial=1.0, maximum=2.0, multiplier=3.0, "
+            "deadline=4.0>"
+        )
+
+    def test_apply(self):
+        target = mock.Mock(spec=["__call__", "__name__"], __name__="target")
+        timeout_ = timeout.ExponentialTimeout(1, 10, 2)
+        wrapped = timeout_(target)
+
+        wrapped()
+        target.assert_called_with(timeout=1)
+
+        wrapped()
+        target.assert_called_with(timeout=2)
+
+        wrapped()
+        target.assert_called_with(timeout=4)
+
+    def test_apply_passthrough(self):
+        target = mock.Mock(spec=["__call__", "__name__"], __name__="target")
+        timeout_ = timeout.ExponentialTimeout(42.0, 100, 2)
+        wrapped = timeout_(target)
+
+        wrapped(1, 2, meep="moop")
+
+        target.assert_called_once_with(1, 2, meep="moop", timeout=42.0)
diff --git a/appveyor.yml b/appveyor.yml
index e552cb428de5..fcb43d498ad1 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -1,102 +1,75 @@
 version: 1.0.{build}.{branch}
 
-environment:
-  global:
-    # SDK v7.0 MSVC Express 2008's SetEnv.cmd script will fail if the
-    # /E:ON and /V:ON options are not enabled in the batch script intepreter
-    # See: http://stackoverflow.com/a/13751649/163740
-    CMD_IN_ENV: "cmd /E:ON /V:ON /C .\\appveyor\\run_with_env.cmd"
+build: off
 
+environment:
   matrix:
 
     # Pre-installed Python versions, which Appveyor may upgrade to
     # a later point release.
     # See: http://www.appveyor.com/docs/installed-software#python
 
-    # Python 2.7.11 is the latest Python 2.7 with a Windows installer
-    # Python 2.7.11 is the overall latest
-    # https://www.python.org/ftp/python/2.7.11/
-    - PYTHON: "C:\\Python27"
-      PYTHON_VERSION: "2.7.11"
-      PYTHON_ARCH: "32"
-      TOX_ENV: "py27"
-
-    - PYTHON: "C:\\Python27-x64"
-      PYTHON_VERSION: "2.7.11"
-      PYTHON_ARCH: "64"
-      TOX_ENV: "py27"
-
-    # Python 3.4.4 is the latest Python 3.4 with a Windows installer
-    # Python 3.4.4 is the overall latest
-    # https://www.python.org/ftp/python/3.4.4/
-    - PYTHON: "C:\\Python34"
-      PYTHON_VERSION: "3.4.4"
-      PYTHON_ARCH: "32"
-      TOX_ENV: "py34"
-
-    - PYTHON: "C:\\Python34-x64"
-      PYTHON_VERSION: "3.4.4"
-      PYTHON_ARCH: "64"
-      TOX_ENV: "py34"
-
-    # Python 3.5.1 is the latest Python 3.5 with a Windows installer
-    # Python 3.5.1 is the overall latest
-    # https://www.python.org/ftp/python/3.5.1/
-    - PYTHON: "C:\\Python35"
-      PYTHON_VERSION: "3.5.1"
-      PYTHON_ARCH: "32"
-      TOX_ENV: "py35"
+    # We test on 32-bit Python 2.7, and 64-bit Python 3.x.
+    # This is because it takes too long to serially go through six to eight
+    # iterations.
 
+    - PYTHON: "C:\\Python27"
     - PYTHON: "C:\\Python35-x64"
-      PYTHON_VERSION: "3.5.1"
-      PYTHON_ARCH: "64"
-      TOX_ENV: "py35"
 
 install:
-  - ECHO "Filesystem root:"
-  - ps: "ls \"C:/\""
-
-  - ECHO "Installed SDKs:"
-  - ps: "ls \"C:/Program Files/Microsoft SDKs/Windows\""
+  - cmd: echo "Filesystem root:"
+  - dir C:\
 
-  # Install Python (from the official .msi of http://python.org) and pip when
-  # not already installed.
-  - ps: if (-not(Test-Path($env:PYTHON))) { & appveyor\install.ps1 }
+  - echo "Installed SDKs:"
+  - dir "C:\Program Files\Microsoft SDKs\Windows"
 
-  # Prepend newly installed Python to the PATH of this build (this cannot be
+  # Prepend "current" Python to the PATH of this build (this cannot be
   # done from inside the powershell script as it would require to restart
   # the parent CMD process).
-  - "SET PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
+  - SET PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%
 
-  # Check that we have the expected version and architecture for Python
-  - "python --version"
-  - "python -c \"import struct; print(struct.calcsize('P') * 8)\""
+  # https://stackoverflow.com/a/4509885/1068170
+  # Set `PYTHON_ARCH` (either 32 or 64)
+  - set PY_CMD=python -c "import platform; print(platform.architecture()[0][:2])"
+  - for /f "tokens=1 delims=" %%i in ('%PY_CMD%') do set PYTHON_ARCH=%%i
+  # Set `PYTHON_VERSION`
+  - set PY_CMD=python -c "import platform; print(platform.python_version())"
+  - for /f "tokens=1 delims=" %%i in ('%PY_CMD%') do set PYTHON_VERSION=%%i
 
-  # Upgrade to the latest version of pip to avoid it displaying warnings
-  # about it being out of date.
-  - "pip install --disable-pip-version-check --user --upgrade pip"
+  # Check that we have the expected version and architecture for Python
+  - python appveyor\env_info.py
 
-  # Install the build dependencies of the project. If some dependencies contain
-  # compiled extensions and are not provided as pre-built wheel packages,
-  # pip will build them from source using the MSVC compiler matching the
-  # target Python version and architecture
-  - "%CMD_IN_ENV% pip install -r appveyor/requirements.txt"
+  # Upgrade to the latest version of pip.
+  - python -m pip install --upgrade pip setuptools
 
-build_script:
-  # Build the compiled extension
-  - "%CMD_IN_ENV% python setup.py build"
+  # Install the build dependencies of the project (assumes all extensions
+  # are pure Python or have wheels, so they don't need to be built).
+  - python -m pip install -r appveyor\requirements.txt
 
 test_script:
-  - "%CMD_IN_ENV% pip list"
   # Run the project tests
-  - "%CMD_IN_ENV% tox -e %TOX_ENV%"
-
-after_test:
-  # If tests are successful, create binary packages for the project.
-  - "%CMD_IN_ENV% python setup.py bdist_wininst"
-  - "%CMD_IN_ENV% python setup.py bdist_msi"
-  - ps: "ls dist"
-
-artifacts:
-  # Archive the generated packages in the ci.appveyor.com build report.
-  - path: dist\*
+  - "%PYTHON%\\Scripts\\nox.exe -f api_core\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f asset\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f bigquery\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f bigquery_datatransfer\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f bigtable\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f container\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f core\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f dataproc\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f datastore\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f dns\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f error_reporting\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f firestore\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f language\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f logging\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f monitoring\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f pubsub\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f resource_manager\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f runtimeconfig\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f spanner\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f speech\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f storage\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f trace\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f translate\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f videointelligence\\nox.py -s default"
+  - "%PYTHON%\\Scripts\\nox.exe -f vision\\nox.py -s default"
diff --git a/appveyor/env_info.py b/appveyor/env_info.py
new file mode 100644
index 000000000000..c27b686dd199
--- /dev/null
+++ b/appveyor/env_info.py
@@ -0,0 +1,48 @@
+# Copyright 2017 Google LLC 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.
+
+"""Get environment information."""
+
+from __future__ import print_function
+
+import os
+import struct
+import sys
+
+
+def env_var(var_name):
+    value = os.environ.get(var_name)
+    print("os.environ[{!r}]: {}".format(var_name, value))
+
+
+def main():
+    print("os.name: {}".format(os.name))
+    env_var("PYTHON_ARCH")
+    env_var("PYTHON_VERSION")
+    print("sys.platform: {}".format(sys.platform))
+
+    if sys.maxsize == 2 ** 63 - 1:
+        print("sys.maxsize: 2^(63) - 1")
+    elif sys.maxsize == 2 ** 31 - 1:
+        print("sys.maxsize: 2^(31) - 1")
+    else:
+        print("sys.maxsize: {}".format(sys.maxsize))
+
+    print("sys.version:\n{}".format(sys.version))
+    bitness = struct.calcsize("P") * 8
+    print("struct.calcsize('P') * 8: {}".format(bitness))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/appveyor/install.ps1 b/appveyor/install.ps1
deleted file mode 100644
index 160ba55c0737..000000000000
--- a/appveyor/install.ps1
+++ /dev/null
@@ -1,229 +0,0 @@
-# Sample script to install Python and pip under Windows
-# Authors: Olivier Grisel, Jonathan Helmus, Kyle Kastner, and Alex Willmer
-# License: CC0 1.0 Universal: http://creativecommons.org/publicdomain/zero/1.0/
-
-$MINICONDA_URL = "http://repo.continuum.io/miniconda/"
-$BASE_URL = "https://www.python.org/ftp/python/"
-$GET_PIP_URL = "https://bootstrap.pypa.io/get-pip.py"
-$GET_PIP_PATH = "C:\get-pip.py"
-
-$PYTHON_PRERELEASE_REGEX = @"
-(?x)
-(?<major>\d+)
-\.
-(?<minor>\d+)
-\.
-(?<micro>\d+)
-(?<prerelease>[a-z]{1,2}\d+)
-"@
-
-
-function Download ($filename, $url) {
-    $webclient = New-Object System.Net.WebClient
-
-    $basedir = $pwd.Path + "\"
-    $filepath = $basedir + $filename
-    if (Test-Path $filename) {
-        Write-Host "Reusing" $filepath
-        return $filepath
-    }
-
-    # Download and retry up to 3 times in case of network transient errors.
-    Write-Host "Downloading" $filename "from" $url
-    $retry_attempts = 2
-    for ($i = 0; $i -lt $retry_attempts; $i++) {
-        try {
-            $webclient.DownloadFile($url, $filepath)
-            break
-        }
-        Catch [Exception]{
-            Start-Sleep 1
-        }
-    }
-    if (Test-Path $filepath) {
-        Write-Host "File saved at" $filepath
-    } else {
-        # Retry once to get the error message if any at the last try
-        $webclient.DownloadFile($url, $filepath)
-    }
-    return $filepath
-}
-
-
-function ParsePythonVersion ($python_version) {
-    if ($python_version -match $PYTHON_PRERELEASE_REGEX) {
-        return ([int]$matches.major, [int]$matches.minor, [int]$matches.micro,
-                $matches.prerelease)
-    }
-    $version_obj = [version]$python_version
-    return ($version_obj.major, $version_obj.minor, $version_obj.build, "")
-}
-
-
-function DownloadPython ($python_version, $platform_suffix) {
-    $major, $minor, $micro, $prerelease = ParsePythonVersion $python_version
-
-    if (($major -le 2 -and $micro -eq 0) `
-        -or ($major -eq 3 -and $minor -le 2 -and $micro -eq 0) `
-        ) {
-        $dir = "$major.$minor"
-        $python_version = "$major.$minor$prerelease"
-    } else {
-        $dir = "$major.$minor.$micro"
-    }
-
-    if ($prerelease) {
-        if (($major -le 2) `
-            -or ($major -eq 3 -and $minor -eq 1) `
-            -or ($major -eq 3 -and $minor -eq 2) `
-            -or ($major -eq 3 -and $minor -eq 3) `
-            ) {
-            $dir = "$dir/prev"
-        }
-    }
-
-    if (($major -le 2) -or ($major -le 3 -and $minor -le 4)) {
-        $ext = "msi"
-        if ($platform_suffix) {
-            $platform_suffix = ".$platform_suffix"
-        }
-    } else {
-        $ext = "exe"
-        if ($platform_suffix) {
-            $platform_suffix = "-$platform_suffix"
-        }
-    }
-
-    $filename = "python-$python_version$platform_suffix.$ext"
-    $url = "$BASE_URL$dir/$filename"
-    $filepath = Download $filename $url
-    return $filepath
-}
-
-
-function InstallPython ($python_version, $architecture, $python_home) {
-    Write-Host "Installing Python" $python_version "for" $architecture "bit architecture to" $python_home
-    if (Test-Path $python_home) {
-        Write-Host $python_home "already exists, skipping."
-        return $false
-    }
-    if ($architecture -eq "32") {
-        $platform_suffix = ""
-    } else {
-        $platform_suffix = "amd64"
-    }
-    $installer_path = DownloadPython $python_version $platform_suffix
-    $installer_ext = [System.IO.Path]::GetExtension($installer_path)
-    Write-Host "Installing $installer_path to $python_home"
-    $install_log = $python_home + ".log"
-    if ($installer_ext -eq '.msi') {
-        InstallPythonMSI $installer_path $python_home $install_log
-    } else {
-        InstallPythonEXE $installer_path $python_home $install_log
-    }
-    if (Test-Path $python_home) {
-        Write-Host "Python $python_version ($architecture) installation complete"
-    } else {
-        Write-Host "Failed to install Python in $python_home"
-        Get-Content -Path $install_log
-        Exit 1
-    }
-}
-
-
-function InstallPythonEXE ($exepath, $python_home, $install_log) {
-    $install_args = "/quiet InstallAllUsers=1 TargetDir=$python_home"
-    RunCommand $exepath $install_args
-}
-
-
-function InstallPythonMSI ($msipath, $python_home, $install_log) {
-    $install_args = "/qn /log $install_log /i $msipath TARGETDIR=$python_home"
-    $uninstall_args = "/qn /x $msipath"
-    RunCommand "msiexec.exe" $install_args
-    if (-not(Test-Path $python_home)) {
-        Write-Host "Python seems to be installed else-where, reinstalling."
-        RunCommand "msiexec.exe" $uninstall_args
-        RunCommand "msiexec.exe" $install_args
-    }
-}
-
-function RunCommand ($command, $command_args) {
-    Write-Host $command $command_args
-    Start-Process -FilePath $command -ArgumentList $command_args -Wait -Passthru
-}
-
-
-function InstallPip ($python_home) {
-    $pip_path = $python_home + "\Scripts\pip.exe"
-    $python_path = $python_home + "\python.exe"
-    if (-not(Test-Path $pip_path)) {
-        Write-Host "Installing pip..."
-        $webclient = New-Object System.Net.WebClient
-        $webclient.DownloadFile($GET_PIP_URL, $GET_PIP_PATH)
-        Write-Host "Executing:" $python_path $GET_PIP_PATH
-        & $python_path $GET_PIP_PATH
-    } else {
-        Write-Host "pip already installed."
-    }
-}
-
-
-function DownloadMiniconda ($python_version, $platform_suffix) {
-    if ($python_version -eq "3.4") {
-        $filename = "Miniconda3-3.5.5-Windows-" + $platform_suffix + ".exe"
-    } else {
-        $filename = "Miniconda-3.5.5-Windows-" + $platform_suffix + ".exe"
-    }
-    $url = $MINICONDA_URL + $filename
-    $filepath = Download $filename $url
-    return $filepath
-}
-
-
-function InstallMiniconda ($python_version, $architecture, $python_home) {
-    Write-Host "Installing Python" $python_version "for" $architecture "bit architecture to" $python_home
-    if (Test-Path $python_home) {
-        Write-Host $python_home "already exists, skipping."
-        return $false
-    }
-    if ($architecture -eq "32") {
-        $platform_suffix = "x86"
-    } else {
-        $platform_suffix = "x86_64"
-    }
-    $filepath = DownloadMiniconda $python_version $platform_suffix
-    Write-Host "Installing" $filepath "to" $python_home
-    $install_log = $python_home + ".log"
-    $args = "/S /D=$python_home"
-    Write-Host $filepath $args
-    Start-Process -FilePath $filepath -ArgumentList $args -Wait -Passthru
-    if (Test-Path $python_home) {
-        Write-Host "Python $python_version ($architecture) installation complete"
-    } else {
-        Write-Host "Failed to install Python in $python_home"
-        Get-Content -Path $install_log
-        Exit 1
-    }
-}
-
-
-function InstallMinicondaPip ($python_home) {
-    $pip_path = $python_home + "\Scripts\pip.exe"
-    $conda_path = $python_home + "\Scripts\conda.exe"
-    if (-not(Test-Path $pip_path)) {
-        Write-Host "Installing pip..."
-        $args = "install --yes pip"
-        Write-Host $conda_path $args
-        Start-Process -FilePath "$conda_path" -ArgumentList $args -Wait -Passthru
-    } else {
-        Write-Host "pip already installed."
-    }
-}
-
-function main () {
-    InstallPython $env:PYTHON_VERSION $env:PYTHON_ARCH $env:PYTHON
-    InstallPip $env:PYTHON
-}
-
-main
diff --git a/appveyor/requirements.txt b/appveyor/requirements.txt
index 390d11078312..45a4e4c25627 100644
--- a/appveyor/requirements.txt
+++ b/appveyor/requirements.txt
@@ -3,4 +3,4 @@
 # pip will build them from source using the MSVC compiler matching the
 # target Python version and architecture
 wheel
-tox
+nox-automation>=0.17.0
diff --git a/appveyor/run_with_env.cmd b/appveyor/run_with_env.cmd
deleted file mode 100644
index 5da547c499ee..000000000000
--- a/appveyor/run_with_env.cmd
+++ /dev/null
@@ -1,88 +0,0 @@
-:: To build extensions for 64 bit Python 3, we need to configure environment
-:: variables to use the MSVC 2010 C++ compilers from GRMSDKX_EN_DVD.iso of:
-:: MS Windows SDK for Windows 7 and .NET Framework 4 (SDK v7.1)
-::
-:: To build extensions for 64 bit Python 2, we need to configure environment
-:: variables to use the MSVC 2008 C++ compilers from GRMSDKX_EN_DVD.iso of:
-:: MS Windows SDK for Windows 7 and .NET Framework 3.5 (SDK v7.0)
-::
-:: 32 bit builds, and 64-bit builds for 3.5 and beyond, do not require specific
-:: environment configurations.
-::
-:: Note: this script needs to be run with the /E:ON and /V:ON flags for the
-:: cmd interpreter, at least for (SDK v7.0)
-::
-:: More details at:
-:: https://github.com/cython/cython/wiki/64BitCythonExtensionsOnWindows
-:: http://stackoverflow.com/a/13751649/163740
-::
-:: Author: Olivier Grisel
-:: License: CC0 1.0 Universal: http://creativecommons.org/publicdomain/zero/1.0/
-::
-:: Notes about batch files for Python people:
-::
-:: Quotes in values are literally part of the values:
-::      SET FOO="bar"
-:: FOO is now five characters long: " b a r "
-:: If you don't want quotes, don't include them on the right-hand side.
-::
-:: The CALL lines at the end of this file look redundant, but if you move them
-:: outside of the IF clauses, they do not run properly in the SET_SDK_64==Y
-:: case, I don't know why.
-@ECHO OFF
-
-SET COMMAND_TO_RUN=%*
-SET WIN_SDK_ROOT=C:\Program Files\Microsoft SDKs\Windows
-SET WIN_WDK=c:\Program Files (x86)\Windows Kits\10\Include\wdf
-
-:: Extract the major and minor versions, and allow for the minor version to be
-:: more than 9.  This requires the version number to have two dots in it.
-SET MAJOR_PYTHON_VERSION=%PYTHON_VERSION:~0,1%
-IF "%PYTHON_VERSION:~3,1%" == "." (
-    SET MINOR_PYTHON_VERSION=%PYTHON_VERSION:~2,1%
-) ELSE (
-    SET MINOR_PYTHON_VERSION=%PYTHON_VERSION:~2,2%
-)
-
-:: Based on the Python version, determine what SDK version to use, and whether
-:: to set the SDK for 64-bit.
-IF %MAJOR_PYTHON_VERSION% == 2 (
-    SET WINDOWS_SDK_VERSION="v7.0"
-    SET SET_SDK_64=Y
-) ELSE (
-    IF %MAJOR_PYTHON_VERSION% == 3 (
-        SET WINDOWS_SDK_VERSION="v7.1"
-        IF %MINOR_PYTHON_VERSION% LEQ 4 (
-            SET SET_SDK_64=Y
-        ) ELSE (
-            SET SET_SDK_64=N
-            IF EXIST "%WIN_WDK%" (
-                :: See: https://connect.microsoft.com/VisualStudio/feedback/details/1610302/
-                REN "%WIN_WDK%" 0wdf
-            )
-        )
-    ) ELSE (
-        ECHO Unsupported Python version: "%MAJOR_PYTHON_VERSION%"
-        EXIT 1
-    )
-)
-
-IF %PYTHON_ARCH% == 64 (
-    IF %SET_SDK_64% == Y (
-        ECHO Configuring Windows SDK %WINDOWS_SDK_VERSION% for Python %MAJOR_PYTHON_VERSION% on a 64 bit architecture
-        SET DISTUTILS_USE_SDK=1
-        SET MSSdk=1
-        "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Setup\WindowsSdkVer.exe" -q -version:%WINDOWS_SDK_VERSION%
-        "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Bin\SetEnv.cmd" /x64 /release
-        ECHO Executing: %COMMAND_TO_RUN%
-        call %COMMAND_TO_RUN% || EXIT 1
-    ) ELSE (
-        ECHO Using default MSVC build environment for 64 bit architecture
-        ECHO Executing: %COMMAND_TO_RUN%
-        call %COMMAND_TO_RUN% || EXIT 1
-    )
-) ELSE (
-    ECHO Using default MSVC build environment for 32 bit architecture
-    ECHO Executing: %COMMAND_TO_RUN%
-    call %COMMAND_TO_RUN% || EXIT 1
-)
diff --git a/asset/.coveragerc b/asset/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/asset/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/asset/.flake8 b/asset/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/asset/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/asset/.repo-metadata.json b/asset/.repo-metadata.json
new file mode 100644
index 000000000000..cc9ac3cd4b1d
--- /dev/null
+++ b/asset/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudasset",
+  "name_pretty": "Cloud Asset Inventory",
+  "product_documentation": "https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview",
+  "client_documentation": "https://googleapis.dev/python/cloudasset/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559757",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-asset",
+  "api_id": "cloudasset.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/asset/CHANGELOG.md b/asset/CHANGELOG.md
new file mode 100644
index 000000000000..049d0f2c3017
--- /dev/null
+++ b/asset/CHANGELOG.md
@@ -0,0 +1,126 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-asset/#history
+
+## 0.4.1
+
+08-12-2019 13:44 PDT
+
+### Documentation
+- Fix links to googleapis.dev ([#8998](https://github.com/googleapis/google-cloud-python/pull/8998))
+
+## 0.4.0
+
+08-01-2019 14:24 PDT
+
+### New Features
+- Generate asset v1p2beta1. ([#8888](https://github.com/googleapis/google-cloud-python/pull/8888))
+
+### Internal / Testing Changes
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.3.0
+
+07-22-2019 17:42 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8382](https://github.com/googleapis/google-cloud-python/pull/8382))
+- Add nox session docs, add routing header to method metadata (via synth). ([#7919](https://github.com/googleapis/google-cloud-python/pull/7919))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add 'client_options' support (via synth). ([#8498](https://github.com/googleapis/google-cloud-python/pull/8498))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Update vpcsc test settings. ([#8627](https://github.com/googleapis/google-cloud-python/pull/8627))
+- Pin black version (via synth) ([#8572](https://github.com/googleapis/google-cloud-python/pull/8572))
+- Add VPCSC tests. ([#8613](https://github.com/googleapis/google-cloud-python/pull/8613))
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Add disclaimer to auto-generated template files (via synth). ([#8306](https://github.com/googleapis/google-cloud-python/pull/8306))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8232](https://github.com/googleapis/google-cloud-python/pull/8232))
+- Fix coverage in 'types.py'. ([#8144](https://github.com/googleapis/google-cloud-python/pull/8144))
+- Blacken noxfile.py, setup.py (via synth). ([#8114](https://github.com/googleapis/google-cloud-python/pull/8114))
+-  Declare encoding as utf-8 in pb2 files (via synth). ([#8343](https://github.com/googleapis/google-cloud-python/pull/8343))
+- Add empty lines (via synth). ([#8047](https://github.com/googleapis/google-cloud-python/pull/8047))
+
+## 0.2.0
+
+03-19-2019 12:17 PDT
+
+
+### Implementation Changes
+- Rename 'GcsDestination.uri' -> 'object_uri', docstring changes . ([#7202](https://github.com/googleapis/google-cloud-python/pull/7202))
+- Protoc-generated serialization update.. ([#7073](https://github.com/googleapis/google-cloud-python/pull/7073))
+
+### New Features
+- Generate v1. ([#7513](https://github.com/googleapis/google-cloud-python/pull/7513))
+
+### Documentation
+- Fix broken links to Cloud Asset API ([#7524](https://github.com/googleapis/google-cloud-python/pull/7524))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+- Pick up stub docstring fix in GAPIC generator.[#6963](https://github.com/googleapis/google-cloud-python/pull/6963))
+
+### Internal / Testing Changes
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Add support for including protos in synth ([#7114](https://github.com/googleapis/google-cloud-python/pull/7114))
+
+## 0.1.2
+
+12-17-2018 16:15 PST
+
+
+### Implementation Changes
+- Use moved iam.policy now at google.api_core.iam.policy ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up enum fixes in the GAPIC generator. ([#6607](https://github.com/googleapis/google-cloud-python/pull/6607))
+- Pick up fixes in GAPIC generator. ([#6489](https://github.com/googleapis/google-cloud-python/pull/6489))
+- Fix client_info bug, update docstrings. ([#6403](https://github.com/googleapis/google-cloud-python/pull/6403))
+- Synth docstring changes generated from updated protos ([#6349](https://github.com/googleapis/google-cloud-python/pull/6349))
+- Generated cloud asset client files are under asset-[version] ([#6341](https://github.com/googleapis/google-cloud-python/pull/6341))
+
+### New Features
+
+### Dependencies
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Fix docs build. ([#6351](https://github.com/googleapis/google-cloud-python/pull/6351))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Add templating to asset synth.py ([#6606](https://github.com/googleapis/google-cloud-python/pull/6606))
+- Add synth metadata. ([#6560](https://github.com/googleapis/google-cloud-python/pull/6560))
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Unblack gapic and protos.
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.1.1
+
+### Packaging
+- Release as `google-cloud-asset`, rather than `google-cloud-cloudasset`.
+  (#5998)
+
+## 0.1.0
+
+Initial release.
+
diff --git a/asset/LICENSE b/asset/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/asset/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/asset/MANIFEST.in b/asset/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/asset/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/asset/README.rst b/asset/README.rst
new file mode 100644
index 000000000000..e0d579c20035
--- /dev/null
+++ b/asset/README.rst
@@ -0,0 +1,86 @@
+Python Client for Cloud Asset API
+=================================
+
+|alpha| |pypi| |versions| 
+
+`Cloud Asset API`_: The cloud asset API manages the history and inventory of cloud resources.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-asset.svg
+   :target: https://pypi.org/project/google-cloud-asset/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-asset.svg
+   :target: https://pypi.org/project/google-cloud-asset/
+.. _Cloud Asset API: https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/reference/rest/
+.. _Client Library Documentation: https://googleapis.dev/python/cloudasset/latest
+.. _Product Documentation:  https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Asset API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Asset API.:  https://console.cloud.google.com/apis/library/cloudasset.googleapis.com
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-asset
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-asset
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Asset API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/asset/docs/README.rst b/asset/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/asset/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/asset/docs/changelog.md b/asset/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/asset/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/asset/docs/conf.py b/asset/docs/conf.py
new file mode 100644
index 000000000000..cb7ef3bdb856
--- /dev/null
+++ b/asset/docs/conf.py
@@ -0,0 +1,350 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-asset documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-asset"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-asset-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-asset.tex",
+        u"google-cloud-asset Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-asset", u"google-cloud-asset Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-asset",
+        u"google-cloud-asset Documentation",
+        author,
+        "google-cloud-asset",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/asset/docs/gapic/v1/api.rst b/asset/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..12fc69a59923
--- /dev/null
+++ b/asset/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Asset API
+==========================
+
+.. automodule:: google.cloud.asset_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/asset/docs/gapic/v1/types.rst b/asset/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..962b18ff2902
--- /dev/null
+++ b/asset/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Asset API Client
+================================
+
+.. automodule:: google.cloud.asset_v1.types
+    :members:
\ No newline at end of file
diff --git a/asset/docs/gapic/v1beta1/api.rst b/asset/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..f5b1195aef13
--- /dev/null
+++ b/asset/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Asset API
+==========================
+
+.. automodule:: google.cloud.asset_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/asset/docs/gapic/v1beta1/types.rst b/asset/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..550bd11428af
--- /dev/null
+++ b/asset/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Asset API Client
+================================
+
+.. automodule:: google.cloud.asset_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/asset/docs/gapic/v1p2beta1/api.rst b/asset/docs/gapic/v1p2beta1/api.rst
new file mode 100644
index 000000000000..ca2696c24291
--- /dev/null
+++ b/asset/docs/gapic/v1p2beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Asset API
+==========================
+
+.. automodule:: google.cloud.asset_v1p2beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/asset/docs/gapic/v1p2beta1/types.rst b/asset/docs/gapic/v1p2beta1/types.rst
new file mode 100644
index 000000000000..914469b3224f
--- /dev/null
+++ b/asset/docs/gapic/v1p2beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Asset API Client
+================================
+
+.. automodule:: google.cloud.asset_v1p2beta1.types
+    :members:
\ No newline at end of file
diff --git a/asset/docs/index.rst b/asset/docs/index.rst
new file mode 100644
index 000000000000..cc1b49a90e90
--- /dev/null
+++ b/asset/docs/index.rst
@@ -0,0 +1,46 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+
+This package includes clients for multiple versions of the Cloud Asset API. By default, you will get ``v1``
+the latest stable version.
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+
+A new beta release with additional features over the current stable version, spelled ``v1p2beta1``, is provided
+to allow you to use these new features. These are expected to move into the stable release soon; until
+then, the usual beta admonishment (changes are possible, etc.) applies.
+
+An API and type reference is provided for this beta:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1p2beta1/api
+    gapic/v1p2beta1/types
+
+The previous beta release, spelled ``v1p2beta1`` is also provided to continue to support code
+previously written against it. In order to use it, you will want to import from 
+``google.cloud.asset_v1beta1`` in lieu of ``google.cloud.asset_v1``.
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-asset`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/asset/google/__init__.py b/asset/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/asset/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/asset/google/cloud/__init__.py b/asset/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/asset/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/asset/google/cloud/asset.py b/asset/google/cloud/asset.py
new file mode 100644
index 000000000000..24c7e7d24e40
--- /dev/null
+++ b/asset/google/cloud/asset.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.asset_v1 import AssetServiceClient
+from google.cloud.asset_v1 import enums
+from google.cloud.asset_v1 import types
+
+
+__all__ = ("enums", "types", "AssetServiceClient")
diff --git a/asset/google/cloud/asset_v1/__init__.py b/asset/google/cloud/asset_v1/__init__.py
new file mode 100644
index 000000000000..a3dfa14c692b
--- /dev/null
+++ b/asset/google/cloud/asset_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.asset_v1 import types
+from google.cloud.asset_v1.gapic import asset_service_client
+from google.cloud.asset_v1.gapic import enums
+
+
+class AssetServiceClient(asset_service_client.AssetServiceClient):
+    __doc__ = asset_service_client.AssetServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "AssetServiceClient")
diff --git a/asset/google/cloud/asset_v1/gapic/__init__.py b/asset/google/cloud/asset_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1/gapic/asset_service_client.py b/asset/google/cloud/asset_v1/gapic/asset_service_client.py
new file mode 100644
index 000000000000..ab9078cc62c7
--- /dev/null
+++ b/asset/google/cloud/asset_v1/gapic/asset_service_client.py
@@ -0,0 +1,431 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.asset.v1 AssetService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.path_template
+import grpc
+
+from google.cloud.asset_v1.gapic import asset_service_client_config
+from google.cloud.asset_v1.gapic import enums
+from google.cloud.asset_v1.gapic.transports import asset_service_grpc_transport
+from google.cloud.asset_v1.proto import asset_service_pb2
+from google.cloud.asset_v1.proto import asset_service_pb2_grpc
+from google.cloud.asset_v1.proto import assets_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-asset").version
+
+
+class AssetServiceClient(object):
+    """Asset service definition."""
+
+    SERVICE_ADDRESS = "cloudasset.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.asset.v1.AssetService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            AssetServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.AssetServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.AssetServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = asset_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=asset_service_grpc_transport.AssetServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = asset_service_grpc_transport.AssetServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def export_assets(
+        self,
+        parent,
+        output_config,
+        read_time=None,
+        asset_types=None,
+        content_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` API allowing you to keep
+        track of the export.
+
+        Example:
+            >>> from google.cloud import asset_v1
+            >>>
+            >>> client = asset_v1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_assets(parent, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. The relative name of the root asset. This 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"),
+                or a folder number (such as "folders/123").
+            output_config (Union[dict, ~google.cloud.asset_v1.types.OutputConfig]): Required. Output configuration indicating where the results will be output
+                to. All results will be in newline delimited JSON format.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1.types.OutputConfig`
+            read_time (Union[dict, ~google.cloud.asset_v1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1.types.Timestamp`
+            asset_types (list[str]): 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>`__
+                for all supported asset types.
+            content_type (~google.cloud.asset_v1.types.ContentType): Asset content type. If not specified, no content but the asset name will be
+                returned.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_assets,
+                default_retry=self._method_configs["ExportAssets"].retry,
+                default_timeout=self._method_configs["ExportAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.ExportAssetsRequest(
+            parent=parent,
+            output_config=output_config,
+            read_time=read_time,
+            asset_types=asset_types,
+            content_type=content_type,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_assets"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            asset_service_pb2.ExportAssetsResponse,
+            metadata_type=asset_service_pb2.ExportAssetsRequest,
+        )
+
+    def batch_get_assets_history(
+        self,
+        parent,
+        content_type,
+        read_time_window,
+        asset_names=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Batch gets the update history of assets that overlap a time window. For
+        RESOURCE content, this API outputs history with asset in both 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.
+
+        Example:
+            >>> from google.cloud import asset_v1
+            >>> from google.cloud.asset_v1 import enums
+            >>>
+            >>> client = asset_v1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> # TODO: Initialize `content_type`:
+            >>> content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `read_time_window`:
+            >>> read_time_window = {}
+            >>>
+            >>> response = client.batch_get_assets_history(parent, content_type, read_time_window)
+
+        Args:
+            parent (str): 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").
+            content_type (~google.cloud.asset_v1.types.ContentType): Required. The content type.
+            read_time_window (Union[dict, ~google.cloud.asset_v1.types.TimeWindow]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1.types.TimeWindow`
+            asset_names (list[str]): 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>`__
+                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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1.types.BatchGetAssetsHistoryResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_get_assets_history" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_get_assets_history"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_get_assets_history,
+                default_retry=self._method_configs["BatchGetAssetsHistory"].retry,
+                default_timeout=self._method_configs["BatchGetAssetsHistory"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.BatchGetAssetsHistoryRequest(
+            parent=parent,
+            content_type=content_type,
+            read_time_window=read_time_window,
+            asset_names=asset_names,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_get_assets_history"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/asset/google/cloud/asset_v1/gapic/asset_service_client_config.py b/asset/google/cloud/asset_v1/gapic/asset_service_client_config.py
new file mode 100644
index 000000000000..885ad4f0968c
--- /dev/null
+++ b/asset/google/cloud/asset_v1/gapic/asset_service_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.asset.v1.AssetService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ExportAssets": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchGetAssetsHistory": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/asset/google/cloud/asset_v1/gapic/enums.py b/asset/google/cloud/asset_v1/gapic/enums.py
new file mode 100644
index 000000000000..780beae4ddef
--- /dev/null
+++ b/asset/google/cloud/asset_v1/gapic/enums.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ContentType(enum.IntEnum):
+    """
+    Asset content type.
+
+    Attributes:
+      CONTENT_TYPE_UNSPECIFIED (int): Unspecified content type.
+      RESOURCE (int): Resource metadata.
+      IAM_POLICY (int): The actual IAM policy set on a resource.
+    """
+
+    CONTENT_TYPE_UNSPECIFIED = 0
+    RESOURCE = 1
+    IAM_POLICY = 2
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
diff --git a/asset/google/cloud/asset_v1/gapic/transports/__init__.py b/asset/google/cloud/asset_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1/gapic/transports/asset_service_grpc_transport.py b/asset/google/cloud/asset_v1/gapic/transports/asset_service_grpc_transport.py
new file mode 100644
index 000000000000..b6849225d4f5
--- /dev/null
+++ b/asset/google/cloud/asset_v1/gapic/transports/asset_service_grpc_transport.py
@@ -0,0 +1,150 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.asset_v1.proto import asset_service_pb2_grpc
+
+
+class AssetServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.asset.v1 AssetService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudasset.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "asset_service_stub": asset_service_pb2_grpc.AssetServiceStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudasset.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def export_assets(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.export_assets`.
+
+        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`` API allowing you to keep
+        track of the export.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].ExportAssets
+
+    @property
+    def batch_get_assets_history(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.batch_get_assets_history`.
+
+        Batch gets the update history of assets that overlap a time window. For
+        RESOURCE content, this API outputs history with asset in both 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].BatchGetAssetsHistory
diff --git a/asset/google/cloud/asset_v1/proto/__init__.py b/asset/google/cloud/asset_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1/proto/asset_service.proto b/asset/google/cloud/asset_v1/proto/asset_service.proto
new file mode 100644
index 000000000000..0dfc2898b131
--- /dev/null
+++ b/asset/google/cloud/asset_v1/proto/asset_service.proto
@@ -0,0 +1,171 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/asset/v1/assets.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Asset.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1;asset";
+option java_multiple_files = true;
+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 {
+  // 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.
+  rpc ExportAssets(ExportAssetsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=*/*}:exportAssets"
+      body: "*"
+    };
+  }
+
+  // Batch gets the update history of assets that overlap a time window.
+  // For RESOURCE content, this API outputs history with asset in both
+  // 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) = {
+      get: "/v1/{parent=*/*}:batchGetAssetsHistory"
+    };
+  }
+}
+
+// Export asset request.
+message ExportAssetsRequest {
+  // Required. The relative name of the root asset. This 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"),
+  // or a folder number (such as "folders/123").
+  string parent = 1;
+
+  // 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.
+  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)
+  // for all supported asset types.
+  repeated string asset_types = 3;
+
+  // Asset content type. If not specified, no content but the asset name will be
+  // returned.
+  ContentType content_type = 4;
+
+  // Required. Output configuration indicating where the results will be output
+  // to. All results will be in newline delimited JSON format.
+  OutputConfig output_config = 5;
+}
+
+// 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.
+message ExportAssetsResponse {
+  // Time the snapshot was taken.
+  google.protobuf.Timestamp read_time = 1;
+
+  // Output configuration indicating where the results were output to.
+  // All results are in JSON format.
+  OutputConfig output_config = 2;
+}
+
+// Batch get assets history request.
+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;
+
+  // 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)
+  // 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 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;
+}
+
+// Batch get assets history response.
+message BatchGetAssetsHistoryResponse {
+  // A list of assets with valid time windows.
+  repeated TemporalAsset assets = 1;
+}
+
+// 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;
+  }
+}
+
+// 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/asset/google/cloud/asset_v1/proto/asset_service_pb2.py b/asset/google/cloud/asset_v1/proto/asset_service_pb2.py
new file mode 100644
index 000000000000..869d4dc3fee1
--- /dev/null
+++ b/asset/google/cloud/asset_v1/proto/asset_service_pb2.py
@@ -0,0 +1,726 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset_v1/proto/asset_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.asset_v1.proto import (
+    assets_pb2 as google_dot_cloud_dot_asset__v1_dot_proto_dot_assets__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/asset_v1/proto/asset_service.proto",
+    package="google.cloud.asset.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.asset.v1B\021AssetServiceProtoP\001Z:google.golang.org/genproto/googleapis/cloud/asset/v1;asset\252\002\025Google.Cloud.Asset.V1\312\002\025Google\\Cloud\\Asset\\V1"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/asset_v1/proto/asset_service.proto\x12\x15google.cloud.asset.v1\x1a\x1cgoogle/api/annotations.proto\x1a(google/cloud/asset_v1/proto/assets.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xdf\x01\n\x13\x45xportAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0b\x61sset_types\x18\x03 \x03(\t\x12\x38\n\x0c\x63ontent_type\x18\x04 \x01(\x0e\x32".google.cloud.asset.v1.ContentType\x12:\n\routput_config\x18\x05 \x01(\x0b\x32#.google.cloud.asset.v1.OutputConfig"\x81\x01\n\x14\x45xportAssetsResponse\x12-\n\tread_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12:\n\routput_config\x18\x02 \x01(\x0b\x32#.google.cloud.asset.v1.OutputConfig"\xba\x01\n\x1c\x42\x61tchGetAssetsHistoryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0b\x61sset_names\x18\x02 \x03(\t\x12\x38\n\x0c\x63ontent_type\x18\x03 \x01(\x0e\x32".google.cloud.asset.v1.ContentType\x12;\n\x10read_time_window\x18\x04 \x01(\x0b\x32!.google.cloud.asset.v1.TimeWindow"U\n\x1d\x42\x61tchGetAssetsHistoryResponse\x12\x34\n\x06\x61ssets\x18\x01 \x03(\x0b\x32$.google.cloud.asset.v1.TemporalAsset"_\n\x0cOutputConfig\x12@\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32%.google.cloud.asset.v1.GcsDestinationH\x00\x42\r\n\x0b\x64\x65stination"-\n\x0eGcsDestination\x12\r\n\x03uri\x18\x01 \x01(\tH\x00\x42\x0c\n\nobject_uri*I\n\x0b\x43ontentType\x12\x1c\n\x18\x43ONTENT_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08RESOURCE\x10\x01\x12\x0e\n\nIAM_POLICY\x10\x02\x32\xc9\x02\n\x0c\x41ssetService\x12\x83\x01\n\x0c\x45xportAssets\x12*.google.cloud.asset.v1.ExportAssetsRequest\x1a\x1d.google.longrunning.Operation"(\x82\xd3\xe4\x93\x02""\x1d/v1/{parent=*/*}:exportAssets:\x01*\x12\xb2\x01\n\x15\x42\x61tchGetAssetsHistory\x12\x33.google.cloud.asset.v1.BatchGetAssetsHistoryRequest\x1a\x34.google.cloud.asset.v1.BatchGetAssetsHistoryResponse".\x82\xd3\xe4\x93\x02(\x12&/v1/{parent=*/*}:batchGetAssetsHistoryB\x9c\x01\n\x19\x63om.google.cloud.asset.v1B\x11\x41ssetServiceProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/asset/v1;asset\xaa\x02\x15Google.Cloud.Asset.V1\xca\x02\x15Google\\Cloud\\Asset\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_asset__v1_dot_proto_dot_assets__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_CONTENTTYPE = _descriptor.EnumDescriptor(
+    name="ContentType",
+    full_name="google.cloud.asset.v1.ContentType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CONTENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESOURCE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IAM_POLICY", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=994,
+    serialized_end=1067,
+)
+_sym_db.RegisterEnumDescriptor(_CONTENTTYPE)
+
+ContentType = enum_type_wrapper.EnumTypeWrapper(_CONTENTTYPE)
+CONTENT_TYPE_UNSPECIFIED = 0
+RESOURCE = 1
+IAM_POLICY = 2
+
+
+_EXPORTASSETSREQUEST = _descriptor.Descriptor(
+    name="ExportAssetsRequest",
+    full_name="google.cloud.asset.v1.ExportAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1.ExportAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.asset.v1.ExportAssetsRequest.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_types",
+            full_name="google.cloud.asset.v1.ExportAssetsRequest.asset_types",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1.ExportAssetsRequest.content_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.asset.v1.ExportAssetsRequest.output_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=217,
+    serialized_end=440,
+)
+
+
+_EXPORTASSETSRESPONSE = _descriptor.Descriptor(
+    name="ExportAssetsResponse",
+    full_name="google.cloud.asset.v1.ExportAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.asset.v1.ExportAssetsResponse.read_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.asset.v1.ExportAssetsResponse.output_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=443,
+    serialized_end=572,
+)
+
+
+_BATCHGETASSETSHISTORYREQUEST = _descriptor.Descriptor(
+    name="BatchGetAssetsHistoryRequest",
+    full_name="google.cloud.asset.v1.BatchGetAssetsHistoryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1.BatchGetAssetsHistoryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_names",
+            full_name="google.cloud.asset.v1.BatchGetAssetsHistoryRequest.asset_names",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1.BatchGetAssetsHistoryRequest.content_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time_window",
+            full_name="google.cloud.asset.v1.BatchGetAssetsHistoryRequest.read_time_window",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=575,
+    serialized_end=761,
+)
+
+
+_BATCHGETASSETSHISTORYRESPONSE = _descriptor.Descriptor(
+    name="BatchGetAssetsHistoryResponse",
+    full_name="google.cloud.asset.v1.BatchGetAssetsHistoryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="assets",
+            full_name="google.cloud.asset.v1.BatchGetAssetsHistoryResponse.assets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=763,
+    serialized_end=848,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.asset.v1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.asset.v1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.asset.v1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=850,
+    serialized_end=945,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.asset.v1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.asset.v1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="object_uri",
+            full_name="google.cloud.asset.v1.GcsDestination.object_uri",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=947,
+    serialized_end=992,
+)
+
+_EXPORTASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTASSETSREQUEST.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_EXPORTASSETSREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_EXPORTASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTASSETSRESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_BATCHGETASSETSHISTORYREQUEST.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_BATCHGETASSETSHISTORYREQUEST.fields_by_name[
+    "read_time_window"
+].message_type = google_dot_cloud_dot_asset__v1_dot_proto_dot_assets__pb2._TIMEWINDOW
+_BATCHGETASSETSHISTORYRESPONSE.fields_by_name[
+    "assets"
+].message_type = google_dot_cloud_dot_asset__v1_dot_proto_dot_assets__pb2._TEMPORALASSET
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_GCSDESTINATION.oneofs_by_name["object_uri"].fields.append(
+    _GCSDESTINATION.fields_by_name["uri"]
+)
+_GCSDESTINATION.fields_by_name["uri"].containing_oneof = _GCSDESTINATION.oneofs_by_name[
+    "object_uri"
+]
+DESCRIPTOR.message_types_by_name["ExportAssetsRequest"] = _EXPORTASSETSREQUEST
+DESCRIPTOR.message_types_by_name["ExportAssetsResponse"] = _EXPORTASSETSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchGetAssetsHistoryRequest"
+] = _BATCHGETASSETSHISTORYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchGetAssetsHistoryResponse"
+] = _BATCHGETASSETSHISTORYRESPONSE
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.enum_types_by_name["ContentType"] = _CONTENTTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ExportAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTASSETSREQUEST,
+        __module__="google.cloud.asset_v1.proto.asset_service_pb2",
+        __doc__="""Export asset request.
+  
+  
+  Attributes:
+      parent:
+          Required. The relative name of the root asset. This 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"), or a folder number (such as
+          "folders/123").
+      read_time:
+          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.
+      asset_types:
+          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>`__ for all
+          supported asset types.
+      content_type:
+          Asset content type. If not specified, no content but the asset
+          name will be returned.
+      output_config:
+          Required. Output configuration indicating where the results
+          will be output to. All results will be in newline delimited
+          JSON format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.ExportAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportAssetsRequest)
+
+ExportAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ExportAssetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTASSETSRESPONSE,
+        __module__="google.cloud.asset_v1.proto.asset_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      read_time:
+          Time the snapshot was taken.
+      output_config:
+          Output configuration indicating where the results were output
+          to. All results are in JSON format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.ExportAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ExportAssetsResponse)
+
+BatchGetAssetsHistoryRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchGetAssetsHistoryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETASSETSHISTORYREQUEST,
+        __module__="google.cloud.asset_v1.proto.asset_service_pb2",
+        __doc__="""Batch get assets history request.
+  
+  
+  Attributes:
+      parent:
+          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").
+      asset_names:
+          A list of the full names of the assets. For example: ``//compu
+          te.googleapis.com/projects/my_project_123/zones/zone1/instance
+          s/instance1``. See `Resource Names <https://cloud.google.com/a
+          pis/design/resource_names#full_resource_name>`__ and `Resource
+          Name Format <https://cloud.google.com/resource-
+          manager/docs/cloud-asset-inventory/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.
+      content_type:
+          Required. The content type.
+      read_time_window:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.BatchGetAssetsHistoryRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetAssetsHistoryRequest)
+
+BatchGetAssetsHistoryResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchGetAssetsHistoryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETASSETSHISTORYRESPONSE,
+        __module__="google.cloud.asset_v1.proto.asset_service_pb2",
+        __doc__="""Batch get assets history response.
+  
+  
+  Attributes:
+      assets:
+          A list of assets with valid time windows.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.BatchGetAssetsHistoryResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetAssetsHistoryResponse)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.asset_v1.proto.asset_service_pb2",
+        __doc__="""Output configuration for export assets destination.
+  
+  
+  Attributes:
+      destination:
+          Asset export destination.
+      gcs_destination:
+          Destination on Cloud Storage.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.asset_v1.proto.asset_service_pb2",
+        __doc__="""A Cloud Storage location.
+  
+  
+  Attributes:
+      object_uri:
+          Required.
+      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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+
+DESCRIPTOR._options = None
+
+_ASSETSERVICE = _descriptor.ServiceDescriptor(
+    name="AssetService",
+    full_name="google.cloud.asset.v1.AssetService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1070,
+    serialized_end=1399,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ExportAssets",
+            full_name="google.cloud.asset.v1.AssetService.ExportAssets",
+            index=0,
+            containing_service=None,
+            input_type=_EXPORTASSETSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002""\035/v1/{parent=*/*}:exportAssets:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchGetAssetsHistory",
+            full_name="google.cloud.asset.v1.AssetService.BatchGetAssetsHistory",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHGETASSETSHISTORYREQUEST,
+            output_type=_BATCHGETASSETSHISTORYRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002(\022&/v1/{parent=*/*}:batchGetAssetsHistory"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_ASSETSERVICE)
+
+DESCRIPTOR.services_by_name["AssetService"] = _ASSETSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/asset/google/cloud/asset_v1/proto/asset_service_pb2_grpc.py b/asset/google/cloud/asset_v1/proto/asset_service_pb2_grpc.py
new file mode 100644
index 000000000000..3795a401928c
--- /dev/null
+++ b/asset/google/cloud/asset_v1/proto/asset_service_pb2_grpc.py
@@ -0,0 +1,78 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.asset_v1.proto import (
+    asset_service_pb2 as google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class AssetServiceStub(object):
+    """Asset service definition.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ExportAssets = channel.unary_unary(
+            "/google.cloud.asset.v1.AssetService/ExportAssets",
+            request_serializer=google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2.ExportAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.BatchGetAssetsHistory = channel.unary_unary(
+            "/google.cloud.asset.v1.AssetService/BatchGetAssetsHistory",
+            request_serializer=google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryResponse.FromString,
+        )
+
+
+class AssetServiceServicer(object):
+    """Asset service definition.
+  """
+
+    def ExportAssets(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchGetAssetsHistory(self, request, context):
+        """Batch gets the update history of assets that overlap a time window.
+    For RESOURCE content, this API outputs history with asset in both
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_AssetServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ExportAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportAssets,
+            request_deserializer=google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2.ExportAssetsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "BatchGetAssetsHistory": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchGetAssetsHistory,
+            request_deserializer=google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.asset.v1.AssetService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/asset/google/cloud/asset_v1/proto/assets.proto b/asset/google/cloud/asset_v1/proto/assets.proto
new file mode 100644
index 000000000000..f6a8108c0bd2
--- /dev/null
+++ b/asset/google/cloud/asset_v1/proto/assets.proto
@@ -0,0 +1,118 @@
+// 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.v1;
+
+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 csharp_namespace = "Google.Cloud.Asset.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1;asset";
+option java_multiple_files = true;
+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.
+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;
+}
+
+// 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/asset/google/cloud/asset_v1/proto/assets_pb2.py b/asset/google/cloud/asset_v1/proto/assets_pb2.py
new file mode 100644
index 000000000000..99fba5cde79d
--- /dev/null
+++ b/asset/google/cloud/asset_v1/proto/assets_pb2.py
@@ -0,0 +1,544 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset_v1/proto/assets.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/asset_v1/proto/assets.proto",
+    package="google.cloud.asset.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.asset.v1B\nAssetProtoP\001Z:google.golang.org/genproto/googleapis/cloud/asset/v1;asset\252\002\025Google.Cloud.Asset.V1\312\002\025Google\\Cloud\\Asset\\V1"
+    ),
+    serialized_pb=_b(
+        '\n(google/cloud/asset_v1/proto/assets.proto\x12\x15google.cloud.asset.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x19google/protobuf/any.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x80\x01\n\rTemporalAsset\x12\x31\n\x06window\x18\x01 \x01(\x0b\x32!.google.cloud.asset.v1.TimeWindow\x12\x0f\n\x07\x64\x65leted\x18\x02 \x01(\x08\x12+\n\x05\x61sset\x18\x03 \x01(\x0b\x32\x1c.google.cloud.asset.v1.Asset"j\n\nTimeWindow\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x87\x01\n\x05\x41sset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x31\n\x08resource\x18\x03 \x01(\x0b\x32\x1f.google.cloud.asset.v1.Resource\x12)\n\niam_policy\x18\x04 \x01(\x0b\x32\x15.google.iam.v1.Policy"\xa0\x01\n\x08Resource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x1e\n\x16\x64iscovery_document_uri\x18\x02 \x01(\t\x12\x16\n\x0e\x64iscovery_name\x18\x03 \x01(\t\x12\x14\n\x0cresource_url\x18\x04 \x01(\t\x12\x0e\n\x06parent\x18\x05 \x01(\t\x12%\n\x04\x64\x61ta\x18\x06 \x01(\x0b\x32\x17.google.protobuf.StructB\x95\x01\n\x19\x63om.google.cloud.asset.v1B\nAssetProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/asset/v1;asset\xaa\x02\x15Google.Cloud.Asset.V1\xca\x02\x15Google\\Cloud\\Asset\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEMPORALASSET = _descriptor.Descriptor(
+    name="TemporalAsset",
+    full_name="google.cloud.asset.v1.TemporalAsset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="window",
+            full_name="google.cloud.asset.v1.TemporalAsset.window",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deleted",
+            full_name="google.cloud.asset.v1.TemporalAsset.deleted",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset",
+            full_name="google.cloud.asset.v1.TemporalAsset.asset",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=216,
+    serialized_end=344,
+)
+
+
+_TIMEWINDOW = _descriptor.Descriptor(
+    name="TimeWindow",
+    full_name="google.cloud.asset.v1.TimeWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.asset.v1.TimeWindow.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.asset.v1.TimeWindow.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=346,
+    serialized_end=452,
+)
+
+
+_ASSET = _descriptor.Descriptor(
+    name="Asset",
+    full_name="google.cloud.asset.v1.Asset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.asset.v1.Asset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_type",
+            full_name="google.cloud.asset.v1.Asset.asset_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource",
+            full_name="google.cloud.asset.v1.Asset.resource",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="iam_policy",
+            full_name="google.cloud.asset.v1.Asset.iam_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=455,
+    serialized_end=590,
+)
+
+
+_RESOURCE = _descriptor.Descriptor(
+    name="Resource",
+    full_name="google.cloud.asset.v1.Resource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.asset.v1.Resource.version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery_document_uri",
+            full_name="google.cloud.asset.v1.Resource.discovery_document_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery_name",
+            full_name="google.cloud.asset.v1.Resource.discovery_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_url",
+            full_name="google.cloud.asset.v1.Resource.resource_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1.Resource.parent",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.cloud.asset.v1.Resource.data",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=593,
+    serialized_end=753,
+)
+
+_TEMPORALASSET.fields_by_name["window"].message_type = _TIMEWINDOW
+_TEMPORALASSET.fields_by_name["asset"].message_type = _ASSET
+_TIMEWINDOW.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEWINDOW.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ASSET.fields_by_name["resource"].message_type = _RESOURCE
+_ASSET.fields_by_name[
+    "iam_policy"
+].message_type = (
+    google_dot_iam_dot_v1_dot_policy__pb2.google_dot_iam_dot_v1_dot_policy__pb2._POLICY
+)
+_RESOURCE.fields_by_name[
+    "data"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+DESCRIPTOR.message_types_by_name["TemporalAsset"] = _TEMPORALASSET
+DESCRIPTOR.message_types_by_name["TimeWindow"] = _TIMEWINDOW
+DESCRIPTOR.message_types_by_name["Asset"] = _ASSET
+DESCRIPTOR.message_types_by_name["Resource"] = _RESOURCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TemporalAsset = _reflection.GeneratedProtocolMessageType(
+    "TemporalAsset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEMPORALASSET,
+        __module__="google.cloud.asset_v1.proto.assets_pb2",
+        __doc__="""Temporal asset. In addition to the asset, the temporal asset includes
+  the status of the asset and valid from and to time of it.
+  
+  
+  Attributes:
+      window:
+          The time window when the asset data and state was observed.
+      deleted:
+          If the asset is deleted or not.
+      asset:
+          Asset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.TemporalAsset)
+    ),
+)
+_sym_db.RegisterMessage(TemporalAsset)
+
+TimeWindow = _reflection.GeneratedProtocolMessageType(
+    "TimeWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEWINDOW,
+        __module__="google.cloud.asset_v1.proto.assets_pb2",
+        __doc__="""A time window of (start\_time, end\_time].
+  
+  
+  Attributes:
+      start_time:
+          Start time of the time window (exclusive).
+      end_time:
+          End time of the time window (inclusive). Current timestamp if
+          not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.TimeWindow)
+    ),
+)
+_sym_db.RegisterMessage(TimeWindow)
+
+Asset = _reflection.GeneratedProtocolMessageType(
+    "Asset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASSET,
+        __module__="google.cloud.asset_v1.proto.assets_pb2",
+        __doc__="""Cloud asset. This includes all Google Cloud Platform resources, Cloud
+  IAM policies, and other non-GCP assets.
+  
+  
+  Attributes:
+      name:
+
+          The full name of the asset. For example:
+          ``//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1``.
+          See https://cloud.google.com/apis/design/resource_names#full_resource_name
+          for more information.
+      asset_type:
+          Type of the asset. Example: "compute.googleapis.com/Disk".
+      resource:
+          Representation of the resource.
+      iam_policy:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.Asset)
+    ),
+)
+_sym_db.RegisterMessage(Asset)
+
+Resource = _reflection.GeneratedProtocolMessageType(
+    "Resource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESOURCE,
+        __module__="google.cloud.asset_v1.proto.assets_pb2",
+        __doc__="""Representation of a cloud resource.
+  
+  
+  Attributes:
+      version:
+          The API version. Example: "v1".
+      discovery_document_uri:
+          The URL of the discovery document containing the resource's
+          JSON schema. For example: ``"https://www.googleapis.com/discov
+          ery/v1/apis/compute/v1/rest"``. It will be left unspecified
+          for resources without a discovery-based API, such as Cloud
+          Bigtable.
+      discovery_name:
+          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.
+      resource_url:
+          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.
+      parent:
+          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#p
+          olicy_hierarchy>`__. For example: ``"//cloudresourcemanager.go
+          ogleapis.com/projects/my_project_123"``.  For third-party
+          assets, it is up to the users to define.
+      data:
+          The content of the resource, in which some sensitive fields
+          are scrubbed away and may not be present.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1.Resource)
+    ),
+)
+_sym_db.RegisterMessage(Resource)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/asset/google/cloud/asset_v1/proto/assets_pb2_grpc.py b/asset/google/cloud/asset_v1/proto/assets_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/asset/google/cloud/asset_v1/proto/assets_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/asset/google/cloud/asset_v1/types.py b/asset/google/cloud/asset_v1/types.py
new file mode 100644
index 000000000000..6dc0ded7c413
--- /dev/null
+++ b/asset/google/cloud/asset_v1/types.py
@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.asset_v1.proto import asset_service_pb2
+from google.cloud.asset_v1.proto import assets_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    policy_pb2,
+    operations_pb2,
+    any_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [asset_service_pb2, assets_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.asset_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/asset/google/cloud/asset_v1beta1/__init__.py b/asset/google/cloud/asset_v1beta1/__init__.py
new file mode 100644
index 000000000000..bd6e93391183
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.asset_v1beta1 import types
+from google.cloud.asset_v1beta1.gapic import asset_service_client
+from google.cloud.asset_v1beta1.gapic import enums
+
+
+class AssetServiceClient(asset_service_client.AssetServiceClient):
+    __doc__ = asset_service_client.AssetServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "AssetServiceClient")
diff --git a/asset/google/cloud/asset_v1beta1/gapic/__init__.py b/asset/google/cloud/asset_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1beta1/gapic/asset_service_client.py b/asset/google/cloud/asset_v1beta1/gapic/asset_service_client.py
new file mode 100644
index 000000000000..32b796af82ec
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/gapic/asset_service_client.py
@@ -0,0 +1,426 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.asset.v1beta1 AssetService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.path_template
+import grpc
+
+from google.cloud.asset_v1beta1.gapic import asset_service_client_config
+from google.cloud.asset_v1beta1.gapic import enums
+from google.cloud.asset_v1beta1.gapic.transports import asset_service_grpc_transport
+from google.cloud.asset_v1beta1.proto import asset_service_pb2
+from google.cloud.asset_v1beta1.proto import asset_service_pb2_grpc
+from google.cloud.asset_v1beta1.proto import assets_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-asset").version
+
+
+class AssetServiceClient(object):
+    """Asset service definition."""
+
+    SERVICE_ADDRESS = "cloudasset.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.asset.v1beta1.AssetService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            AssetServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.AssetServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.AssetServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = asset_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=asset_service_grpc_transport.AssetServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = asset_service_grpc_transport.AssetServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def export_assets(
+        self,
+        parent,
+        output_config,
+        read_time=None,
+        asset_types=None,
+        content_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` API allowing you to keep
+        track of the export.
+
+        Example:
+            >>> from google.cloud import asset_v1beta1
+            >>>
+            >>> client = asset_v1beta1.AssetServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_assets(parent, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. The relative name of the root asset. This can only be an
+                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").
+            output_config (Union[dict, ~google.cloud.asset_v1beta1.types.OutputConfig]): Required. Output configuration indicating where the results will be output
+                to. All results will be in newline delimited JSON format.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1beta1.types.OutputConfig`
+            read_time (Union[dict, ~google.cloud.asset_v1beta1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1beta1.types.Timestamp`
+            asset_types (list[str]): A list of asset types of which to take a snapshot for. For example:
+                "google.compute.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>`__
+                for all supported asset types.
+            content_type (~google.cloud.asset_v1beta1.types.ContentType): Asset content type. If not specified, no content but the asset name will be
+                returned.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_assets,
+                default_retry=self._method_configs["ExportAssets"].retry,
+                default_timeout=self._method_configs["ExportAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.ExportAssetsRequest(
+            parent=parent,
+            output_config=output_config,
+            read_time=read_time,
+            asset_types=asset_types,
+            content_type=content_type,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_assets"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            asset_service_pb2.ExportAssetsResponse,
+            metadata_type=asset_service_pb2.ExportAssetsRequest,
+        )
+
+    def batch_get_assets_history(
+        self,
+        parent,
+        content_type,
+        read_time_window,
+        asset_names=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Batch gets the update history of assets that overlap a time window. For
+        RESOURCE content, this API outputs history with asset in both 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.
+
+        Example:
+            >>> from google.cloud import asset_v1beta1
+            >>> from google.cloud.asset_v1beta1 import enums
+            >>>
+            >>> client = asset_v1beta1.AssetServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `content_type`:
+            >>> content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `read_time_window`:
+            >>> read_time_window = {}
+            >>>
+            >>> response = client.batch_get_assets_history(parent, content_type, read_time_window)
+
+        Args:
+            parent (str): 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").
+            content_type (~google.cloud.asset_v1beta1.types.ContentType): Required. The content type.
+            read_time_window (Union[dict, ~google.cloud.asset_v1beta1.types.TimeWindow]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1beta1.types.TimeWindow`
+            asset_names (list[str]): 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>`__
+                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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1beta1.types.BatchGetAssetsHistoryResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_get_assets_history" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_get_assets_history"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_get_assets_history,
+                default_retry=self._method_configs["BatchGetAssetsHistory"].retry,
+                default_timeout=self._method_configs["BatchGetAssetsHistory"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.BatchGetAssetsHistoryRequest(
+            parent=parent,
+            content_type=content_type,
+            read_time_window=read_time_window,
+            asset_names=asset_names,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_get_assets_history"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/asset/google/cloud/asset_v1beta1/gapic/asset_service_client_config.py b/asset/google/cloud/asset_v1beta1/gapic/asset_service_client_config.py
new file mode 100644
index 000000000000..340e89de38b2
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/gapic/asset_service_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.asset.v1beta1.AssetService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ExportAssets": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchGetAssetsHistory": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/asset/google/cloud/asset_v1beta1/gapic/enums.py b/asset/google/cloud/asset_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..780beae4ddef
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/gapic/enums.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ContentType(enum.IntEnum):
+    """
+    Asset content type.
+
+    Attributes:
+      CONTENT_TYPE_UNSPECIFIED (int): Unspecified content type.
+      RESOURCE (int): Resource metadata.
+      IAM_POLICY (int): The actual IAM policy set on a resource.
+    """
+
+    CONTENT_TYPE_UNSPECIFIED = 0
+    RESOURCE = 1
+    IAM_POLICY = 2
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
diff --git a/asset/google/cloud/asset_v1beta1/gapic/transports/__init__.py b/asset/google/cloud/asset_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1beta1/gapic/transports/asset_service_grpc_transport.py b/asset/google/cloud/asset_v1beta1/gapic/transports/asset_service_grpc_transport.py
new file mode 100644
index 000000000000..9e92ba565ce3
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/gapic/transports/asset_service_grpc_transport.py
@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.asset_v1beta1.proto import asset_service_pb2_grpc
+
+
+class AssetServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.asset.v1beta1 AssetService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudasset.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "asset_service_stub": asset_service_pb2_grpc.AssetServiceStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudasset.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def export_assets(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.export_assets`.
+
+        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`` API allowing you to keep
+        track of the export.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].ExportAssets
+
+    @property
+    def batch_get_assets_history(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.batch_get_assets_history`.
+
+        Batch gets the update history of assets that overlap a time window. For
+        RESOURCE content, this API outputs history with asset in both 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].BatchGetAssetsHistory
diff --git a/asset/google/cloud/asset_v1beta1/proto/__init__.py b/asset/google/cloud/asset_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1beta1/proto/asset_service.proto b/asset/google/cloud/asset_v1beta1/proto/asset_service.proto
new file mode 100644
index 000000000000..8e2d1b0a387e
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/proto/asset_service.proto
@@ -0,0 +1,182 @@
+// 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.cloud.asset.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/asset/v1beta1/assets.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Asset.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset";
+option java_multiple_files = true;
+option java_outer_classname = "AssetServiceProto";
+option java_package = "com.google.cloud.asset.v1beta1";
+option php_namespace = "Google\\Cloud\\Asset\\V1beta1";
+
+// Asset service definition.
+service AssetService {
+  // 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.
+  rpc ExportAssets(ExportAssetsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}:exportAssets"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{parent=folders/*}:exportAssets"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1beta1/{parent=organizations/*}:exportAssets"
+        body: "*"
+      }
+    };
+  }
+
+  // Batch gets the update history of assets that overlap a time window.
+  // For RESOURCE content, this API outputs history with asset in both
+  // 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.
+  rpc BatchGetAssetsHistory(BatchGetAssetsHistoryRequest)
+      returns (BatchGetAssetsHistoryResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}:batchGetAssetsHistory"
+      additional_bindings {
+        get: "/v1beta1/{parent=organizations/*}:batchGetAssetsHistory"
+      }
+    };
+  }
+}
+
+// Export asset request.
+message ExportAssetsRequest {
+  // Required. The relative name of the root asset. This can only be an
+  // 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;
+
+  // 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.
+  google.protobuf.Timestamp read_time = 2;
+
+  // A list of asset types of which to take a snapshot for. For example:
+  // "google.compute.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)
+  // for all supported asset types.
+  repeated string asset_types = 3;
+
+  // Asset content type. If not specified, no content but the asset name will be
+  // returned.
+  ContentType content_type = 4;
+
+  // Required. Output configuration indicating where the results will be output
+  // to. All results will be in newline delimited JSON format.
+  OutputConfig output_config = 5;
+}
+
+// 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.
+message ExportAssetsResponse {
+  // Time the snapshot was taken.
+  google.protobuf.Timestamp read_time = 1;
+
+  // Output configuration indicating where the results were output to.
+  // All results are in JSON format.
+  OutputConfig output_config = 2;
+}
+
+// Batch get assets history request.
+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;
+
+  // 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)
+  // 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 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;
+}
+
+// Batch get assets history response.
+message BatchGetAssetsHistoryResponse {
+  // A list of assets with valid time windows.
+  repeated TemporalAsset assets = 1;
+}
+
+// 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;
+  }
+}
+
+// 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/asset/google/cloud/asset_v1beta1/proto/asset_service_pb2.py b/asset/google/cloud/asset_v1beta1/proto/asset_service_pb2.py
new file mode 100644
index 000000000000..bd97c5aa8137
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/proto/asset_service_pb2.py
@@ -0,0 +1,728 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset_v1beta1/proto/asset_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.asset_v1beta1.proto import (
+    assets_pb2 as google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_assets__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/asset_v1beta1/proto/asset_service.proto",
+    package="google.cloud.asset.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.asset.v1beta1B\021AssetServiceProtoP\001Z?google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset\252\002\032Google.Cloud.Asset.V1Beta1\312\002\032Google\\Cloud\\Asset\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/asset_v1beta1/proto/asset_service.proto\x12\x1agoogle.cloud.asset.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/asset_v1beta1/proto/assets.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xe9\x01\n\x13\x45xportAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0b\x61sset_types\x18\x03 \x03(\t\x12=\n\x0c\x63ontent_type\x18\x04 \x01(\x0e\x32\'.google.cloud.asset.v1beta1.ContentType\x12?\n\routput_config\x18\x05 \x01(\x0b\x32(.google.cloud.asset.v1beta1.OutputConfig"\x86\x01\n\x14\x45xportAssetsResponse\x12-\n\tread_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12?\n\routput_config\x18\x02 \x01(\x0b\x32(.google.cloud.asset.v1beta1.OutputConfig"\xc4\x01\n\x1c\x42\x61tchGetAssetsHistoryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0b\x61sset_names\x18\x02 \x03(\t\x12=\n\x0c\x63ontent_type\x18\x03 \x01(\x0e\x32\'.google.cloud.asset.v1beta1.ContentType\x12@\n\x10read_time_window\x18\x04 \x01(\x0b\x32&.google.cloud.asset.v1beta1.TimeWindow"Z\n\x1d\x42\x61tchGetAssetsHistoryResponse\x12\x39\n\x06\x61ssets\x18\x01 \x03(\x0b\x32).google.cloud.asset.v1beta1.TemporalAsset"d\n\x0cOutputConfig\x12\x45\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32*.google.cloud.asset.v1beta1.GcsDestinationH\x00\x42\r\n\x0b\x64\x65stination"-\n\x0eGcsDestination\x12\r\n\x03uri\x18\x01 \x01(\tH\x00\x42\x0c\n\nobject_uri*I\n\x0b\x43ontentType\x12\x1c\n\x18\x43ONTENT_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08RESOURCE\x10\x01\x12\x0e\n\nIAM_POLICY\x10\x02\x32\x91\x04\n\x0c\x41ssetService\x12\xfa\x01\n\x0c\x45xportAssets\x12/.google.cloud.asset.v1beta1.ExportAssetsRequest\x1a\x1d.google.longrunning.Operation"\x99\x01\x82\xd3\xe4\x93\x02\x92\x01")/v1beta1/{parent=projects/*}:exportAssets:\x01*Z-"(/v1beta1/{parent=folders/*}:exportAssets:\x01*Z3"./v1beta1/{parent=organizations/*}:exportAssets:\x01*\x12\x83\x02\n\x15\x42\x61tchGetAssetsHistory\x12\x38.google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest\x1a\x39.google.cloud.asset.v1beta1.BatchGetAssetsHistoryResponse"u\x82\xd3\xe4\x93\x02o\x12\x32/v1beta1/{parent=projects/*}:batchGetAssetsHistoryZ9\x12\x37/v1beta1/{parent=organizations/*}:batchGetAssetsHistoryB\xb0\x01\n\x1e\x63om.google.cloud.asset.v1beta1B\x11\x41ssetServiceProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset\xaa\x02\x1aGoogle.Cloud.Asset.V1Beta1\xca\x02\x1aGoogle\\Cloud\\Asset\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_assets__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_CONTENTTYPE = _descriptor.EnumDescriptor(
+    name="ContentType",
+    full_name="google.cloud.asset.v1beta1.ContentType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CONTENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESOURCE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IAM_POLICY", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1044,
+    serialized_end=1117,
+)
+_sym_db.RegisterEnumDescriptor(_CONTENTTYPE)
+
+ContentType = enum_type_wrapper.EnumTypeWrapper(_CONTENTTYPE)
+CONTENT_TYPE_UNSPECIFIED = 0
+RESOURCE = 1
+IAM_POLICY = 2
+
+
+_EXPORTASSETSREQUEST = _descriptor.Descriptor(
+    name="ExportAssetsRequest",
+    full_name="google.cloud.asset.v1beta1.ExportAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsRequest.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_types",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsRequest.asset_types",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsRequest.content_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsRequest.output_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=232,
+    serialized_end=465,
+)
+
+
+_EXPORTASSETSRESPONSE = _descriptor.Descriptor(
+    name="ExportAssetsResponse",
+    full_name="google.cloud.asset.v1beta1.ExportAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsResponse.read_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.asset.v1beta1.ExportAssetsResponse.output_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=468,
+    serialized_end=602,
+)
+
+
+_BATCHGETASSETSHISTORYREQUEST = _descriptor.Descriptor(
+    name="BatchGetAssetsHistoryRequest",
+    full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_names",
+            full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest.asset_names",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest.content_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time_window",
+            full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest.read_time_window",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=605,
+    serialized_end=801,
+)
+
+
+_BATCHGETASSETSHISTORYRESPONSE = _descriptor.Descriptor(
+    name="BatchGetAssetsHistoryResponse",
+    full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="assets",
+            full_name="google.cloud.asset.v1beta1.BatchGetAssetsHistoryResponse.assets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=803,
+    serialized_end=893,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.asset.v1beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.asset.v1beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.asset.v1beta1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=895,
+    serialized_end=995,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.asset.v1beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.asset.v1beta1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="object_uri",
+            full_name="google.cloud.asset.v1beta1.GcsDestination.object_uri",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=997,
+    serialized_end=1042,
+)
+
+_EXPORTASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTASSETSREQUEST.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_EXPORTASSETSREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_EXPORTASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTASSETSRESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_BATCHGETASSETSHISTORYREQUEST.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_BATCHGETASSETSHISTORYREQUEST.fields_by_name[
+    "read_time_window"
+].message_type = (
+    google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_assets__pb2._TIMEWINDOW
+)
+_BATCHGETASSETSHISTORYRESPONSE.fields_by_name[
+    "assets"
+].message_type = (
+    google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_assets__pb2._TEMPORALASSET
+)
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_GCSDESTINATION.oneofs_by_name["object_uri"].fields.append(
+    _GCSDESTINATION.fields_by_name["uri"]
+)
+_GCSDESTINATION.fields_by_name["uri"].containing_oneof = _GCSDESTINATION.oneofs_by_name[
+    "object_uri"
+]
+DESCRIPTOR.message_types_by_name["ExportAssetsRequest"] = _EXPORTASSETSREQUEST
+DESCRIPTOR.message_types_by_name["ExportAssetsResponse"] = _EXPORTASSETSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchGetAssetsHistoryRequest"
+] = _BATCHGETASSETSHISTORYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchGetAssetsHistoryResponse"
+] = _BATCHGETASSETSHISTORYRESPONSE
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.enum_types_by_name["ContentType"] = _CONTENTTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ExportAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTASSETSREQUEST,
+        __module__="google.cloud.asset_v1beta1.proto.asset_service_pb2",
+        __doc__="""Export asset request.
+  
+  
+  Attributes:
+      parent:
+          Required. The relative name of the root asset. This can only
+          be an 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").
+      read_time:
+          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.
+      asset_types:
+          A list of asset types of which to take a snapshot for. For
+          example: "google.compute.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>`__ for all
+          supported asset types.
+      content_type:
+          Asset content type. If not specified, no content but the asset
+          name will be returned.
+      output_config:
+          Required. Output configuration indicating where the results
+          will be output to. All results will be in newline delimited
+          JSON format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.ExportAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportAssetsRequest)
+
+ExportAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ExportAssetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTASSETSRESPONSE,
+        __module__="google.cloud.asset_v1beta1.proto.asset_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      read_time:
+          Time the snapshot was taken.
+      output_config:
+          Output configuration indicating where the results were output
+          to. All results are in JSON format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.ExportAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ExportAssetsResponse)
+
+BatchGetAssetsHistoryRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchGetAssetsHistoryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETASSETSHISTORYREQUEST,
+        __module__="google.cloud.asset_v1beta1.proto.asset_service_pb2",
+        __doc__="""Batch get assets history request.
+  
+  
+  Attributes:
+      parent:
+          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").
+      asset_names:
+          A list of the full names of the assets. For example: ``//compu
+          te.googleapis.com/projects/my_project_123/zones/zone1/instance
+          s/instance1``. See `Resource Names <https://cloud.google.com/a
+          pis/design/resource_names#full_resource_name>`__ 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.
+      content_type:
+          Required. The content type.
+      read_time_window:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.BatchGetAssetsHistoryRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetAssetsHistoryRequest)
+
+BatchGetAssetsHistoryResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchGetAssetsHistoryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETASSETSHISTORYRESPONSE,
+        __module__="google.cloud.asset_v1beta1.proto.asset_service_pb2",
+        __doc__="""Batch get assets history response.
+  
+  
+  Attributes:
+      assets:
+          A list of assets with valid time windows.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.BatchGetAssetsHistoryResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetAssetsHistoryResponse)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.asset_v1beta1.proto.asset_service_pb2",
+        __doc__="""Output configuration for export assets destination.
+  
+  
+  Attributes:
+      destination:
+          Asset export destination.
+      gcs_destination:
+          Destination on Cloud Storage.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.asset_v1beta1.proto.asset_service_pb2",
+        __doc__="""A Cloud Storage location.
+  
+  
+  Attributes:
+      object_uri:
+          Required.
+      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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+
+DESCRIPTOR._options = None
+
+_ASSETSERVICE = _descriptor.ServiceDescriptor(
+    name="AssetService",
+    full_name="google.cloud.asset.v1beta1.AssetService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1120,
+    serialized_end=1649,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ExportAssets",
+            full_name="google.cloud.asset.v1beta1.AssetService.ExportAssets",
+            index=0,
+            containing_service=None,
+            input_type=_EXPORTASSETSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\222\001")/v1beta1/{parent=projects/*}:exportAssets:\001*Z-"(/v1beta1/{parent=folders/*}:exportAssets:\001*Z3"./v1beta1/{parent=organizations/*}:exportAssets:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchGetAssetsHistory",
+            full_name="google.cloud.asset.v1beta1.AssetService.BatchGetAssetsHistory",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHGETASSETSHISTORYREQUEST,
+            output_type=_BATCHGETASSETSHISTORYRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002o\0222/v1beta1/{parent=projects/*}:batchGetAssetsHistoryZ9\0227/v1beta1/{parent=organizations/*}:batchGetAssetsHistory"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_ASSETSERVICE)
+
+DESCRIPTOR.services_by_name["AssetService"] = _ASSETSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/asset/google/cloud/asset_v1beta1/proto/asset_service_pb2_grpc.py b/asset/google/cloud/asset_v1beta1/proto/asset_service_pb2_grpc.py
new file mode 100644
index 000000000000..35e7c536eae5
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/proto/asset_service_pb2_grpc.py
@@ -0,0 +1,77 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.asset_v1beta1.proto import (
+    asset_service_pb2 as google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class AssetServiceStub(object):
+    """Asset service definition.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ExportAssets = channel.unary_unary(
+            "/google.cloud.asset.v1beta1.AssetService/ExportAssets",
+            request_serializer=google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2.ExportAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.BatchGetAssetsHistory = channel.unary_unary(
+            "/google.cloud.asset.v1beta1.AssetService/BatchGetAssetsHistory",
+            request_serializer=google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryResponse.FromString,
+        )
+
+
+class AssetServiceServicer(object):
+    """Asset service definition.
+  """
+
+    def ExportAssets(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchGetAssetsHistory(self, request, context):
+        """Batch gets the update history of assets that overlap a time window.
+    For RESOURCE content, this API outputs history with asset in both
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_AssetServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ExportAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportAssets,
+            request_deserializer=google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2.ExportAssetsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "BatchGetAssetsHistory": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchGetAssetsHistory,
+            request_deserializer=google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.asset.v1beta1.AssetService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/asset/google/cloud/asset_v1beta1/proto/assets.proto b/asset/google/cloud/asset_v1beta1/proto/assets.proto
new file mode 100644
index 000000000000..84db977b97d7
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/proto/assets.proto
@@ -0,0 +1,117 @@
+// 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.cloud.asset.v1beta1;
+
+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 csharp_namespace = "Google.Cloud.Asset.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset";
+option java_multiple_files = true;
+option java_outer_classname = "AssetProto";
+option java_package = "com.google.cloud.asset.v1beta1";
+option php_namespace = "Google\\Cloud\\Asset\\V1beta1";
+
+// 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: "google.compute.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;
+}
+
+// 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/asset/google/cloud/asset_v1beta1/proto/assets_pb2.py b/asset/google/cloud/asset_v1beta1/proto/assets_pb2.py
new file mode 100644
index 000000000000..6a04ad0a8fdd
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/proto/assets_pb2.py
@@ -0,0 +1,544 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset_v1beta1/proto/assets.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/asset_v1beta1/proto/assets.proto",
+    package="google.cloud.asset.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.asset.v1beta1B\nAssetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset\252\002\032Google.Cloud.Asset.V1Beta1\312\002\032Google\\Cloud\\Asset\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/asset_v1beta1/proto/assets.proto\x12\x1agoogle.cloud.asset.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x19google/protobuf/any.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x8a\x01\n\rTemporalAsset\x12\x36\n\x06window\x18\x01 \x01(\x0b\x32&.google.cloud.asset.v1beta1.TimeWindow\x12\x0f\n\x07\x64\x65leted\x18\x02 \x01(\x08\x12\x30\n\x05\x61sset\x18\x03 \x01(\x0b\x32!.google.cloud.asset.v1beta1.Asset"j\n\nTimeWindow\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8c\x01\n\x05\x41sset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x36\n\x08resource\x18\x03 \x01(\x0b\x32$.google.cloud.asset.v1beta1.Resource\x12)\n\niam_policy\x18\x04 \x01(\x0b\x32\x15.google.iam.v1.Policy"\xa0\x01\n\x08Resource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x1e\n\x16\x64iscovery_document_uri\x18\x02 \x01(\t\x12\x16\n\x0e\x64iscovery_name\x18\x03 \x01(\t\x12\x14\n\x0cresource_url\x18\x04 \x01(\t\x12\x0e\n\x06parent\x18\x05 \x01(\t\x12%\n\x04\x64\x61ta\x18\x06 \x01(\x0b\x32\x17.google.protobuf.StructB\xa9\x01\n\x1e\x63om.google.cloud.asset.v1beta1B\nAssetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset\xaa\x02\x1aGoogle.Cloud.Asset.V1Beta1\xca\x02\x1aGoogle\\Cloud\\Asset\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEMPORALASSET = _descriptor.Descriptor(
+    name="TemporalAsset",
+    full_name="google.cloud.asset.v1beta1.TemporalAsset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="window",
+            full_name="google.cloud.asset.v1beta1.TemporalAsset.window",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deleted",
+            full_name="google.cloud.asset.v1beta1.TemporalAsset.deleted",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset",
+            full_name="google.cloud.asset.v1beta1.TemporalAsset.asset",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=226,
+    serialized_end=364,
+)
+
+
+_TIMEWINDOW = _descriptor.Descriptor(
+    name="TimeWindow",
+    full_name="google.cloud.asset.v1beta1.TimeWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.asset.v1beta1.TimeWindow.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.asset.v1beta1.TimeWindow.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=366,
+    serialized_end=472,
+)
+
+
+_ASSET = _descriptor.Descriptor(
+    name="Asset",
+    full_name="google.cloud.asset.v1beta1.Asset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.asset.v1beta1.Asset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_type",
+            full_name="google.cloud.asset.v1beta1.Asset.asset_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource",
+            full_name="google.cloud.asset.v1beta1.Asset.resource",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="iam_policy",
+            full_name="google.cloud.asset.v1beta1.Asset.iam_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=475,
+    serialized_end=615,
+)
+
+
+_RESOURCE = _descriptor.Descriptor(
+    name="Resource",
+    full_name="google.cloud.asset.v1beta1.Resource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.asset.v1beta1.Resource.version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery_document_uri",
+            full_name="google.cloud.asset.v1beta1.Resource.discovery_document_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery_name",
+            full_name="google.cloud.asset.v1beta1.Resource.discovery_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_url",
+            full_name="google.cloud.asset.v1beta1.Resource.resource_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1beta1.Resource.parent",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.cloud.asset.v1beta1.Resource.data",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=618,
+    serialized_end=778,
+)
+
+_TEMPORALASSET.fields_by_name["window"].message_type = _TIMEWINDOW
+_TEMPORALASSET.fields_by_name["asset"].message_type = _ASSET
+_TIMEWINDOW.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEWINDOW.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ASSET.fields_by_name["resource"].message_type = _RESOURCE
+_ASSET.fields_by_name[
+    "iam_policy"
+].message_type = (
+    google_dot_iam_dot_v1_dot_policy__pb2.google_dot_iam_dot_v1_dot_policy__pb2._POLICY
+)
+_RESOURCE.fields_by_name[
+    "data"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+DESCRIPTOR.message_types_by_name["TemporalAsset"] = _TEMPORALASSET
+DESCRIPTOR.message_types_by_name["TimeWindow"] = _TIMEWINDOW
+DESCRIPTOR.message_types_by_name["Asset"] = _ASSET
+DESCRIPTOR.message_types_by_name["Resource"] = _RESOURCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TemporalAsset = _reflection.GeneratedProtocolMessageType(
+    "TemporalAsset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEMPORALASSET,
+        __module__="google.cloud.asset_v1beta1.proto.assets_pb2",
+        __doc__="""Temporal asset. In addition to the asset, the temporal asset includes
+  the status of the asset and valid from and to time of it.
+  
+  
+  Attributes:
+      window:
+          The time window when the asset data and state was observed.
+      deleted:
+          If the asset is deleted or not.
+      asset:
+          Asset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.TemporalAsset)
+    ),
+)
+_sym_db.RegisterMessage(TemporalAsset)
+
+TimeWindow = _reflection.GeneratedProtocolMessageType(
+    "TimeWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEWINDOW,
+        __module__="google.cloud.asset_v1beta1.proto.assets_pb2",
+        __doc__="""A time window of (start\_time, end\_time].
+  
+  
+  Attributes:
+      start_time:
+          Start time of the time window (exclusive).
+      end_time:
+          End time of the time window (inclusive). Current timestamp if
+          not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.TimeWindow)
+    ),
+)
+_sym_db.RegisterMessage(TimeWindow)
+
+Asset = _reflection.GeneratedProtocolMessageType(
+    "Asset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASSET,
+        __module__="google.cloud.asset_v1beta1.proto.assets_pb2",
+        __doc__="""Cloud asset. This includes all Google Cloud Platform resources, Cloud
+  IAM policies, and other non-GCP assets.
+  
+  
+  Attributes:
+      name:
+
+          The full name of the asset. For example:
+          ``//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1``.
+          See https://cloud.google.com/apis/design/resource_names#full_resource_name
+          for more information.
+      asset_type:
+          Type of the asset. Example: "google.compute.Disk".
+      resource:
+          Representation of the resource.
+      iam_policy:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.Asset)
+    ),
+)
+_sym_db.RegisterMessage(Asset)
+
+Resource = _reflection.GeneratedProtocolMessageType(
+    "Resource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESOURCE,
+        __module__="google.cloud.asset_v1beta1.proto.assets_pb2",
+        __doc__="""Representation of a cloud resource.
+  
+  
+  Attributes:
+      version:
+          The API version. Example: "v1".
+      discovery_document_uri:
+          The URL of the discovery document containing the resource's
+          JSON schema. For example: ``"https://www.googleapis.com/discov
+          ery/v1/apis/compute/v1/rest"``. It will be left unspecified
+          for resources without a discovery-based API, such as Cloud
+          Bigtable.
+      discovery_name:
+          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.
+      resource_url:
+          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.
+      parent:
+          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#p
+          olicy_hierarchy>`__. For example: ``"//cloudresourcemanager.go
+          ogleapis.com/projects/my_project_123"``.  For third-party
+          assets, it is up to the users to define.
+      data:
+          The content of the resource, in which some sensitive fields
+          are scrubbed away and may not be present.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1beta1.Resource)
+    ),
+)
+_sym_db.RegisterMessage(Resource)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/asset/google/cloud/asset_v1beta1/proto/assets_pb2_grpc.py b/asset/google/cloud/asset_v1beta1/proto/assets_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/proto/assets_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/asset/google/cloud/asset_v1beta1/types.py b/asset/google/cloud/asset_v1beta1/types.py
new file mode 100644
index 000000000000..cf051722e176
--- /dev/null
+++ b/asset/google/cloud/asset_v1beta1/types.py
@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.asset_v1beta1.proto import asset_service_pb2
+from google.cloud.asset_v1beta1.proto import assets_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    policy_pb2,
+    operations_pb2,
+    any_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [asset_service_pb2, assets_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.asset_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/asset/google/cloud/asset_v1p2beta1/__init__.py b/asset/google/cloud/asset_v1p2beta1/__init__.py
new file mode 100644
index 000000000000..07b349a3269b
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.asset_v1p2beta1 import types
+from google.cloud.asset_v1p2beta1.gapic import asset_service_client
+from google.cloud.asset_v1p2beta1.gapic import enums
+
+
+class AssetServiceClient(asset_service_client.AssetServiceClient):
+    __doc__ = asset_service_client.AssetServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "AssetServiceClient")
diff --git a/asset/google/cloud/asset_v1p2beta1/gapic/__init__.py b/asset/google/cloud/asset_v1p2beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1p2beta1/gapic/asset_service_client.py b/asset/google/cloud/asset_v1p2beta1/gapic/asset_service_client.py
new file mode 100644
index 000000000000..b4cdc2b0da2d
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/gapic/asset_service_client.py
@@ -0,0 +1,827 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.asset.v1p2beta1 AssetService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.path_template
+import grpc
+
+from google.cloud.asset_v1p2beta1.gapic import asset_service_client_config
+from google.cloud.asset_v1p2beta1.gapic import enums
+from google.cloud.asset_v1p2beta1.gapic.transports import asset_service_grpc_transport
+from google.cloud.asset_v1p2beta1.proto import asset_service_pb2
+from google.cloud.asset_v1p2beta1.proto import asset_service_pb2_grpc
+from google.cloud.asset_v1p2beta1.proto import assets_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-asset").version
+
+
+class AssetServiceClient(object):
+    """Asset service definition."""
+
+    SERVICE_ADDRESS = "cloudasset.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.asset.v1p2beta1.AssetService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            AssetServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def feed_path(cls, project, feed):
+        """Return a fully-qualified feed string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/feeds/{feed}", project=project, feed=feed
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.AssetServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.AssetServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = asset_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=asset_service_grpc_transport.AssetServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = asset_service_grpc_transport.AssetServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def export_assets(
+        self,
+        parent,
+        output_config,
+        read_time=None,
+        asset_types=None,
+        content_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` API allowing you to keep
+        track of the export.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_assets(parent, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. The relative name of the root asset. This 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").
+            output_config (Union[dict, ~google.cloud.asset_v1p2beta1.types.OutputConfig]): Required. Output configuration indicating where the results will be output
+                to. All results will be in newline delimited JSON format.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1p2beta1.types.OutputConfig`
+            read_time (Union[dict, ~google.cloud.asset_v1p2beta1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1p2beta1.types.Timestamp`
+            asset_types (list[str]): 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>`__
+                for all supported asset types.
+            content_type (~google.cloud.asset_v1p2beta1.types.ContentType): Asset content type. If not specified, no content but the asset name will be
+                returned.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1p2beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_assets,
+                default_retry=self._method_configs["ExportAssets"].retry,
+                default_timeout=self._method_configs["ExportAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.ExportAssetsRequest(
+            parent=parent,
+            output_config=output_config,
+            read_time=read_time,
+            asset_types=asset_types,
+            content_type=content_type,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_assets"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            asset_service_pb2.ExportAssetsResponse,
+            metadata_type=asset_service_pb2.ExportAssetsRequest,
+        )
+
+    def batch_get_assets_history(
+        self,
+        parent,
+        asset_names,
+        content_type,
+        read_time_window=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Batch gets the update history of assets that overlap a time window. For
+        RESOURCE content, this API outputs history with asset in both 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.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>> from google.cloud.asset_v1p2beta1 import enums
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> # TODO: Initialize `asset_names`:
+            >>> asset_names = []
+            >>>
+            >>> # TODO: Initialize `content_type`:
+            >>> content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+            >>>
+            >>> response = client.batch_get_assets_history(parent, asset_names, content_type)
+
+        Args:
+            parent (str): 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").
+            asset_names (list[str]): 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>`__
+                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.
+            content_type (~google.cloud.asset_v1p2beta1.types.ContentType): Required. The content type.
+            read_time_window (Union[dict, ~google.cloud.asset_v1p2beta1.types.TimeWindow]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1p2beta1.types.TimeWindow`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1p2beta1.types.BatchGetAssetsHistoryResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_get_assets_history" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_get_assets_history"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_get_assets_history,
+                default_retry=self._method_configs["BatchGetAssetsHistory"].retry,
+                default_timeout=self._method_configs["BatchGetAssetsHistory"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.BatchGetAssetsHistoryRequest(
+            parent=parent,
+            asset_names=asset_names,
+            content_type=content_type,
+            read_time_window=read_time_window,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_get_assets_history"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_feed(
+        self,
+        parent,
+        feed_id,
+        feed,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a feed in a parent project/folder/organization to listen to its
+        asset updates.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> # TODO: Initialize `feed_id`:
+            >>> feed_id = ''
+            >>>
+            >>> # TODO: Initialize `feed`:
+            >>> feed = {}
+            >>>
+            >>> response = client.create_feed(parent, feed_id, feed)
+
+        Args:
+            parent (str): 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").
+            feed_id (str): Required. This is the client-assigned asset feed identifier and it needs to
+                be unique under a specific parent project/folder/organization.
+            feed (Union[dict, ~google.cloud.asset_v1p2beta1.types.Feed]): 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
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1p2beta1.types.Feed`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1p2beta1.types.Feed` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_feed" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_feed"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_feed,
+                default_retry=self._method_configs["CreateFeed"].retry,
+                default_timeout=self._method_configs["CreateFeed"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.CreateFeedRequest(
+            parent=parent, feed_id=feed_id, feed=feed
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_feed"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_feed(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets details about an asset feed.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> name = client.feed_path('[PROJECT]', '[FEED]')
+            >>>
+            >>> response = client.get_feed(name)
+
+        Args:
+            name (str): 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
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1p2beta1.types.Feed` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_feed" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_feed"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_feed,
+                default_retry=self._method_configs["GetFeed"].retry,
+                default_timeout=self._method_configs["GetFeed"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.GetFeedRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_feed"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_feeds(
+        self,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all asset feeds in a parent project/folder/organization.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> response = client.list_feeds(parent)
+
+        Args:
+            parent (str): 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").
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1p2beta1.types.ListFeedsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_feeds" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_feeds"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_feeds,
+                default_retry=self._method_configs["ListFeeds"].retry,
+                default_timeout=self._method_configs["ListFeeds"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.ListFeedsRequest(parent=parent)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_feeds"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_feed(
+        self,
+        feed,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an asset feed configuration.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> # TODO: Initialize `feed`:
+            >>> feed = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_feed(feed, update_mask)
+
+        Args:
+            feed (Union[dict, ~google.cloud.asset_v1p2beta1.types.Feed]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1p2beta1.types.Feed`
+            update_mask (Union[dict, ~google.cloud.asset_v1p2beta1.types.FieldMask]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.asset_v1p2beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.asset_v1p2beta1.types.Feed` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_feed" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_feed"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_feed,
+                default_retry=self._method_configs["UpdateFeed"].retry,
+                default_timeout=self._method_configs["UpdateFeed"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.UpdateFeedRequest(
+            feed=feed, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("feed.name", feed.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_feed"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_feed(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an asset feed.
+
+        Example:
+            >>> from google.cloud import asset_v1p2beta1
+            >>>
+            >>> client = asset_v1p2beta1.AssetServiceClient()
+            >>>
+            >>> name = client.feed_path('[PROJECT]', '[FEED]')
+            >>>
+            >>> client.delete_feed(name)
+
+        Args:
+            name (str): 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
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_feed" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_feed"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_feed,
+                default_retry=self._method_configs["DeleteFeed"].retry,
+                default_timeout=self._method_configs["DeleteFeed"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = asset_service_pb2.DeleteFeedRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_feed"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/asset/google/cloud/asset_v1p2beta1/gapic/asset_service_client_config.py b/asset/google/cloud/asset_v1p2beta1/gapic/asset_service_client_config.py
new file mode 100644
index 000000000000..f3eab9e21e3b
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/gapic/asset_service_client_config.py
@@ -0,0 +1,58 @@
+config = {
+    "interfaces": {
+        "google.cloud.asset.v1p2beta1.AssetService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ExportAssets": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchGetAssetsHistory": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateFeed": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetFeed": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFeeds": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateFeed": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteFeed": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/asset/google/cloud/asset_v1p2beta1/gapic/enums.py b/asset/google/cloud/asset_v1p2beta1/gapic/enums.py
new file mode 100644
index 000000000000..a9541ab2c818
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/gapic/enums.py
@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ContentType(enum.IntEnum):
+    """
+    Asset content type.
+
+    Attributes:
+      CONTENT_TYPE_UNSPECIFIED (int): Unspecified content type.
+      RESOURCE (int): Resource metadata.
+      IAM_POLICY (int): The actual IAM policy set on a resource.
+      IAM_POLICY_NAME (int): The IAM policy name for the IAM policy set on a resource.
+      ORG_POLICY (int)
+      ACCESS_POLICY (int): The Cloud Access context mananger Policy set on an asset.
+    """
+
+    CONTENT_TYPE_UNSPECIFIED = 0
+    RESOURCE = 1
+    IAM_POLICY = 2
+    IAM_POLICY_NAME = 3
+    ORG_POLICY = 4
+    ACCESS_POLICY = 5
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
diff --git a/asset/google/cloud/asset_v1p2beta1/gapic/transports/__init__.py b/asset/google/cloud/asset_v1p2beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1p2beta1/gapic/transports/asset_service_grpc_transport.py b/asset/google/cloud/asset_v1p2beta1/gapic/transports/asset_service_grpc_transport.py
new file mode 100644
index 000000000000..d7c33e9f0f5f
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/gapic/transports/asset_service_grpc_transport.py
@@ -0,0 +1,215 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.asset_v1p2beta1.proto import asset_service_pb2_grpc
+
+
+class AssetServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.asset.v1p2beta1 AssetService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudasset.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "asset_service_stub": asset_service_pb2_grpc.AssetServiceStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudasset.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def export_assets(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.export_assets`.
+
+        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`` API allowing you to keep
+        track of the export.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].ExportAssets
+
+    @property
+    def batch_get_assets_history(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.batch_get_assets_history`.
+
+        Batch gets the update history of assets that overlap a time window. For
+        RESOURCE content, this API outputs history with asset in both 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].BatchGetAssetsHistory
+
+    @property
+    def create_feed(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.create_feed`.
+
+        Creates a feed in a parent project/folder/organization to listen to its
+        asset updates.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].CreateFeed
+
+    @property
+    def get_feed(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.get_feed`.
+
+        Gets details about an asset feed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].GetFeed
+
+    @property
+    def list_feeds(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.list_feeds`.
+
+        Lists all asset feeds in a parent project/folder/organization.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].ListFeeds
+
+    @property
+    def update_feed(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.update_feed`.
+
+        Updates an asset feed configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].UpdateFeed
+
+    @property
+    def delete_feed(self):
+        """Return the gRPC stub for :meth:`AssetServiceClient.delete_feed`.
+
+        Deletes an asset feed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["asset_service_stub"].DeleteFeed
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/__init__.py b/asset/google/cloud/asset_v1p2beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/asset_service.proto b/asset/google/cloud/asset_v1p2beta1/proto/asset_service.proto
new file mode 100644
index 000000000000..0d461d0fa81c
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/proto/asset_service.proto
@@ -0,0 +1,384 @@
+// 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/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";
+import "google/api/client.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";
+
+  // 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.
+  rpc ExportAssets(ExportAssetsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p2beta1/{parent=*/*}:exportAssets"
+      body: "*"
+    };
+  }
+
+  // Batch gets the update history of assets that overlap a time window.
+  // For RESOURCE content, this API outputs history with asset in both
+  // 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.
+  rpc BatchGetAssetsHistory(BatchGetAssetsHistoryRequest) returns (BatchGetAssetsHistoryResponse) {
+    option (google.api.http) = {
+      get: "/v1p2beta1/{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: "/v1p2beta1/{parent=*/*}/feeds"
+      body: "*"
+    };
+  }
+
+  // Gets details about an asset feed.
+  rpc GetFeed(GetFeedRequest) returns (Feed) {
+    option (google.api.http) = {
+      get: "/v1p2beta1/{name=*/*/feeds/*}"
+    };
+  }
+
+  // Lists all asset feeds in a parent project/folder/organization.
+  rpc ListFeeds(ListFeedsRequest) returns (ListFeedsResponse) {
+    option (google.api.http) = {
+      get: "/v1p2beta1/{parent=*/*}/feeds"
+    };
+  }
+
+  // Updates an asset feed configuration.
+  rpc UpdateFeed(UpdateFeedRequest) returns (Feed) {
+    option (google.api.http) = {
+      patch: "/v1p2beta1/{feed.name=*/*/feeds/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes an asset feed.
+  rpc DeleteFeed(DeleteFeedRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1p2beta1/{name=*/*/feeds/*}"
+    };
+  }
+}
+
+// Export asset request.
+message ExportAssetsRequest {
+  // Required. The relative name of the root asset. This 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;
+
+  // 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.
+  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)
+  // for all supported asset types.
+  repeated string asset_types = 3;
+
+  // Asset content type. If not specified, no content but the asset name will be
+  // returned.
+  ContentType content_type = 4;
+
+  // Required. Output configuration indicating where the results will be output
+  // to. All results will be in newline delimited JSON format.
+  OutputConfig output_config = 5;
+}
+
+// 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.
+message ExportAssetsResponse {
+  // Time the snapshot was taken.
+  google.protobuf.Timestamp read_time = 1;
+
+  // Output configuration indicating where the results were output to.
+  // All results are in JSON format.
+  OutputConfig output_config = 2;
+}
+
+// Batch get assets history request.
+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;
+
+  // 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)
+  // 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 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;
+}
+
+// Batch get assets history response.
+message BatchGetAssetsHistoryResponse {
+  // A list of assets with valid time windows.
+  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;
+
+  // 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;
+
+  // 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;
+}
+
+// Get asset feed request.
+message GetFeedRequest {
+  // 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;
+}
+
+// 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;
+}
+
+// List asset feeds response.
+message ListFeedsResponse {
+  // A list of feeds.
+  repeated Feed feeds = 1;
+}
+
+// Update asset feed request.
+message UpdateFeedRequest {
+  // 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;
+
+  // 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;
+}
+
+// Delete asset feed request.
+message DeleteFeedRequest {
+  // 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;
+}
+
+// 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;
+  }
+}
+
+// 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;
+
+    // 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/<asset type>/<shard number> and only
+    // contains assets for that type. <shard number> 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 error.
+  string dataset = 1;
+
+  // 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;
+
+  // 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 not set and the destination table already exists, the export call
+  // returns an error.
+  bool force = 3;
+}
+
+// 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;
+}
+
+// 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;
+
+  // The IAM policy name for the IAM policy set on a resource.
+  IAM_POLICY_NAME = 3;
+
+  ORG_POLICY = 4;
+
+  // The Cloud Access context mananger Policy set on an asset.
+  ACCESS_POLICY = 5;
+}
+
+// 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 {
+  // 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;
+
+  // 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;
+}
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/asset_service_pb2.py b/asset/google/cloud/asset_v1p2beta1/proto/asset_service_pb2.py
new file mode 100644
index 000000000000..0275b6737a02
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/proto/asset_service_pb2.py
@@ -0,0 +1,1717 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset_v1p2beta1/proto/asset_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.asset_v1p2beta1.proto import (
+    assets_pb2 as google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_assets__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/asset_v1p2beta1/proto/asset_service.proto",
+    package="google.cloud.asset.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n com.google.cloud.asset.v1p2beta1B\021AssetServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/asset/v1p2beta1;asset\252\002\034Google.Cloud.Asset.V1p2Beta1\312\002\034Google\\Cloud\\Asset\\V1p2Beta1"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/asset_v1p2beta1/proto/asset_service.proto\x12\x1cgoogle.cloud.asset.v1p2beta1\x1a\x1cgoogle/api/annotations.proto\x1a/google/cloud/asset_v1p2beta1/proto/assets.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/api/client.proto"\xed\x01\n\x13\x45xportAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0b\x61sset_types\x18\x03 \x03(\t\x12?\n\x0c\x63ontent_type\x18\x04 \x01(\x0e\x32).google.cloud.asset.v1p2beta1.ContentType\x12\x41\n\routput_config\x18\x05 \x01(\x0b\x32*.google.cloud.asset.v1p2beta1.OutputConfig"\x88\x01\n\x14\x45xportAssetsResponse\x12-\n\tread_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x41\n\routput_config\x18\x02 \x01(\x0b\x32*.google.cloud.asset.v1p2beta1.OutputConfig"\xc8\x01\n\x1c\x42\x61tchGetAssetsHistoryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0b\x61sset_names\x18\x02 \x03(\t\x12?\n\x0c\x63ontent_type\x18\x03 \x01(\x0e\x32).google.cloud.asset.v1p2beta1.ContentType\x12\x42\n\x10read_time_window\x18\x04 \x01(\x0b\x32(.google.cloud.asset.v1p2beta1.TimeWindow"\\\n\x1d\x42\x61tchGetAssetsHistoryResponse\x12;\n\x06\x61ssets\x18\x01 \x03(\x0b\x32+.google.cloud.asset.v1p2beta1.TemporalAsset"f\n\x11\x43reateFeedRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0f\n\x07\x66\x65\x65\x64_id\x18\x02 \x01(\t\x12\x30\n\x04\x66\x65\x65\x64\x18\x03 \x01(\x0b\x32".google.cloud.asset.v1p2beta1.Feed"\x1e\n\x0eGetFeedRequest\x12\x0c\n\x04name\x18\x01 \x01(\t""\n\x10ListFeedsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t"F\n\x11ListFeedsResponse\x12\x31\n\x05\x66\x65\x65\x64s\x18\x01 \x03(\x0b\x32".google.cloud.asset.v1p2beta1.Feed"v\n\x11UpdateFeedRequest\x12\x30\n\x04\x66\x65\x65\x64\x18\x01 \x01(\x0b\x32".google.cloud.asset.v1p2beta1.Feed\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"!\n\x11\x44\x65leteFeedRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xb9\x01\n\x0cOutputConfig\x12G\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32,.google.cloud.asset.v1p2beta1.GcsDestinationH\x00\x12Q\n\x14\x62igquery_destination\x18\x02 \x01(\x0b\x32\x31.google.cloud.asset.v1p2beta1.BigQueryDestinationH\x00\x42\r\n\x0b\x64\x65stination"C\n\x0eGcsDestination\x12\r\n\x03uri\x18\x01 \x01(\tH\x00\x12\x14\n\nuri_prefix\x18\x02 \x01(\tH\x00\x42\x0c\n\nobject_uri"D\n\x13\x42igQueryDestination\x12\x0f\n\x07\x64\x61taset\x18\x01 \x01(\t\x12\r\n\x05table\x18\x02 \x01(\t\x12\r\n\x05\x66orce\x18\x03 \x01(\x08""\n\x11PubsubDestination\x12\r\n\x05topic\x18\x01 \x01(\t"p\n\x10\x46\x65\x65\x64OutputConfig\x12M\n\x12pubsub_destination\x18\x01 \x01(\x0b\x32/.google.cloud.asset.v1p2beta1.PubsubDestinationH\x00\x42\r\n\x0b\x64\x65stination"\xcb\x01\n\x04\x46\x65\x65\x64\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x61sset_names\x18\x02 \x03(\t\x12\x13\n\x0b\x61sset_types\x18\x03 \x03(\t\x12?\n\x0c\x63ontent_type\x18\x04 \x01(\x0e\x32).google.cloud.asset.v1p2beta1.ContentType\x12J\n\x12\x66\x65\x65\x64_output_config\x18\x05 \x01(\x0b\x32..google.cloud.asset.v1p2beta1.FeedOutputConfig*\x81\x01\n\x0b\x43ontentType\x12\x1c\n\x18\x43ONTENT_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08RESOURCE\x10\x01\x12\x0e\n\nIAM_POLICY\x10\x02\x12\x13\n\x0fIAM_POLICY_NAME\x10\x03\x12\x0e\n\nORG_POLICY\x10\x04\x12\x11\n\rACCESS_POLICY\x10\x05\x32\xf5\x08\n\x0c\x41ssetService\x12\x91\x01\n\x0c\x45xportAssets\x12\x31.google.cloud.asset.v1p2beta1.ExportAssetsRequest\x1a\x1d.google.longrunning.Operation"/\x82\xd3\xe4\x93\x02)"$/v1p2beta1/{parent=*/*}:exportAssets:\x01*\x12\xc7\x01\n\x15\x42\x61tchGetAssetsHistory\x12:.google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest\x1a;.google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryResponse"5\x82\xd3\xe4\x93\x02/\x12-/v1p2beta1/{parent=*/*}:batchGetAssetsHistory\x12\x8b\x01\n\nCreateFeed\x12/.google.cloud.asset.v1p2beta1.CreateFeedRequest\x1a".google.cloud.asset.v1p2beta1.Feed"(\x82\xd3\xe4\x93\x02""\x1d/v1p2beta1/{parent=*/*}/feeds:\x01*\x12\x82\x01\n\x07GetFeed\x12,.google.cloud.asset.v1p2beta1.GetFeedRequest\x1a".google.cloud.asset.v1p2beta1.Feed"%\x82\xd3\xe4\x93\x02\x1f\x12\x1d/v1p2beta1/{name=*/*/feeds/*}\x12\x93\x01\n\tListFeeds\x12..google.cloud.asset.v1p2beta1.ListFeedsRequest\x1a/.google.cloud.asset.v1p2beta1.ListFeedsResponse"%\x82\xd3\xe4\x93\x02\x1f\x12\x1d/v1p2beta1/{parent=*/*}/feeds\x12\x90\x01\n\nUpdateFeed\x12/.google.cloud.asset.v1p2beta1.UpdateFeedRequest\x1a".google.cloud.asset.v1p2beta1.Feed"-\x82\xd3\xe4\x93\x02\'2"/v1p2beta1/{feed.name=*/*/feeds/*}:\x01*\x12|\n\nDeleteFeed\x12/.google.cloud.asset.v1p2beta1.DeleteFeedRequest\x1a\x16.google.protobuf.Empty"%\x82\xd3\xe4\x93\x02\x1f*\x1d/v1p2beta1/{name=*/*/feeds/*}\x1aM\xca\x41\x19\x63loudasset.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xb8\x01\n com.google.cloud.asset.v1p2beta1B\x11\x41ssetServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/asset/v1p2beta1;asset\xaa\x02\x1cGoogle.Cloud.Asset.V1p2Beta1\xca\x02\x1cGoogle\\Cloud\\Asset\\V1p2Beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_assets__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+_CONTENTTYPE = _descriptor.EnumDescriptor(
+    name="ContentType",
+    full_name="google.cloud.asset.v1p2beta1.ContentType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CONTENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESOURCE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IAM_POLICY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IAM_POLICY_NAME",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORG_POLICY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCESS_POLICY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2084,
+    serialized_end=2213,
+)
+_sym_db.RegisterEnumDescriptor(_CONTENTTYPE)
+
+ContentType = enum_type_wrapper.EnumTypeWrapper(_CONTENTTYPE)
+CONTENT_TYPE_UNSPECIFIED = 0
+RESOURCE = 1
+IAM_POLICY = 2
+IAM_POLICY_NAME = 3
+ORG_POLICY = 4
+ACCESS_POLICY = 5
+
+
+_EXPORTASSETSREQUEST = _descriptor.Descriptor(
+    name="ExportAssetsRequest",
+    full_name="google.cloud.asset.v1p2beta1.ExportAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsRequest.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_types",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsRequest.asset_types",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsRequest.content_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsRequest.output_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=326,
+    serialized_end=563,
+)
+
+
+_EXPORTASSETSRESPONSE = _descriptor.Descriptor(
+    name="ExportAssetsResponse",
+    full_name="google.cloud.asset.v1p2beta1.ExportAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsResponse.read_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.asset.v1p2beta1.ExportAssetsResponse.output_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=566,
+    serialized_end=702,
+)
+
+
+_BATCHGETASSETSHISTORYREQUEST = _descriptor.Descriptor(
+    name="BatchGetAssetsHistoryRequest",
+    full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_names",
+            full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest.asset_names",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest.content_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time_window",
+            full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest.read_time_window",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=705,
+    serialized_end=905,
+)
+
+
+_BATCHGETASSETSHISTORYRESPONSE = _descriptor.Descriptor(
+    name="BatchGetAssetsHistoryResponse",
+    full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="assets",
+            full_name="google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryResponse.assets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=907,
+    serialized_end=999,
+)
+
+
+_CREATEFEEDREQUEST = _descriptor.Descriptor(
+    name="CreateFeedRequest",
+    full_name="google.cloud.asset.v1p2beta1.CreateFeedRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1p2beta1.CreateFeedRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feed_id",
+            full_name="google.cloud.asset.v1p2beta1.CreateFeedRequest.feed_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feed",
+            full_name="google.cloud.asset.v1p2beta1.CreateFeedRequest.feed",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1001,
+    serialized_end=1103,
+)
+
+
+_GETFEEDREQUEST = _descriptor.Descriptor(
+    name="GetFeedRequest",
+    full_name="google.cloud.asset.v1p2beta1.GetFeedRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.asset.v1p2beta1.GetFeedRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1105,
+    serialized_end=1135,
+)
+
+
+_LISTFEEDSREQUEST = _descriptor.Descriptor(
+    name="ListFeedsRequest",
+    full_name="google.cloud.asset.v1p2beta1.ListFeedsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1p2beta1.ListFeedsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1137,
+    serialized_end=1171,
+)
+
+
+_LISTFEEDSRESPONSE = _descriptor.Descriptor(
+    name="ListFeedsResponse",
+    full_name="google.cloud.asset.v1p2beta1.ListFeedsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="feeds",
+            full_name="google.cloud.asset.v1p2beta1.ListFeedsResponse.feeds",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1173,
+    serialized_end=1243,
+)
+
+
+_UPDATEFEEDREQUEST = _descriptor.Descriptor(
+    name="UpdateFeedRequest",
+    full_name="google.cloud.asset.v1p2beta1.UpdateFeedRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="feed",
+            full_name="google.cloud.asset.v1p2beta1.UpdateFeedRequest.feed",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.asset.v1p2beta1.UpdateFeedRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1245,
+    serialized_end=1363,
+)
+
+
+_DELETEFEEDREQUEST = _descriptor.Descriptor(
+    name="DeleteFeedRequest",
+    full_name="google.cloud.asset.v1p2beta1.DeleteFeedRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.asset.v1p2beta1.DeleteFeedRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1365,
+    serialized_end=1398,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.asset.v1p2beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.asset.v1p2beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_destination",
+            full_name="google.cloud.asset.v1p2beta1.OutputConfig.bigquery_destination",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.asset.v1p2beta1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1401,
+    serialized_end=1586,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.asset.v1p2beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.asset.v1p2beta1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri_prefix",
+            full_name="google.cloud.asset.v1p2beta1.GcsDestination.uri_prefix",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="object_uri",
+            full_name="google.cloud.asset.v1p2beta1.GcsDestination.object_uri",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1588,
+    serialized_end=1655,
+)
+
+
+_BIGQUERYDESTINATION = _descriptor.Descriptor(
+    name="BigQueryDestination",
+    full_name="google.cloud.asset.v1p2beta1.BigQueryDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.asset.v1p2beta1.BigQueryDestination.dataset",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.cloud.asset.v1p2beta1.BigQueryDestination.table",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="force",
+            full_name="google.cloud.asset.v1p2beta1.BigQueryDestination.force",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1657,
+    serialized_end=1725,
+)
+
+
+_PUBSUBDESTINATION = _descriptor.Descriptor(
+    name="PubsubDestination",
+    full_name="google.cloud.asset.v1p2beta1.PubsubDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.cloud.asset.v1p2beta1.PubsubDestination.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1727,
+    serialized_end=1761,
+)
+
+
+_FEEDOUTPUTCONFIG = _descriptor.Descriptor(
+    name="FeedOutputConfig",
+    full_name="google.cloud.asset.v1p2beta1.FeedOutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pubsub_destination",
+            full_name="google.cloud.asset.v1p2beta1.FeedOutputConfig.pubsub_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.asset.v1p2beta1.FeedOutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1763,
+    serialized_end=1875,
+)
+
+
+_FEED = _descriptor.Descriptor(
+    name="Feed",
+    full_name="google.cloud.asset.v1p2beta1.Feed",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.asset.v1p2beta1.Feed.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_names",
+            full_name="google.cloud.asset.v1p2beta1.Feed.asset_names",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_types",
+            full_name="google.cloud.asset.v1p2beta1.Feed.asset_types",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.asset.v1p2beta1.Feed.content_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feed_output_config",
+            full_name="google.cloud.asset.v1p2beta1.Feed.feed_output_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1878,
+    serialized_end=2081,
+)
+
+_EXPORTASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTASSETSREQUEST.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_EXPORTASSETSREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_EXPORTASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTASSETSRESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_BATCHGETASSETSHISTORYREQUEST.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_BATCHGETASSETSHISTORYREQUEST.fields_by_name[
+    "read_time_window"
+].message_type = (
+    google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_assets__pb2._TIMEWINDOW
+)
+_BATCHGETASSETSHISTORYRESPONSE.fields_by_name[
+    "assets"
+].message_type = (
+    google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_assets__pb2._TEMPORALASSET
+)
+_CREATEFEEDREQUEST.fields_by_name["feed"].message_type = _FEED
+_LISTFEEDSRESPONSE.fields_by_name["feeds"].message_type = _FEED
+_UPDATEFEEDREQUEST.fields_by_name["feed"].message_type = _FEED
+_UPDATEFEEDREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.fields_by_name["bigquery_destination"].message_type = _BIGQUERYDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["bigquery_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "bigquery_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_GCSDESTINATION.oneofs_by_name["object_uri"].fields.append(
+    _GCSDESTINATION.fields_by_name["uri"]
+)
+_GCSDESTINATION.fields_by_name["uri"].containing_oneof = _GCSDESTINATION.oneofs_by_name[
+    "object_uri"
+]
+_GCSDESTINATION.oneofs_by_name["object_uri"].fields.append(
+    _GCSDESTINATION.fields_by_name["uri_prefix"]
+)
+_GCSDESTINATION.fields_by_name[
+    "uri_prefix"
+].containing_oneof = _GCSDESTINATION.oneofs_by_name["object_uri"]
+_FEEDOUTPUTCONFIG.fields_by_name["pubsub_destination"].message_type = _PUBSUBDESTINATION
+_FEEDOUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _FEEDOUTPUTCONFIG.fields_by_name["pubsub_destination"]
+)
+_FEEDOUTPUTCONFIG.fields_by_name[
+    "pubsub_destination"
+].containing_oneof = _FEEDOUTPUTCONFIG.oneofs_by_name["destination"]
+_FEED.fields_by_name["content_type"].enum_type = _CONTENTTYPE
+_FEED.fields_by_name["feed_output_config"].message_type = _FEEDOUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["ExportAssetsRequest"] = _EXPORTASSETSREQUEST
+DESCRIPTOR.message_types_by_name["ExportAssetsResponse"] = _EXPORTASSETSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchGetAssetsHistoryRequest"
+] = _BATCHGETASSETSHISTORYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchGetAssetsHistoryResponse"
+] = _BATCHGETASSETSHISTORYRESPONSE
+DESCRIPTOR.message_types_by_name["CreateFeedRequest"] = _CREATEFEEDREQUEST
+DESCRIPTOR.message_types_by_name["GetFeedRequest"] = _GETFEEDREQUEST
+DESCRIPTOR.message_types_by_name["ListFeedsRequest"] = _LISTFEEDSREQUEST
+DESCRIPTOR.message_types_by_name["ListFeedsResponse"] = _LISTFEEDSRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateFeedRequest"] = _UPDATEFEEDREQUEST
+DESCRIPTOR.message_types_by_name["DeleteFeedRequest"] = _DELETEFEEDREQUEST
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["BigQueryDestination"] = _BIGQUERYDESTINATION
+DESCRIPTOR.message_types_by_name["PubsubDestination"] = _PUBSUBDESTINATION
+DESCRIPTOR.message_types_by_name["FeedOutputConfig"] = _FEEDOUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["Feed"] = _FEED
+DESCRIPTOR.enum_types_by_name["ContentType"] = _CONTENTTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ExportAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTASSETSREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Export asset request.
+  
+  
+  Attributes:
+      parent:
+          Required. The relative name of the root asset. This 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").
+      read_time:
+          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.
+      asset_types:
+          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>`__ for all
+          supported asset types.
+      content_type:
+          Asset content type. If not specified, no content but the asset
+          name will be returned.
+      output_config:
+          Required. Output configuration indicating where the results
+          will be output to. All results will be in newline delimited
+          JSON format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.ExportAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportAssetsRequest)
+
+ExportAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ExportAssetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTASSETSRESPONSE,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      read_time:
+          Time the snapshot was taken.
+      output_config:
+          Output configuration indicating where the results were output
+          to. All results are in JSON format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.ExportAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ExportAssetsResponse)
+
+BatchGetAssetsHistoryRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchGetAssetsHistoryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETASSETSHISTORYREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Batch get assets history request.
+  
+  
+  Attributes:
+      parent:
+          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").
+      asset_names:
+          A list of the full names of the assets. For example: ``//compu
+          te.googleapis.com/projects/my_project_123/zones/zone1/instance
+          s/instance1``. See `Resource Names <https://cloud.google.com/a
+          pis/design/resource_names#full_resource_name>`__ and `Resource
+          Name Format <https://cloud.google.com/resource-
+          manager/docs/cloud-asset-inventory/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.
+      content_type:
+          Required. The content type.
+      read_time_window:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetAssetsHistoryRequest)
+
+BatchGetAssetsHistoryResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchGetAssetsHistoryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETASSETSHISTORYRESPONSE,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Batch get assets history response.
+  
+  
+  Attributes:
+      assets:
+          A list of assets with valid time windows.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.BatchGetAssetsHistoryResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetAssetsHistoryResponse)
+
+CreateFeedRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateFeedRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEFEEDREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Create asset feed request.
+  
+  
+  Attributes:
+      parent:
+          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").
+      feed_id:
+          Required. This is the client-assigned asset feed identifier
+          and it needs to be unique under a specific parent
+          project/folder/organization.
+      feed:
+          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
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.CreateFeedRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateFeedRequest)
+
+GetFeedRequest = _reflection.GeneratedProtocolMessageType(
+    "GetFeedRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETFEEDREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Get asset feed request.
+  
+  
+  Attributes:
+      name:
+          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
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.GetFeedRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetFeedRequest)
+
+ListFeedsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFeedsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFEEDSREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""List asset feeds request.
+  
+  
+  Attributes:
+      parent:
+          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").
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.ListFeedsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFeedsRequest)
+
+ListFeedsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFeedsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFEEDSRESPONSE,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""List asset feeds response.
+  
+  
+  Attributes:
+      feeds:
+          A list of feeds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.ListFeedsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFeedsResponse)
+
+UpdateFeedRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateFeedRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEFEEDREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Update asset feed request.
+  
+  
+  Attributes:
+      feed:
+          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.
+      update_mask:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.UpdateFeedRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateFeedRequest)
+
+DeleteFeedRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteFeedRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEFEEDREQUEST,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Delete asset feed request.
+  
+  
+  Attributes:
+      name:
+          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
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.DeleteFeedRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteFeedRequest)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Output configuration for export assets destination.
+  
+  
+  Attributes:
+      destination:
+          Asset export destination.
+      gcs_destination:
+          Destination on Cloud Storage.
+      bigquery_destination:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""A Cloud Storage location.
+  
+  
+  Attributes:
+      object_uri:
+          Required.
+      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.
+      uri_prefix:
+          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.googl
+          eapis.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+BigQueryDestination = _reflection.GeneratedProtocolMessageType(
+    "BigQueryDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYDESTINATION,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""A Bigquery destination.
+  
+  
+  Attributes:
+      dataset:
+          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 error.
+      table:
+          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.
+      force:
+          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 not set and the destination
+          table already exists, the export call returns an error.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.BigQueryDestination)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryDestination)
+
+PubsubDestination = _reflection.GeneratedProtocolMessageType(
+    "PubsubDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBSUBDESTINATION,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""A Cloud Pubsub destination.
+  
+  
+  Attributes:
+      topic:
+          The name of the Cloud Pub/Sub topic to publish to. For
+          example: ``projects/PROJECT_ID/topics/TOPIC_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.PubsubDestination)
+    ),
+)
+_sym_db.RegisterMessage(PubsubDestination)
+
+FeedOutputConfig = _reflection.GeneratedProtocolMessageType(
+    "FeedOutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEEDOUTPUTCONFIG,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""Output configuration for asset feed destination.
+  
+  
+  Attributes:
+      destination:
+          Asset feed destination.
+      pubsub_destination:
+          Destination on Cloud Pubsub.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.FeedOutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(FeedOutputConfig)
+
+Feed = _reflection.GeneratedProtocolMessageType(
+    "Feed",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEED,
+        __module__="google.cloud.asset_v1p2beta1.proto.asset_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          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.
+      asset_names:
+          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: ``//comput
+          e.googleapis.com/projects/my_project_123/zones/zone1/instances
+          /instance1``. See `Resource Names <https://cloud.google.com/ap
+          is/design/resource_names#full_resource_name>`__ for more info.
+      asset_types:
+          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.
+      content_type:
+          Asset content type. If not specified, no content but the asset
+          name and type will be returned.
+      feed_output_config:
+          Required. Feed output configuration defining where the asset
+          updates are published to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.Feed)
+    ),
+)
+_sym_db.RegisterMessage(Feed)
+
+
+DESCRIPTOR._options = None
+
+_ASSETSERVICE = _descriptor.ServiceDescriptor(
+    name="AssetService",
+    full_name="google.cloud.asset.v1p2beta1.AssetService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\031cloudasset.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=2216,
+    serialized_end=3357,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ExportAssets",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.ExportAssets",
+            index=0,
+            containing_service=None,
+            input_type=_EXPORTASSETSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v1p2beta1/{parent=*/*}:exportAssets:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchGetAssetsHistory",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.BatchGetAssetsHistory",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHGETASSETSHISTORYREQUEST,
+            output_type=_BATCHGETASSETSHISTORYRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1p2beta1/{parent=*/*}:batchGetAssetsHistory"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateFeed",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.CreateFeed",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEFEEDREQUEST,
+            output_type=_FEED,
+            serialized_options=_b(
+                '\202\323\344\223\002""\035/v1p2beta1/{parent=*/*}/feeds:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetFeed",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.GetFeed",
+            index=3,
+            containing_service=None,
+            input_type=_GETFEEDREQUEST,
+            output_type=_FEED,
+            serialized_options=_b(
+                "\202\323\344\223\002\037\022\035/v1p2beta1/{name=*/*/feeds/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFeeds",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.ListFeeds",
+            index=4,
+            containing_service=None,
+            input_type=_LISTFEEDSREQUEST,
+            output_type=_LISTFEEDSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\037\022\035/v1p2beta1/{parent=*/*}/feeds"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateFeed",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.UpdateFeed",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATEFEEDREQUEST,
+            output_type=_FEED,
+            serialized_options=_b(
+                "\202\323\344\223\002'2\"/v1p2beta1/{feed.name=*/*/feeds/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteFeed",
+            full_name="google.cloud.asset.v1p2beta1.AssetService.DeleteFeed",
+            index=6,
+            containing_service=None,
+            input_type=_DELETEFEEDREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\037*\035/v1p2beta1/{name=*/*/feeds/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_ASSETSERVICE)
+
+DESCRIPTOR.services_by_name["AssetService"] = _ASSETSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/asset_service_pb2_grpc.py b/asset/google/cloud/asset_v1p2beta1/proto/asset_service_pb2_grpc.py
new file mode 100644
index 000000000000..05ec4e44be0f
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/proto/asset_service_pb2_grpc.py
@@ -0,0 +1,163 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.asset_v1p2beta1.proto import (
+    asset_service_pb2 as google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class AssetServiceStub(object):
+    """Asset service definition.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ExportAssets = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/ExportAssets",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.ExportAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.BatchGetAssetsHistory = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/BatchGetAssetsHistory",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryResponse.FromString,
+        )
+        self.CreateFeed = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/CreateFeed",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.CreateFeedRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.Feed.FromString,
+        )
+        self.GetFeed = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/GetFeed",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.GetFeedRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.Feed.FromString,
+        )
+        self.ListFeeds = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/ListFeeds",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.ListFeedsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.ListFeedsResponse.FromString,
+        )
+        self.UpdateFeed = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/UpdateFeed",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.UpdateFeedRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.Feed.FromString,
+        )
+        self.DeleteFeed = channel.unary_unary(
+            "/google.cloud.asset.v1p2beta1.AssetService/DeleteFeed",
+            request_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.DeleteFeedRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class AssetServiceServicer(object):
+    """Asset service definition.
+  """
+
+    def ExportAssets(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchGetAssetsHistory(self, request, context):
+        """Batch gets the update history of assets that overlap a time window.
+    For RESOURCE content, this API outputs history with asset in both
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateFeed(self, request, context):
+        """Creates a feed in a parent project/folder/organization to listen to its
+    asset updates.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetFeed(self, request, context):
+        """Gets details about an asset feed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFeeds(self, request, context):
+        """Lists all asset feeds in a parent project/folder/organization.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateFeed(self, request, context):
+        """Updates an asset feed configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteFeed(self, request, context):
+        """Deletes an asset feed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_AssetServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ExportAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportAssets,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.ExportAssetsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "BatchGetAssetsHistory": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchGetAssetsHistory,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.BatchGetAssetsHistoryResponse.SerializeToString,
+        ),
+        "CreateFeed": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateFeed,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.CreateFeedRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.Feed.SerializeToString,
+        ),
+        "GetFeed": grpc.unary_unary_rpc_method_handler(
+            servicer.GetFeed,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.GetFeedRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.Feed.SerializeToString,
+        ),
+        "ListFeeds": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFeeds,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.ListFeedsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.ListFeedsResponse.SerializeToString,
+        ),
+        "UpdateFeed": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateFeed,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.UpdateFeedRequest.FromString,
+            response_serializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.Feed.SerializeToString,
+        ),
+        "DeleteFeed": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteFeed,
+            request_deserializer=google_dot_cloud_dot_asset__v1p2beta1_dot_proto_dot_asset__service__pb2.DeleteFeedRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.asset.v1p2beta1.AssetService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/assets.proto b/asset/google/cloud/asset_v1p2beta1/proto/assets.proto
new file mode 100644
index 000000000000..a9cda898a357
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/proto/assets.proto
@@ -0,0 +1,135 @@
+// 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;
+
+  // Cloud IAM policy name of the Cloud IAM policy set on a cloud resource. For
+  // each resource, there must be at most one Cloud IAM policy name associated
+  // with it.
+  bytes iam_policy_name = 5;
+
+  // 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 ending at a visible 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;
+
+  // The actual metadata content for the resource, only visible for internal
+  // users.
+  google.protobuf.Any internal_data = 7;
+}
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/assets_pb2.py b/asset/google/cloud/asset_v1p2beta1/proto/assets_pb2.py
new file mode 100644
index 000000000000..0e086f63c197
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/proto/assets_pb2.py
@@ -0,0 +1,616 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset_v1p2beta1/proto/assets.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/asset_v1p2beta1/proto/assets.proto",
+    package="google.cloud.asset.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n com.google.cloud.asset.v1p2beta1B\nAssetProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/asset/v1p2beta1;asset\370\001\001\252\002\034Google.Cloud.Asset.v1p2beta1\312\002\034Google\\Cloud\\Asset\\v1p2beta1"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/asset_v1p2beta1/proto/assets.proto\x12\x1cgoogle.cloud.asset.v1p2beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x19google/protobuf/any.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x8e\x01\n\rTemporalAsset\x12\x38\n\x06window\x18\x01 \x01(\x0b\x32(.google.cloud.asset.v1p2beta1.TimeWindow\x12\x0f\n\x07\x64\x65leted\x18\x02 \x01(\x08\x12\x32\n\x05\x61sset\x18\x03 \x01(\x0b\x32#.google.cloud.asset.v1p2beta1.Asset"j\n\nTimeWindow\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xba\x01\n\x05\x41sset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nasset_type\x18\x02 \x01(\t\x12\x38\n\x08resource\x18\x03 \x01(\x0b\x32&.google.cloud.asset.v1p2beta1.Resource\x12)\n\niam_policy\x18\x04 \x01(\x0b\x32\x15.google.iam.v1.Policy\x12\x17\n\x0fiam_policy_name\x18\x05 \x01(\x0c\x12\x11\n\tancestors\x18\x06 \x03(\t"\xcd\x01\n\x08Resource\x12\x0f\n\x07version\x18\x01 \x01(\t\x12\x1e\n\x16\x64iscovery_document_uri\x18\x02 \x01(\t\x12\x16\n\x0e\x64iscovery_name\x18\x03 \x01(\t\x12\x14\n\x0cresource_url\x18\x04 \x01(\t\x12\x0e\n\x06parent\x18\x05 \x01(\t\x12%\n\x04\x64\x61ta\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12+\n\rinternal_data\x18\x07 \x01(\x0b\x32\x14.google.protobuf.AnyB\xb4\x01\n com.google.cloud.asset.v1p2beta1B\nAssetProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/asset/v1p2beta1;asset\xf8\x01\x01\xaa\x02\x1cGoogle.Cloud.Asset.v1p2beta1\xca\x02\x1cGoogle\\Cloud\\Asset\\v1p2beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEMPORALASSET = _descriptor.Descriptor(
+    name="TemporalAsset",
+    full_name="google.cloud.asset.v1p2beta1.TemporalAsset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="window",
+            full_name="google.cloud.asset.v1p2beta1.TemporalAsset.window",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deleted",
+            full_name="google.cloud.asset.v1p2beta1.TemporalAsset.deleted",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset",
+            full_name="google.cloud.asset.v1p2beta1.TemporalAsset.asset",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=230,
+    serialized_end=372,
+)
+
+
+_TIMEWINDOW = _descriptor.Descriptor(
+    name="TimeWindow",
+    full_name="google.cloud.asset.v1p2beta1.TimeWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.asset.v1p2beta1.TimeWindow.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.asset.v1p2beta1.TimeWindow.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=374,
+    serialized_end=480,
+)
+
+
+_ASSET = _descriptor.Descriptor(
+    name="Asset",
+    full_name="google.cloud.asset.v1p2beta1.Asset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.asset.v1p2beta1.Asset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_type",
+            full_name="google.cloud.asset.v1p2beta1.Asset.asset_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource",
+            full_name="google.cloud.asset.v1p2beta1.Asset.resource",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="iam_policy",
+            full_name="google.cloud.asset.v1p2beta1.Asset.iam_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="iam_policy_name",
+            full_name="google.cloud.asset.v1p2beta1.Asset.iam_policy_name",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ancestors",
+            full_name="google.cloud.asset.v1p2beta1.Asset.ancestors",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=483,
+    serialized_end=669,
+)
+
+
+_RESOURCE = _descriptor.Descriptor(
+    name="Resource",
+    full_name="google.cloud.asset.v1p2beta1.Resource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.asset.v1p2beta1.Resource.version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery_document_uri",
+            full_name="google.cloud.asset.v1p2beta1.Resource.discovery_document_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery_name",
+            full_name="google.cloud.asset.v1p2beta1.Resource.discovery_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_url",
+            full_name="google.cloud.asset.v1p2beta1.Resource.resource_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.asset.v1p2beta1.Resource.parent",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.cloud.asset.v1p2beta1.Resource.data",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="internal_data",
+            full_name="google.cloud.asset.v1p2beta1.Resource.internal_data",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=672,
+    serialized_end=877,
+)
+
+_TEMPORALASSET.fields_by_name["window"].message_type = _TIMEWINDOW
+_TEMPORALASSET.fields_by_name["asset"].message_type = _ASSET
+_TIMEWINDOW.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEWINDOW.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ASSET.fields_by_name["resource"].message_type = _RESOURCE
+_ASSET.fields_by_name[
+    "iam_policy"
+].message_type = (
+    google_dot_iam_dot_v1_dot_policy__pb2.google_dot_iam_dot_v1_dot_policy__pb2._POLICY
+)
+_RESOURCE.fields_by_name[
+    "data"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_RESOURCE.fields_by_name[
+    "internal_data"
+].message_type = google_dot_protobuf_dot_any__pb2._ANY
+DESCRIPTOR.message_types_by_name["TemporalAsset"] = _TEMPORALASSET
+DESCRIPTOR.message_types_by_name["TimeWindow"] = _TIMEWINDOW
+DESCRIPTOR.message_types_by_name["Asset"] = _ASSET
+DESCRIPTOR.message_types_by_name["Resource"] = _RESOURCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TemporalAsset = _reflection.GeneratedProtocolMessageType(
+    "TemporalAsset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEMPORALASSET,
+        __module__="google.cloud.asset_v1p2beta1.proto.assets_pb2",
+        __doc__="""Temporal asset. In addition to the asset, the temporal asset includes
+  the status of the asset and valid from and to time of it.
+  
+  
+  Attributes:
+      window:
+          The time window when the asset data and state was observed.
+      deleted:
+          If the asset is deleted or not.
+      asset:
+          Asset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.TemporalAsset)
+    ),
+)
+_sym_db.RegisterMessage(TemporalAsset)
+
+TimeWindow = _reflection.GeneratedProtocolMessageType(
+    "TimeWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEWINDOW,
+        __module__="google.cloud.asset_v1p2beta1.proto.assets_pb2",
+        __doc__="""A time window of (start\_time, end\_time].
+  
+  
+  Attributes:
+      start_time:
+          Start time of the time window (exclusive).
+      end_time:
+          End time of the time window (inclusive). Current timestamp if
+          not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.TimeWindow)
+    ),
+)
+_sym_db.RegisterMessage(TimeWindow)
+
+Asset = _reflection.GeneratedProtocolMessageType(
+    "Asset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASSET,
+        __module__="google.cloud.asset_v1p2beta1.proto.assets_pb2",
+        __doc__="""Cloud asset. This includes all Google Cloud Platform resources, Cloud
+  IAM policies, and other non-GCP assets.
+  
+  
+  Attributes:
+      name:
+
+          The full name of the asset. For example:
+          ``//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1``.
+          See https://cloud.google.com/apis/design/resource_names#full_resource_name
+          for more information.
+      asset_type:
+          Type of the asset. Example: "compute.googleapis.com/Disk".
+      resource:
+          Representation of the resource.
+      iam_policy:
+          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.
+      iam_policy_name:
+          Cloud IAM policy name of the Cloud IAM policy set on a cloud
+          resource. For each resource, there must be at most one Cloud
+          IAM policy name associated with it.
+      ancestors:
+          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 ending
+          at a visible root. If the asset is a CRM project/
+          folder/organization, this starts from the asset itself.
+          Example: ["projects/123456789", "folders/5432",
+          "organizations/1234"]
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.Asset)
+    ),
+)
+_sym_db.RegisterMessage(Asset)
+
+Resource = _reflection.GeneratedProtocolMessageType(
+    "Resource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESOURCE,
+        __module__="google.cloud.asset_v1p2beta1.proto.assets_pb2",
+        __doc__="""Representation of a cloud resource.
+  
+  
+  Attributes:
+      version:
+          The API version. Example: "v1".
+      discovery_document_uri:
+          The URL of the discovery document containing the resource's
+          JSON schema. For example: ``"https://www.googleapis.com/discov
+          ery/v1/apis/compute/v1/rest"``. It will be left unspecified
+          for resources without a discovery-based API, such as Cloud
+          Bigtable.
+      discovery_name:
+          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.
+      resource_url:
+          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.
+      parent:
+          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#p
+          olicy_hierarchy>`__. For example: ``"//cloudresourcemanager.go
+          ogleapis.com/projects/my_project_123"``.  For third-party
+          assets, it is up to the users to define.
+      data:
+          The content of the resource, in which some sensitive fields
+          are scrubbed away and may not be present.
+      internal_data:
+          The actual metadata content for the resource, only visible for
+          internal users.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.asset.v1p2beta1.Resource)
+    ),
+)
+_sym_db.RegisterMessage(Resource)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/asset/google/cloud/asset_v1p2beta1/proto/assets_pb2_grpc.py b/asset/google/cloud/asset_v1p2beta1/proto/assets_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/proto/assets_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/asset/google/cloud/asset_v1p2beta1/types.py b/asset/google/cloud/asset_v1p2beta1/types.py
new file mode 100644
index 000000000000..adaff8cd6862
--- /dev/null
+++ b/asset/google/cloud/asset_v1p2beta1/types.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.asset_v1p2beta1.proto import asset_service_pb2
+from google.cloud.asset_v1p2beta1.proto import assets_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    policy_pb2,
+    operations_pb2,
+    any_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [asset_service_pb2, assets_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.asset_v1p2beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/asset/noxfile.py b/asset/noxfile.py
new file mode 100644
index 000000000000..393f4b64a33c
--- /dev/null
+++ b/asset/noxfile.py
@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Additional setup for VPCSC system tests
+    env = {
+        "PROJECT_ID": os.environ.get("PROJECT_ID"),
+        "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT": "secure-gcp-test-project-4",
+        "GOOGLE_CLOUD_TESTS_IN_VPCSC": "true",
+    }
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, env=env, *session.posargs)
+    if system_test_folder_exists:
+        session.run(
+            "py.test", "--quiet", system_test_folder_path, env=env, *session.posargs
+        )
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=80")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/asset/setup.cfg b/asset/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/asset/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/asset/setup.py b/asset/setup.py
new file mode 100644
index 000000000000..a70843c8e1de
--- /dev/null
+++ b/asset/setup.py
@@ -0,0 +1,85 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+# Package metadata.
+
+name = "google-cloud-asset"
+description = "Cloud Asset API API client library"
+version = "0.4.1"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+]
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/asset/synth.metadata b/asset/synth.metadata
new file mode 100644
index 000000000000..2a27fdfa4cf0
--- /dev/null
+++ b/asset/synth.metadata
@@ -0,0 +1,59 @@
+{
+  "updateTime": "2019-08-06T12:11:34.528326Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "asset",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/asset/artman_cloudasset_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "asset",
+        "apiVersion": "v1p2beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/asset/artman_cloudasset_v1p2beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "asset",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/asset/artman_cloudasset_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/asset/synth.py b/asset/synth.py
new file mode 100644
index 000000000000..9f4498bdbb58
--- /dev/null
+++ b/asset/synth.py
@@ -0,0 +1,89 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1", "v1p2beta1", "v1"]
+
+excludes = ["setup.py", "nox*.py", "README.rst", "docs/conf.py", "docs/index.rst"]
+
+# ----------------------------------------------------------------------------
+# Generate asset GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library(
+        "asset",
+        version,
+        config_path=f"/google/cloud/asset/artman_cloudasset_{version}.yaml",
+        artman_output_name=f"asset-{version}",
+        include_protos=True,
+    )
+
+    s.move(library, excludes=excludes)
+
+s.replace(
+    "google/cloud/asset_v*/proto/assets_pb2.py",
+    "from google.iam.v1 import policy_pb2 as",
+    "from google.iam.v1 import iam_policy_pb2_grpc as",
+)
+
+s.replace(
+    "google/cloud/asset_v*/proto/assets_pb2.py",
+    "from google.iam.v1 import iam_policy_pb2_grpc "
+    "as google_dot_iam_dot_v1_dot_policy__pb2",
+    "from google.iam.v1 import iam_policy_pb2 "
+    "as google_dot_iam_dot_v1_dot_policy__pb2",
+)
+
+s.replace(
+    "google/cloud/asset_v*/proto/assets_pb2.py",
+    "_ASSET.fields_by_name\['iam_policy'\].message_type "
+    "= google_dot_iam_dot_v1_dot_policy__pb2._POLICY",
+    "_ASSET.fields_by_name['iam_policy'].message_type = google_dot_iam_dot"
+    "_v1_dot_policy__pb2.google_dot_iam_dot_v1_dot_policy__pb2._POLICY",
+)
+
+
+_BORKED_ASSET_DOCSTRING = """\
+          The full name of the asset. For example: ``//compute.googleapi
+          s.com/projects/my_project_123/zones/zone1/instances/instance1`
+          `. See `Resource Names <https://cloud.google.com/apis/design/r
+          esource_names#full_resource_name>`__ for more information.
+"""
+
+_FIXED_ASSET_DOCSTRING = """
+          The full name of the asset. For example:
+          ``//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1``.
+          See https://cloud.google.com/apis/design/resource_names#full_resource_name
+          for more information.
+"""
+
+s.replace(
+    "google/cloud/asset_v*/proto/assets_pb2.py",
+    _BORKED_ASSET_DOCSTRING,
+    _FIXED_ASSET_DOCSTRING,
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = gcp.CommonTemplates().py_library(unit_cov_level=79, cov_level=80)
+s.move(templated_files, excludes=["noxfile.py"])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/asset/tests/system/test_vpcsc.py b/asset/tests/system/test_vpcsc.py
new file mode 100644
index 000000000000..e3336bfe4f4f
--- /dev/null
+++ b/asset/tests/system/test_vpcsc.py
@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# flake8: noqa
+
+import os
+import pytest
+
+from google.api_core import exceptions
+from google.cloud import asset_v1
+from google.cloud.asset_v1 import enums
+
+PROJECT_INSIDE = os.environ.get("PROJECT_ID", None)
+PROJECT_OUTSIDE = os.environ.get(
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT", None
+)
+IS_INSIDE_VPCSC = os.environ.get("GOOGLE_CLOUD_TESTS_IN_VPCSC", "true")
+
+
+class TestVPCServiceControl(object):
+    @staticmethod
+    def _is_rejected(call):
+        try:
+            responses = call()
+        except exceptions.PermissionDenied as e:
+            return e.message == "Request is prohibited by organization's policy"
+        except:
+            pass
+        return False
+
+    @staticmethod
+    def _do_test(delayed_inside, delayed_outside):
+        if IS_INSIDE_VPCSC.lower() == "true":
+            assert TestVPCServiceControl._is_rejected(delayed_outside)
+            assert not (TestVPCServiceControl._is_rejected(delayed_inside))
+        else:
+            assert not (TestVPCServiceControl._is_rejected(delayed_outside))
+            assert TestVPCServiceControl._is_rejected(delayed_inside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_export_assets(self):
+        client = asset_v1.AssetServiceClient()
+        output_config = {}
+        parent_inside = "projects/" + PROJECT_INSIDE
+        delayed_inside = lambda: client.export_assets(parent_inside, output_config)
+        parent_outside = "projects/" + PROJECT_OUTSIDE
+        delayed_outside = lambda: client.export_assets(parent_outside, output_config)
+        TestVPCServiceControl._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_batch_get_assets_history(self):
+        client = asset_v1.AssetServiceClient()
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+        read_time_window = {}
+        parent_inside = "projects/" + PROJECT_INSIDE
+        delayed_inside = lambda: client.batch_get_assets_history(
+            parent_inside, content_type, read_time_window
+        )
+        parent_outside = "projects/" + PROJECT_OUTSIDE
+        delayed_outside = lambda: client.batch_get_assets_history(
+            parent_outside, content_type, read_time_window
+        )
+        TestVPCServiceControl._do_test(delayed_inside, delayed_outside)
diff --git a/asset/tests/unit/gapic/v1/test_asset_service_client_v1.py b/asset/tests/unit/gapic/v1/test_asset_service_client_v1.py
new file mode 100644
index 000000000000..0afe1cf92033
--- /dev/null
+++ b/asset/tests/unit/gapic/v1/test_asset_service_client_v1.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import asset_v1
+from google.cloud.asset_v1 import enums
+from google.cloud.asset_v1.proto import asset_service_pb2
+from google.cloud.asset_v1.proto import assets_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestAssetServiceClient(object):
+    def test_export_assets(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.ExportAssetsResponse(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_assets", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        output_config = {}
+
+        response = client.export_assets(parent, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.ExportAssetsRequest(
+            parent=parent, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_assets_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_assets_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        output_config = {}
+
+        response = client.export_assets(parent, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_batch_get_assets_history(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.BatchGetAssetsHistoryResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+        read_time_window = {}
+
+        response = client.batch_get_assets_history(
+            parent, content_type, read_time_window
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.BatchGetAssetsHistoryRequest(
+            parent=parent, content_type=content_type, read_time_window=read_time_window
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_get_assets_history_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1.AssetServiceClient()
+
+        # Setup request
+        parent = "parent-995424086"
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+        read_time_window = {}
+
+        with pytest.raises(CustomException):
+            client.batch_get_assets_history(parent, content_type, read_time_window)
diff --git a/asset/tests/unit/gapic/v1beta1/test_asset_service_client_v1beta1.py b/asset/tests/unit/gapic/v1beta1/test_asset_service_client_v1beta1.py
new file mode 100644
index 000000000000..7ade3e8d5402
--- /dev/null
+++ b/asset/tests/unit/gapic/v1beta1/test_asset_service_client_v1beta1.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import asset_v1beta1
+from google.cloud.asset_v1beta1 import enums
+from google.cloud.asset_v1beta1.proto import asset_service_pb2
+from google.cloud.asset_v1beta1.proto import assets_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestAssetServiceClient(object):
+    def test_export_assets(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.ExportAssetsResponse(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_assets", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        output_config = {}
+
+        response = client.export_assets(parent, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.ExportAssetsRequest(
+            parent=parent, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_assets_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_assets_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        output_config = {}
+
+        response = client.export_assets(parent, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_batch_get_assets_history(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.BatchGetAssetsHistoryResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+        read_time_window = {}
+
+        response = client.batch_get_assets_history(
+            parent, content_type, read_time_window
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.BatchGetAssetsHistoryRequest(
+            parent=parent, content_type=content_type, read_time_window=read_time_window
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_get_assets_history_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1beta1.AssetServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+        read_time_window = {}
+
+        with pytest.raises(CustomException):
+            client.batch_get_assets_history(parent, content_type, read_time_window)
diff --git a/asset/tests/unit/gapic/v1p2beta1/test_asset_service_client_v1p2beta1.py b/asset/tests/unit/gapic/v1p2beta1/test_asset_service_client_v1p2beta1.py
new file mode 100644
index 000000000000..b893a5d278af
--- /dev/null
+++ b/asset/tests/unit/gapic/v1p2beta1/test_asset_service_client_v1p2beta1.py
@@ -0,0 +1,358 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import asset_v1p2beta1
+from google.cloud.asset_v1p2beta1 import enums
+from google.cloud.asset_v1p2beta1.proto import asset_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestAssetServiceClient(object):
+    def test_export_assets(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.ExportAssetsResponse(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_assets", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        output_config = {}
+
+        response = client.export_assets(parent, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.ExportAssetsRequest(
+            parent=parent, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_assets_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_assets_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        output_config = {}
+
+        response = client.export_assets(parent, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_batch_get_assets_history(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.BatchGetAssetsHistoryResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        asset_names = []
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+
+        response = client.batch_get_assets_history(parent, asset_names, content_type)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.BatchGetAssetsHistoryRequest(
+            parent=parent, asset_names=asset_names, content_type=content_type
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_get_assets_history_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup request
+        parent = "parent-995424086"
+        asset_names = []
+        content_type = enums.ContentType.CONTENT_TYPE_UNSPECIFIED
+
+        with pytest.raises(CustomException):
+            client.batch_get_assets_history(parent, asset_names, content_type)
+
+    def test_create_feed(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = asset_service_pb2.Feed(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+        feed_id = "feedId-976011428"
+        feed = {}
+
+        response = client.create_feed(parent, feed_id, feed)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.CreateFeedRequest(
+            parent=parent, feed_id=feed_id, feed=feed
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_feed_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup request
+        parent = "parent-995424086"
+        feed_id = "feedId-976011428"
+        feed = {}
+
+        with pytest.raises(CustomException):
+            client.create_feed(parent, feed_id, feed)
+
+    def test_get_feed(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = asset_service_pb2.Feed(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        name = client.feed_path("[PROJECT]", "[FEED]")
+
+        response = client.get_feed(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.GetFeedRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_feed_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup request
+        name = client.feed_path("[PROJECT]", "[FEED]")
+
+        with pytest.raises(CustomException):
+            client.get_feed(name)
+
+    def test_list_feeds(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = asset_service_pb2.ListFeedsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+
+        response = client.list_feeds(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.ListFeedsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_feeds_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup request
+        parent = "parent-995424086"
+
+        with pytest.raises(CustomException):
+            client.list_feeds(parent)
+
+    def test_update_feed(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = asset_service_pb2.Feed(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        feed = {}
+        update_mask = {}
+
+        response = client.update_feed(feed, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.UpdateFeedRequest(
+            feed=feed, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_feed_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup request
+        feed = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_feed(feed, update_mask)
+
+    def test_delete_feed(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup Request
+        name = client.feed_path("[PROJECT]", "[FEED]")
+
+        client.delete_feed(name)
+
+        assert len(channel.requests) == 1
+        expected_request = asset_service_pb2.DeleteFeedRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_feed_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = asset_v1p2beta1.AssetServiceClient()
+
+        # Setup request
+        name = client.feed_path("[PROJECT]", "[FEED]")
+
+        with pytest.raises(CustomException):
+            client.delete_feed(name)
diff --git a/automl/.coveragerc b/automl/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/automl/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/automl/.flake8 b/automl/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/automl/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/automl/.repo-metadata.json b/automl/.repo-metadata.json
new file mode 100644
index 000000000000..6d94acb2d745
--- /dev/null
+++ b/automl/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "automl",
+  "name_pretty": "Cloud AutoML",
+  "product_documentation": "https://cloud.google.com/automl/docs/",
+  "client_documentation": "https://googleapis.dev/python/automl/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559744",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-automl",
+  "api_id": "automl.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/automl/CHANGELOG.md b/automl/CHANGELOG.md
new file mode 100644
index 000000000000..e991a616462e
--- /dev/null
+++ b/automl/CHANGELOG.md
@@ -0,0 +1,139 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-automl/#history
+
+## 0.5.0
+
+08-28-2019 14:07 PDT
+
+### Implementation Changes
+- Catch exceptions in GcsClient when a same name bucket already exists in a different project ([#9139](https://github.com/googleapis/google-cloud-python/pull/9139))
+- Log when LROs are kicked off. ([#9058](https://github.com/googleapis/google-cloud-python/pull/9058))
+- Throw a ValueError when an ambiguous display_name is used ([#9089](https://github.com/googleapis/google-cloud-python/pull/9089))
+- Remove send/recv msg size limit (via synth). ([#8944](https://github.com/googleapis/google-cloud-python/pull/8944))
+
+### New Features
+- Enable users to pass in Pandas Dataframe when calling import_data() and batch_predict() from AutoML Tables client ([#9116](https://github.com/googleapis/google-cloud-python/pull/9116))
+- Add support for documents (via synth). ([#9039](https://github.com/googleapis/google-cloud-python/pull/9039))
+- Add a TablesClient for automl-tables specific behavior. ([#8720](https://github.com/googleapis/google-cloud-python/pull/8720))
+- Add 'ClassificationEvaluationMetrics.display_name'/'BatchPredictResult.metadata'/'TableSpec.valid_row_count' (via synth) ([#9004](https://github.com/googleapis/google-cloud-python/pull/9004))
+
+### Documentation
+- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035))
+
+### Internal / Testing Changes
+- Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085))
+- Skip relevant system tests if in VPCSC ([#9111](https://github.com/googleapis/google-cloud-python/pull/9111))
+- Fix synth replace to add TablesClient. ([#9033](https://github.com/googleapis/google-cloud-python/pull/9033))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.4.0
+
+07-22-2019 17:39 PDT
+
+
+### New Features
+- Add support for 'TablesModelMetadata.{optimization_objective_recall_value,optimization_objective_precision_value}' (via synth). ([#8643](https://github.com/googleapis/google-cloud-python/pull/8643))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8533](https://github.com/googleapis/google-cloud-python/pull/8533))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8573](https://github.com/googleapis/google-cloud-python/pull/8573))
+- Update Ruby package name (via synth). ([#8485](https://github.com/googleapis/google-cloud-python/pull/8485))
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.3.0
+
+06-20-2019 14:47 PDT
+
+
+### New Features
+- Add support for video object tracking (via synth). ([#8278](https://github.com/googleapis/google-cloud-python/pull/8278))
+
+### Documentation
+- Add proto files; add 'docs' session to 'nox'; update docstrings (via synth). ([#8029](https://github.com/googleapis/google-cloud-python/pull/8029))
+
+### Internal / Testing Changes
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8233](https://github.com/googleapis/google-cloud-python/pull/8233))
+- Fix coverage in 'types.py'. ([#8145](https://github.com/googleapis/google-cloud-python/pull/8145))
+- Blacken noxfile.py, setup.py (via synth). ([#8115](https://github.com/googleapis/google-cloud-python/pull/8115))
+- Add empty lines (via synth). ([#8048](https://github.com/googleapis/google-cloud-python/pull/8048))
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+- Include protos in synth. ([#8000](https://github.com/googleapis/google-cloud-python/pull/8000))
+
+## 0.2.0
+
+04-03-2019 09:16 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Sort generated classes (via synth). ([#7256](https://github.com/googleapis/google-cloud-python/pull/7256))
+- Protoc-generated serialization update. ([#7074](https://github.com/googleapis/google-cloud-python/pull/7074))
+
+### New Features
+- Video Classification, Text Extraction, Text Sentiment, Tables support. ([#7650](https://github.com/googleapis/google-cloud-python/pull/7650))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- AutoML: pick up stub docstring fix in GAPIC generator. ([#6964](https://github.com/googleapis/google-cloud-python/pull/6964))
+
+### Internal / Testing Changes
+- Update copyright headers
+
+## 0.1.2
+
+12-17-2018 16:27 PST
+
+
+### Implementation Changes
+- Add protoc-generated descriptor changes from updated .proto files. ([#6899](https://github.com/googleapis/google-cloud-python/pull/6899))
+- Import `iam.policy` from `google.api_core.iam.policy`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes in GAPIC generator. ([#6490](https://github.com/googleapis/google-cloud-python/pull/6490))
+- Assorted synth fixups / cleanups ([#6400](https://github.com/googleapis/google-cloud-python/pull/6400))
+- Fix client_info bug, update docstrings. ([#6404](https://github.com/googleapis/google-cloud-python/pull/6404))
+- Re-generate library using automl/synth.py ([#5972](https://github.com/googleapis/google-cloud-python/pull/5972))
+- Re-generate library using automl/synth.py ([#5946](https://github.com/googleapis/google-cloud-python/pull/5946))
+
+### Dependencies
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Bump minimum `api_core`' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6005](https://github.com/googleapis/google-cloud-python/pull/6005))
+- Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Unblack automl gapic and protos.
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6561](https://github.com/googleapis/google-cloud-python/pull/6561))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.1.1
+
+### Documentation
+- Fix broken links (#5675)
+- bad trove classifier (#5648)
+
+## 0.1.0
+
+### New Features
+- Initial Release of AutoML v1beta1
+
diff --git a/automl/LICENSE b/automl/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/automl/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/automl/MANIFEST.in b/automl/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/automl/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/automl/README.rst b/automl/README.rst
new file mode 100644
index 000000000000..ecf4052479a1
--- /dev/null
+++ b/automl/README.rst
@@ -0,0 +1,131 @@
+Python Client for Cloud AutoML API
+==================================
+
+|alpha| |pypi| |versions| 
+
+The `Cloud AutoML API`_ 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.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-automl.svg
+   :target: https://pypi.org/project/google-cloud-automl/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-automl.svg
+   :target: https://pypi.org/project/google-cloud-automl/
+.. _Cloud AutoML API: https://cloud.google.com/automl
+.. _Client Library Documentation: https://googleapis.dev/python/automl/latest
+.. _Product Documentation:  https://cloud.google.com/automl
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud AutoML API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud AutoML API.:  https://cloud.google.com/automl
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-automl
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-automl
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   from google.cloud.automl_v1beta1 import PredictionServiceClient
+
+   client = PredictionServiceClient()
+   model_path = client.model_path('my-project-123', 'us-central', 'model-name')
+   payload = {...}
+   params = {'foo': 1}
+   response = client.predict(model_path, payload, params=params)
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud AutoML API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
+
+Making & Testing Local Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to make changes to this library, here is how to set up your
+development environment:
+
+1. Make sure you have `virtualenv`_ installed and activated as shown above.
+2. Run the following one-time setup (it will be persisted in your virtualenv):
+
+   .. code-block:: console
+
+       pip install -r ../docs/requirements.txt
+       pip install -U nox mock pytest
+
+3. If you want to run all tests, you will need a billing-enabled 
+   `GCP project`_, and a `service account`_ with access to the AutoML APIs.
+   Note: the first time the tests run in a new project it will take a _long_
+   time, on the order of 2-3 hours. This is one-time setup that will be skipped
+   in future runs.
+
+.. _service account: https://cloud.google.com/iam/docs/creating-managing-service-accounts
+.. _GCP project: https://cloud.google.com/resource-manager/docs/creating-managing-projects
+
+.. code-block:: console
+
+    export PROJECT_ID=<project-id> GOOGLE_APPLICATION_CREDENTIALS=</path/to/creds.json>
+    nox
+
diff --git a/automl/docs/README.rst b/automl/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/automl/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/automl/docs/changelog.md b/automl/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/automl/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/automl/docs/conf.py b/automl/docs/conf.py
new file mode 100644
index 000000000000..4eb565b9bf75
--- /dev/null
+++ b/automl/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-automl documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-automl"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-automl-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-automl.tex",
+        u"google-cloud-automl Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-automl",
+        u"google-cloud-automl Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-automl",
+        u"google-cloud-automl Documentation",
+        author,
+        "google-cloud-automl",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/automl/docs/gapic/v1beta1/api.rst b/automl/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..268baa5b798c
--- /dev/null
+++ b/automl/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud AutoML API
+===========================
+
+.. automodule:: google.cloud.automl_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/automl/docs/gapic/v1beta1/tables.rst b/automl/docs/gapic/v1beta1/tables.rst
new file mode 100644
index 000000000000..54ed6a203805
--- /dev/null
+++ b/automl/docs/gapic/v1beta1/tables.rst
@@ -0,0 +1,5 @@
+A tables-specific client for AutoML
+===================================
+
+.. automodule:: google.cloud.automl_v1beta1.tables.tables_client
+    :members:
diff --git a/automl/docs/gapic/v1beta1/types.rst b/automl/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..27ce6644bcc5
--- /dev/null
+++ b/automl/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud AutoML API Client
+=================================
+
+.. automodule:: google.cloud.automl_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/automl/docs/index.rst b/automl/docs/index.rst
new file mode 100644
index 000000000000..01f577642cb1
--- /dev/null
+++ b/automl/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+    gapic/v1beta1/tables
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-automl`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/automl/google/__init__.py b/automl/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/automl/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/automl/google/cloud/__init__.py b/automl/google/cloud/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/automl/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/automl/google/cloud/automl.py b/automl/google/cloud/automl.py
new file mode 100644
index 000000000000..77528b3d1dbf
--- /dev/null
+++ b/automl/google/cloud/automl.py
@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.automl_v1beta1 import AutoMlClient
+from google.cloud.automl_v1beta1 import PredictionServiceClient
+from google.cloud.automl_v1beta1 import enums
+from google.cloud.automl_v1beta1 import types
+
+
+__all__ = ("enums", "types", "AutoMlClient", "PredictionServiceClient")
diff --git a/automl/google/cloud/automl_v1beta1/__init__.py b/automl/google/cloud/automl_v1beta1/__init__.py
new file mode 100644
index 000000000000..113b55279b85
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/__init__.py
@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.automl_v1beta1 import types
+from google.cloud.automl_v1beta1.gapic import auto_ml_client
+from google.cloud.automl_v1beta1.gapic import enums
+from google.cloud.automl_v1beta1.gapic import prediction_service_client
+from google.cloud.automl_v1beta1.tables import gcs_client
+from google.cloud.automl_v1beta1.tables import tables_client
+
+
+class TablesClient(tables_client.TablesClient):
+    __doc__ = tables_client.TablesClient.__doc__
+
+
+class AutoMlClient(auto_ml_client.AutoMlClient):
+    __doc__ = auto_ml_client.AutoMlClient.__doc__
+    enums = enums
+
+
+class PredictionServiceClient(prediction_service_client.PredictionServiceClient):
+    __doc__ = prediction_service_client.PredictionServiceClient.__doc__
+    enums = enums
+
+
+class GcsClient(gcs_client.GcsClient):
+    __doc__ = gcs_client.GcsClient.__doc__
+
+
+__all__ = (
+    "enums",
+    "types",
+    "AutoMlClient",
+    "PredictionServiceClient",
+    "TablesClient",
+    "GcsClient",
+)
diff --git a/automl/google/cloud/automl_v1beta1/gapic/__init__.py b/automl/google/cloud/automl_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client.py b/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client.py
new file mode 100644
index 000000000000..e0e10d8735e4
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client.py
@@ -0,0 +1,2457 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.automl.v1beta1 AutoMl API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.automl_v1beta1.gapic import auto_ml_client_config
+from google.cloud.automl_v1beta1.gapic import enums
+from google.cloud.automl_v1beta1.gapic.transports import auto_ml_grpc_transport
+from google.cloud.automl_v1beta1.proto import annotation_spec_pb2
+from google.cloud.automl_v1beta1.proto import column_spec_pb2
+from google.cloud.automl_v1beta1.proto import dataset_pb2
+from google.cloud.automl_v1beta1.proto import image_pb2
+from google.cloud.automl_v1beta1.proto import io_pb2
+from google.cloud.automl_v1beta1.proto import model_evaluation_pb2
+from google.cloud.automl_v1beta1.proto import model_pb2
+from google.cloud.automl_v1beta1.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.automl_v1beta1.proto import service_pb2
+from google.cloud.automl_v1beta1.proto import service_pb2_grpc
+from google.cloud.automl_v1beta1.proto import table_spec_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-automl").version
+
+
+class AutoMlClient(object):
+    """
+    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_ADDRESS = "automl.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.automl.v1beta1.AutoMl"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            AutoMlClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def annotation_spec_path(cls, project, location, dataset, annotation_spec):
+        """Return a fully-qualified annotation_spec string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}",
+            project=project,
+            location=location,
+            dataset=dataset,
+            annotation_spec=annotation_spec,
+        )
+
+    @classmethod
+    def column_spec_path(cls, project, location, dataset, table_spec, column_spec):
+        """Return a fully-qualified column_spec string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}/columnSpecs/{column_spec}",
+            project=project,
+            location=location,
+            dataset=dataset,
+            table_spec=table_spec,
+            column_spec=column_spec,
+        )
+
+    @classmethod
+    def dataset_path(cls, project, location, dataset):
+        """Return a fully-qualified dataset string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/datasets/{dataset}",
+            project=project,
+            location=location,
+            dataset=dataset,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def model_path(cls, project, location, model):
+        """Return a fully-qualified model string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/models/{model}",
+            project=project,
+            location=location,
+            model=model,
+        )
+
+    @classmethod
+    def model_evaluation_path(cls, project, location, model, model_evaluation):
+        """Return a fully-qualified model_evaluation string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation}",
+            project=project,
+            location=location,
+            model=model,
+            model_evaluation=model_evaluation,
+        )
+
+    @classmethod
+    def table_spec_path(cls, project, location, dataset, table_spec):
+        """Return a fully-qualified table_spec string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}",
+            project=project,
+            location=location,
+            dataset=dataset,
+            table_spec=table_spec,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.AutoMlGrpcTransport,
+                    Callable[[~.Credentials, type], ~.AutoMlGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = auto_ml_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=auto_ml_grpc_transport.AutoMlGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = auto_ml_grpc_transport.AutoMlGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_dataset(
+        self,
+        parent,
+        dataset,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `dataset`:
+            >>> dataset = {}
+            >>>
+            >>> response = client.create_dataset(parent, dataset)
+
+        Args:
+            parent (str): The resource name of the project to create the dataset for.
+            dataset (Union[dict, ~google.cloud.automl_v1beta1.types.Dataset]): The dataset to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.Dataset`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_dataset,
+                default_retry=self._method_configs["CreateDataset"].retry,
+                default_timeout=self._method_configs["CreateDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.CreateDatasetRequest(parent=parent, dataset=dataset)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_dataset(
+        self,
+        dataset,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> # TODO: Initialize `dataset`:
+            >>> dataset = {}
+            >>>
+            >>> response = client.update_dataset(dataset)
+
+        Args:
+            dataset (Union[dict, ~google.cloud.automl_v1beta1.types.Dataset]): The dataset which replaces the resource on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.Dataset`
+            update_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): The update mask applies to the resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_dataset,
+                default_retry=self._method_configs["UpdateDataset"].retry,
+                default_timeout=self._method_configs["UpdateDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UpdateDatasetRequest(
+            dataset=dataset, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("dataset.name", dataset.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_dataset(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[LOCATION]', '[DATASET]')
+            >>>
+            >>> response = client.get_dataset(name)
+
+        Args:
+            name (str): The resource name of the dataset to retrieve.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_dataset,
+                default_retry=self._method_configs["GetDataset"].retry,
+                default_timeout=self._method_configs["GetDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetDatasetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_datasets(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists datasets in a project.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_datasets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_datasets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The resource name of the project from which to list datasets.
+            filter_ (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.Dataset` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_datasets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_datasets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_datasets,
+                default_retry=self._method_configs["ListDatasets"].retry,
+                default_timeout=self._method_configs["ListDatasets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListDatasetsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_datasets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="datasets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_dataset(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a dataset and all of its contents. Returns empty response in the
+        ``response`` field when it completes, and ``delete_details`` in the
+        ``metadata`` field.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[LOCATION]', '[DATASET]')
+            >>>
+            >>> response = client.delete_dataset(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): The resource name of the dataset to delete.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_dataset,
+                default_retry=self._method_configs["DeleteDataset"].retry,
+                default_timeout=self._method_configs["DeleteDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.DeleteDatasetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["delete_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def import_data(
+        self,
+        name,
+        input_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Imports data into a dataset. For Tables this method can only be called
+        on an empty Dataset.
+
+        For Tables:
+
+        -  A ``schema_inference_version`` parameter must be explicitly set.
+           Returns an empty response in the ``response`` field when it
+           completes.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[LOCATION]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_data(name, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. Dataset name. Dataset must already exist. All imported
+                annotations and examples will be added.
+            input_config (Union[dict, ~google.cloud.automl_v1beta1.types.InputConfig]): Required. The desired input location and its domain specific semantics,
+                if any.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.InputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_data" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_data"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_data,
+                default_retry=self._method_configs["ImportData"].retry,
+                default_timeout=self._method_configs["ImportData"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ImportDataRequest(name=name, input_config=input_config)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_data"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def export_data(
+        self,
+        name,
+        output_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Exports dataset's data to the provided output location. Returns an empty
+        response in the ``response`` field when it completes.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[LOCATION]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_data(name, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. The resource name of the dataset.
+            output_config (Union[dict, ~google.cloud.automl_v1beta1.types.OutputConfig]): Required. The desired output location.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.OutputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_data" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_data"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_data,
+                default_retry=self._method_configs["ExportData"].retry,
+                default_timeout=self._method_configs["ExportData"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ExportDataRequest(name=name, output_config=output_config)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_data"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def create_model(
+        self,
+        parent,
+        model,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a model. Returns a Model in the ``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.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `model`:
+            >>> model = {}
+            >>>
+            >>> response = client.create_model(parent, model)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Resource name of the parent project where the model is being created.
+            model (Union[dict, ~google.cloud.automl_v1beta1.types.Model]): The model to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.Model`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_model" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_model"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_model,
+                default_retry=self._method_configs["CreateModel"].retry,
+                default_timeout=self._method_configs["CreateModel"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.CreateModelRequest(parent=parent, model=model)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_model"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            model_pb2.Model,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def get_model(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a model.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> response = client.get_model(name)
+
+        Args:
+            name (str): Resource name of the model.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Model` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_model" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_model"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_model,
+                default_retry=self._method_configs["GetModel"].retry,
+                default_timeout=self._method_configs["GetModel"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetModelRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_model"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_models(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists models.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_models(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_models(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the project, from which to list the models.
+            filter_ (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.Model` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_models" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_models"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_models,
+                default_retry=self._method_configs["ListModels"].retry,
+                default_timeout=self._method_configs["ListModels"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListModelsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_models"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="model",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_model(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a model. Returns ``google.protobuf.Empty`` in the ``response``
+        field when it completes, and ``delete_details`` in the ``metadata``
+        field.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> response = client.delete_model(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Resource name of the model being deleted.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_model" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_model"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_model,
+                default_retry=self._method_configs["DeleteModel"].retry,
+                default_timeout=self._method_configs["DeleteModel"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.DeleteModelRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["delete_model"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def deploy_model(
+        self,
+        name,
+        image_object_detection_model_deployment_metadata=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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``) 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.
+
+        Returns an empty response in the ``response`` field when it completes.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> response = client.deploy_model(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Resource name of the model to deploy.
+            image_object_detection_model_deployment_metadata (Union[dict, ~google.cloud.automl_v1beta1.types.ImageObjectDetectionModelDeploymentMetadata]): Model deployment metadata specific to Image Object Detection.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.ImageObjectDetectionModelDeploymentMetadata`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "deploy_model" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "deploy_model"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.deploy_model,
+                default_retry=self._method_configs["DeployModel"].retry,
+                default_timeout=self._method_configs["DeployModel"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            image_object_detection_model_deployment_metadata=image_object_detection_model_deployment_metadata
+        )
+
+        request = service_pb2.DeployModelRequest(
+            name=name,
+            image_object_detection_model_deployment_metadata=image_object_detection_model_deployment_metadata,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["deploy_model"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def undeploy_model(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` field when it completes.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> response = client.undeploy_model(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Resource name of the model to undeploy.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "undeploy_model" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "undeploy_model"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.undeploy_model,
+                default_retry=self._method_configs["UndeployModel"].retry,
+                default_timeout=self._method_configs["UndeployModel"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UndeployModelRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["undeploy_model"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def get_model_evaluation(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a model evaluation.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_evaluation_path('[PROJECT]', '[LOCATION]', '[MODEL]', '[MODEL_EVALUATION]')
+            >>>
+            >>> response = client.get_model_evaluation(name)
+
+        Args:
+            name (str): Resource name for the model evaluation.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.ModelEvaluation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_model_evaluation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_model_evaluation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_model_evaluation,
+                default_retry=self._method_configs["GetModelEvaluation"].retry,
+                default_timeout=self._method_configs["GetModelEvaluation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetModelEvaluationRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_model_evaluation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def export_model(
+        self,
+        name,
+        output_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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``.
+
+        Returns an empty response in the ``response`` field when it completes.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_model(name, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. The resource name of the model to export.
+            output_config (Union[dict, ~google.cloud.automl_v1beta1.types.ModelExportOutputConfig]): Required. The desired output location and configuration.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.ModelExportOutputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_model" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_model"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_model,
+                default_retry=self._method_configs["ExportModel"].retry,
+                default_timeout=self._method_configs["ExportModel"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ExportModelRequest(name=name, output_config=output_config)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_model"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def export_evaluated_examples(
+        self,
+        name,
+        output_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Exports examples on which the model was evaluated (i.e. which were in
+        the TEST set of the dataset the model was created from), together with
+        their ground truth annotations and the annotations created (predicted)
+        by the model. The examples, ground truth and predictions are exported in
+        the state they were at the moment the model was evaluated.
+
+        This export is available only for 30 days since the model evaluation is
+        created.
+
+        Currently only available for Tables.
+
+        Returns an empty response in the ``response`` field when it completes.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_evaluated_examples(name, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. The resource name of the model whose evaluated examples are to
+                be exported.
+            output_config (Union[dict, ~google.cloud.automl_v1beta1.types.ExportEvaluatedExamplesOutputConfig]): Required. The desired output location and configuration.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.ExportEvaluatedExamplesOutputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_evaluated_examples" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_evaluated_examples"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_evaluated_examples,
+                default_retry=self._method_configs["ExportEvaluatedExamples"].retry,
+                default_timeout=self._method_configs["ExportEvaluatedExamples"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ExportEvaluatedExamplesRequest(
+            name=name, output_config=output_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_evaluated_examples"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
+
+    def list_model_evaluations(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists model evaluations.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_model_evaluations(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_model_evaluations(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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.
+            filter_ (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.ModelEvaluation` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_model_evaluations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_model_evaluations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_model_evaluations,
+                default_retry=self._method_configs["ListModelEvaluations"].retry,
+                default_timeout=self._method_configs["ListModelEvaluations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListModelEvaluationsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_model_evaluations"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="model_evaluation",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_annotation_spec(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an annotation spec.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.annotation_spec_path('[PROJECT]', '[LOCATION]', '[DATASET]', '[ANNOTATION_SPEC]')
+            >>>
+            >>> response = client.get_annotation_spec(name)
+
+        Args:
+            name (str): The resource name of the annotation spec to retrieve.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.AnnotationSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_annotation_spec" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_annotation_spec"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_annotation_spec,
+                default_retry=self._method_configs["GetAnnotationSpec"].retry,
+                default_timeout=self._method_configs["GetAnnotationSpec"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetAnnotationSpecRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_annotation_spec"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_table_spec(
+        self,
+        name,
+        field_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a table spec.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.table_spec_path('[PROJECT]', '[LOCATION]', '[DATASET]', '[TABLE_SPEC]')
+            >>>
+            >>> response = client.get_table_spec(name)
+
+        Args:
+            name (str): The resource name of the table spec to retrieve.
+            field_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): Mask specifying which fields to read.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.TableSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_table_spec" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_table_spec"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_table_spec,
+                default_retry=self._method_configs["GetTableSpec"].retry,
+                default_timeout=self._method_configs["GetTableSpec"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetTableSpecRequest(name=name, field_mask=field_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_table_spec"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_table_specs(
+        self,
+        parent,
+        field_mask=None,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists table specs in a dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.dataset_path('[PROJECT]', '[LOCATION]', '[DATASET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_table_specs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_table_specs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The resource name of the dataset to list table specs from.
+            field_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): Mask specifying which fields to read.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            filter_ (str): Filter expression, see go/filtering.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.TableSpec` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_table_specs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_table_specs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_table_specs,
+                default_retry=self._method_configs["ListTableSpecs"].retry,
+                default_timeout=self._method_configs["ListTableSpecs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListTableSpecsRequest(
+            parent=parent, field_mask=field_mask, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_table_specs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="table_specs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_table_spec(
+        self,
+        table_spec,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a table spec.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> # TODO: Initialize `table_spec`:
+            >>> table_spec = {}
+            >>>
+            >>> response = client.update_table_spec(table_spec)
+
+        Args:
+            table_spec (Union[dict, ~google.cloud.automl_v1beta1.types.TableSpec]): The table spec which replaces the resource on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.TableSpec`
+            update_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): The update mask applies to the resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.TableSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_table_spec" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_table_spec"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_table_spec,
+                default_retry=self._method_configs["UpdateTableSpec"].retry,
+                default_timeout=self._method_configs["UpdateTableSpec"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UpdateTableSpecRequest(
+            table_spec=table_spec, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_spec.name", table_spec.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_table_spec"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_column_spec(
+        self,
+        name,
+        field_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a column spec.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> name = client.column_spec_path('[PROJECT]', '[LOCATION]', '[DATASET]', '[TABLE_SPEC]', '[COLUMN_SPEC]')
+            >>>
+            >>> response = client.get_column_spec(name)
+
+        Args:
+            name (str): The resource name of the column spec to retrieve.
+            field_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): Mask specifying which fields to read.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.ColumnSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_column_spec" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_column_spec"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_column_spec,
+                default_retry=self._method_configs["GetColumnSpec"].retry,
+                default_timeout=self._method_configs["GetColumnSpec"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetColumnSpecRequest(name=name, field_mask=field_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_column_spec"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_column_specs(
+        self,
+        parent,
+        field_mask=None,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists column specs in a table spec.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> parent = client.table_spec_path('[PROJECT]', '[LOCATION]', '[DATASET]', '[TABLE_SPEC]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_column_specs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_column_specs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The resource name of the table spec to list column specs from.
+            field_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): Mask specifying which fields to read.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            filter_ (str): Filter expression, see go/filtering.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.ColumnSpec` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_column_specs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_column_specs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_column_specs,
+                default_retry=self._method_configs["ListColumnSpecs"].retry,
+                default_timeout=self._method_configs["ListColumnSpecs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListColumnSpecsRequest(
+            parent=parent, field_mask=field_mask, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_column_specs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="column_specs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_column_spec(
+        self,
+        column_spec,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a column spec.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.AutoMlClient()
+            >>>
+            >>> # TODO: Initialize `column_spec`:
+            >>> column_spec = {}
+            >>>
+            >>> response = client.update_column_spec(column_spec)
+
+        Args:
+            column_spec (Union[dict, ~google.cloud.automl_v1beta1.types.ColumnSpec]): The column spec which replaces the resource on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.ColumnSpec`
+            update_mask (Union[dict, ~google.cloud.automl_v1beta1.types.FieldMask]): The update mask applies to the resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.ColumnSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_column_spec" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_column_spec"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_column_spec,
+                default_retry=self._method_configs["UpdateColumnSpec"].retry,
+                default_timeout=self._method_configs["UpdateColumnSpec"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UpdateColumnSpecRequest(
+            column_spec=column_spec, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("column_spec.name", column_spec.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_column_spec"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client_config.py b/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client_config.py
new file mode 100644
index 000000000000..d127ce6f478b
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/auto_ml_client_config.py
@@ -0,0 +1,143 @@
+config = {
+    "interfaces": {
+        "google.cloud.automl.v1beta1.AutoMl": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateDataset": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDataset": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDataset": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDatasets": {
+                    "timeout_millis": 50000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDataset": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportData": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportData": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateModel": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetModel": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListModels": {
+                    "timeout_millis": 50000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteModel": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeployModel": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UndeployModel": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetModelEvaluation": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportModel": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportEvaluatedExamples": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListModelEvaluations": {
+                    "timeout_millis": 50000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetAnnotationSpec": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTableSpec": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTableSpecs": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTableSpec": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetColumnSpec": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListColumnSpecs": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateColumnSpec": {
+                    "timeout_millis": 5000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/automl/google/cloud/automl_v1beta1/gapic/enums.py b/automl/google/cloud/automl_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..9d817f8ec807
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/enums.py
@@ -0,0 +1,158 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ClassificationType(enum.IntEnum):
+    """
+    Type of the classification problem.
+
+    Attributes:
+      CLASSIFICATION_TYPE_UNSPECIFIED (int): An un-set value of this enum.
+      MULTICLASS (int): At most one label is allowed per example.
+      MULTILABEL (int): Multiple labels are allowed for one example.
+    """
+
+    CLASSIFICATION_TYPE_UNSPECIFIED = 0
+    MULTICLASS = 1
+    MULTILABEL = 2
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class TypeCode(enum.IntEnum):
+    """
+    ``TypeCode`` is used as a part of ``DataType``.
+
+    Attributes:
+      TYPE_CODE_UNSPECIFIED (int): Not specified. Should not be used.
+      FLOAT64 (int): Encoded as ``number``, or the strings ``"NaN"``, ``"Infinity"``, or
+      ``"-Infinity"``.
+      TIMESTAMP (int): Must be between 0AD and 9999AD. Encoded as ``string`` according to
+      ``time_format``, or, if that format is not set, then in RFC 3339
+      ``date-time`` format, where ``time-offset`` = ``"Z"`` (e.g.
+      1985-04-12T23:20:50.52Z).
+      STRING (int): Encoded as ``string``.
+      ARRAY (int): Encoded as ``list``, where the list elements are represented according
+      to
+
+      ``list_element_type``.
+      STRUCT (int): Encoded as ``struct``, where field values are represented according to
+      ``struct_type``.
+      CATEGORY (int): Values of this type are not further understood by AutoML, e.g. AutoML is
+      unable to tell the order of values (as it could with FLOAT64), or is
+      unable to say if one value contains another (as it could with STRING).
+      Encoded as ``string`` (bytes should be base64-encoded, as described in
+      RFC 4648, section 4).
+    """
+
+    TYPE_CODE_UNSPECIFIED = 0
+    FLOAT64 = 3
+    TIMESTAMP = 4
+    STRING = 6
+    ARRAY = 8
+    STRUCT = 9
+    CATEGORY = 10
+
+
+class Document(object):
+    class Layout(object):
+        class TextSegmentType(enum.IntEnum):
+            """
+            The type of TextSegment in the context of the original document.
+
+            Attributes:
+              TEXT_SEGMENT_TYPE_UNSPECIFIED (int): Should not be used.
+              TOKEN (int): The text segment is a token. e.g. word.
+              PARAGRAPH (int): The text segment is a paragraph.
+              FORM_FIELD (int): The text segment is a form field.
+              FORM_FIELD_NAME (int): 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_CONTENTS (int): 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.
+              TABLE (int): The text segment is a whole table, including headers, and all rows.
+              TABLE_HEADER (int): 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_ROW (int): 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_CELL (int): 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.
+            """
+
+            TEXT_SEGMENT_TYPE_UNSPECIFIED = 0
+            TOKEN = 1
+            PARAGRAPH = 2
+            FORM_FIELD = 3
+            FORM_FIELD_NAME = 4
+            FORM_FIELD_CONTENTS = 5
+            TABLE = 6
+            TABLE_HEADER = 7
+            TABLE_ROW = 8
+            TABLE_CELL = 9
+
+
+class DocumentDimensions(object):
+    class DocumentDimensionUnit(enum.IntEnum):
+        """
+        Unit of the document dimension.
+
+        Attributes:
+          DOCUMENT_DIMENSION_UNIT_UNSPECIFIED (int): Should not be used.
+          INCH (int): Document dimension is measured in inches.
+          CENTIMETER (int): Document dimension is measured in centimeters.
+          POINT (int): Document dimension is measured in points. 72 points = 1 inch.
+        """
+
+        DOCUMENT_DIMENSION_UNIT_UNSPECIFIED = 0
+        INCH = 1
+        CENTIMETER = 2
+        POINT = 3
+
+
+class Model(object):
+    class DeploymentState(enum.IntEnum):
+        """
+        Deployment state of the model.
+
+        Attributes:
+          DEPLOYMENT_STATE_UNSPECIFIED (int): Should not be used, an un-set enum has this value by default.
+          DEPLOYED (int): Model is deployed.
+          UNDEPLOYED (int): Model is not deployed.
+        """
+
+        DEPLOYMENT_STATE_UNSPECIFIED = 0
+        DEPLOYED = 1
+        UNDEPLOYED = 2
diff --git a/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client.py b/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client.py
new file mode 100644
index 000000000000..3342fecd621f
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client.py
@@ -0,0 +1,517 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.automl.v1beta1 PredictionService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.path_template
+import grpc
+
+from google.cloud.automl_v1beta1.gapic import enums
+from google.cloud.automl_v1beta1.gapic import prediction_service_client_config
+from google.cloud.automl_v1beta1.gapic.transports import (
+    prediction_service_grpc_transport,
+)
+from google.cloud.automl_v1beta1.proto import annotation_spec_pb2
+from google.cloud.automl_v1beta1.proto import column_spec_pb2
+from google.cloud.automl_v1beta1.proto import data_items_pb2
+from google.cloud.automl_v1beta1.proto import dataset_pb2
+from google.cloud.automl_v1beta1.proto import image_pb2
+from google.cloud.automl_v1beta1.proto import io_pb2
+from google.cloud.automl_v1beta1.proto import model_evaluation_pb2
+from google.cloud.automl_v1beta1.proto import model_pb2
+from google.cloud.automl_v1beta1.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.automl_v1beta1.proto import prediction_service_pb2
+from google.cloud.automl_v1beta1.proto import prediction_service_pb2_grpc
+from google.cloud.automl_v1beta1.proto import service_pb2
+from google.cloud.automl_v1beta1.proto import service_pb2_grpc
+from google.cloud.automl_v1beta1.proto import table_spec_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-automl").version
+
+
+class PredictionServiceClient(object):
+    """
+    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_ADDRESS = "automl.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.automl.v1beta1.PredictionService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            PredictionServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def model_path(cls, project, location, model):
+        """Return a fully-qualified model string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/models/{model}",
+            project=project,
+            location=location,
+            model=model,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.PredictionServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.PredictionServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = prediction_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=prediction_service_grpc_transport.PredictionServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = prediction_service_grpc_transport.PredictionServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def predict(
+        self,
+        name,
+        payload,
+        params=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Perform an online prediction. The prediction result will be directly
+        returned in the response. Available for following ML problems, and their
+        expected request payloads:
+
+        -  Image Classification - Image in .JPEG, .GIF or .PNG format,
+           image\_bytes up to 30MB.
+        -  Image Object Detection - Image in .JPEG, .GIF or .PNG format,
+           image\_bytes up to 30MB.
+        -  Text Classification - TextSnippet, content up to 60,000 characters,
+           UTF-8 encoded.
+        -  Text Extraction - TextSnippet, content up to 30,000 characters, UTF-8
+           NFC encoded.
+        -  Translation - TextSnippet, content up to 25,000 characters, UTF-8
+           encoded.
+        -  Tables - Row, with column values matching the columns of the model,
+           up to 5MB. Not available for FORECASTING
+
+        ``prediction_type``.
+
+        -  Text Sentiment - TextSnippet, content up 500 characters, UTF-8
+           encoded.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.PredictionServiceClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> # TODO: Initialize `payload`:
+            >>> payload = {}
+            >>>
+            >>> response = client.predict(name, payload)
+
+        Args:
+            name (str): Name of the model requested to serve the prediction.
+            payload (Union[dict, ~google.cloud.automl_v1beta1.types.ExamplePayload]): Required. Payload to perform a prediction on. The payload must match the
+                problem type that the model was trained to solve.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.ExamplePayload`
+            params (dict[str -> str]): Additional domain-specific parameters, any string must be up to 25000
+                characters long.
+
+                -  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 returned in the response.
+                   Default is 100, the requested value may be limited by server.
+
+                -  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].
+                The default is false.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.PredictResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "predict" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "predict"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.predict,
+                default_retry=self._method_configs["Predict"].retry,
+                default_timeout=self._method_configs["Predict"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = prediction_service_pb2.PredictRequest(
+            name=name, payload=payload, params=params
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["predict"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_predict(
+        self,
+        name,
+        input_config,
+        output_config,
+        params=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Perform a batch prediction. Unlike the online ``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`` method. Once the operation is
+        done, ``BatchPredictResult`` is returned in the ``response`` field.
+        Available for following ML problems:
+
+        -  Image Classification
+        -  Image Object Detection
+        -  Video Classification
+        -  Video Object Tracking \* Text Extraction
+        -  Tables
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.PredictionServiceClient()
+            >>>
+            >>> name = client.model_path('[PROJECT]', '[LOCATION]', '[MODEL]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.batch_predict(name, input_config, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Name of the model requested to serve the batch prediction.
+            input_config (Union[dict, ~google.cloud.automl_v1beta1.types.BatchPredictInputConfig]): Required. The input configuration for batch prediction.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.BatchPredictInputConfig`
+            output_config (Union[dict, ~google.cloud.automl_v1beta1.types.BatchPredictOutputConfig]): Required. The Configuration specifying where output predictions should
+                be written.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.automl_v1beta1.types.BatchPredictOutputConfig`
+            params (dict[str -> str]): 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. ``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. 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. The default is "false".
+                   ``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. 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. 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. ``max_bounding_box_count`` - (int64) No more than
+                   this number of bounding boxes will be returned per frame. Default is
+                   100, the requested value may be limited by server.
+                   ``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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_predict" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_predict"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_predict,
+                default_retry=self._method_configs["BatchPredict"].retry,
+                default_timeout=self._method_configs["BatchPredict"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = prediction_service_pb2.BatchPredictRequest(
+            name=name,
+            input_config=input_config,
+            output_config=output_config,
+            params=params,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["batch_predict"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            prediction_service_pb2.BatchPredictResult,
+            metadata_type=proto_operations_pb2.OperationMetadata,
+        )
diff --git a/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client_config.py b/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client_config.py
new file mode 100644
index 000000000000..d93ca92f8ed2
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/prediction_service_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.automl.v1beta1.PredictionService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "Predict": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchPredict": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/automl/google/cloud/automl_v1beta1/gapic/transports/__init__.py b/automl/google/cloud/automl_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/automl/google/cloud/automl_v1beta1/gapic/transports/auto_ml_grpc_transport.py b/automl/google/cloud/automl_v1beta1/gapic/transports/auto_ml_grpc_transport.py
new file mode 100644
index 000000000000..0efa164f5de5
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/transports/auto_ml_grpc_transport.py
@@ -0,0 +1,474 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.automl_v1beta1.proto import service_pb2_grpc
+
+
+class AutoMlGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.automl.v1beta1 AutoMl API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="automl.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"auto_ml_stub": service_pb2_grpc.AutoMlStub(channel)}
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="automl.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_dataset(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.create_dataset`.
+
+        Creates a dataset.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].CreateDataset
+
+    @property
+    def update_dataset(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.update_dataset`.
+
+        Updates a dataset.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].UpdateDataset
+
+    @property
+    def get_dataset(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.get_dataset`.
+
+        Gets a dataset.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].GetDataset
+
+    @property
+    def list_datasets(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.list_datasets`.
+
+        Lists datasets in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ListDatasets
+
+    @property
+    def delete_dataset(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.delete_dataset`.
+
+        Deletes a dataset and all of its contents. Returns empty response in the
+        ``response`` field when it completes, and ``delete_details`` in the
+        ``metadata`` field.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].DeleteDataset
+
+    @property
+    def import_data(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.import_data`.
+
+        Imports data into a dataset. For Tables this method can only be called
+        on an empty Dataset.
+
+        For Tables:
+
+        -  A ``schema_inference_version`` parameter must be explicitly set.
+           Returns an empty response in the ``response`` field when it
+           completes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ImportData
+
+    @property
+    def export_data(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.export_data`.
+
+        Exports dataset's data to the provided output location. Returns an empty
+        response in the ``response`` field when it completes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ExportData
+
+    @property
+    def create_model(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.create_model`.
+
+        Creates a model. Returns a Model in the ``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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].CreateModel
+
+    @property
+    def get_model(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.get_model`.
+
+        Gets a model.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].GetModel
+
+    @property
+    def list_models(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.list_models`.
+
+        Lists models.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ListModels
+
+    @property
+    def delete_model(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.delete_model`.
+
+        Deletes a model. Returns ``google.protobuf.Empty`` in the ``response``
+        field when it completes, and ``delete_details`` in the ``metadata``
+        field.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].DeleteModel
+
+    @property
+    def deploy_model(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.deploy_model`.
+
+        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``) 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.
+
+        Returns an empty response in the ``response`` field when it completes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].DeployModel
+
+    @property
+    def undeploy_model(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.undeploy_model`.
+
+        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`` field when it completes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].UndeployModel
+
+    @property
+    def get_model_evaluation(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.get_model_evaluation`.
+
+        Gets a model evaluation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].GetModelEvaluation
+
+    @property
+    def export_model(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.export_model`.
+
+        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``.
+
+        Returns an empty response in the ``response`` field when it completes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ExportModel
+
+    @property
+    def export_evaluated_examples(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.export_evaluated_examples`.
+
+        Exports examples on which the model was evaluated (i.e. which were in
+        the TEST set of the dataset the model was created from), together with
+        their ground truth annotations and the annotations created (predicted)
+        by the model. The examples, ground truth and predictions are exported in
+        the state they were at the moment the model was evaluated.
+
+        This export is available only for 30 days since the model evaluation is
+        created.
+
+        Currently only available for Tables.
+
+        Returns an empty response in the ``response`` field when it completes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ExportEvaluatedExamples
+
+    @property
+    def list_model_evaluations(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.list_model_evaluations`.
+
+        Lists model evaluations.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ListModelEvaluations
+
+    @property
+    def get_annotation_spec(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.get_annotation_spec`.
+
+        Gets an annotation spec.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].GetAnnotationSpec
+
+    @property
+    def get_table_spec(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.get_table_spec`.
+
+        Gets a table spec.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].GetTableSpec
+
+    @property
+    def list_table_specs(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.list_table_specs`.
+
+        Lists table specs in a dataset.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ListTableSpecs
+
+    @property
+    def update_table_spec(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.update_table_spec`.
+
+        Updates a table spec.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].UpdateTableSpec
+
+    @property
+    def get_column_spec(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.get_column_spec`.
+
+        Gets a column spec.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].GetColumnSpec
+
+    @property
+    def list_column_specs(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.list_column_specs`.
+
+        Lists column specs in a table spec.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].ListColumnSpecs
+
+    @property
+    def update_column_spec(self):
+        """Return the gRPC stub for :meth:`AutoMlClient.update_column_spec`.
+
+        Updates a column spec.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["auto_ml_stub"].UpdateColumnSpec
diff --git a/automl/google/cloud/automl_v1beta1/gapic/transports/prediction_service_grpc_transport.py b/automl/google/cloud/automl_v1beta1/gapic/transports/prediction_service_grpc_transport.py
new file mode 100644
index 000000000000..143711923f54
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/gapic/transports/prediction_service_grpc_transport.py
@@ -0,0 +1,175 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.automl_v1beta1.proto import prediction_service_pb2_grpc
+
+
+class PredictionServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.automl.v1beta1 PredictionService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="automl.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "prediction_service_stub": prediction_service_pb2_grpc.PredictionServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="automl.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def predict(self):
+        """Return the gRPC stub for :meth:`PredictionServiceClient.predict`.
+
+        Perform an online prediction. The prediction result will be directly
+        returned in the response. Available for following ML problems, and their
+        expected request payloads:
+
+        -  Image Classification - Image in .JPEG, .GIF or .PNG format,
+           image\_bytes up to 30MB.
+        -  Image Object Detection - Image in .JPEG, .GIF or .PNG format,
+           image\_bytes up to 30MB.
+        -  Text Classification - TextSnippet, content up to 60,000 characters,
+           UTF-8 encoded.
+        -  Text Extraction - TextSnippet, content up to 30,000 characters, UTF-8
+           NFC encoded.
+        -  Translation - TextSnippet, content up to 25,000 characters, UTF-8
+           encoded.
+        -  Tables - Row, with column values matching the columns of the model,
+           up to 5MB. Not available for FORECASTING
+
+        ``prediction_type``.
+
+        -  Text Sentiment - TextSnippet, content up 500 characters, UTF-8
+           encoded.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["prediction_service_stub"].Predict
+
+    @property
+    def batch_predict(self):
+        """Return the gRPC stub for :meth:`PredictionServiceClient.batch_predict`.
+
+        Perform a batch prediction. Unlike the online ``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`` method. Once the operation is
+        done, ``BatchPredictResult`` is returned in the ``response`` field.
+        Available for following ML problems:
+
+        -  Image Classification
+        -  Image Object Detection
+        -  Video Classification
+        -  Video Object Tracking \* Text Extraction
+        -  Tables
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["prediction_service_stub"].BatchPredict
diff --git a/automl/google/cloud/automl_v1beta1/proto/__init__.py b/automl/google/cloud/automl_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/automl/google/cloud/automl_v1beta1/proto/annotation_payload.proto b/automl/google/cloud/automl_v1beta1/proto/annotation_payload.proto
new file mode 100644
index 000000000000..7cc2860f1597
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/annotation_payload.proto
@@ -0,0 +1,78 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/classification.proto";
+import "google/cloud/automl/v1beta1/detection.proto";
+import "google/cloud/automl/v1beta1/tables.proto";
+import "google/cloud/automl/v1beta1/text_extraction.proto";
+import "google/cloud/automl/v1beta1/text_sentiment.proto";
+import "google/cloud/automl/v1beta1/translation.proto";
+import "google/protobuf/any.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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 video classification.
+    // Returned for Video Classification predictions.
+    VideoClassificationAnnotation video_classification = 9;
+
+    // Annotation details for video object tracking.
+    VideoObjectTrackingAnnotation video_object_tracking = 8;
+
+    // Annotation details for text extraction.
+    TextExtractionAnnotation text_extraction = 6;
+
+    // Annotation details for text sentiment.
+    TextSentimentAnnotation text_sentiment = 7;
+
+    // Annotation details for Tables.
+    TablesAnnotation tables = 10;
+  }
+
+  // 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.v1beta1.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/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2.py b/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2.py
new file mode 100644
index 000000000000..f05435b900ab
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2.py
@@ -0,0 +1,412 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/annotation_payload.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    detection_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    tables_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_extraction_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__extraction__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_sentiment_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__sentiment__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    translation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2,
+)
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/annotation_payload.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/automl_v1beta1/proto/annotation_payload.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x31google/cloud/automl_v1beta1/proto/detection.proto\x1a.google/cloud/automl_v1beta1/proto/tables.proto\x1a\x37google/cloud/automl_v1beta1/proto/text_extraction.proto\x1a\x36google/cloud/automl_v1beta1/proto/text_sentiment.proto\x1a\x33google/cloud/automl_v1beta1/proto/translation.proto\x1a\x19google/protobuf/any.proto\x1a\x1cgoogle/api/annotations.proto"\xe6\x05\n\x11\x41nnotationPayload\x12I\n\x0btranslation\x18\x02 \x01(\x0b\x32\x32.google.cloud.automl.v1beta1.TranslationAnnotationH\x00\x12O\n\x0e\x63lassification\x18\x03 \x01(\x0b\x32\x35.google.cloud.automl.v1beta1.ClassificationAnnotationH\x00\x12]\n\x16image_object_detection\x18\x04 \x01(\x0b\x32;.google.cloud.automl.v1beta1.ImageObjectDetectionAnnotationH\x00\x12Z\n\x14video_classification\x18\t \x01(\x0b\x32:.google.cloud.automl.v1beta1.VideoClassificationAnnotationH\x00\x12[\n\x15video_object_tracking\x18\x08 \x01(\x0b\x32:.google.cloud.automl.v1beta1.VideoObjectTrackingAnnotationH\x00\x12P\n\x0ftext_extraction\x18\x06 \x01(\x0b\x32\x35.google.cloud.automl.v1beta1.TextExtractionAnnotationH\x00\x12N\n\x0etext_sentiment\x18\x07 \x01(\x0b\x32\x34.google.cloud.automl.v1beta1.TextSentimentAnnotationH\x00\x12?\n\x06tables\x18\n \x01(\x0b\x32-.google.cloud.automl.v1beta1.TablesAnnotationH\x00\x12\x1a\n\x12\x61nnotation_spec_id\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x05 \x01(\tB\x08\n\x06\x64\x65tailB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__extraction__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__sentiment__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_ANNOTATIONPAYLOAD = _descriptor.Descriptor(
+    name="AnnotationPayload",
+    full_name="google.cloud.automl.v1beta1.AnnotationPayload",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="translation",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.translation",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="classification",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.classification",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_object_detection",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.image_object_detection",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.video_classification",
+            index=3,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_tracking",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.video_object_tracking",
+            index=4,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_extraction",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.text_extraction",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_sentiment",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.text_sentiment",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tables",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.tables",
+            index=7,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_id",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.annotation_spec_id",
+            index=8,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.display_name",
+            index=9,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="detail",
+            full_name="google.cloud.automl.v1beta1.AnnotationPayload.detail",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=470,
+    serialized_end=1212,
+)
+
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "translation"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2._TRANSLATIONANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "classification"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2._CLASSIFICATIONANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "image_object_detection"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2._IMAGEOBJECTDETECTIONANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "video_classification"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2._VIDEOCLASSIFICATIONANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "video_object_tracking"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2._VIDEOOBJECTTRACKINGANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "text_extraction"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__extraction__pb2._TEXTEXTRACTIONANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "text_sentiment"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__sentiment__pb2._TEXTSENTIMENTANNOTATION
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "tables"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2._TABLESANNOTATION
+)
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["translation"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "translation"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["classification"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "classification"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["image_object_detection"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "image_object_detection"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["video_classification"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "video_classification"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["video_object_tracking"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "video_object_tracking"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["text_extraction"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "text_extraction"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["text_sentiment"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "text_sentiment"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+_ANNOTATIONPAYLOAD.oneofs_by_name["detail"].fields.append(
+    _ANNOTATIONPAYLOAD.fields_by_name["tables"]
+)
+_ANNOTATIONPAYLOAD.fields_by_name[
+    "tables"
+].containing_oneof = _ANNOTATIONPAYLOAD.oneofs_by_name["detail"]
+DESCRIPTOR.message_types_by_name["AnnotationPayload"] = _ANNOTATIONPAYLOAD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotationPayload = _reflection.GeneratedProtocolMessageType(
+    "AnnotationPayload",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATIONPAYLOAD,
+        __module__="google.cloud.automl_v1beta1.proto.annotation_payload_pb2",
+        __doc__="""Contains annotation information that is relevant to AutoML.
+  
+  
+  Attributes:
+      detail:
+          Output only . Additional information about the annotation
+          specific to the AutoML domain.
+      translation:
+          Annotation details for translation.
+      classification:
+          Annotation details for content or image classification.
+      image_object_detection:
+          Annotation details for image object detection.
+      video_classification:
+          Annotation details for video classification. Returned for
+          Video Classification predictions.
+      video_object_tracking:
+          Annotation details for video object tracking.
+      text_extraction:
+          Annotation details for text extraction.
+      text_sentiment:
+          Annotation details for text sentiment.
+      tables:
+          Annotation details for Tables.
+      annotation_spec_id:
+          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.
+      display_name:
+          Output only. The value of [display\_name][google.cloud.automl.
+          v1beta1.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.AnnotationPayload)
+    ),
+)
+_sym_db.RegisterMessage(AnnotationPayload)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/annotation_payload_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/annotation_spec.proto b/automl/google/cloud/automl_v1beta1/proto/annotation_spec.proto
new file mode 100644
index 000000000000..483792b6678a
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/annotation_spec.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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// A definition of an annotation spec.
+message AnnotationSpec {
+  // 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_]+`.
+  // (_), and ASCII digits 0-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/automl/google/cloud/automl_v1beta1/proto/annotation_spec_pb2.py b/automl/google/cloud/automl_v1beta1/proto/annotation_spec_pb2.py
new file mode 100644
index 000000000000..80ae0a8af98a
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/annotation_spec_pb2.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/annotation_spec.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/annotation_spec.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/automl_v1beta1/proto/annotation_spec.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"K\n\x0e\x41nnotationSpec\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x15\n\rexample_count\x18\t \x01(\x05\x42\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_ANNOTATIONSPEC = _descriptor.Descriptor(
+    name="AnnotationSpec",
+    full_name="google.cloud.automl.v1beta1.AnnotationSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.AnnotationSpec.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.AnnotationSpec.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="example_count",
+            full_name="google.cloud.automl.v1beta1.AnnotationSpec.example_count",
+            index=2,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=118,
+    serialized_end=193,
+)
+
+DESCRIPTOR.message_types_by_name["AnnotationSpec"] = _ANNOTATIONSPEC
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotationSpec = _reflection.GeneratedProtocolMessageType(
+    "AnnotationSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATIONSPEC,
+        __module__="google.cloud.automl_v1beta1.proto.annotation_spec_pb2",
+        __doc__="""A definition of an annotation spec.
+  
+  
+  Attributes:
+      name:
+          Output only. Resource name of the annotation spec. Form:  'pro
+          jects/{project\_id}/locations/{location\_id}/datasets/{dataset
+          \_id}/annotationSpecs/{annotation\_spec\_id}'
+      display_name:
+          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.
+      example_count:
+          Output only. The number of examples in the parent dataset
+          labeled by the annotation spec.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.AnnotationSpec)
+    ),
+)
+_sym_db.RegisterMessage(AnnotationSpec)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/annotation_spec_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/annotation_spec_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/annotation_spec_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/classification.proto b/automl/google/cloud/automl_v1beta1/proto/classification.proto
new file mode 100644
index 000000000000..7e54238e0333
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/classification.proto
@@ -0,0 +1,217 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/temporal.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_outer_classname = "ClassificationProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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;
+}
+
+// Contains annotation details specific to video classification.
+message VideoClassificationAnnotation {
+  // Output only. Expresses the type of video classification. Possible values:
+  //
+  // *  `segment` - Classification done on a specified by user
+  //        time segment of a video. AnnotationSpec is answered to be present
+  //        in that time segment, if it is present in any part of it. The video
+  //        ML model evaluations are done only for this type of classification.
+  //
+  // *  `shot`- 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.
+  //        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` - 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.
+  //        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.
+  string type = 1;
+
+  // Output only . The classification details of this annotation.
+  ClassificationAnnotation classification_annotation = 2;
+
+  // Output only . The time segment of the video to which the
+  // annotation applies.
+  TimeSegment time_segment = 3;
+}
+
+// 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.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.recall_at1] and [precision_at1][google.cloud.automl.v1beta1.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.v1beta1.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.v1beta1.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.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.
+    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 Precision-Recall Curve metric based on priors.
+  // Micro-averaged for the overall evaluation.
+  // Deprecated.
+  float base_au_prc = 2 [deprecated = true];
+
+  // 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/automl/google/cloud/automl_v1beta1/proto/classification_pb2.py b/automl/google/cloud/automl_v1beta1/proto/classification_pb2.py
new file mode 100644
index 000000000000..496a4a2844b9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/classification_pb2.py
@@ -0,0 +1,991 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/classification.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    temporal_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_temporal__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/classification.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\023ClassificationProtoZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/automl_v1beta1/proto/classification.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x30google/cloud/automl_v1beta1/proto/temporal.proto\x1a\x1cgoogle/api/annotations.proto")\n\x18\x43lassificationAnnotation\x12\r\n\x05score\x18\x01 \x01(\x02"\xc7\x01\n\x1dVideoClassificationAnnotation\x12\x0c\n\x04type\x18\x01 \x01(\t\x12X\n\x19\x63lassification_annotation\x18\x02 \x01(\x0b\x32\x35.google.cloud.automl.v1beta1.ClassificationAnnotation\x12>\n\x0ctime_segment\x18\x03 \x01(\x0b\x32(.google.cloud.automl.v1beta1.TimeSegment"\xa9\x07\n\x1f\x43lassificationEvaluationMetrics\x12\x0e\n\x06\x61u_prc\x18\x01 \x01(\x02\x12\x17\n\x0b\x62\x61se_au_prc\x18\x02 \x01(\x02\x42\x02\x18\x01\x12\x0e\n\x06\x61u_roc\x18\x06 \x01(\x02\x12\x10\n\x08log_loss\x18\x07 \x01(\x02\x12u\n\x18\x63onfidence_metrics_entry\x18\x03 \x03(\x0b\x32S.google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry\x12\x66\n\x10\x63onfusion_matrix\x18\x04 \x01(\x0b\x32L.google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix\x12\x1a\n\x12\x61nnotation_spec_id\x18\x05 \x03(\t\x1a\xfc\x02\n\x16\x43onfidenceMetricsEntry\x12\x1c\n\x14\x63onfidence_threshold\x18\x01 \x01(\x02\x12\x1a\n\x12position_threshold\x18\x0e \x01(\x05\x12\x0e\n\x06recall\x18\x02 \x01(\x02\x12\x11\n\tprecision\x18\x03 \x01(\x02\x12\x1b\n\x13\x66\x61lse_positive_rate\x18\x08 \x01(\x02\x12\x10\n\x08\x66\x31_score\x18\x04 \x01(\x02\x12\x12\n\nrecall_at1\x18\x05 \x01(\x02\x12\x15\n\rprecision_at1\x18\x06 \x01(\x02\x12\x1f\n\x17\x66\x61lse_positive_rate_at1\x18\t \x01(\x02\x12\x14\n\x0c\x66\x31_score_at1\x18\x07 \x01(\x02\x12\x1b\n\x13true_positive_count\x18\n \x01(\x03\x12\x1c\n\x14\x66\x61lse_positive_count\x18\x0b \x01(\x03\x12\x1c\n\x14\x66\x61lse_negative_count\x18\x0c \x01(\x03\x12\x1b\n\x13true_negative_count\x18\r \x01(\x03\x1a\xc0\x01\n\x0f\x43onfusionMatrix\x12\x1a\n\x12\x61nnotation_spec_id\x18\x01 \x03(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x03(\t\x12]\n\x03row\x18\x02 \x03(\x0b\x32P.google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.Row\x1a\x1c\n\x03Row\x12\x15\n\rexample_count\x18\x01 \x03(\x05*Y\n\x12\x43lassificationType\x12#\n\x1f\x43LASSIFICATION_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nMULTICLASS\x10\x01\x12\x0e\n\nMULTILABEL\x10\x02\x42\xb8\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x13\x43lassificationProtoZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_temporal__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+_CLASSIFICATIONTYPE = _descriptor.EnumDescriptor(
+    name="ClassificationType",
+    full_name="google.cloud.automl.v1beta1.ClassificationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CLASSIFICATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MULTICLASS", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MULTILABEL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1352,
+    serialized_end=1441,
+)
+_sym_db.RegisterEnumDescriptor(_CLASSIFICATIONTYPE)
+
+ClassificationType = enum_type_wrapper.EnumTypeWrapper(_CLASSIFICATIONTYPE)
+CLASSIFICATION_TYPE_UNSPECIFIED = 0
+MULTICLASS = 1
+MULTILABEL = 2
+
+
+_CLASSIFICATIONANNOTATION = _descriptor.Descriptor(
+    name="ClassificationAnnotation",
+    full_name="google.cloud.automl.v1beta1.ClassificationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.automl.v1beta1.ClassificationAnnotation.score",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=167,
+    serialized_end=208,
+)
+
+
+_VIDEOCLASSIFICATIONANNOTATION = _descriptor.Descriptor(
+    name="VideoClassificationAnnotation",
+    full_name="google.cloud.automl.v1beta1.VideoClassificationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.automl.v1beta1.VideoClassificationAnnotation.type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="classification_annotation",
+            full_name="google.cloud.automl.v1beta1.VideoClassificationAnnotation.classification_annotation",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_segment",
+            full_name="google.cloud.automl.v1beta1.VideoClassificationAnnotation.time_segment",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=211,
+    serialized_end=410,
+)
+
+
+_CLASSIFICATIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY = _descriptor.Descriptor(
+    name="ConfidenceMetricsEntry",
+    full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="confidence_threshold",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.confidence_threshold",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="position_threshold",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.position_threshold",
+            index=1,
+            number=14,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.recall",
+            index=2,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.precision",
+            index=3,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_positive_rate",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.false_positive_rate",
+            index=4,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.f1_score",
+            index=5,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall_at1",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.recall_at1",
+            index=6,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision_at1",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.precision_at1",
+            index=7,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_positive_rate_at1",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.false_positive_rate_at1",
+            index=8,
+            number=9,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score_at1",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.f1_score_at1",
+            index=9,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="true_positive_count",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.true_positive_count",
+            index=10,
+            number=10,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_positive_count",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.false_positive_count",
+            index=11,
+            number=11,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_negative_count",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.false_negative_count",
+            index=12,
+            number=12,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="true_negative_count",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.true_negative_count",
+            index=13,
+            number=13,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=775,
+    serialized_end=1155,
+)
+
+_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX_ROW = _descriptor.Descriptor(
+    name="Row",
+    full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.Row",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="example_count",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.Row.example_count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1322,
+    serialized_end=1350,
+)
+
+_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX = _descriptor.Descriptor(
+    name="ConfusionMatrix",
+    full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_id",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.annotation_spec_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.display_name",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.row",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX_ROW],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1158,
+    serialized_end=1350,
+)
+
+_CLASSIFICATIONEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="ClassificationEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="au_prc",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.au_prc",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="base_au_prc",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.base_au_prc",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="au_roc",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.au_roc",
+            index=2,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="log_loss",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.log_loss",
+            index=3,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence_metrics_entry",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.confidence_metrics_entry",
+            index=4,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confusion_matrix",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.confusion_matrix",
+            index=5,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_id",
+            full_name="google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.annotation_spec_id",
+            index=6,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _CLASSIFICATIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY,
+        _CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=413,
+    serialized_end=1350,
+)
+
+_VIDEOCLASSIFICATIONANNOTATION.fields_by_name[
+    "classification_annotation"
+].message_type = _CLASSIFICATIONANNOTATION
+_VIDEOCLASSIFICATIONANNOTATION.fields_by_name[
+    "time_segment"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_temporal__pb2._TIMESEGMENT
+)
+_CLASSIFICATIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY.containing_type = (
+    _CLASSIFICATIONEVALUATIONMETRICS
+)
+_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX_ROW.containing_type = (
+    _CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX
+)
+_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX.fields_by_name[
+    "row"
+].message_type = _CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX_ROW
+_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX.containing_type = (
+    _CLASSIFICATIONEVALUATIONMETRICS
+)
+_CLASSIFICATIONEVALUATIONMETRICS.fields_by_name[
+    "confidence_metrics_entry"
+].message_type = _CLASSIFICATIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY
+_CLASSIFICATIONEVALUATIONMETRICS.fields_by_name[
+    "confusion_matrix"
+].message_type = _CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX
+DESCRIPTOR.message_types_by_name["ClassificationAnnotation"] = _CLASSIFICATIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "VideoClassificationAnnotation"
+] = _VIDEOCLASSIFICATIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "ClassificationEvaluationMetrics"
+] = _CLASSIFICATIONEVALUATIONMETRICS
+DESCRIPTOR.enum_types_by_name["ClassificationType"] = _CLASSIFICATIONTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ClassificationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ClassificationAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFICATIONANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.classification_pb2",
+        __doc__="""Contains annotation details specific to classification.
+  
+  
+  Attributes:
+      score:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ClassificationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ClassificationAnnotation)
+
+VideoClassificationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "VideoClassificationAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCLASSIFICATIONANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.classification_pb2",
+        __doc__="""Contains annotation details specific to video classification.
+  
+  
+  Attributes:
+      type:
+          Output only. Expresses the type of video classification.
+          Possible values:  -  ``segment`` - Classification done on a
+          specified by user time segment    of a video. AnnotationSpec
+          is answered to be present in that time    segment, if it is
+          present in any part of it. The video ML model    evaluations
+          are done only for this type of classification.  -  ``shot``-
+          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. 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``
+          - 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.
+          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.
+      classification_annotation:
+          Output only . The classification details of this annotation.
+      time_segment:
+          Output only . The time segment of the video to which the
+          annotation applies.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoClassificationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(VideoClassificationAnnotation)
+
+ClassificationEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "ClassificationEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        ConfidenceMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "ConfidenceMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLASSIFICATIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.classification_pb2",
+                __doc__="""Metrics for a single confidence threshold.
+    
+    
+    Attributes:
+        confidence_threshold:
+            Output only. Metrics are computed with an assumption that the
+            model never returns predictions with score lower than this
+            value.
+        position_threshold:
+            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.
+        recall:
+            Output only. Recall (True Positive Rate) for the given
+            confidence threshold.
+        precision:
+            Output only. Precision for the given confidence threshold.
+        false_positive_rate:
+            Output only. False Positive Rate for the given confidence
+            threshold.
+        f1_score:
+            Output only. The harmonic mean of recall and precision.
+        recall_at1:
+            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.
+        precision_at1:
+            Output only. The precision when only considering the label
+            that has the highest prediction score and not below the
+            confidence threshold for each example.
+        false_positive_rate_at1:
+            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.
+        f1_score_at1:
+            Output only. The harmonic mean of [recall\_at1][google.cloud.a
+            utoml.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetric
+            sEntry.recall\_at1] and [precision\_at1][google.cloud.automl.v
+            1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.
+            precision\_at1].
+        true_positive_count:
+            Output only. The number of model created labels that match a
+            ground truth label.
+        false_positive_count:
+            Output only. The number of model created labels that do not
+            match a ground truth label.
+        false_negative_count:
+            Output only. The number of ground truth labels that are not
+            matched by a model created label.
+        true_negative_count:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry)
+            ),
+        ),
+        ConfusionMatrix=_reflection.GeneratedProtocolMessageType(
+            "ConfusionMatrix",
+            (_message.Message,),
+            dict(
+                Row=_reflection.GeneratedProtocolMessageType(
+                    "Row",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX_ROW,
+                        __module__="google.cloud.automl_v1beta1.proto.classification_pb2",
+                        __doc__="""Output only. A row in the confusion matrix.
+      
+      
+      Attributes:
+          example_count:
+              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.v1beta1.ClassificationEvaluationMe
+              trics.ConfusionMatrix.display\_name] field.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix.Row)
+                    ),
+                ),
+                DESCRIPTOR=_CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX,
+                __module__="google.cloud.automl_v1beta1.proto.classification_pb2",
+                __doc__="""Confusion matrix of the model running the classification.
+    
+    
+    Attributes:
+        annotation_spec_id:
+            Output only. IDs of the annotation specs used in the confusion
+            matrix. For Tables CLASSIFICATION  [prediction\_type][google.c
+            loud.automl.v1beta1.TablesModelMetadata.prediction\_type] only
+            list of [annotation\_spec\_display\_name-s][] is populated.
+        display_name:
+            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][go
+            ogle.cloud.automl.v1beta1.TablesModelMetadata.prediction\_type
+            ], distinct values of the target column at the moment of the
+            model evaluation are populated here.
+        row:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix)
+            ),
+        ),
+        DESCRIPTOR=_CLASSIFICATIONEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.classification_pb2",
+        __doc__="""Model evaluation metrics for classification problems. Note: For Video
+  Classification this metrics only describe quality of the Video
+  Classification predictions of "segment\_classification" type.
+  
+  
+  Attributes:
+      au_prc:
+          Output only. The Area Under Precision-Recall Curve metric.
+          Micro-averaged for the overall evaluation.
+      base_au_prc:
+          Output only. The Area Under Precision-Recall Curve metric
+          based on priors. Micro-averaged for the overall evaluation.
+          Deprecated.
+      au_roc:
+          Output only. The Area Under Receiver Operating Characteristic
+          curve metric. Micro-averaged for the overall evaluation.
+      log_loss:
+          Output only. The Log Loss metric.
+      confidence_metrics_entry:
+          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.
+      confusion_matrix:
+          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.
+      annotation_spec_id:
+          Output only. The annotation spec ids used for this evaluation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ClassificationEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(ClassificationEvaluationMetrics)
+_sym_db.RegisterMessage(ClassificationEvaluationMetrics.ConfidenceMetricsEntry)
+_sym_db.RegisterMessage(ClassificationEvaluationMetrics.ConfusionMatrix)
+_sym_db.RegisterMessage(ClassificationEvaluationMetrics.ConfusionMatrix.Row)
+
+
+DESCRIPTOR._options = None
+_CLASSIFICATIONEVALUATIONMETRICS.fields_by_name["base_au_prc"]._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/classification_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/classification_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/classification_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/column_spec.proto b/automl/google/cloud/automl_v1beta1/proto/column_spec.proto
new file mode 100644
index 000000000000..b8f437f793ee
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/column_spec.proto
@@ -0,0 +1,73 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/data_stats.proto";
+import "google/cloud/automl/v1beta1/data_types.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// A representation of a column in a relational table. When listing them, column specs are returned in the same order in which they were
+// given on import .
+// Used by:
+//   *   Tables
+message ColumnSpec {
+  // Identifies the table's column, and its correlation with the column this
+  // ColumnSpec describes.
+  message CorrelatedColumn {
+    // The column_spec_id of the correlated column, which belongs to the same
+    // table as the in-context column.
+    string column_spec_id = 1;
+
+    // Correlation between this and the in-context column.
+    CorrelationStats correlation_stats = 2;
+  }
+
+  // Output only. The resource name of the column specs.
+  // Form:
+  //
+  // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/tableSpecs/{table_spec_id}/columnSpecs/{column_spec_id}`
+  string name = 1;
+
+  // The data type of elements stored in the column.
+  DataType data_type = 2;
+
+  // Output only. The name of the column to show in the interface. The name can
+  // be up to 100 characters long and can consist only of ASCII Latin letters
+  // A-Z and a-z, ASCII digits 0-9, underscores(_), and forward slashes(/), and
+  // must start with a letter or a digit.
+  string display_name = 3;
+
+  // Output only. Stats of the series of values in the column.
+  // 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.
+  DataStats data_stats = 4;
+
+  // Deprecated.
+  repeated CorrelatedColumn top_correlated_columns = 5;
+
+  // Used to perform consistent read-modify-write updates. If not set, a blind
+  // "overwrite" update happens.
+  string etag = 6;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2.py b/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2.py
new file mode 100644
index 000000000000..1a6685c98346
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2.py
@@ -0,0 +1,314 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/column_spec.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    data_stats_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    data_types_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__types__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/column_spec.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/automl_v1beta1/proto/column_spec.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x32google/cloud/automl_v1beta1/proto/data_stats.proto\x1a\x32google/cloud/automl_v1beta1/proto/data_types.proto\x1a\x1cgoogle/api/annotations.proto"\x84\x03\n\nColumnSpec\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x38\n\tdata_type\x18\x02 \x01(\x0b\x32%.google.cloud.automl.v1beta1.DataType\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12:\n\ndata_stats\x18\x04 \x01(\x0b\x32&.google.cloud.automl.v1beta1.DataStats\x12X\n\x16top_correlated_columns\x18\x05 \x03(\x0b\x32\x38.google.cloud.automl.v1beta1.ColumnSpec.CorrelatedColumn\x12\x0c\n\x04\x65tag\x18\x06 \x01(\t\x1at\n\x10\x43orrelatedColumn\x12\x16\n\x0e\x63olumn_spec_id\x18\x01 \x01(\t\x12H\n\x11\x63orrelation_stats\x18\x02 \x01(\x0b\x32-.google.cloud.automl.v1beta1.CorrelationStatsB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__types__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_COLUMNSPEC_CORRELATEDCOLUMN = _descriptor.Descriptor(
+    name="CorrelatedColumn",
+    full_name="google.cloud.automl.v1beta1.ColumnSpec.CorrelatedColumn",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="column_spec_id",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.CorrelatedColumn.column_spec_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="correlation_stats",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.CorrelatedColumn.correlation_stats",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=491,
+    serialized_end=607,
+)
+
+_COLUMNSPEC = _descriptor.Descriptor(
+    name="ColumnSpec",
+    full_name="google.cloud.automl.v1beta1.ColumnSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_type",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.data_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.display_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_stats",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.data_stats",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top_correlated_columns",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.top_correlated_columns",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.automl.v1beta1.ColumnSpec.etag",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_COLUMNSPEC_CORRELATEDCOLUMN],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=219,
+    serialized_end=607,
+)
+
+_COLUMNSPEC_CORRELATEDCOLUMN.fields_by_name[
+    "correlation_stats"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2._CORRELATIONSTATS
+)
+_COLUMNSPEC_CORRELATEDCOLUMN.containing_type = _COLUMNSPEC
+_COLUMNSPEC.fields_by_name[
+    "data_type"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__types__pb2._DATATYPE
+)
+_COLUMNSPEC.fields_by_name[
+    "data_stats"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2._DATASTATS
+)
+_COLUMNSPEC.fields_by_name[
+    "top_correlated_columns"
+].message_type = _COLUMNSPEC_CORRELATEDCOLUMN
+DESCRIPTOR.message_types_by_name["ColumnSpec"] = _COLUMNSPEC
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ColumnSpec = _reflection.GeneratedProtocolMessageType(
+    "ColumnSpec",
+    (_message.Message,),
+    dict(
+        CorrelatedColumn=_reflection.GeneratedProtocolMessageType(
+            "CorrelatedColumn",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COLUMNSPEC_CORRELATEDCOLUMN,
+                __module__="google.cloud.automl_v1beta1.proto.column_spec_pb2",
+                __doc__="""Identifies the table's column, and its correlation with the column this
+    ColumnSpec describes.
+    
+    
+    Attributes:
+        column_spec_id:
+            The column\_spec\_id of the correlated column, which belongs
+            to the same table as the in-context column.
+        correlation_stats:
+            Correlation between this and the in-context column.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ColumnSpec.CorrelatedColumn)
+            ),
+        ),
+        DESCRIPTOR=_COLUMNSPEC,
+        __module__="google.cloud.automl_v1beta1.proto.column_spec_pb2",
+        __doc__="""A representation of a column in a relational table. When listing them,
+  column specs are returned in the same order in which they were given on
+  import . Used by: \* Tables
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name of the column specs. Form:  ``p
+          rojects/{project_id}/locations/{location_id}/datasets/{dataset
+          _id}/tableSpecs/{table_spec_id}/columnSpecs/{column_spec_id}``
+      data_type:
+          The data type of elements stored in the column.
+      display_name:
+          Output only. The name of the column to show in the interface.
+          The name can be up to 100 characters long and can consist only
+          of ASCII Latin letters A-Z and a-z, ASCII digits 0-9,
+          underscores(\_), and forward slashes(/), and must start with a
+          letter or a digit.
+      data_stats:
+          Output only. Stats of the series of values in the column. 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.
+      top_correlated_columns:
+          Deprecated.
+      etag:
+          Used to perform consistent read-modify-write updates. If not
+          set, a blind "overwrite" update happens.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ColumnSpec)
+    ),
+)
+_sym_db.RegisterMessage(ColumnSpec)
+_sym_db.RegisterMessage(ColumnSpec.CorrelatedColumn)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/column_spec_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_items.proto b/automl/google/cloud/automl_v1beta1/proto/data_items.proto
new file mode 100644
index 000000000000..fdbea7042d84
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_items.proto
@@ -0,0 +1,229 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/automl/v1beta1/geometry.proto";
+import "google/cloud/automl/v1beta1/io.proto";
+import "google/cloud/automl/v1beta1/text_segment.proto";
+import "google/protobuf/any.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/struct.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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][] 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.
+  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;
+
+    // An input config specifying the content of the image.
+    InputConfig input_config = 6;
+  }
+
+  // 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.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 {
+  // 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
+  //
+  // [column_spec_ids][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs]
+  // of the Model this row is being passed to.
+  // Note: The below `values` field must match order of this field, if this
+  // field is set.
+  repeated string column_spec_ids = 2;
+
+  // 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.
+  repeated google.protobuf.Value values = 3;
+}
+
+// Example data used for training or prediction.
+message ExamplePayload {
+  // Required. Input only. The example data.
+  oneof payload {
+    // Example image.
+    Image image = 1;
+
+    // Example text.
+    TextSnippet text_snippet = 2;
+
+    // Example document.
+    Document document = 4;
+
+    // Example relational table row.
+    Row row = 3;
+  }
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_items_pb2.py b/automl/google/cloud/automl_v1beta1/proto/data_items_pb2.py
new file mode 100644
index 000000000000..ee388d632364
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_items_pb2.py
@@ -0,0 +1,1008 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/data_items.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.automl_v1beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    io_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_segment_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__segment__pb2,
+)
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/data_items.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/automl_v1beta1/proto/data_items.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x30google/cloud/automl_v1beta1/proto/geometry.proto\x1a*google/cloud/automl_v1beta1/proto/io.proto\x1a\x34google/cloud/automl_v1beta1/proto/text_segment.proto\x1a\x19google/protobuf/any.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/protobuf/struct.proto"\x7f\n\x05Image\x12\x15\n\x0bimage_bytes\x18\x01 \x01(\x0cH\x00\x12@\n\x0cinput_config\x18\x06 \x01(\x0b\x32(.google.cloud.automl.v1beta1.InputConfigH\x00\x12\x15\n\rthumbnail_uri\x18\x04 \x01(\tB\x06\n\x04\x64\x61ta"F\n\x0bTextSnippet\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\x12\x13\n\x0b\x63ontent_uri\x18\x04 \x01(\t"\xef\x01\n\x12\x44ocumentDimensions\x12S\n\x04unit\x18\x01 \x01(\x0e\x32\x45.google.cloud.automl.v1beta1.DocumentDimensions.DocumentDimensionUnit\x12\r\n\x05width\x18\x02 \x01(\x02\x12\x0e\n\x06height\x18\x03 \x01(\x02"e\n\x15\x44ocumentDimensionUnit\x12\'\n#DOCUMENT_DIMENSION_UNIT_UNSPECIFIED\x10\x00\x12\x08\n\x04INCH\x10\x01\x12\x0e\n\nCENTIMETER\x10\x02\x12\t\n\x05POINT\x10\x03"\xf9\x05\n\x08\x44ocument\x12\x46\n\x0cinput_config\x18\x01 \x01(\x0b\x32\x30.google.cloud.automl.v1beta1.DocumentInputConfig\x12?\n\rdocument_text\x18\x02 \x01(\x0b\x32(.google.cloud.automl.v1beta1.TextSnippet\x12<\n\x06layout\x18\x03 \x03(\x0b\x32,.google.cloud.automl.v1beta1.Document.Layout\x12L\n\x13\x64ocument_dimensions\x18\x04 \x01(\x0b\x32/.google.cloud.automl.v1beta1.DocumentDimensions\x12\x12\n\npage_count\x18\x05 \x01(\x05\x1a\xc3\x03\n\x06Layout\x12>\n\x0ctext_segment\x18\x01 \x01(\x0b\x32(.google.cloud.automl.v1beta1.TextSegment\x12\x13\n\x0bpage_number\x18\x02 \x01(\x05\x12@\n\rbounding_poly\x18\x03 \x01(\x0b\x32).google.cloud.automl.v1beta1.BoundingPoly\x12W\n\x11text_segment_type\x18\x04 \x01(\x0e\x32<.google.cloud.automl.v1beta1.Document.Layout.TextSegmentType"\xc8\x01\n\x0fTextSegmentType\x12!\n\x1dTEXT_SEGMENT_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05TOKEN\x10\x01\x12\r\n\tPARAGRAPH\x10\x02\x12\x0e\n\nFORM_FIELD\x10\x03\x12\x13\n\x0f\x46ORM_FIELD_NAME\x10\x04\x12\x17\n\x13\x46ORM_FIELD_CONTENTS\x10\x05\x12\t\n\x05TABLE\x10\x06\x12\x10\n\x0cTABLE_HEADER\x10\x07\x12\r\n\tTABLE_ROW\x10\x08\x12\x0e\n\nTABLE_CELL\x10\t"F\n\x03Row\x12\x17\n\x0f\x63olumn_spec_ids\x18\x02 \x03(\t\x12&\n\x06values\x18\x03 \x03(\x0b\x32\x16.google.protobuf.Value"\xfe\x01\n\x0e\x45xamplePayload\x12\x33\n\x05image\x18\x01 \x01(\x0b\x32".google.cloud.automl.v1beta1.ImageH\x00\x12@\n\x0ctext_snippet\x18\x02 \x01(\x0b\x32(.google.cloud.automl.v1beta1.TextSnippetH\x00\x12\x39\n\x08\x64ocument\x18\x04 \x01(\x0b\x32%.google.cloud.automl.v1beta1.DocumentH\x00\x12/\n\x03row\x18\x03 \x01(\x0b\x32 .google.cloud.automl.v1beta1.RowH\x00\x42\t\n\x07payloadB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__segment__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENTDIMENSIONS_DOCUMENTDIMENSIONUNIT = _descriptor.EnumDescriptor(
+    name="DocumentDimensionUnit",
+    full_name="google.cloud.automl.v1beta1.DocumentDimensions.DocumentDimensionUnit",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DOCUMENT_DIMENSION_UNIT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INCH", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CENTIMETER", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POINT", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=690,
+    serialized_end=791,
+)
+_sym_db.RegisterEnumDescriptor(_DOCUMENTDIMENSIONS_DOCUMENTDIMENSIONUNIT)
+
+_DOCUMENT_LAYOUT_TEXTSEGMENTTYPE = _descriptor.EnumDescriptor(
+    name="TextSegmentType",
+    full_name="google.cloud.automl.v1beta1.Document.Layout.TextSegmentType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_SEGMENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOKEN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARAGRAPH", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FORM_FIELD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FORM_FIELD_NAME",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FORM_FIELD_CONTENTS",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE_HEADER", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE_ROW", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE_CELL", index=9, number=9, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1355,
+    serialized_end=1555,
+)
+_sym_db.RegisterEnumDescriptor(_DOCUMENT_LAYOUT_TEXTSEGMENTTYPE)
+
+
+_IMAGE = _descriptor.Descriptor(
+    name="Image",
+    full_name="google.cloud.automl.v1beta1.Image",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_bytes",
+            full_name="google.cloud.automl.v1beta1.Image.image_bytes",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.automl.v1beta1.Image.input_config",
+            index=1,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="thumbnail_uri",
+            full_name="google.cloud.automl.v1beta1.Image.thumbnail_uri",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="data",
+            full_name="google.cloud.automl.v1beta1.Image.data",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=350,
+    serialized_end=477,
+)
+
+
+_TEXTSNIPPET = _descriptor.Descriptor(
+    name="TextSnippet",
+    full_name="google.cloud.automl.v1beta1.TextSnippet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.automl.v1beta1.TextSnippet.content",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.automl.v1beta1.TextSnippet.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_uri",
+            full_name="google.cloud.automl.v1beta1.TextSnippet.content_uri",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=479,
+    serialized_end=549,
+)
+
+
+_DOCUMENTDIMENSIONS = _descriptor.Descriptor(
+    name="DocumentDimensions",
+    full_name="google.cloud.automl.v1beta1.DocumentDimensions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="unit",
+            full_name="google.cloud.automl.v1beta1.DocumentDimensions.unit",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.cloud.automl.v1beta1.DocumentDimensions.width",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.cloud.automl.v1beta1.DocumentDimensions.height",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCUMENTDIMENSIONS_DOCUMENTDIMENSIONUNIT],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=552,
+    serialized_end=791,
+)
+
+
+_DOCUMENT_LAYOUT = _descriptor.Descriptor(
+    name="Layout",
+    full_name="google.cloud.automl.v1beta1.Document.Layout",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text_segment",
+            full_name="google.cloud.automl.v1beta1.Document.Layout.text_segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_number",
+            full_name="google.cloud.automl.v1beta1.Document.Layout.page_number",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.automl.v1beta1.Document.Layout.bounding_poly",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_segment_type",
+            full_name="google.cloud.automl.v1beta1.Document.Layout.text_segment_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCUMENT_LAYOUT_TEXTSEGMENTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1104,
+    serialized_end=1555,
+)
+
+_DOCUMENT = _descriptor.Descriptor(
+    name="Document",
+    full_name="google.cloud.automl.v1beta1.Document",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.automl.v1beta1.Document.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_text",
+            full_name="google.cloud.automl.v1beta1.Document.document_text",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="layout",
+            full_name="google.cloud.automl.v1beta1.Document.layout",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_dimensions",
+            full_name="google.cloud.automl.v1beta1.Document.document_dimensions",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_count",
+            full_name="google.cloud.automl.v1beta1.Document.page_count",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DOCUMENT_LAYOUT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=794,
+    serialized_end=1555,
+)
+
+
+_ROW = _descriptor.Descriptor(
+    name="Row",
+    full_name="google.cloud.automl.v1beta1.Row",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="column_spec_ids",
+            full_name="google.cloud.automl.v1beta1.Row.column_spec_ids",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.cloud.automl.v1beta1.Row.values",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1557,
+    serialized_end=1627,
+)
+
+
+_EXAMPLEPAYLOAD = _descriptor.Descriptor(
+    name="ExamplePayload",
+    full_name="google.cloud.automl.v1beta1.ExamplePayload",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.automl.v1beta1.ExamplePayload.image",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_snippet",
+            full_name="google.cloud.automl.v1beta1.ExamplePayload.text_snippet",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.automl.v1beta1.ExamplePayload.document",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row",
+            full_name="google.cloud.automl.v1beta1.ExamplePayload.row",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="payload",
+            full_name="google.cloud.automl.v1beta1.ExamplePayload.payload",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1630,
+    serialized_end=1884,
+)
+
+_IMAGE.fields_by_name[
+    "input_config"
+].message_type = google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._INPUTCONFIG
+_IMAGE.oneofs_by_name["data"].fields.append(_IMAGE.fields_by_name["image_bytes"])
+_IMAGE.fields_by_name["image_bytes"].containing_oneof = _IMAGE.oneofs_by_name["data"]
+_IMAGE.oneofs_by_name["data"].fields.append(_IMAGE.fields_by_name["input_config"])
+_IMAGE.fields_by_name["input_config"].containing_oneof = _IMAGE.oneofs_by_name["data"]
+_DOCUMENTDIMENSIONS.fields_by_name[
+    "unit"
+].enum_type = _DOCUMENTDIMENSIONS_DOCUMENTDIMENSIONUNIT
+_DOCUMENTDIMENSIONS_DOCUMENTDIMENSIONUNIT.containing_type = _DOCUMENTDIMENSIONS
+_DOCUMENT_LAYOUT.fields_by_name[
+    "text_segment"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__segment__pb2._TEXTSEGMENT
+)
+_DOCUMENT_LAYOUT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_DOCUMENT_LAYOUT.fields_by_name[
+    "text_segment_type"
+].enum_type = _DOCUMENT_LAYOUT_TEXTSEGMENTTYPE
+_DOCUMENT_LAYOUT.containing_type = _DOCUMENT
+_DOCUMENT_LAYOUT_TEXTSEGMENTTYPE.containing_type = _DOCUMENT_LAYOUT
+_DOCUMENT.fields_by_name[
+    "input_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._DOCUMENTINPUTCONFIG
+)
+_DOCUMENT.fields_by_name["document_text"].message_type = _TEXTSNIPPET
+_DOCUMENT.fields_by_name["layout"].message_type = _DOCUMENT_LAYOUT
+_DOCUMENT.fields_by_name["document_dimensions"].message_type = _DOCUMENTDIMENSIONS
+_ROW.fields_by_name["values"].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_EXAMPLEPAYLOAD.fields_by_name["image"].message_type = _IMAGE
+_EXAMPLEPAYLOAD.fields_by_name["text_snippet"].message_type = _TEXTSNIPPET
+_EXAMPLEPAYLOAD.fields_by_name["document"].message_type = _DOCUMENT
+_EXAMPLEPAYLOAD.fields_by_name["row"].message_type = _ROW
+_EXAMPLEPAYLOAD.oneofs_by_name["payload"].fields.append(
+    _EXAMPLEPAYLOAD.fields_by_name["image"]
+)
+_EXAMPLEPAYLOAD.fields_by_name[
+    "image"
+].containing_oneof = _EXAMPLEPAYLOAD.oneofs_by_name["payload"]
+_EXAMPLEPAYLOAD.oneofs_by_name["payload"].fields.append(
+    _EXAMPLEPAYLOAD.fields_by_name["text_snippet"]
+)
+_EXAMPLEPAYLOAD.fields_by_name[
+    "text_snippet"
+].containing_oneof = _EXAMPLEPAYLOAD.oneofs_by_name["payload"]
+_EXAMPLEPAYLOAD.oneofs_by_name["payload"].fields.append(
+    _EXAMPLEPAYLOAD.fields_by_name["document"]
+)
+_EXAMPLEPAYLOAD.fields_by_name[
+    "document"
+].containing_oneof = _EXAMPLEPAYLOAD.oneofs_by_name["payload"]
+_EXAMPLEPAYLOAD.oneofs_by_name["payload"].fields.append(
+    _EXAMPLEPAYLOAD.fields_by_name["row"]
+)
+_EXAMPLEPAYLOAD.fields_by_name["row"].containing_oneof = _EXAMPLEPAYLOAD.oneofs_by_name[
+    "payload"
+]
+DESCRIPTOR.message_types_by_name["Image"] = _IMAGE
+DESCRIPTOR.message_types_by_name["TextSnippet"] = _TEXTSNIPPET
+DESCRIPTOR.message_types_by_name["DocumentDimensions"] = _DOCUMENTDIMENSIONS
+DESCRIPTOR.message_types_by_name["Document"] = _DOCUMENT
+DESCRIPTOR.message_types_by_name["Row"] = _ROW
+DESCRIPTOR.message_types_by_name["ExamplePayload"] = _EXAMPLEPAYLOAD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Image = _reflection.GeneratedProtocolMessageType(
+    "Image",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGE,
+        __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+        __doc__="""A representation of an image. Only images up to 30MB in size are
+  supported.
+  
+  
+  Attributes:
+      data:
+          Input only. The data representing the image. For Predict calls
+          [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.
+      image_bytes:
+          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.
+      input_config:
+          An input config specifying the content of the image.
+      thumbnail_uri:
+          Output only. HTTP URI to the thumbnail image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Image)
+    ),
+)
+_sym_db.RegisterMessage(Image)
+
+TextSnippet = _reflection.GeneratedProtocolMessageType(
+    "TextSnippet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSNIPPET,
+        __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+        __doc__="""A representation of a text snippet.
+  
+  
+  Attributes:
+      content:
+          Required. The content of the text snippet as a string. Up to
+          250000 characters long.
+      mime_type:
+          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].
+      content_uri:
+          Output only. HTTP URI where you can download the content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextSnippet)
+    ),
+)
+_sym_db.RegisterMessage(TextSnippet)
+
+DocumentDimensions = _reflection.GeneratedProtocolMessageType(
+    "DocumentDimensions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTDIMENSIONS,
+        __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+        __doc__="""Message that describes dimension of a document.
+  
+  
+  Attributes:
+      unit:
+          Unit of the dimension.
+      width:
+          Width value of the document, works together with the unit.
+      height:
+          Height value of the document, works together with the unit.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DocumentDimensions)
+    ),
+)
+_sym_db.RegisterMessage(DocumentDimensions)
+
+Document = _reflection.GeneratedProtocolMessageType(
+    "Document",
+    (_message.Message,),
+    dict(
+        Layout=_reflection.GeneratedProtocolMessageType(
+            "Layout",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DOCUMENT_LAYOUT,
+                __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+                __doc__="""Describes the layout information of a
+    [text\_segment][google.cloud.automl.v1beta1.Document.Layout.text\_segment]
+    in the document.
+    
+    
+    Attributes:
+        text_segment:
+            Text Segment that represents a segment in [document\_text][goo
+            gle.cloud.automl.v1beta1.Document.document\_text].
+        page_number:
+            Page number of the [text\_segment][google.cloud.automl.v1beta1
+            .Document.Layout.text\_segment] in the original document,
+            starts from 1.
+        bounding_poly:
+            The position of the [text\_segment][google.cloud.automl.v1beta
+            1.Document.Layout.text\_segment] in the page. Contains exactly
+            4  [normalized\_vertices][google.cloud.automl.v1beta1.Bounding
+            Poly.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.v1b
+            eta1.NormalizedVertex] are relative to the page. Coordinates
+            are based on top-left as point (0,0).
+        text_segment_type:
+            The type of the [text\_segment][google.cloud.automl.v1beta1.Do
+            cument.Layout.text\_segment] in document.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Document.Layout)
+            ),
+        ),
+        DESCRIPTOR=_DOCUMENT,
+        __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+        __doc__="""A structured text document e.g. a PDF.
+  
+  
+  Attributes:
+      input_config:
+          An input config specifying the content of the document.
+      document_text:
+          The plain text version of this document.
+      layout:
+          Describes the layout of the document. Sorted by
+          [page\_number][].
+      document_dimensions:
+          The dimensions of the page in the document.
+      page_count:
+          Number of pages in the document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Document)
+    ),
+)
+_sym_db.RegisterMessage(Document)
+_sym_db.RegisterMessage(Document.Layout)
+
+Row = _reflection.GeneratedProtocolMessageType(
+    "Row",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROW,
+        __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+        __doc__="""A representation of a row in a relational table.
+  
+  
+  Attributes:
+      column_spec_ids:
+          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  [column\_spec\_ids][google.cloud.aut
+          oml.v1beta1.TablesModelMetadata.input\_feature\_column\_specs]
+          of the Model this row is being passed to. Note: The below
+          ``values`` field must match order of this field, if this field
+          is set.
+      values:
+          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.v1
+          beta1.TablesModelMetadata.input\_feature\_column\_specs] of
+          the Model this row is being passed to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Row)
+    ),
+)
+_sym_db.RegisterMessage(Row)
+
+ExamplePayload = _reflection.GeneratedProtocolMessageType(
+    "ExamplePayload",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXAMPLEPAYLOAD,
+        __module__="google.cloud.automl_v1beta1.proto.data_items_pb2",
+        __doc__="""Example data used for training or prediction.
+  
+  
+  Attributes:
+      payload:
+          Required. Input only. The example data.
+      image:
+          Example image.
+      text_snippet:
+          Example text.
+      document:
+          Example document.
+      row:
+          Example relational table row.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExamplePayload)
+    ),
+)
+_sym_db.RegisterMessage(ExamplePayload)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_items_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/data_items_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_items_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_stats.proto b/automl/google/cloud/automl_v1beta1/proto/data_stats.proto
new file mode 100644
index 000000000000..5d941a5baa81
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_stats.proto
@@ -0,0 +1,167 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// The data statistics of a series of values that share the same DataType.
+message DataStats {
+  // The data statistics specific to a DataType.
+  oneof stats {
+    // The statistics for FLOAT64 DataType.
+    Float64Stats float64_stats = 3;
+
+    // The statistics for STRING DataType.
+    StringStats string_stats = 4;
+
+    // The statistics for TIMESTAMP DataType.
+    TimestampStats timestamp_stats = 5;
+
+    // The statistics for ARRAY DataType.
+    ArrayStats array_stats = 6;
+
+    // The statistics for STRUCT DataType.
+    StructStats struct_stats = 7;
+
+    // The statistics for CATEGORY DataType.
+    CategoryStats category_stats = 8;
+  }
+
+  // The number of distinct values.
+  int64 distinct_value_count = 1;
+
+  // The number of values that are null.
+  int64 null_value_count = 2;
+
+  // The number of values that are valid.
+  int64 valid_value_count = 9;
+}
+
+// The data statistics of a series of FLOAT64 values.
+message Float64Stats {
+  // A bucket of a histogram.
+  message HistogramBucket {
+    // The minimum value of the bucket, inclusive.
+    double min = 1;
+
+    // The maximum value of the bucket, exclusive unless max = `"Infinity"`, in
+    // which case it's inclusive.
+    double max = 2;
+
+    // The number of data values that are in the bucket, i.e. are between
+    // min and max values.
+    int64 count = 3;
+  }
+
+  // The mean of the series.
+  double mean = 1;
+
+  // The standard deviation of the series.
+  double standard_deviation = 2;
+
+  // Ordered from 0 to k k-quantile values of the data series of n values.
+  // The value at index i is, approximately, the i*n/k-th smallest value in the
+  // series; for i = 0 and i = k these are, respectively, the min and max
+  // values.
+  repeated double quantiles = 3;
+
+  // Histogram buckets of the data series. Sorted by the min value of the
+  // bucket, ascendingly, and the number of the buckets is dynamically
+  // generated. The buckets are non-overlapping and completely cover whole
+  // FLOAT64 range with min of first bucket being `"-Infinity"`, and max of
+  // the last one being `"Infinity"`.
+  repeated HistogramBucket histogram_buckets = 4;
+}
+
+// The data statistics of a series of STRING values.
+message StringStats {
+  // The statistics of a unigram.
+  message UnigramStats {
+    // The unigram.
+    string value = 1;
+
+    // The number of occurrences of this unigram in the series.
+    int64 count = 2;
+  }
+
+  // The statistics of the top 20 unigrams, ordered by
+  // [count][google.cloud.automl.v1beta1.StringStats.UnigramStats.count].
+  repeated UnigramStats top_unigram_stats = 1;
+}
+
+// The data statistics of a series of TIMESTAMP values.
+message TimestampStats {
+  // Stats split by a defined in context granularity.
+  message GranularStats {
+    // A map from granularity key to example count for that key.
+    // E.g. for hour_of_day `13` means 1pm, or for month_of_year `5` means May).
+    map<int32, int64> buckets = 1;
+  }
+
+  // The string key is the pre-defined granularity. Currently supported:
+  // hour_of_day, day_of_week, month_of_year.
+  // Granularities finer that the granularity of timestamp data are not
+  // populated (e.g. if timestamps are at day granularity, then hour_of_day
+  // is not populated).
+  map<string, GranularStats> granular_stats = 1;
+}
+
+// The data statistics of a series of ARRAY values.
+message ArrayStats {
+  // Stats of all the values of all arrays, as if they were a single long
+  // series of data. The type depends on the element type of the array.
+  DataStats member_stats = 2;
+}
+
+// The data statistics of a series of STRUCT values.
+message StructStats {
+  // Map from a field name of the struct to data stats aggregated over series
+  // of all data in that field across all the structs.
+  map<string, DataStats> field_stats = 1;
+}
+
+// The data statistics of a series of CATEGORY values.
+message CategoryStats {
+  // The statistics of a single CATEGORY value.
+  message SingleCategoryStats {
+    // The CATEGORY value.
+    string value = 1;
+
+    // The number of occurrences of this value in the series.
+    int64 count = 2;
+  }
+
+  // The statistics of the top 20 CATEGORY values, ordered by
+  //
+  // [count][google.cloud.automl.v1beta1.CategoryStats.SingleCategoryStats.count].
+  repeated SingleCategoryStats top_category_stats = 1;
+}
+
+// A correlation statistics between two series of DataType values. The series
+// may have differing DataType-s, but within a single series the DataType must
+// be the same.
+message CorrelationStats {
+  // The correlation value using the Cramer's V measure.
+  double cramers_v = 1;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2.py b/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2.py
new file mode 100644
index 000000000000..f0415f19ae5d
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2.py
@@ -0,0 +1,1329 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/data_stats.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/data_stats.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/automl_v1beta1/proto/data_stats.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"\xfd\x03\n\tDataStats\x12\x42\n\rfloat64_stats\x18\x03 \x01(\x0b\x32).google.cloud.automl.v1beta1.Float64StatsH\x00\x12@\n\x0cstring_stats\x18\x04 \x01(\x0b\x32(.google.cloud.automl.v1beta1.StringStatsH\x00\x12\x46\n\x0ftimestamp_stats\x18\x05 \x01(\x0b\x32+.google.cloud.automl.v1beta1.TimestampStatsH\x00\x12>\n\x0b\x61rray_stats\x18\x06 \x01(\x0b\x32\'.google.cloud.automl.v1beta1.ArrayStatsH\x00\x12@\n\x0cstruct_stats\x18\x07 \x01(\x0b\x32(.google.cloud.automl.v1beta1.StructStatsH\x00\x12\x44\n\x0e\x63\x61tegory_stats\x18\x08 \x01(\x0b\x32*.google.cloud.automl.v1beta1.CategoryStatsH\x00\x12\x1c\n\x14\x64istinct_value_count\x18\x01 \x01(\x03\x12\x18\n\x10null_value_count\x18\x02 \x01(\x03\x12\x19\n\x11valid_value_count\x18\t \x01(\x03\x42\x07\n\x05stats"\xdd\x01\n\x0c\x46loat64Stats\x12\x0c\n\x04mean\x18\x01 \x01(\x01\x12\x1a\n\x12standard_deviation\x18\x02 \x01(\x01\x12\x11\n\tquantiles\x18\x03 \x03(\x01\x12T\n\x11histogram_buckets\x18\x04 \x03(\x0b\x32\x39.google.cloud.automl.v1beta1.Float64Stats.HistogramBucket\x1a:\n\x0fHistogramBucket\x12\x0b\n\x03min\x18\x01 \x01(\x01\x12\x0b\n\x03max\x18\x02 \x01(\x01\x12\r\n\x05\x63ount\x18\x03 \x01(\x03"\x8d\x01\n\x0bStringStats\x12P\n\x11top_unigram_stats\x18\x01 \x03(\x0b\x32\x35.google.cloud.automl.v1beta1.StringStats.UnigramStats\x1a,\n\x0cUnigramStats\x12\r\n\x05value\x18\x01 \x01(\t\x12\r\n\x05\x63ount\x18\x02 \x01(\x03"\xf4\x02\n\x0eTimestampStats\x12V\n\x0egranular_stats\x18\x01 \x03(\x0b\x32>.google.cloud.automl.v1beta1.TimestampStats.GranularStatsEntry\x1a\x98\x01\n\rGranularStats\x12W\n\x07\x62uckets\x18\x01 \x03(\x0b\x32\x46.google.cloud.automl.v1beta1.TimestampStats.GranularStats.BucketsEntry\x1a.\n\x0c\x42ucketsEntry\x12\x0b\n\x03key\x18\x01 \x01(\x05\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01\x1ao\n\x12GranularStatsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12H\n\x05value\x18\x02 \x01(\x0b\x32\x39.google.cloud.automl.v1beta1.TimestampStats.GranularStats:\x02\x38\x01"J\n\nArrayStats\x12<\n\x0cmember_stats\x18\x02 \x01(\x0b\x32&.google.cloud.automl.v1beta1.DataStats"\xb7\x01\n\x0bStructStats\x12M\n\x0b\x66ield_stats\x18\x01 \x03(\x0b\x32\x38.google.cloud.automl.v1beta1.StructStats.FieldStatsEntry\x1aY\n\x0f\x46ieldStatsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x35\n\x05value\x18\x02 \x01(\x0b\x32&.google.cloud.automl.v1beta1.DataStats:\x02\x38\x01"\xa0\x01\n\rCategoryStats\x12Z\n\x12top_category_stats\x18\x01 \x03(\x0b\x32>.google.cloud.automl.v1beta1.CategoryStats.SingleCategoryStats\x1a\x33\n\x13SingleCategoryStats\x12\r\n\x05value\x18\x01 \x01(\t\x12\r\n\x05\x63ount\x18\x02 \x01(\x03"%\n\x10\x43orrelationStats\x12\x11\n\tcramers_v\x18\x01 \x01(\x01\x42\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_DATASTATS = _descriptor.Descriptor(
+    name="DataStats",
+    full_name="google.cloud.automl.v1beta1.DataStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="float64_stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.float64_stats",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.string_stats",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.timestamp_stats",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.array_stats",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="struct_stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.struct_stats",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category_stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.category_stats",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distinct_value_count",
+            full_name="google.cloud.automl.v1beta1.DataStats.distinct_value_count",
+            index=6,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="null_value_count",
+            full_name="google.cloud.automl.v1beta1.DataStats.null_value_count",
+            index=7,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_value_count",
+            full_name="google.cloud.automl.v1beta1.DataStats.valid_value_count",
+            index=8,
+            number=9,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="stats",
+            full_name="google.cloud.automl.v1beta1.DataStats.stats",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=114,
+    serialized_end=623,
+)
+
+
+_FLOAT64STATS_HISTOGRAMBUCKET = _descriptor.Descriptor(
+    name="HistogramBucket",
+    full_name="google.cloud.automl.v1beta1.Float64Stats.HistogramBucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.HistogramBucket.min",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.HistogramBucket.max",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.HistogramBucket.count",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=789,
+    serialized_end=847,
+)
+
+_FLOAT64STATS = _descriptor.Descriptor(
+    name="Float64Stats",
+    full_name="google.cloud.automl.v1beta1.Float64Stats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mean",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.mean",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="standard_deviation",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.standard_deviation",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quantiles",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.quantiles",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="histogram_buckets",
+            full_name="google.cloud.automl.v1beta1.Float64Stats.histogram_buckets",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FLOAT64STATS_HISTOGRAMBUCKET],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=626,
+    serialized_end=847,
+)
+
+
+_STRINGSTATS_UNIGRAMSTATS = _descriptor.Descriptor(
+    name="UnigramStats",
+    full_name="google.cloud.automl.v1beta1.StringStats.UnigramStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.StringStats.UnigramStats.value",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.automl.v1beta1.StringStats.UnigramStats.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=947,
+    serialized_end=991,
+)
+
+_STRINGSTATS = _descriptor.Descriptor(
+    name="StringStats",
+    full_name="google.cloud.automl.v1beta1.StringStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="top_unigram_stats",
+            full_name="google.cloud.automl.v1beta1.StringStats.top_unigram_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_STRINGSTATS_UNIGRAMSTATS],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=850,
+    serialized_end=991,
+)
+
+
+_TIMESTAMPSTATS_GRANULARSTATS_BUCKETSENTRY = _descriptor.Descriptor(
+    name="BucketsEntry",
+    full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStats.BucketsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStats.BucketsEntry.key",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStats.BucketsEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1207,
+    serialized_end=1253,
+)
+
+_TIMESTAMPSTATS_GRANULARSTATS = _descriptor.Descriptor(
+    name="GranularStats",
+    full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="buckets",
+            full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStats.buckets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_TIMESTAMPSTATS_GRANULARSTATS_BUCKETSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1101,
+    serialized_end=1253,
+)
+
+_TIMESTAMPSTATS_GRANULARSTATSENTRY = _descriptor.Descriptor(
+    name="GranularStatsEntry",
+    full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStatsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStatsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.TimestampStats.GranularStatsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1255,
+    serialized_end=1366,
+)
+
+_TIMESTAMPSTATS = _descriptor.Descriptor(
+    name="TimestampStats",
+    full_name="google.cloud.automl.v1beta1.TimestampStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="granular_stats",
+            full_name="google.cloud.automl.v1beta1.TimestampStats.granular_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_TIMESTAMPSTATS_GRANULARSTATS, _TIMESTAMPSTATS_GRANULARSTATSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=994,
+    serialized_end=1366,
+)
+
+
+_ARRAYSTATS = _descriptor.Descriptor(
+    name="ArrayStats",
+    full_name="google.cloud.automl.v1beta1.ArrayStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="member_stats",
+            full_name="google.cloud.automl.v1beta1.ArrayStats.member_stats",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1368,
+    serialized_end=1442,
+)
+
+
+_STRUCTSTATS_FIELDSTATSENTRY = _descriptor.Descriptor(
+    name="FieldStatsEntry",
+    full_name="google.cloud.automl.v1beta1.StructStats.FieldStatsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.StructStats.FieldStatsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.StructStats.FieldStatsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1539,
+    serialized_end=1628,
+)
+
+_STRUCTSTATS = _descriptor.Descriptor(
+    name="StructStats",
+    full_name="google.cloud.automl.v1beta1.StructStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_stats",
+            full_name="google.cloud.automl.v1beta1.StructStats.field_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_STRUCTSTATS_FIELDSTATSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1445,
+    serialized_end=1628,
+)
+
+
+_CATEGORYSTATS_SINGLECATEGORYSTATS = _descriptor.Descriptor(
+    name="SingleCategoryStats",
+    full_name="google.cloud.automl.v1beta1.CategoryStats.SingleCategoryStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.CategoryStats.SingleCategoryStats.value",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.automl.v1beta1.CategoryStats.SingleCategoryStats.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1740,
+    serialized_end=1791,
+)
+
+_CATEGORYSTATS = _descriptor.Descriptor(
+    name="CategoryStats",
+    full_name="google.cloud.automl.v1beta1.CategoryStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="top_category_stats",
+            full_name="google.cloud.automl.v1beta1.CategoryStats.top_category_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_CATEGORYSTATS_SINGLECATEGORYSTATS],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1631,
+    serialized_end=1791,
+)
+
+
+_CORRELATIONSTATS = _descriptor.Descriptor(
+    name="CorrelationStats",
+    full_name="google.cloud.automl.v1beta1.CorrelationStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cramers_v",
+            full_name="google.cloud.automl.v1beta1.CorrelationStats.cramers_v",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1793,
+    serialized_end=1830,
+)
+
+_DATASTATS.fields_by_name["float64_stats"].message_type = _FLOAT64STATS
+_DATASTATS.fields_by_name["string_stats"].message_type = _STRINGSTATS
+_DATASTATS.fields_by_name["timestamp_stats"].message_type = _TIMESTAMPSTATS
+_DATASTATS.fields_by_name["array_stats"].message_type = _ARRAYSTATS
+_DATASTATS.fields_by_name["struct_stats"].message_type = _STRUCTSTATS
+_DATASTATS.fields_by_name["category_stats"].message_type = _CATEGORYSTATS
+_DATASTATS.oneofs_by_name["stats"].fields.append(
+    _DATASTATS.fields_by_name["float64_stats"]
+)
+_DATASTATS.fields_by_name["float64_stats"].containing_oneof = _DATASTATS.oneofs_by_name[
+    "stats"
+]
+_DATASTATS.oneofs_by_name["stats"].fields.append(
+    _DATASTATS.fields_by_name["string_stats"]
+)
+_DATASTATS.fields_by_name["string_stats"].containing_oneof = _DATASTATS.oneofs_by_name[
+    "stats"
+]
+_DATASTATS.oneofs_by_name["stats"].fields.append(
+    _DATASTATS.fields_by_name["timestamp_stats"]
+)
+_DATASTATS.fields_by_name[
+    "timestamp_stats"
+].containing_oneof = _DATASTATS.oneofs_by_name["stats"]
+_DATASTATS.oneofs_by_name["stats"].fields.append(
+    _DATASTATS.fields_by_name["array_stats"]
+)
+_DATASTATS.fields_by_name["array_stats"].containing_oneof = _DATASTATS.oneofs_by_name[
+    "stats"
+]
+_DATASTATS.oneofs_by_name["stats"].fields.append(
+    _DATASTATS.fields_by_name["struct_stats"]
+)
+_DATASTATS.fields_by_name["struct_stats"].containing_oneof = _DATASTATS.oneofs_by_name[
+    "stats"
+]
+_DATASTATS.oneofs_by_name["stats"].fields.append(
+    _DATASTATS.fields_by_name["category_stats"]
+)
+_DATASTATS.fields_by_name[
+    "category_stats"
+].containing_oneof = _DATASTATS.oneofs_by_name["stats"]
+_FLOAT64STATS_HISTOGRAMBUCKET.containing_type = _FLOAT64STATS
+_FLOAT64STATS.fields_by_name[
+    "histogram_buckets"
+].message_type = _FLOAT64STATS_HISTOGRAMBUCKET
+_STRINGSTATS_UNIGRAMSTATS.containing_type = _STRINGSTATS
+_STRINGSTATS.fields_by_name[
+    "top_unigram_stats"
+].message_type = _STRINGSTATS_UNIGRAMSTATS
+_TIMESTAMPSTATS_GRANULARSTATS_BUCKETSENTRY.containing_type = (
+    _TIMESTAMPSTATS_GRANULARSTATS
+)
+_TIMESTAMPSTATS_GRANULARSTATS.fields_by_name[
+    "buckets"
+].message_type = _TIMESTAMPSTATS_GRANULARSTATS_BUCKETSENTRY
+_TIMESTAMPSTATS_GRANULARSTATS.containing_type = _TIMESTAMPSTATS
+_TIMESTAMPSTATS_GRANULARSTATSENTRY.fields_by_name[
+    "value"
+].message_type = _TIMESTAMPSTATS_GRANULARSTATS
+_TIMESTAMPSTATS_GRANULARSTATSENTRY.containing_type = _TIMESTAMPSTATS
+_TIMESTAMPSTATS.fields_by_name[
+    "granular_stats"
+].message_type = _TIMESTAMPSTATS_GRANULARSTATSENTRY
+_ARRAYSTATS.fields_by_name["member_stats"].message_type = _DATASTATS
+_STRUCTSTATS_FIELDSTATSENTRY.fields_by_name["value"].message_type = _DATASTATS
+_STRUCTSTATS_FIELDSTATSENTRY.containing_type = _STRUCTSTATS
+_STRUCTSTATS.fields_by_name["field_stats"].message_type = _STRUCTSTATS_FIELDSTATSENTRY
+_CATEGORYSTATS_SINGLECATEGORYSTATS.containing_type = _CATEGORYSTATS
+_CATEGORYSTATS.fields_by_name[
+    "top_category_stats"
+].message_type = _CATEGORYSTATS_SINGLECATEGORYSTATS
+DESCRIPTOR.message_types_by_name["DataStats"] = _DATASTATS
+DESCRIPTOR.message_types_by_name["Float64Stats"] = _FLOAT64STATS
+DESCRIPTOR.message_types_by_name["StringStats"] = _STRINGSTATS
+DESCRIPTOR.message_types_by_name["TimestampStats"] = _TIMESTAMPSTATS
+DESCRIPTOR.message_types_by_name["ArrayStats"] = _ARRAYSTATS
+DESCRIPTOR.message_types_by_name["StructStats"] = _STRUCTSTATS
+DESCRIPTOR.message_types_by_name["CategoryStats"] = _CATEGORYSTATS
+DESCRIPTOR.message_types_by_name["CorrelationStats"] = _CORRELATIONSTATS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DataStats = _reflection.GeneratedProtocolMessageType(
+    "DataStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of values that share the same DataType.
+  
+  
+  Attributes:
+      stats:
+          The data statistics specific to a DataType.
+      float64_stats:
+          The statistics for FLOAT64 DataType.
+      string_stats:
+          The statistics for STRING DataType.
+      timestamp_stats:
+          The statistics for TIMESTAMP DataType.
+      array_stats:
+          The statistics for ARRAY DataType.
+      struct_stats:
+          The statistics for STRUCT DataType.
+      category_stats:
+          The statistics for CATEGORY DataType.
+      distinct_value_count:
+          The number of distinct values.
+      null_value_count:
+          The number of values that are null.
+      valid_value_count:
+          The number of values that are valid.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DataStats)
+    ),
+)
+_sym_db.RegisterMessage(DataStats)
+
+Float64Stats = _reflection.GeneratedProtocolMessageType(
+    "Float64Stats",
+    (_message.Message,),
+    dict(
+        HistogramBucket=_reflection.GeneratedProtocolMessageType(
+            "HistogramBucket",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FLOAT64STATS_HISTOGRAMBUCKET,
+                __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+                __doc__="""A bucket of a histogram.
+    
+    
+    Attributes:
+        min:
+            The minimum value of the bucket, inclusive.
+        max:
+            The maximum value of the bucket, exclusive unless max =
+            ``"Infinity"``, in which case it's inclusive.
+        count:
+            The number of data values that are in the bucket, i.e. are
+            between min and max values.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Float64Stats.HistogramBucket)
+            ),
+        ),
+        DESCRIPTOR=_FLOAT64STATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of FLOAT64 values.
+  
+  
+  Attributes:
+      mean:
+          The mean of the series.
+      standard_deviation:
+          The standard deviation of the series.
+      quantiles:
+          Ordered from 0 to k k-quantile values of the data series of n
+          values. The value at index i is, approximately, the i\*n/k-th
+          smallest value in the series; for i = 0 and i = k these are,
+          respectively, the min and max values.
+      histogram_buckets:
+          Histogram buckets of the data series. Sorted by the min value
+          of the bucket, ascendingly, and the number of the buckets is
+          dynamically generated. The buckets are non-overlapping and
+          completely cover whole FLOAT64 range with min of first bucket
+          being ``"-Infinity"``, and max of the last one being
+          ``"Infinity"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Float64Stats)
+    ),
+)
+_sym_db.RegisterMessage(Float64Stats)
+_sym_db.RegisterMessage(Float64Stats.HistogramBucket)
+
+StringStats = _reflection.GeneratedProtocolMessageType(
+    "StringStats",
+    (_message.Message,),
+    dict(
+        UnigramStats=_reflection.GeneratedProtocolMessageType(
+            "UnigramStats",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRINGSTATS_UNIGRAMSTATS,
+                __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+                __doc__="""The statistics of a unigram.
+    
+    
+    Attributes:
+        value:
+            The unigram.
+        count:
+            The number of occurrences of this unigram in the series.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.StringStats.UnigramStats)
+            ),
+        ),
+        DESCRIPTOR=_STRINGSTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of STRING values.
+  
+  
+  Attributes:
+      top_unigram_stats:
+          The statistics of the top 20 unigrams, ordered by [count][goog
+          le.cloud.automl.v1beta1.StringStats.UnigramStats.count].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.StringStats)
+    ),
+)
+_sym_db.RegisterMessage(StringStats)
+_sym_db.RegisterMessage(StringStats.UnigramStats)
+
+TimestampStats = _reflection.GeneratedProtocolMessageType(
+    "TimestampStats",
+    (_message.Message,),
+    dict(
+        GranularStats=_reflection.GeneratedProtocolMessageType(
+            "GranularStats",
+            (_message.Message,),
+            dict(
+                BucketsEntry=_reflection.GeneratedProtocolMessageType(
+                    "BucketsEntry",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_TIMESTAMPSTATS_GRANULARSTATS_BUCKETSENTRY,
+                        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2"
+                        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TimestampStats.GranularStats.BucketsEntry)
+                    ),
+                ),
+                DESCRIPTOR=_TIMESTAMPSTATS_GRANULARSTATS,
+                __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+                __doc__="""Stats split by a defined in context granularity.
+    
+    
+    Attributes:
+        buckets:
+            A map from granularity key to example count for that key. E.g.
+            for hour\_of\_day ``13`` means 1pm, or for month\_of\_year
+            ``5`` means May).
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TimestampStats.GranularStats)
+            ),
+        ),
+        GranularStatsEntry=_reflection.GeneratedProtocolMessageType(
+            "GranularStatsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TIMESTAMPSTATS_GRANULARSTATSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TimestampStats.GranularStatsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TIMESTAMPSTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of TIMESTAMP values.
+  
+  
+  Attributes:
+      granular_stats:
+          The string key is the pre-defined granularity. Currently
+          supported: hour\_of\_day, day\_of\_week, month\_of\_year.
+          Granularities finer that the granularity of timestamp data are
+          not populated (e.g. if timestamps are at day granularity, then
+          hour\_of\_day is not populated).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TimestampStats)
+    ),
+)
+_sym_db.RegisterMessage(TimestampStats)
+_sym_db.RegisterMessage(TimestampStats.GranularStats)
+_sym_db.RegisterMessage(TimestampStats.GranularStats.BucketsEntry)
+_sym_db.RegisterMessage(TimestampStats.GranularStatsEntry)
+
+ArrayStats = _reflection.GeneratedProtocolMessageType(
+    "ArrayStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARRAYSTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of ARRAY values.
+  
+  
+  Attributes:
+      member_stats:
+          Stats of all the values of all arrays, as if they were a
+          single long series of data. The type depends on the element
+          type of the array.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ArrayStats)
+    ),
+)
+_sym_db.RegisterMessage(ArrayStats)
+
+StructStats = _reflection.GeneratedProtocolMessageType(
+    "StructStats",
+    (_message.Message,),
+    dict(
+        FieldStatsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldStatsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTSTATS_FIELDSTATSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.StructStats.FieldStatsEntry)
+            ),
+        ),
+        DESCRIPTOR=_STRUCTSTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of STRUCT values.
+  
+  
+  Attributes:
+      field_stats:
+          Map from a field name of the struct to data stats aggregated
+          over series of all data in that field across all the structs.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.StructStats)
+    ),
+)
+_sym_db.RegisterMessage(StructStats)
+_sym_db.RegisterMessage(StructStats.FieldStatsEntry)
+
+CategoryStats = _reflection.GeneratedProtocolMessageType(
+    "CategoryStats",
+    (_message.Message,),
+    dict(
+        SingleCategoryStats=_reflection.GeneratedProtocolMessageType(
+            "SingleCategoryStats",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CATEGORYSTATS_SINGLECATEGORYSTATS,
+                __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+                __doc__="""The statistics of a single CATEGORY value.
+    
+    
+    Attributes:
+        value:
+            The CATEGORY value.
+        count:
+            The number of occurrences of this value in the series.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.CategoryStats.SingleCategoryStats)
+            ),
+        ),
+        DESCRIPTOR=_CATEGORYSTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""The data statistics of a series of CATEGORY values.
+  
+  
+  Attributes:
+      top_category_stats:
+          The statistics of the top 20 CATEGORY values, ordered by  [cou
+          nt][google.cloud.automl.v1beta1.CategoryStats.SingleCategorySt
+          ats.count].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.CategoryStats)
+    ),
+)
+_sym_db.RegisterMessage(CategoryStats)
+_sym_db.RegisterMessage(CategoryStats.SingleCategoryStats)
+
+CorrelationStats = _reflection.GeneratedProtocolMessageType(
+    "CorrelationStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CORRELATIONSTATS,
+        __module__="google.cloud.automl_v1beta1.proto.data_stats_pb2",
+        __doc__="""A correlation statistics between two series of DataType values. The
+  series may have differing DataType-s, but within a single series the
+  DataType must be the same.
+  
+  
+  Attributes:
+      cramers_v:
+          The correlation value using the Cramer's V measure.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.CorrelationStats)
+    ),
+)
+_sym_db.RegisterMessage(CorrelationStats)
+
+
+DESCRIPTOR._options = None
+_TIMESTAMPSTATS_GRANULARSTATS_BUCKETSENTRY._options = None
+_TIMESTAMPSTATS_GRANULARSTATSENTRY._options = None
+_STRUCTSTATS_FIELDSTATSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_stats_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_types.proto b/automl/google/cloud/automl_v1beta1/proto/data_types.proto
new file mode 100644
index 000000000000..086e96e32629
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_types.proto
@@ -0,0 +1,106 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// `TypeCode` is used as a part of
+// [DataType][google.cloud.automl.v1beta1.DataType].
+enum TypeCode {
+  // Not specified. Should not be used.
+  TYPE_CODE_UNSPECIFIED = 0;
+
+  // Encoded as `number`, or the strings `"NaN"`, `"Infinity"`, or
+  // `"-Infinity"`.
+  FLOAT64 = 3;
+
+  // Must be between 0AD and 9999AD. Encoded as `string` according to
+  // [time_format][google.cloud.automl.v1beta1.DataType.time_format], or, if
+  // that format is not set, then in RFC 3339 `date-time` format, where
+  // `time-offset` = `"Z"` (e.g. 1985-04-12T23:20:50.52Z).
+  TIMESTAMP = 4;
+
+  // Encoded as `string`.
+  STRING = 6;
+
+  // Encoded as `list`, where the list elements are represented according to
+  //
+  // [list_element_type][google.cloud.automl.v1beta1.DataType.list_element_type].
+  ARRAY = 8;
+
+  // Encoded as `struct`, where field values are represented according to
+  // [struct_type][google.cloud.automl.v1beta1.DataType.struct_type].
+  STRUCT = 9;
+
+  // Values of this type are not further understood by AutoML,
+  // e.g. AutoML is unable to tell the order of values (as it could with
+  // FLOAT64), or is unable to say if one value contains another (as it
+  // could with STRING).
+  // Encoded as `string` (bytes should be base64-encoded, as described in RFC
+  // 4648, section 4).
+  CATEGORY = 10;
+}
+
+// Indicated the type of data that can be stored in a structured data entity
+// (e.g. a table).
+message DataType {
+  // Details of DataType-s that need additional specification.
+  oneof details {
+    // If [type_code][google.cloud.automl.v1beta1.DataType.type_code] == [ARRAY][google.cloud.automl.v1beta1.TypeCode.ARRAY],
+    // then `list_element_type` is the type of the elements.
+    DataType list_element_type = 2;
+
+    // If [type_code][google.cloud.automl.v1beta1.DataType.type_code] == [STRUCT][google.cloud.automl.v1beta1.TypeCode.STRUCT], then `struct_type`
+    // provides type information for the struct's fields.
+    StructType struct_type = 3;
+
+    // If [type_code][google.cloud.automl.v1beta1.DataType.type_code] == [TIMESTAMP][google.cloud.automl.v1beta1.TypeCode.TIMESTAMP]
+    // then `time_format` provides the format in which that time field is
+    // expressed. The time_format must either be one of:
+    // * `UNIX_SECONDS`
+    // * `UNIX_MILLISECONDS`
+    // * `UNIX_MICROSECONDS`
+    // * `UNIX_NANOSECONDS`
+    // (for respectively number of seconds, milliseconds, microseconds and
+    // nanoseconds since start of the Unix epoch);
+    // or be written in `strftime` syntax. If time_format is not set, then the
+    // default format as described on the type_code is used.
+    string time_format = 5;
+  }
+
+  // Required. The [TypeCode][google.cloud.automl.v1beta1.TypeCode] for this type.
+  TypeCode type_code = 1;
+
+  // If true, this DataType can also be `NULL`. In .CSV files `NULL` value is
+  // expressed as an empty string.
+  bool nullable = 4;
+}
+
+// `StructType` defines the DataType-s of a [STRUCT][google.cloud.automl.v1beta1.TypeCode.STRUCT] type.
+message StructType {
+  // Unordered map of struct field names to their data types.
+  // Fields cannot be added or removed via Update. Their names and
+  // data types are still mutable.
+  map<string, DataType> fields = 1;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_types_pb2.py b/automl/google/cloud/automl_v1beta1/proto/data_types_pb2.py
new file mode 100644
index 000000000000..631850a58fc6
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_types_pb2.py
@@ -0,0 +1,408 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/data_types.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/data_types.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/automl_v1beta1/proto/data_types.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"\xfc\x01\n\x08\x44\x61taType\x12\x42\n\x11list_element_type\x18\x02 \x01(\x0b\x32%.google.cloud.automl.v1beta1.DataTypeH\x00\x12>\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\'.google.cloud.automl.v1beta1.StructTypeH\x00\x12\x15\n\x0btime_format\x18\x05 \x01(\tH\x00\x12\x38\n\ttype_code\x18\x01 \x01(\x0e\x32%.google.cloud.automl.v1beta1.TypeCode\x12\x10\n\x08nullable\x18\x04 \x01(\x08\x42\t\n\x07\x64\x65tails"\xa7\x01\n\nStructType\x12\x43\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x33.google.cloud.automl.v1beta1.StructType.FieldsEntry\x1aT\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x34\n\x05value\x18\x02 \x01(\x0b\x32%.google.cloud.automl.v1beta1.DataType:\x02\x38\x01*r\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\t\x12\x0c\n\x08\x43\x41TEGORY\x10\nB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_TYPECODE = _descriptor.EnumDescriptor(
+    name="TypeCode",
+    full_name="google.cloud.automl.v1beta1.TypeCode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_CODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLOAT64", index=1, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIMESTAMP", index=2, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRING", index=3, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ARRAY", index=4, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRUCT", index=5, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CATEGORY", index=6, number=10, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=538,
+    serialized_end=652,
+)
+_sym_db.RegisterEnumDescriptor(_TYPECODE)
+
+TypeCode = enum_type_wrapper.EnumTypeWrapper(_TYPECODE)
+TYPE_CODE_UNSPECIFIED = 0
+FLOAT64 = 3
+TIMESTAMP = 4
+STRING = 6
+ARRAY = 8
+STRUCT = 9
+CATEGORY = 10
+
+
+_DATATYPE = _descriptor.Descriptor(
+    name="DataType",
+    full_name="google.cloud.automl.v1beta1.DataType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="list_element_type",
+            full_name="google.cloud.automl.v1beta1.DataType.list_element_type",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="struct_type",
+            full_name="google.cloud.automl.v1beta1.DataType.struct_type",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_format",
+            full_name="google.cloud.automl.v1beta1.DataType.time_format",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type_code",
+            full_name="google.cloud.automl.v1beta1.DataType.type_code",
+            index=3,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="nullable",
+            full_name="google.cloud.automl.v1beta1.DataType.nullable",
+            index=4,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="details",
+            full_name="google.cloud.automl.v1beta1.DataType.details",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=114,
+    serialized_end=366,
+)
+
+
+_STRUCTTYPE_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.cloud.automl.v1beta1.StructType.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.StructType.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.StructType.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=452,
+    serialized_end=536,
+)
+
+_STRUCTTYPE = _descriptor.Descriptor(
+    name="StructType",
+    full_name="google.cloud.automl.v1beta1.StructType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.automl.v1beta1.StructType.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_STRUCTTYPE_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=369,
+    serialized_end=536,
+)
+
+_DATATYPE.fields_by_name["list_element_type"].message_type = _DATATYPE
+_DATATYPE.fields_by_name["struct_type"].message_type = _STRUCTTYPE
+_DATATYPE.fields_by_name["type_code"].enum_type = _TYPECODE
+_DATATYPE.oneofs_by_name["details"].fields.append(
+    _DATATYPE.fields_by_name["list_element_type"]
+)
+_DATATYPE.fields_by_name[
+    "list_element_type"
+].containing_oneof = _DATATYPE.oneofs_by_name["details"]
+_DATATYPE.oneofs_by_name["details"].fields.append(
+    _DATATYPE.fields_by_name["struct_type"]
+)
+_DATATYPE.fields_by_name["struct_type"].containing_oneof = _DATATYPE.oneofs_by_name[
+    "details"
+]
+_DATATYPE.oneofs_by_name["details"].fields.append(
+    _DATATYPE.fields_by_name["time_format"]
+)
+_DATATYPE.fields_by_name["time_format"].containing_oneof = _DATATYPE.oneofs_by_name[
+    "details"
+]
+_STRUCTTYPE_FIELDSENTRY.fields_by_name["value"].message_type = _DATATYPE
+_STRUCTTYPE_FIELDSENTRY.containing_type = _STRUCTTYPE
+_STRUCTTYPE.fields_by_name["fields"].message_type = _STRUCTTYPE_FIELDSENTRY
+DESCRIPTOR.message_types_by_name["DataType"] = _DATATYPE
+DESCRIPTOR.message_types_by_name["StructType"] = _STRUCTTYPE
+DESCRIPTOR.enum_types_by_name["TypeCode"] = _TYPECODE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DataType = _reflection.GeneratedProtocolMessageType(
+    "DataType",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATATYPE,
+        __module__="google.cloud.automl_v1beta1.proto.data_types_pb2",
+        __doc__="""Indicated the type of data that can be stored in a structured data
+  entity (e.g. a table).
+  
+  
+  Attributes:
+      details:
+          Details of DataType-s that need additional specification.
+      list_element_type:
+          If
+          [type\_code][google.cloud.automl.v1beta1.DataType.type\_code]
+          == [ARRAY][google.cloud.automl.v1beta1.TypeCode.ARRAY], then
+          ``list_element_type`` is the type of the elements.
+      struct_type:
+          If
+          [type\_code][google.cloud.automl.v1beta1.DataType.type\_code]
+          == [STRUCT][google.cloud.automl.v1beta1.TypeCode.STRUCT], then
+          ``struct_type`` provides type information for the struct's
+          fields.
+      time_format:
+          If
+          [type\_code][google.cloud.automl.v1beta1.DataType.type\_code]
+          == [TIMESTAMP][google.cloud.automl.v1beta1.TypeCode.TIMESTAMP]
+          then ``time_format`` provides the format in which that time
+          field is expressed. The time\_format must either be one of: \*
+          ``UNIX_SECONDS`` \* ``UNIX_MILLISECONDS`` \*
+          ``UNIX_MICROSECONDS`` \* ``UNIX_NANOSECONDS`` (for
+          respectively number of seconds, milliseconds, microseconds and
+          nanoseconds since start of the Unix epoch); or be written in
+          ``strftime`` syntax. If time\_format is not set, then the
+          default format as described on the type\_code is used.
+      type_code:
+          Required. The [TypeCode][google.cloud.automl.v1beta1.TypeCode]
+          for this type.
+      nullable:
+          If true, this DataType can also be ``NULL``. In .CSV files
+          ``NULL`` value is expressed as an empty string.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DataType)
+    ),
+)
+_sym_db.RegisterMessage(DataType)
+
+StructType = _reflection.GeneratedProtocolMessageType(
+    "StructType",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTTYPE_FIELDSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.data_types_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.StructType.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_STRUCTTYPE,
+        __module__="google.cloud.automl_v1beta1.proto.data_types_pb2",
+        __doc__="""``StructType`` defines the DataType-s of a
+  [STRUCT][google.cloud.automl.v1beta1.TypeCode.STRUCT] type.
+  
+  
+  Attributes:
+      fields:
+          Unordered map of struct field names to their data types.
+          Fields cannot be added or removed via Update. Their names and
+          data types are still mutable.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.StructType)
+    ),
+)
+_sym_db.RegisterMessage(StructType)
+_sym_db.RegisterMessage(StructType.FieldsEntry)
+
+
+DESCRIPTOR._options = None
+_STRUCTTYPE_FIELDSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/data_types_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/data_types_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/data_types_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/dataset.proto b/automl/google/cloud/automl_v1beta1/proto/dataset.proto
new file mode 100644
index 000000000000..e07b17841777
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/dataset.proto
@@ -0,0 +1,91 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/image.proto";
+import "google/cloud/automl/v1beta1/tables.proto";
+import "google/cloud/automl/v1beta1/text.proto";
+import "google/cloud/automl/v1beta1/translation.proto";
+import "google/cloud/automl/v1beta1/video.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+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 {
+  // 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 video classification.
+    VideoClassificationDatasetMetadata video_classification_dataset_metadata = 31;
+
+    // Metadata for a dataset used for video object tracking.
+    VideoObjectTrackingDatasetMetadata video_object_tracking_dataset_metadata = 29;
+
+    // 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;
+
+    // Metadata for a dataset used for Tables.
+    TablesDatasetMetadata tables_dataset_metadata = 33;
+  }
+
+  // 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;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/dataset_pb2.py b/automl/google/cloud/automl_v1beta1/proto/dataset_pb2.py
new file mode 100644
index 000000000000..b313da91b4dd
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/dataset_pb2.py
@@ -0,0 +1,520 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/dataset.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    image_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    tables_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    translation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    video_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/dataset.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        "\n/google/cloud/automl_v1beta1/proto/dataset.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a-google/cloud/automl_v1beta1/proto/image.proto\x1a.google/cloud/automl_v1beta1/proto/tables.proto\x1a,google/cloud/automl_v1beta1/proto/text.proto\x1a\x33google/cloud/automl_v1beta1/proto/translation.proto\x1a-google/cloud/automl_v1beta1/proto/video.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto\"\xee\x08\n\x07\x44\x61taset\x12_\n\x1ctranslation_dataset_metadata\x18\x17 \x01(\x0b\x32\x37.google.cloud.automl.v1beta1.TranslationDatasetMetadataH\x00\x12p\n%image_classification_dataset_metadata\x18\x18 \x01(\x0b\x32?.google.cloud.automl.v1beta1.ImageClassificationDatasetMetadataH\x00\x12n\n$text_classification_dataset_metadata\x18\x19 \x01(\x0b\x32>.google.cloud.automl.v1beta1.TextClassificationDatasetMetadataH\x00\x12s\n'image_object_detection_dataset_metadata\x18\x1a \x01(\x0b\x32@.google.cloud.automl.v1beta1.ImageObjectDetectionDatasetMetadataH\x00\x12p\n%video_classification_dataset_metadata\x18\x1f \x01(\x0b\x32?.google.cloud.automl.v1beta1.VideoClassificationDatasetMetadataH\x00\x12q\n&video_object_tracking_dataset_metadata\x18\x1d \x01(\x0b\x32?.google.cloud.automl.v1beta1.VideoObjectTrackingDatasetMetadataH\x00\x12\x66\n text_extraction_dataset_metadata\x18\x1c \x01(\x0b\x32:.google.cloud.automl.v1beta1.TextExtractionDatasetMetadataH\x00\x12\x64\n\x1ftext_sentiment_dataset_metadata\x18\x1e \x01(\x0b\x32\x39.google.cloud.automl.v1beta1.TextSentimentDatasetMetadataH\x00\x12U\n\x17tables_dataset_metadata\x18! \x01(\x0b\x32\x32.google.cloud.automl.v1beta1.TablesDatasetMetadataH\x00\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x15\n\rexample_count\x18\x15 \x01(\x05\x12/\n\x0b\x63reate_time\x18\x0e \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04\x65tag\x18\x11 \x01(\tB\x12\n\x10\x64\x61taset_metadataB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3"
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DATASET = _descriptor.Descriptor(
+    name="Dataset",
+    full_name="google.cloud.automl.v1beta1.Dataset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="translation_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.translation_dataset_metadata",
+            index=0,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_classification_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.image_classification_dataset_metadata",
+            index=1,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_classification_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.text_classification_dataset_metadata",
+            index=2,
+            number=25,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_object_detection_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.image_object_detection_dataset_metadata",
+            index=3,
+            number=26,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.video_classification_dataset_metadata",
+            index=4,
+            number=31,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_tracking_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.video_object_tracking_dataset_metadata",
+            index=5,
+            number=29,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_extraction_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.text_extraction_dataset_metadata",
+            index=6,
+            number=28,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_sentiment_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.text_sentiment_dataset_metadata",
+            index=7,
+            number=30,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tables_dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.tables_dataset_metadata",
+            index=8,
+            number=33,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.Dataset.name",
+            index=9,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.Dataset.display_name",
+            index=10,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.automl.v1beta1.Dataset.description",
+            index=11,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="example_count",
+            full_name="google.cloud.automl.v1beta1.Dataset.example_count",
+            index=12,
+            number=21,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.automl.v1beta1.Dataset.create_time",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.automl.v1beta1.Dataset.etag",
+            index=14,
+            number=17,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="dataset_metadata",
+            full_name="google.cloud.automl.v1beta1.Dataset.dataset_metadata",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=385,
+    serialized_end=1519,
+)
+
+_DATASET.fields_by_name[
+    "translation_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2._TRANSLATIONDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "image_classification_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2._IMAGECLASSIFICATIONDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "text_classification_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2._TEXTCLASSIFICATIONDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "image_object_detection_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2._IMAGEOBJECTDETECTIONDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "video_classification_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2._VIDEOCLASSIFICATIONDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "video_object_tracking_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2._VIDEOOBJECTTRACKINGDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "text_extraction_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2._TEXTEXTRACTIONDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "text_sentiment_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2._TEXTSENTIMENTDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "tables_dataset_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2._TABLESDATASETMETADATA
+)
+_DATASET.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["translation_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "translation_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["image_classification_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "image_classification_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["text_classification_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "text_classification_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["image_object_detection_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "image_object_detection_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["video_classification_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "video_classification_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["video_object_tracking_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "video_object_tracking_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["text_extraction_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "text_extraction_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["text_sentiment_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "text_sentiment_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+_DATASET.oneofs_by_name["dataset_metadata"].fields.append(
+    _DATASET.fields_by_name["tables_dataset_metadata"]
+)
+_DATASET.fields_by_name[
+    "tables_dataset_metadata"
+].containing_oneof = _DATASET.oneofs_by_name["dataset_metadata"]
+DESCRIPTOR.message_types_by_name["Dataset"] = _DATASET
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Dataset = _reflection.GeneratedProtocolMessageType(
+    "Dataset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASET,
+        __module__="google.cloud.automl_v1beta1.proto.dataset_pb2",
+        __doc__="""A workspace for solving a single, particular machine learning (ML)
+  problem. A workspace contains examples that may be annotated.
+  
+  
+  Attributes:
+      dataset_metadata:
+          Required. The dataset metadata that is specific to the problem
+          type.
+      translation_dataset_metadata:
+          Metadata for a dataset used for translation.
+      image_classification_dataset_metadata:
+          Metadata for a dataset used for image classification.
+      text_classification_dataset_metadata:
+          Metadata for a dataset used for text classification.
+      image_object_detection_dataset_metadata:
+          Metadata for a dataset used for image object detection.
+      video_classification_dataset_metadata:
+          Metadata for a dataset used for video classification.
+      video_object_tracking_dataset_metadata:
+          Metadata for a dataset used for video object tracking.
+      text_extraction_dataset_metadata:
+          Metadata for a dataset used for text extraction.
+      text_sentiment_dataset_metadata:
+          Metadata for a dataset used for text sentiment.
+      tables_dataset_metadata:
+          Metadata for a dataset used for Tables.
+      name:
+          Output only. The resource name of the dataset. Form: ``project
+          s/{project_id}/locations/{location_id}/datasets/{dataset_id}``
+      display_name:
+          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.
+      description:
+          User-provided description of the dataset. The description can
+          be up to 25000 characters long.
+      example_count:
+          Output only. The number of examples in the dataset.
+      create_time:
+          Output only. Timestamp when this dataset was created.
+      etag:
+          Used to perform consistent read-modify-write updates. If not
+          set, a blind "overwrite" update happens.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Dataset)
+    ),
+)
+_sym_db.RegisterMessage(Dataset)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/dataset_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/dataset_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/dataset_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/detection.proto b/automl/google/cloud/automl_v1beta1/proto/detection.proto
new file mode 100644
index 000000000000..99761fd52c57
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/detection.proto
@@ -0,0 +1,136 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/geometry.proto";
+import "google/protobuf/duration.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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;
+}
+
+// Annotation details for video object tracking.
+message VideoObjectTrackingAnnotation {
+  // 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
+  // is done as best effort. Especially in cases when an entity goes
+  // off-screen for a longer time (minutes), when it comes back it may be given
+  // a new instance ID.
+  string instance_id = 1;
+
+  // Required. A time (frame) of a video to which this annotation pertains.
+  // Represented as the duration since the video's start.
+  google.protobuf.Duration time_offset = 2;
+
+  // Required. The rectangle representing the object location on the frame (i.e.
+  // at the time_offset of the video).
+  BoundingPoly bounding_box = 3;
+
+  // 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
+  // changed to 1).
+  float score = 4;
+}
+
+// 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;
+}
+
+// Model evaluation metrics for video object tracking problems.
+// Evaluates prediction quality of both labeled bounding boxes and labeled
+// tracks (i.e. series of bounding boxes sharing same label and instance ID).
+message VideoObjectTrackingEvaluationMetrics {
+  // Output only. The number of video frames used to create this evaluation.
+  int32 evaluated_frame_count = 1;
+
+  // Output only. The total number of bounding boxes (i.e. summed over all
+  // frames) the ground truth used to create this evaluation had.
+  int32 evaluated_bounding_box_count = 2;
+
+  // 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 = 4;
+
+  // 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 = 6;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/detection_pb2.py b/automl/google/cloud/automl_v1beta1/proto/detection_pb2.py
new file mode 100644
index 000000000000..c9c4296fedda
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/detection_pb2.py
@@ -0,0 +1,745 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/detection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/detection.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/automl_v1beta1/proto/detection.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x30google/cloud/automl_v1beta1/proto/geometry.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/api/annotations.proto"p\n\x1eImageObjectDetectionAnnotation\x12?\n\x0c\x62ounding_box\x18\x01 \x01(\x0b\x32).google.cloud.automl.v1beta1.BoundingPoly\x12\r\n\x05score\x18\x02 \x01(\x02"\xb4\x01\n\x1dVideoObjectTrackingAnnotation\x12\x13\n\x0binstance_id\x18\x01 \x01(\t\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12?\n\x0c\x62ounding_box\x18\x03 \x01(\x0b\x32).google.cloud.automl.v1beta1.BoundingPoly\x12\r\n\x05score\x18\x04 \x01(\x02"\xae\x02\n\x17\x42oundingBoxMetricsEntry\x12\x15\n\riou_threshold\x18\x01 \x01(\x02\x12\x1e\n\x16mean_average_precision\x18\x02 \x01(\x02\x12o\n\x1a\x63onfidence_metrics_entries\x18\x03 \x03(\x0b\x32K.google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry\x1ak\n\x16\x43onfidenceMetricsEntry\x12\x1c\n\x14\x63onfidence_threshold\x18\x01 \x01(\x02\x12\x0e\n\x06recall\x18\x02 \x01(\x02\x12\x11\n\tprecision\x18\x03 \x01(\x02\x12\x10\n\x08\x66\x31_score\x18\x04 \x01(\x02"\xd6\x01\n%ImageObjectDetectionEvaluationMetrics\x12$\n\x1c\x65valuated_bounding_box_count\x18\x01 \x01(\x05\x12Z\n\x1c\x62ounding_box_metrics_entries\x18\x02 \x03(\x0b\x32\x34.google.cloud.automl.v1beta1.BoundingBoxMetricsEntry\x12+\n#bounding_box_mean_average_precision\x18\x03 \x01(\x02"\xf4\x01\n$VideoObjectTrackingEvaluationMetrics\x12\x1d\n\x15\x65valuated_frame_count\x18\x01 \x01(\x05\x12$\n\x1c\x65valuated_bounding_box_count\x18\x02 \x01(\x05\x12Z\n\x1c\x62ounding_box_metrics_entries\x18\x04 \x03(\x0b\x32\x34.google.cloud.automl.v1beta1.BoundingBoxMetricsEntry\x12+\n#bounding_box_mean_average_precision\x18\x06 \x01(\x02\x42\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_IMAGEOBJECTDETECTIONANNOTATION = _descriptor.Descriptor(
+    name="ImageObjectDetectionAnnotation",
+    full_name="google.cloud.automl.v1beta1.ImageObjectDetectionAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionAnnotation.bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionAnnotation.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=194,
+    serialized_end=306,
+)
+
+
+_VIDEOOBJECTTRACKINGANNOTATION = _descriptor.Descriptor(
+    name="VideoObjectTrackingAnnotation",
+    full_name="google.cloud.automl.v1beta1.VideoObjectTrackingAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingAnnotation.instance_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingAnnotation.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingAnnotation.bounding_box",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=309,
+    serialized_end=489,
+)
+
+
+_BOUNDINGBOXMETRICSENTRY_CONFIDENCEMETRICSENTRY = _descriptor.Descriptor(
+    name="ConfidenceMetricsEntry",
+    full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="confidence_threshold",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry.confidence_threshold",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry.recall",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry.precision",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry.f1_score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=687,
+    serialized_end=794,
+)
+
+_BOUNDINGBOXMETRICSENTRY = _descriptor.Descriptor(
+    name="BoundingBoxMetricsEntry",
+    full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="iou_threshold",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.iou_threshold",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_average_precision",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.mean_average_precision",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence_metrics_entries",
+            full_name="google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.confidence_metrics_entries",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_BOUNDINGBOXMETRICSENTRY_CONFIDENCEMETRICSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=492,
+    serialized_end=794,
+)
+
+
+_IMAGEOBJECTDETECTIONEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="ImageObjectDetectionEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.ImageObjectDetectionEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="evaluated_bounding_box_count",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionEvaluationMetrics.evaluated_bounding_box_count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box_metrics_entries",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionEvaluationMetrics.bounding_box_metrics_entries",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box_mean_average_precision",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionEvaluationMetrics.bounding_box_mean_average_precision",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=797,
+    serialized_end=1011,
+)
+
+
+_VIDEOOBJECTTRACKINGEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="VideoObjectTrackingEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="evaluated_frame_count",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetrics.evaluated_frame_count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluated_bounding_box_count",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetrics.evaluated_bounding_box_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box_metrics_entries",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetrics.bounding_box_metrics_entries",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box_mean_average_precision",
+            full_name="google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetrics.bounding_box_mean_average_precision",
+            index=3,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1014,
+    serialized_end=1258,
+)
+
+_IMAGEOBJECTDETECTIONANNOTATION.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_VIDEOOBJECTTRACKINGANNOTATION.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOOBJECTTRACKINGANNOTATION.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_BOUNDINGBOXMETRICSENTRY_CONFIDENCEMETRICSENTRY.containing_type = (
+    _BOUNDINGBOXMETRICSENTRY
+)
+_BOUNDINGBOXMETRICSENTRY.fields_by_name[
+    "confidence_metrics_entries"
+].message_type = _BOUNDINGBOXMETRICSENTRY_CONFIDENCEMETRICSENTRY
+_IMAGEOBJECTDETECTIONEVALUATIONMETRICS.fields_by_name[
+    "bounding_box_metrics_entries"
+].message_type = _BOUNDINGBOXMETRICSENTRY
+_VIDEOOBJECTTRACKINGEVALUATIONMETRICS.fields_by_name[
+    "bounding_box_metrics_entries"
+].message_type = _BOUNDINGBOXMETRICSENTRY
+DESCRIPTOR.message_types_by_name[
+    "ImageObjectDetectionAnnotation"
+] = _IMAGEOBJECTDETECTIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "VideoObjectTrackingAnnotation"
+] = _VIDEOOBJECTTRACKINGANNOTATION
+DESCRIPTOR.message_types_by_name["BoundingBoxMetricsEntry"] = _BOUNDINGBOXMETRICSENTRY
+DESCRIPTOR.message_types_by_name[
+    "ImageObjectDetectionEvaluationMetrics"
+] = _IMAGEOBJECTDETECTIONEVALUATIONMETRICS
+DESCRIPTOR.message_types_by_name[
+    "VideoObjectTrackingEvaluationMetrics"
+] = _VIDEOOBJECTTRACKINGEVALUATIONMETRICS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ImageObjectDetectionAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ImageObjectDetectionAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEOBJECTDETECTIONANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.detection_pb2",
+        __doc__="""Annotation details for image object detection.
+  
+  
+  Attributes:
+      bounding_box:
+          Output only. The rectangle representing the object location.
+      score:
+          Output only. The confidence that this annotation is positive
+          for the parent example, value in [0, 1], higher means higher
+          positivity confidence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageObjectDetectionAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ImageObjectDetectionAnnotation)
+
+VideoObjectTrackingAnnotation = _reflection.GeneratedProtocolMessageType(
+    "VideoObjectTrackingAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOOBJECTTRACKINGANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.detection_pb2",
+        __doc__="""Annotation details for video object tracking.
+  
+  
+  Attributes:
+      instance_id:
+          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 is done as best effort. Especially in cases
+          when an entity goes off-screen for a longer time (minutes),
+          when it comes back it may be given a new instance ID.
+      time_offset:
+          Required. A time (frame) of a video to which this annotation
+          pertains. Represented as the duration since the video's start.
+      bounding_box:
+          Required. The rectangle representing the object location on
+          the frame (i.e. at the time\_offset of the video).
+      score:
+          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 changed to 1).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoObjectTrackingAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(VideoObjectTrackingAnnotation)
+
+BoundingBoxMetricsEntry = _reflection.GeneratedProtocolMessageType(
+    "BoundingBoxMetricsEntry",
+    (_message.Message,),
+    dict(
+        ConfidenceMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "ConfidenceMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BOUNDINGBOXMETRICSENTRY_CONFIDENCEMETRICSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.detection_pb2",
+                __doc__="""Metrics for a single confidence threshold.
+    
+    
+    Attributes:
+        confidence_threshold:
+            Output only. The confidence threshold value used to compute
+            the metrics.
+        recall:
+            Output only. Recall under the given confidence threshold.
+        precision:
+            Output only. Precision under the given confidence threshold.
+        f1_score:
+            Output only. The harmonic mean of recall and precision.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BoundingBoxMetricsEntry.ConfidenceMetricsEntry)
+            ),
+        ),
+        DESCRIPTOR=_BOUNDINGBOXMETRICSENTRY,
+        __module__="google.cloud.automl_v1beta1.proto.detection_pb2",
+        __doc__="""Bounding box matching model metrics for a single intersection-over-union
+  threshold and multiple label match confidence thresholds.
+  
+  
+  Attributes:
+      iou_threshold:
+          Output only. The intersection-over-union threshold value used
+          to compute this metrics entry.
+      mean_average_precision:
+          Output only. The mean average precision, most often close to
+          au\_prc.
+      confidence_metrics_entries:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BoundingBoxMetricsEntry)
+    ),
+)
+_sym_db.RegisterMessage(BoundingBoxMetricsEntry)
+_sym_db.RegisterMessage(BoundingBoxMetricsEntry.ConfidenceMetricsEntry)
+
+ImageObjectDetectionEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "ImageObjectDetectionEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEOBJECTDETECTIONEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.detection_pb2",
+        __doc__="""Model evaluation metrics for image object detection problems. Evaluates
+  prediction quality of labeled bounding boxes.
+  
+  
+  Attributes:
+      evaluated_bounding_box_count:
+          Output only. The total number of bounding boxes (i.e. summed
+          over all images) the ground truth used to create this
+          evaluation had.
+      bounding_box_metrics_entries:
+          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.
+      bounding_box_mean_average_precision:
+          Output only. The single metric for bounding boxes evaluation:
+          the mean\_average\_precision averaged over all
+          bounding\_box\_metrics\_entries.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageObjectDetectionEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(ImageObjectDetectionEvaluationMetrics)
+
+VideoObjectTrackingEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "VideoObjectTrackingEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOOBJECTTRACKINGEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.detection_pb2",
+        __doc__="""Model evaluation metrics for video object tracking problems. Evaluates
+  prediction quality of both labeled bounding boxes and labeled tracks
+  (i.e. series of bounding boxes sharing same label and instance ID).
+  
+  
+  Attributes:
+      evaluated_frame_count:
+          Output only. The number of video frames used to create this
+          evaluation.
+      evaluated_bounding_box_count:
+          Output only. The total number of bounding boxes (i.e. summed
+          over all frames) the ground truth used to create this
+          evaluation had.
+      bounding_box_metrics_entries:
+          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.
+      bounding_box_mean_average_precision:
+          Output only. The single metric for bounding boxes evaluation:
+          the mean\_average\_precision averaged over all
+          bounding\_box\_metrics\_entries.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(VideoObjectTrackingEvaluationMetrics)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/detection_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/detection_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/detection_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/geometry.proto b/automl/google/cloud/automl_v1beta1/proto/geometry.proto
new file mode 100644
index 000000000000..e5379ab14df6
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/geometry.proto
@@ -0,0 +1,47 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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/automl/google/cloud/automl_v1beta1/proto/geometry_pb2.py b/automl/google/cloud/automl_v1beta1/proto/geometry_pb2.py
new file mode 100644
index 000000000000..935a2e4d7819
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/geometry_pb2.py
@@ -0,0 +1,175 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/geometry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/geometry.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/automl_v1beta1/proto/geometry.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"Z\n\x0c\x42oundingPoly\x12J\n\x13normalized_vertices\x18\x02 \x03(\x0b\x32-.google.cloud.automl.v1beta1.NormalizedVertexB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.automl.v1beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.automl.v1beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.automl.v1beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=111,
+    serialized_end=151,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.automl.v1beta1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.automl.v1beta1.BoundingPoly.normalized_vertices",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=153,
+    serialized_end=243,
+)
+
+_BOUNDINGPOLY.fields_by_name["normalized_vertices"].message_type = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.automl_v1beta1.proto.geometry_pb2",
+        __doc__="""Required. Horizontal coordinate.
+  
+  
+  Attributes:
+      y:
+          Required. Vertical coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.automl_v1beta1.proto.geometry_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      normalized_vertices:
+          Output only . The bounding polygon normalized vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/geometry_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/geometry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/geometry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/image.proto b/automl/google/cloud/automl_v1beta1/proto/image.proto
new file mode 100644
index 000000000000..241d11ebef04
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/image.proto
@@ -0,0 +1,158 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/annotation_spec.proto";
+import "google/cloud/automl/v1beta1/classification.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "ImageProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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;
+
+  // Required. The train budget of creating this model, expressed in hours. The
+  // actual `train_cost` will be equal or less than this value.
+  int64 train_budget = 2;
+
+  // Output only. The actual train cost of creating this model, expressed in
+  // hours. If this model is created from a `base` model, the train cost used
+  // to create the `base` model are not included.
+  int64 train_cost = 3;
+
+  // 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.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.
+  // *   `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.v1beta1.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.v1beta1.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.v1beta1.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;
+}
+
+// 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.
+  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 2,000,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 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.v1beta1.ImageObjectDetectionModelMetadata.qps_per_node].
+  // Must be between 1 and 100, inclusive on both ends.
+  int64 node_count = 1;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/image_pb2.py b/automl/google/cloud/automl_v1beta1/proto/image_pb2.py
new file mode 100644
index 000000000000..8efacf229e46
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/image_pb2.py
@@ -0,0 +1,590 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/image.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    annotation_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/image.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\nImageProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/automl_v1beta1/proto/image.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x37google/cloud/automl_v1beta1/proto/annotation_spec.proto\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"r\n"ImageClassificationDatasetMetadata\x12L\n\x13\x63lassification_type\x18\x01 \x01(\x0e\x32/.google.cloud.automl.v1beta1.ClassificationType"%\n#ImageObjectDetectionDatasetMetadata"\x8c\x01\n ImageClassificationModelMetadata\x12\x15\n\rbase_model_id\x18\x01 \x01(\t\x12\x14\n\x0ctrain_budget\x18\x02 \x01(\x03\x12\x12\n\ntrain_cost\x18\x03 \x01(\x03\x12\x13\n\x0bstop_reason\x18\x05 \x01(\t\x12\x12\n\nmodel_type\x18\x07 \x01(\t"\xbe\x01\n!ImageObjectDetectionModelMetadata\x12\x12\n\nmodel_type\x18\x01 \x01(\t\x12\x12\n\nnode_count\x18\x03 \x01(\x03\x12\x10\n\x08node_qps\x18\x04 \x01(\x01\x12\x13\n\x0bstop_reason\x18\x05 \x01(\t\x12%\n\x1dtrain_budget_milli_node_hours\x18\x06 \x01(\x03\x12#\n\x1btrain_cost_milli_node_hours\x18\x07 \x01(\x03"A\n+ImageObjectDetectionModelDeploymentMetadata\x12\x12\n\nnode_count\x18\x01 \x01(\x03\x42\xb1\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\nImageProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_IMAGECLASSIFICATIONDATASETMETADATA = _descriptor.Descriptor(
+    name="ImageClassificationDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.ImageClassificationDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="classification_type",
+            full_name="google.cloud.automl.v1beta1.ImageClassificationDatasetMetadata.classification_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=254,
+    serialized_end=368,
+)
+
+
+_IMAGEOBJECTDETECTIONDATASETMETADATA = _descriptor.Descriptor(
+    name="ImageObjectDetectionDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.ImageObjectDetectionDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=370,
+    serialized_end=407,
+)
+
+
+_IMAGECLASSIFICATIONMODELMETADATA = _descriptor.Descriptor(
+    name="ImageClassificationModelMetadata",
+    full_name="google.cloud.automl.v1beta1.ImageClassificationModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="base_model_id",
+            full_name="google.cloud.automl.v1beta1.ImageClassificationModelMetadata.base_model_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="train_budget",
+            full_name="google.cloud.automl.v1beta1.ImageClassificationModelMetadata.train_budget",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="train_cost",
+            full_name="google.cloud.automl.v1beta1.ImageClassificationModelMetadata.train_cost",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stop_reason",
+            full_name="google.cloud.automl.v1beta1.ImageClassificationModelMetadata.stop_reason",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_type",
+            full_name="google.cloud.automl.v1beta1.ImageClassificationModelMetadata.model_type",
+            index=4,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=410,
+    serialized_end=550,
+)
+
+
+_IMAGEOBJECTDETECTIONMODELMETADATA = _descriptor.Descriptor(
+    name="ImageObjectDetectionModelMetadata",
+    full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model_type",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata.model_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_count",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata.node_count",
+            index=1,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_qps",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata.node_qps",
+            index=2,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stop_reason",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata.stop_reason",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="train_budget_milli_node_hours",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata.train_budget_milli_node_hours",
+            index=4,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="train_cost_milli_node_hours",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata.train_cost_milli_node_hours",
+            index=5,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=553,
+    serialized_end=743,
+)
+
+
+_IMAGEOBJECTDETECTIONMODELDEPLOYMENTMETADATA = _descriptor.Descriptor(
+    name="ImageObjectDetectionModelDeploymentMetadata",
+    full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelDeploymentMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="node_count",
+            full_name="google.cloud.automl.v1beta1.ImageObjectDetectionModelDeploymentMetadata.node_count",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=745,
+    serialized_end=810,
+)
+
+_IMAGECLASSIFICATIONDATASETMETADATA.fields_by_name[
+    "classification_type"
+].enum_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2._CLASSIFICATIONTYPE
+)
+DESCRIPTOR.message_types_by_name[
+    "ImageClassificationDatasetMetadata"
+] = _IMAGECLASSIFICATIONDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ImageObjectDetectionDatasetMetadata"
+] = _IMAGEOBJECTDETECTIONDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ImageClassificationModelMetadata"
+] = _IMAGECLASSIFICATIONMODELMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ImageObjectDetectionModelMetadata"
+] = _IMAGEOBJECTDETECTIONMODELMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ImageObjectDetectionModelDeploymentMetadata"
+] = _IMAGEOBJECTDETECTIONMODELDEPLOYMENTMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ImageClassificationDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImageClassificationDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECLASSIFICATIONDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.image_pb2",
+        __doc__="""Dataset metadata that is specific to image classification.
+  
+  
+  Attributes:
+      classification_type:
+          Required. Type of the classification problem.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageClassificationDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImageClassificationDatasetMetadata)
+
+ImageObjectDetectionDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImageObjectDetectionDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEOBJECTDETECTIONDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.image_pb2",
+        __doc__="""Dataset metadata specific to image object detection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageObjectDetectionDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImageObjectDetectionDatasetMetadata)
+
+ImageClassificationModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImageClassificationModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECLASSIFICATIONMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.image_pb2",
+        __doc__="""Model metadata for image classification.
+  
+  
+  Attributes:
+      base_model_id:
+          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``.
+      train_budget:
+          Required. The train budget of creating this model, expressed
+          in hours. The actual ``train_cost`` will be equal or less than
+          this value.
+      train_cost:
+          Output only. The actual train cost of creating this model,
+          expressed in hours. If this model is created from a ``base``
+          model, the train cost used to create the ``base`` model are
+          not included.
+      stop_reason:
+          Output only. The reason that this create model operation
+          stopped, e.g. ``BUDGET_REACHED``, ``MODEL_CONVERGED``.
+      model_type:
+          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.clo
+          ud.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.E
+          xportModel]) 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. \* ``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
+          .v1beta1.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.E
+          xportModel][google.cloud.automl.v1beta1.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.v1beta1.AutoMl.E
+          xportModel]) 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageClassificationModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImageClassificationModelMetadata)
+
+ImageObjectDetectionModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImageObjectDetectionModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEOBJECTDETECTIONMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.image_pb2",
+        __doc__="""Model metadata specific to image object detection.
+  
+  
+  Attributes:
+      model_type:
+          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.
+      node_count:
+          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.
+      node_qps:
+          Output only. An approximate number of online prediction QPS
+          that can be supported by this model per each node on which it
+          is deployed.
+      stop_reason:
+          Output only. The reason that this create model operation
+          stopped, e.g. ``BUDGET_REACHED``, ``MODEL_CONVERGED``.
+      train_budget_milli_node_hours:
+          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
+          2,000,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.
+      train_cost_milli_node_hours:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImageObjectDetectionModelMetadata)
+
+ImageObjectDetectionModelDeploymentMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImageObjectDetectionModelDeploymentMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEOBJECTDETECTIONMODELDEPLOYMENTMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.image_pb2",
+        __doc__="""Model deployment metadata specific to Image Object Detection.
+  
+  
+  Attributes:
+      node_count:
+          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.v1beta1.ImageObjectDetectionModelMetadat
+          a.qps\_per\_node]. Must be between 1 and 100, inclusive on
+          both ends.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImageObjectDetectionModelDeploymentMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImageObjectDetectionModelDeploymentMetadata)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/image_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/image_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/image_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/io.proto b/automl/google/cloud/automl_v1beta1/proto/io.proto
new file mode 100644
index 000000000000..6f007f02a10d
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/io.proto
@@ -0,0 +1,1130 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// Input configuration for 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.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 (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:
+//
+//  *  For Image Classification:
+//         CSV file(s) with each line in format:
+//           ML_USE,GCS_FILE_PATH,LABEL,LABEL,...
+//           GCS_FILE_PATH leads to image of up to 30MB in size. Supported
+//           extensions: .JPEG, .GIF, .PNG, .WEBP, .BMP, .TIFF, .ICO
+//           For 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
+//
+//  *  For Image Object Detection:
+//         CSV file(s) with each line in format:
+//           ML_USE,GCS_FILE_PATH,(LABEL,BOUNDING_BOX | ,,,,,,,)
+//           GCS_FILE_PATH leads to image of up to 30MB in size. Supported
+//           extensions: .JPEG, .GIF, .PNG.
+//           Each image is assumed to be exhaustively labeled. The minimum
+//           allowed BOUNDING_BOX edge length is 0.01, and no more than 500
+//           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.
+//         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:
+//           ML_USE,GCS_FILE_PATH
+//           where ML_USE VALIDATE value should not be used. The GCS_FILE_PATH
+//           should lead to another .csv file which describes examples that have
+//           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 end has to be after the start. 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 shuold 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,,,
+//
+//  *  For Video Object Tracking:
+//         CSV file(s) with each line in format:
+//           ML_USE,GCS_FILE_PATH
+//           where ML_USE VALIDATE value should not be used. The GCS_FILE_PATH
+//           should lead to another .csv file which describes examples that have
+//           given ML_USE, using one of 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_IDs 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,,,,,,,,,,,
+//  *  For Text Extraction:
+//         CSV file(s) with each line in format:
+//           ML_USE,GCS_FILE_PATH
+//           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, 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
+//           TEST,gs://folder/file3.jsonl
+//         Sample in-line JSON Lines file for entity extraction (presented here
+//         with artificial line breaks, but the only actual line break is
+//         denoted by \n).:
+//           {
+//             "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": "animal",
+//                 "text_extraction": {"text_segment": {"start_offset": 0,
+//                 "end_offset": 3}}
+//               },
+//               {
+//                 "display_name": "animal",
+//                 "text_extraction": {"text_segment": {"start_offset": 4,
+//                 "end_offset": 7}}
+//               }
+//             ],
+//           }\n
+//           {
+//              "text_snippet": {
+//                "content": "This dog is good."
+//              },
+//              "annotations": [
+//                {
+//                  "display_name": "animal",
+//                  "text_extraction": {
+//                    "text_segment": {"start_offset": 5, "end_offset": 8}
+//                  }
+//                }
+//              ]
+//           }
+//         Sample document JSON Lines file (presented here with artificial line
+//         breaks, but the only actual line break is 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.pdf" ]
+//                 }
+//               }
+//             }
+//           }
+//
+//  *  For Text Classification:
+//         CSV file(s) with each line in format:
+//           ML_USE,(TEXT_SNIPPET | GCS_FILE_PATH),LABEL,LABEL,...
+//           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 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 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.
+//         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, 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
+//           is treated as to be imported text snippet. In both cases, the
+//           text snippet must be up to 500 characters long.
+//         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 is concatenated into a single
+//
+// [primary_table][google.cloud.automl.v1beta1.TablesDatasetMetadata.primary_table_name]
+//         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.
+//  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 = A path to file on GCS, e.g. "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
+//                     an 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 = A content of a text snippet, UTF-8 encoded, enclosed within
+//                 double quotes ("").
+//  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
+//              huge.
+//
+//  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.
+    // In ImportData, the gcs_source points to a csv with structure described in
+    // the comment.
+    GcsSource gcs_source = 1;
+
+    // The BigQuery location for the input content.
+    BigQuerySource bigquery_source = 3;
+  }
+
+  // Additional domain-specific parameters describing the semantic of the
+  // imported data, any string must be up to 25000
+  // characters long.
+  //
+  // *  For Tables:
+  //    `schema_inference_version` - (integer) Required. The version of the
+  //        algorithm that should be used for the initial inference of the
+  //        schema (columns' DataTypes) of the table the data is being imported
+  //        into. Allowed values: "1".
+  map<string, string> 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.v1beta1.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:
+//
+//  *  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
+//           GCS_FILE_PATH leads to 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 end has to be after the start.
+//         Three sample rows:
+//           gs://folder/video1.mp4,10,40
+//           gs://folder/video1.mp4,20,60
+//           gs://folder/vid2.mov,0,inf
+//
+//  *  For Video Object Tracking:
+//         CSV file(s) with each line in format:
+//           GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END
+//           GCS_FILE_PATH leads to 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 end has to be after the start.
+//         Three sample rows:
+//           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
+//         formats may be used).
+//         The in-line .JSONL file(s) contain 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.
+//         The document .JSONL file(s) contain, per line, a proto that wraps a
+//           Document proto with input_config set. Only PDF documents are
+//           supported now, and each document must be up to 2MB large.
+//         Any given .JSONL file must be 100MB or smaller, and no more than 20
+//         files may be given.
+//         Sample in-line JSON Lines file (presented here with artificial line
+//         breaks, but the only actual line break is 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": "An elaborate content",
+//               "mime_type": "text/plain"
+//             }
+//           }
+//         Sample document JSON Lines file (presented here with artificial line
+//         breaks, but the only actual line break is 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.pdf" ]
+//                 }
+//               }
+//             }
+//           }
+//
+//  *  For Tables:
+//         Either
+//         [gcs_source][google.cloud.automl.v1beta1.InputConfig.gcs_source] or
+//
+// [bigquery_source][google.cloud.automl.v1beta1.InputConfig.bigquery_source].
+//         GCS case:
+//           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.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. 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"}]}
+//         BigQuery case:
+//           An 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.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
+//
+// [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.
+//
+//  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
+//                       example that has a time dimension (e.g. video).
+//  TIME_SEGMENT_END = TIME_OFFSET
+//                     Expresses an end, exclusive, of a time segment within
+//                     an 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 {
+  // Required. The source of the input.
+  oneof source {
+    // The Google Cloud Storage location for the input content.
+    GcsSource gcs_source = 1;
+
+    // The BigQuery location for the input content.
+    BigQuerySource bigquery_source = 2;
+  }
+}
+
+// Input configuration of a [Document][google.cloud.automl.v1beta1.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 GCS or
+//         BigQuery.
+//         GCS case:
+//
+// [gcs_destination][google.cloud.automl.v1beta1.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.v1beta1.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_<automl-dataset-display-name>_<timestamp-of-export-call>`
+//           where <automl-dataset-display-name> 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 {
+  // Required. The destination of the output.
+  oneof destination {
+    // 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-<dataset-display-name>-<timestamp-of-export-call> 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;
+
+    // The BigQuery location where the output is to be written to.
+    BigQueryDestination bigquery_destination = 2;
+  }
+}
+
+// Output configuration for BatchPredict Action.
+//
+// As destination the
+//
+// [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 is created. Its name
+// will be
+// "prediction-<model-display-name>-<timestamp-of-prediction-call>",
+// 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" : "<id_value>" 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" : "<id_value>" 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" : "<id_value>" 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" : "<id_value>" 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 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`
+//         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" : "<id_value>" (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.v1beta1.BatchPredictOutputConfig.gcs_destination]
+//         or
+//
+// [bigquery_destination][google.cloud.automl.v1beta1.BatchPredictOutputConfig.bigquery_destination]
+//         is set (either is allowed).
+//         GCS 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.v1beta1.TablesModelMetadata.prediction_type]:
+//             Each .csv file will contain a header, listing all columns'
+//
+// [display_name-s][google.cloud.automl.v1beta1.ColumnSpec.display_name]
+//             given on input followed by M target column names in the format of
+//
+// "<[target_column_specs][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]
+//
+// [display_name][google.cloud.automl.v1beta1.ColumnSpec.display_name]>_<target
+//             value>_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.v1beta1.TablesAnnotation.score].
+//           For REGRESSION and FORECASTING
+//
+// [prediction_type-s][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]:
+//             Each .csv file will contain a header, listing all columns'
+//             [display_name-s][google.cloud.automl.v1beta1.display_name] given
+//             on input followed by the predicted target column with name in the
+//             format of
+//
+// "predicted_<[target_column_specs][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]
+//
+// [display_name][google.cloud.automl.v1beta1.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.v1beta1.OutputConfig.bigquery_destination]
+//           pointing to a BigQuery project must be set. In the given project a
+//           new dataset will be created with name
+//           `prediction_<model-display-name>_<timestamp-of-prediction-call>`
+//           where <model-display-name> 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.v1beta1.ColumnSpec.display_name]
+//           followed by the target column with name in the format of
+//
+// "predicted_<[target_column_specs][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]
+//
+// [display_name][google.cloud.automl.v1beta1.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.v1beta1.AnnotationPayload],
+//           represented as STRUCT-s, containing
+//           [TablesAnnotation][google.cloud.automl.v1beta1.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.v1beta1.TablesModelMetadata.target_column_spec]
+//
+// [display_name][google.cloud.automl.v1beta1.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 {
+  // Required. The destination of the output.
+  oneof destination {
+    // The Google Cloud Storage location of the directory where the output is to
+    // be written to.
+    GcsDestination gcs_destination = 1;
+
+    // The BigQuery location where the output is to be written to.
+    BigQueryDestination bigquery_destination = 2;
+  }
+}
+
+// Output configuration for ModelExport Action.
+message ModelExportOutputConfig {
+  // Required. The destination of the output.
+  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".
+    //
+    //  Under the directory given as the destination a new one with name
+    //  "model-export-<model-display-name>-<timestamp-of-export-call>",
+    //  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;
+
+    // The GCR location where model image is to be pushed to. This location
+    // may only be set for the following model formats:
+    //   "docker".
+    //
+    // The model image will be created under the given URI.
+    GcrDestination gcr_destination = 3;
+  }
+
+  // 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", "docker".
+  //
+  // *  For Image Classification mobile-core-ml-low-latency-1,
+  //        mobile-core-ml-versatile-1, mobile-core-ml-high-accuracy-1:
+  //      "core_ml" (default).
+  // 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.
+  // * 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<string, string> params = 2;
+}
+
+// Output configuration for ExportEvaluatedExamples Action. Note that this call
+// is available only for 30 days since the moment the model was evaluated.
+// The output depends on the domain, as follows (note that only examples from
+// the TEST set are exported):
+//
+//  *  For Tables:
+//
+// [bigquery_destination][google.cloud.automl.v1beta1.OutputConfig.bigquery_destination]
+//       pointing to a BigQuery project must be set. In the given project a
+//       new dataset will be created with name
+//
+// `export_evaluated_examples_<model-display-name>_<timestamp-of-export-call>`
+//       where <model-display-name> 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 an `evaluated_examples` table will be
+//       created. It will have all the same columns as the
+//
+// [primary_table][google.cloud.automl.v1beta1.TablesDatasetMetadata.primary_table_spec_id]
+//       of the
+//       [dataset][google.cloud.automl.v1beta1.Model.dataset_id] from which
+//       the model was created, as they were at the moment of model's
+//       evaluation (this includes the target column with its ground
+//       truth), followed by a column called "predicted_<target_column>". That
+//       last column will contain the model's prediction result for each
+//       respective row, given as ARRAY of
+//       [AnnotationPayloads][google.cloud.automl.v1beta1.AnnotationPayload],
+//       represented as STRUCT-s, containing
+//       [TablesAnnotation][google.cloud.automl.v1beta1.TablesAnnotation].
+message ExportEvaluatedExamplesOutputConfig {
+  // Required. The destination of the output.
+  oneof destination {
+    // The BigQuery location where the output is to be written to.
+    BigQueryDestination bigquery_destination = 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;
+}
+
+// The BigQuery location for the input content.
+message BigQuerySource {
+  // Required. BigQuery URI to a table, up to 2000 characters long.
+  // Accepted forms:
+  // *  BigQuery path e.g. bq://projectId.bqDatasetId.bqTableId
+  string input_uri = 1;
+}
+
+// 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;
+}
+
+// The BigQuery location for the output content.
+message BigQueryDestination {
+  // Required. BigQuery URI to a project, up to 2000 characters long.
+  // Accepted forms:
+  // *  BigQuery path e.g. bq://projectId
+  string output_uri = 1;
+}
+
+// The GCR location where the image must be pushed to.
+message GcrDestination {
+  // Required. Google Contained Registry URI of the new image, up to 2000
+  // characters long. See
+  //
+  // https:
+  // //cloud.google.com/container-registry/do
+  // // cs/pushing-and-pulling#pushing_an_image_to_a_registry
+  // Accepted forms:
+  // * [HOSTNAME]/[PROJECT-ID]/[IMAGE]
+  // * [HOSTNAME]/[PROJECT-ID]/[IMAGE]:[TAG]
+  //
+  // The requesting user must have permission to push images the project.
+  string output_uri = 1;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/io_pb2.py b/automl/google/cloud/automl_v1beta1/proto/io_pb2.py
new file mode 100644
index 000000000000..62cd25fdd121
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/io_pb2.py
@@ -0,0 +1,1918 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/io.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/io.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n*google/cloud/automl_v1beta1/proto/io.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"\x92\x02\n\x0bInputConfig\x12<\n\ngcs_source\x18\x01 \x01(\x0b\x32&.google.cloud.automl.v1beta1.GcsSourceH\x00\x12\x46\n\x0f\x62igquery_source\x18\x03 \x01(\x0b\x32+.google.cloud.automl.v1beta1.BigQuerySourceH\x00\x12\x44\n\x06params\x18\x02 \x03(\x0b\x32\x34.google.cloud.automl.v1beta1.InputConfig.ParamsEntry\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x08\n\x06source"\xa9\x01\n\x17\x42\x61tchPredictInputConfig\x12<\n\ngcs_source\x18\x01 \x01(\x0b\x32&.google.cloud.automl.v1beta1.GcsSourceH\x00\x12\x46\n\x0f\x62igquery_source\x18\x02 \x01(\x0b\x32+.google.cloud.automl.v1beta1.BigQuerySourceH\x00\x42\x08\n\x06source"Q\n\x13\x44ocumentInputConfig\x12:\n\ngcs_source\x18\x01 \x01(\x0b\x32&.google.cloud.automl.v1beta1.GcsSource"\xb7\x01\n\x0cOutputConfig\x12\x46\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32+.google.cloud.automl.v1beta1.GcsDestinationH\x00\x12P\n\x14\x62igquery_destination\x18\x02 \x01(\x0b\x32\x30.google.cloud.automl.v1beta1.BigQueryDestinationH\x00\x42\r\n\x0b\x64\x65stination"\xc3\x01\n\x18\x42\x61tchPredictOutputConfig\x12\x46\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32+.google.cloud.automl.v1beta1.GcsDestinationH\x00\x12P\n\x14\x62igquery_destination\x18\x02 \x01(\x0b\x32\x30.google.cloud.automl.v1beta1.BigQueryDestinationH\x00\x42\r\n\x0b\x64\x65stination"\xcf\x02\n\x17ModelExportOutputConfig\x12\x46\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32+.google.cloud.automl.v1beta1.GcsDestinationH\x00\x12\x46\n\x0fgcr_destination\x18\x03 \x01(\x0b\x32+.google.cloud.automl.v1beta1.GcrDestinationH\x00\x12\x14\n\x0cmodel_format\x18\x04 \x01(\t\x12P\n\x06params\x18\x02 \x03(\x0b\x32@.google.cloud.automl.v1beta1.ModelExportOutputConfig.ParamsEntry\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\r\n\x0b\x64\x65stination"\x86\x01\n#ExportEvaluatedExamplesOutputConfig\x12P\n\x14\x62igquery_destination\x18\x02 \x01(\x0b\x32\x30.google.cloud.automl.v1beta1.BigQueryDestinationH\x00\x42\r\n\x0b\x64\x65stination"\x1f\n\tGcsSource\x12\x12\n\ninput_uris\x18\x01 \x03(\t"#\n\x0e\x42igQuerySource\x12\x11\n\tinput_uri\x18\x01 \x01(\t"+\n\x0eGcsDestination\x12\x19\n\x11output_uri_prefix\x18\x01 \x01(\t")\n\x13\x42igQueryDestination\x12\x12\n\noutput_uri\x18\x01 \x01(\t"$\n\x0eGcrDestination\x12\x12\n\noutput_uri\x18\x01 \x01(\tB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_INPUTCONFIG_PARAMSENTRY = _descriptor.Descriptor(
+    name="ParamsEntry",
+    full_name="google.cloud.automl.v1beta1.InputConfig.ParamsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.InputConfig.ParamsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.InputConfig.ParamsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=325,
+    serialized_end=370,
+)
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.automl.v1beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.automl.v1beta1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_source",
+            full_name="google.cloud.automl.v1beta1.InputConfig.bigquery_source",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.cloud.automl.v1beta1.InputConfig.params",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INPUTCONFIG_PARAMSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.automl.v1beta1.InputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=106,
+    serialized_end=380,
+)
+
+
+_BATCHPREDICTINPUTCONFIG = _descriptor.Descriptor(
+    name="BatchPredictInputConfig",
+    full_name="google.cloud.automl.v1beta1.BatchPredictInputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.automl.v1beta1.BatchPredictInputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_source",
+            full_name="google.cloud.automl.v1beta1.BatchPredictInputConfig.bigquery_source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.automl.v1beta1.BatchPredictInputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=383,
+    serialized_end=552,
+)
+
+
+_DOCUMENTINPUTCONFIG = _descriptor.Descriptor(
+    name="DocumentInputConfig",
+    full_name="google.cloud.automl.v1beta1.DocumentInputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.automl.v1beta1.DocumentInputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=554,
+    serialized_end=635,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.automl.v1beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.automl.v1beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_destination",
+            full_name="google.cloud.automl.v1beta1.OutputConfig.bigquery_destination",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.automl.v1beta1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=638,
+    serialized_end=821,
+)
+
+
+_BATCHPREDICTOUTPUTCONFIG = _descriptor.Descriptor(
+    name="BatchPredictOutputConfig",
+    full_name="google.cloud.automl.v1beta1.BatchPredictOutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_destination",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOutputConfig.bigquery_destination",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=824,
+    serialized_end=1019,
+)
+
+
+_MODELEXPORTOUTPUTCONFIG_PARAMSENTRY = _descriptor.Descriptor(
+    name="ParamsEntry",
+    full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.ParamsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.ParamsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.ParamsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=325,
+    serialized_end=370,
+)
+
+_MODELEXPORTOUTPUTCONFIG = _descriptor.Descriptor(
+    name="ModelExportOutputConfig",
+    full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcr_destination",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.gcr_destination",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_format",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.model_format",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.params",
+            index=3,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODELEXPORTOUTPUTCONFIG_PARAMSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.automl.v1beta1.ModelExportOutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1022,
+    serialized_end=1357,
+)
+
+
+_EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG = _descriptor.Descriptor(
+    name="ExportEvaluatedExamplesOutputConfig",
+    full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bigquery_destination",
+            full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig.bigquery_destination",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1360,
+    serialized_end=1494,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.automl.v1beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uris",
+            full_name="google.cloud.automl.v1beta1.GcsSource.input_uris",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1496,
+    serialized_end=1527,
+)
+
+
+_BIGQUERYSOURCE = _descriptor.Descriptor(
+    name="BigQuerySource",
+    full_name="google.cloud.automl.v1beta1.BigQuerySource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.automl.v1beta1.BigQuerySource.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1529,
+    serialized_end=1564,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.automl.v1beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri_prefix",
+            full_name="google.cloud.automl.v1beta1.GcsDestination.output_uri_prefix",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1566,
+    serialized_end=1609,
+)
+
+
+_BIGQUERYDESTINATION = _descriptor.Descriptor(
+    name="BigQueryDestination",
+    full_name="google.cloud.automl.v1beta1.BigQueryDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.automl.v1beta1.BigQueryDestination.output_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1611,
+    serialized_end=1652,
+)
+
+
+_GCRDESTINATION = _descriptor.Descriptor(
+    name="GcrDestination",
+    full_name="google.cloud.automl.v1beta1.GcrDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.automl.v1beta1.GcrDestination.output_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1654,
+    serialized_end=1690,
+)
+
+_INPUTCONFIG_PARAMSENTRY.containing_type = _INPUTCONFIG
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_INPUTCONFIG.fields_by_name["bigquery_source"].message_type = _BIGQUERYSOURCE
+_INPUTCONFIG.fields_by_name["params"].message_type = _INPUTCONFIG_PARAMSENTRY
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["gcs_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["bigquery_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "bigquery_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_BATCHPREDICTINPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_BATCHPREDICTINPUTCONFIG.fields_by_name[
+    "bigquery_source"
+].message_type = _BIGQUERYSOURCE
+_BATCHPREDICTINPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _BATCHPREDICTINPUTCONFIG.fields_by_name["gcs_source"]
+)
+_BATCHPREDICTINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _BATCHPREDICTINPUTCONFIG.oneofs_by_name["source"]
+_BATCHPREDICTINPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _BATCHPREDICTINPUTCONFIG.fields_by_name["bigquery_source"]
+)
+_BATCHPREDICTINPUTCONFIG.fields_by_name[
+    "bigquery_source"
+].containing_oneof = _BATCHPREDICTINPUTCONFIG.oneofs_by_name["source"]
+_DOCUMENTINPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.fields_by_name["bigquery_destination"].message_type = _BIGQUERYDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["bigquery_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "bigquery_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_BATCHPREDICTOUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].message_type = _GCSDESTINATION
+_BATCHPREDICTOUTPUTCONFIG.fields_by_name[
+    "bigquery_destination"
+].message_type = _BIGQUERYDESTINATION
+_BATCHPREDICTOUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _BATCHPREDICTOUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_BATCHPREDICTOUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _BATCHPREDICTOUTPUTCONFIG.oneofs_by_name["destination"]
+_BATCHPREDICTOUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _BATCHPREDICTOUTPUTCONFIG.fields_by_name["bigquery_destination"]
+)
+_BATCHPREDICTOUTPUTCONFIG.fields_by_name[
+    "bigquery_destination"
+].containing_oneof = _BATCHPREDICTOUTPUTCONFIG.oneofs_by_name["destination"]
+_MODELEXPORTOUTPUTCONFIG_PARAMSENTRY.containing_type = _MODELEXPORTOUTPUTCONFIG
+_MODELEXPORTOUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].message_type = _GCSDESTINATION
+_MODELEXPORTOUTPUTCONFIG.fields_by_name[
+    "gcr_destination"
+].message_type = _GCRDESTINATION
+_MODELEXPORTOUTPUTCONFIG.fields_by_name[
+    "params"
+].message_type = _MODELEXPORTOUTPUTCONFIG_PARAMSENTRY
+_MODELEXPORTOUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _MODELEXPORTOUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_MODELEXPORTOUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _MODELEXPORTOUTPUTCONFIG.oneofs_by_name["destination"]
+_MODELEXPORTOUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _MODELEXPORTOUTPUTCONFIG.fields_by_name["gcr_destination"]
+)
+_MODELEXPORTOUTPUTCONFIG.fields_by_name[
+    "gcr_destination"
+].containing_oneof = _MODELEXPORTOUTPUTCONFIG.oneofs_by_name["destination"]
+_EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG.fields_by_name[
+    "bigquery_destination"
+].message_type = _BIGQUERYDESTINATION
+_EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG.fields_by_name["bigquery_destination"]
+)
+_EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG.fields_by_name[
+    "bigquery_destination"
+].containing_oneof = _EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG.oneofs_by_name["destination"]
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["BatchPredictInputConfig"] = _BATCHPREDICTINPUTCONFIG
+DESCRIPTOR.message_types_by_name["DocumentInputConfig"] = _DOCUMENTINPUTCONFIG
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["BatchPredictOutputConfig"] = _BATCHPREDICTOUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["ModelExportOutputConfig"] = _MODELEXPORTOUTPUTCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ExportEvaluatedExamplesOutputConfig"
+] = _EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["BigQuerySource"] = _BIGQUERYSOURCE
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["BigQueryDestination"] = _BIGQUERYDESTINATION
+DESCRIPTOR.message_types_by_name["GcrDestination"] = _GCRDESTINATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        ParamsEntry=_reflection.GeneratedProtocolMessageType(
+            "ParamsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INPUTCONFIG_PARAMSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.io_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.InputConfig.ParamsEntry)
+            ),
+        ),
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""Input configuration for 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.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 (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:
+  
+  -  For Image Classification: CSV file(s) with each line in format:
+     ML\_USE,GCS\_FILE\_PATH,LABEL,LABEL,... GCS\_FILE\_PATH leads to
+     image of up to 30MB in size. Supported extensions: .JPEG, .GIF, .PNG,
+     .WEBP, .BMP, .TIFF, .ICO For 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
+  
+  -  For Image Object Detection: CSV file(s) with each line in format:
+     ML\_USE,GCS\_FILE\_PATH,(LABEL,BOUNDING\_BOX \| ,,,,,,,)
+     GCS\_FILE\_PATH leads to image of up to 30MB in size. Supported
+     extensions: .JPEG, .GIF, .PNG. Each image is assumed to be
+     exhaustively labeled. The minimum allowed BOUNDING\_BOX edge length
+     is 0.01, and no more than 500 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. 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:
+     ML\_USE,GCS\_FILE\_PATH where ML\_USE VALIDATE value should not be
+     used. The GCS\_FILE\_PATH should lead to another .csv file which
+     describes examples that have 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 end has to be after the start. 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 shuold
+     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,,,
+  
+  -  For Video Object Tracking: CSV file(s) with each line in format:
+     ML\_USE,GCS\_FILE\_PATH where ML\_USE VALIDATE value should not be
+     used. The GCS\_FILE\_PATH should lead to another .csv file which
+     describes examples that have given ML\_USE, using one of 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\_IDs 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,,,,,,,,,,,
+  -  For Text Extraction: CSV file(s) with each line in format:
+     ML\_USE,GCS\_FILE\_PATH 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, 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 TEST,gs://folder/file3.jsonl 
+  
+  -  For Text Classification: CSV file(s) with each line in format:
+     ML\_USE,(TEXT\_SNIPPET \| GCS\_FILE\_PATH),LABEL,LABEL,...
+     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 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 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. 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, 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 is
+     treated as to be imported text snippet. In both cases, the text
+     snippet must be up to 500 characters long. 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 is concatenated into a single
+  
+  [primary\_table][google.cloud.automl.v1beta1.TablesDatasetMetadata.primary\_table\_name]
+  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.
+  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 = A path to file on GCS, e.g. "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 an 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 = A content of a text snippet, UTF-8 encoded, enclosed
+  within double quotes (""). 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 huge.
+  
+  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.
+  
+  
+  Attributes:
+      source:
+          The source of the input.
+      gcs_source:
+          The Google Cloud Storage location for the input content. In
+          ImportData, the gcs\_source points to a csv with structure
+          described in the comment.
+      bigquery_source:
+          The BigQuery location for the input content.
+      params:
+          Additional domain-specific parameters describing the semantic
+          of the imported data, any string must be up to 25000
+          characters long.  -  For Tables: ``schema_inference_version``
+          - (integer) Required. The    version of the algorithm that
+          should be used for the initial    inference of the schema
+          (columns' DataTypes) of the table the data is    being
+          imported into. Allowed values: "1".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+_sym_db.RegisterMessage(InputConfig.ParamsEntry)
+
+BatchPredictInputConfig = _reflection.GeneratedProtocolMessageType(
+    "BatchPredictInputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHPREDICTINPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""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.v1beta1.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:
+  
+  -  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
+     GCS\_FILE\_PATH leads to 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 end has to be after the start. Three sample rows:
+     gs://folder/video1.mp4,10,40 gs://folder/video1.mp4,20,60
+     gs://folder/vid2.mov,0,inf
+  
+  -  For Video Object Tracking: CSV file(s) with each line in format:
+     GCS\_FILE\_PATH,TIME\_SEGMENT\_START,TIME\_SEGMENT\_END
+     GCS\_FILE\_PATH leads to 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 end has to be after the start. Three sample rows:
+     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 formats may be used). The in-line .JSONL
+     file(s) contain 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. The document .JSONL file(s)
+     contain, per line, a proto that wraps a Document proto with
+     input\_config set. Only PDF documents are supported now, and each
+     document must be up to 2MB large. Any given .JSONL file must be 100MB
+     or smaller, and no more than 20 files may be given. 
+  
+  -  For Tables: Either
+     [gcs\_source][google.cloud.automl.v1beta1.InputConfig.gcs\_source] or
+  
+  [bigquery\_source][google.cloud.automl.v1beta1.InputConfig.bigquery\_source].
+  GCS case: 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.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. 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"}]}
+  BigQuery case: An 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.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
+  
+  [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.
+  
+  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 example that has a time dimension (e.g. video). TIME\_SEGMENT\_END =
+  TIME\_OFFSET Expresses an end, exclusive, of a time segment within an
+  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.
+  
+  
+  Attributes:
+      source:
+          Required. The source of the input.
+      gcs_source:
+          The Google Cloud Storage location for the input content.
+      bigquery_source:
+          The BigQuery location for the input content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictInputConfig)
+    ),
+)
+_sym_db.RegisterMessage(BatchPredictInputConfig)
+
+DocumentInputConfig = _reflection.GeneratedProtocolMessageType(
+    "DocumentInputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTINPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""Input configuration of a
+  [Document][google.cloud.automl.v1beta1.Document].
+  
+  
+  Attributes:
+      gcs_source:
+          The Google Cloud Storage location of the document file. Only a
+          single path should be given. Max supported size: 512MB.
+          Supported extensions: .PDF.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DocumentInputConfig)
+    ),
+)
+_sym_db.RegisterMessage(DocumentInputConfig)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""
+-  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)
+     \\tTEXT\_SNIPPET (in target language)
+  
+  -  For Tables: Output depends on whether the dataset was imported from
+     GCS or BigQuery. GCS case:
+  
+  [gcs\_destination][google.cloud.automl.v1beta1.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.v1beta1.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_<automl-dataset-display-name>_<timestamp-of-export-call>``
+  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.
+  
+  
+  Attributes:
+      destination:
+          Required. The destination of the output.
+      gcs_destination:
+          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.
+      bigquery_destination:
+          The BigQuery location where the output is to be written to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+BatchPredictOutputConfig = _reflection.GeneratedProtocolMessageType(
+    "BatchPredictOutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHPREDICTOUTPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""Output configuration for BatchPredict Action.
+  
+  As destination the
+  
+  [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 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:%20//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:%20//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 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:%20//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:%20//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:%20//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.v1beta1.BatchPredictOutputConfig.gcs\_destination]
+  or
+  
+  [bigquery\_destination][google.cloud.automl.v1beta1.BatchPredictOutputConfig.bigquery\_destination]
+  is set (either is allowed). GCS 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.v1beta1.TablesModelMetadata.prediction\_type]:
+  Each .csv file will contain a header, listing all columns'
+  
+  [display\_name-s][google.cloud.automl.v1beta1.ColumnSpec.display\_name]
+  given on input followed by M target column names in the format of
+  
+  "<[target\_column\_specs][google.cloud.automl.v1beta1.TablesModelMetadata.target\_column\_spec]
+  
+  [display\_name][google.cloud.automl.v1beta1.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.v1beta1.TablesAnnotation.score]. For
+  REGRESSION and FORECASTING
+  
+  [prediction\_type-s][google.cloud.automl.v1beta1.TablesModelMetadata.prediction\_type]:
+  Each .csv file will contain a header, listing all columns'
+  [display\_name-s][google.cloud.automl.v1beta1.display\_name] given on
+  input followed by the predicted target column with name in the format of
+  
+  "predicted\_<[target\_column\_specs][google.cloud.automl.v1beta1.TablesModelMetadata.target\_column\_spec]
+  
+  [display\_name][google.cloud.automl.v1beta1.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:%20//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.v1beta1.OutputConfig.bigquery\_destination]
+  pointing to a BigQuery project must be set. In the given project a new
+  dataset will be created with name
+  ``prediction_<model-display-name>_<timestamp-of-prediction-call>`` 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.v1beta1.ColumnSpec.display\_name]
+  followed by the target column with name in the format of
+  
+  "predicted\_<[target\_column\_specs][google.cloud.automl.v1beta1.TablesModelMetadata.target\_column\_spec]
+  
+  [display\_name][google.cloud.automl.v1beta1.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.v1beta1.AnnotationPayload],
+  represented as STRUCT-s, containing
+  [TablesAnnotation][google.cloud.automl.v1beta1.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.v1beta1.TablesModelMetadata.target\_column\_spec]
+  
+  [display\_name][google.cloud.automl.v1beta1.ColumnSpec.display\_name]>",
+  and as a value has
+  
+  ```google.rpc.Status`` <https:%20//github.com/googleapis/googleapis/blob/master/google/rpc/status.proto>`__
+  represented as a STRUCT, and containing only ``code`` and ``message``.
+  
+  
+  Attributes:
+      destination:
+          Required. The destination of the output.
+      gcs_destination:
+          The Google Cloud Storage location of the directory where the
+          output is to be written to.
+      bigquery_destination:
+          The BigQuery location where the output is to be written to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictOutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(BatchPredictOutputConfig)
+
+ModelExportOutputConfig = _reflection.GeneratedProtocolMessageType(
+    "ModelExportOutputConfig",
+    (_message.Message,),
+    dict(
+        ParamsEntry=_reflection.GeneratedProtocolMessageType(
+            "ParamsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODELEXPORTOUTPUTCONFIG_PARAMSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.io_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ModelExportOutputConfig.ParamsEntry)
+            ),
+        ),
+        DESCRIPTOR=_MODELEXPORTOUTPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""Output configuration for ModelExport Action.
+  
+  
+  Attributes:
+      destination:
+          Required. The destination of the output.
+      gcs_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".  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.
+      gcr_destination:
+          The GCR location where model image is to be pushed to. This
+          location may only be set for the following model formats:
+          "docker".  The model image will be created under the given
+          URI.
+      model_format:
+          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", "docker".  -  For Image Classification
+          mobile-core-ml-low-latency-1,    mobile-core-ml-versatile-1,
+          mobile-core-ml-high-accuracy-1:    "core\_ml" (default).
+          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. -
+          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.
+      params:
+          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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ModelExportOutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(ModelExportOutputConfig)
+_sym_db.RegisterMessage(ModelExportOutputConfig.ParamsEntry)
+
+ExportEvaluatedExamplesOutputConfig = _reflection.GeneratedProtocolMessageType(
+    "ExportEvaluatedExamplesOutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""Output configuration for ExportEvaluatedExamples Action. Note that this
+  call is available only for 30 days since the moment the model was
+  evaluated. The output depends on the domain, as follows (note that only
+  examples from the TEST set are exported):
+  
+  -  For Tables:
+  
+  [bigquery\_destination][google.cloud.automl.v1beta1.OutputConfig.bigquery\_destination]
+  pointing to a BigQuery project must be set. In the given project a new
+  dataset will be created with name
+  
+  ``export_evaluated_examples_<model-display-name>_<timestamp-of-export-call>``
+  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
+  an ``evaluated_examples`` table will be created. It will have all the
+  same columns as the
+  
+  [primary\_table][google.cloud.automl.v1beta1.TablesDatasetMetadata.primary\_table\_spec\_id]
+  of the [dataset][google.cloud.automl.v1beta1.Model.dataset\_id] from
+  which the model was created, as they were at the moment of model's
+  evaluation (this includes the target column with its ground truth),
+  followed by a column called "predicted\_". That last column will contain
+  the model's prediction result for each respective row, given as ARRAY of
+  [AnnotationPayloads][google.cloud.automl.v1beta1.AnnotationPayload],
+  represented as STRUCT-s, containing
+  [TablesAnnotation][google.cloud.automl.v1beta1.TablesAnnotation].
+  
+  
+  Attributes:
+      destination:
+          Required. The destination of the output.
+      bigquery_destination:
+          The BigQuery location where the output is to be written to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(ExportEvaluatedExamplesOutputConfig)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""The Google Cloud Storage location for the input content.
+  
+  
+  Attributes:
+      input_uris:
+          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
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+BigQuerySource = _reflection.GeneratedProtocolMessageType(
+    "BigQuerySource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYSOURCE,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""The BigQuery location for the input content.
+  
+  
+  Attributes:
+      input_uri:
+          Required. BigQuery URI to a table, up to 2000 characters long.
+          Accepted forms: \* BigQuery path e.g.
+          bq://projectId.bqDatasetId.bqTableId
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BigQuerySource)
+    ),
+)
+_sym_db.RegisterMessage(BigQuerySource)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""The Google Cloud Storage location where the output is to be written to.
+  
+  
+  Attributes:
+      output_uri_prefix:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+BigQueryDestination = _reflection.GeneratedProtocolMessageType(
+    "BigQueryDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYDESTINATION,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""The BigQuery location for the output content.
+  
+  
+  Attributes:
+      output_uri:
+          Required. BigQuery URI to a project, up to 2000 characters
+          long. Accepted forms: \* BigQuery path e.g. bq://projectId
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BigQueryDestination)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryDestination)
+
+GcrDestination = _reflection.GeneratedProtocolMessageType(
+    "GcrDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCRDESTINATION,
+        __module__="google.cloud.automl_v1beta1.proto.io_pb2",
+        __doc__="""The GCR location where the image must be pushed to.
+  
+  
+  Attributes:
+      output_uri:
+          Required. Google Contained Registry URI of the new image, up
+          to 2000 characters long. See  https:
+          //cloud.google.com/container-registry/do // cs/pushing-and-
+          pulling#pushing\_an\_image\_to\_a\_registry Accepted forms: \*
+          [HOSTNAME]/[PROJECT-ID]/[IMAGE] \* [HOSTNAME]/[PROJECT-
+          ID]/[IMAGE]:[TAG]  The requesting user must have permission to
+          push images the project.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GcrDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcrDestination)
+
+
+DESCRIPTOR._options = None
+_INPUTCONFIG_PARAMSENTRY._options = None
+_MODELEXPORTOUTPUTCONFIG_PARAMSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/io_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/io_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/io_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/model.proto b/automl/google/cloud/automl_v1beta1/proto/model.proto
new file mode 100644
index 000000000000..8c53d9b5832f
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/model.proto
@@ -0,0 +1,103 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/image.proto";
+import "google/cloud/automl/v1beta1/tables.proto";
+import "google/cloud/automl/v1beta1/text.proto";
+import "google/cloud/automl/v1beta1/translation.proto";
+import "google/cloud/automl/v1beta1/video.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// API proto representing a trained machine learning model.
+message 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 video classification models.
+    VideoClassificationModelMetadata video_classification_model_metadata = 23;
+
+    // Metadata for video object tracking models.
+    VideoObjectTrackingModelMetadata video_object_tracking_model_metadata = 21;
+
+    // Metadata for text extraction models.
+    TextExtractionModelMetadata text_extraction_model_metadata = 19;
+
+    // Metadata for Tables models.
+    TablesModelMetadata tables_model_metadata = 24;
+
+    // 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;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/model_evaluation.proto b/automl/google/cloud/automl_v1beta1/proto/model_evaluation.proto
new file mode 100644
index 000000000000..ce2db614a182
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/model_evaluation.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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/classification.proto";
+import "google/cloud/automl/v1beta1/detection.proto";
+import "google/cloud/automl/v1beta1/regression.proto";
+import "google/cloud/automl/v1beta1/tables.proto";
+import "google/cloud/automl/v1beta1/text_extraction.proto";
+import "google/cloud/automl/v1beta1/text_sentiment.proto";
+import "google/cloud/automl/v1beta1/translation.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// Evaluation results of a model.
+message ModelEvaluation {
+  // 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 Tables regression.
+    // Tables problem is considered a regression when the target column
+    // has FLOAT64 DataType.
+    RegressionEvaluationMetrics regression_evaluation_metrics = 24;
+
+    // Model evaluation metrics for translation.
+    TranslationEvaluationMetrics translation_evaluation_metrics = 9;
+
+    // Model evaluation metrics for image object detection.
+    ImageObjectDetectionEvaluationMetrics image_object_detection_evaluation_metrics = 12;
+
+    // Model evaluation metrics for video object tracking.
+    VideoObjectTrackingEvaluationMetrics video_object_tracking_evaluation_metrics = 14;
+
+    // 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.v1beta1.TablesModelMetadata.prediction_type]
+  // the
+  // [display_name][google.cloud.automl.v1beta1.ModelEvaluation.display_name]
+  // field is used.
+  string annotation_spec_id = 2;
+
+  // Output only. The value of
+  // [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
+  // the two model's trainings.
+  // 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.
+  // 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.v1beta1.ModelEvaluation.annotation_spec_id].
+  int32 evaluated_example_count = 6;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2.py b/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2.py
new file mode 100644
index 000000000000..681a2663a1d0
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2.py
@@ -0,0 +1,469 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/model_evaluation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    detection_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    regression_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_regression__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    tables_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_extraction_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__extraction__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_sentiment_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__sentiment__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    translation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/model_evaluation.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/automl_v1beta1/proto/model_evaluation.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x31google/cloud/automl_v1beta1/proto/detection.proto\x1a\x32google/cloud/automl_v1beta1/proto/regression.proto\x1a.google/cloud/automl_v1beta1/proto/tables.proto\x1a\x37google/cloud/automl_v1beta1/proto/text_extraction.proto\x1a\x36google/cloud/automl_v1beta1/proto/text_sentiment.proto\x1a\x33google/cloud/automl_v1beta1/proto/translation.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xa7\x07\n\x0fModelEvaluation\x12i\n!classification_evaluation_metrics\x18\x08 \x01(\x0b\x32<.google.cloud.automl.v1beta1.ClassificationEvaluationMetricsH\x00\x12\x61\n\x1dregression_evaluation_metrics\x18\x18 \x01(\x0b\x32\x38.google.cloud.automl.v1beta1.RegressionEvaluationMetricsH\x00\x12\x63\n\x1etranslation_evaluation_metrics\x18\t \x01(\x0b\x32\x39.google.cloud.automl.v1beta1.TranslationEvaluationMetricsH\x00\x12w\n)image_object_detection_evaluation_metrics\x18\x0c \x01(\x0b\x32\x42.google.cloud.automl.v1beta1.ImageObjectDetectionEvaluationMetricsH\x00\x12u\n(video_object_tracking_evaluation_metrics\x18\x0e \x01(\x0b\x32\x41.google.cloud.automl.v1beta1.VideoObjectTrackingEvaluationMetricsH\x00\x12h\n!text_sentiment_evaluation_metrics\x18\x0b \x01(\x0b\x32;.google.cloud.automl.v1beta1.TextSentimentEvaluationMetricsH\x00\x12j\n"text_extraction_evaluation_metrics\x18\r \x01(\x0b\x32<.google.cloud.automl.v1beta1.TextExtractionEvaluationMetricsH\x00\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1a\n\x12\x61nnotation_spec_id\x18\x02 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x0f \x01(\t\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1f\n\x17\x65valuated_example_count\x18\x06 \x01(\x05\x42\t\n\x07metricsB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_regression__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__extraction__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__sentiment__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_MODELEVALUATION = _descriptor.Descriptor(
+    name="ModelEvaluation",
+    full_name="google.cloud.automl.v1beta1.ModelEvaluation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="classification_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.classification_evaluation_metrics",
+            index=0,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="regression_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.regression_evaluation_metrics",
+            index=1,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="translation_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.translation_evaluation_metrics",
+            index=2,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_object_detection_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.image_object_detection_evaluation_metrics",
+            index=3,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_tracking_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.video_object_tracking_evaluation_metrics",
+            index=4,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_sentiment_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.text_sentiment_evaluation_metrics",
+            index=5,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_extraction_evaluation_metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.text_extraction_evaluation_metrics",
+            index=6,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.name",
+            index=7,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_id",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.annotation_spec_id",
+            index=8,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.display_name",
+            index=9,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.create_time",
+            index=10,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluated_example_count",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.evaluated_example_count",
+            index=11,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="metrics",
+            full_name="google.cloud.automl.v1beta1.ModelEvaluation.metrics",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=526,
+    serialized_end=1461,
+)
+
+_MODELEVALUATION.fields_by_name[
+    "classification_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2._CLASSIFICATIONEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "regression_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_regression__pb2._REGRESSIONEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "translation_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2._TRANSLATIONEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "image_object_detection_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2._IMAGEOBJECTDETECTIONEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "video_object_tracking_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_detection__pb2._VIDEOOBJECTTRACKINGEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "text_sentiment_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__sentiment__pb2._TEXTSENTIMENTEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "text_extraction_evaluation_metrics"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__extraction__pb2._TEXTEXTRACTIONEVALUATIONMETRICS
+)
+_MODELEVALUATION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["classification_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "classification_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["regression_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "regression_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["translation_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "translation_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["image_object_detection_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "image_object_detection_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["video_object_tracking_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "video_object_tracking_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["text_sentiment_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "text_sentiment_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+_MODELEVALUATION.oneofs_by_name["metrics"].fields.append(
+    _MODELEVALUATION.fields_by_name["text_extraction_evaluation_metrics"]
+)
+_MODELEVALUATION.fields_by_name[
+    "text_extraction_evaluation_metrics"
+].containing_oneof = _MODELEVALUATION.oneofs_by_name["metrics"]
+DESCRIPTOR.message_types_by_name["ModelEvaluation"] = _MODELEVALUATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ModelEvaluation = _reflection.GeneratedProtocolMessageType(
+    "ModelEvaluation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODELEVALUATION,
+        __module__="google.cloud.automl_v1beta1.proto.model_evaluation_pb2",
+        __doc__="""Evaluation results of a model.
+  
+  
+  Attributes:
+      metrics:
+          Output only. Problem type specific evaluation metrics.
+      classification_evaluation_metrics:
+          Model evaluation metrics for image, text, video and tables
+          classification. Tables problem is considered a classification
+          when the target column is CATEGORY DataType.
+      regression_evaluation_metrics:
+          Model evaluation metrics for Tables regression. Tables problem
+          is considered a regression when the target column has FLOAT64
+          DataType.
+      translation_evaluation_metrics:
+          Model evaluation metrics for translation.
+      image_object_detection_evaluation_metrics:
+          Model evaluation metrics for image object detection.
+      video_object_tracking_evaluation_metrics:
+          Model evaluation metrics for video object tracking.
+      text_sentiment_evaluation_metrics:
+          Evaluation metrics for text sentiment models.
+      text_extraction_evaluation_metrics:
+          Evaluation metrics for text extraction models.
+      name:
+          Output only. Resource name of the model evaluation. Format:  `
+          `projects/{project_id}/locations/{location_id}/models/{model_i
+          d}/modelEvaluations/{model_evaluation_id}``
+      annotation_spec_id:
+          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.v1bet
+          a1.TablesModelMetadata.prediction\_type] the [display\_name][g
+          oogle.cloud.automl.v1beta1.ModelEvaluation.display\_name]
+          field is used.
+      display_name:
+          Output only. The value of [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 the two model's trainings. For Tables
+          CLASSIFICATION  [prediction\_type-s][google.cloud.automl.v1bet
+          a1.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.
+      create_time:
+          Output only. Timestamp when this model evaluation was created.
+      evaluated_example_count:
+          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.v1beta1.ModelE
+          valuation.annotation\_spec\_id].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ModelEvaluation)
+    ),
+)
+_sym_db.RegisterMessage(ModelEvaluation)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/model_evaluation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/model_pb2.py b/automl/google/cloud/automl_v1beta1/proto/model_pb2.py
new file mode 100644
index 000000000000..f669af2061e7
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/model_pb2.py
@@ -0,0 +1,555 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/model.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    image_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    tables_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    text_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    translation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    video_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/model.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/automl_v1beta1/proto/model.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a-google/cloud/automl_v1beta1/proto/image.proto\x1a.google/cloud/automl_v1beta1/proto/tables.proto\x1a,google/cloud/automl_v1beta1/proto/text.proto\x1a\x33google/cloud/automl_v1beta1/proto/translation.proto\x1a-google/cloud/automl_v1beta1/proto/video.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xf2\t\n\x05Model\x12[\n\x1atranslation_model_metadata\x18\x0f \x01(\x0b\x32\x35.google.cloud.automl.v1beta1.TranslationModelMetadataH\x00\x12l\n#image_classification_model_metadata\x18\r \x01(\x0b\x32=.google.cloud.automl.v1beta1.ImageClassificationModelMetadataH\x00\x12j\n"text_classification_model_metadata\x18\x0e \x01(\x0b\x32<.google.cloud.automl.v1beta1.TextClassificationModelMetadataH\x00\x12o\n%image_object_detection_model_metadata\x18\x14 \x01(\x0b\x32>.google.cloud.automl.v1beta1.ImageObjectDetectionModelMetadataH\x00\x12l\n#video_classification_model_metadata\x18\x17 \x01(\x0b\x32=.google.cloud.automl.v1beta1.VideoClassificationModelMetadataH\x00\x12m\n$video_object_tracking_model_metadata\x18\x15 \x01(\x0b\x32=.google.cloud.automl.v1beta1.VideoObjectTrackingModelMetadataH\x00\x12\x62\n\x1etext_extraction_model_metadata\x18\x13 \x01(\x0b\x32\x38.google.cloud.automl.v1beta1.TextExtractionModelMetadataH\x00\x12Q\n\x15tables_model_metadata\x18\x18 \x01(\x0b\x32\x30.google.cloud.automl.v1beta1.TablesModelMetadataH\x00\x12`\n\x1dtext_sentiment_model_metadata\x18\x16 \x01(\x0b\x32\x37.google.cloud.automl.v1beta1.TextSentimentModelMetadataH\x00\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x12\n\ndataset_id\x18\x03 \x01(\t\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12L\n\x10\x64\x65ployment_state\x18\x08 \x01(\x0e\x32\x32.google.cloud.automl.v1beta1.Model.DeploymentState"Q\n\x0f\x44\x65ploymentState\x12 \n\x1c\x44\x45PLOYMENT_STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x44\x45PLOYED\x10\x01\x12\x0e\n\nUNDEPLOYED\x10\x02\x42\x10\n\x0emodel_metadataB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_MODEL_DEPLOYMENTSTATE = _descriptor.EnumDescriptor(
+    name="DeploymentState",
+    full_name="google.cloud.automl.v1beta1.Model.DeploymentState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DEPLOYMENT_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEPLOYED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNDEPLOYED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1550,
+    serialized_end=1631,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_DEPLOYMENTSTATE)
+
+
+_MODEL = _descriptor.Descriptor(
+    name="Model",
+    full_name="google.cloud.automl.v1beta1.Model",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="translation_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.translation_model_metadata",
+            index=0,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_classification_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.image_classification_model_metadata",
+            index=1,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_classification_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.text_classification_model_metadata",
+            index=2,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_object_detection_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.image_object_detection_model_metadata",
+            index=3,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.video_classification_model_metadata",
+            index=4,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_tracking_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.video_object_tracking_model_metadata",
+            index=5,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_extraction_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.text_extraction_model_metadata",
+            index=6,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tables_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.tables_model_metadata",
+            index=7,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_sentiment_model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.text_sentiment_model_metadata",
+            index=8,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.Model.name",
+            index=9,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.automl.v1beta1.Model.display_name",
+            index=10,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.automl.v1beta1.Model.dataset_id",
+            index=11,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.automl.v1beta1.Model.create_time",
+            index=12,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.automl.v1beta1.Model.update_time",
+            index=13,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deployment_state",
+            full_name="google.cloud.automl.v1beta1.Model.deployment_state",
+            index=14,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_MODEL_DEPLOYMENTSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="model_metadata",
+            full_name="google.cloud.automl.v1beta1.Model.model_metadata",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=383,
+    serialized_end=1649,
+)
+
+_MODEL.fields_by_name[
+    "translation_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_translation__pb2._TRANSLATIONMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "image_classification_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2._IMAGECLASSIFICATIONMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "text_classification_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2._TEXTCLASSIFICATIONMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "image_object_detection_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2._IMAGEOBJECTDETECTIONMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "video_classification_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2._VIDEOCLASSIFICATIONMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "video_object_tracking_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_video__pb2._VIDEOOBJECTTRACKINGMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "text_extraction_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2._TEXTEXTRACTIONMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "tables_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_tables__pb2._TABLESMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "text_sentiment_model_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__pb2._TEXTSENTIMENTMODELMETADATA
+)
+_MODEL.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_MODEL.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_MODEL.fields_by_name["deployment_state"].enum_type = _MODEL_DEPLOYMENTSTATE
+_MODEL_DEPLOYMENTSTATE.containing_type = _MODEL
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["translation_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "translation_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["image_classification_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "image_classification_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["text_classification_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "text_classification_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["image_object_detection_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "image_object_detection_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["video_classification_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "video_classification_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["video_object_tracking_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "video_object_tracking_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["text_extraction_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "text_extraction_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["tables_model_metadata"]
+)
+_MODEL.fields_by_name["tables_model_metadata"].containing_oneof = _MODEL.oneofs_by_name[
+    "model_metadata"
+]
+_MODEL.oneofs_by_name["model_metadata"].fields.append(
+    _MODEL.fields_by_name["text_sentiment_model_metadata"]
+)
+_MODEL.fields_by_name[
+    "text_sentiment_model_metadata"
+].containing_oneof = _MODEL.oneofs_by_name["model_metadata"]
+DESCRIPTOR.message_types_by_name["Model"] = _MODEL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Model = _reflection.GeneratedProtocolMessageType(
+    "Model",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODEL,
+        __module__="google.cloud.automl_v1beta1.proto.model_pb2",
+        __doc__="""API proto representing a trained machine learning model.
+  
+  
+  Attributes:
+      model_metadata:
+          Required. The model metadata that is specific to the problem
+          type. Must match the metadata type of the dataset used to
+          train the model.
+      translation_model_metadata:
+          Metadata for translation models.
+      image_classification_model_metadata:
+          Metadata for image classification models.
+      text_classification_model_metadata:
+          Metadata for text classification models.
+      image_object_detection_model_metadata:
+          Metadata for image object detection models.
+      video_classification_model_metadata:
+          Metadata for video classification models.
+      video_object_tracking_model_metadata:
+          Metadata for video object tracking models.
+      text_extraction_model_metadata:
+          Metadata for text extraction models.
+      tables_model_metadata:
+          Metadata for Tables models.
+      text_sentiment_model_metadata:
+          Metadata for text sentiment models.
+      name:
+          Output only. Resource name of the model. Format: ``projects/{p
+          roject_id}/locations/{location_id}/models/{model_id}``
+      display_name:
+          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.
+      dataset_id:
+          Required. The resource ID of the dataset used to create the
+          model. The dataset must come from the same ancestor project
+          and location.
+      create_time:
+          Output only. Timestamp when the model training finished and
+          can be used for prediction.
+      update_time:
+          Output only. Timestamp when this model was last updated.
+      deployment_state:
+          Output only. Deployment state of the model. A model can only
+          serve prediction requests after it gets deployed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.Model)
+    ),
+)
+_sym_db.RegisterMessage(Model)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/model_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/model_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/model_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/operations.proto b/automl/google/cloud/automl_v1beta1/proto/operations.proto
new file mode 100644
index 000000000000..aba18cd6715c
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/operations.proto
@@ -0,0 +1,190 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/io.proto";
+import "google/cloud/automl/v1beta1/model.proto";
+import "google/cloud/automl/v1beta1/model_evaluation.proto";
+import "google/protobuf/empty.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/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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 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;
+
+    // Details of ExportEvaluatedExamples operation.
+    ExportEvaluatedExamplesOperationMetadata export_evaluated_examples_details = 26;
+  }
+
+  // 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 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.v1beta1.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;
+
+      // The path of the BigQuery dataset created, in bq://projectId.bqDatasetId
+      // format, into which the exported data is written.
+      string bigquery_output_dataset = 2;
+    }
+  }
+
+  // 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.v1beta1.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;
+
+      // The path of the BigQuery dataset created, in bq://projectId.bqDatasetId
+      // format, into which the prediction output is written.
+      string bigquery_output_dataset = 2;
+    }
+  }
+
+  // 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.v1beta1.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;
+}
+
+// Details of EvaluatedExamples operation.
+message ExportEvaluatedExamplesOperationMetadata {
+  // Further describes the output of the evaluated examples export.
+  // Supplements
+  //
+  // [ExportEvaluatedExamplesOutputConfig][google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig].
+  message ExportEvaluatedExamplesOutputInfo {
+    // The path of the BigQuery dataset created, in bq://projectId.bqDatasetId
+    // format, into which the output of export evaluated examples is written.
+    string bigquery_output_dataset = 2;
+  }
+
+  // Output only. Information further describing the output of this evaluated
+  // examples export.
+  ExportEvaluatedExamplesOutputInfo output_info = 2;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/operations_pb2.py b/automl/google/cloud/automl_v1beta1/proto/operations_pb2.py
new file mode 100644
index 000000000000..b6e3f132684d
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/operations_pb2.py
@@ -0,0 +1,1286 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/operations.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    io_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    model_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    model_evaluation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/operations.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/automl_v1beta1/proto/operations.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a*google/cloud/automl_v1beta1/proto/io.proto\x1a-google/cloud/automl_v1beta1/proto/model.proto\x1a\x38google/cloud/automl_v1beta1/proto/model_evaluation.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\x8b\x08\n\x11OperationMetadata\x12N\n\x0e\x64\x65lete_details\x18\x08 \x01(\x0b\x32\x34.google.cloud.automl.v1beta1.DeleteOperationMetadataH\x00\x12Y\n\x14\x64\x65ploy_model_details\x18\x18 \x01(\x0b\x32\x39.google.cloud.automl.v1beta1.DeployModelOperationMetadataH\x00\x12]\n\x16undeploy_model_details\x18\x19 \x01(\x0b\x32;.google.cloud.automl.v1beta1.UndeployModelOperationMetadataH\x00\x12Y\n\x14\x63reate_model_details\x18\n \x01(\x0b\x32\x39.google.cloud.automl.v1beta1.CreateModelOperationMetadataH\x00\x12W\n\x13import_data_details\x18\x0f \x01(\x0b\x32\x38.google.cloud.automl.v1beta1.ImportDataOperationMetadataH\x00\x12[\n\x15\x62\x61tch_predict_details\x18\x10 \x01(\x0b\x32:.google.cloud.automl.v1beta1.BatchPredictOperationMetadataH\x00\x12W\n\x13\x65xport_data_details\x18\x15 \x01(\x0b\x32\x38.google.cloud.automl.v1beta1.ExportDataOperationMetadataH\x00\x12Y\n\x14\x65xport_model_details\x18\x16 \x01(\x0b\x32\x39.google.cloud.automl.v1beta1.ExportModelOperationMetadataH\x00\x12r\n!export_evaluated_examples_details\x18\x1a \x01(\x0b\x32\x45.google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadataH\x00\x12\x18\n\x10progress_percent\x18\r \x01(\x05\x12,\n\x10partial_failures\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\t\n\x07\x64\x65tails"\x19\n\x17\x44\x65leteOperationMetadata"\x1e\n\x1c\x44\x65ployModelOperationMetadata" \n\x1eUndeployModelOperationMetadata"\x1e\n\x1c\x43reateModelOperationMetadata"\x1d\n\x1bImportDataOperationMetadata"\xef\x01\n\x1b\x45xportDataOperationMetadata\x12\x62\n\x0boutput_info\x18\x01 \x01(\x0b\x32M.google.cloud.automl.v1beta1.ExportDataOperationMetadata.ExportDataOutputInfo\x1al\n\x14\x45xportDataOutputInfo\x12\x1e\n\x14gcs_output_directory\x18\x01 \x01(\tH\x00\x12!\n\x17\x62igquery_output_dataset\x18\x02 \x01(\tH\x00\x42\x11\n\x0foutput_location"\xc3\x02\n\x1d\x42\x61tchPredictOperationMetadata\x12J\n\x0cinput_config\x18\x01 \x01(\x0b\x32\x34.google.cloud.automl.v1beta1.BatchPredictInputConfig\x12\x66\n\x0boutput_info\x18\x02 \x01(\x0b\x32Q.google.cloud.automl.v1beta1.BatchPredictOperationMetadata.BatchPredictOutputInfo\x1an\n\x16\x42\x61tchPredictOutputInfo\x12\x1e\n\x14gcs_output_directory\x18\x01 \x01(\tH\x00\x12!\n\x17\x62igquery_output_dataset\x18\x02 \x01(\tH\x00\x42\x11\n\x0foutput_location"\xbb\x01\n\x1c\x45xportModelOperationMetadata\x12\x64\n\x0boutput_info\x18\x02 \x01(\x0b\x32O.google.cloud.automl.v1beta1.ExportModelOperationMetadata.ExportModelOutputInfo\x1a\x35\n\x15\x45xportModelOutputInfo\x12\x1c\n\x14gcs_output_directory\x18\x01 \x01(\t"\xee\x01\n(ExportEvaluatedExamplesOperationMetadata\x12|\n\x0boutput_info\x18\x02 \x01(\x0b\x32g.google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata.ExportEvaluatedExamplesOutputInfo\x1a\x44\n!ExportEvaluatedExamplesOutputInfo\x12\x1f\n\x17\x62igquery_output_dataset\x18\x02 \x01(\tB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_OPERATIONMETADATA = _descriptor.Descriptor(
+    name="OperationMetadata",
+    full_name="google.cloud.automl.v1beta1.OperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="delete_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.delete_details",
+            index=0,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deploy_model_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.deploy_model_details",
+            index=1,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="undeploy_model_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.undeploy_model_details",
+            index=2,
+            number=25,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_model_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.create_model_details",
+            index=3,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_data_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.import_data_details",
+            index=4,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="batch_predict_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.batch_predict_details",
+            index=5,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="export_data_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.export_data_details",
+            index=6,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="export_model_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.export_model_details",
+            index=7,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="export_evaluated_examples_details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.export_evaluated_examples_details",
+            index=8,
+            number=26,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.progress_percent",
+            index=9,
+            number=13,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_failures",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.partial_failures",
+            index=10,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.create_time",
+            index=11,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.update_time",
+            index=12,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="details",
+            full_name="google.cloud.automl.v1beta1.OperationMetadata.details",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=350,
+    serialized_end=1385,
+)
+
+
+_DELETEOPERATIONMETADATA = _descriptor.Descriptor(
+    name="DeleteOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.DeleteOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1387,
+    serialized_end=1412,
+)
+
+
+_DEPLOYMODELOPERATIONMETADATA = _descriptor.Descriptor(
+    name="DeployModelOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.DeployModelOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1414,
+    serialized_end=1444,
+)
+
+
+_UNDEPLOYMODELOPERATIONMETADATA = _descriptor.Descriptor(
+    name="UndeployModelOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.UndeployModelOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1446,
+    serialized_end=1478,
+)
+
+
+_CREATEMODELOPERATIONMETADATA = _descriptor.Descriptor(
+    name="CreateModelOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.CreateModelOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1480,
+    serialized_end=1510,
+)
+
+
+_IMPORTDATAOPERATIONMETADATA = _descriptor.Descriptor(
+    name="ImportDataOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.ImportDataOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1512,
+    serialized_end=1541,
+)
+
+
+_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO = _descriptor.Descriptor(
+    name="ExportDataOutputInfo",
+    full_name="google.cloud.automl.v1beta1.ExportDataOperationMetadata.ExportDataOutputInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_output_directory",
+            full_name="google.cloud.automl.v1beta1.ExportDataOperationMetadata.ExportDataOutputInfo.gcs_output_directory",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_output_dataset",
+            full_name="google.cloud.automl.v1beta1.ExportDataOperationMetadata.ExportDataOutputInfo.bigquery_output_dataset",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="output_location",
+            full_name="google.cloud.automl.v1beta1.ExportDataOperationMetadata.ExportDataOutputInfo.output_location",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1675,
+    serialized_end=1783,
+)
+
+_EXPORTDATAOPERATIONMETADATA = _descriptor.Descriptor(
+    name="ExportDataOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.ExportDataOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_info",
+            full_name="google.cloud.automl.v1beta1.ExportDataOperationMetadata.output_info",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1544,
+    serialized_end=1783,
+)
+
+
+_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO = _descriptor.Descriptor(
+    name="BatchPredictOutputInfo",
+    full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata.BatchPredictOutputInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_output_directory",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata.BatchPredictOutputInfo.gcs_output_directory",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_output_dataset",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata.BatchPredictOutputInfo.bigquery_output_dataset",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="output_location",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata.BatchPredictOutputInfo.output_location",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1999,
+    serialized_end=2109,
+)
+
+_BATCHPREDICTOPERATIONMETADATA = _descriptor.Descriptor(
+    name="BatchPredictOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_info",
+            full_name="google.cloud.automl.v1beta1.BatchPredictOperationMetadata.output_info",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1786,
+    serialized_end=2109,
+)
+
+
+_EXPORTMODELOPERATIONMETADATA_EXPORTMODELOUTPUTINFO = _descriptor.Descriptor(
+    name="ExportModelOutputInfo",
+    full_name="google.cloud.automl.v1beta1.ExportModelOperationMetadata.ExportModelOutputInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_output_directory",
+            full_name="google.cloud.automl.v1beta1.ExportModelOperationMetadata.ExportModelOutputInfo.gcs_output_directory",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2246,
+    serialized_end=2299,
+)
+
+_EXPORTMODELOPERATIONMETADATA = _descriptor.Descriptor(
+    name="ExportModelOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.ExportModelOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_info",
+            full_name="google.cloud.automl.v1beta1.ExportModelOperationMetadata.output_info",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_EXPORTMODELOPERATIONMETADATA_EXPORTMODELOUTPUTINFO],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2112,
+    serialized_end=2299,
+)
+
+
+_EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA_EXPORTEVALUATEDEXAMPLESOUTPUTINFO = _descriptor.Descriptor(
+    name="ExportEvaluatedExamplesOutputInfo",
+    full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata.ExportEvaluatedExamplesOutputInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bigquery_output_dataset",
+            full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata.ExportEvaluatedExamplesOutputInfo.bigquery_output_dataset",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2472,
+    serialized_end=2540,
+)
+
+_EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA = _descriptor.Descriptor(
+    name="ExportEvaluatedExamplesOperationMetadata",
+    full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_info",
+            full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata.output_info",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA_EXPORTEVALUATEDEXAMPLESOUTPUTINFO
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2302,
+    serialized_end=2540,
+)
+
+_OPERATIONMETADATA.fields_by_name[
+    "delete_details"
+].message_type = _DELETEOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "deploy_model_details"
+].message_type = _DEPLOYMODELOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "undeploy_model_details"
+].message_type = _UNDEPLOYMODELOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "create_model_details"
+].message_type = _CREATEMODELOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "import_data_details"
+].message_type = _IMPORTDATAOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "batch_predict_details"
+].message_type = _BATCHPREDICTOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "export_data_details"
+].message_type = _EXPORTDATAOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "export_model_details"
+].message_type = _EXPORTMODELOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "export_evaluated_examples_details"
+].message_type = _EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA
+_OPERATIONMETADATA.fields_by_name[
+    "partial_failures"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_OPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["delete_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "delete_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["deploy_model_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "deploy_model_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["undeploy_model_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "undeploy_model_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["create_model_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "create_model_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["import_data_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "import_data_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["batch_predict_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "batch_predict_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["export_data_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "export_data_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["export_model_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "export_model_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_OPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _OPERATIONMETADATA.fields_by_name["export_evaluated_examples_details"]
+)
+_OPERATIONMETADATA.fields_by_name[
+    "export_evaluated_examples_details"
+].containing_oneof = _OPERATIONMETADATA.oneofs_by_name["details"]
+_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.containing_type = (
+    _EXPORTDATAOPERATIONMETADATA
+)
+_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.oneofs_by_name[
+    "output_location"
+].fields.append(
+    _EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.fields_by_name[
+        "gcs_output_directory"
+    ]
+)
+_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.fields_by_name[
+    "gcs_output_directory"
+].containing_oneof = _EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.oneofs_by_name[
+    "output_location"
+]
+_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.oneofs_by_name[
+    "output_location"
+].fields.append(
+    _EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.fields_by_name[
+        "bigquery_output_dataset"
+    ]
+)
+_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.fields_by_name[
+    "bigquery_output_dataset"
+].containing_oneof = _EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO.oneofs_by_name[
+    "output_location"
+]
+_EXPORTDATAOPERATIONMETADATA.fields_by_name[
+    "output_info"
+].message_type = _EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO
+_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.containing_type = (
+    _BATCHPREDICTOPERATIONMETADATA
+)
+_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.oneofs_by_name[
+    "output_location"
+].fields.append(
+    _BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.fields_by_name[
+        "gcs_output_directory"
+    ]
+)
+_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.fields_by_name[
+    "gcs_output_directory"
+].containing_oneof = _BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.oneofs_by_name[
+    "output_location"
+]
+_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.oneofs_by_name[
+    "output_location"
+].fields.append(
+    _BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.fields_by_name[
+        "bigquery_output_dataset"
+    ]
+)
+_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.fields_by_name[
+    "bigquery_output_dataset"
+].containing_oneof = _BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO.oneofs_by_name[
+    "output_location"
+]
+_BATCHPREDICTOPERATIONMETADATA.fields_by_name[
+    "input_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._BATCHPREDICTINPUTCONFIG
+)
+_BATCHPREDICTOPERATIONMETADATA.fields_by_name[
+    "output_info"
+].message_type = _BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO
+_EXPORTMODELOPERATIONMETADATA_EXPORTMODELOUTPUTINFO.containing_type = (
+    _EXPORTMODELOPERATIONMETADATA
+)
+_EXPORTMODELOPERATIONMETADATA.fields_by_name[
+    "output_info"
+].message_type = _EXPORTMODELOPERATIONMETADATA_EXPORTMODELOUTPUTINFO
+_EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA_EXPORTEVALUATEDEXAMPLESOUTPUTINFO.containing_type = (
+    _EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA
+)
+_EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA.fields_by_name[
+    "output_info"
+].message_type = (
+    _EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA_EXPORTEVALUATEDEXAMPLESOUTPUTINFO
+)
+DESCRIPTOR.message_types_by_name["OperationMetadata"] = _OPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["DeleteOperationMetadata"] = _DELETEOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "DeployModelOperationMetadata"
+] = _DEPLOYMODELOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "UndeployModelOperationMetadata"
+] = _UNDEPLOYMODELOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "CreateModelOperationMetadata"
+] = _CREATEMODELOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ImportDataOperationMetadata"
+] = _IMPORTDATAOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ExportDataOperationMetadata"
+] = _EXPORTDATAOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "BatchPredictOperationMetadata"
+] = _BATCHPREDICTOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ExportModelOperationMetadata"
+] = _EXPORTMODELOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ExportEvaluatedExamplesOperationMetadata"
+] = _EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+OperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Metadata used across all long running operations returned by AutoML API.
+  
+  
+  Attributes:
+      details:
+          Ouptut only. Details of specific operation. Even if this field
+          is empty, the presence allows to distinguish different types
+          of operations.
+      delete_details:
+          Details of a Delete operation.
+      deploy_model_details:
+          Details of a DeployModel operation.
+      undeploy_model_details:
+          Details of an UndeployModel operation.
+      create_model_details:
+          Details of CreateModel operation.
+      import_data_details:
+          Details of ImportData operation.
+      batch_predict_details:
+          Details of BatchPredict operation.
+      export_data_details:
+          Details of ExportData operation.
+      export_model_details:
+          Details of ExportModel operation.
+      export_evaluated_examples_details:
+          Details of ExportEvaluatedExamples operation.
+      progress_percent:
+          Output only. Progress of operation. Range: [0, 100]. Not used
+          currently.
+      partial_failures:
+          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.
+      create_time:
+          Output only. Time when the operation was created.
+      update_time:
+          Output only. Time when the operation was updated for the last
+          time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.OperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperationMetadata)
+
+DeleteOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "DeleteOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of operations that perform deletes of any entities.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DeleteOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(DeleteOperationMetadata)
+
+DeployModelOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "DeployModelOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEPLOYMODELOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of DeployModel operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DeployModelOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(DeployModelOperationMetadata)
+
+UndeployModelOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "UndeployModelOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UNDEPLOYMODELOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of UndeployModel operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.UndeployModelOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(UndeployModelOperationMetadata)
+
+CreateModelOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateModelOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEMODELOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of CreateModel operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.CreateModelOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateModelOperationMetadata)
+
+ImportDataOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImportDataOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDATAOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of ImportData operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImportDataOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImportDataOperationMetadata)
+
+ExportDataOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ExportDataOperationMetadata",
+    (_message.Message,),
+    dict(
+        ExportDataOutputInfo=_reflection.GeneratedProtocolMessageType(
+            "ExportDataOutputInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_EXPORTDATAOPERATIONMETADATA_EXPORTDATAOUTPUTINFO,
+                __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+                __doc__="""Further describes this export data's output. Supplements
+    [OutputConfig][google.cloud.automl.v1beta1.OutputConfig].
+    
+    
+    Attributes:
+        output_location:
+            The output location to which the exported data is written.
+        gcs_output_directory:
+            The full path of the Google Cloud Storage directory created,
+            into which the exported data is written.
+        bigquery_output_dataset:
+            The path of the BigQuery dataset created, in
+            bq://projectId.bqDatasetId format, into which the exported
+            data is written.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportDataOperationMetadata.ExportDataOutputInfo)
+            ),
+        ),
+        DESCRIPTOR=_EXPORTDATAOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of ExportData operation.
+  
+  
+  Attributes:
+      output_info:
+          Output only. Information further describing this export data's
+          output.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportDataOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ExportDataOperationMetadata)
+_sym_db.RegisterMessage(ExportDataOperationMetadata.ExportDataOutputInfo)
+
+BatchPredictOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "BatchPredictOperationMetadata",
+    (_message.Message,),
+    dict(
+        BatchPredictOutputInfo=_reflection.GeneratedProtocolMessageType(
+            "BatchPredictOutputInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BATCHPREDICTOPERATIONMETADATA_BATCHPREDICTOUTPUTINFO,
+                __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+                __doc__="""Further describes this batch predict's output. Supplements
+    
+    [BatchPredictOutputConfig][google.cloud.automl.v1beta1.BatchPredictOutputConfig].
+    
+    
+    Attributes:
+        output_location:
+            The output location into which prediction output is written.
+        gcs_output_directory:
+            The full path of the Google Cloud Storage directory created,
+            into which the prediction output is written.
+        bigquery_output_dataset:
+            The path of the BigQuery dataset created, in
+            bq://projectId.bqDatasetId format, into which the prediction
+            output is written.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictOperationMetadata.BatchPredictOutputInfo)
+            ),
+        ),
+        DESCRIPTOR=_BATCHPREDICTOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of BatchPredict operation.
+  
+  
+  Attributes:
+      input_config:
+          Output only. The input config that was given upon starting
+          this batch predict operation.
+      output_info:
+          Output only. Information further describing this batch
+          predict's output.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(BatchPredictOperationMetadata)
+_sym_db.RegisterMessage(BatchPredictOperationMetadata.BatchPredictOutputInfo)
+
+ExportModelOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ExportModelOperationMetadata",
+    (_message.Message,),
+    dict(
+        ExportModelOutputInfo=_reflection.GeneratedProtocolMessageType(
+            "ExportModelOutputInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_EXPORTMODELOPERATIONMETADATA_EXPORTMODELOUTPUTINFO,
+                __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+                __doc__="""Further describes the output of model export. Supplements
+    
+    [ModelExportOutputConfig][google.cloud.automl.v1beta1.ModelExportOutputConfig].
+    
+    
+    Attributes:
+        gcs_output_directory:
+            The full path of the Google Cloud Storage directory created,
+            into which the model will be exported.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportModelOperationMetadata.ExportModelOutputInfo)
+            ),
+        ),
+        DESCRIPTOR=_EXPORTMODELOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of ExportModel operation.
+  
+  
+  Attributes:
+      output_info:
+          Output only. Information further describing the output of this
+          model export.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportModelOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ExportModelOperationMetadata)
+_sym_db.RegisterMessage(ExportModelOperationMetadata.ExportModelOutputInfo)
+
+ExportEvaluatedExamplesOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ExportEvaluatedExamplesOperationMetadata",
+    (_message.Message,),
+    dict(
+        ExportEvaluatedExamplesOutputInfo=_reflection.GeneratedProtocolMessageType(
+            "ExportEvaluatedExamplesOutputInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA_EXPORTEVALUATEDEXAMPLESOUTPUTINFO,
+                __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+                __doc__="""Further describes the output of the evaluated examples export.
+    Supplements
+    
+    [ExportEvaluatedExamplesOutputConfig][google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig].
+    
+    
+    Attributes:
+        bigquery_output_dataset:
+            The path of the BigQuery dataset created, in
+            bq://projectId.bqDatasetId format, into which the output of
+            export evaluated examples is written.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata.ExportEvaluatedExamplesOutputInfo)
+            ),
+        ),
+        DESCRIPTOR=_EXPORTEVALUATEDEXAMPLESOPERATIONMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.operations_pb2",
+        __doc__="""Details of EvaluatedExamples operation.
+  
+  
+  Attributes:
+      output_info:
+          Output only. Information further describing the output of this
+          evaluated examples export.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportEvaluatedExamplesOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ExportEvaluatedExamplesOperationMetadata)
+_sym_db.RegisterMessage(
+    ExportEvaluatedExamplesOperationMetadata.ExportEvaluatedExamplesOutputInfo
+)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/operations_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/operations_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/operations_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/prediction_service.proto b/automl/google/cloud/automl_v1beta1/proto/prediction_service.proto
new file mode 100644
index 000000000000..57f1b794e716
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/prediction_service.proto
@@ -0,0 +1,255 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.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";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "PredictionServiceProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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 will be directly
+  // returned in the response.
+  // Available for following ML problems, and their expected request payloads:
+  // * Image Classification - Image in .JPEG, .GIF or .PNG format, image_bytes
+  //                          up to 30MB.
+  // * Image Object Detection - Image in .JPEG, .GIF or .PNG format, image_bytes
+  //                            up to 30MB.
+  // * Text Classification - TextSnippet, content up to 60,000 characters,
+  //                         UTF-8 encoded.
+  // * Text Extraction - TextSnippet, content up to 30,000 characters,
+  //                     UTF-8 NFC encoded.
+  // * Translation - TextSnippet, content up to 25,000 characters, UTF-8
+  //                 encoded.
+  // * Tables - Row, with column values matching the columns of the model,
+  //            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: "*"
+    };
+  }
+
+  // Perform a batch prediction. Unlike the online
+  // [Predict][google.cloud.automl.v1beta1.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.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
+  // * Tables
+  rpc BatchPredict(BatchPredictRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/models/*}:batchPredict"
+      body: "*"
+    };
+  }
+}
+
+// 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. Payload to perform a prediction on. The payload must match the
+  // problem type that the model was trained to solve.
+  ExamplePayload payload = 2;
+
+  // Additional domain-specific parameters, any string must be up to 25000
+  // characters long.
+  //
+  // *  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 returned in the response. Default is 100, the
+  //        requested value may be limited by server.
+  // *  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].
+  //        The default is false.
+  map<string, string> params = 3;
+}
+
+// Response message for
+// [PredictionService.Predict][google.cloud.automl.v1beta1.PredictionService.Predict].
+message PredictResponse {
+  // Prediction result.
+  // 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:
+  //  `max_bounding_box_count` - (int64) At most that many bounding boxes per
+  //      image could have been returned.
+  //
+  // * For Text Sentiment:
+  //  `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 will be also positive (though
+  //      the least).
+  //      The sentiment_score shouldn't be confused with "score" or "magnitude"
+  //      from the previous Natural Language Sentiment Analysis API.
+  map<string, string> metadata = 2;
+}
+
+// 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. The input configuration for batch prediction.
+  BatchPredictInputConfig input_config = 3;
+
+  // Required. The Configuration specifying where output predictions should
+  // be written.
+  BatchPredictOutputConfig output_config = 4;
+
+  // 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.
+  //    `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.
+  //        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. The default is "false".
+  //    `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.
+  //        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. 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.
+  //    `max_bounding_box_count` - (int64) No more than this number of bounding
+  //        boxes will be returned per frame. Default is 100, the requested
+  //        value may be limited by server.
+  //    `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<string, string> 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.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<string, string> metadata = 1;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2.py b/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2.py
new file mode 100644
index 000000000000..751f16ef8f5b
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2.py
@@ -0,0 +1,880 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/prediction_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.automl_v1beta1.proto import (
+    annotation_payload_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__payload__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    data_items_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    io_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    operations_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_operations__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/prediction_service.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\026PredictionServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/automl_v1beta1/proto/prediction_service.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a:google/cloud/automl_v1beta1/proto/annotation_payload.proto\x1a\x32google/cloud/automl_v1beta1/proto/data_items.proto\x1a*google/cloud/automl_v1beta1/proto/io.proto\x1a\x32google/cloud/automl_v1beta1/proto/operations.proto\x1a#google/longrunning/operations.proto"\xd4\x01\n\x0ePredictRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12<\n\x07payload\x18\x02 \x01(\x0b\x32+.google.cloud.automl.v1beta1.ExamplePayload\x12G\n\x06params\x18\x03 \x03(\x0b\x32\x37.google.cloud.automl.v1beta1.PredictRequest.ParamsEntry\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x9a\x02\n\x0fPredictResponse\x12?\n\x07payload\x18\x01 \x03(\x0b\x32..google.cloud.automl.v1beta1.AnnotationPayload\x12G\n\x12preprocessed_input\x18\x03 \x01(\x0b\x32+.google.cloud.automl.v1beta1.ExamplePayload\x12L\n\x08metadata\x18\x02 \x03(\x0b\x32:.google.cloud.automl.v1beta1.PredictResponse.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xba\x02\n\x13\x42\x61tchPredictRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12J\n\x0cinput_config\x18\x03 \x01(\x0b\x32\x34.google.cloud.automl.v1beta1.BatchPredictInputConfig\x12L\n\routput_config\x18\x04 \x01(\x0b\x32\x35.google.cloud.automl.v1beta1.BatchPredictOutputConfig\x12L\n\x06params\x18\x05 \x03(\x0b\x32<.google.cloud.automl.v1beta1.BatchPredictRequest.ParamsEntry\x1a-\n\x0bParamsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x96\x01\n\x12\x42\x61tchPredictResult\x12O\n\x08metadata\x18\x01 \x03(\x0b\x32=.google.cloud.automl.v1beta1.BatchPredictResult.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x32\xb4\x03\n\x11PredictionService\x12\xa8\x01\n\x07Predict\x12+.google.cloud.automl.v1beta1.PredictRequest\x1a,.google.cloud.automl.v1beta1.PredictResponse"B\x82\xd3\xe4\x93\x02<"7/v1beta1/{name=projects/*/locations/*/models/*}:predict:\x01*\x12\xa8\x01\n\x0c\x42\x61tchPredict\x12\x30.google.cloud.automl.v1beta1.BatchPredictRequest\x1a\x1d.google.longrunning.Operation"G\x82\xd3\xe4\x93\x02\x41"</v1beta1/{name=projects/*/locations/*/models/*}:batchPredict:\x01*\x1aI\xca\x41\x15\x61utoml.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xbd\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x16PredictionServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__payload__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_operations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_PREDICTREQUEST_PARAMSENTRY = _descriptor.Descriptor(
+    name="ParamsEntry",
+    full_name="google.cloud.automl.v1beta1.PredictRequest.ParamsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.PredictRequest.ParamsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.PredictRequest.ParamsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=559,
+    serialized_end=604,
+)
+
+_PREDICTREQUEST = _descriptor.Descriptor(
+    name="PredictRequest",
+    full_name="google.cloud.automl.v1beta1.PredictRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.PredictRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="payload",
+            full_name="google.cloud.automl.v1beta1.PredictRequest.payload",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.cloud.automl.v1beta1.PredictRequest.params",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PREDICTREQUEST_PARAMSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=392,
+    serialized_end=604,
+)
+
+
+_PREDICTRESPONSE_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.automl.v1beta1.PredictResponse.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.PredictResponse.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.PredictResponse.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=842,
+    serialized_end=889,
+)
+
+_PREDICTRESPONSE = _descriptor.Descriptor(
+    name="PredictResponse",
+    full_name="google.cloud.automl.v1beta1.PredictResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="payload",
+            full_name="google.cloud.automl.v1beta1.PredictResponse.payload",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="preprocessed_input",
+            full_name="google.cloud.automl.v1beta1.PredictResponse.preprocessed_input",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.automl.v1beta1.PredictResponse.metadata",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PREDICTRESPONSE_METADATAENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=607,
+    serialized_end=889,
+)
+
+
+_BATCHPREDICTREQUEST_PARAMSENTRY = _descriptor.Descriptor(
+    name="ParamsEntry",
+    full_name="google.cloud.automl.v1beta1.BatchPredictRequest.ParamsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.BatchPredictRequest.ParamsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.BatchPredictRequest.ParamsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=559,
+    serialized_end=604,
+)
+
+_BATCHPREDICTREQUEST = _descriptor.Descriptor(
+    name="BatchPredictRequest",
+    full_name="google.cloud.automl.v1beta1.BatchPredictRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.BatchPredictRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.automl.v1beta1.BatchPredictRequest.input_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.automl.v1beta1.BatchPredictRequest.output_config",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.cloud.automl.v1beta1.BatchPredictRequest.params",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_BATCHPREDICTREQUEST_PARAMSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=892,
+    serialized_end=1206,
+)
+
+
+_BATCHPREDICTRESULT_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.automl.v1beta1.BatchPredictResult.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.BatchPredictResult.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.BatchPredictResult.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=842,
+    serialized_end=889,
+)
+
+_BATCHPREDICTRESULT = _descriptor.Descriptor(
+    name="BatchPredictResult",
+    full_name="google.cloud.automl.v1beta1.BatchPredictResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.automl.v1beta1.BatchPredictResult.metadata",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_BATCHPREDICTRESULT_METADATAENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1209,
+    serialized_end=1359,
+)
+
+_PREDICTREQUEST_PARAMSENTRY.containing_type = _PREDICTREQUEST
+_PREDICTREQUEST.fields_by_name[
+    "payload"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2._EXAMPLEPAYLOAD
+)
+_PREDICTREQUEST.fields_by_name["params"].message_type = _PREDICTREQUEST_PARAMSENTRY
+_PREDICTRESPONSE_METADATAENTRY.containing_type = _PREDICTRESPONSE
+_PREDICTRESPONSE.fields_by_name[
+    "payload"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__payload__pb2._ANNOTATIONPAYLOAD
+)
+_PREDICTRESPONSE.fields_by_name[
+    "preprocessed_input"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2._EXAMPLEPAYLOAD
+)
+_PREDICTRESPONSE.fields_by_name[
+    "metadata"
+].message_type = _PREDICTRESPONSE_METADATAENTRY
+_BATCHPREDICTREQUEST_PARAMSENTRY.containing_type = _BATCHPREDICTREQUEST
+_BATCHPREDICTREQUEST.fields_by_name[
+    "input_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._BATCHPREDICTINPUTCONFIG
+)
+_BATCHPREDICTREQUEST.fields_by_name[
+    "output_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._BATCHPREDICTOUTPUTCONFIG
+)
+_BATCHPREDICTREQUEST.fields_by_name[
+    "params"
+].message_type = _BATCHPREDICTREQUEST_PARAMSENTRY
+_BATCHPREDICTRESULT_METADATAENTRY.containing_type = _BATCHPREDICTRESULT
+_BATCHPREDICTRESULT.fields_by_name[
+    "metadata"
+].message_type = _BATCHPREDICTRESULT_METADATAENTRY
+DESCRIPTOR.message_types_by_name["PredictRequest"] = _PREDICTREQUEST
+DESCRIPTOR.message_types_by_name["PredictResponse"] = _PREDICTRESPONSE
+DESCRIPTOR.message_types_by_name["BatchPredictRequest"] = _BATCHPREDICTREQUEST
+DESCRIPTOR.message_types_by_name["BatchPredictResult"] = _BATCHPREDICTRESULT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+PredictRequest = _reflection.GeneratedProtocolMessageType(
+    "PredictRequest",
+    (_message.Message,),
+    dict(
+        ParamsEntry=_reflection.GeneratedProtocolMessageType(
+            "ParamsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PREDICTREQUEST_PARAMSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.PredictRequest.ParamsEntry)
+            ),
+        ),
+        DESCRIPTOR=_PREDICTREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2",
+        __doc__="""Request message for
+  [PredictionService.Predict][google.cloud.automl.v1beta1.PredictionService.Predict].
+  
+  
+  Attributes:
+      name:
+          Name of the model requested to serve the prediction.
+      payload:
+          Required. Payload to perform a prediction on. The payload must
+          match the problem type that the model was trained to solve.
+      params:
+          Additional domain-specific parameters, any string must be up
+          to 25000 characters long.  -  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 returned in the response.
+          Default is 100, the requested value may be limited by server.
+          -  For Tables: ``feature_importance`` - (boolean) Whether  [fe
+          ature\_importance][[google.cloud.automl.v1beta1.TablesModelCol
+          umnInfo.feature\_importance] should be populated in the
+          returned  [TablesAnnotation(-s)][[google.cloud.automl.v1beta1.
+          TablesAnnotation]. The default is false.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.PredictRequest)
+    ),
+)
+_sym_db.RegisterMessage(PredictRequest)
+_sym_db.RegisterMessage(PredictRequest.ParamsEntry)
+
+PredictResponse = _reflection.GeneratedProtocolMessageType(
+    "PredictResponse",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PREDICTRESPONSE_METADATAENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.PredictResponse.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_PREDICTRESPONSE,
+        __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2",
+        __doc__="""Response message for
+  [PredictionService.Predict][google.cloud.automl.v1beta1.PredictionService.Predict].
+  
+  
+  Attributes:
+      payload:
+          Prediction result. Translation and Text Sentiment will return
+          precisely one payload.
+      preprocessed_input:
+          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].
+      metadata:
+          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 Text Sentiment:
+          ``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 will be    also positive (though the least).
+          The sentiment\_score shouldn't be    confused with "score" or
+          "magnitude" from the previous Natural    Language Sentiment
+          Analysis API.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.PredictResponse)
+    ),
+)
+_sym_db.RegisterMessage(PredictResponse)
+_sym_db.RegisterMessage(PredictResponse.MetadataEntry)
+
+BatchPredictRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchPredictRequest",
+    (_message.Message,),
+    dict(
+        ParamsEntry=_reflection.GeneratedProtocolMessageType(
+            "ParamsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BATCHPREDICTREQUEST_PARAMSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictRequest.ParamsEntry)
+            ),
+        ),
+        DESCRIPTOR=_BATCHPREDICTREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2",
+        __doc__="""Request message for
+  [PredictionService.BatchPredict][google.cloud.automl.v1beta1.PredictionService.BatchPredict].
+  
+  
+  Attributes:
+      name:
+          Name of the model requested to serve the batch prediction.
+      input_config:
+          Required. The input configuration for batch prediction.
+      output_config:
+          Required. The Configuration specifying where output
+          predictions should be written.
+      params:
+          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.
+          ``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. 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. The default is
+          "false".    ``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. 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. 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. ``max_bounding_box_count`` - (int64)
+          No more than    this number of bounding boxes will be returned
+          per frame. Default is    100, the requested value may be
+          limited by server.    ``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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchPredictRequest)
+_sym_db.RegisterMessage(BatchPredictRequest.ParamsEntry)
+
+BatchPredictResult = _reflection.GeneratedProtocolMessageType(
+    "BatchPredictResult",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BATCHPREDICTRESULT_METADATAENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictResult.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_BATCHPREDICTRESULT,
+        __module__="google.cloud.automl_v1beta1.proto.prediction_service_pb2",
+        __doc__="""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].
+  
+  
+  Attributes:
+      metadata:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.BatchPredictResult)
+    ),
+)
+_sym_db.RegisterMessage(BatchPredictResult)
+_sym_db.RegisterMessage(BatchPredictResult.MetadataEntry)
+
+
+DESCRIPTOR._options = None
+_PREDICTREQUEST_PARAMSENTRY._options = None
+_PREDICTRESPONSE_METADATAENTRY._options = None
+_BATCHPREDICTREQUEST_PARAMSENTRY._options = None
+_BATCHPREDICTRESULT_METADATAENTRY._options = None
+
+_PREDICTIONSERVICE = _descriptor.ServiceDescriptor(
+    name="PredictionService",
+    full_name="google.cloud.automl.v1beta1.PredictionService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\025automl.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=1362,
+    serialized_end=1798,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="Predict",
+            full_name="google.cloud.automl.v1beta1.PredictionService.Predict",
+            index=0,
+            containing_service=None,
+            input_type=_PREDICTREQUEST,
+            output_type=_PREDICTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002<"7/v1beta1/{name=projects/*/locations/*/models/*}:predict:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchPredict",
+            full_name="google.cloud.automl.v1beta1.PredictionService.BatchPredict",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHPREDICTREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002A"</v1beta1/{name=projects/*/locations/*/models/*}:batchPredict:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PREDICTIONSERVICE)
+
+DESCRIPTOR.services_by_name["PredictionService"] = _PREDICTIONSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2_grpc.py
new file mode 100644
index 000000000000..8049017e1bcb
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/prediction_service_pb2_grpc.py
@@ -0,0 +1,106 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.automl_v1beta1.proto import (
+    prediction_service_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class PredictionServiceStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.Predict = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.PredictionService/Predict",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2.PredictRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2.PredictResponse.FromString,
+        )
+        self.BatchPredict = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.PredictionService/BatchPredict",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2.BatchPredictRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class PredictionServiceServicer(object):
+    """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.
+  """
+
+    def Predict(self, request, context):
+        """Perform an online prediction. The prediction result will be directly
+    returned in the response.
+    Available for following ML problems, and their expected request payloads:
+    * Image Classification - Image in .JPEG, .GIF or .PNG format, image_bytes
+    up to 30MB.
+    * Image Object Detection - Image in .JPEG, .GIF or .PNG format, image_bytes
+    up to 30MB.
+    * Text Classification - TextSnippet, content up to 60,000 characters,
+    UTF-8 encoded.
+    * Text Extraction - TextSnippet, content up to 30,000 characters,
+    UTF-8 NFC encoded.
+    * Translation - TextSnippet, content up to 25,000 characters, UTF-8
+    encoded.
+    * Tables - Row, with column values matching the columns of the model,
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchPredict(self, request, context):
+        """Perform a batch prediction. Unlike the online
+    [Predict][google.cloud.automl.v1beta1.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.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
+    * Tables
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_PredictionServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "Predict": grpc.unary_unary_rpc_method_handler(
+            servicer.Predict,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2.PredictRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2.PredictResponse.SerializeToString,
+        ),
+        "BatchPredict": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchPredict,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_prediction__service__pb2.BatchPredictRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.automl.v1beta1.PredictionService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/automl/google/cloud/automl_v1beta1/proto/ranges.proto b/automl/google/cloud/automl_v1beta1/proto/ranges.proto
new file mode 100644
index 000000000000..6a1d66fa0eb5
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/ranges.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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "RangesProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// A range between two double numbers.
+message DoubleRange {
+  // Start of the range, inclusive.
+  double start = 1;
+
+  // End of the range, exclusive.
+  double end = 2;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/ranges_pb2.py b/automl/google/cloud/automl_v1beta1/proto/ranges_pb2.py
new file mode 100644
index 000000000000..6f2121baf69e
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/ranges_pb2.py
@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/ranges.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/ranges.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\013RangesProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/automl_v1beta1/proto/ranges.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto")\n\x0b\x44oubleRange\x12\r\n\x05start\x18\x01 \x01(\x01\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x01\x42\xb2\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x0bRangesProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_DOUBLERANGE = _descriptor.Descriptor(
+    name="DoubleRange",
+    full_name="google.cloud.automl.v1beta1.DoubleRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start",
+            full_name="google.cloud.automl.v1beta1.DoubleRange.start",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end",
+            full_name="google.cloud.automl.v1beta1.DoubleRange.end",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=109,
+    serialized_end=150,
+)
+
+DESCRIPTOR.message_types_by_name["DoubleRange"] = _DOUBLERANGE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DoubleRange = _reflection.GeneratedProtocolMessageType(
+    "DoubleRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOUBLERANGE,
+        __module__="google.cloud.automl_v1beta1.proto.ranges_pb2",
+        __doc__="""A range between two double numbers.
+  
+  
+  Attributes:
+      start:
+          Start of the range, inclusive.
+      end:
+          End of the range, exclusive.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DoubleRange)
+    ),
+)
+_sym_db.RegisterMessage(DoubleRange)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/ranges_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/ranges_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/ranges_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/regression.proto b/automl/google/cloud/automl_v1beta1/proto/regression.proto
new file mode 100644
index 000000000000..d2b96af13ace
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/regression.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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_outer_classname = "RegressionProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// Metrics for regression problems.
+message RegressionEvaluationMetrics {
+  // Output only. Root Mean Squared Error (RMSE).
+  float root_mean_squared_error = 1;
+
+  // Output only. Mean Absolute Error (MAE).
+  float mean_absolute_error = 2;
+
+  // Output only. Mean absolute percentage error. Only set if all ground truth
+  // values are are positive.
+  float mean_absolute_percentage_error = 3;
+
+  // Output only. R squared.
+  float r_squared = 4;
+
+  // Output only. Root mean squared log error.
+  float root_mean_squared_log_error = 5;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/regression_pb2.py b/automl/google/cloud/automl_v1beta1/proto/regression_pb2.py
new file mode 100644
index 000000000000..1e17b745999d
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/regression_pb2.py
@@ -0,0 +1,179 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/regression.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/regression.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\017RegressionProtoZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/automl_v1beta1/proto/regression.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"\xbb\x01\n\x1bRegressionEvaluationMetrics\x12\x1f\n\x17root_mean_squared_error\x18\x01 \x01(\x02\x12\x1b\n\x13mean_absolute_error\x18\x02 \x01(\x02\x12&\n\x1emean_absolute_percentage_error\x18\x03 \x01(\x02\x12\x11\n\tr_squared\x18\x04 \x01(\x02\x12#\n\x1broot_mean_squared_log_error\x18\x05 \x01(\x02\x42\xb4\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x0fRegressionProtoZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_REGRESSIONEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="RegressionEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.RegressionEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="root_mean_squared_error",
+            full_name="google.cloud.automl.v1beta1.RegressionEvaluationMetrics.root_mean_squared_error",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_absolute_error",
+            full_name="google.cloud.automl.v1beta1.RegressionEvaluationMetrics.mean_absolute_error",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_absolute_percentage_error",
+            full_name="google.cloud.automl.v1beta1.RegressionEvaluationMetrics.mean_absolute_percentage_error",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="r_squared",
+            full_name="google.cloud.automl.v1beta1.RegressionEvaluationMetrics.r_squared",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="root_mean_squared_log_error",
+            full_name="google.cloud.automl.v1beta1.RegressionEvaluationMetrics.root_mean_squared_log_error",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=114,
+    serialized_end=301,
+)
+
+DESCRIPTOR.message_types_by_name[
+    "RegressionEvaluationMetrics"
+] = _REGRESSIONEVALUATIONMETRICS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+RegressionEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "RegressionEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REGRESSIONEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.regression_pb2",
+        __doc__="""Metrics for regression problems.
+  
+  
+  Attributes:
+      root_mean_squared_error:
+          Output only. Root Mean Squared Error (RMSE).
+      mean_absolute_error:
+          Output only. Mean Absolute Error (MAE).
+      mean_absolute_percentage_error:
+          Output only. Mean absolute percentage error. Only set if all
+          ground truth values are are positive.
+      r_squared:
+          Output only. R squared.
+      root_mean_squared_log_error:
+          Output only. Root mean squared log error.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.RegressionEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(RegressionEvaluationMetrics)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/regression_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/regression_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/regression_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/service.proto b/automl/google/cloud/automl_v1beta1/proto/service.proto
new file mode 100644
index 000000000000..660d42b528bc
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/service.proto
@@ -0,0 +1,630 @@
+// 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.automl.v1beta1;
+
+import "google/api/annotations.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";
+import "google/cloud/automl/v1beta1/dataset.proto";
+import "google/cloud/automl/v1beta1/image.proto";
+import "google/cloud/automl/v1beta1/io.proto";
+import "google/cloud/automl/v1beta1/model.proto";
+import "google/cloud/automl/v1beta1/model_evaluation.proto";
+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;
+option java_outer_classname = "AutoMlProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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 (Dataset) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/datasets"
+      body: "dataset"
+    };
+  }
+
+  // Gets a dataset.
+  rpc GetDataset(GetDatasetRequest) returns (Dataset) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/datasets/*}"
+    };
+  }
+
+  // Lists datasets in a project.
+  rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/datasets"
+    };
+  }
+
+  // Updates a dataset.
+  rpc UpdateDataset(UpdateDatasetRequest) returns (Dataset) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{dataset.name=projects/*/locations/*/datasets/*}"
+      body: "dataset"
+    };
+  }
+
+  // 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: "/v1beta1/{name=projects/*/locations/*/datasets/*}"
+    };
+  }
+
+  // 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.v1beta1.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: "/v1beta1/{name=projects/*/locations/*/datasets/*}:importData"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1beta1/{name=projects/*/locations/*/datasets/*}:exportData"
+      body: "*"
+    };
+  }
+
+  // Gets an annotation spec.
+  rpc GetAnnotationSpec(GetAnnotationSpecRequest) returns (AnnotationSpec) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/datasets/*/annotationSpecs/*}"
+    };
+  }
+
+  // Gets a table spec.
+  rpc GetTableSpec(GetTableSpecRequest) returns (TableSpec) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*}"
+    };
+  }
+
+  // Lists table specs in a dataset.
+  rpc ListTableSpecs(ListTableSpecsRequest) returns (ListTableSpecsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/datasets/*}/tableSpecs"
+    };
+  }
+
+  // Updates a table spec.
+  rpc UpdateTableSpec(UpdateTableSpecRequest) returns (TableSpec) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{table_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*}"
+      body: "table_spec"
+    };
+  }
+
+  // Gets a column spec.
+  rpc GetColumnSpec(GetColumnSpecRequest) returns (ColumnSpec) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}"
+    };
+  }
+
+  // Lists column specs in a table spec.
+  rpc ListColumnSpecs(ListColumnSpecsRequest) returns (ListColumnSpecsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/datasets/*/tableSpecs/*}/columnSpecs"
+    };
+  }
+
+  // Updates a column spec.
+  rpc UpdateColumnSpec(UpdateColumnSpecRequest) returns (ColumnSpec) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{column_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}"
+      body: "column_spec"
+    };
+  }
+
+  // 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: "/v1beta1/{parent=projects/*/locations/*}/models"
+      body: "model"
+    };
+  }
+
+  // Gets a model.
+  rpc GetModel(GetModelRequest) returns (Model) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/models/*}"
+    };
+  }
+
+  // Lists models.
+  rpc ListModels(ListModelsRequest) returns (ListModelsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/models"
+    };
+  }
+
+  // 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: "/v1beta1/{name=projects/*/locations/*/models/*}"
+    };
+  }
+
+  // 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.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.
+  //
+  // 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: "/v1beta1/{name=projects/*/locations/*/models/*}:deploy"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1beta1/{name=projects/*/locations/*/models/*}:undeploy"
+      body: "*"
+    };
+  }
+
+  // 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.v1beta1.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: "/v1beta1/{name=projects/*/locations/*/models/*}:export"
+      body: "*"
+    };
+  }
+
+  // Exports examples on which the model was evaluated (i.e. which were in the
+  // TEST set of the dataset the model was created from), together with their
+  // ground truth annotations and the annotations created (predicted) by the
+  // model.
+  // The examples, ground truth and predictions are exported in the state
+  // they were at the moment the model was evaluated.
+  //
+  // This export is available only for 30 days since the model evaluation is
+  // created.
+  //
+  // Currently only available for Tables.
+  //
+  // Returns an empty response in the
+  // [response][google.longrunning.Operation.response] field when it completes.
+  rpc ExportEvaluatedExamples(ExportEvaluatedExamplesRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/models/*}:exportEvaluatedExamples"
+      body: "*"
+    };
+  }
+
+  // Gets a model evaluation.
+  rpc GetModelEvaluation(GetModelEvaluationRequest) returns (ModelEvaluation) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/models/*/modelEvaluations/*}"
+    };
+  }
+
+  // Lists model evaluations.
+  rpc ListModelEvaluations(ListModelEvaluationsRequest) returns (ListModelEvaluationsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/models/*}/modelEvaluations"
+    };
+  }
+}
+
+// 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;
+}
+
+// Request message for [AutoMl.GetDataset][google.cloud.automl.v1beta1.AutoMl.GetDataset].
+message GetDatasetRequest {
+  // The resource name of the dataset to retrieve.
+  string name = 1;
+}
+
+// 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;
+
+  // 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.v1beta1.ListDatasetsResponse.next_page_token] of the previous
+  // [AutoMl.ListDatasets][google.cloud.automl.v1beta1.AutoMl.ListDatasets] call.
+  string page_token = 6;
+}
+
+// Response message for [AutoMl.ListDatasets][google.cloud.automl.v1beta1.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.v1beta1.ListDatasetsRequest.page_token] to obtain that page.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // 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;
+}
+
+// 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;
+
+  // Required. The desired input location and its domain specific semantics,
+  // if any.
+  InputConfig input_config = 3;
+}
+
+// Request message for [AutoMl.ExportData][google.cloud.automl.v1beta1.AutoMl.ExportData].
+message ExportDataRequest {
+  // Required. The resource name of the dataset.
+  string name = 1;
+
+  // Required. The desired output location.
+  OutputConfig output_config = 3;
+}
+
+// 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;
+}
+
+// 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;
+
+  // Mask specifying which fields to read.
+  google.protobuf.FieldMask field_mask = 2;
+}
+
+// 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;
+
+  // Mask specifying which fields to read.
+  google.protobuf.FieldMask field_mask = 2;
+
+  // Filter expression, see go/filtering.
+  string filter = 3;
+
+  // Requested page size. The server can return fewer results than requested.
+  // If unspecified, the server will pick a default size.
+  int32 page_size = 4;
+
+  // A token identifying a page of results for the server to return.
+  // Typically obtained from the
+  // [ListTableSpecsResponse.next_page_token][google.cloud.automl.v1beta1.ListTableSpecsResponse.next_page_token] field of the previous
+  // [AutoMl.ListTableSpecs][google.cloud.automl.v1beta1.AutoMl.ListTableSpecs] call.
+  string page_token = 6;
+}
+
+// Response message for [AutoMl.ListTableSpecs][google.cloud.automl.v1beta1.AutoMl.ListTableSpecs].
+message ListTableSpecsResponse {
+  // The table specs read.
+  repeated TableSpec table_specs = 1;
+
+  // A token to retrieve next page of results.
+  // Pass to [ListTableSpecsRequest.page_token][google.cloud.automl.v1beta1.ListTableSpecsRequest.page_token] to obtain that page.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // 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;
+
+  // Mask specifying which fields to read.
+  google.protobuf.FieldMask field_mask = 2;
+}
+
+// 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;
+
+  // Mask specifying which fields to read.
+  google.protobuf.FieldMask field_mask = 2;
+
+  // Filter expression, see go/filtering.
+  string filter = 3;
+
+  // Requested page size. The server can return fewer results than requested.
+  // If unspecified, the server will pick a default size.
+  int32 page_size = 4;
+
+  // A token identifying a page of results for the server to return.
+  // Typically obtained from the
+  // [ListColumnSpecsResponse.next_page_token][google.cloud.automl.v1beta1.ListColumnSpecsResponse.next_page_token] field of the previous
+  // [AutoMl.ListColumnSpecs][google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs] call.
+  string page_token = 6;
+}
+
+// Response message for [AutoMl.ListColumnSpecs][google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs].
+message ListColumnSpecsResponse {
+  // The column specs read.
+  repeated ColumnSpec column_specs = 1;
+
+  // A token to retrieve next page of results.
+  // Pass to [ListColumnSpecsRequest.page_token][google.cloud.automl.v1beta1.ListColumnSpecsRequest.page_token] to obtain that page.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // 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;
+}
+
+// Request message for [AutoMl.GetModel][google.cloud.automl.v1beta1.AutoMl.GetModel].
+message GetModelRequest {
+  // Resource name of the model.
+  string name = 1;
+}
+
+// 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;
+
+  // 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.v1beta1.ListModelsResponse.next_page_token] of the previous
+  // [AutoMl.ListModels][google.cloud.automl.v1beta1.AutoMl.ListModels] call.
+  string page_token = 6;
+}
+
+// Response message for [AutoMl.ListModels][google.cloud.automl.v1beta1.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.v1beta1.ListModelsRequest.page_token] to obtain that page.
+  string next_page_token = 2;
+}
+
+// Request message for [AutoMl.DeleteModel][google.cloud.automl.v1beta1.AutoMl.DeleteModel].
+message DeleteModelRequest {
+  // Resource name of the model being deleted.
+  string name = 1;
+}
+
+// Request message for [AutoMl.DeployModel][google.cloud.automl.v1beta1.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;
+  }
+
+  // Resource name of the model to deploy.
+  string name = 1;
+}
+
+// Request message for [AutoMl.UndeployModel][google.cloud.automl.v1beta1.AutoMl.UndeployModel].
+message UndeployModelRequest {
+  // Resource name of the model to undeploy.
+  string name = 1;
+}
+
+// Request message for [AutoMl.ExportModel][google.cloud.automl.v1beta1.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;
+
+  // Required. The desired output location and configuration.
+  ModelExportOutputConfig output_config = 3;
+}
+
+// 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;
+
+  // Required. The desired output location and configuration.
+  ExportEvaluatedExamplesOutputConfig output_config = 3;
+}
+
+// Request message for [AutoMl.GetModelEvaluation][google.cloud.automl.v1beta1.AutoMl.GetModelEvaluation].
+message GetModelEvaluationRequest {
+  // Resource name for the model evaluation.
+  string name = 1;
+}
+
+// Request message for [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations].
+message ListModelEvaluationsRequest {
+  // 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;
+
+  // 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;
+
+  // 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.v1beta1.ListModelEvaluationsResponse.next_page_token] of the previous
+  // [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations] call.
+  string page_token = 6;
+}
+
+// Response message for [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.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.v1beta1.ListModelEvaluationsRequest.page_token] field of a new
+  // [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations] request to obtain that page.
+  string next_page_token = 2;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/service_pb2.py b/automl/google/cloud/automl_v1beta1/proto/service_pb2.py
new file mode 100644
index 000000000000..5533916b97b8
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/service_pb2.py
@@ -0,0 +1,2942 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.automl_v1beta1.proto import (
+    annotation_payload_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__payload__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    annotation_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    column_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    image_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    io_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    model_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    model_evaluation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    operations_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_operations__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    table_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/service.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\013AutoMlProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/automl_v1beta1/proto/service.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a:google/cloud/automl_v1beta1/proto/annotation_payload.proto\x1a\x37google/cloud/automl_v1beta1/proto/annotation_spec.proto\x1a\x33google/cloud/automl_v1beta1/proto/column_spec.proto\x1a/google/cloud/automl_v1beta1/proto/dataset.proto\x1a-google/cloud/automl_v1beta1/proto/image.proto\x1a*google/cloud/automl_v1beta1/proto/io.proto\x1a-google/cloud/automl_v1beta1/proto/model.proto\x1a\x38google/cloud/automl_v1beta1/proto/model_evaluation.proto\x1a\x32google/cloud/automl_v1beta1/proto/operations.proto\x1a\x32google/cloud/automl_v1beta1/proto/table_spec.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/api/client.proto"]\n\x14\x43reateDatasetRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x35\n\x07\x64\x61taset\x18\x02 \x01(\x0b\x32$.google.cloud.automl.v1beta1.Dataset"!\n\x11GetDatasetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x13ListDatasetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"g\n\x14ListDatasetsResponse\x12\x36\n\x08\x64\x61tasets\x18\x01 \x03(\x0b\x32$.google.cloud.automl.v1beta1.Dataset\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"~\n\x14UpdateDatasetRequest\x12\x35\n\x07\x64\x61taset\x18\x01 \x01(\x0b\x32$.google.cloud.automl.v1beta1.Dataset\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteDatasetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"a\n\x11ImportDataRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12>\n\x0cinput_config\x18\x03 \x01(\x0b\x32(.google.cloud.automl.v1beta1.InputConfig"c\n\x11\x45xportDataRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12@\n\routput_config\x18\x03 \x01(\x0b\x32).google.cloud.automl.v1beta1.OutputConfig"(\n\x18GetAnnotationSpecRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"S\n\x13GetTableSpecRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x8e\x01\n\x15ListTableSpecsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"n\n\x16ListTableSpecsResponse\x12;\n\x0btable_specs\x18\x01 \x03(\x0b\x32&.google.cloud.automl.v1beta1.TableSpec\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x85\x01\n\x16UpdateTableSpecRequest\x12:\n\ntable_spec\x18\x01 \x01(\x0b\x32&.google.cloud.automl.v1beta1.TableSpec\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"T\n\x14GetColumnSpecRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x8f\x01\n\x16ListColumnSpecsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"q\n\x17ListColumnSpecsResponse\x12=\n\x0c\x63olumn_specs\x18\x01 \x03(\x0b\x32\'.google.cloud.automl.v1beta1.ColumnSpec\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x88\x01\n\x17UpdateColumnSpecRequest\x12<\n\x0b\x63olumn_spec\x18\x01 \x01(\x0b\x32\'.google.cloud.automl.v1beta1.ColumnSpec\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"W\n\x12\x43reateModelRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x31\n\x05model\x18\x04 \x01(\x0b\x32".google.cloud.automl.v1beta1.Model"\x1f\n\x0fGetModelRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"Z\n\x11ListModelsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"`\n\x12ListModelsResponse\x12\x31\n\x05model\x18\x01 \x03(\x0b\x32".google.cloud.automl.v1beta1.Model\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t""\n\x12\x44\x65leteModelRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xc6\x01\n\x12\x44\x65ployModelRequest\x12\x84\x01\n0image_object_detection_model_deployment_metadata\x18\x02 \x01(\x0b\x32H.google.cloud.automl.v1beta1.ImageObjectDetectionModelDeploymentMetadataH\x00\x12\x0c\n\x04name\x18\x01 \x01(\tB\x1b\n\x19model_deployment_metadata"$\n\x14UndeployModelRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"o\n\x12\x45xportModelRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12K\n\routput_config\x18\x03 \x01(\x0b\x32\x34.google.cloud.automl.v1beta1.ModelExportOutputConfig"\x87\x01\n\x1e\x45xportEvaluatedExamplesRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12W\n\routput_config\x18\x03 \x01(\x0b\x32@.google.cloud.automl.v1beta1.ExportEvaluatedExamplesOutputConfig")\n\x19GetModelEvaluationRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"d\n\x1bListModelEvaluationsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"\x7f\n\x1cListModelEvaluationsResponse\x12\x46\n\x10model_evaluation\x18\x01 \x03(\x0b\x32,.google.cloud.automl.v1beta1.ModelEvaluation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xd9"\n\x06\x41utoMl\x12\xac\x01\n\rCreateDataset\x12\x31.google.cloud.automl.v1beta1.CreateDatasetRequest\x1a$.google.cloud.automl.v1beta1.Dataset"B\x82\xd3\xe4\x93\x02<"1/v1beta1/{parent=projects/*/locations/*}/datasets:\x07\x64\x61taset\x12\x9d\x01\n\nGetDataset\x12..google.cloud.automl.v1beta1.GetDatasetRequest\x1a$.google.cloud.automl.v1beta1.Dataset"9\x82\xd3\xe4\x93\x02\x33\x12\x31/v1beta1/{name=projects/*/locations/*/datasets/*}\x12\xae\x01\n\x0cListDatasets\x12\x30.google.cloud.automl.v1beta1.ListDatasetsRequest\x1a\x31.google.cloud.automl.v1beta1.ListDatasetsResponse"9\x82\xd3\xe4\x93\x02\x33\x12\x31/v1beta1/{parent=projects/*/locations/*}/datasets\x12\xb4\x01\n\rUpdateDataset\x12\x31.google.cloud.automl.v1beta1.UpdateDatasetRequest\x1a$.google.cloud.automl.v1beta1.Dataset"J\x82\xd3\xe4\x93\x02\x44\x32\x39/v1beta1/{dataset.name=projects/*/locations/*/datasets/*}:\x07\x64\x61taset\x12\x9c\x01\n\rDeleteDataset\x12\x31.google.cloud.automl.v1beta1.DeleteDatasetRequest\x1a\x1d.google.longrunning.Operation"9\x82\xd3\xe4\x93\x02\x33*1/v1beta1/{name=projects/*/locations/*/datasets/*}\x12\xa4\x01\n\nImportData\x12..google.cloud.automl.v1beta1.ImportDataRequest\x1a\x1d.google.longrunning.Operation"G\x82\xd3\xe4\x93\x02\x41"</v1beta1/{name=projects/*/locations/*/datasets/*}:importData:\x01*\x12\xa4\x01\n\nExportData\x12..google.cloud.automl.v1beta1.ExportDataRequest\x1a\x1d.google.longrunning.Operation"G\x82\xd3\xe4\x93\x02\x41"</v1beta1/{name=projects/*/locations/*/datasets/*}:exportData:\x01*\x12\xc4\x01\n\x11GetAnnotationSpec\x12\x35.google.cloud.automl.v1beta1.GetAnnotationSpecRequest\x1a+.google.cloud.automl.v1beta1.AnnotationSpec"K\x82\xd3\xe4\x93\x02\x45\x12\x43/v1beta1/{name=projects/*/locations/*/datasets/*/annotationSpecs/*}\x12\xb0\x01\n\x0cGetTableSpec\x12\x30.google.cloud.automl.v1beta1.GetTableSpecRequest\x1a&.google.cloud.automl.v1beta1.TableSpec"F\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*}\x12\xc1\x01\n\x0eListTableSpecs\x12\x32.google.cloud.automl.v1beta1.ListTableSpecsRequest\x1a\x33.google.cloud.automl.v1beta1.ListTableSpecsResponse"F\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{parent=projects/*/locations/*/datasets/*}/tableSpecs\x12\xcd\x01\n\x0fUpdateTableSpec\x12\x33.google.cloud.automl.v1beta1.UpdateTableSpecRequest\x1a&.google.cloud.automl.v1beta1.TableSpec"]\x82\xd3\xe4\x93\x02W2I/v1beta1/{table_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*}:\ntable_spec\x12\xc1\x01\n\rGetColumnSpec\x12\x31.google.cloud.automl.v1beta1.GetColumnSpecRequest\x1a\'.google.cloud.automl.v1beta1.ColumnSpec"T\x82\xd3\xe4\x93\x02N\x12L/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}\x12\xd2\x01\n\x0fListColumnSpecs\x12\x33.google.cloud.automl.v1beta1.ListColumnSpecsRequest\x1a\x34.google.cloud.automl.v1beta1.ListColumnSpecsResponse"T\x82\xd3\xe4\x93\x02N\x12L/v1beta1/{parent=projects/*/locations/*/datasets/*/tableSpecs/*}/columnSpecs\x12\xe0\x01\n\x10UpdateColumnSpec\x12\x34.google.cloud.automl.v1beta1.UpdateColumnSpecRequest\x1a\'.google.cloud.automl.v1beta1.ColumnSpec"m\x82\xd3\xe4\x93\x02g2X/v1beta1/{column_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}:\x0b\x63olumn_spec\x12\x9d\x01\n\x0b\x43reateModel\x12/.google.cloud.automl.v1beta1.CreateModelRequest\x1a\x1d.google.longrunning.Operation">\x82\xd3\xe4\x93\x02\x38"//v1beta1/{parent=projects/*/locations/*}/models:\x05model\x12\x95\x01\n\x08GetModel\x12,.google.cloud.automl.v1beta1.GetModelRequest\x1a".google.cloud.automl.v1beta1.Model"7\x82\xd3\xe4\x93\x02\x31\x12//v1beta1/{name=projects/*/locations/*/models/*}\x12\xa6\x01\n\nListModels\x12..google.cloud.automl.v1beta1.ListModelsRequest\x1a/.google.cloud.automl.v1beta1.ListModelsResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v1beta1/{parent=projects/*/locations/*}/models\x12\x96\x01\n\x0b\x44\x65leteModel\x12/.google.cloud.automl.v1beta1.DeleteModelRequest\x1a\x1d.google.longrunning.Operation"7\x82\xd3\xe4\x93\x02\x31*//v1beta1/{name=projects/*/locations/*/models/*}\x12\xa0\x01\n\x0b\x44\x65ployModel\x12/.google.cloud.automl.v1beta1.DeployModelRequest\x1a\x1d.google.longrunning.Operation"A\x82\xd3\xe4\x93\x02;"6/v1beta1/{name=projects/*/locations/*/models/*}:deploy:\x01*\x12\xa6\x01\n\rUndeployModel\x12\x31.google.cloud.automl.v1beta1.UndeployModelRequest\x1a\x1d.google.longrunning.Operation"C\x82\xd3\xe4\x93\x02="8/v1beta1/{name=projects/*/locations/*/models/*}:undeploy:\x01*\x12\xa0\x01\n\x0b\x45xportModel\x12/.google.cloud.automl.v1beta1.ExportModelRequest\x1a\x1d.google.longrunning.Operation"A\x82\xd3\xe4\x93\x02;"6/v1beta1/{name=projects/*/locations/*/models/*}:export:\x01*\x12\xc9\x01\n\x17\x45xportEvaluatedExamples\x12;.google.cloud.automl.v1beta1.ExportEvaluatedExamplesRequest\x1a\x1d.google.longrunning.Operation"R\x82\xd3\xe4\x93\x02L"G/v1beta1/{name=projects/*/locations/*/models/*}:exportEvaluatedExamples:\x01*\x12\xc6\x01\n\x12GetModelEvaluation\x12\x36.google.cloud.automl.v1beta1.GetModelEvaluationRequest\x1a,.google.cloud.automl.v1beta1.ModelEvaluation"J\x82\xd3\xe4\x93\x02\x44\x12\x42/v1beta1/{name=projects/*/locations/*/models/*/modelEvaluations/*}\x12\xd7\x01\n\x14ListModelEvaluations\x12\x38.google.cloud.automl.v1beta1.ListModelEvaluationsRequest\x1a\x39.google.cloud.automl.v1beta1.ListModelEvaluationsResponse"J\x82\xd3\xe4\x93\x02\x44\x12\x42/v1beta1/{parent=projects/*/locations/*/models/*}/modelEvaluations\x1aI\xca\x41\x15\x61utoml.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xb2\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x0b\x41utoMlProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__payload__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_operations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEDATASETREQUEST = _descriptor.Descriptor(
+    name="CreateDatasetRequest",
+    full_name="google.cloud.automl.v1beta1.CreateDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.CreateDatasetRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.automl.v1beta1.CreateDatasetRequest.dataset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=725,
+    serialized_end=818,
+)
+
+
+_GETDATASETREQUEST = _descriptor.Descriptor(
+    name="GetDatasetRequest",
+    full_name="google.cloud.automl.v1beta1.GetDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.GetDatasetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=820,
+    serialized_end=853,
+)
+
+
+_LISTDATASETSREQUEST = _descriptor.Descriptor(
+    name="ListDatasetsRequest",
+    full_name="google.cloud.automl.v1beta1.ListDatasetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.ListDatasetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.automl.v1beta1.ListDatasetsRequest.filter",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.automl.v1beta1.ListDatasetsRequest.page_size",
+            index=2,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.automl.v1beta1.ListDatasetsRequest.page_token",
+            index=3,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=855,
+    serialized_end=947,
+)
+
+
+_LISTDATASETSRESPONSE = _descriptor.Descriptor(
+    name="ListDatasetsResponse",
+    full_name="google.cloud.automl.v1beta1.ListDatasetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="datasets",
+            full_name="google.cloud.automl.v1beta1.ListDatasetsResponse.datasets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.automl.v1beta1.ListDatasetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=949,
+    serialized_end=1052,
+)
+
+
+_UPDATEDATASETREQUEST = _descriptor.Descriptor(
+    name="UpdateDatasetRequest",
+    full_name="google.cloud.automl.v1beta1.UpdateDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.automl.v1beta1.UpdateDatasetRequest.dataset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.automl.v1beta1.UpdateDatasetRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1054,
+    serialized_end=1180,
+)
+
+
+_DELETEDATASETREQUEST = _descriptor.Descriptor(
+    name="DeleteDatasetRequest",
+    full_name="google.cloud.automl.v1beta1.DeleteDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.DeleteDatasetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1182,
+    serialized_end=1218,
+)
+
+
+_IMPORTDATAREQUEST = _descriptor.Descriptor(
+    name="ImportDataRequest",
+    full_name="google.cloud.automl.v1beta1.ImportDataRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.ImportDataRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.automl.v1beta1.ImportDataRequest.input_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1220,
+    serialized_end=1317,
+)
+
+
+_EXPORTDATAREQUEST = _descriptor.Descriptor(
+    name="ExportDataRequest",
+    full_name="google.cloud.automl.v1beta1.ExportDataRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.ExportDataRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.automl.v1beta1.ExportDataRequest.output_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1319,
+    serialized_end=1418,
+)
+
+
+_GETANNOTATIONSPECREQUEST = _descriptor.Descriptor(
+    name="GetAnnotationSpecRequest",
+    full_name="google.cloud.automl.v1beta1.GetAnnotationSpecRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.GetAnnotationSpecRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1420,
+    serialized_end=1460,
+)
+
+
+_GETTABLESPECREQUEST = _descriptor.Descriptor(
+    name="GetTableSpecRequest",
+    full_name="google.cloud.automl.v1beta1.GetTableSpecRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.GetTableSpecRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.automl.v1beta1.GetTableSpecRequest.field_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1462,
+    serialized_end=1545,
+)
+
+
+_LISTTABLESPECSREQUEST = _descriptor.Descriptor(
+    name="ListTableSpecsRequest",
+    full_name="google.cloud.automl.v1beta1.ListTableSpecsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsRequest.field_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsRequest.filter",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsRequest.page_token",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1548,
+    serialized_end=1690,
+)
+
+
+_LISTTABLESPECSRESPONSE = _descriptor.Descriptor(
+    name="ListTableSpecsResponse",
+    full_name="google.cloud.automl.v1beta1.ListTableSpecsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_specs",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsResponse.table_specs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.automl.v1beta1.ListTableSpecsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1692,
+    serialized_end=1802,
+)
+
+
+_UPDATETABLESPECREQUEST = _descriptor.Descriptor(
+    name="UpdateTableSpecRequest",
+    full_name="google.cloud.automl.v1beta1.UpdateTableSpecRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_spec",
+            full_name="google.cloud.automl.v1beta1.UpdateTableSpecRequest.table_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.automl.v1beta1.UpdateTableSpecRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1805,
+    serialized_end=1938,
+)
+
+
+_GETCOLUMNSPECREQUEST = _descriptor.Descriptor(
+    name="GetColumnSpecRequest",
+    full_name="google.cloud.automl.v1beta1.GetColumnSpecRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.GetColumnSpecRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.automl.v1beta1.GetColumnSpecRequest.field_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1940,
+    serialized_end=2024,
+)
+
+
+_LISTCOLUMNSPECSREQUEST = _descriptor.Descriptor(
+    name="ListColumnSpecsRequest",
+    full_name="google.cloud.automl.v1beta1.ListColumnSpecsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsRequest.field_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsRequest.filter",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsRequest.page_token",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2027,
+    serialized_end=2170,
+)
+
+
+_LISTCOLUMNSPECSRESPONSE = _descriptor.Descriptor(
+    name="ListColumnSpecsResponse",
+    full_name="google.cloud.automl.v1beta1.ListColumnSpecsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="column_specs",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsResponse.column_specs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.automl.v1beta1.ListColumnSpecsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2172,
+    serialized_end=2285,
+)
+
+
+_UPDATECOLUMNSPECREQUEST = _descriptor.Descriptor(
+    name="UpdateColumnSpecRequest",
+    full_name="google.cloud.automl.v1beta1.UpdateColumnSpecRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="column_spec",
+            full_name="google.cloud.automl.v1beta1.UpdateColumnSpecRequest.column_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.automl.v1beta1.UpdateColumnSpecRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2288,
+    serialized_end=2424,
+)
+
+
+_CREATEMODELREQUEST = _descriptor.Descriptor(
+    name="CreateModelRequest",
+    full_name="google.cloud.automl.v1beta1.CreateModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.CreateModelRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.automl.v1beta1.CreateModelRequest.model",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2426,
+    serialized_end=2513,
+)
+
+
+_GETMODELREQUEST = _descriptor.Descriptor(
+    name="GetModelRequest",
+    full_name="google.cloud.automl.v1beta1.GetModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.GetModelRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2515,
+    serialized_end=2546,
+)
+
+
+_LISTMODELSREQUEST = _descriptor.Descriptor(
+    name="ListModelsRequest",
+    full_name="google.cloud.automl.v1beta1.ListModelsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.ListModelsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.automl.v1beta1.ListModelsRequest.filter",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.automl.v1beta1.ListModelsRequest.page_size",
+            index=2,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.automl.v1beta1.ListModelsRequest.page_token",
+            index=3,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2548,
+    serialized_end=2638,
+)
+
+
+_LISTMODELSRESPONSE = _descriptor.Descriptor(
+    name="ListModelsResponse",
+    full_name="google.cloud.automl.v1beta1.ListModelsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.automl.v1beta1.ListModelsResponse.model",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.automl.v1beta1.ListModelsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2640,
+    serialized_end=2736,
+)
+
+
+_DELETEMODELREQUEST = _descriptor.Descriptor(
+    name="DeleteModelRequest",
+    full_name="google.cloud.automl.v1beta1.DeleteModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.DeleteModelRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2738,
+    serialized_end=2772,
+)
+
+
+_DEPLOYMODELREQUEST = _descriptor.Descriptor(
+    name="DeployModelRequest",
+    full_name="google.cloud.automl.v1beta1.DeployModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_object_detection_model_deployment_metadata",
+            full_name="google.cloud.automl.v1beta1.DeployModelRequest.image_object_detection_model_deployment_metadata",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.DeployModelRequest.name",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="model_deployment_metadata",
+            full_name="google.cloud.automl.v1beta1.DeployModelRequest.model_deployment_metadata",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2775,
+    serialized_end=2973,
+)
+
+
+_UNDEPLOYMODELREQUEST = _descriptor.Descriptor(
+    name="UndeployModelRequest",
+    full_name="google.cloud.automl.v1beta1.UndeployModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.UndeployModelRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2975,
+    serialized_end=3011,
+)
+
+
+_EXPORTMODELREQUEST = _descriptor.Descriptor(
+    name="ExportModelRequest",
+    full_name="google.cloud.automl.v1beta1.ExportModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.ExportModelRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.automl.v1beta1.ExportModelRequest.output_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3013,
+    serialized_end=3124,
+)
+
+
+_EXPORTEVALUATEDEXAMPLESREQUEST = _descriptor.Descriptor(
+    name="ExportEvaluatedExamplesRequest",
+    full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.automl.v1beta1.ExportEvaluatedExamplesRequest.output_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3127,
+    serialized_end=3262,
+)
+
+
+_GETMODELEVALUATIONREQUEST = _descriptor.Descriptor(
+    name="GetModelEvaluationRequest",
+    full_name="google.cloud.automl.v1beta1.GetModelEvaluationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.GetModelEvaluationRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3264,
+    serialized_end=3305,
+)
+
+
+_LISTMODELEVALUATIONSREQUEST = _descriptor.Descriptor(
+    name="ListModelEvaluationsRequest",
+    full_name="google.cloud.automl.v1beta1.ListModelEvaluationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.automl.v1beta1.ListModelEvaluationsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.automl.v1beta1.ListModelEvaluationsRequest.filter",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.automl.v1beta1.ListModelEvaluationsRequest.page_size",
+            index=2,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.automl.v1beta1.ListModelEvaluationsRequest.page_token",
+            index=3,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3307,
+    serialized_end=3407,
+)
+
+
+_LISTMODELEVALUATIONSRESPONSE = _descriptor.Descriptor(
+    name="ListModelEvaluationsResponse",
+    full_name="google.cloud.automl.v1beta1.ListModelEvaluationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model_evaluation",
+            full_name="google.cloud.automl.v1beta1.ListModelEvaluationsResponse.model_evaluation",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.automl.v1beta1.ListModelEvaluationsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3409,
+    serialized_end=3536,
+)
+
+_CREATEDATASETREQUEST.fields_by_name[
+    "dataset"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2._DATASET
+)
+_LISTDATASETSRESPONSE.fields_by_name[
+    "datasets"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2._DATASET
+)
+_UPDATEDATASETREQUEST.fields_by_name[
+    "dataset"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2._DATASET
+)
+_UPDATEDATASETREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_IMPORTDATAREQUEST.fields_by_name[
+    "input_config"
+].message_type = google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._INPUTCONFIG
+_EXPORTDATAREQUEST.fields_by_name[
+    "output_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._OUTPUTCONFIG
+)
+_GETTABLESPECREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTABLESPECSREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTABLESPECSRESPONSE.fields_by_name[
+    "table_specs"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2._TABLESPEC
+)
+_UPDATETABLESPECREQUEST.fields_by_name[
+    "table_spec"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2._TABLESPEC
+)
+_UPDATETABLESPECREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_GETCOLUMNSPECREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTCOLUMNSPECSREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTCOLUMNSPECSRESPONSE.fields_by_name[
+    "column_specs"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2._COLUMNSPEC
+)
+_UPDATECOLUMNSPECREQUEST.fields_by_name[
+    "column_spec"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2._COLUMNSPEC
+)
+_UPDATECOLUMNSPECREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEMODELREQUEST.fields_by_name[
+    "model"
+].message_type = google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2._MODEL
+_LISTMODELSRESPONSE.fields_by_name[
+    "model"
+].message_type = google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2._MODEL
+_DEPLOYMODELREQUEST.fields_by_name[
+    "image_object_detection_model_deployment_metadata"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_image__pb2._IMAGEOBJECTDETECTIONMODELDEPLOYMENTMETADATA
+)
+_DEPLOYMODELREQUEST.oneofs_by_name["model_deployment_metadata"].fields.append(
+    _DEPLOYMODELREQUEST.fields_by_name[
+        "image_object_detection_model_deployment_metadata"
+    ]
+)
+_DEPLOYMODELREQUEST.fields_by_name[
+    "image_object_detection_model_deployment_metadata"
+].containing_oneof = _DEPLOYMODELREQUEST.oneofs_by_name["model_deployment_metadata"]
+_EXPORTMODELREQUEST.fields_by_name[
+    "output_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._MODELEXPORTOUTPUTCONFIG
+)
+_EXPORTEVALUATEDEXAMPLESREQUEST.fields_by_name[
+    "output_config"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._EXPORTEVALUATEDEXAMPLESOUTPUTCONFIG
+)
+_LISTMODELEVALUATIONSRESPONSE.fields_by_name[
+    "model_evaluation"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2._MODELEVALUATION
+)
+DESCRIPTOR.message_types_by_name["CreateDatasetRequest"] = _CREATEDATASETREQUEST
+DESCRIPTOR.message_types_by_name["GetDatasetRequest"] = _GETDATASETREQUEST
+DESCRIPTOR.message_types_by_name["ListDatasetsRequest"] = _LISTDATASETSREQUEST
+DESCRIPTOR.message_types_by_name["ListDatasetsResponse"] = _LISTDATASETSRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateDatasetRequest"] = _UPDATEDATASETREQUEST
+DESCRIPTOR.message_types_by_name["DeleteDatasetRequest"] = _DELETEDATASETREQUEST
+DESCRIPTOR.message_types_by_name["ImportDataRequest"] = _IMPORTDATAREQUEST
+DESCRIPTOR.message_types_by_name["ExportDataRequest"] = _EXPORTDATAREQUEST
+DESCRIPTOR.message_types_by_name["GetAnnotationSpecRequest"] = _GETANNOTATIONSPECREQUEST
+DESCRIPTOR.message_types_by_name["GetTableSpecRequest"] = _GETTABLESPECREQUEST
+DESCRIPTOR.message_types_by_name["ListTableSpecsRequest"] = _LISTTABLESPECSREQUEST
+DESCRIPTOR.message_types_by_name["ListTableSpecsResponse"] = _LISTTABLESPECSRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateTableSpecRequest"] = _UPDATETABLESPECREQUEST
+DESCRIPTOR.message_types_by_name["GetColumnSpecRequest"] = _GETCOLUMNSPECREQUEST
+DESCRIPTOR.message_types_by_name["ListColumnSpecsRequest"] = _LISTCOLUMNSPECSREQUEST
+DESCRIPTOR.message_types_by_name["ListColumnSpecsResponse"] = _LISTCOLUMNSPECSRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateColumnSpecRequest"] = _UPDATECOLUMNSPECREQUEST
+DESCRIPTOR.message_types_by_name["CreateModelRequest"] = _CREATEMODELREQUEST
+DESCRIPTOR.message_types_by_name["GetModelRequest"] = _GETMODELREQUEST
+DESCRIPTOR.message_types_by_name["ListModelsRequest"] = _LISTMODELSREQUEST
+DESCRIPTOR.message_types_by_name["ListModelsResponse"] = _LISTMODELSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteModelRequest"] = _DELETEMODELREQUEST
+DESCRIPTOR.message_types_by_name["DeployModelRequest"] = _DEPLOYMODELREQUEST
+DESCRIPTOR.message_types_by_name["UndeployModelRequest"] = _UNDEPLOYMODELREQUEST
+DESCRIPTOR.message_types_by_name["ExportModelRequest"] = _EXPORTMODELREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ExportEvaluatedExamplesRequest"
+] = _EXPORTEVALUATEDEXAMPLESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetModelEvaluationRequest"
+] = _GETMODELEVALUATIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListModelEvaluationsRequest"
+] = _LISTMODELEVALUATIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListModelEvaluationsResponse"
+] = _LISTMODELEVALUATIONSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDATASETREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.CreateDataset][google.cloud.automl.v1beta1.AutoMl.CreateDataset].
+  
+  
+  Attributes:
+      parent:
+          The resource name of the project to create the dataset for.
+      dataset:
+          The dataset to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.CreateDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDatasetRequest)
+
+GetDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATASETREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.GetDataset][google.cloud.automl.v1beta1.AutoMl.GetDataset].
+  
+  
+  Attributes:
+      name:
+          The resource name of the dataset to retrieve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GetDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDatasetRequest)
+
+ListDatasetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDatasetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASETSREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ListDatasets][google.cloud.automl.v1beta1.AutoMl.ListDatasets].
+  
+  
+  Attributes:
+      parent:
+          The resource name of the project from which to list datasets.
+      filter:
+          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.
+      page_size:
+          Requested page size. Server may return fewer results than
+          requested. If unspecified, server will pick a default size.
+      page_token:
+          A token identifying a page of results for the server to return
+          Typically obtained via [ListDatasetsResponse.next\_page\_token
+          ][google.cloud.automl.v1beta1.ListDatasetsResponse.next\_page\
+          _token] of the previous [AutoMl.ListDatasets][google.cloud.aut
+          oml.v1beta1.AutoMl.ListDatasets] call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListDatasetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDatasetsRequest)
+
+ListDatasetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDatasetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASETSRESPONSE,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Response message for
+  [AutoMl.ListDatasets][google.cloud.automl.v1beta1.AutoMl.ListDatasets].
+  
+  
+  Attributes:
+      datasets:
+          The datasets read.
+      next_page_token:
+          A token to retrieve next page of results. Pass to [ListDataset
+          sRequest.page\_token][google.cloud.automl.v1beta1.ListDatasets
+          Request.page\_token] to obtain that page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListDatasetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDatasetsResponse)
+
+UpdateDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDATASETREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.UpdateDataset][google.cloud.automl.v1beta1.AutoMl.UpdateDataset]
+  
+  
+  Attributes:
+      dataset:
+          The dataset which replaces the resource on the server.
+      update_mask:
+          The update mask applies to the resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.UpdateDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDatasetRequest)
+
+DeleteDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDATASETREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.DeleteDataset][google.cloud.automl.v1beta1.AutoMl.DeleteDataset].
+  
+  
+  Attributes:
+      name:
+          The resource name of the dataset to delete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DeleteDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDatasetRequest)
+
+ImportDataRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportDataRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDATAREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ImportData][google.cloud.automl.v1beta1.AutoMl.ImportData].
+  
+  
+  Attributes:
+      name:
+          Required. Dataset name. Dataset must already exist. All
+          imported annotations and examples will be added.
+      input_config:
+          Required. The desired input location and its domain specific
+          semantics, if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ImportDataRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportDataRequest)
+
+ExportDataRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportDataRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDATAREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ExportData][google.cloud.automl.v1beta1.AutoMl.ExportData].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the dataset.
+      output_config:
+          Required. The desired output location.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportDataRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportDataRequest)
+
+GetAnnotationSpecRequest = _reflection.GeneratedProtocolMessageType(
+    "GetAnnotationSpecRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETANNOTATIONSPECREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.GetAnnotationSpec][google.cloud.automl.v1beta1.AutoMl.GetAnnotationSpec].
+  
+  
+  Attributes:
+      name:
+          The resource name of the annotation spec to retrieve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GetAnnotationSpecRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetAnnotationSpecRequest)
+
+GetTableSpecRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTableSpecRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTABLESPECREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.GetTableSpec][google.cloud.automl.v1beta1.AutoMl.GetTableSpec].
+  
+  
+  Attributes:
+      name:
+          The resource name of the table spec to retrieve.
+      field_mask:
+          Mask specifying which fields to read.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GetTableSpecRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTableSpecRequest)
+
+ListTableSpecsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTableSpecsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTABLESPECSREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ListTableSpecs][google.cloud.automl.v1beta1.AutoMl.ListTableSpecs].
+  
+  
+  Attributes:
+      parent:
+          The resource name of the dataset to list table specs from.
+      field_mask:
+          Mask specifying which fields to read.
+      filter:
+          Filter expression, see go/filtering.
+      page_size:
+          Requested page size. The server can return fewer results than
+          requested. If unspecified, the server will pick a default
+          size.
+      page_token:
+          A token identifying a page of results for the server to
+          return. Typically obtained from the [ListTableSpecsResponse.ne
+          xt\_page\_token][google.cloud.automl.v1beta1.ListTableSpecsRes
+          ponse.next\_page\_token] field of the previous [AutoMl.ListTab
+          leSpecs][google.cloud.automl.v1beta1.AutoMl.ListTableSpecs]
+          call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListTableSpecsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTableSpecsRequest)
+
+ListTableSpecsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTableSpecsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTABLESPECSRESPONSE,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Response message for
+  [AutoMl.ListTableSpecs][google.cloud.automl.v1beta1.AutoMl.ListTableSpecs].
+  
+  
+  Attributes:
+      table_specs:
+          The table specs read.
+      next_page_token:
+          A token to retrieve next page of results. Pass to [ListTableSp
+          ecsRequest.page\_token][google.cloud.automl.v1beta1.ListTableS
+          pecsRequest.page\_token] to obtain that page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListTableSpecsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTableSpecsResponse)
+
+UpdateTableSpecRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTableSpecRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETABLESPECREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.UpdateTableSpec][google.cloud.automl.v1beta1.AutoMl.UpdateTableSpec]
+  
+  
+  Attributes:
+      table_spec:
+          The table spec which replaces the resource on the server.
+      update_mask:
+          The update mask applies to the resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.UpdateTableSpecRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTableSpecRequest)
+
+GetColumnSpecRequest = _reflection.GeneratedProtocolMessageType(
+    "GetColumnSpecRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCOLUMNSPECREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.GetColumnSpec][google.cloud.automl.v1beta1.AutoMl.GetColumnSpec].
+  
+  
+  Attributes:
+      name:
+          The resource name of the column spec to retrieve.
+      field_mask:
+          Mask specifying which fields to read.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GetColumnSpecRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetColumnSpecRequest)
+
+ListColumnSpecsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListColumnSpecsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOLUMNSPECSREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ListColumnSpecs][google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs].
+  
+  
+  Attributes:
+      parent:
+          The resource name of the table spec to list column specs from.
+      field_mask:
+          Mask specifying which fields to read.
+      filter:
+          Filter expression, see go/filtering.
+      page_size:
+          Requested page size. The server can return fewer results than
+          requested. If unspecified, the server will pick a default
+          size.
+      page_token:
+          A token identifying a page of results for the server to
+          return. Typically obtained from the [ListColumnSpecsResponse.n
+          ext\_page\_token][google.cloud.automl.v1beta1.ListColumnSpecsR
+          esponse.next\_page\_token] field of the previous [AutoMl.ListC
+          olumnSpecs][google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs
+          ] call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListColumnSpecsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListColumnSpecsRequest)
+
+ListColumnSpecsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListColumnSpecsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOLUMNSPECSRESPONSE,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Response message for
+  [AutoMl.ListColumnSpecs][google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs].
+  
+  
+  Attributes:
+      column_specs:
+          The column specs read.
+      next_page_token:
+          A token to retrieve next page of results. Pass to [ListColumnS
+          pecsRequest.page\_token][google.cloud.automl.v1beta1.ListColum
+          nSpecsRequest.page\_token] to obtain that page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListColumnSpecsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListColumnSpecsResponse)
+
+UpdateColumnSpecRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateColumnSpecRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECOLUMNSPECREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.UpdateColumnSpec][google.cloud.automl.v1beta1.AutoMl.UpdateColumnSpec]
+  
+  
+  Attributes:
+      column_spec:
+          The column spec which replaces the resource on the server.
+      update_mask:
+          The update mask applies to the resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.UpdateColumnSpecRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateColumnSpecRequest)
+
+CreateModelRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEMODELREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.CreateModel][google.cloud.automl.v1beta1.AutoMl.CreateModel].
+  
+  
+  Attributes:
+      parent:
+          Resource name of the parent project where the model is being
+          created.
+      model:
+          The model to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.CreateModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateModelRequest)
+
+GetModelRequest = _reflection.GeneratedProtocolMessageType(
+    "GetModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETMODELREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.GetModel][google.cloud.automl.v1beta1.AutoMl.GetModel].
+  
+  
+  Attributes:
+      name:
+          Resource name of the model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GetModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetModelRequest)
+
+ListModelsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListModelsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMODELSREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ListModels][google.cloud.automl.v1beta1.AutoMl.ListModels].
+  
+  
+  Attributes:
+      parent:
+          Resource name of the project, from which to list the models.
+      filter:
+          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.
+      page_size:
+          Requested page size.
+      page_token:
+          A token identifying a page of results for the server to return
+          Typically obtained via [ListModelsResponse.next\_page\_token][
+          google.cloud.automl.v1beta1.ListModelsResponse.next\_page\_tok
+          en] of the previous [AutoMl.ListModels][google.cloud.automl.v1
+          beta1.AutoMl.ListModels] call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListModelsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListModelsRequest)
+
+ListModelsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListModelsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMODELSRESPONSE,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Response message for
+  [AutoMl.ListModels][google.cloud.automl.v1beta1.AutoMl.ListModels].
+  
+  
+  Attributes:
+      model:
+          List of models in the requested page.
+      next_page_token:
+          A token to retrieve next page of results. Pass to [ListModelsR
+          equest.page\_token][google.cloud.automl.v1beta1.ListModelsRequ
+          est.page\_token] to obtain that page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListModelsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListModelsResponse)
+
+DeleteModelRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEMODELREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.DeleteModel][google.cloud.automl.v1beta1.AutoMl.DeleteModel].
+  
+  
+  Attributes:
+      name:
+          Resource name of the model being deleted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DeleteModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteModelRequest)
+
+DeployModelRequest = _reflection.GeneratedProtocolMessageType(
+    "DeployModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEPLOYMODELREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.DeployModel][google.cloud.automl.v1beta1.AutoMl.DeployModel].
+  
+  
+  Attributes:
+      model_deployment_metadata:
+          The per-domain specific deployment parameters.
+      image_object_detection_model_deployment_metadata:
+          Model deployment metadata specific to Image Object Detection.
+      name:
+          Resource name of the model to deploy.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.DeployModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeployModelRequest)
+
+UndeployModelRequest = _reflection.GeneratedProtocolMessageType(
+    "UndeployModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UNDEPLOYMODELREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.UndeployModel][google.cloud.automl.v1beta1.AutoMl.UndeployModel].
+  
+  
+  Attributes:
+      name:
+          Resource name of the model to undeploy.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.UndeployModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(UndeployModelRequest)
+
+ExportModelRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTMODELREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ExportModel][google.cloud.automl.v1beta1.AutoMl.ExportModel].
+  Models need to be enabled for exporting, otherwise an error code will be
+  returned.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the model to export.
+      output_config:
+          Required. The desired output location and configuration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportModelRequest)
+
+ExportEvaluatedExamplesRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportEvaluatedExamplesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTEVALUATEDEXAMPLESREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ExportEvaluatedExamples][google.cloud.automl.v1beta1.AutoMl.ExportEvaluatedExamples].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the model whose evaluated
+          examples are to be exported.
+      output_config:
+          Required. The desired output location and configuration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ExportEvaluatedExamplesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportEvaluatedExamplesRequest)
+
+GetModelEvaluationRequest = _reflection.GeneratedProtocolMessageType(
+    "GetModelEvaluationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETMODELEVALUATIONREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.GetModelEvaluation][google.cloud.automl.v1beta1.AutoMl.GetModelEvaluation].
+  
+  
+  Attributes:
+      name:
+          Resource name for the model evaluation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.GetModelEvaluationRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetModelEvaluationRequest)
+
+ListModelEvaluationsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListModelEvaluationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMODELEVALUATIONSREQUEST,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Request message for
+  [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations].
+  
+  
+  Attributes:
+      parent:
+          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.
+      filter:
+          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.
+      page_size:
+          Requested page size.
+      page_token:
+          A token identifying a page of results for the server to
+          return. Typically obtained via [ListModelEvaluationsResponse.n
+          ext\_page\_token][google.cloud.automl.v1beta1.ListModelEvaluat
+          ionsResponse.next\_page\_token] of the previous [AutoMl.ListMo
+          delEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEv
+          aluations] call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListModelEvaluationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListModelEvaluationsRequest)
+
+ListModelEvaluationsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListModelEvaluationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMODELEVALUATIONSRESPONSE,
+        __module__="google.cloud.automl_v1beta1.proto.service_pb2",
+        __doc__="""Response message for
+  [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations].
+  
+  
+  Attributes:
+      model_evaluation:
+          List of model evaluations in the requested page.
+      next_page_token:
+          A token to retrieve next page of results. Pass to the [ListMod
+          elEvaluationsRequest.page\_token][google.cloud.automl.v1beta1.
+          ListModelEvaluationsRequest.page\_token] field of a new [AutoM
+          l.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.Lis
+          tModelEvaluations] request to obtain that page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.ListModelEvaluationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListModelEvaluationsResponse)
+
+
+DESCRIPTOR._options = None
+
+_AUTOML = _descriptor.ServiceDescriptor(
+    name="AutoMl",
+    full_name="google.cloud.automl.v1beta1.AutoMl",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\025automl.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=3539,
+    serialized_end=7980,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateDataset",
+            full_name="google.cloud.automl.v1beta1.AutoMl.CreateDataset",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEDATASETREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2._DATASET,
+            serialized_options=_b(
+                '\202\323\344\223\002<"1/v1beta1/{parent=projects/*/locations/*}/datasets:\007dataset'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDataset",
+            full_name="google.cloud.automl.v1beta1.AutoMl.GetDataset",
+            index=1,
+            containing_service=None,
+            input_type=_GETDATASETREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2._DATASET,
+            serialized_options=_b(
+                "\202\323\344\223\0023\0221/v1beta1/{name=projects/*/locations/*/datasets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDatasets",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ListDatasets",
+            index=2,
+            containing_service=None,
+            input_type=_LISTDATASETSREQUEST,
+            output_type=_LISTDATASETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0023\0221/v1beta1/{parent=projects/*/locations/*}/datasets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDataset",
+            full_name="google.cloud.automl.v1beta1.AutoMl.UpdateDataset",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEDATASETREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2._DATASET,
+            serialized_options=_b(
+                "\202\323\344\223\002D29/v1beta1/{dataset.name=projects/*/locations/*/datasets/*}:\007dataset"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDataset",
+            full_name="google.cloud.automl.v1beta1.AutoMl.DeleteDataset",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEDATASETREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\0023*1/v1beta1/{name=projects/*/locations/*/datasets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportData",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ImportData",
+            index=5,
+            containing_service=None,
+            input_type=_IMPORTDATAREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002A"</v1beta1/{name=projects/*/locations/*/datasets/*}:importData:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportData",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ExportData",
+            index=6,
+            containing_service=None,
+            input_type=_EXPORTDATAREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002A"</v1beta1/{name=projects/*/locations/*/datasets/*}:exportData:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetAnnotationSpec",
+            full_name="google.cloud.automl.v1beta1.AutoMl.GetAnnotationSpec",
+            index=7,
+            containing_service=None,
+            input_type=_GETANNOTATIONSPECREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2._ANNOTATIONSPEC,
+            serialized_options=_b(
+                "\202\323\344\223\002E\022C/v1beta1/{name=projects/*/locations/*/datasets/*/annotationSpecs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTableSpec",
+            full_name="google.cloud.automl.v1beta1.AutoMl.GetTableSpec",
+            index=8,
+            containing_service=None,
+            input_type=_GETTABLESPECREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2._TABLESPEC,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTableSpecs",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ListTableSpecs",
+            index=9,
+            containing_service=None,
+            input_type=_LISTTABLESPECSREQUEST,
+            output_type=_LISTTABLESPECSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1beta1/{parent=projects/*/locations/*/datasets/*}/tableSpecs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTableSpec",
+            full_name="google.cloud.automl.v1beta1.AutoMl.UpdateTableSpec",
+            index=10,
+            containing_service=None,
+            input_type=_UPDATETABLESPECREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2._TABLESPEC,
+            serialized_options=_b(
+                "\202\323\344\223\002W2I/v1beta1/{table_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*}:\ntable_spec"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetColumnSpec",
+            full_name="google.cloud.automl.v1beta1.AutoMl.GetColumnSpec",
+            index=11,
+            containing_service=None,
+            input_type=_GETCOLUMNSPECREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2._COLUMNSPEC,
+            serialized_options=_b(
+                "\202\323\344\223\002N\022L/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListColumnSpecs",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs",
+            index=12,
+            containing_service=None,
+            input_type=_LISTCOLUMNSPECSREQUEST,
+            output_type=_LISTCOLUMNSPECSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002N\022L/v1beta1/{parent=projects/*/locations/*/datasets/*/tableSpecs/*}/columnSpecs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateColumnSpec",
+            full_name="google.cloud.automl.v1beta1.AutoMl.UpdateColumnSpec",
+            index=13,
+            containing_service=None,
+            input_type=_UPDATECOLUMNSPECREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2._COLUMNSPEC,
+            serialized_options=_b(
+                "\202\323\344\223\002g2X/v1beta1/{column_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}:\013column_spec"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateModel",
+            full_name="google.cloud.automl.v1beta1.AutoMl.CreateModel",
+            index=14,
+            containing_service=None,
+            input_type=_CREATEMODELREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0028"//v1beta1/{parent=projects/*/locations/*}/models:\005model'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetModel",
+            full_name="google.cloud.automl.v1beta1.AutoMl.GetModel",
+            index=15,
+            containing_service=None,
+            input_type=_GETMODELREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2._MODEL,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1beta1/{name=projects/*/locations/*/models/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListModels",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ListModels",
+            index=16,
+            containing_service=None,
+            input_type=_LISTMODELSREQUEST,
+            output_type=_LISTMODELSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1beta1/{parent=projects/*/locations/*}/models"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteModel",
+            full_name="google.cloud.automl.v1beta1.AutoMl.DeleteModel",
+            index=17,
+            containing_service=None,
+            input_type=_DELETEMODELREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v1beta1/{name=projects/*/locations/*/models/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeployModel",
+            full_name="google.cloud.automl.v1beta1.AutoMl.DeployModel",
+            index=18,
+            containing_service=None,
+            input_type=_DEPLOYMODELREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1beta1/{name=projects/*/locations/*/models/*}:deploy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UndeployModel",
+            full_name="google.cloud.automl.v1beta1.AutoMl.UndeployModel",
+            index=19,
+            containing_service=None,
+            input_type=_UNDEPLOYMODELREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v1beta1/{name=projects/*/locations/*/models/*}:undeploy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportModel",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ExportModel",
+            index=20,
+            containing_service=None,
+            input_type=_EXPORTMODELREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1beta1/{name=projects/*/locations/*/models/*}:export:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportEvaluatedExamples",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ExportEvaluatedExamples",
+            index=21,
+            containing_service=None,
+            input_type=_EXPORTEVALUATEDEXAMPLESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002L"G/v1beta1/{name=projects/*/locations/*/models/*}:exportEvaluatedExamples:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetModelEvaluation",
+            full_name="google.cloud.automl.v1beta1.AutoMl.GetModelEvaluation",
+            index=22,
+            containing_service=None,
+            input_type=_GETMODELEVALUATIONREQUEST,
+            output_type=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2._MODELEVALUATION,
+            serialized_options=_b(
+                "\202\323\344\223\002D\022B/v1beta1/{name=projects/*/locations/*/models/*/modelEvaluations/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListModelEvaluations",
+            full_name="google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations",
+            index=23,
+            containing_service=None,
+            input_type=_LISTMODELEVALUATIONSREQUEST,
+            output_type=_LISTMODELEVALUATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002D\022B/v1beta1/{parent=projects/*/locations/*/models/*}/modelEvaluations"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_AUTOML)
+
+DESCRIPTOR.services_by_name["AutoMl"] = _AUTOML
+
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/service_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/service_pb2_grpc.py
new file mode 100644
index 000000000000..eb049c207ee7
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/service_pb2_grpc.py
@@ -0,0 +1,545 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.automl_v1beta1.proto import (
+    annotation_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    column_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    model_evaluation_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    model_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    service_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    table_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class AutoMlStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateDataset = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/CreateDataset",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.CreateDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.Dataset.FromString,
+        )
+        self.GetDataset = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/GetDataset",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.Dataset.FromString,
+        )
+        self.ListDatasets = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ListDatasets",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListDatasetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListDatasetsResponse.FromString,
+        )
+        self.UpdateDataset = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/UpdateDataset",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UpdateDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.Dataset.FromString,
+        )
+        self.DeleteDataset = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/DeleteDataset",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.DeleteDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ImportData = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ImportData",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ImportDataRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ExportData = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ExportData",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ExportDataRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetAnnotationSpec = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/GetAnnotationSpec",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetAnnotationSpecRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2.AnnotationSpec.FromString,
+        )
+        self.GetTableSpec = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/GetTableSpec",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetTableSpecRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2.TableSpec.FromString,
+        )
+        self.ListTableSpecs = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ListTableSpecs",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListTableSpecsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListTableSpecsResponse.FromString,
+        )
+        self.UpdateTableSpec = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/UpdateTableSpec",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UpdateTableSpecRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2.TableSpec.FromString,
+        )
+        self.GetColumnSpec = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/GetColumnSpec",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetColumnSpecRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2.ColumnSpec.FromString,
+        )
+        self.ListColumnSpecs = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ListColumnSpecs",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListColumnSpecsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListColumnSpecsResponse.FromString,
+        )
+        self.UpdateColumnSpec = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/UpdateColumnSpec",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UpdateColumnSpecRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2.ColumnSpec.FromString,
+        )
+        self.CreateModel = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/CreateModel",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.CreateModelRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetModel = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/GetModel",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetModelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2.Model.FromString,
+        )
+        self.ListModels = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ListModels",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelsResponse.FromString,
+        )
+        self.DeleteModel = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/DeleteModel",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.DeleteModelRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeployModel = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/DeployModel",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.DeployModelRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UndeployModel = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/UndeployModel",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UndeployModelRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ExportModel = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ExportModel",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ExportModelRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ExportEvaluatedExamples = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ExportEvaluatedExamples",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ExportEvaluatedExamplesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetModelEvaluation = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/GetModelEvaluation",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetModelEvaluationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2.ModelEvaluation.FromString,
+        )
+        self.ListModelEvaluations = channel.unary_unary(
+            "/google.cloud.automl.v1beta1.AutoMl/ListModelEvaluations",
+            request_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelEvaluationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelEvaluationsResponse.FromString,
+        )
+
+
+class AutoMlServicer(object):
+    """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.
+  """
+
+    def CreateDataset(self, request, context):
+        """Creates a dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDataset(self, request, context):
+        """Gets a dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDatasets(self, request, context):
+        """Lists datasets in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDataset(self, request, context):
+        """Updates a dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDataset(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportData(self, request, context):
+        """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.v1beta1.InputConfig.params]
+    parameter must be explicitly set.
+    Returns an empty response in the
+    [response][google.longrunning.Operation.response] field when it completes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportData(self, request, context):
+        """Exports dataset's data to the provided output location.
+    Returns an empty response in the
+    [response][google.longrunning.Operation.response] field when it completes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetAnnotationSpec(self, request, context):
+        """Gets an annotation spec.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTableSpec(self, request, context):
+        """Gets a table spec.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTableSpecs(self, request, context):
+        """Lists table specs in a dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTableSpec(self, request, context):
+        """Updates a table spec.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetColumnSpec(self, request, context):
+        """Gets a column spec.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListColumnSpecs(self, request, context):
+        """Lists column specs in a table spec.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateColumnSpec(self, request, context):
+        """Updates a column spec.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateModel(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetModel(self, request, context):
+        """Gets a model.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListModels(self, request, context):
+        """Lists models.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteModel(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeployModel(self, request, context):
+        """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.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.
+
+    Returns an empty response in the
+    [response][google.longrunning.Operation.response] field when it completes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UndeployModel(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportModel(self, request, context):
+        """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.v1beta1.ModelExportOutputConfig].
+
+    Returns an empty response in the
+    [response][google.longrunning.Operation.response] field when it completes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportEvaluatedExamples(self, request, context):
+        """Exports examples on which the model was evaluated (i.e. which were in the
+    TEST set of the dataset the model was created from), together with their
+    ground truth annotations and the annotations created (predicted) by the
+    model.
+    The examples, ground truth and predictions are exported in the state
+    they were at the moment the model was evaluated.
+
+    This export is available only for 30 days since the model evaluation is
+    created.
+
+    Currently only available for Tables.
+
+    Returns an empty response in the
+    [response][google.longrunning.Operation.response] field when it completes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetModelEvaluation(self, request, context):
+        """Gets a model evaluation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListModelEvaluations(self, request, context):
+        """Lists model evaluations.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_AutoMlServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDataset,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.CreateDatasetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.Dataset.SerializeToString,
+        ),
+        "GetDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDataset,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetDatasetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.Dataset.SerializeToString,
+        ),
+        "ListDatasets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDatasets,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListDatasetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListDatasetsResponse.SerializeToString,
+        ),
+        "UpdateDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDataset,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UpdateDatasetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_dataset__pb2.Dataset.SerializeToString,
+        ),
+        "DeleteDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDataset,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.DeleteDatasetRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ImportData": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportData,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ImportDataRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ExportData": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportData,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ExportDataRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetAnnotationSpec": grpc.unary_unary_rpc_method_handler(
+            servicer.GetAnnotationSpec,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetAnnotationSpecRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_annotation__spec__pb2.AnnotationSpec.SerializeToString,
+        ),
+        "GetTableSpec": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTableSpec,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetTableSpecRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2.TableSpec.SerializeToString,
+        ),
+        "ListTableSpecs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTableSpecs,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListTableSpecsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListTableSpecsResponse.SerializeToString,
+        ),
+        "UpdateTableSpec": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTableSpec,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UpdateTableSpecRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_table__spec__pb2.TableSpec.SerializeToString,
+        ),
+        "GetColumnSpec": grpc.unary_unary_rpc_method_handler(
+            servicer.GetColumnSpec,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetColumnSpecRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2.ColumnSpec.SerializeToString,
+        ),
+        "ListColumnSpecs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListColumnSpecs,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListColumnSpecsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListColumnSpecsResponse.SerializeToString,
+        ),
+        "UpdateColumnSpec": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateColumnSpec,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UpdateColumnSpecRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2.ColumnSpec.SerializeToString,
+        ),
+        "CreateModel": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateModel,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.CreateModelRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetModel": grpc.unary_unary_rpc_method_handler(
+            servicer.GetModel,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetModelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__pb2.Model.SerializeToString,
+        ),
+        "ListModels": grpc.unary_unary_rpc_method_handler(
+            servicer.ListModels,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelsResponse.SerializeToString,
+        ),
+        "DeleteModel": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteModel,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.DeleteModelRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeployModel": grpc.unary_unary_rpc_method_handler(
+            servicer.DeployModel,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.DeployModelRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UndeployModel": grpc.unary_unary_rpc_method_handler(
+            servicer.UndeployModel,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.UndeployModelRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ExportModel": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportModel,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ExportModelRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ExportEvaluatedExamples": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportEvaluatedExamples,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ExportEvaluatedExamplesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetModelEvaluation": grpc.unary_unary_rpc_method_handler(
+            servicer.GetModelEvaluation,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.GetModelEvaluationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_model__evaluation__pb2.ModelEvaluation.SerializeToString,
+        ),
+        "ListModelEvaluations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListModelEvaluations,
+            request_deserializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelEvaluationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_service__pb2.ListModelEvaluationsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.automl.v1beta1.AutoMl", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/automl/google/cloud/automl_v1beta1/proto/table_spec.proto b/automl/google/cloud/automl_v1beta1/proto/table_spec.proto
new file mode 100644
index 000000000000..4475617ae275
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/table_spec.proto
@@ -0,0 +1,73 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/io.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// A specification of a relational table.
+// The table's schema is represented via its child column specs. It is
+// pre-populated as part of ImportData by schema inference algorithm, the
+// version of which is a required parameter of ImportData InputConfig.
+// Note: While working with a table, at times the schema may be
+// inconsistent with the data in the table (e.g. string in a FLOAT64 column).
+// The consistency validation is done upon creation of a model.
+// Used by:
+//   *   Tables
+message TableSpec {
+  // Output only. The resource name of the table spec.
+  // Form:
+  //
+  // `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/tableSpecs/{table_spec_id}`
+  string name = 1;
+
+  // column_spec_id of the time column. Only used if the parent dataset's
+  // ml_use_column_spec_id is not set. Used to split rows into TRAIN, VALIDATE
+  // and TEST sets such that oldest rows go to TRAIN set, newest to TEST, and
+  // those in between to VALIDATE.
+  // Required type: TIMESTAMP.
+  // If both this column and ml_use_column are not set, then ML use of all rows
+  // will be assigned by AutoML. NOTE: Updates of this field will instantly
+  // affect any other users concurrently working with the dataset.
+  string time_column_spec_id = 2;
+
+  // 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;
+
+  // Output only. Input configs via which data currently residing in the table
+  // had been imported.
+  repeated InputConfig input_configs = 5;
+
+  // Used to perform consistent read-modify-write updates. If not set, a blind
+  // "overwrite" update happens.
+  string etag = 6;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2.py b/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2.py
new file mode 100644
index 000000000000..9f5f386f83a2
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2.py
@@ -0,0 +1,244 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/table_spec.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    io_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/table_spec.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/automl_v1beta1/proto/table_spec.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a*google/cloud/automl_v1beta1/proto/io.proto\x1a\x1cgoogle/api/annotations.proto"\xc7\x01\n\tTableSpec\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1b\n\x13time_column_spec_id\x18\x02 \x01(\t\x12\x11\n\trow_count\x18\x03 \x01(\x03\x12\x17\n\x0fvalid_row_count\x18\x04 \x01(\x03\x12\x14\n\x0c\x63olumn_count\x18\x07 \x01(\x03\x12?\n\rinput_configs\x18\x05 \x03(\x0b\x32(.google.cloud.automl.v1beta1.InputConfig\x12\x0c\n\x04\x65tag\x18\x06 \x01(\tB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TABLESPEC = _descriptor.Descriptor(
+    name="TableSpec",
+    full_name="google.cloud.automl.v1beta1.TableSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.automl.v1beta1.TableSpec.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_column_spec_id",
+            full_name="google.cloud.automl.v1beta1.TableSpec.time_column_spec_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_count",
+            full_name="google.cloud.automl.v1beta1.TableSpec.row_count",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_row_count",
+            full_name="google.cloud.automl.v1beta1.TableSpec.valid_row_count",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_count",
+            full_name="google.cloud.automl.v1beta1.TableSpec.column_count",
+            index=4,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_configs",
+            full_name="google.cloud.automl.v1beta1.TableSpec.input_configs",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.automl.v1beta1.TableSpec.etag",
+            index=6,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=158,
+    serialized_end=357,
+)
+
+_TABLESPEC.fields_by_name[
+    "input_configs"
+].message_type = google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_io__pb2._INPUTCONFIG
+DESCRIPTOR.message_types_by_name["TableSpec"] = _TABLESPEC
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TableSpec = _reflection.GeneratedProtocolMessageType(
+    "TableSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLESPEC,
+        __module__="google.cloud.automl_v1beta1.proto.table_spec_pb2",
+        __doc__="""A specification of a relational table. The table's schema is represented
+  via its child column specs. It is pre-populated as part of ImportData by
+  schema inference algorithm, the version of which is a required parameter
+  of ImportData InputConfig. Note: While working with a table, at times
+  the schema may be inconsistent with the data in the table (e.g. string
+  in a FLOAT64 column). The consistency validation is done upon creation
+  of a model. Used by: \* Tables
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name of the table spec. Form:  ``pro
+          jects/{project_id}/locations/{location_id}/datasets/{dataset_i
+          d}/tableSpecs/{table_spec_id}``
+      time_column_spec_id:
+          column\_spec\_id of the time column. Only used if the parent
+          dataset's ml\_use\_column\_spec\_id is not set. Used to split
+          rows into TRAIN, VALIDATE and TEST sets such that oldest rows
+          go to TRAIN set, newest to TEST, and those in between to
+          VALIDATE. Required type: TIMESTAMP. If both this column and
+          ml\_use\_column are not set, then ML use of all rows will be
+          assigned by AutoML. NOTE: Updates of this field will instantly
+          affect any other users concurrently working with the dataset.
+      row_count:
+          Output only. The number of rows (i.e. examples) in the table.
+      valid_row_count:
+          Output only. The number of valid rows (i.e. without values
+          that don't match DataType-s of their columns).
+      column_count:
+          Output only. The number of columns of the table. That is, the
+          number of child ColumnSpec-s.
+      input_configs:
+          Output only. Input configs via which data currently residing
+          in the table had been imported.
+      etag:
+          Used to perform consistent read-modify-write updates. If not
+          set, a blind "overwrite" update happens.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TableSpec)
+    ),
+)
+_sym_db.RegisterMessage(TableSpec)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/table_spec_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/tables.proto b/automl/google/cloud/automl_v1beta1/proto/tables.proto
new file mode 100644
index 000000000000..c8b7809b6cf1
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/tables.proto
@@ -0,0 +1,269 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/classification.proto";
+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/temporal.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/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// Metadata for a dataset used for AutoML Tables.
+message TablesDatasetMetadata {
+  // Output only. The table_spec_id of the primary table of this dataset.
+  string primary_table_spec_id = 1;
+
+  // column_spec_id of the primary table's column that should be used as the
+  // training & prediction target.
+  // This column must be non-nullable and have one of following data types
+  // (otherwise model creation will error):
+  //
+  // * CATEGORY
+  //
+  // * FLOAT64
+  //
+  // 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
+  // concurrently working with the dataset.
+  string target_column_spec_id = 2;
+
+  // column_spec_id of the primary table's column that should be used as the
+  // weight column, i.e. the higher the value the more important the row will be
+  // during model training.
+  // Required type: FLOAT64.
+  // Allowed values: 0 to 10000, inclusive on both ends; 0 means the row is
+  //                 ignored for training.
+  // If not set all rows are assumed to have equal weight of 1.
+  // NOTE: Updates of this field will instantly affect any other users
+  // concurrently working with the dataset.
+  string weight_column_spec_id = 3;
+
+  // column_spec_id of the primary table column which specifies a possible ML
+  // use of the row, i.e. the column will be used to split the rows into TRAIN,
+  // VALIDATE and TEST sets.
+  // Required type: STRING.
+  // This column, if set, must either have all of `TRAIN`, `VALIDATE`, `TEST`
+  // among its values, or only have `TEST`, `UNASSIGNED` values. In the latter
+  // case the rows with `UNASSIGNED` value will be assigned by AutoML. Note
+  // that if a given ml use distribution makes it impossible to create a "good"
+  // model, that call will error describing the issue.
+  // If both this column_spec_id and primary table's time_column_spec_id are not
+  // set, then all rows are treated as `UNASSIGNED`.
+  // NOTE: Updates of this field will instantly affect any other users
+  // concurrently working with the dataset.
+  string ml_use_column_spec_id = 4;
+
+  // Output only. Correlations between
+  //
+  // [TablesDatasetMetadata.target_column_spec_id][google.cloud.automl.v1beta1.TablesDatasetMetadata.target_column_spec_id],
+  // and other columns of the
+  //
+  // [TablesDatasetMetadataprimary_table][google.cloud.automl.v1beta1.TablesDatasetMetadata.primary_table_spec_id].
+  // Only set if the target column is set. Mapping from other column spec id to
+  // its CorrelationStats with the target column.
+  // This field may be stale, see the stats_update_time field for
+  // for the timestamp at which these stats were last updated.
+  map<string, CorrelationStats> target_column_correlations = 6;
+
+  // 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 {
+  // Column spec of the dataset's primary table's column the model is
+  // predicting. Snapshotted when model creation started.
+  // Only 3 fields are used:
+  // name - May be set on CreateModel, if it's not then the ColumnSpec
+  //        corresponding to the current target_column_spec_id of the dataset
+  //        the model is trained from is used.
+  //        If neither is set, CreateModel will error.
+  // display_name - Output only.
+  // data_type - Output only.
+  ColumnSpec target_column_spec = 2;
+
+  // Column specs of the dataset's primary table's columns, on which
+  // the model is trained and which are used as the input for predictions.
+  // The
+  //
+  // [target_column][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]
+  // as well as, according to dataset's state upon model creation,
+  //
+  // [weight_column][google.cloud.automl.v1beta1.TablesDatasetMetadata.weight_column_spec_id],
+  // and
+  //
+  // [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.
+  repeated ColumnSpec input_feature_column_specs = 3;
+
+  // Objective function the model is optimizing towards. The training process
+  // creates a model that maximizes/minimizes the value of the objective
+  // function over the validation set.
+  //
+  // The supported optimization objectives depend on the prediction type.
+  // If the field is not set, a default objective function is used.
+  //
+  // CLASSIFICATION_BINARY:
+  //   "MAXIMIZE_AU_ROC" (default) - Maximize the area under the receiver
+  //                                 operating characteristic (ROC) curve.
+  //   "MINIMIZE_LOG_LOSS" - Minimize log loss.
+  //   "MAXIMIZE_AU_PRC" - Maximize the area under the precision-recall curve.
+  //   "MAXIMIZE_PRECISION_AT_RECALL" - Maximize precision for a specified
+  //                                   recall value.
+  //   "MAXIMIZE_RECALL_AT_PRECISION" - Maximize recall for a specified
+  //                                    precision value.
+  //
+  // CLASSIFICATION_MULTI_CLASS :
+  //   "MINIMIZE_LOG_LOSS" (default) - Minimize log loss.
+  //
+  //
+  // REGRESSION:
+  //   "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).
+  string optimization_objective = 4;
+
+  // 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;
+
+  // Required. 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 training cost of the model will not exceed this budget. The final cost
+  // will be attempted to be close to the budget, though may end up being (even)
+  // noticeably smaller - at the backend's discretion. This especially may
+  // happen when further model training ceases to provide any improvements.
+  //
+  // If the budget is set to a value known to be insufficient to train a
+  // model for the given dataset, the training won't be attempted and
+  // will error.
+  //
+  // The train budget must be between 1,000 and 72,000 milli node hours,
+  // inclusive.
+  int64 train_budget_milli_node_hours = 6;
+
+  // Output only. The actual training cost of the 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;
+
+  // Use the entire training budget. This disables the early stopping feature.
+  // By default, the early stopping feature is enabled, which means that AutoML
+  // Tables might stop training before the entire training budget has been used.
+  bool disable_early_stopping = 12;
+}
+
+// Contains annotation details specific to Tables.
+message TablesAnnotation {
+  // Output only. A confidence estimate between 0.0 and 1.0, inclusive. A higher
+  // value means greater confidence in the returned value.
+  // For
+  //
+  // [target_column_spec][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]
+  // of FLOAT64 data type the score is not populated.
+  float score = 1;
+
+  // Output only. Only populated when
+  //
+  // [target_column_spec][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]
+  // has FLOAT64 data type. An interval in which the exactly correct target
+  // value has 95% chance to be in.
+  DoubleRange prediction_interval = 4;
+
+  // The predicted value of the row's
+  //
+  // [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.
+  google.protobuf.Value value = 2;
+
+  // Output only. Auxiliary information for each of the model's
+  //
+  // [input_feature_column_specs][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs]
+  // with respect to this particular prediction.
+  // If no other fields than
+  //
+  // [column_spec_name][google.cloud.automl.v1beta1.TablesModelColumnInfo.column_spec_name]
+  // and
+  //
+  // [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;
+}
+
+// An information specific to given column and Tables Model, in context
+// of the Model and the predictions created by it.
+message TablesModelColumnInfo {
+  // Output only. The name of the ColumnSpec describing the column. Not
+  // populated when this proto is outputted to BigQuery.
+  string column_spec_name = 1;
+
+  // Output only. The display name of the column (same as the display_name of
+  // its ColumnSpec).
+  string column_display_name = 2;
+
+  // 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
+  // columns of a given model they add to 1.
+  //
+  // When given back by Predict (populated iff
+  // [feature_importance
+  // param][google.cloud.automl.v1beta1.PredictRequest.params] is set) or Batch
+  // Predict (populated iff
+  // [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.
+  float feature_importance = 3;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/tables_pb2.py b/automl/google/cloud/automl_v1beta1/proto/tables_pb2.py
new file mode 100644
index 000000000000..b55cfa1f247b
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/tables_pb2.py
@@ -0,0 +1,855 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/tables.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    column_spec_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    data_items_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    data_stats_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    ranges_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_ranges__pb2,
+)
+from google.cloud.automl_v1beta1.proto import (
+    temporal_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_temporal__pb2,
+)
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/tables.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/automl_v1beta1/proto/tables.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x33google/cloud/automl_v1beta1/proto/column_spec.proto\x1a\x32google/cloud/automl_v1beta1/proto/data_items.proto\x1a\x32google/cloud/automl_v1beta1/proto/data_stats.proto\x1a.google/cloud/automl_v1beta1/proto/ranges.proto\x1a\x30google/cloud/automl_v1beta1/proto/temporal.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xb0\x03\n\x15TablesDatasetMetadata\x12\x1d\n\x15primary_table_spec_id\x18\x01 \x01(\t\x12\x1d\n\x15target_column_spec_id\x18\x02 \x01(\t\x12\x1d\n\x15weight_column_spec_id\x18\x03 \x01(\t\x12\x1d\n\x15ml_use_column_spec_id\x18\x04 \x01(\t\x12t\n\x1atarget_column_correlations\x18\x06 \x03(\x0b\x32P.google.cloud.automl.v1beta1.TablesDatasetMetadata.TargetColumnCorrelationsEntry\x12\x35\n\x11stats_update_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1an\n\x1dTargetColumnCorrelationsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12<\n\x05value\x18\x02 \x01(\x0b\x32-.google.cloud.automl.v1beta1.CorrelationStats:\x02\x38\x01"\x89\x03\n\x13TablesModelMetadata\x12\x43\n\x12target_column_spec\x18\x02 \x01(\x0b\x32\'.google.cloud.automl.v1beta1.ColumnSpec\x12K\n\x1ainput_feature_column_specs\x18\x03 \x03(\x0b\x32\'.google.cloud.automl.v1beta1.ColumnSpec\x12\x1e\n\x16optimization_objective\x18\x04 \x01(\t\x12T\n\x18tables_model_column_info\x18\x05 \x03(\x0b\x32\x32.google.cloud.automl.v1beta1.TablesModelColumnInfo\x12%\n\x1dtrain_budget_milli_node_hours\x18\x06 \x01(\x03\x12#\n\x1btrain_cost_milli_node_hours\x18\x07 \x01(\x03\x12\x1e\n\x16\x64isable_early_stopping\x18\x0c \x01(\x08"\xe5\x01\n\x10TablesAnnotation\x12\r\n\x05score\x18\x01 \x01(\x02\x12\x45\n\x13prediction_interval\x18\x04 \x01(\x0b\x32(.google.cloud.automl.v1beta1.DoubleRange\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value\x12T\n\x18tables_model_column_info\x18\x03 \x03(\x0b\x32\x32.google.cloud.automl.v1beta1.TablesModelColumnInfo"j\n\x15TablesModelColumnInfo\x12\x18\n\x10\x63olumn_spec_name\x18\x01 \x01(\t\x12\x1b\n\x13\x63olumn_display_name\x18\x02 \x01(\t\x12\x1a\n\x12\x66\x65\x61ture_importance\x18\x03 \x01(\x02\x42\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_ranges__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_temporal__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY = _descriptor.Descriptor(
+    name="TargetColumnCorrelationsEntry",
+    full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.TargetColumnCorrelationsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.TargetColumnCorrelationsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.TargetColumnCorrelationsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=806,
+    serialized_end=916,
+)
+
+_TABLESDATASETMETADATA = _descriptor.Descriptor(
+    name="TablesDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="primary_table_spec_id",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.primary_table_spec_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_column_spec_id",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.target_column_spec_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="weight_column_spec_id",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.weight_column_spec_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ml_use_column_spec_id",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.ml_use_column_spec_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_column_correlations",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.target_column_correlations",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stats_update_time",
+            full_name="google.cloud.automl.v1beta1.TablesDatasetMetadata.stats_update_time",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=484,
+    serialized_end=916,
+)
+
+
+_TABLESMODELMETADATA = _descriptor.Descriptor(
+    name="TablesModelMetadata",
+    full_name="google.cloud.automl.v1beta1.TablesModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_column_spec",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_feature_column_specs",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="optimization_objective",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.optimization_objective",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tables_model_column_info",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.tables_model_column_info",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="train_budget_milli_node_hours",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.train_budget_milli_node_hours",
+            index=4,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="train_cost_milli_node_hours",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.train_cost_milli_node_hours",
+            index=5,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disable_early_stopping",
+            full_name="google.cloud.automl.v1beta1.TablesModelMetadata.disable_early_stopping",
+            index=6,
+            number=12,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=919,
+    serialized_end=1312,
+)
+
+
+_TABLESANNOTATION = _descriptor.Descriptor(
+    name="TablesAnnotation",
+    full_name="google.cloud.automl.v1beta1.TablesAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.automl.v1beta1.TablesAnnotation.score",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="prediction_interval",
+            full_name="google.cloud.automl.v1beta1.TablesAnnotation.prediction_interval",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.automl.v1beta1.TablesAnnotation.value",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tables_model_column_info",
+            full_name="google.cloud.automl.v1beta1.TablesAnnotation.tables_model_column_info",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1315,
+    serialized_end=1544,
+)
+
+
+_TABLESMODELCOLUMNINFO = _descriptor.Descriptor(
+    name="TablesModelColumnInfo",
+    full_name="google.cloud.automl.v1beta1.TablesModelColumnInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="column_spec_name",
+            full_name="google.cloud.automl.v1beta1.TablesModelColumnInfo.column_spec_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_display_name",
+            full_name="google.cloud.automl.v1beta1.TablesModelColumnInfo.column_display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature_importance",
+            full_name="google.cloud.automl.v1beta1.TablesModelColumnInfo.feature_importance",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1546,
+    serialized_end=1652,
+)
+
+_TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__stats__pb2._CORRELATIONSTATS
+)
+_TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY.containing_type = (
+    _TABLESDATASETMETADATA
+)
+_TABLESDATASETMETADATA.fields_by_name[
+    "target_column_correlations"
+].message_type = _TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY
+_TABLESDATASETMETADATA.fields_by_name[
+    "stats_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TABLESMODELMETADATA.fields_by_name[
+    "target_column_spec"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2._COLUMNSPEC
+)
+_TABLESMODELMETADATA.fields_by_name[
+    "input_feature_column_specs"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_column__spec__pb2._COLUMNSPEC
+)
+_TABLESMODELMETADATA.fields_by_name[
+    "tables_model_column_info"
+].message_type = _TABLESMODELCOLUMNINFO
+_TABLESANNOTATION.fields_by_name[
+    "prediction_interval"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_ranges__pb2._DOUBLERANGE
+)
+_TABLESANNOTATION.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_TABLESANNOTATION.fields_by_name[
+    "tables_model_column_info"
+].message_type = _TABLESMODELCOLUMNINFO
+DESCRIPTOR.message_types_by_name["TablesDatasetMetadata"] = _TABLESDATASETMETADATA
+DESCRIPTOR.message_types_by_name["TablesModelMetadata"] = _TABLESMODELMETADATA
+DESCRIPTOR.message_types_by_name["TablesAnnotation"] = _TABLESANNOTATION
+DESCRIPTOR.message_types_by_name["TablesModelColumnInfo"] = _TABLESMODELCOLUMNINFO
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TablesDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "TablesDatasetMetadata",
+    (_message.Message,),
+    dict(
+        TargetColumnCorrelationsEntry=_reflection.GeneratedProtocolMessageType(
+            "TargetColumnCorrelationsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.tables_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TablesDatasetMetadata.TargetColumnCorrelationsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TABLESDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.tables_pb2",
+        __doc__="""Metadata for a dataset used for AutoML Tables.
+  
+  
+  Attributes:
+      primary_table_spec_id:
+          Output only. The table\_spec\_id of the primary table of this
+          dataset.
+      target_column_spec_id:
+          column\_spec\_id of the primary table's column that should be
+          used as the training & prediction target. This column must be
+          non-nullable and have one of following data types (otherwise
+          model creation will error):  -  CATEGORY  -  FLOAT64  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 concurrently working with the
+          dataset.
+      weight_column_spec_id:
+          column\_spec\_id of the primary table's column that should be
+          used as the weight column, i.e. the higher the value the more
+          important the row will be during model training. Required
+          type: FLOAT64. Allowed values: 0 to 10000, inclusive on both
+          ends; 0 means the row is ignored for training. If not set all
+          rows are assumed to have equal weight of 1. NOTE: Updates of
+          this field will instantly affect any other users concurrently
+          working with the dataset.
+      ml_use_column_spec_id:
+          column\_spec\_id of the primary table column which specifies a
+          possible ML use of the row, i.e. the column will be used to
+          split the rows into TRAIN, VALIDATE and TEST sets. Required
+          type: STRING. This column, if set, must either have all of
+          ``TRAIN``, ``VALIDATE``, ``TEST`` among its values, or only
+          have ``TEST``, ``UNASSIGNED`` values. In the latter case the
+          rows with ``UNASSIGNED`` value will be assigned by AutoML.
+          Note that if a given ml use distribution makes it impossible
+          to create a "good" model, that call will error describing the
+          issue. If both this column\_spec\_id and primary table's
+          time\_column\_spec\_id are not set, then all rows are treated
+          as ``UNASSIGNED``. NOTE: Updates of this field will instantly
+          affect any other users concurrently working with the dataset.
+      target_column_correlations:
+          Output only. Correlations between  [TablesDatasetMetadata.targ
+          et\_column\_spec\_id][google.cloud.automl.v1beta1.TablesDatase
+          tMetadata.target\_column\_spec\_id], and other columns of the
+          [TablesDatasetMetadataprimary\_table][google.cloud.automl.v1be
+          ta1.TablesDatasetMetadata.primary\_table\_spec\_id]. Only set
+          if the target column is set. Mapping from other column spec id
+          to its CorrelationStats with the target column. This field may
+          be stale, see the stats\_update\_time field for for the
+          timestamp at which these stats were last updated.
+      stats_update_time:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TablesDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TablesDatasetMetadata)
+_sym_db.RegisterMessage(TablesDatasetMetadata.TargetColumnCorrelationsEntry)
+
+TablesModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "TablesModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLESMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.tables_pb2",
+        __doc__="""Model metadata specific to AutoML Tables.
+  
+  
+  Attributes:
+      target_column_spec:
+          Column spec of the dataset's primary table's column the model
+          is predicting. Snapshotted when model creation started. Only 3
+          fields are used: name - May be set on CreateModel, if it's not
+          then the ColumnSpec corresponding to the current
+          target\_column\_spec\_id of the dataset the model is trained
+          from is used. If neither is set, CreateModel will error.
+          display\_name - Output only. data\_type - Output only.
+      input_feature_column_specs:
+          Column specs of the dataset's primary table's columns, on
+          which the model is trained and which are used as the input for
+          predictions. The  [target\_column][google.cloud.automl.v1beta1
+          .TablesModelMetadata.target\_column\_spec] as well as,
+          according to dataset's state upon model creation,  [weight\_co
+          lumn][google.cloud.automl.v1beta1.TablesDatasetMetadata.weight
+          \_column\_spec\_id], and  [ml\_use\_column][google.cloud.autom
+          l.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.
+      optimization_objective:
+          Objective function the model is optimizing towards. The
+          training process creates a model that maximizes/minimizes the
+          value of the objective function over the validation set.  The
+          supported optimization objectives depend on the prediction
+          type. If the field is not set, a default objective function is
+          used.  CLASSIFICATION\_BINARY: "MAXIMIZE\_AU\_ROC" (default) -
+          Maximize the area under the receiver operating characteristic
+          (ROC) curve. "MINIMIZE\_LOG\_LOSS" - Minimize log loss.
+          "MAXIMIZE\_AU\_PRC" - Maximize the area under the precision-
+          recall curve. "MAXIMIZE\_PRECISION\_AT\_RECALL" - Maximize
+          precision for a specified recall value.
+          "MAXIMIZE\_RECALL\_AT\_PRECISION" - Maximize recall for a
+          specified precision value.  CLASSIFICATION\_MULTI\_CLASS :
+          "MINIMIZE\_LOG\_LOSS" (default) - Minimize log loss.
+          REGRESSION: "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).
+      tables_model_column_info:
+          Output only. Auxiliary information for each of the
+          input\_feature\_column\_specs with respect to this particular
+          model.
+      train_budget_milli_node_hours:
+          Required. 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 training cost of the model will not exceed
+          this budget. The final cost will be attempted to be close to
+          the budget, though may end up being (even) noticeably smaller
+          - at the backend's discretion. This especially may happen when
+          further model training ceases to provide any improvements.  If
+          the budget is set to a value known to be insufficient to train
+          a model for the given dataset, the training won't be attempted
+          and will error.  The train budget must be between 1,000 and
+          72,000 milli node hours, inclusive.
+      train_cost_milli_node_hours:
+          Output only. The actual training cost of the 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.
+      disable_early_stopping:
+          Use the entire training budget. This disables the early
+          stopping feature. By default, the early stopping feature is
+          enabled, which means that AutoML Tables might stop training
+          before the entire training budget has been used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TablesModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TablesModelMetadata)
+
+TablesAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TablesAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLESANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.tables_pb2",
+        __doc__="""Contains annotation details specific to Tables.
+  
+  
+  Attributes:
+      score:
+          Output only. A confidence estimate between 0.0 and 1.0,
+          inclusive. A higher value means greater confidence in the
+          returned value. For  [target\_column\_spec][google.cloud.autom
+          l.v1beta1.TablesModelMetadata.target\_column\_spec] of FLOAT64
+          data type the score is not populated.
+      prediction_interval:
+          Output only. Only populated when  [target\_column\_spec][googl
+          e.cloud.automl.v1beta1.TablesModelMetadata.target\_column\_spe
+          c] has FLOAT64 data type. An interval in which the exactly
+          correct target value has 95% chance to be in.
+      value:
+          The predicted value of the row's  [target\_column][google.clou
+          d.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.
+      tables_model_column_info:
+          Output only. Auxiliary information for each of the model's  [i
+          nput\_feature\_column\_specs][google.cloud.automl.v1beta1.Tabl
+          esModelMetadata.input\_feature\_column\_specs] with respect to
+          this particular prediction. If no other fields than  [column\_
+          spec\_name][google.cloud.automl.v1beta1.TablesModelColumnInfo.
+          column\_spec\_name] and  [column\_display\_name][google.cloud.
+          automl.v1beta1.TablesModelColumnInfo.column\_display\_name]
+          would be populated, then this whole field is not.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TablesAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TablesAnnotation)
+
+TablesModelColumnInfo = _reflection.GeneratedProtocolMessageType(
+    "TablesModelColumnInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLESMODELCOLUMNINFO,
+        __module__="google.cloud.automl_v1beta1.proto.tables_pb2",
+        __doc__="""An information specific to given column and Tables Model, in context of
+  the Model and the predictions created by it.
+  
+  
+  Attributes:
+      column_spec_name:
+          Output only. The name of the ColumnSpec describing the column.
+          Not populated when this proto is outputted to BigQuery.
+      column_display_name:
+          Output only. The display name of the column (same as the
+          display\_name of its ColumnSpec).
+      feature_importance:
+          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 columns of a given model
+          they add to 1.  When given back by Predict (populated iff
+          [feature\_importance
+          param][google.cloud.automl.v1beta1.PredictRequest.params] is
+          set) or Batch Predict (populated iff [feature\_importance][goo
+          gle.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TablesModelColumnInfo)
+    ),
+)
+_sym_db.RegisterMessage(TablesModelColumnInfo)
+
+
+DESCRIPTOR._options = None
+_TABLESDATASETMETADATA_TARGETCOLUMNCORRELATIONSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/tables_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/tables_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/tables_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/temporal.proto b/automl/google/cloud/automl_v1beta1/proto/temporal.proto
new file mode 100644
index 000000000000..84874d99fa06
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/temporal.proto
@@ -0,0 +1,38 @@
+// 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.automl.v1beta1;
+
+import "google/protobuf/duration.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// A time period inside of an example that has a time dimension (e.g. video).
+message TimeSegment {
+  // Start of the time segment (inclusive), represented as the duration since
+  // the example start.
+  google.protobuf.Duration start_time_offset = 1;
+
+  // End of the time segment (exclusive), represented as the duration since the
+  // example start.
+  google.protobuf.Duration end_time_offset = 2;
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/temporal_pb2.py b/automl/google/cloud/automl_v1beta1/proto/temporal_pb2.py
new file mode 100644
index 000000000000..99fa8d6635ae
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/temporal_pb2.py
@@ -0,0 +1,129 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/temporal.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/temporal.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/automl_v1beta1/proto/temporal.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/api/annotations.proto"w\n\x0bTimeSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.DurationB\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TIMESEGMENT = _descriptor.Descriptor(
+    name="TimeSegment",
+    full_name="google.cloud.automl.v1beta1.TimeSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.automl.v1beta1.TimeSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.automl.v1beta1.TimeSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=143,
+    serialized_end=262,
+)
+
+_TIMESEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TIMESEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["TimeSegment"] = _TIMESEGMENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TimeSegment = _reflection.GeneratedProtocolMessageType(
+    "TimeSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMESEGMENT,
+        __module__="google.cloud.automl_v1beta1.proto.temporal_pb2",
+        __doc__="""A time period inside of an example that has a time dimension (e.g.
+  video).
+  
+  
+  Attributes:
+      start_time_offset:
+          Start of the time segment (inclusive), represented as the
+          duration since the example start.
+      end_time_offset:
+          End of the time segment (exclusive), represented as the
+          duration since the example start.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TimeSegment)
+    ),
+)
+_sym_db.RegisterMessage(TimeSegment)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/temporal_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/temporal_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/temporal_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/text.proto b/automl/google/cloud/automl_v1beta1/proto/text.proto
new file mode 100644
index 000000000000..6a01b7cff60f
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text.proto
@@ -0,0 +1,65 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/classification.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "TextProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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 {
+
+}
+
+// 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/automl/google/cloud/automl_v1beta1/proto/text_extraction.proto b/automl/google/cloud/automl_v1beta1/proto/text_extraction.proto
new file mode 100644
index 000000000000..07f0dda8169f
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_extraction.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.cloud.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/text_segment.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2.py b/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2.py
new file mode 100644
index 000000000000..04dc759c3f02
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2.py
@@ -0,0 +1,351 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/text_extraction.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    text_segment_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__segment__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/text_extraction.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1P\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/automl_v1beta1/proto/text_extraction.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x34google/cloud/automl_v1beta1/proto/text_segment.proto\x1a\x1cgoogle/api/annotations.proto"y\n\x18TextExtractionAnnotation\x12@\n\x0ctext_segment\x18\x03 \x01(\x0b\x32(.google.cloud.automl.v1beta1.TextSegmentH\x00\x12\r\n\x05score\x18\x01 \x01(\x02\x42\x0c\n\nannotation"\x97\x02\n\x1fTextExtractionEvaluationMetrics\x12\x0e\n\x06\x61u_prc\x18\x01 \x01(\x02\x12w\n\x1a\x63onfidence_metrics_entries\x18\x02 \x03(\x0b\x32S.google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry\x1ak\n\x16\x43onfidenceMetricsEntry\x12\x1c\n\x14\x63onfidence_threshold\x18\x01 \x01(\x02\x12\x0e\n\x06recall\x18\x03 \x01(\x02\x12\x11\n\tprecision\x18\x04 \x01(\x02\x12\x10\n\x08\x66\x31_score\x18\x05 \x01(\x02\x42\xa5\x01\n\x1f\x63om.google.cloud.automl.v1beta1P\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__segment__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTEXTRACTIONANNOTATION = _descriptor.Descriptor(
+    name="TextExtractionAnnotation",
+    full_name="google.cloud.automl.v1beta1.TextExtractionAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text_segment",
+            full_name="google.cloud.automl.v1beta1.TextExtractionAnnotation.text_segment",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.automl.v1beta1.TextExtractionAnnotation.score",
+            index=1,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="annotation",
+            full_name="google.cloud.automl.v1beta1.TextExtractionAnnotation.annotation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=172,
+    serialized_end=293,
+)
+
+
+_TEXTEXTRACTIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY = _descriptor.Descriptor(
+    name="ConfidenceMetricsEntry",
+    full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="confidence_threshold",
+            full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry.confidence_threshold",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry.recall",
+            index=1,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry.precision",
+            index=2,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry.f1_score",
+            index=3,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=468,
+    serialized_end=575,
+)
+
+_TEXTEXTRACTIONEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="TextExtractionEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="au_prc",
+            full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.au_prc",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence_metrics_entries",
+            full_name="google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.confidence_metrics_entries",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TEXTEXTRACTIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=296,
+    serialized_end=575,
+)
+
+_TEXTEXTRACTIONANNOTATION.fields_by_name[
+    "text_segment"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_text__segment__pb2._TEXTSEGMENT
+)
+_TEXTEXTRACTIONANNOTATION.oneofs_by_name["annotation"].fields.append(
+    _TEXTEXTRACTIONANNOTATION.fields_by_name["text_segment"]
+)
+_TEXTEXTRACTIONANNOTATION.fields_by_name[
+    "text_segment"
+].containing_oneof = _TEXTEXTRACTIONANNOTATION.oneofs_by_name["annotation"]
+_TEXTEXTRACTIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY.containing_type = (
+    _TEXTEXTRACTIONEVALUATIONMETRICS
+)
+_TEXTEXTRACTIONEVALUATIONMETRICS.fields_by_name[
+    "confidence_metrics_entries"
+].message_type = _TEXTEXTRACTIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY
+DESCRIPTOR.message_types_by_name["TextExtractionAnnotation"] = _TEXTEXTRACTIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "TextExtractionEvaluationMetrics"
+] = _TEXTEXTRACTIONEVALUATIONMETRICS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextExtractionAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextExtractionAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTEXTRACTIONANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.text_extraction_pb2",
+        __doc__="""Annotation for identifying spans of text.
+  
+  
+  Attributes:
+      annotation:
+          Required. Text extraction annotations can either be a text
+          segment or a text relation.
+      text_segment:
+          An entity annotation will set this, which is the part of the
+          original text to which the annotation pertains.
+      score:
+          Output only. A confidence estimate between 0.0 and 1.0. A
+          higher value means greater confidence in correctness of the
+          annotation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextExtractionAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextExtractionAnnotation)
+
+TextExtractionEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "TextExtractionEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        ConfidenceMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "ConfidenceMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTEXTRACTIONEVALUATIONMETRICS_CONFIDENCEMETRICSENTRY,
+                __module__="google.cloud.automl_v1beta1.proto.text_extraction_pb2",
+                __doc__="""Metrics for a single confidence threshold.
+    
+    
+    Attributes:
+        confidence_threshold:
+            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.
+        recall:
+            Output only. Recall under the given confidence threshold.
+        precision:
+            Output only. Precision under the given confidence threshold.
+        f1_score:
+            Output only. The harmonic mean of recall and precision.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics.ConfidenceMetricsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TEXTEXTRACTIONEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.text_extraction_pb2",
+        __doc__="""Model evaluation metrics for text extraction problems.
+  
+  
+  Attributes:
+      au_prc:
+          Output only. The Area under precision recall curve metric.
+      confidence_metrics_entries:
+          Output only. Metrics that have confidence thresholds.
+          Precision-recall curve can be derived from it.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextExtractionEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(TextExtractionEvaluationMetrics)
+_sym_db.RegisterMessage(TextExtractionEvaluationMetrics.ConfidenceMetricsEntry)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_extraction_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_pb2.py b/automl/google/cloud/automl_v1beta1/proto/text_pb2.py
new file mode 100644
index 000000000000..df8a45c5fa72
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_pb2.py
@@ -0,0 +1,319 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/text.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/text.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\tTextProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/automl_v1beta1/proto/text.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x1cgoogle/api/annotations.proto"q\n!TextClassificationDatasetMetadata\x12L\n\x13\x63lassification_type\x18\x01 \x01(\x0e\x32/.google.cloud.automl.v1beta1.ClassificationType"!\n\x1fTextClassificationModelMetadata"\x1f\n\x1dTextExtractionDatasetMetadata"\x1d\n\x1bTextExtractionModelMetadata"5\n\x1cTextSentimentDatasetMetadata\x12\x15\n\rsentiment_max\x18\x01 \x01(\x05"\x1c\n\x1aTextSentimentModelMetadataB\xb0\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\tTextProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTCLASSIFICATIONDATASETMETADATA = _descriptor.Descriptor(
+    name="TextClassificationDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.TextClassificationDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="classification_type",
+            full_name="google.cloud.automl.v1beta1.TextClassificationDatasetMetadata.classification_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=163,
+    serialized_end=276,
+)
+
+
+_TEXTCLASSIFICATIONMODELMETADATA = _descriptor.Descriptor(
+    name="TextClassificationModelMetadata",
+    full_name="google.cloud.automl.v1beta1.TextClassificationModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=278,
+    serialized_end=311,
+)
+
+
+_TEXTEXTRACTIONDATASETMETADATA = _descriptor.Descriptor(
+    name="TextExtractionDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.TextExtractionDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=313,
+    serialized_end=344,
+)
+
+
+_TEXTEXTRACTIONMODELMETADATA = _descriptor.Descriptor(
+    name="TextExtractionModelMetadata",
+    full_name="google.cloud.automl.v1beta1.TextExtractionModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=346,
+    serialized_end=375,
+)
+
+
+_TEXTSENTIMENTDATASETMETADATA = _descriptor.Descriptor(
+    name="TextSentimentDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.TextSentimentDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sentiment_max",
+            full_name="google.cloud.automl.v1beta1.TextSentimentDatasetMetadata.sentiment_max",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=377,
+    serialized_end=430,
+)
+
+
+_TEXTSENTIMENTMODELMETADATA = _descriptor.Descriptor(
+    name="TextSentimentModelMetadata",
+    full_name="google.cloud.automl.v1beta1.TextSentimentModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=432,
+    serialized_end=460,
+)
+
+_TEXTCLASSIFICATIONDATASETMETADATA.fields_by_name[
+    "classification_type"
+].enum_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2._CLASSIFICATIONTYPE
+)
+DESCRIPTOR.message_types_by_name[
+    "TextClassificationDatasetMetadata"
+] = _TEXTCLASSIFICATIONDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "TextClassificationModelMetadata"
+] = _TEXTCLASSIFICATIONMODELMETADATA
+DESCRIPTOR.message_types_by_name[
+    "TextExtractionDatasetMetadata"
+] = _TEXTEXTRACTIONDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "TextExtractionModelMetadata"
+] = _TEXTEXTRACTIONMODELMETADATA
+DESCRIPTOR.message_types_by_name[
+    "TextSentimentDatasetMetadata"
+] = _TEXTSENTIMENTDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "TextSentimentModelMetadata"
+] = _TEXTSENTIMENTMODELMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextClassificationDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextClassificationDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTCLASSIFICATIONDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.text_pb2",
+        __doc__="""Dataset metadata for classification.
+  
+  
+  Attributes:
+      classification_type:
+          Required. Type of the classification problem.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextClassificationDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextClassificationDatasetMetadata)
+
+TextClassificationModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextClassificationModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTCLASSIFICATIONMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.text_pb2",
+        __doc__="""Model metadata that is specific to text classification.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextClassificationModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextClassificationModelMetadata)
+
+TextExtractionDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextExtractionDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTEXTRACTIONDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.text_pb2",
+        __doc__="""Dataset metadata that is specific to text extraction
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextExtractionDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextExtractionDatasetMetadata)
+
+TextExtractionModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextExtractionModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTEXTRACTIONMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.text_pb2",
+        __doc__="""Model metadata that is specific to text extraction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextExtractionModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextExtractionModelMetadata)
+
+TextSentimentDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextSentimentDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSENTIMENTDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.text_pb2",
+        __doc__="""Dataset metadata for text sentiment.
+  
+  
+  Attributes:
+      sentiment_max:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextSentimentDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextSentimentDatasetMetadata)
+
+TextSentimentModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextSentimentModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSENTIMENTMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.text_pb2",
+        __doc__="""Model metadata that is specific to text sentiment.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextSentimentModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextSentimentModelMetadata)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/text_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_segment.proto b/automl/google/cloud/automl_v1beta1/proto/text_segment.proto
new file mode 100644
index 000000000000..41b8be1cca00
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_segment.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.automl.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "TextSegmentProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2.py b/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2.py
new file mode 100644
index 000000000000..79774587f8c1
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/text_segment.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/text_segment.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\020TextSegmentProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/automl_v1beta1/proto/text_segment.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x1cgoogle/api/annotations.proto"H\n\x0bTextSegment\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\t\x12\x14\n\x0cstart_offset\x18\x01 \x01(\x03\x12\x12\n\nend_offset\x18\x02 \x01(\x03\x42\xb7\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x10TextSegmentProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_TEXTSEGMENT = _descriptor.Descriptor(
+    name="TextSegment",
+    full_name="google.cloud.automl.v1beta1.TextSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.automl.v1beta1.TextSegment.content",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_offset",
+            full_name="google.cloud.automl.v1beta1.TextSegment.start_offset",
+            index=1,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_offset",
+            full_name="google.cloud.automl.v1beta1.TextSegment.end_offset",
+            index=2,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=115,
+    serialized_end=187,
+)
+
+DESCRIPTOR.message_types_by_name["TextSegment"] = _TEXTSEGMENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextSegment = _reflection.GeneratedProtocolMessageType(
+    "TextSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSEGMENT,
+        __module__="google.cloud.automl_v1beta1.proto.text_segment_pb2",
+        __doc__="""A contiguous part of a text (string), assuming it has an UTF-8 NFC
+  encoding.
+  
+  
+  Attributes:
+      content:
+          Output only. The content of the TextSegment.
+      start_offset:
+          Required. Zero-based character index of the first character of
+          the text segment (counting characters from the beginning of
+          the text).
+      end_offset:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextSegment)
+    ),
+)
+_sym_db.RegisterMessage(TextSegment)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_segment_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_sentiment.proto b/automl/google/cloud/automl_v1beta1/proto/text_sentiment.proto
new file mode 100644
index 000000000000..978acb0f97c6
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_sentiment.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.cloud.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/classification.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_outer_classname = "TextSentimentProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// 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.v1beta1.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;
+
+  // Output only. The annotation spec ids used for this evaluation.
+  // Deprecated .
+  repeated string annotation_spec_id = 9 [deprecated = true];
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2.py b/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2.py
new file mode 100644
index 000000000000..c55c9979bb83
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2.py
@@ -0,0 +1,353 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/text_sentiment.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/text_sentiment.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\022TextSentimentProtoZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/automl_v1beta1/proto/text_sentiment.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x1cgoogle/api/annotations.proto",\n\x17TextSentimentAnnotation\x12\x11\n\tsentiment\x18\x01 \x01(\x05"\xc5\x02\n\x1eTextSentimentEvaluationMetrics\x12\x11\n\tprecision\x18\x01 \x01(\x02\x12\x0e\n\x06recall\x18\x02 \x01(\x02\x12\x10\n\x08\x66\x31_score\x18\x03 \x01(\x02\x12\x1b\n\x13mean_absolute_error\x18\x04 \x01(\x02\x12\x1a\n\x12mean_squared_error\x18\x05 \x01(\x02\x12\x14\n\x0clinear_kappa\x18\x06 \x01(\x02\x12\x17\n\x0fquadratic_kappa\x18\x07 \x01(\x02\x12\x66\n\x10\x63onfusion_matrix\x18\x08 \x01(\x0b\x32L.google.cloud.automl.v1beta1.ClassificationEvaluationMetrics.ConfusionMatrix\x12\x1e\n\x12\x61nnotation_spec_id\x18\t \x03(\tB\x02\x18\x01\x42\xb7\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x12TextSentimentProtoZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTSENTIMENTANNOTATION = _descriptor.Descriptor(
+    name="TextSentimentAnnotation",
+    full_name="google.cloud.automl.v1beta1.TextSentimentAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.automl.v1beta1.TextSentimentAnnotation.sentiment",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=173,
+    serialized_end=217,
+)
+
+
+_TEXTSENTIMENTEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="TextSentimentEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.precision",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.recall",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.f1_score",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_absolute_error",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.mean_absolute_error",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_squared_error",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.mean_squared_error",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="linear_kappa",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.linear_kappa",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quadratic_kappa",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.quadratic_kappa",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confusion_matrix",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.confusion_matrix",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_id",
+            full_name="google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics.annotation_spec_id",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=220,
+    serialized_end=545,
+)
+
+_TEXTSENTIMENTEVALUATIONMETRICS.fields_by_name[
+    "confusion_matrix"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2._CLASSIFICATIONEVALUATIONMETRICS_CONFUSIONMATRIX
+)
+DESCRIPTOR.message_types_by_name["TextSentimentAnnotation"] = _TEXTSENTIMENTANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "TextSentimentEvaluationMetrics"
+] = _TEXTSENTIMENTEVALUATIONMETRICS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextSentimentAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextSentimentAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSENTIMENTANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.text_sentiment_pb2",
+        __doc__="""Contains annotation details specific to text sentiment.
+  
+  
+  Attributes:
+      sentiment:
+          Output only. The sentiment with the semantic, as given to the 
+          [AutoMl.ImportData][google.cloud.automl.v1beta1.AutoMl.ImportD
+          ata] 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextSentimentAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextSentimentAnnotation)
+
+TextSentimentEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "TextSentimentEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSENTIMENTEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.text_sentiment_pb2",
+        __doc__="""Model evaluation metrics for text sentiment problems.
+  
+  
+  Attributes:
+      precision:
+          Output only. Precision.
+      recall:
+          Output only. Recall.
+      f1_score:
+          Output only. The harmonic mean of recall and precision.
+      mean_absolute_error:
+          Output only. Mean absolute error. Only set for the overall
+          model evaluation, not for evaluation of a single annotation
+          spec.
+      mean_squared_error:
+          Output only. Mean squared error. Only set for the overall
+          model evaluation, not for evaluation of a single annotation
+          spec.
+      linear_kappa:
+          Output only. Linear weighted kappa. Only set for the overall
+          model evaluation, not for evaluation of a single annotation
+          spec.
+      quadratic_kappa:
+          Output only. Quadratic weighted kappa. Only set for the
+          overall model evaluation, not for evaluation of a single
+          annotation spec.
+      confusion_matrix:
+          Output only. Confusion matrix of the evaluation. Only set for
+          the overall model evaluation, not for evaluation of a single
+          annotation spec.
+      annotation_spec_id:
+          Output only. The annotation spec ids used for this evaluation.
+          Deprecated .
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TextSentimentEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(TextSentimentEvaluationMetrics)
+
+
+DESCRIPTOR._options = None
+_TEXTSENTIMENTEVALUATIONMETRICS.fields_by_name["annotation_spec_id"]._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/text_sentiment_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/translation.proto b/automl/google/cloud/automl_v1beta1/proto/translation.proto
new file mode 100644
index 000000000000..ed02b2af5fd6
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/translation.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.cloud.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/data_items.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "TranslationProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+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;
+
+  // Required. The BCP-47 language code of the target language.
+  string target_language_code = 2;
+}
+
+// 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 languge (The BCP-47 language code) that is used for training.
+  string source_language_code = 2;
+
+  // Output only. The target languge (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/automl/google/cloud/automl_v1beta1/proto/translation_pb2.py b/automl/google/cloud/automl_v1beta1/proto/translation_pb2.py
new file mode 100644
index 000000000000..15a081761c0f
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/translation_pb2.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/translation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    data_items_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/translation.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\020TranslationProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/automl_v1beta1/proto/translation.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x32google/cloud/automl_v1beta1/proto/data_items.proto\x1a\x1cgoogle/api/annotations.proto"X\n\x1aTranslationDatasetMetadata\x12\x1c\n\x14source_language_code\x18\x01 \x01(\t\x12\x1c\n\x14target_language_code\x18\x02 \x01(\t"K\n\x1cTranslationEvaluationMetrics\x12\x12\n\nbleu_score\x18\x01 \x01(\x01\x12\x17\n\x0f\x62\x61se_bleu_score\x18\x02 \x01(\x01"j\n\x18TranslationModelMetadata\x12\x12\n\nbase_model\x18\x01 \x01(\t\x12\x1c\n\x14source_language_code\x18\x02 \x01(\t\x12\x1c\n\x14target_language_code\x18\x03 \x01(\t"]\n\x15TranslationAnnotation\x12\x44\n\x12translated_content\x18\x01 \x01(\x0b\x32(.google.cloud.automl.v1beta1.TextSnippetB\xb7\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\x10TranslationProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TRANSLATIONDATASETMETADATA = _descriptor.Descriptor(
+    name="TranslationDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.TranslationDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="source_language_code",
+            full_name="google.cloud.automl.v1beta1.TranslationDatasetMetadata.source_language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_language_code",
+            full_name="google.cloud.automl.v1beta1.TranslationDatasetMetadata.target_language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=166,
+    serialized_end=254,
+)
+
+
+_TRANSLATIONEVALUATIONMETRICS = _descriptor.Descriptor(
+    name="TranslationEvaluationMetrics",
+    full_name="google.cloud.automl.v1beta1.TranslationEvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bleu_score",
+            full_name="google.cloud.automl.v1beta1.TranslationEvaluationMetrics.bleu_score",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="base_bleu_score",
+            full_name="google.cloud.automl.v1beta1.TranslationEvaluationMetrics.base_bleu_score",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=256,
+    serialized_end=331,
+)
+
+
+_TRANSLATIONMODELMETADATA = _descriptor.Descriptor(
+    name="TranslationModelMetadata",
+    full_name="google.cloud.automl.v1beta1.TranslationModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="base_model",
+            full_name="google.cloud.automl.v1beta1.TranslationModelMetadata.base_model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_language_code",
+            full_name="google.cloud.automl.v1beta1.TranslationModelMetadata.source_language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_language_code",
+            full_name="google.cloud.automl.v1beta1.TranslationModelMetadata.target_language_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=333,
+    serialized_end=439,
+)
+
+
+_TRANSLATIONANNOTATION = _descriptor.Descriptor(
+    name="TranslationAnnotation",
+    full_name="google.cloud.automl.v1beta1.TranslationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="translated_content",
+            full_name="google.cloud.automl.v1beta1.TranslationAnnotation.translated_content",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=441,
+    serialized_end=534,
+)
+
+_TRANSLATIONANNOTATION.fields_by_name[
+    "translated_content"
+].message_type = (
+    google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_data__items__pb2._TEXTSNIPPET
+)
+DESCRIPTOR.message_types_by_name[
+    "TranslationDatasetMetadata"
+] = _TRANSLATIONDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "TranslationEvaluationMetrics"
+] = _TRANSLATIONEVALUATIONMETRICS
+DESCRIPTOR.message_types_by_name["TranslationModelMetadata"] = _TRANSLATIONMODELMETADATA
+DESCRIPTOR.message_types_by_name["TranslationAnnotation"] = _TRANSLATIONANNOTATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TranslationDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "TranslationDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATIONDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.translation_pb2",
+        __doc__="""Dataset metadata that is specific to translation.
+  
+  
+  Attributes:
+      source_language_code:
+          Required. The BCP-47 language code of the source language.
+      target_language_code:
+          Required. The BCP-47 language code of the target language.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TranslationDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TranslationDatasetMetadata)
+
+TranslationEvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "TranslationEvaluationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATIONEVALUATIONMETRICS,
+        __module__="google.cloud.automl_v1beta1.proto.translation_pb2",
+        __doc__="""Evaluation metrics for the dataset.
+  
+  
+  Attributes:
+      bleu_score:
+          Output only. BLEU score.
+      base_bleu_score:
+          Output only. BLEU score for base model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TranslationEvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(TranslationEvaluationMetrics)
+
+TranslationModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "TranslationModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATIONMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.translation_pb2",
+        __doc__="""Model metadata that is specific to translation.
+  
+  
+  Attributes:
+      base_model:
+          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}``
+      source_language_code:
+          Output only. Inferred from the dataset. The source languge
+          (The BCP-47 language code) that is used for training.
+      target_language_code:
+          Output only. The target languge (The BCP-47 language code)
+          that is used for training.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TranslationModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TranslationModelMetadata)
+
+TranslationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TranslationAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATIONANNOTATION,
+        __module__="google.cloud.automl_v1beta1.proto.translation_pb2",
+        __doc__="""Annotation details specific to translation.
+  
+  
+  Attributes:
+      translated_content:
+          Output only . The translated content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.TranslationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TranslationAnnotation)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/translation_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/translation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/translation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/proto/video.proto b/automl/google/cloud/automl_v1beta1/proto/video.proto
new file mode 100644
index 000000000000..b7c7325bc2f1
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/video.proto
@@ -0,0 +1,49 @@
+// 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.automl.v1beta1;
+
+import "google/cloud/automl/v1beta1/classification.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl";
+option java_multiple_files = true;
+option java_outer_classname = "VideoProto";
+option java_package = "com.google.cloud.automl.v1beta1";
+option php_namespace = "Google\\Cloud\\AutoMl\\V1beta1";
+option ruby_package = "Google::Cloud::AutoML::V1beta1";
+
+// Dataset metadata specific to video classification.
+// All Video Classification datasets are treated as multi label.
+message VideoClassificationDatasetMetadata {
+
+}
+
+// Dataset metadata specific to video object tracking.
+message VideoObjectTrackingDatasetMetadata {
+
+}
+
+// Model metadata specific to video classification.
+message VideoClassificationModelMetadata {
+
+}
+
+// Model metadata specific to video object tracking.
+message VideoObjectTrackingModelMetadata {
+
+}
diff --git a/automl/google/cloud/automl_v1beta1/proto/video_pb2.py b/automl/google/cloud/automl_v1beta1/proto/video_pb2.py
new file mode 100644
index 000000000000..156c58b3b364
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/video_pb2.py
@@ -0,0 +1,189 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/automl_v1beta1/proto/video.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.automl_v1beta1.proto import (
+    classification_pb2 as google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/automl_v1beta1/proto/video.proto",
+    package="google.cloud.automl.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.automl.v1beta1B\nVideoProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\312\002\033Google\\Cloud\\AutoMl\\V1beta1\352\002\036Google::Cloud::AutoML::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/automl_v1beta1/proto/video.proto\x12\x1bgoogle.cloud.automl.v1beta1\x1a\x36google/cloud/automl_v1beta1/proto/classification.proto\x1a\x1cgoogle/api/annotations.proto"$\n"VideoClassificationDatasetMetadata"$\n"VideoObjectTrackingDatasetMetadata""\n VideoClassificationModelMetadata""\n VideoObjectTrackingModelMetadataB\xb1\x01\n\x1f\x63om.google.cloud.automl.v1beta1B\nVideoProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl\xca\x02\x1bGoogle\\Cloud\\AutoMl\\V1beta1\xea\x02\x1eGoogle::Cloud::AutoML::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_automl__v1beta1_dot_proto_dot_classification__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_VIDEOCLASSIFICATIONDATASETMETADATA = _descriptor.Descriptor(
+    name="VideoClassificationDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.VideoClassificationDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=164,
+    serialized_end=200,
+)
+
+
+_VIDEOOBJECTTRACKINGDATASETMETADATA = _descriptor.Descriptor(
+    name="VideoObjectTrackingDatasetMetadata",
+    full_name="google.cloud.automl.v1beta1.VideoObjectTrackingDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=202,
+    serialized_end=238,
+)
+
+
+_VIDEOCLASSIFICATIONMODELMETADATA = _descriptor.Descriptor(
+    name="VideoClassificationModelMetadata",
+    full_name="google.cloud.automl.v1beta1.VideoClassificationModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=240,
+    serialized_end=274,
+)
+
+
+_VIDEOOBJECTTRACKINGMODELMETADATA = _descriptor.Descriptor(
+    name="VideoObjectTrackingModelMetadata",
+    full_name="google.cloud.automl.v1beta1.VideoObjectTrackingModelMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=276,
+    serialized_end=310,
+)
+
+DESCRIPTOR.message_types_by_name[
+    "VideoClassificationDatasetMetadata"
+] = _VIDEOCLASSIFICATIONDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "VideoObjectTrackingDatasetMetadata"
+] = _VIDEOOBJECTTRACKINGDATASETMETADATA
+DESCRIPTOR.message_types_by_name[
+    "VideoClassificationModelMetadata"
+] = _VIDEOCLASSIFICATIONMODELMETADATA
+DESCRIPTOR.message_types_by_name[
+    "VideoObjectTrackingModelMetadata"
+] = _VIDEOOBJECTTRACKINGMODELMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+VideoClassificationDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "VideoClassificationDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCLASSIFICATIONDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.video_pb2",
+        __doc__="""Dataset metadata specific to video classification. All Video
+  Classification datasets are treated as multi label.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoClassificationDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(VideoClassificationDatasetMetadata)
+
+VideoObjectTrackingDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "VideoObjectTrackingDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOOBJECTTRACKINGDATASETMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.video_pb2",
+        __doc__="""Dataset metadata specific to video object tracking.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoObjectTrackingDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(VideoObjectTrackingDatasetMetadata)
+
+VideoClassificationModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "VideoClassificationModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCLASSIFICATIONMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.video_pb2",
+        __doc__="""Model metadata specific to video classification.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoClassificationModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(VideoClassificationModelMetadata)
+
+VideoObjectTrackingModelMetadata = _reflection.GeneratedProtocolMessageType(
+    "VideoObjectTrackingModelMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOOBJECTTRACKINGMODELMETADATA,
+        __module__="google.cloud.automl_v1beta1.proto.video_pb2",
+        __doc__="""Model metadata specific to video object tracking.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.automl.v1beta1.VideoObjectTrackingModelMetadata)
+    ),
+)
+_sym_db.RegisterMessage(VideoObjectTrackingModelMetadata)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/automl/google/cloud/automl_v1beta1/proto/video_pb2_grpc.py b/automl/google/cloud/automl_v1beta1/proto/video_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/proto/video_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/automl/google/cloud/automl_v1beta1/tables/__init__.py b/automl/google/cloud/automl_v1beta1/tables/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/automl/google/cloud/automl_v1beta1/tables/gcs_client.py b/automl/google/cloud/automl_v1beta1/tables/gcs_client.py
new file mode 100644
index 000000000000..980fd40b1f90
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/tables/gcs_client.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wraps the Google Cloud Storage client library for use in tables helper."""
+
+import logging
+import time
+
+from google.api_core import exceptions
+
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+
+try:
+    from google.cloud import storage
+except ImportError:  # pragma: NO COVER
+    storage = None
+
+_LOGGER = logging.getLogger(__name__)
+_PANDAS_REQUIRED = "pandas is required to verify type DataFrame."
+_STORAGE_REQUIRED = (
+    "google-cloud-storage is required to create a Google Cloud Storage client."
+)
+
+
+class GcsClient(object):
+    """Uploads Pandas DataFrame to a bucket in Google Cloud Storage."""
+
+    def __init__(self, bucket_name=None, client=None, credentials=None):
+        """Constructor.
+
+        Args:
+            bucket_name (Optional[str]): The name of Google Cloud Storage
+                bucket for this client to send requests to.
+            client (Optional[storage.Client]): A Google Cloud Storage Client
+                instance.
+            credentials (Optional[google.auth.credentials.Credentials]): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+        """
+        if storage is None:
+            raise ImportError(_STORAGE_REQUIRED)
+
+        if client is not None:
+            self.client = client
+        elif credentials is not None:
+            self.client = storage.Client(credentials=credentials)
+        else:
+            self.client = storage.Client()
+
+        self.bucket_name = bucket_name
+
+    def ensure_bucket_exists(self, project, region):
+        """Checks if a bucket named '{project}-automl-tables-staging' exists.
+
+        If this bucket doesn't exist, creates one.
+        If this bucket already exists in `project`, do nothing.
+        If this bucket exists in a different project that we don't have
+        access to, creates a bucket named
+        '{project}-automl-tables-staging-{create_timestamp}' because bucket's
+        name must be globally unique.
+        Save the created bucket's name and reuse this for future requests.
+
+        Args:
+            project (str): The project that stores the bucket.
+            region (str): The region of the bucket.
+
+        Returns:
+            A string representing the created bucket name.
+        """
+        if self.bucket_name is None:
+            self.bucket_name = "{}-automl-tables-staging".format(project)
+
+        try:
+            self.client.get_bucket(self.bucket_name)
+        except (exceptions.Forbidden, exceptions.NotFound) as e:
+            if isinstance(e, exceptions.Forbidden):
+                used_bucket_name = self.bucket_name
+                self.bucket_name = used_bucket_name + "-{}".format(int(time.time()))
+                _LOGGER.warning(
+                    "Created a bucket named {} because a bucket named {} already exists in a different project.".format(
+                        self.bucket_name, used_bucket_name
+                    )
+                )
+
+            bucket = self.client.bucket(self.bucket_name)
+            bucket.create(project=project, location=region)
+
+        return self.bucket_name
+
+    def upload_pandas_dataframe(self, dataframe, uploaded_csv_name=None):
+        """Uploads a Pandas DataFrame as CSV to the bucket.
+
+        Args:
+            dataframe (pandas.DataFrame): The Pandas Dataframe to be uploaded.
+            uploaded_csv_name (Optional[str]): The name for the uploaded CSV.
+
+        Returns:
+            A string representing the GCS URI of the uploaded CSV.
+        """
+        if pandas is None:
+            raise ImportError(_PANDAS_REQUIRED)
+
+        if not isinstance(dataframe, pandas.DataFrame):
+            raise ValueError("'dataframe' must be a pandas.DataFrame instance.")
+
+        if self.bucket_name is None:
+            raise ValueError("Must ensure a bucket exists before uploading data.")
+
+        if uploaded_csv_name is None:
+            uploaded_csv_name = "automl-tables-dataframe-{}.csv".format(
+                int(time.time())
+            )
+        csv_string = dataframe.to_csv()
+
+        bucket = self.client.get_bucket(self.bucket_name)
+        blob = bucket.blob(uploaded_csv_name)
+        blob.upload_from_string(csv_string)
+
+        return "gs://{}/{}".format(self.bucket_name, uploaded_csv_name)
diff --git a/automl/google/cloud/automl_v1beta1/tables/tables_client.py b/automl/google/cloud/automl_v1beta1/tables/tables_client.py
new file mode 100644
index 000000000000..80e301fbd6bd
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/tables/tables_client.py
@@ -0,0 +1,2780 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A tables helper for the google.cloud.automl_v1beta1 AutoML API"""
+
+import pkg_resources
+import logging
+
+from google.api_core.gapic_v1 import client_info
+from google.api_core import exceptions
+from google.cloud.automl_v1beta1 import gapic
+from google.cloud.automl_v1beta1.proto import data_types_pb2
+from google.cloud.automl_v1beta1.tables import gcs_client
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-automl").version
+_LOGGER = logging.getLogger(__name__)
+
+
+class TablesClient(object):
+    """
+    AutoML Tables API helper.
+
+    This is intended to simplify usage of the auto-generated python client,
+    in particular for the `AutoML Tables product
+    <https://cloud.google.com/automl-tables/>`_.
+    """
+
+    def __init__(
+        self,
+        project=None,
+        region="us-central1",
+        client=None,
+        prediction_client=None,
+        gcs_client=None,
+        **kwargs
+    ):
+        """Constructor.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+
+        Args:
+            project (Optional[string]): The project all future calls will
+                default to. Most methods take `project` as an optional
+                parameter, and can override your choice of `project` supplied
+                here.
+            region (Optional[string]): The region all future calls will
+                default to. Most methods take `region` as an optional
+                parameter, and can override your choice of `region` supplied
+                here. Note, only `us-central1` is supported to-date.
+            transport (Union[~.AutoMlGrpcTransport, Callable[[~.Credentials, type], ~.AutoMlGrpcTransport]):
+                A transport instance, responsible for actually making the API
+                calls.  The default transport uses the gRPC protocol.  This
+                argument may also be a callable which returns a transport
+                instance. Callables will be sent the credentials as the first
+                argument and the default transport class as the second
+                argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        version = _GAPIC_LIBRARY_VERSION
+        user_agent = "automl-tables-wrapper/{}".format(version)
+
+        client_info_ = kwargs.get("client_info")
+        if client_info_ is None:
+            client_info_ = client_info.ClientInfo(
+                user_agent=user_agent, gapic_version=version
+            )
+        else:
+            client_info_.user_agent = user_agent
+            client_info_.gapic_version = version
+
+        if client is None:
+            self.auto_ml_client = gapic.auto_ml_client.AutoMlClient(
+                client_info=client_info_, **kwargs
+            )
+        else:
+            self.auto_ml_client = client
+
+        if prediction_client is None:
+            self.prediction_client = gapic.prediction_service_client.PredictionServiceClient(
+                client_info=client_info_, **kwargs
+            )
+        else:
+            self.prediction_client = prediction_client
+
+        self.project = project
+        self.region = region
+        self.gcs_client = gcs_client
+
+    def __lookup_by_display_name(self, object_type, items, display_name):
+        relevant_items = [i for i in items if i.display_name == display_name]
+        if len(relevant_items) == 0:
+            raise exceptions.NotFound(
+                "The {} with display_name='{}' was not found.".format(
+                    object_type, display_name
+                )
+            )
+        elif len(relevant_items) == 1:
+            return relevant_items[0]
+        else:
+            raise ValueError(
+                (
+                    "Multiple {}s match display_name='{}': {}\n\n"
+                    "Please use the `.name` (unique identifier) field instead"
+                ).format(
+                    object_type,
+                    display_name,
+                    ", ".join([str(i) for i in relevant_items]),
+                )
+            )
+
+    def __location_path(self, project=None, region=None):
+        if project is None:
+            if self.project is None:
+                raise ValueError(
+                    "Either initialize your client with a value "
+                    "for 'project', or provide 'project' as a "
+                    "parameter for this method."
+                )
+            project = self.project
+
+        if region is None:
+            if self.region is None:
+                raise ValueError(
+                    "Either initialize your client with a value "
+                    "for 'region', or provide 'region' as a "
+                    "parameter for this method."
+                )
+            region = self.region
+
+        return self.auto_ml_client.location_path(project, region)
+
+    # the returned metadata object doesn't allow for updating fields, so
+    # we need to manually copy user-updated fields over
+    def __update_metadata(self, metadata, k, v):
+        new_metadata = {}
+        new_metadata["ml_use_column_spec_id"] = metadata.ml_use_column_spec_id
+        new_metadata["weight_column_spec_id"] = metadata.weight_column_spec_id
+        new_metadata["target_column_spec_id"] = metadata.target_column_spec_id
+        new_metadata[k] = v
+
+        return new_metadata
+
+    def __dataset_from_args(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        if dataset is None and dataset_display_name is None and dataset_name is None:
+            raise ValueError(
+                "One of 'dataset', 'dataset_name' or "
+                "'dataset_display_name' must be set."
+            )
+        # we prefer to make a live call here in the case that the
+        # dataset object is out-of-date
+        if dataset is not None:
+            dataset_name = dataset.name
+
+        return self.get_dataset(
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+    def __model_from_args(
+        self,
+        model=None,
+        model_display_name=None,
+        model_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        if model is None and model_display_name is None and model_name is None:
+            raise ValueError(
+                "One of 'model', 'model_name' or " "'model_display_name' must be set."
+            )
+        # we prefer to make a live call here in the case that the
+        # model object is out-of-date
+        if model is not None:
+            model_name = model.name
+
+        return self.get_model(
+            model_display_name=model_display_name,
+            model_name=model_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+    def __dataset_name_from_args(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        if dataset is None and dataset_display_name is None and dataset_name is None:
+            raise ValueError(
+                "One of 'dataset', 'dataset_name' or "
+                "'dataset_display_name' must be set."
+            )
+
+        if dataset_name is None:
+            if dataset is None:
+                dataset = self.get_dataset(
+                    dataset_display_name=dataset_display_name,
+                    project=project,
+                    region=region,
+                    **kwargs
+                )
+
+            dataset_name = dataset.name
+        else:
+            # we do this to force a NotFound error when needed
+            self.get_dataset(
+                dataset_name=dataset_name, project=project, region=region, **kwargs
+            )
+        return dataset_name
+
+    def __table_spec_name_from_args(
+        self,
+        table_spec_index=0,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        table_specs = [
+            t for t in self.list_table_specs(dataset_name=dataset_name, **kwargs)
+        ]
+
+        table_spec_full_id = table_specs[table_spec_index].name
+        return table_spec_full_id
+
+    def __model_name_from_args(
+        self,
+        model=None,
+        model_display_name=None,
+        model_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        if model is None and model_display_name is None and model_name is None:
+            raise ValueError(
+                "One of 'model', 'model_name' or " "'model_display_name' must be set."
+            )
+
+        if model_name is None:
+            if model is None:
+                model = self.get_model(
+                    model_display_name=model_display_name,
+                    project=project,
+                    region=region,
+                    **kwargs
+                )
+            model_name = model.name
+        else:
+            # we do this to force a NotFound error when needed
+            self.get_model(
+                model_name=model_name, project=project, region=region, **kwargs
+            )
+        return model_name
+
+    def __log_operation_info(self, message, op):
+        name = "UNKNOWN"
+        try:
+            if (
+                op is not None
+                and op.operation is not None
+                and op.operation.name is not None
+            ):
+                name = op.operation.name
+        except AttributeError:
+            pass
+        _LOGGER.info(
+            (
+                "Operation '{}' is running in the background. The returned "
+                "Operation '{}' can be used to query or block on the status "
+                "of this operation. Ending your python session will _not_ "
+                "cancel this operation. Read the documentation here:\n\n"
+                "\thttps://googleapis.dev/python/google-api-core/latest/operation.html\n\n"
+                "for more information on the Operation class."
+            ).format(message, name)
+        )
+        return op
+
+    def __column_spec_name_from_args(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        column_spec_name=None,
+        column_spec_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        column_specs = self.list_column_specs(
+            dataset=dataset,
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            table_spec_name=table_spec_name,
+            table_spec_index=table_spec_index,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        if column_spec_display_name is not None:
+            column_specs = {s.display_name: s for s in column_specs}
+            if column_specs.get(column_spec_display_name) is None:
+                raise exceptions.NotFound(
+                    "No column with "
+                    + "column_spec_display_name: '{}' found".format(
+                        column_spec_display_name
+                    )
+                )
+            column_spec_name = column_specs[column_spec_display_name].name
+        elif column_spec_name is not None:
+            column_specs = {s.name: s for s in column_specs}
+            if column_specs.get(column_spec_name) is None:
+                raise exceptions.NotFound(
+                    "No column with "
+                    + "column_spec_name: '{}' found".format(column_spec_name)
+                )
+        else:
+            raise ValueError(
+                "Either supply 'column_spec_name' or "
+                "'column_spec_display_name' for the column to update"
+            )
+
+        return column_spec_name
+
+    def __type_code_to_value_type(self, type_code, value):
+        if value is None:
+            return {"null_value": 0}
+        elif type_code == data_types_pb2.FLOAT64:
+            return {"number_value": value}
+        elif type_code == data_types_pb2.TIMESTAMP:
+            return {"string_value": value}
+        elif type_code == data_types_pb2.STRING:
+            return {"string_value": value}
+        elif type_code == data_types_pb2.ARRAY:
+            return {"list_value": value}
+        elif type_code == data_types_pb2.STRUCT:
+            return {"struct_value": value}
+        elif type_code == data_types_pb2.CATEGORY:
+            return {"string_value": value}
+        else:
+            raise ValueError("Unknown type_code: {}".format(type_code))
+
+    def __ensure_gcs_client_is_initialized(self, credentials=None):
+        """Checks if GCS client is initialized. Initializes it if not.
+
+        Args:
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+        """
+        if self.gcs_client is None:
+            self.gcs_client = gcs_client.GcsClient(credentials=credentials)
+
+    def list_datasets(self, project=None, region=None, **kwargs):
+        """List all datasets in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> ds = client.list_datasets()
+            >>>
+            >>> for d in ds:
+            ...     # do something
+            ...     pass
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.Dataset`
+            instances.  You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        return self.auto_ml_client.list_datasets(
+            self.__location_path(project=project, region=region), **kwargs
+        )
+
+    def get_dataset(
+        self,
+        project=None,
+        region=None,
+        dataset_name=None,
+        dataset_display_name=None,
+        **kwargs
+    ):
+        """Gets a single dataset in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.get_dataset(dataset_display_name='my_dataset')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_name (Optional[string]):
+                This is the fully-qualified name generated by the AutoML API
+                for this dataset. This is not to be confused with the
+                human-assigned `dataset_display_name` that is provided when
+                creating a dataset. Either `dataset_name` or
+                `dataset_display_name` must be provided.
+            dataset_display_name (Optional[string]):
+                This is the name you provided for the dataset when first
+                creating it. Either `dataset_name` or `dataset_display_name`
+                must be provided.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance if
+            found, `None` otherwise.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        if dataset_name is None and dataset_display_name is None:
+            raise ValueError(
+                "One of 'dataset_name' or " "'dataset_display_name' must be set."
+            )
+
+        if dataset_name is not None:
+            return self.auto_ml_client.get_dataset(dataset_name, **kwargs)
+
+        return self.__lookup_by_display_name(
+            "dataset",
+            self.list_datasets(project, region, **kwargs),
+            dataset_display_name,
+        )
+
+    def create_dataset(
+        self, dataset_display_name, metadata={}, project=None, region=None, **kwargs
+    ):
+        """Create a dataset. Keep in mind, importing data is a separate step.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.create_dataset(dataset_display_name='my_dataset')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (string):
+                A human-readable name to refer to this dataset by.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        return self.auto_ml_client.create_dataset(
+            self.__location_path(project, region),
+            {"display_name": dataset_display_name, "tables_dataset_metadata": metadata},
+            **kwargs
+        )
+
+    def delete_dataset(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Deletes a dataset. This does not delete any models trained on
+        this dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> op = client.delete_dataset(dataset_display_name='my_dataset')
+            >>>
+            >>> op.result() # blocks on delete request
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to
+                delete.  This must be supplied if `dataset` or `dataset_name`
+                are not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                delete. This must be supplied if `dataset_display_name` or
+                `dataset` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to delete. This must be
+                supplied if `dataset_display_name` or `dataset_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        try:
+            dataset_name = self.__dataset_name_from_args(
+                dataset=dataset,
+                dataset_name=dataset_name,
+                dataset_display_name=dataset_display_name,
+                project=project,
+                region=region,
+                **kwargs
+            )
+        # delete is idempotent
+        except exceptions.NotFound:
+            return None
+
+        op = self.auto_ml_client.delete_dataset(dataset_name, **kwargs)
+        self.__log_operation_info("Delete dataset", op)
+        return op
+
+    def import_data(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        pandas_dataframe=None,
+        gcs_input_uris=None,
+        bigquery_input_uri=None,
+        project=None,
+        region=None,
+        credentials=None,
+        **kwargs
+    ):
+        """Imports data into a dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.create_dataset(dataset_display_name='my_dataset')
+            >>>
+            >>> client.import_data(dataset=d,
+            ...     gcs_input_uris='gs://cloud-ml-tables-data/bank-marketing.csv')
+            ...
+            >>> def callback(operation_future):
+            ...    result = operation_future.result()
+            ...
+            >>> response.add_done_callback(callback)
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            credentials (Optional[google.auth.credentials.Credentials]): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to import
+                data into. This must be supplied if `dataset` or `dataset_name`
+                are not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                import data into. This must be supplied if
+                `dataset_display_name` or `dataset` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to import data into. This must
+                be supplied if `dataset_display_name` or `dataset_name` are not
+                supplied.
+            pandas_dataframe (Optional[pandas.DataFrame]):
+                A Pandas Dataframe object containing the data to import. The data
+                will be converted to CSV, and this CSV will be staged to GCS in
+                `gs://{project}-automl-tables-staging/{uploaded_csv_name}`
+                This parameter must be supplied if neither `gcs_input_uris` nor
+                `bigquery_input_uri` is supplied.
+            gcs_input_uris (Optional[Union[string, Sequence[string]]]):
+                Either a single `gs://..` prefixed URI, or a list of URIs
+                referring to GCS-hosted CSV files containing the data to
+                import. This must be supplied if neither `bigquery_input_uri`
+                nor `pandas_dataframe` is supplied.
+            bigquery_input_uri (Optional[string]):
+                A URI pointing to the BigQuery table containing the data to
+                import. This must be supplied if neither `gcs_input_uris` nor
+                `pandas_dataframe` is supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        request = {}
+
+        if pandas_dataframe is not None:
+            self.__ensure_gcs_client_is_initialized(credentials)
+            self.gcs_client.ensure_bucket_exists(project, region)
+            gcs_input_uri = self.gcs_client.upload_pandas_dataframe(pandas_dataframe)
+            request = {"gcs_source": {"input_uris": [gcs_input_uri]}}
+        elif gcs_input_uris is not None:
+            if type(gcs_input_uris) != list:
+                gcs_input_uris = [gcs_input_uris]
+            request = {"gcs_source": {"input_uris": gcs_input_uris}}
+        elif bigquery_input_uri is not None:
+            request = {"bigquery_source": {"input_uri": bigquery_input_uri}}
+        else:
+            raise ValueError(
+                "One of 'gcs_input_uris', or 'bigquery_input_uri', or 'pandas_dataframe' must be set."
+            )
+
+        op = self.auto_ml_client.import_data(dataset_name, request, **kwargs)
+        self.__log_operation_info("Data import", op)
+        return op
+
+    def export_data(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        gcs_output_uri_prefix=None,
+        bigquery_output_uri=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Exports data from a dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.create_dataset(dataset_display_name='my_dataset')
+            >>>
+            >>> client.export_data(dataset=d,
+            ...     gcs_output_uri_prefix='gs://cloud-ml-tables-data/bank-marketing.csv')
+            ...
+            >>> def callback(operation_future):
+            ...    result = operation_future.result()
+            ...
+            >>> response.add_done_callback(callback)
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to export
+                data from. This must be supplied if `dataset` or `dataset_name`
+                are not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                export data from. This must be supplied if
+                `dataset_display_name` or `dataset` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to export data from. This must
+                be supplied if `dataset_display_name` or `dataset_name` are not
+                supplied.
+            gcs_output_uri_prefix (Optional[Union[string, Sequence[string]]]):
+                A single `gs://..` prefixed URI to export to. This must be
+                supplied if `bigquery_output_uri` is not.
+            bigquery_output_uri (Optional[string]):
+                A URI pointing to the BigQuery table containing the data to
+                export. This must be supplied if `gcs_output_uri_prefix` is not.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        request = {}
+        if gcs_output_uri_prefix is not None:
+            request = {"gcs_destination": {"output_uri_prefix": gcs_output_uri_prefix}}
+        elif bigquery_output_uri is not None:
+            request = {"bigquery_destination": {"output_uri": bigquery_output_uri}}
+        else:
+            raise ValueError(
+                "One of 'gcs_output_uri_prefix', or 'bigquery_output_uri' must be set."
+            )
+
+        op = self.auto_ml_client.export_data(dataset_name, request, **kwargs)
+        self.__log_operation_info("Export data", op)
+        return op
+
+    def get_table_spec(self, table_spec_name, project=None, region=None, **kwargs):
+        """Gets a single table spec in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.get_table_spec('my_table_spec')
+            >>>
+
+        Args:
+            table_spec_name (string):
+                This is the fully-qualified name generated by the AutoML API
+                for this table spec.
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.TableSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        return self.auto_ml_client.get_table_spec(table_spec_name, **kwargs)
+
+    def list_table_specs(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Lists table specs.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> for s in client.list_table_specs(dataset_display_name='my_dataset')
+            ...     # process the spec
+            ...     pass
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to read
+                specs from. This must be supplied if `dataset` or
+                `dataset_name` are not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to read
+                specs from. This must be supplied if `dataset_display_name` or
+                `dataset` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to read specs from. This must
+                be supplied if `dataset_display_name` or `dataset_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of
+            :class:`~google.cloud.automl_v1beta1.types.TableSpec` instances.
+            You can also iterate over the pages of the response using its
+            `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        return self.auto_ml_client.list_table_specs(dataset_name, **kwargs)
+
+    def get_column_spec(self, column_spec_name, project=None, region=None, **kwargs):
+        """Gets a single column spec in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.get_column_spec('my_column_spec')
+            >>>
+
+        Args:
+            column_spec_name (string):
+                This is the fully-qualified name generated by the AutoML API
+                for this column spec.
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.ColumnSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        return self.auto_ml_client.get_column_spec(column_spec_name, **kwargs)
+
+    def list_column_specs(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Lists column specs.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> for s in client.list_column_specs(dataset_display_name='my_dataset')
+            ...     # process the spec
+            ...     pass
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            table_spec_name (Optional[string]):
+                The AutoML-assigned name for the table whose specs you want to
+                read. If not supplied, the client can determine this name from
+                a source `Dataset` object.
+            table_spec_index (Optional[int]):
+                If no `table_spec_name` was provided, we use this index to
+                determine which table to read column specs from.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to read
+                specs from. If no `table_spec_name` is supplied, this will be
+                used together with `table_spec_index` to infer the name of
+                table to read specs from. This must be supplied if
+                `table_spec_name`, `dataset` or `dataset_name` are not
+                supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to read
+                specs from. If no `table_spec_name` is supplied, this will be
+                used together with `table_spec_index` to infer the name of
+                table to read specs from. This must be supplied if
+                `table_spec_name`, `dataset` or `dataset_display_name` are not
+                supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to read specs from. If no
+                `table_spec_name` is supplied, this will be used together with
+                `table_spec_index` to infer the name of table to read specs
+                from. This must be supplied if `table_spec_name`,
+                `dataset_name` or `dataset_display_name` are not supplied.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of
+            :class:`~google.cloud.automl_v1beta1.types.ColumnSpec` instances.
+            You can also iterate over the pages of the response using its
+            `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        if table_spec_name is None:
+            table_specs = [
+                t
+                for t in self.list_table_specs(
+                    dataset=dataset,
+                    dataset_display_name=dataset_display_name,
+                    dataset_name=dataset_name,
+                    project=project,
+                    region=region,
+                    **kwargs
+                )
+            ]
+
+            table_spec_name = table_specs[table_spec_index].name
+
+        return self.auto_ml_client.list_column_specs(table_spec_name, **kwargs)
+
+    def update_column_spec(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        column_spec_name=None,
+        column_spec_display_name=None,
+        type_code=None,
+        nullable=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Updates a column's specs.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.update_column_specs(dataset_display_name='my_dataset',
+            ...     column_spec_display_name='Outcome', type_code='CATEGORY')
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            column_spec_name (Optional[string]):
+                The name AutoML-assigned name for the column you want to
+                update.
+            column_spec_display_name (Optional[string]):
+                The human-readable name of the column you want to update. If
+                this is supplied in place of `column_spec_name`, you also need
+                to provide either a way to lookup the source dataset (using one
+                of the `dataset*` kwargs), or the `table_spec_name` of the
+                table this column belongs to.
+            table_spec_name (Optional[string]):
+                The AutoML-assigned name for the table whose specs you want to
+                update. If not supplied, the client can determine this name
+                from a source `Dataset` object.
+            table_spec_index (Optional[int]):
+                If no `table_spec_name` was provided, we use this index to
+                determine which table to update column specs on.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                specs on. If no `table_spec_name` is supplied, this will be
+                used together with `table_spec_index` to infer the name of
+                table to update specs on. This must be supplied if
+                `table_spec_name`, `dataset` or `dataset_name` are not
+                supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update specs one. If no `table_spec_name` is supplied, this
+                will be used together with `table_spec_index` to infer the name
+                of table to update specs on. This must be supplied if
+                `table_spec_name`, `dataset` or `dataset_display_name` are not
+                supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update specs on. If no
+                `table_spec_name` is supplied, this will be used together with
+                `table_spec_index` to infer the name of table to update specs
+                on. This must be supplied if `table_spec_name`, `dataset_name`
+                or `dataset_display_name` are not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.ColumnSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        column_spec_name = self.__column_spec_name_from_args(
+            dataset=dataset,
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            table_spec_name=table_spec_name,
+            table_spec_index=table_spec_index,
+            column_spec_name=column_spec_name,
+            column_spec_display_name=column_spec_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        # type code must always be set
+        if type_code is None:
+            # this index is safe, we would have already thrown a NotFound
+            # had the column_spec_name not existed
+            type_code = {
+                s.name: s
+                for s in self.list_column_specs(
+                    dataset=dataset,
+                    dataset_display_name=dataset_display_name,
+                    dataset_name=dataset_name,
+                    table_spec_name=table_spec_name,
+                    table_spec_index=table_spec_index,
+                    project=project,
+                    region=region,
+                    **kwargs
+                )
+            }[column_spec_name].data_type.type_code
+
+        data_type = {}
+        if nullable is not None:
+            data_type["nullable"] = nullable
+
+        data_type["type_code"] = type_code
+
+        request = {"name": column_spec_name, "data_type": data_type}
+
+        return self.auto_ml_client.update_column_spec(request, **kwargs)
+
+    def set_target_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        column_spec_name=None,
+        column_spec_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Sets the target column for a given table.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.set_target_column(dataset_display_name='my_dataset',
+            ...     column_spec_display_name='Income')
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            column_spec_name (Optional[string]):
+                The name AutoML-assigned name for the column you want to set as
+                the target column.
+            column_spec_display_name (Optional[string]):
+                The human-readable name of the column you want to set as the
+                target column. If this is supplied in place of
+                `column_spec_name`, you also need to provide either a way to
+                lookup the source dataset (using one of the `dataset*` kwargs),
+                or the `table_spec_name` of the table this column belongs to.
+            table_spec_name (Optional[string]):
+                The AutoML-assigned name for the table whose target column you
+                want to set . If not supplied, the client can determine this
+                name from a source `Dataset` object.
+            table_spec_index (Optional[int]):
+                If no `table_spec_name` or `column_spec_name` was provided, we
+                use this index to determine which table to set the target
+                column on.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the target column of. If no `table_spec_name` is supplied, this
+                will be used together with `table_spec_index` to infer the name
+                of table to update the target column of. This must be supplied
+                if `table_spec_name`, `dataset` or `dataset_name` are not
+                supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the target column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the target column of. This
+                must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the target column of.
+                If no `table_spec_name` is supplied, this will be used together
+                with `table_spec_index` to infer the name of table to update
+                the target column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        column_spec_name = self.__column_spec_name_from_args(
+            dataset=dataset,
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            table_spec_name=table_spec_name,
+            table_spec_index=table_spec_index,
+            column_spec_name=column_spec_name,
+            column_spec_display_name=column_spec_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        column_spec_id = column_spec_name.rsplit("/", 1)[-1]
+
+        dataset = self.__dataset_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        metadata = dataset.tables_dataset_metadata
+        metadata = self.__update_metadata(
+            metadata, "target_column_spec_id", column_spec_id
+        )
+
+        request = {"name": dataset.name, "tables_dataset_metadata": metadata}
+
+        return self.auto_ml_client.update_dataset(request, **kwargs)
+
+    def set_time_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        column_spec_name=None,
+        column_spec_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Sets the time column which designates which data will be of type
+        timestamp and will be used for the timeseries data.
+        This column must be of type timestamp.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.set_time_column(dataset_display_name='my_dataset',
+            ...     column_spec_name='Unix Time')
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            column_spec_name (Optional[string]):
+                The name AutoML-assigned name for the column you want to set as
+                the time column.
+            column_spec_display_name (Optional[string]):
+                The human-readable name of the column you want to set as the
+                time column. If this is supplied in place of
+                `column_spec_name`, you also need to provide either a way to
+                lookup the source dataset (using one of the `dataset*` kwargs),
+                or the `table_spec_name` of the table this column belongs to.
+            table_spec_name (Optional[string]):
+                The AutoML-assigned name for the table whose time column
+                you want to set . If not supplied, the client can determine
+                this name from a source `Dataset` object.
+            table_spec_index (Optional[int]):
+                If no `table_spec_name` or `column_spec_name` was provided, we
+                use this index to determine which table to set the time
+                column on.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the time column of. If no `table_spec_name` is supplied,
+                this will be used together with `table_spec_index` to infer the
+                name of table to update the time column of. This must be
+                supplied if `table_spec_name`, `dataset` or `dataset_name` are
+                not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the time column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the time column of.
+                This must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the time column
+                of.  If no `table_spec_name` is supplied, this will be used
+                together with `table_spec_index` to infer the name of table to
+                update the time column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.TableSpec` instance.
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        column_spec_name = self.__column_spec_name_from_args(
+            dataset=dataset,
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            table_spec_name=table_spec_name,
+            table_spec_index=table_spec_index,
+            column_spec_name=column_spec_name,
+            column_spec_display_name=column_spec_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        column_spec_id = column_spec_name.rsplit("/", 1)[-1]
+
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        table_spec_full_id = self.__table_spec_name_from_args(
+            dataset_name=dataset_name, **kwargs
+        )
+
+        my_table_spec = {
+            "name": table_spec_full_id,
+            "time_column_spec_id": column_spec_id,
+        }
+
+        return self.auto_ml_client.update_table_spec(my_table_spec, **kwargs)
+
+    def clear_time_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Clears the time column which designates which data will be of type
+        timestamp and will be used for the timeseries data.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.set_time_column(dataset_display_name='my_dataset')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the time column of. If no `table_spec_name` is supplied,
+                this will be used together with `table_spec_index` to infer the
+                name of table to update the time column of. This must be
+                supplied if `table_spec_name`, `dataset` or `dataset_name` are
+                not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the time column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the time column of.
+                This must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the time column
+                of.  If no `table_spec_name` is supplied, this will be used
+                together with `table_spec_index` to infer the name of table to
+                update the time column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.TableSpec` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        table_spec_full_id = self.__table_spec_name_from_args(
+            dataset_name=dataset_name, **kwargs
+        )
+
+        my_table_spec = {"name": table_spec_full_id, "time_column_spec_id": None}
+
+        return self.auto_ml_client.update_table_spec(my_table_spec, **kwargs)
+
+    def set_weight_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        column_spec_name=None,
+        column_spec_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Sets the weight column for a given table.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.set_weight_column(dataset_display_name='my_dataset',
+            ...     column_spec_display_name='Income')
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            column_spec_name (Optional[string]):
+                The name AutoML-assigned name for the column you want to
+                set as the weight column.
+            column_spec_display_name (Optional[string]):
+                The human-readable name of the column you want to set as the
+                weight column. If this is supplied in place of
+                `column_spec_name`, you also need to provide either a way to
+                lookup the source dataset (using one of the `dataset*` kwargs),
+                or the `table_spec_name` of the table this column belongs to.
+            table_spec_name (Optional[string]):
+                The AutoML-assigned name for the table whose weight column you
+                want to set . If not supplied, the client can determine this
+                name from a source `Dataset` object.
+            table_spec_index (Optional[int]):
+                If no `table_spec_name` or `column_spec_name` was provided, we
+                use this index to determine which table to set the weight
+                column on.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the weight column of. If no `table_spec_name` is supplied, this
+                will be used together with `table_spec_index` to infer the name
+                of table to update the weight column of. This must be supplied
+                if `table_spec_name`, `dataset` or `dataset_name` are not
+                supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the weight column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the weight column of. This
+                must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the weight column of.
+                If no `table_spec_name` is supplied, this will be used together
+                with `table_spec_index` to infer the name of table to update
+                the weight column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        column_spec_name = self.__column_spec_name_from_args(
+            dataset=dataset,
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            table_spec_name=table_spec_name,
+            table_spec_index=table_spec_index,
+            column_spec_name=column_spec_name,
+            column_spec_display_name=column_spec_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        column_spec_id = column_spec_name.rsplit("/", 1)[-1]
+
+        dataset = self.__dataset_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        metadata = dataset.tables_dataset_metadata
+        metadata = self.__update_metadata(
+            metadata, "weight_column_spec_id", column_spec_id
+        )
+
+        request = {"name": dataset.name, "tables_dataset_metadata": metadata}
+
+        return self.auto_ml_client.update_dataset(request, **kwargs)
+
+    def clear_weight_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Clears the weight column for a given dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.clear_weight_column(dataset_display_name='my_dataset')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the weight column of. If no `table_spec_name` is supplied, this
+                will be used together with `table_spec_index` to infer the name
+                of table to update the weight column of. This must be supplied
+                if `table_spec_name`, `dataset` or `dataset_name` are not
+                supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the weight column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the weight column of. This
+                must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the weight column of.
+                If no `table_spec_name` is supplied, this will be used together
+                with `table_spec_index` to infer the name of table to update
+                the weight column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        dataset = self.__dataset_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        metadata = dataset.tables_dataset_metadata
+        metadata = self.__update_metadata(metadata, "weight_column_spec_id", None)
+
+        request = {"name": dataset.name, "tables_dataset_metadata": metadata}
+
+        return self.auto_ml_client.update_dataset(request, **kwargs)
+
+    def set_test_train_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        table_spec_name=None,
+        table_spec_index=0,
+        column_spec_name=None,
+        column_spec_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Sets the test/train (ml_use) column which designates which data
+        belongs to the test and train sets. This column must be categorical.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.set_test_train_column(dataset_display_name='my_dataset',
+            ...     column_spec_display_name='TestSplit')
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            column_spec_name (Optional[string]):
+                The name AutoML-assigned name for the column you want to set as
+                the test/train column.
+            column_spec_display_name (Optional[string]):
+                The human-readable name of the column you want to set as the
+                test/train column. If this is supplied in place of
+                `column_spec_name`, you also need to provide either a way to
+                lookup the source dataset (using one of the `dataset*` kwargs),
+                or the `table_spec_name` of the table this column belongs to.
+            table_spec_name (Optional[string]):
+                The AutoML-assigned name for the table whose test/train column
+                you want to set . If not supplied, the client can determine
+                this name from a source `Dataset` object.
+            table_spec_index (Optional[int]):
+                If no `table_spec_name` or `column_spec_name` was provided, we
+                use this index to determine which table to set the test/train
+                column on.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the test/train column of. If no `table_spec_name` is supplied,
+                this will be used together with `table_spec_index` to infer the
+                name of table to update the test/train column of. This must be
+                supplied if `table_spec_name`, `dataset` or `dataset_name` are
+                not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the test/train column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the test/train column of.
+                This must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the test/train column
+                of.  If no `table_spec_name` is supplied, this will be used
+                together with `table_spec_index` to infer the name of table to
+                update the test/train column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        column_spec_name = self.__column_spec_name_from_args(
+            dataset=dataset,
+            dataset_display_name=dataset_display_name,
+            dataset_name=dataset_name,
+            table_spec_name=table_spec_name,
+            table_spec_index=table_spec_index,
+            column_spec_name=column_spec_name,
+            column_spec_display_name=column_spec_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        column_spec_id = column_spec_name.rsplit("/", 1)[-1]
+
+        dataset = self.__dataset_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        metadata = dataset.tables_dataset_metadata
+        metadata = self.__update_metadata(
+            metadata, "ml_use_column_spec_id", column_spec_id
+        )
+
+        request = {"name": dataset.name, "tables_dataset_metadata": metadata}
+
+        return self.auto_ml_client.update_dataset(request, **kwargs)
+
+    def clear_test_train_column(
+        self,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Clears the test/train (ml_use) column which designates which data
+        belongs to the test and train sets.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.clear_test_train_column(dataset_display_name='my_dataset')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to update
+                the test/train column of. If no `table_spec_name` is supplied,
+                this will be used together with `table_spec_index` to infer the
+                name of table to update the test/train column of. This must be
+                supplied if `table_spec_name`, `dataset` or `dataset_name` are
+                not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to
+                update the test/train column of. If no `table_spec_name` is
+                supplied, this will be used together with `table_spec_index` to
+                infer the name of table to update the test/train column of.
+                This must be supplied if `table_spec_name`, `dataset` or
+                `dataset_display_name` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to update the test/train column
+                of.  If no `table_spec_name` is supplied, this will be used
+                together with `table_spec_index` to infer the name of table to
+                update the test/train column of. This must be supplied if
+                `table_spec_name`, `dataset_name` or `dataset_display_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        dataset = self.__dataset_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+        metadata = dataset.tables_dataset_metadata
+        metadata = self.__update_metadata(metadata, "ml_use_column_spec_id", None)
+
+        request = {"name": dataset.name, "tables_dataset_metadata": metadata}
+
+        return self.auto_ml_client.update_dataset(request, **kwargs)
+
+    def list_models(self, project=None, region=None, **kwargs):
+        """List all models in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> ms = client.list_models()
+            >>>
+            >>> for m in ms:
+            ...     # do something
+            ...     pass
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.automl_v1beta1.types.Model`
+            instances.  You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        return self.auto_ml_client.list_models(
+            self.__location_path(project=project, region=region), **kwargs
+        )
+
+    def list_model_evaluations(
+        self,
+        project=None,
+        region=None,
+        model=None,
+        model_display_name=None,
+        model_name=None,
+        **kwargs
+    ):
+        """List all model evaluations for a given model.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> ms = client.list_model_evaluations(model_display_name='my_model')
+            >>>
+            >>> for m in ms:
+            ...     # do something
+            ...     pass
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            model_display_name (Optional[string]):
+                The human-readable name given to the model you want to list
+                evaluations for.  This must be supplied if `model` or
+                `model_name` are not supplied.
+            model_name (Optional[string]):
+                The AutoML-assigned name given to the model you want to list
+                evaluations for. This must be supplied if `model_display_name`
+                or `model` are not supplied.
+            model (Optional[model]):
+                The `model` instance you want to list evaluations for. This
+                must be supplied if `model_display_name` or `model_name` are
+                not supplied.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of
+            :class:`~google.cloud.automl_v1beta1.types.ModelEvaluation`
+            instances.  You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        model_name = self.__model_name_from_args(
+            model=model,
+            model_name=model_name,
+            model_display_name=model_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        return self.auto_ml_client.list_model_evaluations(model_name, **kwargs)
+
+    def create_model(
+        self,
+        model_display_name,
+        dataset=None,
+        dataset_display_name=None,
+        dataset_name=None,
+        train_budget_milli_node_hours=None,
+        optimization_objective=None,
+        project=None,
+        region=None,
+        model_metadata={},
+        include_column_spec_names=None,
+        exclude_column_spec_names=None,
+        **kwargs
+    ):
+        """Create a model. This will train your model on the given dataset.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> m = client.create_model('my_model', dataset_display_name='my_dataset')
+            >>>
+            >>> m.result() # blocks on result
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            model_display_name (string):
+                A human-readable name to refer to this model by.
+            train_budget_milli_node_hours (int):
+                The amount of time (in thousandths of an hour) to spend
+                training. This value must be between 1,000 and 72,000 inclusive
+                (between 1 and 72 hours).
+            optimization_objective (string):
+                The metric AutoML tables should optimize for.
+            dataset_display_name (Optional[string]):
+                The human-readable name given to the dataset you want to train
+                your model on. This must be supplied if `dataset` or
+                `dataset_name` are not supplied.
+            dataset_name (Optional[string]):
+                The AutoML-assigned name given to the dataset you want to train
+                your model on. This must be supplied if `dataset_display_name`
+                or `dataset` are not supplied.
+            dataset (Optional[Dataset]):
+                The `Dataset` instance you want to train your model on. This
+                must be supplied if `dataset_display_name` or `dataset_name`
+                are not supplied.
+            model_metadata (Optional[Dict]):
+                Optional model metadata to supply to the client.
+            include_column_spec_names(Optional[string]):
+                The list of the names of the columns you want to include to train
+                your model on.
+            exclude_column_spec_names(Optional[string]):
+                The list of the names of the columns you want to exclude and
+                not train your model on.
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        if (
+            train_budget_milli_node_hours is None
+            or train_budget_milli_node_hours < 1000
+            or train_budget_milli_node_hours > 72000
+        ):
+            raise ValueError(
+                "'train_budget_milli_node_hours' must be a "
+                "value between 1,000 and 72,000 inclusive"
+            )
+
+        if exclude_column_spec_names not in [
+            None,
+            [],
+        ] and include_column_spec_names not in [None, []]:
+            raise ValueError(
+                "Cannot set both "
+                "'exclude_column_spec_names' and "
+                "'include_column_spec_names'"
+            )
+
+        dataset_name = self.__dataset_name_from_args(
+            dataset=dataset,
+            dataset_name=dataset_name,
+            dataset_display_name=dataset_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        model_metadata["train_budget_milli_node_hours"] = train_budget_milli_node_hours
+        if optimization_objective is not None:
+            model_metadata["optimization_objective"] = optimization_objective
+
+        dataset_id = dataset_name.rsplit("/", 1)[-1]
+        columns = [
+            s
+            for s in self.list_column_specs(
+                dataset=dataset,
+                dataset_name=dataset_name,
+                dataset_display_name=dataset_display_name,
+                **kwargs
+            )
+        ]
+
+        final_columns = []
+        if include_column_spec_names:
+            for c in columns:
+                if c.display_name in include_column_spec_names:
+                    final_columns.append(c)
+
+            model_metadata["input_feature_column_specs"] = final_columns
+        elif exclude_column_spec_names:
+            for a in columns:
+                if a.display_name not in exclude_column_spec_names:
+                    final_columns.append(a)
+
+            model_metadata["input_feature_column_specs"] = final_columns
+
+        request = {
+            "display_name": model_display_name,
+            "dataset_id": dataset_id,
+            "tables_model_metadata": model_metadata,
+        }
+
+        op = self.auto_ml_client.create_model(
+            self.__location_path(project=project, region=region), request, **kwargs
+        )
+        self.__log_operation_info("Model creation", op)
+        return op
+
+    def delete_model(
+        self,
+        model=None,
+        model_display_name=None,
+        model_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Deletes a model. Note this will not delete any datasets associated
+        with this model.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> op = client.delete_model(model_display_name='my_model')
+            >>>
+            >>> op.result() # blocks on delete request
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            model_display_name (Optional[string]):
+                The human-readable name given to the model you want to
+                delete.  This must be supplied if `model` or `model_name`
+                are not supplied.
+            model_name (Optional[string]):
+                The AutoML-assigned name given to the model you want to
+                delete. This must be supplied if `model_display_name` or
+                `model` are not supplied.
+            model (Optional[model]):
+                The `model` instance you want to delete. This must be
+                supplied if `model_display_name` or `model_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        try:
+            model_name = self.__model_name_from_args(
+                model=model,
+                model_name=model_name,
+                model_display_name=model_display_name,
+                project=project,
+                region=region,
+                **kwargs
+            )
+        # delete is idempotent
+        except exceptions.NotFound:
+            return None
+
+        op = self.auto_ml_client.delete_model(model_name, **kwargs)
+        self.__log_operation_info("Delete model", op)
+        return op
+
+    def get_model_evaluation(
+        self, model_evaluation_name, project=None, region=None, **kwargs
+    ):
+        """Gets a single evaluation model in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.get_model_evaluation('my_model_evaluation')
+            >>>
+
+        Args:
+            model_evaluation_name (string):
+                This is the fully-qualified name generated by the AutoML API
+                for this model evaluation.
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.ModelEvaluation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        return self.auto_ml_client.get_model_evaluation(model_evaluation_name, **kwargs)
+
+    def get_model(
+        self,
+        project=None,
+        region=None,
+        model_name=None,
+        model_display_name=None,
+        **kwargs
+    ):
+        """Gets a single model in a particular project and region.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> d = client.get_model(model_display_name='my_model')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            model_name (Optional[string]):
+                This is the fully-qualified name generated by the AutoML API
+                for this model. This is not to be confused with the
+                human-assigned `model_display_name` that is provided when
+                creating a model. Either `model_name` or
+                `model_display_name` must be provided.
+            model_display_name (Optional[string]):
+                This is the name you provided for the model when first
+                creating it. Either `model_name` or `model_display_name`
+                must be provided.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.Model` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        if model_name is None and model_display_name is None:
+            raise ValueError(
+                "One of 'model_name' or " "'model_display_name' must be set."
+            )
+
+        if model_name is not None:
+            return self.auto_ml_client.get_model(model_name, **kwargs)
+
+        return self.__lookup_by_display_name(
+            "model", self.list_models(project, region, **kwargs), model_display_name
+        )
+
+    # TODO(jonathanskim): allow deployment from just model ID
+    def deploy_model(
+        self,
+        model=None,
+        model_name=None,
+        model_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Deploys a model. This allows you make online predictions using the
+        model you've deployed.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> op = client.deploy_model(model_display_name='my_model')
+            >>>
+            >>> op.result() # blocks on deploy request
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            model_display_name (Optional[string]):
+                The human-readable name given to the model you want to
+                deploy.  This must be supplied if `model` or `model_name`
+                are not supplied.
+            model_name (Optional[string]):
+                The AutoML-assigned name given to the model you want to
+                deploy. This must be supplied if `model_display_name` or
+                `model` are not supplied.
+            model (Optional[model]):
+                The `model` instance you want to deploy. This must be
+                supplied if `model_display_name` or `model_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        model_name = self.__model_name_from_args(
+            model=model,
+            model_name=model_name,
+            model_display_name=model_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        op = self.auto_ml_client.deploy_model(model_name, **kwargs)
+        self.__log_operation_info("Deploy model", op)
+        return op
+
+    def undeploy_model(
+        self,
+        model=None,
+        model_name=None,
+        model_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Undeploys a model.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> op = client.undeploy_model(model_display_name='my_model')
+            >>>
+            >>> op.result() # blocks on undeploy request
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            model_display_name (Optional[string]):
+                The human-readable name given to the model you want to
+                undeploy.  This must be supplied if `model` or `model_name`
+                are not supplied.
+            model_name (Optional[string]):
+                The AutoML-assigned name given to the model you want to
+                undeploy. This must be supplied if `model_display_name` or
+                `model` are not supplied.
+            model (Optional[model]):
+                The `model` instance you want to undeploy. This must be
+                supplied if `model_display_name` or `model_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        model_name = self.__model_name_from_args(
+            model=model,
+            model_name=model_name,
+            model_display_name=model_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        op = self.auto_ml_client.undeploy_model(model_name, **kwargs)
+        self.__log_operation_info("Undeploy model", op)
+        return op
+
+    ## TODO(lwander): support pandas DataFrame as input type
+    def predict(
+        self,
+        inputs,
+        model=None,
+        model_name=None,
+        model_display_name=None,
+        project=None,
+        region=None,
+        **kwargs
+    ):
+        """Makes a prediction on a deployed model. This will fail if the model
+        was not deployed.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.predict(inputs={'Age': 30, 'Income': 12, 'Category': 'A'}
+            ...     model_display_name='my_model')
+            ...
+            >>> client.predict([30, 12, 'A'], model_display_name='my_model')
+            >>>
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            inputs (Union[List[string], Dict[string, string]]):
+                Either the sorted list of column values to predict with, or a
+                key-value map of column display name to value to predict with.
+            model_display_name (Optional[string]):
+                The human-readable name given to the model you want to predict
+                with.  This must be supplied if `model` or `model_name` are not
+                supplied.
+            model_name (Optional[string]):
+                The AutoML-assigned name given to the model you want to predict
+                with. This must be supplied if `model_display_name` or `model`
+                are not supplied.
+            model (Optional[model]):
+                The `model` instance you want to predict with . This must be
+                supplied if `model_display_name` or `model_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types.PredictResponse`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        model = self.__model_from_args(
+            model=model,
+            model_name=model_name,
+            model_display_name=model_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        column_specs = model.tables_model_metadata.input_feature_column_specs
+        if type(inputs) == dict:
+            inputs = [inputs.get(c.display_name, None) for c in column_specs]
+
+        if len(inputs) != len(column_specs):
+            raise ValueError(
+                (
+                    "Dimension mismatch, the number of provided "
+                    "inputs ({}) does not match that of the model "
+                    "({})"
+                ).format(len(inputs), len(column_specs))
+            )
+
+        values = []
+        for i, c in zip(inputs, column_specs):
+            value_type = self.__type_code_to_value_type(c.data_type.type_code, i)
+            values.append(value_type)
+
+        request = {"row": {"values": values}}
+
+        return self.prediction_client.predict(model.name, request, **kwargs)
+
+    def batch_predict(
+        self,
+        pandas_dataframe=None,
+        bigquery_input_uri=None,
+        bigquery_output_uri=None,
+        gcs_input_uris=None,
+        gcs_output_uri_prefix=None,
+        model=None,
+        model_name=None,
+        model_display_name=None,
+        project=None,
+        region=None,
+        credentials=None,
+        inputs=None,
+        **kwargs
+    ):
+        """Makes a batch prediction on a model. This does _not_ require the
+        model to be deployed.
+
+        Example:
+            >>> from google.cloud import automl_v1beta1
+            >>>
+            >>> from google.oauth2 import service_account
+            >>>
+            >>> client = automl_v1beta1.TablesClient(
+            ...     credentials=service_account.Credentials.from_service_account_file('~/.gcp/account.json')
+            ...     project='my-project', region='us-central1')
+            ...
+            >>> client.batch_predict(
+            ...     gcs_input_uris='gs://inputs/input.csv',
+            ...     gcs_output_uri_prefix='gs://outputs/',
+            ...     model_display_name='my_model'
+            ...  ).result()
+            ...
+
+        Args:
+            project (Optional[string]):
+                If you have initialized the client with a value for `project`
+                it will be used if this parameter is not supplied. Keep in
+                mind, the service account this client was initialized with must
+                have access to this project.
+            region (Optional[string]):
+                If you have initialized the client with a value for `region` it
+                will be used if this parameter is not supplied.
+            credentials (Optional[google.auth.credentials.Credentials]): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            pandas_dataframe (Optional[pandas.DataFrame]):
+                A Pandas Dataframe object containing the data you want to predict
+                off of. The data will be converted to CSV, and this CSV will be
+                staged to GCS in `gs://{project}-automl-tables-staging/{uploaded_csv_name}`
+                This must be supplied if neither `gcs_input_uris` nor
+                `bigquery_input_uri` is supplied.
+            gcs_input_uris (Optional(Union[List[string], string]))
+                Either a list of or a single GCS URI containing the data you
+                want to predict off of. This must be supplied if neither
+                `pandas_dataframe` nor `bigquery_input_uri` is supplied.
+            gcs_output_uri_prefix (Optional[string])
+                The folder in GCS you want to write output to. This must be
+                supplied if `bigquery_output_uri` is not.
+            bigquery_input_uri (Optional[string])
+                The BigQuery table to input data from. This must be supplied if
+                neither `pandas_dataframe` nor `gcs_input_uris` is supplied.
+            bigquery_output_uri (Optional[string])
+                The BigQuery table to output data to. This must be supplied if
+                `gcs_output_uri_prefix` is not.
+            model_display_name (Optional[string]):
+                The human-readable name given to the model you want to predict
+                with.  This must be supplied if `model` or `model_name` are not
+                supplied.
+            model_name (Optional[string]):
+                The AutoML-assigned name given to the model you want to predict
+                with. This must be supplied if `model_display_name` or `model`
+                are not supplied.
+            model (Optional[model]):
+                The `model` instance you want to predict with . This must be
+                supplied if `model_display_name` or `model_name` are not
+                supplied.
+
+        Returns:
+            A :class:`~google.cloud.automl_v1beta1.types._OperationFuture`
+            instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                to a retryable error and retry attempts failed.
+            ValueError: If required parameters are missing.
+        """
+        model_name = self.__model_name_from_args(
+            model=model,
+            model_name=model_name,
+            model_display_name=model_display_name,
+            project=project,
+            region=region,
+            **kwargs
+        )
+
+        input_request = None
+
+        if pandas_dataframe is not None:
+            self.__ensure_gcs_client_is_initialized(credentials)
+            self.gcs_client.ensure_bucket_exists(project, region)
+            gcs_input_uri = self.gcs_client.upload_pandas_dataframe(pandas_dataframe)
+            input_request = {"gcs_source": {"input_uris": [gcs_input_uri]}}
+        elif gcs_input_uris is not None:
+            if type(gcs_input_uris) != list:
+                gcs_input_uris = [gcs_input_uris]
+            input_request = {"gcs_source": {"input_uris": gcs_input_uris}}
+        elif bigquery_input_uri is not None:
+            input_request = {"bigquery_source": {"input_uri": bigquery_input_uri}}
+        else:
+            raise ValueError(
+                "One of 'gcs_input_uris'/'bigquery_input_uris' must" "be set"
+            )
+
+        output_request = None
+        if gcs_output_uri_prefix is not None:
+            output_request = {
+                "gcs_destination": {"output_uri_prefix": gcs_output_uri_prefix}
+            }
+        elif bigquery_output_uri is not None:
+            output_request = {
+                "bigquery_destination": {"output_uri": bigquery_output_uri}
+            }
+        else:
+            raise ValueError(
+                "One of 'gcs_output_uri_prefix'/'bigquery_output_uri' must be set"
+            )
+
+        op = self.prediction_client.batch_predict(
+            model_name, input_request, output_request, **kwargs
+        )
+        self.__log_operation_info("Batch predict", op)
+        return op
diff --git a/automl/google/cloud/automl_v1beta1/types.py b/automl/google/cloud/automl_v1beta1/types.py
new file mode 100644
index 000000000000..8025892487d6
--- /dev/null
+++ b/automl/google/cloud/automl_v1beta1/types.py
@@ -0,0 +1,114 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.automl_v1beta1.proto import annotation_payload_pb2
+from google.cloud.automl_v1beta1.proto import annotation_spec_pb2
+from google.cloud.automl_v1beta1.proto import classification_pb2
+from google.cloud.automl_v1beta1.proto import column_spec_pb2
+from google.cloud.automl_v1beta1.proto import data_items_pb2
+from google.cloud.automl_v1beta1.proto import data_stats_pb2
+from google.cloud.automl_v1beta1.proto import data_types_pb2
+from google.cloud.automl_v1beta1.proto import dataset_pb2
+from google.cloud.automl_v1beta1.proto import detection_pb2
+from google.cloud.automl_v1beta1.proto import geometry_pb2
+from google.cloud.automl_v1beta1.proto import image_pb2
+from google.cloud.automl_v1beta1.proto import io_pb2
+from google.cloud.automl_v1beta1.proto import model_evaluation_pb2
+from google.cloud.automl_v1beta1.proto import model_pb2
+from google.cloud.automl_v1beta1.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.automl_v1beta1.proto import prediction_service_pb2
+from google.cloud.automl_v1beta1.proto import ranges_pb2
+from google.cloud.automl_v1beta1.proto import regression_pb2
+from google.cloud.automl_v1beta1.proto import service_pb2
+from google.cloud.automl_v1beta1.proto import table_spec_pb2
+from google.cloud.automl_v1beta1.proto import tables_pb2
+from google.cloud.automl_v1beta1.proto import temporal_pb2
+from google.cloud.automl_v1beta1.proto import text_extraction_pb2
+from google.cloud.automl_v1beta1.proto import text_pb2
+from google.cloud.automl_v1beta1.proto import text_segment_pb2
+from google.cloud.automl_v1beta1.proto import text_sentiment_pb2
+from google.cloud.automl_v1beta1.proto import translation_pb2
+from google.cloud.automl_v1beta1.proto import video_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    longrunning_operations_pb2,
+    any_pb2,
+    duration_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [
+    annotation_payload_pb2,
+    annotation_spec_pb2,
+    classification_pb2,
+    column_spec_pb2,
+    data_items_pb2,
+    data_stats_pb2,
+    data_types_pb2,
+    dataset_pb2,
+    detection_pb2,
+    geometry_pb2,
+    image_pb2,
+    io_pb2,
+    model_evaluation_pb2,
+    model_pb2,
+    proto_operations_pb2,
+    prediction_service_pb2,
+    ranges_pb2,
+    regression_pb2,
+    service_pb2,
+    table_spec_pb2,
+    tables_pb2,
+    temporal_pb2,
+    text_extraction_pb2,
+    text_pb2,
+    text_segment_pb2,
+    text_sentiment_pb2,
+    translation_pb2,
+    video_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.automl_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/automl/noxfile.py b/automl/noxfile.py
new file mode 100644
index 000000000000..19fb3148ffd8
--- /dev/null
+++ b/automl/noxfile.py
@@ -0,0 +1,162 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+    session.install("-e", ".[pandas,storage]")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+    session.install("-e", ".[pandas,storage]")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=83")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/automl/setup.cfg b/automl/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/automl/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/automl/setup.py b/automl/setup.py
new file mode 100644
index 000000000000..c76f945594e8
--- /dev/null
+++ b/automl/setup.py
@@ -0,0 +1,78 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-automl"
+description = "Cloud AutoML API client library"
+version = "0.5.0"
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+extras = {
+    "pandas": ["pandas>=0.24.0"],
+    "storage": ["google-cloud-storage >= 1.18.0, < 2.0.0dev"],
+}
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@oogle.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/automl/synth.metadata b/automl/synth.metadata
new file mode 100644
index 000000000000..7cf7214eecc8
--- /dev/null
+++ b/automl/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-26T23:45:30.964132Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.35.0",
+        "dockerImage": "googleapis/artman@sha256:97ef134b6b1cc2c21868960d3b4352524023fb25b61fc137ca0783ce3c08c2cd"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "650caad718bb063f189405c23972dc9818886358",
+        "internalRef": "265565344"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "automl",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/automl/artman_automl_v1beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/automl/synth.py b/automl/synth.py
new file mode 100644
index 000000000000..06407e9fa019
--- /dev/null
+++ b/automl/synth.py
@@ -0,0 +1,115 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import re
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1"]
+
+
+# ----------------------------------------------------------------------------
+# Generate automl GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("automl", version, include_protos=True)
+    s.move(library / f"google/cloud/automl_{version}")
+    s.move(library / f"tests/unit/gapic/{version}")
+    s.move(library / f"docs/gapic/{version}")
+
+s.move(library / f"docs/conf.py")
+
+# Use the highest version library to generate import alias.
+s.move(library / "google/cloud/automl.py")
+
+# Add tables client to v1beta1
+s.replace(
+    f"google/cloud/automl_v1beta1/__init__.py",
+    f"from google.cloud.automl_v1beta1.gapic import prediction_service_client",
+    f"from google.cloud.automl_v1beta1.gapic import prediction_service_client\n"
+    f"from google.cloud.automl_v1beta1.tables import tables_client"
+    f"\n\n"
+    f"class TablesClient(tables_client.TablesClient):"
+    f"    __doc__ = tables_client.TablesClient.__doc__",
+)
+
+s.replace(
+    f"google/cloud/automl_v1beta1/__init__.py",
+    f"""__all__ = \(
+    'enums',
+    'types',
+    'AutoMlClient',
+    'PredictionServiceClient',
+\)""",
+    f'__all__ = ("enums", "types", "AutoMlClient", "PredictionServiceClient", "TablesClient")',
+)
+
+# Fixup issues in generated code
+s.replace(
+    "**/gapic/*_client.py",
+    r"metadata_type=operations_pb2.OperationMetadata",
+    r"metadata_type=proto_operations_pb2.OperationMetadata",
+)
+
+# Fix spacing/'::' issues in docstrings
+s.replace(
+    "google/cloud/automl_v1beta1/gapic/prediction_service_client.py", "^\s+::", ""
+)
+
+s.replace(
+    "google/cloud/automl_v1beta1/gapic/auto_ml_client.py",
+    "^(\s+)(::)\n\n\s+?([^\s])",
+    "    \g<1>\g<2>\n    \g<1>\g<3>",
+)
+
+# Remove 'raw-latex' sections with sample JSON Lines files
+s.replace(
+    "google/cloud/**/io_pb2.py",
+    r"""Sample in-line
+     JSON Lines file.*?\}`\n""",
+    "\n",
+    flags=re.DOTALL,
+)
+
+# Remove 'raw-latex' sections with sample JSON Lines files
+s.replace(
+    "google/cloud/**/io_pb2.py",
+    r"""Sample
+     in-line JSON Lines.*?(\n\s+-\s+For Text Classification.*\n)""",
+    "\g<1>",
+    flags=re.DOTALL,
+)
+
+# Replace docstring with no summary line
+s.replace(
+    "google/cloud/**/io_pb2.py",
+    r"""__doc__ = \"\"\"-  For Translation: CSV file ``translation\.csv``, with each """,
+    r'''__doc__ = """
+-  For Translation: CSV file ``translation.csv``, with each ''',
+    flags=re.DOTALL,
+)
+
+s.replace("google/cloud/**/io_pb2.py", r":raw-latex:`\\t `", r"\\\\t")
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=82, cov_level=83)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/automl/tests/system/gapic/v1beta1/test_system_tables_client_v1.py b/automl/tests/system/gapic/v1beta1/test_system_tables_client_v1.py
new file mode 100644
index 000000000000..01c49541dc70
--- /dev/null
+++ b/automl/tests/system/gapic/v1beta1/test_system_tables_client_v1.py
@@ -0,0 +1,294 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import pandas
+import pytest
+import random
+import string
+import time
+import unittest
+
+from google.cloud import automl_v1beta1
+from google.api_core import exceptions
+from google.cloud.automl_v1beta1.gapic import enums
+
+PROJECT = os.environ["PROJECT_ID"]
+REGION = "us-central1"
+MAX_WAIT_TIME_SECONDS = 30
+MAX_SLEEP_TIME_SECONDS = 5
+STATIC_DATASET = "test_dataset_do_not_delete"
+STATIC_MODEL = "test_model_do_not_delete"
+RUNNING_IN_VPCSC = os.getenv("GOOGLE_CLOUD_TESTS_IN_VPCSC", "").lower() == "true"
+
+ID = "{rand}_{time}".format(
+    rand="".join(
+        [random.choice(string.ascii_letters + string.digits) for n in range(4)]
+    ),
+    time=int(time.time()),
+)
+
+
+def _id(name):
+    return "{}_{}".format(name, ID)
+
+
+class TestSystemTablesClient(object):
+    def cancel_and_wait(self, op):
+        op.cancel()
+        start = time.time()
+        sleep_time = 1
+        while time.time() - start < MAX_WAIT_TIME_SECONDS:
+            if op.cancelled():
+                return
+            time.sleep(sleep_time)
+            sleep_time = min(sleep_time * 2, MAX_SLEEP_TIME_SECONDS)
+        assert op.cancelled()
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_list_datasets(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        # will raise if not found
+        next(
+            iter(
+                [d for d in client.list_datasets(timeout=10) if d.name == dataset.name]
+            )
+        )
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_list_models(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        model = self.ensure_model_ready(client)
+        # will raise if not found
+        next(iter([m for m in client.list_models(timeout=10) if m.name == model.name]))
+
+    def test_create_delete_dataset(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        display_name = _id("t_cr_dl")
+        dataset = client.create_dataset(display_name)
+        assert dataset is not None
+        assert (
+            dataset.name == client.get_dataset(dataset_display_name=display_name).name
+        )
+        client.delete_dataset(dataset=dataset)
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_import_data(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        display_name = _id("t_import")
+        dataset = client.create_dataset(display_name)
+        op = client.import_data(
+            dataset=dataset,
+            gcs_input_uris="gs://cloud-ml-tables-data/bank-marketing.csv",
+        )
+        self.cancel_and_wait(op)
+        client.delete_dataset(dataset=dataset)
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_import_pandas_dataframe(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        display_name = _id("t_import_pandas")
+        dataset = client.create_dataset(display_name)
+        dataframe = pandas.DataFrame({"test-col1": [1, 2], "test-col2": [3, 4]})
+        op = client.import_data(
+            project=PROJECT, dataset=dataset, pandas_dataframe=dataframe
+        )
+        self.cancel_and_wait(op)
+        client.delete_dataset(dataset=dataset)
+
+    def ensure_dataset_ready(self, client):
+        dataset = None
+        try:
+            dataset = client.get_dataset(dataset_display_name=STATIC_DATASET)
+        except exceptions.NotFound:
+            dataset = client.create_dataset(STATIC_DATASET)
+
+        if dataset.example_count is None or dataset.example_count == 0:
+            op = client.import_data(
+                dataset=dataset,
+                gcs_input_uris="gs://cloud-ml-tables-data/bank-marketing.csv",
+            )
+            op.result()
+            dataset = client.get_dataset(dataset_name=dataset.name)
+
+        return dataset
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_list_column_specs(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        # will raise if not found
+        next(
+            iter(
+                [
+                    d
+                    for d in client.list_column_specs(dataset=dataset)
+                    if d.display_name == "Deposit"
+                ]
+            )
+        )
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_get_column_spec(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        name = [d for d in client.list_column_specs(dataset=dataset)][0].name
+        assert client.get_column_spec(name).name == name
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_list_table_specs(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        name = [d for d in client.list_table_specs(dataset=dataset)][0].name
+        assert client.get_table_spec(name).name == name
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_set_column_nullable(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        client.update_column_spec(
+            dataset=dataset, column_spec_display_name="POutcome", nullable=True
+        )
+        columns = {c.display_name: c for c in client.list_column_specs(dataset=dataset)}
+        assert columns["POutcome"].data_type.nullable == True
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_set_target_column(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        client.set_target_column(dataset=dataset, column_spec_display_name="Age")
+        columns = {c.display_name: c for c in client.list_column_specs(dataset=dataset)}
+        dataset = client.get_dataset(dataset_name=dataset.name)
+        metadata = dataset.tables_dataset_metadata
+        assert columns["Age"].name.endswith(
+            "/{}".format(metadata.target_column_spec_id)
+        )
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_set_weight_column(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        client.set_weight_column(dataset=dataset, column_spec_display_name="Duration")
+        columns = {c.display_name: c for c in client.list_column_specs(dataset=dataset)}
+        dataset = client.get_dataset(dataset_name=dataset.name)
+        metadata = dataset.tables_dataset_metadata
+        assert columns["Duration"].name.endswith(
+            "/{}".format(metadata.weight_column_spec_id)
+        )
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_set_weight_and_target_column(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        client.set_weight_column(dataset=dataset, column_spec_display_name="Day")
+        client.set_target_column(dataset=dataset, column_spec_display_name="Campaign")
+        columns = {c.display_name: c for c in client.list_column_specs(dataset=dataset)}
+        dataset = client.get_dataset(dataset_name=dataset.name)
+        metadata = dataset.tables_dataset_metadata
+        assert columns["Day"].name.endswith(
+            "/{}".format(metadata.weight_column_spec_id)
+        )
+        assert columns["Campaign"].name.endswith(
+            "/{}".format(metadata.target_column_spec_id)
+        )
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_create_delete_model(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        dataset = self.ensure_dataset_ready(client)
+        client.set_target_column(dataset=dataset, column_spec_display_name="Deposit")
+        display_name = _id("t_cr_dl")
+        op = client.create_model(
+            display_name, dataset=dataset, train_budget_milli_node_hours=1000
+        )
+        self.cancel_and_wait(op)
+        client.delete_model(model_display_name=display_name)
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_list_model_evaluations(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        model = self.ensure_model_online(client)
+        # will raise if not found
+        next(
+            iter(
+                [
+                    m
+                    for m in client.list_model_evaluations(model=model)
+                    if m.display_name is not None
+                ]
+            )
+        )
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_get_model_evaluation(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        model = self.ensure_model_online(client)
+        name = [m for m in client.list_model_evaluations(model=model)][0].name
+        assert client.get_model_evaluation(model_evaluation_name=name).name == name
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_online_predict(self):
+        client = automl_v1beta1.TablesClient(project=PROJECT, region=REGION)
+        model = self.ensure_model_online(client)
+        result = client.predict(
+            inputs={
+                "Age": 31,
+                "Balance": 200,
+                "Campaign": 2,
+                "Contact": "cellular",
+                "Day": 4,
+                "Default": "no",
+                "Duration": 12,
+                "Education": "primary",
+                "Housing": "yes",
+                "Job": "blue-collar",
+                "Loan": "no",
+                "MaritalStatus": "divorced",
+                "Month": "jul",
+                "PDays": 4,
+                "POutcome": None,
+                "Previous": 12,
+            },
+            model=model,
+        )
+        assert result is not None
+
+    def ensure_model_online(self, client):
+        model = self.ensure_model_ready(client)
+        if model.deployment_state != enums.Model.DeploymentState.DEPLOYED:
+            client.deploy_model(model=model).result()
+
+        return client.get_model(model_name=model.name)
+
+    def ensure_model_ready(self, client):
+        try:
+            return client.get_model(model_display_name=STATIC_MODEL)
+        except exceptions.NotFound:
+            pass
+
+        dataset = self.ensure_dataset_ready(client)
+        client.set_target_column(dataset=dataset, column_spec_display_name="Deposit")
+        client.clear_weight_column(dataset=dataset)
+        client.clear_test_train_column(dataset=dataset)
+        client.update_column_spec(
+            dataset=dataset, column_spec_display_name="POutcome", nullable=True
+        )
+        op = client.create_model(
+            STATIC_MODEL, dataset=dataset, train_budget_milli_node_hours=1000
+        )
+        op.result()
+        return client.get_model(model_display_name=STATIC_MODEL)
diff --git a/automl/tests/unit/gapic/v1beta1/test_auto_ml_client_v1beta1.py b/automl/tests/unit/gapic/v1beta1/test_auto_ml_client_v1beta1.py
new file mode 100644
index 000000000000..e3a5ce12f7cf
--- /dev/null
+++ b/automl/tests/unit/gapic/v1beta1/test_auto_ml_client_v1beta1.py
@@ -0,0 +1,1255 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import automl_v1beta1
+from google.cloud.automl_v1beta1.proto import annotation_spec_pb2
+from google.cloud.automl_v1beta1.proto import column_spec_pb2
+from google.cloud.automl_v1beta1.proto import dataset_pb2
+from google.cloud.automl_v1beta1.proto import io_pb2
+from google.cloud.automl_v1beta1.proto import model_evaluation_pb2
+from google.cloud.automl_v1beta1.proto import model_pb2
+from google.cloud.automl_v1beta1.proto import service_pb2
+from google.cloud.automl_v1beta1.proto import table_spec_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestAutoMlClient(object):
+    def test_create_dataset(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        etag = "etag3123477"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "etag": etag,
+        }
+        expected_response = dataset_pb2.Dataset(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        dataset = {}
+
+        response = client.create_dataset(parent, dataset)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.CreateDatasetRequest(
+            parent=parent, dataset=dataset
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        dataset = {}
+
+        with pytest.raises(CustomException):
+            client.create_dataset(parent, dataset)
+
+    def test_update_dataset(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        etag = "etag3123477"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "etag": etag,
+        }
+        expected_response = dataset_pb2.Dataset(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        dataset = {}
+
+        response = client.update_dataset(dataset)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UpdateDatasetRequest(dataset=dataset)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        dataset = {}
+
+        with pytest.raises(CustomException):
+            client.update_dataset(dataset)
+
+    def test_get_dataset(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        etag = "etag3123477"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "etag": etag,
+        }
+        expected_response = dataset_pb2.Dataset(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+
+        response = client.get_dataset(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetDatasetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+
+        with pytest.raises(CustomException):
+            client.get_dataset(name)
+
+    def test_list_datasets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        datasets_element = {}
+        datasets = [datasets_element]
+        expected_response = {"next_page_token": next_page_token, "datasets": datasets}
+        expected_response = service_pb2.ListDatasetsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_datasets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.datasets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListDatasetsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_datasets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_datasets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_dataset(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_dataset", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+
+        response = client.delete_dataset(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.DeleteDatasetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_dataset_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_dataset_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+
+        response = client.delete_dataset(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_import_data(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_import_data", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+        input_config = {}
+
+        response = client.import_data(name, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ImportDataRequest(
+            name=name, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_data_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_import_data_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+        input_config = {}
+
+        response = client.import_data(name, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_export_data(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_data", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+        output_config = {}
+
+        response = client.export_data(name, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ExportDataRequest(
+            name=name, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_data_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_data_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+        output_config = {}
+
+        response = client.export_data(name, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_create_model(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        dataset_id = "datasetId-2115646910"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "dataset_id": dataset_id,
+        }
+        expected_response = model_pb2.Model(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_model", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        model = {}
+
+        response = client.create_model(parent, model)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.CreateModelRequest(parent=parent, model=model)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_model_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_model_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        model = {}
+
+        response = client.create_model(parent, model)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_model(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        dataset_id = "datasetId-2115646910"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "dataset_id": dataset_id,
+        }
+        expected_response = model_pb2.Model(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.get_model(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetModelRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_model_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        with pytest.raises(CustomException):
+            client.get_model(name)
+
+    def test_list_models(self):
+        # Setup Expected Response
+        next_page_token = ""
+        model_element = {}
+        model = [model_element]
+        expected_response = {"next_page_token": next_page_token, "model": model}
+        expected_response = service_pb2.ListModelsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_models(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.model[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListModelsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_models_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_models(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_model(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_model", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.delete_model(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.DeleteModelRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_model_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_model_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.delete_model(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_deploy_model(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_deploy_model", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.deploy_model(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.DeployModelRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_deploy_model_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_deploy_model_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.deploy_model(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_undeploy_model(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_undeploy_model", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.undeploy_model(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UndeployModelRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_undeploy_model_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_undeploy_model_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        response = client.undeploy_model(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_model_evaluation(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        annotation_spec_id = "annotationSpecId60690191"
+        display_name = "displayName1615086568"
+        evaluated_example_count = 277565350
+        expected_response = {
+            "name": name_2,
+            "annotation_spec_id": annotation_spec_id,
+            "display_name": display_name,
+            "evaluated_example_count": evaluated_example_count,
+        }
+        expected_response = model_evaluation_pb2.ModelEvaluation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_evaluation_path(
+            "[PROJECT]", "[LOCATION]", "[MODEL]", "[MODEL_EVALUATION]"
+        )
+
+        response = client.get_model_evaluation(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetModelEvaluationRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_model_evaluation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        name = client.model_evaluation_path(
+            "[PROJECT]", "[LOCATION]", "[MODEL]", "[MODEL_EVALUATION]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_model_evaluation(name)
+
+    def test_export_model(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_model", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        output_config = {}
+
+        response = client.export_model(name, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ExportModelRequest(
+            name=name, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_model_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_model_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        output_config = {}
+
+        response = client.export_model(name, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_export_evaluated_examples(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_evaluated_examples", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        output_config = {}
+
+        response = client.export_evaluated_examples(name, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ExportEvaluatedExamplesRequest(
+            name=name, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_evaluated_examples_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_evaluated_examples_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        output_config = {}
+
+        response = client.export_evaluated_examples(name, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_list_model_evaluations(self):
+        # Setup Expected Response
+        next_page_token = ""
+        model_evaluation_element = {}
+        model_evaluation = [model_evaluation_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "model_evaluation": model_evaluation,
+        }
+        expected_response = service_pb2.ListModelEvaluationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        paged_list_response = client.list_model_evaluations(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.model_evaluation[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListModelEvaluationsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_model_evaluations_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        parent = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+
+        paged_list_response = client.list_model_evaluations(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_annotation_spec(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        example_count = 1517063674
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "example_count": example_count,
+        }
+        expected_response = annotation_spec_pb2.AnnotationSpec(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.annotation_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[ANNOTATION_SPEC]"
+        )
+
+        response = client.get_annotation_spec(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetAnnotationSpecRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_annotation_spec_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        name = client.annotation_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[ANNOTATION_SPEC]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_annotation_spec(name)
+
+    def test_get_table_spec(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        time_column_spec_id = "timeColumnSpecId1558734824"
+        row_count = 1340416618
+        valid_row_count = 406068761
+        column_count = 122671386
+        etag = "etag3123477"
+        expected_response = {
+            "name": name_2,
+            "time_column_spec_id": time_column_spec_id,
+            "row_count": row_count,
+            "valid_row_count": valid_row_count,
+            "column_count": column_count,
+            "etag": etag,
+        }
+        expected_response = table_spec_pb2.TableSpec(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.table_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]"
+        )
+
+        response = client.get_table_spec(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetTableSpecRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_table_spec_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        name = client.table_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_table_spec(name)
+
+    def test_list_table_specs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        table_specs_element = {}
+        table_specs = [table_specs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "table_specs": table_specs,
+        }
+        expected_response = service_pb2.ListTableSpecsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+
+        paged_list_response = client.list_table_specs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.table_specs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListTableSpecsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_table_specs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        parent = client.dataset_path("[PROJECT]", "[LOCATION]", "[DATASET]")
+
+        paged_list_response = client.list_table_specs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_table_spec(self):
+        # Setup Expected Response
+        name = "name3373707"
+        time_column_spec_id = "timeColumnSpecId1558734824"
+        row_count = 1340416618
+        valid_row_count = 406068761
+        column_count = 122671386
+        etag = "etag3123477"
+        expected_response = {
+            "name": name,
+            "time_column_spec_id": time_column_spec_id,
+            "row_count": row_count,
+            "valid_row_count": valid_row_count,
+            "column_count": column_count,
+            "etag": etag,
+        }
+        expected_response = table_spec_pb2.TableSpec(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        table_spec = {}
+
+        response = client.update_table_spec(table_spec)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UpdateTableSpecRequest(table_spec=table_spec)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_table_spec_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        table_spec = {}
+
+        with pytest.raises(CustomException):
+            client.update_table_spec(table_spec)
+
+    def test_get_column_spec(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        etag = "etag3123477"
+        expected_response = {"name": name_2, "display_name": display_name, "etag": etag}
+        expected_response = column_spec_pb2.ColumnSpec(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        name = client.column_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]", "[COLUMN_SPEC]"
+        )
+
+        response = client.get_column_spec(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetColumnSpecRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_column_spec_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        name = client.column_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]", "[COLUMN_SPEC]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_column_spec(name)
+
+    def test_list_column_specs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        column_specs_element = {}
+        column_specs = [column_specs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "column_specs": column_specs,
+        }
+        expected_response = service_pb2.ListColumnSpecsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        parent = client.table_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]"
+        )
+
+        paged_list_response = client.list_column_specs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.column_specs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListColumnSpecsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_column_specs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        parent = client.table_spec_path(
+            "[PROJECT]", "[LOCATION]", "[DATASET]", "[TABLE_SPEC]"
+        )
+
+        paged_list_response = client.list_column_specs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_column_spec(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        etag = "etag3123477"
+        expected_response = {"name": name, "display_name": display_name, "etag": etag}
+        expected_response = column_spec_pb2.ColumnSpec(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup Request
+        column_spec = {}
+
+        response = client.update_column_spec(column_spec)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UpdateColumnSpecRequest(column_spec=column_spec)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_column_spec_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.AutoMlClient()
+
+        # Setup request
+        column_spec = {}
+
+        with pytest.raises(CustomException):
+            client.update_column_spec(column_spec)
diff --git a/automl/tests/unit/gapic/v1beta1/test_gcs_client_v1beta1.py b/automl/tests/unit/gapic/v1beta1/test_gcs_client_v1beta1.py
new file mode 100644
index 000000000000..49d4a0f85423
--- /dev/null
+++ b/automl/tests/unit/gapic/v1beta1/test_gcs_client_v1beta1.py
@@ -0,0 +1,152 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pandas
+import pytest
+import re
+
+from google.api_core import exceptions
+from google.cloud import automl_v1beta1
+
+
+class TestGcsClient(object):
+    def gcs_client(self, bucket_name=None, client_attrs={}):
+        client_mock = mock.Mock(**client_attrs)
+        return automl_v1beta1.tables.gcs_client.GcsClient(
+            bucket_name=bucket_name, client=client_mock
+        )
+
+    def test_ensure_bucket_exists(self):
+        mock_bucket = mock.Mock()
+        gcs_client = self.gcs_client(
+            client_attrs={
+                "get_bucket.side_effect": exceptions.NotFound("err"),
+                "bucket.return_value": mock_bucket,
+            }
+        )
+        returned_bucket_name = gcs_client.ensure_bucket_exists(
+            "my-project", "us-central1"
+        )
+        gcs_client.client.get_bucket.assert_called_with(
+            "my-project-automl-tables-staging"
+        )
+        gcs_client.client.bucket.assert_called_with("my-project-automl-tables-staging")
+        mock_bucket.create.assert_called_with(
+            project="my-project", location="us-central1"
+        )
+        assert returned_bucket_name == "my-project-automl-tables-staging"
+
+    def test_ensure_bucket_exists_bucket_already_exists_in_different_project(self):
+        mock_bucket = mock.Mock()
+        gcs_client = self.gcs_client(
+            client_attrs={
+                "get_bucket.side_effect": exceptions.Forbidden("err"),
+                "bucket.return_value": mock_bucket,
+            }
+        )
+        returned_bucket_name = gcs_client.ensure_bucket_exists(
+            "my-project", "us-central1"
+        )
+        gcs_client.client.get_bucket.assert_called_with(
+            "my-project-automl-tables-staging"
+        )
+        gcs_client.client.bucket.assert_called_with(returned_bucket_name)
+        mock_bucket.create.assert_called_with(
+            project="my-project", location="us-central1"
+        )
+
+        assert re.match(
+            "^my-project-automl-tables-staging-[0-9]*$", returned_bucket_name
+        )
+
+    def test_ensure_bucket_exists_bucket_already_exists_in_current_project(self):
+        gcs_client = self.gcs_client()
+        returned_bucket_name = gcs_client.ensure_bucket_exists(
+            "my-project", "us-central1"
+        )
+        gcs_client.client.get_bucket.assert_called_with(
+            "my-project-automl-tables-staging"
+        )
+        gcs_client.client.bucket.assert_not_called()
+        assert returned_bucket_name == "my-project-automl-tables-staging"
+
+    def test_ensure_bucket_exists_custom_bucket_name(self):
+        mock_bucket = mock.Mock()
+        gcs_client = self.gcs_client(
+            bucket_name="my-bucket",
+            client_attrs={
+                "get_bucket.side_effect": exceptions.NotFound("err"),
+                "bucket.return_value": mock_bucket,
+            },
+        )
+        returned_bucket_name = gcs_client.ensure_bucket_exists(
+            "my-project", "us-central1"
+        )
+        gcs_client.client.get_bucket.assert_called_with("my-bucket")
+        gcs_client.client.bucket.assert_called_with("my-bucket")
+        mock_bucket.create.assert_called_with(
+            project="my-project", location="us-central1"
+        )
+        assert returned_bucket_name == "my-bucket"
+
+    def test_upload_pandas_dataframe(self):
+        mock_blob = mock.Mock()
+        mock_bucket = mock.Mock(**{"blob.return_value": mock_blob})
+        gcs_client = self.gcs_client(
+            bucket_name="my-bucket",
+            client_attrs={"get_bucket.return_value": mock_bucket},
+        )
+        dataframe = pandas.DataFrame({"col1": [1, 2], "col2": [3, 4]})
+
+        gcs_uri = gcs_client.upload_pandas_dataframe(dataframe, "my-file.csv")
+
+        gcs_client.client.get_bucket.assert_called_with("my-bucket")
+        mock_bucket.blob.assert_called_with("my-file.csv")
+        mock_blob.upload_from_string.assert_called_with(",col1,col2\n0,1,3\n1,2,4\n")
+        assert gcs_uri == "gs://my-bucket/my-file.csv"
+
+    def test_upload_pandas_dataframe_no_csv_name(self):
+        mock_blob = mock.Mock()
+        mock_bucket = mock.Mock(**{"blob.return_value": mock_blob})
+        gcs_client = self.gcs_client(
+            bucket_name="my-bucket",
+            client_attrs={"get_bucket.return_value": mock_bucket},
+        )
+        dataframe = pandas.DataFrame({"col1": [1, 2], "col2": [3, 4]})
+
+        gcs_uri = gcs_client.upload_pandas_dataframe(dataframe)
+        generated_csv_name = gcs_uri.split("/")[-1]
+
+        gcs_client.client.get_bucket.assert_called_with("my-bucket")
+        mock_bucket.blob.assert_called_with(generated_csv_name)
+        mock_blob.upload_from_string.assert_called_with(",col1,col2\n0,1,3\n1,2,4\n")
+        assert re.match("^gs://my-bucket/automl-tables-dataframe-[0-9]*.csv$", gcs_uri)
+
+    def test_upload_pandas_dataframe_not_type_dataframe(self):
+        gcs_client = self.gcs_client()
+        with pytest.raises(ValueError):
+            gcs_client.upload_pandas_dataframe("my-dataframe")
+        gcs_client.client.upload_pandas_dataframe.assert_not_called()
+
+    def test_upload_pandas_dataframe_bucket_not_exist(self):
+        gcs_client = self.gcs_client()
+        dataframe = pandas.DataFrame({})
+        with pytest.raises(ValueError):
+            gcs_client.upload_pandas_dataframe(dataframe)
+        gcs_client.client.upload_pandas_dataframe.assert_not_called()
diff --git a/automl/tests/unit/gapic/v1beta1/test_prediction_service_client_v1beta1.py b/automl/tests/unit/gapic/v1beta1/test_prediction_service_client_v1beta1.py
new file mode 100644
index 000000000000..e3ab187f4644
--- /dev/null
+++ b/automl/tests/unit/gapic/v1beta1/test_prediction_service_client_v1beta1.py
@@ -0,0 +1,165 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import automl_v1beta1
+from google.cloud.automl_v1beta1.proto import data_items_pb2
+from google.cloud.automl_v1beta1.proto import io_pb2
+from google.cloud.automl_v1beta1.proto import prediction_service_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestPredictionServiceClient(object):
+    def test_predict(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = prediction_service_pb2.PredictResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.PredictionServiceClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        payload = {}
+
+        response = client.predict(name, payload)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = prediction_service_pb2.PredictRequest(
+            name=name, payload=payload
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_predict_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.PredictionServiceClient()
+
+        # Setup request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        payload = {}
+
+        with pytest.raises(CustomException):
+            client.predict(name, payload)
+
+    def test_batch_predict(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = prediction_service_pb2.BatchPredictResult(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_predict", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.PredictionServiceClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        input_config = {}
+        output_config = {}
+
+        response = client.batch_predict(name, input_config, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = prediction_service_pb2.BatchPredictRequest(
+            name=name, input_config=input_config, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_predict_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_predict_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = automl_v1beta1.PredictionServiceClient()
+
+        # Setup Request
+        name = client.model_path("[PROJECT]", "[LOCATION]", "[MODEL]")
+        input_config = {}
+        output_config = {}
+
+        response = client.batch_predict(name, input_config, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/automl/tests/unit/gapic/v1beta1/test_tables_client_v1beta1.py b/automl/tests/unit/gapic/v1beta1/test_tables_client_v1beta1.py
new file mode 100644
index 000000000000..aa1babfa8752
--- /dev/null
+++ b/automl/tests/unit/gapic/v1beta1/test_tables_client_v1beta1.py
@@ -0,0 +1,1319 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pandas
+import pytest
+
+from google.cloud import automl_v1beta1
+from google.api_core import exceptions
+from google.cloud.automl_v1beta1.proto import data_types_pb2
+
+PROJECT = "project"
+REGION = "region"
+LOCATION_PATH = "projects/{}/locations/{}".format(PROJECT, REGION)
+
+
+class TestTablesClient(object):
+    def tables_client(
+        self, client_attrs={}, prediction_client_attrs={}, gcs_client_attrs={}
+    ):
+        client_mock = mock.Mock(**client_attrs)
+        prediction_client_mock = mock.Mock(**prediction_client_attrs)
+        gcs_client_mock = mock.Mock(**gcs_client_attrs)
+        return automl_v1beta1.TablesClient(
+            client=client_mock,
+            prediction_client=prediction_client_mock,
+            gcs_client=gcs_client_mock,
+            project=PROJECT,
+            region=REGION,
+        )
+
+    def test_list_datasets_empty(self):
+        client = self.tables_client(
+            {
+                "list_datasets.return_value": [],
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        ds = client.list_datasets()
+        client.auto_ml_client.location_path.assert_called_with(PROJECT, REGION)
+        client.auto_ml_client.list_datasets.assert_called_with(LOCATION_PATH)
+        assert ds == []
+
+    def test_list_datasets_not_empty(self):
+        datasets = ["some_dataset"]
+        client = self.tables_client(
+            {
+                "list_datasets.return_value": datasets,
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        ds = client.list_datasets()
+        client.auto_ml_client.location_path.assert_called_with(PROJECT, REGION)
+        client.auto_ml_client.list_datasets.assert_called_with(LOCATION_PATH)
+        assert len(ds) == 1
+        assert ds[0] == "some_dataset"
+
+    def test_get_dataset_no_value(self):
+        dataset_actual = "dataset"
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            dataset = client.get_dataset()
+        client.auto_ml_client.get_dataset.assert_not_called()
+
+    def test_get_dataset_name(self):
+        dataset_actual = "dataset"
+        client = self.tables_client({"get_dataset.return_value": dataset_actual}, {})
+        dataset = client.get_dataset(dataset_name="my_dataset")
+        client.auto_ml_client.get_dataset.assert_called_with("my_dataset")
+        assert dataset == dataset_actual
+
+    def test_get_no_dataset(self):
+        client = self.tables_client(
+            {"get_dataset.side_effect": exceptions.NotFound("err")}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.get_dataset(dataset_name="my_dataset")
+        client.auto_ml_client.get_dataset.assert_called_with("my_dataset")
+
+    def test_get_dataset_from_empty_list(self):
+        client = self.tables_client({"list_datasets.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.get_dataset(dataset_display_name="my_dataset")
+
+    def test_get_dataset_from_list_not_found(self):
+        client = self.tables_client(
+            {"list_datasets.return_value": [mock.Mock(display_name="not_it")]}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.get_dataset(dataset_display_name="my_dataset")
+
+    def test_get_dataset_from_list(self):
+        client = self.tables_client(
+            {
+                "list_datasets.return_value": [
+                    mock.Mock(display_name="not_it"),
+                    mock.Mock(display_name="my_dataset"),
+                ]
+            },
+            {},
+        )
+        dataset = client.get_dataset(dataset_display_name="my_dataset")
+        assert dataset.display_name == "my_dataset"
+
+    def test_get_dataset_from_list_ambiguous(self):
+        client = self.tables_client(
+            {
+                "list_datasets.return_value": [
+                    mock.Mock(display_name="my_dataset"),
+                    mock.Mock(display_name="not_my_dataset"),
+                    mock.Mock(display_name="my_dataset"),
+                ]
+            },
+            {},
+        )
+        with pytest.raises(ValueError):
+            client.get_dataset(dataset_display_name="my_dataset")
+
+    def test_create_dataset(self):
+        client = self.tables_client(
+            {
+                "location_path.return_value": LOCATION_PATH,
+                "create_dataset.return_value": mock.Mock(display_name="name"),
+            },
+            {},
+        )
+        metadata = {"metadata": "values"}
+        dataset = client.create_dataset("name", metadata=metadata)
+        client.auto_ml_client.location_path.assert_called_with(PROJECT, REGION)
+        client.auto_ml_client.create_dataset.assert_called_with(
+            LOCATION_PATH, {"display_name": "name", "tables_dataset_metadata": metadata}
+        )
+        assert dataset.display_name == "name"
+
+    def test_delete_dataset(self):
+        dataset = mock.Mock()
+        dataset.configure_mock(name="name")
+        client = self.tables_client({"delete_dataset.return_value": None}, {})
+        client.delete_dataset(dataset=dataset)
+        client.auto_ml_client.delete_dataset.assert_called_with("name")
+
+    def test_delete_dataset_not_found(self):
+        client = self.tables_client({"list_datasets.return_value": []}, {})
+        client.delete_dataset(dataset_display_name="not_found")
+        client.auto_ml_client.delete_dataset.assert_not_called()
+
+    def test_delete_dataset_name(self):
+        client = self.tables_client({"delete_dataset.return_value": None}, {})
+        client.delete_dataset(dataset_name="name")
+        client.auto_ml_client.delete_dataset.assert_called_with("name")
+
+    def test_export_not_found(self):
+        client = self.tables_client({"list_datasets.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.export_data(dataset_display_name="name", gcs_input_uris="uri")
+
+        client.auto_ml_client.export_data.assert_not_called()
+
+    def test_export_gcs_uri(self):
+        client = self.tables_client({"export_data.return_value": None}, {})
+        client.export_data(dataset_name="name", gcs_output_uri_prefix="uri")
+        client.auto_ml_client.export_data.assert_called_with(
+            "name", {"gcs_destination": {"output_uri_prefix": "uri"}}
+        )
+
+    def test_export_bq_uri(self):
+        client = self.tables_client({"export_data.return_value": None}, {})
+        client.export_data(dataset_name="name", bigquery_output_uri="uri")
+        client.auto_ml_client.export_data.assert_called_with(
+            "name", {"bigquery_destination": {"output_uri": "uri"}}
+        )
+
+    def test_import_not_found(self):
+        client = self.tables_client({"list_datasets.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.import_data(dataset_display_name="name", gcs_input_uris="uri")
+
+        client.auto_ml_client.import_data.assert_not_called()
+
+    def test_import_pandas_dataframe(self):
+        client = self.tables_client(
+            gcs_client_attrs={
+                "bucket_name": "my_bucket",
+                "upload_pandas_dataframe.return_value": "uri",
+            }
+        )
+        dataframe = pandas.DataFrame({})
+        client.import_data(
+            project=PROJECT,
+            region=REGION,
+            dataset_name="name",
+            pandas_dataframe=dataframe,
+        )
+        client.gcs_client.ensure_bucket_exists.assert_called_with(PROJECT, REGION)
+        client.gcs_client.upload_pandas_dataframe.assert_called_with(dataframe)
+        client.auto_ml_client.import_data.assert_called_with(
+            "name", {"gcs_source": {"input_uris": ["uri"]}}
+        )
+
+    def test_import_gcs_uri(self):
+        client = self.tables_client({"import_data.return_value": None}, {})
+        client.import_data(dataset_name="name", gcs_input_uris="uri")
+        client.auto_ml_client.import_data.assert_called_with(
+            "name", {"gcs_source": {"input_uris": ["uri"]}}
+        )
+
+    def test_import_gcs_uris(self):
+        client = self.tables_client({"import_data.return_value": None}, {})
+        client.import_data(dataset_name="name", gcs_input_uris=["uri", "uri"])
+        client.auto_ml_client.import_data.assert_called_with(
+            "name", {"gcs_source": {"input_uris": ["uri", "uri"]}}
+        )
+
+    def test_import_bq_uri(self):
+        client = self.tables_client({"import_data.return_value": None}, {})
+        client.import_data(dataset_name="name", bigquery_input_uri="uri")
+        client.auto_ml_client.import_data.assert_called_with(
+            "name", {"bigquery_source": {"input_uri": "uri"}}
+        )
+
+    def test_list_table_specs(self):
+        client = self.tables_client({"list_table_specs.return_value": None}, {})
+        client.list_table_specs(dataset_name="name")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+
+    def test_list_table_specs_not_found(self):
+        client = self.tables_client(
+            {"list_table_specs.side_effect": exceptions.NotFound("not found")}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.list_table_specs(dataset_name="name")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+
+    def test_get_table_spec(self):
+        client = self.tables_client({}, {})
+        client.get_table_spec("name")
+        client.auto_ml_client.get_table_spec.assert_called_with("name")
+
+    def test_get_column_spec(self):
+        client = self.tables_client({}, {})
+        client.get_column_spec("name")
+        client.auto_ml_client.get_column_spec.assert_called_with("name")
+
+    def test_list_column_specs(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [],
+            },
+            {},
+        )
+        client.list_column_specs(dataset_name="name")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+
+    def test_update_column_spec_not_found(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.update_column_spec(dataset_name="name", column_spec_name="column2")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_not_called()
+
+    def test_update_column_spec_display_name_not_found(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.update_column_spec(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_not_called()
+
+    def test_update_column_spec_name_no_args(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column/2", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.update_column_spec(dataset_name="name", column_spec_name="column/2")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_called_with(
+            {"name": "column/2", "data_type": {"type_code": "type_code"}}
+        )
+
+    def test_update_column_spec_no_args(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.update_column_spec(
+            dataset_name="name", column_spec_display_name="column"
+        )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_called_with(
+            {"name": "column", "data_type": {"type_code": "type_code"}}
+        )
+
+    def test_update_column_spec_nullable(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.update_column_spec(
+            dataset_name="name", column_spec_display_name="column", nullable=True
+        )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_called_with(
+            {
+                "name": "column",
+                "data_type": {"type_code": "type_code", "nullable": True},
+            }
+        )
+
+    def test_update_column_spec_type_code(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.update_column_spec(
+            dataset_name="name",
+            column_spec_display_name="column",
+            type_code="type_code2",
+        )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_called_with(
+            {"name": "column", "data_type": {"type_code": "type_code2"}}
+        )
+
+    def test_update_column_spec_type_code_nullable(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.update_column_spec(
+            dataset_name="name",
+            nullable=True,
+            column_spec_display_name="column",
+            type_code="type_code2",
+        )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_called_with(
+            {
+                "name": "column",
+                "data_type": {"type_code": "type_code2", "nullable": True},
+            }
+        )
+
+    def test_update_column_spec_type_code_nullable_false(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        data_type_mock = mock.Mock(type_code="type_code")
+        column_spec_mock.configure_mock(
+            name="column", display_name="column", data_type=data_type_mock
+        )
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.update_column_spec(
+            dataset_name="name",
+            nullable=False,
+            column_spec_display_name="column",
+            type_code="type_code2",
+        )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_column_spec.assert_called_with(
+            {
+                "name": "column",
+                "data_type": {"type_code": "type_code2", "nullable": False},
+            }
+        )
+
+    def test_set_target_column_table_not_found(self):
+        client = self.tables_client(
+            {"list_table_specs.side_effect": exceptions.NotFound("err")}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.set_target_column(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_not_called()
+        client.auto_ml_client.update_dataset.assert_not_called()
+
+    def test_set_target_column_not_found(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/1", display_name="column")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.set_target_column(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_dataset.assert_not_called()
+
+    def test_set_target_column(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/1", display_name="column")
+        dataset_mock = mock.Mock()
+        tables_dataset_metadata_mock = mock.Mock()
+        tables_dataset_metadata_mock.configure_mock(
+            target_column_spec_id="2",
+            weight_column_spec_id="2",
+            ml_use_column_spec_id="3",
+        )
+        dataset_mock.configure_mock(
+            name="dataset", tables_dataset_metadata=tables_dataset_metadata_mock
+        )
+        client = self.tables_client(
+            {
+                "get_dataset.return_value": dataset_mock,
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.set_target_column(dataset_name="name", column_spec_display_name="column")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_dataset.assert_called_with(
+            {
+                "name": "dataset",
+                "tables_dataset_metadata": {
+                    "target_column_spec_id": "1",
+                    "weight_column_spec_id": "2",
+                    "ml_use_column_spec_id": "3",
+                },
+            }
+        )
+
+    def test_set_weight_column_table_not_found(self):
+        client = self.tables_client(
+            {"list_table_specs.side_effect": exceptions.NotFound("err")}, {}
+        )
+        try:
+            client.set_weight_column(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        except exceptions.NotFound:
+            pass
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_not_called()
+        client.auto_ml_client.update_dataset.assert_not_called()
+
+    def test_set_weight_column_not_found(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/1", display_name="column")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.set_weight_column(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_dataset.assert_not_called()
+
+    def test_set_weight_column(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/2", display_name="column")
+        dataset_mock = mock.Mock()
+        tables_dataset_metadata_mock = mock.Mock()
+        tables_dataset_metadata_mock.configure_mock(
+            target_column_spec_id="1",
+            weight_column_spec_id="1",
+            ml_use_column_spec_id="3",
+        )
+        dataset_mock.configure_mock(
+            name="dataset", tables_dataset_metadata=tables_dataset_metadata_mock
+        )
+        client = self.tables_client(
+            {
+                "get_dataset.return_value": dataset_mock,
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.set_weight_column(dataset_name="name", column_spec_display_name="column")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_dataset.assert_called_with(
+            {
+                "name": "dataset",
+                "tables_dataset_metadata": {
+                    "target_column_spec_id": "1",
+                    "weight_column_spec_id": "2",
+                    "ml_use_column_spec_id": "3",
+                },
+            }
+        )
+
+    def test_clear_weight_column(self):
+        dataset_mock = mock.Mock()
+        tables_dataset_metadata_mock = mock.Mock()
+        tables_dataset_metadata_mock.configure_mock(
+            target_column_spec_id="1",
+            weight_column_spec_id="2",
+            ml_use_column_spec_id="3",
+        )
+        dataset_mock.configure_mock(
+            name="dataset", tables_dataset_metadata=tables_dataset_metadata_mock
+        )
+        client = self.tables_client({"get_dataset.return_value": dataset_mock}, {})
+        client.clear_weight_column(dataset_name="name")
+        client.auto_ml_client.update_dataset.assert_called_with(
+            {
+                "name": "dataset",
+                "tables_dataset_metadata": {
+                    "target_column_spec_id": "1",
+                    "weight_column_spec_id": None,
+                    "ml_use_column_spec_id": "3",
+                },
+            }
+        )
+
+    def test_set_test_train_column_table_not_found(self):
+        client = self.tables_client(
+            {"list_table_specs.side_effect": exceptions.NotFound("err")}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.set_test_train_column(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_not_called()
+        client.auto_ml_client.update_dataset.assert_not_called()
+
+    def test_set_test_train_column_not_found(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/1", display_name="column")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.set_test_train_column(
+                dataset_name="name", column_spec_display_name="column2"
+            )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_dataset.assert_not_called()
+
+    def test_set_test_train_column(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/3", display_name="column")
+        dataset_mock = mock.Mock()
+        tables_dataset_metadata_mock = mock.Mock()
+        tables_dataset_metadata_mock.configure_mock(
+            target_column_spec_id="1",
+            weight_column_spec_id="2",
+            ml_use_column_spec_id="2",
+        )
+        dataset_mock.configure_mock(
+            name="dataset", tables_dataset_metadata=tables_dataset_metadata_mock
+        )
+        client = self.tables_client(
+            {
+                "get_dataset.return_value": dataset_mock,
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.set_test_train_column(
+            dataset_name="name", column_spec_display_name="column"
+        )
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_dataset.assert_called_with(
+            {
+                "name": "dataset",
+                "tables_dataset_metadata": {
+                    "target_column_spec_id": "1",
+                    "weight_column_spec_id": "2",
+                    "ml_use_column_spec_id": "3",
+                },
+            }
+        )
+
+    def test_clear_test_train_column(self):
+        dataset_mock = mock.Mock()
+        tables_dataset_metadata_mock = mock.Mock()
+        tables_dataset_metadata_mock.configure_mock(
+            target_column_spec_id="1",
+            weight_column_spec_id="2",
+            ml_use_column_spec_id="2",
+        )
+        dataset_mock.configure_mock(
+            name="dataset", tables_dataset_metadata=tables_dataset_metadata_mock
+        )
+        client = self.tables_client({"get_dataset.return_value": dataset_mock}, {})
+        client.clear_test_train_column(dataset_name="name")
+        client.auto_ml_client.update_dataset.assert_called_with(
+            {
+                "name": "dataset",
+                "tables_dataset_metadata": {
+                    "target_column_spec_id": "1",
+                    "weight_column_spec_id": "2",
+                    "ml_use_column_spec_id": None,
+                },
+            }
+        )
+
+    def test_set_time_column(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/3", display_name="column")
+        dataset_mock = mock.Mock()
+        dataset_mock.configure_mock(name="dataset")
+        client = self.tables_client(
+            {
+                "get_dataset.return_value": dataset_mock,
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+            },
+            {},
+        )
+        client.set_time_column(dataset_name="name", column_spec_display_name="column")
+        client.auto_ml_client.list_table_specs.assert_called_with("name")
+        client.auto_ml_client.list_column_specs.assert_called_with("table")
+        client.auto_ml_client.update_table_spec.assert_called_with(
+            {"name": "table", "time_column_spec_id": "3"}
+        )
+
+    def test_clear_time_column(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        dataset_mock = mock.Mock()
+        dataset_mock.configure_mock(name="dataset")
+        client = self.tables_client(
+            {
+                "get_dataset.return_value": dataset_mock,
+                "list_table_specs.return_value": [table_spec_mock],
+            },
+            {},
+        )
+        client.clear_time_column(dataset_name="name")
+        client.auto_ml_client.update_table_spec.assert_called_with(
+            {"name": "table", "time_column_spec_id": None}
+        )
+
+    def test_get_model_evaluation(self):
+        client = self.tables_client({}, {})
+        ds = client.get_model_evaluation(model_evaluation_name="x")
+        client.auto_ml_client.get_model_evaluation.assert_called_with("x")
+
+    def test_list_model_evaluations_empty(self):
+        client = self.tables_client({"list_model_evaluations.return_value": []}, {})
+        ds = client.list_model_evaluations(model_name="model")
+        client.auto_ml_client.list_model_evaluations.assert_called_with("model")
+        assert ds == []
+
+    def test_list_model_evaluations_not_empty(self):
+        evaluations = ["eval"]
+        client = self.tables_client(
+            {
+                "list_model_evaluations.return_value": evaluations,
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        ds = client.list_model_evaluations(model_name="model")
+        client.auto_ml_client.list_model_evaluations.assert_called_with("model")
+        assert len(ds) == 1
+        assert ds[0] == "eval"
+
+    def test_list_models_empty(self):
+        client = self.tables_client(
+            {
+                "list_models.return_value": [],
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        ds = client.list_models()
+        client.auto_ml_client.location_path.assert_called_with(PROJECT, REGION)
+        client.auto_ml_client.list_models.assert_called_with(LOCATION_PATH)
+        assert ds == []
+
+    def test_list_models_not_empty(self):
+        models = ["some_model"]
+        client = self.tables_client(
+            {
+                "list_models.return_value": models,
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        ds = client.list_models()
+        client.auto_ml_client.location_path.assert_called_with(PROJECT, REGION)
+        client.auto_ml_client.list_models.assert_called_with(LOCATION_PATH)
+        assert len(ds) == 1
+        assert ds[0] == "some_model"
+
+    def test_get_model_name(self):
+        model_actual = "model"
+        client = self.tables_client({"get_model.return_value": model_actual}, {})
+        model = client.get_model(model_name="my_model")
+        client.auto_ml_client.get_model.assert_called_with("my_model")
+        assert model == model_actual
+
+    def test_get_no_model(self):
+        client = self.tables_client(
+            {"get_model.side_effect": exceptions.NotFound("err")}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.get_model(model_name="my_model")
+        client.auto_ml_client.get_model.assert_called_with("my_model")
+
+    def test_get_model_from_empty_list(self):
+        client = self.tables_client({"list_models.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.get_model(model_display_name="my_model")
+
+    def test_get_model_from_list_not_found(self):
+        client = self.tables_client(
+            {"list_models.return_value": [mock.Mock(display_name="not_it")]}, {}
+        )
+        with pytest.raises(exceptions.NotFound):
+            client.get_model(model_display_name="my_model")
+
+    def test_get_model_from_list(self):
+        client = self.tables_client(
+            {
+                "list_models.return_value": [
+                    mock.Mock(display_name="not_it"),
+                    mock.Mock(display_name="my_model"),
+                ]
+            },
+            {},
+        )
+        model = client.get_model(model_display_name="my_model")
+        assert model.display_name == "my_model"
+
+    def test_get_model_from_list_ambiguous(self):
+        client = self.tables_client(
+            {
+                "list_models.return_value": [
+                    mock.Mock(display_name="my_model"),
+                    mock.Mock(display_name="not_my_model"),
+                    mock.Mock(display_name="my_model"),
+                ]
+            },
+            {},
+        )
+        with pytest.raises(ValueError):
+            client.get_model(model_display_name="my_model")
+
+    def test_delete_model(self):
+        model = mock.Mock()
+        model.configure_mock(name="name")
+        client = self.tables_client({"delete_model.return_value": None}, {})
+        client.delete_model(model=model)
+        client.auto_ml_client.delete_model.assert_called_with("name")
+
+    def test_delete_model_not_found(self):
+        client = self.tables_client({"list_models.return_value": []}, {})
+        client.delete_model(model_display_name="not_found")
+        client.auto_ml_client.delete_model.assert_not_called()
+
+    def test_delete_model_name(self):
+        client = self.tables_client({"delete_model.return_value": None}, {})
+        client.delete_model(model_name="name")
+        client.auto_ml_client.delete_model.assert_called_with("name")
+
+    def test_deploy_model_no_args(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.deploy_model()
+        client.auto_ml_client.deploy_model.assert_not_called()
+
+    def test_deploy_model(self):
+        client = self.tables_client({}, {})
+        client.deploy_model(model_name="name")
+        client.auto_ml_client.deploy_model.assert_called_with("name")
+
+    def test_deploy_model_not_found(self):
+        client = self.tables_client({"list_models.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.deploy_model(model_display_name="name")
+        client.auto_ml_client.deploy_model.assert_not_called()
+
+    def test_undeploy_model(self):
+        client = self.tables_client({}, {})
+        client.undeploy_model(model_name="name")
+        client.auto_ml_client.undeploy_model.assert_called_with("name")
+
+    def test_undeploy_model_not_found(self):
+        client = self.tables_client({"list_models.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.undeploy_model(model_display_name="name")
+        client.auto_ml_client.undeploy_model.assert_not_called()
+
+    def test_create_model(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock = mock.Mock()
+        column_spec_mock.configure_mock(name="column/2", display_name="column")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [column_spec_mock],
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        client.create_model(
+            "my_model", dataset_name="my_dataset", train_budget_milli_node_hours=1000
+        )
+        client.auto_ml_client.create_model.assert_called_with(
+            LOCATION_PATH,
+            {
+                "display_name": "my_model",
+                "dataset_id": "my_dataset",
+                "tables_model_metadata": {"train_budget_milli_node_hours": 1000},
+            },
+        )
+
+    def test_create_model_include_columns(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock1 = mock.Mock()
+        column_spec_mock1.configure_mock(name="column/1", display_name="column1")
+        column_spec_mock2 = mock.Mock()
+        column_spec_mock2.configure_mock(name="column/2", display_name="column2")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [
+                    column_spec_mock1,
+                    column_spec_mock2,
+                ],
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        client.create_model(
+            "my_model",
+            dataset_name="my_dataset",
+            include_column_spec_names=["column1"],
+            train_budget_milli_node_hours=1000,
+        )
+        client.auto_ml_client.create_model.assert_called_with(
+            LOCATION_PATH,
+            {
+                "display_name": "my_model",
+                "dataset_id": "my_dataset",
+                "tables_model_metadata": {
+                    "train_budget_milli_node_hours": 1000,
+                    "input_feature_column_specs": [column_spec_mock1],
+                },
+            },
+        )
+
+    def test_create_model_exclude_columns(self):
+        table_spec_mock = mock.Mock()
+        # name is reserved in use of __init__, needs to be passed here
+        table_spec_mock.configure_mock(name="table")
+        column_spec_mock1 = mock.Mock()
+        column_spec_mock1.configure_mock(name="column/1", display_name="column1")
+        column_spec_mock2 = mock.Mock()
+        column_spec_mock2.configure_mock(name="column/2", display_name="column2")
+        client = self.tables_client(
+            {
+                "list_table_specs.return_value": [table_spec_mock],
+                "list_column_specs.return_value": [
+                    column_spec_mock1,
+                    column_spec_mock2,
+                ],
+                "location_path.return_value": LOCATION_PATH,
+            },
+            {},
+        )
+        client.create_model(
+            "my_model",
+            dataset_name="my_dataset",
+            exclude_column_spec_names=["column1"],
+            train_budget_milli_node_hours=1000,
+        )
+        client.auto_ml_client.create_model.assert_called_with(
+            LOCATION_PATH,
+            {
+                "display_name": "my_model",
+                "dataset_id": "my_dataset",
+                "tables_model_metadata": {
+                    "train_budget_milli_node_hours": 1000,
+                    "input_feature_column_specs": [column_spec_mock2],
+                },
+            },
+        )
+
+    def test_create_model_invalid_hours_small(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.create_model(
+                "my_model", dataset_name="my_dataset", train_budget_milli_node_hours=1
+            )
+        client.auto_ml_client.create_model.assert_not_called()
+
+    def test_create_model_invalid_hours_large(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.create_model(
+                "my_model",
+                dataset_name="my_dataset",
+                train_budget_milli_node_hours=1000000,
+            )
+        client.auto_ml_client.create_model.assert_not_called()
+
+    def test_create_model_invalid_no_dataset(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.create_model("my_model", train_budget_milli_node_hours=1000)
+        client.auto_ml_client.get_dataset.assert_not_called()
+        client.auto_ml_client.create_model.assert_not_called()
+
+    def test_create_model_invalid_include_exclude(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.create_model(
+                "my_model",
+                dataset_name="my_dataset",
+                include_column_spec_names=["a"],
+                exclude_column_spec_names=["b"],
+                train_budget_milli_node_hours=1000,
+            )
+        client.auto_ml_client.get_dataset.assert_not_called()
+        client.auto_ml_client.create_model.assert_not_called()
+
+    def test_predict_from_array(self):
+        data_type = mock.Mock(type_code=data_types_pb2.CATEGORY)
+        column_spec = mock.Mock(display_name="a", data_type=data_type)
+        model_metadata = mock.Mock(input_feature_column_specs=[column_spec])
+        model = mock.Mock()
+        model.configure_mock(tables_model_metadata=model_metadata, name="my_model")
+        client = self.tables_client({"get_model.return_value": model}, {})
+        client.predict(["1"], model_name="my_model")
+        client.prediction_client.predict.assert_called_with(
+            "my_model", {"row": {"values": [{"string_value": "1"}]}}
+        )
+
+    def test_predict_from_dict(self):
+        data_type = mock.Mock(type_code=data_types_pb2.CATEGORY)
+        column_spec_a = mock.Mock(display_name="a", data_type=data_type)
+        column_spec_b = mock.Mock(display_name="b", data_type=data_type)
+        model_metadata = mock.Mock(
+            input_feature_column_specs=[column_spec_a, column_spec_b]
+        )
+        model = mock.Mock()
+        model.configure_mock(tables_model_metadata=model_metadata, name="my_model")
+        client = self.tables_client({"get_model.return_value": model}, {})
+        client.predict({"a": "1", "b": "2"}, model_name="my_model")
+        client.prediction_client.predict.assert_called_with(
+            "my_model",
+            {"row": {"values": [{"string_value": "1"}, {"string_value": "2"}]}},
+        )
+
+    def test_predict_from_dict_missing(self):
+        data_type = mock.Mock(type_code=data_types_pb2.CATEGORY)
+        column_spec_a = mock.Mock(display_name="a", data_type=data_type)
+        column_spec_b = mock.Mock(display_name="b", data_type=data_type)
+        model_metadata = mock.Mock(
+            input_feature_column_specs=[column_spec_a, column_spec_b]
+        )
+        model = mock.Mock()
+        model.configure_mock(tables_model_metadata=model_metadata, name="my_model")
+        client = self.tables_client({"get_model.return_value": model}, {})
+        client.predict({"a": "1"}, model_name="my_model")
+        client.prediction_client.predict.assert_called_with(
+            "my_model", {"row": {"values": [{"string_value": "1"}, {"null_value": 0}]}}
+        )
+
+    def test_predict_all_types(self):
+        float_type = mock.Mock(type_code=data_types_pb2.FLOAT64)
+        timestamp_type = mock.Mock(type_code=data_types_pb2.TIMESTAMP)
+        string_type = mock.Mock(type_code=data_types_pb2.STRING)
+        array_type = mock.Mock(type_code=data_types_pb2.ARRAY)
+        struct_type = mock.Mock(type_code=data_types_pb2.STRUCT)
+        category_type = mock.Mock(type_code=data_types_pb2.CATEGORY)
+        column_spec_float = mock.Mock(display_name="float", data_type=float_type)
+        column_spec_timestamp = mock.Mock(
+            display_name="timestamp", data_type=timestamp_type
+        )
+        column_spec_string = mock.Mock(display_name="string", data_type=string_type)
+        column_spec_array = mock.Mock(display_name="array", data_type=array_type)
+        column_spec_struct = mock.Mock(display_name="struct", data_type=struct_type)
+        column_spec_category = mock.Mock(
+            display_name="category", data_type=category_type
+        )
+        column_spec_null = mock.Mock(display_name="null", data_type=category_type)
+        model_metadata = mock.Mock(
+            input_feature_column_specs=[
+                column_spec_float,
+                column_spec_timestamp,
+                column_spec_string,
+                column_spec_array,
+                column_spec_struct,
+                column_spec_category,
+                column_spec_null,
+            ]
+        )
+        model = mock.Mock()
+        model.configure_mock(tables_model_metadata=model_metadata, name="my_model")
+        client = self.tables_client({"get_model.return_value": model}, {})
+        client.predict(
+            {
+                "float": 1.0,
+                "timestamp": "EST",
+                "string": "text",
+                "array": [1],
+                "struct": {"a": "b"},
+                "category": "a",
+                "null": None,
+            },
+            model_name="my_model",
+        )
+        client.prediction_client.predict.assert_called_with(
+            "my_model",
+            {
+                "row": {
+                    "values": [
+                        {"number_value": 1.0},
+                        {"string_value": "EST"},
+                        {"string_value": "text"},
+                        {"list_value": [1]},
+                        {"struct_value": {"a": "b"}},
+                        {"string_value": "a"},
+                        {"null_value": 0},
+                    ]
+                }
+            },
+        )
+
+    def test_predict_from_array_missing(self):
+        data_type = mock.Mock(type_code=data_types_pb2.CATEGORY)
+        column_spec = mock.Mock(display_name="a", data_type=data_type)
+        model_metadata = mock.Mock(input_feature_column_specs=[column_spec])
+        model = mock.Mock()
+        model.configure_mock(tables_model_metadata=model_metadata, name="my_model")
+        client = self.tables_client({"get_model.return_value": model}, {})
+        with pytest.raises(ValueError):
+            client.predict([], model_name="my_model")
+        client.prediction_client.predict.assert_not_called()
+
+    def test_batch_predict_pandas_dataframe(self):
+        client = self.tables_client(
+            gcs_client_attrs={
+                "bucket_name": "my_bucket",
+                "upload_pandas_dataframe.return_value": "gs://input",
+            }
+        )
+        dataframe = pandas.DataFrame({})
+        client.batch_predict(
+            project=PROJECT,
+            region=REGION,
+            model_name="my_model",
+            pandas_dataframe=dataframe,
+            gcs_output_uri_prefix="gs://output",
+        )
+
+        client.gcs_client.ensure_bucket_exists.assert_called_with(PROJECT, REGION)
+        client.gcs_client.upload_pandas_dataframe.assert_called_with(dataframe)
+
+        client.prediction_client.batch_predict.assert_called_with(
+            "my_model",
+            {"gcs_source": {"input_uris": ["gs://input"]}},
+            {"gcs_destination": {"output_uri_prefix": "gs://output"}},
+        )
+
+    def test_batch_predict_gcs(self):
+        client = self.tables_client({}, {})
+        client.batch_predict(
+            model_name="my_model",
+            gcs_input_uris="gs://input",
+            gcs_output_uri_prefix="gs://output",
+        )
+        client.prediction_client.batch_predict.assert_called_with(
+            "my_model",
+            {"gcs_source": {"input_uris": ["gs://input"]}},
+            {"gcs_destination": {"output_uri_prefix": "gs://output"}},
+        )
+
+    def test_batch_predict_bigquery(self):
+        client = self.tables_client({}, {})
+        client.batch_predict(
+            model_name="my_model",
+            bigquery_input_uri="bq://input",
+            bigquery_output_uri="bq://output",
+        )
+        client.prediction_client.batch_predict.assert_called_with(
+            "my_model",
+            {"bigquery_source": {"input_uri": "bq://input"}},
+            {"bigquery_destination": {"output_uri": "bq://output"}},
+        )
+
+    def test_batch_predict_mixed(self):
+        client = self.tables_client({}, {})
+        client.batch_predict(
+            model_name="my_model",
+            gcs_input_uris="gs://input",
+            bigquery_output_uri="bq://output",
+        )
+        client.prediction_client.batch_predict.assert_called_with(
+            "my_model",
+            {"gcs_source": {"input_uris": ["gs://input"]}},
+            {"bigquery_destination": {"output_uri": "bq://output"}},
+        )
+
+    def test_batch_predict_missing_input_gcs_uri(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.batch_predict(
+                model_name="my_model",
+                gcs_input_uris=None,
+                gcs_output_uri_prefix="gs://output",
+            )
+        client.prediction_client.batch_predict.assert_not_called()
+
+    def test_batch_predict_missing_input_bigquery_uri(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.batch_predict(
+                model_name="my_model",
+                bigquery_input_uri=None,
+                gcs_output_uri_prefix="gs://output",
+            )
+        client.prediction_client.batch_predict.assert_not_called()
+
+    def test_batch_predict_missing_output_gcs_uri(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.batch_predict(
+                model_name="my_model",
+                gcs_input_uris="gs://input",
+                gcs_output_uri_prefix=None,
+            )
+        client.prediction_client.batch_predict.assert_not_called()
+
+    def test_batch_predict_missing_output_bigquery_uri(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.batch_predict(
+                model_name="my_model",
+                gcs_input_uris="gs://input",
+                bigquery_output_uri=None,
+            )
+        client.prediction_client.batch_predict.assert_not_called()
+
+    def test_batch_predict_missing_model(self):
+        client = self.tables_client({"list_models.return_value": []}, {})
+        with pytest.raises(exceptions.NotFound):
+            client.batch_predict(
+                model_display_name="my_model",
+                gcs_input_uris="gs://input",
+                gcs_output_uri_prefix="gs://output",
+            )
+        client.prediction_client.batch_predict.assert_not_called()
+
+    def test_batch_predict_no_model(self):
+        client = self.tables_client({}, {})
+        with pytest.raises(ValueError):
+            client.batch_predict(
+                gcs_input_uris="gs://input", gcs_output_uri_prefix="gs://output"
+            )
+        client.auto_ml_client.list_models.assert_not_called()
+        client.prediction_client.batch_predict.assert_not_called()
diff --git a/bigquery/.coveragerc b/bigquery/.coveragerc
new file mode 100644
index 000000000000..098720f672e1
--- /dev/null
+++ b/bigquery/.coveragerc
@@ -0,0 +1,16 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
diff --git a/bigquery/.flake8 b/bigquery/.flake8
new file mode 100644
index 000000000000..61766fa84d02
--- /dev/null
+++ b/bigquery/.flake8
@@ -0,0 +1,13 @@
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/bigquery/.gitignore b/bigquery/.gitignore
new file mode 100644
index 000000000000..9e3a5f25770c
--- /dev/null
+++ b/bigquery/.gitignore
@@ -0,0 +1 @@
+docs/_build
\ No newline at end of file
diff --git a/bigquery/.repo-metadata.json b/bigquery/.repo-metadata.json
new file mode 100644
index 000000000000..5b4734b8e389
--- /dev/null
+++ b/bigquery/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "bigquery",
+  "name_pretty": "Google Cloud BigQuery",
+  "product_documentation": "https://cloud.google.com/bigquery",
+  "client_documentation": "https://googleapis.dev/python/bigquery/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559654",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-bigquery",
+  "api_id": "bigquery.googleapis.com",
+  "requires_billing": false
+}
\ No newline at end of file
diff --git a/bigquery/CHANGELOG.md b/bigquery/CHANGELOG.md
new file mode 100644
index 000000000000..6d1c71ccbf79
--- /dev/null
+++ b/bigquery/CHANGELOG.md
@@ -0,0 +1,722 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-bigquery/#history
+
+## 1.18.0
+
+08-08-2019 12:28 PDT
+
+### New Features
+
+- Add `bqstorage_client` param to `QueryJob.to_arrow()` ([#8693](https://github.com/googleapis/google-cloud-python/pull/8693))
+- Include SQL query and job ID in exception messages. ([#8748](https://github.com/googleapis/google-cloud-python/pull/8748))
+- Allow using TableListItem to construct a Table object. ([#8738](https://github.com/googleapis/google-cloud-python/pull/8738))
+- Add StandardSqlDataTypes enum to BigQuery ([#8782](https://github.com/googleapis/google-cloud-python/pull/8782))
+- Add `to_standard_sql()` method to SchemaField ([#8880](https://github.com/googleapis/google-cloud-python/pull/8880))
+- Add debug logging statements to track when BQ Storage API is used. ([#8838](https://github.com/googleapis/google-cloud-python/pull/8838))
+- Hide error traceback in BigQuery cell magic ([#8808](https://github.com/googleapis/google-cloud-python/pull/8808))
+- Allow choice of compression when loading from dataframe ([#8938](https://github.com/googleapis/google-cloud-python/pull/8938))
+- Additional clustering metrics for BQML K-means models (via synth). ([#8945](https://github.com/googleapis/google-cloud-python/pull/8945))
+
+### Documentation
+
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Remove redundant service account key code sample. ([#8891](https://github.com/googleapis/google-cloud-python/pull/8891))
+
+### Internal / Testing Changes
+
+- Fix several pytest "skip if" markers ([#8694](https://github.com/googleapis/google-cloud-python/pull/8694))
+- Update tests to support conversion of NaN as NULL in pyarrow `0.14.*`. ([#8785](https://github.com/googleapis/google-cloud-python/pull/8785))
+- Mock external calls in one of BigQuery unit tests ([#8727](https://github.com/googleapis/google-cloud-python/pull/8727))
+- Set IPython user agent when running queries with IPython cell magic ([#8713](https://github.com/googleapis/google-cloud-python/pull/8713))
+- Use configurable bucket name for GCS samples data in systems tests. ([#8783](https://github.com/googleapis/google-cloud-python/pull/8783))
+- Move `maybe_fail_import()` to top level test utils ([#8840](https://github.com/googleapis/google-cloud-python/pull/8840))
+- Set BQ Storage client user-agent when in Jupyter cell ([#8734](https://github.com/googleapis/google-cloud-python/pull/8734))
+
+## 1.17.0
+
+07-12-2019 07:56 PDT
+
+### New Features
+
+- Support faster Arrow data format in `to_dataframe` when using BigQuery Storage API. ([#8551](https://github.com/googleapis/google-cloud-python/pull/8551))
+- Add `to_arrow` to get a `pyarrow.Table` from query results. ([#8609](https://github.com/googleapis/google-cloud-python/pull/8609))
+
+### Dependencies
+
+- Exclude bad 0.14.0 `pyarrow` release. ([#8551](https://github.com/googleapis/google-cloud-python/pull/8551))
+
+## 1.16.0
+
+07-01-2019 10:22 PDT
+
+### New Features
+
+- Add Routines API. ([#8491](https://github.com/googleapis/google-cloud-python/pull/8491))
+- Add more stats to Models API, such as `optimization_strategy` (via synth). ([#8344](https://github.com/googleapis/google-cloud-python/pull/8344))
+
+### Documentation
+
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Add sample demonstrating how to create a job. ([#8422](https://github.com/googleapis/google-cloud-python/pull/8422))
+- Use autodetected location in code samples. ([#8340](https://github.com/googleapis/google-cloud-python/pull/8340), [#8341](https://github.com/googleapis/google-cloud-python/pull/8341))
+
+### Internal / Testing Changes
+
+- Refactor `to_dataframe` to deterministicly update progress bar. ([#8303](https://github.com/googleapis/google-cloud-python/pull/8303))
+
+## 1.15.0
+
+06-14-2019 10:10 PDT
+
+### Implementation Changes
+
+- Fix bug where `load_table_from_dataframe` could not append to REQUIRED fields. ([#8230](https://github.com/googleapis/google-cloud-python/pull/8230))
+
+### New Features
+
+- Add `page_size` parameter to `QueryJob.result`. ([#8206](https://github.com/googleapis/google-cloud-python/pull/8206))
+
+## 1.14.0
+
+06-04-2019 11:11 PDT
+
+
+### New Features
+- Add `maximum_bytes_billed` argument and `context.default_query_job_config` property to magics. ([#8179](https://github.com/googleapis/google-cloud-python/pull/8179))
+
+### Dependencies
+- Don't pin `google-api-core` in libs using `google-cloud-core`. ([#8213](https://github.com/googleapis/google-cloud-python/pull/8213))
+
+## 1.13.0
+
+05-31-2019 10:22 PDT
+
+### New Features
+
+- Use `job_config.schema` for data type conversion if specified in `load_table_from_dataframe`. ([#8105](https://github.com/googleapis/google-cloud-python/pull/8105))
+
+### Internal / Testing Changes
+
+- Adds private `_connection` object to magics context. ([#8192](https://github.com/googleapis/google-cloud-python/pull/8192))
+- Fix coverage in 'types.py' (via synth). ([#8146](https://github.com/googleapis/google-cloud-python/pull/8146))
+
+## 1.12.1
+
+05-21-2019 11:16 PDT
+
+### Implementation Changes
+
+- Don't raise error when encountering unknown fields in Models API. ([#8083](https://github.com/googleapis/google-cloud-python/pull/8083))
+
+### Documentation
+
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+
+### Internal / Testing Changes
+
+- Add empty lines (via synth). ([#8049](https://github.com/googleapis/google-cloud-python/pull/8049))
+
+## 1.12.0
+
+05-16-2019 11:25 PDT
+
+### Implementation Changes
+- Remove duplicates from index on pandas DataFrames returned by `to_dataframe()`. ([#7953](https://github.com/googleapis/google-cloud-python/pull/7953))
+- Prevent error when time partitioning is populated with empty dict ([#7904](https://github.com/googleapis/google-cloud-python/pull/7904))
+- Preserve order in `to_dataframe` with BQ Storage from queries containing `ORDER BY` ([#7793](https://github.com/googleapis/google-cloud-python/pull/7793))
+- Respect `progress_bar_type` in `to_dataframe` when used with BQ Storage API ([#7697](https://github.com/googleapis/google-cloud-python/pull/7697))
+- Refactor QueryJob.query to read from resource dictionary ([#7763](https://github.com/googleapis/google-cloud-python/pull/7763))
+- Close the `to_dataframe` progress bar when finished. ([#7757](https://github.com/googleapis/google-cloud-python/pull/7757))
+- Ensure that `KeyboardInterrupt` during `to_dataframe`no longer hangs. ([#7698](https://github.com/googleapis/google-cloud-python/pull/7698))
+- Raise ValueError when BQ Storage is required but missing ([#7726](https://github.com/googleapis/google-cloud-python/pull/7726))
+- Make `total_rows` available on RowIterator before iteration ([#7622](https://github.com/googleapis/google-cloud-python/pull/7622))
+- Avoid masking auth errors in `to_dataframe` with BQ Storage API ([#7674](https://github.com/googleapis/google-cloud-python/pull/7674))
+
+### New Features
+- Add support for passing `client_info`. ([#7849](https://github.com/googleapis/google-cloud-python/pull/7849) and ([#7806](https://github.com/googleapis/google-cloud-python/pull/7806))
+- Phase 1 for storing schemas for later use. ([#7761](https://github.com/googleapis/google-cloud-python/pull/7761))
+- Add `destination` and related properties to LoadJob. ([#7710](https://github.com/googleapis/google-cloud-python/pull/7710))
+- Add `clustering_fields` property to TableListItem ([#7692](https://github.com/googleapis/google-cloud-python/pull/7692))
+- Add `created` and `expires` properties to TableListItem ([#7684](https://github.com/googleapis/google-cloud-python/pull/7684))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+- Add `[all]` extras to install all extra dependencies ([#7610](https://github.com/googleapis/google-cloud-python/pull/7610))
+
+### Documentation
+- Move table and dataset snippets to samples/ directory ([#7683](https://github.com/googleapis/google-cloud-python/pull/7683))
+
+### Internal / Testing Changes
+- Blacken unit tests. ([#7960](https://github.com/googleapis/google-cloud-python/pull/7960))
+- Cleanup client tests with method to create minimal table resource ([#7802](https://github.com/googleapis/google-cloud-python/pull/7802))
+
+## 1.11.2
+
+04-05-2019 08:16 PDT
+
+### Dependencies
+
+- Add dependency on protobuf. ([#7668](https://github.com/googleapis/google-cloud-python/pull/7668))
+
+## 1.11.1
+
+04-04-2019 09:19 PDT
+
+### Internal / Testing Changes
+
+- Increment version number in `setup.py`.
+
+## 1.11.0
+
+04-03-2019 19:33 PDT
+
+### Implementation Changes
+
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+
+- Enable fastparquet support by using temporary file in `load_table_from_dataframe` ([#7545](https://github.com/googleapis/google-cloud-python/pull/7545))
+- Allow string for copy sources, query destination, and default dataset ([#7560](https://github.com/googleapis/google-cloud-python/pull/7560))
+- Add `progress_bar_type` argument to `to_dataframe` to use `tqdm` to display a progress bar ([#7552](https://github.com/googleapis/google-cloud-python/pull/7552))
+- Call `get_table` in `list_rows` if the schema is not available ([#7621](https://github.com/googleapis/google-cloud-python/pull/7621))
+- Fallback to BQ API when there are problems reading from BQ Storage. ([#7633](https://github.com/googleapis/google-cloud-python/pull/7633))
+- Add methods for Models API ([#7562](https://github.com/googleapis/google-cloud-python/pull/7562))
+- Add option to use BigQuery Storage API from IPython magics ([#7640](https://github.com/googleapis/google-cloud-python/pull/7640))
+
+### Documentation
+
+- Remove typo in `Table.from_api_repr` docstring. ([#7509](https://github.com/googleapis/google-cloud-python/pull/7509))
+- Add docs session to nox configuration for BigQuery ([#7541](https://github.com/googleapis/google-cloud-python/pull/7541))
+
+### Internal / Testing Changes
+
+- Refactor `table()` methods into shared implementation. ([#7516](https://github.com/googleapis/google-cloud-python/pull/7516))
+- Blacken noxfile and setup file in nox session ([#7619](https://github.com/googleapis/google-cloud-python/pull/7619))
+- Actually use the `progress_bar_type` argument in `QueryJob.to_dataframe()`. ([#7616](https://github.com/googleapis/google-cloud-python/pull/7616))
+
+## 1.10.0
+
+03-06-2019 15:20 PST
+
+### Implementation Changes
+
+- Harden 'ArrayQueryParameter.from_api_repr' against missing 'parameterValue'. ([#7311](https://github.com/googleapis/google-cloud-python/pull/7311))
+- Allow nested records w/ null values. ([#7297](https://github.com/googleapis/google-cloud-python/pull/7297))
+
+### New Features
+
+- Add options to ignore errors when creating/deleting datasets/tables. ([#7491](https://github.com/googleapis/google-cloud-python/pull/7491))
+- Accept a string in Table and Dataset constructors. ([#7483](https://github.com/googleapis/google-cloud-python/pull/7483))
+
+### Documentation
+
+- Update docstring of RowIterator's to_dataframe ([#7306](https://github.com/googleapis/google-cloud-python/pull/7306))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+
+- Fix lint. ([#7383](https://github.com/googleapis/google-cloud-python/pull/7383))
+
+## 1.9.0
+
+02-04-2019 13:28 PST
+
+### New Features
+
+- Add arguments to select `dtypes` and use BQ Storage API to `QueryJob.to_dataframe()`. ([#7241](https://github.com/googleapis/google-cloud-python/pull/7241))
+
+### Documentation
+
+- Add sample for fetching `total_rows` from query results. ([#7217](https://github.com/googleapis/google-cloud-python/pull/7217))
+
+## 1.8.1
+
+12-17-2018 17:53 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize docs for 'page_size' / 'max_results' / 'page_token' ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+## 1.8.0
+
+12-10-2018 12:39 PST
+
+
+### Implementation Changes
+- Add option to use BQ Storage API with `to_dataframe` ([#6854](https://github.com/googleapis/google-cloud-python/pull/6854))
+- Fix exception type in comment ([#6847](https://github.com/googleapis/google-cloud-python/pull/6847))
+- Add `to_bqstorage` to convert from Table[Reference] google-cloud-bigquery-storage reference ([#6840](https://github.com/googleapis/google-cloud-python/pull/6840))
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Add avro logical type control for load jobs. ([#6827](https://github.com/googleapis/google-cloud-python/pull/6827))
+- Allow setting partition expiration to 'None'. ([#6823](https://github.com/googleapis/google-cloud-python/pull/6823))
+- Add `retry` argument to `_AsyncJob.result`. ([#6302](https://github.com/googleapis/google-cloud-python/pull/6302))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+
+### Documentation
+- Add avro load samples ([#6832](https://github.com/googleapis/google-cloud-python/pull/6832))
+
+### Internal / Testing Changes
+- Blacken libraries ([#6794](https://github.com/googleapis/google-cloud-python/pull/6794))
+- Fix copy/paste typos in noxfile comments ([#6831](https://github.com/googleapis/google-cloud-python/pull/6831))
+
+## 1.7.0
+
+11-05-2018 16:41 PST
+
+### Implementation Changes
+
+- Add destination table properties to `LoadJobConfig`. ([#6202](https://github.com/googleapis/google-cloud-python/pull/6202))
+- Allow strings or references in `create_dataset` and `create_table` ([#6199](https://github.com/googleapis/google-cloud-python/pull/6199))
+- Fix swallowed error message ([#6168](https://github.com/googleapis/google-cloud-python/pull/6168))
+
+### New Features
+
+- Add `--params option` to `%%bigquery` magic ([#6277](https://github.com/googleapis/google-cloud-python/pull/6277))
+- Expose `to_api_repr` method for jobs. ([#6176](https://github.com/googleapis/google-cloud-python/pull/6176))
+- Allow string in addition to DatasetReference / TableReference in Client methods. ([#6164](https://github.com/googleapis/google-cloud-python/pull/6164))
+- Add keyword arguments to job config constructors for setting properties ([#6397](https://github.com/googleapis/google-cloud-python/pull/6397))
+
+### Documentation
+
+- Update README service links in quickstart guides. ([#6322](https://github.com/googleapis/google-cloud-python/pull/6322))
+- Move usage guides to their own docs. ([#6238](https://github.com/googleapis/google-cloud-python/pull/6238))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+
+- Deprecation cleanups ([#6304](https://github.com/googleapis/google-cloud-python/pull/6304))
+- Use `_get_sub_prop` helper so missing load stats don't raise. ([#6269](https://github.com/googleapis/google-cloud-python/pull/6269))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Harden snippets against transient GCS errors. ([#6184](https://github.com/googleapis/google-cloud-python/pull/6184))
+
+## 1.6.0
+
+### New Features
+- Add support for `GEOGRAPHY` type ([#6147](https://github.com/googleapis/google-cloud-python/pull/6147))
+- Add default QueryJobConfig to Client ([#6088](https://github.com/googleapis/google-cloud-python/pull/6088))
+
+### Documentation
+- Remove unused "append" samples ([#6100](https://github.com/googleapis/google-cloud-python/pull/6100))
+
+### Internal / Testing Changes
+- Address dataset leaks, conflicts in systests ([#6099](https://github.com/googleapis/google-cloud-python/pull/6099))
+- Harden bucket teardown against `429 Too Many Requests`. ([#6101](https://github.com/googleapis/google-cloud-python/pull/6101))
+
+## 1.5.1
+
+### Implementation Changes
+
+- Retry '502 Bad Gateway' errors by default. (#5930)
+- Avoid pulling entire result set into memory when constructing dataframe. (#5870)
+- Add support for retrying unstructured 429 / 500 / 502 responses. (#6011)
+- Populate the jobReference from the API response. (#6044)
+
+### Documentation
+
+- Prepare documentation for repo split (#5955)
+- Fix leakage of bigquery/spanner sections into sidebar menu. (#5986)
+
+### Internal / Testing Changes
+
+- Test pandas support under Python 3.7. (#5857)
+- Nox: use inplace installs (#5865)
+- Update system test to use test data in bigquery-public-data. (#5965)
+
+## 1.5.0
+
+### Implementation Changes
+
+- Make 'Table.location' read-only. (#5687)
+
+### New Features
+
+- Add 'clustering_fields' properties. (#5630)
+- Add support for job labels (#5654)
+- Add 'QueryJob.estimated_bytes_processed' property (#5655)
+- Add support/tests for loading tables from 'gzip.GzipFile'. (#5711)
+- Add 'ExternalSourceFormat' enum. (#5674)
+- Add default location to client (#5678)
+
+### Documentation
+
+- Fix typo in CopyJob sources docstring (#5690)
+
+### Internal / Testing Changes
+
+- Add/refactor snippets for managing BigQuery jobs (#5631)
+- Reenable systests for 'dataset.update'/'table.update'. (#5732)
+
+## 1.4.0
+
+### Implementation Changes
+
+- Add 'internalError' to retryable error reasons. (#5599)
+- Don't raise exception if viewing CREATE VIEW DDL results (#5602)
+
+### New Features
+
+- Add Orc source format support and samples (#5500)
+- Move 'DEFAULT_RETRY' (w/ its predicate) to a new public 'retry' module. (#5552)
+- Allow listing rows on an empty table. (#5584)
+
+### Documentation
+
+- Add load_table_from_dataframe() to usage docs and changelog and dedents snippets in usage page (#5501)
+- Add samples for query external data sources (GCS & Sheets) (#5491)
+- Add BigQuery authorized view samples (#5515)
+- Update docs to show pyarrow as the only dependency of load_table_from_dataframe() (#5582)
+
+### Internal / Testing Changes
+
+- Add missing explict coverage for '_helpers' (#5550)
+- Skip update_table and update_dataset tests until etag issue is resolved. (#5590)
+
+## 1.3.0
+
+### New Features
+
+- NUMERIC type support (#5331)
+- Add timeline and top-level slot-millis to query statistics. (#5312)
+- Add additional statistics to query plan stages. (#5307)
+- Add `client.load_table_from_dataframe()` (#5387)
+
+### Documentation
+
+- Use autosummary to split up API reference docs (#5340)
+- Fix typo in Client docstrings (#5342)
+
+### Internal / Testing Changes
+
+- Prune systests identified as reduntant to snippets. (#5365)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Improve system test performance (#5319)
+
+## 1.2.0
+
+### Implementation Changes
+- Switch `list_partitions` helper to a direct metatable read (#5273)
+- Fix typo in `Encoding.ISO_8859_1` enum value (#5211)
+
+### New Features
+- Add UnknownJob type for redacted jobs. (#5281)
+- Add project parameter to `list_datasets` and `list_jobs` (#5217)
+- Add from_string factory methods to Dataset and Table (#5255)
+- Add column based time partitioning (#5267)
+
+### Documentation
+- Standardize docstrings for constants (#5289)
+- Fix docstring / impl of `ExtractJob.destination_uri_file_counts`. (#5245)
+
+### Internal / Testing Changes
+- Add testing support for Python 3.7; remove testing support for Python 3.4. (#5295)
+
+## 1.1.0
+
+### New Features
+- Add `client.get_service_account_email` (#5203)
+
+### Documentation
+- Update samples and standardize region tags (#5195)
+
+### Internal / Testing Changes
+- Fix trove classifier to be Production/Stable
+- Don't suppress 'dots' output on test (#5202)
+
+## 1.0.0
+
+### Implementation Changes
+- Remove deprecated Client methods (#5182)
+
+## 0.32.0
+
+### :warning: Interface changes
+
+- Use `job.configuration` resource for XXXJobConfig classes (#5036)
+
+### Interface additions
+
+- Add `page_size` parameter for `list_rows` and use in DB-API for `arraysize` (#4931)
+- Add IPython magics for running queries (#4983)
+
+### Documentation
+
+- Add job string constant parameters in init and snippets documentation (#4987)
+
+### Internal / Testing changes
+
+- Specify IPython version 5.5 when running Python 2.7 tests (#5145)
+- Move all Dataset property conversion logic into properties (#5130)
+- Remove unnecessary _Table class from test_job.py (#5126)
+- Use explicit bytes to initialize 'BytesIO'. (#5116)
+- Make SchemaField be able to include description via from_api_repr method (#5114)
+- Remove _ApiResourceProperty class (#5107)
+- Add dev version for 0.32.0 release (#5105)
+- StringIO to BytesIO (#5101)
+- Shorten snippets test name (#5091)
+- Don't use `selected_fields` for listing query result rows (#5072)
+- Add location property to job classes. (#5071)
+- Use autospec for Connection in tests. (#5066)
+- Add Parquet SourceFormat and samples (#5057)
+- Remove test_load_table_from_uri_w_autodetect_schema_then_get_job because of duplicate test in snippets (#5004)
+- Fix encoding variable and strings UTF-8 and ISO-8859-1 difference documentation (#4990)
+
+## 0.31.0
+
+### Interface additions
+
+- Add support for `EncryptionConfiguration` (#4845)
+
+### Implementation changes
+
+- Allow listing/getting jobs even when there is an "invalid" job. (#4786)
+
+### Dependencies
+
+- The minimum version for `google-api-core` has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)
+
+### Documentation
+
+- Update format in `Table.full_table_id` and `TableListItem.full_table_id` docstrings. (#4906)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Remove unnecessary debug print from tests (#4907)
+- Use constant strings for job properties in tests (#4833)
+
+## 0.30.0
+
+This is the release candidate for v1.0.0.
+
+### Interface changes / additions
+
+- Add `delete_contents` to `delete_dataset`. (#4724)
+
+### Bugfixes
+
+- Add handling of missing properties in `SchemaField.from_api_repr()`. (#4754)
+- Fix missing return value in `LoadJobConfig.from_api_repr`. (#4727)
+
+### Documentation
+
+- Minor documentation and typo fixes. (#4782, #4718, #4784, #4835, #4836)
+
+## 0.29.0
+
+### Interface changes / additions
+
+-   Add `to_dataframe()` method to row iterators. When Pandas is installed this
+    method returns a `DataFrame` containing the query's or table's rows.
+    ([#4354](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4354))
+-   Iterate over a `QueryJob` to wait for and get the query results.
+    ([#4350](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4350))
+-   Add `Table.reference` and `Dataset.reference` properties to get the
+    `TableReference` or `DatasetReference` corresponding to that `Table` or
+    `Dataset`, respectively.
+    ([#4405](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4405))
+-   Add `Row.keys()`, `Row.items()`, and `Row.get()`. This makes `Row` act
+    more like a built-in dictionary.
+    ([#4393](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4393),
+    [#4413](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4413))
+
+### Interface changes / breaking changes
+
+-   Add `Client.insert_rows()` and `Client.insert_rows_json()`, deprecate
+    `Client.create_rows()` and `Client.create_rows_json()`.
+    ([#4657](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4657))
+-   Add `Client.list_tables`, deprecate `Client.list_dataset_tables`.
+    ([#4653](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4653))
+-   `Client.list_tables` returns an iterators of `TableListItem`. The API
+    only returns a subset of properties of a table when listing.
+    ([#4427](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4427))
+-   Remove `QueryJob.query_results()`. Use `QueryJob.result()` instead.
+    ([#4652](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4652))
+-   Remove `Client.query_rows()`. Use `Client.query()` instead.
+    ([#4429](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4429))
+-   `Client.list_datasets` returns an iterator of `DatasetListItem`. The API
+    only returns a subset of properties of a dataset when listing.
+    ([#4439](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/4439))
+
+## 0.28.0
+
+**0.28.0 significantly changes the interface for this package.** For examples
+of the differences between 0.28.0 and previous versions, see
+[Migrating to the BigQuery Python client library 0.28][2].
+These changes can be summarized as follows:
+
+-   Query and view operations default to the standard SQL dialect. (#4192)
+-   Client functions related to
+    [jobs](https://cloud.google.com/bigquery/docs/jobs-overview), like running
+    queries, immediately start the job.
+-   Functions to create, get, update, delete datasets and tables moved to the
+    client class.
+
+[2]: https://cloud.google.com/bigquery/docs/python-client-migration
+
+### Fixes
+
+- Populate timeout parameter correctly for queries (#4209)
+- Automatically retry idempotent RPCs (#4148, #4178)
+- Parse timestamps in query parameters using canonical format (#3945)
+- Parse array parameters that contain a struct type. (#4040)
+- Support Sub Second Datetimes in row data (#3901, #3915, #3926), h/t @page1
+
+### Interface changes / additions
+
+- Support external table configuration (#4182) in query jobs (#4191) and
+  tables (#4193).
+- New `Row` class allows for access by integer index like a tuple, string
+  index like a dictionary, or attribute access like an object. (#4149)
+- Add option for job ID generation with user-supplied prefix (#4198)
+- Add support for update of dataset access entries (#4197)
+- Add support for atomic read-modify-write of a dataset using etag (#4052)
+- Add support for labels to `Dataset` (#4026)
+- Add support for labels to `Table` (#4207)
+- Add `Table.streaming_buffer` property (#4161)
+- Add `TableReference` class (#3942)
+- Add `DatasetReference` class (#3938, #3942, #3993)
+- Add `ExtractJob.destination_uri_file_counts` property. (#3803)
+- Add `client.create_rows_json()` to bypass conversions on streaming writes.
+  (#4189)
+- Add `client.get_job()` to get arbitrary jobs. (#3804, #4213)
+- Add filter to `client.list_datasets()` (#4205)
+- Add `QueryJob.undeclared_query_parameters` property. (#3802)
+- Add `QueryJob.referenced_tables` property. (#3801)
+- Add new scalar statistics properties to `QueryJob` (#3800)
+- Add `QueryJob.query_plan` property. (#3799)
+
+### Interface changes / breaking changes
+
+- Remove `client.run_async_query()`, use `client.query()` instead. (#4130)
+- Remove `client.run_sync_query()`, use `client.query_rows()` instead. (#4065, #4248)
+- Make `QueryResults` read-only. (#4094, #4144)
+- Make `get_query_results` private. Return rows for `QueryJob.result()` (#3883)
+- Move `*QueryParameter` and `UDFResource` classes to `query` module (also
+  exposed in `bigquery` module). (#4156)
+
+#### Changes to tables
+
+- Remove `client` from `Table` class (#4159)
+- Remove `table.exists()` (#4145)
+- Move `table.list_parations` to `client.list_partitions` (#4146)
+- Move `table.upload_from_file` to `client.load_table_from_file` (#4136)
+- Move `table.update()` and `table.patch()` to `client.update_table()` (#4076)
+- Move `table.insert_data()` to `client.create_rows()`. Automatically
+  generates row IDs if not supplied. (#4151, #4173)
+- Move `table.fetch_data()` to `client.list_rows()` (#4119, #4143)
+- Move `table.delete()` to `client.delete_table()` (#4066)
+- Move `table.create()` to `client.create_table()` (#4038, #4043)
+- Move `table.reload()` to `client.get_table()` (#4004)
+- Rename `Table.name` attribute to `Table.table_id` (#3959)
+- `Table` constructor takes a `TableReference` as parameter (#3997)
+
+#### Changes to datasets
+
+- Remove `client` from `Dataset` class (#4018)
+- Remove `dataset.exists()` (#3996)
+- Move `dataset.list_tables()` to `client.list_dataset_tables()` (#4013)
+- Move `dataset.delete()` to `client.delete_dataset()` (#4012)
+- Move `dataset.patch()` and `dataset.update()` to `client.update_dataset()` (#4003)
+- Move `dataset.create()` to `client.create_dataset()` (#3982)
+- Move `dataset.reload()` to `client.get_dataset()` (#3973)
+- Rename `Dataset.name` attribute to `Dataset.dataset_id` (#3955)
+- `client.dataset()` returns a `DatasetReference` instead of `Dataset`. (#3944)
+- Rename class: `dataset.AccessGrant -> dataset.AccessEntry`. (#3798)
+- `dataset.table()` returns a `TableReference` instead of a `Table` (#4014)
+- `Dataset` constructor takes a DatasetReference (#4036)
+
+#### Changes to jobs
+
+- Make `job.begin()` method private. (#4242)
+- Add `LoadJobConfig` class and modify `LoadJob` (#4103, #4137)
+- Add `CopyJobConfig` class and modify `CopyJob` (#4051, #4059)
+- Type of Job's and Query's `default_dataset` changed from `Dataset` to
+  `DatasetReference` (#4037)
+- Rename `client.load_table_from_storage()` to `client.load_table_from_uri()`
+  (#4235)
+- Rename `client.extract_table_to_storage` to `client.extract_table()`.
+  Method starts the extract job immediately. (#3991, #4177)
+- Rename `XJob.name` to `XJob.job_id`. (#3962)
+- Rename job classes. `LoadTableFromStorageJob -> LoadJob` and
+  `ExtractTableToStorageJob -> jobs.ExtractJob` (#3797)
+
+### Dependencies
+
+- Updating to `google-cloud-core ~= 0.28`, in particular, the
+  `google-api-core` package has been moved out of `google-cloud-core`. (#4221)
+
+PyPI: https://pypi.org/project/google-cloud-bigquery/0.28.0/
+
+
+## 0.27.0
+
+- Remove client-side enum validation. (#3735)
+- Add `Table.row_from_mapping` helper. (#3425)
+- Move `google.cloud.future` to `google.api.core` (#3764)
+- Fix `__eq__` and `__ne__`. (#3765)
+- Move `google.cloud.iterator` to `google.api.core.page_iterator` (#3770)
+- `nullMarker` support for BigQuery Load Jobs (#3777), h/t @leondealmeida
+- Allow `job_id` to be explicitly specified in DB-API. (#3779)
+- Add support for a custom null marker. (#3776)
+- Add `SchemaField` serialization and deserialization. (#3786)
+- Add `get_query_results` method to the client. (#3838)
+- Poll for query completion via `getQueryResults` method. (#3844)
+- Allow fetching more than the first page when `max_results` is set. (#3845)
+
+PyPI: https://pypi.org/project/google-cloud-bigquery/0.27.0/
+
+## 0.26.0
+
+### Notable implementation changes
+
+- Using the `requests` transport attached to a Client for for resumable media
+  (i.e. downloads and uploads) (#3705) (this relates to the `httplib2` to
+  `requests` switch)
+
+### Interface changes / additions
+
+- Adding `autodetect` property on `LoadTableFromStorageJob` to enable schema
+  autodetection. (#3648)
+- Implementing the Python Futures interface for Jobs. Call `job.result()` to
+  wait for jobs to complete instead of polling manually on the job status.
+  (#3626)
+- Adding `is_nullable` property on `SchemaField`. Can be used to check if a
+  column is nullable. (#3620)
+- `job_name` argument added to `Table.upload_from_file` for setting the job
+  ID. (#3605)
+- Adding `google.cloud.bigquery.dbapi` package, which implements PEP-249
+  DB-API specification. (#2921)
+- Adding `Table.view_use_legacy_sql` property. Can be used to create views
+  with legacy or standard SQL. (#3514)
+
+### Interface changes / breaking changes
+
+- Removing `results()` method from the `QueryJob` class. Use
+  `query_results()` instead. (#3661)
+- `SchemaField` is now immutable. It is also hashable so that it can be used
+  in sets. (#3601)
+
+### Dependencies
+
+- Updating to `google-cloud-core ~= 0.26`, in particular, the underlying HTTP
+  transport switched from `httplib2` to `requests` (#3654, #3674)
+- Adding dependency on `google-resumable-media` for loading BigQuery tables
+  from local files. (#3555)
+
+### Packaging
+
+- Fix inclusion of `tests` (vs. `unit_tests`) in `MANIFEST.in` (#3552)
+- Updating `author_email` in `setup.py` to `googleapis-publisher@google.com`.
+  (#3598)
+
+PyPI: https://pypi.org/project/google-cloud-bigquery/0.26.0/
diff --git a/bigquery/LICENSE b/bigquery/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/bigquery/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/bigquery/MANIFEST.in b/bigquery/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/bigquery/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/bigquery/README.rst b/bigquery/README.rst
new file mode 100644
index 000000000000..8f73576d6f7d
--- /dev/null
+++ b/bigquery/README.rst
@@ -0,0 +1,104 @@
+Python Client for Google BigQuery
+=================================
+
+|GA| |pypi| |versions| 
+
+Querying massive datasets can be time consuming and expensive without the
+right hardware and infrastructure. Google `BigQuery`_ solves this problem by
+enabling super-fast, SQL queries against append-mostly tables, using the
+processing power of Google's infrastructure.
+
+-  `Client Library Documentation`_
+-  `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-bigquery.svg
+   :target: https://pypi.org/project/google-cloud-bigquery/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-bigquery.svg
+   :target: https://pypi.org/project/google-cloud-bigquery/
+.. _BigQuery: https://cloud.google.com/bigquery/what-is-bigquery
+.. _Client Library Documentation: https://googleapis.dev/python/bigquery/latest
+.. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud BigQuery API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud BigQuery API.:  https://cloud.google.com/bigquery
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-bigquery
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-bigquery
+
+Example Usage
+-------------
+
+Perform a query
+~~~~~~~~~~~~~~~
+
+.. code:: python
+
+    from google.cloud import bigquery
+
+    client = bigquery.Client()
+
+    # Perform a query.
+    QUERY = (
+        'SELECT name FROM `bigquery-public-data.usa_names.usa_1910_2013` '
+        'WHERE state = "TX" '
+        'LIMIT 100')
+    query_job = client.query(QUERY)  # API request
+    rows = query_job.result()  # Waits for query to finish
+
+    for row in rows:
+        print(row.name)
diff --git a/bigquery/benchmark/README.md b/bigquery/benchmark/README.md
new file mode 100644
index 000000000000..435926acb045
--- /dev/null
+++ b/bigquery/benchmark/README.md
@@ -0,0 +1,8 @@
+# BigQuery Benchmark
+This directory contains benchmarks for BigQuery client.
+
+## Usage
+`python benchmark.py queries.json`
+
+BigQuery service caches requests so the benchmark should be run
+at least twice, disregarding the first result.
diff --git a/bigquery/benchmark/benchmark.py b/bigquery/benchmark/benchmark.py
new file mode 100644
index 000000000000..2917f169aba1
--- /dev/null
+++ b/bigquery/benchmark/benchmark.py
@@ -0,0 +1,46 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.cloud import bigquery
+from datetime import datetime
+import json
+import sys
+
+if len(sys.argv) < 2:
+    raise Exception('need query file, usage: python {0} <queries.json>'.format(sys.argv[0]))
+
+with open(sys.argv[1], 'r') as f:
+    queries = json.loads(f.read())
+
+client = bigquery.Client()
+
+for query in queries:
+    start_time = datetime.now()
+    job = client.query(query)
+    rows = job.result()
+
+    num_rows = 0
+    num_cols = None
+    first_byte_time = None
+
+    for row in rows:
+        if num_rows == 0:
+            num_cols = len(row)
+            first_byte_time = datetime.now() - start_time
+        elif num_cols != len(row):
+            raise Exception('found {0} columsn, expected {1}'.format(len(row), num_cols))
+        num_rows += 1
+    total_time = datetime.now() - start_time
+    print("query {0}: {1} rows, {2} cols, first byte {3} sec, total {4} sec"
+        .format(query, num_rows, num_cols, first_byte_time.total_seconds(), total_time.total_seconds()))
diff --git a/bigquery/benchmark/queries.json b/bigquery/benchmark/queries.json
new file mode 100644
index 000000000000..13fed38b52b3
--- /dev/null
+++ b/bigquery/benchmark/queries.json
@@ -0,0 +1,10 @@
+[
+  "SELECT * FROM `nyc-tlc.yellow.trips` LIMIT 10000",
+  "SELECT * FROM `nyc-tlc.yellow.trips` LIMIT 100000",
+  "SELECT * FROM `nyc-tlc.yellow.trips` LIMIT 1000000",
+  "SELECT title FROM `bigquery-public-data.samples.wikipedia` ORDER BY title LIMIT 1000",
+  "SELECT title, id, timestamp, contributor_ip FROM `bigquery-public-data.samples.wikipedia` WHERE title like 'Blo%' ORDER BY id",
+  "SELECT * FROM `bigquery-public-data.baseball.games_post_wide` ORDER BY gameId",
+  "SELECT * FROM `bigquery-public-data.samples.github_nested` WHERE repository.has_downloads ORDER BY repository.created_at LIMIT 10000",
+  "SELECT repo_name, path FROM `bigquery-public-data.github_repos.files` WHERE path LIKE '%.java' ORDER BY id LIMIT 1000000"
+]
diff --git a/bigquery/docs/.gitignore b/bigquery/docs/.gitignore
new file mode 100644
index 000000000000..3fe20bec0f3a
--- /dev/null
+++ b/bigquery/docs/.gitignore
@@ -0,0 +1 @@
+generated/
\ No newline at end of file
diff --git a/bigquery/docs/README.rst b/bigquery/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/bigquery/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/bigquery/docs/changelog.md b/bigquery/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/bigquery/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/bigquery/docs/conf.py b/bigquery/docs/conf.py
new file mode 100644
index 000000000000..b3cfa267dd7d
--- /dev/null
+++ b/bigquery/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+# 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.
+#
+# google-cloud-bigquery documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shutil
+
+from sphinx.util import logging
+
+logger = logging.getLogger(__name__)
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates", os.path.join("..", "..", "docs", "_templates")]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-bigquery"
+copyright = u"2015, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+# html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-bigquery-doc"
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-bigquery.tex",
+        u"google-cloud-bigquery Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-bigquery",
+        u"google-cloud-bigquery Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-bigquery",
+        u"google-cloud-bigquery Documentation",
+        author,
+        "google-cloud-bigquery",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
+
+# Static HTML pages, e.g. to support redirects
+# See: https://tech.signavio.com/2017/managing-sphinx-redirects
+# HTML pages to be copied from source to target
+static_html_pages = ["usage.html", "generated/google.cloud.bigquery.magics.html"]
+
+
+def copy_static_html_pages(app, exception):
+    if exception is None and app.builder.name == "html":
+        for static_html_page in static_html_pages:
+            target_path = app.outdir + "/" + static_html_page
+            src_path = app.srcdir + "/" + static_html_page
+            if os.path.isfile(src_path):
+                logger.info("Copying static html: %s -> %s", src_path, target_path)
+                shutil.copyfile(src_path, target_path)
+
+
+def setup(app):
+    app.connect("build-finished", copy_static_html_pages)
diff --git a/bigquery/docs/dbapi.rst b/bigquery/docs/dbapi.rst
new file mode 100644
index 000000000000..ca0256d3c8de
--- /dev/null
+++ b/bigquery/docs/dbapi.rst
@@ -0,0 +1,6 @@
+DB-API Reference
+~~~~~~~~~~~~~~~~
+
+.. automodule:: google.cloud.bigquery.dbapi
+  :members:
+  :show-inheritance:
diff --git a/bigquery/docs/gapic/v2/enums.rst b/bigquery/docs/gapic/v2/enums.rst
new file mode 100644
index 000000000000..0e0f05adaea5
--- /dev/null
+++ b/bigquery/docs/gapic/v2/enums.rst
@@ -0,0 +1,8 @@
+Enums for BigQuery API Client
+=============================
+
+.. autoclass:: google.cloud.bigquery_v2.gapic.enums.Model
+    :members:
+
+.. autoclass:: google.cloud.bigquery_v2.gapic.enums.StandardSqlDataType
+    :members:
diff --git a/bigquery/docs/gapic/v2/types.rst b/bigquery/docs/gapic/v2/types.rst
new file mode 100644
index 000000000000..97938768a690
--- /dev/null
+++ b/bigquery/docs/gapic/v2/types.rst
@@ -0,0 +1,5 @@
+Types for BigQuery API Client
+=============================
+
+.. automodule:: google.cloud.bigquery_v2.types
+    :members:
\ No newline at end of file
diff --git a/bigquery/docs/generated/google.cloud.bigquery.magics.html b/bigquery/docs/generated/google.cloud.bigquery.magics.html
new file mode 100644
index 000000000000..0d2a00fa14c9
--- /dev/null
+++ b/bigquery/docs/generated/google.cloud.bigquery.magics.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=../magics.html:" />
+ <script>
+   window.location.href = "../magics.html"
+ </script>
+</head>
+</html>
diff --git a/bigquery/docs/index.rst b/bigquery/docs/index.rst
new file mode 100644
index 000000000000..ec360de69770
--- /dev/null
+++ b/bigquery/docs/index.rst
@@ -0,0 +1,29 @@
+.. include:: README.rst
+
+More Examples
+~~~~~~~~~~~~~
+
+.. toctree::
+  :maxdepth: 2
+
+  usage/index
+  Official Google BigQuery How-to Guides <https://cloud.google.com/bigquery/docs/how-to>
+
+API Reference
+-------------
+
+.. toctree::
+  :maxdepth: 2
+
+  reference
+  dbapi
+
+Changelog
+---------
+
+For a list of all ``google-cloud-bigquery`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/bigquery/docs/magics.rst b/bigquery/docs/magics.rst
new file mode 100644
index 000000000000..732c27af94dd
--- /dev/null
+++ b/bigquery/docs/magics.rst
@@ -0,0 +1,5 @@
+IPython Magics for BigQuery
+===========================
+
+.. automodule:: google.cloud.bigquery.magics
+    :members:
diff --git a/bigquery/docs/reference.rst b/bigquery/docs/reference.rst
new file mode 100644
index 000000000000..e01443808795
--- /dev/null
+++ b/bigquery/docs/reference.rst
@@ -0,0 +1,186 @@
+API Reference
+~~~~~~~~~~~~~
+
+.. currentmodule:: google.cloud.bigquery
+
+The main concepts with this API are:
+
+- :class:`~google.cloud.bigquery.client.Client` manages connections to the
+  BigQuery API. Use the client methods to run jobs (such as a
+  :class:`~google.cloud.bigquery.job.QueryJob` via
+  :meth:`~google.cloud.bigquery.client.Client.query`) and manage resources.
+
+- :class:`~google.cloud.bigquery.dataset.Dataset` represents a
+  collection of tables.
+
+- :class:`~google.cloud.bigquery.table.Table` represents a single "relation".
+
+Client
+======
+
+.. autosummary::
+    :toctree: generated
+
+    client.Client
+
+Job
+===
+
+Job Configuration
+-----------------
+
+.. autosummary::
+    :toctree: generated
+
+    job.QueryJobConfig
+    job.CopyJobConfig
+    job.LoadJobConfig
+    job.ExtractJobConfig
+
+Job Classes
+-----------
+
+.. autosummary::
+    :toctree: generated
+
+    job.QueryJob
+    job.CopyJob
+    job.LoadJob
+    job.ExtractJob
+    job.UnknownJob
+
+Job-Related Types
+-----------------
+
+.. autosummary::
+    :toctree: generated
+
+    job.Compression
+    job.CreateDisposition
+    job.DestinationFormat
+    job.Encoding
+    job.QueryPriority
+    job.SourceFormat
+    job.WriteDisposition
+    job.SchemaUpdateOption
+
+
+Dataset
+=======
+
+.. autosummary::
+    :toctree: generated
+
+    dataset.Dataset
+    dataset.DatasetListItem
+    dataset.DatasetReference
+    dataset.AccessEntry
+
+
+Table
+=====
+
+.. autosummary::
+    :toctree: generated
+
+    table.Table
+    table.TableListItem
+    table.TableReference
+    table.Row
+    table.RowIterator
+    table.EncryptionConfiguration
+    table.TimePartitioning
+    table.TimePartitioningType
+
+Model
+=====
+
+.. autosummary::
+    :toctree: generated
+
+    model.Model
+    model.ModelReference
+
+Routine
+=======
+
+.. autosummary::
+    :toctree: generated
+
+    routine.Routine
+    routine.RoutineArgument
+    routine.RoutineReference
+
+Schema
+======
+
+.. autosummary::
+    :toctree: generated
+
+    schema.SchemaField
+
+
+Query
+=====
+
+.. autosummary::
+    :toctree: generated
+
+    query.ArrayQueryParameter
+    query.ScalarQueryParameter
+    query.StructQueryParameter
+    query.UDFResource
+
+
+Retries
+=======
+
+.. autosummary::
+    :toctree: generated
+
+    retry.DEFAULT_RETRY
+
+
+External Configuration
+======================
+
+.. autosummary::
+    :toctree: generated
+
+    external_config.ExternalSourceFormat
+    external_config.ExternalConfig
+    external_config.BigtableOptions
+    external_config.BigtableColumnFamily
+    external_config.BigtableColumn
+    external_config.CSVOptions
+    external_config.GoogleSheetsOptions
+
+
+Magics
+======
+
+.. toctree::
+    :maxdepth: 2
+
+    magics
+
+
+Enums
+=====
+
+.. autosummary::
+    :toctree: generated
+
+    enums.StandardSqlDataTypes
+
+
+Additional Types
+================
+
+Protocol buffer classes for working with the Models API.
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v2/enums
+    gapic/v2/types
diff --git a/bigquery/docs/samples b/bigquery/docs/samples
new file mode 120000
index 000000000000..18cd9a30aaff
--- /dev/null
+++ b/bigquery/docs/samples
@@ -0,0 +1 @@
+../samples/
\ No newline at end of file
diff --git a/bigquery/docs/snippets.py b/bigquery/docs/snippets.py
new file mode 100644
index 000000000000..4c39ff912230
--- /dev/null
+++ b/bigquery/docs/snippets.py
@@ -0,0 +1,2540 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Testable usage examples for Google BigQuery API wrapper
+
+Each example function takes a ``client`` argument (which must be an instance
+of :class:`google.cloud.bigquery.client.Client`) and uses it to perform a task
+with the API.
+
+To facilitate running the examples as system tests, each example is also passed
+a ``to_delete`` list;  the function adds to the list any objects created which
+need to be deleted during teardown.
+"""
+
+import os
+import time
+
+import pytest
+import six
+
+try:
+    import fastparquet
+except (ImportError, AttributeError):
+    fastparquet = None
+try:
+    import pandas
+except (ImportError, AttributeError):
+    pandas = None
+try:
+    import pyarrow
+except (ImportError, AttributeError):
+    pyarrow = None
+
+from google.api_core import datetime_helpers
+from google.api_core.exceptions import InternalServerError
+from google.api_core.exceptions import ServiceUnavailable
+from google.api_core.exceptions import TooManyRequests
+from google.cloud import bigquery
+from google.cloud import storage
+from test_utils.retry import RetryErrors
+
+ORIGINAL_FRIENDLY_NAME = "Original friendly name"
+ORIGINAL_DESCRIPTION = "Original description"
+LOCALLY_CHANGED_FRIENDLY_NAME = "Locally-changed friendly name"
+LOCALLY_CHANGED_DESCRIPTION = "Locally-changed description"
+UPDATED_FRIENDLY_NAME = "Updated friendly name"
+UPDATED_DESCRIPTION = "Updated description"
+
+SCHEMA = [
+    bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+    bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+]
+
+ROWS = [
+    ("Phred Phlyntstone", 32),
+    ("Bharney Rhubble", 33),
+    ("Wylma Phlyntstone", 29),
+    ("Bhettye Rhubble", 27),
+]
+
+QUERY = (
+    "SELECT name FROM `bigquery-public-data.usa_names.usa_1910_2013` "
+    'WHERE state = "TX"'
+)
+
+
+retry_429 = RetryErrors(TooManyRequests)
+retry_storage_errors = RetryErrors(
+    (TooManyRequests, InternalServerError, ServiceUnavailable)
+)
+
+
+@pytest.fixture(scope="module")
+def client():
+    return bigquery.Client()
+
+
+@pytest.fixture
+def to_delete(client):
+    doomed = []
+    yield doomed
+    for item in doomed:
+        if isinstance(item, (bigquery.Dataset, bigquery.DatasetReference)):
+            retry_429(client.delete_dataset)(item, delete_contents=True)
+        elif isinstance(item, storage.Bucket):
+            retry_storage_errors(item.delete)()
+        else:
+            retry_429(item.delete)()
+
+
+def _millis():
+    return int(time.time() * 1000)
+
+
+class _CloseOnDelete(object):
+    def __init__(self, wrapped):
+        self._wrapped = wrapped
+
+    def delete(self):
+        self._wrapped.close()
+
+
+def test_create_client_default_credentials():
+    """Create a BigQuery client with Application Default Credentials"""
+
+    # [START bigquery_client_default_credentials]
+    from google.cloud import bigquery
+
+    # If you don't specify credentials when constructing the client, the
+    # client library will look for credentials in the environment.
+    client = bigquery.Client()
+    # [END bigquery_client_default_credentials]
+
+    assert client is not None
+
+
+def test_create_table_nested_repeated_schema(client, to_delete):
+    dataset_id = "create_table_nested_repeated_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    dataset = bigquery.Dataset(dataset_ref)
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_nested_repeated_schema]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_ref = client.dataset('my_dataset')
+
+    schema = [
+        bigquery.SchemaField("id", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("first_name", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("last_name", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("dob", "DATE", mode="NULLABLE"),
+        bigquery.SchemaField(
+            "addresses",
+            "RECORD",
+            mode="REPEATED",
+            fields=[
+                bigquery.SchemaField("status", "STRING", mode="NULLABLE"),
+                bigquery.SchemaField("address", "STRING", mode="NULLABLE"),
+                bigquery.SchemaField("city", "STRING", mode="NULLABLE"),
+                bigquery.SchemaField("state", "STRING", mode="NULLABLE"),
+                bigquery.SchemaField("zip", "STRING", mode="NULLABLE"),
+                bigquery.SchemaField("numberOfYears", "STRING", mode="NULLABLE"),
+            ],
+        ),
+    ]
+    table_ref = dataset_ref.table("my_table")
+    table = bigquery.Table(table_ref, schema=schema)
+    table = client.create_table(table)  # API request
+
+    print("Created table {}".format(table.full_table_id))
+    # [END bigquery_nested_repeated_schema]
+
+
+def test_create_table_cmek(client, to_delete):
+    dataset_id = "create_table_cmek_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_create_table_cmek]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    table_ref = client.dataset(dataset_id).table("my_table")
+    table = bigquery.Table(table_ref)
+
+    # Set the encryption key to use for the table.
+    # TODO: Replace this key with a key you have created in Cloud KMS.
+    kms_key_name = "projects/{}/locations/{}/keyRings/{}/cryptoKeys/{}".format(
+        "cloud-samples-tests", "us-central1", "test", "test"
+    )
+    table.encryption_configuration = bigquery.EncryptionConfiguration(
+        kms_key_name=kms_key_name
+    )
+
+    table = client.create_table(table)  # API request
+
+    assert table.encryption_configuration.kms_key_name == kms_key_name
+    # [END bigquery_create_table_cmek]
+
+
+def test_create_partitioned_table(client, to_delete):
+    dataset_id = "create_table_partitioned_{}".format(_millis())
+    dataset_ref = bigquery.Dataset(client.dataset(dataset_id))
+    dataset = client.create_dataset(dataset_ref)
+    to_delete.append(dataset)
+
+    # [START bigquery_create_table_partitioned]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_ref = client.dataset('my_dataset')
+
+    table_ref = dataset_ref.table("my_partitioned_table")
+    schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+        bigquery.SchemaField("date", "DATE"),
+    ]
+    table = bigquery.Table(table_ref, schema=schema)
+    table.time_partitioning = bigquery.TimePartitioning(
+        type_=bigquery.TimePartitioningType.DAY,
+        field="date",  # name of column to use for partitioning
+        expiration_ms=7776000000,
+    )  # 90 days
+
+    table = client.create_table(table)
+
+    print(
+        "Created table {}, partitioned on column {}".format(
+            table.table_id, table.time_partitioning.field
+        )
+    )
+    # [END bigquery_create_table_partitioned]
+
+    assert table.time_partitioning.type_ == "DAY"
+    assert table.time_partitioning.field == "date"
+    assert table.time_partitioning.expiration_ms == 7776000000
+
+
+def test_load_and_query_partitioned_table(client, to_delete):
+    dataset_id = "load_partitioned_table_dataset_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_partitioned]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+    table_id = "us_states_by_date"
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+        bigquery.SchemaField("date", "DATE"),
+    ]
+    job_config.skip_leading_rows = 1
+    job_config.time_partitioning = bigquery.TimePartitioning(
+        type_=bigquery.TimePartitioningType.DAY,
+        field="date",  # name of column to use for partitioning
+        expiration_ms=7776000000,
+    )  # 90 days
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states-by-date.csv"
+
+    load_job = client.load_table_from_uri(
+        uri, dataset_ref.table(table_id), job_config=job_config
+    )  # API request
+
+    assert load_job.job_type == "load"
+
+    load_job.result()  # Waits for table load to complete.
+
+    table = client.get_table(dataset_ref.table(table_id))
+    print("Loaded {} rows to table {}".format(table.num_rows, table_id))
+    # [END bigquery_load_table_partitioned]
+    assert table.num_rows == 50
+
+    project_id = client.project
+
+    # [START bigquery_query_partitioned_table]
+    import datetime
+
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # project_id = 'my-project'
+    # dataset_id = 'my_dataset'
+    table_id = "us_states_by_date"
+
+    sql_template = """
+        SELECT *
+        FROM `{}.{}.{}`
+        WHERE date BETWEEN @start_date AND @end_date
+    """
+    sql = sql_template.format(project_id, dataset_id, table_id)
+    job_config = bigquery.QueryJobConfig()
+    job_config.query_parameters = [
+        bigquery.ScalarQueryParameter("start_date", "DATE", datetime.date(1800, 1, 1)),
+        bigquery.ScalarQueryParameter("end_date", "DATE", datetime.date(1899, 12, 31)),
+    ]
+
+    # API request
+    query_job = client.query(sql, job_config=job_config)
+
+    rows = list(query_job)
+    print("{} states were admitted to the US in the 1800s".format(len(rows)))
+    # [END bigquery_query_partitioned_table]
+    assert len(rows) == 29
+
+
+# [START bigquery_table_exists]
+def table_exists(client, table_reference):
+    """Return if a table exists.
+
+    Args:
+        client (google.cloud.bigquery.client.Client):
+            A client to connect to the BigQuery API.
+        table_reference (google.cloud.bigquery.table.TableReference):
+            A reference to the table to look for.
+
+    Returns:
+        bool: ``True`` if the table exists, ``False`` otherwise.
+    """
+    from google.cloud.exceptions import NotFound
+
+    try:
+        client.get_table(table_reference)
+        return True
+    except NotFound:
+        return False
+
+
+# [END bigquery_table_exists]
+
+
+def test_table_exists(client, to_delete):
+    """Determine if a table exists."""
+    DATASET_ID = "get_table_dataset_{}".format(_millis())
+    TABLE_ID = "get_table_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(DATASET_ID))
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table_ref = dataset.table(TABLE_ID)
+    table = bigquery.Table(table_ref, schema=SCHEMA)
+    table = client.create_table(table)
+
+    assert table_exists(client, table_ref)
+    assert not table_exists(client, dataset.table("i_dont_exist"))
+
+
+@pytest.mark.skip(
+    reason=(
+        "update_table() is flaky "
+        "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/5589"
+    )
+)
+def test_manage_table_labels(client, to_delete):
+    dataset_id = "label_table_dataset_{}".format(_millis())
+    table_id = "label_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table = bigquery.Table(dataset.table(table_id), schema=SCHEMA)
+    table = client.create_table(table)
+
+    # [START bigquery_label_table]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # table_ref = client.dataset('my_dataset').table('my_table')
+    # table = client.get_table(table_ref)  # API request
+
+    assert table.labels == {}
+    labels = {"color": "green"}
+    table.labels = labels
+
+    table = client.update_table(table, ["labels"])  # API request
+
+    assert table.labels == labels
+    # [END bigquery_label_table]
+
+    # [START bigquery_get_table_labels]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+    # table_id = 'my_table'
+
+    dataset_ref = client.dataset(dataset_id)
+    table_ref = dataset_ref.table(table_id)
+    table = client.get_table(table_ref)  # API Request
+
+    # View table labels
+    print("Table ID: {}".format(table_id))
+    print("Labels:")
+    if table.labels:
+        for label, value in table.labels.items():
+            print("\t{}: {}".format(label, value))
+    else:
+        print("\tTable has no labels defined.")
+    # [END bigquery_get_table_labels]
+    assert table.labels == labels
+
+    # [START bigquery_delete_label_table]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # table_ref = client.dataset('my_dataset').table('my_table')
+    # table = client.get_table(table_ref)  # API request
+
+    # This example table starts with one label
+    assert table.labels == {"color": "green"}
+    # To delete a label from a table, set its value to None
+    table.labels["color"] = None
+
+    table = client.update_table(table, ["labels"])  # API request
+
+    assert table.labels == {}
+    # [END bigquery_delete_label_table]
+
+
+@pytest.mark.skip(
+    reason=(
+        "update_table() is flaky "
+        "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/5589"
+    )
+)
+def test_update_table_description(client, to_delete):
+    """Update a table's description."""
+    dataset_id = "update_table_description_dataset_{}".format(_millis())
+    table_id = "update_table_description_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table = bigquery.Table(dataset.table(table_id), schema=SCHEMA)
+    table.description = "Original description."
+    table = client.create_table(table)
+
+    # [START bigquery_update_table_description]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # table_ref = client.dataset('my_dataset').table('my_table')
+    # table = client.get_table(table_ref)  # API request
+
+    assert table.description == "Original description."
+    table.description = "Updated description."
+
+    table = client.update_table(table, ["description"])  # API request
+
+    assert table.description == "Updated description."
+    # [END bigquery_update_table_description]
+
+
+@pytest.mark.skip(
+    reason=(
+        "update_table() is flaky "
+        "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/5589"
+    )
+)
+def test_update_table_expiration(client, to_delete):
+    """Update a table's expiration time."""
+    dataset_id = "update_table_expiration_dataset_{}".format(_millis())
+    table_id = "update_table_expiration_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table = bigquery.Table(dataset.table(table_id), schema=SCHEMA)
+    table = client.create_table(table)
+
+    # [START bigquery_update_table_expiration]
+    import datetime
+    import pytz
+
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # table_ref = client.dataset('my_dataset').table('my_table')
+    # table = client.get_table(table_ref)  # API request
+
+    assert table.expires is None
+
+    # set table to expire 5 days from now
+    expiration = datetime.datetime.now(pytz.utc) + datetime.timedelta(days=5)
+    table.expires = expiration
+    table = client.update_table(table, ["expires"])  # API request
+
+    # expiration is stored in milliseconds
+    margin = datetime.timedelta(microseconds=1000)
+    assert expiration - margin <= table.expires <= expiration + margin
+    # [END bigquery_update_table_expiration]
+
+
+@pytest.mark.skip(
+    reason=(
+        "update_table() is flaky "
+        "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/5589"
+    )
+)
+def test_relax_column(client, to_delete):
+    """Updates a schema field from required to nullable."""
+    dataset_id = "relax_column_dataset_{}".format(_millis())
+    table_id = "relax_column_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_relax_column]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+    # table_id = 'my_table'
+
+    original_schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+    ]
+    table_ref = client.dataset(dataset_id).table(table_id)
+    table = bigquery.Table(table_ref, schema=original_schema)
+    table = client.create_table(table)
+    assert all(field.mode == "REQUIRED" for field in table.schema)
+
+    # SchemaField properties cannot be edited after initialization.
+    # To make changes, construct new SchemaField objects.
+    relaxed_schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("age", "INTEGER", mode="NULLABLE"),
+    ]
+    table.schema = relaxed_schema
+    table = client.update_table(table, ["schema"])
+
+    assert all(field.mode == "NULLABLE" for field in table.schema)
+    # [END bigquery_relax_column]
+
+
+@pytest.mark.skip(
+    reason=(
+        "update_table() is flaky "
+        "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/5589"
+    )
+)
+def test_update_table_cmek(client, to_delete):
+    """Patch a table's metadata."""
+    dataset_id = "update_table_cmek_{}".format(_millis())
+    table_id = "update_table_cmek_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table = bigquery.Table(dataset.table(table_id))
+    original_kms_key_name = "projects/{}/locations/{}/keyRings/{}/cryptoKeys/{}".format(
+        "cloud-samples-tests", "us-central1", "test", "test"
+    )
+    table.encryption_configuration = bigquery.EncryptionConfiguration(
+        kms_key_name=original_kms_key_name
+    )
+    table = client.create_table(table)
+
+    # [START bigquery_update_table_cmek]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    assert table.encryption_configuration.kms_key_name == original_kms_key_name
+
+    # Set a new encryption key to use for the destination.
+    # TODO: Replace this key with a key you have created in KMS.
+    updated_kms_key_name = (
+        "projects/cloud-samples-tests/locations/us-central1/"
+        "keyRings/test/cryptoKeys/otherkey"
+    )
+    table.encryption_configuration = bigquery.EncryptionConfiguration(
+        kms_key_name=updated_kms_key_name
+    )
+
+    table = client.update_table(table, ["encryption_configuration"])  # API request
+
+    assert table.encryption_configuration.kms_key_name == updated_kms_key_name
+    assert original_kms_key_name != updated_kms_key_name
+    # [END bigquery_update_table_cmek]
+
+
+@pytest.mark.skip(
+    reason=(
+        "update_table() is flaky "
+        "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/5589"
+    )
+)
+def test_manage_views(client, to_delete):
+    project = client.project
+    source_dataset_id = "source_dataset_{}".format(_millis())
+    source_dataset_ref = client.dataset(source_dataset_id)
+    source_dataset = bigquery.Dataset(source_dataset_ref)
+    source_dataset = client.create_dataset(source_dataset)
+    to_delete.append(source_dataset)
+
+    job_config = bigquery.LoadJobConfig()
+    job_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    job_config.skip_leading_rows = 1
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.csv"
+    source_table_id = "us_states"
+    load_job = client.load_table_from_uri(
+        uri, source_dataset.table(source_table_id), job_config=job_config
+    )
+    load_job.result()
+
+    shared_dataset_id = "shared_dataset_{}".format(_millis())
+    shared_dataset_ref = client.dataset(shared_dataset_id)
+    shared_dataset = bigquery.Dataset(shared_dataset_ref)
+    shared_dataset = client.create_dataset(shared_dataset)
+    to_delete.append(shared_dataset)
+
+    # [START bigquery_create_view]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # project = 'my-project'
+    # source_dataset_id = 'my_source_dataset'
+    # source_table_id = 'us_states'
+    # shared_dataset_ref = client.dataset('my_shared_dataset')
+
+    # This example shows how to create a shared view of a source table of
+    # US States. The source table contains all 50 states, while the view will
+    # contain only states with names starting with 'W'.
+    view_ref = shared_dataset_ref.table("my_shared_view")
+    view = bigquery.Table(view_ref)
+    sql_template = 'SELECT name, post_abbr FROM `{}.{}.{}` WHERE name LIKE "W%"'
+    view.view_query = sql_template.format(project, source_dataset_id, source_table_id)
+    view = client.create_table(view)  # API request
+
+    print("Successfully created view at {}".format(view.full_table_id))
+    # [END bigquery_create_view]
+
+    # [START bigquery_update_view_query]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # project = 'my-project'
+    # source_dataset_id = 'my_source_dataset'
+    # source_table_id = 'us_states'
+    # shared_dataset_ref = client.dataset('my_shared_dataset')
+
+    # This example shows how to update a shared view of a source table of
+    # US States. The view's query will be updated to contain only states with
+    # names starting with 'M'.
+    view_ref = shared_dataset_ref.table("my_shared_view")
+    view = bigquery.Table(view_ref)
+    sql_template = 'SELECT name, post_abbr FROM `{}.{}.{}` WHERE name LIKE "M%"'
+    view.view_query = sql_template.format(project, source_dataset_id, source_table_id)
+    view = client.update_table(view, ["view_query"])  # API request
+    # [END bigquery_update_view_query]
+
+    # [START bigquery_get_view]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # shared_dataset_id = 'my_shared_dataset'
+
+    view_ref = client.dataset(shared_dataset_id).table("my_shared_view")
+    view = client.get_table(view_ref)  # API Request
+
+    # Display view properties
+    print("View at {}".format(view.full_table_id))
+    print("View Query:\n{}".format(view.view_query))
+    # [END bigquery_get_view]
+    assert view.view_query is not None
+
+    analyst_group_email = "example-analyst-group@google.com"
+    # [START bigquery_grant_view_access]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    # Assign access controls to the dataset containing the view
+    # shared_dataset_id = 'my_shared_dataset'
+    # analyst_group_email = 'data_analysts@example.com'
+    shared_dataset = client.get_dataset(
+        client.dataset(shared_dataset_id)
+    )  # API request
+    access_entries = shared_dataset.access_entries
+    access_entries.append(
+        bigquery.AccessEntry("READER", "groupByEmail", analyst_group_email)
+    )
+    shared_dataset.access_entries = access_entries
+    shared_dataset = client.update_dataset(
+        shared_dataset, ["access_entries"]
+    )  # API request
+
+    # Authorize the view to access the source dataset
+    # project = 'my-project'
+    # source_dataset_id = 'my_source_dataset'
+    source_dataset = client.get_dataset(
+        client.dataset(source_dataset_id)
+    )  # API request
+    view_reference = {
+        "projectId": project,
+        "datasetId": shared_dataset_id,
+        "tableId": "my_shared_view",
+    }
+    access_entries = source_dataset.access_entries
+    access_entries.append(bigquery.AccessEntry(None, "view", view_reference))
+    source_dataset.access_entries = access_entries
+    source_dataset = client.update_dataset(
+        source_dataset, ["access_entries"]
+    )  # API request
+    # [END bigquery_grant_view_access]
+
+
+def test_table_insert_rows(client, to_delete):
+    """Insert / fetch table data."""
+    dataset_id = "table_insert_rows_dataset_{}".format(_millis())
+    table_id = "table_insert_rows_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dataset = client.create_dataset(dataset)
+    dataset.location = "US"
+    to_delete.append(dataset)
+
+    table = bigquery.Table(dataset.table(table_id), schema=SCHEMA)
+    table = client.create_table(table)
+
+    # [START bigquery_table_insert_rows]
+    # TODO(developer): Uncomment the lines below and replace with your values.
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'  # replace with your dataset ID
+    # For this sample, the table must already exist and have a defined schema
+    # table_id = 'my_table'  # replace with your table ID
+    # table_ref = client.dataset(dataset_id).table(table_id)
+    # table = client.get_table(table_ref)  # API request
+
+    rows_to_insert = [(u"Phred Phlyntstone", 32), (u"Wylma Phlyntstone", 29)]
+
+    errors = client.insert_rows(table, rows_to_insert)  # API request
+
+    assert errors == []
+    # [END bigquery_table_insert_rows]
+
+
+def test_load_table_from_file(client, to_delete):
+    """Upload table data from a CSV file."""
+    dataset_id = "load_table_from_file_dataset_{}".format(_millis())
+    table_id = "load_table_from_file_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dataset.location = "US"
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+    snippets_dir = os.path.abspath(os.path.dirname(__file__))
+    filename = os.path.join(
+        snippets_dir, "..", "..", "bigquery", "tests", "data", "people.csv"
+    )
+
+    # [START bigquery_load_from_file]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # filename = '/path/to/file.csv'
+    # dataset_id = 'my_dataset'
+    # table_id = 'my_table'
+
+    dataset_ref = client.dataset(dataset_id)
+    table_ref = dataset_ref.table(table_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.source_format = bigquery.SourceFormat.CSV
+    job_config.skip_leading_rows = 1
+    job_config.autodetect = True
+
+    with open(filename, "rb") as source_file:
+        job = client.load_table_from_file(source_file, table_ref, job_config=job_config)
+
+    job.result()  # Waits for table load to complete.
+
+    print("Loaded {} rows into {}:{}.".format(job.output_rows, dataset_id, table_id))
+    # [END bigquery_load_from_file]
+
+    table = client.get_table(table_ref)
+    rows = list(client.list_rows(table))  # API request
+
+    assert len(rows) == 2
+    # Order is not preserved, so compare individually
+    row1 = bigquery.Row(("Wylma Phlyntstone", 29), {"full_name": 0, "age": 1})
+    assert row1 in rows
+    row2 = bigquery.Row(("Phred Phlyntstone", 32), {"full_name": 0, "age": 1})
+    assert row2 in rows
+
+
+def test_load_table_from_uri_avro(client, to_delete, capsys):
+    dataset_id = "load_table_from_uri_avro_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_gcs_avro]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.source_format = bigquery.SourceFormat.AVRO
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.avro"
+
+    load_job = client.load_table_from_uri(
+        uri, dataset_ref.table("us_states"), job_config=job_config
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(dataset_ref.table("us_states"))
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_avro]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_from_uri_csv(client, to_delete, capsys):
+    dataset_id = "load_table_from_uri_csv_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_gcs_csv]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    job_config.skip_leading_rows = 1
+    # The source format defaults to CSV, so the line below is optional.
+    job_config.source_format = bigquery.SourceFormat.CSV
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.csv"
+
+    load_job = client.load_table_from_uri(
+        uri, dataset_ref.table("us_states"), job_config=job_config
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(dataset_ref.table("us_states"))
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_csv]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_from_uri_json(client, to_delete, capsys):
+    dataset_id = "load_table_from_uri_json_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dataset.location = "US"
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_gcs_json]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    job_config.source_format = bigquery.SourceFormat.NEWLINE_DELIMITED_JSON
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.json"
+
+    load_job = client.load_table_from_uri(
+        uri,
+        dataset_ref.table("us_states"),
+        location="US",  # Location must match that of the destination dataset.
+        job_config=job_config,
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(dataset_ref.table("us_states"))
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_json]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_from_uri_cmek(client, to_delete):
+    dataset_id = "load_table_from_uri_cmek_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dataset.location = "US"
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_gcs_json_cmek]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.autodetect = True
+    job_config.source_format = bigquery.SourceFormat.NEWLINE_DELIMITED_JSON
+
+    # Set the encryption key to use for the destination.
+    # TODO: Replace this key with a key you have created in KMS.
+    kms_key_name = "projects/{}/locations/{}/keyRings/{}/cryptoKeys/{}".format(
+        "cloud-samples-tests", "us-central1", "test", "test"
+    )
+    encryption_config = bigquery.EncryptionConfiguration(kms_key_name=kms_key_name)
+    job_config.destination_encryption_configuration = encryption_config
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.json"
+
+    load_job = client.load_table_from_uri(
+        uri,
+        dataset_ref.table("us_states"),
+        location="US",  # Location must match that of the destination dataset.
+        job_config=job_config,
+    )  # API request
+
+    assert load_job.job_type == "load"
+
+    load_job.result()  # Waits for table load to complete.
+
+    assert load_job.state == "DONE"
+    table = client.get_table(dataset_ref.table("us_states"))
+    assert table.encryption_configuration.kms_key_name == kms_key_name
+    # [END bigquery_load_table_gcs_json_cmek]
+
+
+def test_load_table_from_uri_parquet(client, to_delete, capsys):
+    dataset_id = "load_table_from_uri_parquet_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_gcs_parquet]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.source_format = bigquery.SourceFormat.PARQUET
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.parquet"
+
+    load_job = client.load_table_from_uri(
+        uri, dataset_ref.table("us_states"), job_config=job_config
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(dataset_ref.table("us_states"))
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_parquet]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_from_uri_orc(client, to_delete, capsys):
+    dataset_id = "load_table_from_uri_orc_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_load_table_gcs_orc]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.source_format = bigquery.SourceFormat.ORC
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.orc"
+
+    load_job = client.load_table_from_uri(
+        uri, dataset_ref.table("us_states"), job_config=job_config
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(dataset_ref.table("us_states"))
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_orc]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_from_uri_autodetect(client, to_delete, capsys):
+    """Load table from a GCS URI using various formats and auto-detected schema
+
+    Each file format has its own tested load from URI sample. Because most of
+    the code is common for autodetect, append, and truncate, this sample
+    includes snippets for all supported formats but only calls a single load
+    job.
+
+    This code snippet is made up of shared code, then format-specific code,
+    followed by more shared code. Note that only the last format in the
+    format-specific code section will be tested in this test.
+    """
+    dataset_id = "load_table_from_uri_auto_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # Shared code
+    # [START bigquery_load_table_gcs_csv_autodetect]
+    # [START bigquery_load_table_gcs_json_autodetect]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    dataset_ref = client.dataset(dataset_id)
+    job_config = bigquery.LoadJobConfig()
+    job_config.autodetect = True
+    # [END bigquery_load_table_gcs_csv_autodetect]
+    # [END bigquery_load_table_gcs_json_autodetect]
+
+    # Format-specific code
+    # [START bigquery_load_table_gcs_csv_autodetect]
+    job_config.skip_leading_rows = 1
+    # The source format defaults to CSV, so the line below is optional.
+    job_config.source_format = bigquery.SourceFormat.CSV
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.csv"
+    # [END bigquery_load_table_gcs_csv_autodetect]
+    # unset csv-specific attribute
+    del job_config._properties["load"]["skipLeadingRows"]
+
+    # [START bigquery_load_table_gcs_json_autodetect]
+    job_config.source_format = bigquery.SourceFormat.NEWLINE_DELIMITED_JSON
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.json"
+    # [END bigquery_load_table_gcs_json_autodetect]
+
+    # Shared code
+    # [START bigquery_load_table_gcs_csv_autodetect]
+    # [START bigquery_load_table_gcs_json_autodetect]
+    load_job = client.load_table_from_uri(
+        uri, dataset_ref.table("us_states"), job_config=job_config
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(dataset_ref.table("us_states"))
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_csv_autodetect]
+    # [END bigquery_load_table_gcs_json_autodetect]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_from_uri_truncate(client, to_delete, capsys):
+    """Replaces table data with data from a GCS URI using various formats
+
+    Each file format has its own tested load from URI sample. Because most of
+    the code is common for autodetect, append, and truncate, this sample
+    includes snippets for all supported formats but only calls a single load
+    job.
+
+    This code snippet is made up of shared code, then format-specific code,
+    followed by more shared code. Note that only the last format in the
+    format-specific code section will be tested in this test.
+    """
+    dataset_id = "load_table_from_uri_trunc_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    job_config = bigquery.LoadJobConfig()
+    job_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    table_ref = dataset.table("us_states")
+    body = six.BytesIO(b"Washington,WA")
+    client.load_table_from_file(body, table_ref, job_config=job_config).result()
+    previous_rows = client.get_table(table_ref).num_rows
+    assert previous_rows > 0
+
+    # Shared code
+    # [START bigquery_load_table_gcs_avro_truncate]
+    # [START bigquery_load_table_gcs_csv_truncate]
+    # [START bigquery_load_table_gcs_json_truncate]
+    # [START bigquery_load_table_gcs_parquet_truncate]
+    # [START bigquery_load_table_gcs_orc_truncate]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # table_ref = client.dataset('my_dataset').table('existing_table')
+
+    job_config = bigquery.LoadJobConfig()
+    job_config.write_disposition = bigquery.WriteDisposition.WRITE_TRUNCATE
+    # [END bigquery_load_table_gcs_avro_truncate]
+    # [END bigquery_load_table_gcs_csv_truncate]
+    # [END bigquery_load_table_gcs_json_truncate]
+    # [END bigquery_load_table_gcs_parquet_truncate]
+    # [END bigquery_load_table_gcs_orc_truncate]
+
+    # Format-specific code
+    # [START bigquery_load_table_gcs_avro_truncate]
+    job_config.source_format = bigquery.SourceFormat.AVRO
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.avro"
+    # [END bigquery_load_table_gcs_avro_truncate]
+
+    # [START bigquery_load_table_gcs_csv_truncate]
+    job_config.skip_leading_rows = 1
+    # The source format defaults to CSV, so the line below is optional.
+    job_config.source_format = bigquery.SourceFormat.CSV
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.csv"
+    # [END bigquery_load_table_gcs_csv_truncate]
+    # unset csv-specific attribute
+    del job_config._properties["load"]["skipLeadingRows"]
+
+    # [START bigquery_load_table_gcs_json_truncate]
+    job_config.source_format = bigquery.SourceFormat.NEWLINE_DELIMITED_JSON
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.json"
+    # [END bigquery_load_table_gcs_json_truncate]
+
+    # [START bigquery_load_table_gcs_parquet_truncate]
+    job_config.source_format = bigquery.SourceFormat.PARQUET
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.parquet"
+    # [END bigquery_load_table_gcs_parquet_truncate]
+
+    # [START bigquery_load_table_gcs_orc_truncate]
+    job_config.source_format = bigquery.SourceFormat.ORC
+    uri = "gs://cloud-samples-data/bigquery/us-states/us-states.orc"
+    # [END bigquery_load_table_gcs_orc_truncate]
+
+    # Shared code
+    # [START bigquery_load_table_gcs_avro_truncate]
+    # [START bigquery_load_table_gcs_csv_truncate]
+    # [START bigquery_load_table_gcs_json_truncate]
+    # [START bigquery_load_table_gcs_parquet_truncate]
+    # [START bigquery_load_table_gcs_orc_truncate]
+    load_job = client.load_table_from_uri(
+        uri, table_ref, job_config=job_config
+    )  # API request
+    print("Starting job {}".format(load_job.job_id))
+
+    load_job.result()  # Waits for table load to complete.
+    print("Job finished.")
+
+    destination_table = client.get_table(table_ref)
+    print("Loaded {} rows.".format(destination_table.num_rows))
+    # [END bigquery_load_table_gcs_avro_truncate]
+    # [END bigquery_load_table_gcs_csv_truncate]
+    # [END bigquery_load_table_gcs_json_truncate]
+    # [END bigquery_load_table_gcs_parquet_truncate]
+    # [END bigquery_load_table_gcs_orc_truncate]
+
+    out, _ = capsys.readouterr()
+    assert "Loaded 50 rows." in out
+
+
+def test_load_table_add_column(client, to_delete):
+    dataset_id = "load_table_add_column_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    snippets_dir = os.path.abspath(os.path.dirname(__file__))
+    filepath = os.path.join(
+        snippets_dir, "..", "..", "bigquery", "tests", "data", "people.csv"
+    )
+    table_ref = dataset_ref.table("my_table")
+    old_schema = [bigquery.SchemaField("full_name", "STRING", mode="REQUIRED")]
+    table = client.create_table(bigquery.Table(table_ref, schema=old_schema))
+
+    # [START bigquery_add_column_load_append]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_ref = client.dataset('my_dataset')
+    # filepath = 'path/to/your_file.csv'
+
+    # Retrieves the destination table and checks the length of the schema
+    table_id = "my_table"
+    table_ref = dataset_ref.table(table_id)
+    table = client.get_table(table_ref)
+    print("Table {} contains {} columns.".format(table_id, len(table.schema)))
+
+    # Configures the load job to append the data to the destination table,
+    # allowing field addition
+    job_config = bigquery.LoadJobConfig()
+    job_config.write_disposition = bigquery.WriteDisposition.WRITE_APPEND
+    job_config.schema_update_options = [
+        bigquery.SchemaUpdateOption.ALLOW_FIELD_ADDITION
+    ]
+    # In this example, the existing table contains only the 'full_name' column.
+    # 'REQUIRED' fields cannot be added to an existing schema, so the
+    # additional column must be 'NULLABLE'.
+    job_config.schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="NULLABLE"),
+    ]
+    job_config.source_format = bigquery.SourceFormat.CSV
+    job_config.skip_leading_rows = 1
+
+    with open(filepath, "rb") as source_file:
+        job = client.load_table_from_file(
+            source_file,
+            table_ref,
+            location="US",  # Must match the destination dataset location.
+            job_config=job_config,
+        )  # API request
+
+    job.result()  # Waits for table load to complete.
+    print(
+        "Loaded {} rows into {}:{}.".format(
+            job.output_rows, dataset_id, table_ref.table_id
+        )
+    )
+
+    # Checks the updated length of the schema
+    table = client.get_table(table)
+    print("Table {} now contains {} columns.".format(table_id, len(table.schema)))
+    # [END bigquery_add_column_load_append]
+    assert len(table.schema) == 2
+    assert table.num_rows > 0
+
+
+def test_load_table_relax_column(client, to_delete):
+    dataset_id = "load_table_relax_column_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    snippets_dir = os.path.abspath(os.path.dirname(__file__))
+    filepath = os.path.join(
+        snippets_dir, "..", "..", "bigquery", "tests", "data", "people.csv"
+    )
+    table_ref = dataset_ref.table("my_table")
+    old_schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+        bigquery.SchemaField("favorite_color", "STRING", mode="REQUIRED"),
+    ]
+    table = client.create_table(bigquery.Table(table_ref, schema=old_schema))
+
+    # [START bigquery_relax_column_load_append]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_ref = client.dataset('my_dataset')
+    # filepath = 'path/to/your_file.csv'
+
+    # Retrieves the destination table and checks the number of required fields
+    table_id = "my_table"
+    table_ref = dataset_ref.table(table_id)
+    table = client.get_table(table_ref)
+    original_required_fields = sum(field.mode == "REQUIRED" for field in table.schema)
+    # In this example, the existing table has 3 required fields.
+    print("{} fields in the schema are required.".format(original_required_fields))
+
+    # Configures the load job to append the data to a destination table,
+    # allowing field relaxation
+    job_config = bigquery.LoadJobConfig()
+    job_config.write_disposition = bigquery.WriteDisposition.WRITE_APPEND
+    job_config.schema_update_options = [
+        bigquery.SchemaUpdateOption.ALLOW_FIELD_RELAXATION
+    ]
+    # In this example, the existing table contains three required fields
+    # ('full_name', 'age', and 'favorite_color'), while the data to load
+    # contains only the first two fields.
+    job_config.schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+    ]
+    job_config.source_format = bigquery.SourceFormat.CSV
+    job_config.skip_leading_rows = 1
+
+    with open(filepath, "rb") as source_file:
+        job = client.load_table_from_file(
+            source_file,
+            table_ref,
+            location="US",  # Must match the destination dataset location.
+            job_config=job_config,
+        )  # API request
+
+    job.result()  # Waits for table load to complete.
+    print(
+        "Loaded {} rows into {}:{}.".format(
+            job.output_rows, dataset_id, table_ref.table_id
+        )
+    )
+
+    # Checks the updated number of required fields
+    table = client.get_table(table)
+    current_required_fields = sum(field.mode == "REQUIRED" for field in table.schema)
+    print("{} fields in the schema are now required.".format(current_required_fields))
+    # [END bigquery_relax_column_load_append]
+    assert original_required_fields - current_required_fields == 1
+    assert len(table.schema) == 3
+    assert table.schema[2].mode == "NULLABLE"
+    assert table.num_rows > 0
+
+
+def test_copy_table(client, to_delete):
+    dataset_id = "copy_table_dataset_{}".format(_millis())
+    dest_dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dest_dataset.location = "US"
+    dest_dataset = client.create_dataset(dest_dataset)
+    to_delete.append(dest_dataset)
+
+    # [START bigquery_copy_table]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    source_dataset = client.dataset("samples", project="bigquery-public-data")
+    source_table_ref = source_dataset.table("shakespeare")
+
+    # dataset_id = 'my_dataset'
+    dest_table_ref = client.dataset(dataset_id).table("destination_table")
+
+    job = client.copy_table(
+        source_table_ref,
+        dest_table_ref,
+        # Location must match that of the source and destination tables.
+        location="US",
+    )  # API request
+
+    job.result()  # Waits for job to complete.
+
+    assert job.state == "DONE"
+    dest_table = client.get_table(dest_table_ref)  # API request
+    assert dest_table.num_rows > 0
+    # [END bigquery_copy_table]
+
+
+def test_copy_table_multiple_source(client, to_delete):
+    dest_dataset_id = "dest_dataset_{}".format(_millis())
+    dest_dataset = bigquery.Dataset(client.dataset(dest_dataset_id))
+    dest_dataset.location = "US"
+    dest_dataset = client.create_dataset(dest_dataset)
+    to_delete.append(dest_dataset)
+
+    source_dataset_id = "source_dataset_{}".format(_millis())
+    source_dataset = bigquery.Dataset(client.dataset(source_dataset_id))
+    source_dataset.location = "US"
+    source_dataset = client.create_dataset(source_dataset)
+    to_delete.append(source_dataset)
+
+    schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+
+    table_data = {"table1": b"Washington,WA", "table2": b"California,CA"}
+    for table_id, data in table_data.items():
+        table_ref = source_dataset.table(table_id)
+        job_config = bigquery.LoadJobConfig()
+        job_config.schema = schema
+        body = six.BytesIO(data)
+        client.load_table_from_file(
+            body,
+            table_ref,
+            # Location must match that of the destination dataset.
+            location="US",
+            job_config=job_config,
+        ).result()
+
+    # [START bigquery_copy_table_multiple_source]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # source_dataset_id = 'my_source_dataset'
+    # dest_dataset_id = 'my_destination_dataset'
+
+    table1_ref = client.dataset(source_dataset_id).table("table1")
+    table2_ref = client.dataset(source_dataset_id).table("table2")
+    dest_table_ref = client.dataset(dest_dataset_id).table("destination_table")
+
+    job = client.copy_table(
+        [table1_ref, table2_ref],
+        dest_table_ref,
+        # Location must match that of the source and destination tables.
+        location="US",
+    )  # API request
+    job.result()  # Waits for job to complete.
+
+    assert job.state == "DONE"
+    dest_table = client.get_table(dest_table_ref)  # API request
+    assert dest_table.num_rows > 0
+    # [END bigquery_copy_table_multiple_source]
+
+    assert dest_table.num_rows == 2
+
+
+def test_copy_table_cmek(client, to_delete):
+    dataset_id = "copy_table_cmek_{}".format(_millis())
+    dest_dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dest_dataset.location = "US"
+    dest_dataset = client.create_dataset(dest_dataset)
+    to_delete.append(dest_dataset)
+
+    # [START bigquery_copy_table_cmek]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    source_dataset = bigquery.DatasetReference("bigquery-public-data", "samples")
+    source_table_ref = source_dataset.table("shakespeare")
+
+    # dataset_id = 'my_dataset'
+    dest_dataset_ref = client.dataset(dataset_id)
+    dest_table_ref = dest_dataset_ref.table("destination_table")
+
+    # Set the encryption key to use for the destination.
+    # TODO: Replace this key with a key you have created in KMS.
+    kms_key_name = "projects/{}/locations/{}/keyRings/{}/cryptoKeys/{}".format(
+        "cloud-samples-tests", "us-central1", "test", "test"
+    )
+    encryption_config = bigquery.EncryptionConfiguration(kms_key_name=kms_key_name)
+    job_config = bigquery.CopyJobConfig()
+    job_config.destination_encryption_configuration = encryption_config
+
+    job = client.copy_table(
+        source_table_ref,
+        dest_table_ref,
+        # Location must match that of the source and destination tables.
+        location="US",
+        job_config=job_config,
+    )  # API request
+    job.result()  # Waits for job to complete.
+
+    assert job.state == "DONE"
+    dest_table = client.get_table(dest_table_ref)
+    assert dest_table.encryption_configuration.kms_key_name == kms_key_name
+    # [END bigquery_copy_table_cmek]
+
+
+def test_extract_table(client, to_delete):
+    bucket_name = "extract_shakespeare_{}".format(_millis())
+    storage_client = storage.Client()
+    bucket = retry_storage_errors(storage_client.create_bucket)(bucket_name)
+    to_delete.append(bucket)
+
+    # [START bigquery_extract_table]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # bucket_name = 'my-bucket'
+    project = "bigquery-public-data"
+    dataset_id = "samples"
+    table_id = "shakespeare"
+
+    destination_uri = "gs://{}/{}".format(bucket_name, "shakespeare.csv")
+    dataset_ref = client.dataset(dataset_id, project=project)
+    table_ref = dataset_ref.table(table_id)
+
+    extract_job = client.extract_table(
+        table_ref,
+        destination_uri,
+        # Location must match that of the source table.
+        location="US",
+    )  # API request
+    extract_job.result()  # Waits for job to complete.
+
+    print(
+        "Exported {}:{}.{} to {}".format(project, dataset_id, table_id, destination_uri)
+    )
+    # [END bigquery_extract_table]
+
+    blob = retry_storage_errors(bucket.get_blob)("shakespeare.csv")
+    assert blob.exists
+    assert blob.size > 0
+    to_delete.insert(0, blob)
+
+
+def test_extract_table_json(client, to_delete):
+    bucket_name = "extract_shakespeare_json_{}".format(_millis())
+    storage_client = storage.Client()
+    bucket = retry_storage_errors(storage_client.create_bucket)(bucket_name)
+    to_delete.append(bucket)
+
+    # [START bigquery_extract_table_json]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # bucket_name = 'my-bucket'
+
+    destination_uri = "gs://{}/{}".format(bucket_name, "shakespeare.json")
+    dataset_ref = client.dataset("samples", project="bigquery-public-data")
+    table_ref = dataset_ref.table("shakespeare")
+    job_config = bigquery.job.ExtractJobConfig()
+    job_config.destination_format = bigquery.DestinationFormat.NEWLINE_DELIMITED_JSON
+
+    extract_job = client.extract_table(
+        table_ref,
+        destination_uri,
+        job_config=job_config,
+        # Location must match that of the source table.
+        location="US",
+    )  # API request
+    extract_job.result()  # Waits for job to complete.
+    # [END bigquery_extract_table_json]
+
+    blob = retry_storage_errors(bucket.get_blob)("shakespeare.json")
+    assert blob.exists
+    assert blob.size > 0
+    to_delete.insert(0, blob)
+
+
+def test_extract_table_compressed(client, to_delete):
+    bucket_name = "extract_shakespeare_compress_{}".format(_millis())
+    storage_client = storage.Client()
+    bucket = retry_storage_errors(storage_client.create_bucket)(bucket_name)
+    to_delete.append(bucket)
+
+    # [START bigquery_extract_table_compressed]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # bucket_name = 'my-bucket'
+
+    destination_uri = "gs://{}/{}".format(bucket_name, "shakespeare.csv.gz")
+    dataset_ref = client.dataset("samples", project="bigquery-public-data")
+    table_ref = dataset_ref.table("shakespeare")
+    job_config = bigquery.job.ExtractJobConfig()
+    job_config.compression = bigquery.Compression.GZIP
+
+    extract_job = client.extract_table(
+        table_ref,
+        destination_uri,
+        # Location must match that of the source table.
+        location="US",
+        job_config=job_config,
+    )  # API request
+    extract_job.result()  # Waits for job to complete.
+    # [END bigquery_extract_table_compressed]
+
+    blob = retry_storage_errors(bucket.get_blob)("shakespeare.csv.gz")
+    assert blob.exists
+    assert blob.size > 0
+    to_delete.insert(0, blob)
+
+
+def test_undelete_table(client, to_delete):
+    dataset_id = "undelete_table_dataset_{}".format(_millis())
+    table_id = "undelete_table_table_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    dataset.location = "US"
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table = bigquery.Table(dataset.table(table_id), schema=SCHEMA)
+    client.create_table(table)
+
+    # [START bigquery_undelete_table]
+    # TODO(developer): Uncomment the lines below and replace with your values.
+    # import time
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'  # Replace with your dataset ID.
+    # table_id = 'my_table'      # Replace with your table ID.
+
+    table_ref = client.dataset(dataset_id).table(table_id)
+
+    # TODO(developer): Choose an appropriate snapshot point as epoch
+    # milliseconds. For this example, we choose the current time as we're about
+    # to delete the table immediately afterwards.
+    snapshot_epoch = int(time.time() * 1000)
+    # [END bigquery_undelete_table]
+
+    # Due to very short lifecycle of the table, ensure we're not picking a time
+    # prior to the table creation due to time drift between backend and client.
+    table = client.get_table(table_ref)
+    created_epoch = datetime_helpers.to_microseconds(table.created)
+    if created_epoch > snapshot_epoch:
+        snapshot_epoch = created_epoch
+
+    # [START bigquery_undelete_table]
+
+    # "Accidentally" delete the table.
+    client.delete_table(table_ref)  # API request
+
+    # Construct the restore-from table ID using a snapshot decorator.
+    snapshot_table_id = "{}@{}".format(table_id, snapshot_epoch)
+    source_table_ref = client.dataset(dataset_id).table(snapshot_table_id)
+
+    # Choose a new table ID for the recovered table data.
+    recovered_table_id = "{}_recovered".format(table_id)
+    dest_table_ref = client.dataset(dataset_id).table(recovered_table_id)
+
+    # Construct and run a copy job.
+    job = client.copy_table(
+        source_table_ref,
+        dest_table_ref,
+        # Location must match that of the source and destination tables.
+        location="US",
+    )  # API request
+
+    job.result()  # Waits for job to complete.
+
+    print(
+        "Copied data from deleted table {} to {}".format(table_id, recovered_table_id)
+    )
+    # [END bigquery_undelete_table]
+
+
+def test_client_query(client):
+    """Run a simple query."""
+
+    # [START bigquery_query]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = (
+        "SELECT name FROM `bigquery-public-data.usa_names.usa_1910_2013` "
+        'WHERE state = "TX" '
+        "LIMIT 100"
+    )
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+    )  # API request - starts the query
+
+    for row in query_job:  # API request - fetches results
+        # Row values can be accessed by field name or index
+        assert row[0] == row.name == row["name"]
+        print(row)
+    # [END bigquery_query]
+
+
+def test_client_query_legacy_sql(client):
+    """Run a query with Legacy SQL explicitly set"""
+    # [START bigquery_query_legacy]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = (
+        "SELECT name FROM [bigquery-public-data:usa_names.usa_1910_2013] "
+        'WHERE state = "TX" '
+        "LIMIT 100"
+    )
+
+    # Set use_legacy_sql to True to use legacy SQL syntax.
+    job_config = bigquery.QueryJobConfig()
+    job_config.use_legacy_sql = True
+
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    # Print the results.
+    for row in query_job:  # API request - fetches results
+        print(row)
+    # [END bigquery_query_legacy]
+
+
+def test_client_query_total_rows(client, capsys):
+    """Run a query and just check for how many rows."""
+    # [START bigquery_query_total_rows]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = (
+        "SELECT name FROM `bigquery-public-data.usa_names.usa_1910_2013` "
+        'WHERE state = "TX" '
+        "LIMIT 100"
+    )
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+    )  # API request - starts the query
+
+    results = query_job.result()  # Wait for query to complete.
+    print("Got {} rows.".format(results.total_rows))
+    # [END bigquery_query_total_rows]
+
+    out, _ = capsys.readouterr()
+    assert "Got 100 rows." in out
+
+
+def test_manage_job(client):
+    sql = """
+        SELECT corpus
+        FROM `bigquery-public-data.samples.shakespeare`
+        GROUP BY corpus;
+    """
+    location = "us"
+    job = client.query(sql, location=location)
+    job_id = job.job_id
+
+    # [START bigquery_cancel_job]
+    # TODO(developer): Uncomment the lines below and replace with your values.
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # job_id = 'bq-job-123x456-123y123z123c'  # replace with your job ID
+    # location = 'us'                         # replace with your location
+
+    job = client.cancel_job(job_id, location=location)
+    # [END bigquery_cancel_job]
+
+    # [START bigquery_get_job]
+    # TODO(developer): Uncomment the lines below and replace with your values.
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # job_id = 'bq-job-123x456-123y123z123c'  # replace with your job ID
+    # location = 'us'                         # replace with your location
+
+    job = client.get_job(job_id, location=location)  # API request
+
+    # Print selected job properties
+    print("Details for job {} running in {}:".format(job_id, location))
+    print(
+        "\tType: {}\n\tState: {}\n\tCreated: {}".format(
+            job.job_type, job.state, job.created
+        )
+    )
+    # [END bigquery_get_job]
+
+
+def test_client_query_destination_table(client, to_delete):
+    """Run a query"""
+    dataset_id = "query_destination_table_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    to_delete.append(dataset_ref)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    client.create_dataset(dataset)
+
+    # [START bigquery_query_destination_table]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'your_dataset_id'
+
+    job_config = bigquery.QueryJobConfig()
+    # Set the destination table
+    table_ref = client.dataset(dataset_id).table("your_table_id")
+    job_config.destination = table_ref
+    sql = """
+        SELECT corpus
+        FROM `bigquery-public-data.samples.shakespeare`
+        GROUP BY corpus;
+    """
+
+    # Start the query, passing in the extra configuration.
+    query_job = client.query(
+        sql,
+        # Location must match that of the dataset(s) referenced in the query
+        # and of the destination table.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    query_job.result()  # Waits for the query to finish
+    print("Query results loaded to table {}".format(table_ref.path))
+    # [END bigquery_query_destination_table]
+
+
+def test_client_query_destination_table_legacy(client, to_delete):
+    dataset_id = "query_destination_table_legacy_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    to_delete.append(dataset_ref)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    client.create_dataset(dataset)
+
+    # [START bigquery_query_legacy_large_results]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'your_dataset_id'
+
+    job_config = bigquery.QueryJobConfig()
+    # Set use_legacy_sql to True to use legacy SQL syntax.
+    job_config.use_legacy_sql = True
+    # Set the destination table
+    table_ref = client.dataset(dataset_id).table("your_table_id")
+    job_config.destination = table_ref
+    job_config.allow_large_results = True
+    sql = """
+        SELECT corpus
+        FROM [bigquery-public-data:samples.shakespeare]
+        GROUP BY corpus;
+    """
+    # Start the query, passing in the extra configuration.
+    query_job = client.query(
+        sql,
+        # Location must match that of the dataset(s) referenced in the query
+        # and of the destination table.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    query_job.result()  # Waits for the query to finish
+    print("Query results loaded to table {}".format(table_ref.path))
+    # [END bigquery_query_legacy_large_results]
+
+
+def test_client_query_destination_table_cmek(client, to_delete):
+    """Run a query"""
+    dataset_id = "query_destination_table_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    to_delete.append(dataset_ref)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    client.create_dataset(dataset)
+
+    # [START bigquery_query_destination_table_cmek]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    job_config = bigquery.QueryJobConfig()
+
+    # Set the destination table. Here, dataset_id is a string, such as:
+    # dataset_id = 'your_dataset_id'
+    table_ref = client.dataset(dataset_id).table("your_table_id")
+    job_config.destination = table_ref
+
+    # Set the encryption key to use for the destination.
+    # TODO: Replace this key with a key you have created in KMS.
+    kms_key_name = "projects/{}/locations/{}/keyRings/{}/cryptoKeys/{}".format(
+        "cloud-samples-tests", "us-central1", "test", "test"
+    )
+    encryption_config = bigquery.EncryptionConfiguration(kms_key_name=kms_key_name)
+    job_config.destination_encryption_configuration = encryption_config
+
+    # Start the query, passing in the extra configuration.
+    query_job = client.query(
+        "SELECT 17 AS my_col;",
+        # Location must match that of the dataset(s) referenced in the query
+        # and of the destination table.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+    query_job.result()
+
+    # The destination table is written using the encryption configuration.
+    table = client.get_table(table_ref)
+    assert table.encryption_configuration.kms_key_name == kms_key_name
+    # [END bigquery_query_destination_table_cmek]
+
+
+def test_client_query_batch(client, to_delete):
+    # [START bigquery_query_batch]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    job_config = bigquery.QueryJobConfig()
+    # Run at batch priority, which won't count toward concurrent rate limit.
+    job_config.priority = bigquery.QueryPriority.BATCH
+    sql = """
+        SELECT corpus
+        FROM `bigquery-public-data.samples.shakespeare`
+        GROUP BY corpus;
+    """
+    # Location must match that of the dataset(s) referenced in the query.
+    location = "US"
+
+    # API request - starts the query
+    query_job = client.query(sql, location=location, job_config=job_config)
+
+    # Check on the progress by getting the job's updated state. Once the state
+    # is `DONE`, the results are ready.
+    query_job = client.get_job(
+        query_job.job_id, location=location
+    )  # API request - fetches job
+    print("Job {} is currently in state {}".format(query_job.job_id, query_job.state))
+    # [END bigquery_query_batch]
+
+
+def test_client_query_relax_column(client, to_delete):
+    dataset_id = "query_relax_column_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table_ref = dataset_ref.table("my_table")
+    schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+    ]
+    table = client.create_table(bigquery.Table(table_ref, schema=schema))
+
+    # [START bigquery_relax_column_query_append]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_ref = client.dataset('my_dataset')
+
+    # Retrieves the destination table and checks the number of required fields
+    table_id = "my_table"
+    table_ref = dataset_ref.table(table_id)
+    table = client.get_table(table_ref)
+    original_required_fields = sum(field.mode == "REQUIRED" for field in table.schema)
+    # In this example, the existing table has 2 required fields
+    print("{} fields in the schema are required.".format(original_required_fields))
+
+    # Configures the query to append the results to a destination table,
+    # allowing field relaxation
+    job_config = bigquery.QueryJobConfig()
+    job_config.schema_update_options = [
+        bigquery.SchemaUpdateOption.ALLOW_FIELD_RELAXATION
+    ]
+    job_config.destination = table_ref
+    job_config.write_disposition = bigquery.WriteDisposition.WRITE_APPEND
+
+    query_job = client.query(
+        # In this example, the existing table contains 'full_name' and 'age' as
+        # required columns, but the query results will omit the second column.
+        'SELECT "Beyonce" as full_name;',
+        # Location must match that of the dataset(s) referenced in the query
+        # and of the destination table.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    query_job.result()  # Waits for the query to finish
+    print("Query job {} complete.".format(query_job.job_id))
+
+    # Checks the updated number of required fields
+    table = client.get_table(table)
+    current_required_fields = sum(field.mode == "REQUIRED" for field in table.schema)
+    print("{} fields in the schema are now required.".format(current_required_fields))
+    # [END bigquery_relax_column_query_append]
+    assert original_required_fields - current_required_fields > 0
+    assert len(table.schema) == 2
+    assert table.schema[1].mode == "NULLABLE"
+    assert table.num_rows > 0
+
+
+def test_client_query_add_column(client, to_delete):
+    dataset_id = "query_add_column_{}".format(_millis())
+    dataset_ref = client.dataset(dataset_id)
+    dataset = bigquery.Dataset(dataset_ref)
+    dataset.location = "US"
+    dataset = client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    table_ref = dataset_ref.table("my_table")
+    schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+    ]
+    table = client.create_table(bigquery.Table(table_ref, schema=schema))
+
+    # [START bigquery_add_column_query_append]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_ref = client.dataset('my_dataset')
+
+    # Retrieves the destination table and checks the length of the schema
+    table_id = "my_table"
+    table_ref = dataset_ref.table(table_id)
+    table = client.get_table(table_ref)
+    print("Table {} contains {} columns.".format(table_id, len(table.schema)))
+
+    # Configures the query to append the results to a destination table,
+    # allowing field addition
+    job_config = bigquery.QueryJobConfig()
+    job_config.schema_update_options = [
+        bigquery.SchemaUpdateOption.ALLOW_FIELD_ADDITION
+    ]
+    job_config.destination = table_ref
+    job_config.write_disposition = bigquery.WriteDisposition.WRITE_APPEND
+
+    query_job = client.query(
+        # In this example, the existing table contains only the 'full_name' and
+        # 'age' columns, while the results of this query will contain an
+        # additional 'favorite_color' column.
+        'SELECT "Timmy" as full_name, 85 as age, "Blue" as favorite_color;',
+        # Location must match that of the dataset(s) referenced in the query
+        # and of the destination table.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    query_job.result()  # Waits for the query to finish
+    print("Query job {} complete.".format(query_job.job_id))
+
+    # Checks the updated length of the schema
+    table = client.get_table(table)
+    print("Table {} now contains {} columns.".format(table_id, len(table.schema)))
+    # [END bigquery_add_column_query_append]
+    assert len(table.schema) == 3
+    assert table.num_rows > 0
+
+
+def test_client_query_w_named_params(client, capsys):
+    """Run a query using named query parameters"""
+
+    # [START bigquery_query_params_named]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = """
+        SELECT word, word_count
+        FROM `bigquery-public-data.samples.shakespeare`
+        WHERE corpus = @corpus
+        AND word_count >= @min_word_count
+        ORDER BY word_count DESC;
+    """
+    query_params = [
+        bigquery.ScalarQueryParameter("corpus", "STRING", "romeoandjuliet"),
+        bigquery.ScalarQueryParameter("min_word_count", "INT64", 250),
+    ]
+    job_config = bigquery.QueryJobConfig()
+    job_config.query_parameters = query_params
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    # Print the results
+    for row in query_job:
+        print("{}: \t{}".format(row.word, row.word_count))
+
+    assert query_job.state == "DONE"
+    # [END bigquery_query_params_named]
+
+    out, _ = capsys.readouterr()
+    assert "the" in out
+
+
+def test_client_query_w_positional_params(client, capsys):
+    """Run a query using query parameters"""
+
+    # [START bigquery_query_params_positional]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = """
+        SELECT word, word_count
+        FROM `bigquery-public-data.samples.shakespeare`
+        WHERE corpus = ?
+        AND word_count >= ?
+        ORDER BY word_count DESC;
+    """
+    # Set the name to None to use positional parameters.
+    # Note that you cannot mix named and positional parameters.
+    query_params = [
+        bigquery.ScalarQueryParameter(None, "STRING", "romeoandjuliet"),
+        bigquery.ScalarQueryParameter(None, "INT64", 250),
+    ]
+    job_config = bigquery.QueryJobConfig()
+    job_config.query_parameters = query_params
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    # Print the results
+    for row in query_job:
+        print("{}: \t{}".format(row.word, row.word_count))
+
+    assert query_job.state == "DONE"
+    # [END bigquery_query_params_positional]
+
+    out, _ = capsys.readouterr()
+    assert "the" in out
+
+
+def test_client_query_w_timestamp_params(client, capsys):
+    """Run a query using query parameters"""
+
+    # [START bigquery_query_params_timestamps]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    import datetime
+    import pytz
+
+    query = "SELECT TIMESTAMP_ADD(@ts_value, INTERVAL 1 HOUR);"
+    query_params = [
+        bigquery.ScalarQueryParameter(
+            "ts_value",
+            "TIMESTAMP",
+            datetime.datetime(2016, 12, 7, 8, 0, tzinfo=pytz.UTC),
+        )
+    ]
+    job_config = bigquery.QueryJobConfig()
+    job_config.query_parameters = query_params
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    # Print the results
+    for row in query_job:
+        print(row)
+
+    assert query_job.state == "DONE"
+    # [END bigquery_query_params_timestamps]
+
+    out, _ = capsys.readouterr()
+    assert "2016, 12, 7, 9, 0" in out
+
+
+def test_client_query_w_array_params(client, capsys):
+    """Run a query using array query parameters"""
+    # [START bigquery_query_params_arrays]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = """
+        SELECT name, sum(number) as count
+        FROM `bigquery-public-data.usa_names.usa_1910_2013`
+        WHERE gender = @gender
+        AND state IN UNNEST(@states)
+        GROUP BY name
+        ORDER BY count DESC
+        LIMIT 10;
+    """
+    query_params = [
+        bigquery.ScalarQueryParameter("gender", "STRING", "M"),
+        bigquery.ArrayQueryParameter("states", "STRING", ["WA", "WI", "WV", "WY"]),
+    ]
+    job_config = bigquery.QueryJobConfig()
+    job_config.query_parameters = query_params
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    # Print the results
+    for row in query_job:
+        print("{}: \t{}".format(row.name, row.count))
+
+    assert query_job.state == "DONE"
+    # [END bigquery_query_params_arrays]
+
+    out, _ = capsys.readouterr()
+    assert "James" in out
+
+
+def test_client_query_w_struct_params(client, capsys):
+    """Run a query using struct query parameters"""
+    # [START bigquery_query_params_structs]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    query = "SELECT @struct_value AS s;"
+    query_params = [
+        bigquery.StructQueryParameter(
+            "struct_value",
+            bigquery.ScalarQueryParameter("x", "INT64", 1),
+            bigquery.ScalarQueryParameter("y", "STRING", "foo"),
+        )
+    ]
+    job_config = bigquery.QueryJobConfig()
+    job_config.query_parameters = query_params
+    query_job = client.query(
+        query,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request - starts the query
+
+    # Print the results
+    for row in query_job:
+        print(row.s)
+
+    assert query_job.state == "DONE"
+    # [END bigquery_query_params_structs]
+
+    out, _ = capsys.readouterr()
+    assert "1" in out
+    assert "foo" in out
+
+
+def test_client_query_dry_run(client):
+    """Run a dry run query"""
+
+    # [START bigquery_query_dry_run]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    job_config = bigquery.QueryJobConfig()
+    job_config.dry_run = True
+    job_config.use_query_cache = False
+    query_job = client.query(
+        (
+            "SELECT name, COUNT(*) as name_count "
+            "FROM `bigquery-public-data.usa_names.usa_1910_2013` "
+            "WHERE state = 'WA' "
+            "GROUP BY name"
+        ),
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request
+
+    # A dry run query completes immediately.
+    assert query_job.state == "DONE"
+    assert query_job.dry_run
+
+    print("This query will process {} bytes.".format(query_job.total_bytes_processed))
+    # [END bigquery_query_dry_run]
+
+    assert query_job.total_bytes_processed > 0
+
+
+def test_query_no_cache(client):
+    # [START bigquery_query_no_cache]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    job_config = bigquery.QueryJobConfig()
+    job_config.use_query_cache = False
+    sql = """
+        SELECT corpus
+        FROM `bigquery-public-data.samples.shakespeare`
+        GROUP BY corpus;
+    """
+    query_job = client.query(
+        sql,
+        # Location must match that of the dataset(s) referenced in the query.
+        location="US",
+        job_config=job_config,
+    )  # API request
+
+    # Print the results.
+    for row in query_job:  # API request - fetches results
+        print(row)
+    # [END bigquery_query_no_cache]
+
+
+def test_query_external_gcs_temporary_table(client):
+    # [START bigquery_query_external_gcs_temp]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    # Configure the external data source and query job
+    external_config = bigquery.ExternalConfig("CSV")
+    external_config.source_uris = [
+        "gs://cloud-samples-data/bigquery/us-states/us-states.csv"
+    ]
+    external_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    external_config.options.skip_leading_rows = 1  # optionally skip header row
+    table_id = "us_states"
+    job_config = bigquery.QueryJobConfig()
+    job_config.table_definitions = {table_id: external_config}
+
+    # Example query to find states starting with 'W'
+    sql = 'SELECT * FROM `{}` WHERE name LIKE "W%"'.format(table_id)
+
+    query_job = client.query(sql, job_config=job_config)  # API request
+
+    w_states = list(query_job)  # Waits for query to finish
+    print("There are {} states with names starting with W.".format(len(w_states)))
+    # [END bigquery_query_external_gcs_temp]
+    assert len(w_states) == 4
+
+
+def test_query_external_gcs_permanent_table(client, to_delete):
+    dataset_id = "query_external_gcs_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_query_external_gcs_perm]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+    # dataset_id = 'my_dataset'
+
+    # Configure the external data source
+    dataset_ref = client.dataset(dataset_id)
+    table_id = "us_states"
+    schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    table = bigquery.Table(dataset_ref.table(table_id), schema=schema)
+    external_config = bigquery.ExternalConfig("CSV")
+    external_config.source_uris = [
+        "gs://cloud-samples-data/bigquery/us-states/us-states.csv"
+    ]
+    external_config.options.skip_leading_rows = 1  # optionally skip header row
+    table.external_data_configuration = external_config
+
+    # Create a permanent table linked to the GCS file
+    table = client.create_table(table)  # API request
+
+    # Example query to find states starting with 'W'
+    sql = 'SELECT * FROM `{}.{}` WHERE name LIKE "W%"'.format(dataset_id, table_id)
+
+    query_job = client.query(sql)  # API request
+
+    w_states = list(query_job)  # Waits for query to finish
+    print("There are {} states with names starting with W.".format(len(w_states)))
+    # [END bigquery_query_external_gcs_perm]
+    assert len(w_states) == 4
+
+
+def test_query_external_sheets_temporary_table(client):
+    # [START bigquery_query_external_sheets_temp]
+    # [START bigquery_auth_drive_scope]
+    import google.auth
+
+    # from google.cloud import bigquery
+
+    # Create credentials with Drive & BigQuery API scopes
+    # Both APIs must be enabled for your project before running this code
+    credentials, project = google.auth.default(
+        scopes=[
+            "https://www.googleapis.com/auth/drive",
+            "https://www.googleapis.com/auth/bigquery",
+        ]
+    )
+    client = bigquery.Client(credentials=credentials, project=project)
+    # [END bigquery_auth_drive_scope]
+
+    # Configure the external data source and query job
+    external_config = bigquery.ExternalConfig("GOOGLE_SHEETS")
+    # Use a shareable link or grant viewing access to the email address you
+    # used to authenticate with BigQuery (this example Sheet is public)
+    sheet_url = (
+        "https://docs.google.com/spreadsheets"
+        "/d/1i_QCL-7HcSyUZmIbP9E6lO_T5u3HnpLe7dnpHaijg_E/edit?usp=sharing"
+    )
+    external_config.source_uris = [sheet_url]
+    external_config.schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    external_config.options.skip_leading_rows = 1  # optionally skip header row
+    table_id = "us_states"
+    job_config = bigquery.QueryJobConfig()
+    job_config.table_definitions = {table_id: external_config}
+
+    # Example query to find states starting with 'W'
+    sql = 'SELECT * FROM `{}` WHERE name LIKE "W%"'.format(table_id)
+
+    query_job = client.query(sql, job_config=job_config)  # API request
+
+    w_states = list(query_job)  # Waits for query to finish
+    print("There are {} states with names starting with W.".format(len(w_states)))
+    # [END bigquery_query_external_sheets_temp]
+    assert len(w_states) == 4
+
+
+def test_query_external_sheets_permanent_table(client, to_delete):
+    dataset_id = "query_external_sheets_{}".format(_millis())
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_query_external_sheets_perm]
+    import google.auth
+
+    # from google.cloud import bigquery
+    # dataset_id = 'my_dataset'
+
+    # Create credentials with Drive & BigQuery API scopes
+    # Both APIs must be enabled for your project before running this code
+    credentials, project = google.auth.default(
+        scopes=[
+            "https://www.googleapis.com/auth/drive",
+            "https://www.googleapis.com/auth/bigquery",
+        ]
+    )
+    client = bigquery.Client(credentials=credentials, project=project)
+
+    # Configure the external data source
+    dataset_ref = client.dataset(dataset_id)
+    table_id = "us_states"
+    schema = [
+        bigquery.SchemaField("name", "STRING"),
+        bigquery.SchemaField("post_abbr", "STRING"),
+    ]
+    table = bigquery.Table(dataset_ref.table(table_id), schema=schema)
+    external_config = bigquery.ExternalConfig("GOOGLE_SHEETS")
+    # Use a shareable link or grant viewing access to the email address you
+    # used to authenticate with BigQuery (this example Sheet is public)
+    sheet_url = (
+        "https://docs.google.com/spreadsheets"
+        "/d/1i_QCL-7HcSyUZmIbP9E6lO_T5u3HnpLe7dnpHaijg_E/edit?usp=sharing"
+    )
+    external_config.source_uris = [sheet_url]
+    external_config.options.skip_leading_rows = 1  # optionally skip header row
+    table.external_data_configuration = external_config
+
+    # Create a permanent table linked to the Sheets file
+    table = client.create_table(table)  # API request
+
+    # Example query to find states starting with 'W'
+    sql = 'SELECT * FROM `{}.{}` WHERE name LIKE "W%"'.format(dataset_id, table_id)
+
+    query_job = client.query(sql)  # API request
+
+    w_states = list(query_job)  # Waits for query to finish
+    print("There are {} states with names starting with W.".format(len(w_states)))
+    # [END bigquery_query_external_sheets_perm]
+    assert len(w_states) == 4
+
+
+def test_ddl_create_view(client, to_delete, capsys):
+    """Create a view via a DDL query."""
+    project = client.project
+    dataset_id = "ddl_view_{}".format(_millis())
+    table_id = "new_view"
+    dataset = bigquery.Dataset(client.dataset(dataset_id))
+    client.create_dataset(dataset)
+    to_delete.append(dataset)
+
+    # [START bigquery_ddl_create_view]
+    # from google.cloud import bigquery
+    # project = 'my-project'
+    # dataset_id = 'my_dataset'
+    # table_id = 'new_view'
+    # client = bigquery.Client(project=project)
+
+    sql = """
+    CREATE VIEW `{}.{}.{}`
+    OPTIONS(
+        expiration_timestamp=TIMESTAMP_ADD(
+            CURRENT_TIMESTAMP(), INTERVAL 48 HOUR),
+        friendly_name="new_view",
+        description="a view that expires in 2 days",
+        labels=[("org_unit", "development")]
+    )
+    AS SELECT name, state, year, number
+        FROM `bigquery-public-data.usa_names.usa_1910_current`
+        WHERE state LIKE 'W%'
+    """.format(
+        project, dataset_id, table_id
+    )
+
+    job = client.query(sql)  # API request.
+    job.result()  # Waits for the query to finish.
+
+    print(
+        'Created new view "{}.{}.{}".'.format(
+            job.destination.project,
+            job.destination.dataset_id,
+            job.destination.table_id,
+        )
+    )
+    # [END bigquery_ddl_create_view]
+
+    out, _ = capsys.readouterr()
+    assert 'Created new view "{}.{}.{}".'.format(project, dataset_id, table_id) in out
+
+    # Test that listing query result rows succeeds so that generic query
+    # processing tools work with DDL statements.
+    rows = list(job)
+    assert len(rows) == 0
+
+    if pandas is not None:
+        df = job.to_dataframe()
+        assert len(df) == 0
+
+
+def test_client_list_jobs(client):
+    """List jobs for a project."""
+
+    # [START bigquery_list_jobs]
+    # TODO(developer): Uncomment the lines below and replace with your values.
+    # from google.cloud import bigquery
+    # project = 'my_project'  # replace with your project ID
+    # client = bigquery.Client(project=project)
+    import datetime
+
+    # List the 10 most recent jobs in reverse chronological order.
+    # Omit the max_results parameter to list jobs from the past 6 months.
+    print("Last 10 jobs:")
+    for job in client.list_jobs(max_results=10):  # API request(s)
+        print(job.job_id)
+
+    # The following are examples of additional optional parameters:
+
+    # Use min_creation_time and/or max_creation_time to specify a time window.
+    print("Jobs from the last ten minutes:")
+    ten_mins_ago = datetime.datetime.utcnow() - datetime.timedelta(minutes=10)
+    for job in client.list_jobs(min_creation_time=ten_mins_ago):
+        print(job.job_id)
+
+    # Use all_users to include jobs run by all users in the project.
+    print("Last 10 jobs run by all users:")
+    for job in client.list_jobs(max_results=10, all_users=True):
+        print("{} run by user: {}".format(job.job_id, job.user_email))
+
+    # Use state_filter to filter by job state.
+    print("Jobs currently running:")
+    for job in client.list_jobs(state_filter="RUNNING"):
+        print(job.job_id)
+    # [END bigquery_list_jobs]
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_query_results_as_dataframe(client):
+    # [START bigquery_query_results_dataframe]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    sql = """
+        SELECT name, SUM(number) as count
+        FROM `bigquery-public-data.usa_names.usa_1910_current`
+        GROUP BY name
+        ORDER BY count DESC
+        LIMIT 10
+    """
+
+    df = client.query(sql).to_dataframe()
+    # [END bigquery_query_results_dataframe]
+    assert isinstance(df, pandas.DataFrame)
+    assert len(list(df)) == 2  # verify the number of columns
+    assert len(df) == 10  # verify the number of rows
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_list_rows_as_dataframe(client):
+    # [START bigquery_list_rows_dataframe]
+    # from google.cloud import bigquery
+    # client = bigquery.Client()
+
+    dataset_ref = client.dataset("samples", project="bigquery-public-data")
+    table_ref = dataset_ref.table("shakespeare")
+    table = client.get_table(table_ref)
+
+    df = client.list_rows(table).to_dataframe()
+    # [END bigquery_list_rows_dataframe]
+    assert isinstance(df, pandas.DataFrame)
+    assert len(list(df)) == len(table.schema)  # verify the number of columns
+    assert len(df) == table.num_rows  # verify the number of rows
+
+
+if __name__ == "__main__":
+    pytest.main()
diff --git a/bigquery/docs/usage.html b/bigquery/docs/usage.html
new file mode 100644
index 000000000000..78dc14b9ca03
--- /dev/null
+++ b/bigquery/docs/usage.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./usage/index.html:" />
+ <script>
+   window.location.href = "./usage/index.html"
+ </script>
+</head>
+</html>
diff --git a/bigquery/docs/usage/client.rst b/bigquery/docs/usage/client.rst
new file mode 100644
index 000000000000..d631585ea2fe
--- /dev/null
+++ b/bigquery/docs/usage/client.rst
@@ -0,0 +1,25 @@
+Creating a Client
+~~~~~~~~~~~~~~~~~
+
+A project is the top-level container in the ``BigQuery`` API:  it is tied
+closely to billing, and can provide default access control across all its
+datasets.  If no ``project`` is passed to the client container, the library
+attempts to infer a project using the environment (including explicit
+environment variables, GAE, and GCE).
+
+To override the project inferred from the environment, pass an explicit
+``project`` to the :class:`~google.cloud.bigquery.client.Client` constructor,
+or to either of the alternative ``classmethod`` factories:
+
+.. code-block:: python
+
+   from google.cloud import bigquery
+   client = bigquery.Client(project='PROJECT_ID')
+
+
+Project ACLs
+^^^^^^^^^^^^
+
+Each project has an access control list granting reader / writer / owner
+permission to one or more entities.  This list cannot be queried or set
+via the API; it must be managed using the Google Developer Console.
diff --git a/bigquery/docs/usage/datasets.rst b/bigquery/docs/usage/datasets.rst
new file mode 100644
index 000000000000..2daee77f36d2
--- /dev/null
+++ b/bigquery/docs/usage/datasets.rst
@@ -0,0 +1,131 @@
+Managing Datasets
+~~~~~~~~~~~~~~~~~
+
+A dataset represents a collection of tables, and applies several default
+policies to tables as they are created:
+
+- An access control list (ACL).  When created, a dataset has an ACL
+  which maps to the ACL inherited from its project.
+
+- A default table expiration period.  If set, tables created within the
+  dataset will have the value as their expiration period.
+
+See BigQuery documentation for more information on
+`Datasets <https://cloud.google.com/bigquery/docs/datasets>`_.
+
+Listing Datasets
+^^^^^^^^^^^^^^^^
+
+List datasets for a project with the
+:func:`~google.cloud.bigquery.client.Client.list_datasets` method:
+
+.. literalinclude:: ../samples/list_datasets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_list_datasets]
+   :end-before: [END bigquery_list_datasets]
+
+List datasets by label for a project with the
+:func:`~google.cloud.bigquery.client.Client.list_datasets` method:
+
+.. literalinclude:: ../samples/list_datasets_by_label.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_list_datasets_by_label]
+   :end-before: [END bigquery_list_datasets_by_label]
+
+Getting a Dataset
+^^^^^^^^^^^^^^^^^
+
+Get a dataset resource (to pick up changes made by another client) with the
+:func:`~google.cloud.bigquery.client.Client.get_dataset` method:
+
+.. literalinclude:: ../samples/get_dataset.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_get_dataset]
+   :end-before: [END bigquery_get_dataset]
+
+Determine if a dataset exists with the
+:func:`~google.cloud.bigquery.client.Client.get_dataset` method:
+
+.. literalinclude:: ../samples/dataset_exists.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_dataset_exists]
+   :end-before: [END bigquery_dataset_exists]
+
+Creating a Dataset
+^^^^^^^^^^^^^^^^^^
+
+Create a new dataset with the
+:func:`~google.cloud.bigquery.client.Client.create_dataset` method:
+
+.. literalinclude:: ../samples/create_dataset.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_create_dataset]
+   :end-before: [END bigquery_create_dataset]
+
+Updating a Dataset
+^^^^^^^^^^^^^^^^^^
+
+Update a property in a dataset's metadata with the
+:func:`~google.cloud.bigquery.client.Client.update_dataset` method:
+
+.. literalinclude:: ../samples/update_dataset_description.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_update_dataset_description]
+   :end-before: [END bigquery_update_dataset_description]
+
+Modify user permissions on a dataset with the
+:func:`~google.cloud.bigquery.client.Client.update_dataset` method:
+
+.. literalinclude:: ../samples/update_dataset_access.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_update_dataset_access]
+   :end-before: [END bigquery_update_dataset_access]
+
+Manage Dataset labels
+^^^^^^^^^^^^^^^^^^^^^
+
+Add labels to a dataset with the
+:func:`~google.cloud.bigquery.client.Client.update_dataset` method:
+
+.. literalinclude:: ../samples/label_dataset.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_label_dataset]
+   :end-before: [END bigquery_label_dataset]
+
+Get dataset's labels with the
+:func:`~google.cloud.bigquery.client.Client.get_dataset` method:
+
+.. literalinclude:: ../samples/get_dataset_labels.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_get_dataset_labels]
+   :end-before: [END bigquery_get_dataset_labels]
+   
+Delete dataset's labels with the
+:func:`~google.cloud.bigquery.client.Client.update_dataset` method:
+
+.. literalinclude:: ../samples/delete_dataset_labels.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_delete_label_dataset]
+   :end-before: [END bigquery_delete_label_dataset]
+
+Deleting a Dataset
+^^^^^^^^^^^^^^^^^^
+
+Delete a dataset with the
+:func:`~google.cloud.bigquery.client.Client.delete_dataset` method:
+
+.. literalinclude:: ../samples/delete_dataset.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_delete_dataset]
+   :end-before: [END bigquery_delete_dataset]
diff --git a/bigquery/docs/usage/encryption.rst b/bigquery/docs/usage/encryption.rst
new file mode 100644
index 000000000000..88d23067995e
--- /dev/null
+++ b/bigquery/docs/usage/encryption.rst
@@ -0,0 +1,52 @@
+Using Customer Managed Encryption Keys
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Table data is always encrypted at rest, but BigQuery also provides a way for
+you to control what keys it uses to encrypt they data. See `Protecting data
+with Cloud KMS keys
+<https://cloud.google.com/bigquery/docs/customer-managed-encryption>`_
+in the BigQuery documentation for more details.
+
+Create a new table, using a customer-managed encryption key from
+Cloud KMS to encrypt it.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_create_table_cmek]
+   :end-before: [END bigquery_create_table_cmek]
+
+Change the key used to encrypt a table.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_update_table_cmek]
+   :end-before: [END bigquery_update_table_cmek]
+
+Load a file from Cloud Storage, using a customer-managed encryption key from
+Cloud KMS for the destination table.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_load_table_gcs_json_cmek]
+   :end-before: [END bigquery_load_table_gcs_json_cmek]
+
+Copy a table, using a customer-managed encryption key from Cloud KMS for the
+destination table.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_copy_table_cmek]
+   :end-before: [END bigquery_copy_table_cmek]
+
+Write query results to a table, using a customer-managed encryption key from
+Cloud KMS for the destination table.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_query_destination_table_cmek]
+   :end-before: [END bigquery_query_destination_table_cmek]
diff --git a/bigquery/docs/usage/index.rst b/bigquery/docs/usage/index.rst
new file mode 100644
index 000000000000..ff4c9d7f1a8f
--- /dev/null
+++ b/bigquery/docs/usage/index.rst
@@ -0,0 +1,35 @@
+Usage Guides
+~~~~~~~~~~~~
+
+BigQuery Basics
+^^^^^^^^^^^^^^^
+
+.. toctree::
+  :maxdepth: 1
+
+  client
+  queries
+
+Working with BigQuery Resources
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. toctree::
+  :maxdepth: 1
+
+  datasets
+  tables
+  encryption
+  jobs
+
+Integrations with Other Libraries
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. toctree::
+  :maxdepth: 1
+
+  pandas
+
+See also, the :mod:`google.cloud.bigquery.magics` module for integrations
+with Jupyter.
+
+
diff --git a/bigquery/docs/usage/jobs.rst b/bigquery/docs/usage/jobs.rst
new file mode 100644
index 000000000000..914d1d459ee7
--- /dev/null
+++ b/bigquery/docs/usage/jobs.rst
@@ -0,0 +1,18 @@
+Managing Jobs
+~~~~~~~~~~~~~
+
+List jobs for a project
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Jobs describe actions performed on data in BigQuery tables:
+
+- Load data into a table
+- Run a query against data in one or more tables
+- Extract data from a table
+- Copy a table
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_list_jobs]
+   :end-before: [END bigquery_list_jobs]
diff --git a/bigquery/docs/usage/pandas.rst b/bigquery/docs/usage/pandas.rst
new file mode 100644
index 000000000000..9db98dfbbccb
--- /dev/null
+++ b/bigquery/docs/usage/pandas.rst
@@ -0,0 +1,62 @@
+Using BigQuery with Pandas
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Retrieve BigQuery data as a Pandas DataFrame
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As of version 0.29.0, you can use the
+:func:`~google.cloud.bigquery.table.RowIterator.to_dataframe` function to
+retrieve query results or table rows as a :class:`pandas.DataFrame`.
+
+First, ensure that the :mod:`pandas` library is installed by running:
+
+.. code-block:: bash
+
+   pip install --upgrade pandas
+
+Alternatively, you can install the BigQuery python client library with
+:mod:`pandas` by running:
+
+.. code-block:: bash
+
+   pip install --upgrade google-cloud-bigquery[pandas]
+
+To retrieve query results as a :class:`pandas.DataFrame`:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_query_results_dataframe]
+   :end-before: [END bigquery_query_results_dataframe]
+
+To retrieve table rows as a :class:`pandas.DataFrame`:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_list_rows_dataframe]
+   :end-before: [END bigquery_list_rows_dataframe]
+
+Load a Pandas DataFrame to a BigQuery Table
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As of version 1.3.0, you can use the
+:func:`~google.cloud.bigquery.client.Client.load_table_from_dataframe` function
+to load data from a :class:`pandas.DataFrame` to a
+:class:`~google.cloud.bigquery.table.Table`. To use this function, in addition
+to :mod:`pandas`, you will need to install the :mod:`pyarrow` library. You can
+install the BigQuery python client library with :mod:`pandas` and
+:mod:`pyarrow` by running:
+
+.. code-block:: bash
+
+   pip install --upgrade google-cloud-bigquery[pandas,pyarrow]
+
+The following example demonstrates how to create a :class:`pandas.DataFrame`
+and load it into a new table:
+
+.. literalinclude:: ../samples/load_table_dataframe.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_load_table_dataframe]
+   :end-before: [END bigquery_load_table_dataframe]
diff --git a/bigquery/docs/usage/queries.rst b/bigquery/docs/usage/queries.rst
new file mode 100644
index 000000000000..fc77bb5b80cd
--- /dev/null
+++ b/bigquery/docs/usage/queries.rst
@@ -0,0 +1,49 @@
+Running Queries
+~~~~~~~~~~~~~~~
+
+Querying data
+^^^^^^^^^^^^^
+
+Run a query and wait for it to finish:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_query]
+   :end-before: [END bigquery_query]
+
+
+Run a dry run query
+^^^^^^^^^^^^^^^^^^^
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_query_dry_run]
+   :end-before: [END bigquery_query_dry_run]
+
+
+Writing query results to a destination table
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+See BigQuery documentation for more information on
+`writing query results <https://cloud.google.com/bigquery/docs/writing-results>`_.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_query_destination_table]
+   :end-before: [END bigquery_query_destination_table]
+
+
+Run a query using a named query parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+See BigQuery documentation for more information on
+`parameterized queries <https://cloud.google.com/bigquery/docs/parameterized-queries>`_.
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_query_params_named]
+   :end-before: [END bigquery_query_params_named]
diff --git a/bigquery/docs/usage/tables.rst b/bigquery/docs/usage/tables.rst
new file mode 100644
index 000000000000..458c5b0009ba
--- /dev/null
+++ b/bigquery/docs/usage/tables.rst
@@ -0,0 +1,156 @@
+Managing Tables
+~~~~~~~~~~~~~~~
+
+Tables exist within datasets. See BigQuery documentation for more information
+on `Tables <https://cloud.google.com/bigquery/docs/tables>`_.
+
+Listing Tables
+^^^^^^^^^^^^^^
+
+List the tables belonging to a dataset with the
+:func:`~google.cloud.bigquery.client.Client.list_tables` method:
+
+.. literalinclude:: ../samples/list_tables.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_list_tables]
+   :end-before: [END bigquery_list_tables]
+
+Getting a Table
+^^^^^^^^^^^^^^^
+
+Get a table resource with the
+:func:`~google.cloud.bigquery.client.Client.get_table` method:
+
+.. literalinclude:: ../samples/get_table.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_get_table]
+   :end-before: [END bigquery_get_table]
+
+Browse data rows in a table with the
+:func:`~google.cloud.bigquery.client.Client.list_rows` method:
+
+.. literalinclude:: ../samples/browse_table_data.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_browse_table]
+   :end-before: [END bigquery_browse_table]
+
+Creating a Table
+^^^^^^^^^^^^^^^^
+
+Create an empty table with the
+:func:`~google.cloud.bigquery.client.Client.create_table` method:
+
+.. literalinclude:: ../samples/create_table.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_create_table]
+   :end-before: [END bigquery_create_table]
+
+Load table data from a file with the
+:func:`~google.cloud.bigquery.client.Client.load_table_from_file` method:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_load_from_file]
+   :end-before: [END bigquery_load_from_file]
+
+Load a CSV file from Cloud Storage with the
+:func:`~google.cloud.bigquery.client.Client.load_table_from_uri` method:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_load_table_gcs_csv]
+   :end-before: [END bigquery_load_table_gcs_csv]
+
+See also: `Loading CSV data from Cloud Storage
+<https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-csv>`_.
+
+Load a JSON file from Cloud Storage:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_load_table_gcs_json]
+   :end-before: [END bigquery_load_table_gcs_json]
+
+See also: `Loading JSON data from Cloud Storage
+<https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-json>`_.
+
+Load a Parquet file from Cloud Storage:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_load_table_gcs_parquet]
+   :end-before: [END bigquery_load_table_gcs_parquet]
+
+See also: `Loading Parquet data from Cloud Storage
+<https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-parquet>`_.
+
+Updating a Table
+^^^^^^^^^^^^^^^^
+
+Update a property in a table's metadata with the
+:func:`~google.cloud.bigquery.client.Client.update_table` method:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_update_table_description]
+   :end-before: [END bigquery_update_table_description]
+
+Insert rows into a table's data with the
+:func:`~google.cloud.bigquery.client.Client.insert_rows` method:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_table_insert_rows]
+   :end-before: [END bigquery_table_insert_rows]
+
+Add an empty column to the existing table with the
+:func:`~google.cloud.bigquery.update_table` method:
+
+.. literalinclude:: ../samples/add_empty_column.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_add_empty_column]
+   :end-before: [END bigquery_add_empty_column]
+
+Copying a Table
+^^^^^^^^^^^^^^^
+
+Copy a table with the
+:func:`~google.cloud.bigquery.client.Client.copy_table` method:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_copy_table]
+   :end-before: [END bigquery_copy_table]
+
+Copy table data to Google Cloud Storage with the
+:func:`~google.cloud.bigquery.client.Client.extract_table` method:
+
+.. literalinclude:: ../snippets.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_extract_table]
+   :end-before: [END bigquery_extract_table]
+
+Deleting a Table
+^^^^^^^^^^^^^^^^
+
+Delete a table with the
+:func:`~google.cloud.bigquery.client.Client.delete_table` method:
+
+.. literalinclude:: ../samples/delete_table.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquery_delete_table]
+   :end-before: [END bigquery_delete_table]
diff --git a/bigquery/google/__init__.py b/bigquery/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/bigquery/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigquery/google/cloud/__init__.py b/bigquery/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/bigquery/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigquery/google/cloud/bigquery/__init__.py b/bigquery/google/cloud/bigquery/__init__.py
new file mode 100644
index 000000000000..bda8c5611435
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/__init__.py
@@ -0,0 +1,148 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google BigQuery API wrapper.
+
+The main concepts with this API are:
+
+- :class:`~google.cloud.bigquery.client.Client` manages connections to the
+  BigQuery API. Use the client methods to run jobs (such as a
+  :class:`~google.cloud.bigquery.job.QueryJob` via
+  :meth:`~google.cloud.bigquery.client.Client.query`) and manage resources.
+
+- :class:`~google.cloud.bigquery.dataset.Dataset` represents a
+  collection of tables.
+
+- :class:`~google.cloud.bigquery.table.Table` represents a single "relation".
+"""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-bigquery").version
+
+from google.cloud.bigquery.client import Client
+from google.cloud.bigquery.dataset import AccessEntry
+from google.cloud.bigquery.dataset import Dataset
+from google.cloud.bigquery.dataset import DatasetReference
+from google.cloud.bigquery import enums
+from google.cloud.bigquery.enums import StandardSqlDataTypes
+from google.cloud.bigquery.external_config import ExternalConfig
+from google.cloud.bigquery.external_config import BigtableOptions
+from google.cloud.bigquery.external_config import BigtableColumnFamily
+from google.cloud.bigquery.external_config import BigtableColumn
+from google.cloud.bigquery.external_config import CSVOptions
+from google.cloud.bigquery.external_config import GoogleSheetsOptions
+from google.cloud.bigquery.external_config import ExternalSourceFormat
+from google.cloud.bigquery.job import Compression
+from google.cloud.bigquery.job import CopyJob
+from google.cloud.bigquery.job import CopyJobConfig
+from google.cloud.bigquery.job import CreateDisposition
+from google.cloud.bigquery.job import DestinationFormat
+from google.cloud.bigquery.job import Encoding
+from google.cloud.bigquery.job import ExtractJob
+from google.cloud.bigquery.job import ExtractJobConfig
+from google.cloud.bigquery.job import LoadJob
+from google.cloud.bigquery.job import LoadJobConfig
+from google.cloud.bigquery.job import QueryJob
+from google.cloud.bigquery.job import QueryJobConfig
+from google.cloud.bigquery.job import QueryPriority
+from google.cloud.bigquery.job import SchemaUpdateOption
+from google.cloud.bigquery.job import SourceFormat
+from google.cloud.bigquery.job import UnknownJob
+from google.cloud.bigquery.job import WriteDisposition
+from google.cloud.bigquery.model import Model
+from google.cloud.bigquery.model import ModelReference
+from google.cloud.bigquery.query import ArrayQueryParameter
+from google.cloud.bigquery.query import ScalarQueryParameter
+from google.cloud.bigquery.query import StructQueryParameter
+from google.cloud.bigquery.query import UDFResource
+from google.cloud.bigquery.retry import DEFAULT_RETRY
+from google.cloud.bigquery.routine import Routine
+from google.cloud.bigquery.routine import RoutineArgument
+from google.cloud.bigquery.routine import RoutineReference
+from google.cloud.bigquery.schema import SchemaField
+from google.cloud.bigquery.table import EncryptionConfiguration
+from google.cloud.bigquery.table import Table
+from google.cloud.bigquery.table import TableReference
+from google.cloud.bigquery.table import Row
+from google.cloud.bigquery.table import TimePartitioningType
+from google.cloud.bigquery.table import TimePartitioning
+
+__all__ = [
+    "__version__",
+    "Client",
+    # Queries
+    "QueryJob",
+    "QueryJobConfig",
+    "ArrayQueryParameter",
+    "ScalarQueryParameter",
+    "StructQueryParameter",
+    # Datasets
+    "Dataset",
+    "DatasetReference",
+    "AccessEntry",
+    # Tables
+    "EncryptionConfiguration",
+    "Table",
+    "TableReference",
+    "Row",
+    "CopyJob",
+    "CopyJobConfig",
+    "ExtractJob",
+    "ExtractJobConfig",
+    "LoadJob",
+    "LoadJobConfig",
+    "UnknownJob",
+    "TimePartitioningType",
+    "TimePartitioning",
+    # Models
+    "Model",
+    "ModelReference",
+    # Routines
+    "Routine",
+    "RoutineArgument",
+    "RoutineReference",
+    # Shared helpers
+    "SchemaField",
+    "UDFResource",
+    "ExternalConfig",
+    "BigtableOptions",
+    "BigtableColumnFamily",
+    "BigtableColumn",
+    "CSVOptions",
+    "GoogleSheetsOptions",
+    "DEFAULT_RETRY",
+    # Enum Constants
+    "enums",
+    "Compression",
+    "CreateDisposition",
+    "DestinationFormat",
+    "ExternalSourceFormat",
+    "Encoding",
+    "QueryPriority",
+    "SchemaUpdateOption",
+    "StandardSqlDataTypes",
+    "SourceFormat",
+    "WriteDisposition",
+]
+
+
+def load_ipython_extension(ipython):
+    """Called by IPython when this module is loaded as an IPython extension."""
+    from google.cloud.bigquery.magics import _cell_magic
+
+    ipython.register_magic_function(
+        _cell_magic, magic_kind="cell", magic_name="bigquery"
+    )
diff --git a/bigquery/google/cloud/bigquery/_helpers.py b/bigquery/google/cloud/bigquery/_helpers.py
new file mode 100644
index 000000000000..bb3998732a5a
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/_helpers.py
@@ -0,0 +1,635 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shared helper functions for BigQuery API classes."""
+
+import base64
+import copy
+import datetime
+import decimal
+
+from google.cloud._helpers import UTC
+from google.cloud._helpers import _date_from_iso8601_date
+from google.cloud._helpers import _datetime_from_microseconds
+from google.cloud._helpers import _microseconds_from_datetime
+from google.cloud._helpers import _RFC3339_NO_FRACTION
+from google.cloud._helpers import _to_bytes
+
+_RFC3339_MICROS_NO_ZULU = "%Y-%m-%dT%H:%M:%S.%f"
+_TIMEONLY_WO_MICROS = "%H:%M:%S"
+_TIMEONLY_W_MICROS = "%H:%M:%S.%f"
+
+
+def _not_null(value, field):
+    """Check whether 'value' should be coerced to 'field' type."""
+    return value is not None or field.mode != "NULLABLE"
+
+
+def _int_from_json(value, field):
+    """Coerce 'value' to an int, if set or not nullable."""
+    if _not_null(value, field):
+        return int(value)
+
+
+def _float_from_json(value, field):
+    """Coerce 'value' to a float, if set or not nullable."""
+    if _not_null(value, field):
+        return float(value)
+
+
+def _decimal_from_json(value, field):
+    """Coerce 'value' to a Decimal, if set or not nullable."""
+    if _not_null(value, field):
+        return decimal.Decimal(value)
+
+
+def _bool_from_json(value, field):
+    """Coerce 'value' to a bool, if set or not nullable."""
+    if _not_null(value, field):
+        return value.lower() in ["t", "true", "1"]
+
+
+def _string_from_json(value, _):
+    """NOOP string -> string coercion"""
+    return value
+
+
+def _bytes_from_json(value, field):
+    """Base64-decode value"""
+    if _not_null(value, field):
+        return base64.standard_b64decode(_to_bytes(value))
+
+
+def _timestamp_from_json(value, field):
+    """Coerce 'value' to a datetime, if set or not nullable."""
+    if _not_null(value, field):
+        # value will be a float in seconds, to microsecond precision, in UTC.
+        return _datetime_from_microseconds(1e6 * float(value))
+
+
+def _timestamp_query_param_from_json(value, field):
+    """Coerce 'value' to a datetime, if set or not nullable.
+
+    Args:
+        value (str): The timestamp.
+        field (.SchemaField): The field corresponding to the value.
+
+    Returns:
+        Optional[datetime.datetime]: The parsed datetime object from
+        ``value`` if the ``field`` is not null (otherwise it is
+        :data:`None`).
+    """
+    if _not_null(value, field):
+        # Canonical formats for timestamps in BigQuery are flexible. See:
+        # g.co/cloud/bigquery/docs/reference/standard-sql/data-types#timestamp-type
+        # The separator between the date and time can be 'T' or ' '.
+        value = value.replace(" ", "T", 1)
+        # The UTC timezone may be formatted as Z or +00:00.
+        value = value.replace("Z", "")
+        value = value.replace("+00:00", "")
+
+        if "." in value:
+            # YYYY-MM-DDTHH:MM:SS.ffffff
+            return datetime.datetime.strptime(value, _RFC3339_MICROS_NO_ZULU).replace(
+                tzinfo=UTC
+            )
+        else:
+            # YYYY-MM-DDTHH:MM:SS
+            return datetime.datetime.strptime(value, _RFC3339_NO_FRACTION).replace(
+                tzinfo=UTC
+            )
+    else:
+        return None
+
+
+def _datetime_from_json(value, field):
+    """Coerce 'value' to a datetime, if set or not nullable.
+
+    Args:
+        value (str): The timestamp.
+        field (.SchemaField): The field corresponding to the value.
+
+    Returns:
+        Optional[datetime.datetime]: The parsed datetime object from
+        ``value`` if the ``field`` is not null (otherwise it is
+        :data:`None`).
+    """
+    if _not_null(value, field):
+        if "." in value:
+            # YYYY-MM-DDTHH:MM:SS.ffffff
+            return datetime.datetime.strptime(value, _RFC3339_MICROS_NO_ZULU)
+        else:
+            # YYYY-MM-DDTHH:MM:SS
+            return datetime.datetime.strptime(value, _RFC3339_NO_FRACTION)
+    else:
+        return None
+
+
+def _date_from_json(value, field):
+    """Coerce 'value' to a datetime date, if set or not nullable"""
+    if _not_null(value, field):
+        # value will be a string, in YYYY-MM-DD form.
+        return _date_from_iso8601_date(value)
+
+
+def _time_from_json(value, field):
+    """Coerce 'value' to a datetime date, if set or not nullable"""
+    if _not_null(value, field):
+        if len(value) == 8:  # HH:MM:SS
+            fmt = _TIMEONLY_WO_MICROS
+        elif len(value) == 15:  # HH:MM:SS.micros
+            fmt = _TIMEONLY_W_MICROS
+        else:
+            raise ValueError("Unknown time format: {}".format(value))
+        return datetime.datetime.strptime(value, fmt).time()
+
+
+def _record_from_json(value, field):
+    """Coerce 'value' to a mapping, if set or not nullable."""
+    if _not_null(value, field):
+        record = {}
+        record_iter = zip(field.fields, value["f"])
+        for subfield, cell in record_iter:
+            converter = _CELLDATA_FROM_JSON[subfield.field_type]
+            if subfield.mode == "REPEATED":
+                value = [converter(item["v"], subfield) for item in cell["v"]]
+            else:
+                value = converter(cell["v"], subfield)
+            record[subfield.name] = value
+        return record
+
+
+_CELLDATA_FROM_JSON = {
+    "INTEGER": _int_from_json,
+    "INT64": _int_from_json,
+    "FLOAT": _float_from_json,
+    "FLOAT64": _float_from_json,
+    "NUMERIC": _decimal_from_json,
+    "BOOLEAN": _bool_from_json,
+    "BOOL": _bool_from_json,
+    "STRING": _string_from_json,
+    "GEOGRAPHY": _string_from_json,
+    "BYTES": _bytes_from_json,
+    "TIMESTAMP": _timestamp_from_json,
+    "DATETIME": _datetime_from_json,
+    "DATE": _date_from_json,
+    "TIME": _time_from_json,
+    "RECORD": _record_from_json,
+}
+
+_QUERY_PARAMS_FROM_JSON = dict(_CELLDATA_FROM_JSON)
+_QUERY_PARAMS_FROM_JSON["TIMESTAMP"] = _timestamp_query_param_from_json
+
+
+def _field_to_index_mapping(schema):
+    """Create a mapping from schema field name to index of field."""
+    return {f.name: i for i, f in enumerate(schema)}
+
+
+def _field_from_json(resource, field):
+    converter = _CELLDATA_FROM_JSON.get(field.field_type, lambda value, _: value)
+    if field.mode == "REPEATED":
+        return [converter(item["v"], field) for item in resource]
+    else:
+        return converter(resource, field)
+
+
+def _row_tuple_from_json(row, schema):
+    """Convert JSON row data to row with appropriate types.
+
+    Note:  ``row['f']`` and ``schema`` are presumed to be of the same length.
+
+    :type row: dict
+    :param row: A JSON response row to be converted.
+
+    :type schema: tuple
+    :param schema: A tuple of
+                   :class:`~google.cloud.bigquery.schema.SchemaField`.
+
+    :rtype: tuple
+    :returns: A tuple of data converted to native types.
+    """
+    row_data = []
+    for field, cell in zip(schema, row["f"]):
+        row_data.append(_field_from_json(cell["v"], field))
+    return tuple(row_data)
+
+
+def _rows_from_json(values, schema):
+    """Convert JSON row data to rows with appropriate types."""
+    from google.cloud.bigquery import Row
+
+    field_to_index = _field_to_index_mapping(schema)
+    return [Row(_row_tuple_from_json(r, schema), field_to_index) for r in values]
+
+
+def _int_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    if isinstance(value, int):
+        value = str(value)
+    return value
+
+
+def _float_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    return value
+
+
+def _decimal_to_json(value):
+    """Coerce 'value' to a JSON-compatible representation."""
+    if isinstance(value, decimal.Decimal):
+        value = str(value)
+    return value
+
+
+def _bool_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    if isinstance(value, bool):
+        value = "true" if value else "false"
+    return value
+
+
+def _bytes_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    if isinstance(value, bytes):
+        value = base64.standard_b64encode(value).decode("ascii")
+    return value
+
+
+def _timestamp_to_json_parameter(value):
+    """Coerce 'value' to an JSON-compatible representation.
+
+    This version returns the string representation used in query parameters.
+    """
+    if isinstance(value, datetime.datetime):
+        if value.tzinfo not in (None, UTC):
+            # Convert to UTC and remove the time zone info.
+            value = value.replace(tzinfo=None) - value.utcoffset()
+        value = "%s %s+00:00" % (value.date().isoformat(), value.time().isoformat())
+    return value
+
+
+def _timestamp_to_json_row(value):
+    """Coerce 'value' to an JSON-compatible representation.
+
+    This version returns floating-point seconds value used in row data.
+    """
+    if isinstance(value, datetime.datetime):
+        value = _microseconds_from_datetime(value) * 1e-6
+    return value
+
+
+def _datetime_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    if isinstance(value, datetime.datetime):
+        value = value.strftime(_RFC3339_MICROS_NO_ZULU)
+    return value
+
+
+def _date_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    if isinstance(value, datetime.date):
+        value = value.isoformat()
+    return value
+
+
+def _time_to_json(value):
+    """Coerce 'value' to an JSON-compatible representation."""
+    if isinstance(value, datetime.time):
+        value = value.isoformat()
+    return value
+
+
+# Converters used for scalar values marshalled as row data.
+_SCALAR_VALUE_TO_JSON_ROW = {
+    "INTEGER": _int_to_json,
+    "INT64": _int_to_json,
+    "FLOAT": _float_to_json,
+    "FLOAT64": _float_to_json,
+    "NUMERIC": _decimal_to_json,
+    "BOOLEAN": _bool_to_json,
+    "BOOL": _bool_to_json,
+    "BYTES": _bytes_to_json,
+    "TIMESTAMP": _timestamp_to_json_row,
+    "DATETIME": _datetime_to_json,
+    "DATE": _date_to_json,
+    "TIME": _time_to_json,
+}
+
+
+# Converters used for scalar values marshalled as query parameters.
+_SCALAR_VALUE_TO_JSON_PARAM = _SCALAR_VALUE_TO_JSON_ROW.copy()
+_SCALAR_VALUE_TO_JSON_PARAM["TIMESTAMP"] = _timestamp_to_json_parameter
+
+
+def _scalar_field_to_json(field, row_value):
+    """Maps a field and value to a JSON-safe value.
+
+    Args:
+        field ( \
+            :class:`~google.cloud.bigquery.schema.SchemaField`, \
+        ):
+            The SchemaField to use for type conversion and field name.
+        row_value (any):
+            Value to be converted, based on the field's type.
+
+    Returns:
+        any:
+            A JSON-serializable object.
+    """
+    converter = _SCALAR_VALUE_TO_JSON_ROW.get(field.field_type)
+    if converter is None:  # STRING doesn't need converting
+        return row_value
+    return converter(row_value)
+
+
+def _repeated_field_to_json(field, row_value):
+    """Convert a repeated/array field to its JSON representation.
+
+    Args:
+        field ( \
+            :class:`~google.cloud.bigquery.schema.SchemaField`, \
+        ):
+            The SchemaField to use for type conversion and field name. The
+            field mode must equal ``REPEATED``.
+        row_value (Sequence[any]):
+            A sequence of values to convert to JSON-serializable values.
+
+    Returns:
+        List[any]:
+            A list of JSON-serializable objects.
+    """
+    # Remove the REPEATED, but keep the other fields. This allows us to process
+    # each item as if it were a top-level field.
+    item_field = copy.deepcopy(field)
+    item_field._mode = "NULLABLE"
+    values = []
+    for item in row_value:
+        values.append(_field_to_json(item_field, item))
+    return values
+
+
+def _record_field_to_json(fields, row_value):
+    """Convert a record/struct field to its JSON representation.
+
+    Args:
+        fields ( \
+            Sequence[:class:`~google.cloud.bigquery.schema.SchemaField`], \
+        ):
+            The :class:`~google.cloud.bigquery.schema.SchemaField`s of the
+            record's subfields to use for type conversion and field names.
+        row_value (Union[Tuple[Any], Mapping[str, Any]):
+            A tuple or dictionary to convert to JSON-serializable values.
+
+    Returns:
+        Mapping[str, any]:
+            A JSON-serializable dictionary.
+    """
+    record = {}
+    isdict = isinstance(row_value, dict)
+
+    for subindex, subfield in enumerate(fields):
+        subname = subfield.name
+        if isdict:
+            subvalue = row_value.get(subname)
+        else:
+            subvalue = row_value[subindex]
+        record[subname] = _field_to_json(subfield, subvalue)
+    return record
+
+
+def _field_to_json(field, row_value):
+    """Convert a field into JSON-serializable values.
+
+    Args:
+        field ( \
+            :class:`~google.cloud.bigquery.schema.SchemaField`, \
+        ):
+            The SchemaField to use for type conversion and field name.
+
+        row_value (Union[ \
+            Sequence[list], \
+            any, \
+        ]):
+            Row data to be inserted. If the SchemaField's mode is
+            REPEATED, assume this is a list. If not, the type
+            is inferred from the SchemaField's field_type.
+
+    Returns:
+        any:
+            A JSON-serializable object.
+    """
+    if row_value is None:
+        return None
+
+    if field.mode == "REPEATED":
+        return _repeated_field_to_json(field, row_value)
+
+    if field.field_type == "RECORD":
+        return _record_field_to_json(field.fields, row_value)
+
+    return _scalar_field_to_json(field, row_value)
+
+
+def _snake_to_camel_case(value):
+    """Convert snake case string to camel case."""
+    words = value.split("_")
+    return words[0] + "".join(map(str.capitalize, words[1:]))
+
+
+def _get_sub_prop(container, keys, default=None):
+    """Get a nested value from a dictionary.
+
+    This method works like ``dict.get(key)``, but for nested values.
+
+    Arguments:
+        container (dict):
+            A dictionary which may contain other dictionaries as values.
+        keys (iterable):
+            A sequence of keys to attempt to get the value for. Each item in
+            the sequence represents a deeper nesting. The first key is for
+            the top level. If there is a dictionary there, the second key
+            attempts to get the value within that, and so on.
+        default (object):
+            (Optional) Value to returned if any of the keys are not found.
+            Defaults to ``None``.
+
+    Examples:
+        Get a top-level value (equivalent to ``container.get('key')``).
+
+        >>> _get_sub_prop({'key': 'value'}, ['key'])
+        'value'
+
+        Get a top-level value, providing a default (equivalent to
+        ``container.get('key', default='default')``).
+
+        >>> _get_sub_prop({'nothere': 123}, ['key'], default='not found')
+        'not found'
+
+        Get a nested value.
+
+        >>> _get_sub_prop({'key': {'subkey': 'value'}}, ['key', 'subkey'])
+        'value'
+
+    Returns:
+        object: The value if present or the default.
+    """
+    sub_val = container
+    for key in keys:
+        if key not in sub_val:
+            return default
+        sub_val = sub_val[key]
+    return sub_val
+
+
+def _set_sub_prop(container, keys, value):
+    """Set a nested value in a dictionary.
+
+    Arguments:
+        container (dict):
+            A dictionary which may contain other dictionaries as values.
+        keys (iterable):
+            A sequence of keys to attempt to set the value for. Each item in
+            the sequence represents a deeper nesting. The first key is for
+            the top level. If there is a dictionary there, the second key
+            attempts to get the value within that, and so on.
+        value (object): Value to set within the container.
+
+    Examples:
+        Set a top-level value (equivalent to ``container['key'] = 'value'``).
+
+        >>> container = {}
+        >>> _set_sub_prop(container, ['key'], 'value')
+        >>> container
+        {'key': 'value'}
+
+        Set a nested value.
+
+        >>> container = {}
+        >>> _set_sub_prop(container, ['key', 'subkey'], 'value')
+        >>> container
+        {'key': {'subkey': 'value'}}
+
+        Replace a nested value.
+
+        >>> container = {'key': {'subkey': 'prev'}}
+        >>> _set_sub_prop(container, ['key', 'subkey'], 'new')
+        >>> container
+        {'key': {'subkey': 'new'}}
+    """
+    sub_val = container
+    for key in keys[:-1]:
+        if key not in sub_val:
+            sub_val[key] = {}
+        sub_val = sub_val[key]
+    sub_val[keys[-1]] = value
+
+
+def _del_sub_prop(container, keys):
+    """Remove a nested key fro a dictionary.
+
+    Arguments:
+        container (dict):
+            A dictionary which may contain other dictionaries as values.
+        keys (iterable):
+            A sequence of keys to attempt to clear the value for. Each item in
+            the sequence represents a deeper nesting. The first key is for
+            the top level. If there is a dictionary there, the second key
+            attempts to get the value within that, and so on.
+
+    Examples:
+        Remove a top-level value (equivalent to ``del container['key']``).
+
+        >>> container = {'key': 'value'}
+        >>> _del_sub_prop(container, ['key'])
+        >>> container
+        {}
+
+        Remove a nested value.
+
+        >>> container = {'key': {'subkey': 'value'}}
+        >>> _del_sub_prop(container, ['key', 'subkey'])
+        >>> container
+        {'key': {}}
+    """
+    sub_val = container
+    for key in keys[:-1]:
+        if key not in sub_val:
+            sub_val[key] = {}
+        sub_val = sub_val[key]
+    if keys[-1] in sub_val:
+        del sub_val[keys[-1]]
+
+
+def _int_or_none(value):
+    """Helper: deserialize int value from JSON string."""
+    if isinstance(value, int):
+        return value
+    if value is not None:
+        return int(value)
+
+
+def _str_or_none(value):
+    """Helper: serialize value to JSON string."""
+    if value is not None:
+        return str(value)
+
+
+def _parse_3_part_id(full_id, default_project=None, property_name="table_id"):
+    output_project_id = default_project
+    output_dataset_id = None
+    output_resource_id = None
+    parts = full_id.split(".")
+
+    if len(parts) != 2 and len(parts) != 3:
+        raise ValueError(
+            "{property_name} must be a fully-qualified ID in "
+            'standard SQL format. e.g. "project.dataset.{property_name}", '
+            "got {}".format(full_id, property_name=property_name)
+        )
+
+    if len(parts) == 2 and not default_project:
+        raise ValueError(
+            "When default_project is not set, {property_name} must be a "
+            "fully-qualified ID in standard SQL format. "
+            'e.g. "project.dataset_id.{property_name}", got {}'.format(
+                full_id, property_name=property_name
+            )
+        )
+
+    if len(parts) == 2:
+        output_dataset_id, output_resource_id = parts
+    else:
+        output_project_id, output_dataset_id, output_resource_id = parts
+
+    return output_project_id, output_dataset_id, output_resource_id
+
+
+def _build_resource_from_properties(obj, filter_fields):
+    """Build a resource based on a ``_properties`` dictionary, filtered by
+    ``filter_fields``, which follow the name of the Python object.
+    """
+    partial = {}
+    for filter_field in filter_fields:
+        api_field = obj._PROPERTY_TO_API_FIELD.get(filter_field)
+        if api_field is None and filter_field not in obj._properties:
+            raise ValueError("No property %s" % filter_field)
+        elif api_field is not None:
+            partial[api_field] = obj._properties.get(api_field)
+        else:
+            # allows properties that are not defined in the library
+            # and properties that have the same name as API resource key
+            partial[filter_field] = obj._properties[filter_field]
+
+    return partial
diff --git a/bigquery/google/cloud/bigquery/_http.py b/bigquery/google/cloud/bigquery/_http.py
new file mode 100644
index 000000000000..5dd660ea0b8d
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/_http.py
@@ -0,0 +1,44 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google BigQuery connections."""
+
+from google.cloud import _http
+
+from google.cloud.bigquery import __version__
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google BigQuery via the JSON REST API.
+
+    :type client: :class:`~google.cloud.bigquery.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+    """
+
+    DEFAULT_API_ENDPOINT = "https://www.googleapis.com"
+
+    def __init__(self, client, client_info=None, api_endpoint=DEFAULT_API_ENDPOINT):
+        super(Connection, self).__init__(client, client_info)
+        self.API_BASE_URL = api_endpoint
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_VERSION = "v2"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/bigquery/{api_version}{path}"
+    """A template for the URL of a particular API call."""
diff --git a/bigquery/google/cloud/bigquery/_pandas_helpers.py b/bigquery/google/cloud/bigquery/_pandas_helpers.py
new file mode 100644
index 000000000000..5e73c9f58e22
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/_pandas_helpers.py
@@ -0,0 +1,594 @@
+# 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.
+
+"""Shared helper functions for connecting BigQuery and pandas."""
+
+import concurrent.futures
+import functools
+import logging
+import warnings
+
+from six.moves import queue
+
+try:
+    from google.cloud import bigquery_storage_v1beta1
+except ImportError:  # pragma: NO COVER
+    bigquery_storage_v1beta1 = None
+
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+
+try:
+    import pyarrow
+    import pyarrow.parquet
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+
+from google.cloud.bigquery import schema
+
+
+_LOGGER = logging.getLogger(__name__)
+
+_NO_BQSTORAGE_ERROR = (
+    "The google-cloud-bigquery-storage library is not installed, "
+    "please install google-cloud-bigquery-storage to use bqstorage features."
+)
+
+_PROGRESS_INTERVAL = 0.2  # Maximum time between download status checks, in seconds.
+
+_PANDAS_DTYPE_TO_BQ = {
+    "bool": "BOOLEAN",
+    "datetime64[ns, UTC]": "TIMESTAMP",
+    "datetime64[ns]": "DATETIME",
+    "float32": "FLOAT",
+    "float64": "FLOAT",
+    "int8": "INTEGER",
+    "int16": "INTEGER",
+    "int32": "INTEGER",
+    "int64": "INTEGER",
+    "uint8": "INTEGER",
+    "uint16": "INTEGER",
+    "uint32": "INTEGER",
+}
+
+
+class _DownloadState(object):
+    """Flag to indicate that a thread should exit early."""
+
+    def __init__(self):
+        # No need for a lock because reading/replacing a variable is defined to
+        # be an atomic operation in the Python language definition (enforced by
+        # the global interpreter lock).
+        self.done = False
+
+
+def pyarrow_datetime():
+    return pyarrow.timestamp("us", tz=None)
+
+
+def pyarrow_numeric():
+    return pyarrow.decimal128(38, 9)
+
+
+def pyarrow_time():
+    return pyarrow.time64("us")
+
+
+def pyarrow_timestamp():
+    return pyarrow.timestamp("us", tz="UTC")
+
+
+if pyarrow:
+    # This dictionary is duplicated in bigquery_storage/test/unite/test_reader.py
+    # When modifying it be sure to update it there as well.
+    BQ_TO_ARROW_SCALARS = {
+        "BOOL": pyarrow.bool_,
+        "BOOLEAN": pyarrow.bool_,
+        "BYTES": pyarrow.binary,
+        "DATE": pyarrow.date32,
+        "DATETIME": pyarrow_datetime,
+        "FLOAT": pyarrow.float64,
+        "FLOAT64": pyarrow.float64,
+        "GEOGRAPHY": pyarrow.string,
+        "INT64": pyarrow.int64,
+        "INTEGER": pyarrow.int64,
+        "NUMERIC": pyarrow_numeric,
+        "STRING": pyarrow.string,
+        "TIME": pyarrow_time,
+        "TIMESTAMP": pyarrow_timestamp,
+    }
+else:  # pragma: NO COVER
+    BQ_TO_ARROW_SCALARS = {}  # pragma: NO COVER
+
+
+def bq_to_arrow_struct_data_type(field):
+    arrow_fields = []
+    for subfield in field.fields:
+        arrow_subfield = bq_to_arrow_field(subfield)
+        if arrow_subfield:
+            arrow_fields.append(arrow_subfield)
+        else:
+            # Could not determine a subfield type. Fallback to type
+            # inference.
+            return None
+    return pyarrow.struct(arrow_fields)
+
+
+def bq_to_arrow_data_type(field):
+    """Return the Arrow data type, corresponding to a given BigQuery column.
+
+    Returns None if default Arrow type inspection should be used.
+    """
+    if field.mode is not None and field.mode.upper() == "REPEATED":
+        inner_type = bq_to_arrow_data_type(
+            schema.SchemaField(field.name, field.field_type, fields=field.fields)
+        )
+        if inner_type:
+            return pyarrow.list_(inner_type)
+        return None
+
+    if field.field_type.upper() in schema._STRUCT_TYPES:
+        return bq_to_arrow_struct_data_type(field)
+
+    data_type_constructor = BQ_TO_ARROW_SCALARS.get(field.field_type.upper())
+    if data_type_constructor is None:
+        return None
+    return data_type_constructor()
+
+
+def bq_to_arrow_field(bq_field):
+    """Return the Arrow field, corresponding to a given BigQuery column.
+
+    Returns None if the Arrow type cannot be determined.
+    """
+    arrow_type = bq_to_arrow_data_type(bq_field)
+    if arrow_type:
+        is_nullable = bq_field.mode.upper() == "NULLABLE"
+        return pyarrow.field(bq_field.name, arrow_type, nullable=is_nullable)
+
+    warnings.warn("Unable to determine type for field '{}'.".format(bq_field.name))
+    return None
+
+
+def bq_to_arrow_schema(bq_schema):
+    """Return the Arrow schema, corresponding to a given BigQuery schema.
+
+    Returns None if any Arrow type cannot be determined.
+    """
+    arrow_fields = []
+    for bq_field in bq_schema:
+        arrow_field = bq_to_arrow_field(bq_field)
+        if arrow_field is None:
+            # Auto-detect the schema if there is an unknown field type.
+            return None
+        arrow_fields.append(arrow_field)
+    return pyarrow.schema(arrow_fields)
+
+
+def bq_to_arrow_array(series, bq_field):
+    arrow_type = bq_to_arrow_data_type(bq_field)
+    if bq_field.mode.upper() == "REPEATED":
+        return pyarrow.ListArray.from_pandas(series, type=arrow_type)
+    if bq_field.field_type.upper() in schema._STRUCT_TYPES:
+        return pyarrow.StructArray.from_pandas(series, type=arrow_type)
+    return pyarrow.array(series, type=arrow_type)
+
+
+def get_column_or_index(dataframe, name):
+    """Return a column or index as a pandas series."""
+    if name in dataframe.columns:
+        return dataframe[name].reset_index(drop=True)
+
+    if isinstance(dataframe.index, pandas.MultiIndex):
+        if name in dataframe.index.names:
+            return (
+                dataframe.index.get_level_values(name)
+                .to_series()
+                .reset_index(drop=True)
+            )
+    else:
+        if name == dataframe.index.name:
+            return dataframe.index.to_series().reset_index(drop=True)
+
+    raise ValueError("column or index '{}' not found.".format(name))
+
+
+def list_columns_and_indexes(dataframe):
+    """Return all index and column names with dtypes.
+
+    Returns:
+        Sequence[Tuple[dtype, str]]:
+            Returns a sorted list of indexes and column names with
+            corresponding dtypes. If an index is missing a name or has the
+            same name as a column, the index is omitted.
+    """
+    column_names = frozenset(dataframe.columns)
+    columns_and_indexes = []
+    if isinstance(dataframe.index, pandas.MultiIndex):
+        for name in dataframe.index.names:
+            if name and name not in column_names:
+                values = dataframe.index.get_level_values(name)
+                columns_and_indexes.append((name, values.dtype))
+    else:
+        if dataframe.index.name and dataframe.index.name not in column_names:
+            columns_and_indexes.append((dataframe.index.name, dataframe.index.dtype))
+
+    columns_and_indexes += zip(dataframe.columns, dataframe.dtypes)
+    return columns_and_indexes
+
+
+def dataframe_to_bq_schema(dataframe, bq_schema):
+    """Convert a pandas DataFrame schema to a BigQuery schema.
+
+    Args:
+        dataframe (pandas.DataFrame):
+            DataFrame for which the client determines the BigQuery schema.
+        bq_schema (Sequence[google.cloud.bigquery.schema.SchemaField]):
+            A BigQuery schema. Use this argument to override the autodetected
+            type for some or all of the DataFrame columns.
+
+    Returns:
+        Optional[Sequence[google.cloud.bigquery.schema.SchemaField]]:
+            The automatically determined schema. Returns None if the type of
+            any column cannot be determined.
+    """
+    if bq_schema:
+        for field in bq_schema:
+            if field.field_type in schema._STRUCT_TYPES:
+                raise ValueError(
+                    "Uploading dataframes with struct (record) column types "
+                    "is not supported. See: "
+                    "https://github.com/googleapis/google-cloud-python/issues/8191"
+                )
+        bq_schema_index = {field.name: field for field in bq_schema}
+        bq_schema_unused = set(bq_schema_index.keys())
+    else:
+        bq_schema_index = {}
+        bq_schema_unused = set()
+
+    bq_schema_out = []
+    for column, dtype in list_columns_and_indexes(dataframe):
+        # Use provided type from schema, if present.
+        bq_field = bq_schema_index.get(column)
+        if bq_field:
+            bq_schema_out.append(bq_field)
+            bq_schema_unused.discard(bq_field.name)
+            continue
+
+        # Otherwise, try to automatically determine the type based on the
+        # pandas dtype.
+        bq_type = _PANDAS_DTYPE_TO_BQ.get(dtype.name)
+        if not bq_type:
+            warnings.warn(u"Unable to determine type of column '{}'.".format(column))
+            return None
+        bq_field = schema.SchemaField(column, bq_type)
+        bq_schema_out.append(bq_field)
+
+    # Catch any schema mismatch. The developer explicitly asked to serialize a
+    # column, but it was not found.
+    if bq_schema_unused:
+        raise ValueError(
+            u"bq_schema contains fields not present in dataframe: {}".format(
+                bq_schema_unused
+            )
+        )
+    return tuple(bq_schema_out)
+
+
+def dataframe_to_arrow(dataframe, bq_schema):
+    """Convert pandas dataframe to Arrow table, using BigQuery schema.
+
+    Args:
+        dataframe (pandas.DataFrame):
+            DataFrame to convert to Arrow table.
+        bq_schema (Sequence[google.cloud.bigquery.schema.SchemaField]):
+            Desired BigQuery schema. Number of columns must match number of
+            columns in the DataFrame.
+
+    Returns:
+        pyarrow.Table:
+            Table containing dataframe data, with schema derived from
+            BigQuery schema.
+    """
+    column_names = set(dataframe.columns)
+    column_and_index_names = set(
+        name for name, _ in list_columns_and_indexes(dataframe)
+    )
+    bq_field_names = set(field.name for field in bq_schema)
+
+    extra_fields = bq_field_names - column_and_index_names
+    if extra_fields:
+        raise ValueError(
+            u"bq_schema contains fields not present in dataframe: {}".format(
+                extra_fields
+            )
+        )
+
+    # It's okay for indexes to be missing from bq_schema, but it's not okay to
+    # be missing columns.
+    missing_fields = column_names - bq_field_names
+    if missing_fields:
+        raise ValueError(
+            u"bq_schema is missing fields from dataframe: {}".format(missing_fields)
+        )
+
+    arrow_arrays = []
+    arrow_names = []
+    arrow_fields = []
+    for bq_field in bq_schema:
+        arrow_fields.append(bq_to_arrow_field(bq_field))
+        arrow_names.append(bq_field.name)
+        arrow_arrays.append(
+            bq_to_arrow_array(get_column_or_index(dataframe, bq_field.name), bq_field)
+        )
+
+    if all((field is not None for field in arrow_fields)):
+        return pyarrow.Table.from_arrays(
+            arrow_arrays, schema=pyarrow.schema(arrow_fields)
+        )
+    return pyarrow.Table.from_arrays(arrow_arrays, names=arrow_names)
+
+
+def dataframe_to_parquet(dataframe, bq_schema, filepath, parquet_compression="SNAPPY"):
+    """Write dataframe as a Parquet file, according to the desired BQ schema.
+
+    This function requires the :mod:`pyarrow` package. Arrow is used as an
+    intermediate format.
+
+    Args:
+        dataframe (pandas.DataFrame):
+            DataFrame to convert to Parquet file.
+        bq_schema (Sequence[google.cloud.bigquery.schema.SchemaField]):
+            Desired BigQuery schema. Number of columns must match number of
+            columns in the DataFrame.
+        filepath (str):
+            Path to write Parquet file to.
+        parquet_compression (str):
+            (optional) The compression codec to use by the the
+            ``pyarrow.parquet.write_table`` serializing method. Defaults to
+            "SNAPPY".
+            https://arrow.apache.org/docs/python/generated/pyarrow.parquet.write_table.html#pyarrow-parquet-write-table
+    """
+    if pyarrow is None:
+        raise ValueError("pyarrow is required for BigQuery schema conversion.")
+
+    arrow_table = dataframe_to_arrow(dataframe, bq_schema)
+    pyarrow.parquet.write_table(arrow_table, filepath, compression=parquet_compression)
+
+
+def _tabledata_list_page_to_arrow(page, column_names, arrow_types):
+    # Iterate over the page to force the API request to get the page data.
+    try:
+        next(iter(page))
+    except StopIteration:
+        pass
+
+    arrays = []
+    for column_index, arrow_type in enumerate(arrow_types):
+        arrays.append(pyarrow.array(page._columns[column_index], type=arrow_type))
+
+    return pyarrow.RecordBatch.from_arrays(arrays, column_names)
+
+
+def download_arrow_tabledata_list(pages, schema):
+    """Use tabledata.list to construct an iterable of RecordBatches."""
+    column_names = bq_to_arrow_schema(schema) or [field.name for field in schema]
+    arrow_types = [bq_to_arrow_data_type(field) for field in schema]
+
+    for page in pages:
+        yield _tabledata_list_page_to_arrow(page, column_names, arrow_types)
+
+
+def _tabledata_list_page_to_dataframe(page, column_names, dtypes):
+    # Iterate over the page to force the API request to get the page data.
+    try:
+        next(iter(page))
+    except StopIteration:
+        pass
+
+    columns = {}
+    for column_index, column_name in enumerate(column_names):
+        dtype = dtypes.get(column_name)
+        columns[column_name] = pandas.Series(page._columns[column_index], dtype=dtype)
+
+    return pandas.DataFrame(columns, columns=column_names)
+
+
+def download_dataframe_tabledata_list(pages, schema, dtypes):
+    """Use (slower, but free) tabledata.list to construct a DataFrame."""
+    column_names = [field.name for field in schema]
+    for page in pages:
+        yield _tabledata_list_page_to_dataframe(page, column_names, dtypes)
+
+
+def _bqstorage_page_to_arrow(page):
+    return page.to_arrow()
+
+
+def _bqstorage_page_to_dataframe(column_names, dtypes, page):
+    # page.to_dataframe() does not preserve column order in some versions
+    # of google-cloud-bigquery-storage. Access by column name to rearrange.
+    return page.to_dataframe(dtypes=dtypes)[column_names]
+
+
+def _download_table_bqstorage_stream(
+    download_state, bqstorage_client, session, stream, worker_queue, page_to_item
+):
+    position = bigquery_storage_v1beta1.types.StreamPosition(stream=stream)
+    rowstream = bqstorage_client.read_rows(position).rows(session)
+
+    for page in rowstream.pages:
+        if download_state.done:
+            return
+        item = page_to_item(page)
+        worker_queue.put(item)
+
+
+def _nowait(futures):
+    """Separate finished and unfinished threads, much like
+    :func:`concurrent.futures.wait`, but don't wait.
+    """
+    done = []
+    not_done = []
+    for future in futures:
+        if future.done():
+            done.append(future)
+        else:
+            not_done.append(future)
+    return done, not_done
+
+
+def _download_table_bqstorage(
+    project_id,
+    table,
+    bqstorage_client,
+    preserve_order=False,
+    selected_fields=None,
+    page_to_item=None,
+):
+    """Use (faster, but billable) BQ Storage API to construct DataFrame."""
+    if "$" in table.table_id:
+        raise ValueError(
+            "Reading from a specific partition is not currently supported."
+        )
+    if "@" in table.table_id:
+        raise ValueError("Reading from a specific snapshot is not currently supported.")
+
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    if selected_fields is not None:
+        for field in selected_fields:
+            read_options.selected_fields.append(field.name)
+
+    requested_streams = 0
+    if preserve_order:
+        requested_streams = 1
+
+    session = bqstorage_client.create_read_session(
+        table.to_bqstorage(),
+        "projects/{}".format(project_id),
+        format_=bigquery_storage_v1beta1.enums.DataFormat.ARROW,
+        read_options=read_options,
+        requested_streams=requested_streams,
+    )
+    _LOGGER.debug(
+        "Started reading table '{}.{}.{}' with BQ Storage API session '{}'.".format(
+            table.project, table.dataset_id, table.table_id, session.name
+        )
+    )
+
+    # Avoid reading rows from an empty table.
+    if not session.streams:
+        return
+
+    total_streams = len(session.streams)
+
+    # Use _DownloadState to notify worker threads when to quit.
+    # See: https://stackoverflow.com/a/29237343/101923
+    download_state = _DownloadState()
+
+    # Create a queue to collect frames as they are created in each thread.
+    worker_queue = queue.Queue()
+
+    with concurrent.futures.ThreadPoolExecutor(max_workers=total_streams) as pool:
+        try:
+            # Manually submit jobs and wait for download to complete rather
+            # than using pool.map because pool.map continues running in the
+            # background even if there is an exception on the main thread.
+            # See: https://github.com/googleapis/google-cloud-python/pull/7698
+            not_done = [
+                pool.submit(
+                    _download_table_bqstorage_stream,
+                    download_state,
+                    bqstorage_client,
+                    session,
+                    stream,
+                    worker_queue,
+                    page_to_item,
+                )
+                for stream in session.streams
+            ]
+
+            while not_done:
+                # Don't block on the worker threads. For performance reasons,
+                # we want to block on the queue's get method, instead. This
+                # prevents the queue from filling up, because the main thread
+                # has smaller gaps in time between calls to the queue's get
+                # method. For a detailed explaination, see:
+                # https://friendliness.dev/2019/06/18/python-nowait/
+                done, not_done = _nowait(not_done)
+                for future in done:
+                    # Call result() on any finished threads to raise any
+                    # exceptions encountered.
+                    future.result()
+
+                try:
+                    frame = worker_queue.get(timeout=_PROGRESS_INTERVAL)
+                    yield frame
+                except queue.Empty:  # pragma: NO COVER
+                    continue
+
+            # Return any remaining values after the workers finished.
+            while not worker_queue.empty():  # pragma: NO COVER
+                try:
+                    # Include a timeout because even though the queue is
+                    # non-empty, it doesn't guarantee that a subsequent call to
+                    # get() will not block.
+                    frame = worker_queue.get(timeout=_PROGRESS_INTERVAL)
+                    yield frame
+                except queue.Empty:  # pragma: NO COVER
+                    continue
+        finally:
+            # No need for a lock because reading/replacing a variable is
+            # defined to be an atomic operation in the Python language
+            # definition (enforced by the global interpreter lock).
+            download_state.done = True
+
+            # Shutdown all background threads, now that they should know to
+            # exit early.
+            pool.shutdown(wait=True)
+
+
+def download_arrow_bqstorage(
+    project_id, table, bqstorage_client, preserve_order=False, selected_fields=None
+):
+    return _download_table_bqstorage(
+        project_id,
+        table,
+        bqstorage_client,
+        preserve_order=preserve_order,
+        selected_fields=selected_fields,
+        page_to_item=_bqstorage_page_to_arrow,
+    )
+
+
+def download_dataframe_bqstorage(
+    project_id,
+    table,
+    bqstorage_client,
+    column_names,
+    dtypes,
+    preserve_order=False,
+    selected_fields=None,
+):
+    page_to_item = functools.partial(_bqstorage_page_to_dataframe, column_names, dtypes)
+    return _download_table_bqstorage(
+        project_id,
+        table,
+        bqstorage_client,
+        preserve_order=preserve_order,
+        selected_fields=selected_fields,
+        page_to_item=page_to_item,
+    )
diff --git a/bigquery/google/cloud/bigquery/client.py b/bigquery/google/cloud/bigquery/client.py
new file mode 100644
index 000000000000..047633642e1e
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/client.py
@@ -0,0 +1,2500 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Google BigQuery API."""
+
+from __future__ import absolute_import
+
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+
+import copy
+import functools
+import gzip
+import io
+import json
+import os
+import tempfile
+import uuid
+import warnings
+
+try:
+    import pyarrow
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+import six
+
+from google import resumable_media
+from google.resumable_media.requests import MultipartUpload
+from google.resumable_media.requests import ResumableUpload
+
+import google.api_core.client_options
+import google.api_core.exceptions
+from google.api_core import page_iterator
+import google.cloud._helpers
+from google.cloud import exceptions
+from google.cloud.client import ClientWithProject
+
+from google.cloud.bigquery._helpers import _record_field_to_json
+from google.cloud.bigquery._helpers import _str_or_none
+from google.cloud.bigquery._http import Connection
+from google.cloud.bigquery import _pandas_helpers
+from google.cloud.bigquery.dataset import Dataset
+from google.cloud.bigquery.dataset import DatasetListItem
+from google.cloud.bigquery.dataset import DatasetReference
+from google.cloud.bigquery import job
+from google.cloud.bigquery.model import Model
+from google.cloud.bigquery.model import ModelReference
+from google.cloud.bigquery.query import _QueryResults
+from google.cloud.bigquery.retry import DEFAULT_RETRY
+from google.cloud.bigquery.routine import Routine
+from google.cloud.bigquery.routine import RoutineReference
+from google.cloud.bigquery.schema import SchemaField
+from google.cloud.bigquery.table import _table_arg_to_table
+from google.cloud.bigquery.table import _table_arg_to_table_ref
+from google.cloud.bigquery.table import Table
+from google.cloud.bigquery.table import TableListItem
+from google.cloud.bigquery.table import TableReference
+from google.cloud.bigquery.table import RowIterator
+
+
+_DEFAULT_CHUNKSIZE = 1048576  # 1024 * 1024 B = 1 MB
+_MAX_MULTIPART_SIZE = 5 * 1024 * 1024
+_DEFAULT_NUM_RETRIES = 6
+_BASE_UPLOAD_TEMPLATE = (
+    u"https://www.googleapis.com/upload/bigquery/v2/projects/"
+    u"{project}/jobs?uploadType="
+)
+_MULTIPART_URL_TEMPLATE = _BASE_UPLOAD_TEMPLATE + u"multipart"
+_RESUMABLE_URL_TEMPLATE = _BASE_UPLOAD_TEMPLATE + u"resumable"
+_GENERIC_CONTENT_TYPE = u"*/*"
+_READ_LESS_THAN_SIZE = (
+    "Size {:d} was specified but the file-like object only had " "{:d} bytes remaining."
+)
+_NEED_TABLE_ARGUMENT = (
+    "The table argument should be a table ID string, Table, or TableReference"
+)
+
+
+class Project(object):
+    """Wrapper for resource describing a BigQuery project.
+
+    :type project_id: str
+    :param project_id: Opaque ID of the project
+
+    :type numeric_id: int
+    :param numeric_id: Numeric ID of the project
+
+    :type friendly_name: str
+    :param friendly_name: Display name of the project
+    """
+
+    def __init__(self, project_id, numeric_id, friendly_name):
+        self.project_id = project_id
+        self.numeric_id = numeric_id
+        self.friendly_name = friendly_name
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct an instance from a resource dict."""
+        return cls(resource["id"], resource["numericId"], resource["friendlyName"])
+
+
+class Client(ClientWithProject):
+    """Client to bundle configuration needed for API requests.
+
+    Args:
+        project (str):
+            Project ID for the project which the client acts on behalf of.
+            Will be passed when creating a dataset / job. If not passed,
+            falls back to the default inferred from the environment.
+        credentials (google.auth.credentials.Credentials):
+            (Optional) The OAuth2 Credentials to use for this client. If not
+            passed (and if no ``_http`` object is passed), falls back to the
+            default inferred from the environment.
+        _http (requests.Session):
+            (Optional) HTTP object to make requests. Can be any object that
+            defines ``request()`` with the same interface as
+            :meth:`requests.Session.request`. If not passed, an ``_http``
+            object is created that is bound to the ``credentials`` for the
+            current object.
+            This parameter should be considered private, and could change in
+            the future.
+        location (str):
+            (Optional) Default location for jobs / datasets / tables.
+        default_query_job_config (google.cloud.bigquery.job.QueryJobConfig):
+            (Optional) Default ``QueryJobConfig``.
+            Will be merged into job configs passed into the ``query`` method.
+        client_info (google.api_core.client_info.ClientInfo):
+            The client info used to send a user-agent string along with API
+            requests. If ``None``, then default info will be used. Generally,
+            you only need to set this if you're developing your own library
+            or partner tool.
+        client_options (Union[~google.api_core.client_options.ClientOptions, dict]):
+            (Optional) Client options used to set user options on the client.
+            API Endpoint should be set through client_options.
+
+    Raises:
+        google.auth.exceptions.DefaultCredentialsError:
+            Raised if ``credentials`` is not specified and the library fails
+            to acquire default credentials.
+    """
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/bigquery",
+        "https://www.googleapis.com/auth/cloud-platform",
+    )
+    """The scopes required for authenticating as a BigQuery consumer."""
+
+    def __init__(
+        self,
+        project=None,
+        credentials=None,
+        _http=None,
+        location=None,
+        default_query_job_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+
+        kw_args = {"client_info": client_info}
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+                kw_args["api_endpoint"] = api_endpoint
+
+        self._connection = Connection(self, **kw_args)
+        self._location = location
+        self._default_query_job_config = default_query_job_config
+
+    @property
+    def location(self):
+        """Default location for jobs / datasets / tables."""
+        return self._location
+
+    def get_service_account_email(self, project=None):
+        """Get the email address of the project's BigQuery service account
+
+        Note:
+            This is the service account that BigQuery uses to manage tables
+            encrypted by a key in KMS.
+
+        Args:
+            project (str, optional):
+                Project ID to use for retreiving service account email.
+                Defaults to the client's project.
+
+        Returns:
+            str: service account email address
+
+        Example:
+
+            >>> from google.cloud import bigquery
+            >>> client = bigquery.Client()
+            >>> client.get_service_account_email()
+            my_service_account@my-project.iam.gserviceaccount.com
+
+        """
+        if project is None:
+            project = self.project
+        path = "/projects/%s/serviceAccount" % (project,)
+        api_response = self._connection.api_request(method="GET", path=path)
+        return api_response["email"]
+
+    def list_projects(self, max_results=None, page_token=None, retry=DEFAULT_RETRY):
+        """List projects for the project associated with this client.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/projects/list
+
+        :type max_results: int
+        :param max_results: (Optional) maximum number of projects to return,
+                            If not passed, defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            (Optional) Token representing a cursor into the projects. If
+            not passed, the API will return the first page of projects.
+            The token marks the beginning of the iterator to be returned
+            and the value of the ``page_token`` can be accessed at
+            ``next_page_token`` of the
+            :class:`~google.api_core.page_iterator.HTTPIterator`.
+
+        :type retry: :class:`google.api_core.retry.Retry`
+        :param retry: (Optional) How to retry the RPC.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~google.cloud.bigquery.client.Project`
+                  accessible to the current client.
+        """
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path="/projects",
+            item_to_value=_item_to_project,
+            items_key="projects",
+            page_token=page_token,
+            max_results=max_results,
+        )
+
+    def list_datasets(
+        self,
+        project=None,
+        include_all=False,
+        filter=None,
+        max_results=None,
+        page_token=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """List datasets for the project associated with this client.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/list
+
+        Args:
+            project (str):
+                Optional. Project ID to use for retreiving datasets. Defaults
+                to the client's project.
+            include_all (bool):
+                Optional. True if results include hidden datasets. Defaults
+                to False.
+            filter (str):
+                Optional. An expression for filtering the results by label.
+                For syntax, see
+                https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/list#filter.
+            max_results (int):
+                Optional. Maximum number of datasets to return.
+            page_token (str):
+                Optional. Token representing a cursor into the datasets. If
+                not passed, the API will return the first page of datasets.
+                The token marks the beginning of the iterator to be returned
+                and the value of the ``page_token`` can be accessed at
+                ``next_page_token`` of the
+                :class:`~google.api_core.page_iterator.HTTPIterator`.
+            retry (google.api_core.retry.Retry):
+                Optional. How to retry the RPC.
+
+        Returns:
+            google.api_core.page_iterator.Iterator:
+                Iterator of
+                :class:`~google.cloud.bigquery.dataset.DatasetListItem`.
+                associated with the project.
+        """
+        extra_params = {}
+        if project is None:
+            project = self.project
+        if include_all:
+            extra_params["all"] = True
+        if filter:
+            # TODO: consider supporting a dict of label -> value for filter,
+            # and converting it into a string here.
+            extra_params["filter"] = filter
+        path = "/projects/%s/datasets" % (project,)
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path=path,
+            item_to_value=_item_to_dataset,
+            items_key="datasets",
+            page_token=page_token,
+            max_results=max_results,
+            extra_params=extra_params,
+        )
+
+    def dataset(self, dataset_id, project=None):
+        """Construct a reference to a dataset.
+
+        :type dataset_id: str
+        :param dataset_id: ID of the dataset.
+
+        :type project: str
+        :param project: (Optional) project ID for the dataset (defaults to
+                        the project of the client).
+
+        :rtype: :class:`google.cloud.bigquery.dataset.DatasetReference`
+        :returns: a new ``DatasetReference`` instance
+        """
+        if project is None:
+            project = self.project
+
+        return DatasetReference(project, dataset_id)
+
+    def create_dataset(self, dataset, exists_ok=False, retry=DEFAULT_RETRY):
+        """API call: create the dataset via a POST request.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/insert
+
+        Args:
+            dataset (Union[ \
+                :class:`~google.cloud.bigquery.dataset.Dataset`, \
+                :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+                str, \
+            ]):
+                A :class:`~google.cloud.bigquery.dataset.Dataset` to create.
+                If ``dataset`` is a reference, an empty dataset is created
+                with the specified ID and client's default location.
+            exists_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "already exists"
+                errors when creating the dataset.
+            retry (google.api_core.retry.Retry):
+                Optional. How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.dataset.Dataset:
+                A new ``Dataset`` returned from the API.
+
+        Example:
+
+            >>> from google.cloud import bigquery
+            >>> client = bigquery.Client()
+            >>> dataset = bigquery.Dataset(client.dataset('my_dataset'))
+            >>> dataset = client.create_dataset(dataset)
+
+        """
+        if isinstance(dataset, str):
+            dataset = DatasetReference.from_string(
+                dataset, default_project=self.project
+            )
+        if isinstance(dataset, DatasetReference):
+            dataset = Dataset(dataset)
+
+        path = "/projects/%s/datasets" % (dataset.project,)
+
+        data = dataset.to_api_repr()
+        if data.get("location") is None and self.location is not None:
+            data["location"] = self.location
+
+        try:
+            api_response = self._call_api(retry, method="POST", path=path, data=data)
+            return Dataset.from_api_repr(api_response)
+        except google.api_core.exceptions.Conflict:
+            if not exists_ok:
+                raise
+            return self.get_dataset(dataset.reference, retry=retry)
+
+    def create_routine(self, routine, exists_ok=False, retry=DEFAULT_RETRY):
+        """[Beta] Create a routine via a POST request.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines/insert
+
+        Args:
+            routine (:class:`~google.cloud.bigquery.routine.Routine`):
+                A :class:`~google.cloud.bigquery.routine.Routine` to create.
+                The dataset that the routine belongs to must already exist.
+            exists_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "already exists"
+                errors when creating the routine.
+            retry (google.api_core.retry.Retry):
+                Optional. How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.routine.Routine:
+                A new ``Routine`` returned from the service.
+        """
+        reference = routine.reference
+        path = "/projects/{}/datasets/{}/routines".format(
+            reference.project, reference.dataset_id
+        )
+        resource = routine.to_api_repr()
+        try:
+            api_response = self._call_api(
+                retry, method="POST", path=path, data=resource
+            )
+            return Routine.from_api_repr(api_response)
+        except google.api_core.exceptions.Conflict:
+            if not exists_ok:
+                raise
+            return self.get_routine(routine.reference, retry=retry)
+
+    def create_table(self, table, exists_ok=False, retry=DEFAULT_RETRY):
+        """API call:  create a table via a PUT request
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/insert
+
+        Args:
+            table (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                A :class:`~google.cloud.bigquery.table.Table` to create.
+                If ``table`` is a reference, an empty table is created
+                with the specified ID. The dataset that the table belongs to
+                must already exist.
+            exists_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "already exists"
+                errors when creating the table.
+            retry (google.api_core.retry.Retry):
+                Optional. How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.table.Table:
+                A new ``Table`` returned from the service.
+        """
+        table = _table_arg_to_table(table, default_project=self.project)
+
+        path = "/projects/%s/datasets/%s/tables" % (table.project, table.dataset_id)
+        data = table.to_api_repr()
+        try:
+            api_response = self._call_api(retry, method="POST", path=path, data=data)
+            return Table.from_api_repr(api_response)
+        except google.api_core.exceptions.Conflict:
+            if not exists_ok:
+                raise
+            return self.get_table(table.reference, retry=retry)
+
+    def _call_api(self, retry, **kwargs):
+        call = functools.partial(self._connection.api_request, **kwargs)
+        if retry:
+            call = retry(call)
+        return call()
+
+    def get_dataset(self, dataset_ref, retry=DEFAULT_RETRY):
+        """Fetch the dataset referenced by ``dataset_ref``
+
+        Args:
+            dataset_ref (Union[ \
+                :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+                str, \
+            ]):
+                A reference to the dataset to fetch from the BigQuery API.
+                If a string is passed in, this method attempts to create a
+                dataset reference from a string using
+                :func:`~google.cloud.bigquery.dataset.DatasetReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.dataset.Dataset:
+                A ``Dataset`` instance.
+        """
+        if isinstance(dataset_ref, str):
+            dataset_ref = DatasetReference.from_string(
+                dataset_ref, default_project=self.project
+            )
+
+        api_response = self._call_api(retry, method="GET", path=dataset_ref.path)
+        return Dataset.from_api_repr(api_response)
+
+    def get_model(self, model_ref, retry=DEFAULT_RETRY):
+        """[Beta] Fetch the model referenced by ``model_ref``.
+
+         Args:
+            model_ref (Union[ \
+                :class:`~google.cloud.bigquery.model.ModelReference`, \
+                str, \
+            ]):
+                A reference to the model to fetch from the BigQuery API.
+                If a string is passed in, this method attempts to create a
+                model reference from a string using
+                :func:`google.cloud.bigquery.model.ModelReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+         Returns:
+            google.cloud.bigquery.model.Model:
+                A ``Model`` instance.
+        """
+        if isinstance(model_ref, str):
+            model_ref = ModelReference.from_string(
+                model_ref, default_project=self.project
+            )
+
+        api_response = self._call_api(retry, method="GET", path=model_ref.path)
+        return Model.from_api_repr(api_response)
+
+    def get_routine(self, routine_ref, retry=DEFAULT_RETRY):
+        """[Beta] Get the routine referenced by ``routine_ref``.
+
+         Args:
+            routine_ref (Union[ \
+                :class:`~google.cloud.bigquery.routine.Routine`, \
+                :class:`~google.cloud.bigquery.routine.RoutineReference`, \
+                str, \
+            ]):
+                A reference to the routine to fetch from the BigQuery API. If
+                a string is passed in, this method attempts to create a
+                reference from a string using
+                :func:`google.cloud.bigquery.routine.RoutineReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the API call.
+
+         Returns:
+            google.cloud.bigquery.routine.Routine:
+                A ``Routine`` instance.
+        """
+        if isinstance(routine_ref, str):
+            routine_ref = RoutineReference.from_string(
+                routine_ref, default_project=self.project
+            )
+
+        api_response = self._call_api(retry, method="GET", path=routine_ref.path)
+        return Routine.from_api_repr(api_response)
+
+    def get_table(self, table, retry=DEFAULT_RETRY):
+        """Fetch the table referenced by ``table``.
+
+        Args:
+            table (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                A reference to the table to fetch from the BigQuery API.
+                If a string is passed in, this method attempts to create a
+                table reference from a string using
+                :func:`google.cloud.bigquery.table.TableReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.table.Table:
+                A ``Table`` instance.
+        """
+        table_ref = _table_arg_to_table_ref(table, default_project=self.project)
+        api_response = self._call_api(retry, method="GET", path=table_ref.path)
+        return Table.from_api_repr(api_response)
+
+    def update_dataset(self, dataset, fields, retry=DEFAULT_RETRY):
+        """Change some fields of a dataset.
+
+        Use ``fields`` to specify which fields to update. At least one field
+        must be provided. If a field is listed in ``fields`` and is ``None`` in
+        ``dataset``, it will be deleted.
+
+        If ``dataset.etag`` is not ``None``, the update will only
+        succeed if the dataset on the server has the same ETag. Thus
+        reading a dataset with ``get_dataset``, changing its fields,
+        and then passing it to ``update_dataset`` will ensure that the changes
+        will only be saved if no modifications to the dataset occurred
+        since the read.
+
+        Args:
+            dataset (google.cloud.bigquery.dataset.Dataset):
+                The dataset to update.
+            fields (Sequence[str]):
+                The properties of ``dataset`` to change (e.g. "friendly_name").
+            retry (google.api_core.retry.Retry, optional):
+                How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.dataset.Dataset:
+                The modified ``Dataset`` instance.
+        """
+        partial = dataset._build_resource(fields)
+        if dataset.etag is not None:
+            headers = {"If-Match": dataset.etag}
+        else:
+            headers = None
+        api_response = self._call_api(
+            retry, method="PATCH", path=dataset.path, data=partial, headers=headers
+        )
+        return Dataset.from_api_repr(api_response)
+
+    def update_model(self, model, fields, retry=DEFAULT_RETRY):
+        """[Beta] Change some fields of a model.
+
+        Use ``fields`` to specify which fields to update. At least one field
+        must be provided. If a field is listed in ``fields`` and is ``None``
+        in ``model``, the field value will be deleted.
+
+        If ``model.etag`` is not ``None``, the update will only succeed if
+        the model on the server has the same ETag. Thus reading a model with
+        ``get_model``, changing its fields, and then passing it to
+        ``update_model`` will ensure that the changes will only be saved if
+        no modifications to the model occurred since the read.
+
+        Args:
+            model (google.cloud.bigquery.model.Model): The model to update.
+            fields (Sequence[str]):
+                The fields of ``model`` to change, spelled as the Model
+                properties (e.g. "friendly_name").
+            retry (google.api_core.retry.Retry):
+                (Optional) A description of how to retry the API call.
+
+        Returns:
+            google.cloud.bigquery.model.Model:
+                The model resource returned from the API call.
+        """
+        partial = model._build_resource(fields)
+        if model.etag:
+            headers = {"If-Match": model.etag}
+        else:
+            headers = None
+        api_response = self._call_api(
+            retry, method="PATCH", path=model.path, data=partial, headers=headers
+        )
+        return Model.from_api_repr(api_response)
+
+    def update_routine(self, routine, fields, retry=DEFAULT_RETRY):
+        """[Beta] Change some fields of a routine.
+
+        Use ``fields`` to specify which fields to update. At least one field
+        must be provided. If a field is listed in ``fields`` and is ``None``
+        in ``routine``, the field value will be deleted.
+
+        .. warning::
+           During beta, partial updates are not supported. You must provide
+           all fields in the resource.
+
+        If :attr:`~google.cloud.bigquery.routine.Routine.etag` is not
+        ``None``, the update will only succeed if the resource on the server
+        has the same ETag. Thus reading a routine with
+        :func:`~google.cloud.bigquery.client.Client.get_routine`, changing
+        its fields, and then passing it to this method will ensure that the
+        changes will only be saved if no modifications to the resource
+        occurred since the read.
+
+        Args:
+            routine (google.cloud.bigquery.routine.Routine): The routine to update.
+            fields (Sequence[str]):
+                The fields of ``routine`` to change, spelled as the
+                :class:`~google.cloud.bigquery.routine.Routine` properties
+                (e.g. ``type_``).
+            retry (google.api_core.retry.Retry):
+                (Optional) A description of how to retry the API call.
+
+        Returns:
+            google.cloud.bigquery.routine.Routine:
+                The routine resource returned from the API call.
+        """
+        partial = routine._build_resource(fields)
+        if routine.etag:
+            headers = {"If-Match": routine.etag}
+        else:
+            headers = None
+
+        # TODO: remove when routines update supports partial requests.
+        partial["routineReference"] = routine.reference.to_api_repr()
+
+        api_response = self._call_api(
+            retry, method="PUT", path=routine.path, data=partial, headers=headers
+        )
+        return Routine.from_api_repr(api_response)
+
+    def update_table(self, table, fields, retry=DEFAULT_RETRY):
+        """Change some fields of a table.
+
+        Use ``fields`` to specify which fields to update. At least one field
+        must be provided. If a field is listed in ``fields`` and is ``None``
+        in ``table``, the field value will be deleted.
+
+        If ``table.etag`` is not ``None``, the update will only succeed if
+        the table on the server has the same ETag. Thus reading a table with
+        ``get_table``, changing its fields, and then passing it to
+        ``update_table`` will ensure that the changes will only be saved if
+        no modifications to the table occurred since the read.
+
+        Args:
+            table (google.cloud.bigquery.table.Table): The table to update.
+            fields (Sequence[str]):
+                The fields of ``table`` to change, spelled as the Table
+                properties (e.g. "friendly_name").
+            retry (google.api_core.retry.Retry):
+                (Optional) A description of how to retry the API call.
+
+        Returns:
+            google.cloud.bigquery.table.Table:
+                The table resource returned from the API call.
+        """
+        partial = table._build_resource(fields)
+        if table.etag is not None:
+            headers = {"If-Match": table.etag}
+        else:
+            headers = None
+        api_response = self._call_api(
+            retry, method="PATCH", path=table.path, data=partial, headers=headers
+        )
+        return Table.from_api_repr(api_response)
+
+    def list_models(
+        self, dataset, max_results=None, page_token=None, retry=DEFAULT_RETRY
+    ):
+        """[Beta] List models in the dataset.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/models/list
+
+        Args:
+            dataset (Union[ \
+                :class:`~google.cloud.bigquery.dataset.Dataset`, \
+                :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+                str, \
+            ]):
+                A reference to the dataset whose models to list from the
+                BigQuery API. If a string is passed in, this method attempts
+                to create a dataset reference from a string using
+                :func:`google.cloud.bigquery.dataset.DatasetReference.from_string`.
+            max_results (int):
+                (Optional) Maximum number of models to return. If not passed,
+                defaults to a value set by the API.
+            page_token (str):
+                (Optional) Token representing a cursor into the models. If
+                not passed, the API will return the first page of models. The
+                token marks the beginning of the iterator to be returned and
+                the value of the ``page_token`` can be accessed at
+                ``next_page_token`` of the
+                :class:`~google.api_core.page_iterator.HTTPIterator`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+         Returns:
+            google.api_core.page_iterator.Iterator:
+                Iterator of
+                :class:`~google.cloud.bigquery.model.Model` contained
+                within the requested dataset.
+        """
+        if isinstance(dataset, str):
+            dataset = DatasetReference.from_string(
+                dataset, default_project=self.project
+            )
+
+        if not isinstance(dataset, (Dataset, DatasetReference)):
+            raise TypeError("dataset must be a Dataset, DatasetReference, or string")
+
+        path = "%s/models" % dataset.path
+        result = page_iterator.HTTPIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path=path,
+            item_to_value=_item_to_model,
+            items_key="models",
+            page_token=page_token,
+            max_results=max_results,
+        )
+        result.dataset = dataset
+        return result
+
+    def list_routines(
+        self, dataset, max_results=None, page_token=None, retry=DEFAULT_RETRY
+    ):
+        """[Beta] List routines in the dataset.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines/list
+
+        Args:
+            dataset (Union[ \
+                :class:`~google.cloud.bigquery.dataset.Dataset`, \
+                :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+                str, \
+            ]):
+                A reference to the dataset whose routines to list from the
+                BigQuery API. If a string is passed in, this method attempts
+                to create a dataset reference from a string using
+                :func:`google.cloud.bigquery.dataset.DatasetReference.from_string`.
+            max_results (int):
+                (Optional) Maximum number of routines to return. If not passed,
+                defaults to a value set by the API.
+            page_token (str):
+                (Optional) Token representing a cursor into the routines. If
+                not passed, the API will return the first page of routines. The
+                token marks the beginning of the iterator to be returned and
+                the value of the ``page_token`` can be accessed at
+                ``next_page_token`` of the
+                :class:`~google.api_core.page_iterator.HTTPIterator`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+         Returns:
+            google.api_core.page_iterator.Iterator:
+                Iterator of all
+                :class:`~google.cloud.bigquery.routine.Routine`s contained
+                within the requested dataset, limited by ``max_results``.
+        """
+        if isinstance(dataset, str):
+            dataset = DatasetReference.from_string(
+                dataset, default_project=self.project
+            )
+
+        if not isinstance(dataset, (Dataset, DatasetReference)):
+            raise TypeError("dataset must be a Dataset, DatasetReference, or string")
+
+        path = "{}/routines".format(dataset.path)
+        result = page_iterator.HTTPIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path=path,
+            item_to_value=_item_to_routine,
+            items_key="routines",
+            page_token=page_token,
+            max_results=max_results,
+        )
+        result.dataset = dataset
+        return result
+
+    def list_tables(
+        self, dataset, max_results=None, page_token=None, retry=DEFAULT_RETRY
+    ):
+        """List tables in the dataset.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/list
+
+        Args:
+            dataset (Union[ \
+                :class:`~google.cloud.bigquery.dataset.Dataset`, \
+                :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+                str, \
+            ]):
+                A reference to the dataset whose tables to list from the
+                BigQuery API. If a string is passed in, this method attempts
+                to create a dataset reference from a string using
+                :func:`google.cloud.bigquery.dataset.DatasetReference.from_string`.
+            max_results (int):
+                (Optional) Maximum number of tables to return. If not passed,
+                defaults to a value set by the API.
+            page_token (str):
+                (Optional) Token representing a cursor into the tables. If
+                not passed, the API will return the first page of tables. The
+                token marks the beginning of the iterator to be returned and
+                the value of the ``page_token`` can be accessed at
+                ``next_page_token`` of the
+                :class:`~google.api_core.page_iterator.HTTPIterator`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.api_core.page_iterator.Iterator:
+                Iterator of
+                :class:`~google.cloud.bigquery.table.TableListItem` contained
+                within the requested dataset.
+        """
+        if isinstance(dataset, str):
+            dataset = DatasetReference.from_string(
+                dataset, default_project=self.project
+            )
+
+        if not isinstance(dataset, (Dataset, DatasetReference)):
+            raise TypeError("dataset must be a Dataset, DatasetReference, or string")
+
+        path = "%s/tables" % dataset.path
+        result = page_iterator.HTTPIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path=path,
+            item_to_value=_item_to_table,
+            items_key="tables",
+            page_token=page_token,
+            max_results=max_results,
+        )
+        result.dataset = dataset
+        return result
+
+    def delete_dataset(
+        self, dataset, delete_contents=False, retry=DEFAULT_RETRY, not_found_ok=False
+    ):
+        """Delete a dataset.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/delete
+
+        Args
+            dataset (Union[ \
+                :class:`~google.cloud.bigquery.dataset.Dataset`, \
+                :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+                str, \
+            ]):
+                A reference to the dataset to delete. If a string is passed
+                in, this method attempts to create a dataset reference from a
+                string using
+                :func:`google.cloud.bigquery.dataset.DatasetReference.from_string`.
+            delete_contents (boolean):
+                (Optional) If True, delete all the tables in the dataset. If
+                False and the dataset contains tables, the request will fail.
+                Default is False.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+            not_found_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "not found" errors
+                when deleting the dataset.
+        """
+        if isinstance(dataset, str):
+            dataset = DatasetReference.from_string(
+                dataset, default_project=self.project
+            )
+
+        if not isinstance(dataset, (Dataset, DatasetReference)):
+            raise TypeError("dataset must be a Dataset or a DatasetReference")
+
+        params = {}
+        if delete_contents:
+            params["deleteContents"] = "true"
+
+        try:
+            self._call_api(
+                retry, method="DELETE", path=dataset.path, query_params=params
+            )
+        except google.api_core.exceptions.NotFound:
+            if not not_found_ok:
+                raise
+
+    def delete_model(self, model, retry=DEFAULT_RETRY, not_found_ok=False):
+        """[Beta] Delete a model
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/models/delete
+
+        Args:
+            model (Union[ \
+                :class:`~google.cloud.bigquery.model.Model`, \
+                :class:`~google.cloud.bigquery.model.ModelReference`, \
+                str, \
+            ]):
+                A reference to the model to delete. If a string is passed in,
+                this method attempts to create a model reference from a
+                string using
+                :func:`google.cloud.bigquery.model.ModelReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+            not_found_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "not found" errors
+                when deleting the model.
+        """
+        if isinstance(model, str):
+            model = ModelReference.from_string(model, default_project=self.project)
+
+        if not isinstance(model, (Model, ModelReference)):
+            raise TypeError("model must be a Model or a ModelReference")
+
+        try:
+            self._call_api(retry, method="DELETE", path=model.path)
+        except google.api_core.exceptions.NotFound:
+            if not not_found_ok:
+                raise
+
+    def delete_routine(self, routine, retry=DEFAULT_RETRY, not_found_ok=False):
+        """[Beta] Delete a routine.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines/delete
+
+        Args:
+            model (Union[ \
+                :class:`~google.cloud.bigquery.routine.Routine`, \
+                :class:`~google.cloud.bigquery.routine.RoutineReference`, \
+                str, \
+            ]):
+                A reference to the routine to delete. If a string is passed
+                in, this method attempts to create a routine reference from a
+                string using
+                :func:`google.cloud.bigquery.routine.RoutineReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+            not_found_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "not found" errors
+                when deleting the routine.
+        """
+        if isinstance(routine, str):
+            routine = RoutineReference.from_string(
+                routine, default_project=self.project
+            )
+
+        if not isinstance(routine, (Routine, RoutineReference)):
+            raise TypeError("routine must be a Routine or a RoutineReference")
+
+        try:
+            self._call_api(retry, method="DELETE", path=routine.path)
+        except google.api_core.exceptions.NotFound:
+            if not not_found_ok:
+                raise
+
+    def delete_table(self, table, retry=DEFAULT_RETRY, not_found_ok=False):
+        """Delete a table
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/delete
+
+        Args:
+            table (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                A reference to the table to delete. If a string is passed in,
+                this method attempts to create a table reference from a
+                string using
+                :func:`google.cloud.bigquery.table.TableReference.from_string`.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+            not_found_ok (bool):
+                Defaults to ``False``. If ``True``, ignore "not found" errors
+                when deleting the table.
+        """
+        table = _table_arg_to_table_ref(table, default_project=self.project)
+        if not isinstance(table, TableReference):
+            raise TypeError("Unable to get TableReference for table '{}'".format(table))
+
+        try:
+            self._call_api(retry, method="DELETE", path=table.path)
+        except google.api_core.exceptions.NotFound:
+            if not not_found_ok:
+                raise
+
+    def _get_query_results(
+        self, job_id, retry, project=None, timeout_ms=None, location=None
+    ):
+        """Get the query results object for a query job.
+
+        Arguments:
+            job_id (str): Name of the query job.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+            project (str):
+                (Optional) project ID for the query job (defaults to the
+                project of the client).
+            timeout_ms (int):
+                (Optional) number of milliseconds the the API call should
+                wait for the query to complete before the request times out.
+            location (str): Location of the query job.
+
+        Returns:
+            google.cloud.bigquery.query._QueryResults:
+                A new ``_QueryResults`` instance.
+        """
+
+        extra_params = {"maxResults": 0}
+
+        if project is None:
+            project = self.project
+
+        if timeout_ms is not None:
+            extra_params["timeoutMs"] = timeout_ms
+
+        if location is None:
+            location = self.location
+
+        if location is not None:
+            extra_params["location"] = location
+
+        path = "/projects/{}/queries/{}".format(project, job_id)
+
+        # This call is typically made in a polling loop that checks whether the
+        # job is complete (from QueryJob.done(), called ultimately from
+        # QueryJob.result()). So we don't need to poll here.
+        resource = self._call_api(
+            retry, method="GET", path=path, query_params=extra_params
+        )
+        return _QueryResults.from_api_repr(resource)
+
+    def job_from_resource(self, resource):
+        """Detect correct job type from resource and instantiate.
+
+        :type resource: dict
+        :param resource: one job resource from API response
+
+        :rtype: One of:
+                :class:`google.cloud.bigquery.job.LoadJob`,
+                :class:`google.cloud.bigquery.job.CopyJob`,
+                :class:`google.cloud.bigquery.job.ExtractJob`,
+                or :class:`google.cloud.bigquery.job.QueryJob`
+        :returns: the job instance, constructed via the resource
+        """
+        config = resource.get("configuration", {})
+        if "load" in config:
+            return job.LoadJob.from_api_repr(resource, self)
+        elif "copy" in config:
+            return job.CopyJob.from_api_repr(resource, self)
+        elif "extract" in config:
+            return job.ExtractJob.from_api_repr(resource, self)
+        elif "query" in config:
+            return job.QueryJob.from_api_repr(resource, self)
+        return job.UnknownJob.from_api_repr(resource, self)
+
+    def get_job(self, job_id, project=None, location=None, retry=DEFAULT_RETRY):
+        """Fetch a job for the project associated with this client.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/get
+
+        Arguments:
+            job_id (str): Unique job identifier.
+
+        Keyword Arguments:
+            project (str):
+                (Optional) ID of the project which ownsthe job (defaults to
+                the client's project).
+            location (str): Location where the job was run.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            Union[google.cloud.bigquery.job.LoadJob, \
+                  google.cloud.bigquery.job.CopyJob, \
+                  google.cloud.bigquery.job.ExtractJob, \
+                  google.cloud.bigquery.job.QueryJob]:
+                Job instance, based on the resource returned by the API.
+        """
+        extra_params = {"projection": "full"}
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        if location is not None:
+            extra_params["location"] = location
+
+        path = "/projects/{}/jobs/{}".format(project, job_id)
+
+        resource = self._call_api(
+            retry, method="GET", path=path, query_params=extra_params
+        )
+
+        return self.job_from_resource(resource)
+
+    def cancel_job(self, job_id, project=None, location=None, retry=DEFAULT_RETRY):
+        """Attempt to cancel a job from a job ID.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/cancel
+
+        Arguments:
+            job_id (str): Unique job identifier.
+
+        Keyword Arguments:
+            project (str):
+                (Optional) ID of the project which owns the job (defaults to
+                the client's project).
+            location (str): Location where the job was run.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            Union[google.cloud.bigquery.job.LoadJob, \
+                  google.cloud.bigquery.job.CopyJob, \
+                  google.cloud.bigquery.job.ExtractJob, \
+                  google.cloud.bigquery.job.QueryJob]:
+                Job instance, based on the resource returned by the API.
+        """
+        extra_params = {"projection": "full"}
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        if location is not None:
+            extra_params["location"] = location
+
+        path = "/projects/{}/jobs/{}/cancel".format(project, job_id)
+
+        resource = self._call_api(
+            retry, method="POST", path=path, query_params=extra_params
+        )
+
+        return self.job_from_resource(resource["job"])
+
+    def list_jobs(
+        self,
+        project=None,
+        max_results=None,
+        page_token=None,
+        all_users=None,
+        state_filter=None,
+        retry=DEFAULT_RETRY,
+        min_creation_time=None,
+        max_creation_time=None,
+    ):
+        """List jobs for the project associated with this client.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/list
+
+        Args:
+            project (str, optional):
+                Project ID to use for retreiving datasets. Defaults
+                to the client's project.
+            max_results (int, optional):
+                Maximum number of jobs to return.
+            page_token (str, optional):
+                Opaque marker for the next "page" of jobs. If not
+                passed, the API will return the first page of jobs. The token
+                marks the beginning of the iterator to be returned and the
+                value of the ``page_token`` can be accessed at
+                ``next_page_token`` of
+                :class:`~google.api_core.page_iterator.HTTPIterator`.
+            all_users (bool, optional):
+                If true, include jobs owned by all users in the project.
+                Defaults to :data:`False`.
+            state_filter (str, optional):
+                If set, include only jobs matching the given state. One of:
+                    * ``"done"``
+                    * ``"pending"``
+                    * ``"running"``
+            retry (google.api_core.retry.Retry, optional):
+                How to retry the RPC.
+            min_creation_time (datetime.datetime, optional):
+                Min value for job creation time. If set, only jobs created
+                after or at this timestamp are returned. If the datetime has
+                no time zone assumes UTC time.
+            max_creation_time (datetime.datetime, optional):
+                Max value for job creation time. If set, only jobs created
+                before or at this timestamp are returned. If the datetime has
+                no time zone assumes UTC time.
+
+        Returns:
+            google.api_core.page_iterator.Iterator:
+                Iterable of job instances.
+        """
+        extra_params = {
+            "allUsers": all_users,
+            "stateFilter": state_filter,
+            "minCreationTime": _str_or_none(
+                google.cloud._helpers._millis_from_datetime(min_creation_time)
+            ),
+            "maxCreationTime": _str_or_none(
+                google.cloud._helpers._millis_from_datetime(max_creation_time)
+            ),
+            "projection": "full",
+        }
+
+        extra_params = {
+            param: value for param, value in extra_params.items() if value is not None
+        }
+
+        if project is None:
+            project = self.project
+
+        path = "/projects/%s/jobs" % (project,)
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path=path,
+            item_to_value=_item_to_job,
+            items_key="jobs",
+            page_token=page_token,
+            max_results=max_results,
+            extra_params=extra_params,
+        )
+
+    def load_table_from_uri(
+        self,
+        source_uris,
+        destination,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        job_config=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """Starts a job for loading data into a table from CloudStorage.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load
+
+        Arguments:
+            source_uris (Union[str, Sequence[str]]):
+                URIs of data files to be loaded; in format
+                ``gs://<bucket_name>/<object_name_or_glob>``.
+            destination (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                Table into which data is to be loaded. If a string is passed
+                in, this method attempts to create a table reference from a
+                string using
+                :func:`google.cloud.bigquery.table.TableReference.from_string`.
+
+        Keyword Arguments:
+            job_id (str): (Optional) Name of the job.
+            job_id_prefix (str):
+                (Optional) the user-provided prefix for a randomly generated
+                job ID. This parameter will be ignored if a ``job_id`` is
+                also given.
+            location (str):
+                Location where to run the job. Must match the location of the
+                destination table.
+            project (str):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            job_config (google.cloud.bigquery.job.LoadJobConfig):
+                (Optional) Extra configuration options for the job.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.job.LoadJob: A new load job.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        job_ref = job._JobReference(job_id, project=project, location=location)
+
+        if isinstance(source_uris, six.string_types):
+            source_uris = [source_uris]
+
+        destination = _table_arg_to_table_ref(destination, default_project=self.project)
+        load_job = job.LoadJob(job_ref, source_uris, destination, self, job_config)
+        load_job._begin(retry=retry)
+
+        return load_job
+
+    def load_table_from_file(
+        self,
+        file_obj,
+        destination,
+        rewind=False,
+        size=None,
+        num_retries=_DEFAULT_NUM_RETRIES,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        job_config=None,
+    ):
+        """Upload the contents of this table from a file-like object.
+
+        Similar to :meth:`load_table_from_uri`, this method creates, starts and
+        returns a :class:`~google.cloud.bigquery.job.LoadJob`.
+
+        Arguments:
+            file_obj (file): A file handle opened in binary mode for reading.
+            destination (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                Table into which data is to be loaded. If a string is passed
+                in, this method attempts to create a table reference from a
+                string using
+                :func:`google.cloud.bigquery.table.TableReference.from_string`.
+
+        Keyword Arguments:
+            rewind (bool):
+                If True, seek to the beginning of the file handle before
+                reading the file.
+            size (int):
+                The number of bytes to read from the file handle. If size is
+                ``None`` or large, resumable upload will be used. Otherwise,
+                multipart upload will be used.
+            num_retries (int): Number of upload retries. Defaults to 6.
+            job_id (str): (Optional) Name of the job.
+            job_id_prefix (str):
+                (Optional) the user-provided prefix for a randomly generated
+                job ID. This parameter will be ignored if a ``job_id`` is
+                also given.
+            location (str):
+                Location where to run the job. Must match the location of the
+                destination table.
+            project (str):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            job_config (google.cloud.bigquery.job.LoadJobConfig):
+                (Optional) Extra configuration options for the job.
+
+        Returns:
+            google.cloud.bigquery.job.LoadJob: A new load job.
+
+        Raises:
+            ValueError:
+                If ``size`` is not passed in and can not be determined, or if
+                the ``file_obj`` can be detected to be a file opened in text
+                mode.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        destination = _table_arg_to_table_ref(destination, default_project=self.project)
+        job_ref = job._JobReference(job_id, project=project, location=location)
+        load_job = job.LoadJob(job_ref, None, destination, self, job_config)
+        job_resource = load_job.to_api_repr()
+
+        if rewind:
+            file_obj.seek(0, os.SEEK_SET)
+
+        _check_mode(file_obj)
+
+        try:
+            if size is None or size >= _MAX_MULTIPART_SIZE:
+                response = self._do_resumable_upload(
+                    file_obj, job_resource, num_retries
+                )
+            else:
+                response = self._do_multipart_upload(
+                    file_obj, job_resource, size, num_retries
+                )
+        except resumable_media.InvalidResponse as exc:
+            raise exceptions.from_http_response(exc.response)
+
+        return self.job_from_resource(response.json())
+
+    def load_table_from_dataframe(
+        self,
+        dataframe,
+        destination,
+        num_retries=_DEFAULT_NUM_RETRIES,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        job_config=None,
+        parquet_compression="snappy",
+    ):
+        """Upload the contents of a table from a pandas DataFrame.
+
+        Similar to :meth:`load_table_from_uri`, this method creates, starts and
+        returns a :class:`~google.cloud.bigquery.job.LoadJob`.
+
+        Arguments:
+            dataframe (pandas.DataFrame):
+                A :class:`~pandas.DataFrame` containing the data to load.
+            destination (google.cloud.bigquery.table.TableReference):
+                The destination table to use for loading the data. If it is an
+                existing table, the schema of the :class:`~pandas.DataFrame`
+                must match the schema of the destination table. If the table
+                does not yet exist, the schema is inferred from the
+                :class:`~pandas.DataFrame`.
+
+                If a string is passed in, this method attempts to create a
+                table reference from a string using
+                :func:`google.cloud.bigquery.table.TableReference.from_string`.
+
+        Keyword Arguments:
+            num_retries (int, optional): Number of upload retries.
+            job_id (str, optional): Name of the job.
+            job_id_prefix (str, optional):
+                The user-provided prefix for a randomly generated
+                job ID. This parameter will be ignored if a ``job_id`` is
+                also given.
+            location (str):
+                Location where to run the job. Must match the location of the
+                destination table.
+            project (str, optional):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            job_config (~google.cloud.bigquery.job.LoadJobConfig, optional):
+                Extra configuration options for the job.
+
+                To override the default pandas data type conversions, supply
+                a value for
+                :attr:`~google.cloud.bigquery.job.LoadJobConfig.schema` with
+                column names matching those of the dataframe. The BigQuery
+                schema is used to determine the correct data type conversion.
+                Indexes are not loaded. Requires the :mod:`pyarrow` library.
+            parquet_compression (str):
+                 [Beta] The compression method to use if intermittently
+                 serializing ``dataframe`` to a parquet file.
+
+                 If ``pyarrow`` and job config schema are used, the argument
+                 is directly passed as the ``compression`` argument to the
+                 underlying ``pyarrow.parquet.write_table()`` method (the
+                 default value "snappy" gets converted to uppercase).
+                 https://arrow.apache.org/docs/python/generated/pyarrow.parquet.write_table.html#pyarrow-parquet-write-table
+
+                 If either ``pyarrow`` or job config schema are missing, the
+                 argument is directly passed as the ``compression`` argument
+                 to the underlying ``DataFrame.to_parquet()`` method.
+                 https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.DataFrame.to_parquet.html#pandas.DataFrame.to_parquet
+
+        Returns:
+            google.cloud.bigquery.job.LoadJob: A new load job.
+
+        Raises:
+            ImportError:
+                If a usable parquet engine cannot be found. This method
+                requires :mod:`pyarrow` or :mod:`fastparquet` to be
+                installed.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if job_config is None:
+            job_config = job.LoadJobConfig()
+        else:
+            # Make a copy so that the job config isn't modified in-place.
+            job_config_properties = copy.deepcopy(job_config._properties)
+            job_config = job.LoadJobConfig()
+            job_config._properties = job_config_properties
+        job_config.source_format = job.SourceFormat.PARQUET
+
+        if location is None:
+            location = self.location
+
+        job_config.schema = _pandas_helpers.dataframe_to_bq_schema(
+            dataframe, job_config.schema
+        )
+
+        tmpfd, tmppath = tempfile.mkstemp(suffix="_job_{}.parquet".format(job_id[:8]))
+        os.close(tmpfd)
+
+        try:
+            if pyarrow and job_config.schema:
+                if parquet_compression == "snappy":  # adjust the default value
+                    parquet_compression = parquet_compression.upper()
+
+                _pandas_helpers.dataframe_to_parquet(
+                    dataframe,
+                    job_config.schema,
+                    tmppath,
+                    parquet_compression=parquet_compression,
+                )
+            else:
+                if job_config.schema:
+                    warnings.warn(
+                        "job_config.schema is set, but not used to assist in "
+                        "identifying correct types for data serialization. "
+                        "Please install the pyarrow package.",
+                        PendingDeprecationWarning,
+                        stacklevel=2,
+                    )
+
+                dataframe.to_parquet(tmppath, compression=parquet_compression)
+
+            with open(tmppath, "rb") as parquet_file:
+                return self.load_table_from_file(
+                    parquet_file,
+                    destination,
+                    num_retries=num_retries,
+                    rewind=True,
+                    job_id=job_id,
+                    job_id_prefix=job_id_prefix,
+                    location=location,
+                    project=project,
+                    job_config=job_config,
+                )
+
+        finally:
+            os.remove(tmppath)
+
+    def load_table_from_json(
+        self,
+        json_rows,
+        destination,
+        num_retries=_DEFAULT_NUM_RETRIES,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        job_config=None,
+    ):
+        """Upload the contents of a table from a JSON string or dict.
+
+        Arguments:
+            json_rows (Iterable[Dict[str, Any]]):
+                Row data to be inserted. Keys must match the table schema fields
+                and values must be JSON-compatible representations.
+            destination (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                Table into which data is to be loaded. If a string is passed
+                in, this method attempts to create a table reference from a
+                string using
+                :func:`google.cloud.bigquery.table.TableReference.from_string`.
+
+        Keyword Arguments:
+            num_retries (int, optional): Number of upload retries.
+            job_id (str): (Optional) Name of the job.
+            job_id_prefix (str):
+                (Optional) the user-provided prefix for a randomly generated
+                job ID. This parameter will be ignored if a ``job_id`` is
+                also given.
+            location (str):
+                Location where to run the job. Must match the location of the
+                destination table.
+            project (str):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            job_config (google.cloud.bigquery.job.LoadJobConfig):
+                (Optional) Extra configuration options for the job. The
+                ``source_format`` setting is always set to
+                :attr:`~google.cloud.bigquery.job.SourceFormat.NEWLINE_DELIMITED_JSON`.
+
+        Returns:
+            google.cloud.bigquery.job.LoadJob: A new load job.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if job_config is None:
+            job_config = job.LoadJobConfig()
+        else:
+            # Make a copy so that the job config isn't modified in-place.
+            job_config = copy.deepcopy(job_config)
+        job_config.source_format = job.SourceFormat.NEWLINE_DELIMITED_JSON
+
+        if job_config.schema is None:
+            job_config.autodetect = True
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        destination = _table_arg_to_table_ref(destination, default_project=self.project)
+
+        data_str = u"\n".join(json.dumps(item) for item in json_rows)
+        data_file = io.BytesIO(data_str.encode())
+
+        return self.load_table_from_file(
+            data_file,
+            destination,
+            num_retries=num_retries,
+            job_id=job_id,
+            job_id_prefix=job_id_prefix,
+            location=location,
+            project=project,
+            job_config=job_config,
+        )
+
+    def _do_resumable_upload(self, stream, metadata, num_retries):
+        """Perform a resumable upload.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type metadata: dict
+        :param metadata: The metadata associated with the upload.
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :rtype: :class:`~requests.Response`
+        :returns: The "200 OK" response object returned after the final chunk
+                  is uploaded.
+        """
+        upload, transport = self._initiate_resumable_upload(
+            stream, metadata, num_retries
+        )
+
+        while not upload.finished:
+            response = upload.transmit_next_chunk(transport)
+
+        return response
+
+    def _initiate_resumable_upload(self, stream, metadata, num_retries):
+        """Initiate a resumable upload.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type metadata: dict
+        :param metadata: The metadata associated with the upload.
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :rtype: tuple
+        :returns:
+            Pair of
+
+            * The :class:`~google.resumable_media.requests.ResumableUpload`
+              that was created
+            * The ``transport`` used to initiate the upload.
+        """
+        chunk_size = _DEFAULT_CHUNKSIZE
+        transport = self._http
+        headers = _get_upload_headers(self._connection.user_agent)
+        upload_url = _RESUMABLE_URL_TEMPLATE.format(project=self.project)
+        # TODO: modify ResumableUpload to take a retry.Retry object
+        # that it can use for the initial RPC.
+        upload = ResumableUpload(upload_url, chunk_size, headers=headers)
+
+        if num_retries is not None:
+            upload._retry_strategy = resumable_media.RetryStrategy(
+                max_retries=num_retries
+            )
+
+        upload.initiate(
+            transport, stream, metadata, _GENERIC_CONTENT_TYPE, stream_final=False
+        )
+
+        return upload, transport
+
+    def _do_multipart_upload(self, stream, metadata, size, num_retries):
+        """Perform a multipart upload.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type metadata: dict
+        :param metadata: The metadata associated with the upload.
+
+        :type size: int
+        :param size: The number of bytes to be uploaded (which will be read
+                     from ``stream``). If not provided, the upload will be
+                     concluded once ``stream`` is exhausted (or :data:`None`).
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :rtype: :class:`~requests.Response`
+        :returns: The "200 OK" response object returned after the multipart
+                  upload request.
+        :raises: :exc:`ValueError` if the ``stream`` has fewer than ``size``
+                 bytes remaining.
+        """
+        data = stream.read(size)
+        if len(data) < size:
+            msg = _READ_LESS_THAN_SIZE.format(size, len(data))
+            raise ValueError(msg)
+
+        headers = _get_upload_headers(self._connection.user_agent)
+
+        upload_url = _MULTIPART_URL_TEMPLATE.format(project=self.project)
+        upload = MultipartUpload(upload_url, headers=headers)
+
+        if num_retries is not None:
+            upload._retry_strategy = resumable_media.RetryStrategy(
+                max_retries=num_retries
+            )
+
+        response = upload.transmit(self._http, data, metadata, _GENERIC_CONTENT_TYPE)
+
+        return response
+
+    def copy_table(
+        self,
+        sources,
+        destination,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        job_config=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """Copy one or more tables to another table.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.copy
+
+        Arguments:
+            sources (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+                Sequence[ \
+                    Union[ \
+                        :class:`~google.cloud.bigquery.table.Table`, \
+                        :class:`~google.cloud.bigquery.table.TableReference`, \
+                        str, \
+                    ] \
+                ], \
+            ]):
+                Table or tables to be copied.
+            destination (Union[
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                Table into which data is to be copied.
+
+        Keyword Arguments:
+            job_id (str): (Optional) The ID of the job.
+            job_id_prefix (str)
+                (Optional) the user-provided prefix for a randomly generated
+                job ID. This parameter will be ignored if a ``job_id`` is
+                also given.
+            location (str):
+                Location where to run the job. Must match the location of any
+                source table as well as the destination table.
+            project (str):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            job_config (google.cloud.bigquery.job.CopyJobConfig):
+                (Optional) Extra configuration options for the job.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.job.CopyJob: A new copy job instance.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        job_ref = job._JobReference(job_id, project=project, location=location)
+
+        # sources can be one of many different input types. (string, Table,
+        # TableReference, or a sequence of any of those.) Convert them all to a
+        # list of TableReferences.
+        #
+        # _table_arg_to_table_ref leaves lists unmodified.
+        sources = _table_arg_to_table_ref(sources, default_project=self.project)
+
+        if not isinstance(sources, collections_abc.Sequence):
+            sources = [sources]
+
+        sources = [
+            _table_arg_to_table_ref(source, default_project=self.project)
+            for source in sources
+        ]
+
+        destination = _table_arg_to_table_ref(destination, default_project=self.project)
+
+        copy_job = job.CopyJob(
+            job_ref, sources, destination, client=self, job_config=job_config
+        )
+        copy_job._begin(retry=retry)
+
+        return copy_job
+
+    def extract_table(
+        self,
+        source,
+        destination_uris,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        job_config=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """Start a job to extract a table into Cloud Storage files.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.extract
+
+        Arguments:
+            source (Union[ \
+                :class:`google.cloud.bigquery.table.Table`, \
+                :class:`google.cloud.bigquery.table.TableReference`, \
+                src, \
+            ]):
+                Table to be extracted.
+            destination_uris (Union[str, Sequence[str]]):
+                URIs of Cloud Storage file(s) into which table data is to be
+                extracted; in format
+                ``gs://<bucket_name>/<object_name_or_glob>``.
+
+        Keyword Arguments:
+            job_id (str): (Optional) The ID of the job.
+            job_id_prefix (str)
+                (Optional) the user-provided prefix for a randomly generated
+                job ID. This parameter will be ignored if a ``job_id`` is
+                also given.
+            location (str):
+                Location where to run the job. Must match the location of the
+                source table.
+            project (str):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            job_config (google.cloud.bigquery.job.ExtractJobConfig):
+                (Optional) Extra configuration options for the job.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+        :type source: :class:`google.cloud.bigquery.table.TableReference`
+        :param source: table to be extracted.
+
+
+        Returns:
+            google.cloud.bigquery.job.ExtractJob: A new extract job instance.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        job_ref = job._JobReference(job_id, project=project, location=location)
+        source = _table_arg_to_table_ref(source, default_project=self.project)
+
+        if isinstance(destination_uris, six.string_types):
+            destination_uris = [destination_uris]
+
+        extract_job = job.ExtractJob(
+            job_ref, source, destination_uris, client=self, job_config=job_config
+        )
+        extract_job._begin(retry=retry)
+
+        return extract_job
+
+    def query(
+        self,
+        query,
+        job_config=None,
+        job_id=None,
+        job_id_prefix=None,
+        location=None,
+        project=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """Run a SQL query.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query
+
+        Arguments:
+            query (str):
+                SQL query to be executed. Defaults to the standard SQL
+                dialect. Use the ``job_config`` parameter to change dialects.
+
+        Keyword Arguments:
+            job_config (google.cloud.bigquery.job.QueryJobConfig):
+                (Optional) Extra configuration options for the job.
+                To override any options that were previously set in
+                the ``default_query_job_config`` given to the
+                ``Client`` constructor, manually set those options to ``None``,
+                or whatever value is preferred.
+            job_id (str): (Optional) ID to use for the query job.
+            job_id_prefix (str):
+                (Optional) The prefix to use for a randomly generated job ID.
+                This parameter will be ignored if a ``job_id`` is also given.
+            location (str):
+                Location where to run the job. Must match the location of the
+                any table used in the query as well as the destination table.
+            project (str):
+                Project ID of the project of where to run the job. Defaults
+                to the client's project.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.job.QueryJob: A new query job instance.
+        """
+        job_id = _make_job_id(job_id, job_id_prefix)
+
+        if project is None:
+            project = self.project
+
+        if location is None:
+            location = self.location
+
+        if self._default_query_job_config:
+            if job_config:
+                # anything that's not defined on the incoming
+                # that is in the default,
+                # should be filled in with the default
+                # the incoming therefore has precedence
+                job_config = job_config._fill_from_default(
+                    self._default_query_job_config
+                )
+            else:
+                job_config = self._default_query_job_config
+
+        job_ref = job._JobReference(job_id, project=project, location=location)
+        query_job = job.QueryJob(job_ref, query, client=self, job_config=job_config)
+        query_job._begin(retry=retry)
+
+        return query_job
+
+    def insert_rows(self, table, rows, selected_fields=None, **kwargs):
+        """Insert rows into a table via the streaming API.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tabledata/insertAll
+
+        Args:
+            table (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                The destination table for the row data, or a reference to it.
+            rows (Union[ \
+                Sequence[Tuple], \
+                Sequence[dict], \
+            ]):
+                Row data to be inserted. If a list of tuples is given, each
+                tuple should contain data for each schema field on the
+                current table and in the same order as the schema fields. If
+                a list of dictionaries is given, the keys must include all
+                required fields in the schema. Keys which do not correspond
+                to a field in the schema are ignored.
+            selected_fields (Sequence[ \
+                :class:`~google.cloud.bigquery.schema.SchemaField`, \
+            ]):
+                The fields to return. Required if ``table`` is a
+                :class:`~google.cloud.bigquery.table.TableReference`.
+            kwargs (dict):
+                Keyword arguments to
+                :meth:`~google.cloud.bigquery.client.Client.insert_rows_json`.
+
+        Returns:
+            Sequence[Mappings]:
+                One mapping per row with insert errors: the "index" key
+                identifies the row, and the "errors" key contains a list of
+                the mappings describing one or more problems with the row.
+
+        Raises:
+            ValueError: if table's schema is not set
+        """
+        table = _table_arg_to_table(table, default_project=self.project)
+
+        if not isinstance(table, Table):
+            raise TypeError(_NEED_TABLE_ARGUMENT)
+
+        schema = table.schema
+
+        # selected_fields can override the table schema.
+        if selected_fields is not None:
+            schema = selected_fields
+
+        if len(schema) == 0:
+            raise ValueError(
+                (
+                    "Could not determine schema for table '{}'. Call client.get_table() "
+                    "or pass in a list of schema fields to the selected_fields argument."
+                ).format(table)
+            )
+
+        json_rows = [_record_field_to_json(schema, row) for row in rows]
+
+        return self.insert_rows_json(table, json_rows, **kwargs)
+
+    def insert_rows_json(
+        self,
+        table,
+        json_rows,
+        row_ids=None,
+        skip_invalid_rows=None,
+        ignore_unknown_values=None,
+        template_suffix=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """Insert rows into a table without applying local type conversions.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tabledata/insertAll
+
+        table (Union[ \
+            :class:`~google.cloud.bigquery.table.Table` \
+            :class:`~google.cloud.bigquery.table.TableReference`, \
+            str, \
+        ]):
+            The destination table for the row data, or a reference to it.
+        json_rows (Sequence[dict]):
+            Row data to be inserted. Keys must match the table schema fields
+            and values must be JSON-compatible representations.
+        row_ids (Sequence[str]):
+            (Optional) Unique ids, one per row being inserted. If omitted,
+            unique IDs are created.
+        skip_invalid_rows (bool):
+            (Optional) Insert all valid rows of a request, even if invalid
+            rows exist. The default value is False, which causes the entire
+            request to fail if any invalid rows exist.
+        ignore_unknown_values (bool):
+            (Optional) Accept rows that contain values that do not match the
+            schema. The unknown values are ignored. Default is False, which
+            treats unknown values as errors.
+        template_suffix (str):
+            (Optional) treat ``name`` as a template table and provide a suffix.
+            BigQuery will create the table ``<name> + <template_suffix>`` based
+            on the schema of the template table. See
+            https://cloud.google.com/bigquery/streaming-data-into-bigquery#template-tables
+        retry (:class:`google.api_core.retry.Retry`):
+            (Optional) How to retry the RPC.
+
+        Returns:
+            Sequence[Mappings]:
+                One mapping per row with insert errors: the "index" key
+                identifies the row, and the "errors" key contains a list of
+                the mappings describing one or more problems with the row.
+        """
+        # Convert table to just a reference because unlike insert_rows,
+        # insert_rows_json doesn't need the table schema. It's not doing any
+        # type conversions.
+        table = _table_arg_to_table_ref(table, default_project=self.project)
+        rows_info = []
+        data = {"rows": rows_info}
+
+        for index, row in enumerate(json_rows):
+            info = {"json": row}
+            if row_ids is not None:
+                info["insertId"] = row_ids[index]
+            else:
+                info["insertId"] = str(uuid.uuid4())
+            rows_info.append(info)
+
+        if skip_invalid_rows is not None:
+            data["skipInvalidRows"] = skip_invalid_rows
+
+        if ignore_unknown_values is not None:
+            data["ignoreUnknownValues"] = ignore_unknown_values
+
+        if template_suffix is not None:
+            data["templateSuffix"] = template_suffix
+
+        # We can always retry, because every row has an insert ID.
+        response = self._call_api(
+            retry, method="POST", path="%s/insertAll" % table.path, data=data
+        )
+        errors = []
+
+        for error in response.get("insertErrors", ()):
+            errors.append({"index": int(error["index"]), "errors": error["errors"]})
+
+        return errors
+
+    def list_partitions(self, table, retry=DEFAULT_RETRY):
+        """List the partitions in a table.
+
+        Arguments:
+            table (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                The table or reference from which to get partition info
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            List[str]:
+                A list of the partition ids present in the partitioned table
+        """
+        table = _table_arg_to_table_ref(table, default_project=self.project)
+        meta_table = self.get_table(
+            TableReference(
+                self.dataset(table.dataset_id, project=table.project),
+                "%s$__PARTITIONS_SUMMARY__" % table.table_id,
+            )
+        )
+
+        subset = [col for col in meta_table.schema if col.name == "partition_id"]
+        return [
+            row[0]
+            for row in self.list_rows(meta_table, selected_fields=subset, retry=retry)
+        ]
+
+    def list_rows(
+        self,
+        table,
+        selected_fields=None,
+        max_results=None,
+        page_token=None,
+        start_index=None,
+        page_size=None,
+        retry=DEFAULT_RETRY,
+    ):
+        """List the rows of the table.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tabledata/list
+
+        .. note::
+
+           This method assumes that the provided schema is up-to-date with the
+           schema as defined on the back-end: if the two schemas are not
+           identical, the values returned may be incomplete. To ensure that the
+           local copy of the schema is up-to-date, call ``client.get_table``.
+
+        Args:
+            table (Union[ \
+                :class:`~google.cloud.bigquery.table.Table`, \
+                :class:`~google.cloud.bigquery.table.TableListItem`, \
+                :class:`~google.cloud.bigquery.table.TableReference`, \
+                str, \
+            ]):
+                The table to list, or a reference to it. When the table
+                object does not contain a schema and ``selected_fields`` is
+                not supplied, this method calls ``get_table`` to fetch the
+                table schema.
+            selected_fields (Sequence[ \
+                :class:`~google.cloud.bigquery.schema.SchemaField` \
+            ]):
+                The fields to return. If not supplied, data for all columns
+                are downloaded.
+            max_results (int):
+                (Optional) maximum number of rows to return.
+            page_token (str):
+                (Optional) Token representing a cursor into the table's rows.
+                If not passed, the API will return the first page of the
+                rows. The token marks the beginning of the iterator to be
+                returned and the value of the ``page_token`` can be accessed
+                at ``next_page_token`` of the
+                :class:`~google.cloud.bigquery.table.RowIterator`.
+            start_index (int):
+                (Optional) The zero-based index of the starting row to read.
+            page_size (int):
+                Optional. The maximum number of rows in each page of results
+                from this request. Non-positive values are ignored. Defaults
+                to a sensible value set by the API.
+            retry (:class:`google.api_core.retry.Retry`):
+                (Optional) How to retry the RPC.
+
+        Returns:
+            google.cloud.bigquery.table.RowIterator:
+                Iterator of row data
+                :class:`~google.cloud.bigquery.table.Row`-s. During each
+                page, the iterator will have the ``total_rows`` attribute
+                set, which counts the total number of rows **in the table**
+                (this is distinct from the total number of rows in the
+                current page: ``iterator.page.num_items``).
+        """
+        table = _table_arg_to_table(table, default_project=self.project)
+
+        if not isinstance(table, Table):
+            raise TypeError(_NEED_TABLE_ARGUMENT)
+
+        schema = table.schema
+
+        # selected_fields can override the table schema.
+        if selected_fields is not None:
+            schema = selected_fields
+
+        # No schema, but no selected_fields. Assume the developer wants all
+        # columns, so get the table resource for them rather than failing.
+        elif len(schema) == 0:
+            table = self.get_table(table.reference, retry=retry)
+            schema = table.schema
+
+        params = {}
+        if selected_fields is not None:
+            params["selectedFields"] = ",".join(field.name for field in selected_fields)
+        if start_index is not None:
+            params["startIndex"] = start_index
+
+        row_iterator = RowIterator(
+            client=self,
+            api_request=functools.partial(self._call_api, retry),
+            path="%s/data" % (table.path,),
+            schema=schema,
+            page_token=page_token,
+            max_results=max_results,
+            page_size=page_size,
+            extra_params=params,
+            table=table,
+            # Pass in selected_fields separately from schema so that full
+            # tables can be fetched without a column filter.
+            selected_fields=selected_fields,
+        )
+        return row_iterator
+
+    def _schema_from_json_file_object(self, file_obj):
+        """Helper function for schema_from_json that takes a
+       file object that describes a table schema.
+
+       Returns:
+            List of schema field objects.
+        """
+        json_data = json.load(file_obj)
+        return [SchemaField.from_api_repr(field) for field in json_data]
+
+    def _schema_to_json_file_object(self, schema_list, file_obj):
+        """Helper function for schema_to_json that takes a schema list and file
+        object and writes the schema list to the file object with json.dump
+        """
+        json.dump(schema_list, file_obj, indent=2, sort_keys=True)
+
+    def schema_from_json(self, file_or_path):
+        """Takes a file object or file path that contains json that describes
+        a table schema.
+
+        Returns:
+            List of schema field objects.
+        """
+        if isinstance(file_or_path, io.IOBase):
+            return self._schema_from_json_file_object(file_or_path)
+
+        with open(file_or_path) as file_obj:
+            return self._schema_from_json_file_object(file_obj)
+
+    def schema_to_json(self, schema_list, destination):
+        """Takes a list of schema field objects.
+
+        Serializes the list of schema field objects as json to a file.
+
+        Destination is a file path or a file object.
+        """
+        json_schema_list = [f.to_api_repr() for f in schema_list]
+
+        if isinstance(destination, io.IOBase):
+            return self._schema_to_json_file_object(json_schema_list, destination)
+
+        with open(destination, mode="w") as file_obj:
+            return self._schema_to_json_file_object(json_schema_list, file_obj)
+
+
+# pylint: disable=unused-argument
+def _item_to_project(iterator, resource):
+    """Convert a JSON project to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: An item to be converted to a project.
+
+    :rtype: :class:`.Project`
+    :returns: The next project in the page.
+    """
+    return Project.from_api_repr(resource)
+
+
+# pylint: enable=unused-argument
+
+
+def _item_to_dataset(iterator, resource):
+    """Convert a JSON dataset to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: An item to be converted to a dataset.
+
+    :rtype: :class:`.DatasetListItem`
+    :returns: The next dataset in the page.
+    """
+    return DatasetListItem(resource)
+
+
+def _item_to_job(iterator, resource):
+    """Convert a JSON job to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: An item to be converted to a job.
+
+    :rtype: job instance.
+    :returns: The next job in the page.
+    """
+    return iterator.client.job_from_resource(resource)
+
+
+def _item_to_model(iterator, resource):
+    """Convert a JSON model to the native object.
+
+    Args:
+        iterator (google.api_core.page_iterator.Iterator):
+            The iterator that is currently in use.
+        resource (dict):
+            An item to be converted to a model.
+
+    Returns:
+        google.cloud.bigquery.model.Model: The next model in the page.
+    """
+    return Model.from_api_repr(resource)
+
+
+def _item_to_routine(iterator, resource):
+    """Convert a JSON model to the native object.
+
+    Args:
+        iterator (google.api_core.page_iterator.Iterator):
+            The iterator that is currently in use.
+        resource (dict):
+            An item to be converted to a routine.
+
+    Returns:
+        google.cloud.bigquery.routine.Routine: The next routine in the page.
+    """
+    return Routine.from_api_repr(resource)
+
+
+def _item_to_table(iterator, resource):
+    """Convert a JSON table to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: An item to be converted to a table.
+
+    :rtype: :class:`~google.cloud.bigquery.table.Table`
+    :returns: The next table in the page.
+    """
+    return TableListItem(resource)
+
+
+def _make_job_id(job_id, prefix=None):
+    """Construct an ID for a new job.
+
+    :type job_id: str or ``NoneType``
+    :param job_id: the user-provided job ID
+
+    :type prefix: str or ``NoneType``
+    :param prefix: (Optional) the user-provided prefix for a job ID
+
+    :rtype: str
+    :returns: A job ID
+    """
+    if job_id is not None:
+        return job_id
+    elif prefix is not None:
+        return str(prefix) + str(uuid.uuid4())
+    else:
+        return str(uuid.uuid4())
+
+
+def _check_mode(stream):
+    """Check that a stream was opened in read-binary mode.
+
+    :type stream: IO[bytes]
+    :param stream: A bytes IO object open for reading.
+
+    :raises: :exc:`ValueError` if the ``stream.mode`` is a valid attribute
+             and is not among ``rb``, ``r+b`` or ``rb+``.
+    """
+    mode = getattr(stream, "mode", None)
+
+    if isinstance(stream, gzip.GzipFile):
+        if mode != gzip.READ:
+            raise ValueError(
+                "Cannot upload gzip files opened in write mode:  use "
+                "gzip.GzipFile(filename, mode='rb')"
+            )
+    else:
+        if mode is not None and mode not in ("rb", "r+b", "rb+"):
+            raise ValueError(
+                "Cannot upload files opened in text mode:  use "
+                "open(filename, mode='rb') or open(filename, mode='r+b')"
+            )
+
+
+def _get_upload_headers(user_agent):
+    """Get the headers for an upload request.
+
+    :type user_agent: str
+    :param user_agent: The user-agent for requests.
+
+    :rtype: dict
+    :returns: The headers to be used for the request.
+    """
+    return {
+        "Accept": "application/json",
+        "Accept-Encoding": "gzip, deflate",
+        "User-Agent": user_agent,
+        "content-type": "application/json",
+    }
diff --git a/bigquery/google/cloud/bigquery/dataset.py b/bigquery/google/cloud/bigquery/dataset.py
new file mode 100644
index 000000000000..494c219d4f67
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dataset.py
@@ -0,0 +1,715 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define API Datasets."""
+
+from __future__ import absolute_import
+
+import six
+import copy
+import re
+
+import google.cloud._helpers
+from google.cloud.bigquery import _helpers
+from google.cloud.bigquery.model import ModelReference
+from google.cloud.bigquery.routine import RoutineReference
+from google.cloud.bigquery.table import TableReference
+
+
+_PROJECT_PREFIX_PATTERN = re.compile(
+    r"""
+    (?P<project_id>\S+\:[^.]+)\.(?P<dataset_id>[^.]+)$
+""",
+    re.VERBOSE,
+)
+
+
+def _get_table_reference(self, table_id):
+    """Constructs a TableReference.
+
+    Args:
+        table_id (str): The ID of the table.
+
+    Returns:
+        google.cloud.bigquery.table.TableReference:
+            A table reference for a table in this dataset.
+    """
+    return TableReference(self, table_id)
+
+
+def _get_model_reference(self, model_id):
+    """Constructs a ModelReference.
+
+    Args:
+        model_id (str): the ID of the model.
+
+    Returns:
+        google.cloud.bigquery.model.ModelReference:
+            A ModelReference for a model in this dataset.
+    """
+    return ModelReference.from_api_repr(
+        {"projectId": self.project, "datasetId": self.dataset_id, "modelId": model_id}
+    )
+
+
+def _get_routine_reference(self, routine_id):
+    """Constructs a RoutineReference.
+
+    Args:
+        routine_id (str): the ID of the routine.
+
+    Returns:
+        google.cloud.bigquery.routine.RoutineReference:
+            A RoutineReference for a routine in this dataset.
+    """
+    return RoutineReference.from_api_repr(
+        {
+            "projectId": self.project,
+            "datasetId": self.dataset_id,
+            "routineId": routine_id,
+        }
+    )
+
+
+class AccessEntry(object):
+    """Represents grant of an access role to an entity.
+
+    An entry must have exactly one of the allowed :attr:`ENTITY_TYPES`. If
+    anything but ``view`` is set, a ``role`` is also required. ``role`` is
+    omitted for a ``view``, because ``view`` s are always read-only.
+
+    See https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets.
+
+    Attributes:
+        role (str):
+            Role granted to the entity. The following string values are
+            supported: `'READER'`, `'WRITER'`, `'OWNER'`. It may also be
+            :data:`None` if the ``entity_type`` is ``view``.
+
+        entity_type (str):
+            Type of entity being granted the role. One of :attr:`ENTITY_TYPES`.
+
+        entity_id (Union[str, Dict[str, str]]):
+            If the ``entity_type`` is not 'view', the ``entity_id`` is the
+            ``str`` ID of the entity being granted the role. If the
+            ``entity_type`` is 'view', the ``entity_id`` is a ``dict``
+            representing the view from a different dataset to grant access to
+            in the following format::
+
+                {
+                    'projectId': string,
+                    'datasetId': string,
+                    'tableId': string
+                }
+
+    Raises:
+        ValueError:
+            If the ``entity_type`` is not among :attr:`ENTITY_TYPES`, or if a
+            ``view`` has ``role`` set, or a non ``view`` **does not** have a
+            ``role`` set.
+
+    Examples:
+        >>> entry = AccessEntry('OWNER', 'userByEmail', 'user@example.com')
+
+        >>> view = {
+        ...     'projectId': 'my-project',
+        ...     'datasetId': 'my_dataset',
+        ...     'tableId': 'my_table'
+        ... }
+        >>> entry = AccessEntry(None, 'view', view)
+    """
+
+    ENTITY_TYPES = frozenset(
+        ["userByEmail", "groupByEmail", "domain", "specialGroup", "view"]
+    )
+    """Allowed entity types."""
+
+    def __init__(self, role, entity_type, entity_id):
+        if entity_type not in self.ENTITY_TYPES:
+            message = "Entity type %r not among: %s" % (
+                entity_type,
+                ", ".join(self.ENTITY_TYPES),
+            )
+            raise ValueError(message)
+        if entity_type == "view":
+            if role is not None:
+                raise ValueError(
+                    "Role must be None for a view. Received " "role: %r" % (role,)
+                )
+        else:
+            if role is None:
+                raise ValueError(
+                    "Role must be set for entity " "type %r" % (entity_type,)
+                )
+
+        self.role = role
+        self.entity_type = entity_type
+        self.entity_id = entity_id
+
+    def __eq__(self, other):
+        if not isinstance(other, AccessEntry):
+            return NotImplemented
+        return (
+            self.role == other.role
+            and self.entity_type == other.entity_type
+            and self.entity_id == other.entity_id
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        return "<AccessEntry: role=%s, %s=%s>" % (
+            self.role,
+            self.entity_type,
+            self.entity_id,
+        )
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this access entry
+
+        Returns:
+            Dict[str, object]: Access entry represented as an API resource
+        """
+        resource = {self.entity_type: self.entity_id}
+        if self.role is not None:
+            resource["role"] = self.role
+        return resource
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct an access entry given its API representation
+
+        Args:
+            resource (Dict[str, object]):
+                Access entry resource representation returned from the API
+
+        Returns:
+            google.cloud.bigquery.dataset.AccessEntry:
+                Access entry parsed from ``resource``.
+
+        Raises:
+            ValueError:
+                If the resource has more keys than ``role`` and one additional
+                key.
+        """
+        entry = resource.copy()
+        role = entry.pop("role", None)
+        entity_type, entity_id = entry.popitem()
+        if len(entry) != 0:
+            raise ValueError("Entry has unexpected keys remaining.", entry)
+        return cls(role, entity_type, entity_id)
+
+
+class DatasetReference(object):
+    """DatasetReferences are pointers to datasets.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets
+
+    Args:
+        project (str): The ID of the project
+        dataset_id (str): The ID of the dataset
+
+    Raises:
+        ValueError: If either argument is not of type ``str``.
+    """
+
+    def __init__(self, project, dataset_id):
+        if not isinstance(project, six.string_types):
+            raise ValueError("Pass a string for project")
+        if not isinstance(dataset_id, six.string_types):
+            raise ValueError("Pass a string for dataset_id")
+        self._project = project
+        self._dataset_id = dataset_id
+
+    @property
+    def project(self):
+        """str: Project ID of the dataset."""
+        return self._project
+
+    @property
+    def dataset_id(self):
+        """str: Dataset ID."""
+        return self._dataset_id
+
+    @property
+    def path(self):
+        """str: URL path for the dataset based on project and dataset ID."""
+        return "/projects/%s/datasets/%s" % (self.project, self.dataset_id)
+
+    table = _get_table_reference
+
+    model = _get_model_reference
+
+    routine = _get_routine_reference
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a dataset reference given its API representation
+
+        Args:
+            resource (Dict[str, str]):
+                Dataset reference resource representation returned from the API
+
+        Returns:
+            google.cloud.bigquery.dataset.DatasetReference:
+                Dataset reference parsed from ``resource``.
+        """
+        project = resource["projectId"]
+        dataset_id = resource["datasetId"]
+        return cls(project, dataset_id)
+
+    @classmethod
+    def from_string(cls, dataset_id, default_project=None):
+        """Construct a dataset reference from dataset ID string.
+
+        Args:
+            dataset_id (str):
+                A dataset ID in standard SQL format. If ``default_project``
+                is not specified, this must include both the project ID and
+                the dataset ID, separated by ``.``.
+            default_project (str):
+                Optional. The project ID to use when ``dataset_id`` does not
+                include a project ID.
+
+        Returns:
+            DatasetReference:
+                Dataset reference parsed from ``dataset_id``.
+
+        Examples:
+            >>> DatasetReference.from_string('my-project-id.some_dataset')
+            DatasetReference('my-project-id', 'some_dataset')
+
+        Raises:
+            ValueError:
+                If ``dataset_id`` is not a fully-qualified dataset ID in
+                standard SQL format.
+        """
+        output_dataset_id = dataset_id
+        output_project_id = default_project
+        with_prefix = _PROJECT_PREFIX_PATTERN.match(dataset_id)
+        if with_prefix is None:
+            parts = dataset_id.split(".")
+        else:
+            project_id = with_prefix.group("project_id")
+            dataset_id = with_prefix.group("dataset_id")
+            parts = [project_id, dataset_id]
+
+        if len(parts) == 1 and not default_project:
+            raise ValueError(
+                "When default_project is not set, dataset_id must be a "
+                "fully-qualified dataset ID in standard SQL format, "
+                'e.g., "project.dataset_id" got {}'.format(dataset_id)
+            )
+        elif len(parts) == 2:
+            output_project_id, output_dataset_id = parts
+        elif len(parts) > 2:
+            raise ValueError(
+                "Too many parts in dataset_id. Expected a fully-qualified "
+                "dataset ID in standard SQL format. e.g. "
+                '"project.dataset_id", got {}'.format(dataset_id)
+            )
+
+        return cls(output_project_id, output_dataset_id)
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this dataset reference
+
+        Returns:
+            Dict[str, str]: dataset reference represented as an API resource
+        """
+        return {"projectId": self._project, "datasetId": self._dataset_id}
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            Tuple[str]: The contents of this :class:`.DatasetReference`.
+        """
+        return (self._project, self._dataset_id)
+
+    def __eq__(self, other):
+        if not isinstance(other, DatasetReference):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __repr__(self):
+        return "DatasetReference{}".format(self._key())
+
+
+class Dataset(object):
+    """Datasets are containers for tables.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets
+
+    Args:
+        dataset_ref (Union[ \
+            :class:`~google.cloud.bigquery.dataset.DatasetReference`, \
+            str, \
+        ]):
+            A pointer to a dataset. If ``dataset_ref`` is a string, it must
+            include both the project ID and the dataset ID, separated by
+            ``.``.
+    """
+
+    _PROPERTY_TO_API_FIELD = {
+        "access_entries": "access",
+        "created": "creationTime",
+        "default_table_expiration_ms": "defaultTableExpirationMs",
+        "friendly_name": "friendlyName",
+    }
+
+    def __init__(self, dataset_ref):
+        if isinstance(dataset_ref, six.string_types):
+            dataset_ref = DatasetReference.from_string(dataset_ref)
+        self._properties = {"datasetReference": dataset_ref.to_api_repr(), "labels": {}}
+
+    @property
+    def project(self):
+        """str: Project ID of the project bound to the dataset."""
+        return self._properties["datasetReference"]["projectId"]
+
+    @property
+    def path(self):
+        """str: URL path for the dataset based on project and dataset ID."""
+        return "/projects/%s/datasets/%s" % (self.project, self.dataset_id)
+
+    @property
+    def access_entries(self):
+        """List[google.cloud.bigquery.dataset.AccessEntry]: Dataset's access
+        entries.
+
+        ``role`` augments the entity type and must be present **unless** the
+        entity type is ``view``.
+
+        Raises:
+            TypeError: If 'value' is not a sequence
+            ValueError:
+                If any item in the sequence is not an
+                :class:`~google.cloud.bigquery.dataset.AccessEntry`.
+        """
+        entries = self._properties.get("access", [])
+        return [AccessEntry.from_api_repr(entry) for entry in entries]
+
+    @access_entries.setter
+    def access_entries(self, value):
+        if not all(isinstance(field, AccessEntry) for field in value):
+            raise ValueError("Values must be AccessEntry instances")
+        entries = [entry.to_api_repr() for entry in value]
+        self._properties["access"] = entries
+
+    @property
+    def created(self):
+        """Union[datetime.datetime, None]: Datetime at which the dataset was
+        created (:data:`None` until set from the server).
+        """
+        creation_time = self._properties.get("creationTime")
+        if creation_time is not None:
+            # creation_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(creation_time)
+            )
+
+    @property
+    def dataset_id(self):
+        """str: Dataset ID."""
+        return self._properties["datasetReference"]["datasetId"]
+
+    @property
+    def full_dataset_id(self):
+        """Union[str, None]: ID for the dataset resource (:data:`None` until
+        set from the server)
+
+        In the format ``project_id:dataset_id``.
+        """
+        return self._properties.get("id")
+
+    @property
+    def reference(self):
+        """google.cloud.bigquery.dataset.DatasetReference: A reference to this
+        dataset.
+        """
+        return DatasetReference(self.project, self.dataset_id)
+
+    @property
+    def etag(self):
+        """Union[str, None]: ETag for the dataset resource (:data:`None` until
+        set from the server).
+        """
+        return self._properties.get("etag")
+
+    @property
+    def modified(self):
+        """Union[datetime.datetime, None]: Datetime at which the dataset was
+        last modified (:data:`None` until set from the server).
+        """
+        modified_time = self._properties.get("lastModifiedTime")
+        if modified_time is not None:
+            # modified_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(modified_time)
+            )
+
+    @property
+    def self_link(self):
+        """Union[str, None]: URL for the dataset resource (:data:`None` until
+        set from the server).
+        """
+        return self._properties.get("selfLink")
+
+    @property
+    def default_table_expiration_ms(self):
+        """Union[int, None]: Default expiration time for tables in the dataset
+        (defaults to :data:`None`).
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        return _helpers._int_or_none(self._properties.get("defaultTableExpirationMs"))
+
+    @default_table_expiration_ms.setter
+    def default_table_expiration_ms(self, value):
+        if not isinstance(value, six.integer_types) and value is not None:
+            raise ValueError("Pass an integer, or None")
+        self._properties["defaultTableExpirationMs"] = _helpers._str_or_none(value)
+
+    @property
+    def description(self):
+        """Union[str, None]: Description of the dataset as set by the user
+        (defaults to :data:`None`).
+
+        Raises:
+            ValueError: for invalid value types.
+        """
+        return self._properties.get("description")
+
+    @description.setter
+    def description(self, value):
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["description"] = value
+
+    @property
+    def friendly_name(self):
+        """Union[str, None]: Title of the dataset as set by the user
+        (defaults to :data:`None`).
+
+        Raises:
+            ValueError: for invalid value types.
+        """
+        return self._properties.get("friendlyName")
+
+    @friendly_name.setter
+    def friendly_name(self, value):
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["friendlyName"] = value
+
+    @property
+    def location(self):
+        """Union[str, None]: Location in which the dataset is hosted as set by
+        the user (defaults to :data:`None`).
+
+        Raises:
+            ValueError: for invalid value types.
+        """
+        return self._properties.get("location")
+
+    @location.setter
+    def location(self, value):
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["location"] = value
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the dataset.
+
+        This method always returns a dict. To change a dataset's labels,
+        modify the dict, then call
+        :meth:`google.cloud.bigquery.client.Client.update_dataset`. To delete
+        a label, set its value to :data:`None` before updating.
+
+        Raises:
+            ValueError: for invalid value types.
+        """
+        return self._properties.setdefault("labels", {})
+
+    @labels.setter
+    def labels(self, value):
+        if not isinstance(value, dict):
+            raise ValueError("Pass a dict")
+        self._properties["labels"] = value
+
+    @classmethod
+    def from_string(cls, full_dataset_id):
+        """Construct a dataset from fully-qualified dataset ID.
+
+        Args:
+            full_dataset_id (str):
+                A fully-qualified dataset ID in standard SQL format. Must
+                include both the project ID and the dataset ID, separated by
+                ``.``.
+
+        Returns:
+            Dataset: Dataset parsed from ``full_dataset_id``.
+
+        Examples:
+            >>> Dataset.from_string('my-project-id.some_dataset')
+            Dataset(DatasetReference('my-project-id', 'some_dataset'))
+
+        Raises:
+            ValueError:
+                If ``full_dataset_id`` is not a fully-qualified dataset ID in
+                standard SQL format.
+        """
+        return cls(DatasetReference.from_string(full_dataset_id))
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a dataset given its API representation
+
+        Args:
+            resource (Dict[str: object]):
+                Dataset resource representation returned from the API
+
+        Returns:
+            google.cloud.bigquery.dataset.Dataset:
+                Dataset parsed from ``resource``.
+        """
+        if (
+            "datasetReference" not in resource
+            or "datasetId" not in resource["datasetReference"]
+        ):
+            raise KeyError(
+                "Resource lacks required identity information:"
+                '["datasetReference"]["datasetId"]'
+            )
+        project_id = resource["datasetReference"]["projectId"]
+        dataset_id = resource["datasetReference"]["datasetId"]
+        dataset = cls(DatasetReference(project_id, dataset_id))
+        dataset._properties = copy.deepcopy(resource)
+        return dataset
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this dataset
+
+        Returns:
+            Dict[str, object]: The dataset represented as an API resource
+        """
+        return copy.deepcopy(self._properties)
+
+    def _build_resource(self, filter_fields):
+        """Generate a resource for ``update``."""
+        return _helpers._build_resource_from_properties(self, filter_fields)
+
+    table = _get_table_reference
+
+    model = _get_model_reference
+
+    routine = _get_routine_reference
+
+    def __repr__(self):
+        return "Dataset({})".format(repr(self.reference))
+
+
+class DatasetListItem(object):
+    """A read-only dataset resource from a list operation.
+
+    For performance reasons, the BigQuery API only includes some of the
+    dataset properties when listing datasets. Notably,
+    :attr:`~google.cloud.bigquery.dataset.Dataset.access_entries` is missing.
+
+    For a full list of the properties that the BigQuery API returns, see the
+    `REST documentation for datasets.list
+    <https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/list>`_.
+
+
+    Args:
+        resource (Dict[str, str]):
+            A dataset-like resource object from a dataset list response. A
+            ``datasetReference`` property is required.
+
+    Raises:
+        ValueError:
+            If ``datasetReference`` or one of its required members is missing
+            from ``resource``.
+    """
+
+    def __init__(self, resource):
+        if "datasetReference" not in resource:
+            raise ValueError("resource must contain a datasetReference value")
+        if "projectId" not in resource["datasetReference"]:
+            raise ValueError(
+                "resource['datasetReference'] must contain a projectId value"
+            )
+        if "datasetId" not in resource["datasetReference"]:
+            raise ValueError(
+                "resource['datasetReference'] must contain a datasetId value"
+            )
+        self._properties = resource
+
+    @property
+    def project(self):
+        """str: Project bound to the dataset."""
+        return self._properties["datasetReference"]["projectId"]
+
+    @property
+    def dataset_id(self):
+        """str: Dataset ID."""
+        return self._properties["datasetReference"]["datasetId"]
+
+    @property
+    def full_dataset_id(self):
+        """Union[str, None]: ID for the dataset resource (:data:`None` until
+        set from the server)
+
+        In the format ``project_id:dataset_id``.
+        """
+        return self._properties.get("id")
+
+    @property
+    def friendly_name(self):
+        """Union[str, None]: Title of the dataset as set by the user
+        (defaults to :data:`None`).
+        """
+        return self._properties.get("friendlyName")
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the dataset."""
+        return self._properties.setdefault("labels", {})
+
+    @property
+    def reference(self):
+        """google.cloud.bigquery.dataset.DatasetReference: A reference to this
+        dataset.
+        """
+        return DatasetReference(self.project, self.dataset_id)
+
+    table = _get_table_reference
+
+    model = _get_model_reference
+
+    routine = _get_routine_reference
diff --git a/bigquery/google/cloud/bigquery/dbapi/__init__.py b/bigquery/google/cloud/bigquery/dbapi/__init__.py
new file mode 100644
index 000000000000..d1a723949b10
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dbapi/__init__.py
@@ -0,0 +1,87 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+"""Google BigQuery implementation of the Database API Specification v2.0.
+
+This module implements the `Python Database API Specification v2.0 (DB-API)`_
+for Google BigQuery.
+
+.. _Python Database API Specification v2.0 (DB-API):
+   https://www.python.org/dev/peps/pep-0249/
+"""
+
+from google.cloud.bigquery.dbapi.connection import connect
+from google.cloud.bigquery.dbapi.connection import Connection
+from google.cloud.bigquery.dbapi.cursor import Cursor
+from google.cloud.bigquery.dbapi.exceptions import Warning
+from google.cloud.bigquery.dbapi.exceptions import Error
+from google.cloud.bigquery.dbapi.exceptions import InterfaceError
+from google.cloud.bigquery.dbapi.exceptions import DatabaseError
+from google.cloud.bigquery.dbapi.exceptions import DataError
+from google.cloud.bigquery.dbapi.exceptions import OperationalError
+from google.cloud.bigquery.dbapi.exceptions import IntegrityError
+from google.cloud.bigquery.dbapi.exceptions import InternalError
+from google.cloud.bigquery.dbapi.exceptions import ProgrammingError
+from google.cloud.bigquery.dbapi.exceptions import NotSupportedError
+from google.cloud.bigquery.dbapi.types import Binary
+from google.cloud.bigquery.dbapi.types import Date
+from google.cloud.bigquery.dbapi.types import DateFromTicks
+from google.cloud.bigquery.dbapi.types import Time
+from google.cloud.bigquery.dbapi.types import TimeFromTicks
+from google.cloud.bigquery.dbapi.types import Timestamp
+from google.cloud.bigquery.dbapi.types import TimestampFromTicks
+from google.cloud.bigquery.dbapi.types import BINARY
+from google.cloud.bigquery.dbapi.types import DATETIME
+from google.cloud.bigquery.dbapi.types import NUMBER
+from google.cloud.bigquery.dbapi.types import ROWID
+from google.cloud.bigquery.dbapi.types import STRING
+
+
+apilevel = "2.0"
+
+# Threads may share the module and connections, but not cursors.
+threadsafety = 2
+
+paramstyle = "pyformat"
+
+__all__ = [
+    "apilevel",
+    "threadsafety",
+    "paramstyle",
+    "connect",
+    "Connection",
+    "Cursor",
+    "Warning",
+    "Error",
+    "InterfaceError",
+    "DatabaseError",
+    "DataError",
+    "OperationalError",
+    "IntegrityError",
+    "InternalError",
+    "ProgrammingError",
+    "NotSupportedError",
+    "Binary",
+    "Date",
+    "DateFromTicks",
+    "Time",
+    "TimeFromTicks",
+    "Timestamp",
+    "TimestampFromTicks",
+    "BINARY",
+    "DATETIME",
+    "NUMBER",
+    "ROWID",
+    "STRING",
+]
diff --git a/bigquery/google/cloud/bigquery/dbapi/_helpers.py b/bigquery/google/cloud/bigquery/dbapi/_helpers.py
new file mode 100644
index 000000000000..6e7f58bd4944
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dbapi/_helpers.py
@@ -0,0 +1,117 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+
+import datetime
+import decimal
+import numbers
+
+import six
+
+from google.cloud import bigquery
+from google.cloud.bigquery.dbapi import exceptions
+
+
+def scalar_to_query_parameter(value, name=None):
+    """Convert a scalar value into a query parameter.
+
+    :type value: any
+    :param value: A scalar value to convert into a query parameter.
+
+    :type name: str
+    :param name: (Optional) Name of the query parameter.
+
+    :rtype: :class:`~google.cloud.bigquery.ScalarQueryParameter`
+    :returns:
+        A query parameter corresponding with the type and value of the plain
+        Python object.
+    :raises: :class:`~google.cloud.bigquery.dbapi.exceptions.ProgrammingError`
+        if the type cannot be determined.
+    """
+    parameter_type = None
+
+    if isinstance(value, bool):
+        parameter_type = "BOOL"
+    elif isinstance(value, numbers.Integral):
+        parameter_type = "INT64"
+    elif isinstance(value, numbers.Real):
+        parameter_type = "FLOAT64"
+    elif isinstance(value, decimal.Decimal):
+        parameter_type = "NUMERIC"
+    elif isinstance(value, six.text_type):
+        parameter_type = "STRING"
+    elif isinstance(value, six.binary_type):
+        parameter_type = "BYTES"
+    elif isinstance(value, datetime.datetime):
+        parameter_type = "DATETIME" if value.tzinfo is None else "TIMESTAMP"
+    elif isinstance(value, datetime.date):
+        parameter_type = "DATE"
+    elif isinstance(value, datetime.time):
+        parameter_type = "TIME"
+    else:
+        raise exceptions.ProgrammingError(
+            "encountered parameter {} with value {} of unexpected type".format(
+                name, value
+            )
+        )
+    return bigquery.ScalarQueryParameter(name, parameter_type, value)
+
+
+def to_query_parameters_list(parameters):
+    """Converts a sequence of parameter values into query parameters.
+
+    :type parameters: Sequence[Any]
+    :param parameters: Sequence of query parameter values.
+
+    :rtype: List[google.cloud.bigquery.query._AbstractQueryParameter]
+    :returns: A list of query parameters.
+    """
+    return [scalar_to_query_parameter(value) for value in parameters]
+
+
+def to_query_parameters_dict(parameters):
+    """Converts a dictionary of parameter values into query parameters.
+
+    :type parameters: Mapping[str, Any]
+    :param parameters: Dictionary of query parameter values.
+
+    :rtype: List[google.cloud.bigquery.query._AbstractQueryParameter]
+    :returns: A list of named query parameters.
+    """
+    return [
+        scalar_to_query_parameter(value, name=name)
+        for name, value in six.iteritems(parameters)
+    ]
+
+
+def to_query_parameters(parameters):
+    """Converts DB-API parameter values into query parameters.
+
+    :type parameters: Mapping[str, Any] or Sequence[Any]
+    :param parameters: A dictionary or sequence of query parameter values.
+
+    :rtype: List[google.cloud.bigquery.query._AbstractQueryParameter]
+    :returns: A list of query parameters.
+    """
+    if parameters is None:
+        return []
+
+    if isinstance(parameters, collections_abc.Mapping):
+        return to_query_parameters_dict(parameters)
+
+    return to_query_parameters_list(parameters)
diff --git a/bigquery/google/cloud/bigquery/dbapi/connection.py b/bigquery/google/cloud/bigquery/dbapi/connection.py
new file mode 100644
index 000000000000..0dbc9143b255
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dbapi/connection.py
@@ -0,0 +1,59 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+"""Connection for the Google BigQuery DB-API."""
+
+from google.cloud import bigquery
+from google.cloud.bigquery.dbapi import cursor
+
+
+class Connection(object):
+    """DB-API Connection to Google BigQuery.
+
+    :type client: :class:`~google.cloud.bigquery.Client`
+    :param client: A client used to connect to BigQuery.
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def close(self):
+        """No-op."""
+
+    def commit(self):
+        """No-op."""
+
+    def cursor(self):
+        """Return a new cursor object.
+
+        :rtype: :class:`~google.cloud.bigquery.dbapi.Cursor`
+        :returns: A DB-API cursor that uses this connection.
+        """
+        return cursor.Cursor(self)
+
+
+def connect(client=None):
+    """Construct a DB-API connection to Google BigQuery.
+
+    :type client: :class:`~google.cloud.bigquery.Client`
+    :param client:
+        (Optional) A client used to connect to BigQuery. If not passed, a
+        client is created using default options inferred from the environment.
+
+    :rtype: :class:`~google.cloud.bigquery.dbapi.Connection`
+    :returns: A new DB-API connection to BigQuery.
+    """
+    if client is None:
+        client = bigquery.Client()
+    return Connection(client)
diff --git a/bigquery/google/cloud/bigquery/dbapi/cursor.py b/bigquery/google/cloud/bigquery/dbapi/cursor.py
new file mode 100644
index 000000000000..1fbd9fb10cc4
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dbapi/cursor.py
@@ -0,0 +1,358 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+"""Cursor for the Google BigQuery DB-API."""
+
+import collections
+
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+
+import six
+
+from google.cloud.bigquery import job
+from google.cloud.bigquery.dbapi import _helpers
+from google.cloud.bigquery.dbapi import exceptions
+import google.cloud.exceptions
+
+# Per PEP 249: A 7-item sequence containing information describing one result
+# column. The first two items (name and type_code) are mandatory, the other
+# five are optional and are set to None if no meaningful values can be
+# provided.
+Column = collections.namedtuple(
+    "Column",
+    [
+        "name",
+        "type_code",
+        "display_size",
+        "internal_size",
+        "precision",
+        "scale",
+        "null_ok",
+    ],
+)
+
+
+class Cursor(object):
+    """DB-API Cursor to Google BigQuery.
+
+    :type connection: :class:`~google.cloud.bigquery.dbapi.Connection`
+    :param connection: A DB-API connection to Google BigQuery.
+    """
+
+    def __init__(self, connection):
+        self.connection = connection
+        self.description = None
+        # Per PEP 249: The attribute is -1 in case no .execute*() has been
+        # performed on the cursor or the rowcount of the last operation
+        # cannot be determined by the interface.
+        self.rowcount = -1
+        # Per PEP 249: The arraysize attribute defaults to 1, meaning to fetch
+        # a single row at a time.
+        self.arraysize = 1
+        self._query_data = None
+        self._query_job = None
+
+    def close(self):
+        """No-op."""
+
+    def _set_description(self, schema):
+        """Set description from schema.
+
+        :type schema: Sequence[google.cloud.bigquery.schema.SchemaField]
+        :param schema: A description of fields in the schema.
+        """
+        if schema is None:
+            self.description = None
+            return
+
+        self.description = tuple(
+            [
+                Column(
+                    name=field.name,
+                    type_code=field.field_type,
+                    display_size=None,
+                    internal_size=None,
+                    precision=None,
+                    scale=None,
+                    null_ok=field.is_nullable,
+                )
+                for field in schema
+            ]
+        )
+
+    def _set_rowcount(self, query_results):
+        """Set the rowcount from query results.
+
+        Normally, this sets rowcount to the number of rows returned by the
+        query, but if it was a DML statement, it sets rowcount to the number
+        of modified rows.
+
+        :type query_results:
+            :class:`~google.cloud.bigquery.query._QueryResults`
+        :param query_results: results of a query
+        """
+        total_rows = 0
+        num_dml_affected_rows = query_results.num_dml_affected_rows
+
+        if query_results.total_rows is not None and query_results.total_rows > 0:
+            total_rows = query_results.total_rows
+        if num_dml_affected_rows is not None and num_dml_affected_rows > 0:
+            total_rows = num_dml_affected_rows
+        self.rowcount = total_rows
+
+    def execute(self, operation, parameters=None, job_id=None):
+        """Prepare and execute a database operation.
+
+        .. note::
+            When setting query parameters, values which are "text"
+            (``unicode`` in Python2, ``str`` in Python3) will use
+            the 'STRING' BigQuery type. Values which are "bytes" (``str`` in
+            Python2, ``bytes`` in Python3), will use using the 'BYTES' type.
+
+            A `~datetime.datetime` parameter without timezone information uses
+            the 'DATETIME' BigQuery type (example: Global Pi Day Celebration
+            March 14, 2017 at 1:59pm). A `~datetime.datetime` parameter with
+            timezone information uses the 'TIMESTAMP' BigQuery type (example:
+            a wedding on April 29, 2011 at 11am, British Summer Time).
+
+            For more information about BigQuery data types, see:
+            https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types
+
+            ``STRUCT``/``RECORD`` and ``REPEATED`` query parameters are not
+            yet supported. See:
+            https://github.com/GoogleCloudPlatform/google-cloud-python/issues/3524
+
+        :type operation: str
+        :param operation: A Google BigQuery query string.
+
+        :type parameters: Mapping[str, Any] or Sequence[Any]
+        :param parameters:
+            (Optional) dictionary or sequence of parameter values.
+
+        :type job_id: str
+        :param job_id: (Optional) The job_id to use. If not set, a job ID
+            is generated at random.
+        """
+        self._query_data = None
+        self._query_job = None
+        client = self.connection._client
+
+        # The DB-API uses the pyformat formatting, since the way BigQuery does
+        # query parameters was not one of the standard options. Convert both
+        # the query and the parameters to the format expected by the client
+        # libraries.
+        formatted_operation = _format_operation(operation, parameters=parameters)
+        query_parameters = _helpers.to_query_parameters(parameters)
+
+        config = job.QueryJobConfig()
+        config.query_parameters = query_parameters
+        config.use_legacy_sql = False
+        self._query_job = client.query(
+            formatted_operation, job_config=config, job_id=job_id
+        )
+
+        # Wait for the query to finish.
+        try:
+            self._query_job.result()
+        except google.cloud.exceptions.GoogleCloudError as exc:
+            raise exceptions.DatabaseError(exc)
+
+        query_results = self._query_job._query_results
+        self._set_rowcount(query_results)
+        self._set_description(query_results.schema)
+
+    def executemany(self, operation, seq_of_parameters):
+        """Prepare and execute a database operation multiple times.
+
+        :type operation: str
+        :param operation: A Google BigQuery query string.
+
+        :type seq_of_parameters: Sequence[Mapping[str, Any] or Sequence[Any]]
+        :param parameters: Sequence of many sets of parameter values.
+        """
+        for parameters in seq_of_parameters:
+            self.execute(operation, parameters)
+
+    def _try_fetch(self, size=None):
+        """Try to start fetching data, if not yet started.
+
+        Mutates self to indicate that iteration has started.
+        """
+        if self._query_job is None:
+            raise exceptions.InterfaceError(
+                "No query results: execute() must be called before fetch."
+            )
+
+        is_dml = (
+            self._query_job.statement_type
+            and self._query_job.statement_type.upper() != "SELECT"
+        )
+        if is_dml:
+            self._query_data = iter([])
+            return
+
+        if self._query_data is None:
+            client = self.connection._client
+            rows_iter = client.list_rows(
+                self._query_job.destination,
+                selected_fields=self._query_job._query_results.schema,
+                page_size=self.arraysize,
+            )
+            self._query_data = iter(rows_iter)
+
+    def fetchone(self):
+        """Fetch a single row from the results of the last ``execute*()`` call.
+
+        :rtype: tuple
+        :returns:
+            A tuple representing a row or ``None`` if no more data is
+            available.
+        :raises: :class:`~google.cloud.bigquery.dbapi.InterfaceError`
+            if called before ``execute()``.
+        """
+        self._try_fetch()
+        try:
+            return six.next(self._query_data)
+        except StopIteration:
+            return None
+
+    def fetchmany(self, size=None):
+        """Fetch multiple results from the last ``execute*()`` call.
+
+        .. note::
+            The size parameter is not used for the request/response size.
+            Set the ``arraysize`` attribute before calling ``execute()`` to
+            set the batch size.
+
+        :type size: int
+        :param size:
+            (Optional) Maximum number of rows to return. Defaults to the
+            ``arraysize`` property value.
+
+        :rtype: List[tuple]
+        :returns: A list of rows.
+        :raises: :class:`~google.cloud.bigquery.dbapi.InterfaceError`
+            if called before ``execute()``.
+        """
+        if size is None:
+            size = self.arraysize
+
+        self._try_fetch(size=size)
+        rows = []
+
+        for row in self._query_data:
+            rows.append(row)
+            if len(rows) >= size:
+                break
+
+        return rows
+
+    def fetchall(self):
+        """Fetch all remaining results from the last ``execute*()`` call.
+
+        :rtype: List[tuple]
+        :returns: A list of all the rows in the results.
+        :raises: :class:`~google.cloud.bigquery.dbapi.InterfaceError`
+            if called before ``execute()``.
+        """
+        self._try_fetch()
+        return list(self._query_data)
+
+    def setinputsizes(self, sizes):
+        """No-op."""
+
+    def setoutputsize(self, size, column=None):
+        """No-op."""
+
+
+def _format_operation_list(operation, parameters):
+    """Formats parameters in operation in the way BigQuery expects.
+
+    The input operation will be a query like ``SELECT %s`` and the output
+    will be a query like ``SELECT ?``.
+
+    :type operation: str
+    :param operation: A Google BigQuery query string.
+
+    :type parameters: Sequence[Any]
+    :param parameters: Sequence of parameter values.
+
+    :rtype: str
+    :returns: A formatted query string.
+    :raises: :class:`~google.cloud.bigquery.dbapi.ProgrammingError`
+        if a parameter used in the operation is not found in the
+        ``parameters`` argument.
+    """
+    formatted_params = ["?" for _ in parameters]
+
+    try:
+        return operation % tuple(formatted_params)
+    except TypeError as exc:
+        raise exceptions.ProgrammingError(exc)
+
+
+def _format_operation_dict(operation, parameters):
+    """Formats parameters in operation in the way BigQuery expects.
+
+    The input operation will be a query like ``SELECT %(namedparam)s`` and
+    the output will be a query like ``SELECT @namedparam``.
+
+    :type operation: str
+    :param operation: A Google BigQuery query string.
+
+    :type parameters: Mapping[str, Any]
+    :param parameters: Dictionary of parameter values.
+
+    :rtype: str
+    :returns: A formatted query string.
+    :raises: :class:`~google.cloud.bigquery.dbapi.ProgrammingError`
+        if a parameter used in the operation is not found in the
+        ``parameters`` argument.
+    """
+    formatted_params = {}
+    for name in parameters:
+        escaped_name = name.replace("`", r"\`")
+        formatted_params[name] = "@`{}`".format(escaped_name)
+
+    try:
+        return operation % formatted_params
+    except KeyError as exc:
+        raise exceptions.ProgrammingError(exc)
+
+
+def _format_operation(operation, parameters=None):
+    """Formats parameters in operation in way BigQuery expects.
+
+    :type: str
+    :param operation: A Google BigQuery query string.
+
+    :type: Mapping[str, Any] or Sequence[Any]
+    :param parameters: Optional parameter values.
+
+    :rtype: str
+    :returns: A formatted query string.
+    :raises: :class:`~google.cloud.bigquery.dbapi.ProgrammingError`
+        if a parameter used in the operation is not found in the
+        ``parameters`` argument.
+    """
+    if parameters is None:
+        return operation
+
+    if isinstance(parameters, collections_abc.Mapping):
+        return _format_operation_dict(operation, parameters)
+
+    return _format_operation_list(operation, parameters)
diff --git a/bigquery/google/cloud/bigquery/dbapi/exceptions.py b/bigquery/google/cloud/bigquery/dbapi/exceptions.py
new file mode 100644
index 000000000000..37f7129d0618
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dbapi/exceptions.py
@@ -0,0 +1,58 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+"""Exceptions used in the Google BigQuery DB-API."""
+
+
+class Warning(Exception):
+    """Exception raised for important DB-API warnings."""
+
+
+class Error(Exception):
+    """Exception representing all non-warning DB-API errors."""
+
+
+class InterfaceError(Error):
+    """DB-API error related to the database interface."""
+
+
+class DatabaseError(Error):
+    """DB-API error related to the database."""
+
+
+class DataError(DatabaseError):
+    """DB-API error due to problems with the processed data."""
+
+
+class OperationalError(DatabaseError):
+    """DB-API error related to the database operation.
+
+    These errors are not necessarily under the control of the programmer.
+    """
+
+
+class IntegrityError(DatabaseError):
+    """DB-API error when integrity of the database is affected."""
+
+
+class InternalError(DatabaseError):
+    """DB-API error when the database encounters an internal error."""
+
+
+class ProgrammingError(DatabaseError):
+    """DB-API exception raised for programming errors."""
+
+
+class NotSupportedError(DatabaseError):
+    """DB-API error for operations not supported by the database or API."""
diff --git a/bigquery/google/cloud/bigquery/dbapi/types.py b/bigquery/google/cloud/bigquery/dbapi/types.py
new file mode 100644
index 000000000000..3c8c454a011a
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/dbapi/types.py
@@ -0,0 +1,85 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+"""Types used in the Google BigQuery DB-API.
+
+See `PEP-249`_ for details.
+
+.. _PEP-249:
+    https://www.python.org/dev/peps/pep-0249/#type-objects-and-constructors
+"""
+
+import datetime
+
+
+Date = datetime.date
+Time = datetime.time
+Timestamp = datetime.datetime
+DateFromTicks = datetime.date.fromtimestamp
+TimestampFromTicks = datetime.datetime.fromtimestamp
+
+
+def Binary(string):
+    """Contruct a DB-API binary value.
+
+    :type string: str
+    :param string: A string to encode as a binary value.
+
+    :rtype: bytes
+    :returns: The UTF-8 encoded bytes representing the string.
+    """
+    return string.encode("utf-8")
+
+
+def TimeFromTicks(ticks, tz=None):
+    """Construct a DB-API time value from the given ticks value.
+
+    :type ticks: float
+    :param ticks:
+        a number of seconds since the epoch; see the documentation of the
+        standard Python time module for details.
+
+    :type tz: :class:`datetime.tzinfo`
+    :param tz: (Optional) time zone to use for conversion
+
+    :rtype: :class:`datetime.time`
+    :returns: time represented by ticks.
+    """
+    dt = datetime.datetime.fromtimestamp(ticks, tz=tz)
+    return dt.timetz()
+
+
+class _DBAPITypeObject(object):
+    """DB-API type object which compares equal to many different strings.
+
+    See `PEP-249`_ for details.
+
+    .. _PEP-249:
+        https://www.python.org/dev/peps/pep-0249/#implementation-hints-for-module-authors
+    """
+
+    def __init__(self, *values):
+        self.values = values
+
+    def __eq__(self, other):
+        return other in self.values
+
+
+STRING = "STRING"
+BINARY = _DBAPITypeObject("BYTES", "RECORD", "STRUCT")
+NUMBER = _DBAPITypeObject(
+    "INTEGER", "INT64", "FLOAT", "FLOAT64", "NUMERIC", "BOOLEAN", "BOOL"
+)
+DATETIME = _DBAPITypeObject("TIMESTAMP", "DATE", "TIME", "DATETIME")
+ROWID = "ROWID"
diff --git a/bigquery/google/cloud/bigquery/enums.py b/bigquery/google/cloud/bigquery/enums.py
new file mode 100644
index 000000000000..29fe543f6505
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/enums.py
@@ -0,0 +1,92 @@
+# 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.
+
+import re
+
+import enum
+import six
+
+from google.cloud.bigquery_v2.gapic import enums as gapic_enums
+
+
+_SQL_SCALAR_TYPES = frozenset(
+    (
+        "INT64",
+        "BOOL",
+        "FLOAT64",
+        "STRING",
+        "BYTES",
+        "TIMESTAMP",
+        "DATE",
+        "TIME",
+        "DATETIME",
+        "GEOGRAPHY",
+        "NUMERIC",
+    )
+)
+
+_SQL_NONSCALAR_TYPES = frozenset(("TYPE_KIND_UNSPECIFIED", "ARRAY", "STRUCT"))
+
+
+def _make_sql_scalars_enum():
+    """Create an enum based on a gapic enum containing only SQL scalar types."""
+
+    new_enum = enum.Enum(
+        "StandardSqlDataTypes",
+        (
+            (member.name, member.value)
+            for member in gapic_enums.StandardSqlDataType.TypeKind
+            if member.name in _SQL_SCALAR_TYPES
+        ),
+    )
+
+    # make sure the docstring for the new enum is also correct
+    orig_doc = gapic_enums.StandardSqlDataType.TypeKind.__doc__
+    skip_pattern = re.compile(
+        "|".join(_SQL_NONSCALAR_TYPES)
+        + "|because a JSON object"  # the second description line of STRUCT member
+    )
+
+    new_doc = "\n".join(
+        six.moves.filterfalse(skip_pattern.search, orig_doc.splitlines())
+    )
+    new_enum.__doc__ = "An Enum of scalar SQL types.\n" + new_doc
+
+    return new_enum
+
+
+StandardSqlDataTypes = _make_sql_scalars_enum()
+
+
+# See also: https://cloud.google.com/bigquery/data-types#legacy_sql_data_types
+# and https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types
+class SqlTypeNames(str, enum.Enum):
+    """Enum of allowed SQL type names in schema.SchemaField."""
+
+    STRING = "STRING"
+    BYTES = "BYTES"
+    INTEGER = "INTEGER"
+    INT64 = "INTEGER"
+    FLOAT = "FLOAT"
+    FLOAT64 = "FLOAT"
+    NUMERIC = "NUMERIC"
+    BOOLEAN = "BOOLEAN"
+    BOOL = "BOOLEAN"
+    GEOGRAPHY = "GEOGRAPHY"  # NOTE: not available in legacy types
+    RECORD = "RECORD"
+    STRUCT = "RECORD"
+    TIMESTAMP = "TIMESTAMP"
+    DATE = "DATE"
+    TIME = "TIME"
+    DATETIME = "DATETIME"
diff --git a/bigquery/google/cloud/bigquery/external_config.py b/bigquery/google/cloud/bigquery/external_config.py
new file mode 100644
index 000000000000..048c2178a654
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/external_config.py
@@ -0,0 +1,718 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define classes that describe external data sources.
+
+   These are used for both Table.externalDataConfiguration and
+   Job.configuration.query.tableDefinitions.
+"""
+
+from __future__ import absolute_import
+
+import base64
+import copy
+
+from google.cloud.bigquery._helpers import _to_bytes
+from google.cloud.bigquery._helpers import _bytes_to_json
+from google.cloud.bigquery._helpers import _int_or_none
+from google.cloud.bigquery.schema import SchemaField
+
+
+class ExternalSourceFormat(object):
+    """The format for external data files.
+
+    Note that the set of allowed values for external data sources is different
+    than the set used for loading data (see
+    :class:`~google.cloud.bigquery.job.SourceFormat`).
+    """
+
+    CSV = "CSV"
+    """Specifies CSV format."""
+
+    GOOGLE_SHEETS = "GOOGLE_SHEETS"
+    """Specifies Google Sheets format."""
+
+    NEWLINE_DELIMITED_JSON = "NEWLINE_DELIMITED_JSON"
+    """Specifies newline delimited JSON format."""
+
+    AVRO = "AVRO"
+    """Specifies Avro format."""
+
+    DATASTORE_BACKUP = "DATASTORE_BACKUP"
+    """Specifies datastore backup format"""
+
+    BIGTABLE = "BIGTABLE"
+    """Specifies Bigtable format."""
+
+
+class BigtableColumn(object):
+    """Options for a Bigtable column."""
+
+    def __init__(self):
+        self._properties = {}
+
+    @property
+    def encoding(self):
+        """str: The encoding of the values when the type is not `STRING`
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.%28key%29.bigtableOptions.columnFamilies.columns.encoding
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns.encoding
+        """
+        return self._properties.get("encoding")
+
+    @encoding.setter
+    def encoding(self, value):
+        self._properties["encoding"] = value
+
+    @property
+    def field_name(self):
+        """str: An identifier to use if the qualifier is not a valid BigQuery
+        field identifier
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.%28key%29.bigtableOptions.columnFamilies.columns.fieldName
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns.fieldName
+        """
+        return self._properties.get("fieldName")
+
+    @field_name.setter
+    def field_name(self, value):
+        self._properties["fieldName"] = value
+
+    @property
+    def only_read_latest(self):
+        """bool: If this is set, only the latest version of value in this
+        column are exposed.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.%28key%29.bigtableOptions.columnFamilies.columns.onlyReadLatest
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns.onlyReadLatest
+        """
+        return self._properties.get("onlyReadLatest")
+
+    @only_read_latest.setter
+    def only_read_latest(self, value):
+        self._properties["onlyReadLatest"] = value
+
+    @property
+    def qualifier_encoded(self):
+        """Union[str, bytes]: The qualifier encoded in binary.
+
+        The type is ``str`` (Python 2.x) or ``bytes`` (Python 3.x). The module
+        will handle base64 encoding for you.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.%28key%29.bigtableOptions.columnFamilies.columns.qualifierEncoded
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns.qualifierEncoded
+        """
+        prop = self._properties.get("qualifierEncoded")
+        if prop is None:
+            return None
+        return base64.standard_b64decode(_to_bytes(prop))
+
+    @qualifier_encoded.setter
+    def qualifier_encoded(self, value):
+        self._properties["qualifierEncoded"] = _bytes_to_json(value)
+
+    @property
+    def qualifier_string(self):
+        """str: A valid UTF-8 string qualifier
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.%28key%29.bigtableOptions.columnFamilies.columns.qualifierEncoded
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns.qualifierEncoded
+        """
+        return self._properties.get("qualifierString")
+
+    @qualifier_string.setter
+    def qualifier_string(self, value):
+        self._properties["qualifierString"] = value
+
+    @property
+    def type_(self):
+        """str: The type to convert the value in cells of this column.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.%28key%29.bigtableOptions.columnFamilies.columns.type
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns.type
+        """
+        return self._properties.get("type")
+
+    @type_.setter
+    def type_(self, value):
+        self._properties["type"] = value
+
+    def to_api_repr(self):
+        """Build an API representation of this object.
+
+        Returns:
+            Dict[str, Any]:
+                A dictionary in the format used by the BigQuery API.
+        """
+        return copy.deepcopy(self._properties)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a :class:`~.external_config.BigtableColumn`
+        instance given its API representation.
+
+        Args:
+            resource (Dict[str, Any]):
+                Definition of a :class:`~.external_config.BigtableColumn`
+                instance in the same representation as is returned from the
+                API.
+
+        Returns:
+            :class:`~.external_config.BigtableColumn`:
+                Configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+
+class BigtableColumnFamily(object):
+    """Options for a Bigtable column family."""
+
+    def __init__(self):
+        self._properties = {}
+
+    @property
+    def encoding(self):
+        """str: The encoding of the values when the type is not `STRING`
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.columnFamilies.encoding
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.encoding
+        """
+        return self._properties.get("encoding")
+
+    @encoding.setter
+    def encoding(self, value):
+        self._properties["encoding"] = value
+
+    @property
+    def family_id(self):
+        """str: Identifier of the column family.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.columnFamilies.familyId
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.familyId
+        """
+        return self._properties.get("familyId")
+
+    @family_id.setter
+    def family_id(self, value):
+        self._properties["familyId"] = value
+
+    @property
+    def only_read_latest(self):
+        """bool: If this is set only the latest version of value are exposed
+        for all columns in this column family.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.columnFamilies.onlyReadLatest
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.onlyReadLatest
+        """
+        return self._properties.get("onlyReadLatest")
+
+    @only_read_latest.setter
+    def only_read_latest(self, value):
+        self._properties["onlyReadLatest"] = value
+
+    @property
+    def type_(self):
+        """str: The type to convert the value in cells of this column family.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.columnFamilies.type
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.type
+        """
+        return self._properties.get("type")
+
+    @type_.setter
+    def type_(self, value):
+        self._properties["type"] = value
+
+    @property
+    def columns(self):
+        """List[:class:`~.external_config.BigtableColumn`]: Lists of columns
+        that should be exposed as individual fields.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.columnFamilies.columns
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies.columns
+        """
+        prop = self._properties.get("columns", [])
+        return [BigtableColumn.from_api_repr(col) for col in prop]
+
+    @columns.setter
+    def columns(self, value):
+        self._properties["columns"] = [col.to_api_repr() for col in value]
+
+    def to_api_repr(self):
+        """Build an API representation of this object.
+
+        Returns:
+            Dict[str, Any]:
+                A dictionary in the format used by the BigQuery API.
+        """
+        return copy.deepcopy(self._properties)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a :class:`~.external_config.BigtableColumnFamily`
+        instance given its API representation.
+
+        Args:
+            resource (Dict[str, Any]):
+                Definition of a :class:`~.external_config.BigtableColumnFamily`
+                instance in the same representation as is returned from the
+                API.
+
+        Returns:
+            :class:`~.external_config.BigtableColumnFamily`:
+                Configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+
+class BigtableOptions(object):
+    """Options that describe how to treat Bigtable tables as BigQuery tables.
+    """
+
+    _SOURCE_FORMAT = "BIGTABLE"
+    _RESOURCE_NAME = "bigtableOptions"
+
+    def __init__(self):
+        self._properties = {}
+
+    @property
+    def ignore_unspecified_column_families(self):
+        """bool: If :data:`True`, ignore columns not specified in
+        :attr:`column_families` list. Defaults to :data:`False`.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.ignoreUnspecifiedColumnFamilies
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.ignoreUnspecifiedColumnFamilies
+        """
+        return self._properties.get("ignoreUnspecifiedColumnFamilies")
+
+    @ignore_unspecified_column_families.setter
+    def ignore_unspecified_column_families(self, value):
+        self._properties["ignoreUnspecifiedColumnFamilies"] = value
+
+    @property
+    def read_rowkey_as_string(self):
+        """bool: If :data:`True`, rowkey column families will be read and
+        converted to string. Defaults to :data:`False`.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.readRowkeyAsString
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.readRowkeyAsString
+        """
+        return self._properties.get("readRowkeyAsString")
+
+    @read_rowkey_as_string.setter
+    def read_rowkey_as_string(self, value):
+        self._properties["readRowkeyAsString"] = value
+
+    @property
+    def column_families(self):
+        """List[:class:`~.external_config.BigtableColumnFamily`]: List of
+        column families to expose in the table schema along with their types.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).bigtableOptions.columnFamilies
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.bigtableOptions.columnFamilies
+        """
+        prop = self._properties.get("columnFamilies", [])
+        return [BigtableColumnFamily.from_api_repr(cf) for cf in prop]
+
+    @column_families.setter
+    def column_families(self, value):
+        self._properties["columnFamilies"] = [cf.to_api_repr() for cf in value]
+
+    def to_api_repr(self):
+        """Build an API representation of this object.
+
+        Returns:
+            Dict[str, Any]:
+                A dictionary in the format used by the BigQuery API.
+        """
+        return copy.deepcopy(self._properties)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a :class:`~.external_config.BigtableOptions`
+        instance given its API representation.
+
+        Args:
+            resource (Dict[str, Any]):
+                Definition of a :class:`~.external_config.BigtableOptions`
+                instance in the same representation as is returned from the
+                API.
+
+        Returns:
+            :class:`~.external_config.BigtableOptions`:
+                Configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+
+class CSVOptions(object):
+    """Options that describe how to treat CSV files as BigQuery tables."""
+
+    _SOURCE_FORMAT = "CSV"
+    _RESOURCE_NAME = "csvOptions"
+
+    def __init__(self):
+        self._properties = {}
+
+    @property
+    def allow_jagged_rows(self):
+        """bool: If :data:`True`, BigQuery treats missing trailing columns as
+        null values. Defaults to :data:`False`.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).csvOptions.allowJaggedRows
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.csvOptions.allowJaggedRows
+        """
+        return self._properties.get("allowJaggedRows")
+
+    @allow_jagged_rows.setter
+    def allow_jagged_rows(self, value):
+        self._properties["allowJaggedRows"] = value
+
+    @property
+    def allow_quoted_newlines(self):
+        """bool: If :data:`True`, quoted data sections that contain newline
+        characters in a CSV file are allowed. Defaults to :data:`False`.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).csvOptions.allowQuotedNewlines
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.csvOptions.allowQuotedNewlines
+        """
+        return self._properties.get("allowQuotedNewlines")
+
+    @allow_quoted_newlines.setter
+    def allow_quoted_newlines(self, value):
+        self._properties["allowQuotedNewlines"] = value
+
+    @property
+    def encoding(self):
+        """str: The character encoding of the data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).csvOptions.encoding
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.csvOptions.encoding
+        """
+        return self._properties.get("encoding")
+
+    @encoding.setter
+    def encoding(self, value):
+        self._properties["encoding"] = value
+
+    @property
+    def field_delimiter(self):
+        """str: The separator for fields in a CSV file. Defaults to comma (',').
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).csvOptions.fieldDelimiter
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.csvOptions.fieldDelimiter
+        """
+        return self._properties.get("fieldDelimiter")
+
+    @field_delimiter.setter
+    def field_delimiter(self, value):
+        self._properties["fieldDelimiter"] = value
+
+    @property
+    def quote_character(self):
+        """str: The value that is used to quote data sections in a CSV file.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).csvOptions.quote
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.csvOptions.quote
+        """
+        return self._properties.get("quote")
+
+    @quote_character.setter
+    def quote_character(self, value):
+        self._properties["quote"] = value
+
+    @property
+    def skip_leading_rows(self):
+        """int: The number of rows at the top of a CSV file.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).csvOptions.skipLeadingRows
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.csvOptions.skipLeadingRows
+        """
+        return _int_or_none(self._properties.get("skipLeadingRows"))
+
+    @skip_leading_rows.setter
+    def skip_leading_rows(self, value):
+        self._properties["skipLeadingRows"] = str(value)
+
+    def to_api_repr(self):
+        """Build an API representation of this object.
+
+        Returns:
+            Dict[str, Any]:
+                A dictionary in the format used by the BigQuery API.
+        """
+        return copy.deepcopy(self._properties)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a :class:`~.external_config.CSVOptions` instance
+        given its API representation.
+
+        Args:
+            resource (Dict[str, Any]):
+                Definition of a :class:`~.external_config.CSVOptions`
+                instance in the same representation as is returned from the
+                API.
+
+        Returns:
+            :class:`~.external_config.CSVOptions`:
+                Configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+
+class GoogleSheetsOptions(object):
+    """Options that describe how to treat Google Sheets as BigQuery tables."""
+
+    _SOURCE_FORMAT = "GOOGLE_SHEETS"
+    _RESOURCE_NAME = "googleSheetsOptions"
+
+    def __init__(self):
+        self._properties = {}
+
+    @property
+    def skip_leading_rows(self):
+        """int: The number of rows at the top of a sheet that BigQuery will
+        skip when reading the data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).googleSheetsOptions.skipLeadingRows
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.googleSheetsOptions.skipLeadingRows
+        """
+        return _int_or_none(self._properties.get("skipLeadingRows"))
+
+    @skip_leading_rows.setter
+    def skip_leading_rows(self, value):
+        self._properties["skipLeadingRows"] = str(value)
+
+    def to_api_repr(self):
+        """Build an API representation of this object.
+
+        Returns:
+            Dict[str, Any]:
+                A dictionary in the format used by the BigQuery API.
+        """
+        return copy.deepcopy(self._properties)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a :class:`~.external_config.GoogleSheetsOptions`
+        instance given its API representation.
+
+        Args:
+            resource (Dict[str, Any]):
+                Definition of a :class:`~.external_config.GoogleSheetsOptions`
+                instance in the same representation as is returned from the
+                API.
+
+        Returns:
+            :class:`~.external_config.GoogleSheetsOptions`:
+                Configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+
+_OPTION_CLASSES = (BigtableOptions, CSVOptions, GoogleSheetsOptions)
+
+
+class ExternalConfig(object):
+    """Description of an external data source.
+
+    Args:
+        source_format (:class:`~.external_config.ExternalSourceFormat`):
+            See :attr:`source_format`.
+    """
+
+    def __init__(self, source_format):
+        self._properties = {"sourceFormat": source_format}
+        self._options = None
+        for optcls in _OPTION_CLASSES:
+            if source_format == optcls._SOURCE_FORMAT:
+                self._options = optcls()
+                break
+
+    @property
+    def source_format(self):
+        """:class:`~.external_config.ExternalSourceFormat`:
+        Format of external source.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.sourceFormat
+        """
+        return self._properties["sourceFormat"]
+
+    @property
+    def options(self):
+        """Dict[str, Any]: Source-specific options."""
+        return self._options
+
+    @property
+    def autodetect(self):
+        """bool: If :data:`True`, try to detect schema and format options
+        automatically.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).autodetect
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.autodetect
+        """
+        return self._properties.get("autodetect")
+
+    @autodetect.setter
+    def autodetect(self, value):
+        self._properties["autodetect"] = value
+
+    @property
+    def compression(self):
+        """str: The compression type of the data source.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).compression
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.compression
+        """
+        return self._properties.get("compression")
+
+    @compression.setter
+    def compression(self, value):
+        self._properties["compression"] = value
+
+    @property
+    def ignore_unknown_values(self):
+        """bool: If :data:`True`, extra values that are not represented in the
+        table schema are ignored. Defaults to :data:`False`.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).ignoreUnknownValues
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.ignoreUnknownValues
+        """
+        return self._properties.get("ignoreUnknownValues")
+
+    @ignore_unknown_values.setter
+    def ignore_unknown_values(self, value):
+        self._properties["ignoreUnknownValues"] = value
+
+    @property
+    def max_bad_records(self):
+        """int: The maximum number of bad records that BigQuery can ignore when
+        reading data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).maxBadRecords
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.maxBadRecords
+        """
+        return self._properties.get("maxBadRecords")
+
+    @max_bad_records.setter
+    def max_bad_records(self, value):
+        self._properties["maxBadRecords"] = value
+
+    @property
+    def source_uris(self):
+        """List[str]: URIs that point to your data in Google Cloud.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).sourceUris
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.sourceUris
+        """
+        return self._properties.get("sourceUris", [])
+
+    @source_uris.setter
+    def source_uris(self, value):
+        self._properties["sourceUris"] = value
+
+    @property
+    def schema(self):
+        """List[:class:`~google.cloud.bigquery.schema.SchemaField`]: The schema
+        for the data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).schema
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#externalDataConfiguration.schema
+        """
+        prop = self._properties.get("schema", {})
+        return [SchemaField.from_api_repr(field) for field in prop.get("fields", [])]
+
+    @schema.setter
+    def schema(self, value):
+        prop = value
+        if value is not None:
+            prop = {"fields": [field.to_api_repr() for field in value]}
+        self._properties["schema"] = prop
+
+    def to_api_repr(self):
+        """Build an API representation of this object.
+
+        Returns:
+            Dict[str, Any]:
+                A dictionary in the format used by the BigQuery API.
+        """
+        config = copy.deepcopy(self._properties)
+        if self.options is not None:
+            r = self.options.to_api_repr()
+            if r != {}:
+                config[self.options._RESOURCE_NAME] = r
+        return config
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct an :class:`~.external_config.ExternalConfig`
+        instance given its API representation.
+
+        Args:
+            resource (Dict[str, Any]):
+                Definition of an :class:`~.external_config.ExternalConfig`
+                instance in the same representation as is returned from the
+                API.
+
+        Returns:
+            :class:`~.external_config.ExternalConfig`:
+                Configuration parsed from ``resource``.
+        """
+        config = cls(resource["sourceFormat"])
+        for optcls in _OPTION_CLASSES:
+            opts = resource.get(optcls._RESOURCE_NAME)
+            if opts is not None:
+                config._options = optcls.from_api_repr(opts)
+                break
+        config._properties = copy.deepcopy(resource)
+        return config
diff --git a/bigquery/google/cloud/bigquery/job.py b/bigquery/google/cloud/bigquery/job.py
new file mode 100644
index 000000000000..6e1eb81648f5
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/job.py
@@ -0,0 +1,3427 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define API Jobs."""
+
+import copy
+import re
+import threading
+
+import six
+from six.moves import http_client
+
+import google.api_core.future.polling
+from google.cloud import exceptions
+from google.cloud.exceptions import NotFound
+from google.cloud.bigquery.dataset import Dataset
+from google.cloud.bigquery.dataset import DatasetListItem
+from google.cloud.bigquery.dataset import DatasetReference
+from google.cloud.bigquery.external_config import ExternalConfig
+from google.cloud.bigquery.query import _query_param_from_api_repr
+from google.cloud.bigquery.query import ArrayQueryParameter
+from google.cloud.bigquery.query import ScalarQueryParameter
+from google.cloud.bigquery.query import StructQueryParameter
+from google.cloud.bigquery.query import UDFResource
+from google.cloud.bigquery.retry import DEFAULT_RETRY
+from google.cloud.bigquery.routine import RoutineReference
+from google.cloud.bigquery.schema import SchemaField
+from google.cloud.bigquery.table import _EmptyRowIterator
+from google.cloud.bigquery.table import EncryptionConfiguration
+from google.cloud.bigquery.table import _table_arg_to_table_ref
+from google.cloud.bigquery.table import TableReference
+from google.cloud.bigquery.table import Table
+from google.cloud.bigquery.table import TimePartitioning
+from google.cloud.bigquery import _helpers
+
+_DONE_STATE = "DONE"
+_STOPPED_REASON = "stopped"
+_TIMEOUT_BUFFER_SECS = 0.1
+_CONTAINS_ORDER_BY = re.compile(r"ORDER\s+BY", re.IGNORECASE)
+
+_ERROR_REASON_TO_EXCEPTION = {
+    "accessDenied": http_client.FORBIDDEN,
+    "backendError": http_client.INTERNAL_SERVER_ERROR,
+    "billingNotEnabled": http_client.FORBIDDEN,
+    "billingTierLimitExceeded": http_client.BAD_REQUEST,
+    "blocked": http_client.FORBIDDEN,
+    "duplicate": http_client.CONFLICT,
+    "internalError": http_client.INTERNAL_SERVER_ERROR,
+    "invalid": http_client.BAD_REQUEST,
+    "invalidQuery": http_client.BAD_REQUEST,
+    "notFound": http_client.NOT_FOUND,
+    "notImplemented": http_client.NOT_IMPLEMENTED,
+    "quotaExceeded": http_client.FORBIDDEN,
+    "rateLimitExceeded": http_client.FORBIDDEN,
+    "resourceInUse": http_client.BAD_REQUEST,
+    "resourcesExceeded": http_client.BAD_REQUEST,
+    "responseTooLarge": http_client.FORBIDDEN,
+    "stopped": http_client.OK,
+    "tableUnavailable": http_client.BAD_REQUEST,
+}
+
+
+def _error_result_to_exception(error_result):
+    """Maps BigQuery error reasons to an exception.
+
+    The reasons and their matching HTTP status codes are documented on
+    the `troubleshooting errors`_ page.
+
+    .. _troubleshooting errors: https://cloud.google.com/bigquery\
+        /troubleshooting-errors
+
+    :type error_result: Mapping[str, str]
+    :param error_result: The error result from BigQuery.
+
+    :rtype google.cloud.exceptions.GoogleCloudError:
+    :returns: The mapped exception.
+    """
+    reason = error_result.get("reason")
+    status_code = _ERROR_REASON_TO_EXCEPTION.get(
+        reason, http_client.INTERNAL_SERVER_ERROR
+    )
+    return exceptions.from_http_status(
+        status_code, error_result.get("message", ""), errors=[error_result]
+    )
+
+
+def _contains_order_by(query):
+    """Do we need to preserve the order of the query results?
+
+    This function has known false positives, such as with ordered window
+    functions:
+
+    .. code-block:: sql
+
+       SELECT SUM(x) OVER (
+           window_name
+           PARTITION BY...
+           ORDER BY...
+           window_frame_clause)
+       FROM ...
+
+    This false positive failure case means the behavior will be correct, but
+    downloading results with the BigQuery Storage API may be slower than it
+    otherwise would. This is preferable to the false negative case, where
+    results are expected to be in order but are not (due to parallel reads).
+    """
+    return query and _CONTAINS_ORDER_BY.search(query)
+
+
+class Compression(object):
+    """The compression type to use for exported files. The default value is
+    :attr:`NONE`.
+
+    :attr:`DEFLATE` and :attr:`SNAPPY` are
+    only supported for Avro.
+    """
+
+    GZIP = "GZIP"
+    """Specifies GZIP format."""
+
+    DEFLATE = "DEFLATE"
+    """Specifies DEFLATE format."""
+
+    SNAPPY = "SNAPPY"
+    """Specifies SNAPPY format."""
+
+    NONE = "NONE"
+    """Specifies no compression."""
+
+
+class CreateDisposition(object):
+    """Specifies whether the job is allowed to create new tables. The default
+    value is :attr:`CREATE_IF_NEEDED`.
+
+    Creation, truncation and append actions occur as one atomic update
+    upon job completion.
+    """
+
+    CREATE_IF_NEEDED = "CREATE_IF_NEEDED"
+    """If the table does not exist, BigQuery creates the table."""
+
+    CREATE_NEVER = "CREATE_NEVER"
+    """The table must already exist. If it does not, a 'notFound' error is
+    returned in the job result."""
+
+
+class DestinationFormat(object):
+    """The exported file format. The default value is :attr:`CSV`.
+
+    Tables with nested or repeated fields cannot be exported as CSV.
+    """
+
+    CSV = "CSV"
+    """Specifies CSV format."""
+
+    NEWLINE_DELIMITED_JSON = "NEWLINE_DELIMITED_JSON"
+    """Specifies newline delimited JSON format."""
+
+    AVRO = "AVRO"
+    """Specifies Avro format."""
+
+
+class Encoding(object):
+    """The character encoding of the data. The default is :attr:`UTF_8`.
+
+    BigQuery decodes the data after the raw, binary data has been
+    split using the values of the quote and fieldDelimiter properties.
+    """
+
+    UTF_8 = "UTF-8"
+    """Specifies UTF-8 encoding."""
+
+    ISO_8859_1 = "ISO-8859-1"
+    """Specifies ISO-8859-1 encoding."""
+
+
+class QueryPriority(object):
+    """Specifies a priority for the query. The default value is
+    :attr:`INTERACTIVE`.
+    """
+
+    INTERACTIVE = "INTERACTIVE"
+    """Specifies interactive priority."""
+
+    BATCH = "BATCH"
+    """Specifies batch priority."""
+
+
+class SourceFormat(object):
+    """The format of the data files. The default value is :attr:`CSV`.
+
+    Note that the set of allowed values for loading data is different
+    than the set used for external data sources (see
+    :class:`~google.cloud.bigquery.external_config.ExternalSourceFormat`).
+    """
+
+    CSV = "CSV"
+    """Specifies CSV format."""
+
+    DATASTORE_BACKUP = "DATASTORE_BACKUP"
+    """Specifies datastore backup format"""
+
+    NEWLINE_DELIMITED_JSON = "NEWLINE_DELIMITED_JSON"
+    """Specifies newline delimited JSON format."""
+
+    AVRO = "AVRO"
+    """Specifies Avro format."""
+
+    PARQUET = "PARQUET"
+    """Specifies Parquet format."""
+
+    ORC = "ORC"
+    """Specifies Orc format."""
+
+
+class WriteDisposition(object):
+    """Specifies the action that occurs if destination table already exists.
+
+    The default value is :attr:`WRITE_APPEND`.
+
+    Each action is atomic and only occurs if BigQuery is able to complete
+    the job successfully. Creation, truncation and append actions occur as one
+    atomic update upon job completion.
+    """
+
+    WRITE_APPEND = "WRITE_APPEND"
+    """If the table already exists, BigQuery appends the data to the table."""
+
+    WRITE_TRUNCATE = "WRITE_TRUNCATE"
+    """If the table already exists, BigQuery overwrites the table data."""
+
+    WRITE_EMPTY = "WRITE_EMPTY"
+    """If the table already exists and contains data, a 'duplicate' error is
+    returned in the job result."""
+
+
+class SchemaUpdateOption(object):
+    """Specifies an update to the destination table schema as a side effect of
+    a load job.
+    """
+
+    ALLOW_FIELD_ADDITION = "ALLOW_FIELD_ADDITION"
+    """Allow adding a nullable field to the schema."""
+
+    ALLOW_FIELD_RELAXATION = "ALLOW_FIELD_RELAXATION"
+    """Allow relaxing a required field in the original schema to nullable."""
+
+
+class _JobReference(object):
+    """A reference to a job.
+
+    Arguments:
+        job_id (str): ID of the job to run.
+        project (str): ID of the project where the job runs.
+        location (str): Location of where the job runs.
+    """
+
+    def __init__(self, job_id, project, location):
+        self._properties = {"jobId": job_id, "projectId": project}
+        # The location field must not be populated if it is None.
+        if location:
+            self._properties["location"] = location
+
+    @property
+    def job_id(self):
+        """str: ID of the job."""
+        return self._properties.get("jobId")
+
+    @property
+    def project(self):
+        """str: ID of the project where the job runs."""
+        return self._properties.get("projectId")
+
+    @property
+    def location(self):
+        """str: Location where the job runs."""
+        return self._properties.get("location")
+
+    def _to_api_repr(self):
+        """Returns the API resource representation of the job reference."""
+        return copy.deepcopy(self._properties)
+
+    @classmethod
+    def _from_api_repr(cls, resource):
+        """Returns a job reference for an API resource representation."""
+        job_id = resource.get("jobId")
+        project = resource.get("projectId")
+        location = resource.get("location")
+        job_ref = cls(job_id, project, location)
+        return job_ref
+
+
+class _AsyncJob(google.api_core.future.polling.PollingFuture):
+    """Base class for asynchronous jobs.
+
+    Arguments:
+        job_id (Union[str, _JobReference]):
+            Job's ID in the project associated with the client or a
+            fully-qualified job reference.
+        client (google.cloud.bigquery.client.Client):
+            Client which holds credentials and project configuration.
+    """
+
+    def __init__(self, job_id, client):
+        super(_AsyncJob, self).__init__()
+
+        # The job reference can be either a plain job ID or the full resource.
+        # Populate the properties dictionary consistently depending on what has
+        # been passed in.
+        job_ref = job_id
+        if not isinstance(job_id, _JobReference):
+            job_ref = _JobReference(job_id, client.project, None)
+        self._properties = {"jobReference": job_ref._to_api_repr()}
+
+        self._client = client
+        self._result_set = False
+        self._completion_lock = threading.Lock()
+
+    @property
+    def job_id(self):
+        """str: ID of the job."""
+        return _helpers._get_sub_prop(self._properties, ["jobReference", "jobId"])
+
+    @property
+    def project(self):
+        """Project bound to the job.
+
+        :rtype: str
+        :returns: the project (derived from the client).
+        """
+        return _helpers._get_sub_prop(self._properties, ["jobReference", "projectId"])
+
+    @property
+    def location(self):
+        """str: Location where the job runs."""
+        return _helpers._get_sub_prop(self._properties, ["jobReference", "location"])
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current dataset.
+
+        :rtype: :class:`google.cloud.bigquery.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self._client
+        return client
+
+    @property
+    def job_type(self):
+        """Type of job
+
+        :rtype: str
+        :returns: one of 'load', 'copy', 'extract', 'query'
+        """
+        return self._JOB_TYPE
+
+    @property
+    def path(self):
+        """URL path for the job's APIs.
+
+        :rtype: str
+        :returns: the path based on project and job ID.
+        """
+        return "/projects/%s/jobs/%s" % (self.project, self.job_id)
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the job."""
+        return self._properties.setdefault("labels", {})
+
+    @property
+    def etag(self):
+        """ETag for the job resource.
+
+        :rtype: str, or ``NoneType``
+        :returns: the ETag (None until set from the server).
+        """
+        return self._properties.get("etag")
+
+    @property
+    def self_link(self):
+        """URL for the job resource.
+
+        :rtype: str, or ``NoneType``
+        :returns: the URL (None until set from the server).
+        """
+        return self._properties.get("selfLink")
+
+    @property
+    def user_email(self):
+        """E-mail address of user who submitted the job.
+
+        :rtype: str, or ``NoneType``
+        :returns: the URL (None until set from the server).
+        """
+        return self._properties.get("user_email")
+
+    @property
+    def created(self):
+        """Datetime at which the job was created.
+
+        :rtype: ``datetime.datetime``, or ``NoneType``
+        :returns: the creation time (None until set from the server).
+        """
+        statistics = self._properties.get("statistics")
+        if statistics is not None:
+            millis = statistics.get("creationTime")
+            if millis is not None:
+                return _helpers._datetime_from_microseconds(millis * 1000.0)
+
+    @property
+    def started(self):
+        """Datetime at which the job was started.
+
+        :rtype: ``datetime.datetime``, or ``NoneType``
+        :returns: the start time (None until set from the server).
+        """
+        statistics = self._properties.get("statistics")
+        if statistics is not None:
+            millis = statistics.get("startTime")
+            if millis is not None:
+                return _helpers._datetime_from_microseconds(millis * 1000.0)
+
+    @property
+    def ended(self):
+        """Datetime at which the job finished.
+
+        :rtype: ``datetime.datetime``, or ``NoneType``
+        :returns: the end time (None until set from the server).
+        """
+        statistics = self._properties.get("statistics")
+        if statistics is not None:
+            millis = statistics.get("endTime")
+            if millis is not None:
+                return _helpers._datetime_from_microseconds(millis * 1000.0)
+
+    def _job_statistics(self):
+        """Helper for job-type specific statistics-based properties."""
+        statistics = self._properties.get("statistics", {})
+        return statistics.get(self._JOB_TYPE, {})
+
+    @property
+    def error_result(self):
+        """Error information about the job as a whole.
+
+        :rtype: mapping, or ``NoneType``
+        :returns: the error information (None until set from the server).
+        """
+        status = self._properties.get("status")
+        if status is not None:
+            return status.get("errorResult")
+
+    @property
+    def errors(self):
+        """Information about individual errors generated by the job.
+
+        :rtype: list of mappings, or ``NoneType``
+        :returns: the error information (None until set from the server).
+        """
+        status = self._properties.get("status")
+        if status is not None:
+            return status.get("errors")
+
+    @property
+    def state(self):
+        """Status of the job.
+
+        :rtype: str, or ``NoneType``
+        :returns: the state (None until set from the server).
+        """
+        status = self._properties.get("status")
+        if status is not None:
+            return status.get("state")
+
+    def _scrub_local_properties(self, cleaned):
+        """Helper:  handle subclass properties in cleaned."""
+        pass
+
+    def _copy_configuration_properties(self, configuration):
+        """Helper:  assign subclass configuration properties in cleaned."""
+        raise NotImplementedError("Abstract")
+
+    def _set_properties(self, api_response):
+        """Update properties from resource in body of ``api_response``
+
+        :type api_response: dict
+        :param api_response: response returned from an API call
+        """
+        cleaned = api_response.copy()
+        self._scrub_local_properties(cleaned)
+
+        statistics = cleaned.get("statistics", {})
+        if "creationTime" in statistics:
+            statistics["creationTime"] = float(statistics["creationTime"])
+        if "startTime" in statistics:
+            statistics["startTime"] = float(statistics["startTime"])
+        if "endTime" in statistics:
+            statistics["endTime"] = float(statistics["endTime"])
+
+        self._properties.clear()
+        self._properties.update(cleaned)
+        self._copy_configuration_properties(cleaned.get("configuration", {}))
+
+        # For Future interface
+        self._set_future_result()
+
+    @classmethod
+    def _get_resource_config(cls, resource):
+        """Helper for :meth:`from_api_repr`
+
+        :type resource: dict
+        :param resource: resource for the job
+
+        :rtype: dict
+        :returns: tuple (string, dict), where the first element is the
+                  job ID and the second contains job-specific configuration.
+        :raises: :class:`KeyError` if the resource has no identifier, or
+                 is missing the appropriate configuration.
+        """
+        if "jobReference" not in resource or "jobId" not in resource["jobReference"]:
+            raise KeyError(
+                "Resource lacks required identity information: "
+                '["jobReference"]["jobId"]'
+            )
+        job_id = resource["jobReference"]["jobId"]
+        if (
+            "configuration" not in resource
+            or cls._JOB_TYPE not in resource["configuration"]
+        ):
+            raise KeyError(
+                "Resource lacks required configuration: "
+                '["configuration"]["%s"]' % cls._JOB_TYPE
+            )
+        return job_id, resource["configuration"]
+
+    def to_api_repr(self):
+        """Generate a resource for the job."""
+        raise NotImplementedError("Abstract")
+
+    _build_resource = to_api_repr  # backward-compatibility alias
+
+    def _begin(self, client=None, retry=DEFAULT_RETRY):
+        """API call:  begin the job via a POST request
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert
+
+        Args:
+            client (Optional[google.cloud.bigquery.client.Client]):
+                The client to use. If not passed, falls back to the ``client``
+                associated with the job object or``NoneType``
+            retry (Optional[google.api_core.retry.Retry]):
+                How to retry the RPC.
+
+        Raises:
+            ValueError:
+                If the job has already begun.
+        """
+        if self.state is not None:
+            raise ValueError("Job already begun.")
+
+        client = self._require_client(client)
+        path = "/projects/%s/jobs" % (self.project,)
+
+        # jobs.insert is idempotent because we ensure that every new
+        # job has an ID.
+        api_response = client._call_api(
+            retry, method="POST", path=path, data=self.to_api_repr()
+        )
+        self._set_properties(api_response)
+
+    def exists(self, client=None, retry=DEFAULT_RETRY):
+        """API call:  test for the existence of the job via a GET request
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/get
+
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current dataset.
+
+        :type retry: :class:`google.api_core.retry.Retry`
+        :param retry: (Optional) How to retry the RPC.
+
+        :rtype: bool
+        :returns: Boolean indicating existence of the job.
+        """
+        client = self._require_client(client)
+
+        extra_params = {"fields": "id"}
+        if self.location:
+            extra_params["location"] = self.location
+
+        try:
+            client._call_api(
+                retry, method="GET", path=self.path, query_params=extra_params
+            )
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self, client=None, retry=DEFAULT_RETRY):
+        """API call:  refresh job properties via a GET request.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/get
+
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current dataset.
+
+        :type retry: :class:`google.api_core.retry.Retry`
+        :param retry: (Optional) How to retry the RPC.
+        """
+        client = self._require_client(client)
+
+        extra_params = {}
+        if self.location:
+            extra_params["location"] = self.location
+
+        api_response = client._call_api(
+            retry, method="GET", path=self.path, query_params=extra_params
+        )
+        self._set_properties(api_response)
+
+    def cancel(self, client=None):
+        """API call:  cancel job via a POST request
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/cancel
+
+        :type client: :class:`~google.cloud.bigquery.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current dataset.
+
+        :rtype: bool
+        :returns: Boolean indicating that the cancel request was sent.
+        """
+        client = self._require_client(client)
+
+        extra_params = {}
+        if self.location:
+            extra_params["location"] = self.location
+
+        api_response = client._connection.api_request(
+            method="POST", path="%s/cancel" % (self.path,), query_params=extra_params
+        )
+        self._set_properties(api_response["job"])
+        # The Future interface requires that we return True if the *attempt*
+        # to cancel was successful.
+        return True
+
+    # The following methods implement the PollingFuture interface. Note that
+    # the methods above are from the pre-Future interface and are left for
+    # compatibility. The only "overloaded" method is :meth:`cancel`, which
+    # satisfies both interfaces.
+
+    def _set_future_result(self):
+        """Set the result or exception from the job if it is complete."""
+        # This must be done in a lock to prevent the polling thread
+        # and main thread from both executing the completion logic
+        # at the same time.
+        with self._completion_lock:
+            # If the operation isn't complete or if the result has already been
+            # set, do not call set_result/set_exception again.
+            # Note: self._result_set is set to True in set_result and
+            # set_exception, in case those methods are invoked directly.
+            if self.state != _DONE_STATE or self._result_set:
+                return
+
+            if self.error_result is not None:
+                exception = _error_result_to_exception(self.error_result)
+                self.set_exception(exception)
+            else:
+                self.set_result(self)
+
+    def done(self, retry=DEFAULT_RETRY):
+        """Refresh the job and checks if it is complete.
+
+        :type retry: :class:`google.api_core.retry.Retry`
+        :param retry: (Optional) How to retry the RPC.
+
+        :rtype: bool
+        :returns: True if the job is complete, False otherwise.
+        """
+        # Do not refresh is the state is already done, as the job will not
+        # change once complete.
+        if self.state != _DONE_STATE:
+            self.reload(retry=retry)
+        return self.state == _DONE_STATE
+
+    def result(self, timeout=None, retry=DEFAULT_RETRY):
+        """Start the job and wait for it to complete and get the result.
+
+        :type timeout: float
+        :param timeout:
+            How long (in seconds) to wait for job to complete before raising
+            a :class:`concurrent.futures.TimeoutError`.
+
+        :type retry: :class:`google.api_core.retry.Retry`
+        :param retry: (Optional) How to retry the RPC.
+
+        :rtype: _AsyncJob
+        :returns: This instance.
+
+        :raises:
+            :class:`~google.cloud.exceptions.GoogleCloudError` if the job
+            failed or :class:`concurrent.futures.TimeoutError` if the job did
+            not complete in the given timeout.
+        """
+        if self.state is None:
+            self._begin(retry=retry)
+        # TODO: modify PollingFuture so it can pass a retry argument to done().
+        return super(_AsyncJob, self).result(timeout=timeout)
+
+    def cancelled(self):
+        """Check if the job has been cancelled.
+
+        This always returns False. It's not possible to check if a job was
+        cancelled in the API. This method is here to satisfy the interface
+        for :class:`google.api_core.future.Future`.
+
+        :rtype: bool
+        :returns: False
+        """
+        return (
+            self.error_result is not None
+            and self.error_result.get("reason") == _STOPPED_REASON
+        )
+
+
+class _JobConfig(object):
+    """Abstract base class for job configuration objects.
+
+    Arguments:
+        job_type (str): The key to use for the job configuration.
+    """
+
+    def __init__(self, job_type, **kwargs):
+        self._job_type = job_type
+        self._properties = {job_type: {}}
+        for prop, val in kwargs.items():
+            setattr(self, prop, val)
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the job.
+
+        This method always returns a dict. To change a job's labels,
+        modify the dict, then call ``Client.update_job``. To delete a
+        label, set its value to :data:`None` before updating.
+
+        Raises:
+            ValueError: If ``value`` type is invalid.
+        """
+        return self._properties.setdefault("labels", {})
+
+    @labels.setter
+    def labels(self, value):
+        if not isinstance(value, dict):
+            raise ValueError("Pass a dict")
+        self._properties["labels"] = value
+
+    def _get_sub_prop(self, key, default=None):
+        """Get a value in the ``self._properties[self._job_type]`` dictionary.
+
+        Most job properties are inside the dictionary related to the job type
+        (e.g. 'copy', 'extract', 'load', 'query'). Use this method to access
+        those properties::
+
+            self._get_sub_prop('destinationTable')
+
+        This is equivalent to using the ``_helpers._get_sub_prop`` function::
+
+            _helpers._get_sub_prop(
+                self._properties, ['query', 'destinationTable'])
+
+        Arguments:
+            key (str):
+                 Key for the value to get in the
+                 ``self._properties[self._job_type]`` dictionary.
+            default (object):
+                (Optional) Default value to return if the key is not found.
+                Defaults to :data:`None`.
+
+        Returns:
+            object: The value if present or the default.
+        """
+        return _helpers._get_sub_prop(
+            self._properties, [self._job_type, key], default=default
+        )
+
+    def _set_sub_prop(self, key, value):
+        """Set a value in the ``self._properties[self._job_type]`` dictionary.
+
+        Most job properties are inside the dictionary related to the job type
+        (e.g. 'copy', 'extract', 'load', 'query'). Use this method to set
+        those properties::
+
+            self._set_sub_prop('useLegacySql', False)
+
+        This is equivalent to using the ``_helper._set_sub_prop`` function::
+
+            _helper._set_sub_prop(
+                self._properties, ['query', 'useLegacySql'], False)
+
+        Arguments:
+            key (str):
+                 Key to set in the ``self._properties[self._job_type]``
+                 dictionary.
+            value (object): Value to set.
+        """
+        _helpers._set_sub_prop(self._properties, [self._job_type, key], value)
+
+    def _del_sub_prop(self, key):
+        """Remove ``key`` from the ``self._properties[self._job_type]`` dict.
+
+        Most job properties are inside the dictionary related to the job type
+        (e.g. 'copy', 'extract', 'load', 'query'). Use this method to clear
+        those properties::
+
+            self._del_sub_prop('useLegacySql')
+
+        This is equivalent to using the ``_helper._del_sub_prop`` function::
+
+            _helper._del_sub_prop(
+                self._properties, ['query', 'useLegacySql'])
+
+        Arguments:
+            key (str):
+                 Key to remove in the ``self._properties[self._job_type]``
+                 dictionary.
+        """
+        _helpers._del_sub_prop(self._properties, [self._job_type, key])
+
+    def to_api_repr(self):
+        """Build an API representation of the job config.
+
+        :rtype: dict
+        :returns: A dictionary in the format used by the BigQuery API.
+        """
+        return copy.deepcopy(self._properties)
+
+    def _fill_from_default(self, default_job_config):
+        """Merge this job config with a default job config.
+
+        The keys in this object take precedence over the keys in the default
+        config. The merge is done at the top-level as well as for keys one
+        level below the job type.
+
+        Arguments:
+            default_job_config (google.cloud.bigquery.job._JobConfig):
+                The default job config that will be used to fill in self.
+
+        Returns:
+            google.cloud.bigquery.job._JobConfig A new (merged) job config.
+        """
+        if self._job_type != default_job_config._job_type:
+            raise TypeError(
+                "attempted to merge two incompatible job types: "
+                + repr(self._job_type)
+                + ", "
+                + repr(default_job_config._job_type)
+            )
+
+        new_job_config = self.__class__()
+
+        default_job_properties = copy.deepcopy(default_job_config._properties)
+        for key in self._properties:
+            if key != self._job_type:
+                default_job_properties[key] = self._properties[key]
+
+        default_job_properties[self._job_type].update(self._properties[self._job_type])
+        new_job_config._properties = default_job_properties
+
+        return new_job_config
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a job configuration given its API representation
+
+        :type resource: dict
+        :param resource:
+            An extract job configuration in the same representation as is
+            returned from the API.
+
+        :rtype: :class:`google.cloud.bigquery.job._JobConfig`
+        :returns: Configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+
+class LoadJobConfig(_JobConfig):
+    """Configuration options for load jobs.
+
+    All properties in this class are optional. Values which are :data:`None` ->
+    server defaults. Set properties on the constructed configuration by using
+    the property name as the name of a keyword argument.
+    """
+
+    def __init__(self, **kwargs):
+        super(LoadJobConfig, self).__init__("load", **kwargs)
+
+    @property
+    def allow_jagged_rows(self):
+        """bool: Allow missing trailing optional columns (CSV only).
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.allowJaggedRows
+        """
+        return self._get_sub_prop("allowJaggedRows")
+
+    @allow_jagged_rows.setter
+    def allow_jagged_rows(self, value):
+        self._set_sub_prop("allowJaggedRows", value)
+
+    @property
+    def allow_quoted_newlines(self):
+        """bool: Allow quoted data containing newline characters (CSV only).
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.allowQuotedNewlines
+        """
+        return self._get_sub_prop("allowQuotedNewlines")
+
+    @allow_quoted_newlines.setter
+    def allow_quoted_newlines(self, value):
+        self._set_sub_prop("allowQuotedNewlines", value)
+
+    @property
+    def autodetect(self):
+        """bool: Automatically infer the schema from a sample of the data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.autodetect
+        """
+        return self._get_sub_prop("autodetect")
+
+    @autodetect.setter
+    def autodetect(self, value):
+        self._set_sub_prop("autodetect", value)
+
+    @property
+    def clustering_fields(self):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+
+        Clustering fields are immutable after table creation.
+
+        .. note::
+
+           As of 2018-06-29, clustering fields cannot be set on a table
+           which does not also have time partioning defined.
+        """
+        prop = self._get_sub_prop("clustering")
+        if prop is not None:
+            return list(prop.get("fields", ()))
+
+    @clustering_fields.setter
+    def clustering_fields(self, value):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+        """
+        if value is not None:
+            self._set_sub_prop("clustering", {"fields": value})
+        else:
+            self._del_sub_prop("clustering")
+
+    @property
+    def create_disposition(self):
+        """google.cloud.bigquery.job.CreateDisposition: Specifies behavior
+        for creating tables.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.createDisposition
+        """
+        return self._get_sub_prop("createDisposition")
+
+    @create_disposition.setter
+    def create_disposition(self, value):
+        self._set_sub_prop("createDisposition", value)
+
+    @property
+    def destination_encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the destination table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys) or :data:`None`
+        if using default encryption.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.destinationEncryptionConfiguration
+        """
+        prop = self._get_sub_prop("destinationEncryptionConfiguration")
+        if prop is not None:
+            prop = EncryptionConfiguration.from_api_repr(prop)
+        return prop
+
+    @destination_encryption_configuration.setter
+    def destination_encryption_configuration(self, value):
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+            self._set_sub_prop("destinationEncryptionConfiguration", api_repr)
+        else:
+            self._del_sub_prop("destinationEncryptionConfiguration")
+
+    @property
+    def destination_table_description(self):
+        """Union[str, None] name given to destination table.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.destinationTableProperties.description
+        """
+        prop = self._get_sub_prop("destinationTableProperties")
+        if prop is not None:
+            return prop["description"]
+
+    @destination_table_description.setter
+    def destination_table_description(self, value):
+        keys = [self._job_type, "destinationTableProperties", "description"]
+        if value is not None:
+            _helpers._set_sub_prop(self._properties, keys, value)
+        else:
+            _helpers._del_sub_prop(self._properties, keys)
+
+    @property
+    def destination_table_friendly_name(self):
+        """Union[str, None] name given to destination table.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.destinationTableProperties.friendlyName
+        """
+        prop = self._get_sub_prop("destinationTableProperties")
+        if prop is not None:
+            return prop["friendlyName"]
+
+    @destination_table_friendly_name.setter
+    def destination_table_friendly_name(self, value):
+        keys = [self._job_type, "destinationTableProperties", "friendlyName"]
+        if value is not None:
+            _helpers._set_sub_prop(self._properties, keys, value)
+        else:
+            _helpers._del_sub_prop(self._properties, keys)
+
+    @property
+    def encoding(self):
+        """google.cloud.bigquery.job.Encoding: The character encoding of the
+        data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.encoding
+        """
+        return self._get_sub_prop("encoding")
+
+    @encoding.setter
+    def encoding(self, value):
+        self._set_sub_prop("encoding", value)
+
+    @property
+    def field_delimiter(self):
+        """str: The separator for fields in a CSV file.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.fieldDelimiter
+        """
+        return self._get_sub_prop("fieldDelimiter")
+
+    @field_delimiter.setter
+    def field_delimiter(self, value):
+        self._set_sub_prop("fieldDelimiter", value)
+
+    @property
+    def ignore_unknown_values(self):
+        """bool: Ignore extra values not represented in the table schema.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.ignoreUnknownValues
+        """
+        return self._get_sub_prop("ignoreUnknownValues")
+
+    @ignore_unknown_values.setter
+    def ignore_unknown_values(self, value):
+        self._set_sub_prop("ignoreUnknownValues", value)
+
+    @property
+    def max_bad_records(self):
+        """int: Number of invalid rows to ignore.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.maxBadRecords
+        """
+        return _helpers._int_or_none(self._get_sub_prop("maxBadRecords"))
+
+    @max_bad_records.setter
+    def max_bad_records(self, value):
+        self._set_sub_prop("maxBadRecords", value)
+
+    @property
+    def null_marker(self):
+        """str: Represents a null value (CSV only).
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.nullMarker
+        """
+        return self._get_sub_prop("nullMarker")
+
+    @null_marker.setter
+    def null_marker(self, value):
+        self._set_sub_prop("nullMarker", value)
+
+    @property
+    def quote_character(self):
+        """str: Character used to quote data sections (CSV only).
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.quote
+        """
+        return self._get_sub_prop("quote")
+
+    @quote_character.setter
+    def quote_character(self, value):
+        self._set_sub_prop("quote", value)
+
+    @property
+    def schema(self):
+        """List[google.cloud.bigquery.schema.SchemaField]: Schema of the
+        destination table.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
+        """
+        schema = _helpers._get_sub_prop(self._properties, ["load", "schema", "fields"])
+        if schema is None:
+            return
+        return [SchemaField.from_api_repr(field) for field in schema]
+
+    @schema.setter
+    def schema(self, value):
+        if value is None:
+            self._del_sub_prop("schema")
+            return
+
+        if not all(hasattr(field, "to_api_repr") for field in value):
+            raise ValueError("Schema items must be fields")
+        _helpers._set_sub_prop(
+            self._properties,
+            ["load", "schema", "fields"],
+            [field.to_api_repr() for field in value],
+        )
+
+    @property
+    def schema_update_options(self):
+        """List[google.cloud.bigquery.job.SchemaUpdateOption]: Specifies
+        updates to the destination table schema to allow as a side effect of
+        the load job.
+        """
+        return self._get_sub_prop("schemaUpdateOptions")
+
+    @schema_update_options.setter
+    def schema_update_options(self, values):
+        self._set_sub_prop("schemaUpdateOptions", values)
+
+    @property
+    def skip_leading_rows(self):
+        """int: Number of rows to skip when reading data (CSV only).
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.skipLeadingRows
+        """
+        return _helpers._int_or_none(self._get_sub_prop("skipLeadingRows"))
+
+    @skip_leading_rows.setter
+    def skip_leading_rows(self, value):
+        self._set_sub_prop("skipLeadingRows", str(value))
+
+    @property
+    def source_format(self):
+        """google.cloud.bigquery.job.SourceFormat: File format of the data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.sourceFormat
+        """
+        return self._get_sub_prop("sourceFormat")
+
+    @source_format.setter
+    def source_format(self, value):
+        self._set_sub_prop("sourceFormat", value)
+
+    @property
+    def time_partitioning(self):
+        """google.cloud.bigquery.table.TimePartitioning: Specifies time-based
+        partitioning for the destination table.
+        """
+        prop = self._get_sub_prop("timePartitioning")
+        if prop is not None:
+            prop = TimePartitioning.from_api_repr(prop)
+        return prop
+
+    @time_partitioning.setter
+    def time_partitioning(self, value):
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+            self._set_sub_prop("timePartitioning", api_repr)
+        else:
+            self._del_sub_prop("timePartitioning")
+
+    @property
+    def use_avro_logical_types(self):
+        """bool: For loads of Avro data, governs whether Avro logical types are
+        converted to their corresponding BigQuery types(e.g. TIMESTAMP) rather than
+        raw types (e.g. INTEGER).
+        """
+        return self._get_sub_prop("useAvroLogicalTypes")
+
+    @use_avro_logical_types.setter
+    def use_avro_logical_types(self, value):
+        self._set_sub_prop("useAvroLogicalTypes", bool(value))
+
+    @property
+    def write_disposition(self):
+        """google.cloud.bigquery.job.WriteDisposition: Action that occurs if
+        the destination table already exists.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.writeDisposition
+        """
+        return self._get_sub_prop("writeDisposition")
+
+    @write_disposition.setter
+    def write_disposition(self, value):
+        self._set_sub_prop("writeDisposition", value)
+
+
+class LoadJob(_AsyncJob):
+    """Asynchronous job for loading data into a table.
+
+    Can load from Google Cloud Storage URIs or from a file.
+
+    :type job_id: str
+    :param job_id: the job's ID
+
+    :type source_uris: sequence of string or ``NoneType``
+    :param source_uris:
+        URIs of one or more data files to be loaded.  See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.sourceUris
+        for supported URI formats. Pass None for jobs that load from a file.
+
+    :type destination: :class:`google.cloud.bigquery.table.TableReference`
+    :param destination: reference to table into which data is to be loaded.
+
+    :type client: :class:`google.cloud.bigquery.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the dataset (which requires a project).
+    """
+
+    _JOB_TYPE = "load"
+
+    def __init__(self, job_id, source_uris, destination, client, job_config=None):
+        super(LoadJob, self).__init__(job_id, client)
+
+        if job_config is None:
+            job_config = LoadJobConfig()
+
+        self.source_uris = source_uris
+        self._destination = destination
+        self._configuration = job_config
+
+    @property
+    def destination(self):
+        """google.cloud.bigquery.table.TableReference: table where loaded rows are written
+
+        See:
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.load.destinationTable
+        """
+        return self._destination
+
+    @property
+    def allow_jagged_rows(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.allow_jagged_rows`.
+        """
+        return self._configuration.allow_jagged_rows
+
+    @property
+    def allow_quoted_newlines(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.allow_quoted_newlines`.
+        """
+        return self._configuration.allow_quoted_newlines
+
+    @property
+    def autodetect(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.autodetect`.
+        """
+        return self._configuration.autodetect
+
+    @property
+    def create_disposition(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.create_disposition`.
+        """
+        return self._configuration.create_disposition
+
+    @property
+    def encoding(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.encoding`.
+        """
+        return self._configuration.encoding
+
+    @property
+    def field_delimiter(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.field_delimiter`.
+        """
+        return self._configuration.field_delimiter
+
+    @property
+    def ignore_unknown_values(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.ignore_unknown_values`.
+        """
+        return self._configuration.ignore_unknown_values
+
+    @property
+    def max_bad_records(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.max_bad_records`.
+        """
+        return self._configuration.max_bad_records
+
+    @property
+    def null_marker(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.null_marker`.
+        """
+        return self._configuration.null_marker
+
+    @property
+    def quote_character(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.quote_character`.
+        """
+        return self._configuration.quote_character
+
+    @property
+    def skip_leading_rows(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.skip_leading_rows`.
+        """
+        return self._configuration.skip_leading_rows
+
+    @property
+    def source_format(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.source_format`.
+        """
+        return self._configuration.source_format
+
+    @property
+    def write_disposition(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.write_disposition`.
+        """
+        return self._configuration.write_disposition
+
+    @property
+    def schema(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.schema`.
+        """
+        return self._configuration.schema
+
+    @property
+    def destination_encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the destination table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys)
+        or :data:`None` if using default encryption.
+
+        See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.destination_encryption_configuration`.
+        """
+        return self._configuration.destination_encryption_configuration
+
+    @property
+    def destination_table_description(self):
+        """Union[str, None] name given to destination table.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.destinationTableProperties.description
+        """
+        return self._configuration.destination_table_description
+
+    @property
+    def destination_table_friendly_name(self):
+        """Union[str, None] name given to destination table.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.destinationTableProperties.friendlyName
+        """
+        return self._configuration.destination_table_friendly_name
+
+    @property
+    def time_partitioning(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.time_partitioning`.
+        """
+        return self._configuration.time_partitioning
+
+    @property
+    def use_avro_logical_types(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.use_avro_logical_types`.
+        """
+        return self._configuration.use_avro_logical_types
+
+    @property
+    def clustering_fields(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.clustering_fields`.
+        """
+        return self._configuration.clustering_fields
+
+    @property
+    def schema_update_options(self):
+        """See
+        :attr:`google.cloud.bigquery.job.LoadJobConfig.schema_update_options`.
+        """
+        return self._configuration.schema_update_options
+
+    @property
+    def input_file_bytes(self):
+        """Count of bytes loaded from source files.
+
+        :rtype: int, or ``NoneType``
+        :returns: the count (None until set from the server).
+        :raises: ValueError for invalid value types.
+        """
+        return _helpers._int_or_none(
+            _helpers._get_sub_prop(
+                self._properties, ["statistics", "load", "inputFileBytes"]
+            )
+        )
+
+    @property
+    def input_files(self):
+        """Count of source files.
+
+        :rtype: int, or ``NoneType``
+        :returns: the count (None until set from the server).
+        """
+        return _helpers._int_or_none(
+            _helpers._get_sub_prop(
+                self._properties, ["statistics", "load", "inputFiles"]
+            )
+        )
+
+    @property
+    def output_bytes(self):
+        """Count of bytes saved to destination table.
+
+        :rtype: int, or ``NoneType``
+        :returns: the count (None until set from the server).
+        """
+        return _helpers._int_or_none(
+            _helpers._get_sub_prop(
+                self._properties, ["statistics", "load", "outputBytes"]
+            )
+        )
+
+    @property
+    def output_rows(self):
+        """Count of rows saved to destination table.
+
+        :rtype: int, or ``NoneType``
+        :returns: the count (None until set from the server).
+        """
+        return _helpers._int_or_none(
+            _helpers._get_sub_prop(
+                self._properties, ["statistics", "load", "outputRows"]
+            )
+        )
+
+    def to_api_repr(self):
+        """Generate a resource for :meth:`_begin`."""
+        configuration = self._configuration.to_api_repr()
+        if self.source_uris is not None:
+            _helpers._set_sub_prop(
+                configuration, ["load", "sourceUris"], self.source_uris
+            )
+        _helpers._set_sub_prop(
+            configuration, ["load", "destinationTable"], self.destination.to_api_repr()
+        )
+
+        return {
+            "jobReference": self._properties["jobReference"],
+            "configuration": configuration,
+        }
+
+    def _copy_configuration_properties(self, configuration):
+        """Helper:  assign subclass configuration properties in cleaned."""
+        self._configuration._properties = copy.deepcopy(configuration)
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a job given its API representation
+
+        .. note:
+
+           This method assumes that the project found in the resource matches
+           the client's project.
+
+        :type resource: dict
+        :param resource: dataset job representation returned from the API
+
+        :type client: :class:`google.cloud.bigquery.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the dataset.
+
+        :rtype: :class:`google.cloud.bigquery.job.LoadJob`
+        :returns: Job parsed from ``resource``.
+        """
+        config_resource = resource.get("configuration", {})
+        config = LoadJobConfig.from_api_repr(config_resource)
+        # A load job requires a destination table.
+        dest_config = config_resource["load"]["destinationTable"]
+        ds_ref = DatasetReference(dest_config["projectId"], dest_config["datasetId"])
+        destination = TableReference(ds_ref, dest_config["tableId"])
+        # sourceUris will be absent if this is a file upload.
+        source_uris = _helpers._get_sub_prop(config_resource, ["load", "sourceUris"])
+        job_ref = _JobReference._from_api_repr(resource["jobReference"])
+        job = cls(job_ref, source_uris, destination, client, config)
+        job._set_properties(resource)
+        return job
+
+
+class CopyJobConfig(_JobConfig):
+    """Configuration options for copy jobs.
+
+    All properties in this class are optional. Values which are :data:`None` ->
+    server defaults. Set properties on the constructed configuration by using
+    the property name as the name of a keyword argument.
+    """
+
+    def __init__(self, **kwargs):
+        super(CopyJobConfig, self).__init__("copy", **kwargs)
+
+    @property
+    def create_disposition(self):
+        """google.cloud.bigquery.job.CreateDisposition: Specifies behavior
+        for creating tables.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.copy.createDisposition
+        """
+        return self._get_sub_prop("createDisposition")
+
+    @create_disposition.setter
+    def create_disposition(self, value):
+        self._set_sub_prop("createDisposition", value)
+
+    @property
+    def write_disposition(self):
+        """google.cloud.bigquery.job.WriteDisposition: Action that occurs if
+        the destination table already exists.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.copy.writeDisposition
+        """
+        return self._get_sub_prop("writeDisposition")
+
+    @write_disposition.setter
+    def write_disposition(self, value):
+        self._set_sub_prop("writeDisposition", value)
+
+    @property
+    def destination_encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the destination table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys) or :data:`None`
+        if using default encryption.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.copy.destinationEncryptionConfiguration
+        """
+        prop = self._get_sub_prop("destinationEncryptionConfiguration")
+        if prop is not None:
+            prop = EncryptionConfiguration.from_api_repr(prop)
+        return prop
+
+    @destination_encryption_configuration.setter
+    def destination_encryption_configuration(self, value):
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+        self._set_sub_prop("destinationEncryptionConfiguration", api_repr)
+
+
+class CopyJob(_AsyncJob):
+    """Asynchronous job: copy data into a table from other tables.
+
+    :type job_id: str
+    :param job_id: the job's ID, within the project belonging to ``client``.
+
+    :type sources: list of :class:`google.cloud.bigquery.table.TableReference`
+    :param sources: Table from which data is to be loaded.
+
+    :type destination: :class:`google.cloud.bigquery.table.TableReference`
+    :param destination: Table into which data is to be loaded.
+
+    :type client: :class:`google.cloud.bigquery.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the dataset (which requires a project).
+
+    :type job_config: :class:`~google.cloud.bigquery.job.CopyJobConfig`
+    :param job_config:
+        (Optional) Extra configuration options for the copy job.
+    """
+
+    _JOB_TYPE = "copy"
+
+    def __init__(self, job_id, sources, destination, client, job_config=None):
+        super(CopyJob, self).__init__(job_id, client)
+
+        if job_config is None:
+            job_config = CopyJobConfig()
+
+        self.destination = destination
+        self.sources = sources
+        self._configuration = job_config
+
+    @property
+    def create_disposition(self):
+        """See
+        :attr:`google.cloud.bigquery.job.CopyJobConfig.create_disposition`.
+        """
+        return self._configuration.create_disposition
+
+    @property
+    def write_disposition(self):
+        """See
+        :attr:`google.cloud.bigquery.job.CopyJobConfig.write_disposition`.
+        """
+        return self._configuration.write_disposition
+
+    @property
+    def destination_encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the destination table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys) or :data:`None`
+        if using default encryption.
+
+        See
+        :attr:`google.cloud.bigquery.job.CopyJobConfig.destination_encryption_configuration`.
+        """
+        return self._configuration.destination_encryption_configuration
+
+    def to_api_repr(self):
+        """Generate a resource for :meth:`_begin`."""
+
+        source_refs = [
+            {
+                "projectId": table.project,
+                "datasetId": table.dataset_id,
+                "tableId": table.table_id,
+            }
+            for table in self.sources
+        ]
+
+        configuration = self._configuration.to_api_repr()
+        _helpers._set_sub_prop(configuration, ["copy", "sourceTables"], source_refs)
+        _helpers._set_sub_prop(
+            configuration,
+            ["copy", "destinationTable"],
+            {
+                "projectId": self.destination.project,
+                "datasetId": self.destination.dataset_id,
+                "tableId": self.destination.table_id,
+            },
+        )
+
+        return {
+            "jobReference": self._properties["jobReference"],
+            "configuration": configuration,
+        }
+
+    def _copy_configuration_properties(self, configuration):
+        """Helper:  assign subclass configuration properties in cleaned."""
+        self._configuration._properties = copy.deepcopy(configuration)
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a job given its API representation
+
+        .. note:
+
+           This method assumes that the project found in the resource matches
+           the client's project.
+
+        :type resource: dict
+        :param resource: dataset job representation returned from the API
+
+        :type client: :class:`google.cloud.bigquery.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the dataset.
+
+        :rtype: :class:`google.cloud.bigquery.job.CopyJob`
+        :returns: Job parsed from ``resource``.
+        """
+        job_id, config_resource = cls._get_resource_config(resource)
+        config = CopyJobConfig.from_api_repr(config_resource)
+        # Copy required fields to the job.
+        copy_resource = config_resource["copy"]
+        destination = TableReference.from_api_repr(copy_resource["destinationTable"])
+        sources = []
+        source_configs = copy_resource.get("sourceTables")
+        if source_configs is None:
+            single = copy_resource.get("sourceTable")
+            if single is None:
+                raise KeyError("Resource missing 'sourceTables' / 'sourceTable'")
+            source_configs = [single]
+        for source_config in source_configs:
+            table_ref = TableReference.from_api_repr(source_config)
+            sources.append(table_ref)
+        job = cls(job_id, sources, destination, client=client, job_config=config)
+        job._set_properties(resource)
+        return job
+
+
+class ExtractJobConfig(_JobConfig):
+    """Configuration options for extract jobs.
+
+    All properties in this class are optional. Values which are :data:`None` ->
+    server defaults. Set properties on the constructed configuration by using
+    the property name as the name of a keyword argument.
+    """
+
+    def __init__(self, **kwargs):
+        super(ExtractJobConfig, self).__init__("extract", **kwargs)
+
+    @property
+    def compression(self):
+        """google.cloud.bigquery.job.Compression: Compression type to use for
+        exported files.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.extract.compression
+        """
+        return self._get_sub_prop("compression")
+
+    @compression.setter
+    def compression(self, value):
+        self._set_sub_prop("compression", value)
+
+    @property
+    def destination_format(self):
+        """google.cloud.bigquery.job.DestinationFormat: Exported file format.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.extract.destinationFormat
+        """
+        return self._get_sub_prop("destinationFormat")
+
+    @destination_format.setter
+    def destination_format(self, value):
+        self._set_sub_prop("destinationFormat", value)
+
+    @property
+    def field_delimiter(self):
+        """str: Delimiter to use between fields in the exported data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.extract.fieldDelimiter
+        """
+        return self._get_sub_prop("fieldDelimiter")
+
+    @field_delimiter.setter
+    def field_delimiter(self, value):
+        self._set_sub_prop("fieldDelimiter", value)
+
+    @property
+    def print_header(self):
+        """bool: Print a header row in the exported data.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.extract.printHeader
+        """
+        return self._get_sub_prop("printHeader")
+
+    @print_header.setter
+    def print_header(self, value):
+        self._set_sub_prop("printHeader", value)
+
+
+class ExtractJob(_AsyncJob):
+    """Asynchronous job: extract data from a table into Cloud Storage.
+
+    :type job_id: str
+    :param job_id: the job's ID
+
+    :type source: :class:`google.cloud.bigquery.table.TableReference`
+    :param source: Table into which data is to be loaded.
+
+    :type destination_uris: list of string
+    :param destination_uris:
+        URIs describing where the extracted data will be written in Cloud
+        Storage, using the format ``gs://<bucket_name>/<object_name_or_glob>``.
+
+    :type client: :class:`google.cloud.bigquery.client.Client`
+    :param client:
+        A client which holds credentials and project configuration.
+
+    :type job_config: :class:`~google.cloud.bigquery.job.ExtractJobConfig`
+    :param job_config:
+        (Optional) Extra configuration options for the extract job.
+    """
+
+    _JOB_TYPE = "extract"
+
+    def __init__(self, job_id, source, destination_uris, client, job_config=None):
+        super(ExtractJob, self).__init__(job_id, client)
+
+        if job_config is None:
+            job_config = ExtractJobConfig()
+
+        self.source = source
+        self.destination_uris = destination_uris
+        self._configuration = job_config
+
+    @property
+    def compression(self):
+        """See
+        :attr:`google.cloud.bigquery.job.ExtractJobConfig.compression`.
+        """
+        return self._configuration.compression
+
+    @property
+    def destination_format(self):
+        """See
+        :attr:`google.cloud.bigquery.job.ExtractJobConfig.destination_format`.
+        """
+        return self._configuration.destination_format
+
+    @property
+    def field_delimiter(self):
+        """See
+        :attr:`google.cloud.bigquery.job.ExtractJobConfig.field_delimiter`.
+        """
+        return self._configuration.field_delimiter
+
+    @property
+    def print_header(self):
+        """See
+        :attr:`google.cloud.bigquery.job.ExtractJobConfig.print_header`.
+        """
+        return self._configuration.print_header
+
+    @property
+    def destination_uri_file_counts(self):
+        """Return file counts from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.extract.destinationUriFileCounts
+
+        Returns:
+            a list of integer counts, each representing the number of files
+            per destination URI or URI pattern specified in the extract
+            configuration. These values will be in the same order as the URIs
+            specified in the 'destinationUris' field.  Returns None if job is
+            not yet complete.
+        """
+        counts = self._job_statistics().get("destinationUriFileCounts")
+        if counts is not None:
+            return [int(count) for count in counts]
+        return None
+
+    def to_api_repr(self):
+        """Generate a resource for :meth:`_begin`."""
+
+        source_ref = {
+            "projectId": self.source.project,
+            "datasetId": self.source.dataset_id,
+            "tableId": self.source.table_id,
+        }
+
+        configuration = self._configuration.to_api_repr()
+        _helpers._set_sub_prop(configuration, ["extract", "sourceTable"], source_ref)
+        _helpers._set_sub_prop(
+            configuration, ["extract", "destinationUris"], self.destination_uris
+        )
+
+        return {
+            "jobReference": self._properties["jobReference"],
+            "configuration": configuration,
+        }
+
+    def _copy_configuration_properties(self, configuration):
+        """Helper:  assign subclass configuration properties in cleaned."""
+        self._configuration._properties = copy.deepcopy(configuration)
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a job given its API representation
+
+        .. note:
+
+           This method assumes that the project found in the resource matches
+           the client's project.
+
+        :type resource: dict
+        :param resource: dataset job representation returned from the API
+
+        :type client: :class:`google.cloud.bigquery.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the dataset.
+
+        :rtype: :class:`google.cloud.bigquery.job.ExtractJob`
+        :returns: Job parsed from ``resource``.
+        """
+        job_id, config_resource = cls._get_resource_config(resource)
+        config = ExtractJobConfig.from_api_repr(config_resource)
+        source_config = _helpers._get_sub_prop(
+            config_resource, ["extract", "sourceTable"]
+        )
+        dataset = DatasetReference(
+            source_config["projectId"], source_config["datasetId"]
+        )
+        source = dataset.table(source_config["tableId"])
+        destination_uris = _helpers._get_sub_prop(
+            config_resource, ["extract", "destinationUris"]
+        )
+
+        job = cls(job_id, source, destination_uris, client=client, job_config=config)
+        job._set_properties(resource)
+        return job
+
+
+def _from_api_repr_query_parameters(resource):
+    return [_query_param_from_api_repr(mapping) for mapping in resource]
+
+
+def _to_api_repr_query_parameters(value):
+    return [query_parameter.to_api_repr() for query_parameter in value]
+
+
+def _from_api_repr_udf_resources(resource):
+    udf_resources = []
+    for udf_mapping in resource:
+        for udf_type, udf_value in udf_mapping.items():
+            udf_resources.append(UDFResource(udf_type, udf_value))
+    return udf_resources
+
+
+def _to_api_repr_udf_resources(value):
+    return [{udf_resource.udf_type: udf_resource.value} for udf_resource in value]
+
+
+def _from_api_repr_table_defs(resource):
+    return {k: ExternalConfig.from_api_repr(v) for k, v in resource.items()}
+
+
+def _to_api_repr_table_defs(value):
+    return {k: ExternalConfig.to_api_repr(v) for k, v in value.items()}
+
+
+class QueryJobConfig(_JobConfig):
+    """Configuration options for query jobs.
+
+    All properties in this class are optional. Values which are :data:`None` ->
+    server defaults. Set properties on the constructed configuration by using
+    the property name as the name of a keyword argument.
+    """
+
+    def __init__(self, **kwargs):
+        super(QueryJobConfig, self).__init__("query", **kwargs)
+
+    @property
+    def destination_encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the destination table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys) or :data:`None`
+        if using default encryption.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.destinationEncryptionConfiguration
+        """
+        prop = self._get_sub_prop("destinationEncryptionConfiguration")
+        if prop is not None:
+            prop = EncryptionConfiguration.from_api_repr(prop)
+        return prop
+
+    @destination_encryption_configuration.setter
+    def destination_encryption_configuration(self, value):
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+        self._set_sub_prop("destinationEncryptionConfiguration", api_repr)
+
+    @property
+    def allow_large_results(self):
+        """bool: Allow large query results tables (legacy SQL, only)
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.allowLargeResults
+        """
+        return self._get_sub_prop("allowLargeResults")
+
+    @allow_large_results.setter
+    def allow_large_results(self, value):
+        self._set_sub_prop("allowLargeResults", value)
+
+    @property
+    def create_disposition(self):
+        """google.cloud.bigquery.job.CreateDisposition: Specifies behavior
+        for creating tables.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.createDisposition
+        """
+        return self._get_sub_prop("createDisposition")
+
+    @create_disposition.setter
+    def create_disposition(self, value):
+        self._set_sub_prop("createDisposition", value)
+
+    @property
+    def default_dataset(self):
+        """google.cloud.bigquery.dataset.DatasetReference: the default dataset
+        to use for unqualified table names in the query or :data:`None` if not
+        set.
+
+        The ``default_dataset`` setter accepts:
+
+        - a :class:`~google.cloud.bigquery.dataset.Dataset`, or
+        - a :class:`~google.cloud.bigquery.dataset.DatasetReference`, or
+        - a :class:`str` of the fully-qualified dataset ID in standard SQL
+          format. The value must included a project ID and dataset ID
+          separated by ``.``. For example: ``your-project.your_dataset``.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/v2/jobs#configuration.query.defaultDataset
+        """
+        prop = self._get_sub_prop("defaultDataset")
+        if prop is not None:
+            prop = DatasetReference.from_api_repr(prop)
+        return prop
+
+    @default_dataset.setter
+    def default_dataset(self, value):
+        if value is None:
+            self._set_sub_prop("defaultDataset", None)
+            return
+
+        if isinstance(value, six.string_types):
+            value = DatasetReference.from_string(value)
+
+        if isinstance(value, (Dataset, DatasetListItem)):
+            value = value.reference
+
+        resource = value.to_api_repr()
+        self._set_sub_prop("defaultDataset", resource)
+
+    @property
+    def destination(self):
+        """google.cloud.bigquery.table.TableReference: table where results are
+        written or :data:`None` if not set.
+
+        The ``destination`` setter accepts:
+
+        - a :class:`~google.cloud.bigquery.table.Table`, or
+        - a :class:`~google.cloud.bigquery.table.TableReference`, or
+        - a :class:`str` of the fully-qualified table ID in standard SQL
+          format. The value must included a project ID, dataset ID, and table
+          ID, each separated by ``.``. For example:
+          ``your-project.your_dataset.your_table``.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.destinationTable
+        """
+        prop = self._get_sub_prop("destinationTable")
+        if prop is not None:
+            prop = TableReference.from_api_repr(prop)
+        return prop
+
+    @destination.setter
+    def destination(self, value):
+        if value is None:
+            self._set_sub_prop("destinationTable", None)
+            return
+
+        value = _table_arg_to_table_ref(value)
+        resource = value.to_api_repr()
+        self._set_sub_prop("destinationTable", resource)
+
+    @property
+    def dry_run(self):
+        """bool: :data:`True` if this query should be a dry run to estimate
+        costs.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/v2/jobs#configuration.dryRun
+        """
+        return self._properties.get("dryRun")
+
+    @dry_run.setter
+    def dry_run(self, value):
+        self._properties["dryRun"] = value
+
+    @property
+    def flatten_results(self):
+        """bool: Flatten nested/repeated fields in results. (Legacy SQL only)
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.flattenResults
+        """
+        return self._get_sub_prop("flattenResults")
+
+    @flatten_results.setter
+    def flatten_results(self, value):
+        self._set_sub_prop("flattenResults", value)
+
+    @property
+    def maximum_billing_tier(self):
+        """int: Deprecated. Changes the billing tier to allow high-compute
+        queries.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.maximumBillingTier
+        """
+        return self._get_sub_prop("maximumBillingTier")
+
+    @maximum_billing_tier.setter
+    def maximum_billing_tier(self, value):
+        self._set_sub_prop("maximumBillingTier", value)
+
+    @property
+    def maximum_bytes_billed(self):
+        """int: Maximum bytes to be billed for this job or :data:`None` if not set.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.maximumBytesBilled
+        """
+        return _helpers._int_or_none(self._get_sub_prop("maximumBytesBilled"))
+
+    @maximum_bytes_billed.setter
+    def maximum_bytes_billed(self, value):
+        self._set_sub_prop("maximumBytesBilled", str(value))
+
+    @property
+    def priority(self):
+        """google.cloud.bigquery.job.QueryPriority: Priority of the query.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.priority
+        """
+        return self._get_sub_prop("priority")
+
+    @priority.setter
+    def priority(self, value):
+        self._set_sub_prop("priority", value)
+
+    @property
+    def query_parameters(self):
+        """List[Union[google.cloud.bigquery.query.ArrayQueryParameter, \
+        google.cloud.bigquery.query.ScalarQueryParameter, \
+        google.cloud.bigquery.query.StructQueryParameter]]: list of parameters
+        for parameterized query (empty by default)
+
+        See:
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.queryParameters
+        """
+        prop = self._get_sub_prop("queryParameters", default=[])
+        return _from_api_repr_query_parameters(prop)
+
+    @query_parameters.setter
+    def query_parameters(self, values):
+        self._set_sub_prop("queryParameters", _to_api_repr_query_parameters(values))
+
+    @property
+    def udf_resources(self):
+        """List[google.cloud.bigquery.query.UDFResource]: user
+        defined function resources (empty by default)
+
+        See:
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.userDefinedFunctionResources
+        """
+        prop = self._get_sub_prop("userDefinedFunctionResources", default=[])
+        return _from_api_repr_udf_resources(prop)
+
+    @udf_resources.setter
+    def udf_resources(self, values):
+        self._set_sub_prop(
+            "userDefinedFunctionResources", _to_api_repr_udf_resources(values)
+        )
+
+    @property
+    def use_legacy_sql(self):
+        """bool: Use legacy SQL syntax.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/v2/jobs#configuration.query.useLegacySql
+        """
+        return self._get_sub_prop("useLegacySql")
+
+    @use_legacy_sql.setter
+    def use_legacy_sql(self, value):
+        self._set_sub_prop("useLegacySql", value)
+
+    @property
+    def use_query_cache(self):
+        """bool: Look for the query result in the cache.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.useQueryCache
+        """
+        return self._get_sub_prop("useQueryCache")
+
+    @use_query_cache.setter
+    def use_query_cache(self, value):
+        self._set_sub_prop("useQueryCache", value)
+
+    @property
+    def write_disposition(self):
+        """google.cloud.bigquery.job.WriteDisposition: Action that occurs if
+        the destination table already exists.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.writeDisposition
+        """
+        return self._get_sub_prop("writeDisposition")
+
+    @write_disposition.setter
+    def write_disposition(self, value):
+        self._set_sub_prop("writeDisposition", value)
+
+    @property
+    def table_definitions(self):
+        """Dict[str, google.cloud.bigquery.external_config.ExternalConfig]:
+        Definitions for external tables or :data:`None` if not set.
+
+        See
+        https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions
+        """
+        prop = self._get_sub_prop("tableDefinitions")
+        if prop is not None:
+            prop = _from_api_repr_table_defs(prop)
+        return prop
+
+    @table_definitions.setter
+    def table_definitions(self, values):
+        self._set_sub_prop("tableDefinitions", _to_api_repr_table_defs(values))
+
+    @property
+    def time_partitioning(self):
+        """google.cloud.bigquery.table.TimePartitioning: Specifies time-based
+        partitioning for the destination table.
+        """
+        prop = self._get_sub_prop("timePartitioning")
+        if prop is not None:
+            prop = TimePartitioning.from_api_repr(prop)
+        return prop
+
+    @time_partitioning.setter
+    def time_partitioning(self, value):
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+        self._set_sub_prop("timePartitioning", api_repr)
+
+    @property
+    def clustering_fields(self):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+
+        Clustering fields are immutable after table creation.
+
+        .. note::
+
+           As of 2018-06-29, clustering fields cannot be set on a table
+           which does not also have time partioning defined.
+        """
+        prop = self._get_sub_prop("clustering")
+        if prop is not None:
+            return list(prop.get("fields", ()))
+
+    @clustering_fields.setter
+    def clustering_fields(self, value):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+        """
+        if value is not None:
+            self._set_sub_prop("clustering", {"fields": value})
+        else:
+            self._del_sub_prop("clustering")
+
+    @property
+    def schema_update_options(self):
+        """List[google.cloud.bigquery.job.SchemaUpdateOption]: Specifies
+        updates to the destination table schema to allow as a side effect of
+        the query job.
+        """
+        return self._get_sub_prop("schemaUpdateOptions")
+
+    @schema_update_options.setter
+    def schema_update_options(self, values):
+        self._set_sub_prop("schemaUpdateOptions", values)
+
+    def to_api_repr(self):
+        """Build an API representation of the query job config.
+
+        Returns:
+            dict: A dictionary in the format used by the BigQuery API.
+        """
+        resource = copy.deepcopy(self._properties)
+
+        # Query parameters have an addition property associated with them
+        # to indicate if the query is using named or positional parameters.
+        query_parameters = resource["query"].get("queryParameters")
+        if query_parameters:
+            if query_parameters[0].get("name") is None:
+                resource["query"]["parameterMode"] = "POSITIONAL"
+            else:
+                resource["query"]["parameterMode"] = "NAMED"
+
+        return resource
+
+
+class QueryJob(_AsyncJob):
+    """Asynchronous job: query tables.
+
+    :type job_id: str
+    :param job_id: the job's ID, within the project belonging to ``client``.
+
+    :type query: str
+    :param query: SQL query string
+
+    :type client: :class:`google.cloud.bigquery.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the dataset (which requires a project).
+
+    :type job_config: :class:`~google.cloud.bigquery.job.QueryJobConfig`
+    :param job_config:
+        (Optional) Extra configuration options for the query job.
+    """
+
+    _JOB_TYPE = "query"
+    _UDF_KEY = "userDefinedFunctionResources"
+
+    def __init__(self, job_id, query, client, job_config=None):
+        super(QueryJob, self).__init__(job_id, client)
+
+        if job_config is None:
+            job_config = QueryJobConfig()
+        if job_config.use_legacy_sql is None:
+            job_config.use_legacy_sql = False
+
+        _helpers._set_sub_prop(
+            self._properties, ["configuration", "query", "query"], query
+        )
+
+        self._configuration = job_config
+        self._query_results = None
+        self._done_timeout = None
+
+    @property
+    def allow_large_results(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.allow_large_results`.
+        """
+        return self._configuration.allow_large_results
+
+    @property
+    def create_disposition(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.create_disposition`.
+        """
+        return self._configuration.create_disposition
+
+    @property
+    def default_dataset(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.default_dataset`.
+        """
+        return self._configuration.default_dataset
+
+    @property
+    def destination(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.destination`.
+        """
+        return self._configuration.destination
+
+    @property
+    def destination_encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the destination table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys) or :data:`None`
+        if using default encryption.
+
+        See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.destination_encryption_configuration`.
+        """
+        return self._configuration.destination_encryption_configuration
+
+    @property
+    def dry_run(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.dry_run`.
+        """
+        return self._configuration.dry_run
+
+    @property
+    def flatten_results(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.flatten_results`.
+        """
+        return self._configuration.flatten_results
+
+    @property
+    def priority(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.priority`.
+        """
+        return self._configuration.priority
+
+    @property
+    def query(self):
+        """str: The query text used in this query job.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.query
+        """
+        return _helpers._get_sub_prop(
+            self._properties, ["configuration", "query", "query"]
+        )
+
+    @property
+    def query_parameters(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.query_parameters`.
+        """
+        return self._configuration.query_parameters
+
+    @property
+    def udf_resources(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.udf_resources`.
+        """
+        return self._configuration.udf_resources
+
+    @property
+    def use_legacy_sql(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.use_legacy_sql`.
+        """
+        return self._configuration.use_legacy_sql
+
+    @property
+    def use_query_cache(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.use_query_cache`.
+        """
+        return self._configuration.use_query_cache
+
+    @property
+    def write_disposition(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.write_disposition`.
+        """
+        return self._configuration.write_disposition
+
+    @property
+    def maximum_billing_tier(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.maximum_billing_tier`.
+        """
+        return self._configuration.maximum_billing_tier
+
+    @property
+    def maximum_bytes_billed(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.maximum_bytes_billed`.
+        """
+        return self._configuration.maximum_bytes_billed
+
+    @property
+    def table_definitions(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.table_definitions`.
+        """
+        return self._configuration.table_definitions
+
+    @property
+    def time_partitioning(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.time_partitioning`.
+        """
+        return self._configuration.time_partitioning
+
+    @property
+    def clustering_fields(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.clustering_fields`.
+        """
+        return self._configuration.clustering_fields
+
+    @property
+    def schema_update_options(self):
+        """See
+        :attr:`google.cloud.bigquery.job.QueryJobConfig.schema_update_options`.
+        """
+        return self._configuration.schema_update_options
+
+    def to_api_repr(self):
+        """Generate a resource for :meth:`_begin`."""
+        configuration = self._configuration.to_api_repr()
+
+        resource = {
+            "jobReference": self._properties["jobReference"],
+            "configuration": configuration,
+        }
+        configuration["query"]["query"] = self.query
+
+        return resource
+
+    def _copy_configuration_properties(self, configuration):
+        """Helper:  assign subclass configuration properties in cleaned."""
+        self._configuration._properties = copy.deepcopy(configuration)
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a job given its API representation
+
+        :type resource: dict
+        :param resource: dataset job representation returned from the API
+
+        :type client: :class:`google.cloud.bigquery.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the dataset.
+
+        :rtype: :class:`google.cloud.bigquery.job.QueryJob`
+        :returns: Job parsed from ``resource``.
+        """
+        job_id, config = cls._get_resource_config(resource)
+        query = _helpers._get_sub_prop(config, ["query", "query"])
+        job = cls(job_id, query, client=client)
+        job._set_properties(resource)
+        return job
+
+    @property
+    def query_plan(self):
+        """Return query plan from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.queryPlan
+
+        :rtype: list of :class:`QueryPlanEntry`
+        :returns: mappings describing the query plan, or an empty list
+                  if the query has not yet completed.
+        """
+        plan_entries = self._job_statistics().get("queryPlan", ())
+        return [QueryPlanEntry.from_api_repr(entry) for entry in plan_entries]
+
+    @property
+    def timeline(self):
+        """List(TimelineEntry): Return the query execution timeline
+        from job statistics.
+        """
+        raw = self._job_statistics().get("timeline", ())
+        return [TimelineEntry.from_api_repr(entry) for entry in raw]
+
+    @property
+    def total_bytes_processed(self):
+        """Return total bytes processed from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.totalBytesProcessed
+
+        :rtype: int or None
+        :returns: total bytes processed by the job, or None if job is not
+                  yet complete.
+        """
+        result = self._job_statistics().get("totalBytesProcessed")
+        if result is not None:
+            result = int(result)
+        return result
+
+    @property
+    def total_bytes_billed(self):
+        """Return total bytes billed from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.totalBytesBilled
+
+        :rtype: int or None
+        :returns: total bytes processed by the job, or None if job is not
+                  yet complete.
+        """
+        result = self._job_statistics().get("totalBytesBilled")
+        if result is not None:
+            result = int(result)
+        return result
+
+    @property
+    def billing_tier(self):
+        """Return billing tier from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.billingTier
+
+        :rtype: int or None
+        :returns: billing tier used by the job, or None if job is not
+                  yet complete.
+        """
+        return self._job_statistics().get("billingTier")
+
+    @property
+    def cache_hit(self):
+        """Return whether or not query results were served from cache.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.cacheHit
+
+        :rtype: bool or None
+        :returns: whether the query results were returned from cache, or None
+                  if job is not yet complete.
+        """
+        return self._job_statistics().get("cacheHit")
+
+    @property
+    def ddl_operation_performed(self):
+        """Optional[str]: Return the DDL operation performed.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.ddlOperationPerformed
+
+        """
+        return self._job_statistics().get("ddlOperationPerformed")
+
+    @property
+    def ddl_target_routine(self):
+        """Optional[google.cloud.bigquery.routine.RoutineReference]: Return the DDL target routine, present
+            for CREATE/DROP FUNCTION/PROCEDURE  queries.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/JobStatistics
+        """
+        prop = self._job_statistics().get("ddlTargetRoutine")
+        if prop is not None:
+            prop = RoutineReference.from_api_repr(prop)
+        return prop
+
+    @property
+    def ddl_target_table(self):
+        """Optional[google.cloud.bigquery.table.TableReference]: Return the DDL target table, present
+            for CREATE/DROP TABLE/VIEW queries.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.ddlTargetTable
+        """
+        prop = self._job_statistics().get("ddlTargetTable")
+        if prop is not None:
+            prop = TableReference.from_api_repr(prop)
+        return prop
+
+    @property
+    def num_dml_affected_rows(self):
+        """Return the number of DML rows affected by the job.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.numDmlAffectedRows
+
+        :rtype: int or None
+        :returns: number of DML rows affected by the job, or None if job is not
+                  yet complete.
+        """
+        result = self._job_statistics().get("numDmlAffectedRows")
+        if result is not None:
+            result = int(result)
+        return result
+
+    @property
+    def slot_millis(self):
+        """Union[int, None]: Slot-milliseconds used by this query job."""
+        return _helpers._int_or_none(self._job_statistics().get("totalSlotMs"))
+
+    @property
+    def statement_type(self):
+        """Return statement type from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.statementType
+
+        :rtype: str or None
+        :returns: type of statement used by the job, or None if job is not
+                  yet complete.
+        """
+        return self._job_statistics().get("statementType")
+
+    @property
+    def referenced_tables(self):
+        """Return referenced tables from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.referencedTables
+
+        :rtype: list of dict
+        :returns: mappings describing the query plan, or an empty list
+                  if the query has not yet completed.
+        """
+        tables = []
+        datasets_by_project_name = {}
+
+        for table in self._job_statistics().get("referencedTables", ()):
+
+            t_project = table["projectId"]
+
+            ds_id = table["datasetId"]
+            t_dataset = datasets_by_project_name.get((t_project, ds_id))
+            if t_dataset is None:
+                t_dataset = DatasetReference(t_project, ds_id)
+                datasets_by_project_name[(t_project, ds_id)] = t_dataset
+
+            t_name = table["tableId"]
+            tables.append(t_dataset.table(t_name))
+
+        return tables
+
+    @property
+    def undeclared_query_parameters(self):
+        """Return undeclared query parameters from job statistics, if present.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.undeclaredQueryParameters
+
+        :rtype:
+            list of
+            :class:`~google.cloud.bigquery.ArrayQueryParameter`,
+            :class:`~google.cloud.bigquery.ScalarQueryParameter`, or
+            :class:`~google.cloud.bigquery.StructQueryParameter`
+        :returns: undeclared parameters, or an empty list if the query has
+                  not yet completed.
+        """
+        parameters = []
+        undeclared = self._job_statistics().get("undeclaredQueryParameters", ())
+
+        for parameter in undeclared:
+            p_type = parameter["parameterType"]
+
+            if "arrayType" in p_type:
+                klass = ArrayQueryParameter
+            elif "structTypes" in p_type:
+                klass = StructQueryParameter
+            else:
+                klass = ScalarQueryParameter
+
+            parameters.append(klass.from_api_repr(parameter))
+
+        return parameters
+
+    @property
+    def estimated_bytes_processed(self):
+        """Return the estimated number of bytes processed by the query.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#statistics.query.estimatedBytesProcessed
+
+        :rtype: int or None
+        :returns: number of DML rows affected by the job, or None if job is not
+                  yet complete.
+        """
+        result = self._job_statistics().get("estimatedBytesProcessed")
+        if result is not None:
+            result = int(result)
+        return result
+
+    def done(self, retry=DEFAULT_RETRY):
+        """Refresh the job and checks if it is complete.
+
+        :rtype: bool
+        :returns: True if the job is complete, False otherwise.
+        """
+        # Since the API to getQueryResults can hang up to the timeout value
+        # (default of 10 seconds), set the timeout parameter to ensure that
+        # the timeout from the futures API is respected. See:
+        # https://github.com/GoogleCloudPlatform/google-cloud-python/issues/4135
+        timeout_ms = None
+        if self._done_timeout is not None:
+            # Subtract a buffer for context switching, network latency, etc.
+            timeout = self._done_timeout - _TIMEOUT_BUFFER_SECS
+            timeout = max(min(timeout, 10), 0)
+            self._done_timeout -= timeout
+            self._done_timeout = max(0, self._done_timeout)
+            timeout_ms = int(timeout * 1000)
+
+        # Do not refresh is the state is already done, as the job will not
+        # change once complete.
+        if self.state != _DONE_STATE:
+            self._query_results = self._client._get_query_results(
+                self.job_id,
+                retry,
+                project=self.project,
+                timeout_ms=timeout_ms,
+                location=self.location,
+            )
+
+            # Only reload the job once we know the query is complete.
+            # This will ensure that fields such as the destination table are
+            # correctly populated.
+            if self._query_results.complete:
+                self.reload(retry=retry)
+
+        return self.state == _DONE_STATE
+
+    def _blocking_poll(self, timeout=None):
+        self._done_timeout = timeout
+        super(QueryJob, self)._blocking_poll(timeout=timeout)
+
+    @staticmethod
+    def _format_for_exception(query, job_id):
+        """Format a query for the output in exception message.
+
+        Args:
+            query (str): The SQL query to format.
+            job_id (str): The ID of the job that ran the query.
+
+        Returns: (str)
+            A formatted query text.
+        """
+        template = "\n\n(job ID: {job_id})\n\n{header}\n\n{ruler}\n{body}\n{ruler}"
+
+        lines = query.splitlines()
+        max_line_len = max(len(l) for l in lines)
+
+        header = "-----Query Job SQL Follows-----"
+        header = "{:^{total_width}}".format(header, total_width=max_line_len + 5)
+
+        # Print out a "ruler" above and below the SQL so we can judge columns.
+        # Left pad for the line numbers (4 digits plus ":").
+        ruler = "    |" + "    .    |" * (max_line_len // 10)
+
+        # Put line numbers next to the SQL.
+        body = "\n".join(
+            "{:4}:{}".format(n, line) for n, line in enumerate(lines, start=1)
+        )
+
+        return template.format(job_id=job_id, header=header, ruler=ruler, body=body)
+
+    def _begin(self, client=None, retry=DEFAULT_RETRY):
+        """API call:  begin the job via a POST request
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert
+
+        Args:
+            client (Optional[google.cloud.bigquery.client.Client]):
+                The client to use. If not passed, falls back to the ``client``
+                associated with the job object or``NoneType``.
+            retry (Optional[google.api_core.retry.Retry]):
+                How to retry the RPC.
+
+        Raises:
+            ValueError:
+                If the job has already begun.
+        """
+
+        try:
+            super(QueryJob, self)._begin(client=client, retry=retry)
+        except exceptions.GoogleCloudError as exc:
+            exc.message += self._format_for_exception(self.query, self.job_id)
+            raise
+
+    def result(self, timeout=None, page_size=None, retry=DEFAULT_RETRY):
+        """Start the job and wait for it to complete and get the result.
+
+        Args:
+            timeout (float):
+                How long (in seconds) to wait for job to complete before
+                raising a :class:`concurrent.futures.TimeoutError`.
+            page_size (int):
+                (Optional) The maximum number of rows in each page of results
+                from this request. Non-positive values are ignored.
+            retry (google.api_core.retry.Retry):
+                (Optional) How to retry the call that retrieves rows.
+
+        Returns:
+            google.cloud.bigquery.table.RowIterator:
+                Iterator of row data
+                :class:`~google.cloud.bigquery.table.Row`-s. During each
+                page, the iterator will have the ``total_rows`` attribute
+                set, which counts the total number of rows **in the result
+                set** (this is distinct from the total number of rows in the
+                current page: ``iterator.page.num_items``).
+
+        Raises:
+            google.cloud.exceptions.GoogleCloudError:
+                If the job failed.
+            concurrent.futures.TimeoutError:
+                If the job did not complete in the given timeout.
+        """
+        try:
+            super(QueryJob, self).result(timeout=timeout)
+
+            # Return an iterator instead of returning the job.
+            if not self._query_results:
+                self._query_results = self._client._get_query_results(
+                    self.job_id, retry, project=self.project, location=self.location
+                )
+        except exceptions.GoogleCloudError as exc:
+            exc.message += self._format_for_exception(self.query, self.job_id)
+            raise
+
+        # If the query job is complete but there are no query results, this was
+        # special job, such as a DDL query. Return an empty result set to
+        # indicate success and avoid calling tabledata.list on a table which
+        # can't be read (such as a view table).
+        if self._query_results.total_rows is None:
+            return _EmptyRowIterator()
+
+        schema = self._query_results.schema
+        dest_table_ref = self.destination
+        dest_table = Table(dest_table_ref, schema=schema)
+        dest_table._properties["numRows"] = self._query_results.total_rows
+        rows = self._client.list_rows(dest_table, page_size=page_size, retry=retry)
+        rows._preserve_order = _contains_order_by(self.query)
+        return rows
+
+    # If changing the signature of this method, make sure to apply the same
+    # changes to table.RowIterator.to_arrow()
+    def to_arrow(self, progress_bar_type=None, bqstorage_client=None):
+        """[Beta] Create a class:`pyarrow.Table` by loading all pages of a
+        table or query.
+
+        Args:
+            progress_bar_type (Optional[str]):
+                If set, use the `tqdm <https://tqdm.github.io/>`_ library to
+                display a progress bar while the data downloads. Install the
+                ``tqdm`` package to use this feature.
+
+                Possible values of ``progress_bar_type`` include:
+
+                ``None``
+                  No progress bar.
+                ``'tqdm'``
+                  Use the :func:`tqdm.tqdm` function to print a progress bar
+                  to :data:`sys.stderr`.
+                ``'tqdm_notebook'``
+                  Use the :func:`tqdm.tqdm_notebook` function to display a
+                  progress bar as a Jupyter notebook widget.
+                ``'tqdm_gui'``
+                  Use the :func:`tqdm.tqdm_gui` function to display a
+                  progress bar as a graphical dialog box.
+            bqstorage_client ( \
+                google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient \
+            ):
+                **Beta Feature** Optional. A BigQuery Storage API client. If
+                supplied, use the faster BigQuery Storage API to fetch rows
+                from BigQuery. This API is a billable API.
+
+                This method requires the ``pyarrow`` and
+                ``google-cloud-bigquery-storage`` libraries.
+
+                Reading from a specific partition or snapshot is not
+                currently supported by this method.
+
+        Returns:
+            pyarrow.Table
+                A :class:`pyarrow.Table` populated with row data and column
+                headers from the query results. The column headers are derived
+                from the destination table's schema.
+
+        Raises:
+            ValueError:
+                If the :mod:`pyarrow` library cannot be imported.
+
+        ..versionadded:: 1.17.0
+        """
+        return self.result().to_arrow(
+            progress_bar_type=progress_bar_type, bqstorage_client=bqstorage_client
+        )
+
+    # If changing the signature of this method, make sure to apply the same
+    # changes to table.RowIterator.to_dataframe()
+    def to_dataframe(self, bqstorage_client=None, dtypes=None, progress_bar_type=None):
+        """Return a pandas DataFrame from a QueryJob
+
+        Args:
+            bqstorage_client ( \
+                google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient \
+            ):
+                **Alpha Feature** Optional. A BigQuery Storage API client. If
+                supplied, use the faster BigQuery Storage API to fetch rows
+                from BigQuery. This API is a billable API.
+
+                This method requires the ``fastavro`` and
+                ``google-cloud-bigquery-storage`` libraries.
+
+                Reading from a specific partition or snapshot is not
+                currently supported by this method.
+
+                **Caution**: There is a known issue reading small anonymous
+                query result tables with the BQ Storage API. Write your query
+                results to a destination table to work around this issue.
+            dtypes ( \
+                Map[str, Union[str, pandas.Series.dtype]] \
+            ):
+                Optional. A dictionary of column names pandas ``dtype``s. The
+                provided ``dtype`` is used when constructing the series for
+                the column specified. Otherwise, the default pandas behavior
+                is used.
+            progress_bar_type (Optional[str]):
+                If set, use the `tqdm <https://tqdm.github.io/>`_ library to
+                display a progress bar while the data downloads. Install the
+                ``tqdm`` package to use this feature.
+
+                See
+                :func:`~google.cloud.bigquery.table.RowIterator.to_dataframe`
+                for details.
+
+                ..versionadded:: 1.11.0
+
+        Returns:
+            A :class:`~pandas.DataFrame` populated with row data and column
+            headers from the query results. The column headers are derived
+            from the destination table's schema.
+
+        Raises:
+            ValueError: If the `pandas` library cannot be imported.
+        """
+        return self.result().to_dataframe(
+            bqstorage_client=bqstorage_client,
+            dtypes=dtypes,
+            progress_bar_type=progress_bar_type,
+        )
+
+    def __iter__(self):
+        return iter(self.result())
+
+
+class QueryPlanEntryStep(object):
+    """Map a single step in a query plan entry.
+
+    :type kind: str
+    :param kind: step type
+
+    :type substeps:
+    :param substeps: names of substeps
+    """
+
+    def __init__(self, kind, substeps):
+        self.kind = kind
+        self.substeps = list(substeps)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct instance from the JSON repr.
+
+        :type resource: dict
+        :param resource: JSON representation of the entry
+
+        :rtype: :class:`QueryPlanEntryStep`
+        :return: new instance built from the resource
+        """
+        return cls(kind=resource.get("kind"), substeps=resource.get("substeps", ()))
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self.kind == other.kind and self.substeps == other.substeps
+
+
+class QueryPlanEntry(object):
+    """QueryPlanEntry represents a single stage of a query execution plan.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs
+    for the underlying API representation within query statistics.
+
+    """
+
+    def __init__(self):
+        self._properties = {}
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct instance from the JSON repr.
+
+        Args:
+            resource(Dict[str: object]):
+                ExplainQueryStage representation returned from API
+
+        Returns:
+            google.cloud.bigquery.QueryPlanEntry:
+                Query plan entry parsed from ``resource``
+        """
+        entry = cls()
+        entry._properties = resource
+        return entry
+
+    @property
+    def name(self):
+        """Union[str, None]: Human-readable name of the stage."""
+        return self._properties.get("name")
+
+    @property
+    def entry_id(self):
+        """Union[str, None]: Unique ID for the stage within the plan."""
+        return self._properties.get("id")
+
+    @property
+    def start(self):
+        """Union[Datetime, None]: Datetime when the stage started."""
+        if self._properties.get("startMs") is None:
+            return None
+        return _helpers._datetime_from_microseconds(
+            int(self._properties.get("startMs")) * 1000.0
+        )
+
+    @property
+    def end(self):
+        """Union[Datetime, None]: Datetime when the stage ended."""
+        if self._properties.get("endMs") is None:
+            return None
+        return _helpers._datetime_from_microseconds(
+            int(self._properties.get("endMs")) * 1000.0
+        )
+
+    @property
+    def input_stages(self):
+        """List(int): Entry IDs for stages that were inputs for this stage."""
+        if self._properties.get("inputStages") is None:
+            return []
+        return [
+            _helpers._int_or_none(entry)
+            for entry in self._properties.get("inputStages")
+        ]
+
+    @property
+    def parallel_inputs(self):
+        """Union[int, None]: Number of parallel input segments within
+        the stage.
+        """
+        return _helpers._int_or_none(self._properties.get("parallelInputs"))
+
+    @property
+    def completed_parallel_inputs(self):
+        """Union[int, None]: Number of parallel input segments completed."""
+        return _helpers._int_or_none(self._properties.get("completedParallelInputs"))
+
+    @property
+    def wait_ms_avg(self):
+        """Union[int, None]: Milliseconds the average worker spent waiting to
+        be scheduled.
+        """
+        return _helpers._int_or_none(self._properties.get("waitMsAvg"))
+
+    @property
+    def wait_ms_max(self):
+        """Union[int, None]: Milliseconds the slowest worker spent waiting to
+        be scheduled.
+        """
+        return _helpers._int_or_none(self._properties.get("waitMsMax"))
+
+    @property
+    def wait_ratio_avg(self):
+        """Union[float, None]: Ratio of time the average worker spent waiting
+        to be scheduled, relative to the longest time spent by any worker in
+        any stage of the overall plan.
+        """
+        return self._properties.get("waitRatioAvg")
+
+    @property
+    def wait_ratio_max(self):
+        """Union[float, None]: Ratio of time the slowest worker spent waiting
+        to be scheduled, relative to the longest time spent by any worker in
+        any stage of the overall plan.
+        """
+        return self._properties.get("waitRatioMax")
+
+    @property
+    def read_ms_avg(self):
+        """Union[int, None]: Milliseconds the average worker spent reading
+        input.
+        """
+        return _helpers._int_or_none(self._properties.get("readMsAvg"))
+
+    @property
+    def read_ms_max(self):
+        """Union[int, None]: Milliseconds the slowest worker spent reading
+        input.
+        """
+        return _helpers._int_or_none(self._properties.get("readMsMax"))
+
+    @property
+    def read_ratio_avg(self):
+        """Union[float, None]: Ratio of time the average worker spent reading
+        input, relative to the longest time spent by any worker in any stage
+        of the overall plan.
+        """
+        return self._properties.get("readRatioAvg")
+
+    @property
+    def read_ratio_max(self):
+        """Union[float, None]: Ratio of time the slowest worker spent reading
+        to be scheduled, relative to the longest time spent by any worker in
+        any stage of the overall plan.
+        """
+        return self._properties.get("readRatioMax")
+
+    @property
+    def compute_ms_avg(self):
+        """Union[int, None]: Milliseconds the average worker spent on CPU-bound
+        processing.
+        """
+        return _helpers._int_or_none(self._properties.get("computeMsAvg"))
+
+    @property
+    def compute_ms_max(self):
+        """Union[int, None]: Milliseconds the slowest worker spent on CPU-bound
+        processing.
+        """
+        return _helpers._int_or_none(self._properties.get("computeMsMax"))
+
+    @property
+    def compute_ratio_avg(self):
+        """Union[float, None]: Ratio of time the average worker spent on
+        CPU-bound processing, relative to the longest time spent by any
+        worker in any stage of the overall plan.
+        """
+        return self._properties.get("computeRatioAvg")
+
+    @property
+    def compute_ratio_max(self):
+        """Union[float, None]: Ratio of time the slowest worker spent on
+        CPU-bound processing, relative to the longest time spent by any
+        worker in any stage of the overall plan.
+        """
+        return self._properties.get("computeRatioMax")
+
+    @property
+    def write_ms_avg(self):
+        """Union[int, None]: Milliseconds the average worker spent writing
+        output data.
+        """
+        return _helpers._int_or_none(self._properties.get("writeMsAvg"))
+
+    @property
+    def write_ms_max(self):
+        """Union[int, None]: Milliseconds the slowest worker spent writing
+        output data.
+        """
+        return _helpers._int_or_none(self._properties.get("writeMsMax"))
+
+    @property
+    def write_ratio_avg(self):
+        """Union[float, None]: Ratio of time the average worker spent writing
+        output data, relative to the longest time spent by any worker in any
+        stage of the overall plan.
+        """
+        return self._properties.get("writeRatioAvg")
+
+    @property
+    def write_ratio_max(self):
+        """Union[float, None]: Ratio of time the slowest worker spent writing
+        output data, relative to the longest time spent by any worker in any
+        stage of the overall plan.
+        """
+        return self._properties.get("writeRatioMax")
+
+    @property
+    def records_read(self):
+        """Union[int, None]: Number of records read by this stage."""
+        return _helpers._int_or_none(self._properties.get("recordsRead"))
+
+    @property
+    def records_written(self):
+        """Union[int, None]: Number of records written by this stage."""
+        return _helpers._int_or_none(self._properties.get("recordsWritten"))
+
+    @property
+    def status(self):
+        """Union[str, None]: status of this stage."""
+        return self._properties.get("status")
+
+    @property
+    def shuffle_output_bytes(self):
+        """Union[int, None]: Number of bytes written by this stage to
+        intermediate shuffle.
+        """
+        return _helpers._int_or_none(self._properties.get("shuffleOutputBytes"))
+
+    @property
+    def shuffle_output_bytes_spilled(self):
+        """Union[int, None]: Number of bytes written by this stage to
+        intermediate shuffle and spilled to disk.
+        """
+        return _helpers._int_or_none(self._properties.get("shuffleOutputBytesSpilled"))
+
+    @property
+    def steps(self):
+        """List(QueryPlanEntryStep): List of step operations performed by
+        each worker in the stage.
+        """
+        return [
+            QueryPlanEntryStep.from_api_repr(step)
+            for step in self._properties.get("steps", [])
+        ]
+
+
+class TimelineEntry(object):
+    """TimelineEntry represents progress of a query job at a particular
+    point in time.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs
+    for the underlying API representation within query statistics.
+
+    """
+
+    def __init__(self):
+        self._properties = {}
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct instance from the JSON repr.
+
+        Args:
+            resource(Dict[str: object]):
+                QueryTimelineSample representation returned from API
+
+        Returns:
+            google.cloud.bigquery.TimelineEntry:
+                Timeline sample parsed from ``resource``
+        """
+        entry = cls()
+        entry._properties = resource
+        return entry
+
+    @property
+    def elapsed_ms(self):
+        """Union[int, None]: Milliseconds elapsed since start of query
+        execution."""
+        return _helpers._int_or_none(self._properties.get("elapsedMs"))
+
+    @property
+    def active_units(self):
+        """Union[int, None]: Current number of input units being processed
+        by workers, reported as largest value since the last sample."""
+        return _helpers._int_or_none(self._properties.get("activeUnits"))
+
+    @property
+    def pending_units(self):
+        """Union[int, None]: Current number of input units remaining for
+        query stages active at this sample time."""
+        return _helpers._int_or_none(self._properties.get("pendingUnits"))
+
+    @property
+    def completed_units(self):
+        """Union[int, None]: Current number of input units completed by
+        this query."""
+        return _helpers._int_or_none(self._properties.get("completedUnits"))
+
+    @property
+    def slot_millis(self):
+        """Union[int, None]: Cumulative slot-milliseconds consumed by
+        this query."""
+        return _helpers._int_or_none(self._properties.get("totalSlotMs"))
+
+
+class UnknownJob(_AsyncJob):
+    """A job whose type cannot be determined."""
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Construct an UnknownJob from the JSON representation.
+
+        Args:
+            resource (dict): JSON representation of a job.
+            client (google.cloud.bigquery.client.Client):
+                Client connected to BigQuery API.
+
+        Returns:
+            UnknownJob: Job corresponding to the resource.
+        """
+        job_ref_properties = resource.get("jobReference", {"projectId": client.project})
+        job_ref = _JobReference._from_api_repr(job_ref_properties)
+        job = cls(job_ref, client)
+        # Populate the job reference with the project, even if it has been
+        # redacted, because we know it should equal that of the request.
+        resource["jobReference"] = job_ref_properties
+        job._properties = resource
+        return job
diff --git a/bigquery/google/cloud/bigquery/magics.py b/bigquery/google/cloud/bigquery/magics.py
new file mode 100644
index 000000000000..b2dae2511ec8
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/magics.py
@@ -0,0 +1,494 @@
+# 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.
+
+"""IPython Magics
+
+.. function:: %%bigquery
+
+    IPython cell magic to run a query and display the result as a DataFrame
+
+    .. code-block:: python
+
+        %%bigquery [<destination_var>] [--project <project>] [--use_legacy_sql]
+                   [--verbose] [--params <params>]
+        <query>
+
+    Parameters:
+
+    * ``<destination_var>`` (optional, line argument):
+        variable to store the query results. The results are not displayed if
+        this parameter is used.
+    * ``--project <project>`` (optional, line argument):
+        Project to use for running the query. Defaults to the context
+        :attr:`~google.cloud.bigquery.magics.Context.project`.
+    * ``--use_bqstorage_api`` (optional, line argument):
+        Downloads the DataFrame using the BigQuery Storage API. To use this
+        option, install the ``google-cloud-bigquery-storage`` and ``fastavro``
+        packages, and `enable the BigQuery Storage API
+        <https://console.cloud.google.com/apis/library/bigquerystorage.googleapis.com>`_.
+    * ``--use_legacy_sql`` (optional, line argument):
+        Runs the query using Legacy SQL syntax. Defaults to Standard SQL if
+        this argument not used.
+    * ``--verbose`` (optional, line argument):
+        If this flag is used, information including the query job ID and the
+        amount of time for the query to complete will not be cleared after the
+        query is finished. By default, this information will be displayed but
+        will be cleared after the query is finished.
+    * ``--params <params>`` (optional, line argument):
+        If present, the argument following the ``--params`` flag must be
+        either:
+
+        * :class:`str` - A JSON string representation of a dictionary in the
+          format ``{"param_name": "param_value"}`` (ex. ``{"num": 17}``). Use
+          of the parameter in the query should be indicated with
+          ``@param_name``. See ``In[5]`` in the Examples section below.
+
+        * :class:`dict` reference - A reference to a ``dict`` in the format
+          ``{"param_name": "param_value"}``, where the value types must be JSON
+          serializable. The variable reference is indicated by a ``$`` before
+          the variable name (ex. ``$my_dict_var``). See ``In[6]`` and ``In[7]``
+          in the Examples section below.
+    * ``<query>`` (required, cell argument):
+        SQL query to run.
+
+    Returns:
+        A :class:`pandas.DataFrame` with the query results.
+
+    .. note::
+        All queries run using this magic will run using the context
+        :attr:`~google.cloud.bigquery.magics.Context.credentials`.
+
+    Examples:
+        The following examples can be run in an IPython notebook after loading
+        the bigquery IPython extension (see ``In[1]``) and setting up
+        Application Default Credentials.
+
+    .. code-block:: none
+
+        In [1]: %load_ext google.cloud.bigquery
+
+        In [2]: %%bigquery
+           ...: SELECT name, SUM(number) as count
+           ...: FROM `bigquery-public-data.usa_names.usa_1910_current`
+           ...: GROUP BY name
+           ...: ORDER BY count DESC
+           ...: LIMIT 3
+
+        Out[2]:       name    count
+           ...: -------------------
+           ...: 0    James  4987296
+           ...: 1     John  4866302
+           ...: 2   Robert  4738204
+
+        In [3]: %%bigquery df --project my-alternate-project --verbose
+           ...: SELECT name, SUM(number) as count
+           ...: FROM `bigquery-public-data.usa_names.usa_1910_current`
+           ...: WHERE gender = 'F'
+           ...: GROUP BY name
+           ...: ORDER BY count DESC
+           ...: LIMIT 3
+        Executing query with job ID: bf633912-af2c-4780-b568-5d868058632b
+        Query executing: 2.61s
+        Query complete after 2.92s
+
+        In [4]: df
+
+        Out[4]:          name    count
+           ...: ----------------------
+           ...: 0        Mary  3736239
+           ...: 1    Patricia  1568495
+           ...: 2   Elizabeth  1519946
+
+        In [5]: %%bigquery --params {"num": 17}
+           ...: SELECT @num AS num
+
+        Out[5]:     num
+           ...: -------
+           ...: 0    17
+
+        In [6]: params = {"num": 17}
+
+        In [7]: %%bigquery --params $params
+           ...: SELECT @num AS num
+
+        Out[7]:     num
+           ...: -------
+           ...: 0    17
+"""
+
+from __future__ import print_function
+
+import ast
+import sys
+import time
+from concurrent import futures
+
+try:
+    import IPython
+    from IPython import display
+    from IPython.core import magic_arguments
+except ImportError:  # pragma: NO COVER
+    raise ImportError("This module can only be loaded in IPython.")
+
+from google.api_core import client_info
+import google.auth
+from google.cloud import bigquery
+from google.cloud.bigquery.dbapi import _helpers
+import six
+
+
+IPYTHON_USER_AGENT = "ipython-{}".format(IPython.__version__)
+
+
+class Context(object):
+    """Storage for objects to be used throughout an IPython notebook session.
+
+    A Context object is initialized when the ``magics`` module is imported,
+    and can be found at ``google.cloud.bigquery.magics.context``.
+    """
+
+    def __init__(self):
+        self._credentials = None
+        self._project = None
+        self._connection = None
+        self._use_bqstorage_api = None
+        self._default_query_job_config = bigquery.QueryJobConfig()
+
+    @property
+    def credentials(self):
+        """google.auth.credentials.Credentials: Credentials to use for queries
+        performed through IPython magics
+
+        Note:
+            These credentials do not need to be explicitly defined if you are
+            using Application Default Credentials. If you are not using
+            Application Default Credentials, manually construct a
+            :class:`google.auth.credentials.Credentials` object and set it as
+            the context credentials as demonstrated in the example below. See
+            `auth docs`_ for more information on obtaining credentials.
+
+        Example:
+            Manually setting the context credentials:
+
+            >>> from google.cloud.bigquery import magics
+            >>> from google.oauth2 import service_account
+            >>> credentials = (service_account
+            ...     .Credentials.from_service_account_file(
+            ...         '/path/to/key.json'))
+            >>> magics.context.credentials = credentials
+
+
+        .. _auth docs: http://google-auth.readthedocs.io
+            /en/latest/user-guide.html#obtaining-credentials
+        """
+        if self._credentials is None:
+            self._credentials, _ = google.auth.default()
+        return self._credentials
+
+    @credentials.setter
+    def credentials(self, value):
+        self._credentials = value
+
+    @property
+    def project(self):
+        """str: Default project to use for queries performed through IPython
+        magics
+
+        Note:
+            The project does not need to be explicitly defined if you have an
+            environment default project set. If you do not have a default
+            project set in your environment, manually assign the project as
+            demonstrated in the example below.
+
+        Example:
+            Manually setting the context project:
+
+            >>> from google.cloud.bigquery import magics
+            >>> magics.context.project = 'my-project'
+        """
+        if self._project is None:
+            _, self._project = google.auth.default()
+        return self._project
+
+    @project.setter
+    def project(self, value):
+        self._project = value
+
+    @property
+    def use_bqstorage_api(self):
+        """bool: [Beta] Set to True to use the BigQuery Storage API to
+        download query results
+
+        To use this option, install the ``google-cloud-bigquery-storage`` and
+        ``fastavro`` packages, and `enable the BigQuery Storage API
+        <https://console.cloud.google.com/apis/library/bigquerystorage.googleapis.com>`_.
+        """
+        return self._use_bqstorage_api
+
+    @use_bqstorage_api.setter
+    def use_bqstorage_api(self, value):
+        self._use_bqstorage_api = value
+
+    @property
+    def default_query_job_config(self):
+        """google.cloud.bigquery.job.QueryJobConfig: Default job
+        configuration for queries.
+
+        The context's :class:`~google.cloud.bigquery.job.QueryJobConfig` is
+        used for queries. Some properties can be overridden with arguments to
+        the magics.
+
+        Example:
+            Manually setting the default value for ``maximum_bytes_billed``
+            to 100 MB:
+
+            >>> from google.cloud.bigquery import magics
+            >>> magics.context.default_query_job_config.maximum_bytes_billed = 100000000
+        """
+        return self._default_query_job_config
+
+    @default_query_job_config.setter
+    def default_query_job_config(self, value):
+        self._default_query_job_config = value
+
+
+context = Context()
+
+
+def _run_query(client, query, job_config=None):
+    """Runs a query while printing status updates
+
+    Args:
+        client (google.cloud.bigquery.client.Client):
+            Client to bundle configuration needed for API requests.
+        query (str):
+            SQL query to be executed. Defaults to the standard SQL dialect.
+            Use the ``job_config`` parameter to change dialects.
+        job_config (google.cloud.bigquery.job.QueryJobConfig, optional):
+            Extra configuration options for the job.
+
+    Returns:
+        google.cloud.bigquery.job.QueryJob: the query job created
+
+    Example:
+        >>> client = bigquery.Client()
+        >>> _run_query(client, "SELECT 17")
+        Executing query with job ID: bf633912-af2c-4780-b568-5d868058632b
+        Query executing: 1.66s
+        Query complete after 2.07s
+        'bf633912-af2c-4780-b568-5d868058632b'
+    """
+    start_time = time.time()
+    query_job = client.query(query, job_config=job_config)
+
+    if job_config and job_config.dry_run:
+        return query_job
+
+    print("Executing query with job ID: {}".format(query_job.job_id))
+
+    while True:
+        print("\rQuery executing: {:0.2f}s".format(time.time() - start_time), end="")
+        try:
+            query_job.result(timeout=0.5)
+            break
+        except futures.TimeoutError:
+            continue
+    print("\nQuery complete after {:0.2f}s".format(time.time() - start_time))
+    return query_job
+
+
+@magic_arguments.magic_arguments()
+@magic_arguments.argument(
+    "destination_var",
+    nargs="?",
+    help=("If provided, save the output to this variable instead of displaying it."),
+)
+@magic_arguments.argument(
+    "--project",
+    type=str,
+    default=None,
+    help=("Project to use for executing this query. Defaults to the context project."),
+)
+@magic_arguments.argument(
+    "--maximum_bytes_billed",
+    default=None,
+    help=(
+        "maximum_bytes_billed to use for executing this query. Defaults to "
+        "the context default_query_job_config.maximum_bytes_billed."
+    ),
+)
+@magic_arguments.argument(
+    "--dry_run",
+    action="store_true",
+    default=False,
+    help=(
+        "Sets query to be a dry run to estimate costs. "
+        "Defaults to executing the query instead of dry run if this argument is not used."
+    ),
+)
+@magic_arguments.argument(
+    "--use_legacy_sql",
+    action="store_true",
+    default=False,
+    help=(
+        "Sets query to use Legacy SQL instead of Standard SQL. Defaults to "
+        "Standard SQL if this argument is not used."
+    ),
+)
+@magic_arguments.argument(
+    "--use_bqstorage_api",
+    action="store_true",
+    default=False,
+    help=(
+        "[Beta] Use the BigQuery Storage API to download large query results. "
+        "To use this option, install the google-cloud-bigquery-storage and "
+        "fastavro packages, and enable the BigQuery Storage API."
+    ),
+)
+@magic_arguments.argument(
+    "--verbose",
+    action="store_true",
+    default=False,
+    help=(
+        "If set, print verbose output, including the query job ID and the "
+        "amount of time for the query to finish. By default, this "
+        "information will be displayed as the query runs, but will be "
+        "cleared after the query is finished."
+    ),
+)
+@magic_arguments.argument(
+    "--params",
+    nargs="+",
+    default=None,
+    help=(
+        "Parameters to format the query string. If present, the --params "
+        "flag should be followed by a string representation of a dictionary "
+        "in the format {'param_name': 'param_value'} (ex. {\"num\": 17}), "
+        "or a reference to a dictionary in the same format. The dictionary "
+        "reference can be made by including a '$' before the variable "
+        "name (ex. $my_dict_var)."
+    ),
+)
+def _cell_magic(line, query):
+    """Underlying function for bigquery cell magic
+
+    Note:
+        This function contains the underlying logic for the 'bigquery' cell
+        magic. This function is not meant to be called directly.
+
+    Args:
+        line (str): "%%bigquery" followed by arguments as required
+        query (str): SQL query to run
+
+    Returns:
+        pandas.DataFrame: the query results.
+    """
+    args = magic_arguments.parse_argstring(_cell_magic, line)
+
+    params = []
+    if args.params is not None:
+        try:
+            params = _helpers.to_query_parameters(
+                ast.literal_eval("".join(args.params))
+            )
+        except Exception:
+            raise SyntaxError(
+                "--params is not a correctly formatted JSON string or a JSON "
+                "serializable dictionary"
+            )
+
+    project = args.project or context.project
+    client = bigquery.Client(
+        project=project,
+        credentials=context.credentials,
+        default_query_job_config=context.default_query_job_config,
+        client_info=client_info.ClientInfo(user_agent=IPYTHON_USER_AGENT),
+    )
+    if context._connection:
+        client._connection = context._connection
+    bqstorage_client = _make_bqstorage_client(
+        args.use_bqstorage_api or context.use_bqstorage_api, context.credentials
+    )
+    job_config = bigquery.job.QueryJobConfig()
+    job_config.query_parameters = params
+    job_config.use_legacy_sql = args.use_legacy_sql
+    job_config.dry_run = args.dry_run
+
+    if args.maximum_bytes_billed == "None":
+        job_config.maximum_bytes_billed = 0
+    elif args.maximum_bytes_billed is not None:
+        value = int(args.maximum_bytes_billed)
+        job_config.maximum_bytes_billed = value
+
+    error = None
+    try:
+        query_job = _run_query(client, query, job_config)
+    except Exception as ex:
+        error = str(ex)
+
+    if not args.verbose:
+        display.clear_output()
+
+    if error:
+        if args.destination_var:
+            print(
+                "Could not save output to variable '{}'.".format(args.destination_var),
+                file=sys.stderr,
+            )
+        print("\nERROR:\n", error, file=sys.stderr)
+        return
+
+    if args.dry_run and args.destination_var:
+        IPython.get_ipython().push({args.destination_var: query_job})
+        return
+    elif args.dry_run:
+        print(
+            "Query validated. This query will process {} bytes.".format(
+                query_job.total_bytes_processed
+            )
+        )
+        return query_job
+
+    result = query_job.to_dataframe(bqstorage_client=bqstorage_client)
+    if args.destination_var:
+        IPython.get_ipython().push({args.destination_var: result})
+    else:
+        return result
+
+
+def _make_bqstorage_client(use_bqstorage_api, credentials):
+    if not use_bqstorage_api:
+        return None
+
+    try:
+        from google.cloud import bigquery_storage_v1beta1
+    except ImportError as err:
+        customized_error = ImportError(
+            "Install the google-cloud-bigquery-storage and pyarrow packages "
+            "to use the BigQuery Storage API."
+        )
+        six.raise_from(customized_error, err)
+
+    try:
+        from google.api_core.gapic_v1 import client_info as gapic_client_info
+    except ImportError as err:
+        customized_error = ImportError(
+            "Install the grpcio package to use the BigQuery Storage API."
+        )
+        six.raise_from(customized_error, err)
+
+    return bigquery_storage_v1beta1.BigQueryStorageClient(
+        credentials=credentials,
+        client_info=gapic_client_info.ClientInfo(user_agent=IPYTHON_USER_AGENT),
+    )
diff --git a/bigquery/google/cloud/bigquery/model.py b/bigquery/google/cloud/bigquery/model.py
new file mode 100644
index 000000000000..4049a9232467
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/model.py
@@ -0,0 +1,412 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define resources for the BigQuery ML Models API."""
+
+import copy
+
+from google.protobuf import json_format
+import six
+
+import google.cloud._helpers
+from google.api_core import datetime_helpers
+from google.cloud.bigquery import _helpers
+from google.cloud.bigquery_v2 import types
+
+
+class Model(object):
+    """Model represents a machine learning model resource.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/models
+
+    Args:
+        model_ref (Union[ \
+            :class:`~google.cloud.bigquery.model.ModelReference`, \
+            str, \
+        ]):
+            A pointer to a model. If ``model_ref`` is a string, it must
+            included a project ID, dataset ID, and model ID, each separated
+            by ``.``.
+    """
+
+    _PROPERTY_TO_API_FIELD = {
+        "expires": "expirationTime",
+        "friendly_name": "friendlyName",
+        # Even though it's not necessary for field mapping to map when the
+        # property name equals the resource name, we add these here so that we
+        # have an exhaustive list of all mutable properties.
+        "labels": "labels",
+        "description": "description",
+    }
+
+    def __init__(self, model_ref):
+        # Use _proto on read-only properties to use it's built-in type
+        # conversion.
+        self._proto = types.Model()
+
+        # Use _properties on read-write properties to match the REST API
+        # semantics. The BigQuery API makes a distinction between an unset
+        # value, a null value, and a default value (0 or ""), but the protocol
+        # buffer classes do not.
+        self._properties = {}
+
+        if isinstance(model_ref, six.string_types):
+            model_ref = ModelReference.from_string(model_ref)
+
+        if model_ref:
+            self._proto.model_reference.CopyFrom(model_ref._proto)
+
+    @property
+    def reference(self):
+        """A :class:`~google.cloud.bigquery.model.ModelReference` pointing to
+        this model.
+
+        Read-only.
+
+        Returns:
+            google.cloud.bigquery.model.ModelReference: pointer to this model.
+        """
+        ref = ModelReference()
+        ref._proto = self._proto.model_reference
+        return ref
+
+    @property
+    def project(self):
+        """str: Project bound to the model"""
+        return self.reference.project
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the model."""
+        return self.reference.dataset_id
+
+    @property
+    def model_id(self):
+        """str: The model ID."""
+        return self.reference.model_id
+
+    @property
+    def path(self):
+        """str: URL path for the model's APIs."""
+        return self.reference.path
+
+    @property
+    def location(self):
+        """str: The geographic location where the model resides. This value
+        is inherited from the dataset.
+
+        Read-only.
+        """
+        return self._proto.location
+
+    @property
+    def etag(self):
+        """str: ETag for the model resource (:data:`None` until
+        set from the server).
+
+        Read-only.
+        """
+        return self._proto.etag
+
+    @property
+    def created(self):
+        """Union[datetime.datetime, None]: Datetime at which the model was
+        created (:data:`None` until set from the server).
+
+        Read-only.
+        """
+        value = self._proto.creation_time
+        if value is not None and value != 0:
+            # value will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(value)
+            )
+
+    @property
+    def modified(self):
+        """Union[datetime.datetime, None]: Datetime at which the model was last
+        modified (:data:`None` until set from the server).
+
+        Read-only.
+        """
+        value = self._proto.last_modified_time
+        if value is not None and value != 0:
+            # value will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(value)
+            )
+
+    @property
+    def model_type(self):
+        """google.cloud.bigquery_v2.gapic.enums.Model.ModelType: Type of the
+        model resource.
+
+        Read-only.
+
+        The value is one of elements of the
+        :class:`~google.cloud.bigquery_v2.gapic.enums.Model.ModelType`
+        enumeration.
+        """
+        return self._proto.model_type
+
+    @property
+    def training_runs(self):
+        """Sequence[google.cloud.bigquery_v2.types.Model.TrainingRun]: Information
+        for all training runs in increasing order of start time.
+
+        Read-only.
+
+        An iterable of :class:`~google.cloud.bigquery_v2.types.Model.TrainingRun`.
+        """
+        return self._proto.training_runs
+
+    @property
+    def feature_columns(self):
+        """Sequence[google.cloud.bigquery_v2.types.StandardSqlField]: Input
+        feature columns that were used to train this model.
+
+        Read-only.
+
+        An iterable of :class:`~google.cloud.bigquery_v2.types.StandardSqlField`.
+        """
+        return self._proto.feature_columns
+
+    @property
+    def label_columns(self):
+        """Sequence[google.cloud.bigquery_v2.types.StandardSqlField]: Label
+        columns that were used to train this model. The output of the model
+        will have a ``predicted_`` prefix to these columns.
+
+        Read-only.
+
+        An iterable of :class:`~google.cloud.bigquery_v2.types.StandardSqlField`.
+        """
+        return self._proto.label_columns
+
+    @property
+    def expires(self):
+        """Union[datetime.datetime, None]: The datetime when this model
+        expires. If not present, the model will persist indefinitely. Expired
+        models will be deleted and their storage reclaimed.
+        """
+        value = self._properties.get("expirationTime")
+        if value is not None:
+            # value will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(value)
+            )
+
+    @expires.setter
+    def expires(self, value):
+        if value is not None:
+            value = str(google.cloud._helpers._millis_from_datetime(value))
+        self._properties["expirationTime"] = value
+
+    @property
+    def description(self):
+        """Union[str, None]: Description of the model (defaults to
+        :data:`None`).
+        """
+        return self._properties.get("description")
+
+    @description.setter
+    def description(self, value):
+        self._properties["description"] = value
+
+    @property
+    def friendly_name(self):
+        """Union[str, None]: Title of the table (defaults to :data:`None`).
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        return self._properties.get("friendlyName")
+
+    @friendly_name.setter
+    def friendly_name(self, value):
+        self._properties["friendlyName"] = value
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the table.
+
+        This method always returns a dict. To change a model's labels,
+        modify the dict, then call ``Client.update_model``. To delete a
+        label, set its value to :data:`None` before updating.
+        """
+        return self._properties.setdefault("labels", {})
+
+    @labels.setter
+    def labels(self, value):
+        if value is None:
+            value = {}
+        self._properties["labels"] = value
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a model resource given its API representation
+
+        Args:
+            resource (Dict[str, object]):
+                Model resource representation from the API
+
+        Returns:
+            google.cloud.bigquery.model.Model: Model parsed from ``resource``.
+        """
+        this = cls(None)
+        # Keep a reference to the resource as a workaround to find unknown
+        # field values.
+        this._properties = resource
+
+        # Convert from millis-from-epoch to timestamp well-known type.
+        # TODO: Remove this hack once CL 238585470 hits prod.
+        resource = copy.deepcopy(resource)
+        for training_run in resource.get("trainingRuns", ()):
+            start_time = training_run.get("startTime")
+            if not start_time or "-" in start_time:  # Already right format?
+                continue
+            start_time = datetime_helpers.from_microseconds(1e3 * float(start_time))
+            training_run["startTime"] = datetime_helpers.to_rfc3339(start_time)
+
+        this._proto = json_format.ParseDict(
+            resource, types.Model(), ignore_unknown_fields=True
+        )
+        return this
+
+    def _build_resource(self, filter_fields):
+        """Generate a resource for ``update``."""
+        return _helpers._build_resource_from_properties(self, filter_fields)
+
+    def __repr__(self):
+        return "Model(reference={})".format(repr(self.reference))
+
+
+class ModelReference(object):
+    """ModelReferences are pointers to models.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/models
+    """
+
+    def __init__(self):
+        self._proto = types.ModelReference()
+        self._properties = {}
+
+    @property
+    def project(self):
+        """str: Project bound to the model"""
+        return self._proto.project_id
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the model."""
+        return self._proto.dataset_id
+
+    @property
+    def model_id(self):
+        """str: The model ID."""
+        return self._proto.model_id
+
+    @property
+    def path(self):
+        """str: URL path for the model's APIs."""
+        return "/projects/%s/datasets/%s/models/%s" % (
+            self._proto.project_id,
+            self._proto.dataset_id,
+            self._proto.model_id,
+        )
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory:  construct a model reference given its API representation
+
+        Args:
+            resource (Dict[str, object]):
+                Model reference representation returned from the API
+
+        Returns:
+            google.cloud.bigquery.model.ModelReference:
+                Model reference parsed from ``resource``.
+        """
+        ref = cls()
+        # Keep a reference to the resource as a workaround to find unknown
+        # field values.
+        ref._properties = resource
+        ref._proto = json_format.ParseDict(
+            resource, types.ModelReference(), ignore_unknown_fields=True
+        )
+        return ref
+
+    @classmethod
+    def from_string(cls, model_id, default_project=None):
+        """Construct a model reference from model ID string.
+
+        Args:
+            model_id (str):
+                A model ID in standard SQL format. If ``default_project``
+                is not specified, this must included a project ID, dataset
+                ID, and model ID, each separated by ``.``.
+            default_project (str):
+                Optional. The project ID to use when ``model_id`` does not
+                include a project ID.
+
+        Returns:
+            google.cloud.bigquery.model.ModelReference:
+                Model reference parsed from ``model_id``.
+
+        Raises:
+            ValueError:
+                If ``model_id`` is not a fully-qualified table ID in
+                standard SQL format.
+        """
+        proj, dset, model = _helpers._parse_3_part_id(
+            model_id, default_project=default_project, property_name="model_id"
+        )
+        return cls.from_api_repr(
+            {"projectId": proj, "datasetId": dset, "modelId": model}
+        )
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this model reference.
+
+        Returns:
+            Dict[str, object]: Model reference represented as an API resource
+        """
+        return json_format.MessageToDict(self._proto)
+
+    def _key(self):
+        """Unique key for this model.
+
+        This is used for hashing a ModelReference.
+        """
+        return self.project, self.dataset_id, self.model_id
+
+    def __eq__(self, other):
+        if not isinstance(other, ModelReference):
+            return NotImplemented
+        return self._proto == other._proto
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __repr__(self):
+        return "ModelReference(project='{}', dataset_id='{}', project_id='{}')".format(
+            self.project, self.dataset_id, self.model_id
+        )
diff --git a/bigquery/google/cloud/bigquery/query.py b/bigquery/google/cloud/bigquery/query.py
new file mode 100644
index 000000000000..4039be33db8c
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/query.py
@@ -0,0 +1,632 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""BigQuery query processing."""
+
+from collections import OrderedDict
+import copy
+
+from google.cloud.bigquery.table import _parse_schema_resource
+from google.cloud.bigquery._helpers import _rows_from_json
+from google.cloud.bigquery._helpers import _QUERY_PARAMS_FROM_JSON
+from google.cloud.bigquery._helpers import _SCALAR_VALUE_TO_JSON_PARAM
+
+
+class UDFResource(object):
+    """Describe a single user-defined function (UDF) resource.
+
+    :type udf_type: str
+    :param udf_type: the type of the resource ('inlineCode' or 'resourceUri')
+
+    :type value: str
+    :param value: the inline code or resource URI.
+
+    See
+    https://cloud.google.com/bigquery/user-defined-functions#api
+    """
+
+    def __init__(self, udf_type, value):
+        self.udf_type = udf_type
+        self.value = value
+
+    def __eq__(self, other):
+        if not isinstance(other, UDFResource):
+            return NotImplemented
+        return self.udf_type == other.udf_type and self.value == other.value
+
+    def __ne__(self, other):
+        return not self == other
+
+
+class _AbstractQueryParameter(object):
+    """Base class for named / positional query parameters.
+    """
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct parameter from JSON resource.
+
+        :type resource: dict
+        :param resource: JSON mapping of parameter
+
+        :rtype: :class:`~google.cloud.bigquery.query.ScalarQueryParameter`
+        """
+        raise NotImplementedError
+
+    def to_api_repr(self):
+        """Construct JSON API representation for the parameter.
+
+        :rtype: dict
+        """
+        raise NotImplementedError
+
+
+class ScalarQueryParameter(_AbstractQueryParameter):
+    """Named / positional query parameters for scalar values.
+
+    :type name: str or None
+    :param name: Parameter name, used via ``@foo`` syntax.  If None, the
+                 parameter can only be addressed via position (``?``).
+
+    :type type_: str
+    :param type_: name of parameter type.  One of 'STRING', 'INT64',
+                  'FLOAT64', 'NUMERIC', 'BOOL', 'TIMESTAMP', 'DATETIME', or
+                  'DATE'.
+
+    :type value: str, int, float, :class:`decimal.Decimal`, bool,
+                 :class:`datetime.datetime`, or :class:`datetime.date`.
+    :param value: the scalar parameter value.
+    """
+
+    def __init__(self, name, type_, value):
+        self.name = name
+        self.type_ = type_
+        self.value = value
+
+    @classmethod
+    def positional(cls, type_, value):
+        """Factory for positional paramater.
+
+        :type type_: str
+        :param type_:
+            name of parameter type.  One of 'STRING', 'INT64',
+            'FLOAT64', 'NUMERIC', 'BOOL', 'TIMESTAMP', 'DATETIME', or
+            'DATE'.
+
+        :type value: str, int, float, :class:`decimal.Decimal`, bool,
+                     :class:`datetime.datetime`, or
+                     :class:`datetime.date`.
+        :param value: the scalar parameter value.
+
+        :rtype: :class:`~google.cloud.bigquery.query.ScalarQueryParameter`
+        :returns: instance without name
+        """
+        return cls(None, type_, value)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct parameter from JSON resource.
+
+        :type resource: dict
+        :param resource: JSON mapping of parameter
+
+        :rtype: :class:`~google.cloud.bigquery.query.ScalarQueryParameter`
+        :returns: instance
+        """
+        name = resource.get("name")
+        type_ = resource["parameterType"]["type"]
+
+        # parameterValue might not be present if JSON resource originates
+        # from the back-end - the latter omits it for None values.
+        value = resource.get("parameterValue", {}).get("value")
+        if value is not None:
+            converted = _QUERY_PARAMS_FROM_JSON[type_](value, None)
+        else:
+            converted = None
+
+        return cls(name, type_, converted)
+
+    def to_api_repr(self):
+        """Construct JSON API representation for the parameter.
+
+        :rtype: dict
+        :returns: JSON mapping
+        """
+        value = self.value
+        converter = _SCALAR_VALUE_TO_JSON_PARAM.get(self.type_)
+        if converter is not None:
+            value = converter(value)
+        resource = {
+            "parameterType": {"type": self.type_},
+            "parameterValue": {"value": value},
+        }
+        if self.name is not None:
+            resource["name"] = self.name
+        return resource
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            tuple: The contents of this
+                   :class:`~google.cloud.bigquery.query.ScalarQueryParameter`.
+        """
+        return (self.name, self.type_.upper(), self.value)
+
+    def __eq__(self, other):
+        if not isinstance(other, ScalarQueryParameter):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        return "ScalarQueryParameter{}".format(self._key())
+
+
+class ArrayQueryParameter(_AbstractQueryParameter):
+    """Named / positional query parameters for array values.
+
+    :type name: str or None
+    :param name: Parameter name, used via ``@foo`` syntax.  If None, the
+                 parameter can only be addressed via position (``?``).
+
+    :type array_type: str
+    :param array_type:
+        name of type of array elements.  One of `'STRING'`, `'INT64'`,
+        `'FLOAT64'`, `'NUMERIC'`, `'BOOL'`, `'TIMESTAMP'`, or `'DATE'`.
+
+    :type values: list of appropriate scalar type.
+    :param values: the parameter array values.
+    """
+
+    def __init__(self, name, array_type, values):
+        self.name = name
+        self.array_type = array_type
+        self.values = values
+
+    @classmethod
+    def positional(cls, array_type, values):
+        """Factory for positional parameters.
+
+        :type array_type: str
+        :param array_type:
+            name of type of array elements.  One of `'STRING'`, `'INT64'`,
+            `'FLOAT64'`, `'NUMERIC'`, `'BOOL'`, `'TIMESTAMP'`, or `'DATE'`.
+
+        :type values: list of appropriate scalar type
+        :param values: the parameter array values.
+
+        :rtype: :class:`~google.cloud.bigquery.query.ArrayQueryParameter`
+        :returns: instance without name
+        """
+        return cls(None, array_type, values)
+
+    @classmethod
+    def _from_api_repr_struct(cls, resource):
+        name = resource.get("name")
+        converted = []
+        # We need to flatten the array to use the StructQueryParameter
+        # parse code.
+        resource_template = {
+            # The arrayType includes all the types of the fields of the STRUCT
+            "parameterType": resource["parameterType"]["arrayType"]
+        }
+        for array_value in resource["parameterValue"]["arrayValues"]:
+            struct_resource = copy.deepcopy(resource_template)
+            struct_resource["parameterValue"] = array_value
+            struct_value = StructQueryParameter.from_api_repr(struct_resource)
+            converted.append(struct_value)
+        return cls(name, "STRUCT", converted)
+
+    @classmethod
+    def _from_api_repr_scalar(cls, resource):
+        name = resource.get("name")
+        array_type = resource["parameterType"]["arrayType"]["type"]
+        parameter_value = resource.get("parameterValue", {})
+        array_values = parameter_value.get("arrayValues", ())
+        values = [value["value"] for value in array_values]
+        converted = [
+            _QUERY_PARAMS_FROM_JSON[array_type](value, None) for value in values
+        ]
+        return cls(name, array_type, converted)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct parameter from JSON resource.
+
+        :type resource: dict
+        :param resource: JSON mapping of parameter
+
+        :rtype: :class:`~google.cloud.bigquery.query.ArrayQueryParameter`
+        :returns: instance
+        """
+        array_type = resource["parameterType"]["arrayType"]["type"]
+        if array_type == "STRUCT":
+            return cls._from_api_repr_struct(resource)
+        return cls._from_api_repr_scalar(resource)
+
+    def to_api_repr(self):
+        """Construct JSON API representation for the parameter.
+
+        :rtype: dict
+        :returns: JSON mapping
+        """
+        values = self.values
+        if self.array_type == "RECORD" or self.array_type == "STRUCT":
+            reprs = [value.to_api_repr() for value in values]
+            a_type = reprs[0]["parameterType"]
+            a_values = [repr_["parameterValue"] for repr_ in reprs]
+        else:
+            a_type = {"type": self.array_type}
+            converter = _SCALAR_VALUE_TO_JSON_PARAM.get(self.array_type)
+            if converter is not None:
+                values = [converter(value) for value in values]
+            a_values = [{"value": value} for value in values]
+        resource = {
+            "parameterType": {"type": "ARRAY", "arrayType": a_type},
+            "parameterValue": {"arrayValues": a_values},
+        }
+        if self.name is not None:
+            resource["name"] = self.name
+        return resource
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            tuple: The contents of this
+                   :class:`~google.cloud.bigquery.query.ArrayQueryParameter`.
+        """
+        return (self.name, self.array_type.upper(), self.values)
+
+    def __eq__(self, other):
+        if not isinstance(other, ArrayQueryParameter):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        return "ArrayQueryParameter{}".format(self._key())
+
+
+class StructQueryParameter(_AbstractQueryParameter):
+    """Named / positional query parameters for struct values.
+
+    :type name: str or None
+    :param name: Parameter name, used via ``@foo`` syntax.  If None, the
+                 parameter can only be addressed via position (``?``).
+
+    :type sub_params:
+        tuple of :class:`~google.cloud.bigquery.query.ScalarQueryParameter`,
+        :class:`~google.cloud.bigquery.query.ArrayQueryParameter`, or
+        :class:`~google.cloud.bigquery.query.StructQueryParameter`
+    :param sub_params: the sub-parameters for the struct
+    """
+
+    def __init__(self, name, *sub_params):
+        self.name = name
+        types = self.struct_types = OrderedDict()
+        values = self.struct_values = {}
+        for sub in sub_params:
+            if isinstance(sub, self.__class__):
+                types[sub.name] = "STRUCT"
+                values[sub.name] = sub
+            elif isinstance(sub, ArrayQueryParameter):
+                types[sub.name] = "ARRAY"
+                values[sub.name] = sub
+            else:
+                types[sub.name] = sub.type_
+                values[sub.name] = sub.value
+
+    @classmethod
+    def positional(cls, *sub_params):
+        """Factory for positional parameters.
+
+        :type sub_params:
+            tuple of
+            :class:`~google.cloud.bigquery.query.ScalarQueryParameter`,
+            :class:`~google.cloud.bigquery.query.ArrayQueryParameter`, or
+            :class:`~google.cloud.bigquery.query.StructQueryParameter`
+        :param sub_params: the sub-parameters for the struct
+
+        :rtype: :class:`~google.cloud.bigquery.query.StructQueryParameter`
+        :returns: instance without name
+        """
+        return cls(None, *sub_params)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct parameter from JSON resource.
+
+        :type resource: dict
+        :param resource: JSON mapping of parameter
+
+        :rtype: :class:`~google.cloud.bigquery.query.StructQueryParameter`
+        :returns: instance
+        """
+        name = resource.get("name")
+        instance = cls(name)
+        type_resources = {}
+        types = instance.struct_types
+        for item in resource["parameterType"]["structTypes"]:
+            types[item["name"]] = item["type"]["type"]
+            type_resources[item["name"]] = item["type"]
+        struct_values = resource["parameterValue"]["structValues"]
+        for key, value in struct_values.items():
+            type_ = types[key]
+            converted = None
+            if type_ == "STRUCT":
+                struct_resource = {
+                    "name": key,
+                    "parameterType": type_resources[key],
+                    "parameterValue": value,
+                }
+                converted = StructQueryParameter.from_api_repr(struct_resource)
+            elif type_ == "ARRAY":
+                struct_resource = {
+                    "name": key,
+                    "parameterType": type_resources[key],
+                    "parameterValue": value,
+                }
+                converted = ArrayQueryParameter.from_api_repr(struct_resource)
+            else:
+                value = value["value"]
+                converted = _QUERY_PARAMS_FROM_JSON[type_](value, None)
+            instance.struct_values[key] = converted
+        return instance
+
+    def to_api_repr(self):
+        """Construct JSON API representation for the parameter.
+
+        :rtype: dict
+        :returns: JSON mapping
+        """
+        s_types = {}
+        values = {}
+        for name, value in self.struct_values.items():
+            type_ = self.struct_types[name]
+            if type_ in ("STRUCT", "ARRAY"):
+                repr_ = value.to_api_repr()
+                s_types[name] = {"name": name, "type": repr_["parameterType"]}
+                values[name] = repr_["parameterValue"]
+            else:
+                s_types[name] = {"name": name, "type": {"type": type_}}
+                converter = _SCALAR_VALUE_TO_JSON_PARAM.get(type_)
+                if converter is not None:
+                    value = converter(value)
+                values[name] = {"value": value}
+
+        resource = {
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [s_types[key] for key in self.struct_types],
+            },
+            "parameterValue": {"structValues": values},
+        }
+        if self.name is not None:
+            resource["name"] = self.name
+        return resource
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            tuple: The contents of this
+                   :class:`~google.cloud.biquery.ArrayQueryParameter`.
+        """
+        return (self.name, self.struct_types, self.struct_values)
+
+    def __eq__(self, other):
+        if not isinstance(other, StructQueryParameter):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        return "StructQueryParameter{}".format(self._key())
+
+
+class _QueryResults(object):
+    """Results of a query.
+
+    See:
+    https://g.co/cloud/bigquery/docs/reference/rest/v2/jobs/getQueryResults
+    """
+
+    def __init__(self, properties):
+        self._properties = {}
+        self._set_properties(properties)
+
+    @classmethod
+    def from_api_repr(cls, api_response):
+        return cls(api_response)
+
+    @property
+    def project(self):
+        """Project bound to the query job.
+
+        :rtype: str
+        :returns: the project that the query job is associated with.
+        """
+        return self._properties.get("jobReference", {}).get("projectId")
+
+    @property
+    def cache_hit(self):
+        """Query results served from cache.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#cacheHit
+
+        :rtype: bool or ``NoneType``
+        :returns: True if the query results were served from cache (None
+                  until set by the server).
+        """
+        return self._properties.get("cacheHit")
+
+    @property
+    def complete(self):
+        """Server completed query.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#jobComplete
+
+        :rtype: bool or ``NoneType``
+        :returns: True if the query completed on the server (None
+                  until set by the server).
+        """
+        return self._properties.get("jobComplete")
+
+    @property
+    def errors(self):
+        """Errors generated by the query.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#errors
+
+        :rtype: list of mapping, or ``NoneType``
+        :returns: Mappings describing errors generated on the server (None
+                  until set by the server).
+        """
+        return self._properties.get("errors")
+
+    @property
+    def job_id(self):
+        """Job ID of the query job these results are from.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#jobReference
+
+        :rtype: string
+        :returns: Job ID of the query job.
+        """
+        return self._properties.get("jobReference", {}).get("jobId")
+
+    @property
+    def page_token(self):
+        """Token for fetching next bach of results.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#pageToken
+
+        :rtype: str, or ``NoneType``
+        :returns: Token generated on the server (None until set by the server).
+        """
+        return self._properties.get("pageToken")
+
+    @property
+    def total_rows(self):
+        """Total number of rows returned by the query.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#totalRows
+
+        :rtype: int, or ``NoneType``
+        :returns: Count generated on the server (None until set by the server).
+        """
+        total_rows = self._properties.get("totalRows")
+        if total_rows is not None:
+            return int(total_rows)
+
+    @property
+    def total_bytes_processed(self):
+        """Total number of bytes processed by the query.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#totalBytesProcessed
+
+        :rtype: int, or ``NoneType``
+        :returns: Count generated on the server (None until set by the server).
+        """
+        total_bytes_processed = self._properties.get("totalBytesProcessed")
+        if total_bytes_processed is not None:
+            return int(total_bytes_processed)
+
+    @property
+    def num_dml_affected_rows(self):
+        """Total number of rows affected by a DML query.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#numDmlAffectedRows
+
+        :rtype: int, or ``NoneType``
+        :returns: Count generated on the server (None until set by the server).
+        """
+        num_dml_affected_rows = self._properties.get("numDmlAffectedRows")
+        if num_dml_affected_rows is not None:
+            return int(num_dml_affected_rows)
+
+    @property
+    def rows(self):
+        """Query results.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#rows
+
+        :rtype: list of :class:`~google.cloud.bigquery.table.Row`
+        :returns: fields describing the schema (None until set by the server).
+        """
+        return _rows_from_json(self._properties.get("rows", ()), self.schema)
+
+    @property
+    def schema(self):
+        """Schema for query results.
+
+        See
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#schema
+
+        :rtype: list of :class:`SchemaField`, or ``NoneType``
+        :returns: fields describing the schema (None until set by the server).
+        """
+        return _parse_schema_resource(self._properties.get("schema", {}))
+
+    def _set_properties(self, api_response):
+        """Update properties from resource in body of ``api_response``
+
+        :type api_response: dict
+        :param api_response: response returned from an API call
+        """
+        job_id_present = (
+            "jobReference" in api_response
+            and "jobId" in api_response["jobReference"]
+            and "projectId" in api_response["jobReference"]
+        )
+        if not job_id_present:
+            raise ValueError("QueryResult requires a job reference")
+
+        self._properties.clear()
+        self._properties.update(copy.deepcopy(api_response))
+
+
+def _query_param_from_api_repr(resource):
+    """Helper:  construct concrete query parameter from JSON resource."""
+    qp_type = resource["parameterType"]
+    if "arrayType" in qp_type:
+        klass = ArrayQueryParameter
+    elif "structTypes" in qp_type:
+        klass = StructQueryParameter
+    else:
+        klass = ScalarQueryParameter
+    return klass.from_api_repr(resource)
diff --git a/bigquery/google/cloud/bigquery/retry.py b/bigquery/google/cloud/bigquery/retry.py
new file mode 100644
index 000000000000..4bc4b757f45d
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/retry.py
@@ -0,0 +1,55 @@
+# 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.
+
+from google.api_core import exceptions
+from google.api_core import retry
+
+
+_RETRYABLE_REASONS = frozenset(
+    ["rateLimitExceeded", "backendError", "internalError", "badGateway"]
+)
+
+_UNSTRUCTURED_RETRYABLE_TYPES = (
+    exceptions.TooManyRequests,
+    exceptions.InternalServerError,
+    exceptions.BadGateway,
+)
+
+
+def _should_retry(exc):
+    """Predicate for determining when to retry.
+
+    We retry if and only if the 'reason' is 'backendError'
+    or 'rateLimitExceeded'.
+    """
+    if not hasattr(exc, "errors"):
+        return False
+
+    if len(exc.errors) == 0:
+        # Check for unstructured error returns, e.g. from GFE
+        return isinstance(exc, _UNSTRUCTURED_RETRYABLE_TYPES)
+
+    reason = exc.errors[0]["reason"]
+    return reason in _RETRYABLE_REASONS
+
+
+DEFAULT_RETRY = retry.Retry(predicate=_should_retry)
+"""The default retry object.
+
+Any method with a ``retry`` parameter will be retried automatically,
+with reasonable defaults. To disable retry, pass ``retry=None``.
+To modify the default retry behavior, call a ``with_XXX`` method
+on ``DEFAULT_RETRY``. For example, to change the deadline to 30 seconds,
+pass ``retry=bigquery.DEFAULT_RETRY.with_deadline(30)``.
+"""
diff --git a/bigquery/google/cloud/bigquery/routine.py b/bigquery/google/cloud/bigquery/routine.py
new file mode 100644
index 000000000000..d5bb752dfddb
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/routine.py
@@ -0,0 +1,513 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define resources for the BigQuery Routines API."""
+
+from google.protobuf import json_format
+import six
+
+import google.cloud._helpers
+from google.cloud.bigquery import _helpers
+import google.cloud.bigquery_v2.types
+
+
+class Routine(object):
+    """Resource representing a user-defined routine.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines
+
+    Args:
+        routine_ref (Union[ \
+            str, \
+            google.cloud.bigquery.routine.RoutineReference, \
+        ]):
+            A pointer to a routine. If ``routine_ref`` is a string, it must
+            included a project ID, dataset ID, and routine ID, each separated
+            by ``.``.
+        ``**kwargs`` (Dict):
+            Initial property values.
+    """
+
+    _PROPERTY_TO_API_FIELD = {
+        "arguments": "arguments",
+        "body": "definitionBody",
+        "created": "creationTime",
+        "etag": "etag",
+        "imported_libraries": "importedLibraries",
+        "language": "language",
+        "modified": "lastModifiedTime",
+        "reference": "routineReference",
+        "return_type": "returnType",
+        "type_": "routineType",
+    }
+
+    def __init__(self, routine_ref, **kwargs):
+        if isinstance(routine_ref, six.string_types):
+            routine_ref = RoutineReference.from_string(routine_ref)
+
+        self._properties = {"routineReference": routine_ref.to_api_repr()}
+        for property_name in kwargs:
+            setattr(self, property_name, kwargs[property_name])
+
+    @property
+    def reference(self):
+        """google.cloud.bigquery.routine.RoutineReference: Reference
+        describing the ID of this routine.
+        """
+        return RoutineReference.from_api_repr(
+            self._properties[self._PROPERTY_TO_API_FIELD["reference"]]
+        )
+
+    @property
+    def path(self):
+        """str: URL path for the routine's APIs."""
+        return self.reference.path
+
+    @property
+    def project(self):
+        """str: ID of the project containing the routine."""
+        return self.reference.project
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the routine."""
+        return self.reference.dataset_id
+
+    @property
+    def routine_id(self):
+        """str: The routine ID."""
+        return self.reference.routine_id
+
+    @property
+    def etag(self):
+        """str: ETag for the resource (:data:`None` until set from the
+        server).
+
+        Read-only.
+        """
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["etag"])
+
+    @property
+    def type_(self):
+        """str: The fine-grained type of the routine.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#RoutineType
+        """
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["type_"])
+
+    @type_.setter
+    def type_(self, value):
+        self._properties[self._PROPERTY_TO_API_FIELD["type_"]] = value
+
+    @property
+    def created(self):
+        """Optional[datetime.datetime]: Datetime at which the routine was
+        created (:data:`None` until set from the server).
+
+        Read-only.
+        """
+        value = self._properties.get(self._PROPERTY_TO_API_FIELD["created"])
+        if value is not None and value != 0:
+            # value will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(value)
+            )
+
+    @property
+    def modified(self):
+        """Optional[datetime.datetime]: Datetime at which the routine was
+        last modified (:data:`None` until set from the server).
+
+        Read-only.
+        """
+        value = self._properties.get(self._PROPERTY_TO_API_FIELD["modified"])
+        if value is not None and value != 0:
+            # value will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(value)
+            )
+
+    @property
+    def language(self):
+        """Optional[str]: The language of the routine.
+
+        Defaults to ``SQL``.
+        """
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["language"])
+
+    @language.setter
+    def language(self, value):
+        self._properties[self._PROPERTY_TO_API_FIELD["language"]] = value
+
+    @property
+    def arguments(self):
+        """List[google.cloud.bigquery.routine.RoutineArgument]: Input/output
+        argument of a function or a stored procedure.
+
+        In-place modification is not supported. To set, replace the entire
+        property value with the modified list of
+        :class:`~google.cloud.bigquery.routine.RoutineArgument` objects.
+        """
+        resources = self._properties.get(self._PROPERTY_TO_API_FIELD["arguments"], [])
+        return [RoutineArgument.from_api_repr(resource) for resource in resources]
+
+    @arguments.setter
+    def arguments(self, value):
+        if not value:
+            resource = []
+        else:
+            resource = [argument.to_api_repr() for argument in value]
+        self._properties[self._PROPERTY_TO_API_FIELD["arguments"]] = resource
+
+    @property
+    def return_type(self):
+        """google.cloud.bigquery_v2.types.StandardSqlDataType: Return type of
+        the routine.
+
+        If absent, the return type is inferred from
+        :attr:`~google.cloud.bigquery.routine.Routine.body` at query time in
+        each query that references this routine. If present, then the
+        evaluated result will be cast to the specified returned type at query
+        time.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#resource-routine
+        """
+        resource = self._properties.get(self._PROPERTY_TO_API_FIELD["return_type"])
+        if not resource:
+            return resource
+        output = google.cloud.bigquery_v2.types.StandardSqlDataType()
+        output = json_format.ParseDict(resource, output, ignore_unknown_fields=True)
+        return output
+
+    @return_type.setter
+    def return_type(self, value):
+        if value:
+            resource = json_format.MessageToDict(value)
+        else:
+            resource = None
+        self._properties[self._PROPERTY_TO_API_FIELD["return_type"]] = resource
+
+    @property
+    def imported_libraries(self):
+        """List[str]: The path of the imported JavaScript libraries.
+
+        The :attr:`~google.cloud.bigquery.routine.Routine.language` must
+        equal ``JAVACRIPT``.
+
+        Examples:
+            Set the ``imported_libraries`` to a list of Google Cloud Storage
+            URIs.
+
+            .. code-block:: python
+
+               routine = bigquery.Routine("proj.dataset.routine_id")
+               routine.imported_libraries = [
+                   "gs://cloud-samples-data/bigquery/udfs/max-value.js",
+               ]
+        """
+        return self._properties.get(
+            self._PROPERTY_TO_API_FIELD["imported_libraries"], []
+        )
+
+    @imported_libraries.setter
+    def imported_libraries(self, value):
+        if not value:
+            resource = []
+        else:
+            resource = value
+        self._properties[self._PROPERTY_TO_API_FIELD["imported_libraries"]] = resource
+
+    @property
+    def body(self):
+        """str: The body of the routine."""
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["body"])
+
+    @body.setter
+    def body(self, value):
+        self._properties[self._PROPERTY_TO_API_FIELD["body"]] = value
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a routine given its API representation.
+
+        Args:
+            resource (Dict[str, object]):
+                Resource, as returned from the API.
+
+        Returns:
+            google.cloud.bigquery.routine.Routine:
+                Python object, as parsed from ``resource``.
+        """
+        ref = cls(RoutineReference.from_api_repr(resource["routineReference"]))
+        ref._properties = resource
+        return ref
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this routine.
+
+        Returns:
+            Dict[str, object]:
+                Routine represented as an API resource.
+        """
+        return self._properties
+
+    def _build_resource(self, filter_fields):
+        """Generate a resource for ``update``."""
+        return _helpers._build_resource_from_properties(self, filter_fields)
+
+    def __repr__(self):
+        return "Routine('{}.{}.{}')".format(
+            self.project, self.dataset_id, self.routine_id
+        )
+
+
+class RoutineArgument(object):
+    """Input/output argument of a function or a stored procedure.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines
+
+    Args:
+        ``**kwargs`` (Dict):
+            Initial property values.
+    """
+
+    _PROPERTY_TO_API_FIELD = {
+        "data_type": "dataType",
+        "kind": "argumentKind",
+        # Even though it's not necessary for field mapping to map when the
+        # property name equals the resource name, we add these here so that we
+        # have an exhaustive list of all properties.
+        "name": "name",
+        "mode": "mode",
+    }
+
+    def __init__(self, **kwargs):
+        self._properties = {}
+        for property_name in kwargs:
+            setattr(self, property_name, kwargs[property_name])
+
+    @property
+    def name(self):
+        """Optional[str]: Name of this argument.
+
+        Can be absent for function return argument.
+        """
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["name"])
+
+    @name.setter
+    def name(self, value):
+        self._properties[self._PROPERTY_TO_API_FIELD["name"]] = value
+
+    @property
+    def kind(self):
+        """Optional[str]: The kind of argument, for example ``FIXED_TYPE`` or
+        ``ANY_TYPE``.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/routines#ArgumentKind
+        """
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["kind"])
+
+    @kind.setter
+    def kind(self, value):
+        self._properties[self._PROPERTY_TO_API_FIELD["kind"]] = value
+
+    @property
+    def mode(self):
+        """Optional[str]: The input/output mode of the argument."""
+        return self._properties.get(self._PROPERTY_TO_API_FIELD["mode"])
+
+    @mode.setter
+    def mode(self, value):
+        self._properties[self._PROPERTY_TO_API_FIELD["mode"]] = value
+
+    @property
+    def data_type(self):
+        """Optional[google.cloud.bigquery_v2.types.StandardSqlDataType]: Type
+        of a variable, e.g., a function argument.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/StandardSqlDataType
+        """
+        resource = self._properties.get(self._PROPERTY_TO_API_FIELD["data_type"])
+        if not resource:
+            return resource
+        output = google.cloud.bigquery_v2.types.StandardSqlDataType()
+        output = json_format.ParseDict(resource, output, ignore_unknown_fields=True)
+        return output
+
+    @data_type.setter
+    def data_type(self, value):
+        if value:
+            resource = json_format.MessageToDict(value)
+        else:
+            resource = None
+        self._properties[self._PROPERTY_TO_API_FIELD["data_type"]] = resource
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a routine argument given its API representation.
+
+        Args:
+            resource (Dict[str, object]):
+                Resource, as returned from the API.
+
+        Returns:
+            google.cloud.bigquery.routine.RoutineArgument:
+                Python object, as parsed from ``resource``.
+        """
+        ref = cls()
+        ref._properties = resource
+        return ref
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this routine argument.
+
+        Returns:
+            Dict[str, object]:
+                Routine argument represented as an API resource.
+        """
+        return self._properties
+
+    def __eq__(self, other):
+        if not isinstance(other, RoutineArgument):
+            return NotImplemented
+        return self._properties == other._properties
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        all_properties = [
+            "{}={}".format(property_name, repr(getattr(self, property_name)))
+            for property_name in sorted(self._PROPERTY_TO_API_FIELD)
+        ]
+        return "RoutineArgument({})".format(", ".join(all_properties))
+
+
+class RoutineReference(object):
+    """A pointer to a routine.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/routines
+    """
+
+    def __init__(self):
+        self._properties = {}
+
+    @property
+    def project(self):
+        """str: ID of the project containing the routine."""
+        return self._properties["projectId"]
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the routine."""
+        return self._properties["datasetId"]
+
+    @property
+    def routine_id(self):
+        """str: The routine ID."""
+        return self._properties["routineId"]
+
+    @property
+    def path(self):
+        """str: URL path for the routine's APIs."""
+        return "/projects/%s/datasets/%s/routines/%s" % (
+            self.project,
+            self.dataset_id,
+            self.routine_id,
+        )
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a routine reference given its API representation.
+
+        Args:
+            resource (Dict[str, object]):
+                Routine reference representation returned from the API.
+
+        Returns:
+            google.cloud.bigquery.routine.RoutineReference:
+                Routine reference parsed from ``resource``.
+        """
+        ref = cls()
+        ref._properties = resource
+        return ref
+
+    @classmethod
+    def from_string(cls, routine_id, default_project=None):
+        """Factory: construct a routine reference from routine ID string.
+
+        Args:
+            routine_id (str):
+                A routine ID in standard SQL format. If ``default_project``
+                is not specified, this must included a project ID, dataset
+                ID, and routine ID, each separated by ``.``.
+            default_project (str):
+                Optional. The project ID to use when ``routine_id`` does not
+                include a project ID.
+
+        Returns:
+            google.cloud.bigquery.routine.RoutineReference:
+                Routine reference parsed from ``routine_id``.
+
+        Raises:
+            ValueError:
+                If ``routine_id`` is not a fully-qualified routine ID in
+                standard SQL format.
+        """
+        proj, dset, routine = _helpers._parse_3_part_id(
+            routine_id, default_project=default_project, property_name="routine_id"
+        )
+        return cls.from_api_repr(
+            {"projectId": proj, "datasetId": dset, "routineId": routine}
+        )
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this routine reference.
+
+        Returns:
+            Dict[str, object]:
+                Routine reference represented as an API resource.
+        """
+        return self._properties
+
+    def __eq__(self, other):
+        """Two RoutineReferences are equal if they point to the same routine."""
+        if not isinstance(other, RoutineReference):
+            return NotImplemented
+        return str(self) == str(other)
+
+    def __hash__(self):
+        return hash(str(self))
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        return "RoutineReference.from_string('{}')".format(str(self))
+
+    def __str__(self):
+        """String representation of the reference.
+
+        This is a fully-qualified ID, including the project ID and dataset ID.
+        """
+        return "{}.{}.{}".format(self.project, self.dataset_id, self.routine_id)
diff --git a/bigquery/google/cloud/bigquery/schema.py b/bigquery/google/cloud/bigquery/schema.py
new file mode 100644
index 000000000000..e0673d85baf6
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/schema.py
@@ -0,0 +1,262 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Schemas for BigQuery tables / queries."""
+
+from google.cloud.bigquery_v2 import types
+
+
+_STRUCT_TYPES = ("RECORD", "STRUCT")
+
+# SQL types reference:
+# https://cloud.google.com/bigquery/data-types#legacy_sql_data_types
+# https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types
+LEGACY_TO_STANDARD_TYPES = {
+    "STRING": types.StandardSqlDataType.STRING,
+    "BYTES": types.StandardSqlDataType.BYTES,
+    "INTEGER": types.StandardSqlDataType.INT64,
+    "INT64": types.StandardSqlDataType.INT64,
+    "FLOAT": types.StandardSqlDataType.FLOAT64,
+    "FLOAT64": types.StandardSqlDataType.FLOAT64,
+    "NUMERIC": types.StandardSqlDataType.NUMERIC,
+    "BOOLEAN": types.StandardSqlDataType.BOOL,
+    "BOOL": types.StandardSqlDataType.BOOL,
+    "GEOGRAPHY": types.StandardSqlDataType.GEOGRAPHY,
+    "RECORD": types.StandardSqlDataType.STRUCT,
+    "STRUCT": types.StandardSqlDataType.STRUCT,
+    "TIMESTAMP": types.StandardSqlDataType.TIMESTAMP,
+    "DATE": types.StandardSqlDataType.DATE,
+    "TIME": types.StandardSqlDataType.TIME,
+    "DATETIME": types.StandardSqlDataType.DATETIME,
+    # no direct conversion from ARRAY, the latter is represented by mode="REPEATED"
+}
+"""String names of the legacy SQL types to integer codes of Standard SQL types."""
+
+
+class SchemaField(object):
+    """Describe a single field within a table schema.
+
+    Args:
+        name (str): the name of the field.
+
+        field_type (str): the type of the field. See
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.type
+
+        mode (str): the mode of the field.  See
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.mode
+
+        description (Optional[str]):description for the field.
+
+        fields (Tuple[:class:`~google.cloud.bigquery.schema.SchemaField`]):
+            subfields (requires ``field_type`` of 'RECORD').
+    """
+
+    def __init__(self, name, field_type, mode="NULLABLE", description=None, fields=()):
+        self._name = name
+        self._field_type = field_type
+        self._mode = mode
+        self._description = description
+        self._fields = tuple(fields)
+
+    @classmethod
+    def from_api_repr(cls, api_repr):
+        """Return a ``SchemaField`` object deserialized from a dictionary.
+
+        Args:
+            api_repr (Mapping[str, str]): The serialized representation
+                of the SchemaField, such as what is output by
+                :meth:`to_api_repr`.
+
+        Returns:
+            google.cloud.biquery.schema.SchemaField:
+                The ``SchemaField`` object.
+        """
+        # Handle optional properties with default values
+        mode = api_repr.get("mode", "NULLABLE")
+        description = api_repr.get("description")
+        fields = api_repr.get("fields", ())
+        return cls(
+            field_type=api_repr["type"].upper(),
+            fields=[cls.from_api_repr(f) for f in fields],
+            mode=mode.upper(),
+            description=description,
+            name=api_repr["name"],
+        )
+
+    @property
+    def name(self):
+        """str: The name of the field."""
+        return self._name
+
+    @property
+    def field_type(self):
+        """str: The type of the field.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.type
+        """
+        return self._field_type
+
+    @property
+    def mode(self):
+        """str: The mode of the field.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.mode
+        """
+        return self._mode
+
+    @property
+    def is_nullable(self):
+        """bool: whether 'mode' is 'nullable'."""
+        return self._mode == "NULLABLE"
+
+    @property
+    def description(self):
+        """Optional[str]: description for the field."""
+        return self._description
+
+    @property
+    def fields(self):
+        """tuple: Subfields contained in this field.
+
+        Must be empty unset if ``field_type`` is not 'RECORD'.
+        """
+        return self._fields
+
+    def to_api_repr(self):
+        """Return a dictionary representing this schema field.
+
+        Returns:
+            dict: A dictionary representing the SchemaField in a serialized
+                form.
+        """
+        # Put together the basic representation. See http://bit.ly/2hOAT5u.
+        answer = {
+            "mode": self.mode.upper(),
+            "name": self.name,
+            "type": self.field_type.upper(),
+            "description": self.description,
+        }
+
+        # If this is a RECORD type, then sub-fields are also included,
+        # add this to the serialized representation.
+        if self.field_type.upper() in _STRUCT_TYPES:
+            answer["fields"] = [f.to_api_repr() for f in self.fields]
+
+        # Done; return the serialized dictionary.
+        return answer
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            tuple: The contents of this
+                   :class:`~google.cloud.bigquery.schema.SchemaField`.
+        """
+        return (
+            self._name,
+            self._field_type.upper(),
+            self._mode.upper(),
+            self._description,
+            self._fields,
+        )
+
+    def to_standard_sql(self):
+        """Return the field as the standard SQL field representation object.
+
+        Returns:
+            An instance of :class:`~google.cloud.bigquery_v2.types.StandardSqlField`.
+        """
+        sql_type = types.StandardSqlDataType()
+
+        if self.mode == "REPEATED":
+            sql_type.type_kind = types.StandardSqlDataType.ARRAY
+        else:
+            sql_type.type_kind = LEGACY_TO_STANDARD_TYPES.get(
+                self.field_type, types.StandardSqlDataType.TYPE_KIND_UNSPECIFIED
+            )
+
+        if sql_type.type_kind == types.StandardSqlDataType.ARRAY:  # noqa: E721
+            array_element_type = LEGACY_TO_STANDARD_TYPES.get(
+                self.field_type, types.StandardSqlDataType.TYPE_KIND_UNSPECIFIED
+            )
+            sql_type.array_element_type.type_kind = array_element_type
+
+            # ARRAY cannot directly contain other arrays, only scalar types and STRUCTs
+            # https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#array-type
+            if array_element_type == types.StandardSqlDataType.STRUCT:  # noqa: E721
+                sql_type.array_element_type.struct_type.fields.extend(
+                    field.to_standard_sql() for field in self.fields
+                )
+
+        elif sql_type.type_kind == types.StandardSqlDataType.STRUCT:  # noqa: E721
+            sql_type.struct_type.fields.extend(
+                field.to_standard_sql() for field in self.fields
+            )
+
+        return types.StandardSqlField(name=self.name, type=sql_type)
+
+    def __eq__(self, other):
+        if not isinstance(other, SchemaField):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __repr__(self):
+        return "SchemaField{}".format(self._key())
+
+
+def _parse_schema_resource(info):
+    """Parse a resource fragment into a schema field.
+
+    Args:
+        info: (Mapping[str->dict]): should contain a "fields" key to be parsed
+
+    Returns:
+        (Union[Sequence[:class:`google.cloud.bigquery.schema.SchemaField`],None])
+            a list of parsed fields, or ``None`` if no "fields" key found.
+    """
+    if "fields" not in info:
+        return ()
+
+    schema = []
+    for r_field in info["fields"]:
+        name = r_field["name"]
+        field_type = r_field["type"]
+        mode = r_field.get("mode", "NULLABLE")
+        description = r_field.get("description")
+        sub_fields = _parse_schema_resource(r_field)
+        schema.append(SchemaField(name, field_type, mode, description, sub_fields))
+    return schema
+
+
+def _build_schema_resource(fields):
+    """Generate a resource fragment for a schema.
+
+    Args:
+        fields [Sequence[:class:`~google.cloud.bigquery.schema.SchemaField`]):
+            schema to be dumped
+
+    Returns: (Sequence[dict])
+        mappings describing the schema of the supplied fields.
+    """
+    return [field.to_api_repr() for field in fields]
diff --git a/bigquery/google/cloud/bigquery/table.py b/bigquery/google/cloud/bigquery/table.py
new file mode 100644
index 000000000000..62072cf88804
--- /dev/null
+++ b/bigquery/google/cloud/bigquery/table.py
@@ -0,0 +1,1953 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define API Tables."""
+
+from __future__ import absolute_import
+
+import copy
+import datetime
+import functools
+import logging
+import operator
+import warnings
+
+import six
+
+try:
+    from google.cloud import bigquery_storage_v1beta1
+except ImportError:  # pragma: NO COVER
+    bigquery_storage_v1beta1 = None
+
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+
+try:
+    import pyarrow
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+
+try:
+    import tqdm
+except ImportError:  # pragma: NO COVER
+    tqdm = None
+
+import google.api_core.exceptions
+from google.api_core.page_iterator import HTTPIterator
+
+import google.cloud._helpers
+from google.cloud.bigquery import _helpers
+from google.cloud.bigquery import _pandas_helpers
+from google.cloud.bigquery.schema import SchemaField
+from google.cloud.bigquery.schema import _build_schema_resource
+from google.cloud.bigquery.schema import _parse_schema_resource
+from google.cloud.bigquery.external_config import ExternalConfig
+
+
+_LOGGER = logging.getLogger(__name__)
+
+_NO_BQSTORAGE_ERROR = (
+    "The google-cloud-bigquery-storage library is not installed, "
+    "please install google-cloud-bigquery-storage to use bqstorage features."
+)
+_NO_PANDAS_ERROR = (
+    "The pandas library is not installed, please install "
+    "pandas to use the to_dataframe() function."
+)
+_NO_PYARROW_ERROR = (
+    "The pyarrow library is not installed, please install "
+    "pandas to use the to_arrow() function."
+)
+_NO_TQDM_ERROR = (
+    "A progress bar was requested, but there was an error loading the tqdm "
+    "library. Please install tqdm to use the progress bar functionality."
+)
+_TABLE_HAS_NO_SCHEMA = 'Table has no schema:  call "client.get_table()"'
+
+
+def _reference_getter(table):
+    """A :class:`~google.cloud.bigquery.table.TableReference` pointing to
+    this table.
+
+    Returns:
+        google.cloud.bigquery.table.TableReference: pointer to this table.
+    """
+    from google.cloud.bigquery import dataset
+
+    dataset_ref = dataset.DatasetReference(table.project, table.dataset_id)
+    return TableReference(dataset_ref, table.table_id)
+
+
+def _view_use_legacy_sql_getter(table):
+    """bool: Specifies whether to execute the view with Legacy or Standard SQL.
+
+    This boolean specifies whether to execute the view with Legacy SQL
+    (:data:`True`) or Standard SQL (:data:`False`). The client side default is
+    :data:`False`. The server-side default is :data:`True`. If this table is
+    not a view, :data:`None` is returned.
+
+    Raises:
+        ValueError: For invalid value types.
+    """
+    view = table._properties.get("view")
+    if view is not None:
+        # The server-side default for useLegacySql is True.
+        return view.get("useLegacySql", True)
+    # In some cases, such as in a table list no view object is present, but the
+    # resource still represents a view. Use the type as a fallback.
+    if table.table_type == "VIEW":
+        # The server-side default for useLegacySql is True.
+        return True
+
+
+class EncryptionConfiguration(object):
+    """Custom encryption configuration (e.g., Cloud KMS keys).
+
+    Args:
+        kms_key_name (str): resource ID of Cloud KMS key used for encryption
+    """
+
+    def __init__(self, kms_key_name=None):
+        self._properties = {}
+        if kms_key_name is not None:
+            self._properties["kmsKeyName"] = kms_key_name
+
+    @property
+    def kms_key_name(self):
+        """str: Resource ID of Cloud KMS key
+
+        Resource ID of Cloud KMS key or :data:`None` if using default
+        encryption.
+        """
+        return self._properties.get("kmsKeyName")
+
+    @kms_key_name.setter
+    def kms_key_name(self, value):
+        self._properties["kmsKeyName"] = value
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Construct an encryption configuration from its API representation
+
+        Args:
+            resource (Dict[str, object]):
+                An encryption configuration representation as returned from
+                the API.
+
+        Returns:
+            google.cloud.bigquery.table.EncryptionConfiguration:
+                An encryption configuration parsed from ``resource``.
+        """
+        config = cls()
+        config._properties = copy.deepcopy(resource)
+        return config
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this encryption
+        configuration.
+
+        Returns:
+            Dict[str, object]:
+                Encryption configuration as represented as an API resource
+        """
+        return copy.deepcopy(self._properties)
+
+    def __eq__(self, other):
+        if not isinstance(other, EncryptionConfiguration):
+            return NotImplemented
+        return self.kms_key_name == other.kms_key_name
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self.kms_key_name)
+
+    def __repr__(self):
+        return "EncryptionConfiguration({})".format(self.kms_key_name)
+
+
+class TableReference(object):
+    """TableReferences are pointers to tables.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/tables
+
+    Args:
+        dataset_ref (google.cloud.bigquery.dataset.DatasetReference):
+            A pointer to the dataset
+        table_id (str): The ID of the table
+    """
+
+    def __init__(self, dataset_ref, table_id):
+        self._project = dataset_ref.project
+        self._dataset_id = dataset_ref.dataset_id
+        self._table_id = table_id
+
+    @property
+    def project(self):
+        """str: Project bound to the table"""
+        return self._project
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the table."""
+        return self._dataset_id
+
+    @property
+    def table_id(self):
+        """str: The table ID."""
+        return self._table_id
+
+    @property
+    def path(self):
+        """str: URL path for the table's APIs."""
+        return "/projects/%s/datasets/%s/tables/%s" % (
+            self._project,
+            self._dataset_id,
+            self._table_id,
+        )
+
+    @classmethod
+    def from_string(cls, table_id, default_project=None):
+        """Construct a table reference from table ID string.
+
+        Args:
+            table_id (str):
+                A table ID in standard SQL format. If ``default_project``
+                is not specified, this must included a project ID, dataset
+                ID, and table ID, each separated by ``.``.
+            default_project (str):
+                Optional. The project ID to use when ``table_id`` does not
+                include a project ID.
+
+        Returns:
+            TableReference: Table reference parsed from ``table_id``.
+
+        Examples:
+            >>> TableReference.from_string('my-project.mydataset.mytable')
+            TableRef...(DatasetRef...('my-project', 'mydataset'), 'mytable')
+
+        Raises:
+            ValueError:
+                If ``table_id`` is not a fully-qualified table ID in
+                standard SQL format.
+        """
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        (
+            output_project_id,
+            output_dataset_id,
+            output_table_id,
+        ) = _helpers._parse_3_part_id(
+            table_id, default_project=default_project, property_name="table_id"
+        )
+
+        return cls(
+            DatasetReference(output_project_id, output_dataset_id), output_table_id
+        )
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory:  construct a table reference given its API representation
+
+        Args:
+            resource (Dict[str, object]):
+                Table reference representation returned from the API
+
+        Returns:
+            google.cloud.bigquery.table.TableReference:
+                Table reference parsed from ``resource``.
+        """
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        project = resource["projectId"]
+        dataset_id = resource["datasetId"]
+        table_id = resource["tableId"]
+        return cls(DatasetReference(project, dataset_id), table_id)
+
+    def to_api_repr(self):
+        """Construct the API resource representation of this table reference.
+
+        Returns:
+            Dict[str, object]: Table reference represented as an API resource
+        """
+        return {
+            "projectId": self._project,
+            "datasetId": self._dataset_id,
+            "tableId": self._table_id,
+        }
+
+    def to_bqstorage(self):
+        """Construct a BigQuery Storage API representation of this table.
+
+        Install the ``google-cloud-bigquery-storage`` package to use this
+        feature.
+
+        If the ``table_id`` contains a partition identifier (e.g.
+        ``my_table$201812``) or a snapshot identifier (e.g.
+        ``mytable@1234567890``), it is ignored. Use
+        :class:`google.cloud.bigquery_storage_v1beta1.types.TableReadOptions`
+        to filter rows by partition. Use
+        :class:`google.cloud.bigquery_storage_v1beta1.types.TableModifiers`
+        to select a specific snapshot to read from.
+
+        Returns:
+            google.cloud.bigquery_storage_v1beta1.types.TableReference:
+                A reference to this table in the BigQuery Storage API.
+
+        Raises:
+            ValueError:
+                If the :mod:`google.cloud.bigquery_storage_v1beta1` module
+                cannot be imported.
+        """
+        if bigquery_storage_v1beta1 is None:
+            raise ValueError(_NO_BQSTORAGE_ERROR)
+
+        table_ref = bigquery_storage_v1beta1.types.TableReference()
+        table_ref.project_id = self._project
+        table_ref.dataset_id = self._dataset_id
+        table_id = self._table_id
+
+        if "@" in table_id:
+            table_id = table_id.split("@")[0]
+
+        if "$" in table_id:
+            table_id = table_id.split("$")[0]
+
+        table_ref.table_id = table_id
+
+        return table_ref
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            Tuple[str]: The contents of this :class:`DatasetReference`.
+        """
+        return (self._project, self._dataset_id, self._table_id)
+
+    def __eq__(self, other):
+        if not isinstance(other, TableReference):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __repr__(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset_ref = DatasetReference(self._project, self._dataset_id)
+        return "TableReference({}, '{}')".format(repr(dataset_ref), self._table_id)
+
+
+class Table(object):
+    """Tables represent a set of rows whose values correspond to a schema.
+
+    See
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/tables
+
+    Args:
+        table_ref (Union[ \
+            :class:`~google.cloud.bigquery.table.TableReference`, \
+            str, \
+        ]):
+            A pointer to a table. If ``table_ref`` is a string, it must
+            included a project ID, dataset ID, and table ID, each separated
+            by ``.``.
+        schema (List[google.cloud.bigquery.schema.SchemaField]):
+            The table's schema
+    """
+
+    _PROPERTY_TO_API_FIELD = {
+        "friendly_name": "friendlyName",
+        "expires": "expirationTime",
+        "time_partitioning": "timePartitioning",
+        "partitioning_type": "timePartitioning",
+        "partition_expiration": "timePartitioning",
+        "view_use_legacy_sql": "view",
+        "view_query": "view",
+        "external_data_configuration": "externalDataConfiguration",
+        "encryption_configuration": "encryptionConfiguration",
+    }
+
+    def __init__(self, table_ref, schema=None):
+        table_ref = _table_arg_to_table_ref(table_ref)
+        self._properties = {"tableReference": table_ref.to_api_repr(), "labels": {}}
+        # Let the @property do validation.
+        if schema is not None:
+            self.schema = schema
+
+    @property
+    def project(self):
+        """str: Project bound to the table."""
+        return self._properties["tableReference"]["projectId"]
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the table."""
+        return self._properties["tableReference"]["datasetId"]
+
+    @property
+    def table_id(self):
+        """str: ID of the table."""
+        return self._properties["tableReference"]["tableId"]
+
+    reference = property(_reference_getter)
+
+    @property
+    def path(self):
+        """str: URL path for the table's APIs."""
+        return "/projects/%s/datasets/%s/tables/%s" % (
+            self.project,
+            self.dataset_id,
+            self.table_id,
+        )
+
+    @property
+    def schema(self):
+        """List[google.cloud.bigquery.schema.SchemaField]: Table's schema.
+
+        Raises:
+            TypeError: If 'value' is not a sequence
+            ValueError:
+                If any item in the sequence is not a
+                :class:`~google.cloud.bigquery.schema.SchemaField`
+        """
+        prop = self._properties.get("schema")
+        if not prop:
+            return []
+        else:
+            return _parse_schema_resource(prop)
+
+    @schema.setter
+    def schema(self, value):
+        if value is None:
+            self._properties["schema"] = None
+        elif not all(isinstance(field, SchemaField) for field in value):
+            raise ValueError("Schema items must be fields")
+        else:
+            self._properties["schema"] = {"fields": _build_schema_resource(value)}
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the table.
+
+        This method always returns a dict. To change a table's labels,
+        modify the dict, then call ``Client.update_table``. To delete a
+        label, set its value to :data:`None` before updating.
+
+        Raises:
+            ValueError: If ``value`` type is invalid.
+        """
+        return self._properties.setdefault("labels", {})
+
+    @labels.setter
+    def labels(self, value):
+        if not isinstance(value, dict):
+            raise ValueError("Pass a dict")
+        self._properties["labels"] = value
+
+    @property
+    def encryption_configuration(self):
+        """google.cloud.bigquery.table.EncryptionConfiguration: Custom
+        encryption configuration for the table.
+
+        Custom encryption configuration (e.g., Cloud KMS keys) or :data:`None`
+        if using default encryption.
+
+        See `protecting data with Cloud KMS keys
+        <https://cloud.google.com/bigquery/docs/customer-managed-encryption>`_
+        in the BigQuery documentation.
+        """
+        prop = self._properties.get("encryptionConfiguration")
+        if prop is not None:
+            prop = EncryptionConfiguration.from_api_repr(prop)
+        return prop
+
+    @encryption_configuration.setter
+    def encryption_configuration(self, value):
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+        self._properties["encryptionConfiguration"] = api_repr
+
+    @property
+    def created(self):
+        """Union[datetime.datetime, None]: Datetime at which the table was
+        created (:data:`None` until set from the server).
+        """
+        creation_time = self._properties.get("creationTime")
+        if creation_time is not None:
+            # creation_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(creation_time)
+            )
+
+    @property
+    def etag(self):
+        """Union[str, None]: ETag for the table resource (:data:`None` until
+        set from the server).
+        """
+        return self._properties.get("etag")
+
+    @property
+    def modified(self):
+        """Union[datetime.datetime, None]: Datetime at which the table was last
+        modified (:data:`None` until set from the server).
+        """
+        modified_time = self._properties.get("lastModifiedTime")
+        if modified_time is not None:
+            # modified_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(modified_time)
+            )
+
+    @property
+    def num_bytes(self):
+        """Union[int, None]: The size of the table in bytes (:data:`None` until
+        set from the server).
+        """
+        return _helpers._int_or_none(self._properties.get("numBytes"))
+
+    @property
+    def num_rows(self):
+        """Union[int, None]: The number of rows in the table (:data:`None`
+        until set from the server).
+        """
+        return _helpers._int_or_none(self._properties.get("numRows"))
+
+    @property
+    def self_link(self):
+        """Union[str, None]: URL for the table resource (:data:`None` until set
+        from the server).
+        """
+        return self._properties.get("selfLink")
+
+    @property
+    def full_table_id(self):
+        """Union[str, None]: ID for the table (:data:`None` until set from the
+        server).
+
+        In the format ``project_id:dataset_id.table_id``.
+        """
+        return self._properties.get("id")
+
+    @property
+    def table_type(self):
+        """Union[str, None]: The type of the table (:data:`None` until set from
+        the server).
+
+        Possible values are ``'TABLE'``, ``'VIEW'``, or ``'EXTERNAL'``.
+        """
+        return self._properties.get("type")
+
+    @property
+    def time_partitioning(self):
+        """google.cloud.bigquery.table.TimePartitioning: Configures time-based
+        partitioning for a table.
+
+        Raises:
+            ValueError:
+                If the value is not :class:`TimePartitioning` or :data:`None`.
+        """
+        prop = self._properties.get("timePartitioning")
+        if prop is not None:
+            return TimePartitioning.from_api_repr(prop)
+
+    @time_partitioning.setter
+    def time_partitioning(self, value):
+        api_repr = value
+        if isinstance(value, TimePartitioning):
+            api_repr = value.to_api_repr()
+        elif value is not None:
+            raise ValueError(
+                "value must be google.cloud.bigquery.table.TimePartitioning " "or None"
+            )
+        self._properties["timePartitioning"] = api_repr
+
+    @property
+    def partitioning_type(self):
+        """Union[str, None]: Time partitioning of the table if it is
+        partitioned (Defaults to :data:`None`).
+
+        The only partitioning type that is currently supported is
+        :attr:`~google.cloud.bigquery.table.TimePartitioningType.DAY`.
+        """
+        warnings.warn(
+            "This method will be deprecated in future versions. Please use "
+            "Table.time_partitioning.type_ instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+        if self.time_partitioning is not None:
+            return self.time_partitioning.type_
+
+    @partitioning_type.setter
+    def partitioning_type(self, value):
+        warnings.warn(
+            "This method will be deprecated in future versions. Please use "
+            "Table.time_partitioning.type_ instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+        if self.time_partitioning is None:
+            self._properties["timePartitioning"] = {}
+        self._properties["timePartitioning"]["type"] = value
+
+    @property
+    def partition_expiration(self):
+        """Union[int, None]: Expiration time in milliseconds for a partition.
+
+        If :attr:`partition_expiration` is set and :attr:`type_` is
+        not set, :attr:`type_` will default to
+        :attr:`~google.cloud.bigquery.table.TimePartitioningType.DAY`.
+        """
+        warnings.warn(
+            "This method will be deprecated in future versions. Please use "
+            "Table.time_partitioning.expiration_ms instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+        if self.time_partitioning is not None:
+            return self.time_partitioning.expiration_ms
+
+    @partition_expiration.setter
+    def partition_expiration(self, value):
+        warnings.warn(
+            "This method will be deprecated in future versions. Please use "
+            "Table.time_partitioning.expiration_ms instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+        if self.time_partitioning is None:
+            self._properties["timePartitioning"] = {"type": TimePartitioningType.DAY}
+        self._properties["timePartitioning"]["expirationMs"] = str(value)
+
+    @property
+    def clustering_fields(self):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+
+        Clustering fields are immutable after table creation.
+
+        .. note::
+
+           As of 2018-06-29, clustering fields cannot be set on a table
+           which does not also have time partioning defined.
+        """
+        prop = self._properties.get("clustering")
+        if prop is not None:
+            return list(prop.get("fields", ()))
+
+    @clustering_fields.setter
+    def clustering_fields(self, value):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+        """
+        if value is not None:
+            prop = self._properties.setdefault("clustering", {})
+            prop["fields"] = value
+        else:
+            if "clustering" in self._properties:
+                del self._properties["clustering"]
+
+    @property
+    def description(self):
+        """Union[str, None]: Description of the table (defaults to
+        :data:`None`).
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        return self._properties.get("description")
+
+    @description.setter
+    def description(self, value):
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["description"] = value
+
+    @property
+    def expires(self):
+        """Union[datetime.datetime, None]: Datetime at which the table will be
+        deleted.
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        expiration_time = self._properties.get("expirationTime")
+        if expiration_time is not None:
+            # expiration_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(expiration_time)
+            )
+
+    @expires.setter
+    def expires(self, value):
+        if not isinstance(value, datetime.datetime) and value is not None:
+            raise ValueError("Pass a datetime, or None")
+        value_ms = google.cloud._helpers._millis_from_datetime(value)
+        self._properties["expirationTime"] = _helpers._str_or_none(value_ms)
+
+    @property
+    def friendly_name(self):
+        """Union[str, None]: Title of the table (defaults to :data:`None`).
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        return self._properties.get("friendlyName")
+
+    @friendly_name.setter
+    def friendly_name(self, value):
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["friendlyName"] = value
+
+    @property
+    def location(self):
+        """Union[str, None]: Location in which the table is hosted
+
+        Defaults to :data:`None`.
+        """
+        return self._properties.get("location")
+
+    @property
+    def view_query(self):
+        """Union[str, None]: SQL query defining the table as a view (defaults
+        to :data:`None`).
+
+        By default, the query is treated as Standard SQL. To use Legacy
+        SQL, set :attr:`view_use_legacy_sql` to :data:`True`.
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        view = self._properties.get("view")
+        if view is not None:
+            return view.get("query")
+
+    @view_query.setter
+    def view_query(self, value):
+        if not isinstance(value, six.string_types):
+            raise ValueError("Pass a string")
+        view = self._properties.get("view")
+        if view is None:
+            view = self._properties["view"] = {}
+        view["query"] = value
+        # The service defaults useLegacySql to True, but this
+        # client uses Standard SQL by default.
+        if view.get("useLegacySql") is None:
+            view["useLegacySql"] = False
+
+    @view_query.deleter
+    def view_query(self):
+        """Delete SQL query defining the table as a view."""
+        self._properties.pop("view", None)
+
+    view_use_legacy_sql = property(_view_use_legacy_sql_getter)
+
+    @view_use_legacy_sql.setter
+    def view_use_legacy_sql(self, value):
+        if not isinstance(value, bool):
+            raise ValueError("Pass a boolean")
+        if self._properties.get("view") is None:
+            self._properties["view"] = {}
+        self._properties["view"]["useLegacySql"] = value
+
+    @property
+    def streaming_buffer(self):
+        """google.cloud.bigquery.StreamingBuffer: Information about a table's
+        streaming buffer.
+        """
+        sb = self._properties.get("streamingBuffer")
+        if sb is not None:
+            return StreamingBuffer(sb)
+
+    @property
+    def external_data_configuration(self):
+        """Union[google.cloud.bigquery.ExternalConfig, None]: Configuration for
+        an external data source (defaults to :data:`None`).
+
+        Raises:
+            ValueError: For invalid value types.
+        """
+        prop = self._properties.get("externalDataConfiguration")
+        if prop is not None:
+            prop = ExternalConfig.from_api_repr(prop)
+        return prop
+
+    @external_data_configuration.setter
+    def external_data_configuration(self, value):
+        if not (value is None or isinstance(value, ExternalConfig)):
+            raise ValueError("Pass an ExternalConfig or None")
+        api_repr = value
+        if value is not None:
+            api_repr = value.to_api_repr()
+        self._properties["externalDataConfiguration"] = api_repr
+
+    @classmethod
+    def from_string(cls, full_table_id):
+        """Construct a table from fully-qualified table ID.
+
+        Args:
+            full_table_id (str):
+                A fully-qualified table ID in standard SQL format. Must
+                included a project ID, dataset ID, and table ID, each
+                separated by ``.``.
+
+        Returns:
+            Table: Table parsed from ``full_table_id``.
+
+        Examples:
+            >>> Table.from_string('my-project.mydataset.mytable')
+            Table(TableRef...(D...('my-project', 'mydataset'), 'mytable'))
+
+        Raises:
+            ValueError:
+                If ``full_table_id`` is not a fully-qualified table ID in
+                standard SQL format.
+        """
+        return cls(TableReference.from_string(full_table_id))
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: construct a table given its API representation
+
+        Args:
+            resource (Dict[str, object]):
+                Table resource representation from the API
+
+        Returns:
+            google.cloud.bigquery.table.Table: Table parsed from ``resource``.
+
+        Raises:
+            KeyError:
+                If the ``resource`` lacks the key ``'tableReference'``, or if
+                the ``dict`` stored within the key ``'tableReference'`` lacks
+                the keys ``'tableId'``, ``'projectId'``, or ``'datasetId'``.
+        """
+        from google.cloud.bigquery import dataset
+
+        if (
+            "tableReference" not in resource
+            or "tableId" not in resource["tableReference"]
+        ):
+            raise KeyError(
+                "Resource lacks required identity information:"
+                '["tableReference"]["tableId"]'
+            )
+        project_id = resource["tableReference"]["projectId"]
+        table_id = resource["tableReference"]["tableId"]
+        dataset_id = resource["tableReference"]["datasetId"]
+        dataset_ref = dataset.DatasetReference(project_id, dataset_id)
+
+        table = cls(dataset_ref.table(table_id))
+        table._properties = resource
+
+        return table
+
+    def to_api_repr(self):
+        """Constructs the API resource of this table
+
+        Returns:
+            Dict[str, object]: Table represented as an API resource
+        """
+        return copy.deepcopy(self._properties)
+
+    def to_bqstorage(self):
+        """Construct a BigQuery Storage API representation of this table.
+
+        Returns:
+            google.cloud.bigquery_storage_v1beta1.types.TableReference:
+                A reference to this table in the BigQuery Storage API.
+        """
+        return self.reference.to_bqstorage()
+
+    def _build_resource(self, filter_fields):
+        """Generate a resource for ``update``."""
+        return _helpers._build_resource_from_properties(self, filter_fields)
+
+    def __repr__(self):
+        return "Table({})".format(repr(self.reference))
+
+
+class TableListItem(object):
+    """A read-only table resource from a list operation.
+
+    For performance reasons, the BigQuery API only includes some of the table
+    properties when listing tables. Notably,
+    :attr:`~google.cloud.bigquery.table.Table.schema` and
+    :attr:`~google.cloud.bigquery.table.Table.num_rows` are missing.
+
+    For a full list of the properties that the BigQuery API returns, see the
+    `REST documentation for tables.list
+    <https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/list>`_.
+
+
+    Args:
+        resource (Dict[str, object]):
+            A table-like resource object from a table list response. A
+            ``tableReference`` property is required.
+
+    Raises:
+        ValueError:
+            If ``tableReference`` or one of its required members is missing
+            from ``resource``.
+    """
+
+    def __init__(self, resource):
+        if "tableReference" not in resource:
+            raise ValueError("resource must contain a tableReference value")
+        if "projectId" not in resource["tableReference"]:
+            raise ValueError(
+                "resource['tableReference'] must contain a projectId value"
+            )
+        if "datasetId" not in resource["tableReference"]:
+            raise ValueError(
+                "resource['tableReference'] must contain a datasetId value"
+            )
+        if "tableId" not in resource["tableReference"]:
+            raise ValueError("resource['tableReference'] must contain a tableId value")
+
+        self._properties = resource
+
+    @property
+    def created(self):
+        """Union[datetime.datetime, None]: Datetime at which the table was
+        created (:data:`None` until set from the server).
+        """
+        creation_time = self._properties.get("creationTime")
+        if creation_time is not None:
+            # creation_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(creation_time)
+            )
+
+    @property
+    def expires(self):
+        """Union[datetime.datetime, None]: Datetime at which the table will be
+        deleted.
+        """
+        expiration_time = self._properties.get("expirationTime")
+        if expiration_time is not None:
+            # expiration_time will be in milliseconds.
+            return google.cloud._helpers._datetime_from_microseconds(
+                1000.0 * float(expiration_time)
+            )
+
+    @property
+    def project(self):
+        """str: Project bound to the table."""
+        return self._properties["tableReference"]["projectId"]
+
+    @property
+    def dataset_id(self):
+        """str: ID of dataset containing the table."""
+        return self._properties["tableReference"]["datasetId"]
+
+    @property
+    def table_id(self):
+        """str: ID of the table."""
+        return self._properties["tableReference"]["tableId"]
+
+    reference = property(_reference_getter)
+
+    @property
+    def labels(self):
+        """Dict[str, str]: Labels for the table.
+
+        This method always returns a dict. To change a table's labels,
+        modify the dict, then call ``Client.update_table``. To delete a
+        label, set its value to :data:`None` before updating.
+        """
+        return self._properties.setdefault("labels", {})
+
+    @property
+    def full_table_id(self):
+        """Union[str, None]: ID for the table (:data:`None` until set from the
+        server).
+
+        In the format ``project_id:dataset_id.table_id``.
+        """
+        return self._properties.get("id")
+
+    @property
+    def table_type(self):
+        """Union[str, None]: The type of the table (:data:`None` until set from
+        the server).
+
+        Possible values are ``'TABLE'``, ``'VIEW'``, or ``'EXTERNAL'``.
+        """
+        return self._properties.get("type")
+
+    @property
+    def time_partitioning(self):
+        """google.cloud.bigquery.table.TimePartitioning: Configures time-based
+        partitioning for a table.
+        """
+        prop = self._properties.get("timePartitioning")
+        if prop is not None:
+            return TimePartitioning.from_api_repr(prop)
+
+    @property
+    def partitioning_type(self):
+        """Union[str, None]: Time partitioning of the table if it is
+        partitioned (Defaults to :data:`None`).
+        """
+        warnings.warn(
+            "This method will be deprecated in future versions. Please use "
+            "TableListItem.time_partitioning.type_ instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+        if self.time_partitioning is not None:
+            return self.time_partitioning.type_
+
+    @property
+    def partition_expiration(self):
+        """Union[int, None]: Expiration time in milliseconds for a partition.
+
+        If this property is set and :attr:`type_` is not set, :attr:`type_`
+        will default to :attr:`TimePartitioningType.DAY`.
+        """
+        warnings.warn(
+            "This method will be deprecated in future versions. Please use "
+            "TableListItem.time_partitioning.expiration_ms instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+        if self.time_partitioning is not None:
+            return self.time_partitioning.expiration_ms
+
+    @property
+    def friendly_name(self):
+        """Union[str, None]: Title of the table (defaults to :data:`None`)."""
+        return self._properties.get("friendlyName")
+
+    view_use_legacy_sql = property(_view_use_legacy_sql_getter)
+
+    @property
+    def clustering_fields(self):
+        """Union[List[str], None]: Fields defining clustering for the table
+
+        (Defaults to :data:`None`).
+
+        Clustering fields are immutable after table creation.
+
+        .. note::
+
+           As of 2018-06-29, clustering fields cannot be set on a table
+           which does not also have time partioning defined.
+        """
+        prop = self._properties.get("clustering")
+        if prop is not None:
+            return list(prop.get("fields", ()))
+
+    @classmethod
+    def from_string(cls, full_table_id):
+        """Construct a table from fully-qualified table ID.
+
+        Args:
+            full_table_id (str):
+                A fully-qualified table ID in standard SQL format. Must
+                included a project ID, dataset ID, and table ID, each
+                separated by ``.``.
+
+        Returns:
+            Table: Table parsed from ``full_table_id``.
+
+        Examples:
+            >>> Table.from_string('my-project.mydataset.mytable')
+            Table(TableRef...(D...('my-project', 'mydataset'), 'mytable'))
+
+        Raises:
+            ValueError:
+                If ``full_table_id`` is not a fully-qualified table ID in
+                standard SQL format.
+        """
+        return cls(
+            {"tableReference": TableReference.from_string(full_table_id).to_api_repr()}
+        )
+
+    def to_bqstorage(self):
+        """Construct a BigQuery Storage API representation of this table.
+
+        Returns:
+            google.cloud.bigquery_storage_v1beta1.types.TableReference:
+                A reference to this table in the BigQuery Storage API.
+        """
+        return self.reference.to_bqstorage()
+
+
+def _row_from_mapping(mapping, schema):
+    """Convert a mapping to a row tuple using the schema.
+
+    Args:
+        mapping (Dict[str, object])
+            Mapping of row data: must contain keys for all required fields in
+            the schema. Keys which do not correspond to a field in the schema
+            are ignored.
+        schema (List[google.cloud.bigquery.schema.SchemaField]):
+            The schema of the table destination for the rows
+
+    Returns:
+        Tuple[object]:
+            Tuple whose elements are ordered according to the schema.
+
+    Raises:
+        ValueError: If schema is empty.
+    """
+    if len(schema) == 0:
+        raise ValueError(_TABLE_HAS_NO_SCHEMA)
+
+    row = []
+    for field in schema:
+        if field.mode == "REQUIRED":
+            row.append(mapping[field.name])
+        elif field.mode == "REPEATED":
+            row.append(mapping.get(field.name, ()))
+        elif field.mode == "NULLABLE":
+            row.append(mapping.get(field.name))
+        else:
+            raise ValueError("Unknown field mode: {}".format(field.mode))
+    return tuple(row)
+
+
+class StreamingBuffer(object):
+    """Information about a table's streaming buffer.
+
+    See https://cloud.google.com/bigquery/streaming-data-into-bigquery.
+
+    Args:
+        resource (Dict[str, object]):
+            streaming buffer representation returned from the API
+    """
+
+    def __init__(self, resource):
+        self.estimated_bytes = int(resource["estimatedBytes"])
+        self.estimated_rows = int(resource["estimatedRows"])
+        # time is in milliseconds since the epoch.
+        self.oldest_entry_time = google.cloud._helpers._datetime_from_microseconds(
+            1000.0 * int(resource["oldestEntryTime"])
+        )
+
+
+class Row(object):
+    """A BigQuery row.
+
+    Values can be accessed by position (index), by key like a dict,
+    or as properties.
+
+    Args:
+        values (Sequence[object]): The row values
+        field_to_index (Dict[str, int]):
+            A mapping from schema field names to indexes
+    """
+
+    # Choose unusual field names to try to avoid conflict with schema fields.
+    __slots__ = ("_xxx_values", "_xxx_field_to_index")
+
+    def __init__(self, values, field_to_index):
+        self._xxx_values = values
+        self._xxx_field_to_index = field_to_index
+
+    def values(self):
+        """Return the values included in this row.
+
+        Returns:
+            Sequence[object]: A sequence of length ``len(row)``.
+        """
+        return copy.deepcopy(self._xxx_values)
+
+    def keys(self):
+        """Return the keys for using a row as a dict.
+
+        Returns:
+            Iterable[str]: The keys corresponding to the columns of a row
+
+        Examples:
+
+            >>> list(Row(('a', 'b'), {'x': 0, 'y': 1}).keys())
+            ['x', 'y']
+        """
+        return six.iterkeys(self._xxx_field_to_index)
+
+    def items(self):
+        """Return items as ``(key, value)`` pairs.
+
+        Returns:
+            Iterable[Tuple[str, object]]:
+                The ``(key, value)`` pairs representing this row.
+
+        Examples:
+
+            >>> list(Row(('a', 'b'), {'x': 0, 'y': 1}).items())
+            [('x', 'a'), ('y', 'b')]
+        """
+        for key, index in six.iteritems(self._xxx_field_to_index):
+            yield (key, copy.deepcopy(self._xxx_values[index]))
+
+    def get(self, key, default=None):
+        """Return a value for key, with a default value if it does not exist.
+
+        Args:
+            key (str): The key of the column to access
+            default (object):
+                The default value to use if the key does not exist. (Defaults
+                to :data:`None`.)
+
+        Returns:
+            object:
+                The value associated with the provided key, or a default value.
+
+        Examples:
+            When the key exists, the value associated with it is returned.
+
+            >>> Row(('a', 'b'), {'x': 0, 'y': 1}).get('x')
+            'a'
+
+            The default value is :data:`None` when the key does not exist.
+
+            >>> Row(('a', 'b'), {'x': 0, 'y': 1}).get('z')
+            None
+
+            The default value can be overrided with the ``default`` parameter.
+
+            >>> Row(('a', 'b'), {'x': 0, 'y': 1}).get('z', '')
+            ''
+
+            >>> Row(('a', 'b'), {'x': 0, 'y': 1}).get('z', default = '')
+            ''
+        """
+        index = self._xxx_field_to_index.get(key)
+        if index is None:
+            return default
+        return self._xxx_values[index]
+
+    def __getattr__(self, name):
+        value = self._xxx_field_to_index.get(name)
+        if value is None:
+            raise AttributeError("no row field {!r}".format(name))
+        return self._xxx_values[value]
+
+    def __len__(self):
+        return len(self._xxx_values)
+
+    def __getitem__(self, key):
+        if isinstance(key, six.string_types):
+            value = self._xxx_field_to_index.get(key)
+            if value is None:
+                raise KeyError("no row field {!r}".format(key))
+            key = value
+        return self._xxx_values[key]
+
+    def __eq__(self, other):
+        if not isinstance(other, Row):
+            return NotImplemented
+        return (
+            self._xxx_values == other._xxx_values
+            and self._xxx_field_to_index == other._xxx_field_to_index
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        # sort field dict by value, for determinism
+        items = sorted(self._xxx_field_to_index.items(), key=operator.itemgetter(1))
+        f2i = "{" + ", ".join("%r: %d" % item for item in items) + "}"
+        return "Row({}, {})".format(self._xxx_values, f2i)
+
+
+class _NoopProgressBarQueue(object):
+    """A fake Queue class that does nothing.
+
+    This is used when there is no progress bar to send updates to.
+    """
+
+    def put_nowait(self, item):
+        """Don't actually do anything with the item."""
+
+
+class RowIterator(HTTPIterator):
+    """A class for iterating through HTTP/JSON API row list responses.
+
+    Args:
+        client (google.cloud.bigquery.Client): The API client.
+        api_request (Callable[google.cloud._http.JSONConnection.api_request]):
+            The function to use to make API requests.
+        path (str): The method path to query for the list of items.
+        page_token (str): A token identifying a page in a result set to start
+            fetching results from.
+        max_results (int, optional): The maximum number of results to fetch.
+        page_size (int, optional): The maximum number of rows in each page
+            of results from this request. Non-positive values are ignored.
+            Defaults to a sensible value set by the API.
+        extra_params (Dict[str, object]):
+            Extra query string parameters for the API call.
+        table (Union[ \
+            :class:`~google.cloud.bigquery.table.Table`, \
+            :class:`~google.cloud.bigquery.table.TableReference`, \
+        ]):
+            Optional. The table which these rows belong to, or a reference to
+            it. Used to call the BigQuery Storage API to fetch rows.
+        selected_fields (Sequence[ \
+            google.cloud.bigquery.schema.SchemaField, \
+        ]):
+            Optional. A subset of columns to select from this table.
+
+    """
+
+    def __init__(
+        self,
+        client,
+        api_request,
+        path,
+        schema,
+        page_token=None,
+        max_results=None,
+        page_size=None,
+        extra_params=None,
+        table=None,
+        selected_fields=None,
+    ):
+        super(RowIterator, self).__init__(
+            client,
+            api_request,
+            path,
+            item_to_value=_item_to_row,
+            items_key="rows",
+            page_token=page_token,
+            max_results=max_results,
+            extra_params=extra_params,
+            page_start=_rows_page_start,
+            next_token="pageToken",
+        )
+        self._field_to_index = _helpers._field_to_index_mapping(schema)
+        self._page_size = page_size
+        self._preserve_order = False
+        self._project = client.project
+        self._schema = schema
+        self._selected_fields = selected_fields
+        self._table = table
+        self._total_rows = getattr(table, "num_rows", None)
+
+    def _get_next_page_response(self):
+        """Requests the next page from the path provided.
+
+        Returns:
+            Dict[str, object]:
+                The parsed JSON response of the next page's contents.
+        """
+        params = self._get_query_params()
+        if self._page_size is not None:
+            params["maxResults"] = self._page_size
+        return self.api_request(
+            method=self._HTTP_METHOD, path=self.path, query_params=params
+        )
+
+    @property
+    def schema(self):
+        """List[google.cloud.bigquery.schema.SchemaField]: The subset of
+        columns to be read from the table."""
+        return list(self._schema)
+
+    @property
+    def total_rows(self):
+        """int: The total number of rows in the table."""
+        return self._total_rows
+
+    def _get_progress_bar(self, progress_bar_type):
+        """Construct a tqdm progress bar object, if tqdm is installed."""
+        if tqdm is None:
+            if progress_bar_type is not None:
+                warnings.warn(_NO_TQDM_ERROR, UserWarning, stacklevel=3)
+            return None
+
+        description = "Downloading"
+        unit = "rows"
+
+        try:
+            if progress_bar_type == "tqdm":
+                return tqdm.tqdm(desc=description, total=self.total_rows, unit=unit)
+            elif progress_bar_type == "tqdm_notebook":
+                return tqdm.tqdm_notebook(
+                    desc=description, total=self.total_rows, unit=unit
+                )
+            elif progress_bar_type == "tqdm_gui":
+                return tqdm.tqdm_gui(desc=description, total=self.total_rows, unit=unit)
+        except (KeyError, TypeError):
+            # Protect ourselves from any tqdm errors. In case of
+            # unexpected tqdm behavior, just fall back to showing
+            # no progress bar.
+            warnings.warn(_NO_TQDM_ERROR, UserWarning, stacklevel=3)
+        return None
+
+    def _to_page_iterable(
+        self, bqstorage_download, tabledata_list_download, bqstorage_client=None
+    ):
+        if bqstorage_client is not None:
+            try:
+                # Iterate over the stream so that read errors are raised (and
+                # the method can then fallback to tabledata.list).
+                for item in bqstorage_download():
+                    yield item
+                return
+            except google.api_core.exceptions.Forbidden:
+                # Don't hide errors such as insufficient permissions to create
+                # a read session, or the API is not enabled. Both of those are
+                # clearly problems if the developer has explicitly asked for
+                # BigQuery Storage API support.
+                raise
+            except google.api_core.exceptions.GoogleAPICallError:
+                # There is a known issue with reading from small anonymous
+                # query results tables, so some errors are expected. Rather
+                # than throw those errors, try reading the DataFrame again, but
+                # with the tabledata.list API.
+                pass
+
+        _LOGGER.debug(
+            "Started reading table '{}.{}.{}' with tabledata.list.".format(
+                self._table.project, self._table.dataset_id, self._table.table_id
+            )
+        )
+        for item in tabledata_list_download():
+            yield item
+
+    def _to_arrow_iterable(self, bqstorage_client=None):
+        """Create an iterable of arrow RecordBatches, to process the table as a stream."""
+        bqstorage_download = functools.partial(
+            _pandas_helpers.download_arrow_bqstorage,
+            self._project,
+            self._table,
+            bqstorage_client,
+            preserve_order=self._preserve_order,
+            selected_fields=self._selected_fields,
+        )
+        tabledata_list_download = functools.partial(
+            _pandas_helpers.download_arrow_tabledata_list, iter(self.pages), self.schema
+        )
+        return self._to_page_iterable(
+            bqstorage_download,
+            tabledata_list_download,
+            bqstorage_client=bqstorage_client,
+        )
+
+    # If changing the signature of this method, make sure to apply the same
+    # changes to job.QueryJob.to_arrow()
+    def to_arrow(self, progress_bar_type=None, bqstorage_client=None):
+        """[Beta] Create a class:`pyarrow.Table` by loading all pages of a
+        table or query.
+
+        Args:
+            progress_bar_type (Optional[str]):
+                If set, use the `tqdm <https://tqdm.github.io/>`_ library to
+                display a progress bar while the data downloads. Install the
+                ``tqdm`` package to use this feature.
+
+                Possible values of ``progress_bar_type`` include:
+
+                ``None``
+                  No progress bar.
+                ``'tqdm'``
+                  Use the :func:`tqdm.tqdm` function to print a progress bar
+                  to :data:`sys.stderr`.
+                ``'tqdm_notebook'``
+                  Use the :func:`tqdm.tqdm_notebook` function to display a
+                  progress bar as a Jupyter notebook widget.
+                ``'tqdm_gui'``
+                  Use the :func:`tqdm.tqdm_gui` function to display a
+                  progress bar as a graphical dialog box.
+            bqstorage_client ( \
+                google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient \
+            ):
+                **Beta Feature** Optional. A BigQuery Storage API client. If
+                supplied, use the faster BigQuery Storage API to fetch rows
+                from BigQuery. This API is a billable API.
+
+                This method requires the ``pyarrow`` and
+                ``google-cloud-bigquery-storage`` libraries.
+
+                Reading from a specific partition or snapshot is not
+                currently supported by this method.
+
+        Returns:
+            pyarrow.Table
+                A :class:`pyarrow.Table` populated with row data and column
+                headers from the query results. The column headers are derived
+                from the destination table's schema.
+
+        Raises:
+            ValueError:
+                If the :mod:`pyarrow` library cannot be imported.
+
+        ..versionadded:: 1.17.0
+        """
+        if pyarrow is None:
+            raise ValueError(_NO_PYARROW_ERROR)
+
+        progress_bar = self._get_progress_bar(progress_bar_type)
+
+        record_batches = []
+        for record_batch in self._to_arrow_iterable(bqstorage_client=bqstorage_client):
+            record_batches.append(record_batch)
+
+            if progress_bar is not None:
+                # In some cases, the number of total rows is not populated
+                # until the first page of rows is fetched. Update the
+                # progress bar's total to keep an accurate count.
+                progress_bar.total = progress_bar.total or self.total_rows
+                progress_bar.update(record_batch.num_rows)
+
+        if progress_bar is not None:
+            # Indicate that the download has finished.
+            progress_bar.close()
+
+        if record_batches:
+            return pyarrow.Table.from_batches(record_batches)
+        else:
+            # No records, use schema based on BigQuery schema.
+            arrow_schema = _pandas_helpers.bq_to_arrow_schema(self._schema)
+            return pyarrow.Table.from_batches(record_batches, schema=arrow_schema)
+
+    def _to_dataframe_iterable(self, bqstorage_client=None, dtypes=None):
+        """Create an iterable of pandas DataFrames, to process the table as a stream.
+
+        See ``to_dataframe`` for argument descriptions.
+        """
+        column_names = [field.name for field in self._schema]
+        bqstorage_download = functools.partial(
+            _pandas_helpers.download_dataframe_bqstorage,
+            self._project,
+            self._table,
+            bqstorage_client,
+            column_names,
+            dtypes,
+            preserve_order=self._preserve_order,
+            selected_fields=self._selected_fields,
+        )
+        tabledata_list_download = functools.partial(
+            _pandas_helpers.download_dataframe_tabledata_list,
+            iter(self.pages),
+            self.schema,
+            dtypes,
+        )
+        return self._to_page_iterable(
+            bqstorage_download,
+            tabledata_list_download,
+            bqstorage_client=bqstorage_client,
+        )
+
+    # If changing the signature of this method, make sure to apply the same
+    # changes to job.QueryJob.to_dataframe()
+    def to_dataframe(self, bqstorage_client=None, dtypes=None, progress_bar_type=None):
+        """Create a pandas DataFrame by loading all pages of a query.
+
+        Args:
+            bqstorage_client ( \
+                google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient \
+            ):
+                **Beta Feature** Optional. A BigQuery Storage API client. If
+                supplied, use the faster BigQuery Storage API to fetch rows
+                from BigQuery. This API is a billable API.
+
+                This method requires the ``pyarrow`` and
+                ``google-cloud-bigquery-storage`` libraries.
+
+                Reading from a specific partition or snapshot is not
+                currently supported by this method.
+
+                **Caution**: There is a known issue reading small anonymous
+                query result tables with the BQ Storage API. When a problem
+                is encountered reading a table, the tabledata.list method
+                from the BigQuery API is used, instead.
+            dtypes ( \
+                Map[str, Union[str, pandas.Series.dtype]] \
+            ):
+                Optional. A dictionary of column names pandas ``dtype``s. The
+                provided ``dtype`` is used when constructing the series for
+                the column specified. Otherwise, the default pandas behavior
+                is used.
+            progress_bar_type (Optional[str]):
+                If set, use the `tqdm <https://tqdm.github.io/>`_ library to
+                display a progress bar while the data downloads. Install the
+                ``tqdm`` package to use this feature.
+
+                Possible values of ``progress_bar_type`` include:
+
+                ``None``
+                  No progress bar.
+                ``'tqdm'``
+                  Use the :func:`tqdm.tqdm` function to print a progress bar
+                  to :data:`sys.stderr`.
+                ``'tqdm_notebook'``
+                  Use the :func:`tqdm.tqdm_notebook` function to display a
+                  progress bar as a Jupyter notebook widget.
+                ``'tqdm_gui'``
+                  Use the :func:`tqdm.tqdm_gui` function to display a
+                  progress bar as a graphical dialog box.
+
+                ..versionadded:: 1.11.0
+
+        Returns:
+            pandas.DataFrame:
+                A :class:`~pandas.DataFrame` populated with row data and column
+                headers from the query results. The column headers are derived
+                from the destination table's schema.
+
+        Raises:
+            ValueError:
+                If the :mod:`pandas` library cannot be imported, or the
+                :mod:`google.cloud.bigquery_storage_v1beta1` module is
+                required but cannot be imported.
+
+        """
+        if pandas is None:
+            raise ValueError(_NO_PANDAS_ERROR)
+        if dtypes is None:
+            dtypes = {}
+
+        progress_bar = self._get_progress_bar(progress_bar_type)
+
+        frames = []
+        for frame in self._to_dataframe_iterable(
+            bqstorage_client=bqstorage_client, dtypes=dtypes
+        ):
+            frames.append(frame)
+
+            if progress_bar is not None:
+                # In some cases, the number of total rows is not populated
+                # until the first page of rows is fetched. Update the
+                # progress bar's total to keep an accurate count.
+                progress_bar.total = progress_bar.total or self.total_rows
+                progress_bar.update(len(frame))
+
+        if progress_bar is not None:
+            # Indicate that the download has finished.
+            progress_bar.close()
+
+        # Avoid concatting an empty list.
+        if not frames:
+            column_names = [field.name for field in self._schema]
+            return pandas.DataFrame(columns=column_names)
+        return pandas.concat(frames, ignore_index=True)
+
+
+class _EmptyRowIterator(object):
+    """An empty row iterator.
+
+    This class prevents API requests when there are no rows to fetch or rows
+    are impossible to fetch, such as with query results for DDL CREATE VIEW
+    statements.
+    """
+
+    schema = ()
+    pages = ()
+    total_rows = 0
+
+    def to_arrow(self, progress_bar_type=None):
+        """[Beta] Create an empty class:`pyarrow.Table`.
+
+        Args:
+            progress_bar_type (Optional[str]):
+                Ignored. Added for compatibility with RowIterator.
+
+        Returns:
+            pyarrow.Table:
+                An empty :class:`pyarrow.Table`.
+        """
+        if pyarrow is None:
+            raise ValueError(_NO_PYARROW_ERROR)
+        return pyarrow.Table.from_arrays(())
+
+    def to_dataframe(self, bqstorage_client=None, dtypes=None, progress_bar_type=None):
+        """Create an empty dataframe.
+
+        Args:
+            bqstorage_client (Any):
+                Ignored. Added for compatibility with RowIterator.
+            dtypes (Any):
+                Ignored. Added for compatibility with RowIterator.
+            progress_bar_type (Any):
+                Ignored. Added for compatibility with RowIterator.
+
+        Returns:
+            pandas.DataFrame:
+                An empty :class:`~pandas.DataFrame`.
+        """
+        if pandas is None:
+            raise ValueError(_NO_PANDAS_ERROR)
+        return pandas.DataFrame()
+
+    def __iter__(self):
+        return iter(())
+
+
+class TimePartitioningType(object):
+    """Specifies the type of time partitioning to perform."""
+
+    DAY = "DAY"
+    """str: Generates one partition per day."""
+
+
+class TimePartitioning(object):
+    """Configures time-based partitioning for a table.
+
+    Args:
+        type_ (google.cloud.bigquery.table.TimePartitioningType, optional):
+            Specifies the type of time partitioning to perform. Defaults to
+            :attr:`~google.cloud.bigquery.table.TimePartitioningType.DAY`,
+            which is the only currently supported type.
+        field (str, optional):
+            If set, the table is partitioned by this field. If not set, the
+            table is partitioned by pseudo column ``_PARTITIONTIME``. The field
+            must be a top-level ``TIMESTAMP`` or ``DATE`` field. Its mode must
+            be ``NULLABLE`` or ``REQUIRED``.
+        expiration_ms(int, optional):
+            Number of milliseconds for which to keep the storage for a
+            partition.
+        require_partition_filter (bool, optional):
+            If set to true, queries over the partitioned table require a
+            partition filter that can be used for partition elimination to be
+            specified.
+    """
+
+    def __init__(
+        self, type_=None, field=None, expiration_ms=None, require_partition_filter=None
+    ):
+        self._properties = {}
+        if type_ is None:
+            self.type_ = TimePartitioningType.DAY
+        else:
+            self.type_ = type_
+        if field is not None:
+            self.field = field
+        if expiration_ms is not None:
+            self.expiration_ms = expiration_ms
+        if require_partition_filter is not None:
+            self.require_partition_filter = require_partition_filter
+
+    @property
+    def type_(self):
+        """google.cloud.bigquery.table.TimePartitioningType: The type of time
+        partitioning to use.
+        """
+        return self._properties.get("type")
+
+    @type_.setter
+    def type_(self, value):
+        self._properties["type"] = value
+
+    @property
+    def field(self):
+        """str: Field in the table to use for partitioning"""
+        return self._properties.get("field")
+
+    @field.setter
+    def field(self, value):
+        self._properties["field"] = value
+
+    @property
+    def expiration_ms(self):
+        """int: Number of milliseconds to keep the storage for a partition."""
+        return _helpers._int_or_none(self._properties.get("expirationMs"))
+
+    @expiration_ms.setter
+    def expiration_ms(self, value):
+        if value is not None:
+            # Allow explicitly setting the expiration to None.
+            value = str(value)
+        self._properties["expirationMs"] = value
+
+    @property
+    def require_partition_filter(self):
+        """bool: Specifies whether partition filters are required for queries
+        """
+        return self._properties.get("requirePartitionFilter")
+
+    @require_partition_filter.setter
+    def require_partition_filter(self, value):
+        self._properties["requirePartitionFilter"] = value
+
+    @classmethod
+    def from_api_repr(cls, api_repr):
+        """Return a :class:`TimePartitioning` object deserialized from a dict.
+
+        This method creates a new ``TimePartitioning`` instance that points to
+        the ``api_repr`` parameter as its internal properties dict. This means
+        that when a ``TimePartitioning`` instance is stored as a property of
+        another object, any changes made at the higher level will also appear
+        here::
+
+            >>> time_partitioning = TimePartitioning()
+            >>> table.time_partitioning = time_partitioning
+            >>> table.time_partitioning.field = 'timecolumn'
+            >>> time_partitioning.field
+            'timecolumn'
+
+        Args:
+            api_repr (Mapping[str, str]):
+                The serialized representation of the TimePartitioning, such as
+                what is output by :meth:`to_api_repr`.
+
+        Returns:
+            google.cloud.bigquery.table.TimePartitioning:
+                The ``TimePartitioning`` object.
+        """
+        instance = cls()
+        instance._properties = api_repr
+        return instance
+
+    def to_api_repr(self):
+        """Return a dictionary representing this object.
+
+        This method returns the properties dict of the ``TimePartitioning``
+        instance rather than making a copy. This means that when a
+        ``TimePartitioning`` instance is stored as a property of another
+        object, any changes made at the higher level will also appear here.
+
+        Returns:
+            dict:
+                A dictionary representing the TimePartitioning object in
+                serialized form.
+        """
+        return self._properties
+
+    def _key(self):
+        return tuple(sorted(self._properties.items()))
+
+    def __eq__(self, other):
+        if not isinstance(other, TimePartitioning):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __repr__(self):
+        key_vals = ["{}={}".format(key, val) for key, val in self._key()]
+        return "TimePartitioning({})".format(",".join(key_vals))
+
+
+def _item_to_row(iterator, resource):
+    """Convert a JSON row to the native object.
+
+    .. note::
+
+        This assumes that the ``schema`` attribute has been
+        added to the iterator after being created, which
+        should be done by the caller.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: An item to be converted to a row.
+
+    :rtype: :class:`~google.cloud.bigquery.table.Row`
+    :returns: The next row in the page.
+    """
+    return Row(
+        _helpers._row_tuple_from_json(resource, iterator.schema),
+        iterator._field_to_index,
+    )
+
+
+def _tabledata_list_page_columns(schema, response):
+    """Make a generator of all the columns in a page from tabledata.list.
+
+    This enables creating a :class:`pandas.DataFrame` and other
+    column-oriented data structures such as :class:`pyarrow.RecordBatch`
+    """
+    columns = []
+    rows = response.get("rows", [])
+
+    def get_column_data(field_index, field):
+        for row in rows:
+            yield _helpers._field_from_json(row["f"][field_index]["v"], field)
+
+    for field_index, field in enumerate(schema):
+        columns.append(get_column_data(field_index, field))
+
+    return columns
+
+
+# pylint: disable=unused-argument
+def _rows_page_start(iterator, page, response):
+    """Grab total rows when :class:`~google.cloud.iterator.Page` starts.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type page: :class:`~google.api_core.page_iterator.Page`
+    :param page: The page that was just created.
+
+    :type response: dict
+    :param response: The JSON API response for a page of rows in a table.
+    """
+    # Make a (lazy) copy of the page in column-oriented format for use in data
+    # science packages.
+    page._columns = _tabledata_list_page_columns(iterator._schema, response)
+
+    total_rows = response.get("totalRows")
+    if total_rows is not None:
+        total_rows = int(total_rows)
+    iterator._total_rows = total_rows
+
+
+# pylint: enable=unused-argument
+
+
+def _table_arg_to_table_ref(value, default_project=None):
+    """Helper to convert a string or Table to TableReference.
+
+    This function keeps TableReference and other kinds of objects unchanged.
+    """
+    if isinstance(value, six.string_types):
+        value = TableReference.from_string(value, default_project=default_project)
+    if isinstance(value, (Table, TableListItem)):
+        value = value.reference
+    return value
+
+
+def _table_arg_to_table(value, default_project=None):
+    """Helper to convert a string or TableReference to a Table.
+
+    This function keeps Table and other kinds of objects unchanged.
+    """
+    if isinstance(value, six.string_types):
+        value = TableReference.from_string(value, default_project=default_project)
+    if isinstance(value, TableReference):
+        value = Table(value)
+    if isinstance(value, TableListItem):
+        newvalue = Table(value.reference)
+        newvalue._properties = value._properties
+        value = newvalue
+
+    return value
diff --git a/bigquery/google/cloud/bigquery_v2/__init__.py b/bigquery/google/cloud/bigquery_v2/__init__.py
new file mode 100644
index 000000000000..e582214329f3
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/__init__.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import pkg_resources
+
+__version__ = pkg_resources.get_distribution("google-cloud-bigquery").version  # noqa
+
+from google.cloud.bigquery_v2 import types
+from google.cloud.bigquery_v2.gapic import enums
+
+
+__all__ = (
+    # google.cloud.bigquery_v2
+    "__version__",
+    "types",
+    # google.cloud.bigquery_v2
+    "enums",
+)
diff --git a/bigquery/google/cloud/bigquery_v2/gapic/__init__.py b/bigquery/google/cloud/bigquery_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/google/cloud/bigquery_v2/gapic/enums.py b/bigquery/google/cloud/bigquery_v2/gapic/enums.py
new file mode 100644
index 000000000000..5d95f2590785
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/gapic/enums.py
@@ -0,0 +1,171 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Model(object):
+    class DataSplitMethod(enum.IntEnum):
+        """
+        Indicates the method to split input data into multiple tables.
+
+        Attributes:
+          DATA_SPLIT_METHOD_UNSPECIFIED (int)
+          RANDOM (int): Splits data randomly.
+          CUSTOM (int): Splits data with the user provided tags.
+          SEQUENTIAL (int): Splits data sequentially.
+          NO_SPLIT (int): Data split will be skipped.
+          AUTO_SPLIT (int): Splits data automatically: Uses NO\_SPLIT if the data size is small.
+          Otherwise uses RANDOM.
+        """
+
+        DATA_SPLIT_METHOD_UNSPECIFIED = 0
+        RANDOM = 1
+        CUSTOM = 2
+        SEQUENTIAL = 3
+        NO_SPLIT = 4
+        AUTO_SPLIT = 5
+
+    class DistanceType(enum.IntEnum):
+        """
+        Distance metric used to compute the distance between two points.
+
+        Attributes:
+          DISTANCE_TYPE_UNSPECIFIED (int)
+          EUCLIDEAN (int): Eculidean distance.
+          COSINE (int): Cosine distance.
+        """
+
+        DISTANCE_TYPE_UNSPECIFIED = 0
+        EUCLIDEAN = 1
+        COSINE = 2
+
+    class LearnRateStrategy(enum.IntEnum):
+        """
+        Indicates the learning rate optimization strategy to use.
+
+        Attributes:
+          LEARN_RATE_STRATEGY_UNSPECIFIED (int)
+          LINE_SEARCH (int): Use line search to determine learning rate.
+          CONSTANT (int): Use a constant learning rate.
+        """
+
+        LEARN_RATE_STRATEGY_UNSPECIFIED = 0
+        LINE_SEARCH = 1
+        CONSTANT = 2
+
+    class LossType(enum.IntEnum):
+        """
+        Loss metric to evaluate model training performance.
+
+        Attributes:
+          LOSS_TYPE_UNSPECIFIED (int)
+          MEAN_SQUARED_LOSS (int): Mean squared loss, used for linear regression.
+          MEAN_LOG_LOSS (int): Mean log loss, used for logistic regression.
+        """
+
+        LOSS_TYPE_UNSPECIFIED = 0
+        MEAN_SQUARED_LOSS = 1
+        MEAN_LOG_LOSS = 2
+
+    class ModelType(enum.IntEnum):
+        """
+        Indicates the type of the Model.
+
+        Attributes:
+          MODEL_TYPE_UNSPECIFIED (int)
+          LINEAR_REGRESSION (int): Linear regression model.
+          LOGISTIC_REGRESSION (int): Logistic regression based classification model.
+          KMEANS (int): K-means clustering model.
+          TENSORFLOW (int): [Beta] An imported TensorFlow model.
+        """
+
+        MODEL_TYPE_UNSPECIFIED = 0
+        LINEAR_REGRESSION = 1
+        LOGISTIC_REGRESSION = 2
+        KMEANS = 3
+        TENSORFLOW = 6
+
+    class OptimizationStrategy(enum.IntEnum):
+        """
+        Indicates the optimization strategy used for training.
+
+        Attributes:
+          OPTIMIZATION_STRATEGY_UNSPECIFIED (int)
+          BATCH_GRADIENT_DESCENT (int): Uses an iterative batch gradient descent algorithm.
+          NORMAL_EQUATION (int): Uses a normal equation to solve linear regression problem.
+        """
+
+        OPTIMIZATION_STRATEGY_UNSPECIFIED = 0
+        BATCH_GRADIENT_DESCENT = 1
+        NORMAL_EQUATION = 2
+
+    class KmeansEnums(object):
+        class KmeansInitializationMethod(enum.IntEnum):
+            """
+            Indicates the method used to initialize the centroids for KMeans
+            clustering algorithm.
+
+            Attributes:
+              KMEANS_INITIALIZATION_METHOD_UNSPECIFIED (int)
+              RANDOM (int): Initializes the centroids randomly.
+              CUSTOM (int): Initializes the centroids using data specified in
+              kmeans\_initialization\_column.
+            """
+
+            KMEANS_INITIALIZATION_METHOD_UNSPECIFIED = 0
+            RANDOM = 1
+            CUSTOM = 2
+
+
+class StandardSqlDataType(object):
+    class TypeKind(enum.IntEnum):
+        """
+        Attributes:
+          TYPE_KIND_UNSPECIFIED (int): Invalid type.
+          INT64 (int): Encoded as a string in decimal format.
+          BOOL (int): Encoded as a boolean "false" or "true".
+          FLOAT64 (int): Encoded as a number, or string "NaN", "Infinity" or "-Infinity".
+          STRING (int): Encoded as a string value.
+          BYTES (int): Encoded as a base64 string per RFC 4648, section 4.
+          TIMESTAMP (int): Encoded as an RFC 3339 timestamp with mandatory "Z" time zone string:
+          1985-04-12T23:20:50.52Z
+          DATE (int): Encoded as RFC 3339 full-date format string: 1985-04-12
+          TIME (int): Encoded as RFC 3339 partial-time format string: 23:20:50.52
+          DATETIME (int): Encoded as RFC 3339 full-date "T" partial-time: 1985-04-12T23:20:50.52
+          GEOGRAPHY (int): Encoded as WKT
+          NUMERIC (int): Encoded as a decimal string.
+          ARRAY (int): Encoded as a list with types matching Type.array\_type.
+          STRUCT (int): Encoded as a list with fields of type Type.struct\_type[i]. List is used
+          because a JSON object cannot have duplicate field names.
+        """
+
+        TYPE_KIND_UNSPECIFIED = 0
+        INT64 = 2
+        BOOL = 5
+        FLOAT64 = 7
+        STRING = 8
+        BYTES = 9
+        TIMESTAMP = 19
+        DATE = 10
+        TIME = 20
+        DATETIME = 21
+        GEOGRAPHY = 22
+        NUMERIC = 23
+        ARRAY = 16
+        STRUCT = 17
diff --git a/bigquery/google/cloud/bigquery_v2/proto/__init__.py b/bigquery/google/cloud/bigquery_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/google/cloud/bigquery_v2/proto/location_metadata.proto b/bigquery/google/cloud/bigquery_v2/proto/location_metadata.proto
new file mode 100644
index 000000000000..95a3133c5755
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/location_metadata.proto
@@ -0,0 +1,34 @@
+// 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/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery";
+option java_outer_classname = "LocationMetadataProto";
+option java_package = "com.google.cloud.bigquery.v2";
+
+
+// BigQuery-specific metadata about a location. This will be set on
+// google.cloud.location.Location.metadata in Cloud Location API
+// responses.
+message LocationMetadata {
+  // The legacy BigQuery location ID, e.g. “EU” for the “europe” location.
+  // This is for any API consumers that need the legacy “US” and “EU” locations.
+  string legacy_location_id = 1;
+}
diff --git a/bigquery/google/cloud/bigquery_v2/proto/location_metadata_pb2.py b/bigquery/google/cloud/bigquery_v2/proto/location_metadata_pb2.py
new file mode 100644
index 000000000000..6dd9da52e4ed
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/location_metadata_pb2.py
@@ -0,0 +1,98 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery_v2/proto/location_metadata.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery_v2/proto/location_metadata.proto",
+    package="google.cloud.bigquery.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.bigquery.v2B\025LocationMetadataProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/bigquery_v2/proto/location_metadata.proto\x12\x18google.cloud.bigquery.v2\x1a\x1cgoogle/api/annotations.proto".\n\x10LocationMetadata\x12\x1a\n\x12legacy_location_id\x18\x01 \x01(\tBw\n\x1c\x63om.google.cloud.bigquery.v2B\x15LocationMetadataProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigqueryb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_LOCATIONMETADATA = _descriptor.Descriptor(
+    name="LocationMetadata",
+    full_name="google.cloud.bigquery.v2.LocationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="legacy_location_id",
+            full_name="google.cloud.bigquery.v2.LocationMetadata.legacy_location_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=114,
+    serialized_end=160,
+)
+
+DESCRIPTOR.message_types_by_name["LocationMetadata"] = _LOCATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LocationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LocationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONMETADATA,
+        __module__="google.cloud.bigquery_v2.proto.location_metadata_pb2",
+        __doc__="""BigQuery-specific metadata about a location. This will be set on
+  google.cloud.location.Location.metadata in Cloud Location API responses.
+  
+  
+  Attributes:
+      legacy_location_id:
+          The legacy BigQuery location ID, e.g. ``EU`` for the ``europe``
+          location. This is for any API consumers that need the legacy
+          ``US`` and ``EU`` locations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.LocationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LocationMetadata)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery/google/cloud/bigquery_v2/proto/location_metadata_pb2_grpc.py b/bigquery/google/cloud/bigquery_v2/proto/location_metadata_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/location_metadata_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery/google/cloud/bigquery_v2/proto/model.proto b/bigquery/google/cloud/bigquery_v2/proto/model.proto
new file mode 100644
index 000000000000..42246e8efff2
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/model.proto
@@ -0,0 +1,632 @@
+// 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/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";
+option java_package = "com.google.cloud.bigquery.v2";
+
+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) {
+  }
+
+  // Lists all models in the specified dataset. Requires the READER dataset
+  // role.
+  rpc ListModels(ListModelsRequest) returns (ListModelsResponse) {
+  }
+
+  // Patch specific fields in the specified model.
+  rpc PatchModel(PatchModelRequest) returns (Model) {
+  }
+
+  // Deletes the model specified by modelId from the dataset.
+  rpc DeleteModel(DeleteModelRequest) returns (google.protobuf.Empty) {
+  }
+}
+
+message Model {
+  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;
+
+    // Mean squared error.
+    google.protobuf.DoubleValue mean_squared_error = 2;
+
+    // Mean squared log error.
+    google.protobuf.DoubleValue mean_squared_log_error = 3;
+
+    // Median absolute error.
+    google.protobuf.DoubleValue median_absolute_error = 4;
+
+    // R^2 score.
+    google.protobuf.DoubleValue r_squared = 5;
+  }
+
+  // Aggregate metrics for classification/classifier models. For multi-class
+  // models, the metrics are either macro-averaged or micro-averaged. When
+  // macro-averaged, the metrics are calculated for each label and then an
+  // unweighted average is taken of those values. When micro-averaged, the
+  // metric is calculated globally by counting the total number of correctly
+  // predicted rows.
+  message AggregateClassificationMetrics {
+    // Precision is the fraction of actual positive predictions that had
+    // positive actual labels. For multiclass this is a macro-averaged
+    // metric treating each class as a binary classifier.
+    google.protobuf.DoubleValue precision = 1;
+
+    // Recall is the fraction of actual positive labels that were given a
+    // positive prediction. For multiclass this is a macro-averaged metric.
+    google.protobuf.DoubleValue recall = 2;
+
+    // Accuracy is the fraction of predictions given the correct label. For
+    // multiclass this is a micro-averaged metric.
+    google.protobuf.DoubleValue accuracy = 3;
+
+    // Threshold at which the metrics are computed. For binary
+    // classification models this is the positive class threshold.
+    // For multi-class classfication models this is the confidence
+    // threshold.
+    google.protobuf.DoubleValue threshold = 4;
+
+    // The F1 score is an average of recall and precision. For multiclass
+    // this is a macro-averaged metric.
+    google.protobuf.DoubleValue f1_score = 5;
+
+    // Logarithmic Loss. For multiclass this is a macro-averaged metric.
+    google.protobuf.DoubleValue log_loss = 6;
+
+    // Area Under a ROC Curve. For multiclass this is a macro-averaged
+    // metric.
+    google.protobuf.DoubleValue roc_auc = 7;
+  }
+
+  // Evaluation metrics for binary classification/classifier models.
+  message BinaryClassificationMetrics {
+    // Confusion matrix for binary classification models.
+    message BinaryConfusionMatrix {
+      // Threshold value used when computing each of the following metric.
+      google.protobuf.DoubleValue positive_class_threshold = 1;
+
+      // Number of true samples predicted as true.
+      google.protobuf.Int64Value true_positives = 2;
+
+      // Number of false samples predicted as true.
+      google.protobuf.Int64Value false_positives = 3;
+
+      // Number of true samples predicted as false.
+      google.protobuf.Int64Value true_negatives = 4;
+
+      // Number of false samples predicted as false.
+      google.protobuf.Int64Value false_negatives = 5;
+
+      // The fraction of actual positive predictions that had positive actual
+      // labels.
+      google.protobuf.DoubleValue precision = 6;
+
+      // The fraction of actual positive labels that were given a positive
+      // prediction.
+      google.protobuf.DoubleValue recall = 7;
+
+      // The equally weighted average of recall and precision.
+      google.protobuf.DoubleValue f1_score = 8;
+
+      // The fraction of predictions given the correct label.
+      google.protobuf.DoubleValue accuracy = 9;
+    }
+
+    // Aggregate classification metrics.
+    AggregateClassificationMetrics aggregate_classification_metrics = 1;
+
+    // Binary confusion matrix at multiple thresholds.
+    repeated BinaryConfusionMatrix binary_confusion_matrix_list = 2;
+
+    // Label representing the positive class.
+    string positive_label = 3;
+
+    // Label representing the negative class.
+    string negative_label = 4;
+  }
+
+  // Evaluation metrics for multi-class classification/classifier models.
+  message MultiClassClassificationMetrics {
+    // Confusion matrix for multi-class classification models.
+    message ConfusionMatrix {
+      // A single entry in the confusion matrix.
+      message Entry {
+        // The predicted label. For confidence_threshold > 0, we will
+        // also add an entry indicating the number of items under the
+        // confidence threshold.
+        string predicted_label = 1;
+
+        // Number of items being predicted as this label.
+        google.protobuf.Int64Value item_count = 2;
+      }
+
+      // A single row in the confusion matrix.
+      message Row {
+        // The original label of this row.
+        string actual_label = 1;
+
+        // Info describing predicted label distribution.
+        repeated Entry entries = 2;
+      }
+
+      // Confidence threshold used when computing the entries of the
+      // confusion matrix.
+      google.protobuf.DoubleValue confidence_threshold = 1;
+
+      // One row per actual label.
+      repeated Row rows = 2;
+    }
+
+    // Aggregate classification metrics.
+    AggregateClassificationMetrics aggregate_classification_metrics = 1;
+
+    // Confusion matrix at different thresholds.
+    repeated ConfusionMatrix confusion_matrix_list = 2;
+  }
+
+  // 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
+  // data or just the eval data based on whether eval data was used during
+  // training. These are not present for imported models.
+  message EvaluationMetrics {
+    oneof metrics {
+      // Populated for regression models and explicit feedback type matrix
+      // factorization models.
+      RegressionMetrics regression_metrics = 1;
+
+      // Populated for binary classification/classifier models.
+      BinaryClassificationMetrics binary_classification_metrics = 2;
+
+      // Populated for multi-class classification/classifier models.
+      MultiClassClassificationMetrics multi_class_classification_metrics = 3;
+
+      // Populated for clustering models.
+      ClusteringMetrics clustering_metrics = 4;
+    }
+  }
+
+  // Information about a single training query run for the model.
+  message TrainingRun {
+    message TrainingOptions {
+      // The maximum number of iterations in training. Used only for iterative
+      // training algorithms.
+      int64 max_iterations = 1;
+
+      // Type of loss function used during training run.
+      LossType loss_type = 2;
+
+      // Learning rate in training. Used only for iterative training algorithms.
+      double learn_rate = 3;
+
+      // L1 regularization coefficient.
+      google.protobuf.DoubleValue l1_regularization = 4;
+
+      // L2 regularization coefficient.
+      google.protobuf.DoubleValue l2_regularization = 5;
+
+      // When early_stop is true, stops training when accuracy improvement is
+      // less than 'min_relative_progress'. Used only for iterative training
+      // algorithms.
+      google.protobuf.DoubleValue min_relative_progress = 6;
+
+      // Whether to train a model from the last checkpoint.
+      google.protobuf.BoolValue warm_start = 7;
+
+      // Whether to stop early when the loss doesn't improve significantly
+      // any more (compared to min_relative_progress). Used only for iterative
+      // training algorithms.
+      google.protobuf.BoolValue early_stop = 8;
+
+      // Name of input label columns in training data.
+      repeated string input_label_columns = 9;
+
+      // The data split type for training and evaluation, e.g. RANDOM.
+      DataSplitMethod data_split_method = 10;
+
+      // The fraction of evaluation data over the whole input data. The rest
+      // of data will be used as training data. The format should be double.
+      // Accurate to two decimal places.
+      // Default value is 0.2.
+      double data_split_eval_fraction = 11;
+
+      // The column to split data with. This column won't be used as a
+      // feature.
+      // 1. When data_split_method is CUSTOM, the corresponding column should
+      // be boolean. The rows with true value tag are eval data, and the false
+      // are training data.
+      // 2. When data_split_method is SEQ, the first DATA_SPLIT_EVAL_FRACTION
+      // rows (from smallest to largest) in the corresponding column are used
+      // as training data, and the rest are eval data. It respects the order
+      // in Orderable data types:
+      // https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#data-type-properties
+      string data_split_column = 12;
+
+      // The strategy to determine learn rate for the current iteration.
+      LearnRateStrategy learn_rate_strategy = 13;
+
+      // Specifies the initial learning rate for the line search learn rate
+      // strategy.
+      double initial_learn_rate = 16;
+
+      // Weights associated with each label class, for rebalancing the
+      // training data. Only applicable for classification models.
+      map<string, double> label_class_weights = 17;
+
+      // Distance type for clustering models.
+      DistanceType distance_type = 20;
+
+      // Number of clusters for clustering models.
+      int64 num_clusters = 21;
+
+      // [Beta] Google Cloud Storage URI from which the model was imported. Only
+      // applicable for imported models.
+      string model_uri = 22;
+
+      // 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.
+    message IterationResult {
+      // Information about a single cluster for clustering model.
+      message ClusterInfo {
+        // Centroid id.
+        int64 centroid_id = 1;
+
+        // Cluster radius, the average distance from centroid
+        // to each point assigned to the cluster.
+        google.protobuf.DoubleValue cluster_radius = 2;
+
+        // Cluster size, the total number of points assigned to the cluster.
+        google.protobuf.Int64Value cluster_size = 3;
+      }
+
+      // Index of the iteration, 0 based.
+      google.protobuf.Int32Value index = 1;
+
+      // Time taken to run the iteration in milliseconds.
+      google.protobuf.Int64Value duration_ms = 4;
+
+      // Loss computed on the training data at the end of iteration.
+      google.protobuf.DoubleValue training_loss = 5;
+
+      // Loss computed on the eval data at the end of iteration.
+      google.protobuf.DoubleValue eval_loss = 6;
+
+      // Learn rate used for this iteration.
+      double learn_rate = 7;
+
+      // Information about top clusters for clustering models.
+      repeated ClusterInfo cluster_infos = 8;
+    }
+
+    // Options that were used for this training run, includes
+    // user specified and default options that were used.
+    TrainingOptions training_options = 1;
+
+    // The start time of this training run.
+    google.protobuf.Timestamp start_time = 8;
+
+    // Output of each iteration run, results.size() <= max_iterations.
+    repeated IterationResult results = 6;
+
+    // The evaluation metrics over training/eval data that were computed at the
+    // end of training.
+    EvaluationMetrics evaluation_metrics = 7;
+  }
+
+  // Indicates the type of the Model.
+  enum ModelType {
+    MODEL_TYPE_UNSPECIFIED = 0;
+
+    // Linear regression model.
+    LINEAR_REGRESSION = 1;
+
+    // Logistic regression based classification model.
+    LOGISTIC_REGRESSION = 2;
+
+    // K-means clustering model.
+    KMEANS = 3;
+
+    // [Beta] An imported TensorFlow model.
+    TENSORFLOW = 6;
+  }
+
+  // Loss metric to evaluate model training performance.
+  enum LossType {
+    LOSS_TYPE_UNSPECIFIED = 0;
+
+    // Mean squared loss, used for linear regression.
+    MEAN_SQUARED_LOSS = 1;
+
+    // Mean log loss, used for logistic regression.
+    MEAN_LOG_LOSS = 2;
+  }
+
+  // Distance metric used to compute the distance between two points.
+  enum DistanceType {
+    DISTANCE_TYPE_UNSPECIFIED = 0;
+
+    // Eculidean distance.
+    EUCLIDEAN = 1;
+
+    // Cosine distance.
+    COSINE = 2;
+  }
+
+  // Indicates the method to split input data into multiple tables.
+  enum DataSplitMethod {
+    DATA_SPLIT_METHOD_UNSPECIFIED = 0;
+
+    // Splits data randomly.
+    RANDOM = 1;
+
+    // Splits data with the user provided tags.
+    CUSTOM = 2;
+
+    // Splits data sequentially.
+    SEQUENTIAL = 3;
+
+    // Data split will be skipped.
+    NO_SPLIT = 4;
+
+    // Splits data automatically: Uses NO_SPLIT if the data size is small.
+    // Otherwise uses RANDOM.
+    AUTO_SPLIT = 5;
+  }
+
+  // Indicates the learning rate optimization strategy to use.
+  enum LearnRateStrategy {
+    LEARN_RATE_STRATEGY_UNSPECIFIED = 0;
+
+    // Use line search to determine learning rate.
+    LINE_SEARCH = 1;
+
+    // Use a constant learning rate.
+    CONSTANT = 2;
+  }
+
+  // Indicates the optimization strategy used for training.
+  enum OptimizationStrategy {
+    OPTIMIZATION_STRATEGY_UNSPECIFIED = 0;
+
+    // Uses an iterative batch gradient descent algorithm.
+    BATCH_GRADIENT_DESCENT = 1;
+
+    // Uses a normal equation to solve linear regression problem.
+    NORMAL_EQUATION = 2;
+  }
+
+  // Output only. A hash of this resource.
+  string etag = 1;
+
+  // Required. Unique identifier for this model.
+  ModelReference model_reference = 2;
+
+  // 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 last modified, in millisecs
+  // since the epoch.
+  int64 last_modified_time = 6;
+
+  // [Optional] A user-friendly description of this model.
+  string description = 12;
+
+  // [Optional] A descriptive name for this model.
+  string friendly_name = 14;
+
+  // [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
+  // 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<string, string> labels = 15;
+
+  // [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;
+
+  // Output only. The geographic location where the model resides. This value
+  // is inherited from the dataset.
+  string location = 13;
+
+  // Output only. Type of the model resource.
+  ModelType model_type = 7;
+
+  // Output only. Information for all training runs in increasing order of
+  // start_time.
+  repeated TrainingRun training_runs = 9;
+
+  // Output only. Input feature columns that were used to train this model.
+  repeated StandardSqlField feature_columns = 10;
+
+  // 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;
+}
+
+message GetModelRequest {
+  // Project ID of the requested model.
+  string project_id = 1;
+
+  // Dataset ID of the requested model.
+  string dataset_id = 2;
+
+  // Model ID of the requested model.
+  string model_id = 3;
+}
+
+message PatchModelRequest {
+  // Project ID of the model to patch.
+  string project_id = 1;
+
+  // Dataset ID of the model to patch.
+  string dataset_id = 2;
+
+  // Model ID of the model to patch.
+  string model_id = 3;
+
+  // Patched model.
+  // Follows RFC5789 patch semantics. Missing fields are not updated.
+  // To clear a field, explicitly set to default value.
+  Model model = 4;
+}
+
+message DeleteModelRequest {
+  // Project ID of the model to delete.
+  string project_id = 1;
+
+  // Dataset ID of the model to delete.
+  string dataset_id = 2;
+
+  // Model ID of the model to delete.
+  string model_id = 3;
+}
+
+message ListModelsRequest {
+  // Project ID of the models to list.
+  string project_id = 1;
+
+  // Dataset ID of the models to list.
+  string dataset_id = 2;
+
+  // 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
+  // results
+  string page_token = 4;
+}
+
+message ListModelsResponse {
+  // Models in the requested dataset. Only the following fields are populated:
+  // model_reference, model_type, creation_time, last_modified_time and
+  // labels.
+  repeated Model models = 1;
+
+  // A token to request the next page of results.
+  string next_page_token = 2;
+}
diff --git a/bigquery/google/cloud/bigquery_v2/proto/model_pb2.py b/bigquery/google/cloud/bigquery_v2/proto/model_pb2.py
new file mode 100644
index 000000000000..45e6cefdf72c
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/model_pb2.py
@@ -0,0 +1,4026 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery_v2/proto/model.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.bigquery_v2.proto import (
+    model_reference_pb2 as google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__reference__pb2,
+)
+from google.cloud.bigquery_v2.proto import (
+    standard_sql_pb2 as google_dot_cloud_dot_bigquery__v2_dot_proto_dot_standard__sql__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery_v2/proto/model.proto",
+    package="google.cloud.bigquery.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.bigquery.v2B\nModelProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"
+    ),
+    serialized_pb=_b(
+        '\n*google/cloud/bigquery_v2/proto/model.proto\x12\x18google.cloud.bigquery.v2\x1a\x34google/cloud/bigquery_v2/proto/model_reference.proto\x1a\x31google/cloud/bigquery_v2/proto/standard_sql.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto"\x8a\x34\n\x05Model\x12\x0c\n\x04\x65tag\x18\x01 \x01(\t\x12\x41\n\x0fmodel_reference\x18\x02 \x01(\x0b\x32(.google.cloud.bigquery.v2.ModelReference\x12\x15\n\rcreation_time\x18\x05 \x01(\x03\x12\x1a\n\x12last_modified_time\x18\x06 \x01(\x03\x12\x13\n\x0b\x64\x65scription\x18\x0c \x01(\t\x12\x15\n\rfriendly_name\x18\x0e \x01(\t\x12;\n\x06labels\x18\x0f \x03(\x0b\x32+.google.cloud.bigquery.v2.Model.LabelsEntry\x12\x17\n\x0f\x65xpiration_time\x18\x10 \x01(\x03\x12\x10\n\x08location\x18\r \x01(\t\x12=\n\nmodel_type\x18\x07 \x01(\x0e\x32).google.cloud.bigquery.v2.Model.ModelType\x12\x42\n\rtraining_runs\x18\t \x03(\x0b\x32+.google.cloud.bigquery.v2.Model.TrainingRun\x12\x43\n\x0f\x66\x65\x61ture_columns\x18\n \x03(\x0b\x32*.google.cloud.bigquery.v2.StandardSqlField\x12\x41\n\rlabel_columns\x18\x0b \x03(\x0b\x32*.google.cloud.bigquery.v2.StandardSqlField\x1aq\n\x0bKmeansEnums"b\n\x1aKmeansInitializationMethod\x12,\n(KMEANS_INITIALIZATION_METHOD_UNSPECIFIED\x10\x00\x12\n\n\x06RANDOM\x10\x01\x12\n\n\x06\x43USTOM\x10\x02\x1a\xb4\x02\n\x11RegressionMetrics\x12\x39\n\x13mean_absolute_error\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x38\n\x12mean_squared_error\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12<\n\x16mean_squared_log_error\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12;\n\x15median_absolute_error\x18\x04 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12/\n\tr_squared\x18\x05 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x1a\xef\x02\n\x1e\x41ggregateClassificationMetrics\x12/\n\tprecision\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12,\n\x06recall\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12.\n\x08\x61\x63\x63uracy\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12/\n\tthreshold\x18\x04 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12.\n\x08\x66\x31_score\x18\x05 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12.\n\x08log_loss\x18\x06 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12-\n\x07roc_auc\x18\x07 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x1a\x9f\x06\n\x1b\x42inaryClassificationMetrics\x12h\n aggregate_classification_metrics\x18\x01 \x01(\x0b\x32>.google.cloud.bigquery.v2.Model.AggregateClassificationMetrics\x12w\n\x1c\x62inary_confusion_matrix_list\x18\x02 \x03(\x0b\x32Q.google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix\x12\x16\n\x0epositive_label\x18\x03 \x01(\t\x12\x16\n\x0enegative_label\x18\x04 \x01(\t\x1a\xec\x03\n\x15\x42inaryConfusionMatrix\x12>\n\x18positive_class_threshold\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x33\n\x0etrue_positives\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x34\n\x0f\x66\x61lse_positives\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x33\n\x0etrue_negatives\x18\x04 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x34\n\x0f\x66\x61lse_negatives\x18\x05 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12/\n\tprecision\x18\x06 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12,\n\x06recall\x18\x07 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12.\n\x08\x66\x31_score\x18\x08 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12.\n\x08\x61\x63\x63uracy\x18\t \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x1a\x87\x05\n\x1fMultiClassClassificationMetrics\x12h\n aggregate_classification_metrics\x18\x01 \x01(\x0b\x32>.google.cloud.bigquery.v2.Model.AggregateClassificationMetrics\x12n\n\x15\x63onfusion_matrix_list\x18\x02 \x03(\x0b\x32O.google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix\x1a\x89\x03\n\x0f\x43onfusionMatrix\x12:\n\x14\x63onfidence_threshold\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x61\n\x04rows\x18\x02 \x03(\x0b\x32S.google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Row\x1aQ\n\x05\x45ntry\x12\x17\n\x0fpredicted_label\x18\x01 \x01(\t\x12/\n\nitem_count\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x1a\x83\x01\n\x03Row\x12\x14\n\x0c\x61\x63tual_label\x18\x01 \x01(\t\x12\x66\n\x07\x65ntries\x18\x02 \x03(\x0b\x32U.google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Entry\x1a\xcb\x06\n\x11\x43lusteringMetrics\x12:\n\x14\x64\x61vies_bouldin_index\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12;\n\x15mean_squared_distance\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12K\n\x08\x63lusters\x18\x03 \x03(\x0b\x32\x39.google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster\x1a\xef\x04\n\x07\x43luster\x12\x13\n\x0b\x63\x65ntroid_id\x18\x01 \x01(\x03\x12^\n\x0e\x66\x65\x61ture_values\x18\x02 \x03(\x0b\x32\x46.google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue\x12*\n\x05\x63ount\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x1a\xc2\x03\n\x0c\x46\x65\x61tureValue\x12\x16\n\x0e\x66\x65\x61ture_column\x18\x01 \x01(\t\x12\x37\n\x0fnumerical_value\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.DoubleValueH\x00\x12t\n\x11\x63\x61tegorical_value\x18\x03 \x01(\x0b\x32W.google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValueH\x00\x1a\xe1\x01\n\x10\x43\x61tegoricalValue\x12~\n\x0f\x63\x61tegory_counts\x18\x01 \x03(\x0b\x32\x65.google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.CategoryCount\x1aM\n\rCategoryCount\x12\x10\n\x08\x63\x61tegory\x18\x01 \x01(\t\x12*\n\x05\x63ount\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64ValueB\x07\n\x05value\x1a\x95\x03\n\x11\x45valuationMetrics\x12O\n\x12regression_metrics\x18\x01 \x01(\x0b\x32\x31.google.cloud.bigquery.v2.Model.RegressionMetricsH\x00\x12\x64\n\x1d\x62inary_classification_metrics\x18\x02 \x01(\x0b\x32;.google.cloud.bigquery.v2.Model.BinaryClassificationMetricsH\x00\x12m\n"multi_class_classification_metrics\x18\x03 \x01(\x0b\x32?.google.cloud.bigquery.v2.Model.MultiClassClassificationMetricsH\x00\x12O\n\x12\x63lustering_metrics\x18\x04 \x01(\x0b\x32\x31.google.cloud.bigquery.v2.Model.ClusteringMetricsH\x00\x42\t\n\x07metrics\x1a\xab\x0f\n\x0bTrainingRun\x12U\n\x10training_options\x18\x01 \x01(\x0b\x32;.google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions\x12.\n\nstart_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12L\n\x07results\x18\x06 \x03(\x0b\x32;.google.cloud.bigquery.v2.Model.TrainingRun.IterationResult\x12M\n\x12\x65valuation_metrics\x18\x07 \x01(\x0b\x32\x31.google.cloud.bigquery.v2.Model.EvaluationMetrics\x1a\x9d\t\n\x0fTrainingOptions\x12\x16\n\x0emax_iterations\x18\x01 \x01(\x03\x12;\n\tloss_type\x18\x02 \x01(\x0e\x32(.google.cloud.bigquery.v2.Model.LossType\x12\x12\n\nlearn_rate\x18\x03 \x01(\x01\x12\x37\n\x11l1_regularization\x18\x04 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x37\n\x11l2_regularization\x18\x05 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12;\n\x15min_relative_progress\x18\x06 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12.\n\nwarm_start\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12.\n\nearly_stop\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x1b\n\x13input_label_columns\x18\t \x03(\t\x12J\n\x11\x64\x61ta_split_method\x18\n \x01(\x0e\x32/.google.cloud.bigquery.v2.Model.DataSplitMethod\x12 \n\x18\x64\x61ta_split_eval_fraction\x18\x0b \x01(\x01\x12\x19\n\x11\x64\x61ta_split_column\x18\x0c \x01(\t\x12N\n\x13learn_rate_strategy\x18\r \x01(\x0e\x32\x31.google.cloud.bigquery.v2.Model.LearnRateStrategy\x12\x1a\n\x12initial_learn_rate\x18\x10 \x01(\x01\x12o\n\x13label_class_weights\x18\x11 \x03(\x0b\x32R.google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.LabelClassWeightsEntry\x12\x43\n\rdistance_type\x18\x14 \x01(\x0e\x32,.google.cloud.bigquery.v2.Model.DistanceType\x12\x14\n\x0cnum_clusters\x18\x15 \x01(\x03\x12\x11\n\tmodel_uri\x18\x16 \x01(\t\x12S\n\x15optimization_strategy\x18\x17 \x01(\x0e\x32\x34.google.cloud.bigquery.v2.Model.OptimizationStrategy\x12l\n\x1ckmeans_initialization_method\x18! \x01(\x0e\x32\x46.google.cloud.bigquery.v2.Model.KmeansEnums.KmeansInitializationMethod\x12$\n\x1ckmeans_initialization_column\x18" \x01(\t\x1a\x38\n\x16LabelClassWeightsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x01:\x02\x38\x01\x1a\xd7\x03\n\x0fIterationResult\x12*\n\x05index\x18\x01 \x01(\x0b\x32\x1b.google.protobuf.Int32Value\x12\x30\n\x0b\x64uration_ms\x18\x04 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x33\n\rtraining_loss\x18\x05 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12/\n\teval_loss\x18\x06 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x12\n\nlearn_rate\x18\x07 \x01(\x01\x12^\n\rcluster_infos\x18\x08 \x03(\x0b\x32G.google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.ClusterInfo\x1a\x8b\x01\n\x0b\x43lusterInfo\x12\x13\n\x0b\x63\x65ntroid_id\x18\x01 \x01(\x03\x12\x34\n\x0e\x63luster_radius\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x31\n\x0c\x63luster_size\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"s\n\tModelType\x12\x1a\n\x16MODEL_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11LINEAR_REGRESSION\x10\x01\x12\x17\n\x13LOGISTIC_REGRESSION\x10\x02\x12\n\n\x06KMEANS\x10\x03\x12\x0e\n\nTENSORFLOW\x10\x06"O\n\x08LossType\x12\x19\n\x15LOSS_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11MEAN_SQUARED_LOSS\x10\x01\x12\x11\n\rMEAN_LOG_LOSS\x10\x02"H\n\x0c\x44istanceType\x12\x1d\n\x19\x44ISTANCE_TYPE_UNSPECIFIED\x10\x00\x12\r\n\tEUCLIDEAN\x10\x01\x12\n\n\x06\x43OSINE\x10\x02"z\n\x0f\x44\x61taSplitMethod\x12!\n\x1d\x44\x41TA_SPLIT_METHOD_UNSPECIFIED\x10\x00\x12\n\n\x06RANDOM\x10\x01\x12\n\n\x06\x43USTOM\x10\x02\x12\x0e\n\nSEQUENTIAL\x10\x03\x12\x0c\n\x08NO_SPLIT\x10\x04\x12\x0e\n\nAUTO_SPLIT\x10\x05"W\n\x11LearnRateStrategy\x12#\n\x1fLEARN_RATE_STRATEGY_UNSPECIFIED\x10\x00\x12\x0f\n\x0bLINE_SEARCH\x10\x01\x12\x0c\n\x08\x43ONSTANT\x10\x02"n\n\x14OptimizationStrategy\x12%\n!OPTIMIZATION_STRATEGY_UNSPECIFIED\x10\x00\x12\x1a\n\x16\x42\x41TCH_GRADIENT_DESCENT\x10\x01\x12\x13\n\x0fNORMAL_EQUATION\x10\x02"K\n\x0fGetModelRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x10\n\x08model_id\x18\x03 \x01(\t"}\n\x11PatchModelRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x10\n\x08model_id\x18\x03 \x01(\t\x12.\n\x05model\x18\x04 \x01(\x0b\x32\x1f.google.cloud.bigquery.v2.Model"N\n\x12\x44\x65leteModelRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x10\n\x08model_id\x18\x03 \x01(\t"\x82\x01\n\x11ListModelsRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x31\n\x0bmax_results\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.UInt32Value\x12\x12\n\npage_token\x18\x04 \x01(\t"^\n\x12ListModelsResponse\x12/\n\x06models\x18\x01 \x03(\x0b\x32\x1f.google.cloud.bigquery.v2.Model\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xeb\x04\n\x0cModelService\x12X\n\x08GetModel\x12).google.cloud.bigquery.v2.GetModelRequest\x1a\x1f.google.cloud.bigquery.v2.Model"\x00\x12i\n\nListModels\x12+.google.cloud.bigquery.v2.ListModelsRequest\x1a,.google.cloud.bigquery.v2.ListModelsResponse"\x00\x12\\\n\nPatchModel\x12+.google.cloud.bigquery.v2.PatchModelRequest\x1a\x1f.google.cloud.bigquery.v2.Model"\x00\x12U\n\x0b\x44\x65leteModel\x12,.google.cloud.bigquery.v2.DeleteModelRequest\x1a\x16.google.protobuf.Empty"\x00\x1a\xe0\x01\xca\x41\x17\x62igquery.googleapis.com\xd2\x41\xc2\x01https://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-onlyBl\n\x1c\x63om.google.cloud.bigquery.v2B\nModelProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigqueryb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__reference__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery__v2_dot_proto_dot_standard__sql__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_MODEL_KMEANSENUMS_KMEANSINITIALIZATIONMETHOD = _descriptor.EnumDescriptor(
+    name="KmeansInitializationMethod",
+    full_name="google.cloud.bigquery.v2.Model.KmeansEnums.KmeansInitializationMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="KMEANS_INITIALIZATION_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RANDOM", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=898,
+    serialized_end=996,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_KMEANSENUMS_KMEANSINITIALIZATIONMETHOD)
+
+_MODEL_MODELTYPE = _descriptor.EnumDescriptor(
+    name="ModelType",
+    full_name="google.cloud.bigquery.v2.Model.ModelType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MODEL_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINEAR_REGRESSION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGISTIC_REGRESSION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KMEANS", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TENSORFLOW", index=4, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6398,
+    serialized_end=6513,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_MODELTYPE)
+
+_MODEL_LOSSTYPE = _descriptor.EnumDescriptor(
+    name="LossType",
+    full_name="google.cloud.bigquery.v2.Model.LossType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LOSS_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEAN_SQUARED_LOSS",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEAN_LOG_LOSS", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6515,
+    serialized_end=6594,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_LOSSTYPE)
+
+_MODEL_DISTANCETYPE = _descriptor.EnumDescriptor(
+    name="DistanceType",
+    full_name="google.cloud.bigquery.v2.Model.DistanceType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DISTANCE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EUCLIDEAN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COSINE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6596,
+    serialized_end=6668,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_DISTANCETYPE)
+
+_MODEL_DATASPLITMETHOD = _descriptor.EnumDescriptor(
+    name="DataSplitMethod",
+    full_name="google.cloud.bigquery.v2.Model.DataSplitMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_SPLIT_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RANDOM", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEQUENTIAL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NO_SPLIT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTO_SPLIT", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6670,
+    serialized_end=6792,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_DATASPLITMETHOD)
+
+_MODEL_LEARNRATESTRATEGY = _descriptor.EnumDescriptor(
+    name="LearnRateStrategy",
+    full_name="google.cloud.bigquery.v2.Model.LearnRateStrategy",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LEARN_RATE_STRATEGY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINE_SEARCH", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONSTANT", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6794,
+    serialized_end=6881,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_LEARNRATESTRATEGY)
+
+_MODEL_OPTIMIZATIONSTRATEGY = _descriptor.EnumDescriptor(
+    name="OptimizationStrategy",
+    full_name="google.cloud.bigquery.v2.Model.OptimizationStrategy",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPTIMIZATION_STRATEGY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BATCH_GRADIENT_DESCENT",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NORMAL_EQUATION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6883,
+    serialized_end=6993,
+)
+_sym_db.RegisterEnumDescriptor(_MODEL_OPTIMIZATIONSTRATEGY)
+
+
+_MODEL_KMEANSENUMS = _descriptor.Descriptor(
+    name="KmeansEnums",
+    full_name="google.cloud.bigquery.v2.Model.KmeansEnums",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_MODEL_KMEANSENUMS_KMEANSINITIALIZATIONMETHOD],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=883,
+    serialized_end=996,
+)
+
+_MODEL_REGRESSIONMETRICS = _descriptor.Descriptor(
+    name="RegressionMetrics",
+    full_name="google.cloud.bigquery.v2.Model.RegressionMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mean_absolute_error",
+            full_name="google.cloud.bigquery.v2.Model.RegressionMetrics.mean_absolute_error",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_squared_error",
+            full_name="google.cloud.bigquery.v2.Model.RegressionMetrics.mean_squared_error",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_squared_log_error",
+            full_name="google.cloud.bigquery.v2.Model.RegressionMetrics.mean_squared_log_error",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="median_absolute_error",
+            full_name="google.cloud.bigquery.v2.Model.RegressionMetrics.median_absolute_error",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="r_squared",
+            full_name="google.cloud.bigquery.v2.Model.RegressionMetrics.r_squared",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=999,
+    serialized_end=1307,
+)
+
+_MODEL_AGGREGATECLASSIFICATIONMETRICS = _descriptor.Descriptor(
+    name="AggregateClassificationMetrics",
+    full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.precision",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.recall",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accuracy",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.accuracy",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="threshold",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.threshold",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.f1_score",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="log_loss",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.log_loss",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roc_auc",
+            full_name="google.cloud.bigquery.v2.Model.AggregateClassificationMetrics.roc_auc",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1310,
+    serialized_end=1677,
+)
+
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX = _descriptor.Descriptor(
+    name="BinaryConfusionMatrix",
+    full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="positive_class_threshold",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.positive_class_threshold",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="true_positives",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.true_positives",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_positives",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.false_positives",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="true_negatives",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.true_negatives",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_negatives",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.false_negatives",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.precision",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.recall",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.f1_score",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accuracy",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix.accuracy",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1987,
+    serialized_end=2479,
+)
+
+_MODEL_BINARYCLASSIFICATIONMETRICS = _descriptor.Descriptor(
+    name="BinaryClassificationMetrics",
+    full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aggregate_classification_metrics",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.aggregate_classification_metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_confusion_matrix_list",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.binary_confusion_matrix_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="positive_label",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.positive_label",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negative_label",
+            full_name="google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.negative_label",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1680,
+    serialized_end=2479,
+)
+
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ENTRY = _descriptor.Descriptor(
+    name="Entry",
+    full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Entry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="predicted_label",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Entry.predicted_label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="item_count",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Entry.item_count",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2914,
+    serialized_end=2995,
+)
+
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ROW = _descriptor.Descriptor(
+    name="Row",
+    full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Row",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="actual_label",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Row.actual_label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Row.entries",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2998,
+    serialized_end=3129,
+)
+
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX = _descriptor.Descriptor(
+    name="ConfusionMatrix",
+    full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="confidence_threshold",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.confidence_threshold",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.rows",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ENTRY,
+        _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ROW,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2736,
+    serialized_end=3129,
+)
+
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS = _descriptor.Descriptor(
+    name="MultiClassClassificationMetrics",
+    full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aggregate_classification_metrics",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.aggregate_classification_metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confusion_matrix_list",
+            full_name="google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.confusion_matrix_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2482,
+    serialized_end=3129,
+)
+
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE_CATEGORYCOUNT = _descriptor.Descriptor(
+    name="CategoryCount",
+    full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.CategoryCount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="category",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.CategoryCount.category",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.CategoryCount.count",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3889,
+    serialized_end=3966,
+)
+
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE = _descriptor.Descriptor(
+    name="CategoricalValue",
+    full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="category_counts",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.category_counts",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE_CATEGORYCOUNT
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3741,
+    serialized_end=3966,
+)
+
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE = _descriptor.Descriptor(
+    name="FeatureValue",
+    full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="feature_column",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.feature_column",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="numerical_value",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.numerical_value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="categorical_value",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.categorical_value",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.value",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3525,
+    serialized_end=3975,
+)
+
+_MODEL_CLUSTERINGMETRICS_CLUSTER = _descriptor.Descriptor(
+    name="Cluster",
+    full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="centroid_id",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.centroid_id",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature_values",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.feature_values",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.count",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3352,
+    serialized_end=3975,
+)
+
+_MODEL_CLUSTERINGMETRICS = _descriptor.Descriptor(
+    name="ClusteringMetrics",
+    full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="davies_bouldin_index",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.davies_bouldin_index",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_squared_distance",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.mean_squared_distance",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.cloud.bigquery.v2.Model.ClusteringMetrics.clusters",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_CLUSTERINGMETRICS_CLUSTER],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3132,
+    serialized_end=3975,
+)
+
+_MODEL_EVALUATIONMETRICS = _descriptor.Descriptor(
+    name="EvaluationMetrics",
+    full_name="google.cloud.bigquery.v2.Model.EvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="regression_metrics",
+            full_name="google.cloud.bigquery.v2.Model.EvaluationMetrics.regression_metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_classification_metrics",
+            full_name="google.cloud.bigquery.v2.Model.EvaluationMetrics.binary_classification_metrics",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="multi_class_classification_metrics",
+            full_name="google.cloud.bigquery.v2.Model.EvaluationMetrics.multi_class_classification_metrics",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="clustering_metrics",
+            full_name="google.cloud.bigquery.v2.Model.EvaluationMetrics.clustering_metrics",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="metrics",
+            full_name="google.cloud.bigquery.v2.Model.EvaluationMetrics.metrics",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3978,
+    serialized_end=4383,
+)
+
+_MODEL_TRAININGRUN_TRAININGOPTIONS_LABELCLASSWEIGHTSENTRY = _descriptor.Descriptor(
+    name="LabelClassWeightsEntry",
+    full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.LabelClassWeightsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.LabelClassWeightsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.LabelClassWeightsEntry.value",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5819,
+    serialized_end=5875,
+)
+
+_MODEL_TRAININGRUN_TRAININGOPTIONS = _descriptor.Descriptor(
+    name="TrainingOptions",
+    full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_iterations",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.max_iterations",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="loss_type",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.loss_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="learn_rate",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.learn_rate",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="l1_regularization",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.l1_regularization",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="l2_regularization",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.l2_regularization",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_relative_progress",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.min_relative_progress",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="warm_start",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.warm_start",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="early_stop",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.early_stop",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_label_columns",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.input_label_columns",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_split_method",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.data_split_method",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_split_eval_fraction",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.data_split_eval_fraction",
+            index=10,
+            number=11,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_split_column",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.data_split_column",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="learn_rate_strategy",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.learn_rate_strategy",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_learn_rate",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.initial_learn_rate",
+            index=13,
+            number=16,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_class_weights",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.label_class_weights",
+            index=14,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distance_type",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.distance_type",
+            index=15,
+            number=20,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_clusters",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.num_clusters",
+            index=16,
+            number=21,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_uri",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.model_uri",
+            index=17,
+            number=22,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="optimization_strategy",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.optimization_strategy",
+            index=18,
+            number=23,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kmeans_initialization_method",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.kmeans_initialization_method",
+            index=19,
+            number=33,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kmeans_initialization_column",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.kmeans_initialization_column",
+            index=20,
+            number=34,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_TRAININGRUN_TRAININGOPTIONS_LABELCLASSWEIGHTSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4694,
+    serialized_end=5875,
+)
+
+_MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO = _descriptor.Descriptor(
+    name="ClusterInfo",
+    full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.ClusterInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="centroid_id",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.ClusterInfo.centroid_id",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_radius",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.ClusterInfo.cluster_radius",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_size",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.ClusterInfo.cluster_size",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6210,
+    serialized_end=6349,
+)
+
+_MODEL_TRAININGRUN_ITERATIONRESULT = _descriptor.Descriptor(
+    name="IterationResult",
+    full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.index",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duration_ms",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.duration_ms",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="training_loss",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.training_loss",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="eval_loss",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.eval_loss",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="learn_rate",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.learn_rate",
+            index=4,
+            number=7,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_infos",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.cluster_infos",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5878,
+    serialized_end=6349,
+)
+
+_MODEL_TRAININGRUN = _descriptor.Descriptor(
+    name="TrainingRun",
+    full_name="google.cloud.bigquery.v2.Model.TrainingRun",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="training_options",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.training_options",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.start_time",
+            index=1,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.results",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluation_metrics",
+            full_name="google.cloud.bigquery.v2.Model.TrainingRun.evaluation_metrics",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _MODEL_TRAININGRUN_TRAININGOPTIONS,
+        _MODEL_TRAININGRUN_ITERATIONRESULT,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4386,
+    serialized_end=6349,
+)
+
+_MODEL_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.bigquery.v2.Model.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.bigquery.v2.Model.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.bigquery.v2.Model.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6351,
+    serialized_end=6396,
+)
+
+_MODEL = _descriptor.Descriptor(
+    name="Model",
+    full_name="google.cloud.bigquery.v2.Model",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.bigquery.v2.Model.etag",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_reference",
+            full_name="google.cloud.bigquery.v2.Model.model_reference",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="creation_time",
+            full_name="google.cloud.bigquery.v2.Model.creation_time",
+            index=2,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_modified_time",
+            full_name="google.cloud.bigquery.v2.Model.last_modified_time",
+            index=3,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.bigquery.v2.Model.description",
+            index=4,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="friendly_name",
+            full_name="google.cloud.bigquery.v2.Model.friendly_name",
+            index=5,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.bigquery.v2.Model.labels",
+            index=6,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiration_time",
+            full_name="google.cloud.bigquery.v2.Model.expiration_time",
+            index=7,
+            number=16,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.cloud.bigquery.v2.Model.location",
+            index=8,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_type",
+            full_name="google.cloud.bigquery.v2.Model.model_type",
+            index=9,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="training_runs",
+            full_name="google.cloud.bigquery.v2.Model.training_runs",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature_columns",
+            full_name="google.cloud.bigquery.v2.Model.feature_columns",
+            index=11,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_columns",
+            full_name="google.cloud.bigquery.v2.Model.label_columns",
+            index=12,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _MODEL_KMEANSENUMS,
+        _MODEL_REGRESSIONMETRICS,
+        _MODEL_AGGREGATECLASSIFICATIONMETRICS,
+        _MODEL_BINARYCLASSIFICATIONMETRICS,
+        _MODEL_MULTICLASSCLASSIFICATIONMETRICS,
+        _MODEL_CLUSTERINGMETRICS,
+        _MODEL_EVALUATIONMETRICS,
+        _MODEL_TRAININGRUN,
+        _MODEL_LABELSENTRY,
+    ],
+    enum_types=[
+        _MODEL_MODELTYPE,
+        _MODEL_LOSSTYPE,
+        _MODEL_DISTANCETYPE,
+        _MODEL_DATASPLITMETHOD,
+        _MODEL_LEARNRATESTRATEGY,
+        _MODEL_OPTIMIZATIONSTRATEGY,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=327,
+    serialized_end=6993,
+)
+
+
+_GETMODELREQUEST = _descriptor.Descriptor(
+    name="GetModelRequest",
+    full_name="google.cloud.bigquery.v2.GetModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.bigquery.v2.GetModelRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.bigquery.v2.GetModelRequest.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_id",
+            full_name="google.cloud.bigquery.v2.GetModelRequest.model_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6995,
+    serialized_end=7070,
+)
+
+
+_PATCHMODELREQUEST = _descriptor.Descriptor(
+    name="PatchModelRequest",
+    full_name="google.cloud.bigquery.v2.PatchModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.bigquery.v2.PatchModelRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.bigquery.v2.PatchModelRequest.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_id",
+            full_name="google.cloud.bigquery.v2.PatchModelRequest.model_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.bigquery.v2.PatchModelRequest.model",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7072,
+    serialized_end=7197,
+)
+
+
+_DELETEMODELREQUEST = _descriptor.Descriptor(
+    name="DeleteModelRequest",
+    full_name="google.cloud.bigquery.v2.DeleteModelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.bigquery.v2.DeleteModelRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.bigquery.v2.DeleteModelRequest.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_id",
+            full_name="google.cloud.bigquery.v2.DeleteModelRequest.model_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7199,
+    serialized_end=7277,
+)
+
+
+_LISTMODELSREQUEST = _descriptor.Descriptor(
+    name="ListModelsRequest",
+    full_name="google.cloud.bigquery.v2.ListModelsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.bigquery.v2.ListModelsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.bigquery.v2.ListModelsRequest.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_results",
+            full_name="google.cloud.bigquery.v2.ListModelsRequest.max_results",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.bigquery.v2.ListModelsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7280,
+    serialized_end=7410,
+)
+
+
+_LISTMODELSRESPONSE = _descriptor.Descriptor(
+    name="ListModelsResponse",
+    full_name="google.cloud.bigquery.v2.ListModelsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="models",
+            full_name="google.cloud.bigquery.v2.ListModelsResponse.models",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.bigquery.v2.ListModelsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7412,
+    serialized_end=7506,
+)
+
+_MODEL_KMEANSENUMS.containing_type = _MODEL
+_MODEL_KMEANSENUMS_KMEANSINITIALIZATIONMETHOD.containing_type = _MODEL_KMEANSENUMS
+_MODEL_REGRESSIONMETRICS.fields_by_name[
+    "mean_absolute_error"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_REGRESSIONMETRICS.fields_by_name[
+    "mean_squared_error"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_REGRESSIONMETRICS.fields_by_name[
+    "mean_squared_log_error"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_REGRESSIONMETRICS.fields_by_name[
+    "median_absolute_error"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_REGRESSIONMETRICS.fields_by_name[
+    "r_squared"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_REGRESSIONMETRICS.containing_type = _MODEL
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "precision"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "recall"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "accuracy"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "threshold"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "f1_score"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "log_loss"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.fields_by_name[
+    "roc_auc"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_AGGREGATECLASSIFICATIONMETRICS.containing_type = _MODEL
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "positive_class_threshold"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "true_positives"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "false_positives"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "true_negatives"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "false_negatives"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "precision"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "recall"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "f1_score"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.fields_by_name[
+    "accuracy"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX.containing_type = (
+    _MODEL_BINARYCLASSIFICATIONMETRICS
+)
+_MODEL_BINARYCLASSIFICATIONMETRICS.fields_by_name[
+    "aggregate_classification_metrics"
+].message_type = _MODEL_AGGREGATECLASSIFICATIONMETRICS
+_MODEL_BINARYCLASSIFICATIONMETRICS.fields_by_name[
+    "binary_confusion_matrix_list"
+].message_type = _MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX
+_MODEL_BINARYCLASSIFICATIONMETRICS.containing_type = _MODEL
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ENTRY.fields_by_name[
+    "item_count"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ENTRY.containing_type = (
+    _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX
+)
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ROW.fields_by_name[
+    "entries"
+].message_type = _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ENTRY
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ROW.containing_type = (
+    _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX
+)
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX.fields_by_name[
+    "confidence_threshold"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX.fields_by_name[
+    "rows"
+].message_type = _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ROW
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX.containing_type = (
+    _MODEL_MULTICLASSCLASSIFICATIONMETRICS
+)
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS.fields_by_name[
+    "aggregate_classification_metrics"
+].message_type = _MODEL_AGGREGATECLASSIFICATIONMETRICS
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS.fields_by_name[
+    "confusion_matrix_list"
+].message_type = _MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX
+_MODEL_MULTICLASSCLASSIFICATIONMETRICS.containing_type = _MODEL
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE_CATEGORYCOUNT.fields_by_name[
+    "count"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE_CATEGORYCOUNT.containing_type = (
+    _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE
+)
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE.fields_by_name[
+    "category_counts"
+].message_type = (
+    _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE_CATEGORYCOUNT
+)
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE.containing_type = (
+    _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE
+)
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.fields_by_name[
+    "numerical_value"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.fields_by_name[
+    "categorical_value"
+].message_type = _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.containing_type = (
+    _MODEL_CLUSTERINGMETRICS_CLUSTER
+)
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.oneofs_by_name["value"].fields.append(
+    _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.fields_by_name["numerical_value"]
+)
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.fields_by_name[
+    "numerical_value"
+].containing_oneof = _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.oneofs_by_name[
+    "value"
+]
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.oneofs_by_name["value"].fields.append(
+    _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.fields_by_name["categorical_value"]
+)
+_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.fields_by_name[
+    "categorical_value"
+].containing_oneof = _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE.oneofs_by_name[
+    "value"
+]
+_MODEL_CLUSTERINGMETRICS_CLUSTER.fields_by_name[
+    "feature_values"
+].message_type = _MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE
+_MODEL_CLUSTERINGMETRICS_CLUSTER.fields_by_name[
+    "count"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_CLUSTERINGMETRICS_CLUSTER.containing_type = _MODEL_CLUSTERINGMETRICS
+_MODEL_CLUSTERINGMETRICS.fields_by_name[
+    "davies_bouldin_index"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_CLUSTERINGMETRICS.fields_by_name[
+    "mean_squared_distance"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_CLUSTERINGMETRICS.fields_by_name[
+    "clusters"
+].message_type = _MODEL_CLUSTERINGMETRICS_CLUSTER
+_MODEL_CLUSTERINGMETRICS.containing_type = _MODEL
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "regression_metrics"
+].message_type = _MODEL_REGRESSIONMETRICS
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "binary_classification_metrics"
+].message_type = _MODEL_BINARYCLASSIFICATIONMETRICS
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "multi_class_classification_metrics"
+].message_type = _MODEL_MULTICLASSCLASSIFICATIONMETRICS
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "clustering_metrics"
+].message_type = _MODEL_CLUSTERINGMETRICS
+_MODEL_EVALUATIONMETRICS.containing_type = _MODEL
+_MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"].fields.append(
+    _MODEL_EVALUATIONMETRICS.fields_by_name["regression_metrics"]
+)
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "regression_metrics"
+].containing_oneof = _MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"]
+_MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"].fields.append(
+    _MODEL_EVALUATIONMETRICS.fields_by_name["binary_classification_metrics"]
+)
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "binary_classification_metrics"
+].containing_oneof = _MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"]
+_MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"].fields.append(
+    _MODEL_EVALUATIONMETRICS.fields_by_name["multi_class_classification_metrics"]
+)
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "multi_class_classification_metrics"
+].containing_oneof = _MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"]
+_MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"].fields.append(
+    _MODEL_EVALUATIONMETRICS.fields_by_name["clustering_metrics"]
+)
+_MODEL_EVALUATIONMETRICS.fields_by_name[
+    "clustering_metrics"
+].containing_oneof = _MODEL_EVALUATIONMETRICS.oneofs_by_name["metrics"]
+_MODEL_TRAININGRUN_TRAININGOPTIONS_LABELCLASSWEIGHTSENTRY.containing_type = (
+    _MODEL_TRAININGRUN_TRAININGOPTIONS
+)
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "loss_type"
+].enum_type = _MODEL_LOSSTYPE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "l1_regularization"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "l2_regularization"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "min_relative_progress"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "warm_start"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "early_stop"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "data_split_method"
+].enum_type = _MODEL_DATASPLITMETHOD
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "learn_rate_strategy"
+].enum_type = _MODEL_LEARNRATESTRATEGY
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "label_class_weights"
+].message_type = _MODEL_TRAININGRUN_TRAININGOPTIONS_LABELCLASSWEIGHTSENTRY
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "distance_type"
+].enum_type = _MODEL_DISTANCETYPE
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "optimization_strategy"
+].enum_type = _MODEL_OPTIMIZATIONSTRATEGY
+_MODEL_TRAININGRUN_TRAININGOPTIONS.fields_by_name[
+    "kmeans_initialization_method"
+].enum_type = _MODEL_KMEANSENUMS_KMEANSINITIALIZATIONMETHOD
+_MODEL_TRAININGRUN_TRAININGOPTIONS.containing_type = _MODEL_TRAININGRUN
+_MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO.fields_by_name[
+    "cluster_radius"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO.fields_by_name[
+    "cluster_size"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO.containing_type = (
+    _MODEL_TRAININGRUN_ITERATIONRESULT
+)
+_MODEL_TRAININGRUN_ITERATIONRESULT.fields_by_name[
+    "index"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_MODEL_TRAININGRUN_ITERATIONRESULT.fields_by_name[
+    "duration_ms"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_MODEL_TRAININGRUN_ITERATIONRESULT.fields_by_name[
+    "training_loss"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_TRAININGRUN_ITERATIONRESULT.fields_by_name[
+    "eval_loss"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_MODEL_TRAININGRUN_ITERATIONRESULT.fields_by_name[
+    "cluster_infos"
+].message_type = _MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO
+_MODEL_TRAININGRUN_ITERATIONRESULT.containing_type = _MODEL_TRAININGRUN
+_MODEL_TRAININGRUN.fields_by_name[
+    "training_options"
+].message_type = _MODEL_TRAININGRUN_TRAININGOPTIONS
+_MODEL_TRAININGRUN.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_MODEL_TRAININGRUN.fields_by_name[
+    "results"
+].message_type = _MODEL_TRAININGRUN_ITERATIONRESULT
+_MODEL_TRAININGRUN.fields_by_name[
+    "evaluation_metrics"
+].message_type = _MODEL_EVALUATIONMETRICS
+_MODEL_TRAININGRUN.containing_type = _MODEL
+_MODEL_LABELSENTRY.containing_type = _MODEL
+_MODEL.fields_by_name[
+    "model_reference"
+].message_type = (
+    google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__reference__pb2._MODELREFERENCE
+)
+_MODEL.fields_by_name["labels"].message_type = _MODEL_LABELSENTRY
+_MODEL.fields_by_name["model_type"].enum_type = _MODEL_MODELTYPE
+_MODEL.fields_by_name["training_runs"].message_type = _MODEL_TRAININGRUN
+_MODEL.fields_by_name[
+    "feature_columns"
+].message_type = (
+    google_dot_cloud_dot_bigquery__v2_dot_proto_dot_standard__sql__pb2._STANDARDSQLFIELD
+)
+_MODEL.fields_by_name[
+    "label_columns"
+].message_type = (
+    google_dot_cloud_dot_bigquery__v2_dot_proto_dot_standard__sql__pb2._STANDARDSQLFIELD
+)
+_MODEL_MODELTYPE.containing_type = _MODEL
+_MODEL_LOSSTYPE.containing_type = _MODEL
+_MODEL_DISTANCETYPE.containing_type = _MODEL
+_MODEL_DATASPLITMETHOD.containing_type = _MODEL
+_MODEL_LEARNRATESTRATEGY.containing_type = _MODEL
+_MODEL_OPTIMIZATIONSTRATEGY.containing_type = _MODEL
+_PATCHMODELREQUEST.fields_by_name["model"].message_type = _MODEL
+_LISTMODELSREQUEST.fields_by_name[
+    "max_results"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._UINT32VALUE
+_LISTMODELSRESPONSE.fields_by_name["models"].message_type = _MODEL
+DESCRIPTOR.message_types_by_name["Model"] = _MODEL
+DESCRIPTOR.message_types_by_name["GetModelRequest"] = _GETMODELREQUEST
+DESCRIPTOR.message_types_by_name["PatchModelRequest"] = _PATCHMODELREQUEST
+DESCRIPTOR.message_types_by_name["DeleteModelRequest"] = _DELETEMODELREQUEST
+DESCRIPTOR.message_types_by_name["ListModelsRequest"] = _LISTMODELSREQUEST
+DESCRIPTOR.message_types_by_name["ListModelsResponse"] = _LISTMODELSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Model = _reflection.GeneratedProtocolMessageType(
+    "Model",
+    (_message.Message,),
+    dict(
+        KmeansEnums=_reflection.GeneratedProtocolMessageType(
+            "KmeansEnums",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODEL_KMEANSENUMS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.KmeansEnums)
+            ),
+        ),
+        RegressionMetrics=_reflection.GeneratedProtocolMessageType(
+            "RegressionMetrics",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODEL_REGRESSIONMETRICS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Evaluation metrics for regression and explicit feedback type matrix
+    factorization models.
+    
+    
+    Attributes:
+        mean_absolute_error:
+            Mean absolute error.
+        mean_squared_error:
+            Mean squared error.
+        mean_squared_log_error:
+            Mean squared log error.
+        median_absolute_error:
+            Median absolute error.
+        r_squared:
+            R^2 score.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.RegressionMetrics)
+            ),
+        ),
+        AggregateClassificationMetrics=_reflection.GeneratedProtocolMessageType(
+            "AggregateClassificationMetrics",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODEL_AGGREGATECLASSIFICATIONMETRICS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Aggregate metrics for classification/classifier models. For multi-class
+    models, the metrics are either macro-averaged or micro-averaged. When
+    macro-averaged, the metrics are calculated for each label and then an
+    unweighted average is taken of those values. When micro-averaged, the
+    metric is calculated globally by counting the total number of correctly
+    predicted rows.
+    
+    
+    Attributes:
+        precision:
+            Precision is the fraction of actual positive predictions that
+            had positive actual labels. For multiclass this is a macro-
+            averaged metric treating each class as a binary classifier.
+        recall:
+            Recall is the fraction of actual positive labels that were
+            given a positive prediction. For multiclass this is a macro-
+            averaged metric.
+        accuracy:
+            Accuracy is the fraction of predictions given the correct
+            label. For multiclass this is a micro-averaged metric.
+        threshold:
+            Threshold at which the metrics are computed. For binary
+            classification models this is the positive class threshold.
+            For multi-class classfication models this is the confidence
+            threshold.
+        f1_score:
+            The F1 score is an average of recall and precision. For
+            multiclass this is a macro-averaged metric.
+        log_loss:
+            Logarithmic Loss. For multiclass this is a macro-averaged
+            metric.
+        roc_auc:
+            Area Under a ROC Curve. For multiclass this is a macro-
+            averaged metric.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.AggregateClassificationMetrics)
+            ),
+        ),
+        BinaryClassificationMetrics=_reflection.GeneratedProtocolMessageType(
+            "BinaryClassificationMetrics",
+            (_message.Message,),
+            dict(
+                BinaryConfusionMatrix=_reflection.GeneratedProtocolMessageType(
+                    "BinaryConfusionMatrix",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_MODEL_BINARYCLASSIFICATIONMETRICS_BINARYCONFUSIONMATRIX,
+                        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                        __doc__="""Confusion matrix for binary classification models.
+      
+      
+      Attributes:
+          positive_class_threshold:
+              Threshold value used when computing each of the following
+              metric.
+          true_positives:
+              Number of true samples predicted as true.
+          false_positives:
+              Number of false samples predicted as true.
+          true_negatives:
+              Number of true samples predicted as false.
+          false_negatives:
+              Number of false samples predicted as false.
+          precision:
+              The fraction of actual positive predictions that had positive
+              actual labels.
+          recall:
+              The fraction of actual positive labels that were given a
+              positive prediction.
+          f1_score:
+              The equally weighted average of recall and precision.
+          accuracy:
+              The fraction of predictions given the correct label.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.BinaryClassificationMetrics.BinaryConfusionMatrix)
+                    ),
+                ),
+                DESCRIPTOR=_MODEL_BINARYCLASSIFICATIONMETRICS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Evaluation metrics for binary classification/classifier models.
+    
+    
+    Attributes:
+        aggregate_classification_metrics:
+            Aggregate classification metrics.
+        binary_confusion_matrix_list:
+            Binary confusion matrix at multiple thresholds.
+        positive_label:
+            Label representing the positive class.
+        negative_label:
+            Label representing the negative class.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.BinaryClassificationMetrics)
+            ),
+        ),
+        MultiClassClassificationMetrics=_reflection.GeneratedProtocolMessageType(
+            "MultiClassClassificationMetrics",
+            (_message.Message,),
+            dict(
+                ConfusionMatrix=_reflection.GeneratedProtocolMessageType(
+                    "ConfusionMatrix",
+                    (_message.Message,),
+                    dict(
+                        Entry=_reflection.GeneratedProtocolMessageType(
+                            "Entry",
+                            (_message.Message,),
+                            dict(
+                                DESCRIPTOR=_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ENTRY,
+                                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                                __doc__="""A single entry in the confusion matrix.
+        
+        
+        Attributes:
+            predicted_label:
+                The predicted label. For confidence\_threshold > 0, we will
+                also add an entry indicating the number of items under the
+                confidence threshold.
+            item_count:
+                Number of items being predicted as this label.
+        """,
+                                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Entry)
+                            ),
+                        ),
+                        Row=_reflection.GeneratedProtocolMessageType(
+                            "Row",
+                            (_message.Message,),
+                            dict(
+                                DESCRIPTOR=_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX_ROW,
+                                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                                __doc__="""A single row in the confusion matrix.
+        
+        
+        Attributes:
+            actual_label:
+                The original label of this row.
+            entries:
+                Info describing predicted label distribution.
+        """,
+                                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix.Row)
+                            ),
+                        ),
+                        DESCRIPTOR=_MODEL_MULTICLASSCLASSIFICATIONMETRICS_CONFUSIONMATRIX,
+                        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                        __doc__="""Confusion matrix for multi-class classification models.
+      
+      
+      Attributes:
+          confidence_threshold:
+              Confidence threshold used when computing the entries of the
+              confusion matrix.
+          rows:
+              One row per actual label.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics.ConfusionMatrix)
+                    ),
+                ),
+                DESCRIPTOR=_MODEL_MULTICLASSCLASSIFICATIONMETRICS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Evaluation metrics for multi-class classification/classifier models.
+    
+    
+    Attributes:
+        aggregate_classification_metrics:
+            Aggregate classification metrics.
+        confusion_matrix_list:
+            Confusion matrix at different thresholds.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.MultiClassClassificationMetrics)
+            ),
+        ),
+        ClusteringMetrics=_reflection.GeneratedProtocolMessageType(
+            "ClusteringMetrics",
+            (_message.Message,),
+            dict(
+                Cluster=_reflection.GeneratedProtocolMessageType(
+                    "Cluster",
+                    (_message.Message,),
+                    dict(
+                        FeatureValue=_reflection.GeneratedProtocolMessageType(
+                            "FeatureValue",
+                            (_message.Message,),
+                            dict(
+                                CategoricalValue=_reflection.GeneratedProtocolMessageType(
+                                    "CategoricalValue",
+                                    (_message.Message,),
+                                    dict(
+                                        CategoryCount=_reflection.GeneratedProtocolMessageType(
+                                            "CategoryCount",
+                                            (_message.Message,),
+                                            dict(
+                                                DESCRIPTOR=_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE_CATEGORYCOUNT,
+                                                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                                                __doc__="""Represents the count of a single category within the cluster.
+            
+            
+            Attributes:
+                category:
+                    The name of category.
+                count:
+                    The count of training samples matching the category within the
+                    cluster.
+            """,
+                                                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.CategoryCount)
+                                            ),
+                                        ),
+                                        DESCRIPTOR=_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE_CATEGORICALVALUE,
+                                        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                                        __doc__="""Representative value of a categorical feature.
+          
+          
+          Attributes:
+              category_counts:
+                  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.
+          """,
+                                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue)
+                                    ),
+                                ),
+                                DESCRIPTOR=_MODEL_CLUSTERINGMETRICS_CLUSTER_FEATUREVALUE,
+                                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                                __doc__="""Representative value of a single feature within the cluster.
+        
+        
+        Attributes:
+            feature_column:
+                The feature column name.
+            numerical_value:
+                The numerical feature value. This is the centroid value for
+                this feature.
+            categorical_value:
+                The categorical feature value.
+        """,
+                                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster.FeatureValue)
+                            ),
+                        ),
+                        DESCRIPTOR=_MODEL_CLUSTERINGMETRICS_CLUSTER,
+                        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                        __doc__="""Message containing the information about one cluster.
+      
+      
+      Attributes:
+          centroid_id:
+              Centroid id.
+          feature_values:
+              Values of highly variant features for this cluster.
+          count:
+              Count of training data rows that were assigned to this
+              cluster.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.ClusteringMetrics.Cluster)
+                    ),
+                ),
+                DESCRIPTOR=_MODEL_CLUSTERINGMETRICS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Evaluation metrics for clustering models.
+    
+    
+    Attributes:
+        davies_bouldin_index:
+            Davies-Bouldin index.
+        mean_squared_distance:
+            Mean of squared distances between each sample to its cluster
+            centroid.
+        clusters:
+            [Beta] Information for all clusters.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.ClusteringMetrics)
+            ),
+        ),
+        EvaluationMetrics=_reflection.GeneratedProtocolMessageType(
+            "EvaluationMetrics",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODEL_EVALUATIONMETRICS,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Evaluation metrics of a model. These are either computed on all training
+    data or just the eval data based on whether eval data was used during
+    training. These are not present for imported models.
+    
+    
+    Attributes:
+        regression_metrics:
+            Populated for regression models and explicit feedback type
+            matrix factorization models.
+        binary_classification_metrics:
+            Populated for binary classification/classifier models.
+        multi_class_classification_metrics:
+            Populated for multi-class classification/classifier models.
+        clustering_metrics:
+            Populated for clustering models.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.EvaluationMetrics)
+            ),
+        ),
+        TrainingRun=_reflection.GeneratedProtocolMessageType(
+            "TrainingRun",
+            (_message.Message,),
+            dict(
+                TrainingOptions=_reflection.GeneratedProtocolMessageType(
+                    "TrainingOptions",
+                    (_message.Message,),
+                    dict(
+                        LabelClassWeightsEntry=_reflection.GeneratedProtocolMessageType(
+                            "LabelClassWeightsEntry",
+                            (_message.Message,),
+                            dict(
+                                DESCRIPTOR=_MODEL_TRAININGRUN_TRAININGOPTIONS_LABELCLASSWEIGHTSENTRY,
+                                __module__="google.cloud.bigquery_v2.proto.model_pb2"
+                                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions.LabelClassWeightsEntry)
+                            ),
+                        ),
+                        DESCRIPTOR=_MODEL_TRAININGRUN_TRAININGOPTIONS,
+                        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                        __doc__="""Protocol buffer.
+
+  Attributes:
+          max_iterations:
+              The maximum number of iterations in training. Used only for
+              iterative training algorithms.
+          loss_type:
+              Type of loss function used during training run.
+          learn_rate:
+              Learning rate in training. Used only for iterative training
+              algorithms.
+          l1_regularization:
+              L1 regularization coefficient.
+          l2_regularization:
+              L2 regularization coefficient.
+          min_relative_progress:
+              When early\_stop is true, stops training when accuracy
+              improvement is less than 'min\_relative\_progress'. Used only
+              for iterative training algorithms.
+          warm_start:
+              Whether to train a model from the last checkpoint.
+          early_stop:
+              Whether to stop early when the loss doesn't improve
+              significantly any more (compared to min\_relative\_progress).
+              Used only for iterative training algorithms.
+          input_label_columns:
+              Name of input label columns in training data.
+          data_split_method:
+              The data split type for training and evaluation, e.g. RANDOM.
+          data_split_eval_fraction:
+              The fraction of evaluation data over the whole input data. The
+              rest of data will be used as training data. The format should
+              be double. Accurate to two decimal places. Default value is
+              0.2.
+          data_split_column:
+              The column to split data with. This column won't be used as a
+              feature. 1. When data\_split\_method is CUSTOM, the
+              corresponding column should be boolean. The rows with true
+              value tag are eval data, and the false are training data. 2.
+              When data\_split\_method is SEQ, the first
+              DATA\_SPLIT\_EVAL\_FRACTION rows (from smallest to largest) in
+              the corresponding column are used as training data, and the
+              rest are eval data. It respects the order in Orderable data
+              types:
+              https://cloud.google.com/bigquery/docs/reference/standard-
+              sql/data-types#data-type-properties
+          learn_rate_strategy:
+              The strategy to determine learn rate for the current
+              iteration.
+          initial_learn_rate:
+              Specifies the initial learning rate for the line search learn
+              rate strategy.
+          label_class_weights:
+              Weights associated with each label class, for rebalancing the
+              training data. Only applicable for classification models.
+          distance_type:
+              Distance type for clustering models.
+          num_clusters:
+              Number of clusters for clustering models.
+          model_uri:
+              [Beta] Google Cloud Storage URI from which the model was
+              imported. Only applicable for imported models.
+          optimization_strategy:
+              Optimization strategy for training linear regression models.
+          kmeans_initialization_method:
+              The method used to initialize the centroids for kmeans
+              algorithm.
+          kmeans_initialization_column:
+              The column used to provide the initial centroids for kmeans
+              algorithm when kmeans\_initialization\_method is CUSTOM.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.TrainingRun.TrainingOptions)
+                    ),
+                ),
+                IterationResult=_reflection.GeneratedProtocolMessageType(
+                    "IterationResult",
+                    (_message.Message,),
+                    dict(
+                        ClusterInfo=_reflection.GeneratedProtocolMessageType(
+                            "ClusterInfo",
+                            (_message.Message,),
+                            dict(
+                                DESCRIPTOR=_MODEL_TRAININGRUN_ITERATIONRESULT_CLUSTERINFO,
+                                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                                __doc__="""Information about a single cluster for clustering model.
+        
+        
+        Attributes:
+            centroid_id:
+                Centroid id.
+            cluster_radius:
+                Cluster radius, the average distance from centroid to each
+                point assigned to the cluster.
+            cluster_size:
+                Cluster size, the total number of points assigned to the
+                cluster.
+        """,
+                                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.TrainingRun.IterationResult.ClusterInfo)
+                            ),
+                        ),
+                        DESCRIPTOR=_MODEL_TRAININGRUN_ITERATIONRESULT,
+                        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                        __doc__="""Information about a single iteration of the training run.
+      
+      
+      Attributes:
+          index:
+              Index of the iteration, 0 based.
+          duration_ms:
+              Time taken to run the iteration in milliseconds.
+          training_loss:
+              Loss computed on the training data at the end of iteration.
+          eval_loss:
+              Loss computed on the eval data at the end of iteration.
+          learn_rate:
+              Learn rate used for this iteration.
+          cluster_infos:
+              Information about top clusters for clustering models.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.TrainingRun.IterationResult)
+                    ),
+                ),
+                DESCRIPTOR=_MODEL_TRAININGRUN,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2",
+                __doc__="""Information about a single training query run for the model.
+    
+    
+    Attributes:
+        training_options:
+            Options that were used for this training run, includes user
+            specified and default options that were used.
+        start_time:
+            The start time of this training run.
+        results:
+            Output of each iteration run, results.size() <=
+            max\_iterations.
+        evaluation_metrics:
+            The evaluation metrics over training/eval data that were
+            computed at the end of training.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.TrainingRun)
+            ),
+        ),
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODEL_LABELSENTRY,
+                __module__="google.cloud.bigquery_v2.proto.model_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_MODEL,
+        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+        __doc__="""Protocol buffer.
+
+  Attributes:
+      etag:
+          Output only. A hash of this resource.
+      model_reference:
+          Required. Unique identifier for this model.
+      creation_time:
+          Output only. The time when this model was created, in
+          millisecs since the epoch.
+      last_modified_time:
+          Output only. The time when this model was last modified, in
+          millisecs since the epoch.
+      description:
+          [Optional] A user-friendly description of this model.
+      friendly_name:
+          [Optional] A descriptive name for this model.
+      labels:
+          [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 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.
+      expiration_time:
+          [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.
+      location:
+          Output only. The geographic location where the model resides.
+          This value is inherited from the dataset.
+      model_type:
+          Output only. Type of the model resource.
+      training_runs:
+          Output only. Information for all training runs in increasing
+          order of start\_time.
+      feature_columns:
+          Output only. Input feature columns that were used to train
+          this model.
+      label_columns:
+          Output only. Label columns that were used to train this model.
+          The output of the model will have a "predicted\_" prefix to
+          these columns.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.Model)
+    ),
+)
+_sym_db.RegisterMessage(Model)
+_sym_db.RegisterMessage(Model.KmeansEnums)
+_sym_db.RegisterMessage(Model.RegressionMetrics)
+_sym_db.RegisterMessage(Model.AggregateClassificationMetrics)
+_sym_db.RegisterMessage(Model.BinaryClassificationMetrics)
+_sym_db.RegisterMessage(Model.BinaryClassificationMetrics.BinaryConfusionMatrix)
+_sym_db.RegisterMessage(Model.MultiClassClassificationMetrics)
+_sym_db.RegisterMessage(Model.MultiClassClassificationMetrics.ConfusionMatrix)
+_sym_db.RegisterMessage(Model.MultiClassClassificationMetrics.ConfusionMatrix.Entry)
+_sym_db.RegisterMessage(Model.MultiClassClassificationMetrics.ConfusionMatrix.Row)
+_sym_db.RegisterMessage(Model.ClusteringMetrics)
+_sym_db.RegisterMessage(Model.ClusteringMetrics.Cluster)
+_sym_db.RegisterMessage(Model.ClusteringMetrics.Cluster.FeatureValue)
+_sym_db.RegisterMessage(Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue)
+_sym_db.RegisterMessage(
+    Model.ClusteringMetrics.Cluster.FeatureValue.CategoricalValue.CategoryCount
+)
+_sym_db.RegisterMessage(Model.EvaluationMetrics)
+_sym_db.RegisterMessage(Model.TrainingRun)
+_sym_db.RegisterMessage(Model.TrainingRun.TrainingOptions)
+_sym_db.RegisterMessage(Model.TrainingRun.TrainingOptions.LabelClassWeightsEntry)
+_sym_db.RegisterMessage(Model.TrainingRun.IterationResult)
+_sym_db.RegisterMessage(Model.TrainingRun.IterationResult.ClusterInfo)
+_sym_db.RegisterMessage(Model.LabelsEntry)
+
+GetModelRequest = _reflection.GeneratedProtocolMessageType(
+    "GetModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETMODELREQUEST,
+        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+        __doc__="""Protocol buffer.
+
+  Attributes:
+      project_id:
+          Project ID of the requested model.
+      dataset_id:
+          Dataset ID of the requested model.
+      model_id:
+          Model ID of the requested model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.GetModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetModelRequest)
+
+PatchModelRequest = _reflection.GeneratedProtocolMessageType(
+    "PatchModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PATCHMODELREQUEST,
+        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+        __doc__="""Protocol buffer.
+
+  Attributes:
+      project_id:
+          Project ID of the model to patch.
+      dataset_id:
+          Dataset ID of the model to patch.
+      model_id:
+          Model ID of the model to patch.
+      model:
+          Patched model. Follows RFC5789 patch semantics. Missing fields
+          are not updated. To clear a field, explicitly set to default
+          value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.PatchModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(PatchModelRequest)
+
+DeleteModelRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteModelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEMODELREQUEST,
+        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+        __doc__="""Protocol buffer.
+
+  Attributes:
+      project_id:
+          Project ID of the model to delete.
+      dataset_id:
+          Dataset ID of the model to delete.
+      model_id:
+          Model ID of the model to delete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.DeleteModelRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteModelRequest)
+
+ListModelsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListModelsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMODELSREQUEST,
+        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+        __doc__="""Protocol buffer.
+
+  Attributes:
+      project_id:
+          Project ID of the models to list.
+      dataset_id:
+          Dataset ID of the models to list.
+      max_results:
+          The maximum number of results to return in a single response
+          page. Leverage the page tokens to iterate through the entire
+          collection.
+      page_token:
+          Page token, returned by a previous call to request the next
+          page of results
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.ListModelsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListModelsRequest)
+
+ListModelsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListModelsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMODELSRESPONSE,
+        __module__="google.cloud.bigquery_v2.proto.model_pb2",
+        __doc__="""Protocol buffer.
+
+  Attributes:
+      models:
+          Models in the requested dataset. Only the following fields are
+          populated: model\_reference, model\_type, creation\_time,
+          last\_modified\_time and labels.
+      next_page_token:
+          A token to request the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.ListModelsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListModelsResponse)
+
+
+DESCRIPTOR._options = None
+_MODEL_TRAININGRUN_TRAININGOPTIONS_LABELCLASSWEIGHTSENTRY._options = None
+_MODEL_LABELSENTRY._options = None
+
+_MODELSERVICE = _descriptor.ServiceDescriptor(
+    name="ModelService",
+    full_name="google.cloud.bigquery.v2.ModelService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\027bigquery.googleapis.com\322A\302\001https://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"
+    ),
+    serialized_start=7509,
+    serialized_end=8128,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GetModel",
+            full_name="google.cloud.bigquery.v2.ModelService.GetModel",
+            index=0,
+            containing_service=None,
+            input_type=_GETMODELREQUEST,
+            output_type=_MODEL,
+            serialized_options=None,
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListModels",
+            full_name="google.cloud.bigquery.v2.ModelService.ListModels",
+            index=1,
+            containing_service=None,
+            input_type=_LISTMODELSREQUEST,
+            output_type=_LISTMODELSRESPONSE,
+            serialized_options=None,
+        ),
+        _descriptor.MethodDescriptor(
+            name="PatchModel",
+            full_name="google.cloud.bigquery.v2.ModelService.PatchModel",
+            index=2,
+            containing_service=None,
+            input_type=_PATCHMODELREQUEST,
+            output_type=_MODEL,
+            serialized_options=None,
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteModel",
+            full_name="google.cloud.bigquery.v2.ModelService.DeleteModel",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEMODELREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=None,
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_MODELSERVICE)
+
+DESCRIPTOR.services_by_name["ModelService"] = _MODELSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery/google/cloud/bigquery_v2/proto/model_pb2_grpc.py b/bigquery/google/cloud/bigquery_v2/proto/model_pb2_grpc.py
new file mode 100644
index 000000000000..5abcdf0f2606
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/model_pb2_grpc.py
@@ -0,0 +1,102 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigquery_v2.proto import (
+    model_pb2 as google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ModelServiceStub(object):
+    # missing associated documentation comment in .proto file
+    pass
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GetModel = channel.unary_unary(
+            "/google.cloud.bigquery.v2.ModelService/GetModel",
+            request_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.GetModelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.Model.FromString,
+        )
+        self.ListModels = channel.unary_unary(
+            "/google.cloud.bigquery.v2.ModelService/ListModels",
+            request_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.ListModelsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.ListModelsResponse.FromString,
+        )
+        self.PatchModel = channel.unary_unary(
+            "/google.cloud.bigquery.v2.ModelService/PatchModel",
+            request_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.PatchModelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.Model.FromString,
+        )
+        self.DeleteModel = channel.unary_unary(
+            "/google.cloud.bigquery.v2.ModelService/DeleteModel",
+            request_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.DeleteModelRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class ModelServiceServicer(object):
+    # missing associated documentation comment in .proto file
+    pass
+
+    def GetModel(self, request, context):
+        """Gets the specified model resource by model ID.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListModels(self, request, context):
+        """Lists all models in the specified dataset. Requires the READER dataset
+    role.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PatchModel(self, request, context):
+        """Patch specific fields in the specified model.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteModel(self, request, context):
+        """Deletes the model specified by modelId from the dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ModelServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GetModel": grpc.unary_unary_rpc_method_handler(
+            servicer.GetModel,
+            request_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.GetModelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.Model.SerializeToString,
+        ),
+        "ListModels": grpc.unary_unary_rpc_method_handler(
+            servicer.ListModels,
+            request_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.ListModelsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.ListModelsResponse.SerializeToString,
+        ),
+        "PatchModel": grpc.unary_unary_rpc_method_handler(
+            servicer.PatchModel,
+            request_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.PatchModelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.Model.SerializeToString,
+        ),
+        "DeleteModel": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteModel,
+            request_deserializer=google_dot_cloud_dot_bigquery__v2_dot_proto_dot_model__pb2.DeleteModelRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.bigquery.v2.ModelService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigquery/google/cloud/bigquery_v2/proto/model_reference.proto b/bigquery/google/cloud/bigquery_v2/proto/model_reference.proto
new file mode 100644
index 000000000000..f436659abd4f
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/model_reference.proto
@@ -0,0 +1,38 @@
+// 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/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery";
+option java_outer_classname = "ModelReferenceProto";
+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 dataset containing this model.
+  string dataset_id = 2;
+
+  // [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;
+}
diff --git a/bigquery/google/cloud/bigquery_v2/proto/model_reference_pb2.py b/bigquery/google/cloud/bigquery_v2/proto/model_reference_pb2.py
new file mode 100644
index 000000000000..94f6116b5a44
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/model_reference_pb2.py
@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery_v2/proto/model_reference.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery_v2/proto/model_reference.proto",
+    package="google.cloud.bigquery.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.bigquery.v2B\023ModelReferenceProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/bigquery_v2/proto/model_reference.proto\x12\x18google.cloud.bigquery.v2\x1a\x1cgoogle/api/annotations.proto"J\n\x0eModelReference\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x10\n\x08model_id\x18\x03 \x01(\tBu\n\x1c\x63om.google.cloud.bigquery.v2B\x13ModelReferenceProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigqueryb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_MODELREFERENCE = _descriptor.Descriptor(
+    name="ModelReference",
+    full_name="google.cloud.bigquery.v2.ModelReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.bigquery.v2.ModelReference.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.bigquery.v2.ModelReference.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_id",
+            full_name="google.cloud.bigquery.v2.ModelReference.model_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=112,
+    serialized_end=186,
+)
+
+DESCRIPTOR.message_types_by_name["ModelReference"] = _MODELREFERENCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ModelReference = _reflection.GeneratedProtocolMessageType(
+    "ModelReference",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODELREFERENCE,
+        __module__="google.cloud.bigquery_v2.proto.model_reference_pb2",
+        __doc__="""Id path of a model.
+  
+  
+  Attributes:
+      project_id:
+          [Required] The ID of the project containing this model.
+      dataset_id:
+          [Required] The ID of the dataset containing this model.
+      model_id:
+          [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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.ModelReference)
+    ),
+)
+_sym_db.RegisterMessage(ModelReference)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery/google/cloud/bigquery_v2/proto/model_reference_pb2_grpc.py b/bigquery/google/cloud/bigquery_v2/proto/model_reference_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/model_reference_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery/google/cloud/bigquery_v2/proto/standard_sql.proto b/bigquery/google/cloud/bigquery_v2/proto/standard_sql.proto
new file mode 100644
index 000000000000..98173092ff71
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/standard_sql.proto
@@ -0,0 +1,109 @@
+// 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/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery";
+option java_outer_classname = "StandardSqlProto";
+option java_package = "com.google.cloud.bigquery.v2";
+
+// The type of a variable, e.g., a function argument.
+// Examples:
+// INT64: {type_kind="INT64"}
+// ARRAY<STRING>: {type_kind="ARRAY", array_element_type="STRING"}
+// STRUCT<x STRING, y ARRAY<DATE>>:
+//   {type_kind="STRUCT",
+//    struct_type={fields=[
+//      {name="x", type={type_kind="STRING"}},
+//      {name="y", type={type_kind="ARRAY", array_element_type="DATE"}}
+//    ]}}
+message StandardSqlDataType {
+  enum TypeKind {
+    // Invalid type.
+    TYPE_KIND_UNSPECIFIED = 0;
+
+    // Encoded as a string in decimal format.
+    INT64 = 2;
+
+    // Encoded as a boolean "false" or "true".
+    BOOL = 5;
+
+    // Encoded as a number, or string "NaN", "Infinity" or "-Infinity".
+    FLOAT64 = 7;
+
+    // Encoded as a string value.
+    STRING = 8;
+
+    // Encoded as a base64 string per RFC 4648, section 4.
+    BYTES = 9;
+
+    // Encoded as an RFC 3339 timestamp with mandatory "Z" time zone string:
+    // 1985-04-12T23:20:50.52Z
+    TIMESTAMP = 19;
+
+    // Encoded as RFC 3339 full-date format string: 1985-04-12
+    DATE = 10;
+
+    // Encoded as RFC 3339 partial-time format string: 23:20:50.52
+    TIME = 20;
+
+    // Encoded as RFC 3339 full-date "T" partial-time: 1985-04-12T23:20:50.52
+    DATETIME = 21;
+
+    // Encoded as WKT
+    GEOGRAPHY = 22;
+
+    // Encoded as a decimal string.
+    NUMERIC = 23;
+
+    // Encoded as a list with types matching Type.array_type.
+    ARRAY = 16;
+
+    // Encoded as a list with fields of type Type.struct_type[i]. List is used
+    // because a JSON object cannot have duplicate field names.
+    STRUCT = 17;
+  }
+
+  // Required. The top level type of this field.
+  // Can be any standard SQL data type (e.g., "INT64", "DATE", "ARRAY").
+  TypeKind type_kind = 1;
+
+  oneof sub_type {
+    // The type of the array's elements, if type_kind = "ARRAY".
+    StandardSqlDataType array_element_type = 2;
+
+    // The fields of this struct, in order, if type_kind = "STRUCT".
+    StandardSqlStructType struct_type = 3;
+  }
+}
+
+// A field or a column.
+message StandardSqlField {
+  // Optional. The name of this field. Can be absent for struct fields.
+  string name = 1;
+
+  // 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;
+}
+
+message StandardSqlStructType {
+  repeated StandardSqlField fields = 1;
+}
diff --git a/bigquery/google/cloud/bigquery_v2/proto/standard_sql_pb2.py b/bigquery/google/cloud/bigquery_v2/proto/standard_sql_pb2.py
new file mode 100644
index 000000000000..91f1554f7f80
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/standard_sql_pb2.py
@@ -0,0 +1,366 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery_v2/proto/standard_sql.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery_v2/proto/standard_sql.proto",
+    package="google.cloud.bigquery.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.bigquery.v2B\020StandardSqlProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/bigquery_v2/proto/standard_sql.proto\x12\x18google.cloud.bigquery.v2\x1a\x1cgoogle/api/annotations.proto"\xc6\x03\n\x13StandardSqlDataType\x12I\n\ttype_kind\x18\x01 \x01(\x0e\x32\x36.google.cloud.bigquery.v2.StandardSqlDataType.TypeKind\x12K\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32-.google.cloud.bigquery.v2.StandardSqlDataTypeH\x00\x12\x46\n\x0bstruct_type\x18\x03 \x01(\x0b\x32/.google.cloud.bigquery.v2.StandardSqlStructTypeH\x00"\xc2\x01\n\x08TypeKind\x12\x19\n\x15TYPE_KIND_UNSPECIFIED\x10\x00\x12\t\n\x05INT64\x10\x02\x12\x08\n\x04\x42OOL\x10\x05\x12\x0b\n\x07\x46LOAT64\x10\x07\x12\n\n\x06STRING\x10\x08\x12\t\n\x05\x42YTES\x10\t\x12\r\n\tTIMESTAMP\x10\x13\x12\x08\n\x04\x44\x41TE\x10\n\x12\x08\n\x04TIME\x10\x14\x12\x0c\n\x08\x44\x41TETIME\x10\x15\x12\r\n\tGEOGRAPHY\x10\x16\x12\x0b\n\x07NUMERIC\x10\x17\x12\t\n\x05\x41RRAY\x10\x10\x12\n\n\x06STRUCT\x10\x11\x42\n\n\x08sub_type"]\n\x10StandardSqlField\x12\x0c\n\x04name\x18\x01 \x01(\t\x12;\n\x04type\x18\x02 \x01(\x0b\x32-.google.cloud.bigquery.v2.StandardSqlDataType"S\n\x15StandardSqlStructType\x12:\n\x06\x66ields\x18\x01 \x03(\x0b\x32*.google.cloud.bigquery.v2.StandardSqlFieldBr\n\x1c\x63om.google.cloud.bigquery.v2B\x10StandardSqlProtoZ@google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigqueryb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_STANDARDSQLDATATYPE_TYPEKIND = _descriptor.EnumDescriptor(
+    name="TypeKind",
+    full_name="google.cloud.bigquery.v2.StandardSqlDataType.TypeKind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_KIND_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INT64", index=1, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOL", index=2, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLOAT64", index=3, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRING", index=4, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BYTES", index=5, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIMESTAMP", index=6, number=19, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATE", index=7, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIME", index=8, number=20, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATETIME", index=9, number=21, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GEOGRAPHY", index=10, number=22, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMERIC", index=11, number=23, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ARRAY", index=12, number=16, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRUCT", index=13, number=17, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=358,
+    serialized_end=552,
+)
+_sym_db.RegisterEnumDescriptor(_STANDARDSQLDATATYPE_TYPEKIND)
+
+
+_STANDARDSQLDATATYPE = _descriptor.Descriptor(
+    name="StandardSqlDataType",
+    full_name="google.cloud.bigquery.v2.StandardSqlDataType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type_kind",
+            full_name="google.cloud.bigquery.v2.StandardSqlDataType.type_kind",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_element_type",
+            full_name="google.cloud.bigquery.v2.StandardSqlDataType.array_element_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="struct_type",
+            full_name="google.cloud.bigquery.v2.StandardSqlDataType.struct_type",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STANDARDSQLDATATYPE_TYPEKIND],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="sub_type",
+            full_name="google.cloud.bigquery.v2.StandardSqlDataType.sub_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=110,
+    serialized_end=564,
+)
+
+
+_STANDARDSQLFIELD = _descriptor.Descriptor(
+    name="StandardSqlField",
+    full_name="google.cloud.bigquery.v2.StandardSqlField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.v2.StandardSqlField.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.bigquery.v2.StandardSqlField.type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=566,
+    serialized_end=659,
+)
+
+
+_STANDARDSQLSTRUCTTYPE = _descriptor.Descriptor(
+    name="StandardSqlStructType",
+    full_name="google.cloud.bigquery.v2.StandardSqlStructType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.bigquery.v2.StandardSqlStructType.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=661,
+    serialized_end=744,
+)
+
+_STANDARDSQLDATATYPE.fields_by_name[
+    "type_kind"
+].enum_type = _STANDARDSQLDATATYPE_TYPEKIND
+_STANDARDSQLDATATYPE.fields_by_name[
+    "array_element_type"
+].message_type = _STANDARDSQLDATATYPE
+_STANDARDSQLDATATYPE.fields_by_name["struct_type"].message_type = _STANDARDSQLSTRUCTTYPE
+_STANDARDSQLDATATYPE_TYPEKIND.containing_type = _STANDARDSQLDATATYPE
+_STANDARDSQLDATATYPE.oneofs_by_name["sub_type"].fields.append(
+    _STANDARDSQLDATATYPE.fields_by_name["array_element_type"]
+)
+_STANDARDSQLDATATYPE.fields_by_name[
+    "array_element_type"
+].containing_oneof = _STANDARDSQLDATATYPE.oneofs_by_name["sub_type"]
+_STANDARDSQLDATATYPE.oneofs_by_name["sub_type"].fields.append(
+    _STANDARDSQLDATATYPE.fields_by_name["struct_type"]
+)
+_STANDARDSQLDATATYPE.fields_by_name[
+    "struct_type"
+].containing_oneof = _STANDARDSQLDATATYPE.oneofs_by_name["sub_type"]
+_STANDARDSQLFIELD.fields_by_name["type"].message_type = _STANDARDSQLDATATYPE
+_STANDARDSQLSTRUCTTYPE.fields_by_name["fields"].message_type = _STANDARDSQLFIELD
+DESCRIPTOR.message_types_by_name["StandardSqlDataType"] = _STANDARDSQLDATATYPE
+DESCRIPTOR.message_types_by_name["StandardSqlField"] = _STANDARDSQLFIELD
+DESCRIPTOR.message_types_by_name["StandardSqlStructType"] = _STANDARDSQLSTRUCTTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+StandardSqlDataType = _reflection.GeneratedProtocolMessageType(
+    "StandardSqlDataType",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STANDARDSQLDATATYPE,
+        __module__="google.cloud.bigquery_v2.proto.standard_sql_pb2",
+        __doc__="""The type of a variable, e.g., a function argument. Examples: INT64:
+  {type\_kind="INT64"} ARRAY: {type\_kind="ARRAY",
+  array\_element\_type="STRING"} STRUCT<x STRING, y ARRAY>:
+  {type\_kind="STRUCT", struct\_type={fields=[ {name="x",
+  type={type\_kind="STRING"}}, {name="y", type={type\_kind="ARRAY",
+  array\_element\_type="DATE"}} ]}}
+  
+  
+  Attributes:
+      type_kind:
+          Required. The top level type of this field. Can be any
+          standard SQL data type (e.g., "INT64", "DATE", "ARRAY").
+      array_element_type:
+          The type of the array's elements, if type\_kind = "ARRAY".
+      struct_type:
+          The fields of this struct, in order, if type\_kind = "STRUCT".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.StandardSqlDataType)
+    ),
+)
+_sym_db.RegisterMessage(StandardSqlDataType)
+
+StandardSqlField = _reflection.GeneratedProtocolMessageType(
+    "StandardSqlField",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STANDARDSQLFIELD,
+        __module__="google.cloud.bigquery_v2.proto.standard_sql_pb2",
+        __doc__="""A field or a column.
+  
+  
+  Attributes:
+      name:
+          Optional. The name of this field. Can be absent for struct
+          fields.
+      type:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.StandardSqlField)
+    ),
+)
+_sym_db.RegisterMessage(StandardSqlField)
+
+StandardSqlStructType = _reflection.GeneratedProtocolMessageType(
+    "StandardSqlStructType",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STANDARDSQLSTRUCTTYPE,
+        __module__="google.cloud.bigquery_v2.proto.standard_sql_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.v2.StandardSqlStructType)
+    ),
+)
+_sym_db.RegisterMessage(StandardSqlStructType)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery/google/cloud/bigquery_v2/proto/standard_sql_pb2_grpc.py b/bigquery/google/cloud/bigquery_v2/proto/standard_sql_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/proto/standard_sql_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery/google/cloud/bigquery_v2/types.py b/bigquery/google/cloud/bigquery_v2/types.py
new file mode 100644
index 000000000000..36fc2d6bfbd2
--- /dev/null
+++ b/bigquery/google/cloud/bigquery_v2/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.bigquery_v2.proto import model_pb2
+from google.cloud.bigquery_v2.proto import model_reference_pb2
+from google.cloud.bigquery_v2.proto import standard_sql_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+
+
+_shared_modules = [empty_pb2, timestamp_pb2, wrappers_pb2]
+
+_local_modules = [model_pb2, model_reference_pb2, standard_sql_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.bigquery_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/bigquery/noxfile.py b/bigquery/noxfile.py
new file mode 100644
index 000000000000..37611a5ce296
--- /dev/null
+++ b/bigquery/noxfile.py
@@ -0,0 +1,196 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (
+    os.path.join("..", "api_core[grpc]"),
+    os.path.join("..", "core"),
+    os.path.join("..", "test_utils"),
+)
+
+BLACK_PATHS = ("docs", "google", "samples", "tests", "noxfile.py", "setup.py")
+
+
+def default(session):
+    """Default unit test session.
+
+    This is intended to be run **without** an interpreter set, so
+    that the current ``python`` (on the ``PATH``) or the version of
+    Python corresponding to the ``nox`` binary the ``PATH`` can
+    run the tests.
+    """
+    # Install all test dependencies, then install local packages in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+
+    dev_install = ".[all]"
+    session.install("-e", dev_install)
+
+    # IPython does not support Python 2 after version 5.x
+    if session.python == "2.7":
+        session.install("ipython==5.5")
+    else:
+        session.install("ipython")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud.bigquery",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.6"])
+def system(session):
+    """Run the system test suite."""
+
+    # Sanity check: Only run system tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable.")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install local packages in place.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", os.path.join("..", "storage"))
+    session.install("-e", os.path.join("..", "test_utils"))
+    session.install("-e", ".[all]")
+
+    # IPython does not support Python 2 after version 5.x
+    if session.python == "2.7":
+        session.install("ipython==5.5")
+    else:
+        session.install("ipython")
+
+    # Run py.test against the system tests.
+    session.run(
+        "py.test", "--quiet", os.path.join("tests", "system.py"), *session.posargs
+    )
+
+
+@nox.session(python=["2.7", "3.6"])
+def snippets(session):
+    """Run the snippets test suite."""
+
+    # Sanity check: Only run snippets tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable.")
+
+    # Install all test dependencies, then install local packages in place.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", os.path.join("..", "storage"))
+    session.install("-e", os.path.join("..", "test_utils"))
+    session.install("-e", ".[all]")
+
+    # Run py.test against the snippets tests.
+    session.run("py.test", os.path.join("docs", "snippets.py"), *session.posargs)
+    session.run("py.test", "samples", *session.posargs)
+
+
+@nox.session(python="3.6")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.6")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+
+    session.install("black", "flake8")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+    session.run("flake8", os.path.join("google", "cloud", "bigquery"))
+    session.run("flake8", "tests")
+    session.run("flake8", os.path.join("docs", "snippets.py"))
+    session.run("black", "--check", *BLACK_PATHS)
+
+
+@nox.session(python="3.6")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+
+    session.install("docutils", "Pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.6")
+def docs(session):
+    """Build the docs."""
+
+    session.install("ipython", "recommonmark", "sphinx", "sphinx_rtd_theme")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", os.path.join("..", "storage"))
+    session.install("-e", ".[all]")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/bigquery/pylint.config.py b/bigquery/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/bigquery/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/bigquery/samples/__init__.py b/bigquery/samples/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/samples/add_empty_column.py b/bigquery/samples/add_empty_column.py
new file mode 100644
index 000000000000..eb84037598d3
--- /dev/null
+++ b/bigquery/samples/add_empty_column.py
@@ -0,0 +1,40 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def add_empty_column(client, table_id):
+
+    # [START bigquery_add_empty_column]
+    from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set table_id to the ID of the table to add an empty column.
+    # table_id = "your-project.your_dataset.your_table_name"
+
+    table = client.get_table(table_id)
+
+    original_schema = table.schema
+    new_schema = original_schema[:]  # creates a copy of the schema
+    new_schema.append(bigquery.SchemaField("phone", "STRING"))
+
+    table.schema = new_schema
+    table = client.update_table(table, ["schema"])  # API request
+
+    if len(table.schema) == len(original_schema) + 1 == len(new_schema):
+        print("A new column has been added.")
+    else:
+        print("The column has not been added.")
+    # [END bigquery_add_empty_column]
diff --git a/bigquery/samples/browse_table_data.py b/bigquery/samples/browse_table_data.py
new file mode 100644
index 000000000000..dd6c572cab6d
--- /dev/null
+++ b/bigquery/samples/browse_table_data.py
@@ -0,0 +1,47 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def browse_table_data(client, table_id):
+
+    # [START bigquery_browse_table]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set table_id to the ID of the table to browse data rows.
+    # table_id = "your-project.your_dataset.your_table_name"
+
+    # Download all rows from a table.
+    rows_iter = client.list_rows(table_id)
+
+    # Iterate over rows to make the API requests to fetch row data.
+    rows = list(rows_iter)
+    print("Downloaded {} rows from table {}".format(len(rows), table_id))
+
+    # Download at most 10 rows.
+    rows_iter = client.list_rows(table_id, max_results=10)
+    rows = list(rows_iter)
+    print("Downloaded {} rows from table {}".format(len(rows), table_id))
+
+    # Specify selected fields to limit the results to certain columns.
+    table = client.get_table(table_id)
+    fields = table.schema[:2]  # first two columns
+    rows_iter = client.list_rows(table_id, selected_fields=fields, max_results=10)
+    rows = list(rows_iter)
+    print("Selected {} columns from table {}.".format(len(rows_iter.schema), table_id))
+    print("Downloaded {} rows from table {}".format(len(rows), table_id))
+    # [END bigquery_browse_table]
diff --git a/bigquery/samples/create_dataset.py b/bigquery/samples/create_dataset.py
new file mode 100644
index 000000000000..89ca9d38f5f3
--- /dev/null
+++ b/bigquery/samples/create_dataset.py
@@ -0,0 +1,38 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def create_dataset(client, dataset_id):
+
+    # [START bigquery_create_dataset]
+    from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to create.
+    # dataset_id = "{}.your_dataset".format(client.project)
+
+    # Construct a full Dataset object to send to the API.
+    dataset = bigquery.Dataset(dataset_id)
+
+    # TODO(developer): Specify the geographic location where the dataset should reside.
+    dataset.location = "US"
+
+    # Send the dataset to the API for creation.
+    # Raises google.api_core.exceptions.Conflict if the Dataset already
+    # exists within the project.
+    dataset = client.create_dataset(dataset)  # API request
+    print("Created dataset {}.{}".format(client.project, dataset.dataset_id))
+    # [END bigquery_create_dataset]
diff --git a/bigquery/samples/create_job.py b/bigquery/samples/create_job.py
new file mode 100644
index 000000000000..24bb85510598
--- /dev/null
+++ b/bigquery/samples/create_job.py
@@ -0,0 +1,40 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def create_job(client):
+
+    # [START bigquery_create_job]
+    from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    query_job = client.query(
+        "SELECT country_name from `bigquery-public-data.utility_us.country_code_iso`",
+        # Explicitly force job execution to be routed to a specific processing
+        # location.
+        location="US",
+        # Specify a job configuration to set optional job resource properties.
+        job_config=bigquery.QueryJobConfig(
+            labels={"example-label": "example-value"}, maximum_bytes_billed=1000000
+        ),
+        # The client libraries automatically generate a job ID. Override the
+        # generated ID with either the job_id_prefix or job_id parameters.
+        job_id_prefix="code_sample_",
+    )  # API request
+
+    print("Started job: {}".format(query_job.job_id))
+    # [END bigquery_create_job]
+    return query_job
diff --git a/bigquery/samples/create_routine.py b/bigquery/samples/create_routine.py
new file mode 100644
index 000000000000..c08ec4799a3e
--- /dev/null
+++ b/bigquery/samples/create_routine.py
@@ -0,0 +1,47 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def create_routine(client, routine_id):
+
+    # [START bigquery_create_routine]
+    from google.cloud import bigquery
+    from google.cloud import bigquery_v2
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Choose a fully-qualified ID for the routine.
+    # routine_id = "my-project.my_dataset.my_routine"
+
+    routine = bigquery.Routine(
+        routine_id,
+        type_="SCALAR_FUNCTION",
+        language="SQL",
+        body="x * 3",
+        arguments=[
+            bigquery.RoutineArgument(
+                name="x",
+                data_type=bigquery_v2.types.StandardSqlDataType(
+                    type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+                ),
+            )
+        ],
+    )
+
+    routine = client.create_routine(routine)
+
+    print("Created routine {}".format(routine.reference))
+    # [END bigquery_create_routine]
+    return routine
diff --git a/bigquery/samples/create_routine_ddl.py b/bigquery/samples/create_routine_ddl.py
new file mode 100644
index 000000000000..a4ae3318e7b4
--- /dev/null
+++ b/bigquery/samples/create_routine_ddl.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def create_routine_ddl(client, routine_id):
+
+    # [START bigquery_create_routine_ddl]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Choose a fully-qualified ID for the routine.
+    # routine_id = "my-project.my_dataset.my_routine"
+
+    sql = """
+    CREATE FUNCTION `{}`(
+        arr ARRAY<STRUCT<name STRING, val INT64>>
+    ) AS (
+        (SELECT SUM(IF(elem.name = "foo",elem.val,null)) FROM UNNEST(arr) AS elem)
+    )
+    """.format(
+        routine_id
+    )
+
+    # Initiate the query to create the routine.
+    query_job = client.query(sql)
+
+    # Wait for the query to complete.
+    query_job.result()
+
+    print("Created routine {}".format(query_job.ddl_target_routine))
+    # [END bigquery_create_routine_ddl]
diff --git a/bigquery/samples/create_table.py b/bigquery/samples/create_table.py
new file mode 100644
index 000000000000..2a6e98fc72f6
--- /dev/null
+++ b/bigquery/samples/create_table.py
@@ -0,0 +1,37 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def create_table(client, table_id):
+
+    # [START bigquery_create_table]
+    from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set table_id to the ID of the table to create
+    # table_id = "your-project.your_dataset.your_table_name"
+
+    schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+    ]
+
+    table = bigquery.Table(table_id, schema=schema)
+    table = client.create_table(table)  # API request
+    print(
+        "Created table {}.{}.{}".format(table.project, table.dataset_id, table.table_id)
+    )
+    # [END bigquery_create_table]
diff --git a/bigquery/samples/dataset_exists.py b/bigquery/samples/dataset_exists.py
new file mode 100644
index 000000000000..46cf26a623bf
--- /dev/null
+++ b/bigquery/samples/dataset_exists.py
@@ -0,0 +1,29 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def dataset_exists(client, dataset_id):
+
+    # [START bigquery_dataset_exists]
+    from google.cloud.exceptions import NotFound
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to determine existence.
+    # dataset_id = "your-project.your_dataset"
+
+    try:
+        client.get_dataset(dataset_id)
+        print("Dataset {} already exists".format(dataset_id))
+    except NotFound:
+        print("Dataset {} is not found".format(dataset_id))
+    # [END bigquery_dataset_exists]
diff --git a/bigquery/samples/delete_dataset.py b/bigquery/samples/delete_dataset.py
new file mode 100644
index 000000000000..6cde1b6b2d27
--- /dev/null
+++ b/bigquery/samples/delete_dataset.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def delete_dataset(client, dataset_id):
+
+    # [START bigquery_delete_dataset]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set model_id to the ID of the model to fetch.
+    # dataset_id = 'your-project.your_dataset'
+
+    # Use the delete_contents parameter to delete a dataset and its contents
+    # Use the not_found_ok parameter to not receive an error if the dataset has already been deleted.
+    client.delete_dataset(dataset_id, delete_contents=True, not_found_ok=True)
+
+    print("Deleted dataset '{}'.".format(dataset_id))
+    # [END bigquery_delete_dataset]
diff --git a/bigquery/samples/delete_dataset_labels.py b/bigquery/samples/delete_dataset_labels.py
new file mode 100644
index 000000000000..33ff5c0f2620
--- /dev/null
+++ b/bigquery/samples/delete_dataset_labels.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def delete_dataset_labels(client, dataset_id):
+
+    # [START bigquery_delete_label_dataset]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = "your-project.your_dataset"
+
+    dataset = client.get_dataset(dataset_id)
+
+    # To delete a label from a dataset, set its value to None
+    dataset.labels["color"] = None
+
+    dataset = client.update_dataset(dataset, ["labels"])
+    print("Labels deleted from {}".format(dataset_id))
+    # [END bigquery_delete_label_dataset]
+    return dataset
diff --git a/bigquery/samples/delete_model.py b/bigquery/samples/delete_model.py
new file mode 100644
index 000000000000..5ac4305bc97e
--- /dev/null
+++ b/bigquery/samples/delete_model.py
@@ -0,0 +1,32 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def delete_model(client, model_id):
+    """Sample ID: go/samples-tracker/1534"""
+
+    # [START bigquery_delete_model]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set model_id to the ID of the model to fetch.
+    # model_id = 'your-project.your_dataset.your_model'
+
+    client.delete_model(model_id)
+
+    print("Deleted model '{}'.".format(model_id))
+    # [END bigquery_delete_model]
diff --git a/bigquery/samples/delete_routine.py b/bigquery/samples/delete_routine.py
new file mode 100644
index 000000000000..c0164b415008
--- /dev/null
+++ b/bigquery/samples/delete_routine.py
@@ -0,0 +1,31 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def delete_routine(client, routine_id):
+
+    # [START bigquery_delete_routine]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set the fully-qualified ID for the routine.
+    # routine_id = "my-project.my_dataset.my_routine"
+
+    client.delete_routine(routine_id)
+
+    print("Deleted routine {}.".format(routine_id))
+    # [END bigquery_delete_routine]
diff --git a/bigquery/samples/delete_table.py b/bigquery/samples/delete_table.py
new file mode 100644
index 000000000000..dcdd3d855b2e
--- /dev/null
+++ b/bigquery/samples/delete_table.py
@@ -0,0 +1,32 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def delete_table(client, table_id):
+
+    # [START bigquery_delete_table]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set table_id to the ID of the table to fetch.
+    # table_id = 'your-project.your_dataset.your_table'
+
+    # If the table does not exist, delete_table raises
+    # google.api_core.exceptions.NotFound unless not_found_ok is True
+    client.delete_table(table_id, not_found_ok=True)
+    print("Deleted table '{}'.".format(table_id))
+    # [END bigquery_delete_table]
diff --git a/bigquery/samples/get_dataset.py b/bigquery/samples/get_dataset.py
new file mode 100644
index 000000000000..5586c2b95ebb
--- /dev/null
+++ b/bigquery/samples/get_dataset.py
@@ -0,0 +1,56 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def get_dataset(client, dataset_id):
+
+    # [START bigquery_get_dataset]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = 'your-project.your_dataset'
+
+    dataset = client.get_dataset(dataset_id)
+
+    full_dataset_id = "{}.{}".format(dataset.project, dataset.dataset_id)
+    friendly_name = dataset.friendly_name
+    print(
+        "Got dataset '{}' with friendly_name '{}'.".format(
+            full_dataset_id, friendly_name
+        )
+    )
+
+    # View dataset properties
+    print("Description: {}".format(dataset.description))
+    print("Labels:")
+    labels = dataset.labels
+    if labels:
+        for label, value in labels.items():
+            print("\t{}: {}".format(label, value))
+    else:
+        print("\tDataset has no labels defined.")
+
+    # View tables in dataset
+    print("Tables:")
+    tables = list(client.list_tables(dataset))  # API request(s)
+    if tables:
+        for table in tables:
+            print("\t{}".format(table.table_id))
+    else:
+        print("\tThis dataset does not contain any tables.")
+    # [END bigquery_get_dataset]
diff --git a/bigquery/samples/get_dataset_labels.py b/bigquery/samples/get_dataset_labels.py
new file mode 100644
index 000000000000..2f21723a550b
--- /dev/null
+++ b/bigquery/samples/get_dataset_labels.py
@@ -0,0 +1,38 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def get_dataset_labels(client, dataset_id):
+
+    # [START bigquery_get_dataset_labels]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = "your-project.your_dataset"
+
+    dataset = client.get_dataset(dataset_id)
+
+    # View dataset labels
+    print("Dataset ID: {}".format(dataset_id))
+    print("Labels:")
+    if dataset.labels:
+        for label, value in dataset.labels.items():
+            print("\t{}: {}".format(label, value))
+    else:
+        print("\tDataset has no labels defined.")
+    # [END bigquery_get_dataset_labels]
diff --git a/bigquery/samples/get_model.py b/bigquery/samples/get_model.py
new file mode 100644
index 000000000000..69986733c50b
--- /dev/null
+++ b/bigquery/samples/get_model.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def get_model(client, model_id):
+    """Sample ID: go/samples-tracker/1510"""
+
+    # [START bigquery_get_model]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set model_id to the ID of the model to fetch.
+    # model_id = 'your-project.your_dataset.your_model'
+
+    model = client.get_model(model_id)
+
+    full_model_id = "{}.{}.{}".format(model.project, model.dataset_id, model.model_id)
+    friendly_name = model.friendly_name
+    print(
+        "Got model '{}' with friendly_name '{}'.".format(full_model_id, friendly_name)
+    )
+    # [END bigquery_get_model]
diff --git a/bigquery/samples/get_routine.py b/bigquery/samples/get_routine.py
new file mode 100644
index 000000000000..d9035c282438
--- /dev/null
+++ b/bigquery/samples/get_routine.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def get_routine(client, routine_id):
+
+    # [START bigquery_get_routine]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set the fully-qualified ID for the routine.
+    # routine_id = "my-project.my_dataset.my_routine"
+
+    routine = client.get_routine(routine_id)
+
+    print("Routine `{}`:".format(routine.reference))
+    print("  Type: '{}'".format(routine.type_))
+    print("  Language: '{}'".format(routine.language))
+    print("  Arguments:")
+
+    for argument in routine.arguments:
+        print("    Name: '{}'".format(argument.name))
+        print("    Type: '{}'".format(argument.type_))
+    # [END bigquery_get_routine]
+    return routine
diff --git a/bigquery/samples/get_table.py b/bigquery/samples/get_table.py
new file mode 100644
index 000000000000..e49e032f6e23
--- /dev/null
+++ b/bigquery/samples/get_table.py
@@ -0,0 +1,38 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def get_table(client, table_id):
+
+    # [START bigquery_get_table]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set table_id to the ID of the model to fetch.
+    # table_id = 'your-project.your_dataset.your_table'
+
+    table = client.get_table(table_id)
+
+    print(
+        "Got table '{}.{}.{}'.".format(table.project, table.dataset_id, table.table_id)
+    )
+
+    # View table properties
+    print("Table schema: {}".format(table.schema))
+    print("Table description: {}".format(table.description))
+    print("Table has {} rows".format(table.num_rows))
+    # [END bigquery_get_table]
diff --git a/bigquery/samples/label_dataset.py b/bigquery/samples/label_dataset.py
new file mode 100644
index 000000000000..7840ea25a63f
--- /dev/null
+++ b/bigquery/samples/label_dataset.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def label_dataset(client, dataset_id):
+
+    # [START bigquery_label_dataset]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = "your-project.your_dataset"
+
+    dataset = client.get_dataset(dataset_id)
+    dataset.labels = {"color": "green"}
+    dataset = client.update_dataset(dataset, ["labels"])
+
+    print("Labels added to {}".format(dataset_id))
+    # [END bigquery_label_dataset]
diff --git a/bigquery/samples/list_datasets.py b/bigquery/samples/list_datasets.py
new file mode 100644
index 000000000000..b57aad1b5e7b
--- /dev/null
+++ b/bigquery/samples/list_datasets.py
@@ -0,0 +1,34 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def list_datasets(client):
+
+    # [START bigquery_list_datasets]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    datasets = list(client.list_datasets())
+    project = client.project
+
+    if datasets:
+        print("Datasets in project {}:".format(project))
+        for dataset in datasets:  # API request(s)
+            print("\t{}".format(dataset.dataset_id))
+    else:
+        print("{} project does not contain any datasets.".format(project))
+    # [END bigquery_list_datasets]
diff --git a/bigquery/samples/list_datasets_by_label.py b/bigquery/samples/list_datasets_by_label.py
new file mode 100644
index 000000000000..8b574b1110eb
--- /dev/null
+++ b/bigquery/samples/list_datasets_by_label.py
@@ -0,0 +1,34 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def list_datasets_by_label(client):
+
+    # [START bigquery_list_datasets_by_label]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    label_filter = "labels.color:green"
+    datasets = list(client.list_datasets(filter=label_filter))
+
+    if datasets:
+        print("Datasets filtered by {}:".format(label_filter))
+        for dataset in datasets:
+            print("\t{}.{}".format(dataset.project, dataset.dataset_id))
+    else:
+        print("No datasets found with this filter.")
+    # [END bigquery_list_datasets_by_label]
diff --git a/bigquery/samples/list_models.py b/bigquery/samples/list_models.py
new file mode 100644
index 000000000000..5b4d21799b28
--- /dev/null
+++ b/bigquery/samples/list_models.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def list_models(client, dataset_id):
+    """Sample ID: go/samples-tracker/1512"""
+
+    # [START bigquery_list_models]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset that contains
+    #                  the models you are listing.
+    # dataset_id = 'your-project.your_dataset'
+
+    models = client.list_models(dataset_id)
+
+    print("Models contained in '{}':".format(dataset_id))
+    for model in models:
+        full_model_id = "{}.{}.{}".format(
+            model.project, model.dataset_id, model.model_id
+        )
+        friendly_name = model.friendly_name
+        print("{}: friendly_name='{}'".format(full_model_id, friendly_name))
+    # [END bigquery_list_models]
diff --git a/bigquery/samples/list_routines.py b/bigquery/samples/list_routines.py
new file mode 100644
index 000000000000..1ae4f441cde1
--- /dev/null
+++ b/bigquery/samples/list_routines.py
@@ -0,0 +1,34 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def list_routines(client, dataset_id):
+
+    # [START bigquery_list_routines]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset that contains
+    #                  the routines you are listing.
+    # dataset_id = 'your-project.your_dataset'
+
+    routines = client.list_routines(dataset_id)
+
+    print("Routines contained in dataset {}:".format(dataset_id))
+    for routine in routines:
+        print(routine.reference)
+    # [END bigquery_list_routines]
diff --git a/bigquery/samples/list_tables.py b/bigquery/samples/list_tables.py
new file mode 100644
index 000000000000..2057f2d73891
--- /dev/null
+++ b/bigquery/samples/list_tables.py
@@ -0,0 +1,34 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def list_tables(client, dataset_id):
+
+    # [START bigquery_list_tables]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset that contains
+    #                  the tables you are listing.
+    # dataset_id = 'your-project.your_dataset'
+
+    tables = client.list_tables(dataset_id)
+
+    print("Tables contained in '{}':".format(dataset_id))
+    for table in tables:
+        print("{}.{}.{}".format(table.project, table.dataset_id, table.table_id))
+    # [END bigquery_list_tables]
diff --git a/bigquery/samples/load_table_dataframe.py b/bigquery/samples/load_table_dataframe.py
new file mode 100644
index 000000000000..69eeb6ef89d0
--- /dev/null
+++ b/bigquery/samples/load_table_dataframe.py
@@ -0,0 +1,73 @@
+# 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.
+
+
+def load_table_dataframe(client, table_id):
+    # [START bigquery_load_table_dataframe]
+    from google.cloud import bigquery
+    import pandas
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set table_id to the ID of the table to create.
+    # table_id = "your-project.your_dataset.your_table_name"
+
+    records = [
+        {"title": u"The Meaning of Life", "release_year": 1983},
+        {"title": u"Monty Python and the Holy Grail", "release_year": 1975},
+        {"title": u"Life of Brian", "release_year": 1979},
+        {"title": u"And Now for Something Completely Different", "release_year": 1971},
+    ]
+    dataframe = pandas.DataFrame(
+        records,
+        # In the loaded table, the column order reflects the order of the
+        # columns in the DataFrame.
+        columns=["title", "release_year"],
+        # Optionally, set a named index, which can also be written to the
+        # BigQuery table.
+        index=pandas.Index(
+            [u"Q24980", u"Q25043", u"Q24953", u"Q16403"], name="wikidata_id"
+        ),
+    )
+    job_config = bigquery.LoadJobConfig(
+        # Specify a (partial) schema. All columns are always written to the
+        # table. The schema is used to assist in data type definitions.
+        schema=[
+            # Specify the type of columns whose type cannot be auto-detected. For
+            # example the "title" column uses pandas dtype "object", so its
+            # data type is ambiguous.
+            bigquery.SchemaField("title", bigquery.enums.SqlTypeNames.STRING),
+            # Indexes are written if included in the schema by name.
+            bigquery.SchemaField("wikidata_id", bigquery.enums.SqlTypeNames.STRING),
+        ],
+        # Optionally, set the write disposition. BigQuery appends loaded rows
+        # to an existing table by default, but with WRITE_TRUNCATE write
+        # disposition it replaces the table with the loaded data.
+        write_disposition="WRITE_TRUNCATE",
+    )
+
+    job = client.load_table_from_dataframe(
+        dataframe, table_id, job_config=job_config, location="US"
+    )
+    job.result()  # Waits for table load to complete.
+
+    table = client.get_table(table_id)
+    print(
+        "Loaded {} rows and {} columns to {}".format(
+            table.num_rows, len(table.schema), table_id
+        )
+    )
+    # [END bigquery_load_table_dataframe]
+    return table
diff --git a/bigquery/samples/query_to_arrow.py b/bigquery/samples/query_to_arrow.py
new file mode 100644
index 000000000000..b13dcf3e1413
--- /dev/null
+++ b/bigquery/samples/query_to_arrow.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def query_to_arrow(client):
+
+    # [START bigquery_query_to_arrow]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    sql = """
+    WITH races AS (
+    SELECT "800M" AS race,
+        [STRUCT("Rudisha" as name, [23.4, 26.3, 26.4, 26.1] as splits),
+        STRUCT("Makhloufi" as name, [24.5, 25.4, 26.6, 26.1] as splits),
+        STRUCT("Murphy" as name, [23.9, 26.0, 27.0, 26.0] as splits),
+        STRUCT("Bosse" as name, [23.6, 26.2, 26.5, 27.1] as splits),
+        STRUCT("Rotich" as name, [24.7, 25.6, 26.9, 26.4] as splits),
+        STRUCT("Lewandowski" as name, [25.0, 25.7, 26.3, 27.2] as splits),
+        STRUCT("Kipketer" as name, [23.2, 26.1, 27.3, 29.4] as splits),
+        STRUCT("Berian" as name, [23.7, 26.1, 27.0, 29.3] as splits)]
+        AS participants)
+    SELECT
+    race,
+    participant
+    FROM races r
+    CROSS JOIN UNNEST(r.participants) as participant;
+    """
+    query_job = client.query(sql)
+    arrow_table = query_job.to_arrow()
+
+    print(
+        "Downloaded {} rows, {} columns.".format(
+            arrow_table.num_rows, arrow_table.num_columns
+        )
+    )
+    print("\nSchema:\n{}".format(repr(arrow_table.schema)))
+    # [END bigquery_query_to_arrow]
+    return arrow_table
diff --git a/bigquery/samples/tests/__init__.py b/bigquery/samples/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/samples/tests/conftest.py b/bigquery/samples/tests/conftest.py
new file mode 100644
index 000000000000..f2bb93112a22
--- /dev/null
+++ b/bigquery/samples/tests/conftest.py
@@ -0,0 +1,134 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import uuid
+
+import pytest
+
+from google.cloud import bigquery
+from google.cloud import bigquery_v2
+
+
+@pytest.fixture(scope="module")
+def client():
+    return bigquery.Client()
+
+
+@pytest.fixture
+def random_table_id(client, dataset_id):
+    now = datetime.datetime.now()
+    random_table_id = "example_table_{}_{}".format(
+        now.strftime("%Y%m%d%H%M%S"), uuid.uuid4().hex[:8]
+    )
+    return "{}.{}".format(dataset_id, random_table_id)
+
+
+@pytest.fixture
+def random_dataset_id(client):
+    now = datetime.datetime.now()
+    random_dataset_id = "example_dataset_{}_{}".format(
+        now.strftime("%Y%m%d%H%M%S"), uuid.uuid4().hex[:8]
+    )
+    yield "{}.{}".format(client.project, random_dataset_id)
+    client.delete_dataset(random_dataset_id, delete_contents=True, not_found_ok=True)
+
+
+@pytest.fixture
+def random_routine_id(client, dataset_id):
+    now = datetime.datetime.now()
+    random_routine_id = "example_routine_{}_{}".format(
+        now.strftime("%Y%m%d%H%M%S"), uuid.uuid4().hex[:8]
+    )
+    return "{}.{}".format(dataset_id, random_routine_id)
+
+
+@pytest.fixture
+def dataset_id(client):
+    now = datetime.datetime.now()
+    dataset_id = "python_samples_{}_{}".format(
+        now.strftime("%Y%m%d%H%M%S"), uuid.uuid4().hex[:8]
+    )
+    dataset = client.create_dataset(dataset_id)
+    yield "{}.{}".format(dataset.project, dataset.dataset_id)
+    client.delete_dataset(dataset, delete_contents=True, not_found_ok=True)
+
+
+@pytest.fixture
+def table_id(client, dataset_id):
+    now = datetime.datetime.now()
+    table_id = "python_samples_{}_{}".format(
+        now.strftime("%Y%m%d%H%M%S"), uuid.uuid4().hex[:8]
+    )
+
+    table = bigquery.Table("{}.{}".format(dataset_id, table_id))
+    table = client.create_table(table)
+    yield "{}.{}.{}".format(table.project, table.dataset_id, table.table_id)
+    client.delete_table(table, not_found_ok=True)
+
+
+@pytest.fixture
+def table_with_data_id(client):
+    return "bigquery-public-data.samples.shakespeare"
+
+
+@pytest.fixture
+def routine_id(client, dataset_id):
+    now = datetime.datetime.now()
+    routine_id = "python_samples_{}_{}".format(
+        now.strftime("%Y%m%d%H%M%S"), uuid.uuid4().hex[:8]
+    )
+
+    routine = bigquery.Routine("{}.{}".format(dataset_id, routine_id))
+    routine.type_ = "SCALAR_FUNCTION"
+    routine.language = "SQL"
+    routine.body = "x * 3"
+    routine.arguments = [
+        bigquery.RoutineArgument(
+            name="x",
+            data_type=bigquery_v2.types.StandardSqlDataType(
+                type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+            ),
+        )
+    ]
+
+    routine = client.create_routine(routine)
+    yield "{}.{}.{}".format(routine.project, routine.dataset_id, routine.routine_id)
+    client.delete_routine(routine, not_found_ok=True)
+
+
+@pytest.fixture
+def model_id(client, dataset_id):
+    model_id = "{}.{}".format(dataset_id, uuid.uuid4().hex)
+
+    # The only way to create a model resource is via SQL.
+    # Use a very small dataset (2 points), to train a model quickly.
+    sql = """
+    CREATE MODEL `{}`
+    OPTIONS (
+        model_type='linear_reg',
+        max_iteration=1,
+        learn_rate=0.4,
+        learn_rate_strategy='constant'
+    ) AS (
+        SELECT 'a' AS f1, 2.0 AS label
+        UNION ALL
+        SELECT 'b' AS f1, 3.8 AS label
+    )
+    """.format(
+        model_id
+    )
+
+    client.query(sql).result()
+    return model_id
diff --git a/bigquery/samples/tests/test_add_empty_column.py b/bigquery/samples/tests/test_add_empty_column.py
new file mode 100644
index 000000000000..e6c56e6cbfbc
--- /dev/null
+++ b/bigquery/samples/tests/test_add_empty_column.py
@@ -0,0 +1,23 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from .. import add_empty_column
+
+
+def test_add_empty_column(capsys, client, table_id):
+
+    add_empty_column.add_empty_column(client, table_id)
+    out, err = capsys.readouterr()
+    assert "A new column has been added." in out
diff --git a/bigquery/samples/tests/test_browse_table_data.py b/bigquery/samples/tests/test_browse_table_data.py
new file mode 100644
index 000000000000..f777bf91ca00
--- /dev/null
+++ b/bigquery/samples/tests/test_browse_table_data.py
@@ -0,0 +1,26 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from .. import browse_table_data
+
+
+def test_browse_table_data(capsys, client, table_with_data_id):
+
+    browse_table_data.browse_table_data(client, table_with_data_id)
+    out, err = capsys.readouterr()
+    assert "Downloaded 164656 rows from table {}".format(table_with_data_id) in out
+    assert "Downloaded 10 rows from table {}".format(table_with_data_id) in out
+    assert "Selected 2 columns from table {}".format(table_with_data_id) in out
+    assert "Downloaded 10 rows from table {}".format(table_with_data_id) in out
diff --git a/bigquery/samples/tests/test_create_dataset.py b/bigquery/samples/tests/test_create_dataset.py
new file mode 100644
index 000000000000..dfadc67d8468
--- /dev/null
+++ b/bigquery/samples/tests/test_create_dataset.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import create_dataset
+
+
+def test_create_dataset(capsys, client, random_dataset_id):
+
+    create_dataset.create_dataset(client, random_dataset_id)
+    out, err = capsys.readouterr()
+    assert "Created dataset {}".format(random_dataset_id) in out
diff --git a/bigquery/samples/tests/test_create_job.py b/bigquery/samples/tests/test_create_job.py
new file mode 100644
index 000000000000..fce005ae8236
--- /dev/null
+++ b/bigquery/samples/tests/test_create_job.py
@@ -0,0 +1,23 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import create_job
+
+
+def test_create_job(capsys, client):
+
+    query_job = create_job.create_job(client)
+    client.cancel_job(query_job.job_id, location="US")
+    out, err = capsys.readouterr()
+    assert "Started job: {}".format(query_job.job_id) in out
diff --git a/bigquery/samples/tests/test_create_table.py b/bigquery/samples/tests/test_create_table.py
new file mode 100644
index 000000000000..093ee6e94277
--- /dev/null
+++ b/bigquery/samples/tests/test_create_table.py
@@ -0,0 +1,21 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import create_table
+
+
+def test_create_table(capsys, client, random_table_id):
+    create_table.create_table(client, random_table_id)
+    out, err = capsys.readouterr()
+    assert "Created table {}".format(random_table_id) in out
diff --git a/bigquery/samples/tests/test_dataset_exists.py b/bigquery/samples/tests/test_dataset_exists.py
new file mode 100644
index 000000000000..203c4b884dc4
--- /dev/null
+++ b/bigquery/samples/tests/test_dataset_exists.py
@@ -0,0 +1,30 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from google.cloud import bigquery
+
+from .. import dataset_exists
+
+
+def test_dataset_exists(capsys, client, random_dataset_id):
+
+    dataset_exists.dataset_exists(client, random_dataset_id)
+    out, err = capsys.readouterr()
+    assert "Dataset {} is not found".format(random_dataset_id) in out
+    dataset = bigquery.Dataset(random_dataset_id)
+    dataset = client.create_dataset(dataset)
+    dataset_exists.dataset_exists(client, random_dataset_id)
+    out, err = capsys.readouterr()
+    assert "Dataset {} already exists".format(random_dataset_id) in out
diff --git a/bigquery/samples/tests/test_dataset_label_samples.py b/bigquery/samples/tests/test_dataset_label_samples.py
new file mode 100644
index 000000000000..94a2092407b0
--- /dev/null
+++ b/bigquery/samples/tests/test_dataset_label_samples.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import delete_dataset_labels
+from .. import get_dataset_labels
+from .. import label_dataset
+
+
+def test_dataset_label_samples(capsys, client, dataset_id):
+
+    label_dataset.label_dataset(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Labels added to {}".format(dataset_id) in out
+
+    get_dataset_labels.get_dataset_labels(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "color: green" in out
+
+    dataset = delete_dataset_labels.delete_dataset_labels(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Labels deleted from {}".format(dataset_id) in out
+    assert dataset.labels.get("color") is None
diff --git a/bigquery/samples/tests/test_delete_dataset.py b/bigquery/samples/tests/test_delete_dataset.py
new file mode 100644
index 000000000000..2b1b6ad06195
--- /dev/null
+++ b/bigquery/samples/tests/test_delete_dataset.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import delete_dataset
+
+
+def test_delete_dataset(capsys, client, dataset_id):
+
+    delete_dataset.delete_dataset(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Deleted dataset '{}'.".format(dataset_id) in out
diff --git a/bigquery/samples/tests/test_delete_table.py b/bigquery/samples/tests/test_delete_table.py
new file mode 100644
index 000000000000..8f4796623a83
--- /dev/null
+++ b/bigquery/samples/tests/test_delete_table.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import delete_table
+
+
+def test_delete_table(capsys, client, table_id):
+
+    delete_table.delete_table(client, table_id)
+    out, err = capsys.readouterr()
+    assert "Deleted table '{}'.".format(table_id) in out
diff --git a/bigquery/samples/tests/test_get_dataset.py b/bigquery/samples/tests/test_get_dataset.py
new file mode 100644
index 000000000000..374f8835211a
--- /dev/null
+++ b/bigquery/samples/tests/test_get_dataset.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import get_dataset
+
+
+def test_get_dataset(capsys, client, dataset_id):
+
+    get_dataset.get_dataset(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "{}".format(dataset_id) in out
diff --git a/bigquery/samples/tests/test_get_table.py b/bigquery/samples/tests/test_get_table.py
new file mode 100644
index 000000000000..b811ccecad1f
--- /dev/null
+++ b/bigquery/samples/tests/test_get_table.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.cloud import bigquery
+from .. import get_table
+
+
+def test_get_table(capsys, client, random_table_id):
+
+    schema = [
+        bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+        bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+    ]
+
+    table = bigquery.Table(random_table_id, schema)
+    table.description = "Sample Table"
+    table = client.create_table(table)
+
+    get_table.get_table(client, random_table_id)
+    out, err = capsys.readouterr()
+    assert "Got table '{}'.".format(random_table_id) in out
+    assert "full_name" in out  # test that schema is printed
+    assert "Table description: Sample Table" in out
+    assert "Table has 0 rows" in out
+    client.delete_table(table, not_found_ok=True)
diff --git a/bigquery/samples/tests/test_list_datasets.py b/bigquery/samples/tests/test_list_datasets.py
new file mode 100644
index 000000000000..4c66a24f9b1a
--- /dev/null
+++ b/bigquery/samples/tests/test_list_datasets.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import list_datasets
+
+
+def test_list_datasets(capsys, client, dataset_id):
+
+    list_datasets.list_datasets(client)
+    out, err = capsys.readouterr()
+    assert "Datasets in project {}:".format(client.project) in out
diff --git a/bigquery/samples/tests/test_list_datasets_by_label.py b/bigquery/samples/tests/test_list_datasets_by_label.py
new file mode 100644
index 000000000000..346cbf1a982d
--- /dev/null
+++ b/bigquery/samples/tests/test_list_datasets_by_label.py
@@ -0,0 +1,26 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from .. import list_datasets_by_label
+
+
+def test_list_datasets_by_label(capsys, client, dataset_id):
+
+    dataset = client.get_dataset(dataset_id)
+    dataset.labels = {"color": "green"}
+    dataset = client.update_dataset(dataset, ["labels"])
+    list_datasets_by_label.list_datasets_by_label(client)
+    out, err = capsys.readouterr()
+    assert "{}".format(dataset_id) in out
diff --git a/bigquery/samples/tests/test_list_tables.py b/bigquery/samples/tests/test_list_tables.py
new file mode 100644
index 000000000000..ec1621ac7579
--- /dev/null
+++ b/bigquery/samples/tests/test_list_tables.py
@@ -0,0 +1,23 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import list_tables
+
+
+def test_list_tables(capsys, client, dataset_id, table_id):
+
+    list_tables.list_tables(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Tables contained in '{}':".format(dataset_id) in out
+    assert table_id in out
diff --git a/bigquery/samples/tests/test_load_table_dataframe.py b/bigquery/samples/tests/test_load_table_dataframe.py
new file mode 100644
index 000000000000..d553d449a525
--- /dev/null
+++ b/bigquery/samples/tests/test_load_table_dataframe.py
@@ -0,0 +1,30 @@
+# 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.
+
+import pytest
+
+from .. import load_table_dataframe
+
+
+pytest.importorskip("pandas")
+pytest.importorskip("pyarrow")
+
+
+def test_load_table_dataframe(capsys, client, random_table_id):
+    table = load_table_dataframe.load_table_dataframe(client, random_table_id)
+    out, _ = capsys.readouterr()
+    assert "Loaded 4 rows and 3 columns" in out
+
+    column_names = [field.name for field in table.schema]
+    assert column_names == ["wikidata_id", "title", "release_year"]
diff --git a/bigquery/samples/tests/test_model_samples.py b/bigquery/samples/tests/test_model_samples.py
new file mode 100644
index 000000000000..d7b06a92a3e1
--- /dev/null
+++ b/bigquery/samples/tests/test_model_samples.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import delete_model
+from .. import get_model
+from .. import list_models
+from .. import update_model
+
+
+def test_model_samples(capsys, client, dataset_id, model_id):
+    """Since creating a model is a long operation, test all model samples in
+    the same test, following a typical end-to-end flow.
+    """
+    get_model.get_model(client, model_id)
+    out, err = capsys.readouterr()
+    assert model_id in out
+
+    list_models.list_models(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Models contained in '{}':".format(dataset_id) in out
+
+    update_model.update_model(client, model_id)
+    out, err = capsys.readouterr()
+    assert "This model was modified from a Python program." in out
+
+    delete_model.delete_model(client, model_id)
+    out, err = capsys.readouterr()
+    assert "Deleted model '{}'.".format(model_id) in out
diff --git a/bigquery/samples/tests/test_query_to_arrow.py b/bigquery/samples/tests/test_query_to_arrow.py
new file mode 100644
index 000000000000..f70bd49fe565
--- /dev/null
+++ b/bigquery/samples/tests/test_query_to_arrow.py
@@ -0,0 +1,29 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pyarrow
+
+from .. import query_to_arrow
+
+
+def test_query_to_arrow(capsys, client):
+
+    arrow_table = query_to_arrow.query_to_arrow(client)
+    out, err = capsys.readouterr()
+    assert "Downloaded 8 rows, 2 columns." in out
+
+    arrow_schema = arrow_table.schema
+    assert arrow_schema.names == ["race", "participant"]
+    assert pyarrow.types.is_string(arrow_schema.types[0])
+    assert pyarrow.types.is_struct(arrow_schema.types[1])
diff --git a/bigquery/samples/tests/test_routine_samples.py b/bigquery/samples/tests/test_routine_samples.py
new file mode 100644
index 000000000000..5a1c69c7f60f
--- /dev/null
+++ b/bigquery/samples/tests/test_routine_samples.py
@@ -0,0 +1,89 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.cloud import bigquery
+from google.cloud import bigquery_v2
+
+
+def test_create_routine(capsys, client, random_routine_id):
+    from .. import create_routine
+
+    create_routine.create_routine(client, random_routine_id)
+    out, err = capsys.readouterr()
+    assert "Created routine {}".format(random_routine_id) in out
+
+
+def test_create_routine_ddl(capsys, client, random_routine_id):
+    from .. import create_routine_ddl
+
+    create_routine_ddl.create_routine_ddl(client, random_routine_id)
+    routine = client.get_routine(random_routine_id)
+    out, err = capsys.readouterr()
+
+    assert "Created routine {}".format(random_routine_id) in out
+    return routine
+    assert routine.type_ == "SCALAR_FUNCTION"
+    assert routine.language == "SQL"
+    expected_arguments = [
+        bigquery.RoutineArgument(
+            name="arr",
+            data_type=bigquery_v2.types.StandardSqlDataType(
+                type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.ARRAY,
+                array_element_type=bigquery_v2.types.StandardSqlDataType(
+                    type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.STRUCT,
+                    struct_type=bigquery_v2.types.StandardSqlStructType(
+                        fields=[
+                            bigquery_v2.types.StandardSqlField(
+                                name="name",
+                                type=bigquery_v2.types.StandardSqlDataType(
+                                    type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.STRING
+                                ),
+                            ),
+                            bigquery_v2.types.StandardSqlField(
+                                name="val",
+                                type=bigquery_v2.types.StandardSqlDataType(
+                                    type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+                                ),
+                            ),
+                        ]
+                    ),
+                ),
+            ),
+        )
+    ]
+    assert routine.arguments == expected_arguments
+
+
+def test_list_routines(capsys, client, dataset_id, routine_id):
+    from .. import list_routines
+
+    list_routines.list_routines(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Routines contained in dataset {}:".format(dataset_id) in out
+    assert routine_id in out
+
+
+def test_delete_routine(capsys, client, routine_id):
+    from .. import delete_routine
+
+    delete_routine.delete_routine(client, routine_id)
+    out, err = capsys.readouterr()
+    assert "Deleted routine {}.".format(routine_id) in out
+
+
+def test_update_routine(client, routine_id):
+    from .. import update_routine
+
+    routine = update_routine.update_routine(client, routine_id)
+    assert routine.body == "x * 4"
diff --git a/bigquery/samples/tests/test_update_dataset_access.py b/bigquery/samples/tests/test_update_dataset_access.py
new file mode 100644
index 000000000000..ae33dbfe4a4c
--- /dev/null
+++ b/bigquery/samples/tests/test_update_dataset_access.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import update_dataset_access
+
+
+def test_update_dataset_access(capsys, client, dataset_id):
+
+    update_dataset_access.update_dataset_access(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert (
+        "Updated dataset '{}' with modified user permissions.".format(dataset_id) in out
+    )
diff --git a/bigquery/samples/tests/test_update_dataset_default_table_expiration.py b/bigquery/samples/tests/test_update_dataset_default_table_expiration.py
new file mode 100644
index 000000000000..46e9654209ed
--- /dev/null
+++ b/bigquery/samples/tests/test_update_dataset_default_table_expiration.py
@@ -0,0 +1,29 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import update_dataset_default_table_expiration
+
+
+def test_update_dataset_default_table_expiration(capsys, client, dataset_id):
+
+    one_day_ms = 24 * 60 * 60 * 1000  # in milliseconds
+
+    update_dataset_default_table_expiration.update_dataset_default_table_expiration(
+        client, dataset_id
+    )
+    out, err = capsys.readouterr()
+    assert (
+        "Updated dataset {} with new expiration {}".format(dataset_id, one_day_ms)
+        in out
+    )
diff --git a/bigquery/samples/tests/test_update_dataset_description.py b/bigquery/samples/tests/test_update_dataset_description.py
new file mode 100644
index 000000000000..c6f8889f50da
--- /dev/null
+++ b/bigquery/samples/tests/test_update_dataset_description.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .. import update_dataset_description
+
+
+def test_update_dataset_description(capsys, client, dataset_id):
+
+    update_dataset_description.update_dataset_description(client, dataset_id)
+    out, err = capsys.readouterr()
+    assert "Updated description." in out
diff --git a/bigquery/samples/update_dataset_access.py b/bigquery/samples/update_dataset_access.py
new file mode 100644
index 000000000000..aa316a38dff9
--- /dev/null
+++ b/bigquery/samples/update_dataset_access.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def update_dataset_access(client, dataset_id):
+
+    # [START bigquery_update_dataset_access]
+    from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = 'your-project.your_dataset'
+
+    dataset = client.get_dataset(dataset_id)
+
+    entry = bigquery.AccessEntry(
+        role="READER",
+        entity_type="userByEmail",
+        entity_id="sample.bigquery.dev@gmail.com",
+    )
+
+    entries = list(dataset.access_entries)
+    entries.append(entry)
+    dataset.access_entries = entries
+
+    dataset = client.update_dataset(dataset, ["access_entries"])  # API request
+
+    full_dataset_id = "{}.{}".format(dataset.project, dataset.dataset_id)
+    print(
+        "Updated dataset '{}' with modified user permissions.".format(full_dataset_id)
+    )
+    # [END bigquery_update_dataset_access]
diff --git a/bigquery/samples/update_dataset_default_table_expiration.py b/bigquery/samples/update_dataset_default_table_expiration.py
new file mode 100644
index 000000000000..4534bb2011eb
--- /dev/null
+++ b/bigquery/samples/update_dataset_default_table_expiration.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def update_dataset_default_table_expiration(client, dataset_id):
+
+    # [START bigquery_update_dataset_expiration]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = 'your-project.your_dataset'
+
+    dataset = client.get_dataset(dataset_id)
+    dataset.default_table_expiration_ms = 24 * 60 * 60 * 1000  # in milliseconds
+
+    dataset = client.update_dataset(
+        dataset, ["default_table_expiration_ms"]
+    )  # API request
+
+    full_dataset_id = "{}.{}".format(dataset.project, dataset.dataset_id)
+    print(
+        "Updated dataset {} with new expiration {}".format(
+            full_dataset_id, dataset.default_table_expiration_ms
+        )
+    )
+    # [END bigquery_update_dataset_expiration]
diff --git a/bigquery/samples/update_dataset_description.py b/bigquery/samples/update_dataset_description.py
new file mode 100644
index 000000000000..f3afb7fa68ce
--- /dev/null
+++ b/bigquery/samples/update_dataset_description.py
@@ -0,0 +1,38 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def update_dataset_description(client, dataset_id):
+
+    # [START bigquery_update_dataset_description]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set dataset_id to the ID of the dataset to fetch.
+    # dataset_id = 'your-project.your_dataset'
+
+    dataset = client.get_dataset(dataset_id)
+    dataset.description = "Updated description."
+    dataset = client.update_dataset(dataset, ["description"])
+
+    full_dataset_id = "{}.{}".format(dataset.project, dataset.dataset_id)
+    print(
+        "Updated dataset '{}' with description '{}'.".format(
+            full_dataset_id, dataset.description
+        )
+    )
+    # [END bigquery_update_dataset_description]
diff --git a/bigquery/samples/update_model.py b/bigquery/samples/update_model.py
new file mode 100644
index 000000000000..5df4ada886ed
--- /dev/null
+++ b/bigquery/samples/update_model.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def update_model(client, model_id):
+    """Sample ID: go/samples-tracker/1533"""
+
+    # [START bigquery_update_model_description]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set model_id to the ID of the model to fetch.
+    # model_id = 'your-project.your_dataset.your_model'
+
+    model = client.get_model(model_id)
+    model.description = "This model was modified from a Python program."
+    model = client.update_model(model, ["description"])
+
+    full_model_id = "{}.{}.{}".format(model.project, model.dataset_id, model.model_id)
+    print(
+        "Updated model '{}' with description '{}'.".format(
+            full_model_id, model.description
+        )
+    )
+    # [END bigquery_update_model_description]
diff --git a/bigquery/samples/update_routine.py b/bigquery/samples/update_routine.py
new file mode 100644
index 000000000000..4d491d42e168
--- /dev/null
+++ b/bigquery/samples/update_routine.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def update_routine(client, routine_id):
+
+    # [START bigquery_update_routine]
+    # TODO(developer): Import the client library.
+    # from google.cloud import bigquery
+
+    # TODO(developer): Construct a BigQuery client object.
+    # client = bigquery.Client()
+
+    # TODO(developer): Set the fully-qualified ID for the routine.
+    # routine_id = "my-project.my_dataset.my_routine"
+
+    routine = client.get_routine(routine_id)
+
+    routine.body = "x * 4"
+
+    routine = client.update_routine(
+        routine,
+        [
+            "body",
+            # Due to a limitation of the API, all fields are required, not just
+            # those that have been updated.
+            "arguments",
+            "language",
+            "type_",
+            "return_type",
+        ],
+    )
+    # [END bigquery_update_routine]
+    return routine
diff --git a/bigquery/setup.cfg b/bigquery/setup.cfg
new file mode 100644
index 000000000000..2a9acf13daa9
--- /dev/null
+++ b/bigquery/setup.cfg
@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1
diff --git a/bigquery/setup.py b/bigquery/setup.py
new file mode 100644
index 000000000000..b3eeb15b5d64
--- /dev/null
+++ b/bigquery/setup.py
@@ -0,0 +1,118 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-bigquery"
+description = "Google BigQuery API client library"
+version = "1.18.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    'enum34; python_version < "3.4"',
+    "google-cloud-core >= 1.0.3, < 2.0dev",
+    "google-resumable-media >= 0.3.1",
+    "protobuf >= 3.6.0",
+]
+extras = {
+    "bqstorage": [
+        "google-cloud-bigquery-storage >= 0.6.0, <2.0.0dev",
+        # Bad Linux release for 0.14.0.
+        # https://issues.apache.org/jira/browse/ARROW-5868
+        "pyarrow>=0.13.0, != 0.14.0",
+    ],
+    "pandas": ["pandas>=0.17.1"],
+    # Exclude PyArrow dependency from Windows Python 2.7.
+    'pyarrow: platform_system != "Windows" or python_version >= "3.4"': [
+        # Bad Linux release for 0.14.0.
+        # https://issues.apache.org/jira/browse/ARROW-5868
+        "pyarrow>=0.4.1, != 0.14.0"
+    ],
+    "tqdm": ["tqdm >= 4.0.0, <5.0.0dev"],
+    "fastparquet": ["fastparquet", "python-snappy"],
+}
+
+all_extras = []
+
+for extra in extras:
+    if extra == "fastparquet":
+        # Skip fastparquet from "all" because it is redundant with pyarrow and
+        # creates a dependency on pre-release versions of numpy. See:
+        # https://github.com/googleapis/google-cloud-python/issues/8549
+        continue
+    all_extras.extend(extras[extra])
+
+extras["all"] = all_extras
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/bigquery/synth.metadata b/bigquery/synth.metadata
new file mode 100644
index 000000000000..b5cce0083f8e
--- /dev/null
+++ b/bigquery/synth.metadata
@@ -0,0 +1,32 @@
+{
+  "updateTime": "2019-08-06T12:13:25.893023Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "bigquery",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/bigquery/artman_bigquery_v2.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/bigquery/synth.py b/bigquery/synth.py
new file mode 100644
index 000000000000..a8370fd4e96a
--- /dev/null
+++ b/bigquery/synth.py
@@ -0,0 +1,54 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+
+version = 'v2'
+
+library = gapic.py_library(
+    'bigquery',
+    version,
+    config_path='/google/cloud/bigquery/'
+                'artman_bigquery_v2.yaml',
+    artman_output_name='bigquery-v2',
+    include_protos=True,
+)
+
+s.move(
+    [
+        library / "google/cloud/bigquery_v2/gapic/enums.py",
+        library / "google/cloud/bigquery_v2/types.py",
+        library / "google/cloud/bigquery_v2/proto/location*",
+        library / "google/cloud/bigquery_v2/proto/model*",
+        library / "google/cloud/bigquery_v2/proto/standard_sql*",
+    ],
+)
+
+# Fix up proto docs that are missing summary line.
+s.replace(
+    "google/cloud/bigquery_v2/proto/model_pb2.py",
+    '"""Attributes:',
+    '"""Protocol buffer.\n\n  Attributes:',
+)
+
+# Remove non-ascii characters from docstrings for Python 2.7.
+# Format quoted strings as plain text.
+s.replace("google/cloud/bigquery_v2/proto/*.py", "[“”]", '``')
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/bigquery/tests/__init__.py b/bigquery/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/tests/data/characters.json b/bigquery/tests/data/characters.json
new file mode 100644
index 000000000000..d38636810196
--- /dev/null
+++ b/bigquery/tests/data/characters.json
@@ -0,0 +1,68 @@
+[
+   {
+      "Age" : "111",
+      "Spells" : [],
+      "Name" : "Bilbo",
+      "Weight" : 67.2,
+      "TeaTime" : "10:00:00",
+      "NextVacation" : "2017-09-22",
+      "FavoriteTime" : "2031-04-01T05:09:27",
+      "IsMagic" : false
+   },
+   {
+      "Age" : "1000",
+      "Name" : "Gandalf",
+      "Spells" : [
+         {
+            "Name" : "Skydragon",
+            "Properties" : [
+               {
+                  "Power" : 1,
+                  "Name" : "Flying"
+               },
+               {
+                  "Name" : "Creature",
+                  "Power" : 1
+               },
+               {
+                  "Power" : 11,
+                  "Name" : "Explodey"
+               }
+            ],
+            "LastUsed" : "2015-10-31 23:59:56 UTC",
+            "Icon" : "iVBORw0KGgoAAAANSUhEUgAAAB4AAAAgCAYAAAAFQMh/AAAAAXNSR0IArs4c6QAAA9lJREFUSA21lk9OVEEQxvsRDImoiMG9mLjjCG5mEg7gEfQGsIcF7p0EDsBBSJiNO7ZsFRZqosb/QkSj7fer7ur33sw8GDFUUq+7q6vqq6qu7pkQzqG4EeI521e7FePVgM9cGPYwhCi6UO8qFOK+YY+Br66ujsmmxb84Yzwp6zCsxjJfWVkxnMsEMGuWHZ9Wcz11cM48hkq0vLwc1tbW4mAwqDpcdIqnMmgF0JMv2CiGnZ2dcHR0FA4PD8Pe3t5U/tx6bCSlb+JT8XfxT3HsUek0Li0tRdjWl+z6iRF+FNA1hXPDQ/IMNyRg3s8bD/OaZS+VP+9cOLSa64cA34oXZWagDkRzAaJxXaE+ufc4rCN7LrazZ2+8+STtpAL8WYDvpTaHKlkB2iQARMvb2+H27m4YaL7zaDtUw1BZAASi6T8T2UZnPZV2pvnJfCH5p8bewcGB6TrIfz8wBZgHQ83kjpuj6RBYQpuo09Tvmpd7TPe+ktZN8cKwS92KWXGuaqWowlYEwthtMcWOZUNJc8at+zuF/Xkqo69baS7P+AvWjYwJ4jyHXXsEnd74ZO/Pq+uXUuv6WNlso6cvnDsZB1V/unJab3D1/KrJDw9NCM9wHf2FK2ejTKMejnBHfGtfH7LGGCdQDqaqJgfgzWjXK1nYV4jRbPGnxUT7cqUaZfJrVZeOm9QmB21L6xXgbu/ScsYusJFMoU0x2fsamRJOd6kOYDRLUxv94ENZe8+0gM+0dyz+KgU7X8rLHHCIOZyrna4y6ykIu0YCs02TBXmk3PZssmEgaTxTo83xjCIjoE21h0Yah3MrV4+9kR8MaabGze+9NEILGAFE5nMOiiA32KnAr/sb7tED3nzlzC4dB38WMC+EjaqHfqvUKHi2gJPdWQ6AbH8hgyQ7QY6jvjj3QZWvX6pUAtduTX5Dss96Q7NI9RQRJeeKvRFbt0v2gb1Gx/PooJsztn1c1DqpAU3Hde2dB2aEHBhjgOFjMeDvxLafjQ3YZQSgOcHJZX611H45sGLHWvYTz9hiURlpNoBZvxb/Ft9lAQ1DmBfUiR+j1hAPkMBTE9L9+zLva1QvGFHurRBaZ5xLVitoBviiRkD/sIMDztKA5FA0b9/0OclzO2/XAQymJ0TcghZwEo9/AX8gMeAJMOvIsWWt5bwCoiFhVSllrdH0t5Q1JHAFlKJNkvTVdn2GHb9KdmacMT+d/Os05imJUccRX2YuZ93Sxf0Ilc4DPDeAq5SAvFEAY94cQc6BA26dzb4HWAJI4DPmQE5KCVUyvb2FcDZem7JdT2ggKUP3xX6n9XNq1DpzSf4Cy4ZqSlmM8d8AAAAASUVORK5CYII=",
+            "DiscoveredBy" : "Firebreather"
+         }
+      ],
+      "NextVacation" : "2666-06-06",
+      "TeaTime" : "15:00:00",
+      "Weight" : 198.6,
+      "FavoriteTime" : "2001-12-19T23:59:59",
+      "FavoriteNumber" : "3.141592654",
+      "IsMagic" : true
+   },
+   {
+      "Weight" : 128.3,
+      "TeaTime" : "12:00:00",
+      "NextVacation" : "2017-03-14",
+      "IsMagic" : true,
+      "FavoriteTime" : "2000-10-31T23:27:46",
+      "Age" : "17",
+      "FavoriteNumber" : "13",
+      "Spells" : [
+         {
+            "LastUsed" : "2017-02-14 12:07:23 UTC",
+            "Properties" : [
+               {
+                  "Name" : "Makes you look crazy",
+                  "Power" : 1
+               }
+            ],
+            "Icon" : "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAAAXNSR0IArs4c6QAAABxpRE9UAAAAAgAAAAAAAAAgAAAAKAAAACAAAAAgAAABxj2CfowAAAGSSURBVHgB7Jc9TsNAEIX3JDkCPUV6KlpKFHEGlD4nyA04ACUXQKTgCEipUnKGNEbP0otentayicZ24SlWs7tjO/N9u/5J2b2+NUtuZcnwYE8BuQPyGZAPwXwLLPk5kG+BJa9+fgfkh1B+CeancL4F8i2Q/wWm/S/w+XFoTseftn0dvhu0OXfhpM+AGvzcEiYVAFisPqE9zrETJhHAlXfg2lglMK9z0f3RBfB+ZyRUV3x+erzsEIjjOBqc1xtNAIrvguybV3A9lkVHxlEE6GrrPb/ZvAySwlUnfCmlPQ+R8JCExvGtcRQBLFwj4FGkznX1VYDKPG/f2/MjwCksXACgdNUxJjwK9xwl4JihOwTFR0kIF+CABEPRnvsvPFctMoYKqAFSAFaMwB4pp3Y+bodIYL9WmIAaIOHxo7W8wiHvAjTvhUeNwwSgeAeAABbqOewC5hBdwFD4+9+7puzXV9fS6/b1wwT4tsaYAhwOOQdUQch5vgZCeAhAv3ZM31yYAAUgvApQQQ6n5w6FB/RVe1jdJOAPAAD//1eMQwoAAAGQSURBVO1UMU4DQQy8X9AgWopIUINEkS4VlJQo4gvwAV7AD3gEH4iSgidESpWSXyyZExP5lr0c7K5PsXBhec/2+jzjuWtent9CLdtu1mG5+gjz+WNr7IsY7eH+tvO+xfuqk4vz7CH91edFaF5v9nb6dBKm13edvrL+0Lk5lMzJkQDeJSkkgHF6mR8CHwMHCQR/NAQQGD0BAlwK4FCefQiefq+A2Vn29tG7igLAfmwcnJu/nJy3BMQkMN9HEPr8AL3bfBv7Bp+7/SoExMDjZwKEJwmyhnnmQIQEBIlz2x0iKoAvJkAC6TsTIH6MqRrEWUMSZF2zAwqT4Eu/e6pzFAIkmNSZ4OFT+VYBIIF//UqbJwnF/4DU0GwOn8r/JQYCpPGufEfJuZiA37ycQw/5uFeqPq4pfR6FADmkBCXjfWdZj3NfXW58dAJyB9W65wRoMWulryvAyqa05nQFaDFrpa8rwMqmtOZ0BWgxa6WvK8DKprTmdAVoMWulryvAyqa05nQFaDFrpa8rwMqmtOb89wr4AtQ4aPoL6yVpAAAAAElFTkSuQmCC",
+            "Name" : "Talking cats",
+            "DiscoveredBy" : "Salem"
+         }
+      ],
+      "Name" : "Sabrina"
+   }
+]
diff --git a/bigquery/tests/data/characters.jsonl b/bigquery/tests/data/characters.jsonl
new file mode 100644
index 000000000000..42b5bdc6a152
--- /dev/null
+++ b/bigquery/tests/data/characters.jsonl
@@ -0,0 +1,3 @@
+{"Name":"Bilbo","Age":"111","Weight":67.2,"IsMagic":false,"Spells":[],"TeaTime":"10:00:00","NextVacation":"2017-09-22","FavoriteTime":"2031-04-01T05:09:27","FavoriteNumber":"111"}
+{"Name":"Gandalf","Age":"1000","Weight":198.6,"IsMagic":true,"Spells":[{"Name": "Skydragon", "Icon":"iVBORw0KGgoAAAANSUhEUgAAAB4AAAAgCAYAAAAFQMh/AAAAAXNSR0IArs4c6QAAA9lJREFUSA21lk9OVEEQxvsRDImoiMG9mLjjCG5mEg7gEfQGsIcF7p0EDsBBSJiNO7ZsFRZqosb/QkSj7fer7ur33sw8GDFUUq+7q6vqq6qu7pkQzqG4EeI521e7FePVgM9cGPYwhCi6UO8qFOK+YY+Br66ujsmmxb84Yzwp6zCsxjJfWVkxnMsEMGuWHZ9Wcz11cM48hkq0vLwc1tbW4mAwqDpcdIqnMmgF0JMv2CiGnZ2dcHR0FA4PD8Pe3t5U/tx6bCSlb+JT8XfxT3HsUek0Li0tRdjWl+z6iRF+FNA1hXPDQ/IMNyRg3s8bD/OaZS+VP+9cOLSa64cA34oXZWagDkRzAaJxXaE+ufc4rCN7LrazZ2+8+STtpAL8WYDvpTaHKlkB2iQARMvb2+H27m4YaL7zaDtUw1BZAASi6T8T2UZnPZV2pvnJfCH5p8bewcGB6TrIfz8wBZgHQ83kjpuj6RBYQpuo09Tvmpd7TPe+ktZN8cKwS92KWXGuaqWowlYEwthtMcWOZUNJc8at+zuF/Xkqo69baS7P+AvWjYwJ4jyHXXsEnd74ZO/Pq+uXUuv6WNlso6cvnDsZB1V/unJab3D1/KrJDw9NCM9wHf2FK2ejTKMejnBHfGtfH7LGGCdQDqaqJgfgzWjXK1nYV4jRbPGnxUT7cqUaZfJrVZeOm9QmB21L6xXgbu/ScsYusJFMoU0x2fsamRJOd6kOYDRLUxv94ENZe8+0gM+0dyz+KgU7X8rLHHCIOZyrna4y6ykIu0YCs02TBXmk3PZssmEgaTxTo83xjCIjoE21h0Yah3MrV4+9kR8MaabGze+9NEILGAFE5nMOiiA32KnAr/sb7tED3nzlzC4dB38WMC+EjaqHfqvUKHi2gJPdWQ6AbH8hgyQ7QY6jvjj3QZWvX6pUAtduTX5Dss96Q7NI9RQRJeeKvRFbt0v2gb1Gx/PooJsztn1c1DqpAU3Hde2dB2aEHBhjgOFjMeDvxLafjQ3YZQSgOcHJZX611H45sGLHWvYTz9hiURlpNoBZvxb/Ft9lAQ1DmBfUiR+j1hAPkMBTE9L9+zLva1QvGFHurRBaZ5xLVitoBviiRkD/sIMDztKA5FA0b9/0OclzO2/XAQymJ0TcghZwEo9/AX8gMeAJMOvIsWWt5bwCoiFhVSllrdH0t5Q1JHAFlKJNkvTVdn2GHb9KdmacMT+d/Os05imJUccRX2YuZ93Sxf0Ilc4DPDeAq5SAvFEAY94cQc6BA26dzb4HWAJI4DPmQE5KCVUyvb2FcDZem7JdT2ggKUP3xX6n9XNq1DpzSf4Cy4ZqSlmM8d8AAAAASUVORK5CYII=","DiscoveredBy":"Firebreather","Properties":[{"Name":"Flying","Power":1},{"Name":"Creature","Power":1},{"Name":"Explodey","Power":11}],"LastUsed":"2015-10-31 23:59:56 UTC"}],"TeaTime":"15:00:00","NextVacation":"2666-06-06","FavoriteTime":"2001-12-19T23:59:59","FavoriteNumber":"1.618033989"}
+{"Name":"Sabrina","Age":"17","Weight":128.3,"IsMagic":true,"Spells":[{"Name": "Talking cats", "Icon":"iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAAAXNSR0IArs4c6QAAABxpRE9UAAAAAgAAAAAAAAAgAAAAKAAAACAAAAAgAAABxj2CfowAAAGSSURBVHgB7Jc9TsNAEIX3JDkCPUV6KlpKFHEGlD4nyA04ACUXQKTgCEipUnKGNEbP0otentayicZ24SlWs7tjO/N9u/5J2b2+NUtuZcnwYE8BuQPyGZAPwXwLLPk5kG+BJa9+fgfkh1B+CeancL4F8i2Q/wWm/S/w+XFoTseftn0dvhu0OXfhpM+AGvzcEiYVAFisPqE9zrETJhHAlXfg2lglMK9z0f3RBfB+ZyRUV3x+erzsEIjjOBqc1xtNAIrvguybV3A9lkVHxlEE6GrrPb/ZvAySwlUnfCmlPQ+R8JCExvGtcRQBLFwj4FGkznX1VYDKPG/f2/MjwCksXACgdNUxJjwK9xwl4JihOwTFR0kIF+CABEPRnvsvPFctMoYKqAFSAFaMwB4pp3Y+bodIYL9WmIAaIOHxo7W8wiHvAjTvhUeNwwSgeAeAABbqOewC5hBdwFD4+9+7puzXV9fS6/b1wwT4tsaYAhwOOQdUQch5vgZCeAhAv3ZM31yYAAUgvApQQQ6n5w6FB/RVe1jdJOAPAAD//1eMQwoAAAGQSURBVO1UMU4DQQy8X9AgWopIUINEkS4VlJQo4gvwAV7AD3gEH4iSgidESpWSXyyZExP5lr0c7K5PsXBhec/2+jzjuWtent9CLdtu1mG5+gjz+WNr7IsY7eH+tvO+xfuqk4vz7CH91edFaF5v9nb6dBKm13edvrL+0Lk5lMzJkQDeJSkkgHF6mR8CHwMHCQR/NAQQGD0BAlwK4FCefQiefq+A2Vn29tG7igLAfmwcnJu/nJy3BMQkMN9HEPr8AL3bfBv7Bp+7/SoExMDjZwKEJwmyhnnmQIQEBIlz2x0iKoAvJkAC6TsTIH6MqRrEWUMSZF2zAwqT4Eu/e6pzFAIkmNSZ4OFT+VYBIIF//UqbJwnF/4DU0GwOn8r/JQYCpPGufEfJuZiA37ycQw/5uFeqPq4pfR6FADmkBCXjfWdZj3NfXW58dAJyB9W65wRoMWulryvAyqa05nQFaDFrpa8rwMqmtOZ0BWgxa6WvK8DKprTmdAVoMWulryvAyqa05nQFaDFrpa8rwMqmtOb89wr4AtQ4aPoL6yVpAAAAAElFTkSuQmCC","DiscoveredBy":"Salem","Properties":[{"Name":"Makes you look crazy","Power":1}],"LastUsed":"2017-02-14 12:07:23 UTC"}],"TeaTime":"12:00:00","NextVacation":"2017-03-14","FavoriteTime":"2000-10-31T23:27:46","FavoriteNumber":"13"}
diff --git a/bigquery/tests/data/colors.avro b/bigquery/tests/data/colors.avro
new file mode 100644
index 000000000000..e0133fd027f4
Binary files /dev/null and b/bigquery/tests/data/colors.avro differ
diff --git a/bigquery/tests/data/people.csv b/bigquery/tests/data/people.csv
new file mode 100644
index 000000000000..d3c7d063892a
--- /dev/null
+++ b/bigquery/tests/data/people.csv
@@ -0,0 +1,3 @@
+full_name,age
+Phred Phlyntstone,32
+Wylma Phlyntstone,29
\ No newline at end of file
diff --git a/bigquery/tests/data/schema.json b/bigquery/tests/data/schema.json
new file mode 100644
index 000000000000..6a36e55e579a
--- /dev/null
+++ b/bigquery/tests/data/schema.json
@@ -0,0 +1,88 @@
+{
+   "fields" : [
+      {
+         "type" : "STRING",
+         "name" : "Name",
+         "mode" : "NULLABLE"
+      },
+      {
+         "name" : "Age",
+         "mode" : "NULLABLE",
+         "type" : "INTEGER"
+      },
+      {
+         "type" : "FLOAT",
+         "name" : "Weight",
+         "mode" : "NULLABLE"
+      },
+      {
+         "mode" : "NULLABLE",
+         "name" : "IsMagic",
+         "type" : "BOOLEAN"
+      },
+      {
+         "name" : "Spells",
+         "fields" : [
+            {
+               "mode" : "NULLABLE",
+               "name" : "Name",
+               "type" : "STRING"
+            },
+            {
+               "mode" : "NULLABLE",
+               "name" : "LastUsed",
+               "type" : "TIMESTAMP"
+            },
+            {
+               "type" : "STRING",
+               "mode" : "NULLABLE",
+               "name" : "DiscoveredBy"
+            },
+            {
+               "name" : "Properties",
+               "fields" : [
+                  {
+                     "name" : "Name",
+                     "mode" : "NULLABLE",
+                     "type" : "STRING"
+                  },
+                  {
+                     "type" : "FLOAT",
+                     "name" : "Power",
+                     "mode" : "NULLABLE"
+                  }
+               ],
+               "mode" : "REPEATED",
+               "type" : "RECORD"
+            },
+            {
+               "mode" : "NULLABLE",
+               "name" : "Icon",
+               "type" : "BYTES"
+            }
+         ],
+         "mode" : "REPEATED",
+         "type" : "RECORD"
+      },
+      {
+         "type" : "TIME",
+         "mode" : "NULLABLE",
+         "name" : "TeaTime"
+      },
+      {
+         "type" : "DATE",
+         "name" : "NextVacation",
+         "mode" : "NULLABLE"
+      },
+      {
+         "mode" : "NULLABLE",
+         "name" : "FavoriteTime",
+         "type" : "DATETIME"
+      },
+      {
+         "mode" : "NULLABLE",
+         "name" : "FavoriteNumber",
+         "type" : "NUMERIC"
+      }
+   ]
+}
diff --git a/bigquery/tests/scrub_datasets.py b/bigquery/tests/scrub_datasets.py
new file mode 100644
index 000000000000..9a8ab3e7b7c5
--- /dev/null
+++ b/bigquery/tests/scrub_datasets.py
@@ -0,0 +1,25 @@
+import re
+import sys
+
+from google.api_core.exceptions import NotFound
+from google.cloud.bigquery import Client
+
+
+def main(prefixes):
+    client = Client()
+
+    pattern = re.compile("|".join("^{}.*$".format(prefix) for prefix in prefixes))
+
+    ds_items = list(client.list_datasets())
+    for dataset in ds_items:
+        ds_id = dataset.dataset_id
+        if pattern.match(ds_id):
+            print("Deleting dataset: {}".format(ds_id))
+            try:
+                client.delete_dataset(dataset.reference, delete_contents=True)
+            except NotFound:
+                print("   NOT FOUND")
+
+
+if __name__ == "__main__":
+    main(sys.argv[1:])
diff --git a/bigquery/tests/system.py b/bigquery/tests/system.py
new file mode 100644
index 000000000000..3593e1ecb609
--- /dev/null
+++ b/bigquery/tests/system.py
@@ -0,0 +1,2394 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import collections
+import concurrent.futures
+import csv
+import datetime
+import decimal
+import json
+import operator
+import os
+import time
+import unittest
+import uuid
+import re
+
+import six
+import pytest
+import pytz
+
+try:
+    from google.cloud import bigquery_storage_v1beta1
+except ImportError:  # pragma: NO COVER
+    bigquery_storage_v1beta1 = None
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+try:
+    import pyarrow
+    import pyarrow.types
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+try:
+    import IPython
+    from IPython.utils import io
+    from IPython.testing import tools
+    from IPython.terminal import interactiveshell
+except ImportError:  # pragma: NO COVER
+    IPython = None
+
+from google.api_core.exceptions import PreconditionFailed
+from google.api_core.exceptions import BadRequest
+from google.api_core.exceptions import Conflict
+from google.api_core.exceptions import Forbidden
+from google.api_core.exceptions import GoogleAPICallError
+from google.api_core.exceptions import NotFound
+from google.api_core.exceptions import InternalServerError
+from google.api_core.exceptions import ServiceUnavailable
+from google.api_core.exceptions import TooManyRequests
+from google.cloud import bigquery
+from google.cloud import bigquery_v2
+from google.cloud.bigquery.dataset import Dataset
+from google.cloud.bigquery.dataset import DatasetReference
+from google.cloud.bigquery.table import Table
+from google.cloud._helpers import UTC
+from google.cloud.bigquery import dbapi
+from google.cloud import storage
+
+from test_utils.retry import RetryErrors
+from test_utils.retry import RetryInstanceState
+from test_utils.retry import RetryResult
+from test_utils.system import unique_resource_id
+
+
+JOB_TIMEOUT = 120  # 2 minutes
+WHERE = os.path.abspath(os.path.dirname(__file__))
+
+# Common table data used for many tests.
+ROWS = [
+    ("Phred Phlyntstone", 32),
+    ("Bharney Rhubble", 33),
+    ("Wylma Phlyntstone", 29),
+    ("Bhettye Rhubble", 27),
+]
+HEADER_ROW = ("Full Name", "Age")
+SCHEMA = [
+    bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+    bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+]
+TIME_PARTITIONING_CLUSTERING_FIELDS_SCHEMA = [
+    bigquery.SchemaField("transaction_time", "TIMESTAMP", mode="REQUIRED"),
+    bigquery.SchemaField("transaction_id", "INTEGER", mode="REQUIRED"),
+    bigquery.SchemaField("user_email", "STRING", mode="REQUIRED"),
+    bigquery.SchemaField("store_code", "STRING", mode="REQUIRED"),
+    bigquery.SchemaField(
+        "items",
+        "RECORD",
+        mode="REPEATED",
+        fields=[
+            bigquery.SchemaField("item_code", "STRING", mode="REQUIRED"),
+            bigquery.SchemaField("quantity", "INTEGER", mode="REQUIRED"),
+            bigquery.SchemaField("comments", "STRING", mode="NULLABLE"),
+            bigquery.SchemaField("expiration_date", "DATE", mode="REQUIRED"),
+        ],
+    ),
+]
+
+# The VPC-SC team maintains a mirror of the GCS bucket used for code
+# samples. The public bucket crosses the configured security boundary.
+# See: https://github.com/googleapis/google-cloud-python/issues/8550
+SAMPLES_BUCKET = os.environ.get("GCLOUD_TEST_SAMPLES_BUCKET", "cloud-samples-data")
+
+retry_storage_errors = RetryErrors(
+    (TooManyRequests, InternalServerError, ServiceUnavailable)
+)
+
+
+def _has_rows(result):
+    return len(result) > 0
+
+
+def _make_dataset_id(prefix):
+    return "%s%s" % (prefix, unique_resource_id())
+
+
+def _load_json_schema(filename="data/schema.json"):
+    from google.cloud.bigquery.table import _parse_schema_resource
+
+    json_filename = os.path.join(WHERE, filename)
+
+    with open(json_filename, "r") as schema_file:
+        return _parse_schema_resource(json.load(schema_file))
+
+
+def _rate_limit_exceeded(forbidden):
+    """Predicate: pass only exceptions with 'rateLimitExceeded' as reason."""
+    return any(error["reason"] == "rateLimitExceeded" for error in forbidden._errors)
+
+
+# We need to wait to stay within the rate limits.
+# The alternative outcome is a 403 Forbidden response from upstream, which
+# they return instead of the more appropriate 429.
+# See https://cloud.google.com/bigquery/quota-policy
+retry_403 = RetryErrors(Forbidden, error_predicate=_rate_limit_exceeded)
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    CURSOR = None
+
+
+def setUpModule():
+    Config.CLIENT = bigquery.Client()
+    Config.CURSOR = dbapi.connect(Config.CLIENT).cursor()
+
+
+class TestBigQuery(unittest.TestCase):
+    def setUp(self):
+        self.to_delete = []
+
+    def tearDown(self):
+        def _still_in_use(bad_request):
+            return any(
+                error["reason"] == "resourceInUse" for error in bad_request._errors
+            )
+
+        retry_in_use = RetryErrors(BadRequest, error_predicate=_still_in_use)
+        retry_storage_errors_conflict = RetryErrors(
+            (Conflict, TooManyRequests, InternalServerError, ServiceUnavailable)
+        )
+        for doomed in self.to_delete:
+            if isinstance(doomed, storage.Bucket):
+                retry_storage_errors_conflict(doomed.delete)(force=True)
+            elif isinstance(doomed, (Dataset, bigquery.DatasetReference)):
+                retry_in_use(Config.CLIENT.delete_dataset)(doomed, delete_contents=True)
+            elif isinstance(doomed, (Table, bigquery.TableReference)):
+                retry_in_use(Config.CLIENT.delete_table)(doomed)
+            else:
+                doomed.delete()
+
+    def test_get_service_account_email(self):
+        client = Config.CLIENT
+
+        got = client.get_service_account_email()
+
+        self.assertIsInstance(got, six.text_type)
+        self.assertIn("@", got)
+
+    def _create_bucket(self, bucket_name, location=None):
+        storage_client = storage.Client()
+        bucket = storage_client.bucket(bucket_name)
+        retry_storage_errors(bucket.create)(location=location)
+        self.to_delete.append(bucket)
+
+        return bucket
+
+    def test_create_dataset(self):
+        DATASET_ID = _make_dataset_id("create_dataset")
+        dataset = self.temp_dataset(DATASET_ID)
+
+        self.assertTrue(_dataset_exists(dataset))
+        self.assertEqual(dataset.dataset_id, DATASET_ID)
+        self.assertEqual(dataset.project, Config.CLIENT.project)
+
+    def test_get_dataset(self):
+        dataset_id = _make_dataset_id("get_dataset")
+        client = Config.CLIENT
+        dataset_arg = Dataset(client.dataset(dataset_id))
+        dataset_arg.friendly_name = "Friendly"
+        dataset_arg.description = "Description"
+        dataset = retry_403(client.create_dataset)(dataset_arg)
+        self.to_delete.append(dataset)
+        dataset_ref = client.dataset(dataset_id)
+
+        # Get with a reference.
+        got = client.get_dataset(dataset_ref)
+        self.assertEqual(got.friendly_name, "Friendly")
+        self.assertEqual(got.description, "Description")
+
+        # Get with a string.
+        got = client.get_dataset(dataset_id)
+        self.assertEqual(got.friendly_name, "Friendly")
+        self.assertEqual(got.description, "Description")
+
+        # Get with a fully-qualified string.
+        got = client.get_dataset("{}.{}".format(client.project, dataset_id))
+        self.assertEqual(got.friendly_name, "Friendly")
+        self.assertEqual(got.description, "Description")
+
+    def test_update_dataset(self):
+        dataset = self.temp_dataset(_make_dataset_id("update_dataset"))
+        self.assertTrue(_dataset_exists(dataset))
+        self.assertIsNone(dataset.friendly_name)
+        self.assertIsNone(dataset.description)
+        self.assertEqual(dataset.labels, {})
+
+        dataset.friendly_name = "Friendly"
+        dataset.description = "Description"
+        dataset.labels = {"priority": "high", "color": "blue"}
+        ds2 = Config.CLIENT.update_dataset(
+            dataset, ("friendly_name", "description", "labels")
+        )
+        self.assertEqual(ds2.friendly_name, "Friendly")
+        self.assertEqual(ds2.description, "Description")
+        self.assertEqual(ds2.labels, {"priority": "high", "color": "blue"})
+
+        ds2.labels = {
+            "color": "green",  # change
+            "shape": "circle",  # add
+            "priority": None,  # delete
+        }
+        ds3 = Config.CLIENT.update_dataset(ds2, ["labels"])
+        self.assertEqual(ds3.labels, {"color": "green", "shape": "circle"})
+
+        # If we try to update using d2 again, it will fail because the
+        # previous update changed the ETag.
+        ds2.description = "no good"
+        with self.assertRaises(PreconditionFailed):
+            Config.CLIENT.update_dataset(ds2, ["description"])
+
+    def test_list_datasets(self):
+        datasets_to_create = [
+            "new" + unique_resource_id(),
+            "newer" + unique_resource_id(),
+            "newest" + unique_resource_id(),
+        ]
+        for dataset_id in datasets_to_create:
+            self.temp_dataset(dataset_id)
+
+        # Retrieve the datasets.
+        iterator = Config.CLIENT.list_datasets()
+        all_datasets = list(iterator)
+        self.assertIsNone(iterator.next_page_token)
+        created = [
+            dataset
+            for dataset in all_datasets
+            if dataset.dataset_id in datasets_to_create
+            and dataset.project == Config.CLIENT.project
+        ]
+        self.assertEqual(len(created), len(datasets_to_create))
+
+    def test_list_datasets_w_project(self):
+        # Retrieve datasets from a different project.
+        iterator = Config.CLIENT.list_datasets(project="bigquery-public-data")
+        all_datasets = frozenset([dataset.dataset_id for dataset in iterator])
+        self.assertIn("usa_names", all_datasets)
+
+    def test_create_table(self):
+        dataset = self.temp_dataset(_make_dataset_id("create_table"))
+        table_id = "test_table"
+        table_arg = Table(dataset.table(table_id), schema=SCHEMA)
+        self.assertFalse(_table_exists(table_arg))
+
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        self.assertTrue(_table_exists(table))
+        self.assertEqual(table.table_id, table_id)
+
+    def test_create_table_w_time_partitioning_w_clustering_fields(self):
+        from google.cloud.bigquery.table import TimePartitioning
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        dataset = self.temp_dataset(_make_dataset_id("create_table_tp_cf"))
+        table_id = "test_table"
+        table_arg = Table(
+            dataset.table(table_id), schema=TIME_PARTITIONING_CLUSTERING_FIELDS_SCHEMA
+        )
+        self.assertFalse(_table_exists(table_arg))
+
+        table_arg.time_partitioning = TimePartitioning(field="transaction_time")
+
+        table_arg.clustering_fields = ["user_email", "store_code"]
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        self.assertTrue(_table_exists(table))
+        self.assertEqual(table.table_id, table_id)
+        time_partitioning = table.time_partitioning
+        self.assertEqual(time_partitioning.type_, TimePartitioningType.DAY)
+        self.assertEqual(time_partitioning.field, "transaction_time")
+        self.assertEqual(table.clustering_fields, ["user_email", "store_code"])
+
+    def test_delete_dataset_with_string(self):
+        dataset_id = _make_dataset_id("delete_table_true")
+        dataset_ref = Config.CLIENT.dataset(dataset_id)
+        retry_403(Config.CLIENT.create_dataset)(Dataset(dataset_ref))
+        self.assertTrue(_dataset_exists(dataset_ref))
+        Config.CLIENT.delete_dataset(dataset_id)
+        self.assertFalse(_dataset_exists(dataset_ref))
+
+    def test_delete_dataset_delete_contents_true(self):
+        dataset_id = _make_dataset_id("delete_table_true")
+        dataset = retry_403(Config.CLIENT.create_dataset)(
+            Dataset(Config.CLIENT.dataset(dataset_id))
+        )
+
+        table_id = "test_table"
+        table_arg = Table(dataset.table(table_id), schema=SCHEMA)
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        Config.CLIENT.delete_dataset(dataset, delete_contents=True)
+
+        self.assertFalse(_table_exists(table))
+
+    def test_delete_dataset_delete_contents_false(self):
+        from google.api_core import exceptions
+
+        dataset = self.temp_dataset(_make_dataset_id("delete_table_false"))
+        table_id = "test_table"
+        table_arg = Table(dataset.table(table_id), schema=SCHEMA)
+
+        retry_403(Config.CLIENT.create_table)(table_arg)
+        with self.assertRaises(exceptions.BadRequest):
+            Config.CLIENT.delete_dataset(dataset)
+
+    def test_get_table_w_public_dataset(self):
+        public = "bigquery-public-data"
+        dataset_id = "samples"
+        table_id = "shakespeare"
+        table_ref = DatasetReference(public, dataset_id).table(table_id)
+
+        # Get table with reference.
+        table = Config.CLIENT.get_table(table_ref)
+        self.assertEqual(table.table_id, table_id)
+        self.assertEqual(table.dataset_id, dataset_id)
+        self.assertEqual(table.project, public)
+        schema_names = [field.name for field in table.schema]
+        self.assertEqual(schema_names, ["word", "word_count", "corpus", "corpus_date"])
+
+        # Get table with string.
+        table = Config.CLIENT.get_table("{}.{}.{}".format(public, dataset_id, table_id))
+        self.assertEqual(table.table_id, table_id)
+        self.assertEqual(table.dataset_id, dataset_id)
+        self.assertEqual(table.project, public)
+
+    def test_list_partitions(self):
+        table_ref = DatasetReference(
+            "bigquery-public-data", "ethereum_blockchain"
+        ).table("blocks")
+        all_rows = Config.CLIENT.list_partitions(table_ref)
+        self.assertIn("20180801", all_rows)
+        self.assertGreater(len(all_rows), 1000)
+
+    def test_list_tables(self):
+        dataset_id = _make_dataset_id("list_tables")
+        dataset = self.temp_dataset(dataset_id)
+        # Retrieve tables before any are created for the dataset.
+        iterator = Config.CLIENT.list_tables(dataset)
+        all_tables = list(iterator)
+        self.assertEqual(all_tables, [])
+        self.assertIsNone(iterator.next_page_token)
+
+        # Insert some tables to be listed.
+        tables_to_create = [
+            "new" + unique_resource_id(),
+            "newer" + unique_resource_id(),
+            "newest" + unique_resource_id(),
+        ]
+        for table_name in tables_to_create:
+            table = Table(dataset.table(table_name), schema=SCHEMA)
+            created_table = retry_403(Config.CLIENT.create_table)(table)
+            self.to_delete.insert(0, created_table)
+
+        # Retrieve the tables.
+        iterator = Config.CLIENT.list_tables(dataset)
+        all_tables = list(iterator)
+        self.assertIsNone(iterator.next_page_token)
+        created = [
+            table
+            for table in all_tables
+            if (table.table_id in tables_to_create and table.dataset_id == dataset_id)
+        ]
+        self.assertEqual(len(created), len(tables_to_create))
+
+        # List tables with a string ID.
+        iterator = Config.CLIENT.list_tables(dataset_id)
+        self.assertGreater(len(list(iterator)), 0)
+
+        # List tables with a fully-qualified string ID.
+        iterator = Config.CLIENT.list_tables(
+            "{}.{}".format(Config.CLIENT.project, dataset_id)
+        )
+        self.assertGreater(len(list(iterator)), 0)
+
+    def test_update_table(self):
+        dataset = self.temp_dataset(_make_dataset_id("update_table"))
+
+        TABLE_NAME = "test_table"
+        table_arg = Table(dataset.table(TABLE_NAME), schema=SCHEMA)
+        self.assertFalse(_table_exists(table_arg))
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+        self.assertTrue(_table_exists(table))
+        self.assertIsNone(table.friendly_name)
+        self.assertIsNone(table.description)
+        self.assertEqual(table.labels, {})
+        table.friendly_name = "Friendly"
+        table.description = "Description"
+        table.labels = {"priority": "high", "color": "blue"}
+
+        table2 = Config.CLIENT.update_table(
+            table, ["friendly_name", "description", "labels"]
+        )
+
+        self.assertEqual(table2.friendly_name, "Friendly")
+        self.assertEqual(table2.description, "Description")
+        self.assertEqual(table2.labels, {"priority": "high", "color": "blue"})
+
+        table2.description = None
+        table2.labels = {
+            "color": "green",  # change
+            "shape": "circle",  # add
+            "priority": None,  # delete
+        }
+        table3 = Config.CLIENT.update_table(table2, ["description", "labels"])
+        self.assertIsNone(table3.description)
+        self.assertEqual(table3.labels, {"color": "green", "shape": "circle"})
+
+        # If we try to update using table2 again, it will fail because the
+        # previous update changed the ETag.
+        table2.description = "no good"
+        with self.assertRaises(PreconditionFailed):
+            Config.CLIENT.update_table(table2, ["description"])
+
+    def test_update_table_schema(self):
+        dataset = self.temp_dataset(_make_dataset_id("update_table"))
+
+        TABLE_NAME = "test_table"
+        table_arg = Table(dataset.table(TABLE_NAME), schema=SCHEMA)
+        self.assertFalse(_table_exists(table_arg))
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+        self.assertTrue(_table_exists(table))
+        voter = bigquery.SchemaField("voter", "BOOLEAN", mode="NULLABLE")
+        schema = table.schema
+        schema.append(voter)
+        table.schema = schema
+
+        updated_table = Config.CLIENT.update_table(table, ["schema"])
+
+        self.assertEqual(len(updated_table.schema), len(schema))
+        for found, expected in zip(updated_table.schema, schema):
+            self.assertEqual(found.name, expected.name)
+            self.assertEqual(found.field_type, expected.field_type)
+            self.assertEqual(found.mode, expected.mode)
+
+    @staticmethod
+    def _fetch_single_page(table, selected_fields=None):
+        iterator = Config.CLIENT.list_rows(table, selected_fields=selected_fields)
+        page = six.next(iterator.pages)
+        return list(page)
+
+    def _create_table_many_columns(self, rowcount):
+        # Generate a table of maximum width via CREATE TABLE AS SELECT.
+        # first column is named 'rowval', and has a value from 1..rowcount
+        # Subsequent column is named col_<N> and contains the value N*rowval,
+        # where N is between 1 and 9999 inclusive.
+        dsname = _make_dataset_id("wide_schema")
+        dataset = self.temp_dataset(dsname)
+        table_id = "many_columns"
+        table_ref = dataset.table(table_id)
+        self.to_delete.insert(0, table_ref)
+        colprojections = ",".join(
+            ["r * {} as col_{}".format(n, n) for n in range(1, 10000)]
+        )
+        sql = """
+            CREATE TABLE {}.{}
+            AS
+            SELECT
+                r as rowval,
+                {}
+            FROM
+              UNNEST(GENERATE_ARRAY(1,{},1)) as r
+            """.format(
+            dsname, table_id, colprojections, rowcount
+        )
+        query_job = Config.CLIENT.query(sql)
+        query_job.result()
+        self.assertEqual(query_job.statement_type, "CREATE_TABLE_AS_SELECT")
+        self.assertEqual(query_job.ddl_operation_performed, "CREATE")
+        self.assertEqual(query_job.ddl_target_table, table_ref)
+
+        return table_ref
+
+    def test_query_many_columns(self):
+        # Test working with the widest schema BigQuery supports, 10k columns.
+        row_count = 2
+        table_ref = self._create_table_many_columns(row_count)
+        rows = list(
+            Config.CLIENT.query(
+                "SELECT * FROM `{}.{}`".format(table_ref.dataset_id, table_ref.table_id)
+            )
+        )
+
+        self.assertEqual(len(rows), row_count)
+
+        # check field representations adhere to expected values.
+        correctwidth = 0
+        badvals = 0
+        for r in rows:
+            vals = r._xxx_values
+            rowval = vals[0]
+            if len(vals) == 10000:
+                correctwidth = correctwidth + 1
+            for n in range(1, 10000):
+                if vals[n] != rowval * (n):
+                    badvals = badvals + 1
+        self.assertEqual(correctwidth, row_count)
+        self.assertEqual(badvals, 0)
+
+    def test_insert_rows_then_dump_table(self):
+        NOW_SECONDS = 1448911495.484366
+        NOW = datetime.datetime.utcfromtimestamp(NOW_SECONDS).replace(tzinfo=UTC)
+        ROWS = [
+            ("Phred Phlyntstone", 32, NOW),
+            ("Bharney Rhubble", 33, NOW + datetime.timedelta(seconds=10)),
+            ("Wylma Phlyntstone", 29, NOW + datetime.timedelta(seconds=20)),
+            ("Bhettye Rhubble", 27, None),
+        ]
+        ROW_IDS = range(len(ROWS))
+
+        dataset = self.temp_dataset(_make_dataset_id("insert_rows_then_dump"))
+        TABLE_ID = "test_table"
+        schema = [
+            bigquery.SchemaField("full_name", "STRING", mode="REQUIRED"),
+            bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+            bigquery.SchemaField("now", "TIMESTAMP"),
+        ]
+        table_arg = Table(dataset.table(TABLE_ID), schema=schema)
+        self.assertFalse(_table_exists(table_arg))
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+        self.assertTrue(_table_exists(table))
+
+        errors = Config.CLIENT.insert_rows(table, ROWS, row_ids=ROW_IDS)
+        self.assertEqual(len(errors), 0)
+
+        rows = ()
+
+        # Allow for "warm up" before rows visible.  See
+        # https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataavailability
+        # 8 tries -> 1 + 2 + 4 + 8 + 16 + 32 + 64 = 127 seconds
+        retry = RetryResult(_has_rows, max_tries=8)
+        rows = retry(self._fetch_single_page)(table)
+        row_tuples = [r.values() for r in rows]
+        by_age = operator.itemgetter(1)
+        self.assertEqual(sorted(row_tuples, key=by_age), sorted(ROWS, key=by_age))
+
+    def test_load_table_from_local_avro_file_then_dump_table(self):
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        TABLE_NAME = "test_table_avro"
+        ROWS = [
+            ("violet", 400),
+            ("indigo", 445),
+            ("blue", 475),
+            ("green", 510),
+            ("yellow", 570),
+            ("orange", 590),
+            ("red", 650),
+        ]
+
+        dataset = self.temp_dataset(_make_dataset_id("load_local_then_dump"))
+        table_ref = dataset.table(TABLE_NAME)
+        table = Table(table_ref)
+        self.to_delete.insert(0, table)
+
+        with open(os.path.join(WHERE, "data", "colors.avro"), "rb") as avrof:
+            config = bigquery.LoadJobConfig()
+            config.source_format = SourceFormat.AVRO
+            config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+            job = Config.CLIENT.load_table_from_file(
+                avrof, table_ref, job_config=config
+            )
+        # Retry until done.
+        job.result(timeout=JOB_TIMEOUT)
+
+        self.assertEqual(job.output_rows, len(ROWS))
+
+        table = Config.CLIENT.get_table(table)
+        rows = self._fetch_single_page(table)
+        row_tuples = [r.values() for r in rows]
+        by_wavelength = operator.itemgetter(1)
+        self.assertEqual(
+            sorted(row_tuples, key=by_wavelength), sorted(ROWS, key=by_wavelength)
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_automatic_schema(self):
+        """Test that a DataFrame with dtypes that map well to BigQuery types
+        can be uploaded without specifying a schema.
+
+        https://github.com/googleapis/google-cloud-python/issues/9044
+        """
+        df_data = collections.OrderedDict(
+            [
+                ("bool_col", pandas.Series([True, False, True], dtype="bool")),
+                (
+                    "ts_col",
+                    pandas.Series(
+                        [
+                            datetime.datetime(2010, 1, 2, 3, 44, 50),
+                            datetime.datetime(2011, 2, 3, 14, 50, 59),
+                            datetime.datetime(2012, 3, 14, 15, 16),
+                        ],
+                        dtype="datetime64[ns]",
+                    ).dt.tz_localize(pytz.utc),
+                ),
+                (
+                    "dt_col",
+                    pandas.Series(
+                        [
+                            datetime.datetime(2010, 1, 2, 3, 44, 50),
+                            datetime.datetime(2011, 2, 3, 14, 50, 59),
+                            datetime.datetime(2012, 3, 14, 15, 16),
+                        ],
+                        dtype="datetime64[ns]",
+                    ),
+                ),
+                ("float32_col", pandas.Series([1.0, 2.0, 3.0], dtype="float32")),
+                ("float64_col", pandas.Series([4.0, 5.0, 6.0], dtype="float64")),
+                ("int8_col", pandas.Series([-12, -11, -10], dtype="int8")),
+                ("int16_col", pandas.Series([-9, -8, -7], dtype="int16")),
+                ("int32_col", pandas.Series([-6, -5, -4], dtype="int32")),
+                ("int64_col", pandas.Series([-3, -2, -1], dtype="int64")),
+                ("uint8_col", pandas.Series([0, 1, 2], dtype="uint8")),
+                ("uint16_col", pandas.Series([3, 4, 5], dtype="uint16")),
+                ("uint32_col", pandas.Series([6, 7, 8], dtype="uint32")),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, columns=df_data.keys())
+
+        dataset_id = _make_dataset_id("bq_load_test")
+        self.temp_dataset(dataset_id)
+        table_id = "{}.{}.load_table_from_dataframe_w_automatic_schema".format(
+            Config.CLIENT.project, dataset_id
+        )
+
+        load_job = Config.CLIENT.load_table_from_dataframe(dataframe, table_id)
+        load_job.result()
+
+        table = Config.CLIENT.get_table(table_id)
+        self.assertEqual(
+            tuple(table.schema),
+            (
+                bigquery.SchemaField("bool_col", "BOOLEAN"),
+                bigquery.SchemaField("ts_col", "TIMESTAMP"),
+                bigquery.SchemaField("dt_col", "DATETIME"),
+                bigquery.SchemaField("float32_col", "FLOAT"),
+                bigquery.SchemaField("float64_col", "FLOAT"),
+                bigquery.SchemaField("int8_col", "INTEGER"),
+                bigquery.SchemaField("int16_col", "INTEGER"),
+                bigquery.SchemaField("int32_col", "INTEGER"),
+                bigquery.SchemaField("int64_col", "INTEGER"),
+                bigquery.SchemaField("uint8_col", "INTEGER"),
+                bigquery.SchemaField("uint16_col", "INTEGER"),
+                bigquery.SchemaField("uint32_col", "INTEGER"),
+            ),
+        )
+        self.assertEqual(table.num_rows, 3)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_nulls(self):
+        """Test that a DataFrame with null columns can be uploaded if a
+        BigQuery schema is specified.
+
+        See: https://github.com/googleapis/google-cloud-python/issues/7370
+        """
+        # Schema with all scalar types.
+        scalars_schema = (
+            bigquery.SchemaField("bool_col", "BOOLEAN"),
+            bigquery.SchemaField("bytes_col", "BYTES"),
+            bigquery.SchemaField("date_col", "DATE"),
+            bigquery.SchemaField("dt_col", "DATETIME"),
+            bigquery.SchemaField("float_col", "FLOAT"),
+            bigquery.SchemaField("geo_col", "GEOGRAPHY"),
+            bigquery.SchemaField("int_col", "INTEGER"),
+            bigquery.SchemaField("num_col", "NUMERIC"),
+            bigquery.SchemaField("str_col", "STRING"),
+            bigquery.SchemaField("time_col", "TIME"),
+            bigquery.SchemaField("ts_col", "TIMESTAMP"),
+        )
+        table_schema = scalars_schema + (
+            # TODO: Array columns can't be read due to NULLABLE versus REPEATED
+            #       mode mismatch. See:
+            #       https://issuetracker.google.com/133415569#comment3
+            # bigquery.SchemaField("array_col", "INTEGER", mode="REPEATED"),
+            # TODO: Support writing StructArrays to Parquet. See:
+            #       https://jira.apache.org/jira/browse/ARROW-2587
+            # bigquery.SchemaField("struct_col", "RECORD", fields=scalars_schema),
+        )
+        num_rows = 100
+        nulls = [None] * num_rows
+        df_data = collections.OrderedDict(
+            [
+                ("bool_col", nulls),
+                ("bytes_col", nulls),
+                ("date_col", nulls),
+                ("dt_col", nulls),
+                ("float_col", nulls),
+                ("geo_col", nulls),
+                ("int_col", nulls),
+                ("num_col", nulls),
+                ("str_col", nulls),
+                ("time_col", nulls),
+                ("ts_col", nulls),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, columns=df_data.keys())
+
+        dataset_id = _make_dataset_id("bq_load_test")
+        self.temp_dataset(dataset_id)
+        table_id = "{}.{}.load_table_from_dataframe_w_nulls".format(
+            Config.CLIENT.project, dataset_id
+        )
+
+        # Create the table before loading so that schema mismatch errors are
+        # identified.
+        table = retry_403(Config.CLIENT.create_table)(
+            Table(table_id, schema=table_schema)
+        )
+        self.to_delete.insert(0, table)
+
+        job_config = bigquery.LoadJobConfig(schema=table_schema)
+        load_job = Config.CLIENT.load_table_from_dataframe(
+            dataframe, table_id, job_config=job_config
+        )
+        load_job.result()
+
+        table = Config.CLIENT.get_table(table)
+        self.assertEqual(tuple(table.schema), table_schema)
+        self.assertEqual(table.num_rows, num_rows)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_required(self):
+        """Test that a DataFrame with required columns can be uploaded if a
+        BigQuery schema is specified.
+
+        See: https://github.com/googleapis/google-cloud-python/issues/8093
+        """
+        table_schema = (
+            bigquery.SchemaField("name", "STRING", mode="REQUIRED"),
+            bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+        )
+
+        records = [{"name": "Chip", "age": 2}, {"name": "Dale", "age": 3}]
+        dataframe = pandas.DataFrame(records, columns=["name", "age"])
+        job_config = bigquery.LoadJobConfig(schema=table_schema)
+        dataset_id = _make_dataset_id("bq_load_test")
+        self.temp_dataset(dataset_id)
+        table_id = "{}.{}.load_table_from_dataframe_w_required".format(
+            Config.CLIENT.project, dataset_id
+        )
+
+        # Create the table before loading so that schema mismatch errors are
+        # identified.
+        table = retry_403(Config.CLIENT.create_table)(
+            Table(table_id, schema=table_schema)
+        )
+        self.to_delete.insert(0, table)
+
+        job_config = bigquery.LoadJobConfig(schema=table_schema)
+        load_job = Config.CLIENT.load_table_from_dataframe(
+            dataframe, table_id, job_config=job_config
+        )
+        load_job.result()
+
+        table = Config.CLIENT.get_table(table)
+        self.assertEqual(tuple(table.schema), table_schema)
+        self.assertEqual(table.num_rows, 2)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_explicit_schema(self):
+        # Schema with all scalar types.
+        scalars_schema = (
+            bigquery.SchemaField("bool_col", "BOOLEAN"),
+            bigquery.SchemaField("bytes_col", "BYTES"),
+            bigquery.SchemaField("date_col", "DATE"),
+            bigquery.SchemaField("dt_col", "DATETIME"),
+            bigquery.SchemaField("float_col", "FLOAT"),
+            bigquery.SchemaField("geo_col", "GEOGRAPHY"),
+            bigquery.SchemaField("int_col", "INTEGER"),
+            bigquery.SchemaField("num_col", "NUMERIC"),
+            bigquery.SchemaField("str_col", "STRING"),
+            bigquery.SchemaField("time_col", "TIME"),
+            bigquery.SchemaField("ts_col", "TIMESTAMP"),
+        )
+        table_schema = scalars_schema + (
+            # TODO: Array columns can't be read due to NULLABLE versus REPEATED
+            #       mode mismatch. See:
+            #       https://issuetracker.google.com/133415569#comment3
+            # bigquery.SchemaField("array_col", "INTEGER", mode="REPEATED"),
+            # TODO: Support writing StructArrays to Parquet. See:
+            #       https://jira.apache.org/jira/browse/ARROW-2587
+            # bigquery.SchemaField("struct_col", "RECORD", fields=scalars_schema),
+        )
+        df_data = collections.OrderedDict(
+            [
+                ("bool_col", [True, None, False]),
+                ("bytes_col", [b"abc", None, b"def"]),
+                (
+                    "date_col",
+                    [datetime.date(1, 1, 1), None, datetime.date(9999, 12, 31)],
+                ),
+                (
+                    "dt_col",
+                    [
+                        datetime.datetime(1, 1, 1, 0, 0, 0),
+                        None,
+                        datetime.datetime(9999, 12, 31, 23, 59, 59, 999999),
+                    ],
+                ),
+                ("float_col", [float("-inf"), float("nan"), float("inf")]),
+                (
+                    "geo_col",
+                    [
+                        "POINT(30 10)",
+                        None,
+                        "POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))",
+                    ],
+                ),
+                ("int_col", [-9223372036854775808, None, 9223372036854775807]),
+                (
+                    "num_col",
+                    [
+                        decimal.Decimal("-99999999999999999999999999999.999999999"),
+                        None,
+                        decimal.Decimal("99999999999999999999999999999.999999999"),
+                    ],
+                ),
+                ("str_col", [u"abc", None, u"def"]),
+                (
+                    "time_col",
+                    [datetime.time(0, 0, 0), None, datetime.time(23, 59, 59, 999999)],
+                ),
+                (
+                    "ts_col",
+                    [
+                        datetime.datetime(1, 1, 1, 0, 0, 0, tzinfo=pytz.utc),
+                        None,
+                        datetime.datetime(
+                            9999, 12, 31, 23, 59, 59, 999999, tzinfo=pytz.utc
+                        ),
+                    ],
+                ),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, dtype="object", columns=df_data.keys())
+
+        dataset_id = _make_dataset_id("bq_load_test")
+        self.temp_dataset(dataset_id)
+        table_id = "{}.{}.load_table_from_dataframe_w_explicit_schema".format(
+            Config.CLIENT.project, dataset_id
+        )
+
+        job_config = bigquery.LoadJobConfig(schema=table_schema)
+        load_job = Config.CLIENT.load_table_from_dataframe(
+            dataframe, table_id, job_config=job_config
+        )
+        load_job.result()
+
+        table = Config.CLIENT.get_table(table_id)
+        self.assertEqual(tuple(table.schema), table_schema)
+        self.assertEqual(table.num_rows, 3)
+
+    def test_load_table_from_json_basic_use(self):
+        table_schema = (
+            bigquery.SchemaField("name", "STRING", mode="REQUIRED"),
+            bigquery.SchemaField("age", "INTEGER", mode="REQUIRED"),
+            bigquery.SchemaField("birthday", "DATE", mode="REQUIRED"),
+            bigquery.SchemaField("is_awesome", "BOOLEAN", mode="REQUIRED"),
+        )
+
+        json_rows = [
+            {"name": "John", "age": 18, "birthday": "2001-10-15", "is_awesome": False},
+            {"name": "Chuck", "age": 79, "birthday": "1940-03-10", "is_awesome": True},
+        ]
+
+        dataset_id = _make_dataset_id("bq_system_test")
+        self.temp_dataset(dataset_id)
+        table_id = "{}.{}.load_table_from_json_basic_use".format(
+            Config.CLIENT.project, dataset_id
+        )
+
+        # Create the table before loading so that schema mismatch errors are
+        # identified.
+        table = retry_403(Config.CLIENT.create_table)(
+            Table(table_id, schema=table_schema)
+        )
+        self.to_delete.insert(0, table)
+
+        job_config = bigquery.LoadJobConfig(schema=table_schema)
+        load_job = Config.CLIENT.load_table_from_json(
+            json_rows, table_id, job_config=job_config
+        )
+        load_job.result()
+
+        table = Config.CLIENT.get_table(table)
+        self.assertEqual(tuple(table.schema), table_schema)
+        self.assertEqual(table.num_rows, 2)
+
+    def test_load_table_from_json_schema_autodetect(self):
+        json_rows = [
+            {"name": "John", "age": 18, "birthday": "2001-10-15", "is_awesome": False},
+            {"name": "Chuck", "age": 79, "birthday": "1940-03-10", "is_awesome": True},
+        ]
+
+        dataset_id = _make_dataset_id("bq_system_test")
+        self.temp_dataset(dataset_id)
+        table_id = "{}.{}.load_table_from_json_basic_use".format(
+            Config.CLIENT.project, dataset_id
+        )
+
+        # Use schema with NULLABLE fields, because schema autodetection
+        # defaults to field mode NULLABLE.
+        table_schema = (
+            bigquery.SchemaField("name", "STRING", mode="NULLABLE"),
+            bigquery.SchemaField("age", "INTEGER", mode="NULLABLE"),
+            bigquery.SchemaField("birthday", "DATE", mode="NULLABLE"),
+            bigquery.SchemaField("is_awesome", "BOOLEAN", mode="NULLABLE"),
+        )
+        # create the table before loading so that the column order is predictable
+        table = retry_403(Config.CLIENT.create_table)(
+            Table(table_id, schema=table_schema)
+        )
+        self.to_delete.insert(0, table)
+
+        # do not pass an explicit job config to trigger automatic schema detection
+        load_job = Config.CLIENT.load_table_from_json(json_rows, table_id)
+        load_job.result()
+
+        table = Config.CLIENT.get_table(table)
+        self.assertEqual(tuple(table.schema), table_schema)
+        self.assertEqual(table.num_rows, 2)
+
+    def test_load_avro_from_uri_then_dump_table(self):
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        table_name = "test_table"
+        rows = [
+            ("violet", 400),
+            ("indigo", 445),
+            ("blue", 475),
+            ("green", 510),
+            ("yellow", 570),
+            ("orange", 590),
+            ("red", 650),
+        ]
+        with open(os.path.join(WHERE, "data", "colors.avro"), "rb") as f:
+            GS_URL = self._write_avro_to_storage(
+                "bq_load_test" + unique_resource_id(), "colors.avro", f
+            )
+
+        dataset = self.temp_dataset(_make_dataset_id("bq_load_test"))
+        table_arg = dataset.table(table_name)
+        table = retry_403(Config.CLIENT.create_table)(Table(table_arg))
+        self.to_delete.insert(0, table)
+
+        config = bigquery.LoadJobConfig()
+        config.create_disposition = CreateDisposition.CREATE_NEVER
+        config.source_format = SourceFormat.AVRO
+        config.write_disposition = WriteDisposition.WRITE_EMPTY
+        job = Config.CLIENT.load_table_from_uri(GS_URL, table_arg, job_config=config)
+        job.result(timeout=JOB_TIMEOUT)
+        self.assertEqual(job.output_rows, len(rows))
+
+        table = Config.CLIENT.get_table(table)
+        fetched = self._fetch_single_page(table)
+        row_tuples = [r.values() for r in fetched]
+        self.assertEqual(
+            sorted(row_tuples, key=lambda x: x[1]), sorted(rows, key=lambda x: x[1])
+        )
+
+    def test_load_table_from_uri_then_dump_table(self):
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        TABLE_ID = "test_table"
+        GS_URL = self._write_csv_to_storage(
+            "bq_load_test" + unique_resource_id(), "person_ages.csv", HEADER_ROW, ROWS
+        )
+
+        dataset = self.temp_dataset(_make_dataset_id("load_gcs_then_dump"))
+
+        table_arg = Table(dataset.table(TABLE_ID), schema=SCHEMA)
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        config = bigquery.LoadJobConfig()
+        config.create_disposition = CreateDisposition.CREATE_NEVER
+        config.skip_leading_rows = 1
+        config.source_format = SourceFormat.CSV
+        config.write_disposition = WriteDisposition.WRITE_EMPTY
+        job = Config.CLIENT.load_table_from_uri(
+            GS_URL, dataset.table(TABLE_ID), job_config=config
+        )
+
+        # Allow for 90 seconds of "warm up" before rows visible.  See
+        # https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataavailability
+        # 8 tries -> 1 + 2 + 4 + 8 + 16 + 32 + 64 = 127 seconds
+        retry = RetryInstanceState(_job_done, max_tries=8)
+        retry(job.reload)()
+
+        rows = self._fetch_single_page(table)
+        row_tuples = [r.values() for r in rows]
+        by_age = operator.itemgetter(1)
+        self.assertEqual(sorted(row_tuples, key=by_age), sorted(ROWS, key=by_age))
+
+    def test_load_table_from_file_w_explicit_location(self):
+        # Create a temporary bucket for extract files.
+        bucket_name = "bq_load_table_eu_extract_test" + unique_resource_id()
+        self._create_bucket(bucket_name, location="eu")
+
+        # Create a temporary dataset & table in the EU.
+        table_bytes = six.BytesIO(b"a,3\nb,2\nc,1\n")
+        client = Config.CLIENT
+        dataset = self.temp_dataset(_make_dataset_id("eu_load_file"), location="EU")
+        table_ref = dataset.table("letters")
+        job_config = bigquery.LoadJobConfig()
+        job_config.skip_leading_rows = 0
+        job_config.schema = [
+            bigquery.SchemaField("letter", "STRING"),
+            bigquery.SchemaField("value", "INTEGER"),
+        ]
+
+        # Load the file to an EU dataset with an EU load job.
+        load_job = client.load_table_from_file(
+            table_bytes, table_ref, location="EU", job_config=job_config
+        )
+        load_job.result()
+        job_id = load_job.job_id
+
+        # Can get the job from the EU.
+        load_job = client.get_job(job_id, location="EU")
+        self.assertEqual(job_id, load_job.job_id)
+        self.assertEqual("EU", load_job.location)
+        self.assertTrue(load_job.exists())
+
+        # Cannot get the job from the US.
+        with self.assertRaises(NotFound):
+            client.get_job(job_id, location="US")
+
+        load_job_us = client.get_job(job_id)
+        load_job_us._properties["jobReference"]["location"] = "US"
+        self.assertFalse(load_job_us.exists())
+        with self.assertRaises(NotFound):
+            load_job_us.reload()
+
+        # Can cancel the job from the EU.
+        self.assertTrue(load_job.cancel())
+        load_job = client.cancel_job(job_id, location="EU")
+        self.assertEqual(job_id, load_job.job_id)
+        self.assertEqual("EU", load_job.location)
+
+        # Cannot cancel the job from the US.
+        with self.assertRaises(NotFound):
+            client.cancel_job(job_id, location="US")
+        with self.assertRaises(NotFound):
+            load_job_us.cancel()
+
+        # Can list the table rows.
+        table = client.get_table(table_ref)
+        self.assertEqual(table.num_rows, 3)
+        rows = [(row.letter, row.value) for row in client.list_rows(table)]
+        self.assertEqual(list(sorted(rows)), [("a", 3), ("b", 2), ("c", 1)])
+
+        # Verify location behavior with queries
+        query_config = bigquery.QueryJobConfig()
+        query_config.dry_run = True
+
+        query_string = "SELECT * FROM `{}.letters` LIMIT 1".format(dataset.dataset_id)
+
+        eu_query = client.query(query_string, location="EU", job_config=query_config)
+        self.assertTrue(eu_query.done)
+
+        # Cannot query from US.
+        with self.assertRaises(GoogleAPICallError):
+            list(client.query(query_string, location="US", job_config=query_config))
+
+        # Cannot copy from US.
+        with self.assertRaises(GoogleAPICallError):
+            client.copy_table(
+                table_ref, dataset.table("letters2_us"), location="US"
+            ).result()
+
+        # Cannot extract from US.
+        with self.assertRaises(GoogleAPICallError):
+            client.extract_table(
+                table_ref, "gs://{}/letters-us.csv".format(bucket_name), location="US"
+            ).result()
+
+    def _write_csv_to_storage(self, bucket_name, blob_name, header_row, data_rows):
+        from google.cloud._testing import _NamedTemporaryFile
+
+        bucket = self._create_bucket(bucket_name)
+        blob = bucket.blob(blob_name)
+
+        with _NamedTemporaryFile() as temp:
+            with open(temp.name, "w") as csv_write:
+                writer = csv.writer(csv_write)
+                writer.writerow(header_row)
+                writer.writerows(data_rows)
+
+            with open(temp.name, "rb") as csv_read:
+                retry_storage_errors(blob.upload_from_file)(
+                    csv_read, content_type="text/csv"
+                )
+
+        self.to_delete.insert(0, blob)
+        return "gs://{}/{}".format(bucket_name, blob_name)
+
+    def _write_avro_to_storage(self, bucket_name, blob_name, avro_file):
+        bucket = self._create_bucket(bucket_name)
+        blob = bucket.blob(blob_name)
+        retry_storage_errors(blob.upload_from_file)(
+            avro_file, content_type="application/x-avro-binary"
+        )
+        self.to_delete.insert(0, blob)
+        return "gs://{}/{}".format(bucket_name, blob_name)
+
+    def _load_table_for_extract_table(self, bucket, blob_name, table, rows):
+        from google.cloud._testing import _NamedTemporaryFile
+
+        blob = bucket.blob(blob_name)
+        with _NamedTemporaryFile() as temp:
+            with open(temp.name, "w") as csv_write:
+                writer = csv.writer(csv_write)
+                writer.writerow(HEADER_ROW)
+                writer.writerows(rows)
+
+            with open(temp.name, "rb") as csv_read:
+                retry_storage_errors(blob.upload_from_file)(
+                    csv_read, content_type="text/csv"
+                )
+
+        self.to_delete.insert(0, blob)
+
+        dataset = self.temp_dataset(table.dataset_id)
+        table_ref = dataset.table(table.table_id)
+        config = bigquery.LoadJobConfig()
+        config.autodetect = True
+        gs_url = "gs://{}/{}".format(bucket.name, blob_name)
+        job = Config.CLIENT.load_table_from_uri(gs_url, table_ref, job_config=config)
+        # TODO(jba): do we need this retry now that we have job.result()?
+        # Allow for 90 seconds of "warm up" before rows visible.  See
+        # https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataavailability
+        # 8 tries -> 1 + 2 + 4 + 8 + 16 + 32 + 64 = 127 seconds
+        retry = RetryInstanceState(_job_done, max_tries=8)
+        retry(job.reload)()
+
+    def test_extract_table(self):
+        local_id = unique_resource_id()
+        bucket_name = "bq_extract_test" + local_id
+        source_blob_name = "person_ages.csv"
+        dataset_id = _make_dataset_id("load_gcs_then_extract")
+        table_id = "test_table"
+        table_ref = Config.CLIENT.dataset(dataset_id).table(table_id)
+        table = Table(table_ref)
+        self.to_delete.insert(0, table)
+        bucket = self._create_bucket(bucket_name)
+        self._load_table_for_extract_table(bucket, source_blob_name, table_ref, ROWS)
+        destination_blob_name = "person_ages_out.csv"
+        destination = bucket.blob(destination_blob_name)
+        destination_uri = "gs://{}/person_ages_out.csv".format(bucket_name)
+
+        job = Config.CLIENT.extract_table(table_ref, destination_uri)
+        job.result(timeout=100)
+
+        self.to_delete.insert(0, destination)
+        got_bytes = retry_storage_errors(destination.download_as_string)()
+        got = got_bytes.decode("utf-8")
+        self.assertIn("Bharney Rhubble", got)
+
+    def test_copy_table(self):
+        # If we create a new table to copy from, the test won't work
+        # because the new rows will be stored in the streaming buffer,
+        # and copy jobs don't read the streaming buffer.
+        # We could wait for the streaming buffer to empty, but that could
+        # take minutes. Instead we copy a small public table.
+        source_dataset = DatasetReference("bigquery-public-data", "samples")
+        source_ref = source_dataset.table("shakespeare")
+        dest_dataset = self.temp_dataset(_make_dataset_id("copy_table"))
+        dest_ref = dest_dataset.table("destination_table")
+        job_config = bigquery.CopyJobConfig()
+        job = Config.CLIENT.copy_table(source_ref, dest_ref, job_config=job_config)
+        job.result()
+
+        dest_table = Config.CLIENT.get_table(dest_ref)
+        self.to_delete.insert(0, dest_table)
+        # Just check that we got some rows.
+        got_rows = self._fetch_single_page(dest_table)
+        self.assertTrue(len(got_rows) > 0)
+
+    def test_job_cancel(self):
+        DATASET_ID = _make_dataset_id("job_cancel")
+        JOB_ID_PREFIX = "fetch_" + DATASET_ID
+        TABLE_NAME = "test_table"
+        QUERY = "SELECT * FROM %s.%s" % (DATASET_ID, TABLE_NAME)
+
+        dataset = self.temp_dataset(DATASET_ID)
+
+        table_arg = Table(dataset.table(TABLE_NAME), schema=SCHEMA)
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        job = Config.CLIENT.query(QUERY, job_id_prefix=JOB_ID_PREFIX)
+        job.cancel()
+
+        retry = RetryInstanceState(_job_done, max_tries=8)
+        retry(job.reload)()
+
+        # The `cancel` API doesn't leave any reliable traces on
+        # the status of the job resource, so we can't really assert for
+        # them here.  The best we can do is not that the API call didn't
+        # raise an error, and that the job completed (in the `retry()`
+        # above).
+
+    def test_get_failed_job(self):
+        # issue 4246
+        from google.api_core.exceptions import BadRequest
+
+        JOB_ID = "invalid_{}".format(str(uuid.uuid4()))
+        QUERY = "SELECT TIMESTAMP_ADD(@ts_value, INTERVAL 1 HOUR);"
+        PARAM = bigquery.ScalarQueryParameter("ts_value", "TIMESTAMP", 1.4810976e9)
+
+        job_config = bigquery.QueryJobConfig()
+        job_config.query_parameters = [PARAM]
+
+        with self.assertRaises(BadRequest):
+            Config.CLIENT.query(QUERY, job_id=JOB_ID, job_config=job_config).result()
+
+        job = Config.CLIENT.get_job(JOB_ID)
+
+        with self.assertRaises(ValueError):
+            job.query_parameters
+
+    def test_query_w_legacy_sql_types(self):
+        naive = datetime.datetime(2016, 12, 5, 12, 41, 9)
+        stamp = "%s %s" % (naive.date().isoformat(), naive.time().isoformat())
+        zoned = naive.replace(tzinfo=UTC)
+        examples = [
+            {"sql": "SELECT 1", "expected": 1},
+            {"sql": "SELECT 1.3", "expected": 1.3},
+            {"sql": "SELECT TRUE", "expected": True},
+            {"sql": 'SELECT "ABC"', "expected": "ABC"},
+            {"sql": 'SELECT CAST("foo" AS BYTES)', "expected": b"foo"},
+            {"sql": 'SELECT CAST("%s" AS TIMESTAMP)' % (stamp,), "expected": zoned},
+        ]
+        for example in examples:
+            job_config = bigquery.QueryJobConfig()
+            job_config.use_legacy_sql = True
+            rows = list(Config.CLIENT.query(example["sql"], job_config=job_config))
+            self.assertEqual(len(rows), 1)
+            self.assertEqual(len(rows[0]), 1)
+            self.assertEqual(rows[0][0], example["expected"])
+
+    def _generate_standard_sql_types_examples(self):
+        naive = datetime.datetime(2016, 12, 5, 12, 41, 9)
+        naive_microseconds = datetime.datetime(2016, 12, 5, 12, 41, 9, 250000)
+        stamp = "%s %s" % (naive.date().isoformat(), naive.time().isoformat())
+        stamp_microseconds = stamp + ".250000"
+        zoned = naive.replace(tzinfo=UTC)
+        zoned_microseconds = naive_microseconds.replace(tzinfo=UTC)
+        numeric = decimal.Decimal("123456789.123456789")
+        return [
+            {"sql": "SELECT 1", "expected": 1},
+            {"sql": "SELECT 1.3", "expected": 1.3},
+            {"sql": "SELECT TRUE", "expected": True},
+            {"sql": 'SELECT "ABC"', "expected": "ABC"},
+            {"sql": 'SELECT CAST("foo" AS BYTES)', "expected": b"foo"},
+            {"sql": 'SELECT TIMESTAMP "%s"' % (stamp,), "expected": zoned},
+            {
+                "sql": 'SELECT TIMESTAMP "%s"' % (stamp_microseconds,),
+                "expected": zoned_microseconds,
+            },
+            {"sql": 'SELECT DATETIME(TIMESTAMP "%s")' % (stamp,), "expected": naive},
+            {
+                "sql": 'SELECT DATETIME(TIMESTAMP "%s")' % (stamp_microseconds,),
+                "expected": naive_microseconds,
+            },
+            {"sql": 'SELECT DATE(TIMESTAMP "%s")' % (stamp,), "expected": naive.date()},
+            {"sql": 'SELECT TIME(TIMESTAMP "%s")' % (stamp,), "expected": naive.time()},
+            {"sql": 'SELECT NUMERIC "%s"' % (numeric,), "expected": numeric},
+            {"sql": "SELECT (1, 2)", "expected": {"_field_1": 1, "_field_2": 2}},
+            {
+                "sql": "SELECT ((1, 2), (3, 4), 5)",
+                "expected": {
+                    "_field_1": {"_field_1": 1, "_field_2": 2},
+                    "_field_2": {"_field_1": 3, "_field_2": 4},
+                    "_field_3": 5,
+                },
+            },
+            {"sql": "SELECT [1, 2, 3]", "expected": [1, 2, 3]},
+            {
+                "sql": "SELECT ([1, 2], 3, [4, 5])",
+                "expected": {"_field_1": [1, 2], "_field_2": 3, "_field_3": [4, 5]},
+            },
+            {
+                "sql": "SELECT [(1, 2, 3), (4, 5, 6)]",
+                "expected": [
+                    {"_field_1": 1, "_field_2": 2, "_field_3": 3},
+                    {"_field_1": 4, "_field_2": 5, "_field_3": 6},
+                ],
+            },
+            {
+                "sql": "SELECT [([1, 2, 3], 4), ([5, 6], 7)]",
+                "expected": [
+                    {u"_field_1": [1, 2, 3], u"_field_2": 4},
+                    {u"_field_1": [5, 6], u"_field_2": 7},
+                ],
+            },
+            {
+                "sql": "SELECT ARRAY(SELECT STRUCT([1, 2]))",
+                "expected": [{u"_field_1": [1, 2]}],
+            },
+            {"sql": "SELECT ST_GeogPoint(1, 2)", "expected": "POINT(1 2)"},
+        ]
+
+    def test_query_w_standard_sql_types(self):
+        examples = self._generate_standard_sql_types_examples()
+        for example in examples:
+            rows = list(Config.CLIENT.query(example["sql"]))
+            self.assertEqual(len(rows), 1)
+            self.assertEqual(len(rows[0]), 1)
+            self.assertEqual(rows[0][0], example["expected"])
+
+    def test_query_w_failed_query(self):
+        from google.api_core.exceptions import BadRequest
+
+        with self.assertRaises(BadRequest):
+            Config.CLIENT.query("invalid syntax;").result()
+
+    def test_query_w_wrong_config(self):
+        from google.cloud.bigquery.job import LoadJobConfig
+
+        good_query = "SELECT 1;"
+        rows = list(Config.CLIENT.query("SELECT 1;").result())
+        assert rows[0][0] == 1
+
+        bad_config = LoadJobConfig()
+        bad_config.destination = Config.CLIENT.dataset("dset").table("tbl")
+        with self.assertRaises(Exception):
+            Config.CLIENT.query(good_query, job_config=bad_config).result()
+
+    def test_query_w_timeout(self):
+        query_job = Config.CLIENT.query(
+            "SELECT * FROM `bigquery-public-data.github_repos.commits`;",
+            job_id_prefix="test_query_w_timeout_",
+        )
+
+        with self.assertRaises(concurrent.futures.TimeoutError):
+            # 1 second is much too short for this query.
+            query_job.result(timeout=1)
+
+    def test_query_w_page_size(self):
+        page_size = 45
+        query_job = Config.CLIENT.query(
+            "SELECT word FROM `bigquery-public-data.samples.shakespeare`;",
+            job_id_prefix="test_query_w_page_size_",
+        )
+        iterator = query_job.result(page_size=page_size)
+        self.assertEqual(next(iterator.pages).num_items, page_size)
+
+    def test_query_statistics(self):
+        """
+        A system test to exercise some of the extended query statistics.
+
+        Note:  We construct a query that should need at least three stages by
+        specifying a JOIN query.  Exact plan and stats are effectively
+        non-deterministic, so we're largely interested in confirming values
+        are present.
+        """
+
+        job_config = bigquery.QueryJobConfig()
+        job_config.use_query_cache = False
+
+        query_job = Config.CLIENT.query(
+            """
+            SELECT
+              COUNT(1)
+            FROM
+            (
+              SELECT
+                year,
+                wban_number
+              FROM `bigquery-public-data.samples.gsod`
+              LIMIT 1000
+            ) lside
+            INNER JOIN
+            (
+              SELECT
+                year,
+                state
+              FROM `bigquery-public-data.samples.natality`
+              LIMIT 1000
+            ) rside
+            ON
+            lside.year = rside.year
+            """,
+            location="US",
+            job_config=job_config,
+        )
+
+        # run the job to completion
+        query_job.result()
+
+        # Assert top-level stats
+        self.assertFalse(query_job.cache_hit)
+        self.assertIsNotNone(query_job.destination)
+        self.assertTrue(query_job.done)
+        self.assertFalse(query_job.dry_run)
+        self.assertIsNone(query_job.num_dml_affected_rows)
+        self.assertEqual(query_job.priority, "INTERACTIVE")
+        self.assertGreater(query_job.total_bytes_billed, 1)
+        self.assertGreater(query_job.total_bytes_processed, 1)
+        self.assertEqual(query_job.statement_type, "SELECT")
+        self.assertGreater(query_job.slot_millis, 1)
+
+        # Make assertions on the shape of the query plan.
+        plan = query_job.query_plan
+        self.assertGreaterEqual(len(plan), 3)
+        first_stage = plan[0]
+        self.assertIsNotNone(first_stage.start)
+        self.assertIsNotNone(first_stage.end)
+        self.assertIsNotNone(first_stage.entry_id)
+        self.assertIsNotNone(first_stage.name)
+        self.assertGreater(first_stage.parallel_inputs, 0)
+        self.assertGreater(first_stage.completed_parallel_inputs, 0)
+        self.assertGreater(first_stage.shuffle_output_bytes, 0)
+        self.assertEqual(first_stage.status, "COMPLETE")
+
+        # Query plan is a digraph.  Ensure it has inter-stage links,
+        # but not every stage has inputs.
+        stages_with_inputs = 0
+        for entry in plan:
+            if len(entry.input_stages) > 0:
+                stages_with_inputs = stages_with_inputs + 1
+        self.assertGreater(stages_with_inputs, 0)
+        self.assertGreater(len(plan), stages_with_inputs)
+
+    def test_dbapi_w_standard_sql_types(self):
+        examples = self._generate_standard_sql_types_examples()
+        for example in examples:
+            Config.CURSOR.execute(example["sql"])
+            self.assertEqual(Config.CURSOR.rowcount, 1)
+            row = Config.CURSOR.fetchone()
+            self.assertEqual(len(row), 1)
+            self.assertEqual(row[0], example["expected"])
+            row = Config.CURSOR.fetchone()
+            self.assertIsNone(row)
+
+    def test_dbapi_fetchall(self):
+        query = "SELECT * FROM UNNEST([(1, 2), (3, 4), (5, 6)])"
+
+        for arraysize in range(1, 5):
+            Config.CURSOR.execute(query)
+            self.assertEqual(Config.CURSOR.rowcount, 3, "expected 3 rows")
+            Config.CURSOR.arraysize = arraysize
+            rows = Config.CURSOR.fetchall()
+            row_tuples = [r.values() for r in rows]
+            self.assertEqual(row_tuples, [(1, 2), (3, 4), (5, 6)])
+
+    def _load_table_for_dml(self, rows, dataset_id, table_id):
+        from google.cloud._testing import _NamedTemporaryFile
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        dataset = self.temp_dataset(dataset_id)
+        greeting = bigquery.SchemaField("greeting", "STRING", mode="NULLABLE")
+        table_ref = dataset.table(table_id)
+        table_arg = Table(table_ref, schema=[greeting])
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        with _NamedTemporaryFile() as temp:
+            with open(temp.name, "w") as csv_write:
+                writer = csv.writer(csv_write)
+                writer.writerow(("Greeting",))
+                writer.writerows(rows)
+
+            with open(temp.name, "rb") as csv_read:
+                config = bigquery.LoadJobConfig()
+                config.source_format = SourceFormat.CSV
+                config.skip_leading_rows = 1
+                config.create_disposition = CreateDisposition.CREATE_NEVER
+                config.write_disposition = WriteDisposition.WRITE_EMPTY
+                job = Config.CLIENT.load_table_from_file(
+                    csv_read, table_ref, job_config=config
+                )
+
+        # Retry until done.
+        job.result(timeout=JOB_TIMEOUT)
+        self._fetch_single_page(table)
+
+    def test_query_w_dml(self):
+        dataset_name = _make_dataset_id("dml_query")
+        table_name = "test_table"
+        self._load_table_for_dml([("Hello World",)], dataset_name, table_name)
+        query_template = """UPDATE {}.{}
+            SET greeting = 'Guten Tag'
+            WHERE greeting = 'Hello World'
+            """
+
+        query_job = Config.CLIENT.query(
+            query_template.format(dataset_name, table_name),
+            job_id_prefix="test_query_w_dml_",
+        )
+        query_job.result()
+
+        self.assertEqual(query_job.num_dml_affected_rows, 1)
+
+    def test_dbapi_w_dml(self):
+        dataset_name = _make_dataset_id("dml_dbapi")
+        table_name = "test_table"
+        self._load_table_for_dml([("Hello World",)], dataset_name, table_name)
+        query_template = """UPDATE {}.{}
+            SET greeting = 'Guten Tag'
+            WHERE greeting = 'Hello World'
+            """
+
+        Config.CURSOR.execute(
+            query_template.format(dataset_name, table_name),
+            job_id="test_dbapi_w_dml_{}".format(str(uuid.uuid4())),
+        )
+        self.assertEqual(Config.CURSOR.rowcount, 1)
+        self.assertIsNone(Config.CURSOR.fetchone())
+
+    def test_query_w_query_params(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import ArrayQueryParameter
+        from google.cloud.bigquery.query import ScalarQueryParameter
+        from google.cloud.bigquery.query import StructQueryParameter
+
+        question = "What is the answer to life, the universe, and everything?"
+        question_param = ScalarQueryParameter(
+            name="question", type_="STRING", value=question
+        )
+        answer = 42
+        answer_param = ScalarQueryParameter(name="answer", type_="INT64", value=answer)
+        pi = 3.1415926
+        pi_param = ScalarQueryParameter(name="pi", type_="FLOAT64", value=pi)
+        pi_numeric = decimal.Decimal("3.141592654")
+        pi_numeric_param = ScalarQueryParameter(
+            name="pi_numeric_param", type_="NUMERIC", value=pi_numeric
+        )
+        truthy = True
+        truthy_param = ScalarQueryParameter(name="truthy", type_="BOOL", value=truthy)
+        beef = b"DEADBEEF"
+        beef_param = ScalarQueryParameter(name="beef", type_="BYTES", value=beef)
+        naive = datetime.datetime(2016, 12, 5, 12, 41, 9)
+        naive_param = ScalarQueryParameter(name="naive", type_="DATETIME", value=naive)
+        naive_date_param = ScalarQueryParameter(
+            name="naive_date", type_="DATE", value=naive.date()
+        )
+        naive_time_param = ScalarQueryParameter(
+            name="naive_time", type_="TIME", value=naive.time()
+        )
+        zoned = naive.replace(tzinfo=UTC)
+        zoned_param = ScalarQueryParameter(name="zoned", type_="TIMESTAMP", value=zoned)
+        array_param = ArrayQueryParameter(
+            name="array_param", array_type="INT64", values=[1, 2]
+        )
+        struct_param = StructQueryParameter("hitchhiker", question_param, answer_param)
+        phred_name = "Phred Phlyntstone"
+        phred_name_param = ScalarQueryParameter(
+            name="name", type_="STRING", value=phred_name
+        )
+        phred_age = 32
+        phred_age_param = ScalarQueryParameter(
+            name="age", type_="INT64", value=phred_age
+        )
+        phred_param = StructQueryParameter(None, phred_name_param, phred_age_param)
+        bharney_name = "Bharney Rhubbyl"
+        bharney_name_param = ScalarQueryParameter(
+            name="name", type_="STRING", value=bharney_name
+        )
+        bharney_age = 31
+        bharney_age_param = ScalarQueryParameter(
+            name="age", type_="INT64", value=bharney_age
+        )
+        bharney_param = StructQueryParameter(
+            None, bharney_name_param, bharney_age_param
+        )
+        characters_param = ArrayQueryParameter(
+            name=None, array_type="RECORD", values=[phred_param, bharney_param]
+        )
+        hero_param = StructQueryParameter("hero", phred_name_param, phred_age_param)
+        sidekick_param = StructQueryParameter(
+            "sidekick", bharney_name_param, bharney_age_param
+        )
+        roles_param = StructQueryParameter("roles", hero_param, sidekick_param)
+        friends_param = ArrayQueryParameter(
+            name="friends", array_type="STRING", values=[phred_name, bharney_name]
+        )
+        with_friends_param = StructQueryParameter(None, friends_param)
+        top_left_param = StructQueryParameter(
+            "top_left",
+            ScalarQueryParameter("x", "INT64", 12),
+            ScalarQueryParameter("y", "INT64", 102),
+        )
+        bottom_right_param = StructQueryParameter(
+            "bottom_right",
+            ScalarQueryParameter("x", "INT64", 22),
+            ScalarQueryParameter("y", "INT64", 92),
+        )
+        rectangle_param = StructQueryParameter(
+            "rectangle", top_left_param, bottom_right_param
+        )
+        examples = [
+            {
+                "sql": "SELECT @question",
+                "expected": question,
+                "query_parameters": [question_param],
+            },
+            {
+                "sql": "SELECT @answer",
+                "expected": answer,
+                "query_parameters": [answer_param],
+            },
+            {"sql": "SELECT @pi", "expected": pi, "query_parameters": [pi_param]},
+            {
+                "sql": "SELECT @pi_numeric_param",
+                "expected": pi_numeric,
+                "query_parameters": [pi_numeric_param],
+            },
+            {
+                "sql": "SELECT @truthy",
+                "expected": truthy,
+                "query_parameters": [truthy_param],
+            },
+            {"sql": "SELECT @beef", "expected": beef, "query_parameters": [beef_param]},
+            {
+                "sql": "SELECT @naive",
+                "expected": naive,
+                "query_parameters": [naive_param],
+            },
+            {
+                "sql": "SELECT @naive_date",
+                "expected": naive.date(),
+                "query_parameters": [naive_date_param],
+            },
+            {
+                "sql": "SELECT @naive_time",
+                "expected": naive.time(),
+                "query_parameters": [naive_time_param],
+            },
+            {
+                "sql": "SELECT @zoned",
+                "expected": zoned,
+                "query_parameters": [zoned_param],
+            },
+            {
+                "sql": "SELECT @array_param",
+                "expected": [1, 2],
+                "query_parameters": [array_param],
+            },
+            {
+                "sql": "SELECT (@hitchhiker.question, @hitchhiker.answer)",
+                "expected": ({"_field_1": question, "_field_2": answer}),
+                "query_parameters": [struct_param],
+            },
+            {
+                "sql": "SELECT "
+                "((@rectangle.bottom_right.x - @rectangle.top_left.x) "
+                "* (@rectangle.top_left.y - @rectangle.bottom_right.y))",
+                "expected": 100,
+                "query_parameters": [rectangle_param],
+            },
+            {
+                "sql": "SELECT ?",
+                "expected": [
+                    {"name": phred_name, "age": phred_age},
+                    {"name": bharney_name, "age": bharney_age},
+                ],
+                "query_parameters": [characters_param],
+            },
+            {
+                "sql": "SELECT @roles",
+                "expected": {
+                    "hero": {"name": phred_name, "age": phred_age},
+                    "sidekick": {"name": bharney_name, "age": bharney_age},
+                },
+                "query_parameters": [roles_param],
+            },
+            {
+                "sql": "SELECT ?",
+                "expected": {"friends": [phred_name, bharney_name]},
+                "query_parameters": [with_friends_param],
+            },
+        ]
+        for example in examples:
+            jconfig = QueryJobConfig()
+            jconfig.query_parameters = example["query_parameters"]
+            query_job = Config.CLIENT.query(
+                example["sql"],
+                job_config=jconfig,
+                job_id_prefix="test_query_w_query_params",
+            )
+            rows = list(query_job.result())
+            self.assertEqual(len(rows), 1)
+            self.assertEqual(len(rows[0]), 1)
+            self.assertEqual(rows[0][0], example["expected"])
+
+    def test_dbapi_w_query_parameters(self):
+        examples = [
+            {
+                "sql": "SELECT %(boolval)s",
+                "expected": True,
+                "query_parameters": {"boolval": True},
+            },
+            {
+                "sql": 'SELECT %(a "very" weird `name`)s',
+                "expected": True,
+                "query_parameters": {'a "very" weird `name`': True},
+            },
+            {
+                "sql": "SELECT %(select)s",
+                "expected": True,
+                "query_parameters": {"select": True},  # this name is a keyword
+            },
+            {"sql": "SELECT %s", "expected": False, "query_parameters": [False]},
+            {
+                "sql": "SELECT %(intval)s",
+                "expected": 123,
+                "query_parameters": {"intval": 123},
+            },
+            {
+                "sql": "SELECT %s",
+                "expected": -123456789,
+                "query_parameters": [-123456789],
+            },
+            {
+                "sql": "SELECT %(floatval)s",
+                "expected": 1.25,
+                "query_parameters": {"floatval": 1.25},
+            },
+            {
+                "sql": "SELECT LOWER(%(strval)s)",
+                "query_parameters": {"strval": "I Am A String"},
+                "expected": "i am a string",
+            },
+            {
+                "sql": "SELECT DATE_SUB(%(dateval)s, INTERVAL 1 DAY)",
+                "query_parameters": {"dateval": datetime.date(2017, 4, 2)},
+                "expected": datetime.date(2017, 4, 1),
+            },
+            {
+                "sql": "SELECT TIME_ADD(%(timeval)s, INTERVAL 4 SECOND)",
+                "query_parameters": {"timeval": datetime.time(12, 34, 56)},
+                "expected": datetime.time(12, 35, 0),
+            },
+            {
+                "sql": ("SELECT DATETIME_ADD(%(datetimeval)s, INTERVAL 53 SECOND)"),
+                "query_parameters": {
+                    "datetimeval": datetime.datetime(2012, 3, 4, 5, 6, 7)
+                },
+                "expected": datetime.datetime(2012, 3, 4, 5, 7, 0),
+            },
+            {
+                "sql": "SELECT TIMESTAMP_TRUNC(%(zoned)s, MINUTE)",
+                "query_parameters": {
+                    "zoned": datetime.datetime(2012, 3, 4, 5, 6, 7, tzinfo=UTC)
+                },
+                "expected": datetime.datetime(2012, 3, 4, 5, 6, 0, tzinfo=UTC),
+            },
+            {
+                "sql": "SELECT TIMESTAMP_TRUNC(%(zoned)s, MINUTE)",
+                "query_parameters": {
+                    "zoned": datetime.datetime(2012, 3, 4, 5, 6, 7, 250000, tzinfo=UTC)
+                },
+                "expected": datetime.datetime(2012, 3, 4, 5, 6, 0, tzinfo=UTC),
+            },
+        ]
+        for example in examples:
+            msg = "sql: {} query_parameters: {}".format(
+                example["sql"], example["query_parameters"]
+            )
+
+            Config.CURSOR.execute(example["sql"], example["query_parameters"])
+
+            self.assertEqual(Config.CURSOR.rowcount, 1, msg=msg)
+            row = Config.CURSOR.fetchone()
+            self.assertEqual(len(row), 1, msg=msg)
+            self.assertEqual(row[0], example["expected"], msg=msg)
+            row = Config.CURSOR.fetchone()
+            self.assertIsNone(row, msg=msg)
+
+    def test_large_query_w_public_data(self):
+        PUBLIC = "bigquery-public-data"
+        DATASET_ID = "samples"
+        TABLE_NAME = "natality"
+        LIMIT = 1000
+        SQL = "SELECT * from `{}.{}.{}` LIMIT {}".format(
+            PUBLIC, DATASET_ID, TABLE_NAME, LIMIT
+        )
+
+        query_job = Config.CLIENT.query(SQL)
+
+        rows = list(query_job)
+        self.assertEqual(len(rows), LIMIT)
+
+    def test_query_future(self):
+        query_job = Config.CLIENT.query("SELECT 1")
+        iterator = query_job.result(timeout=JOB_TIMEOUT)
+        row_tuples = [r.values() for r in iterator]
+        self.assertEqual(row_tuples, [(1,)])
+
+    def test_query_iter(self):
+        import types
+
+        query_job = Config.CLIENT.query("SELECT 1")
+        self.assertIsInstance(iter(query_job), types.GeneratorType)
+        row_tuples = [r.values() for r in query_job]
+        self.assertEqual(row_tuples, [(1,)])
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_query_results_to_dataframe(self):
+        QUERY = """
+            SELECT id, author, time_ts, dead
+            FROM `bigquery-public-data.hacker_news.comments`
+            LIMIT 10
+        """
+
+        df = Config.CLIENT.query(QUERY).result().to_dataframe()
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 10)  # verify the number of rows
+        column_names = ["id", "author", "time_ts", "dead"]
+        self.assertEqual(list(df), column_names)  # verify the column names
+        exp_datatypes = {
+            "id": int,
+            "author": six.text_type,
+            "time_ts": pandas.Timestamp,
+            "dead": bool,
+        }
+        for index, row in df.iterrows():
+            for col in column_names:
+                # all the schema fields are nullable, so None is acceptable
+                if not row[col] is None:
+                    self.assertIsInstance(row[col], exp_datatypes[col])
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_query_results_to_dataframe_w_bqstorage(self):
+        dest_dataset = self.temp_dataset(_make_dataset_id("bqstorage_to_dataframe_"))
+        dest_ref = dest_dataset.table("query_results")
+
+        query = """
+            SELECT id, author, time_ts, dead
+            FROM `bigquery-public-data.hacker_news.comments`
+            LIMIT 10
+        """
+
+        bqstorage_client = bigquery_storage_v1beta1.BigQueryStorageClient(
+            credentials=Config.CLIENT._credentials
+        )
+
+        job_configs = (
+            # There is a known issue reading small anonymous query result
+            # tables with the BQ Storage API. Writing to a destination
+            # table works around this issue.
+            bigquery.QueryJobConfig(
+                destination=dest_ref, write_disposition="WRITE_TRUNCATE"
+            ),
+            # Check that the client is able to work around the issue with
+            # reading small anonymous query result tables by falling back to
+            # the tabledata.list API.
+            None,
+        )
+
+        for job_config in job_configs:
+            df = (
+                Config.CLIENT.query(query, job_config=job_config)
+                .result()
+                .to_dataframe(bqstorage_client)
+            )
+
+            self.assertIsInstance(df, pandas.DataFrame)
+            self.assertEqual(len(df), 10)  # verify the number of rows
+            column_names = ["id", "author", "time_ts", "dead"]
+            self.assertEqual(list(df), column_names)
+            exp_datatypes = {
+                "id": int,
+                "author": six.text_type,
+                "time_ts": pandas.Timestamp,
+                "dead": bool,
+            }
+            for index, row in df.iterrows():
+                for col in column_names:
+                    # all the schema fields are nullable, so None is acceptable
+                    if not row[col] is None:
+                        self.assertIsInstance(row[col], exp_datatypes[col])
+
+    def test_insert_rows_nested_nested(self):
+        # See #2951
+        SF = bigquery.SchemaField
+        schema = [
+            SF("string_col", "STRING", mode="NULLABLE"),
+            SF(
+                "record_col",
+                "RECORD",
+                mode="NULLABLE",
+                fields=[
+                    SF("nested_string", "STRING", mode="NULLABLE"),
+                    SF("nested_repeated", "INTEGER", mode="REPEATED"),
+                    SF(
+                        "nested_record",
+                        "RECORD",
+                        mode="NULLABLE",
+                        fields=[SF("nested_nested_string", "STRING", mode="NULLABLE")],
+                    ),
+                ],
+            ),
+        ]
+        record = {
+            "nested_string": "another string value",
+            "nested_repeated": [0, 1, 2],
+            "nested_record": {"nested_nested_string": "some deep insight"},
+        }
+        to_insert = [("Some value", record)]
+        table_id = "test_table"
+        dataset = self.temp_dataset(_make_dataset_id("issue_2951"))
+        table_arg = Table(dataset.table(table_id), schema=schema)
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        Config.CLIENT.insert_rows(table, to_insert)
+
+        retry = RetryResult(_has_rows, max_tries=8)
+        rows = retry(self._fetch_single_page)(table)
+        row_tuples = [r.values() for r in rows]
+        self.assertEqual(row_tuples, to_insert)
+
+    def test_insert_rows_nested_nested_dictionary(self):
+        # See #2951
+        SF = bigquery.SchemaField
+        schema = [
+            SF("string_col", "STRING", mode="NULLABLE"),
+            SF(
+                "record_col",
+                "RECORD",
+                mode="NULLABLE",
+                fields=[
+                    SF("nested_string", "STRING", mode="NULLABLE"),
+                    SF("nested_repeated", "INTEGER", mode="REPEATED"),
+                    SF(
+                        "nested_record",
+                        "RECORD",
+                        mode="NULLABLE",
+                        fields=[SF("nested_nested_string", "STRING", mode="NULLABLE")],
+                    ),
+                ],
+            ),
+        ]
+        record = {
+            "nested_string": "another string value",
+            "nested_repeated": [0, 1, 2],
+            "nested_record": {"nested_nested_string": "some deep insight"},
+        }
+        to_insert = [{"string_col": "Some value", "record_col": record}]
+        table_id = "test_table"
+        dataset = self.temp_dataset(_make_dataset_id("issue_2951"))
+        table_arg = Table(dataset.table(table_id), schema=schema)
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+
+        Config.CLIENT.insert_rows(table, to_insert)
+
+        retry = RetryResult(_has_rows, max_tries=8)
+        rows = retry(self._fetch_single_page)(table)
+        row_tuples = [r.values() for r in rows]
+        expected_rows = [("Some value", record)]
+        self.assertEqual(row_tuples, expected_rows)
+
+    def test_create_routine(self):
+        routine_name = "test_routine"
+        dataset = self.temp_dataset(_make_dataset_id("create_routine"))
+        float64_type = bigquery_v2.types.StandardSqlDataType(
+            type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.FLOAT64
+        )
+        routine = bigquery.Routine(
+            dataset.routine(routine_name),
+            language="JAVASCRIPT",
+            type_="SCALAR_FUNCTION",
+            return_type=float64_type,
+            imported_libraries=[
+                "gs://{}/bigquery/udfs/max-value.js".format(SAMPLES_BUCKET)
+            ],
+        )
+        routine.arguments = [
+            bigquery.RoutineArgument(
+                name="arr",
+                data_type=bigquery_v2.types.StandardSqlDataType(
+                    type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.ARRAY,
+                    array_element_type=float64_type,
+                ),
+            )
+        ]
+        routine.body = "return maxValue(arr)"
+        query_string = "SELECT `{}`([-100.0, 3.14, 100.0, 42.0]) as max_value;".format(
+            str(routine.reference)
+        )
+
+        routine = retry_403(Config.CLIENT.create_routine)(routine)
+        query_job = retry_403(Config.CLIENT.query)(query_string)
+        rows = list(query_job.result())
+
+        assert len(rows) == 1
+        assert rows[0].max_value == 100.0
+
+    def test_create_table_rows_fetch_nested_schema(self):
+        table_name = "test_table"
+        dataset = self.temp_dataset(_make_dataset_id("create_table_nested_schema"))
+        schema = _load_json_schema()
+        table_arg = Table(dataset.table(table_name), schema=schema)
+        table = retry_403(Config.CLIENT.create_table)(table_arg)
+        self.to_delete.insert(0, table)
+        self.assertTrue(_table_exists(table))
+        self.assertEqual(table.table_id, table_name)
+
+        to_insert = []
+        # Data is in "JSON Lines" format, see http://jsonlines.org/
+        json_filename = os.path.join(WHERE, "data", "characters.jsonl")
+        with open(json_filename) as rows_file:
+            for line in rows_file:
+                to_insert.append(json.loads(line))
+
+        errors = Config.CLIENT.insert_rows_json(table, to_insert)
+        self.assertEqual(len(errors), 0)
+
+        retry = RetryResult(_has_rows, max_tries=8)
+        fetched = retry(self._fetch_single_page)(table)
+        fetched_tuples = [f.values() for f in fetched]
+
+        self.assertEqual(len(fetched), len(to_insert))
+
+        for found, expected in zip(sorted(fetched_tuples), to_insert):
+            self.assertEqual(found[0], expected["Name"])
+            self.assertEqual(found[1], int(expected["Age"]))
+            self.assertEqual(found[2], expected["Weight"])
+            self.assertEqual(found[3], expected["IsMagic"])
+
+            self.assertEqual(len(found[4]), len(expected["Spells"]))
+            for f_spell, e_spell in zip(found[4], expected["Spells"]):
+                self.assertEqual(f_spell["Name"], e_spell["Name"])
+                parts = time.strptime(e_spell["LastUsed"], "%Y-%m-%d %H:%M:%S UTC")
+                e_used = datetime.datetime(*parts[0:6], tzinfo=UTC)
+                self.assertEqual(f_spell["LastUsed"], e_used)
+                self.assertEqual(f_spell["DiscoveredBy"], e_spell["DiscoveredBy"])
+                self.assertEqual(f_spell["Properties"], e_spell["Properties"])
+
+                e_icon = base64.standard_b64decode(e_spell["Icon"].encode("ascii"))
+                self.assertEqual(f_spell["Icon"], e_icon)
+
+            parts = time.strptime(expected["TeaTime"], "%H:%M:%S")
+            e_teatime = datetime.time(*parts[3:6])
+            self.assertEqual(found[5], e_teatime)
+
+            parts = time.strptime(expected["NextVacation"], "%Y-%m-%d")
+            e_nextvac = datetime.date(*parts[0:3])
+            self.assertEqual(found[6], e_nextvac)
+
+            parts = time.strptime(expected["FavoriteTime"], "%Y-%m-%dT%H:%M:%S")
+            e_favtime = datetime.datetime(*parts[0:6])
+            self.assertEqual(found[7], e_favtime)
+            self.assertEqual(found[8], decimal.Decimal(expected["FavoriteNumber"]))
+
+    def _fetch_dataframe(self, query):
+        return Config.CLIENT.query(query).result().to_dataframe()
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_nested_table_to_arrow(self):
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        SF = bigquery.SchemaField
+        schema = [
+            SF("string_col", "STRING", mode="NULLABLE"),
+            SF(
+                "record_col",
+                "RECORD",
+                mode="NULLABLE",
+                fields=[
+                    SF("nested_string", "STRING", mode="NULLABLE"),
+                    SF("nested_repeated", "INTEGER", mode="REPEATED"),
+                ],
+            ),
+            SF("float_col", "FLOAT", mode="NULLABLE"),
+        ]
+        record = {"nested_string": "another string value", "nested_repeated": [0, 1, 2]}
+        to_insert = [
+            {"string_col": "Some value", "record_col": record, "float_col": 3.14}
+        ]
+        rows = [json.dumps(row) for row in to_insert]
+        body = six.BytesIO("{}\n".format("\n".join(rows)).encode("ascii"))
+        table_id = "test_table"
+        dataset = self.temp_dataset(_make_dataset_id("nested_df"))
+        table = dataset.table(table_id)
+        self.to_delete.insert(0, table)
+        job_config = bigquery.LoadJobConfig()
+        job_config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+        job_config.source_format = SourceFormat.NEWLINE_DELIMITED_JSON
+        job_config.schema = schema
+        # Load a table using a local JSON file from memory.
+        Config.CLIENT.load_table_from_file(body, table, job_config=job_config).result()
+        bqstorage_client = bigquery_storage_v1beta1.BigQueryStorageClient(
+            credentials=Config.CLIENT._credentials
+        )
+
+        tbl = Config.CLIENT.list_rows(table, selected_fields=schema).to_arrow(
+            bqstorage_client=bqstorage_client
+        )
+
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 1)
+        self.assertEqual(tbl.num_columns, 3)
+        # Columns may not appear in the requested order.
+        self.assertTrue(
+            pyarrow.types.is_float64(tbl.schema.field_by_name("float_col").type)
+        )
+        self.assertTrue(
+            pyarrow.types.is_string(tbl.schema.field_by_name("string_col").type)
+        )
+        record_col = tbl.schema.field_by_name("record_col").type
+        self.assertTrue(pyarrow.types.is_struct(record_col))
+        self.assertEqual(record_col.num_children, 2)
+        self.assertEqual(record_col[0].name, "nested_string")
+        self.assertTrue(pyarrow.types.is_string(record_col[0].type))
+        self.assertEqual(record_col[1].name, "nested_repeated")
+        self.assertTrue(pyarrow.types.is_list(record_col[1].type))
+        self.assertTrue(pyarrow.types.is_int64(record_col[1].type.value_type))
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_nested_table_to_dataframe(self):
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        SF = bigquery.SchemaField
+        schema = [
+            SF("string_col", "STRING", mode="NULLABLE"),
+            SF(
+                "record_col",
+                "RECORD",
+                mode="NULLABLE",
+                fields=[
+                    SF("nested_string", "STRING", mode="NULLABLE"),
+                    SF("nested_repeated", "INTEGER", mode="REPEATED"),
+                    SF(
+                        "nested_record",
+                        "RECORD",
+                        mode="NULLABLE",
+                        fields=[SF("nested_nested_string", "STRING", mode="NULLABLE")],
+                    ),
+                ],
+            ),
+            SF("bigfloat_col", "FLOAT", mode="NULLABLE"),
+            SF("smallfloat_col", "FLOAT", mode="NULLABLE"),
+        ]
+        record = {
+            "nested_string": "another string value",
+            "nested_repeated": [0, 1, 2],
+            "nested_record": {"nested_nested_string": "some deep insight"},
+        }
+        to_insert = [
+            {
+                "string_col": "Some value",
+                "record_col": record,
+                "bigfloat_col": 3.14,
+                "smallfloat_col": 2.72,
+            }
+        ]
+        rows = [json.dumps(row) for row in to_insert]
+        body = six.BytesIO("{}\n".format("\n".join(rows)).encode("ascii"))
+        table_id = "test_table"
+        dataset = self.temp_dataset(_make_dataset_id("nested_df"))
+        table = dataset.table(table_id)
+        self.to_delete.insert(0, table)
+        job_config = bigquery.LoadJobConfig()
+        job_config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+        job_config.source_format = SourceFormat.NEWLINE_DELIMITED_JSON
+        job_config.schema = schema
+        # Load a table using a local JSON file from memory.
+        Config.CLIENT.load_table_from_file(body, table, job_config=job_config).result()
+
+        df = Config.CLIENT.list_rows(table, selected_fields=schema).to_dataframe(
+            dtypes={"smallfloat_col": "float16"}
+        )
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 1)  # verify the number of rows
+        exp_columns = ["string_col", "record_col", "bigfloat_col", "smallfloat_col"]
+        self.assertEqual(list(df), exp_columns)  # verify the column names
+        row = df.iloc[0]
+        # verify the row content
+        self.assertEqual(row["string_col"], "Some value")
+        self.assertEqual(row["record_col"], record)
+        # verify that nested data can be accessed with indices/keys
+        self.assertEqual(row["record_col"]["nested_repeated"][0], 0)
+        self.assertEqual(
+            row["record_col"]["nested_record"]["nested_nested_string"],
+            "some deep insight",
+        )
+        # verify dtypes
+        self.assertEqual(df.dtypes["bigfloat_col"].name, "float64")
+        self.assertEqual(df.dtypes["smallfloat_col"].name, "float16")
+
+    def test_list_rows_empty_table(self):
+        from google.cloud.bigquery.table import RowIterator
+
+        dataset_id = _make_dataset_id("empty_table")
+        dataset = self.temp_dataset(dataset_id)
+        table_ref = dataset.table("empty_table")
+        table = Config.CLIENT.create_table(bigquery.Table(table_ref))
+
+        # It's a bit silly to list rows for an empty table, but this does
+        # happen as the result of a DDL query from an IPython magic command.
+        rows = Config.CLIENT.list_rows(table)
+        self.assertIsInstance(rows, RowIterator)
+        self.assertEqual(tuple(rows), ())
+
+    def test_list_rows_page_size(self):
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.job import WriteDisposition
+
+        num_items = 7
+        page_size = 3
+        num_pages, num_last_page = divmod(num_items, page_size)
+
+        SF = bigquery.SchemaField
+        schema = [SF("string_col", "STRING", mode="NULLABLE")]
+        to_insert = [{"string_col": "item%d" % i} for i in range(num_items)]
+        rows = [json.dumps(row) for row in to_insert]
+        body = six.BytesIO("{}\n".format("\n".join(rows)).encode("ascii"))
+
+        table_id = "test_table"
+        dataset = self.temp_dataset(_make_dataset_id("nested_df"))
+        table = dataset.table(table_id)
+        self.to_delete.insert(0, table)
+        job_config = bigquery.LoadJobConfig()
+        job_config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+        job_config.source_format = SourceFormat.NEWLINE_DELIMITED_JSON
+        job_config.schema = schema
+        # Load a table using a local JSON file from memory.
+        Config.CLIENT.load_table_from_file(body, table, job_config=job_config).result()
+
+        df = Config.CLIENT.list_rows(table, selected_fields=schema, page_size=page_size)
+        pages = df.pages
+
+        for i in range(num_pages):
+            page = next(pages)
+            self.assertEqual(page.num_items, page_size)
+        page = next(pages)
+        self.assertEqual(page.num_items, num_last_page)
+
+    def temp_dataset(self, dataset_id, location=None):
+        dataset = Dataset(Config.CLIENT.dataset(dataset_id))
+        if location:
+            dataset.location = location
+        dataset = retry_403(Config.CLIENT.create_dataset)(dataset)
+        self.to_delete.append(dataset)
+        return dataset
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(IPython is None, reason="Requires `ipython`")
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    sql = """
+        SELECT
+            CONCAT(
+            'https://stackoverflow.com/questions/',
+            CAST(id as STRING)) as url,
+            view_count
+        FROM `bigquery-public-data.stackoverflow.posts_questions`
+        WHERE tags like '%google-bigquery%'
+        ORDER BY view_count DESC
+        LIMIT 10
+    """
+    with io.capture_output() as captured:
+        result = ip.run_cell_magic("bigquery", "", sql)
+
+    lines = re.split("\n|\r", captured.stdout)
+    # Removes blanks & terminal code (result of display clearing)
+    updates = list(filter(lambda x: bool(x) and x != "\x1b[2K", lines))
+    assert re.match("Executing query with job ID: .*", updates[0])
+    assert all(re.match("Query executing: .*s", line) for line in updates[1:-1])
+    assert re.match("Query complete after .*s", updates[-1])
+    assert isinstance(result, pandas.DataFrame)
+    assert len(result) == 10  # verify row count
+    assert list(result) == ["url", "view_count"]  # verify column names
+
+
+def _job_done(instance):
+    return instance.state.lower() == "done"
+
+
+def _dataset_exists(ds):
+    try:
+        Config.CLIENT.get_dataset(DatasetReference(ds.project, ds.dataset_id))
+        return True
+    except NotFound:
+        return False
+
+
+def _table_exists(t):
+    try:
+        tr = DatasetReference(t.project, t.dataset_id).table(t.table_id)
+        Config.CLIENT.get_table(tr)
+        return True
+    except NotFound:
+        return False
+
+
+@pytest.fixture(scope="session")
+def ipython():
+    config = tools.default_config()
+    config.TerminalInteractiveShell.simple_prompt = True
+    shell = interactiveshell.TerminalInteractiveShell.instance(config=config)
+    return shell
+
+
+@pytest.fixture()
+def ipython_interactive(request, ipython):
+    """Activate IPython's builtin hooks
+
+    for the duration of the test scope.
+    """
+    with ipython.builtin_trap:
+        yield ipython
diff --git a/bigquery/tests/unit/__init__.py b/bigquery/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/bigquery/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/bigquery/tests/unit/enums/__init__.py b/bigquery/tests/unit/enums/__init__.py
new file mode 100644
index 000000000000..c5cce043083c
--- /dev/null
+++ b/bigquery/tests/unit/enums/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2019, Google LLC 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.
diff --git a/bigquery/tests/unit/enums/test_standard_sql_data_types.py b/bigquery/tests/unit/enums/test_standard_sql_data_types.py
new file mode 100644
index 000000000000..6fa4f057fb98
--- /dev/null
+++ b/bigquery/tests/unit/enums/test_standard_sql_data_types.py
@@ -0,0 +1,73 @@
+# 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.
+
+import pytest
+
+
+@pytest.fixture
+def module_under_test():
+    from google.cloud.bigquery import enums
+
+    return enums
+
+
+@pytest.fixture
+def enum_under_test():
+    from google.cloud.bigquery.enums import StandardSqlDataTypes
+
+    return StandardSqlDataTypes
+
+
+@pytest.fixture
+def gapic_enum():
+    """The referential autogenerated enum the enum under test is based on."""
+    from google.cloud.bigquery_v2.gapic.enums import StandardSqlDataType
+
+    return StandardSqlDataType.TypeKind
+
+
+def test_all_gapic_enum_members_are_known(module_under_test, gapic_enum):
+    gapic_names = set(type_.name for type_ in gapic_enum)
+    anticipated_names = (
+        module_under_test._SQL_SCALAR_TYPES | module_under_test._SQL_NONSCALAR_TYPES
+    )
+    assert not (gapic_names - anticipated_names)  # no unhandled names
+
+
+def test_standard_sql_types_enum_members(enum_under_test, gapic_enum):
+    # check the presence of a few typical SQL types
+    for name in ("INT64", "FLOAT64", "DATE", "BOOL", "GEOGRAPHY"):
+        assert name in enum_under_test.__members__
+
+    # the enum members must match those in the original gapic enum
+    for member in enum_under_test:
+        assert member.name in gapic_enum.__members__
+        assert member.value == gapic_enum[member.name].value
+
+    # check a few members that should *not* be copied over from the gapic enum
+    for name in ("STRUCT", "ARRAY"):
+        assert name in gapic_enum.__members__
+        assert name not in enum_under_test.__members__
+
+
+def test_standard_sql_types_enum_docstring(enum_under_test, gapic_enum):
+    assert "STRUCT (int):" not in enum_under_test.__doc__
+    assert "BOOL (int):" in enum_under_test.__doc__
+    assert "TIME (int):" in enum_under_test.__doc__
+
+    # All lines in the docstring should actually come from the original docstring,
+    # except for the header.
+    assert "An Enum of scalar SQL types." in enum_under_test.__doc__
+    doc_lines = enum_under_test.__doc__.splitlines()
+    assert set(doc_lines[1:]) <= set(gapic_enum.__doc__.splitlines())
diff --git a/bigquery/tests/unit/helpers.py b/bigquery/tests/unit/helpers.py
new file mode 100644
index 000000000000..5b731a763a99
--- /dev/null
+++ b/bigquery/tests/unit/helpers.py
@@ -0,0 +1,24 @@
+# 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.
+
+
+def make_connection(*responses):
+    import google.cloud.bigquery._http
+    import mock
+    from google.cloud.exceptions import NotFound
+
+    mock_conn = mock.create_autospec(google.cloud.bigquery._http.Connection)
+    mock_conn.user_agent = "testing 1.2.3"
+    mock_conn.api_request.side_effect = list(responses) + [NotFound("miss")]
+    return mock_conn
diff --git a/bigquery/tests/unit/model/__init__.py b/bigquery/tests/unit/model/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/tests/unit/model/test_model.py b/bigquery/tests/unit/model/test_model.py
new file mode 100644
index 000000000000..b6d9756e15fe
--- /dev/null
+++ b/bigquery/tests/unit/model/test_model.py
@@ -0,0 +1,292 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+
+import pytest
+
+import google.cloud._helpers
+from google.cloud.bigquery_v2.gapic import enums
+
+
+@pytest.fixture
+def target_class():
+    from google.cloud.bigquery import Model
+
+    return Model
+
+
+@pytest.fixture
+def object_under_test(target_class):
+    return target_class("project-id.dataset_id.model_id")
+
+
+def test_ctor(target_class):
+    from google.cloud.bigquery import ModelReference
+
+    ref = ModelReference.from_string("my-proj.my_dset.my_model")
+    got = target_class(ref)
+    assert got.reference == ref
+
+
+def test_ctor_string(target_class):
+    from google.cloud.bigquery import ModelReference
+
+    model_id = "my-proj.my_dset.my_model"
+    ref = ModelReference.from_string(model_id)
+    got = target_class(model_id)
+    assert got.reference == ref
+
+
+def test_from_api_repr(target_class):
+    from google.cloud.bigquery import ModelReference
+
+    creation_time = datetime.datetime(
+        2010, 5, 19, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+    )
+    modified_time = datetime.datetime(
+        2011, 10, 1, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+    )
+    expiration_time = datetime.datetime(
+        2012, 12, 21, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+    )
+    resource = {
+        "modelReference": {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "modelId": "my_model",
+        },
+        "location": "US",
+        "etag": "abcdefg",
+        "creationTime": str(google.cloud._helpers._millis(creation_time)),
+        "lastModifiedTime": str(google.cloud._helpers._millis(modified_time)),
+        "expirationTime": str(google.cloud._helpers._millis(expiration_time)),
+        "description": "A friendly description.",
+        "friendlyName": "A friendly name.",
+        "modelType": "LOGISTIC_REGRESSION",
+        "labels": {"greeting": u"こんにちは"},
+        "trainingRuns": [
+            {
+                "trainingOptions": {"initialLearnRate": 1.0},
+                "startTime": str(
+                    google.cloud._helpers._datetime_to_rfc3339(creation_time)
+                ),
+            },
+            {
+                "trainingOptions": {"initialLearnRate": 0.5},
+                "startTime": str(
+                    google.cloud._helpers._datetime_to_rfc3339(modified_time)
+                ),
+            },
+            {
+                "trainingOptions": {"initialLearnRate": 0.25},
+                # Allow milliseconds since epoch format.
+                # TODO: Remove this hack once CL 238585470 hits prod.
+                "startTime": str(google.cloud._helpers._millis(expiration_time)),
+            },
+        ],
+        "featureColumns": [],
+    }
+    got = target_class.from_api_repr(resource)
+
+    assert got.project == "my-project"
+    assert got.dataset_id == "my_dataset"
+    assert got.model_id == "my_model"
+    assert got.reference == ModelReference.from_string("my-project.my_dataset.my_model")
+    assert got.path == "/projects/my-project/datasets/my_dataset/models/my_model"
+    assert got.location == "US"
+    assert got.etag == "abcdefg"
+    assert got.created == creation_time
+    assert got.modified == modified_time
+    assert got.expires == expiration_time
+    assert got.description == u"A friendly description."
+    assert got.friendly_name == u"A friendly name."
+    assert got.model_type == enums.Model.ModelType.LOGISTIC_REGRESSION
+    assert got.labels == {"greeting": u"こんにちは"}
+    assert got.training_runs[0].training_options.initial_learn_rate == 1.0
+    assert (
+        got.training_runs[0]
+        .start_time.ToDatetime()
+        .replace(tzinfo=google.cloud._helpers.UTC)
+        == creation_time
+    )
+    assert got.training_runs[1].training_options.initial_learn_rate == 0.5
+    assert (
+        got.training_runs[1]
+        .start_time.ToDatetime()
+        .replace(tzinfo=google.cloud._helpers.UTC)
+        == modified_time
+    )
+    assert got.training_runs[2].training_options.initial_learn_rate == 0.25
+    assert (
+        got.training_runs[2]
+        .start_time.ToDatetime()
+        .replace(tzinfo=google.cloud._helpers.UTC)
+        == expiration_time
+    )
+
+
+def test_from_api_repr_w_minimal_resource(target_class):
+    from google.cloud.bigquery import ModelReference
+
+    resource = {
+        "modelReference": {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "modelId": "my_model",
+        }
+    }
+    got = target_class.from_api_repr(resource)
+    assert got.reference == ModelReference.from_string("my-project.my_dataset.my_model")
+    assert got.location == ""
+    assert got.etag == ""
+    assert got.created is None
+    assert got.modified is None
+    assert got.expires is None
+    assert got.description is None
+    assert got.friendly_name is None
+    assert got.model_type == enums.Model.ModelType.MODEL_TYPE_UNSPECIFIED
+    assert got.labels == {}
+    assert len(got.training_runs) == 0
+    assert len(got.feature_columns) == 0
+    assert len(got.label_columns) == 0
+
+
+def test_from_api_repr_w_unknown_fields(target_class):
+    from google.cloud.bigquery import ModelReference
+
+    resource = {
+        "modelReference": {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "modelId": "my_model",
+        },
+        "thisFieldIsNotInTheProto": "just ignore me",
+    }
+    got = target_class.from_api_repr(resource)
+    assert got.reference == ModelReference.from_string("my-project.my_dataset.my_model")
+    assert got._properties is resource
+
+
+@pytest.mark.parametrize(
+    "resource,filter_fields,expected",
+    [
+        (
+            {
+                "friendlyName": "hello",
+                "description": "world",
+                "expirationTime": "12345",
+                "labels": {"a-label": "a-value"},
+            },
+            ["description"],
+            {"description": "world"},
+        ),
+        (
+            {"friendlyName": "hello", "description": "world"},
+            ["friendlyName"],
+            {"friendlyName": "hello"},
+        ),
+        (
+            {
+                "friendlyName": "hello",
+                "description": "world",
+                "expirationTime": "12345",
+                "labels": {"a-label": "a-value"},
+            },
+            ["expires"],
+            {"expirationTime": "12345"},
+        ),
+        (
+            {
+                "friendlyName": "hello",
+                "description": "world",
+                "expirationTime": None,
+                "labels": {"a-label": "a-value"},
+            },
+            ["expires"],
+            {"expirationTime": None},
+        ),
+        (
+            {
+                "friendlyName": "hello",
+                "description": "world",
+                "expirationTime": None,
+                "labels": {"a-label": "a-value"},
+            },
+            ["labels"],
+            {"labels": {"a-label": "a-value"}},
+        ),
+    ],
+)
+def test_build_resource(object_under_test, resource, filter_fields, expected):
+    object_under_test._properties = resource
+    got = object_under_test._build_resource(filter_fields)
+    assert got == expected
+
+
+def test_set_description(object_under_test):
+    assert not object_under_test.description
+    object_under_test.description = "A model description."
+    assert object_under_test.description == "A model description."
+    object_under_test.description = None
+    assert not object_under_test.description
+
+
+def test_set_expires(object_under_test):
+    assert not object_under_test.expires
+    expiration_time = datetime.datetime(
+        2012, 12, 21, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+    )
+    object_under_test.expires = expiration_time
+    assert object_under_test.expires == expiration_time
+    object_under_test.expires = None
+    assert not object_under_test.expires
+
+
+def test_set_friendly_name(object_under_test):
+    assert not object_under_test.friendly_name
+    object_under_test.friendly_name = "A model name."
+    assert object_under_test.friendly_name == "A model name."
+    object_under_test.friendly_name = None
+    assert not object_under_test.friendly_name
+
+
+def test_set_labels(object_under_test):
+    assert object_under_test.labels == {}
+    object_under_test.labels["data_owner"] = "someteam"
+    assert object_under_test.labels == {"data_owner": "someteam"}
+    del object_under_test.labels["data_owner"]
+    assert object_under_test.labels == {}
+
+
+def test_replace_labels(object_under_test):
+    assert object_under_test.labels == {}
+    object_under_test.labels = {"data_owner": "someteam"}
+    assert object_under_test.labels == {"data_owner": "someteam"}
+    labels = {}
+    object_under_test.labels = labels
+    assert object_under_test.labels is labels
+    object_under_test.labels = None
+    assert object_under_test.labels == {}
+
+
+def test_repr(target_class):
+    model = target_class("my-proj.my_dset.my_model")
+    got = repr(model)
+    assert got == (
+        "Model(reference=ModelReference("
+        "project='my-proj', dataset_id='my_dset', project_id='my_model'))"
+    )
diff --git a/bigquery/tests/unit/model/test_model_reference.py b/bigquery/tests/unit/model/test_model_reference.py
new file mode 100644
index 000000000000..ff1d1df7d499
--- /dev/null
+++ b/bigquery/tests/unit/model/test_model_reference.py
@@ -0,0 +1,140 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pytest
+
+
+@pytest.fixture
+def target_class():
+    from google.cloud.bigquery import ModelReference
+
+    return ModelReference
+
+
+def test_from_api_repr(target_class):
+    resource = {
+        "projectId": "my-project",
+        "datasetId": "my_dataset",
+        "modelId": "my_model",
+    }
+    got = target_class.from_api_repr(resource)
+    assert got.project == "my-project"
+    assert got.dataset_id == "my_dataset"
+    assert got.model_id == "my_model"
+    assert got.path == "/projects/my-project/datasets/my_dataset/models/my_model"
+
+
+def test_from_api_repr_w_unknown_fields(target_class):
+    resource = {
+        "projectId": "my-project",
+        "datasetId": "my_dataset",
+        "modelId": "my_model",
+        "thisFieldIsNotInTheProto": "just ignore me",
+    }
+    got = target_class.from_api_repr(resource)
+    assert got.project == "my-project"
+    assert got.dataset_id == "my_dataset"
+    assert got.model_id == "my_model"
+    assert got._properties is resource
+
+
+def test_to_api_repr(target_class):
+    ref = target_class.from_string("my-project.my_dataset.my_model")
+    got = ref.to_api_repr()
+    assert got == {
+        "projectId": "my-project",
+        "datasetId": "my_dataset",
+        "modelId": "my_model",
+    }
+
+
+def test_from_string(target_class):
+    got = target_class.from_string("string-project.string_dataset.string_model")
+    assert got.project == "string-project"
+    assert got.dataset_id == "string_dataset"
+    assert got.model_id == "string_model"
+    assert got.path == (
+        "/projects/string-project/datasets/string_dataset/models/string_model"
+    )
+
+
+def test_from_string_legacy_string(target_class):
+    with pytest.raises(ValueError):
+        target_class.from_string("string-project:string_dataset.string_model")
+
+
+def test_from_string_not_fully_qualified(target_class):
+    with pytest.raises(ValueError):
+        target_class.from_string("string_model")
+
+    with pytest.raises(ValueError):
+        target_class.from_string("string_dataset.string_model")
+
+    with pytest.raises(ValueError):
+        target_class.from_string("a.b.c.d")
+
+
+def test_from_string_with_default_project(target_class):
+    got = target_class.from_string(
+        "string_dataset.string_model", default_project="default-project"
+    )
+    assert got.project == "default-project"
+    assert got.dataset_id == "string_dataset"
+    assert got.model_id == "string_model"
+
+
+def test_from_string_ignores_default_project(target_class):
+    got = target_class.from_string(
+        "string-project.string_dataset.string_model", default_project="default-project"
+    )
+    assert got.project == "string-project"
+    assert got.dataset_id == "string_dataset"
+    assert got.model_id == "string_model"
+
+
+def test_eq(target_class):
+    model = target_class.from_string("my-proj.my_dset.my_model")
+    model_too = target_class.from_string("my-proj.my_dset.my_model")
+    assert model == model_too
+    assert not (model != model_too)
+
+    other_model = target_class.from_string("my-proj.my_dset.my_model2")
+    assert not (model == other_model)
+    assert model != other_model
+
+    notamodel = object()
+    assert not (model == notamodel)
+    assert model != notamodel
+
+
+def test_hash(target_class):
+    model = target_class.from_string("my-proj.my_dset.my_model")
+    model2 = target_class.from_string("my-proj.my_dset.model2")
+    got = {model: "hello", model2: "world"}
+    assert got[model] == "hello"
+    assert got[model2] == "world"
+
+    model_too = target_class.from_string("my-proj.my_dset.my_model")
+    assert got[model_too] == "hello"
+
+
+def test_repr(target_class):
+    model = target_class.from_string("my-proj.my_dset.my_model")
+    got = repr(model)
+    assert (
+        got
+        == "ModelReference(project='my-proj', dataset_id='my_dset', project_id='my_model')"
+    )
diff --git a/bigquery/tests/unit/routine/__init__.py b/bigquery/tests/unit/routine/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery/tests/unit/routine/test_routine.py b/bigquery/tests/unit/routine/test_routine.py
new file mode 100644
index 000000000000..02d4a2ee2883
--- /dev/null
+++ b/bigquery/tests/unit/routine/test_routine.py
@@ -0,0 +1,305 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+
+import pytest
+
+import google.cloud._helpers
+from google.cloud import bigquery_v2
+
+
+@pytest.fixture
+def target_class():
+    from google.cloud.bigquery.routine import Routine
+
+    return Routine
+
+
+@pytest.fixture
+def object_under_test(target_class):
+    return target_class("project-id.dataset_id.routine_id")
+
+
+def test_ctor(target_class):
+    from google.cloud.bigquery.routine import RoutineReference
+
+    ref = RoutineReference.from_string("my-proj.my_dset.my_routine")
+    actual_routine = target_class(ref)
+    assert actual_routine.reference == ref
+    assert (
+        actual_routine.path == "/projects/my-proj/datasets/my_dset/routines/my_routine"
+    )
+
+
+def test_ctor_w_string(target_class):
+    from google.cloud.bigquery.routine import RoutineReference
+
+    routine_id = "my-proj.my_dset.my_routine"
+    ref = RoutineReference.from_string(routine_id)
+    actual_routine = target_class(routine_id)
+    assert actual_routine.reference == ref
+
+
+def test_ctor_w_properties(target_class):
+    from google.cloud.bigquery.routine import RoutineArgument
+    from google.cloud.bigquery.routine import RoutineReference
+
+    routine_id = "my-proj.my_dset.my_routine"
+    arguments = [
+        RoutineArgument(
+            name="x",
+            data_type=bigquery_v2.types.StandardSqlDataType(
+                type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+            ),
+        )
+    ]
+    body = "x * 3"
+    language = "SQL"
+    return_type = bigquery_v2.types.StandardSqlDataType(
+        type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+    )
+    type_ = "SCALAR_FUNCTION"
+
+    actual_routine = target_class(
+        routine_id,
+        arguments=arguments,
+        body=body,
+        language=language,
+        return_type=return_type,
+        type_=type_,
+    )
+
+    ref = RoutineReference.from_string(routine_id)
+    assert actual_routine.reference == ref
+    assert actual_routine.arguments == arguments
+    assert actual_routine.body == body
+    assert actual_routine.language == language
+    assert actual_routine.return_type == return_type
+    assert actual_routine.type_ == type_
+
+
+def test_from_api_repr(target_class):
+    from google.cloud.bigquery.routine import RoutineArgument
+    from google.cloud.bigquery.routine import RoutineReference
+
+    creation_time = datetime.datetime(
+        2010, 5, 19, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+    )
+    modified_time = datetime.datetime(
+        2011, 10, 1, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+    )
+    resource = {
+        "routineReference": {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "routineId": "my_routine",
+        },
+        "etag": "abcdefg",
+        "creationTime": str(google.cloud._helpers._millis(creation_time)),
+        "lastModifiedTime": str(google.cloud._helpers._millis(modified_time)),
+        "definitionBody": "42",
+        "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+        "language": "SQL",
+        "returnType": {"typeKind": "INT64"},
+        "routineType": "SCALAR_FUNCTION",
+        "someNewField": "someValue",
+    }
+    actual_routine = target_class.from_api_repr(resource)
+
+    assert actual_routine.project == "my-project"
+    assert actual_routine.dataset_id == "my_dataset"
+    assert actual_routine.routine_id == "my_routine"
+    assert (
+        actual_routine.path
+        == "/projects/my-project/datasets/my_dataset/routines/my_routine"
+    )
+    assert actual_routine.reference == RoutineReference.from_string(
+        "my-project.my_dataset.my_routine"
+    )
+    assert actual_routine.etag == "abcdefg"
+    assert actual_routine.created == creation_time
+    assert actual_routine.modified == modified_time
+    assert actual_routine.arguments == [
+        RoutineArgument(
+            name="x",
+            data_type=bigquery_v2.types.StandardSqlDataType(
+                type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+            ),
+        )
+    ]
+    assert actual_routine.body == "42"
+    assert actual_routine.language == "SQL"
+    assert actual_routine.return_type == bigquery_v2.types.StandardSqlDataType(
+        type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+    )
+    assert actual_routine.type_ == "SCALAR_FUNCTION"
+    assert actual_routine._properties["someNewField"] == "someValue"
+
+
+def test_from_api_repr_w_minimal_resource(target_class):
+    from google.cloud.bigquery.routine import RoutineReference
+
+    resource = {
+        "routineReference": {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "routineId": "my_routine",
+        }
+    }
+    actual_routine = target_class.from_api_repr(resource)
+    assert actual_routine.reference == RoutineReference.from_string(
+        "my-project.my_dataset.my_routine"
+    )
+    assert actual_routine.etag is None
+    assert actual_routine.created is None
+    assert actual_routine.modified is None
+    assert actual_routine.arguments == []
+    assert actual_routine.body is None
+    assert actual_routine.language is None
+    assert actual_routine.return_type is None
+    assert actual_routine.type_ is None
+
+
+def test_from_api_repr_w_unknown_fields(target_class):
+    from google.cloud.bigquery.routine import RoutineReference
+
+    resource = {
+        "routineReference": {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "routineId": "my_routine",
+        },
+        "thisFieldIsNotInTheProto": "just ignore me",
+    }
+    actual_routine = target_class.from_api_repr(resource)
+    assert actual_routine.reference == RoutineReference.from_string(
+        "my-project.my_dataset.my_routine"
+    )
+    assert actual_routine._properties is resource
+
+
+@pytest.mark.parametrize(
+    "resource,filter_fields,expected",
+    [
+        (
+            {
+                "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+                "definitionBody": "x * 3",
+                "language": "SQL",
+                "returnType": {"typeKind": "INT64"},
+                "routineType": "SCALAR_FUNCTION",
+            },
+            ["arguments"],
+            {"arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}]},
+        ),
+        (
+            {
+                "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+                "definitionBody": "x * 3",
+                "language": "SQL",
+                "returnType": {"typeKind": "INT64"},
+                "routineType": "SCALAR_FUNCTION",
+            },
+            ["body"],
+            {"definitionBody": "x * 3"},
+        ),
+        (
+            {
+                "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+                "definitionBody": "x * 3",
+                "language": "SQL",
+                "returnType": {"typeKind": "INT64"},
+                "routineType": "SCALAR_FUNCTION",
+            },
+            ["language"],
+            {"language": "SQL"},
+        ),
+        (
+            {
+                "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+                "definitionBody": "x * 3",
+                "language": "SQL",
+                "returnType": {"typeKind": "INT64"},
+                "routineType": "SCALAR_FUNCTION",
+            },
+            ["return_type"],
+            {"returnType": {"typeKind": "INT64"}},
+        ),
+        (
+            {
+                "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+                "definitionBody": "x * 3",
+                "language": "SQL",
+                "returnType": {"typeKind": "INT64"},
+                "routineType": "SCALAR_FUNCTION",
+            },
+            ["type_"],
+            {"routineType": "SCALAR_FUNCTION"},
+        ),
+        (
+            {},
+            ["arguments", "language", "body", "type_", "return_type"],
+            {
+                "arguments": None,
+                "definitionBody": None,
+                "language": None,
+                "returnType": None,
+                "routineType": None,
+            },
+        ),
+        (
+            {"someNewField": "someValue"},
+            ["someNewField"],
+            {"someNewField": "someValue"},
+        ),
+    ],
+)
+def test_build_resource(object_under_test, resource, filter_fields, expected):
+    object_under_test._properties = resource
+    actual_routine = object_under_test._build_resource(filter_fields)
+    assert actual_routine == expected
+
+
+def test_set_arguments_w_none(object_under_test):
+    object_under_test.arguments = None
+    assert object_under_test.arguments == []
+    assert object_under_test._properties["arguments"] == []
+
+
+def test_set_imported_libraries(object_under_test):
+    imported_libraries = ["gs://cloud-samples-data/bigquery/udfs/max-value.js"]
+    object_under_test.imported_libraries = imported_libraries
+    assert object_under_test.imported_libraries == imported_libraries
+    assert object_under_test._properties["importedLibraries"] == imported_libraries
+
+
+def test_set_imported_libraries_w_none(object_under_test):
+    object_under_test.imported_libraries = None
+    assert object_under_test.imported_libraries == []
+    assert object_under_test._properties["importedLibraries"] == []
+
+
+def test_set_return_type_w_none(object_under_test):
+    object_under_test.return_type = None
+    assert object_under_test.return_type is None
+    assert object_under_test._properties["returnType"] is None
+
+
+def test_repr(target_class):
+    model = target_class("my-proj.my_dset.my_routine")
+    actual_routine = repr(model)
+    assert actual_routine == "Routine('my-proj.my_dset.my_routine')"
diff --git a/bigquery/tests/unit/routine/test_routine_argument.py b/bigquery/tests/unit/routine/test_routine_argument.py
new file mode 100644
index 000000000000..7d17b5fc703f
--- /dev/null
+++ b/bigquery/tests/unit/routine/test_routine_argument.py
@@ -0,0 +1,100 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pytest
+
+from google.cloud import bigquery_v2
+
+
+@pytest.fixture
+def target_class():
+    from google.cloud.bigquery.routine import RoutineArgument
+
+    return RoutineArgument
+
+
+def test_ctor(target_class):
+    data_type = bigquery_v2.types.StandardSqlDataType(
+        type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+    )
+    actual_arg = target_class(
+        name="field_name", kind="FIXED_TYPE", mode="IN", data_type=data_type
+    )
+    assert actual_arg.name == "field_name"
+    assert actual_arg.kind == "FIXED_TYPE"
+    assert actual_arg.mode == "IN"
+    assert actual_arg.data_type == data_type
+
+
+def test_from_api_repr(target_class):
+    resource = {
+        "argumentKind": "FIXED_TYPE",
+        "dataType": {"typeKind": "INT64"},
+        "mode": "IN",
+        "name": "field_name",
+    }
+    actual_arg = target_class.from_api_repr(resource)
+    assert actual_arg.name == "field_name"
+    assert actual_arg.kind == "FIXED_TYPE"
+    assert actual_arg.mode == "IN"
+    assert actual_arg.data_type == bigquery_v2.types.StandardSqlDataType(
+        type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+    )
+
+
+def test_from_api_repr_w_minimal_resource(target_class):
+    resource = {}
+    actual_arg = target_class.from_api_repr(resource)
+    assert actual_arg.name is None
+    assert actual_arg.kind is None
+    assert actual_arg.mode is None
+    assert actual_arg.data_type is None
+
+
+def test_from_api_repr_w_unknown_fields(target_class):
+    resource = {"thisFieldIsNotInTheProto": "just ignore me"}
+    actual_arg = target_class.from_api_repr(resource)
+    assert actual_arg._properties is resource
+
+
+def test_eq(target_class):
+    data_type = bigquery_v2.types.StandardSqlDataType(
+        type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+    )
+    arg = target_class(
+        name="field_name", kind="FIXED_TYPE", mode="IN", data_type=data_type
+    )
+    arg_too = target_class(
+        name="field_name", kind="FIXED_TYPE", mode="IN", data_type=data_type
+    )
+    assert arg == arg_too
+    assert not (arg != arg_too)
+
+    other_arg = target_class()
+    assert not (arg == other_arg)
+    assert arg != other_arg
+
+    notanarg = object()
+    assert not (arg == notanarg)
+    assert arg != notanarg
+
+
+def test_repr(target_class):
+    arg = target_class(name="field_name", kind="FIXED_TYPE", mode="IN", data_type=None)
+    actual_repr = repr(arg)
+    assert actual_repr == (
+        "RoutineArgument(data_type=None, kind='FIXED_TYPE', mode='IN', name='field_name')"
+    )
diff --git a/bigquery/tests/unit/routine/test_routine_reference.py b/bigquery/tests/unit/routine/test_routine_reference.py
new file mode 100644
index 000000000000..9d3d551a6294
--- /dev/null
+++ b/bigquery/tests/unit/routine/test_routine_reference.py
@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pytest
+
+
+@pytest.fixture
+def target_class():
+    from google.cloud.bigquery.routine import RoutineReference
+
+    return RoutineReference
+
+
+def test_from_api_repr(target_class):
+    resource = {
+        "projectId": "my-project",
+        "datasetId": "my_dataset",
+        "routineId": "my_routine",
+    }
+    got = target_class.from_api_repr(resource)
+    assert got.project == "my-project"
+    assert got.dataset_id == "my_dataset"
+    assert got.routine_id == "my_routine"
+    assert got.path == "/projects/my-project/datasets/my_dataset/routines/my_routine"
+
+
+def test_from_api_repr_w_unknown_fields(target_class):
+    resource = {
+        "projectId": "my-project",
+        "datasetId": "my_dataset",
+        "routineId": "my_routine",
+        "thisFieldIsNotInTheProto": "just ignore me",
+    }
+    got = target_class.from_api_repr(resource)
+    assert got.project == "my-project"
+    assert got.dataset_id == "my_dataset"
+    assert got.routine_id == "my_routine"
+    assert got._properties is resource
+
+
+def test_to_api_repr(target_class):
+    ref = target_class.from_string("my-project.my_dataset.my_routine")
+    got = ref.to_api_repr()
+    assert got == {
+        "projectId": "my-project",
+        "datasetId": "my_dataset",
+        "routineId": "my_routine",
+    }
+
+
+def test_from_string(target_class):
+    got = target_class.from_string("string-project.string_dataset.string_routine")
+    assert got.project == "string-project"
+    assert got.dataset_id == "string_dataset"
+    assert got.routine_id == "string_routine"
+    assert got.path == (
+        "/projects/string-project/datasets/string_dataset/routines/string_routine"
+    )
+
+
+def test_from_string_legacy_string(target_class):
+    with pytest.raises(ValueError):
+        target_class.from_string("string-project:string_dataset.string_routine")
+
+
+def test_from_string_not_fully_qualified(target_class):
+    with pytest.raises(ValueError):
+        target_class.from_string("string_routine")
+
+    with pytest.raises(ValueError):
+        target_class.from_string("string_dataset.string_routine")
+
+    with pytest.raises(ValueError):
+        target_class.from_string("a.b.c.d")
+
+
+def test_from_string_with_default_project(target_class):
+    got = target_class.from_string(
+        "string_dataset.string_routine", default_project="default-project"
+    )
+    assert got.project == "default-project"
+    assert got.dataset_id == "string_dataset"
+    assert got.routine_id == "string_routine"
+
+
+def test_from_string_ignores_default_project(target_class):
+    got = target_class.from_string(
+        "string-project.string_dataset.string_routine",
+        default_project="default-project",
+    )
+    assert got.project == "string-project"
+    assert got.dataset_id == "string_dataset"
+    assert got.routine_id == "string_routine"
+
+
+def test_eq(target_class):
+    routine = target_class.from_string("my-proj.my_dset.my_routine")
+    routine_too = target_class.from_string("my-proj.my_dset.my_routine")
+    assert routine == routine_too
+    assert not (routine != routine_too)
+
+    other_routine = target_class.from_string("my-proj.my_dset.my_routine2")
+    assert not (routine == other_routine)
+    assert routine != other_routine
+
+    notaroutine = object()
+    assert not (routine == notaroutine)
+    assert routine != notaroutine
+
+
+def test_hash(target_class):
+    routine = target_class.from_string("my-proj.my_dset.my_routine")
+    routine2 = target_class.from_string("my-proj.my_dset.routine2")
+    got = {routine: "hello", routine2: "world"}
+    assert got[routine] == "hello"
+    assert got[routine2] == "world"
+
+    routine_too = target_class.from_string("my-proj.my_dset.my_routine")
+    assert got[routine_too] == "hello"
+
+
+def test_repr(target_class):
+    routine = target_class.from_string("my-proj.my_dset.my_routine")
+    got = repr(routine)
+    assert got == "RoutineReference.from_string('my-proj.my_dset.my_routine')"
diff --git a/bigquery/tests/unit/test__helpers.py b/bigquery/tests/unit/test__helpers.py
new file mode 100644
index 000000000000..3884695d83af
--- /dev/null
+++ b/bigquery/tests/unit/test__helpers.py
@@ -0,0 +1,1025 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import datetime
+import decimal
+import unittest
+
+
+class Test_not_null(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _not_null
+
+        return _not_null(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertFalse(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        self.assertTrue(self._call_fut(None, _Field("REQUIRED")))
+
+    def test_w_value(self):
+        self.assertTrue(self._call_fut(object(), object()))
+
+
+class Test_int_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _int_from_json
+
+        return _int_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("42", object())
+        self.assertEqual(coerced, 42)
+
+    def test_w_float_value(self):
+        coerced = self._call_fut(42, object())
+        self.assertEqual(coerced, 42)
+
+
+class Test_float_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _float_from_json
+
+        return _float_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("3.1415", object())
+        self.assertEqual(coerced, 3.1415)
+
+    def test_w_float_value(self):
+        coerced = self._call_fut(3.1415, object())
+        self.assertEqual(coerced, 3.1415)
+
+
+class Test_decimal_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _decimal_from_json
+
+        return _decimal_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("3.1415", object())
+        self.assertEqual(coerced, decimal.Decimal("3.1415"))
+
+    def test_w_float_value(self):
+        coerced = self._call_fut(3.1415, object())
+        # There is no exact float representation of 3.1415.
+        self.assertEqual(coerced, decimal.Decimal(3.1415))
+
+
+class Test_bool_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _bool_from_json
+
+        return _bool_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(AttributeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_value_t(self):
+        coerced = self._call_fut("T", object())
+        self.assertTrue(coerced)
+
+    def test_w_value_true(self):
+        coerced = self._call_fut("True", object())
+        self.assertTrue(coerced)
+
+    def test_w_value_1(self):
+        coerced = self._call_fut("1", object())
+        self.assertTrue(coerced)
+
+    def test_w_value_other(self):
+        coerced = self._call_fut("f", object())
+        self.assertFalse(coerced)
+
+
+class Test_string_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _string_from_json
+
+        return _string_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        self.assertIsNone(self._call_fut(None, _Field("REQUIRED")))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("Wonderful!", object())
+        self.assertEqual(coerced, "Wonderful!")
+
+
+class Test_bytes_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _bytes_from_json
+
+        return _bytes_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_base64_encoded_bytes(self):
+        expected = b"Wonderful!"
+        encoded = base64.standard_b64encode(expected)
+        coerced = self._call_fut(encoded, object())
+        self.assertEqual(coerced, expected)
+
+    def test_w_base64_encoded_text(self):
+        expected = b"Wonderful!"
+        encoded = base64.standard_b64encode(expected).decode("ascii")
+        coerced = self._call_fut(encoded, object())
+        self.assertEqual(coerced, expected)
+
+
+class Test_timestamp_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _timestamp_from_json
+
+        return _timestamp_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        from google.cloud._helpers import _EPOCH
+
+        coerced = self._call_fut("1.234567", object())
+        self.assertEqual(
+            coerced, _EPOCH + datetime.timedelta(seconds=1, microseconds=234567)
+        )
+
+    def test_w_float_value(self):
+        from google.cloud._helpers import _EPOCH
+
+        coerced = self._call_fut(1.234567, object())
+        self.assertEqual(
+            coerced, _EPOCH + datetime.timedelta(seconds=1, microseconds=234567)
+        )
+
+
+class Test_timestamp_query_param_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery import _helpers
+
+        return _helpers._timestamp_query_param_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_timestamp_valid(self):
+        from google.cloud._helpers import UTC
+
+        samples = [
+            (
+                "2016-12-20 15:58:27.339328+00:00",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20 15:58:27+00:00",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20T15:58:27.339328+00:00",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20T15:58:27+00:00",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20 15:58:27.339328Z",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20 15:58:27Z",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20T15:58:27.339328Z",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=UTC),
+            ),
+            (
+                "2016-12-20T15:58:27Z",
+                datetime.datetime(2016, 12, 20, 15, 58, 27, tzinfo=UTC),
+            ),
+        ]
+        for timestamp_str, expected_result in samples:
+            self.assertEqual(
+                self._call_fut(timestamp_str, _Field("NULLABLE")), expected_result
+            )
+
+    def test_w_timestamp_invalid(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("definitely-not-a-timestamp", _Field("NULLABLE"))
+
+
+class Test_datetime_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _datetime_from_json
+
+        return _datetime_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("2016-12-02T18:51:33", object())
+        self.assertEqual(coerced, datetime.datetime(2016, 12, 2, 18, 51, 33))
+
+    def test_w_microseconds(self):
+        coerced = self._call_fut("2015-05-22T10:11:12.987654", object())
+        self.assertEqual(coerced, datetime.datetime(2015, 5, 22, 10, 11, 12, 987654))
+
+
+class Test_date_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _date_from_json
+
+        return _date_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("1987-09-22", object())
+        self.assertEqual(coerced, datetime.date(1987, 9, 22))
+
+
+class Test_time_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _time_from_json
+
+        return _time_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_string_value(self):
+        coerced = self._call_fut("12:12:27", object())
+        self.assertEqual(coerced, datetime.time(12, 12, 27))
+
+    def test_w_subsecond_string_value(self):
+        coerced = self._call_fut("12:12:27.123456", object())
+        self.assertEqual(coerced, datetime.time(12, 12, 27, 123456))
+
+    def test_w_bogus_string_value(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("12:12:27.123", object())
+
+
+class Test_record_from_json(unittest.TestCase):
+    def _call_fut(self, value, field):
+        from google.cloud.bigquery._helpers import _record_from_json
+
+        return _record_from_json(value, field)
+
+    def test_w_none_nullable(self):
+        self.assertIsNone(self._call_fut(None, _Field("NULLABLE")))
+
+    def test_w_none_required(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None, _Field("REQUIRED"))
+
+    def test_w_nullable_subfield_none(self):
+        subfield = _Field("NULLABLE", "age", "INTEGER")
+        field = _Field("REQUIRED", fields=[subfield])
+        value = {"f": [{"v": None}]}
+        coerced = self._call_fut(value, field)
+        self.assertEqual(coerced, {"age": None})
+
+    def test_w_scalar_subfield(self):
+        subfield = _Field("REQUIRED", "age", "INTEGER")
+        field = _Field("REQUIRED", fields=[subfield])
+        value = {"f": [{"v": 42}]}
+        coerced = self._call_fut(value, field)
+        self.assertEqual(coerced, {"age": 42})
+
+    def test_w_scalar_subfield_geography(self):
+        subfield = _Field("REQUIRED", "geo", "GEOGRAPHY")
+        field = _Field("REQUIRED", fields=[subfield])
+        value = {"f": [{"v": "POINT(1, 2)"}]}
+        coerced = self._call_fut(value, field)
+        self.assertEqual(coerced, {"geo": "POINT(1, 2)"})
+
+    def test_w_repeated_subfield(self):
+        subfield = _Field("REPEATED", "color", "STRING")
+        field = _Field("REQUIRED", fields=[subfield])
+        value = {"f": [{"v": [{"v": "red"}, {"v": "yellow"}, {"v": "blue"}]}]}
+        coerced = self._call_fut(value, field)
+        self.assertEqual(coerced, {"color": ["red", "yellow", "blue"]})
+
+    def test_w_record_subfield(self):
+        full_name = _Field("REQUIRED", "full_name", "STRING")
+        area_code = _Field("REQUIRED", "area_code", "STRING")
+        local_number = _Field("REQUIRED", "local_number", "STRING")
+        rank = _Field("REQUIRED", "rank", "INTEGER")
+        phone = _Field(
+            "NULLABLE", "phone", "RECORD", fields=[area_code, local_number, rank]
+        )
+        person = _Field("REQUIRED", "person", "RECORD", fields=[full_name, phone])
+        value = {
+            "f": [
+                {"v": "Phred Phlyntstone"},
+                {"v": {"f": [{"v": "800"}, {"v": "555-1212"}, {"v": 1}]}},
+            ]
+        }
+        expected = {
+            "full_name": "Phred Phlyntstone",
+            "phone": {"area_code": "800", "local_number": "555-1212", "rank": 1},
+        }
+        coerced = self._call_fut(value, person)
+        self.assertEqual(coerced, expected)
+
+
+class Test_field_to_index_mapping(unittest.TestCase):
+    def _call_fut(self, schema):
+        from google.cloud.bigquery._helpers import _field_to_index_mapping
+
+        return _field_to_index_mapping(schema)
+
+    def test_w_empty_schema(self):
+        self.assertEqual(self._call_fut([]), {})
+
+    def test_w_non_empty_schema(self):
+        schema = [
+            _Field("REPEATED", "first", "INTEGER"),
+            _Field("REQUIRED", "second", "INTEGER"),
+            _Field("REPEATED", "third", "INTEGER"),
+        ]
+        self.assertEqual(self._call_fut(schema), {"first": 0, "second": 1, "third": 2})
+
+
+class Test_row_tuple_from_json(unittest.TestCase):
+    def _call_fut(self, row, schema):
+        from google.cloud.bigquery._helpers import _row_tuple_from_json
+
+        return _row_tuple_from_json(row, schema)
+
+    def test_w_single_scalar_column(self):
+        # SELECT 1 AS col
+        col = _Field("REQUIRED", "col", "INTEGER")
+        row = {u"f": [{u"v": u"1"}]}
+        self.assertEqual(self._call_fut(row, schema=[col]), (1,))
+
+    def test_w_single_scalar_geography_column(self):
+        # SELECT 1 AS col
+        col = _Field("REQUIRED", "geo", "GEOGRAPHY")
+        row = {u"f": [{u"v": u"POINT(1, 2)"}]}
+        self.assertEqual(self._call_fut(row, schema=[col]), ("POINT(1, 2)",))
+
+    def test_w_single_struct_column(self):
+        # SELECT (1, 2) AS col
+        sub_1 = _Field("REQUIRED", "sub_1", "INTEGER")
+        sub_2 = _Field("REQUIRED", "sub_2", "INTEGER")
+        col = _Field("REQUIRED", "col", "RECORD", fields=[sub_1, sub_2])
+        row = {u"f": [{u"v": {u"f": [{u"v": u"1"}, {u"v": u"2"}]}}]}
+        self.assertEqual(self._call_fut(row, schema=[col]), ({"sub_1": 1, "sub_2": 2},))
+
+    def test_w_single_array_column(self):
+        # SELECT [1, 2, 3] as col
+        col = _Field("REPEATED", "col", "INTEGER")
+        row = {u"f": [{u"v": [{u"v": u"1"}, {u"v": u"2"}, {u"v": u"3"}]}]}
+        self.assertEqual(self._call_fut(row, schema=[col]), ([1, 2, 3],))
+
+    def test_w_struct_w_nested_array_column(self):
+        # SELECT ([1, 2], 3, [4, 5]) as col
+        first = _Field("REPEATED", "first", "INTEGER")
+        second = _Field("REQUIRED", "second", "INTEGER")
+        third = _Field("REPEATED", "third", "INTEGER")
+        col = _Field("REQUIRED", "col", "RECORD", fields=[first, second, third])
+        row = {
+            u"f": [
+                {
+                    u"v": {
+                        u"f": [
+                            {u"v": [{u"v": u"1"}, {u"v": u"2"}]},
+                            {u"v": u"3"},
+                            {u"v": [{u"v": u"4"}, {u"v": u"5"}]},
+                        ]
+                    }
+                }
+            ]
+        }
+        self.assertEqual(
+            self._call_fut(row, schema=[col]),
+            ({u"first": [1, 2], u"second": 3, u"third": [4, 5]},),
+        )
+
+    def test_w_array_of_struct(self):
+        # SELECT [(1, 2, 3), (4, 5, 6)] as col
+        first = _Field("REQUIRED", "first", "INTEGER")
+        second = _Field("REQUIRED", "second", "INTEGER")
+        third = _Field("REQUIRED", "third", "INTEGER")
+        col = _Field("REPEATED", "col", "RECORD", fields=[first, second, third])
+        row = {
+            u"f": [
+                {
+                    u"v": [
+                        {u"v": {u"f": [{u"v": u"1"}, {u"v": u"2"}, {u"v": u"3"}]}},
+                        {u"v": {u"f": [{u"v": u"4"}, {u"v": u"5"}, {u"v": u"6"}]}},
+                    ]
+                }
+            ]
+        }
+        self.assertEqual(
+            self._call_fut(row, schema=[col]),
+            (
+                [
+                    {u"first": 1, u"second": 2, u"third": 3},
+                    {u"first": 4, u"second": 5, u"third": 6},
+                ],
+            ),
+        )
+
+    def test_w_array_of_struct_w_array(self):
+        # SELECT [([1, 2, 3], 4), ([5, 6], 7)]
+        first = _Field("REPEATED", "first", "INTEGER")
+        second = _Field("REQUIRED", "second", "INTEGER")
+        col = _Field("REPEATED", "col", "RECORD", fields=[first, second])
+        row = {
+            u"f": [
+                {
+                    u"v": [
+                        {
+                            u"v": {
+                                u"f": [
+                                    {u"v": [{u"v": u"1"}, {u"v": u"2"}, {u"v": u"3"}]},
+                                    {u"v": u"4"},
+                                ]
+                            }
+                        },
+                        {
+                            u"v": {
+                                u"f": [
+                                    {u"v": [{u"v": u"5"}, {u"v": u"6"}]},
+                                    {u"v": u"7"},
+                                ]
+                            }
+                        },
+                    ]
+                }
+            ]
+        }
+        self.assertEqual(
+            self._call_fut(row, schema=[col]),
+            ([{u"first": [1, 2, 3], u"second": 4}, {u"first": [5, 6], u"second": 7}],),
+        )
+
+
+class Test_rows_from_json(unittest.TestCase):
+    def _call_fut(self, rows, schema):
+        from google.cloud.bigquery._helpers import _rows_from_json
+
+        return _rows_from_json(rows, schema)
+
+    def test_w_record_subfield(self):
+        from google.cloud.bigquery.table import Row
+
+        full_name = _Field("REQUIRED", "full_name", "STRING")
+        area_code = _Field("REQUIRED", "area_code", "STRING")
+        local_number = _Field("REQUIRED", "local_number", "STRING")
+        rank = _Field("REQUIRED", "rank", "INTEGER")
+        phone = _Field(
+            "NULLABLE", "phone", "RECORD", fields=[area_code, local_number, rank]
+        )
+        color = _Field("REPEATED", "color", "STRING")
+        schema = [full_name, phone, color]
+        rows = [
+            {
+                "f": [
+                    {"v": "Phred Phlyntstone"},
+                    {"v": {"f": [{"v": "800"}, {"v": "555-1212"}, {"v": 1}]}},
+                    {"v": [{"v": "orange"}, {"v": "black"}]},
+                ]
+            },
+            {
+                "f": [
+                    {"v": "Bharney Rhubble"},
+                    {"v": {"f": [{"v": "877"}, {"v": "768-5309"}, {"v": 2}]}},
+                    {"v": [{"v": "brown"}]},
+                ]
+            },
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": None}, {"v": []}]},
+        ]
+        phred_phone = {"area_code": "800", "local_number": "555-1212", "rank": 1}
+        bharney_phone = {"area_code": "877", "local_number": "768-5309", "rank": 2}
+        f2i = {"full_name": 0, "phone": 1, "color": 2}
+        expected = [
+            Row(("Phred Phlyntstone", phred_phone, ["orange", "black"]), f2i),
+            Row(("Bharney Rhubble", bharney_phone, ["brown"]), f2i),
+            Row(("Wylma Phlyntstone", None, []), f2i),
+        ]
+        coerced = self._call_fut(rows, schema)
+        self.assertEqual(coerced, expected)
+
+    def test_w_int64_float64_bool(self):
+        from google.cloud.bigquery.table import Row
+
+        # "Standard" SQL dialect uses 'INT64', 'FLOAT64', 'BOOL'.
+        candidate = _Field("REQUIRED", "candidate", "STRING")
+        votes = _Field("REQUIRED", "votes", "INT64")
+        percentage = _Field("REQUIRED", "percentage", "FLOAT64")
+        incumbent = _Field("REQUIRED", "incumbent", "BOOL")
+        schema = [candidate, votes, percentage, incumbent]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": 8}, {"v": 0.25}, {"v": "true"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": 4}, {"v": 0.125}, {"v": "false"}]},
+            {
+                "f": [
+                    {"v": "Wylma Phlyntstone"},
+                    {"v": 20},
+                    {"v": 0.625},
+                    {"v": "false"},
+                ]
+            },
+        ]
+        f2i = {"candidate": 0, "votes": 1, "percentage": 2, "incumbent": 3}
+        expected = [
+            Row(("Phred Phlyntstone", 8, 0.25, True), f2i),
+            Row(("Bharney Rhubble", 4, 0.125, False), f2i),
+            Row(("Wylma Phlyntstone", 20, 0.625, False), f2i),
+        ]
+        coerced = self._call_fut(rows, schema)
+        self.assertEqual(coerced, expected)
+
+
+class Test_int_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _int_to_json
+
+        return _int_to_json(value)
+
+    def test_w_int(self):
+        self.assertEqual(self._call_fut(123), "123")
+
+    def test_w_string(self):
+        self.assertEqual(self._call_fut("123"), "123")
+
+
+class Test_float_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _float_to_json
+
+        return _float_to_json(value)
+
+    def test_w_float(self):
+        self.assertEqual(self._call_fut(1.23), 1.23)
+
+
+class Test_decimal_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _decimal_to_json
+
+        return _decimal_to_json(value)
+
+    def test_w_float(self):
+        self.assertEqual(self._call_fut(1.23), 1.23)
+
+    def test_w_string(self):
+        self.assertEqual(self._call_fut("1.23"), "1.23")
+
+    def test_w_decimal(self):
+        self.assertEqual(self._call_fut(decimal.Decimal("1.23")), "1.23")
+
+
+class Test_bool_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _bool_to_json
+
+        return _bool_to_json(value)
+
+    def test_w_true(self):
+        self.assertEqual(self._call_fut(True), "true")
+
+    def test_w_false(self):
+        self.assertEqual(self._call_fut(False), "false")
+
+    def test_w_string(self):
+        self.assertEqual(self._call_fut("false"), "false")
+
+
+class Test_bytes_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _bytes_to_json
+
+        return _bytes_to_json(value)
+
+    def test_w_non_bytes(self):
+        non_bytes = object()
+        self.assertIs(self._call_fut(non_bytes), non_bytes)
+
+    def test_w_bytes(self):
+        source = b"source"
+        expected = u"c291cmNl"
+        converted = self._call_fut(source)
+        self.assertEqual(converted, expected)
+
+
+class Test_timestamp_to_json_parameter(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _timestamp_to_json_parameter
+
+        return _timestamp_to_json_parameter(value)
+
+    def test_w_float(self):
+        self.assertEqual(self._call_fut(1.234567), 1.234567)
+
+    def test_w_string(self):
+        ZULU = "2016-12-20 15:58:27.339328+00:00"
+        self.assertEqual(self._call_fut(ZULU), ZULU)
+
+    def test_w_datetime_wo_zone(self):
+        ZULU = "2016-12-20 15:58:27.339328+00:00"
+        when = datetime.datetime(2016, 12, 20, 15, 58, 27, 339328)
+        self.assertEqual(self._call_fut(when), ZULU)
+
+    def test_w_datetime_w_non_utc_zone(self):
+        class _Zone(datetime.tzinfo):
+            def utcoffset(self, _):
+                return datetime.timedelta(minutes=-240)
+
+        ZULU = "2016-12-20 19:58:27.339328+00:00"
+        when = datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=_Zone())
+        self.assertEqual(self._call_fut(when), ZULU)
+
+    def test_w_datetime_w_utc_zone(self):
+        from google.cloud._helpers import UTC
+
+        ZULU = "2016-12-20 15:58:27.339328+00:00"
+        when = datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=UTC)
+        self.assertEqual(self._call_fut(when), ZULU)
+
+
+class Test_timestamp_to_json_row(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _timestamp_to_json_row
+
+        return _timestamp_to_json_row(value)
+
+    def test_w_float(self):
+        self.assertEqual(self._call_fut(1.234567), 1.234567)
+
+    def test_w_string(self):
+        ZULU = "2016-12-20 15:58:27.339328+00:00"
+        self.assertEqual(self._call_fut(ZULU), ZULU)
+
+    def test_w_datetime(self):
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        when = datetime.datetime(2016, 12, 20, 15, 58, 27, 339328)
+        self.assertEqual(self._call_fut(when), _microseconds_from_datetime(when) / 1e6)
+
+
+class Test_datetime_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _datetime_to_json
+
+        return _datetime_to_json(value)
+
+    def test_w_string(self):
+        RFC3339 = "2016-12-03T14:14:51Z"
+        self.assertEqual(self._call_fut(RFC3339), RFC3339)
+
+    def test_w_datetime(self):
+        from google.cloud._helpers import UTC
+
+        when = datetime.datetime(2016, 12, 3, 14, 11, 27, 123456, tzinfo=UTC)
+        self.assertEqual(self._call_fut(when), "2016-12-03T14:11:27.123456")
+
+
+class Test_date_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _date_to_json
+
+        return _date_to_json(value)
+
+    def test_w_string(self):
+        RFC3339 = "2016-12-03"
+        self.assertEqual(self._call_fut(RFC3339), RFC3339)
+
+    def test_w_datetime(self):
+        when = datetime.date(2016, 12, 3)
+        self.assertEqual(self._call_fut(when), "2016-12-03")
+
+
+class Test_time_to_json(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _time_to_json
+
+        return _time_to_json(value)
+
+    def test_w_string(self):
+        RFC3339 = "12:13:41"
+        self.assertEqual(self._call_fut(RFC3339), RFC3339)
+
+    def test_w_datetime(self):
+        when = datetime.time(12, 13, 41)
+        self.assertEqual(self._call_fut(when), "12:13:41")
+
+
+def _make_field(field_type, mode="NULLABLE", name="testing", fields=()):
+    from google.cloud.bigquery.schema import SchemaField
+
+    return SchemaField(name=name, field_type=field_type, mode=mode, fields=fields)
+
+
+class Test_scalar_field_to_json(unittest.TestCase):
+    def _call_fut(self, field, value):
+        from google.cloud.bigquery._helpers import _scalar_field_to_json
+
+        return _scalar_field_to_json(field, value)
+
+    def test_w_unknown_field_type(self):
+        field = _make_field("UNKNOWN")
+        original = object()
+        converted = self._call_fut(field, original)
+        self.assertIs(converted, original)
+
+    def test_w_known_field_type(self):
+        field = _make_field("INT64")
+        original = 42
+        converted = self._call_fut(field, original)
+        self.assertEqual(converted, str(original))
+
+
+class Test_repeated_field_to_json(unittest.TestCase):
+    def _call_fut(self, field, value):
+        from google.cloud.bigquery._helpers import _repeated_field_to_json
+
+        return _repeated_field_to_json(field, value)
+
+    def test_w_empty(self):
+        field = _make_field("INT64", mode="REPEATED")
+        original = []
+        converted = self._call_fut(field, original)
+        self.assertEqual(converted, original)
+        self.assertEqual(field.mode, "REPEATED")
+
+    def test_w_non_empty(self):
+        field = _make_field("INT64", mode="REPEATED")
+        original = [42]
+        converted = self._call_fut(field, original)
+        self.assertEqual(converted, [str(value) for value in original])
+        self.assertEqual(field.mode, "REPEATED")
+
+
+class Test_record_field_to_json(unittest.TestCase):
+    def _call_fut(self, field, value):
+        from google.cloud.bigquery._helpers import _record_field_to_json
+
+        return _record_field_to_json(field, value)
+
+    def test_w_empty(self):
+        fields = []
+        original = []
+        converted = self._call_fut(fields, original)
+        self.assertEqual(converted, {})
+
+    def test_w_non_empty_list(self):
+        fields = [
+            _make_field("INT64", name="one", mode="NULLABLE"),
+            _make_field("STRING", name="two", mode="NULLABLE"),
+        ]
+        original = [42, "two"]
+        converted = self._call_fut(fields, original)
+        self.assertEqual(converted, {"one": "42", "two": "two"})
+
+    def test_w_non_empty_dict(self):
+        fields = [
+            _make_field("INT64", name="one", mode="NULLABLE"),
+            _make_field("STRING", name="two", mode="NULLABLE"),
+        ]
+        original = {"one": 42, "two": "two"}
+        converted = self._call_fut(fields, original)
+        self.assertEqual(converted, {"one": "42", "two": "two"})
+
+    def test_w_missing_nullable(self):
+        fields = [
+            _make_field("INT64", name="one", mode="NULLABLE"),
+            _make_field("STRING", name="two", mode="NULLABLE"),
+        ]
+        original = {"one": 42}
+        converted = self._call_fut(fields, original)
+        self.assertEqual(converted, {"one": "42", "two": None})
+
+
+class Test_field_to_json(unittest.TestCase):
+    def _call_fut(self, field, value):
+        from google.cloud.bigquery._helpers import _field_to_json
+
+        return _field_to_json(field, value)
+
+    def test_w_none(self):
+        field = _make_field("INT64")
+        original = None
+        converted = self._call_fut(field, original)
+        self.assertIsNone(converted)
+
+    def test_w_repeated(self):
+        field = _make_field("INT64", mode="REPEATED")
+        original = [42, 17]
+        converted = self._call_fut(field, original)
+        self.assertEqual(converted, [str(value) for value in original])
+
+    def test_w_record(self):
+        subfields = [
+            _make_field("INT64", name="one"),
+            _make_field("STRING", name="two"),
+        ]
+        field = _make_field("RECORD", fields=subfields)
+        original = {"one": 42, "two": "two"}
+        converted = self._call_fut(field, original)
+        self.assertEqual(converted, {"one": "42", "two": "two"})
+
+    def test_w_scalar(self):
+        field = _make_field("INT64")
+        original = 42
+        converted = self._call_fut(field, original)
+        self.assertEqual(converted, str(original))
+
+
+class Test_snake_to_camel_case(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _snake_to_camel_case
+
+        return _snake_to_camel_case(value)
+
+    def test_w_snake_case_string(self):
+        self.assertEqual(self._call_fut("friendly_name"), "friendlyName")
+
+    def test_w_camel_case_string(self):
+        self.assertEqual(self._call_fut("friendlyName"), "friendlyName")
+
+
+class Test__get_sub_prop(unittest.TestCase):
+    def _call_fut(self, container, keys, **kw):
+        from google.cloud.bigquery._helpers import _get_sub_prop
+
+        return _get_sub_prop(container, keys, **kw)
+
+    def test_w_empty_container_default_default(self):
+        self.assertIsNone(self._call_fut({}, ["key1"]))
+
+    def test_w_missing_key_explicit_default(self):
+        self.assertEqual(self._call_fut({"key2": 2}, ["key1"], default=1), 1)
+
+    def test_w_matching_single_key(self):
+        self.assertEqual(self._call_fut({"key1": 1}, ["key1"]), 1)
+
+    def test_w_matching_first_key_missing_second_key(self):
+        self.assertIsNone(self._call_fut({"key1": {"key3": 3}}, ["key1", "key2"]))
+
+    def test_w_matching_first_key_matching_second_key(self):
+        self.assertEqual(self._call_fut({"key1": {"key2": 2}}, ["key1", "key2"]), 2)
+
+
+class Test__set_sub_prop(unittest.TestCase):
+    def _call_fut(self, container, keys, value):
+        from google.cloud.bigquery._helpers import _set_sub_prop
+
+        return _set_sub_prop(container, keys, value)
+
+    def test_w_empty_container_single_key(self):
+        container = {}
+        self._call_fut(container, ["key1"], "value")
+        self.assertEqual(container, {"key1": "value"})
+
+    def test_w_empty_container_nested_keys(self):
+        container = {}
+        self._call_fut(container, ["key1", "key2", "key3"], "value")
+        self.assertEqual(container, {"key1": {"key2": {"key3": "value"}}})
+
+    def test_w_existing_value(self):
+        container = {"key1": "before"}
+        self._call_fut(container, ["key1"], "after")
+        self.assertEqual(container, {"key1": "after"})
+
+    def test_w_nested_keys_existing_value(self):
+        container = {"key1": {"key2": {"key3": "before"}}}
+        self._call_fut(container, ["key1", "key2", "key3"], "after")
+        self.assertEqual(container, {"key1": {"key2": {"key3": "after"}}})
+
+
+class Test__del_sub_prop(unittest.TestCase):
+    def _call_fut(self, container, keys):
+        from google.cloud.bigquery._helpers import _del_sub_prop
+
+        return _del_sub_prop(container, keys)
+
+    def test_w_single_key(self):
+        container = {"key1": "value"}
+        self._call_fut(container, ["key1"])
+        self.assertEqual(container, {})
+
+    def test_w_empty_container_nested_keys(self):
+        container = {}
+        self._call_fut(container, ["key1", "key2", "key3"])
+        self.assertEqual(container, {"key1": {"key2": {}}})
+
+    def test_w_existing_value_nested_keys(self):
+        container = {"key1": {"key2": {"key3": "value"}}}
+        self._call_fut(container, ["key1", "key2", "key3"])
+        self.assertEqual(container, {"key1": {"key2": {}}})
+
+
+class Test__int_or_none(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _int_or_none
+
+        return _int_or_none(value)
+
+    def test_w_num_string(self):
+        self.assertEqual(self._call_fut("123"), 123)
+
+    def test_w_none(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_w_int(self):
+        self.assertEqual(self._call_fut(123), 123)
+
+    def test_w_non_num_string(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("ham")
+
+
+class Test__str_or_none(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.bigquery._helpers import _str_or_none
+
+        return _str_or_none(value)
+
+    def test_w_int(self):
+        self.assertEqual(self._call_fut(123), "123")
+
+    def test_w_none(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_w_str(self):
+        self.assertEqual(self._call_fut("ham"), "ham")
+
+
+class _Field(object):
+    def __init__(self, mode, name="unknown", field_type="UNKNOWN", fields=()):
+        self.mode = mode
+        self.name = name
+        self.field_type = field_type
+        self.fields = fields
diff --git a/bigquery/tests/unit/test__http.py b/bigquery/tests/unit/test__http.py
new file mode 100644
index 000000000000..629e8031a52f
--- /dev/null
+++ b/bigquery/tests/unit/test__http.py
@@ -0,0 +1,108 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+import requests
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_build_api_url_no_extra_query_params(self):
+        conn = self._make_one(object())
+        URI = "/".join([conn.DEFAULT_API_ENDPOINT, "bigquery", conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_custom_endpoint(self):
+        custom_endpoint = "https://www.foo-googleapis.com"
+        conn = self._make_one(object(), api_endpoint=custom_endpoint)
+        URI = "/".join([custom_endpoint, "bigquery", conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_extra_query_params(self):
+        from six.moves.urllib.parse import parse_qsl
+        from six.moves.urllib.parse import urlsplit
+
+        conn = self._make_one(object())
+        uri = conn.build_api_url("/foo", {"bar": "baz"})
+        scheme, netloc, path, qs, _ = urlsplit(uri)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        self.assertEqual(path, "/".join(["", "bigquery", conn.API_VERSION, "foo"]))
+        parms = dict(parse_qsl(qs))
+        self.assertEqual(parms["bar"], "baz")
+
+    def test_user_agent(self):
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        conn.user_agent = "my-application/1.2.3"
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
+        self.assertIn("my-application/1.2.3", conn.user_agent)
+
+    def test_extra_headers_replace(self):
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        conn.extra_headers = {"x-test-header": "a test value"}
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+            "x-test-header": "a test value",
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
diff --git a/bigquery/tests/unit/test__pandas_helpers.py b/bigquery/tests/unit/test__pandas_helpers.py
new file mode 100644
index 000000000000..b539abe9a89a
--- /dev/null
+++ b/bigquery/tests/unit/test__pandas_helpers.py
@@ -0,0 +1,907 @@
+# 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.
+
+import collections
+import datetime
+import decimal
+import functools
+import warnings
+
+import mock
+
+try:
+    import pandas
+    import pandas.api.types
+    import pandas.testing
+except ImportError:  # pragma: NO COVER
+    pandas = None
+try:
+    import pyarrow
+    import pyarrow.types
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+import pytest
+import pytz
+
+from google.cloud.bigquery import schema
+
+
+@pytest.fixture
+def module_under_test():
+    from google.cloud.bigquery import _pandas_helpers
+
+    return _pandas_helpers
+
+
+def is_none(value):
+    return value is None
+
+
+def is_datetime(type_):
+    # See: https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#datetime-type
+    return all_(
+        pyarrow.types.is_timestamp,
+        lambda type_: type_.unit == "us",
+        lambda type_: type_.tz is None,
+    )(type_)
+
+
+def is_numeric(type_):
+    # See: https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#numeric-type
+    return all_(
+        pyarrow.types.is_decimal,
+        lambda type_: type_.precision == 38,
+        lambda type_: type_.scale == 9,
+    )(type_)
+
+
+def is_timestamp(type_):
+    # See: https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#timestamp-type
+    return all_(
+        pyarrow.types.is_timestamp,
+        lambda type_: type_.unit == "us",
+        lambda type_: type_.tz == "UTC",
+    )(type_)
+
+
+def do_all(functions, value):
+    return all((func(value) for func in functions))
+
+
+def all_(*functions):
+    return functools.partial(do_all, functions)
+
+
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_is_datetime():
+    assert is_datetime(pyarrow.timestamp("us", tz=None))
+    assert not is_datetime(pyarrow.timestamp("ms", tz=None))
+    assert not is_datetime(pyarrow.timestamp("us", tz="UTC"))
+    assert not is_datetime(pyarrow.string())
+
+
+def test_do_all():
+    assert do_all((lambda _: True, lambda _: True), None)
+    assert not do_all((lambda _: True, lambda _: False), None)
+    assert not do_all((lambda _: False,), None)
+
+
+def test_all_():
+    assert all_(lambda _: True, lambda _: True)(None)
+    assert not all_(lambda _: True, lambda _: False)(None)
+
+
+@pytest.mark.parametrize(
+    "bq_type,bq_mode,is_correct_type",
+    [
+        ("STRING", "NULLABLE", pyarrow.types.is_string),
+        ("STRING", None, pyarrow.types.is_string),
+        ("string", "NULLABLE", pyarrow.types.is_string),
+        ("StRiNg", "NULLABLE", pyarrow.types.is_string),
+        ("BYTES", "NULLABLE", pyarrow.types.is_binary),
+        ("INTEGER", "NULLABLE", pyarrow.types.is_int64),
+        ("INT64", "NULLABLE", pyarrow.types.is_int64),
+        ("FLOAT", "NULLABLE", pyarrow.types.is_float64),
+        ("FLOAT64", "NULLABLE", pyarrow.types.is_float64),
+        ("NUMERIC", "NULLABLE", is_numeric),
+        ("BOOLEAN", "NULLABLE", pyarrow.types.is_boolean),
+        ("BOOL", "NULLABLE", pyarrow.types.is_boolean),
+        ("TIMESTAMP", "NULLABLE", is_timestamp),
+        ("DATE", "NULLABLE", pyarrow.types.is_date32),
+        ("TIME", "NULLABLE", pyarrow.types.is_time64),
+        ("DATETIME", "NULLABLE", is_datetime),
+        ("GEOGRAPHY", "NULLABLE", pyarrow.types.is_string),
+        ("UNKNOWN_TYPE", "NULLABLE", is_none),
+        # Use pyarrow.list_(item_type) for repeated (array) fields.
+        (
+            "STRING",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_string(type_.value_type),
+            ),
+        ),
+        (
+            "STRING",
+            "repeated",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_string(type_.value_type),
+            ),
+        ),
+        (
+            "STRING",
+            "RePeAtEd",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_string(type_.value_type),
+            ),
+        ),
+        (
+            "BYTES",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_binary(type_.value_type),
+            ),
+        ),
+        (
+            "INTEGER",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_int64(type_.value_type),
+            ),
+        ),
+        (
+            "INT64",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_int64(type_.value_type),
+            ),
+        ),
+        (
+            "FLOAT",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_float64(type_.value_type),
+            ),
+        ),
+        (
+            "FLOAT64",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_float64(type_.value_type),
+            ),
+        ),
+        (
+            "NUMERIC",
+            "REPEATED",
+            all_(pyarrow.types.is_list, lambda type_: is_numeric(type_.value_type)),
+        ),
+        (
+            "BOOLEAN",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_boolean(type_.value_type),
+            ),
+        ),
+        (
+            "BOOL",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_boolean(type_.value_type),
+            ),
+        ),
+        (
+            "TIMESTAMP",
+            "REPEATED",
+            all_(pyarrow.types.is_list, lambda type_: is_timestamp(type_.value_type)),
+        ),
+        (
+            "DATE",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_date32(type_.value_type),
+            ),
+        ),
+        (
+            "TIME",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_time64(type_.value_type),
+            ),
+        ),
+        (
+            "DATETIME",
+            "REPEATED",
+            all_(pyarrow.types.is_list, lambda type_: is_datetime(type_.value_type)),
+        ),
+        (
+            "GEOGRAPHY",
+            "REPEATED",
+            all_(
+                pyarrow.types.is_list,
+                lambda type_: pyarrow.types.is_string(type_.value_type),
+            ),
+        ),
+        ("RECORD", "REPEATED", is_none),
+        ("UNKNOWN_TYPE", "REPEATED", is_none),
+    ],
+)
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_data_type(module_under_test, bq_type, bq_mode, is_correct_type):
+    field = schema.SchemaField("ignored_name", bq_type, mode=bq_mode)
+    actual = module_under_test.bq_to_arrow_data_type(field)
+    assert is_correct_type(actual)
+
+
+@pytest.mark.parametrize("bq_type", ["RECORD", "record", "STRUCT", "struct"])
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_data_type_w_struct(module_under_test, bq_type):
+    fields = (
+        schema.SchemaField("field01", "STRING"),
+        schema.SchemaField("field02", "BYTES"),
+        schema.SchemaField("field03", "INTEGER"),
+        schema.SchemaField("field04", "INT64"),
+        schema.SchemaField("field05", "FLOAT"),
+        schema.SchemaField("field06", "FLOAT64"),
+        schema.SchemaField("field07", "NUMERIC"),
+        schema.SchemaField("field08", "BOOLEAN"),
+        schema.SchemaField("field09", "BOOL"),
+        schema.SchemaField("field10", "TIMESTAMP"),
+        schema.SchemaField("field11", "DATE"),
+        schema.SchemaField("field12", "TIME"),
+        schema.SchemaField("field13", "DATETIME"),
+        schema.SchemaField("field14", "GEOGRAPHY"),
+    )
+    field = schema.SchemaField("ignored_name", bq_type, mode="NULLABLE", fields=fields)
+    actual = module_under_test.bq_to_arrow_data_type(field)
+    expected = pyarrow.struct(
+        (
+            pyarrow.field("field01", pyarrow.string()),
+            pyarrow.field("field02", pyarrow.binary()),
+            pyarrow.field("field03", pyarrow.int64()),
+            pyarrow.field("field04", pyarrow.int64()),
+            pyarrow.field("field05", pyarrow.float64()),
+            pyarrow.field("field06", pyarrow.float64()),
+            pyarrow.field("field07", module_under_test.pyarrow_numeric()),
+            pyarrow.field("field08", pyarrow.bool_()),
+            pyarrow.field("field09", pyarrow.bool_()),
+            pyarrow.field("field10", module_under_test.pyarrow_timestamp()),
+            pyarrow.field("field11", pyarrow.date32()),
+            pyarrow.field("field12", module_under_test.pyarrow_time()),
+            pyarrow.field("field13", module_under_test.pyarrow_datetime()),
+            pyarrow.field("field14", pyarrow.string()),
+        )
+    )
+    assert pyarrow.types.is_struct(actual)
+    assert actual.num_children == len(fields)
+    assert actual.equals(expected)
+
+
+@pytest.mark.parametrize("bq_type", ["RECORD", "record", "STRUCT", "struct"])
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_data_type_w_array_struct(module_under_test, bq_type):
+    fields = (
+        schema.SchemaField("field01", "STRING"),
+        schema.SchemaField("field02", "BYTES"),
+        schema.SchemaField("field03", "INTEGER"),
+        schema.SchemaField("field04", "INT64"),
+        schema.SchemaField("field05", "FLOAT"),
+        schema.SchemaField("field06", "FLOAT64"),
+        schema.SchemaField("field07", "NUMERIC"),
+        schema.SchemaField("field08", "BOOLEAN"),
+        schema.SchemaField("field09", "BOOL"),
+        schema.SchemaField("field10", "TIMESTAMP"),
+        schema.SchemaField("field11", "DATE"),
+        schema.SchemaField("field12", "TIME"),
+        schema.SchemaField("field13", "DATETIME"),
+        schema.SchemaField("field14", "GEOGRAPHY"),
+    )
+    field = schema.SchemaField("ignored_name", bq_type, mode="REPEATED", fields=fields)
+    actual = module_under_test.bq_to_arrow_data_type(field)
+    expected_value_type = pyarrow.struct(
+        (
+            pyarrow.field("field01", pyarrow.string()),
+            pyarrow.field("field02", pyarrow.binary()),
+            pyarrow.field("field03", pyarrow.int64()),
+            pyarrow.field("field04", pyarrow.int64()),
+            pyarrow.field("field05", pyarrow.float64()),
+            pyarrow.field("field06", pyarrow.float64()),
+            pyarrow.field("field07", module_under_test.pyarrow_numeric()),
+            pyarrow.field("field08", pyarrow.bool_()),
+            pyarrow.field("field09", pyarrow.bool_()),
+            pyarrow.field("field10", module_under_test.pyarrow_timestamp()),
+            pyarrow.field("field11", pyarrow.date32()),
+            pyarrow.field("field12", module_under_test.pyarrow_time()),
+            pyarrow.field("field13", module_under_test.pyarrow_datetime()),
+            pyarrow.field("field14", pyarrow.string()),
+        )
+    )
+    assert pyarrow.types.is_list(actual)
+    assert pyarrow.types.is_struct(actual.value_type)
+    assert actual.value_type.num_children == len(fields)
+    assert actual.value_type.equals(expected_value_type)
+
+
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_data_type_w_struct_unknown_subfield(module_under_test):
+    fields = (
+        schema.SchemaField("field1", "STRING"),
+        schema.SchemaField("field2", "INTEGER"),
+        # Don't know what to convert UNKNOWN_TYPE to, let type inference work,
+        # instead.
+        schema.SchemaField("field3", "UNKNOWN_TYPE"),
+    )
+    field = schema.SchemaField("ignored_name", "RECORD", mode="NULLABLE", fields=fields)
+
+    with warnings.catch_warnings(record=True) as warned:
+        actual = module_under_test.bq_to_arrow_data_type(field)
+
+    assert actual is None
+    assert len(warned) == 1
+    warning = warned[0]
+    assert "field3" in str(warning)
+
+
+@pytest.mark.parametrize(
+    "bq_type,rows",
+    [
+        ("STRING", ["abc", None, "def", None]),
+        ("BYTES", [b"abc", None, b"def", None]),
+        ("INTEGER", [123, None, 456, None]),
+        ("INT64", [-9223372036854775808, None, 9223372036854775807, 123]),
+        ("FLOAT", [1.25, None, 3.5, None]),
+        (
+            "NUMERIC",
+            [
+                decimal.Decimal("-99999999999999999999999999999.999999999"),
+                None,
+                decimal.Decimal("99999999999999999999999999999.999999999"),
+                decimal.Decimal("999.123456789"),
+            ],
+        ),
+        ("BOOLEAN", [True, None, False, None]),
+        ("BOOL", [False, None, True, None]),
+        # TODO: Once https://issues.apache.org/jira/browse/ARROW-5450 is
+        # resolved, test with TIMESTAMP column. Conversion from pyarrow
+        # TimestampArray to list of Python objects fails with OverflowError:
+        # Python int too large to convert to C long.
+        #
+        # (
+        #     "TIMESTAMP",
+        #     [
+        #         datetime.datetime(1, 1, 1, 0, 0, 0, tzinfo=pytz.utc),
+        #         None,
+        #         datetime.datetime(9999, 12, 31, 23, 59, 59, 999999, tzinfo=pytz.utc),
+        #         datetime.datetime(1970, 1, 1, 0, 0, 0, tzinfo=pytz.utc),
+        #     ],
+        # ),
+        (
+            "DATE",
+            [
+                datetime.date(1, 1, 1),
+                None,
+                datetime.date(9999, 12, 31),
+                datetime.date(1970, 1, 1),
+            ],
+        ),
+        (
+            "TIME",
+            [
+                datetime.time(0, 0, 0),
+                None,
+                datetime.time(23, 59, 59, 999999),
+                datetime.time(12, 0, 0),
+            ],
+        ),
+        # TODO: Once https://issues.apache.org/jira/browse/ARROW-5450 is
+        # resolved, test with DATETIME column. Conversion from pyarrow
+        # TimestampArray to list of Python objects fails with OverflowError:
+        # Python int too large to convert to C long.
+        #
+        # (
+        #     "DATETIME",
+        #     [
+        #         datetime.datetime(1, 1, 1, 0, 0, 0),
+        #         None,
+        #         datetime.datetime(9999, 12, 31, 23, 59, 59, 999999),
+        #         datetime.datetime(1970, 1, 1, 0, 0, 0),
+        #     ],
+        # ),
+        (
+            "GEOGRAPHY",
+            [
+                "POINT(30 10)",
+                None,
+                "LINESTRING (30 10, 10 30, 40 40)",
+                "POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))",
+            ],
+        ),
+    ],
+)
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_array_w_nullable_scalars(module_under_test, bq_type, rows):
+    series = pandas.Series(rows, dtype="object")
+    bq_field = schema.SchemaField("field_name", bq_type)
+    arrow_array = module_under_test.bq_to_arrow_array(series, bq_field)
+    roundtrip = arrow_array.to_pylist()
+    assert rows == roundtrip
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_array_w_arrays(module_under_test):
+    rows = [[1, 2, 3], [], [4, 5, 6]]
+    series = pandas.Series(rows, dtype="object")
+    bq_field = schema.SchemaField("field_name", "INTEGER", mode="REPEATED")
+    arrow_array = module_under_test.bq_to_arrow_array(series, bq_field)
+    roundtrip = arrow_array.to_pylist()
+    assert rows == roundtrip
+
+
+@pytest.mark.parametrize("bq_type", ["RECORD", "record", "STRUCT", "struct"])
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_array_w_structs(module_under_test, bq_type):
+    rows = [
+        {"int_col": 123, "string_col": "abc"},
+        None,
+        {"int_col": 456, "string_col": "def"},
+    ]
+    series = pandas.Series(rows, dtype="object")
+    bq_field = schema.SchemaField(
+        "field_name",
+        bq_type,
+        fields=(
+            schema.SchemaField("int_col", "INTEGER"),
+            schema.SchemaField("string_col", "STRING"),
+        ),
+    )
+    arrow_array = module_under_test.bq_to_arrow_array(series, bq_field)
+    roundtrip = arrow_array.to_pylist()
+    assert rows == roundtrip
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_array_w_special_floats(module_under_test):
+    bq_field = schema.SchemaField("field_name", "FLOAT64")
+    rows = [float("-inf"), float("nan"), float("inf"), None]
+    series = pandas.Series(rows, dtype="object")
+    arrow_array = module_under_test.bq_to_arrow_array(series, bq_field)
+    roundtrip = arrow_array.to_pylist()
+    assert len(rows) == len(roundtrip)
+    assert roundtrip[0] == float("-inf")
+    # Since we are converting from pandas, NaN is treated as NULL in pyarrow
+    # due to pandas conventions.
+    # https://arrow.apache.org/docs/python/data.html#none-values-and-nan-handling
+    assert roundtrip[1] is None
+    assert roundtrip[2] == float("inf")
+    assert roundtrip[3] is None
+
+
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_bq_to_arrow_schema_w_unknown_type(module_under_test):
+    fields = (
+        schema.SchemaField("field1", "STRING"),
+        schema.SchemaField("field2", "INTEGER"),
+        # Don't know what to convert UNKNOWN_TYPE to, let type inference work,
+        # instead.
+        schema.SchemaField("field3", "UNKNOWN_TYPE"),
+    )
+    actual = module_under_test.bq_to_arrow_schema(fields)
+    assert actual is None
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_not_found(module_under_test):
+    dataframe = pandas.DataFrame({"not_the_column_youre_looking_for": [1, 2, 3]})
+    with pytest.raises(ValueError, match="col_is_missing"):
+        module_under_test.get_column_or_index(dataframe, "col_is_missing")
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_with_multiindex_not_found(module_under_test):
+    dataframe = pandas.DataFrame(
+        {"column_name": [1, 2, 3, 4, 5, 6]},
+        index=pandas.MultiIndex.from_tuples(
+            [("a", 0), ("a", 1), ("b", 0), ("b", 1), ("c", 0), ("c", 1)]
+        ),
+    )
+    with pytest.raises(ValueError, match="not_in_df"):
+        module_under_test.get_column_or_index(dataframe, "not_in_df")
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_with_both_prefers_column(module_under_test):
+    dataframe = pandas.DataFrame(
+        {"some_name": [1, 2, 3]}, index=pandas.Index([0, 1, 2], name="some_name")
+    )
+    series = module_under_test.get_column_or_index(dataframe, "some_name")
+    expected = pandas.Series([1, 2, 3], name="some_name")
+    pandas.testing.assert_series_equal(series, expected)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_with_column(module_under_test):
+    dataframe = pandas.DataFrame({"column_name": [1, 2, 3], "other_column": [4, 5, 6]})
+    series = module_under_test.get_column_or_index(dataframe, "column_name")
+    expected = pandas.Series([1, 2, 3], name="column_name")
+    pandas.testing.assert_series_equal(series, expected)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_with_named_index(module_under_test):
+    dataframe = pandas.DataFrame(
+        {"column_name": [1, 2, 3]}, index=pandas.Index([4, 5, 6], name="index_name")
+    )
+    series = module_under_test.get_column_or_index(dataframe, "index_name")
+    expected = pandas.Series([4, 5, 6], name="index_name")
+    pandas.testing.assert_series_equal(series, expected)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_with_datetimeindex(module_under_test):
+    datetimes = [
+        datetime.datetime(2000, 1, 2, 3, 4, 5, 101),
+        datetime.datetime(2006, 7, 8, 9, 10, 11, 202),
+        datetime.datetime(2012, 1, 14, 15, 16, 17, 303),
+    ]
+    dataframe = pandas.DataFrame(
+        {"column_name": [1, 2, 3]},
+        index=pandas.DatetimeIndex(datetimes, name="index_name"),
+    )
+    series = module_under_test.get_column_or_index(dataframe, "index_name")
+    expected = pandas.Series(datetimes, name="index_name")
+    pandas.testing.assert_series_equal(series, expected)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_get_column_or_index_with_multiindex(module_under_test):
+    dataframe = pandas.DataFrame(
+        {"column_name": [1, 2, 3, 4, 5, 6]},
+        index=pandas.MultiIndex.from_tuples(
+            [("a", 0), ("a", 1), ("b", 0), ("b", 1), ("c", 0), ("c", 1)],
+            names=["letters", "numbers"],
+        ),
+    )
+
+    series = module_under_test.get_column_or_index(dataframe, "letters")
+    expected = pandas.Series(["a", "a", "b", "b", "c", "c"], name="letters")
+    pandas.testing.assert_series_equal(series, expected)
+
+    series = module_under_test.get_column_or_index(dataframe, "numbers")
+    expected = pandas.Series([0, 1, 0, 1, 0, 1], name="numbers")
+    pandas.testing.assert_series_equal(series, expected)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_list_columns_and_indexes_without_named_index(module_under_test):
+    df_data = collections.OrderedDict(
+        [
+            ("a_series", [1, 2, 3, 4]),
+            ("b_series", [0.1, 0.2, 0.3, 0.4]),
+            ("c_series", ["a", "b", "c", "d"]),
+        ]
+    )
+    dataframe = pandas.DataFrame(df_data)
+
+    columns_and_indexes = module_under_test.list_columns_and_indexes(dataframe)
+    expected = [
+        ("a_series", pandas.api.types.pandas_dtype("int64")),
+        ("b_series", pandas.api.types.pandas_dtype("float64")),
+        ("c_series", pandas.api.types.pandas_dtype("object")),
+    ]
+    assert columns_and_indexes == expected
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_list_columns_and_indexes_with_named_index_same_as_column_name(
+    module_under_test
+):
+    df_data = collections.OrderedDict(
+        [
+            ("a_series", [1, 2, 3, 4]),
+            ("b_series", [0.1, 0.2, 0.3, 0.4]),
+            ("c_series", ["a", "b", "c", "d"]),
+        ]
+    )
+    dataframe = pandas.DataFrame(
+        df_data,
+        # Use same name as an integer column but a different datatype so that
+        # we can verify that the column is listed but the index isn't.
+        index=pandas.Index([0.1, 0.2, 0.3, 0.4], name="a_series"),
+    )
+
+    columns_and_indexes = module_under_test.list_columns_and_indexes(dataframe)
+    expected = [
+        ("a_series", pandas.api.types.pandas_dtype("int64")),
+        ("b_series", pandas.api.types.pandas_dtype("float64")),
+        ("c_series", pandas.api.types.pandas_dtype("object")),
+    ]
+    assert columns_and_indexes == expected
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_list_columns_and_indexes_with_named_index(module_under_test):
+    df_data = collections.OrderedDict(
+        [
+            ("a_series", [1, 2, 3, 4]),
+            ("b_series", [0.1, 0.2, 0.3, 0.4]),
+            ("c_series", ["a", "b", "c", "d"]),
+        ]
+    )
+    dataframe = pandas.DataFrame(
+        df_data, index=pandas.Index([4, 5, 6, 7], name="a_index")
+    )
+
+    columns_and_indexes = module_under_test.list_columns_and_indexes(dataframe)
+    expected = [
+        ("a_index", pandas.api.types.pandas_dtype("int64")),
+        ("a_series", pandas.api.types.pandas_dtype("int64")),
+        ("b_series", pandas.api.types.pandas_dtype("float64")),
+        ("c_series", pandas.api.types.pandas_dtype("object")),
+    ]
+    assert columns_and_indexes == expected
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_list_columns_and_indexes_with_multiindex(module_under_test):
+    df_data = collections.OrderedDict(
+        [
+            ("a_series", [1, 2, 3, 4]),
+            ("b_series", [0.1, 0.2, 0.3, 0.4]),
+            ("c_series", ["a", "b", "c", "d"]),
+        ]
+    )
+    dataframe = pandas.DataFrame(
+        df_data,
+        index=pandas.MultiIndex.from_tuples(
+            [(0, 0, 41), (0, 0, 42), (1, 0, 41), (1, 1, 41)],
+            names=[
+                "a_index",
+                # Use same name as column, but different dtype so we can verify
+                # the column type is included.
+                "b_series",
+                "c_index",
+            ],
+        ),
+    )
+
+    columns_and_indexes = module_under_test.list_columns_and_indexes(dataframe)
+    expected = [
+        ("a_index", pandas.api.types.pandas_dtype("int64")),
+        ("c_index", pandas.api.types.pandas_dtype("int64")),
+        ("a_series", pandas.api.types.pandas_dtype("int64")),
+        ("b_series", pandas.api.types.pandas_dtype("float64")),
+        ("c_series", pandas.api.types.pandas_dtype("object")),
+    ]
+    assert columns_and_indexes == expected
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_dataframe_to_arrow_with_multiindex(module_under_test):
+    bq_schema = (
+        schema.SchemaField("str_index", "STRING"),
+        # int_index is intentionally omitted, to verify that it's okay to be
+        # missing indexes from the schema.
+        schema.SchemaField("dt_index", "DATETIME"),
+        schema.SchemaField("int_col", "INTEGER"),
+        schema.SchemaField("nullable_int_col", "INTEGER"),
+        schema.SchemaField("str_col", "STRING"),
+    )
+    df_data = collections.OrderedDict(
+        [
+            ("int_col", [1, 2, 3, 4, 5, 6]),
+            ("nullable_int_col", [6.0, float("nan"), 7.0, float("nan"), 8.0, 9.0]),
+            ("str_col", ["apple", "banana", "cherry", "durian", "etrog", "fig"]),
+        ]
+    )
+    df_index = pandas.MultiIndex.from_tuples(
+        [
+            ("a", 0, datetime.datetime(1999, 12, 31, 23, 59, 59, 999999)),
+            ("a", 0, datetime.datetime(2000, 1, 1, 0, 0, 0)),
+            ("a", 1, datetime.datetime(1999, 12, 31, 23, 59, 59, 999999)),
+            ("b", 1, datetime.datetime(2000, 1, 1, 0, 0, 0)),
+            ("b", 0, datetime.datetime(1999, 12, 31, 23, 59, 59, 999999)),
+            ("b", 0, datetime.datetime(2000, 1, 1, 0, 0, 0)),
+        ],
+        names=["str_index", "int_index", "dt_index"],
+    )
+    dataframe = pandas.DataFrame(df_data, index=df_index)
+
+    arrow_table = module_under_test.dataframe_to_arrow(dataframe, bq_schema)
+
+    assert arrow_table.schema.names == [
+        "str_index",
+        "dt_index",
+        "int_col",
+        "nullable_int_col",
+        "str_col",
+    ]
+    arrow_data = arrow_table.to_pydict()
+    assert arrow_data["str_index"] == ["a", "a", "a", "b", "b", "b"]
+    expected_dt_index = [
+        pandas.Timestamp(dt)
+        for dt in (
+            datetime.datetime(1999, 12, 31, 23, 59, 59, 999999),
+            datetime.datetime(2000, 1, 1, 0, 0, 0),
+            datetime.datetime(1999, 12, 31, 23, 59, 59, 999999),
+            datetime.datetime(2000, 1, 1, 0, 0, 0),
+            datetime.datetime(1999, 12, 31, 23, 59, 59, 999999),
+            datetime.datetime(2000, 1, 1, 0, 0, 0),
+        )
+    ]
+    assert arrow_data["dt_index"] == expected_dt_index
+    assert arrow_data["int_col"] == [1, 2, 3, 4, 5, 6]
+    assert arrow_data["nullable_int_col"] == [6, None, 7, None, 8, 9]
+    assert arrow_data["str_col"] == [
+        "apple",
+        "banana",
+        "cherry",
+        "durian",
+        "etrog",
+        "fig",
+    ]
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_dataframe_to_arrow_with_required_fields(module_under_test):
+    bq_schema = (
+        schema.SchemaField("field01", "STRING", mode="REQUIRED"),
+        schema.SchemaField("field02", "BYTES", mode="REQUIRED"),
+        schema.SchemaField("field03", "INTEGER", mode="REQUIRED"),
+        schema.SchemaField("field04", "INT64", mode="REQUIRED"),
+        schema.SchemaField("field05", "FLOAT", mode="REQUIRED"),
+        schema.SchemaField("field06", "FLOAT64", mode="REQUIRED"),
+        schema.SchemaField("field07", "NUMERIC", mode="REQUIRED"),
+        schema.SchemaField("field08", "BOOLEAN", mode="REQUIRED"),
+        schema.SchemaField("field09", "BOOL", mode="REQUIRED"),
+        schema.SchemaField("field10", "TIMESTAMP", mode="REQUIRED"),
+        schema.SchemaField("field11", "DATE", mode="REQUIRED"),
+        schema.SchemaField("field12", "TIME", mode="REQUIRED"),
+        schema.SchemaField("field13", "DATETIME", mode="REQUIRED"),
+        schema.SchemaField("field14", "GEOGRAPHY", mode="REQUIRED"),
+    )
+    dataframe = pandas.DataFrame(
+        {
+            "field01": ["hello", "world"],
+            "field02": [b"abd", b"efg"],
+            "field03": [1, 2],
+            "field04": [3, 4],
+            "field05": [1.25, 9.75],
+            "field06": [-1.75, -3.5],
+            "field07": [decimal.Decimal("1.2345"), decimal.Decimal("6.7891")],
+            "field08": [True, False],
+            "field09": [False, True],
+            "field10": [
+                datetime.datetime(1970, 1, 1, 0, 0, 0, tzinfo=pytz.utc),
+                datetime.datetime(2012, 12, 21, 9, 7, 42, tzinfo=pytz.utc),
+            ],
+            "field11": [datetime.date(9999, 12, 31), datetime.date(1970, 1, 1)],
+            "field12": [datetime.time(23, 59, 59, 999999), datetime.time(12, 0, 0)],
+            "field13": [
+                datetime.datetime(1970, 1, 1, 0, 0, 0),
+                datetime.datetime(2012, 12, 21, 9, 7, 42),
+            ],
+            "field14": [
+                "POINT(30 10)",
+                "POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))",
+            ],
+        }
+    )
+
+    arrow_table = module_under_test.dataframe_to_arrow(dataframe, bq_schema)
+    arrow_schema = arrow_table.schema
+
+    assert len(arrow_schema) == len(bq_schema)
+    for arrow_field in arrow_schema:
+        assert not arrow_field.nullable
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_dataframe_to_arrow_with_unknown_type(module_under_test):
+    bq_schema = (
+        schema.SchemaField("field00", "UNKNOWN_TYPE"),
+        schema.SchemaField("field01", "STRING"),
+        schema.SchemaField("field02", "BYTES"),
+        schema.SchemaField("field03", "INTEGER"),
+    )
+    dataframe = pandas.DataFrame(
+        {
+            "field00": ["whoami", "whatami"],
+            "field01": ["hello", "world"],
+            "field02": [b"abd", b"efg"],
+            "field03": [1, 2],
+        }
+    )
+
+    with warnings.catch_warnings(record=True) as warned:
+        arrow_table = module_under_test.dataframe_to_arrow(dataframe, bq_schema)
+    arrow_schema = arrow_table.schema
+
+    assert len(warned) == 1
+    warning = warned[0]
+    assert "field00" in str(warning)
+
+    assert len(arrow_schema) == len(bq_schema)
+    assert arrow_schema[0].name == "field00"
+    assert arrow_schema[1].name == "field01"
+    assert arrow_schema[2].name == "field02"
+    assert arrow_schema[3].name == "field03"
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_dataframe_to_parquet_without_pyarrow(module_under_test, monkeypatch):
+    monkeypatch.setattr(module_under_test, "pyarrow", None)
+    with pytest.raises(ValueError) as exc_context:
+        module_under_test.dataframe_to_parquet(pandas.DataFrame(), (), None)
+    assert "pyarrow is required" in str(exc_context.value)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_dataframe_to_parquet_w_extra_fields(module_under_test, monkeypatch):
+    with pytest.raises(ValueError) as exc_context:
+        module_under_test.dataframe_to_parquet(
+            pandas.DataFrame(), (schema.SchemaField("not_in_df", "STRING"),), None
+        )
+    message = str(exc_context.value)
+    assert "bq_schema contains fields not present in dataframe" in message
+    assert "not_in_df" in message
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_dataframe_to_parquet_w_missing_fields(module_under_test, monkeypatch):
+    with pytest.raises(ValueError) as exc_context:
+        module_under_test.dataframe_to_parquet(
+            pandas.DataFrame({"not_in_bq": [1, 2, 3]}), (), None
+        )
+    message = str(exc_context.value)
+    assert "bq_schema is missing fields from dataframe" in message
+    assert "not_in_bq" in message
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(pyarrow is None, reason="Requires `pyarrow`")
+def test_dataframe_to_parquet_compression_method(module_under_test):
+    bq_schema = (schema.SchemaField("field00", "STRING"),)
+    dataframe = pandas.DataFrame({"field00": ["foo", "bar"]})
+
+    write_table_patch = mock.patch.object(
+        module_under_test.pyarrow.parquet, "write_table", autospec=True
+    )
+
+    with write_table_patch as fake_write_table:
+        module_under_test.dataframe_to_parquet(
+            dataframe, bq_schema, None, parquet_compression="ZSTD"
+        )
+
+    call_args = fake_write_table.call_args
+    assert call_args is not None
+    assert call_args.kwargs.get("compression") == "ZSTD"
diff --git a/bigquery/tests/unit/test_client.py b/bigquery/tests/unit/test_client.py
new file mode 100644
index 000000000000..f31d8587322b
--- /dev/null
+++ b/bigquery/tests/unit/test_client.py
@@ -0,0 +1,6168 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import copy
+import collections
+import datetime
+import decimal
+import email
+import gzip
+import io
+import json
+import unittest
+import warnings
+
+import mock
+import requests
+import six
+from six.moves import http_client
+import pytest
+import pytz
+
+try:
+    import pandas
+except (ImportError, AttributeError):  # pragma: NO COVER
+    pandas = None
+try:
+    import pyarrow
+except (ImportError, AttributeError):  # pragma: NO COVER
+    pyarrow = None
+
+import google.api_core.exceptions
+from google.api_core.gapic_v1 import client_info
+import google.cloud._helpers
+from google.cloud import bigquery_v2
+from google.cloud.bigquery.dataset import DatasetReference
+from tests.unit.helpers import make_connection
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_list_partitons_meta_info(project, dataset_id, table_id, num_rows=0):
+    return {
+        "tableReference": {
+            "projectId": project,
+            "datasetId": dataset_id,
+            "tableId": "{}$__PARTITIONS_SUMMARY__".format(table_id),
+        },
+        "schema": {
+            "fields": [
+                {"name": "project_id", "type": "STRING", "mode": "NULLABLE"},
+                {"name": "dataset_id", "type": "STRING", "mode": "NULLABLE"},
+                {"name": "table_id", "type": "STRING", "mode": "NULLABLE"},
+                {"name": "partition_id", "type": "STRING", "mode": "NULLABLE"},
+            ]
+        },
+        "etag": "ETAG",
+        "numRows": num_rows,
+    }
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    DS_ID = "DATASET_ID"
+    TABLE_ID = "TABLE_ID"
+    MODEL_ID = "MODEL_ID"
+    TABLE_REF = DatasetReference(PROJECT, DS_ID).table(TABLE_ID)
+    KMS_KEY_NAME = "projects/1/locations/global/keyRings/1/cryptoKeys/1"
+    LOCATION = "us-central"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _make_table_resource(self):
+        return {
+            "id": "%s:%s:%s" % (self.PROJECT, self.DS_ID, self.TABLE_ID),
+            "tableReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.TABLE_ID,
+            },
+        }
+
+    def test_ctor_defaults(self):
+        from google.cloud.bigquery._http import Connection
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, creds)
+        self.assertIs(client._connection.http, http)
+        self.assertIsNone(client.location)
+        self.assertEqual(
+            client._connection.API_BASE_URL, Connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_ctor_w_empty_client_options(self):
+        from google.api_core.client_options import ClientOptions
+
+        creds = _make_credentials()
+        http = object()
+        client_options = ClientOptions()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            client_options=client_options,
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, client._connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_ctor_w_client_options_dict(self):
+
+        creds = _make_credentials()
+        http = object()
+        client_options = {"api_endpoint": "https://www.foo-googleapis.com"}
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            client_options=client_options,
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://www.foo-googleapis.com"
+        )
+
+    def test_ctor_w_client_options_object(self):
+        from google.api_core.client_options import ClientOptions
+
+        creds = _make_credentials()
+        http = object()
+        client_options = ClientOptions(api_endpoint="https://www.foo-googleapis.com")
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            client_options=client_options,
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://www.foo-googleapis.com"
+        )
+
+    def test_ctor_w_location(self):
+        from google.cloud.bigquery._http import Connection
+
+        creds = _make_credentials()
+        http = object()
+        location = "us-central"
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _http=http, location=location
+        )
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, creds)
+        self.assertIs(client._connection.http, http)
+        self.assertEqual(client.location, location)
+
+    def test_ctor_w_query_job_config(self):
+        from google.cloud.bigquery._http import Connection
+        from google.cloud.bigquery import QueryJobConfig
+
+        creds = _make_credentials()
+        http = object()
+        location = "us-central"
+        job_config = QueryJobConfig()
+        job_config.dry_run = True
+
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            location=location,
+            default_query_job_config=job_config,
+        )
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, creds)
+        self.assertIs(client._connection.http, http)
+        self.assertEqual(client.location, location)
+
+        self.assertIsInstance(client._default_query_job_config, QueryJobConfig)
+        self.assertTrue(client._default_query_job_config.dry_run)
+
+    def test__get_query_results_miss_w_explicit_project_and_timeout(self):
+        from google.cloud.exceptions import NotFound
+
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection()
+
+        with self.assertRaises(NotFound):
+            client._get_query_results(
+                "nothere",
+                None,
+                project="other-project",
+                location=self.LOCATION,
+                timeout_ms=500,
+            )
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/other-project/queries/nothere",
+            query_params={"maxResults": 0, "timeoutMs": 500, "location": self.LOCATION},
+        )
+
+    def test__get_query_results_miss_w_client_location(self):
+        from google.cloud.exceptions import NotFound
+
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds, location=self.LOCATION)
+        conn = client._connection = make_connection()
+
+        with self.assertRaises(NotFound):
+            client._get_query_results("nothere", None)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/PROJECT/queries/nothere",
+            query_params={"maxResults": 0, "location": self.LOCATION},
+        )
+
+    def test__get_query_results_hit(self):
+        job_id = "query_job"
+        data = {
+            "kind": "bigquery#getQueryResultsResponse",
+            "etag": "some-tag",
+            "schema": {
+                "fields": [
+                    {"name": "title", "type": "STRING", "mode": "NULLABLE"},
+                    {"name": "unique_words", "type": "INTEGER", "mode": "NULLABLE"},
+                ]
+            },
+            "jobReference": {"projectId": self.PROJECT, "jobId": job_id},
+            "totalRows": "10",
+            "totalBytesProcessed": "2464625",
+            "jobComplete": True,
+            "cacheHit": False,
+        }
+
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        client._connection = make_connection(data)
+        query_results = client._get_query_results(job_id, None)
+
+        self.assertEqual(query_results.total_rows, 10)
+        self.assertTrue(query_results.complete)
+
+    def test_get_service_account_email(self):
+        path = "/projects/%s/serviceAccount" % (self.PROJECT,)
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        email = "bq-123@bigquery-encryption.iam.gserviceaccount.com"
+        resource = {"kind": "bigquery#getServiceAccountResponse", "email": email}
+        conn = client._connection = make_connection(resource)
+
+        service_account_email = client.get_service_account_email()
+
+        conn.api_request.assert_called_once_with(method="GET", path=path)
+        self.assertEqual(service_account_email, email)
+
+    def test_get_service_account_email_w_alternate_project(self):
+        project = "my-alternate-project"
+        path = "/projects/%s/serviceAccount" % (project,)
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        email = "bq-123@bigquery-encryption.iam.gserviceaccount.com"
+        resource = {"kind": "bigquery#getServiceAccountResponse", "email": email}
+        conn = client._connection = make_connection(resource)
+
+        service_account_email = client.get_service_account_email(project=project)
+
+        conn.api_request.assert_called_once_with(method="GET", path=path)
+        self.assertEqual(service_account_email, email)
+
+    def test_list_projects_defaults(self):
+        from google.cloud.bigquery.client import Project
+
+        PROJECT_1 = "PROJECT_ONE"
+        PROJECT_2 = "PROJECT_TWO"
+        TOKEN = "TOKEN"
+        DATA = {
+            "nextPageToken": TOKEN,
+            "projects": [
+                {
+                    "kind": "bigquery#project",
+                    "id": PROJECT_1,
+                    "numericId": 1,
+                    "projectReference": {"projectId": PROJECT_1},
+                    "friendlyName": "One",
+                },
+                {
+                    "kind": "bigquery#project",
+                    "id": PROJECT_2,
+                    "numericId": 2,
+                    "projectReference": {"projectId": PROJECT_2},
+                    "friendlyName": "Two",
+                },
+            ],
+        }
+        creds = _make_credentials()
+        client = self._make_one(PROJECT_1, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_projects()
+        page = six.next(iterator.pages)
+        projects = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(projects), len(DATA["projects"]))
+        for found, expected in zip(projects, DATA["projects"]):
+            self.assertIsInstance(found, Project)
+            self.assertEqual(found.project_id, expected["id"])
+            self.assertEqual(found.numeric_id, expected["numericId"])
+            self.assertEqual(found.friendly_name, expected["friendlyName"])
+        self.assertEqual(token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/projects", query_params={}
+        )
+
+    def test_list_projects_explicit_response_missing_projects_key(self):
+        TOKEN = "TOKEN"
+        DATA = {}
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_projects(max_results=3, page_token=TOKEN)
+        page = six.next(iterator.pages)
+        projects = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(projects), 0)
+        self.assertIsNone(token)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects",
+            query_params={"maxResults": 3, "pageToken": TOKEN},
+        )
+
+    def test_list_datasets_defaults(self):
+        from google.cloud.bigquery.dataset import DatasetListItem
+
+        DATASET_1 = "dataset_one"
+        DATASET_2 = "dataset_two"
+        PATH = "projects/%s/datasets" % self.PROJECT
+        TOKEN = "TOKEN"
+        DATA = {
+            "nextPageToken": TOKEN,
+            "datasets": [
+                {
+                    "kind": "bigquery#dataset",
+                    "id": "%s:%s" % (self.PROJECT, DATASET_1),
+                    "datasetReference": {
+                        "datasetId": DATASET_1,
+                        "projectId": self.PROJECT,
+                    },
+                    "friendlyName": None,
+                },
+                {
+                    "kind": "bigquery#dataset",
+                    "id": "%s:%s" % (self.PROJECT, DATASET_2),
+                    "datasetReference": {
+                        "datasetId": DATASET_2,
+                        "projectId": self.PROJECT,
+                    },
+                    "friendlyName": "Two",
+                },
+            ],
+        }
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_datasets()
+        page = six.next(iterator.pages)
+        datasets = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(datasets), len(DATA["datasets"]))
+        for found, expected in zip(datasets, DATA["datasets"]):
+            self.assertIsInstance(found, DatasetListItem)
+            self.assertEqual(found.full_dataset_id, expected["id"])
+            self.assertEqual(found.friendly_name, expected["friendlyName"])
+        self.assertEqual(token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={}
+        )
+
+    def test_list_datasets_w_project(self):
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection({})
+
+        list(client.list_datasets(project="other-project"))
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/projects/other-project/datasets", query_params={}
+        )
+
+    def test_list_datasets_explicit_response_missing_datasets_key(self):
+        PATH = "projects/%s/datasets" % self.PROJECT
+        TOKEN = "TOKEN"
+        FILTER = "FILTER"
+        DATA = {}
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_datasets(
+            include_all=True, filter=FILTER, max_results=3, page_token=TOKEN
+        )
+        page = six.next(iterator.pages)
+        datasets = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(datasets), 0)
+        self.assertIsNone(token)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/%s" % PATH,
+            query_params={
+                "all": True,
+                "filter": FILTER,
+                "maxResults": 3,
+                "pageToken": TOKEN,
+            },
+        )
+
+    def test_dataset_with_specified_project(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        dataset = client.dataset(self.DS_ID, self.PROJECT)
+        self.assertIsInstance(dataset, DatasetReference)
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+
+    def test_dataset_with_default_project(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        dataset = client.dataset(self.DS_ID)
+        self.assertIsInstance(dataset, DatasetReference)
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+
+    def test_get_dataset(self):
+        from google.cloud.exceptions import ServerError
+
+        path = "projects/%s/datasets/%s" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        resource = {
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+        }
+        conn = client._connection = make_connection(resource)
+        dataset_ref = client.dataset(self.DS_ID)
+
+        dataset = client.get_dataset(dataset_ref)
+
+        conn.api_request.assert_called_once_with(method="GET", path="/%s" % path)
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+
+        # Test retry.
+
+        # Not a cloud API exception (missing 'errors' field).
+        client._connection = make_connection(Exception(""), resource)
+        with self.assertRaises(Exception):
+            client.get_dataset(dataset_ref)
+
+        # Zero-length errors field.
+        client._connection = make_connection(ServerError(""), resource)
+        with self.assertRaises(ServerError):
+            client.get_dataset(dataset_ref)
+
+        # Non-retryable reason.
+        client._connection = make_connection(
+            ServerError("", errors=[{"reason": "serious"}]), resource
+        )
+        with self.assertRaises(ServerError):
+            client.get_dataset(dataset_ref)
+
+        # Retryable reason, but retry is disabled.
+        client._connection = make_connection(
+            ServerError("", errors=[{"reason": "backendError"}]), resource
+        )
+        with self.assertRaises(ServerError):
+            client.get_dataset(dataset_ref, retry=None)
+
+        # Retryable reason, default retry: success.
+        client._connection = make_connection(
+            ServerError("", errors=[{"reason": "backendError"}]), resource
+        )
+        dataset = client.get_dataset(
+            # Test with a string for dataset ID.
+            dataset_ref.dataset_id
+        )
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+
+    def test_create_dataset_minimal(self):
+        from google.cloud.bigquery.dataset import Dataset
+
+        PATH = "projects/%s/datasets" % self.PROJECT
+        RESOURCE = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(RESOURCE)
+
+        ds_ref = client.dataset(self.DS_ID)
+        before = Dataset(ds_ref)
+
+        after = client.create_dataset(before)
+
+        self.assertEqual(after.dataset_id, self.DS_ID)
+        self.assertEqual(after.project, self.PROJECT)
+        self.assertEqual(after.etag, RESOURCE["etag"])
+        self.assertEqual(after.full_dataset_id, RESOURCE["id"])
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % PATH,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "labels": {},
+            },
+        )
+
+    def test_create_dataset_w_attrs(self):
+        from google.cloud.bigquery.dataset import Dataset, AccessEntry
+
+        PATH = "projects/%s/datasets" % self.PROJECT
+        DESCRIPTION = "DESC"
+        FRIENDLY_NAME = "FN"
+        LOCATION = "US"
+        USER_EMAIL = "phred@example.com"
+        LABELS = {"color": "red"}
+        VIEW = {
+            "projectId": "my-proj",
+            "datasetId": "starry-skies",
+            "tableId": "northern-hemisphere",
+        }
+        RESOURCE = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "description": DESCRIPTION,
+            "friendlyName": FRIENDLY_NAME,
+            "location": LOCATION,
+            "defaultTableExpirationMs": "3600",
+            "labels": LABELS,
+            "access": [{"role": "OWNER", "userByEmail": USER_EMAIL}, {"view": VIEW}],
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(RESOURCE)
+        entries = [
+            AccessEntry("OWNER", "userByEmail", USER_EMAIL),
+            AccessEntry(None, "view", VIEW),
+        ]
+
+        ds_ref = client.dataset(self.DS_ID)
+        before = Dataset(ds_ref)
+        before.access_entries = entries
+        before.description = DESCRIPTION
+        before.friendly_name = FRIENDLY_NAME
+        before.default_table_expiration_ms = 3600
+        before.location = LOCATION
+        before.labels = LABELS
+
+        after = client.create_dataset(before)
+
+        self.assertEqual(after.dataset_id, self.DS_ID)
+        self.assertEqual(after.project, self.PROJECT)
+        self.assertEqual(after.etag, RESOURCE["etag"])
+        self.assertEqual(after.full_dataset_id, RESOURCE["id"])
+        self.assertEqual(after.description, DESCRIPTION)
+        self.assertEqual(after.friendly_name, FRIENDLY_NAME)
+        self.assertEqual(after.location, LOCATION)
+        self.assertEqual(after.default_table_expiration_ms, 3600)
+        self.assertEqual(after.labels, LABELS)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % PATH,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "description": DESCRIPTION,
+                "friendlyName": FRIENDLY_NAME,
+                "location": LOCATION,
+                "defaultTableExpirationMs": "3600",
+                "access": [
+                    {"role": "OWNER", "userByEmail": USER_EMAIL},
+                    {"view": VIEW},
+                ],
+                "labels": LABELS,
+            },
+        )
+
+    def test_create_dataset_w_custom_property(self):
+        # The library should handle sending properties to the API that are not
+        # yet part of the library
+        from google.cloud.bigquery.dataset import Dataset
+
+        path = "/projects/%s/datasets" % self.PROJECT
+        resource = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "newAlphaProperty": "unreleased property",
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource)
+
+        ds_ref = client.dataset(self.DS_ID)
+        before = Dataset(ds_ref)
+        before._properties["newAlphaProperty"] = "unreleased property"
+
+        after = client.create_dataset(before)
+
+        self.assertEqual(after.dataset_id, self.DS_ID)
+        self.assertEqual(after.project, self.PROJECT)
+        self.assertEqual(after._properties["newAlphaProperty"], "unreleased property")
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=path,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "newAlphaProperty": "unreleased property",
+                "labels": {},
+            },
+        )
+
+    def test_create_dataset_w_client_location_wo_dataset_location(self):
+        from google.cloud.bigquery.dataset import Dataset
+
+        PATH = "projects/%s/datasets" % self.PROJECT
+        RESOURCE = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "location": self.LOCATION,
+        }
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(RESOURCE)
+
+        ds_ref = client.dataset(self.DS_ID)
+        before = Dataset(ds_ref)
+
+        after = client.create_dataset(before)
+
+        self.assertEqual(after.dataset_id, self.DS_ID)
+        self.assertEqual(after.project, self.PROJECT)
+        self.assertEqual(after.etag, RESOURCE["etag"])
+        self.assertEqual(after.full_dataset_id, RESOURCE["id"])
+        self.assertEqual(after.location, self.LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % PATH,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "labels": {},
+                "location": self.LOCATION,
+            },
+        )
+
+    def test_create_dataset_w_client_location_w_dataset_location(self):
+        from google.cloud.bigquery.dataset import Dataset
+
+        PATH = "projects/%s/datasets" % self.PROJECT
+        OTHER_LOCATION = "EU"
+        RESOURCE = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "location": OTHER_LOCATION,
+        }
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(RESOURCE)
+
+        ds_ref = client.dataset(self.DS_ID)
+        before = Dataset(ds_ref)
+        before.location = OTHER_LOCATION
+
+        after = client.create_dataset(before)
+
+        self.assertEqual(after.dataset_id, self.DS_ID)
+        self.assertEqual(after.project, self.PROJECT)
+        self.assertEqual(after.etag, RESOURCE["etag"])
+        self.assertEqual(after.full_dataset_id, RESOURCE["id"])
+        self.assertEqual(after.location, OTHER_LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % PATH,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "labels": {},
+                "location": OTHER_LOCATION,
+            },
+        )
+
+    def test_create_dataset_w_reference(self):
+        path = "/projects/%s/datasets" % self.PROJECT
+        resource = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "location": self.LOCATION,
+        }
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        dataset = client.create_dataset(client.dataset(self.DS_ID))
+
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(dataset.etag, resource["etag"])
+        self.assertEqual(dataset.full_dataset_id, resource["id"])
+        self.assertEqual(dataset.location, self.LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=path,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "labels": {},
+                "location": self.LOCATION,
+            },
+        )
+
+    def test_create_dataset_w_fully_qualified_string(self):
+        path = "/projects/%s/datasets" % self.PROJECT
+        resource = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "location": self.LOCATION,
+        }
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        dataset = client.create_dataset("{}.{}".format(self.PROJECT, self.DS_ID))
+
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(dataset.etag, resource["etag"])
+        self.assertEqual(dataset.full_dataset_id, resource["id"])
+        self.assertEqual(dataset.location, self.LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=path,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "labels": {},
+                "location": self.LOCATION,
+            },
+        )
+
+    def test_create_dataset_w_string(self):
+        path = "/projects/%s/datasets" % self.PROJECT
+        resource = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "location": self.LOCATION,
+        }
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        dataset = client.create_dataset(self.DS_ID)
+
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(dataset.etag, resource["etag"])
+        self.assertEqual(dataset.full_dataset_id, resource["id"])
+        self.assertEqual(dataset.location, self.LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=path,
+            data={
+                "datasetReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                },
+                "labels": {},
+                "location": self.LOCATION,
+            },
+        )
+
+    def test_create_dataset_alreadyexists_w_exists_ok_false(self):
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        client._connection = make_connection(
+            google.api_core.exceptions.AlreadyExists("dataset already exists")
+        )
+
+        with pytest.raises(google.api_core.exceptions.AlreadyExists):
+            client.create_dataset(self.DS_ID)
+
+    def test_create_dataset_alreadyexists_w_exists_ok_true(self):
+        post_path = "/projects/{}/datasets".format(self.PROJECT)
+        get_path = "/projects/{}/datasets/{}".format(self.PROJECT, self.DS_ID)
+        resource = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "id": "{}:{}".format(self.PROJECT, self.DS_ID),
+            "location": self.LOCATION,
+        }
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.AlreadyExists("dataset already exists"), resource
+        )
+
+        dataset = client.create_dataset(self.DS_ID, exists_ok=True)
+
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(dataset.etag, resource["etag"])
+        self.assertEqual(dataset.full_dataset_id, resource["id"])
+        self.assertEqual(dataset.location, self.LOCATION)
+
+        conn.api_request.assert_has_calls(
+            [
+                mock.call(
+                    method="POST",
+                    path=post_path,
+                    data={
+                        "datasetReference": {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                        },
+                        "labels": {},
+                        "location": self.LOCATION,
+                    },
+                ),
+                mock.call(method="GET", path=get_path),
+            ]
+        )
+
+    def test_create_routine_w_minimal_resource(self):
+        from google.cloud.bigquery.routine import Routine
+        from google.cloud.bigquery.routine import RoutineReference
+
+        creds = _make_credentials()
+        resource = {
+            "routineReference": {
+                "projectId": "test-routine-project",
+                "datasetId": "test_routines",
+                "routineId": "minimal_routine",
+            }
+        }
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource)
+        full_routine_id = "test-routine-project.test_routines.minimal_routine"
+        routine = Routine(full_routine_id)
+
+        actual_routine = client.create_routine(routine)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/test-routine-project/datasets/test_routines/routines",
+            data=resource,
+        )
+        self.assertEqual(
+            actual_routine.reference, RoutineReference.from_string(full_routine_id)
+        )
+
+    def test_create_routine_w_conflict(self):
+        from google.cloud.bigquery.routine import Routine
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.AlreadyExists("routine already exists")
+        )
+        full_routine_id = "test-routine-project.test_routines.minimal_routine"
+        routine = Routine(full_routine_id)
+
+        with pytest.raises(google.api_core.exceptions.AlreadyExists):
+            client.create_routine(routine)
+
+        resource = {
+            "routineReference": {
+                "projectId": "test-routine-project",
+                "datasetId": "test_routines",
+                "routineId": "minimal_routine",
+            }
+        }
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/test-routine-project/datasets/test_routines/routines",
+            data=resource,
+        )
+
+    def test_create_routine_w_conflict_exists_ok(self):
+        from google.cloud.bigquery.routine import Routine
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = {
+            "routineReference": {
+                "projectId": "test-routine-project",
+                "datasetId": "test_routines",
+                "routineId": "minimal_routine",
+            }
+        }
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.AlreadyExists("routine already exists"), resource
+        )
+        full_routine_id = "test-routine-project.test_routines.minimal_routine"
+        routine = Routine(full_routine_id)
+
+        actual_routine = client.create_routine(routine, exists_ok=True)
+
+        self.assertEqual(actual_routine.project, "test-routine-project")
+        self.assertEqual(actual_routine.dataset_id, "test_routines")
+        self.assertEqual(actual_routine.routine_id, "minimal_routine")
+        conn.api_request.assert_has_calls(
+            [
+                mock.call(
+                    method="POST",
+                    path="/projects/test-routine-project/datasets/test_routines/routines",
+                    data=resource,
+                ),
+                mock.call(
+                    method="GET",
+                    path="/projects/test-routine-project/datasets/test_routines/routines/minimal_routine",
+                ),
+            ]
+        )
+
+    def test_create_table_w_day_partition(self):
+        from google.cloud.bigquery.table import Table
+        from google.cloud.bigquery.table import TimePartitioning
+
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        table.time_partitioning = TimePartitioning()
+
+        got = client.create_table(table)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "timePartitioning": {"type": "DAY"},
+                "labels": {},
+            },
+        )
+        self.assertEqual(table.time_partitioning.type_, "DAY")
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_w_custom_property(self):
+        # The library should handle sending properties to the API that are not
+        # yet part of the library
+        from google.cloud.bigquery.table import Table
+
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        resource["newAlphaProperty"] = "unreleased property"
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        table._properties["newAlphaProperty"] = "unreleased property"
+
+        got = client.create_table(table)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "newAlphaProperty": "unreleased property",
+                "labels": {},
+            },
+        )
+        self.assertEqual(got._properties["newAlphaProperty"], "unreleased property")
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_w_encryption_configuration(self):
+        from google.cloud.bigquery.table import EncryptionConfiguration
+        from google.cloud.bigquery.table import Table
+
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        table.encryption_configuration = EncryptionConfiguration(
+            kms_key_name=self.KMS_KEY_NAME
+        )
+
+        got = client.create_table(table)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "labels": {},
+                "encryptionConfiguration": {"kmsKeyName": self.KMS_KEY_NAME},
+            },
+        )
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_w_day_partition_and_expire(self):
+        from google.cloud.bigquery.table import Table
+        from google.cloud.bigquery.table import TimePartitioning
+
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        table.time_partitioning = TimePartitioning(expiration_ms=100)
+
+        got = client.create_table(table)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "timePartitioning": {"type": "DAY", "expirationMs": "100"},
+                "labels": {},
+            },
+        )
+        self.assertEqual(table.time_partitioning.type_, "DAY")
+        self.assertEqual(table.time_partitioning.expiration_ms, 100)
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_w_schema_and_query(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        query = "SELECT * from %s:%s" % (self.DS_ID, self.TABLE_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        resource.update(
+            {
+                "schema": {
+                    "fields": [
+                        {
+                            "name": "full_name",
+                            "type": "STRING",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        },
+                        {
+                            "name": "age",
+                            "type": "INTEGER",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        },
+                    ]
+                },
+                "view": {"query": query},
+            }
+        )
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF, schema=schema)
+        table.view_query = query
+
+        got = client.create_table(table)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "schema": {
+                    "fields": [
+                        {
+                            "name": "full_name",
+                            "type": "STRING",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        },
+                        {
+                            "name": "age",
+                            "type": "INTEGER",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        },
+                    ]
+                },
+                "view": {"query": query, "useLegacySql": False},
+                "labels": {},
+            },
+        )
+        self.assertEqual(got.table_id, self.TABLE_ID)
+        self.assertEqual(got.project, self.PROJECT)
+        self.assertEqual(got.dataset_id, self.DS_ID)
+        self.assertEqual(got.schema, schema)
+        self.assertEqual(got.view_query, query)
+
+    def test_create_table_w_external(self):
+        from google.cloud.bigquery.external_config import ExternalConfig
+        from google.cloud.bigquery.job import SourceFormat
+        from google.cloud.bigquery.table import Table
+
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        resource.update(
+            {
+                "externalDataConfiguration": {
+                    "sourceFormat": SourceFormat.CSV,
+                    "autodetect": True,
+                }
+            }
+        )
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        ec = ExternalConfig("CSV")
+        ec.autodetect = True
+        table.external_data_configuration = ec
+
+        got = client.create_table(table)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "externalDataConfiguration": {
+                    "sourceFormat": SourceFormat.CSV,
+                    "autodetect": True,
+                },
+                "labels": {},
+            },
+        )
+        self.assertEqual(got.table_id, self.TABLE_ID)
+        self.assertEqual(got.project, self.PROJECT)
+        self.assertEqual(got.dataset_id, self.DS_ID)
+        self.assertEqual(
+            got.external_data_configuration.source_format, SourceFormat.CSV
+        )
+        self.assertEqual(got.external_data_configuration.autodetect, True)
+
+    def test_create_table_w_reference(self):
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+
+        got = client.create_table(self.TABLE_REF)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "labels": {},
+            },
+        )
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_w_fully_qualified_string(self):
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+
+        got = client.create_table(
+            "{}.{}.{}".format(self.PROJECT, self.DS_ID, self.TABLE_ID)
+        )
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "labels": {},
+            },
+        )
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_w_string(self):
+        path = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+
+        got = client.create_table("{}.{}".format(self.DS_ID, self.TABLE_ID))
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/%s" % path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "labels": {},
+            },
+        )
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+    def test_create_table_alreadyexists_w_exists_ok_false(self):
+        post_path = "/projects/{}/datasets/{}/tables".format(self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.AlreadyExists("table already exists")
+        )
+
+        with pytest.raises(google.api_core.exceptions.AlreadyExists):
+            client.create_table("{}.{}".format(self.DS_ID, self.TABLE_ID))
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=post_path,
+            data={
+                "tableReference": {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.TABLE_ID,
+                },
+                "labels": {},
+            },
+        )
+
+    def test_create_table_alreadyexists_w_exists_ok_true(self):
+        post_path = "/projects/{}/datasets/{}/tables".format(self.PROJECT, self.DS_ID)
+        get_path = "/projects/{}/datasets/{}/tables/{}".format(
+            self.PROJECT, self.DS_ID, self.TABLE_ID
+        )
+        resource = self._make_table_resource()
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.AlreadyExists("table already exists"), resource
+        )
+
+        got = client.create_table(
+            "{}.{}".format(self.DS_ID, self.TABLE_ID), exists_ok=True
+        )
+
+        self.assertEqual(got.project, self.PROJECT)
+        self.assertEqual(got.dataset_id, self.DS_ID)
+        self.assertEqual(got.table_id, self.TABLE_ID)
+
+        conn.api_request.assert_has_calls(
+            [
+                mock.call(
+                    method="POST",
+                    path=post_path,
+                    data={
+                        "tableReference": {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": self.TABLE_ID,
+                        },
+                        "labels": {},
+                    },
+                ),
+                mock.call(method="GET", path=get_path),
+            ]
+        )
+
+    def test_get_model(self):
+        path = "projects/%s/datasets/%s/models/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.MODEL_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        resource = {
+            "modelReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "modelId": self.MODEL_ID,
+            }
+        }
+        conn = client._connection = make_connection(resource)
+
+        model_ref = client.dataset(self.DS_ID).model(self.MODEL_ID)
+        got = client.get_model(model_ref)
+
+        conn.api_request.assert_called_once_with(method="GET", path="/%s" % path)
+        self.assertEqual(got.model_id, self.MODEL_ID)
+
+    def test_get_model_w_string(self):
+        path = "projects/%s/datasets/%s/models/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.MODEL_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        resource = {
+            "modelReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "modelId": self.MODEL_ID,
+            }
+        }
+        conn = client._connection = make_connection(resource)
+
+        model_id = "{}.{}.{}".format(self.PROJECT, self.DS_ID, self.MODEL_ID)
+        got = client.get_model(model_id)
+
+        conn.api_request.assert_called_once_with(method="GET", path="/%s" % path)
+        self.assertEqual(got.model_id, self.MODEL_ID)
+
+    def test_get_routine(self):
+        from google.cloud.bigquery.routine import Routine
+        from google.cloud.bigquery.routine import RoutineReference
+
+        full_routine_id = "test-routine-project.test_routines.minimal_routine"
+        routines = [
+            full_routine_id,
+            Routine(full_routine_id),
+            RoutineReference.from_string(full_routine_id),
+        ]
+        for routine in routines:
+            creds = _make_credentials()
+            resource = {
+                "etag": "im-an-etag",
+                "routineReference": {
+                    "projectId": "test-routine-project",
+                    "datasetId": "test_routines",
+                    "routineId": "minimal_routine",
+                },
+                "routineType": "SCALAR_FUNCTION",
+            }
+            client = self._make_one(project=self.PROJECT, credentials=creds)
+            conn = client._connection = make_connection(resource)
+
+            actual_routine = client.get_routine(routine)
+
+            conn.api_request.assert_called_once_with(
+                method="GET",
+                path="/projects/test-routine-project/datasets/test_routines/routines/minimal_routine",
+            )
+            self.assertEqual(
+                actual_routine.reference,
+                RoutineReference.from_string(full_routine_id),
+                msg="routine={}".format(repr(routine)),
+            )
+            self.assertEqual(
+                actual_routine.etag,
+                "im-an-etag",
+                msg="routine={}".format(repr(routine)),
+            )
+            self.assertEqual(
+                actual_routine.type_,
+                "SCALAR_FUNCTION",
+                msg="routine={}".format(repr(routine)),
+            )
+
+    def test_get_table(self):
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        resource = self._make_table_resource()
+        conn = client._connection = make_connection(resource)
+        table = client.get_table(self.TABLE_REF)
+
+        conn.api_request.assert_called_once_with(method="GET", path="/%s" % path)
+        self.assertEqual(table.table_id, self.TABLE_ID)
+
+    def test_get_table_sets_user_agent(self):
+        creds = _make_credentials()
+        http = mock.create_autospec(requests.Session)
+        mock_response = http.request(
+            url=mock.ANY, method=mock.ANY, headers=mock.ANY, data=mock.ANY
+        )
+        http.reset_mock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = self._make_table_resource()
+        user_agent_override = client_info.ClientInfo(user_agent="my-application/1.2.3")
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            client_info=user_agent_override,
+            _http=http,
+        )
+
+        client.get_table(self.TABLE_REF)
+
+        expected_user_agent = user_agent_override.to_user_agent()
+        http.request.assert_called_once_with(
+            url=mock.ANY,
+            method="GET",
+            headers={
+                "X-Goog-API-Client": expected_user_agent,
+                "Accept-Encoding": "gzip",
+                "User-Agent": expected_user_agent,
+            },
+            data=mock.ANY,
+        )
+        self.assertIn("my-application/1.2.3", expected_user_agent)
+
+    def test_update_dataset_w_invalid_field(self):
+        from google.cloud.bigquery.dataset import Dataset
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(ValueError):
+            client.update_dataset(Dataset(client.dataset(self.DS_ID)), ["foo"])
+
+    def test_update_dataset(self):
+        from google.cloud.bigquery.dataset import Dataset, AccessEntry
+
+        PATH = "projects/%s/datasets/%s" % (self.PROJECT, self.DS_ID)
+        DESCRIPTION = "DESCRIPTION"
+        FRIENDLY_NAME = "TITLE"
+        LOCATION = "loc"
+        LABELS = {"priority": "high"}
+        ACCESS = [{"role": "OWNER", "userByEmail": "phred@example.com"}]
+        EXP = 17
+        RESOURCE = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": "etag",
+            "description": DESCRIPTION,
+            "friendlyName": FRIENDLY_NAME,
+            "location": LOCATION,
+            "defaultTableExpirationMs": EXP,
+            "labels": LABELS,
+            "access": ACCESS,
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(RESOURCE, RESOURCE)
+        ds = Dataset(client.dataset(self.DS_ID))
+        ds.description = DESCRIPTION
+        ds.friendly_name = FRIENDLY_NAME
+        ds.location = LOCATION
+        ds.default_table_expiration_ms = EXP
+        ds.labels = LABELS
+        ds.access_entries = [AccessEntry("OWNER", "userByEmail", "phred@example.com")]
+        ds2 = client.update_dataset(
+            ds, ["description", "friendly_name", "location", "labels", "access_entries"]
+        )
+        conn.api_request.assert_called_once_with(
+            method="PATCH",
+            data={
+                "description": DESCRIPTION,
+                "friendlyName": FRIENDLY_NAME,
+                "location": LOCATION,
+                "labels": LABELS,
+                "access": ACCESS,
+            },
+            path="/" + PATH,
+            headers=None,
+        )
+        self.assertEqual(ds2.description, ds.description)
+        self.assertEqual(ds2.friendly_name, ds.friendly_name)
+        self.assertEqual(ds2.location, ds.location)
+        self.assertEqual(ds2.labels, ds.labels)
+        self.assertEqual(ds2.access_entries, ds.access_entries)
+
+        # ETag becomes If-Match header.
+        ds._properties["etag"] = "etag"
+        client.update_dataset(ds, [])
+        req = conn.api_request.call_args
+        self.assertEqual(req[1]["headers"]["If-Match"], "etag")
+
+    def test_update_dataset_w_custom_property(self):
+        # The library should handle sending properties to the API that are not
+        # yet part of the library
+        from google.cloud.bigquery.dataset import Dataset
+
+        path = "/projects/%s/datasets/%s" % (self.PROJECT, self.DS_ID)
+        resource = {
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "newAlphaProperty": "unreleased property",
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource)
+        dataset = Dataset(client.dataset(self.DS_ID))
+        dataset._properties["newAlphaProperty"] = "unreleased property"
+
+        dataset = client.update_dataset(dataset, ["newAlphaProperty"])
+        conn.api_request.assert_called_once_with(
+            method="PATCH",
+            data={"newAlphaProperty": "unreleased property"},
+            path=path,
+            headers=None,
+        )
+
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(dataset._properties["newAlphaProperty"], "unreleased property")
+
+    def test_update_model(self):
+        from google.cloud.bigquery.model import Model
+
+        path = "projects/%s/datasets/%s/models/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.MODEL_ID,
+        )
+        description = "description"
+        title = "title"
+        expires = datetime.datetime(
+            2012, 12, 21, 16, 0, 0, tzinfo=google.cloud._helpers.UTC
+        )
+        resource = {
+            "modelReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "modelId": self.MODEL_ID,
+            },
+            "description": description,
+            "etag": "etag",
+            "expirationTime": str(google.cloud._helpers._millis(expires)),
+            "friendlyName": title,
+            "labels": {"x": "y"},
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource, resource)
+        model_id = "{}.{}.{}".format(self.PROJECT, self.DS_ID, self.MODEL_ID)
+        model = Model(model_id)
+        model.description = description
+        model.friendly_name = title
+        model.expires = expires
+        model.labels = {"x": "y"}
+
+        updated_model = client.update_model(
+            model, ["description", "friendly_name", "labels", "expires"]
+        )
+
+        sent = {
+            "description": description,
+            "expirationTime": str(google.cloud._helpers._millis(expires)),
+            "friendlyName": title,
+            "labels": {"x": "y"},
+        }
+        conn.api_request.assert_called_once_with(
+            method="PATCH", data=sent, path="/" + path, headers=None
+        )
+        self.assertEqual(updated_model.model_id, model.model_id)
+        self.assertEqual(updated_model.description, model.description)
+        self.assertEqual(updated_model.friendly_name, model.friendly_name)
+        self.assertEqual(updated_model.labels, model.labels)
+        self.assertEqual(updated_model.expires, model.expires)
+
+        # ETag becomes If-Match header.
+        model._proto.etag = "etag"
+        client.update_model(model, [])
+        req = conn.api_request.call_args
+        self.assertEqual(req[1]["headers"]["If-Match"], "etag")
+
+    def test_update_routine(self):
+        from google.cloud.bigquery.routine import Routine
+        from google.cloud.bigquery.routine import RoutineArgument
+
+        full_routine_id = "routines-project.test_routines.updated_routine"
+        resource = {
+            "routineReference": {
+                "projectId": "routines-project",
+                "datasetId": "test_routines",
+                "routineId": "updated_routine",
+            },
+            "routineType": "SCALAR_FUNCTION",
+            "language": "SQL",
+            "definitionBody": "x * 3",
+            "arguments": [{"name": "x", "dataType": {"typeKind": "INT64"}}],
+            "returnType": None,
+            "someNewField": "someValue",
+        }
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource, resource)
+        routine = Routine(full_routine_id)
+        routine.arguments = [
+            RoutineArgument(
+                name="x",
+                data_type=bigquery_v2.types.StandardSqlDataType(
+                    type_kind=bigquery_v2.enums.StandardSqlDataType.TypeKind.INT64
+                ),
+            )
+        ]
+        routine.body = "x * 3"
+        routine.language = "SQL"
+        routine.type_ = "SCALAR_FUNCTION"
+        routine._properties["someNewField"] = "someValue"
+
+        actual_routine = client.update_routine(
+            routine,
+            ["arguments", "language", "body", "type_", "return_type", "someNewField"],
+        )
+
+        # TODO: routineReference isn't needed when the Routines API supports
+        #       partial updates.
+        sent = resource
+        conn.api_request.assert_called_once_with(
+            method="PUT",
+            data=sent,
+            path="/projects/routines-project/datasets/test_routines/routines/updated_routine",
+            headers=None,
+        )
+        self.assertEqual(actual_routine.arguments, routine.arguments)
+        self.assertEqual(actual_routine.body, routine.body)
+        self.assertEqual(actual_routine.language, routine.language)
+        self.assertEqual(actual_routine.type_, routine.type_)
+
+        # ETag becomes If-Match header.
+        routine._properties["etag"] = "im-an-etag"
+        client.update_routine(routine, [])
+        req = conn.api_request.call_args
+        self.assertEqual(req[1]["headers"]["If-Match"], "im-an-etag")
+
+    def test_update_table(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        description = "description"
+        title = "title"
+        resource = self._make_table_resource()
+        resource.update(
+            {
+                "schema": {
+                    "fields": [
+                        {
+                            "name": "full_name",
+                            "type": "STRING",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        },
+                        {
+                            "name": "age",
+                            "type": "INTEGER",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        },
+                    ]
+                },
+                "etag": "etag",
+                "description": description,
+                "friendlyName": title,
+                "labels": {"x": "y"},
+            }
+        )
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource, resource)
+        table = Table(self.TABLE_REF, schema=schema)
+        table.description = description
+        table.friendly_name = title
+        table.labels = {"x": "y"}
+
+        updated_table = client.update_table(
+            table, ["schema", "description", "friendly_name", "labels"]
+        )
+
+        sent = {
+            "schema": {
+                "fields": [
+                    {
+                        "name": "full_name",
+                        "type": "STRING",
+                        "mode": "REQUIRED",
+                        "description": None,
+                    },
+                    {
+                        "name": "age",
+                        "type": "INTEGER",
+                        "mode": "REQUIRED",
+                        "description": None,
+                    },
+                ]
+            },
+            "description": description,
+            "friendlyName": title,
+            "labels": {"x": "y"},
+        }
+        conn.api_request.assert_called_once_with(
+            method="PATCH", data=sent, path="/" + path, headers=None
+        )
+        self.assertEqual(updated_table.description, table.description)
+        self.assertEqual(updated_table.friendly_name, table.friendly_name)
+        self.assertEqual(updated_table.schema, table.schema)
+        self.assertEqual(updated_table.labels, table.labels)
+
+        # ETag becomes If-Match header.
+        table._properties["etag"] = "etag"
+        client.update_table(table, [])
+        req = conn.api_request.call_args
+        self.assertEqual(req[1]["headers"]["If-Match"], "etag")
+
+    def test_update_table_w_custom_property(self):
+        from google.cloud.bigquery.table import Table
+
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        resource = self._make_table_resource()
+        resource["newAlphaProperty"] = "unreleased property"
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        table._properties["newAlphaProperty"] = "unreleased property"
+
+        updated_table = client.update_table(table, ["newAlphaProperty"])
+
+        conn.api_request.assert_called_once_with(
+            method="PATCH",
+            path="/%s" % path,
+            data={"newAlphaProperty": "unreleased property"},
+            headers=None,
+        )
+        self.assertEqual(
+            updated_table._properties["newAlphaProperty"], "unreleased property"
+        )
+
+    def test_update_table_only_use_legacy_sql(self):
+        from google.cloud.bigquery.table import Table
+
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        resource = self._make_table_resource()
+        resource["view"] = {"useLegacySql": True}
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF)
+        table.view_use_legacy_sql = True
+
+        updated_table = client.update_table(table, ["view_use_legacy_sql"])
+
+        conn.api_request.assert_called_once_with(
+            method="PATCH",
+            path="/%s" % path,
+            data={"view": {"useLegacySql": True}},
+            headers=None,
+        )
+        self.assertEqual(updated_table.view_use_legacy_sql, table.view_use_legacy_sql)
+
+    def test_update_table_w_query(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _millis
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        query = "select fullname, age from person_ages"
+        location = "EU"
+        exp_time = datetime.datetime(2015, 8, 1, 23, 59, 59, tzinfo=UTC)
+        schema_resource = {
+            "fields": [
+                {
+                    "name": "full_name",
+                    "type": "STRING",
+                    "mode": "REQUIRED",
+                    "description": None,
+                },
+                {
+                    "name": "age",
+                    "type": "INTEGER",
+                    "mode": "REQUIRED",
+                    "description": None,
+                },
+            ]
+        }
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        resource = self._make_table_resource()
+        resource.update(
+            {
+                "schema": schema_resource,
+                "view": {"query": query, "useLegacySql": True},
+                "location": location,
+                "expirationTime": _millis(exp_time),
+            }
+        )
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource)
+        table = Table(self.TABLE_REF, schema=schema)
+        table.expires = exp_time
+        table.view_query = query
+        table.view_use_legacy_sql = True
+        updated_properties = ["schema", "view_query", "expires", "view_use_legacy_sql"]
+
+        updated_table = client.update_table(table, updated_properties)
+
+        self.assertEqual(updated_table.schema, table.schema)
+        self.assertEqual(updated_table.view_query, table.view_query)
+        self.assertEqual(updated_table.expires, table.expires)
+        self.assertEqual(updated_table.view_use_legacy_sql, table.view_use_legacy_sql)
+        self.assertEqual(updated_table.location, location)
+
+        conn.api_request.assert_called_once_with(
+            method="PATCH",
+            path="/%s" % path,
+            data={
+                "view": {"query": query, "useLegacySql": True},
+                "expirationTime": str(_millis(exp_time)),
+                "schema": schema_resource,
+            },
+            headers=None,
+        )
+
+    def test_update_table_w_schema_None(self):
+        # Simulate deleting schema:  not sure if back-end will actually
+        # allow this operation, but the spec says it is optional.
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        resource1 = self._make_table_resource()
+        resource1.update(
+            {
+                "schema": {
+                    "fields": [
+                        {"name": "full_name", "type": "STRING", "mode": "REQUIRED"},
+                        {"name": "age", "type": "INTEGER", "mode": "REQUIRED"},
+                    ]
+                }
+            }
+        )
+        resource2 = self._make_table_resource()
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource1, resource2)
+        table = client.get_table(
+            # Test with string for table ID
+            "{}.{}.{}".format(
+                self.TABLE_REF.project,
+                self.TABLE_REF.dataset_id,
+                self.TABLE_REF.table_id,
+            )
+        )
+        table.schema = None
+
+        updated_table = client.update_table(table, ["schema"])
+
+        self.assertEqual(len(conn.api_request.call_args_list), 2)
+        req = conn.api_request.call_args_list[1]
+        self.assertEqual(req[1]["method"], "PATCH")
+        sent = {"schema": None}
+        self.assertEqual(req[1]["data"], sent)
+        self.assertEqual(req[1]["path"], "/%s" % path)
+        self.assertEqual(len(updated_table.schema), 0)
+
+    def test_update_table_delete_property(self):
+        from google.cloud.bigquery.table import Table
+
+        description = "description"
+        title = "title"
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        resource1 = self._make_table_resource()
+        resource1.update({"description": description, "friendlyName": title})
+        resource2 = self._make_table_resource()
+        resource2["description"] = None
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(resource1, resource2)
+        table = Table(self.TABLE_REF)
+        table.description = description
+        table.friendly_name = title
+        table2 = client.update_table(table, ["description", "friendly_name"])
+        self.assertEqual(table2.description, table.description)
+        table2.description = None
+
+        table3 = client.update_table(table2, ["description"])
+        self.assertEqual(len(conn.api_request.call_args_list), 2)
+        req = conn.api_request.call_args_list[1]
+        self.assertEqual(req[1]["method"], "PATCH")
+        self.assertEqual(req[1]["path"], "/%s" % path)
+        sent = {"description": None}
+        self.assertEqual(req[1]["data"], sent)
+        self.assertIsNone(table3.description)
+
+    def test_list_tables_empty(self):
+        path = "/projects/{}/datasets/{}/tables".format(self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection({})
+
+        dataset = client.dataset(self.DS_ID)
+        iterator = client.list_tables(dataset)
+        self.assertIs(iterator.dataset, dataset)
+        page = six.next(iterator.pages)
+        tables = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(tables, [])
+        self.assertIsNone(token)
+        conn.api_request.assert_called_once_with(
+            method="GET", path=path, query_params={}
+        )
+
+    def test_list_models_empty(self):
+        path = "/projects/{}/datasets/{}/models".format(self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection({})
+
+        dataset_id = "{}.{}".format(self.PROJECT, self.DS_ID)
+        iterator = client.list_models(dataset_id)
+        page = six.next(iterator.pages)
+        models = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(models, [])
+        self.assertIsNone(token)
+        conn.api_request.assert_called_once_with(
+            method="GET", path=path, query_params={}
+        )
+
+    def test_list_models_defaults(self):
+        from google.cloud.bigquery.model import Model
+
+        MODEL_1 = "model_one"
+        MODEL_2 = "model_two"
+        PATH = "projects/%s/datasets/%s/models" % (self.PROJECT, self.DS_ID)
+        TOKEN = "TOKEN"
+        DATA = {
+            "nextPageToken": TOKEN,
+            "models": [
+                {
+                    "modelReference": {
+                        "modelId": MODEL_1,
+                        "datasetId": self.DS_ID,
+                        "projectId": self.PROJECT,
+                    }
+                },
+                {
+                    "modelReference": {
+                        "modelId": MODEL_2,
+                        "datasetId": self.DS_ID,
+                        "projectId": self.PROJECT,
+                    }
+                },
+            ],
+        }
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(DATA)
+        dataset = client.dataset(self.DS_ID)
+
+        iterator = client.list_models(dataset)
+        self.assertIs(iterator.dataset, dataset)
+        page = six.next(iterator.pages)
+        models = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(models), len(DATA["models"]))
+        for found, expected in zip(models, DATA["models"]):
+            self.assertIsInstance(found, Model)
+            self.assertEqual(found.model_id, expected["modelReference"]["modelId"])
+        self.assertEqual(token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={}
+        )
+
+    def test_list_models_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.list_models(client.dataset(self.DS_ID).model("foo"))
+
+    def test_list_routines_empty(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection({})
+
+        iterator = client.list_routines("test-routines.test_routines")
+        page = six.next(iterator.pages)
+        routines = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(routines, [])
+        self.assertIsNone(token)
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/test-routines/datasets/test_routines/routines",
+            query_params={},
+        )
+
+    def test_list_routines_defaults(self):
+        from google.cloud.bigquery.routine import Routine
+
+        project_id = "test-routines"
+        dataset_id = "test_routines"
+        path = "/projects/test-routines/datasets/test_routines/routines"
+        routine_1 = "routine_one"
+        routine_2 = "routine_two"
+        token = "TOKEN"
+        resource = {
+            "nextPageToken": token,
+            "routines": [
+                {
+                    "routineReference": {
+                        "routineId": routine_1,
+                        "datasetId": dataset_id,
+                        "projectId": project_id,
+                    }
+                },
+                {
+                    "routineReference": {
+                        "routineId": routine_2,
+                        "datasetId": dataset_id,
+                        "projectId": project_id,
+                    }
+                },
+            ],
+        }
+
+        creds = _make_credentials()
+        client = self._make_one(project=project_id, credentials=creds)
+        conn = client._connection = make_connection(resource)
+        dataset = client.dataset(dataset_id)
+
+        iterator = client.list_routines(dataset)
+        self.assertIs(iterator.dataset, dataset)
+        page = six.next(iterator.pages)
+        routines = list(page)
+        actual_token = iterator.next_page_token
+
+        self.assertEqual(len(routines), len(resource["routines"]))
+        for found, expected in zip(routines, resource["routines"]):
+            self.assertIsInstance(found, Routine)
+            self.assertEqual(
+                found.routine_id, expected["routineReference"]["routineId"]
+            )
+        self.assertEqual(actual_token, token)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=path, query_params={}
+        )
+
+    def test_list_routines_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.list_routines(client.dataset(self.DS_ID).table("foo"))
+
+    def test_list_tables_defaults(self):
+        from google.cloud.bigquery.table import TableListItem
+
+        TABLE_1 = "table_one"
+        TABLE_2 = "table_two"
+        PATH = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        TOKEN = "TOKEN"
+        DATA = {
+            "nextPageToken": TOKEN,
+            "tables": [
+                {
+                    "kind": "bigquery#table",
+                    "id": "%s:%s.%s" % (self.PROJECT, self.DS_ID, TABLE_1),
+                    "tableReference": {
+                        "tableId": TABLE_1,
+                        "datasetId": self.DS_ID,
+                        "projectId": self.PROJECT,
+                    },
+                    "type": "TABLE",
+                },
+                {
+                    "kind": "bigquery#table",
+                    "id": "%s:%s.%s" % (self.PROJECT, self.DS_ID, TABLE_2),
+                    "tableReference": {
+                        "tableId": TABLE_2,
+                        "datasetId": self.DS_ID,
+                        "projectId": self.PROJECT,
+                    },
+                    "type": "TABLE",
+                },
+            ],
+        }
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(DATA)
+        dataset = client.dataset(self.DS_ID)
+
+        iterator = client.list_tables(dataset)
+        self.assertIs(iterator.dataset, dataset)
+        page = six.next(iterator.pages)
+        tables = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(tables), len(DATA["tables"]))
+        for found, expected in zip(tables, DATA["tables"]):
+            self.assertIsInstance(found, TableListItem)
+            self.assertEqual(found.full_table_id, expected["id"])
+            self.assertEqual(found.table_type, expected["type"])
+        self.assertEqual(token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={}
+        )
+
+    def test_list_tables_explicit(self):
+        from google.cloud.bigquery.table import TableListItem
+
+        TABLE_1 = "table_one"
+        TABLE_2 = "table_two"
+        PATH = "projects/%s/datasets/%s/tables" % (self.PROJECT, self.DS_ID)
+        TOKEN = "TOKEN"
+        DATA = {
+            "tables": [
+                {
+                    "kind": "bigquery#dataset",
+                    "id": "%s:%s.%s" % (self.PROJECT, self.DS_ID, TABLE_1),
+                    "tableReference": {
+                        "tableId": TABLE_1,
+                        "datasetId": self.DS_ID,
+                        "projectId": self.PROJECT,
+                    },
+                    "type": "TABLE",
+                },
+                {
+                    "kind": "bigquery#dataset",
+                    "id": "%s:%s.%s" % (self.PROJECT, self.DS_ID, TABLE_2),
+                    "tableReference": {
+                        "tableId": TABLE_2,
+                        "datasetId": self.DS_ID,
+                        "projectId": self.PROJECT,
+                    },
+                    "type": "TABLE",
+                },
+            ]
+        }
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(DATA)
+        dataset = client.dataset(self.DS_ID)
+
+        iterator = client.list_tables(
+            # Test with string for dataset ID.
+            self.DS_ID,
+            max_results=3,
+            page_token=TOKEN,
+        )
+        self.assertEqual(iterator.dataset, dataset)
+        page = six.next(iterator.pages)
+        tables = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(tables), len(DATA["tables"]))
+        for found, expected in zip(tables, DATA["tables"]):
+            self.assertIsInstance(found, TableListItem)
+            self.assertEqual(found.full_table_id, expected["id"])
+            self.assertEqual(found.table_type, expected["type"])
+        self.assertIsNone(token)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/%s" % PATH,
+            query_params={"maxResults": 3, "pageToken": TOKEN},
+        )
+
+    def test_list_tables_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.list_tables(client.dataset(self.DS_ID).table("foo"))
+
+    def test_delete_dataset(self):
+        from google.cloud.bigquery.dataset import Dataset
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        ds_ref = DatasetReference(self.PROJECT, self.DS_ID)
+        datasets = (ds_ref, Dataset(ds_ref), "{}.{}".format(self.PROJECT, self.DS_ID))
+        PATH = "projects/%s/datasets/%s" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection(*([{}] * len(datasets)))
+        for arg in datasets:
+            client.delete_dataset(arg)
+            conn.api_request.assert_called_with(
+                method="DELETE", path="/%s" % PATH, query_params={}
+            )
+
+    def test_delete_dataset_delete_contents(self):
+        from google.cloud.bigquery.dataset import Dataset
+
+        PATH = "projects/%s/datasets/%s" % (self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        conn = client._connection = make_connection({}, {})
+        ds_ref = client.dataset(self.DS_ID)
+        for arg in (ds_ref, Dataset(ds_ref)):
+            client.delete_dataset(arg, delete_contents=True)
+            conn.api_request.assert_called_with(
+                method="DELETE",
+                path="/%s" % PATH,
+                query_params={"deleteContents": "true"},
+            )
+
+    def test_delete_dataset_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.delete_dataset(client.dataset(self.DS_ID).table("foo"))
+
+    def test_delete_dataset_w_not_found_ok_false(self):
+        path = "/projects/{}/datasets/{}".format(self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("dataset not found")
+        )
+
+        with self.assertRaises(google.api_core.exceptions.NotFound):
+            client.delete_dataset(self.DS_ID)
+
+        conn.api_request.assert_called_with(method="DELETE", path=path, query_params={})
+
+    def test_delete_dataset_w_not_found_ok_true(self):
+        path = "/projects/{}/datasets/{}".format(self.PROJECT, self.DS_ID)
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("dataset not found")
+        )
+
+        client.delete_dataset(self.DS_ID, not_found_ok=True)
+
+        conn.api_request.assert_called_with(method="DELETE", path=path, query_params={})
+
+    def test_delete_model(self):
+        from google.cloud.bigquery.model import Model
+
+        path = "projects/%s/datasets/%s/models/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.MODEL_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        model_id = "{}.{}.{}".format(self.PROJECT, self.DS_ID, self.MODEL_ID)
+        models = (
+            model_id,
+            client.dataset(self.DS_ID).model(self.MODEL_ID),
+            Model(model_id),
+        )
+        conn = client._connection = make_connection(*([{}] * len(models)))
+
+        for arg in models:
+            client.delete_model(arg)
+            conn.api_request.assert_called_with(method="DELETE", path="/%s" % path)
+
+    def test_delete_model_w_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.delete_model(client.dataset(self.DS_ID))
+
+    def test_delete_model_w_not_found_ok_false(self):
+        path = "/projects/{}/datasets/{}/models/{}".format(
+            self.PROJECT, self.DS_ID, self.MODEL_ID
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("model not found")
+        )
+
+        with self.assertRaises(google.api_core.exceptions.NotFound):
+            client.delete_model("{}.{}".format(self.DS_ID, self.MODEL_ID))
+
+        conn.api_request.assert_called_with(method="DELETE", path=path)
+
+    def test_delete_model_w_not_found_ok_true(self):
+        path = "/projects/{}/datasets/{}/models/{}".format(
+            self.PROJECT, self.DS_ID, self.MODEL_ID
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("model not found")
+        )
+
+        client.delete_model(
+            "{}.{}".format(self.DS_ID, self.MODEL_ID), not_found_ok=True
+        )
+
+        conn.api_request.assert_called_with(method="DELETE", path=path)
+
+    def test_delete_routine(self):
+        from google.cloud.bigquery.routine import Routine
+        from google.cloud.bigquery.routine import RoutineReference
+
+        full_routine_id = "test-routine-project.test_routines.minimal_routine"
+        routines = [
+            full_routine_id,
+            Routine(full_routine_id),
+            RoutineReference.from_string(full_routine_id),
+        ]
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(*([{}] * len(routines)))
+
+        for routine in routines:
+            client.delete_routine(routine)
+            conn.api_request.assert_called_with(
+                method="DELETE",
+                path="/projects/test-routine-project/datasets/test_routines/routines/minimal_routine",
+            )
+
+    def test_delete_routine_w_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.delete_routine(client.dataset(self.DS_ID))
+
+    def test_delete_routine_w_not_found_ok_false(self):
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("routine not found")
+        )
+
+        with self.assertRaises(google.api_core.exceptions.NotFound):
+            client.delete_routine("routines-project.test_routines.test_routine")
+
+        conn.api_request.assert_called_with(
+            method="DELETE",
+            path="/projects/routines-project/datasets/test_routines/routines/test_routine",
+        )
+
+    def test_delete_routine_w_not_found_ok_true(self):
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("routine not found")
+        )
+
+        client.delete_routine(
+            "routines-project.test_routines.test_routine", not_found_ok=True
+        )
+
+        conn.api_request.assert_called_with(
+            method="DELETE",
+            path="/projects/routines-project/datasets/test_routines/routines/test_routine",
+        )
+
+    def test_delete_table(self):
+        from google.cloud.bigquery.table import Table
+
+        tables = (
+            self.TABLE_REF,
+            Table(self.TABLE_REF),
+            "{}.{}.{}".format(
+                self.TABLE_REF.project,
+                self.TABLE_REF.dataset_id,
+                self.TABLE_REF.table_id,
+            ),
+        )
+        path = "projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(*([{}] * len(tables)))
+
+        for arg in tables:
+            client.delete_table(arg)
+            conn.api_request.assert_called_with(method="DELETE", path="/%s" % path)
+
+    def test_delete_table_w_wrong_type(self):
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        with self.assertRaises(TypeError):
+            client.delete_table(client.dataset(self.DS_ID))
+
+    def test_delete_table_w_not_found_ok_false(self):
+        path = "/projects/{}/datasets/{}/tables/{}".format(
+            self.PROJECT, self.DS_ID, self.TABLE_ID
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("table not found")
+        )
+
+        with self.assertRaises(google.api_core.exceptions.NotFound):
+            client.delete_table("{}.{}".format(self.DS_ID, self.TABLE_ID))
+
+        conn.api_request.assert_called_with(method="DELETE", path=path)
+
+    def test_delete_table_w_not_found_ok_true(self):
+        path = "/projects/{}/datasets/{}/tables/{}".format(
+            self.PROJECT, self.DS_ID, self.TABLE_ID
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(
+            google.api_core.exceptions.NotFound("table not found")
+        )
+
+        client.delete_table(
+            "{}.{}".format(self.DS_ID, self.TABLE_ID), not_found_ok=True
+        )
+
+        conn.api_request.assert_called_with(method="DELETE", path=path)
+
+    def test_job_from_resource_unknown_type(self):
+        from google.cloud.bigquery.job import UnknownJob
+
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        got = client.job_from_resource({})  # Can parse redacted job.
+        self.assertIsInstance(got, UnknownJob)
+        self.assertEqual(got.project, self.PROJECT)
+
+    def test_get_job_miss_w_explict_project(self):
+        from google.cloud.exceptions import NotFound
+
+        OTHER_PROJECT = "OTHER_PROJECT"
+        JOB_ID = "NONESUCH"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection()
+
+        with self.assertRaises(NotFound):
+            client.get_job(JOB_ID, project=OTHER_PROJECT, location=self.LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/OTHER_PROJECT/jobs/NONESUCH",
+            query_params={"projection": "full", "location": self.LOCATION},
+        )
+
+    def test_get_job_miss_w_client_location(self):
+        from google.cloud.exceptions import NotFound
+
+        OTHER_PROJECT = "OTHER_PROJECT"
+        JOB_ID = "NONESUCH"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds, location=self.LOCATION)
+        conn = client._connection = make_connection()
+
+        with self.assertRaises(NotFound):
+            client.get_job(JOB_ID, project=OTHER_PROJECT)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/OTHER_PROJECT/jobs/NONESUCH",
+            query_params={"projection": "full", "location": self.LOCATION},
+        )
+
+    def test_get_job_hit(self):
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import QueryJob
+        from google.cloud.bigquery.job import WriteDisposition
+
+        JOB_ID = "query_job"
+        QUERY_DESTINATION_TABLE = "query_destination_table"
+        QUERY = "SELECT * from test_dataset:test_table"
+        ASYNC_QUERY_DATA = {
+            "id": "{}:{}".format(self.PROJECT, JOB_ID),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "query_job"},
+            "state": "DONE",
+            "configuration": {
+                "query": {
+                    "query": QUERY,
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": QUERY_DESTINATION_TABLE,
+                    },
+                    "createDisposition": CreateDisposition.CREATE_IF_NEEDED,
+                    "writeDisposition": WriteDisposition.WRITE_TRUNCATE,
+                }
+            },
+        }
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(ASYNC_QUERY_DATA)
+
+        job = client.get_job(JOB_ID)
+
+        self.assertIsInstance(job, QueryJob)
+        self.assertEqual(job.job_id, JOB_ID)
+        self.assertEqual(job.create_disposition, CreateDisposition.CREATE_IF_NEEDED)
+        self.assertEqual(job.write_disposition, WriteDisposition.WRITE_TRUNCATE)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/PROJECT/jobs/query_job",
+            query_params={"projection": "full"},
+        )
+
+    def test_cancel_job_miss_w_explict_project(self):
+        from google.cloud.exceptions import NotFound
+
+        OTHER_PROJECT = "OTHER_PROJECT"
+        JOB_ID = "NONESUCH"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection()
+
+        with self.assertRaises(NotFound):
+            client.cancel_job(JOB_ID, project=OTHER_PROJECT, location=self.LOCATION)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/OTHER_PROJECT/jobs/NONESUCH/cancel",
+            query_params={"projection": "full", "location": self.LOCATION},
+        )
+
+    def test_cancel_job_miss_w_client_location(self):
+        from google.cloud.exceptions import NotFound
+
+        OTHER_PROJECT = "OTHER_PROJECT"
+        JOB_ID = "NONESUCH"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds, location=self.LOCATION)
+        conn = client._connection = make_connection()
+
+        with self.assertRaises(NotFound):
+            client.cancel_job(JOB_ID, project=OTHER_PROJECT)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/OTHER_PROJECT/jobs/NONESUCH/cancel",
+            query_params={"projection": "full", "location": self.LOCATION},
+        )
+
+    def test_cancel_job_hit(self):
+        from google.cloud.bigquery.job import QueryJob
+
+        JOB_ID = "query_job"
+        QUERY = "SELECT * from test_dataset:test_table"
+        QUERY_JOB_RESOURCE = {
+            "id": "{}:{}".format(self.PROJECT, JOB_ID),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "query_job"},
+            "state": "RUNNING",
+            "configuration": {"query": {"query": QUERY}},
+        }
+        RESOURCE = {"job": QUERY_JOB_RESOURCE}
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(RESOURCE)
+
+        job = client.cancel_job(JOB_ID)
+
+        self.assertIsInstance(job, QueryJob)
+        self.assertEqual(job.job_id, JOB_ID)
+        self.assertEqual(job.query, QUERY)
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/PROJECT/jobs/query_job/cancel",
+            query_params={"projection": "full"},
+        )
+
+    def test_list_jobs_defaults(self):
+        from google.cloud.bigquery.job import CopyJob
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import ExtractJob
+        from google.cloud.bigquery.job import LoadJob
+        from google.cloud.bigquery.job import QueryJob
+        from google.cloud.bigquery.job import WriteDisposition
+
+        SOURCE_TABLE = "source_table"
+        DESTINATION_TABLE = "destination_table"
+        QUERY_DESTINATION_TABLE = "query_destination_table"
+        SOURCE_URI = "gs://test_bucket/src_object*"
+        DESTINATION_URI = "gs://test_bucket/dst_object*"
+        JOB_TYPES = {
+            "load_job": LoadJob,
+            "copy_job": CopyJob,
+            "extract_job": ExtractJob,
+            "query_job": QueryJob,
+        }
+        PATH = "projects/%s/jobs" % self.PROJECT
+        TOKEN = "TOKEN"
+        QUERY = "SELECT * from test_dataset:test_table"
+        ASYNC_QUERY_DATA = {
+            "id": "%s:%s" % (self.PROJECT, "query_job"),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "query_job"},
+            "state": "DONE",
+            "configuration": {
+                "query": {
+                    "query": QUERY,
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": QUERY_DESTINATION_TABLE,
+                    },
+                    "createDisposition": CreateDisposition.CREATE_IF_NEEDED,
+                    "writeDisposition": WriteDisposition.WRITE_TRUNCATE,
+                }
+            },
+        }
+        EXTRACT_DATA = {
+            "id": "%s:%s" % (self.PROJECT, "extract_job"),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "extract_job"},
+            "state": "DONE",
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": SOURCE_TABLE,
+                    },
+                    "destinationUris": [DESTINATION_URI],
+                }
+            },
+        }
+        COPY_DATA = {
+            "id": "%s:%s" % (self.PROJECT, "copy_job"),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "copy_job"},
+            "state": "DONE",
+            "configuration": {
+                "copy": {
+                    "sourceTables": [
+                        {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": SOURCE_TABLE,
+                        }
+                    ],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": DESTINATION_TABLE,
+                    },
+                }
+            },
+        }
+        LOAD_DATA = {
+            "id": "%s:%s" % (self.PROJECT, "load_job"),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "load_job"},
+            "state": "DONE",
+            "configuration": {
+                "load": {
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": SOURCE_TABLE,
+                    },
+                    "sourceUris": [SOURCE_URI],
+                }
+            },
+        }
+        DATA = {
+            "nextPageToken": TOKEN,
+            "jobs": [ASYNC_QUERY_DATA, EXTRACT_DATA, COPY_DATA, LOAD_DATA],
+        }
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_jobs()
+        page = six.next(iterator.pages)
+        jobs = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(jobs), len(DATA["jobs"]))
+        for found, expected in zip(jobs, DATA["jobs"]):
+            name = expected["jobReference"]["jobId"]
+            self.assertIsInstance(found, JOB_TYPES[name])
+            self.assertEqual(found.job_id, name)
+        self.assertEqual(token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={"projection": "full"}
+        )
+
+    def test_list_jobs_load_job_wo_sourceUris(self):
+        from google.cloud.bigquery.job import LoadJob
+
+        SOURCE_TABLE = "source_table"
+        JOB_TYPES = {"load_job": LoadJob}
+        PATH = "projects/%s/jobs" % self.PROJECT
+        TOKEN = "TOKEN"
+        LOAD_DATA = {
+            "id": "%s:%s" % (self.PROJECT, "load_job"),
+            "jobReference": {"projectId": self.PROJECT, "jobId": "load_job"},
+            "state": "DONE",
+            "configuration": {
+                "load": {
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": SOURCE_TABLE,
+                    }
+                }
+            },
+        }
+        DATA = {"nextPageToken": TOKEN, "jobs": [LOAD_DATA]}
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_jobs()
+        page = six.next(iterator.pages)
+        jobs = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(jobs), len(DATA["jobs"]))
+        for found, expected in zip(jobs, DATA["jobs"]):
+            name = expected["jobReference"]["jobId"]
+            self.assertIsInstance(found, JOB_TYPES[name])
+            self.assertEqual(found.job_id, name)
+        self.assertEqual(token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={"projection": "full"}
+        )
+
+    def test_list_jobs_explicit_missing(self):
+        PATH = "projects/%s/jobs" % self.PROJECT
+        DATA = {}
+        TOKEN = "TOKEN"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection(DATA)
+
+        iterator = client.list_jobs(
+            max_results=1000, page_token=TOKEN, all_users=True, state_filter="done"
+        )
+        page = six.next(iterator.pages)
+        jobs = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(jobs), 0)
+        self.assertIsNone(token)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/%s" % PATH,
+            query_params={
+                "projection": "full",
+                "maxResults": 1000,
+                "pageToken": TOKEN,
+                "allUsers": True,
+                "stateFilter": "done",
+            },
+        )
+
+    def test_list_jobs_w_project(self):
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection({})
+
+        list(client.list_jobs(project="other-project"))
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/other-project/jobs",
+            query_params={"projection": "full"},
+        )
+
+    def test_list_jobs_w_time_filter(self):
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = make_connection({})
+
+        # One millisecond after the unix epoch.
+        start_time = datetime.datetime(1970, 1, 1, 0, 0, 0, 1000)
+        # One millisecond after the the 2038 31-bit signed int rollover
+        end_time = datetime.datetime(2038, 1, 19, 3, 14, 7, 1000)
+        end_time_millis = (((2 ** 31) - 1) * 1000) + 1
+
+        list(client.list_jobs(min_creation_time=start_time, max_creation_time=end_time))
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/%s/jobs" % self.PROJECT,
+            query_params={
+                "projection": "full",
+                "minCreationTime": "1",
+                "maxCreationTime": str(end_time_millis),
+            },
+        )
+
+    def test_load_table_from_uri(self):
+        from google.cloud.bigquery.job import LoadJob
+
+        JOB = "job_name"
+        DESTINATION = "destination_table"
+        SOURCE_URI = "http://example.com/source.csv"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "load": {
+                    "sourceUris": [SOURCE_URI],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": DESTINATION,
+                    },
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        destination = client.dataset(self.DS_ID).table(DESTINATION)
+
+        job = client.load_table_from_uri(SOURCE_URI, destination, job_id=JOB)
+
+        # Check that load_table_from_uri actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/%s/jobs" % self.PROJECT, data=RESOURCE
+        )
+
+        self.assertIsInstance(job, LoadJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(list(job.source_uris), [SOURCE_URI])
+        self.assertIs(job.destination, destination)
+
+        conn = client._connection = make_connection(RESOURCE)
+
+        job = client.load_table_from_uri([SOURCE_URI], destination, job_id=JOB)
+        self.assertIsInstance(job, LoadJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(list(job.source_uris), [SOURCE_URI])
+        self.assertIs(job.destination, destination)
+
+    def test_load_table_from_uri_w_explicit_project(self):
+        job_id = "this-is-a-job-id"
+        destination_id = "destination_table"
+        source_uri = "gs://example/source.csv"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {
+                "load": {
+                    "sourceUris": [source_uri],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": destination_id,
+                    },
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(resource)
+        destination = client.dataset(self.DS_ID).table(destination_id)
+
+        client.load_table_from_uri(
+            source_uri,
+            destination,
+            job_id=job_id,
+            project="other-project",
+            location=self.LOCATION,
+        )
+
+        # Check that load_table_from_uri actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_load_table_from_uri_w_client_location(self):
+        job_id = "this-is-a-job-id"
+        destination_id = "destination_table"
+        source_uri = "gs://example/source.csv"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {
+                "load": {
+                    "sourceUris": [source_uri],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": destination_id,
+                    },
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _http=http, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        client.load_table_from_uri(
+            source_uri,
+            # Test with string for table ID.
+            "{}.{}".format(self.DS_ID, destination_id),
+            job_id=job_id,
+            project="other-project",
+        )
+
+        # Check that load_table_from_uri actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    @staticmethod
+    def _mock_requests_response(status_code, headers, content=b""):
+        return mock.Mock(
+            content=content,
+            headers=headers,
+            status_code=status_code,
+            spec=["content", "headers", "status_code"],
+        )
+
+    def _mock_transport(self, status_code, headers, content=b""):
+        fake_transport = mock.Mock(spec=["request"])
+        fake_response = self._mock_requests_response(
+            status_code, headers, content=content
+        )
+        fake_transport.request.return_value = fake_response
+        return fake_transport
+
+    def _initiate_resumable_upload_helper(self, num_retries=None):
+        from google.resumable_media.requests import ResumableUpload
+        from google.cloud.bigquery.client import _DEFAULT_CHUNKSIZE
+        from google.cloud.bigquery.client import _GENERIC_CONTENT_TYPE
+        from google.cloud.bigquery.client import _get_upload_headers
+        from google.cloud.bigquery.job import LoadJob
+        from google.cloud.bigquery.job import LoadJobConfig
+        from google.cloud.bigquery.job import SourceFormat
+
+        # Create mocks to be checked for doing transport.
+        resumable_url = "http://test.invalid?upload_id=hey-you"
+        response_headers = {"location": resumable_url}
+        fake_transport = self._mock_transport(http_client.OK, response_headers)
+        client = self._make_one(project=self.PROJECT, _http=fake_transport)
+        conn = client._connection = make_connection()
+
+        # Create some mock arguments and call the method under test.
+        data = b"goodbye gudbi gootbee"
+        stream = io.BytesIO(data)
+        config = LoadJobConfig()
+        config.source_format = SourceFormat.CSV
+        job = LoadJob(None, None, self.TABLE_REF, client, job_config=config)
+        metadata = job.to_api_repr()
+        upload, transport = client._initiate_resumable_upload(
+            stream, metadata, num_retries
+        )
+
+        # Check the returned values.
+        self.assertIsInstance(upload, ResumableUpload)
+        upload_url = (
+            "https://www.googleapis.com/upload/bigquery/v2/projects/"
+            + self.PROJECT
+            + "/jobs?uploadType=resumable"
+        )
+        self.assertEqual(upload.upload_url, upload_url)
+        expected_headers = _get_upload_headers(conn.user_agent)
+        self.assertEqual(upload._headers, expected_headers)
+        self.assertFalse(upload.finished)
+        self.assertEqual(upload._chunk_size, _DEFAULT_CHUNKSIZE)
+        self.assertIs(upload._stream, stream)
+        self.assertIsNone(upload._total_bytes)
+        self.assertEqual(upload._content_type, _GENERIC_CONTENT_TYPE)
+        self.assertEqual(upload.resumable_url, resumable_url)
+
+        retry_strategy = upload._retry_strategy
+        self.assertEqual(retry_strategy.max_sleep, 64.0)
+        if num_retries is None:
+            self.assertEqual(retry_strategy.max_cumulative_retry, 600.0)
+            self.assertIsNone(retry_strategy.max_retries)
+        else:
+            self.assertIsNone(retry_strategy.max_cumulative_retry)
+            self.assertEqual(retry_strategy.max_retries, num_retries)
+        self.assertIs(transport, fake_transport)
+        # Make sure we never read from the stream.
+        self.assertEqual(stream.tell(), 0)
+
+        # Check the mocks.
+        request_headers = expected_headers.copy()
+        request_headers["x-upload-content-type"] = _GENERIC_CONTENT_TYPE
+        fake_transport.request.assert_called_once_with(
+            "POST",
+            upload_url,
+            data=json.dumps(metadata).encode("utf-8"),
+            headers=request_headers,
+            timeout=mock.ANY,
+        )
+
+    def test__initiate_resumable_upload(self):
+        self._initiate_resumable_upload_helper()
+
+    def test__initiate_resumable_upload_with_retry(self):
+        self._initiate_resumable_upload_helper(num_retries=11)
+
+    def _do_multipart_upload_success_helper(self, get_boundary, num_retries=None):
+        from google.cloud.bigquery.client import _get_upload_headers
+        from google.cloud.bigquery.job import LoadJob
+        from google.cloud.bigquery.job import LoadJobConfig
+        from google.cloud.bigquery.job import SourceFormat
+
+        fake_transport = self._mock_transport(http_client.OK, {})
+        client = self._make_one(project=self.PROJECT, _http=fake_transport)
+        conn = client._connection = make_connection()
+
+        # Create some mock arguments.
+        data = b"Bzzzz-zap \x00\x01\xf4"
+        stream = io.BytesIO(data)
+        config = LoadJobConfig()
+        config.source_format = SourceFormat.CSV
+        job = LoadJob(None, None, self.TABLE_REF, client, job_config=config)
+        metadata = job.to_api_repr()
+        size = len(data)
+        response = client._do_multipart_upload(stream, metadata, size, num_retries)
+
+        # Check the mocks and the returned value.
+        self.assertIs(response, fake_transport.request.return_value)
+        self.assertEqual(stream.tell(), size)
+        get_boundary.assert_called_once_with()
+
+        upload_url = (
+            "https://www.googleapis.com/upload/bigquery/v2/projects/"
+            + self.PROJECT
+            + "/jobs?uploadType=multipart"
+        )
+        payload = (
+            b"--==0==\r\n"
+            + b"content-type: application/json; charset=UTF-8\r\n\r\n"
+            + json.dumps(metadata).encode("utf-8")
+            + b"\r\n"
+            + b"--==0==\r\n"
+            + b"content-type: */*\r\n\r\n"
+            + data
+            + b"\r\n"
+            + b"--==0==--"
+        )
+        headers = _get_upload_headers(conn.user_agent)
+        headers["content-type"] = b'multipart/related; boundary="==0=="'
+        fake_transport.request.assert_called_once_with(
+            "POST", upload_url, data=payload, headers=headers, timeout=mock.ANY
+        )
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload(self, get_boundary):
+        self._do_multipart_upload_success_helper(get_boundary)
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload_with_retry(self, get_boundary):
+        self._do_multipart_upload_success_helper(get_boundary, num_retries=8)
+
+    def test_copy_table(self):
+        from google.cloud.bigquery.job import CopyJob
+
+        JOB = "job_name"
+        SOURCE = "source_table"
+        DESTINATION = "destination_table"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "copy": {
+                    "sourceTables": [
+                        {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": SOURCE,
+                        }
+                    ],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": DESTINATION,
+                    },
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        dataset = client.dataset(self.DS_ID)
+        source = dataset.table(SOURCE)
+        destination = dataset.table(DESTINATION)
+
+        job = client.copy_table(source, destination, job_id=JOB)
+
+        # Check that copy_table actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/%s/jobs" % self.PROJECT, data=RESOURCE
+        )
+
+        self.assertIsInstance(job, CopyJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(list(job.sources), [source])
+        self.assertIs(job.destination, destination)
+
+        conn = client._connection = make_connection(RESOURCE)
+        source2 = dataset.table(SOURCE + "2")
+        job = client.copy_table([source, source2], destination, job_id=JOB)
+        self.assertIsInstance(job, CopyJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(list(job.sources), [source, source2])
+        self.assertIs(job.destination, destination)
+
+    def test_copy_table_w_explicit_project(self):
+        job_id = "this-is-a-job-id"
+        source_id = "source_table"
+        destination_id = "destination_table"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {
+                "copy": {
+                    "sourceTables": [
+                        {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": source_id,
+                        }
+                    ],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": destination_id,
+                    },
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(resource)
+        dataset = client.dataset(self.DS_ID)
+        source = dataset.table(source_id)
+        destination = dataset.table(destination_id)
+
+        client.copy_table(
+            source,
+            destination,
+            job_id=job_id,
+            project="other-project",
+            location=self.LOCATION,
+        )
+
+        # Check that copy_table actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_copy_table_w_client_location(self):
+        job_id = "this-is-a-job-id"
+        source_id = "source_table"
+        destination_id = "destination_table"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {
+                "copy": {
+                    "sourceTables": [
+                        {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": source_id,
+                        }
+                    ],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": destination_id,
+                    },
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _http=http, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        client.copy_table(
+            # Test with string for table IDs.
+            "{}.{}".format(self.DS_ID, source_id),
+            "{}.{}".format(self.DS_ID, destination_id),
+            job_id=job_id,
+            project="other-project",
+        )
+
+        # Check that copy_table actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_copy_table_w_source_strings(self):
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        client._connection = make_connection({})
+        sources = [
+            "dataset_wo_proj.some_table",
+            "other_project.other_dataset.other_table",
+            client.dataset("dataset_from_ref").table("table_from_ref"),
+        ]
+        destination = "some_project.some_dataset.destination_table"
+
+        job = client.copy_table(sources, destination)
+
+        expected_sources = [
+            client.dataset("dataset_wo_proj").table("some_table"),
+            client.dataset("other_dataset", project="other_project").table(
+                "other_table"
+            ),
+            client.dataset("dataset_from_ref").table("table_from_ref"),
+        ]
+        self.assertEqual(list(job.sources), expected_sources)
+        expected_destination = client.dataset(
+            "some_dataset", project="some_project"
+        ).table("destination_table")
+        self.assertEqual(job.destination, expected_destination)
+
+    def test_extract_table(self):
+        from google.cloud.bigquery.job import ExtractJob
+
+        JOB = "job_id"
+        SOURCE = "source_table"
+        DESTINATION = "gs://bucket_name/object_name"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": SOURCE,
+                    },
+                    "destinationUris": [DESTINATION],
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        dataset = client.dataset(self.DS_ID)
+        source = dataset.table(SOURCE)
+
+        job = client.extract_table(source, DESTINATION, job_id=JOB)
+
+        # Check that extract_table actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/PROJECT/jobs", data=RESOURCE
+        )
+
+        # Check the job resource.
+        self.assertIsInstance(job, ExtractJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(job.source, source)
+        self.assertEqual(list(job.destination_uris), [DESTINATION])
+
+    def test_extract_table_w_explicit_project(self):
+        job_id = "job_id"
+        source_id = "source_table"
+        destination = "gs://bucket_name/object_name"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": source_id,
+                    },
+                    "destinationUris": [destination],
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(resource)
+        dataset = client.dataset(self.DS_ID)
+        source = dataset.table(source_id)
+
+        client.extract_table(
+            source,
+            destination,
+            job_id=job_id,
+            project="other-project",
+            location=self.LOCATION,
+        )
+
+        # Check that extract_table actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_extract_table_w_client_location(self):
+        job_id = "job_id"
+        source_id = "source_table"
+        destination = "gs://bucket_name/object_name"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": source_id,
+                    },
+                    "destinationUris": [destination],
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _http=http, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        client.extract_table(
+            # Test with string for table ID.
+            "{}.{}".format(self.DS_ID, source_id),
+            destination,
+            job_id=job_id,
+            project="other-project",
+        )
+
+        # Check that extract_table actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_extract_table_generated_job_id(self):
+        from google.cloud.bigquery.job import ExtractJob
+        from google.cloud.bigquery.job import ExtractJobConfig
+        from google.cloud.bigquery.job import DestinationFormat
+
+        JOB = "job_id"
+        SOURCE = "source_table"
+        DESTINATION = "gs://bucket_name/object_name"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": SOURCE,
+                    },
+                    "destinationUris": [DESTINATION],
+                    "destinationFormat": "NEWLINE_DELIMITED_JSON",
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        dataset = client.dataset(self.DS_ID)
+        source = dataset.table(SOURCE)
+        job_config = ExtractJobConfig()
+        job_config.destination_format = DestinationFormat.NEWLINE_DELIMITED_JSON
+
+        job = client.extract_table(source, DESTINATION, job_config=job_config)
+
+        # Check that extract_table actually starts the job.
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/projects/PROJECT/jobs")
+        self.assertIsInstance(req["data"]["jobReference"]["jobId"], six.string_types)
+
+        # Check the job resource.
+        self.assertIsInstance(job, ExtractJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.source, source)
+        self.assertEqual(list(job.destination_uris), [DESTINATION])
+
+    def test_extract_table_w_destination_uris(self):
+        from google.cloud.bigquery.job import ExtractJob
+
+        JOB = "job_id"
+        SOURCE = "source_table"
+        DESTINATION1 = "gs://bucket_name/object_one"
+        DESTINATION2 = "gs://bucket_name/object_two"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": SOURCE,
+                    },
+                    "destinationUris": [DESTINATION1, DESTINATION2],
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        dataset = client.dataset(self.DS_ID)
+        source = dataset.table(SOURCE)
+
+        job = client.extract_table(source, [DESTINATION1, DESTINATION2], job_id=JOB)
+
+        # Check that extract_table actually starts the job.
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/projects/PROJECT/jobs")
+
+        # Check the job resource.
+        self.assertIsInstance(job, ExtractJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(job.source, source)
+        self.assertEqual(list(job.destination_uris), [DESTINATION1, DESTINATION2])
+
+    def test_query_defaults(self):
+        from google.cloud.bigquery.job import QueryJob
+
+        QUERY = "select count(*) from persons"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": "some-random-id"},
+            "configuration": {"query": {"query": QUERY, "useLegacySql": False}},
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+
+        job = client.query(QUERY)
+
+        self.assertIsInstance(job, QueryJob)
+        self.assertIsInstance(job.job_id, six.string_types)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.query, QUERY)
+        self.assertEqual(job.udf_resources, [])
+        self.assertEqual(job.query_parameters, [])
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/projects/PROJECT/jobs")
+        sent = req["data"]
+        self.assertIsInstance(sent["jobReference"]["jobId"], six.string_types)
+        sent_config = sent["configuration"]["query"]
+        self.assertEqual(sent_config["query"], QUERY)
+        self.assertFalse(sent_config["useLegacySql"])
+
+    def test_query_w_explicit_project(self):
+        job_id = "some-job-id"
+        query = "select count(*) from persons"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {"query": {"query": query, "useLegacySql": False}},
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(resource)
+
+        client.query(
+            query, job_id=job_id, project="other-project", location=self.LOCATION
+        )
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_query_w_explicit_job_config(self):
+        job_id = "some-job-id"
+        query = "select count(*) from persons"
+        resource = {
+            "jobReference": {
+                "jobId": job_id,
+                "projectId": self.PROJECT,
+                "location": self.LOCATION,
+            },
+            "configuration": {
+                "query": {
+                    "query": query,
+                    "defaultDataset": {
+                        "projectId": self.PROJECT,
+                        "datasetId": "some-dataset",
+                    },
+                    "useLegacySql": False,
+                    "useQueryCache": True,
+                    "maximumBytesBilled": "2000",
+                }
+            },
+        }
+
+        creds = _make_credentials()
+        http = object()
+
+        from google.cloud.bigquery import QueryJobConfig, DatasetReference
+
+        default_job_config = QueryJobConfig()
+        default_job_config.default_dataset = DatasetReference(
+            self.PROJECT, "some-dataset"
+        )
+        default_job_config.maximum_bytes_billed = 1000
+
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            default_query_job_config=default_job_config,
+        )
+        conn = client._connection = make_connection(resource)
+
+        job_config = QueryJobConfig()
+        job_config.use_query_cache = True
+        job_config.maximum_bytes_billed = 2000
+
+        client.query(
+            query, job_id=job_id, location=self.LOCATION, job_config=job_config
+        )
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/PROJECT/jobs", data=resource
+        )
+
+    def test_query_w_explicit_job_config_override(self):
+        job_id = "some-job-id"
+        query = "select count(*) from persons"
+        resource = {
+            "jobReference": {
+                "jobId": job_id,
+                "projectId": self.PROJECT,
+                "location": self.LOCATION,
+            },
+            "configuration": {
+                "query": {
+                    "query": query,
+                    "defaultDataset": None,
+                    "useLegacySql": False,
+                    "useQueryCache": True,
+                    "maximumBytesBilled": "2000",
+                }
+            },
+        }
+
+        creds = _make_credentials()
+        http = object()
+
+        from google.cloud.bigquery import QueryJobConfig, DatasetReference
+
+        default_job_config = QueryJobConfig()
+        default_job_config.default_dataset = DatasetReference(
+            self.PROJECT, "some-dataset"
+        )
+        default_job_config.maximum_bytes_billed = 1000
+
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            default_query_job_config=default_job_config,
+        )
+        conn = client._connection = make_connection(resource)
+
+        job_config = QueryJobConfig()
+        job_config.use_query_cache = True
+        job_config.maximum_bytes_billed = 2000
+        job_config.default_dataset = None
+
+        client.query(
+            query, job_id=job_id, location=self.LOCATION, job_config=job_config
+        )
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/PROJECT/jobs", data=resource
+        )
+
+    def test_query_w_client_default_config_no_incoming(self):
+        job_id = "some-job-id"
+        query = "select count(*) from persons"
+        resource = {
+            "jobReference": {
+                "jobId": job_id,
+                "projectId": self.PROJECT,
+                "location": self.LOCATION,
+            },
+            "configuration": {
+                "query": {
+                    "query": query,
+                    "useLegacySql": False,
+                    "maximumBytesBilled": "1000",
+                }
+            },
+        }
+
+        creds = _make_credentials()
+        http = object()
+
+        from google.cloud.bigquery import QueryJobConfig
+
+        default_job_config = QueryJobConfig()
+        default_job_config.maximum_bytes_billed = 1000
+
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=creds,
+            _http=http,
+            default_query_job_config=default_job_config,
+        )
+        conn = client._connection = make_connection(resource)
+
+        client.query(query, job_id=job_id, location=self.LOCATION)
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/PROJECT/jobs", data=resource
+        )
+
+    def test_query_w_client_location(self):
+        job_id = "some-job-id"
+        query = "select count(*) from persons"
+        resource = {
+            "jobReference": {
+                "projectId": "other-project",
+                "location": self.LOCATION,
+                "jobId": job_id,
+            },
+            "configuration": {"query": {"query": query, "useLegacySql": False}},
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _http=http, location=self.LOCATION
+        )
+        conn = client._connection = make_connection(resource)
+
+        client.query(query, job_id=job_id, project="other-project")
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/projects/other-project/jobs", data=resource
+        )
+
+    def test_query_detect_location(self):
+        query = "select count(*) from persons"
+        resource_location = "EU"
+        resource = {
+            "jobReference": {
+                "projectId": self.PROJECT,
+                # Location not set in request, but present in the response.
+                "location": resource_location,
+                "jobId": "some-random-id",
+            },
+            "configuration": {"query": {"query": query, "useLegacySql": False}},
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(resource)
+
+        job = client.query(query)
+
+        self.assertEqual(job.location, resource_location)
+
+        # Check that request did not contain a location.
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        sent = req["data"]
+        self.assertIsNone(sent["jobReference"].get("location"))
+
+    def test_query_w_udf_resources(self):
+        from google.cloud.bigquery.job import QueryJob
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import UDFResource
+
+        RESOURCE_URI = "gs://some-bucket/js/lib.js"
+        JOB = "job_name"
+        QUERY = "select count(*) from persons"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "query": {
+                    "query": QUERY,
+                    "useLegacySql": True,
+                    "userDefinedFunctionResources": [{"resourceUri": RESOURCE_URI}],
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        udf_resources = [UDFResource("resourceUri", RESOURCE_URI)]
+        config = QueryJobConfig()
+        config.udf_resources = udf_resources
+        config.use_legacy_sql = True
+
+        job = client.query(QUERY, job_config=config, job_id=JOB)
+
+        self.assertIsInstance(job, QueryJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(job.query, QUERY)
+        self.assertEqual(job.udf_resources, udf_resources)
+        self.assertEqual(job.query_parameters, [])
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/projects/PROJECT/jobs")
+        sent = req["data"]
+        self.assertIsInstance(sent["jobReference"]["jobId"], six.string_types)
+        sent_config = sent["configuration"]["query"]
+        self.assertEqual(sent_config["query"], QUERY)
+        self.assertTrue(sent_config["useLegacySql"])
+        self.assertEqual(
+            sent_config["userDefinedFunctionResources"][0],
+            {"resourceUri": RESOURCE_URI},
+        )
+
+    def test_query_w_query_parameters(self):
+        from google.cloud.bigquery.job import QueryJob
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        JOB = "job_name"
+        QUERY = "select count(*) from persons"
+        RESOURCE = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": JOB},
+            "configuration": {
+                "query": {
+                    "query": QUERY,
+                    "useLegacySql": False,
+                    "queryParameters": [
+                        {
+                            "name": "foo",
+                            "parameterType": {"type": "INT64"},
+                            "parameterValue": {"value": "123"},
+                        }
+                    ],
+                }
+            },
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESOURCE)
+        query_parameters = [ScalarQueryParameter("foo", "INT64", 123)]
+        config = QueryJobConfig()
+        config.query_parameters = query_parameters
+
+        job = client.query(QUERY, job_config=config, job_id=JOB)
+
+        self.assertIsInstance(job, QueryJob)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_id, JOB)
+        self.assertEqual(job.query, QUERY)
+        self.assertEqual(job.udf_resources, [])
+        self.assertEqual(job.query_parameters, query_parameters)
+
+        # Check that query actually starts the job.
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/projects/PROJECT/jobs")
+        sent = req["data"]
+        self.assertEqual(sent["jobReference"]["jobId"], JOB)
+        sent_config = sent["configuration"]["query"]
+        self.assertEqual(sent_config["query"], QUERY)
+        self.assertFalse(sent_config["useLegacySql"])
+        self.assertEqual(
+            sent_config["queryParameters"][0],
+            {
+                "name": "foo",
+                "parameterType": {"type": "INT64"},
+                "parameterValue": {"value": "123"},
+            },
+        )
+
+    def test_insert_rows_wo_schema(self):
+        from google.cloud.bigquery.table import Table
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        table = Table(self.TABLE_REF)
+        ROWS = [
+            ("Phred Phlyntstone", 32),
+            ("Bharney Rhubble", 33),
+            ("Wylma Phlyntstone", 29),
+            ("Bhettye Rhubble", 27),
+        ]
+
+        with self.assertRaises(ValueError) as exc:
+            client.insert_rows(table, ROWS)
+
+        self.assertIn("Could not determine schema for table", exc.exception.args[0])
+
+    def test_insert_rows_w_schema(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_rfc3339
+        from google.cloud._helpers import _microseconds_from_datetime
+        from google.cloud.bigquery.table import SchemaField
+
+        WHEN_TS = 1437767599.006
+        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(tzinfo=UTC)
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField("joined", "TIMESTAMP", mode="NULLABLE"),
+        ]
+        ROWS = [
+            ("Phred Phlyntstone", 32, _datetime_to_rfc3339(WHEN)),
+            ("Bharney Rhubble", 33, WHEN + datetime.timedelta(seconds=1)),
+            ("Wylma Phlyntstone", 29, WHEN + datetime.timedelta(seconds=2)),
+            ("Bhettye Rhubble", 27, None),
+        ]
+
+        def _row_data(row):
+            joined = row[2]
+            if isinstance(row[2], datetime.datetime):
+                joined = _microseconds_from_datetime(joined) * 1e-6
+            return {"full_name": row[0], "age": str(row[1]), "joined": joined}
+
+        SENT = {
+            "rows": [
+                {"json": _row_data(row), "insertId": str(i)}
+                for i, row in enumerate(ROWS)
+            ]
+        }
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(ROWS)))):
+            # Test with using string IDs for the table.
+            errors = client.insert_rows(
+                "{}.{}".format(self.DS_ID, self.TABLE_ID), ROWS, selected_fields=schema
+            )
+
+        self.assertEqual(len(errors), 0)
+        conn.api_request.assert_called_once()
+        _, req = conn.api_request.call_args
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self.assertEqual(req["data"], SENT)
+
+    def test_insert_rows_w_list_of_dictionaries(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_rfc3339
+        from google.cloud._helpers import _microseconds_from_datetime
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        WHEN_TS = 1437767599.006
+        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(tzinfo=UTC)
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField("joined", "TIMESTAMP", mode="NULLABLE"),
+        ]
+        table = Table(self.TABLE_REF, schema=schema)
+        ROWS = [
+            {
+                "full_name": "Phred Phlyntstone",
+                "age": 32,
+                "joined": _datetime_to_rfc3339(WHEN),
+            },
+            {
+                "full_name": "Bharney Rhubble",
+                "age": 33,
+                "joined": WHEN + datetime.timedelta(seconds=1),
+            },
+            {
+                "full_name": "Wylma Phlyntstone",
+                "age": 29,
+                "joined": WHEN + datetime.timedelta(seconds=2),
+            },
+            {"full_name": "Bhettye Rhubble", "age": 27, "joined": None},
+        ]
+
+        def _row_data(row):
+            joined = row["joined"]
+            if isinstance(joined, datetime.datetime):
+                row["joined"] = _microseconds_from_datetime(joined) * 1e-6
+            row["age"] = str(row["age"])
+            return row
+
+        SENT = {
+            "rows": [
+                {"json": _row_data(row), "insertId": str(i)}
+                for i, row in enumerate(ROWS)
+            ]
+        }
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(ROWS)))):
+            errors = client.insert_rows(table, ROWS)
+
+        self.assertEqual(len(errors), 0)
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/%s" % PATH, data=SENT
+        )
+
+    def test_insert_rows_w_list_of_Rows(self):
+        from google.cloud.bigquery.table import Table
+        from google.cloud.bigquery.table import SchemaField
+        from google.cloud.bigquery.table import Row
+
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        table = Table(self.TABLE_REF, schema=schema)
+        f2i = {"full_name": 0, "age": 1}
+        ROWS = [
+            Row(("Phred Phlyntstone", 32), f2i),
+            Row(("Bharney Rhubble", 33), f2i),
+            Row(("Wylma Phlyntstone", 29), f2i),
+            Row(("Bhettye Rhubble", 27), f2i),
+        ]
+
+        def _row_data(row):
+            return {"full_name": row[0], "age": str(row[1])}
+
+        SENT = {
+            "rows": [
+                {"json": _row_data(row), "insertId": str(i)}
+                for i, row in enumerate(ROWS)
+            ]
+        }
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(ROWS)))):
+            errors = client.insert_rows(table, ROWS)
+
+        self.assertEqual(len(errors), 0)
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/%s" % PATH, data=SENT
+        )
+
+    def test_insert_rows_w_skip_invalid_and_ignore_unknown(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        RESPONSE = {
+            "insertErrors": [
+                {
+                    "index": 1,
+                    "errors": [
+                        {
+                            "reason": "REASON",
+                            "location": "LOCATION",
+                            "debugInfo": "INFO",
+                            "message": "MESSAGE",
+                        }
+                    ],
+                }
+            ]
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(RESPONSE)
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField("voter", "BOOLEAN", mode="NULLABLE"),
+        ]
+        table = Table(self.TABLE_REF, schema=schema)
+        ROWS = [
+            ("Phred Phlyntstone", 32, True),
+            ("Bharney Rhubble", 33, False),
+            ("Wylma Phlyntstone", 29, True),
+            ("Bhettye Rhubble", 27, True),
+        ]
+
+        def _row_data(row):
+            return {
+                "full_name": row[0],
+                "age": str(row[1]),
+                "voter": row[2] and "true" or "false",
+            }
+
+        SENT = {
+            "skipInvalidRows": True,
+            "ignoreUnknownValues": True,
+            "templateSuffix": "20160303",
+            "rows": [
+                {"insertId": index, "json": _row_data(row)}
+                for index, row in enumerate(ROWS)
+            ],
+        }
+
+        errors = client.insert_rows(
+            table,
+            ROWS,
+            row_ids=[index for index, _ in enumerate(ROWS)],
+            skip_invalid_rows=True,
+            ignore_unknown_values=True,
+            template_suffix="20160303",
+        )
+
+        self.assertEqual(len(errors), 1)
+        self.assertEqual(errors[0]["index"], 1)
+        self.assertEqual(len(errors[0]["errors"]), 1)
+        self.assertEqual(
+            errors[0]["errors"][0], RESPONSE["insertErrors"][0]["errors"][0]
+        )
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/%s" % PATH, data=SENT
+        )
+
+    def test_insert_rows_w_repeated_fields(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        color = SchemaField("color", "STRING", mode="REPEATED")
+        items = SchemaField("items", "INTEGER", mode="REPEATED")
+        score = SchemaField("score", "INTEGER")
+        times = SchemaField("times", "TIMESTAMP", mode="REPEATED")
+        distances = SchemaField("distances", "FLOAT", mode="REPEATED")
+        structs = SchemaField(
+            "structs", "RECORD", mode="REPEATED", fields=[score, times, distances]
+        )
+        table = Table(self.TABLE_REF, schema=[color, items, structs])
+        ROWS = [
+            (
+                ["red", "green"],
+                [1, 2],
+                [
+                    (
+                        12,
+                        [
+                            datetime.datetime(2018, 12, 1, 12, 0, 0, tzinfo=pytz.utc),
+                            datetime.datetime(2018, 12, 1, 13, 0, 0, tzinfo=pytz.utc),
+                        ],
+                        [1.25, 2.5],
+                    ),
+                    {
+                        "score": 13,
+                        "times": [
+                            datetime.datetime(2018, 12, 2, 12, 0, 0, tzinfo=pytz.utc),
+                            datetime.datetime(2018, 12, 2, 13, 0, 0, tzinfo=pytz.utc),
+                        ],
+                        "distances": [-1.25, -2.5],
+                    },
+                ],
+            ),
+            {"color": None, "items": [], "structs": [(None, [], [3.5])]},
+        ]
+
+        SENT = {
+            "rows": [
+                {
+                    "json": {
+                        "color": ["red", "green"],
+                        "items": ["1", "2"],
+                        "structs": [
+                            {
+                                "score": "12",
+                                "times": [
+                                    1543665600.0,  # 2018-12-01 12:00 UTC
+                                    1543669200.0,  # 2018-12-01 13:00 UTC
+                                ],
+                                "distances": [1.25, 2.5],
+                            },
+                            {
+                                "score": "13",
+                                "times": [
+                                    1543752000.0,  # 2018-12-02 12:00 UTC
+                                    1543755600.0,  # 2018-12-02 13:00 UTC
+                                ],
+                                "distances": [-1.25, -2.5],
+                            },
+                        ],
+                    },
+                    "insertId": "0",
+                },
+                {
+                    "json": {
+                        "color": None,
+                        "items": [],
+                        "structs": [{"score": None, "times": [], "distances": [3.5]}],
+                    },
+                    "insertId": "1",
+                },
+            ]
+        }
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(ROWS)))):
+            errors = client.insert_rows(table, ROWS)
+
+        self.assertEqual(len(errors), 0)
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/%s" % PATH, data=SENT
+        )
+
+    def test_insert_rows_w_record_schema(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        area_code = SchemaField("area_code", "STRING", "REQUIRED")
+        local_number = SchemaField("local_number", "STRING", "REQUIRED")
+        rank = SchemaField("rank", "INTEGER", "REQUIRED")
+        phone = SchemaField(
+            "phone", "RECORD", mode="NULLABLE", fields=[area_code, local_number, rank]
+        )
+        ROWS = [
+            (
+                "Phred Phlyntstone",
+                {"area_code": "800", "local_number": "555-1212", "rank": 1},
+            ),
+            ("Bharney Rhubble", ("877", "768-5309", 2)),
+            ("Wylma Phlyntstone", None),
+        ]
+
+        SENT = {
+            "rows": [
+                {
+                    "json": {
+                        "full_name": "Phred Phlyntstone",
+                        "phone": {
+                            "area_code": "800",
+                            "local_number": "555-1212",
+                            "rank": "1",
+                        },
+                    },
+                    "insertId": "0",
+                },
+                {
+                    "json": {
+                        "full_name": "Bharney Rhubble",
+                        "phone": {
+                            "area_code": "877",
+                            "local_number": "768-5309",
+                            "rank": "2",
+                        },
+                    },
+                    "insertId": "1",
+                },
+                {
+                    "json": {"full_name": "Wylma Phlyntstone", "phone": None},
+                    "insertId": "2",
+                },
+            ]
+        }
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(ROWS)))):
+            errors = client.insert_rows(
+                self.TABLE_REF, ROWS, selected_fields=[full_name, phone]
+            )
+
+        self.assertEqual(len(errors), 0)
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/%s" % PATH, data=SENT
+        )
+
+    def test_insert_rows_errors(self):
+        from google.cloud.bigquery.table import Table
+
+        ROWS = [
+            ("Phred Phlyntstone", 32, True),
+            ("Bharney Rhubble", 33, False),
+            ("Wylma Phlyntstone", 29, True),
+            ("Bhettye Rhubble", 27, True),
+        ]
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+
+        # table ref with no selected fields
+        with self.assertRaises(ValueError):
+            client.insert_rows(self.TABLE_REF, ROWS)
+
+        # table with no schema
+        with self.assertRaises(ValueError):
+            client.insert_rows(Table(self.TABLE_REF), ROWS)
+
+        # neither Table nor tableReference
+        with self.assertRaises(TypeError):
+            client.insert_rows(1, ROWS)
+
+    def test_insert_rows_w_numeric(self):
+        from google.cloud.bigquery import table
+
+        project = "PROJECT"
+        ds_id = "DS_ID"
+        table_id = "TABLE_ID"
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=project, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        table_ref = DatasetReference(project, ds_id).table(table_id)
+        schema = [
+            table.SchemaField("account", "STRING"),
+            table.SchemaField("balance", "NUMERIC"),
+        ]
+        insert_table = table.Table(table_ref, schema=schema)
+        rows = [
+            ("Savings", decimal.Decimal("23.47")),
+            ("Checking", decimal.Decimal("1.98")),
+            ("Mortgage", decimal.Decimal("-12345678909.87654321")),
+        ]
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(rows)))):
+            errors = client.insert_rows(insert_table, rows)
+
+        self.assertEqual(len(errors), 0)
+        rows_json = [
+            {"account": "Savings", "balance": "23.47"},
+            {"account": "Checking", "balance": "1.98"},
+            {"account": "Mortgage", "balance": "-12345678909.87654321"},
+        ]
+        sent = {
+            "rows": [
+                {"json": row, "insertId": str(i)} for i, row in enumerate(rows_json)
+            ]
+        }
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/{}/datasets/{}/tables/{}/insertAll".format(
+                project, ds_id, table_id
+            ),
+            data=sent,
+        )
+
+    def test_insert_rows_json(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        PROJECT = "PROJECT"
+        DS_ID = "DS_ID"
+        TABLE_ID = "TABLE_ID"
+        PATH = "projects/%s/datasets/%s/tables/%s/insertAll" % (
+            PROJECT,
+            DS_ID,
+            TABLE_ID,
+        )
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection({})
+        table_ref = DatasetReference(PROJECT, DS_ID).table(TABLE_ID)
+        schema = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField("joined", "TIMESTAMP", mode="NULLABLE"),
+        ]
+        table = Table(table_ref, schema=schema)
+        ROWS = [
+            {
+                "full_name": "Phred Phlyntstone",
+                "age": "32",
+                "joined": "2015-07-24T19:53:19.006000Z",
+            },
+            {"full_name": "Bharney Rhubble", "age": "33", "joined": 1437767600.006},
+            {"full_name": "Wylma Phlyntstone", "age": "29", "joined": 1437767601.006},
+            {"full_name": "Bhettye Rhubble", "age": "27", "joined": None},
+        ]
+
+        SENT = {
+            "rows": [{"json": row, "insertId": str(i)} for i, row in enumerate(ROWS)]
+        }
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(ROWS)))):
+            errors = client.insert_rows_json(table, ROWS)
+
+        self.assertEqual(len(errors), 0)
+        conn.api_request.assert_called_once_with(
+            method="POST", path="/%s" % PATH, data=SENT
+        )
+
+    def test_insert_rows_json_with_string_id(self):
+        rows = [{"col1": "val1"}]
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(
+            project="default-project", credentials=creds, _http=http
+        )
+        conn = client._connection = make_connection({})
+
+        with mock.patch("uuid.uuid4", side_effect=map(str, range(len(rows)))):
+            errors = client.insert_rows_json("proj.dset.tbl", rows)
+
+        self.assertEqual(len(errors), 0)
+        expected = {
+            "rows": [{"json": row, "insertId": str(i)} for i, row in enumerate(rows)]
+        }
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/proj/datasets/dset/tables/tbl/insertAll",
+            data=expected,
+        )
+
+    def test_list_partitions(self):
+        from google.cloud.bigquery.table import Table
+
+        rows = 3
+        meta_info = _make_list_partitons_meta_info(
+            self.PROJECT, self.DS_ID, self.TABLE_ID, rows
+        )
+
+        data = {
+            "totalRows": str(rows),
+            "rows": [
+                {"f": [{"v": "20180101"}]},
+                {"f": [{"v": "20180102"}]},
+                {"f": [{"v": "20180103"}]},
+            ],
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        client._connection = make_connection(meta_info, data)
+        table = Table(self.TABLE_REF)
+
+        partition_list = client.list_partitions(table)
+        self.assertEqual(len(partition_list), rows)
+        self.assertIn("20180102", partition_list)
+
+    def test_list_partitions_with_string_id(self):
+        meta_info = _make_list_partitons_meta_info(
+            self.PROJECT, self.DS_ID, self.TABLE_ID, 0
+        )
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        client._connection = make_connection(meta_info, {})
+
+        partition_list = client.list_partitions(
+            "{}.{}".format(self.DS_ID, self.TABLE_ID)
+        )
+
+        self.assertEqual(len(partition_list), 0)
+
+    def test_list_rows(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud.bigquery.table import Table
+        from google.cloud.bigquery.table import SchemaField
+        from google.cloud.bigquery.table import Row
+
+        PATH = "projects/%s/datasets/%s/tables/%s/data" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        WHEN_TS = 1437767599.006
+        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(tzinfo=UTC)
+        WHEN_1 = WHEN + datetime.timedelta(seconds=1)
+        WHEN_2 = WHEN + datetime.timedelta(seconds=2)
+        ROWS = 1234
+        TOKEN = "TOKEN"
+
+        def _bigquery_timestamp_float_repr(ts_float):
+            # Preserve microsecond precision for E+09 timestamps
+            return "%0.15E" % (ts_float,)
+
+        DATA = {
+            "totalRows": str(ROWS),
+            "pageToken": TOKEN,
+            "rows": [
+                {
+                    "f": [
+                        {"v": "Phred Phlyntstone"},
+                        {"v": "32"},
+                        {"v": _bigquery_timestamp_float_repr(WHEN_TS)},
+                    ]
+                },
+                {
+                    "f": [
+                        {"v": "Bharney Rhubble"},
+                        {"v": "33"},
+                        {"v": _bigquery_timestamp_float_repr(WHEN_TS + 1)},
+                    ]
+                },
+                {
+                    "f": [
+                        {"v": "Wylma Phlyntstone"},
+                        {"v": "29"},
+                        {"v": _bigquery_timestamp_float_repr(WHEN_TS + 2)},
+                    ]
+                },
+                {"f": [{"v": "Bhettye Rhubble"}, {"v": None}, {"v": None}]},
+            ],
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(DATA, DATA)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="NULLABLE")
+        joined = SchemaField("joined", "TIMESTAMP", mode="NULLABLE")
+        table = Table(self.TABLE_REF, schema=[full_name, age, joined])
+
+        iterator = client.list_rows(table)
+        page = six.next(iterator.pages)
+        rows = list(page)
+        total_rows = iterator.total_rows
+        page_token = iterator.next_page_token
+
+        f2i = {"full_name": 0, "age": 1, "joined": 2}
+        self.assertEqual(len(rows), 4)
+        self.assertEqual(rows[0], Row(("Phred Phlyntstone", 32, WHEN), f2i))
+        self.assertEqual(rows[1], Row(("Bharney Rhubble", 33, WHEN_1), f2i))
+        self.assertEqual(rows[2], Row(("Wylma Phlyntstone", 29, WHEN_2), f2i))
+        self.assertEqual(rows[3], Row(("Bhettye Rhubble", None, None), f2i))
+        self.assertEqual(total_rows, ROWS)
+        self.assertEqual(page_token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={}
+        )
+
+    def test_list_rows_empty_table(self):
+        response = {"totalRows": "0", "rows": []}
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        client._connection = make_connection(response, response)
+
+        # Table that has no schema because it's an empty table.
+        rows = client.list_rows(
+            # Test with using a string for the table ID.
+            "{}.{}.{}".format(
+                self.TABLE_REF.project,
+                self.TABLE_REF.dataset_id,
+                self.TABLE_REF.table_id,
+            ),
+            selected_fields=[],
+        )
+
+        # When a table reference / string and selected_fields is provided,
+        # total_rows can't be populated until iteration starts.
+        self.assertIsNone(rows.total_rows)
+        self.assertEqual(tuple(rows), ())
+        self.assertEqual(rows.total_rows, 0)
+
+    def test_list_rows_query_params(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        table = Table(
+            self.TABLE_REF, schema=[SchemaField("age", "INTEGER", mode="NULLABLE")]
+        )
+        tests = [
+            ({}, {}),
+            ({"start_index": 1}, {"startIndex": 1}),
+            ({"max_results": 2}, {"maxResults": 2}),
+            ({"start_index": 1, "max_results": 2}, {"startIndex": 1, "maxResults": 2}),
+        ]
+        conn = client._connection = make_connection(*len(tests) * [{}])
+        for i, test in enumerate(tests):
+            iterator = client.list_rows(table, **test[0])
+            six.next(iterator.pages)
+            req = conn.api_request.call_args_list[i]
+            self.assertEqual(req[1]["query_params"], test[1], "for kwargs %s" % test[0])
+
+    def test_list_rows_repeated_fields(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        PATH = "projects/%s/datasets/%s/tables/%s/data" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        ROWS = 1234
+        TOKEN = "TOKEN"
+        DATA = {
+            "totalRows": ROWS,
+            "pageToken": TOKEN,
+            "rows": [
+                {
+                    "f": [
+                        {"v": [{"v": "red"}, {"v": "green"}]},
+                        {
+                            "v": [
+                                {
+                                    "v": {
+                                        "f": [
+                                            {"v": [{"v": "1"}, {"v": "2"}]},
+                                            {"v": [{"v": "3.1415"}, {"v": "1.414"}]},
+                                        ]
+                                    }
+                                }
+                            ]
+                        },
+                    ]
+                }
+            ],
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(DATA)
+        color = SchemaField("color", "STRING", mode="REPEATED")
+        index = SchemaField("index", "INTEGER", "REPEATED")
+        score = SchemaField("score", "FLOAT", "REPEATED")
+        struct = SchemaField("struct", "RECORD", mode="REPEATED", fields=[index, score])
+
+        iterator = client.list_rows(self.TABLE_REF, selected_fields=[color, struct])
+        page = six.next(iterator.pages)
+        rows = list(page)
+        total_rows = iterator.total_rows
+        page_token = iterator.next_page_token
+
+        self.assertEqual(len(rows), 1)
+        self.assertEqual(rows[0][0], ["red", "green"])
+        self.assertEqual(rows[0][1], [{"index": [1, 2], "score": [3.1415, 1.414]}])
+        self.assertEqual(total_rows, ROWS)
+        self.assertEqual(page_token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/%s" % PATH,
+            query_params={"selectedFields": "color,struct"},
+        )
+
+    def test_list_rows_w_record_schema(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        PATH = "projects/%s/datasets/%s/tables/%s/data" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        ROWS = 1234
+        TOKEN = "TOKEN"
+        DATA = {
+            "totalRows": ROWS,
+            "pageToken": TOKEN,
+            "rows": [
+                {
+                    "f": [
+                        {"v": "Phred Phlyntstone"},
+                        {"v": {"f": [{"v": "800"}, {"v": "555-1212"}, {"v": 1}]}},
+                    ]
+                },
+                {
+                    "f": [
+                        {"v": "Bharney Rhubble"},
+                        {"v": {"f": [{"v": "877"}, {"v": "768-5309"}, {"v": 2}]}},
+                    ]
+                },
+                {"f": [{"v": "Wylma Phlyntstone"}, {"v": None}]},
+            ],
+        }
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        conn = client._connection = make_connection(DATA)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        area_code = SchemaField("area_code", "STRING", "REQUIRED")
+        local_number = SchemaField("local_number", "STRING", "REQUIRED")
+        rank = SchemaField("rank", "INTEGER", "REQUIRED")
+        phone = SchemaField(
+            "phone", "RECORD", mode="NULLABLE", fields=[area_code, local_number, rank]
+        )
+        table = Table(self.TABLE_REF, schema=[full_name, phone])
+
+        iterator = client.list_rows(table)
+        page = six.next(iterator.pages)
+        rows = list(page)
+        total_rows = iterator.total_rows
+        page_token = iterator.next_page_token
+
+        self.assertEqual(len(rows), 3)
+        self.assertEqual(rows[0][0], "Phred Phlyntstone")
+        self.assertEqual(
+            rows[0][1], {"area_code": "800", "local_number": "555-1212", "rank": 1}
+        )
+        self.assertEqual(rows[1][0], "Bharney Rhubble")
+        self.assertEqual(
+            rows[1][1], {"area_code": "877", "local_number": "768-5309", "rank": 2}
+        )
+        self.assertEqual(rows[2][0], "Wylma Phlyntstone")
+        self.assertIsNone(rows[2][1])
+        self.assertEqual(total_rows, ROWS)
+        self.assertEqual(page_token, TOKEN)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path="/%s" % PATH, query_params={}
+        )
+
+    def test_list_rows_with_missing_schema(self):
+        from google.cloud.bigquery.table import Table, TableListItem
+
+        table_path = "/projects/{}/datasets/{}/tables/{}".format(
+            self.PROJECT, self.DS_ID, self.TABLE_ID
+        )
+        tabledata_path = "{}/data".format(table_path)
+
+        table_list_item_data = {
+            "id": "%s:%s:%s" % (self.PROJECT, self.DS_ID, self.TABLE_ID),
+            "tableReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.TABLE_ID,
+            },
+        }
+        table_data = copy.deepcopy(table_list_item_data)
+        # Intentionally make wrong, since total_rows can update during iteration.
+        table_data["numRows"] = 2
+        table_data["schema"] = {
+            "fields": [
+                {"name": "name", "type": "STRING"},
+                {"name": "age", "type": "INTEGER"},
+            ]
+        }
+        rows_data = {
+            "totalRows": 3,
+            "pageToken": None,
+            "rows": [
+                {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+                {"f": [{"v": "Bharney Rhubble"}, {"v": "31"}]},
+                {"f": [{"v": "Wylma Phlyntstone"}, {"v": None}]},
+            ],
+        }
+
+        creds = _make_credentials()
+        http = object()
+
+        schemaless_tables = (
+            "{}.{}".format(self.DS_ID, self.TABLE_ID),
+            self.TABLE_REF,
+            Table(self.TABLE_REF),
+            TableListItem(table_list_item_data),
+        )
+
+        for table in schemaless_tables:
+            client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+            conn = client._connection = make_connection(table_data, rows_data)
+
+            row_iter = client.list_rows(table)
+
+            conn.api_request.assert_called_once_with(method="GET", path=table_path)
+            conn.api_request.reset_mock()
+            self.assertEqual(row_iter.total_rows, 2, msg=repr(table))
+
+            rows = list(row_iter)
+            conn.api_request.assert_called_once_with(
+                method="GET", path=tabledata_path, query_params={}
+            )
+            self.assertEqual(row_iter.total_rows, 3, msg=repr(table))
+            self.assertEqual(rows[0].name, "Phred Phlyntstone", msg=repr(table))
+            self.assertEqual(rows[1].age, 31, msg=repr(table))
+            self.assertIsNone(rows[2].age, msg=repr(table))
+
+    def test_list_rows_error(self):
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+
+        # neither Table nor tableReference
+        with self.assertRaises(TypeError):
+            client.list_rows(1)
+
+
+class Test_make_job_id(unittest.TestCase):
+    def _call_fut(self, job_id, prefix=None):
+        from google.cloud.bigquery.client import _make_job_id
+
+        return _make_job_id(job_id, prefix=prefix)
+
+    def test__make_job_id_wo_suffix(self):
+        job_id = self._call_fut("job_id")
+
+        self.assertEqual(job_id, "job_id")
+
+    def test__make_job_id_w_suffix(self):
+        with mock.patch("uuid.uuid4", side_effect=["212345"]):
+            job_id = self._call_fut(None, prefix="job_id")
+
+        self.assertEqual(job_id, "job_id212345")
+
+    def test__make_random_job_id(self):
+        with mock.patch("uuid.uuid4", side_effect=["212345"]):
+            job_id = self._call_fut(None)
+
+        self.assertEqual(job_id, "212345")
+
+    def test__make_job_id_w_job_id_overrides_prefix(self):
+        job_id = self._call_fut("job_id", prefix="unused_prefix")
+
+        self.assertEqual(job_id, "job_id")
+
+
+class TestClientUpload(object):
+    # NOTE: This is a "partner" to `TestClient` meant to test some of the
+    #       "load_table_from_file" portions of `Client`. It also uses
+    #       `pytest`-style tests rather than `unittest`-style.
+    from google.cloud.bigquery.job import SourceFormat
+
+    TABLE_REF = DatasetReference("project_id", "test_dataset").table("test_table")
+
+    LOCATION = "us-central"
+
+    @staticmethod
+    def _make_client(transport=None, location=None):
+        from google.cloud.bigquery import _http
+        from google.cloud.bigquery import client
+
+        cl = client.Client(
+            project="project_id",
+            credentials=_make_credentials(),
+            _http=transport,
+            location=location,
+        )
+        cl._connection = mock.create_autospec(_http.Connection, instance=True)
+        return cl
+
+    @staticmethod
+    def _make_response(status_code, content="", headers={}):
+        """Make a mock HTTP response."""
+        import requests
+
+        response = requests.Response()
+        response.request = requests.Request("POST", "http://example.com").prepare()
+        response._content = content.encode("utf-8")
+        response.headers.update(headers)
+        response.status_code = status_code
+        return response
+
+    @classmethod
+    def _make_do_upload_patch(cls, client, method, resource={}, side_effect=None):
+        """Patches the low-level upload helpers."""
+        if side_effect is None:
+            side_effect = [
+                cls._make_response(
+                    http_client.OK,
+                    json.dumps(resource),
+                    {"Content-Type": "application/json"},
+                )
+            ]
+        return mock.patch.object(client, method, side_effect=side_effect, autospec=True)
+
+    EXPECTED_CONFIGURATION = {
+        "jobReference": {"projectId": "project_id", "jobId": "job_id"},
+        "configuration": {
+            "load": {
+                "sourceFormat": SourceFormat.CSV,
+                "destinationTable": {
+                    "projectId": "project_id",
+                    "datasetId": "test_dataset",
+                    "tableId": "test_table",
+                },
+            }
+        },
+    }
+
+    @staticmethod
+    def _make_file_obj():
+        return io.BytesIO(b"hello, is it me you're looking for?")
+
+    def _make_gzip_file_obj(self, writable):
+        if writable:
+            return gzip.GzipFile(mode="w", fileobj=io.BytesIO())
+        else:
+            return gzip.GzipFile(mode="r", fileobj=self._make_file_obj())
+
+    @staticmethod
+    def _make_config():
+        from google.cloud.bigquery.job import LoadJobConfig
+        from google.cloud.bigquery.job import SourceFormat
+
+        config = LoadJobConfig()
+        config.source_format = SourceFormat.CSV
+        return config
+
+    # High-level tests
+
+    def test_load_table_from_file_resumable(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", self.EXPECTED_CONFIGURATION
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                file_obj,
+                self.TABLE_REF,
+                job_id="job_id",
+                job_config=self._make_config(),
+            )
+
+        do_upload.assert_called_once_with(
+            file_obj, self.EXPECTED_CONFIGURATION, _DEFAULT_NUM_RETRIES
+        )
+
+    def test_load_table_from_file_w_explicit_project(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", self.EXPECTED_CONFIGURATION
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                file_obj,
+                self.TABLE_REF,
+                job_id="job_id",
+                project="other-project",
+                location=self.LOCATION,
+                job_config=self._make_config(),
+            )
+
+        expected_resource = copy.deepcopy(self.EXPECTED_CONFIGURATION)
+        expected_resource["jobReference"]["location"] = self.LOCATION
+        expected_resource["jobReference"]["projectId"] = "other-project"
+        do_upload.assert_called_once_with(
+            file_obj, expected_resource, _DEFAULT_NUM_RETRIES
+        )
+
+    def test_load_table_from_file_w_client_location(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+
+        client = self._make_client(location=self.LOCATION)
+        file_obj = self._make_file_obj()
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", self.EXPECTED_CONFIGURATION
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                file_obj,
+                # Test with string for table ID.
+                "{}.{}.{}".format(
+                    self.TABLE_REF.project,
+                    self.TABLE_REF.dataset_id,
+                    self.TABLE_REF.table_id,
+                ),
+                job_id="job_id",
+                project="other-project",
+                job_config=self._make_config(),
+            )
+
+        expected_resource = copy.deepcopy(self.EXPECTED_CONFIGURATION)
+        expected_resource["jobReference"]["location"] = self.LOCATION
+        expected_resource["jobReference"]["projectId"] = "other-project"
+        do_upload.assert_called_once_with(
+            file_obj, expected_resource, _DEFAULT_NUM_RETRIES
+        )
+
+    def test_load_table_from_file_resumable_metadata(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import WriteDisposition
+
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+
+        config = self._make_config()
+        config.allow_jagged_rows = False
+        config.allow_quoted_newlines = False
+        config.create_disposition = CreateDisposition.CREATE_IF_NEEDED
+        config.encoding = "utf8"
+        config.field_delimiter = ","
+        config.ignore_unknown_values = False
+        config.max_bad_records = 0
+        config.quote_character = '"'
+        config.skip_leading_rows = 1
+        config.write_disposition = WriteDisposition.WRITE_APPEND
+        config.null_marker = r"\N"
+
+        expected_config = {
+            "jobReference": {"projectId": "project_id", "jobId": "job_id"},
+            "configuration": {
+                "load": {
+                    "destinationTable": {
+                        "projectId": self.TABLE_REF.project,
+                        "datasetId": self.TABLE_REF.dataset_id,
+                        "tableId": self.TABLE_REF.table_id,
+                    },
+                    "sourceFormat": config.source_format,
+                    "allowJaggedRows": config.allow_jagged_rows,
+                    "allowQuotedNewlines": config.allow_quoted_newlines,
+                    "createDisposition": config.create_disposition,
+                    "encoding": config.encoding,
+                    "fieldDelimiter": config.field_delimiter,
+                    "ignoreUnknownValues": config.ignore_unknown_values,
+                    "maxBadRecords": config.max_bad_records,
+                    "quote": config.quote_character,
+                    "skipLeadingRows": str(config.skip_leading_rows),
+                    "writeDisposition": config.write_disposition,
+                    "nullMarker": config.null_marker,
+                }
+            },
+        }
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", expected_config
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                file_obj, self.TABLE_REF, job_id="job_id", job_config=config
+            )
+
+        do_upload.assert_called_once_with(
+            file_obj, expected_config, _DEFAULT_NUM_RETRIES
+        )
+
+    def test_load_table_from_file_multipart(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+        file_obj_size = 10
+        config = self._make_config()
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_multipart_upload", self.EXPECTED_CONFIGURATION
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                file_obj,
+                self.TABLE_REF,
+                job_id="job_id",
+                job_config=config,
+                size=file_obj_size,
+            )
+
+        do_upload.assert_called_once_with(
+            file_obj, self.EXPECTED_CONFIGURATION, file_obj_size, _DEFAULT_NUM_RETRIES
+        )
+
+    def test_load_table_from_file_with_retries(self):
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+        num_retries = 20
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", self.EXPECTED_CONFIGURATION
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                file_obj,
+                self.TABLE_REF,
+                num_retries=num_retries,
+                job_id="job_id",
+                job_config=self._make_config(),
+            )
+
+        do_upload.assert_called_once_with(
+            file_obj, self.EXPECTED_CONFIGURATION, num_retries
+        )
+
+    def test_load_table_from_file_with_rewind(self):
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+        file_obj.seek(2)
+
+        with self._make_do_upload_patch(
+            client, "_do_resumable_upload", self.EXPECTED_CONFIGURATION
+        ):
+            client.load_table_from_file(file_obj, self.TABLE_REF, rewind=True)
+
+        assert file_obj.tell() == 0
+
+    def test_load_table_from_file_with_readable_gzip(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+
+        client = self._make_client()
+        gzip_file = self._make_gzip_file_obj(writable=False)
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", self.EXPECTED_CONFIGURATION
+        )
+        with do_upload_patch as do_upload:
+            client.load_table_from_file(
+                gzip_file,
+                self.TABLE_REF,
+                job_id="job_id",
+                job_config=self._make_config(),
+            )
+
+        do_upload.assert_called_once_with(
+            gzip_file, self.EXPECTED_CONFIGURATION, _DEFAULT_NUM_RETRIES
+        )
+
+    def test_load_table_from_file_with_writable_gzip(self):
+        client = self._make_client()
+        gzip_file = self._make_gzip_file_obj(writable=True)
+
+        with pytest.raises(ValueError):
+            client.load_table_from_file(
+                gzip_file,
+                self.TABLE_REF,
+                job_id="job_id",
+                job_config=self._make_config(),
+            )
+
+    def test_load_table_from_file_failure(self):
+        from google.resumable_media import InvalidResponse
+        from google.cloud import exceptions
+
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+
+        response = self._make_response(
+            content="Someone is already in this spot.", status_code=http_client.CONFLICT
+        )
+
+        do_upload_patch = self._make_do_upload_patch(
+            client, "_do_resumable_upload", side_effect=InvalidResponse(response)
+        )
+
+        with do_upload_patch, pytest.raises(exceptions.Conflict) as exc_info:
+            client.load_table_from_file(file_obj, self.TABLE_REF, rewind=True)
+
+        assert response.text in exc_info.value.message
+        assert exc_info.value.errors == []
+
+    def test_load_table_from_file_bad_mode(self):
+        client = self._make_client()
+        file_obj = mock.Mock(spec=["mode"])
+        file_obj.mode = "x"
+
+        with pytest.raises(ValueError):
+            client.load_table_from_file(file_obj, self.TABLE_REF)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+
+        client = self._make_client()
+        records = [{"id": 1, "age": 100}, {"id": 2, "age": 60}]
+        dataframe = pandas.DataFrame(records)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        with load_patch as load_table_from_file:
+            client.load_table_from_dataframe(dataframe, self.TABLE_REF)
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=None,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_file = load_table_from_file.mock_calls[0][1][1]
+        assert sent_file.closed
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_client_location(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+
+        client = self._make_client(location=self.LOCATION)
+        records = [{"id": 1, "age": 100}, {"id": 2, "age": 60}]
+        dataframe = pandas.DataFrame(records)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        with load_patch as load_table_from_file:
+            client.load_table_from_dataframe(dataframe, self.TABLE_REF)
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_file = load_table_from_file.mock_calls[0][1][1]
+        assert sent_file.closed
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_custom_job_config(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+
+        client = self._make_client()
+        records = [{"id": 1, "age": 100}, {"id": 2, "age": 60}]
+        dataframe = pandas.DataFrame(records)
+        job_config = job.LoadJobConfig()
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        with load_patch as load_table_from_file:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_automatic_schema(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+        df_data = collections.OrderedDict(
+            [
+                ("int_col", [1, 2, 3]),
+                ("float_col", [1.0, 2.0, 3.0]),
+                ("bool_col", [True, False, True]),
+                (
+                    "dt_col",
+                    pandas.Series(
+                        [
+                            datetime.datetime(2010, 1, 2, 3, 44, 50),
+                            datetime.datetime(2011, 2, 3, 14, 50, 59),
+                            datetime.datetime(2012, 3, 14, 15, 16),
+                        ],
+                        dtype="datetime64[ns]",
+                    ),
+                ),
+                (
+                    "ts_col",
+                    pandas.Series(
+                        [
+                            datetime.datetime(2010, 1, 2, 3, 44, 50),
+                            datetime.datetime(2011, 2, 3, 14, 50, 59),
+                            datetime.datetime(2012, 3, 14, 15, 16),
+                        ],
+                        dtype="datetime64[ns]",
+                    ).dt.tz_localize(pytz.utc),
+                ),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, columns=df_data.keys())
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        with load_patch as load_table_from_file:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, location=self.LOCATION
+            )
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+        assert tuple(sent_config.schema) == (
+            SchemaField("int_col", "INTEGER"),
+            SchemaField("float_col", "FLOAT"),
+            SchemaField("bool_col", "BOOLEAN"),
+            SchemaField("dt_col", "DATETIME"),
+            SchemaField("ts_col", "TIMESTAMP"),
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_struct_fields_error(self):
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+
+        records = [{"float_column": 3.14, "struct_column": [{"foo": 1}, {"bar": -1}]}]
+        dataframe = pandas.DataFrame(data=records)
+
+        schema = [
+            SchemaField("float_column", "FLOAT"),
+            SchemaField(
+                "agg_col",
+                "RECORD",
+                fields=[SchemaField("foo", "INTEGER"), SchemaField("bar", "INTEGER")],
+            ),
+        ]
+        job_config = job.LoadJobConfig(schema=schema)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        with pytest.raises(ValueError) as exc_info, load_patch:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        err_msg = str(exc_info.value)
+        assert "struct" in err_msg
+        assert "not support" in err_msg
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_partial_schema(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+        df_data = collections.OrderedDict(
+            [
+                ("int_col", [1, 2, 3]),
+                ("int_as_float_col", [1.0, float("nan"), 3.0]),
+                ("float_col", [1.0, 2.0, 3.0]),
+                ("bool_col", [True, False, True]),
+                (
+                    "dt_col",
+                    pandas.Series(
+                        [
+                            datetime.datetime(2010, 1, 2, 3, 44, 50),
+                            datetime.datetime(2011, 2, 3, 14, 50, 59),
+                            datetime.datetime(2012, 3, 14, 15, 16),
+                        ],
+                        dtype="datetime64[ns]",
+                    ),
+                ),
+                (
+                    "ts_col",
+                    pandas.Series(
+                        [
+                            datetime.datetime(2010, 1, 2, 3, 44, 50),
+                            datetime.datetime(2011, 2, 3, 14, 50, 59),
+                            datetime.datetime(2012, 3, 14, 15, 16),
+                        ],
+                        dtype="datetime64[ns]",
+                    ).dt.tz_localize(pytz.utc),
+                ),
+                ("string_col", [u"abc", None, u"def"]),
+                ("bytes_col", [b"abc", b"def", None]),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, columns=df_data.keys())
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        schema = (
+            SchemaField("int_as_float_col", "INTEGER"),
+            SchemaField("string_col", "STRING"),
+            SchemaField("bytes_col", "BYTES"),
+        )
+        job_config = job.LoadJobConfig(schema=schema)
+        with load_patch as load_table_from_file:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+        assert tuple(sent_config.schema) == (
+            SchemaField("int_col", "INTEGER"),
+            SchemaField("int_as_float_col", "INTEGER"),
+            SchemaField("float_col", "FLOAT"),
+            SchemaField("bool_col", "BOOLEAN"),
+            SchemaField("dt_col", "DATETIME"),
+            SchemaField("ts_col", "TIMESTAMP"),
+            SchemaField("string_col", "STRING"),
+            SchemaField("bytes_col", "BYTES"),
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_partial_schema_extra_types(self):
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+        df_data = collections.OrderedDict(
+            [
+                ("int_col", [1, 2, 3]),
+                ("int_as_float_col", [1.0, float("nan"), 3.0]),
+                ("string_col", [u"abc", None, u"def"]),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, columns=df_data.keys())
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        schema = (
+            SchemaField("int_as_float_col", "INTEGER"),
+            SchemaField("string_col", "STRING"),
+            SchemaField("unknown_col", "BYTES"),
+        )
+        job_config = job.LoadJobConfig(schema=schema)
+        with load_patch as load_table_from_file, pytest.raises(
+            ValueError
+        ) as exc_context:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        load_table_from_file.assert_not_called()
+        message = str(exc_context.value)
+        assert "bq_schema contains fields not present in dataframe" in message
+        assert "unknown_col" in message
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_partial_schema_missing_types(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+        df_data = collections.OrderedDict(
+            [
+                ("string_col", [u"abc", u"def", u"ghi"]),
+                ("unknown_col", [b"jkl", None, b"mno"]),
+            ]
+        )
+        dataframe = pandas.DataFrame(df_data, columns=df_data.keys())
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        schema = (SchemaField("string_col", "STRING"),)
+        job_config = job.LoadJobConfig(schema=schema)
+        with load_patch as load_table_from_file, warnings.catch_warnings(
+            record=True
+        ) as warned:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        assert warned  # there should be at least one warning
+        unknown_col_warnings = [
+            warning for warning in warned if "unknown_col" in str(warning)
+        ]
+        assert unknown_col_warnings
+        assert unknown_col_warnings[0].category == UserWarning
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+        assert sent_config.schema is None
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_schema_wo_pyarrow(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+        records = [{"name": u"Monty", "age": 100}, {"name": u"Python", "age": 60}]
+        dataframe = pandas.DataFrame(records, columns=["name", "age"])
+        schema = (SchemaField("name", "STRING"), SchemaField("age", "INTEGER"))
+        job_config = job.LoadJobConfig(schema=schema)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        pyarrow_patch = mock.patch("google.cloud.bigquery.client.pyarrow", None)
+
+        with load_patch as load_table_from_file, pyarrow_patch, warnings.catch_warnings(
+            record=True
+        ) as warned:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        assert warned  # there should be at least one warning
+        for warning in warned:
+            assert "pyarrow" in str(warning)
+            assert warning.category in (DeprecationWarning, PendingDeprecationWarning)
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+        assert tuple(sent_config.schema) == schema
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_schema_arrow_custom_compression(self):
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+        records = [{"name": u"Monty", "age": 100}, {"name": u"Python", "age": 60}]
+        dataframe = pandas.DataFrame(records)
+        schema = (SchemaField("name", "STRING"), SchemaField("age", "INTEGER"))
+        job_config = job.LoadJobConfig(schema=schema)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        to_parquet_patch = mock.patch(
+            "google.cloud.bigquery.client._pandas_helpers.dataframe_to_parquet",
+            autospec=True,
+        )
+
+        with load_patch, to_parquet_patch as fake_to_parquet:
+            client.load_table_from_dataframe(
+                dataframe,
+                self.TABLE_REF,
+                job_config=job_config,
+                location=self.LOCATION,
+                parquet_compression="LZ4",
+            )
+
+        call_args = fake_to_parquet.call_args
+        assert call_args is not None
+        assert call_args.kwargs.get("parquet_compression") == "LZ4"
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_wo_pyarrow_custom_compression(self):
+        client = self._make_client()
+        records = [{"id": 1, "age": 100}, {"id": 2, "age": 60}]
+        dataframe = pandas.DataFrame(records)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        pyarrow_patch = mock.patch("google.cloud.bigquery.client.pyarrow", None)
+        to_parquet_patch = mock.patch.object(
+            dataframe, "to_parquet", wraps=dataframe.to_parquet
+        )
+
+        with load_patch, pyarrow_patch, to_parquet_patch as to_parquet_spy:
+            client.load_table_from_dataframe(
+                dataframe,
+                self.TABLE_REF,
+                location=self.LOCATION,
+                parquet_compression="gzip",
+            )
+
+        call_args = to_parquet_spy.call_args
+        assert call_args is not None
+        assert call_args.kwargs.get("compression") == "gzip"
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_load_table_from_dataframe_w_nulls(self):
+        """Test that a DataFrame with null columns can be uploaded if a
+        BigQuery schema is specified.
+
+        See: https://github.com/googleapis/google-cloud-python/issues/7370
+        """
+        from google.cloud.bigquery.schema import SchemaField
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+
+        client = self._make_client()
+        records = [{"name": None, "age": None}, {"name": None, "age": None}]
+        dataframe = pandas.DataFrame(records, columns=["name", "age"])
+        schema = [SchemaField("name", "STRING"), SchemaField("age", "INTEGER")]
+        job_config = job.LoadJobConfig(schema=schema)
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+        with load_patch as load_table_from_file:
+            client.load_table_from_dataframe(
+                dataframe, self.TABLE_REF, job_config=job_config, location=self.LOCATION
+            )
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            rewind=True,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=self.LOCATION,
+            project=None,
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.schema == schema
+        assert sent_config.source_format == job.SourceFormat.PARQUET
+
+    def test_load_table_from_json_basic_use(self):
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery import job
+
+        client = self._make_client()
+
+        json_rows = [
+            {"name": "One", "age": 11, "birthday": "2008-09-10", "adult": False},
+            {"name": "Two", "age": 22, "birthday": "1997-08-09", "adult": True},
+        ]
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        with load_patch as load_table_from_file:
+            client.load_table_from_json(json_rows, self.TABLE_REF)
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location=client.location,
+            project=client.project,
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert sent_config.source_format == job.SourceFormat.NEWLINE_DELIMITED_JSON
+        assert sent_config.schema is None
+        assert sent_config.autodetect
+
+    def test_load_table_from_json_non_default_args(self):
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.client import _DEFAULT_NUM_RETRIES
+        from google.cloud.bigquery.schema import SchemaField
+
+        client = self._make_client()
+
+        json_rows = [
+            {"name": "One", "age": 11, "birthday": "2008-09-10", "adult": False},
+            {"name": "Two", "age": 22, "birthday": "1997-08-09", "adult": True},
+        ]
+
+        schema = [
+            SchemaField("name", "STRING"),
+            SchemaField("age", "INTEGER"),
+            SchemaField("adult", "BOOLEAN"),
+        ]
+        job_config = job.LoadJobConfig(schema=schema)
+        job_config._properties["load"]["unknown_field"] = "foobar"
+
+        load_patch = mock.patch(
+            "google.cloud.bigquery.client.Client.load_table_from_file", autospec=True
+        )
+
+        with load_patch as load_table_from_file:
+            client.load_table_from_json(
+                json_rows,
+                self.TABLE_REF,
+                job_config=job_config,
+                project="project-x",
+                location="EU",
+            )
+
+        load_table_from_file.assert_called_once_with(
+            client,
+            mock.ANY,
+            self.TABLE_REF,
+            num_retries=_DEFAULT_NUM_RETRIES,
+            job_id=mock.ANY,
+            job_id_prefix=None,
+            location="EU",
+            project="project-x",
+            job_config=mock.ANY,
+        )
+
+        sent_config = load_table_from_file.mock_calls[0][2]["job_config"]
+        assert job_config.source_format is None  # the original was not modified
+        assert sent_config.source_format == job.SourceFormat.NEWLINE_DELIMITED_JSON
+        assert sent_config.schema == schema
+        assert not sent_config.autodetect
+        # all properties should have been cloned and sent to the backend
+        assert sent_config._properties.get("load", {}).get("unknown_field") == "foobar"
+
+    # Low-level tests
+
+    @classmethod
+    def _make_resumable_upload_responses(cls, size):
+        """Make a series of responses for a successful resumable upload."""
+        from google import resumable_media
+
+        resumable_url = "http://test.invalid?upload_id=and-then-there-was-1"
+        initial_response = cls._make_response(
+            http_client.OK, "", {"location": resumable_url}
+        )
+        data_response = cls._make_response(
+            resumable_media.PERMANENT_REDIRECT,
+            "",
+            {"range": "bytes=0-{:d}".format(size - 1)},
+        )
+        final_response = cls._make_response(
+            http_client.OK,
+            json.dumps({"size": size}),
+            {"Content-Type": "application/json"},
+        )
+        return [initial_response, data_response, final_response]
+
+    @staticmethod
+    def _make_transport(responses=None):
+        import google.auth.transport.requests
+
+        transport = mock.create_autospec(
+            google.auth.transport.requests.AuthorizedSession, instance=True
+        )
+        transport.request.side_effect = responses
+        return transport
+
+    def test__do_resumable_upload(self):
+        file_obj = self._make_file_obj()
+        file_obj_len = len(file_obj.getvalue())
+        transport = self._make_transport(
+            self._make_resumable_upload_responses(file_obj_len)
+        )
+        client = self._make_client(transport)
+
+        result = client._do_resumable_upload(
+            file_obj, self.EXPECTED_CONFIGURATION, None
+        )
+
+        content = result.content.decode("utf-8")
+        assert json.loads(content) == {"size": file_obj_len}
+
+        # Verify that configuration data was passed in with the initial
+        # request.
+        transport.request.assert_any_call(
+            "POST",
+            mock.ANY,
+            data=json.dumps(self.EXPECTED_CONFIGURATION).encode("utf-8"),
+            headers=mock.ANY,
+            timeout=mock.ANY,
+        )
+
+    def test__do_multipart_upload(self):
+        transport = self._make_transport([self._make_response(http_client.OK)])
+        client = self._make_client(transport)
+        file_obj = self._make_file_obj()
+        file_obj_len = len(file_obj.getvalue())
+
+        client._do_multipart_upload(
+            file_obj, self.EXPECTED_CONFIGURATION, file_obj_len, None
+        )
+
+        # Verify that configuration data was passed in with the initial
+        # request.
+        request_args = transport.request.mock_calls[0][2]
+        request_data = request_args["data"].decode("utf-8")
+        request_headers = request_args["headers"]
+
+        request_content = email.message_from_string(
+            "Content-Type: {}\r\n{}".format(
+                request_headers["content-type"].decode("utf-8"), request_data
+            )
+        )
+
+        # There should be two payloads: the configuration and the binary daya.
+        configuration_data = request_content.get_payload(0).get_payload()
+        binary_data = request_content.get_payload(1).get_payload()
+
+        assert json.loads(configuration_data) == self.EXPECTED_CONFIGURATION
+        assert binary_data.encode("utf-8") == file_obj.getvalue()
+
+    def test__do_multipart_upload_wrong_size(self):
+        client = self._make_client()
+        file_obj = self._make_file_obj()
+        file_obj_len = len(file_obj.getvalue())
+
+        with pytest.raises(ValueError):
+            client._do_multipart_upload(file_obj, {}, file_obj_len + 1, None)
+
+    def test_schema_from_json_with_file_path(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        file_content = """[
+          {
+            "description": "quarter",
+            "mode": "REQUIRED",
+            "name": "qtr",
+            "type": "STRING"
+          },
+          {
+            "description": "sales representative",
+            "mode": "NULLABLE",
+            "name": "rep",
+            "type": "STRING"
+          },
+          {
+            "description": "total sales",
+            "mode": "NULLABLE",
+            "name": "sales",
+            "type": "FLOAT"
+          }
+        ]"""
+
+        expected = [
+            SchemaField("qtr", "STRING", "REQUIRED", "quarter"),
+            SchemaField("rep", "STRING", "NULLABLE", "sales representative"),
+            SchemaField("sales", "FLOAT", "NULLABLE", "total sales"),
+        ]
+
+        client = self._make_client()
+        mock_file_path = "/mocked/file.json"
+
+        if six.PY2:
+            open_patch = mock.patch(
+                "__builtin__.open", mock.mock_open(read_data=file_content)
+            )
+        else:
+            open_patch = mock.patch(
+                "builtins.open", new=mock.mock_open(read_data=file_content)
+            )
+
+        with open_patch as _mock_file:
+            actual = client.schema_from_json(mock_file_path)
+            _mock_file.assert_called_once_with(mock_file_path)
+            # This assert is to make sure __exit__ is called in the context
+            # manager that opens the file in the function
+            _mock_file().__exit__.assert_called_once()
+
+        assert expected == actual
+
+    def test_schema_from_json_with_file_object(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        file_content = """[
+          {
+            "description": "quarter",
+            "mode": "REQUIRED",
+            "name": "qtr",
+            "type": "STRING"
+          },
+          {
+            "description": "sales representative",
+            "mode": "NULLABLE",
+            "name": "rep",
+            "type": "STRING"
+          },
+          {
+            "description": "total sales",
+            "mode": "NULLABLE",
+            "name": "sales",
+            "type": "FLOAT"
+          }
+        ]"""
+
+        expected = [
+            SchemaField("qtr", "STRING", "REQUIRED", "quarter"),
+            SchemaField("rep", "STRING", "NULLABLE", "sales representative"),
+            SchemaField("sales", "FLOAT", "NULLABLE", "total sales"),
+        ]
+
+        client = self._make_client()
+
+        if six.PY2:
+            fake_file = io.BytesIO(file_content)
+        else:
+            fake_file = io.StringIO(file_content)
+
+        actual = client.schema_from_json(fake_file)
+
+        assert expected == actual
+
+    def test_schema_to_json_with_file_path(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        file_content = [
+            {
+                "description": "quarter",
+                "mode": "REQUIRED",
+                "name": "qtr",
+                "type": "STRING",
+            },
+            {
+                "description": "sales representative",
+                "mode": "NULLABLE",
+                "name": "rep",
+                "type": "STRING",
+            },
+            {
+                "description": "total sales",
+                "mode": "NULLABLE",
+                "name": "sales",
+                "type": "FLOAT",
+            },
+        ]
+
+        schema_list = [
+            SchemaField("qtr", "STRING", "REQUIRED", "quarter"),
+            SchemaField("rep", "STRING", "NULLABLE", "sales representative"),
+            SchemaField("sales", "FLOAT", "NULLABLE", "total sales"),
+        ]
+
+        client = self._make_client()
+        mock_file_path = "/mocked/file.json"
+
+        if six.PY2:
+            open_patch = mock.patch("__builtin__.open", mock.mock_open())
+        else:
+            open_patch = mock.patch("builtins.open", mock.mock_open())
+
+        with open_patch as mock_file, mock.patch("json.dump") as mock_dump:
+            client.schema_to_json(schema_list, mock_file_path)
+            mock_file.assert_called_once_with(mock_file_path, mode="w")
+            # This assert is to make sure __exit__ is called in the context
+            # manager that opens the file in the function
+            mock_file().__exit__.assert_called_once()
+            mock_dump.assert_called_with(
+                file_content, mock_file.return_value, indent=2, sort_keys=True
+            )
+
+    def test_schema_to_json_with_file_object(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        file_content = [
+            {
+                "description": "quarter",
+                "mode": "REQUIRED",
+                "name": "qtr",
+                "type": "STRING",
+            },
+            {
+                "description": "sales representative",
+                "mode": "NULLABLE",
+                "name": "rep",
+                "type": "STRING",
+            },
+            {
+                "description": "total sales",
+                "mode": "NULLABLE",
+                "name": "sales",
+                "type": "FLOAT",
+            },
+        ]
+
+        schema_list = [
+            SchemaField("qtr", "STRING", "REQUIRED", "quarter"),
+            SchemaField("rep", "STRING", "NULLABLE", "sales representative"),
+            SchemaField("sales", "FLOAT", "NULLABLE", "total sales"),
+        ]
+
+        if six.PY2:
+            fake_file = io.BytesIO()
+        else:
+            fake_file = io.StringIO()
+
+        client = self._make_client()
+
+        client.schema_to_json(schema_list, fake_file)
+        assert file_content == json.loads(fake_file.getvalue())
diff --git a/bigquery/tests/unit/test_dataset.py b/bigquery/tests/unit/test_dataset.py
new file mode 100644
index 000000000000..26b1729a240c
--- /dev/null
+++ b/bigquery/tests/unit/test_dataset.py
@@ -0,0 +1,671 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+import pytest
+
+
+class TestAccessEntry(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.dataset import AccessEntry
+
+        return AccessEntry
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        entry = self._make_one("OWNER", "userByEmail", "phred@example.com")
+        self.assertEqual(entry.role, "OWNER")
+        self.assertEqual(entry.entity_type, "userByEmail")
+        self.assertEqual(entry.entity_id, "phred@example.com")
+
+    def test_ctor_bad_entity_type(self):
+        with self.assertRaises(ValueError):
+            self._make_one(None, "unknown", None)
+
+    def test_ctor_view_with_role(self):
+        role = "READER"
+        entity_type = "view"
+        with self.assertRaises(ValueError):
+            self._make_one(role, entity_type, None)
+
+    def test_ctor_view_success(self):
+        role = None
+        entity_type = "view"
+        entity_id = object()
+        entry = self._make_one(role, entity_type, entity_id)
+        self.assertEqual(entry.role, role)
+        self.assertEqual(entry.entity_type, entity_type)
+        self.assertEqual(entry.entity_id, entity_id)
+
+    def test_ctor_nonview_without_role(self):
+        role = None
+        entity_type = "userByEmail"
+        with self.assertRaises(ValueError):
+            self._make_one(role, entity_type, None)
+
+    def test___eq___role_mismatch(self):
+        entry = self._make_one("OWNER", "userByEmail", "phred@example.com")
+        other = self._make_one("WRITER", "userByEmail", "phred@example.com")
+        self.assertNotEqual(entry, other)
+
+    def test___eq___entity_type_mismatch(self):
+        entry = self._make_one("OWNER", "userByEmail", "phred@example.com")
+        other = self._make_one("OWNER", "groupByEmail", "phred@example.com")
+        self.assertNotEqual(entry, other)
+
+    def test___eq___entity_id_mismatch(self):
+        entry = self._make_one("OWNER", "userByEmail", "phred@example.com")
+        other = self._make_one("OWNER", "userByEmail", "bharney@example.com")
+        self.assertNotEqual(entry, other)
+
+    def test___eq___hit(self):
+        entry = self._make_one("OWNER", "userByEmail", "phred@example.com")
+        other = self._make_one("OWNER", "userByEmail", "phred@example.com")
+        self.assertEqual(entry, other)
+
+    def test__eq___type_mismatch(self):
+        entry = self._make_one("OWNER", "userByEmail", "silly@example.com")
+        self.assertNotEqual(entry, object())
+        self.assertEqual(entry, mock.ANY)
+
+    def test_to_api_repr(self):
+        entry = self._make_one("OWNER", "userByEmail", "salmon@example.com")
+        resource = entry.to_api_repr()
+        exp_resource = {"role": "OWNER", "userByEmail": "salmon@example.com"}
+        self.assertEqual(resource, exp_resource)
+
+    def test_to_api_repr_view(self):
+        view = {
+            "projectId": "my-project",
+            "datasetId": "my_dataset",
+            "tableId": "my_table",
+        }
+        entry = self._make_one(None, "view", view)
+        resource = entry.to_api_repr()
+        exp_resource = {"view": view}
+        self.assertEqual(resource, exp_resource)
+
+    def test_from_api_repr(self):
+        resource = {"role": "OWNER", "userByEmail": "salmon@example.com"}
+        entry = self._get_target_class().from_api_repr(resource)
+        self.assertEqual(entry.role, "OWNER")
+        self.assertEqual(entry.entity_type, "userByEmail")
+        self.assertEqual(entry.entity_id, "salmon@example.com")
+
+    def test_from_api_repr_w_unknown_entity_type(self):
+        resource = {"role": "READER", "unknown": "UNKNOWN"}
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(resource)
+
+    def test_from_api_repr_entries_w_extra_keys(self):
+        resource = {
+            "role": "READER",
+            "specialGroup": "projectReaders",
+            "userByEmail": "salmon@example.com",
+        }
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(resource)
+
+
+class TestDatasetReference(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        return DatasetReference
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        dataset_ref = self._make_one("some-project-1", "dataset_1")
+        self.assertEqual(dataset_ref.project, "some-project-1")
+        self.assertEqual(dataset_ref.dataset_id, "dataset_1")
+
+    def test_ctor_bad_args(self):
+        with self.assertRaises(ValueError):
+            self._make_one(1, "d")
+        with self.assertRaises(ValueError):
+            self._make_one("p", 2)
+
+    def test_table(self):
+        dataset_ref = self._make_one("some-project-1", "dataset_1")
+        table_ref = dataset_ref.table("table_1")
+        self.assertEqual(table_ref.dataset_id, "dataset_1")
+        self.assertEqual(table_ref.project, "some-project-1")
+        self.assertEqual(table_ref.table_id, "table_1")
+
+    def test_model(self):
+        dataset_ref = self._make_one("some-project-1", "dataset_1")
+        model_ref = dataset_ref.model("model_1")
+        self.assertEqual(model_ref.project, "some-project-1")
+        self.assertEqual(model_ref.dataset_id, "dataset_1")
+        self.assertEqual(model_ref.model_id, "model_1")
+
+    def test_routine(self):
+        dataset_ref = self._make_one("some-project-1", "dataset_1")
+        routine_ref = dataset_ref.routine("routine_1")
+        self.assertEqual(routine_ref.project, "some-project-1")
+        self.assertEqual(routine_ref.dataset_id, "dataset_1")
+        self.assertEqual(routine_ref.routine_id, "routine_1")
+
+    def test_to_api_repr(self):
+        dataset = self._make_one("project_1", "dataset_1")
+
+        resource = dataset.to_api_repr()
+
+        self.assertEqual(resource, {"projectId": "project_1", "datasetId": "dataset_1"})
+
+    def test_from_api_repr(self):
+        cls = self._get_target_class()
+        expected = self._make_one("project_1", "dataset_1")
+
+        got = cls.from_api_repr({"projectId": "project_1", "datasetId": "dataset_1"})
+
+        self.assertEqual(expected, got)
+
+    def test_from_string(self):
+        cls = self._get_target_class()
+        got = cls.from_string("string-project.string_dataset")
+        self.assertEqual(got.project, "string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+
+    def test_from_string_w_prefix(self):
+        cls = self._get_target_class()
+        got = cls.from_string("google.com:string-project.string_dataset")
+        self.assertEqual(got.project, "google.com:string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+
+    def test_from_string_legacy_string(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string-project:string_dataset")
+
+    def test_from_string_w_incorrect_prefix(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("google.com.string-project.dataset_id")
+
+    def test_from_string_w_prefix_and_too_many_parts(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("google.com:string-project.dataset_id.table_id")
+
+    def test_from_string_not_fully_qualified(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string_dataset")
+        with self.assertRaises(ValueError):
+            cls.from_string("a.b.c")
+
+    def test_from_string_with_default_project(self):
+        cls = self._get_target_class()
+        got = cls.from_string("string_dataset", default_project="default-project")
+        self.assertEqual(got.project, "default-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+
+    def test_from_string_ignores_default_project(self):
+        cls = self._get_target_class()
+        got = cls.from_string(
+            "string-project.string_dataset", default_project="default-project"
+        )
+        self.assertEqual(got.project, "string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+
+    def test___eq___wrong_type(self):
+        dataset = self._make_one("project_1", "dataset_1")
+        other = object()
+        self.assertNotEqual(dataset, other)
+        self.assertEqual(dataset, mock.ANY)
+
+    def test___eq___project_mismatch(self):
+        dataset = self._make_one("project_1", "dataset_1")
+        other = self._make_one("project_2", "dataset_1")
+        self.assertNotEqual(dataset, other)
+
+    def test___eq___dataset_mismatch(self):
+        dataset = self._make_one("project_1", "dataset_1")
+        other = self._make_one("project_1", "dataset_2")
+        self.assertNotEqual(dataset, other)
+
+    def test___eq___equality(self):
+        dataset = self._make_one("project_1", "dataset_1")
+        other = self._make_one("project_1", "dataset_1")
+        self.assertEqual(dataset, other)
+
+    def test___hash__set_equality(self):
+        dataset1 = self._make_one("project_1", "dataset_1")
+        dataset2 = self._make_one("project_1", "dataset_2")
+        set_one = {dataset1, dataset2}
+        set_two = {dataset1, dataset2}
+        self.assertEqual(set_one, set_two)
+
+    def test___hash__not_equals(self):
+        dataset1 = self._make_one("project_1", "dataset_1")
+        dataset2 = self._make_one("project_1", "dataset_2")
+        set_one = {dataset1}
+        set_two = {dataset2}
+        self.assertNotEqual(set_one, set_two)
+
+    def test___repr__(self):
+        dataset = self._make_one("project1", "dataset1")
+        expected = "DatasetReference('project1', 'dataset1')"
+        self.assertEqual(repr(dataset), expected)
+
+
+class TestDataset(unittest.TestCase):
+    from google.cloud.bigquery.dataset import DatasetReference
+
+    PROJECT = "project"
+    DS_ID = "dataset-id"
+    DS_REF = DatasetReference(PROJECT, DS_ID)
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.dataset import Dataset
+
+        return Dataset
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _setUpConstants(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        self.WHEN_TS = 1437767599.006
+        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(tzinfo=UTC)
+        self.ETAG = "ETAG"
+        self.DS_FULL_ID = "%s:%s" % (self.PROJECT, self.DS_ID)
+        self.RESOURCE_URL = "http://example.com/path/to/resource"
+
+    def _make_resource(self):
+        self._setUpConstants()
+        USER_EMAIL = "phred@example.com"
+        GROUP_EMAIL = "group-name@lists.example.com"
+        return {
+            "creationTime": self.WHEN_TS * 1000,
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+            "etag": self.ETAG,
+            "id": self.DS_FULL_ID,
+            "lastModifiedTime": self.WHEN_TS * 1000,
+            "location": "US",
+            "selfLink": self.RESOURCE_URL,
+            "defaultTableExpirationMs": 3600,
+            "access": [
+                {"role": "OWNER", "userByEmail": USER_EMAIL},
+                {"role": "OWNER", "groupByEmail": GROUP_EMAIL},
+                {"role": "WRITER", "specialGroup": "projectWriters"},
+                {"role": "READER", "specialGroup": "projectReaders"},
+            ],
+        }
+
+    def _verify_access_entry(self, access_entries, resource):
+        r_entries = []
+        for r_entry in resource["access"]:
+            role = r_entry.pop("role")
+            for entity_type, entity_id in sorted(r_entry.items()):
+                r_entries.append(
+                    {"role": role, "entity_type": entity_type, "entity_id": entity_id}
+                )
+
+        self.assertEqual(len(access_entries), len(r_entries))
+        for a_entry, r_entry in zip(access_entries, r_entries):
+            self.assertEqual(a_entry.role, r_entry["role"])
+            self.assertEqual(a_entry.entity_type, r_entry["entity_type"])
+            self.assertEqual(a_entry.entity_id, r_entry["entity_id"])
+
+    def _verify_readonly_resource_properties(self, dataset, resource):
+
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.reference.project, self.PROJECT)
+        self.assertEqual(dataset.reference.dataset_id, self.DS_ID)
+
+        if "creationTime" in resource:
+            self.assertEqual(dataset.created, self.WHEN)
+        else:
+            self.assertIsNone(dataset.created)
+        if "etag" in resource:
+            self.assertEqual(dataset.etag, self.ETAG)
+        else:
+            self.assertIsNone(dataset.etag)
+        if "lastModifiedTime" in resource:
+            self.assertEqual(dataset.modified, self.WHEN)
+        else:
+            self.assertIsNone(dataset.modified)
+        if "selfLink" in resource:
+            self.assertEqual(dataset.self_link, self.RESOURCE_URL)
+        else:
+            self.assertIsNone(dataset.self_link)
+
+    def _verify_resource_properties(self, dataset, resource):
+
+        self._verify_readonly_resource_properties(dataset, resource)
+
+        if "defaultTableExpirationMs" in resource:
+            self.assertEqual(
+                dataset.default_table_expiration_ms,
+                int(resource.get("defaultTableExpirationMs")),
+            )
+        else:
+            self.assertIsNone(dataset.default_table_expiration_ms)
+        self.assertEqual(dataset.description, resource.get("description"))
+        self.assertEqual(dataset.friendly_name, resource.get("friendlyName"))
+        self.assertEqual(dataset.location, resource.get("location"))
+
+        if "access" in resource:
+            self._verify_access_entry(dataset.access_entries, resource)
+        else:
+            self.assertEqual(dataset.access_entries, [])
+
+    def test_ctor_defaults(self):
+        dataset = self._make_one(self.DS_REF)
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, self.PROJECT)
+        self.assertEqual(
+            dataset.path, "/projects/%s/datasets/%s" % (self.PROJECT, self.DS_ID)
+        )
+        self.assertEqual(dataset.access_entries, [])
+
+        self.assertIsNone(dataset.created)
+        self.assertIsNone(dataset.full_dataset_id)
+        self.assertIsNone(dataset.etag)
+        self.assertIsNone(dataset.modified)
+        self.assertIsNone(dataset.self_link)
+
+        self.assertIsNone(dataset.default_table_expiration_ms)
+        self.assertIsNone(dataset.description)
+        self.assertIsNone(dataset.friendly_name)
+        self.assertIsNone(dataset.location)
+
+    def test_ctor_string(self):
+        dataset = self._make_one("some-project.some_dset")
+        self.assertEqual(dataset.project, "some-project")
+        self.assertEqual(dataset.dataset_id, "some_dset")
+
+    def test_ctor_string_wo_project_id(self):
+        with pytest.raises(ValueError):
+            # Project ID is missing.
+            self._make_one("some_dset")
+
+    def test_ctor_explicit(self):
+        from google.cloud.bigquery.dataset import DatasetReference, AccessEntry
+
+        phred = AccessEntry("OWNER", "userByEmail", "phred@example.com")
+        bharney = AccessEntry("OWNER", "userByEmail", "bharney@example.com")
+        entries = [phred, bharney]
+        OTHER_PROJECT = "foo-bar-123"
+        dataset = self._make_one(DatasetReference(OTHER_PROJECT, self.DS_ID))
+        dataset.access_entries = entries
+        self.assertEqual(dataset.dataset_id, self.DS_ID)
+        self.assertEqual(dataset.project, OTHER_PROJECT)
+        self.assertEqual(
+            dataset.path, "/projects/%s/datasets/%s" % (OTHER_PROJECT, self.DS_ID)
+        )
+        self.assertEqual(dataset.access_entries, entries)
+
+        self.assertIsNone(dataset.created)
+        self.assertIsNone(dataset.full_dataset_id)
+        self.assertIsNone(dataset.etag)
+        self.assertIsNone(dataset.modified)
+        self.assertIsNone(dataset.self_link)
+
+        self.assertIsNone(dataset.default_table_expiration_ms)
+        self.assertIsNone(dataset.description)
+        self.assertIsNone(dataset.friendly_name)
+        self.assertIsNone(dataset.location)
+
+    def test_access_entries_setter_non_list(self):
+        dataset = self._make_one(self.DS_REF)
+        with self.assertRaises(TypeError):
+            dataset.access_entries = object()
+
+    def test_access_entries_setter_invalid_field(self):
+        from google.cloud.bigquery.dataset import AccessEntry
+
+        dataset = self._make_one(self.DS_REF)
+        phred = AccessEntry("OWNER", "userByEmail", "phred@example.com")
+        with self.assertRaises(ValueError):
+            dataset.access_entries = [phred, object()]
+
+    def test_access_entries_setter(self):
+        from google.cloud.bigquery.dataset import AccessEntry
+
+        dataset = self._make_one(self.DS_REF)
+        phred = AccessEntry("OWNER", "userByEmail", "phred@example.com")
+        bharney = AccessEntry("OWNER", "userByEmail", "bharney@example.com")
+        dataset.access_entries = [phred, bharney]
+        self.assertEqual(dataset.access_entries, [phred, bharney])
+
+    def test_default_table_expiration_ms_setter_bad_value(self):
+        dataset = self._make_one(self.DS_REF)
+        with self.assertRaises(ValueError):
+            dataset.default_table_expiration_ms = "bogus"
+
+    def test_default_table_expiration_ms_setter(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset.default_table_expiration_ms = 12345
+        self.assertEqual(dataset.default_table_expiration_ms, 12345)
+
+    def test_description_setter_bad_value(self):
+        dataset = self._make_one(self.DS_REF)
+        with self.assertRaises(ValueError):
+            dataset.description = 12345
+
+    def test_description_setter(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset.description = "DESCRIPTION"
+        self.assertEqual(dataset.description, "DESCRIPTION")
+
+    def test_friendly_name_setter_bad_value(self):
+        dataset = self._make_one(self.DS_REF)
+        with self.assertRaises(ValueError):
+            dataset.friendly_name = 12345
+
+    def test_friendly_name_setter(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset.friendly_name = "FRIENDLY"
+        self.assertEqual(dataset.friendly_name, "FRIENDLY")
+
+    def test_location_setter_bad_value(self):
+        dataset = self._make_one(self.DS_REF)
+        with self.assertRaises(ValueError):
+            dataset.location = 12345
+
+    def test_location_setter(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset.location = "LOCATION"
+        self.assertEqual(dataset.location, "LOCATION")
+
+    def test_labels_update_in_place(self):
+        dataset = self._make_one(self.DS_REF)
+        del dataset._properties["labels"]  # don't start w/ existing dict
+        labels = dataset.labels
+        labels["foo"] = "bar"  # update in place
+        self.assertEqual(dataset.labels, {"foo": "bar"})
+
+    def test_labels_setter(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset.labels = {"color": "green"}
+        self.assertEqual(dataset.labels, {"color": "green"})
+
+    def test_labels_setter_bad_value(self):
+        dataset = self._make_one(self.DS_REF)
+        with self.assertRaises(ValueError):
+            dataset.labels = None
+
+    def test_labels_getter_missing_value(self):
+        dataset = self._make_one(self.DS_REF)
+        self.assertEqual(dataset.labels, {})
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        RESOURCE = {
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "datasetReference": {"projectId": self.PROJECT, "datasetId": self.DS_ID},
+        }
+        klass = self._get_target_class()
+        dataset = klass.from_api_repr(RESOURCE)
+        self._verify_resource_properties(dataset, RESOURCE)
+
+    def test_from_api_repr_w_properties(self):
+        RESOURCE = self._make_resource()
+        klass = self._get_target_class()
+        dataset = klass.from_api_repr(RESOURCE)
+        self._verify_resource_properties(dataset, RESOURCE)
+
+    def test_to_api_repr_w_custom_field(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset._properties["newAlphaProperty"] = "unreleased property"
+        resource = dataset.to_api_repr()
+
+        exp_resource = {
+            "datasetReference": self.DS_REF.to_api_repr(),
+            "labels": {},
+            "newAlphaProperty": "unreleased property",
+        }
+        self.assertEqual(resource, exp_resource)
+
+    def test_from_string(self):
+        cls = self._get_target_class()
+        got = cls.from_string("string-project.string_dataset")
+        self.assertEqual(got.project, "string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+
+    def test_from_string_legacy_string(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string-project:string_dataset")
+
+    def test__build_resource_w_custom_field(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset._properties["newAlphaProperty"] = "unreleased property"
+        resource = dataset._build_resource(["newAlphaProperty"])
+
+        exp_resource = {"newAlphaProperty": "unreleased property"}
+        self.assertEqual(resource, exp_resource)
+
+    def test__build_resource_w_custom_field_not_in__properties(self):
+        dataset = self._make_one(self.DS_REF)
+        dataset.bad = "value"
+        with self.assertRaises(ValueError):
+            dataset._build_resource(["bad"])
+
+    def test_table(self):
+        from google.cloud.bigquery.table import TableReference
+
+        dataset = self._make_one(self.DS_REF)
+        table = dataset.table("table_id")
+        self.assertIsInstance(table, TableReference)
+        self.assertEqual(table.table_id, "table_id")
+        self.assertEqual(table.dataset_id, self.DS_ID)
+        self.assertEqual(table.project, self.PROJECT)
+
+    def test___repr__(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = self._make_one(DatasetReference("project1", "dataset1"))
+        expected = "Dataset(DatasetReference('project1', 'dataset1'))"
+        self.assertEqual(repr(dataset), expected)
+
+
+class TestDatasetListItem(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.dataset import DatasetListItem
+
+        return DatasetListItem
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        project = "test-project"
+        dataset_id = "test_dataset"
+        resource = {
+            "kind": "bigquery#dataset",
+            "id": "{}:{}".format(project, dataset_id),
+            "datasetReference": {"projectId": project, "datasetId": dataset_id},
+            "friendlyName": "Data of the Test",
+            "labels": {"some-stuff": "this-is-a-label"},
+        }
+
+        dataset = self._make_one(resource)
+        self.assertEqual(dataset.project, project)
+        self.assertEqual(dataset.dataset_id, dataset_id)
+        self.assertEqual(dataset.full_dataset_id, "{}:{}".format(project, dataset_id))
+        self.assertEqual(dataset.reference.project, project)
+        self.assertEqual(dataset.reference.dataset_id, dataset_id)
+        self.assertEqual(dataset.friendly_name, "Data of the Test")
+        self.assertEqual(dataset.labels["some-stuff"], "this-is-a-label")
+
+    def test_ctor_missing_properties(self):
+        resource = {
+            "datasetReference": {"projectId": "testproject", "datasetId": "testdataset"}
+        }
+        dataset = self._make_one(resource)
+        self.assertEqual(dataset.project, "testproject")
+        self.assertEqual(dataset.dataset_id, "testdataset")
+        self.assertIsNone(dataset.full_dataset_id)
+        self.assertIsNone(dataset.friendly_name)
+        self.assertEqual(dataset.labels, {})
+
+    def test_ctor_wo_project(self):
+        resource = {"datasetReference": {"datasetId": "testdataset"}}
+        with self.assertRaises(ValueError):
+            self._make_one(resource)
+
+    def test_ctor_wo_dataset(self):
+        resource = {"datasetReference": {"projectId": "testproject"}}
+        with self.assertRaises(ValueError):
+            self._make_one(resource)
+
+    def test_ctor_wo_reference(self):
+        with self.assertRaises(ValueError):
+            self._make_one({})
+
+    def test_labels_update_in_place(self):
+        resource = {
+            "datasetReference": {"projectId": "testproject", "datasetId": "testdataset"}
+        }
+        dataset = self._make_one(resource)
+        labels = dataset.labels
+        labels["foo"] = "bar"  # update in place
+        self.assertEqual(dataset.labels, {"foo": "bar"})
+
+    def test_table(self):
+        from google.cloud.bigquery.table import TableReference
+
+        project = "test-project"
+        dataset_id = "test_dataset"
+        resource = {"datasetReference": {"projectId": project, "datasetId": dataset_id}}
+        dataset = self._make_one(resource)
+        table = dataset.table("table_id")
+        self.assertIsInstance(table, TableReference)
+        self.assertEqual(table.table_id, "table_id")
+        self.assertEqual(table.dataset_id, dataset_id)
+        self.assertEqual(table.project, project)
diff --git a/bigquery/tests/unit/test_dbapi__helpers.py b/bigquery/tests/unit/test_dbapi__helpers.py
new file mode 100644
index 000000000000..bcc3e0879f87
--- /dev/null
+++ b/bigquery/tests/unit/test_dbapi__helpers.py
@@ -0,0 +1,94 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+import datetime
+import decimal
+import math
+import unittest
+
+import google.cloud._helpers
+from google.cloud.bigquery.dbapi import _helpers
+from google.cloud.bigquery.dbapi import exceptions
+
+
+class TestQueryParameters(unittest.TestCase):
+    def test_scalar_to_query_parameter(self):
+        expected_types = [
+            (True, "BOOL"),
+            (False, "BOOL"),
+            (123, "INT64"),
+            (-123456789, "INT64"),
+            (1.25, "FLOAT64"),
+            (decimal.Decimal("1.25"), "NUMERIC"),
+            (b"I am some bytes", "BYTES"),
+            (u"I am a string", "STRING"),
+            (datetime.date(2017, 4, 1), "DATE"),
+            (datetime.time(12, 34, 56), "TIME"),
+            (datetime.datetime(2012, 3, 4, 5, 6, 7), "DATETIME"),
+            (
+                datetime.datetime(
+                    2012, 3, 4, 5, 6, 7, tzinfo=google.cloud._helpers.UTC
+                ),
+                "TIMESTAMP",
+            ),
+        ]
+        for value, expected_type in expected_types:
+            msg = "value: {} expected_type: {}".format(value, expected_type)
+            parameter = _helpers.scalar_to_query_parameter(value)
+            self.assertIsNone(parameter.name, msg=msg)
+            self.assertEqual(parameter.type_, expected_type, msg=msg)
+            self.assertEqual(parameter.value, value, msg=msg)
+            named_parameter = _helpers.scalar_to_query_parameter(value, name="myvar")
+            self.assertEqual(named_parameter.name, "myvar", msg=msg)
+            self.assertEqual(named_parameter.type_, expected_type, msg=msg)
+            self.assertEqual(named_parameter.value, value, msg=msg)
+
+    def test_scalar_to_query_parameter_w_unexpected_type(self):
+        with self.assertRaises(exceptions.ProgrammingError):
+            _helpers.scalar_to_query_parameter(value={"a": "dictionary"})
+
+    def test_scalar_to_query_parameter_w_special_floats(self):
+        nan_parameter = _helpers.scalar_to_query_parameter(float("nan"))
+        self.assertTrue(math.isnan(nan_parameter.value))
+        self.assertEqual(nan_parameter.type_, "FLOAT64")
+        inf_parameter = _helpers.scalar_to_query_parameter(float("inf"))
+        self.assertTrue(math.isinf(inf_parameter.value))
+        self.assertEqual(inf_parameter.type_, "FLOAT64")
+
+    def test_to_query_parameters_w_dict(self):
+        parameters = {"somebool": True, "somestring": u"a-string-value"}
+        query_parameters = _helpers.to_query_parameters(parameters)
+        query_parameter_tuples = []
+        for param in query_parameters:
+            query_parameter_tuples.append((param.name, param.type_, param.value))
+        self.assertSequenceEqual(
+            sorted(query_parameter_tuples),
+            sorted(
+                [
+                    ("somebool", "BOOL", True),
+                    ("somestring", "STRING", u"a-string-value"),
+                ]
+            ),
+        )
+
+    def test_to_query_parameters_w_list(self):
+        parameters = [True, u"a-string-value"]
+        query_parameters = _helpers.to_query_parameters(parameters)
+        query_parameter_tuples = []
+        for param in query_parameters:
+            query_parameter_tuples.append((param.name, param.type_, param.value))
+        self.assertSequenceEqual(
+            sorted(query_parameter_tuples),
+            sorted([(None, "BOOL", True), (None, "STRING", u"a-string-value")]),
+        )
diff --git a/bigquery/tests/unit/test_dbapi_connection.py b/bigquery/tests/unit/test_dbapi_connection.py
new file mode 100644
index 000000000000..19acec05bd34
--- /dev/null
+++ b/bigquery/tests/unit/test_dbapi_connection.py
@@ -0,0 +1,78 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.dbapi import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _mock_client(self, rows=None, schema=None):
+        from google.cloud.bigquery import client
+
+        mock_client = mock.create_autospec(client.Client)
+        return mock_client
+
+    def test_ctor(self):
+        from google.cloud.bigquery.dbapi import Connection
+
+        mock_client = self._mock_client()
+        connection = self._make_one(client=mock_client)
+        self.assertIsInstance(connection, Connection)
+        self.assertIs(connection._client, mock_client)
+
+    @mock.patch("google.cloud.bigquery.Client", autospec=True)
+    def test_connect_wo_client(self, mock_client):
+        from google.cloud.bigquery.dbapi import connect
+        from google.cloud.bigquery.dbapi import Connection
+
+        connection = connect()
+        self.assertIsInstance(connection, Connection)
+        self.assertIsNotNone(connection._client)
+
+    def test_connect_w_client(self):
+        from google.cloud.bigquery.dbapi import connect
+        from google.cloud.bigquery.dbapi import Connection
+
+        mock_client = self._mock_client()
+        connection = connect(client=mock_client)
+        self.assertIsInstance(connection, Connection)
+        self.assertIs(connection._client, mock_client)
+
+    def test_close(self):
+        connection = self._make_one(client=self._mock_client())
+        # close() is a no-op, there is nothing to test.
+        connection.close()
+
+    def test_commit(self):
+        connection = self._make_one(client=self._mock_client())
+        # commit() is a no-op, there is nothing to test.
+        connection.commit()
+
+    def test_cursor(self):
+        from google.cloud.bigquery.dbapi import Cursor
+
+        connection = self._make_one(client=self._mock_client())
+        cursor = connection.cursor()
+        self.assertIsInstance(cursor, Cursor)
+        self.assertIs(cursor.connection, connection)
diff --git a/bigquery/tests/unit/test_dbapi_cursor.py b/bigquery/tests/unit/test_dbapi_cursor.py
new file mode 100644
index 000000000000..4a675c73958d
--- /dev/null
+++ b/bigquery/tests/unit/test_dbapi_cursor.py
@@ -0,0 +1,318 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestCursor(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.dbapi import Cursor
+
+        return Cursor
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _mock_client(self, rows=None, schema=None, num_dml_affected_rows=None):
+        from google.cloud.bigquery import client
+
+        if rows is None:
+            total_rows = 0
+        else:
+            total_rows = len(rows)
+
+        mock_client = mock.create_autospec(client.Client)
+        mock_client.query.return_value = self._mock_job(
+            total_rows=total_rows,
+            schema=schema,
+            num_dml_affected_rows=num_dml_affected_rows,
+        )
+        mock_client.list_rows.return_value = rows
+        return mock_client
+
+    def _mock_job(self, total_rows=0, schema=None, num_dml_affected_rows=None):
+        from google.cloud.bigquery import job
+
+        mock_job = mock.create_autospec(job.QueryJob)
+        mock_job.error_result = None
+        mock_job.state = "DONE"
+        mock_job.result.return_value = mock_job
+        mock_job._query_results = self._mock_results(
+            total_rows=total_rows,
+            schema=schema,
+            num_dml_affected_rows=num_dml_affected_rows,
+        )
+
+        if num_dml_affected_rows is None:
+            mock_job.statement_type = None  # API sends back None for SELECT
+        else:
+            mock_job.statement_type = "UPDATE"
+
+        return mock_job
+
+    def _mock_results(self, total_rows=0, schema=None, num_dml_affected_rows=None):
+        from google.cloud.bigquery import query
+
+        mock_results = mock.create_autospec(query._QueryResults)
+        mock_results.schema = schema
+        mock_results.num_dml_affected_rows = num_dml_affected_rows
+        mock_results.total_rows = total_rows
+        return mock_results
+
+    def test_ctor(self):
+        from google.cloud.bigquery.dbapi import connect
+        from google.cloud.bigquery.dbapi import Cursor
+
+        connection = connect(self._mock_client())
+        cursor = self._make_one(connection)
+        self.assertIsInstance(cursor, Cursor)
+        self.assertIs(cursor.connection, connection)
+
+    def test_close(self):
+        from google.cloud.bigquery.dbapi import connect
+
+        connection = connect(self._mock_client())
+        cursor = connection.cursor()
+        # close() is a no-op, there is nothing to test.
+        cursor.close()
+
+    def test_fetchone_wo_execute_raises_error(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(self._mock_client())
+        cursor = connection.cursor()
+        self.assertRaises(dbapi.Error, cursor.fetchone)
+
+    def test_fetchone_w_row(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(self._mock_client(rows=[(1,)]))
+        cursor = connection.cursor()
+        cursor.execute("SELECT 1;")
+        row = cursor.fetchone()
+        self.assertEqual(row, (1,))
+        self.assertIsNone(cursor.fetchone())
+
+    def test_fetchmany_wo_execute_raises_error(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(self._mock_client())
+        cursor = connection.cursor()
+        self.assertRaises(dbapi.Error, cursor.fetchmany)
+
+    def test_fetchmany_w_row(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(self._mock_client(rows=[(1,)]))
+        cursor = connection.cursor()
+        cursor.execute("SELECT 1;")
+        rows = cursor.fetchmany()
+        self.assertEqual(len(rows), 1)
+        self.assertEqual(rows[0], (1,))
+
+    def test_fetchmany_w_size(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(
+            self._mock_client(rows=[(1, 2, 3), (4, 5, 6), (7, 8, 9)])
+        )
+        cursor = connection.cursor()
+        cursor.execute("SELECT a, b, c;")
+        rows = cursor.fetchmany(size=2)
+        self.assertEqual(len(rows), 2)
+        self.assertEqual(rows[0], (1, 2, 3))
+        self.assertEqual(rows[1], (4, 5, 6))
+        second_page = cursor.fetchmany(size=2)
+        self.assertEqual(len(second_page), 1)
+        self.assertEqual(second_page[0], (7, 8, 9))
+        third_page = cursor.fetchmany(size=2)
+        self.assertEqual(third_page, [])
+
+    def test_fetchmany_w_arraysize(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(
+            self._mock_client(rows=[(1, 2, 3), (4, 5, 6), (7, 8, 9)])
+        )
+        cursor = connection.cursor()
+        cursor.execute("SELECT a, b, c;")
+        cursor.arraysize = 2
+        rows = cursor.fetchmany()
+        self.assertEqual(len(rows), 2)
+        self.assertEqual(rows[0], (1, 2, 3))
+        self.assertEqual(rows[1], (4, 5, 6))
+        second_page = cursor.fetchmany()
+        self.assertEqual(len(second_page), 1)
+        self.assertEqual(second_page[0], (7, 8, 9))
+        third_page = cursor.fetchmany()
+        self.assertEqual(third_page, [])
+
+    def test_fetchall_wo_execute_raises_error(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(self._mock_client())
+        cursor = connection.cursor()
+        self.assertRaises(dbapi.Error, cursor.fetchall)
+
+    def test_fetchall_w_row(self):
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(self._mock_client(rows=[(1,)]))
+        cursor = connection.cursor()
+        cursor.execute("SELECT 1;")
+        self.assertIsNone(cursor.description)
+        self.assertEqual(cursor.rowcount, 1)
+        rows = cursor.fetchall()
+        self.assertEqual(len(rows), 1)
+        self.assertEqual(rows[0], (1,))
+
+    def test_execute_custom_job_id(self):
+        from google.cloud.bigquery.dbapi import connect
+
+        client = self._mock_client(rows=[], num_dml_affected_rows=0)
+        connection = connect(client)
+        cursor = connection.cursor()
+        cursor.execute("SELECT 1;", job_id="foo")
+        args, kwargs = client.query.call_args
+        self.assertEqual(args[0], "SELECT 1;")
+        self.assertEqual(kwargs["job_id"], "foo")
+
+    def test_execute_w_dml(self):
+        from google.cloud.bigquery.dbapi import connect
+
+        connection = connect(self._mock_client(rows=[], num_dml_affected_rows=12))
+        cursor = connection.cursor()
+        cursor.execute("DELETE FROM UserSessions WHERE user_id = 'test';")
+        rows = cursor.fetchall()
+        self.assertIsNone(cursor.description)
+        self.assertEqual(cursor.rowcount, 12)
+        self.assertEqual(rows, [])
+
+    def test_execute_w_query(self):
+        from google.cloud.bigquery.schema import SchemaField
+        from google.cloud.bigquery import dbapi
+
+        connection = dbapi.connect(
+            self._mock_client(
+                rows=[("hello", "world", 1), ("howdy", "y'all", 2)],
+                schema=[
+                    SchemaField("a", "STRING", mode="NULLABLE"),
+                    SchemaField("b", "STRING", mode="REQUIRED"),
+                    SchemaField("c", "INTEGER", mode="NULLABLE"),
+                ],
+            )
+        )
+        cursor = connection.cursor()
+        cursor.execute("SELECT a, b, c FROM hello_world WHERE d > 3;")
+
+        # Verify the description.
+        self.assertEqual(len(cursor.description), 3)
+        a_name, a_type, _, _, _, _, a_null_ok = cursor.description[0]
+        self.assertEqual(a_name, "a")
+        self.assertEqual(a_type, "STRING")
+        self.assertEqual(a_type, dbapi.STRING)
+        self.assertTrue(a_null_ok)
+        b_name, b_type, _, _, _, _, b_null_ok = cursor.description[1]
+        self.assertEqual(b_name, "b")
+        self.assertEqual(b_type, "STRING")
+        self.assertEqual(b_type, dbapi.STRING)
+        self.assertFalse(b_null_ok)
+        c_name, c_type, _, _, _, _, c_null_ok = cursor.description[2]
+        self.assertEqual(c_name, "c")
+        self.assertEqual(c_type, "INTEGER")
+        self.assertEqual(c_type, dbapi.NUMBER)
+        self.assertTrue(c_null_ok)
+
+        # Verify the results.
+        self.assertEqual(cursor.rowcount, 2)
+        row = cursor.fetchone()
+        self.assertEqual(row, ("hello", "world", 1))
+        row = cursor.fetchone()
+        self.assertEqual(row, ("howdy", "y'all", 2))
+        row = cursor.fetchone()
+        self.assertIsNone(row)
+
+    def test_execute_raises_if_result_raises(self):
+        import google.cloud.exceptions
+
+        from google.cloud.bigquery import client
+        from google.cloud.bigquery import job
+        from google.cloud.bigquery.dbapi import connect
+        from google.cloud.bigquery.dbapi import exceptions
+
+        job = mock.create_autospec(job.QueryJob)
+        job.result.side_effect = google.cloud.exceptions.GoogleCloudError("")
+        client = mock.create_autospec(client.Client)
+        client.query.return_value = job
+        connection = connect(client)
+        cursor = connection.cursor()
+
+        with self.assertRaises(exceptions.DatabaseError):
+            cursor.execute("SELECT 1")
+
+    def test_executemany_w_dml(self):
+        from google.cloud.bigquery.dbapi import connect
+
+        connection = connect(self._mock_client(rows=[], num_dml_affected_rows=12))
+        cursor = connection.cursor()
+        cursor.executemany(
+            "DELETE FROM UserSessions WHERE user_id = %s;",
+            (("test",), ("anothertest",)),
+        )
+        self.assertIsNone(cursor.description)
+        self.assertEqual(cursor.rowcount, 12)
+
+    def test__format_operation_w_dict(self):
+        from google.cloud.bigquery.dbapi import cursor
+
+        formatted_operation = cursor._format_operation(
+            "SELECT %(somevalue)s, %(a `weird` one)s;",
+            {"somevalue": "hi", "a `weird` one": "world"},
+        )
+        self.assertEqual(
+            formatted_operation, "SELECT @`somevalue`, @`a \\`weird\\` one`;"
+        )
+
+    def test__format_operation_w_wrong_dict(self):
+        from google.cloud.bigquery import dbapi
+        from google.cloud.bigquery.dbapi import cursor
+
+        self.assertRaises(
+            dbapi.ProgrammingError,
+            cursor._format_operation,
+            "SELECT %(somevalue)s, %(othervalue)s;",
+            {"somevalue-not-here": "hi", "othervalue": "world"},
+        )
+
+    def test__format_operation_w_sequence(self):
+        from google.cloud.bigquery.dbapi import cursor
+
+        formatted_operation = cursor._format_operation(
+            "SELECT %s, %s;", ("hello", "world")
+        )
+        self.assertEqual(formatted_operation, "SELECT ?, ?;")
+
+    def test__format_operation_w_too_short_sequence(self):
+        from google.cloud.bigquery import dbapi
+        from google.cloud.bigquery.dbapi import cursor
+
+        self.assertRaises(
+            dbapi.ProgrammingError,
+            cursor._format_operation,
+            "SELECT %s, %s;",
+            ("hello",),
+        )
diff --git a/bigquery/tests/unit/test_dbapi_types.py b/bigquery/tests/unit/test_dbapi_types.py
new file mode 100644
index 000000000000..e05660ffed14
--- /dev/null
+++ b/bigquery/tests/unit/test_dbapi_types.py
@@ -0,0 +1,42 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+import datetime
+import unittest
+
+import google.cloud._helpers
+from google.cloud.bigquery.dbapi import types
+
+
+class TestTypes(unittest.TestCase):
+    def test_binary_type(self):
+        self.assertEqual("BYTES", types.BINARY)
+        self.assertEqual("RECORD", types.BINARY)
+        self.assertEqual("STRUCT", types.BINARY)
+        self.assertNotEqual("STRING", types.BINARY)
+
+    def test_binary_constructor(self):
+        self.assertEqual(types.Binary(u"hello"), b"hello")
+        self.assertEqual(types.Binary(u"\u1f60"), u"\u1f60".encode("utf-8"))
+
+    def test_timefromticks(self):
+        somedatetime = datetime.datetime(
+            2017, 2, 18, 12, 47, 26, tzinfo=google.cloud._helpers.UTC
+        )
+        epoch = datetime.datetime(1970, 1, 1, tzinfo=google.cloud._helpers.UTC)
+        ticks = (somedatetime - epoch).total_seconds()
+        self.assertEqual(
+            types.TimeFromTicks(ticks, google.cloud._helpers.UTC),
+            datetime.time(12, 47, 26, tzinfo=google.cloud._helpers.UTC),
+        )
diff --git a/bigquery/tests/unit/test_external_config.py b/bigquery/tests/unit/test_external_config.py
new file mode 100644
index 000000000000..ddf95e317969
--- /dev/null
+++ b/bigquery/tests/unit/test_external_config.py
@@ -0,0 +1,368 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import copy
+import unittest
+
+from google.cloud.bigquery import external_config
+from google.cloud.bigquery import schema
+
+
+class TestExternalConfig(unittest.TestCase):
+
+    SOURCE_URIS = ["gs://foo", "gs://bar"]
+
+    BASE_RESOURCE = {
+        "sourceFormat": "",
+        "sourceUris": SOURCE_URIS,
+        "maxBadRecords": 17,
+        "autodetect": True,
+        "ignoreUnknownValues": False,
+        "compression": "compression",
+    }
+
+    def test_from_api_repr_base(self):
+        resource = copy.deepcopy(self.BASE_RESOURCE)
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+        self._verify_base(ec)
+        self.assertEqual(ec.schema, [])
+        self.assertIsNone(ec.options)
+
+        got_resource = ec.to_api_repr()
+        self.assertEqual(got_resource, self.BASE_RESOURCE)
+
+        resource = _copy_and_update(
+            self.BASE_RESOURCE,
+            {
+                "schema": {
+                    "fields": [
+                        {
+                            "name": "full_name",
+                            "type": "STRING",
+                            "mode": "REQUIRED",
+                            "description": None,
+                        }
+                    ]
+                }
+            },
+        )
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+        self._verify_base(ec)
+        exp_schema = [schema.SchemaField("full_name", "STRING", mode="REQUIRED")]
+        self.assertEqual(ec.schema, exp_schema)
+        self.assertIsNone(ec.options)
+
+        got_resource = ec.to_api_repr()
+        self.assertEqual(got_resource, resource)
+
+    def test_to_api_repr_base(self):
+        ec = external_config.ExternalConfig("")
+        ec.source_uris = self.SOURCE_URIS
+        ec.max_bad_records = 17
+        ec.autodetect = True
+        ec.ignore_unknown_values = False
+        ec.compression = "compression"
+        ec.schema = [schema.SchemaField("full_name", "STRING", mode="REQUIRED")]
+
+        exp_schema = {
+            "fields": [
+                {
+                    "name": "full_name",
+                    "type": "STRING",
+                    "mode": "REQUIRED",
+                    "description": None,
+                }
+            ]
+        }
+        got_resource = ec.to_api_repr()
+        exp_resource = {
+            "sourceFormat": "",
+            "sourceUris": self.SOURCE_URIS,
+            "maxBadRecords": 17,
+            "autodetect": True,
+            "ignoreUnknownValues": False,
+            "compression": "compression",
+            "schema": exp_schema,
+        }
+        self.assertEqual(got_resource, exp_resource)
+
+    def test_schema_None(self):
+        ec = external_config.ExternalConfig("")
+        ec.schema = None
+        got = ec.to_api_repr()
+        want = {"sourceFormat": "", "schema": None}
+        self.assertEqual(got, want)
+
+    def test_schema_empty(self):
+        ec = external_config.ExternalConfig("")
+        ec.schema = []
+        got = ec.to_api_repr()
+        want = {"sourceFormat": "", "schema": {"fields": []}}
+        self.assertEqual(got, want)
+
+    def _verify_base(self, ec):
+        self.assertEqual(ec.autodetect, True)
+        self.assertEqual(ec.compression, "compression")
+        self.assertEqual(ec.ignore_unknown_values, False)
+        self.assertEqual(ec.max_bad_records, 17)
+        self.assertEqual(ec.source_uris, self.SOURCE_URIS)
+
+    def test_to_api_repr_source_format(self):
+        ec = external_config.ExternalConfig("CSV")
+        got = ec.to_api_repr()
+        want = {"sourceFormat": "CSV"}
+        self.assertEqual(got, want)
+
+    def test_from_api_repr_sheets(self):
+        resource = _copy_and_update(
+            self.BASE_RESOURCE,
+            {
+                "sourceFormat": "GOOGLE_SHEETS",
+                "googleSheetsOptions": {"skipLeadingRows": "123"},
+            },
+        )
+
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+
+        self._verify_base(ec)
+        self.assertEqual(ec.source_format, "GOOGLE_SHEETS")
+        self.assertIsInstance(ec.options, external_config.GoogleSheetsOptions)
+        self.assertEqual(ec.options.skip_leading_rows, 123)
+
+        got_resource = ec.to_api_repr()
+
+        self.assertEqual(got_resource, resource)
+
+        del resource["googleSheetsOptions"]["skipLeadingRows"]
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+        self.assertIsNone(ec.options.skip_leading_rows)
+        got_resource = ec.to_api_repr()
+        self.assertEqual(got_resource, resource)
+
+    def test_to_api_repr_sheets(self):
+        ec = external_config.ExternalConfig("GOOGLE_SHEETS")
+        options = external_config.GoogleSheetsOptions()
+        options.skip_leading_rows = 123
+        ec._options = options
+
+        exp_resource = {
+            "sourceFormat": "GOOGLE_SHEETS",
+            "googleSheetsOptions": {"skipLeadingRows": "123"},
+        }
+
+        got_resource = ec.to_api_repr()
+
+        self.assertEqual(got_resource, exp_resource)
+
+    def test_from_api_repr_csv(self):
+        resource = _copy_and_update(
+            self.BASE_RESOURCE,
+            {
+                "sourceFormat": "CSV",
+                "csvOptions": {
+                    "fieldDelimiter": "fieldDelimiter",
+                    "skipLeadingRows": "123",
+                    "quote": "quote",
+                    "allowQuotedNewlines": True,
+                    "allowJaggedRows": False,
+                    "encoding": "encoding",
+                },
+            },
+        )
+
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+
+        self._verify_base(ec)
+        self.assertEqual(ec.source_format, "CSV")
+        self.assertIsInstance(ec.options, external_config.CSVOptions)
+        self.assertEqual(ec.options.field_delimiter, "fieldDelimiter")
+        self.assertEqual(ec.options.skip_leading_rows, 123)
+        self.assertEqual(ec.options.quote_character, "quote")
+        self.assertEqual(ec.options.allow_quoted_newlines, True)
+        self.assertEqual(ec.options.allow_jagged_rows, False)
+        self.assertEqual(ec.options.encoding, "encoding")
+
+        got_resource = ec.to_api_repr()
+
+        self.assertEqual(got_resource, resource)
+
+        del resource["csvOptions"]["skipLeadingRows"]
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+        self.assertIsNone(ec.options.skip_leading_rows)
+        got_resource = ec.to_api_repr()
+        self.assertEqual(got_resource, resource)
+
+    def test_to_api_repr_csv(self):
+        ec = external_config.ExternalConfig("CSV")
+        options = external_config.CSVOptions()
+        options.allow_quoted_newlines = True
+        options.encoding = "encoding"
+        options.field_delimiter = "fieldDelimiter"
+        options.quote_character = "quote"
+        options.skip_leading_rows = 123
+        options.allow_jagged_rows = False
+        ec._options = options
+
+        exp_resource = {
+            "sourceFormat": "CSV",
+            "csvOptions": {
+                "fieldDelimiter": "fieldDelimiter",
+                "skipLeadingRows": "123",
+                "quote": "quote",
+                "allowQuotedNewlines": True,
+                "allowJaggedRows": False,
+                "encoding": "encoding",
+            },
+        }
+
+        got_resource = ec.to_api_repr()
+
+        self.assertEqual(got_resource, exp_resource)
+
+    def test_from_api_repr_bigtable(self):
+        qualifier_encoded = base64.standard_b64encode(b"q").decode("ascii")
+        resource = _copy_and_update(
+            self.BASE_RESOURCE,
+            {
+                "sourceFormat": "BIGTABLE",
+                "bigtableOptions": {
+                    "ignoreUnspecifiedColumnFamilies": True,
+                    "readRowkeyAsString": False,
+                    "columnFamilies": [
+                        {
+                            "familyId": "familyId",
+                            "type": "type",
+                            "encoding": "encoding",
+                            "columns": [
+                                {
+                                    "qualifierString": "q",
+                                    "fieldName": "fieldName1",
+                                    "type": "type1",
+                                    "encoding": "encoding1",
+                                    "onlyReadLatest": True,
+                                },
+                                {
+                                    "qualifierEncoded": qualifier_encoded,
+                                    "fieldName": "fieldName2",
+                                    "type": "type2",
+                                    "encoding": "encoding2",
+                                },
+                            ],
+                            "onlyReadLatest": False,
+                        }
+                    ],
+                },
+            },
+        )
+
+        ec = external_config.ExternalConfig.from_api_repr(resource)
+
+        self._verify_base(ec)
+        self.assertEqual(ec.source_format, "BIGTABLE")
+        self.assertIsInstance(ec.options, external_config.BigtableOptions)
+        self.assertEqual(ec.options.ignore_unspecified_column_families, True)
+        self.assertEqual(ec.options.read_rowkey_as_string, False)
+        self.assertEqual(len(ec.options.column_families), 1)
+        fam1 = ec.options.column_families[0]
+        self.assertIsInstance(fam1, external_config.BigtableColumnFamily)
+        self.assertEqual(fam1.family_id, "familyId")
+        self.assertEqual(fam1.type_, "type")
+        self.assertEqual(fam1.encoding, "encoding")
+        self.assertEqual(len(fam1.columns), 2)
+        self.assertFalse(fam1.only_read_latest)
+        col1 = fam1.columns[0]
+        self.assertEqual(col1.qualifier_string, "q")
+        self.assertEqual(col1.field_name, "fieldName1")
+        self.assertEqual(col1.type_, "type1")
+        self.assertEqual(col1.encoding, "encoding1")
+        self.assertTrue(col1.only_read_latest)
+        self.assertIsNone(col1.qualifier_encoded)
+        col2 = ec.options.column_families[0].columns[1]
+        self.assertEqual(col2.qualifier_encoded, b"q")
+        self.assertEqual(col2.field_name, "fieldName2")
+        self.assertEqual(col2.type_, "type2")
+        self.assertEqual(col2.encoding, "encoding2")
+
+        got_resource = ec.to_api_repr()
+
+        self.assertEqual(got_resource, resource)
+
+    def test_to_api_repr_bigtable(self):
+        ec = external_config.ExternalConfig("BIGTABLE")
+        options = external_config.BigtableOptions()
+        options.ignore_unspecified_column_families = True
+        options.read_rowkey_as_string = False
+        ec._options = options
+
+        fam1 = external_config.BigtableColumnFamily()
+        fam1.family_id = "familyId"
+        fam1.type_ = "type"
+        fam1.encoding = "encoding"
+        fam1.only_read_latest = False
+        col1 = external_config.BigtableColumn()
+        col1.qualifier_string = "q"
+        col1.field_name = "fieldName1"
+        col1.type_ = "type1"
+        col1.encoding = "encoding1"
+        col1.only_read_latest = True
+        col2 = external_config.BigtableColumn()
+        col2.qualifier_encoded = b"q"
+        col2.field_name = "fieldName2"
+        col2.type_ = "type2"
+        col2.encoding = "encoding2"
+        fam1.columns = [col1, col2]
+        options.column_families = [fam1]
+
+        qualifier_encoded = base64.standard_b64encode(b"q").decode("ascii")
+        exp_resource = {
+            "sourceFormat": "BIGTABLE",
+            "bigtableOptions": {
+                "ignoreUnspecifiedColumnFamilies": True,
+                "readRowkeyAsString": False,
+                "columnFamilies": [
+                    {
+                        "familyId": "familyId",
+                        "type": "type",
+                        "encoding": "encoding",
+                        "columns": [
+                            {
+                                "qualifierString": "q",
+                                "fieldName": "fieldName1",
+                                "type": "type1",
+                                "encoding": "encoding1",
+                                "onlyReadLatest": True,
+                            },
+                            {
+                                "qualifierEncoded": qualifier_encoded,
+                                "fieldName": "fieldName2",
+                                "type": "type2",
+                                "encoding": "encoding2",
+                            },
+                        ],
+                        "onlyReadLatest": False,
+                    }
+                ],
+            },
+        }
+
+        got_resource = ec.to_api_repr()
+
+        self.assertEqual(got_resource, exp_resource)
+
+
+def _copy_and_update(d, u):
+    d = copy.deepcopy(d)
+    d.update(u)
+    return d
diff --git a/bigquery/tests/unit/test_job.py b/bigquery/tests/unit/test_job.py
new file mode 100644
index 000000000000..19409d8d43c3
--- /dev/null
+++ b/bigquery/tests/unit/test_job.py
@@ -0,0 +1,5411 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import copy
+import json
+import textwrap
+import unittest
+
+import mock
+import pytest
+from six.moves import http_client
+
+try:
+    import pandas
+except (ImportError, AttributeError):  # pragma: NO COVER
+    pandas = None
+
+try:
+    import pyarrow
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+try:
+    from google.cloud import bigquery_storage_v1beta1
+except (ImportError, AttributeError):  # pragma: NO COVER
+    bigquery_storage_v1beta1 = None
+try:
+    from tqdm import tqdm
+except (ImportError, AttributeError):  # pragma: NO COVER
+    tqdm = None
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="test-project", connection=None):
+    from google.cloud.bigquery.client import Client
+
+    if connection is None:
+        connection = _make_connection()
+
+    client = Client(project=project, credentials=_make_credentials(), _http=object())
+    client._connection = connection
+    return client
+
+
+def _make_connection(*responses):
+    import google.cloud.bigquery._http
+    from google.cloud.exceptions import NotFound
+
+    mock_conn = mock.create_autospec(google.cloud.bigquery._http.Connection)
+    mock_conn.api_request.side_effect = list(responses) + [NotFound("miss")]
+    return mock_conn
+
+
+def _make_job_resource(
+    creation_time_ms=1437767599006,
+    started_time_ms=1437767600007,
+    ended_time_ms=1437767601008,
+    started=False,
+    ended=False,
+    etag="abc-def-hjk",
+    endpoint="https://www.googleapis.com",
+    job_type="load",
+    job_id="a-random-id",
+    project_id="some-project",
+    user_email="bq-user@example.com",
+):
+    resource = {
+        "configuration": {job_type: {}},
+        "statistics": {"creationTime": creation_time_ms, job_type: {}},
+        "etag": etag,
+        "id": "{}:{}".format(project_id, job_id),
+        "jobReference": {"projectId": project_id, "jobId": job_id},
+        "selfLink": "{}/bigquery/v2/projects/{}/jobs/{}".format(
+            endpoint, project_id, job_id
+        ),
+        "user_email": user_email,
+    }
+
+    if started or ended:
+        resource["statistics"]["startTime"] = started_time_ms
+
+    if ended:
+        resource["statistics"]["endTime"] = ended_time_ms
+
+    if job_type == "query":
+        resource["configuration"]["query"]["destinationTable"] = {
+            "projectId": project_id,
+            "datasetId": "_temp_dataset",
+            "tableId": "_temp_table",
+        }
+
+    return resource
+
+
+class Test__error_result_to_exception(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud.bigquery import job
+
+        return job._error_result_to_exception(*args, **kwargs)
+
+    def test_simple(self):
+        error_result = {"reason": "invalid", "message": "bad request"}
+        exception = self._call_fut(error_result)
+        self.assertEqual(exception.code, http_client.BAD_REQUEST)
+        self.assertTrue(exception.message.startswith("bad request"))
+        self.assertIn(error_result, exception.errors)
+
+    def test_missing_reason(self):
+        error_result = {}
+        exception = self._call_fut(error_result)
+        self.assertEqual(exception.code, http_client.INTERNAL_SERVER_ERROR)
+
+
+class Test_JobReference(unittest.TestCase):
+    JOB_ID = "job-id"
+    PROJECT = "test-project-123"
+    LOCATION = "us-central"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery import job
+
+        return job._JobReference
+
+    def _make_one(self, job_id, project, location):
+        return self._get_target_class()(job_id, project, location)
+
+    def test_ctor(self):
+        job_ref = self._make_one(self.JOB_ID, self.PROJECT, self.LOCATION)
+
+        self.assertEqual(job_ref.job_id, self.JOB_ID)
+        self.assertEqual(job_ref.project, self.PROJECT)
+        self.assertEqual(job_ref.location, self.LOCATION)
+
+    def test__to_api_repr(self):
+        job_ref = self._make_one(self.JOB_ID, self.PROJECT, self.LOCATION)
+
+        self.assertEqual(
+            job_ref._to_api_repr(),
+            {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": self.LOCATION,
+            },
+        )
+
+    def test_from_api_repr(self):
+        api_repr = {
+            "jobId": self.JOB_ID,
+            "projectId": self.PROJECT,
+            "location": self.LOCATION,
+        }
+
+        job_ref = self._get_target_class()._from_api_repr(api_repr)
+
+        self.assertEqual(job_ref.job_id, self.JOB_ID)
+        self.assertEqual(job_ref.project, self.PROJECT)
+        self.assertEqual(job_ref.location, self.LOCATION)
+
+
+class Test_AsyncJob(unittest.TestCase):
+    JOB_ID = "job-id"
+    PROJECT = "test-project-123"
+    LOCATION = "us-central"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery import job
+
+        return job._AsyncJob
+
+    def _make_one(self, job_id, client):
+        return self._get_target_class()(job_id, client)
+
+    def _make_derived_class(self):
+        class Derived(self._get_target_class()):
+            _JOB_TYPE = "derived"
+
+        return Derived
+
+    def _make_derived(self, job_id, client):
+        return self._make_derived_class()(job_id, client)
+
+    @staticmethod
+    def _job_reference(job_id, project, location):
+        from google.cloud.bigquery import job
+
+        return job._JobReference(job_id, project, location)
+
+    def test_ctor_w_bare_job_id(self):
+        import threading
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+
+        self.assertEqual(job.job_id, self.JOB_ID)
+        self.assertEqual(job.project, self.PROJECT)
+        self.assertIsNone(job.location)
+        self.assertIs(job._client, client)
+        self.assertEqual(
+            job._properties,
+            {"jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID}},
+        )
+        self.assertIsInstance(job._completion_lock, type(threading.Lock()))
+        self.assertEqual(
+            job.path, "/projects/{}/jobs/{}".format(self.PROJECT, self.JOB_ID)
+        )
+
+    def test_ctor_w_job_ref(self):
+        import threading
+
+        other_project = "other-project-234"
+        client = _make_client(project=other_project)
+        job_ref = self._job_reference(self.JOB_ID, self.PROJECT, self.LOCATION)
+        job = self._make_one(job_ref, client)
+
+        self.assertEqual(job.job_id, self.JOB_ID)
+        self.assertEqual(job.project, self.PROJECT)
+        self.assertEqual(job.location, self.LOCATION)
+        self.assertIs(job._client, client)
+        self.assertEqual(
+            job._properties,
+            {
+                "jobReference": {
+                    "projectId": self.PROJECT,
+                    "location": self.LOCATION,
+                    "jobId": self.JOB_ID,
+                }
+            },
+        )
+        self.assertFalse(job._result_set)
+        self.assertIsInstance(job._completion_lock, type(threading.Lock()))
+        self.assertEqual(
+            job.path, "/projects/{}/jobs/{}".format(self.PROJECT, self.JOB_ID)
+        )
+
+    def test__require_client_w_none(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+
+        self.assertIs(job._require_client(None), client)
+
+    def test__require_client_w_other(self):
+        client = _make_client(project=self.PROJECT)
+        other = object()
+        job = self._make_one(self.JOB_ID, client)
+
+        self.assertIs(job._require_client(other), other)
+
+    def test_job_type(self):
+        client = _make_client(project=self.PROJECT)
+        derived = self._make_derived(self.JOB_ID, client)
+
+        self.assertEqual(derived.job_type, "derived")
+
+    def test_labels_miss(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertEqual(job.labels, {})
+
+    def test_labels_update_in_place(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        labels = job.labels
+        labels["foo"] = "bar"  # update in place
+        self.assertEqual(job.labels, {"foo": "bar"})
+
+    def test_labels_hit(self):
+        labels = {"foo": "bar"}
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["labels"] = labels
+        self.assertEqual(job.labels, labels)
+
+    def test_etag(self):
+        etag = "ETAG-123"
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.etag)
+        job._properties["etag"] = etag
+        self.assertEqual(job.etag, etag)
+
+    def test_self_link(self):
+        self_link = "https://api.example.com/123"
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.self_link)
+        job._properties["selfLink"] = self_link
+        self.assertEqual(job.self_link, self_link)
+
+    def test_user_email(self):
+        user_email = "user@example.com"
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.user_email)
+        job._properties["user_email"] = user_email
+        self.assertEqual(job.user_email, user_email)
+
+    @staticmethod
+    def _datetime_and_millis():
+        import datetime
+        import pytz
+        from google.cloud._helpers import _millis
+
+        now = datetime.datetime.utcnow().replace(
+            microsecond=123000, tzinfo=pytz.UTC  # stats timestamps have ms precision
+        )
+        return now, _millis(now)
+
+    def test_created(self):
+        now, millis = self._datetime_and_millis()
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.created)
+        stats = job._properties["statistics"] = {}
+        self.assertIsNone(job.created)
+        stats["creationTime"] = millis
+        self.assertEqual(job.created, now)
+
+    def test_started(self):
+        now, millis = self._datetime_and_millis()
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.started)
+        stats = job._properties["statistics"] = {}
+        self.assertIsNone(job.started)
+        stats["startTime"] = millis
+        self.assertEqual(job.started, now)
+
+    def test_ended(self):
+        now, millis = self._datetime_and_millis()
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.ended)
+        stats = job._properties["statistics"] = {}
+        self.assertIsNone(job.ended)
+        stats["endTime"] = millis
+        self.assertEqual(job.ended, now)
+
+    def test__job_statistics(self):
+        statistics = {"foo": "bar"}
+        client = _make_client(project=self.PROJECT)
+        derived = self._make_derived(self.JOB_ID, client)
+        self.assertEqual(derived._job_statistics(), {})
+        stats = derived._properties["statistics"] = {}
+        self.assertEqual(derived._job_statistics(), {})
+        stats["derived"] = statistics
+        self.assertEqual(derived._job_statistics(), statistics)
+
+    def test_error_result(self):
+        error_result = {
+            "debugInfo": "DEBUG INFO",
+            "location": "LOCATION",
+            "message": "MESSAGE",
+            "reason": "REASON",
+        }
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.error_result)
+        status = job._properties["status"] = {}
+        self.assertIsNone(job.error_result)
+        status["errorResult"] = error_result
+        self.assertEqual(job.error_result, error_result)
+
+    def test_errors(self):
+        errors = [
+            {
+                "debugInfo": "DEBUG INFO",
+                "location": "LOCATION",
+                "message": "MESSAGE",
+                "reason": "REASON",
+            }
+        ]
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.errors)
+        status = job._properties["status"] = {}
+        self.assertIsNone(job.errors)
+        status["errors"] = errors
+        self.assertEqual(job.errors, errors)
+
+    def test_state(self):
+        state = "STATE"
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        self.assertIsNone(job.state)
+        status = job._properties["status"] = {}
+        self.assertIsNone(job.state)
+        status["state"] = state
+        self.assertEqual(job.state, state)
+
+    def test__scrub_local_properties(self):
+        before = {"foo": "bar"}
+        resource = before.copy()
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._scrub_local_properties(resource)  # no raise
+        self.assertEqual(resource, before)
+
+    def test__copy_configuration_properties(self):
+        before = {"foo": "bar"}
+        resource = before.copy()
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        with self.assertRaises(NotImplementedError):
+            job._copy_configuration_properties(resource)
+        self.assertEqual(resource, before)
+
+    def _set_properties_job(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._scrub_local_properties = mock.Mock()
+        job._copy_configuration_properties = mock.Mock()
+        job._set_future_result = mock.Mock()
+        job._properties = {
+            "jobReference": job._properties["jobReference"],
+            "foo": "bar",
+        }
+        return job
+
+    def test__set_properties_no_stats(self):
+        config = {"test": True}
+        resource = {"configuration": config}
+        job = self._set_properties_job()
+
+        job._set_properties(resource)
+
+        self.assertEqual(job._properties, resource)
+
+        job._scrub_local_properties.assert_called_once_with(resource)
+        job._copy_configuration_properties.assert_called_once_with(config)
+
+    def test__set_properties_w_creation_time(self):
+        now, millis = self._datetime_and_millis()
+        config = {"test": True}
+        stats = {"creationTime": str(millis)}
+        resource = {"configuration": config, "statistics": stats}
+        job = self._set_properties_job()
+
+        job._set_properties(resource)
+
+        cleaned = copy.deepcopy(resource)
+        cleaned["statistics"]["creationTime"] = float(millis)
+        self.assertEqual(job._properties, cleaned)
+
+        job._scrub_local_properties.assert_called_once_with(resource)
+        job._copy_configuration_properties.assert_called_once_with(config)
+
+    def test__set_properties_w_start_time(self):
+        now, millis = self._datetime_and_millis()
+        config = {"test": True}
+        stats = {"startTime": str(millis)}
+        resource = {"configuration": config, "statistics": stats}
+        job = self._set_properties_job()
+
+        job._set_properties(resource)
+
+        cleaned = copy.deepcopy(resource)
+        cleaned["statistics"]["startTime"] = float(millis)
+        self.assertEqual(job._properties, cleaned)
+
+        job._scrub_local_properties.assert_called_once_with(resource)
+        job._copy_configuration_properties.assert_called_once_with(config)
+
+    def test__set_properties_w_end_time(self):
+        now, millis = self._datetime_and_millis()
+        config = {"test": True}
+        stats = {"endTime": str(millis)}
+        resource = {"configuration": config, "statistics": stats}
+        job = self._set_properties_job()
+
+        job._set_properties(resource)
+
+        cleaned = copy.deepcopy(resource)
+        cleaned["statistics"]["endTime"] = float(millis)
+        self.assertEqual(job._properties, cleaned)
+
+        job._scrub_local_properties.assert_called_once_with(resource)
+        job._copy_configuration_properties.assert_called_once_with(config)
+
+    def test__get_resource_config_missing_job_ref(self):
+        resource = {}
+        klass = self._make_derived_class()
+
+        with self.assertRaises(KeyError):
+            klass._get_resource_config(resource)
+
+    def test__get_resource_config_missing_job_id(self):
+        resource = {"jobReference": {}}
+        klass = self._make_derived_class()
+
+        with self.assertRaises(KeyError):
+            klass._get_resource_config(resource)
+
+    def test__get_resource_config_missing_configuration(self):
+        resource = {"jobReference": {"jobId": self.JOB_ID}}
+        klass = self._make_derived_class()
+
+        with self.assertRaises(KeyError):
+            klass._get_resource_config(resource)
+
+    def test__get_resource_config_missing_config_type(self):
+        resource = {"jobReference": {"jobId": self.JOB_ID}, "configuration": {}}
+        klass = self._make_derived_class()
+
+        with self.assertRaises(KeyError):
+            klass._get_resource_config(resource)
+
+    def test__get_resource_config_ok(self):
+        derived_config = {"foo": "bar"}
+        resource = {
+            "jobReference": {"jobId": self.JOB_ID},
+            "configuration": {"derived": derived_config},
+        }
+        klass = self._make_derived_class()
+
+        job_id, config = klass._get_resource_config(resource)
+
+        self.assertEqual(job_id, self.JOB_ID)
+        self.assertEqual(config, {"derived": derived_config})
+
+    def test__build_resource(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        with self.assertRaises(NotImplementedError):
+            job._build_resource()
+
+    def test_to_api_repr(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        with self.assertRaises(NotImplementedError):
+            job.to_api_repr()
+
+    def test__begin_already(self):
+        job = self._set_properties_job()
+        job._properties["status"] = {"state": "WHATEVER"}
+
+        with self.assertRaises(ValueError):
+            job._begin()
+
+    def test__begin_defaults(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        job = self._set_properties_job()
+        builder = job.to_api_repr = mock.Mock()
+        builder.return_value = resource
+        call_api = job._client._call_api = mock.Mock()
+        call_api.return_value = resource
+
+        job._begin()
+
+        call_api.assert_called_once_with(
+            DEFAULT_RETRY,
+            method="POST",
+            path="/projects/{}/jobs".format(self.PROJECT),
+            data=resource,
+        )
+        self.assertEqual(job._properties, resource)
+
+    def test__begin_explicit(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        other_project = "other-project-234"
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        job = self._set_properties_job()
+        builder = job.to_api_repr = mock.Mock()
+        builder.return_value = resource
+        client = _make_client(project=other_project)
+        call_api = client._call_api = mock.Mock()
+        call_api.return_value = resource
+        retry = DEFAULT_RETRY.with_deadline(1)
+
+        job._begin(client=client, retry=retry)
+
+        call_api.assert_called_once_with(
+            retry,
+            method="POST",
+            path="/projects/{}/jobs".format(self.PROJECT),
+            data=resource,
+        )
+        self.assertEqual(job._properties, resource)
+
+    def test_exists_defaults_miss(self):
+        from google.cloud.exceptions import NotFound
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        job = self._set_properties_job()
+        job._properties["jobReference"]["location"] = self.LOCATION
+        call_api = job._client._call_api = mock.Mock()
+        call_api.side_effect = NotFound("testing")
+
+        self.assertFalse(job.exists())
+
+        call_api.assert_called_once_with(
+            DEFAULT_RETRY,
+            method="GET",
+            path="/projects/{}/jobs/{}".format(self.PROJECT, self.JOB_ID),
+            query_params={"fields": "id", "location": self.LOCATION},
+        )
+
+    def test_exists_explicit_hit(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        other_project = "other-project-234"
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        job = self._set_properties_job()
+        client = _make_client(project=other_project)
+        call_api = client._call_api = mock.Mock()
+        call_api.return_value = resource
+        retry = DEFAULT_RETRY.with_deadline(1)
+
+        self.assertTrue(job.exists(client=client, retry=retry))
+
+        call_api.assert_called_once_with(
+            retry,
+            method="GET",
+            path="/projects/{}/jobs/{}".format(self.PROJECT, self.JOB_ID),
+            query_params={"fields": "id"},
+        )
+
+    def test_reload_defaults(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        job = self._set_properties_job()
+        job._properties["jobReference"]["location"] = self.LOCATION
+        call_api = job._client._call_api = mock.Mock()
+        call_api.return_value = resource
+
+        job.reload()
+
+        call_api.assert_called_once_with(
+            DEFAULT_RETRY,
+            method="GET",
+            path="/projects/{}/jobs/{}".format(self.PROJECT, self.JOB_ID),
+            query_params={"location": self.LOCATION},
+        )
+        self.assertEqual(job._properties, resource)
+
+    def test_reload_explicit(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        other_project = "other-project-234"
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        job = self._set_properties_job()
+        client = _make_client(project=other_project)
+        call_api = client._call_api = mock.Mock()
+        call_api.return_value = resource
+        retry = DEFAULT_RETRY.with_deadline(1)
+
+        job.reload(client=client, retry=retry)
+
+        call_api.assert_called_once_with(
+            retry,
+            method="GET",
+            path="/projects/{}/jobs/{}".format(self.PROJECT, self.JOB_ID),
+            query_params={},
+        )
+        self.assertEqual(job._properties, resource)
+
+    def test_cancel_defaults(self):
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        response = {"job": resource}
+        job = self._set_properties_job()
+        job._properties["jobReference"]["location"] = self.LOCATION
+        connection = job._client._connection = _make_connection(response)
+
+        self.assertTrue(job.cancel())
+
+        connection.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/{}/jobs/{}/cancel".format(self.PROJECT, self.JOB_ID),
+            query_params={"location": self.LOCATION},
+        )
+        self.assertEqual(job._properties, resource)
+
+    def test_cancel_explicit(self):
+        other_project = "other-project-234"
+        resource = {
+            "jobReference": {
+                "jobId": self.JOB_ID,
+                "projectId": self.PROJECT,
+                "location": None,
+            },
+            "configuration": {"test": True},
+        }
+        response = {"job": resource}
+        job = self._set_properties_job()
+        client = _make_client(project=other_project)
+        connection = client._connection = _make_connection(response)
+
+        self.assertTrue(job.cancel(client=client))
+
+        connection.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/{}/jobs/{}/cancel".format(self.PROJECT, self.JOB_ID),
+            query_params={},
+        )
+        self.assertEqual(job._properties, resource)
+
+    def test__set_future_result_wo_done(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        set_exception = job.set_exception = mock.Mock()
+        set_result = job.set_result = mock.Mock()
+
+        job._set_future_result()
+
+        set_exception.assert_not_called()
+        set_result.assert_not_called()
+
+    def test__set_future_result_w_result_set(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {"state": "DONE"}
+        job._result_set = True
+        set_exception = job.set_exception = mock.Mock()
+        set_result = job.set_result = mock.Mock()
+
+        job._set_future_result()
+
+        set_exception.assert_not_called()
+        set_result.assert_not_called()
+
+    def test__set_future_result_w_done_wo_result_set_w_error(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {
+            "state": "DONE",
+            "errorResult": {"reason": "notFound", "message": "testing"},
+        }
+        set_exception = job.set_exception = mock.Mock()
+        set_result = job.set_result = mock.Mock()
+
+        job._set_future_result()
+
+        set_exception.assert_called_once()
+        args, kw = set_exception.call_args
+        exception, = args
+        self.assertIsInstance(exception, NotFound)
+        self.assertEqual(exception.message, "testing")
+        self.assertEqual(kw, {})
+        set_result.assert_not_called()
+
+    def test__set_future_result_w_done_wo_result_set_wo_error(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {"state": "DONE"}
+        set_exception = job.set_exception = mock.Mock()
+        set_result = job.set_result = mock.Mock()
+
+        job._set_future_result()
+
+        set_exception.assert_not_called()
+        set_result.assert_called_once_with(job)
+
+    def test_done_defaults_wo_state(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        reload_ = job.reload = mock.Mock()
+
+        self.assertFalse(job.done())
+
+        reload_.assert_called_once_with(retry=DEFAULT_RETRY)
+
+    def test_done_explicit_wo_state(self):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        reload_ = job.reload = mock.Mock()
+        retry = DEFAULT_RETRY.with_deadline(1)
+
+        self.assertFalse(job.done(retry=retry))
+
+        reload_.assert_called_once_with(retry=retry)
+
+    def test_done_already(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {"state": "DONE"}
+
+        self.assertTrue(job.done())
+
+    @mock.patch("google.api_core.future.polling.PollingFuture.result")
+    def test_result_default_wo_state(self, result):
+        from google.cloud.bigquery.retry import DEFAULT_RETRY
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        begin = job._begin = mock.Mock()
+
+        self.assertIs(job.result(), result.return_value)
+
+        begin.assert_called_once_with(retry=DEFAULT_RETRY)
+        result.assert_called_once_with(timeout=None)
+
+    @mock.patch("google.api_core.future.polling.PollingFuture.result")
+    def test_result_w_retry_wo_state(self, result):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        begin = job._begin = mock.Mock()
+        retry = mock.Mock()
+
+        self.assertIs(job.result(retry=retry), result.return_value)
+
+        begin.assert_called_once_with(retry=retry)
+        result.assert_called_once_with(timeout=None)
+
+    @mock.patch("google.api_core.future.polling.PollingFuture.result")
+    def test_result_explicit_w_state(self, result):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {"state": "DONE"}
+        begin = job._begin = mock.Mock()
+        timeout = 1
+
+        self.assertIs(job.result(timeout=timeout), result.return_value)
+
+        begin.assert_not_called()
+        result.assert_called_once_with(timeout=timeout)
+
+    def test_cancelled_wo_error_result(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+
+        self.assertFalse(job.cancelled())
+
+    def test_cancelled_w_error_result_not_stopped(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {"errorResult": {"reason": "other"}}
+
+        self.assertFalse(job.cancelled())
+
+    def test_cancelled_w_error_result_w_stopped(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, client)
+        job._properties["status"] = {"errorResult": {"reason": "stopped"}}
+
+        self.assertTrue(job.cancelled())
+
+
+class Test_JobConfig(unittest.TestCase):
+    JOB_TYPE = "testing"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery import job
+
+        return job._JobConfig
+
+    def _make_one(self, job_type=JOB_TYPE):
+        return self._get_target_class()(job_type)
+
+    def test_ctor(self):
+        job_config = self._make_one()
+        self.assertEqual(job_config._job_type, self.JOB_TYPE)
+        self.assertEqual(job_config._properties, {self.JOB_TYPE: {}})
+
+    def test_fill_from_default(self):
+        from google.cloud.bigquery import QueryJobConfig
+
+        job_config = QueryJobConfig()
+        job_config.dry_run = True
+        job_config.maximum_bytes_billed = 1000
+
+        default_job_config = QueryJobConfig()
+        default_job_config.use_query_cache = True
+        default_job_config.maximum_bytes_billed = 2000
+
+        final_job_config = job_config._fill_from_default(default_job_config)
+        self.assertTrue(final_job_config.dry_run)
+        self.assertTrue(final_job_config.use_query_cache)
+        self.assertEqual(final_job_config.maximum_bytes_billed, 1000)
+
+    def test_fill_from_default_conflict(self):
+        from google.cloud.bigquery import QueryJobConfig
+
+        basic_job_config = QueryJobConfig()
+        conflicting_job_config = self._make_one("conflicting_job_type")
+        self.assertNotEqual(
+            basic_job_config._job_type, conflicting_job_config._job_type
+        )
+
+        with self.assertRaises(TypeError):
+            basic_job_config._fill_from_default(conflicting_job_config)
+
+    @mock.patch("google.cloud.bigquery._helpers._get_sub_prop")
+    def test__get_sub_prop_wo_default(self, _get_sub_prop):
+        job_config = self._make_one()
+        key = "key"
+        self.assertIs(job_config._get_sub_prop(key), _get_sub_prop.return_value)
+        _get_sub_prop.assert_called_once_with(
+            job_config._properties, [self.JOB_TYPE, key], default=None
+        )
+
+    @mock.patch("google.cloud.bigquery._helpers._get_sub_prop")
+    def test__get_sub_prop_w_default(self, _get_sub_prop):
+        job_config = self._make_one()
+        key = "key"
+        default = "default"
+        self.assertIs(
+            job_config._get_sub_prop(key, default=default), _get_sub_prop.return_value
+        )
+        _get_sub_prop.assert_called_once_with(
+            job_config._properties, [self.JOB_TYPE, key], default=default
+        )
+
+    @mock.patch("google.cloud.bigquery._helpers._set_sub_prop")
+    def test__set_sub_prop(self, _set_sub_prop):
+        job_config = self._make_one()
+        key = "key"
+        value = "value"
+        job_config._set_sub_prop(key, value)
+        _set_sub_prop.assert_called_once_with(
+            job_config._properties, [self.JOB_TYPE, key], value
+        )
+
+    def test_to_api_repr(self):
+        job_config = self._make_one()
+        expected = job_config._properties = {self.JOB_TYPE: {"foo": "bar"}}
+        found = job_config.to_api_repr()
+        self.assertEqual(found, expected)
+        self.assertIsNot(found, expected)  # copied
+
+    # 'from_api_repr' cannot be tested on '_JobConfig', because it presumes
+    # the ctor can be called w/o arguments
+
+    def test_labels_miss(self):
+        job_config = self._make_one()
+        self.assertEqual(job_config.labels, {})
+
+    def test_labels_update_in_place(self):
+        job_config = self._make_one()
+        labels = job_config.labels
+        labels["foo"] = "bar"  # update in place
+        self.assertEqual(job_config.labels, {"foo": "bar"})
+
+    def test_labels_hit(self):
+        labels = {"foo": "bar"}
+        job_config = self._make_one()
+        job_config._properties["labels"] = labels
+        self.assertEqual(job_config.labels, labels)
+
+    def test_labels_setter_invalid(self):
+        labels = object()
+        job_config = self._make_one()
+        with self.assertRaises(ValueError):
+            job_config.labels = labels
+
+    def test_labels_setter(self):
+        labels = {"foo": "bar"}
+        job_config = self._make_one()
+        job_config.labels = labels
+        self.assertEqual(job_config._properties["labels"], labels)
+
+
+class _Base(object):
+    from google.cloud.bigquery.dataset import DatasetReference
+    from google.cloud.bigquery.table import TableReference
+
+    ENDPOINT = "https://www.googleapis.com"
+    PROJECT = "project"
+    SOURCE1 = "http://example.com/source1.csv"
+    DS_ID = "dataset_id"
+    DS_REF = DatasetReference(PROJECT, DS_ID)
+    TABLE_ID = "table_id"
+    TABLE_REF = TableReference(DS_REF, TABLE_ID)
+    JOB_ID = "JOB_ID"
+    KMS_KEY_NAME = "projects/1/locations/global/keyRings/1/cryptoKeys/1"
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _setUpConstants(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        self.WHEN_TS = 1437767599.006
+        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(tzinfo=UTC)
+        self.ETAG = "ETAG"
+        self.FULL_JOB_ID = "%s:%s" % (self.PROJECT, self.JOB_ID)
+        self.RESOURCE_URL = "{}/bigquery/v2/projects/{}/jobs/{}".format(
+            self.ENDPOINT, self.PROJECT, self.JOB_ID
+        )
+        self.USER_EMAIL = "phred@example.com"
+
+    def _table_ref(self, table_id):
+        from google.cloud.bigquery.table import TableReference
+
+        return TableReference(self.DS_REF, table_id)
+
+    def _make_resource(self, started=False, ended=False):
+        self._setUpConstants()
+        return _make_job_resource(
+            creation_time_ms=int(self.WHEN_TS * 1000),
+            started_time_ms=int(self.WHEN_TS * 1000),
+            ended_time_ms=int(self.WHEN_TS * 1000) + 1000000,
+            started=started,
+            ended=ended,
+            etag=self.ETAG,
+            endpoint=self.ENDPOINT,
+            job_type=self.JOB_TYPE,
+            job_id=self.JOB_ID,
+            project_id=self.PROJECT,
+            user_email=self.USER_EMAIL,
+        )
+
+    def _verifyInitialReadonlyProperties(self, job):
+        # root elements of resource
+        self.assertIsNone(job.etag)
+        self.assertIsNone(job.self_link)
+        self.assertIsNone(job.user_email)
+
+        # derived from resource['statistics']
+        self.assertIsNone(job.created)
+        self.assertIsNone(job.started)
+        self.assertIsNone(job.ended)
+
+        # derived from resource['status']
+        self.assertIsNone(job.error_result)
+        self.assertIsNone(job.errors)
+        self.assertIsNone(job.state)
+
+    def _verifyReadonlyResourceProperties(self, job, resource):
+        from datetime import timedelta
+
+        statistics = resource.get("statistics", {})
+
+        if "creationTime" in statistics:
+            self.assertEqual(job.created, self.WHEN)
+        else:
+            self.assertIsNone(job.created)
+
+        if "startTime" in statistics:
+            self.assertEqual(job.started, self.WHEN)
+        else:
+            self.assertIsNone(job.started)
+
+        if "endTime" in statistics:
+            self.assertEqual(job.ended, self.WHEN + timedelta(seconds=1000))
+        else:
+            self.assertIsNone(job.ended)
+
+        if "etag" in resource:
+            self.assertEqual(job.etag, self.ETAG)
+        else:
+            self.assertIsNone(job.etag)
+
+        if "selfLink" in resource:
+            self.assertEqual(job.self_link, self.RESOURCE_URL)
+        else:
+            self.assertIsNone(job.self_link)
+
+        if "user_email" in resource:
+            self.assertEqual(job.user_email, self.USER_EMAIL)
+        else:
+            self.assertIsNone(job.user_email)
+
+
+class TestLoadJobConfig(unittest.TestCase, _Base):
+    JOB_TYPE = "load"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import LoadJobConfig
+
+        return LoadJobConfig
+
+    def test_ctor_w_properties(self):
+        config = self._get_target_class()(
+            allow_jagged_rows=True, allow_quoted_newlines=True
+        )
+
+        self.assertTrue(config.allow_jagged_rows)
+        self.assertTrue(config.allow_quoted_newlines)
+
+    def test_allow_jagged_rows_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.allow_jagged_rows)
+
+    def test_allow_jagged_rows_hit(self):
+        config = self._get_target_class()()
+        config._properties["load"]["allowJaggedRows"] = True
+        self.assertTrue(config.allow_jagged_rows)
+
+    def test_allow_jagged_rows_setter(self):
+        config = self._get_target_class()()
+        config.allow_jagged_rows = True
+        self.assertTrue(config._properties["load"]["allowJaggedRows"])
+
+    def test_allow_quoted_newlines_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.allow_quoted_newlines)
+
+    def test_allow_quoted_newlines_hit(self):
+        config = self._get_target_class()()
+        config._properties["load"]["allowQuotedNewlines"] = True
+        self.assertTrue(config.allow_quoted_newlines)
+
+    def test_allow_quoted_newlines_setter(self):
+        config = self._get_target_class()()
+        config.allow_quoted_newlines = True
+        self.assertTrue(config._properties["load"]["allowQuotedNewlines"])
+
+    def test_autodetect_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.autodetect)
+
+    def test_autodetect_hit(self):
+        config = self._get_target_class()()
+        config._properties["load"]["autodetect"] = True
+        self.assertTrue(config.autodetect)
+
+    def test_autodetect_setter(self):
+        config = self._get_target_class()()
+        config.autodetect = True
+        self.assertTrue(config._properties["load"]["autodetect"])
+
+    def test_clustering_fields_miss(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.clustering_fields)
+
+    def test_clustering_fields_hit(self):
+        config = self._get_target_class()()
+        fields = ["email", "postal_code"]
+        config._properties["load"]["clustering"] = {"fields": fields}
+        self.assertEqual(config.clustering_fields, fields)
+
+    def test_clustering_fields_setter(self):
+        fields = ["email", "postal_code"]
+        config = self._get_target_class()()
+        config.clustering_fields = fields
+        self.assertEqual(config._properties["load"]["clustering"], {"fields": fields})
+
+    def test_clustering_fields_setter_w_none(self):
+        config = self._get_target_class()()
+        fields = ["email", "postal_code"]
+        config._properties["load"]["clustering"] = {"fields": fields}
+        config.clustering_fields = None
+        self.assertIsNone(config.clustering_fields)
+        self.assertNotIn("clustering", config._properties["load"])
+
+    def test_create_disposition_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.create_disposition)
+
+    def test_create_disposition_hit(self):
+        from google.cloud.bigquery.job import CreateDisposition
+
+        disposition = CreateDisposition.CREATE_IF_NEEDED
+        config = self._get_target_class()()
+        config._properties["load"]["createDisposition"] = disposition
+        self.assertEqual(config.create_disposition, disposition)
+
+    def test_create_disposition_setter(self):
+        from google.cloud.bigquery.job import CreateDisposition
+
+        disposition = CreateDisposition.CREATE_IF_NEEDED
+        config = self._get_target_class()()
+        config.create_disposition = disposition
+        self.assertEqual(config._properties["load"]["createDisposition"], disposition)
+
+    def test_destination_encryption_configuration_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.destination_encryption_configuration)
+
+    def test_destination_encryption_configuration_hit(self):
+        from google.cloud.bigquery.table import EncryptionConfiguration
+
+        kms_key_name = "kms-key-name"
+        encryption_configuration = EncryptionConfiguration(kms_key_name)
+        config = self._get_target_class()()
+        config._properties["load"]["destinationEncryptionConfiguration"] = {
+            "kmsKeyName": kms_key_name
+        }
+        self.assertEqual(
+            config.destination_encryption_configuration, encryption_configuration
+        )
+
+    def test_destination_encryption_configuration_setter(self):
+        from google.cloud.bigquery.table import EncryptionConfiguration
+
+        kms_key_name = "kms-key-name"
+        encryption_configuration = EncryptionConfiguration(kms_key_name)
+        config = self._get_target_class()()
+        config.destination_encryption_configuration = encryption_configuration
+        expected = {"kmsKeyName": kms_key_name}
+        self.assertEqual(
+            config._properties["load"]["destinationEncryptionConfiguration"], expected
+        )
+
+    def test_destination_encryption_configuration_setter_w_none(self):
+        kms_key_name = "kms-key-name"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationEncryptionConfiguration"] = {
+            "kmsKeyName": kms_key_name
+        }
+        config.destination_encryption_configuration = None
+        self.assertIsNone(config.destination_encryption_configuration)
+        self.assertNotIn(
+            "destinationEncryptionConfiguration", config._properties["load"]
+        )
+
+    def test_destination_table_description_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.destination_table_description)
+
+    def test_destination_table_description_hit(self):
+        description = "Description"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationTableProperties"] = {
+            "description": description
+        }
+        self.assertEqual(config.destination_table_description, description)
+
+    def test_destination_table_description_setter(self):
+        description = "Description"
+        config = self._get_target_class()()
+        config.destination_table_description = description
+        expected = {"description": description}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+
+    def test_destination_table_description_setter_w_fn_already(self):
+        description = "Description"
+        friendly_name = "Friendly Name"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationTableProperties"] = {
+            "friendlyName": friendly_name
+        }
+        config.destination_table_description = description
+        expected = {"friendlyName": friendly_name, "description": description}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+
+    def test_destination_table_description_w_none(self):
+        description = "Description"
+        friendly_name = "Friendly Name"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationTableProperties"] = {
+            "description": description,
+            "friendlyName": friendly_name,
+        }
+        config.destination_table_description = None
+        expected = {"friendlyName": friendly_name}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+
+    def test_destination_table_friendly_name_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.destination_table_friendly_name)
+
+    def test_destination_table_friendly_name_hit(self):
+        friendly_name = "Friendly Name"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationTableProperties"] = {
+            "friendlyName": friendly_name
+        }
+        self.assertEqual(config.destination_table_friendly_name, friendly_name)
+
+    def test_destination_table_friendly_name_setter(self):
+        friendly_name = "Friendly Name"
+        config = self._get_target_class()()
+        config.destination_table_friendly_name = friendly_name
+        expected = {"friendlyName": friendly_name}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+
+    def test_destination_table_friendly_name_setter_w_descr_already(self):
+        friendly_name = "Friendly Name"
+        description = "Description"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationTableProperties"] = {
+            "description": description
+        }
+        config.destination_table_friendly_name = friendly_name
+        expected = {"friendlyName": friendly_name, "description": description}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+
+    def test_destination_table_friendly_name_w_none(self):
+        friendly_name = "Friendly Name"
+        description = "Description"
+        config = self._get_target_class()()
+        config._properties["load"]["destinationTableProperties"] = {
+            "description": description,
+            "friendlyName": friendly_name,
+        }
+        config.destination_table_friendly_name = None
+        expected = {"description": description}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+
+    def test_encoding_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.encoding)
+
+    def test_encoding_hit(self):
+        from google.cloud.bigquery.job import Encoding
+
+        encoding = Encoding.UTF_8
+        config = self._get_target_class()()
+        config._properties["load"]["encoding"] = encoding
+        self.assertEqual(config.encoding, encoding)
+
+    def test_encoding_setter(self):
+        from google.cloud.bigquery.job import Encoding
+
+        encoding = Encoding.UTF_8
+        config = self._get_target_class()()
+        config.encoding = encoding
+        self.assertEqual(config._properties["load"]["encoding"], encoding)
+
+    def test_field_delimiter_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.field_delimiter)
+
+    def test_field_delimiter_hit(self):
+        field_delimiter = "|"
+        config = self._get_target_class()()
+        config._properties["load"]["fieldDelimiter"] = field_delimiter
+        self.assertEqual(config.field_delimiter, field_delimiter)
+
+    def test_field_delimiter_setter(self):
+        field_delimiter = "|"
+        config = self._get_target_class()()
+        config.field_delimiter = field_delimiter
+        self.assertEqual(config._properties["load"]["fieldDelimiter"], field_delimiter)
+
+    def test_ignore_unknown_values_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.ignore_unknown_values)
+
+    def test_ignore_unknown_values_hit(self):
+        config = self._get_target_class()()
+        config._properties["load"]["ignoreUnknownValues"] = True
+        self.assertTrue(config.ignore_unknown_values)
+
+    def test_ignore_unknown_values_setter(self):
+        config = self._get_target_class()()
+        config.ignore_unknown_values = True
+        self.assertTrue(config._properties["load"]["ignoreUnknownValues"])
+
+    def test_max_bad_records_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.max_bad_records)
+
+    def test_max_bad_records_hit(self):
+        max_bad_records = 13
+        config = self._get_target_class()()
+        config._properties["load"]["maxBadRecords"] = max_bad_records
+        self.assertEqual(config.max_bad_records, max_bad_records)
+
+    def test_max_bad_records_setter(self):
+        max_bad_records = 13
+        config = self._get_target_class()()
+        config.max_bad_records = max_bad_records
+        self.assertEqual(config._properties["load"]["maxBadRecords"], max_bad_records)
+
+    def test_null_marker_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.null_marker)
+
+    def test_null_marker_hit(self):
+        null_marker = "XXX"
+        config = self._get_target_class()()
+        config._properties["load"]["nullMarker"] = null_marker
+        self.assertEqual(config.null_marker, null_marker)
+
+    def test_null_marker_setter(self):
+        null_marker = "XXX"
+        config = self._get_target_class()()
+        config.null_marker = null_marker
+        self.assertEqual(config._properties["load"]["nullMarker"], null_marker)
+
+    def test_quote_character_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.quote_character)
+
+    def test_quote_character_hit(self):
+        quote_character = "'"
+        config = self._get_target_class()()
+        config._properties["load"]["quote"] = quote_character
+        self.assertEqual(config.quote_character, quote_character)
+
+    def test_quote_character_setter(self):
+        quote_character = "'"
+        config = self._get_target_class()()
+        config.quote_character = quote_character
+        self.assertEqual(config._properties["load"]["quote"], quote_character)
+
+    def test_schema_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.schema)
+
+    def test_schema_hit(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        config = self._get_target_class()()
+        all_props_repr = {
+            "mode": "REQUIRED",
+            "name": "foo",
+            "type": "INTEGER",
+            "description": "Foo",
+        }
+        minimal_repr = {"name": "bar", "type": "STRING"}
+        config._properties["load"]["schema"] = {
+            "fields": [all_props_repr, minimal_repr]
+        }
+        all_props, minimal = config.schema
+        self.assertEqual(all_props, SchemaField.from_api_repr(all_props_repr))
+        self.assertEqual(minimal, SchemaField.from_api_repr(minimal_repr))
+
+    def test_schema_setter(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        config = self._get_target_class()()
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        config.schema = [full_name, age]
+        full_name_repr = {
+            "name": "full_name",
+            "type": "STRING",
+            "mode": "REQUIRED",
+            "description": None,
+        }
+        age_repr = {
+            "name": "age",
+            "type": "INTEGER",
+            "mode": "REQUIRED",
+            "description": None,
+        }
+        self.assertEqual(
+            config._properties["load"]["schema"], {"fields": [full_name_repr, age_repr]}
+        )
+
+    def test_schema_setter_unsetting_schema(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        config = self._get_target_class()()
+        config._properties["load"]["schema"] = [
+            SchemaField("full_name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+
+        config.schema = None
+        self.assertNotIn("schema", config._properties["load"])
+        config.schema = None  # no error, idempotent operation
+
+    def test_schema_update_options_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.schema_update_options)
+
+    def test_schema_update_options_hit(self):
+        from google.cloud.bigquery.job import SchemaUpdateOption
+
+        options = [
+            SchemaUpdateOption.ALLOW_FIELD_ADDITION,
+            SchemaUpdateOption.ALLOW_FIELD_RELAXATION,
+        ]
+        config = self._get_target_class()()
+        config._properties["load"]["schemaUpdateOptions"] = options
+        self.assertEqual(config.schema_update_options, options)
+
+    def test_schema_update_options_setter(self):
+        from google.cloud.bigquery.job import SchemaUpdateOption
+
+        options = [
+            SchemaUpdateOption.ALLOW_FIELD_ADDITION,
+            SchemaUpdateOption.ALLOW_FIELD_RELAXATION,
+        ]
+        config = self._get_target_class()()
+        config.schema_update_options = options
+        self.assertEqual(config._properties["load"]["schemaUpdateOptions"], options)
+
+    def test_skip_leading_rows_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.skip_leading_rows)
+
+    def test_skip_leading_rows_hit_w_str(self):
+        skip_leading_rows = 1
+        config = self._get_target_class()()
+        config._properties["load"]["skipLeadingRows"] = str(skip_leading_rows)
+        self.assertEqual(config.skip_leading_rows, skip_leading_rows)
+
+    def test_skip_leading_rows_hit_w_integer(self):
+        skip_leading_rows = 1
+        config = self._get_target_class()()
+        config._properties["load"]["skipLeadingRows"] = skip_leading_rows
+        self.assertEqual(config.skip_leading_rows, skip_leading_rows)
+
+    def test_skip_leading_rows_setter(self):
+        skip_leading_rows = 1
+        config = self._get_target_class()()
+        config.skip_leading_rows = skip_leading_rows
+        self.assertEqual(
+            config._properties["load"]["skipLeadingRows"], str(skip_leading_rows)
+        )
+
+    def test_source_format_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.source_format)
+
+    def test_source_format_hit(self):
+        from google.cloud.bigquery.job import SourceFormat
+
+        source_format = SourceFormat.CSV
+        config = self._get_target_class()()
+        config._properties["load"]["sourceFormat"] = source_format
+        self.assertEqual(config.source_format, source_format)
+
+    def test_source_format_setter(self):
+        from google.cloud.bigquery.job import SourceFormat
+
+        source_format = SourceFormat.CSV
+        config = self._get_target_class()()
+        config.source_format = source_format
+        self.assertEqual(config._properties["load"]["sourceFormat"], source_format)
+
+    def test_time_partitioning_miss(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.time_partitioning)
+
+    def test_time_partitioning_hit(self):
+        from google.cloud.bigquery.table import TimePartitioning
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        field = "creation_date"
+        year_ms = 86400 * 1000 * 365
+        config = self._get_target_class()()
+        config._properties["load"]["timePartitioning"] = {
+            "type": TimePartitioningType.DAY,
+            "field": field,
+            "expirationMs": str(year_ms),
+            "requirePartitionFilter": False,
+        }
+        expected = TimePartitioning(
+            type_=TimePartitioningType.DAY,
+            field=field,
+            expiration_ms=year_ms,
+            require_partition_filter=False,
+        )
+        self.assertEqual(config.time_partitioning, expected)
+
+    def test_time_partitioning_setter(self):
+        from google.cloud.bigquery.table import TimePartitioning
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        field = "creation_date"
+        year_ms = 86400 * 1000 * 365
+        time_partitioning = TimePartitioning(
+            type_=TimePartitioningType.DAY,
+            field=field,
+            expiration_ms=year_ms,
+            require_partition_filter=False,
+        )
+        config = self._get_target_class()()
+        config.time_partitioning = time_partitioning
+        expected = {
+            "type": TimePartitioningType.DAY,
+            "field": field,
+            "expirationMs": str(year_ms),
+            "requirePartitionFilter": False,
+        }
+        self.assertEqual(config._properties["load"]["timePartitioning"], expected)
+
+    def test_time_partitioning_setter_w_none(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        field = "creation_date"
+        year_ms = 86400 * 1000 * 365
+        config = self._get_target_class()()
+        config._properties["load"]["timePartitioning"] = {
+            "type": TimePartitioningType.DAY,
+            "field": field,
+            "expirationMs": str(year_ms),
+            "requirePartitionFilter": False,
+        }
+        config.time_partitioning = None
+        self.assertIsNone(config.time_partitioning)
+        self.assertNotIn("timePartitioning", config._properties["load"])
+
+    def test_use_avro_logical_types(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.use_avro_logical_types)
+
+    def test_use_avro_logical_types_setter(self):
+        config = self._get_target_class()()
+        config.use_avro_logical_types = True
+        self.assertTrue(config._properties["load"]["useAvroLogicalTypes"])
+
+    def test_write_disposition_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.write_disposition)
+
+    def test_write_disposition_hit(self):
+        from google.cloud.bigquery.job import WriteDisposition
+
+        write_disposition = WriteDisposition.WRITE_TRUNCATE
+        config = self._get_target_class()()
+        config._properties["load"]["writeDisposition"] = write_disposition
+        self.assertEqual(config.write_disposition, write_disposition)
+
+    def test_write_disposition_setter(self):
+        from google.cloud.bigquery.job import WriteDisposition
+
+        write_disposition = WriteDisposition.WRITE_TRUNCATE
+        config = self._get_target_class()()
+        config.write_disposition = write_disposition
+        self.assertEqual(
+            config._properties["load"]["writeDisposition"], write_disposition
+        )
+
+
+class TestLoadJob(unittest.TestCase, _Base):
+    JOB_TYPE = "load"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import LoadJob
+
+        return LoadJob
+
+    def _setUpConstants(self):
+        super(TestLoadJob, self)._setUpConstants()
+        self.INPUT_FILES = 2
+        self.INPUT_BYTES = 12345
+        self.OUTPUT_BYTES = 23456
+        self.OUTPUT_ROWS = 345
+
+    def _make_resource(self, started=False, ended=False):
+        resource = super(TestLoadJob, self)._make_resource(started, ended)
+        config = resource["configuration"]["load"]
+        config["sourceUris"] = [self.SOURCE1]
+        config["destinationTable"] = {
+            "projectId": self.PROJECT,
+            "datasetId": self.DS_ID,
+            "tableId": self.TABLE_ID,
+        }
+
+        if ended:
+            resource["status"] = {"state": "DONE"}
+            resource["statistics"]["load"]["inputFiles"] = self.INPUT_FILES
+            resource["statistics"]["load"]["inputFileBytes"] = self.INPUT_BYTES
+            resource["statistics"]["load"]["outputBytes"] = self.OUTPUT_BYTES
+            resource["statistics"]["load"]["outputRows"] = self.OUTPUT_ROWS
+
+        return resource
+
+    def _verifyBooleanConfigProperties(self, job, config):
+        if "allowJaggedRows" in config:
+            self.assertEqual(job.allow_jagged_rows, config["allowJaggedRows"])
+        else:
+            self.assertIsNone(job.allow_jagged_rows)
+        if "allowQuotedNewlines" in config:
+            self.assertEqual(job.allow_quoted_newlines, config["allowQuotedNewlines"])
+        else:
+            self.assertIsNone(job.allow_quoted_newlines)
+        if "autodetect" in config:
+            self.assertEqual(job.autodetect, config["autodetect"])
+        else:
+            self.assertIsNone(job.autodetect)
+        if "ignoreUnknownValues" in config:
+            self.assertEqual(job.ignore_unknown_values, config["ignoreUnknownValues"])
+        else:
+            self.assertIsNone(job.ignore_unknown_values)
+        if "useAvroLogicalTypes" in config:
+            self.assertEqual(job.use_avro_logical_types, config["useAvroLogicalTypes"])
+        else:
+            self.assertIsNone(job.use_avro_logical_types)
+
+    def _verifyEnumConfigProperties(self, job, config):
+        if "createDisposition" in config:
+            self.assertEqual(job.create_disposition, config["createDisposition"])
+        else:
+            self.assertIsNone(job.create_disposition)
+        if "encoding" in config:
+            self.assertEqual(job.encoding, config["encoding"])
+        else:
+            self.assertIsNone(job.encoding)
+        if "sourceFormat" in config:
+            self.assertEqual(job.source_format, config["sourceFormat"])
+        else:
+            self.assertIsNone(job.source_format)
+        if "writeDisposition" in config:
+            self.assertEqual(job.write_disposition, config["writeDisposition"])
+        else:
+            self.assertIsNone(job.write_disposition)
+        if "schemaUpdateOptions" in config:
+            self.assertEqual(job.schema_update_options, config["schemaUpdateOptions"])
+        else:
+            self.assertIsNone(job.schema_update_options)
+
+    def _verifyResourceProperties(self, job, resource):
+        self._verifyReadonlyResourceProperties(job, resource)
+
+        config = resource.get("configuration", {}).get("load")
+
+        self._verifyBooleanConfigProperties(job, config)
+        self._verifyEnumConfigProperties(job, config)
+
+        self.assertEqual(job.source_uris, config["sourceUris"])
+
+        table_ref = config["destinationTable"]
+        self.assertEqual(job.destination.project, table_ref["projectId"])
+        self.assertEqual(job.destination.dataset_id, table_ref["datasetId"])
+        self.assertEqual(job.destination.table_id, table_ref["tableId"])
+
+        if "fieldDelimiter" in config:
+            self.assertEqual(job.field_delimiter, config["fieldDelimiter"])
+        else:
+            self.assertIsNone(job.field_delimiter)
+        if "maxBadRecords" in config:
+            self.assertEqual(job.max_bad_records, config["maxBadRecords"])
+        else:
+            self.assertIsNone(job.max_bad_records)
+        if "nullMarker" in config:
+            self.assertEqual(job.null_marker, config["nullMarker"])
+        else:
+            self.assertIsNone(job.null_marker)
+        if "quote" in config:
+            self.assertEqual(job.quote_character, config["quote"])
+        else:
+            self.assertIsNone(job.quote_character)
+        if "skipLeadingRows" in config:
+            self.assertEqual(str(job.skip_leading_rows), config["skipLeadingRows"])
+        else:
+            self.assertIsNone(job.skip_leading_rows)
+
+        if "destinationEncryptionConfiguration" in config:
+            self.assertIsNotNone(job.destination_encryption_configuration)
+            self.assertEqual(
+                job.destination_encryption_configuration.kms_key_name,
+                config["destinationEncryptionConfiguration"]["kmsKeyName"],
+            )
+        else:
+            self.assertIsNone(job.destination_encryption_configuration)
+
+    def test_ctor(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+        self.assertIs(job.destination, self.TABLE_REF)
+        self.assertEqual(list(job.source_uris), [self.SOURCE1])
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_type, self.JOB_TYPE)
+        self.assertEqual(job.path, "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID))
+
+        self._verifyInitialReadonlyProperties(job)
+
+        # derived from resource['statistics']['load']
+        self.assertIsNone(job.input_file_bytes)
+        self.assertIsNone(job.input_files)
+        self.assertIsNone(job.output_bytes)
+        self.assertIsNone(job.output_rows)
+
+        # set/read from resource['configuration']['load']
+        self.assertIsNone(job.schema)
+        self.assertIsNone(job.allow_jagged_rows)
+        self.assertIsNone(job.allow_quoted_newlines)
+        self.assertIsNone(job.autodetect)
+        self.assertIsNone(job.create_disposition)
+        self.assertIsNone(job.encoding)
+        self.assertIsNone(job.field_delimiter)
+        self.assertIsNone(job.ignore_unknown_values)
+        self.assertIsNone(job.max_bad_records)
+        self.assertIsNone(job.null_marker)
+        self.assertIsNone(job.quote_character)
+        self.assertIsNone(job.skip_leading_rows)
+        self.assertIsNone(job.source_format)
+        self.assertIsNone(job.write_disposition)
+        self.assertIsNone(job.destination_encryption_configuration)
+        self.assertIsNone(job.destination_table_description)
+        self.assertIsNone(job.destination_table_friendly_name)
+        self.assertIsNone(job.time_partitioning)
+        self.assertIsNone(job.use_avro_logical_types)
+        self.assertIsNone(job.clustering_fields)
+        self.assertIsNone(job.schema_update_options)
+
+    def test_ctor_w_config(self):
+        from google.cloud.bigquery.schema import SchemaField
+        from google.cloud.bigquery.job import LoadJobConfig
+
+        client = _make_client(project=self.PROJECT)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        config = LoadJobConfig()
+        config.schema = [full_name, age]
+        job = self._make_one(
+            self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client, config
+        )
+        self.assertEqual(job.schema, [full_name, age])
+        config.destination_table_description = "Description"
+        expected = {"description": "Description"}
+        self.assertEqual(
+            config._properties["load"]["destinationTableProperties"], expected
+        )
+        friendly_name = "Friendly Name"
+        config._properties["load"]["destinationTableProperties"] = {
+            "friendlyName": friendly_name
+        }
+        self.assertEqual(config.destination_table_friendly_name, friendly_name)
+
+    def test_ctor_w_job_reference(self):
+        from google.cloud.bigquery import job
+
+        client = _make_client(project=self.PROJECT)
+        job_ref = job._JobReference(self.JOB_ID, "alternative-project", "US")
+        load_job = self._make_one(job_ref, [self.SOURCE1], self.TABLE_REF, client)
+        self.assertEqual(load_job.project, "alternative-project")
+        self.assertEqual(load_job.location, "US")
+
+    def test_done(self):
+        client = _make_client(project=self.PROJECT)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+        self.assertTrue(job.done())
+
+    def test_result(self):
+        client = _make_client(project=self.PROJECT)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+
+        result = job.result()
+
+        self.assertIs(result, job)
+
+    def test_result_invokes_begin(self):
+        begun_resource = self._make_resource()
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(begun_resource, done_resource)
+        client = _make_client(self.PROJECT)
+        client._connection = connection
+
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+        job.result()
+
+        self.assertEqual(len(connection.api_request.call_args_list), 2)
+        begin_request, reload_request = connection.api_request.call_args_list
+        self.assertEqual(begin_request[1]["method"], "POST")
+        self.assertEqual(reload_request[1]["method"], "GET")
+
+    def test_schema_setter_non_list(self):
+        from google.cloud.bigquery.job import LoadJobConfig
+
+        config = LoadJobConfig()
+        with self.assertRaises(TypeError):
+            config.schema = object()
+
+    def test_schema_setter_invalid_field(self):
+        from google.cloud.bigquery.job import LoadJobConfig
+        from google.cloud.bigquery.schema import SchemaField
+
+        config = LoadJobConfig()
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        with self.assertRaises(ValueError):
+            config.schema = [full_name, object()]
+
+    def test_schema_setter(self):
+        from google.cloud.bigquery.job import LoadJobConfig
+        from google.cloud.bigquery.schema import SchemaField
+
+        config = LoadJobConfig()
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        config.schema = [full_name, age]
+        self.assertEqual(config.schema, [full_name, age])
+
+    def test_props_set_by_server(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _millis
+
+        CREATED = datetime.datetime(2015, 8, 11, 12, 13, 22, tzinfo=UTC)
+        STARTED = datetime.datetime(2015, 8, 11, 13, 47, 15, tzinfo=UTC)
+        ENDED = datetime.datetime(2015, 8, 11, 14, 47, 15, tzinfo=UTC)
+        FULL_JOB_ID = "%s:%s" % (self.PROJECT, self.JOB_ID)
+        URL = "http://example.com/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        EMAIL = "phred@example.com"
+        ERROR_RESULT = {
+            "debugInfo": "DEBUG",
+            "location": "LOCATION",
+            "message": "MESSAGE",
+            "reason": "REASON",
+        }
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+        job._properties["etag"] = "ETAG"
+        job._properties["id"] = FULL_JOB_ID
+        job._properties["selfLink"] = URL
+        job._properties["user_email"] = EMAIL
+
+        statistics = job._properties["statistics"] = {}
+        statistics["creationTime"] = _millis(CREATED)
+        statistics["startTime"] = _millis(STARTED)
+        statistics["endTime"] = _millis(ENDED)
+
+        self.assertEqual(job.etag, "ETAG")
+        self.assertEqual(job.self_link, URL)
+        self.assertEqual(job.user_email, EMAIL)
+
+        self.assertEqual(job.created, CREATED)
+        self.assertEqual(job.started, STARTED)
+        self.assertEqual(job.ended, ENDED)
+
+        # running jobs have no load stats not yet set.
+        self.assertIsNone(job.output_bytes)
+
+        load_stats = statistics["load"] = {}
+        load_stats["inputFileBytes"] = 12345
+        load_stats["inputFiles"] = 1
+        load_stats["outputBytes"] = 23456
+        load_stats["outputRows"] = 345
+
+        self.assertEqual(job.input_file_bytes, 12345)
+        self.assertEqual(job.input_files, 1)
+        self.assertEqual(job.output_bytes, 23456)
+        self.assertEqual(job.output_rows, 345)
+
+        status = job._properties["status"] = {}
+
+        self.assertIsNone(job.error_result)
+        self.assertIsNone(job.errors)
+        self.assertIsNone(job.state)
+
+        status["errorResult"] = ERROR_RESULT
+        status["errors"] = [ERROR_RESULT]
+        status["state"] = "STATE"
+
+        self.assertEqual(job.error_result, ERROR_RESULT)
+        self.assertEqual(job.errors, [ERROR_RESULT])
+        self.assertEqual(job.state, "STATE")
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_missing_config(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": "%s:%s" % (self.PROJECT, self.JOB_ID),
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+        }
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.FULL_JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "load": {
+                    "sourceUris": [self.SOURCE1],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.TABLE_ID,
+                    },
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_with_encryption(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.FULL_JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "load": {
+                    "sourceUris": [self.SOURCE1],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.TABLE_ID,
+                    },
+                    "destinationEncryptionConfiguration": {
+                        "kmsKeyName": self.KMS_KEY_NAME
+                    },
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_repr_w_properties(self):
+        from google.cloud.bigquery.job import CreateDisposition
+
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = self._make_resource()
+        load_config = RESOURCE["configuration"]["load"]
+        load_config["createDisposition"] = CreateDisposition.CREATE_IF_NEEDED
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_already_running(self):
+        conn = _make_connection()
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+        job._properties["status"] = {"state": "RUNNING"}
+
+        with self.assertRaises(ValueError):
+            job._begin()
+
+    def test_begin_w_bound_client(self):
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+
+        job._begin()
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/{}/jobs".format(self.PROJECT),
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "load": {
+                        "sourceUris": [self.SOURCE1],
+                        "destinationTable": {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": self.TABLE_ID,
+                        },
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_autodetect(self):
+        from google.cloud.bigquery.job import LoadJobConfig
+
+        path = "/projects/{}/jobs".format(self.PROJECT)
+        resource = self._make_resource()
+        resource["configuration"]["load"]["autodetect"] = True
+        # Ensure None for missing server-set props
+        del resource["statistics"]["creationTime"]
+        del resource["etag"]
+        del resource["selfLink"]
+        del resource["user_email"]
+        conn = _make_connection(resource)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        config = LoadJobConfig()
+        config.autodetect = True
+        job = self._make_one(
+            self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client, config
+        )
+        job._begin()
+
+        sent = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "load": {
+                    "sourceUris": [self.SOURCE1],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.TABLE_ID,
+                    },
+                    "autodetect": True,
+                }
+            },
+        }
+        conn.api_request.assert_called_once_with(method="POST", path=path, data=sent)
+        self._verifyResourceProperties(job, resource)
+
+    def test_begin_w_alternate_client(self):
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import LoadJobConfig
+        from google.cloud.bigquery.job import SchemaUpdateOption
+        from google.cloud.bigquery.job import WriteDisposition
+        from google.cloud.bigquery.schema import SchemaField
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource(ended=True)
+        LOAD_CONFIGURATION = {
+            "sourceUris": [self.SOURCE1],
+            "destinationTable": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.TABLE_ID,
+            },
+            "allowJaggedRows": True,
+            "allowQuotedNewlines": True,
+            "createDisposition": CreateDisposition.CREATE_NEVER,
+            "encoding": "ISO-8559-1",
+            "fieldDelimiter": "|",
+            "ignoreUnknownValues": True,
+            "maxBadRecords": 100,
+            "nullMarker": r"\N",
+            "quote": "'",
+            "skipLeadingRows": "1",
+            "sourceFormat": "CSV",
+            "useAvroLogicalTypes": True,
+            "writeDisposition": WriteDisposition.WRITE_TRUNCATE,
+            "schema": {
+                "fields": [
+                    {
+                        "name": "full_name",
+                        "type": "STRING",
+                        "mode": "REQUIRED",
+                        "description": None,
+                    },
+                    {
+                        "name": "age",
+                        "type": "INTEGER",
+                        "mode": "REQUIRED",
+                        "description": None,
+                    },
+                ]
+            },
+            "schemaUpdateOptions": [SchemaUpdateOption.ALLOW_FIELD_ADDITION],
+        }
+        RESOURCE["configuration"]["load"] = LOAD_CONFIGURATION
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        config = LoadJobConfig()
+        config.schema = [full_name, age]
+        job = self._make_one(
+            self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client1, config
+        )
+        config.allow_jagged_rows = True
+        config.allow_quoted_newlines = True
+        config.create_disposition = CreateDisposition.CREATE_NEVER
+        config.encoding = "ISO-8559-1"
+        config.field_delimiter = "|"
+        config.ignore_unknown_values = True
+        config.max_bad_records = 100
+        config.null_marker = r"\N"
+        config.quote_character = "'"
+        config.skip_leading_rows = 1
+        config.source_format = "CSV"
+        config.use_avro_logical_types = True
+        config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+        config.schema_update_options = [SchemaUpdateOption.ALLOW_FIELD_ADDITION]
+
+        job._begin(client=client2)
+
+        conn1.api_request.assert_not_called()
+        self.assertEqual(len(conn2.api_request.call_args_list), 1)
+        req = conn2.api_request.call_args_list[0]
+        self.assertEqual(req[1]["method"], "POST")
+        self.assertEqual(req[1]["path"], PATH)
+        SENT = {
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {"load": LOAD_CONFIGURATION},
+        }
+        self.maxDiff = None
+        self.assertEqual(req[1]["data"], SENT)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_job_reference(self):
+        from google.cloud.bigquery import job
+
+        resource = self._make_resource()
+        resource["jobReference"]["projectId"] = "alternative-project"
+        resource["jobReference"]["location"] = "US"
+        job_ref = job._JobReference(self.JOB_ID, "alternative-project", "US")
+        conn = _make_connection(resource)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        load_job = self._make_one(job_ref, [self.SOURCE1], self.TABLE_REF, client)
+
+        load_job._begin()
+
+        conn.api_request.assert_called_once()
+        _, request = conn.api_request.call_args
+        self.assertEqual(request["method"], "POST")
+        self.assertEqual(request["path"], "/projects/alternative-project/jobs")
+        self.assertEqual(
+            request["data"]["jobReference"]["projectId"], "alternative-project"
+        )
+        self.assertEqual(request["data"]["jobReference"]["location"], "US")
+        self.assertEqual(request["data"]["jobReference"]["jobId"], self.JOB_ID)
+
+    def test_exists_miss_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn = _make_connection()
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+
+        self.assertFalse(job.exists())
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_exists_hit_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection({})
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client1)
+
+        self.assertTrue(job.exists(client=client2))
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_exists_miss_w_job_reference(self):
+        from google.cloud.bigquery import job
+
+        job_ref = job._JobReference("my-job-id", "other-project", "US")
+        conn = _make_connection()
+        client = _make_client(project=self.PROJECT, connection=conn)
+        load_job = self._make_one(job_ref, [self.SOURCE1], self.TABLE_REF, client)
+
+        self.assertFalse(load_job.exists())
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/other-project/jobs/my-job-id",
+            query_params={"fields": "id", "location": "US"},
+        )
+
+    def test_reload_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource()
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+
+        job.reload()
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource()
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client1)
+
+        job.reload(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_reload_w_job_reference(self):
+        from google.cloud.bigquery import job
+
+        resource = self._make_resource(ended=True)
+        resource["jobReference"]["projectId"] = "alternative-project"
+        resource["jobReference"]["location"] = "US"
+        job_ref = job._JobReference(self.JOB_ID, "alternative-project", "US")
+        conn = _make_connection(resource)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        load_job = self._make_one(job_ref, [self.SOURCE1], self.TABLE_REF, client)
+
+        load_job.reload()
+
+        conn.api_request.assert_called_once_with(
+            method="GET",
+            path="/projects/alternative-project/jobs/{}".format(self.JOB_ID),
+            query_params={"location": "US"},
+        )
+
+    def test_cancel_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s/cancel" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource(ended=True)
+        RESPONSE = {"job": RESOURCE}
+        conn = _make_connection(RESPONSE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client)
+
+        job.cancel()
+
+        conn.api_request.assert_called_once_with(
+            method="POST", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_cancel_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s/cancel" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource(ended=True)
+        RESPONSE = {"job": RESOURCE}
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESPONSE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        job = self._make_one(self.JOB_ID, [self.SOURCE1], self.TABLE_REF, client1)
+
+        job.cancel(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="POST", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_cancel_w_job_reference(self):
+        from google.cloud.bigquery import job
+
+        resource = self._make_resource(ended=True)
+        resource["jobReference"]["projectId"] = "alternative-project"
+        resource["jobReference"]["location"] = "US"
+        job_ref = job._JobReference(self.JOB_ID, "alternative-project", "US")
+        conn = _make_connection({"job": resource})
+        client = _make_client(project=self.PROJECT, connection=conn)
+        load_job = self._make_one(job_ref, [self.SOURCE1], self.TABLE_REF, client)
+
+        load_job.cancel()
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path="/projects/alternative-project/jobs/{}/cancel".format(self.JOB_ID),
+            query_params={"location": "US"},
+        )
+
+
+class TestCopyJobConfig(unittest.TestCase, _Base):
+    JOB_TYPE = "copy"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import CopyJobConfig
+
+        return CopyJobConfig
+
+    def test_ctor_w_properties(self):
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import WriteDisposition
+
+        create_disposition = CreateDisposition.CREATE_NEVER
+        write_disposition = WriteDisposition.WRITE_TRUNCATE
+        config = self._get_target_class()(
+            create_disposition=create_disposition, write_disposition=write_disposition
+        )
+
+        self.assertEqual(config.create_disposition, create_disposition)
+        self.assertEqual(config.write_disposition, write_disposition)
+
+    def test_to_api_repr_with_encryption(self):
+        from google.cloud.bigquery.table import EncryptionConfiguration
+
+        config = self._make_one()
+        config.destination_encryption_configuration = EncryptionConfiguration(
+            kms_key_name=self.KMS_KEY_NAME
+        )
+        resource = config.to_api_repr()
+        self.assertEqual(
+            resource,
+            {
+                "copy": {
+                    "destinationEncryptionConfiguration": {
+                        "kmsKeyName": self.KMS_KEY_NAME
+                    }
+                }
+            },
+        )
+
+    def test_to_api_repr_with_encryption_none(self):
+        config = self._make_one()
+        config.destination_encryption_configuration = None
+        resource = config.to_api_repr()
+        self.assertEqual(
+            resource, {"copy": {"destinationEncryptionConfiguration": None}}
+        )
+
+
+class TestCopyJob(unittest.TestCase, _Base):
+    JOB_TYPE = "copy"
+    SOURCE_TABLE = "source_table"
+    DESTINATION_TABLE = "destination_table"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import CopyJob
+
+        return CopyJob
+
+    def _make_resource(self, started=False, ended=False):
+        resource = super(TestCopyJob, self)._make_resource(started, ended)
+        config = resource["configuration"]["copy"]
+        config["sourceTables"] = [
+            {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.SOURCE_TABLE,
+            }
+        ]
+        config["destinationTable"] = {
+            "projectId": self.PROJECT,
+            "datasetId": self.DS_ID,
+            "tableId": self.DESTINATION_TABLE,
+        }
+
+        return resource
+
+    def _verifyResourceProperties(self, job, resource):
+        self._verifyReadonlyResourceProperties(job, resource)
+
+        config = resource.get("configuration", {}).get("copy")
+
+        table_ref = config["destinationTable"]
+        self.assertEqual(job.destination.project, table_ref["projectId"])
+        self.assertEqual(job.destination.dataset_id, table_ref["datasetId"])
+        self.assertEqual(job.destination.table_id, table_ref["tableId"])
+
+        sources = config.get("sourceTables")
+        if sources is None:
+            sources = [config["sourceTable"]]
+        self.assertEqual(len(sources), len(job.sources))
+        for table_ref, table in zip(sources, job.sources):
+            self.assertEqual(table.project, table_ref["projectId"])
+            self.assertEqual(table.dataset_id, table_ref["datasetId"])
+            self.assertEqual(table.table_id, table_ref["tableId"])
+
+        if "createDisposition" in config:
+            self.assertEqual(job.create_disposition, config["createDisposition"])
+        else:
+            self.assertIsNone(job.create_disposition)
+
+        if "writeDisposition" in config:
+            self.assertEqual(job.write_disposition, config["writeDisposition"])
+        else:
+            self.assertIsNone(job.write_disposition)
+
+        if "destinationEncryptionConfiguration" in config:
+            self.assertIsNotNone(job.destination_encryption_configuration)
+            self.assertEqual(
+                job.destination_encryption_configuration.kms_key_name,
+                config["destinationEncryptionConfiguration"]["kmsKeyName"],
+            )
+        else:
+            self.assertIsNone(job.destination_encryption_configuration)
+
+    def test_ctor(self):
+        client = _make_client(project=self.PROJECT)
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        job = self._make_one(self.JOB_ID, [source], destination, client)
+        self.assertIs(job.destination, destination)
+        self.assertEqual(job.sources, [source])
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_type, self.JOB_TYPE)
+        self.assertEqual(job.path, "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID))
+
+        self._verifyInitialReadonlyProperties(job)
+
+        # set/read from resource['configuration']['copy']
+        self.assertIsNone(job.create_disposition)
+        self.assertIsNone(job.write_disposition)
+        self.assertIsNone(job.destination_encryption_configuration)
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_missing_config(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+        }
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "copy": {
+                    "sourceTables": [
+                        {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": self.SOURCE_TABLE,
+                        }
+                    ],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.DESTINATION_TABLE,
+                    },
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_with_encryption(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "copy": {
+                    "sourceTables": [
+                        {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": self.SOURCE_TABLE,
+                        }
+                    ],
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.DESTINATION_TABLE,
+                    },
+                    "destinationEncryptionConfiguration": {
+                        "kmsKeyName": self.KMS_KEY_NAME
+                    },
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_repr_w_sourcetable(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "copy": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.SOURCE_TABLE,
+                    },
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.DESTINATION_TABLE,
+                    },
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_repr_wo_sources(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "copy": {
+                    "destinationTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.DESTINATION_TABLE,
+                    }
+                }
+            },
+        }
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_w_properties(self):
+        from google.cloud.bigquery.job import CreateDisposition
+
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = self._make_resource()
+        copy_config = RESOURCE["configuration"]["copy"]
+        copy_config["createDisposition"] = CreateDisposition.CREATE_IF_NEEDED
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_bound_client(self):
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        job = self._make_one(self.JOB_ID, [source], destination, client)
+
+        job._begin()
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "copy": {
+                        "sourceTables": [
+                            {
+                                "projectId": self.PROJECT,
+                                "datasetId": self.DS_ID,
+                                "tableId": self.SOURCE_TABLE,
+                            }
+                        ],
+                        "destinationTable": {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": self.DESTINATION_TABLE,
+                        },
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_alternate_client(self):
+        from google.cloud.bigquery.job import CopyJobConfig
+
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import WriteDisposition
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource(ended=True)
+        COPY_CONFIGURATION = {
+            "sourceTables": [
+                {
+                    "projectId": self.PROJECT,
+                    "datasetId": self.DS_ID,
+                    "tableId": self.SOURCE_TABLE,
+                }
+            ],
+            "destinationTable": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.DESTINATION_TABLE,
+            },
+            "createDisposition": CreateDisposition.CREATE_NEVER,
+            "writeDisposition": WriteDisposition.WRITE_TRUNCATE,
+        }
+        RESOURCE["configuration"]["copy"] = COPY_CONFIGURATION
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        config = CopyJobConfig()
+        config.create_disposition = CreateDisposition.CREATE_NEVER
+        config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+        job = self._make_one(self.JOB_ID, [source], destination, client1, config)
+        job._begin(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {"copy": COPY_CONFIGURATION},
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_exists_miss_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn = _make_connection()
+        client = _make_client(project=self.PROJECT, connection=conn)
+
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        job = self._make_one(self.JOB_ID, [source], destination, client)
+
+        self.assertFalse(job.exists())
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_exists_hit_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection({})
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        job = self._make_one(self.JOB_ID, [source], destination, client1)
+
+        self.assertTrue(job.exists(client=client2))
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_reload_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource()
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        job = self._make_one(self.JOB_ID, [source], destination, client)
+
+        job.reload()
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource()
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        source = self._table_ref(self.SOURCE_TABLE)
+        destination = self._table_ref(self.DESTINATION_TABLE)
+        job = self._make_one(self.JOB_ID, [source], destination, client1)
+
+        job.reload(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+
+class TestExtractJobConfig(unittest.TestCase, _Base):
+    JOB_TYPE = "extract"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import ExtractJobConfig
+
+        return ExtractJobConfig
+
+    def test_ctor_w_properties(self):
+        config = self._get_target_class()(field_delimiter="\t", print_header=True)
+
+        self.assertEqual(config.field_delimiter, "\t")
+        self.assertTrue(config.print_header)
+
+    def test_to_api_repr(self):
+        from google.cloud.bigquery import job
+
+        config = self._make_one()
+        config.compression = job.Compression.SNAPPY
+        config.destination_format = job.DestinationFormat.AVRO
+        config.field_delimiter = "ignored for avro"
+        config.print_header = False
+        config._properties["extract"]["someNewField"] = "some-value"
+        resource = config.to_api_repr()
+        self.assertEqual(
+            resource,
+            {
+                "extract": {
+                    "compression": "SNAPPY",
+                    "destinationFormat": "AVRO",
+                    "fieldDelimiter": "ignored for avro",
+                    "printHeader": False,
+                    "someNewField": "some-value",
+                }
+            },
+        )
+
+    def test_from_api_repr(self):
+        cls = self._get_target_class()
+        config = cls.from_api_repr(
+            {
+                "extract": {
+                    "compression": "NONE",
+                    "destinationFormat": "CSV",
+                    "fieldDelimiter": "\t",
+                    "printHeader": True,
+                    "someNewField": "some-value",
+                }
+            }
+        )
+        self.assertEqual(config.compression, "NONE")
+        self.assertEqual(config.destination_format, "CSV")
+        self.assertEqual(config.field_delimiter, "\t")
+        self.assertEqual(config.print_header, True)
+        self.assertEqual(config._properties["extract"]["someNewField"], "some-value")
+
+
+class TestExtractJob(unittest.TestCase, _Base):
+    JOB_TYPE = "extract"
+    SOURCE_TABLE = "source_table"
+    DESTINATION_URI = "gs://bucket_name/object_name"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import ExtractJob
+
+        return ExtractJob
+
+    def _make_resource(self, started=False, ended=False):
+        resource = super(TestExtractJob, self)._make_resource(started, ended)
+        config = resource["configuration"]["extract"]
+        config["sourceTable"] = {
+            "projectId": self.PROJECT,
+            "datasetId": self.DS_ID,
+            "tableId": self.SOURCE_TABLE,
+        }
+        config["destinationUris"] = [self.DESTINATION_URI]
+        return resource
+
+    def _verifyResourceProperties(self, job, resource):
+        self._verifyReadonlyResourceProperties(job, resource)
+
+        config = resource.get("configuration", {}).get("extract")
+
+        self.assertEqual(job.destination_uris, config["destinationUris"])
+
+        table_ref = config["sourceTable"]
+        self.assertEqual(job.source.project, table_ref["projectId"])
+        self.assertEqual(job.source.dataset_id, table_ref["datasetId"])
+        self.assertEqual(job.source.table_id, table_ref["tableId"])
+
+        if "compression" in config:
+            self.assertEqual(job.compression, config["compression"])
+        else:
+            self.assertIsNone(job.compression)
+
+        if "destinationFormat" in config:
+            self.assertEqual(job.destination_format, config["destinationFormat"])
+        else:
+            self.assertIsNone(job.destination_format)
+
+        if "fieldDelimiter" in config:
+            self.assertEqual(job.field_delimiter, config["fieldDelimiter"])
+        else:
+            self.assertIsNone(job.field_delimiter)
+
+        if "printHeader" in config:
+            self.assertEqual(job.print_header, config["printHeader"])
+        else:
+            self.assertIsNone(job.print_header)
+
+    def test_ctor(self):
+        from google.cloud.bigquery.table import Table
+
+        client = _make_client(project=self.PROJECT)
+        source = Table(self.TABLE_REF)
+        job = self._make_one(self.JOB_ID, source, [self.DESTINATION_URI], client)
+        self.assertEqual(job.source.project, self.PROJECT)
+        self.assertEqual(job.source.dataset_id, self.DS_ID)
+        self.assertEqual(job.source.table_id, self.TABLE_ID)
+        self.assertEqual(job.destination_uris, [self.DESTINATION_URI])
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_type, self.JOB_TYPE)
+        self.assertEqual(job.path, "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID))
+
+        self._verifyInitialReadonlyProperties(job)
+
+        # set/read from resource['configuration']['extract']
+        self.assertIsNone(job.compression)
+        self.assertIsNone(job.destination_format)
+        self.assertIsNone(job.field_delimiter)
+        self.assertIsNone(job.print_header)
+
+    def test_destination_uri_file_counts(self):
+        file_counts = 23
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(
+            self.JOB_ID, self.TABLE_REF, [self.DESTINATION_URI], client
+        )
+        self.assertIsNone(job.destination_uri_file_counts)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.destination_uri_file_counts)
+
+        extract_stats = statistics["extract"] = {}
+        self.assertIsNone(job.destination_uri_file_counts)
+
+        extract_stats["destinationUriFileCounts"] = [str(file_counts)]
+        self.assertEqual(job.destination_uri_file_counts, [file_counts])
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_missing_config(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+        }
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "extract": {
+                    "sourceTable": {
+                        "projectId": self.PROJECT,
+                        "datasetId": self.DS_ID,
+                        "tableId": self.SOURCE_TABLE,
+                    },
+                    "destinationUris": [self.DESTINATION_URI],
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_repr_w_properties(self):
+        from google.cloud.bigquery.job import Compression
+
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = self._make_resource()
+        extract_config = RESOURCE["configuration"]["extract"]
+        extract_config["compression"] = Compression.GZIP
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_bound_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        source_dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        source = source_dataset.table(self.SOURCE_TABLE)
+        job = self._make_one(self.JOB_ID, source, [self.DESTINATION_URI], client)
+
+        job._begin()
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "extract": {
+                        "sourceTable": {
+                            "projectId": self.PROJECT,
+                            "datasetId": self.DS_ID,
+                            "tableId": self.SOURCE_TABLE,
+                        },
+                        "destinationUris": [self.DESTINATION_URI],
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_alternate_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+        from google.cloud.bigquery.job import Compression
+        from google.cloud.bigquery.job import DestinationFormat
+        from google.cloud.bigquery.job import ExtractJobConfig
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource(ended=True)
+        EXTRACT_CONFIGURATION = {
+            "sourceTable": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.SOURCE_TABLE,
+            },
+            "destinationUris": [self.DESTINATION_URI],
+            "compression": Compression.GZIP,
+            "destinationFormat": DestinationFormat.NEWLINE_DELIMITED_JSON,
+            "fieldDelimiter": "|",
+            "printHeader": False,
+        }
+        RESOURCE["configuration"]["extract"] = EXTRACT_CONFIGURATION
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        source_dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        source = source_dataset.table(self.SOURCE_TABLE)
+        config = ExtractJobConfig()
+        config.compression = Compression.GZIP
+        config.destination_format = DestinationFormat.NEWLINE_DELIMITED_JSON
+        config.field_delimiter = "|"
+        config.print_header = False
+        job = self._make_one(
+            self.JOB_ID, source, [self.DESTINATION_URI], client1, config
+        )
+
+        job._begin(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {"extract": EXTRACT_CONFIGURATION},
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_exists_miss_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn = _make_connection()
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(
+            self.JOB_ID, self.TABLE_REF, [self.DESTINATION_URI], client
+        )
+
+        self.assertFalse(job.exists())
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_exists_hit_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection({})
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        job = self._make_one(
+            self.JOB_ID, self.TABLE_REF, [self.DESTINATION_URI], client1
+        )
+
+        self.assertTrue(job.exists(client=client2))
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_reload_w_bound_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource()
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        source_dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        source = source_dataset.table(self.SOURCE_TABLE)
+        job = self._make_one(self.JOB_ID, source, [self.DESTINATION_URI], client)
+
+        job.reload()
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        RESOURCE = self._make_resource()
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        source_dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        source = source_dataset.table(self.SOURCE_TABLE)
+        job = self._make_one(self.JOB_ID, source, [self.DESTINATION_URI], client1)
+
+        job.reload(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+
+class TestQueryJobConfig(unittest.TestCase, _Base):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import QueryJobConfig
+
+        return QueryJobConfig
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        config = self._make_one()
+        self.assertEqual(config._properties, {"query": {}})
+
+    def test_ctor_w_none(self):
+        config = self._make_one()
+        config.default_dataset = None
+        config.destination = None
+        self.assertIsNone(config.default_dataset)
+        self.assertIsNone(config.destination)
+
+    def test_ctor_w_properties(self):
+        config = self._get_target_class()(use_query_cache=False, use_legacy_sql=True)
+
+        self.assertFalse(config.use_query_cache)
+        self.assertTrue(config.use_legacy_sql)
+
+    def test_ctor_w_string_default_dataset(self):
+        from google.cloud.bigquery import dataset
+
+        default_dataset = "default-proj.default_dset"
+        config = self._get_target_class()(default_dataset=default_dataset)
+        expected = dataset.DatasetReference.from_string(default_dataset)
+        self.assertEqual(config.default_dataset, expected)
+
+    def test_ctor_w_string_destinaton(self):
+        from google.cloud.bigquery import table
+
+        destination = "dest-proj.dest_dset.dest_tbl"
+        config = self._get_target_class()(destination=destination)
+        expected = table.TableReference.from_string(destination)
+        self.assertEqual(config.destination, expected)
+
+    def test_default_dataset_w_string(self):
+        from google.cloud.bigquery import dataset
+
+        default_dataset = "default-proj.default_dset"
+        config = self._make_one()
+        config.default_dataset = default_dataset
+        expected = dataset.DatasetReference.from_string(default_dataset)
+        self.assertEqual(config.default_dataset, expected)
+
+    def test_default_dataset_w_dataset(self):
+        from google.cloud.bigquery import dataset
+
+        default_dataset = "default-proj.default_dset"
+        expected = dataset.DatasetReference.from_string(default_dataset)
+        config = self._make_one()
+        config.default_dataset = dataset.Dataset(expected)
+        self.assertEqual(config.default_dataset, expected)
+
+    def test_destinaton_w_string(self):
+        from google.cloud.bigquery import table
+
+        destination = "dest-proj.dest_dset.dest_tbl"
+        config = self._make_one()
+        config.destination = destination
+        expected = table.TableReference.from_string(destination)
+        self.assertEqual(config.destination, expected)
+
+    def test_time_partitioning(self):
+        from google.cloud.bigquery import table
+
+        time_partitioning = table.TimePartitioning(
+            type_=table.TimePartitioningType.DAY, field="name"
+        )
+        config = self._make_one()
+        config.time_partitioning = time_partitioning
+        # TimePartitioning should be configurable after assigning
+        time_partitioning.expiration_ms = 10000
+
+        self.assertEqual(config.time_partitioning.type_, table.TimePartitioningType.DAY)
+        self.assertEqual(config.time_partitioning.field, "name")
+        self.assertEqual(config.time_partitioning.expiration_ms, 10000)
+
+        config.time_partitioning = None
+        self.assertIsNone(config.time_partitioning)
+
+    def test_clustering_fields(self):
+        fields = ["email", "postal_code"]
+        config = self._get_target_class()()
+        config.clustering_fields = fields
+        self.assertEqual(config.clustering_fields, fields)
+
+        config.clustering_fields = None
+        self.assertIsNone(config.clustering_fields)
+
+    def test_from_api_repr_empty(self):
+        klass = self._get_target_class()
+        config = klass.from_api_repr({})
+        self.assertIsNone(config.dry_run)
+        self.assertIsNone(config.use_legacy_sql)
+        self.assertIsNone(config.default_dataset)
+        self.assertIsNone(config.destination)
+        self.assertIsNone(config.destination_encryption_configuration)
+
+    def test_from_api_repr_normal(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        resource = {
+            "query": {
+                "useLegacySql": True,
+                "query": "no property for me",
+                "defaultDataset": {
+                    "projectId": "someproject",
+                    "datasetId": "somedataset",
+                },
+                "someNewProperty": "I should be saved, too.",
+            },
+            "dryRun": True,
+        }
+        klass = self._get_target_class()
+
+        config = klass.from_api_repr(resource)
+
+        self.assertTrue(config.use_legacy_sql)
+        self.assertEqual(
+            config.default_dataset, DatasetReference("someproject", "somedataset")
+        )
+        self.assertTrue(config.dry_run)
+        # Make sure unknown properties propagate.
+        self.assertEqual(config._properties["query"]["query"], "no property for me")
+        self.assertEqual(
+            config._properties["query"]["someNewProperty"], "I should be saved, too."
+        )
+
+    def test_to_api_repr_normal(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        config = self._make_one()
+        config.use_legacy_sql = True
+        config.default_dataset = DatasetReference("someproject", "somedataset")
+        config.dry_run = False
+        config._properties["someNewProperty"] = "Woohoo, alpha stuff."
+
+        resource = config.to_api_repr()
+
+        self.assertFalse(resource["dryRun"])
+        self.assertTrue(resource["query"]["useLegacySql"])
+        self.assertEqual(
+            resource["query"]["defaultDataset"]["projectId"], "someproject"
+        )
+        self.assertEqual(
+            resource["query"]["defaultDataset"]["datasetId"], "somedataset"
+        )
+        # Make sure unknown properties propagate.
+        self.assertEqual(resource["someNewProperty"], "Woohoo, alpha stuff.")
+
+    def test_to_api_repr_with_encryption(self):
+        from google.cloud.bigquery.table import EncryptionConfiguration
+
+        config = self._make_one()
+        config.destination_encryption_configuration = EncryptionConfiguration(
+            kms_key_name=self.KMS_KEY_NAME
+        )
+        resource = config.to_api_repr()
+        self.assertEqual(
+            resource,
+            {
+                "query": {
+                    "destinationEncryptionConfiguration": {
+                        "kmsKeyName": self.KMS_KEY_NAME
+                    }
+                }
+            },
+        )
+
+    def test_to_api_repr_with_encryption_none(self):
+        config = self._make_one()
+        config.destination_encryption_configuration = None
+        resource = config.to_api_repr()
+        self.assertEqual(
+            resource, {"query": {"destinationEncryptionConfiguration": None}}
+        )
+
+    def test_from_api_repr_with_encryption(self):
+        resource = {
+            "query": {
+                "destinationEncryptionConfiguration": {"kmsKeyName": self.KMS_KEY_NAME}
+            }
+        }
+        klass = self._get_target_class()
+        config = klass.from_api_repr(resource)
+        self.assertEqual(
+            config.destination_encryption_configuration.kms_key_name, self.KMS_KEY_NAME
+        )
+
+
+class TestQueryJob(unittest.TestCase, _Base):
+    JOB_TYPE = "query"
+    QUERY = "select count(*) from persons"
+    DESTINATION_TABLE = "destination_table"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import QueryJob
+
+        return QueryJob
+
+    def _make_resource(self, started=False, ended=False):
+        resource = super(TestQueryJob, self)._make_resource(started, ended)
+        config = resource["configuration"]["query"]
+        config["query"] = self.QUERY
+
+        if ended:
+            resource["status"] = {"state": "DONE"}
+
+        return resource
+
+    def _verifyBooleanResourceProperties(self, job, config):
+
+        if "allowLargeResults" in config:
+            self.assertEqual(job.allow_large_results, config["allowLargeResults"])
+        else:
+            self.assertIsNone(job.allow_large_results)
+        if "flattenResults" in config:
+            self.assertEqual(job.flatten_results, config["flattenResults"])
+        else:
+            self.assertIsNone(job.flatten_results)
+        if "useQueryCache" in config:
+            self.assertEqual(job.use_query_cache, config["useQueryCache"])
+        else:
+            self.assertIsNone(job.use_query_cache)
+        if "useLegacySql" in config:
+            self.assertEqual(job.use_legacy_sql, config["useLegacySql"])
+        else:
+            self.assertIsNone(job.use_legacy_sql)
+
+    def _verifyIntegerResourceProperties(self, job, config):
+        if "maximumBillingTier" in config:
+            self.assertEqual(job.maximum_billing_tier, config["maximumBillingTier"])
+        else:
+            self.assertIsNone(job.maximum_billing_tier)
+        if "maximumBytesBilled" in config:
+            self.assertEqual(
+                str(job.maximum_bytes_billed), config["maximumBytesBilled"]
+            )
+            self.assertIsInstance(job.maximum_bytes_billed, int)
+        else:
+            self.assertIsNone(job.maximum_bytes_billed)
+
+    def _verify_udf_resources(self, job, config):
+        udf_resources = config.get("userDefinedFunctionResources", ())
+        self.assertEqual(len(job.udf_resources), len(udf_resources))
+        for found, expected in zip(job.udf_resources, udf_resources):
+            if "resourceUri" in expected:
+                self.assertEqual(found.udf_type, "resourceUri")
+                self.assertEqual(found.value, expected["resourceUri"])
+            else:
+                self.assertEqual(found.udf_type, "inlineCode")
+                self.assertEqual(found.value, expected["inlineCode"])
+
+    def _verifyQueryParameters(self, job, config):
+        query_parameters = config.get("queryParameters", ())
+        self.assertEqual(len(job.query_parameters), len(query_parameters))
+        for found, expected in zip(job.query_parameters, query_parameters):
+            self.assertEqual(found.to_api_repr(), expected)
+
+    def _verify_table_definitions(self, job, config):
+        table_defs = config.get("tableDefinitions")
+        if job.table_definitions is None:
+            self.assertIsNone(table_defs)
+        else:
+            self.assertEqual(len(job.table_definitions), len(table_defs))
+            for found_key, found_ec in job.table_definitions.items():
+                expected_ec = table_defs.get(found_key)
+                self.assertIsNotNone(expected_ec)
+                self.assertEqual(found_ec.to_api_repr(), expected_ec)
+
+    def _verify_configuration_properties(self, job, configuration):
+        if "dryRun" in configuration:
+            self.assertEqual(job.dry_run, configuration["dryRun"])
+        else:
+            self.assertIsNone(job.dry_run)
+
+    def _verifyResourceProperties(self, job, resource):
+        self._verifyReadonlyResourceProperties(job, resource)
+
+        configuration = resource.get("configuration", {})
+        self._verify_configuration_properties(job, configuration)
+
+        query_config = resource.get("configuration", {}).get("query")
+        self._verifyBooleanResourceProperties(job, query_config)
+        self._verifyIntegerResourceProperties(job, query_config)
+        self._verify_udf_resources(job, query_config)
+        self._verifyQueryParameters(job, query_config)
+        self._verify_table_definitions(job, query_config)
+
+        self.assertEqual(job.query, query_config["query"])
+        if "createDisposition" in query_config:
+            self.assertEqual(job.create_disposition, query_config["createDisposition"])
+        else:
+            self.assertIsNone(job.create_disposition)
+        if "defaultDataset" in query_config:
+            ds_ref = job.default_dataset
+            ds_ref = {"projectId": ds_ref.project, "datasetId": ds_ref.dataset_id}
+            self.assertEqual(ds_ref, query_config["defaultDataset"])
+        else:
+            self.assertIsNone(job.default_dataset)
+        if "destinationTable" in query_config:
+            table = job.destination
+            tb_ref = {
+                "projectId": table.project,
+                "datasetId": table.dataset_id,
+                "tableId": table.table_id,
+            }
+            self.assertEqual(tb_ref, query_config["destinationTable"])
+        else:
+            self.assertIsNone(job.destination)
+        if "priority" in query_config:
+            self.assertEqual(job.priority, query_config["priority"])
+        else:
+            self.assertIsNone(job.priority)
+        if "writeDisposition" in query_config:
+            self.assertEqual(job.write_disposition, query_config["writeDisposition"])
+        else:
+            self.assertIsNone(job.write_disposition)
+        if "destinationEncryptionConfiguration" in query_config:
+            self.assertIsNotNone(job.destination_encryption_configuration)
+            self.assertEqual(
+                job.destination_encryption_configuration.kms_key_name,
+                query_config["destinationEncryptionConfiguration"]["kmsKeyName"],
+            )
+        else:
+            self.assertIsNone(job.destination_encryption_configuration)
+        if "schemaUpdateOptions" in query_config:
+            self.assertEqual(
+                job.schema_update_options, query_config["schemaUpdateOptions"]
+            )
+        else:
+            self.assertIsNone(job.schema_update_options)
+
+    def test_ctor_defaults(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertEqual(job.query, self.QUERY)
+        self.assertIs(job._client, client)
+        self.assertEqual(job.job_type, self.JOB_TYPE)
+        self.assertEqual(job.path, "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID))
+
+        self._verifyInitialReadonlyProperties(job)
+
+        self.assertFalse(job.use_legacy_sql)
+
+        # set/read from resource['configuration']['query']
+        self.assertIsNone(job.allow_large_results)
+        self.assertIsNone(job.create_disposition)
+        self.assertIsNone(job.default_dataset)
+        self.assertIsNone(job.destination)
+        self.assertIsNone(job.flatten_results)
+        self.assertIsNone(job.priority)
+        self.assertIsNone(job.use_query_cache)
+        self.assertIsNone(job.dry_run)
+        self.assertIsNone(job.write_disposition)
+        self.assertIsNone(job.maximum_billing_tier)
+        self.assertIsNone(job.maximum_bytes_billed)
+        self.assertIsNone(job.table_definitions)
+        self.assertIsNone(job.destination_encryption_configuration)
+        self.assertIsNone(job.time_partitioning)
+        self.assertIsNone(job.clustering_fields)
+        self.assertIsNone(job.schema_update_options)
+
+    def test_ctor_w_udf_resources(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import UDFResource
+
+        RESOURCE_URI = "gs://some-bucket/js/lib.js"
+        udf_resources = [UDFResource("resourceUri", RESOURCE_URI)]
+        client = _make_client(project=self.PROJECT)
+        config = QueryJobConfig()
+        config.udf_resources = udf_resources
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=config)
+        self.assertEqual(job.udf_resources, udf_resources)
+
+    def test_ctor_w_query_parameters(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        query_parameters = [ScalarQueryParameter("foo", "INT64", 123)]
+        client = _make_client(project=self.PROJECT)
+        config = QueryJobConfig(query_parameters=query_parameters)
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=config)
+        self.assertEqual(job.query_parameters, query_parameters)
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_missing_config(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": "%s:%s" % (self.PROJECT, self.DS_ID),
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+        }
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {"query": {"query": self.QUERY}},
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_repr_with_encryption(self):
+        self._setUpConstants()
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = {
+            "id": self.JOB_ID,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "configuration": {
+                "query": {
+                    "query": self.QUERY,
+                    "destinationEncryptionConfiguration": {
+                        "kmsKeyName": self.KMS_KEY_NAME
+                    },
+                }
+            },
+        }
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_from_api_repr_w_properties(self):
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import SchemaUpdateOption
+        from google.cloud.bigquery.job import WriteDisposition
+
+        client = _make_client(project=self.PROJECT)
+        RESOURCE = self._make_resource()
+        query_config = RESOURCE["configuration"]["query"]
+        query_config["createDisposition"] = CreateDisposition.CREATE_IF_NEEDED
+        query_config["writeDisposition"] = WriteDisposition.WRITE_TRUNCATE
+        query_config["destinationTable"] = {
+            "projectId": self.PROJECT,
+            "datasetId": self.DS_ID,
+            "tableId": self.DESTINATION_TABLE,
+        }
+        query_config["schemaUpdateOptions"] = [SchemaUpdateOption.ALLOW_FIELD_ADDITION]
+        klass = self._get_target_class()
+        job = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(job._client, client)
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_cancelled(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        job._properties["status"] = {
+            "state": "DONE",
+            "errorResult": {"reason": "stopped"},
+        }
+
+        self.assertTrue(job.cancelled())
+
+    def test_done(self):
+        client = _make_client(project=self.PROJECT)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+        self.assertTrue(job.done())
+
+    def test_query_plan(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+        from google.cloud.bigquery.job import QueryPlanEntry
+        from google.cloud.bigquery.job import QueryPlanEntryStep
+
+        plan_entries = [
+            {
+                "name": "NAME",
+                "id": "1234",
+                "inputStages": ["88", "101"],
+                "startMs": "1522540800000",
+                "endMs": "1522540804000",
+                "parallelInputs": "1000",
+                "completedParallelInputs": "5",
+                "waitMsAvg": "33",
+                "waitMsMax": "400",
+                "waitRatioAvg": 2.71828,
+                "waitRatioMax": 3.14159,
+                "readMsAvg": "45",
+                "readMsMax": "90",
+                "readRatioAvg": 1.41421,
+                "readRatioMax": 1.73205,
+                "computeMsAvg": "55",
+                "computeMsMax": "99",
+                "computeRatioAvg": 0.69315,
+                "computeRatioMax": 1.09861,
+                "writeMsAvg": "203",
+                "writeMsMax": "340",
+                "writeRatioAvg": 3.32193,
+                "writeRatioMax": 2.30258,
+                "recordsRead": "100",
+                "recordsWritten": "1",
+                "status": "STATUS",
+                "shuffleOutputBytes": "1024",
+                "shuffleOutputBytesSpilled": "1",
+                "steps": [{"kind": "KIND", "substeps": ["SUBSTEP1", "SUBSTEP2"]}],
+            }
+        ]
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertEqual(job.query_plan, [])
+
+        statistics = job._properties["statistics"] = {}
+        self.assertEqual(job.query_plan, [])
+
+        query_stats = statistics["query"] = {}
+        self.assertEqual(job.query_plan, [])
+
+        query_stats["queryPlan"] = plan_entries
+
+        self.assertEqual(len(job.query_plan), len(plan_entries))
+        for found, expected in zip(job.query_plan, plan_entries):
+            self.assertIsInstance(found, QueryPlanEntry)
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.entry_id, expected["id"])
+            self.assertEqual(len(found.input_stages), len(expected["inputStages"]))
+            for f_id in found.input_stages:
+                self.assertIn(f_id, [int(e) for e in expected["inputStages"]])
+            self.assertEqual(
+                found.start.strftime(_RFC3339_MICROS), "2018-04-01T00:00:00.000000Z"
+            )
+            self.assertEqual(
+                found.end.strftime(_RFC3339_MICROS), "2018-04-01T00:00:04.000000Z"
+            )
+            self.assertEqual(found.parallel_inputs, int(expected["parallelInputs"]))
+            self.assertEqual(
+                found.completed_parallel_inputs,
+                int(expected["completedParallelInputs"]),
+            )
+            self.assertEqual(found.wait_ms_avg, int(expected["waitMsAvg"]))
+            self.assertEqual(found.wait_ms_max, int(expected["waitMsMax"]))
+            self.assertEqual(found.wait_ratio_avg, expected["waitRatioAvg"])
+            self.assertEqual(found.wait_ratio_max, expected["waitRatioMax"])
+            self.assertEqual(found.read_ms_avg, int(expected["readMsAvg"]))
+            self.assertEqual(found.read_ms_max, int(expected["readMsMax"]))
+            self.assertEqual(found.read_ratio_avg, expected["readRatioAvg"])
+            self.assertEqual(found.read_ratio_max, expected["readRatioMax"])
+            self.assertEqual(found.compute_ms_avg, int(expected["computeMsAvg"]))
+            self.assertEqual(found.compute_ms_max, int(expected["computeMsMax"]))
+            self.assertEqual(found.compute_ratio_avg, expected["computeRatioAvg"])
+            self.assertEqual(found.compute_ratio_max, expected["computeRatioMax"])
+            self.assertEqual(found.write_ms_avg, int(expected["writeMsAvg"]))
+            self.assertEqual(found.write_ms_max, int(expected["writeMsMax"]))
+            self.assertEqual(found.write_ratio_avg, expected["writeRatioAvg"])
+            self.assertEqual(found.write_ratio_max, expected["writeRatioMax"])
+            self.assertEqual(found.records_read, int(expected["recordsRead"]))
+            self.assertEqual(found.records_written, int(expected["recordsWritten"]))
+            self.assertEqual(found.status, expected["status"])
+            self.assertEqual(
+                found.shuffle_output_bytes, int(expected["shuffleOutputBytes"])
+            )
+            self.assertEqual(
+                found.shuffle_output_bytes_spilled,
+                int(expected["shuffleOutputBytesSpilled"]),
+            )
+
+            self.assertEqual(len(found.steps), len(expected["steps"]))
+            for f_step, e_step in zip(found.steps, expected["steps"]):
+                self.assertIsInstance(f_step, QueryPlanEntryStep)
+                self.assertEqual(f_step.kind, e_step["kind"])
+                self.assertEqual(f_step.substeps, e_step["substeps"])
+
+    def test_total_bytes_processed(self):
+        total_bytes = 1234
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.total_bytes_processed)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.total_bytes_processed)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.total_bytes_processed)
+
+        query_stats["totalBytesProcessed"] = str(total_bytes)
+        self.assertEqual(job.total_bytes_processed, total_bytes)
+
+    def test_total_bytes_billed(self):
+        total_bytes = 1234
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.total_bytes_billed)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.total_bytes_billed)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.total_bytes_billed)
+
+        query_stats["totalBytesBilled"] = str(total_bytes)
+        self.assertEqual(job.total_bytes_billed, total_bytes)
+
+    def test_billing_tier(self):
+        billing_tier = 1
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.billing_tier)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.billing_tier)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.billing_tier)
+
+        query_stats["billingTier"] = billing_tier
+        self.assertEqual(job.billing_tier, billing_tier)
+
+    def test_cache_hit(self):
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.cache_hit)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.cache_hit)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.cache_hit)
+
+        query_stats["cacheHit"] = True
+        self.assertTrue(job.cache_hit)
+
+    def test_ddl_operation_performed(self):
+        op = "SKIP"
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.ddl_operation_performed)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.ddl_operation_performed)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.ddl_operation_performed)
+
+        query_stats["ddlOperationPerformed"] = op
+        self.assertEqual(job.ddl_operation_performed, op)
+
+    def test_ddl_target_routine(self):
+        from google.cloud.bigquery.routine import RoutineReference
+
+        ref_routine = {
+            "projectId": self.PROJECT,
+            "datasetId": "ddl_ds",
+            "routineId": "targetroutine",
+        }
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.ddl_target_routine)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.ddl_target_routine)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.ddl_target_routine)
+
+        query_stats["ddlTargetRoutine"] = ref_routine
+        self.assertIsInstance(job.ddl_target_routine, RoutineReference)
+        self.assertEqual(job.ddl_target_routine.routine_id, "targetroutine")
+        self.assertEqual(job.ddl_target_routine.dataset_id, "ddl_ds")
+        self.assertEqual(job.ddl_target_routine.project, self.PROJECT)
+
+    def test_ddl_target_table(self):
+        from google.cloud.bigquery.table import TableReference
+
+        ref_table = {
+            "projectId": self.PROJECT,
+            "datasetId": "ddl_ds",
+            "tableId": "targettable",
+        }
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.ddl_target_table)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.ddl_target_table)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.ddl_target_table)
+
+        query_stats["ddlTargetTable"] = ref_table
+        self.assertIsInstance(job.ddl_target_table, TableReference)
+        self.assertEqual(job.ddl_target_table.table_id, "targettable")
+        self.assertEqual(job.ddl_target_table.dataset_id, "ddl_ds")
+        self.assertEqual(job.ddl_target_table.project, self.PROJECT)
+
+    def test_num_dml_affected_rows(self):
+        num_rows = 1234
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.num_dml_affected_rows)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.num_dml_affected_rows)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.num_dml_affected_rows)
+
+        query_stats["numDmlAffectedRows"] = str(num_rows)
+        self.assertEqual(job.num_dml_affected_rows, num_rows)
+
+    def test_slot_millis(self):
+        millis = 1234
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.slot_millis)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.slot_millis)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.slot_millis)
+
+        query_stats["totalSlotMs"] = millis
+        self.assertEqual(job.slot_millis, millis)
+
+    def test_statement_type(self):
+        statement_type = "SELECT"
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.statement_type)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.statement_type)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.statement_type)
+
+        query_stats["statementType"] = statement_type
+        self.assertEqual(job.statement_type, statement_type)
+
+    def test_referenced_tables(self):
+        from google.cloud.bigquery.table import TableReference
+
+        ref_tables_resource = [
+            {"projectId": self.PROJECT, "datasetId": "dataset", "tableId": "local1"},
+            {"projectId": self.PROJECT, "datasetId": "dataset", "tableId": "local2"},
+            {
+                "projectId": "other-project-123",
+                "datasetId": "other-dataset",
+                "tableId": "other-table",
+            },
+        ]
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertEqual(job.referenced_tables, [])
+
+        statistics = job._properties["statistics"] = {}
+        self.assertEqual(job.referenced_tables, [])
+
+        query_stats = statistics["query"] = {}
+        self.assertEqual(job.referenced_tables, [])
+
+        query_stats["referencedTables"] = ref_tables_resource
+
+        local1, local2, remote = job.referenced_tables
+
+        self.assertIsInstance(local1, TableReference)
+        self.assertEqual(local1.table_id, "local1")
+        self.assertEqual(local1.dataset_id, "dataset")
+        self.assertEqual(local1.project, self.PROJECT)
+
+        self.assertIsInstance(local2, TableReference)
+        self.assertEqual(local2.table_id, "local2")
+        self.assertEqual(local2.dataset_id, "dataset")
+        self.assertEqual(local2.project, self.PROJECT)
+
+        self.assertIsInstance(remote, TableReference)
+        self.assertEqual(remote.table_id, "other-table")
+        self.assertEqual(remote.dataset_id, "other-dataset")
+        self.assertEqual(remote.project, "other-project-123")
+
+    def test_timeline(self):
+        timeline_resource = [
+            {
+                "elapsedMs": 1,
+                "activeUnits": 22,
+                "pendingUnits": 33,
+                "completedUnits": 44,
+                "totalSlotMs": 101,
+            }
+        ]
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertEqual(job.timeline, [])
+
+        statistics = job._properties["statistics"] = {}
+        self.assertEqual(job.timeline, [])
+
+        query_stats = statistics["query"] = {}
+        self.assertEqual(job.timeline, [])
+
+        query_stats["timeline"] = timeline_resource
+
+        self.assertEqual(len(job.timeline), len(timeline_resource))
+        self.assertEqual(job.timeline[0].elapsed_ms, 1)
+        self.assertEqual(job.timeline[0].active_units, 22)
+        self.assertEqual(job.timeline[0].pending_units, 33)
+        self.assertEqual(job.timeline[0].completed_units, 44)
+        self.assertEqual(job.timeline[0].slot_millis, 101)
+
+    def test_undeclared_query_parameters(self):
+        from google.cloud.bigquery.query import ArrayQueryParameter
+        from google.cloud.bigquery.query import ScalarQueryParameter
+        from google.cloud.bigquery.query import StructQueryParameter
+
+        undeclared = [
+            {
+                "name": "my_scalar",
+                "parameterType": {"type": "STRING"},
+                "parameterValue": {"value": "value"},
+            },
+            {
+                "name": "my_array",
+                "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+                "parameterValue": {
+                    "arrayValues": [{"value": "1066"}, {"value": "1745"}]
+                },
+            },
+            {
+                "name": "my_struct",
+                "parameterType": {
+                    "type": "STRUCT",
+                    "structTypes": [{"name": "count", "type": {"type": "INT64"}}],
+                },
+                "parameterValue": {"structValues": {"count": {"value": "123"}}},
+            },
+        ]
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertEqual(job.undeclared_query_parameters, [])
+
+        statistics = job._properties["statistics"] = {}
+        self.assertEqual(job.undeclared_query_parameters, [])
+
+        query_stats = statistics["query"] = {}
+        self.assertEqual(job.undeclared_query_parameters, [])
+
+        query_stats["undeclaredQueryParameters"] = undeclared
+
+        scalar, array, struct = job.undeclared_query_parameters
+
+        self.assertIsInstance(scalar, ScalarQueryParameter)
+        self.assertEqual(scalar.name, "my_scalar")
+        self.assertEqual(scalar.type_, "STRING")
+        self.assertEqual(scalar.value, "value")
+
+        self.assertIsInstance(array, ArrayQueryParameter)
+        self.assertEqual(array.name, "my_array")
+        self.assertEqual(array.array_type, "INT64")
+        self.assertEqual(array.values, [1066, 1745])
+
+        self.assertIsInstance(struct, StructQueryParameter)
+        self.assertEqual(struct.name, "my_struct")
+        self.assertEqual(struct.struct_types, {"count": "INT64"})
+        self.assertEqual(struct.struct_values, {"count": 123})
+
+    def test_estimated_bytes_processed(self):
+        est_bytes = 123456
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+        self.assertIsNone(job.estimated_bytes_processed)
+
+        statistics = job._properties["statistics"] = {}
+        self.assertIsNone(job.estimated_bytes_processed)
+
+        query_stats = statistics["query"] = {}
+        self.assertIsNone(job.estimated_bytes_processed)
+
+        query_stats["estimatedBytesProcessed"] = str(est_bytes)
+        self.assertEqual(job.estimated_bytes_processed, est_bytes)
+
+    def test_result(self):
+        from google.cloud.bigquery.table import RowIterator
+
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "schema": {"fields": [{"name": "col1", "type": "STRING"}]},
+            "totalRows": "2",
+        }
+        tabledata_resource = {
+            # Explicitly set totalRows to be different from the query response.
+            # to test update during iteration.
+            "totalRows": "1",
+            "pageToken": None,
+            "rows": [{"f": [{"v": "abc"}]}],
+        }
+        connection = _make_connection(query_resource, tabledata_resource)
+        client = _make_client(self.PROJECT, connection=connection)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+
+        result = job.result()
+
+        self.assertIsInstance(result, RowIterator)
+        self.assertEqual(result.total_rows, 2)
+
+        rows = list(result)
+        self.assertEqual(len(rows), 1)
+        self.assertEqual(rows[0].col1, "abc")
+        # Test that the total_rows property has changed during iteration, based
+        # on the response from tabledata.list.
+        self.assertEqual(result.total_rows, 1)
+
+    def test_result_w_empty_schema(self):
+        from google.cloud.bigquery.table import _EmptyRowIterator
+
+        # Destination table may have no schema for some DDL and DML queries.
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "schema": {"fields": []},
+        }
+        connection = _make_connection(query_resource, query_resource)
+        client = _make_client(self.PROJECT, connection=connection)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+
+        result = job.result()
+
+        self.assertIsInstance(result, _EmptyRowIterator)
+        self.assertEqual(list(result), [])
+
+    def test_result_invokes_begins(self):
+        begun_resource = self._make_resource()
+        incomplete_resource = {
+            "jobComplete": False,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "schema": {"fields": [{"name": "col1", "type": "STRING"}]},
+        }
+        query_resource = copy.deepcopy(incomplete_resource)
+        query_resource["jobComplete"] = True
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(
+            begun_resource,
+            incomplete_resource,
+            query_resource,
+            done_resource,
+            query_resource,
+        )
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        job.result()
+
+        self.assertEqual(len(connection.api_request.call_args_list), 4)
+        begin_request = connection.api_request.call_args_list[0]
+        query_request = connection.api_request.call_args_list[2]
+        reload_request = connection.api_request.call_args_list[3]
+        self.assertEqual(begin_request[1]["method"], "POST")
+        self.assertEqual(query_request[1]["method"], "GET")
+        self.assertEqual(reload_request[1]["method"], "GET")
+
+    def test_result_w_timeout(self):
+        begun_resource = self._make_resource()
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "schema": {"fields": [{"name": "col1", "type": "STRING"}]},
+        }
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(begun_resource, query_resource, done_resource)
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        job.result(timeout=1.0)
+
+        self.assertEqual(len(connection.api_request.call_args_list), 3)
+        begin_request = connection.api_request.call_args_list[0]
+        query_request = connection.api_request.call_args_list[1]
+        reload_request = connection.api_request.call_args_list[2]
+        self.assertEqual(begin_request[1]["method"], "POST")
+        self.assertEqual(query_request[1]["method"], "GET")
+        self.assertEqual(
+            query_request[1]["path"],
+            "/projects/{}/queries/{}".format(self.PROJECT, self.JOB_ID),
+        )
+        self.assertEqual(query_request[1]["query_params"]["timeoutMs"], 900)
+        self.assertEqual(reload_request[1]["method"], "GET")
+
+    def test_result_w_page_size(self):
+        # Arrange
+        query_results_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "schema": {"fields": [{"name": "col1", "type": "STRING"}]},
+            "totalRows": "4",
+        }
+        job_resource = self._make_resource(started=True, ended=True)
+        q_config = job_resource["configuration"]["query"]
+        q_config["destinationTable"] = {
+            "projectId": self.PROJECT,
+            "datasetId": self.DS_ID,
+            "tableId": self.TABLE_ID,
+        }
+        tabledata_resource = {
+            "totalRows": 4,
+            "pageToken": "some-page-token",
+            "rows": [
+                {"f": [{"v": "row1"}]},
+                {"f": [{"v": "row2"}]},
+                {"f": [{"v": "row3"}]},
+            ],
+        }
+        tabledata_resource_page_2 = {"totalRows": 4, "rows": [{"f": [{"v": "row4"}]}]}
+        conn = _make_connection(
+            query_results_resource, tabledata_resource, tabledata_resource_page_2
+        )
+        client = _make_client(self.PROJECT, connection=conn)
+        job = self._get_target_class().from_api_repr(job_resource, client)
+
+        # Act
+        result = job.result(page_size=3)
+
+        # Assert
+        actual_rows = list(result)
+        self.assertEqual(len(actual_rows), 4)
+
+        tabledata_path = "/projects/%s/datasets/%s/tables/%s/data" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_ID,
+        )
+        conn.api_request.assert_has_calls(
+            [
+                mock.call(
+                    method="GET", path=tabledata_path, query_params={"maxResults": 3}
+                ),
+                mock.call(
+                    method="GET",
+                    path=tabledata_path,
+                    query_params={"pageToken": "some-page-token", "maxResults": 3},
+                ),
+            ]
+        )
+
+    def test_result_error(self):
+        from google.cloud import exceptions
+
+        query = textwrap.dedent(
+            """
+            SELECT foo, bar
+            FROM table_baz
+            WHERE foo == bar"""
+        )
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, query, client)
+        error_result = {
+            "debugInfo": "DEBUG",
+            "location": "LOCATION",
+            "message": "MESSAGE",
+            "reason": "invalid",
+        }
+        job._properties["status"] = {
+            "errorResult": error_result,
+            "errors": [error_result],
+            "state": "DONE",
+        }
+        job._set_future_result()
+
+        with self.assertRaises(exceptions.GoogleCloudError) as exc_info:
+            job.result()
+
+        self.assertIsInstance(exc_info.exception, exceptions.GoogleCloudError)
+        self.assertEqual(exc_info.exception.code, http_client.BAD_REQUEST)
+
+        full_text = str(exc_info.exception)
+
+        assert job.job_id in full_text
+        assert "Query Job SQL Follows" in full_text
+
+        for i, line in enumerate(query.splitlines(), start=1):
+            expected_line = "{}:{}".format(i, line)
+            assert expected_line in full_text
+
+    def test__begin_error(self):
+        from google.cloud import exceptions
+
+        query = textwrap.dedent(
+            """
+            SELECT foo, bar
+            FROM table_baz
+            WHERE foo == bar"""
+        )
+
+        client = _make_client(project=self.PROJECT)
+        job = self._make_one(self.JOB_ID, query, client)
+        call_api_patch = mock.patch(
+            "google.cloud.bigquery.client.Client._call_api",
+            autospec=True,
+            side_effect=exceptions.BadRequest("Syntax error in SQL query"),
+        )
+
+        with call_api_patch, self.assertRaises(exceptions.GoogleCloudError) as exc_info:
+            job.result()
+
+        self.assertIsInstance(exc_info.exception, exceptions.GoogleCloudError)
+        self.assertEqual(exc_info.exception.code, http_client.BAD_REQUEST)
+
+        full_text = str(exc_info.exception)
+
+        assert job.job_id in full_text
+        assert "Query Job SQL Follows" in full_text
+
+        for i, line in enumerate(query.splitlines(), start=1):
+            expected_line = "{}:{}".format(i, line)
+            assert expected_line in full_text
+
+    def test_begin_w_bound_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+        from google.cloud.bigquery.job import QueryJobConfig
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        DS_ID = "DATASET"
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+
+        config = QueryJobConfig()
+        config.default_dataset = DatasetReference(self.PROJECT, DS_ID)
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=config)
+
+        job._begin()
+
+        self.assertIsNone(job.default_dataset)
+        self.assertEqual(job.udf_resources, [])
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "query": {
+                        "query": self.QUERY,
+                        "useLegacySql": False,
+                        "defaultDataset": {
+                            "projectId": self.PROJECT,
+                            "datasetId": DS_ID,
+                        },
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_alternate_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+        from google.cloud.bigquery.job import CreateDisposition
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.job import QueryPriority
+        from google.cloud.bigquery.job import SchemaUpdateOption
+        from google.cloud.bigquery.job import WriteDisposition
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        TABLE = "TABLE"
+        DS_ID = "DATASET"
+        RESOURCE = self._make_resource(ended=True)
+        QUERY_CONFIGURATION = {
+            "query": self.QUERY,
+            "allowLargeResults": True,
+            "createDisposition": CreateDisposition.CREATE_NEVER,
+            "defaultDataset": {"projectId": self.PROJECT, "datasetId": DS_ID},
+            "destinationTable": {
+                "projectId": self.PROJECT,
+                "datasetId": DS_ID,
+                "tableId": TABLE,
+            },
+            "flattenResults": True,
+            "priority": QueryPriority.INTERACTIVE,
+            "useQueryCache": True,
+            "useLegacySql": True,
+            "writeDisposition": WriteDisposition.WRITE_TRUNCATE,
+            "maximumBillingTier": 4,
+            "maximumBytesBilled": "123456",
+            "schemaUpdateOptions": [SchemaUpdateOption.ALLOW_FIELD_RELAXATION],
+        }
+        RESOURCE["configuration"]["query"] = QUERY_CONFIGURATION
+        RESOURCE["configuration"]["dryRun"] = True
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        dataset_ref = DatasetReference(self.PROJECT, DS_ID)
+        table_ref = dataset_ref.table(TABLE)
+
+        config = QueryJobConfig()
+        config.allow_large_results = True
+        config.create_disposition = CreateDisposition.CREATE_NEVER
+        config.default_dataset = dataset_ref
+        config.destination = table_ref
+        config.dry_run = True
+        config.flatten_results = True
+        config.maximum_billing_tier = 4
+        config.priority = QueryPriority.INTERACTIVE
+        config.use_legacy_sql = True
+        config.use_query_cache = True
+        config.write_disposition = WriteDisposition.WRITE_TRUNCATE
+        config.maximum_bytes_billed = 123456
+        config.schema_update_options = [SchemaUpdateOption.ALLOW_FIELD_RELAXATION]
+        job = self._make_one(self.JOB_ID, self.QUERY, client1, job_config=config)
+
+        job._begin(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {"dryRun": True, "query": QUERY_CONFIGURATION},
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_udf(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import UDFResource
+
+        RESOURCE_URI = "gs://some-bucket/js/lib.js"
+        INLINE_UDF_CODE = 'var someCode = "here";'
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        RESOURCE["configuration"]["query"]["userDefinedFunctionResources"] = [
+            {"resourceUri": RESOURCE_URI},
+            {"inlineCode": INLINE_UDF_CODE},
+        ]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        udf_resources = [
+            UDFResource("resourceUri", RESOURCE_URI),
+            UDFResource("inlineCode", INLINE_UDF_CODE),
+        ]
+        config = QueryJobConfig()
+        config.udf_resources = udf_resources
+        config.use_legacy_sql = True
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=config)
+
+        job._begin()
+
+        self.assertEqual(job.udf_resources, udf_resources)
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "query": {
+                        "query": self.QUERY,
+                        "useLegacySql": True,
+                        "userDefinedFunctionResources": [
+                            {"resourceUri": RESOURCE_URI},
+                            {"inlineCode": INLINE_UDF_CODE},
+                        ],
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_named_query_parameter(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        query_parameters = [ScalarQueryParameter("foo", "INT64", 123)]
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        config = RESOURCE["configuration"]["query"]
+        config["parameterMode"] = "NAMED"
+        config["queryParameters"] = [
+            {
+                "name": "foo",
+                "parameterType": {"type": "INT64"},
+                "parameterValue": {"value": "123"},
+            }
+        ]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        jconfig = QueryJobConfig()
+        jconfig.query_parameters = query_parameters
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=jconfig)
+
+        job._begin()
+
+        self.assertEqual(job.query_parameters, query_parameters)
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "query": {
+                        "query": self.QUERY,
+                        "useLegacySql": False,
+                        "parameterMode": "NAMED",
+                        "queryParameters": config["queryParameters"],
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_positional_query_parameter(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        query_parameters = [ScalarQueryParameter.positional("INT64", 123)]
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        config = RESOURCE["configuration"]["query"]
+        config["parameterMode"] = "POSITIONAL"
+        config["queryParameters"] = [
+            {"parameterType": {"type": "INT64"}, "parameterValue": {"value": "123"}}
+        ]
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        jconfig = QueryJobConfig()
+        jconfig.query_parameters = query_parameters
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=jconfig)
+
+        job._begin()
+
+        self.assertEqual(job.query_parameters, query_parameters)
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "query": {
+                        "query": self.QUERY,
+                        "useLegacySql": False,
+                        "parameterMode": "POSITIONAL",
+                        "queryParameters": config["queryParameters"],
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_begin_w_table_defs(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+        from google.cloud.bigquery.external_config import ExternalConfig
+        from google.cloud.bigquery.external_config import BigtableColumn
+        from google.cloud.bigquery.external_config import BigtableColumnFamily
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+
+        bt_config = ExternalConfig("BIGTABLE")
+        bt_config.ignore_unknown_values = True
+        bt_config.options.read_rowkey_as_string = True
+        cf = BigtableColumnFamily()
+        cf.family_id = "cf"
+        col = BigtableColumn()
+        col.field_name = "fn"
+        cf.columns = [col]
+        bt_config.options.column_families = [cf]
+        BT_CONFIG_RESOURCE = {
+            "sourceFormat": "BIGTABLE",
+            "ignoreUnknownValues": True,
+            "bigtableOptions": {
+                "readRowkeyAsString": True,
+                "columnFamilies": [
+                    {"familyId": "cf", "columns": [{"fieldName": "fn"}]}
+                ],
+            },
+        }
+        CSV_CONFIG_RESOURCE = {
+            "sourceFormat": "CSV",
+            "maxBadRecords": 8,
+            "csvOptions": {"allowJaggedRows": True},
+        }
+        csv_config = ExternalConfig("CSV")
+        csv_config.max_bad_records = 8
+        csv_config.options.allow_jagged_rows = True
+        bt_table = "bigtable-table"
+        csv_table = "csv-table"
+        RESOURCE["configuration"]["query"]["tableDefinitions"] = {
+            bt_table: BT_CONFIG_RESOURCE,
+            csv_table: CSV_CONFIG_RESOURCE,
+        }
+        want_resource = copy.deepcopy(RESOURCE)
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        config = QueryJobConfig()
+        config.table_definitions = {bt_table: bt_config, csv_table: csv_config}
+        config.use_legacy_sql = True
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=config)
+
+        job._begin()
+
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "query": {
+                        "query": self.QUERY,
+                        "useLegacySql": True,
+                        "tableDefinitions": {
+                            bt_table: BT_CONFIG_RESOURCE,
+                            csv_table: CSV_CONFIG_RESOURCE,
+                        },
+                    }
+                },
+            },
+        )
+        self._verifyResourceProperties(job, want_resource)
+
+    def test_dry_run_query(self):
+        from google.cloud.bigquery.job import QueryJobConfig
+
+        PATH = "/projects/%s/jobs" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        # Ensure None for missing server-set props
+        del RESOURCE["statistics"]["creationTime"]
+        del RESOURCE["etag"]
+        del RESOURCE["selfLink"]
+        del RESOURCE["user_email"]
+        RESOURCE["configuration"]["dryRun"] = True
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        config = QueryJobConfig()
+        config.dry_run = True
+        job = self._make_one(self.JOB_ID, self.QUERY, client, job_config=config)
+
+        job._begin()
+        self.assertEqual(job.udf_resources, [])
+        conn.api_request.assert_called_once_with(
+            method="POST",
+            path=PATH,
+            data={
+                "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+                "configuration": {
+                    "query": {"query": self.QUERY, "useLegacySql": False},
+                    "dryRun": True,
+                },
+            },
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_exists_miss_w_bound_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn = _make_connection()
+        client = _make_client(project=self.PROJECT, connection=conn)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        self.assertFalse(job.exists())
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_exists_hit_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection({})
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        job = self._make_one(self.JOB_ID, self.QUERY, client1)
+
+        self.assertTrue(job.exists(client=client2))
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={"fields": "id"}
+        )
+
+    def test_reload_w_bound_client(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+        from google.cloud.bigquery.job import QueryJobConfig
+
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        DS_ID = "DATASET"
+        DEST_TABLE = "dest_table"
+        RESOURCE = self._make_resource()
+        conn = _make_connection(RESOURCE)
+        client = _make_client(project=self.PROJECT, connection=conn)
+        dataset_ref = DatasetReference(self.PROJECT, DS_ID)
+        table_ref = dataset_ref.table(DEST_TABLE)
+        config = QueryJobConfig()
+        config.destination = table_ref
+        job = self._make_one(self.JOB_ID, None, client, job_config=config)
+
+        job.reload()
+
+        self.assertNotEqual(job.destination, table_ref)
+
+        conn.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        PATH = "/projects/%s/jobs/%s" % (self.PROJECT, self.JOB_ID)
+        DS_ID = "DATASET"
+        DEST_TABLE = "dest_table"
+        RESOURCE = self._make_resource()
+        q_config = RESOURCE["configuration"]["query"]
+        q_config["destinationTable"] = {
+            "projectId": self.PROJECT,
+            "datasetId": DS_ID,
+            "tableId": DEST_TABLE,
+        }
+        conn1 = _make_connection()
+        client1 = _make_client(project=self.PROJECT, connection=conn1)
+        conn2 = _make_connection(RESOURCE)
+        client2 = _make_client(project=self.PROJECT, connection=conn2)
+        job = self._make_one(self.JOB_ID, self.QUERY, client1)
+
+        job.reload(client=client2)
+
+        conn1.api_request.assert_not_called()
+        conn2.api_request.assert_called_once_with(
+            method="GET", path=PATH, query_params={}
+        )
+        self._verifyResourceProperties(job, RESOURCE)
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_arrow(self):
+        begun_resource = self._make_resource()
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "totalRows": "4",
+            "schema": {
+                "fields": [
+                    {
+                        "name": "spouse_1",
+                        "type": "RECORD",
+                        "fields": [
+                            {"name": "name", "type": "STRING", "mode": "NULLABLE"},
+                            {"name": "age", "type": "INTEGER", "mode": "NULLABLE"},
+                        ],
+                    },
+                    {
+                        "name": "spouse_2",
+                        "type": "RECORD",
+                        "fields": [
+                            {"name": "name", "type": "STRING", "mode": "NULLABLE"},
+                            {"name": "age", "type": "INTEGER", "mode": "NULLABLE"},
+                        ],
+                    },
+                ]
+            },
+        }
+        tabledata_resource = {
+            "rows": [
+                {
+                    "f": [
+                        {"v": {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]}},
+                        {"v": {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]}},
+                    ]
+                },
+                {
+                    "f": [
+                        {"v": {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]}},
+                        {"v": {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]}},
+                    ]
+                },
+            ]
+        }
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(
+            begun_resource, query_resource, done_resource, tabledata_resource
+        )
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        tbl = job.to_arrow()
+
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 2)
+
+        # Check the schema.
+        self.assertEqual(tbl.schema[0].name, "spouse_1")
+        self.assertEqual(tbl.schema[0].type[0].name, "name")
+        self.assertEqual(tbl.schema[0].type[1].name, "age")
+        self.assertTrue(pyarrow.types.is_struct(tbl.schema[0].type))
+        self.assertTrue(pyarrow.types.is_string(tbl.schema[0].type[0].type))
+        self.assertTrue(pyarrow.types.is_int64(tbl.schema[0].type[1].type))
+        self.assertEqual(tbl.schema[1].name, "spouse_2")
+        self.assertEqual(tbl.schema[1].type[0].name, "name")
+        self.assertEqual(tbl.schema[1].type[1].name, "age")
+        self.assertTrue(pyarrow.types.is_struct(tbl.schema[1].type))
+        self.assertTrue(pyarrow.types.is_string(tbl.schema[1].type[0].type))
+        self.assertTrue(pyarrow.types.is_int64(tbl.schema[1].type[1].type))
+
+        # Check the data.
+        tbl_data = tbl.to_pydict()
+        spouse_1 = tbl_data["spouse_1"]
+        self.assertEqual(
+            spouse_1,
+            [
+                {"name": "Phred Phlyntstone", "age": 32},
+                {"name": "Bhettye Rhubble", "age": 27},
+            ],
+        )
+        spouse_2 = tbl_data["spouse_2"]
+        self.assertEqual(
+            spouse_2,
+            [
+                {"name": "Wylma Phlyntstone", "age": 29},
+                {"name": "Bharney Rhubble", "age": 33},
+            ],
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe(self):
+        begun_resource = self._make_resource()
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "totalRows": "4",
+            "schema": {
+                "fields": [
+                    {"name": "name", "type": "STRING", "mode": "NULLABLE"},
+                    {"name": "age", "type": "INTEGER", "mode": "NULLABLE"},
+                ]
+            },
+        }
+        tabledata_resource = {
+            "rows": [
+                {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+                {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+                {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+                {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+            ]
+        }
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(
+            begun_resource, query_resource, done_resource, tabledata_resource
+        )
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        df = job.to_dataframe()
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 4)  # verify the number of rows
+        self.assertEqual(list(df), ["name", "age"])  # verify the column names
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_ddl_query(self):
+        # Destination table may have no schema for some DDL and DML queries.
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "schema": {"fields": []},
+        }
+        connection = _make_connection(query_resource)
+        client = _make_client(self.PROJECT, connection=connection)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+
+        df = job.to_dataframe()
+
+        self.assertEqual(len(df), 0)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_bqstorage(self):
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "totalRows": "4",
+            "schema": {
+                "fields": [
+                    {"name": "name", "type": "STRING", "mode": "NULLABLE"},
+                    {"name": "age", "type": "INTEGER", "mode": "NULLABLE"},
+                ]
+            },
+        }
+        connection = _make_connection(query_resource)
+        client = _make_client(self.PROJECT, connection=connection)
+        resource = self._make_resource(ended=True)
+        job = self._get_target_class().from_api_repr(resource, client)
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        session = bigquery_storage_v1beta1.types.ReadSession()
+        session.avro_schema.schema = json.dumps(
+            {
+                "type": "record",
+                "name": "__root__",
+                "fields": [
+                    {"name": "name", "type": ["null", "string"]},
+                    {"name": "age", "type": ["null", "long"]},
+                ],
+            }
+        )
+        bqstorage_client.create_read_session.return_value = session
+
+        job.to_dataframe(bqstorage_client=bqstorage_client)
+
+        bqstorage_client.create_read_session.assert_called_once_with(
+            mock.ANY,
+            "projects/{}".format(self.PROJECT),
+            format_=bigquery_storage_v1beta1.enums.DataFormat.ARROW,
+            read_options=mock.ANY,
+            # Use default number of streams for best performance.
+            requested_streams=0,
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_column_dtypes(self):
+        begun_resource = self._make_resource()
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "totalRows": "4",
+            "schema": {
+                "fields": [
+                    {"name": "start_timestamp", "type": "TIMESTAMP"},
+                    {"name": "seconds", "type": "INT64"},
+                    {"name": "miles", "type": "FLOAT64"},
+                    {"name": "km", "type": "FLOAT64"},
+                    {"name": "payment_type", "type": "STRING"},
+                    {"name": "complete", "type": "BOOL"},
+                    {"name": "date", "type": "DATE"},
+                ]
+            },
+        }
+        row_data = [
+            ["1.4338368E9", "420", "1.1", "1.77", "Cash", "true", "1999-12-01"],
+            ["1.3878117E9", "2580", "17.7", "28.5", "Cash", "false", "1953-06-14"],
+            ["1.3855653E9", "2280", "4.4", "7.1", "Credit", "true", "1981-11-04"],
+        ]
+        rows = [{"f": [{"v": field} for field in row]} for row in row_data]
+        query_resource["rows"] = rows
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(
+            begun_resource, query_resource, done_resource, query_resource
+        )
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        df = job.to_dataframe(dtypes={"km": "float16"})
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 3)  # verify the number of rows
+        exp_columns = [field["name"] for field in query_resource["schema"]["fields"]]
+        self.assertEqual(list(df), exp_columns)  # verify the column names
+
+        self.assertEqual(df.start_timestamp.dtype.name, "datetime64[ns, UTC]")
+        self.assertEqual(df.seconds.dtype.name, "int64")
+        self.assertEqual(df.miles.dtype.name, "float64")
+        self.assertEqual(df.km.dtype.name, "float16")
+        self.assertEqual(df.payment_type.dtype.name, "object")
+        self.assertEqual(df.complete.dtype.name, "bool")
+        self.assertEqual(df.date.dtype.name, "object")
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(tqdm is None, "Requires `tqdm`")
+    @mock.patch("tqdm.tqdm")
+    def test_to_dataframe_with_progress_bar(self, tqdm_mock):
+        begun_resource = self._make_resource()
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "totalRows": "4",
+            "schema": {
+                "fields": [{"name": "name", "type": "STRING", "mode": "NULLABLE"}]
+            },
+        }
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(
+            begun_resource,
+            query_resource,
+            done_resource,
+            query_resource,
+            query_resource,
+        )
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        job.to_dataframe(progress_bar_type=None)
+        tqdm_mock.assert_not_called()
+
+        job.to_dataframe(progress_bar_type="tqdm")
+        tqdm_mock.assert_called()
+
+    def test_iter(self):
+        import types
+
+        begun_resource = self._make_resource()
+        query_resource = {
+            "jobComplete": True,
+            "jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID},
+            "totalRows": "0",
+            "schema": {"fields": [{"name": "col1", "type": "STRING"}]},
+        }
+        done_resource = copy.deepcopy(begun_resource)
+        done_resource["status"] = {"state": "DONE"}
+        connection = _make_connection(begun_resource, query_resource, done_resource)
+        client = _make_client(project=self.PROJECT, connection=connection)
+        job = self._make_one(self.JOB_ID, self.QUERY, client)
+
+        self.assertIsInstance(iter(job), types.GeneratorType)
+
+
+class TestQueryPlanEntryStep(unittest.TestCase, _Base):
+    KIND = "KIND"
+    SUBSTEPS = ("SUB1", "SUB2")
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import QueryPlanEntryStep
+
+        return QueryPlanEntryStep
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        step = self._make_one(self.KIND, self.SUBSTEPS)
+        self.assertEqual(step.kind, self.KIND)
+        self.assertEqual(step.substeps, list(self.SUBSTEPS))
+
+    def test_from_api_repr_empty(self):
+        klass = self._get_target_class()
+        step = klass.from_api_repr({})
+        self.assertIsNone(step.kind)
+        self.assertEqual(step.substeps, [])
+
+    def test_from_api_repr_normal(self):
+        resource = {"kind": self.KIND, "substeps": self.SUBSTEPS}
+        klass = self._get_target_class()
+        step = klass.from_api_repr(resource)
+        self.assertEqual(step.kind, self.KIND)
+        self.assertEqual(step.substeps, list(self.SUBSTEPS))
+
+    def test___eq___mismatched_type(self):
+        step = self._make_one(self.KIND, self.SUBSTEPS)
+        self.assertNotEqual(step, object())
+
+    def test___eq___mismatch_kind(self):
+        step = self._make_one(self.KIND, self.SUBSTEPS)
+        other = self._make_one("OTHER", self.SUBSTEPS)
+        self.assertNotEqual(step, other)
+
+    def test___eq___mismatch_substeps(self):
+        step = self._make_one(self.KIND, self.SUBSTEPS)
+        other = self._make_one(self.KIND, ())
+        self.assertNotEqual(step, other)
+
+    def test___eq___hit(self):
+        step = self._make_one(self.KIND, self.SUBSTEPS)
+        other = self._make_one(self.KIND, self.SUBSTEPS)
+        self.assertEqual(step, other)
+
+    def test___eq___wrong_type(self):
+        step = self._make_one(self.KIND, self.SUBSTEPS)
+        self.assertFalse(step == "hello")
+
+
+class TestQueryPlanEntry(unittest.TestCase, _Base):
+    NAME = "NAME"
+    ENTRY_ID = 1234
+    START_MS = 1522540800000
+    END_MS = 1522540804000
+    INPUT_STAGES = (88, 101)
+    PARALLEL_INPUTS = 1000
+    COMPLETED_PARALLEL_INPUTS = 5
+    WAIT_MS_AVG = 33
+    WAIT_MS_MAX = 400
+    WAIT_RATIO_AVG = 2.71828
+    WAIT_RATIO_MAX = 3.14159
+    READ_MS_AVG = 45
+    READ_MS_MAX = 90
+    READ_RATIO_AVG = 1.41421
+    READ_RATIO_MAX = 1.73205
+    COMPUTE_MS_AVG = 55
+    COMPUTE_MS_MAX = 99
+    COMPUTE_RATIO_AVG = 0.69315
+    COMPUTE_RATIO_MAX = 1.09861
+    WRITE_MS_AVG = 203
+    WRITE_MS_MAX = 340
+    WRITE_RATIO_AVG = 3.32193
+    WRITE_RATIO_MAX = 2.30258
+    RECORDS_READ = 100
+    RECORDS_WRITTEN = 1
+    STATUS = "STATUS"
+    SHUFFLE_OUTPUT_BYTES = 1024
+    SHUFFLE_OUTPUT_BYTES_SPILLED = 1
+
+    START_RFC3339_MICROS = "2018-04-01T00:00:00.000000Z"
+    END_RFC3339_MICROS = "2018-04-01T00:00:04.000000Z"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import QueryPlanEntry
+
+        return QueryPlanEntry
+
+    def test_from_api_repr_empty(self):
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr({})
+
+        self.assertIsNone(entry.name)
+        self.assertIsNone(entry.entry_id)
+        self.assertEqual(entry.input_stages, [])
+        self.assertIsNone(entry.start)
+        self.assertIsNone(entry.end)
+        self.assertIsNone(entry.parallel_inputs)
+        self.assertIsNone(entry.completed_parallel_inputs)
+        self.assertIsNone(entry.wait_ms_avg)
+        self.assertIsNone(entry.wait_ms_max)
+        self.assertIsNone(entry.wait_ratio_avg)
+        self.assertIsNone(entry.wait_ratio_max)
+        self.assertIsNone(entry.read_ms_avg)
+        self.assertIsNone(entry.read_ms_max)
+        self.assertIsNone(entry.read_ratio_avg)
+        self.assertIsNone(entry.read_ratio_max)
+        self.assertIsNone(entry.compute_ms_avg)
+        self.assertIsNone(entry.compute_ms_max)
+        self.assertIsNone(entry.compute_ratio_avg)
+        self.assertIsNone(entry.compute_ratio_max)
+        self.assertIsNone(entry.write_ms_avg)
+        self.assertIsNone(entry.write_ms_max)
+        self.assertIsNone(entry.write_ratio_avg)
+        self.assertIsNone(entry.write_ratio_max)
+        self.assertIsNone(entry.records_read)
+        self.assertIsNone(entry.records_written)
+        self.assertIsNone(entry.status)
+        self.assertIsNone(entry.shuffle_output_bytes)
+        self.assertIsNone(entry.shuffle_output_bytes_spilled)
+        self.assertEqual(entry.steps, [])
+
+    def test_from_api_repr_normal(self):
+        from google.cloud.bigquery.job import QueryPlanEntryStep
+
+        steps = [
+            QueryPlanEntryStep(
+                kind=TestQueryPlanEntryStep.KIND,
+                substeps=TestQueryPlanEntryStep.SUBSTEPS,
+            )
+        ]
+        resource = {
+            "name": self.NAME,
+            "id": self.ENTRY_ID,
+            "inputStages": self.INPUT_STAGES,
+            "startMs": self.START_MS,
+            "endMs": self.END_MS,
+            "waitMsAvg": self.WAIT_MS_AVG,
+            "waitMsMax": self.WAIT_MS_MAX,
+            "waitRatioAvg": self.WAIT_RATIO_AVG,
+            "waitRatioMax": self.WAIT_RATIO_MAX,
+            "readMsAvg": self.READ_MS_AVG,
+            "readMsMax": self.READ_MS_MAX,
+            "readRatioAvg": self.READ_RATIO_AVG,
+            "readRatioMax": self.READ_RATIO_MAX,
+            "computeMsAvg": self.COMPUTE_MS_AVG,
+            "computeMsMax": self.COMPUTE_MS_MAX,
+            "computeRatioAvg": self.COMPUTE_RATIO_AVG,
+            "computeRatioMax": self.COMPUTE_RATIO_MAX,
+            "writeMsAvg": self.WRITE_MS_AVG,
+            "writeMsMax": self.WRITE_MS_MAX,
+            "writeRatioAvg": self.WRITE_RATIO_AVG,
+            "writeRatioMax": self.WRITE_RATIO_MAX,
+            "recordsRead": self.RECORDS_READ,
+            "recordsWritten": self.RECORDS_WRITTEN,
+            "status": self.STATUS,
+            "shuffleOutputBytes": self.SHUFFLE_OUTPUT_BYTES,
+            "shuffleOutputBytesSpilled": self.SHUFFLE_OUTPUT_BYTES_SPILLED,
+            "steps": [
+                {
+                    "kind": TestQueryPlanEntryStep.KIND,
+                    "substeps": TestQueryPlanEntryStep.SUBSTEPS,
+                }
+            ],
+        }
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr(resource)
+        self.assertEqual(entry.name, self.NAME)
+        self.assertEqual(entry.entry_id, self.ENTRY_ID)
+        self.assertEqual(entry.wait_ratio_avg, self.WAIT_RATIO_AVG)
+        self.assertEqual(entry.wait_ratio_max, self.WAIT_RATIO_MAX)
+        self.assertEqual(entry.read_ratio_avg, self.READ_RATIO_AVG)
+        self.assertEqual(entry.read_ratio_max, self.READ_RATIO_MAX)
+        self.assertEqual(entry.compute_ratio_avg, self.COMPUTE_RATIO_AVG)
+        self.assertEqual(entry.compute_ratio_max, self.COMPUTE_RATIO_MAX)
+        self.assertEqual(entry.write_ratio_avg, self.WRITE_RATIO_AVG)
+        self.assertEqual(entry.write_ratio_max, self.WRITE_RATIO_MAX)
+        self.assertEqual(entry.records_read, self.RECORDS_READ)
+        self.assertEqual(entry.records_written, self.RECORDS_WRITTEN)
+        self.assertEqual(entry.status, self.STATUS)
+        self.assertEqual(entry.steps, steps)
+
+    def test_start(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr({})
+        self.assertEqual(entry.start, None)
+
+        entry._properties["startMs"] = self.START_MS
+        self.assertEqual(
+            entry.start.strftime(_RFC3339_MICROS), self.START_RFC3339_MICROS
+        )
+
+    def test_end(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr({})
+        self.assertEqual(entry.end, None)
+
+        entry._properties["endMs"] = self.END_MS
+        self.assertEqual(entry.end.strftime(_RFC3339_MICROS), self.END_RFC3339_MICROS)
+
+
+class TestTimelineEntry(unittest.TestCase, _Base):
+    ELAPSED_MS = 101
+    ACTIVE_UNITS = 50
+    PENDING_UNITS = 98
+    COMPLETED_UNITS = 520
+    SLOT_MILLIS = 12029
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.job import TimelineEntry
+
+        return TimelineEntry
+
+    def test_from_api_repr_empty(self):
+        klass = self._get_target_class()
+        entry = klass.from_api_repr({})
+        self.assertIsNone(entry.elapsed_ms)
+        self.assertIsNone(entry.active_units)
+        self.assertIsNone(entry.pending_units)
+        self.assertIsNone(entry.completed_units)
+        self.assertIsNone(entry.slot_millis)
+
+    def test_from_api_repr_normal(self):
+        resource = {
+            "elapsedMs": self.ELAPSED_MS,
+            "activeUnits": self.ACTIVE_UNITS,
+            "pendingUnits": self.PENDING_UNITS,
+            "completedUnits": self.COMPLETED_UNITS,
+            "totalSlotMs": self.SLOT_MILLIS,
+        }
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr(resource)
+        self.assertEqual(entry.elapsed_ms, self.ELAPSED_MS)
+        self.assertEqual(entry.active_units, self.ACTIVE_UNITS)
+        self.assertEqual(entry.pending_units, self.PENDING_UNITS)
+        self.assertEqual(entry.completed_units, self.COMPLETED_UNITS)
+        self.assertEqual(entry.slot_millis, self.SLOT_MILLIS)
+
+
+@pytest.mark.parametrize(
+    "query,expected",
+    (
+        (None, False),
+        ("", False),
+        ("select name, age from table", False),
+        ("select name, age from table LIMIT 10;", False),
+        ("select name, age from table order by other_column;", True),
+        ("Select name, age From table Order By other_column", True),
+        ("SELECT name, age FROM table ORDER BY other_column;", True),
+        ("select name, age from table order\nby other_column", True),
+        ("Select name, age From table Order\nBy other_column;", True),
+        ("SELECT name, age FROM table ORDER\nBY other_column", True),
+        ("SelecT name, age froM table OrdeR \n\t BY other_column;", True),
+    ),
+)
+def test__contains_order_by(query, expected):
+    from google.cloud.bigquery import job as mut
+
+    if expected:
+        assert mut._contains_order_by(query)
+    else:
+        assert not mut._contains_order_by(query)
+
+
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+@pytest.mark.skipif(
+    bigquery_storage_v1beta1 is None, reason="Requires `google-cloud-bigquery-storage`"
+)
+@pytest.mark.parametrize(
+    "query",
+    (
+        "select name, age from table order by other_column;",
+        "Select name, age From table Order By other_column;",
+        "SELECT name, age FROM table ORDER BY other_column;",
+        "select name, age from table order\nby other_column;",
+        "Select name, age From table Order\nBy other_column;",
+        "SELECT name, age FROM table ORDER\nBY other_column;",
+        "SelecT name, age froM table OrdeR \n\t BY other_column;",
+    ),
+)
+def test_to_dataframe_bqstorage_preserve_order(query):
+    from google.cloud.bigquery.job import QueryJob as target_class
+
+    job_resource = _make_job_resource(
+        project_id="test-project", job_type="query", ended=True
+    )
+    job_resource["configuration"]["query"]["query"] = query
+    job_resource["status"] = {"state": "DONE"}
+    get_query_results_resource = {
+        "jobComplete": True,
+        "jobReference": {"projectId": "test-project", "jobId": "test-job"},
+        "schema": {
+            "fields": [
+                {"name": "name", "type": "STRING", "mode": "NULLABLE"},
+                {"name": "age", "type": "INTEGER", "mode": "NULLABLE"},
+            ]
+        },
+        "totalRows": "4",
+    }
+    connection = _make_connection(get_query_results_resource, job_resource)
+    client = _make_client(connection=connection)
+    job = target_class.from_api_repr(job_resource, client)
+    bqstorage_client = mock.create_autospec(
+        bigquery_storage_v1beta1.BigQueryStorageClient
+    )
+    session = bigquery_storage_v1beta1.types.ReadSession()
+    session.avro_schema.schema = json.dumps(
+        {
+            "type": "record",
+            "name": "__root__",
+            "fields": [
+                {"name": "name", "type": ["null", "string"]},
+                {"name": "age", "type": ["null", "long"]},
+            ],
+        }
+    )
+    bqstorage_client.create_read_session.return_value = session
+
+    job.to_dataframe(bqstorage_client=bqstorage_client)
+
+    bqstorage_client.create_read_session.assert_called_once_with(
+        mock.ANY,
+        "projects/test-project",
+        format_=bigquery_storage_v1beta1.enums.DataFormat.ARROW,
+        read_options=mock.ANY,
+        # Use a single stream to preserve row order.
+        requested_streams=1,
+    )
diff --git a/bigquery/tests/unit/test_magics.py b/bigquery/tests/unit/test_magics.py
new file mode 100644
index 000000000000..fbea9bdd9050
--- /dev/null
+++ b/bigquery/tests/unit/test_magics.py
@@ -0,0 +1,1009 @@
+# 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.
+
+import copy
+import re
+from concurrent import futures
+
+import mock
+import pytest
+import six
+
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+try:
+    import IPython
+    from IPython.utils import io
+    from IPython.testing import tools
+    from IPython.terminal import interactiveshell
+except ImportError:  # pragma: NO COVER
+    IPython = None
+
+from google.api_core import exceptions
+import google.auth.credentials
+
+try:
+    from google.cloud import bigquery_storage_v1beta1
+except ImportError:  # pragma: NO COVER
+    bigquery_storage_v1beta1 = None
+from google.cloud.bigquery import job
+from google.cloud.bigquery import table
+from google.cloud.bigquery import magics
+from tests.unit.helpers import make_connection
+from test_utils.imports import maybe_fail_import
+
+
+pytestmark = pytest.mark.skipif(IPython is None, reason="Requires `ipython`")
+
+
+@pytest.fixture(scope="session")
+def ipython():
+    config = tools.default_config()
+    config.TerminalInteractiveShell.simple_prompt = True
+    shell = interactiveshell.TerminalInteractiveShell.instance(config=config)
+    return shell
+
+
+@pytest.fixture()
+def ipython_interactive(request, ipython):
+    """Activate IPython's builtin hooks
+
+    for the duration of the test scope.
+    """
+    with ipython.builtin_trap:
+        yield ipython
+
+
+@pytest.fixture(scope="session")
+def missing_bq_storage():
+    """Provide a patcher that can make the bigquery storage import to fail."""
+
+    def fail_if(name, globals, locals, fromlist, level):
+        # NOTE: *very* simplified, assuming a straightforward absolute import
+        return "bigquery_storage_v1beta1" in name or (
+            fromlist is not None and "bigquery_storage_v1beta1" in fromlist
+        )
+
+    return maybe_fail_import(predicate=fail_if)
+
+
+@pytest.fixture(scope="session")
+def missing_grpcio_lib():
+    """Provide a patcher that can make the gapic library import to fail."""
+
+    def fail_if(name, globals, locals, fromlist, level):
+        # NOTE: *very* simplified, assuming a straightforward absolute import
+        return "gapic_v1" in name or (fromlist is not None and "gapic_v1" in fromlist)
+
+    return maybe_fail_import(predicate=fail_if)
+
+
+JOB_REFERENCE_RESOURCE = {"projectId": "its-a-project-eh", "jobId": "some-random-id"}
+TABLE_REFERENCE_RESOURCE = {
+    "projectId": "its-a-project-eh",
+    "datasetId": "ds",
+    "tableId": "persons",
+}
+QUERY_RESOURCE = {
+    "jobReference": JOB_REFERENCE_RESOURCE,
+    "configuration": {
+        "query": {
+            "destinationTable": TABLE_REFERENCE_RESOURCE,
+            "query": "SELECT 42 FROM `life.the_universe.and_everything`;",
+            "queryParameters": [],
+            "useLegacySql": False,
+        }
+    },
+    "status": {"state": "DONE"},
+}
+
+
+def test_context_credentials_auto_set_w_application_default_credentials():
+    """When Application Default Credentials are set, the context credentials
+    will be created the first time it is called
+    """
+    assert magics.context._credentials is None
+    assert magics.context._project is None
+
+    project = "prahj-ekt"
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, project)
+    )
+    with default_patch as default_mock:
+        assert magics.context.credentials is credentials_mock
+        assert magics.context.project == project
+
+    assert default_mock.call_count == 2
+
+
+def test_context_credentials_and_project_can_be_set_explicitly():
+    project1 = "one-project-55564"
+    project2 = "other-project-52569"
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, project1)
+    )
+    with default_patch as default_mock:
+        magics.context.credentials = credentials_mock
+        magics.context.project = project2
+
+    assert magics.context.project == project2
+    assert magics.context.credentials is credentials_mock
+    # default should not be called if credentials & project are explicitly set
+    assert default_mock.call_count == 0
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_context_connection_can_be_overriden():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+    magics.context._credentials = None
+
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    project = "project-123"
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, project)
+    )
+    job_reference = copy.deepcopy(JOB_REFERENCE_RESOURCE)
+    job_reference["projectId"] = project
+
+    query = "select * from persons"
+    resource = copy.deepcopy(QUERY_RESOURCE)
+    resource["jobReference"] = job_reference
+    resource["configuration"]["query"]["query"] = query
+    data = {"jobReference": job_reference, "totalRows": 0, "rows": []}
+
+    conn = magics.context._connection = make_connection(resource, data)
+    list_rows_patch = mock.patch(
+        "google.cloud.bigquery.client.Client.list_rows",
+        return_value=google.cloud.bigquery.table._EmptyRowIterator(),
+    )
+    with list_rows_patch as list_rows, default_patch:
+        ip.run_cell_magic("bigquery", "", query)
+
+    # Check that query actually starts the job.
+    list_rows.assert_called()
+    assert len(conn.api_request.call_args_list) == 2
+    _, req = conn.api_request.call_args_list[0]
+    assert req["method"] == "POST"
+    assert req["path"] == "/projects/{}/jobs".format(project)
+    sent = req["data"]
+    assert isinstance(sent["jobReference"]["jobId"], six.string_types)
+    sent_config = sent["configuration"]["query"]
+    assert sent_config["query"] == query
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_context_no_connection():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+    magics.context._credentials = None
+    magics.context._connection = None
+
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    project = "project-123"
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, project)
+    )
+    job_reference = copy.deepcopy(JOB_REFERENCE_RESOURCE)
+    job_reference["projectId"] = project
+
+    query = "select * from persons"
+    resource = copy.deepcopy(QUERY_RESOURCE)
+    resource["jobReference"] = job_reference
+    resource["configuration"]["query"]["query"] = query
+    data = {"jobReference": job_reference, "totalRows": 0, "rows": []}
+
+    conn_mock = make_connection(resource, data, data, data)
+    conn_patch = mock.patch("google.cloud.bigquery.client.Connection", autospec=True)
+    list_rows_patch = mock.patch(
+        "google.cloud.bigquery.client.Client.list_rows",
+        return_value=google.cloud.bigquery.table._EmptyRowIterator(),
+    )
+    with conn_patch as conn, list_rows_patch as list_rows, default_patch:
+        conn.return_value = conn_mock
+        ip.run_cell_magic("bigquery", "", query)
+
+    # Check that query actually starts the job.
+    list_rows.assert_called()
+    assert len(conn_mock.api_request.call_args_list) == 2
+    _, req = conn_mock.api_request.call_args_list[0]
+    assert req["method"] == "POST"
+    assert req["path"] == "/projects/{}/jobs".format(project)
+    sent = req["data"]
+    assert isinstance(sent["jobReference"]["jobId"], six.string_types)
+    sent_config = sent["configuration"]["query"]
+    assert sent_config["query"] == query
+
+
+def test__run_query():
+    magics.context._credentials = None
+
+    job_id = "job_1234"
+    sql = "SELECT 17"
+    responses = [
+        futures.TimeoutError,
+        futures.TimeoutError,
+        [table.Row((17,), {"num": 0})],
+    ]
+
+    client_patch = mock.patch(
+        "google.cloud.bigquery.magics.bigquery.Client", autospec=True
+    )
+    with client_patch as client_mock, io.capture_output() as captured:
+        client_mock().query(sql).result.side_effect = responses
+        client_mock().query(sql).job_id = job_id
+
+        query_job = magics._run_query(client_mock(), sql)
+
+    lines = re.split("\n|\r", captured.stdout)
+    # Removes blanks & terminal code (result of display clearing)
+    updates = list(filter(lambda x: bool(x) and x != "\x1b[2K", lines))
+
+    assert query_job.job_id == job_id
+    expected_first_line = "Executing query with job ID: {}".format(job_id)
+    assert updates[0] == expected_first_line
+    execution_updates = updates[1:-1]
+    assert len(execution_updates) == 3  # one update per API response
+    for line in execution_updates:
+        assert re.match("Query executing: .*s", line)
+    assert re.match("Query complete after .*s", updates[-1])
+
+
+def test__run_query_dry_run_without_errors_is_silent():
+    magics.context._credentials = None
+
+    sql = "SELECT 17"
+
+    client_patch = mock.patch(
+        "google.cloud.bigquery.magics.bigquery.Client", autospec=True
+    )
+
+    job_config = job.QueryJobConfig()
+    job_config.dry_run = True
+    with client_patch as client_mock, io.capture_output() as captured:
+        client_mock().query(sql).job_id = None
+        magics._run_query(client_mock(), sql, job_config=job_config)
+
+    assert len(captured.stderr) == 0
+    assert len(captured.stdout) == 0
+
+
+def test__make_bqstorage_client_false():
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    got = magics._make_bqstorage_client(False, credentials_mock)
+    assert got is None
+
+
+@pytest.mark.skipif(
+    bigquery_storage_v1beta1 is None, reason="Requires `google-cloud-bigquery-storage`"
+)
+def test__make_bqstorage_client_true():
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    got = magics._make_bqstorage_client(True, credentials_mock)
+    assert isinstance(got, bigquery_storage_v1beta1.BigQueryStorageClient)
+
+
+def test__make_bqstorage_client_true_raises_import_error(missing_bq_storage):
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    with pytest.raises(ImportError) as exc_context, missing_bq_storage:
+        magics._make_bqstorage_client(True, credentials_mock)
+
+    error_msg = str(exc_context.value)
+    assert "google-cloud-bigquery-storage" in error_msg
+    assert "pyarrow" in error_msg
+
+
+def test__make_bqstorage_client_true_missing_gapic(missing_grpcio_lib):
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    with pytest.raises(ImportError) as exc_context, missing_grpcio_lib:
+        magics._make_bqstorage_client(True, credentials_mock)
+
+    assert "grpcio" in str(exc_context.value)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_extension_load():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+
+    # verify that the magic is registered and has the correct source
+    magic = ip.magics_manager.magics["cell"].get("bigquery")
+    assert magic.__module__ == "google.cloud.bigquery.magics"
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_bigquery_magic_without_optional_arguments(missing_bq_storage):
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    sql = "SELECT 17 AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+
+    # Shouldn't fail when BigQuery Storage client isn't installed.
+    with run_query_patch as run_query_mock, missing_bq_storage:
+        run_query_mock.return_value = query_job_mock
+        return_value = ip.run_cell_magic("bigquery", "", sql)
+
+    assert isinstance(return_value, pandas.DataFrame)
+    assert len(return_value) == len(result)  # verify row count
+    assert list(return_value) == list(result)  # verify column names
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_default_connection_user_agent():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._connection = None
+
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    conn_patch = mock.patch("google.cloud.bigquery.client.Connection", autospec=True)
+
+    with conn_patch as conn, run_query_patch, default_patch:
+        ip.run_cell_magic("bigquery", "", "SELECT 17 as num")
+
+    client_info_arg = conn.call_args.kwargs.get("client_info")
+    assert client_info_arg is not None
+    assert client_info_arg.user_agent == "ipython-" + IPython.__version__
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_with_legacy_sql():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    with run_query_patch as run_query_mock:
+        ip.run_cell_magic("bigquery", "--use_legacy_sql", "SELECT 17 AS num")
+
+        job_config_used = run_query_mock.call_args_list[0][0][-1]
+        assert job_config_used.use_legacy_sql is True
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_bigquery_magic_with_result_saved_to_variable():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    sql = "SELECT 17 AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    assert "df" not in ip.user_ns
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+    with run_query_patch as run_query_mock:
+        run_query_mock.return_value = query_job_mock
+
+        return_value = ip.run_cell_magic("bigquery", "df", sql)
+
+    assert return_value is None
+    assert "df" in ip.user_ns  # verify that variable exists
+    df = ip.user_ns["df"]
+    assert len(df) == len(result)  # verify row count
+    assert list(df) == list(result)  # verify column names
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_does_not_clear_display_in_verbose_mode():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    clear_patch = mock.patch(
+        "google.cloud.bigquery.magics.display.clear_output", autospec=True
+    )
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    with clear_patch as clear_mock, run_query_patch:
+        ip.run_cell_magic("bigquery", "--verbose", "SELECT 17 as num")
+
+        assert clear_mock.call_count == 0
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_clears_display_in_verbose_mode():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    clear_patch = mock.patch(
+        "google.cloud.bigquery.magics.display.clear_output", autospec=True
+    )
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    with clear_patch as clear_mock, run_query_patch:
+        ip.run_cell_magic("bigquery", "", "SELECT 17 as num")
+
+        assert clear_mock.call_count == 1
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(
+    bigquery_storage_v1beta1 is None, reason="Requires `google-cloud-bigquery-storage`"
+)
+def test_bigquery_magic_with_bqstorage_from_argument(monkeypatch):
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    mock_credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    # Set up the context with monkeypatch so that it's reset for subsequent
+    # tests.
+    monkeypatch.setattr(magics.context, "credentials", mock_credentials)
+    monkeypatch.setattr(magics.context, "use_bqstorage_api", False)
+
+    # Mock out the BigQuery Storage API.
+    bqstorage_mock = mock.create_autospec(
+        bigquery_storage_v1beta1.BigQueryStorageClient
+    )
+    bqstorage_instance_mock = mock.create_autospec(
+        bigquery_storage_v1beta1.BigQueryStorageClient, instance=True
+    )
+    bqstorage_mock.return_value = bqstorage_instance_mock
+    bqstorage_client_patch = mock.patch(
+        "google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient", bqstorage_mock
+    )
+
+    sql = "SELECT 17 AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+    with run_query_patch as run_query_mock, bqstorage_client_patch:
+        run_query_mock.return_value = query_job_mock
+
+        return_value = ip.run_cell_magic("bigquery", "--use_bqstorage_api", sql)
+
+    assert len(bqstorage_mock.call_args_list) == 1
+    kwargs = bqstorage_mock.call_args_list[0].kwargs
+    assert kwargs.get("credentials") is mock_credentials
+    client_info = kwargs.get("client_info")
+    assert client_info is not None
+    assert client_info.user_agent == "ipython-" + IPython.__version__
+
+    query_job_mock.to_dataframe.assert_called_once_with(
+        bqstorage_client=bqstorage_instance_mock
+    )
+
+    assert isinstance(return_value, pandas.DataFrame)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(
+    bigquery_storage_v1beta1 is None, reason="Requires `google-cloud-bigquery-storage`"
+)
+def test_bigquery_magic_with_bqstorage_from_context(monkeypatch):
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    mock_credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    # Set up the context with monkeypatch so that it's reset for subsequent
+    # tests.
+    monkeypatch.setattr(magics.context, "credentials", mock_credentials)
+    monkeypatch.setattr(magics.context, "use_bqstorage_api", True)
+
+    # Mock out the BigQuery Storage API.
+    bqstorage_mock = mock.create_autospec(
+        bigquery_storage_v1beta1.BigQueryStorageClient
+    )
+    bqstorage_instance_mock = mock.create_autospec(
+        bigquery_storage_v1beta1.BigQueryStorageClient, instance=True
+    )
+    bqstorage_mock.return_value = bqstorage_instance_mock
+    bqstorage_client_patch = mock.patch(
+        "google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient", bqstorage_mock
+    )
+
+    sql = "SELECT 17 AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+    with run_query_patch as run_query_mock, bqstorage_client_patch:
+        run_query_mock.return_value = query_job_mock
+
+        return_value = ip.run_cell_magic("bigquery", "", sql)
+
+    assert len(bqstorage_mock.call_args_list) == 1
+    kwargs = bqstorage_mock.call_args_list[0].kwargs
+    assert kwargs.get("credentials") is mock_credentials
+    client_info = kwargs.get("client_info")
+    assert client_info is not None
+    assert client_info.user_agent == "ipython-" + IPython.__version__
+
+    query_job_mock.to_dataframe.assert_called_once_with(
+        bqstorage_client=bqstorage_instance_mock
+    )
+
+    assert isinstance(return_value, pandas.DataFrame)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(
+    bigquery_storage_v1beta1 is None, reason="Requires `google-cloud-bigquery-storage`"
+)
+def test_bigquery_magic_without_bqstorage(monkeypatch):
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    mock_credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    # Set up the context with monkeypatch so that it's reset for subsequent
+    # tests.
+    monkeypatch.setattr(magics.context, "credentials", mock_credentials)
+
+    # Mock out the BigQuery Storage API.
+    bqstorage_mock = mock.create_autospec(
+        bigquery_storage_v1beta1.BigQueryStorageClient
+    )
+    bqstorage_client_patch = mock.patch(
+        "google.cloud.bigquery_storage_v1beta1.BigQueryStorageClient", bqstorage_mock
+    )
+
+    sql = "SELECT 17 AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+    with run_query_patch as run_query_mock, bqstorage_client_patch:
+        run_query_mock.return_value = query_job_mock
+
+        return_value = ip.run_cell_magic("bigquery", "", sql)
+
+        bqstorage_mock.assert_not_called()
+        query_job_mock.to_dataframe.assert_called_once_with(bqstorage_client=None)
+
+    assert isinstance(return_value, pandas.DataFrame)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_dryrun_option_sets_job_config():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+
+    sql = "SELECT 17 AS num"
+
+    with run_query_patch as run_query_mock:
+        ip.run_cell_magic("bigquery", "--dry_run", sql)
+
+        job_config_used = run_query_mock.call_args_list[0][0][-1]
+        assert job_config_used.dry_run is True
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_dryrun_option_returns_query_job():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+
+    sql = "SELECT 17 AS num"
+
+    with run_query_patch as run_query_mock, io.capture_output() as captured_io:
+        run_query_mock.return_value = query_job_mock
+        return_value = ip.run_cell_magic("bigquery", "--dry_run", sql)
+
+        assert "Query validated. This query will process" in captured_io.stdout
+        assert isinstance(return_value, job.QueryJob)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_dryrun_option_variable_error_message():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query",
+        autospec=True,
+        side_effect=exceptions.BadRequest("Syntax error in SQL query"),
+    )
+
+    sql = "SELECT SELECT 17 AS num"
+
+    assert "q_job" not in ip.user_ns
+
+    with run_query_patch, io.capture_output() as captured:
+        ip.run_cell_magic("bigquery", "q_job --dry_run", sql)
+
+    full_text = captured.stderr
+    assert "Could not save output to variable 'q_job'." in full_text
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_dryrun_option_saves_query_job_to_variable():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+
+    sql = "SELECT 17 AS num"
+
+    assert "q_job" not in ip.user_ns
+
+    with run_query_patch as run_query_mock:
+        run_query_mock.return_value = query_job_mock
+        return_value = ip.run_cell_magic("bigquery", "q_job --dry_run", sql)
+
+    assert return_value is None
+    assert "q_job" in ip.user_ns
+    q_job = ip.user_ns["q_job"]
+    assert isinstance(q_job, job.QueryJob)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_w_maximum_bytes_billed_invalid():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+    client_query_patch = mock.patch("google.cloud.bigquery.client.Client.query")
+
+    sql = "SELECT 17 AS num"
+
+    with pytest.raises(ValueError), default_patch, client_query_patch:
+        ip.run_cell_magic("bigquery", "--maximum_bytes_billed=abc", sql)
+
+
+@pytest.mark.parametrize(
+    "param_value,expected", [("987654321", "987654321"), ("None", "0")]
+)
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_w_maximum_bytes_billed_overrides_context(param_value, expected):
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+
+    # Set the default maximum bytes billed, so we know it's overridable by the param.
+    magics.context.default_query_job_config.maximum_bytes_billed = 1234567
+
+    project = "test-project"
+    job_reference = copy.deepcopy(JOB_REFERENCE_RESOURCE)
+    job_reference["projectId"] = project
+    query = "SELECT 17 AS num"
+    resource = copy.deepcopy(QUERY_RESOURCE)
+    resource["jobReference"] = job_reference
+    resource["configuration"]["query"]["query"] = query
+    data = {"jobReference": job_reference, "totalRows": 0, "rows": []}
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+    conn = magics.context._connection = make_connection(resource, data)
+    list_rows_patch = mock.patch(
+        "google.cloud.bigquery.client.Client.list_rows",
+        return_value=google.cloud.bigquery.table._EmptyRowIterator(),
+    )
+    with list_rows_patch, default_patch:
+        ip.run_cell_magic(
+            "bigquery", "--maximum_bytes_billed={}".format(param_value), query
+        )
+
+    _, req = conn.api_request.call_args_list[0]
+    sent_config = req["data"]["configuration"]["query"]
+    assert sent_config["maximumBytesBilled"] == expected
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_w_maximum_bytes_billed_w_context_inplace():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+
+    magics.context.default_query_job_config.maximum_bytes_billed = 1337
+
+    project = "test-project"
+    job_reference = copy.deepcopy(JOB_REFERENCE_RESOURCE)
+    job_reference["projectId"] = project
+    query = "SELECT 17 AS num"
+    resource = copy.deepcopy(QUERY_RESOURCE)
+    resource["jobReference"] = job_reference
+    resource["configuration"]["query"]["query"] = query
+    data = {"jobReference": job_reference, "totalRows": 0, "rows": []}
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+    conn = magics.context._connection = make_connection(resource, data)
+    list_rows_patch = mock.patch(
+        "google.cloud.bigquery.client.Client.list_rows",
+        return_value=google.cloud.bigquery.table._EmptyRowIterator(),
+    )
+    with list_rows_patch, default_patch:
+        ip.run_cell_magic("bigquery", "", query)
+
+    _, req = conn.api_request.call_args_list[0]
+    sent_config = req["data"]["configuration"]["query"]
+    assert sent_config["maximumBytesBilled"] == "1337"
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_w_maximum_bytes_billed_w_context_setter():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+
+    magics.context.default_query_job_config = job.QueryJobConfig(
+        maximum_bytes_billed=10203
+    )
+
+    project = "test-project"
+    job_reference = copy.deepcopy(JOB_REFERENCE_RESOURCE)
+    job_reference["projectId"] = project
+    query = "SELECT 17 AS num"
+    resource = copy.deepcopy(QUERY_RESOURCE)
+    resource["jobReference"] = job_reference
+    resource["configuration"]["query"]["query"] = query
+    data = {"jobReference": job_reference, "totalRows": 0, "rows": []}
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+    conn = magics.context._connection = make_connection(resource, data)
+    list_rows_patch = mock.patch(
+        "google.cloud.bigquery.client.Client.list_rows",
+        return_value=google.cloud.bigquery.table._EmptyRowIterator(),
+    )
+    with list_rows_patch, default_patch:
+        ip.run_cell_magic("bigquery", "", query)
+
+    _, req = conn.api_request.call_args_list[0]
+    sent_config = req["data"]["configuration"]["query"]
+    assert sent_config["maximumBytesBilled"] == "10203"
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_with_project():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context._project = None
+
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    with run_query_patch as run_query_mock, default_patch:
+        ip.run_cell_magic("bigquery", "--project=specific-project", "SELECT 17 as num")
+
+        client_used = run_query_mock.call_args_list[0][0][0]
+        assert client_used.project == "specific-project"
+        # context project should not change
+        assert magics.context.project == "general-project"
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_bigquery_magic_with_string_params():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    sql = "SELECT @num AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    assert "params_string_df" not in ip.user_ns
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+    with run_query_patch as run_query_mock:
+        run_query_mock.return_value = query_job_mock
+
+        ip.run_cell_magic("bigquery", 'params_string_df --params {"num":17}', sql)
+        run_query_mock.assert_called_once_with(mock.ANY, sql.format(num=17), mock.ANY)
+
+    assert "params_string_df" in ip.user_ns  # verify that the variable exists
+    df = ip.user_ns["params_string_df"]
+    assert len(df) == len(result)  # verify row count
+    assert list(df) == list(result)  # verify column names
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_bigquery_magic_with_dict_params():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    sql = "SELECT @num AS num"
+    result = pandas.DataFrame([17], columns=["num"])
+    assert "params_dict_df" not in ip.user_ns
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query", autospec=True
+    )
+    query_job_mock = mock.create_autospec(
+        google.cloud.bigquery.job.QueryJob, instance=True
+    )
+    query_job_mock.to_dataframe.return_value = result
+    with run_query_patch as run_query_mock:
+        run_query_mock.return_value = query_job_mock
+
+        params = {"num": 17}
+        # Insert dictionary into user namespace so that it can be expanded
+        ip.user_ns["params"] = params
+        ip.run_cell_magic("bigquery", "params_dict_df --params $params", sql)
+        run_query_mock.assert_called_once_with(mock.ANY, sql.format(num=17), mock.ANY)
+
+    assert "params_dict_df" in ip.user_ns  # verify that the variable exists
+    df = ip.user_ns["params_dict_df"]
+    assert len(df) == len(result)  # verify row count
+    assert list(df) == list(result)  # verify column names
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+@pytest.mark.skipif(pandas is None, reason="Requires `pandas`")
+def test_bigquery_magic_with_improperly_formatted_params():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+    magics.context.credentials = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+
+    sql = "SELECT @num AS num"
+
+    with pytest.raises(SyntaxError):
+        ip.run_cell_magic("bigquery", "--params {17}", sql)
+
+
+@pytest.mark.usefixtures("ipython_interactive")
+def test_bigquery_magic_omits_tracebacks_from_error_message():
+    ip = IPython.get_ipython()
+    ip.extension_manager.load_extension("google.cloud.bigquery")
+
+    credentials_mock = mock.create_autospec(
+        google.auth.credentials.Credentials, instance=True
+    )
+    default_patch = mock.patch(
+        "google.auth.default", return_value=(credentials_mock, "general-project")
+    )
+
+    run_query_patch = mock.patch(
+        "google.cloud.bigquery.magics._run_query",
+        autospec=True,
+        side_effect=exceptions.BadRequest("Syntax error in SQL query"),
+    )
+
+    with run_query_patch, default_patch, io.capture_output() as captured_io:
+        ip.run_cell_magic("bigquery", "", "SELECT foo FROM WHERE LIMIT bar")
+
+    output = captured_io.stderr
+    assert "400 Syntax error in SQL query" in output
+    assert "Traceback (most recent call last)" not in output
+    assert "Syntax error" not in captured_io.stdout
diff --git a/bigquery/tests/unit/test_query.py b/bigquery/tests/unit/test_query.py
new file mode 100644
index 000000000000..a7c639ed1e77
--- /dev/null
+++ b/bigquery/tests/unit/test_query.py
@@ -0,0 +1,1111 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import unittest
+
+import mock
+
+
+class Test_UDFResource(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.query import UDFResource
+
+        return UDFResource
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        udf = self._make_one("resourceUri", "gs://some_bucket/some_file")
+        self.assertEqual(udf.udf_type, "resourceUri")
+        self.assertEqual(udf.value, "gs://some_bucket/some_file")
+
+    def test___eq__(self):
+        udf = self._make_one("resourceUri", "gs://some_bucket/some_file")
+        self.assertEqual(udf, udf)
+        self.assertNotEqual(udf, object())
+        wrong_val = self._make_one("resourceUri", "gs://some_bucket/other_file")
+        self.assertNotEqual(udf, wrong_val)
+        wrong_type = self._make_one("inlineCode", udf.value)
+        self.assertNotEqual(udf, wrong_type)
+
+
+class Test__AbstractQueryParameter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.query import _AbstractQueryParameter
+
+        return _AbstractQueryParameter
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_from_api_virtual(self):
+        klass = self._get_target_class()
+        with self.assertRaises(NotImplementedError):
+            klass.from_api_repr({})
+
+    def test_to_api_virtual(self):
+        param = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            param.to_api_repr()
+
+
+class Test_ScalarQueryParameter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        return ScalarQueryParameter
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        param = self._make_one(name="foo", type_="INT64", value=123)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.type_, "INT64")
+        self.assertEqual(param.value, 123)
+
+    def test___eq__(self):
+        param = self._make_one(name="foo", type_="INT64", value=123)
+        self.assertEqual(param, param)
+        self.assertNotEqual(param, object())
+        alias = self._make_one(name="bar", type_="INT64", value=123)
+        self.assertNotEqual(param, alias)
+        wrong_type = self._make_one(name="foo", type_="FLOAT64", value=123.0)
+        self.assertNotEqual(param, wrong_type)
+        wrong_val = self._make_one(name="foo", type_="INT64", value=234)
+        self.assertNotEqual(param, wrong_val)
+
+    def test_positional(self):
+        klass = self._get_target_class()
+        param = klass.positional(type_="INT64", value=123)
+        self.assertEqual(param.name, None)
+        self.assertEqual(param.type_, "INT64")
+        self.assertEqual(param.value, 123)
+
+    def test_from_api_repr_w_name(self):
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {"type": "INT64"},
+            "parameterValue": {"value": 123},
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.type_, "INT64")
+        self.assertEqual(param.value, 123)
+
+    def test_from_api_repr_wo_name(self):
+        RESOURCE = {
+            "parameterType": {"type": "INT64"},
+            "parameterValue": {"value": "123"},
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, None)
+        self.assertEqual(param.type_, "INT64")
+        self.assertEqual(param.value, 123)
+
+    def test_from_api_repr_wo_value(self):
+        # Back-end may not send back values for None params. See #9027
+        RESOURCE = {"name": "foo", "parameterType": {"type": "INT64"}}
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.type_, "INT64")
+        self.assertIs(param.value, None)
+
+    def test_to_api_repr_w_name(self):
+        EXPECTED = {
+            "name": "foo",
+            "parameterType": {"type": "INT64"},
+            "parameterValue": {"value": "123"},
+        }
+        param = self._make_one(name="foo", type_="INT64", value=123)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_wo_name(self):
+        EXPECTED = {
+            "parameterType": {"type": "INT64"},
+            "parameterValue": {"value": "123"},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="INT64", value=123)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_float(self):
+        EXPECTED = {
+            "parameterType": {"type": "FLOAT64"},
+            "parameterValue": {"value": 12.345},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="FLOAT64", value=12.345)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_numeric(self):
+        EXPECTED = {
+            "parameterType": {"type": "NUMERIC"},
+            "parameterValue": {"value": "123456789.123456789"},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="NUMERIC", value="123456789.123456789")
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_bool(self):
+        EXPECTED = {
+            "parameterType": {"type": "BOOL"},
+            "parameterValue": {"value": "false"},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="BOOL", value=False)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_timestamp_datetime(self):
+        from google.cloud._helpers import UTC
+
+        STAMP = "2016-12-20 15:58:27.339328+00:00"
+        when = datetime.datetime(2016, 12, 20, 15, 58, 27, 339328, tzinfo=UTC)
+        EXPECTED = {
+            "parameterType": {"type": "TIMESTAMP"},
+            "parameterValue": {"value": STAMP},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="TIMESTAMP", value=when)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_timestamp_micros(self):
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        now = datetime.datetime.utcnow()
+        seconds = _microseconds_from_datetime(now) / 1.0e6
+        EXPECTED = {
+            "parameterType": {"type": "TIMESTAMP"},
+            "parameterValue": {"value": seconds},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="TIMESTAMP", value=seconds)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_datetime_datetime(self):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        now = datetime.datetime.utcnow()
+        EXPECTED = {
+            "parameterType": {"type": "DATETIME"},
+            "parameterValue": {
+                "value": _datetime_to_rfc3339(now)[:-1]  # strip trailing 'Z'
+            },
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="DATETIME", value=now)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_datetime_string(self):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        now = datetime.datetime.utcnow()
+        now_str = _datetime_to_rfc3339(now)
+        EXPECTED = {
+            "parameterType": {"type": "DATETIME"},
+            "parameterValue": {"value": now_str},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="DATETIME", value=now_str)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_date_date(self):
+        today = datetime.date.today()
+        EXPECTED = {
+            "parameterType": {"type": "DATE"},
+            "parameterValue": {"value": today.isoformat()},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="DATE", value=today)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_date_string(self):
+        today = datetime.date.today()
+        today_str = (today.isoformat(),)
+        EXPECTED = {
+            "parameterType": {"type": "DATE"},
+            "parameterValue": {"value": today_str},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="DATE", value=today_str)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_unknown_type(self):
+        EXPECTED = {
+            "parameterType": {"type": "UNKNOWN"},
+            "parameterValue": {"value": "unknown"},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(type_="UNKNOWN", value="unknown")
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test___eq___wrong_type(self):
+        field = self._make_one("test", "STRING", "value")
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___eq___name_mismatch(self):
+        field = self._make_one("test", "STRING", "value")
+        other = self._make_one("other", "STRING", "value")
+        self.assertNotEqual(field, other)
+
+    def test___eq___field_type_mismatch(self):
+        field = self._make_one("test", "STRING", None)
+        other = self._make_one("test", "INT64", None)
+        self.assertNotEqual(field, other)
+
+    def test___eq___value_mismatch(self):
+        field = self._make_one("test", "STRING", "hello")
+        other = self._make_one("test", "STRING", "world")
+        self.assertNotEqual(field, other)
+
+    def test___eq___hit(self):
+        field = self._make_one("test", "STRING", "gotcha")
+        other = self._make_one("test", "STRING", "gotcha")
+        self.assertEqual(field, other)
+
+    def test___ne___wrong_type(self):
+        field = self._make_one("toast", "INT64", 13)
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___ne___same_value(self):
+        field1 = self._make_one("test", "INT64", 12)
+        field2 = self._make_one("test", "INT64", 12)
+        # unittest ``assertEqual`` uses ``==`` not ``!=``.
+        comparison_val = field1 != field2
+        self.assertFalse(comparison_val)
+
+    def test___ne___different_values(self):
+        field1 = self._make_one("test", "INT64", 11)
+        field2 = self._make_one("test", "INT64", 12)
+        self.assertNotEqual(field1, field2)
+
+    def test___repr__(self):
+        field1 = self._make_one("field1", "STRING", "value")
+        expected = "ScalarQueryParameter('field1', 'STRING', 'value')"
+        self.assertEqual(repr(field1), expected)
+
+
+def _make_subparam(name, type_, value):
+    from google.cloud.bigquery.query import ScalarQueryParameter
+
+    return ScalarQueryParameter(name, type_, value)
+
+
+class Test_ArrayQueryParameter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.query import ArrayQueryParameter
+
+        return ArrayQueryParameter
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        param = self._make_one(name="foo", array_type="INT64", values=[1, 2])
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.array_type, "INT64")
+        self.assertEqual(param.values, [1, 2])
+
+    def test___eq__(self):
+        param = self._make_one(name="foo", array_type="INT64", values=[123])
+        self.assertEqual(param, param)
+        self.assertNotEqual(param, object())
+        alias = self._make_one(name="bar", array_type="INT64", values=[123])
+        self.assertNotEqual(param, alias)
+        wrong_type = self._make_one(name="foo", array_type="FLOAT64", values=[123.0])
+        self.assertNotEqual(param, wrong_type)
+        wrong_val = self._make_one(name="foo", array_type="INT64", values=[234])
+        self.assertNotEqual(param, wrong_val)
+
+    def test_positional(self):
+        klass = self._get_target_class()
+        param = klass.positional(array_type="INT64", values=[1, 2])
+        self.assertEqual(param.name, None)
+        self.assertEqual(param.array_type, "INT64")
+        self.assertEqual(param.values, [1, 2])
+
+    def test_from_api_repr_w_name(self):
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+            "parameterValue": {"arrayValues": [{"value": "1"}, {"value": "2"}]},
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.array_type, "INT64")
+        self.assertEqual(param.values, [1, 2])
+
+    def test_from_api_repr_wo_name(self):
+        RESOURCE = {
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+            "parameterValue": {"arrayValues": [{"value": "1"}, {"value": "2"}]},
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, None)
+        self.assertEqual(param.array_type, "INT64")
+        self.assertEqual(param.values, [1, 2])
+
+    def test_from_api_repr_wo_values(self):
+        # Back-end may not send back values for empty array params. See #7309
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.array_type, "INT64")
+        self.assertEqual(param.values, [])
+
+    def test_from_api_repr_w_struct_type(self):
+        from google.cloud.bigquery.query import StructQueryParameter
+
+        RESOURCE = {
+            "parameterType": {
+                "type": "ARRAY",
+                "arrayType": {
+                    "type": "STRUCT",
+                    "structTypes": [
+                        {"name": "name", "type": {"type": "STRING"}},
+                        {"name": "age", "type": {"type": "INT64"}},
+                    ],
+                },
+            },
+            "parameterValue": {
+                "arrayValues": [
+                    {
+                        "structValues": {
+                            "name": {"value": "Phred Phlyntstone"},
+                            "age": {"value": "32"},
+                        }
+                    },
+                    {
+                        "structValues": {
+                            "name": {"value": "Bharney Rhubbyl"},
+                            "age": {"value": "31"},
+                        }
+                    },
+                ]
+            },
+        }
+
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+
+        phred = StructQueryParameter.positional(
+            _make_subparam("name", "STRING", "Phred Phlyntstone"),
+            _make_subparam("age", "INT64", 32),
+        )
+        bharney = StructQueryParameter.positional(
+            _make_subparam("name", "STRING", "Bharney Rhubbyl"),
+            _make_subparam("age", "INT64", 31),
+        )
+        self.assertEqual(param.array_type, "STRUCT")
+        self.assertEqual(param.values, [phred, bharney])
+
+    def test_to_api_repr_w_name(self):
+        EXPECTED = {
+            "name": "foo",
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+            "parameterValue": {"arrayValues": [{"value": "1"}, {"value": "2"}]},
+        }
+        param = self._make_one(name="foo", array_type="INT64", values=[1, 2])
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_wo_name(self):
+        EXPECTED = {
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+            "parameterValue": {"arrayValues": [{"value": "1"}, {"value": "2"}]},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(array_type="INT64", values=[1, 2])
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_unknown_type(self):
+        EXPECTED = {
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "UNKNOWN"}},
+            "parameterValue": {"arrayValues": [{"value": "unknown"}]},
+        }
+        klass = self._get_target_class()
+        param = klass.positional(array_type="UNKNOWN", values=["unknown"])
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_record_type(self):
+        from google.cloud.bigquery.query import StructQueryParameter
+
+        EXPECTED = {
+            "parameterType": {
+                "type": "ARRAY",
+                "arrayType": {
+                    "type": "STRUCT",
+                    "structTypes": [
+                        {"name": "foo", "type": {"type": "STRING"}},
+                        {"name": "bar", "type": {"type": "INT64"}},
+                    ],
+                },
+            },
+            "parameterValue": {
+                "arrayValues": [
+                    {"structValues": {"foo": {"value": "Foo"}, "bar": {"value": "123"}}}
+                ]
+            },
+        }
+        one = _make_subparam("foo", "STRING", "Foo")
+        another = _make_subparam("bar", "INT64", 123)
+        struct = StructQueryParameter.positional(one, another)
+        klass = self._get_target_class()
+        param = klass.positional(array_type="RECORD", values=[struct])
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test___eq___wrong_type(self):
+        field = self._make_one("test", "STRING", ["value"])
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___eq___name_mismatch(self):
+        field = self._make_one("field", "STRING", ["value"])
+        other = self._make_one("other", "STRING", ["value"])
+        self.assertNotEqual(field, other)
+
+    def test___eq___field_type_mismatch(self):
+        field = self._make_one("test", "STRING", [])
+        other = self._make_one("test", "INT64", [])
+        self.assertNotEqual(field, other)
+
+    def test___eq___value_mismatch(self):
+        field = self._make_one("test", "STRING", ["hello"])
+        other = self._make_one("test", "STRING", ["hello", "world"])
+        self.assertNotEqual(field, other)
+
+    def test___eq___hit(self):
+        field = self._make_one("test", "STRING", ["gotcha"])
+        other = self._make_one("test", "STRING", ["gotcha"])
+        self.assertEqual(field, other)
+
+    def test___ne___wrong_type(self):
+        field = self._make_one("toast", "INT64", [13])
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___ne___same_value(self):
+        field1 = self._make_one("test", "INT64", [12])
+        field2 = self._make_one("test", "INT64", [12])
+        # unittest ``assertEqual`` uses ``==`` not ``!=``.
+        comparison_val = field1 != field2
+        self.assertFalse(comparison_val)
+
+    def test___ne___different_values(self):
+        field1 = self._make_one("test", "INT64", [11])
+        field2 = self._make_one("test", "INT64", [12])
+        self.assertNotEqual(field1, field2)
+
+    def test___repr__(self):
+        field1 = self._make_one("field1", "STRING", ["value"])
+        expected = "ArrayQueryParameter('field1', 'STRING', ['value'])"
+        self.assertEqual(repr(field1), expected)
+
+
+class Test_StructQueryParameter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.query import StructQueryParameter
+
+        return StructQueryParameter
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        sub_1 = _make_subparam("bar", "INT64", 123)
+        sub_2 = _make_subparam("baz", "STRING", "abc")
+        param = self._make_one("foo", sub_1, sub_2)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.struct_types, {"bar": "INT64", "baz": "STRING"})
+        self.assertEqual(param.struct_values, {"bar": 123, "baz": "abc"})
+
+    def test___eq__(self):
+        sub_1 = _make_subparam("bar", "INT64", 123)
+        sub_2 = _make_subparam("baz", "STRING", "abc")
+        sub_3 = _make_subparam("baz", "STRING", "def")
+        sub_1_float = _make_subparam("bar", "FLOAT64", 123.0)
+        param = self._make_one("foo", sub_1, sub_2)
+        self.assertEqual(param, param)
+        self.assertNotEqual(param, object())
+        alias = self._make_one("bar", sub_1, sub_2)
+        self.assertNotEqual(param, alias)
+        wrong_type = self._make_one("foo", sub_1_float, sub_2)
+        self.assertNotEqual(param, wrong_type)
+        wrong_val = self._make_one("foo", sub_2, sub_3)
+        self.assertNotEqual(param, wrong_val)
+
+    def test_positional(self):
+        sub_1 = _make_subparam("bar", "INT64", 123)
+        sub_2 = _make_subparam("baz", "STRING", "abc")
+        klass = self._get_target_class()
+        param = klass.positional(sub_1, sub_2)
+        self.assertEqual(param.name, None)
+        self.assertEqual(param.struct_types, {"bar": "INT64", "baz": "STRING"})
+        self.assertEqual(param.struct_values, {"bar": 123, "baz": "abc"})
+
+    def test_from_api_repr_w_name(self):
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "INT64"}},
+                    {"name": "baz", "type": {"type": "STRING"}},
+                ],
+            },
+            "parameterValue": {
+                "structValues": {"bar": {"value": 123}, "baz": {"value": "abc"}}
+            },
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.struct_types, {"bar": "INT64", "baz": "STRING"})
+        self.assertEqual(param.struct_values, {"bar": 123, "baz": "abc"})
+
+    def test_from_api_repr_wo_name(self):
+        RESOURCE = {
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "INT64"}},
+                    {"name": "baz", "type": {"type": "STRING"}},
+                ],
+            },
+            "parameterValue": {
+                "structValues": {"bar": {"value": 123}, "baz": {"value": "abc"}}
+            },
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(param.name, None)
+        self.assertEqual(param.struct_types, {"bar": "INT64", "baz": "STRING"})
+        self.assertEqual(param.struct_values, {"bar": 123, "baz": "abc"})
+
+    def test_from_api_repr_w_nested_array(self):
+        from google.cloud.bigquery.query import ArrayQueryParameter
+
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "STRING"}},
+                    {
+                        "name": "baz",
+                        "type": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+                    },
+                ],
+            },
+            "parameterValue": {
+                "structValues": {
+                    "bar": {"value": "abc"},
+                    "baz": {"arrayValues": [{"value": "123"}, {"value": "456"}]},
+                }
+            },
+        }
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+        self.assertEqual(
+            param,
+            self._make_one(
+                "foo",
+                _make_subparam("bar", "STRING", "abc"),
+                ArrayQueryParameter("baz", "INT64", [123, 456]),
+            ),
+        )
+
+    def test_from_api_repr_w_nested_struct(self):
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "STRING"}},
+                    {
+                        "name": "baz",
+                        "type": {
+                            "type": "STRUCT",
+                            "structTypes": [
+                                {"name": "qux", "type": {"type": "INT64"}},
+                                {"name": "spam", "type": {"type": "BOOL"}},
+                            ],
+                        },
+                    },
+                ],
+            },
+            "parameterValue": {
+                "structValues": {
+                    "bar": {"value": "abc"},
+                    "baz": {
+                        "structValues": {
+                            "qux": {"value": "123"},
+                            "spam": {"value": "true"},
+                        }
+                    },
+                }
+            },
+        }
+
+        klass = self._get_target_class()
+        param = klass.from_api_repr(RESOURCE)
+
+        expected = self._make_one(
+            "foo",
+            _make_subparam("bar", "STRING", "abc"),
+            self._make_one(
+                "baz",
+                _make_subparam("qux", "INT64", 123),
+                _make_subparam("spam", "BOOL", True),
+            ),
+        )
+        self.assertEqual(param.name, "foo")
+        self.assertEqual(param.struct_types, expected.struct_types)
+        self.assertEqual(param.struct_values, expected.struct_values)
+
+    def test_to_api_repr_w_name(self):
+        EXPECTED = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "INT64"}},
+                    {"name": "baz", "type": {"type": "STRING"}},
+                ],
+            },
+            "parameterValue": {
+                "structValues": {"bar": {"value": "123"}, "baz": {"value": "abc"}}
+            },
+        }
+        sub_1 = _make_subparam("bar", "INT64", 123)
+        sub_2 = _make_subparam("baz", "STRING", "abc")
+        param = self._make_one("foo", sub_1, sub_2)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_wo_name(self):
+        EXPECTED = {
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "INT64"}},
+                    {"name": "baz", "type": {"type": "STRING"}},
+                ],
+            },
+            "parameterValue": {
+                "structValues": {"bar": {"value": "123"}, "baz": {"value": "abc"}}
+            },
+        }
+        sub_1 = _make_subparam("bar", "INT64", 123)
+        sub_2 = _make_subparam("baz", "STRING", "abc")
+        klass = self._get_target_class()
+        param = klass.positional(sub_1, sub_2)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_nested_array(self):
+        from google.cloud.bigquery.query import ArrayQueryParameter
+
+        EXPECTED = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "STRING"}},
+                    {
+                        "name": "baz",
+                        "type": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+                    },
+                ],
+            },
+            "parameterValue": {
+                "structValues": {
+                    "bar": {"value": "abc"},
+                    "baz": {"arrayValues": [{"value": "123"}, {"value": "456"}]},
+                }
+            },
+        }
+        scalar = _make_subparam("bar", "STRING", "abc")
+        array = ArrayQueryParameter("baz", "INT64", [123, 456])
+        param = self._make_one("foo", scalar, array)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test_to_api_repr_w_nested_struct(self):
+        EXPECTED = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "bar", "type": {"type": "STRING"}},
+                    {
+                        "name": "baz",
+                        "type": {
+                            "type": "STRUCT",
+                            "structTypes": [
+                                {"name": "qux", "type": {"type": "INT64"}},
+                                {"name": "spam", "type": {"type": "BOOL"}},
+                            ],
+                        },
+                    },
+                ],
+            },
+            "parameterValue": {
+                "structValues": {
+                    "bar": {"value": "abc"},
+                    "baz": {
+                        "structValues": {
+                            "qux": {"value": "123"},
+                            "spam": {"value": "true"},
+                        }
+                    },
+                }
+            },
+        }
+        scalar_1 = _make_subparam("bar", "STRING", "abc")
+        scalar_2 = _make_subparam("qux", "INT64", 123)
+        scalar_3 = _make_subparam("spam", "BOOL", True)
+        sub = self._make_one("baz", scalar_2, scalar_3)
+        param = self._make_one("foo", scalar_1, sub)
+        self.assertEqual(param.to_api_repr(), EXPECTED)
+
+    def test___eq___wrong_type(self):
+        field = self._make_one("test", _make_subparam("bar", "STRING", "abc"))
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___eq___name_mismatch(self):
+        field = self._make_one("test", _make_subparam("bar", "STRING", "abc"))
+        other = self._make_one("other ", _make_subparam("bar", "STRING", "abc"))
+        self.assertNotEqual(field, other)
+
+    def test___eq___field_type_mismatch(self):
+        field = self._make_one("test", _make_subparam("bar", "STRING", None))
+        other = self._make_one("test", _make_subparam("bar", "INT64", None))
+        self.assertNotEqual(field, other)
+
+    def test___eq___value_mismatch(self):
+        field = self._make_one("test", _make_subparam("bar", "STRING", "hello"))
+        other = self._make_one("test", _make_subparam("bar", "STRING", "world"))
+        self.assertNotEqual(field, other)
+
+    def test___eq___hit(self):
+        field = self._make_one("test", _make_subparam("bar", "STRING", "gotcha"))
+        other = self._make_one("test", _make_subparam("bar", "STRING", "gotcha"))
+        self.assertEqual(field, other)
+
+    def test___ne___wrong_type(self):
+        field = self._make_one("test", _make_subparam("bar", "STRING", "hello"))
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___ne___same_value(self):
+        field1 = self._make_one("test", _make_subparam("bar", "STRING", "hello"))
+        field2 = self._make_one("test", _make_subparam("bar", "STRING", "hello"))
+        # unittest ``assertEqual`` uses ``==`` not ``!=``.
+        comparison_val = field1 != field2
+        self.assertFalse(comparison_val)
+
+    def test___ne___different_values(self):
+        field1 = self._make_one("test", _make_subparam("bar", "STRING", "hello"))
+        field2 = self._make_one("test", _make_subparam("bar", "STRING", "world"))
+        self.assertNotEqual(field1, field2)
+
+    def test___repr__(self):
+        field1 = self._make_one("test", _make_subparam("field1", "STRING", "hello"))
+        got = repr(field1)
+        self.assertIn("StructQueryParameter", got)
+        self.assertIn("'field1', 'STRING'", got)
+        self.assertIn("'field1': 'hello'", got)
+
+
+class Test_QueryResults(unittest.TestCase):
+    PROJECT = "project"
+    JOB_ID = "test-synchronous-query"
+    TOKEN = "TOKEN"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.query import _QueryResults
+
+        return _QueryResults
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _make_resource(self):
+        return {"jobReference": {"projectId": self.PROJECT, "jobId": self.JOB_ID}}
+
+    def _verifySchema(self, query, resource):
+        from google.cloud.bigquery.schema import SchemaField
+
+        if "schema" in resource:
+            fields = resource["schema"]["fields"]
+            self.assertEqual(len(query.schema), len(fields))
+            for found, expected in zip(query.schema, fields):
+                self.assertIsInstance(found, SchemaField)
+                self.assertEqual(found.name, expected["name"])
+                self.assertEqual(found.field_type, expected["type"])
+                self.assertEqual(found.mode, expected["mode"])
+                self.assertEqual(found.description, expected.get("description"))
+                self.assertEqual(found.fields, expected.get("fields", ()))
+        else:
+            self.assertEqual(query.schema, ())
+
+    def test_ctor_defaults(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.cache_hit)
+        self.assertIsNone(query.complete)
+        self.assertIsNone(query.errors)
+        self.assertIsNone(query.page_token)
+        self.assertEqual(query.project, self.PROJECT)
+        self.assertEqual(query.rows, [])
+        self.assertEqual(query.schema, ())
+        self.assertIsNone(query.total_rows)
+        self.assertIsNone(query.total_bytes_processed)
+
+    def test_cache_hit_missing(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.cache_hit)
+
+    def test_cache_hit_present(self):
+        resource = self._make_resource()
+        resource["cacheHit"] = True
+        query = self._make_one(resource)
+        self.assertTrue(query.cache_hit)
+
+    def test_complete_missing(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.complete)
+
+    def test_complete_present(self):
+        resource = self._make_resource()
+        resource["jobComplete"] = True
+        query = self._make_one(resource)
+        self.assertTrue(query.complete)
+
+    def test_errors_missing(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.errors)
+
+    def test_errors_present(self):
+        ERRORS = [{"reason": "testing"}]
+        resource = self._make_resource()
+        resource["errors"] = ERRORS
+        query = self._make_one(resource)
+        self.assertEqual(query.errors, ERRORS)
+
+    def test_job_id_missing(self):
+        with self.assertRaises(ValueError):
+            self._make_one({})
+
+    def test_job_id_broken_job_reference(self):
+        resource = {"jobReference": {"bogus": "BOGUS"}}
+        with self.assertRaises(ValueError):
+            self._make_one(resource)
+
+    def test_job_id_present(self):
+        resource = self._make_resource()
+        resource["jobReference"]["jobId"] = "custom-job"
+        query = self._make_one(resource)
+        self.assertEqual(query.job_id, "custom-job")
+
+    def test_page_token_missing(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.page_token)
+
+    def test_page_token_present(self):
+        resource = self._make_resource()
+        resource["pageToken"] = "TOKEN"
+        query = self._make_one(resource)
+        self.assertEqual(query.page_token, "TOKEN")
+
+    def test_total_rows_present_integer(self):
+        resource = self._make_resource()
+        resource["totalRows"] = 42
+        query = self._make_one(resource)
+        self.assertEqual(query.total_rows, 42)
+
+    def test_total_rows_present_string(self):
+        resource = self._make_resource()
+        resource["totalRows"] = "42"
+        query = self._make_one(resource)
+        self.assertEqual(query.total_rows, 42)
+
+    def test_total_bytes_processed_missing(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.total_bytes_processed)
+
+    def test_total_bytes_processed_present_integer(self):
+        resource = self._make_resource()
+        resource["totalBytesProcessed"] = 123456
+        query = self._make_one(resource)
+        self.assertEqual(query.total_bytes_processed, 123456)
+
+    def test_total_bytes_processed_present_string(self):
+        resource = self._make_resource()
+        resource["totalBytesProcessed"] = "123456"
+        query = self._make_one(resource)
+        self.assertEqual(query.total_bytes_processed, 123456)
+
+    def test_num_dml_affected_rows_missing(self):
+        query = self._make_one(self._make_resource())
+        self.assertIsNone(query.num_dml_affected_rows)
+
+    def test_num_dml_affected_rows_present_integer(self):
+        resource = self._make_resource()
+        resource["numDmlAffectedRows"] = 123456
+        query = self._make_one(resource)
+        self.assertEqual(query.num_dml_affected_rows, 123456)
+
+    def test_num_dml_affected_rows_present_string(self):
+        resource = self._make_resource()
+        resource["numDmlAffectedRows"] = "123456"
+        query = self._make_one(resource)
+        self.assertEqual(query.num_dml_affected_rows, 123456)
+
+    def test_schema(self):
+        query = self._make_one(self._make_resource())
+        self._verifySchema(query, self._make_resource())
+        resource = self._make_resource()
+        resource["schema"] = {
+            "fields": [
+                {"name": "full_name", "type": "STRING", "mode": "REQURED"},
+                {"name": "age", "type": "INTEGER", "mode": "REQURED"},
+            ]
+        }
+        query._set_properties(resource)
+        self._verifySchema(query, resource)
+
+
+class Test__query_param_from_api_repr(unittest.TestCase):
+    @staticmethod
+    def _call_fut(resource):
+        from google.cloud.bigquery.query import _query_param_from_api_repr
+
+        return _query_param_from_api_repr(resource)
+
+    def test_w_scalar(self):
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {"type": "INT64"},
+            "parameterValue": {"value": "123"},
+        }
+
+        parameter = self._call_fut(RESOURCE)
+
+        self.assertIsInstance(parameter, ScalarQueryParameter)
+        self.assertEqual(parameter.name, "foo")
+        self.assertEqual(parameter.type_, "INT64")
+        self.assertEqual(parameter.value, 123)
+
+    def test_w_scalar_timestamp(self):
+        from google.cloud._helpers import UTC
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        RESOURCE = {
+            "name": "zoned",
+            "parameterType": {"type": "TIMESTAMP"},
+            "parameterValue": {"value": "2012-03-04 05:06:07+00:00"},
+        }
+
+        parameter = self._call_fut(RESOURCE)
+
+        self.assertIsInstance(parameter, ScalarQueryParameter)
+        self.assertEqual(parameter.name, "zoned")
+        self.assertEqual(parameter.type_, "TIMESTAMP")
+        self.assertEqual(
+            parameter.value, datetime.datetime(2012, 3, 4, 5, 6, 7, tzinfo=UTC)
+        )
+
+    def test_w_scalar_timestamp_micros(self):
+        from google.cloud._helpers import UTC
+        from google.cloud.bigquery.query import ScalarQueryParameter
+
+        RESOURCE = {
+            "name": "zoned",
+            "parameterType": {"type": "TIMESTAMP"},
+            "parameterValue": {"value": "2012-03-04 05:06:07.250000+00:00"},
+        }
+
+        parameter = self._call_fut(RESOURCE)
+
+        self.assertIsInstance(parameter, ScalarQueryParameter)
+        self.assertEqual(parameter.name, "zoned")
+        self.assertEqual(parameter.type_, "TIMESTAMP")
+        self.assertEqual(
+            parameter.value, datetime.datetime(2012, 3, 4, 5, 6, 7, 250000, tzinfo=UTC)
+        )
+
+    def test_w_array(self):
+        from google.cloud.bigquery.query import ArrayQueryParameter
+
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {"type": "ARRAY", "arrayType": {"type": "INT64"}},
+            "parameterValue": {"arrayValues": [{"value": "123"}]},
+        }
+
+        parameter = self._call_fut(RESOURCE)
+
+        self.assertIsInstance(parameter, ArrayQueryParameter)
+        self.assertEqual(parameter.name, "foo")
+        self.assertEqual(parameter.array_type, "INT64")
+        self.assertEqual(parameter.values, [123])
+
+    def test_w_struct(self):
+        from google.cloud.bigquery.query import StructQueryParameter
+
+        RESOURCE = {
+            "name": "foo",
+            "parameterType": {
+                "type": "STRUCT",
+                "structTypes": [
+                    {"name": "foo", "type": {"type": "STRING"}},
+                    {"name": "bar", "type": {"type": "INT64"}},
+                ],
+            },
+            "parameterValue": {
+                "structValues": {"foo": {"value": "Foo"}, "bar": {"value": "123"}}
+            },
+        }
+
+        parameter = self._call_fut(RESOURCE)
+
+        self.assertIsInstance(parameter, StructQueryParameter)
+        self.assertEqual(parameter.name, "foo")
+        self.assertEqual(parameter.struct_types, {"foo": "STRING", "bar": "INT64"})
+        self.assertEqual(parameter.struct_values, {"foo": "Foo", "bar": 123})
diff --git a/bigquery/tests/unit/test_retry.py b/bigquery/tests/unit/test_retry.py
new file mode 100644
index 000000000000..d9f867cb30f7
--- /dev/null
+++ b/bigquery/tests/unit/test_retry.py
@@ -0,0 +1,69 @@
+# 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.
+
+import unittest
+
+import mock
+
+
+class Test_should_retry(unittest.TestCase):
+    def _call_fut(self, exc):
+        from google.cloud.bigquery.retry import _should_retry
+
+        return _should_retry(exc)
+
+    def test_wo_errors_attribute(self):
+        self.assertFalse(self._call_fut(object()))
+
+    def test_w_empty_errors(self):
+        exc = mock.Mock(errors=[], spec=["errors"])
+        self.assertFalse(self._call_fut(exc))
+
+    def test_w_non_matching_reason(self):
+        exc = mock.Mock(errors=[{"reason": "bogus"}], spec=["errors"])
+        self.assertFalse(self._call_fut(exc))
+
+    def test_w_backendError(self):
+        exc = mock.Mock(errors=[{"reason": "backendError"}], spec=["errors"])
+        self.assertTrue(self._call_fut(exc))
+
+    def test_w_rateLimitExceeded(self):
+        exc = mock.Mock(errors=[{"reason": "rateLimitExceeded"}], spec=["errors"])
+        self.assertTrue(self._call_fut(exc))
+
+    def test_w_unstructured_too_many_requests(self):
+        from google.api_core.exceptions import TooManyRequests
+
+        exc = TooManyRequests("testing")
+        self.assertTrue(self._call_fut(exc))
+
+    def test_w_internalError(self):
+        exc = mock.Mock(errors=[{"reason": "internalError"}], spec=["errors"])
+        self.assertTrue(self._call_fut(exc))
+
+    def test_w_unstructured_internal_server_error(self):
+        from google.api_core.exceptions import InternalServerError
+
+        exc = InternalServerError("testing")
+        self.assertTrue(self._call_fut(exc))
+
+    def test_w_badGateway(self):
+        exc = mock.Mock(errors=[{"reason": "badGateway"}], spec=["errors"])
+        self.assertTrue(self._call_fut(exc))
+
+    def test_w_unstructured_bad_gateway(self):
+        from google.api_core.exceptions import BadGateway
+
+        exc = BadGateway("testing")
+        self.assertTrue(self._call_fut(exc))
diff --git a/bigquery/tests/unit/test_schema.py b/bigquery/tests/unit/test_schema.py
new file mode 100644
index 000000000000..862d8a823e62
--- /dev/null
+++ b/bigquery/tests/unit/test_schema.py
@@ -0,0 +1,570 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestSchemaField(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.schema import SchemaField
+
+        return SchemaField
+
+    @staticmethod
+    def _get_standard_sql_data_type_class():
+        from google.cloud.bigquery_v2 import types
+
+        return types.StandardSqlDataType
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        field = self._make_one("test", "STRING")
+        self.assertEqual(field._name, "test")
+        self.assertEqual(field._field_type, "STRING")
+        self.assertEqual(field._mode, "NULLABLE")
+        self.assertIsNone(field._description)
+        self.assertEqual(field._fields, ())
+
+    def test_constructor_explicit(self):
+        field = self._make_one("test", "STRING", mode="REQUIRED", description="Testing")
+        self.assertEqual(field._name, "test")
+        self.assertEqual(field._field_type, "STRING")
+        self.assertEqual(field._mode, "REQUIRED")
+        self.assertEqual(field._description, "Testing")
+        self.assertEqual(field._fields, ())
+
+    def test_constructor_subfields(self):
+        sub_field1 = self._make_one("area_code", "STRING")
+        sub_field2 = self._make_one("local_number", "STRING")
+        field = self._make_one(
+            "phone_number", "RECORD", fields=[sub_field1, sub_field2]
+        )
+        self.assertEqual(field._name, "phone_number")
+        self.assertEqual(field._field_type, "RECORD")
+        self.assertEqual(field._mode, "NULLABLE")
+        self.assertIsNone(field._description)
+        self.assertEqual(len(field._fields), 2)
+        self.assertIs(field._fields[0], sub_field1)
+        self.assertIs(field._fields[1], sub_field2)
+
+    def test_to_api_repr(self):
+        field = self._make_one("foo", "INTEGER", "NULLABLE")
+        self.assertEqual(
+            field.to_api_repr(),
+            {"mode": "NULLABLE", "name": "foo", "type": "INTEGER", "description": None},
+        )
+
+    def test_to_api_repr_with_subfield(self):
+        for record_type in ("RECORD", "STRUCT"):
+            subfield = self._make_one("bar", "INTEGER", "NULLABLE")
+            field = self._make_one("foo", record_type, "REQUIRED", fields=(subfield,))
+            self.assertEqual(
+                field.to_api_repr(),
+                {
+                    "fields": [
+                        {
+                            "mode": "NULLABLE",
+                            "name": "bar",
+                            "type": "INTEGER",
+                            "description": None,
+                        }
+                    ],
+                    "mode": "REQUIRED",
+                    "name": "foo",
+                    "type": record_type,
+                    "description": None,
+                },
+            )
+
+    def test_from_api_repr(self):
+        field = self._get_target_class().from_api_repr(
+            {
+                "fields": [{"mode": "nullable", "name": "bar", "type": "integer"}],
+                "mode": "required",
+                "description": "test_description",
+                "name": "foo",
+                "type": "record",
+            }
+        )
+        self.assertEqual(field.name, "foo")
+        self.assertEqual(field.field_type, "RECORD")
+        self.assertEqual(field.mode, "REQUIRED")
+        self.assertEqual(field.description, "test_description")
+        self.assertEqual(len(field.fields), 1)
+        self.assertEqual(field.fields[0].name, "bar")
+        self.assertEqual(field.fields[0].field_type, "INTEGER")
+        self.assertEqual(field.fields[0].mode, "NULLABLE")
+
+    def test_from_api_repr_defaults(self):
+        field = self._get_target_class().from_api_repr(
+            {"name": "foo", "type": "record"}
+        )
+        self.assertEqual(field.name, "foo")
+        self.assertEqual(field.field_type, "RECORD")
+        self.assertEqual(field.mode, "NULLABLE")
+        self.assertEqual(field.description, None)
+        self.assertEqual(len(field.fields), 0)
+
+    def test_name_property(self):
+        name = "lemon-ness"
+        schema_field = self._make_one(name, "INTEGER")
+        self.assertIs(schema_field.name, name)
+
+    def test_field_type_property(self):
+        field_type = "BOOLEAN"
+        schema_field = self._make_one("whether", field_type)
+        self.assertIs(schema_field.field_type, field_type)
+
+    def test_mode_property(self):
+        mode = "REPEATED"
+        schema_field = self._make_one("again", "FLOAT", mode=mode)
+        self.assertIs(schema_field.mode, mode)
+
+    def test_is_nullable(self):
+        mode = "NULLABLE"
+        schema_field = self._make_one("test", "FLOAT", mode=mode)
+        self.assertTrue(schema_field.is_nullable)
+
+    def test_is_not_nullable(self):
+        mode = "REPEATED"
+        schema_field = self._make_one("test", "FLOAT", mode=mode)
+        self.assertFalse(schema_field.is_nullable)
+
+    def test_description_property(self):
+        description = "It holds some data."
+        schema_field = self._make_one("do", "TIMESTAMP", description=description)
+        self.assertIs(schema_field.description, description)
+
+    def test_fields_property(self):
+        sub_field1 = self._make_one("one", "STRING")
+        sub_field2 = self._make_one("fish", "INTEGER")
+        fields = (sub_field1, sub_field2)
+        schema_field = self._make_one("boat", "RECORD", fields=fields)
+        self.assertIs(schema_field.fields, fields)
+
+    def test_to_standard_sql_simple_type(self):
+        sql_type = self._get_standard_sql_data_type_class()
+        examples = (
+            # a few legacy types
+            ("INTEGER", sql_type.INT64),
+            ("FLOAT", sql_type.FLOAT64),
+            ("BOOLEAN", sql_type.BOOL),
+            ("DATETIME", sql_type.DATETIME),
+            # a few standard types
+            ("INT64", sql_type.INT64),
+            ("FLOAT64", sql_type.FLOAT64),
+            ("BOOL", sql_type.BOOL),
+            ("GEOGRAPHY", sql_type.GEOGRAPHY),
+        )
+        for legacy_type, standard_type in examples:
+            field = self._make_one("some_field", legacy_type)
+            standard_field = field.to_standard_sql()
+            self.assertEqual(standard_field.name, "some_field")
+            self.assertEqual(standard_field.type.type_kind, standard_type)
+            self.assertFalse(standard_field.type.HasField("sub_type"))
+
+    def test_to_standard_sql_struct_type(self):
+        from google.cloud.bigquery_v2 import types
+
+        # Expected result object:
+        #
+        # name: "image_usage"
+        # type {
+        #     type_kind: STRUCT
+        #     struct_type {
+        #         fields {
+        #             name: "image_content"
+        #             type {type_kind: BYTES}
+        #         }
+        #         fields {
+        #             name: "last_used"
+        #             type {
+        #                 type_kind: STRUCT
+        #                 struct_type {
+        #                     fields {
+        #                         name: "date_field"
+        #                         type {type_kind: DATE}
+        #                     }
+        #                     fields {
+        #                         name: "time_field"
+        #                         type {type_kind: TIME}
+        #                     }
+        #                 }
+        #             }
+        #         }
+        #     }
+        # }
+
+        sql_type = self._get_standard_sql_data_type_class()
+
+        # level 2 fields
+        sub_sub_field_date = types.StandardSqlField(
+            name="date_field", type=sql_type(type_kind=sql_type.DATE)
+        )
+        sub_sub_field_time = types.StandardSqlField(
+            name="time_field", type=sql_type(type_kind=sql_type.TIME)
+        )
+
+        # level 1 fields
+        sub_field_struct = types.StandardSqlField(
+            name="last_used", type=sql_type(type_kind=sql_type.STRUCT)
+        )
+        sub_field_struct.type.struct_type.fields.extend(
+            [sub_sub_field_date, sub_sub_field_time]
+        )
+        sub_field_bytes = types.StandardSqlField(
+            name="image_content", type=sql_type(type_kind=sql_type.BYTES)
+        )
+
+        # level 0 (top level)
+        expected_result = types.StandardSqlField(
+            name="image_usage", type=sql_type(type_kind=sql_type.STRUCT)
+        )
+        expected_result.type.struct_type.fields.extend(
+            [sub_field_bytes, sub_field_struct]
+        )
+
+        # construct legacy SchemaField object
+        sub_sub_field1 = self._make_one("date_field", "DATE")
+        sub_sub_field2 = self._make_one("time_field", "TIME")
+        sub_field_record = self._make_one(
+            "last_used", "RECORD", fields=(sub_sub_field1, sub_sub_field2)
+        )
+        sub_field_bytes = self._make_one("image_content", "BYTES")
+
+        for type_name in ("RECORD", "STRUCT"):
+            schema_field = self._make_one(
+                "image_usage", type_name, fields=(sub_field_bytes, sub_field_record)
+            )
+            standard_field = schema_field.to_standard_sql()
+            self.assertEqual(standard_field, expected_result)
+
+    def test_to_standard_sql_array_type_simple(self):
+        from google.cloud.bigquery_v2 import types
+
+        sql_type = self._get_standard_sql_data_type_class()
+
+        # construct expected result object
+        expected_sql_type = sql_type(type_kind=sql_type.ARRAY)
+        expected_sql_type.array_element_type.type_kind = sql_type.INT64
+        expected_result = types.StandardSqlField(
+            name="valid_numbers", type=expected_sql_type
+        )
+
+        # construct "repeated" SchemaField object and convert to standard SQL
+        schema_field = self._make_one("valid_numbers", "INT64", mode="REPEATED")
+        standard_field = schema_field.to_standard_sql()
+
+        self.assertEqual(standard_field, expected_result)
+
+    def test_to_standard_sql_array_type_struct(self):
+        from google.cloud.bigquery_v2 import types
+
+        sql_type = self._get_standard_sql_data_type_class()
+
+        # define person STRUCT
+        name_field = types.StandardSqlField(
+            name="name", type=sql_type(type_kind=sql_type.STRING)
+        )
+        age_field = types.StandardSqlField(
+            name="age", type=sql_type(type_kind=sql_type.INT64)
+        )
+        person_struct = types.StandardSqlField(
+            name="person_info", type=sql_type(type_kind=sql_type.STRUCT)
+        )
+        person_struct.type.struct_type.fields.extend([name_field, age_field])
+
+        # define expected result - an ARRAY of person structs
+        expected_sql_type = sql_type(
+            type_kind=sql_type.ARRAY, array_element_type=person_struct.type
+        )
+        expected_result = types.StandardSqlField(
+            name="known_people", type=expected_sql_type
+        )
+
+        # construct legacy repeated SchemaField object
+        sub_field1 = self._make_one("name", "STRING")
+        sub_field2 = self._make_one("age", "INTEGER")
+        schema_field = self._make_one(
+            "known_people", "RECORD", fields=(sub_field1, sub_field2), mode="REPEATED"
+        )
+
+        standard_field = schema_field.to_standard_sql()
+        self.assertEqual(standard_field, expected_result)
+
+    def test_to_standard_sql_unknown_type(self):
+        sql_type = self._get_standard_sql_data_type_class()
+        field = self._make_one("weird_field", "TROOLEAN")
+
+        standard_field = field.to_standard_sql()
+
+        self.assertEqual(standard_field.name, "weird_field")
+        self.assertEqual(standard_field.type.type_kind, sql_type.TYPE_KIND_UNSPECIFIED)
+        self.assertFalse(standard_field.type.HasField("sub_type"))
+
+    def test___eq___wrong_type(self):
+        field = self._make_one("test", "STRING")
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___eq___name_mismatch(self):
+        field = self._make_one("test", "STRING")
+        other = self._make_one("other", "STRING")
+        self.assertNotEqual(field, other)
+
+    def test___eq___field_type_mismatch(self):
+        field = self._make_one("test", "STRING")
+        other = self._make_one("test", "INTEGER")
+        self.assertNotEqual(field, other)
+
+    def test___eq___mode_mismatch(self):
+        field = self._make_one("test", "STRING", mode="REQUIRED")
+        other = self._make_one("test", "STRING", mode="NULLABLE")
+        self.assertNotEqual(field, other)
+
+    def test___eq___description_mismatch(self):
+        field = self._make_one("test", "STRING", description="Testing")
+        other = self._make_one("test", "STRING", description="Other")
+        self.assertNotEqual(field, other)
+
+    def test___eq___fields_mismatch(self):
+        sub1 = self._make_one("sub1", "STRING")
+        sub2 = self._make_one("sub2", "STRING")
+        field = self._make_one("test", "RECORD", fields=[sub1])
+        other = self._make_one("test", "RECORD", fields=[sub2])
+        self.assertNotEqual(field, other)
+
+    def test___eq___hit(self):
+        field = self._make_one("test", "STRING", mode="REQUIRED", description="Testing")
+        other = self._make_one("test", "STRING", mode="REQUIRED", description="Testing")
+        self.assertEqual(field, other)
+
+    def test___eq___hit_case_diff_on_type(self):
+        field = self._make_one("test", "STRING", mode="REQUIRED", description="Testing")
+        other = self._make_one("test", "string", mode="REQUIRED", description="Testing")
+        self.assertEqual(field, other)
+
+    def test___eq___hit_w_fields(self):
+        sub1 = self._make_one("sub1", "STRING")
+        sub2 = self._make_one("sub2", "STRING")
+        field = self._make_one("test", "RECORD", fields=[sub1, sub2])
+        other = self._make_one("test", "RECORD", fields=[sub1, sub2])
+        self.assertEqual(field, other)
+
+    def test___ne___wrong_type(self):
+        field = self._make_one("toast", "INTEGER")
+        other = object()
+        self.assertNotEqual(field, other)
+        self.assertEqual(field, mock.ANY)
+
+    def test___ne___same_value(self):
+        field1 = self._make_one("test", "TIMESTAMP", mode="REPEATED")
+        field2 = self._make_one("test", "TIMESTAMP", mode="REPEATED")
+        # unittest ``assertEqual`` uses ``==`` not ``!=``.
+        comparison_val = field1 != field2
+        self.assertFalse(comparison_val)
+
+    def test___ne___different_values(self):
+        field1 = self._make_one(
+            "test1", "FLOAT", mode="REPEATED", description="Not same"
+        )
+        field2 = self._make_one(
+            "test2", "FLOAT", mode="NULLABLE", description="Knot saym"
+        )
+        self.assertNotEqual(field1, field2)
+
+    def test___hash__set_equality(self):
+        sub1 = self._make_one("sub1", "STRING")
+        sub2 = self._make_one("sub2", "STRING")
+        field1 = self._make_one("test", "RECORD", fields=[sub1])
+        field2 = self._make_one("test", "RECORD", fields=[sub2])
+        set_one = {field1, field2}
+        set_two = {field1, field2}
+        self.assertEqual(set_one, set_two)
+
+    def test___hash__not_equals(self):
+        sub1 = self._make_one("sub1", "STRING")
+        sub2 = self._make_one("sub2", "STRING")
+        field1 = self._make_one("test", "RECORD", fields=[sub1])
+        field2 = self._make_one("test", "RECORD", fields=[sub2])
+        set_one = {field1}
+        set_two = {field2}
+        self.assertNotEqual(set_one, set_two)
+
+    def test___repr__(self):
+        field1 = self._make_one("field1", "STRING")
+        expected = "SchemaField('field1', 'STRING', 'NULLABLE', None, ())"
+        self.assertEqual(repr(field1), expected)
+
+
+# TODO: dedup with the same class in test_table.py.
+class _SchemaBase(object):
+    def _verify_field(self, field, r_field):
+        self.assertEqual(field.name, r_field["name"])
+        self.assertEqual(field.field_type, r_field["type"])
+        self.assertEqual(field.mode, r_field.get("mode", "NULLABLE"))
+
+    def _verifySchema(self, schema, resource):
+        r_fields = resource["schema"]["fields"]
+        self.assertEqual(len(schema), len(r_fields))
+
+        for field, r_field in zip(schema, r_fields):
+            self._verify_field(field, r_field)
+
+
+class Test_parse_schema_resource(unittest.TestCase, _SchemaBase):
+    def _call_fut(self, resource):
+        from google.cloud.bigquery.schema import _parse_schema_resource
+
+        return _parse_schema_resource(resource)
+
+    def _make_resource(self):
+        return {
+            "schema": {
+                "fields": [
+                    {"name": "full_name", "type": "STRING", "mode": "REQUIRED"},
+                    {"name": "age", "type": "INTEGER", "mode": "REQUIRED"},
+                ]
+            }
+        }
+
+    def test__parse_schema_resource_defaults(self):
+        RESOURCE = self._make_resource()
+        schema = self._call_fut(RESOURCE["schema"])
+        self._verifySchema(schema, RESOURCE)
+
+    def test__parse_schema_resource_subfields(self):
+        RESOURCE = self._make_resource()
+        RESOURCE["schema"]["fields"].append(
+            {
+                "name": "phone",
+                "type": "RECORD",
+                "mode": "REPEATED",
+                "fields": [
+                    {"name": "type", "type": "STRING", "mode": "REQUIRED"},
+                    {"name": "number", "type": "STRING", "mode": "REQUIRED"},
+                ],
+            }
+        )
+        schema = self._call_fut(RESOURCE["schema"])
+        self._verifySchema(schema, RESOURCE)
+
+    def test__parse_schema_resource_fields_without_mode(self):
+        RESOURCE = self._make_resource()
+        RESOURCE["schema"]["fields"].append({"name": "phone", "type": "STRING"})
+
+        schema = self._call_fut(RESOURCE["schema"])
+        self._verifySchema(schema, RESOURCE)
+
+
+class Test_build_schema_resource(unittest.TestCase, _SchemaBase):
+    def _call_fut(self, resource):
+        from google.cloud.bigquery.schema import _build_schema_resource
+
+        return _build_schema_resource(resource)
+
+    def test_defaults(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        resource = self._call_fut([full_name, age])
+        self.assertEqual(len(resource), 2)
+        self.assertEqual(
+            resource[0],
+            {
+                "name": "full_name",
+                "type": "STRING",
+                "mode": "REQUIRED",
+                "description": None,
+            },
+        )
+        self.assertEqual(
+            resource[1],
+            {"name": "age", "type": "INTEGER", "mode": "REQUIRED", "description": None},
+        )
+
+    def test_w_description(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        DESCRIPTION = "DESCRIPTION"
+        full_name = SchemaField(
+            "full_name", "STRING", mode="REQUIRED", description=DESCRIPTION
+        )
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        resource = self._call_fut([full_name, age])
+        self.assertEqual(len(resource), 2)
+        self.assertEqual(
+            resource[0],
+            {
+                "name": "full_name",
+                "type": "STRING",
+                "mode": "REQUIRED",
+                "description": DESCRIPTION,
+            },
+        )
+        self.assertEqual(
+            resource[1],
+            {"name": "age", "type": "INTEGER", "mode": "REQUIRED", "description": None},
+        )
+
+    def test_w_subfields(self):
+        from google.cloud.bigquery.schema import SchemaField
+
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        ph_type = SchemaField("type", "STRING", "REQUIRED")
+        ph_num = SchemaField("number", "STRING", "REQUIRED")
+        phone = SchemaField(
+            "phone", "RECORD", mode="REPEATED", fields=[ph_type, ph_num]
+        )
+        resource = self._call_fut([full_name, phone])
+        self.assertEqual(len(resource), 2)
+        self.assertEqual(
+            resource[0],
+            {
+                "name": "full_name",
+                "type": "STRING",
+                "mode": "REQUIRED",
+                "description": None,
+            },
+        )
+        self.assertEqual(
+            resource[1],
+            {
+                "name": "phone",
+                "type": "RECORD",
+                "mode": "REPEATED",
+                "description": None,
+                "fields": [
+                    {
+                        "name": "type",
+                        "type": "STRING",
+                        "mode": "REQUIRED",
+                        "description": None,
+                    },
+                    {
+                        "name": "number",
+                        "type": "STRING",
+                        "mode": "REQUIRED",
+                        "description": None,
+                    },
+                ],
+            },
+        )
diff --git a/bigquery/tests/unit/test_signature_compatibility.py b/bigquery/tests/unit/test_signature_compatibility.py
new file mode 100644
index 000000000000..6002ae3e87c9
--- /dev/null
+++ b/bigquery/tests/unit/test_signature_compatibility.py
@@ -0,0 +1,51 @@
+# 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.
+
+import inspect
+
+import pytest
+
+
+@pytest.fixture
+def query_job_class():
+    from google.cloud.bigquery.job import QueryJob
+
+    return QueryJob
+
+
+@pytest.fixture
+def row_iterator_class():
+    from google.cloud.bigquery.table import RowIterator
+
+    return RowIterator
+
+
+@pytest.mark.skipif(
+    not hasattr(inspect, "signature"),
+    reason="inspect.signature() is not availalbe in older Python versions",
+)
+def test_to_arrow_method_signatures_match(query_job_class, row_iterator_class):
+    sig = inspect.signature(query_job_class.to_arrow)
+    sig2 = inspect.signature(row_iterator_class.to_arrow)
+    assert sig == sig2
+
+
+@pytest.mark.skipif(
+    not hasattr(inspect, "signature"),
+    reason="inspect.signature() is not availalbe in older Python versions",
+)
+def test_to_dataframe_method_signatures_match(query_job_class, row_iterator_class):
+    sig = inspect.signature(query_job_class.to_dataframe)
+    sig2 = inspect.signature(row_iterator_class.to_dataframe)
+    assert sig == sig2
diff --git a/bigquery/tests/unit/test_table.py b/bigquery/tests/unit/test_table.py
new file mode 100644
index 000000000000..8ba7fee892e5
--- /dev/null
+++ b/bigquery/tests/unit/test_table.py
@@ -0,0 +1,3020 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import itertools
+import logging
+import time
+import unittest
+import warnings
+
+import mock
+import pytest
+import six
+
+import google.api_core.exceptions
+
+try:
+    from google.cloud import bigquery_storage_v1beta1
+except ImportError:  # pragma: NO COVER
+    bigquery_storage_v1beta1 = None
+
+try:
+    import pandas
+except (ImportError, AttributeError):  # pragma: NO COVER
+    pandas = None
+
+try:
+    import pyarrow
+    import pyarrow.types
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+
+try:
+    from tqdm import tqdm
+except (ImportError, AttributeError):  # pragma: NO COVER
+    tqdm = None
+
+from google.cloud.bigquery.dataset import DatasetReference
+
+
+def _mock_client():
+    from google.cloud.bigquery import client
+
+    mock_client = mock.create_autospec(client.Client)
+    mock_client.project = "my-project"
+    return mock_client
+
+
+class _SchemaBase(object):
+    def _verify_field(self, field, r_field):
+        self.assertEqual(field.name, r_field["name"])
+        self.assertEqual(field.field_type, r_field["type"])
+        self.assertEqual(field.mode, r_field.get("mode", "NULLABLE"))
+
+    def _verifySchema(self, schema, resource):
+        r_fields = resource["schema"]["fields"]
+        self.assertEqual(len(schema), len(r_fields))
+
+        for field, r_field in zip(schema, r_fields):
+            self._verify_field(field, r_field)
+
+
+class TestEncryptionConfiguration(unittest.TestCase):
+    KMS_KEY_NAME = "projects/1/locations/global/keyRings/1/cryptoKeys/1"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.table import EncryptionConfiguration
+
+        return EncryptionConfiguration
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        encryption_config = self._make_one()
+        self.assertIsNone(encryption_config.kms_key_name)
+
+    def test_ctor_with_key(self):
+        encryption_config = self._make_one(kms_key_name=self.KMS_KEY_NAME)
+        self.assertEqual(encryption_config.kms_key_name, self.KMS_KEY_NAME)
+
+    def test_kms_key_name_setter(self):
+        encryption_config = self._make_one()
+        self.assertIsNone(encryption_config.kms_key_name)
+        encryption_config.kms_key_name = self.KMS_KEY_NAME
+        self.assertEqual(encryption_config.kms_key_name, self.KMS_KEY_NAME)
+        encryption_config.kms_key_name = None
+        self.assertIsNone(encryption_config.kms_key_name)
+
+    def test_from_api_repr(self):
+        RESOURCE = {"kmsKeyName": self.KMS_KEY_NAME}
+        klass = self._get_target_class()
+        encryption_config = klass.from_api_repr(RESOURCE)
+        self.assertEqual(encryption_config.kms_key_name, self.KMS_KEY_NAME)
+
+    def test_to_api_repr(self):
+        encryption_config = self._make_one(kms_key_name=self.KMS_KEY_NAME)
+        resource = encryption_config.to_api_repr()
+        self.assertEqual(resource, {"kmsKeyName": self.KMS_KEY_NAME})
+
+    def test___eq___wrong_type(self):
+        encryption_config = self._make_one()
+        other = object()
+        self.assertNotEqual(encryption_config, other)
+        self.assertEqual(encryption_config, mock.ANY)
+
+    def test___eq___kms_key_name_mismatch(self):
+        encryption_config = self._make_one()
+        other = self._make_one(self.KMS_KEY_NAME)
+        self.assertNotEqual(encryption_config, other)
+
+    def test___eq___hit(self):
+        encryption_config = self._make_one(self.KMS_KEY_NAME)
+        other = self._make_one(self.KMS_KEY_NAME)
+        self.assertEqual(encryption_config, other)
+
+    def test___ne___wrong_type(self):
+        encryption_config = self._make_one()
+        other = object()
+        self.assertNotEqual(encryption_config, other)
+        self.assertEqual(encryption_config, mock.ANY)
+
+    def test___ne___same_value(self):
+        encryption_config1 = self._make_one(self.KMS_KEY_NAME)
+        encryption_config2 = self._make_one(self.KMS_KEY_NAME)
+        # unittest ``assertEqual`` uses ``==`` not ``!=``.
+        comparison_val = encryption_config1 != encryption_config2
+        self.assertFalse(comparison_val)
+
+    def test___ne___different_values(self):
+        encryption_config1 = self._make_one()
+        encryption_config2 = self._make_one(self.KMS_KEY_NAME)
+        self.assertNotEqual(encryption_config1, encryption_config2)
+
+    def test___hash__set_equality(self):
+        encryption_config1 = self._make_one(self.KMS_KEY_NAME)
+        encryption_config2 = self._make_one(self.KMS_KEY_NAME)
+        set_one = {encryption_config1, encryption_config2}
+        set_two = {encryption_config1, encryption_config2}
+        self.assertEqual(set_one, set_two)
+
+    def test___hash__not_equals(self):
+        encryption_config1 = self._make_one()
+        encryption_config2 = self._make_one(self.KMS_KEY_NAME)
+        set_one = {encryption_config1}
+        set_two = {encryption_config2}
+        self.assertNotEqual(set_one, set_two)
+
+    def test___repr__(self):
+        encryption_config = self._make_one(self.KMS_KEY_NAME)
+        expected = "EncryptionConfiguration({})".format(self.KMS_KEY_NAME)
+        self.assertEqual(repr(encryption_config), expected)
+
+
+class TestTableReference(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.table import TableReference
+
+        return TableReference
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset_ref = DatasetReference("project_1", "dataset_1")
+
+        table_ref = self._make_one(dataset_ref, "table_1")
+        self.assertEqual(table_ref.dataset_id, dataset_ref.dataset_id)
+        self.assertEqual(table_ref.table_id, "table_1")
+
+    def test_to_api_repr(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset_ref = DatasetReference("project_1", "dataset_1")
+        table_ref = self._make_one(dataset_ref, "table_1")
+
+        resource = table_ref.to_api_repr()
+
+        self.assertEqual(
+            resource,
+            {"projectId": "project_1", "datasetId": "dataset_1", "tableId": "table_1"},
+        )
+
+    def test_from_api_repr(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+        from google.cloud.bigquery.table import TableReference
+
+        dataset_ref = DatasetReference("project_1", "dataset_1")
+        expected = self._make_one(dataset_ref, "table_1")
+
+        got = TableReference.from_api_repr(
+            {"projectId": "project_1", "datasetId": "dataset_1", "tableId": "table_1"}
+        )
+
+        self.assertEqual(expected, got)
+
+    def test_from_string(self):
+        cls = self._get_target_class()
+        got = cls.from_string("string-project.string_dataset.string_table")
+        self.assertEqual(got.project, "string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+        self.assertEqual(got.table_id, "string_table")
+
+    def test_from_string_legacy_string(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string-project:string_dataset.string_table")
+
+    def test_from_string_not_fully_qualified(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string_table")
+
+        with self.assertRaises(ValueError):
+            cls.from_string("string_dataset.string_table")
+
+        with self.assertRaises(ValueError):
+            cls.from_string("a.b.c.d")
+
+    def test_from_string_with_default_project(self):
+        cls = self._get_target_class()
+        got = cls.from_string(
+            "string_dataset.string_table", default_project="default-project"
+        )
+        self.assertEqual(got.project, "default-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+        self.assertEqual(got.table_id, "string_table")
+
+    def test_from_string_ignores_default_project(self):
+        cls = self._get_target_class()
+        got = cls.from_string(
+            "string-project.string_dataset.string_table",
+            default_project="default-project",
+        )
+        self.assertEqual(got.project, "string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+        self.assertEqual(got.table_id, "string_table")
+
+    def test___eq___wrong_type(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset_ref = DatasetReference("project_1", "dataset_1")
+        table = self._make_one(dataset_ref, "table_1")
+        other = object()
+        self.assertNotEqual(table, other)
+        self.assertEqual(table, mock.ANY)
+
+    def test___eq___project_mismatch(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = DatasetReference("project_1", "dataset_1")
+        other_dataset = DatasetReference("project_2", "dataset_1")
+        table = self._make_one(dataset, "table_1")
+        other = self._make_one(other_dataset, "table_1")
+        self.assertNotEqual(table, other)
+
+    def test___eq___dataset_mismatch(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = DatasetReference("project_1", "dataset_1")
+        other_dataset = DatasetReference("project_1", "dataset_2")
+        table = self._make_one(dataset, "table_1")
+        other = self._make_one(other_dataset, "table_1")
+        self.assertNotEqual(table, other)
+
+    def test___eq___table_mismatch(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = DatasetReference("project_1", "dataset_1")
+        table = self._make_one(dataset, "table_1")
+        other = self._make_one(dataset, "table_2")
+        self.assertNotEqual(table, other)
+
+    def test___eq___equality(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = DatasetReference("project_1", "dataset_1")
+        table = self._make_one(dataset, "table_1")
+        other = self._make_one(dataset, "table_1")
+        self.assertEqual(table, other)
+
+    def test___hash__set_equality(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = DatasetReference("project_1", "dataset_1")
+        table1 = self._make_one(dataset, "table1")
+        table2 = self._make_one(dataset, "table2")
+        set_one = {table1, table2}
+        set_two = {table1, table2}
+        self.assertEqual(set_one, set_two)
+
+    def test___hash__not_equals(self):
+        from google.cloud.bigquery.dataset import DatasetReference
+
+        dataset = DatasetReference("project_1", "dataset_1")
+        table1 = self._make_one(dataset, "table1")
+        table2 = self._make_one(dataset, "table2")
+        set_one = {table1}
+        set_two = {table2}
+        self.assertNotEqual(set_one, set_two)
+
+    def test___repr__(self):
+        dataset = DatasetReference("project1", "dataset1")
+        table1 = self._make_one(dataset, "table1")
+        expected = (
+            "TableReference(DatasetReference('project1', 'dataset1'), " "'table1')"
+        )
+        self.assertEqual(repr(table1), expected)
+
+
+class TestTable(unittest.TestCase, _SchemaBase):
+
+    PROJECT = "prahj-ekt"
+    DS_ID = "dataset-name"
+    TABLE_NAME = "table-name"
+    KMS_KEY_NAME = "projects/1/locations/global/keyRings/1/cryptoKeys/1"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.table import Table
+
+        return Table
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _setUpConstants(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        self.WHEN_TS = 1437767599.006
+        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(tzinfo=UTC)
+        self.ETAG = "ETAG"
+        self.TABLE_FULL_ID = "%s:%s.%s" % (self.PROJECT, self.DS_ID, self.TABLE_NAME)
+        self.RESOURCE_URL = "http://example.com/path/to/resource"
+        self.NUM_BYTES = 12345
+        self.NUM_ROWS = 67
+        self.NUM_EST_BYTES = 1234
+        self.NUM_EST_ROWS = 23
+
+    def _make_resource(self):
+        self._setUpConstants()
+        return {
+            "creationTime": self.WHEN_TS * 1000,
+            "tableReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.TABLE_NAME,
+            },
+            "schema": {
+                "fields": [
+                    {"name": "full_name", "type": "STRING", "mode": "REQUIRED"},
+                    {"name": "age", "type": "INTEGER", "mode": "REQUIRED"},
+                ]
+            },
+            "etag": "ETAG",
+            "id": self.TABLE_FULL_ID,
+            "lastModifiedTime": self.WHEN_TS * 1000,
+            "location": "US",
+            "selfLink": self.RESOURCE_URL,
+            "numRows": self.NUM_ROWS,
+            "numBytes": self.NUM_BYTES,
+            "type": "TABLE",
+            "streamingBuffer": {
+                "estimatedRows": str(self.NUM_EST_ROWS),
+                "estimatedBytes": str(self.NUM_EST_BYTES),
+                "oldestEntryTime": self.WHEN_TS * 1000,
+            },
+            "externalDataConfiguration": {
+                "sourceFormat": "CSV",
+                "csvOptions": {"allowJaggedRows": True, "encoding": "encoding"},
+            },
+            "labels": {"x": "y"},
+        }
+
+    def _verifyReadonlyResourceProperties(self, table, resource):
+        if "creationTime" in resource:
+            self.assertEqual(table.created, self.WHEN)
+        else:
+            self.assertIsNone(table.created)
+
+        if "etag" in resource:
+            self.assertEqual(table.etag, self.ETAG)
+        else:
+            self.assertIsNone(table.etag)
+
+        if "numRows" in resource:
+            self.assertEqual(table.num_rows, self.NUM_ROWS)
+        else:
+            self.assertIsNone(table.num_rows)
+
+        if "numBytes" in resource:
+            self.assertEqual(table.num_bytes, self.NUM_BYTES)
+        else:
+            self.assertIsNone(table.num_bytes)
+
+        if "selfLink" in resource:
+            self.assertEqual(table.self_link, self.RESOURCE_URL)
+        else:
+            self.assertIsNone(table.self_link)
+
+        if "streamingBuffer" in resource:
+            self.assertEqual(table.streaming_buffer.estimated_rows, self.NUM_EST_ROWS)
+            self.assertEqual(table.streaming_buffer.estimated_bytes, self.NUM_EST_BYTES)
+            self.assertEqual(table.streaming_buffer.oldest_entry_time, self.WHEN)
+        else:
+            self.assertIsNone(table.streaming_buffer)
+
+        self.assertEqual(table.full_table_id, self.TABLE_FULL_ID)
+        self.assertEqual(
+            table.table_type, "TABLE" if "view" not in resource else "VIEW"
+        )
+
+    def _verifyResourceProperties(self, table, resource):
+
+        self._verifyReadonlyResourceProperties(table, resource)
+
+        if "expirationTime" in resource:
+            self.assertEqual(table.expires, self.EXP_TIME)
+        else:
+            self.assertIsNone(table.expires)
+
+        self.assertEqual(table.description, resource.get("description"))
+        self.assertEqual(table.friendly_name, resource.get("friendlyName"))
+        self.assertEqual(table.location, resource.get("location"))
+
+        if "view" in resource:
+            self.assertEqual(table.view_query, resource["view"]["query"])
+            self.assertEqual(
+                table.view_use_legacy_sql, resource["view"].get("useLegacySql", True)
+            )
+        else:
+            self.assertIsNone(table.view_query)
+            self.assertIsNone(table.view_use_legacy_sql)
+
+        if "schema" in resource:
+            self._verifySchema(table.schema, resource)
+        else:
+            self.assertEqual(table.schema, [])
+
+        if "externalDataConfiguration" in resource:
+            edc = table.external_data_configuration
+            self.assertEqual(edc.source_format, "CSV")
+            self.assertEqual(edc.options.allow_jagged_rows, True)
+
+        if "labels" in resource:
+            self.assertEqual(table.labels, {"x": "y"})
+        else:
+            self.assertEqual(table.labels, {})
+
+        if "encryptionConfiguration" in resource:
+            self.assertIsNotNone(table.encryption_configuration)
+            self.assertEqual(
+                table.encryption_configuration.kms_key_name,
+                resource["encryptionConfiguration"]["kmsKeyName"],
+            )
+        else:
+            self.assertIsNone(table.encryption_configuration)
+
+    def test_ctor(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        self.assertEqual(table.table_id, self.TABLE_NAME)
+        self.assertEqual(table.project, self.PROJECT)
+        self.assertEqual(table.dataset_id, self.DS_ID)
+        self.assertEqual(table.reference.table_id, self.TABLE_NAME)
+        self.assertEqual(table.reference.project, self.PROJECT)
+        self.assertEqual(table.reference.dataset_id, self.DS_ID)
+        self.assertEqual(
+            table.path,
+            "/projects/%s/datasets/%s/tables/%s"
+            % (self.PROJECT, self.DS_ID, self.TABLE_NAME),
+        )
+        self.assertEqual(table.schema, [])
+
+        self.assertIsNone(table.created)
+        self.assertIsNone(table.etag)
+        self.assertIsNone(table.modified)
+        self.assertIsNone(table.num_bytes)
+        self.assertIsNone(table.num_rows)
+        self.assertIsNone(table.self_link)
+        self.assertIsNone(table.full_table_id)
+        self.assertIsNone(table.table_type)
+        self.assertIsNone(table.description)
+        self.assertIsNone(table.expires)
+        self.assertIsNone(table.friendly_name)
+        self.assertIsNone(table.location)
+        self.assertIsNone(table.view_query)
+        self.assertIsNone(table.view_use_legacy_sql)
+        self.assertIsNone(table.external_data_configuration)
+        self.assertEqual(table.labels, {})
+        self.assertIsNone(table.encryption_configuration)
+        self.assertIsNone(table.time_partitioning)
+        self.assertIsNone(table.clustering_fields)
+
+    def test_ctor_w_schema(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        table = self._make_one(table_ref, schema=[full_name, age])
+
+        self.assertEqual(table.schema, [full_name, age])
+
+    def test_ctor_string(self):
+        table = self._make_one("some-project.some_dset.some_tbl")
+        self.assertEqual(table.project, "some-project")
+        self.assertEqual(table.dataset_id, "some_dset")
+        self.assertEqual(table.table_id, "some_tbl")
+
+    def test_ctor_tablelistitem(self):
+        from google.cloud.bigquery.table import Table, TableListItem
+
+        import datetime
+        from google.cloud._helpers import _millis, UTC
+
+        self.WHEN_TS = 1437767599.125
+        self.EXP_TIME = datetime.datetime(2015, 8, 1, 23, 59, 59, tzinfo=UTC)
+
+        project = "test-project"
+        dataset_id = "test_dataset"
+        table_id = "coffee_table"
+        resource = {
+            "creationTime": self.WHEN_TS * 1000,
+            "expirationTime": _millis(self.EXP_TIME),
+            "kind": "bigquery#table",
+            "id": "{}:{}.{}".format(project, dataset_id, table_id),
+            "tableReference": {
+                "projectId": project,
+                "datasetId": dataset_id,
+                "tableId": table_id,
+            },
+            "friendlyName": "Mahogany Coffee Table",
+            "type": "TABLE",
+            "timePartitioning": {
+                "type": "DAY",
+                "field": "mycolumn",
+                "expirationMs": "10000",
+            },
+            "labels": {"some-stuff": "this-is-a-label"},
+            "clustering": {"fields": ["string"]},
+        }
+
+        table_list_item = TableListItem(resource)
+        table = Table(table_list_item)
+
+        self.assertIsNone(table.created)
+        self.assertEqual(table.reference.project, project)
+        self.assertEqual(table.reference.dataset_id, dataset_id)
+        self.assertEqual(table.reference.table_id, table_id)
+
+    def test_ctor_string_wo_project_id(self):
+        with pytest.raises(ValueError):
+            # Project ID is missing.
+            self._make_one("some_dset.some_tbl")
+
+    def test_num_bytes_getter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        # Check with no value set.
+        self.assertIsNone(table.num_bytes)
+
+        num_bytes = 1337
+        # Check with integer value set.
+        table._properties = {"numBytes": num_bytes}
+        self.assertEqual(table.num_bytes, num_bytes)
+
+        # Check with a string value set.
+        table._properties = {"numBytes": str(num_bytes)}
+        self.assertEqual(table.num_bytes, num_bytes)
+
+        # Check with invalid int value.
+        table._properties = {"numBytes": "x"}
+        with self.assertRaises(ValueError):
+            getattr(table, "num_bytes")
+
+    def test_num_rows_getter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        # Check with no value set.
+        self.assertIsNone(table.num_rows)
+
+        num_rows = 42
+        # Check with integer value set.
+        table._properties = {"numRows": num_rows}
+        self.assertEqual(table.num_rows, num_rows)
+
+        # Check with a string value set.
+        table._properties = {"numRows": str(num_rows)}
+        self.assertEqual(table.num_rows, num_rows)
+
+        # Check with invalid int value.
+        table._properties = {"numRows": "x"}
+        with self.assertRaises(ValueError):
+            getattr(table, "num_rows")
+
+    def test_schema_setter_non_list(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(TypeError):
+            table.schema = object()
+
+    def test_schema_setter_invalid_field(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        with self.assertRaises(ValueError):
+            table.schema = [full_name, object()]
+
+    def test_schema_setter(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        table.schema = [full_name, age]
+        self.assertEqual(table.schema, [full_name, age])
+
+    def test_props_set_by_server(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _millis
+
+        CREATED = datetime.datetime(2015, 7, 29, 12, 13, 22, tzinfo=UTC)
+        MODIFIED = datetime.datetime(2015, 7, 29, 14, 47, 15, tzinfo=UTC)
+        TABLE_FULL_ID = "%s:%s.%s" % (self.PROJECT, self.DS_ID, self.TABLE_NAME)
+        URL = "http://example.com/projects/%s/datasets/%s/tables/%s" % (
+            self.PROJECT,
+            self.DS_ID,
+            self.TABLE_NAME,
+        )
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table._properties["creationTime"] = _millis(CREATED)
+        table._properties["etag"] = "ETAG"
+        table._properties["lastModifiedTime"] = _millis(MODIFIED)
+        table._properties["numBytes"] = 12345
+        table._properties["numRows"] = 66
+        table._properties["selfLink"] = URL
+        table._properties["id"] = TABLE_FULL_ID
+        table._properties["type"] = "TABLE"
+
+        self.assertEqual(table.created, CREATED)
+        self.assertEqual(table.etag, "ETAG")
+        self.assertEqual(table.modified, MODIFIED)
+        self.assertEqual(table.num_bytes, 12345)
+        self.assertEqual(table.num_rows, 66)
+        self.assertEqual(table.self_link, URL)
+        self.assertEqual(table.full_table_id, TABLE_FULL_ID)
+        self.assertEqual(table.table_type, "TABLE")
+
+    def test_description_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.description = 12345
+
+    def test_description_setter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.description = "DESCRIPTION"
+        self.assertEqual(table.description, "DESCRIPTION")
+
+    def test_expires_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.expires = object()
+
+    def test_expires_setter(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        WHEN = datetime.datetime(2015, 7, 28, 16, 39, tzinfo=UTC)
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.expires = WHEN
+        self.assertEqual(table.expires, WHEN)
+
+    def test_friendly_name_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.friendly_name = 12345
+
+    def test_friendly_name_setter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.friendly_name = "FRIENDLY"
+        self.assertEqual(table.friendly_name, "FRIENDLY")
+
+    def test_view_query_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.view_query = 12345
+
+    def test_view_query_setter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.view_query = "select * from foo"
+        self.assertEqual(table.view_query, "select * from foo")
+        self.assertEqual(table.view_use_legacy_sql, False)
+
+        table.view_use_legacy_sql = True
+        self.assertEqual(table.view_use_legacy_sql, True)
+
+    def test_view_query_deleter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.view_query = "select * from foo"
+        del table.view_query
+        self.assertIsNone(table.view_query)
+        self.assertIsNone(table.view_use_legacy_sql)
+
+    def test_view_use_legacy_sql_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.view_use_legacy_sql = 12345
+
+    def test_view_use_legacy_sql_setter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.view_use_legacy_sql = True
+        table.view_query = "select * from foo"
+        self.assertEqual(table.view_use_legacy_sql, True)
+        self.assertEqual(table.view_query, "select * from foo")
+
+    def test_external_data_configuration_setter(self):
+        from google.cloud.bigquery.external_config import ExternalConfig
+
+        external_config = ExternalConfig("CSV")
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        table.external_data_configuration = external_config
+
+        self.assertEqual(
+            table.external_data_configuration.source_format,
+            external_config.source_format,
+        )
+
+    def test_external_data_configuration_setter_none(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        table.external_data_configuration = None
+
+        self.assertIsNone(table.external_data_configuration)
+
+    def test_external_data_configuration_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.external_data_configuration = 12345
+
+    def test_labels_update_in_place(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        del table._properties["labels"]  # don't start w/ existing dict
+        labels = table.labels
+        labels["foo"] = "bar"  # update in place
+        self.assertEqual(table.labels, {"foo": "bar"})
+
+    def test_labels_setter_bad_value(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        with self.assertRaises(ValueError):
+            table.labels = 12345
+
+    def test_from_string(self):
+        cls = self._get_target_class()
+        got = cls.from_string("string-project.string_dataset.string_table")
+        self.assertEqual(got.project, "string-project")
+        self.assertEqual(got.dataset_id, "string_dataset")
+        self.assertEqual(got.table_id, "string_table")
+
+    def test_from_string_legacy_string(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string-project:string_dataset.string_table")
+
+    def test_from_string_not_fully_qualified(self):
+        cls = self._get_target_class()
+        with self.assertRaises(ValueError):
+            cls.from_string("string_dataset.string_table")
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        RESOURCE = {
+            "id": "%s:%s.%s" % (self.PROJECT, self.DS_ID, self.TABLE_NAME),
+            "tableReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.TABLE_NAME,
+            },
+            "type": "TABLE",
+        }
+        klass = self._get_target_class()
+        table = klass.from_api_repr(RESOURCE)
+        self.assertEqual(table.table_id, self.TABLE_NAME)
+        self._verifyResourceProperties(table, RESOURCE)
+
+    def test_from_api_repr_w_properties(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _millis
+
+        RESOURCE = self._make_resource()
+        RESOURCE["view"] = {"query": "select fullname, age from person_ages"}
+        RESOURCE["type"] = "VIEW"
+        RESOURCE["location"] = "EU"
+        self.EXP_TIME = datetime.datetime(2015, 8, 1, 23, 59, 59, tzinfo=UTC)
+        RESOURCE["expirationTime"] = _millis(self.EXP_TIME)
+        klass = self._get_target_class()
+        table = klass.from_api_repr(RESOURCE)
+        self._verifyResourceProperties(table, RESOURCE)
+
+    def test_from_api_with_encryption(self):
+        self._setUpConstants()
+        RESOURCE = {
+            "id": "%s:%s.%s" % (self.PROJECT, self.DS_ID, self.TABLE_NAME),
+            "tableReference": {
+                "projectId": self.PROJECT,
+                "datasetId": self.DS_ID,
+                "tableId": self.TABLE_NAME,
+            },
+            "encryptionConfiguration": {"kmsKeyName": self.KMS_KEY_NAME},
+            "type": "TABLE",
+        }
+        klass = self._get_target_class()
+        table = klass.from_api_repr(RESOURCE)
+        self._verifyResourceProperties(table, RESOURCE)
+
+    def test_to_api_repr_w_custom_field(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table._properties["newAlphaProperty"] = "unreleased property"
+        resource = table.to_api_repr()
+
+        exp_resource = {
+            "tableReference": table_ref.to_api_repr(),
+            "labels": {},
+            "newAlphaProperty": "unreleased property",
+        }
+        self.assertEqual(resource, exp_resource)
+
+    def test__build_resource_w_custom_field(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table._properties["newAlphaProperty"] = "unreleased property"
+        resource = table._build_resource(["newAlphaProperty"])
+
+        exp_resource = {"newAlphaProperty": "unreleased property"}
+        self.assertEqual(resource, exp_resource)
+
+    def test__build_resource_w_custom_field_not_in__properties(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table = self._make_one(dataset.table(self.TABLE_NAME))
+        table.bad = "value"
+        with self.assertRaises(ValueError):
+            table._build_resource(["bad"])
+
+    def test_time_partitioning_getter(self):
+        from google.cloud.bigquery.table import TimePartitioning
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        table._properties["timePartitioning"] = {
+            "type": "DAY",
+            "field": "col1",
+            "expirationMs": "123456",
+            "requirePartitionFilter": False,
+        }
+        self.assertIsInstance(table.time_partitioning, TimePartitioning)
+        self.assertEqual(table.time_partitioning.type_, TimePartitioningType.DAY)
+        self.assertEqual(table.time_partitioning.field, "col1")
+        self.assertEqual(table.time_partitioning.expiration_ms, 123456)
+        self.assertFalse(table.time_partitioning.require_partition_filter)
+
+    def test_time_partitioning_getter_w_none(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        table._properties["timePartitioning"] = None
+        self.assertIsNone(table.time_partitioning)
+
+        del table._properties["timePartitioning"]
+        self.assertIsNone(table.time_partitioning)
+
+    def test_time_partitioning_getter_w_empty(self):
+        from google.cloud.bigquery.table import TimePartitioning
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        # Even though there are required properties according to the API
+        # specification, sometimes time partitioning is populated as an empty
+        # object. See internal bug 131167013.
+        table._properties["timePartitioning"] = {}
+        self.assertIsInstance(table.time_partitioning, TimePartitioning)
+        self.assertIsNone(table.time_partitioning.type_)
+        self.assertIsNone(table.time_partitioning.field)
+        self.assertIsNone(table.time_partitioning.expiration_ms)
+        self.assertIsNone(table.time_partitioning.require_partition_filter)
+
+    def test_time_partitioning_setter(self):
+        from google.cloud.bigquery.table import TimePartitioning
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        time_partitioning = TimePartitioning(type_=TimePartitioningType.DAY)
+
+        table.time_partitioning = time_partitioning
+
+        self.assertEqual(table.time_partitioning.type_, TimePartitioningType.DAY)
+        # Both objects point to the same properties dict
+        self.assertIs(
+            table._properties["timePartitioning"], time_partitioning._properties
+        )
+
+        time_partitioning.expiration_ms = 10000
+
+        # Changes to TimePartitioning object are reflected in Table properties
+        self.assertEqual(
+            table.time_partitioning.expiration_ms, time_partitioning.expiration_ms
+        )
+
+    def test_time_partitioning_setter_bad_type(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        with self.assertRaises(ValueError):
+            table.time_partitioning = {"timePartitioning": {"type": "DAY"}}
+
+    def test_time_partitioning_setter_none(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        table.time_partitioning = None
+
+        self.assertIsNone(table.time_partitioning)
+
+    def test_partitioning_type_setter(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        with warnings.catch_warnings(record=True) as warned:
+            self.assertIsNone(table.partitioning_type)
+
+            table.partitioning_type = TimePartitioningType.DAY
+
+            self.assertEqual(table.partitioning_type, "DAY")
+
+        self.assertEqual(len(warned), 3)
+        for warning in warned:
+            self.assertIs(warning.category, PendingDeprecationWarning)
+
+    def test_partitioning_type_setter_w_time_partitioning_set(self):
+        from google.cloud.bigquery.table import TimePartitioning
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.time_partitioning = TimePartitioning()
+
+        with warnings.catch_warnings(record=True) as warned:
+            table.partitioning_type = "NEW_FAKE_TYPE"
+
+            self.assertEqual(table.partitioning_type, "NEW_FAKE_TYPE")
+
+        self.assertEqual(len(warned), 2)
+        for warning in warned:
+            self.assertIs(warning.category, PendingDeprecationWarning)
+
+    def test_partitioning_expiration_setter_w_time_partitioning_set(self):
+        from google.cloud.bigquery.table import TimePartitioning
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        table.time_partitioning = TimePartitioning()
+
+        with warnings.catch_warnings(record=True) as warned:
+            table.partition_expiration = 100000
+
+            self.assertEqual(table.partition_expiration, 100000)
+
+        self.assertEqual(len(warned), 2)
+        for warning in warned:
+            self.assertIs(warning.category, PendingDeprecationWarning)
+
+    def test_partition_expiration_setter(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        with warnings.catch_warnings(record=True) as warned:
+            self.assertIsNone(table.partition_expiration)
+
+            table.partition_expiration = 100
+
+            self.assertEqual(table.partition_expiration, 100)
+            # defaults to 'DAY' when expiration is set and type is not set
+            self.assertEqual(table.partitioning_type, "DAY")
+
+        self.assertEqual(len(warned), 4)
+        for warning in warned:
+            self.assertIs(warning.category, PendingDeprecationWarning)
+
+    def test_clustering_fields_setter_w_fields(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        fields = ["email", "phone"]
+
+        table.clustering_fields = fields
+        self.assertEqual(table.clustering_fields, fields)
+        self.assertEqual(table._properties["clustering"], {"fields": fields})
+
+    def test_clustering_fields_setter_w_none(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        fields = ["email", "phone"]
+
+        table._properties["clustering"] = {"fields": fields}
+        table.clustering_fields = None
+        self.assertEqual(table.clustering_fields, None)
+        self.assertFalse("clustering" in table._properties)
+
+    def test_clustering_fields_setter_w_none_noop(self):
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+
+        table.clustering_fields = None
+        self.assertEqual(table.clustering_fields, None)
+        self.assertFalse("clustering" in table._properties)
+
+    def test_encryption_configuration_setter(self):
+        from google.cloud.bigquery.table import EncryptionConfiguration
+
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = self._make_one(table_ref)
+        encryption_configuration = EncryptionConfiguration(
+            kms_key_name=self.KMS_KEY_NAME
+        )
+        table.encryption_configuration = encryption_configuration
+        self.assertEqual(table.encryption_configuration.kms_key_name, self.KMS_KEY_NAME)
+        table.encryption_configuration = None
+        self.assertIsNone(table.encryption_configuration)
+
+    def test___repr__(self):
+        from google.cloud.bigquery.table import TableReference
+
+        dataset = DatasetReference("project1", "dataset1")
+        table1 = self._make_one(TableReference(dataset, "table1"))
+        expected = (
+            "Table(TableReference("
+            "DatasetReference('project1', 'dataset1'), "
+            "'table1'))"
+        )
+        self.assertEqual(repr(table1), expected)
+
+
+class Test_row_from_mapping(unittest.TestCase, _SchemaBase):
+
+    PROJECT = "prahj-ekt"
+    DS_ID = "dataset-name"
+    TABLE_NAME = "table-name"
+
+    def _call_fut(self, mapping, schema):
+        from google.cloud.bigquery.table import _row_from_mapping
+
+        return _row_from_mapping(mapping, schema)
+
+    def test__row_from_mapping_wo_schema(self):
+        from google.cloud.bigquery.table import Table, _TABLE_HAS_NO_SCHEMA
+
+        MAPPING = {"full_name": "Phred Phlyntstone", "age": 32}
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        table = Table(table_ref)
+
+        with self.assertRaises(ValueError) as exc:
+            self._call_fut(MAPPING, table.schema)
+
+        self.assertEqual(exc.exception.args, (_TABLE_HAS_NO_SCHEMA,))
+
+    def test__row_from_mapping_w_invalid_schema(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        MAPPING = {
+            "full_name": "Phred Phlyntstone",
+            "age": 32,
+            "colors": ["red", "green"],
+            "bogus": "WHATEVER",
+        }
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        colors = SchemaField("colors", "DATETIME", mode="REPEATED")
+        bogus = SchemaField("joined", "STRING", mode="BOGUS")
+        table = Table(table_ref, schema=[full_name, age, colors, bogus])
+
+        with self.assertRaises(ValueError) as exc:
+            self._call_fut(MAPPING, table.schema)
+
+        self.assertIn("Unknown field mode: BOGUS", str(exc.exception))
+
+    def test__row_from_mapping_w_schema(self):
+        from google.cloud.bigquery.table import Table, SchemaField
+
+        MAPPING = {
+            "full_name": "Phred Phlyntstone",
+            "age": 32,
+            "colors": ["red", "green"],
+            "extra": "IGNORED",
+        }
+        dataset = DatasetReference(self.PROJECT, self.DS_ID)
+        table_ref = dataset.table(self.TABLE_NAME)
+        full_name = SchemaField("full_name", "STRING", mode="REQUIRED")
+        age = SchemaField("age", "INTEGER", mode="REQUIRED")
+        colors = SchemaField("colors", "DATETIME", mode="REPEATED")
+        joined = SchemaField("joined", "STRING", mode="NULLABLE")
+        table = Table(table_ref, schema=[full_name, age, colors, joined])
+
+        self.assertEqual(
+            self._call_fut(MAPPING, table.schema),
+            ("Phred Phlyntstone", 32, ["red", "green"], None),
+        )
+
+
+class TestTableListItem(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigquery.table import TableListItem
+
+        return TableListItem
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _setUpConstants(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        self.WHEN_TS = 1437767599.125
+        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(tzinfo=UTC)
+        self.EXP_TIME = datetime.datetime(2015, 8, 1, 23, 59, 59, tzinfo=UTC)
+
+    def test_ctor(self):
+        from google.cloud._helpers import _millis
+
+        self._setUpConstants()
+        project = "test-project"
+        dataset_id = "test_dataset"
+        table_id = "coffee_table"
+        resource = {
+            "creationTime": self.WHEN_TS * 1000,
+            "expirationTime": _millis(self.EXP_TIME),
+            "kind": "bigquery#table",
+            "id": "{}:{}.{}".format(project, dataset_id, table_id),
+            "tableReference": {
+                "projectId": project,
+                "datasetId": dataset_id,
+                "tableId": table_id,
+            },
+            "friendlyName": "Mahogany Coffee Table",
+            "type": "TABLE",
+            "timePartitioning": {
+                "type": "DAY",
+                "field": "mycolumn",
+                "expirationMs": "10000",
+            },
+            "labels": {"some-stuff": "this-is-a-label"},
+            "clustering": {"fields": ["string"]},
+        }
+
+        table = self._make_one(resource)
+
+        self.assertEqual(table.created, self.WHEN)
+        self.assertEqual(table.expires, self.EXP_TIME)
+        self.assertEqual(table.project, project)
+        self.assertEqual(table.dataset_id, dataset_id)
+        self.assertEqual(table.table_id, table_id)
+        self.assertEqual(
+            table.full_table_id, "{}:{}.{}".format(project, dataset_id, table_id)
+        )
+        self.assertEqual(table.reference.project, project)
+        self.assertEqual(table.reference.dataset_id, dataset_id)
+        self.assertEqual(table.reference.table_id, table_id)
+        self.assertEqual(table.friendly_name, "Mahogany Coffee Table")
+        self.assertEqual(table.table_type, "TABLE")
+        self.assertEqual(table.time_partitioning.type_, "DAY")
+        self.assertEqual(table.time_partitioning.expiration_ms, 10000)
+        self.assertEqual(table.time_partitioning.field, "mycolumn")
+        self.assertEqual(table.labels["some-stuff"], "this-is-a-label")
+        self.assertIsNone(table.view_use_legacy_sql)
+        self.assertEqual(table.clustering_fields, ["string"])
+
+        with warnings.catch_warnings(record=True) as warned:
+            self.assertEqual(table.partitioning_type, "DAY")
+            self.assertEqual(table.partition_expiration, 10000)
+
+        self.assertEqual(len(warned), 2)
+        for warning in warned:
+            self.assertIs(warning.category, PendingDeprecationWarning)
+
+    def test_ctor_view(self):
+        project = "test-project"
+        dataset_id = "test_dataset"
+        table_id = "just_looking"
+        resource = {
+            "kind": "bigquery#table",
+            "id": "{}:{}.{}".format(project, dataset_id, table_id),
+            "tableReference": {
+                "projectId": project,
+                "datasetId": dataset_id,
+                "tableId": table_id,
+            },
+            "type": "VIEW",
+        }
+
+        table = self._make_one(resource)
+        self.assertEqual(table.project, project)
+        self.assertEqual(table.dataset_id, dataset_id)
+        self.assertEqual(table.table_id, table_id)
+        self.assertEqual(
+            table.full_table_id, "{}:{}.{}".format(project, dataset_id, table_id)
+        )
+        self.assertEqual(table.reference.project, project)
+        self.assertEqual(table.reference.dataset_id, dataset_id)
+        self.assertEqual(table.reference.table_id, table_id)
+        self.assertEqual(table.table_type, "VIEW")
+        # Server default for useLegacySql is True.
+        self.assertTrue(table.view_use_legacy_sql)
+
+    def test_ctor_missing_properties(self):
+        resource = {
+            "tableReference": {
+                "projectId": "testproject",
+                "datasetId": "testdataset",
+                "tableId": "testtable",
+            }
+        }
+        table = self._make_one(resource)
+        self.assertEqual(table.project, "testproject")
+        self.assertEqual(table.dataset_id, "testdataset")
+        self.assertEqual(table.table_id, "testtable")
+        self.assertIsNone(table.created)
+        self.assertIsNone(table.expires)
+        self.assertIsNone(table.clustering_fields)
+        self.assertIsNone(table.full_table_id)
+        self.assertIsNone(table.friendly_name)
+        self.assertIsNone(table.table_type)
+        self.assertIsNone(table.time_partitioning)
+        self.assertEqual(table.labels, {})
+        self.assertIsNone(table.view_use_legacy_sql)
+
+        with warnings.catch_warnings(record=True) as warned:
+            self.assertIsNone(table.partitioning_type)
+            self.assertIsNone(table.partition_expiration)
+
+        self.assertEqual(len(warned), 2)
+        for warning in warned:
+            self.assertIs(warning.category, PendingDeprecationWarning)
+
+    def test_ctor_wo_project(self):
+        resource = {
+            "tableReference": {"datasetId": "testdataset", "tableId": "testtable"}
+        }
+        with self.assertRaises(ValueError):
+            self._make_one(resource)
+
+    def test_ctor_wo_dataset(self):
+        resource = {
+            "tableReference": {"projectId": "testproject", "tableId": "testtable"}
+        }
+        with self.assertRaises(ValueError):
+            self._make_one(resource)
+
+    def test_ctor_wo_table(self):
+        resource = {
+            "tableReference": {"projectId": "testproject", "datasetId": "testdataset"}
+        }
+        with self.assertRaises(ValueError):
+            self._make_one(resource)
+
+    def test_ctor_wo_reference(self):
+        with self.assertRaises(ValueError):
+            self._make_one({})
+
+    def test_labels_update_in_place(self):
+        resource = {
+            "tableReference": {
+                "projectId": "testproject",
+                "datasetId": "testdataset",
+                "tableId": "testtable",
+            }
+        }
+        table = self._make_one(resource)
+        labels = table.labels
+        labels["foo"] = "bar"  # update in place
+        self.assertEqual(table.labels, {"foo": "bar"})
+
+
+class TestRow(unittest.TestCase):
+    def test_row(self):
+        from google.cloud.bigquery.table import Row
+
+        VALUES = (1, 2, 3)
+        row = Row(VALUES, {"a": 0, "b": 1, "c": 2})
+        self.assertEqual(row.a, 1)
+        self.assertEqual(row[1], 2)
+        self.assertEqual(row["c"], 3)
+        self.assertEqual(len(row), 3)
+        self.assertEqual(row.values(), VALUES)
+        self.assertEqual(set(row.keys()), set({"a": 1, "b": 2, "c": 3}.keys()))
+        self.assertEqual(set(row.items()), set({"a": 1, "b": 2, "c": 3}.items()))
+        self.assertEqual(row.get("a"), 1)
+        self.assertEqual(row.get("d"), None)
+        self.assertEqual(row.get("d", ""), "")
+        self.assertEqual(row.get("d", default=""), "")
+        self.assertEqual(repr(row), "Row((1, 2, 3), {'a': 0, 'b': 1, 'c': 2})")
+        self.assertFalse(row != row)
+        self.assertFalse(row == 3)
+        with self.assertRaises(AttributeError):
+            row.z
+        with self.assertRaises(KeyError):
+            row["z"]
+
+
+class Test_EmptyRowIterator(unittest.TestCase):
+    def _make_one(self):
+        from google.cloud.bigquery.table import _EmptyRowIterator
+
+        return _EmptyRowIterator()
+
+    def test_total_rows_eq_zero(self):
+        row_iterator = self._make_one()
+        self.assertEqual(row_iterator.total_rows, 0)
+
+    @mock.patch("google.cloud.bigquery.table.pyarrow", new=None)
+    def test_to_arrow_error_if_pyarrow_is_none(self):
+        row_iterator = self._make_one()
+        with self.assertRaises(ValueError):
+            row_iterator.to_arrow()
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_arrow(self):
+        row_iterator = self._make_one()
+        tbl = row_iterator.to_arrow()
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 0)
+
+    @mock.patch("google.cloud.bigquery.table.pandas", new=None)
+    def test_to_dataframe_error_if_pandas_is_none(self):
+        row_iterator = self._make_one()
+        with self.assertRaises(ValueError):
+            row_iterator.to_dataframe()
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe(self):
+        row_iterator = self._make_one()
+        df = row_iterator.to_dataframe()
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 0)  # verify the number of rows
+
+
+class TestRowIterator(unittest.TestCase):
+    def _class_under_test(self):
+        from google.cloud.bigquery.table import RowIterator
+
+        return RowIterator
+
+    def _make_one(
+        self,
+        client=None,
+        api_request=None,
+        path=None,
+        schema=None,
+        table=None,
+        **kwargs
+    ):
+        from google.cloud.bigquery.table import TableReference
+
+        if client is None:
+            client = _mock_client()
+
+        if api_request is None:
+            api_request = mock.sentinel.api_request
+
+        if path is None:
+            path = "/foo"
+
+        if schema is None:
+            schema = []
+
+        if table is None:
+            table = TableReference.from_string("my-project.my_dataset.my_table")
+
+        return self._class_under_test()(
+            client, api_request, path, schema, table=table, **kwargs
+        )
+
+    def test_constructor(self):
+        from google.cloud.bigquery.table import _item_to_row
+        from google.cloud.bigquery.table import _rows_page_start
+
+        client = _mock_client()
+        path = "/some/path"
+        iterator = self._make_one(client=client, path=path)
+
+        # Objects are set without copying.
+        self.assertIs(iterator.client, client)
+        self.assertIs(iterator.item_to_value, _item_to_row)
+        self.assertIs(iterator._page_start, _rows_page_start)
+        # Properties have the expect value.
+        self.assertEqual(iterator.extra_params, {})
+        self.assertEqual(iterator._items_key, "rows")
+        self.assertIsNone(iterator.max_results)
+        self.assertEqual(iterator.path, path)
+        self.assertFalse(iterator._started)
+        self.assertIsNone(iterator.total_rows)
+        # Changing attributes.
+        self.assertEqual(iterator.page_number, 0)
+        self.assertIsNone(iterator.next_page_token)
+        self.assertEqual(iterator.num_results, 0)
+
+    def test_constructor_with_table(self):
+        from google.cloud.bigquery.table import Table
+
+        table = Table("proj.dset.tbl")
+        table._properties["numRows"] = 100
+
+        iterator = self._make_one(table=table)
+
+        self.assertIs(iterator._table, table)
+        self.assertEqual(iterator.total_rows, 100)
+
+    def test_iterate(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+        self.assertEqual(row_iterator.num_results, 0)
+
+        rows_iter = iter(row_iterator)
+
+        val1 = six.next(rows_iter)
+        self.assertEqual(val1.name, "Phred Phlyntstone")
+        self.assertEqual(row_iterator.num_results, 1)
+
+        val2 = six.next(rows_iter)
+        self.assertEqual(val2.name, "Bharney Rhubble")
+        self.assertEqual(row_iterator.num_results, 2)
+
+        with self.assertRaises(StopIteration):
+            six.next(rows_iter)
+
+        api_request.assert_called_once_with(method="GET", path=path, query_params={})
+
+    def test_page_size(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+
+        row_iterator = self._make_one(
+            _mock_client(), api_request, path, schema, page_size=4
+        )
+        row_iterator._get_next_page_response()
+
+        api_request.assert_called_once_with(
+            method="GET",
+            path=path,
+            query_params={"maxResults": row_iterator._page_size},
+        )
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_arrow(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField(
+                "child",
+                "RECORD",
+                mode="REPEATED",
+                fields=[
+                    SchemaField("name", "STRING", mode="REQUIRED"),
+                    SchemaField("age", "INTEGER", mode="REQUIRED"),
+                ],
+            ),
+        ]
+        rows = [
+            {
+                "f": [
+                    {"v": "Bharney Rhubble"},
+                    {"v": "33"},
+                    {
+                        "v": [
+                            {"v": {"f": [{"v": "Whamm-Whamm Rhubble"}, {"v": "3"}]}},
+                            {"v": {"f": [{"v": "Hoppy"}, {"v": "1"}]}},
+                        ]
+                    },
+                ]
+            },
+            {
+                "f": [
+                    {"v": "Wylma Phlyntstone"},
+                    {"v": "29"},
+                    {
+                        "v": [
+                            {"v": {"f": [{"v": "Bepples Phlyntstone"}, {"v": "0"}]}},
+                            {"v": {"f": [{"v": "Dino"}, {"v": "4"}]}},
+                        ]
+                    },
+                ]
+            },
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        tbl = row_iterator.to_arrow()
+
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 2)
+
+        # Check the schema.
+        self.assertEqual(tbl.schema[0].name, "name")
+        self.assertTrue(pyarrow.types.is_string(tbl.schema[0].type))
+        self.assertEqual(tbl.schema[1].name, "age")
+        self.assertTrue(pyarrow.types.is_int64(tbl.schema[1].type))
+        child_field = tbl.schema[2]
+        self.assertEqual(child_field.name, "child")
+        self.assertTrue(pyarrow.types.is_list(child_field.type))
+        self.assertTrue(pyarrow.types.is_struct(child_field.type.value_type))
+        self.assertEqual(child_field.type.value_type[0].name, "name")
+        self.assertEqual(child_field.type.value_type[1].name, "age")
+
+        # Check the data.
+        tbl_data = tbl.to_pydict()
+        names = tbl_data["name"]
+        ages = tbl_data["age"]
+        children = tbl_data["child"]
+        self.assertEqual(names, ["Bharney Rhubble", "Wylma Phlyntstone"])
+        self.assertEqual(ages, [33, 29])
+        self.assertEqual(
+            children,
+            [
+                [
+                    {"name": "Whamm-Whamm Rhubble", "age": 3},
+                    {"name": "Hoppy", "age": 1},
+                ],
+                [{"name": "Bepples Phlyntstone", "age": 0}, {"name": "Dino", "age": 4}],
+            ],
+        )
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_arrow_w_nulls(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [SchemaField("name", "STRING"), SchemaField("age", "INTEGER")]
+        rows = [
+            {"f": [{"v": "Donkey"}, {"v": 32}]},
+            {"f": [{"v": "Diddy"}, {"v": 29}]},
+            {"f": [{"v": "Dixie"}, {"v": None}]},
+            {"f": [{"v": None}, {"v": 111}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        tbl = row_iterator.to_arrow()
+
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 4)
+
+        # Check the schema.
+        self.assertEqual(tbl.schema[0].name, "name")
+        self.assertTrue(pyarrow.types.is_string(tbl.schema[0].type))
+        self.assertEqual(tbl.schema[1].name, "age")
+        self.assertTrue(pyarrow.types.is_int64(tbl.schema[1].type))
+
+        # Check the data.
+        tbl_data = tbl.to_pydict()
+        names = tbl_data["name"]
+        ages = tbl_data["age"]
+        self.assertEqual(names, ["Donkey", "Diddy", "Dixie", None])
+        self.assertEqual(ages, [32, 29, None, 111])
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_arrow_w_unknown_type(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField("sport", "UNKNOWN_TYPE", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}, {"v": "volleyball"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}, {"v": "basketball"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        tbl = row_iterator.to_arrow()
+
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 2)
+
+        # Check the schema.
+        self.assertEqual(tbl.schema[0].name, "name")
+        self.assertTrue(pyarrow.types.is_string(tbl.schema[0].type))
+        self.assertEqual(tbl.schema[1].name, "age")
+        self.assertTrue(pyarrow.types.is_int64(tbl.schema[1].type))
+        self.assertEqual(tbl.schema[2].name, "sport")
+
+        # Check the data.
+        tbl_data = tbl.to_pydict()
+        names = tbl_data["name"]
+        ages = tbl_data["age"]
+        sports = tbl_data["sport"]
+        self.assertEqual(names, ["Bharney Rhubble", "Wylma Phlyntstone"])
+        self.assertEqual(ages, [33, 29])
+        self.assertEqual(sports, ["volleyball", "basketball"])
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_arrow_w_empty_table(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+            SchemaField(
+                "child",
+                "RECORD",
+                mode="REPEATED",
+                fields=[
+                    SchemaField("name", "STRING", mode="REQUIRED"),
+                    SchemaField("age", "INTEGER", mode="REQUIRED"),
+                ],
+            ),
+        ]
+        rows = []
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        tbl = row_iterator.to_arrow()
+
+        self.assertIsInstance(tbl, pyarrow.Table)
+        self.assertEqual(tbl.num_rows, 0)
+
+        # Check the schema.
+        self.assertEqual(tbl.schema[0].name, "name")
+        self.assertTrue(pyarrow.types.is_string(tbl.schema[0].type))
+        self.assertEqual(tbl.schema[1].name, "age")
+        self.assertTrue(pyarrow.types.is_int64(tbl.schema[1].type))
+        child_field = tbl.schema[2]
+        self.assertEqual(child_field.name, "child")
+        self.assertTrue(pyarrow.types.is_list(child_field.type))
+        self.assertTrue(pyarrow.types.is_struct(child_field.type.value_type))
+        self.assertEqual(child_field.type.value_type[0].name, "name")
+        self.assertEqual(child_field.type.value_type[1].name, "age")
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_arrow_w_bqstorage(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+        from google.cloud.bigquery_storage_v1beta1 import reader
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        streams = [
+            # Use two streams we want to check frames are read from each stream.
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/1234"},
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/5678"},
+        ]
+        session = bigquery_storage_v1beta1.types.ReadSession(streams=streams)
+        arrow_schema = pyarrow.schema(
+            [
+                pyarrow.field("colA", pyarrow.int64()),
+                # Not alphabetical to test column order.
+                pyarrow.field("colC", pyarrow.float64()),
+                pyarrow.field("colB", pyarrow.string()),
+            ]
+        )
+        session.arrow_schema.serialized_schema = arrow_schema.serialize().to_pybytes()
+        bqstorage_client.create_read_session.return_value = session
+
+        mock_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        bqstorage_client.read_rows.return_value = mock_rowstream
+
+        mock_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_rowstream.rows.return_value = mock_rows
+        expected_num_rows = 2
+        expected_num_columns = 3
+        page_items = [
+            pyarrow.array([1, -1]),
+            pyarrow.array([2.0, 4.0]),
+            pyarrow.array(["abc", "def"]),
+        ]
+
+        mock_page = mock.create_autospec(reader.ReadRowsPage)
+        mock_page.to_arrow.return_value = pyarrow.RecordBatch.from_arrays(
+            page_items, arrow_schema
+        )
+        mock_pages = (mock_page, mock_page, mock_page)
+        type(mock_rows).pages = mock.PropertyMock(return_value=mock_pages)
+
+        schema = [
+            schema.SchemaField("colA", "INTEGER"),
+            schema.SchemaField("colC", "FLOAT"),
+            schema.SchemaField("colB", "STRING"),
+        ]
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            schema,
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+            selected_fields=schema,
+        )
+
+        actual_tbl = row_iterator.to_arrow(bqstorage_client=bqstorage_client)
+
+        # Are the columns in the expected order?
+        self.assertEqual(actual_tbl.num_columns, expected_num_columns)
+        self.assertEqual(actual_tbl.schema[0].name, "colA")
+        self.assertEqual(actual_tbl.schema[1].name, "colC")
+        self.assertEqual(actual_tbl.schema[2].name, "colB")
+
+        # Have expected number of rows?
+        total_pages = len(streams) * len(mock_pages)
+        total_rows = expected_num_rows * total_pages
+        self.assertEqual(actual_tbl.num_rows, total_rows)
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_arrow_w_bqstorage_no_streams(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        session = bigquery_storage_v1beta1.types.ReadSession()
+        arrow_schema = pyarrow.schema(
+            [
+                pyarrow.field("colA", pyarrow.string()),
+                # Not alphabetical to test column order.
+                pyarrow.field("colC", pyarrow.string()),
+                pyarrow.field("colB", pyarrow.string()),
+            ]
+        )
+        session.arrow_schema.serialized_schema = arrow_schema.serialize().to_pybytes()
+        bqstorage_client.create_read_session.return_value = session
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            [
+                schema.SchemaField("colA", "STRING"),
+                schema.SchemaField("colC", "STRING"),
+                schema.SchemaField("colB", "STRING"),
+            ],
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+        )
+
+        actual_table = row_iterator.to_arrow(bqstorage_client=bqstorage_client)
+        self.assertEqual(actual_table.num_columns, 3)
+        self.assertEqual(actual_table.num_rows, 0)
+        self.assertEqual(actual_table.schema[0].name, "colA")
+        self.assertEqual(actual_table.schema[1].name, "colC")
+        self.assertEqual(actual_table.schema[2].name, "colB")
+
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    @unittest.skipIf(tqdm is None, "Requires `tqdm`")
+    @mock.patch("tqdm.tqdm_gui")
+    @mock.patch("tqdm.tqdm_notebook")
+    @mock.patch("tqdm.tqdm")
+    def test_to_arrow_progress_bar(self, tqdm_mock, tqdm_notebook_mock, tqdm_gui_mock):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+
+        progress_bars = (
+            ("tqdm", tqdm_mock),
+            ("tqdm_notebook", tqdm_notebook_mock),
+            ("tqdm_gui", tqdm_gui_mock),
+        )
+
+        for progress_bar_type, progress_bar_mock in progress_bars:
+            row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+            tbl = row_iterator.to_arrow(progress_bar_type=progress_bar_type)
+
+            progress_bar_mock.assert_called()
+            progress_bar_mock().update.assert_called()
+            progress_bar_mock().close.assert_called_once()
+            self.assertEqual(tbl.num_rows, 4)
+
+    @mock.patch("google.cloud.bigquery.table.pyarrow", new=None)
+    def test_to_arrow_w_pyarrow_none(self):
+        schema = []
+        rows = []
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        with self.assertRaises(ValueError):
+            row_iterator.to_arrow()
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        df = row_iterator.to_dataframe()
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 4)  # verify the number of rows
+        self.assertEqual(list(df), ["name", "age"])  # verify the column names
+        self.assertEqual(df.name.dtype.name, "object")
+        self.assertEqual(df.age.dtype.name, "int64")
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(tqdm is None, "Requires `tqdm`")
+    @mock.patch("tqdm.tqdm_gui")
+    @mock.patch("tqdm.tqdm_notebook")
+    @mock.patch("tqdm.tqdm")
+    def test_to_dataframe_progress_bar(
+        self, tqdm_mock, tqdm_notebook_mock, tqdm_gui_mock
+    ):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+
+        progress_bars = (
+            ("tqdm", tqdm_mock),
+            ("tqdm_notebook", tqdm_notebook_mock),
+            ("tqdm_gui", tqdm_gui_mock),
+        )
+
+        for progress_bar_type, progress_bar_mock in progress_bars:
+            row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+            df = row_iterator.to_dataframe(progress_bar_type=progress_bar_type)
+
+            progress_bar_mock.assert_called()
+            progress_bar_mock().update.assert_called()
+            progress_bar_mock().close.assert_called_once()
+            self.assertEqual(len(df), 4)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @mock.patch("google.cloud.bigquery.table.tqdm", new=None)
+    def test_to_dataframe_no_tqdm_no_progress_bar(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        with warnings.catch_warnings(record=True) as warned:
+            df = row_iterator.to_dataframe()
+
+        self.assertEqual(len(warned), 0)
+        self.assertEqual(len(df), 4)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @mock.patch("google.cloud.bigquery.table.tqdm", new=None)
+    def test_to_dataframe_no_tqdm(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        with warnings.catch_warnings(record=True) as warned:
+            df = row_iterator.to_dataframe(progress_bar_type="tqdm")
+
+        self.assertEqual(len(warned), 1)
+        for warning in warned:
+            self.assertIs(warning.category, UserWarning)
+
+        # Even though the progress bar won't show, downloading the dataframe
+        # should still work.
+        self.assertEqual(len(df), 4)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(tqdm is None, "Requires `tqdm`")
+    @mock.patch("tqdm.tqdm_gui", new=None)  # will raise TypeError on call
+    @mock.patch("tqdm.tqdm_notebook", new=None)  # will raise TypeError on call
+    @mock.patch("tqdm.tqdm", new=None)  # will raise TypeError on call
+    def test_to_dataframe_tqdm_error(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+
+        for progress_bar_type in ("tqdm", "tqdm_notebook", "tqdm_gui"):
+            api_request = mock.Mock(return_value={"rows": rows})
+            row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+            with warnings.catch_warnings(record=True) as warned:
+                df = row_iterator.to_dataframe(progress_bar_type=progress_bar_type)
+
+            self.assertEqual(len(df), 4)  # all should be well
+
+            # Warn that a progress bar was requested, but creating the tqdm
+            # progress bar failed.
+            for warning in warned:
+                self.assertIs(warning.category, UserWarning)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_w_empty_results(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        api_request = mock.Mock(return_value={"rows": []})
+        row_iterator = self._make_one(_mock_client(), api_request, schema=schema)
+
+        df = row_iterator.to_dataframe()
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 0)  # verify the number of rows
+        self.assertEqual(list(df), ["name", "age"])  # verify the column names
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_logs_tabledata_list(self):
+        from google.cloud.bigquery.table import Table
+
+        mock_logger = mock.create_autospec(logging.Logger)
+        api_request = mock.Mock(return_value={"rows": []})
+        row_iterator = self._make_one(
+            _mock_client(), api_request, table=Table("debug-proj.debug_dset.debug_tbl")
+        )
+
+        with mock.patch("google.cloud.bigquery.table._LOGGER", mock_logger):
+            row_iterator.to_dataframe()
+
+        mock_logger.debug.assert_any_call(
+            "Started reading table 'debug-proj.debug_dset.debug_tbl' with tabledata.list."
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_w_various_types_nullable(self):
+        import datetime
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("start_timestamp", "TIMESTAMP"),
+            SchemaField("seconds", "INT64"),
+            SchemaField("miles", "FLOAT64"),
+            SchemaField("payment_type", "STRING"),
+            SchemaField("complete", "BOOL"),
+            SchemaField("date", "DATE"),
+        ]
+        row_data = [
+            [None, None, None, None, None, None],
+            ["1.4338368E9", "420", "1.1", "Cash", "true", "1999-12-01"],
+            ["1.3878117E9", "2580", "17.7", "Cash", "false", "1953-06-14"],
+            ["1.3855653E9", "2280", "4.4", "Credit", "true", "1981-11-04"],
+        ]
+        rows = [{"f": [{"v": field} for field in row]} for row in row_data]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        df = row_iterator.to_dataframe()
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 4)  # verify the number of rows
+        exp_columns = [field.name for field in schema]
+        self.assertEqual(list(df), exp_columns)  # verify the column names
+
+        for index, row in df.iterrows():
+            if index == 0:
+                self.assertTrue(row.isnull().all())
+            else:
+                self.assertIsInstance(row.start_timestamp, pandas.Timestamp)
+                self.assertIsInstance(row.seconds, float)
+                self.assertIsInstance(row.payment_type, str)
+                self.assertIsInstance(row.complete, bool)
+                self.assertIsInstance(row.date, datetime.date)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_column_dtypes(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("start_timestamp", "TIMESTAMP"),
+            SchemaField("seconds", "INT64"),
+            SchemaField("miles", "FLOAT64"),
+            SchemaField("km", "FLOAT64"),
+            SchemaField("payment_type", "STRING"),
+            SchemaField("complete", "BOOL"),
+            SchemaField("date", "DATE"),
+        ]
+        row_data = [
+            ["1.4338368E9", "420", "1.1", "1.77", "Cash", "true", "1999-12-01"],
+            ["1.3878117E9", "2580", "17.7", "28.5", "Cash", "false", "1953-06-14"],
+            ["1.3855653E9", "2280", "4.4", "7.1", "Credit", "true", "1981-11-04"],
+        ]
+        rows = [{"f": [{"v": field} for field in row]} for row in row_data]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        df = row_iterator.to_dataframe(dtypes={"km": "float16"})
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 3)  # verify the number of rows
+        exp_columns = [field.name for field in schema]
+        self.assertEqual(list(df), exp_columns)  # verify the column names
+
+        self.assertEqual(df.start_timestamp.dtype.name, "datetime64[ns, UTC]")
+        self.assertEqual(df.seconds.dtype.name, "int64")
+        self.assertEqual(df.miles.dtype.name, "float64")
+        self.assertEqual(df.km.dtype.name, "float16")
+        self.assertEqual(df.payment_type.dtype.name, "object")
+        self.assertEqual(df.complete.dtype.name, "bool")
+        self.assertEqual(df.date.dtype.name, "object")
+
+    @mock.patch("google.cloud.bigquery.table.pandas", new=None)
+    def test_to_dataframe_error_if_pandas_is_none(self):
+        from google.cloud.bigquery.table import SchemaField
+
+        schema = [
+            SchemaField("name", "STRING", mode="REQUIRED"),
+            SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = self._make_one(_mock_client(), api_request, path, schema)
+
+        with self.assertRaises(ValueError):
+            row_iterator.to_dataframe()
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_w_bqstorage_no_streams(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        session = bigquery_storage_v1beta1.types.ReadSession()
+        bqstorage_client.create_read_session.return_value = session
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            api_request=None,
+            path=None,
+            schema=[
+                schema.SchemaField("colA", "IGNORED"),
+                schema.SchemaField("colC", "IGNORED"),
+                schema.SchemaField("colB", "IGNORED"),
+            ],
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+        )
+
+        got = row_iterator.to_dataframe(bqstorage_client)
+        column_names = ["colA", "colC", "colB"]
+        self.assertEqual(list(got), column_names)
+        self.assertTrue(got.empty)
+
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_dataframe_w_bqstorage_logs_session(self):
+        from google.cloud.bigquery.table import Table
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        session = bigquery_storage_v1beta1.types.ReadSession()
+        session.name = "projects/test-proj/locations/us/sessions/SOMESESSION"
+        bqstorage_client.create_read_session.return_value = session
+        mock_logger = mock.create_autospec(logging.Logger)
+        row_iterator = self._make_one(
+            _mock_client(), table=Table("debug-proj.debug_dset.debug_tbl")
+        )
+
+        with mock.patch("google.cloud.bigquery._pandas_helpers._LOGGER", mock_logger):
+            row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+
+        mock_logger.debug.assert_any_call(
+            "Started reading table 'debug-proj.debug_dset.debug_tbl' "
+            "with BQ Storage API session 'projects/test-proj/locations/us/sessions/SOMESESSION'."
+        )
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_dataframe_w_bqstorage_empty_streams(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+        from google.cloud.bigquery_storage_v1beta1 import reader
+
+        arrow_fields = [
+            pyarrow.field("colA", pyarrow.int64()),
+            # Not alphabetical to test column order.
+            pyarrow.field("colC", pyarrow.float64()),
+            pyarrow.field("colB", pyarrow.utf8()),
+        ]
+        arrow_schema = pyarrow.schema(arrow_fields)
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        session = bigquery_storage_v1beta1.types.ReadSession(
+            streams=[{"name": "/projects/proj/dataset/dset/tables/tbl/streams/1234"}],
+            arrow_schema={"serialized_schema": arrow_schema.serialize().to_pybytes()},
+        )
+        bqstorage_client.create_read_session.return_value = session
+
+        mock_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        bqstorage_client.read_rows.return_value = mock_rowstream
+
+        mock_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_rowstream.rows.return_value = mock_rows
+        mock_pages = mock.PropertyMock(return_value=())
+        type(mock_rows).pages = mock_pages
+
+        schema = [
+            schema.SchemaField("colA", "IGNORED"),
+            schema.SchemaField("colC", "IGNORED"),
+            schema.SchemaField("colB", "IGNORED"),
+        ]
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            schema,
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+            selected_fields=schema,
+        )
+
+        got = row_iterator.to_dataframe(bqstorage_client)
+
+        column_names = ["colA", "colC", "colB"]
+        self.assertEqual(list(got), column_names)
+        self.assertTrue(got.empty)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_dataframe_w_bqstorage_nonempty(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+        from google.cloud.bigquery_storage_v1beta1 import reader
+
+        arrow_fields = [
+            pyarrow.field("colA", pyarrow.int64()),
+            # Not alphabetical to test column order.
+            pyarrow.field("colC", pyarrow.float64()),
+            pyarrow.field("colB", pyarrow.utf8()),
+        ]
+        arrow_schema = pyarrow.schema(arrow_fields)
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        streams = [
+            # Use two streams we want to check frames are read from each stream.
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/1234"},
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/5678"},
+        ]
+        session = bigquery_storage_v1beta1.types.ReadSession(
+            streams=streams,
+            arrow_schema={"serialized_schema": arrow_schema.serialize().to_pybytes()},
+        )
+        bqstorage_client.create_read_session.return_value = session
+
+        mock_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        bqstorage_client.read_rows.return_value = mock_rowstream
+
+        mock_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_rowstream.rows.return_value = mock_rows
+        page_items = [
+            {"colA": 1, "colB": "abc", "colC": 2.0},
+            {"colA": -1, "colB": "def", "colC": 4.0},
+        ]
+
+        mock_page = mock.create_autospec(reader.ReadRowsPage)
+        mock_page.to_dataframe.return_value = pandas.DataFrame(
+            page_items, columns=["colA", "colB", "colC"]
+        )
+        mock_pages = (mock_page, mock_page, mock_page)
+        type(mock_rows).pages = mock.PropertyMock(return_value=mock_pages)
+
+        schema = [
+            schema.SchemaField("colA", "IGNORED"),
+            schema.SchemaField("colC", "IGNORED"),
+            schema.SchemaField("colB", "IGNORED"),
+        ]
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            schema,
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+            selected_fields=schema,
+        )
+
+        got = row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+
+        # Are the columns in the expected order?
+        column_names = ["colA", "colC", "colB"]
+        self.assertEqual(list(got), column_names)
+
+        # Have expected number of rows?
+        total_pages = len(streams) * len(mock_pages)
+        total_rows = len(page_items) * total_pages
+        self.assertEqual(len(got.index), total_rows)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_dataframe_w_bqstorage_multiple_streams_return_unique_index(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+        from google.cloud.bigquery_storage_v1beta1 import reader
+
+        arrow_fields = [pyarrow.field("colA", pyarrow.int64())]
+        arrow_schema = pyarrow.schema(arrow_fields)
+
+        streams = [
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/1234"},
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/5678"},
+        ]
+        session = bigquery_storage_v1beta1.types.ReadSession(
+            streams=streams,
+            arrow_schema={"serialized_schema": arrow_schema.serialize().to_pybytes()},
+        )
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        bqstorage_client.create_read_session.return_value = session
+
+        mock_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        bqstorage_client.read_rows.return_value = mock_rowstream
+
+        mock_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_rowstream.rows.return_value = mock_rows
+
+        page_data_frame = pandas.DataFrame(
+            [{"colA": 1}, {"colA": -1}], columns=["colA"]
+        )
+        mock_page = mock.create_autospec(reader.ReadRowsPage)
+        mock_page.to_dataframe.return_value = page_data_frame
+        mock_pages = (mock_page, mock_page, mock_page)
+        type(mock_rows).pages = mock.PropertyMock(return_value=mock_pages)
+
+        row_iterator = self._make_one(
+            schema=[schema.SchemaField("colA", "IGNORED")],
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+        )
+        got = row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+
+        self.assertEqual(list(got), ["colA"])
+        total_pages = len(streams) * len(mock_pages)
+        total_rows = len(page_data_frame) * total_pages
+        self.assertEqual(len(got.index), total_rows)
+        self.assertTrue(got.index.is_unique)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    @unittest.skipIf(tqdm is None, "Requires `tqdm`")
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    @mock.patch("tqdm.tqdm")
+    def test_to_dataframe_w_bqstorage_updates_progress_bar(self, tqdm_mock):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+        from google.cloud.bigquery_storage_v1beta1 import reader
+
+        # Speed up testing.
+        mut._PROGRESS_INTERVAL = 0.01
+
+        arrow_fields = [pyarrow.field("testcol", pyarrow.int64())]
+        arrow_schema = pyarrow.schema(arrow_fields)
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        streams = [
+            # Use two streams we want to check that progress bar updates are
+            # sent from each stream.
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/1234"},
+            {"name": "/projects/proj/dataset/dset/tables/tbl/streams/5678"},
+        ]
+        session = bigquery_storage_v1beta1.types.ReadSession(
+            streams=streams,
+            arrow_schema={"serialized_schema": arrow_schema.serialize().to_pybytes()},
+        )
+        bqstorage_client.create_read_session.return_value = session
+
+        mock_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        bqstorage_client.read_rows.return_value = mock_rowstream
+
+        mock_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_rowstream.rows.return_value = mock_rows
+        mock_page = mock.create_autospec(reader.ReadRowsPage)
+        page_items = [-1, 0, 1]
+        type(mock_page).num_items = mock.PropertyMock(return_value=len(page_items))
+
+        def blocking_to_dataframe(*args, **kwargs):
+            # Sleep for longer than the waiting interval. This ensures the
+            # progress_queue gets written to more than once because it gives
+            # the worker->progress updater time to sum intermediate updates.
+            time.sleep(2 * mut._PROGRESS_INTERVAL)
+            return pandas.DataFrame({"testcol": page_items})
+
+        mock_page.to_dataframe.side_effect = blocking_to_dataframe
+        mock_pages = (mock_page, mock_page, mock_page, mock_page, mock_page)
+        type(mock_rows).pages = mock.PropertyMock(return_value=mock_pages)
+
+        schema = [schema.SchemaField("testcol", "IGNORED")]
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            schema,
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+            selected_fields=schema,
+        )
+
+        row_iterator.to_dataframe(
+            bqstorage_client=bqstorage_client, progress_bar_type="tqdm"
+        )
+
+        # Make sure that this test updated the progress bar once per page from
+        # each stream.
+        total_pages = len(streams) * len(mock_pages)
+        expected_total_rows = total_pages * len(page_items)
+        progress_updates = [
+            args[0] for args, kwargs in tqdm_mock().update.call_args_list
+        ]
+        # Should have sent >1 update due to delay in blocking_to_dataframe.
+        self.assertGreater(len(progress_updates), 1)
+        self.assertEqual(sum(progress_updates), expected_total_rows)
+        tqdm_mock().close.assert_called_once()
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    @unittest.skipIf(pyarrow is None, "Requires `pyarrow`")
+    def test_to_dataframe_w_bqstorage_exits_on_keyboardinterrupt(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+        from google.cloud.bigquery_storage_v1beta1 import reader
+
+        # Speed up testing.
+        mut._PROGRESS_INTERVAL = 0.01
+
+        arrow_fields = [
+            pyarrow.field("colA", pyarrow.int64()),
+            # Not alphabetical to test column order.
+            pyarrow.field("colC", pyarrow.float64()),
+            pyarrow.field("colB", pyarrow.utf8()),
+        ]
+        arrow_schema = pyarrow.schema(arrow_fields)
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        session = bigquery_storage_v1beta1.types.ReadSession(
+            streams=[
+                # Use two streams because one will fail with a
+                # KeyboardInterrupt, and we want to check that the other stream
+                # ends early.
+                {"name": "/projects/proj/dataset/dset/tables/tbl/streams/1234"},
+                {"name": "/projects/proj/dataset/dset/tables/tbl/streams/5678"},
+            ],
+            arrow_schema={"serialized_schema": arrow_schema.serialize().to_pybytes()},
+        )
+        bqstorage_client.create_read_session.return_value = session
+
+        def blocking_to_dataframe(*args, **kwargs):
+            # Sleep for longer than the waiting interval so that we know we're
+            # only reading one page per loop at most.
+            time.sleep(2 * mut._PROGRESS_INTERVAL)
+            return pandas.DataFrame(
+                {"colA": [1, -1], "colB": ["abc", "def"], "colC": [2.0, 4.0]},
+                columns=["colA", "colB", "colC"],
+            )
+
+        mock_page = mock.create_autospec(reader.ReadRowsPage)
+        mock_page.to_dataframe.side_effect = blocking_to_dataframe
+        mock_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_pages = mock.PropertyMock(return_value=(mock_page, mock_page, mock_page))
+        type(mock_rows).pages = mock_pages
+        mock_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        mock_rowstream.rows.return_value = mock_rows
+
+        mock_cancelled_rows = mock.create_autospec(reader.ReadRowsIterable)
+        mock_cancelled_pages = mock.PropertyMock(side_effect=KeyboardInterrupt)
+        type(mock_cancelled_rows).pages = mock_cancelled_pages
+        mock_cancelled_rowstream = mock.create_autospec(reader.ReadRowsStream)
+        mock_cancelled_rowstream.rows.return_value = mock_cancelled_rows
+
+        bqstorage_client.read_rows.side_effect = (
+            mock_cancelled_rowstream,
+            mock_rowstream,
+        )
+
+        schema = [
+            schema.SchemaField("colA", "IGNORED"),
+            schema.SchemaField("colB", "IGNORED"),
+            schema.SchemaField("colC", "IGNORED"),
+        ]
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            schema,
+            table=mut.TableReference.from_string("proj.dset.tbl"),
+            selected_fields=schema,
+        )
+
+        with pytest.raises(KeyboardInterrupt):
+            row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+
+        # Should not have fetched the third page of results because exit_early
+        # should have been set.
+        self.assertLessEqual(mock_page.to_dataframe.call_count, 2)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_w_bqstorage_fallback_to_tabledata_list(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        bqstorage_client.create_read_session.side_effect = google.api_core.exceptions.InternalServerError(
+            "can't read with bqstorage_client"
+        )
+        iterator_schema = [
+            schema.SchemaField("name", "STRING", mode="REQUIRED"),
+            schema.SchemaField("age", "INTEGER", mode="REQUIRED"),
+        ]
+        rows = [
+            {"f": [{"v": "Phred Phlyntstone"}, {"v": "32"}]},
+            {"f": [{"v": "Bharney Rhubble"}, {"v": "33"}]},
+            {"f": [{"v": "Wylma Phlyntstone"}, {"v": "29"}]},
+            {"f": [{"v": "Bhettye Rhubble"}, {"v": "27"}]},
+        ]
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": rows})
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            api_request,
+            path,
+            iterator_schema,
+            table=mut.Table("proj.dset.tbl"),
+        )
+
+        df = row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 4)  # verify the number of rows
+        self.assertEqual(list(df), ["name", "age"])  # verify the column names
+        self.assertEqual(df.name.dtype.name, "object")
+        self.assertEqual(df.age.dtype.name, "int64")
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    def test_to_dataframe_tabledata_list_w_multiple_pages_return_unique_index(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+
+        iterator_schema = [schema.SchemaField("name", "STRING", mode="REQUIRED")]
+        path = "/foo"
+        api_request = mock.Mock(
+            side_effect=[
+                {"rows": [{"f": [{"v": "Bengt"}]}], "pageToken": "NEXTPAGE"},
+                {"rows": [{"f": [{"v": "Sven"}]}]},
+            ]
+        )
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            api_request,
+            path,
+            iterator_schema,
+            table=mut.Table("proj.dset.tbl"),
+        )
+
+        df = row_iterator.to_dataframe(bqstorage_client=None)
+
+        self.assertIsInstance(df, pandas.DataFrame)
+        self.assertEqual(len(df), 2)
+        self.assertEqual(list(df), ["name"])
+        self.assertEqual(df.name.dtype.name, "object")
+        self.assertTrue(df.index.is_unique)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_w_bqstorage_raises_auth_error(self):
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        bqstorage_client.create_read_session.side_effect = google.api_core.exceptions.Forbidden(
+            "TEST BigQuery Storage API not enabled. TEST"
+        )
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": []})
+        row_iterator = mut.RowIterator(
+            _mock_client(), api_request, path, [], table=mut.Table("proj.dset.tbl")
+        )
+
+        with pytest.raises(google.api_core.exceptions.Forbidden):
+            row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+
+    @unittest.skipIf(pandas is None, "Requires `pandas`")
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_w_bqstorage_raises_import_error(self):
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+        path = "/foo"
+        api_request = mock.Mock(return_value={"rows": []})
+        row_iterator = mut.RowIterator(
+            _mock_client(), api_request, path, [], table=mut.Table("proj.dset.tbl")
+        )
+
+        with mock.patch.object(mut, "bigquery_storage_v1beta1", None), pytest.raises(
+            ValueError
+        ) as exc_context:
+            row_iterator.to_dataframe(bqstorage_client=bqstorage_client)
+        assert mut._NO_BQSTORAGE_ERROR in str(exc_context.value)
+
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_w_bqstorage_partition(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            [schema.SchemaField("colA", "IGNORED")],
+            table=mut.TableReference.from_string("proj.dset.tbl$20181225"),
+        )
+
+        with pytest.raises(ValueError):
+            row_iterator.to_dataframe(bqstorage_client)
+
+    @unittest.skipIf(
+        bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+    )
+    def test_to_dataframe_w_bqstorage_snapshot(self):
+        from google.cloud.bigquery import schema
+        from google.cloud.bigquery import table as mut
+
+        bqstorage_client = mock.create_autospec(
+            bigquery_storage_v1beta1.BigQueryStorageClient
+        )
+
+        row_iterator = mut.RowIterator(
+            _mock_client(),
+            None,  # api_request: ignored
+            None,  # path: ignored
+            [schema.SchemaField("colA", "IGNORED")],
+            table=mut.TableReference.from_string("proj.dset.tbl@1234567890000"),
+        )
+
+        with pytest.raises(ValueError):
+            row_iterator.to_dataframe(bqstorage_client)
+
+
+class TestTimePartitioning(unittest.TestCase):
+    def _get_target_class(self):
+        from google.cloud.bigquery.table import TimePartitioning
+
+        return TimePartitioning
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        time_partitioning = self._make_one()
+
+        self.assertEqual(time_partitioning.type_, "DAY")
+        self.assertIsNone(time_partitioning.field)
+        self.assertIsNone(time_partitioning.expiration_ms)
+        self.assertIsNone(time_partitioning.require_partition_filter)
+
+    def test_constructor_explicit(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        time_partitioning = self._make_one(
+            type_=TimePartitioningType.DAY,
+            field="name",
+            expiration_ms=10000,
+            require_partition_filter=True,
+        )
+
+        self.assertEqual(time_partitioning.type_, "DAY")
+        self.assertEqual(time_partitioning.field, "name")
+        self.assertEqual(time_partitioning.expiration_ms, 10000)
+        self.assertTrue(time_partitioning.require_partition_filter)
+
+    def test_from_api_repr_empty(self):
+        klass = self._get_target_class()
+
+        # Even though there are required properties according to the API
+        # specification, sometimes time partitioning is populated as an empty
+        # object. See internal bug 131167013.
+        api_repr = {}
+        time_partitioning = klass.from_api_repr(api_repr)
+
+        self.assertIsNone(time_partitioning.type_)
+        self.assertIsNone(time_partitioning.field)
+        self.assertIsNone(time_partitioning.expiration_ms)
+        self.assertIsNone(time_partitioning.require_partition_filter)
+
+    def test_from_api_repr_minimal(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        klass = self._get_target_class()
+        api_repr = {"type": "DAY"}
+        time_partitioning = klass.from_api_repr(api_repr)
+
+        self.assertEqual(time_partitioning.type_, TimePartitioningType.DAY)
+        self.assertIsNone(time_partitioning.field)
+        self.assertIsNone(time_partitioning.expiration_ms)
+        self.assertIsNone(time_partitioning.require_partition_filter)
+
+    def test_from_api_repr_doesnt_override_type(self):
+        klass = self._get_target_class()
+        api_repr = {"type": "HOUR"}
+        time_partitioning = klass.from_api_repr(api_repr)
+        self.assertEqual(time_partitioning.type_, "HOUR")
+
+    def test_from_api_repr_explicit(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        klass = self._get_target_class()
+        api_repr = {
+            "type": "DAY",
+            "field": "name",
+            "expirationMs": "10000",
+            "requirePartitionFilter": True,
+        }
+        time_partitioning = klass.from_api_repr(api_repr)
+
+        self.assertEqual(time_partitioning.type_, TimePartitioningType.DAY)
+        self.assertEqual(time_partitioning.field, "name")
+        self.assertEqual(time_partitioning.expiration_ms, 10000)
+        self.assertTrue(time_partitioning.require_partition_filter)
+
+    def test_to_api_repr_defaults(self):
+        time_partitioning = self._make_one()
+        expected = {"type": "DAY"}
+        self.assertEqual(time_partitioning.to_api_repr(), expected)
+
+    def test_to_api_repr_explicit(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        time_partitioning = self._make_one(
+            type_=TimePartitioningType.DAY,
+            field="name",
+            expiration_ms=10000,
+            require_partition_filter=True,
+        )
+
+        expected = {
+            "type": "DAY",
+            "field": "name",
+            "expirationMs": "10000",
+            "requirePartitionFilter": True,
+        }
+        self.assertEqual(time_partitioning.to_api_repr(), expected)
+
+    def test___eq___wrong_type(self):
+        time_partitioning = self._make_one()
+        other = object()
+        self.assertNotEqual(time_partitioning, other)
+        self.assertEqual(time_partitioning, mock.ANY)
+
+    def test___eq___type__mismatch(self):
+        time_partitioning = self._make_one()
+        other = self._make_one(type_="HOUR")
+        self.assertNotEqual(time_partitioning, other)
+
+    def test___eq___field_mismatch(self):
+        time_partitioning = self._make_one(field="foo")
+        other = self._make_one(field="bar")
+        self.assertNotEqual(time_partitioning, other)
+
+    def test___eq___expiration_ms_mismatch(self):
+        time_partitioning = self._make_one(field="foo", expiration_ms=100000)
+        other = self._make_one(field="foo", expiration_ms=200000)
+        self.assertNotEqual(time_partitioning, other)
+
+    def test___eq___require_partition_filter_mismatch(self):
+        time_partitioning = self._make_one(
+            field="foo", expiration_ms=100000, require_partition_filter=True
+        )
+        other = self._make_one(
+            field="foo", expiration_ms=100000, require_partition_filter=False
+        )
+        self.assertNotEqual(time_partitioning, other)
+
+    def test___eq___hit(self):
+        time_partitioning = self._make_one(
+            field="foo", expiration_ms=100000, require_partition_filter=True
+        )
+        other = self._make_one(
+            field="foo", expiration_ms=100000, require_partition_filter=True
+        )
+        self.assertEqual(time_partitioning, other)
+
+    def test___ne___wrong_type(self):
+        time_partitioning = self._make_one()
+        other = object()
+        self.assertNotEqual(time_partitioning, other)
+        self.assertEqual(time_partitioning, mock.ANY)
+
+    def test___ne___same_value(self):
+        time_partitioning1 = self._make_one()
+        time_partitioning2 = self._make_one()
+        # unittest ``assertEqual`` uses ``==`` not ``!=``.
+        comparison_val = time_partitioning1 != time_partitioning2
+        self.assertFalse(comparison_val)
+
+    def test___ne___different_values(self):
+        time_partitioning1 = self._make_one()
+        time_partitioning2 = self._make_one(type_="HOUR")
+        self.assertNotEqual(time_partitioning1, time_partitioning2)
+
+    def test___hash__set_equality(self):
+        time_partitioning1 = self._make_one(field="foo")
+        time_partitioning2 = self._make_one(field="foo")
+        set_one = {time_partitioning1, time_partitioning2}
+        set_two = {time_partitioning1, time_partitioning2}
+        self.assertEqual(set_one, set_two)
+
+    def test___hash__not_equals(self):
+        time_partitioning1 = self._make_one(field="foo")
+        time_partitioning2 = self._make_one(field="bar")
+        set_one = {time_partitioning1}
+        set_two = {time_partitioning2}
+        self.assertNotEqual(set_one, set_two)
+
+    def test___repr___minimal(self):
+        time_partitioning = self._make_one()
+        expected = "TimePartitioning(type=DAY)"
+        self.assertEqual(repr(time_partitioning), expected)
+
+    def test___repr___explicit(self):
+        from google.cloud.bigquery.table import TimePartitioningType
+
+        time_partitioning = self._make_one(
+            type_=TimePartitioningType.DAY,
+            field="name",
+            expiration_ms=10000,
+            require_partition_filter=True,
+        )
+        expected = (
+            "TimePartitioning("
+            "expirationMs=10000,"
+            "field=name,"
+            "requirePartitionFilter=True,"
+            "type=DAY)"
+        )
+        self.assertEqual(repr(time_partitioning), expected)
+
+    def test_set_expiration_w_none(self):
+        time_partitioning = self._make_one()
+        time_partitioning.expiration_ms = None
+        assert time_partitioning._properties["expirationMs"] is None
+
+
+@pytest.mark.skipif(
+    bigquery_storage_v1beta1 is None, reason="Requires `google-cloud-bigquery-storage`"
+)
+def test_table_reference_to_bqstorage():
+    from google.cloud.bigquery import table as mut
+
+    # Can't use parametrized pytest because bigquery_storage_v1beta1 may not be
+    # available.
+    expected = bigquery_storage_v1beta1.types.TableReference(
+        project_id="my-project", dataset_id="my_dataset", table_id="my_table"
+    )
+    cases = (
+        "my-project.my_dataset.my_table",
+        "my-project.my_dataset.my_table$20181225",
+        "my-project.my_dataset.my_table@1234567890",
+        "my-project.my_dataset.my_table$20181225@1234567890",
+    )
+
+    classes = (mut.TableReference, mut.Table, mut.TableListItem)
+
+    for case, cls in itertools.product(cases, classes):
+        got = cls.from_string(case).to_bqstorage()
+        assert got == expected
+
+
+@unittest.skipIf(
+    bigquery_storage_v1beta1 is None, "Requires `google-cloud-bigquery-storage`"
+)
+def test_table_reference_to_bqstorage_raises_import_error():
+    from google.cloud.bigquery import table as mut
+
+    classes = (mut.TableReference, mut.Table, mut.TableListItem)
+    for cls in classes:
+        with mock.patch.object(mut, "bigquery_storage_v1beta1", None), pytest.raises(
+            ValueError
+        ) as exc_context:
+            cls.from_string("my-project.my_dataset.my_table").to_bqstorage()
+        assert mut._NO_BQSTORAGE_ERROR in str(exc_context.value)
diff --git a/bigquery_datatransfer/.coveragerc b/bigquery_datatransfer/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/bigquery_datatransfer/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/bigquery_datatransfer/.flake8 b/bigquery_datatransfer/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/bigquery_datatransfer/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/bigquery_datatransfer/.repo-metadata.json b/bigquery_datatransfer/.repo-metadata.json
new file mode 100644
index 000000000000..c128b1bcfc27
--- /dev/null
+++ b/bigquery_datatransfer/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "bigquerydatatransfer",
+  "name_pretty": "Google BigQuery Data Transfer Service",
+  "product_documentation": "https://cloud.google.com/bigquery/transfer/",
+  "client_documentation": "https://googleapis.dev/python/bigquerydatatransfer/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559654",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-bigquery-datatransfer",
+  "api_id": "bigquerydatatransfer.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/bigquery_datatransfer/CHANGELOG.md b/bigquery_datatransfer/CHANGELOG.md
new file mode 100644
index 000000000000..483716f73f63
--- /dev/null
+++ b/bigquery_datatransfer/CHANGELOG.md
@@ -0,0 +1,132 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-bigquery-datatransfer/#history
+
+## 0.4.1
+
+07-31-2019 17:50 PDT
+
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Fix links to BigQuery Datatransfer documentation. ([#8859](https://github.com/googleapis/google-cloud-python/pull/8859))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+
+### Internal / Testing Changes
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.4.0
+
+07-16-2019 17:11 PDT
+
+### Implementation Changes
+
+- Retry DEADLINE_EXCEEDED (via synth). ([#7920](https://github.com/googleapis/google-cloud-python/pull/7920))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+
+- Add `DatasourceServiceClient` (via synth). ([#8630](https://github.com/googleapis/google-cloud-python/pull/8630))
+- Add `start_manual_transfer_runs` method (via synth). ([#8630](https://github.com/googleapis/google-cloud-python/pull/8630))
+- Add `client_info`/`version_info` support (via synth). ([#8630](https://github.com/googleapis/google-cloud-python/pull/8630))
+- Allow passing kwargs to `create_channel` (via synth). ([#8630](https://github.com/googleapis/google-cloud-python/pull/8630))
+- Add path helpers (via synth). ([#8630](https://github.com/googleapis/google-cloud-python/pull/8630))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+### Documentation
+
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Adjust indentation on scheduled query sample. ([#8493](https://github.com/googleapis/google-cloud-python/pull/8493))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Add sample to schedule query with BQ DTS. ([#7703](https://github.com/googleapis/google-cloud-python/pull/7703))
+- Add nox session `docs` (via synth). ([#7765](https://github.com/googleapis/google-cloud-python/pull/7765))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Pick up stub docstring fix in GAPIC generator. ([#6965](https://github.com/googleapis/google-cloud-python/pull/6965))
+
+### Internal / Testing Changes
+
+- Blacken noxfile.py, setup.py (via synth). ([#8116](https://github.com/googleapis/google-cloud-python/pull/8116))
+- Add empty lines (via synth). ([#8050](https://github.com/googleapis/google-cloud-python/pull/8050))
+- Remove unused message exports (via synth). ([#7263](https://github.com/googleapis/google-cloud-python/pull/7263))
+- Protoc-generated serialization update. ([#7075](https://github.com/googleapis/google-cloud-python/pull/7075))
+
+## 0.3.0
+
+12-17-2018 17:59 PST
+
+
+### Implementation Changes
+- Pick up enum fixes in the GAPIC generator. ([#6608](https://github.com/googleapis/google-cloud-python/pull/6608))
+- Pick up fixes in GAPIC generator. ([#6491](https://github.com/googleapis/google-cloud-python/pull/6491))
+- Fix `client_info` bug, update docstrings. ([#6405](https://github.com/googleapis/google-cloud-python/pull/6405))
+- Re-generate library using bigquery_datatransfer/synth.py ([#5973](https://github.com/googleapis/google-cloud-python/pull/5973))
+- Fix stray, lint-breaking blank lines from autosynth. ([#5960](https://github.com/googleapis/google-cloud-python/pull/5960))
+- Re-generate library using `bigquery_datatransfer/synth.py`. ([#5947](https://github.com/googleapis/google-cloud-python/pull/5947))
+
+### Dependencies
+- Bump minimum api_core version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Fix GAX fossils ([#6264](https://github.com/googleapis/google-cloud-python/pull/6264))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6013](https://github.com/googleapis/google-cloud-python/pull/6013))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Unblack bigquery gapic and protos.
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6562](https://github.com/googleapis/google-cloud-python/pull/6562))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.2.0
+
+### Implementation Changes
+- Regenerate bigquery-datatransfer (#5793)
+
+### Internal / Testing Changes
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Fix bad trove classifier
+- Rename releases to changelog and include from CHANGELOG.md (#5191)
+
+## 0.1.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Fix package name in readme (#4670)
+- BigQueryDataTransfer: update 404 link for API documentation (#4672)
+- Replacing references to `stable/` docs with `latest/`. (#4638)
+
+### Testing and internal changes
+
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Update index.rst (#4816)
+- nox unittest updates (#4646)
+
+## 0.1.0
+
+[![release level](https://img.shields.io/badge/release%20level-alpha-orange.svg?style&#x3D;flat)](https://cloud.google.com/terms/launch-stages)
+
+The BigQuery Data Transfer Service automates data movement from SaaS
+applications to Google BigQuery on a scheduled, managed basis. Your analytics
+team can lay the foundation for a data warehouse without writing a single line
+of code. BigQuery Data Transfer Service initially supports Google application
+sources like Adwords, DoubleClick Campaign Manager, DoubleClick for Publishers
+and YouTube.
+
+PyPI: https://pypi.org/project/google-cloud-bigquery-datatransfer/0.1.0/
diff --git a/bigquery_datatransfer/LICENSE b/bigquery_datatransfer/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/bigquery_datatransfer/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/bigquery_datatransfer/MANIFEST.in b/bigquery_datatransfer/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/bigquery_datatransfer/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/bigquery_datatransfer/README.rst b/bigquery_datatransfer/README.rst
new file mode 100644
index 000000000000..bb4b5a10ef06
--- /dev/null
+++ b/bigquery_datatransfer/README.rst
@@ -0,0 +1,111 @@
+Python Client for BigQuery Data Transfer API
+============================================
+
+|alpha| |pypi| |versions| 
+
+The `BigQuery Data Transfer API`_ allows users to transfer data from partner
+SaaS applications to Google BigQuery on a scheduled, managed basis.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-bigquery-datatransfer.svg
+   :target: https://pypi.org/project/google-cloud-bigquery-datatransfer/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-bigquery-datatransfer.svg
+   :target: https://pypi.org/project/google-cloud-bigquery-datatransfer/
+.. _BigQuery Data Transfer API: https://cloud.google.com/bigquery/transfer
+.. _Client Library Documentation: https://googleapis.dev/python/bigquerydatatransfer/latest
+.. _Product Documentation:  https://cloud.google.com/bigquery/docs/transfer-service-overview
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable the BigQuery Data Transfer API.`_
+3. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable the BigQuery Data Transfer API.:  https://cloud.google.com/bigquery/docs/transfer-service-overview
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-bigquery-datatransfer
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-bigquery-datatransfer
+
+Example Usage
+~~~~~~~~~~~~~
+
+DataTransferServiceClient
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code:: py
+
+    from google.cloud.bigquery import datatransfer_v1
+
+    client = datatransfer_v1.DataTransferServiceClient()
+
+    parent = client.location_path('[PROJECT]', '[LOCATION]')
+
+
+    # Iterate over all results
+    for element in client.list_data_sources(parent):
+        # process element
+        pass
+
+    # Or iterate over results one page at a time
+    for page in client.list_data_sources(parent).pages:
+        for element in page:
+            # process element
+            pass
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for BigQuery Data Transfer API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/bigquery_datatransfer/docs/README.rst b/bigquery_datatransfer/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/bigquery_datatransfer/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/bigquery_datatransfer/docs/changelog.md b/bigquery_datatransfer/docs/changelog.md
new file mode 120000
index 000000000000..05ed7b33f590
--- /dev/null
+++ b/bigquery_datatransfer/docs/changelog.md
@@ -0,0 +1 @@
+../../bigquery_datatransfer/CHANGELOG.md
\ No newline at end of file
diff --git a/bigquery_datatransfer/docs/conf.py b/bigquery_datatransfer/docs/conf.py
new file mode 100644
index 000000000000..ef6f120fefa6
--- /dev/null
+++ b/bigquery_datatransfer/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-bigquerydatatransfer documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-bigquerydatatransfer"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-bigquerydatatransfer-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-bigquerydatatransfer.tex",
+        u"google-cloud-bigquerydatatransfer Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-bigquerydatatransfer",
+        u"google-cloud-bigquerydatatransfer Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-bigquerydatatransfer",
+        u"google-cloud-bigquerydatatransfer Documentation",
+        author,
+        "google-cloud-bigquerydatatransfer",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/bigquery_datatransfer/docs/gapic/v1/api.rst b/bigquery_datatransfer/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..a8b855bb4cc4
--- /dev/null
+++ b/bigquery_datatransfer/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for BigQuery Data Transfer API
+=====================================
+
+.. automodule:: google.cloud.bigquery_datatransfer_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/bigquery_datatransfer/docs/gapic/v1/types.rst b/bigquery_datatransfer/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..2a77ee73ecef
--- /dev/null
+++ b/bigquery_datatransfer/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for BigQuery Data Transfer API Client
+===========================================
+
+.. automodule:: google.cloud.bigquery_datatransfer_v1.types
+    :members:
\ No newline at end of file
diff --git a/bigquery_datatransfer/docs/index.rst b/bigquery_datatransfer/docs/index.rst
new file mode 100644
index 000000000000..942e2634213c
--- /dev/null
+++ b/bigquery_datatransfer/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1/api
+   gapic/v1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-bigquery-bigquery-datatransfer`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/bigquery_datatransfer/google/__init__.py b/bigquery_datatransfer/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/bigquery_datatransfer/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigquery_datatransfer/google/cloud/__init__.py b/bigquery_datatransfer/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer.py
new file mode 100644
index 000000000000..ddd78f62eea4
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.bigquery_datatransfer_v1 import DataTransferServiceClient
+from google.cloud.bigquery_datatransfer_v1 import enums
+from google.cloud.bigquery_datatransfer_v1 import types
+
+
+__all__ = ("enums", "types", "DataTransferServiceClient")
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/__init__.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/__init__.py
new file mode 100644
index 000000000000..e4a3a5f9763c
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.bigquery_datatransfer_v1 import types
+from google.cloud.bigquery_datatransfer_v1.gapic import data_transfer_service_client
+from google.cloud.bigquery_datatransfer_v1.gapic import enums
+
+
+class DataTransferServiceClient(data_transfer_service_client.DataTransferServiceClient):
+    __doc__ = data_transfer_service_client.DataTransferServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DataTransferServiceClient")
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/__init__.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/data_transfer_service_client.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/data_transfer_service_client.py
new file mode 100644
index 000000000000..5c52eed8a43d
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/data_transfer_service_client.py
@@ -0,0 +1,1534 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.bigquery.datatransfer.v1 DataTransferService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.path_template
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.bigquery_datatransfer_v1.gapic import (
+    data_transfer_service_client_config,
+)
+from google.cloud.bigquery_datatransfer_v1.gapic import enums
+from google.cloud.bigquery_datatransfer_v1.gapic.transports import (
+    data_transfer_service_grpc_transport,
+)
+from google.cloud.bigquery_datatransfer_v1.proto import datatransfer_pb2
+from google.cloud.bigquery_datatransfer_v1.proto import datatransfer_pb2_grpc
+from google.cloud.bigquery_datatransfer_v1.proto import transfer_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-bigquery-datatransfer"
+).version
+
+
+class DataTransferServiceClient(object):
+    """
+    The Google BigQuery Data Transfer Service API enables BigQuery users to
+    configure the transfer of their data from other Google Products into
+    BigQuery. This service contains methods that are end user exposed. It backs
+    up the frontend.
+    """
+
+    SERVICE_ADDRESS = "bigquerydatatransfer.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.bigquery.datatransfer.v1.DataTransferService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DataTransferServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def location_data_source_path(cls, project, location, data_source):
+        """Return a fully-qualified location_data_source string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/dataSources/{data_source}",
+            project=project,
+            location=location,
+            data_source=data_source,
+        )
+
+    @classmethod
+    def location_run_path(cls, project, location, transfer_config, run):
+        """Return a fully-qualified location_run string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run}",
+            project=project,
+            location=location,
+            transfer_config=transfer_config,
+            run=run,
+        )
+
+    @classmethod
+    def location_transfer_config_path(cls, project, location, transfer_config):
+        """Return a fully-qualified location_transfer_config string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/transferConfigs/{transfer_config}",
+            project=project,
+            location=location,
+            transfer_config=transfer_config,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def project_data_source_path(cls, project, data_source):
+        """Return a fully-qualified project_data_source string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/dataSources/{data_source}",
+            project=project,
+            data_source=data_source,
+        )
+
+    @classmethod
+    def project_run_path(cls, project, transfer_config, run):
+        """Return a fully-qualified project_run string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/transferConfigs/{transfer_config}/runs/{run}",
+            project=project,
+            transfer_config=transfer_config,
+            run=run,
+        )
+
+    @classmethod
+    def project_transfer_config_path(cls, project, transfer_config):
+        """Return a fully-qualified project_transfer_config string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/transferConfigs/{transfer_config}",
+            project=project,
+            transfer_config=transfer_config,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DataTransferServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DataTransferServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = data_transfer_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=data_transfer_service_grpc_transport.DataTransferServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = data_transfer_service_grpc_transport.DataTransferServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def get_data_source(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves a supported data source and returns its settings,
+        which can be used for UI rendering.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> name = client.project_data_source_path('[PROJECT]', '[DATA_SOURCE]')
+            >>>
+            >>> response = client.get_data_source(name)
+
+        Args:
+            name (str): The field will contain name of the resource requested, for example:
+                ``projects/{project_id}/dataSources/{data_source_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.DataSource` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_data_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_data_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_data_source,
+                default_retry=self._method_configs["GetDataSource"].retry,
+                default_timeout=self._method_configs["GetDataSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.GetDataSourceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_data_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_data_sources(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists supported data sources and returns their settings,
+        which can be used for UI rendering.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_data_sources(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_data_sources(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The BigQuery project id for which data sources should be returned. Must
+                be in the form: ``projects/{project_id}``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigquery_datatransfer_v1.types.DataSource` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_data_sources" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_data_sources"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_data_sources,
+                default_retry=self._method_configs["ListDataSources"].retry,
+                default_timeout=self._method_configs["ListDataSources"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.ListDataSourcesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_data_sources"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="data_sources",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_transfer_config(
+        self,
+        parent,
+        transfer_config,
+        authorization_code=None,
+        version_info=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new data transfer configuration.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `transfer_config`:
+            >>> transfer_config = {}
+            >>>
+            >>> response = client.create_transfer_config(parent, transfer_config)
+
+        Args:
+            parent (str): 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.
+            transfer_config (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.TransferConfig]): Data transfer configuration to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferConfig`
+            authorization_code (str): Optional OAuth2 authorization code to use with this transfer
+                configuration. This is required if new credentials are needed, as
+                indicated by ``CheckValidCreds``. In order to obtain
+                authorization\_code, please make a request to
+                https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client\_id=&scope=<data\_source\_scopes>&redirect\_uri=<redirect\_uri>
+
+                -  client\_id should be OAuth client\_id of BigQuery DTS API for the
+                   given data source returned by ListDataSources method.
+                -  data\_source\_scopes are the scopes returned by ListDataSources
+                   method.
+                -  redirect\_uri is an optional parameter. If not specified, then
+                   authorization code is posted to the opener of authorization flow
+                   window. Otherwise it will be sent to the redirect uri. A special
+                   value of urn:ietf:wg:oauth:2.0:oob means that authorization code
+                   should be returned in the title bar of the browser, with the page
+                   text prompting the user to copy the code and paste it in the
+                   application.
+            version_info (str): Optional version info. If users want to find a very recent access token,
+                that is, immediately after approving access, users have to set the
+                version\_info claim in the token request. To obtain the version\_info,
+                users must use the "none+gsession" response type. which be return a
+                version\_info back in the authorization response which be be put in a
+                JWT claim in the token request.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_transfer_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_transfer_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_transfer_config,
+                default_retry=self._method_configs["CreateTransferConfig"].retry,
+                default_timeout=self._method_configs["CreateTransferConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.CreateTransferConfigRequest(
+            parent=parent,
+            transfer_config=transfer_config,
+            authorization_code=authorization_code,
+            version_info=version_info,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_transfer_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_transfer_config(
+        self,
+        transfer_config,
+        update_mask,
+        authorization_code=None,
+        version_info=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a data transfer configuration.
+        All fields must be set, even if they are not updated.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> # TODO: Initialize `transfer_config`:
+            >>> transfer_config = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_transfer_config(transfer_config, update_mask)
+
+        Args:
+            transfer_config (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.TransferConfig]): Data transfer configuration to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferConfig`
+            update_mask (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.FieldMask]): Required list of fields to be updated in this request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.FieldMask`
+            authorization_code (str): Optional OAuth2 authorization code to use with this transfer
+                configuration. If it is provided, the transfer configuration will be
+                associated with the authorizing user. In order to obtain
+                authorization\_code, please make a request to
+                https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client\_id=&scope=<data\_source\_scopes>&redirect\_uri=<redirect\_uri>
+
+                -  client\_id should be OAuth client\_id of BigQuery DTS API for the
+                   given data source returned by ListDataSources method.
+                -  data\_source\_scopes are the scopes returned by ListDataSources
+                   method.
+                -  redirect\_uri is an optional parameter. If not specified, then
+                   authorization code is posted to the opener of authorization flow
+                   window. Otherwise it will be sent to the redirect uri. A special
+                   value of urn:ietf:wg:oauth:2.0:oob means that authorization code
+                   should be returned in the title bar of the browser, with the page
+                   text prompting the user to copy the code and paste it in the
+                   application.
+            version_info (str): Optional version info. If users want to find a very recent access token,
+                that is, immediately after approving access, users have to set the
+                version\_info claim in the token request. To obtain the version\_info,
+                users must use the "none+gsession" response type. which be return a
+                version\_info back in the authorization response which be be put in a
+                JWT claim in the token request.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_transfer_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_transfer_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_transfer_config,
+                default_retry=self._method_configs["UpdateTransferConfig"].retry,
+                default_timeout=self._method_configs["UpdateTransferConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.UpdateTransferConfigRequest(
+            transfer_config=transfer_config,
+            update_mask=update_mask,
+            authorization_code=authorization_code,
+            version_info=version_info,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("transfer_config.name", transfer_config.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_transfer_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_transfer_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a data transfer configuration,
+        including any associated transfer runs and logs.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> name = client.project_transfer_config_path('[PROJECT]', '[TRANSFER_CONFIG]')
+            >>>
+            >>> client.delete_transfer_config(name)
+
+        Args:
+            name (str): The field will contain name of the resource requested, for example:
+                ``projects/{project_id}/transferConfigs/{config_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_transfer_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_transfer_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_transfer_config,
+                default_retry=self._method_configs["DeleteTransferConfig"].retry,
+                default_timeout=self._method_configs["DeleteTransferConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.DeleteTransferConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_transfer_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_transfer_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns information about a data transfer config.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> name = client.project_transfer_config_path('[PROJECT]', '[TRANSFER_CONFIG]')
+            >>>
+            >>> response = client.get_transfer_config(name)
+
+        Args:
+            name (str): The field will contain name of the resource requested, for example:
+                ``projects/{project_id}/transferConfigs/{config_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_transfer_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_transfer_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_transfer_config,
+                default_retry=self._method_configs["GetTransferConfig"].retry,
+                default_timeout=self._method_configs["GetTransferConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.GetTransferConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_transfer_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_transfer_configs(
+        self,
+        parent,
+        data_source_ids=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns information about all data transfers in the project.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_transfer_configs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_transfer_configs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The BigQuery project id for which data sources should be returned:
+                ``projects/{project_id}``.
+            data_source_ids (list[str]): When specified, only configurations of requested data sources are returned.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferConfig` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_transfer_configs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_transfer_configs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_transfer_configs,
+                default_retry=self._method_configs["ListTransferConfigs"].retry,
+                default_timeout=self._method_configs["ListTransferConfigs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.ListTransferConfigsRequest(
+            parent=parent, data_source_ids=data_source_ids, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_transfer_configs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="transfer_configs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def schedule_transfer_runs(
+        self,
+        parent,
+        start_time,
+        end_time,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates transfer runs for a time range [start\_time, end\_time]. For
+        each date - or whatever granularity the data source supports - in the
+        range, one transfer run is created. Note that runs are created per UTC
+        time in the time range. DEPRECATED: use StartManualTransferRuns instead.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> parent = client.project_transfer_config_path('[PROJECT]', '[TRANSFER_CONFIG]')
+            >>>
+            >>> # TODO: Initialize `start_time`:
+            >>> start_time = {}
+            >>>
+            >>> # TODO: Initialize `end_time`:
+            >>> end_time = {}
+            >>>
+            >>> response = client.schedule_transfer_runs(parent, start_time, end_time)
+
+        Args:
+            parent (str): Transfer configuration name in the form:
+                ``projects/{project_id}/transferConfigs/{config_id}``.
+            start_time (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.Timestamp]): Start time of the range of transfer runs. For example,
+                ``"2017-05-25T00:00:00+00:00"``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.Timestamp`
+            end_time (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.Timestamp]): End time of the range of transfer runs. For example,
+                ``"2017-05-30T00:00:00+00:00"``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.ScheduleTransferRunsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "schedule_transfer_runs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "schedule_transfer_runs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.schedule_transfer_runs,
+                default_retry=self._method_configs["ScheduleTransferRuns"].retry,
+                default_timeout=self._method_configs["ScheduleTransferRuns"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.ScheduleTransferRunsRequest(
+            parent=parent, start_time=start_time, end_time=end_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["schedule_transfer_runs"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_transfer_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns information about the particular transfer run.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> name = client.project_run_path('[PROJECT]', '[TRANSFER_CONFIG]', '[RUN]')
+            >>>
+            >>> response = client.get_transfer_run(name)
+
+        Args:
+            name (str): The field will contain name of the resource requested, for example:
+                ``projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_transfer_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_transfer_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_transfer_run,
+                default_retry=self._method_configs["GetTransferRun"].retry,
+                default_timeout=self._method_configs["GetTransferRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.GetTransferRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_transfer_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_transfer_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the specified transfer run.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> name = client.project_run_path('[PROJECT]', '[TRANSFER_CONFIG]', '[RUN]')
+            >>>
+            >>> client.delete_transfer_run(name)
+
+        Args:
+            name (str): The field will contain name of the resource requested, for example:
+                ``projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_transfer_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_transfer_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_transfer_run,
+                default_retry=self._method_configs["DeleteTransferRun"].retry,
+                default_timeout=self._method_configs["DeleteTransferRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.DeleteTransferRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_transfer_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_transfer_runs(
+        self,
+        parent,
+        states=None,
+        page_size=None,
+        run_attempt=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns information about running and completed jobs.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> parent = client.project_transfer_config_path('[PROJECT]', '[TRANSFER_CONFIG]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_transfer_runs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_transfer_runs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Name of transfer configuration for which transfer runs should be
+                retrieved. Format of transfer configuration resource name is:
+                ``projects/{project_id}/transferConfigs/{config_id}``.
+            states (list[~google.cloud.bigquery_datatransfer_v1.types.TransferState]): When specified, only transfer runs with requested states are returned.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            run_attempt (~google.cloud.bigquery_datatransfer_v1.types.RunAttempt): Indicates how run attempts are to be pulled.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferRun` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_transfer_runs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_transfer_runs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_transfer_runs,
+                default_retry=self._method_configs["ListTransferRuns"].retry,
+                default_timeout=self._method_configs["ListTransferRuns"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.ListTransferRunsRequest(
+            parent=parent, states=states, page_size=page_size, run_attempt=run_attempt
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_transfer_runs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="transfer_runs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_transfer_logs(
+        self,
+        parent,
+        page_size=None,
+        message_types=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns user facing log messages for the data transfer run.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> parent = client.project_run_path('[PROJECT]', '[TRANSFER_CONFIG]', '[RUN]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_transfer_logs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_transfer_logs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Transfer run name in the form:
+                ``projects/{project_id}/transferConfigs/{config_Id}/runs/{run_id}``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            message_types (list[~google.cloud.bigquery_datatransfer_v1.types.MessageSeverity]): Message types to return. If not populated - INFO, WARNING and ERROR
+                messages are returned.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigquery_datatransfer_v1.types.TransferMessage` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_transfer_logs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_transfer_logs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_transfer_logs,
+                default_retry=self._method_configs["ListTransferLogs"].retry,
+                default_timeout=self._method_configs["ListTransferLogs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.ListTransferLogsRequest(
+            parent=parent, page_size=page_size, message_types=message_types
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_transfer_logs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="transfer_messages",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def check_valid_creds(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns true if valid credentials exist for the given data source and
+        requesting user.
+        Some data sources doesn't support service account, so we need to talk to
+        them on behalf of the end user. This API just checks whether we have OAuth
+        token for the particular user, which is a pre-requisite before user can
+        create a transfer config.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> name = client.project_data_source_path('[PROJECT]', '[DATA_SOURCE]')
+            >>>
+            >>> response = client.check_valid_creds(name)
+
+        Args:
+            name (str): The data source in the form:
+                ``projects/{project_id}/dataSources/{data_source_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.CheckValidCredsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "check_valid_creds" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "check_valid_creds"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.check_valid_creds,
+                default_retry=self._method_configs["CheckValidCreds"].retry,
+                default_timeout=self._method_configs["CheckValidCreds"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datatransfer_pb2.CheckValidCredsRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["check_valid_creds"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def start_manual_transfer_runs(
+        self,
+        parent=None,
+        requested_time_range=None,
+        requested_run_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Start manual transfer runs to be executed now with schedule\_time equal
+        to current time. The transfer runs can be created for a time range where
+        the run\_time is between start\_time (inclusive) and end\_time
+        (exclusive), or for a specific run\_time.
+
+        Example:
+            >>> from google.cloud import bigquery_datatransfer_v1
+            >>>
+            >>> client = bigquery_datatransfer_v1.DataTransferServiceClient()
+            >>>
+            >>> response = client.start_manual_transfer_runs()
+
+        Args:
+            parent (str): Transfer configuration name in the form:
+                ``projects/{project_id}/transferConfigs/{config_id}``.
+            requested_time_range (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.TimeRange]): Time range for the transfer runs that should be started.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.TimeRange`
+            requested_run_time (Union[dict, ~google.cloud.bigquery_datatransfer_v1.types.Timestamp]): Specific run\_time for a transfer run to be started. The
+                requested\_run\_time must not be in the future.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_datatransfer_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_datatransfer_v1.types.StartManualTransferRunsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "start_manual_transfer_runs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "start_manual_transfer_runs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.start_manual_transfer_runs,
+                default_retry=self._method_configs["StartManualTransferRuns"].retry,
+                default_timeout=self._method_configs["StartManualTransferRuns"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            requested_time_range=requested_time_range,
+            requested_run_time=requested_run_time,
+        )
+
+        request = datatransfer_pb2.StartManualTransferRunsRequest(
+            parent=parent,
+            requested_time_range=requested_time_range,
+            requested_run_time=requested_run_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["start_manual_transfer_runs"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/data_transfer_service_client_config.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/data_transfer_service_client_config.py
new file mode 100644
index 000000000000..28a9494f22ef
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/data_transfer_service_client_config.py
@@ -0,0 +1,93 @@
+config = {
+    "interfaces": {
+        "google.cloud.bigquery.datatransfer.v1.DataTransferService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "GetDataSource": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDataSources": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTransferConfig": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTransferConfig": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTransferConfig": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTransferConfig": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTransferConfigs": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ScheduleTransferRuns": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTransferRun": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTransferRun": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTransferRuns": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTransferLogs": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CheckValidCreds": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "StartManualTransferRuns": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/enums.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/enums.py
new file mode 100644
index 000000000000..2602eca70f2e
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/enums.py
@@ -0,0 +1,164 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class TransferState(enum.IntEnum):
+    """
+    Represents data transfer run state.
+
+    Attributes:
+      TRANSFER_STATE_UNSPECIFIED (int): State placeholder.
+      PENDING (int): Data transfer is scheduled and is waiting to be picked up by
+      data transfer backend.
+      RUNNING (int): Data transfer is in progress.
+      SUCCEEDED (int): Data transfer completed successfully.
+      FAILED (int): Data transfer failed.
+      CANCELLED (int): Data transfer is cancelled.
+    """
+
+    TRANSFER_STATE_UNSPECIFIED = 0
+    PENDING = 2
+    RUNNING = 3
+    SUCCEEDED = 4
+    FAILED = 5
+    CANCELLED = 6
+
+
+class TransferType(enum.IntEnum):
+    """
+    DEPRECATED. Represents data transfer type.
+
+    Attributes:
+      TRANSFER_TYPE_UNSPECIFIED (int): Invalid or Unknown transfer type placeholder.
+      BATCH (int): Batch data transfer.
+      STREAMING (int): Streaming data transfer. Streaming data source currently doesn't
+      support multiple transfer configs per project.
+    """
+
+    TRANSFER_TYPE_UNSPECIFIED = 0
+    BATCH = 1
+    STREAMING = 2
+
+
+class DataSource(object):
+    class AuthorizationType(enum.IntEnum):
+        """
+        The type of authorization needed for this data source.
+
+        Attributes:
+          AUTHORIZATION_TYPE_UNSPECIFIED (int): Type unspecified.
+          AUTHORIZATION_CODE (int): Use OAuth 2 authorization codes that can be exchanged
+          for a refresh token on the backend.
+          GOOGLE_PLUS_AUTHORIZATION_CODE (int): Return an authorization code for a given Google+ page that can then be
+          exchanged for a refresh token on the backend.
+        """
+
+        AUTHORIZATION_TYPE_UNSPECIFIED = 0
+        AUTHORIZATION_CODE = 1
+        GOOGLE_PLUS_AUTHORIZATION_CODE = 2
+
+    class DataRefreshType(enum.IntEnum):
+        """
+        Represents how the data source supports data auto refresh.
+
+        Attributes:
+          DATA_REFRESH_TYPE_UNSPECIFIED (int): The data source won't support data auto refresh, which is default value.
+          SLIDING_WINDOW (int): The data source supports data auto refresh, and runs will be scheduled
+          for the past few days. Does not allow custom values to be set for each
+          transfer config.
+          CUSTOM_SLIDING_WINDOW (int): The data source supports data auto refresh, and runs will be scheduled
+          for the past few days. Allows custom values to be set for each transfer
+          config.
+        """
+
+        DATA_REFRESH_TYPE_UNSPECIFIED = 0
+        SLIDING_WINDOW = 1
+        CUSTOM_SLIDING_WINDOW = 2
+
+
+class DataSourceParameter(object):
+    class Type(enum.IntEnum):
+        """
+        Parameter type.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Type unspecified.
+          STRING (int): String parameter.
+          INTEGER (int): Integer parameter (64-bits).
+          Will be serialized to json as string.
+          DOUBLE (int): Double precision floating point parameter.
+          BOOLEAN (int): Boolean parameter.
+          RECORD (int): Deprecated. This field has no effect.
+          PLUS_PAGE (int): Page ID for a Google+ Page.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        STRING = 1
+        INTEGER = 2
+        DOUBLE = 3
+        BOOLEAN = 4
+        RECORD = 5
+        PLUS_PAGE = 6
+
+
+class ListTransferRunsRequest(object):
+    class RunAttempt(enum.IntEnum):
+        """
+        Represents which runs should be pulled.
+
+        Attributes:
+          RUN_ATTEMPT_UNSPECIFIED (int): All runs should be returned.
+          LATEST (int): Only latest run per day should be returned.
+        """
+
+        RUN_ATTEMPT_UNSPECIFIED = 0
+        LATEST = 1
+
+
+class TransferMessage(object):
+    class MessageSeverity(enum.IntEnum):
+        """
+        Represents data transfer user facing message severity.
+
+        Attributes:
+          MESSAGE_SEVERITY_UNSPECIFIED (int): No severity specified.
+          INFO (int): Informational message.
+          WARNING (int): Warning message.
+          ERROR (int): Error message.
+        """
+
+        MESSAGE_SEVERITY_UNSPECIFIED = 0
+        INFO = 1
+        WARNING = 2
+        ERROR = 3
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/transports/__init__.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/transports/data_transfer_service_grpc_transport.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/transports/data_transfer_service_grpc_transport.py
new file mode 100644
index 000000000000..fa84cac3ef30
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/gapic/transports/data_transfer_service_grpc_transport.py
@@ -0,0 +1,313 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.bigquery_datatransfer_v1.proto import datatransfer_pb2_grpc
+
+
+class DataTransferServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.bigquery.datatransfer.v1 DataTransferService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="bigquerydatatransfer.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "data_transfer_service_stub": datatransfer_pb2_grpc.DataTransferServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls,
+        address="bigquerydatatransfer.googleapis.com:443",
+        credentials=None,
+        **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def get_data_source(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.get_data_source`.
+
+        Retrieves a supported data source and returns its settings,
+        which can be used for UI rendering.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].GetDataSource
+
+    @property
+    def list_data_sources(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.list_data_sources`.
+
+        Lists supported data sources and returns their settings,
+        which can be used for UI rendering.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].ListDataSources
+
+    @property
+    def create_transfer_config(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.create_transfer_config`.
+
+        Creates a new data transfer configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].CreateTransferConfig
+
+    @property
+    def update_transfer_config(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.update_transfer_config`.
+
+        Updates a data transfer configuration.
+        All fields must be set, even if they are not updated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].UpdateTransferConfig
+
+    @property
+    def delete_transfer_config(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.delete_transfer_config`.
+
+        Deletes a data transfer configuration,
+        including any associated transfer runs and logs.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].DeleteTransferConfig
+
+    @property
+    def get_transfer_config(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.get_transfer_config`.
+
+        Returns information about a data transfer config.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].GetTransferConfig
+
+    @property
+    def list_transfer_configs(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.list_transfer_configs`.
+
+        Returns information about all data transfers in the project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].ListTransferConfigs
+
+    @property
+    def schedule_transfer_runs(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.schedule_transfer_runs`.
+
+        Creates transfer runs for a time range [start\_time, end\_time]. For
+        each date - or whatever granularity the data source supports - in the
+        range, one transfer run is created. Note that runs are created per UTC
+        time in the time range. DEPRECATED: use StartManualTransferRuns instead.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].ScheduleTransferRuns
+
+    @property
+    def get_transfer_run(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.get_transfer_run`.
+
+        Returns information about the particular transfer run.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].GetTransferRun
+
+    @property
+    def delete_transfer_run(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.delete_transfer_run`.
+
+        Deletes the specified transfer run.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].DeleteTransferRun
+
+    @property
+    def list_transfer_runs(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.list_transfer_runs`.
+
+        Returns information about running and completed jobs.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].ListTransferRuns
+
+    @property
+    def list_transfer_logs(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.list_transfer_logs`.
+
+        Returns user facing log messages for the data transfer run.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].ListTransferLogs
+
+    @property
+    def check_valid_creds(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.check_valid_creds`.
+
+        Returns true if valid credentials exist for the given data source and
+        requesting user.
+        Some data sources doesn't support service account, so we need to talk to
+        them on behalf of the end user. This API just checks whether we have OAuth
+        token for the particular user, which is a pre-requisite before user can
+        create a transfer config.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].CheckValidCreds
+
+    @property
+    def start_manual_transfer_runs(self):
+        """Return the gRPC stub for :meth:`DataTransferServiceClient.start_manual_transfer_runs`.
+
+        Start manual transfer runs to be executed now with schedule\_time equal
+        to current time. The transfer runs can be created for a time range where
+        the run\_time is between start\_time (inclusive) and end\_time
+        (exclusive), or for a specific run\_time.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_transfer_service_stub"].StartManualTransferRuns
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/__init__.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource.proto b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource.proto
new file mode 100644
index 000000000000..d7400a55935d
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource.proto
@@ -0,0 +1,542 @@
+// 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/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource_pb2.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource_pb2.py
new file mode 100644
index 000000000000..82c7e654e364
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource_pb2.py
@@ -0,0 +1,2221 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/datatransfer_v1/proto/datasource.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigquery.datatransfer_v1.proto import (
+    datatransfer_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2,
+)
+from google.cloud.bigquery.datatransfer_v1.proto import (
+    transfer_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/datatransfer_v1/proto/datasource.proto",
+    package="google.cloud.bigquery.datatransfer.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.datatransfer.v1B\017DataSourceProtoP\001ZQgoogle.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer\252\002%Google.Cloud.BigQuery.DataTransfer.V1\312\002%Google\\Cloud\\BigQuery\\DataTransfer\\V1"
+    ),
+    serialized_pb=_b(
+        '\n<google/cloud/bigquery/datatransfer_v1/proto/datasource.proto\x12%google.cloud.bigquery.datatransfer.v1\x1a\x1cgoogle/api/annotations.proto\x1a>google/cloud/bigquery/datatransfer_v1/proto/datatransfer.proto\x1a:google/cloud/bigquery/datatransfer_v1/proto/transfer.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/api/client.proto"\x9e\x0e\n\x10ImportedDataInfo\x12\x0b\n\x03sql\x18\x01 \x01(\t\x12\x1c\n\x14\x64\x65stination_table_id\x18\x02 \x01(\t\x12%\n\x1d\x64\x65stination_table_description\x18\n \x01(\t\x12[\n\ntable_defs\x18\x03 \x03(\x0b\x32G.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition\x12\x1e\n\x16user_defined_functions\x18\x04 \x03(\t\x12R\n\x11write_disposition\x18\x06 \x01(\x0e\x32\x37.google.cloud.bigquery.datatransfer.v1.WriteDisposition\x1a\xad\x03\n\x0b\x46ieldSchema\x12\x12\n\nfield_name\x18\x01 \x01(\t\x12V\n\x04type\x18\x02 \x01(\x0e\x32H.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.Type\x12\x13\n\x0bis_repeated\x18\x03 \x01(\x08\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12T\n\x06schema\x18\x05 \x01(\x0b\x32\x44.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.RecordSchema"\xb1\x01\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06STRING\x10\x01\x12\x0b\n\x07INTEGER\x10\x02\x12\t\n\x05\x46LOAT\x10\x03\x12\n\n\x06RECORD\x10\x04\x12\t\n\x05\x42YTES\x10\x05\x12\x0b\n\x07\x42OOLEAN\x10\x06\x12\r\n\tTIMESTAMP\x10\x07\x12\x08\n\x04\x44\x41TE\x10\x08\x12\x08\n\x04TIME\x10\t\x12\x0c\n\x08\x44\x41TETIME\x10\n\x12\x0b\n\x07NUMERIC\x10\x0b\x12\r\n\tGEOGRAPHY\x10\x0c\x1a\x63\n\x0cRecordSchema\x12S\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x43.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema\x1a\x91\x06\n\x0fTableDefinition\x12\x10\n\x08table_id\x18\x01 \x01(\t\x12\x13\n\x0bsource_uris\x18\x02 \x03(\t\x12N\n\x06\x66ormat\x18\x03 \x01(\x0e\x32>.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.Format\x12\x17\n\x0fmax_bad_records\x18\x04 \x01(\x05\x12R\n\x08\x65ncoding\x18\x05 \x01(\x0e\x32@.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.Encoding\x12g\n\x0b\x63sv_options\x18\x06 \x01(\x0b\x32R.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions\x12T\n\x06schema\x18\x07 \x01(\x0b\x32\x44.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.RecordSchema\x12\x39\n\x15ignore_unknown_values\x18\n \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x1a\x9f\x02\n\nCsvOptions\x12\x35\n\x0f\x66ield_delimiter\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.StringValue\x12\x39\n\x15\x61llow_quoted_newlines\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x30\n\nquote_char\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.StringValue\x12\x36\n\x11skip_leading_rows\x18\x04 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x35\n\x11\x61llow_jagged_rows\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.BoolValue"~\n\x06\x46ormat\x12\x16\n\x12\x46ORMAT_UNSPECIFIED\x10\x00\x12\x07\n\x03\x43SV\x10\x01\x12\x08\n\x04JSON\x10\x02\x12\x08\n\x04\x41VRO\x10\x03\x12\x0c\n\x08RECORDIO\x10\x04\x12\x0c\n\x08\x43OLUMNIO\x10\x05\x12\r\n\tCAPACITOR\x10\x06\x12\x0b\n\x07PARQUET\x10\x07\x12\x07\n\x03ORC\x10\x08">\n\x08\x45ncoding\x12\x18\n\x14\x45NCODING_UNSPECIFIED\x10\x00\x12\x0e\n\nISO_8859_1\x10\x01\x12\x08\n\x04UTF8\x10\x02"\x95\x01\n\x18UpdateTransferRunRequest\x12H\n\x0ctransfer_run\x18\x01 \x01(\x0b\x32\x32.google.cloud.bigquery.datatransfer.v1.TransferRun\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x80\x01\n\x1dLogTransferRunMessagesRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Q\n\x11transfer_messages\x18\x02 \x03(\x0b\x32\x36.google.cloud.bigquery.datatransfer.v1.TransferMessage"\xab\x01\n\x18StartBigQueryJobsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\rimported_data\x18\x02 \x03(\x0b\x32\x37.google.cloud.bigquery.datatransfer.v1.ImportedDataInfo\x12\x18\n\x10user_credentials\x18\x03 \x01(\x0c\x12\x17\n\x0fmax_parallelism\x18\x08 \x01(\x05" \n\x10\x46inishRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x90\x01\n!CreateDataSourceDefinitionRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12[\n\x16\x64\x61ta_source_definition\x18\x02 \x01(\x0b\x32;.google.cloud.bigquery.datatransfer.v1.DataSourceDefinition"\xb1\x01\n!UpdateDataSourceDefinitionRequest\x12[\n\x16\x64\x61ta_source_definition\x18\x01 \x01(\x0b\x32;.google.cloud.bigquery.datatransfer.v1.DataSourceDefinition\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"1\n!DeleteDataSourceDefinitionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t".\n\x1eGetDataSourceDefinitionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"Y\n ListDataSourceDefinitionsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"\x9a\x01\n!ListDataSourceDefinitionsResponse\x12\\\n\x17\x64\x61ta_source_definitions\x18\x01 \x03(\x0b\x32;.google.cloud.bigquery.datatransfer.v1.DataSourceDefinition\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xcb\x02\n\x14\x44\x61taSourceDefinition\x12\x0c\n\x04name\x18\x15 \x01(\t\x12\x46\n\x0b\x64\x61ta_source\x18\x01 \x01(\x0b\x32\x31.google.cloud.bigquery.datatransfer.v1.DataSource\x12!\n\x19transfer_run_pubsub_topic\x18\r \x01(\t\x12\x32\n\x0frun_time_offset\x18\x10 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rsupport_email\x18\x16 \x01(\t\x12\x17\n\x0fservice_account\x18\x02 \x01(\t\x12\x10\n\x08\x64isabled\x18\x05 \x01(\x08\x12$\n\x1ctransfer_config_pubsub_topic\x18\x0c \x01(\t\x12\x1e\n\x16supported_location_ids\x18\x17 \x03(\t*[\n\x10WriteDisposition\x12!\n\x1dWRITE_DISPOSITION_UNSPECIFIED\x10\x00\x12\x12\n\x0eWRITE_TRUNCATE\x10\x01\x12\x10\n\x0cWRITE_APPEND\x10\x02\x32\x9d\x10\n\x11\x44\x61taSourceService\x12\xe7\x01\n\x11UpdateTransferRun\x12?.google.cloud.bigquery.datatransfer.v1.UpdateTransferRunRequest\x1a\x32.google.cloud.bigquery.datatransfer.v1.TransferRun"]\x82\xd3\xe4\x93\x02W2G/v1/{transfer_run.name=projects/*/locations/*/transferConfigs/*/runs/*}:\x0ctransfer_run\x12\xc9\x01\n\x16LogTransferRunMessages\x12\x44.google.cloud.bigquery.datatransfer.v1.LogTransferRunMessagesRequest\x1a\x16.google.protobuf.Empty"Q\x82\xd3\xe4\x93\x02K"F/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:logMessages:\x01*\x12\xc5\x01\n\x11StartBigQueryJobs\x12?.google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest\x1a\x16.google.protobuf.Empty"W\x82\xd3\xe4\x93\x02Q"L/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:startBigQueryJobs:\x01*\x12\xad\x01\n\tFinishRun\x12\x37.google.cloud.bigquery.datatransfer.v1.FinishRunRequest\x1a\x16.google.protobuf.Empty"O\x82\xd3\xe4\x93\x02I"D/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:finishRun:\x01*\x12\xfe\x01\n\x1a\x43reateDataSourceDefinition\x12H.google.cloud.bigquery.datatransfer.v1.CreateDataSourceDefinitionRequest\x1a;.google.cloud.bigquery.datatransfer.v1.DataSourceDefinition"Y\x82\xd3\xe4\x93\x02S"9/v1/{parent=projects/*/locations/*}/dataSourceDefinitions:\x16\x64\x61ta_source_definition\x12\x95\x02\n\x1aUpdateDataSourceDefinition\x12H.google.cloud.bigquery.datatransfer.v1.UpdateDataSourceDefinitionRequest\x1a;.google.cloud.bigquery.datatransfer.v1.DataSourceDefinition"p\x82\xd3\xe4\x93\x02j2P/v1/{data_source_definition.name=projects/*/locations/*/dataSourceDefinitions/*}:\x16\x64\x61ta_source_definition\x12\xc1\x01\n\x1a\x44\x65leteDataSourceDefinition\x12H.google.cloud.bigquery.datatransfer.v1.DeleteDataSourceDefinitionRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02;*9/v1/{name=projects/*/locations/*/dataSourceDefinitions/*}\x12\xe0\x01\n\x17GetDataSourceDefinition\x12\x45.google.cloud.bigquery.datatransfer.v1.GetDataSourceDefinitionRequest\x1a;.google.cloud.bigquery.datatransfer.v1.DataSourceDefinition"A\x82\xd3\xe4\x93\x02;\x12\x39/v1/{name=projects/*/locations/*/dataSourceDefinitions/*}\x12\xf1\x01\n\x19ListDataSourceDefinitions\x12G.google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsRequest\x1aH.google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1/{parent=projects/*/locations/*}/dataSourceDefinitions\x1a&\xca\x41#bigquerydatatransfer.googleapis.comB\xe1\x01\n)com.google.cloud.bigquery.datatransfer.v1B\x0f\x44\x61taSourceProtoP\x01ZQgoogle.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer\xaa\x02%Google.Cloud.BigQuery.DataTransfer.V1\xca\x02%Google\\Cloud\\BigQuery\\DataTransfer\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+_WRITEDISPOSITION = _descriptor.EnumDescriptor(
+    name="WriteDisposition",
+    full_name="google.cloud.bigquery.datatransfer.v1.WriteDisposition",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="WRITE_DISPOSITION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WRITE_TRUNCATE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WRITE_APPEND", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3766,
+    serialized_end=3857,
+)
+_sym_db.RegisterEnumDescriptor(_WRITEDISPOSITION)
+
+WriteDisposition = enum_type_wrapper.EnumTypeWrapper(_WRITEDISPOSITION)
+WRITE_DISPOSITION_UNSPECIFIED = 0
+WRITE_TRUNCATE = 1
+WRITE_APPEND = 2
+
+
+_IMPORTEDDATAINFO_FIELDSCHEMA_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTEGER", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLOAT", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECORD", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BYTES", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOLEAN", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIMESTAMP", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATE", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIME", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATETIME", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMERIC", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GEOGRAPHY", index=12, number=12, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1007,
+    serialized_end=1184,
+)
+_sym_db.RegisterEnumDescriptor(_IMPORTEDDATAINFO_FIELDSCHEMA_TYPE)
+
+_IMPORTEDDATAINFO_FORMAT = _descriptor.EnumDescriptor(
+    name="Format",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.Format",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FORMAT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CSV", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JSON", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AVRO", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECORDIO", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COLUMNIO", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CAPACITOR", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARQUET", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORC", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2075,
+    serialized_end=2201,
+)
+_sym_db.RegisterEnumDescriptor(_IMPORTEDDATAINFO_FORMAT)
+
+_IMPORTEDDATAINFO_ENCODING = _descriptor.EnumDescriptor(
+    name="Encoding",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.Encoding",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ENCODING_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ISO_8859_1", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF8", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2203,
+    serialized_end=2265,
+)
+_sym_db.RegisterEnumDescriptor(_IMPORTEDDATAINFO_ENCODING)
+
+
+_IMPORTEDDATAINFO_FIELDSCHEMA = _descriptor.Descriptor(
+    name="FieldSchema",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_name",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.field_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_repeated",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.is_repeated",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.description",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schema",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema.schema",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_IMPORTEDDATAINFO_FIELDSCHEMA_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=755,
+    serialized_end=1184,
+)
+
+_IMPORTEDDATAINFO_RECORDSCHEMA = _descriptor.Descriptor(
+    name="RecordSchema",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.RecordSchema",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.RecordSchema.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1186,
+    serialized_end=1285,
+)
+
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS = _descriptor.Descriptor(
+    name="CsvOptions",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_delimiter",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions.field_delimiter",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_quoted_newlines",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions.allow_quoted_newlines",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quote_char",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions.quote_char",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skip_leading_rows",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions.skip_leading_rows",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_jagged_rows",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions.allow_jagged_rows",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1786,
+    serialized_end=2073,
+)
+
+_IMPORTEDDATAINFO_TABLEDEFINITION = _descriptor.Descriptor(
+    name="TableDefinition",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.table_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_uris",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.source_uris",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="format",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.format",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_bad_records",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.max_bad_records",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.encoding",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="csv_options",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.csv_options",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schema",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.schema",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ignore_unknown_values",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.ignore_unknown_values",
+            index=7,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1288,
+    serialized_end=2073,
+)
+
+_IMPORTEDDATAINFO = _descriptor.Descriptor(
+    name="ImportedDataInfo",
+    full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sql",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.sql",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destination_table_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.destination_table_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destination_table_description",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.destination_table_description",
+            index=2,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_defs",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.table_defs",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_defined_functions",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.user_defined_functions",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="write_disposition",
+            full_name="google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.write_disposition",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _IMPORTEDDATAINFO_FIELDSCHEMA,
+        _IMPORTEDDATAINFO_RECORDSCHEMA,
+        _IMPORTEDDATAINFO_TABLEDEFINITION,
+    ],
+    enum_types=[_IMPORTEDDATAINFO_FORMAT, _IMPORTEDDATAINFO_ENCODING],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=443,
+    serialized_end=2265,
+)
+
+
+_UPDATETRANSFERRUNREQUEST = _descriptor.Descriptor(
+    name="UpdateTransferRunRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transfer_run",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferRunRequest.transfer_run",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferRunRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2268,
+    serialized_end=2417,
+)
+
+
+_LOGTRANSFERRUNMESSAGESREQUEST = _descriptor.Descriptor(
+    name="LogTransferRunMessagesRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.LogTransferRunMessagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.LogTransferRunMessagesRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transfer_messages",
+            full_name="google.cloud.bigquery.datatransfer.v1.LogTransferRunMessagesRequest.transfer_messages",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2420,
+    serialized_end=2548,
+)
+
+
+_STARTBIGQUERYJOBSREQUEST = _descriptor.Descriptor(
+    name="StartBigQueryJobsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="imported_data",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest.imported_data",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_credentials",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest.user_credentials",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_parallelism",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest.max_parallelism",
+            index=3,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2551,
+    serialized_end=2722,
+)
+
+
+_FINISHRUNREQUEST = _descriptor.Descriptor(
+    name="FinishRunRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.FinishRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.FinishRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2724,
+    serialized_end=2756,
+)
+
+
+_CREATEDATASOURCEDEFINITIONREQUEST = _descriptor.Descriptor(
+    name="CreateDataSourceDefinitionRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.CreateDataSourceDefinitionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.CreateDataSourceDefinitionRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_source_definition",
+            full_name="google.cloud.bigquery.datatransfer.v1.CreateDataSourceDefinitionRequest.data_source_definition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2759,
+    serialized_end=2903,
+)
+
+
+_UPDATEDATASOURCEDEFINITIONREQUEST = _descriptor.Descriptor(
+    name="UpdateDataSourceDefinitionRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.UpdateDataSourceDefinitionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="data_source_definition",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateDataSourceDefinitionRequest.data_source_definition",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateDataSourceDefinitionRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2906,
+    serialized_end=3083,
+)
+
+
+_DELETEDATASOURCEDEFINITIONREQUEST = _descriptor.Descriptor(
+    name="DeleteDataSourceDefinitionRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.DeleteDataSourceDefinitionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DeleteDataSourceDefinitionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3085,
+    serialized_end=3134,
+)
+
+
+_GETDATASOURCEDEFINITIONREQUEST = _descriptor.Descriptor(
+    name="GetDataSourceDefinitionRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.GetDataSourceDefinitionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.GetDataSourceDefinitionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3136,
+    serialized_end=3182,
+)
+
+
+_LISTDATASOURCEDEFINITIONSREQUEST = _descriptor.Descriptor(
+    name="ListDataSourceDefinitionsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3184,
+    serialized_end=3273,
+)
+
+
+_LISTDATASOURCEDEFINITIONSRESPONSE = _descriptor.Descriptor(
+    name="ListDataSourceDefinitionsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="data_source_definitions",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsResponse.data_source_definitions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3276,
+    serialized_end=3430,
+)
+
+
+_DATASOURCEDEFINITION = _descriptor.Descriptor(
+    name="DataSourceDefinition",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.name",
+            index=0,
+            number=21,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_source",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.data_source",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transfer_run_pubsub_topic",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.transfer_run_pubsub_topic",
+            index=2,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="run_time_offset",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.run_time_offset",
+            index=3,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="support_email",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.support_email",
+            index=4,
+            number=22,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.service_account",
+            index=5,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.disabled",
+            index=6,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transfer_config_pubsub_topic",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.transfer_config_pubsub_topic",
+            index=7,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="supported_location_ids",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceDefinition.supported_location_ids",
+            index=8,
+            number=23,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3433,
+    serialized_end=3764,
+)
+
+_IMPORTEDDATAINFO_FIELDSCHEMA.fields_by_name[
+    "type"
+].enum_type = _IMPORTEDDATAINFO_FIELDSCHEMA_TYPE
+_IMPORTEDDATAINFO_FIELDSCHEMA.fields_by_name[
+    "schema"
+].message_type = _IMPORTEDDATAINFO_RECORDSCHEMA
+_IMPORTEDDATAINFO_FIELDSCHEMA.containing_type = _IMPORTEDDATAINFO
+_IMPORTEDDATAINFO_FIELDSCHEMA_TYPE.containing_type = _IMPORTEDDATAINFO_FIELDSCHEMA
+_IMPORTEDDATAINFO_RECORDSCHEMA.fields_by_name[
+    "fields"
+].message_type = _IMPORTEDDATAINFO_FIELDSCHEMA
+_IMPORTEDDATAINFO_RECORDSCHEMA.containing_type = _IMPORTEDDATAINFO
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS.fields_by_name[
+    "field_delimiter"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._STRINGVALUE
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS.fields_by_name[
+    "allow_quoted_newlines"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS.fields_by_name[
+    "quote_char"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._STRINGVALUE
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS.fields_by_name[
+    "skip_leading_rows"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS.fields_by_name[
+    "allow_jagged_rows"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS.containing_type = (
+    _IMPORTEDDATAINFO_TABLEDEFINITION
+)
+_IMPORTEDDATAINFO_TABLEDEFINITION.fields_by_name[
+    "format"
+].enum_type = _IMPORTEDDATAINFO_FORMAT
+_IMPORTEDDATAINFO_TABLEDEFINITION.fields_by_name[
+    "encoding"
+].enum_type = _IMPORTEDDATAINFO_ENCODING
+_IMPORTEDDATAINFO_TABLEDEFINITION.fields_by_name[
+    "csv_options"
+].message_type = _IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS
+_IMPORTEDDATAINFO_TABLEDEFINITION.fields_by_name[
+    "schema"
+].message_type = _IMPORTEDDATAINFO_RECORDSCHEMA
+_IMPORTEDDATAINFO_TABLEDEFINITION.fields_by_name[
+    "ignore_unknown_values"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_IMPORTEDDATAINFO_TABLEDEFINITION.containing_type = _IMPORTEDDATAINFO
+_IMPORTEDDATAINFO.fields_by_name[
+    "table_defs"
+].message_type = _IMPORTEDDATAINFO_TABLEDEFINITION
+_IMPORTEDDATAINFO.fields_by_name["write_disposition"].enum_type = _WRITEDISPOSITION
+_IMPORTEDDATAINFO_FORMAT.containing_type = _IMPORTEDDATAINFO
+_IMPORTEDDATAINFO_ENCODING.containing_type = _IMPORTEDDATAINFO
+_UPDATETRANSFERRUNREQUEST.fields_by_name[
+    "transfer_run"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERRUN
+)
+_UPDATETRANSFERRUNREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LOGTRANSFERRUNMESSAGESREQUEST.fields_by_name[
+    "transfer_messages"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERMESSAGE
+)
+_STARTBIGQUERYJOBSREQUEST.fields_by_name[
+    "imported_data"
+].message_type = _IMPORTEDDATAINFO
+_CREATEDATASOURCEDEFINITIONREQUEST.fields_by_name[
+    "data_source_definition"
+].message_type = _DATASOURCEDEFINITION
+_UPDATEDATASOURCEDEFINITIONREQUEST.fields_by_name[
+    "data_source_definition"
+].message_type = _DATASOURCEDEFINITION
+_UPDATEDATASOURCEDEFINITIONREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTDATASOURCEDEFINITIONSRESPONSE.fields_by_name[
+    "data_source_definitions"
+].message_type = _DATASOURCEDEFINITION
+_DATASOURCEDEFINITION.fields_by_name[
+    "data_source"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2._DATASOURCE
+)
+_DATASOURCEDEFINITION.fields_by_name[
+    "run_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["ImportedDataInfo"] = _IMPORTEDDATAINFO
+DESCRIPTOR.message_types_by_name["UpdateTransferRunRequest"] = _UPDATETRANSFERRUNREQUEST
+DESCRIPTOR.message_types_by_name[
+    "LogTransferRunMessagesRequest"
+] = _LOGTRANSFERRUNMESSAGESREQUEST
+DESCRIPTOR.message_types_by_name["StartBigQueryJobsRequest"] = _STARTBIGQUERYJOBSREQUEST
+DESCRIPTOR.message_types_by_name["FinishRunRequest"] = _FINISHRUNREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateDataSourceDefinitionRequest"
+] = _CREATEDATASOURCEDEFINITIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateDataSourceDefinitionRequest"
+] = _UPDATEDATASOURCEDEFINITIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteDataSourceDefinitionRequest"
+] = _DELETEDATASOURCEDEFINITIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetDataSourceDefinitionRequest"
+] = _GETDATASOURCEDEFINITIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDataSourceDefinitionsRequest"
+] = _LISTDATASOURCEDEFINITIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDataSourceDefinitionsResponse"
+] = _LISTDATASOURCEDEFINITIONSRESPONSE
+DESCRIPTOR.message_types_by_name["DataSourceDefinition"] = _DATASOURCEDEFINITION
+DESCRIPTOR.enum_types_by_name["WriteDisposition"] = _WRITEDISPOSITION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ImportedDataInfo = _reflection.GeneratedProtocolMessageType(
+    "ImportedDataInfo",
+    (_message.Message,),
+    dict(
+        FieldSchema=_reflection.GeneratedProtocolMessageType(
+            "FieldSchema",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_IMPORTEDDATAINFO_FIELDSCHEMA,
+                __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+                __doc__="""Defines schema of a field in the imported data.
+    
+    
+    Attributes:
+        field_name:
+            Field name. Matches: [A-Za-z\_][A-Za-z\_0-9]{0,127}
+        type:
+            Field type
+        is_repeated:
+            Is field repeated.
+        description:
+            Description for this field.
+        schema:
+            Present iff type == RECORD.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.FieldSchema)
+            ),
+        ),
+        RecordSchema=_reflection.GeneratedProtocolMessageType(
+            "RecordSchema",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_IMPORTEDDATAINFO_RECORDSCHEMA,
+                __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+                __doc__="""Describes schema of the data to be ingested.
+    
+    
+    Attributes:
+        fields:
+            One field per column in the record.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.RecordSchema)
+            ),
+        ),
+        TableDefinition=_reflection.GeneratedProtocolMessageType(
+            "TableDefinition",
+            (_message.Message,),
+            dict(
+                CsvOptions=_reflection.GeneratedProtocolMessageType(
+                    "CsvOptions",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_IMPORTEDDATAINFO_TABLEDEFINITION_CSVOPTIONS,
+                        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+                        __doc__="""CSV specific options.
+      
+      
+      Attributes:
+          field_delimiter:
+              The delimiter. We currently restrict this to U+0001 to U+00FF
+              and apply additional constraints during validation.
+          allow_quoted_newlines:
+              Whether CSV files are allowed to have quoted newlines. If
+              quoted newlines are allowed, we can't split CSV files.
+          quote_char:
+              The quote character. We currently restrict this to U+0000 to
+              U+00FF and apply additional constraints during validation. Set
+              to ':raw-latex:`\0`' to indicate no quote is used.
+          skip_leading_rows:
+              Number of leading rows to skip.
+          allow_jagged_rows:
+              Accept rows that are missing trailing optional columns.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition.CsvOptions)
+                    ),
+                ),
+                DESCRIPTOR=_IMPORTEDDATAINFO_TABLEDEFINITION,
+                __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+                __doc__="""External table definition. These tables can be referenced with 'name' in
+    the query and can be read just like any other table.
+    
+    
+    Attributes:
+        table_id:
+            BigQuery table\_id (required). This will be used to reference
+            this table in the query.
+        source_uris:
+            URIs for the data to be imported. All URIs must be from the
+            same storage system.
+        format:
+            Describes the format of the data in source\_uri.
+        max_bad_records:
+            Specify the maximum number of bad records that can be ignored.
+            If bad records exceed this threshold the query is aborted.
+        encoding:
+            Character encoding of the input when applicable (CSV, JSON).
+            Defaults to UTF8.
+        csv_options:
+            CSV specific options.
+        schema:
+            Optional schema for the data. When not specified for JSON and
+            CSV formats we will try to detect it automatically.
+        ignore_unknown_values:
+            Indicates if extra values that are not represented in the
+            table schema is allowed.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ImportedDataInfo.TableDefinition)
+            ),
+        ),
+        DESCRIPTOR=_IMPORTEDDATAINFO,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Describes data which should be imported.
+  
+  
+  Attributes:
+      sql:
+          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.
+      destination_table_id:
+          Table where results should be written.
+      destination_table_description:
+          The description of a destination table. This can be several
+          sentences or paragraphs describing the table contents in
+          detail.
+      table_defs:
+          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.
+      user_defined_functions:
+          Inline code for User-defined function resources. Ignored when
+          "sql" parameter is empty.
+      write_disposition:
+          Specifies the action if the destination table already exists.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ImportedDataInfo)
+    ),
+)
+_sym_db.RegisterMessage(ImportedDataInfo)
+_sym_db.RegisterMessage(ImportedDataInfo.FieldSchema)
+_sym_db.RegisterMessage(ImportedDataInfo.RecordSchema)
+_sym_db.RegisterMessage(ImportedDataInfo.TableDefinition)
+_sym_db.RegisterMessage(ImportedDataInfo.TableDefinition.CsvOptions)
+
+UpdateTransferRunRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTransferRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETRANSFERRUNREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""A request to update a transfer run.
+  
+  
+  Attributes:
+      transfer_run:
+          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.
+      update_mask:
+          Required list of fields to be updated in this request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.UpdateTransferRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTransferRunRequest)
+
+LogTransferRunMessagesRequest = _reflection.GeneratedProtocolMessageType(
+    "LogTransferRunMessagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOGTRANSFERRUNMESSAGESREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""A request to add transfer status messages to the run.
+  
+  
+  Attributes:
+      name:
+          Name of the resource in the form: "projects/{project\_id}/loca
+          tions/{location\_id}/transferConfigs/{config\_id}/runs/{run\_i
+          d}"
+      transfer_messages:
+          Messages to append.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.LogTransferRunMessagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(LogTransferRunMessagesRequest)
+
+StartBigQueryJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "StartBigQueryJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STARTBIGQUERYJOBSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""A request to start and monitor a BigQuery load job.
+  
+  
+  Attributes:
+      name:
+          Name of the resource in the form: "projects/{project\_id}/loca
+          tions/{location\_id}/transferConfigs/{config\_id}/runs/{run\_i
+          d}"
+      imported_data:
+          Import jobs which should be started and monitored.
+      user_credentials:
+          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.
+      max_parallelism:
+          The number of BQ Jobs that can run in parallel.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.StartBigQueryJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(StartBigQueryJobsRequest)
+
+FinishRunRequest = _reflection.GeneratedProtocolMessageType(
+    "FinishRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINISHRUNREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""A request to finish a run.
+  
+  
+  Attributes:
+      name:
+          Name of the resource in the form: "projects/{project\_id}/loca
+          tions/{location\_id}/transferConfigs/{config\_id}/runs/{run\_i
+          d}"
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.FinishRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(FinishRunRequest)
+
+CreateDataSourceDefinitionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDataSourceDefinitionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDATASOURCEDEFINITIONREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Represents the request of the CreateDataSourceDefinition method.
+  
+  
+  Attributes:
+      parent:
+          The BigQuery project id for which data source definition is
+          associated. Must be in the form:
+          ``projects/{project_id}/locations/{location_id}``
+      data_source_definition:
+          Data source definition.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.CreateDataSourceDefinitionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDataSourceDefinitionRequest)
+
+UpdateDataSourceDefinitionRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDataSourceDefinitionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDATASOURCEDEFINITIONREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Represents the request of the UpdateDataSourceDefinition method.
+  
+  
+  Attributes:
+      data_source_definition:
+          Data source definition.
+      update_mask:
+          Update field mask.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.UpdateDataSourceDefinitionRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDataSourceDefinitionRequest)
+
+DeleteDataSourceDefinitionRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDataSourceDefinitionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDATASOURCEDEFINITIONREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested, for
+          example: ``projects/{project_id}/locations/{location_id}/dataS
+          ourceDefinitions/{data_source_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.DeleteDataSourceDefinitionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDataSourceDefinitionRequest)
+
+GetDataSourceDefinitionRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDataSourceDefinitionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATASOURCEDEFINITIONREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Represents the request of the GetDataSourceDefinition method.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.GetDataSourceDefinitionRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDataSourceDefinitionRequest)
+
+ListDataSourceDefinitionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDataSourceDefinitionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASOURCEDEFINITIONSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Represents the request of the ListDataSourceDefinitions method.
+  
+  
+  Attributes:
+      parent:
+          The BigQuery project id for which data sources should be
+          returned. Must be in the form:
+          ``projects/{project_id}/locations/{location_id}``
+      page_token:
+          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.
+      page_size:
+          Page size. The default page size is the maximum value of 1000
+          results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDataSourceDefinitionsRequest)
+
+ListDataSourceDefinitionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDataSourceDefinitionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASOURCEDEFINITIONSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Returns a list of supported data source definitions.
+  
+  
+  Attributes:
+      data_source_definitions:
+          List of supported data source definitions.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListDataSourceDefinitionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDataSourceDefinitionsResponse)
+
+DataSourceDefinition = _reflection.GeneratedProtocolMessageType(
+    "DataSourceDefinition",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASOURCEDEFINITION,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datasource_pb2",
+        __doc__="""Represents the data source definition.
+  
+  
+  Attributes:
+      name:
+          The resource name of the data source definition. Data source
+          definition names have the form ``projects/{project_id}/locatio
+          ns/{location}/dataSourceDefinitions/{data_source_id}``.
+      data_source:
+          Data source metadata.
+      transfer_run_pubsub_topic:
+          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.
+      run_time_offset:
+          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.
+      support_email:
+          Support e-mail address of the OAuth client's Brand, which
+          contains the consent screen data.
+      service_account:
+          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.
+      disabled:
+          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.
+      transfer_config_pubsub_topic:
+          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.
+      supported_location_ids:
+          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=pro
+          jects/*}/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;
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.DataSourceDefinition)
+    ),
+)
+_sym_db.RegisterMessage(DataSourceDefinition)
+
+
+DESCRIPTOR._options = None
+
+_DATASOURCESERVICE = _descriptor.ServiceDescriptor(
+    name="DataSourceService",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b("\312A#bigquerydatatransfer.googleapis.com"),
+    serialized_start=3860,
+    serialized_end=5937,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="UpdateTransferRun",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.UpdateTransferRun",
+            index=0,
+            containing_service=None,
+            input_type=_UPDATETRANSFERRUNREQUEST,
+            output_type=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERRUN,
+            serialized_options=_b(
+                "\202\323\344\223\002W2G/v1/{transfer_run.name=projects/*/locations/*/transferConfigs/*/runs/*}:\014transfer_run"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LogTransferRunMessages",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.LogTransferRunMessages",
+            index=1,
+            containing_service=None,
+            input_type=_LOGTRANSFERRUNMESSAGESREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:logMessages:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StartBigQueryJobs",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.StartBigQueryJobs",
+            index=2,
+            containing_service=None,
+            input_type=_STARTBIGQUERYJOBSREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002Q"L/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:startBigQueryJobs:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="FinishRun",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.FinishRun",
+            index=3,
+            containing_service=None,
+            input_type=_FINISHRUNREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002I"D/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:finishRun:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDataSourceDefinition",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.CreateDataSourceDefinition",
+            index=4,
+            containing_service=None,
+            input_type=_CREATEDATASOURCEDEFINITIONREQUEST,
+            output_type=_DATASOURCEDEFINITION,
+            serialized_options=_b(
+                '\202\323\344\223\002S"9/v1/{parent=projects/*/locations/*}/dataSourceDefinitions:\026data_source_definition'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDataSourceDefinition",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.UpdateDataSourceDefinition",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATEDATASOURCEDEFINITIONREQUEST,
+            output_type=_DATASOURCEDEFINITION,
+            serialized_options=_b(
+                "\202\323\344\223\002j2P/v1/{data_source_definition.name=projects/*/locations/*/dataSourceDefinitions/*}:\026data_source_definition"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDataSourceDefinition",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.DeleteDataSourceDefinition",
+            index=6,
+            containing_service=None,
+            input_type=_DELETEDATASOURCEDEFINITIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002;*9/v1/{name=projects/*/locations/*/dataSourceDefinitions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDataSourceDefinition",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.GetDataSourceDefinition",
+            index=7,
+            containing_service=None,
+            input_type=_GETDATASOURCEDEFINITIONREQUEST,
+            output_type=_DATASOURCEDEFINITION,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1/{name=projects/*/locations/*/dataSourceDefinitions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDataSourceDefinitions",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceService.ListDataSourceDefinitions",
+            index=8,
+            containing_service=None,
+            input_type=_LISTDATASOURCEDEFINITIONSREQUEST,
+            output_type=_LISTDATASOURCEDEFINITIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1/{parent=projects/*/locations/*}/dataSourceDefinitions"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DATASOURCESERVICE)
+
+DESCRIPTOR.services_by_name["DataSourceService"] = _DATASOURCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource_pb2_grpc.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource_pb2_grpc.py
new file mode 100644
index 000000000000..136c84c3623a
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datasource_pb2_grpc.py
@@ -0,0 +1,229 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigquery.datatransfer_v1.proto import (
+    datasource_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2,
+)
+from google.cloud.bigquery.datatransfer_v1.proto import (
+    transfer_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DataSourceServiceStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.UpdateTransferRun = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/UpdateTransferRun",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.UpdateTransferRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferRun.FromString,
+        )
+        self.LogTransferRunMessages = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/LogTransferRunMessages",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.LogTransferRunMessagesRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.StartBigQueryJobs = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/StartBigQueryJobs",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.StartBigQueryJobsRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.FinishRun = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/FinishRun",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.FinishRunRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateDataSourceDefinition = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/CreateDataSourceDefinition",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.CreateDataSourceDefinitionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DataSourceDefinition.FromString,
+        )
+        self.UpdateDataSourceDefinition = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/UpdateDataSourceDefinition",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.UpdateDataSourceDefinitionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DataSourceDefinition.FromString,
+        )
+        self.DeleteDataSourceDefinition = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/DeleteDataSourceDefinition",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DeleteDataSourceDefinitionRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetDataSourceDefinition = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/GetDataSourceDefinition",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.GetDataSourceDefinitionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DataSourceDefinition.FromString,
+        )
+        self.ListDataSourceDefinitions = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataSourceService/ListDataSourceDefinitions",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.ListDataSourceDefinitionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.ListDataSourceDefinitionsResponse.FromString,
+        )
+
+
+class DataSourceServiceServicer(object):
+    """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.
+  """
+
+    def UpdateTransferRun(self, request, context):
+        """Update a transfer run. If successful, resets
+    data_source.update_deadline_seconds timer.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LogTransferRunMessages(self, request, context):
+        """Log messages for a transfer run. If successful (at least 1 message), resets
+    data_source.update_deadline_seconds timer.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StartBigQueryJobs(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def FinishRun(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDataSourceDefinition(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDataSourceDefinition(self, request, context):
+        """Updates an existing data source definition. If changing
+    supported_location_ids, triggers same effects as mentioned in "Create a
+    data source definition."
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDataSourceDefinition(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDataSourceDefinition(self, request, context):
+        """Retrieves an existing data source definition.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDataSourceDefinitions(self, request, context):
+        """Lists supported data source definitions.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DataSourceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "UpdateTransferRun": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTransferRun,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.UpdateTransferRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferRun.SerializeToString,
+        ),
+        "LogTransferRunMessages": grpc.unary_unary_rpc_method_handler(
+            servicer.LogTransferRunMessages,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.LogTransferRunMessagesRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "StartBigQueryJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.StartBigQueryJobs,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.StartBigQueryJobsRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "FinishRun": grpc.unary_unary_rpc_method_handler(
+            servicer.FinishRun,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.FinishRunRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateDataSourceDefinition": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDataSourceDefinition,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.CreateDataSourceDefinitionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DataSourceDefinition.SerializeToString,
+        ),
+        "UpdateDataSourceDefinition": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDataSourceDefinition,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.UpdateDataSourceDefinitionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DataSourceDefinition.SerializeToString,
+        ),
+        "DeleteDataSourceDefinition": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDataSourceDefinition,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DeleteDataSourceDefinitionRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetDataSourceDefinition": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDataSourceDefinition,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.GetDataSourceDefinitionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.DataSourceDefinition.SerializeToString,
+        ),
+        "ListDataSourceDefinitions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDataSourceDefinitions,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.ListDataSourceDefinitionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datasource__pb2.ListDataSourceDefinitionsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.bigquery.datatransfer.v1.DataSourceService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer.proto b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer.proto
new file mode 100644
index 000000000000..e9a39683494c
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer.proto
@@ -0,0 +1,730 @@
+// 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/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 = "DataTransferProto";
+option java_package = "com.google.cloud.bigquery.datatransfer.v1";
+option php_namespace = "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
+// BigQuery. This service contains methods that are end user exposed. It backs
+// up the frontend.
+service DataTransferService {
+  option (google.api.default_host) = "bigquerydatatransfer.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Retrieves a supported data source and returns its settings,
+  // which can be used for UI rendering.
+  rpc GetDataSource(GetDataSourceRequest) returns (DataSource) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/dataSources/*}"
+      additional_bindings {
+        get: "/v1/{name=projects/*/dataSources/*}"
+      }
+    };
+  }
+
+  // Lists supported data sources and returns their settings,
+  // which can be used for UI rendering.
+  rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/dataSources"
+      additional_bindings {
+        get: "/v1/{parent=projects/*}/dataSources"
+      }
+    };
+  }
+
+  // Creates a new data transfer configuration.
+  rpc CreateTransferConfig(CreateTransferConfigRequest) returns (TransferConfig) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/transferConfigs"
+      body: "transfer_config"
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/transferConfigs"
+        body: "transfer_config"
+      }
+    };
+  }
+
+  // Updates a data transfer configuration.
+  // All fields must be set, even if they are not updated.
+  rpc UpdateTransferConfig(UpdateTransferConfigRequest) returns (TransferConfig) {
+    option (google.api.http) = {
+      patch: "/v1/{transfer_config.name=projects/*/locations/*/transferConfigs/*}"
+      body: "transfer_config"
+      additional_bindings {
+        patch: "/v1/{transfer_config.name=projects/*/transferConfigs/*}"
+        body: "transfer_config"
+      }
+    };
+  }
+
+  // Deletes a data transfer configuration,
+  // including any associated transfer runs and logs.
+  rpc DeleteTransferConfig(DeleteTransferConfigRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/transferConfigs/*}"
+      additional_bindings {
+        delete: "/v1/{name=projects/*/transferConfigs/*}"
+      }
+    };
+  }
+
+  // Returns information about a data transfer config.
+  rpc GetTransferConfig(GetTransferConfigRequest) returns (TransferConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/transferConfigs/*}"
+      additional_bindings {
+        get: "/v1/{name=projects/*/transferConfigs/*}"
+      }
+    };
+  }
+
+  // Returns information about all data transfers in the project.
+  rpc ListTransferConfigs(ListTransferConfigsRequest) returns (ListTransferConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/transferConfigs"
+      additional_bindings {
+        get: "/v1/{parent=projects/*}/transferConfigs"
+      }
+    };
+  }
+
+  // Creates transfer runs for a time range [start_time, end_time].
+  // For each date - or whatever granularity the data source supports - in the
+  // range, one transfer run is created.
+  // Note that runs are created per UTC time in the time range.
+  // DEPRECATED: use StartManualTransferRuns instead.
+  rpc ScheduleTransferRuns(ScheduleTransferRunsRequest) returns (ScheduleTransferRunsResponse) {
+    option deprecated = true;
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/transferConfigs/*}:scheduleRuns"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/transferConfigs/*}:scheduleRuns"
+        body: "*"
+      }
+    };
+  }
+
+  // Start manual transfer runs to be executed now with schedule_time equal to
+  // current time. The transfer runs can be created for a time range where the
+  // run_time is between start_time (inclusive) and end_time (exclusive), or for
+  // a specific run_time.
+  rpc StartManualTransferRuns(StartManualTransferRunsRequest) returns (StartManualTransferRunsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/transferConfigs/*}:startManualRuns"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/transferConfigs/*}:startManualRuns"
+        body: "*"
+      }
+    };
+  }
+
+  // Returns information about the particular transfer run.
+  rpc GetTransferRun(GetTransferRunRequest) returns (TransferRun) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}"
+      additional_bindings {
+        get: "/v1/{name=projects/*/transferConfigs/*/runs/*}"
+      }
+    };
+  }
+
+  // Deletes the specified transfer run.
+  rpc DeleteTransferRun(DeleteTransferRunRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}"
+      additional_bindings {
+        delete: "/v1/{name=projects/*/transferConfigs/*/runs/*}"
+      }
+    };
+  }
+
+  // Returns information about running and completed jobs.
+  rpc ListTransferRuns(ListTransferRunsRequest) returns (ListTransferRunsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/transferConfigs/*}/runs"
+      additional_bindings {
+        get: "/v1/{parent=projects/*/transferConfigs/*}/runs"
+      }
+    };
+  }
+
+  // Returns user facing log messages for the data transfer run.
+  rpc ListTransferLogs(ListTransferLogsRequest) returns (ListTransferLogsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/transferConfigs/*/runs/*}/transferLogs"
+      additional_bindings {
+        get: "/v1/{parent=projects/*/transferConfigs/*/runs/*}/transferLogs"
+      }
+    };
+  }
+
+  // Returns true if valid credentials exist for the given data source and
+  // requesting user.
+  // Some data sources doesn't support service account, so we need to talk to
+  // them on behalf of the end user. This API just checks whether we have OAuth
+  // token for the particular user, which is a pre-requisite before user can
+  // create a transfer config.
+  rpc CheckValidCreds(CheckValidCredsRequest) returns (CheckValidCredsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/dataSources/*}:checkValidCreds"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{name=projects/*/dataSources/*}:checkValidCreds"
+        body: "*"
+      }
+    };
+  }
+}
+
+// Represents a data source parameter with validation rules, so that
+// parameters can be rendered in the UI. These parameters are given to us by
+// supported data sources, and include all needed information for rendering
+// and validation.
+// Thus, whoever uses this api can decide to generate either generic ui,
+// or custom data source specific forms.
+message DataSourceParameter {
+  // Parameter type.
+  enum Type {
+    // Type unspecified.
+    TYPE_UNSPECIFIED = 0;
+
+    // String parameter.
+    STRING = 1;
+
+    // Integer parameter (64-bits).
+    // Will be serialized to json as string.
+    INTEGER = 2;
+
+    // Double precision floating point parameter.
+    DOUBLE = 3;
+
+    // Boolean parameter.
+    BOOLEAN = 4;
+
+    // Deprecated. This field has no effect.
+    RECORD = 5;
+
+    // Page ID for a Google+ Page.
+    PLUS_PAGE = 6;
+  }
+
+  // Parameter identifier.
+  string param_id = 1;
+
+  // Parameter display name in the user interface.
+  string display_name = 2;
+
+  // Parameter description.
+  string description = 3;
+
+  // Parameter type.
+  Type type = 4;
+
+  // Is parameter required.
+  bool required = 5;
+
+  // Deprecated. This field has no effect.
+  bool repeated = 6;
+
+  // Regular expression which can be used for parameter validation.
+  string validation_regex = 7;
+
+  // All possible values for the parameter.
+  repeated string allowed_values = 8;
+
+  // For integer and double values specifies minimum allowed value.
+  google.protobuf.DoubleValue min_value = 9;
+
+  // For integer and double values specifies maxminum allowed value.
+  google.protobuf.DoubleValue max_value = 10;
+
+  // Deprecated. This field has no effect.
+  repeated DataSourceParameter fields = 11;
+
+  // Description of the requirements for this field, in case the user input does
+  // not fulfill the regex pattern or min/max values.
+  string validation_description = 12;
+
+  // URL to a help document to further explain the naming requirements.
+  string validation_help_url = 13;
+
+  // Cannot be changed after initial creation.
+  bool immutable = 14;
+
+  // Deprecated. This field has no effect.
+  bool recurse = 15;
+
+  // If true, it should not be used in new transfers, and it should not be
+  // visible to users.
+  bool deprecated = 20;
+}
+
+// Represents data source metadata. Metadata is sufficient to
+// render UI and request proper OAuth tokens.
+message DataSource {
+  // The type of authorization needed for this data source.
+  enum AuthorizationType {
+    // Type unspecified.
+    AUTHORIZATION_TYPE_UNSPECIFIED = 0;
+
+    // Use OAuth 2 authorization codes that can be exchanged
+    // for a refresh token on the backend.
+    AUTHORIZATION_CODE = 1;
+
+    // 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;
+  }
+
+  // Represents how the data source supports data auto refresh.
+  enum DataRefreshType {
+    // The data source won't support data auto refresh, which is default value.
+    DATA_REFRESH_TYPE_UNSPECIFIED = 0;
+
+    // The data source supports data auto refresh, and runs will be scheduled
+    // for the past few days. Does not allow custom values to be set for each
+    // transfer config.
+    SLIDING_WINDOW = 1;
+
+    // The data source supports data auto refresh, and runs will be scheduled
+    // for the past few days. Allows custom values to be set for each transfer
+    // config.
+    CUSTOM_SLIDING_WINDOW = 2;
+  }
+
+  // Output only. Data source resource name.
+  string name = 1;
+
+  // Data source id.
+  string data_source_id = 2;
+
+  // User friendly data source name.
+  string display_name = 3;
+
+  // User friendly data source description string.
+  string description = 4;
+
+  // Data source client id which should be used to receive refresh token.
+  string client_id = 5;
+
+  // Api auth scopes for which refresh token needs to be obtained. These are
+  // scopes needed by a data source to prepare data and ingest them into
+  // BigQuery, e.g., https://www.googleapis.com/auth/bigquery
+  repeated string scopes = 6;
+
+  // Deprecated. This field has no effect.
+  TransferType transfer_type = 7 [deprecated = true];
+
+  // Deprecated. This field has no effect.
+  bool supports_multiple_transfers = 8 [deprecated = true];
+
+  // The number of seconds to wait for an update from the data source
+  // before the Data Transfer Service marks the transfer as FAILED.
+  int32 update_deadline_seconds = 9;
+
+  // Default data transfer schedule.
+  // Examples of valid schedules include:
+  // `1st,3rd monday of month 15:30`,
+  // `every wed,fri of jan,jun 13:15`, and
+  // `first sunday of quarter 00:00`.
+  string default_schedule = 10;
+
+  // Specifies whether the data source supports a user defined schedule, or
+  // operates on the default schedule.
+  // When set to `true`, user can override default schedule.
+  bool supports_custom_schedule = 11;
+
+  // Data source parameters.
+  repeated DataSourceParameter parameters = 12;
+
+  // Url for the help document for this data source.
+  string help_url = 13;
+
+  // Indicates the type of authorization.
+  AuthorizationType authorization_type = 14;
+
+  // Specifies whether the data source supports automatic data refresh for the
+  // past few days, and how it's supported.
+  // For some data sources, data might not be complete until a few days later,
+  // so it's useful to refresh data automatically.
+  DataRefreshType data_refresh_type = 15;
+
+  // Default data refresh window on days.
+  // Only meaningful when `data_refresh_type` = `SLIDING_WINDOW`.
+  int32 default_data_refresh_window_days = 16;
+
+  // Disables backfilling and manual run scheduling
+  // for the data source.
+  bool manual_runs_disabled = 17;
+
+  // The minimum interval for scheduler to schedule runs.
+  google.protobuf.Duration minimum_schedule_interval = 18;
+}
+
+// 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;
+}
+
+// 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;
+
+  // Pagination token, which can be used to request a specific page
+  // of `ListDataSourcesRequest` list results. For multiple-page
+  // results, `ListDataSourcesResponse` outputs
+  // a `next_page` token, which can be used as the
+  // `page_token` value to request the next page of list results.
+  string page_token = 3;
+
+  // Page size. The default page size is the maximum value of 1000 results.
+  int32 page_size = 4;
+}
+
+// Returns list of supported data sources and their metadata.
+message ListDataSourcesResponse {
+  // List of supported data sources and their transfer settings.
+  repeated DataSource data_sources = 1;
+
+  // Output only. The next-pagination token. For multiple-page list results,
+  // this token can be used as the
+  // `ListDataSourcesRequest.page_token`
+  // to request the next page of list results.
+  string next_page_token = 2;
+}
+
+// A request to create a data transfer configuration. If new credentials are
+// needed for this transfer configuration, an authorization code must be
+// provided. If an authorization code is provided, the transfer configuration
+// will be associated with the user id corresponding to the
+// 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;
+
+  // Optional OAuth2 authorization code to use with this transfer configuration.
+  // This is required if new credentials are needed, as indicated by
+  // `CheckValidCreds`.
+  // In order to obtain authorization_code, please make a
+  // request to
+  // https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
+  //
+  // * client_id should be OAuth client_id of BigQuery DTS API for the given
+  //   data source returned by ListDataSources method.
+  // * data_source_scopes are the scopes returned by ListDataSources method.
+  // * redirect_uri is an optional parameter. If not specified, then
+  //   authorization code is posted to the opener of authorization flow window.
+  //   Otherwise it will be sent to the redirect uri. A special value of
+  //   urn:ietf:wg:oauth:2.0:oob means that authorization code should be
+  //   returned in the title bar of the browser, with the page text prompting
+  //   the user to copy the code and paste it in the application.
+  string authorization_code = 3;
+
+  // Optional version info. If users want to find a very recent access token,
+  // that is, immediately after approving access, users have to set the
+  // version_info claim in the token request. To obtain the version_info, users
+  // must use the "none+gsession" response type. which be return a
+  // version_info back in the authorization response which be be put in a JWT
+  // claim in the token request.
+  string version_info = 5;
+}
+
+// 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;
+
+  // Optional OAuth2 authorization code to use with this transfer configuration.
+  // If it is provided, the transfer configuration will be associated with the
+  // authorizing user.
+  // In order to obtain authorization_code, please make a
+  // request to
+  // https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
+  //
+  // * client_id should be OAuth client_id of BigQuery DTS API for the given
+  //   data source returned by ListDataSources method.
+  // * data_source_scopes are the scopes returned by ListDataSources method.
+  // * redirect_uri is an optional parameter. If not specified, then
+  //   authorization code is posted to the opener of authorization flow window.
+  //   Otherwise it will be sent to the redirect uri. A special value of
+  //   urn:ietf:wg:oauth:2.0:oob means that authorization code should be
+  //   returned in the title bar of the browser, with the page text prompting
+  //   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;
+
+  // Optional version info. If users want to find a very recent access token,
+  // that is, immediately after approving access, users have to set the
+  // version_info claim in the token request. To obtain the version_info, users
+  // must use the "none+gsession" response type. which be return a
+  // version_info back in the authorization response which be be put in a JWT
+  // claim in the token request.
+  string version_info = 5;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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;
+
+  // When specified, only configurations of requested data sources are returned.
+  repeated string data_source_ids = 2;
+
+  // Pagination token, which can be used to request a specific page
+  // of `ListTransfersRequest` list results. For multiple-page
+  // results, `ListTransfersResponse` outputs
+  // a `next_page` token, which can be used as the
+  // `page_token` value to request the next page of list results.
+  string page_token = 3;
+
+  // Page size. The default page size is the maximum value of 1000 results.
+  int32 page_size = 4;
+}
+
+// The returned list of pipelines in the project.
+message ListTransferConfigsResponse {
+  // Output only. The stored pipeline transfer configurations.
+  repeated TransferConfig transfer_configs = 1;
+
+  // 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;
+}
+
+// A request to list data transfer runs. UI can use this method to show/filter
+// specific data transfer runs. The data source can use this method to request
+// all scheduled transfer runs.
+message ListTransferRunsRequest {
+  // Represents which runs should be pulled.
+  enum RunAttempt {
+    // All runs should be returned.
+    RUN_ATTEMPT_UNSPECIFIED = 0;
+
+    // Only latest run per day should be returned.
+    LATEST = 1;
+  }
+
+  // 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;
+
+  // When specified, only transfer runs with requested states are returned.
+  repeated TransferState states = 2;
+
+  // Pagination token, which can be used to request a specific page
+  // of `ListTransferRunsRequest` list results. For multiple-page
+  // results, `ListTransferRunsResponse` outputs
+  // a `next_page` token, which can be used as the
+  // `page_token` value to request the next page of list results.
+  string page_token = 3;
+
+  // Page size. The default page size is the maximum value of 1000 results.
+  int32 page_size = 4;
+
+  // Indicates how run attempts are to be pulled.
+  RunAttempt run_attempt = 5;
+}
+
+// The returned list of pipelines in the project.
+message ListTransferRunsResponse {
+  // Output only. The stored pipeline transfer runs.
+  repeated TransferRun transfer_runs = 1;
+
+  // 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;
+}
+
+// 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;
+
+  // Pagination token, which can be used to request a specific page
+  // of `ListTransferLogsRequest` list results. For multiple-page
+  // results, `ListTransferLogsResponse` outputs
+  // a `next_page` token, which can be used as the
+  // `page_token` value to request the next page of list results.
+  string page_token = 4;
+
+  // Page size. The default page size is the maximum value of 1000 results.
+  int32 page_size = 5;
+
+  // Message types to return. If not populated - INFO, WARNING and ERROR
+  // messages are returned.
+  repeated TransferMessage.MessageSeverity message_types = 6;
+}
+
+// The returned list transfer run messages.
+message ListTransferLogsResponse {
+  // Output only. The stored pipeline transfer messages.
+  repeated TransferMessage transfer_messages = 1;
+
+  // 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;
+}
+
+// A request to determine whether the user has valid credentials. This method
+// is used to limit the number of OAuth popups in the user interface. The
+// user id is inferred from the API call context.
+// If the data source has the Google+ authorization type, this method
+// 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;
+}
+
+// A response indicating whether the credentials exist and are valid.
+message CheckValidCredsResponse {
+  // If set to `true`, the credentials exist and are valid.
+  bool has_valid_creds = 1;
+}
+
+// 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,
+  // `"2017-05-25T00:00:00+00:00"`.
+  google.protobuf.Timestamp start_time = 2;
+
+  // End time of the range of transfer runs. For example,
+  // `"2017-05-30T00:00:00+00:00"`.
+  google.protobuf.Timestamp end_time = 3;
+}
+
+// A response to schedule transfer runs for a time range.
+message ScheduleTransferRunsResponse {
+  // The transfer runs that were scheduled.
+  repeated TransferRun runs = 1;
+}
+
+// A request to start manual transfer runs.
+message StartManualTransferRunsRequest {
+  // A specification for a time range, this will request transfer runs with
+  // run_time between start_time (inclusive) and end_time (exclusive).
+  message TimeRange {
+    // Start time of the range of transfer runs. For example,
+    // `"2017-05-25T00:00:00+00:00"`. The start_time must be strictly less than
+    // the end_time. Creates transfer runs where run_time is in the range betwen
+    // start_time (inclusive) and end_time (exlusive).
+    google.protobuf.Timestamp start_time = 1;
+
+    // End time of the range of transfer runs. For example,
+    // `"2017-05-30T00:00:00+00:00"`. The end_time must not be in the future.
+    // Creates transfer runs where run_time is in the range betwen start_time
+    // (inclusive) and end_time (exlusive).
+    google.protobuf.Timestamp end_time = 2;
+  }
+
+  // Transfer configuration name in the form:
+  // `projects/{project_id}/transferConfigs/{config_id}`.
+  string parent = 1;
+
+  // The requested time specification - this can be a time range or a specific
+  // run_time.
+  oneof time {
+    // Time range for the transfer runs that should be started.
+    TimeRange requested_time_range = 3;
+
+    // Specific run_time for a transfer run to be started. The
+    // requested_run_time must not be in the future.
+    google.protobuf.Timestamp requested_run_time = 4;
+  }
+}
+
+// A response to start manual transfer runs.
+message StartManualTransferRunsResponse {
+  // The transfer runs that were created.
+  repeated TransferRun runs = 1;
+}
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2.py
new file mode 100644
index 000000000000..55338100718e
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2.py
@@ -0,0 +1,3216 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/datatransfer_v1/proto/datatransfer.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigquery_datatransfer_v1.proto import (
+    transfer_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/datatransfer_v1/proto/datatransfer.proto",
+    package="google.cloud.bigquery.datatransfer.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.datatransfer.v1B\021DataTransferProtoP\001ZQgoogle.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer\252\002%Google.Cloud.BigQuery.DataTransfer.V1\312\002%Google\\Cloud\\BigQuery\\DataTransfer\\V1"
+    ),
+    serialized_pb=_b(
+        '\n>google/cloud/bigquery/datatransfer_v1/proto/datatransfer.proto\x12%google.cloud.bigquery.datatransfer.v1\x1a\x1cgoogle/api/annotations.proto\x1a:google/cloud/bigquery/datatransfer_v1/proto/transfer.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/api/client.proto"\x85\x05\n\x13\x44\x61taSourceParameter\x12\x10\n\x08param_id\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12M\n\x04type\x18\x04 \x01(\x0e\x32?.google.cloud.bigquery.datatransfer.v1.DataSourceParameter.Type\x12\x10\n\x08required\x18\x05 \x01(\x08\x12\x10\n\x08repeated\x18\x06 \x01(\x08\x12\x18\n\x10validation_regex\x18\x07 \x01(\t\x12\x16\n\x0e\x61llowed_values\x18\x08 \x03(\t\x12/\n\tmin_value\x18\t \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12/\n\tmax_value\x18\n \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12J\n\x06\x66ields\x18\x0b \x03(\x0b\x32:.google.cloud.bigquery.datatransfer.v1.DataSourceParameter\x12\x1e\n\x16validation_description\x18\x0c \x01(\t\x12\x1b\n\x13validation_help_url\x18\r \x01(\t\x12\x11\n\timmutable\x18\x0e \x01(\x08\x12\x0f\n\x07recurse\x18\x0f \x01(\x08\x12\x12\n\ndeprecated\x18\x14 \x01(\x08"i\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06STRING\x10\x01\x12\x0b\n\x07INTEGER\x10\x02\x12\n\n\x06\x44OUBLE\x10\x03\x12\x0b\n\x07\x42OOLEAN\x10\x04\x12\n\n\x06RECORD\x10\x05\x12\r\n\tPLUS_PAGE\x10\x06"\xd7\x07\n\nDataSource\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x16\n\x0e\x64\x61ta_source_id\x18\x02 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x11\n\tclient_id\x18\x05 \x01(\t\x12\x0e\n\x06scopes\x18\x06 \x03(\t\x12N\n\rtransfer_type\x18\x07 \x01(\x0e\x32\x33.google.cloud.bigquery.datatransfer.v1.TransferTypeB\x02\x18\x01\x12\'\n\x1bsupports_multiple_transfers\x18\x08 \x01(\x08\x42\x02\x18\x01\x12\x1f\n\x17update_deadline_seconds\x18\t \x01(\x05\x12\x18\n\x10\x64\x65\x66\x61ult_schedule\x18\n \x01(\t\x12 \n\x18supports_custom_schedule\x18\x0b \x01(\x08\x12N\n\nparameters\x18\x0c \x03(\x0b\x32:.google.cloud.bigquery.datatransfer.v1.DataSourceParameter\x12\x10\n\x08help_url\x18\r \x01(\t\x12_\n\x12\x61uthorization_type\x18\x0e \x01(\x0e\x32\x43.google.cloud.bigquery.datatransfer.v1.DataSource.AuthorizationType\x12\\\n\x11\x64\x61ta_refresh_type\x18\x0f \x01(\x0e\x32\x41.google.cloud.bigquery.datatransfer.v1.DataSource.DataRefreshType\x12(\n default_data_refresh_window_days\x18\x10 \x01(\x05\x12\x1c\n\x14manual_runs_disabled\x18\x11 \x01(\x08\x12<\n\x19minimum_schedule_interval\x18\x12 \x01(\x0b\x32\x19.google.protobuf.Duration"s\n\x11\x41uthorizationType\x12"\n\x1e\x41UTHORIZATION_TYPE_UNSPECIFIED\x10\x00\x12\x16\n\x12\x41UTHORIZATION_CODE\x10\x01\x12"\n\x1eGOOGLE_PLUS_AUTHORIZATION_CODE\x10\x02"c\n\x0f\x44\x61taRefreshType\x12!\n\x1d\x44\x41TA_REFRESH_TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0eSLIDING_WINDOW\x10\x01\x12\x19\n\x15\x43USTOM_SLIDING_WINDOW\x10\x02"$\n\x14GetDataSourceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x16ListDataSourcesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05"{\n\x17ListDataSourcesResponse\x12G\n\x0c\x64\x61ta_sources\x18\x01 \x03(\x0b\x32\x31.google.cloud.bigquery.datatransfer.v1.DataSource\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xaf\x01\n\x1b\x43reateTransferConfigRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12N\n\x0ftransfer_config\x18\x02 \x01(\x0b\x32\x35.google.cloud.bigquery.datatransfer.v1.TransferConfig\x12\x1a\n\x12\x61uthorization_code\x18\x03 \x01(\t\x12\x14\n\x0cversion_info\x18\x05 \x01(\t"\xd0\x01\n\x1bUpdateTransferConfigRequest\x12N\n\x0ftransfer_config\x18\x01 \x01(\x0b\x32\x35.google.cloud.bigquery.datatransfer.v1.TransferConfig\x12\x1a\n\x12\x61uthorization_code\x18\x03 \x01(\t\x12/\n\x0bupdate_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x14\n\x0cversion_info\x18\x05 \x01(\t"(\n\x18GetTransferConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"+\n\x1b\x44\x65leteTransferConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"%\n\x15GetTransferRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"(\n\x18\x44\x65leteTransferRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"l\n\x1aListTransferConfigsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x17\n\x0f\x64\x61ta_source_ids\x18\x02 \x03(\t\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05"\x87\x01\n\x1bListTransferConfigsResponse\x12O\n\x10transfer_configs\x18\x01 \x03(\x0b\x32\x35.google.cloud.bigquery.datatransfer.v1.TransferConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xad\x02\n\x17ListTransferRunsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x44\n\x06states\x18\x02 \x03(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferState\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12^\n\x0brun_attempt\x18\x05 \x01(\x0e\x32I.google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.RunAttempt"5\n\nRunAttempt\x12\x1b\n\x17RUN_ATTEMPT_UNSPECIFIED\x10\x00\x12\n\n\x06LATEST\x10\x01"~\n\x18ListTransferRunsResponse\x12I\n\rtransfer_runs\x18\x01 \x03(\x0b\x32\x32.google.cloud.bigquery.datatransfer.v1.TransferRun\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xaf\x01\n\x17ListTransferLogsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x11\n\tpage_size\x18\x05 \x01(\x05\x12]\n\rmessage_types\x18\x06 \x03(\x0e\x32\x46.google.cloud.bigquery.datatransfer.v1.TransferMessage.MessageSeverity"\x86\x01\n\x18ListTransferLogsResponse\x12Q\n\x11transfer_messages\x18\x01 \x03(\x0b\x32\x36.google.cloud.bigquery.datatransfer.v1.TransferMessage\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"&\n\x16\x43heckValidCredsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"2\n\x17\x43heckValidCredsResponse\x12\x17\n\x0fhas_valid_creds\x18\x01 \x01(\x08"\x8b\x01\n\x1bScheduleTransferRunsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"`\n\x1cScheduleTransferRunsResponse\x12@\n\x04runs\x18\x01 \x03(\x0b\x32\x32.google.cloud.bigquery.datatransfer.v1.TransferRun"\xce\x02\n\x1eStartManualTransferRunsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12o\n\x14requested_time_range\x18\x03 \x01(\x0b\x32O.google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRangeH\x00\x12\x38\n\x12requested_run_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x1ai\n\tTimeRange\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\n\x04time"c\n\x1fStartManualTransferRunsResponse\x12@\n\x04runs\x18\x01 \x03(\x0b\x32\x32.google.cloud.bigquery.datatransfer.v1.TransferRun2\xa1\x1e\n\x13\x44\x61taTransferService\x12\xdf\x01\n\rGetDataSource\x12;.google.cloud.bigquery.datatransfer.v1.GetDataSourceRequest\x1a\x31.google.cloud.bigquery.datatransfer.v1.DataSource"^\x82\xd3\xe4\x93\x02X\x12//v1/{name=projects/*/locations/*/dataSources/*}Z%\x12#/v1/{name=projects/*/dataSources/*}\x12\xf0\x01\n\x0fListDataSources\x12=.google.cloud.bigquery.datatransfer.v1.ListDataSourcesRequest\x1a>.google.cloud.bigquery.datatransfer.v1.ListDataSourcesResponse"^\x82\xd3\xe4\x93\x02X\x12//v1/{parent=projects/*/locations/*}/dataSourcesZ%\x12#/v1/{parent=projects/*}/dataSources\x12\x9d\x02\n\x14\x43reateTransferConfig\x12\x42.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest\x1a\x35.google.cloud.bigquery.datatransfer.v1.TransferConfig"\x89\x01\x82\xd3\xe4\x93\x02\x82\x01"3/v1/{parent=projects/*/locations/*}/transferConfigs:\x0ftransfer_configZ:"\'/v1/{parent=projects/*}/transferConfigs:\x0ftransfer_config\x12\xbd\x02\n\x14UpdateTransferConfig\x12\x42.google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest\x1a\x35.google.cloud.bigquery.datatransfer.v1.TransferConfig"\xa9\x01\x82\xd3\xe4\x93\x02\xa2\x01\x32\x43/v1/{transfer_config.name=projects/*/locations/*/transferConfigs/*}:\x0ftransfer_configZJ27/v1/{transfer_config.name=projects/*/transferConfigs/*}:\x0ftransfer_config\x12\xda\x01\n\x14\x44\x65leteTransferConfig\x12\x42.google.cloud.bigquery.datatransfer.v1.DeleteTransferConfigRequest\x1a\x16.google.protobuf.Empty"f\x82\xd3\xe4\x93\x02`*3/v1/{name=projects/*/locations/*/transferConfigs/*}Z)*\'/v1/{name=projects/*/transferConfigs/*}\x12\xf3\x01\n\x11GetTransferConfig\x12?.google.cloud.bigquery.datatransfer.v1.GetTransferConfigRequest\x1a\x35.google.cloud.bigquery.datatransfer.v1.TransferConfig"f\x82\xd3\xe4\x93\x02`\x12\x33/v1/{name=projects/*/locations/*/transferConfigs/*}Z)\x12\'/v1/{name=projects/*/transferConfigs/*}\x12\x84\x02\n\x13ListTransferConfigs\x12\x41.google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest\x1a\x42.google.cloud.bigquery.datatransfer.v1.ListTransferConfigsResponse"f\x82\xd3\xe4\x93\x02`\x12\x33/v1/{parent=projects/*/locations/*}/transferConfigsZ)\x12\'/v1/{parent=projects/*}/transferConfigs\x12\xb0\x02\n\x14ScheduleTransferRuns\x12\x42.google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest\x1a\x43.google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsResponse"\x8e\x01\x88\x02\x01\x82\xd3\xe4\x93\x02\x84\x01"B/v1/{parent=projects/*/locations/*/transferConfigs/*}:scheduleRuns:\x01*Z;"6/v1/{parent=projects/*/transferConfigs/*}:scheduleRuns:\x01*\x12\xbc\x02\n\x17StartManualTransferRuns\x12\x45.google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest\x1a\x46.google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsResponse"\x91\x01\x82\xd3\xe4\x93\x02\x8a\x01"E/v1/{parent=projects/*/locations/*/transferConfigs/*}:startManualRuns:\x01*Z>"9/v1/{parent=projects/*/transferConfigs/*}:startManualRuns:\x01*\x12\xf8\x01\n\x0eGetTransferRun\x12<.google.cloud.bigquery.datatransfer.v1.GetTransferRunRequest\x1a\x32.google.cloud.bigquery.datatransfer.v1.TransferRun"t\x82\xd3\xe4\x93\x02n\x12:/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}Z0\x12./v1/{name=projects/*/transferConfigs/*/runs/*}\x12\xe2\x01\n\x11\x44\x65leteTransferRun\x12?.google.cloud.bigquery.datatransfer.v1.DeleteTransferRunRequest\x1a\x16.google.protobuf.Empty"t\x82\xd3\xe4\x93\x02n*:/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}Z0*./v1/{name=projects/*/transferConfigs/*/runs/*}\x12\x89\x02\n\x10ListTransferRuns\x12>.google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest\x1a?.google.cloud.bigquery.datatransfer.v1.ListTransferRunsResponse"t\x82\xd3\xe4\x93\x02n\x12:/v1/{parent=projects/*/locations/*/transferConfigs/*}/runsZ0\x12./v1/{parent=projects/*/transferConfigs/*}/runs\x12\xa9\x02\n\x10ListTransferLogs\x12>.google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest\x1a?.google.cloud.bigquery.datatransfer.v1.ListTransferLogsResponse"\x93\x01\x82\xd3\xe4\x93\x02\x8c\x01\x12I/v1/{parent=projects/*/locations/*/transferConfigs/*/runs/*}/transferLogsZ?\x12=/v1/{parent=projects/*/transferConfigs/*/runs/*}/transferLogs\x12\x97\x02\n\x0f\x43heckValidCreds\x12=.google.cloud.bigquery.datatransfer.v1.CheckValidCredsRequest\x1a>.google.cloud.bigquery.datatransfer.v1.CheckValidCredsResponse"\x84\x01\x82\xd3\xe4\x93\x02~"?/v1/{name=projects/*/locations/*/dataSources/*}:checkValidCreds:\x01*Z8"3/v1/{name=projects/*/dataSources/*}:checkValidCreds:\x01*\x1aW\xca\x41#bigquerydatatransfer.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xe3\x01\n)com.google.cloud.bigquery.datatransfer.v1B\x11\x44\x61taTransferProtoP\x01ZQgoogle.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer\xaa\x02%Google.Cloud.BigQuery.DataTransfer.V1\xca\x02%Google\\Cloud\\BigQuery\\DataTransfer\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DATASOURCEPARAMETER_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTEGER", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOUBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOLEAN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECORD", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLUS_PAGE", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=921,
+    serialized_end=1026,
+)
+_sym_db.RegisterEnumDescriptor(_DATASOURCEPARAMETER_TYPE)
+
+_DATASOURCE_AUTHORIZATIONTYPE = _descriptor.EnumDescriptor(
+    name="AuthorizationType",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSource.AuthorizationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="AUTHORIZATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTHORIZATION_CODE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GOOGLE_PLUS_AUTHORIZATION_CODE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1796,
+    serialized_end=1911,
+)
+_sym_db.RegisterEnumDescriptor(_DATASOURCE_AUTHORIZATIONTYPE)
+
+_DATASOURCE_DATAREFRESHTYPE = _descriptor.EnumDescriptor(
+    name="DataRefreshType",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSource.DataRefreshType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_REFRESH_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SLIDING_WINDOW", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_SLIDING_WINDOW",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1913,
+    serialized_end=2012,
+)
+_sym_db.RegisterEnumDescriptor(_DATASOURCE_DATAREFRESHTYPE)
+
+_LISTTRANSFERRUNSREQUEST_RUNATTEMPT = _descriptor.EnumDescriptor(
+    name="RunAttempt",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.RunAttempt",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RUN_ATTEMPT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LATEST", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3312,
+    serialized_end=3365,
+)
+_sym_db.RegisterEnumDescriptor(_LISTTRANSFERRUNSREQUEST_RUNATTEMPT)
+
+
+_DATASOURCEPARAMETER = _descriptor.Descriptor(
+    name="DataSourceParameter",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="param_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.param_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="required",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.required",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="repeated",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.repeated",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validation_regex",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.validation_regex",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allowed_values",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.allowed_values",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_value",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.min_value",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_value",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.max_value",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.fields",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validation_description",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.validation_description",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validation_help_url",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.validation_help_url",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="immutable",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.immutable",
+            index=13,
+            number=14,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recurse",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.recurse",
+            index=14,
+            number=15,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deprecated",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSourceParameter.deprecated",
+            index=15,
+            number=20,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DATASOURCEPARAMETER_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=381,
+    serialized_end=1026,
+)
+
+
+_DATASOURCE = _descriptor.Descriptor(
+    name="DataSource",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_source_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.data_source_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.display_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.description",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.client_id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scopes",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.scopes",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transfer_type",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.transfer_type",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="supports_multiple_transfers",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.supports_multiple_transfers",
+            index=7,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_deadline_seconds",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.update_deadline_seconds",
+            index=8,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="default_schedule",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.default_schedule",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="supports_custom_schedule",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.supports_custom_schedule",
+            index=10,
+            number=11,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.parameters",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="help_url",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.help_url",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authorization_type",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.authorization_type",
+            index=13,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_refresh_type",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.data_refresh_type",
+            index=14,
+            number=15,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="default_data_refresh_window_days",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.default_data_refresh_window_days",
+            index=15,
+            number=16,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="manual_runs_disabled",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.manual_runs_disabled",
+            index=16,
+            number=17,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="minimum_schedule_interval",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataSource.minimum_schedule_interval",
+            index=17,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DATASOURCE_AUTHORIZATIONTYPE, _DATASOURCE_DATAREFRESHTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1029,
+    serialized_end=2012,
+)
+
+
+_GETDATASOURCEREQUEST = _descriptor.Descriptor(
+    name="GetDataSourceRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.GetDataSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.GetDataSourceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2014,
+    serialized_end=2050,
+)
+
+
+_LISTDATASOURCESREQUEST = _descriptor.Descriptor(
+    name="ListDataSourcesRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesRequest.page_token",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesRequest.page_size",
+            index=2,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2052,
+    serialized_end=2131,
+)
+
+
+_LISTDATASOURCESRESPONSE = _descriptor.Descriptor(
+    name="ListDataSourcesResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="data_sources",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesResponse.data_sources",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListDataSourcesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2133,
+    serialized_end=2256,
+)
+
+
+_CREATETRANSFERCONFIGREQUEST = _descriptor.Descriptor(
+    name="CreateTransferConfigRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transfer_config",
+            full_name="google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest.transfer_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authorization_code",
+            full_name="google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest.authorization_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version_info",
+            full_name="google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest.version_info",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2259,
+    serialized_end=2434,
+)
+
+
+_UPDATETRANSFERCONFIGREQUEST = _descriptor.Descriptor(
+    name="UpdateTransferConfigRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transfer_config",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest.transfer_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authorization_code",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest.authorization_code",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest.update_mask",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version_info",
+            full_name="google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest.version_info",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2437,
+    serialized_end=2645,
+)
+
+
+_GETTRANSFERCONFIGREQUEST = _descriptor.Descriptor(
+    name="GetTransferConfigRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.GetTransferConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.GetTransferConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2647,
+    serialized_end=2687,
+)
+
+
+_DELETETRANSFERCONFIGREQUEST = _descriptor.Descriptor(
+    name="DeleteTransferConfigRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.DeleteTransferConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DeleteTransferConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2689,
+    serialized_end=2732,
+)
+
+
+_GETTRANSFERRUNREQUEST = _descriptor.Descriptor(
+    name="GetTransferRunRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.GetTransferRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.GetTransferRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2734,
+    serialized_end=2771,
+)
+
+
+_DELETETRANSFERRUNREQUEST = _descriptor.Descriptor(
+    name="DeleteTransferRunRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.DeleteTransferRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.DeleteTransferRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2773,
+    serialized_end=2813,
+)
+
+
+_LISTTRANSFERCONFIGSREQUEST = _descriptor.Descriptor(
+    name="ListTransferConfigsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_source_ids",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest.data_source_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2815,
+    serialized_end=2923,
+)
+
+
+_LISTTRANSFERCONFIGSRESPONSE = _descriptor.Descriptor(
+    name="ListTransferConfigsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transfer_configs",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsResponse.transfer_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferConfigsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2926,
+    serialized_end=3061,
+)
+
+
+_LISTTRANSFERRUNSREQUEST = _descriptor.Descriptor(
+    name="ListTransferRunsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="states",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.states",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="run_attempt",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest.run_attempt",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTTRANSFERRUNSREQUEST_RUNATTEMPT],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3064,
+    serialized_end=3365,
+)
+
+
+_LISTTRANSFERRUNSRESPONSE = _descriptor.Descriptor(
+    name="ListTransferRunsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transfer_runs",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsResponse.transfer_runs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferRunsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3367,
+    serialized_end=3493,
+)
+
+
+_LISTTRANSFERLOGSREQUEST = _descriptor.Descriptor(
+    name="ListTransferLogsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest.page_token",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest.page_size",
+            index=2,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message_types",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest.message_types",
+            index=3,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3496,
+    serialized_end=3671,
+)
+
+
+_LISTTRANSFERLOGSRESPONSE = _descriptor.Descriptor(
+    name="ListTransferLogsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transfer_messages",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsResponse.transfer_messages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.bigquery.datatransfer.v1.ListTransferLogsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3674,
+    serialized_end=3808,
+)
+
+
+_CHECKVALIDCREDSREQUEST = _descriptor.Descriptor(
+    name="CheckValidCredsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.CheckValidCredsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.CheckValidCredsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3810,
+    serialized_end=3848,
+)
+
+
+_CHECKVALIDCREDSRESPONSE = _descriptor.Descriptor(
+    name="CheckValidCredsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.CheckValidCredsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="has_valid_creds",
+            full_name="google.cloud.bigquery.datatransfer.v1.CheckValidCredsResponse.has_valid_creds",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3850,
+    serialized_end=3900,
+)
+
+
+_SCHEDULETRANSFERRUNSREQUEST = _descriptor.Descriptor(
+    name="ScheduleTransferRunsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest.start_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest.end_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3903,
+    serialized_end=4042,
+)
+
+
+_SCHEDULETRANSFERRUNSRESPONSE = _descriptor.Descriptor(
+    name="ScheduleTransferRunsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="runs",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsResponse.runs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4044,
+    serialized_end=4140,
+)
+
+
+_STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE = _descriptor.Descriptor(
+    name="TimeRange",
+    full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4364,
+    serialized_end=4469,
+)
+
+_STARTMANUALTRANSFERRUNSREQUEST = _descriptor.Descriptor(
+    name="StartManualTransferRunsRequest",
+    full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="requested_time_range",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.requested_time_range",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="requested_run_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.requested_run_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="time",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.time",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=4143,
+    serialized_end=4477,
+)
+
+
+_STARTMANUALTRANSFERRUNSRESPONSE = _descriptor.Descriptor(
+    name="StartManualTransferRunsResponse",
+    full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="runs",
+            full_name="google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsResponse.runs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4479,
+    serialized_end=4578,
+)
+
+_DATASOURCEPARAMETER.fields_by_name["type"].enum_type = _DATASOURCEPARAMETER_TYPE
+_DATASOURCEPARAMETER.fields_by_name[
+    "min_value"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_DATASOURCEPARAMETER.fields_by_name[
+    "max_value"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_DATASOURCEPARAMETER.fields_by_name["fields"].message_type = _DATASOURCEPARAMETER
+_DATASOURCEPARAMETER_TYPE.containing_type = _DATASOURCEPARAMETER
+_DATASOURCE.fields_by_name[
+    "transfer_type"
+].enum_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERTYPE
+)
+_DATASOURCE.fields_by_name["parameters"].message_type = _DATASOURCEPARAMETER
+_DATASOURCE.fields_by_name[
+    "authorization_type"
+].enum_type = _DATASOURCE_AUTHORIZATIONTYPE
+_DATASOURCE.fields_by_name["data_refresh_type"].enum_type = _DATASOURCE_DATAREFRESHTYPE
+_DATASOURCE.fields_by_name[
+    "minimum_schedule_interval"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_DATASOURCE_AUTHORIZATIONTYPE.containing_type = _DATASOURCE
+_DATASOURCE_DATAREFRESHTYPE.containing_type = _DATASOURCE
+_LISTDATASOURCESRESPONSE.fields_by_name["data_sources"].message_type = _DATASOURCE
+_CREATETRANSFERCONFIGREQUEST.fields_by_name[
+    "transfer_config"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERCONFIG
+)
+_UPDATETRANSFERCONFIGREQUEST.fields_by_name[
+    "transfer_config"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERCONFIG
+)
+_UPDATETRANSFERCONFIGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTRANSFERCONFIGSRESPONSE.fields_by_name[
+    "transfer_configs"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERCONFIG
+)
+_LISTTRANSFERRUNSREQUEST.fields_by_name[
+    "states"
+].enum_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERSTATE
+)
+_LISTTRANSFERRUNSREQUEST.fields_by_name[
+    "run_attempt"
+].enum_type = _LISTTRANSFERRUNSREQUEST_RUNATTEMPT
+_LISTTRANSFERRUNSREQUEST_RUNATTEMPT.containing_type = _LISTTRANSFERRUNSREQUEST
+_LISTTRANSFERRUNSRESPONSE.fields_by_name[
+    "transfer_runs"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERRUN
+)
+_LISTTRANSFERLOGSREQUEST.fields_by_name[
+    "message_types"
+].enum_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERMESSAGE_MESSAGESEVERITY
+)
+_LISTTRANSFERLOGSRESPONSE.fields_by_name[
+    "transfer_messages"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERMESSAGE
+)
+_SCHEDULETRANSFERRUNSREQUEST.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCHEDULETRANSFERRUNSREQUEST.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCHEDULETRANSFERRUNSRESPONSE.fields_by_name[
+    "runs"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERRUN
+)
+_STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE.containing_type = (
+    _STARTMANUALTRANSFERRUNSREQUEST
+)
+_STARTMANUALTRANSFERRUNSREQUEST.fields_by_name[
+    "requested_time_range"
+].message_type = _STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE
+_STARTMANUALTRANSFERRUNSREQUEST.fields_by_name[
+    "requested_run_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STARTMANUALTRANSFERRUNSREQUEST.oneofs_by_name["time"].fields.append(
+    _STARTMANUALTRANSFERRUNSREQUEST.fields_by_name["requested_time_range"]
+)
+_STARTMANUALTRANSFERRUNSREQUEST.fields_by_name[
+    "requested_time_range"
+].containing_oneof = _STARTMANUALTRANSFERRUNSREQUEST.oneofs_by_name["time"]
+_STARTMANUALTRANSFERRUNSREQUEST.oneofs_by_name["time"].fields.append(
+    _STARTMANUALTRANSFERRUNSREQUEST.fields_by_name["requested_run_time"]
+)
+_STARTMANUALTRANSFERRUNSREQUEST.fields_by_name[
+    "requested_run_time"
+].containing_oneof = _STARTMANUALTRANSFERRUNSREQUEST.oneofs_by_name["time"]
+_STARTMANUALTRANSFERRUNSRESPONSE.fields_by_name[
+    "runs"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERRUN
+)
+DESCRIPTOR.message_types_by_name["DataSourceParameter"] = _DATASOURCEPARAMETER
+DESCRIPTOR.message_types_by_name["DataSource"] = _DATASOURCE
+DESCRIPTOR.message_types_by_name["GetDataSourceRequest"] = _GETDATASOURCEREQUEST
+DESCRIPTOR.message_types_by_name["ListDataSourcesRequest"] = _LISTDATASOURCESREQUEST
+DESCRIPTOR.message_types_by_name["ListDataSourcesResponse"] = _LISTDATASOURCESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "CreateTransferConfigRequest"
+] = _CREATETRANSFERCONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateTransferConfigRequest"
+] = _UPDATETRANSFERCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["GetTransferConfigRequest"] = _GETTRANSFERCONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteTransferConfigRequest"
+] = _DELETETRANSFERCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["GetTransferRunRequest"] = _GETTRANSFERRUNREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTransferRunRequest"] = _DELETETRANSFERRUNREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListTransferConfigsRequest"
+] = _LISTTRANSFERCONFIGSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListTransferConfigsResponse"
+] = _LISTTRANSFERCONFIGSRESPONSE
+DESCRIPTOR.message_types_by_name["ListTransferRunsRequest"] = _LISTTRANSFERRUNSREQUEST
+DESCRIPTOR.message_types_by_name["ListTransferRunsResponse"] = _LISTTRANSFERRUNSRESPONSE
+DESCRIPTOR.message_types_by_name["ListTransferLogsRequest"] = _LISTTRANSFERLOGSREQUEST
+DESCRIPTOR.message_types_by_name["ListTransferLogsResponse"] = _LISTTRANSFERLOGSRESPONSE
+DESCRIPTOR.message_types_by_name["CheckValidCredsRequest"] = _CHECKVALIDCREDSREQUEST
+DESCRIPTOR.message_types_by_name["CheckValidCredsResponse"] = _CHECKVALIDCREDSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ScheduleTransferRunsRequest"
+] = _SCHEDULETRANSFERRUNSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ScheduleTransferRunsResponse"
+] = _SCHEDULETRANSFERRUNSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "StartManualTransferRunsRequest"
+] = _STARTMANUALTRANSFERRUNSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "StartManualTransferRunsResponse"
+] = _STARTMANUALTRANSFERRUNSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DataSourceParameter = _reflection.GeneratedProtocolMessageType(
+    "DataSourceParameter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASOURCEPARAMETER,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""Represents a data source parameter with validation rules, so that
+  parameters can be rendered in the UI. These parameters are given to us
+  by supported data sources, and include all needed information for
+  rendering and validation. Thus, whoever uses this api can decide to
+  generate either generic ui, or custom data source specific forms.
+  
+  
+  Attributes:
+      param_id:
+          Parameter identifier.
+      display_name:
+          Parameter display name in the user interface.
+      description:
+          Parameter description.
+      type:
+          Parameter type.
+      required:
+          Is parameter required.
+      repeated:
+          Deprecated. This field has no effect.
+      validation_regex:
+          Regular expression which can be used for parameter validation.
+      allowed_values:
+          All possible values for the parameter.
+      min_value:
+          For integer and double values specifies minimum allowed value.
+      max_value:
+          For integer and double values specifies maxminum allowed
+          value.
+      fields:
+          Deprecated. This field has no effect.
+      validation_description:
+          Description of the requirements for this field, in case the
+          user input does not fulfill the regex pattern or min/max
+          values.
+      validation_help_url:
+          URL to a help document to further explain the naming
+          requirements.
+      immutable:
+          Cannot be changed after initial creation.
+      recurse:
+          Deprecated. This field has no effect.
+      deprecated:
+          If true, it should not be used in new transfers, and it should
+          not be visible to users.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.DataSourceParameter)
+    ),
+)
+_sym_db.RegisterMessage(DataSourceParameter)
+
+DataSource = _reflection.GeneratedProtocolMessageType(
+    "DataSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASOURCE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""Represents data source metadata. Metadata is sufficient to render UI and
+  request proper OAuth tokens.
+  
+  
+  Attributes:
+      name:
+          Output only. Data source resource name.
+      data_source_id:
+          Data source id.
+      display_name:
+          User friendly data source name.
+      description:
+          User friendly data source description string.
+      client_id:
+          Data source client id which should be used to receive refresh
+          token.
+      scopes:
+          Api auth scopes for which refresh token needs to be obtained.
+          These are scopes needed by a data source to prepare data and
+          ingest them into BigQuery, e.g.,
+          https://www.googleapis.com/auth/bigquery
+      transfer_type:
+          Deprecated. This field has no effect.
+      supports_multiple_transfers:
+          Deprecated. This field has no effect.
+      update_deadline_seconds:
+          The number of seconds to wait for an update from the data
+          source before the Data Transfer Service marks the transfer as
+          FAILED.
+      default_schedule:
+          Default data transfer schedule. Examples of valid schedules
+          include: ``1st,3rd monday of month 15:30``, ``every wed,fri of
+          jan,jun 13:15``, and ``first sunday of quarter 00:00``.
+      supports_custom_schedule:
+          Specifies whether the data source supports a user defined
+          schedule, or operates on the default schedule. When set to
+          ``true``, user can override default schedule.
+      parameters:
+          Data source parameters.
+      help_url:
+          Url for the help document for this data source.
+      authorization_type:
+          Indicates the type of authorization.
+      data_refresh_type:
+          Specifies whether the data source supports automatic data
+          refresh for the past few days, and how it's supported. For
+          some data sources, data might not be complete until a few days
+          later, so it's useful to refresh data automatically.
+      default_data_refresh_window_days:
+          Default data refresh window on days. Only meaningful when
+          ``data_refresh_type`` = ``SLIDING_WINDOW``.
+      manual_runs_disabled:
+          Disables backfilling and manual run scheduling for the data
+          source.
+      minimum_schedule_interval:
+          The minimum interval for scheduler to schedule runs.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.DataSource)
+    ),
+)
+_sym_db.RegisterMessage(DataSource)
+
+GetDataSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDataSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATASOURCEREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to get data source info.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested, for
+          example:
+          ``projects/{project_id}/dataSources/{data_source_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.GetDataSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDataSourceRequest)
+
+ListDataSourcesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDataSourcesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASOURCESREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""Request to list supported data sources and their data transfer settings.
+  
+  
+  Attributes:
+      parent:
+          The BigQuery project id for which data sources should be
+          returned. Must be in the form: ``projects/{project_id}``
+      page_token:
+          Pagination token, which can be used to request a specific page
+          of ``ListDataSourcesRequest`` list results. For multiple-page
+          results, ``ListDataSourcesResponse`` outputs a ``next_page``
+          token, which can be used as the ``page_token`` value to
+          request the next page of list results.
+      page_size:
+          Page size. The default page size is the maximum value of 1000
+          results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListDataSourcesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDataSourcesRequest)
+
+ListDataSourcesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDataSourcesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASOURCESRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""Returns list of supported data sources and their metadata.
+  
+  
+  Attributes:
+      data_sources:
+          List of supported data sources and their transfer settings.
+      next_page_token:
+          Output only. The next-pagination token. For multiple-page list
+          results, this token can be used as the
+          ``ListDataSourcesRequest.page_token`` to request the next page
+          of list results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListDataSourcesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDataSourcesResponse)
+
+CreateTransferConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTransferConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETRANSFERCONFIGREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to create a data transfer configuration. If new credentials
+  are needed for this transfer configuration, an authorization code must
+  be provided. If an authorization code is provided, the transfer
+  configuration will be associated with the user id corresponding to the
+  authorization code. Otherwise, the transfer configuration will be
+  associated with the calling user.
+  
+  
+  Attributes:
+      parent:
+          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.
+      transfer_config:
+          Data transfer configuration to create.
+      authorization_code:
+          Optional OAuth2 authorization code to use with this transfer
+          configuration. This is required if new credentials are needed,
+          as indicated by ``CheckValidCreds``. In order to obtain
+          authorization\_code, please make a request to https://www.gsta
+          tic.com/bigquerydatatransfer/oauthz/auth?client\_id=&scope=&re
+          direct\_uri=  -  client\_id should be OAuth client\_id of
+          BigQuery DTS API for the    given data source returned by
+          ListDataSources method. -  data\_source\_scopes are the scopes
+          returned by ListDataSources    method. -  redirect\_uri is an
+          optional parameter. If not specified, then    authorization
+          code is posted to the opener of authorization flow    window.
+          Otherwise it will be sent to the redirect uri. A special
+          value of urn:ietf:wg:oauth:2.0:oob means that authorization
+          code    should be returned in the title bar of the browser,
+          with the page    text prompting the user to copy the code and
+          paste it in the    application.
+      version_info:
+          Optional version info. If users want to find a very recent
+          access token, that is, immediately after approving access,
+          users have to set the version\_info claim in the token
+          request. To obtain the version\_info, users must use the
+          "none+gsession" response type. which be return a version\_info
+          back in the authorization response which be be put in a JWT
+          claim in the token request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTransferConfigRequest)
+
+UpdateTransferConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTransferConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETRANSFERCONFIGREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to update a transfer configuration. To update the user id of
+  the transfer configuration, an authorization code needs to be provided.
+  
+  
+  Attributes:
+      transfer_config:
+          Data transfer configuration to create.
+      authorization_code:
+          Optional OAuth2 authorization code to use with this transfer
+          configuration. If it is provided, the transfer configuration
+          will be associated with the authorizing user. In order to
+          obtain authorization\_code, please make a request to https://w
+          ww.gstatic.com/bigquerydatatransfer/oauthz/auth?client\_id=&sc
+          ope=&redirect\_uri=  -  client\_id should be OAuth client\_id
+          of BigQuery DTS API for the    given data source returned by
+          ListDataSources method. -  data\_source\_scopes are the scopes
+          returned by ListDataSources    method. -  redirect\_uri is an
+          optional parameter. If not specified, then    authorization
+          code is posted to the opener of authorization flow    window.
+          Otherwise it will be sent to the redirect uri. A special
+          value of urn:ietf:wg:oauth:2.0:oob means that authorization
+          code    should be returned in the title bar of the browser,
+          with the page    text prompting the user to copy the code and
+          paste it in the    application.
+      update_mask:
+          Required list of fields to be updated in this request.
+      version_info:
+          Optional version info. If users want to find a very recent
+          access token, that is, immediately after approving access,
+          users have to set the version\_info claim in the token
+          request. To obtain the version\_info, users must use the
+          "none+gsession" response type. which be return a version\_info
+          back in the authorization response which be be put in a JWT
+          claim in the token request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTransferConfigRequest)
+
+GetTransferConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTransferConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTRANSFERCONFIGREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to get data transfer information.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested, for
+          example: ``projects/{project_id}/transferConfigs/{config_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.GetTransferConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTransferConfigRequest)
+
+DeleteTransferConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTransferConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETRANSFERCONFIGREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to delete data transfer information. All associated transfer
+  runs and log messages will be deleted as well.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested, for
+          example: ``projects/{project_id}/transferConfigs/{config_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.DeleteTransferConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTransferConfigRequest)
+
+GetTransferRunRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTransferRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTRANSFERRUNREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to get data transfer run information.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested, for
+          example: ``projects/{project_id}/transferConfigs/{config_id}/r
+          uns/{run_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.GetTransferRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTransferRunRequest)
+
+DeleteTransferRunRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTransferRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETRANSFERRUNREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to delete data transfer run information.
+  
+  
+  Attributes:
+      name:
+          The field will contain name of the resource requested, for
+          example: ``projects/{project_id}/transferConfigs/{config_id}/r
+          uns/{run_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.DeleteTransferRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTransferRunRequest)
+
+ListTransferConfigsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTransferConfigsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRANSFERCONFIGSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to list data transfers configured for a BigQuery project.
+  
+  
+  Attributes:
+      parent:
+          The BigQuery project id for which data sources should be
+          returned: ``projects/{project_id}``.
+      data_source_ids:
+          When specified, only configurations of requested data sources
+          are returned.
+      page_token:
+          Pagination token, which can be used to request a specific page
+          of ``ListTransfersRequest`` list results. For multiple-page
+          results, ``ListTransfersResponse`` outputs a ``next_page``
+          token, which can be used as the ``page_token`` value to
+          request the next page of list results.
+      page_size:
+          Page size. The default page size is the maximum value of 1000
+          results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListTransferConfigsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTransferConfigsRequest)
+
+ListTransferConfigsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTransferConfigsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRANSFERCONFIGSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""The returned list of pipelines in the project.
+  
+  
+  Attributes:
+      transfer_configs:
+          Output only. The stored pipeline transfer configurations.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListTransferConfigsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTransferConfigsResponse)
+
+ListTransferRunsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTransferRunsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRANSFERRUNSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to list data transfer runs. UI can use this method to
+  show/filter specific data transfer runs. The data source can use this
+  method to request all scheduled transfer runs.
+  
+  
+  Attributes:
+      parent:
+          Name of transfer configuration for which transfer runs should
+          be retrieved. Format of transfer configuration resource name
+          is: ``projects/{project_id}/transferConfigs/{config_id}``.
+      states:
+          When specified, only transfer runs with requested states are
+          returned.
+      page_token:
+          Pagination token, which can be used to request a specific page
+          of ``ListTransferRunsRequest`` list results. For multiple-page
+          results, ``ListTransferRunsResponse`` outputs a ``next_page``
+          token, which can be used as the ``page_token`` value to
+          request the next page of list results.
+      page_size:
+          Page size. The default page size is the maximum value of 1000
+          results.
+      run_attempt:
+          Indicates how run attempts are to be pulled.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListTransferRunsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTransferRunsRequest)
+
+ListTransferRunsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTransferRunsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRANSFERRUNSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""The returned list of pipelines in the project.
+  
+  
+  Attributes:
+      transfer_runs:
+          Output only. The stored pipeline transfer runs.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListTransferRunsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTransferRunsResponse)
+
+ListTransferLogsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTransferLogsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRANSFERLOGSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to get user facing log messages associated with data transfer
+  run.
+  
+  
+  Attributes:
+      parent:
+          Transfer run name in the form: ``projects/{project_id}/transfe
+          rConfigs/{config_Id}/runs/{run_id}``.
+      page_token:
+          Pagination token, which can be used to request a specific page
+          of ``ListTransferLogsRequest`` list results. For multiple-page
+          results, ``ListTransferLogsResponse`` outputs a ``next_page``
+          token, which can be used as the ``page_token`` value to
+          request the next page of list results.
+      page_size:
+          Page size. The default page size is the maximum value of 1000
+          results.
+      message_types:
+          Message types to return. If not populated - INFO, WARNING and
+          ERROR messages are returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListTransferLogsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTransferLogsRequest)
+
+ListTransferLogsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTransferLogsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRANSFERLOGSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""The returned list transfer run messages.
+  
+  
+  Attributes:
+      transfer_messages:
+          Output only. The stored pipeline transfer messages.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ListTransferLogsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTransferLogsResponse)
+
+CheckValidCredsRequest = _reflection.GeneratedProtocolMessageType(
+    "CheckValidCredsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHECKVALIDCREDSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to determine whether the user has valid credentials. This
+  method is used to limit the number of OAuth popups in the user
+  interface. The user id is inferred from the API call context. If the
+  data source has the Google+ authorization type, this method returns
+  false, as it cannot be determined whether the credentials are already
+  valid merely based on the user id.
+  
+  
+  Attributes:
+      name:
+          The data source in the form:
+          ``projects/{project_id}/dataSources/{data_source_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.CheckValidCredsRequest)
+    ),
+)
+_sym_db.RegisterMessage(CheckValidCredsRequest)
+
+CheckValidCredsResponse = _reflection.GeneratedProtocolMessageType(
+    "CheckValidCredsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHECKVALIDCREDSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A response indicating whether the credentials exist and are valid.
+  
+  
+  Attributes:
+      has_valid_creds:
+          If set to ``true``, the credentials exist and are valid.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.CheckValidCredsResponse)
+    ),
+)
+_sym_db.RegisterMessage(CheckValidCredsResponse)
+
+ScheduleTransferRunsRequest = _reflection.GeneratedProtocolMessageType(
+    "ScheduleTransferRunsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCHEDULETRANSFERRUNSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to schedule transfer runs for a time range.
+  
+  
+  Attributes:
+      parent:
+          Transfer configuration name in the form:
+          ``projects/{project_id}/transferConfigs/{config_id}``.
+      start_time:
+          Start time of the range of transfer runs. For example,
+          ``"2017-05-25T00:00:00+00:00"``.
+      end_time:
+          End time of the range of transfer runs. For example,
+          ``"2017-05-30T00:00:00+00:00"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ScheduleTransferRunsRequest)
+
+ScheduleTransferRunsResponse = _reflection.GeneratedProtocolMessageType(
+    "ScheduleTransferRunsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCHEDULETRANSFERRUNSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A response to schedule transfer runs for a time range.
+  
+  
+  Attributes:
+      runs:
+          The transfer runs that were scheduled.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ScheduleTransferRunsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ScheduleTransferRunsResponse)
+
+StartManualTransferRunsRequest = _reflection.GeneratedProtocolMessageType(
+    "StartManualTransferRunsRequest",
+    (_message.Message,),
+    dict(
+        TimeRange=_reflection.GeneratedProtocolMessageType(
+            "TimeRange",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STARTMANUALTRANSFERRUNSREQUEST_TIMERANGE,
+                __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+                __doc__="""A specification for a time range, this will request transfer runs with
+    run\_time between start\_time (inclusive) and end\_time (exclusive).
+    
+    
+    Attributes:
+        start_time:
+            Start time of the range of transfer runs. For example,
+            ``"2017-05-25T00:00:00+00:00"``. The start\_time must be
+            strictly less than the end\_time. Creates transfer runs where
+            run\_time is in the range betwen start\_time (inclusive) and
+            end\_time (exlusive).
+        end_time:
+            End time of the range of transfer runs. For example,
+            ``"2017-05-30T00:00:00+00:00"``. The end\_time must not be in
+            the future. Creates transfer runs where run\_time is in the
+            range betwen start\_time (inclusive) and end\_time (exlusive).
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest.TimeRange)
+            ),
+        ),
+        DESCRIPTOR=_STARTMANUALTRANSFERRUNSREQUEST,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A request to start manual transfer runs.
+  
+  
+  Attributes:
+      parent:
+          Transfer configuration name in the form:
+          ``projects/{project_id}/transferConfigs/{config_id}``.
+      time:
+          The requested time specification - this can be a time range or
+          a specific run\_time.
+      requested_time_range:
+          Time range for the transfer runs that should be started.
+      requested_run_time:
+          Specific run\_time for a transfer run to be started. The
+          requested\_run\_time must not be in the future.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsRequest)
+    ),
+)
+_sym_db.RegisterMessage(StartManualTransferRunsRequest)
+_sym_db.RegisterMessage(StartManualTransferRunsRequest.TimeRange)
+
+StartManualTransferRunsResponse = _reflection.GeneratedProtocolMessageType(
+    "StartManualTransferRunsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STARTMANUALTRANSFERRUNSRESPONSE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.datatransfer_pb2",
+        __doc__="""A response to start manual transfer runs.
+  
+  
+  Attributes:
+      runs:
+          The transfer runs that were created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.StartManualTransferRunsResponse)
+    ),
+)
+_sym_db.RegisterMessage(StartManualTransferRunsResponse)
+
+
+DESCRIPTOR._options = None
+_DATASOURCE.fields_by_name["transfer_type"]._options = None
+_DATASOURCE.fields_by_name["supports_multiple_transfers"]._options = None
+
+_DATATRANSFERSERVICE = _descriptor.ServiceDescriptor(
+    name="DataTransferService",
+    full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A#bigquerydatatransfer.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=4581,
+    serialized_end=8454,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GetDataSource",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.GetDataSource",
+            index=0,
+            containing_service=None,
+            input_type=_GETDATASOURCEREQUEST,
+            output_type=_DATASOURCE,
+            serialized_options=_b(
+                "\202\323\344\223\002X\022//v1/{name=projects/*/locations/*/dataSources/*}Z%\022#/v1/{name=projects/*/dataSources/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDataSources",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.ListDataSources",
+            index=1,
+            containing_service=None,
+            input_type=_LISTDATASOURCESREQUEST,
+            output_type=_LISTDATASOURCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002X\022//v1/{parent=projects/*/locations/*}/dataSourcesZ%\022#/v1/{parent=projects/*}/dataSources"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTransferConfig",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.CreateTransferConfig",
+            index=2,
+            containing_service=None,
+            input_type=_CREATETRANSFERCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERCONFIG,
+            serialized_options=_b(
+                '\202\323\344\223\002\202\001"3/v1/{parent=projects/*/locations/*}/transferConfigs:\017transfer_configZ:"\'/v1/{parent=projects/*}/transferConfigs:\017transfer_config'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTransferConfig",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.UpdateTransferConfig",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATETRANSFERCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002\242\0012C/v1/{transfer_config.name=projects/*/locations/*/transferConfigs/*}:\017transfer_configZJ27/v1/{transfer_config.name=projects/*/transferConfigs/*}:\017transfer_config"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTransferConfig",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.DeleteTransferConfig",
+            index=4,
+            containing_service=None,
+            input_type=_DELETETRANSFERCONFIGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002`*3/v1/{name=projects/*/locations/*/transferConfigs/*}Z)*'/v1/{name=projects/*/transferConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTransferConfig",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.GetTransferConfig",
+            index=5,
+            containing_service=None,
+            input_type=_GETTRANSFERCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002`\0223/v1/{name=projects/*/locations/*/transferConfigs/*}Z)\022'/v1/{name=projects/*/transferConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTransferConfigs",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.ListTransferConfigs",
+            index=6,
+            containing_service=None,
+            input_type=_LISTTRANSFERCONFIGSREQUEST,
+            output_type=_LISTTRANSFERCONFIGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002`\0223/v1/{parent=projects/*/locations/*}/transferConfigsZ)\022'/v1/{parent=projects/*}/transferConfigs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ScheduleTransferRuns",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.ScheduleTransferRuns",
+            index=7,
+            containing_service=None,
+            input_type=_SCHEDULETRANSFERRUNSREQUEST,
+            output_type=_SCHEDULETRANSFERRUNSRESPONSE,
+            serialized_options=_b(
+                '\210\002\001\202\323\344\223\002\204\001"B/v1/{parent=projects/*/locations/*/transferConfigs/*}:scheduleRuns:\001*Z;"6/v1/{parent=projects/*/transferConfigs/*}:scheduleRuns:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StartManualTransferRuns",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.StartManualTransferRuns",
+            index=8,
+            containing_service=None,
+            input_type=_STARTMANUALTRANSFERRUNSREQUEST,
+            output_type=_STARTMANUALTRANSFERRUNSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\212\001"E/v1/{parent=projects/*/locations/*/transferConfigs/*}:startManualRuns:\001*Z>"9/v1/{parent=projects/*/transferConfigs/*}:startManualRuns:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTransferRun",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.GetTransferRun",
+            index=9,
+            containing_service=None,
+            input_type=_GETTRANSFERRUNREQUEST,
+            output_type=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2._TRANSFERRUN,
+            serialized_options=_b(
+                "\202\323\344\223\002n\022:/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}Z0\022./v1/{name=projects/*/transferConfigs/*/runs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTransferRun",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.DeleteTransferRun",
+            index=10,
+            containing_service=None,
+            input_type=_DELETETRANSFERRUNREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002n*:/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}Z0*./v1/{name=projects/*/transferConfigs/*/runs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTransferRuns",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.ListTransferRuns",
+            index=11,
+            containing_service=None,
+            input_type=_LISTTRANSFERRUNSREQUEST,
+            output_type=_LISTTRANSFERRUNSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002n\022:/v1/{parent=projects/*/locations/*/transferConfigs/*}/runsZ0\022./v1/{parent=projects/*/transferConfigs/*}/runs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTransferLogs",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.ListTransferLogs",
+            index=12,
+            containing_service=None,
+            input_type=_LISTTRANSFERLOGSREQUEST,
+            output_type=_LISTTRANSFERLOGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\214\001\022I/v1/{parent=projects/*/locations/*/transferConfigs/*/runs/*}/transferLogsZ?\022=/v1/{parent=projects/*/transferConfigs/*/runs/*}/transferLogs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CheckValidCreds",
+            full_name="google.cloud.bigquery.datatransfer.v1.DataTransferService.CheckValidCreds",
+            index=13,
+            containing_service=None,
+            input_type=_CHECKVALIDCREDSREQUEST,
+            output_type=_CHECKVALIDCREDSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002~"?/v1/{name=projects/*/locations/*/dataSources/*}:checkValidCreds:\001*Z8"3/v1/{name=projects/*/dataSources/*}:checkValidCreds:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DATATRANSFERSERVICE)
+
+DESCRIPTOR.services_by_name["DataTransferService"] = _DATATRANSFERSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2_grpc.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2_grpc.py
new file mode 100644
index 000000000000..ab525e22457c
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2_grpc.py
@@ -0,0 +1,296 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigquery_datatransfer_v1.proto import (
+    datatransfer_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2,
+)
+from google.cloud.bigquery_datatransfer_v1.proto import (
+    transfer_pb2 as google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DataTransferServiceStub(object):
+    """The Google BigQuery Data Transfer Service API enables BigQuery users to
+  configure the transfer of their data from other Google Products into
+  BigQuery. This service contains methods that are end user exposed. It backs
+  up the frontend.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GetDataSource = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/GetDataSource",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.GetDataSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DataSource.FromString,
+        )
+        self.ListDataSources = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/ListDataSources",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListDataSourcesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListDataSourcesResponse.FromString,
+        )
+        self.CreateTransferConfig = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/CreateTransferConfig",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.CreateTransferConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferConfig.FromString,
+        )
+        self.UpdateTransferConfig = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/UpdateTransferConfig",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.UpdateTransferConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferConfig.FromString,
+        )
+        self.DeleteTransferConfig = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/DeleteTransferConfig",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DeleteTransferConfigRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetTransferConfig = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/GetTransferConfig",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.GetTransferConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferConfig.FromString,
+        )
+        self.ListTransferConfigs = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/ListTransferConfigs",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferConfigsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferConfigsResponse.FromString,
+        )
+        self.ScheduleTransferRuns = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/ScheduleTransferRuns",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ScheduleTransferRunsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ScheduleTransferRunsResponse.FromString,
+        )
+        self.StartManualTransferRuns = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/StartManualTransferRuns",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.StartManualTransferRunsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.StartManualTransferRunsResponse.FromString,
+        )
+        self.GetTransferRun = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/GetTransferRun",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.GetTransferRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferRun.FromString,
+        )
+        self.DeleteTransferRun = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/DeleteTransferRun",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DeleteTransferRunRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListTransferRuns = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/ListTransferRuns",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferRunsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferRunsResponse.FromString,
+        )
+        self.ListTransferLogs = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/ListTransferLogs",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferLogsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferLogsResponse.FromString,
+        )
+        self.CheckValidCreds = channel.unary_unary(
+            "/google.cloud.bigquery.datatransfer.v1.DataTransferService/CheckValidCreds",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.CheckValidCredsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.CheckValidCredsResponse.FromString,
+        )
+
+
+class DataTransferServiceServicer(object):
+    """The Google BigQuery Data Transfer Service API enables BigQuery users to
+  configure the transfer of their data from other Google Products into
+  BigQuery. This service contains methods that are end user exposed. It backs
+  up the frontend.
+  """
+
+    def GetDataSource(self, request, context):
+        """Retrieves a supported data source and returns its settings,
+    which can be used for UI rendering.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDataSources(self, request, context):
+        """Lists supported data sources and returns their settings,
+    which can be used for UI rendering.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTransferConfig(self, request, context):
+        """Creates a new data transfer configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTransferConfig(self, request, context):
+        """Updates a data transfer configuration.
+    All fields must be set, even if they are not updated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTransferConfig(self, request, context):
+        """Deletes a data transfer configuration,
+    including any associated transfer runs and logs.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTransferConfig(self, request, context):
+        """Returns information about a data transfer config.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTransferConfigs(self, request, context):
+        """Returns information about all data transfers in the project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ScheduleTransferRuns(self, request, context):
+        """Creates transfer runs for a time range [start_time, end_time].
+    For each date - or whatever granularity the data source supports - in the
+    range, one transfer run is created.
+    Note that runs are created per UTC time in the time range.
+    DEPRECATED: use StartManualTransferRuns instead.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StartManualTransferRuns(self, request, context):
+        """Start manual transfer runs to be executed now with schedule_time equal to
+    current time. The transfer runs can be created for a time range where the
+    run_time is between start_time (inclusive) and end_time (exclusive), or for
+    a specific run_time.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTransferRun(self, request, context):
+        """Returns information about the particular transfer run.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTransferRun(self, request, context):
+        """Deletes the specified transfer run.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTransferRuns(self, request, context):
+        """Returns information about running and completed jobs.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTransferLogs(self, request, context):
+        """Returns user facing log messages for the data transfer run.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CheckValidCreds(self, request, context):
+        """Returns true if valid credentials exist for the given data source and
+    requesting user.
+    Some data sources doesn't support service account, so we need to talk to
+    them on behalf of the end user. This API just checks whether we have OAuth
+    token for the particular user, which is a pre-requisite before user can
+    create a transfer config.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DataTransferServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GetDataSource": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDataSource,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.GetDataSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DataSource.SerializeToString,
+        ),
+        "ListDataSources": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDataSources,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListDataSourcesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListDataSourcesResponse.SerializeToString,
+        ),
+        "CreateTransferConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTransferConfig,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.CreateTransferConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferConfig.SerializeToString,
+        ),
+        "UpdateTransferConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTransferConfig,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.UpdateTransferConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferConfig.SerializeToString,
+        ),
+        "DeleteTransferConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTransferConfig,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DeleteTransferConfigRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetTransferConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTransferConfig,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.GetTransferConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferConfig.SerializeToString,
+        ),
+        "ListTransferConfigs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTransferConfigs,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferConfigsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferConfigsResponse.SerializeToString,
+        ),
+        "ScheduleTransferRuns": grpc.unary_unary_rpc_method_handler(
+            servicer.ScheduleTransferRuns,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ScheduleTransferRunsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ScheduleTransferRunsResponse.SerializeToString,
+        ),
+        "StartManualTransferRuns": grpc.unary_unary_rpc_method_handler(
+            servicer.StartManualTransferRuns,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.StartManualTransferRunsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.StartManualTransferRunsResponse.SerializeToString,
+        ),
+        "GetTransferRun": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTransferRun,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.GetTransferRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_transfer__pb2.TransferRun.SerializeToString,
+        ),
+        "DeleteTransferRun": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTransferRun,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.DeleteTransferRunRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListTransferRuns": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTransferRuns,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferRunsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferRunsResponse.SerializeToString,
+        ),
+        "ListTransferLogs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTransferLogs,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferLogsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.ListTransferLogsResponse.SerializeToString,
+        ),
+        "CheckValidCreds": grpc.unary_unary_rpc_method_handler(
+            servicer.CheckValidCreds,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.CheckValidCredsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_datatransfer__v1_dot_proto_dot_datatransfer__pb2.CheckValidCredsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.bigquery.datatransfer.v1.DataTransferService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer.proto b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer.proto
new file mode 100644
index 000000000000..9501ea3cc3b3
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer.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.bigquery.datatransfer.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.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 = "TransferProto";
+option java_package = "com.google.cloud.bigquery.datatransfer.v1";
+option objc_class_prefix = "GCBDT";
+option php_namespace = "Google\\Cloud\\BigQuery\\DataTransfer\\V1";
+
+// DEPRECATED. Represents data transfer type.
+enum TransferType {
+  option deprecated = true;
+
+  // Invalid or Unknown transfer type placeholder.
+  TRANSFER_TYPE_UNSPECIFIED = 0;
+
+  // Batch data transfer.
+  BATCH = 1;
+
+  // Streaming data transfer. Streaming data source currently doesn't
+  // support multiple transfer configs per project.
+  STREAMING = 2;
+}
+
+// Represents data transfer run state.
+enum TransferState {
+  // State placeholder.
+  TRANSFER_STATE_UNSPECIFIED = 0;
+
+  // Data transfer is scheduled and is waiting to be picked up by
+  // data transfer backend.
+  PENDING = 2;
+
+  // Data transfer is in progress.
+  RUNNING = 3;
+
+  // Data transfer completed successfully.
+  SUCCEEDED = 4;
+
+  // Data transfer failed.
+  FAILED = 5;
+
+  // Data transfer is cancelled.
+  CANCELLED = 6;
+}
+
+// Options customizing the data transfer schedule.
+message ScheduleOptions {
+  // If true, automatic scheduling of data transfer runs for this configuration
+  // will be disabled. The runs can be started on ad-hoc basis using
+  // StartManualTransferRuns API. When automatic scheduling is disabled, the
+  // TransferConfig.schedule field will be ignored.
+  bool disable_auto_scheduling = 3;
+
+  // Specifies time to start scheduling transfer runs. The first run will be
+  // scheduled at or after the start time according to a recurrence pattern
+  // defined in the schedule string. The start time can be changed at any
+  // moment. The time when a data transfer can be trigerred manually is not
+  // limited by this option.
+  google.protobuf.Timestamp start_time = 1;
+
+  // Defines time to stop scheduling transfer runs. A transfer run cannot be
+  // scheduled at or after the end time. The end time can be changed at any
+  // moment. The time when a data transfer can be trigerred manually is not
+  // limited by this option.
+  google.protobuf.Timestamp end_time = 2;
+}
+
+// Represents a data transfer configuration. A transfer configuration
+// contains all metadata needed to perform a data transfer. For example,
+// `destination_dataset_id` specifies where data should be stored.
+// When a new transfer configuration is created, the specified
+// `destination_dataset_id` is created when needed and shared with the
+// appropriate data source service account.
+message TransferConfig {
+  // The resource name of the transfer config.
+  // Transfer config names have the form of
+  // `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`.
+  // The name is automatically generated based on the config_id specified in
+  // CreateTransferConfigRequest along with project_id and region. If config_id
+  // is not provided, usually a uuid, even though it is not guaranteed or
+  // required, will be generated for config_id.
+  string name = 1;
+
+  // The BigQuery target dataset id.
+  string destination_dataset_id = 2;
+
+  // User specified display name for the data transfer.
+  string display_name = 3;
+
+  // Data source id. Cannot be changed once data transfer is created.
+  string data_source_id = 5;
+
+  // Data transfer specific parameters.
+  google.protobuf.Struct params = 9;
+
+  // Data transfer schedule.
+  // If the data source does not support a custom schedule, this should be
+  // empty. If it is empty, the default value for the data source will be
+  // used.
+  // The specified times are in UTC.
+  // Examples of valid format:
+  // `1st,3rd monday of month 15:30`,
+  // `every wed,fri of jan,jun 13:15`, and
+  // `first sunday of quarter 00:00`.
+  // See more explanation about the format here:
+  // https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
+  // NOTE: the granularity should be at least 8 hours, or less frequent.
+  string schedule = 7;
+
+  // Options customizing the data transfer schedule.
+  ScheduleOptions schedule_options = 24;
+
+  // The number of days to look back to automatically refresh the data.
+  // For example, if `data_refresh_window_days = 10`, then every day
+  // BigQuery reingests data for [today-10, today-1], rather than ingesting data
+  // for just [today-1].
+  // Only valid if the data source supports the feature. Set the value to  0
+  // to use the default value.
+  int32 data_refresh_window_days = 12;
+
+  // Is this config disabled. When set to true, no runs are scheduled
+  // for a given transfer.
+  bool disabled = 13;
+
+  // Output only. Data transfer modification time. Ignored by server on input.
+  google.protobuf.Timestamp update_time = 4;
+
+  // Output only. Next time when data transfer will run.
+  google.protobuf.Timestamp next_run_time = 8;
+
+  // Output only. State of the most recently updated transfer run.
+  TransferState state = 10;
+
+  // 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;
+}
+
+// Represents a data transfer run.
+message TransferRun {
+  // The resource name of the transfer run.
+  // Transfer run names have the form
+  // `projects/{project_id}/locations/{location}/transferConfigs/{config_id}/runs/{run_id}`.
+  // The name is ignored when creating a transfer run.
+  string name = 1;
+
+  // Minimum time after which a transfer run can be started.
+  google.protobuf.Timestamp schedule_time = 3;
+
+  // For batch transfer runs, specifies the date and time of the data should be
+  // ingested.
+  google.protobuf.Timestamp run_time = 10;
+
+  // Status of the transfer run.
+  google.rpc.Status error_status = 21;
+
+  // Output only. Time when transfer run was started.
+  // Parameter ignored by server for input requests.
+  google.protobuf.Timestamp start_time = 4;
+
+  // Output only. Time when transfer run ended.
+  // Parameter ignored by server for input requests.
+  google.protobuf.Timestamp end_time = 5;
+
+  // Output only. Last time the data transfer run state was updated.
+  google.protobuf.Timestamp update_time = 6;
+
+  // Output only. Data transfer specific parameters.
+  google.protobuf.Struct params = 9;
+
+  // Output only. The BigQuery target dataset id.
+  string destination_dataset_id = 2;
+
+  // Output only. Data source id.
+  string data_source_id = 7;
+
+  // Data transfer run state. Ignored for input requests.
+  TransferState state = 8;
+
+  // Deprecated. Unique ID of the user on whose behalf transfer is done.
+  int64 user_id = 11;
+
+  // Output only. Describes the schedule of this transfer run if it was
+  // created as part of a regular schedule. For batch transfer runs that are
+  // 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;
+}
+
+// Represents a user facing message for a particular data transfer run.
+message TransferMessage {
+  // Represents data transfer user facing message severity.
+  enum MessageSeverity {
+    // No severity specified.
+    MESSAGE_SEVERITY_UNSPECIFIED = 0;
+
+    // Informational message.
+    INFO = 1;
+
+    // Warning message.
+    WARNING = 2;
+
+    // Error message.
+    ERROR = 3;
+  }
+
+  // Time when message was logged.
+  google.protobuf.Timestamp message_time = 1;
+
+  // Message severity.
+  MessageSeverity severity = 2;
+
+  // Message text.
+  string message_text = 3;
+}
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer_pb2.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer_pb2.py
new file mode 100644
index 000000000000..437774a5f201
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer_pb2.py
@@ -0,0 +1,1066 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/datatransfer_v1/proto/transfer.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/datatransfer_v1/proto/transfer.proto",
+    package="google.cloud.bigquery.datatransfer.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.datatransfer.v1B\rTransferProtoP\001ZQgoogle.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer\242\002\005GCBDT\252\002%Google.Cloud.BigQuery.DataTransfer.V1\312\002%Google\\Cloud\\BigQuery\\DataTransfer\\V1"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/bigquery/datatransfer_v1/proto/transfer.proto\x12%google.cloud.bigquery.datatransfer.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\x90\x01\n\x0fScheduleOptions\x12\x1f\n\x17\x64isable_auto_scheduling\x18\x03 \x01(\x08\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xff\x03\n\x0eTransferConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1e\n\x16\x64\x65stination_dataset_id\x18\x02 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x16\n\x0e\x64\x61ta_source_id\x18\x05 \x01(\t\x12\'\n\x06params\x18\t \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x10\n\x08schedule\x18\x07 \x01(\t\x12P\n\x10schedule_options\x18\x18 \x01(\x0b\x32\x36.google.cloud.bigquery.datatransfer.v1.ScheduleOptions\x12 \n\x18\x64\x61ta_refresh_window_days\x18\x0c \x01(\x05\x12\x10\n\x08\x64isabled\x18\r \x01(\x08\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rnext_run_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x43\n\x05state\x18\n \x01(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferState\x12\x0f\n\x07user_id\x18\x0b \x01(\x03\x12\x16\n\x0e\x64\x61taset_region\x18\x0e \x01(\t"\xfe\x03\n\x0bTransferRun\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x31\n\rschedule_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08run_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12(\n\x0c\x65rror_status\x18\x15 \x01(\x0b\x32\x12.google.rpc.Status\x12.\n\nstart_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\'\n\x06params\x18\t \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x1e\n\x16\x64\x65stination_dataset_id\x18\x02 \x01(\t\x12\x16\n\x0e\x64\x61ta_source_id\x18\x07 \x01(\t\x12\x43\n\x05state\x18\x08 \x01(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferState\x12\x0f\n\x07user_id\x18\x0b \x01(\x03\x12\x10\n\x08schedule\x18\x0c \x01(\t"\x8a\x02\n\x0fTransferMessage\x12\x30\n\x0cmessage_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x08severity\x18\x02 \x01(\x0e\x32\x46.google.cloud.bigquery.datatransfer.v1.TransferMessage.MessageSeverity\x12\x14\n\x0cmessage_text\x18\x03 \x01(\t"U\n\x0fMessageSeverity\x12 \n\x1cMESSAGE_SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03*K\n\x0cTransferType\x12\x1d\n\x19TRANSFER_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41TCH\x10\x01\x12\r\n\tSTREAMING\x10\x02\x1a\x02\x18\x01*s\n\rTransferState\x12\x1e\n\x1aTRANSFER_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x02\x12\x0b\n\x07RUNNING\x10\x03\x12\r\n\tSUCCEEDED\x10\x04\x12\n\n\x06\x46\x41ILED\x10\x05\x12\r\n\tCANCELLED\x10\x06\x42\xe7\x01\n)com.google.cloud.bigquery.datatransfer.v1B\rTransferProtoP\x01ZQgoogle.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer\xa2\x02\x05GCBDT\xaa\x02%Google.Cloud.BigQuery.DataTransfer.V1\xca\x02%Google\\Cloud\\BigQuery\\DataTransfer\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_TRANSFERTYPE = _descriptor.EnumDescriptor(
+    name="TransferType",
+    full_name="google.cloud.bigquery.datatransfer.v1.TransferType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TRANSFER_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BATCH", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=_b("\030\001"),
+    serialized_start=1662,
+    serialized_end=1737,
+)
+_sym_db.RegisterEnumDescriptor(_TRANSFERTYPE)
+
+TransferType = enum_type_wrapper.EnumTypeWrapper(_TRANSFERTYPE)
+_TRANSFERSTATE = _descriptor.EnumDescriptor(
+    name="TransferState",
+    full_name="google.cloud.bigquery.datatransfer.v1.TransferState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TRANSFER_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCEEDED", index=3, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=4, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=5, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1739,
+    serialized_end=1854,
+)
+_sym_db.RegisterEnumDescriptor(_TRANSFERSTATE)
+
+TransferState = enum_type_wrapper.EnumTypeWrapper(_TRANSFERSTATE)
+TRANSFER_TYPE_UNSPECIFIED = 0
+BATCH = 1
+STREAMING = 2
+TRANSFER_STATE_UNSPECIFIED = 0
+PENDING = 2
+RUNNING = 3
+SUCCEEDED = 4
+FAILED = 5
+CANCELLED = 6
+
+
+_TRANSFERMESSAGE_MESSAGESEVERITY = _descriptor.EnumDescriptor(
+    name="MessageSeverity",
+    full_name="google.cloud.bigquery.datatransfer.v1.TransferMessage.MessageSeverity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MESSAGE_SEVERITY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INFO", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WARNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1575,
+    serialized_end=1660,
+)
+_sym_db.RegisterEnumDescriptor(_TRANSFERMESSAGE_MESSAGESEVERITY)
+
+
+_SCHEDULEOPTIONS = _descriptor.Descriptor(
+    name="ScheduleOptions",
+    full_name="google.cloud.bigquery.datatransfer.v1.ScheduleOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disable_auto_scheduling",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleOptions.disable_auto_scheduling",
+            index=0,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleOptions.start_time",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.ScheduleOptions.end_time",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=220,
+    serialized_end=364,
+)
+
+
+_TRANSFERCONFIG = _descriptor.Descriptor(
+    name="TransferConfig",
+    full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destination_dataset_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.destination_dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.display_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_source_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.data_source_id",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.params",
+            index=4,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.schedule",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_options",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.schedule_options",
+            index=6,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_refresh_window_days",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.data_refresh_window_days",
+            index=7,
+            number=12,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.disabled",
+            index=8,
+            number=13,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.update_time",
+            index=9,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_run_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.next_run_time",
+            index=10,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.state",
+            index=11,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.user_id",
+            index=12,
+            number=11,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_region",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferConfig.dataset_region",
+            index=13,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=367,
+    serialized_end=878,
+)
+
+
+_TRANSFERRUN = _descriptor.Descriptor(
+    name="TransferRun",
+    full_name="google.cloud.bigquery.datatransfer.v1.TransferRun",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.schedule_time",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="run_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.run_time",
+            index=2,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error_status",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.error_status",
+            index=3,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.start_time",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.end_time",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.update_time",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.params",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destination_dataset_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.destination_dataset_id",
+            index=8,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_source_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.data_source_id",
+            index=9,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.state",
+            index=10,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_id",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.user_id",
+            index=11,
+            number=11,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferRun.schedule",
+            index=12,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=881,
+    serialized_end=1391,
+)
+
+
+_TRANSFERMESSAGE = _descriptor.Descriptor(
+    name="TransferMessage",
+    full_name="google.cloud.bigquery.datatransfer.v1.TransferMessage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="message_time",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferMessage.message_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="severity",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferMessage.severity",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message_text",
+            full_name="google.cloud.bigquery.datatransfer.v1.TransferMessage.message_text",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TRANSFERMESSAGE_MESSAGESEVERITY],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1394,
+    serialized_end=1660,
+)
+
+_SCHEDULEOPTIONS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCHEDULEOPTIONS.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERCONFIG.fields_by_name[
+    "params"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_TRANSFERCONFIG.fields_by_name["schedule_options"].message_type = _SCHEDULEOPTIONS
+_TRANSFERCONFIG.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERCONFIG.fields_by_name[
+    "next_run_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERCONFIG.fields_by_name["state"].enum_type = _TRANSFERSTATE
+_TRANSFERRUN.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERRUN.fields_by_name[
+    "run_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERRUN.fields_by_name[
+    "error_status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_TRANSFERRUN.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERRUN.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERRUN.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERRUN.fields_by_name[
+    "params"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_TRANSFERRUN.fields_by_name["state"].enum_type = _TRANSFERSTATE
+_TRANSFERMESSAGE.fields_by_name[
+    "message_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSFERMESSAGE.fields_by_name["severity"].enum_type = _TRANSFERMESSAGE_MESSAGESEVERITY
+_TRANSFERMESSAGE_MESSAGESEVERITY.containing_type = _TRANSFERMESSAGE
+DESCRIPTOR.message_types_by_name["ScheduleOptions"] = _SCHEDULEOPTIONS
+DESCRIPTOR.message_types_by_name["TransferConfig"] = _TRANSFERCONFIG
+DESCRIPTOR.message_types_by_name["TransferRun"] = _TRANSFERRUN
+DESCRIPTOR.message_types_by_name["TransferMessage"] = _TRANSFERMESSAGE
+DESCRIPTOR.enum_types_by_name["TransferType"] = _TRANSFERTYPE
+DESCRIPTOR.enum_types_by_name["TransferState"] = _TRANSFERSTATE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScheduleOptions = _reflection.GeneratedProtocolMessageType(
+    "ScheduleOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCHEDULEOPTIONS,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.transfer_pb2",
+        __doc__="""Options customizing the data transfer schedule.
+  
+  
+  Attributes:
+      disable_auto_scheduling:
+          If true, automatic scheduling of data transfer runs for this
+          configuration will be disabled. The runs can be started on ad-
+          hoc basis using StartManualTransferRuns API. When automatic
+          scheduling is disabled, the TransferConfig.schedule field will
+          be ignored.
+      start_time:
+          Specifies time to start scheduling transfer runs. The first
+          run will be scheduled at or after the start time according to
+          a recurrence pattern defined in the schedule string. The start
+          time can be changed at any moment. The time when a data
+          transfer can be trigerred manually is not limited by this
+          option.
+      end_time:
+          Defines time to stop scheduling transfer runs. A transfer run
+          cannot be scheduled at or after the end time. The end time can
+          be changed at any moment. The time when a data transfer can be
+          trigerred manually is not limited by this option.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.ScheduleOptions)
+    ),
+)
+_sym_db.RegisterMessage(ScheduleOptions)
+
+TransferConfig = _reflection.GeneratedProtocolMessageType(
+    "TransferConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSFERCONFIG,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.transfer_pb2",
+        __doc__="""Represents a data transfer configuration. A transfer configuration
+  contains all metadata needed to perform a data transfer. For example,
+  ``destination_dataset_id`` specifies where data should be stored. When a
+  new transfer configuration is created, the specified
+  ``destination_dataset_id`` is created when needed and shared with the
+  appropriate data source service account.
+  
+  
+  Attributes:
+      name:
+          The resource name of the transfer config. Transfer config
+          names have the form of ``projects/{project_id}/locations/{regi
+          on}/transferConfigs/{config_id}``. The name is automatically
+          generated based on the config\_id specified in
+          CreateTransferConfigRequest along with project\_id and region.
+          If config\_id is not provided, usually a uuid, even though it
+          is not guaranteed or required, will be generated for
+          config\_id.
+      destination_dataset_id:
+          The BigQuery target dataset id.
+      display_name:
+          User specified display name for the data transfer.
+      data_source_id:
+          Data source id. Cannot be changed once data transfer is
+          created.
+      params:
+          Data transfer specific parameters.
+      schedule:
+          Data transfer schedule. If the data source does not support a
+          custom schedule, this should be empty. If it is empty, the
+          default value for the data source will be used. The specified
+          times are in UTC. Examples of valid format: ``1st,3rd monday
+          of month 15:30``, ``every wed,fri of jan,jun 13:15``, and
+          ``first sunday of quarter 00:00``. See more explanation about
+          the format here: https://cloud.google.com/appengine/docs/flexi
+          ble/python/scheduling-jobs-with-cron-
+          yaml#the\_schedule\_format NOTE: the granularity should be at
+          least 8 hours, or less frequent.
+      schedule_options:
+          Options customizing the data transfer schedule.
+      data_refresh_window_days:
+          The number of days to look back to automatically refresh the
+          data. For example, if ``data_refresh_window_days = 10``, then
+          every day BigQuery reingests data for [today-10, today-1],
+          rather than ingesting data for just [today-1]. Only valid if
+          the data source supports the feature. Set the value to 0 to
+          use the default value.
+      disabled:
+          Is this config disabled. When set to true, no runs are
+          scheduled for a given transfer.
+      update_time:
+          Output only. Data transfer modification time. Ignored by
+          server on input.
+      next_run_time:
+          Output only. Next time when data transfer will run.
+      state:
+          Output only. State of the most recently updated transfer run.
+      user_id:
+          Deprecated. Unique ID of the user on whose behalf transfer is
+          done.
+      dataset_region:
+          Output only. Region in which BigQuery dataset is located.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.TransferConfig)
+    ),
+)
+_sym_db.RegisterMessage(TransferConfig)
+
+TransferRun = _reflection.GeneratedProtocolMessageType(
+    "TransferRun",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSFERRUN,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.transfer_pb2",
+        __doc__="""Represents a data transfer run.
+  
+  
+  Attributes:
+      name:
+          The resource name of the transfer run. Transfer run names have
+          the form ``projects/{project_id}/locations/{location}/transfer
+          Configs/{config_id}/runs/{run_id}``. The name is ignored when
+          creating a transfer run.
+      schedule_time:
+          Minimum time after which a transfer run can be started.
+      run_time:
+          For batch transfer runs, specifies the date and time of the
+          data should be ingested.
+      error_status:
+          Status of the transfer run.
+      start_time:
+          Output only. Time when transfer run was started. Parameter
+          ignored by server for input requests.
+      end_time:
+          Output only. Time when transfer run ended. Parameter ignored
+          by server for input requests.
+      update_time:
+          Output only. Last time the data transfer run state was
+          updated.
+      params:
+          Output only. Data transfer specific parameters.
+      destination_dataset_id:
+          Output only. The BigQuery target dataset id.
+      data_source_id:
+          Output only. Data source id.
+      state:
+          Data transfer run state. Ignored for input requests.
+      user_id:
+          Deprecated. Unique ID of the user on whose behalf transfer is
+          done.
+      schedule:
+          Output only. Describes the schedule of this transfer run if it
+          was created as part of a regular schedule. For batch transfer
+          runs that are 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.TransferRun)
+    ),
+)
+_sym_db.RegisterMessage(TransferRun)
+
+TransferMessage = _reflection.GeneratedProtocolMessageType(
+    "TransferMessage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSFERMESSAGE,
+        __module__="google.cloud.bigquery.datatransfer_v1.proto.transfer_pb2",
+        __doc__="""Represents a user facing message for a particular data transfer run.
+  
+  
+  Attributes:
+      message_time:
+          Time when message was logged.
+      severity:
+          Message severity.
+      message_text:
+          Message text.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.datatransfer.v1.TransferMessage)
+    ),
+)
+_sym_db.RegisterMessage(TransferMessage)
+
+
+DESCRIPTOR._options = None
+_TRANSFERTYPE._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer_pb2_grpc.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/proto/transfer_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/types.py b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/types.py
new file mode 100644
index 000000000000..da6b3268fcc7
--- /dev/null
+++ b/bigquery_datatransfer/google/cloud/bigquery_datatransfer_v1/types.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.bigquery_datatransfer_v1.proto import datatransfer_pb2
+from google.cloud.bigquery_datatransfer_v1.proto import transfer_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+]
+
+_local_modules = [datatransfer_pb2, transfer_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.bigquery_datatransfer_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/bigquery_datatransfer/noxfile.py b/bigquery_datatransfer/noxfile.py
new file mode 100644
index 000000000000..a5d1ca866045
--- /dev/null
+++ b/bigquery_datatransfer/noxfile.py
@@ -0,0 +1,179 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python=["2.7", "3.7"])
+def samples(session):
+    requirements_path = os.path.join("samples", "requirements.txt")
+    requirements_exists = os.path.exists(requirements_path)
+
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    if requirements_exists:
+        session.install("-r", requirements_path)
+    session.install("-e", ".")
+
+    session.run("py.test", "--quiet", "samples", *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=79")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/bigquery_datatransfer/samples/__init__.py b/bigquery_datatransfer/samples/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_datatransfer/samples/create_scheduled_query.py b/bigquery_datatransfer/samples/create_scheduled_query.py
new file mode 100644
index 000000000000..b4e7437fb37d
--- /dev/null
+++ b/bigquery_datatransfer/samples/create_scheduled_query.py
@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# To install the latest published package dependency, execute the following:
+#   pip install google-cloud-bigquery-datatransfer
+
+
+def sample_create_transfer_config(project_id, dataset_id, authorization_code=""):
+    # [START bigquerydatatransfer_create_scheduled_query]
+    from google.cloud import bigquery_datatransfer_v1
+    import google.protobuf.json_format
+
+    client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+    # TODO(developer): Set the project_id to the project that contains the
+    #                  destination dataset.
+    # project_id = "your-project-id"
+
+    # TODO(developer): Set the destination dataset. The authorized user must
+    #                  have owner permissions on the dataset.
+    # dataset_id = "your_dataset_id"
+
+    # TODO(developer): The first time you run this sample, set the
+    # authorization code to a value from the URL:
+    # https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=433065040935-hav5fqnc9p9cht3rqneus9115ias2kn1.apps.googleusercontent.com&scope=https://www.googleapis.com/auth/bigquery%20https://www.googleapis.com/auth/drive&redirect_uri=urn:ietf:wg:oauth:2.0:oob
+    #
+    # authorization_code = "_4/ABCD-EFGHIJKLMNOP-QRSTUVWXYZ"
+    #
+    # You can use an empty string for authorization_code in subsequent runs of
+    # this code sample with the same credentials.
+    #
+    # authorization_code = ""
+
+    # Use standard SQL syntax for the query.
+    query_string = """
+    SELECT
+      CURRENT_TIMESTAMP() as current_time,
+      @run_time as intended_run_time,
+      @run_date as intended_run_date,
+      17 as some_integer
+    """
+
+    parent = client.project_path(project_id)
+
+    transfer_config = google.protobuf.json_format.ParseDict(
+        {
+            "destination_dataset_id": dataset_id,
+            "display_name": "Your Scheduled Query Name",
+            "data_source_id": "scheduled_query",
+            "params": {
+                "query": query_string,
+                "destination_table_name_template": "your_table_{run_date}",
+                "write_disposition": "WRITE_TRUNCATE",
+                "partitioning_field": "",
+            },
+            "schedule": "every 24 hours",
+        },
+        bigquery_datatransfer_v1.types.TransferConfig(),
+    )
+
+    response = client.create_transfer_config(
+        parent, transfer_config, authorization_code=authorization_code
+    )
+
+    print("Created scheduled query '{}'".format(response.name))
+    # [END bigquerydatatransfer_create_scheduled_query]
+    # Return the config name for testing purposes, so that it can be deleted.
+    return response.name
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--project_id", type=str, default="your-project-id")
+    parser.add_argument("--dataset_id", type=str, default="your_dataset_id")
+    parser.add_argument("--authorization_code", type=str, default="")
+    args = parser.parse_args()
+
+    sample_create_transfer_config(args.project_id, args.authorization_code)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/bigquery_datatransfer/samples/requirements.txt b/bigquery_datatransfer/samples/requirements.txt
new file mode 100644
index 000000000000..07315b55faa6
--- /dev/null
+++ b/bigquery_datatransfer/samples/requirements.txt
@@ -0,0 +1 @@
+-e ../bigquery
diff --git a/bigquery_datatransfer/samples/tests/__init__.py b/bigquery_datatransfer/samples/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_datatransfer/samples/tests/test_create_scheduled_query.py b/bigquery_datatransfer/samples/tests/test_create_scheduled_query.py
new file mode 100644
index 000000000000..a1a69c1ff0c3
--- /dev/null
+++ b/bigquery_datatransfer/samples/tests/test_create_scheduled_query.py
@@ -0,0 +1,82 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+import os
+
+import google.api_core.exceptions
+import google.auth
+import google.cloud.bigquery
+import pytest
+
+from .. import create_scheduled_query
+
+
+@pytest.fixture
+def project_id():
+    return os.environ["PROJECT_ID"]
+
+
+@pytest.fixture(scope="module")
+def credentials():
+    # If using a service account, the BQ DTS robot associated with your project
+    # requires the roles/iam.serviceAccountShortTermTokenMinter permission to
+    # act on behalf of the account.
+    creds, _ = google.auth.default(["https://www.googleapis.com/auth/cloud-platform"])
+    return creds
+
+
+@pytest.fixture(scope="module")
+def bqdts_client(credentials):
+    from google.cloud import bigquery_datatransfer_v1
+
+    return bigquery_datatransfer_v1.DataTransferServiceClient(credentials=credentials)
+
+
+@pytest.fixture(scope="module")
+def bigquery_client(credentials):
+    return google.cloud.bigquery.Client(credentials=credentials)
+
+
+@pytest.fixture(scope="module")
+def dataset_id(bigquery_client):
+    # Ensure the test account has owner permissions on the dataset by creating
+    # one from scratch.
+    temp_ds_id = "bqdts_{}".format(int(time.clock() * 1000000))
+    bigquery_client.create_dataset(temp_ds_id)
+    yield temp_ds_id
+    bigquery_client.delete_dataset(temp_ds_id)
+
+
+@pytest.fixture
+def to_delete(bqdts_client):
+    doomed = []
+    yield doomed
+
+    for resource_name in doomed:
+        try:
+            bqdts_client.delete_transfer_config(resource_name)
+        except google.api_core.exceptions.NotFound:
+            pass
+
+
+def test_sample(project_id, dataset_id, capsys, to_delete):
+    config_name = create_scheduled_query.sample_create_transfer_config(
+        project_id, dataset_id
+    )
+    to_delete.append(config_name)
+    out, err = capsys.readouterr()
+    assert config_name in out
diff --git a/bigquery_datatransfer/setup.cfg b/bigquery_datatransfer/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/bigquery_datatransfer/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/bigquery_datatransfer/setup.py b/bigquery_datatransfer/setup.py
new file mode 100644
index 000000000000..49a6456283ce
--- /dev/null
+++ b/bigquery_datatransfer/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-bigquery-datatransfer"
+description = "BigQuery Data Transfer API client library"
+version = "0.4.1"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/bigquery_datatransfer/synth.metadata b/bigquery_datatransfer/synth.metadata
new file mode 100644
index 000000000000..1643741ae8a9
--- /dev/null
+++ b/bigquery_datatransfer/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-03T12:11:16.935211Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "7b212a8d2319cd81a7b6942c25dbf4550480a06c",
+        "internalRef": "261339454"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "bigquery_datatransfer",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/bigquery/datatransfer/artman_bigquerydatatransfer.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/bigquery_datatransfer/synth.py b/bigquery_datatransfer/synth.py
new file mode 100644
index 000000000000..9a8acff4369c
--- /dev/null
+++ b/bigquery_datatransfer/synth.py
@@ -0,0 +1,68 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+version = "v1"
+
+# ----------------------------------------------------------------------------
+# Generate bigquery_datatransfer GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "bigquery_datatransfer",
+    version,
+    config_path="/google/cloud/bigquery/datatransfer/"
+    "artman_bigquerydatatransfer.yaml",
+    artman_output_name="bigquerydatatransfer-v1",
+    include_protos=True,
+)
+
+s.move(
+    library,
+    excludes=["docs/conf.py", "docs/index.rst", "README.rst", "nox.py", "setup.py"],
+)
+
+s.replace(
+    [
+        "google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2.py",
+        "google/cloud/bigquery_datatransfer_v1/proto/datatransfer_pb2_grpc.py",
+    ],
+    "from google.cloud.bigquery.datatransfer_v1.proto",
+    "from google.cloud.bigquery_datatransfer_v1.proto",
+)
+
+s.replace(
+    "google/cloud/bigquery_datatransfer_v1/gapic/" "data_transfer_service_client.py",
+    "google-cloud-bigquerydatatransfer",
+    "google-cloud-bigquery-datatransfer",
+)
+
+s.replace(
+    "google/cloud/bigquery_datatransfer_v1/gapic/" "data_transfer_service_client.py",
+    "import google.api_core.gapic_v1.method\n",
+    "\g<0>import google.api_core.path_template\n",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=79, cov_level=79, samples_test=True)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/bigquery_datatransfer/tests/system/gapic/v1/test_system_data_transfer_service_v1.py b/bigquery_datatransfer/tests/system/gapic/v1/test_system_data_transfer_service_v1.py
new file mode 100644
index 000000000000..28f975d9f846
--- /dev/null
+++ b/bigquery_datatransfer/tests/system/gapic/v1/test_system_data_transfer_service_v1.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import bigquery_datatransfer_v1
+from google.cloud.bigquery_datatransfer_v1.proto import datatransfer_pb2
+
+
+class TestSystemDataTransferService(object):
+    def test_list_data_sources(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = bigquery_datatransfer_v1.DataTransferServiceClient()
+        parent = client.location_path(project_id, "us-central1")
+        response = client.list_data_sources(parent)
diff --git a/bigquery_datatransfer/tests/unit/gapic/v1/test_data_transfer_service_client_v1.py b/bigquery_datatransfer/tests/unit/gapic/v1/test_data_transfer_service_client_v1.py
new file mode 100644
index 000000000000..7878245ee30f
--- /dev/null
+++ b/bigquery_datatransfer/tests/unit/gapic/v1/test_data_transfer_service_client_v1.py
@@ -0,0 +1,723 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import bigquery_datatransfer_v1
+from google.cloud.bigquery_datatransfer_v1.proto import datatransfer_pb2
+from google.cloud.bigquery_datatransfer_v1.proto import transfer_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDataTransferServiceClient(object):
+    def test_get_data_source(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        data_source_id = "dataSourceId-1015796374"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        client_id = "clientId-1904089585"
+        supports_multiple_transfers = True
+        update_deadline_seconds = 991471694
+        default_schedule = "defaultSchedule-800168235"
+        supports_custom_schedule = True
+        help_url = "helpUrl-789431439"
+        default_data_refresh_window_days = 1804935157
+        manual_runs_disabled = True
+        expected_response = {
+            "name": name_2,
+            "data_source_id": data_source_id,
+            "display_name": display_name,
+            "description": description,
+            "client_id": client_id,
+            "supports_multiple_transfers": supports_multiple_transfers,
+            "update_deadline_seconds": update_deadline_seconds,
+            "default_schedule": default_schedule,
+            "supports_custom_schedule": supports_custom_schedule,
+            "help_url": help_url,
+            "default_data_refresh_window_days": default_data_refresh_window_days,
+            "manual_runs_disabled": manual_runs_disabled,
+        }
+        expected_response = datatransfer_pb2.DataSource(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        name = client.project_data_source_path("[PROJECT]", "[DATA_SOURCE]")
+
+        response = client.get_data_source(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.GetDataSourceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_data_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        name = client.project_data_source_path("[PROJECT]", "[DATA_SOURCE]")
+
+        with pytest.raises(CustomException):
+            client.get_data_source(name)
+
+    def test_list_data_sources(self):
+        # Setup Expected Response
+        next_page_token = ""
+        data_sources_element = {}
+        data_sources = [data_sources_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "data_sources": data_sources,
+        }
+        expected_response = datatransfer_pb2.ListDataSourcesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_data_sources(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.data_sources[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.ListDataSourcesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_data_sources_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_data_sources(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_transfer_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        destination_dataset_id = "destinationDatasetId1541564179"
+        display_name = "displayName1615086568"
+        data_source_id = "dataSourceId-1015796374"
+        schedule = "schedule-697920873"
+        data_refresh_window_days = 327632845
+        disabled = True
+        user_id = 147132913
+        dataset_region = "datasetRegion959248539"
+        expected_response = {
+            "name": name,
+            "destination_dataset_id": destination_dataset_id,
+            "display_name": display_name,
+            "data_source_id": data_source_id,
+            "schedule": schedule,
+            "data_refresh_window_days": data_refresh_window_days,
+            "disabled": disabled,
+            "user_id": user_id,
+            "dataset_region": dataset_region,
+        }
+        expected_response = transfer_pb2.TransferConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        transfer_config = {}
+
+        response = client.create_transfer_config(parent, transfer_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.CreateTransferConfigRequest(
+            parent=parent, transfer_config=transfer_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_transfer_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        transfer_config = {}
+
+        with pytest.raises(CustomException):
+            client.create_transfer_config(parent, transfer_config)
+
+    def test_update_transfer_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        destination_dataset_id = "destinationDatasetId1541564179"
+        display_name = "displayName1615086568"
+        data_source_id = "dataSourceId-1015796374"
+        schedule = "schedule-697920873"
+        data_refresh_window_days = 327632845
+        disabled = True
+        user_id = 147132913
+        dataset_region = "datasetRegion959248539"
+        expected_response = {
+            "name": name,
+            "destination_dataset_id": destination_dataset_id,
+            "display_name": display_name,
+            "data_source_id": data_source_id,
+            "schedule": schedule,
+            "data_refresh_window_days": data_refresh_window_days,
+            "disabled": disabled,
+            "user_id": user_id,
+            "dataset_region": dataset_region,
+        }
+        expected_response = transfer_pb2.TransferConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        transfer_config = {}
+        update_mask = {}
+
+        response = client.update_transfer_config(transfer_config, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.UpdateTransferConfigRequest(
+            transfer_config=transfer_config, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_transfer_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        transfer_config = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_transfer_config(transfer_config, update_mask)
+
+    def test_delete_transfer_config(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        name = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+
+        client.delete_transfer_config(name)
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.DeleteTransferConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_transfer_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        name = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.delete_transfer_config(name)
+
+    def test_get_transfer_config(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        destination_dataset_id = "destinationDatasetId1541564179"
+        display_name = "displayName1615086568"
+        data_source_id = "dataSourceId-1015796374"
+        schedule = "schedule-697920873"
+        data_refresh_window_days = 327632845
+        disabled = True
+        user_id = 147132913
+        dataset_region = "datasetRegion959248539"
+        expected_response = {
+            "name": name_2,
+            "destination_dataset_id": destination_dataset_id,
+            "display_name": display_name,
+            "data_source_id": data_source_id,
+            "schedule": schedule,
+            "data_refresh_window_days": data_refresh_window_days,
+            "disabled": disabled,
+            "user_id": user_id,
+            "dataset_region": dataset_region,
+        }
+        expected_response = transfer_pb2.TransferConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        name = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+
+        response = client.get_transfer_config(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.GetTransferConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_transfer_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        name = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.get_transfer_config(name)
+
+    def test_list_transfer_configs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        transfer_configs_element = {}
+        transfer_configs = [transfer_configs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "transfer_configs": transfer_configs,
+        }
+        expected_response = datatransfer_pb2.ListTransferConfigsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_transfer_configs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.transfer_configs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.ListTransferConfigsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_transfer_configs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_transfer_configs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_schedule_transfer_runs(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datatransfer_pb2.ScheduleTransferRunsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        parent = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+        start_time = {}
+        end_time = {}
+
+        response = client.schedule_transfer_runs(parent, start_time, end_time)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.ScheduleTransferRunsRequest(
+            parent=parent, start_time=start_time, end_time=end_time
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_schedule_transfer_runs_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        parent = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+        start_time = {}
+        end_time = {}
+
+        with pytest.raises(CustomException):
+            client.schedule_transfer_runs(parent, start_time, end_time)
+
+    def test_get_transfer_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        destination_dataset_id = "destinationDatasetId1541564179"
+        data_source_id = "dataSourceId-1015796374"
+        user_id = 147132913
+        schedule = "schedule-697920873"
+        expected_response = {
+            "name": name_2,
+            "destination_dataset_id": destination_dataset_id,
+            "data_source_id": data_source_id,
+            "user_id": user_id,
+            "schedule": schedule,
+        }
+        expected_response = transfer_pb2.TransferRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        name = client.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
+
+        response = client.get_transfer_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.GetTransferRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_transfer_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        name = client.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
+
+        with pytest.raises(CustomException):
+            client.get_transfer_run(name)
+
+    def test_delete_transfer_run(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        name = client.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
+
+        client.delete_transfer_run(name)
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.DeleteTransferRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_transfer_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        name = client.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
+
+        with pytest.raises(CustomException):
+            client.delete_transfer_run(name)
+
+    def test_list_transfer_runs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        transfer_runs_element = {}
+        transfer_runs = [transfer_runs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "transfer_runs": transfer_runs,
+        }
+        expected_response = datatransfer_pb2.ListTransferRunsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        parent = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+
+        paged_list_response = client.list_transfer_runs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.transfer_runs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.ListTransferRunsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_transfer_runs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        parent = client.project_transfer_config_path("[PROJECT]", "[TRANSFER_CONFIG]")
+
+        paged_list_response = client.list_transfer_runs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_transfer_logs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        transfer_messages_element = {}
+        transfer_messages = [transfer_messages_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "transfer_messages": transfer_messages,
+        }
+        expected_response = datatransfer_pb2.ListTransferLogsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        parent = client.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
+
+        paged_list_response = client.list_transfer_logs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.transfer_messages[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.ListTransferLogsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_transfer_logs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        parent = client.project_run_path("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
+
+        paged_list_response = client.list_transfer_logs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_check_valid_creds(self):
+        # Setup Expected Response
+        has_valid_creds = False
+        expected_response = {"has_valid_creds": has_valid_creds}
+        expected_response = datatransfer_pb2.CheckValidCredsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup Request
+        name = client.project_data_source_path("[PROJECT]", "[DATA_SOURCE]")
+
+        response = client.check_valid_creds(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.CheckValidCredsRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_check_valid_creds_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        # Setup request
+        name = client.project_data_source_path("[PROJECT]", "[DATA_SOURCE]")
+
+        with pytest.raises(CustomException):
+            client.check_valid_creds(name)
+
+    def test_start_manual_transfer_runs(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datatransfer_pb2.StartManualTransferRunsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        response = client.start_manual_transfer_runs()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datatransfer_pb2.StartManualTransferRunsRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_start_manual_transfer_runs_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigquery_datatransfer_v1.DataTransferServiceClient()
+
+        with pytest.raises(CustomException):
+            client.start_manual_transfer_runs()
diff --git a/bigquery_datatransfer/tests/unit/test_shim.py b/bigquery_datatransfer/tests/unit/test_shim.py
new file mode 100644
index 000000000000..c27963bce4ab
--- /dev/null
+++ b/bigquery_datatransfer/tests/unit/test_shim.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests for versionless import."""
+
+
+def test_shim():
+    from google.cloud import bigquery_datatransfer
+    from google.cloud import bigquery_datatransfer_v1
+
+    assert bigquery_datatransfer.__all__ == bigquery_datatransfer_v1.__all__
+
+    for name in bigquery_datatransfer.__all__:
+        found = getattr(bigquery_datatransfer, name)
+        expected = getattr(bigquery_datatransfer_v1, name)
+        assert found is expected
diff --git a/bigquery_storage/.coveragerc b/bigquery_storage/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/bigquery_storage/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/bigquery_storage/.flake8 b/bigquery_storage/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/bigquery_storage/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/bigquery_storage/.gitignore b/bigquery_storage/.gitignore
new file mode 100644
index 000000000000..9e3a5f25770c
--- /dev/null
+++ b/bigquery_storage/.gitignore
@@ -0,0 +1 @@
+docs/_build
\ No newline at end of file
diff --git a/bigquery_storage/.repo-metadata.json b/bigquery_storage/.repo-metadata.json
new file mode 100644
index 000000000000..a7f9c207bb7c
--- /dev/null
+++ b/bigquery_storage/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "bigquerystorage",
+  "name_pretty": "Google BigQuery Storage",
+  "product_documentation": "https://cloud.google.com/bigquery/docs/reference/storage/",
+  "client_documentation": "https://googleapis.dev/python/bigquerystorage/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559654",
+  "release_level": "beta",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-bigquery-storage",
+  "api_id": "bigquerystorage.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/bigquery_storage/CHANGELOG.md b/bigquery_storage/CHANGELOG.md
new file mode 100644
index 000000000000..f2fb6237e2b6
--- /dev/null
+++ b/bigquery_storage/CHANGELOG.md
@@ -0,0 +1,140 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-bigquery-storage/#history
+
+## 0.7.0
+
+07-31-2019 17:48 PDT
+
+
+### New Features
+- Support faster Arrow data format in `to_dataframe` and `to_arrow` when using BigQuery Storage API. ([#8551](https://github.com/googleapis/google-cloud-python/pull/8551))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pins of 'googleapis-common-protos. ([#8688](https://github.com/googleapis/google-cloud-python/pull/8688))
+
+### Documentation
+- Update quickstart sample with data format and sharding options. ([#8665](https://github.com/googleapis/google-cloud-python/pull/8665))
+- Fix links to bigquery storage documentation. ([#8859](https://github.com/googleapis/google-cloud-python/pull/8859))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Pin black version. (via synth). ([#8672](https://github.com/googleapis/google-cloud-python/pull/8672))
+
+## 0.6.0
+
+07-11-2019 13:15 PDT
+
+### New Features
+
+- Add `to_arrow` with support for Arrow data format. ([#8644](https://github.com/googleapis/google-cloud-python/pull/8644))
+- Add 'client_options' support (via synth). ([#8536](https://github.com/googleapis/google-cloud-python/pull/8536))
+- Add sharding strategy, stream splitting, Arrow support (via synth). ([#8477](https://github.com/googleapis/google-cloud-python/pull/8477))
+
+### Documentation
+
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+### Internal / Testing Changes
+
+- Allow kwargs to be passed to create_channel (via synth). ([#8441](https://github.com/googleapis/google-cloud-python/pull/8441))
+- Add encoding declaration to protoc-generated files (via synth). ([#8345](https://github.com/googleapis/google-cloud-python/pull/8345))
+- Refactor `reader.ReadRowsPage` to use `_StreamParser`. ([#8262](https://github.com/googleapis/google-cloud-python/pull/8262))
+- Fix coverage in 'types.py' (via synth). ([#8148](https://github.com/googleapis/google-cloud-python/pull/8148))
+- Add empty lines, remove coverage exclusions (via synth). ([#8051](https://github.com/googleapis/google-cloud-python/pull/8051))
+
+## 0.5.0
+
+05-20-2019 09:23 PDT
+
+### Implementation Changes
+
+- Increase default deadline on ReadRows. ([#8030](https://github.com/googleapis/google-cloud-python/pull/8030))
+- Respect timeout on `client.read_rows`. Don't resume on `DEADLINE_EXCEEDED` errors. ([#8025](https://github.com/googleapis/google-cloud-python/pull/8025))
+
+### Documentation
+
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+
+## 0.4.0
+
+04-16-2019 13:46 PDT
+
+### Implementation Changes
+
+- Remove gRPC size limit in the transport options ([#7664](https://github.com/googleapis/google-cloud-python/pull/7664))
+- Add retry params for create_read_session (via synth). ([#7658](https://github.com/googleapis/google-cloud-python/pull/7658))
+
+### New Features
+
+- Add page iterator to ReadRowsStream ([#7680](https://github.com/googleapis/google-cloud-python/pull/7680))
+
+### Internal / Testing Changes
+
+- Remove system test for split rows ([#7673](https://github.com/googleapis/google-cloud-python/pull/7673))
+
+## 0.3.0
+
+04-02-2019 15:22 PDT
+
+### Dependencies
+
+- Add dependency for resource proto. ([#7585](https://github.com/googleapis/google-cloud-python/pull/7585))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### Documentation
+
+- Fix links to BigQuery Storage API docs ([#7647](https://github.com/googleapis/google-cloud-python/pull/7647))
+- Update proto / docstrings (via synth). ([#7461](https://github.com/googleapis/google-cloud-python/pull/7461))
+- googlecloudplatform --> googleapis in READMEs ([#7411](https://github.com/googleapis/google-cloud-python/pull/7411))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Blacken new quickstart snippet. ([#7242](https://github.com/googleapis/google-cloud-python/pull/7242))
+- Add quickstart demonstrating most BQ Storage API read features ([#7223](https://github.com/googleapis/google-cloud-python/pull/7223))
+- Add bigquery_storage to docs ([#7222](https://github.com/googleapis/google-cloud-python/pull/7222))
+
+### Internal / Testing Changes
+
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Copy lintified proto files (via synth). ([#7475](https://github.com/googleapis/google-cloud-python/pull/7475))
+- Add annotations to protocol buffers indicating request parameters (via synth). ([#7550](https://github.com/googleapis/google-cloud-python/pull/7550))
+
+## 0.2.0
+
+01-25-2019 13:54 PST
+
+### New Features
+
+- Add option to choose dtypes by column in to_dataframe. ([#7126](https://github.com/googleapis/google-cloud-python/pull/7126))
+
+### Internal / Testing Changes
+
+- Update copyright headers
+- Protoc-generated serialization update. ([#7076](https://github.com/googleapis/google-cloud-python/pull/7076))
+- BigQuery Storage: run 'blacken' during synth ([#7047](https://github.com/googleapis/google-cloud-python/pull/7047))
+
+## 0.1.1
+
+12-17-2018 18:03 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes in GAPIC generator. ([#6708](https://github.com/googleapis/google-cloud-python/pull/6708))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+### Internal / Testing Changes
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Correct release_status for bigquery_storage ([#6767](https://github.com/googleapis/google-cloud-python/pull/6767))
+
+## 0.1.0
+
+11-29-2018 13:45 PST
+
+- Initial release of BigQuery Storage API client.
+
diff --git a/bigquery_storage/LICENSE b/bigquery_storage/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/bigquery_storage/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/bigquery_storage/MANIFEST.in b/bigquery_storage/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/bigquery_storage/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/bigquery_storage/README.rst b/bigquery_storage/README.rst
new file mode 100644
index 000000000000..6b600ca0bd67
--- /dev/null
+++ b/bigquery_storage/README.rst
@@ -0,0 +1,102 @@
+Python Client for BigQuery Storage API (`Beta`_)
+=================================================
+
+
+
+`BigQuery Storage API`_:
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Beta: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _BigQuery Storage API: https://cloud.google.com/bigquery/docs/reference/storage/
+.. _Client Library Documentation: https://googleapis.dev/python/bigquerystorage/latest
+.. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/storage/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the BigQuery Storage API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the BigQuery Storage API.: https://console.cloud.google.com/apis/library/bigquerystorage.googleapis.com
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-bigquery-storage
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-bigquery-storage
+
+Optional Dependencies
+^^^^^^^^^^^^^^^^^^^^^
+
+Several features of ``google-cloud-bigquery-storage`` require additional
+dependencies.
+
+* Parse Avro blocks in a ``read_rows()`` stream using `fastavro
+  <https://fastavro.readthedocs.io/en/latest/>`_.
+
+  ``pip install google-cloud-bigquery-storage[fastavro]``
+
+* Write rows to a `pandas <http://pandas.pydata.org/pandas-docs/stable/>`_
+  dataframe.
+
+  ``pip install google-cloud-bigquery-storage[pandas,fastavro]``
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for BigQuery Storage API
+   API to see other available methods on the client.
+-  Read the `BigQuery Storage API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _BigQuery Storage API Product documentation:  https://cloud.google.com/bigquery/docs/reference/storage/
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/bigquery_storage/docs/README.rst b/bigquery_storage/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/bigquery_storage/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/bigquery_storage/docs/conf.py b/bigquery_storage/docs/conf.py
new file mode 100644
index 000000000000..9b93ad89594f
--- /dev/null
+++ b/bigquery_storage/docs/conf.py
@@ -0,0 +1,327 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-bigquerystorage documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = ".rst"
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-bigquerystorage"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+# html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-bigquerystorage-doc"
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-bigquerystorage.tex",
+        u"google-cloud-bigquerystorage Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-bigquerystorage",
+        u"google-cloud-bigquerystorage Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-bigquerystorage",
+        u"google-cloud-bigquerystorage Documentation",
+        author,
+        "google-cloud-bigquerystorage",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/bigquery_storage/docs/gapic/v1beta1/api.rst b/bigquery_storage/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..d4df98557e15
--- /dev/null
+++ b/bigquery_storage/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for BigQuery Storage API
+===============================
+
+.. automodule:: google.cloud.bigquery_storage_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/bigquery_storage/docs/gapic/v1beta1/reader.rst b/bigquery_storage/docs/gapic/v1beta1/reader.rst
new file mode 100644
index 000000000000..5b6af828f53e
--- /dev/null
+++ b/bigquery_storage/docs/gapic/v1beta1/reader.rst
@@ -0,0 +1,6 @@
+Reader for BigQuery Storage API
+===============================
+
+.. automodule:: google.cloud.bigquery_storage_v1beta1.reader
+    :members:
+    :inherited-members:
diff --git a/bigquery_storage/docs/gapic/v1beta1/types.rst b/bigquery_storage/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..a36210a64e52
--- /dev/null
+++ b/bigquery_storage/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for BigQuery Storage API Client
+=====================================
+
+.. automodule:: google.cloud.bigquery_storage_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/bigquery_storage/docs/index.rst b/bigquery_storage/docs/index.rst
new file mode 100644
index 000000000000..f34b0cfb4e5a
--- /dev/null
+++ b/bigquery_storage/docs/index.rst
@@ -0,0 +1,19 @@
+.. include:: README.rst
+
+API Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/reader
+    gapic/v1beta1/types
+
+Example Usage
+-------------
+
+.. literalinclude:: samples/quickstart.py
+   :language: python
+   :dedent: 4
+   :start-after: [START bigquerystorage_quickstart]
+   :end-before: [END bigquerystorage_quickstart]
diff --git a/bigquery_storage/docs/samples b/bigquery_storage/docs/samples
new file mode 120000
index 000000000000..e804737ed3a9
--- /dev/null
+++ b/bigquery_storage/docs/samples
@@ -0,0 +1 @@
+../samples
\ No newline at end of file
diff --git a/bigquery_storage/google/__init__.py b/bigquery_storage/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/bigquery_storage/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigquery_storage/google/cloud/__init__.py b/bigquery_storage/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/bigquery_storage/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigquery_storage/google/cloud/bigquery_storage.py b/bigquery_storage/google/cloud/bigquery_storage.py
new file mode 100644
index 000000000000..8613643ee25d
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.bigquery_storage_v1beta1 import BigQueryStorageClient
+from google.cloud.bigquery_storage_v1beta1 import enums
+from google.cloud.bigquery_storage_v1beta1 import types
+
+
+__all__ = ("enums", "types", "BigQueryStorageClient")
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/__init__.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/__init__.py
new file mode 100644
index 000000000000..e355a0f6b8a5
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/__init__.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import pkg_resources
+
+__version__ = pkg_resources.get_distribution(
+    "google-cloud-bigquery-storage"
+).version  # noqa
+
+from google.cloud.bigquery_storage_v1beta1 import types
+from google.cloud.bigquery_storage_v1beta1 import client
+from google.cloud.bigquery_storage_v1beta1.gapic import enums
+
+
+class BigQueryStorageClient(client.BigQueryStorageClient):
+    __doc__ = client.BigQueryStorageClient.__doc__
+    enums = enums
+
+
+__all__ = (
+    # google.cloud.bigquery_storage_v1beta1
+    "__version__",
+    "types",
+    # google.cloud.bigquery_storage_v1beta1.client
+    "BigQueryStorageClient",
+    # google.cloud.bigquery_storage_v1beta1.gapic
+    "enums",
+)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/client.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/client.py
new file mode 100644
index 000000000000..4f53a30550a8
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/client.py
@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Parent client for calling the Cloud BigQuery Storage API.
+
+This is the base from which all interactions with the API occur.
+"""
+
+from __future__ import absolute_import
+
+import google.api_core.gapic_v1.method
+
+from google.cloud.bigquery_storage_v1beta1 import reader
+from google.cloud.bigquery_storage_v1beta1.gapic import big_query_storage_client  # noqa
+
+
+_SCOPES = (
+    "https://www.googleapis.com/auth/bigquery",
+    "https://www.googleapis.com/auth/cloud-platform",
+)
+
+
+class BigQueryStorageClient(big_query_storage_client.BigQueryStorageClient):
+    """Client for interacting with BigQuery Storage API.
+
+    The BigQuery storage API can be used to read data stored in BigQuery.
+    """
+
+    def read_rows(
+        self,
+        read_position,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Reads rows from the table in the format prescribed by the read
+        session. Each response contains one or more table rows, up to a
+        maximum of 10 MiB per response; read requests which attempt to read
+        individual rows larger than this will fail.
+
+        Each request also returns a set of stream statistics reflecting the
+        estimated total number of rows in the read stream. This number is
+        computed based on the total table size and the number of active
+        streams in the read session, and may change as other streams continue
+        to read data.
+
+        Example:
+            >>> from google.cloud import bigquery_storage_v1beta1
+            >>>
+            >>> client = bigquery_storage_v1beta1.BigQueryStorageClient()
+            >>>
+            >>> # TODO: Initialize ``table_reference``:
+            >>> table_reference = {
+            ...     'project_id': 'your-data-project-id',
+            ...     'dataset_id': 'your_dataset_id',
+            ...     'table_id': 'your_table_id',
+            ... }
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = 'projects/your-billing-project-id'
+            >>>
+            >>> session = client.create_read_session(table_reference, parent)
+            >>> read_position = bigquery_storage_v1beta1.types.StreamPosition(
+            ...     stream=session.streams[0],  # TODO: Read the other streams.
+            ... )
+            >>>
+            >>> for element in client.read_rows(read_position):
+            ...     # process element
+            ...     pass
+
+        Args:
+            read_position (Union[ \
+                dict, \
+                ~google.cloud.bigquery_storage_v1beta1.types.StreamPosition \
+            ]):
+                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. If a dict is provided, it must be of the same form
+                as the protobuf message
+                :class:`~google.cloud.bigquery_storage_v1beta1.types.StreamPosition`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            ~google.cloud.bigquery_storage_v1beta1.reader.ReadRowsStream:
+                An iterable of
+                :class:`~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse`.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        gapic_client = super(BigQueryStorageClient, self)
+        stream = gapic_client.read_rows(
+            read_position, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return reader.ReadRowsStream(
+            stream,
+            gapic_client,
+            read_position,
+            {"retry": retry, "timeout": timeout, "metadata": metadata},
+        )
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/__init__.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py
new file mode 100644
index 000000000000..e44e74830031
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py
@@ -0,0 +1,671 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.bigquery.storage.v1beta1 BigQueryStorage API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.path_template
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.bigquery_storage_v1beta1.gapic import big_query_storage_client_config
+from google.cloud.bigquery_storage_v1beta1.gapic import enums
+from google.cloud.bigquery_storage_v1beta1.gapic.transports import (
+    big_query_storage_grpc_transport,
+)
+from google.cloud.bigquery_storage_v1beta1.proto import read_options_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import storage_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import storage_pb2_grpc
+from google.cloud.bigquery_storage_v1beta1.proto import table_reference_pb2
+from google.protobuf import empty_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-bigquery-storage"
+).version
+
+
+class BigQueryStorageClient(object):
+    """
+    BigQuery storage API.
+
+    The BigQuery storage API can be used to read data stored in BigQuery.
+    """
+
+    SERVICE_ADDRESS = "bigquerystorage.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.bigquery.storage.v1beta1.BigQueryStorage"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            BigQueryStorageClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.BigQueryStorageGrpcTransport,
+                    Callable[[~.Credentials, type], ~.BigQueryStorageGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = big_query_storage_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:  # pragma: no cover
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=big_query_storage_grpc_transport.BigQueryStorageGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = big_query_storage_grpc_transport.BigQueryStorageGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_read_session(
+        self,
+        table_reference,
+        parent,
+        table_modifiers=None,
+        requested_streams=None,
+        read_options=None,
+        format_=None,
+        sharding_strategy=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Read sessions automatically expire 24 hours after they are created and do
+        not require manual clean-up by the caller.
+
+        Example:
+            >>> from google.cloud import bigquery_storage_v1beta1
+            >>>
+            >>> client = bigquery_storage_v1beta1.BigQueryStorageClient()
+            >>>
+            >>> # TODO: Initialize `table_reference`:
+            >>> table_reference = {}
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> response = client.create_read_session(table_reference, parent)
+
+        Args:
+            table_reference (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.TableReference]): Required. Reference to the table to read.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.TableReference`
+            parent (str): 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.
+            table_modifiers (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.TableModifiers]): Optional. Any modifiers to the Table (e.g. snapshot timestamp).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.TableModifiers`
+            requested_streams (int): Optional. 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
+                the maximum amount of parallelism allowed by the system.
+
+                Streams must be read starting from offset 0.
+            read_options (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.TableReadOptions]): Optional. Read options for this session (e.g. column selection, filters).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.TableReadOptions`
+            format_ (~google.cloud.bigquery_storage_v1beta1.types.DataFormat): Data output format. Currently default to Avro.
+            sharding_strategy (~google.cloud.bigquery_storage_v1beta1.types.ShardingStrategy): The strategy to use for distributing data among multiple streams. Currently
+                defaults to liquid sharding.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_storage_v1beta1.types.ReadSession` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_read_session" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_read_session"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_read_session,
+                default_retry=self._method_configs["CreateReadSession"].retry,
+                default_timeout=self._method_configs["CreateReadSession"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = storage_pb2.CreateReadSessionRequest(
+            table_reference=table_reference,
+            parent=parent,
+            table_modifiers=table_modifiers,
+            requested_streams=requested_streams,
+            read_options=read_options,
+            format=format_,
+            sharding_strategy=sharding_strategy,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [
+                ("table_reference.project_id", table_reference.project_id),
+                ("table_reference.dataset_id", table_reference.dataset_id),
+            ]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)  # pragma: no cover
+
+        return self._inner_api_calls["create_read_session"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def read_rows(
+        self,
+        read_position,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Reads rows from the table in the format prescribed by the read session.
+        Each response contains one or more table rows, up to a maximum of 10 MiB
+        per response; read requests which attempt to read individual rows larger
+        than this will fail.
+
+        Each request also returns a set of stream statistics reflecting the
+        estimated total number of rows in the read stream. This number is computed
+        based on the total table size and the number of active streams in the read
+        session, and may change as other streams continue to read data.
+
+        Example:
+            >>> from google.cloud import bigquery_storage_v1beta1
+            >>>
+            >>> client = bigquery_storage_v1beta1.BigQueryStorageClient()
+            >>>
+            >>> # TODO: Initialize `read_position`:
+            >>> read_position = {}
+            >>>
+            >>> for element in client.read_rows(read_position):
+            ...     # process element
+            ...     pass
+
+        Args:
+            read_position (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.StreamPosition]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.StreamPosition`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "read_rows" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "read_rows"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.read_rows,
+                default_retry=self._method_configs["ReadRows"].retry,
+                default_timeout=self._method_configs["ReadRows"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = storage_pb2.ReadRowsRequest(read_position=read_position)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("read_position.stream.name", read_position.stream.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)  # pragma: no cover
+
+        return self._inner_api_calls["read_rows"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_create_read_session_streams(
+        self,
+        session,
+        requested_streams,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates additional streams for a ReadSession. This API can be used to
+        dynamically adjust the parallelism of a batch processing task upwards by
+        adding additional workers.
+
+        Example:
+            >>> from google.cloud import bigquery_storage_v1beta1
+            >>>
+            >>> client = bigquery_storage_v1beta1.BigQueryStorageClient()
+            >>>
+            >>> # TODO: Initialize `session`:
+            >>> session = {}
+            >>>
+            >>> # TODO: Initialize `requested_streams`:
+            >>> requested_streams = 0
+            >>>
+            >>> response = client.batch_create_read_session_streams(session, requested_streams)
+
+        Args:
+            session (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.ReadSession]): Required. Must be a non-expired session obtained from a call to
+                CreateReadSession. Only the name field needs to be set.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.ReadSession`
+            requested_streams (int): Required. Number of new streams requested. Must be positive.
+                Number of added streams may be less than this, see CreateReadSessionRequest
+                for more information.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_storage_v1beta1.types.BatchCreateReadSessionStreamsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_create_read_session_streams" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_create_read_session_streams"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_create_read_session_streams,
+                default_retry=self._method_configs[
+                    "BatchCreateReadSessionStreams"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "BatchCreateReadSessionStreams"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = storage_pb2.BatchCreateReadSessionStreamsRequest(
+            session=session, requested_streams=requested_streams
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session.name", session.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)  # pragma: no cover
+
+        return self._inner_api_calls["batch_create_read_session_streams"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def finalize_stream(
+        self,
+        stream,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Triggers the graceful termination of a single stream in a ReadSession. This
+        API can be used to dynamically adjust the parallelism of a batch processing
+        task downwards without losing data.
+
+        This API does not delete the stream -- it remains visible in the
+        ReadSession, and any data processed by the stream is not released to other
+        streams. However, no additional data will be assigned to the stream once
+        this call completes. Callers must continue reading data on the stream until
+        the end of the stream is reached so that data which has already been
+        assigned to the stream will be processed.
+
+        This method will return an error if there are no other live streams
+        in the Session, or if SplitReadStream() has been called on the given
+        Stream.
+
+        Example:
+            >>> from google.cloud import bigquery_storage_v1beta1
+            >>>
+            >>> client = bigquery_storage_v1beta1.BigQueryStorageClient()
+            >>>
+            >>> # TODO: Initialize `stream`:
+            >>> stream = {}
+            >>>
+            >>> client.finalize_stream(stream)
+
+        Args:
+            stream (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.Stream]): Stream to finalize.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.Stream`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "finalize_stream" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "finalize_stream"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.finalize_stream,
+                default_retry=self._method_configs["FinalizeStream"].retry,
+                default_timeout=self._method_configs["FinalizeStream"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = storage_pb2.FinalizeStreamRequest(stream=stream)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("stream.name", stream.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)  # pragma: no cover
+
+        self._inner_api_calls["finalize_stream"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def split_read_stream(
+        self,
+        original_stream,
+        fraction=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Splits a given read stream into two Streams. These streams are referred
+        to as the primary and the residual of the split. The original stream can
+        still be read from in the same manner as before. Both of the returned
+        streams can also be read from, and the total rows return 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 Stream. 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.
+
+        This method is guaranteed to be idempotent.
+
+        Example:
+            >>> from google.cloud import bigquery_storage_v1beta1
+            >>>
+            >>> client = bigquery_storage_v1beta1.BigQueryStorageClient()
+            >>>
+            >>> # TODO: Initialize `original_stream`:
+            >>> original_stream = {}
+            >>>
+            >>> response = client.split_read_stream(original_stream)
+
+        Args:
+            original_stream (Union[dict, ~google.cloud.bigquery_storage_v1beta1.types.Stream]): Stream to split.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigquery_storage_v1beta1.types.Stream`
+            fraction (float): 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 to a data storage boundary on the server side.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigquery_storage_v1beta1.types.SplitReadStreamResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "split_read_stream" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "split_read_stream"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.split_read_stream,
+                default_retry=self._method_configs["SplitReadStream"].retry,
+                default_timeout=self._method_configs["SplitReadStream"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = storage_pb2.SplitReadStreamRequest(
+            original_stream=original_stream, fraction=fraction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("original_stream.name", original_stream.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)  # pragma: no cover
+
+        return self._inner_api_calls["split_read_stream"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client_config.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client_config.py
new file mode 100644
index 000000000000..e33b166f703b
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client_config.py
@@ -0,0 +1,67 @@
+config = {
+    "interfaces": {
+        "google.cloud.bigquery.storage.v1beta1.BigQueryStorage": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+                "unary_streaming": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                },
+                "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.0,
+                    "max_rpc_timeout_millis": 86400000,
+                    "total_timeout_millis": 86400000,
+                },
+            },
+            "methods": {
+                "CreateReadSession": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "create_read_session",
+                },
+                "ReadRows": {
+                    "timeout_millis": 86400000,
+                    "retry_codes_name": "unary_streaming",
+                    "retry_params_name": "read_rows",
+                },
+                "BatchCreateReadSessionStreams": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "FinalizeStream": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SplitReadStream": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/enums.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..bb3b3b7601c9
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/enums.py
@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class DataFormat(enum.IntEnum):
+    """
+    Data format for input or output data.
+
+    Attributes:
+      DATA_FORMAT_UNSPECIFIED (int): Data format is unspecified.
+      AVRO (int): Avro is a standard open source row based file format.
+      See https://avro.apache.org/ for more details.
+      ARROW (int)
+    """
+
+    DATA_FORMAT_UNSPECIFIED = 0
+    AVRO = 1
+    ARROW = 3
+
+
+class ShardingStrategy(enum.IntEnum):
+    """
+    Strategy for distributing data among multiple streams in a read session.
+
+    Attributes:
+      SHARDING_STRATEGY_UNSPECIFIED (int): Same as LIQUID.
+      LIQUID (int): Assigns data to each stream based on the client's read rate. The faster the
+      client reads from a stream, the more data is assigned to the stream. In
+      this strategy, it's possible to read all data from a single stream even if
+      there are other streams present.
+      BALANCED (int): Assigns data 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-filtering rows, so some filters can lead to lopsided
+      assignments.
+    """
+
+    SHARDING_STRATEGY_UNSPECIFIED = 0
+    LIQUID = 1
+    BALANCED = 2
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/transports/__init__.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/transports/big_query_storage_grpc_transport.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/transports/big_query_storage_grpc_transport.py
new file mode 100644
index 000000000000..bf3b8b6f5b24
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/gapic/transports/big_query_storage_grpc_transport.py
@@ -0,0 +1,225 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.bigquery_storage_v1beta1.proto import storage_pb2_grpc
+
+
+class BigQueryStorageGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.bigquery.storage.v1beta1 BigQueryStorage API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/bigquery",
+        "https://www.googleapis.com/auth/cloud-platform",
+    )
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="bigquerystorage.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:  # pragma: no cover
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:  # pragma: no cover
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "big_query_storage_stub": storage_pb2_grpc.BigQueryStorageStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="bigquerystorage.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(  # pragma: no cover
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_read_session(self):
+        """Return the gRPC stub for :meth:`BigQueryStorageClient.create_read_session`.
+
+        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.
+
+        Read sessions automatically expire 24 hours after they are created and do
+        not require manual clean-up by the caller.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["big_query_storage_stub"].CreateReadSession
+
+    @property
+    def read_rows(self):
+        """Return the gRPC stub for :meth:`BigQueryStorageClient.read_rows`.
+
+        Reads rows from the table in the format prescribed by the read session.
+        Each response contains one or more table rows, up to a maximum of 10 MiB
+        per response; read requests which attempt to read individual rows larger
+        than this will fail.
+
+        Each request also returns a set of stream statistics reflecting the
+        estimated total number of rows in the read stream. This number is computed
+        based on the total table size and the number of active streams in the read
+        session, and may change as other streams continue to read data.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["big_query_storage_stub"].ReadRows
+
+    @property
+    def batch_create_read_session_streams(self):
+        """Return the gRPC stub for :meth:`BigQueryStorageClient.batch_create_read_session_streams`.
+
+        Creates additional streams for a ReadSession. This API can be used to
+        dynamically adjust the parallelism of a batch processing task upwards by
+        adding additional workers.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["big_query_storage_stub"].BatchCreateReadSessionStreams
+
+    @property
+    def finalize_stream(self):
+        """Return the gRPC stub for :meth:`BigQueryStorageClient.finalize_stream`.
+
+        Triggers the graceful termination of a single stream in a ReadSession. This
+        API can be used to dynamically adjust the parallelism of a batch processing
+        task downwards without losing data.
+
+        This API does not delete the stream -- it remains visible in the
+        ReadSession, and any data processed by the stream is not released to other
+        streams. However, no additional data will be assigned to the stream once
+        this call completes. Callers must continue reading data on the stream until
+        the end of the stream is reached so that data which has already been
+        assigned to the stream will be processed.
+
+        This method will return an error if there are no other live streams
+        in the Session, or if SplitReadStream() has been called on the given
+        Stream.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["big_query_storage_stub"].FinalizeStream
+
+    @property
+    def split_read_stream(self):
+        """Return the gRPC stub for :meth:`BigQueryStorageClient.split_read_stream`.
+
+        Splits a given read stream into two Streams. These streams are referred
+        to as the primary and the residual of the split. The original stream can
+        still be read from in the same manner as before. Both of the returned
+        streams can also be read from, and the total rows return 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 Stream. 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.
+
+        This method is guaranteed to be idempotent.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["big_query_storage_stub"].SplitReadStream
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/__init__.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow.proto
new file mode 100644
index 000000000000..3003de444c2d
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow.proto
@@ -0,0 +1,37 @@
+// 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.v1beta1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage";
+option java_outer_classname = "ArrowProto";
+option java_package = "com.google.cloud.bigquery.storage.v1beta1";
+
+// Arrow schema.
+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 the returning block.
+  int64 row_count = 2;
+}
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow_pb2.py
new file mode 100644
index 000000000000..4d7d90afaf9e
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow_pb2.py
@@ -0,0 +1,170 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/storage_v1beta1/proto/arrow.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/storage_v1beta1/proto/arrow.proto",
+    package="google.cloud.bigquery.storage.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.storage.v1beta1B\nArrowProtoZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/bigquery/storage_v1beta1/proto/arrow.proto\x12%google.cloud.bigquery.storage.v1beta1"(\n\x0b\x41rrowSchema\x12\x19\n\x11serialized_schema\x18\x01 \x01(\x0c"F\n\x10\x41rrowRecordBatch\x12\x1f\n\x17serialized_record_batch\x18\x01 \x01(\x0c\x12\x11\n\trow_count\x18\x02 \x01(\x03\x42\x85\x01\n)com.google.cloud.bigquery.storage.v1beta1B\nArrowProtoZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storageb\x06proto3'
+    ),
+)
+
+
+_ARROWSCHEMA = _descriptor.Descriptor(
+    name="ArrowSchema",
+    full_name="google.cloud.bigquery.storage.v1beta1.ArrowSchema",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="serialized_schema",
+            full_name="google.cloud.bigquery.storage.v1beta1.ArrowSchema.serialized_schema",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=98,
+    serialized_end=138,
+)
+
+
+_ARROWRECORDBATCH = _descriptor.Descriptor(
+    name="ArrowRecordBatch",
+    full_name="google.cloud.bigquery.storage.v1beta1.ArrowRecordBatch",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="serialized_record_batch",
+            full_name="google.cloud.bigquery.storage.v1beta1.ArrowRecordBatch.serialized_record_batch",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_count",
+            full_name="google.cloud.bigquery.storage.v1beta1.ArrowRecordBatch.row_count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=140,
+    serialized_end=210,
+)
+
+DESCRIPTOR.message_types_by_name["ArrowSchema"] = _ARROWSCHEMA
+DESCRIPTOR.message_types_by_name["ArrowRecordBatch"] = _ARROWRECORDBATCH
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ArrowSchema = _reflection.GeneratedProtocolMessageType(
+    "ArrowSchema",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARROWSCHEMA,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.arrow_pb2",
+        __doc__="""Arrow schema.
+  
+  
+  Attributes:
+      serialized_schema:
+          IPC serialized Arrow schema.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.ArrowSchema)
+    ),
+)
+_sym_db.RegisterMessage(ArrowSchema)
+
+ArrowRecordBatch = _reflection.GeneratedProtocolMessageType(
+    "ArrowRecordBatch",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARROWRECORDBATCH,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.arrow_pb2",
+        __doc__="""Arrow RecordBatch.
+  
+  
+  Attributes:
+      serialized_record_batch:
+          IPC serialized Arrow RecordBatch.
+      row_count:
+          The count of rows in the returning block.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.ArrowRecordBatch)
+    ),
+)
+_sym_db.RegisterMessage(ArrowRecordBatch)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow_pb2_grpc.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/arrow_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro.proto
new file mode 100644
index 000000000000..021d8e44f9f2
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro.proto
@@ -0,0 +1,38 @@
+// 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.v1beta1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage";
+option java_outer_classname = "AvroProto";
+option java_package = "com.google.cloud.bigquery.storage.v1beta1";
+
+// 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/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro_pb2.py
new file mode 100644
index 000000000000..1f5ee11d4022
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro_pb2.py
@@ -0,0 +1,171 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/storage_v1beta1/proto/avro.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/storage_v1beta1/proto/avro.proto",
+    package="google.cloud.bigquery.storage.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.storage.v1beta1B\tAvroProtoZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/bigquery/storage_v1beta1/proto/avro.proto\x12%google.cloud.bigquery.storage.v1beta1"\x1c\n\nAvroSchema\x12\x0e\n\x06schema\x18\x01 \x01(\t"=\n\x08\x41vroRows\x12\x1e\n\x16serialized_binary_rows\x18\x01 \x01(\x0c\x12\x11\n\trow_count\x18\x02 \x01(\x03\x42\x84\x01\n)com.google.cloud.bigquery.storage.v1beta1B\tAvroProtoZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storageb\x06proto3'
+    ),
+)
+
+
+_AVROSCHEMA = _descriptor.Descriptor(
+    name="AvroSchema",
+    full_name="google.cloud.bigquery.storage.v1beta1.AvroSchema",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schema",
+            full_name="google.cloud.bigquery.storage.v1beta1.AvroSchema.schema",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=97,
+    serialized_end=125,
+)
+
+
+_AVROROWS = _descriptor.Descriptor(
+    name="AvroRows",
+    full_name="google.cloud.bigquery.storage.v1beta1.AvroRows",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="serialized_binary_rows",
+            full_name="google.cloud.bigquery.storage.v1beta1.AvroRows.serialized_binary_rows",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_count",
+            full_name="google.cloud.bigquery.storage.v1beta1.AvroRows.row_count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=127,
+    serialized_end=188,
+)
+
+DESCRIPTOR.message_types_by_name["AvroSchema"] = _AVROSCHEMA
+DESCRIPTOR.message_types_by_name["AvroRows"] = _AVROROWS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AvroSchema = _reflection.GeneratedProtocolMessageType(
+    "AvroSchema",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AVROSCHEMA,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.avro_pb2",
+        __doc__="""Avro schema.
+  
+  
+  Attributes:
+      schema:
+          Json serialized schema, as described at
+          https://avro.apache.org/docs/1.8.1/spec.html
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.AvroSchema)
+    ),
+)
+_sym_db.RegisterMessage(AvroSchema)
+
+AvroRows = _reflection.GeneratedProtocolMessageType(
+    "AvroRows",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AVROROWS,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.avro_pb2",
+        __doc__="""Avro rows.
+  
+  
+  Attributes:
+      serialized_binary_rows:
+          Binary serialized rows in a block.
+      row_count:
+          The count of rows in the returning block.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.AvroRows)
+    ),
+)
+_sym_db.RegisterMessage(AvroRows)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro_pb2_grpc.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/avro_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options.proto
new file mode 100644
index 000000000000..9591deba7f47
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options.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.v1beta1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage";
+option java_package = "com.google.cloud.bigquery.storage.v1beta1";
+
+// Options dictating how we read a table.
+message TableReadOptions {
+  // Optional. 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;
+
+  // 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.
+  //
+  // 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;
+}
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py
new file mode 100644
index 000000000000..7291232de3c5
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/storage_v1beta1/proto/read_options.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/storage_v1beta1/proto/read_options.proto",
+    package="google.cloud.bigquery.storage.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.storage.v1beta1ZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"
+    ),
+    serialized_pb=_b(
+        '\n>google/cloud/bigquery/storage_v1beta1/proto/read_options.proto\x12%google.cloud.bigquery.storage.v1beta1"D\n\x10TableReadOptions\x12\x17\n\x0fselected_fields\x18\x01 \x03(\t\x12\x17\n\x0frow_restriction\x18\x02 \x01(\tBy\n)com.google.cloud.bigquery.storage.v1beta1ZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storageb\x06proto3'
+    ),
+)
+
+
+_TABLEREADOPTIONS = _descriptor.Descriptor(
+    name="TableReadOptions",
+    full_name="google.cloud.bigquery.storage.v1beta1.TableReadOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="selected_fields",
+            full_name="google.cloud.bigquery.storage.v1beta1.TableReadOptions.selected_fields",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_restriction",
+            full_name="google.cloud.bigquery.storage.v1beta1.TableReadOptions.row_restriction",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=105,
+    serialized_end=173,
+)
+
+DESCRIPTOR.message_types_by_name["TableReadOptions"] = _TABLEREADOPTIONS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TableReadOptions = _reflection.GeneratedProtocolMessageType(
+    "TableReadOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLEREADOPTIONS,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.read_options_pb2",
+        __doc__="""Options dictating how we read a table.
+  
+  
+  Attributes:
+      selected_fields:
+          Optional. 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.
+      row_restriction:
+          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.  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"
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.TableReadOptions)
+    ),
+)
+_sym_db.RegisterMessage(TableReadOptions)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2_grpc.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/read_options_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage.proto
new file mode 100644
index 000000000000..fa2de616d4f7
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage.proto
@@ -0,0 +1,362 @@
+// 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.v1beta1;
+
+import "google/api/annotations.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";
+
+// BigQuery storage API.
+//
+// The BigQuery storage API can be used to read data stored in BigQuery.
+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/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.
+  //
+  // 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: "/v1beta1/{table_reference.project_id=projects/*}"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{table_reference.dataset_id=projects/*/datasets/*}"
+        body: "*"
+      }
+    };
+  }
+
+  // Reads rows from the table in the format prescribed by the read session.
+  // Each response contains one or more table rows, up to a maximum of 10 MiB
+  // per response; read requests which attempt to read individual rows larger
+  // than this will fail.
+  //
+  // Each request also returns a set of stream statistics reflecting the
+  // estimated total number of rows in the read stream. This number is computed
+  // based on the total table size and the number of active streams in the read
+  // session, and may change as other streams continue to read data.
+  rpc ReadRows(ReadRowsRequest) returns (stream ReadRowsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{read_position.stream.name=projects/*/streams/*}"
+    };
+  }
+
+  // Creates additional streams for a ReadSession. This API can be used to
+  // dynamically adjust the parallelism of a batch processing task upwards by
+  // adding additional workers.
+  rpc BatchCreateReadSessionStreams(BatchCreateReadSessionStreamsRequest) returns (BatchCreateReadSessionStreamsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{session.name=projects/*/sessions/*}"
+      body: "*"
+    };
+  }
+
+  // Triggers the graceful termination of a single stream in a ReadSession. This
+  // API can be used to dynamically adjust the parallelism of a batch processing
+  // task downwards without losing data.
+  //
+  // This API does not delete the stream -- it remains visible in the
+  // ReadSession, and any data processed by the stream is not released to other
+  // streams. However, no additional data will be assigned to the stream once
+  // this call completes. Callers must continue reading data on the stream until
+  // the end of the stream is reached so that data which has already been
+  // assigned to the stream will be processed.
+  //
+  // This method will return an error if there are no other live streams
+  // in the Session, or if SplitReadStream() has been called on the given
+  // Stream.
+  rpc FinalizeStream(FinalizeStreamRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1beta1/{stream.name=projects/*/streams/*}"
+      body: "*"
+    };
+  }
+
+  // Splits a given read stream into two Streams. These streams are referred to
+  // as the primary and the residual of the split. The original stream can still
+  // be read from in the same manner as before. Both of the returned streams can
+  // also be read from, and the total rows return 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 Stream. 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.
+  //
+  // This method is guaranteed to be idempotent.
+  rpc SplitReadStream(SplitReadStreamRequest) returns (SplitReadStreamResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{original_stream.name=projects/*/streams/*}"
+    };
+  }
+}
+
+// Information about a single data stream within a read session.
+message Stream {
+  // Name of the stream, in the form
+  // `projects/{project_id}/locations/{location}/streams/{stream_id}`.
+  string name = 1;
+}
+
+// Expresses a point within a given stream using an offset position.
+message StreamPosition {
+  // Identifier for a given Stream.
+  Stream stream = 1;
+
+  // Position in the stream.
+  int64 offset = 2;
+}
+
+// Information returned from a `CreateReadSession` request.
+message ReadSession {
+  // Unique identifier for the session, in the form
+  // `projects/{project_id}/locations/{location}/sessions/{session_id}`.
+  string name = 1;
+
+  // Time at which the session becomes invalid. After this time, subsequent
+  // requests to read this Session will return errors.
+  google.protobuf.Timestamp expire_time = 2;
+
+  // 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 {
+    // Avro schema.
+    AvroSchema avro_schema = 5;
+
+    // Arrow schema.
+    ArrowSchema arrow_schema = 6;
+  }
+
+  // Streams associated with this session.
+  repeated Stream streams = 4;
+
+  // Table that this ReadSession is reading from.
+  TableReference table_reference = 7;
+
+  // Any modifiers which are applied when reading from the specified table.
+  TableModifiers table_modifiers = 8;
+
+  // The strategy to use for distributing data among the streams.
+  ShardingStrategy sharding_strategy = 9;
+}
+
+// Creates a new read session, which may include additional options such as
+// requested parallelism, projection filters and constraints.
+message CreateReadSessionRequest {
+  // Required. Reference to the table to read.
+  TableReference table_reference = 1;
+
+  // 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).
+  TableModifiers table_modifiers = 2;
+
+  // Optional. 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
+  // the maximum amount of parallelism allowed by the system.
+  //
+  // Streams must be read starting from offset 0.
+  int32 requested_streams = 3;
+
+  // Optional. Read options for this session (e.g. column selection, filters).
+  TableReadOptions read_options = 4;
+
+  // Data output format. Currently default to Avro.
+  DataFormat format = 5;
+
+  // The strategy to use for distributing data among multiple streams. Currently
+  // defaults to liquid sharding.
+  ShardingStrategy sharding_strategy = 7;
+}
+
+// Data format for input or output data.
+enum DataFormat {
+  // Data format is unspecified.
+  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 = 3;
+}
+
+// Strategy for distributing data among multiple streams in a read session.
+enum ShardingStrategy {
+  // Same as LIQUID.
+  SHARDING_STRATEGY_UNSPECIFIED = 0;
+
+  // Assigns data to each stream based on the client's read rate. The faster the
+  // client reads from a stream, the more data is assigned to the stream. In
+  // this strategy, it's possible to read all data from a single stream even if
+  // there are other streams present.
+  LIQUID = 1;
+
+  // Assigns data 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-filtering rows, so some filters can lead to lopsided
+  // assignments.
+  BALANCED = 2;
+}
+
+// Requesting row data via `ReadRows` must provide Stream position information.
+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;
+}
+
+// Progress information for a given Stream.
+message StreamStatus {
+  // Number of estimated rows in the current stream. May change over time as
+  // different readers in the stream progress at rates which are relatively fast
+  // or slow.
+  int64 estimated_row_count = 1;
+
+  // A value in the range [0.0, 1.0] that represents the fraction of rows
+  // assigned to this stream that have been processed by the server. In the
+  // presence of read filters, the server may process more rows than it returns,
+  // so this value reflects progress through the pre-filtering rows.
+  //
+  // This value is only populated for sessions created through the BALANCED
+  // sharding strategy.
+  float fraction_consumed = 2;
+
+  // 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
+  // at that point or beyond. For small tables or streams that are the result of
+  // a chain of splits, this value may never be true.
+  bool is_splittable = 3;
+}
+
+// Information on if the current connection is being throttled.
+message ThrottleStatus {
+  // How much this connection is being throttled.
+  // 0 is no throttling, 100 is completely throttled.
+  int32 throttle_percent = 1;
+}
+
+// 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. This value is recorded here,
+  // in addition to the row_count values in the output-specific messages in
+  // `rows`, so that code which needs to record progress through the stream can
+  // do so in an output format-independent way.
+  int64 row_count = 6;
+
+  // Estimated stream statistics.
+  StreamStatus status = 2;
+
+  // Throttling status. If unset, the latest response still describes
+  // the current throttling status.
+  ThrottleStatus throttle_status = 5;
+}
+
+// Information needed to request additional streams for an established read
+// session.
+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;
+
+  // 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;
+}
+
+// The response from `BatchCreateReadSessionStreams` returns the stream
+// identifiers for the newly created streams.
+message BatchCreateReadSessionStreamsResponse {
+  // Newly added streams.
+  repeated Stream streams = 1;
+}
+
+// Request information for invoking `FinalizeStream`.
+message FinalizeStreamRequest {
+  // Stream to finalize.
+  Stream stream = 2;
+}
+
+// Request information for `SplitReadStream`.
+message SplitReadStreamRequest {
+  // Stream to split.
+  Stream original_stream = 1;
+
+  // 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 to a data storage boundary on the server side.
+  float fraction = 2;
+}
+
+// Response from `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.
+  Stream 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.
+  Stream remainder_stream = 2;
+}
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py
new file mode 100644
index 000000000000..ec546f3f9e81
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py
@@ -0,0 +1,1589 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/storage_v1beta1/proto/storage.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigquery_storage_v1beta1.proto import (
+    arrow_pb2 as google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_arrow__pb2,
+)
+from google.cloud.bigquery_storage_v1beta1.proto import (
+    avro_pb2 as google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_avro__pb2,
+)
+from google.cloud.bigquery_storage_v1beta1.proto import (
+    read_options_pb2 as google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_read__options__pb2,
+)
+from google.cloud.bigquery_storage_v1beta1.proto import (
+    table_reference_pb2 as google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_table__reference__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/storage_v1beta1/proto/storage.proto",
+    package="google.cloud.bigquery.storage.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.storage.v1beta1ZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/bigquery/storage_v1beta1/proto/storage.proto\x12%google.cloud.bigquery.storage.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x37google/cloud/bigquery/storage_v1beta1/proto/arrow.proto\x1a\x36google/cloud/bigquery/storage_v1beta1/proto/avro.proto\x1a>google/cloud/bigquery/storage_v1beta1/proto/read_options.proto\x1a\x41google/cloud/bigquery/storage_v1beta1/proto/table_reference.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/api/client.proto"\x16\n\x06Stream\x12\x0c\n\x04name\x18\x01 \x01(\t"_\n\x0eStreamPosition\x12=\n\x06stream\x18\x01 \x01(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream\x12\x0e\n\x06offset\x18\x02 \x01(\x03"\xa0\x04\n\x0bReadSession\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12H\n\x0b\x61vro_schema\x18\x05 \x01(\x0b\x32\x31.google.cloud.bigquery.storage.v1beta1.AvroSchemaH\x00\x12J\n\x0c\x61rrow_schema\x18\x06 \x01(\x0b\x32\x32.google.cloud.bigquery.storage.v1beta1.ArrowSchemaH\x00\x12>\n\x07streams\x18\x04 \x03(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream\x12N\n\x0ftable_reference\x18\x07 \x01(\x0b\x32\x35.google.cloud.bigquery.storage.v1beta1.TableReference\x12N\n\x0ftable_modifiers\x18\x08 \x01(\x0b\x32\x35.google.cloud.bigquery.storage.v1beta1.TableModifiers\x12R\n\x11sharding_strategy\x18\t \x01(\x0e\x32\x37.google.cloud.bigquery.storage.v1beta1.ShardingStrategyB\x08\n\x06schema"\xcb\x03\n\x18\x43reateReadSessionRequest\x12N\n\x0ftable_reference\x18\x01 \x01(\x0b\x32\x35.google.cloud.bigquery.storage.v1beta1.TableReference\x12\x0e\n\x06parent\x18\x06 \x01(\t\x12N\n\x0ftable_modifiers\x18\x02 \x01(\x0b\x32\x35.google.cloud.bigquery.storage.v1beta1.TableModifiers\x12\x19\n\x11requested_streams\x18\x03 \x01(\x05\x12M\n\x0cread_options\x18\x04 \x01(\x0b\x32\x37.google.cloud.bigquery.storage.v1beta1.TableReadOptions\x12\x41\n\x06\x66ormat\x18\x05 \x01(\x0e\x32\x31.google.cloud.bigquery.storage.v1beta1.DataFormat\x12R\n\x11sharding_strategy\x18\x07 \x01(\x0e\x32\x37.google.cloud.bigquery.storage.v1beta1.ShardingStrategy"_\n\x0fReadRowsRequest\x12L\n\rread_position\x18\x01 \x01(\x0b\x32\x35.google.cloud.bigquery.storage.v1beta1.StreamPosition"]\n\x0cStreamStatus\x12\x1b\n\x13\x65stimated_row_count\x18\x01 \x01(\x03\x12\x19\n\x11\x66raction_consumed\x18\x02 \x01(\x02\x12\x15\n\ris_splittable\x18\x03 \x01(\x08"*\n\x0eThrottleStatus\x12\x18\n\x10throttle_percent\x18\x01 \x01(\x05"\xdf\x02\n\x10ReadRowsResponse\x12\x44\n\tavro_rows\x18\x03 \x01(\x0b\x32/.google.cloud.bigquery.storage.v1beta1.AvroRowsH\x00\x12U\n\x12\x61rrow_record_batch\x18\x04 \x01(\x0b\x32\x37.google.cloud.bigquery.storage.v1beta1.ArrowRecordBatchH\x00\x12\x11\n\trow_count\x18\x06 \x01(\x03\x12\x43\n\x06status\x18\x02 \x01(\x0b\x32\x33.google.cloud.bigquery.storage.v1beta1.StreamStatus\x12N\n\x0fthrottle_status\x18\x05 \x01(\x0b\x32\x35.google.cloud.bigquery.storage.v1beta1.ThrottleStatusB\x06\n\x04rows"\x86\x01\n$BatchCreateReadSessionStreamsRequest\x12\x43\n\x07session\x18\x01 \x01(\x0b\x32\x32.google.cloud.bigquery.storage.v1beta1.ReadSession\x12\x19\n\x11requested_streams\x18\x02 \x01(\x05"g\n%BatchCreateReadSessionStreamsResponse\x12>\n\x07streams\x18\x01 \x03(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream"V\n\x15\x46inalizeStreamRequest\x12=\n\x06stream\x18\x02 \x01(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream"r\n\x16SplitReadStreamRequest\x12\x46\n\x0foriginal_stream\x18\x01 \x01(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream\x12\x10\n\x08\x66raction\x18\x02 \x01(\x02"\xa9\x01\n\x17SplitReadStreamResponse\x12\x45\n\x0eprimary_stream\x18\x01 \x01(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream\x12G\n\x10remainder_stream\x18\x02 \x01(\x0b\x32-.google.cloud.bigquery.storage.v1beta1.Stream*>\n\nDataFormat\x12\x1b\n\x17\x44\x41TA_FORMAT_UNSPECIFIED\x10\x00\x12\x08\n\x04\x41VRO\x10\x01\x12\t\n\x05\x41RROW\x10\x03*O\n\x10ShardingStrategy\x12!\n\x1dSHARDING_STRATEGY_UNSPECIFIED\x10\x00\x12\n\n\x06LIQUID\x10\x01\x12\x0c\n\x08\x42\x41LANCED\x10\x02\x32\xc4\t\n\x0f\x42igQueryStorage\x12\x87\x02\n\x11\x43reateReadSession\x12?.google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest\x1a\x32.google.cloud.bigquery.storage.v1beta1.ReadSession"}\x82\xd3\xe4\x93\x02w"0/v1beta1/{table_reference.project_id=projects/*}:\x01*Z@";/v1beta1/{table_reference.dataset_id=projects/*/datasets/*}:\x01*\x12\xc0\x01\n\x08ReadRows\x12\x36.google.cloud.bigquery.storage.v1beta1.ReadRowsRequest\x1a\x37.google.cloud.bigquery.storage.v1beta1.ReadRowsResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1beta1/{read_position.stream.name=projects/*/streams/*}0\x01\x12\xf4\x01\n\x1d\x42\x61tchCreateReadSessionStreams\x12K.google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsRequest\x1aL.google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsResponse"8\x82\xd3\xe4\x93\x02\x32"-/v1beta1/{session.name=projects/*/sessions/*}:\x01*\x12\x9e\x01\n\x0e\x46inalizeStream\x12<.google.cloud.bigquery.storage.v1beta1.FinalizeStreamRequest\x1a\x16.google.protobuf.Empty"6\x82\xd3\xe4\x93\x02\x30"+/v1beta1/{stream.name=projects/*/streams/*}:\x01*\x12\xce\x01\n\x0fSplitReadStream\x12=.google.cloud.bigquery.storage.v1beta1.SplitReadStreamRequest\x1a>.google.cloud.bigquery.storage.v1beta1.SplitReadStreamResponse"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{original_stream.name=projects/*/streams/*}\x1a{\xca\x41\x1e\x62igquerystorage.googleapis.com\xd2\x41Whttps://www.googleapis.com/auth/bigquery,https://www.googleapis.com/auth/cloud-platformBy\n)com.google.cloud.bigquery.storage.v1beta1ZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storageb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_arrow__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_avro__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_read__options__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_table__reference__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+_DATAFORMAT = _descriptor.EnumDescriptor(
+    name="DataFormat",
+    full_name="google.cloud.bigquery.storage.v1beta1.DataFormat",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_FORMAT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AVRO", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ARROW", index=2, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2799,
+    serialized_end=2861,
+)
+_sym_db.RegisterEnumDescriptor(_DATAFORMAT)
+
+DataFormat = enum_type_wrapper.EnumTypeWrapper(_DATAFORMAT)
+_SHARDINGSTRATEGY = _descriptor.EnumDescriptor(
+    name="ShardingStrategy",
+    full_name="google.cloud.bigquery.storage.v1beta1.ShardingStrategy",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SHARDING_STRATEGY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIQUID", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BALANCED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2863,
+    serialized_end=2942,
+)
+_sym_db.RegisterEnumDescriptor(_SHARDINGSTRATEGY)
+
+ShardingStrategy = enum_type_wrapper.EnumTypeWrapper(_SHARDINGSTRATEGY)
+DATA_FORMAT_UNSPECIFIED = 0
+AVRO = 1
+ARROW = 3
+SHARDING_STRATEGY_UNSPECIFIED = 0
+LIQUID = 1
+BALANCED = 2
+
+
+_STREAM = _descriptor.Descriptor(
+    name="Stream",
+    full_name="google.cloud.bigquery.storage.v1beta1.Stream",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.storage.v1beta1.Stream.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=461,
+    serialized_end=483,
+)
+
+
+_STREAMPOSITION = _descriptor.Descriptor(
+    name="StreamPosition",
+    full_name="google.cloud.bigquery.storage.v1beta1.StreamPosition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stream",
+            full_name="google.cloud.bigquery.storage.v1beta1.StreamPosition.stream",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.cloud.bigquery.storage.v1beta1.StreamPosition.offset",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=485,
+    serialized_end=580,
+)
+
+
+_READSESSION = _descriptor.Descriptor(
+    name="ReadSession",
+    full_name="google.cloud.bigquery.storage.v1beta1.ReadSession",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.expire_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="avro_schema",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.avro_schema",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="arrow_schema",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.arrow_schema",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="streams",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.streams",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_reference",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.table_reference",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_modifiers",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.table_modifiers",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sharding_strategy",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.sharding_strategy",
+            index=7,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="schema",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadSession.schema",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=583,
+    serialized_end=1127,
+)
+
+
+_CREATEREADSESSIONREQUEST = _descriptor.Descriptor(
+    name="CreateReadSessionRequest",
+    full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_reference",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.table_reference",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.parent",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_modifiers",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.table_modifiers",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="requested_streams",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.requested_streams",
+            index=3,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_options",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.read_options",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="format",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.format",
+            index=5,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sharding_strategy",
+            full_name="google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest.sharding_strategy",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1130,
+    serialized_end=1589,
+)
+
+
+_READROWSREQUEST = _descriptor.Descriptor(
+    name="ReadRowsRequest",
+    full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_position",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsRequest.read_position",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1591,
+    serialized_end=1686,
+)
+
+
+_STREAMSTATUS = _descriptor.Descriptor(
+    name="StreamStatus",
+    full_name="google.cloud.bigquery.storage.v1beta1.StreamStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="estimated_row_count",
+            full_name="google.cloud.bigquery.storage.v1beta1.StreamStatus.estimated_row_count",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fraction_consumed",
+            full_name="google.cloud.bigquery.storage.v1beta1.StreamStatus.fraction_consumed",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_splittable",
+            full_name="google.cloud.bigquery.storage.v1beta1.StreamStatus.is_splittable",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1688,
+    serialized_end=1781,
+)
+
+
+_THROTTLESTATUS = _descriptor.Descriptor(
+    name="ThrottleStatus",
+    full_name="google.cloud.bigquery.storage.v1beta1.ThrottleStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="throttle_percent",
+            full_name="google.cloud.bigquery.storage.v1beta1.ThrottleStatus.throttle_percent",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1783,
+    serialized_end=1825,
+)
+
+
+_READROWSRESPONSE = _descriptor.Descriptor(
+    name="ReadRowsResponse",
+    full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="avro_rows",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse.avro_rows",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="arrow_record_batch",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse.arrow_record_batch",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_count",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse.row_count",
+            index=2,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse.status",
+            index=3,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="throttle_status",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse.throttle_status",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="rows",
+            full_name="google.cloud.bigquery.storage.v1beta1.ReadRowsResponse.rows",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1828,
+    serialized_end=2179,
+)
+
+
+_BATCHCREATEREADSESSIONSTREAMSREQUEST = _descriptor.Descriptor(
+    name="BatchCreateReadSessionStreamsRequest",
+    full_name="google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsRequest.session",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="requested_streams",
+            full_name="google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsRequest.requested_streams",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2182,
+    serialized_end=2316,
+)
+
+
+_BATCHCREATEREADSESSIONSTREAMSRESPONSE = _descriptor.Descriptor(
+    name="BatchCreateReadSessionStreamsResponse",
+    full_name="google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="streams",
+            full_name="google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsResponse.streams",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2318,
+    serialized_end=2421,
+)
+
+
+_FINALIZESTREAMREQUEST = _descriptor.Descriptor(
+    name="FinalizeStreamRequest",
+    full_name="google.cloud.bigquery.storage.v1beta1.FinalizeStreamRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stream",
+            full_name="google.cloud.bigquery.storage.v1beta1.FinalizeStreamRequest.stream",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2423,
+    serialized_end=2509,
+)
+
+
+_SPLITREADSTREAMREQUEST = _descriptor.Descriptor(
+    name="SplitReadStreamRequest",
+    full_name="google.cloud.bigquery.storage.v1beta1.SplitReadStreamRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_stream",
+            full_name="google.cloud.bigquery.storage.v1beta1.SplitReadStreamRequest.original_stream",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fraction",
+            full_name="google.cloud.bigquery.storage.v1beta1.SplitReadStreamRequest.fraction",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2511,
+    serialized_end=2625,
+)
+
+
+_SPLITREADSTREAMRESPONSE = _descriptor.Descriptor(
+    name="SplitReadStreamResponse",
+    full_name="google.cloud.bigquery.storage.v1beta1.SplitReadStreamResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="primary_stream",
+            full_name="google.cloud.bigquery.storage.v1beta1.SplitReadStreamResponse.primary_stream",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remainder_stream",
+            full_name="google.cloud.bigquery.storage.v1beta1.SplitReadStreamResponse.remainder_stream",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2628,
+    serialized_end=2797,
+)
+
+_STREAMPOSITION.fields_by_name["stream"].message_type = _STREAM
+_READSESSION.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_READSESSION.fields_by_name[
+    "avro_schema"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_avro__pb2._AVROSCHEMA
+)
+_READSESSION.fields_by_name[
+    "arrow_schema"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_arrow__pb2._ARROWSCHEMA
+)
+_READSESSION.fields_by_name["streams"].message_type = _STREAM
+_READSESSION.fields_by_name[
+    "table_reference"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_table__reference__pb2._TABLEREFERENCE
+)
+_READSESSION.fields_by_name[
+    "table_modifiers"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_table__reference__pb2._TABLEMODIFIERS
+)
+_READSESSION.fields_by_name["sharding_strategy"].enum_type = _SHARDINGSTRATEGY
+_READSESSION.oneofs_by_name["schema"].fields.append(
+    _READSESSION.fields_by_name["avro_schema"]
+)
+_READSESSION.fields_by_name[
+    "avro_schema"
+].containing_oneof = _READSESSION.oneofs_by_name["schema"]
+_READSESSION.oneofs_by_name["schema"].fields.append(
+    _READSESSION.fields_by_name["arrow_schema"]
+)
+_READSESSION.fields_by_name[
+    "arrow_schema"
+].containing_oneof = _READSESSION.oneofs_by_name["schema"]
+_CREATEREADSESSIONREQUEST.fields_by_name[
+    "table_reference"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_table__reference__pb2._TABLEREFERENCE
+)
+_CREATEREADSESSIONREQUEST.fields_by_name[
+    "table_modifiers"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_table__reference__pb2._TABLEMODIFIERS
+)
+_CREATEREADSESSIONREQUEST.fields_by_name[
+    "read_options"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_read__options__pb2._TABLEREADOPTIONS
+)
+_CREATEREADSESSIONREQUEST.fields_by_name["format"].enum_type = _DATAFORMAT
+_CREATEREADSESSIONREQUEST.fields_by_name[
+    "sharding_strategy"
+].enum_type = _SHARDINGSTRATEGY
+_READROWSREQUEST.fields_by_name["read_position"].message_type = _STREAMPOSITION
+_READROWSRESPONSE.fields_by_name[
+    "avro_rows"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_avro__pb2._AVROROWS
+)
+_READROWSRESPONSE.fields_by_name[
+    "arrow_record_batch"
+].message_type = (
+    google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_arrow__pb2._ARROWRECORDBATCH
+)
+_READROWSRESPONSE.fields_by_name["status"].message_type = _STREAMSTATUS
+_READROWSRESPONSE.fields_by_name["throttle_status"].message_type = _THROTTLESTATUS
+_READROWSRESPONSE.oneofs_by_name["rows"].fields.append(
+    _READROWSRESPONSE.fields_by_name["avro_rows"]
+)
+_READROWSRESPONSE.fields_by_name[
+    "avro_rows"
+].containing_oneof = _READROWSRESPONSE.oneofs_by_name["rows"]
+_READROWSRESPONSE.oneofs_by_name["rows"].fields.append(
+    _READROWSRESPONSE.fields_by_name["arrow_record_batch"]
+)
+_READROWSRESPONSE.fields_by_name[
+    "arrow_record_batch"
+].containing_oneof = _READROWSRESPONSE.oneofs_by_name["rows"]
+_BATCHCREATEREADSESSIONSTREAMSREQUEST.fields_by_name[
+    "session"
+].message_type = _READSESSION
+_BATCHCREATEREADSESSIONSTREAMSRESPONSE.fields_by_name["streams"].message_type = _STREAM
+_FINALIZESTREAMREQUEST.fields_by_name["stream"].message_type = _STREAM
+_SPLITREADSTREAMREQUEST.fields_by_name["original_stream"].message_type = _STREAM
+_SPLITREADSTREAMRESPONSE.fields_by_name["primary_stream"].message_type = _STREAM
+_SPLITREADSTREAMRESPONSE.fields_by_name["remainder_stream"].message_type = _STREAM
+DESCRIPTOR.message_types_by_name["Stream"] = _STREAM
+DESCRIPTOR.message_types_by_name["StreamPosition"] = _STREAMPOSITION
+DESCRIPTOR.message_types_by_name["ReadSession"] = _READSESSION
+DESCRIPTOR.message_types_by_name["CreateReadSessionRequest"] = _CREATEREADSESSIONREQUEST
+DESCRIPTOR.message_types_by_name["ReadRowsRequest"] = _READROWSREQUEST
+DESCRIPTOR.message_types_by_name["StreamStatus"] = _STREAMSTATUS
+DESCRIPTOR.message_types_by_name["ThrottleStatus"] = _THROTTLESTATUS
+DESCRIPTOR.message_types_by_name["ReadRowsResponse"] = _READROWSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchCreateReadSessionStreamsRequest"
+] = _BATCHCREATEREADSESSIONSTREAMSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchCreateReadSessionStreamsResponse"
+] = _BATCHCREATEREADSESSIONSTREAMSRESPONSE
+DESCRIPTOR.message_types_by_name["FinalizeStreamRequest"] = _FINALIZESTREAMREQUEST
+DESCRIPTOR.message_types_by_name["SplitReadStreamRequest"] = _SPLITREADSTREAMREQUEST
+DESCRIPTOR.message_types_by_name["SplitReadStreamResponse"] = _SPLITREADSTREAMRESPONSE
+DESCRIPTOR.enum_types_by_name["DataFormat"] = _DATAFORMAT
+DESCRIPTOR.enum_types_by_name["ShardingStrategy"] = _SHARDINGSTRATEGY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Stream = _reflection.GeneratedProtocolMessageType(
+    "Stream",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAM,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Information about a single data stream within a read session.
+  
+  
+  Attributes:
+      name:
+          Name of the stream, in the form ``projects/{project_id}/locati
+          ons/{location}/streams/{stream_id}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.Stream)
+    ),
+)
+_sym_db.RegisterMessage(Stream)
+
+StreamPosition = _reflection.GeneratedProtocolMessageType(
+    "StreamPosition",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMPOSITION,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Expresses a point within a given stream using an offset position.
+  
+  
+  Attributes:
+      stream:
+          Identifier for a given Stream.
+      offset:
+          Position in the stream.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.StreamPosition)
+    ),
+)
+_sym_db.RegisterMessage(StreamPosition)
+
+ReadSession = _reflection.GeneratedProtocolMessageType(
+    "ReadSession",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READSESSION,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Information returned from a ``CreateReadSession`` request.
+  
+  
+  Attributes:
+      name:
+          Unique identifier for the session, in the form ``projects/{pro
+          ject_id}/locations/{location}/sessions/{session_id}``.
+      expire_time:
+          Time at which the session becomes invalid. After this time,
+          subsequent requests to read this Session will return errors.
+      schema:
+          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.
+      avro_schema:
+          Avro schema.
+      arrow_schema:
+          Arrow schema.
+      streams:
+          Streams associated with this session.
+      table_reference:
+          Table that this ReadSession is reading from.
+      table_modifiers:
+          Any modifiers which are applied when reading from the
+          specified table.
+      sharding_strategy:
+          The strategy to use for distributing data among the streams.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.ReadSession)
+    ),
+)
+_sym_db.RegisterMessage(ReadSession)
+
+CreateReadSessionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateReadSessionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEREADSESSIONREQUEST,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Creates a new read session, which may include additional options such as
+  requested parallelism, projection filters and constraints.
+  
+  
+  Attributes:
+      table_reference:
+          Required. Reference to the table to read.
+      parent:
+          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.
+      table_modifiers:
+          Optional. Any modifiers to the Table (e.g. snapshot
+          timestamp).
+      requested_streams:
+          Optional. 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 the maximum
+          amount of parallelism allowed by the system.  Streams must be
+          read starting from offset 0.
+      read_options:
+          Optional. Read options for this session (e.g. column
+          selection, filters).
+      format:
+          Data output format. Currently default to Avro.
+      sharding_strategy:
+          The strategy to use for distributing data among multiple
+          streams. Currently defaults to liquid sharding.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.CreateReadSessionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateReadSessionRequest)
+
+ReadRowsRequest = _reflection.GeneratedProtocolMessageType(
+    "ReadRowsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READROWSREQUEST,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Requesting row data via ``ReadRows`` must provide Stream position
+  information.
+  
+  
+  Attributes:
+      read_position:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.ReadRowsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReadRowsRequest)
+
+StreamStatus = _reflection.GeneratedProtocolMessageType(
+    "StreamStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMSTATUS,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Progress information for a given Stream.
+  
+  
+  Attributes:
+      estimated_row_count:
+          Number of estimated rows in the current stream. May change
+          over time as different readers in the stream progress at rates
+          which are relatively fast or slow.
+      fraction_consumed:
+          A value in the range [0.0, 1.0] that represents the fraction
+          of rows assigned to this stream that have been processed by
+          the server. In the presence of read filters, the server may
+          process more rows than it returns, so this value reflects
+          progress through the pre-filtering rows.  This value is only
+          populated for sessions created through the BALANCED sharding
+          strategy.
+      is_splittable:
+          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 at that point
+          or beyond. For small tables or streams that are the result of
+          a chain of splits, this value may never be true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.StreamStatus)
+    ),
+)
+_sym_db.RegisterMessage(StreamStatus)
+
+ThrottleStatus = _reflection.GeneratedProtocolMessageType(
+    "ThrottleStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_THROTTLESTATUS,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Information on if the current connection is being throttled.
+  
+  
+  Attributes:
+      throttle_percent:
+          How much this connection is being throttled. 0 is no
+          throttling, 100 is completely throttled.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.ThrottleStatus)
+    ),
+)
+_sym_db.RegisterMessage(ThrottleStatus)
+
+ReadRowsResponse = _reflection.GeneratedProtocolMessageType(
+    "ReadRowsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READROWSRESPONSE,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Response from calling ``ReadRows`` may include row data, progress and
+  throttling information.
+  
+  
+  Attributes:
+      rows:
+          Row data is returned in format specified during session
+          creation.
+      avro_rows:
+          Serialized row data in AVRO format.
+      arrow_record_batch:
+          Serialized row data in Arrow RecordBatch format.
+      row_count:
+          Number of serialized rows in the rows block. This value is
+          recorded here, in addition to the row\_count values in the
+          output-specific messages in ``rows``, so that code which needs
+          to record progress through the stream can do so in an output
+          format-independent way.
+      status:
+          Estimated stream statistics.
+      throttle_status:
+          Throttling status. If unset, the latest response still
+          describes the current throttling status.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.ReadRowsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReadRowsResponse)
+
+BatchCreateReadSessionStreamsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateReadSessionStreamsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATEREADSESSIONSTREAMSREQUEST,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Information needed to request additional streams for an established read
+  session.
+  
+  
+  Attributes:
+      session:
+          Required. Must be a non-expired session obtained from a call
+          to CreateReadSession. Only the name field needs to be set.
+      requested_streams:
+          Required. Number of new streams requested. Must be positive.
+          Number of added streams may be less than this, see
+          CreateReadSessionRequest for more information.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateReadSessionStreamsRequest)
+
+BatchCreateReadSessionStreamsResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateReadSessionStreamsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATEREADSESSIONSTREAMSRESPONSE,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""The response from ``BatchCreateReadSessionStreams`` returns the stream
+  identifiers for the newly created streams.
+  
+  
+  Attributes:
+      streams:
+          Newly added streams.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.BatchCreateReadSessionStreamsResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateReadSessionStreamsResponse)
+
+FinalizeStreamRequest = _reflection.GeneratedProtocolMessageType(
+    "FinalizeStreamRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINALIZESTREAMREQUEST,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Request information for invoking ``FinalizeStream``.
+  
+  
+  Attributes:
+      stream:
+          Stream to finalize.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.FinalizeStreamRequest)
+    ),
+)
+_sym_db.RegisterMessage(FinalizeStreamRequest)
+
+SplitReadStreamRequest = _reflection.GeneratedProtocolMessageType(
+    "SplitReadStreamRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPLITREADSTREAMREQUEST,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Request information for ``SplitReadStream``.
+  
+  
+  Attributes:
+      original_stream:
+          Stream to split.
+      fraction:
+          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 to a data storage boundary on the server
+          side.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.SplitReadStreamRequest)
+    ),
+)
+_sym_db.RegisterMessage(SplitReadStreamRequest)
+
+SplitReadStreamResponse = _reflection.GeneratedProtocolMessageType(
+    "SplitReadStreamResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPLITREADSTREAMRESPONSE,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.storage_pb2",
+        __doc__="""Response from ``SplitReadStream``.
+  
+  
+  Attributes:
+      primary_stream:
+          Primary stream, which contains the beginning portion of
+          \|original\_stream\|. An empty value indicates that the
+          original stream can no longer be split.
+      remainder_stream:
+          Remainder stream, which contains the tail of
+          \|original\_stream\|. An empty value indicates that the
+          original stream can no longer be split.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.SplitReadStreamResponse)
+    ),
+)
+_sym_db.RegisterMessage(SplitReadStreamResponse)
+
+
+DESCRIPTOR._options = None
+
+_BIGQUERYSTORAGE = _descriptor.ServiceDescriptor(
+    name="BigQueryStorage",
+    full_name="google.cloud.bigquery.storage.v1beta1.BigQueryStorage",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\036bigquerystorage.googleapis.com\322AWhttps://www.googleapis.com/auth/bigquery,https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=2945,
+    serialized_end=4165,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateReadSession",
+            full_name="google.cloud.bigquery.storage.v1beta1.BigQueryStorage.CreateReadSession",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEREADSESSIONREQUEST,
+            output_type=_READSESSION,
+            serialized_options=_b(
+                '\202\323\344\223\002w"0/v1beta1/{table_reference.project_id=projects/*}:\001*Z@";/v1beta1/{table_reference.dataset_id=projects/*/datasets/*}:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ReadRows",
+            full_name="google.cloud.bigquery.storage.v1beta1.BigQueryStorage.ReadRows",
+            index=1,
+            containing_service=None,
+            input_type=_READROWSREQUEST,
+            output_type=_READROWSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1beta1/{read_position.stream.name=projects/*/streams/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchCreateReadSessionStreams",
+            full_name="google.cloud.bigquery.storage.v1beta1.BigQueryStorage.BatchCreateReadSessionStreams",
+            index=2,
+            containing_service=None,
+            input_type=_BATCHCREATEREADSESSIONSTREAMSREQUEST,
+            output_type=_BATCHCREATEREADSESSIONSTREAMSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0022"-/v1beta1/{session.name=projects/*/sessions/*}:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="FinalizeStream",
+            full_name="google.cloud.bigquery.storage.v1beta1.BigQueryStorage.FinalizeStream",
+            index=3,
+            containing_service=None,
+            input_type=_FINALIZESTREAMREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\0020"+/v1beta1/{stream.name=projects/*/streams/*}:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SplitReadStream",
+            full_name="google.cloud.bigquery.storage.v1beta1.BigQueryStorage.SplitReadStream",
+            index=4,
+            containing_service=None,
+            input_type=_SPLITREADSTREAMREQUEST,
+            output_type=_SPLITREADSTREAMRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0026\0224/v1beta1/{original_stream.name=projects/*/streams/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_BIGQUERYSTORAGE)
+
+DESCRIPTOR.services_by_name["BigQueryStorage"] = _BIGQUERYSTORAGE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2_grpc.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2_grpc.py
new file mode 100644
index 000000000000..85b890f0e0cc
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/storage_pb2_grpc.py
@@ -0,0 +1,168 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigquery_storage_v1beta1.proto import (
+    storage_pb2 as google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class BigQueryStorageStub(object):
+    """BigQuery storage API.
+
+  The BigQuery storage API can be used to read data stored in BigQuery.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateReadSession = channel.unary_unary(
+            "/google.cloud.bigquery.storage.v1beta1.BigQueryStorage/CreateReadSession",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.CreateReadSessionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.ReadSession.FromString,
+        )
+        self.ReadRows = channel.unary_stream(
+            "/google.cloud.bigquery.storage.v1beta1.BigQueryStorage/ReadRows",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.ReadRowsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.ReadRowsResponse.FromString,
+        )
+        self.BatchCreateReadSessionStreams = channel.unary_unary(
+            "/google.cloud.bigquery.storage.v1beta1.BigQueryStorage/BatchCreateReadSessionStreams",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.BatchCreateReadSessionStreamsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.BatchCreateReadSessionStreamsResponse.FromString,
+        )
+        self.FinalizeStream = channel.unary_unary(
+            "/google.cloud.bigquery.storage.v1beta1.BigQueryStorage/FinalizeStream",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.FinalizeStreamRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.SplitReadStream = channel.unary_unary(
+            "/google.cloud.bigquery.storage.v1beta1.BigQueryStorage/SplitReadStream",
+            request_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.SplitReadStreamRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.SplitReadStreamResponse.FromString,
+        )
+
+
+class BigQueryStorageServicer(object):
+    """BigQuery storage API.
+
+  The BigQuery storage API can be used to read data stored in BigQuery.
+  """
+
+    def CreateReadSession(self, request, context):
+        """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.
+
+    Read sessions automatically expire 24 hours after they are created and do
+    not require manual clean-up by the caller.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ReadRows(self, request, context):
+        """Reads rows from the table in the format prescribed by the read session.
+    Each response contains one or more table rows, up to a maximum of 10 MiB
+    per response; read requests which attempt to read individual rows larger
+    than this will fail.
+
+    Each request also returns a set of stream statistics reflecting the
+    estimated total number of rows in the read stream. This number is computed
+    based on the total table size and the number of active streams in the read
+    session, and may change as other streams continue to read data.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchCreateReadSessionStreams(self, request, context):
+        """Creates additional streams for a ReadSession. This API can be used to
+    dynamically adjust the parallelism of a batch processing task upwards by
+    adding additional workers.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def FinalizeStream(self, request, context):
+        """Triggers the graceful termination of a single stream in a ReadSession. This
+    API can be used to dynamically adjust the parallelism of a batch processing
+    task downwards without losing data.
+
+    This API does not delete the stream -- it remains visible in the
+    ReadSession, and any data processed by the stream is not released to other
+    streams. However, no additional data will be assigned to the stream once
+    this call completes. Callers must continue reading data on the stream until
+    the end of the stream is reached so that data which has already been
+    assigned to the stream will be processed.
+
+    This method will return an error if there are no other live streams
+    in the Session, or if SplitReadStream() has been called on the given
+    Stream.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SplitReadStream(self, request, context):
+        """Splits a given read stream into two Streams. These streams are referred to
+    as the primary and the residual of the split. The original stream can still
+    be read from in the same manner as before. Both of the returned streams can
+    also be read from, and the total rows return 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 Stream. 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.
+
+    This method is guaranteed to be idempotent.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_BigQueryStorageServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateReadSession": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateReadSession,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.CreateReadSessionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.ReadSession.SerializeToString,
+        ),
+        "ReadRows": grpc.unary_stream_rpc_method_handler(
+            servicer.ReadRows,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.ReadRowsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.ReadRowsResponse.SerializeToString,
+        ),
+        "BatchCreateReadSessionStreams": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchCreateReadSessionStreams,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.BatchCreateReadSessionStreamsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.BatchCreateReadSessionStreamsResponse.SerializeToString,
+        ),
+        "FinalizeStream": grpc.unary_unary_rpc_method_handler(
+            servicer.FinalizeStream,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.FinalizeStreamRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "SplitReadStream": grpc.unary_unary_rpc_method_handler(
+            servicer.SplitReadStream,
+            request_deserializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.SplitReadStreamRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigquery_dot_storage__v1beta1_dot_proto_dot_storage__pb2.SplitReadStreamResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.bigquery.storage.v1beta1.BigQueryStorage", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference.proto b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference.proto
new file mode 100644
index 000000000000..fb74bbf6c642
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference.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.bigquery.storage.v1beta1;
+
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage";
+option java_outer_classname = "TableReferenceProto";
+option java_package = "com.google.cloud.bigquery.storage.v1beta1";
+
+// Table reference that includes just the 3 strings needed to identify a table.
+message TableReference {
+  // The assigned project ID of the project.
+  string project_id = 1;
+
+  // The ID of the dataset in the above project.
+  string dataset_id = 2;
+
+  // The ID of the table in the above dataset.
+  string table_id = 3;
+}
+
+// All fields in this message optional.
+message TableModifiers {
+  // The snapshot time of the table. If not set, interpreted as now.
+  google.protobuf.Timestamp snapshot_time = 1;
+}
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference_pb2.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference_pb2.py
new file mode 100644
index 000000000000..30c85aa2f469
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference_pb2.py
@@ -0,0 +1,199 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigquery/storage_v1beta1/proto/table_reference.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigquery/storage_v1beta1/proto/table_reference.proto",
+    package="google.cloud.bigquery.storage.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n)com.google.cloud.bigquery.storage.v1beta1B\023TableReferenceProtoZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"
+    ),
+    serialized_pb=_b(
+        '\nAgoogle/cloud/bigquery/storage_v1beta1/proto/table_reference.proto\x12%google.cloud.bigquery.storage.v1beta1\x1a\x1fgoogle/protobuf/timestamp.proto"J\n\x0eTableReference\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x10\n\x08table_id\x18\x03 \x01(\t"C\n\x0eTableModifiers\x12\x31\n\rsnapshot_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x8e\x01\n)com.google.cloud.bigquery.storage.v1beta1B\x13TableReferenceProtoZLgoogle.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storageb\x06proto3'
+    ),
+    dependencies=[google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR],
+)
+
+
+_TABLEREFERENCE = _descriptor.Descriptor(
+    name="TableReference",
+    full_name="google.cloud.bigquery.storage.v1beta1.TableReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.bigquery.storage.v1beta1.TableReference.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.cloud.bigquery.storage.v1beta1.TableReference.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_id",
+            full_name="google.cloud.bigquery.storage.v1beta1.TableReference.table_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=141,
+    serialized_end=215,
+)
+
+
+_TABLEMODIFIERS = _descriptor.Descriptor(
+    name="TableModifiers",
+    full_name="google.cloud.bigquery.storage.v1beta1.TableModifiers",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshot_time",
+            full_name="google.cloud.bigquery.storage.v1beta1.TableModifiers.snapshot_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=217,
+    serialized_end=284,
+)
+
+_TABLEMODIFIERS.fields_by_name[
+    "snapshot_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["TableReference"] = _TABLEREFERENCE
+DESCRIPTOR.message_types_by_name["TableModifiers"] = _TABLEMODIFIERS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TableReference = _reflection.GeneratedProtocolMessageType(
+    "TableReference",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLEREFERENCE,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.table_reference_pb2",
+        __doc__="""Table reference that includes just the 3 strings needed to identify a
+  table.
+  
+  
+  Attributes:
+      project_id:
+          The assigned project ID of the project.
+      dataset_id:
+          The ID of the dataset in the above project.
+      table_id:
+          The ID of the table in the above dataset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.TableReference)
+    ),
+)
+_sym_db.RegisterMessage(TableReference)
+
+TableModifiers = _reflection.GeneratedProtocolMessageType(
+    "TableModifiers",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLEMODIFIERS,
+        __module__="google.cloud.bigquery.storage_v1beta1.proto.table_reference_pb2",
+        __doc__="""All fields in this message optional.
+  
+  
+  Attributes:
+      snapshot_time:
+          The snapshot time of the table. If not set, interpreted as
+          now.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.bigquery.storage.v1beta1.TableModifiers)
+    ),
+)
+_sym_db.RegisterMessage(TableModifiers)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference_pb2_grpc.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/proto/table_reference_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/reader.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/reader.py
new file mode 100644
index 000000000000..138fae4110eb
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/reader.py
@@ -0,0 +1,611 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import collections
+import json
+
+try:
+    import fastavro
+except ImportError:  # pragma: NO COVER
+    fastavro = None
+import google.api_core.exceptions
+
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+try:
+    import pyarrow
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+import six
+
+try:
+    import pyarrow
+except ImportError:  # pragma: NO COVER
+    pyarrow = None
+
+from google.cloud.bigquery_storage_v1beta1 import types
+
+
+_STREAM_RESUMPTION_EXCEPTIONS = (google.api_core.exceptions.ServiceUnavailable,)
+
+_FASTAVRO_REQUIRED = (
+    "fastavro is required to parse ReadRowResponse messages with Avro bytes."
+)
+_PANDAS_REQUIRED = "pandas is required to create a DataFrame"
+_PYARROW_REQUIRED = (
+    "pyarrow is required to parse ReadRowResponse messages with Arrow bytes."
+)
+
+
+class ReadRowsStream(object):
+    """A stream of results from a read rows request.
+
+    This stream is an iterable of
+    :class:`~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse`.
+    Iterate over it to fetch all row messages.
+
+    If the fastavro library is installed, use the
+    :func:`~google.cloud.bigquery_storage_v1beta1.reader.ReadRowsStream.rows()`
+    method to parse all messages into a stream of row dictionaries.
+
+    If the pandas and fastavro libraries are installed, use the
+    :func:`~google.cloud.bigquery_storage_v1beta1.reader.ReadRowsStream.to_dataframe()`
+    method to parse all messages into a :class:`pandas.DataFrame`.
+    """
+
+    def __init__(self, wrapped, client, read_position, read_rows_kwargs):
+        """Construct a ReadRowsStream.
+
+        Args:
+            wrapped (Iterable[ \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse \
+            ]):
+                The ReadRows stream to read.
+            client ( \
+                ~google.cloud.bigquery_storage_v1beta1.gapic. \
+                    big_query_storage_client.BigQueryStorageClient \
+            ):
+                A GAPIC client used to reconnect to a ReadRows stream. This
+                must be the GAPIC client to avoid a circular dependency on
+                this class.
+            read_position (Union[ \
+                dict, \
+                ~google.cloud.bigquery_storage_v1beta1.types.StreamPosition \
+            ]):
+                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. If a dict is provided, it must be of the same form
+                as the protobuf message
+                :class:`~google.cloud.bigquery_storage_v1beta1.types.StreamPosition`
+            read_rows_kwargs (dict):
+                Keyword arguments to use when reconnecting to a ReadRows
+                stream.
+
+        Returns:
+            Iterable[ \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse \
+            ]:
+                A sequence of row messages.
+        """
+
+        # Make a copy of the read position so that we can update it without
+        # mutating the original input.
+        self._position = _copy_stream_position(read_position)
+        self._client = client
+        self._wrapped = wrapped
+        self._read_rows_kwargs = read_rows_kwargs
+
+    def __iter__(self):
+        """An iterable of messages.
+
+        Returns:
+            Iterable[ \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse \
+            ]:
+                A sequence of row messages.
+        """
+
+        # Infinite loop to reconnect on reconnectable errors while processing
+        # the row stream.
+        while True:
+            try:
+                for message in self._wrapped:
+                    rowcount = message.row_count
+                    self._position.offset += rowcount
+                    yield message
+
+                return  # Made it through the whole stream.
+            except _STREAM_RESUMPTION_EXCEPTIONS:
+                # Transient error, so reconnect to the stream.
+                pass
+
+            self._reconnect()
+
+    def _reconnect(self):
+        """Reconnect to the ReadRows stream using the most recent offset."""
+        self._wrapped = self._client.read_rows(
+            _copy_stream_position(self._position), **self._read_rows_kwargs
+        )
+
+    def rows(self, read_session):
+        """Iterate over all rows in the stream.
+
+        This method requires the fastavro library in order to parse row
+        messages.
+
+        .. warning::
+            DATETIME columns are not supported. They are currently parsed as
+            strings in the fastavro library.
+
+        Args:
+            read_session ( \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadSession \
+            ):
+                The read session associated with this read rows stream. This
+                contains the schema, which is required to parse the data
+                messages.
+
+        Returns:
+            Iterable[Mapping]:
+                A sequence of rows, represented as dictionaries.
+        """
+        return ReadRowsIterable(self, read_session)
+
+    def to_arrow(self, read_session):
+        """Create a :class:`pyarrow.Table` of all rows in the stream.
+
+        This method requires the pyarrow library and a stream using the Arrow
+        format.
+
+        Args:
+            read_session ( \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadSession \
+            ):
+                The read session associated with this read rows stream. This
+                contains the schema, which is required to parse the data
+                messages.
+
+        Returns:
+            pyarrow.Table:
+                A table of all rows in the stream.
+        """
+        return self.rows(read_session).to_arrow()
+
+    def to_dataframe(self, read_session, dtypes=None):
+        """Create a :class:`pandas.DataFrame` of all rows in the stream.
+
+        This method requires the pandas libary to create a data frame and the
+        fastavro library to parse row messages.
+
+        .. warning::
+            DATETIME columns are not supported. They are currently parsed as
+            strings.
+
+        Args:
+            read_session ( \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadSession \
+            ):
+                The read session associated with this read rows stream. This
+                contains the schema, which is required to parse the data
+                messages.
+            dtypes ( \
+                Map[str, Union[str, pandas.Series.dtype]] \
+            ):
+                Optional. A dictionary of column names pandas ``dtype``s. The
+                provided ``dtype`` is used when constructing the series for
+                the column specified. Otherwise, the default pandas behavior
+                is used.
+
+        Returns:
+            pandas.DataFrame:
+                A data frame of all rows in the stream.
+        """
+        if pandas is None:
+            raise ImportError(_PANDAS_REQUIRED)
+
+        return self.rows(read_session).to_dataframe(dtypes=dtypes)
+
+
+class ReadRowsIterable(object):
+    """An iterable of rows from a read session.
+
+    Args:
+        reader (google.cloud.bigquery_storage_v1beta1.reader.ReadRowsStream):
+            A read rows stream.
+        read_session (google.cloud.bigquery_storage_v1beta1.types.ReadSession):
+            A read session. This is required because it contains the schema
+            used in the stream messages.
+    """
+
+    # This class is modelled after the google.cloud.bigquery.table.RowIterator
+    # and aims to be API compatible where possible.
+
+    def __init__(self, reader, read_session):
+        self._status = None
+        self._reader = reader
+        self._read_session = read_session
+        self._stream_parser = _StreamParser.from_read_session(self._read_session)
+
+    @property
+    def total_rows(self):
+        """int: Number of estimated rows in the current stream.
+
+        May change over time.
+        """
+        return getattr(self._status, "estimated_row_count", None)
+
+    @property
+    def pages(self):
+        """A generator of all pages in the stream.
+
+        Returns:
+            types.GeneratorType[google.cloud.bigquery_storage_v1beta1.ReadRowsPage]:
+                A generator of pages.
+        """
+        # Each page is an iterator of rows. But also has num_items, remaining,
+        # and to_dataframe.
+        for message in self._reader:
+            self._status = message.status
+            yield ReadRowsPage(self._stream_parser, message)
+
+    def __iter__(self):
+        """Iterator for each row in all pages."""
+        for page in self.pages:
+            for row in page:
+                yield row
+
+    def to_arrow(self):
+        """Create a :class:`pyarrow.Table` of all rows in the stream.
+
+        This method requires the pyarrow library and a stream using the Arrow
+        format.
+
+        Returns:
+            pyarrow.Table:
+                A table of all rows in the stream.
+        """
+        record_batches = []
+        for page in self.pages:
+            record_batches.append(page.to_arrow())
+        return pyarrow.Table.from_batches(record_batches)
+
+    def to_dataframe(self, dtypes=None):
+        """Create a :class:`pandas.DataFrame` of all rows in the stream.
+
+        This method requires the pandas libary to create a data frame and the
+        fastavro library to parse row messages.
+
+        .. warning::
+            DATETIME columns are not supported. They are currently parsed as
+            strings in the fastavro library.
+
+        Args:
+            dtypes ( \
+                Map[str, Union[str, pandas.Series.dtype]] \
+            ):
+                Optional. A dictionary of column names pandas ``dtype``s. The
+                provided ``dtype`` is used when constructing the series for
+                the column specified. Otherwise, the default pandas behavior
+                is used.
+
+        Returns:
+            pandas.DataFrame:
+                A data frame of all rows in the stream.
+        """
+        if pandas is None:
+            raise ImportError(_PANDAS_REQUIRED)
+
+        frames = []
+        for page in self.pages:
+            frames.append(page.to_dataframe(dtypes=dtypes))
+        return pandas.concat(frames)
+
+
+class ReadRowsPage(object):
+    """An iterator of rows from a read session message.
+
+    Args:
+        stream_parser (google.cloud.bigquery_storage_v1beta1.reader._StreamParser):
+            A helper for parsing messages into rows.
+        message (google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse):
+            A message of data from a read rows stream.
+    """
+
+    # This class is modeled after google.api_core.page_iterator.Page and aims
+    # to provide API compatibility where possible.
+
+    def __init__(self, stream_parser, message):
+        self._stream_parser = stream_parser
+        self._message = message
+        self._iter_rows = None
+        self._num_items = self._message.row_count
+        self._remaining = self._message.row_count
+
+    def _parse_rows(self):
+        """Parse rows from the message only once."""
+        if self._iter_rows is not None:
+            return
+
+        rows = self._stream_parser.to_rows(self._message)
+        self._iter_rows = iter(rows)
+
+    @property
+    def num_items(self):
+        """int: Total items in the page."""
+        return self._num_items
+
+    @property
+    def remaining(self):
+        """int: Remaining items in the page."""
+        return self._remaining
+
+    def __iter__(self):
+        """A ``ReadRowsPage`` is an iterator."""
+        return self
+
+    def next(self):
+        """Get the next row in the page."""
+        self._parse_rows()
+        if self._remaining > 0:
+            self._remaining -= 1
+        return six.next(self._iter_rows)
+
+    # Alias needed for Python 2/3 support.
+    __next__ = next
+
+    def to_arrow(self):
+        """Create an :class:`pyarrow.RecordBatch` of rows in the page.
+
+        Returns:
+            pyarrow.RecordBatch:
+                Rows from the message, as an Arrow record batch.
+        """
+        return self._stream_parser.to_arrow(self._message)
+
+    def to_dataframe(self, dtypes=None):
+        """Create a :class:`pandas.DataFrame` of rows in the page.
+
+        This method requires the pandas libary to create a data frame and the
+        fastavro library to parse row messages.
+
+        .. warning::
+            DATETIME columns are not supported. They are currently parsed as
+            strings in the fastavro library.
+
+        Args:
+            dtypes ( \
+                Map[str, Union[str, pandas.Series.dtype]] \
+            ):
+                Optional. A dictionary of column names pandas ``dtype``s. The
+                provided ``dtype`` is used when constructing the series for
+                the column specified. Otherwise, the default pandas behavior
+                is used.
+
+        Returns:
+            pandas.DataFrame:
+                A data frame of all rows in the stream.
+        """
+        if pandas is None:
+            raise ImportError(_PANDAS_REQUIRED)
+        return self._stream_parser.to_dataframe(self._message, dtypes=dtypes)
+
+
+class _StreamParser(object):
+    def to_arrow(self, message):
+        raise NotImplementedError("Not implemented.")
+
+    def to_dataframe(self, message, dtypes=None):
+        raise NotImplementedError("Not implemented.")
+
+    def to_rows(self, message):
+        raise NotImplementedError("Not implemented.")
+
+    @staticmethod
+    def from_read_session(read_session):
+        schema_type = read_session.WhichOneof("schema")
+        if schema_type == "avro_schema":
+            return _AvroStreamParser(read_session)
+        elif schema_type == "arrow_schema":
+            return _ArrowStreamParser(read_session)
+        else:
+            raise TypeError(
+                "Unsupported schema type in read_session: {0}".format(schema_type)
+            )
+
+
+class _AvroStreamParser(_StreamParser):
+    """Helper to parse Avro messages into useful representations."""
+
+    def __init__(self, read_session):
+        """Construct an _AvroStreamParser.
+
+        Args:
+            read_session (google.cloud.bigquery_storage_v1beta1.types.ReadSession):
+                A read session. This is required because it contains the schema
+                used in the stream messages.
+        """
+        if fastavro is None:
+            raise ImportError(_FASTAVRO_REQUIRED)
+
+        self._read_session = read_session
+        self._avro_schema_json = None
+        self._fastavro_schema = None
+        self._column_names = None
+
+    def to_arrow(self, message):
+        """Create an :class:`pyarrow.RecordBatch` of rows in the page.
+
+        Args:
+            message (google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse):
+                Protocol buffer from the read rows stream, to convert into an
+                Arrow record batch.
+
+        Returns:
+            pyarrow.RecordBatch:
+                Rows from the message, as an Arrow record batch.
+        """
+        raise NotImplementedError("to_arrow not implemented for Avro streams.")
+
+    def to_dataframe(self, message, dtypes=None):
+        """Create a :class:`pandas.DataFrame` of rows in the page.
+
+        This method requires the pandas libary to create a data frame and the
+        fastavro library to parse row messages.
+
+        .. warning::
+            DATETIME columns are not supported. They are currently parsed as
+            strings in the fastavro library.
+
+        Args:
+            dtypes ( \
+                Map[str, Union[str, pandas.Series.dtype]] \
+            ):
+                Optional. A dictionary of column names pandas ``dtype``s. The
+                provided ``dtype`` is used when constructing the series for
+                the column specified. Otherwise, the default pandas behavior
+                is used.
+
+        Returns:
+            pandas.DataFrame:
+                A data frame of all rows in the stream.
+        """
+        self._parse_avro_schema()
+
+        if dtypes is None:
+            dtypes = {}
+
+        columns = collections.defaultdict(list)
+        for row in self.to_rows(message):
+            for column in row:
+                columns[column].append(row[column])
+        for column in dtypes:
+            columns[column] = pandas.Series(columns[column], dtype=dtypes[column])
+        return pandas.DataFrame(columns, columns=self._column_names)
+
+    def _parse_avro_schema(self):
+        """Extract and parse Avro schema from a read session."""
+        if self._avro_schema_json:
+            return
+
+        self._avro_schema_json = json.loads(self._read_session.avro_schema.schema)
+        self._column_names = tuple(
+            (field["name"] for field in self._avro_schema_json["fields"])
+        )
+
+    def _parse_fastavro(self):
+        """Convert parsed Avro schema to fastavro format."""
+        self._parse_avro_schema()
+        self._fastavro_schema = fastavro.parse_schema(self._avro_schema_json)
+
+    def to_rows(self, message):
+        """Parse all rows in a stream message.
+
+        Args:
+            message ( \
+                ~google.cloud.bigquery_storage_v1beta1.types.ReadRowsResponse \
+            ):
+                A message containing Avro bytes to parse into rows.
+
+        Returns:
+            Iterable[Mapping]:
+                A sequence of rows, represented as dictionaries.
+        """
+        self._parse_fastavro()
+        messageio = six.BytesIO(message.avro_rows.serialized_binary_rows)
+        while True:
+            # Loop in a while loop because schemaless_reader can only read
+            # a single record.
+            try:
+                # TODO: Parse DATETIME into datetime.datetime (no timezone),
+                #       instead of as a string.
+                yield fastavro.schemaless_reader(messageio, self._fastavro_schema)
+            except StopIteration:
+                break  # Finished with message
+
+
+class _ArrowStreamParser(_StreamParser):
+    def __init__(self, read_session):
+        if pyarrow is None:
+            raise ImportError(_PYARROW_REQUIRED)
+
+        self._read_session = read_session
+        self._schema = None
+
+    def to_arrow(self, message):
+        return self._parse_arrow_message(message)
+
+    def to_rows(self, message):
+        record_batch = self._parse_arrow_message(message)
+
+        # Iterate through each column simultaneously, and make a dict from the
+        # row values
+        for row in zip(*record_batch.columns):
+            yield dict(zip(self._column_names, row))
+
+    def to_dataframe(self, message, dtypes=None):
+        record_batch = self._parse_arrow_message(message)
+
+        if dtypes is None:
+            dtypes = {}
+
+        df = record_batch.to_pandas()
+
+        for column in dtypes:
+            df[column] = pandas.Series(df[column], dtype=dtypes[column])
+
+        return df
+
+    def _parse_arrow_message(self, message):
+        self._parse_arrow_schema()
+
+        return pyarrow.read_record_batch(
+            pyarrow.py_buffer(message.arrow_record_batch.serialized_record_batch),
+            self._schema,
+        )
+
+    def _parse_arrow_schema(self):
+        if self._schema:
+            return
+
+        self._schema = pyarrow.read_schema(
+            pyarrow.py_buffer(self._read_session.arrow_schema.serialized_schema)
+        )
+        self._column_names = [field.name for field in self._schema]
+
+
+def _copy_stream_position(position):
+    """Copy a StreamPosition.
+
+    Args:
+        position (Union[ \
+            dict, \
+            ~google.cloud.bigquery_storage_v1beta1.types.StreamPosition \
+        ]):
+            StreamPostion (or dictionary in StreamPosition format) to copy.
+
+    Returns:
+        ~google.cloud.bigquery_storage_v1beta1.types.StreamPosition:
+            A copy of the input StreamPostion.
+    """
+    if isinstance(position, types.StreamPosition):
+        output = types.StreamPosition()
+        output.CopyFrom(position)
+        return output
+
+    return types.StreamPosition(**position)
diff --git a/bigquery_storage/google/cloud/bigquery_storage_v1beta1/types.py b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/types.py
new file mode 100644
index 000000000000..fd5a3e35c830
--- /dev/null
+++ b/bigquery_storage/google/cloud/bigquery_storage_v1beta1/types.py
@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.bigquery_storage_v1beta1.proto import arrow_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import avro_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import read_options_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import storage_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import table_reference_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [empty_pb2, timestamp_pb2]
+
+_local_modules = [
+    arrow_pb2,
+    avro_pb2,
+    read_options_pb2,
+    storage_pb2,
+    table_reference_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.bigquery_storage_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/bigquery_storage/noxfile.py b/bigquery_storage/noxfile.py
new file mode 100644
index 000000000000..79b9d3689512
--- /dev/null
+++ b/bigquery_storage/noxfile.py
@@ -0,0 +1,182 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+    session.install("-e", ".[fastavro,pandas,pyarrow]")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".[fastavro,pandas,pyarrow]")
+    session.install("-e", "../bigquery/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python=["2.7", "3.7"])
+def samples(session):
+    requirements_path = os.path.join("samples", "requirements.txt")
+    requirements_exists = os.path.exists(requirements_path)
+
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    if requirements_exists:
+        session.install("-r", requirements_path)
+    session.install("-e", ".")
+
+    session.run("py.test", "--quiet", "samples", *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=79")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/bigquery_storage/samples/__init__.py b/bigquery_storage/samples/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_storage/samples/quickstart.py b/bigquery_storage/samples/quickstart.py
new file mode 100644
index 000000000000..8a3b8617b387
--- /dev/null
+++ b/bigquery_storage/samples/quickstart.py
@@ -0,0 +1,100 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import argparse
+
+
+def main(project_id="your-project-id", snapshot_millis=0):
+    # [START bigquerystorage_quickstart]
+    from google.cloud import bigquery_storage_v1beta1
+
+    # TODO(developer): Set the project_id variable.
+    # project_id = 'your-project-id'
+    #
+    # The read session is created in this project. This project can be
+    # different from that which contains the table.
+
+    client = bigquery_storage_v1beta1.BigQueryStorageClient()
+
+    # This example reads baby name data from the public datasets.
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = "bigquery-public-data"
+    table_ref.dataset_id = "usa_names"
+    table_ref.table_id = "usa_1910_current"
+
+    # We limit the output columns to a subset of those allowed in the table,
+    # and set a simple filter to only report names from the state of
+    # Washington (WA).
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    read_options.selected_fields.append("name")
+    read_options.selected_fields.append("number")
+    read_options.selected_fields.append("state")
+    read_options.row_restriction = 'state = "WA"'
+
+    # Set a snapshot time if it's been specified.
+    modifiers = None
+    if snapshot_millis > 0:
+        modifiers = bigquery_storage_v1beta1.types.TableModifiers()
+        modifiers.snapshot_time.FromMilliseconds(snapshot_millis)
+
+    parent = "projects/{}".format(project_id)
+    session = client.create_read_session(
+        table_ref,
+        parent,
+        table_modifiers=modifiers,
+        read_options=read_options,
+        # This API can also deliver data serialized in Apache Arrow format.
+        # This example leverages Apache Avro.
+        format_=bigquery_storage_v1beta1.enums.DataFormat.AVRO,
+        # We use a LIQUID strategy in this example because we only read from a
+        # single stream. Consider BALANCED if you're consuming multiple streams
+        # concurrently and want more consistent stream sizes.
+        sharding_strategy=(bigquery_storage_v1beta1.enums.ShardingStrategy.LIQUID),
+    )  # API request.
+
+    # We'll use only a single stream for reading data from the table. Because
+    # of dynamic sharding, this will yield all the rows in the table. However,
+    # if you wanted to fan out multiple readers you could do so by having a
+    # reader process each individual stream.
+    reader = client.read_rows(
+        bigquery_storage_v1beta1.types.StreamPosition(stream=session.streams[0])
+    )
+
+    # The read stream contains blocks of Avro-encoded bytes. The rows() method
+    # uses the fastavro library to parse these blocks as an interable of Python
+    # dictionaries. Install fastavro with the following command:
+    #
+    # pip install google-cloud-bigquery-storage[fastavro]
+    rows = reader.rows(session)
+
+    # Do any local processing by iterating over the rows. The
+    # google-cloud-bigquery-storage client reconnects to the API after any
+    # transient network errors or timeouts.
+    names = set()
+    states = set()
+
+    for row in rows:
+        names.add(row["name"])
+        states.add(row["state"])
+
+    print("Got {} unique names in states: {}".format(len(names), states))
+    # [END bigquerystorage_quickstart]
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("project_id")
+    parser.add_argument("--snapshot_millis", default=0, type=int)
+    args = parser.parse_args()
+    main(project_id=args.project_id)
diff --git a/bigquery_storage/samples/requirements.txt b/bigquery_storage/samples/requirements.txt
new file mode 100644
index 000000000000..acd0800e713e
--- /dev/null
+++ b/bigquery_storage/samples/requirements.txt
@@ -0,0 +1 @@
+fastavro
\ No newline at end of file
diff --git a/bigquery_storage/samples/tests/__init__.py b/bigquery_storage/samples/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigquery_storage/samples/tests/quickstart_test.py b/bigquery_storage/samples/tests/quickstart_test.py
new file mode 100644
index 000000000000..fde039f4620b
--- /dev/null
+++ b/bigquery_storage/samples/tests/quickstart_test.py
@@ -0,0 +1,44 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import os
+
+import pytest
+
+from .. import quickstart
+
+
+def now_millis():
+    return int(
+        (datetime.datetime.utcnow() - datetime.datetime(1970, 1, 1)).total_seconds()
+        * 1000
+    )
+
+
+@pytest.fixture()
+def project_id():
+    return os.environ["PROJECT_ID"]
+
+
+def test_quickstart_wo_snapshot(capsys, project_id):
+    quickstart.main(project_id)
+    out, _ = capsys.readouterr()
+    assert "WA" in out
+
+
+def test_quickstart_with_snapshot(capsys, project_id):
+    quickstart.main(project_id, now_millis() - 5000)
+    out, _ = capsys.readouterr()
+    assert "WA" in out
diff --git a/bigquery_storage/setup.cfg b/bigquery_storage/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/bigquery_storage/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/bigquery_storage/setup.py b/bigquery_storage/setup.py
new file mode 100644
index 000000000000..29b968a59501
--- /dev/null
+++ b/bigquery_storage/setup.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-bigquery-storage"
+description = "BigQuery Storage API API client library"
+version = "0.7.0"
+release_status = "Development Status :: 4 - Beta"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+extras = {
+    "pandas": "pandas>=0.17.1",
+    "fastavro": "fastavro>=0.21.2",
+    "pyarrow": "pyarrow>=0.13.0, != 0.14.0",
+}
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/bigquery_storage/synth.metadata b/bigquery_storage/synth.metadata
new file mode 100644
index 000000000000..5695e76c7e81
--- /dev/null
+++ b/bigquery_storage/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-21T23:20:45.275738Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.34.0",
+        "dockerImage": "googleapis/artman@sha256:38a27ba6245f96c3e86df7acb2ebcc33b4f186d9e475efe2d64303aec3d4e0ea"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "git@github.com:googleapis/googleapis.git",
+        "sha": "92bebf78345af8b2d3585220527115bda8bdedf8",
+        "internalRef": "264715111"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "bigquery_storage",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/bigquery/storage/artman_bigquerystorage_v1beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/bigquery_storage/synth.py b/bigquery_storage/synth.py
new file mode 100644
index 000000000000..cbbeffd02acf
--- /dev/null
+++ b/bigquery_storage/synth.py
@@ -0,0 +1,136 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+version = "v1beta1"
+
+library = gapic.py_library(
+    "bigquery_storage",
+    version,
+    config_path="/google/cloud/bigquery/storage/" "artman_bigquerystorage_v1beta1.yaml",
+    artman_output_name="bigquerystorage-v1beta1",
+    include_protos=True,
+)
+
+s.move(
+    library,
+    excludes=[
+        "docs/conf.py",
+        "docs/index.rst",
+        "google/cloud/bigquery_storage_v1beta1/__init__.py",
+        "README.rst",
+        "nox*.py",
+        "setup.py",
+        "setup.cfg",
+    ],
+)
+
+s.replace(
+    [
+        "google/cloud/bigquery_storage_v1beta1/proto/storage_pb2.py",
+        "google/cloud/bigquery_storage_v1beta1/proto/storage_pb2_grpc.py",
+    ],
+    "from google.cloud.bigquery.storage_v1beta1.proto",
+    "from google.cloud.bigquery_storage_v1beta1.proto",
+)
+
+s.replace(
+    "google/cloud/bigquery_storage_v1beta1/gapic/" "big_query_storage_client.py",
+    "google-cloud-bigquerystorage",
+    "google-cloud-bigquery-storage",
+)
+
+s.replace(
+    "google/cloud/bigquery_storage_v1beta1/gapic/" "big_query_storage_client.py",
+    "import google.api_core.gapic_v1.method\n",
+    "\g<0>import google.api_core.path_template\n",
+)
+
+s.replace(
+    ["tests/unit/gapic/v1beta1/test_big_query_storage_client_v1beta1.py"],
+    "from google.cloud import bigquery_storage_v1beta1",
+    "from google.cloud.bigquery_storage_v1beta1.gapic import big_query_storage_client  # noqa",
+)
+
+s.replace(
+    ["tests/unit/gapic/v1beta1/test_big_query_storage_client_v1beta1.py"],
+    "bigquery_storage_v1beta1.BigQueryStorageClient",
+    "big_query_storage_client.BigQueryStorageClient",
+)
+
+# START: Ignore lint and coverage
+s.replace(
+    ["google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py"],
+    "if transport:",
+    "if transport:  # pragma: no cover",
+)
+
+s.replace(
+    ["google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py"],
+    r"to_grpc_metadata\(\n",
+    "to_grpc_metadata(  # pragma: no cover\n",
+)
+
+s.replace(
+    ["google/cloud/bigquery_storage_v1beta1/gapic/big_query_storage_client.py"],
+    r"metadata.append\(routing_metadata\)",
+    "metadata.append(routing_metadata)  # pragma: no cover",
+)
+
+s.replace(
+    [
+        "google/cloud/bigquery_storage_v1beta1/gapic/transports/big_query_storage_grpc_transport.py"
+    ],
+    "if channel is not None and credentials is not None:",
+    "if channel is not None and credentials is not None:  # pragma: no cover",
+)
+
+s.replace(
+    [
+        "google/cloud/bigquery_storage_v1beta1/gapic/transports/big_query_storage_grpc_transport.py"
+    ],
+    "if channel is None:",
+    "if channel is None:  # pragma: no cover",
+)
+
+s.replace(
+    [
+        "google/cloud/bigquery_storage_v1beta1/gapic/transports/big_query_storage_grpc_transport.py"
+    ],
+    r"google.api_core.grpc_helpers.create_channel\(",
+    "google.api_core.grpc_helpers.create_channel(  # pragma: no cover",
+)
+# END: Ignore lint and coverage
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+optional_deps = [".[fastavro,pandas,pyarrow]"]
+system_test_deps = optional_deps + ["../bigquery/"]
+templated_files = common.py_library(
+    unit_cov_level=79,
+    cov_level=79,
+    samples_test=True,
+    system_test_dependencies=system_test_deps,
+    unit_test_dependencies=optional_deps,
+)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/bigquery_storage/tests/system/assets/people_data.csv b/bigquery_storage/tests/system/assets/people_data.csv
new file mode 100644
index 000000000000..819adfc4bdf5
--- /dev/null
+++ b/bigquery_storage/tests/system/assets/people_data.csv
@@ -0,0 +1,6 @@
+first_name,last_name,age
+John,Doe,42
+Jack,Black,53
+Nick,Sleek,24
+Kevin,Powell,50
+Johnny,Young,2
diff --git a/bigquery_storage/tests/system/conftest.py b/bigquery_storage/tests/system/conftest.py
new file mode 100644
index 000000000000..5ca85c1b42c8
--- /dev/null
+++ b/bigquery_storage/tests/system/conftest.py
@@ -0,0 +1,233 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""System tests for reading rows from tables."""
+
+import os
+import uuid
+
+import pytest
+
+from google.cloud import bigquery_storage_v1beta1
+
+
+_ASSETS_DIR = os.path.join(os.path.abspath(os.path.dirname(__file__)), "assets")
+
+
+@pytest.fixture(scope="session")
+def project_id():
+    return os.environ["PROJECT_ID"]
+
+
+@pytest.fixture(scope="session")
+def credentials():
+    from google.oauth2 import service_account
+
+    # NOTE: the test config in noxfile checks that the env variable is indeed set
+    filename = os.environ["GOOGLE_APPLICATION_CREDENTIALS"]
+    return service_account.Credentials.from_service_account_file(filename)
+
+
+@pytest.fixture(scope="session")
+def bq_client(credentials):
+    from google.cloud import bigquery
+
+    return bigquery.Client(credentials=credentials)
+
+
+@pytest.fixture(scope="session")
+def dataset(project_id, bq_client):
+    from google.cloud import bigquery
+
+    unique_suffix = str(uuid.uuid4()).replace("-", "_")
+    dataset_name = "bq_storage_system_tests_" + unique_suffix
+
+    dataset_id = "{}.{}".format(project_id, dataset_name)
+    dataset = bigquery.Dataset(dataset_id)
+    dataset.location = "US"
+    created_dataset = bq_client.create_dataset(dataset)
+
+    yield created_dataset
+
+    bq_client.delete_dataset(dataset, delete_contents=True)
+
+
+@pytest.fixture(scope="session")
+def table(project_id, dataset, bq_client):
+    from google.cloud import bigquery
+
+    schema = [
+        bigquery.SchemaField("first_name", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("last_name", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("age", "INTEGER", mode="NULLABLE"),
+    ]
+
+    table_id = "{}.{}.{}".format(project_id, dataset.dataset_id, "users")
+    bq_table = bigquery.Table(table_id, schema=schema)
+    created_table = bq_client.create_table(bq_table)
+
+    yield created_table
+
+    bq_client.delete_table(created_table)
+
+
+@pytest.fixture
+def table_with_data_ref(dataset, table, bq_client):
+    from google.cloud import bigquery
+
+    job_config = bigquery.LoadJobConfig()
+    job_config.source_format = bigquery.SourceFormat.CSV
+    job_config.skip_leading_rows = 1
+    job_config.schema = table.schema
+
+    filename = os.path.join(_ASSETS_DIR, "people_data.csv")
+
+    with open(filename, "rb") as source_file:
+        job = bq_client.load_table_from_file(source_file, table, job_config=job_config)
+
+    job.result()  # wait for the load to complete
+
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = table.project
+    table_ref.dataset_id = table.dataset_id
+    table_ref.table_id = table.table_id
+    yield table_ref
+
+    # truncate table data
+    query = "DELETE FROM {}.{} WHERE 1 = 1".format(dataset.dataset_id, table.table_id)
+    query_job = bq_client.query(query, location="US")
+    query_job.result()
+
+
+@pytest.fixture
+def col_partition_table_ref(project_id, dataset, bq_client):
+    from google.cloud import bigquery
+
+    schema = [
+        bigquery.SchemaField("occurred", "DATE", mode="NULLABLE"),
+        bigquery.SchemaField("description", "STRING", mode="NULLABLE"),
+    ]
+    time_partitioning = bigquery.table.TimePartitioning(
+        type_=bigquery.table.TimePartitioningType.DAY, field="occurred"
+    )
+    bq_table = bigquery.table.Table(
+        table_ref="{}.{}.notable_events".format(project_id, dataset.dataset_id),
+        schema=schema,
+    )
+    bq_table.time_partitioning = time_partitioning
+
+    created_table = bq_client.create_table(bq_table)
+
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = created_table.project
+    table_ref.dataset_id = created_table.dataset_id
+    table_ref.table_id = created_table.table_id
+    yield table_ref
+
+    bq_client.delete_table(created_table)
+
+
+@pytest.fixture
+def ingest_partition_table_ref(project_id, dataset, bq_client):
+    from google.cloud import bigquery
+
+    schema = [
+        bigquery.SchemaField("shape", "STRING", mode="NULLABLE"),
+        bigquery.SchemaField("altitude", "INT64", mode="NULLABLE"),
+    ]
+    time_partitioning = bigquery.table.TimePartitioning(
+        type_=bigquery.table.TimePartitioningType.DAY,
+        field=None,  # use _PARTITIONTIME pseudo column
+    )
+    bq_table = bigquery.table.Table(
+        table_ref="{}.{}.ufo_sightings".format(project_id, dataset.dataset_id),
+        schema=schema,
+    )
+    bq_table.time_partitioning = time_partitioning
+
+    created_table = bq_client.create_table(bq_table)
+
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = created_table.project
+    table_ref.dataset_id = created_table.dataset_id
+    table_ref.table_id = created_table.table_id
+    yield table_ref
+
+    bq_client.delete_table(created_table)
+
+
+@pytest.fixture
+def all_types_table_ref(project_id, dataset, bq_client):
+    from google.cloud import bigquery
+
+    schema = [
+        bigquery.SchemaField("string_field", "STRING"),
+        bigquery.SchemaField("bytes_field", "BYTES"),
+        bigquery.SchemaField("int64_field", "INT64"),
+        bigquery.SchemaField("float64_field", "FLOAT64"),
+        bigquery.SchemaField("numeric_field", "NUMERIC"),
+        bigquery.SchemaField("bool_field", "BOOL"),
+        bigquery.SchemaField("geography_field", "GEOGRAPHY"),
+        bigquery.SchemaField(
+            "person_struct_field",
+            "STRUCT",
+            fields=(
+                bigquery.SchemaField("name", "STRING"),
+                bigquery.SchemaField("age", "INT64"),
+            ),
+        ),
+        bigquery.SchemaField("timestamp_field", "TIMESTAMP"),
+        bigquery.SchemaField("date_field", "DATE"),
+        bigquery.SchemaField("time_field", "TIME"),
+        bigquery.SchemaField("datetime_field", "DATETIME"),
+        bigquery.SchemaField("string_array_field", "STRING", mode="REPEATED"),
+    ]
+    bq_table = bigquery.table.Table(
+        table_ref="{}.{}.complex_records".format(project_id, dataset.dataset_id),
+        schema=schema,
+    )
+
+    created_table = bq_client.create_table(bq_table)
+
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = created_table.project
+    table_ref.dataset_id = created_table.dataset_id
+    table_ref.table_id = created_table.table_id
+    yield table_ref
+
+    bq_client.delete_table(created_table)
+
+
+@pytest.fixture(scope="session")
+def client(credentials):
+    return bigquery_storage_v1beta1.BigQueryStorageClient(credentials=credentials)
+
+
+@pytest.fixture()
+def table_reference():
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = "bigquery-public-data"
+    table_ref.dataset_id = "usa_names"
+    table_ref.table_id = "usa_1910_2013"
+    return table_ref
+
+
+@pytest.fixture()
+def small_table_reference():
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = "bigquery-public-data"
+    table_ref.dataset_id = "utility_us"
+    table_ref.table_id = "country_code_iso"
+    return table_ref
diff --git a/bigquery_storage/tests/system/test_reader.py b/bigquery_storage/tests/system/test_reader.py
new file mode 100644
index 000000000000..2ba1f99fb0a0
--- /dev/null
+++ b/bigquery_storage/tests/system/test_reader.py
@@ -0,0 +1,456 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""System tests for reading rows from tables."""
+
+import copy
+import datetime as dt
+import decimal
+import re
+
+import pytest
+import pytz
+
+from google.cloud import bigquery
+from google.cloud import bigquery_storage_v1beta1
+from google.protobuf import timestamp_pb2
+
+
+def _to_bq_table_ref(proto_table_ref, partition_suffix=""):
+    """Converts protobuf table reference to bigquery table reference.
+
+    Args:
+        proto_table_ref (bigquery_storage_v1beta1.types.TableReference):
+            A protobuf reference to a table.
+        partition_suffix (str):
+            An optional suffix to append to the table_id, useful for selecting
+            partitions of ingestion-time partitioned tables.
+
+    Returns:
+        google.cloud.bigquery.table.TableReference
+    """
+    return bigquery.table.TableReference.from_api_repr(
+        {
+            "projectId": proto_table_ref.project_id,
+            "datasetId": proto_table_ref.dataset_id,
+            "tableId": proto_table_ref.table_id + partition_suffix,
+        }
+    )
+
+
+@pytest.mark.parametrize(
+    "data_format,expected_schema_type",
+    (
+        (None, "avro_schema"),  # Default format (Avro).
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO, "avro_schema"),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW, "arrow_schema"),
+    ),
+)
+def test_read_rows_as_blocks_full_table(
+    client, project_id, small_table_reference, data_format, expected_schema_type
+):
+    session = client.create_read_session(
+        small_table_reference,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+    schema_type = session.WhichOneof("schema")
+    assert schema_type == expected_schema_type
+
+    blocks = list(client.read_rows(stream_pos))
+
+    assert len(blocks) > 0
+    block = blocks[0]
+    assert block.status.estimated_row_count > 0
+
+
+@pytest.mark.parametrize(
+    "data_format,expected_schema_type",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO, "avro_schema"),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW, "arrow_schema"),
+    ),
+)
+def test_read_rows_as_rows_full_table(
+    client, project_id, small_table_reference, data_format, expected_schema_type
+):
+    session = client.create_read_session(
+        small_table_reference,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    assert len(rows) > 0
+
+
+@pytest.mark.parametrize(
+    "data_format",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW),
+    ),
+)
+def test_basic_nonfiltered_read(client, project_id, table_with_data_ref, data_format):
+    session = client.create_read_session(
+        table_with_data_ref,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    assert len(rows) == 5  # all table rows
+
+
+def test_filtered_rows_read(client, project_id, table_with_data_ref):
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    read_options.row_restriction = "age >= 50"
+
+    session = client.create_read_session(
+        table_with_data_ref,
+        "projects/{}".format(project_id),
+        format_=bigquery_storage_v1beta1.enums.DataFormat.AVRO,
+        requested_streams=1,
+        read_options=read_options,
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    assert len(rows) == 2
+
+
+@pytest.mark.parametrize(
+    "data_format",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW),
+    ),
+)
+def test_column_selection_read(client, project_id, table_with_data_ref, data_format):
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    read_options.selected_fields.append("first_name")
+    read_options.selected_fields.append("age")
+
+    session = client.create_read_session(
+        table_with_data_ref,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+        read_options=read_options,
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    for row in rows:
+        assert sorted(row.keys()) == ["age", "first_name"]
+
+
+def test_snapshot(client, project_id, table_with_data_ref, bq_client):
+    before_new_data = timestamp_pb2.Timestamp()
+    before_new_data.GetCurrentTime()
+
+    # load additional data into the table
+    new_data = [
+        {u"first_name": u"NewGuyFoo", u"last_name": u"Smith", u"age": 46},
+        {u"first_name": u"NewGuyBar", u"last_name": u"Jones", u"age": 30},
+    ]
+
+    destination = _to_bq_table_ref(table_with_data_ref)
+    bq_client.load_table_from_json(new_data, destination).result()
+
+    # read data using the timestamp before the additional data load
+    session = client.create_read_session(
+        table_with_data_ref,
+        "projects/{}".format(project_id),
+        format_=bigquery_storage_v1beta1.enums.DataFormat.AVRO,
+        requested_streams=1,
+        table_modifiers={"snapshot_time": before_new_data},
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    # verify that only the data before the timestamp was returned
+    assert len(rows) == 5  # all initial records
+
+    for row in rows:
+        assert "NewGuy" not in row["first_name"]  # no new records
+
+
+def test_column_partitioned_table(
+    client, project_id, col_partition_table_ref, bq_client
+):
+    data = [
+        {"description": "Tracking established.", "occurred": "2017-02-15"},
+        {"description": "Look, a solar eclipse!", "occurred": "2018-02-15"},
+        {"description": "Fake solar eclipse reported.", "occurred": "2018-02-15"},
+        {"description": "1 day after false eclipse report.", "occurred": "2018-02-16"},
+        {"description": "1 year after false eclipse report.", "occurred": "2019-02-15"},
+    ]
+
+    destination = _to_bq_table_ref(col_partition_table_ref)
+    bq_client.load_table_from_json(data, destination).result()
+
+    # Read from the table with a partition filter specified, and verify that
+    # only the expected data is returned.
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    read_options.row_restriction = "occurred = '2018-02-15'"
+
+    session = client.create_read_session(
+        col_partition_table_ref,
+        "projects/{}".format(project_id),
+        format_=bigquery_storage_v1beta1.enums.DataFormat.AVRO,
+        requested_streams=1,
+        read_options=read_options,
+    )
+
+    assert session.streams  # there should be some data to fetch
+
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    assert len(rows) == 2
+
+    expected_descriptions = ("Look, a solar eclipse!", "Fake solar eclipse reported.")
+    for row in rows:
+        assert row["occurred"] == dt.date(2018, 2, 15)
+        assert row["description"] in expected_descriptions
+
+
+@pytest.mark.parametrize(
+    "data_format",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW),
+    ),
+)
+def test_ingestion_time_partitioned_table(
+    client, project_id, ingest_partition_table_ref, bq_client, data_format
+):
+    data = [{"shape": "cigar", "altitude": 1200}, {"shape": "disc", "altitude": 750}]
+    destination = _to_bq_table_ref(
+        ingest_partition_table_ref, partition_suffix="$20190809"
+    )
+    bq_client.load_table_from_json(data, destination).result()
+
+    data = [
+        {"shape": "sphere", "altitude": 3500},
+        {"shape": "doughnut", "altitude": 100},
+    ]
+    destination = _to_bq_table_ref(
+        ingest_partition_table_ref, partition_suffix="$20190810"
+    )
+    bq_client.load_table_from_json(data, destination).result()
+
+    data = [
+        {"shape": "elephant", "altitude": 1},
+        {"shape": "rocket", "altitude": 12700},
+    ]
+    destination = _to_bq_table_ref(
+        ingest_partition_table_ref, partition_suffix="$20190811"
+    )
+    bq_client.load_table_from_json(data, destination).result()
+
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    read_options.row_restriction = "DATE(_PARTITIONTIME) = '2019-08-10'"
+
+    session = client.create_read_session(
+        ingest_partition_table_ref,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+        read_options=read_options,
+    )
+
+    assert session.streams  # there should be some data to fetch
+
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+    rows = list(client.read_rows(stream_pos).rows(session))
+    assert len(rows) == 2
+
+    actual_items = {(row["shape"], row["altitude"]) for row in rows}
+    expected_items = {("sphere", 3500), ("doughnut", 100)}
+    assert actual_items == expected_items
+
+
+@pytest.mark.parametrize(
+    "data_format",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW),
+    ),
+)
+def test_decoding_data_types(
+    client, project_id, all_types_table_ref, bq_client, data_format
+):
+    data = [
+        {
+            u"string_field": u"Price: € 9.95.",
+            u"bytes_field": bigquery._helpers._bytes_to_json(b"byteees"),
+            u"int64_field": -1085,
+            u"float64_field": -42.195,
+            u"numeric_field": "1.4142",
+            u"bool_field": True,
+            u"geography_field": '{"type": "Point", "coordinates": [-49.3028, 69.0622]}',
+            u"person_struct_field": {u"name": u"John", u"age": 42},
+            u"timestamp_field": 1565357902.017896,  # 2019-08-09T13:38:22.017896
+            u"date_field": u"1995-03-17",
+            u"time_field": u"16:24:51",
+            u"datetime_field": u"2005-10-26T19:49:41",
+            u"string_array_field": [u"foo", u"bar", u"baz"],
+        }
+    ]
+
+    # Explicit schema is needed to recognize bytes_field as BYTES, and not STRING.
+    # Since partial schemas are not supported in load_table_from_json(), a full
+    # schema needs to be specified.
+    schema = [
+        bigquery.SchemaField("string_field", "STRING"),
+        bigquery.SchemaField("bytes_field", "BYTES"),
+        bigquery.SchemaField("int64_field", "INT64"),
+        bigquery.SchemaField("float64_field", "FLOAT64"),
+        bigquery.SchemaField("numeric_field", "NUMERIC"),
+        bigquery.SchemaField("bool_field", "BOOL"),
+        bigquery.SchemaField("geography_field", "GEOGRAPHY"),
+        bigquery.SchemaField(
+            "person_struct_field",
+            "STRUCT",
+            fields=(
+                bigquery.SchemaField("name", "STRING"),
+                bigquery.SchemaField("age", "INT64"),
+            ),
+        ),
+        bigquery.SchemaField("timestamp_field", "TIMESTAMP"),
+        bigquery.SchemaField("date_field", "DATE"),
+        bigquery.SchemaField("time_field", "TIME"),
+        bigquery.SchemaField("datetime_field", "DATETIME"),
+        bigquery.SchemaField("string_array_field", "STRING", mode="REPEATED"),
+    ]
+
+    job_config = bigquery.LoadJobConfig(schema=schema)
+    destination = _to_bq_table_ref(all_types_table_ref)
+    bq_client.load_table_from_json(data, destination, job_config=job_config).result()
+
+    session = client.create_read_session(
+        all_types_table_ref,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+    )
+
+    assert session.streams  # there should be data available
+
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    rows = list(client.read_rows(stream_pos).rows(session))
+
+    expected_result = {
+        u"string_field": u"Price: € 9.95.",
+        u"bytes_field": b"byteees",
+        u"int64_field": -1085,
+        u"float64_field": -42.195,
+        u"numeric_field": decimal.Decimal("1.4142"),
+        u"bool_field": True,
+        u"geography_field": "POINT(-49.3028 69.0622)",
+        u"person_struct_field": {u"name": u"John", u"age": 42},
+        u"timestamp_field": dt.datetime(2019, 8, 9, 13, 38, 22, 17896, tzinfo=pytz.UTC),
+        u"date_field": dt.date(1995, 3, 17),
+        u"time_field": dt.time(16, 24, 51),
+        u"string_array_field": [u"foo", u"bar", u"baz"],
+    }
+
+    result_copy = copy.copy(rows[0])
+    del result_copy["datetime_field"]
+    assert result_copy == expected_result
+
+    # Compare datetime separately, AVRO and PYARROW return different object types,
+    # although they should both represent the same value.
+    # TODO: when fixed, change assertion to assert a datetime instance!
+    expected_pattern = re.compile(r"2005-10-26( |T)19:49:41")
+    assert expected_pattern.match(str(rows[0]["datetime_field"]))
+
+
+@pytest.mark.parametrize(
+    "data_format",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW),
+    ),
+)
+def test_resuming_read_from_offset(client, project_id, data_format):
+    shakespeare_ref = bigquery_storage_v1beta1.types.TableReference()
+    shakespeare_ref.project_id = project_id
+    shakespeare_ref.dataset_id = "public_samples_copy"
+    shakespeare_ref.table_id = "shakespeare"
+
+    read_session = client.create_read_session(
+        shakespeare_ref,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+    )
+
+    assert read_session.streams  # there should be data available
+
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=read_session.streams[0], offset=0
+    )
+    read_rows_stream = client.read_rows(stream_pos)
+
+    # fetch the first two batches of rows
+    rows_iter = iter(read_rows_stream)
+    some_rows = next(rows_iter)
+    more_rows = next(rows_iter)
+
+    # fetch the rest of the rows using the stream offset
+    new_stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=read_session.streams[0], offset=some_rows.row_count + more_rows.row_count
+    )
+    remaining_rows_count = sum(
+        1 for _ in client.read_rows(new_stream_pos).rows(read_session)
+    )
+
+    # verify that the counts match
+    expected_len = 164656  # total rows in shakespeare table
+    actual_len = remaining_rows_count + some_rows.row_count + more_rows.row_count
+    assert actual_len == expected_len
diff --git a/bigquery_storage/tests/system/test_reader_dataframe.py b/bigquery_storage/tests/system/test_reader_dataframe.py
new file mode 100644
index 000000000000..07dcab384c05
--- /dev/null
+++ b/bigquery_storage/tests/system/test_reader_dataframe.py
@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""System tests for reading rows with pandas connector."""
+
+import numpy
+import pyarrow.types
+import pytest
+
+from google.cloud import bigquery_storage_v1beta1
+
+
+def test_read_rows_to_arrow(client, project_id):
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = "bigquery-public-data"
+    table_ref.dataset_id = "new_york_citibike"
+    table_ref.table_id = "citibike_stations"
+
+    read_options = bigquery_storage_v1beta1.types.TableReadOptions()
+    read_options.selected_fields.append("station_id")
+    read_options.selected_fields.append("latitude")
+    read_options.selected_fields.append("longitude")
+    read_options.selected_fields.append("name")
+    session = client.create_read_session(
+        table_ref,
+        "projects/{}".format(project_id),
+        format_=bigquery_storage_v1beta1.enums.DataFormat.ARROW,
+        read_options=read_options,
+        requested_streams=1,
+    )
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    tbl = client.read_rows(stream_pos).to_arrow(session)
+
+    assert tbl.num_columns == 4
+    schema = tbl.schema
+    # Use field_by_name because the order doesn't currently match that of
+    # selected_fields.
+    assert pyarrow.types.is_int64(schema.field_by_name("station_id").type)
+    assert pyarrow.types.is_float64(schema.field_by_name("latitude").type)
+    assert pyarrow.types.is_float64(schema.field_by_name("longitude").type)
+    assert pyarrow.types.is_string(schema.field_by_name("name").type)
+
+
+@pytest.mark.parametrize(
+    "data_format,expected_schema_type",
+    (
+        (bigquery_storage_v1beta1.enums.DataFormat.AVRO, "avro_schema"),
+        (bigquery_storage_v1beta1.enums.DataFormat.ARROW, "arrow_schema"),
+    ),
+)
+def test_read_rows_to_dataframe(client, project_id, data_format, expected_schema_type):
+    table_ref = bigquery_storage_v1beta1.types.TableReference()
+    table_ref.project_id = "bigquery-public-data"
+    table_ref.dataset_id = "new_york_citibike"
+    table_ref.table_id = "citibike_stations"
+    session = client.create_read_session(
+        table_ref,
+        "projects/{}".format(project_id),
+        format_=data_format,
+        requested_streams=1,
+    )
+    schema_type = session.WhichOneof("schema")
+    assert schema_type == expected_schema_type
+
+    stream_pos = bigquery_storage_v1beta1.types.StreamPosition(
+        stream=session.streams[0]
+    )
+
+    frame = client.read_rows(stream_pos).to_dataframe(
+        session, dtypes={"latitude": numpy.float16}
+    )
+
+    # Station ID is a required field (no nulls), so the datatype should always
+    # be integer.
+    assert frame.station_id.dtype.name == "int64"
+    assert frame.latitude.dtype.name == "float16"
+    assert frame.longitude.dtype.name == "float64"
+    assert frame["name"].str.startswith("Central Park").any()
diff --git a/bigquery_storage/tests/unit/gapic/v1beta1/test_big_query_storage_client_v1beta1.py b/bigquery_storage/tests/unit/gapic/v1beta1/test_big_query_storage_client_v1beta1.py
new file mode 100644
index 000000000000..e7870b1d25d6
--- /dev/null
+++ b/bigquery_storage/tests/unit/gapic/v1beta1/test_big_query_storage_client_v1beta1.py
@@ -0,0 +1,261 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.bigquery_storage_v1beta1.gapic import big_query_storage_client  # noqa
+from google.cloud.bigquery_storage_v1beta1.proto import storage_pb2
+from google.cloud.bigquery_storage_v1beta1.proto import table_reference_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestBigQueryStorageClient(object):
+    def test_create_read_session(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = storage_pb2.ReadSession(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup Request
+        table_reference = {}
+        parent = "parent-995424086"
+
+        response = client.create_read_session(table_reference, parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = storage_pb2.CreateReadSessionRequest(
+            table_reference=table_reference, parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_read_session_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup request
+        table_reference = {}
+        parent = "parent-995424086"
+
+        with pytest.raises(CustomException):
+            client.create_read_session(table_reference, parent)
+
+    def test_read_rows(self):
+        # Setup Expected Response
+        row_count = 1340416618
+        expected_response = {"row_count": row_count}
+        expected_response = storage_pb2.ReadRowsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup Request
+        read_position = {}
+
+        response = client.read_rows(read_position)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = storage_pb2.ReadRowsRequest(read_position=read_position)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_read_rows_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup request
+        read_position = {}
+
+        with pytest.raises(CustomException):
+            client.read_rows(read_position)
+
+    def test_batch_create_read_session_streams(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = storage_pb2.BatchCreateReadSessionStreamsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup Request
+        session = {}
+        requested_streams = 1017221410
+
+        response = client.batch_create_read_session_streams(session, requested_streams)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = storage_pb2.BatchCreateReadSessionStreamsRequest(
+            session=session, requested_streams=requested_streams
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_create_read_session_streams_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup request
+        session = {}
+        requested_streams = 1017221410
+
+        with pytest.raises(CustomException):
+            client.batch_create_read_session_streams(session, requested_streams)
+
+    def test_finalize_stream(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup Request
+        stream = {}
+
+        client.finalize_stream(stream)
+
+        assert len(channel.requests) == 1
+        expected_request = storage_pb2.FinalizeStreamRequest(stream=stream)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_finalize_stream_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup request
+        stream = {}
+
+        with pytest.raises(CustomException):
+            client.finalize_stream(stream)
+
+    def test_split_read_stream(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = storage_pb2.SplitReadStreamResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup Request
+        original_stream = {}
+
+        response = client.split_read_stream(original_stream)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = storage_pb2.SplitReadStreamRequest(
+            original_stream=original_stream
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_split_read_stream_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = big_query_storage_client.BigQueryStorageClient()
+
+        # Setup request
+        original_stream = {}
+
+        with pytest.raises(CustomException):
+            client.split_read_stream(original_stream)
diff --git a/bigquery_storage/tests/unit/test_client.py b/bigquery_storage/tests/unit/test_client.py
new file mode 100644
index 000000000000..fbce027d136e
--- /dev/null
+++ b/bigquery_storage/tests/unit/test_client.py
@@ -0,0 +1,90 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.api_core.gapic_v1 import client_info
+import mock
+import pytest
+
+from google.cloud.bigquery_storage_v1beta1 import types
+
+
+PROJECT = "my-project"
+SERVICE_ACCOUNT_PROJECT = "project-from-credentials"
+
+
+@pytest.fixture()
+def mock_transport(monkeypatch):
+    from google.cloud.bigquery_storage_v1beta1.gapic.transports import (
+        big_query_storage_grpc_transport,
+    )
+
+    transport = mock.create_autospec(
+        big_query_storage_grpc_transport.BigQueryStorageGrpcTransport
+    )
+    return transport
+
+
+@pytest.fixture()
+def client_under_test(mock_transport):
+    from google.cloud.bigquery_storage_v1beta1 import client
+
+    # The mock is detected as a callable. By creating a real callable here, the
+    # mock can still be used to verify RPCs.
+    def transport_callable(credentials=None, default_class=None, address=None):
+        return mock_transport
+
+    return client.BigQueryStorageClient(transport=transport_callable)
+
+
+def test_constructor_w_client_info(mock_transport):
+    from google.cloud.bigquery_storage_v1beta1 import client
+
+    def transport_callable(credentials=None, default_class=None, address=None):
+        return mock_transport
+
+    client_under_test = client.BigQueryStorageClient(
+        transport=transport_callable,
+        client_info=client_info.ClientInfo(
+            client_library_version="test-client-version"
+        ),
+    )
+
+    user_agent = client_under_test._client_info.to_user_agent()
+    assert "test-client-version" in user_agent
+
+
+def test_create_read_session(mock_transport, client_under_test):
+    table_reference = types.TableReference(
+        project_id="data-project-id", dataset_id="dataset_id", table_id="table_id"
+    )
+
+    client_under_test.create_read_session(table_reference, "projects/other-project")
+
+    expected_request = types.CreateReadSessionRequest(
+        table_reference=table_reference, parent="projects/other-project"
+    )
+    mock_transport.create_read_session.assert_called_once_with(
+        expected_request, metadata=mock.ANY, timeout=mock.ANY
+    )
+
+
+def test_read_rows(mock_transport, client_under_test):
+    stream_position = types.StreamPosition()
+
+    client_under_test.read_rows(stream_position)
+
+    expected_request = types.ReadRowsRequest(read_position=stream_position)
+    mock_transport.create_read_session.read_rows(
+        expected_request, metadata=mock.ANY, timeout=mock.ANY
+    )
diff --git a/bigquery_storage/tests/unit/test_reader.py b/bigquery_storage/tests/unit/test_reader.py
new file mode 100644
index 000000000000..748a45608f3a
--- /dev/null
+++ b/bigquery_storage/tests/unit/test_reader.py
@@ -0,0 +1,738 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an 'AS IS' BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import decimal
+import itertools
+import json
+
+import fastavro
+import pyarrow
+import mock
+import pandas
+import pandas.testing
+import pytest
+import pytz
+import six
+
+import google.api_core.exceptions
+from google.cloud import bigquery_storage_v1beta1
+
+
+PROJECT = "my-project"
+BQ_TO_AVRO_TYPES = {
+    "int64": "long",
+    "float64": "double",
+    "bool": "boolean",
+    "numeric": {"type": "bytes", "logicalType": "decimal", "precision": 38, "scale": 9},
+    "string": "string",
+    "bytes": "bytes",
+    "date": {"type": "int", "logicalType": "date"},
+    "datetime": {"type": "string", "sqlType": "DATETIME"},
+    "time": {"type": "long", "logicalType": "time-micros"},
+    "timestamp": {"type": "long", "logicalType": "timestamp-micros"},
+}
+# This dictionary is duplicated in bigquery/google/cloud/bigquery/_pandas_helpers.py
+# When modifying it be sure to update it there as well.
+BQ_TO_ARROW_TYPES = {
+    "int64": pyarrow.int64(),
+    "float64": pyarrow.float64(),
+    "bool": pyarrow.bool_(),
+    "numeric": pyarrow.decimal128(38, 9),
+    "string": pyarrow.utf8(),
+    "bytes": pyarrow.binary(),
+    "date": pyarrow.date32(),  # int32 days since epoch
+    "datetime": pyarrow.timestamp("us"),
+    "time": pyarrow.time64("us"),
+    "timestamp": pyarrow.timestamp("us", tz="UTC"),
+}
+SCALAR_COLUMNS = [
+    {"name": "int_col", "type": "int64"},
+    {"name": "float_col", "type": "float64"},
+    {"name": "num_col", "type": "numeric"},
+    {"name": "bool_col", "type": "bool"},
+    {"name": "str_col", "type": "string"},
+    {"name": "bytes_col", "type": "bytes"},
+    {"name": "date_col", "type": "date"},
+    {"name": "time_col", "type": "time"},
+    {"name": "ts_col", "type": "timestamp"},
+]
+SCALAR_COLUMN_NAMES = [field["name"] for field in SCALAR_COLUMNS]
+SCALAR_BLOCKS = [
+    [
+        {
+            "int_col": 123,
+            "float_col": 3.14,
+            "num_col": decimal.Decimal("9.99"),
+            "bool_col": True,
+            "str_col": "hello world",
+            "bytes_col": b"ascii bytes",
+            "date_col": datetime.date(1998, 9, 4),
+            "time_col": datetime.time(12, 0),
+            "ts_col": datetime.datetime(2000, 1, 1, 5, 0, tzinfo=pytz.utc),
+        },
+        {
+            "int_col": 456,
+            "float_col": 2.72,
+            "num_col": decimal.Decimal("0.99"),
+            "bool_col": False,
+            "str_col": "hallo welt",
+            "bytes_col": b"\xbb\xee\xff",
+            "date_col": datetime.date(1995, 3, 2),
+            "time_col": datetime.time(13, 37),
+            "ts_col": datetime.datetime(1965, 4, 3, 2, 1, tzinfo=pytz.utc),
+        },
+    ],
+    [
+        {
+            "int_col": 789,
+            "float_col": 1.23,
+            "num_col": decimal.Decimal("5.67"),
+            "bool_col": True,
+            "str_col": u"こんにちは世界",
+            "bytes_col": b"\x54\x69\x6d",
+            "date_col": datetime.date(1970, 1, 1),
+            "time_col": datetime.time(16, 20),
+            "ts_col": datetime.datetime(1991, 8, 25, 20, 57, 8, tzinfo=pytz.utc),
+        }
+    ],
+]
+
+
+@pytest.fixture()
+def mut():
+    from google.cloud.bigquery_storage_v1beta1 import reader
+
+    return reader
+
+
+@pytest.fixture()
+def class_under_test(mut):
+    return mut.ReadRowsStream
+
+
+@pytest.fixture()
+def mock_client():
+    from google.cloud.bigquery_storage_v1beta1.gapic import big_query_storage_client
+
+    return mock.create_autospec(big_query_storage_client.BigQueryStorageClient)
+
+
+def _bq_to_avro_blocks(bq_blocks, avro_schema_json):
+    avro_schema = fastavro.parse_schema(avro_schema_json)
+    avro_blocks = []
+    for block in bq_blocks:
+        blockio = six.BytesIO()
+        for row in block:
+            fastavro.schemaless_writer(blockio, avro_schema, row)
+
+        response = bigquery_storage_v1beta1.types.ReadRowsResponse()
+        response.row_count = len(block)
+        response.avro_rows.serialized_binary_rows = blockio.getvalue()
+        avro_blocks.append(response)
+    return avro_blocks
+
+
+def _bq_to_arrow_batch_objects(bq_blocks, arrow_schema):
+    arrow_batches = []
+    for block in bq_blocks:
+        arrays = []
+        for name in arrow_schema.names:
+            arrays.append(
+                pyarrow.array(
+                    (row[name] for row in block),
+                    type=arrow_schema.field_by_name(name).type,
+                    size=len(block),
+                )
+            )
+        arrow_batches.append(pyarrow.RecordBatch.from_arrays(arrays, arrow_schema))
+    return arrow_batches
+
+
+def _bq_to_arrow_batches(bq_blocks, arrow_schema):
+    arrow_batches = []
+    for record_batch in _bq_to_arrow_batch_objects(bq_blocks, arrow_schema):
+        response = bigquery_storage_v1beta1.types.ReadRowsResponse()
+        response.arrow_record_batch.serialized_record_batch = (
+            record_batch.serialize().to_pybytes()
+        )
+        arrow_batches.append(response)
+    return arrow_batches
+
+
+def _avro_blocks_w_unavailable(avro_blocks):
+    for block in avro_blocks:
+        yield block
+    raise google.api_core.exceptions.ServiceUnavailable("test: please reconnect")
+
+
+def _avro_blocks_w_deadline(avro_blocks):
+    for block in avro_blocks:
+        yield block
+    raise google.api_core.exceptions.DeadlineExceeded("test: timeout, don't reconnect")
+
+
+def _generate_avro_read_session(avro_schema_json):
+    schema = json.dumps(avro_schema_json)
+    return bigquery_storage_v1beta1.types.ReadSession(avro_schema={"schema": schema})
+
+
+def _generate_arrow_read_session(arrow_schema):
+    return bigquery_storage_v1beta1.types.ReadSession(
+        arrow_schema={"serialized_schema": arrow_schema.serialize().to_pybytes()}
+    )
+
+
+def _bq_to_avro_schema(bq_columns):
+    fields = []
+    avro_schema = {"type": "record", "name": "__root__", "fields": fields}
+
+    for column in bq_columns:
+        doc = column.get("description")
+        name = column["name"]
+        type_ = BQ_TO_AVRO_TYPES[column["type"]]
+        mode = column.get("mode", "nullable").lower()
+
+        if mode == "nullable":
+            type_ = ["null", type_]
+
+        fields.append({"name": name, "type": type_, "doc": doc})
+
+    return avro_schema
+
+
+def _bq_to_arrow_schema(bq_columns):
+    def bq_col_as_field(column):
+        doc = column.get("description")
+        name = column["name"]
+        type_ = BQ_TO_ARROW_TYPES[column["type"]]
+        mode = column.get("mode", "nullable").lower()
+
+        return pyarrow.field(name, type_, mode == "nullable", {"description": doc})
+
+    return pyarrow.schema(bq_col_as_field(c) for c in bq_columns)
+
+
+def _get_avro_bytes(rows, avro_schema):
+    avro_file = six.BytesIO()
+    for row in rows:
+        fastavro.schemaless_writer(avro_file, avro_schema, row)
+    return avro_file.getvalue()
+
+
+def test_avro_rows_raises_import_error(mut, class_under_test, mock_client, monkeypatch):
+    monkeypatch.setattr(mut, "fastavro", None)
+    reader = class_under_test(
+        [], mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    avro_schema = _bq_to_avro_schema(bq_columns)
+    read_session = _generate_avro_read_session(avro_schema)
+
+    with pytest.raises(ImportError):
+        reader.rows(read_session)
+
+
+def test_pyarrow_rows_raises_import_error(
+    mut, class_under_test, mock_client, monkeypatch
+):
+    monkeypatch.setattr(mut, "pyarrow", None)
+    reader = class_under_test(
+        [], mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    arrow_schema = _bq_to_arrow_schema(bq_columns)
+    read_session = _generate_arrow_read_session(arrow_schema)
+
+    with pytest.raises(ImportError):
+        reader.rows(read_session)
+
+
+def test_rows_no_schema_set_raises_type_error(
+    mut, class_under_test, mock_client, monkeypatch
+):
+    reader = class_under_test(
+        [], mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    read_session = bigquery_storage_v1beta1.types.ReadSession()
+
+    with pytest.raises(TypeError):
+        reader.rows(read_session)
+
+
+def test_rows_w_empty_stream(class_under_test, mock_client):
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    avro_schema = _bq_to_avro_schema(bq_columns)
+    read_session = _generate_avro_read_session(avro_schema)
+    reader = class_under_test(
+        [], mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+
+    got = reader.rows(read_session)
+    assert got.total_rows is None
+    assert tuple(got) == ()
+
+
+def test_rows_w_empty_stream_arrow(class_under_test, mock_client):
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    arrow_schema = _bq_to_arrow_schema(bq_columns)
+    read_session = _generate_arrow_read_session(arrow_schema)
+    reader = class_under_test(
+        [], mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+
+    got = reader.rows(read_session)
+    assert got.total_rows is None
+    assert tuple(got) == ()
+
+
+def test_rows_w_scalars(class_under_test, mock_client):
+    avro_schema = _bq_to_avro_schema(SCALAR_COLUMNS)
+    read_session = _generate_avro_read_session(avro_schema)
+    avro_blocks = _bq_to_avro_blocks(SCALAR_BLOCKS, avro_schema)
+
+    reader = class_under_test(
+        avro_blocks, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    got = tuple(reader.rows(read_session))
+
+    expected = tuple(itertools.chain.from_iterable(SCALAR_BLOCKS))
+    assert got == expected
+
+
+def test_rows_w_scalars_arrow(class_under_test, mock_client):
+    arrow_schema = _bq_to_arrow_schema(SCALAR_COLUMNS)
+    read_session = _generate_arrow_read_session(arrow_schema)
+    arrow_batches = _bq_to_arrow_batches(SCALAR_BLOCKS, arrow_schema)
+
+    reader = class_under_test(
+        arrow_batches, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    got = tuple(reader.rows(read_session))
+
+    expected = tuple(itertools.chain.from_iterable(SCALAR_BLOCKS))
+    assert got == expected
+
+
+def test_rows_w_timeout(class_under_test, mock_client):
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    avro_schema = _bq_to_avro_schema(bq_columns)
+    read_session = _generate_avro_read_session(avro_schema)
+    bq_blocks_1 = [
+        [{"int_col": 123}, {"int_col": 234}],
+        [{"int_col": 345}, {"int_col": 456}],
+    ]
+    avro_blocks_1 = _avro_blocks_w_deadline(
+        _bq_to_avro_blocks(bq_blocks_1, avro_schema)
+    )
+    bq_blocks_2 = [[{"int_col": 567}, {"int_col": 789}], [{"int_col": 890}]]
+    avro_blocks_2 = _bq_to_avro_blocks(bq_blocks_2, avro_schema)
+
+    mock_client.read_rows.return_value = avro_blocks_2
+    stream_position = bigquery_storage_v1beta1.types.StreamPosition(
+        stream={"name": "test"}
+    )
+
+    reader = class_under_test(
+        avro_blocks_1,
+        mock_client,
+        stream_position,
+        {"metadata": {"test-key": "test-value"}},
+    )
+
+    with pytest.raises(google.api_core.exceptions.DeadlineExceeded):
+        list(reader.rows(read_session))
+
+    # Don't reconnect on DeadlineException. This allows user-specified timeouts
+    # to be respected.
+    mock_client.read_rows.assert_not_called()
+
+
+def test_rows_w_reconnect(class_under_test, mock_client):
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    avro_schema = _bq_to_avro_schema(bq_columns)
+    read_session = _generate_avro_read_session(avro_schema)
+    bq_blocks_1 = [
+        [{"int_col": 123}, {"int_col": 234}],
+        [{"int_col": 345}, {"int_col": 456}],
+    ]
+    avro_blocks_1 = _avro_blocks_w_unavailable(
+        _bq_to_avro_blocks(bq_blocks_1, avro_schema)
+    )
+    bq_blocks_2 = [[{"int_col": 567}, {"int_col": 789}], [{"int_col": 890}]]
+    avro_blocks_2 = _bq_to_avro_blocks(bq_blocks_2, avro_schema)
+
+    for block in avro_blocks_2:
+        block.status.estimated_row_count = 7
+
+    mock_client.read_rows.return_value = avro_blocks_2
+    stream_position = bigquery_storage_v1beta1.types.StreamPosition(
+        stream={"name": "test"}
+    )
+
+    reader = class_under_test(
+        avro_blocks_1,
+        mock_client,
+        stream_position,
+        {"metadata": {"test-key": "test-value"}},
+    )
+    got = reader.rows(read_session)
+
+    expected = tuple(
+        itertools.chain(
+            itertools.chain.from_iterable(bq_blocks_1),
+            itertools.chain.from_iterable(bq_blocks_2),
+        )
+    )
+
+    assert tuple(got) == expected
+    assert got.total_rows == 7
+    mock_client.read_rows.assert_called_once_with(
+        bigquery_storage_v1beta1.types.StreamPosition(
+            stream={"name": "test"}, offset=4
+        ),
+        metadata={"test-key": "test-value"},
+    )
+
+
+def test_rows_w_reconnect_by_page(class_under_test, mock_client):
+    bq_columns = [{"name": "int_col", "type": "int64"}]
+    avro_schema = _bq_to_avro_schema(bq_columns)
+    read_session = _generate_avro_read_session(avro_schema)
+    bq_blocks_1 = [
+        [{"int_col": 123}, {"int_col": 234}],
+        [{"int_col": 345}, {"int_col": 456}],
+    ]
+    avro_blocks_1 = _bq_to_avro_blocks(bq_blocks_1, avro_schema)
+    bq_blocks_2 = [[{"int_col": 567}, {"int_col": 789}], [{"int_col": 890}]]
+    avro_blocks_2 = _bq_to_avro_blocks(bq_blocks_2, avro_schema)
+
+    avro_blocks_1[0].status.estimated_row_count = 8
+    avro_blocks_1[1].status.estimated_row_count = 6
+    avro_blocks_2[0].status.estimated_row_count = 9
+    avro_blocks_2[1].status.estimated_row_count = 7
+
+    mock_client.read_rows.return_value = avro_blocks_2
+    stream_position = bigquery_storage_v1beta1.types.StreamPosition(
+        stream={"name": "test"}
+    )
+
+    reader = class_under_test(
+        _avro_blocks_w_unavailable(avro_blocks_1),
+        mock_client,
+        stream_position,
+        {"metadata": {"test-key": "test-value"}},
+    )
+    got = reader.rows(read_session)
+    pages = iter(got.pages)
+
+    assert got.total_rows is None
+
+    page_1 = next(pages)
+    assert got.total_rows == 8
+    assert page_1.num_items == 2
+    assert page_1.remaining == 2
+    assert tuple(page_1) == tuple(bq_blocks_1[0])
+    assert page_1.num_items == 2
+    assert page_1.remaining == 0
+
+    page_2 = next(pages)
+    assert got.total_rows == 6
+    assert next(page_2) == bq_blocks_1[1][0]
+    assert page_2.num_items == 2
+    assert page_2.remaining == 1
+    assert next(page_2) == bq_blocks_1[1][1]
+
+    page_3 = next(pages)
+    assert tuple(page_3) == tuple(bq_blocks_2[0])
+    assert page_3.num_items == 2
+    assert page_3.remaining == 0
+    assert got.total_rows == 9
+
+    page_4 = next(pages)
+    assert got.total_rows == 7
+    assert tuple(page_4) == tuple(bq_blocks_2[1])
+    assert page_4.num_items == 1
+    assert page_4.remaining == 0
+
+
+def test_to_arrow_no_pyarrow_raises_import_error(
+    mut, class_under_test, mock_client, monkeypatch
+):
+    monkeypatch.setattr(mut, "pyarrow", None)
+    arrow_schema = _bq_to_arrow_schema(SCALAR_COLUMNS)
+    read_session = _generate_arrow_read_session(arrow_schema)
+    arrow_batches = _bq_to_arrow_batches(SCALAR_BLOCKS, arrow_schema)
+    reader = class_under_test(
+        arrow_batches, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+
+    with pytest.raises(ImportError):
+        reader.to_arrow(read_session)
+
+    with pytest.raises(ImportError):
+        reader.rows(read_session).to_arrow()
+
+    with pytest.raises(ImportError):
+        next(reader.rows(read_session).pages).to_arrow()
+
+
+def test_to_arrow_w_scalars_arrow(class_under_test):
+    arrow_schema = _bq_to_arrow_schema(SCALAR_COLUMNS)
+    read_session = _generate_arrow_read_session(arrow_schema)
+    arrow_batches = _bq_to_arrow_batches(SCALAR_BLOCKS, arrow_schema)
+    reader = class_under_test(
+        arrow_batches, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    actual_table = reader.to_arrow(read_session)
+    expected_table = pyarrow.Table.from_batches(
+        _bq_to_arrow_batch_objects(SCALAR_BLOCKS, arrow_schema)
+    )
+    assert actual_table == expected_table
+
+
+def test_to_dataframe_no_pandas_raises_import_error(
+    mut, class_under_test, mock_client, monkeypatch
+):
+    monkeypatch.setattr(mut, "pandas", None)
+    avro_schema = _bq_to_avro_schema(SCALAR_COLUMNS)
+    read_session = _generate_avro_read_session(avro_schema)
+    avro_blocks = _bq_to_avro_blocks(SCALAR_BLOCKS, avro_schema)
+
+    reader = class_under_test(
+        avro_blocks, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+
+    with pytest.raises(ImportError):
+        reader.to_dataframe(read_session)
+
+    with pytest.raises(ImportError):
+        reader.rows(read_session).to_dataframe()
+
+    with pytest.raises(ImportError):
+        next(reader.rows(read_session).pages).to_dataframe()
+
+
+def test_to_dataframe_no_schema_set_raises_type_error(
+    mut, class_under_test, mock_client, monkeypatch
+):
+    reader = class_under_test(
+        [], mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    read_session = bigquery_storage_v1beta1.types.ReadSession()
+
+    with pytest.raises(TypeError):
+        reader.to_dataframe(read_session)
+
+
+def test_to_dataframe_w_scalars(class_under_test):
+    avro_schema = _bq_to_avro_schema(SCALAR_COLUMNS)
+    read_session = _generate_avro_read_session(avro_schema)
+    avro_blocks = _bq_to_avro_blocks(SCALAR_BLOCKS, avro_schema)
+
+    reader = class_under_test(
+        avro_blocks, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    got = reader.to_dataframe(read_session)
+
+    expected = pandas.DataFrame(
+        list(itertools.chain.from_iterable(SCALAR_BLOCKS)), columns=SCALAR_COLUMN_NAMES
+    )
+    # fastavro provides its own UTC definition, so
+    # compare the timestamp columns separately.
+    got_ts = got["ts_col"]
+    got = got.drop(columns=["ts_col"])
+    expected_ts = expected["ts_col"]
+    expected = expected.drop(columns=["ts_col"])
+
+    pandas.testing.assert_frame_equal(
+        got.reset_index(drop=True),  # reset_index to ignore row labels
+        expected.reset_index(drop=True),
+    )
+    pandas.testing.assert_series_equal(
+        got_ts.reset_index(drop=True),
+        expected_ts.reset_index(drop=True),
+        check_dtype=False,  # fastavro's UTC means different dtype
+        check_datetimelike_compat=True,
+    )
+
+
+def test_to_dataframe_w_scalars_arrow(class_under_test):
+    arrow_schema = _bq_to_arrow_schema(SCALAR_COLUMNS)
+    read_session = _generate_arrow_read_session(arrow_schema)
+    arrow_batches = _bq_to_arrow_batches(SCALAR_BLOCKS, arrow_schema)
+
+    reader = class_under_test(
+        arrow_batches, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    got = reader.to_dataframe(read_session)
+
+    expected = pandas.DataFrame(
+        list(itertools.chain.from_iterable(SCALAR_BLOCKS)), columns=SCALAR_COLUMN_NAMES
+    )
+
+    pandas.testing.assert_frame_equal(
+        got.reset_index(drop=True),  # reset_index to ignore row labels
+        expected.reset_index(drop=True),
+    )
+
+
+def test_to_dataframe_w_dtypes(class_under_test):
+    avro_schema = _bq_to_avro_schema(
+        [
+            {"name": "bigfloat", "type": "float64"},
+            {"name": "lilfloat", "type": "float64"},
+        ]
+    )
+    read_session = _generate_avro_read_session(avro_schema)
+    blocks = [
+        [{"bigfloat": 1.25, "lilfloat": 30.5}, {"bigfloat": 2.5, "lilfloat": 21.125}],
+        [{"bigfloat": 3.75, "lilfloat": 11.0}],
+    ]
+    avro_blocks = _bq_to_avro_blocks(blocks, avro_schema)
+
+    reader = class_under_test(
+        avro_blocks, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    got = reader.to_dataframe(read_session, dtypes={"lilfloat": "float16"})
+
+    expected = pandas.DataFrame(
+        {
+            "bigfloat": [1.25, 2.5, 3.75],
+            "lilfloat": pandas.Series([30.5, 21.125, 11.0], dtype="float16"),
+        },
+        columns=["bigfloat", "lilfloat"],
+    )
+    pandas.testing.assert_frame_equal(
+        got.reset_index(drop=True),  # reset_index to ignore row labels
+        expected.reset_index(drop=True),
+    )
+
+
+def test_to_dataframe_w_dtypes_arrow(class_under_test):
+    arrow_schema = _bq_to_arrow_schema(
+        [
+            {"name": "bigfloat", "type": "float64"},
+            {"name": "lilfloat", "type": "float64"},
+        ]
+    )
+    read_session = _generate_arrow_read_session(arrow_schema)
+    blocks = [
+        [{"bigfloat": 1.25, "lilfloat": 30.5}, {"bigfloat": 2.5, "lilfloat": 21.125}],
+        [{"bigfloat": 3.75, "lilfloat": 11.0}],
+    ]
+    arrow_batches = _bq_to_arrow_batches(blocks, arrow_schema)
+
+    reader = class_under_test(
+        arrow_batches, mock_client, bigquery_storage_v1beta1.types.StreamPosition(), {}
+    )
+    got = reader.to_dataframe(read_session, dtypes={"lilfloat": "float16"})
+
+    expected = pandas.DataFrame(
+        {
+            "bigfloat": [1.25, 2.5, 3.75],
+            "lilfloat": pandas.Series([30.5, 21.125, 11.0], dtype="float16"),
+        },
+        columns=["bigfloat", "lilfloat"],
+    )
+    pandas.testing.assert_frame_equal(
+        got.reset_index(drop=True),  # reset_index to ignore row labels
+        expected.reset_index(drop=True),
+    )
+
+
+def test_to_dataframe_by_page(class_under_test, mock_client):
+    bq_columns = [
+        {"name": "int_col", "type": "int64"},
+        {"name": "bool_col", "type": "bool"},
+    ]
+    avro_schema = _bq_to_avro_schema(bq_columns)
+    read_session = _generate_avro_read_session(avro_schema)
+    block_1 = [{"int_col": 123, "bool_col": True}, {"int_col": 234, "bool_col": False}]
+    block_2 = [{"int_col": 345, "bool_col": True}, {"int_col": 456, "bool_col": False}]
+    block_3 = [{"int_col": 567, "bool_col": True}, {"int_col": 789, "bool_col": False}]
+    block_4 = [{"int_col": 890, "bool_col": True}]
+    # Break blocks into two groups to test that iteration continues across
+    # reconnection.
+    bq_blocks_1 = [block_1, block_2]
+    bq_blocks_2 = [block_3, block_4]
+    avro_blocks_1 = _bq_to_avro_blocks(bq_blocks_1, avro_schema)
+    avro_blocks_2 = _bq_to_avro_blocks(bq_blocks_2, avro_schema)
+
+    mock_client.read_rows.return_value = avro_blocks_2
+    stream_position = bigquery_storage_v1beta1.types.StreamPosition(
+        stream={"name": "test"}
+    )
+
+    reader = class_under_test(
+        _avro_blocks_w_unavailable(avro_blocks_1),
+        mock_client,
+        stream_position,
+        {"metadata": {"test-key": "test-value"}},
+    )
+    got = reader.rows(read_session)
+    pages = iter(got.pages)
+
+    page_1 = next(pages)
+    pandas.testing.assert_frame_equal(
+        page_1.to_dataframe().reset_index(drop=True),
+        pandas.DataFrame(block_1, columns=["int_col", "bool_col"]).reset_index(
+            drop=True
+        ),
+    )
+
+    page_2 = next(pages)
+    pandas.testing.assert_frame_equal(
+        page_2.to_dataframe().reset_index(drop=True),
+        pandas.DataFrame(block_2, columns=["int_col", "bool_col"]).reset_index(
+            drop=True
+        ),
+    )
+
+    page_3 = next(pages)
+    pandas.testing.assert_frame_equal(
+        page_3.to_dataframe().reset_index(drop=True),
+        pandas.DataFrame(block_3, columns=["int_col", "bool_col"]).reset_index(
+            drop=True
+        ),
+    )
+
+    page_4 = next(pages)
+    pandas.testing.assert_frame_equal(
+        page_4.to_dataframe().reset_index(drop=True),
+        pandas.DataFrame(block_4, columns=["int_col", "bool_col"]).reset_index(
+            drop=True
+        ),
+    )
+
+
+def test_copy_stream_position(mut):
+    read_position = bigquery_storage_v1beta1.types.StreamPosition(
+        stream={"name": "test"}, offset=41
+    )
+    got = mut._copy_stream_position(read_position)
+    assert got == read_position
+    got.offset = 42
+    assert read_position.offset == 41
+
+
+def test_copy_stream_position_w_dict(mut):
+    read_position = {"stream": {"name": "test"}, "offset": 42}
+    got = mut._copy_stream_position(read_position)
+    assert got.stream.name == "test"
+    assert got.offset == 42
diff --git a/bigtable/.coveragerc b/bigtable/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/bigtable/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/bigtable/.flake8 b/bigtable/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/bigtable/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/bigtable/.repo-metadata.json b/bigtable/.repo-metadata.json
new file mode 100644
index 000000000000..956c74b53395
--- /dev/null
+++ b/bigtable/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "bigtable",
+  "name_pretty": "Cloud Bigtable",
+  "product_documentation": "https://cloud.google.com/bigtable",
+  "client_documentation": "https://googleapis.dev/python/bigtable/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559777",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-bigtable",
+  "api_id": "bigtable.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/bigtable/CHANGELOG.md b/bigtable/CHANGELOG.md
new file mode 100644
index 000000000000..f6e28c23cd4e
--- /dev/null
+++ b/bigtable/CHANGELOG.md
@@ -0,0 +1,313 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-bigtable/#history
+
+## 0.34.0
+
+07-30-2019 10:05 PDT
+
+
+### Implementation Changes
+- Pick up changes to GAPIC client configuration (via synth). ([#8724](https://github.com/googleapis/google-cloud-python/pull/8724))
+- Add `Cell.__repr__`. ([#8683](https://github.com/googleapis/google-cloud-python/pull/8683))
+- Increase timeout for app profile update operation. ([#8417](https://github.com/googleapis/google-cloud-python/pull/8417))
+
+### New Features
+- Add methods returning Separate row types to remove confusion around return types of `row.commit`. ([#8662](https://github.com/googleapis/google-cloud-python/pull/8662))
+- Add `options_` argument to clients' `get_iam_policy` (via synth). ([#8652](https://github.com/googleapis/google-cloud-python/pull/8652))
+-  Add `client_options` support, update list method docstrings (via synth). ([#8500](https://github.com/googleapis/google-cloud-python/pull/8500))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for `grpc-google-iam-v1` to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+- Allow kwargs to be passed to `create_channel` (via synth). ([#8458](https://github.com/googleapis/google-cloud-python/pull/8458))
+- Add `PartialRowsData.cancel`. ([#8176](https://github.com/googleapis/google-cloud-python/pull/8176))
+
+### Documentation
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Add snppets illustrating use of  application profiles. ([#7033](https://github.com/googleapis/google-cloud-python/pull/7033))
+
+### Internal / Testing Changes
+- Add nox session `docs` to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Force timeout for table creation to 90 seconds (in systests). ([#8450](https://github.com/googleapis/google-cloud-python/pull/8450))
+- Plug systest / snippet instance leaks. ([#8416](https://github.com/googleapis/google-cloud-python/pull/8416))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8346](https://github.com/googleapis/google-cloud-python/pull/8346))
+- Add disclaimer to auto-generated template files (via synth).  ([#8308](https://github.com/googleapis/google-cloud-python/pull/8308))
+- Fix coverage in `types.py` (via synth). ([#8149](https://github.com/googleapis/google-cloud-python/pull/8149))
+- Integrate docstring / formatting tweaks (via synth). ([#8138](https://github.com/googleapis/google-cloud-python/pull/8138))
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+
+## 0.33.0
+
+05-16-2019 11:51 PDT
+
+
+### Implementation Changes
+- Fix typos in deprecation warnings. ([#7858](https://github.com/googleapis/google-cloud-python/pull/7858))
+- Add deprecation warnings for to-be-removed features. ([#7532](https://github.com/googleapis/google-cloud-python/pull/7532))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Improve `Policy` interchange w/ JSON, gRPC payloads. ([#7378](https://github.com/googleapis/google-cloud-python/pull/7378))
+
+### New Features
+- Add support for passing `client_info` to client. ([#7876](https://github.com/googleapis/google-cloud-python/pull/7876)) and ([#7898](https://github.com/googleapis/google-cloud-python/pull/7898))
+- Add `Table.mutation_timeout`, allowing override of config timeouts. ([#7424](https://github.com/googleapis/google-cloud-python/pull/7424))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Remove duplicate snippet tags for Delete cluster. ([#7860](https://github.com/googleapis/google-cloud-python/pull/7860))
+- Fix rendering of instance admin snippets. ([#7797](https://github.com/googleapis/google-cloud-python/pull/7797))
+- Avoid leaking instances from snippets. ([#7800](https://github.com/googleapis/google-cloud-python/pull/7800))
+- Fix enum reference in documentation. ([#7724](https://github.com/googleapis/google-cloud-python/pull/7724))
+- Remove duplicate snippets. ([#7528](https://github.com/googleapis/google-cloud-python/pull/7528))
+- Add snippeds for Batcher, RowData, Row Operations, AppendRow. ([#7019](https://github.com/googleapis/google-cloud-python/pull/7019))
+- Add column family snippets. ([#7014](https://github.com/googleapis/google-cloud-python/pull/7014))
+- Add Row Set snippets. ([#7016](https://github.com/googleapis/google-cloud-python/pull/7016))
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Fix typos in Table docstrings. ([#7261](https://github.com/googleapis/google-cloud-python/pull/7261))
+- Update copyright headers (via synth). ([#7139](https://github.com/googleapis/google-cloud-python/pull/7139))
+- Fix linked classes in generated docstrings (via synth). ([#7060](https://github.com/googleapis/google-cloud-python/pull/7060))
+
+### Internal / Testing Changes
+- Run `instance_admin` system tests on a separate instance from `table_admin` and `data` system tests. ([#6579](https://github.com/googleapis/google-cloud-python/pull/6579))
+- Re-blacken. ([#7462](https://github.com/googleapis/google-cloud-python/pull/7462))
+- Copy lintified proto files (via synth). ([#7445](https://github.com/googleapis/google-cloud-python/pull/7445))
+- Remove unused message exports (via synth). ([#7264](https://github.com/googleapis/google-cloud-python/pull/7264))
+- Compare 0 using '!=', rather than 'is not'. ([#7312](https://github.com/googleapis/google-cloud-python/pull/7312))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Protoc-generated serialization update. ([#7077](https://github.com/googleapis/google-cloud-python/pull/7077))
+- Blacken snippets. ([#7048](https://github.com/googleapis/google-cloud-python/pull/7048))
+- Bigtable client snippets ([#7020](https://github.com/googleapis/google-cloud-python/pull/7020))
+- Pick up order-of-enum fix from GAPIC generator. ([#6879](https://github.com/googleapis/google-cloud-python/pull/6879))
+- Plug systest instance leaks ([#7004](https://github.com/googleapis/google-cloud-python/pull/7004))
+
+## 0.32.1
+
+12-17-2018 16:38 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Add snippets for table operations. ([#6484](https://github.com/googleapis/google-cloud-python/pull/6484))
+
+## 0.32.0
+
+12-10-2018 12:47 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Remove `deepcopy` from `PartialRowData.cells` property. ([#6648](https://github.com/googleapis/google-cloud-python/pull/6648))
+- Pick up fixes to GAPIC generator. ([#6630](https://github.com/googleapis/google-cloud-python/pull/6630))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+
+### Internal / Testing Changes
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Blackening Continued... ([#6667](https://github.com/googleapis/google-cloud-python/pull/6667))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+
+## 0.31.1
+
+11-02-2018 08:13 PDT
+
+### Implementation Changes
+- Fix anonymous usage under Bigtable emulator ([#6385](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6385))
+- Support `DirectRow` without a `Table` ([#6336](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6336))
+- Add retry parameter to `Table.read_rows()`. ([#6281](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6281))
+- Fix `ConditionalRow` interaction with `check_and_mutate_row` ([#6296](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6296))
+- Deprecate `channel` arg to `Client` ([#6279](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6279))
+
+### Dependencies
+- Update dependency: `google-api-core >= 1.4.1` ([#6391](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6391))
+- Update IAM version in dependencies ([#6362](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6362))
+
+### Documentation
+- Add `docs/snippets.py` and test ([#6012](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6012))
+- Normalize use of support level badges ([#6159](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Fix client_info bug, update docstrings and timeouts. ([#6406)](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6406))
+- Remove now-spurious fixup from 'synth.py'. ([#6400](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6400))
+- Fix flaky systests / snippets ([#6367](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6367))
+- Add explicit coverage for `row_data._retry_read_rows_exception`. ([#6364](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6364))
+- Fix instance IAM test methods ([#6343](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6343))
+- Fix error from new flake8 version. ([#6309](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6309))
+- Use new Nox ([#6175](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6175))
+
+## 0.31.0
+
+### New Features
+- Upgrade support level from `alpha` to `beta`.  ([#6129](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6129))
+
+### Implementation Changes
+- Improve admin operation timeouts. ([#6010](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6010))
+
+### Documentation
+- Prepare docs for repo split. ([#6014](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6014))
+
+### Internal / Testing Changes
+- Refactor `read_row` to call `read_rows` ([#6137](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6102))
+- Harden instance teardown against '429 Too Many Requests'. ([#6102](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6102))
+- Add `{RowSet,RowRange}.{__eq__,.__ne__}` ([#6025](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6025))
+- Regenerate low-level GAPIC code ([#6036](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6036))
+
+## 0.30.2
+
+### New Features
+- Add iam policy implementation for an instance. (#5838)
+
+### Implementation Changes
+- Fix smart retries for 'read_rows()' when reading the full table (#5966)
+
+### Documentation
+- Replace links to `/stable/` with `/latest/`. (#5901)
+
+### Internal / Testing Changes
+- Re-generate library using bigtable/synth.py (#5974)
+- Refactor `read_rows` infrastructure (#5963)
+
+## 0.30.1
+
+### Implementation changes
+
+- Fix non-admin access to table data. (#5875)
+- Synth bigtable and bigtable admin GAPIC clients. (#5867)
+
+### Testing and internal changes
+
+- Nox: use in-place installs for local packages. (#5865)
+
+## 0.30.0
+
+### New Features
+
+- Improve performance and capabilities of reads.  `read_rows` now returns a generator; has automatic retries; and can read an arbitrary set of keys and ranges
+  - Consolidate read_rows and yield_rows (#5840)
+  - Implement row set for yield_rows  (#5506)
+  - Improve read rows validation performance (#5390)
+  - Add retry for yield_rows (#4882)
+  - Require TimestampRanges to be milliseconds granularity (#5002)
+  - Provide better access to cell values (#4908)
+  - Add data app profile id  (#5369)
+
+- Improve writes: Writes are usable in Beam
+  - Create MutationBatcher for bigtable (#5651)
+  - Allow DirectRow to be created without a table (#5567)
+  - Add data app profile id  (#5369)
+
+- Improve table admin: Table creation now can also create families in a single RPC.  Add an `exist()` method.  Add `get_cluster_states` for information about replication
+  - Add 'Table.get_cluster_states' method (#5790)
+  - Optimize 'Table.exists' performance (#5749)
+  - Add column creation in 'Table.create()'. (#5576)
+  - Add 'Table.exists' method (#5545)
+  - Add split keys on create table - v2 (#5513)
+  - Avoid sharing table names across unrelated systests. (#5421)
+  - Add truncate table and drop by prefix on top of GAPIC integration (#5360)
+
+- Improve instance admin: Instance creation allows for the creation of multiple clusters.  Instance label management is now enabled.  
+  - Create app_profile_object (#5782)
+  - Add 'Instance.exists' method (#5802)
+  - Add 'InstanceAdminClient.list_clusters' method (#5715)
+  - Add 'Instance._state' property (#5736)
+  - Convert 'instance.labels' to return a dictionary (#5728)
+  - Reshape cluster.py, adding cluster() factory to instance.py (#5663)
+  - Convert 'Instance.update' to use 'instance.partial_instance_update' API (#5643)
+  - Refactor 'InstanceAdminClient.update_app_profile' to remove update_mask argument (#5684)
+  - Add the ability to create an instance with multiple clusters (#5622)
+  - Add 'instance_type', 'labels' to 'Instance' ctor (#5614)
+  - Add optional app profile to 'Instance.table' (#5605)
+  - Clean up Instance creation. (#5542)
+  - Make 'InstanceAdminClient.list_instances' return actual instance objects, not protos. (#5420)
+  - Add admin app profile methods on Instance (#5315)
+
+### Internal / Testing Changes
+- Rename releases to changelog and include from CHANGELOG.md (#5191)
+- Fix bad trove classifier
+- Integrate new generated low-level client (#5178)
+- Override gRPC max message lengths. (#5498)
+- Use client properties rather than private attrs (#5398)
+- Fix the broken Bigtable system test. (#5607)
+- Fix Py3 breakage in new system test. (#5474)
+- Modify system test for new GAPIC code (#5302)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Disable Bigtable system tests (#5381)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Pass through 'session.posargs' when running Bigtable system tests. (#5418)
+- Harden 'test_list_instances' against simultaneous test runs. (#5476)
+- Shorten instance / cluster name to fix CI breakage. (#5641)
+- Fix failing systest: 'test_create_instance_w_two_clusters'. (#5836)
+- Add labels {'python-system': ISO-timestamp} to systest instances (#5729)
+- Shorten cluster ID in system test (#5719)
+- Harden 'test_list_instances' further. (#5696)
+- Improve testing of create instance (#5544)
+
+## 0.29.0
+
+### New features
+
+- Use `api_core.retry` for `mutate_row` (#4665, #4341)
+- Added a row generator on a table. (#4679)
+
+### Implementation changes
+
+- Remove gax usage from BigTable (#4873)
+- BigTable: Cell.from_pb() performance improvement (#4745)
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Minor typo (#4758)
+- Row filter end points documentation error (#4667)
+- Removing "rename" from bigtable table.py comments (#4526)
+- Small docs/hygiene tweaks after #4256. (#4333)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Timestamp system test fix (#4765)
+
+## 0.28.1
+
+### Implementation Changes
+
+- Bugfix: Distinguish between an unset column qualifier and an empty string
+  column qualifier while parsing a `ReadRows` response (#4252)
+
+### Features added
+
+- Add a ``retry`` strategy that will be used for retry-able errors
+  in ``Table.mutate_rows``. This will be used for gRPC errors of type
+  ``ABORTED``, ``DEADLINE_EXCEEDED`` and ``SERVICE_UNAVAILABLE``. (#4256)
+
+PyPI: https://pypi.org/project/google-cloud-bigtable/0.28.1/
+
+## 0.28.0
+
+### Documentation
+
+- Fixed referenced types in `Table.row` docstring (#3934, h/t to
+  @MichaelTamm)
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-bigtable/0.28.0/
diff --git a/bigtable/LICENSE b/bigtable/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/bigtable/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/bigtable/MANIFEST.in b/bigtable/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/bigtable/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/bigtable/README.rst b/bigtable/README.rst
new file mode 100644
index 000000000000..5660093c0fb6
--- /dev/null
+++ b/bigtable/README.rst
@@ -0,0 +1,99 @@
+Python Client for Google Cloud Bigtable
+=======================================
+
+|beta| |pypi| |versions| 
+
+`Google Cloud Bigtable`_ is Google's NoSQL Big Data database service. It's the
+same database that powers many core Google services, including Search,
+Analytics, Maps, and Gmail.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |beta| image:: https://img.shields.io/badge/support-beta-silver.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-bigtable.svg
+   :target: https://pypi.org/project/google-cloud-bigtable/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-bigtable.svg
+   :target: https://pypi.org/project/google-cloud-bigtable/
+.. _Google Cloud Bigtable: https://cloud.google.com/bigtable
+.. _Client Library Documentation: https://googleapis.dev/python/bigtable/latest
+.. _Product Documentation:  https://cloud.google.com/bigtable/docs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Bigtable API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Bigtable API.:  https://cloud.google.com/bigtable
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-bigtable
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-bigtable
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Bigtable API
+   to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
+
+``google-cloud-happybase``
+--------------------------
+
+In addition to the core ``google-cloud-bigtable``, we provide a
+`google-cloud-happybase
+<http://google-cloud-python-happybase.readthedocs.io/en/latest/>`__ library
+with the same interface as the popular `HappyBase
+<https://happybase.readthedocs.io/en/latest/>`__ library. Unlike HappyBase,
+``google-cloud-happybase`` uses ``google-cloud-bigtable`` under the covers,
+rather than Apache HBase.
diff --git a/bigtable/docs/README.rst b/bigtable/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/bigtable/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/bigtable/docs/changelog.md b/bigtable/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/bigtable/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/bigtable/docs/client-intro.rst b/bigtable/docs/client-intro.rst
new file mode 100644
index 000000000000..6a38437790e2
--- /dev/null
+++ b/bigtable/docs/client-intro.rst
@@ -0,0 +1,90 @@
+Base for Everything
+===================
+
+To use the API, the :class:`Client <google.cloud.bigtable.client.Client>`
+class defines a high-level interface which handles authorization
+and creating other objects:
+
+.. code:: python
+
+    from google.cloud.bigtable.client import Client
+    client = Client()
+
+Long-lived Defaults
+-------------------
+
+When creating a :class:`Client <google.cloud.bigtable.client.Client>`, the
+``user_agent`` argument has sensible a default
+(:data:`DEFAULT_USER_AGENT <google.cloud.bigtable.client.DEFAULT_USER_AGENT>`).
+However, you may over-ride it and the value will be used throughout all API
+requests made with the ``client`` you create.
+
+Configuration
+-------------
+
+- For an overview of authentication in ``google-cloud-python``,
+  see `Authentication <https://googleapis.dev/python/google-api-core/latest/auth.html#authentication>`_.
+
+- In addition to any authentication configuration, you can also set the
+  :envvar:`GOOGLE_CLOUD_PROJECT` environment variable for the Google Cloud Console
+  project you'd like to interact with. If your code is running in Google App
+  Engine or Google Compute Engine the project will be detected automatically.
+  (Setting this environment variable is not required, you may instead pass the
+  ``project`` explicitly when constructing a
+  :class:`Client <google.cloud.storage.client.Client>`).
+
+- After configuring your environment, create a
+  :class:`Client <google.cloud.storage.client.Client>`
+
+  .. code::
+
+     >>> from google.cloud import bigtable
+     >>> client = bigtable.Client()
+
+  or pass in ``credentials`` and ``project`` explicitly
+
+  .. code::
+
+     >>> from google.cloud import bigtable
+     >>> client = bigtable.Client(project='my-project', credentials=creds)
+
+.. tip::
+
+    Be sure to use the **Project ID**, not the **Project Number**.
+
+Admin API Access
+----------------
+
+If you'll be using your client to make `Instance Admin`_ and `Table Admin`_
+API requests, you'll need to pass the ``admin`` argument:
+
+.. code:: python
+
+    client = bigtable.Client(admin=True)
+
+Read-Only Mode
+--------------
+
+If, on the other hand, you only have (or want) read access to the data,
+you can pass the ``read_only`` argument:
+
+.. code:: python
+
+    client = bigtable.Client(read_only=True)
+
+This will ensure that the
+:data:`READ_ONLY_SCOPE <google.cloud.bigtable.client.READ_ONLY_SCOPE>` is used
+for API requests (so any accidental requests that would modify data will
+fail).
+
+Next Step
+---------
+
+After a :class:`Client <google.cloud.bigtable.client.Client>`, the next highest-level
+object is an :class:`Instance <google.cloud.bigtable.instance.Instance>`. You'll need
+one before you can interact with tables or data.
+
+Head next to learn about the :doc:`instance-api`.
+
+.. _Instance Admin: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/tree/master/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1
+.. _Table Admin: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/tree/master/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1
diff --git a/docs/bigtable-client.rst b/bigtable/docs/client.rst
similarity index 100%
rename from docs/bigtable-client.rst
rename to bigtable/docs/client.rst
diff --git a/docs/bigtable-cluster.rst b/bigtable/docs/cluster.rst
similarity index 100%
rename from docs/bigtable-cluster.rst
rename to bigtable/docs/cluster.rst
diff --git a/docs/bigtable-column-family.rst b/bigtable/docs/column-family.rst
similarity index 100%
rename from docs/bigtable-column-family.rst
rename to bigtable/docs/column-family.rst
diff --git a/bigtable/docs/conf.py b/bigtable/docs/conf.py
new file mode 100644
index 000000000000..ebf93a3dbe5c
--- /dev/null
+++ b/bigtable/docs/conf.py
@@ -0,0 +1,359 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-bigtable documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-bigtable"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-bigtable-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-bigtable.tex",
+        u"google-cloud-bigtable Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-bigtable",
+        u"google-cloud-bigtable Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-bigtable",
+        u"google-cloud-bigtable Documentation",
+        author,
+        "google-cloud-bigtable",
+        "GAPIC library for Bigtable",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/bigtable/docs/data-api.rst b/bigtable/docs/data-api.rst
new file mode 100644
index 000000000000..d35b50079426
--- /dev/null
+++ b/bigtable/docs/data-api.rst
@@ -0,0 +1,344 @@
+Data API
+========
+
+After creating a :class:`Table <google.cloud.bigtable.table.Table>` and some
+column families, you are ready to store and retrieve data.
+
+Cells vs. Columns vs. Column Families
++++++++++++++++++++++++++++++++++++++
+
+* As explained in the :doc:`table overview <table-api>`, tables can
+  have many column families.
+* As described below, a table can also have many rows which are
+  specified by row keys.
+* Within a row, data is stored in a cell. A cell simply has a value (as
+  bytes) and a timestamp. The number of cells in each row can be
+  different, depending on what was stored in each row.
+* Each cell lies in a column (**not** a column family). A column is really
+  just a more **specific** modifier within a column family. A column
+  can be present in every column family, in only one or anywhere in between.
+* Within a column family there can be many columns. For example, within
+  the column family ``foo`` we could have columns ``bar`` and ``baz``.
+  These would typically be represented as ``foo:bar`` and ``foo:baz``.
+
+Modifying Data
+++++++++++++++
+
+Since data is stored in cells, which are stored in rows, we
+use the metaphor of a **row** in classes that are used to modify
+(write, update, delete) data in a
+:class:`Table <google.cloud.bigtable.table.Table>`.
+
+Direct vs. Conditional vs. Append
+---------------------------------
+
+There are three ways to modify data in a table, described by the
+`MutateRow`_, `CheckAndMutateRow`_ and `ReadModifyWriteRow`_ API
+methods.
+
+* The **direct** way is via `MutateRow`_ which involves simply
+  adding, overwriting or deleting cells. The
+  :class:`DirectRow <google.cloud.bigtable.row.DirectRow>` class
+  handles direct mutations.
+* The **conditional** way is via `CheckAndMutateRow`_. This method
+  first checks if some filter is matched in a given row, then
+  applies one of two sets of mutations, depending on if a match
+  occurred or not. (These mutation sets are called the "true
+  mutations" and "false mutations".) The
+  :class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>` class
+  handles conditional mutations.
+* The **append** way is via `ReadModifyWriteRow`_. This simply
+  appends (as bytes) or increments (as an integer) data in a presumed
+  existing cell in a row. The
+  :class:`AppendRow <google.cloud.bigtable.row.AppendRow>` class
+  handles append mutations.
+
+Row Factory
+-----------
+
+A single factory can be used to create any of the three row types.
+To create a :class:`DirectRow <google.cloud.bigtable.row.DirectRow>`:
+
+.. code:: python
+
+    row = table.row(row_key)
+
+Unlike the previous string values we've used before, the row key must
+be ``bytes``.
+
+To create a :class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>`,
+first create a :class:`RowFilter <google.cloud.bigtable.row.RowFilter>` and
+then
+
+.. code:: python
+
+    cond_row = table.row(row_key, filter_=filter_)
+
+To create an :class:`AppendRow <google.cloud.bigtable.row.AppendRow>`
+
+.. code:: python
+
+    append_row = table.row(row_key, append=True)
+
+Building Up Mutations
+---------------------
+
+In all three cases, a set of mutations (or two sets) are built up
+on a row before they are sent of in a batch via
+
+.. code:: python
+
+    row.commit()
+
+Direct Mutations
+----------------
+
+Direct mutations can be added via one of four methods
+
+* :meth:`set_cell() <google.cloud.bigtable.row.DirectRow.set_cell>` allows a
+  single value to be written to a column
+
+  .. code:: python
+
+      row.set_cell(column_family_id, column, value,
+                   timestamp=timestamp)
+
+  If the ``timestamp`` is omitted, the current time on the Google Cloud
+  Bigtable server will be used when the cell is stored.
+
+  The value can either be bytes or an integer, which will be converted to
+  bytes as a signed 64-bit integer.
+
+* :meth:`delete_cell() <google.cloud.bigtable.row.DirectRow.delete_cell>` deletes
+  all cells (i.e. for all timestamps) in a given column
+
+  .. code:: python
+
+      row.delete_cell(column_family_id, column)
+
+  Remember, this only happens in the ``row`` we are using.
+
+  If we only want to delete cells from a limited range of time, a
+  :class:`TimestampRange <google.cloud.bigtable.row.TimestampRange>` can
+  be used
+
+  .. code:: python
+
+      row.delete_cell(column_family_id, column,
+                      time_range=time_range)
+
+* :meth:`delete_cells() <google.cloud.bigtable.row.DirectRow.delete_cells>` does
+  the same thing as
+  :meth:`delete_cell() <google.cloud.bigtable.row.DirectRow.delete_cell>`,
+  but accepts a list of columns in a column family rather than a single one.
+
+  .. code:: python
+
+      row.delete_cells(column_family_id, [column1, column2],
+                       time_range=time_range)
+
+  In addition, if we want to delete cells from every column in a column family,
+  the special :attr:`ALL_COLUMNS <google.cloud.bigtable.row.DirectRow.ALL_COLUMNS>`
+  value can be used
+
+  .. code:: python
+
+      row.delete_cells(column_family_id, row.ALL_COLUMNS,
+                       time_range=time_range)
+
+* :meth:`delete() <google.cloud.bigtable.row.DirectRow.delete>` will delete the
+  entire row
+
+  .. code:: python
+
+      row.delete()
+
+Conditional Mutations
+---------------------
+
+Making **conditional** modifications is essentially identical
+to **direct** modifications: it uses the exact same methods
+to accumulate mutations.
+
+However, each mutation added must specify a ``state``: will the mutation be
+applied if the filter matches or if it fails to match.
+
+For example:
+
+.. code:: python
+
+    cond_row.set_cell(column_family_id, column, value,
+                      timestamp=timestamp, state=True)
+
+will add to the set of true mutations.
+
+Append Mutations
+----------------
+
+Append mutations can be added via one of two methods
+
+* :meth:`append_cell_value() <google.cloud.bigtable.row.AppendRow.append_cell_value>`
+  appends a bytes value to an existing cell:
+
+  .. code:: python
+
+      append_row.append_cell_value(column_family_id, column, bytes_value)
+
+* :meth:`increment_cell_value() <google.cloud.bigtable.row.AppendRow.increment_cell_value>`
+  increments an integer value in an existing cell:
+
+  .. code:: python
+
+      append_row.increment_cell_value(column_family_id, column, int_value)
+
+  Since only bytes are stored in a cell, the cell value is decoded as
+  a signed 64-bit integer before being incremented. (This happens on
+  the Google Cloud Bigtable server, not in the library.)
+
+Notice that no timestamp was specified. This is because **append** mutations
+operate on the latest value of the specified column.
+
+If there are no cells in the specified column, then the empty string (bytes
+case) or zero (integer case) are the assumed values.
+
+Starting Fresh
+--------------
+
+If accumulated mutations need to be dropped, use
+
+.. code:: python
+
+    row.clear()
+
+Reading Data
+++++++++++++
+
+Read Single Row from a Table
+----------------------------
+
+To make a `ReadRows`_ API request for a single row key, use
+:meth:`Table.read_row() <google.cloud.bigtable.table.Table.read_row>`:
+
+.. code:: python
+
+    >>> row_data = table.read_row(row_key)
+    >>> row_data.cells
+    {
+        u'fam1': {
+            b'col1': [
+                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
+                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
+            ],
+            b'col2': [
+                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
+            ],
+        },
+        u'fam2': {
+            b'col3': [
+                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
+                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
+                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
+            ],
+        },
+    }
+    >>> cell = row_data.cells[u'fam1'][b'col1'][0]
+    >>> cell
+    <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>
+    >>> cell.value
+    b'val1'
+    >>> cell.timestamp
+    datetime.datetime(2016, 2, 27, 3, 41, 18, 122823, tzinfo=<UTC>)
+
+Rather than returning a :class:`DirectRow <google.cloud.bigtable.row.DirectRow>`
+or similar class, this method returns a
+:class:`PartialRowData <google.cloud.bigtable.row_data.PartialRowData>`
+instance. This class is used for reading and parsing data rather than for
+modifying data (as :class:`DirectRow <google.cloud.bigtable.row.DirectRow>` is).
+
+A filter can also be applied to the results:
+
+.. code:: python
+
+    row_data = table.read_row(row_key, filter_=filter_val)
+
+The allowable ``filter_`` values are the same as those used for a
+:class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>`. For
+more information, see the
+:meth:`Table.read_row() <google.cloud.bigtable.table.Table.read_row>` documentation.
+
+Stream Many Rows from a Table
+-----------------------------
+
+To make a `ReadRows`_ API request for a stream of rows, use
+:meth:`Table.read_rows() <google.cloud.bigtable.table.Table.read_rows>`:
+
+.. code:: python
+
+    row_data = table.read_rows()
+
+Using gRPC over HTTP/2, a continual stream of responses will be delivered.
+In particular
+
+* :meth:`consume_next() <google.cloud.bigtable.row_data.PartialRowsData.consume_next>`
+  pulls the next result from the stream, parses it and stores it on the
+  :class:`PartialRowsData <google.cloud.bigtable.row_data.PartialRowsData>` instance
+* :meth:`consume_all() <google.cloud.bigtable.row_data.PartialRowsData.consume_all>`
+  pulls results from the stream until there are no more
+* :meth:`cancel() <google.cloud.bigtable.row_data.PartialRowsData.cancel>` closes
+  the stream
+
+See the :class:`PartialRowsData <google.cloud.bigtable.row_data.PartialRowsData>`
+documentation for more information.
+
+As with
+:meth:`Table.read_row() <google.cloud.bigtable.table.Table.read_row>`, an optional
+``filter_`` can be applied. In addition a ``start_key`` and / or ``end_key``
+can be supplied for the stream, a ``limit`` can be set and a boolean
+``allow_row_interleaving`` can be specified to allow faster streamed results
+at the potential cost of non-sequential reads.
+
+See the :meth:`Table.read_rows() <google.cloud.bigtable.table.Table.read_rows>`
+documentation for more information on the optional arguments.
+
+Sample Keys in a Table
+----------------------
+
+Make a `SampleRowKeys`_ API request with
+:meth:`Table.sample_row_keys() <google.cloud.bigtable.table.Table.sample_row_keys>`:
+
+.. code:: python
+
+    keys_iterator = table.sample_row_keys()
+
+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.
+
+As with
+:meth:`Table.read_rows() <google.cloud.bigtable.table.Table.read_rows>`, the
+returned ``keys_iterator`` is connected to a cancellable HTTP/2 stream.
+
+The next key in the result can be accessed via
+
+.. code:: python
+
+    next_key = keys_iterator.next()
+
+or all keys can be iterated over via
+
+.. code:: python
+
+    for curr_key in keys_iterator:
+        do_something(curr_key)
+
+Just as with reading, the stream can be canceled:
+
+.. code:: python
+
+    keys_iterator.cancel()
+
+.. _ReadRows: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L36-L38
+.. _SampleRowKeys: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L44-L46
+.. _MutateRow: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L50-L52
+.. _CheckAndMutateRow: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L62-L64
+.. _ReadModifyWriteRow: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L70-L72
diff --git a/bigtable/docs/index.rst b/bigtable/docs/index.rst
new file mode 100644
index 000000000000..8c76f79b80e1
--- /dev/null
+++ b/bigtable/docs/index.rst
@@ -0,0 +1,30 @@
+.. include:: README.rst
+
+
+Using the API
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   usage
+
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   instance-api
+   table-api
+   data-api
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-datastore`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/bigtable/docs/instance-api.rst b/bigtable/docs/instance-api.rst
new file mode 100644
index 000000000000..bc338d7c7ca9
--- /dev/null
+++ b/bigtable/docs/instance-api.rst
@@ -0,0 +1,135 @@
+Instance Admin API
+==================
+
+After creating a :class:`Client <google.cloud.bigtable.client.Client>`, you can
+interact with individual instances for a project.
+
+List Instances
+--------------
+
+If you want a comprehensive list of all existing instances, make a
+`ListInstances`_ API request with
+:meth:`Client.list_instances() <google.cloud.bigtable.client.Client.list_instances>`:
+
+.. code:: python
+
+    instances = client.list_instances()
+
+Instance Factory
+----------------
+
+To create an :class:`Instance <google.cloud.bigtable.instance.Instance>` object:
+
+.. code:: python
+
+    instance = client.instance(instance_id, location_id,
+                               display_name=display_name)
+
+- ``location_id`` is the ID of the location in which the instance's cluster
+  will be hosted, e.g.  ``'us-central1-c'``.  ``location_id`` is required for
+  instances which do not already exist.
+
+- ``display_name`` is optional. When not provided, ``display_name`` defaults
+  to the ``instance_id`` value.
+
+You can also use :meth:`Client.instance` to create a local wrapper for
+instances that have already been created with the API, or through the web
+console:
+
+.. code:: python
+
+    instance = client.instance(existing_instance_id)
+    instance.reload()
+
+Create a new Instance
+---------------------
+
+After creating the instance object, make a `CreateInstance`_ API request
+with :meth:`create() <google.cloud.bigtable.instance.Instance.create>`:
+
+.. code:: python
+
+    instance.display_name = 'My very own instance'
+    instance.create()
+
+Check on Current Operation
+--------------------------
+
+.. note::
+
+    When modifying an instance (via a `CreateInstance`_ request), the Bigtable
+    API will return a `long-running operation`_ and a corresponding
+    :class:`Operation <google.cloud.bigtable.instance.Operation>` object
+    will be returned by
+    :meth:`create() <google.cloud.bigtable.instance.Instance.create>`.
+
+You can check if a long-running operation (for a
+:meth:`create() <google.cloud.bigtable.instance.Instance.create>` has finished
+by making a `GetOperation`_ request with
+:meth:`Operation.finished() <google.cloud.bigtable.instance.Operation.finished>`:
+
+.. code:: python
+
+    >>> operation = instance.create()
+    >>> operation.finished()
+    True
+
+.. note::
+
+    Once an :class:`Operation <google.cloud.bigtable.instance.Operation>` object
+    has returned :data:`True` from
+    :meth:`finished() <google.cloud.bigtable.instance.Operation.finished>`, the
+    object should not be re-used. Subsequent calls to
+    :meth:`finished() <google.cloud.bigtable.instance.Operation.finished>`
+    will result in a :class:`ValueError <exceptions.ValueError>`.
+
+Get metadata for an existing Instance
+-------------------------------------
+
+After creating the instance object, make a `GetInstance`_ API request
+with :meth:`reload() <google.cloud.bigtable.instance.Instance.reload>`:
+
+.. code:: python
+
+    instance.reload()
+
+This will load ``display_name`` for the existing ``instance`` object.
+
+Update an existing Instance
+---------------------------
+
+After creating the instance object, make an `UpdateInstance`_ API request
+with :meth:`update() <google.cloud.bigtable.instance.Instance.update>`:
+
+.. code:: python
+
+    client.display_name = 'New display_name'
+    instance.update()
+
+Delete an existing Instance
+---------------------------
+
+Make a `DeleteInstance`_ API request with
+:meth:`delete() <google.cloud.bigtable.instance.Instance.delete>`:
+
+.. code:: python
+
+    instance.delete()
+
+Next Step
+---------
+
+Now we go down the hierarchy from
+:class:`Instance <google.cloud.bigtable.instance.Instance>` to a
+:class:`Table <google.cloud.bigtable.table.Table>`.
+
+Head next to learn about the :doc:`table-api`.
+
+.. _Instance Admin API: https://cloud.google.com/bigtable/docs/creating-instance
+.. _CreateInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L66-L68
+.. _GetInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L38-L40
+.. _UpdateInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L93-L95
+.. _DeleteInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L109-L111
+.. _ListInstances: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L44-L46
+.. _GetOperation: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/longrunning/operations.proto#L43-L45
+.. _long-running operation: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/longrunning/operations.proto#L73-L102
diff --git a/docs/bigtable-instance.rst b/bigtable/docs/instance.rst
similarity index 100%
rename from docs/bigtable-instance.rst
rename to bigtable/docs/instance.rst
diff --git a/docs/bigtable-row-data.rst b/bigtable/docs/row-data.rst
similarity index 100%
rename from docs/bigtable-row-data.rst
rename to bigtable/docs/row-data.rst
diff --git a/bigtable/docs/row-filters.rst b/bigtable/docs/row-filters.rst
new file mode 100644
index 000000000000..292ae9dfb6aa
--- /dev/null
+++ b/bigtable/docs/row-filters.rst
@@ -0,0 +1,67 @@
+Bigtable Row Filters
+====================
+
+It is possible to use a
+:class:`RowFilter <google.cloud.bigtable.row_filters.RowFilter>`
+when adding mutations to a
+:class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>` and when
+reading row data with :meth:`read_row() <google.cloud.bigtable.table.Table.read_row>`
+or :meth:`read_rows() <google.cloud.bigtable.table.Table.read_rows>`.
+
+As laid out in the `RowFilter definition`_, the following basic filters
+are provided:
+
+* :class:`SinkFilter <.row_filters.SinkFilter>`
+* :class:`PassAllFilter <.row_filters.PassAllFilter>`
+* :class:`BlockAllFilter <.row_filters.BlockAllFilter>`
+* :class:`RowKeyRegexFilter <.row_filters.RowKeyRegexFilter>`
+* :class:`RowSampleFilter <.row_filters.RowSampleFilter>`
+* :class:`FamilyNameRegexFilter <.row_filters.FamilyNameRegexFilter>`
+* :class:`ColumnQualifierRegexFilter <.row_filters.ColumnQualifierRegexFilter>`
+* :class:`TimestampRangeFilter <.row_filters.TimestampRangeFilter>`
+* :class:`ColumnRangeFilter <.row_filters.ColumnRangeFilter>`
+* :class:`ValueRegexFilter <.row_filters.ValueRegexFilter>`
+* :class:`ValueRangeFilter <.row_filters.ValueRangeFilter>`
+* :class:`CellsRowOffsetFilter <.row_filters.CellsRowOffsetFilter>`
+* :class:`CellsRowLimitFilter <.row_filters.CellsRowLimitFilter>`
+* :class:`CellsColumnLimitFilter <.row_filters.CellsColumnLimitFilter>`
+* :class:`StripValueTransformerFilter <.row_filters.StripValueTransformerFilter>`
+* :class:`ApplyLabelFilter <.row_filters.ApplyLabelFilter>`
+
+In addition, these filters can be combined into composite filters with
+
+* :class:`RowFilterChain <.row_filters.RowFilterChain>`
+* :class:`RowFilterUnion <.row_filters.RowFilterUnion>`
+* :class:`ConditionalRowFilter <.row_filters.ConditionalRowFilter>`
+
+These rules can be nested arbitrarily, with a basic filter at the lowest
+level. For example:
+
+.. code:: python
+
+    # Filter in a specified column (matching any column family).
+    col1_filter = ColumnQualifierRegexFilter(b'columnbia')
+
+    # Create a filter to label results.
+    label1 = u'label-red'
+    label1_filter = ApplyLabelFilter(label1)
+
+    # Combine the filters to label all the cells in columnbia.
+    chain1 = RowFilterChain(filters=[col1_filter, label1_filter])
+
+    # Create a similar filter to label cells blue.
+    col2_filter = ColumnQualifierRegexFilter(b'columnseeya')
+    label2 = u'label-blue'
+    label2_filter = ApplyLabelFilter(label2)
+    chain2 = RowFilterChain(filters=[col2_filter, label2_filter])
+
+    # Bring our two labeled columns together.
+    row_filter = RowFilterUnion(filters=[chain1, chain2])
+
+----
+
+.. automodule:: google.cloud.bigtable.row_filters
+  :members:
+  :show-inheritance:
+
+.. _RowFilter definition: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/1ff247c2e3b7cd0a2dd49071b2d95beaf6563092/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_data.proto#L195
diff --git a/docs/bigtable-row.rst b/bigtable/docs/row.rst
similarity index 100%
rename from docs/bigtable-row.rst
rename to bigtable/docs/row.rst
diff --git a/bigtable/docs/snippets.py b/bigtable/docs/snippets.py
new file mode 100644
index 000000000000..850362b4a42a
--- /dev/null
+++ b/bigtable/docs/snippets.py
@@ -0,0 +1,770 @@
+#!/usr/bin/env python
+
+# 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.
+
+"""Testable usage examples for Google Cloud Bigtable API wrapper
+
+Each example function takes a ``client`` argument (which must be an instance
+of :class:`google.cloud.bigtable.client.Client`) and uses it to perform a task
+with the API.
+
+To facilitate running the examples as system tests, each example is also passed
+a ``to_delete`` list;  the function adds to the list any objects created which
+need to be deleted during teardown.
+
+.. note::
+    This file is under progress and will be updated with more guidance from
+    the team. Unit tests will be added with guidance from the team.
+
+"""
+
+import datetime
+import pytest
+
+from test_utils.system import unique_resource_id
+from test_utils.retry import RetryErrors
+from google.api_core.exceptions import NotFound
+from google.api_core.exceptions import TooManyRequests
+from google.api_core.exceptions import DeadlineExceeded
+from google.cloud._helpers import UTC
+from google.cloud.bigtable import Client
+from google.cloud.bigtable import enums
+
+
+UNIQUE_SUFFIX = unique_resource_id("-")
+INSTANCE_ID = "snippet-tests" + UNIQUE_SUFFIX
+CLUSTER_ID = "clus-1-" + UNIQUE_SUFFIX
+APP_PROFILE_ID = "app-prof" + UNIQUE_SUFFIX
+TABLE_ID = "tabl-1" + UNIQUE_SUFFIX
+ROUTING_POLICY_TYPE = enums.RoutingPolicyType.ANY
+LOCATION_ID = "us-central1-f"
+ALT_LOCATION_ID = "us-central1-a"
+PRODUCTION = enums.Instance.Type.PRODUCTION
+SERVER_NODES = 3
+STORAGE_TYPE = enums.StorageType.SSD
+LABEL_KEY = u"python-snippet"
+LABEL_STAMP = (
+    datetime.datetime.utcnow()
+    .replace(microsecond=0, tzinfo=UTC)
+    .strftime("%Y-%m-%dt%H-%M-%S")
+)
+LABELS = {LABEL_KEY: str(LABEL_STAMP)}
+INSTANCES_TO_DELETE = []
+
+retry_429 = RetryErrors(TooManyRequests, max_tries=9)
+retry_504 = RetryErrors(DeadlineExceeded, max_tries=4)
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    INSTANCE = None
+    TABLE = None
+
+
+def setup_module():
+    client = Config.CLIENT = Client(admin=True)
+    Config.INSTANCE = client.instance(
+        INSTANCE_ID, instance_type=PRODUCTION, labels=LABELS
+    )
+    cluster = Config.INSTANCE.cluster(
+        CLUSTER_ID,
+        location_id=LOCATION_ID,
+        serve_nodes=SERVER_NODES,
+        default_storage_type=STORAGE_TYPE,
+    )
+    operation = Config.INSTANCE.create(clusters=[cluster])
+    # We want to make sure the operation completes.
+    operation.result(timeout=100)
+    Config.TABLE = Config.INSTANCE.table(TABLE_ID)
+    retry_504(Config.TABLE.create)()
+
+
+def teardown_module():
+    retry_429(Config.INSTANCE.delete)()
+
+    for instance in INSTANCES_TO_DELETE:
+        try:
+            retry_429(instance.delete)()
+        except NotFound:
+            pass
+
+
+def test_bigtable_create_instance():
+    # [START bigtable_create_prod_instance]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import enums
+
+    my_instance_id = "inst-my-" + UNIQUE_SUFFIX
+    my_cluster_id = "clus-my-" + UNIQUE_SUFFIX
+    location_id = "us-central1-f"
+    serve_nodes = 3
+    storage_type = enums.StorageType.SSD
+    production = enums.Instance.Type.PRODUCTION
+    labels = {"prod-label": "prod-label"}
+
+    client = Client(admin=True)
+    instance = client.instance(my_instance_id, instance_type=production, labels=labels)
+    cluster = instance.cluster(
+        my_cluster_id,
+        location_id=location_id,
+        serve_nodes=serve_nodes,
+        default_storage_type=storage_type,
+    )
+    operation = instance.create(clusters=[cluster])
+
+    # We want to make sure the operation completes.
+    operation.result(timeout=100)
+
+    # [END bigtable_create_prod_instance]
+
+    try:
+        assert instance.exists()
+    finally:
+        retry_429(instance.delete)()
+
+
+def test_bigtable_create_additional_cluster():
+    # [START bigtable_create_cluster]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import enums
+
+    # Assuming that there is an existing instance with `INSTANCE_ID`
+    # on the server already.
+    # to create an instance see
+    # 'https://cloud.google.com/bigtable/docs/creating-instance'
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    cluster_id = "clus-my-" + UNIQUE_SUFFIX
+    location_id = "us-central1-a"
+    serve_nodes = 3
+    storage_type = enums.StorageType.SSD
+
+    cluster = instance.cluster(
+        cluster_id,
+        location_id=location_id,
+        serve_nodes=serve_nodes,
+        default_storage_type=storage_type,
+    )
+    operation = cluster.create()
+    # We want to make sure the operation completes.
+    operation.result(timeout=100)
+    # [END bigtable_create_cluster]
+
+    try:
+        assert cluster.exists()
+    finally:
+        retry_429(cluster.delete)()
+
+
+def test_bigtable_create_reload_delete_app_profile():
+    import re
+
+    # [START bigtable_create_app_profile]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import enums
+
+    routing_policy_type = enums.RoutingPolicyType.ANY
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    description = "routing policy-multy"
+
+    app_profile = instance.app_profile(
+        app_profile_id=APP_PROFILE_ID,
+        routing_policy_type=routing_policy_type,
+        description=description,
+        cluster_id=CLUSTER_ID,
+    )
+
+    app_profile = app_profile.create(ignore_warnings=True)
+    # [END bigtable_create_app_profile]
+
+    # [START bigtable_app_profile_name]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    app_profile = instance.app_profile(APP_PROFILE_ID)
+
+    app_profile_name = app_profile.name
+    # [END bigtable_app_profile_name]
+    _profile_name_re = re.compile(
+        r"^projects/(?P<project>[^/]+)/"
+        r"instances/(?P<instance>[^/]+)/"
+        r"appProfiles/(?P<appprofile_id>"
+        r"[_a-zA-Z0-9][-_.a-zA-Z0-9]*)$"
+    )
+    assert _profile_name_re.match(app_profile_name)
+
+    # [START bigtable_app_profile_exists]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    app_profile = instance.app_profile(APP_PROFILE_ID)
+
+    app_profile_exists = app_profile.exists()
+    # [END bigtable_app_profile_exists]
+    assert app_profile_exists
+
+    # [START bigtable_reload_app_profile]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    app_profile = instance.app_profile(APP_PROFILE_ID)
+
+    app_profile.reload()
+    # [END bigtable_reload_app_profile]
+    assert app_profile.routing_policy_type == ROUTING_POLICY_TYPE
+
+    # [START bigtable_update_app_profile]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    app_profile = instance.app_profile(APP_PROFILE_ID)
+    app_profile.reload()
+
+    description = "My new app profile"
+    app_profile.description = description
+    app_profile.update()
+    # [END bigtable_update_app_profile]
+    assert app_profile.description == description
+
+    # [START bigtable_delete_app_profile]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    app_profile = instance.app_profile(APP_PROFILE_ID)
+    app_profile.reload()
+
+    app_profile.delete(ignore_warnings=True)
+    # [END bigtable_delete_app_profile]
+    assert not app_profile.exists()
+
+
+def test_bigtable_list_instances():
+    # [START bigtable_list_instances]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    (instances_list, failed_locations_list) = client.list_instances()
+    # [END bigtable_list_instances]
+
+    assert len(instances_list) > 0
+
+
+def test_bigtable_list_clusters_on_instance():
+    # [START bigtable_list_clusters_on_instance]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    (clusters_list, failed_locations_list) = instance.list_clusters()
+    # [END bigtable_list_clusters_on_instance]
+
+    assert len(clusters_list) > 0
+
+
+def test_bigtable_list_clusters_in_project():
+    # [START bigtable_list_clusters_in_project]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    (clusters_list, failed_locations_list) = client.list_clusters()
+    # [END bigtable_list_clusters_in_project]
+
+    assert len(clusters_list) > 0
+
+
+def test_bigtable_list_app_profiles():
+    app_profile = Config.INSTANCE.app_profile(
+        app_profile_id="app-prof-" + UNIQUE_SUFFIX,
+        routing_policy_type=enums.RoutingPolicyType.ANY,
+    )
+    app_profile = app_profile.create(ignore_warnings=True)
+
+    # [START bigtable_list_app_profiles]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    app_profiles_list = instance.list_app_profiles()
+    # [END bigtable_list_app_profiles]
+
+    try:
+        assert len(app_profiles_list) > 0
+    finally:
+        retry_429(app_profile.delete)(ignore_warnings=True)
+
+
+def test_bigtable_instance_exists():
+    # [START bigtable_check_instance_exists]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance_exists = instance.exists()
+    # [END bigtable_check_instance_exists]
+
+    assert instance_exists
+
+
+def test_bigtable_cluster_exists():
+    # [START bigtable_check_cluster_exists]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster = instance.cluster(CLUSTER_ID)
+    cluster_exists = cluster.exists()
+    # [END bigtable_check_cluster_exists]
+
+    assert cluster_exists
+
+
+def test_bigtable_reload_instance():
+    # [START bigtable_reload_instance]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    # [END bigtable_reload_instance]
+
+    assert instance.type_ == PRODUCTION.value
+
+
+def test_bigtable_reload_cluster():
+    # [START bigtable_reload_cluster]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster = instance.cluster(CLUSTER_ID)
+    cluster.reload()
+    # [END bigtable_reload_cluster]
+
+    assert cluster.serve_nodes == SERVER_NODES
+
+
+def test_bigtable_update_instance():
+    # [START bigtable_update_instance]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    display_name = "My new instance"
+    instance.display_name = display_name
+    instance.update()
+    # [END bigtable_update_instance]
+
+    assert instance.display_name == display_name
+
+
+def test_bigtable_update_cluster():
+    # [START bigtable_update_cluster]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster = instance.cluster(CLUSTER_ID)
+    cluster.serve_nodes = 4
+    cluster.update()
+    # [END bigtable_update_cluster]
+
+    assert cluster.serve_nodes == 4
+
+
+def test_bigtable_create_table():
+    # [START bigtable_create_table]
+    from google.api_core import exceptions
+    from google.api_core import retry
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table("table_my")
+    # Define the GC policy to retain only the most recent 2 versions.
+    max_versions_rule = column_family.MaxVersionsGCRule(2)
+
+    # Could include other retriable exception types
+    # Could configure deadline, etc.
+    predicate_504 = retry.if_exception_type(exceptions.DeadlineExceeded)
+    retry_504 = retry.Retry(predicate_504)
+
+    retry_504(table.create)(column_families={"cf1": max_versions_rule})
+    # [END bigtable_create_table]
+
+    try:
+        assert table.exists()
+    finally:
+        retry_429(table.delete)()
+
+
+def test_bigtable_list_tables():
+
+    # [START bigtable_list_tables]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    tables_list = instance.list_tables()
+    # [END bigtable_list_tables]
+
+    # Check if returned list has expected table
+    table_names = [table.name for table in tables_list]
+    assert Config.TABLE.name in table_names
+
+
+def test_bigtable_delete_cluster():
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster_id = "clus-my-" + UNIQUE_SUFFIX
+    cluster = instance.cluster(
+        cluster_id,
+        location_id=ALT_LOCATION_ID,
+        serve_nodes=SERVER_NODES,
+        default_storage_type=STORAGE_TYPE,
+    )
+    operation = cluster.create()
+    # We want to make sure the operation completes.
+    operation.result(timeout=1000)
+
+    # [START bigtable_delete_cluster]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster_to_delete = instance.cluster(cluster_id)
+
+    cluster_to_delete.delete()
+    # [END bigtable_delete_cluster]
+
+    assert not cluster_to_delete.exists()
+
+
+def test_bigtable_delete_instance():
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+
+    instance_id = "snipt-inst-del" + UNIQUE_SUFFIX
+    instance = client.instance(instance_id, instance_type=PRODUCTION, labels=LABELS)
+    cluster = instance.cluster(
+        "clus-to-delete" + UNIQUE_SUFFIX,
+        location_id=ALT_LOCATION_ID,
+        serve_nodes=1,
+        default_storage_type=STORAGE_TYPE,
+    )
+    operation = instance.create(clusters=[cluster])
+
+    # We want to make sure the operation completes.
+    operation.result(timeout=100)
+
+    # Make sure this instance gets deleted after the test case.
+    INSTANCES_TO_DELETE.append(instance)
+
+    # [START bigtable_delete_instance]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+
+    instance_to_delete = client.instance(instance_id)
+    instance_to_delete.delete()
+    # [END bigtable_delete_instance]
+
+    assert not instance_to_delete.exists()
+
+    # Skip deleting it during module teardown if the assertion succeeds.
+    INSTANCES_TO_DELETE.remove(instance)
+
+
+def test_bigtable_test_iam_permissions():
+    # [START bigtable_test_iam_permissions]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    permissions = ["bigtable.clusters.create", "bigtable.tables.create"]
+    permissions_allowed = instance.test_iam_permissions(permissions)
+    # [END bigtable_test_iam_permissions]
+
+    assert permissions_allowed == permissions
+
+
+def test_bigtable_set_iam_policy_then_get_iam_policy():
+    service_account_email = Config.CLIENT._credentials.service_account_email
+
+    # [START bigtable_set_iam_policy]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.policy import Policy
+    from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    new_policy = Policy()
+    new_policy[BIGTABLE_ADMIN_ROLE] = [Policy.service_account(service_account_email)]
+
+    policy_latest = instance.set_iam_policy(new_policy)
+    # [END bigtable_set_iam_policy]
+
+    assert len(policy_latest.bigtable_admins) > 0
+
+    # [START bigtable_get_iam_policy]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    policy = instance.get_iam_policy()
+    # [END bigtable_get_iam_policy]
+
+    assert len(policy.bigtable_admins) > 0
+
+
+def test_bigtable_project_path():
+    import re
+
+    # [START bigtable_project_path]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    project_path = client.project_path
+    # [END bigtable_project_path]
+
+
+def test_bigtable_table_data_client():
+    # [START bigtable_table_data_client]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    table_data_client = client.table_data_client
+    # [END bigtable_table_data_client]
+
+
+def test_bigtable_table_admin_client():
+    # [START bigtable_table_admin_client]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    table_admin_client = client.table_admin_client
+    # [END bigtable_table_admin_client]
+
+
+def test_bigtable_instance_admin_client():
+    # [START bigtable_instance_admin_client]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance_admin_client = client.instance_admin_client
+    # [END bigtable_instance_admin_client]
+
+
+def test_bigtable_admins_policy():
+    service_account_email = Config.CLIENT._credentials.service_account_email
+
+    # [START bigtable_admins_policy]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.policy import Policy
+    from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    new_policy = Policy()
+    new_policy[BIGTABLE_ADMIN_ROLE] = [Policy.service_account(service_account_email)]
+
+    policy_latest = instance.set_iam_policy(new_policy)
+    policy = policy_latest.bigtable_admins
+    # [END bigtable_admins_policy]
+
+    assert len(policy) > 0
+
+
+def test_bigtable_readers_policy():
+    service_account_email = Config.CLIENT._credentials.service_account_email
+
+    # [START bigtable_readers_policy]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.policy import Policy
+    from google.cloud.bigtable.policy import BIGTABLE_READER_ROLE
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    new_policy = Policy()
+    new_policy[BIGTABLE_READER_ROLE] = [Policy.service_account(service_account_email)]
+
+    policy_latest = instance.set_iam_policy(new_policy)
+    policy = policy_latest.bigtable_readers
+    # [END bigtable_readers_policy]
+
+    assert len(policy) > 0
+
+
+def test_bigtable_users_policy():
+    service_account_email = Config.CLIENT._credentials.service_account_email
+
+    # [START bigtable_users_policy]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.policy import Policy
+    from google.cloud.bigtable.policy import BIGTABLE_USER_ROLE
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    new_policy = Policy()
+    new_policy[BIGTABLE_USER_ROLE] = [Policy.service_account(service_account_email)]
+
+    policy_latest = instance.set_iam_policy(new_policy)
+    policy = policy_latest.bigtable_users
+    # [END bigtable_users_policy]
+
+    assert len(policy) > 0
+
+
+def test_bigtable_viewers_policy():
+    service_account_email = Config.CLIENT._credentials.service_account_email
+
+    # [START bigtable_viewers_policy]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.policy import Policy
+    from google.cloud.bigtable.policy import BIGTABLE_VIEWER_ROLE
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance.reload()
+    new_policy = Policy()
+    new_policy[BIGTABLE_VIEWER_ROLE] = [Policy.service_account(service_account_email)]
+
+    policy_latest = instance.set_iam_policy(new_policy)
+    policy = policy_latest.bigtable_viewers
+    # [END bigtable_viewers_policy]
+
+    assert len(policy) > 0
+
+
+def test_bigtable_instance_name():
+    import re
+
+    # [START bigtable_instance_name]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance_name = instance.name
+    # [END bigtable_instance_name]
+
+
+def test_bigtable_cluster_name():
+    import re
+
+    # [START bigtable_cluster_name]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster = instance.cluster(CLUSTER_ID)
+    cluster_name = cluster.name
+    # [END bigtable_cluster_name]
+
+
+def test_bigtable_instance_from_pb():
+    # [START bigtable_instance_from_pb]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    name = instance.name
+    instance_pb = instance_pb2.Instance(
+        name=name, display_name=INSTANCE_ID, type=PRODUCTION, labels=LABELS
+    )
+
+    instance2 = instance.from_pb(instance_pb, client)
+    # [END bigtable_instance_from_pb]
+
+    assert instance2.name == instance.name
+
+
+def test_bigtable_cluster_from_pb():
+    # [START bigtable_cluster_from_pb]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster = instance.cluster(CLUSTER_ID)
+
+    name = cluster.name
+    cluster_state = cluster.state
+    cluster_pb = instance_pb2.Cluster(
+        name=name,
+        location=LOCATION_ID,
+        state=cluster_state,
+        serve_nodes=SERVER_NODES,
+        default_storage_type=STORAGE_TYPE,
+    )
+
+    cluster2 = cluster.from_pb(cluster_pb, instance)
+    # [END bigtable_cluster_from_pb]
+
+    assert cluster2.name == cluster.name
+
+
+def test_bigtable_instance_state():
+    # [START bigtable_instance_state]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    instance_state = instance.state
+    # [END bigtable_instance_state]
+
+    assert not instance_state
+
+
+def test_bigtable_cluster_state():
+    # [START bigtable_cluster_state]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    cluster = instance.cluster(CLUSTER_ID)
+    cluster_state = cluster.state
+    # [END bigtable_cluster_state]
+
+    assert not cluster_state
+
+
+if __name__ == "__main__":
+    pytest.main()
diff --git a/bigtable/docs/snippets_table.py b/bigtable/docs/snippets_table.py
new file mode 100644
index 000000000000..0fbb16bf74ad
--- /dev/null
+++ b/bigtable/docs/snippets_table.py
@@ -0,0 +1,1242 @@
+#!/usr/bin/env python
+
+# 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.
+
+"""Testable usage examples for Google Cloud Bigtable API wrapper
+
+Each example function takes a ``client`` argument (which must be an instance
+of :class:`google.cloud.bigtable.client.Client`) and uses it to perform a task
+with the API.
+
+To facilitate running the examples as system tests, each example is also passed
+a ``to_delete`` list;  the function adds to the list any objects created which
+need to be deleted during teardown.
+
+.. note::
+    This file is under progress and will be updated with more guidance from
+    the team. Unit tests will be added with guidance from the team.
+
+"""
+
+import datetime
+import pytest
+
+from test_utils.system import unique_resource_id
+from google.cloud._helpers import UTC
+from google.cloud.bigtable import Client
+from google.cloud.bigtable import enums
+from google.cloud.bigtable import column_family
+
+
+INSTANCE_ID = "snippet" + unique_resource_id("-")
+CLUSTER_ID = "clus-1" + unique_resource_id("-")
+TABLE_ID = "tabl-1" + unique_resource_id("-")
+COLUMN_FAMILY_ID = "col_fam_id-" + unique_resource_id("-")
+LOCATION_ID = "us-central1-f"
+ALT_LOCATION_ID = "us-central1-a"
+PRODUCTION = enums.Instance.Type.PRODUCTION
+SERVER_NODES = 3
+STORAGE_TYPE = enums.StorageType.SSD
+LABEL_KEY = u"python-snippet"
+LABEL_STAMP = (
+    datetime.datetime.utcnow()
+    .replace(microsecond=0, tzinfo=UTC)
+    .strftime("%Y-%m-%dt%H-%M-%S")
+)
+LABELS = {LABEL_KEY: str(LABEL_STAMP)}
+COLUMN_FAMILY_ID = "col_fam_id1"
+COL_NAME1 = b"col-name1"
+CELL_VAL1 = b"cell-val"
+ROW_KEY1 = b"row_key_id1"
+COLUMN_FAMILY_ID2 = "col_fam_id2"
+COL_NAME2 = b"col-name2"
+CELL_VAL2 = b"cell-val2"
+ROW_KEY2 = b"row_key_id2"
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    INSTANCE = None
+    TABLE = None
+
+
+def setup_module():
+    client = Config.CLIENT = Client(admin=True)
+    Config.INSTANCE = client.instance(
+        INSTANCE_ID, instance_type=PRODUCTION, labels=LABELS
+    )
+    cluster = Config.INSTANCE.cluster(
+        CLUSTER_ID,
+        location_id=LOCATION_ID,
+        serve_nodes=SERVER_NODES,
+        default_storage_type=STORAGE_TYPE,
+    )
+    operation = Config.INSTANCE.create(clusters=[cluster])
+    # We want to make sure the operation completes.
+    operation.result(timeout=100)
+    Config.TABLE = Config.INSTANCE.table(TABLE_ID)
+    Config.TABLE.create()
+    gc_rule = column_family.MaxVersionsGCRule(2)
+    column_family1 = Config.TABLE.column_family(COLUMN_FAMILY_ID, gc_rule=gc_rule)
+    column_family1.create()
+    gc_rule2 = column_family.MaxVersionsGCRule(4)
+    column_family2 = Config.TABLE.column_family(COLUMN_FAMILY_ID2, gc_rule=gc_rule2)
+    column_family2.create()
+
+
+def teardown_module():
+    Config.INSTANCE.delete()
+
+
+def test_bigtable_create_table():
+    # [START bigtable_create_table]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    # Create table without Column families.
+    table1 = instance.table("table_id1")
+    table1.create()
+
+    # Create table with Column families.
+    table2 = instance.table("table_id2")
+    # Define the GC policy to retain only the most recent 2 versions.
+    max_versions_rule = column_family.MaxVersionsGCRule(2)
+    table2.create(column_families={"cf1": max_versions_rule})
+
+    # [END bigtable_create_table]
+    assert table1.exists()
+    assert table2.exists()
+    table1.delete()
+    table2.delete()
+
+
+def test_bigtable_sample_row_keys():
+    table_sample = Config.INSTANCE.table("table_id1_samplerow")
+    initial_split_keys = [b"split_key_1", b"split_key_10", b"split_key_20"]
+    table_sample.create(initial_split_keys=initial_split_keys)
+    assert table_sample.exists()
+
+    # [START bigtable_sample_row_keys]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    table = instance.table("table_id1_samplerow")
+    data = table.sample_row_keys()
+    actual_keys, offset = zip(*[(rk.row_key, rk.offset_bytes) for rk in data])
+    # [END bigtable_sample_row_keys]
+    initial_split_keys.append(b"")
+    assert list(actual_keys) == initial_split_keys
+    table.delete()
+
+
+def test_bigtable_write_read_drop_truncate():
+    # [START bigtable_mutate_rows]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_keys = [
+        b"row_key_1",
+        b"row_key_2",
+        b"row_key_3",
+        b"row_key_4",
+        b"row_key_20",
+        b"row_key_22",
+        b"row_key_200",
+    ]
+    col_name = b"col-name1"
+    rows = []
+    for i, row_key in enumerate(row_keys):
+        value = "value_{}".format(i).encode()
+        row = table.row(row_key)
+        row.set_cell(
+            COLUMN_FAMILY_ID, col_name, value, timestamp=datetime.datetime.utcnow()
+        )
+        rows.append(row)
+    response = table.mutate_rows(rows)
+    # validate that all rows written successfully
+    for i, status in enumerate(response):
+        if status.code != 0:
+            print("Row number {} failed to write".format(i))
+    # [END bigtable_mutate_rows]
+    assert len(response) == len(rows)
+    # [START bigtable_read_row]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_key = "row_key_1"
+    row = table.read_row(row_key)
+    # [END bigtable_read_row]
+    assert row.row_key.decode("utf-8") == row_key
+    # [START bigtable_read_rows]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    # Read full table
+    partial_rows = table.read_rows()
+    read_rows = [row for row in partial_rows]
+    # [END bigtable_read_rows]
+    assert len(read_rows) == len(rows)
+    # [START bigtable_drop_by_prefix]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_key_prefix = b"row_key_2"
+    table.drop_by_prefix(row_key_prefix, timeout=200)
+    # [END bigtable_drop_by_prefix]
+    dropped_row_keys = [b"row_key_2", b"row_key_20", b"row_key_22", b"row_key_200"]
+    for row in table.read_rows():
+        assert row.row_key.decode("utf-8") not in dropped_row_keys
+
+    # [START bigtable_truncate_table]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    table.truncate(timeout=200)
+    # [END bigtable_truncate_table]
+    rows_data_after_truncate = []
+    for row in table.read_rows():
+        rows_data_after_truncate.append(row.row_key)
+    assert rows_data_after_truncate == []
+
+
+def test_bigtable_mutations_batcher():
+    # [START bigtable_mutations_batcher]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    batcher = table.mutations_batcher()
+    # [END bigtable_mutations_batcher]
+
+    # Below code will be used while creating batcher.py snippets.
+    # So not removing this code as of now.
+    row_keys = [
+        b"row_key_1",
+        b"row_key_2",
+        b"row_key_3",
+        b"row_key_4",
+        b"row_key_20",
+        b"row_key_22",
+        b"row_key_200",
+    ]
+    column_name = "column_name".encode()
+    # Add a single row
+    row_key = row_keys[0]
+    row = table.row(row_key)
+    row.set_cell(
+        COLUMN_FAMILY_ID, column_name, "value-0", timestamp=datetime.datetime.utcnow()
+    )
+    batcher.mutate(row)
+    # Add a collections of rows
+    rows = []
+    for i in range(1, len(row_keys)):
+        row = table.row(row_keys[i])
+        value = "value_{}".format(i).encode()
+        row.set_cell(
+            COLUMN_FAMILY_ID, column_name, value, timestamp=datetime.datetime.utcnow()
+        )
+        rows.append(row)
+    batcher.mutate_rows(rows)
+    # batcher will flush current batch if it
+    # reaches the max flush_count
+
+    # Manually send the current batch to Cloud Bigtable
+    batcher.flush()
+    rows_on_table = []
+    for row in table.read_rows():
+        rows_on_table.append(row.row_key)
+    assert len(rows_on_table) == len(row_keys)
+    table.truncate(timeout=200)
+
+
+def test_bigtable_table_column_family():
+    # [START bigtable_table_column_family]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    table = instance.table(TABLE_ID)
+    column_family_obj = table.column_family(COLUMN_FAMILY_ID)
+    # [END bigtable_table_column_family]
+
+    assert column_family_obj.column_family_id == COLUMN_FAMILY_ID
+
+
+def test_bigtable_list_tables():
+    # [START bigtable_list_tables]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    tables_list = instance.list_tables()
+    # [END bigtable_list_tables]
+    assert len(tables_list) != 0
+
+
+def test_bigtable_table_name():
+    import re
+
+    # [START bigtable_table_name]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+
+    table = instance.table(TABLE_ID)
+    table_name = table.name
+    # [END bigtable_table_name]
+    _table_name_re = re.compile(
+        r"^projects/(?P<project>[^/]+)/"
+        r"instances/(?P<instance>[^/]+)/tables/"
+        r"(?P<table_id>[_a-zA-Z0-9][-_.a-zA-Z0-9]*)$"
+    )
+    assert _table_name_re.match(table_name)
+
+
+def test_bigtable_list_column_families():
+    # [START bigtable_list_column_families]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    column_family_list = table.list_column_families()
+    # [END bigtable_list_column_families]
+
+    assert len(column_family_list) > 0
+
+
+def test_bigtable_get_cluster_states():
+    # [START bigtable_get_cluster_states]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    get_cluster_states = table.get_cluster_states()
+    # [END bigtable_get_cluster_states]
+
+    assert CLUSTER_ID in get_cluster_states
+
+
+def test_bigtable_table_exists():
+    # [START bigtable_check_table_exists]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    table_exists = table.exists()
+    # [END bigtable_check_table_exists]
+    assert table_exists
+
+
+def test_bigtable_delete_table():
+    table_del = Config.INSTANCE.table("table_id_del")
+    table_del.create()
+    assert table_del.exists()
+
+    # [START bigtable_delete_table]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table("table_id_del")
+
+    table.delete()
+    # [END bigtable_delete_table]
+    assert not table.exists()
+
+
+def test_bigtable_table_row():
+    # [START bigtable_table_row]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_keys = [b"row_key_1", b"row_key_2"]
+    row1_obj = table.row(row_keys[0])
+    row2_obj = table.row(row_keys[1])
+    # [END bigtable_table_row]
+
+    row1_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row1_obj.commit()
+    row2_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row2_obj.commit()
+
+    written_row_keys = []
+    for row in table.read_rows():
+        written_row_keys.append(row.row_key)
+
+    assert written_row_keys == row_keys
+
+    table.truncate(timeout=300)
+
+
+def test_bigtable_table_append_row():
+    # [START bigtable_table_append_row]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_keys = [b"row_key_1", b"row_key_2"]
+    row1_obj = table.append_row(row_keys[0])
+    row2_obj = table.append_row(row_keys[1])
+    # [END bigtable_table_append_row]
+
+    row1_obj.append_cell_value(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row1_obj.commit()
+    row2_obj.append_cell_value(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row2_obj.commit()
+
+    written_row_keys = []
+    for row in table.read_rows():
+        written_row_keys.append(row.row_key)
+
+    assert written_row_keys == row_keys
+
+    table.truncate(timeout=300)
+
+
+def test_bigtable_table_direct_row():
+    # [START bigtable_table_direct_row]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_keys = [b"row_key_1", b"row_key_2"]
+    row1_obj = table.direct_row(row_keys[0])
+    row2_obj = table.direct_row(row_keys[1])
+    # [END bigtable_table_direct_row]
+
+    row1_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row1_obj.commit()
+    row2_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row2_obj.commit()
+
+    written_row_keys = []
+    for row in table.read_rows():
+        written_row_keys.append(row.row_key)
+
+    assert written_row_keys == row_keys
+
+    table.truncate(timeout=300)
+
+
+def test_bigtable_table_conditional_row():
+    # [START bigtable_table_conditional_row]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.row_filters import PassAllFilter
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_keys = [b"row_key_1", b"row_key_2"]
+    filter_ = PassAllFilter(True)
+    row1_obj = table.conditional_row(row_keys[0], filter_=filter_)
+    row2_obj = table.conditional_row(row_keys[1], filter_=filter_)
+    # [END bigtable_table_conditional_row]
+
+    row1_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1, state=False)
+    row1_obj.commit()
+    row2_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1, state=False)
+    row2_obj.commit()
+
+    written_row_keys = []
+    for row in table.read_rows():
+        written_row_keys.append(row.row_key)
+
+    assert written_row_keys == row_keys
+
+    table.truncate(timeout=300)
+
+
+def test_bigtable_column_family_name():
+    # [START bigtable_column_family_name]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    column_families = table.list_column_families()
+    column_family_obj = column_families[COLUMN_FAMILY_ID]
+    column_family_name = column_family_obj.name
+    # [END bigtable_column_family_name]
+    import re
+
+    _cf_name_re = re.compile(
+        r"^projects/(?P<project>[^/]+)/"
+        r"instances/(?P<instance>[^/]+)/tables/"
+        r"(?P<table>[^/]+)/columnFamilies/"
+        r"(?P<cf_id>[_a-zA-Z0-9][-_.a-zA-Z0-9]*)$"
+    )
+    assert _cf_name_re.match(column_family_name)
+
+
+def test_bigtable_create_update_delete_column_family():
+    # [START bigtable_create_column_family]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    column_family_id = "column_family_id1"
+    gc_rule = column_family.MaxVersionsGCRule(2)
+    column_family_obj = table.column_family(column_family_id, gc_rule=gc_rule)
+    column_family_obj.create()
+
+    # [END bigtable_create_column_family]
+    column_families = table.list_column_families()
+    assert column_families[column_family_id].gc_rule == gc_rule
+
+    # [START bigtable_update_column_family]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    # Already existing column family id
+    column_family_id = "column_family_id1"
+    # Define the GC rule to retain data with max age of 5 days
+    max_age_rule = column_family.MaxAgeGCRule(datetime.timedelta(days=5))
+    column_family_obj = table.column_family(column_family_id, gc_rule=max_age_rule)
+    column_family_obj.update()
+    # [END bigtable_update_column_family]
+
+    updated_families = table.list_column_families()
+    assert updated_families[column_family_id].gc_rule == max_age_rule
+
+    # [START bigtable_delete_column_family]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    column_family_id = "column_family_id1"
+    column_family_obj = table.column_family(column_family_id)
+    column_family_obj.delete()
+    # [END bigtable_delete_column_family]
+    column_families = table.list_column_families()
+    assert column_family_id not in column_families
+
+
+def test_bigtable_add_row_add_row_range_add_row_range_from_keys():
+    row_keys = [
+        b"row_key_1",
+        b"row_key_2",
+        b"row_key_3",
+        b"row_key_4",
+        b"row_key_5",
+        b"row_key_6",
+        b"row_key_7",
+        b"row_key_8",
+        b"row_key_9",
+    ]
+
+    rows = []
+    for row_key in row_keys:
+        row = Config.TABLE.row(row_key)
+        row.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+        rows.append(row)
+    Config.TABLE.mutate_rows(rows)
+
+    # [START bigtable_add_row_key]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.row_set import RowSet
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_set = RowSet()
+    row_set.add_row_key(b"row_key_5")
+    # [END bigtable_add_row_key]
+
+    read_rows = table.read_rows(row_set=row_set)
+    expected_row_keys = [b"row_key_5"]
+    found_row_keys = [row.row_key for row in read_rows]
+    assert found_row_keys == expected_row_keys
+
+    # [START bigtable_add_row_range]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.row_set import RowSet
+    from google.cloud.bigtable.row_set import RowRange
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_set = RowSet()
+    row_set.add_row_range(RowRange(start_key=b"row_key_3", end_key=b"row_key_7"))
+    # [END bigtable_add_row_range]
+
+    read_rows = table.read_rows(row_set=row_set)
+    expected_row_keys = [b"row_key_3", b"row_key_4", b"row_key_5", b"row_key_6"]
+    found_row_keys = [row.row_key for row in read_rows]
+    assert found_row_keys == expected_row_keys
+
+    # [START bigtable_row_range_from_keys]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable.row_set import RowSet
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_set = RowSet()
+    row_set.add_row_range_from_keys(start_key=b"row_key_3", end_key=b"row_key_7")
+    # [END bigtable_row_range_from_keys]
+
+    read_rows = table.read_rows(row_set=row_set)
+    expected_row_keys = [b"row_key_3", b"row_key_4", b"row_key_5", b"row_key_6"]
+    found_row_keys = [row.row_key for row in read_rows]
+    assert found_row_keys == expected_row_keys
+
+    table.truncate(timeout=200)
+
+
+def test_bigtable_batcher_mutate_flush_mutate_rows():
+    # [START bigtable_batcher_mutate]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    # Batcher for max row bytes, max_row_bytes=1024 is optional.
+    batcher = table.mutations_batcher(max_row_bytes=1024)
+
+    # Add a single row
+    row_key = b"row_key_1"
+    row = table.row(row_key)
+    row.set_cell(
+        COLUMN_FAMILY_ID, COL_NAME1, "value-0", timestamp=datetime.datetime.utcnow()
+    )
+
+    # In batcher, mutate will flush current batch if it
+    # reaches the max_row_bytes
+    batcher.mutate(row)
+    batcher.flush()
+    # [END bigtable_batcher_mutate]
+
+    # [START bigtable_batcher_flush]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    # Batcher for max row bytes, max_row_bytes=1024 is optional.
+    batcher = table.mutations_batcher(max_row_bytes=1024)
+
+    # Add a single row
+    row_key = b"row_key"
+    row = table.row(row_key)
+    row.set_cell(COLUMN_FAMILY_ID, COL_NAME1, "value-0")
+
+    # In batcher, mutate will flush current batch if it
+    # reaches the max_row_bytes
+    batcher.mutate(row)
+    batcher.flush()
+    # [END bigtable_batcher_flush]
+
+    rows_on_table = []
+    for row in table.read_rows():
+        rows_on_table.append(row.row_key)
+    assert len(rows_on_table) == 2
+    table.truncate(timeout=200)
+
+    # [START bigtable_batcher_mutate_rows]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    batcher = table.mutations_batcher()
+
+    row1 = table.row(b"row_key_1")
+    row2 = table.row(b"row_key_2")
+    row3 = table.row(b"row_key_3")
+    row4 = table.row(b"row_key_4")
+
+    row1.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val1")
+    row2.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val2")
+    row3.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val3")
+    row4.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val4")
+
+    batcher.mutate_rows([row1, row2, row3, row4])
+
+    # batcher will flush current batch if it
+    # reaches the max flush_count
+    # Manually send the current batch to Cloud Bigtable
+    batcher.flush()
+    # [END bigtable_batcher_mutate_rows]
+
+    rows_on_table = []
+    for row in table.read_rows():
+        rows_on_table.append(row.row_key)
+    assert len(rows_on_table) == 4
+    table.truncate(timeout=200)
+
+
+def test_bigtable_create_family_gc_max_age():
+    # [START bigtable_create_family_gc_max_age]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    # Define the GC rule to retain data with max age of 5 days
+    max_age_rule = column_family.MaxAgeGCRule(datetime.timedelta(days=5))
+
+    column_family_obj = table.column_family("cf1", max_age_rule)
+    column_family_obj.create()
+
+    # [END bigtable_create_family_gc_max_age]
+    rule = str(column_family_obj.to_pb())
+    assert "max_age" in rule
+    assert "seconds: 432000" in rule
+    column_family_obj.delete()
+
+
+def test_bigtable_create_family_gc_max_versions():
+    # [START bigtable_create_family_gc_max_versions]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    # Define the GC policy to retain only the most recent 2 versions
+    max_versions_rule = column_family.MaxVersionsGCRule(2)
+
+    column_family_obj = table.column_family("cf2", max_versions_rule)
+    column_family_obj.create()
+
+    # [END bigtable_create_family_gc_max_versions]
+    rule = str(column_family_obj.to_pb())
+    assert "max_num_versions: 2" in rule
+    column_family_obj.delete()
+
+
+def test_bigtable_create_family_gc_union():
+    # [START bigtable_create_family_gc_union]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    max_versions_rule = column_family.MaxVersionsGCRule(2)
+    max_age_rule = column_family.MaxAgeGCRule(datetime.timedelta(days=5))
+
+    union_rule = column_family.GCRuleUnion([max_versions_rule, max_age_rule])
+
+    column_family_obj = table.column_family("cf3", union_rule)
+    column_family_obj.create()
+
+    # [END bigtable_create_family_gc_union]
+    rule = str(column_family_obj.to_pb())
+    assert "union" in rule
+    assert "max_age" in rule
+    assert "seconds: 432000" in rule
+    assert "max_num_versions: 2" in rule
+    column_family_obj.delete()
+
+
+def test_bigtable_create_family_gc_intersection():
+    # [START bigtable_create_family_gc_intersection]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    max_versions_rule = column_family.MaxVersionsGCRule(2)
+    max_age_rule = column_family.MaxAgeGCRule(datetime.timedelta(days=5))
+
+    intersection_rule = column_family.GCRuleIntersection(
+        [max_versions_rule, max_age_rule]
+    )
+
+    column_family_obj = table.column_family("cf4", intersection_rule)
+    column_family_obj.create()
+
+    # [END bigtable_create_family_gc_intersection]
+
+    rule = str(column_family_obj.to_pb())
+    assert "intersection" in rule
+    assert "max_num_versions: 2" in rule
+    assert "max_age" in rule
+    assert "seconds: 432000" in rule
+    column_family_obj.delete()
+
+
+def test_bigtable_create_family_gc_nested():
+    # [START bigtable_create_family_gc_nested]
+    from google.cloud.bigtable import Client
+    from google.cloud.bigtable import column_family
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    # Create a column family with nested GC policies.
+    # Create a nested GC rule:
+    # Drop cells that are either older than the 10 recent versions
+    # OR
+    # Drop cells that are older than a month AND older than the
+    # 2 recent versions
+    rule1 = column_family.MaxVersionsGCRule(10)
+    rule2 = column_family.GCRuleIntersection(
+        [
+            column_family.MaxAgeGCRule(datetime.timedelta(days=5)),
+            column_family.MaxVersionsGCRule(2),
+        ]
+    )
+
+    nested_rule = column_family.GCRuleUnion([rule1, rule2])
+
+    column_family_obj = table.column_family("cf5", nested_rule)
+    column_family_obj.create()
+
+    # [END bigtable_create_family_gc_nested]
+
+    rule = str(column_family_obj.to_pb())
+    assert "intersection" in rule
+    assert "max_num_versions: 2" in rule
+    assert "max_age" in rule
+    assert "seconds: 432000" in rule
+    column_family_obj.delete()
+
+
+def test_bigtable_row_data_cells_cell_value_cell_values():
+
+    value = b"value_in_col1"
+    row = Config.TABLE.row(b"row_key_1")
+    row.set_cell(
+        COLUMN_FAMILY_ID, COL_NAME1, value, timestamp=datetime.datetime.utcnow()
+    )
+    row.commit()
+
+    row.set_cell(
+        COLUMN_FAMILY_ID, COL_NAME1, value, timestamp=datetime.datetime.utcnow()
+    )
+    row.commit()
+
+    # [START bigtable_row_data_cells]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_key = "row_key_1"
+    row_data = table.read_row(row_key)
+
+    cells = row_data.cells
+    # [END bigtable_row_data_cells]
+
+    actual_cell_value = cells[COLUMN_FAMILY_ID][COL_NAME1][0].value
+    assert actual_cell_value == value
+
+    # [START bigtable_row_cell_value]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_key = "row_key_1"
+    row_data = table.read_row(row_key)
+
+    cell_value = row_data.cell_value(COLUMN_FAMILY_ID, COL_NAME1)
+    # [END bigtable_row_cell_value]
+    assert cell_value == value
+
+    # [START bigtable_row_cell_values]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_key = "row_key_1"
+    row_data = table.read_row(row_key)
+
+    cell_values = row_data.cell_values(COLUMN_FAMILY_ID, COL_NAME1)
+    # [END bigtable_row_cell_values]
+
+    for actual_value, timestamp in cell_values:
+        assert actual_value == value
+
+    value2 = b"value_in_col2"
+    row.set_cell(COLUMN_FAMILY_ID, COL_NAME2, value2)
+    row.commit()
+
+    # [START bigtable_row_find_cells]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row_key = "row_key_1"
+    row = table.read_row(row_key)
+
+    cells = row.find_cells(COLUMN_FAMILY_ID, COL_NAME2)
+    # [END bigtable_row_find_cells]
+
+    assert cells[0].value == value2
+    table.truncate(timeout=200)
+
+
+def test_bigtable_row_setcell_rowkey():
+    # [START bigtable_row_set_cell]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row = table.row(ROW_KEY1)
+
+    cell_val = b"cell-val"
+    row.set_cell(
+        COLUMN_FAMILY_ID, COL_NAME1, cell_val, timestamp=datetime.datetime.utcnow()
+    )
+    # [END bigtable_row_set_cell]
+
+    response = table.mutate_rows([row])
+    # validate that all rows written successfully
+    for i, status in enumerate(response):
+        assert status.code == 0
+
+    # [START bigtable_row_row_key]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row = table.row(ROW_KEY1)
+    row_key = row.row_key
+    # [END bigtable_row_row_key]
+    assert row_key == ROW_KEY1
+
+    # [START bigtable_row_table]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row = table.row(ROW_KEY1)
+    table1 = row.table
+    # [END bigtable_row_table]
+
+    assert table1 == table
+    table.truncate(timeout=200)
+
+
+def test_bigtable_row_delete():
+    table_row_del = Config.INSTANCE.table(TABLE_ID)
+    row_obj = table_row_del.row(b"row_key_1")
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val")
+    row_obj.commit()
+    written_row_keys = []
+    for row in table_row_del.read_rows():
+        written_row_keys.append(row.row_key)
+    assert written_row_keys == [b"row_key_1"]
+
+    # [START bigtable_row_delete]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key = b"row_key_1"
+    row_obj = table.row(row_key)
+
+    row_obj.delete()
+    row_obj.commit()
+    # [END bigtable_row_delete]
+
+    written_row_keys = []
+    for row in table.read_rows():
+        written_row_keys.append(row.row_key)
+    assert len(written_row_keys) == 0
+
+
+def test_bigtable_row_delete_cell():
+    table_row_del_cell = Config.INSTANCE.table(TABLE_ID)
+    row_key1 = b"row_key_1"
+    row_obj = table_row_del_cell.row(row_key1)
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row_obj.commit()
+
+    written_row_keys = []
+    for row in table_row_del_cell.read_rows():
+        written_row_keys.append(row.row_key)
+    assert written_row_keys == [row_key1]
+
+    # [START bigtable_row_delete_cell]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key = b"row_key_1"
+    row_obj = table.row(row_key)
+
+    row_obj.delete_cell(COLUMN_FAMILY_ID, COL_NAME1)
+    row_obj.commit()
+    # [END bigtable_row_delete_cell]
+
+    for row in table.read_rows():
+        assert not row.row_key
+
+
+def test_bigtable_row_delete_cells():
+    table_row_del_cells = Config.INSTANCE.table(TABLE_ID)
+    row_key1 = b"row_key_1"
+    row_obj = table_row_del_cells.row(row_key1)
+
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, CELL_VAL1)
+    row_obj.commit()
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME2, CELL_VAL2)
+    row_obj.commit()
+
+    written_row_keys = []
+    for row in table_row_del_cells.read_rows():
+        written_row_keys.append(row.row_key)
+    assert written_row_keys == [row_key1]
+
+    # [START bigtable_row_delete_cells]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key = b"row_key_1"
+    row_obj = table.row(row_key)
+
+    row_obj.delete_cells(COLUMN_FAMILY_ID, [COL_NAME1, COL_NAME2])
+    row_obj.commit()
+    # [END bigtable_row_delete_cells]
+
+    for row in table.read_rows():
+        assert not row.row_key
+
+
+def test_bigtable_row_clear():
+    table_row_clear = Config.INSTANCE.table(TABLE_ID)
+    row_obj = table_row_clear.row(b"row_key_1")
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val")
+
+    mutation_size = row_obj.get_mutations_size()
+    assert mutation_size > 0
+
+    # [START bigtable_row_clear]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key = b"row_key_1"
+    row_obj = table.row(row_key)
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val")
+
+    row_obj.clear()
+    # [END bigtable_row_clear]
+
+    mutation_size = row_obj.get_mutations_size()
+    assert mutation_size == 0
+
+
+def test_bigtable_row_clear_get_mutations_size():
+    # [START bigtable_row_get_mutations_size]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key_id = b"row_key_1"
+    row_obj = table.row(row_key_id)
+
+    mutation_size = row_obj.get_mutations_size()
+    # [END bigtable_row_get_mutations_size]
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, b"cell-val")
+    mutation_size = row_obj.get_mutations_size()
+    assert mutation_size > 0
+
+    row_obj.clear()
+    mutation_size = row_obj.get_mutations_size()
+    assert mutation_size == 0
+
+
+def test_bigtable_row_setcell_commit_rowkey():
+    # [START bigtable_row_set_cell]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key = b"row_key_1"
+    cell_val = b"cell-val"
+    row_obj = table.row(row_key)
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, cell_val)
+    # [END bigtable_row_set_cell]
+    row_obj.commit()
+
+    # [START bigtable_row_commit]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key = b"row_key_2"
+    cell_val = b"cell-val"
+    row_obj = table.row(row_key)
+    row_obj.set_cell(COLUMN_FAMILY_ID, COL_NAME1, cell_val)
+    row_obj.commit()
+    # [END bigtable_row_commit]
+
+    written_row_keys = []
+    for row in table.read_rows():
+        written_row_keys.append(row.row_key)
+
+    assert written_row_keys == [b"row_key_1", b"row_key_2"]
+
+    # [START bigtable_row_row_key]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+
+    row_key_id = b"row_key_2"
+    row_obj = table.row(row_key_id)
+    row_key = row_obj.row_key
+    # [END bigtable_row_row_key]
+    assert row_key == row_key_id
+    table.truncate(timeout=300)
+
+
+def test_bigtable_row_append_cell_value():
+    row = Config.TABLE.row(ROW_KEY1)
+
+    cell_val1 = b"1"
+    row.set_cell(COLUMN_FAMILY_ID, COL_NAME1, cell_val1)
+    row.commit()
+
+    # [START bigtable_row_append_cell_value]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row = table.row(ROW_KEY1, append=True)
+
+    cell_val2 = b"2"
+    row.append_cell_value(COLUMN_FAMILY_ID, COL_NAME1, cell_val2)
+    # [END bigtable_row_append_cell_value]
+    row.commit()
+
+    row_data = table.read_row(ROW_KEY1)
+    actual_value = row_data.cell_value(COLUMN_FAMILY_ID, COL_NAME1)
+    assert actual_value == cell_val1 + cell_val2
+
+    # [START bigtable_row_commit]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row = Config.TABLE.row(ROW_KEY2)
+    cell_val = 1
+    row.set_cell(COLUMN_FAMILY_ID, COL_NAME1, cell_val)
+    row.commit()
+    # [END bigtable_row_commit]
+
+    # [START bigtable_row_increment_cell_value]
+    from google.cloud.bigtable import Client
+
+    client = Client(admin=True)
+    instance = client.instance(INSTANCE_ID)
+    table = instance.table(TABLE_ID)
+    row = table.row(ROW_KEY2, append=True)
+
+    int_val = 3
+    row.increment_cell_value(COLUMN_FAMILY_ID, COL_NAME1, int_val)
+    # [END bigtable_row_increment_cell_value]
+    row.commit()
+
+    row_data = table.read_row(ROW_KEY2)
+    actual_value = row_data.cell_value(COLUMN_FAMILY_ID, COL_NAME1)
+
+    import struct
+
+    _PACK_I64 = struct.Struct(">q").pack
+    assert actual_value == _PACK_I64(cell_val + int_val)
+    table.truncate(timeout=200)
+
+
+if __name__ == "__main__":
+    pytest.main()
diff --git a/bigtable/docs/table-api.rst b/bigtable/docs/table-api.rst
new file mode 100644
index 000000000000..5168aad49ff7
--- /dev/null
+++ b/bigtable/docs/table-api.rst
@@ -0,0 +1,154 @@
+Table Admin API
+===============
+
+After creating an :class:`Instance <google.cloud.bigtable.instance.Instance>`, you can
+interact with individual tables, groups of tables or column families within
+a table.
+
+List Tables
+-----------
+
+If you want a comprehensive list of all existing tables in a instance, make a
+`ListTables`_ API request with
+:meth:`Instance.list_tables() <google.cloud.bigtable.instance.Instance.list_tables>`:
+
+.. code:: python
+
+    >>> instance.list_tables()
+    [<google.cloud.bigtable.table.Table at 0x7ff6a1de8f50>,
+     <google.cloud.bigtable.table.Table at 0x7ff6a1de8350>]
+
+Table Factory
+-------------
+
+To create a :class:`Table <google.cloud.bigtable.table.Table>` object:
+
+.. code:: python
+
+    table = instance.table(table_id)
+
+Even if this :class:`Table <google.cloud.bigtable.table.Table>` already
+has been created with the API, you'll want this object to use as a
+parent of a :class:`ColumnFamily <google.cloud.bigtable.column_family.ColumnFamily>`
+or :class:`Row <google.cloud.bigtable.row.Row>`.
+
+Create a new Table
+------------------
+
+After creating the table object, make a `CreateTable`_ API request
+with :meth:`create() <google.cloud.bigtable.table.Table.create>`:
+
+.. code:: python
+
+    table.create()
+
+If you would like to initially split the table into several tablets (tablets are
+similar to HBase regions):
+
+.. code:: python
+
+    table.create(initial_split_keys=['s1', 's2'])
+
+Delete an existing Table
+------------------------
+
+Make a `DeleteTable`_ API request with
+:meth:`delete() <google.cloud.bigtable.table.Table.delete>`:
+
+.. code:: python
+
+    table.delete()
+
+List Column Families in a Table
+-------------------------------
+
+Though there is no **official** method for retrieving `column families`_
+associated with a table, the `GetTable`_ API method returns a
+table object with the names of the column families.
+
+To retrieve the list of column families use
+:meth:`list_column_families() <google.cloud.bigtable.table.Table.list_column_families>`:
+
+.. code:: python
+
+    column_families = table.list_column_families()
+
+Column Family Factory
+---------------------
+
+To create a
+:class:`ColumnFamily <google.cloud.bigtable.column_family.ColumnFamily>` object:
+
+.. code:: python
+
+    column_family = table.column_family(column_family_id)
+
+There is no real reason to use this factory unless you intend to
+create or delete a column family.
+
+In addition, you can specify an optional ``gc_rule`` (a
+:class:`GarbageCollectionRule <google.cloud.bigtable.column_family.GarbageCollectionRule>`
+or similar):
+
+.. code:: python
+
+    column_family = table.column_family(column_family_id,
+                                        gc_rule=gc_rule)
+
+This rule helps the backend determine when and how to clean up old cells
+in the column family.
+
+See :doc:`column-family` for more information about
+:class:`GarbageCollectionRule <google.cloud.bigtable.column_family.GarbageCollectionRule>`
+and related classes.
+
+Create a new Column Family
+--------------------------
+
+After creating the column family object, make a `CreateColumnFamily`_ API
+request with
+:meth:`ColumnFamily.create() <google.cloud.bigtable.column_family.ColumnFamily.create>`
+
+.. code:: python
+
+    column_family.create()
+
+Delete an existing Column Family
+--------------------------------
+
+Make a `DeleteColumnFamily`_ API request with
+:meth:`ColumnFamily.delete() <google.cloud.bigtable.column_family.ColumnFamily.delete>`
+
+.. code:: python
+
+    column_family.delete()
+
+Update an existing Column Family
+--------------------------------
+
+Make an `UpdateColumnFamily`_ API request with
+:meth:`ColumnFamily.delete() <google.cloud.bigtable.column_family.ColumnFamily.update>`
+
+.. code:: python
+
+    column_family.update()
+
+Next Step
+---------
+
+Now we go down the final step of the hierarchy from
+:class:`Table <google.cloud.bigtable.table.Table>` to
+:class:`Row <google.cloud.bigtable.row.Row>` as well as streaming
+data directly via a :class:`Table <google.cloud.bigtable.table.Table>`.
+
+Head next to learn about the :doc:`data-api`.
+
+.. _ListTables: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L40-L42
+.. _CreateTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L35-L37
+.. _DeleteTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L50-L52
+.. _RenameTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L56-L58
+.. _GetTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L45-L47
+.. _CreateColumnFamily: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L61-L63
+.. _UpdateColumnFamily: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L66-L68
+.. _DeleteColumnFamily: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L71-L73
+.. _column families: https://cloud.google.com/bigtable/docs/schema-design#column_families_and_column_qualifiers
diff --git a/docs/bigtable-table.rst b/bigtable/docs/table.rst
similarity index 100%
rename from docs/bigtable-table.rst
rename to bigtable/docs/table.rst
diff --git a/bigtable/docs/usage.rst b/bigtable/docs/usage.rst
new file mode 100644
index 000000000000..aa8d899d58cb
--- /dev/null
+++ b/bigtable/docs/usage.rst
@@ -0,0 +1,28 @@
+Using the API
+=============
+
+.. toctree::
+  :maxdepth: 2
+
+  client-intro
+  client
+  cluster
+  instance
+  table
+  column-family
+  row
+  row-data
+  row-filters
+
+
+In the hierarchy of API concepts
+
+* a :class:`Client <google.cloud.bigtable.client.Client>` owns an
+  :class:`Instance <google.cloud.bigtable.instance.Instance>`
+* an :class:`Instance <google.cloud.bigtable.instance.Instance>` owns a
+  :class:`Table <google.cloud.bigtable.table.Table>`
+* a :class:`Table <google.cloud.bigtable.table.Table>` owns a
+  :class:`ColumnFamily <google.cloud.bigtable.column_family.ColumnFamily>`
+* a :class:`Table <google.cloud.bigtable.table.Table>` owns a
+  :class:`Row <google.cloud.bigtable.row.Row>`
+  (and all the cells in the row)
diff --git a/bigtable/google/__init__.py b/bigtable/google/__init__.py
new file mode 100644
index 000000000000..abc37089339e
--- /dev/null
+++ b/bigtable/google/__init__.py
@@ -0,0 +1,25 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud Bigtable API package."""
+
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigtable/google/cloud/__init__.py b/bigtable/google/cloud/__init__.py
new file mode 100644
index 000000000000..2f4b4738aee1
--- /dev/null
+++ b/bigtable/google/cloud/__init__.py
@@ -0,0 +1,8 @@
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/bigtable/google/cloud/bigtable.py b/bigtable/google/cloud/bigtable.py
new file mode 100644
index 000000000000..72858878e8a7
--- /dev/null
+++ b/bigtable/google/cloud/bigtable.py
@@ -0,0 +1,20 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.bigtable_v2 import BigtableClient
+from google.cloud.bigtable_v2 import types
+
+__all__ = ("types", "BigtableClient")
diff --git a/bigtable/google/cloud/bigtable/__init__.py b/bigtable/google/cloud/bigtable/__init__.py
new file mode 100644
index 000000000000..75b765a8a0da
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/__init__.py
@@ -0,0 +1,25 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud Bigtable API package."""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-bigtable").version
+
+from google.cloud.bigtable.client import Client
+
+
+__all__ = ["__version__", "Client"]
diff --git a/bigtable/google/cloud/bigtable/app_profile.py b/bigtable/google/cloud/bigtable/app_profile.py
new file mode 100644
index 000000000000..cb04ebfc78c7
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/app_profile.py
@@ -0,0 +1,349 @@
+# 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.
+
+"""User-friendly container for Google Cloud Bigtable AppProfile."""
+
+
+import re
+
+from google.cloud.bigtable.enums import RoutingPolicyType
+from google.cloud.bigtable_admin_v2.types import instance_pb2
+from google.protobuf import field_mask_pb2
+from google.api_core.exceptions import NotFound
+
+_APP_PROFILE_NAME_RE = re.compile(
+    r"^projects/(?P<project>[^/]+)/"
+    r"instances/(?P<instance>[^/]+)/"
+    r"appProfiles/(?P<app_profile_id>[_a-zA-Z0-9][-_.a-zA-Z0-9]*)$"
+)
+
+
+class AppProfile(object):
+    """Representation of a Google Cloud Bigtable AppProfile.
+
+    We can use a :class:`AppProfile` to:
+
+    * :meth:`reload` itself
+    * :meth:`create` itself
+    * :meth:`update` itself
+    * :meth:`delete` itself
+
+    :type app_profile_id: str
+    :param app_profile_id: The ID of the AppProfile. Must be of the form
+                           ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+
+    :type: routing_policy_type: int
+    :param: routing_policy_type: (Optional) The type of the routing policy.
+                                 Possible values are represented
+                                 by the following constants:
+                                 :data:`google.cloud.bigtable.enums.RoutingPolicyType.ANY`
+                                 :data:`google.cloud.bigtable.enums.RoutingPolicyType.SINGLE`
+
+    :type: description: str
+    :param: description: (Optional) Long form description of the use
+                         case for this AppProfile.
+
+    :type: cluster_id: str
+    :param: cluster_id: (Optional) Unique cluster_id which is only required
+                        when routing_policy_type is
+                        ROUTING_POLICY_TYPE_SINGLE.
+
+    :type: allow_transactional_writes: bool
+    :param: allow_transactional_writes: (Optional) If true, allow
+                                        transactional writes for
+                                        ROUTING_POLICY_TYPE_SINGLE.
+    """
+
+    def __init__(
+        self,
+        app_profile_id,
+        instance,
+        routing_policy_type=None,
+        description=None,
+        cluster_id=None,
+        allow_transactional_writes=None,
+    ):
+        self.app_profile_id = app_profile_id
+        self._instance = instance
+        self.routing_policy_type = routing_policy_type
+        self.description = description
+        self.cluster_id = cluster_id
+        self.allow_transactional_writes = allow_transactional_writes
+
+    @property
+    def name(self):
+        """AppProfile name used in requests.
+
+        .. note::
+
+          This property will not change if ``app_profile_id`` does not, but
+          the return value is not cached.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_app_profile_name]
+            :end-before: [END bigtable_app_profile_name]
+
+        The AppProfile name is of the form
+            ``"projects/../instances/../app_profile/{app_profile_id}"``
+
+        :rtype: str
+        :returns: The AppProfile name.
+        """
+        return self.instance_admin_client.app_profile_path(
+            self._instance._client.project,
+            self._instance.instance_id,
+            self.app_profile_id,
+        )
+
+    @property
+    def instance_admin_client(self):
+        """Shortcut to instance_admin_client
+
+        :rtype: :class:`.bigtable_admin_pb2.BigtableInstanceAdmin`
+        :returns: A BigtableInstanceAdmin instance.
+        """
+        return self._instance._client.instance_admin_client
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        # NOTE: This does not compare the configuration values, such as
+        #       the routing_policy_type. Instead, it only compares
+        #       identifying values instance, AppProfile ID and client. This is
+        #       intentional, since the same AppProfile can be in different
+        #       states if not synchronized.
+        return (
+            other.app_profile_id == self.app_profile_id
+            and other._instance == self._instance
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    @classmethod
+    def from_pb(cls, app_profile_pb, instance):
+        """Creates an instance app_profile from a protobuf.
+
+        :type app_profile_pb: :class:`instance_pb2.app_profile_pb`
+        :param app_profile_pb: An instance protobuf object.
+
+        :type instance: :class:`google.cloud.bigtable.instance.Instance`
+        :param instance: The instance that owns the cluster.
+
+        :rtype: :class:`AppProfile`
+        :returns: The AppProfile parsed from the protobuf response.
+
+        :raises: :class:`ValueError <exceptions.ValueError>` if the AppProfile
+                 name does not match
+                 ``projects/{project}/instances/{instance_id}/appProfiles/{app_profile_id}``
+                 or if the parsed instance ID does not match the istance ID
+                 on the client.
+                 or if the parsed project ID does not match the project ID
+                 on the client.
+        """
+        match_app_profile_name = _APP_PROFILE_NAME_RE.match(app_profile_pb.name)
+        if match_app_profile_name is None:
+            raise ValueError(
+                "AppProfile protobuf name was not in the " "expected format.",
+                app_profile_pb.name,
+            )
+        if match_app_profile_name.group("instance") != instance.instance_id:
+            raise ValueError(
+                "Instance ID on app_profile does not match the "
+                "instance ID on the client"
+            )
+        if match_app_profile_name.group("project") != instance._client.project:
+            raise ValueError(
+                "Project ID on app_profile does not match the "
+                "project ID on the client"
+            )
+        app_profile_id = match_app_profile_name.group("app_profile_id")
+
+        result = cls(app_profile_id, instance)
+        result._update_from_pb(app_profile_pb)
+        return result
+
+    def _update_from_pb(self, app_profile_pb):
+        """Refresh self from the server-provided protobuf.
+        Helper for :meth:`from_pb` and :meth:`reload`.
+        """
+        self.routing_policy_type = None
+        self.allow_transactional_writes = None
+        self.cluster_id = None
+
+        self.description = app_profile_pb.description
+
+        routing_policy_type = None
+        if app_profile_pb.HasField("multi_cluster_routing_use_any"):
+            routing_policy_type = RoutingPolicyType.ANY
+            self.allow_transactional_writes = False
+        else:
+            routing_policy_type = RoutingPolicyType.SINGLE
+            self.cluster_id = app_profile_pb.single_cluster_routing.cluster_id
+            self.allow_transactional_writes = (
+                app_profile_pb.single_cluster_routing.allow_transactional_writes
+            )
+        self.routing_policy_type = routing_policy_type
+
+    def _to_pb(self):
+        """Create an AppProfile proto buff message for API calls
+        :rtype: :class:`.instance_pb2.AppProfile`
+        :returns: The converted current object.
+
+        :raises: :class:`ValueError <exceptions.ValueError>` if the AppProfile
+                 routing_policy_type is not set
+        """
+        if not self.routing_policy_type:
+            raise ValueError("AppProfile required routing policy.")
+
+        single_cluster_routing = None
+        multi_cluster_routing_use_any = None
+
+        if self.routing_policy_type == RoutingPolicyType.ANY:
+            multi_cluster_routing_use_any = (
+                instance_pb2.AppProfile.MultiClusterRoutingUseAny()
+            )
+        else:
+            single_cluster_routing = instance_pb2.AppProfile.SingleClusterRouting(
+                cluster_id=self.cluster_id,
+                allow_transactional_writes=self.allow_transactional_writes,
+            )
+
+        app_profile_pb = instance_pb2.AppProfile(
+            name=self.name,
+            description=self.description,
+            multi_cluster_routing_use_any=multi_cluster_routing_use_any,
+            single_cluster_routing=single_cluster_routing,
+        )
+        return app_profile_pb
+
+    def reload(self):
+        """Reload the metadata for this cluster
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_reload_app_profile]
+            :end-before: [END bigtable_reload_app_profile]
+        """
+
+        app_profile_pb = self.instance_admin_client.get_app_profile(self.name)
+
+        # NOTE: _update_from_pb does not check that the project and
+        #       app_profile ID on the response match the request.
+        self._update_from_pb(app_profile_pb)
+
+    def exists(self):
+        """Check whether the AppProfile already exists.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_app_profile_exists]
+            :end-before: [END bigtable_app_profile_exists]
+
+        :rtype: bool
+        :returns: True if the AppProfile exists, else False.
+        """
+        try:
+            self.instance_admin_client.get_app_profile(self.name)
+            return True
+        # NOTE: There could be other exceptions that are returned to the user.
+        except NotFound:
+            return False
+
+    def create(self, ignore_warnings=None):
+        """Create this AppProfile.
+
+        .. note::
+
+            Uses the ``instance`` and ``app_profile_id`` on the current
+            :class:`AppProfile` in addition to the ``routing_policy_type``,
+            ``description``, ``cluster_id`` and ``allow_transactional_writes``.
+            To change them before creating, reset the values via
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_app_profile]
+            :end-before: [END bigtable_create_app_profile]
+
+        :type: ignore_warnings: bool
+        :param: ignore_warnings: (Optional) If true, ignore safety checks when
+                                 creating the AppProfile.
+        """
+        return self.from_pb(
+            self.instance_admin_client.create_app_profile(
+                parent=self._instance.name,
+                app_profile_id=self.app_profile_id,
+                app_profile=self._to_pb(),
+                ignore_warnings=ignore_warnings,
+            ),
+            self._instance,
+        )
+
+    def update(self, ignore_warnings=None):
+        """Update this app_profile.
+
+        .. note::
+
+            Update any or all of the following values:
+            ``routing_policy_type``
+            ``description``
+            ``cluster_id``
+            ``allow_transactional_writes``
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_update_app_profile]
+            :end-before: [END bigtable_update_app_profile]
+        """
+        update_mask_pb = field_mask_pb2.FieldMask()
+
+        if self.description is not None:
+            update_mask_pb.paths.append("description")
+
+        if self.routing_policy_type == RoutingPolicyType.ANY:
+            update_mask_pb.paths.append("multi_cluster_routing_use_any")
+        else:
+            update_mask_pb.paths.append("single_cluster_routing")
+
+        return self.instance_admin_client.update_app_profile(
+            app_profile=self._to_pb(),
+            update_mask=update_mask_pb,
+            ignore_warnings=ignore_warnings,
+        )
+
+    def delete(self, ignore_warnings=None):
+        """Delete this AppProfile.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_delete_app_profile]
+            :end-before: [END bigtable_delete_app_profile]
+
+        :type: ignore_warnings: bool
+        :param: ignore_warnings: If true, ignore safety checks when deleting
+                the AppProfile.
+
+        :raises: google.api_core.exceptions.GoogleAPICallError: If the request
+                 failed for any reason. google.api_core.exceptions.RetryError:
+                 If the request failed due to a retryable error and retry
+                 attempts failed. ValueError: If the parameters are invalid.
+        """
+        self.instance_admin_client.delete_app_profile(self.name, ignore_warnings)
diff --git a/bigtable/google/cloud/bigtable/batcher.py b/bigtable/google/cloud/bigtable/batcher.py
new file mode 100644
index 000000000000..3a649049b66d
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/batcher.py
@@ -0,0 +1,143 @@
+# 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.
+
+"""User friendly container for Google Cloud Bigtable MutationBatcher."""
+
+
+FLUSH_COUNT = 1000
+MAX_MUTATIONS = 100000
+MAX_ROW_BYTES = 5242880  # 5MB
+
+
+class MaxMutationsError(ValueError):
+    """The number of mutations for bulk request is too big."""
+
+
+class MutationsBatcher(object):
+    """ A MutationsBatcher is used in batch cases where the number of mutations
+    is large or unknown. It will store DirectRows in memory until one of the
+    size limits is reached, or an explicit call to flush() is performed. When
+    a flush event occurs, the DirectRows in memory will be sent to Cloud
+    Bigtable. Batching mutations is more efficient than sending individual
+    request.
+
+    This class is not suited for usage in systems where each mutation
+    needs to guaranteed to be sent, since calling mutate may only result in an
+    in-memory change. In a case of a system crash, any DirectRows remaining in
+    memory will not necessarily be sent to the service, even after the
+    completion of the mutate() method.
+
+    TODO: Performance would dramatically improve if this class had the
+    capability of asynchronous, parallel RPCs.
+
+    :type table: class
+    :param table: class:`~google.cloud.bigtable.table.Table`.
+
+    :type flush_count: int
+    :param flush_count: (Optional) Max number of rows to flush. If it
+    reaches the max number of rows it calls finish_batch() to mutate the
+    current row batch. Default is FLUSH_COUNT (1000 rows).
+
+    :type max_row_bytes: int
+    :param max_row_bytes: (Optional) Max number of row mutations size to
+    flush. If it reaches the max number of row mutations size it calls
+    finish_batch() to mutate the current row batch. Default is MAX_ROW_BYTES
+    (5 MB).
+    """
+
+    def __init__(self, table, flush_count=FLUSH_COUNT, max_row_bytes=MAX_ROW_BYTES):
+        self.rows = []
+        self.total_mutation_count = 0
+        self.total_size = 0
+        self.table = table
+        self.flush_count = flush_count
+        self.max_row_bytes = max_row_bytes
+
+    def mutate(self, row):
+        """ Add a row to the batch. If the current batch meets one of the size
+        limits, the batch is sent synchronously.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_batcher_mutate]
+            :end-before: [END bigtable_batcher_mutate]
+
+        :type row: class
+        :param row: class:`~google.cloud.bigtable.row.DirectRow`.
+
+        :raises: One of the following:
+                 * :exc:`~.table._BigtableRetryableError` if any
+                   row returned a transient error.
+                 * :exc:`RuntimeError` if the number of responses doesn't
+                   match the number of rows that were retried
+                 * :exc:`.batcher.MaxMutationsError` if any row exceeds max
+                   mutations count.
+        """
+        mutation_count = len(row._get_mutations())
+        if mutation_count > MAX_MUTATIONS:
+            raise MaxMutationsError(
+                "The row key {} exceeds the number of mutations {}.".format(
+                    row.row_key, mutation_count
+                )
+            )
+
+        if (self.total_mutation_count + mutation_count) >= MAX_MUTATIONS:
+            self.flush()
+
+        self.rows.append(row)
+        self.total_mutation_count += mutation_count
+        self.total_size += row.get_mutations_size()
+
+        if self.total_size >= self.max_row_bytes or len(self.rows) >= self.flush_count:
+            self.flush()
+
+    def mutate_rows(self, rows):
+        """ Add a row to the batch. If the current batch meets one of the size
+        limits, the batch is sent synchronously.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_batcher_mutate_rows]
+            :end-before: [END bigtable_batcher_mutate_rows]
+
+        :type rows: list:[`~google.cloud.bigtable.row.DirectRow`]
+        :param rows: list:[`~google.cloud.bigtable.row.DirectRow`].
+
+        :raises: One of the following:
+                 * :exc:`~.table._BigtableRetryableError` if any
+                   row returned a transient error.
+                 * :exc:`RuntimeError` if the number of responses doesn't
+                   match the number of rows that were retried
+                 * :exc:`.batcher.MaxMutationsError` if any row exceeds max
+                   mutations count.
+        """
+        for row in rows:
+            self.mutate(row)
+
+    def flush(self):
+        """ Sends the current. batch to Cloud Bigtable.
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_batcher_flush]
+            :end-before: [END bigtable_batcher_flush]
+
+        """
+        if len(self.rows) != 0:
+            self.table.mutate_rows(self.rows)
+            self.total_mutation_count = 0
+            self.total_size = 0
+            self.rows = []
diff --git a/bigtable/google/cloud/bigtable/client.py b/bigtable/google/cloud/bigtable/client.py
new file mode 100644
index 000000000000..f9a625b15843
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/client.py
@@ -0,0 +1,365 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Parent client for calling the Google Cloud Bigtable API.
+
+This is the base from which all interactions with the API occur.
+
+In the hierarchy of API concepts
+
+* a :class:`~google.cloud.bigtable.client.Client` owns an
+  :class:`~google.cloud.bigtable.instance.Instance`
+* an :class:`~google.cloud.bigtable.instance.Instance` owns a
+  :class:`~google.cloud.bigtable.table.Table`
+* a :class:`~google.cloud.bigtable.table.Table` owns a
+  :class:`~.column_family.ColumnFamily`
+* a :class:`~google.cloud.bigtable.table.Table` owns a
+  :class:`~google.cloud.bigtable.row.Row` (and all the cells in the row)
+"""
+import os
+import warnings
+import grpc
+
+from google.api_core.gapic_v1 import client_info
+
+from google.cloud import bigtable_v2
+from google.cloud import bigtable_admin_v2
+
+from google.cloud.bigtable import __version__
+from google.cloud.bigtable.instance import Instance
+from google.cloud.bigtable.cluster import Cluster
+
+from google.cloud.client import ClientWithProject
+
+from google.cloud.bigtable_admin_v2 import enums
+from google.cloud.bigtable.cluster import _CLUSTER_NAME_RE
+from google.cloud.environment_vars import BIGTABLE_EMULATOR
+
+
+INSTANCE_TYPE_PRODUCTION = enums.Instance.Type.PRODUCTION
+INSTANCE_TYPE_DEVELOPMENT = enums.Instance.Type.DEVELOPMENT
+INSTANCE_TYPE_UNSPECIFIED = enums.Instance.Type.TYPE_UNSPECIFIED
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+SPANNER_ADMIN_SCOPE = "https://www.googleapis.com/auth/spanner.admin"
+ADMIN_SCOPE = "https://www.googleapis.com/auth/bigtable.admin"
+"""Scope for interacting with the Cluster Admin and Table Admin APIs."""
+DATA_SCOPE = "https://www.googleapis.com/auth/bigtable.data"
+"""Scope for reading and writing table data."""
+READ_ONLY_SCOPE = "https://www.googleapis.com/auth/bigtable.data.readonly"
+"""Scope for reading table data."""
+
+
+def _create_gapic_client(client_class):
+    def inner(self):
+        if self._emulator_host is None:
+            return client_class(
+                credentials=self._credentials, client_info=self._client_info
+            )
+        else:
+            return client_class(
+                channel=self._emulator_channel, client_info=self._client_info
+            )
+
+    return inner
+
+
+class Client(ClientWithProject):
+    """Client for interacting with Google Cloud Bigtable API.
+
+    .. note::
+
+        Since the Cloud Bigtable API requires the gRPC transport, no
+        ``_http`` argument is accepted by this class.
+
+    :type project: :class:`str` or :func:`unicode <unicode>`
+    :param project: (Optional) The ID of the project which owns the
+                    instances, tables and data. If not provided, will
+                    attempt to determine from the environment.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed, falls back to the default
+                        inferred from the environment.
+
+    :type read_only: bool
+    :param read_only: (Optional) Boolean indicating if the data scope should be
+                      for reading only (or for writing as well). Defaults to
+                      :data:`False`.
+
+    :type admin: bool
+    :param admin: (Optional) Boolean indicating if the client will be used to
+                  interact with the Instance Admin or Table Admin APIs. This
+                  requires the :const:`ADMIN_SCOPE`. Defaults to :data:`False`.
+
+    :type: client_info: :class:`google.api_core.gapic_v1.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+
+    :type channel: :instance: grpc.Channel
+    :param channel (grpc.Channel): (Optional) DEPRECATED:
+            A ``Channel`` instance through which to make calls.
+            This argument is mutually exclusive with ``credentials``;
+            providing both will raise an exception. No longer used.
+
+    :raises: :class:`ValueError <exceptions.ValueError>` if both ``read_only``
+             and ``admin`` are :data:`True`
+    """
+
+    _table_data_client = None
+    _table_admin_client = None
+    _instance_admin_client = None
+
+    def __init__(
+        self,
+        project=None,
+        credentials=None,
+        read_only=False,
+        admin=False,
+        client_info=_CLIENT_INFO,
+        channel=None,
+    ):
+        if read_only and admin:
+            raise ValueError(
+                "A read-only client cannot also perform" "administrative actions."
+            )
+
+        # NOTE: We set the scopes **before** calling the parent constructor.
+        #       It **may** use those scopes in ``with_scopes_if_required``.
+        self._read_only = bool(read_only)
+        self._admin = bool(admin)
+        self._client_info = client_info
+        self._emulator_host = os.getenv(BIGTABLE_EMULATOR)
+        self._emulator_channel = None
+
+        if self._emulator_host is not None:
+            self._emulator_channel = grpc.insecure_channel(self._emulator_host)
+
+        if channel is not None:
+            warnings.warn(
+                "'channel' is deprecated and no longer used.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        self._channel = channel
+        self.SCOPE = self._get_scopes()
+        super(Client, self).__init__(project=project, credentials=credentials)
+
+    def _get_scopes(self):
+        """Get the scopes corresponding to admin / read-only state.
+
+        Returns:
+            Tuple[str, ...]: The tuple of scopes.
+        """
+        if self._read_only:
+            scopes = (READ_ONLY_SCOPE,)
+        else:
+            scopes = (DATA_SCOPE,)
+
+        if self._admin:
+            scopes += (ADMIN_SCOPE,)
+
+        return scopes
+
+    @property
+    def project_path(self):
+        """Project name to be used with Instance Admin API.
+
+        .. note::
+
+            This property will not change if ``project`` does not, but the
+            return value is not cached.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_project_path]
+            :end-before: [END bigtable_project_path]
+
+        The project name is of the form
+
+            ``"projects/{project}"``
+
+        :rtype: str
+        :returns: Return a fully-qualified project string.
+        """
+        return self.instance_admin_client.project_path(self.project)
+
+    @property
+    def table_data_client(self):
+        """Getter for the gRPC stub used for the Table Admin API.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_table_data_client]
+            :end-before: [END bigtable_table_data_client]
+
+        :rtype: :class:`.bigtable_v2.BigtableClient`
+        :returns: A BigtableClient object.
+        """
+        if self._table_data_client is None:
+            self._table_data_client = _create_gapic_client(bigtable_v2.BigtableClient)(
+                self
+            )
+        return self._table_data_client
+
+    @property
+    def table_admin_client(self):
+        """Getter for the gRPC stub used for the Table Admin API.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_table_admin_client]
+            :end-before: [END bigtable_table_admin_client]
+
+        :rtype: :class:`.bigtable_admin_pb2.BigtableTableAdmin`
+        :returns: A BigtableTableAdmin instance.
+        :raises: :class:`ValueError <exceptions.ValueError>` if the current
+                 client is not an admin client or if it has not been
+                 :meth:`start`-ed.
+        """
+        if self._table_admin_client is None:
+            if not self._admin:
+                raise ValueError("Client is not an admin client.")
+            self._table_admin_client = _create_gapic_client(
+                bigtable_admin_v2.BigtableTableAdminClient
+            )(self)
+        return self._table_admin_client
+
+    @property
+    def instance_admin_client(self):
+        """Getter for the gRPC stub used for the Table Admin API.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_instance_admin_client]
+            :end-before: [END bigtable_instance_admin_client]
+
+        :rtype: :class:`.bigtable_admin_pb2.BigtableInstanceAdmin`
+        :returns: A BigtableInstanceAdmin instance.
+        :raises: :class:`ValueError <exceptions.ValueError>` if the current
+                 client is not an admin client or if it has not been
+                 :meth:`start`-ed.
+        """
+        if self._instance_admin_client is None:
+            if not self._admin:
+                raise ValueError("Client is not an admin client.")
+            self._instance_admin_client = _create_gapic_client(
+                bigtable_admin_v2.BigtableInstanceAdminClient
+            )(self)
+        return self._instance_admin_client
+
+    def instance(self, instance_id, display_name=None, instance_type=None, labels=None):
+        """Factory to create a instance associated with this client.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_prod_instance]
+            :end-before: [END bigtable_create_prod_instance]
+
+        :type instance_id: str
+        :param instance_id: The ID of the instance.
+
+        :type display_name: str
+        :param display_name: (Optional) The display name for the instance in
+                             the Cloud Console UI. (Must be between 4 and 30
+                             characters.) If this value is not set in the
+                             constructor, will fall back to the instance ID.
+
+        :type instance_type: int
+        :param instance_type: (Optional) The type of the instance.
+                               Possible values are represented
+                               by the following constants:
+                               :data:`google.cloud.bigtable.enums.InstanceType.PRODUCTION`.
+                               :data:`google.cloud.bigtable.enums.InstanceType.DEVELOPMENT`,
+                               Defaults to
+                               :data:`google.cloud.bigtable.enums.InstanceType.UNSPECIFIED`.
+
+        :type labels: dict
+        :param labels: (Optional) Labels are a flexible and lightweight
+                       mechanism for organizing cloud resources into groups
+                       that reflect a customer's organizational needs and
+                       deployment strategies. They can be used to filter
+                       resources and aggregate metrics. Label keys must be
+                       between 1 and 63 characters long. Maximum 64 labels can
+                       be associated with a given resource. Label values must
+                       be between 0 and 63 characters long. Keys and values
+                       must both be under 128 bytes.
+
+        :rtype: :class:`~google.cloud.bigtable.instance.Instance`
+        :returns: an instance owned by this client.
+        """
+        return Instance(
+            instance_id,
+            self,
+            display_name=display_name,
+            instance_type=instance_type,
+            labels=labels,
+        )
+
+    def list_instances(self):
+        """List instances owned by the project.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_list_instances]
+            :end-before: [END bigtable_list_instances]
+
+        :rtype: tuple
+        :returns:
+            (instances, failed_locations), where 'instances' is list of
+            :class:`google.cloud.bigtable.instance.Instance`, and
+            'failed_locations' is a list of locations which could not
+            be resolved.
+        """
+        resp = self.instance_admin_client.list_instances(self.project_path)
+        instances = [Instance.from_pb(instance, self) for instance in resp.instances]
+        return instances, resp.failed_locations
+
+    def list_clusters(self):
+        """List the clusters in the project.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_list_clusters_in_project]
+            :end-before: [END bigtable_list_clusters_in_project]
+
+        :rtype: tuple
+        :returns:
+            (clusters, failed_locations), where 'clusters' is list of
+            :class:`google.cloud.bigtable.instance.Cluster`, and
+            'failed_locations' is a list of strings representing
+            locations which could not be resolved.
+        """
+        resp = self.instance_admin_client.list_clusters(
+            self.instance_admin_client.instance_path(self.project, "-")
+        )
+        clusters = []
+        instances = {}
+        for cluster in resp.clusters:
+            match_cluster_name = _CLUSTER_NAME_RE.match(cluster.name)
+            instance_id = match_cluster_name.group("instance")
+            if instance_id not in instances:
+                instances[instance_id] = self.instance(instance_id)
+            clusters.append(Cluster.from_pb(cluster, instances[instance_id]))
+        return clusters, resp.failed_locations
diff --git a/bigtable/google/cloud/bigtable/cluster.py b/bigtable/google/cloud/bigtable/cluster.py
new file mode 100644
index 000000000000..5ff1d0404b94
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/cluster.py
@@ -0,0 +1,353 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""User friendly container for Google Cloud Bigtable Cluster."""
+
+
+import re
+from google.cloud.bigtable_admin_v2.types import instance_pb2
+from google.api_core.exceptions import NotFound
+
+
+_CLUSTER_NAME_RE = re.compile(
+    r"^projects/(?P<project>[^/]+)/"
+    r"instances/(?P<instance>[^/]+)/clusters/"
+    r"(?P<cluster_id>[a-z][-a-z0-9]*)$"
+)
+
+
+class Cluster(object):
+    """Representation of a Google Cloud Bigtable Cluster.
+
+    We can use a :class:`Cluster` to:
+
+    * :meth:`reload` itself
+    * :meth:`create` itself
+    * :meth:`update` itself
+    * :meth:`delete` itself
+
+    :type cluster_id: str
+    :param cluster_id: The ID of the cluster.
+
+    :type instance: :class:`~google.cloud.bigtable.instance.Instance`
+    :param instance: The instance where the cluster resides.
+
+    :type location_id: str
+    :param location_id: (Creation Only) The location where this cluster's
+                        nodes and storage reside . For best performance,
+                        clients should be located as close as possible to
+                        this cluster.
+                        For list of supported locations refer to
+                        https://cloud.google.com/bigtable/docs/locations
+
+    :type serve_nodes: int
+    :param serve_nodes: (Optional) The number of nodes in the cluster.
+
+    :type default_storage_type: int
+    :param default_storage_type: (Optional) The type of storage
+                                 Possible values are represented by the
+                                 following constants:
+                                 :data:`google.cloud.bigtable.enums.StorageType.SSD`.
+                                 :data:`google.cloud.bigtable.enums.StorageType.SHD`,
+                                 Defaults to
+                                 :data:`google.cloud.bigtable.enums.StorageType.UNSPECIFIED`.
+
+    :type _state: int
+    :param _state: (`OutputOnly`)
+                   The current state of the cluster.
+                   Possible values are represented by the following constants:
+                   :data:`google.cloud.bigtable.enums.Cluster.State.NOT_KNOWN`.
+                   :data:`google.cloud.bigtable.enums.Cluster.State.READY`.
+                   :data:`google.cloud.bigtable.enums.Cluster.State.CREATING`.
+                   :data:`google.cloud.bigtable.enums.Cluster.State.RESIZING`.
+                   :data:`google.cloud.bigtable.enums.Cluster.State.DISABLED`.
+    """
+
+    def __init__(
+        self,
+        cluster_id,
+        instance,
+        location_id=None,
+        serve_nodes=None,
+        default_storage_type=None,
+        _state=None,
+    ):
+        self.cluster_id = cluster_id
+        self._instance = instance
+        self.location_id = location_id
+        self.serve_nodes = serve_nodes
+        self.default_storage_type = default_storage_type
+        self._state = _state
+
+    @classmethod
+    def from_pb(cls, cluster_pb, instance):
+        """Creates an cluster instance from a protobuf.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_cluster_from_pb]
+            :end-before: [END bigtable_cluster_from_pb]
+
+        :type cluster_pb: :class:`instance_pb2.Cluster`
+        :param cluster_pb: An instance protobuf object.
+
+        :type instance: :class:`google.cloud.bigtable.instance.Instance`
+        :param instance: The instance that owns the cluster.
+
+        :rtype: :class:`Cluster`
+        :returns: The Cluster parsed from the protobuf response.
+        :raises: :class:`ValueError <exceptions.ValueError>` if the cluster
+                 name does not match
+                 ``projects/{project}/instances/{instance_id}/clusters/{cluster_id}``
+                 or if the parsed instance ID does not match the istance ID
+                 on the client.
+                 or if the parsed project ID does not match the project ID
+                 on the client.
+        """
+        match_cluster_name = _CLUSTER_NAME_RE.match(cluster_pb.name)
+        if match_cluster_name is None:
+            raise ValueError(
+                "Cluster protobuf name was not in the " "expected format.",
+                cluster_pb.name,
+            )
+        if match_cluster_name.group("instance") != instance.instance_id:
+            raise ValueError(
+                "Instance ID on cluster does not match the " "instance ID on the client"
+            )
+        if match_cluster_name.group("project") != instance._client.project:
+            raise ValueError(
+                "Project ID on cluster does not match the " "project ID on the client"
+            )
+        cluster_id = match_cluster_name.group("cluster_id")
+
+        result = cls(cluster_id, instance)
+        result._update_from_pb(cluster_pb)
+        return result
+
+    def _update_from_pb(self, cluster_pb):
+        """Refresh self from the server-provided protobuf.
+        Helper for :meth:`from_pb` and :meth:`reload`.
+        """
+
+        self.location_id = cluster_pb.location.split("/")[-1]
+        self.serve_nodes = cluster_pb.serve_nodes
+        self.default_storage_type = cluster_pb.default_storage_type
+        self._state = cluster_pb.state
+
+    @property
+    def name(self):
+        """Cluster name used in requests.
+
+        .. note::
+          This property will not change if ``_instance`` and ``cluster_id``
+          do not, but the return value is not cached.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_cluster_name]
+            :end-before: [END bigtable_cluster_name]
+
+        The cluster name is of the form
+
+            ``"projects/{project}/instances/{instance}/clusters/{cluster_id}"``
+
+        :rtype: str
+        :returns: The cluster name.
+        """
+        return self._instance._client.instance_admin_client.cluster_path(
+            self._instance._client.project, self._instance.instance_id, self.cluster_id
+        )
+
+    @property
+    def state(self):
+        """google.cloud.bigtable.enums.Cluster.State: state of cluster.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_cluster_state]
+            :end-before: [END bigtable_cluster_state]
+
+        """
+        return self._state
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        # NOTE: This does not compare the configuration values, such as
+        #       the serve_nodes. Instead, it only compares
+        #       identifying values instance, cluster ID and client. This is
+        #       intentional, since the same cluster can be in different states
+        #       if not synchronized. Clusters with similar instance/cluster
+        #       settings but different clients can't be used in the same way.
+        return other.cluster_id == self.cluster_id and other._instance == self._instance
+
+    def __ne__(self, other):
+        return not self == other
+
+    def reload(self):
+        """Reload the metadata for this cluster.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_reload_cluster]
+            :end-before: [END bigtable_reload_cluster]
+        """
+        cluster_pb = self._instance._client.instance_admin_client.get_cluster(self.name)
+
+        # NOTE: _update_from_pb does not check that the project and
+        #       cluster ID on the response match the request.
+        self._update_from_pb(cluster_pb)
+
+    def exists(self):
+        """Check whether the cluster already exists.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_check_cluster_exists]
+            :end-before: [END bigtable_check_cluster_exists]
+
+        :rtype: bool
+        :returns: True if the table exists, else False.
+        """
+        client = self._instance._client
+        try:
+            client.instance_admin_client.get_cluster(name=self.name)
+            return True
+        # NOTE: There could be other exceptions that are returned to the user.
+        except NotFound:
+            return False
+
+    def create(self):
+        """Create this cluster.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_cluster]
+            :end-before: [END bigtable_create_cluster]
+
+        .. note::
+
+            Uses the ``project``, ``instance`` and ``cluster_id`` on the
+            current :class:`Cluster` in addition to the ``serve_nodes``.
+            To change them before creating, reset the values via
+
+            .. code:: python
+
+                cluster.serve_nodes = 8
+                cluster.cluster_id = 'i-changed-my-mind'
+
+            before calling :meth:`create`.
+
+        :rtype: :class:`~google.api_core.operation.Operation`
+        :returns: The long-running operation corresponding to the
+                  create operation.
+        """
+        client = self._instance._client
+        cluster_pb = self._to_pb()
+
+        return client.instance_admin_client.create_cluster(
+            self._instance.name, self.cluster_id, cluster_pb
+        )
+
+    def update(self):
+        """Update this cluster.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_update_cluster]
+            :end-before: [END bigtable_update_cluster]
+
+        .. note::
+
+            Updates the ``serve_nodes``. If you'd like to
+            change them before updating, reset the values via
+
+            .. code:: python
+
+                cluster.serve_nodes = 8
+
+            before calling :meth:`update`.
+
+        :type location: :str:``CreationOnly``
+        :param location: 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/<project>/locations/<zone>``.
+
+        :type serve_nodes: :int
+        :param serve_nodes: The number of nodes allocated to this cluster.
+                More nodes enable higher throughput and more consistent
+                performance.
+
+        :rtype: :class:`Operation`
+        :returns: The long-running operation corresponding to the
+                  update operation.
+        """
+        client = self._instance._client
+        # We are passing `None` for second argument location.
+        # Location is set only at the time of creation of a cluster
+        # and can not be changed after cluster has been created.
+        return client.instance_admin_client.update_cluster(
+            self.name, self.serve_nodes, None
+        )
+
+    def delete(self):
+        """Delete this cluster.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_delete_cluster]
+            :end-before: [END bigtable_delete_cluster]
+
+        Marks a cluster and all of its tables for permanent deletion in 7 days.
+
+        Immediately upon completion of the request:
+
+        * Billing will cease for all of the cluster's reserved resources.
+        * The cluster's ``delete_time`` field will be set 7 days in the future.
+
+        Soon afterward:
+
+        * All tables within the cluster will become unavailable.
+
+        At the cluster's ``delete_time``:
+
+        * The cluster and **all of its tables** will immediately and
+          irrevocably disappear from the API, and their data will be
+          permanently deleted.
+        """
+        client = self._instance._client
+        client.instance_admin_client.delete_cluster(self.name)
+
+    def _to_pb(self):
+        """ Create cluster proto buff message for API calls """
+        client = self._instance._client
+        location = client.instance_admin_client.location_path(
+            client.project, self.location_id
+        )
+        cluster_pb = instance_pb2.Cluster(
+            location=location,
+            serve_nodes=self.serve_nodes,
+            default_storage_type=self.default_storage_type,
+        )
+        return cluster_pb
diff --git a/bigtable/google/cloud/bigtable/column_family.py b/bigtable/google/cloud/bigtable/column_family.py
new file mode 100644
index 000000000000..8b536992faa7
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/column_family.py
@@ -0,0 +1,351 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""User friendly container for Google Cloud Bigtable Column Family."""
+
+
+from google.cloud import _helpers
+from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+from google.cloud.bigtable_admin_v2.proto import (
+    bigtable_table_admin_pb2 as table_admin_v2_pb2,
+)
+
+
+class GarbageCollectionRule(object):
+    """Garbage collection rule for column families within a table.
+
+    Cells in the column family (within a table) fitting the rule will be
+    deleted during garbage collection.
+
+    .. note::
+
+        This class is a do-nothing base class for all GC rules.
+
+    .. note::
+
+        A string ``gc_expression`` can also be used with API requests, but
+        that value would be superceded by a ``gc_rule``. As a result, we
+        don't support that feature and instead support via native classes.
+    """
+
+
+class MaxVersionsGCRule(GarbageCollectionRule):
+    """Garbage collection limiting the number of versions of a cell.
+
+    For example:
+
+    .. literalinclude:: snippets_table.py
+        :start-after: [START bigtable_create_family_gc_max_versions]
+        :end-before: [END bigtable_create_family_gc_max_versions]
+
+    :type max_num_versions: int
+    :param max_num_versions: The maximum number of versions
+    """
+
+    def __init__(self, max_num_versions):
+        self.max_num_versions = max_num_versions
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return other.max_num_versions == self.max_num_versions
+
+    def __ne__(self, other):
+        return not self == other
+
+    def to_pb(self):
+        """Converts the garbage collection rule to a protobuf.
+
+        :rtype: :class:`.table_v2_pb2.GcRule`
+        :returns: The converted current object.
+        """
+        return table_v2_pb2.GcRule(max_num_versions=self.max_num_versions)
+
+
+class MaxAgeGCRule(GarbageCollectionRule):
+    """Garbage collection limiting the age of a cell.
+
+    For example:
+
+    .. literalinclude:: snippets_table.py
+        :start-after: [START bigtable_create_family_gc_max_age]
+        :end-before: [END bigtable_create_family_gc_max_age]
+
+    :type max_age: :class:`datetime.timedelta`
+    :param max_age: The maximum age allowed for a cell in the table.
+    """
+
+    def __init__(self, max_age):
+        self.max_age = max_age
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return other.max_age == self.max_age
+
+    def __ne__(self, other):
+        return not self == other
+
+    def to_pb(self):
+        """Converts the garbage collection rule to a protobuf.
+
+        :rtype: :class:`.table_v2_pb2.GcRule`
+        :returns: The converted current object.
+        """
+        max_age = _helpers._timedelta_to_duration_pb(self.max_age)
+        return table_v2_pb2.GcRule(max_age=max_age)
+
+
+class GCRuleUnion(GarbageCollectionRule):
+    """Union of garbage collection rules.
+
+    For example:
+
+    .. literalinclude:: snippets_table.py
+        :start-after: [START bigtable_create_family_gc_union]
+        :end-before: [END bigtable_create_family_gc_union]
+
+    :type rules: list
+    :param rules: List of :class:`GarbageCollectionRule`.
+    """
+
+    def __init__(self, rules):
+        self.rules = rules
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return other.rules == self.rules
+
+    def __ne__(self, other):
+        return not self == other
+
+    def to_pb(self):
+        """Converts the union into a single GC rule as a protobuf.
+
+        :rtype: :class:`.table_v2_pb2.GcRule`
+        :returns: The converted current object.
+        """
+        union = table_v2_pb2.GcRule.Union(rules=[rule.to_pb() for rule in self.rules])
+        return table_v2_pb2.GcRule(union=union)
+
+
+class GCRuleIntersection(GarbageCollectionRule):
+    """Intersection of garbage collection rules.
+
+    For example:
+
+    .. literalinclude:: snippets_table.py
+        :start-after: [START bigtable_create_family_gc_intersection]
+        :end-before: [END bigtable_create_family_gc_intersection]
+
+    :type rules: list
+    :param rules: List of :class:`GarbageCollectionRule`.
+    """
+
+    def __init__(self, rules):
+        self.rules = rules
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return other.rules == self.rules
+
+    def __ne__(self, other):
+        return not self == other
+
+    def to_pb(self):
+        """Converts the intersection into a single GC rule as a protobuf.
+
+        :rtype: :class:`.table_v2_pb2.GcRule`
+        :returns: The converted current object.
+        """
+        intersection = table_v2_pb2.GcRule.Intersection(
+            rules=[rule.to_pb() for rule in self.rules]
+        )
+        return table_v2_pb2.GcRule(intersection=intersection)
+
+
+class ColumnFamily(object):
+    """Representation of a Google Cloud Bigtable Column Family.
+
+    We can use a :class:`ColumnFamily` to:
+
+    * :meth:`create` itself
+    * :meth:`update` itself
+    * :meth:`delete` itself
+
+    :type column_family_id: str
+    :param column_family_id: The ID of the column family. Must be of the
+                             form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+
+    :type table: :class:`Table <google.cloud.bigtable.table.Table>`
+    :param table: The table that owns the column family.
+
+    :type gc_rule: :class:`GarbageCollectionRule`
+    :param gc_rule: (Optional) The garbage collection settings for this
+                    column family.
+    """
+
+    def __init__(self, column_family_id, table, gc_rule=None):
+        self.column_family_id = column_family_id
+        self._table = table
+        self.gc_rule = gc_rule
+
+    @property
+    def name(self):
+        """Column family name used in requests.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_column_family_name]
+            :end-before: [END bigtable_column_family_name]
+
+        .. note::
+
+          This property will not change if ``column_family_id`` does not, but
+          the return value is not cached.
+
+        The Column family name is of the form
+
+            ``"projects/../zones/../clusters/../tables/../columnFamilies/.."``
+
+        :rtype: str
+        :returns: The column family name.
+        """
+        return self._table.name + "/columnFamilies/" + self.column_family_id
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (
+            other.column_family_id == self.column_family_id
+            and other._table == self._table
+            and other.gc_rule == self.gc_rule
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    def to_pb(self):
+        """Converts the column family to a protobuf.
+
+        :rtype: :class:`.table_v2_pb2.ColumnFamily`
+        :returns: The converted current object.
+        """
+        if self.gc_rule is None:
+            return table_v2_pb2.ColumnFamily()
+        else:
+            return table_v2_pb2.ColumnFamily(gc_rule=self.gc_rule.to_pb())
+
+    def create(self):
+        """Create this column family.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_create_column_family]
+            :end-before: [END bigtable_create_column_family]
+
+        """
+        column_family = self.to_pb()
+        modification = table_admin_v2_pb2.ModifyColumnFamiliesRequest.Modification(
+            id=self.column_family_id, create=column_family
+        )
+
+        client = self._table._instance._client
+        # data it contains are the GC rule and the column family ID already
+        # stored on this instance.
+        client.table_admin_client.modify_column_families(
+            self._table.name, [modification]
+        )
+
+    def update(self):
+        """Update this column family.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_update_column_family]
+            :end-before: [END bigtable_update_column_family]
+
+        .. note::
+
+            Only the GC rule can be updated. By changing the column family ID,
+            you will simply be referring to a different column family.
+        """
+        column_family = self.to_pb()
+        modification = table_admin_v2_pb2.ModifyColumnFamiliesRequest.Modification(
+            id=self.column_family_id, update=column_family
+        )
+
+        client = self._table._instance._client
+        # data it contains are the GC rule and the column family ID already
+        # stored on this instance.
+        client.table_admin_client.modify_column_families(
+            self._table.name, [modification]
+        )
+
+    def delete(self):
+        """Delete this column family.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_delete_column_family]
+            :end-before: [END bigtable_delete_column_family]
+
+        """
+        modification = table_admin_v2_pb2.ModifyColumnFamiliesRequest.Modification(
+            id=self.column_family_id, drop=True
+        )
+
+        client = self._table._instance._client
+        # data it contains are the GC rule and the column family ID already
+        # stored on this instance.
+        client.table_admin_client.modify_column_families(
+            self._table.name, [modification]
+        )
+
+
+def _gc_rule_from_pb(gc_rule_pb):
+    """Convert a protobuf GC rule to a native object.
+
+    :type gc_rule_pb: :class:`.table_v2_pb2.GcRule`
+    :param gc_rule_pb: The GC rule to convert.
+
+    :rtype: :class:`GarbageCollectionRule` or :data:`NoneType <types.NoneType>`
+    :returns: An instance of one of the native rules defined
+              in :module:`column_family` or :data:`None` if no values were
+              set on the protobuf passed in.
+    :raises: :class:`ValueError <exceptions.ValueError>` if the rule name
+             is unexpected.
+    """
+    rule_name = gc_rule_pb.WhichOneof("rule")
+    if rule_name is None:
+        return None
+
+    if rule_name == "max_num_versions":
+        return MaxVersionsGCRule(gc_rule_pb.max_num_versions)
+    elif rule_name == "max_age":
+        max_age = _helpers._duration_pb_to_timedelta(gc_rule_pb.max_age)
+        return MaxAgeGCRule(max_age)
+    elif rule_name == "union":
+        return GCRuleUnion([_gc_rule_from_pb(rule) for rule in gc_rule_pb.union.rules])
+    elif rule_name == "intersection":
+        rules = [_gc_rule_from_pb(rule) for rule in gc_rule_pb.intersection.rules]
+        return GCRuleIntersection(rules)
+    else:
+        raise ValueError("Unexpected rule name", rule_name)
diff --git a/bigtable/google/cloud/bigtable/enums.py b/bigtable/google/cloud/bigtable/enums.py
new file mode 100644
index 000000000000..f0965779fc8b
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/enums.py
@@ -0,0 +1,191 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Wrappers for gapic enum types."""
+
+from google.cloud.bigtable_admin_v2 import enums
+
+
+class StorageType(object):
+    """
+    Storage media types for persisting Bigtable data.
+
+    Attributes:
+      UNSPECIFIED (int): The user did not specify a storage type.
+      SSD (int): Flash (SSD) storage should be used.
+      HDD (int): Magnetic drive (HDD) storage should be used.
+    """
+
+    UNSPECIFIED = enums.StorageType.STORAGE_TYPE_UNSPECIFIED
+    SSD = enums.StorageType.SSD
+    HDD = enums.StorageType.HDD
+
+
+class Instance(object):
+    class State(object):
+        """
+        Possible states of an instance.
+
+        Attributes:
+          STATE_NOT_KNOWN (int): The state of the instance could not be
+          determined.
+          READY (int): The instance has been successfully created and can
+          serve requests to its tables.
+          CREATING (int): The instance is currently being created, and may be
+          destroyed if the creation process encounters an error.
+        """
+
+        NOT_KNOWN = enums.Instance.State.STATE_NOT_KNOWN
+        READY = enums.Instance.State.READY
+        CREATING = enums.Instance.State.CREATING
+
+    class Type(object):
+        """
+        The type of the instance.
+
+        Attributes:
+          UNSPECIFIED (int): The type of the instance is unspecified.
+          If set when creating an instance, a ``PRODUCTION`` instance will
+          be created. If set when updating an instance, the type will be
+          left unchanged.
+          PRODUCTION (int): An instance meant for production use.
+          ``serve_nodes`` must be set on the cluster.
+          DEVELOPMENT (int): The instance is meant for development and testing
+          purposes only; it has no performance or uptime guarantees and is not
+          covered by SLA.
+          After a development instance is created, it can be upgraded by
+          updating the instance to type ``PRODUCTION``. An instance created
+          as a production instance cannot be changed to a development instance.
+          When creating a development instance, ``serve_nodes`` on the cluster
+          must not be set.
+        """
+
+        UNSPECIFIED = enums.Instance.Type.TYPE_UNSPECIFIED
+        PRODUCTION = enums.Instance.Type.PRODUCTION
+        DEVELOPMENT = enums.Instance.Type.DEVELOPMENT
+
+
+class Cluster(object):
+    class State(object):
+        """
+        Possible states of a cluster.
+
+        Attributes:
+          NOT_KNOWN (int): The state of the cluster could not be determined.
+          READY (int): The cluster has been successfully created and is ready
+          to serve requests.
+          CREATING (int): The cluster is currently being created, and may be
+          destroyed if the creation process encounters an error.
+          A cluster may not be able to serve requests while being created.
+          RESIZING (int): The cluster is currently being resized, and may
+          revert to its previous node count if the process encounters an error.
+          A cluster is still capable of serving requests while being resized,
+          but may exhibit performance as if its number of allocated nodes is
+          between the starting and requested states.
+          DISABLED (int): The cluster has no backing nodes. The data (tables)
+          still exist, but no operations can be performed on the cluster.
+        """
+
+        NOT_KNOWN = enums.Cluster.State.STATE_NOT_KNOWN
+        READY = enums.Cluster.State.READY
+        CREATING = enums.Cluster.State.CREATING
+        RESIZING = enums.Cluster.State.RESIZING
+        DISABLED = enums.Cluster.State.DISABLED
+
+
+class RoutingPolicyType(object):
+    """
+    The type of the routing policy for app_profile.
+
+    Attributes:
+      ANY (int): 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.
+      See
+      https://cloud.google.com/bigtable/docs/reference/admin/rpc/google.bigtable.admin.v2#google.bigtable.admin.v2.AppProfile.MultiClusterRoutingUseAny
+
+      SINGLE (int): Unconditionally routes all read/write requests to a
+      specific cluster.
+      This option preserves read-your-writes consistency, but does not improve
+      availability.
+      See
+      https://cloud.google.com/bigtable/docs/reference/admin/rpc/google.bigtable.admin.v2#google.bigtable.admin.v2.AppProfile.SingleClusterRouting
+    """
+
+    ANY = 1
+    SINGLE = 2
+
+
+class Table(object):
+    class View(object):
+        """
+        Defines a view over a table's fields.
+
+        Attributes:
+          VIEW_UNSPECIFIED (int): Uses the default view for each method
+          as documented in its request.
+          NAME_ONLY (int): Only populates ``name``.
+          SCHEMA_VIEW (int): Only populates ``name`` and fields related
+          to the table's schema.
+          REPLICATION_VIEW (int): This is a private alpha release of
+          Cloud Bigtable replication. This feature is not currently available
+          to most Cloud Bigtable customers. This 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.
+
+          Only populates ``name`` and fields related to the table's
+          replication state.
+          FULL (int): Populates all fields.
+        """
+
+        VIEW_UNSPECIFIED = enums.Table.View.VIEW_UNSPECIFIED
+        NAME_ONLY = enums.Table.View.NAME_ONLY
+        SCHEMA_VIEW = enums.Table.View.SCHEMA_VIEW
+        REPLICATION_VIEW = enums.Table.View.REPLICATION_VIEW
+        FULL = enums.Table.View.FULL
+
+    class ReplicationState(object):
+        """
+        Table replication states.
+
+        Attributes:
+          STATE_NOT_KNOWN (int): The replication state of the table is unknown
+           in this cluster.
+          INITIALIZING (int): The cluster was recently created, and the table
+           must finish copying
+          over pre-existing data from other clusters before it can begin
+          receiving live replication updates and serving
+          ``Data API`` requests.
+          PLANNED_MAINTENANCE (int): The table is temporarily unable to serve
+          ``Data API`` requests from this
+          cluster due to planned internal maintenance.
+          UNPLANNED_MAINTENANCE (int): The table is temporarily unable to serve
+          ``Data API`` requests from this
+          cluster due to unplanned or emergency maintenance.
+          READY (int): The table can serve
+          ``Data API`` requests from this
+          cluster. Depending on replication delay, reads may not immediately
+          reflect the state of the table in other clusters.
+        """
+
+        STATE_NOT_KNOWN = enums.Table.ClusterState.ReplicationState.STATE_NOT_KNOWN
+        INITIALIZING = enums.Table.ClusterState.ReplicationState.INITIALIZING
+        PLANNED_MAINTENANCE = (
+            enums.Table.ClusterState.ReplicationState.PLANNED_MAINTENANCE
+        )
+        UNPLANNED_MAINTENANCE = (
+            enums.Table.ClusterState.ReplicationState.UNPLANNED_MAINTENANCE
+        )
+        READY = enums.Table.ClusterState.ReplicationState.READY
diff --git a/bigtable/google/cloud/bigtable/instance.py b/bigtable/google/cloud/bigtable/instance.py
new file mode 100644
index 000000000000..8a664778577a
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/instance.py
@@ -0,0 +1,697 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""User-friendly container for Google Cloud Bigtable Instance."""
+
+
+import re
+
+from google.cloud.bigtable.table import Table
+from google.cloud.bigtable.cluster import Cluster
+from google.cloud.bigtable.app_profile import AppProfile
+
+from google.protobuf import field_mask_pb2
+
+from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+from google.api_core.exceptions import NotFound
+
+from google.cloud.bigtable.policy import Policy
+
+import warnings
+
+_INSTANCE_NAME_RE = re.compile(
+    r"^projects/(?P<project>[^/]+)/" r"instances/(?P<instance_id>[a-z][-a-z0-9]*)$"
+)
+
+_INSTANCE_CREATE_WARNING = """
+Use of `instance.create({0}, {1}, {2})` will be deprecated.
+Please replace with
+`cluster = instance.cluster({0}, {1}, {2})`
+`instance.create(clusters=[cluster])`."""
+
+
+class Instance(object):
+    """Representation of a Google Cloud Bigtable Instance.
+
+    We can use an :class:`Instance` to:
+
+    * :meth:`reload` itself
+    * :meth:`create` itself
+    * :meth:`update` itself
+    * :meth:`delete` itself
+
+    .. note::
+
+        For now, we leave out the ``default_storage_type`` (an enum)
+        which if not sent will end up as :data:`.data_v2_pb2.STORAGE_SSD`.
+
+    :type instance_id: str
+    :param instance_id: The ID of the instance.
+
+    :type client: :class:`Client <google.cloud.bigtable.client.Client>`
+    :param client: The client that owns the instance. Provides
+                   authorization and a project ID.
+
+    :type display_name: str
+    :param display_name: (Optional) The display name for the instance in the
+                         Cloud Console UI. (Must be between 4 and 30
+                         characters.) If this value is not set in the
+                         constructor, will fall back to the instance ID.
+
+    :type instance_type: int
+    :param instance_type: (Optional) The type of the instance.
+                          Possible values are represented
+                          by the following constants:
+                          :data:`google.cloud.bigtable.enums.Instance.Type.PRODUCTION`.
+                          :data:`google.cloud.bigtable.enums.Instance.Type.DEVELOPMENT`,
+                          Defaults to
+                          :data:`google.cloud.bigtable.enums.Instance.Type.UNSPECIFIED`.
+
+    :type labels: dict
+    :param labels: (Optional) Labels are a flexible and lightweight
+                   mechanism for organizing cloud resources into groups
+                   that reflect a customer's organizational needs and
+                   deployment strategies. They can be used to filter
+                   resources and aggregate metrics. Label keys must be
+                   between 1 and 63 characters long. Maximum 64 labels can
+                   be associated with a given resource. Label values must
+                   be between 0 and 63 characters long. Keys and values
+                   must both be under 128 bytes.
+
+    :type _state: int
+    :param _state: (`OutputOnly`)
+                   The current state of the instance.
+                   Possible values are represented by the following constants:
+                   :data:`google.cloud.bigtable.enums.Instance.State.STATE_NOT_KNOWN`.
+                   :data:`google.cloud.bigtable.enums.Instance.State.READY`.
+                   :data:`google.cloud.bigtable.enums.Instance.State.CREATING`.
+    """
+
+    def __init__(
+        self,
+        instance_id,
+        client,
+        display_name=None,
+        instance_type=None,
+        labels=None,
+        _state=None,
+    ):
+        self.instance_id = instance_id
+        self._client = client
+        self.display_name = display_name or instance_id
+        self.type_ = instance_type
+        self.labels = labels
+        self._state = _state
+
+    def _update_from_pb(self, instance_pb):
+        """Refresh self from the server-provided protobuf.
+        Helper for :meth:`from_pb` and :meth:`reload`.
+        """
+        if not instance_pb.display_name:  # Simple field (string)
+            raise ValueError("Instance protobuf does not contain display_name")
+        self.display_name = instance_pb.display_name
+        self.type_ = instance_pb.type
+        self.labels = dict(instance_pb.labels)
+        self._state = instance_pb.state
+
+    @classmethod
+    def from_pb(cls, instance_pb, client):
+        """Creates an instance instance from a protobuf.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_instance_from_pb]
+            :end-before: [END bigtable_instance_from_pb]
+
+        :type instance_pb: :class:`instance_pb2.Instance`
+        :param instance_pb: An instance protobuf object.
+
+        :type client: :class:`Client <google.cloud.bigtable.client.Client>`
+        :param client: The client that owns the instance.
+
+        :rtype: :class:`Instance`
+        :returns: The instance parsed from the protobuf response.
+        :raises: :class:`ValueError <exceptions.ValueError>` if the instance
+                 name does not match
+                 ``projects/{project}/instances/{instance_id}``
+                 or if the parsed project ID does not match the project ID
+                 on the client.
+        """
+        match = _INSTANCE_NAME_RE.match(instance_pb.name)
+        if match is None:
+            raise ValueError(
+                "Instance protobuf name was not in the " "expected format.",
+                instance_pb.name,
+            )
+        if match.group("project") != client.project:
+            raise ValueError(
+                "Project ID on instance does not match the " "project ID on the client"
+            )
+        instance_id = match.group("instance_id")
+
+        result = cls(instance_id, client)
+        result._update_from_pb(instance_pb)
+        return result
+
+    @property
+    def name(self):
+        """Instance name used in requests.
+
+        .. note::
+          This property will not change if ``instance_id`` does not,
+          but the return value is not cached.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_instance_name]
+            :end-before: [END bigtable_instance_name]
+
+        The instance name is of the form
+
+            ``"projects/{project}/instances/{instance_id}"``
+
+        :rtype: str
+        :returns: Return a fully-qualified instance string.
+        """
+        return self._client.instance_admin_client.instance_path(
+            project=self._client.project, instance=self.instance_id
+        )
+
+    @property
+    def state(self):
+        """google.cloud.bigtable.enums.Instance.State: state of Instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_instance_state]
+            :end-before: [END bigtable_instance_state]
+
+        """
+        return self._state
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        # NOTE: This does not compare the configuration values, such as
+        #       the display_name. Instead, it only compares
+        #       identifying values instance ID and client. This is
+        #       intentional, since the same instance can be in different states
+        #       if not synchronized. Instances with similar instance
+        #       settings but different clients can't be used in the same way.
+        return other.instance_id == self.instance_id and other._client == self._client
+
+    def __ne__(self, other):
+        return not self == other
+
+    def create(
+        self,
+        location_id=None,
+        serve_nodes=None,
+        default_storage_type=None,
+        clusters=None,
+    ):
+        """Create this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_prod_instance]
+            :end-before: [END bigtable_create_prod_instance]
+
+        .. note::
+
+            Uses the ``project`` and ``instance_id`` on the current
+            :class:`Instance` in addition to the ``display_name``.
+            To change them before creating, reset the values via
+
+            .. code:: python
+
+                instance.display_name = 'New display name'
+                instance.instance_id = 'i-changed-my-mind'
+
+            before calling :meth:`create`.
+
+        :type location_id: str
+        :param location_id: (Creation Only) The location where nodes and
+                            storage of the cluster owned by this instance
+                            reside. For best performance, clients should be
+                            located as close as possible to cluster's location.
+                            For list of supported locations refer to
+                            https://cloud.google.com/bigtable/docs/locations
+
+
+        :type serve_nodes: int
+        :param serve_nodes: (Optional) The number of nodes in the instance's
+                            cluster; used to set up the instance's cluster.
+
+        :type default_storage_type: int
+        :param default_storage_type: (Optional) The storage media type for
+                                      persisting Bigtable data.
+                                      Possible values are represented
+                                      by the following constants:
+                                      :data:`google.cloud.bigtable.enums.StorageType.SSD`.
+                                      :data:`google.cloud.bigtable.enums.StorageType.SHD`,
+                                      Defaults to
+                                      :data:`google.cloud.bigtable.enums.StorageType.UNSPECIFIED`.
+
+        :type clusters: class:`~[~google.cloud.bigtable.cluster.Cluster]`
+        :param clusters: List of clusters to be created.
+
+        :rtype: :class:`~google.api_core.operation.Operation`
+        :returns: The long-running operation corresponding to the create
+                    operation.
+
+        :raises: :class:`ValueError <exceptions.ValueError>` if both
+                 ``clusters`` and one of ``location_id``, ``serve_nodes``
+                 and ``default_storage_type`` are set.
+        """
+
+        if clusters is None:
+            warnings.warn(
+                _INSTANCE_CREATE_WARNING.format(
+                    "location_id", "serve_nodes", "default_storage_type"
+                ),
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+            cluster_id = "{}-cluster".format(self.instance_id)
+
+            clusters = [
+                self.cluster(
+                    cluster_id,
+                    location_id=location_id,
+                    serve_nodes=serve_nodes,
+                    default_storage_type=default_storage_type,
+                )
+            ]
+        elif (
+            location_id is not None
+            or serve_nodes is not None
+            or default_storage_type is not None
+        ):
+            raise ValueError(
+                "clusters and one of location_id, serve_nodes, \
+                             default_storage_type can not be set \
+                             simultaneously."
+            )
+
+        instance_pb = instance_pb2.Instance(
+            display_name=self.display_name, type=self.type_, labels=self.labels
+        )
+
+        parent = self._client.project_path
+
+        return self._client.instance_admin_client.create_instance(
+            parent=parent,
+            instance_id=self.instance_id,
+            instance=instance_pb,
+            clusters={c.cluster_id: c._to_pb() for c in clusters},
+        )
+
+    def exists(self):
+        """Check whether the instance already exists.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_check_instance_exists]
+            :end-before: [END bigtable_check_instance_exists]
+
+        :rtype: bool
+        :returns: True if the table exists, else False.
+        """
+        try:
+            self._client.instance_admin_client.get_instance(name=self.name)
+            return True
+        # NOTE: There could be other exceptions that are returned to the user.
+        except NotFound:
+            return False
+
+    def reload(self):
+        """Reload the metadata for this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_reload_instance]
+            :end-before: [END bigtable_reload_instance]
+        """
+        instance_pb = self._client.instance_admin_client.get_instance(self.name)
+
+        # NOTE: _update_from_pb does not check that the project and
+        #       instance ID on the response match the request.
+        self._update_from_pb(instance_pb)
+
+    def update(self):
+        """Updates an instance within a project.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_update_instance]
+            :end-before: [END bigtable_update_instance]
+
+        .. note::
+
+            Updates any or all of the following values:
+            ``display_name``
+            ``type``
+            ``labels``
+            To change a value before
+            updating, assign that values via
+
+            .. code:: python
+
+                instance.display_name = 'New display name'
+
+            before calling :meth:`update`.
+
+        :rtype: :class:`~google.api_core.operation.Operation`
+        :returns: The long-running operation corresponding to the update
+                    operation.
+        """
+        update_mask_pb = field_mask_pb2.FieldMask()
+        if self.display_name is not None:
+            update_mask_pb.paths.append("display_name")
+        if self.type_ is not None:
+            update_mask_pb.paths.append("type")
+        if self.labels is not None:
+            update_mask_pb.paths.append("labels")
+        instance_pb = instance_pb2.Instance(
+            name=self.name,
+            display_name=self.display_name,
+            type=self.type_,
+            labels=self.labels,
+        )
+
+        return self._client.instance_admin_client.partial_update_instance(
+            instance=instance_pb, update_mask=update_mask_pb
+        )
+
+    def delete(self):
+        """Delete this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_delete_instance]
+            :end-before: [END bigtable_delete_instance]
+
+        Marks an instance and all of its tables for permanent deletion
+        in 7 days.
+
+        Immediately upon completion of the request:
+
+        * Billing will cease for all of the instance's reserved resources.
+        * The instance's ``delete_time`` field will be set 7 days in
+          the future.
+
+        Soon afterward:
+
+        * All tables within the instance will become unavailable.
+
+        At the instance's ``delete_time``:
+
+        * The instance and **all of its tables** will immediately and
+          irrevocably disappear from the API, and their data will be
+          permanently deleted.
+        """
+        self._client.instance_admin_client.delete_instance(name=self.name)
+
+    def get_iam_policy(self):
+        """Gets the access control policy for an instance resource.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_get_iam_policy]
+            :end-before: [END bigtable_get_iam_policy]
+
+        :rtype: :class:`google.cloud.bigtable.policy.Policy`
+        :returns: The current IAM policy of this instance
+        """
+        instance_admin_client = self._client.instance_admin_client
+        resp = instance_admin_client.get_iam_policy(resource=self.name)
+        return Policy.from_pb(resp)
+
+    def set_iam_policy(self, policy):
+        """Sets the access control policy on an instance resource. Replaces any
+        existing policy.
+
+        For more information about policy, please see documentation of
+        class `google.cloud.bigtable.policy.Policy`
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_set_iam_policy]
+            :end-before: [END bigtable_set_iam_policy]
+
+        :type policy: :class:`google.cloud.bigtable.policy.Policy`
+        :param policy: A new IAM policy to replace the current IAM policy
+                       of this instance
+
+        :rtype: :class:`google.cloud.bigtable.policy.Policy`
+        :returns: The current IAM policy of this instance.
+        """
+        instance_admin_client = self._client.instance_admin_client
+        resp = instance_admin_client.set_iam_policy(
+            resource=self.name, policy=policy.to_pb()
+        )
+        return Policy.from_pb(resp)
+
+    def test_iam_permissions(self, permissions):
+        """Returns permissions that the caller has on the specified instance
+        resource.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_test_iam_permissions]
+            :end-before: [END bigtable_test_iam_permissions]
+
+        :type permissions: list
+        :param permissions: 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>`_.
+               `Bigtable Permissions
+               <https://cloud.google.com/bigtable/docs/access-control>`_.
+
+        :rtype: list
+        :returns: A List(string) of permissions allowed on the instance
+        """
+        instance_admin_client = self._client.instance_admin_client
+        resp = instance_admin_client.test_iam_permissions(
+            resource=self.name, permissions=permissions
+        )
+        return list(resp.permissions)
+
+    def cluster(
+        self, cluster_id, location_id=None, serve_nodes=None, default_storage_type=None
+    ):
+        """Factory to create a cluster associated with this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_cluster]
+            :end-before: [END bigtable_create_cluster]
+
+        :type cluster_id: str
+        :param cluster_id: The ID of the cluster.
+
+        :type instance: :class:`~google.cloud.bigtable.instance.Instance`
+        :param instance: The instance where the cluster resides.
+
+        :type location_id: str
+        :param location_id: (Creation Only) The location where this cluster's
+                            nodes and storage reside. For best performance,
+                            clients should be located as close as possible to
+                            this cluster.
+                            For list of supported locations refer to
+                            https://cloud.google.com/bigtable/docs/locations
+
+        :type serve_nodes: int
+        :param serve_nodes: (Optional) The number of nodes in the cluster.
+
+        :type default_storage_type: int
+        :param default_storage_type: (Optional) The type of storage
+                                     Possible values are represented by the
+                                     following constants:
+                                     :data:`google.cloud.bigtable.enums.StorageType.SSD`.
+                                     :data:`google.cloud.bigtable.enums.StorageType.SHD`,
+                                     Defaults to
+                                     :data:`google.cloud.bigtable.enums.StorageType.UNSPECIFIED`.
+
+        :rtype: :class:`~google.cloud.bigtable.instance.Cluster`
+        :returns: a cluster owned by this instance.
+        """
+        return Cluster(
+            cluster_id,
+            self,
+            location_id=location_id,
+            serve_nodes=serve_nodes,
+            default_storage_type=default_storage_type,
+        )
+
+    def list_clusters(self):
+        """List the clusters in this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_list_clusters_on_instance]
+            :end-before: [END bigtable_list_clusters_on_instance]
+
+        :rtype: tuple
+        :returns:
+            (clusters, failed_locations), where 'clusters' is list of
+            :class:`google.cloud.bigtable.instance.Cluster`, and
+            'failed_locations' is a list of locations which could not
+            be resolved.
+        """
+        resp = self._client.instance_admin_client.list_clusters(self.name)
+        clusters = [Cluster.from_pb(cluster, self) for cluster in resp.clusters]
+        return clusters, resp.failed_locations
+
+    def table(self, table_id, mutation_timeout=None, app_profile_id=None):
+        """Factory to create a table associated with this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_table]
+            :end-before: [END bigtable_create_table]
+
+        :type table_id: str
+        :param table_id: The ID of the table.
+
+        :type app_profile_id: str
+        :param app_profile_id: (Optional) The unique name of the AppProfile.
+
+        :rtype: :class:`Table <google.cloud.bigtable.table.Table>`
+        :returns: The table owned by this instance.
+        """
+        return Table(
+            table_id,
+            self,
+            app_profile_id=app_profile_id,
+            mutation_timeout=mutation_timeout,
+        )
+
+    def list_tables(self):
+        """List the tables in this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_list_tables]
+            :end-before: [END bigtable_list_tables]
+
+        :rtype: list of :class:`Table <google.cloud.bigtable.table.Table>`
+        :returns: The list of tables owned by the instance.
+        :raises: :class:`ValueError <exceptions.ValueError>` if one of the
+                 returned tables has a name that is not of the expected format.
+        """
+        table_list_pb = self._client.table_admin_client.list_tables(self.name)
+
+        result = []
+        for table_pb in table_list_pb:
+            table_prefix = self.name + "/tables/"
+            if not table_pb.name.startswith(table_prefix):
+                raise ValueError(
+                    "Table name {} not of expected format".format(table_pb.name)
+                )
+            table_id = table_pb.name[len(table_prefix) :]
+            result.append(self.table(table_id))
+
+        return result
+
+    def app_profile(
+        self,
+        app_profile_id,
+        routing_policy_type=None,
+        description=None,
+        cluster_id=None,
+        allow_transactional_writes=None,
+    ):
+        """Factory to create AppProfile associated with this instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_create_app_profile]
+            :end-before: [END bigtable_create_app_profile]
+
+        :type app_profile_id: str
+        :param app_profile_id: The ID of the AppProfile. Must be of the form
+                               ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+
+        :type: routing_policy_type: int
+        :param: routing_policy_type: The type of the routing policy.
+                                     Possible values are represented
+                                     by the following constants:
+                                     :data:`google.cloud.bigtable.enums.RoutingPolicyType.ANY`
+                                     :data:`google.cloud.bigtable.enums.RoutingPolicyType.SINGLE`
+
+        :type: description: str
+        :param: description: (Optional) Long form description of the use
+                             case for this AppProfile.
+
+        :type: cluster_id: str
+        :param: cluster_id: (Optional) Unique cluster_id which is only required
+                            when routing_policy_type is
+                            ROUTING_POLICY_TYPE_SINGLE.
+
+        :type: allow_transactional_writes: bool
+        :param: allow_transactional_writes: (Optional) If true, allow
+                                            transactional writes for
+                                            ROUTING_POLICY_TYPE_SINGLE.
+
+        :rtype: :class:`~google.cloud.bigtable.app_profile.AppProfile>`
+        :returns: AppProfile for this instance.
+        """
+        return AppProfile(
+            app_profile_id,
+            self,
+            routing_policy_type=routing_policy_type,
+            description=description,
+            cluster_id=cluster_id,
+            allow_transactional_writes=allow_transactional_writes,
+        )
+
+    def list_app_profiles(self):
+        """Lists information about AppProfiles in an instance.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_list_app_profiles]
+            :end-before: [END bigtable_list_app_profiles]
+
+        :rtype: :list:[`~google.cloud.bigtable.app_profile.AppProfile`]
+        :returns: A :list:[`~google.cloud.bigtable.app_profile.AppProfile`].
+                  By default, this is a list of
+                  :class:`~google.cloud.bigtable.app_profile.AppProfile`
+                  instances.
+        """
+        resp = self._client.instance_admin_client.list_app_profiles(self.name)
+        return [AppProfile.from_pb(app_profile, self) for app_profile in resp]
diff --git a/bigtable/google/cloud/bigtable/policy.py b/bigtable/google/cloud/bigtable/policy.py
new file mode 100644
index 000000000000..9fea7bbc5a0e
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/policy.py
@@ -0,0 +1,213 @@
+# 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.
+
+import base64
+
+from google.api_core.iam import Policy as BasePolicy
+from google.cloud._helpers import _to_bytes
+from google.iam.v1 import policy_pb2
+
+"""IAM roles supported by Bigtable Instance resource"""
+BIGTABLE_ADMIN_ROLE = "roles/bigtable.admin"
+"""Administers all instances within a project, including the data stored
+within tables. Can create new instances. Intended for project administrators.
+"""
+BIGTABLE_USER_ROLE = "roles/bigtable.user"
+"""Provides read-write access to the data stored within tables. Intended for
+application developers or service accounts.
+"""
+BIGTABLE_READER_ROLE = "roles/bigtable.reader"
+"""Provides read-only access to the data stored within tables. Intended for
+data scientists, dashboard generators, and other data-analysis scenarios.
+"""
+BIGTABLE_VIEWER_ROLE = "roles/bigtable.viewer"
+"""Provides no data access. Intended as a minimal set of permissions to access
+the GCP Console for Cloud Bigtable.
+"""
+"""For detailed information
+See
+https://cloud.google.com/bigtable/docs/access-control#roles
+"""
+
+
+class Policy(BasePolicy):
+    """IAM Policy
+
+    See
+    https://cloud.google.com/bigtable/docs/reference/admin/rpc/google.iam.v1#policy
+
+    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.
+    For more information about predefined roles currently supoprted
+    by Bigtable Instance please see
+    `Predefined roles
+    <https://cloud.google.com/bigtable/docs/access-control#roles>`_.
+    For more information about custom roles please see
+    `Custom roles
+    <https://cloud.google.com/bigtable/docs/access-control#custom-roles>`_.
+
+    :type etag: str
+    :param etag: etag is used for optimistic concurrency control as a way to
+                 help prevent simultaneous updates of a policy from overwriting
+                 each other. It is strongly suggested that systems make use
+                 of the etag in the read-modify-write cycle to perform policy
+                 updates in order to avoid race conditions:
+                 An etag is returned in the response to getIamPolicy, and
+                 systems are expected to put that etag in the request to
+                 setIamPolicy to 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.
+    """
+
+    def __init__(self, etag=None, version=None):
+        BasePolicy.__init__(
+            self, etag=etag if etag is None else _to_bytes(etag), version=version
+        )
+
+    @property
+    def bigtable_admins(self):
+        """Access to bigtable.admin role memebers
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_admins_policy]
+            :end-before: [END bigtable_admins_policy]
+        """
+        result = set()
+        for member in self._bindings.get(BIGTABLE_ADMIN_ROLE, ()):
+            result.add(member)
+        return frozenset(result)
+
+    @property
+    def bigtable_readers(self):
+        """Access to bigtable.reader role memebers
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_readers_policy]
+            :end-before: [END bigtable_readers_policy]
+        """
+        result = set()
+        for member in self._bindings.get(BIGTABLE_READER_ROLE, ()):
+            result.add(member)
+        return frozenset(result)
+
+    @property
+    def bigtable_users(self):
+        """Access to bigtable.user role memebers
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_users_policy]
+            :end-before: [END bigtable_users_policy]
+        """
+        result = set()
+        for member in self._bindings.get(BIGTABLE_USER_ROLE, ()):
+            result.add(member)
+        return frozenset(result)
+
+    @property
+    def bigtable_viewers(self):
+        """Access to bigtable.viewer role memebers
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START bigtable_viewers_policy]
+            :end-before: [END bigtable_viewers_policy]
+        """
+        result = set()
+        for member in self._bindings.get(BIGTABLE_VIEWER_ROLE, ()):
+            result.add(member)
+        return frozenset(result)
+
+    @classmethod
+    def from_pb(cls, policy_pb):
+        """Factory: create a policy from a protobuf message.
+
+        Args:
+            policy_pb (google.iam.policy_pb2.Policy): message returned by
+            ``get_iam_policy`` gRPC API.
+
+        Returns:
+            :class:`Policy`: the parsed policy
+        """
+        policy = cls(policy_pb.etag, policy_pb.version)
+
+        for binding in policy_pb.bindings:
+            policy[binding.role] = sorted(binding.members)
+
+        return policy
+
+    def to_pb(self):
+        """Render a protobuf message.
+
+        Returns:
+            google.iam.policy_pb2.Policy: a message to be passed to the
+            ``set_iam_policy`` gRPC API.
+        """
+
+        return policy_pb2.Policy(
+            etag=self.etag,
+            version=self.version or 0,
+            bindings=[
+                policy_pb2.Binding(role=role, members=sorted(self[role]))
+                for role in self
+            ],
+        )
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory: create a policy from a JSON resource.
+
+        Overrides the base class version to store :attr:`etag` as bytes.
+
+        Args:
+            resource (dict): JSON policy resource returned by the
+            ``getIamPolicy`` REST API.
+
+        Returns:
+            :class:`Policy`: the parsed policy
+        """
+        etag = resource.get("etag")
+
+        if etag is not None:
+            resource = resource.copy()
+            resource["etag"] = base64.b64decode(etag.encode("ascii"))
+
+        return super(Policy, cls).from_api_repr(resource)
+
+    def to_api_repr(self):
+        """Render a JSON policy resource.
+
+        Overrides the base class version to convert :attr:`etag` from bytes
+        to JSON-compatible base64-encoded text.
+
+        Returns:
+            dict: a JSON resource to be passed to the
+            ``setIamPolicy`` REST API.
+        """
+        resource = super(Policy, self).to_api_repr()
+
+        if self.etag is not None:
+            resource["etag"] = base64.b64encode(self.etag).decode("ascii")
+
+        return resource
diff --git a/google/cloud/bigtable/row.py b/bigtable/google/cloud/bigtable/row.py
similarity index 80%
rename from google/cloud/bigtable/row.py
rename to bigtable/google/cloud/bigtable/row.py
index 11ebceeafb94..8d1f91f3296f 100644
--- a/google/cloud/bigtable/row.py
+++ b/bigtable/google/cloud/bigtable/row.py
@@ -1,4 +1,4 @@
-# Copyright 2015 Google Inc. All rights reserved.
+# Copyright 2015 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""User friendly container for Google Cloud Bigtable Row."""
+"""User-friendly container for Google Cloud Bigtable Row."""
 
 
 import struct
@@ -22,13 +22,10 @@
 from google.cloud._helpers import _datetime_from_microseconds
 from google.cloud._helpers import _microseconds_from_datetime
 from google.cloud._helpers import _to_bytes
-from google.cloud.bigtable._generated import (
-    data_pb2 as data_v2_pb2)
-from google.cloud.bigtable._generated import (
-    bigtable_pb2 as messages_v2_pb2)
+from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
 
 
-_PACK_I64 = struct.Struct('>q').pack
+_PACK_I64 = struct.Struct(">q").pack
 
 MAX_MUTATIONS = 100000
 """The maximum number of mutations that a row can accumulate."""
@@ -48,13 +45,43 @@ class Row(object):
     :param row_key: The key for the current row.
 
     :type table: :class:`Table <google.cloud.bigtable.table.Table>`
-    :param table: The table that owns the row.
+    :param table: (Optional) The table that owns the row.
     """
 
-    def __init__(self, row_key, table):
+    def __init__(self, row_key, table=None):
         self._row_key = _to_bytes(row_key)
         self._table = table
 
+    @property
+    def row_key(self):
+        """Row key.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_row_key]
+            :end-before: [END bigtable_row_row_key]
+
+        :rtype: bytes
+        :returns: The key for the current row.
+        """
+        return self._row_key
+
+    @property
+    def table(self):
+        """Row table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_table]
+            :end-before: [END bigtable_row_table]
+
+        :rtype: table: :class:`Table <google.cloud.bigtable.table.Table>`
+        :returns: table: The table that owns the row.
+        """
+        return self._table
+
 
 class _SetDeleteRow(Row):
     """Row helper for setting or deleting cell values.
@@ -76,7 +103,7 @@ class _SetDeleteRow(Row):
     ALL_COLUMNS = object()
     """Sentinel value used to indicate all columns in a column family."""
 
-    def _get_mutations(self, state):
+    def _get_mutations(self, state=None):
         """Gets the list of mutations for a given state.
 
         This method intended to be implemented by subclasses.
@@ -92,8 +119,7 @@ def _get_mutations(self, state):
         """
         raise NotImplementedError
 
-    def _set_cell(self, column_family_id, column, value, timestamp=None,
-                  state=None):
+    def _set_cell(self, column_family_id, column, value, timestamp=None, state=None):
         """Helper for :meth:`set_cell`
 
         Adds a mutation to set the value in a specific cell.
@@ -132,7 +158,7 @@ def _set_cell(self, column_family_id, column, value, timestamp=None,
         else:
             timestamp_micros = _microseconds_from_datetime(timestamp)
             # Truncate to millisecond granularity.
-            timestamp_micros -= (timestamp_micros % 1000)
+            timestamp_micros -= timestamp_micros % 1000
 
         mutation_val = data_v2_pb2.Mutation.SetCell(
             family_name=column_family_id,
@@ -160,8 +186,7 @@ def _delete(self, state=None):
         mutation_pb = data_v2_pb2.Mutation(delete_from_row=mutation_val)
         self._get_mutations(state).append(mutation_pb)
 
-    def _delete_cells(self, column_family_id, columns, time_range=None,
-                      state=None):
+    def _delete_cells(self, column_family_id, columns, time_range=None, state=None):
         """Helper for :meth:`delete_cell` and :meth:`delete_cells`.
 
         ``state`` is unused by :class:`DirectRow` but is used by
@@ -189,14 +214,14 @@ def _delete_cells(self, column_family_id, columns, time_range=None,
         mutations_list = self._get_mutations(state)
         if columns is self.ALL_COLUMNS:
             mutation_val = data_v2_pb2.Mutation.DeleteFromFamily(
-                family_name=column_family_id,
+                family_name=column_family_id
             )
             mutation_pb = data_v2_pb2.Mutation(delete_from_family=mutation_val)
             mutations_list.append(mutation_pb)
         else:
             delete_kwargs = {}
             if time_range is not None:
-                delete_kwargs['time_range'] = time_range.to_pb()
+                delete_kwargs["time_range"] = time_range.to_pb()
 
             to_append = []
             for column in columns:
@@ -204,13 +229,10 @@ def _delete_cells(self, column_family_id, columns, time_range=None,
                 # time_range will never change if present, but the rest of
                 # delete_kwargs will
                 delete_kwargs.update(
-                    family_name=column_family_id,
-                    column_qualifier=column,
+                    family_name=column_family_id, column_qualifier=column
                 )
-                mutation_val = data_v2_pb2.Mutation.DeleteFromColumn(
-                    **delete_kwargs)
-                mutation_pb = data_v2_pb2.Mutation(
-                    delete_from_column=mutation_val)
+                mutation_val = data_v2_pb2.Mutation.DeleteFromColumn(**delete_kwargs)
+                mutation_pb = data_v2_pb2.Mutation(delete_from_column=mutation_val)
                 to_append.append(mutation_pb)
 
             # We don't add the mutations until all columns have been
@@ -245,14 +267,17 @@ class DirectRow(_SetDeleteRow):
     :param row_key: The key for the current row.
 
     :type table: :class:`Table <google.cloud.bigtable.table.Table>`
-    :param table: The table that owns the row.
+    :param table: (Optional) The table that owns the row. This is
+                  used for the :meth: `commit` only.  Alternatively,
+                  DirectRows can be persisted via
+                  :meth:`~google.cloud.bigtable.table.Table.mutate_rows`.
     """
 
-    def __init__(self, row_key, table):
+    def __init__(self, row_key, table=None):
         super(DirectRow, self).__init__(row_key, table)
         self._pb_mutations = []
 
-    def _get_mutations(self, state):  # pylint: disable=unused-argument
+    def _get_mutations(self, state=None):  # pylint: disable=unused-argument
         """Gets the list of mutations for a given state.
 
         ``state`` is unused by :class:`DirectRow` but is used by
@@ -267,6 +292,23 @@ def _get_mutations(self, state):  # pylint: disable=unused-argument
         """
         return self._pb_mutations
 
+    def get_mutations_size(self):
+        """ Gets the total mutations size for current row
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_get_mutations_size]
+            :end-before: [END bigtable_row_get_mutations_size]
+
+        """
+
+        mutation_size = 0
+        for mutation in self._get_mutations():
+            mutation_size += mutation.ByteSize()
+
+        return mutation_size
+
     def set_cell(self, column_family_id, column, value, timestamp=None):
         """Sets a value in this row.
 
@@ -281,6 +323,12 @@ def set_cell(self, column_family_id, column, value, timestamp=None):
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_set_cell]
+            :end-before: [END bigtable_row_set_cell]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column.
                                  Must be of the form
@@ -298,8 +346,7 @@ def set_cell(self, column_family_id, column, value, timestamp=None):
         :type timestamp: :class:`datetime.datetime`
         :param timestamp: (Optional) The timestamp of the operation.
         """
-        self._set_cell(column_family_id, column, value, timestamp=timestamp,
-                       state=None)
+        self._set_cell(column_family_id, column, value, timestamp=timestamp, state=None)
 
     def delete(self):
         """Deletes this row from the table.
@@ -310,6 +357,13 @@ def delete(self):
             row, but does not make an API request. To actually
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_delete]
+            :end-before: [END bigtable_row_delete]
+
         """
         self._delete(state=None)
 
@@ -323,6 +377,12 @@ def delete_cell(self, column_family_id, column, time_range=None):
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_delete_cell]
+            :end-before: [END bigtable_row_delete_cell]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column
                                  or columns with cells being deleted. Must be
@@ -336,8 +396,9 @@ def delete_cell(self, column_family_id, column, time_range=None):
         :param time_range: (Optional) The range of time within which cells
                            should be deleted.
         """
-        self._delete_cells(column_family_id, [column], time_range=time_range,
-                           state=None)
+        self._delete_cells(
+            column_family_id, [column], time_range=time_range, state=None
+        )
 
     def delete_cells(self, column_family_id, columns, time_range=None):
         """Deletes cells in this row.
@@ -349,6 +410,12 @@ def delete_cells(self, column_family_id, columns, time_range=None):
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_delete_cells]
+            :end-before: [END bigtable_row_delete_cells]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column
                                  or columns with cells being deleted. Must be
@@ -364,8 +431,7 @@ def delete_cells(self, column_family_id, columns, time_range=None):
         :param time_range: (Optional) The range of time within which cells
                            should be deleted.
         """
-        self._delete_cells(column_family_id, columns, time_range=time_range,
-                           state=None)
+        self._delete_cells(column_family_id, columns, time_range=time_range, state=None)
 
     def commit(self):
         """Makes a ``MutateRow`` API request.
@@ -379,28 +445,28 @@ def commit(self):
         After committing the accumulated mutations, resets the local
         mutations to an empty list.
 
-        :raises: :class:`ValueError <exceptions.ValueError>` if the number of
-                 mutations exceeds the :data:`MAX_MUTATIONS`.
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_commit]
+            :end-before: [END bigtable_row_commit]
+
+        :raises: :exc:`~.table.TooManyMutationsError` if the number of
+                 mutations is greater than 100,000.
         """
-        mutations_list = self._get_mutations(None)
-        num_mutations = len(mutations_list)
-        if num_mutations == 0:
-            return
-        if num_mutations > MAX_MUTATIONS:
-            raise ValueError('%d total mutations exceed the maximum allowable '
-                             '%d.' % (num_mutations, MAX_MUTATIONS))
-        request_pb = messages_v2_pb2.MutateRowRequest(
-            table_name=self._table.name,
-            row_key=self._row_key,
-            mutations=mutations_list,
-        )
-        # We expect a `google.protobuf.empty_pb2.Empty`
-        client = self._table._instance._client
-        client._data_stub.MutateRow(request_pb)
+        self._table.mutate_rows([self])
         self.clear()
 
     def clear(self):
-        """Removes all currently accumulated mutations on the current row."""
+        """Removes all currently accumulated mutations on the current row.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_clear]
+            :end-before: [END bigtable_row_clear]
+
+        """
         del self._pb_mutations[:]
 
 
@@ -440,13 +506,14 @@ class ConditionalRow(_SetDeleteRow):
     :type filter_: :class:`.RowFilter`
     :param filter_: Filter to be used for conditional mutations.
     """
+
     def __init__(self, row_key, table, filter_):
         super(ConditionalRow, self).__init__(row_key, table)
         self._filter = filter_
         self._true_pb_mutations = []
         self._false_pb_mutations = []
 
-    def _get_mutations(self, state):
+    def _get_mutations(self, state=None):
         """Gets the list of mutations for a given state.
 
         Over-ridden so that the state can be used in:
@@ -485,6 +552,12 @@ def commit(self):
         After committing the accumulated mutations, resets the local
         mutations.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_commit]
+            :end-before: [END bigtable_row_commit]
+
         :rtype: bool
         :returns: Flag indicating if the filter was matched (which also
                   indicates which set of mutations were applied by the server).
@@ -497,29 +570,26 @@ def commit(self):
         num_false_mutations = len(false_mutations)
         if num_true_mutations == 0 and num_false_mutations == 0:
             return
-        if (num_true_mutations > MAX_MUTATIONS or
-                num_false_mutations > MAX_MUTATIONS):
+        if num_true_mutations > MAX_MUTATIONS or num_false_mutations > MAX_MUTATIONS:
             raise ValueError(
-                'Exceed the maximum allowable mutations (%d). Had %s true '
-                'mutations and %d false mutations.' % (
-                    MAX_MUTATIONS, num_true_mutations, num_false_mutations))
+                "Exceed the maximum allowable mutations (%d). Had %s true "
+                "mutations and %d false mutations."
+                % (MAX_MUTATIONS, num_true_mutations, num_false_mutations)
+            )
 
-        request_pb = messages_v2_pb2.CheckAndMutateRowRequest(
+        data_client = self._table._instance._client.table_data_client
+        resp = data_client.check_and_mutate_row(
             table_name=self._table.name,
             row_key=self._row_key,
             predicate_filter=self._filter.to_pb(),
             true_mutations=true_mutations,
             false_mutations=false_mutations,
         )
-        # We expect a `.messages_v2_pb2.CheckAndMutateRowResponse`
-        client = self._table._instance._client
-        resp = client._data_stub.CheckAndMutateRow(request_pb)
         self.clear()
         return resp.predicate_matched
 
     # pylint: disable=arguments-differ
-    def set_cell(self, column_family_id, column, value, timestamp=None,
-                 state=True):
+    def set_cell(self, column_family_id, column, value, timestamp=None, state=True):
         """Sets a value in this row.
 
         The cell is determined by the ``row_key`` of this
@@ -534,6 +604,12 @@ def set_cell(self, column_family_id, column, value, timestamp=None,
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_set_cell]
+            :end-before: [END bigtable_row_set_cell]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column.
                                  Must be of the form
@@ -555,8 +631,9 @@ def set_cell(self, column_family_id, column, value, timestamp=None,
         :param state: (Optional) The state that the mutation should be
                       applied in. Defaults to :data:`True`.
         """
-        self._set_cell(column_family_id, column, value, timestamp=timestamp,
-                       state=state)
+        self._set_cell(
+            column_family_id, column, value, timestamp=timestamp, state=state
+        )
 
     def delete(self, state=True):
         """Deletes this row from the table.
@@ -568,14 +645,19 @@ def delete(self, state=True):
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_delete]
+            :end-before: [END bigtable_row_delete]
+
         :type state: bool
         :param state: (Optional) The state that the mutation should be
                       applied in. Defaults to :data:`True`.
         """
         self._delete(state=state)
 
-    def delete_cell(self, column_family_id, column, time_range=None,
-                    state=True):
+    def delete_cell(self, column_family_id, column, time_range=None, state=True):
         """Deletes cell in this row.
 
         .. note::
@@ -585,6 +667,12 @@ def delete_cell(self, column_family_id, column, time_range=None,
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+         For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_delete_cell]
+            :end-before: [END bigtable_row_delete_cell]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column
                                  or columns with cells being deleted. Must be
@@ -602,11 +690,11 @@ def delete_cell(self, column_family_id, column, time_range=None,
         :param state: (Optional) The state that the mutation should be
                       applied in. Defaults to :data:`True`.
         """
-        self._delete_cells(column_family_id, [column], time_range=time_range,
-                           state=state)
+        self._delete_cells(
+            column_family_id, [column], time_range=time_range, state=state
+        )
 
-    def delete_cells(self, column_family_id, columns, time_range=None,
-                     state=True):
+    def delete_cells(self, column_family_id, columns, time_range=None, state=True):
         """Deletes cells in this row.
 
         .. note::
@@ -616,6 +704,12 @@ def delete_cells(self, column_family_id, columns, time_range=None,
             send an API request (with the mutations) to the Google Cloud
             Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_delete_cells]
+            :end-before: [END bigtable_row_delete_cells]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column
                                  or columns with cells being deleted. Must be
@@ -635,12 +729,22 @@ def delete_cells(self, column_family_id, columns, time_range=None,
         :param state: (Optional) The state that the mutation should be
                       applied in. Defaults to :data:`True`.
         """
-        self._delete_cells(column_family_id, columns, time_range=time_range,
-                           state=state)
+        self._delete_cells(
+            column_family_id, columns, time_range=time_range, state=state
+        )
+
     # pylint: enable=arguments-differ
 
     def clear(self):
-        """Removes all currently accumulated mutations on the current row."""
+        """Removes all currently accumulated mutations on the current row.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_clear]
+            :end-before: [END bigtable_row_clear]
+
+        """
         del self._true_pb_mutations[:]
         del self._false_pb_mutations[:]
 
@@ -657,7 +761,7 @@ class AppendRow(Row):
     The first works by appending bytes and the second by incrementing an
     integer (stored in the cell as 8 bytes). In either case, if the
     cell is empty, assumes the default empty value (empty string for
-    bytes or and 0 for integer).
+    bytes or 0 for integer).
 
     :type row_key: bytes
     :param row_key: The key for the current row.
@@ -671,7 +775,15 @@ def __init__(self, row_key, table):
         self._rule_pb_list = []
 
     def clear(self):
-        """Removes all currently accumulated modifications on current row."""
+        """Removes all currently accumulated modifications on current row.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_clear]
+            :end-before: [END bigtable_row_clear]
+
+        """
         del self._rule_pb_list[:]
 
     def append_cell_value(self, column_family_id, column, value):
@@ -684,6 +796,12 @@ def append_cell_value(self, column_family_id, column, value):
             request. To actually send an API request (with the rules) to the
             Google Cloud Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_append_cell_value]
+            :end-before: [END bigtable_row_append_cell_value]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column.
                                  Must be of the form
@@ -701,9 +819,8 @@ def append_cell_value(self, column_family_id, column, value):
         column = _to_bytes(column)
         value = _to_bytes(value)
         rule_pb = data_v2_pb2.ReadModifyWriteRule(
-            family_name=column_family_id,
-            column_qualifier=column,
-            append_value=value)
+            family_name=column_family_id, column_qualifier=column, append_value=value
+        )
         self._rule_pb_list.append(rule_pb)
 
     def increment_cell_value(self, column_family_id, column, int_value):
@@ -719,6 +836,12 @@ def increment_cell_value(self, column_family_id, column, int_value):
             request. To actually send an API request (with the rules) to the
             Google Cloud Bigtable API, call :meth:`commit`.
 
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_increment_cell_value]
+            :end-before: [END bigtable_row_increment_cell_value]
+
         :type column_family_id: str
         :param column_family_id: The column family that contains the column.
                                  Must be of the form
@@ -740,7 +863,8 @@ def increment_cell_value(self, column_family_id, column, int_value):
         rule_pb = data_v2_pb2.ReadModifyWriteRule(
             family_name=column_family_id,
             column_qualifier=column,
-            increment_amount=int_value)
+            increment_amount=int_value,
+        )
         self._rule_pb_list.append(rule_pb)
 
     def commit(self):
@@ -758,25 +882,11 @@ def commit(self):
 
         After committing the accumulated mutations, resets the local mutations.
 
-        .. code:: python
-
-            >>> append_row.commit()
-            {
-                u'col-fam-id': {
-                    b'col-name1': [
-                        (b'cell-val', datetime.datetime(...)),
-                        (b'cell-val-newer', datetime.datetime(...)),
-                    ],
-                    b'col-name2': [
-                        (b'altcol-cell-val', datetime.datetime(...)),
-                    ],
-                },
-                u'col-fam-id2': {
-                    b'col-name3-but-other-fam': [
-                        (b'foo', datetime.datetime(...)),
-                    ],
-                },
-            }
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_commit]
+            :end-before: [END bigtable_row_commit]
 
         :rtype: dict
         :returns: The new contents of all modified cells. Returned as a
@@ -791,16 +901,15 @@ def commit(self):
         if num_mutations == 0:
             return {}
         if num_mutations > MAX_MUTATIONS:
-            raise ValueError('%d total append mutations exceed the maximum '
-                             'allowable %d.' % (num_mutations, MAX_MUTATIONS))
-        request_pb = messages_v2_pb2.ReadModifyWriteRowRequest(
-            table_name=self._table.name,
-            row_key=self._row_key,
-            rules=self._rule_pb_list,
+            raise ValueError(
+                "%d total append mutations exceed the maximum "
+                "allowable %d." % (num_mutations, MAX_MUTATIONS)
+            )
+
+        data_client = self._table._instance._client.table_data_client
+        row_response = data_client.read_modify_write_row(
+            table_name=self._table.name, row_key=self._row_key, rules=self._rule_pb_list
         )
-        # We expect a `.data_v2_pb2.Row`
-        client = self._table._instance._client
-        row_response = client._data_stub.ReadModifyWriteRow(request_pb)
 
         # Reset modifications after commit-ing request.
         self.clear()
@@ -878,10 +987,7 @@ def _parse_family_pb(family_pb):
     for column in family_pb.columns:
         result[column.qualifier] = cells = []
         for cell in column.cells:
-            val_pair = (
-                cell.value,
-                _datetime_from_microseconds(cell.timestamp_micros),
-            )
+            val_pair = (cell.value, _datetime_from_microseconds(cell.timestamp_micros))
             cells.append(val_pair)
 
     return family_pb.name, result
diff --git a/bigtable/google/cloud/bigtable/row_data.py b/bigtable/google/cloud/bigtable/row_data.py
new file mode 100644
index 000000000000..24078b8496d8
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/row_data.py
@@ -0,0 +1,699 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Container for Google Cloud Bigtable Cells and Streaming Row Contents."""
+
+
+import copy
+import six
+
+import grpc
+
+from google.api_core import exceptions
+from google.api_core import retry
+from google.cloud._helpers import _datetime_from_microseconds
+from google.cloud._helpers import _to_bytes
+from google.cloud.bigtable_v2.proto import bigtable_pb2 as data_messages_v2_pb2
+from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+_MISSING_COLUMN_FAMILY = "Column family {} is not among the cells stored in this row."
+_MISSING_COLUMN = (
+    "Column {} is not among the cells stored in this row in the " "column family {}."
+)
+_MISSING_INDEX = (
+    "Index {!r} is not valid for the cells stored in this row for column {} "
+    "in the column family {}. There are {} such cells."
+)
+
+
+class Cell(object):
+    """Representation of a Google Cloud Bigtable Cell.
+
+    :type value: bytes
+    :param value: The value stored in the cell.
+
+    :type timestamp_micros: int
+    :param timestamp_micros: The timestamp_micros when the cell was stored.
+
+    :type labels: list
+    :param labels: (Optional) List of strings. Labels applied to the cell.
+    """
+
+    def __init__(self, value, timestamp_micros, labels=None):
+        self.value = value
+        self.timestamp_micros = timestamp_micros
+        self.labels = list(labels) if labels is not None else []
+
+    @classmethod
+    def from_pb(cls, cell_pb):
+        """Create a new cell from a Cell protobuf.
+
+        :type cell_pb: :class:`._generated.data_pb2.Cell`
+        :param cell_pb: The protobuf to convert.
+
+        :rtype: :class:`Cell`
+        :returns: The cell corresponding to the protobuf.
+        """
+        if cell_pb.labels:
+            return cls(cell_pb.value, cell_pb.timestamp_micros, labels=cell_pb.labels)
+        else:
+            return cls(cell_pb.value, cell_pb.timestamp_micros)
+
+    @property
+    def timestamp(self):
+        return _datetime_from_microseconds(self.timestamp_micros)
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (
+            other.value == self.value
+            and other.timestamp_micros == self.timestamp_micros
+            and other.labels == self.labels
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __repr__(self):
+        return "<{name} value={value!r} timestamp={timestamp}>".format(
+            name=self.__class__.__name__, value=self.value, timestamp=self.timestamp
+        )
+
+
+class PartialCellData(object):
+    """Representation of partial cell in a Google Cloud Bigtable Table.
+
+    These are expected to be updated directly from a
+    :class:`._generated.bigtable_service_messages_pb2.ReadRowsResponse`
+
+    :type row_key: bytes
+    :param row_key: The key for the row holding the (partial) cell.
+
+    :type family_name: str
+    :param family_name: The family name of the (partial) cell.
+
+    :type qualifier: bytes
+    :param qualifier: The column qualifier of the (partial) cell.
+
+    :type timestamp_micros: int
+    :param timestamp_micros: The timestamp (in microsecods) of the
+                             (partial) cell.
+
+    :type labels: list of str
+    :param labels: labels assigned to the (partial) cell
+
+    :type value: bytes
+    :param value: The (accumulated) value of the (partial) cell.
+    """
+
+    def __init__(
+        self, row_key, family_name, qualifier, timestamp_micros, labels=(), value=b""
+    ):
+        self.row_key = row_key
+        self.family_name = family_name
+        self.qualifier = qualifier
+        self.timestamp_micros = timestamp_micros
+        self.labels = labels
+        self.value = value
+
+    def append_value(self, value):
+        """Append bytes from a new chunk to value.
+
+        :type value: bytes
+        :param value: bytes to append
+        """
+        self.value += value
+
+
+class PartialRowData(object):
+    """Representation of partial row in a Google Cloud Bigtable Table.
+
+    These are expected to be updated directly from a
+    :class:`._generated.bigtable_service_messages_pb2.ReadRowsResponse`
+
+    :type row_key: bytes
+    :param row_key: The key for the row holding the (partial) data.
+    """
+
+    def __init__(self, row_key):
+        self._row_key = row_key
+        self._cells = {}
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return other._row_key == self._row_key and other._cells == self._cells
+
+    def __ne__(self, other):
+        return not self == other
+
+    def to_dict(self):
+        """Convert the cells to a dictionary.
+
+        This is intended to be used with HappyBase, so the column family and
+        column qualiers are combined (with ``:``).
+
+        :rtype: dict
+        :returns: Dictionary containing all the data in the cells of this row.
+        """
+        result = {}
+        for column_family_id, columns in six.iteritems(self._cells):
+            for column_qual, cells in six.iteritems(columns):
+                key = _to_bytes(column_family_id) + b":" + _to_bytes(column_qual)
+                result[key] = cells
+        return result
+
+    @property
+    def cells(self):
+        """Property returning all the cells accumulated on this partial row.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_data_cells]
+            :end-before: [END bigtable_row_data_cells]
+
+        :rtype: dict
+        :returns: Dictionary of the :class:`Cell` objects accumulated. This
+                  dictionary has two-levels of keys (first for column families
+                  and second for column names/qualifiers within a family). For
+                  a given column, a list of :class:`Cell` objects is stored.
+        """
+        return self._cells
+
+    @property
+    def row_key(self):
+        """Getter for the current (partial) row's key.
+
+        :rtype: bytes
+        :returns: The current (partial) row's key.
+        """
+        return self._row_key
+
+    def find_cells(self, column_family_id, column):
+        """Get a time series of cells stored on this instance.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_find_cells]
+            :end-before: [END bigtable_row_find_cells]
+
+        Args:
+            column_family_id (str): The ID of the column family. Must be of the
+                form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+            column (bytes): The column within the column family where the cells
+                are located.
+
+        Returns:
+            List[~google.cloud.bigtable.row_data.Cell]: The cells stored in the
+            specified column.
+
+        Raises:
+            KeyError: If ``column_family_id`` is not among the cells stored
+                in this row.
+            KeyError: If ``column`` is not among the cells stored in this row
+                for the given ``column_family_id``.
+        """
+        try:
+            column_family = self._cells[column_family_id]
+        except KeyError:
+            raise KeyError(_MISSING_COLUMN_FAMILY.format(column_family_id))
+
+        try:
+            cells = column_family[column]
+        except KeyError:
+            raise KeyError(_MISSING_COLUMN.format(column, column_family_id))
+
+        return cells
+
+    def cell_value(self, column_family_id, column, index=0):
+        """Get a single cell value stored on this instance.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_cell_value]
+            :end-before: [END bigtable_row_cell_value]
+
+        Args:
+            column_family_id (str): The ID of the column family. Must be of the
+                form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+            column (bytes): The column within the column family where the cell
+                is located.
+            index (Optional[int]): The offset within the series of values. If
+                not specified, will return the first cell.
+
+        Returns:
+            ~google.cloud.bigtable.row_data.Cell value: The cell value stored
+            in the specified column and specified index.
+
+        Raises:
+            KeyError: If ``column_family_id`` is not among the cells stored
+                in this row.
+            KeyError: If ``column`` is not among the cells stored in this row
+                for the given ``column_family_id``.
+            IndexError: If ``index`` cannot be found within the cells stored
+                in this row for the given ``column_family_id``, ``column``
+                pair.
+        """
+        cells = self.find_cells(column_family_id, column)
+
+        try:
+            cell = cells[index]
+        except (TypeError, IndexError):
+            num_cells = len(cells)
+            msg = _MISSING_INDEX.format(index, column, column_family_id, num_cells)
+            raise IndexError(msg)
+
+        return cell.value
+
+    def cell_values(self, column_family_id, column, max_count=None):
+        """Get a time series of cells stored on this instance.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_cell_values]
+            :end-before: [END bigtable_row_cell_values]
+
+        Args:
+            column_family_id (str): The ID of the column family. Must be of the
+                form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+            column (bytes): The column within the column family where the cells
+                are located.
+            max_count (int): The maximum number of cells to use.
+
+        Returns:
+            A generator which provides: cell.value, cell.timestamp_micros
+                for each cell in the list of cells
+
+        Raises:
+            KeyError: If ``column_family_id`` is not among the cells stored
+                in this row.
+            KeyError: If ``column`` is not among the cells stored in this row
+                for the given ``column_family_id``.
+        """
+        cells = self.find_cells(column_family_id, column)
+        if max_count is None:
+            max_count = len(cells)
+
+        for index, cell in enumerate(cells):
+            if index == max_count:
+                break
+
+            yield cell.value, cell.timestamp_micros
+
+
+class InvalidReadRowsResponse(RuntimeError):
+    """Exception raised to to invalid response data from back-end."""
+
+
+class InvalidChunk(RuntimeError):
+    """Exception raised to to invalid chunk data from back-end."""
+
+
+def _retry_read_rows_exception(exc):
+    if isinstance(exc, grpc.RpcError):
+        exc = exceptions.from_grpc_error(exc)
+    return isinstance(exc, (exceptions.ServiceUnavailable, exceptions.DeadlineExceeded))
+
+
+DEFAULT_RETRY_READ_ROWS = retry.Retry(
+    predicate=_retry_read_rows_exception,
+    initial=1.0,
+    maximum=15.0,
+    multiplier=2.0,
+    deadline=60.0,  # 60 seconds
+)
+"""The default retry strategy to be used on retry-able errors.
+
+Used by
+:meth:`~google.cloud.bigtable.row_data.PartialRowsData._read_next_response`.
+"""
+
+
+class PartialRowsData(object):
+    """Convenience wrapper for consuming a ``ReadRows`` streaming response.
+
+    :type read_method: :class:`client._table_data_client.read_rows`
+    :param read_method: ``ReadRows`` method.
+
+    :type request: :class:`data_messages_v2_pb2.ReadRowsRequest`
+    :param request: The ``ReadRowsRequest`` message used to create a
+                    ReadRowsResponse iterator. If the iterator fails, a new
+                    iterator is created, allowing the scan to continue from
+                    the point just beyond the last successfully read row,
+                    identified by self.last_scanned_row_key. The retry happens
+                    inside of the Retry class, using a predicate for the
+                    expected exceptions during iteration.
+
+    :type retry: :class:`~google.api_core.retry.Retry`
+    :param retry: (Optional) Retry delay and deadline arguments. To override,
+                  the default value :attr:`DEFAULT_RETRY_READ_ROWS` can be
+                  used and modified with the
+                  :meth:`~google.api_core.retry.Retry.with_delay` method
+                  or the
+                  :meth:`~google.api_core.retry.Retry.with_deadline` method.
+    """
+
+    NEW_ROW = "New row"  # No cells yet complete for row
+    ROW_IN_PROGRESS = "Row in progress"  # Some cells complete for row
+    CELL_IN_PROGRESS = "Cell in progress"  # Incomplete cell for row
+
+    STATE_NEW_ROW = 1
+    STATE_ROW_IN_PROGRESS = 2
+    STATE_CELL_IN_PROGRESS = 3
+
+    read_states = {
+        STATE_NEW_ROW: NEW_ROW,
+        STATE_ROW_IN_PROGRESS: ROW_IN_PROGRESS,
+        STATE_CELL_IN_PROGRESS: CELL_IN_PROGRESS,
+    }
+
+    def __init__(self, read_method, request, retry=DEFAULT_RETRY_READ_ROWS):
+        # Counter for rows returned to the user
+        self._counter = 0
+        # In-progress row, unset until first response, after commit/reset
+        self._row = None
+        # Last complete row, unset until first commit
+        self._previous_row = None
+        # In-progress cell, unset until first response, after completion
+        self._cell = None
+        # Last complete cell, unset until first completion, after new row
+        self._previous_cell = None
+
+        # May be cached from previous response
+        self.last_scanned_row_key = None
+        self.read_method = read_method
+        self.request = request
+        self.retry = retry
+        self.response_iterator = read_method(request)
+
+        self.rows = {}
+        self._state = self.STATE_NEW_ROW
+
+        # Flag to stop iteration, for any reason not related to self.retry()
+        self._cancelled = False
+
+    @property
+    def state(self):
+        """State machine state.
+
+        :rtype: str
+        :returns:  name of state corresponding to current row / chunk
+                   processing.
+        """
+        return self.read_states[self._state]
+
+    def cancel(self):
+        """Cancels the iterator, closing the stream."""
+        self._cancelled = True
+        self.response_iterator.cancel()
+
+    def consume_all(self, max_loops=None):
+        """Consume the streamed responses until there are no more.
+
+        .. warning::
+           This method will be removed in future releases.  Please use this
+           class as a generator instead.
+
+        :type max_loops: int
+        :param max_loops: (Optional) Maximum number of times to try to consume
+                          an additional ``ReadRowsResponse``. You can use this
+                          to avoid long wait times.
+        """
+        for row in self:
+            self.rows[row.row_key] = row
+
+    def _create_retry_request(self):
+        """Helper for :meth:`__iter__`."""
+        req_manager = _ReadRowsRequestManager(
+            self.request, self.last_scanned_row_key, self._counter
+        )
+        return req_manager.build_updated_request()
+
+    def _on_error(self, exc):
+        """Helper for :meth:`__iter__`."""
+        # restart the read scan from AFTER the last successfully read row
+        retry_request = self.request
+        if self.last_scanned_row_key:
+            retry_request = self._create_retry_request()
+
+        self.response_iterator = self.read_method(retry_request)
+
+    def _read_next(self):
+        """Helper for :meth:`__iter__`."""
+        return six.next(self.response_iterator)
+
+    def _read_next_response(self):
+        """Helper for :meth:`__iter__`."""
+        return self.retry(self._read_next, on_error=self._on_error)()
+
+    def __iter__(self):
+        """Consume the ``ReadRowsResponse`` s from the stream.
+        Read the rows and yield each to the reader
+
+        Parse the response and its chunks into a new/existing row in
+        :attr:`_rows`. Rows are returned in order by row key.
+        """
+        while not self._cancelled:
+            try:
+                response = self._read_next_response()
+            except StopIteration:
+                if self.state != self.NEW_ROW:
+                    raise ValueError("The row remains partial / is not committed.")
+                break
+
+            for chunk in response.chunks:
+                if self._cancelled:
+                    break
+                self._process_chunk(chunk)
+                if chunk.commit_row:
+                    self.last_scanned_row_key = self._previous_row.row_key
+                    self._counter += 1
+                    yield self._previous_row
+
+            resp_last_key = response.last_scanned_row_key
+            if resp_last_key and resp_last_key > self.last_scanned_row_key:
+                self.last_scanned_row_key = resp_last_key
+
+    def _process_chunk(self, chunk):
+        if chunk.reset_row:
+            self._validate_chunk_reset_row(chunk)
+            self._row = None
+            self._cell = self._previous_cell = None
+            self._state = self.STATE_NEW_ROW
+            return
+
+        self._update_cell(chunk)
+
+        if self._row is None:
+            if (
+                self._previous_row is not None
+                and self._cell.row_key <= self._previous_row.row_key
+            ):
+                raise InvalidChunk()
+            self._row = PartialRowData(self._cell.row_key)
+
+        if chunk.value_size == 0:
+            self._state = self.STATE_ROW_IN_PROGRESS
+            self._save_current_cell()
+        else:
+            self._state = self.STATE_CELL_IN_PROGRESS
+
+        if chunk.commit_row:
+            if chunk.value_size > 0:
+                raise InvalidChunk()
+
+            self._previous_row = self._row
+            self._row = None
+            self._previous_cell = None
+            self._state = self.STATE_NEW_ROW
+
+    def _update_cell(self, chunk):
+        if self._cell is None:
+            qualifier = None
+            if chunk.HasField("qualifier"):
+                qualifier = chunk.qualifier.value
+            family = None
+            if chunk.HasField("family_name"):
+                family = chunk.family_name.value
+
+            self._cell = PartialCellData(
+                chunk.row_key,
+                family,
+                qualifier,
+                chunk.timestamp_micros,
+                chunk.labels,
+                chunk.value,
+            )
+            self._copy_from_previous(self._cell)
+            self._validate_cell_data_new_cell()
+        else:
+            self._cell.append_value(chunk.value)
+
+    def _validate_cell_data_new_cell(self):
+        cell = self._cell
+        if not cell.row_key or not cell.family_name or cell.qualifier is None:
+            raise InvalidChunk()
+
+        prev = self._previous_cell
+        if prev and prev.row_key != cell.row_key:
+            raise InvalidChunk()
+
+    def _validate_chunk_reset_row(self, chunk):
+        # No reset for new row
+        _raise_if(self._state == self.STATE_NEW_ROW)
+
+        # No reset with other keys
+        _raise_if(chunk.row_key)
+        _raise_if(chunk.HasField("family_name"))
+        _raise_if(chunk.HasField("qualifier"))
+        _raise_if(chunk.timestamp_micros)
+        _raise_if(chunk.labels)
+        _raise_if(chunk.value_size)
+        _raise_if(chunk.value)
+        _raise_if(chunk.commit_row)
+
+    def _save_current_cell(self):
+        """Helper for :meth:`consume_next`."""
+        row, cell = self._row, self._cell
+        family = row._cells.setdefault(cell.family_name, {})
+        qualified = family.setdefault(cell.qualifier, [])
+        complete = Cell.from_pb(cell)
+        qualified.append(complete)
+        self._cell, self._previous_cell = None, cell
+
+    def _copy_from_previous(self, cell):
+        """Helper for :meth:`consume_next`."""
+        previous = self._previous_cell
+        if previous is not None:
+            if not cell.row_key:
+                cell.row_key = previous.row_key
+                if not cell.family_name:
+                    cell.family_name = previous.family_name
+                    # NOTE: ``cell.qualifier`` **can** be empty string.
+                    if cell.qualifier is None:
+                        cell.qualifier = previous.qualifier
+
+
+class _ReadRowsRequestManager(object):
+    """ Update the ReadRowsRequest message in case of failures by
+        filtering the already read keys.
+
+    :type message: class:`data_messages_v2_pb2.ReadRowsRequest`
+    :param message: Original ReadRowsRequest containing all of the parameters
+                    of API call
+
+    :type last_scanned_key: bytes
+    :param last_scanned_key: last successfully scanned key
+
+    :type rows_read_so_far: int
+    :param rows_read_so_far: total no of rows successfully read so far.
+                            this will be used for updating rows_limit
+
+    """
+
+    def __init__(self, message, last_scanned_key, rows_read_so_far):
+        self.message = message
+        self.last_scanned_key = last_scanned_key
+        self.rows_read_so_far = rows_read_so_far
+
+    def build_updated_request(self):
+        """ Updates the given message request as per last scanned key
+        """
+        r_kwargs = {
+            "table_name": self.message.table_name,
+            "filter": self.message.filter,
+        }
+
+        if self.message.rows_limit != 0:
+            r_kwargs["rows_limit"] = max(
+                1, self.message.rows_limit - self.rows_read_so_far
+            )
+
+        # if neither RowSet.row_keys nor RowSet.row_ranges currently exist,
+        # add row_range that starts with last_scanned_key as start_key_open
+        # to request only rows that have not been returned yet
+        if not self.message.HasField("rows"):
+            row_range = data_v2_pb2.RowRange(start_key_open=self.last_scanned_key)
+            r_kwargs["rows"] = data_v2_pb2.RowSet(row_ranges=[row_range])
+        else:
+            row_keys = self._filter_rows_keys()
+            row_ranges = self._filter_row_ranges()
+            r_kwargs["rows"] = data_v2_pb2.RowSet(
+                row_keys=row_keys, row_ranges=row_ranges
+            )
+        return data_messages_v2_pb2.ReadRowsRequest(**r_kwargs)
+
+    def _filter_rows_keys(self):
+        """ Helper for :meth:`build_updated_request`"""
+        return [
+            row_key
+            for row_key in self.message.rows.row_keys
+            if row_key > self.last_scanned_key
+        ]
+
+    def _filter_row_ranges(self):
+        """ Helper for :meth:`build_updated_request`"""
+        new_row_ranges = []
+
+        for row_range in self.message.rows.row_ranges:
+            # if current end_key (open or closed) is set, return its value,
+            # if not, set to empty string ('').
+            # NOTE: Empty string in end_key means "end of table"
+            end_key = self._end_key_set(row_range)
+            # if end_key is already read, skip to the next row_range
+            if end_key and self._key_already_read(end_key):
+                continue
+
+            # if current start_key (open or closed) is set, return its value,
+            # if not, then set to empty string ('')
+            # NOTE: Empty string in start_key means "beginning of table"
+            start_key = self._start_key_set(row_range)
+
+            # if start_key was already read or doesn't exist,
+            # create a row_range with last_scanned_key as start_key_open
+            # to be passed to retry request
+            retry_row_range = row_range
+            if self._key_already_read(start_key):
+                retry_row_range = copy.deepcopy(row_range)
+                retry_row_range.start_key_closed = _to_bytes("")
+                retry_row_range.start_key_open = self.last_scanned_key
+
+            new_row_ranges.append(retry_row_range)
+
+        return new_row_ranges
+
+    def _key_already_read(self, key):
+        """ Helper for :meth:`_filter_row_ranges`"""
+        return key <= self.last_scanned_key
+
+    @staticmethod
+    def _start_key_set(row_range):
+        """ Helper for :meth:`_filter_row_ranges`"""
+        return row_range.start_key_open or row_range.start_key_closed
+
+    @staticmethod
+    def _end_key_set(row_range):
+        """ Helper for :meth:`_filter_row_ranges`"""
+        return row_range.end_key_open or row_range.end_key_closed
+
+
+def _raise_if(predicate, *args):
+    """Helper for validation methods."""
+    if predicate:
+        raise InvalidChunk(*args)
diff --git a/google/cloud/bigtable/row_filters.py b/bigtable/google/cloud/bigtable/row_filters.py
similarity index 85%
rename from google/cloud/bigtable/row_filters.py
rename to bigtable/google/cloud/bigtable/row_filters.py
index 86a5957a3699..e8a70a9f4add 100644
--- a/google/cloud/bigtable/row_filters.py
+++ b/bigtable/google/cloud/bigtable/row_filters.py
@@ -1,4 +1,4 @@
-# Copyright 2016 Google Inc. All rights reserved.
+# Copyright 2016 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,8 +17,7 @@
 
 from google.cloud._helpers import _microseconds_from_datetime
 from google.cloud._helpers import _to_bytes
-from google.cloud.bigtable._generated import (
-    data_pb2 as data_v2_pb2)
+from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
 
 
 class RowFilter(object):
@@ -32,9 +31,6 @@ class RowFilter(object):
         This class is a do-nothing base class for all row filters.
     """
 
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
 
 class _BoolFilter(RowFilter):
     """Row filter that uses a boolean flag.
@@ -48,9 +44,12 @@ def __init__(self, flag):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.flag == self.flag
 
+    def __ne__(self, other):
+        return not self == other
+
 
 class SinkFilter(_BoolFilter):
     """Advanced row filter to skip parent filters.
@@ -124,9 +123,12 @@ def __init__(self, regex):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.regex == self.regex
 
+    def __ne__(self, other):
+        return not self == other
+
 
 class RowKeyRegexFilter(_RegexFilter):
     """Row filter for a row key regular expression.
@@ -165,7 +167,7 @@ class RowSampleFilter(RowFilter):
 
     :type sample: float
     :param sample: The probability of matching a cell (must be in the
-                   interval ``[0, 1]``).
+                   interval ``(0, 1)``  The end points are excluded).
     """
 
     def __init__(self, sample):
@@ -173,9 +175,12 @@ def __init__(self, sample):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.sample == self.sample
 
+    def __ne__(self, other):
+        return not self == other
+
     def to_pb(self):
         """Converts the row filter to a protobuf.
 
@@ -257,12 +262,11 @@ def __init__(self, start=None, end=None):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
-        return (other.start == self.start and
-                other.end == self.end)
+            return NotImplemented
+        return other.start == self.start and other.end == self.end
 
     def __ne__(self, other):
-        return not self.__eq__(other)
+        return not self == other
 
     def to_pb(self):
         """Converts the :class:`TimestampRange` to a protobuf.
@@ -272,11 +276,14 @@ def to_pb(self):
         """
         timestamp_range_kwargs = {}
         if self.start is not None:
-            timestamp_range_kwargs['start_timestamp_micros'] = (
-                _microseconds_from_datetime(self.start))
+            timestamp_range_kwargs["start_timestamp_micros"] = (
+                _microseconds_from_datetime(self.start) // 1000 * 1000
+            )
         if self.end is not None:
-            timestamp_range_kwargs['end_timestamp_micros'] = (
-                _microseconds_from_datetime(self.end))
+            end_time = _microseconds_from_datetime(self.end)
+            if end_time % 1000 != 0:
+                end_time = end_time // 1000 * 1000 + 1000
+            timestamp_range_kwargs["end_timestamp_micros"] = end_time
         return data_v2_pb2.TimestampRange(**timestamp_range_kwargs)
 
 
@@ -292,9 +299,12 @@ def __init__(self, range_):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.range_ == self.range_
 
+    def __ne__(self, other):
+        return not self == other
+
     def to_pb(self):
         """Converts the row filter to a protobuf.
 
@@ -304,8 +314,7 @@ def to_pb(self):
         :rtype: :class:`.data_v2_pb2.RowFilter`
         :returns: The converted current object.
         """
-        return data_v2_pb2.RowFilter(
-            timestamp_range_filter=self.range_.to_pb())
+        return data_v2_pb2.RowFilter(timestamp_range_filter=self.range_.to_pb())
 
 
 class ColumnRangeFilter(RowFilter):
@@ -345,34 +354,47 @@ class ColumnRangeFilter(RowFilter):
              is set but no ``end_column`` is given
     """
 
-    def __init__(self, column_family_id, start_column=None, end_column=None,
-                 inclusive_start=None, inclusive_end=None):
+    def __init__(
+        self,
+        column_family_id,
+        start_column=None,
+        end_column=None,
+        inclusive_start=None,
+        inclusive_end=None,
+    ):
         self.column_family_id = column_family_id
 
         if inclusive_start is None:
             inclusive_start = True
         elif start_column is None:
-            raise ValueError('Inclusive start was specified but no '
-                             'start column was given.')
+            raise ValueError(
+                "Inclusive start was specified but no " "start column was given."
+            )
         self.start_column = start_column
         self.inclusive_start = inclusive_start
 
         if inclusive_end is None:
             inclusive_end = True
         elif end_column is None:
-            raise ValueError('Inclusive end was specified but no '
-                             'end column was given.')
+            raise ValueError(
+                "Inclusive end was specified but no " "end column was given."
+            )
         self.end_column = end_column
         self.inclusive_end = inclusive_end
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
-        return (other.column_family_id == self.column_family_id and
-                other.start_column == self.start_column and
-                other.end_column == self.end_column and
-                other.inclusive_start == self.inclusive_start and
-                other.inclusive_end == self.inclusive_end)
+            return NotImplemented
+        return (
+            other.column_family_id == self.column_family_id
+            and other.start_column == self.start_column
+            and other.end_column == self.end_column
+            and other.inclusive_start == self.inclusive_start
+            and other.inclusive_end == self.inclusive_end
+        )
+
+    def __ne__(self, other):
+        return not self == other
 
     def to_pb(self):
         """Converts the row filter to a protobuf.
@@ -383,18 +405,18 @@ def to_pb(self):
         :rtype: :class:`.data_v2_pb2.RowFilter`
         :returns: The converted current object.
         """
-        column_range_kwargs = {'family_name': self.column_family_id}
+        column_range_kwargs = {"family_name": self.column_family_id}
         if self.start_column is not None:
             if self.inclusive_start:
-                key = 'start_qualifier_closed'
+                key = "start_qualifier_closed"
             else:
-                key = 'start_qualifier_open'
+                key = "start_qualifier_open"
             column_range_kwargs[key] = _to_bytes(self.start_column)
         if self.end_column is not None:
             if self.inclusive_end:
-                key = 'end_qualifier_closed'
+                key = "end_qualifier_closed"
             else:
-                key = 'end_qualifier_open'
+                key = "end_qualifier_open"
             column_range_kwargs[key] = _to_bytes(self.end_column)
 
         column_range = data_v2_pb2.ColumnRange(**column_range_kwargs)
@@ -465,31 +487,39 @@ class ValueRangeFilter(RowFilter):
              is set but no ``end_value`` is given
     """
 
-    def __init__(self, start_value=None, end_value=None,
-                 inclusive_start=None, inclusive_end=None):
+    def __init__(
+        self, start_value=None, end_value=None, inclusive_start=None, inclusive_end=None
+    ):
         if inclusive_start is None:
             inclusive_start = True
         elif start_value is None:
-            raise ValueError('Inclusive start was specified but no '
-                             'start value was given.')
+            raise ValueError(
+                "Inclusive start was specified but no " "start value was given."
+            )
         self.start_value = start_value
         self.inclusive_start = inclusive_start
 
         if inclusive_end is None:
             inclusive_end = True
         elif end_value is None:
-            raise ValueError('Inclusive end was specified but no '
-                             'end value was given.')
+            raise ValueError(
+                "Inclusive end was specified but no " "end value was given."
+            )
         self.end_value = end_value
         self.inclusive_end = inclusive_end
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
-        return (other.start_value == self.start_value and
-                other.end_value == self.end_value and
-                other.inclusive_start == self.inclusive_start and
-                other.inclusive_end == self.inclusive_end)
+            return NotImplemented
+        return (
+            other.start_value == self.start_value
+            and other.end_value == self.end_value
+            and other.inclusive_start == self.inclusive_start
+            and other.inclusive_end == self.inclusive_end
+        )
+
+    def __ne__(self, other):
+        return not self == other
 
     def to_pb(self):
         """Converts the row filter to a protobuf.
@@ -503,15 +533,15 @@ def to_pb(self):
         value_range_kwargs = {}
         if self.start_value is not None:
             if self.inclusive_start:
-                key = 'start_value_closed'
+                key = "start_value_closed"
             else:
-                key = 'start_value_open'
+                key = "start_value_open"
             value_range_kwargs[key] = _to_bytes(self.start_value)
         if self.end_value is not None:
             if self.inclusive_end:
-                key = 'end_value_closed'
+                key = "end_value_closed"
             else:
-                key = 'end_value_open'
+                key = "end_value_open"
             value_range_kwargs[key] = _to_bytes(self.end_value)
 
         value_range = data_v2_pb2.ValueRange(**value_range_kwargs)
@@ -533,9 +563,12 @@ def __init__(self, num_cells):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.num_cells == self.num_cells
 
+    def __ne__(self, other):
+        return not self == other
+
 
 class CellsRowOffsetFilter(_CellCountFilter):
     """Row filter to skip cells in a row.
@@ -550,8 +583,7 @@ def to_pb(self):
         :rtype: :class:`.data_v2_pb2.RowFilter`
         :returns: The converted current object.
         """
-        return data_v2_pb2.RowFilter(
-            cells_per_row_offset_filter=self.num_cells)
+        return data_v2_pb2.RowFilter(cells_per_row_offset_filter=self.num_cells)
 
 
 class CellsRowLimitFilter(_CellCountFilter):
@@ -585,8 +617,7 @@ def to_pb(self):
         :rtype: :class:`.data_v2_pb2.RowFilter`
         :returns: The converted current object.
         """
-        return data_v2_pb2.RowFilter(
-            cells_per_column_limit_filter=self.num_cells)
+        return data_v2_pb2.RowFilter(cells_per_column_limit_filter=self.num_cells)
 
 
 class StripValueTransformerFilter(_BoolFilter):
@@ -631,9 +662,12 @@ def __init__(self, label):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.label == self.label
 
+    def __ne__(self, other):
+        return not self == other
+
     def to_pb(self):
         """Converts the row filter to a protobuf.
 
@@ -661,9 +695,12 @@ def __init__(self, filters=None):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
+            return NotImplemented
         return other.filters == self.filters
 
+    def __ne__(self, other):
+        return not self == other
+
 
 class RowFilterChain(_FilterCombination):
     """Chain of row filters.
@@ -683,7 +720,8 @@ def to_pb(self):
         :returns: The converted current object.
         """
         chain = data_v2_pb2.RowFilter.Chain(
-            filters=[row_filter.to_pb() for row_filter in self.filters])
+            filters=[row_filter.to_pb() for row_filter in self.filters]
+        )
         return data_v2_pb2.RowFilter(chain=chain)
 
 
@@ -707,7 +745,8 @@ def to_pb(self):
         :returns: The converted current object.
         """
         interleave = data_v2_pb2.RowFilter.Interleave(
-            filters=[row_filter.to_pb() for row_filter in self.filters])
+            filters=[row_filter.to_pb() for row_filter in self.filters]
+        )
         return data_v2_pb2.RowFilter(interleave=interleave)
 
 
@@ -748,10 +787,15 @@ def __init__(self, base_filter, true_filter=None, false_filter=None):
 
     def __eq__(self, other):
         if not isinstance(other, self.__class__):
-            return False
-        return (other.base_filter == self.base_filter and
-                other.true_filter == self.true_filter and
-                other.false_filter == self.false_filter)
+            return NotImplemented
+        return (
+            other.base_filter == self.base_filter
+            and other.true_filter == self.true_filter
+            and other.false_filter == self.false_filter
+        )
+
+    def __ne__(self, other):
+        return not self == other
 
     def to_pb(self):
         """Converts the row filter to a protobuf.
@@ -759,10 +803,10 @@ def to_pb(self):
         :rtype: :class:`.data_v2_pb2.RowFilter`
         :returns: The converted current object.
         """
-        condition_kwargs = {'predicate_filter': self.base_filter.to_pb()}
+        condition_kwargs = {"predicate_filter": self.base_filter.to_pb()}
         if self.true_filter is not None:
-            condition_kwargs['true_filter'] = self.true_filter.to_pb()
+            condition_kwargs["true_filter"] = self.true_filter.to_pb()
         if self.false_filter is not None:
-            condition_kwargs['false_filter'] = self.false_filter.to_pb()
+            condition_kwargs["false_filter"] = self.false_filter.to_pb()
         condition = data_v2_pb2.RowFilter.Condition(**condition_kwargs)
         return data_v2_pb2.RowFilter(condition=condition)
diff --git a/bigtable/google/cloud/bigtable/row_set.py b/bigtable/google/cloud/bigtable/row_set.py
new file mode 100644
index 000000000000..0cb6443b05eb
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/row_set.py
@@ -0,0 +1,192 @@
+# 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.
+
+"""User-friendly container for Google Cloud Bigtable RowSet """
+
+
+from google.cloud._helpers import _to_bytes
+
+
+class RowSet(object):
+    """ Convenience wrapper of google.bigtable.v2.RowSet
+
+        Useful for creating a set of row keys and row ranges, which can
+        be passed to yield_rows method of class:`.Table.yield_rows`.
+    """
+
+    def __init__(self):
+        self.row_keys = []
+        self.row_ranges = []
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+
+        if len(other.row_keys) != len(self.row_keys):
+            return False
+
+        if len(other.row_ranges) != len(self.row_ranges):
+            return False
+
+        if not set(other.row_keys) == set(self.row_keys):
+            return False
+
+        if not set(other.row_ranges) == set(self.row_ranges):
+            return False
+
+        return True
+
+    def __ne__(self, other):
+        return not self == other
+
+    def add_row_key(self, row_key):
+        """Add row key to row_keys list.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_add_row_key]
+            :end-before: [END bigtable_add_row_key]
+
+        :type row_key: bytes
+        :param row_key: The key of a row to read
+        """
+        self.row_keys.append(row_key)
+
+    def add_row_range(self, row_range):
+        """Add row_range to row_ranges list.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_add_row_range]
+            :end-before: [END bigtable_add_row_range]
+
+        :type row_range: class:`RowRange`
+        :param row_range: The row range object having start and end key
+        """
+        self.row_ranges.append(row_range)
+
+    def add_row_range_from_keys(
+        self, start_key=None, end_key=None, start_inclusive=True, end_inclusive=False
+    ):
+        """Add row range to row_ranges list from the row keys
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_row_range_from_keys]
+            :end-before: [END bigtable_row_range_from_keys]
+
+        :type start_key: bytes
+        :param start_key: (Optional) Start key of the row range. If left empty,
+                          will be interpreted as the empty string.
+
+        :type end_key: bytes
+        :param end_key: (Optional) End key of the row range. If left empty,
+                        will be interpreted as the empty string and range will
+                        be unbounded on the high end.
+
+        :type start_inclusive: bool
+        :param start_inclusive: (Optional) Whether the ``start_key`` should be
+                        considered inclusive. The default is True (inclusive).
+
+        :type end_inclusive: bool
+        :param end_inclusive: (Optional) Whether the ``end_key`` should be
+                  considered inclusive. The default is False (exclusive).
+        """
+        row_range = RowRange(start_key, end_key, start_inclusive, end_inclusive)
+        self.row_ranges.append(row_range)
+
+    def _update_message_request(self, message):
+        """Add row keys and row range to given request message
+
+        :type message: class:`data_messages_v2_pb2.ReadRowsRequest`
+        :param message: The ``ReadRowsRequest`` protobuf
+        """
+        for each in self.row_keys:
+            message.rows.row_keys.append(_to_bytes(each))
+
+        for each in self.row_ranges:
+            r_kwrags = each.get_range_kwargs()
+            message.rows.row_ranges.add(**r_kwrags)
+
+
+class RowRange(object):
+    """ Convenience wrapper of google.bigtable.v2.RowRange
+
+    :type start_key: bytes
+    :param start_key: (Optional) Start key of the row range. If left empty,
+                      will be interpreted as the empty string.
+
+    :type end_key: bytes
+    :param end_key: (Optional) End key of the row range. If left empty,
+                    will be interpreted as the empty string and range will
+                    be unbounded on the high end.
+
+    :type start_inclusive: bool
+    :param start_inclusive: (Optional) Whether the ``start_key`` should be
+                  considered inclusive. The default is True (inclusive).
+
+    :type end_inclusive: bool
+    :param end_inclusive: (Optional) Whether the ``end_key`` should be
+                  considered inclusive. The default is False (exclusive).
+    """
+
+    def __init__(
+        self, start_key=None, end_key=None, start_inclusive=True, end_inclusive=False
+    ):
+        self.start_key = start_key
+        self.start_inclusive = start_inclusive
+        self.end_key = end_key
+        self.end_inclusive = end_inclusive
+
+    def _key(self):
+        """A tuple key that uniquely describes this field.
+
+        Used to compute this instance's hashcode and evaluate equality.
+
+        Returns:
+            Tuple[str]: The contents of this :class:`.RowRange`.
+        """
+        return (self.start_key, self.start_inclusive, self.end_key, self.end_inclusive)
+
+    def __hash__(self):
+        return hash(self._key())
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._key() == other._key()
+
+    def __ne__(self, other):
+        return not self == other
+
+    def get_range_kwargs(self):
+        """ Convert row range object to dict which can be passed to
+        google.bigtable.v2.RowRange add method.
+        """
+        range_kwargs = {}
+        if self.start_key is not None:
+            start_key_key = "start_key_open"
+            if self.start_inclusive:
+                start_key_key = "start_key_closed"
+            range_kwargs[start_key_key] = _to_bytes(self.start_key)
+
+        if self.end_key is not None:
+            end_key_key = "end_key_open"
+            if self.end_inclusive:
+                end_key_key = "end_key_closed"
+            range_kwargs[end_key_key] = _to_bytes(self.end_key)
+        return range_kwargs
diff --git a/bigtable/google/cloud/bigtable/table.py b/bigtable/google/cloud/bigtable/table.py
new file mode 100644
index 000000000000..4ced9fbde0c2
--- /dev/null
+++ b/bigtable/google/cloud/bigtable/table.py
@@ -0,0 +1,1064 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""User-friendly container for Google Cloud Bigtable Table."""
+
+
+from grpc import StatusCode
+
+from google.api_core import timeout
+from google.api_core.exceptions import RetryError
+from google.api_core.exceptions import NotFound
+from google.api_core.retry import if_exception_type
+from google.api_core.retry import Retry
+from google.api_core.gapic_v1.method import wrap_method
+from google.cloud._helpers import _to_bytes
+from google.cloud.bigtable.column_family import _gc_rule_from_pb
+from google.cloud.bigtable.column_family import ColumnFamily
+from google.cloud.bigtable.batcher import MutationsBatcher
+from google.cloud.bigtable.batcher import FLUSH_COUNT, MAX_ROW_BYTES
+from google.cloud.bigtable.row import AppendRow
+from google.cloud.bigtable.row import ConditionalRow
+from google.cloud.bigtable.row import DirectRow
+from google.cloud.bigtable.row_data import PartialRowsData
+from google.cloud.bigtable.row_data import DEFAULT_RETRY_READ_ROWS
+from google.cloud.bigtable.row_set import RowSet
+from google.cloud.bigtable.row_set import RowRange
+from google.cloud.bigtable import enums
+from google.cloud.bigtable_v2.proto import bigtable_pb2 as data_messages_v2_pb2
+from google.cloud.bigtable_admin_v2.proto import table_pb2 as admin_messages_v2_pb2
+from google.cloud.bigtable_admin_v2.proto import (
+    bigtable_table_admin_pb2 as table_admin_messages_v2_pb2,
+)
+
+import warnings
+
+
+# Maximum number of mutations in bulk (MutateRowsRequest message):
+# (https://cloud.google.com/bigtable/docs/reference/data/rpc/
+#  google.bigtable.v2#google.bigtable.v2.MutateRowRequest)
+_MAX_BULK_MUTATIONS = 100000
+VIEW_NAME_ONLY = enums.Table.View.NAME_ONLY
+
+
+class _BigtableRetryableError(Exception):
+    """Retry-able error expected by the default retry strategy."""
+
+
+DEFAULT_RETRY = Retry(
+    predicate=if_exception_type(_BigtableRetryableError),
+    initial=1.0,
+    maximum=15.0,
+    multiplier=2.0,
+    deadline=120.0,  # 2 minutes
+)
+"""The default retry strategy to be used on retry-able errors.
+
+Used by :meth:`~google.cloud.bigtable.table.Table.mutate_rows`.
+"""
+
+
+class TableMismatchError(ValueError):
+    """Row from another table."""
+
+
+class TooManyMutationsError(ValueError):
+    """The number of mutations for bulk request is too big."""
+
+
+class Table(object):
+    """Representation of a Google Cloud Bigtable Table.
+
+    .. note::
+
+        We don't define any properties on a table other than the name.
+        The only other fields are ``column_families`` and ``granularity``,
+        The ``column_families`` are not stored locally and
+        ``granularity`` is an enum with only one value.
+
+    We can use a :class:`Table` to:
+
+    * :meth:`create` the table
+    * :meth:`delete` the table
+    * :meth:`list_column_families` in the table
+
+    :type table_id: str
+    :param table_id: The ID of the table.
+
+    :type instance: :class:`~google.cloud.bigtable.instance.Instance`
+    :param instance: The instance that owns the table.
+
+    :type app_profile_id: str
+    :param app_profile_id: (Optional) The unique name of the AppProfile.
+    """
+
+    def __init__(self, table_id, instance, mutation_timeout=None, app_profile_id=None):
+        self.table_id = table_id
+        self._instance = instance
+        self._app_profile_id = app_profile_id
+        self.mutation_timeout = mutation_timeout
+
+    @property
+    def name(self):
+        """Table name used in requests.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_table_name]
+            :end-before: [END bigtable_table_name]
+
+        .. note::
+
+          This property will not change if ``table_id`` does not, but the
+          return value is not cached.
+
+        The table name is of the form
+
+            ``"projects/../instances/../tables/{table_id}"``
+
+        :rtype: str
+        :returns: The table name.
+        """
+        project = self._instance._client.project
+        instance_id = self._instance.instance_id
+        table_client = self._instance._client.table_data_client
+        return table_client.table_path(
+            project=project, instance=instance_id, table=self.table_id
+        )
+
+    def column_family(self, column_family_id, gc_rule=None):
+        """Factory to create a column family associated with this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_table_column_family]
+            :end-before: [END bigtable_table_column_family]
+
+        :type column_family_id: str
+        :param column_family_id: The ID of the column family. Must be of the
+                                 form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
+
+        :type gc_rule: :class:`.GarbageCollectionRule`
+        :param gc_rule: (Optional) The garbage collection settings for this
+                        column family.
+
+        :rtype: :class:`.ColumnFamily`
+        :returns: A column family owned by this table.
+        """
+        return ColumnFamily(column_family_id, self, gc_rule=gc_rule)
+
+    def row(self, row_key, filter_=None, append=False):
+        """Factory to create a row associated with this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_table_row]
+            :end-before: [END bigtable_table_row]
+
+        .. warning::
+
+           At most one of ``filter_`` and ``append`` can be used in a
+           :class:`~google.cloud.bigtable.row.Row`.
+
+        :type row_key: bytes
+        :param row_key: The key for the row being created.
+
+        :type filter_: :class:`.RowFilter`
+        :param filter_: (Optional) Filter to be used for conditional mutations.
+                        See :class:`.ConditionalRow` for more details.
+
+        :type append: bool
+        :param append: (Optional) Flag to determine if the row should be used
+                       for append mutations.
+
+        :rtype: :class:`~google.cloud.bigtable.row.Row`
+        :returns: A row owned by this table.
+        :raises: :class:`ValueError <exceptions.ValueError>` if both
+                 ``filter_`` and ``append`` are used.
+        """
+        warnings.warn(
+            "This method will be deprecated in future versions. Please "
+            "use Table.append_row(), Table.conditional_row() "
+            "and Table.direct_row() methods instead.",
+            PendingDeprecationWarning,
+            stacklevel=2,
+        )
+
+        if append and filter_ is not None:
+            raise ValueError("At most one of filter_ and append can be set")
+        if append:
+            return AppendRow(row_key, self)
+        elif filter_ is not None:
+            return ConditionalRow(row_key, self, filter_=filter_)
+        else:
+            return DirectRow(row_key, self)
+
+    def append_row(self, row_key):
+        """Create a :class:`~google.cloud.bigtable.row.AppendRow` associated with this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_table_append_row]
+            :end-before: [END bigtable_table_append_row]
+
+        Args:
+            row_key (bytes): The key for the row being created.
+
+        Returns:
+            A row owned by this table.
+        """
+        return AppendRow(row_key, self)
+
+    def direct_row(self, row_key):
+        """Create a :class:`~google.cloud.bigtable.row.DirectRow` associated with this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_table_direct_row]
+            :end-before: [END bigtable_table_direct_row]
+
+        Args:
+            row_key (bytes): The key for the row being created.
+
+        Returns:
+            A row owned by this table.
+        """
+        return DirectRow(row_key, self)
+
+    def conditional_row(self, row_key, filter_):
+        """Create a :class:`~google.cloud.bigtable.row.ConditionalRow` associated with this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_table_conditional_row]
+            :end-before: [END bigtable_table_conditional_row]
+
+        Args:
+            row_key (bytes): The key for the row being created.
+
+            filter_ (:class:`.RowFilter`): (Optional) Filter to be used for
+                conditional mutations. See :class:`.ConditionalRow` for more details.
+
+        Returns:
+            A row owned by this table.
+        """
+        return ConditionalRow(row_key, self, filter_=filter_)
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return other.table_id == self.table_id and other._instance == self._instance
+
+    def __ne__(self, other):
+        return not self == other
+
+    def create(self, initial_split_keys=[], column_families={}):
+        """Creates this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_create_table]
+            :end-before: [END bigtable_create_table]
+
+        .. note::
+
+            A create request returns a
+            :class:`._generated.table_pb2.Table` but we don't use
+            this response.
+
+        :type initial_split_keys: list
+        :param initial_split_keys: (Optional) list of row keys in bytes that
+                                   will be used to initially split the table
+                                   into several tablets.
+
+        :type column_families: dict
+        :param column_failies: (Optional) A map columns to create.  The key is
+                               the column_id str and the value is a
+                               :class:`GarbageCollectionRule`
+        """
+        table_client = self._instance._client.table_admin_client
+        instance_name = self._instance.name
+
+        families = {
+            id: ColumnFamily(id, self, rule).to_pb()
+            for (id, rule) in column_families.items()
+        }
+        table = admin_messages_v2_pb2.Table(column_families=families)
+
+        split = table_admin_messages_v2_pb2.CreateTableRequest.Split
+        splits = [split(key=_to_bytes(key)) for key in initial_split_keys]
+
+        table_client.create_table(
+            parent=instance_name,
+            table_id=self.table_id,
+            table=table,
+            initial_splits=splits,
+        )
+
+    def exists(self):
+        """Check whether the table exists.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_check_table_exists]
+            :end-before: [END bigtable_check_table_exists]
+
+        :rtype: bool
+        :returns: True if the table exists, else False.
+        """
+        table_client = self._instance._client.table_admin_client
+        try:
+            table_client.get_table(name=self.name, view=VIEW_NAME_ONLY)
+            return True
+        except NotFound:
+            return False
+
+    def delete(self):
+        """Delete this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_delete_table]
+            :end-before: [END bigtable_delete_table]
+
+        """
+        table_client = self._instance._client.table_admin_client
+        table_client.delete_table(name=self.name)
+
+    def list_column_families(self):
+        """List the column families owned by this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_list_column_families]
+            :end-before: [END bigtable_list_column_families]
+
+        :rtype: dict
+        :returns: Dictionary of column families attached to this table. Keys
+                  are strings (column family names) and values are
+                  :class:`.ColumnFamily` instances.
+        :raises: :class:`ValueError <exceptions.ValueError>` if the column
+                 family name from the response does not agree with the computed
+                 name from the column family ID.
+        """
+        table_client = self._instance._client.table_admin_client
+        table_pb = table_client.get_table(self.name)
+
+        result = {}
+        for column_family_id, value_pb in table_pb.column_families.items():
+            gc_rule = _gc_rule_from_pb(value_pb.gc_rule)
+            column_family = self.column_family(column_family_id, gc_rule=gc_rule)
+            result[column_family_id] = column_family
+        return result
+
+    def get_cluster_states(self):
+        """List the cluster states owned by this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_get_cluster_states]
+            :end-before: [END bigtable_get_cluster_states]
+
+        :rtype: dict
+        :returns: Dictionary of cluster states for this table.
+                  Keys are cluster ids and values are
+                  :class: 'ClusterState' instances.
+        """
+
+        REPLICATION_VIEW = enums.Table.View.REPLICATION_VIEW
+        table_client = self._instance._client.table_admin_client
+        table_pb = table_client.get_table(self.name, view=REPLICATION_VIEW)
+
+        return {
+            cluster_id: ClusterState(value_pb.replication_state)
+            for cluster_id, value_pb in table_pb.cluster_states.items()
+        }
+
+    def read_row(self, row_key, filter_=None):
+        """Read a single row from this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_read_row]
+            :end-before: [END bigtable_read_row]
+
+        :type row_key: bytes
+        :param row_key: The key of the row to read from.
+
+        :type filter_: :class:`.RowFilter`
+        :param filter_: (Optional) The filter to apply to the contents of the
+                        row. If unset, returns the entire row.
+
+        :rtype: :class:`.PartialRowData`, :data:`NoneType <types.NoneType>`
+        :returns: The contents of the row if any chunks were returned in
+                  the response, otherwise :data:`None`.
+        :raises: :class:`ValueError <exceptions.ValueError>` if a commit row
+                 chunk is never encountered.
+        """
+        row_set = RowSet()
+        row_set.add_row_key(row_key)
+        result_iter = iter(self.read_rows(filter_=filter_, row_set=row_set))
+        row = next(result_iter, None)
+        if next(result_iter, None) is not None:
+            raise ValueError("More than one row was returned.")
+        return row
+
+    def read_rows(
+        self,
+        start_key=None,
+        end_key=None,
+        limit=None,
+        filter_=None,
+        end_inclusive=False,
+        row_set=None,
+        retry=DEFAULT_RETRY_READ_ROWS,
+    ):
+        """Read rows from this table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_read_rows]
+            :end-before: [END bigtable_read_rows]
+
+        :type start_key: bytes
+        :param start_key: (Optional) The beginning of a range of row keys to
+                          read from. The range will include ``start_key``. If
+                          left empty, will be interpreted as the empty string.
+
+        :type end_key: bytes
+        :param end_key: (Optional) The end of a range of row keys to read from.
+                        The range will not include ``end_key``. If left empty,
+                        will be interpreted as an infinite string.
+
+        :type limit: int
+        :param limit: (Optional) The read will terminate after committing to N
+                      rows' worth of results. The default (zero) is to return
+                      all results.
+
+        :type filter_: :class:`.RowFilter`
+        :param filter_: (Optional) The filter to apply to the contents of the
+                        specified row(s). If unset, reads every column in
+                        each row.
+
+        :type end_inclusive: bool
+        :param end_inclusive: (Optional) Whether the ``end_key`` should be
+                      considered inclusive. The default is False (exclusive).
+
+        :type row_set: :class:`row_set.RowSet`
+        :param row_set: (Optional) The row set containing multiple row keys and
+                        row_ranges.
+
+        :type retry: :class:`~google.api_core.retry.Retry`
+        :param retry:
+            (Optional) Retry delay and deadline arguments. To override, the
+            default value :attr:`DEFAULT_RETRY_READ_ROWS` can be used and
+            modified with the :meth:`~google.api_core.retry.Retry.with_delay`
+            method or the :meth:`~google.api_core.retry.Retry.with_deadline`
+            method.
+
+        :rtype: :class:`.PartialRowsData`
+        :returns: A :class:`.PartialRowsData` a generator for consuming
+                  the streamed results.
+        """
+        request_pb = _create_row_request(
+            self.name,
+            start_key=start_key,
+            end_key=end_key,
+            filter_=filter_,
+            limit=limit,
+            end_inclusive=end_inclusive,
+            app_profile_id=self._app_profile_id,
+            row_set=row_set,
+        )
+        data_client = self._instance._client.table_data_client
+        return PartialRowsData(data_client.transport.read_rows, request_pb, retry)
+
+    def yield_rows(self, **kwargs):
+        """Read rows from this table.
+
+        .. warning::
+           This method will be removed in future releases.  Please use
+           ``read_rows`` instead.
+
+        :type start_key: bytes
+        :param start_key: (Optional) The beginning of a range of row keys to
+                          read from. The range will include ``start_key``. If
+                          left empty, will be interpreted as the empty string.
+
+        :type end_key: bytes
+        :param end_key: (Optional) The end of a range of row keys to read from.
+                        The range will not include ``end_key``. If left empty,
+                        will be interpreted as an infinite string.
+
+        :type limit: int
+        :param limit: (Optional) The read will terminate after committing to N
+                      rows' worth of results. The default (zero) is to return
+                      all results.
+
+        :type filter_: :class:`.RowFilter`
+        :param filter_: (Optional) The filter to apply to the contents of the
+                        specified row(s). If unset, reads every column in
+                        each row.
+
+        :type row_set: :class:`row_set.RowSet`
+        :param row_set: (Optional) The row set containing multiple row keys and
+                        row_ranges.
+
+        :rtype: :class:`.PartialRowData`
+        :returns: A :class:`.PartialRowData` for each row returned
+        """
+        warnings.warn(
+            "`yield_rows()` is deprecated; use `read_rows()` instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.read_rows(**kwargs)
+
+    def mutate_rows(self, rows, retry=DEFAULT_RETRY):
+        """Mutates multiple rows in bulk.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_mutate_rows]
+            :end-before: [END bigtable_mutate_rows]
+
+        The method tries to update all specified rows.
+        If some of the rows weren't updated, it would not remove mutations.
+        They can be applied to the row separately.
+        If row mutations finished successfully, they would be cleaned up.
+
+        Optionally, a ``retry`` strategy can be specified to re-attempt
+        mutations on rows that return transient errors. This method will retry
+        until all rows succeed or until the request deadline is reached. To
+        specify a ``retry`` strategy of "do-nothing", a deadline of ``0.0``
+        can be specified.
+
+        :type rows: list
+        :param rows: List or other iterable of :class:`.DirectRow` instances.
+
+        :type retry: :class:`~google.api_core.retry.Retry`
+        :param retry:
+            (Optional) Retry delay and deadline arguments. To override, the
+            default value :attr:`DEFAULT_RETRY` can be used and modified with
+            the :meth:`~google.api_core.retry.Retry.with_delay` method or the
+            :meth:`~google.api_core.retry.Retry.with_deadline` method.
+
+        :rtype: list
+        :returns: A list of response statuses (`google.rpc.status_pb2.Status`)
+                  corresponding to success or failure of each row mutation
+                  sent. These will be in the same order as the `rows`.
+        """
+        retryable_mutate_rows = _RetryableMutateRowsWorker(
+            self._instance._client,
+            self.name,
+            rows,
+            app_profile_id=self._app_profile_id,
+            timeout=self.mutation_timeout,
+        )
+        return retryable_mutate_rows(retry=retry)
+
+    def sample_row_keys(self):
+        """Read a sample of row keys in the table.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_sample_row_keys]
+            :end-before: [END bigtable_sample_row_keys]
+
+        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.
+
+        The elements in the iterator are a SampleRowKeys response and they have
+        the properties ``offset_bytes`` and ``row_key``. They occur in sorted
+        order. The table might have contents before the first row key in the
+        list and after the last one, but a key containing the empty string
+        indicates "end of table" and will be the last response given, if
+        present.
+
+        .. note::
+
+            Row keys in this list may not have ever been written to or read
+            from, and users should therefore not make any assumptions about the
+            row key structure that are specific to their use case.
+
+        The ``offset_bytes`` field on a response indicates the approximate
+        total storage space used by all rows in the table which precede
+        ``row_key``. Buffering the contents of all rows between two subsequent
+        samples would require space roughly equal to the difference in their
+        ``offset_bytes`` fields.
+
+        :rtype: :class:`~google.cloud.exceptions.GrpcRendezvous`
+        :returns: A cancel-able iterator. Can be consumed by calling ``next()``
+                  or by casting to a :class:`list` and can be cancelled by
+                  calling ``cancel()``.
+        """
+        data_client = self._instance._client.table_data_client
+        response_iterator = data_client.sample_row_keys(
+            self.name, app_profile_id=self._app_profile_id
+        )
+
+        return response_iterator
+
+    def truncate(self, timeout=None):
+        """Truncate the table
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_truncate_table]
+            :end-before: [END bigtable_truncate_table]
+
+        :type timeout: float
+        :param timeout: (Optional) The amount of time, in seconds, to wait
+                        for the request to complete.
+
+        :raise: google.api_core.exceptions.GoogleAPICallError: If the
+                request failed for any reason.
+                google.api_core.exceptions.RetryError: If the request failed
+                due to a retryable error and retry attempts failed.
+                ValueError: If the parameters are invalid.
+        """
+        client = self._instance._client
+        table_admin_client = client.table_admin_client
+        if timeout:
+            table_admin_client.drop_row_range(
+                self.name, delete_all_data_from_table=True, timeout=timeout
+            )
+        else:
+            table_admin_client.drop_row_range(
+                self.name, delete_all_data_from_table=True
+            )
+
+    def drop_by_prefix(self, row_key_prefix, timeout=None):
+        """
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_drop_by_prefix]
+            :end-before: [END bigtable_drop_by_prefix]
+
+        :type row_prefix: bytes
+        :param row_prefix: Delete all rows that start with this row key
+                            prefix. Prefix cannot be zero length.
+
+        :type timeout: float
+        :param timeout: (Optional) The amount of time, in seconds, to wait
+                        for the request to complete.
+
+        :raise: google.api_core.exceptions.GoogleAPICallError: If the
+                request failed for any reason.
+                google.api_core.exceptions.RetryError: If the request failed
+                due to a retryable error and retry attempts failed.
+                ValueError: If the parameters are invalid.
+        """
+        client = self._instance._client
+        table_admin_client = client.table_admin_client
+        if timeout:
+            table_admin_client.drop_row_range(
+                self.name, row_key_prefix=_to_bytes(row_key_prefix), timeout=timeout
+            )
+        else:
+            table_admin_client.drop_row_range(
+                self.name, row_key_prefix=_to_bytes(row_key_prefix)
+            )
+
+    def mutations_batcher(self, flush_count=FLUSH_COUNT, max_row_bytes=MAX_ROW_BYTES):
+        """Factory to create a mutation batcher associated with this instance.
+
+        For example:
+
+        .. literalinclude:: snippets_table.py
+            :start-after: [START bigtable_mutations_batcher]
+            :end-before: [END bigtable_mutations_batcher]
+
+        :type table: class
+        :param table: class:`~google.cloud.bigtable.table.Table`.
+
+        :type flush_count: int
+        :param flush_count: (Optional) Maximum number of rows per batch. If it
+                reaches the max number of rows it calls finish_batch() to
+                mutate the current row batch. Default is FLUSH_COUNT (1000
+                rows).
+
+        :type max_row_bytes: int
+        :param max_row_bytes: (Optional) Max number of row mutations size to
+                flush. If it reaches the max number of row mutations size it
+                calls finish_batch() to mutate the current row batch.
+                Default is MAX_ROW_BYTES (5 MB).
+        """
+        return MutationsBatcher(self, flush_count, max_row_bytes)
+
+
+class _RetryableMutateRowsWorker(object):
+    """A callable worker that can retry to mutate rows with transient errors.
+
+    This class is a callable that can retry mutating rows that result in
+    transient errors. After all rows are successful or none of the rows
+    are retryable, any subsequent call on this callable will be a no-op.
+    """
+
+    # pylint: disable=unsubscriptable-object
+    RETRY_CODES = (
+        StatusCode.DEADLINE_EXCEEDED.value[0],
+        StatusCode.ABORTED.value[0],
+        StatusCode.UNAVAILABLE.value[0],
+    )
+    # pylint: enable=unsubscriptable-object
+
+    def __init__(self, client, table_name, rows, app_profile_id=None, timeout=None):
+        self.client = client
+        self.table_name = table_name
+        self.rows = rows
+        self.app_profile_id = app_profile_id
+        self.responses_statuses = [None] * len(self.rows)
+        self.timeout = timeout
+
+    def __call__(self, retry=DEFAULT_RETRY):
+        """Attempt to mutate all rows and retry rows with transient errors.
+
+        Will retry the rows with transient errors until all rows succeed or
+        ``deadline`` specified in the `retry` is reached.
+
+        :rtype: list
+        :returns: A list of response statuses (`google.rpc.status_pb2.Status`)
+                  corresponding to success or failure of each row mutation
+                  sent. These will be in the same order as the ``rows``.
+        """
+        mutate_rows = self._do_mutate_retryable_rows
+        if retry:
+            mutate_rows = retry(self._do_mutate_retryable_rows)
+
+        try:
+            mutate_rows()
+        except (_BigtableRetryableError, RetryError):
+            # - _BigtableRetryableError raised when no retry strategy is used
+            #   and a retryable error on a mutation occurred.
+            # - RetryError raised when retry deadline is reached.
+            # In both cases, just return current `responses_statuses`.
+            pass
+
+        return self.responses_statuses
+
+    @staticmethod
+    def _is_retryable(status):
+        return status is None or status.code in _RetryableMutateRowsWorker.RETRY_CODES
+
+    def _do_mutate_retryable_rows(self):
+        """Mutate all the rows that are eligible for retry.
+
+        A row is eligible for retry if it has not been tried or if it resulted
+        in a transient error in a previous call.
+
+        :rtype: list
+        :return: The responses statuses, which is a list of
+                 :class:`~google.rpc.status_pb2.Status`.
+        :raises: One of the following:
+
+                 * :exc:`~.table._BigtableRetryableError` if any
+                   row returned a transient error.
+                 * :exc:`RuntimeError` if the number of responses doesn't
+                   match the number of rows that were retried
+        """
+        retryable_rows = []
+        index_into_all_rows = []
+        for index, status in enumerate(self.responses_statuses):
+            if self._is_retryable(status):
+                retryable_rows.append(self.rows[index])
+                index_into_all_rows.append(index)
+
+        if not retryable_rows:
+            # All mutations are either successful or non-retryable now.
+            return self.responses_statuses
+
+        mutate_rows_request = _mutate_rows_request(
+            self.table_name, retryable_rows, app_profile_id=self.app_profile_id
+        )
+        data_client = self.client.table_data_client
+        inner_api_calls = data_client._inner_api_calls
+        if "mutate_rows" not in inner_api_calls:
+            default_retry = (data_client._method_configs["MutateRows"].retry,)
+            if self.timeout is None:
+                default_timeout = data_client._method_configs["MutateRows"].timeout
+            else:
+                default_timeout = timeout.ExponentialTimeout(deadline=self.timeout)
+            data_client._inner_api_calls["mutate_rows"] = wrap_method(
+                data_client.transport.mutate_rows,
+                default_retry=default_retry,
+                default_timeout=default_timeout,
+                client_info=data_client._client_info,
+            )
+
+        responses = data_client._inner_api_calls["mutate_rows"](
+            mutate_rows_request, retry=None
+        )
+
+        num_responses = 0
+        num_retryable_responses = 0
+        for response in responses:
+            for entry in response.entries:
+                num_responses += 1
+                index = index_into_all_rows[entry.index]
+                self.responses_statuses[index] = entry.status
+                if self._is_retryable(entry.status):
+                    num_retryable_responses += 1
+                if entry.status.code == 0:
+                    self.rows[index].clear()
+
+        if len(retryable_rows) != num_responses:
+            raise RuntimeError(
+                "Unexpected number of responses",
+                num_responses,
+                "Expected",
+                len(retryable_rows),
+            )
+
+        if num_retryable_responses:
+            raise _BigtableRetryableError
+
+        return self.responses_statuses
+
+
+class ClusterState(object):
+    """Representation of a Cluster State.
+
+    :type replication_state: int
+    :param replication_state: enum value for cluster state
+        Possible replications_state values are
+        0 for STATE_NOT_KNOWN: The replication state of the table is
+        unknown in this cluster.
+        1 for INITIALIZING: The cluster was recently created, and the
+        table must finish copying
+        over pre-existing data from other clusters before it can
+        begin receiving live replication updates and serving
+        ``Data API`` requests.
+        2 for PLANNED_MAINTENANCE: The table is temporarily unable to
+        serve
+        ``Data API`` requests from this
+        cluster due to planned internal maintenance.
+        3 for UNPLANNED_MAINTENANCE: The table is temporarily unable
+        to serve
+        ``Data API`` requests from this
+        cluster due to unplanned or emergency maintenance.
+        4 for READY: The table can serve
+        ``Data API`` requests from this
+        cluster. Depending on replication delay, reads may not
+        immediately reflect the state of the table in other clusters.
+    """
+
+    def __init__(self, replication_state):
+        self.replication_state = replication_state
+
+    def __repr__(self):
+        """Representation of  cluster state instance as string value
+        for cluster state.
+
+        :rtype: ClusterState instance
+        :returns: ClusterState instance as representation of string
+                  value for cluster state.
+        """
+        replication_dict = {
+            enums.Table.ReplicationState.STATE_NOT_KNOWN: "STATE_NOT_KNOWN",
+            enums.Table.ReplicationState.INITIALIZING: "INITIALIZING",
+            enums.Table.ReplicationState.PLANNED_MAINTENANCE: "PLANNED_MAINTENANCE",
+            enums.Table.ReplicationState.UNPLANNED_MAINTENANCE: "UNPLANNED_MAINTENANCE",
+            enums.Table.ReplicationState.READY: "READY",
+        }
+        return replication_dict[self.replication_state]
+
+    def __eq__(self, other):
+        """Checks if two ClusterState instances(self and other) are
+        equal on the basis of instance variable 'replication_state'.
+
+        :type other: ClusterState
+        :param other: ClusterState instance to compare with.
+
+        :rtype: Boolean value
+        :returns: True if  two cluster state instances have same
+                  replication_state.
+        """
+        if not isinstance(other, self.__class__):
+            return False
+        return self.replication_state == other.replication_state
+
+    def __ne__(self, other):
+        """Checks if two ClusterState instances(self and other) are
+        not equal.
+
+        :type other: ClusterState.
+        :param other: ClusterState instance to compare with.
+
+        :rtype: Boolean value.
+        :returns: True if  two cluster state instances are not equal.
+        """
+        return not self == other
+
+
+def _create_row_request(
+    table_name,
+    start_key=None,
+    end_key=None,
+    filter_=None,
+    limit=None,
+    end_inclusive=False,
+    app_profile_id=None,
+    row_set=None,
+):
+    """Creates a request to read rows in a table.
+
+    :type table_name: str
+    :param table_name: The name of the table to read from.
+
+    :type start_key: bytes
+    :param start_key: (Optional) The beginning of a range of row keys to
+                      read from. The range will include ``start_key``. If
+                      left empty, will be interpreted as the empty string.
+
+    :type end_key: bytes
+    :param end_key: (Optional) The end of a range of row keys to read from.
+                    The range will not include ``end_key``. If left empty,
+                    will be interpreted as an infinite string.
+
+    :type filter_: :class:`.RowFilter`
+    :param filter_: (Optional) The filter to apply to the contents of the
+                    specified row(s). If unset, reads the entire table.
+
+    :type limit: int
+    :param limit: (Optional) The read will terminate after committing to N
+                  rows' worth of results. The default (zero) is to return
+                  all results.
+
+    :type end_inclusive: bool
+    :param end_inclusive: (Optional) Whether the ``end_key`` should be
+                  considered inclusive. The default is False (exclusive).
+
+    :type: app_profile_id: str
+    :param app_profile_id: (Optional) The unique name of the AppProfile.
+
+    :type row_set: :class:`row_set.RowSet`
+    :param row_set: (Optional) The row set containing multiple row keys and
+                    row_ranges.
+
+    :rtype: :class:`data_messages_v2_pb2.ReadRowsRequest`
+    :returns: The ``ReadRowsRequest`` protobuf corresponding to the inputs.
+    :raises: :class:`ValueError <exceptions.ValueError>` if both
+             ``row_set`` and one of ``start_key`` or ``end_key`` are set
+    """
+    request_kwargs = {"table_name": table_name}
+    if (start_key is not None or end_key is not None) and row_set is not None:
+        raise ValueError("Row range and row set cannot be " "set simultaneously")
+
+    if filter_ is not None:
+        request_kwargs["filter"] = filter_.to_pb()
+    if limit is not None:
+        request_kwargs["rows_limit"] = limit
+    if app_profile_id is not None:
+        request_kwargs["app_profile_id"] = app_profile_id
+
+    message = data_messages_v2_pb2.ReadRowsRequest(**request_kwargs)
+
+    if start_key is not None or end_key is not None:
+        row_set = RowSet()
+        row_set.add_row_range(RowRange(start_key, end_key, end_inclusive=end_inclusive))
+
+    if row_set is not None:
+        row_set._update_message_request(message)
+
+    return message
+
+
+def _mutate_rows_request(table_name, rows, app_profile_id=None):
+    """Creates a request to mutate rows in a table.
+
+    :type table_name: str
+    :param table_name: The name of the table to write to.
+
+    :type rows: list
+    :param rows: List or other iterable of :class:`.DirectRow` instances.
+
+    :type: app_profile_id: str
+    :param app_profile_id: (Optional) The unique name of the AppProfile.
+
+    :rtype: :class:`data_messages_v2_pb2.MutateRowsRequest`
+    :returns: The ``MutateRowsRequest`` protobuf corresponding to the inputs.
+    :raises: :exc:`~.table.TooManyMutationsError` if the number of mutations is
+             greater than 100,000
+    """
+    request_pb = data_messages_v2_pb2.MutateRowsRequest(
+        table_name=table_name, app_profile_id=app_profile_id
+    )
+    mutations_count = 0
+    for row in rows:
+        _check_row_table_name(table_name, row)
+        _check_row_type(row)
+        mutations = row._get_mutations()
+        request_pb.entries.add(row_key=row.row_key, mutations=mutations)
+        mutations_count += len(mutations)
+    if mutations_count > _MAX_BULK_MUTATIONS:
+        raise TooManyMutationsError(
+            "Maximum number of mutations is %s" % (_MAX_BULK_MUTATIONS,)
+        )
+    return request_pb
+
+
+def _check_row_table_name(table_name, row):
+    """Checks that a row belongs to a table.
+
+    :type table_name: str
+    :param table_name: The name of the table.
+
+    :type row: :class:`~google.cloud.bigtable.row.Row`
+    :param row: An instance of :class:`~google.cloud.bigtable.row.Row`
+                subclasses.
+
+    :raises: :exc:`~.table.TableMismatchError` if the row does not belong to
+             the table.
+    """
+    if row.table is not None and row.table.name != table_name:
+        raise TableMismatchError(
+            "Row %s is a part of %s table. Current table: %s"
+            % (row.row_key, row.table.name, table_name)
+        )
+
+
+def _check_row_type(row):
+    """Checks that a row is an instance of :class:`.DirectRow`.
+
+    :type row: :class:`~google.cloud.bigtable.row.Row`
+    :param row: An instance of :class:`~google.cloud.bigtable.row.Row`
+                subclasses.
+
+    :raises: :class:`TypeError <exceptions.TypeError>` if the row is not an
+             instance of DirectRow.
+    """
+    if not isinstance(row, DirectRow):
+        raise TypeError(
+            "Bulk processing can not be applied for " "conditional or append mutations."
+        )
diff --git a/bigtable/google/cloud/bigtable_admin_v2/__init__.py b/bigtable/google/cloud/bigtable_admin_v2/__init__.py
new file mode 100644
index 000000000000..501d8f24d3e1
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/__init__.py
@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.bigtable_admin_v2 import types
+from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+from google.cloud.bigtable_admin_v2.gapic import enums
+
+
+class BigtableInstanceAdminClient(
+    bigtable_instance_admin_client.BigtableInstanceAdminClient
+):
+    __doc__ = bigtable_instance_admin_client.BigtableInstanceAdminClient.__doc__
+    enums = enums
+
+
+class BigtableTableAdminClient(bigtable_table_admin_client.BigtableTableAdminClient):
+    __doc__ = bigtable_table_admin_client.BigtableTableAdminClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "BigtableInstanceAdminClient", "BigtableTableAdminClient")
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/__init__.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client.py
new file mode 100644
index 000000000000..fed633c8dc6b
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client.py
@@ -0,0 +1,1881 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.bigtable.admin.v2 BigtableInstanceAdmin API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client_config
+from google.cloud.bigtable_admin_v2.gapic import enums
+from google.cloud.bigtable_admin_v2.gapic.transports import (
+    bigtable_instance_admin_grpc_transport,
+)
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2_grpc
+from google.cloud.bigtable_admin_v2.proto import instance_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-bigtable").version
+
+
+class BigtableInstanceAdminClient(object):
+    """
+    Service for creating, configuring, and deleting Cloud Bigtable Instances and
+    Clusters. Provides access to the Instance and Cluster schemas only, not the
+    tables' metadata or data stored in those tables.
+    """
+
+    SERVICE_ADDRESS = "bigtableadmin.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.bigtable.admin.v2.BigtableInstanceAdmin"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            BigtableInstanceAdminClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def app_profile_path(cls, project, instance, app_profile):
+        """Return a fully-qualified app_profile string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/appProfiles/{app_profile}",
+            project=project,
+            instance=instance,
+            app_profile=app_profile,
+        )
+
+    @classmethod
+    def cluster_path(cls, project, instance, cluster):
+        """Return a fully-qualified cluster string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/clusters/{cluster}",
+            project=project,
+            instance=instance,
+            cluster=cluster,
+        )
+
+    @classmethod
+    def instance_path(cls, project, instance):
+        """Return a fully-qualified instance string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}",
+            project=project,
+            instance=instance,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.BigtableInstanceAdminGrpcTransport,
+                    Callable[[~.Credentials, type], ~.BigtableInstanceAdminGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = bigtable_instance_admin_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=bigtable_instance_admin_grpc_transport.BigtableInstanceAdminGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = bigtable_instance_admin_grpc_transport.BigtableInstanceAdminGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_instance(
+        self,
+        parent,
+        instance_id,
+        instance,
+        clusters,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Create an instance within a project.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `instance_id`:
+            >>> instance_id = ''
+            >>>
+            >>> # TODO: Initialize `instance`:
+            >>> instance = {}
+            >>>
+            >>> # TODO: Initialize `clusters`:
+            >>> clusters = {}
+            >>>
+            >>> response = client.create_instance(parent, instance_id, instance, clusters)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The unique name of the project in which to create the new instance.
+                Values are of the form ``projects/<project>``.
+            instance_id (str): The ID to be used when referring to the new instance within its project,
+                e.g., just ``myinstance`` rather than
+                ``projects/myproject/instances/myinstance``.
+            instance (Union[dict, ~google.cloud.bigtable_admin_v2.types.Instance]): The instance to create. Fields marked ``OutputOnly`` must be left blank.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Instance`
+            clusters (dict[str -> Union[dict, ~google.cloud.bigtable_admin_v2.types.Cluster]]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Cluster`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_instance,
+                default_retry=self._method_configs["CreateInstance"].retry,
+                default_timeout=self._method_configs["CreateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance, clusters=clusters
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            instance_pb2.Instance,
+            metadata_type=bigtable_instance_admin_pb2.CreateInstanceMetadata,
+        )
+
+    def get_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information about an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> response = client.get_instance(name)
+
+        Args:
+            name (str): The unique name of the requested instance. Values are of the form
+                ``projects/<project>/instances/<instance>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Instance` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_instance,
+                default_retry=self._method_configs["GetInstance"].retry,
+                default_timeout=self._method_configs["GetInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.GetInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_instances(
+        self,
+        parent,
+        page_token=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists information about instances in a project.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.list_instances(parent)
+
+        Args:
+            parent (str): The unique name of the project for which a list of instances is
+                requested. Values are of the form ``projects/<project>``.
+            page_token (str): DEPRECATED: This field is unused and ignored.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.ListInstancesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_instances" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_instances"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_instances,
+                default_retry=self._method_configs["ListInstances"].retry,
+                default_timeout=self._method_configs["ListInstances"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.ListInstancesRequest(
+            parent=parent, page_token=page_token
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_instances"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_instance(
+        self,
+        name,
+        display_name,
+        type_,
+        labels,
+        state=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an instance within a project.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>> from google.cloud.bigtable_admin_v2 import enums
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `display_name`:
+            >>> display_name = ''
+            >>>
+            >>> # TODO: Initialize `type_`:
+            >>> type_ = enums.Instance.Type.TYPE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `labels`:
+            >>> labels = {}
+            >>>
+            >>> response = client.update_instance(name, display_name, type_, labels)
+
+        Args:
+            name (str): (``OutputOnly``) The unique name of the instance. Values are of the form
+                ``projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]``.
+            display_name (str): 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.
+            type_ (~google.cloud.bigtable_admin_v2.types.Type): The type of the instance. Defaults to ``PRODUCTION``.
+            labels (dict[str -> str]): Labels are a flexible and lightweight mechanism for organizing cloud
+                resources into groups that reflect a customer's organizational needs and
+                deployment strategies. They can be used to filter resources and
+                aggregate metrics.
+
+                -  Label keys must be between 1 and 63 characters long and must conform
+                   to the regular expression:
+                   ``[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}``.
+                -  Label values must be between 0 and 63 characters long and must
+                   conform to the regular expression: ``[\p{Ll}\p{Lo}\p{N}_-]{0,63}``.
+                -  No more than 64 labels can be associated with a given resource.
+                -  Keys and values must both be under 128 bytes.
+            state (~google.cloud.bigtable_admin_v2.types.State): (``OutputOnly``) The current state of the instance.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Instance` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_instance,
+                default_retry=self._method_configs["UpdateInstance"].retry,
+                default_timeout=self._method_configs["UpdateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = instance_pb2.Instance(
+            name=name, display_name=display_name, type=type_, labels=labels, state=state
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def partial_update_instance(
+        self,
+        instance,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Partially updates an instance within a project.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> # TODO: Initialize `instance`:
+            >>> instance = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.partial_update_instance(instance, update_mask)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            instance (Union[dict, ~google.cloud.bigtable_admin_v2.types.Instance]): The Instance which will (partially) replace the current value.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Instance`
+            update_mask (Union[dict, ~google.cloud.bigtable_admin_v2.types.FieldMask]): The subset of Instance fields which should be replaced.
+                Must be explicitly set.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "partial_update_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "partial_update_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.partial_update_instance,
+                default_retry=self._method_configs["PartialUpdateInstance"].retry,
+                default_timeout=self._method_configs["PartialUpdateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.PartialUpdateInstanceRequest(
+            instance=instance, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("instance.name", instance.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["partial_update_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            instance_pb2.Instance,
+            metadata_type=bigtable_instance_admin_pb2.UpdateInstanceMetadata,
+        )
+
+    def delete_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Delete an instance from a project.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> client.delete_instance(name)
+
+        Args:
+            name (str): The unique name of the instance to be deleted. Values are of the form
+                ``projects/<project>/instances/<instance>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_instance,
+                default_retry=self._method_configs["DeleteInstance"].retry,
+                default_timeout=self._method_configs["DeleteInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.DeleteInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_cluster(
+        self,
+        parent,
+        cluster_id,
+        cluster,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a cluster within an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> response = client.create_cluster(parent, cluster_id, cluster)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The unique name of the instance in which to create the new cluster.
+                Values are of the form ``projects/<project>/instances/<instance>``.
+            cluster_id (str): 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``.
+            cluster (Union[dict, ~google.cloud.bigtable_admin_v2.types.Cluster]): The cluster to be created. Fields marked ``OutputOnly`` must be left
+                blank.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Cluster`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_cluster,
+                default_retry=self._method_configs["CreateCluster"].retry,
+                default_timeout=self._method_configs["CreateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.CreateClusterRequest(
+            parent=parent, cluster_id=cluster_id, cluster=cluster
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            instance_pb2.Cluster,
+            metadata_type=bigtable_instance_admin_pb2.CreateClusterMetadata,
+        )
+
+    def get_cluster(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information about a cluster.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.cluster_path('[PROJECT]', '[INSTANCE]', '[CLUSTER]')
+            >>>
+            >>> response = client.get_cluster(name)
+
+        Args:
+            name (str): The unique name of the requested cluster. Values are of the form
+                ``projects/<project>/instances/<instance>/clusters/<cluster>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Cluster` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_cluster,
+                default_retry=self._method_configs["GetCluster"].retry,
+                default_timeout=self._method_configs["GetCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.GetClusterRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_clusters(
+        self,
+        parent,
+        page_token=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists information about clusters in an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> response = client.list_clusters(parent)
+
+        Args:
+            parent (str): 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/-``.
+            page_token (str): DEPRECATED: This field is unused and ignored.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.ListClustersResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_clusters" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_clusters"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_clusters,
+                default_retry=self._method_configs["ListClusters"].retry,
+                default_timeout=self._method_configs["ListClusters"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.ListClustersRequest(
+            parent=parent, page_token=page_token
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_clusters"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_cluster(
+        self,
+        name,
+        serve_nodes,
+        location=None,
+        state=None,
+        default_storage_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a cluster within an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.cluster_path('[PROJECT]', '[INSTANCE]', '[CLUSTER]')
+            >>>
+            >>> # TODO: Initialize `serve_nodes`:
+            >>> serve_nodes = 0
+            >>>
+            >>> response = client.update_cluster(name, serve_nodes)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): (``OutputOnly``) The unique name of the cluster. Values are of the form
+                ``projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*``.
+            serve_nodes (int): The number of nodes allocated to this cluster. More nodes enable higher
+                throughput and more consistent performance.
+            location (str): (``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/<project>/locations/<zone>``.
+            state (~google.cloud.bigtable_admin_v2.types.State): (``OutputOnly``) The current state of the cluster.
+            default_storage_type (~google.cloud.bigtable_admin_v2.types.StorageType): (``CreationOnly``) The type of storage used by this cluster to serve its
+                parent instance's tables, unless explicitly overridden.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_cluster,
+                default_retry=self._method_configs["UpdateCluster"].retry,
+                default_timeout=self._method_configs["UpdateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = instance_pb2.Cluster(
+            name=name,
+            serve_nodes=serve_nodes,
+            location=location,
+            state=state,
+            default_storage_type=default_storage_type,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["update_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            instance_pb2.Cluster,
+            metadata_type=bigtable_instance_admin_pb2.UpdateClusterMetadata,
+        )
+
+    def delete_cluster(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a cluster from an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.cluster_path('[PROJECT]', '[INSTANCE]', '[CLUSTER]')
+            >>>
+            >>> client.delete_cluster(name)
+
+        Args:
+            name (str): The unique name of the cluster to be deleted. Values are of the form
+                ``projects/<project>/instances/<instance>/clusters/<cluster>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_cluster,
+                default_retry=self._method_configs["DeleteCluster"].retry,
+                default_timeout=self._method_configs["DeleteCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.DeleteClusterRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_app_profile(
+        self,
+        parent,
+        app_profile_id,
+        app_profile,
+        ignore_warnings=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an app profile within an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `app_profile_id`:
+            >>> app_profile_id = ''
+            >>>
+            >>> # TODO: Initialize `app_profile`:
+            >>> app_profile = {}
+            >>>
+            >>> response = client.create_app_profile(parent, app_profile_id, app_profile)
+
+        Args:
+            parent (str): The unique name of the instance in which to create the new app profile.
+                Values are of the form ``projects/<project>/instances/<instance>``.
+            app_profile_id (str): 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``.
+            app_profile (Union[dict, ~google.cloud.bigtable_admin_v2.types.AppProfile]): The app profile to be created. Fields marked ``OutputOnly`` will be
+                ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.AppProfile`
+            ignore_warnings (bool): If true, ignore safety checks when creating the app profile.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.AppProfile` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_app_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_app_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_app_profile,
+                default_retry=self._method_configs["CreateAppProfile"].retry,
+                default_timeout=self._method_configs["CreateAppProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.CreateAppProfileRequest(
+            parent=parent,
+            app_profile_id=app_profile_id,
+            app_profile=app_profile,
+            ignore_warnings=ignore_warnings,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_app_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_app_profile(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information about an app profile.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.app_profile_path('[PROJECT]', '[INSTANCE]', '[APP_PROFILE]')
+            >>>
+            >>> response = client.get_app_profile(name)
+
+        Args:
+            name (str): The unique name of the requested app profile. Values are of the form
+                ``projects/<project>/instances/<instance>/appProfiles/<app_profile>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.AppProfile` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_app_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_app_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_app_profile,
+                default_retry=self._method_configs["GetAppProfile"].retry,
+                default_timeout=self._method_configs["GetAppProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.GetAppProfileRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_app_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_app_profiles(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists information about app profiles in an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_app_profiles(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_app_profiles(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The unique name of the instance for which a list of app profiles is
+                requested. Values are of the form
+                ``projects/<project>/instances/<instance>``. Use ``<instance> = '-'`` to
+                list AppProfiles for all Instances in a project, e.g.,
+                ``projects/myproject/instances/-``.
+            page_size (int): Maximum number of results per page.
+                CURRENTLY UNIMPLEMENTED AND IGNORED.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigtable_admin_v2.types.AppProfile` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_app_profiles" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_app_profiles"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_app_profiles,
+                default_retry=self._method_configs["ListAppProfiles"].retry,
+                default_timeout=self._method_configs["ListAppProfiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.ListAppProfilesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_app_profiles"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="app_profiles",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_app_profile(
+        self,
+        app_profile,
+        update_mask,
+        ignore_warnings=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an app profile within an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> # TODO: Initialize `app_profile`:
+            >>> app_profile = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_app_profile(app_profile, update_mask)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            app_profile (Union[dict, ~google.cloud.bigtable_admin_v2.types.AppProfile]): The app profile which will (partially) replace the current value.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.AppProfile`
+            update_mask (Union[dict, ~google.cloud.bigtable_admin_v2.types.FieldMask]): The subset of app profile fields which should be replaced.
+                If unset, all fields will be replaced.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.FieldMask`
+            ignore_warnings (bool): If true, ignore safety checks when updating the app profile.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_app_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_app_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_app_profile,
+                default_retry=self._method_configs["UpdateAppProfile"].retry,
+                default_timeout=self._method_configs["UpdateAppProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.UpdateAppProfileRequest(
+            app_profile=app_profile,
+            update_mask=update_mask,
+            ignore_warnings=ignore_warnings,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("app_profile.name", app_profile.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["update_app_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            instance_pb2.AppProfile,
+            metadata_type=bigtable_instance_admin_pb2.UpdateAppProfileMetadata,
+        )
+
+    def delete_app_profile(
+        self,
+        name,
+        ignore_warnings,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an app profile from an instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> name = client.app_profile_path('[PROJECT]', '[INSTANCE]', '[APP_PROFILE]')
+            >>>
+            >>> # TODO: Initialize `ignore_warnings`:
+            >>> ignore_warnings = False
+            >>>
+            >>> client.delete_app_profile(name, ignore_warnings)
+
+        Args:
+            name (str): The unique name of the app profile to be deleted. Values are of the form
+                ``projects/<project>/instances/<instance>/appProfiles/<app_profile>``.
+            ignore_warnings (bool): If true, ignore safety checks when deleting the app profile.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_app_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_app_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_app_profile,
+                default_retry=self._method_configs["DeleteAppProfile"].retry,
+                default_timeout=self._method_configs["DeleteAppProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_instance_admin_pb2.DeleteAppProfileRequest(
+            name=name, ignore_warnings=ignore_warnings
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_app_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for an instance resource. Returns an empty
+        policy if an instance exists but does not have a policy set.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> resource = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.bigtable_admin_v2.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on an instance resource. Replaces any
+        existing policy.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> resource = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.bigtable_admin_v2.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns permissions that the caller has on the specified instance resource.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableInstanceAdminClient()
+            >>>
+            >>> resource = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client_config.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client_config.py
new file mode 100644
index 000000000000..b2ec35e0146e
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client_config.py
@@ -0,0 +1,136 @@
+config = {
+    "interfaces": {
+        "google.bigtable.admin.v2.BigtableInstanceAdmin": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "idempotent_params": {
+                    "initial_retry_delay_millis": 1000,
+                    "retry_delay_multiplier": 2.0,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 60000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                },
+                "non_idempotent_params": {
+                    "initial_retry_delay_millis": 0,
+                    "retry_delay_multiplier": 1.0,
+                    "max_retry_delay_millis": 0,
+                    "initial_rpc_timeout_millis": 60000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 60000,
+                },
+                "non_idempotent_heavy_params": {
+                    "initial_retry_delay_millis": 0,
+                    "retry_delay_multiplier": 1.0,
+                    "max_retry_delay_millis": 0,
+                    "initial_rpc_timeout_millis": 300000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 300000,
+                    "total_timeout_millis": 300000,
+                },
+            },
+            "methods": {
+                "CreateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_heavy_params",
+                },
+                "GetInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "ListInstances": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "UpdateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "PartialUpdateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "DeleteInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "CreateCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "GetCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "ListClusters": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "UpdateCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "DeleteCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "CreateAppProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "GetAppProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "ListAppProfiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "UpdateAppProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "DeleteAppProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+            },
+        }
+    }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client.py
new file mode 100644
index 000000000000..844fd59a7b2a
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client.py
@@ -0,0 +1,1426 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.bigtable.admin.v2 BigtableTableAdmin API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client_config
+from google.cloud.bigtable_admin_v2.gapic import enums
+from google.cloud.bigtable_admin_v2.gapic.transports import (
+    bigtable_table_admin_grpc_transport,
+)
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2_grpc
+from google.cloud.bigtable_admin_v2.proto import bigtable_table_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import bigtable_table_admin_pb2_grpc
+from google.cloud.bigtable_admin_v2.proto import instance_pb2
+from google.cloud.bigtable_admin_v2.proto import table_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-bigtable").version
+
+
+class BigtableTableAdminClient(object):
+    """
+    Service for creating, configuring, and deleting Cloud Bigtable tables.
+
+
+    Provides access to the table schemas only, not the data stored within
+    the tables.
+    """
+
+    SERVICE_ADDRESS = "bigtableadmin.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.bigtable.admin.v2.BigtableTableAdmin"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            BigtableTableAdminClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def cluster_path(cls, project, instance, cluster):
+        """Return a fully-qualified cluster string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/clusters/{cluster}",
+            project=project,
+            instance=instance,
+            cluster=cluster,
+        )
+
+    @classmethod
+    def instance_path(cls, project, instance):
+        """Return a fully-qualified instance string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}",
+            project=project,
+            instance=instance,
+        )
+
+    @classmethod
+    def snapshot_path(cls, project, instance, cluster, snapshot):
+        """Return a fully-qualified snapshot string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}",
+            project=project,
+            instance=instance,
+            cluster=cluster,
+            snapshot=snapshot,
+        )
+
+    @classmethod
+    def table_path(cls, project, instance, table):
+        """Return a fully-qualified table string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/tables/{table}",
+            project=project,
+            instance=instance,
+            table=table,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.BigtableTableAdminGrpcTransport,
+                    Callable[[~.Credentials, type], ~.BigtableTableAdminGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = bigtable_table_admin_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=bigtable_table_admin_grpc_transport.BigtableTableAdminGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = bigtable_table_admin_grpc_transport.BigtableTableAdminGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_table(
+        self,
+        parent,
+        table_id,
+        table,
+        initial_splits=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `table_id`:
+            >>> table_id = ''
+            >>>
+            >>> # TODO: Initialize `table`:
+            >>> table = {}
+            >>>
+            >>> response = client.create_table(parent, table_id, table)
+
+        Args:
+            parent (str): The unique name of the instance in which to create the table. Values are
+                of the form ``projects/<project>/instances/<instance>``.
+            table_id (str): The name by which the new table should be referred to within the parent
+                instance, e.g., ``foobar`` rather than ``<parent>/tables/foobar``.
+            table (Union[dict, ~google.cloud.bigtable_admin_v2.types.Table]): The Table to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Table`
+            initial_splits (list[Union[dict, ~google.cloud.bigtable_admin_v2.types.Split]]): The optional list of row keys that will be used to initially split the
+                table into several tablets (tablets are similar to HBase regions). Given
+                two split keys, ``s1`` and ``s2``, three tablets will be created,
+                spanning the key ranges: ``[, s1), [s1, s2), [s2, )``.
+
+                Example:
+
+                -  Row keys := ``["a", "apple", "custom", "customer_1", "customer_2",``
+                   ``"other", "zz"]``
+                -  initial\_split\_keys :=
+                   ``["apple", "customer_1", "customer_2", "other"]``
+                -  Key assignment:
+
+                   -  Tablet 1 ``[, apple) => {"a"}.``
+                   -  Tablet 2 ``[apple, customer_1) => {"apple", "custom"}.``
+                   -  Tablet 3 ``[customer_1, customer_2) => {"customer_1"}.``
+                   -  Tablet 4 ``[customer_2, other) => {"customer_2"}.``
+                   -  Tablet 5 ``[other, ) => {"other", "zz"}.``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Split`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Table` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_table" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_table"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_table,
+                default_retry=self._method_configs["CreateTable"].retry,
+                default_timeout=self._method_configs["CreateTable"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.CreateTableRequest(
+            parent=parent, table_id=table_id, table=table, initial_splits=initial_splits
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_table"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_table_from_snapshot(
+        self,
+        parent,
+        table_id,
+        source_snapshot,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new table from the specified snapshot. The target table must
+        not exist. The snapshot and the table must be in the same instance.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `table_id`:
+            >>> table_id = ''
+            >>>
+            >>> # TODO: Initialize `source_snapshot`:
+            >>> source_snapshot = ''
+            >>>
+            >>> response = client.create_table_from_snapshot(parent, table_id, source_snapshot)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The unique name of the instance in which to create the table. Values are
+                of the form ``projects/<project>/instances/<instance>``.
+            table_id (str): The name by which the new table should be referred to within the parent
+                instance, e.g., ``foobar`` rather than ``<parent>/tables/foobar``.
+            source_snapshot (str): 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>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_table_from_snapshot" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_table_from_snapshot"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_table_from_snapshot,
+                default_retry=self._method_configs["CreateTableFromSnapshot"].retry,
+                default_timeout=self._method_configs["CreateTableFromSnapshot"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.CreateTableFromSnapshotRequest(
+            parent=parent, table_id=table_id, source_snapshot=source_snapshot
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_table_from_snapshot"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            table_pb2.Table,
+            metadata_type=bigtable_table_admin_pb2.CreateTableFromSnapshotMetadata,
+        )
+
+    def list_tables(
+        self,
+        parent,
+        view=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all tables served from a specified instance.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tables(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tables(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The unique name of the instance for which tables should be listed.
+                Values are of the form ``projects/<project>/instances/<instance>``.
+            view (~google.cloud.bigtable_admin_v2.types.View): The view to be applied to the returned tables' fields. Defaults to
+                ``NAME_ONLY`` if unspecified; no others are currently supported.
+            page_size (int): Maximum number of results per page.
+                CURRENTLY UNIMPLEMENTED AND IGNORED.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigtable_admin_v2.types.Table` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tables" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tables"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tables,
+                default_retry=self._method_configs["ListTables"].retry,
+                default_timeout=self._method_configs["ListTables"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.ListTablesRequest(
+            parent=parent, view=view, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tables"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tables",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_table(
+        self,
+        name,
+        view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets metadata information about the specified table.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> response = client.get_table(name)
+
+        Args:
+            name (str): The unique name of the requested table. Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            view (~google.cloud.bigtable_admin_v2.types.View): The view to be applied to the returned table's fields. Defaults to
+                ``SCHEMA_VIEW`` if unspecified.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Table` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_table" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_table"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_table,
+                default_retry=self._method_configs["GetTable"].retry,
+                default_timeout=self._method_configs["GetTable"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.GetTableRequest(name=name, view=view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_table"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_table(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a specified table and all of its data.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> client.delete_table(name)
+
+        Args:
+            name (str): The unique name of the table to be deleted. Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_table" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_table"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_table,
+                default_retry=self._method_configs["DeleteTable"].retry,
+                default_timeout=self._method_configs["DeleteTable"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.DeleteTableRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_table"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def modify_column_families(
+        self,
+        name,
+        modifications,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Performs a series of column family modifications on the specified table.
+        Either all or none of the modifications will occur before this method
+        returns, but data requests received prior to that point may see a table
+        where only some modifications have taken effect.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `modifications`:
+            >>> modifications = []
+            >>>
+            >>> response = client.modify_column_families(name, modifications)
+
+        Args:
+            name (str): The unique name of the table whose families should be modified. Values
+                are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            modifications (list[Union[dict, ~google.cloud.bigtable_admin_v2.types.Modification]]): 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).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Modification`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Table` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "modify_column_families" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "modify_column_families"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.modify_column_families,
+                default_retry=self._method_configs["ModifyColumnFamilies"].retry,
+                default_timeout=self._method_configs["ModifyColumnFamilies"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.ModifyColumnFamiliesRequest(
+            name=name, modifications=modifications
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["modify_column_families"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def drop_row_range(
+        self,
+        name,
+        row_key_prefix=None,
+        delete_all_data_from_table=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently drop/delete a row range from a specified table. The request can
+        specify whether to delete all rows in a table, or only those that match a
+        particular prefix.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> client.drop_row_range(name)
+
+        Args:
+            name (str): The unique name of the table on which to drop a range of rows. Values
+                are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            row_key_prefix (bytes): Delete all rows that start with this row key prefix. Prefix cannot be
+                zero length.
+            delete_all_data_from_table (bool): Delete all rows in the table. Setting this to false is a no-op.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "drop_row_range" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "drop_row_range"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.drop_row_range,
+                default_retry=self._method_configs["DropRowRange"].retry,
+                default_timeout=self._method_configs["DropRowRange"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            row_key_prefix=row_key_prefix,
+            delete_all_data_from_table=delete_all_data_from_table,
+        )
+
+        request = bigtable_table_admin_pb2.DropRowRangeRequest(
+            name=name,
+            row_key_prefix=row_key_prefix,
+            delete_all_data_from_table=delete_all_data_from_table,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["drop_row_range"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def generate_consistency_token(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Generates a consistency token for a Table, which can be used in
+        CheckConsistency to check whether mutations to the table that finished
+        before this call started have been replicated. The tokens will be available
+        for 90 days.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> response = client.generate_consistency_token(name)
+
+        Args:
+            name (str): The unique name of the Table for which to create a consistency token.
+                Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.GenerateConsistencyTokenResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "generate_consistency_token" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "generate_consistency_token"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.generate_consistency_token,
+                default_retry=self._method_configs["GenerateConsistencyToken"].retry,
+                default_timeout=self._method_configs[
+                    "GenerateConsistencyToken"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.GenerateConsistencyTokenRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["generate_consistency_token"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def check_consistency(
+        self,
+        name,
+        consistency_token,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Checks replication consistency based on a consistency token, that is, if
+        replication has caught up based on the conditions specified in the token
+        and the check request.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `consistency_token`:
+            >>> consistency_token = ''
+            >>>
+            >>> response = client.check_consistency(name, consistency_token)
+
+        Args:
+            name (str): The unique name of the Table for which to check replication consistency.
+                Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            consistency_token (str): The token created using GenerateConsistencyToken for the Table.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.CheckConsistencyResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "check_consistency" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "check_consistency"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.check_consistency,
+                default_retry=self._method_configs["CheckConsistency"].retry,
+                default_timeout=self._method_configs["CheckConsistency"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.CheckConsistencyRequest(
+            name=name, consistency_token=consistency_token
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["check_consistency"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def snapshot_table(
+        self,
+        name,
+        cluster,
+        snapshot_id,
+        description,
+        ttl=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new snapshot in the specified cluster from the specified
+        source table. The cluster and the table must be in the same instance.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = ''
+            >>>
+            >>> # TODO: Initialize `snapshot_id`:
+            >>> snapshot_id = ''
+            >>>
+            >>> # TODO: Initialize `description`:
+            >>> description = ''
+            >>>
+            >>> response = client.snapshot_table(name, cluster, snapshot_id, description)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): The unique name of the table to have the snapshot taken. Values are of
+                the form ``projects/<project>/instances/<instance>/tables/<table>``.
+            cluster (str): The name of the cluster where the snapshot will be created in. Values
+                are of the form
+                ``projects/<project>/instances/<instance>/clusters/<cluster>``.
+            snapshot_id (str): 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``.
+            description (str): Description of the snapshot.
+            ttl (Union[dict, ~google.cloud.bigtable_admin_v2.types.Duration]): 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
+                amount of time a snapshot can stay active is 7 days. If 'ttl' is not
+                specified, the default value of 24 hours will be used.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_admin_v2.types.Duration`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "snapshot_table" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "snapshot_table"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.snapshot_table,
+                default_retry=self._method_configs["SnapshotTable"].retry,
+                default_timeout=self._method_configs["SnapshotTable"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.SnapshotTableRequest(
+            name=name,
+            cluster=cluster,
+            snapshot_id=snapshot_id,
+            description=description,
+            ttl=ttl,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["snapshot_table"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            table_pb2.Snapshot,
+            metadata_type=bigtable_table_admin_pb2.SnapshotTableMetadata,
+        )
+
+    def get_snapshot(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets metadata information about the specified snapshot.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.snapshot_path('[PROJECT]', '[INSTANCE]', '[CLUSTER]', '[SNAPSHOT]')
+            >>>
+            >>> response = client.get_snapshot(name)
+
+        Args:
+            name (str): The unique name of the requested snapshot. Values are of the form
+                ``projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_admin_v2.types.Snapshot` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_snapshot" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_snapshot"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_snapshot,
+                default_retry=self._method_configs["GetSnapshot"].retry,
+                default_timeout=self._method_configs["GetSnapshot"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.GetSnapshotRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_snapshot"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_snapshots(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all snapshots associated with the specified cluster.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> parent = client.cluster_path('[PROJECT]', '[INSTANCE]', '[CLUSTER]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_snapshots(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_snapshots(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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/-``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.bigtable_admin_v2.types.Snapshot` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_snapshots" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_snapshots"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_snapshots,
+                default_retry=self._method_configs["ListSnapshots"].retry,
+                default_timeout=self._method_configs["ListSnapshots"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.ListSnapshotsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_snapshots"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="snapshots",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_snapshot(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes the specified snapshot.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_admin_v2
+            >>>
+            >>> client = bigtable_admin_v2.BigtableTableAdminClient()
+            >>>
+            >>> name = client.snapshot_path('[PROJECT]', '[INSTANCE]', '[CLUSTER]', '[SNAPSHOT]')
+            >>>
+            >>> client.delete_snapshot(name)
+
+        Args:
+            name (str): The unique name of the snapshot to be deleted. Values are of the form
+                ``projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_snapshot" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_snapshot"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_snapshot,
+                default_retry=self._method_configs["DeleteSnapshot"].retry,
+                default_timeout=self._method_configs["DeleteSnapshot"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_table_admin_pb2.DeleteSnapshotRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_snapshot"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client_config.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client_config.py
new file mode 100644
index 000000000000..1a3f59a06023
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client_config.py
@@ -0,0 +1,115 @@
+config = {
+    "interfaces": {
+        "google.bigtable.admin.v2.BigtableTableAdmin": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "idempotent_params": {
+                    "initial_retry_delay_millis": 1000,
+                    "retry_delay_multiplier": 2.0,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 60000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                },
+                "non_idempotent_params": {
+                    "initial_retry_delay_millis": 0,
+                    "retry_delay_multiplier": 1.0,
+                    "max_retry_delay_millis": 0,
+                    "initial_rpc_timeout_millis": 60000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 60000,
+                },
+                "non_idempotent_heavy_params": {
+                    "initial_retry_delay_millis": 0,
+                    "retry_delay_multiplier": 1.0,
+                    "max_retry_delay_millis": 0,
+                    "initial_rpc_timeout_millis": 300000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 300000,
+                    "total_timeout_millis": 300000,
+                },
+                "drop_row_range_params": {
+                    "initial_retry_delay_millis": 0,
+                    "retry_delay_multiplier": 1.0,
+                    "max_retry_delay_millis": 0,
+                    "initial_rpc_timeout_millis": 3600000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 3600000,
+                    "total_timeout_millis": 3600000,
+                },
+            },
+            "methods": {
+                "CreateTable": {
+                    "timeout_millis": 130000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_heavy_params",
+                },
+                "CreateTableFromSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "ListTables": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "GetTable": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "DeleteTable": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "ModifyColumnFamilies": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_heavy_params",
+                },
+                "DropRowRange": {
+                    "timeout_millis": 900000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "drop_row_range_params",
+                },
+                "GenerateConsistencyToken": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "CheckConsistency": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "SnapshotTable": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "GetSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "ListSnapshots": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "DeleteSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+            },
+        }
+    }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/enums.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/enums.py
new file mode 100644
index 000000000000..ba847ea35974
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/enums.py
@@ -0,0 +1,179 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class StorageType(enum.IntEnum):
+    """
+    Storage media types for persisting Bigtable data.
+
+    Attributes:
+      STORAGE_TYPE_UNSPECIFIED (int): The user did not specify a storage type.
+      SSD (int): Flash (SSD) storage should be used.
+      HDD (int): Magnetic drive (HDD) storage should be used.
+    """
+
+    STORAGE_TYPE_UNSPECIFIED = 0
+    SSD = 1
+    HDD = 2
+
+
+class Cluster(object):
+    class State(enum.IntEnum):
+        """
+        Possible states of a cluster.
+
+        Attributes:
+          STATE_NOT_KNOWN (int): The state of the cluster could not be determined.
+          READY (int): The cluster has been successfully created and is ready to serve requests.
+          CREATING (int): The cluster is currently being created, and may be destroyed
+          if the creation process encounters an error.
+          A cluster may not be able to serve requests while being created.
+          RESIZING (int): The cluster is currently being resized, and may revert to its previous
+          node count if the process encounters an error.
+          A cluster is still capable of serving requests while being resized,
+          but may exhibit performance as if its number of allocated nodes is
+          between the starting and requested states.
+          DISABLED (int): The cluster has no backing nodes. The data (tables) still
+          exist, but no operations can be performed on the cluster.
+        """
+
+        STATE_NOT_KNOWN = 0
+        READY = 1
+        CREATING = 2
+        RESIZING = 3
+        DISABLED = 4
+
+
+class Instance(object):
+    class State(enum.IntEnum):
+        """
+        Possible states of an instance.
+
+        Attributes:
+          STATE_NOT_KNOWN (int): The state of the instance could not be determined.
+          READY (int): The instance has been successfully created and can serve requests
+          to its tables.
+          CREATING (int): The instance is currently being created, and may be destroyed
+          if the creation process encounters an error.
+        """
+
+        STATE_NOT_KNOWN = 0
+        READY = 1
+        CREATING = 2
+
+    class Type(enum.IntEnum):
+        """
+        The type of the instance.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): The type of the instance is unspecified. If set when creating an
+          instance, a ``PRODUCTION`` instance will be created. If set when
+          updating an instance, the type will be left unchanged.
+          PRODUCTION (int): An instance meant for production use. ``serve_nodes`` must be set on the
+          cluster.
+          DEVELOPMENT (int): The instance is meant for development and testing purposes only; it has
+          no performance or uptime guarantees and is not covered by SLA. After a
+          development instance is created, it can be upgraded by updating the
+          instance to type ``PRODUCTION``. An instance created as a production
+          instance cannot be changed to a development instance. When creating a
+          development instance, ``serve_nodes`` on the cluster must not be set.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        PRODUCTION = 1
+        DEVELOPMENT = 2
+
+
+class Snapshot(object):
+    class State(enum.IntEnum):
+        """
+        Possible states of a snapshot.
+
+        Attributes:
+          STATE_NOT_KNOWN (int): The state of the snapshot could not be determined.
+          READY (int): The snapshot has been successfully created and can serve all requests.
+          CREATING (int): The snapshot is currently being created, and may be destroyed if the
+          creation process encounters an error. A snapshot may not be restored to a
+          table while it is being created.
+        """
+
+        STATE_NOT_KNOWN = 0
+        READY = 1
+        CREATING = 2
+
+
+class Table(object):
+    class TimestampGranularity(enum.IntEnum):
+        """
+        Possible timestamp granularities to use when keeping multiple versions
+        of data in a table.
+
+        Attributes:
+          TIMESTAMP_GRANULARITY_UNSPECIFIED (int): The user did not specify a granularity. Should not be returned.
+          When specified during table creation, MILLIS will be used.
+          MILLIS (int): The table keeps data versioned at a granularity of 1ms.
+        """
+
+        TIMESTAMP_GRANULARITY_UNSPECIFIED = 0
+        MILLIS = 1
+
+    class View(enum.IntEnum):
+        """
+        Defines a view over a table's fields.
+
+        Attributes:
+          VIEW_UNSPECIFIED (int): Uses the default view for each method as documented in its request.
+          NAME_ONLY (int): Only populates ``name``.
+          SCHEMA_VIEW (int): Only populates ``name`` and fields related to the table's schema.
+          REPLICATION_VIEW (int): Only populates ``name`` and fields related to the table's replication
+          state.
+          FULL (int): Populates all fields.
+        """
+
+        VIEW_UNSPECIFIED = 0
+        NAME_ONLY = 1
+        SCHEMA_VIEW = 2
+        REPLICATION_VIEW = 3
+        FULL = 4
+
+    class ClusterState(object):
+        class ReplicationState(enum.IntEnum):
+            """
+            Table replication states.
+
+            Attributes:
+              STATE_NOT_KNOWN (int): The replication state of the table is unknown in this cluster.
+              INITIALIZING (int): The cluster was recently created, and the table must finish copying
+              over pre-existing data from other clusters before it can begin
+              receiving live replication updates and serving Data API requests.
+              PLANNED_MAINTENANCE (int): The table is temporarily unable to serve Data API requests from this
+              cluster due to planned internal maintenance.
+              UNPLANNED_MAINTENANCE (int): The table is temporarily unable to serve Data API requests from this
+              cluster due to unplanned or emergency maintenance.
+              READY (int): The table can serve Data API requests from this cluster. Depending on
+              replication delay, reads may not immediately reflect the state of the
+              table in other clusters.
+            """
+
+            STATE_NOT_KNOWN = 0
+            INITIALIZING = 1
+            PLANNED_MAINTENANCE = 2
+            UNPLANNED_MAINTENANCE = 3
+            READY = 4
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/__init__.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/bigtable_instance_admin_grpc_transport.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/bigtable_instance_admin_grpc_transport.py
new file mode 100644
index 000000000000..afb72e0c8ab9
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/bigtable_instance_admin_grpc_transport.py
@@ -0,0 +1,377 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2_grpc
+
+
+class BigtableInstanceAdminGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.bigtable.admin.v2 BigtableInstanceAdmin API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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/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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="bigtableadmin.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "bigtable_instance_admin_stub": bigtable_instance_admin_pb2_grpc.BigtableInstanceAdminStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="bigtableadmin.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_instance(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.create_instance`.
+
+        Create an instance within a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].CreateInstance
+
+    @property
+    def get_instance(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.get_instance`.
+
+        Gets information about an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].GetInstance
+
+    @property
+    def list_instances(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.list_instances`.
+
+        Lists information about instances in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].ListInstances
+
+    @property
+    def update_instance(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.update_instance`.
+
+        Updates an instance within a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].UpdateInstance
+
+    @property
+    def partial_update_instance(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.partial_update_instance`.
+
+        Partially updates an instance within a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].PartialUpdateInstance
+
+    @property
+    def delete_instance(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.delete_instance`.
+
+        Delete an instance from a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].DeleteInstance
+
+    @property
+    def create_cluster(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.create_cluster`.
+
+        Creates a cluster within an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].CreateCluster
+
+    @property
+    def get_cluster(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.get_cluster`.
+
+        Gets information about a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].GetCluster
+
+    @property
+    def list_clusters(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.list_clusters`.
+
+        Lists information about clusters in an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].ListClusters
+
+    @property
+    def update_cluster(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.update_cluster`.
+
+        Updates a cluster within an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].UpdateCluster
+
+    @property
+    def delete_cluster(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.delete_cluster`.
+
+        Deletes a cluster from an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].DeleteCluster
+
+    @property
+    def create_app_profile(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.create_app_profile`.
+
+        Creates an app profile within an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].CreateAppProfile
+
+    @property
+    def get_app_profile(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.get_app_profile`.
+
+        Gets information about an app profile.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].GetAppProfile
+
+    @property
+    def list_app_profiles(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.list_app_profiles`.
+
+        Lists information about app profiles in an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].ListAppProfiles
+
+    @property
+    def update_app_profile(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.update_app_profile`.
+
+        Updates an app profile within an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].UpdateAppProfile
+
+    @property
+    def delete_app_profile(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.delete_app_profile`.
+
+        Deletes an app profile from an instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].DeleteAppProfile
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.get_iam_policy`.
+
+        Gets the access control policy for an instance resource. Returns an empty
+        policy if an instance exists but does not have a policy set.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].GetIamPolicy
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.set_iam_policy`.
+
+        Sets the access control policy on an instance resource. Replaces any
+        existing policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].SetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`BigtableInstanceAdminClient.test_iam_permissions`.
+
+        Returns permissions that the caller has on the specified instance resource.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_instance_admin_stub"].TestIamPermissions
diff --git a/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/bigtable_table_admin_grpc_transport.py b/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/bigtable_table_admin_grpc_transport.py
new file mode 100644
index 000000000000..7b4432130eae
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/gapic/transports/bigtable_table_admin_grpc_transport.py
@@ -0,0 +1,341 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.bigtable_admin_v2.proto import bigtable_table_admin_pb2_grpc
+
+
+class BigtableTableAdminGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.bigtable.admin.v2 BigtableTableAdmin API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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/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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="bigtableadmin.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "bigtable_table_admin_stub": bigtable_table_admin_pb2_grpc.BigtableTableAdminStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="bigtableadmin.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_table(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.create_table`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].CreateTable
+
+    @property
+    def create_table_from_snapshot(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.create_table_from_snapshot`.
+
+        Creates a new table from the specified snapshot. The target table must
+        not exist. The snapshot and the table must be in the same instance.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].CreateTableFromSnapshot
+
+    @property
+    def list_tables(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.list_tables`.
+
+        Lists all tables served from a specified instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].ListTables
+
+    @property
+    def get_table(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.get_table`.
+
+        Gets metadata information about the specified table.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].GetTable
+
+    @property
+    def delete_table(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.delete_table`.
+
+        Permanently deletes a specified table and all of its data.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].DeleteTable
+
+    @property
+    def modify_column_families(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.modify_column_families`.
+
+        Performs a series of column family modifications on the specified table.
+        Either all or none of the modifications will occur before this method
+        returns, but data requests received prior to that point may see a table
+        where only some modifications have taken effect.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].ModifyColumnFamilies
+
+    @property
+    def drop_row_range(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.drop_row_range`.
+
+        Permanently drop/delete a row range from a specified table. The request can
+        specify whether to delete all rows in a table, or only those that match a
+        particular prefix.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].DropRowRange
+
+    @property
+    def generate_consistency_token(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.generate_consistency_token`.
+
+        Generates a consistency token for a Table, which can be used in
+        CheckConsistency to check whether mutations to the table that finished
+        before this call started have been replicated. The tokens will be available
+        for 90 days.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].GenerateConsistencyToken
+
+    @property
+    def check_consistency(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.check_consistency`.
+
+        Checks replication consistency based on a consistency token, that is, if
+        replication has caught up based on the conditions specified in the token
+        and the check request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].CheckConsistency
+
+    @property
+    def snapshot_table(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.snapshot_table`.
+
+        Creates a new snapshot in the specified cluster from the specified
+        source table. The cluster and the table must be in the same instance.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].SnapshotTable
+
+    @property
+    def get_snapshot(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.get_snapshot`.
+
+        Gets metadata information about the specified snapshot.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].GetSnapshot
+
+    @property
+    def list_snapshots(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.list_snapshots`.
+
+        Lists all snapshots associated with the specified cluster.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].ListSnapshots
+
+    @property
+    def delete_snapshot(self):
+        """Return the gRPC stub for :meth:`BigtableTableAdminClient.delete_snapshot`.
+
+        Permanently deletes the specified snapshot.
+
+        Note: This is a private alpha release of Cloud Bigtable snapshots. This
+        feature is not currently available to most Cloud Bigtable customers. This
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_table_admin_stub"].DeleteSnapshot
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/__init__.py b/bigtable/google/cloud/bigtable_admin_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_data.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_data.proto
new file mode 100644
index 000000000000..ca3b663d8661
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_data.proto
@@ -0,0 +1,94 @@
+// 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.bigtable.admin.cluster.v1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/cluster/v1;cluster";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableClusterDataProto";
+option java_package = "com.google.bigtable.admin.cluster.v1";
+
+
+// A physical location in which a particular project can allocate Cloud BigTable
+// resources.
+message Zone {
+  // Possible states of a zone.
+  enum Status {
+    // The state of the zone is unknown or unspecified.
+    UNKNOWN = 0;
+
+    // The zone is in a good state.
+    OK = 1;
+
+    // The zone is down for planned maintenance.
+    PLANNED_MAINTENANCE = 2;
+
+    // The zone is down for emergency or unplanned maintenance.
+    EMERGENCY_MAINENANCE = 3;
+  }
+
+  // A permanent unique identifier for the zone.
+  // Values are of the form projects/<project>/zones/[a-z][-a-z0-9]*
+  string name = 1;
+
+  // The name of this zone as it appears in UIs.
+  string display_name = 2;
+
+  // The current state of this zone.
+  Status status = 3;
+}
+
+// An isolated set of Cloud BigTable resources on which tables can be hosted.
+message Cluster {
+  // A permanent unique identifier for the cluster. For technical reasons, the
+  // zone in which the cluster resides is included here.
+  // Values are of the form
+  // projects/<project>/zones/<zone>/clusters/[a-z][-a-z0-9]*
+  string name = 1;
+
+  // The operation currently running on the cluster, if any.
+  // This cannot be set directly, only through CreateCluster, UpdateCluster,
+  // or UndeleteCluster. Calls to these methods will be rejected if
+  // "current_operation" is already set.
+  google.longrunning.Operation current_operation = 3;
+
+  // The descriptive name for this cluster as it appears in UIs.
+  // Must be unique per zone.
+  string display_name = 4;
+
+  // The number of serve nodes allocated to this cluster.
+  int32 serve_nodes = 5;
+
+  // What storage type to use for tables in this cluster. Only configurable at
+  // cluster creation time. If unspecified, STORAGE_SSD will be used.
+  StorageType default_storage_type = 8;
+}
+
+enum StorageType {
+  // The storage type used is unspecified.
+  STORAGE_UNSPECIFIED = 0;
+
+  // Data will be stored in SSD, providing low and consistent latencies.
+  STORAGE_SSD = 1;
+
+  // Data will be stored in HDD, providing high and less predictable
+  // latencies.
+  STORAGE_HDD = 2;
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_service.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_service.proto
new file mode 100644
index 000000000000..038fcc46397f
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_service.proto
@@ -0,0 +1,130 @@
+// 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.bigtable.admin.cluster.v1;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/cluster/v1/bigtable_cluster_data.proto";
+import "google/bigtable/admin/cluster/v1/bigtable_cluster_service_messages.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/cluster/v1;cluster";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableClusterServicesProto";
+option java_package = "com.google.bigtable.admin.cluster.v1";
+
+
+// Service for managing zonal Cloud Bigtable resources.
+service BigtableClusterService {
+  // Lists the supported zones for the given project.
+  rpc ListZones(ListZonesRequest) returns (ListZonesResponse) {
+    option (google.api.http) = { get: "/v1/{name=projects/*}/zones" };
+  }
+
+  // Gets information about a particular cluster.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = { get: "/v1/{name=projects/*/zones/*/clusters/*}" };
+  }
+
+  // Lists all clusters in the given project, along with any zones for which
+  // cluster information could not be retrieved.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = { get: "/v1/{name=projects/*}/aggregated/clusters" };
+  }
+
+  // Creates a cluster and begins preparing it to begin serving. The returned
+  // cluster embeds as its "current_operation" a long-running operation which
+  // can be used to track the progress of turning up the new cluster.
+  // Immediately upon completion of this request:
+  //  * The cluster will be readable via the API, with all requested attributes
+  //    but no allocated resources.
+  // Until completion of the embedded operation:
+  //  * Cancelling the operation will render the cluster immediately unreadable
+  //    via the API.
+  //  * All other attempts to modify or delete the cluster will be rejected.
+  // Upon completion of the embedded operation:
+  //  * Billing for all successfully-allocated resources will begin (some types
+  //    may have lower than the requested levels).
+  //  * New tables can be created in the cluster.
+  //  * The cluster's allocated resource levels will be readable via the API.
+  // The embedded operation's "metadata" field type is
+  // [CreateClusterMetadata][google.bigtable.admin.cluster.v1.CreateClusterMetadata] The embedded operation's "response" field type is
+  // [Cluster][google.bigtable.admin.cluster.v1.Cluster], if successful.
+  rpc CreateCluster(CreateClusterRequest) returns (Cluster) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*}/clusters" body: "*" };
+  }
+
+  // Updates a cluster, and begins allocating or releasing resources as
+  // requested. The returned cluster embeds as its "current_operation" a
+  // long-running operation which can be used to track the progress of updating
+  // the cluster.
+  // Immediately upon completion of this request:
+  //  * For resource types where a decrease in the cluster's allocation has been
+  //    requested, billing will be based on the newly-requested level.
+  // Until completion of the embedded operation:
+  //  * Cancelling the operation will set its metadata's "cancelled_at_time",
+  //    and begin restoring resources to their pre-request values. The operation
+  //    is guaranteed to succeed at undoing all resource changes, after which
+  //    point it will terminate with a CANCELLED status.
+  //  * All other attempts to modify or delete the cluster will be rejected.
+  //  * Reading the cluster via the API will continue to give the pre-request
+  //    resource levels.
+  // Upon completion of the embedded operation:
+  //  * Billing will begin for all successfully-allocated resources (some types
+  //    may have lower than the requested levels).
+  //  * All newly-reserved resources will be available for serving the cluster's
+  //    tables.
+  //  * The cluster's new resource levels will be readable via the API.
+  // [UpdateClusterMetadata][google.bigtable.admin.cluster.v1.UpdateClusterMetadata] The embedded operation's "response" field type is
+  // [Cluster][google.bigtable.admin.cluster.v1.Cluster], if successful.
+  rpc UpdateCluster(Cluster) returns (Cluster) {
+    option (google.api.http) = { put: "/v1/{name=projects/*/zones/*/clusters/*}" body: "*" };
+  }
+
+  // Marks a cluster and all of its tables for permanent deletion in 7 days.
+  // Immediately upon completion of the request:
+  //  * Billing will cease for all of the cluster's reserved resources.
+  //  * The cluster's "delete_time" field will be set 7 days in the future.
+  // Soon afterward:
+  //  * All tables within the cluster will become unavailable.
+  // Prior to the cluster's "delete_time":
+  //  * The cluster can be recovered with a call to UndeleteCluster.
+  //  * All other attempts to modify or delete the cluster will be rejected.
+  // At the cluster's "delete_time":
+  //  * The cluster and *all of its tables* will immediately and irrevocably
+  //    disappear from the API, and their data will be permanently deleted.
+  rpc DeleteCluster(DeleteClusterRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v1/{name=projects/*/zones/*/clusters/*}" };
+  }
+
+  // Cancels the scheduled deletion of an cluster and begins preparing it to
+  // resume serving. The returned operation will also be embedded as the
+  // cluster's "current_operation".
+  // Immediately upon completion of this request:
+  //  * The cluster's "delete_time" field will be unset, protecting it from
+  //    automatic deletion.
+  // Until completion of the returned operation:
+  //  * The operation cannot be cancelled.
+  // Upon completion of the returned operation:
+  //  * Billing for the cluster's resources will resume.
+  //  * All tables within the cluster will be available.
+  // [UndeleteClusterMetadata][google.bigtable.admin.cluster.v1.UndeleteClusterMetadata] The embedded operation's "response" field type is
+  // [Cluster][google.bigtable.admin.cluster.v1.Cluster], if successful.
+  rpc UndeleteCluster(UndeleteClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*}:undelete" body: "" };
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_service_messages.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_service_messages.proto
new file mode 100644
index 000000000000..518d14dac8e0
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_cluster_service_messages.proto
@@ -0,0 +1,141 @@
+// 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.bigtable.admin.cluster.v1;
+
+import "google/bigtable/admin/cluster/v1/bigtable_cluster_data.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/cluster/v1;cluster";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableClusterServiceMessagesProto";
+option java_package = "com.google.bigtable.admin.cluster.v1";
+
+
+// Request message for BigtableClusterService.ListZones.
+message ListZonesRequest {
+  // The unique name of the project for which a list of supported zones is
+  // requested.
+  // Values are of the form projects/<project>
+  string name = 1;
+}
+
+// Response message for BigtableClusterService.ListZones.
+message ListZonesResponse {
+  // The list of requested zones.
+  repeated Zone zones = 1;
+}
+
+// Request message for BigtableClusterService.GetCluster.
+message GetClusterRequest {
+  // The unique name of the requested cluster.
+  // Values are of the form projects/<project>/zones/<zone>/clusters/<cluster>
+  string name = 1;
+}
+
+// Request message for BigtableClusterService.ListClusters.
+message ListClustersRequest {
+  // The unique name of the project for which a list of clusters is requested.
+  // Values are of the form projects/<project>
+  string name = 1;
+}
+
+// Response message for BigtableClusterService.ListClusters.
+message ListClustersResponse {
+  // The list of requested Clusters.
+  repeated Cluster clusters = 1;
+
+  // The zones for which clusters could not be retrieved.
+  repeated Zone failed_zones = 2;
+}
+
+// Request message for BigtableClusterService.CreateCluster.
+message CreateClusterRequest {
+  // The unique name of the zone in which to create the cluster.
+  // Values are of the form projects/<project>/zones/<zone>
+  string name = 1;
+
+  // The id to be used when referring to the new cluster within its zone,
+  // e.g. just the "test-cluster" section of the full name
+  // "projects/<project>/zones/<zone>/clusters/test-cluster".
+  string cluster_id = 2;
+
+  // The cluster to create.
+  // The "name", "delete_time", and "current_operation" fields must be left
+  // blank.
+  Cluster cluster = 3;
+}
+
+// Metadata type for the operation returned by
+// BigtableClusterService.CreateCluster.
+message CreateClusterMetadata {
+  // The request which prompted the creation of this operation.
+  CreateClusterRequest original_request = 1;
+
+  // The time at which original_request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// Metadata type for the operation returned by
+// BigtableClusterService.UpdateCluster.
+message UpdateClusterMetadata {
+  // The request which prompted the creation of this operation.
+  Cluster original_request = 1;
+
+  // The time at which original_request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which this operation was cancelled. If set, this operation is
+  // in the process of undoing itself (which is guaranteed to succeed) and
+  // cannot be cancelled again.
+  google.protobuf.Timestamp cancel_time = 3;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 4;
+}
+
+// Request message for BigtableClusterService.DeleteCluster.
+message DeleteClusterRequest {
+  // The unique name of the cluster to be deleted.
+  // Values are of the form projects/<project>/zones/<zone>/clusters/<cluster>
+  string name = 1;
+}
+
+// Request message for BigtableClusterService.UndeleteCluster.
+message UndeleteClusterRequest {
+  // The unique name of the cluster to be un-deleted.
+  // Values are of the form projects/<project>/zones/<zone>/clusters/<cluster>
+  string name = 1;
+}
+
+// Metadata type for the operation returned by
+// BigtableClusterService.UndeleteCluster.
+message UndeleteClusterMetadata {
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 1;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 2;
+}
+
+// Metadata type for operations initiated by the V2 BigtableAdmin service.
+// More complete information for such operations is available via the V2 API.
+message V2OperationMetadata {
+
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin.proto
new file mode 100644
index 000000000000..80ce42470736
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin.proto
@@ -0,0 +1,461 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/v2/instance.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/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableInstanceAdminProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+// Service for creating, configuring, and deleting Cloud Bigtable Instances and
+// Clusters. Provides access to the Instance and Cluster schemas only, not the
+// tables' metadata or data stored in those tables.
+service BigtableInstanceAdmin {
+  // Create an instance within a project.
+  rpc CreateInstance(CreateInstanceRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/instances"
+      body: "*"
+    };
+  }
+
+  // Gets information about an instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Lists information about instances in a project.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*}/instances"
+    };
+  }
+
+  // Updates an instance within a project.
+  rpc UpdateInstance(Instance) returns (Instance) {
+    option (google.api.http) = {
+      put: "/v2/{name=projects/*/instances/*}"
+      body: "*"
+    };
+  }
+
+  // Partially updates an instance within a project.
+  rpc PartialUpdateInstance(PartialUpdateInstanceRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v2/{instance.name=projects/*/instances/*}"
+      body: "instance"
+    };
+  }
+
+  // Delete an instance from a project.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Creates a cluster within an instance.
+  rpc CreateCluster(CreateClusterRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/clusters"
+      body: "cluster"
+    };
+  }
+
+  // Gets information about a cluster.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/clusters/*}"
+    };
+  }
+
+  // Lists information about clusters in an instance.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*}/clusters"
+    };
+  }
+
+  // Updates a cluster within an instance.
+  rpc UpdateCluster(Cluster) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      put: "/v2/{name=projects/*/instances/*/clusters/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes a cluster from an instance.
+  rpc DeleteCluster(DeleteClusterRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/clusters/*}"
+    };
+  }
+
+  // Creates an app profile within an instance.
+  rpc CreateAppProfile(CreateAppProfileRequest) returns (AppProfile) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/appProfiles"
+      body: "app_profile"
+    };
+  }
+
+  // Gets information about an app profile.
+  rpc GetAppProfile(GetAppProfileRequest) returns (AppProfile) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/appProfiles/*}"
+    };
+  }
+
+  // Lists information about app profiles in an instance.
+  rpc ListAppProfiles(ListAppProfilesRequest)
+      returns (ListAppProfilesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*}/appProfiles"
+    };
+  }
+
+  // Updates an app profile within an instance.
+  rpc UpdateAppProfile(UpdateAppProfileRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v2/{app_profile.name=projects/*/instances/*/appProfiles/*}"
+      body: "app_profile"
+    };
+  }
+
+  // Deletes an app profile from an instance.
+  rpc DeleteAppProfile(DeleteAppProfileRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/appProfiles/*}"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v2/{resource=projects/*/instances/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Sets the access control policy on an instance 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/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Returns permissions that the caller has on the specified instance resource.
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
+      returns (google.iam.v1.TestIamPermissionsResponse) {
+    option (google.api.http) = {
+      post: "/v2/{resource=projects/*/instances/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // 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;
+
+  // The instance to create.
+  // Fields marked `OutputOnly` must be left blank.
+  Instance instance = 3;
+
+  // 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<string, Cluster> clusters = 4;
+}
+
+// Request message for BigtableInstanceAdmin.GetInstance.
+message GetInstanceRequest {
+  // The unique name of the requested instance. Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  string name = 1;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // DEPRECATED: This field is unused and ignored.
+  string page_token = 2;
+}
+
+// Response message for BigtableInstanceAdmin.ListInstances.
+message ListInstancesResponse {
+  // The list of requested instances.
+  repeated Instance instances = 1;
+
+  // Locations from which Instance information could not be retrieved,
+  // due to an outage or some other transient condition.
+  // Instances whose Clusters are all in one of the failed locations
+  // may be missing from `instances`, and Instances with at least one
+  // Cluster in a failed location may only have partial information returned.
+  // Values are of the form `projects/<project>/locations/<zone_id>`
+  repeated string failed_locations = 2;
+
+  // DEPRECATED: This field is unused and ignored.
+  string next_page_token = 3;
+}
+
+// Request message for BigtableInstanceAdmin.PartialUpdateInstance.
+message PartialUpdateInstanceRequest {
+  // The Instance which will (partially) replace the current value.
+  Instance instance = 1;
+
+  // The subset of Instance fields which should be replaced.
+  // Must be explicitly set.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for BigtableInstanceAdmin.DeleteInstance.
+message DeleteInstanceRequest {
+  // The unique name of the instance to be deleted.
+  // Values are of the form `projects/<project>/instances/<instance>`.
+  string name = 1;
+}
+
+// Request message for BigtableInstanceAdmin.CreateCluster.
+message CreateClusterRequest {
+  // The unique name of the instance in which to create the new cluster.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // The cluster to be created.
+  // Fields marked `OutputOnly` must be left blank.
+  Cluster cluster = 3;
+}
+
+// Request message for BigtableInstanceAdmin.GetCluster.
+message GetClusterRequest {
+  // The unique name of the requested cluster. Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>`.
+  string name = 1;
+}
+
+// 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/<project>/instances/<instance>`.
+  // Use `<instance> = '-'` to list Clusters for all Instances in a project,
+  // e.g., `projects/myproject/instances/-`.
+  string parent = 1;
+
+  // DEPRECATED: This field is unused and ignored.
+  string page_token = 2;
+}
+
+// Response message for BigtableInstanceAdmin.ListClusters.
+message ListClustersResponse {
+  // The list of requested clusters.
+  repeated Cluster clusters = 1;
+
+  // Locations from which Cluster information could not be retrieved,
+  // due to an outage or some other transient condition.
+  // Clusters from these locations may be missing from `clusters`,
+  // or may only have partial information returned.
+  // Values are of the form `projects/<project>/locations/<zone_id>`
+  repeated string failed_locations = 2;
+
+  // DEPRECATED: This field is unused and ignored.
+  string next_page_token = 3;
+}
+
+// Request message for BigtableInstanceAdmin.DeleteCluster.
+message DeleteClusterRequest {
+  // The unique name of the cluster to be deleted. Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>`.
+  string name = 1;
+}
+
+// The metadata for the Operation returned by CreateInstance.
+message CreateInstanceMetadata {
+  // The request that prompted the initiation of this CreateInstance operation.
+  CreateInstanceRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by UpdateInstance.
+message UpdateInstanceMetadata {
+  // The request that prompted the initiation of this UpdateInstance operation.
+  PartialUpdateInstanceRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by CreateCluster.
+message CreateClusterMetadata {
+  // The request that prompted the initiation of this CreateCluster operation.
+  CreateClusterRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by UpdateCluster.
+message UpdateClusterMetadata {
+  // The request that prompted the initiation of this UpdateCluster operation.
+  Cluster original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// Request message for BigtableInstanceAdmin.CreateAppProfile.
+message CreateAppProfileRequest {
+  // The unique name of the instance in which to create the new app profile.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // The app profile to be created.
+  // Fields marked `OutputOnly` will be ignored.
+  AppProfile app_profile = 3;
+
+  // If true, ignore safety checks when creating the app profile.
+  bool ignore_warnings = 4;
+}
+
+// Request message for BigtableInstanceAdmin.GetAppProfile.
+message GetAppProfileRequest {
+  // The unique name of the requested app profile. Values are of the form
+  // `projects/<project>/instances/<instance>/appProfiles/<app_profile>`.
+  string name = 1;
+}
+
+// Request message for BigtableInstanceAdmin.ListAppProfiles.
+message ListAppProfilesRequest {
+  // The unique name of the instance for which a list of app profiles is
+  // requested. Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  // Use `<instance> = '-'` to list AppProfiles for all Instances in a project,
+  // e.g., `projects/myproject/instances/-`.
+  string parent = 1;
+
+  // Maximum number of results per page.
+  // CURRENTLY UNIMPLEMENTED AND IGNORED.
+  int32 page_size = 3;
+
+  // The value of `next_page_token` returned by a previous call.
+  string page_token = 2;
+}
+
+// Response message for BigtableInstanceAdmin.ListAppProfiles.
+message ListAppProfilesResponse {
+  // The list of requested app profiles.
+  repeated AppProfile app_profiles = 1;
+
+  // Set if not all app profiles could be returned in a single response.
+  // Pass this value to `page_token` in another request to get the next
+  // page of results.
+  string next_page_token = 2;
+
+  // Locations from which AppProfile information could not be retrieved,
+  // due to an outage or some other transient condition.
+  // AppProfiles from these locations may be missing from `app_profiles`.
+  // Values are of the form `projects/<project>/locations/<zone_id>`
+  repeated string failed_locations = 3;
+}
+
+// Request message for BigtableInstanceAdmin.UpdateAppProfile.
+message UpdateAppProfileRequest {
+  // The app profile which will (partially) replace the current value.
+  AppProfile app_profile = 1;
+
+  // The subset of app profile fields which should be replaced.
+  // If unset, all fields will be replaced.
+  google.protobuf.FieldMask update_mask = 2;
+
+  // If true, ignore safety checks when updating the app profile.
+  bool ignore_warnings = 3;
+}
+
+// Request message for BigtableInstanceAdmin.DeleteAppProfile.
+message DeleteAppProfileRequest {
+  // 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;
+
+  // If true, ignore safety checks when deleting the app profile.
+  bool ignore_warnings = 2;
+}
+
+// The metadata for the Operation returned by UpdateAppProfile.
+message UpdateAppProfileMetadata {}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin_pb2.py b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin_pb2.py
new file mode 100644
index 000000000000..01d3fa7e3a4d
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin_pb2.py
@@ -0,0 +1,2363 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable/admin_v2/proto/bigtable_instance_admin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigtable_admin_v2.proto import (
+    instance_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable/admin_v2/proto/bigtable_instance_admin.proto",
+    package="google.bigtable.admin.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.bigtable.admin.v2B\032BigtableInstanceAdminProtoP\001Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\252\002\036Google.Cloud.Bigtable.Admin.V2\312\002\036Google\\Cloud\\Bigtable\\Admin\\V2"
+    ),
+    serialized_pb=_b(
+        '\nBgoogle/cloud/bigtable/admin_v2/proto/bigtable_instance_admin.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x33google/cloud/bigtable/admin_v2/proto/instance.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x97\x02\n\x15\x43reateInstanceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0binstance_id\x18\x02 \x01(\t\x12\x34\n\x08instance\x18\x03 \x01(\x0b\x32".google.bigtable.admin.v2.Instance\x12O\n\x08\x63lusters\x18\x04 \x03(\x0b\x32=.google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry\x1aR\n\rClustersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x30\n\x05value\x18\x02 \x01(\x0b\x32!.google.bigtable.admin.v2.Cluster:\x02\x38\x01""\n\x12GetInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t":\n\x14ListInstancesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t"\x81\x01\n\x15ListInstancesResponse\x12\x35\n\tinstances\x18\x01 \x03(\x0b\x32".google.bigtable.admin.v2.Instance\x12\x18\n\x10\x66\x61iled_locations\x18\x02 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"\x85\x01\n\x1cPartialUpdateInstanceRequest\x12\x34\n\x08instance\x18\x01 \x01(\x0b\x32".google.bigtable.admin.v2.Instance\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"%\n\x15\x44\x65leteInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"n\n\x14\x43reateClusterRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\ncluster_id\x18\x02 \x01(\t\x12\x32\n\x07\x63luster\x18\x03 \x01(\x0b\x32!.google.bigtable.admin.v2.Cluster"!\n\x11GetClusterRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"9\n\x13ListClustersRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t"~\n\x14ListClustersResponse\x12\x33\n\x08\x63lusters\x18\x01 \x03(\x0b\x32!.google.bigtable.admin.v2.Cluster\x12\x18\n\x10\x66\x61iled_locations\x18\x02 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"$\n\x14\x44\x65leteClusterRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xc6\x01\n\x16\x43reateInstanceMetadata\x12I\n\x10original_request\x18\x01 \x01(\x0b\x32/.google.bigtable.admin.v2.CreateInstanceRequest\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xcd\x01\n\x16UpdateInstanceMetadata\x12P\n\x10original_request\x18\x01 \x01(\x0b\x32\x36.google.bigtable.admin.v2.PartialUpdateInstanceRequest\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xc4\x01\n\x15\x43reateClusterMetadata\x12H\n\x10original_request\x18\x01 \x01(\x0b\x32..google.bigtable.admin.v2.CreateClusterRequest\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xb7\x01\n\x15UpdateClusterMetadata\x12;\n\x10original_request\x18\x01 \x01(\x0b\x32!.google.bigtable.admin.v2.Cluster\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x95\x01\n\x17\x43reateAppProfileRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x02 \x01(\t\x12\x39\n\x0b\x61pp_profile\x18\x03 \x01(\x0b\x32$.google.bigtable.admin.v2.AppProfile\x12\x17\n\x0fignore_warnings\x18\x04 \x01(\x08"$\n\x14GetAppProfileRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x16ListAppProfilesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x02 \x01(\t"\x88\x01\n\x17ListAppProfilesResponse\x12:\n\x0c\x61pp_profiles\x18\x01 \x03(\x0b\x32$.google.bigtable.admin.v2.AppProfile\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x18\n\x10\x66\x61iled_locations\x18\x03 \x03(\t"\x9e\x01\n\x17UpdateAppProfileRequest\x12\x39\n\x0b\x61pp_profile\x18\x01 \x01(\x0b\x32$.google.bigtable.admin.v2.AppProfile\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x17\n\x0fignore_warnings\x18\x03 \x01(\x08"@\n\x17\x44\x65leteAppProfileRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x17\n\x0fignore_warnings\x18\x02 \x01(\x08"\x1a\n\x18UpdateAppProfileMetadata2\xaa\x17\n\x15\x42igtableInstanceAdmin\x12\x8e\x01\n\x0e\x43reateInstance\x12/.google.bigtable.admin.v2.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation",\x82\xd3\xe4\x93\x02&"!/v2/{parent=projects/*}/instances:\x01*\x12\x8a\x01\n\x0bGetInstance\x12,.google.bigtable.admin.v2.GetInstanceRequest\x1a".google.bigtable.admin.v2.Instance")\x82\xd3\xe4\x93\x02#\x12!/v2/{name=projects/*/instances/*}\x12\x9b\x01\n\rListInstances\x12..google.bigtable.admin.v2.ListInstancesRequest\x1a/.google.bigtable.admin.v2.ListInstancesResponse")\x82\xd3\xe4\x93\x02#\x12!/v2/{parent=projects/*}/instances\x12\x86\x01\n\x0eUpdateInstance\x12".google.bigtable.admin.v2.Instance\x1a".google.bigtable.admin.v2.Instance",\x82\xd3\xe4\x93\x02&\x1a!/v2/{name=projects/*/instances/*}:\x01*\x12\xac\x01\n\x15PartialUpdateInstance\x12\x36.google.bigtable.admin.v2.PartialUpdateInstanceRequest\x1a\x1d.google.longrunning.Operation"<\x82\xd3\xe4\x93\x02\x36\x32*/v2/{instance.name=projects/*/instances/*}:\x08instance\x12\x84\x01\n\x0e\x44\x65leteInstance\x12/.google.bigtable.admin.v2.DeleteInstanceRequest\x1a\x16.google.protobuf.Empty")\x82\xd3\xe4\x93\x02#*!/v2/{name=projects/*/instances/*}\x12\x9d\x01\n\rCreateCluster\x12..google.bigtable.admin.v2.CreateClusterRequest\x1a\x1d.google.longrunning.Operation"=\x82\xd3\xe4\x93\x02\x37",/v2/{parent=projects/*/instances/*}/clusters:\x07\x63luster\x12\x92\x01\n\nGetCluster\x12+.google.bigtable.admin.v2.GetClusterRequest\x1a!.google.bigtable.admin.v2.Cluster"4\x82\xd3\xe4\x93\x02.\x12,/v2/{name=projects/*/instances/*/clusters/*}\x12\xa3\x01\n\x0cListClusters\x12-.google.bigtable.admin.v2.ListClustersRequest\x1a..google.bigtable.admin.v2.ListClustersResponse"4\x82\xd3\xe4\x93\x02.\x12,/v2/{parent=projects/*/instances/*}/clusters\x12\x8a\x01\n\rUpdateCluster\x12!.google.bigtable.admin.v2.Cluster\x1a\x1d.google.longrunning.Operation"7\x82\xd3\xe4\x93\x02\x31\x1a,/v2/{name=projects/*/instances/*/clusters/*}:\x01*\x12\x8d\x01\n\rDeleteCluster\x12..google.bigtable.admin.v2.DeleteClusterRequest\x1a\x16.google.protobuf.Empty"4\x82\xd3\xe4\x93\x02.*,/v2/{name=projects/*/instances/*/clusters/*}\x12\xb1\x01\n\x10\x43reateAppProfile\x12\x31.google.bigtable.admin.v2.CreateAppProfileRequest\x1a$.google.bigtable.admin.v2.AppProfile"D\x82\xd3\xe4\x93\x02>"//v2/{parent=projects/*/instances/*}/appProfiles:\x0b\x61pp_profile\x12\x9e\x01\n\rGetAppProfile\x12..google.bigtable.admin.v2.GetAppProfileRequest\x1a$.google.bigtable.admin.v2.AppProfile"7\x82\xd3\xe4\x93\x02\x31\x12//v2/{name=projects/*/instances/*/appProfiles/*}\x12\xaf\x01\n\x0fListAppProfiles\x12\x30.google.bigtable.admin.v2.ListAppProfilesRequest\x1a\x31.google.bigtable.admin.v2.ListAppProfilesResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v2/{parent=projects/*/instances/*}/appProfiles\x12\xb6\x01\n\x10UpdateAppProfile\x12\x31.google.bigtable.admin.v2.UpdateAppProfileRequest\x1a\x1d.google.longrunning.Operation"P\x82\xd3\xe4\x93\x02J2;/v2/{app_profile.name=projects/*/instances/*/appProfiles/*}:\x0b\x61pp_profile\x12\x96\x01\n\x10\x44\x65leteAppProfile\x12\x31.google.bigtable.admin.v2.DeleteAppProfileRequest\x1a\x16.google.protobuf.Empty"7\x82\xd3\xe4\x93\x02\x31*//v2/{name=projects/*/instances/*/appProfiles/*}\x12\x88\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"=\x82\xd3\xe4\x93\x02\x37"2/v2/{resource=projects/*/instances/*}:getIamPolicy:\x01*\x12\x88\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"=\x82\xd3\xe4\x93\x02\x37"2/v2/{resource=projects/*/instances/*}:setIamPolicy:\x01*\x12\xae\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"C\x82\xd3\xe4\x93\x02="8/v2/{resource=projects/*/instances/*}:testIamPermissions:\x01*B\xbd\x01\n\x1c\x63om.google.bigtable.admin.v2B\x1a\x42igtableInstanceAdminProtoP\x01Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\xaa\x02\x1eGoogle.Cloud.Bigtable.Admin.V2\xca\x02\x1eGoogle\\Cloud\\Bigtable\\Admin\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEINSTANCEREQUEST_CLUSTERSENTRY = _descriptor.Descriptor(
+    name="ClustersEntry",
+    full_name="google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=570,
+    serialized_end=652,
+)
+
+_CREATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="CreateInstanceRequest",
+    full_name="google.bigtable.admin.v2.CreateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.CreateInstanceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.bigtable.admin.v2.CreateInstanceRequest.instance_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.bigtable.admin.v2.CreateInstanceRequest.instance",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.bigtable.admin.v2.CreateInstanceRequest.clusters",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CREATEINSTANCEREQUEST_CLUSTERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=373,
+    serialized_end=652,
+)
+
+
+_GETINSTANCEREQUEST = _descriptor.Descriptor(
+    name="GetInstanceRequest",
+    full_name="google.bigtable.admin.v2.GetInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.GetInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=654,
+    serialized_end=688,
+)
+
+
+_LISTINSTANCESREQUEST = _descriptor.Descriptor(
+    name="ListInstancesRequest",
+    full_name="google.bigtable.admin.v2.ListInstancesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.ListInstancesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.bigtable.admin.v2.ListInstancesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=690,
+    serialized_end=748,
+)
+
+
+_LISTINSTANCESRESPONSE = _descriptor.Descriptor(
+    name="ListInstancesResponse",
+    full_name="google.bigtable.admin.v2.ListInstancesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instances",
+            full_name="google.bigtable.admin.v2.ListInstancesResponse.instances",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="failed_locations",
+            full_name="google.bigtable.admin.v2.ListInstancesResponse.failed_locations",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.bigtable.admin.v2.ListInstancesResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=751,
+    serialized_end=880,
+)
+
+
+_PARTIALUPDATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="PartialUpdateInstanceRequest",
+    full_name="google.bigtable.admin.v2.PartialUpdateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.bigtable.admin.v2.PartialUpdateInstanceRequest.instance",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.bigtable.admin.v2.PartialUpdateInstanceRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=883,
+    serialized_end=1016,
+)
+
+
+_DELETEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="DeleteInstanceRequest",
+    full_name="google.bigtable.admin.v2.DeleteInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.DeleteInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1018,
+    serialized_end=1055,
+)
+
+
+_CREATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="CreateClusterRequest",
+    full_name="google.bigtable.admin.v2.CreateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.CreateClusterRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.bigtable.admin.v2.CreateClusterRequest.cluster_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.bigtable.admin.v2.CreateClusterRequest.cluster",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1057,
+    serialized_end=1167,
+)
+
+
+_GETCLUSTERREQUEST = _descriptor.Descriptor(
+    name="GetClusterRequest",
+    full_name="google.bigtable.admin.v2.GetClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.GetClusterRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1169,
+    serialized_end=1202,
+)
+
+
+_LISTCLUSTERSREQUEST = _descriptor.Descriptor(
+    name="ListClustersRequest",
+    full_name="google.bigtable.admin.v2.ListClustersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.ListClustersRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.bigtable.admin.v2.ListClustersRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1204,
+    serialized_end=1261,
+)
+
+
+_LISTCLUSTERSRESPONSE = _descriptor.Descriptor(
+    name="ListClustersResponse",
+    full_name="google.bigtable.admin.v2.ListClustersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.bigtable.admin.v2.ListClustersResponse.clusters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="failed_locations",
+            full_name="google.bigtable.admin.v2.ListClustersResponse.failed_locations",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.bigtable.admin.v2.ListClustersResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1263,
+    serialized_end=1389,
+)
+
+
+_DELETECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DeleteClusterRequest",
+    full_name="google.bigtable.admin.v2.DeleteClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.DeleteClusterRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1391,
+    serialized_end=1427,
+)
+
+
+_CREATEINSTANCEMETADATA = _descriptor.Descriptor(
+    name="CreateInstanceMetadata",
+    full_name="google.bigtable.admin.v2.CreateInstanceMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_request",
+            full_name="google.bigtable.admin.v2.CreateInstanceMetadata.original_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_time",
+            full_name="google.bigtable.admin.v2.CreateInstanceMetadata.request_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finish_time",
+            full_name="google.bigtable.admin.v2.CreateInstanceMetadata.finish_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1430,
+    serialized_end=1628,
+)
+
+
+_UPDATEINSTANCEMETADATA = _descriptor.Descriptor(
+    name="UpdateInstanceMetadata",
+    full_name="google.bigtable.admin.v2.UpdateInstanceMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_request",
+            full_name="google.bigtable.admin.v2.UpdateInstanceMetadata.original_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_time",
+            full_name="google.bigtable.admin.v2.UpdateInstanceMetadata.request_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finish_time",
+            full_name="google.bigtable.admin.v2.UpdateInstanceMetadata.finish_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1631,
+    serialized_end=1836,
+)
+
+
+_CREATECLUSTERMETADATA = _descriptor.Descriptor(
+    name="CreateClusterMetadata",
+    full_name="google.bigtable.admin.v2.CreateClusterMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_request",
+            full_name="google.bigtable.admin.v2.CreateClusterMetadata.original_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_time",
+            full_name="google.bigtable.admin.v2.CreateClusterMetadata.request_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finish_time",
+            full_name="google.bigtable.admin.v2.CreateClusterMetadata.finish_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1839,
+    serialized_end=2035,
+)
+
+
+_UPDATECLUSTERMETADATA = _descriptor.Descriptor(
+    name="UpdateClusterMetadata",
+    full_name="google.bigtable.admin.v2.UpdateClusterMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_request",
+            full_name="google.bigtable.admin.v2.UpdateClusterMetadata.original_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_time",
+            full_name="google.bigtable.admin.v2.UpdateClusterMetadata.request_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finish_time",
+            full_name="google.bigtable.admin.v2.UpdateClusterMetadata.finish_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2038,
+    serialized_end=2221,
+)
+
+
+_CREATEAPPPROFILEREQUEST = _descriptor.Descriptor(
+    name="CreateAppProfileRequest",
+    full_name="google.bigtable.admin.v2.CreateAppProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.CreateAppProfileRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.admin.v2.CreateAppProfileRequest.app_profile_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile",
+            full_name="google.bigtable.admin.v2.CreateAppProfileRequest.app_profile",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ignore_warnings",
+            full_name="google.bigtable.admin.v2.CreateAppProfileRequest.ignore_warnings",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2224,
+    serialized_end=2373,
+)
+
+
+_GETAPPPROFILEREQUEST = _descriptor.Descriptor(
+    name="GetAppProfileRequest",
+    full_name="google.bigtable.admin.v2.GetAppProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.GetAppProfileRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2375,
+    serialized_end=2411,
+)
+
+
+_LISTAPPPROFILESREQUEST = _descriptor.Descriptor(
+    name="ListAppProfilesRequest",
+    full_name="google.bigtable.admin.v2.ListAppProfilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.ListAppProfilesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.bigtable.admin.v2.ListAppProfilesRequest.page_size",
+            index=1,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.bigtable.admin.v2.ListAppProfilesRequest.page_token",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2413,
+    serialized_end=2492,
+)
+
+
+_LISTAPPPROFILESRESPONSE = _descriptor.Descriptor(
+    name="ListAppProfilesResponse",
+    full_name="google.bigtable.admin.v2.ListAppProfilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="app_profiles",
+            full_name="google.bigtable.admin.v2.ListAppProfilesResponse.app_profiles",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.bigtable.admin.v2.ListAppProfilesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="failed_locations",
+            full_name="google.bigtable.admin.v2.ListAppProfilesResponse.failed_locations",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2495,
+    serialized_end=2631,
+)
+
+
+_UPDATEAPPPROFILEREQUEST = _descriptor.Descriptor(
+    name="UpdateAppProfileRequest",
+    full_name="google.bigtable.admin.v2.UpdateAppProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="app_profile",
+            full_name="google.bigtable.admin.v2.UpdateAppProfileRequest.app_profile",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.bigtable.admin.v2.UpdateAppProfileRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ignore_warnings",
+            full_name="google.bigtable.admin.v2.UpdateAppProfileRequest.ignore_warnings",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2634,
+    serialized_end=2792,
+)
+
+
+_DELETEAPPPROFILEREQUEST = _descriptor.Descriptor(
+    name="DeleteAppProfileRequest",
+    full_name="google.bigtable.admin.v2.DeleteAppProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.DeleteAppProfileRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ignore_warnings",
+            full_name="google.bigtable.admin.v2.DeleteAppProfileRequest.ignore_warnings",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2794,
+    serialized_end=2858,
+)
+
+
+_UPDATEAPPPROFILEMETADATA = _descriptor.Descriptor(
+    name="UpdateAppProfileMetadata",
+    full_name="google.bigtable.admin.v2.UpdateAppProfileMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2860,
+    serialized_end=2886,
+)
+
+_CREATEINSTANCEREQUEST_CLUSTERSENTRY.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._CLUSTER
+)
+_CREATEINSTANCEREQUEST_CLUSTERSENTRY.containing_type = _CREATEINSTANCEREQUEST
+_CREATEINSTANCEREQUEST.fields_by_name[
+    "instance"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._INSTANCE
+)
+_CREATEINSTANCEREQUEST.fields_by_name[
+    "clusters"
+].message_type = _CREATEINSTANCEREQUEST_CLUSTERSENTRY
+_LISTINSTANCESRESPONSE.fields_by_name[
+    "instances"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._INSTANCE
+)
+_PARTIALUPDATEINSTANCEREQUEST.fields_by_name[
+    "instance"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._INSTANCE
+)
+_PARTIALUPDATEINSTANCEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATECLUSTERREQUEST.fields_by_name[
+    "cluster"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._CLUSTER
+)
+_LISTCLUSTERSRESPONSE.fields_by_name[
+    "clusters"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._CLUSTER
+)
+_CREATEINSTANCEMETADATA.fields_by_name[
+    "original_request"
+].message_type = _CREATEINSTANCEREQUEST
+_CREATEINSTANCEMETADATA.fields_by_name[
+    "request_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATEINSTANCEMETADATA.fields_by_name[
+    "finish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEINSTANCEMETADATA.fields_by_name[
+    "original_request"
+].message_type = _PARTIALUPDATEINSTANCEREQUEST
+_UPDATEINSTANCEMETADATA.fields_by_name[
+    "request_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEINSTANCEMETADATA.fields_by_name[
+    "finish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATECLUSTERMETADATA.fields_by_name[
+    "original_request"
+].message_type = _CREATECLUSTERREQUEST
+_CREATECLUSTERMETADATA.fields_by_name[
+    "request_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATECLUSTERMETADATA.fields_by_name[
+    "finish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATECLUSTERMETADATA.fields_by_name[
+    "original_request"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._CLUSTER
+)
+_UPDATECLUSTERMETADATA.fields_by_name[
+    "request_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATECLUSTERMETADATA.fields_by_name[
+    "finish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATEAPPPROFILEREQUEST.fields_by_name[
+    "app_profile"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._APPPROFILE
+)
+_LISTAPPPROFILESRESPONSE.fields_by_name[
+    "app_profiles"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._APPPROFILE
+)
+_UPDATEAPPPROFILEREQUEST.fields_by_name[
+    "app_profile"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._APPPROFILE
+)
+_UPDATEAPPPROFILEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+DESCRIPTOR.message_types_by_name["CreateInstanceRequest"] = _CREATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["GetInstanceRequest"] = _GETINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["ListInstancesRequest"] = _LISTINSTANCESREQUEST
+DESCRIPTOR.message_types_by_name["ListInstancesResponse"] = _LISTINSTANCESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "PartialUpdateInstanceRequest"
+] = _PARTIALUPDATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteInstanceRequest"] = _DELETEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["CreateClusterRequest"] = _CREATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["GetClusterRequest"] = _GETCLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersRequest"] = _LISTCLUSTERSREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersResponse"] = _LISTCLUSTERSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteClusterRequest"] = _DELETECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["CreateInstanceMetadata"] = _CREATEINSTANCEMETADATA
+DESCRIPTOR.message_types_by_name["UpdateInstanceMetadata"] = _UPDATEINSTANCEMETADATA
+DESCRIPTOR.message_types_by_name["CreateClusterMetadata"] = _CREATECLUSTERMETADATA
+DESCRIPTOR.message_types_by_name["UpdateClusterMetadata"] = _UPDATECLUSTERMETADATA
+DESCRIPTOR.message_types_by_name["CreateAppProfileRequest"] = _CREATEAPPPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["GetAppProfileRequest"] = _GETAPPPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["ListAppProfilesRequest"] = _LISTAPPPROFILESREQUEST
+DESCRIPTOR.message_types_by_name["ListAppProfilesResponse"] = _LISTAPPPROFILESRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateAppProfileRequest"] = _UPDATEAPPPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteAppProfileRequest"] = _DELETEAPPPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateAppProfileMetadata"] = _UPDATEAPPPROFILEMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateInstanceRequest",
+    (_message.Message,),
+    dict(
+        ClustersEntry=_reflection.GeneratedProtocolMessageType(
+            "ClustersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CREATEINSTANCEREQUEST_CLUSTERSENTRY,
+                __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2"
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry)
+            ),
+        ),
+        DESCRIPTOR=_CREATEINSTANCEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.CreateInstance.
+  
+  
+  Attributes:
+      parent:
+          The unique name of the project in which to create the new
+          instance. Values are of the form ``projects/<project>``.
+      instance_id:
+          The ID to be used when referring to the new instance within
+          its project, e.g., just ``myinstance`` rather than
+          ``projects/myproject/instances/myinstance``.
+      instance:
+          The instance to create. Fields marked ``OutputOnly`` must be
+          left blank.
+      clusters:
+          The clusters to be created within the instance, mapped by
+          desired cluster ID, e.g., just ``mycluster`` rather than ``pro
+          jects/myproject/instances/myinstance/clusters/mycluster``.
+          Fields marked ``OutputOnly`` must be left blank. Currently, at
+          most two clusters can be specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstanceRequest)
+_sym_db.RegisterMessage(CreateInstanceRequest.ClustersEntry)
+
+GetInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSTANCEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.GetInstance.
+  
+  
+  Attributes:
+      name:
+          The unique name of the requested instance. Values are of the
+          form ``projects/<project>/instances/<instance>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInstanceRequest)
+
+ListInstancesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.ListInstances.
+  
+  
+  Attributes:
+      parent:
+          The unique name of the project for which a list of instances
+          is requested. Values are of the form ``projects/<project>``.
+      page_token:
+          DEPRECATED: This field is unused and ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListInstancesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesRequest)
+
+ListInstancesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Response message for BigtableInstanceAdmin.ListInstances.
+  
+  
+  Attributes:
+      instances:
+          The list of requested instances.
+      failed_locations:
+          Locations from which Instance information could not be
+          retrieved, due to an outage or some other transient condition.
+          Instances whose Clusters are all in one of the failed
+          locations may be missing from ``instances``, and Instances
+          with at least one Cluster in a failed location may only have
+          partial information returned. Values are of the form
+          ``projects/<project>/locations/<zone_id>``
+      next_page_token:
+          DEPRECATED: This field is unused and ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListInstancesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesResponse)
+
+PartialUpdateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "PartialUpdateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTIALUPDATEINSTANCEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.PartialUpdateInstance.
+  
+  
+  Attributes:
+      instance:
+          The Instance which will (partially) replace the current value.
+      update_mask:
+          The subset of Instance fields which should be replaced. Must
+          be explicitly set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.PartialUpdateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(PartialUpdateInstanceRequest)
+
+DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINSTANCEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.DeleteInstance.
+  
+  
+  Attributes:
+      name:
+          The unique name of the instance to be deleted. Values are of
+          the form ``projects/<project>/instances/<instance>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteInstanceRequest)
+
+CreateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLUSTERREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.CreateCluster.
+  
+  
+  Attributes:
+      parent:
+          The unique name of the instance in which to create the new
+          cluster. Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      cluster_id:
+          The ID to be used when referring to the new cluster within its
+          instance, e.g., just ``mycluster`` rather than ``projects/mypr
+          oject/instances/myinstance/clusters/mycluster``.
+      cluster:
+          The cluster to be created. Fields marked ``OutputOnly`` must
+          be left blank.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateClusterRequest)
+
+GetClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "GetClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCLUSTERREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.GetCluster.
+  
+  
+  Attributes:
+      name:
+          The unique name of the requested cluster. Values are of the
+          form ``projects/<project>/instances/<instance>/clusters/<clust
+          er>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetClusterRequest)
+
+ListClustersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListClustersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.ListClusters.
+  
+  
+  Attributes:
+      parent:
+          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/-``.
+      page_token:
+          DEPRECATED: This field is unused and ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListClustersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersRequest)
+
+ListClustersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListClustersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Response message for BigtableInstanceAdmin.ListClusters.
+  
+  
+  Attributes:
+      clusters:
+          The list of requested clusters.
+      failed_locations:
+          Locations from which Cluster information could not be
+          retrieved, due to an outage or some other transient condition.
+          Clusters from these locations may be missing from
+          ``clusters``, or may only have partial information returned.
+          Values are of the form
+          ``projects/<project>/locations/<zone_id>``
+      next_page_token:
+          DEPRECATED: This field is unused and ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListClustersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersResponse)
+
+DeleteClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETECLUSTERREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.DeleteCluster.
+  
+  
+  Attributes:
+      name:
+          The unique name of the cluster to be deleted. Values are of
+          the form ``projects/<project>/instances/<instance>/clusters/<c
+          luster>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteClusterRequest)
+
+CreateInstanceMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateInstanceMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTANCEMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""The metadata for the Operation returned by CreateInstance.
+  
+  
+  Attributes:
+      original_request:
+          The request that prompted the initiation of this
+          CreateInstance operation.
+      request_time:
+          The time at which the original request was received.
+      finish_time:
+          The time at which the operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateInstanceMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstanceMetadata)
+
+UpdateInstanceMetadata = _reflection.GeneratedProtocolMessageType(
+    "UpdateInstanceMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINSTANCEMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""The metadata for the Operation returned by UpdateInstance.
+  
+  
+  Attributes:
+      original_request:
+          The request that prompted the initiation of this
+          UpdateInstance operation.
+      request_time:
+          The time at which the original request was received.
+      finish_time:
+          The time at which the operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.UpdateInstanceMetadata)
+    ),
+)
+_sym_db.RegisterMessage(UpdateInstanceMetadata)
+
+CreateClusterMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateClusterMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLUSTERMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""The metadata for the Operation returned by CreateCluster.
+  
+  
+  Attributes:
+      original_request:
+          The request that prompted the initiation of this CreateCluster
+          operation.
+      request_time:
+          The time at which the original request was received.
+      finish_time:
+          The time at which the operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateClusterMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateClusterMetadata)
+
+UpdateClusterMetadata = _reflection.GeneratedProtocolMessageType(
+    "UpdateClusterMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECLUSTERMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""The metadata for the Operation returned by UpdateCluster.
+  
+  
+  Attributes:
+      original_request:
+          The request that prompted the initiation of this UpdateCluster
+          operation.
+      request_time:
+          The time at which the original request was received.
+      finish_time:
+          The time at which the operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.UpdateClusterMetadata)
+    ),
+)
+_sym_db.RegisterMessage(UpdateClusterMetadata)
+
+CreateAppProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateAppProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEAPPPROFILEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.CreateAppProfile.
+  
+  
+  Attributes:
+      parent:
+          The unique name of the instance in which to create the new app
+          profile. Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      app_profile_id:
+          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``.
+      app_profile:
+          The app profile to be created. Fields marked ``OutputOnly``
+          will be ignored.
+      ignore_warnings:
+          If true, ignore safety checks when creating the app profile.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateAppProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateAppProfileRequest)
+
+GetAppProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "GetAppProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETAPPPROFILEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.GetAppProfile.
+  
+  
+  Attributes:
+      name:
+          The unique name of the requested app profile. Values are of
+          the form ``projects/<project>/instances/<instance>/appProfiles
+          /<app_profile>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetAppProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetAppProfileRequest)
+
+ListAppProfilesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAppProfilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTAPPPROFILESREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.ListAppProfiles.
+  
+  
+  Attributes:
+      parent:
+          The unique name of the instance for which a list of app
+          profiles is requested. Values are of the form
+          ``projects/<project>/instances/<instance>``. Use ``<instance>
+          = '-'`` to list AppProfiles for all Instances in a project,
+          e.g., ``projects/myproject/instances/-``.
+      page_size:
+          Maximum number of results per page. CURRENTLY UNIMPLEMENTED
+          AND IGNORED.
+      page_token:
+          The value of ``next_page_token`` returned by a previous call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListAppProfilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAppProfilesRequest)
+
+ListAppProfilesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAppProfilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTAPPPROFILESRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Response message for BigtableInstanceAdmin.ListAppProfiles.
+  
+  
+  Attributes:
+      app_profiles:
+          The list of requested app profiles.
+      next_page_token:
+          Set if not all app profiles could be returned in a single
+          response. Pass this value to ``page_token`` in another request
+          to get the next page of results.
+      failed_locations:
+          Locations from which AppProfile information could not be
+          retrieved, due to an outage or some other transient condition.
+          AppProfiles from these locations may be missing from
+          ``app_profiles``. Values are of the form
+          ``projects/<project>/locations/<zone_id>``
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListAppProfilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAppProfilesResponse)
+
+UpdateAppProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateAppProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEAPPPROFILEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.UpdateAppProfile.
+  
+  
+  Attributes:
+      app_profile:
+          The app profile which will (partially) replace the current
+          value.
+      update_mask:
+          The subset of app profile fields which should be replaced. If
+          unset, all fields will be replaced.
+      ignore_warnings:
+          If true, ignore safety checks when updating the app profile.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.UpdateAppProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateAppProfileRequest)
+
+DeleteAppProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteAppProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEAPPPROFILEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""Request message for BigtableInstanceAdmin.DeleteAppProfile.
+  
+  
+  Attributes:
+      name:
+          The unique name of the app profile to be deleted. Values are
+          of the form ``projects/<project>/instances/<instance>/appProfi
+          les/<app_profile>``.
+      ignore_warnings:
+          If true, ignore safety checks when deleting the app profile.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteAppProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteAppProfileRequest)
+
+UpdateAppProfileMetadata = _reflection.GeneratedProtocolMessageType(
+    "UpdateAppProfileMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEAPPPROFILEMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_instance_admin_pb2",
+        __doc__="""The metadata for the Operation returned by UpdateAppProfile.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.UpdateAppProfileMetadata)
+    ),
+)
+_sym_db.RegisterMessage(UpdateAppProfileMetadata)
+
+
+DESCRIPTOR._options = None
+_CREATEINSTANCEREQUEST_CLUSTERSENTRY._options = None
+
+_BIGTABLEINSTANCEADMIN = _descriptor.ServiceDescriptor(
+    name="BigtableInstanceAdmin",
+    full_name="google.bigtable.admin.v2.BigtableInstanceAdmin",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2889,
+    serialized_end=5875,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateInstance",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.CreateInstance",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002&"!/v2/{parent=projects/*}/instances:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInstance",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.GetInstance",
+            index=1,
+            containing_service=None,
+            input_type=_GETINSTANCEREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._INSTANCE,
+            serialized_options=_b(
+                "\202\323\344\223\002#\022!/v2/{name=projects/*/instances/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListInstances",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.ListInstances",
+            index=2,
+            containing_service=None,
+            input_type=_LISTINSTANCESREQUEST,
+            output_type=_LISTINSTANCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002#\022!/v2/{parent=projects/*}/instances"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateInstance",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.UpdateInstance",
+            index=3,
+            containing_service=None,
+            input_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._INSTANCE,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._INSTANCE,
+            serialized_options=_b(
+                "\202\323\344\223\002&\032!/v2/{name=projects/*/instances/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PartialUpdateInstance",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.PartialUpdateInstance",
+            index=4,
+            containing_service=None,
+            input_type=_PARTIALUPDATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\00262*/v2/{instance.name=projects/*/instances/*}:\010instance"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteInstance",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.DeleteInstance",
+            index=5,
+            containing_service=None,
+            input_type=_DELETEINSTANCEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002#*!/v2/{name=projects/*/instances/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateCluster",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.CreateCluster",
+            index=6,
+            containing_service=None,
+            input_type=_CREATECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0027",/v2/{parent=projects/*/instances/*}/clusters:\007cluster'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCluster",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.GetCluster",
+            index=7,
+            containing_service=None,
+            input_type=_GETCLUSTERREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._CLUSTER,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v2/{name=projects/*/instances/*/clusters/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListClusters",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.ListClusters",
+            index=8,
+            containing_service=None,
+            input_type=_LISTCLUSTERSREQUEST,
+            output_type=_LISTCLUSTERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v2/{parent=projects/*/instances/*}/clusters"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCluster",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.UpdateCluster",
+            index=9,
+            containing_service=None,
+            input_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._CLUSTER,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\0021\032,/v2/{name=projects/*/instances/*/clusters/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteCluster",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.DeleteCluster",
+            index=10,
+            containing_service=None,
+            input_type=_DELETECLUSTERREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002.*,/v2/{name=projects/*/instances/*/clusters/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateAppProfile",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.CreateAppProfile",
+            index=11,
+            containing_service=None,
+            input_type=_CREATEAPPPROFILEREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._APPPROFILE,
+            serialized_options=_b(
+                '\202\323\344\223\002>"//v2/{parent=projects/*/instances/*}/appProfiles:\013app_profile'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetAppProfile",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.GetAppProfile",
+            index=12,
+            containing_service=None,
+            input_type=_GETAPPPROFILEREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2._APPPROFILE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v2/{name=projects/*/instances/*/appProfiles/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAppProfiles",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.ListAppProfiles",
+            index=13,
+            containing_service=None,
+            input_type=_LISTAPPPROFILESREQUEST,
+            output_type=_LISTAPPPROFILESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v2/{parent=projects/*/instances/*}/appProfiles"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateAppProfile",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.UpdateAppProfile",
+            index=14,
+            containing_service=None,
+            input_type=_UPDATEAPPPROFILEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002J2;/v2/{app_profile.name=projects/*/instances/*/appProfiles/*}:\013app_profile"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteAppProfile",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.DeleteAppProfile",
+            index=15,
+            containing_service=None,
+            input_type=_DELETEAPPPROFILEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v2/{name=projects/*/instances/*/appProfiles/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.GetIamPolicy",
+            index=16,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v2/{resource=projects/*/instances/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.SetIamPolicy",
+            index=17,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v2/{resource=projects/*/instances/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.bigtable.admin.v2.BigtableInstanceAdmin.TestIamPermissions",
+            index=18,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v2/{resource=projects/*/instances/*}:testIamPermissions:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_BIGTABLEINSTANCEADMIN)
+
+DESCRIPTOR.services_by_name["BigtableInstanceAdmin"] = _BIGTABLEINSTANCEADMIN
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin_pb2_grpc.py b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin_pb2_grpc.py
new file mode 100644
index 000000000000..0ca0445e22db
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_instance_admin_pb2_grpc.py
@@ -0,0 +1,370 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigtable_admin_v2.proto import (
+    bigtable_instance_admin_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2,
+)
+from google.cloud.bigtable_admin_v2.proto import (
+    instance_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class BigtableInstanceAdminStub(object):
+    """Service for creating, configuring, and deleting Cloud Bigtable Instances and
+  Clusters. Provides access to the Instance and Cluster schemas only, not the
+  tables' metadata or data stored in those tables.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateInstance = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/CreateInstance",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.CreateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetInstance = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/GetInstance",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.GetInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Instance.FromString,
+        )
+        self.ListInstances = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/ListInstances",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListInstancesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListInstancesResponse.FromString,
+        )
+        self.UpdateInstance = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/UpdateInstance",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Instance.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Instance.FromString,
+        )
+        self.PartialUpdateInstance = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/PartialUpdateInstance",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.PartialUpdateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteInstance = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/DeleteInstance",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.DeleteInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateCluster = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/CreateCluster",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.CreateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetCluster = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/GetCluster",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.GetClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Cluster.FromString,
+        )
+        self.ListClusters = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/ListClusters",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListClustersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListClustersResponse.FromString,
+        )
+        self.UpdateCluster = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/UpdateCluster",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Cluster.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteCluster = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/DeleteCluster",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.DeleteClusterRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateAppProfile = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/CreateAppProfile",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.CreateAppProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.AppProfile.FromString,
+        )
+        self.GetAppProfile = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/GetAppProfile",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.GetAppProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.AppProfile.FromString,
+        )
+        self.ListAppProfiles = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/ListAppProfiles",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListAppProfilesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListAppProfilesResponse.FromString,
+        )
+        self.UpdateAppProfile = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/UpdateAppProfile",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.UpdateAppProfileRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteAppProfile = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/DeleteAppProfile",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.DeleteAppProfileRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableInstanceAdmin/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+
+
+class BigtableInstanceAdminServicer(object):
+    """Service for creating, configuring, and deleting Cloud Bigtable Instances and
+  Clusters. Provides access to the Instance and Cluster schemas only, not the
+  tables' metadata or data stored in those tables.
+  """
+
+    def CreateInstance(self, request, context):
+        """Create an instance within a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInstance(self, request, context):
+        """Gets information about an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListInstances(self, request, context):
+        """Lists information about instances in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateInstance(self, request, context):
+        """Updates an instance within a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PartialUpdateInstance(self, request, context):
+        """Partially updates an instance within a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteInstance(self, request, context):
+        """Delete an instance from a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateCluster(self, request, context):
+        """Creates a cluster within an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCluster(self, request, context):
+        """Gets information about a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListClusters(self, request, context):
+        """Lists information about clusters in an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCluster(self, request, context):
+        """Updates a cluster within an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteCluster(self, request, context):
+        """Deletes a cluster from an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateAppProfile(self, request, context):
+        """Creates an app profile within an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetAppProfile(self, request, context):
+        """Gets information about an app profile.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAppProfiles(self, request, context):
+        """Lists information about app profiles in an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateAppProfile(self, request, context):
+        """Updates an app profile within an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteAppProfile(self, request, context):
+        """Deletes an app profile from an instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for an instance resource. Returns an empty
+    policy if an instance exists but does not have a policy set.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on an instance resource. Replaces any
+    existing policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns permissions that the caller has on the specified instance resource.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_BigtableInstanceAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateInstance,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.CreateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInstance,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.GetInstanceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Instance.SerializeToString,
+        ),
+        "ListInstances": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInstances,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListInstancesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListInstancesResponse.SerializeToString,
+        ),
+        "UpdateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateInstance,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Instance.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Instance.SerializeToString,
+        ),
+        "PartialUpdateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.PartialUpdateInstance,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.PartialUpdateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteInstance,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.DeleteInstanceRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCluster,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.CreateClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCluster,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.GetClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Cluster.SerializeToString,
+        ),
+        "ListClusters": grpc.unary_unary_rpc_method_handler(
+            servicer.ListClusters,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListClustersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListClustersResponse.SerializeToString,
+        ),
+        "UpdateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCluster,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.Cluster.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteCluster,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.DeleteClusterRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateAppProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateAppProfile,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.CreateAppProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.AppProfile.SerializeToString,
+        ),
+        "GetAppProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.GetAppProfile,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.GetAppProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_instance__pb2.AppProfile.SerializeToString,
+        ),
+        "ListAppProfiles": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAppProfiles,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListAppProfilesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.ListAppProfilesResponse.SerializeToString,
+        ),
+        "UpdateAppProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateAppProfile,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.UpdateAppProfileRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteAppProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteAppProfile,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__instance__admin__pb2.DeleteAppProfileRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.bigtable.admin.v2.BigtableInstanceAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin.proto
new file mode 100644
index 000000000000..79c461e05e63
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin.proto
@@ -0,0 +1,528 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/v2/table.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableAdminProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+// Service for creating, configuring, and deleting Cloud Bigtable tables.
+//
+//
+// Provides access to the table schemas only, not the data stored within
+// the tables.
+service BigtableTableAdmin {
+  // 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.
+  rpc CreateTable(CreateTableRequest) returns (Table) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/tables"
+      body: "*"
+    };
+  }
+
+  // Creates a new table from the specified snapshot. The target table must
+  // not exist. The snapshot and the table must be in the same instance.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc CreateTableFromSnapshot(CreateTableFromSnapshotRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/tables:createFromSnapshot"
+      body: "*"
+    };
+  }
+
+  // Lists all tables served from a specified instance.
+  rpc ListTables(ListTablesRequest) returns (ListTablesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*}/tables"
+    };
+  }
+
+  // Gets metadata information about the specified table.
+  rpc GetTable(GetTableRequest) returns (Table) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/tables/*}"
+    };
+  }
+
+  // Permanently deletes a specified table and all of its data.
+  rpc DeleteTable(DeleteTableRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/tables/*}"
+    };
+  }
+
+  // Performs a series of column family modifications on the specified table.
+  // Either all or none of the modifications will occur before this method
+  // returns, but data requests received prior to that point may see a table
+  // where only some modifications have taken effect.
+  rpc ModifyColumnFamilies(ModifyColumnFamiliesRequest) returns (Table) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies"
+      body: "*"
+    };
+  }
+
+  // Permanently drop/delete a row range from a specified table. The request can
+  // specify whether to delete all rows in a table, or only those that match a
+  // particular prefix.
+  rpc DropRowRange(DropRowRangeRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:dropRowRange"
+      body: "*"
+    };
+  }
+
+  // Generates a consistency token for a Table, which can be used in
+  // CheckConsistency to check whether mutations to the table that finished
+  // before this call started have been replicated. The tokens will be available
+  // for 90 days.
+  rpc GenerateConsistencyToken(GenerateConsistencyTokenRequest)
+      returns (GenerateConsistencyTokenResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:generateConsistencyToken"
+      body: "*"
+    };
+  }
+
+  // Checks replication consistency based on a consistency token, that is, if
+  // replication has caught up based on the conditions specified in the token
+  // and the check request.
+  rpc CheckConsistency(CheckConsistencyRequest)
+      returns (CheckConsistencyResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:checkConsistency"
+      body: "*"
+    };
+  }
+
+  // Creates a new snapshot in the specified cluster from the specified
+  // source table. The cluster and the table must be in the same instance.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc SnapshotTable(SnapshotTableRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:snapshot"
+      body: "*"
+    };
+  }
+
+  // Gets metadata information about the specified snapshot.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc GetSnapshot(GetSnapshotRequest) returns (Snapshot) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}"
+    };
+  }
+
+  // Lists all snapshots associated with the specified cluster.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc ListSnapshots(ListSnapshotsRequest) returns (ListSnapshotsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*/clusters/*}/snapshots"
+    };
+  }
+
+  // Permanently deletes the specified snapshot.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc DeleteSnapshot(DeleteSnapshotRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}"
+    };
+  }
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.CreateTable][google.bigtable.admin.v2.BigtableTableAdmin.CreateTable]
+message CreateTableRequest {
+  // An initial split point for a newly created table.
+  message Split {
+    // Row key to use as an initial tablet boundary.
+    bytes key = 1;
+  }
+
+  // The unique name of the instance in which to create the table.
+  // Values are of the form `projects/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // The Table to create.
+  Table table = 3;
+
+  // The optional list of row keys that will be used to initially split the
+  // table into several tablets (tablets are similar to HBase regions).
+  // Given two split keys, `s1` and `s2`, three tablets will be created,
+  // spanning the key ranges: `[, s1), [s1, s2), [s2, )`.
+  //
+  // Example:
+  //
+  // * Row keys := `["a", "apple", "custom", "customer_1", "customer_2",`
+  //                `"other", "zz"]`
+  // * initial_split_keys := `["apple", "customer_1", "customer_2", "other"]`
+  // * Key assignment:
+  //     - Tablet 1 `[, apple)                => {"a"}.`
+  //     - Tablet 2 `[apple, customer_1)      => {"apple", "custom"}.`
+  //     - Tablet 3 `[customer_1, customer_2) => {"customer_1"}.`
+  //     - Tablet 4 `[customer_2, other)      => {"customer_2"}.`
+  //     - Tablet 5 `[other, )                => {"other", "zz"}.`
+  repeated Split initial_splits = 4;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // Delete all rows or by prefix.
+  oneof target {
+    // Delete all rows that start with this row key prefix. Prefix cannot be
+    // zero length.
+    bytes row_key_prefix = 2;
+
+    // Delete all rows in the table. Setting this to false is a no-op.
+    bool delete_all_data_from_table = 3;
+  }
+}
+
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // The view to be applied to the returned tables' fields.
+  // Defaults to `NAME_ONLY` if unspecified; no others are currently supported.
+  Table.View view = 2;
+
+  // Maximum number of results per page.
+  // CURRENTLY UNIMPLEMENTED AND IGNORED.
+  int32 page_size = 4;
+
+  // The value of `next_page_token` returned by a previous call.
+  string page_token = 3;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ListTables][google.bigtable.admin.v2.BigtableTableAdmin.ListTables]
+message ListTablesResponse {
+  // The tables present in the requested instance.
+  repeated Table tables = 1;
+
+  // Set if not all tables could be returned in a single response.
+  // Pass this value to `page_token` in another request to get the next
+  // page of results.
+  string next_page_token = 2;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.GetTable][google.bigtable.admin.v2.BigtableTableAdmin.GetTable]
+message GetTableRequest {
+  // The unique name of the requested table.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // The view to be applied to the returned table's fields.
+  // Defaults to `SCHEMA_VIEW` if unspecified.
+  Table.View view = 2;
+}
+
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies][google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies]
+message ModifyColumnFamiliesRequest {
+  // A create, update, or delete of a particular column family.
+  message Modification {
+    // The ID of the column family to be modified.
+    string id = 1;
+
+    // Column familiy modifications.
+    oneof mod {
+      // Create a new column family with the specified schema, or fail if
+      // one already exists with the given ID.
+      ColumnFamily create = 2;
+
+      // Update an existing column family to the specified schema, or fail
+      // if no column family exists with the given ID.
+      ColumnFamily update = 3;
+
+      // Drop (delete) the column family with the given ID, or fail if no such
+      // family exists.
+      bool drop = 4;
+    }
+  }
+
+  // The unique name of the table whose families should be modified.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  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;
+}
+
+// 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/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken][google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken]
+message GenerateConsistencyTokenResponse {
+  // The generated consistency token.
+  string consistency_token = 1;
+}
+
+// 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/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // The token created using GenerateConsistencyToken for the Table.
+  string consistency_token = 2;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency][google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency]
+message CheckConsistencyResponse {
+  // True only if the token is consistent. A token is consistent if replication
+  // has caught up with the restrictions specified in the request.
+  bool consistent = 1;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable][google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // The name of the cluster where the snapshot will be created in.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>`.
+  string cluster = 2;
+
+  // 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;
+
+  // 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
+  // amount of time a snapshot can stay active is 7 days. If 'ttl' is not
+  // specified, the default value of 24 hours will be used.
+  google.protobuf.Duration ttl = 4;
+
+  // Description of the snapshot.
+  string description = 5;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+  string name = 1;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots][google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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/<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;
+
+  // The maximum number of snapshots to return per page.
+  // CURRENTLY UNIMPLEMENTED AND IGNORED.
+  int32 page_size = 2;
+
+  // The value of `next_page_token` returned by a previous call.
+  string page_token = 3;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots][google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 ListSnapshotsResponse {
+  // The snapshots present in the requested cluster.
+  repeated Snapshot snapshots = 1;
+
+  // Set if not all snapshots could be returned in a single response.
+  // Pass this value to `page_token` in another request to get the next
+  // page of results.
+  string next_page_token = 2;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+  string name = 1;
+}
+
+// The metadata for the Operation returned by SnapshotTable.
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 SnapshotTableMetadata {
+  // The request that prompted the initiation of this SnapshotTable operation.
+  SnapshotTableRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by CreateTableFromSnapshot.
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 CreateTableFromSnapshotMetadata {
+  // The request that prompted the initiation of this CreateTableFromSnapshot
+  // operation.
+  CreateTableFromSnapshotRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin_pb2.py b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin_pb2.py
new file mode 100644
index 000000000000..4bb9d8f1d328
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin_pb2.py
@@ -0,0 +1,2253 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable/admin_v2/proto/bigtable_table_admin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigtable_admin_v2.proto import (
+    table_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable/admin_v2/proto/bigtable_table_admin.proto",
+    package="google.bigtable.admin.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.bigtable.admin.v2B\027BigtableTableAdminProtoP\001Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\252\002\036Google.Cloud.Bigtable.Admin.V2\312\002\036Google\\Cloud\\Bigtable\\Admin\\V2"
+    ),
+    serialized_pb=_b(
+        '\n?google/cloud/bigtable/admin_v2/proto/bigtable_table_admin.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x30google/cloud/bigtable/admin_v2/proto/table.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xc8\x01\n\x12\x43reateTableRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x10\n\x08table_id\x18\x02 \x01(\t\x12.\n\x05table\x18\x03 \x01(\x0b\x32\x1f.google.bigtable.admin.v2.Table\x12J\n\x0einitial_splits\x18\x04 \x03(\x0b\x32\x32.google.bigtable.admin.v2.CreateTableRequest.Split\x1a\x14\n\x05Split\x12\x0b\n\x03key\x18\x01 \x01(\x0c"[\n\x1e\x43reateTableFromSnapshotRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x10\n\x08table_id\x18\x02 \x01(\t\x12\x17\n\x0fsource_snapshot\x18\x03 \x01(\t"m\n\x13\x44ropRowRangeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x18\n\x0erow_key_prefix\x18\x02 \x01(\x0cH\x00\x12$\n\x1a\x64\x65lete_all_data_from_table\x18\x03 \x01(\x08H\x00\x42\x08\n\x06target"~\n\x11ListTablesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x32\n\x04view\x18\x02 \x01(\x0e\x32$.google.bigtable.admin.v2.Table.View\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"^\n\x12ListTablesResponse\x12/\n\x06tables\x18\x01 \x03(\x0b\x32\x1f.google.bigtable.admin.v2.Table\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"S\n\x0fGetTableRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x32\n\x04view\x18\x02 \x01(\x0e\x32$.google.bigtable.admin.v2.Table.View""\n\x12\x44\x65leteTableRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xae\x02\n\x1bModifyColumnFamiliesRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Y\n\rmodifications\x18\x02 \x03(\x0b\x32\x42.google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification\x1a\xa5\x01\n\x0cModification\x12\n\n\x02id\x18\x01 \x01(\t\x12\x38\n\x06\x63reate\x18\x02 \x01(\x0b\x32&.google.bigtable.admin.v2.ColumnFamilyH\x00\x12\x38\n\x06update\x18\x03 \x01(\x0b\x32&.google.bigtable.admin.v2.ColumnFamilyH\x00\x12\x0e\n\x04\x64rop\x18\x04 \x01(\x08H\x00\x42\x05\n\x03mod"/\n\x1fGenerateConsistencyTokenRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"=\n GenerateConsistencyTokenResponse\x12\x19\n\x11\x63onsistency_token\x18\x01 \x01(\t"B\n\x17\x43heckConsistencyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x11\x63onsistency_token\x18\x02 \x01(\t".\n\x18\x43heckConsistencyResponse\x12\x12\n\nconsistent\x18\x01 \x01(\x08"\x87\x01\n\x14SnapshotTableRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07\x63luster\x18\x02 \x01(\t\x12\x13\n\x0bsnapshot_id\x18\x03 \x01(\t\x12&\n\x03ttl\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t""\n\x12GetSnapshotRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"M\n\x14ListSnapshotsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"g\n\x15ListSnapshotsResponse\x12\x35\n\tsnapshots\x18\x01 \x03(\x0b\x32".google.bigtable.admin.v2.Snapshot\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"%\n\x15\x44\x65leteSnapshotRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xc4\x01\n\x15SnapshotTableMetadata\x12H\n\x10original_request\x18\x01 \x01(\x0b\x32..google.bigtable.admin.v2.SnapshotTableRequest\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xd8\x01\n\x1f\x43reateTableFromSnapshotMetadata\x12R\n\x10original_request\x18\x01 \x01(\x0b\x32\x38.google.bigtable.admin.v2.CreateTableFromSnapshotRequest\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xb7\x11\n\x12\x42igtableTableAdmin\x12\x93\x01\n\x0b\x43reateTable\x12,.google.bigtable.admin.v2.CreateTableRequest\x1a\x1f.google.bigtable.admin.v2.Table"5\x82\xd3\xe4\x93\x02/"*/v2/{parent=projects/*/instances/*}/tables:\x01*\x12\xbc\x01\n\x17\x43reateTableFromSnapshot\x12\x38.google.bigtable.admin.v2.CreateTableFromSnapshotRequest\x1a\x1d.google.longrunning.Operation"H\x82\xd3\xe4\x93\x02\x42"=/v2/{parent=projects/*/instances/*}/tables:createFromSnapshot:\x01*\x12\x9b\x01\n\nListTables\x12+.google.bigtable.admin.v2.ListTablesRequest\x1a,.google.bigtable.admin.v2.ListTablesResponse"2\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/instances/*}/tables\x12\x8a\x01\n\x08GetTable\x12).google.bigtable.admin.v2.GetTableRequest\x1a\x1f.google.bigtable.admin.v2.Table"2\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/instances/*/tables/*}\x12\x87\x01\n\x0b\x44\x65leteTable\x12,.google.bigtable.admin.v2.DeleteTableRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/instances/*/tables/*}\x12\xba\x01\n\x14ModifyColumnFamilies\x12\x35.google.bigtable.admin.v2.ModifyColumnFamiliesRequest\x1a\x1f.google.bigtable.admin.v2.Table"J\x82\xd3\xe4\x93\x02\x44"?/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies:\x01*\x12\x99\x01\n\x0c\x44ropRowRange\x12-.google.bigtable.admin.v2.DropRowRangeRequest\x1a\x16.google.protobuf.Empty"B\x82\xd3\xe4\x93\x02<"7/v2/{name=projects/*/instances/*/tables/*}:dropRowRange:\x01*\x12\xe1\x01\n\x18GenerateConsistencyToken\x12\x39.google.bigtable.admin.v2.GenerateConsistencyTokenRequest\x1a:.google.bigtable.admin.v2.GenerateConsistencyTokenResponse"N\x82\xd3\xe4\x93\x02H"C/v2/{name=projects/*/instances/*/tables/*}:generateConsistencyToken:\x01*\x12\xc1\x01\n\x10\x43heckConsistency\x12\x31.google.bigtable.admin.v2.CheckConsistencyRequest\x1a\x32.google.bigtable.admin.v2.CheckConsistencyResponse"F\x82\xd3\xe4\x93\x02@";/v2/{name=projects/*/instances/*/tables/*}:checkConsistency:\x01*\x12\x9e\x01\n\rSnapshotTable\x12..google.bigtable.admin.v2.SnapshotTableRequest\x1a\x1d.google.longrunning.Operation">\x82\xd3\xe4\x93\x02\x38"3/v2/{name=projects/*/instances/*/tables/*}:snapshot:\x01*\x12\xa1\x01\n\x0bGetSnapshot\x12,.google.bigtable.admin.v2.GetSnapshotRequest\x1a".google.bigtable.admin.v2.Snapshot"@\x82\xd3\xe4\x93\x02:\x12\x38/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}\x12\xb2\x01\n\rListSnapshots\x12..google.bigtable.admin.v2.ListSnapshotsRequest\x1a/.google.bigtable.admin.v2.ListSnapshotsResponse"@\x82\xd3\xe4\x93\x02:\x12\x38/v2/{parent=projects/*/instances/*/clusters/*}/snapshots\x12\x9b\x01\n\x0e\x44\x65leteSnapshot\x12/.google.bigtable.admin.v2.DeleteSnapshotRequest\x1a\x16.google.protobuf.Empty"@\x82\xd3\xe4\x93\x02:*8/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}B\xba\x01\n\x1c\x63om.google.bigtable.admin.v2B\x17\x42igtableTableAdminProtoP\x01Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\xaa\x02\x1eGoogle.Cloud.Bigtable.Admin.V2\xca\x02\x1eGoogle\\Cloud\\Bigtable\\Admin\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATETABLEREQUEST_SPLIT = _descriptor.Descriptor(
+    name="Split",
+    full_name="google.bigtable.admin.v2.CreateTableRequest.Split",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.bigtable.admin.v2.CreateTableRequest.Split.key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=485,
+    serialized_end=505,
+)
+
+_CREATETABLEREQUEST = _descriptor.Descriptor(
+    name="CreateTableRequest",
+    full_name="google.bigtable.admin.v2.CreateTableRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.CreateTableRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_id",
+            full_name="google.bigtable.admin.v2.CreateTableRequest.table_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.bigtable.admin.v2.CreateTableRequest.table",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_splits",
+            full_name="google.bigtable.admin.v2.CreateTableRequest.initial_splits",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CREATETABLEREQUEST_SPLIT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=305,
+    serialized_end=505,
+)
+
+
+_CREATETABLEFROMSNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="CreateTableFromSnapshotRequest",
+    full_name="google.bigtable.admin.v2.CreateTableFromSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.CreateTableFromSnapshotRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_id",
+            full_name="google.bigtable.admin.v2.CreateTableFromSnapshotRequest.table_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_snapshot",
+            full_name="google.bigtable.admin.v2.CreateTableFromSnapshotRequest.source_snapshot",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=507,
+    serialized_end=598,
+)
+
+
+_DROPROWRANGEREQUEST = _descriptor.Descriptor(
+    name="DropRowRangeRequest",
+    full_name="google.bigtable.admin.v2.DropRowRangeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.DropRowRangeRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_key_prefix",
+            full_name="google.bigtable.admin.v2.DropRowRangeRequest.row_key_prefix",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_all_data_from_table",
+            full_name="google.bigtable.admin.v2.DropRowRangeRequest.delete_all_data_from_table",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target",
+            full_name="google.bigtable.admin.v2.DropRowRangeRequest.target",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=600,
+    serialized_end=709,
+)
+
+
+_LISTTABLESREQUEST = _descriptor.Descriptor(
+    name="ListTablesRequest",
+    full_name="google.bigtable.admin.v2.ListTablesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.ListTablesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.bigtable.admin.v2.ListTablesRequest.view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.bigtable.admin.v2.ListTablesRequest.page_size",
+            index=2,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.bigtable.admin.v2.ListTablesRequest.page_token",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=711,
+    serialized_end=837,
+)
+
+
+_LISTTABLESRESPONSE = _descriptor.Descriptor(
+    name="ListTablesResponse",
+    full_name="google.bigtable.admin.v2.ListTablesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tables",
+            full_name="google.bigtable.admin.v2.ListTablesResponse.tables",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.bigtable.admin.v2.ListTablesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=839,
+    serialized_end=933,
+)
+
+
+_GETTABLEREQUEST = _descriptor.Descriptor(
+    name="GetTableRequest",
+    full_name="google.bigtable.admin.v2.GetTableRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.GetTableRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.bigtable.admin.v2.GetTableRequest.view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=935,
+    serialized_end=1018,
+)
+
+
+_DELETETABLEREQUEST = _descriptor.Descriptor(
+    name="DeleteTableRequest",
+    full_name="google.bigtable.admin.v2.DeleteTableRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.DeleteTableRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1020,
+    serialized_end=1054,
+)
+
+
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION = _descriptor.Descriptor(
+    name="Modification",
+    full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.create",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.update",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="drop",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.drop",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="mod",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.mod",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1194,
+    serialized_end=1359,
+)
+
+_MODIFYCOLUMNFAMILIESREQUEST = _descriptor.Descriptor(
+    name="ModifyColumnFamiliesRequest",
+    full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="modifications",
+            full_name="google.bigtable.admin.v2.ModifyColumnFamiliesRequest.modifications",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1057,
+    serialized_end=1359,
+)
+
+
+_GENERATECONSISTENCYTOKENREQUEST = _descriptor.Descriptor(
+    name="GenerateConsistencyTokenRequest",
+    full_name="google.bigtable.admin.v2.GenerateConsistencyTokenRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.GenerateConsistencyTokenRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1361,
+    serialized_end=1408,
+)
+
+
+_GENERATECONSISTENCYTOKENRESPONSE = _descriptor.Descriptor(
+    name="GenerateConsistencyTokenResponse",
+    full_name="google.bigtable.admin.v2.GenerateConsistencyTokenResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="consistency_token",
+            full_name="google.bigtable.admin.v2.GenerateConsistencyTokenResponse.consistency_token",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1410,
+    serialized_end=1471,
+)
+
+
+_CHECKCONSISTENCYREQUEST = _descriptor.Descriptor(
+    name="CheckConsistencyRequest",
+    full_name="google.bigtable.admin.v2.CheckConsistencyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.CheckConsistencyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="consistency_token",
+            full_name="google.bigtable.admin.v2.CheckConsistencyRequest.consistency_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1473,
+    serialized_end=1539,
+)
+
+
+_CHECKCONSISTENCYRESPONSE = _descriptor.Descriptor(
+    name="CheckConsistencyResponse",
+    full_name="google.bigtable.admin.v2.CheckConsistencyResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="consistent",
+            full_name="google.bigtable.admin.v2.CheckConsistencyResponse.consistent",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1541,
+    serialized_end=1587,
+)
+
+
+_SNAPSHOTTABLEREQUEST = _descriptor.Descriptor(
+    name="SnapshotTableRequest",
+    full_name="google.bigtable.admin.v2.SnapshotTableRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.SnapshotTableRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.bigtable.admin.v2.SnapshotTableRequest.cluster",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="snapshot_id",
+            full_name="google.bigtable.admin.v2.SnapshotTableRequest.snapshot_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ttl",
+            full_name="google.bigtable.admin.v2.SnapshotTableRequest.ttl",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.bigtable.admin.v2.SnapshotTableRequest.description",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1590,
+    serialized_end=1725,
+)
+
+
+_GETSNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="GetSnapshotRequest",
+    full_name="google.bigtable.admin.v2.GetSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.GetSnapshotRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1727,
+    serialized_end=1761,
+)
+
+
+_LISTSNAPSHOTSREQUEST = _descriptor.Descriptor(
+    name="ListSnapshotsRequest",
+    full_name="google.bigtable.admin.v2.ListSnapshotsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.bigtable.admin.v2.ListSnapshotsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.bigtable.admin.v2.ListSnapshotsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.bigtable.admin.v2.ListSnapshotsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1763,
+    serialized_end=1840,
+)
+
+
+_LISTSNAPSHOTSRESPONSE = _descriptor.Descriptor(
+    name="ListSnapshotsResponse",
+    full_name="google.bigtable.admin.v2.ListSnapshotsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshots",
+            full_name="google.bigtable.admin.v2.ListSnapshotsResponse.snapshots",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.bigtable.admin.v2.ListSnapshotsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1842,
+    serialized_end=1945,
+)
+
+
+_DELETESNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="DeleteSnapshotRequest",
+    full_name="google.bigtable.admin.v2.DeleteSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.DeleteSnapshotRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1947,
+    serialized_end=1984,
+)
+
+
+_SNAPSHOTTABLEMETADATA = _descriptor.Descriptor(
+    name="SnapshotTableMetadata",
+    full_name="google.bigtable.admin.v2.SnapshotTableMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_request",
+            full_name="google.bigtable.admin.v2.SnapshotTableMetadata.original_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_time",
+            full_name="google.bigtable.admin.v2.SnapshotTableMetadata.request_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finish_time",
+            full_name="google.bigtable.admin.v2.SnapshotTableMetadata.finish_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1987,
+    serialized_end=2183,
+)
+
+
+_CREATETABLEFROMSNAPSHOTMETADATA = _descriptor.Descriptor(
+    name="CreateTableFromSnapshotMetadata",
+    full_name="google.bigtable.admin.v2.CreateTableFromSnapshotMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="original_request",
+            full_name="google.bigtable.admin.v2.CreateTableFromSnapshotMetadata.original_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_time",
+            full_name="google.bigtable.admin.v2.CreateTableFromSnapshotMetadata.request_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finish_time",
+            full_name="google.bigtable.admin.v2.CreateTableFromSnapshotMetadata.finish_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2186,
+    serialized_end=2402,
+)
+
+_CREATETABLEREQUEST_SPLIT.containing_type = _CREATETABLEREQUEST
+_CREATETABLEREQUEST.fields_by_name[
+    "table"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE
+)
+_CREATETABLEREQUEST.fields_by_name[
+    "initial_splits"
+].message_type = _CREATETABLEREQUEST_SPLIT
+_DROPROWRANGEREQUEST.oneofs_by_name["target"].fields.append(
+    _DROPROWRANGEREQUEST.fields_by_name["row_key_prefix"]
+)
+_DROPROWRANGEREQUEST.fields_by_name[
+    "row_key_prefix"
+].containing_oneof = _DROPROWRANGEREQUEST.oneofs_by_name["target"]
+_DROPROWRANGEREQUEST.oneofs_by_name["target"].fields.append(
+    _DROPROWRANGEREQUEST.fields_by_name["delete_all_data_from_table"]
+)
+_DROPROWRANGEREQUEST.fields_by_name[
+    "delete_all_data_from_table"
+].containing_oneof = _DROPROWRANGEREQUEST.oneofs_by_name["target"]
+_LISTTABLESREQUEST.fields_by_name[
+    "view"
+].enum_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE_VIEW
+)
+_LISTTABLESRESPONSE.fields_by_name[
+    "tables"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE
+)
+_GETTABLEREQUEST.fields_by_name[
+    "view"
+].enum_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE_VIEW
+)
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name[
+    "create"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._COLUMNFAMILY
+)
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name[
+    "update"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._COLUMNFAMILY
+)
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.containing_type = _MODIFYCOLUMNFAMILIESREQUEST
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name["mod"].fields.append(
+    _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name["create"]
+)
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name[
+    "create"
+].containing_oneof = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name["mod"]
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name["mod"].fields.append(
+    _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name["update"]
+)
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name[
+    "update"
+].containing_oneof = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name["mod"]
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name["mod"].fields.append(
+    _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name["drop"]
+)
+_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name[
+    "drop"
+].containing_oneof = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name["mod"]
+_MODIFYCOLUMNFAMILIESREQUEST.fields_by_name[
+    "modifications"
+].message_type = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION
+_SNAPSHOTTABLEREQUEST.fields_by_name[
+    "ttl"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LISTSNAPSHOTSRESPONSE.fields_by_name[
+    "snapshots"
+].message_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._SNAPSHOT
+)
+_SNAPSHOTTABLEMETADATA.fields_by_name[
+    "original_request"
+].message_type = _SNAPSHOTTABLEREQUEST
+_SNAPSHOTTABLEMETADATA.fields_by_name[
+    "request_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SNAPSHOTTABLEMETADATA.fields_by_name[
+    "finish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATETABLEFROMSNAPSHOTMETADATA.fields_by_name[
+    "original_request"
+].message_type = _CREATETABLEFROMSNAPSHOTREQUEST
+_CREATETABLEFROMSNAPSHOTMETADATA.fields_by_name[
+    "request_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATETABLEFROMSNAPSHOTMETADATA.fields_by_name[
+    "finish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["CreateTableRequest"] = _CREATETABLEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateTableFromSnapshotRequest"
+] = _CREATETABLEFROMSNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["DropRowRangeRequest"] = _DROPROWRANGEREQUEST
+DESCRIPTOR.message_types_by_name["ListTablesRequest"] = _LISTTABLESREQUEST
+DESCRIPTOR.message_types_by_name["ListTablesResponse"] = _LISTTABLESRESPONSE
+DESCRIPTOR.message_types_by_name["GetTableRequest"] = _GETTABLEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTableRequest"] = _DELETETABLEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ModifyColumnFamiliesRequest"
+] = _MODIFYCOLUMNFAMILIESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GenerateConsistencyTokenRequest"
+] = _GENERATECONSISTENCYTOKENREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GenerateConsistencyTokenResponse"
+] = _GENERATECONSISTENCYTOKENRESPONSE
+DESCRIPTOR.message_types_by_name["CheckConsistencyRequest"] = _CHECKCONSISTENCYREQUEST
+DESCRIPTOR.message_types_by_name["CheckConsistencyResponse"] = _CHECKCONSISTENCYRESPONSE
+DESCRIPTOR.message_types_by_name["SnapshotTableRequest"] = _SNAPSHOTTABLEREQUEST
+DESCRIPTOR.message_types_by_name["GetSnapshotRequest"] = _GETSNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["ListSnapshotsRequest"] = _LISTSNAPSHOTSREQUEST
+DESCRIPTOR.message_types_by_name["ListSnapshotsResponse"] = _LISTSNAPSHOTSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteSnapshotRequest"] = _DELETESNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["SnapshotTableMetadata"] = _SNAPSHOTTABLEMETADATA
+DESCRIPTOR.message_types_by_name[
+    "CreateTableFromSnapshotMetadata"
+] = _CREATETABLEFROMSNAPSHOTMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateTableRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTableRequest",
+    (_message.Message,),
+    dict(
+        Split=_reflection.GeneratedProtocolMessageType(
+            "Split",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CREATETABLEREQUEST_SPLIT,
+                __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+                __doc__="""An initial split point for a newly created table.
+    
+    
+    Attributes:
+        key:
+            Row key to use as an initial tablet boundary.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateTableRequest.Split)
+            ),
+        ),
+        DESCRIPTOR=_CREATETABLEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.CreateTable][google.bigtable.admin.v2.BigtableTableAdmin.CreateTable]
+  
+  
+  Attributes:
+      parent:
+          The unique name of the instance in which to create the table.
+          Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      table_id:
+          The name by which the new table should be referred to within
+          the parent instance, e.g., ``foobar`` rather than
+          ``<parent>/tables/foobar``.
+      table:
+          The Table to create.
+      initial_splits:
+          The optional list of row keys that will be used to initially
+          split the table into several tablets (tablets are similar to
+          HBase regions). Given two split keys, ``s1`` and ``s2``, three
+          tablets will be created, spanning the key ranges: ``[, s1),
+          [s1, s2), [s2, )``.  Example:  -  Row keys := ``["a", "apple",
+          "custom", "customer_1", "customer_2",``    ``"other", "zz"]``
+          -  initial\_split\_keys :=    ``["apple", "customer_1",
+          "customer_2", "other"]`` -  Key assignment:     -  Tablet 1
+          ``[, apple)                => {"a"}.``    -  Tablet 2
+          ``[apple, customer_1)      => {"apple", "custom"}.``    -
+          Tablet 3 ``[customer_1, customer_2) => {"customer_1"}.``    -
+          Tablet 4 ``[customer_2, other)      => {"customer_2"}.``    -
+          Tablet 5 ``[other, )                => {"other", "zz"}.``
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateTableRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTableRequest)
+_sym_db.RegisterMessage(CreateTableRequest.Split)
+
+CreateTableFromSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTableFromSnapshotRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETABLEFROMSNAPSHOTREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot]
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      parent:
+          The unique name of the instance in which to create the table.
+          Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      table_id:
+          The name by which the new table should be referred to within
+          the parent instance, e.g., ``foobar`` rather than
+          ``<parent>/tables/foobar``.
+      source_snapshot:
+          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>/instance
+          s/<instance>/clusters/<cluster>/snapshots/<snapshot>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateTableFromSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTableFromSnapshotRequest)
+
+DropRowRangeRequest = _reflection.GeneratedProtocolMessageType(
+    "DropRowRangeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DROPROWRANGEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.DropRowRange][google.bigtable.admin.v2.BigtableTableAdmin.DropRowRange]
+  
+  
+  Attributes:
+      name:
+          The unique name of the table on which to drop a range of rows.
+          Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      target:
+          Delete all rows or by prefix.
+      row_key_prefix:
+          Delete all rows that start with this row key prefix. Prefix
+          cannot be zero length.
+      delete_all_data_from_table:
+          Delete all rows in the table. Setting this to false is a no-
+          op.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DropRowRangeRequest)
+    ),
+)
+_sym_db.RegisterMessage(DropRowRangeRequest)
+
+ListTablesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTablesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTABLESREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.ListTables][google.bigtable.admin.v2.BigtableTableAdmin.ListTables]
+  
+  
+  Attributes:
+      parent:
+          The unique name of the instance for which tables should be
+          listed. Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      view:
+          The view to be applied to the returned tables' fields.
+          Defaults to ``NAME_ONLY`` if unspecified; no others are
+          currently supported.
+      page_size:
+          Maximum number of results per page. CURRENTLY UNIMPLEMENTED
+          AND IGNORED.
+      page_token:
+          The value of ``next_page_token`` returned by a previous call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListTablesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTablesRequest)
+
+ListTablesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTablesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTABLESRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Response message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.ListTables][google.bigtable.admin.v2.BigtableTableAdmin.ListTables]
+  
+  
+  Attributes:
+      tables:
+          The tables present in the requested instance.
+      next_page_token:
+          Set if not all tables could be returned in a single response.
+          Pass this value to ``page_token`` in another request to get
+          the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListTablesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTablesResponse)
+
+GetTableRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTableRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTABLEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.GetTable][google.bigtable.admin.v2.BigtableTableAdmin.GetTable]
+  
+  
+  Attributes:
+      name:
+          The unique name of the requested table. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      view:
+          The view to be applied to the returned table's fields.
+          Defaults to ``SCHEMA_VIEW`` if unspecified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetTableRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTableRequest)
+
+DeleteTableRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTableRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETABLEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable][google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable]
+  
+  
+  Attributes:
+      name:
+          The unique name of the table to be deleted. Values are of the
+          form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteTableRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTableRequest)
+
+ModifyColumnFamiliesRequest = _reflection.GeneratedProtocolMessageType(
+    "ModifyColumnFamiliesRequest",
+    (_message.Message,),
+    dict(
+        Modification=_reflection.GeneratedProtocolMessageType(
+            "Modification",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION,
+                __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+                __doc__="""A create, update, or delete of a particular column family.
+    
+    
+    Attributes:
+        id:
+            The ID of the column family to be modified.
+        mod:
+            Column familiy modifications.
+        create:
+            Create a new column family with the specified schema, or fail
+            if one already exists with the given ID.
+        update:
+            Update an existing column family to the specified schema, or
+            fail if no column family exists with the given ID.
+        drop:
+            Drop (delete) the column family with the given ID, or fail if
+            no such family exists.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification)
+            ),
+        ),
+        DESCRIPTOR=_MODIFYCOLUMNFAMILIESREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies][google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies]
+  
+  
+  Attributes:
+      name:
+          The unique name of the table whose families should be
+          modified. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      modifications:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ModifyColumnFamiliesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ModifyColumnFamiliesRequest)
+_sym_db.RegisterMessage(ModifyColumnFamiliesRequest.Modification)
+
+GenerateConsistencyTokenRequest = _reflection.GeneratedProtocolMessageType(
+    "GenerateConsistencyTokenRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GENERATECONSISTENCYTOKENREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken][google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken]
+  
+  
+  Attributes:
+      name:
+          The unique name of the Table for which to create a consistency
+          token. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GenerateConsistencyTokenRequest)
+    ),
+)
+_sym_db.RegisterMessage(GenerateConsistencyTokenRequest)
+
+GenerateConsistencyTokenResponse = _reflection.GeneratedProtocolMessageType(
+    "GenerateConsistencyTokenResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GENERATECONSISTENCYTOKENRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Response message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken][google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken]
+  
+  
+  Attributes:
+      consistency_token:
+          The generated consistency token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GenerateConsistencyTokenResponse)
+    ),
+)
+_sym_db.RegisterMessage(GenerateConsistencyTokenResponse)
+
+CheckConsistencyRequest = _reflection.GeneratedProtocolMessageType(
+    "CheckConsistencyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHECKCONSISTENCYREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency][google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency]
+  
+  
+  Attributes:
+      name:
+          The unique name of the Table for which to check replication
+          consistency. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      consistency_token:
+          The token created using GenerateConsistencyToken for the
+          Table.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CheckConsistencyRequest)
+    ),
+)
+_sym_db.RegisterMessage(CheckConsistencyRequest)
+
+CheckConsistencyResponse = _reflection.GeneratedProtocolMessageType(
+    "CheckConsistencyResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHECKCONSISTENCYRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Response message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency][google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency]
+  
+  
+  Attributes:
+      consistent:
+          True only if the token is consistent. A token is consistent if
+          replication has caught up with the restrictions specified in
+          the request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CheckConsistencyResponse)
+    ),
+)
+_sym_db.RegisterMessage(CheckConsistencyResponse)
+
+SnapshotTableRequest = _reflection.GeneratedProtocolMessageType(
+    "SnapshotTableRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SNAPSHOTTABLEREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable][google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable]
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      name:
+          The unique name of the table to have the snapshot taken.
+          Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      cluster:
+          The name of the cluster where the snapshot will be created in.
+          Values are of the form ``projects/<project>/instances/<instanc
+          e>/clusters/<cluster>``.
+      snapshot_id:
+          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>/ins
+          tances/<instance>/clusters/<cluster>/snapshots/mysnapshot``.
+      ttl:
+          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 amount of time a snapshot can stay active
+          is 7 days. If 'ttl' is not specified, the default value of 24
+          hours will be used.
+      description:
+          Description of the snapshot.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.SnapshotTableRequest)
+    ),
+)
+_sym_db.RegisterMessage(SnapshotTableRequest)
+
+GetSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSnapshotRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSNAPSHOTREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot]
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      name:
+          The unique name of the requested snapshot. Values are of the
+          form ``projects/<project>/instances/<instance>/clusters/<clust
+          er>/snapshots/<snapshot>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSnapshotRequest)
+
+ListSnapshotsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSnapshotsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSNAPSHOTSREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots][google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots]
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      parent:
+          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/-``.
+      page_size:
+          The maximum number of snapshots to return per page. CURRENTLY
+          UNIMPLEMENTED AND IGNORED.
+      page_token:
+          The value of ``next_page_token`` returned by a previous call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListSnapshotsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSnapshotsRequest)
+
+ListSnapshotsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSnapshotsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSNAPSHOTSRESPONSE,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Response message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots][google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots]
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      snapshots:
+          The snapshots present in the requested cluster.
+      next_page_token:
+          Set if not all snapshots could be returned in a single
+          response. Pass this value to ``page_token`` in another request
+          to get the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListSnapshotsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSnapshotsResponse)
+
+DeleteSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSnapshotRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESNAPSHOTREQUEST,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""Request message for
+  [google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot]
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      name:
+          The unique name of the snapshot to be deleted. Values are of
+          the form ``projects/<project>/instances/<instance>/clusters/<c
+          luster>/snapshots/<snapshot>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSnapshotRequest)
+
+SnapshotTableMetadata = _reflection.GeneratedProtocolMessageType(
+    "SnapshotTableMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SNAPSHOTTABLEMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""The metadata for the Operation returned by SnapshotTable.
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      original_request:
+          The request that prompted the initiation of this SnapshotTable
+          operation.
+      request_time:
+          The time at which the original request was received.
+      finish_time:
+          The time at which the operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.SnapshotTableMetadata)
+    ),
+)
+_sym_db.RegisterMessage(SnapshotTableMetadata)
+
+CreateTableFromSnapshotMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateTableFromSnapshotMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETABLEFROMSNAPSHOTMETADATA,
+        __module__="google.cloud.bigtable.admin_v2.proto.bigtable_table_admin_pb2",
+        __doc__="""The metadata for the Operation returned by CreateTableFromSnapshot.
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      original_request:
+          The request that prompted the initiation of this
+          CreateTableFromSnapshot operation.
+      request_time:
+          The time at which the original request was received.
+      finish_time:
+          The time at which the operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateTableFromSnapshotMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateTableFromSnapshotMetadata)
+
+
+DESCRIPTOR._options = None
+
+_BIGTABLETABLEADMIN = _descriptor.ServiceDescriptor(
+    name="BigtableTableAdmin",
+    full_name="google.bigtable.admin.v2.BigtableTableAdmin",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2405,
+    serialized_end=4636,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateTable",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.CreateTable",
+            index=0,
+            containing_service=None,
+            input_type=_CREATETABLEREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE,
+            serialized_options=_b(
+                '\202\323\344\223\002/"*/v2/{parent=projects/*/instances/*}/tables:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTableFromSnapshot",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot",
+            index=1,
+            containing_service=None,
+            input_type=_CREATETABLEFROMSNAPSHOTREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v2/{parent=projects/*/instances/*}/tables:createFromSnapshot:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTables",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.ListTables",
+            index=2,
+            containing_service=None,
+            input_type=_LISTTABLESREQUEST,
+            output_type=_LISTTABLESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v2/{parent=projects/*/instances/*}/tables"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTable",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.GetTable",
+            index=3,
+            containing_service=None,
+            input_type=_GETTABLEREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v2/{name=projects/*/instances/*/tables/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTable",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable",
+            index=4,
+            containing_service=None,
+            input_type=_DELETETABLEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002,**/v2/{name=projects/*/instances/*/tables/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ModifyColumnFamilies",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies",
+            index=5,
+            containing_service=None,
+            input_type=_MODIFYCOLUMNFAMILIESREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._TABLE,
+            serialized_options=_b(
+                '\202\323\344\223\002D"?/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DropRowRange",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.DropRowRange",
+            index=6,
+            containing_service=None,
+            input_type=_DROPROWRANGEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002<"7/v2/{name=projects/*/instances/*/tables/*}:dropRowRange:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GenerateConsistencyToken",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken",
+            index=7,
+            containing_service=None,
+            input_type=_GENERATECONSISTENCYTOKENREQUEST,
+            output_type=_GENERATECONSISTENCYTOKENRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002H"C/v2/{name=projects/*/instances/*/tables/*}:generateConsistencyToken:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CheckConsistency",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency",
+            index=8,
+            containing_service=None,
+            input_type=_CHECKCONSISTENCYREQUEST,
+            output_type=_CHECKCONSISTENCYRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v2/{name=projects/*/instances/*/tables/*}:checkConsistency:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SnapshotTable",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable",
+            index=9,
+            containing_service=None,
+            input_type=_SNAPSHOTTABLEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0028"3/v2/{name=projects/*/instances/*/tables/*}:snapshot:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSnapshot",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot",
+            index=10,
+            containing_service=None,
+            input_type=_GETSNAPSHOTREQUEST,
+            output_type=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2._SNAPSHOT,
+            serialized_options=_b(
+                "\202\323\344\223\002:\0228/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSnapshots",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots",
+            index=11,
+            containing_service=None,
+            input_type=_LISTSNAPSHOTSREQUEST,
+            output_type=_LISTSNAPSHOTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002:\0228/v2/{parent=projects/*/instances/*/clusters/*}/snapshots"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSnapshot",
+            full_name="google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot",
+            index=12,
+            containing_service=None,
+            input_type=_DELETESNAPSHOTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002:*8/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_BIGTABLETABLEADMIN)
+
+DESCRIPTOR.services_by_name["BigtableTableAdmin"] = _BIGTABLETABLEADMIN
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin_pb2_grpc.py b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin_pb2_grpc.py
new file mode 100644
index 000000000000..2c702413b4e4
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_admin_pb2_grpc.py
@@ -0,0 +1,312 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigtable_admin_v2.proto import (
+    bigtable_table_admin_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2,
+)
+from google.cloud.bigtable_admin_v2.proto import (
+    table_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class BigtableTableAdminStub(object):
+    """Service for creating, configuring, and deleting Cloud Bigtable tables.
+
+
+  Provides access to the table schemas only, not the data stored within
+  the tables.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateTable = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/CreateTable",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CreateTableRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Table.FromString,
+        )
+        self.CreateTableFromSnapshot = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/CreateTableFromSnapshot",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CreateTableFromSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ListTables = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/ListTables",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListTablesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListTablesResponse.FromString,
+        )
+        self.GetTable = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/GetTable",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GetTableRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Table.FromString,
+        )
+        self.DeleteTable = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/DeleteTable",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.DeleteTableRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ModifyColumnFamilies = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/ModifyColumnFamilies",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ModifyColumnFamiliesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Table.FromString,
+        )
+        self.DropRowRange = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/DropRowRange",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.DropRowRangeRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GenerateConsistencyToken = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/GenerateConsistencyToken",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GenerateConsistencyTokenRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GenerateConsistencyTokenResponse.FromString,
+        )
+        self.CheckConsistency = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/CheckConsistency",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CheckConsistencyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CheckConsistencyResponse.FromString,
+        )
+        self.SnapshotTable = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/SnapshotTable",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.SnapshotTableRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetSnapshot = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/GetSnapshot",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GetSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Snapshot.FromString,
+        )
+        self.ListSnapshots = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/ListSnapshots",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListSnapshotsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListSnapshotsResponse.FromString,
+        )
+        self.DeleteSnapshot = channel.unary_unary(
+            "/google.bigtable.admin.v2.BigtableTableAdmin/DeleteSnapshot",
+            request_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.DeleteSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class BigtableTableAdminServicer(object):
+    """Service for creating, configuring, and deleting Cloud Bigtable tables.
+
+
+  Provides access to the table schemas only, not the data stored within
+  the tables.
+  """
+
+    def CreateTable(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTableFromSnapshot(self, request, context):
+        """Creates a new table from the specified snapshot. The target table must
+    not exist. The snapshot and the table must be in the same instance.
+
+    Note: This is a private alpha release of Cloud Bigtable snapshots. This
+    feature is not currently available to most Cloud Bigtable customers. This
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTables(self, request, context):
+        """Lists all tables served from a specified instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTable(self, request, context):
+        """Gets metadata information about the specified table.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTable(self, request, context):
+        """Permanently deletes a specified table and all of its data.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ModifyColumnFamilies(self, request, context):
+        """Performs a series of column family modifications on the specified table.
+    Either all or none of the modifications will occur before this method
+    returns, but data requests received prior to that point may see a table
+    where only some modifications have taken effect.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DropRowRange(self, request, context):
+        """Permanently drop/delete a row range from a specified table. The request can
+    specify whether to delete all rows in a table, or only those that match a
+    particular prefix.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GenerateConsistencyToken(self, request, context):
+        """Generates a consistency token for a Table, which can be used in
+    CheckConsistency to check whether mutations to the table that finished
+    before this call started have been replicated. The tokens will be available
+    for 90 days.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CheckConsistency(self, request, context):
+        """Checks replication consistency based on a consistency token, that is, if
+    replication has caught up based on the conditions specified in the token
+    and the check request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SnapshotTable(self, request, context):
+        """Creates a new snapshot in the specified cluster from the specified
+    source table. The cluster and the table must be in the same instance.
+
+    Note: This is a private alpha release of Cloud Bigtable snapshots. This
+    feature is not currently available to most Cloud Bigtable customers. This
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSnapshot(self, request, context):
+        """Gets metadata information about the specified snapshot.
+
+    Note: This is a private alpha release of Cloud Bigtable snapshots. This
+    feature is not currently available to most Cloud Bigtable customers. This
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSnapshots(self, request, context):
+        """Lists all snapshots associated with the specified cluster.
+
+    Note: This is a private alpha release of Cloud Bigtable snapshots. This
+    feature is not currently available to most Cloud Bigtable customers. This
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSnapshot(self, request, context):
+        """Permanently deletes the specified snapshot.
+
+    Note: This is a private alpha release of Cloud Bigtable snapshots. This
+    feature is not currently available to most Cloud Bigtable customers. This
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_BigtableTableAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateTable": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTable,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CreateTableRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Table.SerializeToString,
+        ),
+        "CreateTableFromSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTableFromSnapshot,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CreateTableFromSnapshotRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ListTables": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTables,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListTablesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListTablesResponse.SerializeToString,
+        ),
+        "GetTable": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTable,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GetTableRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Table.SerializeToString,
+        ),
+        "DeleteTable": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTable,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.DeleteTableRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ModifyColumnFamilies": grpc.unary_unary_rpc_method_handler(
+            servicer.ModifyColumnFamilies,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ModifyColumnFamiliesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Table.SerializeToString,
+        ),
+        "DropRowRange": grpc.unary_unary_rpc_method_handler(
+            servicer.DropRowRange,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.DropRowRangeRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GenerateConsistencyToken": grpc.unary_unary_rpc_method_handler(
+            servicer.GenerateConsistencyToken,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GenerateConsistencyTokenRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GenerateConsistencyTokenResponse.SerializeToString,
+        ),
+        "CheckConsistency": grpc.unary_unary_rpc_method_handler(
+            servicer.CheckConsistency,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CheckConsistencyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.CheckConsistencyResponse.SerializeToString,
+        ),
+        "SnapshotTable": grpc.unary_unary_rpc_method_handler(
+            servicer.SnapshotTable,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.SnapshotTableRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSnapshot,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.GetSnapshotRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_table__pb2.Snapshot.SerializeToString,
+        ),
+        "ListSnapshots": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSnapshots,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListSnapshotsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.ListSnapshotsResponse.SerializeToString,
+        ),
+        "DeleteSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSnapshot,
+            request_deserializer=google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_bigtable__table__admin__pb2.DeleteSnapshotRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.bigtable.admin.v2.BigtableTableAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_data.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_data.proto
new file mode 100644
index 000000000000..e4efb74f560e
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_data.proto
@@ -0,0 +1,126 @@
+// 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.bigtable.admin.table.v1;
+
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/table/v1;table";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableDataProto";
+option java_package = "com.google.bigtable.admin.table.v1";
+
+
+// A collection of user data indexed by row, column, and timestamp.
+// Each table is served using the resources of its parent cluster.
+message Table {
+  enum TimestampGranularity {
+    MILLIS = 0;
+  }
+
+  // A unique identifier of the form
+  // <cluster_name>/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*
+  string name = 1;
+
+  // If this Table is in the process of being created, the Operation used to
+  // track its progress. As long as this operation is present, the Table will
+  // not accept any Table Admin or Read/Write requests.
+  google.longrunning.Operation current_operation = 2;
+
+  // The column families configured for this table, mapped by column family id.
+  map<string, ColumnFamily> column_families = 3;
+
+  // The granularity (e.g. MILLIS, MICROS) at which timestamps are stored in
+  // this table. Timestamps not matching the granularity will be rejected.
+  // Cannot be changed once the table is created.
+  TimestampGranularity granularity = 4;
+}
+
+// A set of columns within a table which share a common configuration.
+message ColumnFamily {
+  // A unique identifier of the form <table_name>/columnFamilies/[-_.a-zA-Z0-9]+
+  // The last segment is the same as the "name" field in
+  // google.bigtable.v1.Family.
+  string name = 1;
+
+  // Garbage collection expression specified by the following grammar:
+  //   GC = EXPR
+  //      | "" ;
+  //   EXPR = EXPR, "||", EXPR              (* lowest precedence *)
+  //        | EXPR, "&&", EXPR
+  //        | "(", EXPR, ")"                (* highest precedence *)
+  //        | PROP ;
+  //   PROP = "version() >", NUM32
+  //        | "age() >", NUM64, [ UNIT ] ;
+  //   NUM32 = non-zero-digit { digit } ;    (* # NUM32 <= 2^32 - 1 *)
+  //   NUM64 = non-zero-digit { digit } ;    (* # NUM64 <= 2^63 - 1 *)
+  //   UNIT =  "d" | "h" | "m"  (* d=days, h=hours, m=minutes, else micros *)
+  // GC expressions can be up to 500 characters in length
+  //
+  // The different types of PROP are defined as follows:
+  //   version() - cell index, counting from most recent and starting at 1
+  //   age() - age of the cell (current time minus cell timestamp)
+  //
+  // Example: "version() > 3 || (age() > 3d && version() > 1)"
+  //   drop cells beyond the most recent three, and drop cells older than three
+  //   days unless they're the most recent cell in the row/column
+  //
+  // Garbage collection executes opportunistically in the background, and so
+  // it's possible for reads to return a cell even if it matches the active GC
+  // expression for its family.
+  string gc_expression = 2;
+
+  // Garbage collection rule specified as a protobuf.
+  // Supersedes `gc_expression`.
+  // Must serialize to at most 500 bytes.
+  //
+  // NOTE: Garbage collection executes opportunistically in the background, and
+  // so it's possible for reads to return a cell even if it matches the active
+  // GC expression for its family.
+  GcRule gc_rule = 3;
+}
+
+// Rule for determining which cells to delete during garbage collection.
+message GcRule {
+  // A GcRule which deletes cells matching all of the given rules.
+  message Intersection {
+    // Only delete cells which would be deleted by every element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  // A GcRule which deletes cells matching any of the given rules.
+  message Union {
+    // Delete cells which would be deleted by any element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  oneof rule {
+    // Delete all cells in a column except the most recent N.
+    int32 max_num_versions = 1;
+
+    // Delete cells in a column older than the given age.
+    // Values must be at least one millisecond, and will be truncated to
+    // microsecond granularity.
+    google.protobuf.Duration max_age = 2;
+
+    // Delete cells that would be deleted by every nested rule.
+    Intersection intersection = 3;
+
+    // Delete cells that would be deleted by any nested rule.
+    Union union = 4;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_service.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_service.proto
new file mode 100644
index 000000000000..6e968fee17c1
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_service.proto
@@ -0,0 +1,80 @@
+// 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.bigtable.admin.table.v1;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/table/v1/bigtable_table_data.proto";
+import "google/bigtable/admin/table/v1/bigtable_table_service_messages.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/table/v1;table";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableServicesProto";
+option java_package = "com.google.bigtable.admin.table.v1";
+
+
+// Service for creating, configuring, and deleting Cloud Bigtable tables.
+// Provides access to the table schemas only, not the data stored within the tables.
+service BigtableTableService {
+  // Creates a new table, to be served from a specified cluster.
+  // The table can be created with a full set of initial column families,
+  // specified in the request.
+  rpc CreateTable(CreateTableRequest) returns (Table) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*}/tables" body: "*" };
+  }
+
+  // Lists the names of all tables served from a specified cluster.
+  rpc ListTables(ListTablesRequest) returns (ListTablesResponse) {
+    option (google.api.http) = { get: "/v1/{name=projects/*/zones/*/clusters/*}/tables" };
+  }
+
+  // Gets the schema of the specified table, including its column families.
+  rpc GetTable(GetTableRequest) returns (Table) {
+    option (google.api.http) = { get: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}" };
+  }
+
+  // Permanently deletes a specified table and all of its data.
+  rpc DeleteTable(DeleteTableRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}" };
+  }
+
+  // Changes the name of a specified table.
+  // Cannot be used to move tables between clusters, zones, or projects.
+  rpc RenameTable(RenameTableRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}:rename" body: "*" };
+  }
+
+  // Creates a new column family within a specified table.
+  rpc CreateColumnFamily(CreateColumnFamilyRequest) returns (ColumnFamily) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}/columnFamilies" body: "*" };
+  }
+
+  // Changes the configuration of a specified column family.
+  rpc UpdateColumnFamily(ColumnFamily) returns (ColumnFamily) {
+    option (google.api.http) = { put: "/v1/{name=projects/*/zones/*/clusters/*/tables/*/columnFamilies/*}" body: "*" };
+  }
+
+  // Permanently deletes a specified column family and all of its data.
+  rpc DeleteColumnFamily(DeleteColumnFamilyRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v1/{name=projects/*/zones/*/clusters/*/tables/*/columnFamilies/*}" };
+  }
+
+  // Delete all rows in a table corresponding to a particular prefix
+  rpc BulkDeleteRows(BulkDeleteRowsRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}:bulkDeleteRows" body: "*" };
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_service_messages.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_service_messages.proto
new file mode 100644
index 000000000000..617ede65592f
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/bigtable_table_service_messages.proto
@@ -0,0 +1,116 @@
+// 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.bigtable.admin.table.v1;
+
+import "google/bigtable/admin/table/v1/bigtable_table_data.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/table/v1;table";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableServiceMessagesProto";
+option java_package = "com.google.bigtable.admin.table.v1";
+
+
+message CreateTableRequest {
+  // The unique name of the cluster in which to create the new table.
+  string name = 1;
+
+  // The name by which the new table should be referred to within the cluster,
+  // e.g. "foobar" rather than "<cluster_name>/tables/foobar".
+  string table_id = 2;
+
+  // The Table to create. The `name` field of the Table and all of its
+  // ColumnFamilies must be left blank, and will be populated in the response.
+  Table table = 3;
+
+  // The optional list of row keys that will be used to initially split the
+  // table into several tablets (Tablets are similar to HBase regions).
+  // Given two split keys, "s1" and "s2", three tablets will be created,
+  // spanning the key ranges: [, s1), [s1, s2), [s2, ).
+  //
+  // Example:
+  //  * Row keys := ["a", "apple", "custom", "customer_1", "customer_2",
+  //                 "other", "zz"]
+  //  * initial_split_keys := ["apple", "customer_1", "customer_2", "other"]
+  //  * Key assignment:
+  //    - Tablet 1 [, apple)                => {"a"}.
+  //    - Tablet 2 [apple, customer_1)      => {"apple", "custom"}.
+  //    - Tablet 3 [customer_1, customer_2) => {"customer_1"}.
+  //    - Tablet 4 [customer_2, other)      => {"customer_2"}.
+  //    - Tablet 5 [other, )                => {"other", "zz"}.
+  repeated string initial_split_keys = 4;
+}
+
+message ListTablesRequest {
+  // The unique name of the cluster for which tables should be listed.
+  string name = 1;
+}
+
+message ListTablesResponse {
+  // The tables present in the requested cluster.
+  // At present, only the names of the tables are populated.
+  repeated Table tables = 1;
+}
+
+message GetTableRequest {
+  // The unique name of the requested table.
+  string name = 1;
+}
+
+message DeleteTableRequest {
+  // The unique name of the table to be deleted.
+  string name = 1;
+}
+
+message RenameTableRequest {
+  // The current unique name of the table.
+  string name = 1;
+
+  // The new name by which the table should be referred to within its containing
+  // cluster, e.g. "foobar" rather than "<cluster_name>/tables/foobar".
+  string new_id = 2;
+}
+
+message CreateColumnFamilyRequest {
+  // The unique name of the table in which to create the new column family.
+  string name = 1;
+
+  // The name by which the new column family should be referred to within the
+  // table, e.g. "foobar" rather than "<table_name>/columnFamilies/foobar".
+  string column_family_id = 2;
+
+  // The column family to create. The `name` field must be left blank.
+  ColumnFamily column_family = 3;
+}
+
+message DeleteColumnFamilyRequest {
+  // The unique name of the column family to be deleted.
+  string name = 1;
+}
+
+message BulkDeleteRowsRequest {
+  // The unique name of the table on which to perform the bulk delete
+  string table_name = 1;
+
+  oneof target {
+    // Delete all rows that start with this row key prefix. Prefix cannot be
+    // zero length.
+    bytes row_key_prefix = 2;
+
+    // Delete all rows in the table. Setting this to false is a no-op.
+    bool delete_all_data_from_table = 3;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/common.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/common.proto
new file mode 100644
index 000000000000..ad4d735994f3
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/common.proto
@@ -0,0 +1,40 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+// Storage media types for persisting Bigtable data.
+enum StorageType {
+  // The user did not specify a storage type.
+  STORAGE_TYPE_UNSPECIFIED = 0;
+
+  // Flash (SSD) storage should be used.
+  SSD = 1;
+
+  // Magnetic drive (HDD) storage should be used.
+  HDD = 2;
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/common_pb2.py b/bigtable/google/cloud/bigtable_admin_v2/proto/common_pb2.py
new file mode 100644
index 000000000000..7d40f043d05c
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/common_pb2.py
@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable/admin_v2/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable/admin_v2/proto/common.proto",
+    package="google.bigtable.admin.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.bigtable.admin.v2B\013CommonProtoP\001Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\252\002\036Google.Cloud.Bigtable.Admin.V2\312\002\036Google\\Cloud\\Bigtable\\Admin\\V2"
+    ),
+    serialized_pb=_b(
+        "\n1google/cloud/bigtable/admin_v2/proto/common.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto*=\n\x0bStorageType\x12\x1c\n\x18STORAGE_TYPE_UNSPECIFIED\x10\x00\x12\x07\n\x03SSD\x10\x01\x12\x07\n\x03HDD\x10\x02\x42\xae\x01\n\x1c\x63om.google.bigtable.admin.v2B\x0b\x43ommonProtoP\x01Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\xaa\x02\x1eGoogle.Cloud.Bigtable.Admin.V2\xca\x02\x1eGoogle\\Cloud\\Bigtable\\Admin\\V2b\x06proto3"
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_STORAGETYPE = _descriptor.EnumDescriptor(
+    name="StorageType",
+    full_name="google.bigtable.admin.v2.StorageType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STORAGE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SSD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HDD", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=142,
+    serialized_end=203,
+)
+_sym_db.RegisterEnumDescriptor(_STORAGETYPE)
+
+StorageType = enum_type_wrapper.EnumTypeWrapper(_STORAGETYPE)
+STORAGE_TYPE_UNSPECIFIED = 0
+SSD = 1
+HDD = 2
+
+
+DESCRIPTOR.enum_types_by_name["StorageType"] = _STORAGETYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/common_pb2_grpc.py b/bigtable/google/cloud/bigtable_admin_v2/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/instance.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/instance.proto
new file mode 100644
index 000000000000..ef8599bfe349
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/instance.proto
@@ -0,0 +1,205 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/v2/common.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "InstanceProto";
+option java_package = "com.google.bigtable.admin.v2";
+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].
+message Instance {
+  // Possible states of an instance.
+  enum State {
+    // The state of the instance could not be determined.
+    STATE_NOT_KNOWN = 0;
+
+    // The instance has been successfully created and can serve requests
+    // to its tables.
+    READY = 1;
+
+    // The instance is currently being created, and may be destroyed
+    // if the creation process encounters an error.
+    CREATING = 2;
+  }
+
+  // The type of the instance.
+  enum Type {
+    // The type of the instance is unspecified. If set when creating an
+    // instance, a `PRODUCTION` instance will be created. If set when updating
+    // an instance, the type will be left unchanged.
+    TYPE_UNSPECIFIED = 0;
+
+    // An instance meant for production use. `serve_nodes` must be set
+    // on the cluster.
+    PRODUCTION = 1;
+
+    // The instance is meant for development and testing purposes only; it has
+    // no performance or uptime guarantees and is not covered by SLA.
+    // After a development instance is created, it can be upgraded by
+    // updating the instance to type `PRODUCTION`. An instance created
+    // as a production instance cannot be changed to a development instance.
+    // When creating a development instance, `serve_nodes` on the cluster must
+    // not be set.
+    DEVELOPMENT = 2;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the instance. Values are of the form
+  // `projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
+  string name = 1;
+
+  // 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;
+
+  // (`OutputOnly`)
+  // The current state of the instance.
+  State state = 3;
+
+  // The type of the instance. Defaults to `PRODUCTION`.
+  Type type = 4;
+
+  // Labels are a flexible and lightweight mechanism for organizing cloud
+  // resources into groups that reflect a customer's organizational needs and
+  // deployment strategies. They can be used to filter resources and aggregate
+  // metrics.
+  //
+  // * Label keys must be between 1 and 63 characters long and must conform to
+  //   the regular expression: `[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}`.
+  // * Label values must be between 0 and 63 characters long and must conform to
+  //   the regular expression: `[\p{Ll}\p{Lo}\p{N}_-]{0,63}`.
+  // * No more than 64 labels can be associated with a given resource.
+  // * Keys and values must both be under 128 bytes.
+  map<string, string> labels = 5;
+}
+
+// A resizable group of nodes in a particular cloud location, capable
+// of serving all [Tables][google.bigtable.admin.v2.Table] in the parent
+// [Instance][google.bigtable.admin.v2.Instance].
+message Cluster {
+  // Possible states of a cluster.
+  enum State {
+    // The state of the cluster could not be determined.
+    STATE_NOT_KNOWN = 0;
+
+    // The cluster has been successfully created and is ready to serve requests.
+    READY = 1;
+
+    // The cluster is currently being created, and may be destroyed
+    // if the creation process encounters an error.
+    // A cluster may not be able to serve requests while being created.
+    CREATING = 2;
+
+    // The cluster is currently being resized, and may revert to its previous
+    // node count if the process encounters an error.
+    // A cluster is still capable of serving requests while being resized,
+    // but may exhibit performance as if its number of allocated nodes is
+    // between the starting and requested states.
+    RESIZING = 3;
+
+    // The cluster has no backing nodes. The data (tables) still
+    // exist, but no operations can be performed on the cluster.
+    DISABLED = 4;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the cluster. Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*`.
+  string name = 1;
+
+  // (`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/<project>/locations/<zone>`.
+  string location = 2;
+
+  // (`OutputOnly`)
+  // The current state of the cluster.
+  State state = 3;
+
+  // The number of nodes allocated to this cluster. More nodes enable higher
+  // throughput and more consistent performance.
+  int32 serve_nodes = 4;
+
+  // (`CreationOnly`)
+  // The type of storage used by this cluster to serve its
+  // parent instance's tables, unless explicitly overridden.
+  StorageType default_storage_type = 5;
+}
+
+// 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.
+  message MultiClusterRoutingUseAny {}
+
+  // Unconditionally routes all read/write requests to a specific cluster.
+  // This option preserves read-your-writes consistency, but does not improve
+  // availability.
+  message SingleClusterRouting {
+    // The cluster to which read/write requests should be routed.
+    string cluster_id = 1;
+
+    // Whether or not `CheckAndMutateRow` and `ReadModifyWriteRow` requests are
+    // allowed by this app profile. It is unsafe to send these requests to
+    // the same table/row/column in multiple clusters.
+    bool allow_transactional_writes = 2;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the app profile. Values are of the form
+  // `projects/<project>/instances/<instance>/appProfiles/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`.
+  string name = 1;
+
+  // Strongly validated etag for optimistic concurrency control. Preserve the
+  // value returned from `GetAppProfile` when calling `UpdateAppProfile` to
+  // fail the request if there has been a modification in the mean time. The
+  // `update_mask` of the request need not include `etag` for this protection
+  // to apply.
+  // See [Wikipedia](https://en.wikipedia.org/wiki/HTTP_ETag) and
+  // [RFC 7232](https://tools.ietf.org/html/rfc7232#section-2.3) for more
+  // details.
+  string etag = 2;
+
+  // 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.
+  // A value must be explicitly set.
+  oneof routing_policy {
+    // Use a multi-cluster routing policy that may pick any cluster.
+    MultiClusterRoutingUseAny multi_cluster_routing_use_any = 5;
+
+    // Use a single-cluster routing policy.
+    SingleClusterRouting single_cluster_routing = 6;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/instance_pb2.py b/bigtable/google/cloud/bigtable_admin_v2/proto/instance_pb2.py
new file mode 100644
index 000000000000..49164dfe6693
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/instance_pb2.py
@@ -0,0 +1,814 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable/admin_v2/proto/instance.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigtable_admin_v2.proto import (
+    common_pb2 as google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_common__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable/admin_v2/proto/instance.proto",
+    package="google.bigtable.admin.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.bigtable.admin.v2B\rInstanceProtoP\001Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\252\002\036Google.Cloud.Bigtable.Admin.V2\312\002\036Google\\Cloud\\Bigtable\\Admin\\V2"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/bigtable/admin_v2/proto/instance.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x31google/cloud/bigtable/admin_v2/proto/common.proto"\x83\x03\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x37\n\x05state\x18\x03 \x01(\x0e\x32(.google.bigtable.admin.v2.Instance.State\x12\x35\n\x04type\x18\x04 \x01(\x0e\x32\'.google.bigtable.admin.v2.Instance.Type\x12>\n\x06labels\x18\x05 \x03(\x0b\x32..google.bigtable.admin.v2.Instance.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"5\n\x05State\x12\x13\n\x0fSTATE_NOT_KNOWN\x10\x00\x12\t\n\x05READY\x10\x01\x12\x0c\n\x08\x43REATING\x10\x02"=\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nPRODUCTION\x10\x01\x12\x0f\n\x0b\x44\x45VELOPMENT\x10\x02"\x8e\x02\n\x07\x43luster\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08location\x18\x02 \x01(\t\x12\x36\n\x05state\x18\x03 \x01(\x0e\x32\'.google.bigtable.admin.v2.Cluster.State\x12\x13\n\x0bserve_nodes\x18\x04 \x01(\x05\x12\x43\n\x14\x64\x65\x66\x61ult_storage_type\x18\x05 \x01(\x0e\x32%.google.bigtable.admin.v2.StorageType"Q\n\x05State\x12\x13\n\x0fSTATE_NOT_KNOWN\x10\x00\x12\t\n\x05READY\x10\x01\x12\x0c\n\x08\x43REATING\x10\x02\x12\x0c\n\x08RESIZING\x10\x03\x12\x0c\n\x08\x44ISABLED\x10\x04"\x82\x03\n\nAppProfile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x65tag\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12g\n\x1dmulti_cluster_routing_use_any\x18\x05 \x01(\x0b\x32>.google.bigtable.admin.v2.AppProfile.MultiClusterRoutingUseAnyH\x00\x12[\n\x16single_cluster_routing\x18\x06 \x01(\x0b\x32\x39.google.bigtable.admin.v2.AppProfile.SingleClusterRoutingH\x00\x1a\x1b\n\x19MultiClusterRoutingUseAny\x1aN\n\x14SingleClusterRouting\x12\x12\n\ncluster_id\x18\x01 \x01(\t\x12"\n\x1a\x61llow_transactional_writes\x18\x02 \x01(\x08\x42\x10\n\x0erouting_policyB\xb0\x01\n\x1c\x63om.google.bigtable.admin.v2B\rInstanceProtoP\x01Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\xaa\x02\x1eGoogle.Cloud.Bigtable.Admin.V2\xca\x02\x1eGoogle\\Cloud\\Bigtable\\Admin\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_INSTANCE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.bigtable.admin.v2.Instance.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_NOT_KNOWN",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=434,
+    serialized_end=487,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_STATE)
+
+_INSTANCE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.bigtable.admin.v2.Instance.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRODUCTION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEVELOPMENT", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=489,
+    serialized_end=550,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_TYPE)
+
+_CLUSTER_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.bigtable.admin.v2.Cluster.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_NOT_KNOWN",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESIZING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=742,
+    serialized_end=823,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTER_STATE)
+
+
+_INSTANCE_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.bigtable.admin.v2.Instance.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.bigtable.admin.v2.Instance.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.admin.v2.Instance.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=387,
+    serialized_end=432,
+)
+
+_INSTANCE = _descriptor.Descriptor(
+    name="Instance",
+    full_name="google.bigtable.admin.v2.Instance",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.Instance.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.bigtable.admin.v2.Instance.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.bigtable.admin.v2.Instance.state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.bigtable.admin.v2.Instance.type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.bigtable.admin.v2.Instance.labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSTANCE_LABELSENTRY],
+    enum_types=[_INSTANCE_STATE, _INSTANCE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=163,
+    serialized_end=550,
+)
+
+
+_CLUSTER = _descriptor.Descriptor(
+    name="Cluster",
+    full_name="google.bigtable.admin.v2.Cluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.Cluster.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.bigtable.admin.v2.Cluster.location",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.bigtable.admin.v2.Cluster.state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="serve_nodes",
+            full_name="google.bigtable.admin.v2.Cluster.serve_nodes",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="default_storage_type",
+            full_name="google.bigtable.admin.v2.Cluster.default_storage_type",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CLUSTER_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=553,
+    serialized_end=823,
+)
+
+
+_APPPROFILE_MULTICLUSTERROUTINGUSEANY = _descriptor.Descriptor(
+    name="MultiClusterRoutingUseAny",
+    full_name="google.bigtable.admin.v2.AppProfile.MultiClusterRoutingUseAny",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1087,
+    serialized_end=1114,
+)
+
+_APPPROFILE_SINGLECLUSTERROUTING = _descriptor.Descriptor(
+    name="SingleClusterRouting",
+    full_name="google.bigtable.admin.v2.AppProfile.SingleClusterRouting",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.bigtable.admin.v2.AppProfile.SingleClusterRouting.cluster_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_transactional_writes",
+            full_name="google.bigtable.admin.v2.AppProfile.SingleClusterRouting.allow_transactional_writes",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1116,
+    serialized_end=1194,
+)
+
+_APPPROFILE = _descriptor.Descriptor(
+    name="AppProfile",
+    full_name="google.bigtable.admin.v2.AppProfile",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.AppProfile.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.bigtable.admin.v2.AppProfile.etag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.bigtable.admin.v2.AppProfile.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="multi_cluster_routing_use_any",
+            full_name="google.bigtable.admin.v2.AppProfile.multi_cluster_routing_use_any",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="single_cluster_routing",
+            full_name="google.bigtable.admin.v2.AppProfile.single_cluster_routing",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _APPPROFILE_MULTICLUSTERROUTINGUSEANY,
+        _APPPROFILE_SINGLECLUSTERROUTING,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="routing_policy",
+            full_name="google.bigtable.admin.v2.AppProfile.routing_policy",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=826,
+    serialized_end=1212,
+)
+
+_INSTANCE_LABELSENTRY.containing_type = _INSTANCE
+_INSTANCE.fields_by_name["state"].enum_type = _INSTANCE_STATE
+_INSTANCE.fields_by_name["type"].enum_type = _INSTANCE_TYPE
+_INSTANCE.fields_by_name["labels"].message_type = _INSTANCE_LABELSENTRY
+_INSTANCE_STATE.containing_type = _INSTANCE
+_INSTANCE_TYPE.containing_type = _INSTANCE
+_CLUSTER.fields_by_name["state"].enum_type = _CLUSTER_STATE
+_CLUSTER.fields_by_name[
+    "default_storage_type"
+].enum_type = (
+    google_dot_cloud_dot_bigtable_dot_admin__v2_dot_proto_dot_common__pb2._STORAGETYPE
+)
+_CLUSTER_STATE.containing_type = _CLUSTER
+_APPPROFILE_MULTICLUSTERROUTINGUSEANY.containing_type = _APPPROFILE
+_APPPROFILE_SINGLECLUSTERROUTING.containing_type = _APPPROFILE
+_APPPROFILE.fields_by_name[
+    "multi_cluster_routing_use_any"
+].message_type = _APPPROFILE_MULTICLUSTERROUTINGUSEANY
+_APPPROFILE.fields_by_name[
+    "single_cluster_routing"
+].message_type = _APPPROFILE_SINGLECLUSTERROUTING
+_APPPROFILE.oneofs_by_name["routing_policy"].fields.append(
+    _APPPROFILE.fields_by_name["multi_cluster_routing_use_any"]
+)
+_APPPROFILE.fields_by_name[
+    "multi_cluster_routing_use_any"
+].containing_oneof = _APPPROFILE.oneofs_by_name["routing_policy"]
+_APPPROFILE.oneofs_by_name["routing_policy"].fields.append(
+    _APPPROFILE.fields_by_name["single_cluster_routing"]
+)
+_APPPROFILE.fields_by_name[
+    "single_cluster_routing"
+].containing_oneof = _APPPROFILE.oneofs_by_name["routing_policy"]
+DESCRIPTOR.message_types_by_name["Instance"] = _INSTANCE
+DESCRIPTOR.message_types_by_name["Cluster"] = _CLUSTER
+DESCRIPTOR.message_types_by_name["AppProfile"] = _APPPROFILE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Instance = _reflection.GeneratedProtocolMessageType(
+    "Instance",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANCE_LABELSENTRY,
+                __module__="google.cloud.bigtable.admin_v2.proto.instance_pb2"
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Instance.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_INSTANCE,
+        __module__="google.cloud.bigtable.admin_v2.proto.instance_pb2",
+        __doc__="""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].
+  
+  
+  Attributes:
+      name:
+          (``OutputOnly``) The unique name of the instance. Values are
+          of the form
+          ``projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]``.
+      display_name:
+          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.
+      state:
+          (``OutputOnly``) The current state of the instance.
+      type:
+          The type of the instance. Defaults to ``PRODUCTION``.
+      labels:
+          Labels are a flexible and lightweight mechanism for organizing
+          cloud resources into groups that reflect a customer's
+          organizational needs and deployment strategies. They can be
+          used to filter resources and aggregate metrics.  -  Label keys
+          must be between 1 and 63 characters long and must conform
+          to the regular expression:
+          ``[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}``. -  Label values
+          must be between 0 and 63 characters long and must    conform
+          to the regular expression: ``[\p{Ll}\p{Lo}\p{N}_-]{0,63}``. -
+          No more than 64 labels can be associated with a given
+          resource. -  Keys and values must both be under 128 bytes.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Instance)
+    ),
+)
+_sym_db.RegisterMessage(Instance)
+_sym_db.RegisterMessage(Instance.LabelsEntry)
+
+Cluster = _reflection.GeneratedProtocolMessageType(
+    "Cluster",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTER,
+        __module__="google.cloud.bigtable.admin_v2.proto.instance_pb2",
+        __doc__="""A resizable group of nodes in a particular cloud location, capable of
+  serving all [Tables][google.bigtable.admin.v2.Table] in the parent
+  [Instance][google.bigtable.admin.v2.Instance].
+  
+  
+  Attributes:
+      name:
+          (``OutputOnly``) The unique name of the cluster. Values are of
+          the form ``projects/<project>/instances/<instance>/clusters/[a
+          -z][-a-z0-9]*``.
+      location:
+          (``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/<project>/locations/<zone>``.
+      state:
+          (``OutputOnly``) The current state of the cluster.
+      serve_nodes:
+          The number of nodes allocated to this cluster. More nodes
+          enable higher throughput and more consistent performance.
+      default_storage_type:
+          (``CreationOnly``) The type of storage used by this cluster to
+          serve its parent instance's tables, unless explicitly
+          overridden.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Cluster)
+    ),
+)
+_sym_db.RegisterMessage(Cluster)
+
+AppProfile = _reflection.GeneratedProtocolMessageType(
+    "AppProfile",
+    (_message.Message,),
+    dict(
+        MultiClusterRoutingUseAny=_reflection.GeneratedProtocolMessageType(
+            "MultiClusterRoutingUseAny",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPPROFILE_MULTICLUSTERROUTINGUSEANY,
+                __module__="google.cloud.bigtable.admin_v2.proto.instance_pb2",
+                __doc__="""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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.AppProfile.MultiClusterRoutingUseAny)
+            ),
+        ),
+        SingleClusterRouting=_reflection.GeneratedProtocolMessageType(
+            "SingleClusterRouting",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPPROFILE_SINGLECLUSTERROUTING,
+                __module__="google.cloud.bigtable.admin_v2.proto.instance_pb2",
+                __doc__="""Unconditionally routes all read/write requests to a specific cluster.
+    This option preserves read-your-writes consistency, but does not improve
+    availability.
+    
+    
+    Attributes:
+        cluster_id:
+            The cluster to which read/write requests should be routed.
+        allow_transactional_writes:
+            Whether or not ``CheckAndMutateRow`` and
+            ``ReadModifyWriteRow`` requests are allowed by this app
+            profile. It is unsafe to send these requests to the same
+            table/row/column in multiple clusters.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.AppProfile.SingleClusterRouting)
+            ),
+        ),
+        DESCRIPTOR=_APPPROFILE,
+        __module__="google.cloud.bigtable.admin_v2.proto.instance_pb2",
+        __doc__="""A configuration object describing how Cloud Bigtable should treat
+  traffic from a particular end user application.
+  
+  
+  Attributes:
+      name:
+          (``OutputOnly``) The unique name of the app profile. Values
+          are of the form
+          ``projects/<project>/instances/<instance>/appProfiles/[_a-
+          zA-Z0-9][-_.a-zA-Z0-9]*``.
+      etag:
+          Strongly validated etag for optimistic concurrency control.
+          Preserve the value returned from ``GetAppProfile`` when
+          calling ``UpdateAppProfile`` to fail the request if there has
+          been a modification in the mean time. The ``update_mask`` of
+          the request need not include ``etag`` for this protection to
+          apply. See `Wikipedia
+          <https://en.wikipedia.org/wiki/HTTP_ETag>`__ and `RFC 7232
+          <https://tools.ietf.org/html/rfc7232#section-2.3>`__ for more
+          details.
+      description:
+          Optional long form description of the use case for this
+          AppProfile.
+      routing_policy:
+          The routing policy for all read/write requests which use this
+          app profile. A value must be explicitly set.
+      multi_cluster_routing_use_any:
+          Use a multi-cluster routing policy that may pick any cluster.
+      single_cluster_routing:
+          Use a single-cluster routing policy.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.AppProfile)
+    ),
+)
+_sym_db.RegisterMessage(AppProfile)
+_sym_db.RegisterMessage(AppProfile.MultiClusterRoutingUseAny)
+_sym_db.RegisterMessage(AppProfile.SingleClusterRouting)
+
+
+DESCRIPTOR._options = None
+_INSTANCE_LABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/instance_pb2_grpc.py b/bigtable/google/cloud/bigtable_admin_v2/proto/instance_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/instance_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/table.proto b/bigtable/google/cloud/bigtable_admin_v2/proto/table.proto
new file mode 100644
index 000000000000..5019d8b86448
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/table.proto
@@ -0,0 +1,220 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "TableProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+// A collection of user data indexed by row, column, and timestamp.
+// Each table is served using the resources of its parent cluster.
+message Table {
+  // The state of a table's data in a particular cluster.
+  message ClusterState {
+    // Table replication states.
+    enum ReplicationState {
+      // The replication state of the table is unknown in this cluster.
+      STATE_NOT_KNOWN = 0;
+
+      // The cluster was recently created, and the table must finish copying
+      // over pre-existing data from other clusters before it can begin
+      // receiving live replication updates and serving Data API requests.
+      INITIALIZING = 1;
+
+      // The table is temporarily unable to serve Data API requests from this
+      // cluster due to planned internal maintenance.
+      PLANNED_MAINTENANCE = 2;
+
+      // The table is temporarily unable to serve Data API requests from this
+      // cluster due to unplanned or emergency maintenance.
+      UNPLANNED_MAINTENANCE = 3;
+
+      // The table can serve Data API requests from this cluster. Depending on
+      // replication delay, reads may not immediately reflect the state of the
+      // table in other clusters.
+      READY = 4;
+    }
+
+    // (`OutputOnly`)
+    // The state of replication for the table in this cluster.
+    ReplicationState replication_state = 1;
+  }
+
+  // Possible timestamp granularities to use when keeping multiple versions
+  // of data in a table.
+  enum TimestampGranularity {
+    // The user did not specify a granularity. Should not be returned.
+    // When specified during table creation, MILLIS will be used.
+    TIMESTAMP_GRANULARITY_UNSPECIFIED = 0;
+
+    // The table keeps data versioned at a granularity of 1ms.
+    MILLIS = 1;
+  }
+
+  // Defines a view over a table's fields.
+  enum View {
+    // Uses the default view for each method as documented in its request.
+    VIEW_UNSPECIFIED = 0;
+
+    // Only populates `name`.
+    NAME_ONLY = 1;
+
+    // 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.
+    REPLICATION_VIEW = 3;
+
+    // Populates all fields.
+    FULL = 4;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the table. Values are of the form
+  // `projects/<project>/instances/<instance>/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.
+  // 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`.
+  // Views: `REPLICATION_VIEW`, `FULL`
+  map<string, ClusterState> cluster_states = 2;
+
+  // (`CreationOnly`)
+  // The column families configured for this table, mapped by column family ID.
+  // Views: `SCHEMA_VIEW`, `FULL`
+  map<string, ColumnFamily> column_families = 3;
+
+  // (`CreationOnly`)
+  // 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`
+  TimestampGranularity granularity = 4;
+}
+
+// A set of columns within a table which share a common configuration.
+message ColumnFamily {
+  // Garbage collection rule specified as a protobuf.
+  // Must serialize to at most 500 bytes.
+  //
+  // NOTE: Garbage collection executes opportunistically in the background, and
+  // so it's possible for reads to return a cell even if it matches the active
+  // GC expression for its family.
+  GcRule gc_rule = 1;
+}
+
+// Rule for determining which cells to delete during garbage collection.
+message GcRule {
+  // A GcRule which deletes cells matching all of the given rules.
+  message Intersection {
+    // Only delete cells which would be deleted by every element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  // A GcRule which deletes cells matching any of the given rules.
+  message Union {
+    // Delete cells which would be deleted by any element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  // Garbage collection rules.
+  oneof rule {
+    // Delete all cells in a column except the most recent N.
+    int32 max_num_versions = 1;
+
+    // Delete cells in a column older than the given age.
+    // Values must be at least one millisecond, and will be truncated to
+    // microsecond granularity.
+    google.protobuf.Duration max_age = 2;
+
+    // Delete cells that would be deleted by every nested rule.
+    Intersection intersection = 3;
+
+    // Delete cells that would be deleted by any nested rule.
+    Union union = 4;
+  }
+}
+
+// A snapshot of a table at a particular time. A snapshot can be used as a
+// checkpoint for data restoration or a data source for a new table.
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 {
+  // Possible states of a snapshot.
+  enum State {
+    // The state of the snapshot could not be determined.
+    STATE_NOT_KNOWN = 0;
+
+    // The snapshot has been successfully created and can serve all requests.
+    READY = 1;
+
+    // The snapshot is currently being created, and may be destroyed if the
+    // creation process encounters an error. A snapshot may not be restored to a
+    // table while it is being created.
+    CREATING = 2;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the snapshot.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+  string name = 1;
+
+  // (`OutputOnly`)
+  // 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.
+  int64 data_size_bytes = 3;
+
+  // (`OutputOnly`)
+  // 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,
+  // the default maximum of 365 days will be used.
+  google.protobuf.Timestamp delete_time = 5;
+
+  // (`OutputOnly`)
+  // The current state of the snapshot.
+  State state = 6;
+
+  // (`OutputOnly`)
+  // Description of the snapshot.
+  string description = 7;
+}
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/table_pb2.py b/bigtable/google/cloud/bigtable_admin_v2/proto/table_pb2.py
new file mode 100644
index 000000000000..e15dd2ba5b3f
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/table_pb2.py
@@ -0,0 +1,1042 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable/admin_v2/proto/table.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable/admin_v2/proto/table.proto",
+    package="google.bigtable.admin.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.bigtable.admin.v2B\nTableProtoP\001Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\252\002\036Google.Cloud.Bigtable.Admin.V2\312\002\036Google\\Cloud\\Bigtable\\Admin\\V2"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/bigtable/admin_v2/proto/table.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xcb\x06\n\x05Table\x12\x0c\n\x04name\x18\x01 \x01(\t\x12J\n\x0e\x63luster_states\x18\x02 \x03(\x0b\x32\x32.google.bigtable.admin.v2.Table.ClusterStatesEntry\x12L\n\x0f\x63olumn_families\x18\x03 \x03(\x0b\x32\x33.google.bigtable.admin.v2.Table.ColumnFamiliesEntry\x12I\n\x0bgranularity\x18\x04 \x01(\x0e\x32\x34.google.bigtable.admin.v2.Table.TimestampGranularity\x1a\xe2\x01\n\x0c\x43lusterState\x12X\n\x11replication_state\x18\x01 \x01(\x0e\x32=.google.bigtable.admin.v2.Table.ClusterState.ReplicationState"x\n\x10ReplicationState\x12\x13\n\x0fSTATE_NOT_KNOWN\x10\x00\x12\x10\n\x0cINITIALIZING\x10\x01\x12\x17\n\x13PLANNED_MAINTENANCE\x10\x02\x12\x19\n\x15UNPLANNED_MAINTENANCE\x10\x03\x12\t\n\x05READY\x10\x04\x1a\x62\n\x12\x43lusterStatesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12;\n\x05value\x18\x02 \x01(\x0b\x32,.google.bigtable.admin.v2.Table.ClusterState:\x02\x38\x01\x1a]\n\x13\x43olumnFamiliesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x35\n\x05value\x18\x02 \x01(\x0b\x32&.google.bigtable.admin.v2.ColumnFamily:\x02\x38\x01"I\n\x14TimestampGranularity\x12%\n!TIMESTAMP_GRANULARITY_UNSPECIFIED\x10\x00\x12\n\n\x06MILLIS\x10\x01"\\\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\r\n\tNAME_ONLY\x10\x01\x12\x0f\n\x0bSCHEMA_VIEW\x10\x02\x12\x14\n\x10REPLICATION_VIEW\x10\x03\x12\x08\n\x04\x46ULL\x10\x04"A\n\x0c\x43olumnFamily\x12\x31\n\x07gc_rule\x18\x01 \x01(\x0b\x32 .google.bigtable.admin.v2.GcRule"\xd5\x02\n\x06GcRule\x12\x1a\n\x10max_num_versions\x18\x01 \x01(\x05H\x00\x12,\n\x07max_age\x18\x02 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x45\n\x0cintersection\x18\x03 \x01(\x0b\x32-.google.bigtable.admin.v2.GcRule.IntersectionH\x00\x12\x37\n\x05union\x18\x04 \x01(\x0b\x32&.google.bigtable.admin.v2.GcRule.UnionH\x00\x1a?\n\x0cIntersection\x12/\n\x05rules\x18\x01 \x03(\x0b\x32 .google.bigtable.admin.v2.GcRule\x1a\x38\n\x05Union\x12/\n\x05rules\x18\x01 \x03(\x0b\x32 .google.bigtable.admin.v2.GcRuleB\x06\n\x04rule"\xcf\x02\n\x08Snapshot\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x0csource_table\x18\x02 \x01(\x0b\x32\x1f.google.bigtable.admin.v2.Table\x12\x17\n\x0f\x64\x61ta_size_bytes\x18\x03 \x01(\x03\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x64\x65lete_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x37\n\x05state\x18\x06 \x01(\x0e\x32(.google.bigtable.admin.v2.Snapshot.State\x12\x13\n\x0b\x64\x65scription\x18\x07 \x01(\t"5\n\x05State\x12\x13\n\x0fSTATE_NOT_KNOWN\x10\x00\x12\t\n\x05READY\x10\x01\x12\x0c\n\x08\x43REATING\x10\x02\x42\xad\x01\n\x1c\x63om.google.bigtable.admin.v2B\nTableProtoP\x01Z=google.golang.org/genproto/googleapis/bigtable/admin/v2;admin\xaa\x02\x1eGoogle.Cloud.Bigtable.Admin.V2\xca\x02\x1eGoogle\\Cloud\\Bigtable\\Admin\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TABLE_CLUSTERSTATE_REPLICATIONSTATE = _descriptor.EnumDescriptor(
+    name="ReplicationState",
+    full_name="google.bigtable.admin.v2.Table.ClusterState.ReplicationState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_NOT_KNOWN",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INITIALIZING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLANNED_MAINTENANCE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNPLANNED_MAINTENANCE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=533,
+    serialized_end=653,
+)
+_sym_db.RegisterEnumDescriptor(_TABLE_CLUSTERSTATE_REPLICATIONSTATE)
+
+_TABLE_TIMESTAMPGRANULARITY = _descriptor.EnumDescriptor(
+    name="TimestampGranularity",
+    full_name="google.bigtable.admin.v2.Table.TimestampGranularity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TIMESTAMP_GRANULARITY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MILLIS", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=850,
+    serialized_end=923,
+)
+_sym_db.RegisterEnumDescriptor(_TABLE_TIMESTAMPGRANULARITY)
+
+_TABLE_VIEW = _descriptor.EnumDescriptor(
+    name="View",
+    full_name="google.bigtable.admin.v2.Table.View",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VIEW_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NAME_ONLY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCHEMA_VIEW", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPLICATION_VIEW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=925,
+    serialized_end=1017,
+)
+_sym_db.RegisterEnumDescriptor(_TABLE_VIEW)
+
+_SNAPSHOT_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.bigtable.admin.v2.Snapshot.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_NOT_KNOWN",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1713,
+    serialized_end=1766,
+)
+_sym_db.RegisterEnumDescriptor(_SNAPSHOT_STATE)
+
+
+_TABLE_CLUSTERSTATE = _descriptor.Descriptor(
+    name="ClusterState",
+    full_name="google.bigtable.admin.v2.Table.ClusterState",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="replication_state",
+            full_name="google.bigtable.admin.v2.Table.ClusterState.replication_state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TABLE_CLUSTERSTATE_REPLICATIONSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=427,
+    serialized_end=653,
+)
+
+_TABLE_CLUSTERSTATESENTRY = _descriptor.Descriptor(
+    name="ClusterStatesEntry",
+    full_name="google.bigtable.admin.v2.Table.ClusterStatesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.bigtable.admin.v2.Table.ClusterStatesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.admin.v2.Table.ClusterStatesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=655,
+    serialized_end=753,
+)
+
+_TABLE_COLUMNFAMILIESENTRY = _descriptor.Descriptor(
+    name="ColumnFamiliesEntry",
+    full_name="google.bigtable.admin.v2.Table.ColumnFamiliesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.bigtable.admin.v2.Table.ColumnFamiliesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.admin.v2.Table.ColumnFamiliesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=755,
+    serialized_end=848,
+)
+
+_TABLE = _descriptor.Descriptor(
+    name="Table",
+    full_name="google.bigtable.admin.v2.Table",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.Table.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_states",
+            full_name="google.bigtable.admin.v2.Table.cluster_states",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_families",
+            full_name="google.bigtable.admin.v2.Table.column_families",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="granularity",
+            full_name="google.bigtable.admin.v2.Table.granularity",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TABLE_CLUSTERSTATE,
+        _TABLE_CLUSTERSTATESENTRY,
+        _TABLE_COLUMNFAMILIESENTRY,
+    ],
+    enum_types=[_TABLE_TIMESTAMPGRANULARITY, _TABLE_VIEW],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=174,
+    serialized_end=1017,
+)
+
+
+_COLUMNFAMILY = _descriptor.Descriptor(
+    name="ColumnFamily",
+    full_name="google.bigtable.admin.v2.ColumnFamily",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gc_rule",
+            full_name="google.bigtable.admin.v2.ColumnFamily.gc_rule",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1019,
+    serialized_end=1084,
+)
+
+
+_GCRULE_INTERSECTION = _descriptor.Descriptor(
+    name="Intersection",
+    full_name="google.bigtable.admin.v2.GcRule.Intersection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="rules",
+            full_name="google.bigtable.admin.v2.GcRule.Intersection.rules",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1299,
+    serialized_end=1362,
+)
+
+_GCRULE_UNION = _descriptor.Descriptor(
+    name="Union",
+    full_name="google.bigtable.admin.v2.GcRule.Union",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="rules",
+            full_name="google.bigtable.admin.v2.GcRule.Union.rules",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1364,
+    serialized_end=1420,
+)
+
+_GCRULE = _descriptor.Descriptor(
+    name="GcRule",
+    full_name="google.bigtable.admin.v2.GcRule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_num_versions",
+            full_name="google.bigtable.admin.v2.GcRule.max_num_versions",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_age",
+            full_name="google.bigtable.admin.v2.GcRule.max_age",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="intersection",
+            full_name="google.bigtable.admin.v2.GcRule.intersection",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="union",
+            full_name="google.bigtable.admin.v2.GcRule.union",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GCRULE_INTERSECTION, _GCRULE_UNION],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="rule",
+            full_name="google.bigtable.admin.v2.GcRule.rule",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1087,
+    serialized_end=1428,
+)
+
+
+_SNAPSHOT = _descriptor.Descriptor(
+    name="Snapshot",
+    full_name="google.bigtable.admin.v2.Snapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.admin.v2.Snapshot.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_table",
+            full_name="google.bigtable.admin.v2.Snapshot.source_table",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_size_bytes",
+            full_name="google.bigtable.admin.v2.Snapshot.data_size_bytes",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.bigtable.admin.v2.Snapshot.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_time",
+            full_name="google.bigtable.admin.v2.Snapshot.delete_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.bigtable.admin.v2.Snapshot.state",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.bigtable.admin.v2.Snapshot.description",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SNAPSHOT_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1431,
+    serialized_end=1766,
+)
+
+_TABLE_CLUSTERSTATE.fields_by_name[
+    "replication_state"
+].enum_type = _TABLE_CLUSTERSTATE_REPLICATIONSTATE
+_TABLE_CLUSTERSTATE.containing_type = _TABLE
+_TABLE_CLUSTERSTATE_REPLICATIONSTATE.containing_type = _TABLE_CLUSTERSTATE
+_TABLE_CLUSTERSTATESENTRY.fields_by_name["value"].message_type = _TABLE_CLUSTERSTATE
+_TABLE_CLUSTERSTATESENTRY.containing_type = _TABLE
+_TABLE_COLUMNFAMILIESENTRY.fields_by_name["value"].message_type = _COLUMNFAMILY
+_TABLE_COLUMNFAMILIESENTRY.containing_type = _TABLE
+_TABLE.fields_by_name["cluster_states"].message_type = _TABLE_CLUSTERSTATESENTRY
+_TABLE.fields_by_name["column_families"].message_type = _TABLE_COLUMNFAMILIESENTRY
+_TABLE.fields_by_name["granularity"].enum_type = _TABLE_TIMESTAMPGRANULARITY
+_TABLE_TIMESTAMPGRANULARITY.containing_type = _TABLE
+_TABLE_VIEW.containing_type = _TABLE
+_COLUMNFAMILY.fields_by_name["gc_rule"].message_type = _GCRULE
+_GCRULE_INTERSECTION.fields_by_name["rules"].message_type = _GCRULE
+_GCRULE_INTERSECTION.containing_type = _GCRULE
+_GCRULE_UNION.fields_by_name["rules"].message_type = _GCRULE
+_GCRULE_UNION.containing_type = _GCRULE
+_GCRULE.fields_by_name[
+    "max_age"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_GCRULE.fields_by_name["intersection"].message_type = _GCRULE_INTERSECTION
+_GCRULE.fields_by_name["union"].message_type = _GCRULE_UNION
+_GCRULE.oneofs_by_name["rule"].fields.append(_GCRULE.fields_by_name["max_num_versions"])
+_GCRULE.fields_by_name["max_num_versions"].containing_oneof = _GCRULE.oneofs_by_name[
+    "rule"
+]
+_GCRULE.oneofs_by_name["rule"].fields.append(_GCRULE.fields_by_name["max_age"])
+_GCRULE.fields_by_name["max_age"].containing_oneof = _GCRULE.oneofs_by_name["rule"]
+_GCRULE.oneofs_by_name["rule"].fields.append(_GCRULE.fields_by_name["intersection"])
+_GCRULE.fields_by_name["intersection"].containing_oneof = _GCRULE.oneofs_by_name["rule"]
+_GCRULE.oneofs_by_name["rule"].fields.append(_GCRULE.fields_by_name["union"])
+_GCRULE.fields_by_name["union"].containing_oneof = _GCRULE.oneofs_by_name["rule"]
+_SNAPSHOT.fields_by_name["source_table"].message_type = _TABLE
+_SNAPSHOT.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SNAPSHOT.fields_by_name[
+    "delete_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SNAPSHOT.fields_by_name["state"].enum_type = _SNAPSHOT_STATE
+_SNAPSHOT_STATE.containing_type = _SNAPSHOT
+DESCRIPTOR.message_types_by_name["Table"] = _TABLE
+DESCRIPTOR.message_types_by_name["ColumnFamily"] = _COLUMNFAMILY
+DESCRIPTOR.message_types_by_name["GcRule"] = _GCRULE
+DESCRIPTOR.message_types_by_name["Snapshot"] = _SNAPSHOT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Table = _reflection.GeneratedProtocolMessageType(
+    "Table",
+    (_message.Message,),
+    dict(
+        ClusterState=_reflection.GeneratedProtocolMessageType(
+            "ClusterState",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TABLE_CLUSTERSTATE,
+                __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+                __doc__="""The state of a table's data in a particular cluster.
+    
+    
+    Attributes:
+        replication_state:
+            (``OutputOnly``) The state of replication for the table in
+            this cluster.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Table.ClusterState)
+            ),
+        ),
+        ClusterStatesEntry=_reflection.GeneratedProtocolMessageType(
+            "ClusterStatesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TABLE_CLUSTERSTATESENTRY,
+                __module__="google.cloud.bigtable.admin_v2.proto.table_pb2"
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Table.ClusterStatesEntry)
+            ),
+        ),
+        ColumnFamiliesEntry=_reflection.GeneratedProtocolMessageType(
+            "ColumnFamiliesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TABLE_COLUMNFAMILIESENTRY,
+                __module__="google.cloud.bigtable.admin_v2.proto.table_pb2"
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Table.ColumnFamiliesEntry)
+            ),
+        ),
+        DESCRIPTOR=_TABLE,
+        __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+        __doc__="""A collection of user data indexed by row, column, and timestamp. Each
+  table is served using the resources of its parent cluster.
+  
+  
+  Attributes:
+      name:
+          (``OutputOnly``) The unique name of the table. Values are of
+          the form ``projects/<project>/instances/<instance>/tables/[_a-
+          zA-Z0-9][-_.a-zA-Z0-9]*``. Views: ``NAME_ONLY``,
+          ``SCHEMA_VIEW``, ``REPLICATION_VIEW``, ``FULL``
+      cluster_states:
+          (``OutputOnly``) 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``. Views: ``REPLICATION_VIEW``,
+          ``FULL``
+      column_families:
+          (``CreationOnly``) The column families configured for this
+          table, mapped by column family ID. Views: ``SCHEMA_VIEW``,
+          ``FULL``
+      granularity:
+          (``CreationOnly``) 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``
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Table)
+    ),
+)
+_sym_db.RegisterMessage(Table)
+_sym_db.RegisterMessage(Table.ClusterState)
+_sym_db.RegisterMessage(Table.ClusterStatesEntry)
+_sym_db.RegisterMessage(Table.ColumnFamiliesEntry)
+
+ColumnFamily = _reflection.GeneratedProtocolMessageType(
+    "ColumnFamily",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLUMNFAMILY,
+        __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+        __doc__="""A set of columns within a table which share a common configuration.
+  
+  
+  Attributes:
+      gc_rule:
+          Garbage collection rule specified as a protobuf. Must
+          serialize to at most 500 bytes.  NOTE: Garbage collection
+          executes opportunistically in the background, and so it's
+          possible for reads to return a cell even if it matches the
+          active GC expression for its family.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ColumnFamily)
+    ),
+)
+_sym_db.RegisterMessage(ColumnFamily)
+
+GcRule = _reflection.GeneratedProtocolMessageType(
+    "GcRule",
+    (_message.Message,),
+    dict(
+        Intersection=_reflection.GeneratedProtocolMessageType(
+            "Intersection",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GCRULE_INTERSECTION,
+                __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+                __doc__="""A GcRule which deletes cells matching all of the given rules.
+    
+    
+    Attributes:
+        rules:
+            Only delete cells which would be deleted by every element of
+            ``rules``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GcRule.Intersection)
+            ),
+        ),
+        Union=_reflection.GeneratedProtocolMessageType(
+            "Union",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GCRULE_UNION,
+                __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+                __doc__="""A GcRule which deletes cells matching any of the given rules.
+    
+    
+    Attributes:
+        rules:
+            Delete cells which would be deleted by any element of
+            ``rules``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GcRule.Union)
+            ),
+        ),
+        DESCRIPTOR=_GCRULE,
+        __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+        __doc__="""Rule for determining which cells to delete during garbage collection.
+  
+  
+  Attributes:
+      rule:
+          Garbage collection rules.
+      max_num_versions:
+          Delete all cells in a column except the most recent N.
+      max_age:
+          Delete cells in a column older than the given age. Values must
+          be at least one millisecond, and will be truncated to
+          microsecond granularity.
+      intersection:
+          Delete cells that would be deleted by every nested rule.
+      union:
+          Delete cells that would be deleted by any nested rule.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GcRule)
+    ),
+)
+_sym_db.RegisterMessage(GcRule)
+_sym_db.RegisterMessage(GcRule.Intersection)
+_sym_db.RegisterMessage(GcRule.Union)
+
+Snapshot = _reflection.GeneratedProtocolMessageType(
+    "Snapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SNAPSHOT,
+        __module__="google.cloud.bigtable.admin_v2.proto.table_pb2",
+        __doc__="""A snapshot of a table at a particular time. A snapshot can be used as a
+  checkpoint for data restoration or a data source for a new table.
+  
+  Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  feature is not currently available to most Cloud Bigtable customers.
+  This 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.
+  
+  
+  Attributes:
+      name:
+          (``OutputOnly``) The unique name of the snapshot. Values are
+          of the form ``projects/<project>/instances/<instance>/clusters
+          /<cluster>/snapshots/<snapshot>``.
+      source_table:
+          (``OutputOnly``) The source table at the time the snapshot was
+          taken.
+      data_size_bytes:
+          (``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.
+      create_time:
+          (``OutputOnly``) The time when the snapshot is created.
+      delete_time:
+          (``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, the default maximum of 365
+          days will be used.
+      state:
+          (``OutputOnly``) The current state of the snapshot.
+      description:
+          (``OutputOnly``) Description of the snapshot.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Snapshot)
+    ),
+)
+_sym_db.RegisterMessage(Snapshot)
+
+
+DESCRIPTOR._options = None
+_TABLE_CLUSTERSTATESENTRY._options = None
+_TABLE_COLUMNFAMILIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_admin_v2/proto/table_pb2_grpc.py b/bigtable/google/cloud/bigtable_admin_v2/proto/table_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/proto/table_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigtable/google/cloud/bigtable_admin_v2/types.py b/bigtable/google/cloud/bigtable_admin_v2/types.py
new file mode 100644
index 000000000000..eb2d919856e8
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_admin_v2/types.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import bigtable_table_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import instance_pb2
+from google.cloud.bigtable_admin_v2.proto import table_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    operations_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [
+    bigtable_instance_admin_pb2,
+    bigtable_table_admin_pb2,
+    instance_pb2,
+    table_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.bigtable_admin_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/bigtable/google/cloud/bigtable_v2/__init__.py b/bigtable/google/cloud/bigtable_v2/__init__.py
new file mode 100644
index 000000000000..ca18668ce49b
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/__init__.py
@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.bigtable_v2 import types
+from google.cloud.bigtable_v2.gapic import bigtable_client
+
+
+class BigtableClient(bigtable_client.BigtableClient):
+    __doc__ = bigtable_client.BigtableClient.__doc__
+
+
+__all__ = ("types", "BigtableClient")
diff --git a/bigtable/google/cloud/bigtable_v2/gapic/__init__.py b/bigtable/google/cloud/bigtable_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/google/cloud/bigtable_v2/gapic/bigtable_client.py b/bigtable/google/cloud/bigtable_v2/gapic/bigtable_client.py
new file mode 100644
index 000000000000..36021068dfd8
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/gapic/bigtable_client.py
@@ -0,0 +1,767 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.bigtable.v2 Bigtable API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.bigtable_v2.gapic import bigtable_client_config
+from google.cloud.bigtable_v2.gapic.transports import bigtable_grpc_transport
+from google.cloud.bigtable_v2.proto import bigtable_pb2
+from google.cloud.bigtable_v2.proto import bigtable_pb2_grpc
+from google.cloud.bigtable_v2.proto import data_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-bigtable").version
+
+
+class BigtableClient(object):
+    """Service for reading from and writing to existing Bigtable tables."""
+
+    SERVICE_ADDRESS = "bigtable.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.bigtable.v2.Bigtable"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            BigtableClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def table_path(cls, project, instance, table):
+        """Return a fully-qualified table string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/tables/{table}",
+            project=project,
+            instance=instance,
+            table=table,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.BigtableGrpcTransport,
+                    Callable[[~.Credentials, type], ~.BigtableGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = bigtable_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=bigtable_grpc_transport.BigtableGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = bigtable_grpc_transport.BigtableGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def read_rows(
+        self,
+        table_name,
+        app_profile_id=None,
+        rows=None,
+        filter_=None,
+        rows_limit=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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
+        atomicity of each row will still be preserved. See the
+        ReadRowsResponse documentation for details.
+
+        Example:
+            >>> from google.cloud import bigtable_v2
+            >>>
+            >>> client = bigtable_v2.BigtableClient()
+            >>>
+            >>> table_name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> for element in client.read_rows(table_name):
+            ...     # process element
+            ...     pass
+
+        Args:
+            table_name (str): The unique name of the table from which to read. Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            app_profile_id (str): This value specifies routing for replication. If not specified, the
+                "default" application profile will be used.
+            rows (Union[dict, ~google.cloud.bigtable_v2.types.RowSet]): The row keys and/or ranges to read. If not specified, reads from all rows.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.RowSet`
+            filter_ (Union[dict, ~google.cloud.bigtable_v2.types.RowFilter]): The filter to apply to the contents of the specified row(s). If unset,
+                reads the entirety of each row.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.RowFilter`
+            rows_limit (long): The read will terminate after committing to N rows' worth of results. The
+                default (zero) is to return all results.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.bigtable_v2.types.ReadRowsResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "read_rows" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "read_rows"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.read_rows,
+                default_retry=self._method_configs["ReadRows"].retry,
+                default_timeout=self._method_configs["ReadRows"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_pb2.ReadRowsRequest(
+            table_name=table_name,
+            app_profile_id=app_profile_id,
+            rows=rows,
+            filter=filter_,
+            rows_limit=rows_limit,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_name", table_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["read_rows"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def sample_row_keys(
+        self,
+        table_name,
+        app_profile_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_v2
+            >>>
+            >>> client = bigtable_v2.BigtableClient()
+            >>>
+            >>> table_name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> for element in client.sample_row_keys(table_name):
+            ...     # process element
+            ...     pass
+
+        Args:
+            table_name (str): The unique name of the table from which to sample row keys. Values are
+                of the form ``projects/<project>/instances/<instance>/tables/<table>``.
+            app_profile_id (str): This value specifies routing for replication. If not specified, the
+                "default" application profile will be used.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.bigtable_v2.types.SampleRowKeysResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "sample_row_keys" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "sample_row_keys"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.sample_row_keys,
+                default_retry=self._method_configs["SampleRowKeys"].retry,
+                default_timeout=self._method_configs["SampleRowKeys"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_pb2.SampleRowKeysRequest(
+            table_name=table_name, app_profile_id=app_profile_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_name", table_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["sample_row_keys"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def mutate_row(
+        self,
+        table_name,
+        row_key,
+        mutations,
+        app_profile_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Mutates a row atomically. Cells already present in the row are left
+        unchanged unless explicitly changed by ``mutation``.
+
+        Example:
+            >>> from google.cloud import bigtable_v2
+            >>>
+            >>> client = bigtable_v2.BigtableClient()
+            >>>
+            >>> table_name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `row_key`:
+            >>> row_key = b''
+            >>>
+            >>> # TODO: Initialize `mutations`:
+            >>> mutations = []
+            >>>
+            >>> response = client.mutate_row(table_name, row_key, mutations)
+
+        Args:
+            table_name (str): The unique name of the table to which the mutation should be applied.
+                Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            row_key (bytes): The key of the row to which the mutation should be applied.
+            mutations (list[Union[dict, ~google.cloud.bigtable_v2.types.Mutation]]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.Mutation`
+            app_profile_id (str): This value specifies routing for replication. If not specified, the
+                "default" application profile will be used.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_v2.types.MutateRowResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "mutate_row" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "mutate_row"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.mutate_row,
+                default_retry=self._method_configs["MutateRow"].retry,
+                default_timeout=self._method_configs["MutateRow"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_pb2.MutateRowRequest(
+            table_name=table_name,
+            row_key=row_key,
+            mutations=mutations,
+            app_profile_id=app_profile_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_name", table_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["mutate_row"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def mutate_rows(
+        self,
+        table_name,
+        entries,
+        app_profile_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Mutates multiple rows in a batch. Each individual row is mutated
+        atomically as in MutateRow, but the entire batch is not executed
+        atomically.
+
+        Example:
+            >>> from google.cloud import bigtable_v2
+            >>>
+            >>> client = bigtable_v2.BigtableClient()
+            >>>
+            >>> table_name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `entries`:
+            >>> entries = []
+            >>>
+            >>> for element in client.mutate_rows(table_name, entries):
+            ...     # process element
+            ...     pass
+
+        Args:
+            table_name (str): The unique name of the table to which the mutations should be applied.
+            entries (list[Union[dict, ~google.cloud.bigtable_v2.types.Entry]]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.Entry`
+            app_profile_id (str): This value specifies routing for replication. If not specified, the
+                "default" application profile will be used.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.bigtable_v2.types.MutateRowsResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "mutate_rows" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "mutate_rows"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.mutate_rows,
+                default_retry=self._method_configs["MutateRows"].retry,
+                default_timeout=self._method_configs["MutateRows"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_pb2.MutateRowsRequest(
+            table_name=table_name, entries=entries, app_profile_id=app_profile_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_name", table_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["mutate_rows"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def check_and_mutate_row(
+        self,
+        table_name,
+        row_key,
+        app_profile_id=None,
+        predicate_filter=None,
+        true_mutations=None,
+        false_mutations=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Mutates a row atomically based on the output of a predicate Reader filter.
+
+        Example:
+            >>> from google.cloud import bigtable_v2
+            >>>
+            >>> client = bigtable_v2.BigtableClient()
+            >>>
+            >>> table_name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `row_key`:
+            >>> row_key = b''
+            >>>
+            >>> response = client.check_and_mutate_row(table_name, row_key)
+
+        Args:
+            table_name (str): The unique name of the table to which the conditional mutation should be
+                applied. Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            row_key (bytes): The key of the row to which the conditional mutation should be applied.
+            app_profile_id (str): This value specifies routing for replication. If not specified, the
+                "default" application profile will be used.
+            predicate_filter (Union[dict, ~google.cloud.bigtable_v2.types.RowFilter]): 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
+                ``false_mutations`` will be executed. If unset, checks that the row
+                contains any values at all.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.RowFilter`
+            true_mutations (list[Union[dict, ~google.cloud.bigtable_v2.types.Mutation]]): Changes to be atomically applied to the specified row if
+                ``predicate_filter`` yields at least one cell when applied to
+                ``row_key``. Entries are applied in order, meaning that earlier
+                mutations can be masked by later ones. Must contain at least one entry
+                if ``false_mutations`` is empty, and at most 100000.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.Mutation`
+            false_mutations (list[Union[dict, ~google.cloud.bigtable_v2.types.Mutation]]): Changes to be atomically applied to the specified row if
+                ``predicate_filter`` does not yield any cells when applied to
+                ``row_key``. Entries are applied in order, meaning that earlier
+                mutations can be masked by later ones. Must contain at least one entry
+                if ``true_mutations`` is empty, and at most 100000.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.Mutation`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_v2.types.CheckAndMutateRowResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "check_and_mutate_row" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "check_and_mutate_row"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.check_and_mutate_row,
+                default_retry=self._method_configs["CheckAndMutateRow"].retry,
+                default_timeout=self._method_configs["CheckAndMutateRow"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_pb2.CheckAndMutateRowRequest(
+            table_name=table_name,
+            row_key=row_key,
+            app_profile_id=app_profile_id,
+            predicate_filter=predicate_filter,
+            true_mutations=true_mutations,
+            false_mutations=false_mutations,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_name", table_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["check_and_mutate_row"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def read_modify_write_row(
+        self,
+        table_name,
+        row_key,
+        rules,
+        app_profile_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Modifies a row atomically on the server. The method reads the latest
+        existing timestamp and value from the specified columns and writes a new
+        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.
+
+        Example:
+            >>> from google.cloud import bigtable_v2
+            >>>
+            >>> client = bigtable_v2.BigtableClient()
+            >>>
+            >>> table_name = client.table_path('[PROJECT]', '[INSTANCE]', '[TABLE]')
+            >>>
+            >>> # TODO: Initialize `row_key`:
+            >>> row_key = b''
+            >>>
+            >>> # TODO: Initialize `rules`:
+            >>> rules = []
+            >>>
+            >>> response = client.read_modify_write_row(table_name, row_key, rules)
+
+        Args:
+            table_name (str): The unique name of the table to which the read/modify/write rules should
+                be applied. Values are of the form
+                ``projects/<project>/instances/<instance>/tables/<table>``.
+            row_key (bytes): The key of the row to which the read/modify/write rules should be applied.
+            rules (list[Union[dict, ~google.cloud.bigtable_v2.types.ReadModifyWriteRule]]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.bigtable_v2.types.ReadModifyWriteRule`
+            app_profile_id (str): This value specifies routing for replication. If not specified, the
+                "default" application profile will be used.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.bigtable_v2.types.ReadModifyWriteRowResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "read_modify_write_row" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "read_modify_write_row"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.read_modify_write_row,
+                default_retry=self._method_configs["ReadModifyWriteRow"].retry,
+                default_timeout=self._method_configs["ReadModifyWriteRow"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = bigtable_pb2.ReadModifyWriteRowRequest(
+            table_name=table_name,
+            row_key=row_key,
+            rules=rules,
+            app_profile_id=app_profile_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("table_name", table_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["read_modify_write_row"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/bigtable/google/cloud/bigtable_v2/gapic/bigtable_client_config.py b/bigtable/google/cloud/bigtable_v2/gapic/bigtable_client_config.py
new file mode 100644
index 000000000000..3096f33e0c68
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/gapic/bigtable_client_config.py
@@ -0,0 +1,80 @@
+config = {
+    "interfaces": {
+        "google.bigtable.v2.Bigtable": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "idempotent_params": {
+                    "initial_retry_delay_millis": 10,
+                    "retry_delay_multiplier": 2.0,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 20000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+                "non_idempotent_params": {
+                    "initial_retry_delay_millis": 10,
+                    "retry_delay_multiplier": 2.0,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 20000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 20000,
+                },
+                "read_rows_params": {
+                    "initial_retry_delay_millis": 10,
+                    "retry_delay_multiplier": 2.0,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 300000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 300000,
+                    "total_timeout_millis": 43200000,
+                },
+                "mutate_rows_params": {
+                    "initial_retry_delay_millis": 10,
+                    "retry_delay_multiplier": 2.0,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 60000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "ReadRows": {
+                    "timeout_millis": 43200000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "read_rows_params",
+                },
+                "SampleRowKeys": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "MutateRow": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "idempotent_params",
+                },
+                "MutateRows": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "mutate_rows_params",
+                },
+                "CheckAndMutateRow": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+                "ReadModifyWriteRow": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "non_idempotent_params",
+                },
+            },
+        }
+    }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/gapic/transports/__init__.py b/bigtable/google/cloud/bigtable_v2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/google/cloud/bigtable_v2/gapic/transports/bigtable_grpc_transport.py b/bigtable/google/cloud/bigtable_v2/gapic/transports/bigtable_grpc_transport.py
new file mode 100644
index 000000000000..4c34d5fb1b39
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/gapic/transports/bigtable_grpc_transport.py
@@ -0,0 +1,205 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.bigtable_v2.proto import bigtable_pb2_grpc
+
+
+class BigtableGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.bigtable.v2 Bigtable API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="bigtable.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"bigtable_stub": bigtable_pb2_grpc.BigtableStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="bigtable.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def read_rows(self):
+        """Return the gRPC stub for :meth:`BigtableClient.read_rows`.
+
+        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
+        atomicity of each row will still be preserved. See the
+        ReadRowsResponse documentation for details.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_stub"].ReadRows
+
+    @property
+    def sample_row_keys(self):
+        """Return the gRPC stub for :meth:`BigtableClient.sample_row_keys`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_stub"].SampleRowKeys
+
+    @property
+    def mutate_row(self):
+        """Return the gRPC stub for :meth:`BigtableClient.mutate_row`.
+
+        Mutates a row atomically. Cells already present in the row are left
+        unchanged unless explicitly changed by ``mutation``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_stub"].MutateRow
+
+    @property
+    def mutate_rows(self):
+        """Return the gRPC stub for :meth:`BigtableClient.mutate_rows`.
+
+        Mutates multiple rows in a batch. Each individual row is mutated
+        atomically as in MutateRow, but the entire batch is not executed
+        atomically.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_stub"].MutateRows
+
+    @property
+    def check_and_mutate_row(self):
+        """Return the gRPC stub for :meth:`BigtableClient.check_and_mutate_row`.
+
+        Mutates a row atomically based on the output of a predicate Reader filter.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_stub"].CheckAndMutateRow
+
+    @property
+    def read_modify_write_row(self):
+        """Return the gRPC stub for :meth:`BigtableClient.read_modify_write_row`.
+
+        Modifies a row atomically on the server. The method reads the latest
+        existing timestamp and value from the specified columns and writes a new
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["bigtable_stub"].ReadModifyWriteRow
diff --git a/bigtable/google/cloud/bigtable_v2/proto/__init__.py b/bigtable/google/cloud/bigtable_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable.proto
new file mode 100644
index 000000000000..0ab763ba6e62
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable.proto
@@ -0,0 +1,365 @@
+// 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.bigtable.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/v2/data.proto";
+import "google/protobuf/wrappers.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/v2;bigtable";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableProto";
+option java_package = "com.google.bigtable.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\V2";
+
+// Service for reading from and writing to existing Bigtable tables.
+service Bigtable {
+  // 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
+  // atomicity of each row will still be preserved. See the
+  // ReadRowsResponse documentation for details.
+  rpc ReadRows(ReadRowsRequest) returns (stream ReadRowsResponse) {
+    option (google.api.http) = {
+      post: "/v2/{table_name=projects/*/instances/*/tables/*}:readRows"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      get: "/v2/{table_name=projects/*/instances/*/tables/*}:sampleRowKeys"
+    };
+  }
+
+  // Mutates a row atomically. Cells already present in the row are left
+  // unchanged unless explicitly changed by `mutation`.
+  rpc MutateRow(MutateRowRequest) returns (MutateRowResponse) {
+    option (google.api.http) = {
+      post: "/v2/{table_name=projects/*/instances/*/tables/*}:mutateRow"
+      body: "*"
+    };
+  }
+
+  // Mutates multiple rows in a batch. Each individual row is mutated
+  // atomically as in MutateRow, but the entire batch is not executed
+  // atomically.
+  rpc MutateRows(MutateRowsRequest) returns (stream MutateRowsResponse) {
+    option (google.api.http) = {
+      post: "/v2/{table_name=projects/*/instances/*/tables/*}:mutateRows"
+      body: "*"
+    };
+  }
+
+  // Mutates a row atomically based on the output of a predicate Reader filter.
+  rpc CheckAndMutateRow(CheckAndMutateRowRequest)
+      returns (CheckAndMutateRowResponse) {
+    option (google.api.http) = {
+      post: "/v2/{table_name=projects/*/instances/*/tables/*}:checkAndMutateRow"
+      body: "*"
+    };
+  }
+
+  // Modifies a row atomically on the server. The method reads the latest
+  // existing timestamp and value from the specified columns and writes a new
+  // 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) {
+    option (google.api.http) = {
+      post: "/v2/{table_name=projects/*/instances/*/tables/*}:readModifyWriteRow"
+      body: "*"
+    };
+  }
+}
+
+// Request message for Bigtable.ReadRows.
+message ReadRowsRequest {
+  // The unique name of the table from which to read.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string table_name = 1;
+
+  // This value specifies routing for replication. If not specified, the
+  // "default" application profile will be used.
+  string app_profile_id = 5;
+
+  // The row keys and/or ranges to read. If not specified, reads from all rows.
+  RowSet rows = 2;
+
+  // The filter to apply to the contents of the specified row(s). If unset,
+  // reads the entirety of each row.
+  RowFilter filter = 3;
+
+  // The read will terminate after committing to N rows' worth of results. The
+  // default (zero) is to return all results.
+  int64 rows_limit = 4;
+}
+
+// Response message for Bigtable.ReadRows.
+message ReadRowsResponse {
+  // Specifies a piece of a row's contents returned as part of the read
+  // response stream.
+  message CellChunk {
+    // The row key for this chunk of data.  If the row key is empty,
+    // this CellChunk is a continuation of the same row as the previous
+    // CellChunk in the response stream, even if that CellChunk was in a
+    // previous ReadRowsResponse message.
+    bytes row_key = 1;
+
+    // The column family name for this chunk of data.  If this message
+    // is not present this CellChunk is a continuation of the same column
+    // family as the previous CellChunk.  The empty string can occur as a
+    // column family name in a response so clients must check
+    // explicitly for the presence of this message, not just for
+    // `family_name.value` being non-empty.
+    google.protobuf.StringValue family_name = 2;
+
+    // The column qualifier for this chunk of data.  If this message
+    // is not present, this CellChunk is a continuation of the same column
+    // as the previous CellChunk.  Column qualifiers may be empty so
+    // clients must check for the presence of this message, not just
+    // for `qualifier.value` being non-empty.
+    google.protobuf.BytesValue qualifier = 3;
+
+    // The cell's stored timestamp, which also uniquely identifies it
+    // within its column.  Values are always expressed in
+    // microseconds, but individual tables may set a coarser
+    // granularity to further restrict the allowed values. For
+    // example, a table which specifies millisecond granularity will
+    // only allow values of `timestamp_micros` which are multiples of
+    // 1000.  Timestamps are only set in the first CellChunk per cell
+    // (for cells split into multiple chunks).
+    int64 timestamp_micros = 4;
+
+    // Labels applied to the cell by a
+    // [RowFilter][google.bigtable.v2.RowFilter].  Labels are only set
+    // on the first CellChunk per cell.
+    repeated string labels = 5;
+
+    // The value stored in the cell.  Cell values can be split across
+    // multiple CellChunks.  In that case only the value field will be
+    // set in CellChunks after the first: the timestamp and labels
+    // will only be present in the first CellChunk, even if the first
+    // CellChunk came in a previous ReadRowsResponse.
+    bytes value = 6;
+
+    // If this CellChunk is part of a chunked cell value and this is
+    // not the final chunk of that cell, value_size will be set to the
+    // total length of the cell value.  The client can use this size
+    // to pre-allocate memory to hold the full cell value.
+    int32 value_size = 7;
+
+    oneof row_status {
+      // Indicates that the client should drop all previous chunks for
+      // `row_key`, as it will be re-read from the beginning.
+      bool reset_row = 8;
+
+      // Indicates that the client can safely process all previous chunks for
+      // `row_key`, as its data has been fully read.
+      bool commit_row = 9;
+    }
+  }
+
+  repeated CellChunk chunks = 1;
+
+  // Optionally the server might return the row key of the last row it
+  // has scanned.  The client can use this to construct a more
+  // efficient retry request if needed: any row keys or portions of
+  // ranges less than this row key can be dropped from the request.
+  // This is primarily useful for cases where the server has read a
+  // lot of data that was filtered out since the last committed row
+  // key, allowing the client to skip that work on a retry.
+  bytes last_scanned_row_key = 2;
+}
+
+// Request message for Bigtable.SampleRowKeys.
+message SampleRowKeysRequest {
+  // The unique name of the table from which to sample row keys.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string table_name = 1;
+
+  // This value specifies routing for replication. If not specified, the
+  // "default" application profile will be used.
+  string app_profile_id = 2;
+}
+
+// Response message for Bigtable.SampleRowKeys.
+message SampleRowKeysResponse {
+  // Sorted streamed sequence of sample row keys in the table. The table might
+  // have contents before the first row key in the list and after the last one,
+  // but a key containing the empty string indicates "end of table" and will be
+  // the last response given, if present.
+  // Note that row keys in this list may not have ever been written to or read
+  // from, and users should therefore not make any assumptions about the row key
+  // structure that are specific to their use case.
+  bytes row_key = 1;
+
+  // Approximate total storage space used by all rows in the table which precede
+  // `row_key`. Buffering the contents of all rows between two subsequent
+  // samples would require space roughly equal to the difference in their
+  // `offset_bytes` fields.
+  int64 offset_bytes = 2;
+}
+
+// Request message for Bigtable.MutateRow.
+message MutateRowRequest {
+  // The unique name of the table to which the mutation should be applied.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string table_name = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Response message for Bigtable.MutateRow.
+message MutateRowResponse {}
+
+// Request message for BigtableService.MutateRows.
+message MutateRowsRequest {
+  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
+    // applied in order, meaning that earlier mutations can be masked by
+    // later ones.
+    // You must specify at least one mutation.
+    repeated Mutation mutations = 2;
+  }
+
+  // The unique name of the table to which the mutations should be applied.
+  string table_name = 1;
+
+  // 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.
+  // 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;
+}
+
+// Response message for BigtableService.MutateRows.
+message MutateRowsResponse {
+  message Entry {
+    // The index into the original request's `entries` list of the Entry
+    // for which a result is being reported.
+    int64 index = 1;
+
+    // The result of the request Entry identified by `index`.
+    // Depending on how requests are batched during execution, it is possible
+    // for one Entry to fail due to an error with another Entry. In the event
+    // that this occurs, the same error will be reported for both entries.
+    google.rpc.Status status = 2;
+  }
+
+  // One or more results for Entries from the batch request.
+  repeated Entry entries = 1;
+}
+
+// Request message for Bigtable.CheckAndMutateRow.
+message CheckAndMutateRowRequest {
+  // The unique name of the table to which the conditional mutation should be
+  // applied.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string table_name = 1;
+
+  // 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;
+
+  // 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
+  // `false_mutations` will be executed. If unset, checks that the row contains
+  // any values at all.
+  RowFilter predicate_filter = 6;
+
+  // Changes to be atomically applied to the specified row if `predicate_filter`
+  // yields at least one cell when applied to `row_key`. Entries are applied in
+  // order, meaning that earlier mutations can be masked by later ones.
+  // Must contain at least one entry if `false_mutations` is empty, and at most
+  // 100000.
+  repeated Mutation true_mutations = 4;
+
+  // Changes to be atomically applied to the specified row if `predicate_filter`
+  // does not yield any cells when applied to `row_key`. Entries are applied in
+  // order, meaning that earlier mutations can be masked by later ones.
+  // Must contain at least one entry if `true_mutations` is empty, and at most
+  // 100000.
+  repeated Mutation false_mutations = 5;
+}
+
+// Response message for Bigtable.CheckAndMutateRow.
+message CheckAndMutateRowResponse {
+  // Whether or not the request's `predicate_filter` yielded any results for
+  // the specified row.
+  bool predicate_matched = 1;
+}
+
+// Request message for Bigtable.ReadModifyWriteRow.
+message ReadModifyWriteRowRequest {
+  // The unique name of the table to which the read/modify/write rules should be
+  // applied.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string table_name = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Response message for Bigtable.ReadModifyWriteRow.
+message ReadModifyWriteRowResponse {
+  // A Row containing the new contents of all cells modified by the request.
+  Row row = 1;
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_data.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_data.proto
new file mode 100644
index 000000000000..ca3b663d8661
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_data.proto
@@ -0,0 +1,94 @@
+// 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.bigtable.admin.cluster.v1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/cluster/v1;cluster";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableClusterDataProto";
+option java_package = "com.google.bigtable.admin.cluster.v1";
+
+
+// A physical location in which a particular project can allocate Cloud BigTable
+// resources.
+message Zone {
+  // Possible states of a zone.
+  enum Status {
+    // The state of the zone is unknown or unspecified.
+    UNKNOWN = 0;
+
+    // The zone is in a good state.
+    OK = 1;
+
+    // The zone is down for planned maintenance.
+    PLANNED_MAINTENANCE = 2;
+
+    // The zone is down for emergency or unplanned maintenance.
+    EMERGENCY_MAINENANCE = 3;
+  }
+
+  // A permanent unique identifier for the zone.
+  // Values are of the form projects/<project>/zones/[a-z][-a-z0-9]*
+  string name = 1;
+
+  // The name of this zone as it appears in UIs.
+  string display_name = 2;
+
+  // The current state of this zone.
+  Status status = 3;
+}
+
+// An isolated set of Cloud BigTable resources on which tables can be hosted.
+message Cluster {
+  // A permanent unique identifier for the cluster. For technical reasons, the
+  // zone in which the cluster resides is included here.
+  // Values are of the form
+  // projects/<project>/zones/<zone>/clusters/[a-z][-a-z0-9]*
+  string name = 1;
+
+  // The operation currently running on the cluster, if any.
+  // This cannot be set directly, only through CreateCluster, UpdateCluster,
+  // or UndeleteCluster. Calls to these methods will be rejected if
+  // "current_operation" is already set.
+  google.longrunning.Operation current_operation = 3;
+
+  // The descriptive name for this cluster as it appears in UIs.
+  // Must be unique per zone.
+  string display_name = 4;
+
+  // The number of serve nodes allocated to this cluster.
+  int32 serve_nodes = 5;
+
+  // What storage type to use for tables in this cluster. Only configurable at
+  // cluster creation time. If unspecified, STORAGE_SSD will be used.
+  StorageType default_storage_type = 8;
+}
+
+enum StorageType {
+  // The storage type used is unspecified.
+  STORAGE_UNSPECIFIED = 0;
+
+  // Data will be stored in SSD, providing low and consistent latencies.
+  STORAGE_SSD = 1;
+
+  // Data will be stored in HDD, providing high and less predictable
+  // latencies.
+  STORAGE_HDD = 2;
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_service.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_service.proto
new file mode 100644
index 000000000000..038fcc46397f
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_service.proto
@@ -0,0 +1,130 @@
+// 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.bigtable.admin.cluster.v1;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/cluster/v1/bigtable_cluster_data.proto";
+import "google/bigtable/admin/cluster/v1/bigtable_cluster_service_messages.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/cluster/v1;cluster";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableClusterServicesProto";
+option java_package = "com.google.bigtable.admin.cluster.v1";
+
+
+// Service for managing zonal Cloud Bigtable resources.
+service BigtableClusterService {
+  // Lists the supported zones for the given project.
+  rpc ListZones(ListZonesRequest) returns (ListZonesResponse) {
+    option (google.api.http) = { get: "/v1/{name=projects/*}/zones" };
+  }
+
+  // Gets information about a particular cluster.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = { get: "/v1/{name=projects/*/zones/*/clusters/*}" };
+  }
+
+  // Lists all clusters in the given project, along with any zones for which
+  // cluster information could not be retrieved.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = { get: "/v1/{name=projects/*}/aggregated/clusters" };
+  }
+
+  // Creates a cluster and begins preparing it to begin serving. The returned
+  // cluster embeds as its "current_operation" a long-running operation which
+  // can be used to track the progress of turning up the new cluster.
+  // Immediately upon completion of this request:
+  //  * The cluster will be readable via the API, with all requested attributes
+  //    but no allocated resources.
+  // Until completion of the embedded operation:
+  //  * Cancelling the operation will render the cluster immediately unreadable
+  //    via the API.
+  //  * All other attempts to modify or delete the cluster will be rejected.
+  // Upon completion of the embedded operation:
+  //  * Billing for all successfully-allocated resources will begin (some types
+  //    may have lower than the requested levels).
+  //  * New tables can be created in the cluster.
+  //  * The cluster's allocated resource levels will be readable via the API.
+  // The embedded operation's "metadata" field type is
+  // [CreateClusterMetadata][google.bigtable.admin.cluster.v1.CreateClusterMetadata] The embedded operation's "response" field type is
+  // [Cluster][google.bigtable.admin.cluster.v1.Cluster], if successful.
+  rpc CreateCluster(CreateClusterRequest) returns (Cluster) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*}/clusters" body: "*" };
+  }
+
+  // Updates a cluster, and begins allocating or releasing resources as
+  // requested. The returned cluster embeds as its "current_operation" a
+  // long-running operation which can be used to track the progress of updating
+  // the cluster.
+  // Immediately upon completion of this request:
+  //  * For resource types where a decrease in the cluster's allocation has been
+  //    requested, billing will be based on the newly-requested level.
+  // Until completion of the embedded operation:
+  //  * Cancelling the operation will set its metadata's "cancelled_at_time",
+  //    and begin restoring resources to their pre-request values. The operation
+  //    is guaranteed to succeed at undoing all resource changes, after which
+  //    point it will terminate with a CANCELLED status.
+  //  * All other attempts to modify or delete the cluster will be rejected.
+  //  * Reading the cluster via the API will continue to give the pre-request
+  //    resource levels.
+  // Upon completion of the embedded operation:
+  //  * Billing will begin for all successfully-allocated resources (some types
+  //    may have lower than the requested levels).
+  //  * All newly-reserved resources will be available for serving the cluster's
+  //    tables.
+  //  * The cluster's new resource levels will be readable via the API.
+  // [UpdateClusterMetadata][google.bigtable.admin.cluster.v1.UpdateClusterMetadata] The embedded operation's "response" field type is
+  // [Cluster][google.bigtable.admin.cluster.v1.Cluster], if successful.
+  rpc UpdateCluster(Cluster) returns (Cluster) {
+    option (google.api.http) = { put: "/v1/{name=projects/*/zones/*/clusters/*}" body: "*" };
+  }
+
+  // Marks a cluster and all of its tables for permanent deletion in 7 days.
+  // Immediately upon completion of the request:
+  //  * Billing will cease for all of the cluster's reserved resources.
+  //  * The cluster's "delete_time" field will be set 7 days in the future.
+  // Soon afterward:
+  //  * All tables within the cluster will become unavailable.
+  // Prior to the cluster's "delete_time":
+  //  * The cluster can be recovered with a call to UndeleteCluster.
+  //  * All other attempts to modify or delete the cluster will be rejected.
+  // At the cluster's "delete_time":
+  //  * The cluster and *all of its tables* will immediately and irrevocably
+  //    disappear from the API, and their data will be permanently deleted.
+  rpc DeleteCluster(DeleteClusterRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v1/{name=projects/*/zones/*/clusters/*}" };
+  }
+
+  // Cancels the scheduled deletion of an cluster and begins preparing it to
+  // resume serving. The returned operation will also be embedded as the
+  // cluster's "current_operation".
+  // Immediately upon completion of this request:
+  //  * The cluster's "delete_time" field will be unset, protecting it from
+  //    automatic deletion.
+  // Until completion of the returned operation:
+  //  * The operation cannot be cancelled.
+  // Upon completion of the returned operation:
+  //  * Billing for the cluster's resources will resume.
+  //  * All tables within the cluster will be available.
+  // [UndeleteClusterMetadata][google.bigtable.admin.cluster.v1.UndeleteClusterMetadata] The embedded operation's "response" field type is
+  // [Cluster][google.bigtable.admin.cluster.v1.Cluster], if successful.
+  rpc UndeleteCluster(UndeleteClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*}:undelete" body: "" };
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_service_messages.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_service_messages.proto
new file mode 100644
index 000000000000..518d14dac8e0
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_cluster_service_messages.proto
@@ -0,0 +1,141 @@
+// 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.bigtable.admin.cluster.v1;
+
+import "google/bigtable/admin/cluster/v1/bigtable_cluster_data.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/cluster/v1;cluster";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableClusterServiceMessagesProto";
+option java_package = "com.google.bigtable.admin.cluster.v1";
+
+
+// Request message for BigtableClusterService.ListZones.
+message ListZonesRequest {
+  // The unique name of the project for which a list of supported zones is
+  // requested.
+  // Values are of the form projects/<project>
+  string name = 1;
+}
+
+// Response message for BigtableClusterService.ListZones.
+message ListZonesResponse {
+  // The list of requested zones.
+  repeated Zone zones = 1;
+}
+
+// Request message for BigtableClusterService.GetCluster.
+message GetClusterRequest {
+  // The unique name of the requested cluster.
+  // Values are of the form projects/<project>/zones/<zone>/clusters/<cluster>
+  string name = 1;
+}
+
+// Request message for BigtableClusterService.ListClusters.
+message ListClustersRequest {
+  // The unique name of the project for which a list of clusters is requested.
+  // Values are of the form projects/<project>
+  string name = 1;
+}
+
+// Response message for BigtableClusterService.ListClusters.
+message ListClustersResponse {
+  // The list of requested Clusters.
+  repeated Cluster clusters = 1;
+
+  // The zones for which clusters could not be retrieved.
+  repeated Zone failed_zones = 2;
+}
+
+// Request message for BigtableClusterService.CreateCluster.
+message CreateClusterRequest {
+  // The unique name of the zone in which to create the cluster.
+  // Values are of the form projects/<project>/zones/<zone>
+  string name = 1;
+
+  // The id to be used when referring to the new cluster within its zone,
+  // e.g. just the "test-cluster" section of the full name
+  // "projects/<project>/zones/<zone>/clusters/test-cluster".
+  string cluster_id = 2;
+
+  // The cluster to create.
+  // The "name", "delete_time", and "current_operation" fields must be left
+  // blank.
+  Cluster cluster = 3;
+}
+
+// Metadata type for the operation returned by
+// BigtableClusterService.CreateCluster.
+message CreateClusterMetadata {
+  // The request which prompted the creation of this operation.
+  CreateClusterRequest original_request = 1;
+
+  // The time at which original_request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// Metadata type for the operation returned by
+// BigtableClusterService.UpdateCluster.
+message UpdateClusterMetadata {
+  // The request which prompted the creation of this operation.
+  Cluster original_request = 1;
+
+  // The time at which original_request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which this operation was cancelled. If set, this operation is
+  // in the process of undoing itself (which is guaranteed to succeed) and
+  // cannot be cancelled again.
+  google.protobuf.Timestamp cancel_time = 3;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 4;
+}
+
+// Request message for BigtableClusterService.DeleteCluster.
+message DeleteClusterRequest {
+  // The unique name of the cluster to be deleted.
+  // Values are of the form projects/<project>/zones/<zone>/clusters/<cluster>
+  string name = 1;
+}
+
+// Request message for BigtableClusterService.UndeleteCluster.
+message UndeleteClusterRequest {
+  // The unique name of the cluster to be un-deleted.
+  // Values are of the form projects/<project>/zones/<zone>/clusters/<cluster>
+  string name = 1;
+}
+
+// Metadata type for the operation returned by
+// BigtableClusterService.UndeleteCluster.
+message UndeleteClusterMetadata {
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 1;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 2;
+}
+
+// Metadata type for operations initiated by the V2 BigtableAdmin service.
+// More complete information for such operations is available via the V2 API.
+message V2OperationMetadata {
+
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_data.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_data.proto
new file mode 100644
index 000000000000..bd063a925f45
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_data.proto
@@ -0,0 +1,516 @@
+// 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.bigtable.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/v1;bigtable";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableDataProto";
+option java_package = "com.google.bigtable.v1";
+
+
+// Specifies the complete (requested) contents of a single row of a table.
+// Rows which exceed 256MiB in size cannot be read in full.
+message Row {
+  // The unique key which identifies this row within its table. This is the same
+  // key that's used to identify the row in, for example, a MutateRowRequest.
+  // May contain any non-empty byte string up to 4KiB in length.
+  bytes key = 1;
+
+  // May be empty, but only if the entire row is empty.
+  // The mutual ordering of column families is not specified.
+  repeated Family families = 2;
+}
+
+// Specifies (some of) the contents of a single row/column family of a table.
+message Family {
+  // The unique key which identifies this family within its row. This is the
+  // same key that's used to identify the family in, for example, a RowFilter
+  // which sets its "family_name_regex_filter" field.
+  // Must match [-_.a-zA-Z0-9]+, except that AggregatingRowProcessors may
+  // produce cells in a sentinel family with an empty name.
+  // Must be no greater than 64 characters in length.
+  string name = 1;
+
+  // Must not be empty. Sorted in order of increasing "qualifier".
+  repeated Column columns = 2;
+}
+
+// Specifies (some of) the contents of a single row/column of a table.
+message Column {
+  // The unique key which identifies this column within its family. This is the
+  // same key that's used to identify the column in, for example, a RowFilter
+  // which sets its "column_qualifier_regex_filter" field.
+  // May contain any byte string, including the empty string, up to 16kiB in
+  // length.
+  bytes qualifier = 1;
+
+  // Must not be empty. Sorted in order of decreasing "timestamp_micros".
+  repeated Cell cells = 2;
+}
+
+// Specifies (some of) the contents of a single row/column/timestamp of a table.
+message Cell {
+  // The cell's stored timestamp, which also uniquely identifies it within
+  // its column.
+  // Values are always expressed in microseconds, but individual tables may set
+  // a coarser "granularity" to further restrict the allowed values. For
+  // example, a table which specifies millisecond granularity will only allow
+  // values of "timestamp_micros" which are multiples of 1000.
+  int64 timestamp_micros = 1;
+
+  // The value stored in the cell.
+  // May contain any byte string, including the empty string, up to 100MiB in
+  // length.
+  bytes value = 2;
+
+  // Labels applied to the cell by a [RowFilter][google.bigtable.v1.RowFilter].
+  repeated string labels = 3;
+}
+
+// Specifies a contiguous range of rows.
+message RowRange {
+  // Inclusive lower bound. If left empty, interpreted as the empty string.
+  bytes start_key = 2;
+
+  // Exclusive upper bound. If left empty, interpreted as infinity.
+  bytes end_key = 3;
+}
+
+// Specifies a non-contiguous set of rows.
+message RowSet {
+  // Single rows included in the set.
+  repeated bytes row_keys = 1;
+
+  // Contiguous row ranges included in the set.
+  repeated RowRange row_ranges = 2;
+}
+
+// Specifies a contiguous range of columns within a single column family.
+// The range spans from <column_family>:<start_qualifier> to
+// <column_family>:<end_qualifier>, where both bounds can be either inclusive or
+// exclusive.
+message ColumnRange {
+  // The name of the column family within which this range falls.
+  string family_name = 1;
+
+  // The column qualifier at which to start the range (within 'column_family').
+  // If neither field is set, interpreted as the empty string, inclusive.
+  oneof start_qualifier {
+    // Used when giving an inclusive lower bound for the range.
+    bytes start_qualifier_inclusive = 2;
+
+    // Used when giving an exclusive lower bound for the range.
+    bytes start_qualifier_exclusive = 3;
+  }
+
+  // The column qualifier at which to end the range (within 'column_family').
+  // If neither field is set, interpreted as the infinite string, exclusive.
+  oneof end_qualifier {
+    // Used when giving an inclusive upper bound for the range.
+    bytes end_qualifier_inclusive = 4;
+
+    // Used when giving an exclusive upper bound for the range.
+    bytes end_qualifier_exclusive = 5;
+  }
+}
+
+// Specified a contiguous range of microsecond timestamps.
+message TimestampRange {
+  // Inclusive lower bound. If left empty, interpreted as 0.
+  int64 start_timestamp_micros = 1;
+
+  // Exclusive upper bound. If left empty, interpreted as infinity.
+  int64 end_timestamp_micros = 2;
+}
+
+// Specifies a contiguous range of raw byte values.
+message ValueRange {
+  // The value at which to start the range.
+  // If neither field is set, interpreted as the empty string, inclusive.
+  oneof start_value {
+    // Used when giving an inclusive lower bound for the range.
+    bytes start_value_inclusive = 1;
+
+    // Used when giving an exclusive lower bound for the range.
+    bytes start_value_exclusive = 2;
+  }
+
+  // The value at which to end the range.
+  // If neither field is set, interpreted as the infinite string, exclusive.
+  oneof end_value {
+    // Used when giving an inclusive upper bound for the range.
+    bytes end_value_inclusive = 3;
+
+    // Used when giving an exclusive upper bound for the range.
+    bytes end_value_exclusive = 4;
+  }
+}
+
+// Takes a row as input and produces an alternate view of the row based on
+// specified rules. For example, a RowFilter might trim down a row to include
+// just the cells from columns matching a given regular expression, or might
+// return all the cells of a row but not their values. More complicated filters
+// can be composed out of these components to express requests such as, "within
+// every column of a particular family, give just the two most recent cells
+// which are older than timestamp X."
+//
+// There are two broad categories of RowFilters (true filters and transformers),
+// as well as two ways to compose simple filters into more complex ones
+// (chains and interleaves). They work as follows:
+//
+// * True filters alter the input row by excluding some of its cells wholesale
+// from the output row. An example of a true filter is the "value_regex_filter",
+// which excludes cells whose values don't match the specified pattern. All
+// regex true filters use RE2 syntax (https://github.com/google/re2/wiki/Syntax)
+// in raw byte mode (RE2::Latin1), and are evaluated as full matches. An
+// important point to keep in mind is that RE2(.) is equivalent by default to
+// RE2([^\n]), meaning that it does not match newlines. When attempting to match
+// an arbitrary byte, you should therefore use the escape sequence '\C', which
+// may need to be further escaped as '\\C' in your client language.
+//
+// * Transformers alter the input row by changing the values of some of its
+// cells in the output, without excluding them completely. Currently, the only
+// supported transformer is the "strip_value_transformer", which replaces every
+// cell's value with the empty string.
+//
+// * Chains and interleaves are described in more detail in the
+// RowFilter.Chain and RowFilter.Interleave documentation.
+//
+// The total serialized size of a RowFilter message must not
+// exceed 4096 bytes, and RowFilters may not be nested within each other
+// (in Chains or Interleaves) to a depth of more than 20.
+message RowFilter {
+  // A RowFilter which sends rows through several RowFilters in sequence.
+  message Chain {
+    // The elements of "filters" are chained together to process the input row:
+    // in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
+    // The full chain is executed atomically.
+    repeated RowFilter filters = 1;
+  }
+
+  // A RowFilter which sends each row to each of several component
+  // RowFilters and interleaves the results.
+  message Interleave {
+    // The elements of "filters" all process a copy of the input row, and the
+    // results are pooled, sorted, and combined into a single output row.
+    // If multiple cells are produced with the same column and timestamp,
+    // they will all appear in the output row in an unspecified mutual order.
+    // Consider the following example, with three filters:
+    //
+    //                              input row
+    //                                  |
+    //        -----------------------------------------------------
+    //        |                         |                         |
+    //       f(0)                      f(1)                      f(2)
+    //        |                         |                         |
+    // 1: foo,bar,10,x             foo,bar,10,z              far,bar,7,a
+    // 2: foo,blah,11,z            far,blah,5,x              far,blah,5,x
+    //        |                         |                         |
+    //        -----------------------------------------------------
+    //                                  |
+    // 1:                        foo,bar,10,z     // could have switched with #2
+    // 2:                        foo,bar,10,x     // could have switched with #1
+    // 3:                        foo,blah,11,z
+    // 4:                        far,bar,7,a
+    // 5:                        far,blah,5,x     // identical to #6
+    // 6:                        far,blah,5,x     // identical to #5
+    // All interleaved filters are executed atomically.
+    repeated RowFilter filters = 1;
+  }
+
+  // A RowFilter which evaluates one of two possible RowFilters, depending on
+  // whether or not a predicate RowFilter outputs any cells from the input row.
+  //
+  // IMPORTANT NOTE: The predicate filter does not execute atomically with the
+  // true and false filters, which may lead to inconsistent or unexpected
+  // results. Additionally, Condition filters have poor performance, especially
+  // when filters are set for the false condition.
+  message Condition {
+    // If "predicate_filter" outputs any cells, then "true_filter" will be
+    // evaluated on the input row. Otherwise, "false_filter" will be evaluated.
+    RowFilter predicate_filter = 1;
+
+    // The filter to apply to the input row if "predicate_filter" returns any
+    // results. If not provided, no results will be returned in the true case.
+    RowFilter true_filter = 2;
+
+    // The filter to apply to the input row if "predicate_filter" does not
+    // return any results. If not provided, no results will be returned in the
+    // false case.
+    RowFilter false_filter = 3;
+  }
+
+  // Which of the possible RowFilter types to apply. If none are set, this
+  // RowFilter returns all cells in the input row.
+  oneof filter {
+    // Applies several RowFilters to the data in sequence, progressively
+    // narrowing the results.
+    Chain chain = 1;
+
+    // Applies several RowFilters to the data in parallel and combines the
+    // results.
+    Interleave interleave = 2;
+
+    // Applies one of two possible RowFilters to the data based on the output of
+    // a predicate RowFilter.
+    Condition condition = 3;
+
+    // ADVANCED USE ONLY.
+    // Hook for introspection into the RowFilter. Outputs all cells directly to
+    // the output of the read rather than to any parent filter. Consider the
+    // following example:
+    //
+    // Chain(
+    //   FamilyRegex("A"),
+    //   Interleave(
+    //     All(),
+    //     Chain(Label("foo"), Sink())
+    //   ),
+    //   QualifierRegex("B")
+    // )
+    //
+    //                         A,A,1,w
+    //                         A,B,2,x
+    //                         B,B,4,z
+    //                            |
+    //                     FamilyRegex("A")
+    //                            |
+    //                         A,A,1,w
+    //                         A,B,2,x
+    //                            |
+    //               +------------+-------------+
+    //               |                          |
+    //             All()                    Label(foo)
+    //               |                          |
+    //            A,A,1,w              A,A,1,w,labels:[foo]
+    //            A,B,2,x              A,B,2,x,labels:[foo]
+    //               |                          |
+    //               |                        Sink() --------------+
+    //               |                          |                  |
+    //               +------------+      x------+          A,A,1,w,labels:[foo]
+    //                            |                        A,B,2,x,labels:[foo]
+    //                         A,A,1,w                             |
+    //                         A,B,2,x                             |
+    //                            |                                |
+    //                    QualifierRegex("B")                      |
+    //                            |                                |
+    //                         A,B,2,x                             |
+    //                            |                                |
+    //                            +--------------------------------+
+    //                            |
+    //                         A,A,1,w,labels:[foo]
+    //                         A,B,2,x,labels:[foo]  // could be switched
+    //                         A,B,2,x               // could be switched
+    //
+    // Despite being excluded by the qualifier filter, a copy of every cell
+    // that reaches the sink is present in the final result.
+    //
+    // As with an [Interleave][google.bigtable.v1.RowFilter.Interleave],
+    // duplicate cells are possible, and appear in an unspecified mutual order.
+    // In this case we have a duplicate with column "A:B" and timestamp 2,
+    // because one copy passed through the all filter while the other was
+    // passed through the label and sink. Note that one copy has label "foo",
+    // while the other does not.
+    //
+    // Cannot be used within the `predicate_filter`, `true_filter`, or
+    // `false_filter` of a [Condition][google.bigtable.v1.RowFilter.Condition].
+    bool sink = 16;
+
+    // Matches all cells, regardless of input. Functionally equivalent to
+    // leaving `filter` unset, but included for completeness.
+    bool pass_all_filter = 17;
+
+    // Does not match any cells, regardless of input. Useful for temporarily
+    // disabling just part of a filter.
+    bool block_all_filter = 18;
+
+    // Matches only cells from rows whose keys satisfy the given RE2 regex. In
+    // other words, passes through the entire row when the key matches, and
+    // otherwise produces an empty row.
+    // Note that, since row keys can contain arbitrary bytes, the '\C' escape
+    // sequence must be used if a true wildcard is desired. The '.' character
+    // will not match the new line character '\n', which may be present in a
+    // binary key.
+    bytes row_key_regex_filter = 4;
+
+    // Matches all cells from a row with probability p, and matches no cells
+    // from the row with probability 1-p.
+    double row_sample_filter = 14;
+
+    // Matches only cells from columns whose families satisfy the given RE2
+    // regex. For technical reasons, the regex must not contain the ':'
+    // character, even if it is not being used as a literal.
+    // Note that, since column families cannot contain the new line character
+    // '\n', it is sufficient to use '.' as a full wildcard when matching
+    // column family names.
+    string family_name_regex_filter = 5;
+
+    // Matches only cells from columns whose qualifiers satisfy the given RE2
+    // regex.
+    // Note that, since column qualifiers can contain arbitrary bytes, the '\C'
+    // escape sequence must be used if a true wildcard is desired. The '.'
+    // character will not match the new line character '\n', which may be
+    // present in a binary qualifier.
+    bytes column_qualifier_regex_filter = 6;
+
+    // Matches only cells from columns within the given range.
+    ColumnRange column_range_filter = 7;
+
+    // Matches only cells with timestamps within the given range.
+    TimestampRange timestamp_range_filter = 8;
+
+    // Matches only cells with values that satisfy the given regular expression.
+    // Note that, since cell values can contain arbitrary bytes, the '\C' escape
+    // sequence must be used if a true wildcard is desired. The '.' character
+    // will not match the new line character '\n', which may be present in a
+    // binary value.
+    bytes value_regex_filter = 9;
+
+    // Matches only cells with values that fall within the given range.
+    ValueRange value_range_filter = 15;
+
+    // Skips the first N cells of each row, matching all subsequent cells.
+    // If duplicate cells are present, as is possible when using an Interleave,
+    // each copy of the cell is counted separately.
+    int32 cells_per_row_offset_filter = 10;
+
+    // Matches only the first N cells of each row.
+    // If duplicate cells are present, as is possible when using an Interleave,
+    // each copy of the cell is counted separately.
+    int32 cells_per_row_limit_filter = 11;
+
+    // Matches only the most recent N cells within each column. For example,
+    // if N=2, this filter would match column "foo:bar" at timestamps 10 and 9,
+    // skip all earlier cells in "foo:bar", and then begin matching again in
+    // column "foo:bar2".
+    // If duplicate cells are present, as is possible when using an Interleave,
+    // each copy of the cell is counted separately.
+    int32 cells_per_column_limit_filter = 12;
+
+    // Replaces each cell's value with the empty string.
+    bool strip_value_transformer = 13;
+
+    // Applies the given label to all cells in the output row. This allows
+    // the client to determine which results were produced from which part of
+    // the filter.
+    //
+    // Values must be at most 15 characters in length, and match the RE2
+    // pattern [a-z0-9\\-]+
+    //
+    // Due to a technical limitation, it is not currently possible to apply
+    // multiple labels to a cell. As a result, a Chain may have no more than
+    // one sub-filter which contains a apply_label_transformer. It is okay for
+    // an Interleave to contain multiple apply_label_transformers, as they will
+    // be applied to separate copies of the input. This may be relaxed in the
+    // future.
+    string apply_label_transformer = 19;
+  }
+}
+
+// Specifies a particular change to be made to the contents of a row.
+message Mutation {
+  // A Mutation which sets the value of the specified cell.
+  message SetCell {
+    // The name of the family into which new data should be written.
+    // Must match [-_.a-zA-Z0-9]+
+    string family_name = 1;
+
+    // The qualifier of the column into which new data should be written.
+    // Can be any byte string, including the empty string.
+    bytes column_qualifier = 2;
+
+    // The timestamp of the cell into which new data should be written.
+    // Use -1 for current Bigtable server time.
+    // Otherwise, the client should set this value itself, noting that the
+    // default value is a timestamp of zero if the field is left unspecified.
+    // Values must match the "granularity" of the table (e.g. micros, millis).
+    int64 timestamp_micros = 3;
+
+    // The value to be written into the specified cell.
+    bytes value = 4;
+  }
+
+  // A Mutation which deletes cells from the specified column, optionally
+  // restricting the deletions to a given timestamp range.
+  message DeleteFromColumn {
+    // The name of the family from which cells should be deleted.
+    // Must match [-_.a-zA-Z0-9]+
+    string family_name = 1;
+
+    // The qualifier of the column from which cells should be deleted.
+    // Can be any byte string, including the empty string.
+    bytes column_qualifier = 2;
+
+    // The range of timestamps within which cells should be deleted.
+    TimestampRange time_range = 3;
+  }
+
+  // A Mutation which deletes all cells from the specified column family.
+  message DeleteFromFamily {
+    // The name of the family from which cells should be deleted.
+    // Must match [-_.a-zA-Z0-9]+
+    string family_name = 1;
+  }
+
+  // A Mutation which deletes all cells from the containing row.
+  message DeleteFromRow {
+
+  }
+
+  // Which of the possible Mutation types to apply.
+  oneof mutation {
+    // Set a cell's value.
+    SetCell set_cell = 1;
+
+    // Deletes cells from a column.
+    DeleteFromColumn delete_from_column = 2;
+
+    // Deletes cells from a column family.
+    DeleteFromFamily delete_from_family = 3;
+
+    // Deletes cells from the entire row.
+    DeleteFromRow delete_from_row = 4;
+  }
+}
+
+// Specifies an atomic read/modify/write operation on the latest value of the
+// specified column.
+message ReadModifyWriteRule {
+  // The name of the family to which the read/modify/write should be applied.
+  // Must match [-_.a-zA-Z0-9]+
+  string family_name = 1;
+
+  // The qualifier of the column to which the read/modify/write should be
+  // applied.
+  // Can be any byte string, including the empty string.
+  bytes column_qualifier = 2;
+
+  // The rule used to determine the column's new latest value from its current
+  // latest value.
+  oneof rule {
+    // Rule specifying that "append_value" be appended to the existing value.
+    // If the targeted cell is unset, it will be treated as containing the
+    // empty string.
+    bytes append_value = 3;
+
+    // Rule specifying that "increment_amount" be added to the existing value.
+    // If the targeted cell is unset, it will be treated as containing a zero.
+    // Otherwise, the targeted cell must contain an 8-byte value (interpreted
+    // as a 64-bit big-endian signed integer), or the entire request will fail.
+    int64 increment_amount = 4;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_instance_admin.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_instance_admin.proto
new file mode 100644
index 000000000000..ec992ea0f818
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_instance_admin.proto
@@ -0,0 +1,456 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/v2/instance.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/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableInstanceAdminProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+
+// Service for creating, configuring, and deleting Cloud Bigtable Instances and
+// Clusters. Provides access to the Instance and Cluster schemas only, not the
+// tables' metadata or data stored in those tables.
+service BigtableInstanceAdmin {
+  // Create an instance within a project.
+  rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/instances"
+      body: "*"
+    };
+  }
+
+  // Gets information about an instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Lists information about instances in a project.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*}/instances"
+    };
+  }
+
+  // Updates an instance within a project.
+  rpc UpdateInstance(Instance) returns (Instance) {
+    option (google.api.http) = {
+      put: "/v2/{name=projects/*/instances/*}"
+      body: "*"
+    };
+  }
+
+  // Partially updates an instance within a project.
+  rpc PartialUpdateInstance(PartialUpdateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v2/{instance.name=projects/*/instances/*}"
+      body: "instance"
+    };
+  }
+
+  // Delete an instance from a project.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Creates a cluster within an instance.
+  rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/clusters"
+      body: "cluster"
+    };
+  }
+
+  // Gets information about a cluster.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/clusters/*}"
+    };
+  }
+
+  // Lists information about clusters in an instance.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*}/clusters"
+    };
+  }
+
+  // Updates a cluster within an instance.
+  rpc UpdateCluster(Cluster) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      put: "/v2/{name=projects/*/instances/*/clusters/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes a cluster from an instance.
+  rpc DeleteCluster(DeleteClusterRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/clusters/*}"
+    };
+  }
+
+  // Creates an app profile within an instance.
+  rpc CreateAppProfile(CreateAppProfileRequest) returns (AppProfile) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/appProfiles"
+      body: "app_profile"
+    };
+  }
+
+  // Gets information about an app profile.
+  rpc GetAppProfile(GetAppProfileRequest) returns (AppProfile) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/appProfiles/*}"
+    };
+  }
+
+  // Lists information about app profiles in an instance.
+  rpc ListAppProfiles(ListAppProfilesRequest) returns (ListAppProfilesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*}/appProfiles"
+    };
+  }
+
+  // Updates an app profile within an instance.
+  rpc UpdateAppProfile(UpdateAppProfileRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v2/{app_profile.name=projects/*/instances/*/appProfiles/*}"
+      body: "app_profile"
+    };
+  }
+
+  // Deletes an app profile from an instance.
+  rpc DeleteAppProfile(DeleteAppProfileRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/appProfiles/*}"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v2/{resource=projects/*/instances/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Sets the access control policy on an instance 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/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Returns permissions that the caller has on the specified instance resource.
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
+    option (google.api.http) = {
+      post: "/v2/{resource=projects/*/instances/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // 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;
+
+  // The instance to create.
+  // Fields marked `OutputOnly` must be left blank.
+  Instance instance = 3;
+
+  // 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<string, Cluster> clusters = 4;
+}
+
+// Request message for BigtableInstanceAdmin.GetInstance.
+message GetInstanceRequest {
+  // The unique name of the requested instance. Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  string name = 1;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // DEPRECATED: This field is unused and ignored.
+  string page_token = 2;
+}
+
+// Response message for BigtableInstanceAdmin.ListInstances.
+message ListInstancesResponse {
+  // The list of requested instances.
+  repeated Instance instances = 1;
+
+  // Locations from which Instance information could not be retrieved,
+  // due to an outage or some other transient condition.
+  // Instances whose Clusters are all in one of the failed locations
+  // may be missing from `instances`, and Instances with at least one
+  // Cluster in a failed location may only have partial information returned.
+  // Values are of the form `projects/<project>/locations/<zone_id>`
+  repeated string failed_locations = 2;
+
+  // DEPRECATED: This field is unused and ignored.
+  string next_page_token = 3;
+}
+
+// Request message for BigtableInstanceAdmin.PartialUpdateInstance.
+message PartialUpdateInstanceRequest {
+  // The Instance which will (partially) replace the current value.
+  Instance instance = 1;
+
+  // The subset of Instance fields which should be replaced.
+  // Must be explicitly set.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for BigtableInstanceAdmin.DeleteInstance.
+message DeleteInstanceRequest {
+  // The unique name of the instance to be deleted.
+  // Values are of the form `projects/<project>/instances/<instance>`.
+  string name = 1;
+}
+
+// Request message for BigtableInstanceAdmin.CreateCluster.
+message CreateClusterRequest {
+  // The unique name of the instance in which to create the new cluster.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // The cluster to be created.
+  // Fields marked `OutputOnly` must be left blank.
+  Cluster cluster = 3;
+}
+
+// Request message for BigtableInstanceAdmin.GetCluster.
+message GetClusterRequest {
+  // The unique name of the requested cluster. Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>`.
+  string name = 1;
+}
+
+// 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/<project>/instances/<instance>`.
+  // Use `<instance> = '-'` to list Clusters for all Instances in a project,
+  // e.g., `projects/myproject/instances/-`.
+  string parent = 1;
+
+  // DEPRECATED: This field is unused and ignored.
+  string page_token = 2;
+}
+
+// Response message for BigtableInstanceAdmin.ListClusters.
+message ListClustersResponse {
+  // The list of requested clusters.
+  repeated Cluster clusters = 1;
+
+  // Locations from which Cluster information could not be retrieved,
+  // due to an outage or some other transient condition.
+  // Clusters from these locations may be missing from `clusters`,
+  // or may only have partial information returned.
+  // Values are of the form `projects/<project>/locations/<zone_id>`
+  repeated string failed_locations = 2;
+
+  // DEPRECATED: This field is unused and ignored.
+  string next_page_token = 3;
+}
+
+// Request message for BigtableInstanceAdmin.DeleteCluster.
+message DeleteClusterRequest {
+  // The unique name of the cluster to be deleted. Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>`.
+  string name = 1;
+}
+
+// The metadata for the Operation returned by CreateInstance.
+message CreateInstanceMetadata {
+  // The request that prompted the initiation of this CreateInstance operation.
+  CreateInstanceRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by UpdateInstance.
+message UpdateInstanceMetadata {
+  // The request that prompted the initiation of this UpdateInstance operation.
+  PartialUpdateInstanceRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by CreateCluster.
+message CreateClusterMetadata {
+  // The request that prompted the initiation of this CreateCluster operation.
+  CreateClusterRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by UpdateCluster.
+message UpdateClusterMetadata {
+  // The request that prompted the initiation of this UpdateCluster operation.
+  Cluster original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// Request message for BigtableInstanceAdmin.CreateAppProfile.
+message CreateAppProfileRequest {
+  // The unique name of the instance in which to create the new app profile.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // The app profile to be created.
+  // Fields marked `OutputOnly` will be ignored.
+  AppProfile app_profile = 3;
+
+  // If true, ignore safety checks when creating the app profile.
+  bool ignore_warnings = 4;
+}
+
+// Request message for BigtableInstanceAdmin.GetAppProfile.
+message GetAppProfileRequest {
+  // The unique name of the requested app profile. Values are of the form
+  // `projects/<project>/instances/<instance>/appProfiles/<app_profile>`.
+  string name = 1;
+}
+
+// Request message for BigtableInstanceAdmin.ListAppProfiles.
+message ListAppProfilesRequest {
+  // The unique name of the instance for which a list of app profiles is
+  // requested. Values are of the form
+  // `projects/<project>/instances/<instance>`.
+  // Use `<instance> = '-'` to list AppProfiles for all Instances in a project,
+  // e.g., `projects/myproject/instances/-`.
+  string parent = 1;
+
+  // Maximum number of results per page.
+  // CURRENTLY UNIMPLEMENTED AND IGNORED.
+  int32 page_size = 3;
+
+  // The value of `next_page_token` returned by a previous call.
+  string page_token = 2;
+}
+
+// Response message for BigtableInstanceAdmin.ListAppProfiles.
+message ListAppProfilesResponse {
+  // The list of requested app profiles.
+  repeated AppProfile app_profiles = 1;
+
+  // Set if not all app profiles could be returned in a single response.
+  // Pass this value to `page_token` in another request to get the next
+  // page of results.
+  string next_page_token = 2;
+
+  // Locations from which AppProfile information could not be retrieved,
+  // due to an outage or some other transient condition.
+  // AppProfiles from these locations may be missing from `app_profiles`.
+  // Values are of the form `projects/<project>/locations/<zone_id>`
+  repeated string failed_locations = 3;
+}
+
+// Request message for BigtableInstanceAdmin.UpdateAppProfile.
+message UpdateAppProfileRequest {
+  // The app profile which will (partially) replace the current value.
+  AppProfile app_profile = 1;
+
+  // The subset of app profile fields which should be replaced.
+  // If unset, all fields will be replaced.
+  google.protobuf.FieldMask update_mask = 2;
+
+  // If true, ignore safety checks when updating the app profile.
+  bool ignore_warnings = 3;
+}
+
+
+// Request message for BigtableInstanceAdmin.DeleteAppProfile.
+message DeleteAppProfileRequest {
+  // 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;
+
+  // If true, ignore safety checks when deleting the app profile.
+  bool ignore_warnings = 2;
+}
+
+// The metadata for the Operation returned by UpdateAppProfile.
+message UpdateAppProfileMetadata {
+
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_pb2.py b/bigtable/google/cloud/bigtable_v2/proto/bigtable_pb2.py
new file mode 100644
index 000000000000..1c2b0f1ae134
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_pb2.py
@@ -0,0 +1,1732 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable_v2/proto/bigtable.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.bigtable_v2.proto import (
+    data_pb2 as google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2,
+)
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable_v2/proto/bigtable.proto",
+    package="google.bigtable.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\026com.google.bigtable.v2B\rBigtableProtoP\001Z:google.golang.org/genproto/googleapis/bigtable/v2;bigtable\252\002\030Google.Cloud.Bigtable.V2\312\002\030Google\\Cloud\\Bigtable\\V2"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/bigtable_v2/proto/bigtable.proto\x12\x12google.bigtable.v2\x1a\x1cgoogle/api/annotations.proto\x1a)google/cloud/bigtable_v2/proto/data.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto"\xaa\x01\n\x0fReadRowsRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x05 \x01(\t\x12(\n\x04rows\x18\x02 \x01(\x0b\x32\x1a.google.bigtable.v2.RowSet\x12-\n\x06\x66ilter\x18\x03 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x12\n\nrows_limit\x18\x04 \x01(\x03"\xf8\x02\n\x10ReadRowsResponse\x12>\n\x06\x63hunks\x18\x01 \x03(\x0b\x32..google.bigtable.v2.ReadRowsResponse.CellChunk\x12\x1c\n\x14last_scanned_row_key\x18\x02 \x01(\x0c\x1a\x85\x02\n\tCellChunk\x12\x0f\n\x07row_key\x18\x01 \x01(\x0c\x12\x31\n\x0b\x66\x61mily_name\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.StringValue\x12.\n\tqualifier\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.BytesValue\x12\x18\n\x10timestamp_micros\x18\x04 \x01(\x03\x12\x0e\n\x06labels\x18\x05 \x03(\t\x12\r\n\x05value\x18\x06 \x01(\x0c\x12\x12\n\nvalue_size\x18\x07 \x01(\x05\x12\x13\n\treset_row\x18\x08 \x01(\x08H\x00\x12\x14\n\ncommit_row\x18\t \x01(\x08H\x00\x42\x0c\n\nrow_status"B\n\x14SampleRowKeysRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x02 \x01(\t">\n\x15SampleRowKeysResponse\x12\x0f\n\x07row_key\x18\x01 \x01(\x0c\x12\x14\n\x0coffset_bytes\x18\x02 \x01(\x03"\x80\x01\n\x10MutateRowRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x04 \x01(\t\x12\x0f\n\x07row_key\x18\x02 \x01(\x0c\x12/\n\tmutations\x18\x03 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation"\x13\n\x11MutateRowResponse"\xc8\x01\n\x11MutateRowsRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x03 \x01(\t\x12<\n\x07\x65ntries\x18\x02 \x03(\x0b\x32+.google.bigtable.v2.MutateRowsRequest.Entry\x1aI\n\x05\x45ntry\x12\x0f\n\x07row_key\x18\x01 \x01(\x0c\x12/\n\tmutations\x18\x02 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation"\x8f\x01\n\x12MutateRowsResponse\x12=\n\x07\x65ntries\x18\x01 \x03(\x0b\x32,.google.bigtable.v2.MutateRowsResponse.Entry\x1a:\n\x05\x45ntry\x12\r\n\x05index\x18\x01 \x01(\x03\x12"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status"\xfd\x01\n\x18\x43heckAndMutateRowRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x07 \x01(\t\x12\x0f\n\x07row_key\x18\x02 \x01(\x0c\x12\x37\n\x10predicate_filter\x18\x06 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x34\n\x0etrue_mutations\x18\x04 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation\x12\x35\n\x0f\x66\x61lse_mutations\x18\x05 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation"6\n\x19\x43heckAndMutateRowResponse\x12\x19\n\x11predicate_matched\x18\x01 \x01(\x08"\x90\x01\n\x19ReadModifyWriteRowRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x16\n\x0e\x61pp_profile_id\x18\x04 \x01(\t\x12\x0f\n\x07row_key\x18\x02 \x01(\x0c\x12\x36\n\x05rules\x18\x03 \x03(\x0b\x32\'.google.bigtable.v2.ReadModifyWriteRule"B\n\x1aReadModifyWriteRowResponse\x12$\n\x03row\x18\x01 \x01(\x0b\x32\x17.google.bigtable.v2.Row2\xad\x08\n\x08\x42igtable\x12\x9d\x01\n\x08ReadRows\x12#.google.bigtable.v2.ReadRowsRequest\x1a$.google.bigtable.v2.ReadRowsResponse"D\x82\xd3\xe4\x93\x02>"9/v2/{table_name=projects/*/instances/*/tables/*}:readRows:\x01*0\x01\x12\xae\x01\n\rSampleRowKeys\x12(.google.bigtable.v2.SampleRowKeysRequest\x1a).google.bigtable.v2.SampleRowKeysResponse"F\x82\xd3\xe4\x93\x02@\x12>/v2/{table_name=projects/*/instances/*/tables/*}:sampleRowKeys0\x01\x12\x9f\x01\n\tMutateRow\x12$.google.bigtable.v2.MutateRowRequest\x1a%.google.bigtable.v2.MutateRowResponse"E\x82\xd3\xe4\x93\x02?":/v2/{table_name=projects/*/instances/*/tables/*}:mutateRow:\x01*\x12\xa5\x01\n\nMutateRows\x12%.google.bigtable.v2.MutateRowsRequest\x1a&.google.bigtable.v2.MutateRowsResponse"F\x82\xd3\xe4\x93\x02@";/v2/{table_name=projects/*/instances/*/tables/*}:mutateRows:\x01*0\x01\x12\xbf\x01\n\x11\x43heckAndMutateRow\x12,.google.bigtable.v2.CheckAndMutateRowRequest\x1a-.google.bigtable.v2.CheckAndMutateRowResponse"M\x82\xd3\xe4\x93\x02G"B/v2/{table_name=projects/*/instances/*/tables/*}:checkAndMutateRow:\x01*\x12\xc3\x01\n\x12ReadModifyWriteRow\x12-.google.bigtable.v2.ReadModifyWriteRowRequest\x1a..google.bigtable.v2.ReadModifyWriteRowResponse"N\x82\xd3\xe4\x93\x02H"C/v2/{table_name=projects/*/instances/*/tables/*}:readModifyWriteRow:\x01*B\x9b\x01\n\x16\x63om.google.bigtable.v2B\rBigtableProtoP\x01Z:google.golang.org/genproto/googleapis/bigtable/v2;bigtable\xaa\x02\x18Google.Cloud.Bigtable.V2\xca\x02\x18Google\\Cloud\\Bigtable\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_READROWSREQUEST = _descriptor.Descriptor(
+    name="ReadRowsRequest",
+    full_name="google.bigtable.v2.ReadRowsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_name",
+            full_name="google.bigtable.v2.ReadRowsRequest.table_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.v2.ReadRowsRequest.app_profile_id",
+            index=1,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows",
+            full_name="google.bigtable.v2.ReadRowsRequest.rows",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.bigtable.v2.ReadRowsRequest.filter",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows_limit",
+            full_name="google.bigtable.v2.ReadRowsRequest.rows_limit",
+            index=4,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=200,
+    serialized_end=370,
+)
+
+
+_READROWSRESPONSE_CELLCHUNK = _descriptor.Descriptor(
+    name="CellChunk",
+    full_name="google.bigtable.v2.ReadRowsResponse.CellChunk",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row_key",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.row_key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.family_name",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="qualifier",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.qualifier",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_micros",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.timestamp_micros",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.labels",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.value",
+            index=5,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value_size",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.value_size",
+            index=6,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reset_row",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.reset_row",
+            index=7,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commit_row",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.commit_row",
+            index=8,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="row_status",
+            full_name="google.bigtable.v2.ReadRowsResponse.CellChunk.row_status",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=488,
+    serialized_end=749,
+)
+
+_READROWSRESPONSE = _descriptor.Descriptor(
+    name="ReadRowsResponse",
+    full_name="google.bigtable.v2.ReadRowsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="chunks",
+            full_name="google.bigtable.v2.ReadRowsResponse.chunks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_scanned_row_key",
+            full_name="google.bigtable.v2.ReadRowsResponse.last_scanned_row_key",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_READROWSRESPONSE_CELLCHUNK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=373,
+    serialized_end=749,
+)
+
+
+_SAMPLEROWKEYSREQUEST = _descriptor.Descriptor(
+    name="SampleRowKeysRequest",
+    full_name="google.bigtable.v2.SampleRowKeysRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_name",
+            full_name="google.bigtable.v2.SampleRowKeysRequest.table_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.v2.SampleRowKeysRequest.app_profile_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=751,
+    serialized_end=817,
+)
+
+
+_SAMPLEROWKEYSRESPONSE = _descriptor.Descriptor(
+    name="SampleRowKeysResponse",
+    full_name="google.bigtable.v2.SampleRowKeysResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row_key",
+            full_name="google.bigtable.v2.SampleRowKeysResponse.row_key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset_bytes",
+            full_name="google.bigtable.v2.SampleRowKeysResponse.offset_bytes",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=819,
+    serialized_end=881,
+)
+
+
+_MUTATEROWREQUEST = _descriptor.Descriptor(
+    name="MutateRowRequest",
+    full_name="google.bigtable.v2.MutateRowRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_name",
+            full_name="google.bigtable.v2.MutateRowRequest.table_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.v2.MutateRowRequest.app_profile_id",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_key",
+            full_name="google.bigtable.v2.MutateRowRequest.row_key",
+            index=2,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mutations",
+            full_name="google.bigtable.v2.MutateRowRequest.mutations",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=884,
+    serialized_end=1012,
+)
+
+
+_MUTATEROWRESPONSE = _descriptor.Descriptor(
+    name="MutateRowResponse",
+    full_name="google.bigtable.v2.MutateRowResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1014,
+    serialized_end=1033,
+)
+
+
+_MUTATEROWSREQUEST_ENTRY = _descriptor.Descriptor(
+    name="Entry",
+    full_name="google.bigtable.v2.MutateRowsRequest.Entry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row_key",
+            full_name="google.bigtable.v2.MutateRowsRequest.Entry.row_key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mutations",
+            full_name="google.bigtable.v2.MutateRowsRequest.Entry.mutations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1163,
+    serialized_end=1236,
+)
+
+_MUTATEROWSREQUEST = _descriptor.Descriptor(
+    name="MutateRowsRequest",
+    full_name="google.bigtable.v2.MutateRowsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_name",
+            full_name="google.bigtable.v2.MutateRowsRequest.table_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.v2.MutateRowsRequest.app_profile_id",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.bigtable.v2.MutateRowsRequest.entries",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MUTATEROWSREQUEST_ENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1036,
+    serialized_end=1236,
+)
+
+
+_MUTATEROWSRESPONSE_ENTRY = _descriptor.Descriptor(
+    name="Entry",
+    full_name="google.bigtable.v2.MutateRowsResponse.Entry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.bigtable.v2.MutateRowsResponse.Entry.index",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.bigtable.v2.MutateRowsResponse.Entry.status",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1324,
+    serialized_end=1382,
+)
+
+_MUTATEROWSRESPONSE = _descriptor.Descriptor(
+    name="MutateRowsResponse",
+    full_name="google.bigtable.v2.MutateRowsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.bigtable.v2.MutateRowsResponse.entries",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_MUTATEROWSRESPONSE_ENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1239,
+    serialized_end=1382,
+)
+
+
+_CHECKANDMUTATEROWREQUEST = _descriptor.Descriptor(
+    name="CheckAndMutateRowRequest",
+    full_name="google.bigtable.v2.CheckAndMutateRowRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_name",
+            full_name="google.bigtable.v2.CheckAndMutateRowRequest.table_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.v2.CheckAndMutateRowRequest.app_profile_id",
+            index=1,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_key",
+            full_name="google.bigtable.v2.CheckAndMutateRowRequest.row_key",
+            index=2,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="predicate_filter",
+            full_name="google.bigtable.v2.CheckAndMutateRowRequest.predicate_filter",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="true_mutations",
+            full_name="google.bigtable.v2.CheckAndMutateRowRequest.true_mutations",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_mutations",
+            full_name="google.bigtable.v2.CheckAndMutateRowRequest.false_mutations",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1385,
+    serialized_end=1638,
+)
+
+
+_CHECKANDMUTATEROWRESPONSE = _descriptor.Descriptor(
+    name="CheckAndMutateRowResponse",
+    full_name="google.bigtable.v2.CheckAndMutateRowResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="predicate_matched",
+            full_name="google.bigtable.v2.CheckAndMutateRowResponse.predicate_matched",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1640,
+    serialized_end=1694,
+)
+
+
+_READMODIFYWRITEROWREQUEST = _descriptor.Descriptor(
+    name="ReadModifyWriteRowRequest",
+    full_name="google.bigtable.v2.ReadModifyWriteRowRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_name",
+            full_name="google.bigtable.v2.ReadModifyWriteRowRequest.table_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_profile_id",
+            full_name="google.bigtable.v2.ReadModifyWriteRowRequest.app_profile_id",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_key",
+            full_name="google.bigtable.v2.ReadModifyWriteRowRequest.row_key",
+            index=2,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rules",
+            full_name="google.bigtable.v2.ReadModifyWriteRowRequest.rules",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1697,
+    serialized_end=1841,
+)
+
+
+_READMODIFYWRITEROWRESPONSE = _descriptor.Descriptor(
+    name="ReadModifyWriteRowResponse",
+    full_name="google.bigtable.v2.ReadModifyWriteRowResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row",
+            full_name="google.bigtable.v2.ReadModifyWriteRowResponse.row",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1843,
+    serialized_end=1909,
+)
+
+_READROWSREQUEST.fields_by_name[
+    "rows"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._ROWSET
+_READROWSREQUEST.fields_by_name[
+    "filter"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._ROWFILTER
+_READROWSRESPONSE_CELLCHUNK.fields_by_name[
+    "family_name"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._STRINGVALUE
+_READROWSRESPONSE_CELLCHUNK.fields_by_name[
+    "qualifier"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BYTESVALUE
+_READROWSRESPONSE_CELLCHUNK.containing_type = _READROWSRESPONSE
+_READROWSRESPONSE_CELLCHUNK.oneofs_by_name["row_status"].fields.append(
+    _READROWSRESPONSE_CELLCHUNK.fields_by_name["reset_row"]
+)
+_READROWSRESPONSE_CELLCHUNK.fields_by_name[
+    "reset_row"
+].containing_oneof = _READROWSRESPONSE_CELLCHUNK.oneofs_by_name["row_status"]
+_READROWSRESPONSE_CELLCHUNK.oneofs_by_name["row_status"].fields.append(
+    _READROWSRESPONSE_CELLCHUNK.fields_by_name["commit_row"]
+)
+_READROWSRESPONSE_CELLCHUNK.fields_by_name[
+    "commit_row"
+].containing_oneof = _READROWSRESPONSE_CELLCHUNK.oneofs_by_name["row_status"]
+_READROWSRESPONSE.fields_by_name["chunks"].message_type = _READROWSRESPONSE_CELLCHUNK
+_MUTATEROWREQUEST.fields_by_name[
+    "mutations"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._MUTATION
+_MUTATEROWSREQUEST_ENTRY.fields_by_name[
+    "mutations"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._MUTATION
+_MUTATEROWSREQUEST_ENTRY.containing_type = _MUTATEROWSREQUEST
+_MUTATEROWSREQUEST.fields_by_name["entries"].message_type = _MUTATEROWSREQUEST_ENTRY
+_MUTATEROWSRESPONSE_ENTRY.fields_by_name[
+    "status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_MUTATEROWSRESPONSE_ENTRY.containing_type = _MUTATEROWSRESPONSE
+_MUTATEROWSRESPONSE.fields_by_name["entries"].message_type = _MUTATEROWSRESPONSE_ENTRY
+_CHECKANDMUTATEROWREQUEST.fields_by_name[
+    "predicate_filter"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._ROWFILTER
+_CHECKANDMUTATEROWREQUEST.fields_by_name[
+    "true_mutations"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._MUTATION
+_CHECKANDMUTATEROWREQUEST.fields_by_name[
+    "false_mutations"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._MUTATION
+_READMODIFYWRITEROWREQUEST.fields_by_name[
+    "rules"
+].message_type = (
+    google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._READMODIFYWRITERULE
+)
+_READMODIFYWRITEROWRESPONSE.fields_by_name[
+    "row"
+].message_type = google_dot_cloud_dot_bigtable__v2_dot_proto_dot_data__pb2._ROW
+DESCRIPTOR.message_types_by_name["ReadRowsRequest"] = _READROWSREQUEST
+DESCRIPTOR.message_types_by_name["ReadRowsResponse"] = _READROWSRESPONSE
+DESCRIPTOR.message_types_by_name["SampleRowKeysRequest"] = _SAMPLEROWKEYSREQUEST
+DESCRIPTOR.message_types_by_name["SampleRowKeysResponse"] = _SAMPLEROWKEYSRESPONSE
+DESCRIPTOR.message_types_by_name["MutateRowRequest"] = _MUTATEROWREQUEST
+DESCRIPTOR.message_types_by_name["MutateRowResponse"] = _MUTATEROWRESPONSE
+DESCRIPTOR.message_types_by_name["MutateRowsRequest"] = _MUTATEROWSREQUEST
+DESCRIPTOR.message_types_by_name["MutateRowsResponse"] = _MUTATEROWSRESPONSE
+DESCRIPTOR.message_types_by_name["CheckAndMutateRowRequest"] = _CHECKANDMUTATEROWREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CheckAndMutateRowResponse"
+] = _CHECKANDMUTATEROWRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ReadModifyWriteRowRequest"
+] = _READMODIFYWRITEROWREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ReadModifyWriteRowResponse"
+] = _READMODIFYWRITEROWRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ReadRowsRequest = _reflection.GeneratedProtocolMessageType(
+    "ReadRowsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READROWSREQUEST,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Request message for Bigtable.ReadRows.
+  
+  
+  Attributes:
+      table_name:
+          The unique name of the table from which to read. Values are of
+          the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      app_profile_id:
+          This value specifies routing for replication. If not
+          specified, the "default" application profile will be used.
+      rows:
+          The row keys and/or ranges to read. If not specified, reads
+          from all rows.
+      filter:
+          The filter to apply to the contents of the specified row(s).
+          If unset, reads the entirety of each row.
+      rows_limit:
+          The read will terminate after committing to N rows' worth of
+          results. The default (zero) is to return all results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadRowsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReadRowsRequest)
+
+ReadRowsResponse = _reflection.GeneratedProtocolMessageType(
+    "ReadRowsResponse",
+    (_message.Message,),
+    dict(
+        CellChunk=_reflection.GeneratedProtocolMessageType(
+            "CellChunk",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_READROWSRESPONSE_CELLCHUNK,
+                __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+                __doc__="""Specifies a piece of a row's contents returned as part of the read
+    response stream.
+    
+    
+    Attributes:
+        row_key:
+            The row key for this chunk of data. If the row key is empty,
+            this CellChunk is a continuation of the same row as the
+            previous CellChunk in the response stream, even if that
+            CellChunk was in a previous ReadRowsResponse message.
+        family_name:
+            The column family name for this chunk of data. If this message
+            is not present this CellChunk is a continuation of the same
+            column family as the previous CellChunk. The empty string can
+            occur as a column family name in a response so clients must
+            check explicitly for the presence of this message, not just
+            for ``family_name.value`` being non-empty.
+        qualifier:
+            The column qualifier for this chunk of data. If this message
+            is not present, this CellChunk is a continuation of the same
+            column as the previous CellChunk. Column qualifiers may be
+            empty so clients must check for the presence of this message,
+            not just for ``qualifier.value`` being non-empty.
+        timestamp_micros:
+            The cell's stored timestamp, which also uniquely identifies it
+            within its column. Values are always expressed in
+            microseconds, but individual tables may set a coarser
+            granularity to further restrict the allowed values. For
+            example, a table which specifies millisecond granularity will
+            only allow values of ``timestamp_micros`` which are multiples
+            of 1000. Timestamps are only set in the first CellChunk per
+            cell (for cells split into multiple chunks).
+        labels:
+            Labels applied to the cell by a
+            [RowFilter][google.bigtable.v2.RowFilter]. Labels are only set
+            on the first CellChunk per cell.
+        value:
+            The value stored in the cell. Cell values can be split across
+            multiple CellChunks. In that case only the value field will be
+            set in CellChunks after the first: the timestamp and labels
+            will only be present in the first CellChunk, even if the first
+            CellChunk came in a previous ReadRowsResponse.
+        value_size:
+            If this CellChunk is part of a chunked cell value and this is
+            not the final chunk of that cell, value\_size will be set to
+            the total length of the cell value. The client can use this
+            size to pre-allocate memory to hold the full cell value.
+        reset_row:
+            Indicates that the client should drop all previous chunks for
+            ``row_key``, as it will be re-read from the beginning.
+        commit_row:
+            Indicates that the client can safely process all previous
+            chunks for ``row_key``, as its data has been fully read.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadRowsResponse.CellChunk)
+            ),
+        ),
+        DESCRIPTOR=_READROWSRESPONSE,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Response message for Bigtable.ReadRows.
+  
+  
+  Attributes:
+      last_scanned_row_key:
+          Optionally the server might return the row key of the last row
+          it has scanned. The client can use this to construct a more
+          efficient retry request if needed: any row keys or portions of
+          ranges less than this row key can be dropped from the request.
+          This is primarily useful for cases where the server has read a
+          lot of data that was filtered out since the last committed row
+          key, allowing the client to skip that work on a retry.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadRowsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReadRowsResponse)
+_sym_db.RegisterMessage(ReadRowsResponse.CellChunk)
+
+SampleRowKeysRequest = _reflection.GeneratedProtocolMessageType(
+    "SampleRowKeysRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAMPLEROWKEYSREQUEST,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Request message for Bigtable.SampleRowKeys.
+  
+  
+  Attributes:
+      table_name:
+          The unique name of the table from which to sample row keys.
+          Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      app_profile_id:
+          This value specifies routing for replication. If not
+          specified, the "default" application profile will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.SampleRowKeysRequest)
+    ),
+)
+_sym_db.RegisterMessage(SampleRowKeysRequest)
+
+SampleRowKeysResponse = _reflection.GeneratedProtocolMessageType(
+    "SampleRowKeysResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAMPLEROWKEYSRESPONSE,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Response message for Bigtable.SampleRowKeys.
+  
+  
+  Attributes:
+      row_key:
+          Sorted streamed sequence of sample row keys in the table. The
+          table might have contents before the first row key in the list
+          and after the last one, but a key containing the empty string
+          indicates "end of table" and will be the last response given,
+          if present. Note that row keys in this list may not have ever
+          been written to or read from, and users should therefore not
+          make any assumptions about the row key structure that are
+          specific to their use case.
+      offset_bytes:
+          Approximate total storage space used by all rows in the table
+          which precede ``row_key``. Buffering the contents of all rows
+          between two subsequent samples would require space roughly
+          equal to the difference in their ``offset_bytes`` fields.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.SampleRowKeysResponse)
+    ),
+)
+_sym_db.RegisterMessage(SampleRowKeysResponse)
+
+MutateRowRequest = _reflection.GeneratedProtocolMessageType(
+    "MutateRowRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MUTATEROWREQUEST,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Request message for Bigtable.MutateRow.
+  
+  
+  Attributes:
+      table_name:
+          The unique name of the table to which the mutation should be
+          applied. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      app_profile_id:
+          This value specifies routing for replication. If not
+          specified, the "default" application profile will be used.
+      row_key:
+          The key of the row to which the mutation should be applied.
+      mutations:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowRequest)
+    ),
+)
+_sym_db.RegisterMessage(MutateRowRequest)
+
+MutateRowResponse = _reflection.GeneratedProtocolMessageType(
+    "MutateRowResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MUTATEROWRESPONSE,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Response message for Bigtable.MutateRow.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowResponse)
+    ),
+)
+_sym_db.RegisterMessage(MutateRowResponse)
+
+MutateRowsRequest = _reflection.GeneratedProtocolMessageType(
+    "MutateRowsRequest",
+    (_message.Message,),
+    dict(
+        Entry=_reflection.GeneratedProtocolMessageType(
+            "Entry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATEROWSREQUEST_ENTRY,
+                __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+                __doc__="""Attributes:
+        row_key:
+            The key of the row to which the ``mutations`` should be
+            applied.
+        mutations:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsRequest.Entry)
+            ),
+        ),
+        DESCRIPTOR=_MUTATEROWSREQUEST,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Request message for BigtableService.MutateRows.
+  
+  
+  Attributes:
+      table_name:
+          The unique name of the table to which the mutations should be
+          applied.
+      app_profile_id:
+          This value specifies routing for replication. If not
+          specified, the "default" application profile will be used.
+      entries:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsRequest)
+    ),
+)
+_sym_db.RegisterMessage(MutateRowsRequest)
+_sym_db.RegisterMessage(MutateRowsRequest.Entry)
+
+MutateRowsResponse = _reflection.GeneratedProtocolMessageType(
+    "MutateRowsResponse",
+    (_message.Message,),
+    dict(
+        Entry=_reflection.GeneratedProtocolMessageType(
+            "Entry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATEROWSRESPONSE_ENTRY,
+                __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+                __doc__="""Attributes:
+        index:
+            The index into the original request's ``entries`` list of the
+            Entry for which a result is being reported.
+        status:
+            The result of the request Entry identified by ``index``.
+            Depending on how requests are batched during execution, it is
+            possible for one Entry to fail due to an error with another
+            Entry. In the event that this occurs, the same error will be
+            reported for both entries.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsResponse.Entry)
+            ),
+        ),
+        DESCRIPTOR=_MUTATEROWSRESPONSE,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Response message for BigtableService.MutateRows.
+  
+  
+  Attributes:
+      entries:
+          One or more results for Entries from the batch request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsResponse)
+    ),
+)
+_sym_db.RegisterMessage(MutateRowsResponse)
+_sym_db.RegisterMessage(MutateRowsResponse.Entry)
+
+CheckAndMutateRowRequest = _reflection.GeneratedProtocolMessageType(
+    "CheckAndMutateRowRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHECKANDMUTATEROWREQUEST,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Request message for Bigtable.CheckAndMutateRow.
+  
+  
+  Attributes:
+      table_name:
+          The unique name of the table to which the conditional mutation
+          should be applied. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      app_profile_id:
+          This value specifies routing for replication. If not
+          specified, the "default" application profile will be used.
+      row_key:
+          The key of the row to which the conditional mutation should be
+          applied.
+      predicate_filter:
+          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 ``false_mutations`` will be executed. If
+          unset, checks that the row contains any values at all.
+      true_mutations:
+          Changes to be atomically applied to the specified row if
+          ``predicate_filter`` yields at least one cell when applied to
+          ``row_key``. Entries are applied in order, meaning that
+          earlier mutations can be masked by later ones. Must contain at
+          least one entry if ``false_mutations`` is empty, and at most
+          100000.
+      false_mutations:
+          Changes to be atomically applied to the specified row if
+          ``predicate_filter`` does not yield any cells when applied to
+          ``row_key``. Entries are applied in order, meaning that
+          earlier mutations can be masked by later ones. Must contain at
+          least one entry if ``true_mutations`` is empty, and at most
+          100000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.CheckAndMutateRowRequest)
+    ),
+)
+_sym_db.RegisterMessage(CheckAndMutateRowRequest)
+
+CheckAndMutateRowResponse = _reflection.GeneratedProtocolMessageType(
+    "CheckAndMutateRowResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHECKANDMUTATEROWRESPONSE,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Response message for Bigtable.CheckAndMutateRow.
+  
+  
+  Attributes:
+      predicate_matched:
+          Whether or not the request's ``predicate_filter`` yielded any
+          results for the specified row.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.CheckAndMutateRowResponse)
+    ),
+)
+_sym_db.RegisterMessage(CheckAndMutateRowResponse)
+
+ReadModifyWriteRowRequest = _reflection.GeneratedProtocolMessageType(
+    "ReadModifyWriteRowRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READMODIFYWRITEROWREQUEST,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Request message for Bigtable.ReadModifyWriteRow.
+  
+  
+  Attributes:
+      table_name:
+          The unique name of the table to which the read/modify/write
+          rules should be applied. Values are of the form
+          ``projects/<project>/instances/<instance>/tables/<table>``.
+      app_profile_id:
+          This value specifies routing for replication. If not
+          specified, the "default" application profile will be used.
+      row_key:
+          The key of the row to which the read/modify/write rules should
+          be applied.
+      rules:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadModifyWriteRowRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReadModifyWriteRowRequest)
+
+ReadModifyWriteRowResponse = _reflection.GeneratedProtocolMessageType(
+    "ReadModifyWriteRowResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READMODIFYWRITEROWRESPONSE,
+        __module__="google.cloud.bigtable_v2.proto.bigtable_pb2",
+        __doc__="""Response message for Bigtable.ReadModifyWriteRow.
+  
+  
+  Attributes:
+      row:
+          A Row containing the new contents of all cells modified by the
+          request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadModifyWriteRowResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReadModifyWriteRowResponse)
+
+
+DESCRIPTOR._options = None
+
+_BIGTABLE = _descriptor.ServiceDescriptor(
+    name="Bigtable",
+    full_name="google.bigtable.v2.Bigtable",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1912,
+    serialized_end=2981,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ReadRows",
+            full_name="google.bigtable.v2.Bigtable.ReadRows",
+            index=0,
+            containing_service=None,
+            input_type=_READROWSREQUEST,
+            output_type=_READROWSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002>"9/v2/{table_name=projects/*/instances/*/tables/*}:readRows:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SampleRowKeys",
+            full_name="google.bigtable.v2.Bigtable.SampleRowKeys",
+            index=1,
+            containing_service=None,
+            input_type=_SAMPLEROWKEYSREQUEST,
+            output_type=_SAMPLEROWKEYSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v2/{table_name=projects/*/instances/*/tables/*}:sampleRowKeys"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="MutateRow",
+            full_name="google.bigtable.v2.Bigtable.MutateRow",
+            index=2,
+            containing_service=None,
+            input_type=_MUTATEROWREQUEST,
+            output_type=_MUTATEROWRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v2/{table_name=projects/*/instances/*/tables/*}:mutateRow:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="MutateRows",
+            full_name="google.bigtable.v2.Bigtable.MutateRows",
+            index=3,
+            containing_service=None,
+            input_type=_MUTATEROWSREQUEST,
+            output_type=_MUTATEROWSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v2/{table_name=projects/*/instances/*/tables/*}:mutateRows:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CheckAndMutateRow",
+            full_name="google.bigtable.v2.Bigtable.CheckAndMutateRow",
+            index=4,
+            containing_service=None,
+            input_type=_CHECKANDMUTATEROWREQUEST,
+            output_type=_CHECKANDMUTATEROWRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002G"B/v2/{table_name=projects/*/instances/*/tables/*}:checkAndMutateRow:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ReadModifyWriteRow",
+            full_name="google.bigtable.v2.Bigtable.ReadModifyWriteRow",
+            index=5,
+            containing_service=None,
+            input_type=_READMODIFYWRITEROWREQUEST,
+            output_type=_READMODIFYWRITEROWRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002H"C/v2/{table_name=projects/*/instances/*/tables/*}:readModifyWriteRow:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_BIGTABLE)
+
+DESCRIPTOR.services_by_name["Bigtable"] = _BIGTABLE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_pb2_grpc.py b/bigtable/google/cloud/bigtable_v2/proto/bigtable_pb2_grpc.py
new file mode 100644
index 000000000000..4dd6cded9bc4
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_pb2_grpc.py
@@ -0,0 +1,148 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.bigtable_v2.proto import (
+    bigtable_pb2 as google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2,
+)
+
+
+class BigtableStub(object):
+    """Service for reading from and writing to existing Bigtable tables.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ReadRows = channel.unary_stream(
+            "/google.bigtable.v2.Bigtable/ReadRows",
+            request_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadRowsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadRowsResponse.FromString,
+        )
+        self.SampleRowKeys = channel.unary_stream(
+            "/google.bigtable.v2.Bigtable/SampleRowKeys",
+            request_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.SampleRowKeysRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.SampleRowKeysResponse.FromString,
+        )
+        self.MutateRow = channel.unary_unary(
+            "/google.bigtable.v2.Bigtable/MutateRow",
+            request_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowResponse.FromString,
+        )
+        self.MutateRows = channel.unary_stream(
+            "/google.bigtable.v2.Bigtable/MutateRows",
+            request_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowsResponse.FromString,
+        )
+        self.CheckAndMutateRow = channel.unary_unary(
+            "/google.bigtable.v2.Bigtable/CheckAndMutateRow",
+            request_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.CheckAndMutateRowRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.CheckAndMutateRowResponse.FromString,
+        )
+        self.ReadModifyWriteRow = channel.unary_unary(
+            "/google.bigtable.v2.Bigtable/ReadModifyWriteRow",
+            request_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadModifyWriteRowRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadModifyWriteRowResponse.FromString,
+        )
+
+
+class BigtableServicer(object):
+    """Service for reading from and writing to existing Bigtable tables.
+  """
+
+    def ReadRows(self, request, context):
+        """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
+    atomicity of each row will still be preserved. See the
+    ReadRowsResponse documentation for details.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SampleRowKeys(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def MutateRow(self, request, context):
+        """Mutates a row atomically. Cells already present in the row are left
+    unchanged unless explicitly changed by `mutation`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def MutateRows(self, request, context):
+        """Mutates multiple rows in a batch. Each individual row is mutated
+    atomically as in MutateRow, but the entire batch is not executed
+    atomically.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CheckAndMutateRow(self, request, context):
+        """Mutates a row atomically based on the output of a predicate Reader filter.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ReadModifyWriteRow(self, request, context):
+        """Modifies a row atomically on the server. The method reads the latest
+    existing timestamp and value from the specified columns and writes a new
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_BigtableServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ReadRows": grpc.unary_stream_rpc_method_handler(
+            servicer.ReadRows,
+            request_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadRowsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadRowsResponse.SerializeToString,
+        ),
+        "SampleRowKeys": grpc.unary_stream_rpc_method_handler(
+            servicer.SampleRowKeys,
+            request_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.SampleRowKeysRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.SampleRowKeysResponse.SerializeToString,
+        ),
+        "MutateRow": grpc.unary_unary_rpc_method_handler(
+            servicer.MutateRow,
+            request_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowResponse.SerializeToString,
+        ),
+        "MutateRows": grpc.unary_stream_rpc_method_handler(
+            servicer.MutateRows,
+            request_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.MutateRowsResponse.SerializeToString,
+        ),
+        "CheckAndMutateRow": grpc.unary_unary_rpc_method_handler(
+            servicer.CheckAndMutateRow,
+            request_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.CheckAndMutateRowRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.CheckAndMutateRowResponse.SerializeToString,
+        ),
+        "ReadModifyWriteRow": grpc.unary_unary_rpc_method_handler(
+            servicer.ReadModifyWriteRow,
+            request_deserializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadModifyWriteRowRequest.FromString,
+            response_serializer=google_dot_cloud_dot_bigtable__v2_dot_proto_dot_bigtable__pb2.ReadModifyWriteRowResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.bigtable.v2.Bigtable", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_service.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_service.proto
new file mode 100644
index 000000000000..b1f729517a47
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_service.proto
@@ -0,0 +1,91 @@
+// 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.bigtable.v1;
+
+import "google/api/annotations.proto";
+import "google/bigtable/v1/bigtable_data.proto";
+import "google/bigtable/v1/bigtable_service_messages.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/v1;bigtable";
+option java_generic_services = true;
+option java_multiple_files = true;
+option java_outer_classname = "BigtableServicesProto";
+option java_package = "com.google.bigtable.v1";
+
+
+// Service for reading from and writing to existing Bigtables.
+service BigtableService {
+  // Streams back the contents of all requested rows, optionally applying
+  // the same Reader filter to each. Depending on their size, rows may be
+  // broken up across multiple responses, but atomicity of each row will still
+  // be preserved.
+  rpc ReadRows(ReadRowsRequest) returns (stream ReadRowsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}/rows:read"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      get: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}/rows:sampleKeys"
+    };
+  }
+
+  // Mutates a row atomically. Cells already present in the row are left
+  // unchanged unless explicitly changed by 'mutation'.
+  rpc MutateRow(MutateRowRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}/rows/{row_key}:mutate"
+      body: "*"
+    };
+  }
+
+  // Mutates multiple rows in a batch. Each individual row is mutated
+  // atomically as in MutateRow, but the entire batch is not executed
+  // atomically.
+  rpc MutateRows(MutateRowsRequest) returns (MutateRowsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}:mutateRows"
+      body: "*"
+    };
+  }
+
+  // Mutates a row atomically based on the output of a predicate Reader filter.
+  rpc CheckAndMutateRow(CheckAndMutateRowRequest) returns (CheckAndMutateRowResponse) {
+    option (google.api.http) = {
+      post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}/rows/{row_key}:checkAndMutate"
+      body: "*"
+    };
+  }
+
+  // Modifies a row atomically, reading the latest existing timestamp/value from
+  // the specified columns and writing a new value at
+  // max(existing timestamp, current server time) based on pre-defined
+  // read/modify/write rules. Returns the new contents of all modified cells.
+  rpc ReadModifyWriteRow(ReadModifyWriteRowRequest) returns (Row) {
+    option (google.api.http) = {
+      post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}/rows/{row_key}:readModifyWrite"
+      body: "*"
+    };
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_service_messages.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_service_messages.proto
new file mode 100644
index 000000000000..d734ececaec3
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_service_messages.proto
@@ -0,0 +1,218 @@
+// 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.bigtable.v1;
+
+import "google/bigtable/v1/bigtable_data.proto";
+import "google/rpc/status.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/v1;bigtable";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableServiceMessagesProto";
+option java_package = "com.google.bigtable.v1";
+
+
+// Request message for BigtableServer.ReadRows.
+message ReadRowsRequest {
+  // The unique name of the table from which to read.
+  string table_name = 1;
+
+  // If neither row_key nor row_range is set, reads from all rows.
+  oneof target {
+    // The key of a single row from which to read.
+    bytes row_key = 2;
+
+    // A range of rows from which to read.
+    RowRange row_range = 3;
+
+    // A set of rows from which to read. Entries need not be in order, and will
+    // be deduplicated before reading.
+    // The total serialized size of the set must not exceed 1MB.
+    RowSet row_set = 8;
+  }
+
+  // The filter to apply to the contents of the specified row(s). If unset,
+  // reads the entire table.
+  RowFilter filter = 5;
+
+  // By default, rows are read sequentially, producing results which are
+  // guaranteed to arrive in increasing row order. Setting
+  // "allow_row_interleaving" to true allows multiple rows to be interleaved in
+  // the response stream, which increases throughput but breaks this guarantee,
+  // and may force the client to use more memory to buffer partially-received
+  // rows. Cannot be set to true when specifying "num_rows_limit".
+  bool allow_row_interleaving = 6;
+
+  // The read will terminate after committing to N rows' worth of results. The
+  // default (zero) is to return all results.
+  // Note that "allow_row_interleaving" cannot be set to true when this is set.
+  int64 num_rows_limit = 7;
+}
+
+// Response message for BigtableService.ReadRows.
+message ReadRowsResponse {
+  // Specifies a piece of a row's contents returned as part of the read
+  // response stream.
+  message Chunk {
+    oneof chunk {
+      // A subset of the data from a particular row. As long as no "reset_row"
+      // is received in between, multiple "row_contents" from the same row are
+      // from the same atomic view of that row, and will be received in the
+      // expected family/column/timestamp order.
+      Family row_contents = 1;
+
+      // Indicates that the client should drop all previous chunks for
+      // "row_key", as it will be re-read from the beginning.
+      bool reset_row = 2;
+
+      // Indicates that the client can safely process all previous chunks for
+      // "row_key", as its data has been fully read.
+      bool commit_row = 3;
+    }
+  }
+
+  // The key of the row for which we're receiving data.
+  // Results will be received in increasing row key order, unless
+  // "allow_row_interleaving" was specified in the request.
+  bytes row_key = 1;
+
+  // One or more chunks of the row specified by "row_key".
+  repeated Chunk chunks = 2;
+}
+
+// Request message for BigtableService.SampleRowKeys.
+message SampleRowKeysRequest {
+  // The unique name of the table from which to sample row keys.
+  string table_name = 1;
+}
+
+// Response message for BigtableService.SampleRowKeys.
+message SampleRowKeysResponse {
+  // Sorted streamed sequence of sample row keys in the table. The table might
+  // have contents before the first row key in the list and after the last one,
+  // but a key containing the empty string indicates "end of table" and will be
+  // the last response given, if present.
+  // Note that row keys in this list may not have ever been written to or read
+  // from, and users should therefore not make any assumptions about the row key
+  // structure that are specific to their use case.
+  bytes row_key = 1;
+
+  // Approximate total storage space used by all rows in the table which precede
+  // "row_key". Buffering the contents of all rows between two subsequent
+  // samples would require space roughly equal to the difference in their
+  // "offset_bytes" fields.
+  int64 offset_bytes = 2;
+}
+
+// Request message for BigtableService.MutateRow.
+message MutateRowRequest {
+  // The unique name of the table to which the mutation should be applied.
+  string table_name = 1;
+
+  // The key of the row to which the mutation should be applied.
+  bytes row_key = 2;
+
+  // 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;
+}
+
+// Request message for BigtableService.MutateRows.
+message MutateRowsRequest {
+  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
+    // applied in order, meaning that earlier mutations can be masked by
+    // later ones.
+    // At least one mutation must be specified.
+    repeated Mutation mutations = 2;
+  }
+
+  // The unique name of the table to which the mutations should be applied.
+  string table_name = 1;
+
+  // The row keys/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 may
+  // contain at most 100000 mutations.
+  repeated Entry entries = 2;
+}
+
+// Response message for BigtableService.MutateRows.
+message MutateRowsResponse {
+  // The results for each Entry from the request, presented in the order
+  // in which the entries were originally given.
+  // Depending on how requests are batched during execution, it is possible
+  // for one Entry to fail due to an error with another Entry. In the event
+  // that this occurs, the same error will be reported for both entries.
+  repeated google.rpc.Status statuses = 1;
+}
+
+// Request message for BigtableService.CheckAndMutateRowRequest
+message CheckAndMutateRowRequest {
+  // The unique name of the table to which the conditional mutation should be
+  // applied.
+  string table_name = 1;
+
+  // The key of the row to which the conditional mutation should be applied.
+  bytes row_key = 2;
+
+  // 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
+  // "false_mutations" will be executed. If unset, checks that the row contains
+  // any values at all.
+  RowFilter predicate_filter = 6;
+
+  // Changes to be atomically applied to the specified row if "predicate_filter"
+  // yields at least one cell when applied to "row_key". Entries are applied in
+  // order, meaning that earlier mutations can be masked by later ones.
+  // Must contain at least one entry if "false_mutations" is empty, and at most
+  // 100000.
+  repeated Mutation true_mutations = 4;
+
+  // Changes to be atomically applied to the specified row if "predicate_filter"
+  // does not yield any cells when applied to "row_key". Entries are applied in
+  // order, meaning that earlier mutations can be masked by later ones.
+  // Must contain at least one entry if "true_mutations" is empty, and at most
+  // 100000.
+  repeated Mutation false_mutations = 5;
+}
+
+// Response message for BigtableService.CheckAndMutateRowRequest.
+message CheckAndMutateRowResponse {
+  // Whether or not the request's "predicate_filter" yielded any results for
+  // the specified row.
+  bool predicate_matched = 1;
+}
+
+// Request message for BigtableService.ReadModifyWriteRowRequest.
+message ReadModifyWriteRowRequest {
+  // The unique name of the table to which the read/modify/write rules should be
+  // applied.
+  string table_name = 1;
+
+  // The key of the row to which the read/modify/write rules should be applied.
+  bytes row_key = 2;
+
+  // 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;
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_admin.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_admin.proto
new file mode 100644
index 000000000000..2d5bddf302aa
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_admin.proto
@@ -0,0 +1,525 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/v2/table.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableAdminProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+
+// Service for creating, configuring, and deleting Cloud Bigtable tables.
+//
+//
+// Provides access to the table schemas only, not the data stored within
+// the tables.
+service BigtableTableAdmin {
+  // 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.
+  rpc CreateTable(CreateTableRequest) returns (Table) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/tables"
+      body: "*"
+    };
+  }
+
+  // Creates a new table from the specified snapshot. The target table must
+  // not exist. The snapshot and the table must be in the same instance.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc CreateTableFromSnapshot(CreateTableFromSnapshotRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/instances/*}/tables:createFromSnapshot"
+      body: "*"
+    };
+  }
+
+  // Lists all tables served from a specified instance.
+  rpc ListTables(ListTablesRequest) returns (ListTablesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*}/tables"
+    };
+  }
+
+  // Gets metadata information about the specified table.
+  rpc GetTable(GetTableRequest) returns (Table) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/tables/*}"
+    };
+  }
+
+  // Permanently deletes a specified table and all of its data.
+  rpc DeleteTable(DeleteTableRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/tables/*}"
+    };
+  }
+
+  // Performs a series of column family modifications on the specified table.
+  // Either all or none of the modifications will occur before this method
+  // returns, but data requests received prior to that point may see a table
+  // where only some modifications have taken effect.
+  rpc ModifyColumnFamilies(ModifyColumnFamiliesRequest) returns (Table) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies"
+      body: "*"
+    };
+  }
+
+  // Permanently drop/delete a row range from a specified table. The request can
+  // specify whether to delete all rows in a table, or only those that match a
+  // particular prefix.
+  rpc DropRowRange(DropRowRangeRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:dropRowRange"
+      body: "*"
+    };
+  }
+
+  // Generates a consistency token for a Table, which can be used in
+  // CheckConsistency to check whether mutations to the table that finished
+  // before this call started have been replicated. The tokens will be available
+  // for 90 days.
+  rpc GenerateConsistencyToken(GenerateConsistencyTokenRequest) returns (GenerateConsistencyTokenResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:generateConsistencyToken"
+      body: "*"
+    };
+  }
+
+  // Checks replication consistency based on a consistency token, that is, if
+  // replication has caught up based on the conditions specified in the token
+  // and the check request.
+  rpc CheckConsistency(CheckConsistencyRequest) returns (CheckConsistencyResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:checkConsistency"
+      body: "*"
+    };
+  }
+
+  // Creates a new snapshot in the specified cluster from the specified
+  // source table. The cluster and the table must be in the same instance.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc SnapshotTable(SnapshotTableRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/instances/*/tables/*}:snapshot"
+      body: "*"
+    };
+  }
+
+  // Gets metadata information about the specified snapshot.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc GetSnapshot(GetSnapshotRequest) returns (Snapshot) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}"
+    };
+  }
+
+  // Lists all snapshots associated with the specified cluster.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc ListSnapshots(ListSnapshotsRequest) returns (ListSnapshotsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/instances/*/clusters/*}/snapshots"
+    };
+  }
+
+  // Permanently deletes the specified snapshot.
+  //
+  // Note: This is a private alpha release of Cloud Bigtable snapshots. This
+  // feature is not currently available to most Cloud Bigtable customers. This
+  // 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.
+  rpc DeleteSnapshot(DeleteSnapshotRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}"
+    };
+  }
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.CreateTable][google.bigtable.admin.v2.BigtableTableAdmin.CreateTable]
+message CreateTableRequest {
+  // An initial split point for a newly created table.
+  message Split {
+    // Row key to use as an initial tablet boundary.
+    bytes key = 1;
+  }
+
+  // The unique name of the instance in which to create the table.
+  // Values are of the form `projects/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // The Table to create.
+  Table table = 3;
+
+  // The optional list of row keys that will be used to initially split the
+  // table into several tablets (tablets are similar to HBase regions).
+  // Given two split keys, `s1` and `s2`, three tablets will be created,
+  // spanning the key ranges: `[, s1), [s1, s2), [s2, )`.
+  //
+  // Example:
+  //
+  // * Row keys := `["a", "apple", "custom", "customer_1", "customer_2",`
+  //                `"other", "zz"]`
+  // * initial_split_keys := `["apple", "customer_1", "customer_2", "other"]`
+  // * Key assignment:
+  //     - Tablet 1 `[, apple)                => {"a"}.`
+  //     - Tablet 2 `[apple, customer_1)      => {"apple", "custom"}.`
+  //     - Tablet 3 `[customer_1, customer_2) => {"customer_1"}.`
+  //     - Tablet 4 `[customer_2, other)      => {"customer_2"}.`
+  //     - Tablet 5 `[other, )                => {"other", "zz"}.`
+  repeated Split initial_splits = 4;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // Delete all rows or by prefix.
+  oneof target {
+    // Delete all rows that start with this row key prefix. Prefix cannot be
+    // zero length.
+    bytes row_key_prefix = 2;
+
+    // Delete all rows in the table. Setting this to false is a no-op.
+    bool delete_all_data_from_table = 3;
+  }
+}
+
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // The view to be applied to the returned tables' fields.
+  // Defaults to `NAME_ONLY` if unspecified; no others are currently supported.
+  Table.View view = 2;
+
+  // Maximum number of results per page.
+  // CURRENTLY UNIMPLEMENTED AND IGNORED.
+  int32 page_size = 4;
+
+  // The value of `next_page_token` returned by a previous call.
+  string page_token = 3;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ListTables][google.bigtable.admin.v2.BigtableTableAdmin.ListTables]
+message ListTablesResponse {
+  // The tables present in the requested instance.
+  repeated Table tables = 1;
+
+  // Set if not all tables could be returned in a single response.
+  // Pass this value to `page_token` in another request to get the next
+  // page of results.
+  string next_page_token = 2;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.GetTable][google.bigtable.admin.v2.BigtableTableAdmin.GetTable]
+message GetTableRequest {
+  // The unique name of the requested table.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // The view to be applied to the returned table's fields.
+  // Defaults to `SCHEMA_VIEW` if unspecified.
+  Table.View view = 2;
+}
+
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies][google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies]
+message ModifyColumnFamiliesRequest {
+  // A create, update, or delete of a particular column family.
+  message Modification {
+    // The ID of the column family to be modified.
+    string id = 1;
+
+    // Column familiy modifications.
+    oneof mod {
+      // Create a new column family with the specified schema, or fail if
+      // one already exists with the given ID.
+      ColumnFamily create = 2;
+
+      // Update an existing column family to the specified schema, or fail
+      // if no column family exists with the given ID.
+      ColumnFamily update = 3;
+
+      // Drop (delete) the column family with the given ID, or fail if no such
+      // family exists.
+      bool drop = 4;
+    }
+  }
+
+  // The unique name of the table whose families should be modified.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  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;
+}
+
+// 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/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken][google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken]
+message GenerateConsistencyTokenResponse {
+  // The generated consistency token.
+  string consistency_token = 1;
+}
+
+// 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/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // The token created using GenerateConsistencyToken for the Table.
+  string consistency_token = 2;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency][google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency]
+message CheckConsistencyResponse {
+  // True only if the token is consistent. A token is consistent if replication
+  // has caught up with the restrictions specified in the request.
+  bool consistent = 1;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable][google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/tables/<table>`.
+  string name = 1;
+
+  // The name of the cluster where the snapshot will be created in.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>`.
+  string cluster = 2;
+
+  // 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;
+
+  // 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
+  // amount of time a snapshot can stay active is 7 days. If 'ttl' is not
+  // specified, the default value of 24 hours will be used.
+  google.protobuf.Duration ttl = 4;
+
+  // Description of the snapshot.
+  string description = 5;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+  string name = 1;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots][google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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/<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;
+
+  // The maximum number of snapshots to return per page.
+  // CURRENTLY UNIMPLEMENTED AND IGNORED.
+  int32 page_size = 2;
+
+  // The value of `next_page_token` returned by a previous call.
+  string page_token = 3;
+}
+
+// Response message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots][google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 ListSnapshotsResponse {
+  // The snapshots present in the requested cluster.
+  repeated Snapshot snapshots = 1;
+
+  // Set if not all snapshots could be returned in a single response.
+  // Pass this value to `page_token` in another request to get the next
+  // page of results.
+  string next_page_token = 2;
+}
+
+// Request message for
+// [google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot][google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot]
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+  string name = 1;
+}
+
+// The metadata for the Operation returned by SnapshotTable.
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 SnapshotTableMetadata {
+  // The request that prompted the initiation of this SnapshotTable operation.
+  SnapshotTableRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
+
+// The metadata for the Operation returned by CreateTableFromSnapshot.
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 CreateTableFromSnapshotMetadata {
+  // The request that prompted the initiation of this CreateTableFromSnapshot
+  // operation.
+  CreateTableFromSnapshotRequest original_request = 1;
+
+  // The time at which the original request was received.
+  google.protobuf.Timestamp request_time = 2;
+
+  // The time at which the operation failed or was completed successfully.
+  google.protobuf.Timestamp finish_time = 3;
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_data.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_data.proto
new file mode 100644
index 000000000000..e4efb74f560e
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_data.proto
@@ -0,0 +1,126 @@
+// 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.bigtable.admin.table.v1;
+
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/table/v1;table";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableDataProto";
+option java_package = "com.google.bigtable.admin.table.v1";
+
+
+// A collection of user data indexed by row, column, and timestamp.
+// Each table is served using the resources of its parent cluster.
+message Table {
+  enum TimestampGranularity {
+    MILLIS = 0;
+  }
+
+  // A unique identifier of the form
+  // <cluster_name>/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*
+  string name = 1;
+
+  // If this Table is in the process of being created, the Operation used to
+  // track its progress. As long as this operation is present, the Table will
+  // not accept any Table Admin or Read/Write requests.
+  google.longrunning.Operation current_operation = 2;
+
+  // The column families configured for this table, mapped by column family id.
+  map<string, ColumnFamily> column_families = 3;
+
+  // The granularity (e.g. MILLIS, MICROS) at which timestamps are stored in
+  // this table. Timestamps not matching the granularity will be rejected.
+  // Cannot be changed once the table is created.
+  TimestampGranularity granularity = 4;
+}
+
+// A set of columns within a table which share a common configuration.
+message ColumnFamily {
+  // A unique identifier of the form <table_name>/columnFamilies/[-_.a-zA-Z0-9]+
+  // The last segment is the same as the "name" field in
+  // google.bigtable.v1.Family.
+  string name = 1;
+
+  // Garbage collection expression specified by the following grammar:
+  //   GC = EXPR
+  //      | "" ;
+  //   EXPR = EXPR, "||", EXPR              (* lowest precedence *)
+  //        | EXPR, "&&", EXPR
+  //        | "(", EXPR, ")"                (* highest precedence *)
+  //        | PROP ;
+  //   PROP = "version() >", NUM32
+  //        | "age() >", NUM64, [ UNIT ] ;
+  //   NUM32 = non-zero-digit { digit } ;    (* # NUM32 <= 2^32 - 1 *)
+  //   NUM64 = non-zero-digit { digit } ;    (* # NUM64 <= 2^63 - 1 *)
+  //   UNIT =  "d" | "h" | "m"  (* d=days, h=hours, m=minutes, else micros *)
+  // GC expressions can be up to 500 characters in length
+  //
+  // The different types of PROP are defined as follows:
+  //   version() - cell index, counting from most recent and starting at 1
+  //   age() - age of the cell (current time minus cell timestamp)
+  //
+  // Example: "version() > 3 || (age() > 3d && version() > 1)"
+  //   drop cells beyond the most recent three, and drop cells older than three
+  //   days unless they're the most recent cell in the row/column
+  //
+  // Garbage collection executes opportunistically in the background, and so
+  // it's possible for reads to return a cell even if it matches the active GC
+  // expression for its family.
+  string gc_expression = 2;
+
+  // Garbage collection rule specified as a protobuf.
+  // Supersedes `gc_expression`.
+  // Must serialize to at most 500 bytes.
+  //
+  // NOTE: Garbage collection executes opportunistically in the background, and
+  // so it's possible for reads to return a cell even if it matches the active
+  // GC expression for its family.
+  GcRule gc_rule = 3;
+}
+
+// Rule for determining which cells to delete during garbage collection.
+message GcRule {
+  // A GcRule which deletes cells matching all of the given rules.
+  message Intersection {
+    // Only delete cells which would be deleted by every element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  // A GcRule which deletes cells matching any of the given rules.
+  message Union {
+    // Delete cells which would be deleted by any element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  oneof rule {
+    // Delete all cells in a column except the most recent N.
+    int32 max_num_versions = 1;
+
+    // Delete cells in a column older than the given age.
+    // Values must be at least one millisecond, and will be truncated to
+    // microsecond granularity.
+    google.protobuf.Duration max_age = 2;
+
+    // Delete cells that would be deleted by every nested rule.
+    Intersection intersection = 3;
+
+    // Delete cells that would be deleted by any nested rule.
+    Union union = 4;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_service.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_service.proto
new file mode 100644
index 000000000000..6e968fee17c1
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_service.proto
@@ -0,0 +1,80 @@
+// 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.bigtable.admin.table.v1;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/table/v1/bigtable_table_data.proto";
+import "google/bigtable/admin/table/v1/bigtable_table_service_messages.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/table/v1;table";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableServicesProto";
+option java_package = "com.google.bigtable.admin.table.v1";
+
+
+// Service for creating, configuring, and deleting Cloud Bigtable tables.
+// Provides access to the table schemas only, not the data stored within the tables.
+service BigtableTableService {
+  // Creates a new table, to be served from a specified cluster.
+  // The table can be created with a full set of initial column families,
+  // specified in the request.
+  rpc CreateTable(CreateTableRequest) returns (Table) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*}/tables" body: "*" };
+  }
+
+  // Lists the names of all tables served from a specified cluster.
+  rpc ListTables(ListTablesRequest) returns (ListTablesResponse) {
+    option (google.api.http) = { get: "/v1/{name=projects/*/zones/*/clusters/*}/tables" };
+  }
+
+  // Gets the schema of the specified table, including its column families.
+  rpc GetTable(GetTableRequest) returns (Table) {
+    option (google.api.http) = { get: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}" };
+  }
+
+  // Permanently deletes a specified table and all of its data.
+  rpc DeleteTable(DeleteTableRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}" };
+  }
+
+  // Changes the name of a specified table.
+  // Cannot be used to move tables between clusters, zones, or projects.
+  rpc RenameTable(RenameTableRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}:rename" body: "*" };
+  }
+
+  // Creates a new column family within a specified table.
+  rpc CreateColumnFamily(CreateColumnFamilyRequest) returns (ColumnFamily) {
+    option (google.api.http) = { post: "/v1/{name=projects/*/zones/*/clusters/*/tables/*}/columnFamilies" body: "*" };
+  }
+
+  // Changes the configuration of a specified column family.
+  rpc UpdateColumnFamily(ColumnFamily) returns (ColumnFamily) {
+    option (google.api.http) = { put: "/v1/{name=projects/*/zones/*/clusters/*/tables/*/columnFamilies/*}" body: "*" };
+  }
+
+  // Permanently deletes a specified column family and all of its data.
+  rpc DeleteColumnFamily(DeleteColumnFamilyRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v1/{name=projects/*/zones/*/clusters/*/tables/*/columnFamilies/*}" };
+  }
+
+  // Delete all rows in a table corresponding to a particular prefix
+  rpc BulkDeleteRows(BulkDeleteRowsRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { post: "/v1/{table_name=projects/*/zones/*/clusters/*/tables/*}:bulkDeleteRows" body: "*" };
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_service_messages.proto b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_service_messages.proto
new file mode 100644
index 000000000000..617ede65592f
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/bigtable_table_service_messages.proto
@@ -0,0 +1,116 @@
+// 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.bigtable.admin.table.v1;
+
+import "google/bigtable/admin/table/v1/bigtable_table_data.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/table/v1;table";
+option java_multiple_files = true;
+option java_outer_classname = "BigtableTableServiceMessagesProto";
+option java_package = "com.google.bigtable.admin.table.v1";
+
+
+message CreateTableRequest {
+  // The unique name of the cluster in which to create the new table.
+  string name = 1;
+
+  // The name by which the new table should be referred to within the cluster,
+  // e.g. "foobar" rather than "<cluster_name>/tables/foobar".
+  string table_id = 2;
+
+  // The Table to create. The `name` field of the Table and all of its
+  // ColumnFamilies must be left blank, and will be populated in the response.
+  Table table = 3;
+
+  // The optional list of row keys that will be used to initially split the
+  // table into several tablets (Tablets are similar to HBase regions).
+  // Given two split keys, "s1" and "s2", three tablets will be created,
+  // spanning the key ranges: [, s1), [s1, s2), [s2, ).
+  //
+  // Example:
+  //  * Row keys := ["a", "apple", "custom", "customer_1", "customer_2",
+  //                 "other", "zz"]
+  //  * initial_split_keys := ["apple", "customer_1", "customer_2", "other"]
+  //  * Key assignment:
+  //    - Tablet 1 [, apple)                => {"a"}.
+  //    - Tablet 2 [apple, customer_1)      => {"apple", "custom"}.
+  //    - Tablet 3 [customer_1, customer_2) => {"customer_1"}.
+  //    - Tablet 4 [customer_2, other)      => {"customer_2"}.
+  //    - Tablet 5 [other, )                => {"other", "zz"}.
+  repeated string initial_split_keys = 4;
+}
+
+message ListTablesRequest {
+  // The unique name of the cluster for which tables should be listed.
+  string name = 1;
+}
+
+message ListTablesResponse {
+  // The tables present in the requested cluster.
+  // At present, only the names of the tables are populated.
+  repeated Table tables = 1;
+}
+
+message GetTableRequest {
+  // The unique name of the requested table.
+  string name = 1;
+}
+
+message DeleteTableRequest {
+  // The unique name of the table to be deleted.
+  string name = 1;
+}
+
+message RenameTableRequest {
+  // The current unique name of the table.
+  string name = 1;
+
+  // The new name by which the table should be referred to within its containing
+  // cluster, e.g. "foobar" rather than "<cluster_name>/tables/foobar".
+  string new_id = 2;
+}
+
+message CreateColumnFamilyRequest {
+  // The unique name of the table in which to create the new column family.
+  string name = 1;
+
+  // The name by which the new column family should be referred to within the
+  // table, e.g. "foobar" rather than "<table_name>/columnFamilies/foobar".
+  string column_family_id = 2;
+
+  // The column family to create. The `name` field must be left blank.
+  ColumnFamily column_family = 3;
+}
+
+message DeleteColumnFamilyRequest {
+  // The unique name of the column family to be deleted.
+  string name = 1;
+}
+
+message BulkDeleteRowsRequest {
+  // The unique name of the table on which to perform the bulk delete
+  string table_name = 1;
+
+  oneof target {
+    // Delete all rows that start with this row key prefix. Prefix cannot be
+    // zero length.
+    bytes row_key_prefix = 2;
+
+    // Delete all rows in the table. Setting this to false is a no-op.
+    bool delete_all_data_from_table = 3;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/common.proto b/bigtable/google/cloud/bigtable_v2/proto/common.proto
new file mode 100644
index 000000000000..0ece12780eb9
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/common.proto
@@ -0,0 +1,41 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+
+// Storage media types for persisting Bigtable data.
+enum StorageType {
+  // The user did not specify a storage type.
+  STORAGE_TYPE_UNSPECIFIED = 0;
+
+  // Flash (SSD) storage should be used.
+  SSD = 1;
+
+  // Magnetic drive (HDD) storage should be used.
+  HDD = 2;
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/data.proto b/bigtable/google/cloud/bigtable_v2/proto/data.proto
new file mode 100644
index 000000000000..d0aab0b63f12
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/data.proto
@@ -0,0 +1,532 @@
+// 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.bigtable.v2;
+
+option csharp_namespace = "Google.Cloud.Bigtable.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/v2;bigtable";
+option java_multiple_files = true;
+option java_outer_classname = "DataProto";
+option java_package = "com.google.bigtable.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\V2";
+
+// Specifies the complete (requested) contents of a single row of a table.
+// Rows which exceed 256MiB in size cannot be read in full.
+message Row {
+  // The unique key which identifies this row within its table. This is the same
+  // key that's used to identify the row in, for example, a MutateRowRequest.
+  // May contain any non-empty byte string up to 4KiB in length.
+  bytes key = 1;
+
+  // May be empty, but only if the entire row is empty.
+  // The mutual ordering of column families is not specified.
+  repeated Family families = 2;
+}
+
+// Specifies (some of) the contents of a single row/column family intersection
+// of a table.
+message Family {
+  // The unique key which identifies this family within its row. This is the
+  // same key that's used to identify the family in, for example, a RowFilter
+  // which sets its "family_name_regex_filter" field.
+  // Must match `[-_.a-zA-Z0-9]+`, except that AggregatingRowProcessors may
+  // produce cells in a sentinel family with an empty name.
+  // Must be no greater than 64 characters in length.
+  string name = 1;
+
+  // Must not be empty. Sorted in order of increasing "qualifier".
+  repeated Column columns = 2;
+}
+
+// Specifies (some of) the contents of a single row/column intersection of a
+// table.
+message Column {
+  // The unique key which identifies this column within its family. This is the
+  // same key that's used to identify the column in, for example, a RowFilter
+  // which sets its `column_qualifier_regex_filter` field.
+  // May contain any byte string, including the empty string, up to 16kiB in
+  // length.
+  bytes qualifier = 1;
+
+  // Must not be empty. Sorted in order of decreasing "timestamp_micros".
+  repeated Cell cells = 2;
+}
+
+// Specifies (some of) the contents of a single row/column/timestamp of a table.
+message Cell {
+  // The cell's stored timestamp, which also uniquely identifies it within
+  // its column.
+  // Values are always expressed in microseconds, but individual tables may set
+  // a coarser granularity to further restrict the allowed values. For
+  // example, a table which specifies millisecond granularity will only allow
+  // values of `timestamp_micros` which are multiples of 1000.
+  int64 timestamp_micros = 1;
+
+  // The value stored in the cell.
+  // May contain any byte string, including the empty string, up to 100MiB in
+  // length.
+  bytes value = 2;
+
+  // Labels applied to the cell by a [RowFilter][google.bigtable.v2.RowFilter].
+  repeated string labels = 3;
+}
+
+// Specifies a contiguous range of rows.
+message RowRange {
+  // The row key at which to start the range.
+  // If neither field is set, interpreted as the empty string, inclusive.
+  oneof start_key {
+    // Used when giving an inclusive lower bound for the range.
+    bytes start_key_closed = 1;
+
+    // Used when giving an exclusive lower bound for the range.
+    bytes start_key_open = 2;
+  }
+
+  // The row key at which to end the range.
+  // If neither field is set, interpreted as the infinite row key, exclusive.
+  oneof end_key {
+    // Used when giving an exclusive upper bound for the range.
+    bytes end_key_open = 3;
+
+    // Used when giving an inclusive upper bound for the range.
+    bytes end_key_closed = 4;
+  }
+}
+
+// Specifies a non-contiguous set of rows.
+message RowSet {
+  // Single rows included in the set.
+  repeated bytes row_keys = 1;
+
+  // Contiguous row ranges included in the set.
+  repeated RowRange row_ranges = 2;
+}
+
+// Specifies a contiguous range of columns within a single column family.
+// The range spans from &lt;column_family&gt;:&lt;start_qualifier&gt; to
+// &lt;column_family&gt;:&lt;end_qualifier&gt;, where both bounds can be either
+// inclusive or exclusive.
+message ColumnRange {
+  // The name of the column family within which this range falls.
+  string family_name = 1;
+
+  // The column qualifier at which to start the range (within `column_family`).
+  // If neither field is set, interpreted as the empty string, inclusive.
+  oneof start_qualifier {
+    // Used when giving an inclusive lower bound for the range.
+    bytes start_qualifier_closed = 2;
+
+    // Used when giving an exclusive lower bound for the range.
+    bytes start_qualifier_open = 3;
+  }
+
+  // The column qualifier at which to end the range (within `column_family`).
+  // If neither field is set, interpreted as the infinite string, exclusive.
+  oneof end_qualifier {
+    // Used when giving an inclusive upper bound for the range.
+    bytes end_qualifier_closed = 4;
+
+    // Used when giving an exclusive upper bound for the range.
+    bytes end_qualifier_open = 5;
+  }
+}
+
+// Specified a contiguous range of microsecond timestamps.
+message TimestampRange {
+  // Inclusive lower bound. If left empty, interpreted as 0.
+  int64 start_timestamp_micros = 1;
+
+  // Exclusive upper bound. If left empty, interpreted as infinity.
+  int64 end_timestamp_micros = 2;
+}
+
+// Specifies a contiguous range of raw byte values.
+message ValueRange {
+  // The value at which to start the range.
+  // If neither field is set, interpreted as the empty string, inclusive.
+  oneof start_value {
+    // Used when giving an inclusive lower bound for the range.
+    bytes start_value_closed = 1;
+
+    // Used when giving an exclusive lower bound for the range.
+    bytes start_value_open = 2;
+  }
+
+  // The value at which to end the range.
+  // If neither field is set, interpreted as the infinite string, exclusive.
+  oneof end_value {
+    // Used when giving an inclusive upper bound for the range.
+    bytes end_value_closed = 3;
+
+    // Used when giving an exclusive upper bound for the range.
+    bytes end_value_open = 4;
+  }
+}
+
+// Takes a row as input and produces an alternate view of the row based on
+// specified rules. For example, a RowFilter might trim down a row to include
+// just the cells from columns matching a given regular expression, or might
+// return all the cells of a row but not their values. More complicated filters
+// can be composed out of these components to express requests such as, "within
+// every column of a particular family, give just the two most recent cells
+// which are older than timestamp X."
+//
+// There are two broad categories of RowFilters (true filters and transformers),
+// as well as two ways to compose simple filters into more complex ones
+// (chains and interleaves). They work as follows:
+//
+// * True filters alter the input row by excluding some of its cells wholesale
+// from the output row. An example of a true filter is the `value_regex_filter`,
+// which excludes cells whose values don't match the specified pattern. All
+// regex true filters use RE2 syntax (https://github.com/google/re2/wiki/Syntax)
+// in raw byte mode (RE2::Latin1), and are evaluated as full matches. An
+// important point to keep in mind is that `RE2(.)` is equivalent by default to
+// `RE2([^\n])`, meaning that it does not match newlines. When attempting to
+// match an arbitrary byte, you should therefore use the escape sequence `\C`,
+// which may need to be further escaped as `\\C` in your client language.
+//
+// * Transformers alter the input row by changing the values of some of its
+// cells in the output, without excluding them completely. Currently, the only
+// supported transformer is the `strip_value_transformer`, which replaces every
+// cell's value with the empty string.
+//
+// * Chains and interleaves are described in more detail in the
+// RowFilter.Chain and RowFilter.Interleave documentation.
+//
+// The total serialized size of a RowFilter message must not
+// exceed 4096 bytes, and RowFilters may not be nested within each other
+// (in Chains or Interleaves) to a depth of more than 20.
+message RowFilter {
+  // A RowFilter which sends rows through several RowFilters in sequence.
+  message Chain {
+    // The elements of "filters" are chained together to process the input row:
+    // in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
+    // The full chain is executed atomically.
+    repeated RowFilter filters = 1;
+  }
+
+  // A RowFilter which sends each row to each of several component
+  // RowFilters and interleaves the results.
+  message Interleave {
+    // The elements of "filters" all process a copy of the input row, and the
+    // results are pooled, sorted, and combined into a single output row.
+    // If multiple cells are produced with the same column and timestamp,
+    // they will all appear in the output row in an unspecified mutual order.
+    // Consider the following example, with three filters:
+    //
+    //                                  input row
+    //                                      |
+    //            -----------------------------------------------------
+    //            |                         |                         |
+    //           f(0)                      f(1)                      f(2)
+    //            |                         |                         |
+    //     1: foo,bar,10,x             foo,bar,10,z              far,bar,7,a
+    //     2: foo,blah,11,z            far,blah,5,x              far,blah,5,x
+    //            |                         |                         |
+    //            -----------------------------------------------------
+    //                                      |
+    //     1:                      foo,bar,10,z   // could have switched with #2
+    //     2:                      foo,bar,10,x   // could have switched with #1
+    //     3:                      foo,blah,11,z
+    //     4:                      far,bar,7,a
+    //     5:                      far,blah,5,x   // identical to #6
+    //     6:                      far,blah,5,x   // identical to #5
+    //
+    // All interleaved filters are executed atomically.
+    repeated RowFilter filters = 1;
+  }
+
+  // A RowFilter which evaluates one of two possible RowFilters, depending on
+  // whether or not a predicate RowFilter outputs any cells from the input row.
+  //
+  // IMPORTANT NOTE: The predicate filter does not execute atomically with the
+  // true and false filters, which may lead to inconsistent or unexpected
+  // results. Additionally, Condition filters have poor performance, especially
+  // when filters are set for the false condition.
+  message Condition {
+    // If `predicate_filter` outputs any cells, then `true_filter` will be
+    // evaluated on the input row. Otherwise, `false_filter` will be evaluated.
+    RowFilter predicate_filter = 1;
+
+    // The filter to apply to the input row if `predicate_filter` returns any
+    // results. If not provided, no results will be returned in the true case.
+    RowFilter true_filter = 2;
+
+    // The filter to apply to the input row if `predicate_filter` does not
+    // return any results. If not provided, no results will be returned in the
+    // false case.
+    RowFilter false_filter = 3;
+  }
+
+  // Which of the possible RowFilter types to apply. If none are set, this
+  // RowFilter returns all cells in the input row.
+  oneof filter {
+    // Applies several RowFilters to the data in sequence, progressively
+    // narrowing the results.
+    Chain chain = 1;
+
+    // Applies several RowFilters to the data in parallel and combines the
+    // results.
+    Interleave interleave = 2;
+
+    // Applies one of two possible RowFilters to the data based on the output of
+    // a predicate RowFilter.
+    Condition condition = 3;
+
+    // ADVANCED USE ONLY.
+    // Hook for introspection into the RowFilter. Outputs all cells directly to
+    // the output of the read rather than to any parent filter. Consider the
+    // following example:
+    //
+    //     Chain(
+    //       FamilyRegex("A"),
+    //       Interleave(
+    //         All(),
+    //         Chain(Label("foo"), Sink())
+    //       ),
+    //       QualifierRegex("B")
+    //     )
+    //
+    //                         A,A,1,w
+    //                         A,B,2,x
+    //                         B,B,4,z
+    //                            |
+    //                     FamilyRegex("A")
+    //                            |
+    //                         A,A,1,w
+    //                         A,B,2,x
+    //                            |
+    //               +------------+-------------+
+    //               |                          |
+    //             All()                    Label(foo)
+    //               |                          |
+    //            A,A,1,w              A,A,1,w,labels:[foo]
+    //            A,B,2,x              A,B,2,x,labels:[foo]
+    //               |                          |
+    //               |                        Sink() --------------+
+    //               |                          |                  |
+    //               +------------+      x------+          A,A,1,w,labels:[foo]
+    //                            |                        A,B,2,x,labels:[foo]
+    //                         A,A,1,w                             |
+    //                         A,B,2,x                             |
+    //                            |                                |
+    //                    QualifierRegex("B")                      |
+    //                            |                                |
+    //                         A,B,2,x                             |
+    //                            |                                |
+    //                            +--------------------------------+
+    //                            |
+    //                         A,A,1,w,labels:[foo]
+    //                         A,B,2,x,labels:[foo]  // could be switched
+    //                         A,B,2,x               // could be switched
+    //
+    // Despite being excluded by the qualifier filter, a copy of every cell
+    // that reaches the sink is present in the final result.
+    //
+    // As with an [Interleave][google.bigtable.v2.RowFilter.Interleave],
+    // duplicate cells are possible, and appear in an unspecified mutual order.
+    // In this case we have a duplicate with column "A:B" and timestamp 2,
+    // because one copy passed through the all filter while the other was
+    // passed through the label and sink. Note that one copy has label "foo",
+    // while the other does not.
+    //
+    // Cannot be used within the `predicate_filter`, `true_filter`, or
+    // `false_filter` of a [Condition][google.bigtable.v2.RowFilter.Condition].
+    bool sink = 16;
+
+    // Matches all cells, regardless of input. Functionally equivalent to
+    // leaving `filter` unset, but included for completeness.
+    bool pass_all_filter = 17;
+
+    // Does not match any cells, regardless of input. Useful for temporarily
+    // disabling just part of a filter.
+    bool block_all_filter = 18;
+
+    // Matches only cells from rows whose keys satisfy the given RE2 regex. In
+    // other words, passes through the entire row when the key matches, and
+    // otherwise produces an empty row.
+    // Note that, since row keys can contain arbitrary bytes, the `\C` escape
+    // sequence must be used if a true wildcard is desired. The `.` character
+    // will not match the new line character `\n`, which may be present in a
+    // binary key.
+    bytes row_key_regex_filter = 4;
+
+    // Matches all cells from a row with probability p, and matches no cells
+    // from the row with probability 1-p.
+    double row_sample_filter = 14;
+
+    // Matches only cells from columns whose families satisfy the given RE2
+    // regex. For technical reasons, the regex must not contain the `:`
+    // character, even if it is not being used as a literal.
+    // Note that, since column families cannot contain the new line character
+    // `\n`, it is sufficient to use `.` as a full wildcard when matching
+    // column family names.
+    string family_name_regex_filter = 5;
+
+    // Matches only cells from columns whose qualifiers satisfy the given RE2
+    // regex.
+    // Note that, since column qualifiers can contain arbitrary bytes, the `\C`
+    // escape sequence must be used if a true wildcard is desired. The `.`
+    // character will not match the new line character `\n`, which may be
+    // present in a binary qualifier.
+    bytes column_qualifier_regex_filter = 6;
+
+    // Matches only cells from columns within the given range.
+    ColumnRange column_range_filter = 7;
+
+    // Matches only cells with timestamps within the given range.
+    TimestampRange timestamp_range_filter = 8;
+
+    // Matches only cells with values that satisfy the given regular expression.
+    // Note that, since cell values can contain arbitrary bytes, the `\C` escape
+    // sequence must be used if a true wildcard is desired. The `.` character
+    // will not match the new line character `\n`, which may be present in a
+    // binary value.
+    bytes value_regex_filter = 9;
+
+    // Matches only cells with values that fall within the given range.
+    ValueRange value_range_filter = 15;
+
+    // Skips the first N cells of each row, matching all subsequent cells.
+    // If duplicate cells are present, as is possible when using an Interleave,
+    // each copy of the cell is counted separately.
+    int32 cells_per_row_offset_filter = 10;
+
+    // Matches only the first N cells of each row.
+    // If duplicate cells are present, as is possible when using an Interleave,
+    // each copy of the cell is counted separately.
+    int32 cells_per_row_limit_filter = 11;
+
+    // Matches only the most recent N cells within each column. For example,
+    // if N=2, this filter would match column `foo:bar` at timestamps 10 and 9,
+    // skip all earlier cells in `foo:bar`, and then begin matching again in
+    // column `foo:bar2`.
+    // If duplicate cells are present, as is possible when using an Interleave,
+    // each copy of the cell is counted separately.
+    int32 cells_per_column_limit_filter = 12;
+
+    // Replaces each cell's value with the empty string.
+    bool strip_value_transformer = 13;
+
+    // Applies the given label to all cells in the output row. This allows
+    // the client to determine which results were produced from which part of
+    // the filter.
+    //
+    // Values must be at most 15 characters in length, and match the RE2
+    // pattern `[a-z0-9\\-]+`
+    //
+    // Due to a technical limitation, it is not currently possible to apply
+    // multiple labels to a cell. As a result, a Chain may have no more than
+    // one sub-filter which contains a `apply_label_transformer`. It is okay for
+    // an Interleave to contain multiple `apply_label_transformers`, as they
+    // will be applied to separate copies of the input. This may be relaxed in
+    // the future.
+    string apply_label_transformer = 19;
+  }
+}
+
+// Specifies a particular change to be made to the contents of a row.
+message Mutation {
+  // A Mutation which sets the value of the specified cell.
+  message SetCell {
+    // The name of the family into which new data should be written.
+    // Must match `[-_.a-zA-Z0-9]+`
+    string family_name = 1;
+
+    // The qualifier of the column into which new data should be written.
+    // Can be any byte string, including the empty string.
+    bytes column_qualifier = 2;
+
+    // The timestamp of the cell into which new data should be written.
+    // Use -1 for current Bigtable server time.
+    // Otherwise, the client should set this value itself, noting that the
+    // default value is a timestamp of zero if the field is left unspecified.
+    // Values must match the granularity of the table (e.g. micros, millis).
+    int64 timestamp_micros = 3;
+
+    // The value to be written into the specified cell.
+    bytes value = 4;
+  }
+
+  // A Mutation which deletes cells from the specified column, optionally
+  // restricting the deletions to a given timestamp range.
+  message DeleteFromColumn {
+    // The name of the family from which cells should be deleted.
+    // Must match `[-_.a-zA-Z0-9]+`
+    string family_name = 1;
+
+    // The qualifier of the column from which cells should be deleted.
+    // Can be any byte string, including the empty string.
+    bytes column_qualifier = 2;
+
+    // The range of timestamps within which cells should be deleted.
+    TimestampRange time_range = 3;
+  }
+
+  // A Mutation which deletes all cells from the specified column family.
+  message DeleteFromFamily {
+    // The name of the family from which cells should be deleted.
+    // Must match `[-_.a-zA-Z0-9]+`
+    string family_name = 1;
+  }
+
+  // A Mutation which deletes all cells from the containing row.
+  message DeleteFromRow {}
+
+  // Which of the possible Mutation types to apply.
+  oneof mutation {
+    // Set a cell's value.
+    SetCell set_cell = 1;
+
+    // Deletes cells from a column.
+    DeleteFromColumn delete_from_column = 2;
+
+    // Deletes cells from a column family.
+    DeleteFromFamily delete_from_family = 3;
+
+    // Deletes cells from the entire row.
+    DeleteFromRow delete_from_row = 4;
+  }
+}
+
+// Specifies an atomic read/modify/write operation on the latest value of the
+// specified column.
+message ReadModifyWriteRule {
+  // The name of the family to which the read/modify/write should be applied.
+  // Must match `[-_.a-zA-Z0-9]+`
+  string family_name = 1;
+
+  // The qualifier of the column to which the read/modify/write should be
+  // applied.
+  // Can be any byte string, including the empty string.
+  bytes column_qualifier = 2;
+
+  // The rule used to determine the column's new latest value from its current
+  // latest value.
+  oneof rule {
+    // Rule specifying that `append_value` be appended to the existing value.
+    // If the targeted cell is unset, it will be treated as containing the
+    // empty string.
+    bytes append_value = 3;
+
+    // Rule specifying that `increment_amount` be added to the existing value.
+    // If the targeted cell is unset, it will be treated as containing a zero.
+    // Otherwise, the targeted cell must contain an 8-byte value (interpreted
+    // as a 64-bit big-endian signed integer), or the entire request will fail.
+    int64 increment_amount = 4;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/data_pb2.py b/bigtable/google/cloud/bigtable_v2/proto/data_pb2.py
new file mode 100644
index 000000000000..8e5cff816455
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/data_pb2.py
@@ -0,0 +1,2608 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/bigtable_v2/proto/data.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/bigtable_v2/proto/data.proto",
+    package="google.bigtable.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\026com.google.bigtable.v2B\tDataProtoP\001Z:google.golang.org/genproto/googleapis/bigtable/v2;bigtable\252\002\030Google.Cloud.Bigtable.V2\312\002\030Google\\Cloud\\Bigtable\\V2"
+    ),
+    serialized_pb=_b(
+        '\n)google/cloud/bigtable_v2/proto/data.proto\x12\x12google.bigtable.v2"@\n\x03Row\x12\x0b\n\x03key\x18\x01 \x01(\x0c\x12,\n\x08\x66\x61milies\x18\x02 \x03(\x0b\x32\x1a.google.bigtable.v2.Family"C\n\x06\x46\x61mily\x12\x0c\n\x04name\x18\x01 \x01(\t\x12+\n\x07\x63olumns\x18\x02 \x03(\x0b\x32\x1a.google.bigtable.v2.Column"D\n\x06\x43olumn\x12\x11\n\tqualifier\x18\x01 \x01(\x0c\x12\'\n\x05\x63\x65lls\x18\x02 \x03(\x0b\x32\x18.google.bigtable.v2.Cell"?\n\x04\x43\x65ll\x12\x18\n\x10timestamp_micros\x18\x01 \x01(\x03\x12\r\n\x05value\x18\x02 \x01(\x0c\x12\x0e\n\x06labels\x18\x03 \x03(\t"\x8a\x01\n\x08RowRange\x12\x1a\n\x10start_key_closed\x18\x01 \x01(\x0cH\x00\x12\x18\n\x0estart_key_open\x18\x02 \x01(\x0cH\x00\x12\x16\n\x0c\x65nd_key_open\x18\x03 \x01(\x0cH\x01\x12\x18\n\x0e\x65nd_key_closed\x18\x04 \x01(\x0cH\x01\x42\x0b\n\tstart_keyB\t\n\x07\x65nd_key"L\n\x06RowSet\x12\x10\n\x08row_keys\x18\x01 \x03(\x0c\x12\x30\n\nrow_ranges\x18\x02 \x03(\x0b\x32\x1c.google.bigtable.v2.RowRange"\xc6\x01\n\x0b\x43olumnRange\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12 \n\x16start_qualifier_closed\x18\x02 \x01(\x0cH\x00\x12\x1e\n\x14start_qualifier_open\x18\x03 \x01(\x0cH\x00\x12\x1e\n\x14\x65nd_qualifier_closed\x18\x04 \x01(\x0cH\x01\x12\x1c\n\x12\x65nd_qualifier_open\x18\x05 \x01(\x0cH\x01\x42\x11\n\x0fstart_qualifierB\x0f\n\rend_qualifier"N\n\x0eTimestampRange\x12\x1e\n\x16start_timestamp_micros\x18\x01 \x01(\x03\x12\x1c\n\x14\x65nd_timestamp_micros\x18\x02 \x01(\x03"\x98\x01\n\nValueRange\x12\x1c\n\x12start_value_closed\x18\x01 \x01(\x0cH\x00\x12\x1a\n\x10start_value_open\x18\x02 \x01(\x0cH\x00\x12\x1a\n\x10\x65nd_value_closed\x18\x03 \x01(\x0cH\x01\x12\x18\n\x0e\x65nd_value_open\x18\x04 \x01(\x0cH\x01\x42\r\n\x0bstart_valueB\x0b\n\tend_value"\xdf\x08\n\tRowFilter\x12\x34\n\x05\x63hain\x18\x01 \x01(\x0b\x32#.google.bigtable.v2.RowFilter.ChainH\x00\x12>\n\ninterleave\x18\x02 \x01(\x0b\x32(.google.bigtable.v2.RowFilter.InterleaveH\x00\x12<\n\tcondition\x18\x03 \x01(\x0b\x32\'.google.bigtable.v2.RowFilter.ConditionH\x00\x12\x0e\n\x04sink\x18\x10 \x01(\x08H\x00\x12\x19\n\x0fpass_all_filter\x18\x11 \x01(\x08H\x00\x12\x1a\n\x10\x62lock_all_filter\x18\x12 \x01(\x08H\x00\x12\x1e\n\x14row_key_regex_filter\x18\x04 \x01(\x0cH\x00\x12\x1b\n\x11row_sample_filter\x18\x0e \x01(\x01H\x00\x12"\n\x18\x66\x61mily_name_regex_filter\x18\x05 \x01(\tH\x00\x12\'\n\x1d\x63olumn_qualifier_regex_filter\x18\x06 \x01(\x0cH\x00\x12>\n\x13\x63olumn_range_filter\x18\x07 \x01(\x0b\x32\x1f.google.bigtable.v2.ColumnRangeH\x00\x12\x44\n\x16timestamp_range_filter\x18\x08 \x01(\x0b\x32".google.bigtable.v2.TimestampRangeH\x00\x12\x1c\n\x12value_regex_filter\x18\t \x01(\x0cH\x00\x12<\n\x12value_range_filter\x18\x0f \x01(\x0b\x32\x1e.google.bigtable.v2.ValueRangeH\x00\x12%\n\x1b\x63\x65lls_per_row_offset_filter\x18\n \x01(\x05H\x00\x12$\n\x1a\x63\x65lls_per_row_limit_filter\x18\x0b \x01(\x05H\x00\x12\'\n\x1d\x63\x65lls_per_column_limit_filter\x18\x0c \x01(\x05H\x00\x12!\n\x17strip_value_transformer\x18\r \x01(\x08H\x00\x12!\n\x17\x61pply_label_transformer\x18\x13 \x01(\tH\x00\x1a\x37\n\x05\x43hain\x12.\n\x07\x66ilters\x18\x01 \x03(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x1a<\n\nInterleave\x12.\n\x07\x66ilters\x18\x01 \x03(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x1a\xad\x01\n\tCondition\x12\x37\n\x10predicate_filter\x18\x01 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x32\n\x0btrue_filter\x18\x02 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x33\n\x0c\x66\x61lse_filter\x18\x03 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilterB\x08\n\x06\x66ilter"\xc9\x04\n\x08Mutation\x12\x38\n\x08set_cell\x18\x01 \x01(\x0b\x32$.google.bigtable.v2.Mutation.SetCellH\x00\x12K\n\x12\x64\x65lete_from_column\x18\x02 \x01(\x0b\x32-.google.bigtable.v2.Mutation.DeleteFromColumnH\x00\x12K\n\x12\x64\x65lete_from_family\x18\x03 \x01(\x0b\x32-.google.bigtable.v2.Mutation.DeleteFromFamilyH\x00\x12\x45\n\x0f\x64\x65lete_from_row\x18\x04 \x01(\x0b\x32*.google.bigtable.v2.Mutation.DeleteFromRowH\x00\x1a\x61\n\x07SetCell\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12\x18\n\x10\x63olumn_qualifier\x18\x02 \x01(\x0c\x12\x18\n\x10timestamp_micros\x18\x03 \x01(\x03\x12\r\n\x05value\x18\x04 \x01(\x0c\x1ay\n\x10\x44\x65leteFromColumn\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12\x18\n\x10\x63olumn_qualifier\x18\x02 \x01(\x0c\x12\x36\n\ntime_range\x18\x03 \x01(\x0b\x32".google.bigtable.v2.TimestampRange\x1a\'\n\x10\x44\x65leteFromFamily\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x1a\x0f\n\rDeleteFromRowB\n\n\x08mutation"\x80\x01\n\x13ReadModifyWriteRule\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12\x18\n\x10\x63olumn_qualifier\x18\x02 \x01(\x0c\x12\x16\n\x0c\x61ppend_value\x18\x03 \x01(\x0cH\x00\x12\x1a\n\x10increment_amount\x18\x04 \x01(\x03H\x00\x42\x06\n\x04ruleB\x97\x01\n\x16\x63om.google.bigtable.v2B\tDataProtoP\x01Z:google.golang.org/genproto/googleapis/bigtable/v2;bigtable\xaa\x02\x18Google.Cloud.Bigtable.V2\xca\x02\x18Google\\Cloud\\Bigtable\\V2b\x06proto3'
+    ),
+)
+
+
+_ROW = _descriptor.Descriptor(
+    name="Row",
+    full_name="google.bigtable.v2.Row",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.bigtable.v2.Row.key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="families",
+            full_name="google.bigtable.v2.Row.families",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=65,
+    serialized_end=129,
+)
+
+
+_FAMILY = _descriptor.Descriptor(
+    name="Family",
+    full_name="google.bigtable.v2.Family",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.bigtable.v2.Family.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="columns",
+            full_name="google.bigtable.v2.Family.columns",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=131,
+    serialized_end=198,
+)
+
+
+_COLUMN = _descriptor.Descriptor(
+    name="Column",
+    full_name="google.bigtable.v2.Column",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="qualifier",
+            full_name="google.bigtable.v2.Column.qualifier",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cells",
+            full_name="google.bigtable.v2.Column.cells",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=200,
+    serialized_end=268,
+)
+
+
+_CELL = _descriptor.Descriptor(
+    name="Cell",
+    full_name="google.bigtable.v2.Cell",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="timestamp_micros",
+            full_name="google.bigtable.v2.Cell.timestamp_micros",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.v2.Cell.value",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.bigtable.v2.Cell.labels",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=270,
+    serialized_end=333,
+)
+
+
+_ROWRANGE = _descriptor.Descriptor(
+    name="RowRange",
+    full_name="google.bigtable.v2.RowRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_key_closed",
+            full_name="google.bigtable.v2.RowRange.start_key_closed",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_key_open",
+            full_name="google.bigtable.v2.RowRange.start_key_open",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_key_open",
+            full_name="google.bigtable.v2.RowRange.end_key_open",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_key_closed",
+            full_name="google.bigtable.v2.RowRange.end_key_closed",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="start_key",
+            full_name="google.bigtable.v2.RowRange.start_key",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="end_key",
+            full_name="google.bigtable.v2.RowRange.end_key",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=336,
+    serialized_end=474,
+)
+
+
+_ROWSET = _descriptor.Descriptor(
+    name="RowSet",
+    full_name="google.bigtable.v2.RowSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row_keys",
+            full_name="google.bigtable.v2.RowSet.row_keys",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_ranges",
+            full_name="google.bigtable.v2.RowSet.row_ranges",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=476,
+    serialized_end=552,
+)
+
+
+_COLUMNRANGE = _descriptor.Descriptor(
+    name="ColumnRange",
+    full_name="google.bigtable.v2.ColumnRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.bigtable.v2.ColumnRange.family_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_qualifier_closed",
+            full_name="google.bigtable.v2.ColumnRange.start_qualifier_closed",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_qualifier_open",
+            full_name="google.bigtable.v2.ColumnRange.start_qualifier_open",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_qualifier_closed",
+            full_name="google.bigtable.v2.ColumnRange.end_qualifier_closed",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_qualifier_open",
+            full_name="google.bigtable.v2.ColumnRange.end_qualifier_open",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="start_qualifier",
+            full_name="google.bigtable.v2.ColumnRange.start_qualifier",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="end_qualifier",
+            full_name="google.bigtable.v2.ColumnRange.end_qualifier",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=555,
+    serialized_end=753,
+)
+
+
+_TIMESTAMPRANGE = _descriptor.Descriptor(
+    name="TimestampRange",
+    full_name="google.bigtable.v2.TimestampRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_timestamp_micros",
+            full_name="google.bigtable.v2.TimestampRange.start_timestamp_micros",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_timestamp_micros",
+            full_name="google.bigtable.v2.TimestampRange.end_timestamp_micros",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=755,
+    serialized_end=833,
+)
+
+
+_VALUERANGE = _descriptor.Descriptor(
+    name="ValueRange",
+    full_name="google.bigtable.v2.ValueRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_value_closed",
+            full_name="google.bigtable.v2.ValueRange.start_value_closed",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_value_open",
+            full_name="google.bigtable.v2.ValueRange.start_value_open",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_value_closed",
+            full_name="google.bigtable.v2.ValueRange.end_value_closed",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_value_open",
+            full_name="google.bigtable.v2.ValueRange.end_value_open",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="start_value",
+            full_name="google.bigtable.v2.ValueRange.start_value",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="end_value",
+            full_name="google.bigtable.v2.ValueRange.end_value",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=836,
+    serialized_end=988,
+)
+
+
+_ROWFILTER_CHAIN = _descriptor.Descriptor(
+    name="Chain",
+    full_name="google.bigtable.v2.RowFilter.Chain",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="filters",
+            full_name="google.bigtable.v2.RowFilter.Chain.filters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1807,
+    serialized_end=1862,
+)
+
+_ROWFILTER_INTERLEAVE = _descriptor.Descriptor(
+    name="Interleave",
+    full_name="google.bigtable.v2.RowFilter.Interleave",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="filters",
+            full_name="google.bigtable.v2.RowFilter.Interleave.filters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1864,
+    serialized_end=1924,
+)
+
+_ROWFILTER_CONDITION = _descriptor.Descriptor(
+    name="Condition",
+    full_name="google.bigtable.v2.RowFilter.Condition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="predicate_filter",
+            full_name="google.bigtable.v2.RowFilter.Condition.predicate_filter",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="true_filter",
+            full_name="google.bigtable.v2.RowFilter.Condition.true_filter",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="false_filter",
+            full_name="google.bigtable.v2.RowFilter.Condition.false_filter",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1927,
+    serialized_end=2100,
+)
+
+_ROWFILTER = _descriptor.Descriptor(
+    name="RowFilter",
+    full_name="google.bigtable.v2.RowFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="chain",
+            full_name="google.bigtable.v2.RowFilter.chain",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interleave",
+            full_name="google.bigtable.v2.RowFilter.interleave",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="condition",
+            full_name="google.bigtable.v2.RowFilter.condition",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sink",
+            full_name="google.bigtable.v2.RowFilter.sink",
+            index=3,
+            number=16,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pass_all_filter",
+            full_name="google.bigtable.v2.RowFilter.pass_all_filter",
+            index=4,
+            number=17,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="block_all_filter",
+            full_name="google.bigtable.v2.RowFilter.block_all_filter",
+            index=5,
+            number=18,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_key_regex_filter",
+            full_name="google.bigtable.v2.RowFilter.row_key_regex_filter",
+            index=6,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_sample_filter",
+            full_name="google.bigtable.v2.RowFilter.row_sample_filter",
+            index=7,
+            number=14,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="family_name_regex_filter",
+            full_name="google.bigtable.v2.RowFilter.family_name_regex_filter",
+            index=8,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_qualifier_regex_filter",
+            full_name="google.bigtable.v2.RowFilter.column_qualifier_regex_filter",
+            index=9,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_range_filter",
+            full_name="google.bigtable.v2.RowFilter.column_range_filter",
+            index=10,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_range_filter",
+            full_name="google.bigtable.v2.RowFilter.timestamp_range_filter",
+            index=11,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value_regex_filter",
+            full_name="google.bigtable.v2.RowFilter.value_regex_filter",
+            index=12,
+            number=9,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value_range_filter",
+            full_name="google.bigtable.v2.RowFilter.value_range_filter",
+            index=13,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cells_per_row_offset_filter",
+            full_name="google.bigtable.v2.RowFilter.cells_per_row_offset_filter",
+            index=14,
+            number=10,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cells_per_row_limit_filter",
+            full_name="google.bigtable.v2.RowFilter.cells_per_row_limit_filter",
+            index=15,
+            number=11,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cells_per_column_limit_filter",
+            full_name="google.bigtable.v2.RowFilter.cells_per_column_limit_filter",
+            index=16,
+            number=12,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="strip_value_transformer",
+            full_name="google.bigtable.v2.RowFilter.strip_value_transformer",
+            index=17,
+            number=13,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="apply_label_transformer",
+            full_name="google.bigtable.v2.RowFilter.apply_label_transformer",
+            index=18,
+            number=19,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ROWFILTER_CHAIN, _ROWFILTER_INTERLEAVE, _ROWFILTER_CONDITION],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="filter",
+            full_name="google.bigtable.v2.RowFilter.filter",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=991,
+    serialized_end=2110,
+)
+
+
+_MUTATION_SETCELL = _descriptor.Descriptor(
+    name="SetCell",
+    full_name="google.bigtable.v2.Mutation.SetCell",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.bigtable.v2.Mutation.SetCell.family_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_qualifier",
+            full_name="google.bigtable.v2.Mutation.SetCell.column_qualifier",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_micros",
+            full_name="google.bigtable.v2.Mutation.SetCell.timestamp_micros",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.bigtable.v2.Mutation.SetCell.value",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2408,
+    serialized_end=2505,
+)
+
+_MUTATION_DELETEFROMCOLUMN = _descriptor.Descriptor(
+    name="DeleteFromColumn",
+    full_name="google.bigtable.v2.Mutation.DeleteFromColumn",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.bigtable.v2.Mutation.DeleteFromColumn.family_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_qualifier",
+            full_name="google.bigtable.v2.Mutation.DeleteFromColumn.column_qualifier",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_range",
+            full_name="google.bigtable.v2.Mutation.DeleteFromColumn.time_range",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2507,
+    serialized_end=2628,
+)
+
+_MUTATION_DELETEFROMFAMILY = _descriptor.Descriptor(
+    name="DeleteFromFamily",
+    full_name="google.bigtable.v2.Mutation.DeleteFromFamily",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.bigtable.v2.Mutation.DeleteFromFamily.family_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2630,
+    serialized_end=2669,
+)
+
+_MUTATION_DELETEFROMROW = _descriptor.Descriptor(
+    name="DeleteFromRow",
+    full_name="google.bigtable.v2.Mutation.DeleteFromRow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2671,
+    serialized_end=2686,
+)
+
+_MUTATION = _descriptor.Descriptor(
+    name="Mutation",
+    full_name="google.bigtable.v2.Mutation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="set_cell",
+            full_name="google.bigtable.v2.Mutation.set_cell",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_from_column",
+            full_name="google.bigtable.v2.Mutation.delete_from_column",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_from_family",
+            full_name="google.bigtable.v2.Mutation.delete_from_family",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_from_row",
+            full_name="google.bigtable.v2.Mutation.delete_from_row",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _MUTATION_SETCELL,
+        _MUTATION_DELETEFROMCOLUMN,
+        _MUTATION_DELETEFROMFAMILY,
+        _MUTATION_DELETEFROMROW,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="mutation",
+            full_name="google.bigtable.v2.Mutation.mutation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2113,
+    serialized_end=2698,
+)
+
+
+_READMODIFYWRITERULE = _descriptor.Descriptor(
+    name="ReadModifyWriteRule",
+    full_name="google.bigtable.v2.ReadModifyWriteRule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.bigtable.v2.ReadModifyWriteRule.family_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_qualifier",
+            full_name="google.bigtable.v2.ReadModifyWriteRule.column_qualifier",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="append_value",
+            full_name="google.bigtable.v2.ReadModifyWriteRule.append_value",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="increment_amount",
+            full_name="google.bigtable.v2.ReadModifyWriteRule.increment_amount",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="rule",
+            full_name="google.bigtable.v2.ReadModifyWriteRule.rule",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2701,
+    serialized_end=2829,
+)
+
+_ROW.fields_by_name["families"].message_type = _FAMILY
+_FAMILY.fields_by_name["columns"].message_type = _COLUMN
+_COLUMN.fields_by_name["cells"].message_type = _CELL
+_ROWRANGE.oneofs_by_name["start_key"].fields.append(
+    _ROWRANGE.fields_by_name["start_key_closed"]
+)
+_ROWRANGE.fields_by_name[
+    "start_key_closed"
+].containing_oneof = _ROWRANGE.oneofs_by_name["start_key"]
+_ROWRANGE.oneofs_by_name["start_key"].fields.append(
+    _ROWRANGE.fields_by_name["start_key_open"]
+)
+_ROWRANGE.fields_by_name["start_key_open"].containing_oneof = _ROWRANGE.oneofs_by_name[
+    "start_key"
+]
+_ROWRANGE.oneofs_by_name["end_key"].fields.append(
+    _ROWRANGE.fields_by_name["end_key_open"]
+)
+_ROWRANGE.fields_by_name["end_key_open"].containing_oneof = _ROWRANGE.oneofs_by_name[
+    "end_key"
+]
+_ROWRANGE.oneofs_by_name["end_key"].fields.append(
+    _ROWRANGE.fields_by_name["end_key_closed"]
+)
+_ROWRANGE.fields_by_name["end_key_closed"].containing_oneof = _ROWRANGE.oneofs_by_name[
+    "end_key"
+]
+_ROWSET.fields_by_name["row_ranges"].message_type = _ROWRANGE
+_COLUMNRANGE.oneofs_by_name["start_qualifier"].fields.append(
+    _COLUMNRANGE.fields_by_name["start_qualifier_closed"]
+)
+_COLUMNRANGE.fields_by_name[
+    "start_qualifier_closed"
+].containing_oneof = _COLUMNRANGE.oneofs_by_name["start_qualifier"]
+_COLUMNRANGE.oneofs_by_name["start_qualifier"].fields.append(
+    _COLUMNRANGE.fields_by_name["start_qualifier_open"]
+)
+_COLUMNRANGE.fields_by_name[
+    "start_qualifier_open"
+].containing_oneof = _COLUMNRANGE.oneofs_by_name["start_qualifier"]
+_COLUMNRANGE.oneofs_by_name["end_qualifier"].fields.append(
+    _COLUMNRANGE.fields_by_name["end_qualifier_closed"]
+)
+_COLUMNRANGE.fields_by_name[
+    "end_qualifier_closed"
+].containing_oneof = _COLUMNRANGE.oneofs_by_name["end_qualifier"]
+_COLUMNRANGE.oneofs_by_name["end_qualifier"].fields.append(
+    _COLUMNRANGE.fields_by_name["end_qualifier_open"]
+)
+_COLUMNRANGE.fields_by_name[
+    "end_qualifier_open"
+].containing_oneof = _COLUMNRANGE.oneofs_by_name["end_qualifier"]
+_VALUERANGE.oneofs_by_name["start_value"].fields.append(
+    _VALUERANGE.fields_by_name["start_value_closed"]
+)
+_VALUERANGE.fields_by_name[
+    "start_value_closed"
+].containing_oneof = _VALUERANGE.oneofs_by_name["start_value"]
+_VALUERANGE.oneofs_by_name["start_value"].fields.append(
+    _VALUERANGE.fields_by_name["start_value_open"]
+)
+_VALUERANGE.fields_by_name[
+    "start_value_open"
+].containing_oneof = _VALUERANGE.oneofs_by_name["start_value"]
+_VALUERANGE.oneofs_by_name["end_value"].fields.append(
+    _VALUERANGE.fields_by_name["end_value_closed"]
+)
+_VALUERANGE.fields_by_name[
+    "end_value_closed"
+].containing_oneof = _VALUERANGE.oneofs_by_name["end_value"]
+_VALUERANGE.oneofs_by_name["end_value"].fields.append(
+    _VALUERANGE.fields_by_name["end_value_open"]
+)
+_VALUERANGE.fields_by_name[
+    "end_value_open"
+].containing_oneof = _VALUERANGE.oneofs_by_name["end_value"]
+_ROWFILTER_CHAIN.fields_by_name["filters"].message_type = _ROWFILTER
+_ROWFILTER_CHAIN.containing_type = _ROWFILTER
+_ROWFILTER_INTERLEAVE.fields_by_name["filters"].message_type = _ROWFILTER
+_ROWFILTER_INTERLEAVE.containing_type = _ROWFILTER
+_ROWFILTER_CONDITION.fields_by_name["predicate_filter"].message_type = _ROWFILTER
+_ROWFILTER_CONDITION.fields_by_name["true_filter"].message_type = _ROWFILTER
+_ROWFILTER_CONDITION.fields_by_name["false_filter"].message_type = _ROWFILTER
+_ROWFILTER_CONDITION.containing_type = _ROWFILTER
+_ROWFILTER.fields_by_name["chain"].message_type = _ROWFILTER_CHAIN
+_ROWFILTER.fields_by_name["interleave"].message_type = _ROWFILTER_INTERLEAVE
+_ROWFILTER.fields_by_name["condition"].message_type = _ROWFILTER_CONDITION
+_ROWFILTER.fields_by_name["column_range_filter"].message_type = _COLUMNRANGE
+_ROWFILTER.fields_by_name["timestamp_range_filter"].message_type = _TIMESTAMPRANGE
+_ROWFILTER.fields_by_name["value_range_filter"].message_type = _VALUERANGE
+_ROWFILTER.oneofs_by_name["filter"].fields.append(_ROWFILTER.fields_by_name["chain"])
+_ROWFILTER.fields_by_name["chain"].containing_oneof = _ROWFILTER.oneofs_by_name[
+    "filter"
+]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["interleave"]
+)
+_ROWFILTER.fields_by_name["interleave"].containing_oneof = _ROWFILTER.oneofs_by_name[
+    "filter"
+]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["condition"]
+)
+_ROWFILTER.fields_by_name["condition"].containing_oneof = _ROWFILTER.oneofs_by_name[
+    "filter"
+]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(_ROWFILTER.fields_by_name["sink"])
+_ROWFILTER.fields_by_name["sink"].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["pass_all_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "pass_all_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["block_all_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "block_all_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["row_key_regex_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "row_key_regex_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["row_sample_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "row_sample_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["family_name_regex_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "family_name_regex_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["column_qualifier_regex_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "column_qualifier_regex_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["column_range_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "column_range_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["timestamp_range_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "timestamp_range_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["value_regex_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "value_regex_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["value_range_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "value_range_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["cells_per_row_offset_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "cells_per_row_offset_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["cells_per_row_limit_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "cells_per_row_limit_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["cells_per_column_limit_filter"]
+)
+_ROWFILTER.fields_by_name[
+    "cells_per_column_limit_filter"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["strip_value_transformer"]
+)
+_ROWFILTER.fields_by_name[
+    "strip_value_transformer"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_ROWFILTER.oneofs_by_name["filter"].fields.append(
+    _ROWFILTER.fields_by_name["apply_label_transformer"]
+)
+_ROWFILTER.fields_by_name[
+    "apply_label_transformer"
+].containing_oneof = _ROWFILTER.oneofs_by_name["filter"]
+_MUTATION_SETCELL.containing_type = _MUTATION
+_MUTATION_DELETEFROMCOLUMN.fields_by_name["time_range"].message_type = _TIMESTAMPRANGE
+_MUTATION_DELETEFROMCOLUMN.containing_type = _MUTATION
+_MUTATION_DELETEFROMFAMILY.containing_type = _MUTATION
+_MUTATION_DELETEFROMROW.containing_type = _MUTATION
+_MUTATION.fields_by_name["set_cell"].message_type = _MUTATION_SETCELL
+_MUTATION.fields_by_name["delete_from_column"].message_type = _MUTATION_DELETEFROMCOLUMN
+_MUTATION.fields_by_name["delete_from_family"].message_type = _MUTATION_DELETEFROMFAMILY
+_MUTATION.fields_by_name["delete_from_row"].message_type = _MUTATION_DELETEFROMROW
+_MUTATION.oneofs_by_name["mutation"].fields.append(_MUTATION.fields_by_name["set_cell"])
+_MUTATION.fields_by_name["set_cell"].containing_oneof = _MUTATION.oneofs_by_name[
+    "mutation"
+]
+_MUTATION.oneofs_by_name["mutation"].fields.append(
+    _MUTATION.fields_by_name["delete_from_column"]
+)
+_MUTATION.fields_by_name[
+    "delete_from_column"
+].containing_oneof = _MUTATION.oneofs_by_name["mutation"]
+_MUTATION.oneofs_by_name["mutation"].fields.append(
+    _MUTATION.fields_by_name["delete_from_family"]
+)
+_MUTATION.fields_by_name[
+    "delete_from_family"
+].containing_oneof = _MUTATION.oneofs_by_name["mutation"]
+_MUTATION.oneofs_by_name["mutation"].fields.append(
+    _MUTATION.fields_by_name["delete_from_row"]
+)
+_MUTATION.fields_by_name["delete_from_row"].containing_oneof = _MUTATION.oneofs_by_name[
+    "mutation"
+]
+_READMODIFYWRITERULE.oneofs_by_name["rule"].fields.append(
+    _READMODIFYWRITERULE.fields_by_name["append_value"]
+)
+_READMODIFYWRITERULE.fields_by_name[
+    "append_value"
+].containing_oneof = _READMODIFYWRITERULE.oneofs_by_name["rule"]
+_READMODIFYWRITERULE.oneofs_by_name["rule"].fields.append(
+    _READMODIFYWRITERULE.fields_by_name["increment_amount"]
+)
+_READMODIFYWRITERULE.fields_by_name[
+    "increment_amount"
+].containing_oneof = _READMODIFYWRITERULE.oneofs_by_name["rule"]
+DESCRIPTOR.message_types_by_name["Row"] = _ROW
+DESCRIPTOR.message_types_by_name["Family"] = _FAMILY
+DESCRIPTOR.message_types_by_name["Column"] = _COLUMN
+DESCRIPTOR.message_types_by_name["Cell"] = _CELL
+DESCRIPTOR.message_types_by_name["RowRange"] = _ROWRANGE
+DESCRIPTOR.message_types_by_name["RowSet"] = _ROWSET
+DESCRIPTOR.message_types_by_name["ColumnRange"] = _COLUMNRANGE
+DESCRIPTOR.message_types_by_name["TimestampRange"] = _TIMESTAMPRANGE
+DESCRIPTOR.message_types_by_name["ValueRange"] = _VALUERANGE
+DESCRIPTOR.message_types_by_name["RowFilter"] = _ROWFILTER
+DESCRIPTOR.message_types_by_name["Mutation"] = _MUTATION
+DESCRIPTOR.message_types_by_name["ReadModifyWriteRule"] = _READMODIFYWRITERULE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Row = _reflection.GeneratedProtocolMessageType(
+    "Row",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROW,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies the complete (requested) contents of a single row of a table.
+  Rows which exceed 256MiB in size cannot be read in full.
+  
+  
+  Attributes:
+      key:
+          The unique key which identifies this row within its table.
+          This is the same key that's used to identify the row in, for
+          example, a MutateRowRequest. May contain any non-empty byte
+          string up to 4KiB in length.
+      families:
+          May be empty, but only if the entire row is empty. The mutual
+          ordering of column families is not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.Row)
+    ),
+)
+_sym_db.RegisterMessage(Row)
+
+Family = _reflection.GeneratedProtocolMessageType(
+    "Family",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FAMILY,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies (some of) the contents of a single row/column family
+  intersection of a table.
+  
+  
+  Attributes:
+      name:
+          The unique key which identifies this family within its row.
+          This is the same key that's used to identify the family in,
+          for example, a RowFilter which sets its
+          "family\_name\_regex\_filter" field. Must match
+          ``[-_.a-zA-Z0-9]+``, except that AggregatingRowProcessors may
+          produce cells in a sentinel family with an empty name. Must be
+          no greater than 64 characters in length.
+      columns:
+          Must not be empty. Sorted in order of increasing "qualifier".
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.Family)
+    ),
+)
+_sym_db.RegisterMessage(Family)
+
+Column = _reflection.GeneratedProtocolMessageType(
+    "Column",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLUMN,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies (some of) the contents of a single row/column intersection of
+  a table.
+  
+  
+  Attributes:
+      qualifier:
+          The unique key which identifies this column within its family.
+          This is the same key that's used to identify the column in,
+          for example, a RowFilter which sets its
+          ``column_qualifier_regex_filter`` field. May contain any byte
+          string, including the empty string, up to 16kiB in length.
+      cells:
+          Must not be empty. Sorted in order of decreasing
+          "timestamp\_micros".
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.Column)
+    ),
+)
+_sym_db.RegisterMessage(Column)
+
+Cell = _reflection.GeneratedProtocolMessageType(
+    "Cell",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CELL,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies (some of) the contents of a single row/column/timestamp of a
+  table.
+  
+  
+  Attributes:
+      timestamp_micros:
+          The cell's stored timestamp, which also uniquely identifies it
+          within its column. Values are always expressed in
+          microseconds, but individual tables may set a coarser
+          granularity to further restrict the allowed values. For
+          example, a table which specifies millisecond granularity will
+          only allow values of ``timestamp_micros`` which are multiples
+          of 1000.
+      value:
+          The value stored in the cell. May contain any byte string,
+          including the empty string, up to 100MiB in length.
+      labels:
+          Labels applied to the cell by a
+          [RowFilter][google.bigtable.v2.RowFilter].
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.Cell)
+    ),
+)
+_sym_db.RegisterMessage(Cell)
+
+RowRange = _reflection.GeneratedProtocolMessageType(
+    "RowRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROWRANGE,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies a contiguous range of rows.
+  
+  
+  Attributes:
+      start_key:
+          The row key at which to start the range. If neither field is
+          set, interpreted as the empty string, inclusive.
+      start_key_closed:
+          Used when giving an inclusive lower bound for the range.
+      start_key_open:
+          Used when giving an exclusive lower bound for the range.
+      end_key:
+          The row key at which to end the range. If neither field is
+          set, interpreted as the infinite row key, exclusive.
+      end_key_open:
+          Used when giving an exclusive upper bound for the range.
+      end_key_closed:
+          Used when giving an inclusive upper bound for the range.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowRange)
+    ),
+)
+_sym_db.RegisterMessage(RowRange)
+
+RowSet = _reflection.GeneratedProtocolMessageType(
+    "RowSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROWSET,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies a non-contiguous set of rows.
+  
+  
+  Attributes:
+      row_keys:
+          Single rows included in the set.
+      row_ranges:
+          Contiguous row ranges included in the set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowSet)
+    ),
+)
+_sym_db.RegisterMessage(RowSet)
+
+ColumnRange = _reflection.GeneratedProtocolMessageType(
+    "ColumnRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLUMNRANGE,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies a contiguous range of columns within a single column family.
+  The range spans from <column\_family>:<start\_qualifier> to
+  <column\_family>:<end\_qualifier>, where both bounds can be either
+  inclusive or exclusive.
+  
+  
+  Attributes:
+      family_name:
+          The name of the column family within which this range falls.
+      start_qualifier:
+          The column qualifier at which to start the range (within
+          ``column_family``). If neither field is set, interpreted as
+          the empty string, inclusive.
+      start_qualifier_closed:
+          Used when giving an inclusive lower bound for the range.
+      start_qualifier_open:
+          Used when giving an exclusive lower bound for the range.
+      end_qualifier:
+          The column qualifier at which to end the range (within
+          ``column_family``). If neither field is set, interpreted as
+          the infinite string, exclusive.
+      end_qualifier_closed:
+          Used when giving an inclusive upper bound for the range.
+      end_qualifier_open:
+          Used when giving an exclusive upper bound for the range.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ColumnRange)
+    ),
+)
+_sym_db.RegisterMessage(ColumnRange)
+
+TimestampRange = _reflection.GeneratedProtocolMessageType(
+    "TimestampRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMESTAMPRANGE,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specified a contiguous range of microsecond timestamps.
+  
+  
+  Attributes:
+      start_timestamp_micros:
+          Inclusive lower bound. If left empty, interpreted as 0.
+      end_timestamp_micros:
+          Exclusive upper bound. If left empty, interpreted as infinity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.TimestampRange)
+    ),
+)
+_sym_db.RegisterMessage(TimestampRange)
+
+ValueRange = _reflection.GeneratedProtocolMessageType(
+    "ValueRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUERANGE,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies a contiguous range of raw byte values.
+  
+  
+  Attributes:
+      start_value:
+          The value at which to start the range. If neither field is
+          set, interpreted as the empty string, inclusive.
+      start_value_closed:
+          Used when giving an inclusive lower bound for the range.
+      start_value_open:
+          Used when giving an exclusive lower bound for the range.
+      end_value:
+          The value at which to end the range. If neither field is set,
+          interpreted as the infinite string, exclusive.
+      end_value_closed:
+          Used when giving an inclusive upper bound for the range.
+      end_value_open:
+          Used when giving an exclusive upper bound for the range.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ValueRange)
+    ),
+)
+_sym_db.RegisterMessage(ValueRange)
+
+RowFilter = _reflection.GeneratedProtocolMessageType(
+    "RowFilter",
+    (_message.Message,),
+    dict(
+        Chain=_reflection.GeneratedProtocolMessageType(
+            "Chain",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ROWFILTER_CHAIN,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A RowFilter which sends rows through several RowFilters in sequence.
+    
+    
+    Attributes:
+        filters:
+            The elements of "filters" are chained together to process the
+            input row: in row -> f(0) -> intermediate row -> f(1) -> ...
+            -> f(N) -> out row The full chain is executed atomically.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter.Chain)
+            ),
+        ),
+        Interleave=_reflection.GeneratedProtocolMessageType(
+            "Interleave",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ROWFILTER_INTERLEAVE,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A RowFilter which sends each row to each of several component RowFilters
+    and interleaves the results.
+    
+    
+    Attributes:
+        filters:
+            The elements of "filters" all process a copy of the input row,
+            and the results are pooled, sorted, and combined into a single
+            output row. If multiple cells are produced with the same
+            column and timestamp, they will all appear in the output row
+            in an unspecified mutual order. Consider the following
+            example, with three filters:  ::
+            input row                                      |
+            -----------------------------------------------------
+            |                         |                         |
+            f(0)                      f(1)                      f(2)
+            |                         |                         |     1:
+            foo,bar,10,x             foo,bar,10,z              far,bar,7,a
+            2: foo,blah,11,z            far,blah,5,x
+            far,blah,5,x            |                         |
+            |
+            -----------------------------------------------------
+            |     1:                      foo,bar,10,z   // could have
+            switched with #2     2:                      foo,bar,10,x   //
+            could have switched with #1     3:
+            foo,blah,11,z     4:                      far,bar,7,a     5:
+            far,blah,5,x   // identical to #6     6:
+            far,blah,5,x   // identical to #5  All interleaved filters are
+            executed atomically.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter.Interleave)
+            ),
+        ),
+        Condition=_reflection.GeneratedProtocolMessageType(
+            "Condition",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ROWFILTER_CONDITION,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A RowFilter which evaluates one of two possible RowFilters, depending on
+    whether or not a predicate RowFilter outputs any cells from the input
+    row.
+    
+    IMPORTANT NOTE: The predicate filter does not execute atomically with
+    the true and false filters, which may lead to inconsistent or unexpected
+    results. Additionally, Condition filters have poor performance,
+    especially when filters are set for the false condition.
+    
+    
+    Attributes:
+        predicate_filter:
+            If ``predicate_filter`` outputs any cells, then
+            ``true_filter`` will be evaluated on the input row. Otherwise,
+            ``false_filter`` will be evaluated.
+        true_filter:
+            The filter to apply to the input row if ``predicate_filter``
+            returns any results. If not provided, no results will be
+            returned in the true case.
+        false_filter:
+            The filter to apply to the input row if ``predicate_filter``
+            does not return any results. If not provided, no results will
+            be returned in the false case.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter.Condition)
+            ),
+        ),
+        DESCRIPTOR=_ROWFILTER,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Takes a row as input and produces an alternate view of the row based on
+  specified rules. For example, a RowFilter might trim down a row to
+  include just the cells from columns matching a given regular expression,
+  or might return all the cells of a row but not their values. More
+  complicated filters can be composed out of these components to express
+  requests such as, "within every column of a particular family, give just
+  the two most recent cells which are older than timestamp X."
+  
+  There are two broad categories of RowFilters (true filters and
+  transformers), as well as two ways to compose simple filters into more
+  complex ones (chains and interleaves). They work as follows:
+  
+  -  True filters alter the input row by excluding some of its cells
+     wholesale from the output row. An example of a true filter is the
+     ``value_regex_filter``, which excludes cells whose values don't match
+     the specified pattern. All regex true filters use RE2 syntax
+     (https://github.com/google/re2/wiki/Syntax) in raw byte mode
+     (RE2::Latin1), and are evaluated as full matches. An important point
+     to keep in mind is that ``RE2(.)`` is equivalent by default to
+     ``RE2([^\n])``, meaning that it does not match newlines. When
+     attempting to match an arbitrary byte, you should therefore use the
+     escape sequence ``\C``, which may need to be further escaped as
+     ``\\C`` in your client language.
+  
+  -  Transformers alter the input row by changing the values of some of
+     its cells in the output, without excluding them completely.
+     Currently, the only supported transformer is the
+     ``strip_value_transformer``, which replaces every cell's value with
+     the empty string.
+  
+  -  Chains and interleaves are described in more detail in the
+     RowFilter.Chain and RowFilter.Interleave documentation.
+  
+  The total serialized size of a RowFilter message must not exceed 4096
+  bytes, and RowFilters may not be nested within each other (in Chains or
+  Interleaves) to a depth of more than 20.
+  
+  
+  Attributes:
+      filter:
+          Which of the possible RowFilter types to apply. If none are
+          set, this RowFilter returns all cells in the input row.
+      chain:
+          Applies several RowFilters to the data in sequence,
+          progressively narrowing the results.
+      interleave:
+          Applies several RowFilters to the data in parallel and
+          combines the results.
+      condition:
+          Applies one of two possible RowFilters to the data based on
+          the output of a predicate RowFilter.
+      sink:
+          ADVANCED USE ONLY. Hook for introspection into the RowFilter.
+          Outputs all cells directly to the output of the read rather
+          than to any parent filter. Consider the following example:  ::
+          Chain(       FamilyRegex("A"),       Interleave(
+          All(),         Chain(Label("foo"), Sink())       ),
+          QualifierRegex("B")     )                          A,A,1,w
+          A,B,2,x                         B,B,4,z
+          |                     FamilyRegex("A")
+          |                         A,A,1,w
+          A,B,2,x                            |
+          +------------+-------------+               |
+          |             All()                    Label(foo)
+          |                          |            A,A,1,w
+          A,A,1,w,labels:[foo]            A,B,2,x
+          A,B,2,x,labels:[foo]               |
+          |               |                        Sink()
+          --------------+               |                          |
+          |               +------------+      x------+
+          A,A,1,w,labels:[foo]                            |
+          A,B,2,x,labels:[foo]                         A,A,1,w
+          |                         A,B,2,x
+          |                            |
+          |                    QualifierRegex("B")
+          |                            |
+          |                         A,B,2,x
+          |                            |
+          |
+          +--------------------------------+
+          |                         A,A,1,w,labels:[foo]
+          A,B,2,x,labels:[foo]  // could be switched
+          A,B,2,x               // could be switched  Despite being
+          excluded by the qualifier filter, a copy of every cell that
+          reaches the sink is present in the final result.  As with an
+          [Interleave][google.bigtable.v2.RowFilter.Interleave],
+          duplicate cells are possible, and appear in an unspecified
+          mutual order. In this case we have a duplicate with column
+          "A:B" and timestamp 2, because one copy passed through the all
+          filter while the other was passed through the label and sink.
+          Note that one copy has label "foo", while the other does not.
+          Cannot be used within the ``predicate_filter``,
+          ``true_filter``, or ``false_filter`` of a
+          [Condition][google.bigtable.v2.RowFilter.Condition].
+      pass_all_filter:
+          Matches all cells, regardless of input. Functionally
+          equivalent to leaving ``filter`` unset, but included for
+          completeness.
+      block_all_filter:
+          Does not match any cells, regardless of input. Useful for
+          temporarily disabling just part of a filter.
+      row_key_regex_filter:
+          Matches only cells from rows whose keys satisfy the given RE2
+          regex. In other words, passes through the entire row when the
+          key matches, and otherwise produces an empty row. Note that,
+          since row keys can contain arbitrary bytes, the ``\C`` escape
+          sequence must be used if a true wildcard is desired. The ``.``
+          character will not match the new line character ``\n``, which
+          may be present in a binary key.
+      row_sample_filter:
+          Matches all cells from a row with probability p, and matches
+          no cells from the row with probability 1-p.
+      family_name_regex_filter:
+          Matches only cells from columns whose families satisfy the
+          given RE2 regex. For technical reasons, the regex must not
+          contain the ``:`` character, even if it is not being used as a
+          literal. Note that, since column families cannot contain the
+          new line character ``\n``, it is sufficient to use ``.`` as a
+          full wildcard when matching column family names.
+      column_qualifier_regex_filter:
+          Matches only cells from columns whose qualifiers satisfy the
+          given RE2 regex. Note that, since column qualifiers can
+          contain arbitrary bytes, the ``\C`` escape sequence must be
+          used if a true wildcard is desired. The ``.`` character will
+          not match the new line character ``\n``, which may be present
+          in a binary qualifier.
+      column_range_filter:
+          Matches only cells from columns within the given range.
+      timestamp_range_filter:
+          Matches only cells with timestamps within the given range.
+      value_regex_filter:
+          Matches only cells with values that satisfy the given regular
+          expression. Note that, since cell values can contain arbitrary
+          bytes, the ``\C`` escape sequence must be used if a true
+          wildcard is desired. The ``.`` character will not match the
+          new line character ``\n``, which may be present in a binary
+          value.
+      value_range_filter:
+          Matches only cells with values that fall within the given
+          range.
+      cells_per_row_offset_filter:
+          Skips the first N cells of each row, matching all subsequent
+          cells. If duplicate cells are present, as is possible when
+          using an Interleave, each copy of the cell is counted
+          separately.
+      cells_per_row_limit_filter:
+          Matches only the first N cells of each row. If duplicate cells
+          are present, as is possible when using an Interleave, each
+          copy of the cell is counted separately.
+      cells_per_column_limit_filter:
+          Matches only the most recent N cells within each column. For
+          example, if N=2, this filter would match column ``foo:bar`` at
+          timestamps 10 and 9, skip all earlier cells in ``foo:bar``,
+          and then begin matching again in column ``foo:bar2``. If
+          duplicate cells are present, as is possible when using an
+          Interleave, each copy of the cell is counted separately.
+      strip_value_transformer:
+          Replaces each cell's value with the empty string.
+      apply_label_transformer:
+          Applies the given label to all cells in the output row. This
+          allows the client to determine which results were produced
+          from which part of the filter.  Values must be at most 15
+          characters in length, and match the RE2 pattern
+          ``[a-z0-9\\-]+``  Due to a technical limitation, it is not
+          currently possible to apply multiple labels to a cell. As a
+          result, a Chain may have no more than one sub-filter which
+          contains a ``apply_label_transformer``. It is okay for an
+          Interleave to contain multiple ``apply_label_transformers``,
+          as they will be applied to separate copies of the input. This
+          may be relaxed in the future.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter)
+    ),
+)
+_sym_db.RegisterMessage(RowFilter)
+_sym_db.RegisterMessage(RowFilter.Chain)
+_sym_db.RegisterMessage(RowFilter.Interleave)
+_sym_db.RegisterMessage(RowFilter.Condition)
+
+Mutation = _reflection.GeneratedProtocolMessageType(
+    "Mutation",
+    (_message.Message,),
+    dict(
+        SetCell=_reflection.GeneratedProtocolMessageType(
+            "SetCell",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATION_SETCELL,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A Mutation which sets the value of the specified cell.
+    
+    
+    Attributes:
+        family_name:
+            The name of the family into which new data should be written.
+            Must match ``[-_.a-zA-Z0-9]+``
+        column_qualifier:
+            The qualifier of the column into which new data should be
+            written. Can be any byte string, including the empty string.
+        timestamp_micros:
+            The timestamp of the cell into which new data should be
+            written. Use -1 for current Bigtable server time. Otherwise,
+            the client should set this value itself, noting that the
+            default value is a timestamp of zero if the field is left
+            unspecified. Values must match the granularity of the table
+            (e.g. micros, millis).
+        value:
+            The value to be written into the specified cell.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.SetCell)
+            ),
+        ),
+        DeleteFromColumn=_reflection.GeneratedProtocolMessageType(
+            "DeleteFromColumn",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATION_DELETEFROMCOLUMN,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A Mutation which deletes cells from the specified column, optionally
+    restricting the deletions to a given timestamp range.
+    
+    
+    Attributes:
+        family_name:
+            The name of the family from which cells should be deleted.
+            Must match ``[-_.a-zA-Z0-9]+``
+        column_qualifier:
+            The qualifier of the column from which cells should be
+            deleted. Can be any byte string, including the empty string.
+        time_range:
+            The range of timestamps within which cells should be deleted.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.DeleteFromColumn)
+            ),
+        ),
+        DeleteFromFamily=_reflection.GeneratedProtocolMessageType(
+            "DeleteFromFamily",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATION_DELETEFROMFAMILY,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A Mutation which deletes all cells from the specified column family.
+    
+    
+    Attributes:
+        family_name:
+            The name of the family from which cells should be deleted.
+            Must match ``[-_.a-zA-Z0-9]+``
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.DeleteFromFamily)
+            ),
+        ),
+        DeleteFromRow=_reflection.GeneratedProtocolMessageType(
+            "DeleteFromRow",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATION_DELETEFROMROW,
+                __module__="google.cloud.bigtable_v2.proto.data_pb2",
+                __doc__="""A Mutation which deletes all cells from the containing row.
+    """,
+                # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.DeleteFromRow)
+            ),
+        ),
+        DESCRIPTOR=_MUTATION,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies a particular change to be made to the contents of a row.
+  
+  
+  Attributes:
+      mutation:
+          Which of the possible Mutation types to apply.
+      set_cell:
+          Set a cell's value.
+      delete_from_column:
+          Deletes cells from a column.
+      delete_from_family:
+          Deletes cells from a column family.
+      delete_from_row:
+          Deletes cells from the entire row.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation)
+    ),
+)
+_sym_db.RegisterMessage(Mutation)
+_sym_db.RegisterMessage(Mutation.SetCell)
+_sym_db.RegisterMessage(Mutation.DeleteFromColumn)
+_sym_db.RegisterMessage(Mutation.DeleteFromFamily)
+_sym_db.RegisterMessage(Mutation.DeleteFromRow)
+
+ReadModifyWriteRule = _reflection.GeneratedProtocolMessageType(
+    "ReadModifyWriteRule",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READMODIFYWRITERULE,
+        __module__="google.cloud.bigtable_v2.proto.data_pb2",
+        __doc__="""Specifies an atomic read/modify/write operation on the latest value of
+  the specified column.
+  
+  
+  Attributes:
+      family_name:
+          The name of the family to which the read/modify/write should
+          be applied. Must match ``[-_.a-zA-Z0-9]+``
+      column_qualifier:
+          The qualifier of the column to which the read/modify/write
+          should be applied. Can be any byte string, including the empty
+          string.
+      rule:
+          The rule used to determine the column's new latest value from
+          its current latest value.
+      append_value:
+          Rule specifying that ``append_value`` be appended to the
+          existing value. If the targeted cell is unset, it will be
+          treated as containing the empty string.
+      increment_amount:
+          Rule specifying that ``increment_amount`` be added to the
+          existing value. If the targeted cell is unset, it will be
+          treated as containing a zero. Otherwise, the targeted cell
+          must contain an 8-byte value (interpreted as a 64-bit big-
+          endian signed integer), or the entire request will fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadModifyWriteRule)
+    ),
+)
+_sym_db.RegisterMessage(ReadModifyWriteRule)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/bigtable/google/cloud/bigtable_v2/proto/data_pb2_grpc.py b/bigtable/google/cloud/bigtable_v2/proto/data_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/data_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/bigtable/google/cloud/bigtable_v2/proto/instance.proto b/bigtable/google/cloud/bigtable_v2/proto/instance.proto
new file mode 100644
index 000000000000..bb69b1f66d42
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/instance.proto
@@ -0,0 +1,208 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/bigtable/admin/v2/common.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "InstanceProto";
+option java_package = "com.google.bigtable.admin.v2";
+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].
+message Instance {
+  // Possible states of an instance.
+  enum State {
+    // The state of the instance could not be determined.
+    STATE_NOT_KNOWN = 0;
+
+    // The instance has been successfully created and can serve requests
+    // to its tables.
+    READY = 1;
+
+    // The instance is currently being created, and may be destroyed
+    // if the creation process encounters an error.
+    CREATING = 2;
+  }
+
+  // The type of the instance.
+  enum Type {
+    // The type of the instance is unspecified. If set when creating an
+    // instance, a `PRODUCTION` instance will be created. If set when updating
+    // an instance, the type will be left unchanged.
+    TYPE_UNSPECIFIED = 0;
+
+    // An instance meant for production use. `serve_nodes` must be set
+    // on the cluster.
+    PRODUCTION = 1;
+
+    // The instance is meant for development and testing purposes only; it has
+    // no performance or uptime guarantees and is not covered by SLA.
+    // After a development instance is created, it can be upgraded by
+    // updating the instance to type `PRODUCTION`. An instance created
+    // as a production instance cannot be changed to a development instance.
+    // When creating a development instance, `serve_nodes` on the cluster must
+    // not be set.
+    DEVELOPMENT = 2;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the instance. Values are of the form
+  // `projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]`.
+  string name = 1;
+
+  // 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;
+
+  // (`OutputOnly`)
+  // The current state of the instance.
+  State state = 3;
+
+  // The type of the instance. Defaults to `PRODUCTION`.
+  Type type = 4;
+
+  // Labels are a flexible and lightweight mechanism for organizing cloud
+  // resources into groups that reflect a customer's organizational needs and
+  // deployment strategies. They can be used to filter resources and aggregate
+  // metrics.
+  //
+  // * Label keys must be between 1 and 63 characters long and must conform to
+  //   the regular expression: `[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}`.
+  // * Label values must be between 0 and 63 characters long and must conform to
+  //   the regular expression: `[\p{Ll}\p{Lo}\p{N}_-]{0,63}`.
+  // * No more than 64 labels can be associated with a given resource.
+  // * Keys and values must both be under 128 bytes.
+  map<string, string> labels = 5;
+}
+
+// A resizable group of nodes in a particular cloud location, capable
+// of serving all [Tables][google.bigtable.admin.v2.Table] in the parent
+// [Instance][google.bigtable.admin.v2.Instance].
+message Cluster {
+  // Possible states of a cluster.
+  enum State {
+    // The state of the cluster could not be determined.
+    STATE_NOT_KNOWN = 0;
+
+    // The cluster has been successfully created and is ready to serve requests.
+    READY = 1;
+
+    // The cluster is currently being created, and may be destroyed
+    // if the creation process encounters an error.
+    // A cluster may not be able to serve requests while being created.
+    CREATING = 2;
+
+    // The cluster is currently being resized, and may revert to its previous
+    // node count if the process encounters an error.
+    // A cluster is still capable of serving requests while being resized,
+    // but may exhibit performance as if its number of allocated nodes is
+    // between the starting and requested states.
+    RESIZING = 3;
+
+    // The cluster has no backing nodes. The data (tables) still
+    // exist, but no operations can be performed on the cluster.
+    DISABLED = 4;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the cluster. Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*`.
+  string name = 1;
+
+  // (`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/<project>/locations/<zone>`.
+  string location = 2;
+
+  // (`OutputOnly`)
+  // The current state of the cluster.
+  State state = 3;
+
+  // The number of nodes allocated to this cluster. More nodes enable higher
+  // throughput and more consistent performance.
+  int32 serve_nodes = 4;
+
+  // (`CreationOnly`)
+  // The type of storage used by this cluster to serve its
+  // parent instance's tables, unless explicitly overridden.
+  StorageType default_storage_type = 5;
+}
+
+// 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.
+  message MultiClusterRoutingUseAny {
+
+  }
+
+  // Unconditionally routes all read/write requests to a specific cluster.
+  // This option preserves read-your-writes consistency, but does not improve
+  // availability.
+  message SingleClusterRouting {
+    // The cluster to which read/write requests should be routed.
+    string cluster_id = 1;
+
+    // Whether or not `CheckAndMutateRow` and `ReadModifyWriteRow` requests are
+    // allowed by this app profile. It is unsafe to send these requests to
+    // the same table/row/column in multiple clusters.
+    bool allow_transactional_writes = 2;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the app profile. Values are of the form
+  // `projects/<project>/instances/<instance>/appProfiles/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`.
+  string name = 1;
+
+  // Strongly validated etag for optimistic concurrency control. Preserve the
+  // value returned from `GetAppProfile` when calling `UpdateAppProfile` to
+  // fail the request if there has been a modification in the mean time. The
+  // `update_mask` of the request need not include `etag` for this protection
+  // to apply.
+  // See [Wikipedia](https://en.wikipedia.org/wiki/HTTP_ETag) and
+  // [RFC 7232](https://tools.ietf.org/html/rfc7232#section-2.3) for more
+  // details.
+  string etag = 2;
+
+  // 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.
+  // A value must be explicitly set.
+  oneof routing_policy {
+    // Use a multi-cluster routing policy that may pick any cluster.
+    MultiClusterRoutingUseAny multi_cluster_routing_use_any = 5;
+
+    // Use a single-cluster routing policy.
+    SingleClusterRouting single_cluster_routing = 6;
+  }
+}
diff --git a/bigtable/google/cloud/bigtable_v2/proto/table.proto b/bigtable/google/cloud/bigtable_v2/proto/table.proto
new file mode 100644
index 000000000000..5d4374effc59
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/proto/table.proto
@@ -0,0 +1,221 @@
+// 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.bigtable.admin.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2";
+option go_package = "google.golang.org/genproto/googleapis/bigtable/admin/v2;admin";
+option java_multiple_files = true;
+option java_outer_classname = "TableProto";
+option java_package = "com.google.bigtable.admin.v2";
+option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2";
+
+
+// A collection of user data indexed by row, column, and timestamp.
+// Each table is served using the resources of its parent cluster.
+message Table {
+  // The state of a table's data in a particular cluster.
+  message ClusterState {
+    // Table replication states.
+    enum ReplicationState {
+      // The replication state of the table is unknown in this cluster.
+      STATE_NOT_KNOWN = 0;
+
+      // The cluster was recently created, and the table must finish copying
+      // over pre-existing data from other clusters before it can begin
+      // receiving live replication updates and serving Data API requests.
+      INITIALIZING = 1;
+
+      // The table is temporarily unable to serve Data API requests from this
+      // cluster due to planned internal maintenance.
+      PLANNED_MAINTENANCE = 2;
+
+      // The table is temporarily unable to serve Data API requests from this
+      // cluster due to unplanned or emergency maintenance.
+      UNPLANNED_MAINTENANCE = 3;
+
+      // The table can serve Data API requests from this cluster. Depending on
+      // replication delay, reads may not immediately reflect the state of the
+      // table in other clusters.
+      READY = 4;
+    }
+
+    // (`OutputOnly`)
+    // The state of replication for the table in this cluster.
+    ReplicationState replication_state = 1;
+  }
+
+  // Possible timestamp granularities to use when keeping multiple versions
+  // of data in a table.
+  enum TimestampGranularity {
+    // The user did not specify a granularity. Should not be returned.
+    // When specified during table creation, MILLIS will be used.
+    TIMESTAMP_GRANULARITY_UNSPECIFIED = 0;
+
+    // The table keeps data versioned at a granularity of 1ms.
+    MILLIS = 1;
+  }
+
+  // Defines a view over a table's fields.
+  enum View {
+    // Uses the default view for each method as documented in its request.
+    VIEW_UNSPECIFIED = 0;
+
+    // Only populates `name`.
+    NAME_ONLY = 1;
+
+    // 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.
+    REPLICATION_VIEW = 3;
+
+    // Populates all fields.
+    FULL = 4;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the table. Values are of the form
+  // `projects/<project>/instances/<instance>/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.
+  // 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`.
+  // Views: `REPLICATION_VIEW`, `FULL`
+  map<string, ClusterState> cluster_states = 2;
+
+  // (`CreationOnly`)
+  // The column families configured for this table, mapped by column family ID.
+  // Views: `SCHEMA_VIEW`, `FULL`
+  map<string, ColumnFamily> column_families = 3;
+
+  // (`CreationOnly`)
+  // 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`
+  TimestampGranularity granularity = 4;
+}
+
+// A set of columns within a table which share a common configuration.
+message ColumnFamily {
+  // Garbage collection rule specified as a protobuf.
+  // Must serialize to at most 500 bytes.
+  //
+  // NOTE: Garbage collection executes opportunistically in the background, and
+  // so it's possible for reads to return a cell even if it matches the active
+  // GC expression for its family.
+  GcRule gc_rule = 1;
+}
+
+// Rule for determining which cells to delete during garbage collection.
+message GcRule {
+  // A GcRule which deletes cells matching all of the given rules.
+  message Intersection {
+    // Only delete cells which would be deleted by every element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  // A GcRule which deletes cells matching any of the given rules.
+  message Union {
+    // Delete cells which would be deleted by any element of `rules`.
+    repeated GcRule rules = 1;
+  }
+
+  // Garbage collection rules.
+  oneof rule {
+    // Delete all cells in a column except the most recent N.
+    int32 max_num_versions = 1;
+
+    // Delete cells in a column older than the given age.
+    // Values must be at least one millisecond, and will be truncated to
+    // microsecond granularity.
+    google.protobuf.Duration max_age = 2;
+
+    // Delete cells that would be deleted by every nested rule.
+    Intersection intersection = 3;
+
+    // Delete cells that would be deleted by any nested rule.
+    Union union = 4;
+  }
+}
+
+// A snapshot of a table at a particular time. A snapshot can be used as a
+// checkpoint for data restoration or a data source for a new table.
+//
+// Note: This is a private alpha release of Cloud Bigtable snapshots. This
+// feature is not currently available to most Cloud Bigtable customers. This
+// 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 {
+  // Possible states of a snapshot.
+  enum State {
+    // The state of the snapshot could not be determined.
+    STATE_NOT_KNOWN = 0;
+
+    // The snapshot has been successfully created and can serve all requests.
+    READY = 1;
+
+    // The snapshot is currently being created, and may be destroyed if the
+    // creation process encounters an error. A snapshot may not be restored to a
+    // table while it is being created.
+    CREATING = 2;
+  }
+
+  // (`OutputOnly`)
+  // The unique name of the snapshot.
+  // Values are of the form
+  // `projects/<project>/instances/<instance>/clusters/<cluster>/snapshots/<snapshot>`.
+  string name = 1;
+
+  // (`OutputOnly`)
+  // 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.
+  int64 data_size_bytes = 3;
+
+  // (`OutputOnly`)
+  // 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,
+  // the default maximum of 365 days will be used.
+  google.protobuf.Timestamp delete_time = 5;
+
+  // (`OutputOnly`)
+  // The current state of the snapshot.
+  State state = 6;
+
+  // (`OutputOnly`)
+  // Description of the snapshot.
+  string description = 7;
+}
diff --git a/bigtable/google/cloud/bigtable_v2/types.py b/bigtable/google/cloud/bigtable_v2/types.py
new file mode 100644
index 000000000000..53937c1d1687
--- /dev/null
+++ b/bigtable/google/cloud/bigtable_v2/types.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.bigtable_v2.proto import bigtable_pb2
+from google.cloud.bigtable_v2.proto import data_pb2
+from google.protobuf import any_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [any_pb2, wrappers_pb2, status_pb2]
+
+_local_modules = [bigtable_pb2, data_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.bigtable_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/bigtable/noxfile.py b/bigtable/noxfile.py
new file mode 100644
index 000000000000..00c2b4793529
--- /dev/null
+++ b/bigtable/noxfile.py
@@ -0,0 +1,185 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=99")
+
+    session.run("coverage", "erase")
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
+
+@nox.session(python=['2.7', '3.7'])
+def snippets(session):
+    """Run the documentation example snippets."""
+    # Sanity check: Only run snippets system tests if the environment variable
+    # is set.
+    if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
+        session.skip('Credentials must be set via environment variable.')
+
+    # Install all test dependencies, then install local packages in place.
+    session.install('mock', 'pytest')
+    for local_dep in LOCAL_DEPS:
+        session.install('-e', local_dep)
+    session.install('-e', '../test_utils/')
+    session.install('-e', '.')
+    session.run(
+        'py.test',
+        '--quiet',
+        os.path.join('docs', 'snippets.py'),
+        *session.posargs
+    )
+    session.run(
+        'py.test',
+        '--quiet',
+        os.path.join('docs', 'snippets_table.py'),
+        *session.posargs
+    )
diff --git a/bigtable/pylint.config.py b/bigtable/pylint.config.py
new file mode 100644
index 000000000000..074e6626a6e6
--- /dev/null
+++ b/bigtable/pylint.config.py
@@ -0,0 +1,30 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+import copy
+
+from gcp_devrel.tools import pylint
+
+# Library configuration
+
+# library_additions = {}
+library_replacements = copy.deepcopy(pylint.DEFAULT_LIBRARY_RC_REPLACEMENTS)
+library_replacements['MASTER']['ignore'].append('_generated')
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/bigtable/releases.md b/bigtable/releases.md
new file mode 120000
index 000000000000..4c43d49320dc
--- /dev/null
+++ b/bigtable/releases.md
@@ -0,0 +1 @@
+../../bigtable/CHANGELOG.md
\ No newline at end of file
diff --git a/bigtable/setup.cfg b/bigtable/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/bigtable/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/bigtable/setup.py b/bigtable/setup.py
new file mode 100644
index 000000000000..29a1de12501f
--- /dev/null
+++ b/bigtable/setup.py
@@ -0,0 +1,91 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-bigtable'
+description = 'Google Cloud Bigtable API client library'
+version = '0.34.0'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 4 - Beta'
+dependencies = [
+    'google-api-core[grpc] >= 1.14.0, < 2.0.0dev',
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/bigtable/synth.metadata b/bigtable/synth.metadata
new file mode 100644
index 000000000000..0c2408190e20
--- /dev/null
+++ b/bigtable/synth.metadata
@@ -0,0 +1,48 @@
+{
+  "updateTime": "2019-08-06T18:10:45.081885Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "53e641721f965a485af64331cfea9e5522294d78"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "bigtable",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/bigtable/artman_bigtable.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "bigtable_admin",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/bigtable/admin/artman_bigtableadmin.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/bigtable/synth.py b/bigtable/synth.py
new file mode 100644
index 000000000000..32ebc4af2eb1
--- /dev/null
+++ b/bigtable/synth.py
@@ -0,0 +1,91 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate bigtable and bigtable_admin GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "bigtable",
+    "v2",
+    config_path="/google/bigtable/artman_bigtable.yaml",
+    artman_output_name="bigtable-v2",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/bigtable_v2")
+s.move(library / "tests")
+
+# Generate admin client
+library = gapic.py_library(
+    "bigtable_admin",
+    "v2",
+    config_path="/google/bigtable/admin/artman_bigtableadmin.yaml",
+    artman_output_name="bigtable-admin-v2",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/bigtable_admin_v2")
+s.move(library / "tests")
+
+s.replace(
+    [
+        "google/cloud/bigtable_admin_v2/gapic/bigtable_instance_admin_client.py",
+        "google/cloud/bigtable_admin_v2/gapic/bigtable_table_admin_client.py",
+    ],
+    "'google-cloud-bigtable-admin'",
+    "'google-cloud-bigtable'",
+)
+
+s.replace(
+    "google/**/*.py",
+    "from google\.cloud\.bigtable\.admin_v2.proto",
+    "from google.cloud.bigtable_admin_v2.proto",
+)
+
+s.replace(
+    ["google/cloud/bigtable_admin_v2/__init__.py"],
+    "    __doc__ = bigtable_instance_admin_client."
+    "BigtableInstanceAdminClient.__doc__\n",
+    "    __doc__ = (\n"
+    "        bigtable_instance_admin_client.BigtableInstanceAdminClient."
+    "__doc__)\n",
+)
+
+s.replace(
+    ["google/cloud/bigtable_v2/gapic/bigtable_client.py"],
+    "if ``true_mutations`` is empty, and at most\n\n\s*100000.",
+    "if ``true_mutations`` is empty, and at most 100000.",
+)
+
+s.replace(
+    ["google/cloud/bigtable_v2/gapic/bigtable_client.py"],
+    "if ``false_mutations`` is empty, and at most\n\n\s*100000.",
+    "if ``false_mutations`` is empty, and at most 100000.",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=99)
+s.move(templated_files, excludes=['noxfile.py'])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/bigtable/tests/__init__.py b/bigtable/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/bigtable/tests/system.py b/bigtable/tests/system.py
new file mode 100644
index 000000000000..28d95d985ffe
--- /dev/null
+++ b/bigtable/tests/system.py
@@ -0,0 +1,1100 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import operator
+import os
+import unittest
+
+from google.api_core.exceptions import TooManyRequests
+from google.cloud.environment_vars import BIGTABLE_EMULATOR
+from test_utils.retry import RetryErrors
+from test_utils.retry import RetryResult
+from test_utils.system import EmulatorCreds
+from test_utils.system import unique_resource_id
+
+from google.cloud._helpers import _datetime_from_microseconds
+from google.cloud._helpers import _microseconds_from_datetime
+from google.cloud._helpers import UTC
+from google.cloud.bigtable.client import Client
+from google.cloud.bigtable.column_family import MaxVersionsGCRule
+from google.cloud.bigtable.row_filters import ApplyLabelFilter
+from google.cloud.bigtable.row_filters import ColumnQualifierRegexFilter
+from google.cloud.bigtable.row_filters import RowFilterChain
+from google.cloud.bigtable.row_filters import RowFilterUnion
+from google.cloud.bigtable.row_data import Cell
+from google.cloud.bigtable.row_data import PartialRowData
+from google.cloud.bigtable.row_set import RowSet
+from google.cloud.bigtable.row_set import RowRange
+from google.cloud.bigtable_admin_v2.gapic import (
+    bigtable_table_admin_client_config as table_admin_config,
+)
+
+UNIQUE_SUFFIX = unique_resource_id("-")
+LOCATION_ID = "us-central1-c"
+INSTANCE_ID = "g-c-p" + UNIQUE_SUFFIX
+INSTANCE_ID_DATA = "g-c-p-d" + UNIQUE_SUFFIX
+TABLE_ID = "google-cloud-python-test-table"
+CLUSTER_ID = INSTANCE_ID + "-cluster"
+CLUSTER_ID_DATA = INSTANCE_ID_DATA + "-cluster"
+SERVE_NODES = 3
+COLUMN_FAMILY_ID1 = u"col-fam-id1"
+COLUMN_FAMILY_ID2 = u"col-fam-id2"
+COL_NAME1 = b"col-name1"
+COL_NAME2 = b"col-name2"
+COL_NAME3 = b"col-name3-but-other-fam"
+CELL_VAL1 = b"cell-val"
+CELL_VAL2 = b"cell-val-newer"
+CELL_VAL3 = b"altcol-cell-val"
+CELL_VAL4 = b"foo"
+ROW_KEY = b"row-key"
+ROW_KEY_ALT = b"row-key-alt"
+EXISTING_INSTANCES = []
+LABEL_KEY = u"python-system"
+label_stamp = (
+    datetime.datetime.utcnow()
+    .replace(microsecond=0, tzinfo=UTC)
+    .strftime("%Y-%m-%dt%H-%M-%S")
+)
+LABELS = {LABEL_KEY: str(label_stamp)}
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    INSTANCE = None
+    INSTANCE_DATA = None
+    CLUSTER = None
+    CLUSTER_DATA = None
+    IN_EMULATOR = False
+
+
+def _retry_on_unavailable(exc):
+    """Retry only errors whose status code is 'UNAVAILABLE'."""
+    from grpc import StatusCode
+
+    return exc.code() == StatusCode.UNAVAILABLE
+
+
+retry_429 = RetryErrors(TooManyRequests, max_tries=9)
+
+
+def setUpModule():
+    from google.cloud.exceptions import GrpcRendezvous
+    from google.cloud.bigtable.enums import Instance
+
+    # See: https://github.com/googleapis/google-cloud-python/issues/5928
+    interfaces = table_admin_config.config["interfaces"]
+    iface_config = interfaces["google.bigtable.admin.v2.BigtableTableAdmin"]
+    methods = iface_config["methods"]
+    create_table = methods["CreateTable"]
+    create_table["timeout_millis"] = 90000
+
+    Config.IN_EMULATOR = os.getenv(BIGTABLE_EMULATOR) is not None
+
+    if Config.IN_EMULATOR:
+        credentials = EmulatorCreds()
+        Config.CLIENT = Client(admin=True, credentials=credentials)
+    else:
+        Config.CLIENT = Client(admin=True)
+
+    Config.INSTANCE = Config.CLIENT.instance(INSTANCE_ID, labels=LABELS)
+    Config.CLUSTER = Config.INSTANCE.cluster(
+        CLUSTER_ID, location_id=LOCATION_ID, serve_nodes=SERVE_NODES
+    )
+    Config.INSTANCE_DATA = Config.CLIENT.instance(
+        INSTANCE_ID_DATA, instance_type=Instance.Type.DEVELOPMENT, labels=LABELS
+    )
+    Config.CLUSTER_DATA = Config.INSTANCE_DATA.cluster(
+        CLUSTER_ID_DATA, location_id=LOCATION_ID
+    )
+
+    if not Config.IN_EMULATOR:
+        retry = RetryErrors(GrpcRendezvous, error_predicate=_retry_on_unavailable)
+        instances, failed_locations = retry(Config.CLIENT.list_instances)()
+
+        if len(failed_locations) != 0:
+            raise ValueError("List instances failed in module set up.")
+
+        EXISTING_INSTANCES[:] = instances
+
+        # After listing, create the test instances.
+        admin_op = Config.INSTANCE.create(clusters=[Config.CLUSTER])
+        admin_op.result(timeout=10)
+        data_op = Config.INSTANCE_DATA.create(clusters=[Config.CLUSTER_DATA])
+        data_op.result(timeout=10)
+
+
+def tearDownModule():
+    if not Config.IN_EMULATOR:
+        retry_429(Config.INSTANCE.delete)()
+        retry_429(Config.INSTANCE_DATA.delete)()
+
+
+class TestInstanceAdminAPI(unittest.TestCase):
+    def setUp(self):
+        if Config.IN_EMULATOR:
+            self.skipTest("Instance Admin API not supported in emulator")
+        self.instances_to_delete = []
+
+    def tearDown(self):
+        for instance in self.instances_to_delete:
+            retry_429(instance.delete)()
+
+    def test_list_instances(self):
+        instances, failed_locations = Config.CLIENT.list_instances()
+
+        self.assertEqual(failed_locations, [])
+
+        found = set([instance.name for instance in instances])
+        self.assertTrue(Config.INSTANCE.name in found)
+
+    def test_reload(self):
+        from google.cloud.bigtable import enums
+
+        # Use same arguments as Config.INSTANCE (created in `setUpModule`)
+        # so we can use reload() on a fresh instance.
+        alt_instance = Config.CLIENT.instance(INSTANCE_ID)
+        # Make sure metadata unset before reloading.
+        alt_instance.display_name = None
+
+        alt_instance.reload()
+        self.assertEqual(alt_instance.display_name, Config.INSTANCE.display_name)
+        self.assertEqual(alt_instance.labels, Config.INSTANCE.labels)
+        self.assertEqual(alt_instance.type_, enums.Instance.Type.PRODUCTION)
+
+    def test_create_instance_defaults(self):
+        from google.cloud.bigtable import enums
+
+        ALT_INSTANCE_ID = "ndef" + UNIQUE_SUFFIX
+        instance = Config.CLIENT.instance(ALT_INSTANCE_ID, labels=LABELS)
+        ALT_CLUSTER_ID = ALT_INSTANCE_ID + "-cluster"
+        cluster = instance.cluster(
+            ALT_CLUSTER_ID, location_id=LOCATION_ID, serve_nodes=SERVE_NODES
+        )
+        operation = instance.create(clusters=[cluster])
+
+        # Make sure this instance gets deleted after the test case.
+        self.instances_to_delete.append(instance)
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+        # Create a new instance instance and make sure it is the same.
+        instance_alt = Config.CLIENT.instance(ALT_INSTANCE_ID)
+        instance_alt.reload()
+
+        self.assertEqual(instance, instance_alt)
+        self.assertEqual(instance.display_name, instance_alt.display_name)
+        # Make sure that by default a PRODUCTION type instance is created
+        self.assertIsNone(instance.type_)
+        self.assertEqual(instance_alt.type_, enums.Instance.Type.PRODUCTION)
+
+    def test_create_instance(self):
+        from google.cloud.bigtable import enums
+
+        _DEVELOPMENT = enums.Instance.Type.DEVELOPMENT
+
+        ALT_INSTANCE_ID = "new" + UNIQUE_SUFFIX
+        instance = Config.CLIENT.instance(
+            ALT_INSTANCE_ID, instance_type=_DEVELOPMENT, labels=LABELS
+        )
+        ALT_CLUSTER_ID = ALT_INSTANCE_ID + "-cluster"
+        cluster = instance.cluster(ALT_CLUSTER_ID, location_id=LOCATION_ID)
+        operation = instance.create(clusters=[cluster])
+
+        # Make sure this instance gets deleted after the test case.
+        self.instances_to_delete.append(instance)
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+        # Create a new instance instance and make sure it is the same.
+        instance_alt = Config.CLIENT.instance(ALT_INSTANCE_ID)
+        instance_alt.reload()
+
+        self.assertEqual(instance, instance_alt)
+        self.assertEqual(instance.display_name, instance_alt.display_name)
+        self.assertEqual(instance.type_, instance_alt.type_)
+        self.assertEqual(instance_alt.labels, LABELS)
+        self.assertEqual(instance_alt.state, enums.Instance.State.READY)
+
+    def test_cluster_exists(self):
+        NONEXISTING_CLUSTER_ID = "cluster-id"
+
+        cluster = Config.INSTANCE.cluster(CLUSTER_ID)
+        alt_cluster = Config.INSTANCE.cluster(NONEXISTING_CLUSTER_ID)
+        self.assertTrue(cluster.exists())
+        self.assertFalse(alt_cluster.exists())
+
+    def test_instance_exists(self):
+        NONEXISTING_INSTANCE_ID = "instancer-id"
+
+        alt_instance = Config.CLIENT.instance(NONEXISTING_INSTANCE_ID)
+        self.assertTrue(Config.INSTANCE.exists())
+        self.assertFalse(alt_instance.exists())
+
+    def test_create_instance_w_two_clusters(self):
+        from google.cloud.bigtable import enums
+        from google.cloud.bigtable.table import ClusterState
+
+        _PRODUCTION = enums.Instance.Type.PRODUCTION
+        ALT_INSTANCE_ID = "dif" + UNIQUE_SUFFIX
+        instance = Config.CLIENT.instance(
+            ALT_INSTANCE_ID, instance_type=_PRODUCTION, labels=LABELS
+        )
+
+        ALT_CLUSTER_ID_1 = ALT_INSTANCE_ID + "-c1"
+        ALT_CLUSTER_ID_2 = ALT_INSTANCE_ID + "-c2"
+        LOCATION_ID_2 = "us-central1-f"
+        STORAGE_TYPE = enums.StorageType.HDD
+        cluster_1 = instance.cluster(
+            ALT_CLUSTER_ID_1,
+            location_id=LOCATION_ID,
+            serve_nodes=SERVE_NODES,
+            default_storage_type=STORAGE_TYPE,
+        )
+        cluster_2 = instance.cluster(
+            ALT_CLUSTER_ID_2,
+            location_id=LOCATION_ID_2,
+            serve_nodes=SERVE_NODES,
+            default_storage_type=STORAGE_TYPE,
+        )
+        operation = instance.create(clusters=[cluster_1, cluster_2])
+
+        # Make sure this instance gets deleted after the test case.
+        self.instances_to_delete.append(instance)
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=30)
+
+        # Create a new instance instance and make sure it is the same.
+        instance_alt = Config.CLIENT.instance(ALT_INSTANCE_ID)
+        instance_alt.reload()
+
+        self.assertEqual(instance, instance_alt)
+        self.assertEqual(instance.display_name, instance_alt.display_name)
+        self.assertEqual(instance.type_, instance_alt.type_)
+
+        clusters, failed_locations = instance_alt.list_clusters()
+        self.assertEqual(failed_locations, [])
+
+        clusters.sort(key=lambda x: x.name)
+        alt_cluster_1, alt_cluster_2 = clusters
+
+        self.assertEqual(cluster_1.location_id, alt_cluster_1.location_id)
+        self.assertEqual(alt_cluster_1.state, enums.Cluster.State.READY)
+        self.assertEqual(cluster_1.serve_nodes, alt_cluster_1.serve_nodes)
+        self.assertEqual(
+            cluster_1.default_storage_type, alt_cluster_1.default_storage_type
+        )
+        self.assertEqual(cluster_2.location_id, alt_cluster_2.location_id)
+        self.assertEqual(alt_cluster_2.state, enums.Cluster.State.READY)
+        self.assertEqual(cluster_2.serve_nodes, alt_cluster_2.serve_nodes)
+        self.assertEqual(
+            cluster_2.default_storage_type, alt_cluster_2.default_storage_type
+        )
+
+        # Test list clusters in project via 'client.list_clusters'
+        clusters, failed_locations = Config.CLIENT.list_clusters()
+        self.assertFalse(failed_locations)
+        found = set([cluster.name for cluster in clusters])
+        self.assertTrue(
+            {alt_cluster_1.name, alt_cluster_2.name, Config.CLUSTER.name}.issubset(
+                found
+            )
+        )
+
+        temp_table_id = "test-get-cluster-states"
+        temp_table = instance.table(temp_table_id)
+        temp_table.create()
+        result = temp_table.get_cluster_states()
+        ReplicationState = enums.Table.ReplicationState
+        expected_results = [
+            ClusterState(ReplicationState.STATE_NOT_KNOWN),
+            ClusterState(ReplicationState.INITIALIZING),
+            ClusterState(ReplicationState.PLANNED_MAINTENANCE),
+            ClusterState(ReplicationState.UNPLANNED_MAINTENANCE),
+            ClusterState(ReplicationState.READY),
+        ]
+        cluster_id_list = result.keys()
+        self.assertEqual(len(cluster_id_list), 2)
+        self.assertIn(ALT_CLUSTER_ID_1, cluster_id_list)
+        self.assertIn(ALT_CLUSTER_ID_2, cluster_id_list)
+        for clusterstate in result.values():
+            self.assertIn(clusterstate, expected_results)
+
+        # Test create app profile with multi_cluster_routing policy
+        app_profiles_to_delete = []
+        description = "routing policy-multy"
+        app_profile_id_1 = "app_profile_id_1"
+        routing = enums.RoutingPolicyType.ANY
+        self._test_create_app_profile_helper(
+            app_profile_id_1,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            ignore_warnings=True,
+        )
+        app_profiles_to_delete.append(app_profile_id_1)
+
+        # Test list app profiles
+        self._test_list_app_profiles_helper(instance, [app_profile_id_1])
+
+        # Test modify app profile app_profile_id_1
+        # routing policy to single cluster policy,
+        # cluster -> ALT_CLUSTER_ID_1,
+        # allow_transactional_writes -> disallowed
+        # modify description
+        description = "to routing policy-single"
+        routing = enums.RoutingPolicyType.SINGLE
+        self._test_modify_app_profile_helper(
+            app_profile_id_1,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            cluster_id=ALT_CLUSTER_ID_1,
+            allow_transactional_writes=False,
+        )
+
+        # Test modify app profile app_profile_id_1
+        # cluster -> ALT_CLUSTER_ID_2,
+        # allow_transactional_writes -> allowed
+        self._test_modify_app_profile_helper(
+            app_profile_id_1,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            cluster_id=ALT_CLUSTER_ID_2,
+            allow_transactional_writes=True,
+            ignore_warnings=True,
+        )
+
+        # Test create app profile with single cluster routing policy
+        description = "routing policy-single"
+        app_profile_id_2 = "app_profile_id_2"
+        routing = enums.RoutingPolicyType.SINGLE
+        self._test_create_app_profile_helper(
+            app_profile_id_2,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            cluster_id=ALT_CLUSTER_ID_2,
+            allow_transactional_writes=False,
+        )
+        app_profiles_to_delete.append(app_profile_id_2)
+
+        # Test list app profiles
+        self._test_list_app_profiles_helper(
+            instance, [app_profile_id_1, app_profile_id_2]
+        )
+
+        # Test modify app profile app_profile_id_2 to
+        # allow transactional writes
+        # Note: no need to set ``ignore_warnings`` to True
+        # since we are not restrictings anything with this modification.
+        self._test_modify_app_profile_helper(
+            app_profile_id_2,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            cluster_id=ALT_CLUSTER_ID_2,
+            allow_transactional_writes=True,
+        )
+
+        # Test modify app profile app_profile_id_2 routing policy
+        # to multi_cluster_routing policy
+        # modify description
+        description = "to routing policy-multy"
+        routing = enums.RoutingPolicyType.ANY
+        self._test_modify_app_profile_helper(
+            app_profile_id_2,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            allow_transactional_writes=False,
+            ignore_warnings=True,
+        )
+
+        # Test delete app profiles
+        for app_profile_id in app_profiles_to_delete:
+            self._test_delete_app_profile_helper(app_profile_id, instance)
+
+    def test_update_display_name_and_labels(self):
+        OLD_DISPLAY_NAME = Config.INSTANCE.display_name
+        NEW_DISPLAY_NAME = "Foo Bar Baz"
+        n_label_stamp = (
+            datetime.datetime.utcnow()
+            .replace(microsecond=0, tzinfo=UTC)
+            .strftime("%Y-%m-%dt%H-%M-%S")
+        )
+
+        NEW_LABELS = {LABEL_KEY: str(n_label_stamp)}
+        Config.INSTANCE.display_name = NEW_DISPLAY_NAME
+        Config.INSTANCE.labels = NEW_LABELS
+        operation = Config.INSTANCE.update()
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+        # Create a new instance instance and reload it.
+        instance_alt = Config.CLIENT.instance(INSTANCE_ID, labels=LABELS)
+        self.assertEqual(instance_alt.display_name, OLD_DISPLAY_NAME)
+        self.assertEqual(instance_alt.labels, LABELS)
+        instance_alt.reload()
+        self.assertEqual(instance_alt.display_name, NEW_DISPLAY_NAME)
+        self.assertEqual(instance_alt.labels, NEW_LABELS)
+
+        # Make sure to put the instance back the way it was for the
+        # other test cases.
+        Config.INSTANCE.display_name = OLD_DISPLAY_NAME
+        Config.INSTANCE.labels = LABELS
+        operation = Config.INSTANCE.update()
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+    def test_update_type(self):
+        from google.cloud.bigtable.enums import Instance
+
+        _DEVELOPMENT = Instance.Type.DEVELOPMENT
+        _PRODUCTION = Instance.Type.PRODUCTION
+        ALT_INSTANCE_ID = "ndif" + UNIQUE_SUFFIX
+        instance = Config.CLIENT.instance(
+            ALT_INSTANCE_ID, instance_type=_DEVELOPMENT, labels=LABELS
+        )
+        operation = instance.create(location_id=LOCATION_ID, serve_nodes=None)
+
+        # Make sure this instance gets deleted after the test case.
+        self.instances_to_delete.append(instance)
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+        # Unset the display_name
+        instance.display_name = None
+
+        instance.type_ = _PRODUCTION
+        operation = instance.update()
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+        # Create a new instance instance and reload it.
+        instance_alt = Config.CLIENT.instance(ALT_INSTANCE_ID)
+        self.assertIsNone(instance_alt.type_)
+        instance_alt.reload()
+        self.assertEqual(instance_alt.type_, _PRODUCTION)
+
+    def test_update_cluster(self):
+        NEW_SERVE_NODES = 4
+
+        Config.CLUSTER.serve_nodes = NEW_SERVE_NODES
+
+        operation = Config.CLUSTER.update()
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=10)
+
+        # Create a new cluster instance and reload it.
+        alt_cluster = Config.INSTANCE.cluster(CLUSTER_ID)
+        alt_cluster.reload()
+        self.assertEqual(alt_cluster.serve_nodes, NEW_SERVE_NODES)
+
+        # Make sure to put the cluster back the way it was for the
+        # other test cases.
+        Config.CLUSTER.serve_nodes = SERVE_NODES
+        operation = Config.CLUSTER.update()
+        operation.result(timeout=10)
+
+    def test_create_cluster(self):
+        from google.cloud.bigtable.enums import StorageType
+        from google.cloud.bigtable.enums import Cluster
+
+        ALT_CLUSTER_ID = INSTANCE_ID + "-c2"
+        ALT_LOCATION_ID = "us-central1-f"
+        ALT_SERVE_NODES = 4
+
+        cluster_2 = Config.INSTANCE.cluster(
+            ALT_CLUSTER_ID,
+            location_id=ALT_LOCATION_ID,
+            serve_nodes=ALT_SERVE_NODES,
+            default_storage_type=(StorageType.SSD),
+        )
+        operation = cluster_2.create()
+
+        # We want to make sure the operation completes.
+        operation.result(timeout=30)
+
+        # Create a new object instance, reload  and make sure it is the same.
+        alt_cluster = Config.INSTANCE.cluster(ALT_CLUSTER_ID)
+        alt_cluster.reload()
+
+        self.assertEqual(cluster_2, alt_cluster)
+        self.assertEqual(cluster_2.location_id, alt_cluster.location_id)
+        self.assertEqual(alt_cluster.state, Cluster.State.READY)
+        self.assertEqual(cluster_2.serve_nodes, alt_cluster.serve_nodes)
+        self.assertEqual(
+            cluster_2.default_storage_type, alt_cluster.default_storage_type
+        )
+
+        # Delete the newly created cluster and confirm
+        self.assertTrue(cluster_2.exists())
+        cluster_2.delete()
+        self.assertFalse(cluster_2.exists())
+
+    def _test_create_app_profile_helper(
+        self,
+        app_profile_id,
+        instance,
+        routing_policy_type,
+        description=None,
+        cluster_id=None,
+        allow_transactional_writes=None,
+        ignore_warnings=None,
+    ):
+
+        app_profile = instance.app_profile(
+            app_profile_id=app_profile_id,
+            routing_policy_type=routing_policy_type,
+            description=description,
+            cluster_id=cluster_id,
+            allow_transactional_writes=allow_transactional_writes,
+        )
+        self.assertEqual(
+            app_profile.allow_transactional_writes, allow_transactional_writes
+        )
+
+        app_profile = app_profile.create(ignore_warnings=ignore_warnings)
+
+        # Load a different app_profile objec form the server and
+        # verrify that it is the same
+        alt_app_profile = instance.app_profile(app_profile_id)
+        alt_app_profile.reload()
+
+        self.assertEqual(app_profile.app_profile_id, alt_app_profile.app_profile_id)
+        self.assertEqual(app_profile.routing_policy_type, routing_policy_type)
+        self.assertEqual(alt_app_profile.routing_policy_type, routing_policy_type)
+        self.assertEqual(app_profile.description, alt_app_profile.description)
+        self.assertFalse(app_profile.allow_transactional_writes)
+        self.assertFalse(alt_app_profile.allow_transactional_writes)
+
+    def _test_list_app_profiles_helper(self, instance, app_profile_ids):
+        app_profiles = instance.list_app_profiles()
+        found = [app_prof.app_profile_id for app_prof in app_profiles]
+        for app_profile_id in app_profile_ids:
+            self.assertTrue(app_profile_id in found)
+
+    def _test_modify_app_profile_helper(
+        self,
+        app_profile_id,
+        instance,
+        routing_policy_type,
+        description=None,
+        cluster_id=None,
+        allow_transactional_writes=None,
+        ignore_warnings=None,
+    ):
+        app_profile = instance.app_profile(
+            app_profile_id=app_profile_id,
+            routing_policy_type=routing_policy_type,
+            description=description,
+            cluster_id=cluster_id,
+            allow_transactional_writes=allow_transactional_writes,
+        )
+
+        operation = app_profile.update(ignore_warnings)
+        operation.result(timeout=30)
+
+        alt_app_profile = instance.app_profile(app_profile_id)
+        alt_app_profile.reload()
+        self.assertEqual(alt_app_profile.description, description)
+        self.assertEqual(alt_app_profile.routing_policy_type, routing_policy_type)
+        self.assertEqual(alt_app_profile.cluster_id, cluster_id)
+        self.assertEqual(
+            alt_app_profile.allow_transactional_writes, allow_transactional_writes
+        )
+
+    def _test_delete_app_profile_helper(self, app_profile_id, instance):
+        app_profile = instance.app_profile(app_profile_id)
+        self.assertTrue(app_profile.exists())
+        app_profile.delete(ignore_warnings=True)
+        self.assertFalse(app_profile.exists())
+
+
+class TestTableAdminAPI(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls._table = Config.INSTANCE_DATA.table(TABLE_ID)
+        cls._table.create()
+
+    @classmethod
+    def tearDownClass(cls):
+        cls._table.delete()
+
+    def setUp(self):
+        self.tables_to_delete = []
+
+    def tearDown(self):
+        for table in self.tables_to_delete:
+            table.delete()
+
+    def test_list_tables(self):
+        # Since `Config.INSTANCE_DATA` is newly created in `setUpModule`, the
+        # table created in `setUpClass` here will be the only one.
+        tables = Config.INSTANCE_DATA.list_tables()
+        self.assertEqual(tables, [self._table])
+
+    def test_exists(self):
+        retry_until_true = RetryResult(lambda result: result)
+        retry_until_false = RetryResult(lambda result: not result)
+        temp_table_id = "test-table_existence"
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        self.assertFalse(temp_table.exists())
+        temp_table.create()
+        self.assertTrue(retry_until_true(temp_table.exists)())
+        temp_table.delete()
+        self.assertFalse(retry_until_false(temp_table.exists)())
+
+    def test_create_table(self):
+        temp_table_id = "test-create-table"
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        temp_table.create()
+        self.tables_to_delete.append(temp_table)
+
+        # First, create a sorted version of our expected result.
+        name_attr = operator.attrgetter("name")
+        expected_tables = sorted([temp_table, self._table], key=name_attr)
+
+        # Then query for the tables in the instance and sort them by
+        # name as well.
+        tables = Config.INSTANCE_DATA.list_tables()
+        sorted_tables = sorted(tables, key=name_attr)
+        self.assertEqual(sorted_tables, expected_tables)
+
+    def test_create_table_with_families(self):
+        temp_table_id = "test-create-table-with-failies"
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        gc_rule = MaxVersionsGCRule(1)
+        temp_table.create(column_families={COLUMN_FAMILY_ID1: gc_rule})
+        self.tables_to_delete.append(temp_table)
+
+        col_fams = temp_table.list_column_families()
+
+        self.assertEqual(len(col_fams), 1)
+        retrieved_col_fam = col_fams[COLUMN_FAMILY_ID1]
+        self.assertIs(retrieved_col_fam._table, temp_table)
+        self.assertEqual(retrieved_col_fam.column_family_id, COLUMN_FAMILY_ID1)
+        self.assertEqual(retrieved_col_fam.gc_rule, gc_rule)
+
+    def test_create_table_with_split_keys(self):
+        temp_table_id = "foo-bar-baz-split-table"
+        initial_split_keys = [b"split_key_1", b"split_key_10", b"split_key_20"]
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        temp_table.create(initial_split_keys=initial_split_keys)
+        self.tables_to_delete.append(temp_table)
+
+        # Read Sample Row Keys for created splits
+        sample_row_keys = temp_table.sample_row_keys()
+        actual_keys = [srk.row_key for srk in sample_row_keys]
+
+        expected_keys = initial_split_keys
+        expected_keys.append(b"")
+
+        self.assertEqual(actual_keys, expected_keys)
+
+    def test_create_column_family(self):
+        temp_table_id = "test-create-column-family"
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        temp_table.create()
+        self.tables_to_delete.append(temp_table)
+
+        self.assertEqual(temp_table.list_column_families(), {})
+        gc_rule = MaxVersionsGCRule(1)
+        column_family = temp_table.column_family(COLUMN_FAMILY_ID1, gc_rule=gc_rule)
+        column_family.create()
+
+        col_fams = temp_table.list_column_families()
+
+        self.assertEqual(len(col_fams), 1)
+        retrieved_col_fam = col_fams[COLUMN_FAMILY_ID1]
+        self.assertIs(retrieved_col_fam._table, column_family._table)
+        self.assertEqual(
+            retrieved_col_fam.column_family_id, column_family.column_family_id
+        )
+        self.assertEqual(retrieved_col_fam.gc_rule, gc_rule)
+
+    def test_update_column_family(self):
+        temp_table_id = "test-update-column-family"
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        temp_table.create()
+        self.tables_to_delete.append(temp_table)
+
+        gc_rule = MaxVersionsGCRule(1)
+        column_family = temp_table.column_family(COLUMN_FAMILY_ID1, gc_rule=gc_rule)
+        column_family.create()
+
+        # Check that our created table is as expected.
+        col_fams = temp_table.list_column_families()
+        self.assertEqual(col_fams, {COLUMN_FAMILY_ID1: column_family})
+
+        # Update the column family's GC rule and then try to update.
+        column_family.gc_rule = None
+        column_family.update()
+
+        # Check that the update has propagated.
+        col_fams = temp_table.list_column_families()
+        self.assertIsNone(col_fams[COLUMN_FAMILY_ID1].gc_rule)
+
+    def test_delete_column_family(self):
+        temp_table_id = "test-delete-column-family"
+        temp_table = Config.INSTANCE_DATA.table(temp_table_id)
+        temp_table.create()
+        self.tables_to_delete.append(temp_table)
+
+        self.assertEqual(temp_table.list_column_families(), {})
+        column_family = temp_table.column_family(COLUMN_FAMILY_ID1)
+        column_family.create()
+
+        # Make sure the family is there before deleting it.
+        col_fams = temp_table.list_column_families()
+        self.assertEqual(list(col_fams.keys()), [COLUMN_FAMILY_ID1])
+
+        column_family.delete()
+        # Make sure we have successfully deleted it.
+        self.assertEqual(temp_table.list_column_families(), {})
+
+
+class TestDataAPI(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls._table = table = Config.INSTANCE_DATA.table("test-data-api")
+        table.create()
+        table.column_family(COLUMN_FAMILY_ID1).create()
+        table.column_family(COLUMN_FAMILY_ID2).create()
+
+    @classmethod
+    def tearDownClass(cls):
+        # Will also delete any data contained in the table.
+        cls._table.delete()
+
+    def _maybe_emulator_skip(self, message):
+        # NOTE: This method is necessary because ``Config.IN_EMULATOR``
+        #       is set at runtime rather than import time, which means we
+        #       can't use the @unittest.skipIf decorator.
+        if Config.IN_EMULATOR:
+            self.skipTest(message)
+
+    def setUp(self):
+        self.rows_to_delete = []
+
+    def tearDown(self):
+        for row in self.rows_to_delete:
+            row.clear()
+            row.delete()
+            row.commit()
+
+    def _write_to_row(self, row1=None, row2=None, row3=None, row4=None):
+        timestamp1 = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        timestamp1_micros = _microseconds_from_datetime(timestamp1)
+        # Truncate to millisecond granularity.
+        timestamp1_micros -= timestamp1_micros % 1000
+        timestamp1 = _datetime_from_microseconds(timestamp1_micros)
+        # 1000 microseconds is a millisecond
+        timestamp2 = timestamp1 + datetime.timedelta(microseconds=1000)
+        timestamp2_micros = _microseconds_from_datetime(timestamp2)
+        timestamp3 = timestamp1 + datetime.timedelta(microseconds=2000)
+        timestamp3_micros = _microseconds_from_datetime(timestamp3)
+        timestamp4 = timestamp1 + datetime.timedelta(microseconds=3000)
+        timestamp4_micros = _microseconds_from_datetime(timestamp4)
+
+        if row1 is not None:
+            row1.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL1, timestamp=timestamp1)
+        if row2 is not None:
+            row2.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL2, timestamp=timestamp2)
+        if row3 is not None:
+            row3.set_cell(COLUMN_FAMILY_ID1, COL_NAME2, CELL_VAL3, timestamp=timestamp3)
+        if row4 is not None:
+            row4.set_cell(COLUMN_FAMILY_ID2, COL_NAME3, CELL_VAL4, timestamp=timestamp4)
+
+        # Create the cells we will check.
+        cell1 = Cell(CELL_VAL1, timestamp1_micros)
+        cell2 = Cell(CELL_VAL2, timestamp2_micros)
+        cell3 = Cell(CELL_VAL3, timestamp3_micros)
+        cell4 = Cell(CELL_VAL4, timestamp4_micros)
+        return cell1, cell2, cell3, cell4
+
+    def test_timestamp_filter_millisecond_granularity(self):
+        from google.cloud.bigtable import row_filters
+
+        end = datetime.datetime.now()
+        start = end - datetime.timedelta(minutes=60)
+        timestamp_range = row_filters.TimestampRange(start=start, end=end)
+        timefilter = row_filters.TimestampRangeFilter(timestamp_range)
+        row_data = self._table.read_rows(filter_=timefilter)
+        row_data.consume_all()
+
+    def test_mutate_rows(self):
+        row1 = self._table.row(ROW_KEY)
+        row1.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL1)
+        row1.commit()
+        self.rows_to_delete.append(row1)
+        row2 = self._table.row(ROW_KEY_ALT)
+        row2.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL2)
+        row2.commit()
+        self.rows_to_delete.append(row2)
+
+        # Change the contents
+        row1.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL3)
+        row2.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL4)
+        rows = [row1, row2]
+        statuses = self._table.mutate_rows(rows)
+        result = [status.code for status in statuses]
+        expected_result = [0, 0]
+        self.assertEqual(result, expected_result)
+
+        # Check the contents
+        row1_data = self._table.read_row(ROW_KEY)
+        self.assertEqual(
+            row1_data.cells[COLUMN_FAMILY_ID1][COL_NAME1][0].value, CELL_VAL3
+        )
+        row2_data = self._table.read_row(ROW_KEY_ALT)
+        self.assertEqual(
+            row2_data.cells[COLUMN_FAMILY_ID1][COL_NAME1][0].value, CELL_VAL4
+        )
+
+    def test_truncate_table(self):
+        row_keys = [
+            b"row_key_1",
+            b"row_key_2",
+            b"row_key_3",
+            b"row_key_4",
+            b"row_key_5",
+            b"row_key_pr_1",
+            b"row_key_pr_2",
+            b"row_key_pr_3",
+            b"row_key_pr_4",
+            b"row_key_pr_5",
+        ]
+
+        for row_key in row_keys:
+            row = self._table.row(row_key)
+            row.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL1)
+            row.commit()
+            self.rows_to_delete.append(row)
+
+        self._table.truncate(timeout=200)
+
+        read_rows = self._table.yield_rows()
+
+        for row in read_rows:
+            self.assertNotIn(row.row_key.decode("utf-8"), row_keys)
+
+    def test_drop_by_prefix_table(self):
+        row_keys = [
+            b"row_key_1",
+            b"row_key_2",
+            b"row_key_3",
+            b"row_key_4",
+            b"row_key_5",
+            b"row_key_pr_1",
+            b"row_key_pr_2",
+            b"row_key_pr_3",
+            b"row_key_pr_4",
+            b"row_key_pr_5",
+        ]
+
+        for row_key in row_keys:
+            row = self._table.row(row_key)
+            row.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL1)
+            row.commit()
+            self.rows_to_delete.append(row)
+
+        self._table.drop_by_prefix(row_key_prefix="row_key_pr", timeout=200)
+
+        read_rows = self._table.yield_rows()
+        expected_rows_count = 5
+        read_rows_count = 0
+
+        for row in read_rows:
+            if row.row_key in row_keys:
+                read_rows_count += 1
+
+        self.assertEqual(expected_rows_count, read_rows_count)
+
+    def test_yield_rows_with_row_set(self):
+        row_keys = [
+            b"row_key_1",
+            b"row_key_2",
+            b"row_key_3",
+            b"row_key_4",
+            b"row_key_5",
+            b"row_key_6",
+            b"row_key_7",
+            b"row_key_8",
+            b"row_key_9",
+        ]
+
+        rows = []
+        for row_key in row_keys:
+            row = self._table.row(row_key)
+            row.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL1)
+            rows.append(row)
+            self.rows_to_delete.append(row)
+        self._table.mutate_rows(rows)
+
+        row_set = RowSet()
+        row_set.add_row_range(RowRange(start_key=b"row_key_3", end_key=b"row_key_7"))
+        row_set.add_row_key(b"row_key_1")
+
+        read_rows = self._table.yield_rows(row_set=row_set)
+
+        expected_row_keys = [
+            b"row_key_1",
+            b"row_key_3",
+            b"row_key_4",
+            b"row_key_5",
+            b"row_key_6",
+        ]
+        found_row_keys = [row.row_key for row in read_rows]
+        self.assertEqual(found_row_keys, expected_row_keys)
+
+    def test_read_large_cell_limit(self):
+        row = self._table.row(ROW_KEY)
+        self.rows_to_delete.append(row)
+
+        number_of_bytes = 10 * 1024 * 1024
+        data = b"1" * number_of_bytes  # 10MB of 1's.
+        row.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, data)
+        row.commit()
+
+        # Read back the contents of the row.
+        partial_row_data = self._table.read_row(ROW_KEY)
+        self.assertEqual(partial_row_data.row_key, ROW_KEY)
+        cell = partial_row_data.cells[COLUMN_FAMILY_ID1]
+        column = cell[COL_NAME1]
+        self.assertEqual(len(column), 1)
+        self.assertEqual(column[0].value, data)
+
+    def test_read_row(self):
+        row = self._table.row(ROW_KEY)
+        self.rows_to_delete.append(row)
+
+        cell1, cell2, cell3, cell4 = self._write_to_row(row, row, row, row)
+        row.commit()
+
+        # Read back the contents of the row.
+        partial_row_data = self._table.read_row(ROW_KEY)
+        self.assertEqual(partial_row_data.row_key, ROW_KEY)
+
+        # Check the cells match.
+        ts_attr = operator.attrgetter("timestamp")
+        expected_row_contents = {
+            COLUMN_FAMILY_ID1: {
+                COL_NAME1: sorted([cell1, cell2], key=ts_attr, reverse=True),
+                COL_NAME2: [cell3],
+            },
+            COLUMN_FAMILY_ID2: {COL_NAME3: [cell4]},
+        }
+        self.assertEqual(partial_row_data.cells, expected_row_contents)
+
+    def test_read_rows(self):
+        row = self._table.row(ROW_KEY)
+        row_alt = self._table.row(ROW_KEY_ALT)
+        self.rows_to_delete.extend([row, row_alt])
+
+        cell1, cell2, cell3, cell4 = self._write_to_row(row, row_alt, row, row_alt)
+        row.commit()
+        row_alt.commit()
+
+        rows_data = self._table.read_rows()
+        self.assertEqual(rows_data.rows, {})
+        rows_data.consume_all()
+
+        # NOTE: We should refrain from editing protected data on instances.
+        #       Instead we should make the values public or provide factories
+        #       for constructing objects with them.
+        row_data = PartialRowData(ROW_KEY)
+        row_data._chunks_encountered = True
+        row_data._committed = True
+        row_data._cells = {COLUMN_FAMILY_ID1: {COL_NAME1: [cell1], COL_NAME2: [cell3]}}
+
+        row_alt_data = PartialRowData(ROW_KEY_ALT)
+        row_alt_data._chunks_encountered = True
+        row_alt_data._committed = True
+        row_alt_data._cells = {
+            COLUMN_FAMILY_ID1: {COL_NAME1: [cell2]},
+            COLUMN_FAMILY_ID2: {COL_NAME3: [cell4]},
+        }
+
+        expected_rows = {ROW_KEY: row_data, ROW_KEY_ALT: row_alt_data}
+        self.assertEqual(rows_data.rows, expected_rows)
+
+    def test_read_with_label_applied(self):
+        self._maybe_emulator_skip("Labels not supported by Bigtable emulator")
+        row = self._table.row(ROW_KEY)
+        self.rows_to_delete.append(row)
+
+        cell1, _, cell3, _ = self._write_to_row(row, None, row)
+        row.commit()
+
+        # Combine a label with column 1.
+        label1 = u"label-red"
+        label1_filter = ApplyLabelFilter(label1)
+        col1_filter = ColumnQualifierRegexFilter(COL_NAME1)
+        chain1 = RowFilterChain(filters=[col1_filter, label1_filter])
+
+        # Combine a label with column 2.
+        label2 = u"label-blue"
+        label2_filter = ApplyLabelFilter(label2)
+        col2_filter = ColumnQualifierRegexFilter(COL_NAME2)
+        chain2 = RowFilterChain(filters=[col2_filter, label2_filter])
+
+        # Bring our two labeled columns together.
+        row_filter = RowFilterUnion(filters=[chain1, chain2])
+        partial_row_data = self._table.read_row(ROW_KEY, filter_=row_filter)
+        self.assertEqual(partial_row_data.row_key, ROW_KEY)
+
+        cells_returned = partial_row_data.cells
+        col_fam1 = cells_returned.pop(COLUMN_FAMILY_ID1)
+        # Make sure COLUMN_FAMILY_ID1 was the only key.
+        self.assertEqual(len(cells_returned), 0)
+
+        cell1_new, = col_fam1.pop(COL_NAME1)
+        cell3_new, = col_fam1.pop(COL_NAME2)
+        # Make sure COL_NAME1 and COL_NAME2 were the only keys.
+        self.assertEqual(len(col_fam1), 0)
+
+        # Check that cell1 has matching values and gained a label.
+        self.assertEqual(cell1_new.value, cell1.value)
+        self.assertEqual(cell1_new.timestamp, cell1.timestamp)
+        self.assertEqual(cell1.labels, [])
+        self.assertEqual(cell1_new.labels, [label1])
+
+        # Check that cell3 has matching values and gained a label.
+        self.assertEqual(cell3_new.value, cell3.value)
+        self.assertEqual(cell3_new.timestamp, cell3.timestamp)
+        self.assertEqual(cell3.labels, [])
+        self.assertEqual(cell3_new.labels, [label2])
+
+    def test_access_with_non_admin_client(self):
+        client = Client(admin=False)
+        instance = client.instance(INSTANCE_ID_DATA)
+        table = instance.table(self._table.table_id)
+        self.assertIsNone(table.read_row("nonesuch"))
diff --git a/bigtable/tests/unit/__init__.py b/bigtable/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/bigtable/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/bigtable/tests/unit/_testing.py b/bigtable/tests/unit/_testing.py
new file mode 100644
index 000000000000..302d33ac1540
--- /dev/null
+++ b/bigtable/tests/unit/_testing.py
@@ -0,0 +1,37 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Mocks used to emulate gRPC generated objects."""
+
+
+import mock
+
+
+class _FakeStub(object):
+    """Acts as a gPRC stub."""
+
+    def __init__(self, *results):
+        self.results = results
+        self.method_calls = []
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    class _CredentialsWithScopes(
+        google.auth.credentials.Credentials, google.auth.credentials.Scoped
+    ):
+        pass
+
+    return mock.Mock(spec=_CredentialsWithScopes)
diff --git a/bigtable/tests/unit/gapic/v2/test_bigtable_client_v2.py b/bigtable/tests/unit/gapic/v2/test_bigtable_client_v2.py
new file mode 100644
index 000000000000..c575a83e3cc7
--- /dev/null
+++ b/bigtable/tests/unit/gapic/v2/test_bigtable_client_v2.py
@@ -0,0 +1,316 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import bigtable_v2
+from google.cloud.bigtable_v2.proto import bigtable_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestBigtableClient(object):
+    def test_read_rows(self):
+        # Setup Expected Response
+        last_scanned_row_key = b"-126"
+        expected_response = {"last_scanned_row_key": last_scanned_row_key}
+        expected_response = bigtable_pb2.ReadRowsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup Request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        response = client.read_rows(table_name)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_pb2.ReadRowsRequest(table_name=table_name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_read_rows_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        with pytest.raises(CustomException):
+            client.read_rows(table_name)
+
+    def test_sample_row_keys(self):
+        # Setup Expected Response
+        row_key = b"122"
+        offset_bytes = 889884095
+        expected_response = {"row_key": row_key, "offset_bytes": offset_bytes}
+        expected_response = bigtable_pb2.SampleRowKeysResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup Request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        response = client.sample_row_keys(table_name)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_pb2.SampleRowKeysRequest(table_name=table_name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_sample_row_keys_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        with pytest.raises(CustomException):
+            client.sample_row_keys(table_name)
+
+    def test_mutate_row(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = bigtable_pb2.MutateRowResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup Request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        row_key = b"122"
+        mutations = []
+
+        response = client.mutate_row(table_name, row_key, mutations)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_pb2.MutateRowRequest(
+            table_name=table_name, row_key=row_key, mutations=mutations
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_mutate_row_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        row_key = b"122"
+        mutations = []
+
+        with pytest.raises(CustomException):
+            client.mutate_row(table_name, row_key, mutations)
+
+    def test_mutate_rows(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = bigtable_pb2.MutateRowsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup Request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        entries = []
+
+        response = client.mutate_rows(table_name, entries)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_pb2.MutateRowsRequest(
+            table_name=table_name, entries=entries
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_mutate_rows_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        entries = []
+
+        with pytest.raises(CustomException):
+            client.mutate_rows(table_name, entries)
+
+    def test_check_and_mutate_row(self):
+        # Setup Expected Response
+        predicate_matched = True
+        expected_response = {"predicate_matched": predicate_matched}
+        expected_response = bigtable_pb2.CheckAndMutateRowResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup Request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        row_key = b"122"
+
+        response = client.check_and_mutate_row(table_name, row_key)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_pb2.CheckAndMutateRowRequest(
+            table_name=table_name, row_key=row_key
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_check_and_mutate_row_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        row_key = b"122"
+
+        with pytest.raises(CustomException):
+            client.check_and_mutate_row(table_name, row_key)
+
+    def test_read_modify_write_row(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = bigtable_pb2.ReadModifyWriteRowResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup Request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        row_key = b"122"
+        rules = []
+
+        response = client.read_modify_write_row(table_name, row_key, rules)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_pb2.ReadModifyWriteRowRequest(
+            table_name=table_name, row_key=row_key, rules=rules
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_read_modify_write_row_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_v2.BigtableClient()
+
+        # Setup request
+        table_name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        row_key = b"122"
+        rules = []
+
+        with pytest.raises(CustomException):
+            client.read_modify_write_row(table_name, row_key, rules)
diff --git a/bigtable/tests/unit/gapic/v2/test_bigtable_instance_admin_client_v2.py b/bigtable/tests/unit/gapic/v2/test_bigtable_instance_admin_client_v2.py
new file mode 100644
index 000000000000..d127d63178a4
--- /dev/null
+++ b/bigtable/tests/unit/gapic/v2/test_bigtable_instance_admin_client_v2.py
@@ -0,0 +1,937 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import bigtable_admin_v2
+from google.cloud.bigtable_admin_v2 import enums
+from google.cloud.bigtable_admin_v2.proto import bigtable_instance_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import instance_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestBigtableInstanceAdminClient(object):
+    def test_create_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = instance_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        instance_id = "instanceId-2101995259"
+        instance = {}
+        clusters = {}
+
+        response = client.create_instance(parent, instance_id, instance, clusters)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance, clusters=clusters
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        instance_id = "instanceId-2101995259"
+        instance = {}
+        clusters = {}
+
+        response = client.create_instance(parent, instance_id, instance, clusters)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = instance_pb2.Instance(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        response = client.get_instance(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.GetInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.get_instance(name)
+
+    def test_list_instances(self):
+        # Setup Expected Response
+        next_page_token = "nextPageToken-1530815211"
+        expected_response = {"next_page_token": next_page_token}
+        expected_response = bigtable_instance_admin_pb2.ListInstancesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.list_instances(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.ListInstancesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_instances_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.list_instances(parent)
+
+    def test_update_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name_2 = "displayName21615000987"
+        expected_response = {"name": name_2, "display_name": display_name_2}
+        expected_response = instance_pb2.Instance(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+        display_name = "displayName1615086568"
+        type_ = enums.Instance.Type.TYPE_UNSPECIFIED
+        labels = {}
+
+        response = client.update_instance(name, display_name, type_, labels)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = instance_pb2.Instance(
+            name=name, display_name=display_name, type=type_, labels=labels
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+        display_name = "displayName1615086568"
+        type_ = enums.Instance.Type.TYPE_UNSPECIFIED
+        labels = {}
+
+        with pytest.raises(CustomException):
+            client.update_instance(name, display_name, type_, labels)
+
+    def test_partial_update_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = instance_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_partial_update_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        instance = {}
+        update_mask = {}
+
+        response = client.partial_update_instance(instance, update_mask)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.PartialUpdateInstanceRequest(
+            instance=instance, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_partial_update_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_partial_update_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        instance = {}
+        update_mask = {}
+
+        response = client.partial_update_instance(instance, update_mask)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_instance(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        client.delete_instance(name)
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.DeleteInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.delete_instance(name)
+
+    def test_create_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        location = "location1901043637"
+        serve_nodes = 1288838783
+        expected_response = {
+            "name": name,
+            "location": location,
+            "serve_nodes": serve_nodes,
+        }
+        expected_response = instance_pb2.Cluster(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        cluster_id = "clusterId240280960"
+        cluster = {}
+
+        response = client.create_cluster(parent, cluster_id, cluster)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.CreateClusterRequest(
+            parent=parent, cluster_id=cluster_id, cluster=cluster
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        cluster_id = "clusterId240280960"
+        cluster = {}
+
+        response = client.create_cluster(parent, cluster_id, cluster)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_cluster(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        location = "location1901043637"
+        serve_nodes = 1288838783
+        expected_response = {
+            "name": name_2,
+            "location": location,
+            "serve_nodes": serve_nodes,
+        }
+        expected_response = instance_pb2.Cluster(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+
+        response = client.get_cluster(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.GetClusterRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+
+        with pytest.raises(CustomException):
+            client.get_cluster(name)
+
+    def test_list_clusters(self):
+        # Setup Expected Response
+        next_page_token = "nextPageToken-1530815211"
+        expected_response = {"next_page_token": next_page_token}
+        expected_response = bigtable_instance_admin_pb2.ListClustersResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        response = client.list_clusters(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.ListClustersRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_clusters_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.list_clusters(parent)
+
+    def test_update_cluster(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        location = "location1901043637"
+        serve_nodes_2 = 1623486220
+        expected_response = {
+            "name": name_2,
+            "location": location,
+            "serve_nodes": serve_nodes_2,
+        }
+        expected_response = instance_pb2.Cluster(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+        serve_nodes = 1288838783
+
+        response = client.update_cluster(name, serve_nodes)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = instance_pb2.Cluster(name=name, serve_nodes=serve_nodes)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+        serve_nodes = 1288838783
+
+        response = client.update_cluster(name, serve_nodes)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_cluster(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+
+        client.delete_cluster(name)
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.DeleteClusterRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+
+        with pytest.raises(CustomException):
+            client.delete_cluster(name)
+
+    def test_create_app_profile(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        description = "description-1724546052"
+        expected_response = {"name": name, "etag": etag, "description": description}
+        expected_response = instance_pb2.AppProfile(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        app_profile_id = "appProfileId1262094415"
+        app_profile = {}
+
+        response = client.create_app_profile(parent, app_profile_id, app_profile)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.CreateAppProfileRequest(
+            parent=parent, app_profile_id=app_profile_id, app_profile=app_profile
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_app_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        app_profile_id = "appProfileId1262094415"
+        app_profile = {}
+
+        with pytest.raises(CustomException):
+            client.create_app_profile(parent, app_profile_id, app_profile)
+
+    def test_get_app_profile(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        etag = "etag3123477"
+        description = "description-1724546052"
+        expected_response = {"name": name_2, "etag": etag, "description": description}
+        expected_response = instance_pb2.AppProfile(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.app_profile_path("[PROJECT]", "[INSTANCE]", "[APP_PROFILE]")
+
+        response = client.get_app_profile(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.GetAppProfileRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_app_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.app_profile_path("[PROJECT]", "[INSTANCE]", "[APP_PROFILE]")
+
+        with pytest.raises(CustomException):
+            client.get_app_profile(name)
+
+    def test_list_app_profiles(self):
+        # Setup Expected Response
+        next_page_token = ""
+        app_profiles_element = {}
+        app_profiles = [app_profiles_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "app_profiles": app_profiles,
+        }
+        expected_response = bigtable_instance_admin_pb2.ListAppProfilesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        paged_list_response = client.list_app_profiles(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.app_profiles[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.ListAppProfilesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_app_profiles_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        paged_list_response = client.list_app_profiles(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_app_profile(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        description = "description-1724546052"
+        expected_response = {"name": name, "etag": etag, "description": description}
+        expected_response = instance_pb2.AppProfile(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_app_profile", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        app_profile = {}
+        update_mask = {}
+
+        response = client.update_app_profile(app_profile, update_mask)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.UpdateAppProfileRequest(
+            app_profile=app_profile, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_app_profile_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_app_profile_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        app_profile = {}
+        update_mask = {}
+
+        response = client.update_app_profile(app_profile, update_mask)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_app_profile(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        name = client.app_profile_path("[PROJECT]", "[INSTANCE]", "[APP_PROFILE]")
+        ignore_warnings = True
+
+        client.delete_app_profile(name, ignore_warnings)
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_instance_admin_pb2.DeleteAppProfileRequest(
+            name=name, ignore_warnings=ignore_warnings
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_app_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        name = client.app_profile_path("[PROJECT]", "[INSTANCE]", "[APP_PROFILE]")
+        ignore_warnings = True
+
+        with pytest.raises(CustomException):
+            client.delete_app_profile(name, ignore_warnings)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"etag3123477"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"etag3123477"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup Request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableInstanceAdminClient()
+
+        # Setup request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/bigtable/tests/unit/gapic/v2/test_bigtable_table_admin_client_v2.py b/bigtable/tests/unit/gapic/v2/test_bigtable_table_admin_client_v2.py
new file mode 100644
index 000000000000..786a8357c321
--- /dev/null
+++ b/bigtable/tests/unit/gapic/v2/test_bigtable_table_admin_client_v2.py
@@ -0,0 +1,633 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import bigtable_admin_v2
+from google.cloud.bigtable_admin_v2.proto import bigtable_table_admin_pb2
+from google.cloud.bigtable_admin_v2.proto import table_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestBigtableTableAdminClient(object):
+    def test_create_table(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = table_pb2.Table(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        table_id = "tableId-895419604"
+        table = {}
+
+        response = client.create_table(parent, table_id, table)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.CreateTableRequest(
+            parent=parent, table_id=table_id, table=table
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_table_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        table_id = "tableId-895419604"
+        table = {}
+
+        with pytest.raises(CustomException):
+            client.create_table(parent, table_id, table)
+
+    def test_create_table_from_snapshot(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = table_pb2.Table(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_table_from_snapshot", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        table_id = "tableId-895419604"
+        source_snapshot = "sourceSnapshot-947679896"
+
+        response = client.create_table_from_snapshot(parent, table_id, source_snapshot)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.CreateTableFromSnapshotRequest(
+            parent=parent, table_id=table_id, source_snapshot=source_snapshot
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_table_from_snapshot_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_table_from_snapshot_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        table_id = "tableId-895419604"
+        source_snapshot = "sourceSnapshot-947679896"
+
+        response = client.create_table_from_snapshot(parent, table_id, source_snapshot)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_list_tables(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tables_element = {}
+        tables = [tables_element]
+        expected_response = {"next_page_token": next_page_token, "tables": tables}
+        expected_response = bigtable_table_admin_pb2.ListTablesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        paged_list_response = client.list_tables(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tables[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.ListTablesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tables_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        paged_list_response = client.list_tables(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_table(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = table_pb2.Table(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        response = client.get_table(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.GetTableRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_table_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        with pytest.raises(CustomException):
+            client.get_table(name)
+
+    def test_delete_table(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        client.delete_table(name)
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.DeleteTableRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_table_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        with pytest.raises(CustomException):
+            client.delete_table(name)
+
+    def test_modify_column_families(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = table_pb2.Table(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        modifications = []
+
+        response = client.modify_column_families(name, modifications)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.ModifyColumnFamiliesRequest(
+            name=name, modifications=modifications
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_modify_column_families_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        modifications = []
+
+        with pytest.raises(CustomException):
+            client.modify_column_families(name, modifications)
+
+    def test_drop_row_range(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        client.drop_row_range(name)
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.DropRowRangeRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_drop_row_range_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        with pytest.raises(CustomException):
+            client.drop_row_range(name)
+
+    def test_generate_consistency_token(self):
+        # Setup Expected Response
+        consistency_token = "consistencyToken-1090516718"
+        expected_response = {"consistency_token": consistency_token}
+        expected_response = bigtable_table_admin_pb2.GenerateConsistencyTokenResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        response = client.generate_consistency_token(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.GenerateConsistencyTokenRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_generate_consistency_token_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+
+        with pytest.raises(CustomException):
+            client.generate_consistency_token(name)
+
+    def test_check_consistency(self):
+        # Setup Expected Response
+        consistent = True
+        expected_response = {"consistent": consistent}
+        expected_response = bigtable_table_admin_pb2.CheckConsistencyResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        consistency_token = "consistencyToken-1090516718"
+
+        response = client.check_consistency(name, consistency_token)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.CheckConsistencyRequest(
+            name=name, consistency_token=consistency_token
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_check_consistency_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        consistency_token = "consistencyToken-1090516718"
+
+        with pytest.raises(CustomException):
+            client.check_consistency(name, consistency_token)
+
+    def test_snapshot_table(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        data_size_bytes = 2110122398
+        description_2 = "description2568623279"
+        expected_response = {
+            "name": name_2,
+            "data_size_bytes": data_size_bytes,
+            "description": description_2,
+        }
+        expected_response = table_pb2.Snapshot(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_snapshot_table", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        cluster = "cluster872092154"
+        snapshot_id = "snapshotId-168585866"
+        description = "description-1724546052"
+
+        response = client.snapshot_table(name, cluster, snapshot_id, description)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.SnapshotTableRequest(
+            name=name, cluster=cluster, snapshot_id=snapshot_id, description=description
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_snapshot_table_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_snapshot_table_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.table_path("[PROJECT]", "[INSTANCE]", "[TABLE]")
+        cluster = "cluster872092154"
+        snapshot_id = "snapshotId-168585866"
+        description = "description-1724546052"
+
+        response = client.snapshot_table(name, cluster, snapshot_id, description)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_snapshot(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        data_size_bytes = 2110122398
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "data_size_bytes": data_size_bytes,
+            "description": description,
+        }
+        expected_response = table_pb2.Snapshot(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.snapshot_path(
+            "[PROJECT]", "[INSTANCE]", "[CLUSTER]", "[SNAPSHOT]"
+        )
+
+        response = client.get_snapshot(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.GetSnapshotRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_snapshot_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.snapshot_path(
+            "[PROJECT]", "[INSTANCE]", "[CLUSTER]", "[SNAPSHOT]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_snapshot(name)
+
+    def test_list_snapshots(self):
+        # Setup Expected Response
+        next_page_token = ""
+        snapshots_element = {}
+        snapshots = [snapshots_element]
+        expected_response = {"next_page_token": next_page_token, "snapshots": snapshots}
+        expected_response = bigtable_table_admin_pb2.ListSnapshotsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        parent = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+
+        paged_list_response = client.list_snapshots(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.snapshots[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.ListSnapshotsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_snapshots_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        parent = client.cluster_path("[PROJECT]", "[INSTANCE]", "[CLUSTER]")
+
+        paged_list_response = client.list_snapshots(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_snapshot(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup Request
+        name = client.snapshot_path(
+            "[PROJECT]", "[INSTANCE]", "[CLUSTER]", "[SNAPSHOT]"
+        )
+
+        client.delete_snapshot(name)
+
+        assert len(channel.requests) == 1
+        expected_request = bigtable_table_admin_pb2.DeleteSnapshotRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_snapshot_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = bigtable_admin_v2.BigtableTableAdminClient()
+
+        # Setup request
+        name = client.snapshot_path(
+            "[PROJECT]", "[INSTANCE]", "[CLUSTER]", "[SNAPSHOT]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_snapshot(name)
diff --git a/unit_tests/bigtable/read-rows-acceptance-test.json b/bigtable/tests/unit/read-rows-acceptance-test.json
similarity index 97%
rename from unit_tests/bigtable/read-rows-acceptance-test.json
rename to bigtable/tests/unit/read-rows-acceptance-test.json
index 4973831f4979..cfa8a17f327b 100644
--- a/unit_tests/bigtable/read-rows-acceptance-test.json
+++ b/bigtable/tests/unit/read-rows-acceptance-test.json
@@ -1173,6 +1173,33 @@
           "error": false
         }
       ]
+    },
+    {
+      "name": "empty second qualifier",
+      "chunks": [
+        "row_key: \"RK\"\nfamily_name: \u003c\n  value: \"A\"\n\u003e\nqualifier: \u003c\n  value: \"C\"\n\u003e\ntimestamp_micros: 99\nvalue: \"value-VAL_1\"\ncommit_row: false\n",
+        "qualifier: \u003c\n  value: \"\"\n\u003e\ntimestamp_micros: 98\nvalue: \"value-VAL_2\"\ncommit_row: true\n"
+      ],
+      "results": [
+        {
+          "rk": "RK",
+          "fm": "A",
+          "qual": "C",
+          "ts": 99,
+          "value": "value-VAL_1",
+          "label": "",
+          "error": false
+        },
+        {
+          "rk": "RK",
+          "fm": "A",
+          "qual": "",
+          "ts": 98,
+          "value": "value-VAL_2",
+          "label": "",
+          "error": false
+        }
+      ]
     }
   ]
-}
\ No newline at end of file
+}
diff --git a/bigtable/tests/unit/test_app_profile.py b/bigtable/tests/unit/test_app_profile.py
new file mode 100644
index 000000000000..f7ec0a85511f
--- /dev/null
+++ b/bigtable/tests/unit/test_app_profile.py
@@ -0,0 +1,672 @@
+# 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.
+
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+        return self.channel_stub.responses.pop()
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class TestAppProfile(unittest.TestCase):
+
+    PROJECT = "project"
+    INSTANCE_ID = "instance-id"
+    APP_PROFILE_ID = "app-profile-id"
+    APP_PROFILE_NAME = "projects/{}/instances/{}/appProfiles/{}".format(
+        PROJECT, INSTANCE_ID, APP_PROFILE_ID
+    )
+    CLUSTER_ID = "cluster-id"
+    OP_ID = 8765
+    OP_NAME = "operations/projects/{}/instances/{}/appProfiles/{}/operations/{}".format(
+        PROJECT, INSTANCE_ID, APP_PROFILE_ID, OP_ID
+    )
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.app_profile import AppProfile
+
+        return AppProfile
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        app_profile = self._make_one(self.APP_PROFILE_ID, instance)
+        self.assertIsInstance(app_profile, self._get_target_class())
+        self.assertEqual(app_profile._instance, instance)
+        self.assertIsNone(app_profile.routing_policy_type)
+        self.assertIsNone(app_profile.description)
+        self.assertIsNone(app_profile.cluster_id)
+        self.assertIsNone(app_profile.allow_transactional_writes)
+
+    def test_constructor_non_defaults(self):
+        from google.cloud.bigtable.enums import RoutingPolicyType
+
+        ANY = RoutingPolicyType.ANY
+        DESCRIPTION_1 = "routing policy any"
+        APP_PROFILE_ID_2 = "app-profile-id-2"
+        SINGLE = RoutingPolicyType.SINGLE
+        DESCRIPTION_2 = "routing policy single"
+        ALLOW_WRITES = True
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        app_profile1 = self._make_one(
+            self.APP_PROFILE_ID,
+            instance,
+            routing_policy_type=ANY,
+            description=DESCRIPTION_1,
+        )
+        app_profile2 = self._make_one(
+            APP_PROFILE_ID_2,
+            instance,
+            routing_policy_type=SINGLE,
+            description=DESCRIPTION_2,
+            cluster_id=self.CLUSTER_ID,
+            allow_transactional_writes=ALLOW_WRITES,
+        )
+        self.assertEqual(app_profile1.app_profile_id, self.APP_PROFILE_ID)
+        self.assertIs(app_profile1._instance, instance)
+        self.assertEqual(app_profile1.routing_policy_type, ANY)
+        self.assertEqual(app_profile1.description, DESCRIPTION_1)
+        self.assertEqual(app_profile2.app_profile_id, APP_PROFILE_ID_2)
+        self.assertIs(app_profile2._instance, instance)
+        self.assertEqual(app_profile2.routing_policy_type, SINGLE)
+        self.assertEqual(app_profile2.description, DESCRIPTION_2)
+        self.assertEqual(app_profile2.cluster_id, self.CLUSTER_ID)
+        self.assertEqual(app_profile2.allow_transactional_writes, ALLOW_WRITES)
+
+    def test_name_property(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        app_profile = self._make_one(self.APP_PROFILE_ID, instance)
+        self.assertEqual(app_profile.name, self.APP_PROFILE_NAME)
+
+    def test___eq__(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        app_profile1 = self._make_one(self.APP_PROFILE_ID, instance)
+        app_profile2 = self._make_one(self.APP_PROFILE_ID, instance)
+        self.assertTrue(app_profile1 == app_profile2)
+
+    def test___eq__type_instance_differ(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        alt_instance = _Instance("other-instance", client)
+        other_object = _Other(self.APP_PROFILE_ID, instance)
+        app_profile1 = self._make_one(self.APP_PROFILE_ID, instance)
+        app_profile2 = self._make_one(self.APP_PROFILE_ID, alt_instance)
+        self.assertFalse(app_profile1 == other_object)
+        self.assertFalse(app_profile1 == app_profile2)
+
+    def test___ne__same_value(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        app_profile1 = self._make_one(self.APP_PROFILE_ID, instance)
+        app_profile2 = self._make_one(self.APP_PROFILE_ID, instance)
+        self.assertFalse(app_profile1 != app_profile2)
+
+    def test___ne__(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        app_profile1 = self._make_one("app_profile_id1", instance)
+        app_profile2 = self._make_one("app_profile_id2", instance)
+        self.assertTrue(app_profile1 != app_profile2)
+
+    def test_from_pb_success_routing_any(self):
+        from google.cloud.bigtable_admin_v2.types import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.enums import RoutingPolicyType
+
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        desctiption = "routing any"
+        routing = RoutingPolicyType.ANY
+        multi_cluster_routing_use_any = (
+            data_v2_pb2.AppProfile.MultiClusterRoutingUseAny()
+        )
+
+        app_profile_pb = data_v2_pb2.AppProfile(
+            name=self.APP_PROFILE_NAME,
+            description=desctiption,
+            multi_cluster_routing_use_any=multi_cluster_routing_use_any,
+        )
+
+        klass = self._get_target_class()
+        app_profile = klass.from_pb(app_profile_pb, instance)
+        self.assertIsInstance(app_profile, klass)
+        self.assertIs(app_profile._instance, instance)
+        self.assertEqual(app_profile.app_profile_id, self.APP_PROFILE_ID)
+        self.assertEqual(app_profile.description, desctiption)
+        self.assertEqual(app_profile.routing_policy_type, routing)
+        self.assertIsNone(app_profile.cluster_id)
+        self.assertEqual(app_profile.allow_transactional_writes, False)
+
+    def test_from_pb_success_routing_single(self):
+        from google.cloud.bigtable_admin_v2.types import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.enums import RoutingPolicyType
+
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        desctiption = "routing single"
+        allow_transactional_writes = True
+        routing = RoutingPolicyType.SINGLE
+        single_cluster_routing = data_v2_pb2.AppProfile.SingleClusterRouting(
+            cluster_id=self.CLUSTER_ID,
+            allow_transactional_writes=allow_transactional_writes,
+        )
+
+        app_profile_pb = data_v2_pb2.AppProfile(
+            name=self.APP_PROFILE_NAME,
+            description=desctiption,
+            single_cluster_routing=single_cluster_routing,
+        )
+
+        klass = self._get_target_class()
+        app_profile = klass.from_pb(app_profile_pb, instance)
+        self.assertIsInstance(app_profile, klass)
+        self.assertIs(app_profile._instance, instance)
+        self.assertEqual(app_profile.app_profile_id, self.APP_PROFILE_ID)
+        self.assertEqual(app_profile.description, desctiption)
+        self.assertEqual(app_profile.routing_policy_type, routing)
+        self.assertEqual(app_profile.cluster_id, self.CLUSTER_ID)
+        self.assertEqual(
+            app_profile.allow_transactional_writes, allow_transactional_writes
+        )
+
+    def test_from_pb_bad_app_profile_name(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        bad_app_profile_name = "BAD_NAME"
+
+        app_profile_pb = data_v2_pb2.AppProfile(name=bad_app_profile_name)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(app_profile_pb, None)
+
+    def test_from_pb_instance_id_mistmatch(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        ALT_INSTANCE_ID = "ALT_INSTANCE_ID"
+        client = _Client(self.PROJECT)
+        instance = _Instance(ALT_INSTANCE_ID, client)
+        self.assertEqual(instance.instance_id, ALT_INSTANCE_ID)
+
+        app_profile_pb = data_v2_pb2.AppProfile(name=self.APP_PROFILE_NAME)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(app_profile_pb, instance)
+
+    def test_from_pb_project_mistmatch(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        ALT_PROJECT = "ALT_PROJECT"
+        client = _Client(project=ALT_PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        self.assertEqual(client.project, ALT_PROJECT)
+
+        app_profile_pb = data_v2_pb2.AppProfile(name=self.APP_PROFILE_NAME)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(app_profile_pb, instance)
+
+    def test_reload_routing_any(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.enums import RoutingPolicyType
+
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        routing = RoutingPolicyType.ANY
+        description = "routing policy any"
+
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+        )
+
+        # Create response_pb
+        description_from_server = "routing policy switched to single"
+        cluster_id_from_server = self.CLUSTER_ID
+        allow_transactional_writes = True
+        single_cluster_routing = data_v2_pb2.AppProfile.SingleClusterRouting(
+            cluster_id=cluster_id_from_server,
+            allow_transactional_writes=allow_transactional_writes,
+        )
+
+        response_pb = data_v2_pb2.AppProfile(
+            name=app_profile.name,
+            single_cluster_routing=single_cluster_routing,
+            description=description_from_server,
+        )
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = api
+        instance_stub = client._instance_admin_client.transport
+        instance_stub.get_app_profile.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_result = None  # reload() has no return value.
+
+        # Check app_profile config values before.
+        self.assertEqual(app_profile.routing_policy_type, routing)
+        self.assertEqual(app_profile.description, description)
+        self.assertIsNone(app_profile.cluster_id)
+        self.assertIsNone(app_profile.allow_transactional_writes)
+
+        # Perform the method and check the result.
+        result = app_profile.reload()
+        self.assertEqual(result, expected_result)
+        self.assertEqual(app_profile.routing_policy_type, RoutingPolicyType.SINGLE)
+        self.assertEqual(app_profile.description, description_from_server)
+        self.assertEqual(app_profile.cluster_id, cluster_id_from_server)
+        self.assertEqual(
+            app_profile.allow_transactional_writes, allow_transactional_writes
+        )
+
+    def test_exists(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.api_core import exceptions
+
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            mock.Mock()
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+
+        # Create response_pb
+        response_pb = data_v2_pb2.AppProfile(name=self.APP_PROFILE_NAME)
+        client._instance_admin_client = instance_api
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = instance_api
+        instance_stub = client._instance_admin_client.transport
+        instance_stub.get_app_profile.side_effect = [
+            response_pb,
+            exceptions.NotFound("testing"),
+            exceptions.BadRequest("testing"),
+        ]
+
+        # Perform the method and check the result.
+        non_existing_app_profile_id = "other-app-profile-id"
+        app_profile = self._make_one(self.APP_PROFILE_ID, instance)
+        alt_app_profile = self._make_one(non_existing_app_profile_id, instance)
+        self.assertTrue(app_profile.exists())
+        self.assertFalse(alt_app_profile.exists())
+        with self.assertRaises(exceptions.BadRequest):
+            alt_app_profile.exists()
+
+    def test_create_routing_any(self):
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable.enums import RoutingPolicyType
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+
+        routing = RoutingPolicyType.ANY
+        description = "routing policy any"
+        ignore_warnings = True
+
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+        )
+        expected_request_app_profile = app_profile._to_pb()
+        expected_request = messages_v2_pb2.CreateAppProfileRequest(
+            parent=instance.name,
+            app_profile_id=self.APP_PROFILE_ID,
+            app_profile=expected_request_app_profile,
+            ignore_warnings=ignore_warnings,
+        )
+
+        # Patch the stub used by the API method.
+        channel = ChannelStub(responses=[expected_request_app_profile])
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            channel=channel
+        )
+        client._instance_admin_client = instance_api
+        # Perform the method and check the result.
+        result = app_profile.create(ignore_warnings)
+        actual_request = channel.requests[0][1]
+
+        self.assertEqual(actual_request, expected_request)
+        self.assertIsInstance(result, self._get_target_class())
+        self.assertEqual(result.app_profile_id, self.APP_PROFILE_ID)
+        self.assertIs(result._instance, instance)
+        self.assertEqual(result.routing_policy_type, routing)
+        self.assertEqual(result.description, description)
+        self.assertEqual(result.allow_transactional_writes, False)
+        self.assertIsNone(result.cluster_id)
+
+    def test_create_routing_single(self):
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable.enums import RoutingPolicyType
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+
+        routing = RoutingPolicyType.SINGLE
+        description = "routing policy single"
+        allow_writes = False
+        ignore_warnings = True
+
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            cluster_id=self.CLUSTER_ID,
+            allow_transactional_writes=allow_writes,
+        )
+        expected_request_app_profile = app_profile._to_pb()
+        expected_request = messages_v2_pb2.CreateAppProfileRequest(
+            parent=instance.name,
+            app_profile_id=self.APP_PROFILE_ID,
+            app_profile=expected_request_app_profile,
+            ignore_warnings=ignore_warnings,
+        )
+
+        # Patch the stub used by the API method.
+        channel = ChannelStub(responses=[expected_request_app_profile])
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            channel=channel
+        )
+        client._instance_admin_client = instance_api
+        # Perform the method and check the result.
+        result = app_profile.create(ignore_warnings)
+        actual_request = channel.requests[0][1]
+
+        self.assertEqual(actual_request, expected_request)
+        self.assertIsInstance(result, self._get_target_class())
+        self.assertEqual(result.app_profile_id, self.APP_PROFILE_ID)
+        self.assertIs(result._instance, instance)
+        self.assertEqual(result.routing_policy_type, routing)
+        self.assertEqual(result.description, description)
+        self.assertEqual(result.allow_transactional_writes, allow_writes)
+        self.assertEqual(result.cluster_id, self.CLUSTER_ID)
+
+    def test_create_app_profile_with_wrong_routing_policy(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID, instance, routing_policy_type=None
+        )
+        with self.assertRaises(ValueError):
+            app_profile.create()
+
+    def test_update_app_profile_routing_any(self):
+        from google.api_core import operation
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable.enums import RoutingPolicyType
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.protobuf import field_mask_pb2
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+
+        routing = RoutingPolicyType.SINGLE
+        description = "to routing policy single"
+        allow_writes = True
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID,
+            instance,
+            routing_policy_type=routing,
+            description=description,
+            cluster_id=self.CLUSTER_ID,
+            allow_transactional_writes=allow_writes,
+        )
+
+        # Create response_pb
+        metadata = messages_v2_pb2.UpdateAppProfileMetadata()
+        type_url = "type.googleapis.com/{}".format(
+            messages_v2_pb2.UpdateAppProfileMetadata.DESCRIPTOR.full_name
+        )
+        response_pb = operations_pb2.Operation(
+            name=self.OP_NAME,
+            metadata=Any(type_url=type_url, value=metadata.SerializeToString()),
+        )
+
+        # Patch the stub used by the API method.
+        channel = ChannelStub(responses=[response_pb])
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            channel=channel
+        )
+        # Mock api calls
+        client._instance_admin_client = instance_api
+
+        # Perform the method and check the result.
+        ignore_warnings = True
+        expected_request_update_mask = field_mask_pb2.FieldMask(
+            paths=["description", "single_cluster_routing"]
+        )
+        expected_request = messages_v2_pb2.UpdateAppProfileRequest(
+            app_profile=app_profile._to_pb(),
+            update_mask=expected_request_update_mask,
+            ignore_warnings=ignore_warnings,
+        )
+
+        result = app_profile.update(ignore_warnings=ignore_warnings)
+        actual_request = channel.requests[0][1]
+
+        self.assertEqual(actual_request, expected_request)
+        self.assertIsInstance(result, operation.Operation)
+        self.assertEqual(result.operation.name, self.OP_NAME)
+        self.assertIsInstance(result.metadata, messages_v2_pb2.UpdateAppProfileMetadata)
+
+    def test_update_app_profile_routing_single(self):
+        from google.api_core import operation
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable.enums import RoutingPolicyType
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.protobuf import field_mask_pb2
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+
+        routing = RoutingPolicyType.ANY
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID, instance, routing_policy_type=routing
+        )
+
+        # Create response_pb
+        metadata = messages_v2_pb2.UpdateAppProfileMetadata()
+        type_url = "type.googleapis.com/{}".format(
+            messages_v2_pb2.UpdateAppProfileMetadata.DESCRIPTOR.full_name
+        )
+        response_pb = operations_pb2.Operation(
+            name=self.OP_NAME,
+            metadata=Any(type_url=type_url, value=metadata.SerializeToString()),
+        )
+
+        # Patch the stub used by the API method.
+        channel = ChannelStub(responses=[response_pb])
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            channel=channel
+        )
+        # Mock api calls
+        client._instance_admin_client = instance_api
+
+        # Perform the method and check the result.
+        ignore_warnings = True
+        expected_request_update_mask = field_mask_pb2.FieldMask(
+            paths=["multi_cluster_routing_use_any"]
+        )
+        expected_request = messages_v2_pb2.UpdateAppProfileRequest(
+            app_profile=app_profile._to_pb(),
+            update_mask=expected_request_update_mask,
+            ignore_warnings=ignore_warnings,
+        )
+
+        result = app_profile.update(ignore_warnings=ignore_warnings)
+        actual_request = channel.requests[0][1]
+
+        self.assertEqual(actual_request, expected_request)
+        self.assertIsInstance(result, operation.Operation)
+        self.assertEqual(result.operation.name, self.OP_NAME)
+        self.assertIsInstance(result.metadata, messages_v2_pb2.UpdateAppProfileMetadata)
+
+    def test_update_app_profile_with_wrong_routing_policy(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+        app_profile = self._make_one(
+            self.APP_PROFILE_ID, instance, routing_policy_type=None
+        )
+        with self.assertRaises(ValueError):
+            app_profile.update()
+
+    def test_delete(self):
+        from google.protobuf import empty_pb2
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            mock.Mock()
+        )
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = client.instance(self.INSTANCE_ID)
+        app_profile = self._make_one(self.APP_PROFILE_ID, instance)
+
+        # Create response_pb
+        response_pb = empty_pb2.Empty()
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = instance_api
+        instance_stub = client._instance_admin_client.transport
+        instance_stub.delete_cluster.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_result = None  # delete() has no return value.
+
+        # Perform the method and check the result.
+        result = app_profile.delete()
+
+        self.assertEqual(result, expected_result)
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+        self.project_name = "projects/" + self.project
+        self._operations_stub = mock.sentinel.operations_stub
+
+    def __eq__(self, other):
+        return other.project == self.project and other.project_name == self.project_name
+
+
+class _Instance(object):
+    def __init__(self, instance_id, client):
+        self.instance_id = instance_id
+        self._client = client
+
+    def __eq__(self, other):
+        return other.instance_id == self.instance_id and other._client == self._client
+
+
+class _Other(object):
+    def __init__(self, app_profile_id, instance):
+        self.app_profile_id = app_profile_id
+        self._instance = instance
diff --git a/bigtable/tests/unit/test_batcher.py b/bigtable/tests/unit/test_batcher.py
new file mode 100644
index 000000000000..8760c3a2de2c
--- /dev/null
+++ b/bigtable/tests/unit/test_batcher.py
@@ -0,0 +1,179 @@
+# 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.
+
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+
+from google.cloud.bigtable.batcher import MutationsBatcher
+from google.cloud.bigtable.row import DirectRow
+
+
+class TestMutationsBatcher(unittest.TestCase):
+    from grpc import StatusCode
+
+    TABLE_ID = "table-id"
+    TABLE_NAME = "/tables/" + TABLE_ID
+
+    # RPC Status Codes
+    SUCCESS = StatusCode.OK.value[0]
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.table import Table
+
+        return Table
+
+    def _make_table(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+
+        instance = client.instance(instance_id="instance-id")
+        table = self._make_table(self.TABLE_ID, instance)
+
+        mutation_batcher = MutationsBatcher(table)
+        self.assertEqual(table, mutation_batcher.table)
+
+    def test_mutate_row(self):
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table)
+
+        rows = [
+            DirectRow(row_key=b"row_key"),
+            DirectRow(row_key=b"row_key_2"),
+            DirectRow(row_key=b"row_key_3"),
+            DirectRow(row_key=b"row_key_4"),
+        ]
+
+        mutation_batcher.mutate_rows(rows)
+        mutation_batcher.flush()
+
+        self.assertEqual(table.mutation_calls, 1)
+
+    def test_mutate_rows(self):
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table)
+
+        row = DirectRow(row_key=b"row_key")
+        row.set_cell("cf1", b"c1", 1)
+        row.set_cell("cf1", b"c2", 2)
+        row.set_cell("cf1", b"c3", 3)
+        row.set_cell("cf1", b"c4", 4)
+
+        mutation_batcher.mutate(row)
+
+        mutation_batcher.flush()
+
+        self.assertEqual(table.mutation_calls, 1)
+
+    def test_flush_with_no_rows(self):
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table)
+        mutation_batcher.flush()
+
+        self.assertEqual(table.mutation_calls, 0)
+
+    def test_add_row_with_max_flush_count(self):
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table, flush_count=3)
+
+        row_1 = DirectRow(row_key=b"row_key_1")
+        row_2 = DirectRow(row_key=b"row_key_2")
+        row_3 = DirectRow(row_key=b"row_key_3")
+
+        mutation_batcher.mutate(row_1)
+        mutation_batcher.mutate(row_2)
+        mutation_batcher.mutate(row_3)
+
+        self.assertEqual(table.mutation_calls, 1)
+
+    @mock.patch("google.cloud.bigtable.batcher.MAX_MUTATIONS", new=3)
+    def test_mutate_row_with_max_mutations_failure(self):
+        from google.cloud.bigtable.batcher import MaxMutationsError
+
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table)
+
+        row = DirectRow(row_key=b"row_key")
+        row.set_cell("cf1", b"c1", 1)
+        row.set_cell("cf1", b"c2", 2)
+        row.set_cell("cf1", b"c3", 3)
+        row.set_cell("cf1", b"c4", 4)
+
+        with self.assertRaises(MaxMutationsError):
+            mutation_batcher.mutate(row)
+
+    @mock.patch("google.cloud.bigtable.batcher.MAX_MUTATIONS", new=3)
+    def test_mutate_row_with_max_mutations(self):
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table)
+
+        row = DirectRow(row_key=b"row_key")
+        row.set_cell("cf1", b"c1", 1)
+        row.set_cell("cf1", b"c2", 2)
+        row.set_cell("cf1", b"c3", 3)
+
+        mutation_batcher.mutate(row)
+        mutation_batcher.flush()
+
+        self.assertEqual(table.mutation_calls, 1)
+
+    def test_mutate_row_with_max_row_bytes(self):
+        table = _Table(self.TABLE_NAME)
+        mutation_batcher = MutationsBatcher(table=table, max_row_bytes=3 * 1024 * 1024)
+
+        number_of_bytes = 1 * 1024 * 1024
+        max_value = b"1" * number_of_bytes
+
+        row = DirectRow(row_key=b"row_key")
+        row.set_cell("cf1", b"c1", max_value)
+        row.set_cell("cf1", b"c2", max_value)
+        row.set_cell("cf1", b"c3", max_value)
+
+        mutation_batcher.mutate(row)
+
+        self.assertEqual(table.mutation_calls, 1)
+
+
+class _Instance(object):
+    def __init__(self, client=None):
+        self._client = client
+
+
+class _Table(object):
+    def __init__(self, name, client=None):
+        self.name = name
+        self._instance = _Instance(client)
+        self.mutation_calls = 0
+
+    def mutate_rows(self, rows):
+        self.mutation_calls += 1
+        return rows
diff --git a/bigtable/tests/unit/test_client.py b/bigtable/tests/unit/test_client.py
new file mode 100644
index 000000000000..05a017d898af
--- /dev/null
+++ b/bigtable/tests/unit/test_client.py
@@ -0,0 +1,473 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+
+
+class Test__create_gapic_client(unittest.TestCase):
+    def _invoke_client_factory(self, client_class):
+        from google.cloud.bigtable.client import _create_gapic_client
+
+        return _create_gapic_client(client_class)
+
+    def test_without_emulator(self):
+        client_class = mock.Mock()
+        credentials = _make_credentials()
+        client = _Client(credentials)
+        client_info = client._client_info = mock.Mock()
+
+        result = self._invoke_client_factory(client_class)(client)
+
+        self.assertIs(result, client_class.return_value)
+        client_class.assert_called_once_with(
+            credentials=client._credentials, client_info=client_info
+        )
+
+    def test_with_emulator(self):
+        client_class = mock.Mock()
+        emulator_host = emulator_channel = object()
+        credentials = _make_credentials()
+        client = _Client(
+            credentials, emulator_host=emulator_host, emulator_channel=emulator_channel
+        )
+        client_info = client._client_info = mock.Mock()
+
+        result = self._invoke_client_factory(client_class)(client)
+
+        self.assertIs(result, client_class.return_value)
+        client_class.assert_called_once_with(
+            channel=client._emulator_channel, client_info=client_info
+        )
+
+
+class _Client(object):
+    def __init__(self, credentials, emulator_host=None, emulator_channel=None):
+        self._credentials = credentials
+        self._emulator_host = emulator_host
+        self._emulator_channel = emulator_channel
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    INSTANCE_ID = "instance-id"
+    DISPLAY_NAME = "display-name"
+    USER_AGENT = "you-sir-age-int"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        from google.cloud.bigtable.client import _CLIENT_INFO
+        from google.cloud.bigtable.client import DATA_SCOPE
+
+        credentials = _make_credentials()
+
+        with mock.patch("google.auth.default") as mocked:
+            mocked.return_value = credentials, self.PROJECT
+            client = self._make_one()
+
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertIs(client._credentials, credentials.with_scopes.return_value)
+        self.assertFalse(client._read_only)
+        self.assertFalse(client._admin)
+        self.assertIs(client._client_info, _CLIENT_INFO)
+        self.assertIsNone(client._channel)
+        self.assertIsNone(client._emulator_host)
+        self.assertIsNone(client._emulator_channel)
+        self.assertEqual(client.SCOPE, (DATA_SCOPE,))
+
+    def test_constructor_explicit(self):
+        import warnings
+        from google.cloud.bigtable.client import ADMIN_SCOPE
+        from google.cloud.bigtable.client import DATA_SCOPE
+
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+
+        with warnings.catch_warnings(record=True) as warned:
+            client = self._make_one(
+                project=self.PROJECT,
+                credentials=credentials,
+                read_only=False,
+                admin=True,
+                client_info=client_info,
+                channel=mock.sentinel.channel,
+            )
+
+        self.assertEqual(len(warned), 1)
+
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertIs(client._credentials, credentials.with_scopes.return_value)
+        self.assertFalse(client._read_only)
+        self.assertTrue(client._admin)
+        self.assertIs(client._client_info, client_info)
+        self.assertIs(client._channel, mock.sentinel.channel)
+        self.assertEqual(client.SCOPE, (DATA_SCOPE, ADMIN_SCOPE))
+
+    def test_constructor_both_admin_and_read_only(self):
+        credentials = _make_credentials()
+        with self.assertRaises(ValueError):
+            self._make_one(
+                project=self.PROJECT,
+                credentials=credentials,
+                admin=True,
+                read_only=True,
+            )
+
+    def test_constructor_with_emulator_host(self):
+        from google.cloud.environment_vars import BIGTABLE_EMULATOR
+
+        credentials = _make_credentials()
+        emulator_host = "localhost:8081"
+        with mock.patch("os.getenv") as getenv:
+            getenv.return_value = emulator_host
+            with mock.patch("grpc.insecure_channel") as factory:
+                getenv.return_value = emulator_host
+                client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        self.assertEqual(client._emulator_host, emulator_host)
+        self.assertIs(client._emulator_channel, factory.return_value)
+        factory.assert_called_once_with(emulator_host)
+        getenv.assert_called_once_with(BIGTABLE_EMULATOR)
+
+    def test__get_scopes_default(self):
+        from google.cloud.bigtable.client import DATA_SCOPE
+
+        client = self._make_one(project=self.PROJECT, credentials=_make_credentials())
+        self.assertEqual(client._get_scopes(), (DATA_SCOPE,))
+
+    def test__get_scopes_admin(self):
+        from google.cloud.bigtable.client import ADMIN_SCOPE
+        from google.cloud.bigtable.client import DATA_SCOPE
+
+        client = self._make_one(
+            project=self.PROJECT, credentials=_make_credentials(), admin=True
+        )
+        expected_scopes = (DATA_SCOPE, ADMIN_SCOPE)
+        self.assertEqual(client._get_scopes(), expected_scopes)
+
+    def test__get_scopes_read_only(self):
+        from google.cloud.bigtable.client import READ_ONLY_SCOPE
+
+        client = self._make_one(
+            project=self.PROJECT, credentials=_make_credentials(), read_only=True
+        )
+        self.assertEqual(client._get_scopes(), (READ_ONLY_SCOPE,))
+
+    def test_project_path_property(self):
+        credentials = _make_credentials()
+        project = "PROJECT"
+        client = self._make_one(project=project, credentials=credentials, admin=True)
+        project_name = "projects/" + project
+        self.assertEqual(client.project_path, project_name)
+
+    def test_table_data_client_not_initialized(self):
+        from google.cloud.bigtable.client import _CLIENT_INFO
+        from google.cloud.bigtable_v2 import BigtableClient
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        table_data_client = client.table_data_client
+        self.assertIsInstance(table_data_client, BigtableClient)
+        self.assertIs(table_data_client._client_info, _CLIENT_INFO)
+        self.assertIs(client._table_data_client, table_data_client)
+
+    def test_table_data_client_not_initialized_w_client_info(self):
+        from google.cloud.bigtable_v2 import BigtableClient
+
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, client_info=client_info
+        )
+
+        table_data_client = client.table_data_client
+        self.assertIsInstance(table_data_client, BigtableClient)
+        self.assertIs(table_data_client._client_info, client_info)
+        self.assertIs(client._table_data_client, table_data_client)
+
+    def test_table_data_client_initialized(self):
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        already = client._table_data_client = object()
+        self.assertIs(client.table_data_client, already)
+
+    def test_table_admin_client_not_initialized_no_admin_flag(self):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        with self.assertRaises(ValueError):
+            client.table_admin_client()
+
+    def test_table_admin_client_not_initialized_w_admin_flag(self):
+        from google.cloud.bigtable.client import _CLIENT_INFO
+        from google.cloud.bigtable_admin_v2 import BigtableTableAdminClient
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        table_admin_client = client.table_admin_client
+        self.assertIsInstance(table_admin_client, BigtableTableAdminClient)
+        self.assertIs(table_admin_client._client_info, _CLIENT_INFO)
+        self.assertIs(client._table_admin_client, table_admin_client)
+
+    def test_table_admin_client_not_initialized_w_client_info(self):
+        from google.cloud.bigtable_admin_v2 import BigtableTableAdminClient
+
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            admin=True,
+            client_info=client_info,
+        )
+
+        table_admin_client = client.table_admin_client
+        self.assertIsInstance(table_admin_client, BigtableTableAdminClient)
+        self.assertIs(table_admin_client._client_info, client_info)
+        self.assertIs(client._table_admin_client, table_admin_client)
+
+    def test_table_admin_client_initialized(self):
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        already = client._table_admin_client = object()
+        self.assertIs(client.table_admin_client, already)
+
+    def test_instance_admin_client_not_initialized_no_admin_flag(self):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        with self.assertRaises(ValueError):
+            client.instance_admin_client()
+
+    def test_instance_admin_client_not_initialized_w_admin_flag(self):
+        from google.cloud.bigtable.client import _CLIENT_INFO
+        from google.cloud.bigtable_admin_v2 import BigtableInstanceAdminClient
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        instance_admin_client = client.instance_admin_client
+        self.assertIsInstance(instance_admin_client, BigtableInstanceAdminClient)
+        self.assertIs(instance_admin_client._client_info, _CLIENT_INFO)
+        self.assertIs(client._instance_admin_client, instance_admin_client)
+
+    def test_instance_admin_client_not_initialized_w_admin_and_client_info(self):
+        from google.cloud.bigtable_admin_v2 import BigtableInstanceAdminClient
+
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            admin=True,
+            client_info=client_info,
+        )
+
+        instance_admin_client = client.instance_admin_client
+        self.assertIsInstance(instance_admin_client, BigtableInstanceAdminClient)
+        self.assertIs(instance_admin_client._client_info, client_info)
+        self.assertIs(client._instance_admin_client, instance_admin_client)
+
+    def test_instance_admin_client_initialized(self):
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        already = client._instance_admin_client = object()
+        self.assertIs(client.instance_admin_client, already)
+
+    def test_instance_factory_defaults(self):
+        from google.cloud.bigtable.instance import Instance
+
+        PROJECT = "PROJECT"
+        INSTANCE_ID = "instance-id"
+        credentials = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=credentials)
+
+        instance = client.instance(INSTANCE_ID)
+
+        self.assertIsInstance(instance, Instance)
+        self.assertEqual(instance.instance_id, INSTANCE_ID)
+        self.assertEqual(instance.display_name, INSTANCE_ID)
+        self.assertIsNone(instance.type_)
+        self.assertIsNone(instance.labels)
+        self.assertIs(instance._client, client)
+
+    def test_instance_factory_non_defaults(self):
+        from google.cloud.bigtable.instance import Instance
+        from google.cloud.bigtable import enums
+
+        PROJECT = "PROJECT"
+        INSTANCE_ID = "instance-id"
+        DISPLAY_NAME = "display-name"
+        instance_type = enums.Instance.Type.DEVELOPMENT
+        labels = {"foo": "bar"}
+        credentials = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=credentials)
+
+        instance = client.instance(
+            INSTANCE_ID,
+            display_name=DISPLAY_NAME,
+            instance_type=instance_type,
+            labels=labels,
+        )
+
+        self.assertIsInstance(instance, Instance)
+        self.assertEqual(instance.instance_id, INSTANCE_ID)
+        self.assertEqual(instance.display_name, DISPLAY_NAME)
+        self.assertEqual(instance.type_, instance_type)
+        self.assertEqual(instance.labels, labels)
+        self.assertIs(instance._client, client)
+
+    def test_list_instances(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable.instance import Instance
+
+        FAILED_LOCATION = "FAILED"
+        INSTANCE_ID1 = "instance-id1"
+        INSTANCE_ID2 = "instance-id2"
+        INSTANCE_NAME1 = "projects/" + self.PROJECT + "/instances/" + INSTANCE_ID1
+        INSTANCE_NAME2 = "projects/" + self.PROJECT + "/instances/" + INSTANCE_ID2
+
+        credentials = _make_credentials()
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        # Create response_pb
+        response_pb = messages_v2_pb2.ListInstancesResponse(
+            failed_locations=[FAILED_LOCATION],
+            instances=[
+                data_v2_pb2.Instance(name=INSTANCE_NAME1, display_name=INSTANCE_NAME1),
+                data_v2_pb2.Instance(name=INSTANCE_NAME2, display_name=INSTANCE_NAME2),
+            ],
+        )
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = api
+        bigtable_instance_stub = client.instance_admin_client.transport
+        bigtable_instance_stub.list_instances.side_effect = [response_pb]
+
+        # Perform the method and check the result.
+        instances, failed_locations = client.list_instances()
+
+        instance_1, instance_2 = instances
+
+        self.assertIsInstance(instance_1, Instance)
+        self.assertEqual(instance_1.name, INSTANCE_NAME1)
+        self.assertTrue(instance_1._client is client)
+
+        self.assertIsInstance(instance_2, Instance)
+        self.assertEqual(instance_2.name, INSTANCE_NAME2)
+        self.assertTrue(instance_2._client is client)
+
+        self.assertEqual(failed_locations, [FAILED_LOCATION])
+
+    def test_list_clusters(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.instance import Cluster
+
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            mock.Mock()
+        )
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        INSTANCE_ID1 = "instance-id1"
+        INSTANCE_ID2 = "instance-id2"
+
+        failed_location = "FAILED"
+        cluster_id1 = "{}-cluster".format(INSTANCE_ID1)
+        cluster_id2 = "{}-cluster-1".format(INSTANCE_ID2)
+        cluster_id3 = "{}-cluster-2".format(INSTANCE_ID2)
+        cluster_name1 = client.instance_admin_client.cluster_path(
+            self.PROJECT, INSTANCE_ID1, cluster_id1
+        )
+        cluster_name2 = client.instance_admin_client.cluster_path(
+            self.PROJECT, INSTANCE_ID2, cluster_id2
+        )
+        cluster_name3 = client.instance_admin_client.cluster_path(
+            self.PROJECT, INSTANCE_ID2, cluster_id3
+        )
+
+        # Create response_pb
+        response_pb = messages_v2_pb2.ListClustersResponse(
+            failed_locations=[failed_location],
+            clusters=[
+                data_v2_pb2.Cluster(name=cluster_name1),
+                data_v2_pb2.Cluster(name=cluster_name2),
+                data_v2_pb2.Cluster(name=cluster_name3),
+            ],
+        )
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = instance_api
+        instance_stub = client._instance_admin_client.transport
+        instance_stub.list_clusters.side_effect = [response_pb]
+
+        # Perform the method and check the result.
+        clusters, failed_locations = client.list_clusters()
+
+        cluster_1, cluster_2, cluster_3 = clusters
+
+        self.assertIsInstance(cluster_1, Cluster)
+        self.assertEqual(cluster_1.name, cluster_name1)
+        self.assertEqual(cluster_1._instance.instance_id, INSTANCE_ID1)
+
+        self.assertIsInstance(cluster_2, Cluster)
+        self.assertEqual(cluster_2.name, cluster_name2)
+        self.assertEqual(cluster_2._instance.instance_id, INSTANCE_ID2)
+
+        self.assertIsInstance(cluster_3, Cluster)
+        self.assertEqual(cluster_3.name, cluster_name3)
+        self.assertEqual(cluster_3._instance.instance_id, INSTANCE_ID2)
+
+        self.assertEqual(failed_locations, [failed_location])
diff --git a/bigtable/tests/unit/test_cluster.py b/bigtable/tests/unit/test_cluster.py
new file mode 100644
index 000000000000..9a0d39c84977
--- /dev/null
+++ b/bigtable/tests/unit/test_cluster.py
@@ -0,0 +1,496 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        return self.channel_stub.responses.pop()
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class TestCluster(unittest.TestCase):
+
+    PROJECT = "project"
+    INSTANCE_ID = "instance-id"
+    LOCATION_ID = "location-id"
+    CLUSTER_ID = "cluster-id"
+    LOCATION_ID = "location-id"
+    CLUSTER_NAME = (
+        "projects/" + PROJECT + "/instances/" + INSTANCE_ID + "/clusters/" + CLUSTER_ID
+    )
+    LOCATION_PATH = "projects/" + PROJECT + "/locations/"
+    SERVE_NODES = 5
+    OP_ID = 5678
+    OP_NAME = "operations/projects/{}/instances/{}/clusters/{}/operations/{}".format(
+        PROJECT, INSTANCE_ID, CLUSTER_ID, OP_ID
+    )
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.cluster import Cluster
+
+        return Cluster
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        cluster = self._make_one(self.CLUSTER_ID, instance)
+        self.assertEqual(cluster.cluster_id, self.CLUSTER_ID)
+        self.assertIs(cluster._instance, instance)
+        self.assertIsNone(cluster.location_id)
+        self.assertIsNone(cluster.state)
+        self.assertIsNone(cluster.serve_nodes)
+        self.assertIsNone(cluster.default_storage_type)
+
+    def test_constructor_non_default(self):
+        from google.cloud.bigtable.enums import StorageType
+        from google.cloud.bigtable.enums import Cluster
+
+        STATE = Cluster.State.READY
+        STORAGE_TYPE_SSD = StorageType.SSD
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        cluster = self._make_one(
+            self.CLUSTER_ID,
+            instance,
+            location_id=self.LOCATION_ID,
+            _state=STATE,
+            serve_nodes=self.SERVE_NODES,
+            default_storage_type=STORAGE_TYPE_SSD,
+        )
+        self.assertEqual(cluster.cluster_id, self.CLUSTER_ID)
+        self.assertIs(cluster._instance, instance)
+        self.assertEqual(cluster.location_id, self.LOCATION_ID)
+        self.assertEqual(cluster.state, STATE)
+        self.assertEqual(cluster.serve_nodes, self.SERVE_NODES)
+        self.assertEqual(cluster.default_storage_type, STORAGE_TYPE_SSD)
+
+    def test_name_property(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster = self._make_one(self.CLUSTER_ID, instance)
+
+        self.assertEqual(cluster.name, self.CLUSTER_NAME)
+
+    def test_from_pb_success(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable import enums
+
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        location = self.LOCATION_PATH + self.LOCATION_ID
+        state = enums.Cluster.State.RESIZING
+        storage_type = enums.StorageType.SSD
+        cluster_pb = data_v2_pb2.Cluster(
+            name=self.CLUSTER_NAME,
+            location=location,
+            state=state,
+            serve_nodes=self.SERVE_NODES,
+            default_storage_type=storage_type,
+        )
+
+        klass = self._get_target_class()
+        cluster = klass.from_pb(cluster_pb, instance)
+        self.assertIsInstance(cluster, klass)
+        self.assertEqual(cluster._instance, instance)
+        self.assertEqual(cluster.cluster_id, self.CLUSTER_ID)
+        self.assertEqual(cluster.location_id, self.LOCATION_ID)
+        self.assertEqual(cluster.state, state)
+        self.assertEqual(cluster.serve_nodes, self.SERVE_NODES)
+        self.assertEqual(cluster.default_storage_type, storage_type)
+
+    def test_from_pb_bad_cluster_name(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        bad_cluster_name = "BAD_NAME"
+
+        cluster_pb = data_v2_pb2.Cluster(name=bad_cluster_name)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(cluster_pb, None)
+
+    def test_from_pb_instance_id_mistmatch(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        ALT_INSTANCE_ID = "ALT_INSTANCE_ID"
+        client = _Client(self.PROJECT)
+        instance = _Instance(ALT_INSTANCE_ID, client)
+
+        self.assertNotEqual(self.INSTANCE_ID, ALT_INSTANCE_ID)
+        cluster_pb = data_v2_pb2.Cluster(name=self.CLUSTER_NAME)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(cluster_pb, instance)
+
+    def test_from_pb_project_mistmatch(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        ALT_PROJECT = "ALT_PROJECT"
+        client = _Client(project=ALT_PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+
+        self.assertNotEqual(self.PROJECT, ALT_PROJECT)
+        cluster_pb = data_v2_pb2.Cluster(name=self.CLUSTER_NAME)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(cluster_pb, instance)
+
+    def test___eq__(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster1 = self._make_one(self.CLUSTER_ID, instance, self.LOCATION_ID)
+        cluster2 = self._make_one(self.CLUSTER_ID, instance, self.LOCATION_ID)
+        self.assertEqual(cluster1, cluster2)
+
+    def test___eq__type_differ(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster1 = self._make_one(self.CLUSTER_ID, instance, self.LOCATION_ID)
+        cluster2 = object()
+        self.assertNotEqual(cluster1, cluster2)
+
+    def test___ne__same_value(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster1 = self._make_one(self.CLUSTER_ID, instance, self.LOCATION_ID)
+        cluster2 = self._make_one(self.CLUSTER_ID, instance, self.LOCATION_ID)
+        comparison_val = cluster1 != cluster2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        client = _Client(self.PROJECT)
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster1 = self._make_one("cluster_id1", instance, self.LOCATION_ID)
+        cluster2 = self._make_one("cluster_id2", instance, self.LOCATION_ID)
+        self.assertNotEqual(cluster1, cluster2)
+
+    def test_reload(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.enums import StorageType
+        from google.cloud.bigtable.enums import Cluster
+
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        STORAGE_TYPE_SSD = StorageType.SSD
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster = self._make_one(
+            self.CLUSTER_ID,
+            instance,
+            location_id=self.LOCATION_ID,
+            serve_nodes=self.SERVE_NODES,
+            default_storage_type=STORAGE_TYPE_SSD,
+        )
+
+        # Create response_pb
+        LOCATION_ID_FROM_SERVER = "new-location-id"
+        STATE = Cluster.State.READY
+        SERVE_NODES_FROM_SERVER = 10
+        STORAGE_TYPE_FROM_SERVER = StorageType.HDD
+
+        response_pb = data_v2_pb2.Cluster(
+            name=cluster.name,
+            location=self.LOCATION_PATH + LOCATION_ID_FROM_SERVER,
+            state=STATE,
+            serve_nodes=SERVE_NODES_FROM_SERVER,
+            default_storage_type=STORAGE_TYPE_FROM_SERVER,
+        )
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = api
+        instance_admin_client = client._instance_admin_client
+        instance_stub = instance_admin_client.transport
+        instance_stub.get_cluster.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_result = None  # reload() has no return value.
+
+        # Check Cluster optional config values before.
+        self.assertEqual(cluster.location_id, self.LOCATION_ID)
+        self.assertIsNone(cluster.state)
+        self.assertEqual(cluster.serve_nodes, self.SERVE_NODES)
+        self.assertEqual(cluster.default_storage_type, STORAGE_TYPE_SSD)
+
+        # Perform the method and check the result.
+        result = cluster.reload()
+        self.assertEqual(result, expected_result)
+        self.assertEqual(cluster.location_id, LOCATION_ID_FROM_SERVER)
+        self.assertEqual(cluster.state, STATE)
+        self.assertEqual(cluster.serve_nodes, SERVE_NODES_FROM_SERVER)
+        self.assertEqual(cluster.default_storage_type, STORAGE_TYPE_FROM_SERVER)
+
+    def test_exists(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.instance import Instance
+        from google.api_core import exceptions
+
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            mock.Mock()
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = Instance(self.INSTANCE_ID, client)
+
+        # Create response_pb
+        cluster_name = client.instance_admin_client.cluster_path(
+            self.PROJECT, self.INSTANCE_ID, self.CLUSTER_ID
+        )
+        response_pb = data_v2_pb2.Cluster(name=cluster_name)
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = instance_api
+        instance_admin_client = client._instance_admin_client
+        instance_stub = instance_admin_client.transport
+        instance_stub.get_cluster.side_effect = [
+            response_pb,
+            exceptions.NotFound("testing"),
+            exceptions.BadRequest("testing"),
+        ]
+
+        # Perform the method and check the result.
+        non_existing_cluster_id = "cluster-id-2"
+        alt_cluster_1 = self._make_one(self.CLUSTER_ID, instance)
+        alt_cluster_2 = self._make_one(non_existing_cluster_id, instance)
+        self.assertTrue(alt_cluster_1.exists())
+        self.assertFalse(alt_cluster_2.exists())
+        with self.assertRaises(exceptions.BadRequest):
+            alt_cluster_1.exists()
+
+    def test_create(self):
+        import datetime
+        from google.api_core import operation
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.bigtable.instance import Instance
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as instance_v2_pb2,
+        )
+        from google.cloud.bigtable.enums import StorageType
+
+        NOW = datetime.datetime.utcnow()
+        NOW_PB = _datetime_to_pb_timestamp(NOW)
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        STORAGE_TYPE_SSD = StorageType.SSD
+        LOCATION = self.LOCATION_PATH + self.LOCATION_ID
+        instance = Instance(self.INSTANCE_ID, client)
+        cluster = self._make_one(
+            self.CLUSTER_ID,
+            instance,
+            location_id=self.LOCATION_ID,
+            serve_nodes=self.SERVE_NODES,
+            default_storage_type=STORAGE_TYPE_SSD,
+        )
+        expected_request_cluster = instance_pb2.Cluster(
+            location=LOCATION,
+            serve_nodes=cluster.serve_nodes,
+            default_storage_type=cluster.default_storage_type,
+        )
+        expected_request = instance_v2_pb2.CreateClusterRequest(
+            parent=instance.name,
+            cluster_id=self.CLUSTER_ID,
+            cluster=expected_request_cluster,
+        )
+
+        metadata = messages_v2_pb2.CreateClusterMetadata(request_time=NOW_PB)
+        type_url = "type.googleapis.com/{}".format(
+            messages_v2_pb2.CreateClusterMetadata.DESCRIPTOR.full_name
+        )
+        response_pb = operations_pb2.Operation(
+            name=self.OP_NAME,
+            metadata=Any(type_url=type_url, value=metadata.SerializeToString()),
+        )
+
+        # Patch the stub used by the API method.
+        channel = ChannelStub(responses=[response_pb])
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            channel=channel
+        )
+        client._instance_admin_client = api
+
+        # Perform the method and check the result.
+        result = cluster.create()
+        actual_request = channel.requests[0][1]
+
+        self.assertEqual(actual_request, expected_request)
+        self.assertIsInstance(result, operation.Operation)
+        self.assertEqual(result.operation.name, self.OP_NAME)
+        self.assertIsInstance(result.metadata, messages_v2_pb2.CreateClusterMetadata)
+
+    def test_update(self):
+        import datetime
+        from google.api_core import operation
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable.enums import StorageType
+
+        NOW = datetime.datetime.utcnow()
+        NOW_PB = _datetime_to_pb_timestamp(NOW)
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        STORAGE_TYPE_SSD = StorageType.SSD
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster = self._make_one(
+            self.CLUSTER_ID,
+            instance,
+            location_id=self.LOCATION_ID,
+            serve_nodes=self.SERVE_NODES,
+            default_storage_type=STORAGE_TYPE_SSD,
+        )
+        # Create expected_request
+        expected_request = instance_pb2.Cluster(
+            name=cluster.name, serve_nodes=self.SERVE_NODES
+        )
+
+        metadata = messages_v2_pb2.UpdateClusterMetadata(request_time=NOW_PB)
+        type_url = "type.googleapis.com/{}".format(
+            messages_v2_pb2.UpdateClusterMetadata.DESCRIPTOR.full_name
+        )
+        response_pb = operations_pb2.Operation(
+            name=self.OP_NAME,
+            metadata=Any(type_url=type_url, value=metadata.SerializeToString()),
+        )
+
+        # Patch the stub used by the API method.
+        channel = ChannelStub(responses=[response_pb])
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            channel=channel
+        )
+        client._instance_admin_client = api
+
+        # Perform the method and check the result.
+        result = cluster.update()
+        actual_request = channel.requests[0][1]
+
+        self.assertEqual(actual_request, expected_request)
+        self.assertIsInstance(result, operation.Operation)
+        self.assertEqual(result.operation.name, self.OP_NAME)
+        self.assertIsInstance(result.metadata, messages_v2_pb2.UpdateClusterMetadata)
+
+    def test_delete(self):
+        from google.protobuf import empty_pb2
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = _Instance(self.INSTANCE_ID, client)
+        cluster = self._make_one(self.CLUSTER_ID, instance, self.LOCATION_ID)
+
+        # Create response_pb
+        response_pb = empty_pb2.Empty()
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = api
+        instance_admin_client = client._instance_admin_client
+        instance_stub = instance_admin_client.transport
+        instance_stub.delete_cluster.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_result = None  # delete() has no return value.
+
+        # Perform the method and check the result.
+        result = cluster.delete()
+
+        self.assertEqual(result, expected_result)
+
+
+class _Instance(object):
+    def __init__(self, instance_id, client):
+        self.instance_id = instance_id
+        self._client = client
+
+    def __eq__(self, other):
+        return other.instance_id == self.instance_id and other._client == self._client
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+        self.project_name = "projects/" + self.project
+        self._operations_stub = mock.sentinel.operations_stub
+
+    def __eq__(self, other):
+        return other.project == self.project and other.project_name == self.project_name
diff --git a/bigtable/tests/unit/test_column_family.py b/bigtable/tests/unit/test_column_family.py
new file mode 100644
index 000000000000..d6f6c2672047
--- /dev/null
+++ b/bigtable/tests/unit/test_column_family.py
@@ -0,0 +1,636 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+
+
+class TestMaxVersionsGCRule(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        return MaxVersionsGCRule
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test___eq__type_differ(self):
+        gc_rule1 = self._make_one(10)
+        self.assertNotEqual(gc_rule1, object())
+        self.assertEqual(gc_rule1, mock.ANY)
+
+    def test___eq__same_value(self):
+        gc_rule1 = self._make_one(2)
+        gc_rule2 = self._make_one(2)
+        self.assertEqual(gc_rule1, gc_rule2)
+
+    def test___ne__same_value(self):
+        gc_rule1 = self._make_one(99)
+        gc_rule2 = self._make_one(99)
+        comparison_val = gc_rule1 != gc_rule2
+        self.assertFalse(comparison_val)
+
+    def test_to_pb(self):
+        max_num_versions = 1337
+        gc_rule = self._make_one(max_num_versions=max_num_versions)
+        pb_val = gc_rule.to_pb()
+        expected = _GcRulePB(max_num_versions=max_num_versions)
+        self.assertEqual(pb_val, expected)
+
+
+class TestMaxAgeGCRule(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+
+        return MaxAgeGCRule
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test___eq__type_differ(self):
+        max_age = object()
+        gc_rule1 = self._make_one(max_age=max_age)
+        gc_rule2 = object()
+        self.assertNotEqual(gc_rule1, gc_rule2)
+
+    def test___eq__same_value(self):
+        max_age = object()
+        gc_rule1 = self._make_one(max_age=max_age)
+        gc_rule2 = self._make_one(max_age=max_age)
+        self.assertEqual(gc_rule1, gc_rule2)
+
+    def test___ne__same_value(self):
+        max_age = object()
+        gc_rule1 = self._make_one(max_age=max_age)
+        gc_rule2 = self._make_one(max_age=max_age)
+        comparison_val = gc_rule1 != gc_rule2
+        self.assertFalse(comparison_val)
+
+    def test_to_pb(self):
+        import datetime
+        from google.protobuf import duration_pb2
+
+        max_age = datetime.timedelta(seconds=1)
+        duration = duration_pb2.Duration(seconds=1)
+        gc_rule = self._make_one(max_age=max_age)
+        pb_val = gc_rule.to_pb()
+        self.assertEqual(pb_val, _GcRulePB(max_age=duration))
+
+
+class TestGCRuleUnion(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.column_family import GCRuleUnion
+
+        return GCRuleUnion
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        rules = object()
+        rule_union = self._make_one(rules)
+        self.assertIs(rule_union.rules, rules)
+
+    def test___eq__(self):
+        rules = object()
+        gc_rule1 = self._make_one(rules)
+        gc_rule2 = self._make_one(rules)
+        self.assertEqual(gc_rule1, gc_rule2)
+
+    def test___eq__type_differ(self):
+        rules = object()
+        gc_rule1 = self._make_one(rules)
+        gc_rule2 = object()
+        self.assertNotEqual(gc_rule1, gc_rule2)
+
+    def test___ne__same_value(self):
+        rules = object()
+        gc_rule1 = self._make_one(rules)
+        gc_rule2 = self._make_one(rules)
+        comparison_val = gc_rule1 != gc_rule2
+        self.assertFalse(comparison_val)
+
+    def test_to_pb(self):
+        import datetime
+        from google.protobuf import duration_pb2
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        max_num_versions = 42
+        rule1 = MaxVersionsGCRule(max_num_versions)
+        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions)
+
+        max_age = datetime.timedelta(seconds=1)
+        rule2 = MaxAgeGCRule(max_age)
+        pb_rule2 = _GcRulePB(max_age=duration_pb2.Duration(seconds=1))
+
+        rule3 = self._make_one(rules=[rule1, rule2])
+        pb_rule3 = _GcRulePB(union=_GcRuleUnionPB(rules=[pb_rule1, pb_rule2]))
+
+        gc_rule_pb = rule3.to_pb()
+        self.assertEqual(gc_rule_pb, pb_rule3)
+
+    def test_to_pb_nested(self):
+        import datetime
+        from google.protobuf import duration_pb2
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        max_num_versions1 = 42
+        rule1 = MaxVersionsGCRule(max_num_versions1)
+        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions1)
+
+        max_age = datetime.timedelta(seconds=1)
+        rule2 = MaxAgeGCRule(max_age)
+        pb_rule2 = _GcRulePB(max_age=duration_pb2.Duration(seconds=1))
+
+        rule3 = self._make_one(rules=[rule1, rule2])
+        pb_rule3 = _GcRulePB(union=_GcRuleUnionPB(rules=[pb_rule1, pb_rule2]))
+
+        max_num_versions2 = 1337
+        rule4 = MaxVersionsGCRule(max_num_versions2)
+        pb_rule4 = _GcRulePB(max_num_versions=max_num_versions2)
+
+        rule5 = self._make_one(rules=[rule3, rule4])
+        pb_rule5 = _GcRulePB(union=_GcRuleUnionPB(rules=[pb_rule3, pb_rule4]))
+
+        gc_rule_pb = rule5.to_pb()
+        self.assertEqual(gc_rule_pb, pb_rule5)
+
+
+class TestGCRuleIntersection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.column_family import GCRuleIntersection
+
+        return GCRuleIntersection
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        rules = object()
+        rule_intersection = self._make_one(rules)
+        self.assertIs(rule_intersection.rules, rules)
+
+    def test___eq__(self):
+        rules = object()
+        gc_rule1 = self._make_one(rules)
+        gc_rule2 = self._make_one(rules)
+        self.assertEqual(gc_rule1, gc_rule2)
+
+    def test___eq__type_differ(self):
+        rules = object()
+        gc_rule1 = self._make_one(rules)
+        gc_rule2 = object()
+        self.assertNotEqual(gc_rule1, gc_rule2)
+
+    def test___ne__same_value(self):
+        rules = object()
+        gc_rule1 = self._make_one(rules)
+        gc_rule2 = self._make_one(rules)
+        comparison_val = gc_rule1 != gc_rule2
+        self.assertFalse(comparison_val)
+
+    def test_to_pb(self):
+        import datetime
+        from google.protobuf import duration_pb2
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        max_num_versions = 42
+        rule1 = MaxVersionsGCRule(max_num_versions)
+        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions)
+
+        max_age = datetime.timedelta(seconds=1)
+        rule2 = MaxAgeGCRule(max_age)
+        pb_rule2 = _GcRulePB(max_age=duration_pb2.Duration(seconds=1))
+
+        rule3 = self._make_one(rules=[rule1, rule2])
+        pb_rule3 = _GcRulePB(
+            intersection=_GcRuleIntersectionPB(rules=[pb_rule1, pb_rule2])
+        )
+
+        gc_rule_pb = rule3.to_pb()
+        self.assertEqual(gc_rule_pb, pb_rule3)
+
+    def test_to_pb_nested(self):
+        import datetime
+        from google.protobuf import duration_pb2
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        max_num_versions1 = 42
+        rule1 = MaxVersionsGCRule(max_num_versions1)
+        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions1)
+
+        max_age = datetime.timedelta(seconds=1)
+        rule2 = MaxAgeGCRule(max_age)
+        pb_rule2 = _GcRulePB(max_age=duration_pb2.Duration(seconds=1))
+
+        rule3 = self._make_one(rules=[rule1, rule2])
+        pb_rule3 = _GcRulePB(
+            intersection=_GcRuleIntersectionPB(rules=[pb_rule1, pb_rule2])
+        )
+
+        max_num_versions2 = 1337
+        rule4 = MaxVersionsGCRule(max_num_versions2)
+        pb_rule4 = _GcRulePB(max_num_versions=max_num_versions2)
+
+        rule5 = self._make_one(rules=[rule3, rule4])
+        pb_rule5 = _GcRulePB(
+            intersection=_GcRuleIntersectionPB(rules=[pb_rule3, pb_rule4])
+        )
+
+        gc_rule_pb = rule5.to_pb()
+        self.assertEqual(gc_rule_pb, pb_rule5)
+
+
+class TestColumnFamily(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.column_family import ColumnFamily
+
+        return ColumnFamily
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        column_family_id = u"column-family-id"
+        table = object()
+        gc_rule = object()
+        column_family = self._make_one(column_family_id, table, gc_rule=gc_rule)
+
+        self.assertEqual(column_family.column_family_id, column_family_id)
+        self.assertIs(column_family._table, table)
+        self.assertIs(column_family.gc_rule, gc_rule)
+
+    def test_name_property(self):
+        column_family_id = u"column-family-id"
+        table_name = "table_name"
+        table = _Table(table_name)
+        column_family = self._make_one(column_family_id, table)
+
+        expected_name = table_name + "/columnFamilies/" + column_family_id
+        self.assertEqual(column_family.name, expected_name)
+
+    def test___eq__(self):
+        column_family_id = "column_family_id"
+        table = object()
+        gc_rule = object()
+        column_family1 = self._make_one(column_family_id, table, gc_rule=gc_rule)
+        column_family2 = self._make_one(column_family_id, table, gc_rule=gc_rule)
+        self.assertEqual(column_family1, column_family2)
+
+    def test___eq__type_differ(self):
+        column_family1 = self._make_one("column_family_id", None)
+        column_family2 = object()
+        self.assertNotEqual(column_family1, column_family2)
+
+    def test___ne__same_value(self):
+        column_family_id = "column_family_id"
+        table = object()
+        gc_rule = object()
+        column_family1 = self._make_one(column_family_id, table, gc_rule=gc_rule)
+        column_family2 = self._make_one(column_family_id, table, gc_rule=gc_rule)
+        comparison_val = column_family1 != column_family2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        column_family1 = self._make_one("column_family_id1", None)
+        column_family2 = self._make_one("column_family_id2", None)
+        self.assertNotEqual(column_family1, column_family2)
+
+    def test_to_pb_no_rules(self):
+        column_family = self._make_one("column_family_id", None)
+        pb_val = column_family.to_pb()
+        expected = _ColumnFamilyPB()
+        self.assertEqual(pb_val, expected)
+
+    def test_to_pb_with_rule(self):
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        gc_rule = MaxVersionsGCRule(1)
+        column_family = self._make_one("column_family_id", None, gc_rule=gc_rule)
+        pb_val = column_family.to_pb()
+        expected = _ColumnFamilyPB(gc_rule=gc_rule.to_pb())
+        self.assertEqual(pb_val, expected)
+
+    def _create_test_helper(self, gc_rule=None):
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_table_admin_pb2 as table_admin_v2_pb2,
+        )
+        from tests.unit._testing import _FakeStub
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        project_id = "project-id"
+        zone = "zone"
+        cluster_id = "cluster-id"
+        table_id = "table-id"
+        column_family_id = "column-family-id"
+        table_name = (
+            "projects/"
+            + project_id
+            + "/zones/"
+            + zone
+            + "/clusters/"
+            + cluster_id
+            + "/tables/"
+            + table_id
+        )
+
+        api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(table_name, client=client)
+        column_family = self._make_one(column_family_id, table, gc_rule=gc_rule)
+
+        # Create request_pb
+        if gc_rule is None:
+            column_family_pb = _ColumnFamilyPB()
+        else:
+            column_family_pb = _ColumnFamilyPB(gc_rule=gc_rule.to_pb())
+        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(name=table_name)
+        request_pb.modifications.add(id=column_family_id, create=column_family_pb)
+
+        # Create response_pb
+        response_pb = _ColumnFamilyPB()
+
+        # Patch the stub used by the API method.
+        stub = _FakeStub(response_pb)
+        client._table_admin_client = api
+        client._table_admin_client.transport.create = stub
+
+        # Create expected_result.
+        expected_result = None  # create() has no return value.
+
+        # Perform the method and check the result.
+        self.assertEqual(stub.results, (response_pb,))
+        result = column_family.create()
+        self.assertEqual(result, expected_result)
+
+    def test_create(self):
+        self._create_test_helper(gc_rule=None)
+
+    def test_create_with_gc_rule(self):
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        gc_rule = MaxVersionsGCRule(1337)
+        self._create_test_helper(gc_rule=gc_rule)
+
+    def _update_test_helper(self, gc_rule=None):
+        from tests.unit._testing import _FakeStub
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_table_admin_pb2 as table_admin_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        project_id = "project-id"
+        zone = "zone"
+        cluster_id = "cluster-id"
+        table_id = "table-id"
+        column_family_id = "column-family-id"
+        table_name = (
+            "projects/"
+            + project_id
+            + "/zones/"
+            + zone
+            + "/clusters/"
+            + cluster_id
+            + "/tables/"
+            + table_id
+        )
+
+        api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(table_name, client=client)
+        column_family = self._make_one(column_family_id, table, gc_rule=gc_rule)
+
+        # Create request_pb
+        if gc_rule is None:
+            column_family_pb = _ColumnFamilyPB()
+        else:
+            column_family_pb = _ColumnFamilyPB(gc_rule=gc_rule.to_pb())
+        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(name=table_name)
+        request_pb.modifications.add(id=column_family_id, update=column_family_pb)
+
+        # Create response_pb
+        response_pb = _ColumnFamilyPB()
+
+        # Patch the stub used by the API method.
+        stub = _FakeStub(response_pb)
+        client._table_admin_client = api
+        client._table_admin_client.transport.update = stub
+
+        # Create expected_result.
+        expected_result = None  # update() has no return value.
+
+        # Perform the method and check the result.
+        self.assertEqual(stub.results, (response_pb,))
+        result = column_family.update()
+        self.assertEqual(result, expected_result)
+
+    def test_update(self):
+        self._update_test_helper(gc_rule=None)
+
+    def test_update_with_gc_rule(self):
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        gc_rule = MaxVersionsGCRule(1337)
+        self._update_test_helper(gc_rule=gc_rule)
+
+    def test_delete(self):
+        from google.protobuf import empty_pb2
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_table_admin_pb2 as table_admin_v2_pb2,
+        )
+        from tests.unit._testing import _FakeStub
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        project_id = "project-id"
+        zone = "zone"
+        cluster_id = "cluster-id"
+        table_id = "table-id"
+        column_family_id = "column-family-id"
+        table_name = (
+            "projects/"
+            + project_id
+            + "/zones/"
+            + zone
+            + "/clusters/"
+            + cluster_id
+            + "/tables/"
+            + table_id
+        )
+
+        api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(table_name, client=client)
+        column_family = self._make_one(column_family_id, table)
+
+        # Create request_pb
+        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(name=table_name)
+        request_pb.modifications.add(id=column_family_id, drop=True)
+
+        # Create response_pb
+        response_pb = empty_pb2.Empty()
+
+        # Patch the stub used by the API method.
+        stub = _FakeStub(response_pb)
+        client._table_admin_client = api
+        client._table_admin_client.transport.delete = stub
+
+        # Create expected_result.
+        expected_result = None  # delete() has no return value.
+
+        # Perform the method and check the result.
+        self.assertEqual(stub.results, (response_pb,))
+        result = column_family.delete()
+        self.assertEqual(result, expected_result)
+
+
+class Test__gc_rule_from_pb(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud.bigtable.column_family import _gc_rule_from_pb
+
+        return _gc_rule_from_pb(*args, **kwargs)
+
+    def test_empty(self):
+
+        gc_rule_pb = _GcRulePB()
+        self.assertIsNone(self._call_fut(gc_rule_pb))
+
+    def test_max_num_versions(self):
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        orig_rule = MaxVersionsGCRule(1)
+        gc_rule_pb = orig_rule.to_pb()
+        result = self._call_fut(gc_rule_pb)
+        self.assertIsInstance(result, MaxVersionsGCRule)
+        self.assertEqual(result, orig_rule)
+
+    def test_max_age(self):
+        import datetime
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+
+        orig_rule = MaxAgeGCRule(datetime.timedelta(seconds=1))
+        gc_rule_pb = orig_rule.to_pb()
+        result = self._call_fut(gc_rule_pb)
+        self.assertIsInstance(result, MaxAgeGCRule)
+        self.assertEqual(result, orig_rule)
+
+    def test_union(self):
+        import datetime
+        from google.cloud.bigtable.column_family import GCRuleUnion
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        rule1 = MaxVersionsGCRule(1)
+        rule2 = MaxAgeGCRule(datetime.timedelta(seconds=1))
+        orig_rule = GCRuleUnion([rule1, rule2])
+        gc_rule_pb = orig_rule.to_pb()
+        result = self._call_fut(gc_rule_pb)
+        self.assertIsInstance(result, GCRuleUnion)
+        self.assertEqual(result, orig_rule)
+
+    def test_intersection(self):
+        import datetime
+        from google.cloud.bigtable.column_family import GCRuleIntersection
+        from google.cloud.bigtable.column_family import MaxAgeGCRule
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        rule1 = MaxVersionsGCRule(1)
+        rule2 = MaxAgeGCRule(datetime.timedelta(seconds=1))
+        orig_rule = GCRuleIntersection([rule1, rule2])
+        gc_rule_pb = orig_rule.to_pb()
+        result = self._call_fut(gc_rule_pb)
+        self.assertIsInstance(result, GCRuleIntersection)
+        self.assertEqual(result, orig_rule)
+
+    def test_unknown_field_name(self):
+        class MockProto(object):
+
+            names = []
+
+            @classmethod
+            def WhichOneof(cls, name):
+                cls.names.append(name)
+                return "unknown"
+
+        self.assertEqual(MockProto.names, [])
+        self.assertRaises(ValueError, self._call_fut, MockProto)
+        self.assertEqual(MockProto.names, ["rule"])
+
+
+def _GcRulePB(*args, **kw):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.GcRule(*args, **kw)
+
+
+def _GcRuleIntersectionPB(*args, **kw):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.GcRule.Intersection(*args, **kw)
+
+
+def _GcRuleUnionPB(*args, **kw):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.GcRule.Union(*args, **kw)
+
+
+def _ColumnFamilyPB(*args, **kw):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.ColumnFamily(*args, **kw)
+
+
+class _Instance(object):
+    def __init__(self, client=None):
+        self._client = client
+
+
+class _Client(object):
+    pass
+
+
+class _Table(object):
+    def __init__(self, name, client=None):
+        self.name = name
+        self._instance = _Instance(client)
diff --git a/bigtable/tests/unit/test_instance.py b/bigtable/tests/unit/test_instance.py
new file mode 100644
index 000000000000..397e54d570d0
--- /dev/null
+++ b/bigtable/tests/unit/test_instance.py
@@ -0,0 +1,959 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+from google.cloud.bigtable.cluster import Cluster
+
+
+class TestInstance(unittest.TestCase):
+
+    PROJECT = "project"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT + "/instances/" + INSTANCE_ID
+    LOCATION_ID = "locid"
+    LOCATION = "projects/" + PROJECT + "/locations/" + LOCATION_ID
+    APP_PROFILE_PATH = (
+        "projects/" + PROJECT + "/instances/" + INSTANCE_ID + "/appProfiles/"
+    )
+    DISPLAY_NAME = "display_name"
+    LABELS = {"foo": "bar"}
+    OP_ID = 8915
+    OP_NAME = "operations/projects/{}/instances/{}operations/{}".format(
+        PROJECT, INSTANCE_ID, OP_ID
+    )
+    TABLE_ID = "table_id"
+    TABLE_NAME = INSTANCE_NAME + "/tables/" + TABLE_ID
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.instance import Instance
+
+        return Instance
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+
+        client = object()
+        instance = self._make_one(self.INSTANCE_ID, client)
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+        self.assertIsNone(instance.type_)
+        self.assertIsNone(instance.labels)
+        self.assertIs(instance._client, client)
+        self.assertIsNone(instance.state)
+
+    def test_constructor_non_default(self):
+        from google.cloud.bigtable import enums
+
+        instance_type = enums.Instance.Type.DEVELOPMENT
+        state = enums.Instance.State.READY
+        labels = {"test": "test"}
+        client = object()
+
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            display_name=self.DISPLAY_NAME,
+            instance_type=instance_type,
+            labels=labels,
+            _state=state,
+        )
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.type_, instance_type)
+        self.assertEqual(instance.labels, labels)
+        self.assertIs(instance._client, client)
+        self.assertEqual(instance.state, state)
+
+    def test__update_from_pb_success(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable import enums
+
+        instance_type = enums.Instance.Type.PRODUCTION
+        state = enums.Instance.State.READY
+        instance_pb = data_v2_pb2.Instance(
+            display_name=self.DISPLAY_NAME,
+            type=instance_type,
+            labels=self.LABELS,
+            state=state,
+        )
+
+        instance = self._make_one(None, None)
+        self.assertIsNone(instance.display_name)
+        self.assertIsNone(instance.type_)
+        self.assertIsNone(instance.labels)
+        instance._update_from_pb(instance_pb)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.type_, instance_type)
+        self.assertEqual(instance.labels, self.LABELS)
+        self.assertEqual(instance._state, state)
+
+    def test__update_from_pb_success_defaults(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable import enums
+
+        instance_pb = data_v2_pb2.Instance(display_name=self.DISPLAY_NAME)
+
+        instance = self._make_one(None, None)
+        self.assertIsNone(instance.display_name)
+        self.assertIsNone(instance.type_)
+        self.assertIsNone(instance.labels)
+        instance._update_from_pb(instance_pb)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.type_, enums.Instance.Type.UNSPECIFIED)
+        self.assertFalse(instance.labels)
+
+    def test__update_from_pb_no_display_name(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        instance_pb = data_v2_pb2.Instance()
+        instance = self._make_one(None, None)
+        self.assertIsNone(instance.display_name)
+        with self.assertRaises(ValueError):
+            instance._update_from_pb(instance_pb)
+
+    def test_from_pb_success(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable import enums
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance_type = enums.Instance.Type.PRODUCTION
+        state = enums.Instance.State.READY
+        instance_pb = data_v2_pb2.Instance(
+            name=self.INSTANCE_NAME,
+            display_name=self.INSTANCE_ID,
+            type=instance_type,
+            labels=self.LABELS,
+            state=state,
+        )
+
+        klass = self._get_target_class()
+        instance = klass.from_pb(instance_pb, client)
+        self.assertIsInstance(instance, klass)
+        self.assertEqual(instance._client, client)
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+        self.assertEqual(instance.type_, instance_type)
+        self.assertEqual(instance.labels, self.LABELS)
+        self.assertEqual(instance._state, state)
+
+    def test_from_pb_bad_instance_name(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        instance_name = "INCORRECT_FORMAT"
+        instance_pb = data_v2_pb2.Instance(name=instance_name)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(instance_pb, None)
+
+    def test_from_pb_project_mistmatch(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+
+        ALT_PROJECT = "ALT_PROJECT"
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=ALT_PROJECT, credentials=credentials, admin=True
+        )
+
+        self.assertNotEqual(self.PROJECT, ALT_PROJECT)
+
+        instance_pb = data_v2_pb2.Instance(name=self.INSTANCE_NAME)
+
+        klass = self._get_target_class()
+        with self.assertRaises(ValueError):
+            klass.from_pb(instance_pb, client)
+
+    def test_name_property(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        # Patch the the API method.
+        client._instance_admin_client = api
+
+        instance = self._make_one(self.INSTANCE_ID, client)
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+
+    def test___eq__(self):
+        client = object()
+        instance1 = self._make_one(self.INSTANCE_ID, client)
+        instance2 = self._make_one(self.INSTANCE_ID, client)
+        self.assertEqual(instance1, instance2)
+
+    def test___eq__type_differ(self):
+        client = object()
+        instance1 = self._make_one(self.INSTANCE_ID, client)
+        instance2 = object()
+        self.assertNotEqual(instance1, instance2)
+
+    def test___ne__same_value(self):
+        client = object()
+        instance1 = self._make_one(self.INSTANCE_ID, client)
+        instance2 = self._make_one(self.INSTANCE_ID, client)
+        comparison_val = instance1 != instance2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        instance1 = self._make_one("instance_id1", "client1")
+        instance2 = self._make_one("instance_id2", "client2")
+        self.assertNotEqual(instance1, instance2)
+
+    def test_create_check_location_and_clusters(self):
+        instance = self._make_one(self.INSTANCE_ID, None)
+
+        with self.assertRaises(ValueError):
+            instance.create(location_id=self.LOCATION_ID, clusters=[object(), object()])
+
+    def test_create_check_serve_nodes_and_clusters(self):
+        instance = self._make_one(self.INSTANCE_ID, None)
+
+        with self.assertRaises(ValueError):
+            instance.create(serve_nodes=3, clusters=[object(), object()])
+
+    def test_create_check_default_storage_type_and_clusters(self):
+        instance = self._make_one(self.INSTANCE_ID, None)
+
+        with self.assertRaises(ValueError):
+            instance.create(default_storage_type=1, clusters=[object(), object()])
+
+    def _instance_api_response_for_create(self):
+        import datetime
+        from google.api_core import operation
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+        NOW = datetime.datetime.utcnow()
+        NOW_PB = _datetime_to_pb_timestamp(NOW)
+        metadata = messages_v2_pb2.CreateInstanceMetadata(request_time=NOW_PB)
+        type_url = "type.googleapis.com/{}".format(
+            messages_v2_pb2.CreateInstanceMetadata.DESCRIPTOR.full_name
+        )
+        response_pb = operations_pb2.Operation(
+            name=self.OP_NAME,
+            metadata=Any(type_url=type_url, value=metadata.SerializeToString()),
+        )
+        response = operation.from_gapic(
+            response_pb,
+            mock.Mock(),
+            instance_pb2.Instance,
+            metadata_type=messages_v2_pb2.CreateInstanceMetadata,
+        )
+        project_path_template = "projects/{}"
+        location_path_template = "projects/{}/locations/{}"
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        instance_api.create_instance.return_value = response
+        instance_api.project_path = project_path_template.format
+        instance_api.location_path = location_path_template.format
+        return instance_api, response
+
+    def test_create(self):
+        from google.cloud.bigtable import enums
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+        import warnings
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            self.DISPLAY_NAME,
+            enums.Instance.Type.PRODUCTION,
+            self.LABELS,
+        )
+        instance_api, response = self._instance_api_response_for_create()
+        client._instance_admin_client = instance_api
+        serve_nodes = 3
+
+        with warnings.catch_warnings(record=True) as warned:
+            result = instance.create(
+                location_id=self.LOCATION_ID, serve_nodes=serve_nodes
+            )
+
+        cluster_pb = instance_pb2.Cluster(
+            location=instance_api.location_path(self.PROJECT, self.LOCATION_ID),
+            serve_nodes=serve_nodes,
+            default_storage_type=enums.StorageType.UNSPECIFIED,
+        )
+        instance_pb = instance_pb2.Instance(
+            display_name=self.DISPLAY_NAME,
+            type=enums.Instance.Type.PRODUCTION,
+            labels=self.LABELS,
+        )
+        cluster_id = "{}-cluster".format(self.INSTANCE_ID)
+        instance_api.create_instance.assert_called_once_with(
+            parent=instance_api.project_path(self.PROJECT),
+            instance_id=self.INSTANCE_ID,
+            instance=instance_pb,
+            clusters={cluster_id: cluster_pb},
+        )
+
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+        self.assertIs(result, response)
+
+    def test_create_w_clusters(self):
+        from google.cloud.bigtable import enums
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            self.DISPLAY_NAME,
+            enums.Instance.Type.PRODUCTION,
+            self.LABELS,
+        )
+        instance_api, response = self._instance_api_response_for_create()
+        client._instance_admin_client = instance_api
+
+        # Perform the method and check the result.
+        cluster_id_1 = "cluster-1"
+        cluster_id_2 = "cluster-2"
+        location_id_1 = "location-id-1"
+        location_id_2 = "location-id-2"
+        serve_nodes_1 = 3
+        serve_nodes_2 = 5
+        clusters = [
+            Cluster(
+                cluster_id_1,
+                instance,
+                location_id=location_id_1,
+                serve_nodes=serve_nodes_1,
+            ),
+            Cluster(
+                cluster_id_2,
+                instance,
+                location_id=location_id_2,
+                serve_nodes=serve_nodes_2,
+            ),
+        ]
+
+        result = instance.create(clusters=clusters)
+
+        cluster_pb_1 = instance_pb2.Cluster(
+            location=instance_api.location_path(self.PROJECT, location_id_1),
+            serve_nodes=serve_nodes_1,
+            default_storage_type=enums.StorageType.UNSPECIFIED,
+        )
+        cluster_pb_2 = instance_pb2.Cluster(
+            location=instance_api.location_path(self.PROJECT, location_id_2),
+            serve_nodes=serve_nodes_2,
+            default_storage_type=enums.StorageType.UNSPECIFIED,
+        )
+        instance_pb = instance_pb2.Instance(
+            display_name=self.DISPLAY_NAME,
+            type=enums.Instance.Type.PRODUCTION,
+            labels=self.LABELS,
+        )
+        instance_api.create_instance.assert_called_once_with(
+            parent=instance_api.project_path(self.PROJECT),
+            instance_id=self.INSTANCE_ID,
+            instance=instance_pb,
+            clusters={cluster_id_1: cluster_pb_1, cluster_id_2: cluster_pb_2},
+        )
+
+        self.assertIs(result, response)
+
+    def test_exists(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.api_core import exceptions
+
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+
+        # Create response_pb
+        instance_name = client.instance_admin_client.instance_path(
+            self.PROJECT, self.INSTANCE_ID
+        )
+        response_pb = data_v2_pb2.Instance(name=instance_name)
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = api
+        instance_admin_client = client._instance_admin_client
+        instance_stub = instance_admin_client.transport
+        instance_stub.get_instance.side_effect = [
+            response_pb,
+            exceptions.NotFound("testing"),
+            exceptions.BadRequest("testing"),
+        ]
+
+        # Perform the method and check the result.
+        non_existing_instance_id = "instance-id-2"
+        alt_instance_1 = self._make_one(self.INSTANCE_ID, client)
+        alt_instance_2 = self._make_one(non_existing_instance_id, client)
+        self.assertTrue(alt_instance_1.exists())
+        self.assertFalse(alt_instance_2.exists())
+
+        with self.assertRaises(exceptions.BadRequest):
+            alt_instance_2.exists()
+
+    def test_reload(self):
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable import enums
+
+        api = bigtable_instance_admin_client.BigtableInstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        # Create response_pb
+        DISPLAY_NAME = u"hey-hi-hello"
+        instance_type = enums.Instance.Type.PRODUCTION
+        response_pb = data_v2_pb2.Instance(
+            display_name=DISPLAY_NAME, type=instance_type, labels=self.LABELS
+        )
+
+        # Patch the stub used by the API method.
+        client._instance_admin_client = api
+        bigtable_instance_stub = client._instance_admin_client.transport
+        bigtable_instance_stub.get_instance.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_result = None  # reload() has no return value.
+
+        # Check Instance optional config values before.
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+
+        # Perform the method and check the result.
+        result = instance.reload()
+        self.assertEqual(result, expected_result)
+
+        # Check Instance optional config values before.
+        self.assertEqual(instance.display_name, DISPLAY_NAME)
+
+    def _instance_api_response_for_update(self):
+        import datetime
+        from google.api_core import operation
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+        NOW = datetime.datetime.utcnow()
+        NOW_PB = _datetime_to_pb_timestamp(NOW)
+        metadata = messages_v2_pb2.UpdateInstanceMetadata(request_time=NOW_PB)
+        type_url = "type.googleapis.com/{}".format(
+            messages_v2_pb2.UpdateInstanceMetadata.DESCRIPTOR.full_name
+        )
+        response_pb = operations_pb2.Operation(
+            name=self.OP_NAME,
+            metadata=Any(type_url=type_url, value=metadata.SerializeToString()),
+        )
+        response = operation.from_gapic(
+            response_pb,
+            mock.Mock(),
+            instance_pb2.Instance,
+            metadata_type=messages_v2_pb2.UpdateInstanceMetadata,
+        )
+        instance_path_template = "projects/{project}/instances/{instance}"
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        instance_api.partial_update_instance.return_value = response
+        instance_api.instance_path = instance_path_template.format
+        return instance_api, response
+
+    def test_update(self):
+        from google.cloud.bigtable import enums
+        from google.protobuf import field_mask_pb2
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            display_name=self.DISPLAY_NAME,
+            instance_type=enums.Instance.Type.DEVELOPMENT,
+            labels=self.LABELS,
+        )
+        instance_api, response = self._instance_api_response_for_update()
+        client._instance_admin_client = instance_api
+
+        result = instance.update()
+
+        instance_pb = instance_pb2.Instance(
+            name=instance.name,
+            display_name=instance.display_name,
+            type=instance.type_,
+            labels=instance.labels,
+        )
+        update_mask_pb = field_mask_pb2.FieldMask(
+            paths=["display_name", "type", "labels"]
+        )
+
+        instance_api.partial_update_instance.assert_called_once_with(
+            instance=instance_pb, update_mask=update_mask_pb
+        )
+
+        self.assertIs(result, response)
+
+    def test_update_empty(self):
+        from google.protobuf import field_mask_pb2
+        from google.cloud.bigtable_admin_v2.types import instance_pb2
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(None, client)
+        instance_api, response = self._instance_api_response_for_update()
+        client._instance_admin_client = instance_api
+
+        result = instance.update()
+
+        instance_pb = instance_pb2.Instance(
+            name=instance.name,
+            display_name=instance.display_name,
+            type=instance.type_,
+            labels=instance.labels,
+        )
+        update_mask_pb = field_mask_pb2.FieldMask()
+
+        instance_api.partial_update_instance.assert_called_once_with(
+            instance=instance_pb, update_mask=update_mask_pb
+        )
+
+        self.assertIs(result, response)
+
+    def test_delete(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        instance_api.delete_instance.return_value = None
+        client._instance_admin_client = instance_api
+
+        result = instance.delete()
+
+        instance_api.delete_instance.assert_called_once_with(instance.name)
+
+        self.assertIsNone(result)
+
+    def test_get_iam_policy(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.iam.v1 import policy_pb2
+        from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        version = 1
+        etag = b"etag_v1"
+        members = ["serviceAccount:service_acc1@test.com", "user:user1@test.com"]
+        bindings = [{"role": BIGTABLE_ADMIN_ROLE, "members": members}]
+        iam_policy = policy_pb2.Policy(version=version, etag=etag, bindings=bindings)
+
+        # Patch the stub used by the API method.
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        client._instance_admin_client = instance_api
+        instance_api.get_iam_policy.return_value = iam_policy
+
+        # Perform the method and check the result.
+        result = instance.get_iam_policy()
+
+        instance_api.get_iam_policy.assert_called_once_with(resource=instance.name)
+        self.assertEqual(result.version, version)
+        self.assertEqual(result.etag, etag)
+        admins = result.bigtable_admins
+        self.assertEqual(len(admins), len(members))
+        for found, expected in zip(sorted(admins), sorted(members)):
+            self.assertEqual(found, expected)
+
+    def test_set_iam_policy(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.iam.v1 import policy_pb2
+        from google.cloud.bigtable.policy import Policy
+        from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        version = 1
+        etag = b"etag_v1"
+        members = ["serviceAccount:service_acc1@test.com", "user:user1@test.com"]
+        bindings = [{"role": BIGTABLE_ADMIN_ROLE, "members": sorted(members)}]
+        iam_policy_pb = policy_pb2.Policy(version=version, etag=etag, bindings=bindings)
+
+        # Patch the stub used by the API method.
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        instance_api.set_iam_policy.return_value = iam_policy_pb
+        client._instance_admin_client = instance_api
+
+        # Perform the method and check the result.
+        iam_policy = Policy(etag=etag, version=version)
+        iam_policy[BIGTABLE_ADMIN_ROLE] = [
+            Policy.user("user1@test.com"),
+            Policy.service_account("service_acc1@test.com"),
+        ]
+
+        result = instance.set_iam_policy(iam_policy)
+
+        instance_api.set_iam_policy.assert_called_once_with(
+            resource=instance.name, policy=iam_policy_pb
+        )
+        self.assertEqual(result.version, version)
+        self.assertEqual(result.etag, etag)
+        admins = result.bigtable_admins
+        self.assertEqual(len(admins), len(members))
+        for found, expected in zip(sorted(admins), sorted(members)):
+            self.assertEqual(found, expected)
+
+    def test_test_iam_permissions(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.iam.v1 import iam_policy_pb2
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        permissions = ["bigtable.tables.create", "bigtable.clusters.create"]
+
+        response = iam_policy_pb2.TestIamPermissionsResponse(permissions=permissions)
+
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        instance_api.test_iam_permissions.return_value = response
+        client._instance_admin_client = instance_api
+
+        result = instance.test_iam_permissions(permissions)
+
+        self.assertEqual(result, permissions)
+        instance_api.test_iam_permissions.assert_called_once_with(
+            resource=instance.name, permissions=permissions
+        )
+
+    def test_cluster_factory(self):
+        from google.cloud.bigtable import enums
+
+        CLUSTER_ID = "{}-cluster".format(self.INSTANCE_ID)
+        LOCATION_ID = "us-central1-c"
+        SERVE_NODES = 3
+        STORAGE_TYPE = enums.StorageType.HDD
+
+        instance = self._make_one(self.INSTANCE_ID, None)
+
+        cluster = instance.cluster(
+            CLUSTER_ID,
+            location_id=LOCATION_ID,
+            serve_nodes=SERVE_NODES,
+            default_storage_type=STORAGE_TYPE,
+        )
+        self.assertIsInstance(cluster, Cluster)
+        self.assertEqual(cluster.cluster_id, CLUSTER_ID)
+        self.assertEqual(cluster.location_id, LOCATION_ID)
+        self.assertIsNone(cluster._state)
+        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
+        self.assertEqual(cluster.default_storage_type, STORAGE_TYPE)
+
+    def test_list_clusters(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_instance_admin_pb2 as messages_v2_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.instance import Instance
+        from google.cloud.bigtable.instance import Cluster
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = Instance(self.INSTANCE_ID, client)
+
+        failed_location = "FAILED"
+        cluster_id1 = "cluster-id1"
+        cluster_id2 = "cluster-id2"
+        cluster_path_template = "projects/{}/instances/{}/clusters/{}"
+        cluster_name1 = cluster_path_template.format(
+            self.PROJECT, self.INSTANCE_ID, cluster_id1
+        )
+        cluster_name2 = cluster_path_template.format(
+            self.PROJECT, self.INSTANCE_ID, cluster_id2
+        )
+
+        # Create response_pb
+        response_pb = messages_v2_pb2.ListClustersResponse(
+            failed_locations=[failed_location],
+            clusters=[
+                data_v2_pb2.Cluster(name=cluster_name1),
+                data_v2_pb2.Cluster(name=cluster_name2),
+            ],
+        )
+
+        # Patch the stub used by the API method.
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        instance_api.list_clusters.side_effect = [response_pb]
+        instance_api.cluster_path = cluster_path_template.format
+        client._instance_admin_client = instance_api
+
+        # Perform the method and check the result.
+        clusters, failed_locations = instance.list_clusters()
+
+        cluster_1, cluster_2 = clusters
+
+        self.assertIsInstance(cluster_1, Cluster)
+        self.assertEqual(cluster_1.name, cluster_name1)
+
+        self.assertIsInstance(cluster_2, Cluster)
+        self.assertEqual(cluster_2.name, cluster_name2)
+
+        self.assertEqual(failed_locations, [failed_location])
+
+    def test_table_factory(self):
+        from google.cloud.bigtable.table import Table
+
+        app_profile_id = "appProfileId1262094415"
+        instance = self._make_one(self.INSTANCE_ID, None)
+
+        table = instance.table(self.TABLE_ID, app_profile_id=app_profile_id)
+        self.assertIsInstance(table, Table)
+        self.assertEqual(table.table_id, self.TABLE_ID)
+        self.assertEqual(table._instance, instance)
+        self.assertEqual(table._app_profile_id, app_profile_id)
+
+    def _list_tables_helper(self, table_name=None):
+        from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_data_v2_pb2
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_table_admin_pb2 as table_messages_v1_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.gapic import (
+            bigtable_table_admin_client,
+            bigtable_instance_admin_client,
+        )
+
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            mock.Mock()
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        # Create response_pb
+        if table_name is None:
+            table_name = self.TABLE_NAME
+
+        response_pb = table_messages_v1_pb2.ListTablesResponse(
+            tables=[table_data_v2_pb2.Table(name=table_name)]
+        )
+
+        # Patch the stub used by the API method.
+        client._table_admin_client = table_api
+        client._instance_admin_client = instance_api
+        bigtable_table_stub = client._table_admin_client.transport
+        bigtable_table_stub.list_tables.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_table = instance.table(self.TABLE_ID)
+        expected_result = [expected_table]
+
+        # Perform the method and check the result.
+        result = instance.list_tables()
+
+        self.assertEqual(result, expected_result)
+
+    def test_list_tables(self):
+        self._list_tables_helper()
+
+    def test_list_tables_failure_bad_split(self):
+        with self.assertRaises(ValueError):
+            self._list_tables_helper(table_name="wrong-format")
+
+    def test_list_tables_failure_name_bad_before(self):
+        BAD_TABLE_NAME = (
+            "nonempty-section-before"
+            + "projects/"
+            + self.PROJECT
+            + "/instances/"
+            + self.INSTANCE_ID
+            + "/tables/"
+            + self.TABLE_ID
+        )
+        with self.assertRaises(ValueError):
+            self._list_tables_helper(table_name=BAD_TABLE_NAME)
+
+    def test_app_profile_factory(self):
+        from google.cloud.bigtable.enums import RoutingPolicyType
+
+        APP_PROFILE_ID_1 = "app-profile-id-1"
+        ANY = RoutingPolicyType.ANY
+        DESCRIPTION_1 = "routing policy any"
+        APP_PROFILE_ID_2 = "app-profile-id-2"
+        SINGLE = RoutingPolicyType.SINGLE
+        DESCRIPTION_2 = "routing policy single"
+        ALLOW_WRITES = True
+        CLUSTER_ID = "cluster-id"
+
+        instance = self._make_one(self.INSTANCE_ID, None)
+
+        app_profile1 = instance.app_profile(
+            APP_PROFILE_ID_1, routing_policy_type=ANY, description=DESCRIPTION_1
+        )
+
+        app_profile2 = instance.app_profile(
+            APP_PROFILE_ID_2,
+            routing_policy_type=SINGLE,
+            description=DESCRIPTION_2,
+            cluster_id=CLUSTER_ID,
+            allow_transactional_writes=ALLOW_WRITES,
+        )
+        self.assertEqual(app_profile1.app_profile_id, APP_PROFILE_ID_1)
+        self.assertIs(app_profile1._instance, instance)
+        self.assertEqual(app_profile1.routing_policy_type, ANY)
+        self.assertEqual(app_profile1.description, DESCRIPTION_1)
+        self.assertEqual(app_profile2.app_profile_id, APP_PROFILE_ID_2)
+        self.assertIs(app_profile2._instance, instance)
+        self.assertEqual(app_profile2.routing_policy_type, SINGLE)
+        self.assertEqual(app_profile2.description, DESCRIPTION_2)
+        self.assertEqual(app_profile2.cluster_id, CLUSTER_ID)
+        self.assertEqual(app_profile2.allow_transactional_writes, ALLOW_WRITES)
+
+    def test_list_app_profiles(self):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_instance_admin_client
+        from google.cloud.bigtable_admin_v2.proto import instance_pb2 as data_v2_pb2
+        from google.cloud.bigtable.app_profile import AppProfile
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT, credentials=credentials, admin=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        # Setup Expected Response
+        app_profile_path_template = "projects/{}/instances/{}/appProfiles/{}"
+        app_profile_id1 = "app-profile-id1"
+        app_profile_id2 = "app-profile-id2"
+        app_profile_name1 = app_profile_path_template.format(
+            self.PROJECT, self.INSTANCE_ID, app_profile_id1
+        )
+        app_profile_name2 = app_profile_path_template.format(
+            self.PROJECT, self.INSTANCE_ID, app_profile_id2
+        )
+        routing_policy = data_v2_pb2.AppProfile.MultiClusterRoutingUseAny()
+
+        app_profiles = [
+            data_v2_pb2.AppProfile(
+                name=app_profile_name1, multi_cluster_routing_use_any=routing_policy
+            ),
+            data_v2_pb2.AppProfile(
+                name=app_profile_name2, multi_cluster_routing_use_any=routing_policy
+            ),
+        ]
+        iterator = _Iterator(pages=[app_profiles])
+
+        # Patch the stub used by the API method.
+        instance_api = mock.create_autospec(
+            bigtable_instance_admin_client.BigtableInstanceAdminClient
+        )
+        client._instance_admin_client = instance_api
+        instance_api.app_profile_path = app_profile_path_template.format
+        instance_api.list_app_profiles.return_value = iterator
+
+        # Perform the method and check the result.
+        app_profiles = instance.list_app_profiles()
+
+        app_profile_1, app_profile_2 = app_profiles
+
+        self.assertIsInstance(app_profile_1, AppProfile)
+        self.assertEqual(app_profile_1.name, app_profile_name1)
+
+        self.assertIsInstance(app_profile_2, AppProfile)
+        self.assertEqual(app_profile_2.name, app_profile_name2)
diff --git a/bigtable/tests/unit/test_policy.py b/bigtable/tests/unit/test_policy.py
new file mode 100644
index 000000000000..74b19e49b29a
--- /dev/null
+++ b/bigtable/tests/unit/test_policy.py
@@ -0,0 +1,201 @@
+# 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.
+
+import unittest
+
+
+class TestPolicy(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.policy import Policy
+
+        return Policy
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        empty = frozenset()
+        policy = self._make_one()
+        self.assertIsNone(policy.etag)
+        self.assertIsNone(policy.version)
+        self.assertEqual(policy.bigtable_admins, empty)
+        self.assertEqual(policy.bigtable_readers, empty)
+        self.assertEqual(policy.bigtable_users, empty)
+        self.assertEqual(policy.bigtable_viewers, empty)
+        self.assertEqual(len(policy), 0)
+        self.assertEqual(dict(policy), {})
+
+    def test_ctor_explicit(self):
+        VERSION = 17
+        ETAG = b"ETAG"
+        empty = frozenset()
+        policy = self._make_one(ETAG, VERSION)
+        self.assertEqual(policy.etag, ETAG)
+        self.assertEqual(policy.version, VERSION)
+        self.assertEqual(policy.bigtable_admins, empty)
+        self.assertEqual(policy.bigtable_readers, empty)
+        self.assertEqual(policy.bigtable_users, empty)
+        self.assertEqual(policy.bigtable_viewers, empty)
+        self.assertEqual(len(policy), 0)
+        self.assertEqual(dict(policy), {})
+
+    def test_bigtable_admins_getter(self):
+        from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[BIGTABLE_ADMIN_ROLE] = [MEMBER]
+        self.assertEqual(policy.bigtable_admins, expected)
+
+    def test_bigtable_readers_getter(self):
+        from google.cloud.bigtable.policy import BIGTABLE_READER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[BIGTABLE_READER_ROLE] = [MEMBER]
+        self.assertEqual(policy.bigtable_readers, expected)
+
+    def test_bigtable_users_getter(self):
+        from google.cloud.bigtable.policy import BIGTABLE_USER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[BIGTABLE_USER_ROLE] = [MEMBER]
+        self.assertEqual(policy.bigtable_users, expected)
+
+    def test_bigtable_viewers_getter(self):
+        from google.cloud.bigtable.policy import BIGTABLE_VIEWER_ROLE
+
+        MEMBER = "user:phred@example.com"
+        expected = frozenset([MEMBER])
+        policy = self._make_one()
+        policy[BIGTABLE_VIEWER_ROLE] = [MEMBER]
+        self.assertEqual(policy.bigtable_viewers, expected)
+
+    def test_from_pb_empty(self):
+        from google.iam.v1 import policy_pb2
+
+        empty = frozenset()
+        message = policy_pb2.Policy()
+        klass = self._get_target_class()
+        policy = klass.from_pb(message)
+        self.assertEqual(policy.etag, b"")
+        self.assertEqual(policy.version, 0)
+        self.assertEqual(policy.bigtable_admins, empty)
+        self.assertEqual(policy.bigtable_readers, empty)
+        self.assertEqual(policy.bigtable_users, empty)
+        self.assertEqual(policy.bigtable_viewers, empty)
+        self.assertEqual(len(policy), 0)
+        self.assertEqual(dict(policy), {})
+
+    def test_from_pb_non_empty(self):
+        from google.iam.v1 import policy_pb2
+        from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+        ETAG = b"ETAG"
+        VERSION = 17
+        members = ["serviceAccount:service_acc1@test.com", "user:user1@test.com"]
+        empty = frozenset()
+        message = policy_pb2.Policy(
+            etag=ETAG,
+            version=VERSION,
+            bindings=[{"role": BIGTABLE_ADMIN_ROLE, "members": members}],
+        )
+        klass = self._get_target_class()
+        policy = klass.from_pb(message)
+        self.assertEqual(policy.etag, ETAG)
+        self.assertEqual(policy.version, VERSION)
+        self.assertEqual(policy.bigtable_admins, set(members))
+        self.assertEqual(policy.bigtable_readers, empty)
+        self.assertEqual(policy.bigtable_users, empty)
+        self.assertEqual(policy.bigtable_viewers, empty)
+        self.assertEqual(len(policy), 1)
+        self.assertEqual(dict(policy), {BIGTABLE_ADMIN_ROLE: set(members)})
+
+    def test_to_pb_empty(self):
+        from google.iam.v1 import policy_pb2
+
+        policy = self._make_one()
+        expected = policy_pb2.Policy()
+
+        self.assertEqual(policy.to_pb(), expected)
+
+    def test_to_pb_explicit(self):
+        from google.iam.v1 import policy_pb2
+        from google.cloud.bigtable.policy import BIGTABLE_ADMIN_ROLE
+
+        VERSION = 17
+        ETAG = b"ETAG"
+        members = ["serviceAccount:service_acc1@test.com", "user:user1@test.com"]
+        policy = self._make_one(ETAG, VERSION)
+        policy[BIGTABLE_ADMIN_ROLE] = members
+        expected = policy_pb2.Policy(
+            etag=ETAG,
+            version=VERSION,
+            bindings=[
+                policy_pb2.Binding(role=BIGTABLE_ADMIN_ROLE, members=sorted(members))
+            ],
+        )
+
+        self.assertEqual(policy.to_pb(), expected)
+
+    def test_from_api_repr_wo_etag(self):
+        VERSION = 17
+        empty = frozenset()
+        resource = {"version": VERSION}
+        klass = self._get_target_class()
+        policy = klass.from_api_repr(resource)
+        self.assertIsNone(policy.etag)
+        self.assertEqual(policy.version, VERSION)
+        self.assertEqual(policy.bigtable_admins, empty)
+        self.assertEqual(policy.bigtable_readers, empty)
+        self.assertEqual(policy.bigtable_users, empty)
+        self.assertEqual(policy.bigtable_viewers, empty)
+        self.assertEqual(len(policy), 0)
+        self.assertEqual(dict(policy), {})
+
+    def test_from_api_repr_w_etag(self):
+        import base64
+
+        ETAG = b"ETAG"
+        empty = frozenset()
+        resource = {"etag": base64.b64encode(ETAG).decode("ascii")}
+        klass = self._get_target_class()
+        policy = klass.from_api_repr(resource)
+        self.assertEqual(policy.etag, ETAG)
+        self.assertIsNone(policy.version)
+        self.assertEqual(policy.bigtable_admins, empty)
+        self.assertEqual(policy.bigtable_readers, empty)
+        self.assertEqual(policy.bigtable_users, empty)
+        self.assertEqual(policy.bigtable_viewers, empty)
+        self.assertEqual(len(policy), 0)
+        self.assertEqual(dict(policy), {})
+
+    def test_to_api_repr_wo_etag(self):
+        VERSION = 17
+        resource = {"version": VERSION}
+        policy = self._make_one(version=VERSION)
+        self.assertEqual(policy.to_api_repr(), resource)
+
+    def test_to_api_repr_w_etag(self):
+        import base64
+
+        ETAG = b"ETAG"
+        policy = self._make_one(etag=ETAG)
+        resource = {"etag": base64.b64encode(ETAG).decode("ascii")}
+        self.assertEqual(policy.to_api_repr(), resource)
diff --git a/bigtable/tests/unit/test_row.py b/bigtable/tests/unit/test_row.py
new file mode 100644
index 000000000000..b4aaefb862f8
--- /dev/null
+++ b/bigtable/tests/unit/test_row.py
@@ -0,0 +1,829 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+import mock
+
+from ._testing import _make_credentials
+
+
+class TestRow(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row import Row
+
+        return Row
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_row_key_getter(self):
+        row = self._make_one(row_key=b"row_key", table="table")
+        self.assertEqual(b"row_key", row.row_key)
+
+    def test_row_table_getter(self):
+        row = self._make_one(row_key=b"row_key", table="table")
+        self.assertEqual("table", row.table)
+
+
+class Test_SetDeleteRow(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row import _SetDeleteRow
+
+        return _SetDeleteRow
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test__get_mutations_virtual(self):
+        row = self._make_one(b"row-key", None)
+        with self.assertRaises(NotImplementedError):
+            row._get_mutations(None)
+
+
+class TestDirectRow(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row import DirectRow
+
+        return DirectRow
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        row_key = b"row_key"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._row_key, row_key)
+        self.assertIs(row._table, table)
+        self.assertEqual(row._pb_mutations, [])
+
+    def test_constructor_with_unicode(self):
+        row_key = u"row_key"
+        row_key_bytes = b"row_key"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._row_key, row_key_bytes)
+        self.assertIs(row._table, table)
+
+    def test_constructor_with_non_bytes(self):
+        row_key = object()
+        with self.assertRaises(TypeError):
+            self._make_one(row_key, None)
+
+    def test__get_mutations(self):
+        row_key = b"row_key"
+        row = self._make_one(row_key, None)
+
+        row._pb_mutations = mutations = object()
+        self.assertIs(mutations, row._get_mutations(None))
+
+    def test_get_mutations_size(self):
+        row_key = b"row_key"
+        row = self._make_one(row_key, None)
+
+        column_family_id1 = u"column_family_id1"
+        column_family_id2 = u"column_family_id2"
+        column1 = b"column1"
+        column2 = b"column2"
+        number_of_bytes = 1 * 1024 * 1024
+        value = b"1" * number_of_bytes
+
+        row.set_cell(column_family_id1, column1, value)
+        row.set_cell(column_family_id2, column2, value)
+
+        total_mutations_size = 0
+        for mutation in row._get_mutations():
+            total_mutations_size += mutation.ByteSize()
+
+        self.assertEqual(row.get_mutations_size(), total_mutations_size)
+
+    def _set_cell_helper(
+        self,
+        column=None,
+        column_bytes=None,
+        value=b"foobar",
+        timestamp=None,
+        timestamp_micros=-1,
+    ):
+        import six
+        import struct
+
+        row_key = b"row_key"
+        column_family_id = u"column_family_id"
+        if column is None:
+            column = b"column"
+        table = object()
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._pb_mutations, [])
+        row.set_cell(column_family_id, column, value, timestamp=timestamp)
+
+        if isinstance(value, six.integer_types):
+            value = struct.pack(">q", value)
+        expected_pb = _MutationPB(
+            set_cell=_MutationSetCellPB(
+                family_name=column_family_id,
+                column_qualifier=column_bytes or column,
+                timestamp_micros=timestamp_micros,
+                value=value,
+            )
+        )
+        self.assertEqual(row._pb_mutations, [expected_pb])
+
+    def test_set_cell(self):
+        self._set_cell_helper()
+
+    def test_set_cell_with_string_column(self):
+        column_bytes = b"column"
+        column_non_bytes = u"column"
+        self._set_cell_helper(column=column_non_bytes, column_bytes=column_bytes)
+
+    def test_set_cell_with_integer_value(self):
+        value = 1337
+        self._set_cell_helper(value=value)
+
+    def test_set_cell_with_non_bytes_value(self):
+        row_key = b"row_key"
+        column = b"column"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        value = object()  # Not bytes
+        with self.assertRaises(TypeError):
+            row.set_cell(column_family_id, column, value)
+
+    def test_set_cell_with_non_null_timestamp(self):
+        import datetime
+        from google.cloud._helpers import _EPOCH
+
+        microseconds = 898294371
+        millis_granularity = microseconds - (microseconds % 1000)
+        timestamp = _EPOCH + datetime.timedelta(microseconds=microseconds)
+        self._set_cell_helper(timestamp=timestamp, timestamp_micros=millis_granularity)
+
+    def test_delete(self):
+        row_key = b"row_key"
+        row = self._make_one(row_key, object())
+        self.assertEqual(row._pb_mutations, [])
+        row.delete()
+
+        expected_pb = _MutationPB(delete_from_row=_MutationDeleteFromRowPB())
+        self.assertEqual(row._pb_mutations, [expected_pb])
+
+    def test_delete_cell(self):
+        klass = self._get_target_class()
+
+        class MockRow(klass):
+            def __init__(self, *args, **kwargs):
+                super(MockRow, self).__init__(*args, **kwargs)
+                self._args = []
+                self._kwargs = []
+
+            # Replace the called method with one that logs arguments.
+            def _delete_cells(self, *args, **kwargs):
+                self._args.append(args)
+                self._kwargs.append(kwargs)
+
+        row_key = b"row_key"
+        column = b"column"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        mock_row = MockRow(row_key, table)
+        # Make sure no values are set before calling the method.
+        self.assertEqual(mock_row._pb_mutations, [])
+        self.assertEqual(mock_row._args, [])
+        self.assertEqual(mock_row._kwargs, [])
+
+        # Actually make the request against the mock class.
+        time_range = object()
+        mock_row.delete_cell(column_family_id, column, time_range=time_range)
+        self.assertEqual(mock_row._pb_mutations, [])
+        self.assertEqual(mock_row._args, [(column_family_id, [column])])
+        self.assertEqual(mock_row._kwargs, [{"state": None, "time_range": time_range}])
+
+    def test_delete_cells_non_iterable(self):
+        row_key = b"row_key"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        columns = object()  # Not iterable
+        with self.assertRaises(TypeError):
+            row.delete_cells(column_family_id, columns)
+
+    def test_delete_cells_all_columns(self):
+        row_key = b"row_key"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        klass = self._get_target_class()
+        self.assertEqual(row._pb_mutations, [])
+        row.delete_cells(column_family_id, klass.ALL_COLUMNS)
+
+        expected_pb = _MutationPB(
+            delete_from_family=_MutationDeleteFromFamilyPB(family_name=column_family_id)
+        )
+        self.assertEqual(row._pb_mutations, [expected_pb])
+
+    def test_delete_cells_no_columns(self):
+        row_key = b"row_key"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        columns = []
+        self.assertEqual(row._pb_mutations, [])
+        row.delete_cells(column_family_id, columns)
+        self.assertEqual(row._pb_mutations, [])
+
+    def _delete_cells_helper(self, time_range=None):
+        row_key = b"row_key"
+        column = b"column"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        columns = [column]
+        self.assertEqual(row._pb_mutations, [])
+        row.delete_cells(column_family_id, columns, time_range=time_range)
+
+        expected_pb = _MutationPB(
+            delete_from_column=_MutationDeleteFromColumnPB(
+                family_name=column_family_id, column_qualifier=column
+            )
+        )
+        if time_range is not None:
+            expected_pb.delete_from_column.time_range.CopyFrom(time_range.to_pb())
+        self.assertEqual(row._pb_mutations, [expected_pb])
+
+    def test_delete_cells_no_time_range(self):
+        self._delete_cells_helper()
+
+    def test_delete_cells_with_time_range(self):
+        import datetime
+        from google.cloud._helpers import _EPOCH
+        from google.cloud.bigtable.row_filters import TimestampRange
+
+        microseconds = 30871000  # Makes sure already milliseconds granularity
+        start = _EPOCH + datetime.timedelta(microseconds=microseconds)
+        time_range = TimestampRange(start=start)
+        self._delete_cells_helper(time_range=time_range)
+
+    def test_delete_cells_with_bad_column(self):
+        # This makes sure a failure on one of the columns doesn't leave
+        # the row's mutations in a bad state.
+        row_key = b"row_key"
+        column = b"column"
+        column_family_id = u"column_family_id"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        columns = [column, object()]
+        self.assertEqual(row._pb_mutations, [])
+        with self.assertRaises(TypeError):
+            row.delete_cells(column_family_id, columns)
+        self.assertEqual(row._pb_mutations, [])
+
+    def test_delete_cells_with_string_columns(self):
+        row_key = b"row_key"
+        column_family_id = u"column_family_id"
+        column1 = u"column1"
+        column1_bytes = b"column1"
+        column2 = u"column2"
+        column2_bytes = b"column2"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        columns = [column1, column2]
+        self.assertEqual(row._pb_mutations, [])
+        row.delete_cells(column_family_id, columns)
+
+        expected_pb1 = _MutationPB(
+            delete_from_column=_MutationDeleteFromColumnPB(
+                family_name=column_family_id, column_qualifier=column1_bytes
+            )
+        )
+        expected_pb2 = _MutationPB(
+            delete_from_column=_MutationDeleteFromColumnPB(
+                family_name=column_family_id, column_qualifier=column2_bytes
+            )
+        )
+        self.assertEqual(row._pb_mutations, [expected_pb1, expected_pb2])
+
+    def test_commit(self):
+        project_id = "project-id"
+        row_key = b"row_key"
+        table_name = "projects/more-stuff"
+        column_family_id = u"column_family_id"
+        column = b"column"
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(table_name, client=client)
+        row = self._make_one(row_key, table)
+        value = b"bytes-value"
+
+        # Perform the method and check the result.
+        row.set_cell(column_family_id, column, value)
+        row.commit()
+        self.assertEqual(table.mutated_rows, [row])
+
+
+class TestConditionalRow(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row import ConditionalRow
+
+        return ConditionalRow
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        row_key = b"row_key"
+        table = object()
+        filter_ = object()
+
+        row = self._make_one(row_key, table, filter_=filter_)
+        self.assertEqual(row._row_key, row_key)
+        self.assertIs(row._table, table)
+        self.assertIs(row._filter, filter_)
+        self.assertEqual(row._true_pb_mutations, [])
+        self.assertEqual(row._false_pb_mutations, [])
+
+    def test__get_mutations(self):
+        row_key = b"row_key"
+        filter_ = object()
+        row = self._make_one(row_key, None, filter_=filter_)
+
+        row._true_pb_mutations = true_mutations = object()
+        row._false_pb_mutations = false_mutations = object()
+        self.assertIs(true_mutations, row._get_mutations(True))
+        self.assertIs(false_mutations, row._get_mutations(False))
+        self.assertIs(false_mutations, row._get_mutations(None))
+
+    def test_commit(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+
+        project_id = "project-id"
+        row_key = b"row_key"
+        table_name = "projects/more-stuff"
+        column_family_id1 = u"column_family_id1"
+        column_family_id2 = u"column_family_id2"
+        column_family_id3 = u"column_family_id3"
+        column1 = b"column1"
+        column2 = b"column2"
+
+        api = bigtable_client.BigtableClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(table_name, client=client)
+        row_filter = RowSampleFilter(0.33)
+        row = self._make_one(row_key, table, filter_=row_filter)
+
+        # Create request_pb
+        value1 = b"bytes-value"
+
+        # Create response_pb
+        predicate_matched = True
+        response_pb = _CheckAndMutateRowResponsePB(predicate_matched=predicate_matched)
+
+        # Patch the stub used by the API method.
+        api.transport.check_and_mutate_row.side_effect = [response_pb]
+        client._table_data_client = api
+
+        # Create expected_result.
+        expected_result = predicate_matched
+
+        # Perform the method and check the result.
+        row.set_cell(column_family_id1, column1, value1, state=True)
+        row.delete(state=False)
+        row.delete_cell(column_family_id2, column2, state=True)
+        row.delete_cells(column_family_id3, row.ALL_COLUMNS, state=True)
+        result = row.commit()
+        self.assertEqual(result, expected_result)
+        self.assertEqual(row._true_pb_mutations, [])
+        self.assertEqual(row._false_pb_mutations, [])
+
+    def test_commit_too_many_mutations(self):
+        from google.cloud._testing import _Monkey
+        from google.cloud.bigtable import row as MUT
+
+        row_key = b"row_key"
+        table = object()
+        filter_ = object()
+        row = self._make_one(row_key, table, filter_=filter_)
+        row._true_pb_mutations = [1, 2, 3]
+        num_mutations = len(row._true_pb_mutations)
+        with _Monkey(MUT, MAX_MUTATIONS=num_mutations - 1):
+            with self.assertRaises(ValueError):
+                row.commit()
+
+    def test_commit_no_mutations(self):
+        from tests.unit._testing import _FakeStub
+
+        project_id = "project-id"
+        row_key = b"row_key"
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(None, client=client)
+        filter_ = object()
+        row = self._make_one(row_key, table, filter_=filter_)
+        self.assertEqual(row._true_pb_mutations, [])
+        self.assertEqual(row._false_pb_mutations, [])
+
+        # Patch the stub used by the API method.
+        stub = _FakeStub()
+
+        # Perform the method and check the result.
+        result = row.commit()
+        self.assertIsNone(result)
+        # Make sure no request was sent.
+        self.assertEqual(stub.method_calls, [])
+
+
+class TestAppendRow(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row import AppendRow
+
+        return AppendRow
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        row_key = b"row_key"
+        table = object()
+
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._row_key, row_key)
+        self.assertIs(row._table, table)
+        self.assertEqual(row._rule_pb_list, [])
+
+    def test_clear(self):
+        row_key = b"row_key"
+        table = object()
+        row = self._make_one(row_key, table)
+        row._rule_pb_list = [1, 2, 3]
+        row.clear()
+        self.assertEqual(row._rule_pb_list, [])
+
+    def test_append_cell_value(self):
+        table = object()
+        row_key = b"row_key"
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._rule_pb_list, [])
+
+        column = b"column"
+        column_family_id = u"column_family_id"
+        value = b"bytes-val"
+        row.append_cell_value(column_family_id, column, value)
+        expected_pb = _ReadModifyWriteRulePB(
+            family_name=column_family_id, column_qualifier=column, append_value=value
+        )
+        self.assertEqual(row._rule_pb_list, [expected_pb])
+
+    def test_increment_cell_value(self):
+        table = object()
+        row_key = b"row_key"
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._rule_pb_list, [])
+
+        column = b"column"
+        column_family_id = u"column_family_id"
+        int_value = 281330
+        row.increment_cell_value(column_family_id, column, int_value)
+        expected_pb = _ReadModifyWriteRulePB(
+            family_name=column_family_id,
+            column_qualifier=column,
+            increment_amount=int_value,
+        )
+        self.assertEqual(row._rule_pb_list, [expected_pb])
+
+    def test_commit(self):
+        from google.cloud._testing import _Monkey
+        from google.cloud.bigtable import row as MUT
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+
+        project_id = "project-id"
+        row_key = b"row_key"
+        table_name = "projects/more-stuff"
+        column_family_id = u"column_family_id"
+        column = b"column"
+
+        api = bigtable_client.BigtableClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(table_name, client=client)
+        row = self._make_one(row_key, table)
+
+        # Create request_pb
+        value = b"bytes-value"
+
+        # Create expected_result.
+        row_responses = []
+        expected_result = object()
+
+        # Patch API calls
+        client._table_data_client = api
+
+        def mock_parse_rmw_row_response(row_response):
+            row_responses.append(row_response)
+            return expected_result
+
+        # Perform the method and check the result.
+        with _Monkey(MUT, _parse_rmw_row_response=mock_parse_rmw_row_response):
+            row.append_cell_value(column_family_id, column, value)
+            result = row.commit()
+
+        self.assertEqual(result, expected_result)
+        self.assertEqual(row._rule_pb_list, [])
+
+    def test_commit_no_rules(self):
+        from tests.unit._testing import _FakeStub
+
+        project_id = "project-id"
+        row_key = b"row_key"
+
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=project_id, credentials=credentials, admin=True
+        )
+        table = _Table(None, client=client)
+        row = self._make_one(row_key, table)
+        self.assertEqual(row._rule_pb_list, [])
+
+        # Patch the stub used by the API method.
+        stub = _FakeStub()
+
+        # Perform the method and check the result.
+        result = row.commit()
+        self.assertEqual(result, {})
+        # Make sure no request was sent.
+        self.assertEqual(stub.method_calls, [])
+
+    def test_commit_too_many_mutations(self):
+        from google.cloud._testing import _Monkey
+        from google.cloud.bigtable import row as MUT
+
+        row_key = b"row_key"
+        table = object()
+        row = self._make_one(row_key, table)
+        row._rule_pb_list = [1, 2, 3]
+        num_mutations = len(row._rule_pb_list)
+        with _Monkey(MUT, MAX_MUTATIONS=num_mutations - 1):
+            with self.assertRaises(ValueError):
+                row.commit()
+
+
+class Test__parse_rmw_row_response(unittest.TestCase):
+    def _call_fut(self, row_response):
+        from google.cloud.bigtable.row import _parse_rmw_row_response
+
+        return _parse_rmw_row_response(row_response)
+
+    def test_it(self):
+        from google.cloud._helpers import _datetime_from_microseconds
+
+        col_fam1 = u"col-fam-id"
+        col_fam2 = u"col-fam-id2"
+        col_name1 = b"col-name1"
+        col_name2 = b"col-name2"
+        col_name3 = b"col-name3-but-other-fam"
+        cell_val1 = b"cell-val"
+        cell_val2 = b"cell-val-newer"
+        cell_val3 = b"altcol-cell-val"
+        cell_val4 = b"foo"
+
+        microseconds = 1000871
+        timestamp = _datetime_from_microseconds(microseconds)
+        expected_output = {
+            col_fam1: {
+                col_name1: [(cell_val1, timestamp), (cell_val2, timestamp)],
+                col_name2: [(cell_val3, timestamp)],
+            },
+            col_fam2: {col_name3: [(cell_val4, timestamp)]},
+        }
+        response_row = _RowPB(
+            families=[
+                _FamilyPB(
+                    name=col_fam1,
+                    columns=[
+                        _ColumnPB(
+                            qualifier=col_name1,
+                            cells=[
+                                _CellPB(value=cell_val1, timestamp_micros=microseconds),
+                                _CellPB(value=cell_val2, timestamp_micros=microseconds),
+                            ],
+                        ),
+                        _ColumnPB(
+                            qualifier=col_name2,
+                            cells=[
+                                _CellPB(value=cell_val3, timestamp_micros=microseconds)
+                            ],
+                        ),
+                    ],
+                ),
+                _FamilyPB(
+                    name=col_fam2,
+                    columns=[
+                        _ColumnPB(
+                            qualifier=col_name3,
+                            cells=[
+                                _CellPB(value=cell_val4, timestamp_micros=microseconds)
+                            ],
+                        )
+                    ],
+                ),
+            ]
+        )
+        sample_input = _ReadModifyWriteRowResponsePB(row=response_row)
+        self.assertEqual(expected_output, self._call_fut(sample_input))
+
+
+class Test__parse_family_pb(unittest.TestCase):
+    def _call_fut(self, family_pb):
+        from google.cloud.bigtable.row import _parse_family_pb
+
+        return _parse_family_pb(family_pb)
+
+    def test_it(self):
+        from google.cloud._helpers import _datetime_from_microseconds
+
+        col_fam1 = u"col-fam-id"
+        col_name1 = b"col-name1"
+        col_name2 = b"col-name2"
+        cell_val1 = b"cell-val"
+        cell_val2 = b"cell-val-newer"
+        cell_val3 = b"altcol-cell-val"
+
+        microseconds = 5554441037
+        timestamp = _datetime_from_microseconds(microseconds)
+        expected_dict = {
+            col_name1: [(cell_val1, timestamp), (cell_val2, timestamp)],
+            col_name2: [(cell_val3, timestamp)],
+        }
+        expected_output = (col_fam1, expected_dict)
+        sample_input = _FamilyPB(
+            name=col_fam1,
+            columns=[
+                _ColumnPB(
+                    qualifier=col_name1,
+                    cells=[
+                        _CellPB(value=cell_val1, timestamp_micros=microseconds),
+                        _CellPB(value=cell_val2, timestamp_micros=microseconds),
+                    ],
+                ),
+                _ColumnPB(
+                    qualifier=col_name2,
+                    cells=[_CellPB(value=cell_val3, timestamp_micros=microseconds)],
+                ),
+            ],
+        )
+        self.assertEqual(expected_output, self._call_fut(sample_input))
+
+
+def _CheckAndMutateRowResponsePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    return messages_v2_pb2.CheckAndMutateRowResponse(*args, **kw)
+
+
+def _ReadModifyWriteRowResponsePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    return messages_v2_pb2.ReadModifyWriteRowResponse(*args, **kw)
+
+
+def _CellPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Cell(*args, **kw)
+
+
+def _ColumnPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Column(*args, **kw)
+
+
+def _FamilyPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Family(*args, **kw)
+
+
+def _MutationPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Mutation(*args, **kw)
+
+
+def _MutationSetCellPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Mutation.SetCell(*args, **kw)
+
+
+def _MutationDeleteFromColumnPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Mutation.DeleteFromColumn(*args, **kw)
+
+
+def _MutationDeleteFromFamilyPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Mutation.DeleteFromFamily(*args, **kw)
+
+
+def _MutationDeleteFromRowPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Mutation.DeleteFromRow(*args, **kw)
+
+
+def _RowPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.Row(*args, **kw)
+
+
+def _ReadModifyWriteRulePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.ReadModifyWriteRule(*args, **kw)
+
+
+class _Instance(object):
+    def __init__(self, client=None):
+        self._client = client
+
+
+class _Table(object):
+    def __init__(self, name, client=None):
+        self.name = name
+        self._instance = _Instance(client)
+        self.client = client
+        self.mutated_rows = []
+
+    def mutate_rows(self, rows):
+        self.mutated_rows.extend(rows)
diff --git a/bigtable/tests/unit/test_row_data.py b/bigtable/tests/unit/test_row_data.py
new file mode 100644
index 000000000000..b787233829b2
--- /dev/null
+++ b/bigtable/tests/unit/test_row_data.py
@@ -0,0 +1,1309 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+import mock
+
+from google.api_core.exceptions import DeadlineExceeded
+from ._testing import _make_credentials
+from google.cloud.bigtable.row_set import RowRange
+from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        return self.channel_stub.responses.pop()
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class TestCell(unittest.TestCase):
+    timestamp_micros = 18738724000  # Make sure millis granularity
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_data import Cell
+
+        return Cell
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def _from_pb_test_helper(self, labels=None):
+        import datetime
+        from google.cloud._helpers import _EPOCH
+        from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+        timestamp_micros = TestCell.timestamp_micros
+        timestamp = _EPOCH + datetime.timedelta(microseconds=timestamp_micros)
+        value = b"value-bytes"
+
+        if labels is None:
+            cell_pb = data_v2_pb2.Cell(value=value, timestamp_micros=timestamp_micros)
+            cell_expected = self._make_one(value, timestamp_micros)
+        else:
+            cell_pb = data_v2_pb2.Cell(
+                value=value, timestamp_micros=timestamp_micros, labels=labels
+            )
+            cell_expected = self._make_one(value, timestamp_micros, labels=labels)
+
+        klass = self._get_target_class()
+        result = klass.from_pb(cell_pb)
+        self.assertEqual(result, cell_expected)
+        self.assertEqual(result.timestamp, timestamp)
+
+    def test_from_pb(self):
+        self._from_pb_test_helper()
+
+    def test_from_pb_with_labels(self):
+        labels = [u"label1", u"label2"]
+        self._from_pb_test_helper(labels)
+
+    def test_constructor(self):
+        value = object()
+        cell = self._make_one(value, TestCell.timestamp_micros)
+        self.assertEqual(cell.value, value)
+
+    def test___eq__(self):
+        value = object()
+        cell1 = self._make_one(value, TestCell.timestamp_micros)
+        cell2 = self._make_one(value, TestCell.timestamp_micros)
+        self.assertEqual(cell1, cell2)
+
+    def test___eq__type_differ(self):
+        cell1 = self._make_one(None, None)
+        cell2 = object()
+        self.assertNotEqual(cell1, cell2)
+
+    def test___ne__same_value(self):
+        value = object()
+        cell1 = self._make_one(value, TestCell.timestamp_micros)
+        cell2 = self._make_one(value, TestCell.timestamp_micros)
+        comparison_val = cell1 != cell2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        value1 = "value1"
+        value2 = "value2"
+        cell1 = self._make_one(value1, TestCell.timestamp_micros)
+        cell2 = self._make_one(value2, TestCell.timestamp_micros)
+        self.assertNotEqual(cell1, cell2)
+
+
+class TestPartialRowData(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_data import PartialRowData
+
+        return PartialRowData
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        row_key = object()
+        partial_row_data = self._make_one(row_key)
+        self.assertIs(partial_row_data._row_key, row_key)
+        self.assertEqual(partial_row_data._cells, {})
+
+    def test___eq__(self):
+        row_key = object()
+        partial_row_data1 = self._make_one(row_key)
+        partial_row_data2 = self._make_one(row_key)
+        self.assertEqual(partial_row_data1, partial_row_data2)
+
+    def test___eq__type_differ(self):
+        partial_row_data1 = self._make_one(None)
+        partial_row_data2 = object()
+        self.assertNotEqual(partial_row_data1, partial_row_data2)
+
+    def test___ne__same_value(self):
+        row_key = object()
+        partial_row_data1 = self._make_one(row_key)
+        partial_row_data2 = self._make_one(row_key)
+        comparison_val = partial_row_data1 != partial_row_data2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        row_key1 = object()
+        partial_row_data1 = self._make_one(row_key1)
+        row_key2 = object()
+        partial_row_data2 = self._make_one(row_key2)
+        self.assertNotEqual(partial_row_data1, partial_row_data2)
+
+    def test___ne__cells(self):
+        row_key = object()
+        partial_row_data1 = self._make_one(row_key)
+        partial_row_data1._cells = object()
+        partial_row_data2 = self._make_one(row_key)
+        self.assertNotEqual(partial_row_data1, partial_row_data2)
+
+    def test_to_dict(self):
+        cell1 = object()
+        cell2 = object()
+        cell3 = object()
+
+        family_name1 = u"name1"
+        family_name2 = u"name2"
+        qual1 = b"col1"
+        qual2 = b"col2"
+        qual3 = b"col3"
+
+        partial_row_data = self._make_one(None)
+        partial_row_data._cells = {
+            family_name1: {qual1: cell1, qual2: cell2},
+            family_name2: {qual3: cell3},
+        }
+
+        result = partial_row_data.to_dict()
+        expected_result = {
+            b"name1:col1": cell1,
+            b"name1:col2": cell2,
+            b"name2:col3": cell3,
+        }
+        self.assertEqual(result, expected_result)
+
+    def test_cell_value(self):
+        family_name = u"name1"
+        qualifier = b"col1"
+        cell = _make_cell(b"value-bytes")
+
+        partial_row_data = self._make_one(None)
+        partial_row_data._cells = {family_name: {qualifier: [cell]}}
+
+        result = partial_row_data.cell_value(family_name, qualifier)
+        self.assertEqual(result, cell.value)
+
+    def test_cell_value_invalid_index(self):
+        family_name = u"name1"
+        qualifier = b"col1"
+        cell = _make_cell(b"")
+
+        partial_row_data = self._make_one(None)
+        partial_row_data._cells = {family_name: {qualifier: [cell]}}
+
+        with self.assertRaises(IndexError):
+            partial_row_data.cell_value(family_name, qualifier, index=None)
+
+    def test_cell_value_invalid_column_family_key(self):
+        family_name = u"name1"
+        qualifier = b"col1"
+
+        partial_row_data = self._make_one(None)
+
+        with self.assertRaises(KeyError):
+            partial_row_data.cell_value(family_name, qualifier)
+
+    def test_cell_value_invalid_column_key(self):
+        family_name = u"name1"
+        qualifier = b"col1"
+
+        partial_row_data = self._make_one(None)
+        partial_row_data._cells = {family_name: {}}
+
+        with self.assertRaises(KeyError):
+            partial_row_data.cell_value(family_name, qualifier)
+
+    def test_cell_values(self):
+        family_name = u"name1"
+        qualifier = b"col1"
+        cell = _make_cell(b"value-bytes")
+
+        partial_row_data = self._make_one(None)
+        partial_row_data._cells = {family_name: {qualifier: [cell]}}
+
+        values = []
+        for value, timestamp_micros in partial_row_data.cell_values(
+            family_name, qualifier
+        ):
+            values.append(value)
+
+        self.assertEqual(values[0], cell.value)
+
+    def test_cell_values_with_max_count(self):
+        family_name = u"name1"
+        qualifier = b"col1"
+        cell_1 = _make_cell(b"value-bytes-1")
+        cell_2 = _make_cell(b"value-bytes-2")
+
+        partial_row_data = self._make_one(None)
+        partial_row_data._cells = {family_name: {qualifier: [cell_1, cell_2]}}
+
+        values = []
+        for value, timestamp_micros in partial_row_data.cell_values(
+            family_name, qualifier, max_count=1
+        ):
+            values.append(value)
+
+        self.assertEqual(1, len(values))
+        self.assertEqual(values[0], cell_1.value)
+
+    def test_cells_property(self):
+        partial_row_data = self._make_one(None)
+        cells = {1: 2}
+        partial_row_data._cells = cells
+        self.assertEqual(partial_row_data.cells, cells)
+
+    def test_row_key_getter(self):
+        row_key = object()
+        partial_row_data = self._make_one(row_key)
+        self.assertIs(partial_row_data.row_key, row_key)
+
+
+class _Client(object):
+
+    data_stub = None
+
+
+class Test_retry_read_rows_exception(unittest.TestCase):
+    @staticmethod
+    def _call_fut(exc):
+        from google.cloud.bigtable.row_data import _retry_read_rows_exception
+
+        return _retry_read_rows_exception(exc)
+
+    @staticmethod
+    def _make_grpc_call_error(exception):
+        from grpc import Call
+        from grpc import RpcError
+
+        class TestingException(Call, RpcError):
+            def __init__(self, exception):
+                self.exception = exception
+
+            def code(self):
+                return self.exception.grpc_status_code
+
+            def details(self):
+                return "Testing"
+
+        return TestingException(exception)
+
+    def test_w_miss(self):
+        from google.api_core.exceptions import Conflict
+
+        exception = Conflict("testing")
+        self.assertFalse(self._call_fut(exception))
+
+    def test_w_service_unavailable(self):
+        from google.api_core.exceptions import ServiceUnavailable
+
+        exception = ServiceUnavailable("testing")
+        self.assertTrue(self._call_fut(exception))
+
+    def test_w_deadline_exceeded(self):
+        from google.api_core.exceptions import DeadlineExceeded
+
+        exception = DeadlineExceeded("testing")
+        self.assertTrue(self._call_fut(exception))
+
+    def test_w_miss_wrapped_in_grpc(self):
+        from google.api_core.exceptions import Conflict
+
+        wrapped = Conflict("testing")
+        exception = self._make_grpc_call_error(wrapped)
+        self.assertFalse(self._call_fut(exception))
+
+    def test_w_service_unavailable_wrapped_in_grpc(self):
+        from google.api_core.exceptions import ServiceUnavailable
+
+        wrapped = ServiceUnavailable("testing")
+        exception = self._make_grpc_call_error(wrapped)
+        self.assertTrue(self._call_fut(exception))
+
+    def test_w_deadline_exceeded_wrapped_in_grpc(self):
+        from google.api_core.exceptions import DeadlineExceeded
+
+        wrapped = DeadlineExceeded("testing")
+        exception = self._make_grpc_call_error(wrapped)
+        self.assertTrue(self._call_fut(exception))
+
+
+class TestPartialRowsData(unittest.TestCase):
+    ROW_KEY = b"row-key"
+    FAMILY_NAME = u"family"
+    QUALIFIER = b"qualifier"
+    TIMESTAMP_MICROS = 100
+    VALUE = b"value"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_data import PartialRowsData
+
+        return PartialRowsData
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        from google.cloud.bigtable.row_data import DEFAULT_RETRY_READ_ROWS
+
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        partial_rows_data = self._make_one(client._data_stub.ReadRows, request)
+        self.assertIs(partial_rows_data.request, request)
+        self.assertEqual(partial_rows_data.rows, {})
+        self.assertEqual(partial_rows_data.retry, DEFAULT_RETRY_READ_ROWS)
+
+    def test_constructor_with_retry(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = retry = object()
+        partial_rows_data = self._make_one(client._data_stub.ReadRows, request, retry)
+        self.assertIs(partial_rows_data.request, request)
+        self.assertEqual(partial_rows_data.rows, {})
+        self.assertEqual(partial_rows_data.retry, retry)
+
+    def test___eq__(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        partial_rows_data1 = self._make_one(client._data_stub.ReadRows, request)
+        partial_rows_data2 = self._make_one(client._data_stub.ReadRows, request)
+        self.assertEqual(partial_rows_data1.rows, partial_rows_data2.rows)
+
+    def test___eq__type_differ(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        partial_rows_data1 = self._make_one(client._data_stub.ReadRows, request)
+        partial_rows_data2 = object()
+        self.assertNotEqual(partial_rows_data1, partial_rows_data2)
+
+    def test___ne__same_value(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        partial_rows_data1 = self._make_one(client._data_stub.ReadRows, request)
+        partial_rows_data2 = self._make_one(client._data_stub.ReadRows, request)
+        comparison_val = partial_rows_data1 != partial_rows_data2
+        self.assertTrue(comparison_val)
+
+    def test___ne__(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        partial_rows_data1 = self._make_one(client._data_stub.ReadRows, request)
+        partial_rows_data2 = self._make_one(client._data_stub.ReadRows, request)
+        self.assertNotEqual(partial_rows_data1, partial_rows_data2)
+
+    def test_rows_getter(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        partial_rows_data = self._make_one(client._data_stub.ReadRows, request)
+        partial_rows_data.rows = value = object()
+        self.assertIs(partial_rows_data.rows, value)
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_state_start(self):
+        client = _Client()
+        iterator = _MockCancellableIterator()
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+        request = object()
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+        self.assertEqual(yrd.state, yrd.NEW_ROW)
+
+    def test_state_new_row_w_row(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+
+        chunk = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+        chunks = [chunk]
+
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        channel = ChannelStub(responses=[iterator])
+        data_api = bigtable_client.BigtableClient(channel=channel)
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        request = object()
+
+        yrd = self._make_one(client._table_data_client.transport.read_rows, request)
+
+        yrd._response_iterator = iterator
+        rows = [row for row in yrd]
+
+        result = rows[0]
+        self.assertEqual(result.row_key, self.ROW_KEY)
+        self.assertEqual(yrd._counter, 1)
+        self.assertEqual(yrd.state, yrd.NEW_ROW)
+
+    def test_multiple_chunks(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+
+        chunk1 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=False,
+        )
+        chunk2 = _ReadRowsResponseCellChunkPB(
+            qualifier=self.QUALIFIER + b"1",
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+        chunks = [chunk1, chunk2]
+
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        channel = ChannelStub(responses=[iterator])
+        data_api = bigtable_client.BigtableClient(channel=channel)
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        request = object()
+
+        yrd = self._make_one(client._table_data_client.transport.read_rows, request)
+
+        yrd._response_iterator = iterator
+        rows = [row for row in yrd]
+        result = rows[0]
+        self.assertEqual(result.row_key, self.ROW_KEY)
+        self.assertEqual(yrd._counter, 1)
+        self.assertEqual(yrd.state, yrd.NEW_ROW)
+
+    def test_cancel(self):
+        client = _Client()
+        response_iterator = _MockCancellableIterator()
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [response_iterator]
+        request = object()
+        yield_rows_data = self._make_one(client._data_stub.ReadRows, request)
+        self.assertEqual(response_iterator.cancel_calls, 0)
+        yield_rows_data.cancel()
+        self.assertEqual(response_iterator.cancel_calls, 1)
+        self.assertEqual(list(yield_rows_data), [])
+
+    # 'consume_next' tested via 'TestPartialRowsData_JSON_acceptance_tests'
+
+    def test__copy_from_previous_unset(self):
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+        cell = _PartialCellData()
+        yrd._copy_from_previous(cell)
+        self.assertEqual(cell.row_key, b"")
+        self.assertEqual(cell.family_name, u"")
+        self.assertIsNone(cell.qualifier)
+        self.assertEqual(cell.timestamp_micros, 0)
+        self.assertEqual(cell.labels, [])
+
+    def test__copy_from_previous_blank(self):
+        ROW_KEY = "RK"
+        FAMILY_NAME = u"A"
+        QUALIFIER = b"C"
+        TIMESTAMP_MICROS = 100
+        LABELS = ["L1", "L2"]
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+        cell = _PartialCellData(
+            row_key=ROW_KEY,
+            family_name=FAMILY_NAME,
+            qualifier=QUALIFIER,
+            timestamp_micros=TIMESTAMP_MICROS,
+            labels=LABELS,
+        )
+        yrd._previous_cell = _PartialCellData()
+        yrd._copy_from_previous(cell)
+        self.assertEqual(cell.row_key, ROW_KEY)
+        self.assertEqual(cell.family_name, FAMILY_NAME)
+        self.assertEqual(cell.qualifier, QUALIFIER)
+        self.assertEqual(cell.timestamp_micros, TIMESTAMP_MICROS)
+        self.assertEqual(cell.labels, LABELS)
+
+    def test__copy_from_previous_filled(self):
+        ROW_KEY = "RK"
+        FAMILY_NAME = u"A"
+        QUALIFIER = b"C"
+        TIMESTAMP_MICROS = 100
+        LABELS = ["L1", "L2"]
+        client = _Client()
+        client._data_stub = mock.MagicMock()
+        request = object()
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+        yrd._previous_cell = _PartialCellData(
+            row_key=ROW_KEY,
+            family_name=FAMILY_NAME,
+            qualifier=QUALIFIER,
+            timestamp_micros=TIMESTAMP_MICROS,
+            labels=LABELS,
+        )
+        cell = _PartialCellData()
+        yrd._copy_from_previous(cell)
+        self.assertEqual(cell.row_key, ROW_KEY)
+        self.assertEqual(cell.family_name, FAMILY_NAME)
+        self.assertEqual(cell.qualifier, QUALIFIER)
+        self.assertEqual(cell.timestamp_micros, 0)
+        self.assertEqual(cell.labels, [])
+
+    def test_valid_last_scanned_row_key_on_start(self):
+        client = _Client()
+        response = _ReadRowsResponseV2(chunks=(), last_scanned_row_key="2.AFTER")
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+        request = object()
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+        yrd.last_scanned_row_key = "1.BEFORE"
+        self._consume_all(yrd)
+        self.assertEqual(yrd.last_scanned_row_key, "2.AFTER")
+
+    def test_invalid_empty_chunk(self):
+        from google.cloud.bigtable.row_data import InvalidChunk
+
+        client = _Client()
+        chunks = _generate_cell_chunks([""])
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+        request = object()
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+        with self.assertRaises(InvalidChunk):
+            self._consume_all(yrd)
+
+    def test_state_cell_in_progress(self):
+        LABELS = ["L1", "L2"]
+
+        request = object()
+        read_rows = mock.MagicMock()
+        yrd = self._make_one(read_rows, request)
+
+        chunk = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            labels=LABELS,
+        )
+        yrd._update_cell(chunk)
+
+        more_cell_data = _ReadRowsResponseCellChunkPB(value=self.VALUE)
+        yrd._update_cell(more_cell_data)
+
+        self.assertEqual(yrd._cell.row_key, self.ROW_KEY)
+        self.assertEqual(yrd._cell.family_name, self.FAMILY_NAME)
+        self.assertEqual(yrd._cell.qualifier, self.QUALIFIER)
+        self.assertEqual(yrd._cell.timestamp_micros, self.TIMESTAMP_MICROS)
+        self.assertEqual(yrd._cell.labels, LABELS)
+        self.assertEqual(yrd._cell.value, self.VALUE + self.VALUE)
+
+    def test_yield_rows_data(self):
+        client = _Client()
+
+        chunk = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+        chunks = [chunk]
+
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+
+        request = object()
+
+        yrd = self._make_one(client._data_stub.ReadRows, request)
+
+        result = self._consume_all(yrd)[0]
+
+        self.assertEqual(result, self.ROW_KEY)
+
+    def test_yield_retry_rows_data(self):
+        from google.api_core import retry
+
+        client = _Client()
+
+        retry_read_rows = retry.Retry(predicate=_read_rows_retry_exception)
+
+        chunk = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+        chunks = [chunk]
+
+        response = _ReadRowsResponseV2(chunks)
+        failure_iterator = _MockFailureIterator_1()
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [failure_iterator, iterator]
+
+        request = object()
+
+        yrd = self._make_one(client._data_stub.ReadRows, request, retry_read_rows)
+
+        result = self._consume_all(yrd)[0]
+
+        self.assertEqual(result, self.ROW_KEY)
+
+    def _consume_all(self, yrd):
+        return [row.row_key for row in yrd]
+
+
+class Test_ReadRowsRequestManager(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.table_name = "table_name"
+        cls.row_range1 = RowRange(b"row_key21", b"row_key29")
+        cls.row_range2 = RowRange(b"row_key31", b"row_key39")
+        cls.row_range3 = RowRange(b"row_key41", b"row_key49")
+
+        cls.request = _ReadRowsRequestPB(table_name=cls.table_name)
+        cls.request.rows.row_ranges.add(**cls.row_range1.get_range_kwargs())
+        cls.request.rows.row_ranges.add(**cls.row_range2.get_range_kwargs())
+        cls.request.rows.row_ranges.add(**cls.row_range3.get_range_kwargs())
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_data import _ReadRowsRequestManager
+
+        return _ReadRowsRequestManager
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        request = mock.Mock()
+        last_scanned_key = "last_key"
+        rows_read_so_far = 10
+
+        request_manager = self._make_one(request, last_scanned_key, rows_read_so_far)
+        self.assertEqual(request, request_manager.message)
+        self.assertEqual(last_scanned_key, request_manager.last_scanned_key)
+        self.assertEqual(rows_read_so_far, request_manager.rows_read_so_far)
+
+    def test__filter_row_key(self):
+        table_name = "table_name"
+        request = _ReadRowsRequestPB(table_name=table_name)
+        request.rows.row_keys.extend(
+            [b"row_key1", b"row_key2", b"row_key3", b"row_key4"]
+        )
+
+        last_scanned_key = b"row_key2"
+        request_manager = self._make_one(request, last_scanned_key, 2)
+        row_keys = request_manager._filter_rows_keys()
+
+        expected_row_keys = [b"row_key3", b"row_key4"]
+        self.assertEqual(expected_row_keys, row_keys)
+
+    def test__filter_row_ranges_all_ranges_added_back(self):
+        last_scanned_key = b"row_key14"
+        request_manager = self._make_one(self.request, last_scanned_key, 2)
+        row_ranges = request_manager._filter_row_ranges()
+
+        exp_row_range1 = data_v2_pb2.RowRange(
+            start_key_closed=b"row_key21", end_key_open=b"row_key29"
+        )
+        exp_row_range2 = data_v2_pb2.RowRange(
+            start_key_closed=b"row_key31", end_key_open=b"row_key39"
+        )
+        exp_row_range3 = data_v2_pb2.RowRange(
+            start_key_closed=b"row_key41", end_key_open=b"row_key49"
+        )
+        exp_row_ranges = [exp_row_range1, exp_row_range2, exp_row_range3]
+
+        self.assertEqual(exp_row_ranges, row_ranges)
+
+    def test__filter_row_ranges_all_ranges_already_read(self):
+        last_scanned_key = b"row_key54"
+        request_manager = self._make_one(self.request, last_scanned_key, 2)
+        row_ranges = request_manager._filter_row_ranges()
+
+        self.assertEqual(row_ranges, [])
+
+    def test__filter_row_ranges_all_ranges_already_read_open_closed(self):
+        last_scanned_key = b"row_key54"
+
+        row_range1 = RowRange(b"row_key21", b"row_key29", False, True)
+        row_range2 = RowRange(b"row_key31", b"row_key39")
+        row_range3 = RowRange(b"row_key41", b"row_key49", False, True)
+
+        request = _ReadRowsRequestPB(table_name=self.table_name)
+        request.rows.row_ranges.add(**row_range1.get_range_kwargs())
+        request.rows.row_ranges.add(**row_range2.get_range_kwargs())
+        request.rows.row_ranges.add(**row_range3.get_range_kwargs())
+
+        request_manager = self._make_one(request, last_scanned_key, 2)
+        request_manager.new_message = _ReadRowsRequestPB(table_name=self.table_name)
+        row_ranges = request_manager._filter_row_ranges()
+
+        self.assertEqual(row_ranges, [])
+
+    def test__filter_row_ranges_some_ranges_already_read(self):
+        last_scanned_key = b"row_key22"
+        request_manager = self._make_one(self.request, last_scanned_key, 2)
+        request_manager.new_message = _ReadRowsRequestPB(table_name=self.table_name)
+        row_ranges = request_manager._filter_row_ranges()
+
+        exp_row_range1 = data_v2_pb2.RowRange(
+            start_key_open=b"row_key22", end_key_open=b"row_key29"
+        )
+        exp_row_range2 = data_v2_pb2.RowRange(
+            start_key_closed=b"row_key31", end_key_open=b"row_key39"
+        )
+        exp_row_range3 = data_v2_pb2.RowRange(
+            start_key_closed=b"row_key41", end_key_open=b"row_key49"
+        )
+        exp_row_ranges = [exp_row_range1, exp_row_range2, exp_row_range3]
+
+        self.assertEqual(exp_row_ranges, row_ranges)
+
+    def test_build_updated_request(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        row_filter = RowSampleFilter(0.33)
+        last_scanned_key = b"row_key25"
+        request = _ReadRowsRequestPB(
+            filter=row_filter.to_pb(), rows_limit=8, table_name=self.table_name
+        )
+        request.rows.row_ranges.add(**self.row_range1.get_range_kwargs())
+
+        request_manager = self._make_one(request, last_scanned_key, 2)
+
+        result = request_manager.build_updated_request()
+
+        expected_result = _ReadRowsRequestPB(
+            table_name=self.table_name, filter=row_filter.to_pb(), rows_limit=6
+        )
+        expected_result.rows.row_ranges.add(
+            start_key_open=last_scanned_key, end_key_open=self.row_range1.end_key
+        )
+
+        self.assertEqual(expected_result, result)
+
+    def test_build_updated_request_full_table(self):
+        last_scanned_key = b"row_key14"
+
+        request = _ReadRowsRequestPB(table_name=self.table_name)
+        request_manager = self._make_one(request, last_scanned_key, 2)
+
+        result = request_manager.build_updated_request()
+        expected_result = _ReadRowsRequestPB(table_name=self.table_name, filter={})
+        expected_result.rows.row_ranges.add(start_key_open=last_scanned_key)
+        self.assertEqual(expected_result, result)
+
+    def test_build_updated_request_no_start_key(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        row_filter = RowSampleFilter(0.33)
+        last_scanned_key = b"row_key25"
+        request = _ReadRowsRequestPB(
+            filter=row_filter.to_pb(), rows_limit=8, table_name=self.table_name
+        )
+        request.rows.row_ranges.add(end_key_open=b"row_key29")
+
+        request_manager = self._make_one(request, last_scanned_key, 2)
+
+        result = request_manager.build_updated_request()
+
+        expected_result = _ReadRowsRequestPB(
+            table_name=self.table_name, filter=row_filter.to_pb(), rows_limit=6
+        )
+        expected_result.rows.row_ranges.add(
+            start_key_open=last_scanned_key, end_key_open=b"row_key29"
+        )
+
+        self.assertEqual(expected_result, result)
+
+    def test_build_updated_request_no_end_key(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        row_filter = RowSampleFilter(0.33)
+        last_scanned_key = b"row_key25"
+        request = _ReadRowsRequestPB(
+            filter=row_filter.to_pb(), rows_limit=8, table_name=self.table_name
+        )
+        request.rows.row_ranges.add(start_key_closed=b"row_key20")
+
+        request_manager = self._make_one(request, last_scanned_key, 2)
+
+        result = request_manager.build_updated_request()
+
+        expected_result = _ReadRowsRequestPB(
+            table_name=self.table_name, filter=row_filter.to_pb(), rows_limit=6
+        )
+        expected_result.rows.row_ranges.add(start_key_open=last_scanned_key)
+
+        self.assertEqual(expected_result, result)
+
+    def test_build_updated_request_rows(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        row_filter = RowSampleFilter(0.33)
+        last_scanned_key = b"row_key4"
+        request = _ReadRowsRequestPB(
+            filter=row_filter.to_pb(), rows_limit=5, table_name=self.table_name
+        )
+        request.rows.row_keys.extend(
+            [
+                b"row_key1",
+                b"row_key2",
+                b"row_key4",
+                b"row_key5",
+                b"row_key7",
+                b"row_key9",
+            ]
+        )
+
+        request_manager = self._make_one(request, last_scanned_key, 3)
+
+        result = request_manager.build_updated_request()
+
+        expected_result = _ReadRowsRequestPB(
+            table_name=self.table_name, filter=row_filter.to_pb(), rows_limit=2
+        )
+        expected_result.rows.row_keys.extend([b"row_key5", b"row_key7", b"row_key9"])
+
+        self.assertEqual(expected_result, result)
+
+    def test_build_updated_request_rows_limit(self):
+        last_scanned_key = b"row_key14"
+
+        request = _ReadRowsRequestPB(table_name=self.table_name, rows_limit=10)
+        request_manager = self._make_one(request, last_scanned_key, 2)
+
+        result = request_manager.build_updated_request()
+        expected_result = _ReadRowsRequestPB(
+            table_name=self.table_name, filter={}, rows_limit=8
+        )
+        expected_result.rows.row_ranges.add(start_key_open=last_scanned_key)
+        self.assertEqual(expected_result, result)
+
+    def test__key_already_read(self):
+        last_scanned_key = b"row_key14"
+        request = _ReadRowsRequestPB(table_name=self.table_name)
+        request_manager = self._make_one(request, last_scanned_key, 2)
+
+        self.assertTrue(request_manager._key_already_read(b"row_key11"))
+        self.assertFalse(request_manager._key_already_read(b"row_key16"))
+
+
+class TestPartialRowsData_JSON_acceptance_tests(unittest.TestCase):
+
+    _json_tests = None
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_data import PartialRowsData
+
+        return PartialRowsData
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def _load_json_test(self, test_name):
+        import os
+
+        if self.__class__._json_tests is None:
+            dirname = os.path.dirname(__file__)
+            filename = os.path.join(dirname, "read-rows-acceptance-test.json")
+            raw = _parse_readrows_acceptance_tests(filename)
+            tests = self.__class__._json_tests = {}
+            for (name, chunks, results) in raw:
+                tests[name] = chunks, results
+        return self.__class__._json_tests[test_name]
+
+    # JSON Error cases:  invalid chunks
+
+    def _fail_during_consume(self, testcase_name):
+        from google.cloud.bigtable.row_data import InvalidChunk
+
+        client = _Client()
+        chunks, results = self._load_json_test(testcase_name)
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+        request = object()
+        prd = self._make_one(client._data_stub.ReadRows, request)
+        with self.assertRaises(InvalidChunk):
+            prd.consume_all()
+        expected_result = self._sort_flattend_cells(
+            [result for result in results if not result["error"]]
+        )
+        flattened = self._sort_flattend_cells(_flatten_cells(prd))
+        self.assertEqual(flattened, expected_result)
+
+    def test_invalid_no_cell_key_before_commit(self):
+        self._fail_during_consume("invalid - no cell key before commit")
+
+    def test_invalid_no_cell_key_before_value(self):
+        self._fail_during_consume("invalid - no cell key before value")
+
+    def test_invalid_new_col_family_wo_qualifier(self):
+        self._fail_during_consume("invalid - new col family must specify qualifier")
+
+    def test_invalid_no_commit_between_rows(self):
+        self._fail_during_consume("invalid - no commit between rows")
+
+    def test_invalid_no_commit_after_first_row(self):
+        self._fail_during_consume("invalid - no commit after first row")
+
+    def test_invalid_duplicate_row_key(self):
+        self._fail_during_consume("invalid - duplicate row key")
+
+    def test_invalid_new_row_missing_row_key(self):
+        self._fail_during_consume("invalid - new row missing row key")
+
+    def test_invalid_bare_reset(self):
+        self._fail_during_consume("invalid - bare reset")
+
+    def test_invalid_bad_reset_no_commit(self):
+        self._fail_during_consume("invalid - bad reset, no commit")
+
+    def test_invalid_missing_key_after_reset(self):
+        self._fail_during_consume("invalid - missing key after reset")
+
+    def test_invalid_reset_with_chunk(self):
+        self._fail_during_consume("invalid - reset with chunk")
+
+    def test_invalid_commit_with_chunk(self):
+        self._fail_during_consume("invalid - commit with chunk")
+
+    # JSON Error cases:  incomplete final row
+
+    def _sort_flattend_cells(self, flattened):
+        import operator
+
+        key_func = operator.itemgetter("rk", "fm", "qual")
+        return sorted(flattened, key=key_func)
+
+    def _incomplete_final_row(self, testcase_name):
+        client = _Client()
+        chunks, results = self._load_json_test(testcase_name)
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+        request = object()
+        prd = self._make_one(client._data_stub.ReadRows, request)
+        with self.assertRaises(ValueError):
+            prd.consume_all()
+        self.assertEqual(prd.state, prd.ROW_IN_PROGRESS)
+        expected_result = self._sort_flattend_cells(
+            [result for result in results if not result["error"]]
+        )
+        flattened = self._sort_flattend_cells(_flatten_cells(prd))
+        self.assertEqual(flattened, expected_result)
+
+    def test_invalid_no_commit(self):
+        self._incomplete_final_row("invalid - no commit")
+
+    def test_invalid_last_row_missing_commit(self):
+        self._incomplete_final_row("invalid - last row missing commit")
+
+    # Non-error cases
+
+    _marker = object()
+
+    def _match_results(self, testcase_name, expected_result=_marker):
+        client = _Client()
+        chunks, results = self._load_json_test(testcase_name)
+        response = _ReadRowsResponseV2(chunks)
+        iterator = _MockCancellableIterator(response)
+        client._data_stub = mock.MagicMock()
+        client._data_stub.ReadRows.side_effect = [iterator]
+        request = object()
+        prd = self._make_one(client._data_stub.ReadRows, request)
+        prd.consume_all()
+        flattened = self._sort_flattend_cells(_flatten_cells(prd))
+        if expected_result is self._marker:
+            expected_result = self._sort_flattend_cells(results)
+        self.assertEqual(flattened, expected_result)
+
+    def test_bare_commit_implies_ts_zero(self):
+        self._match_results("bare commit implies ts=0")
+
+    def test_simple_row_with_timestamp(self):
+        self._match_results("simple row with timestamp")
+
+    def test_missing_timestamp_implies_ts_zero(self):
+        self._match_results("missing timestamp, implied ts=0")
+
+    def test_empty_cell_value(self):
+        self._match_results("empty cell value")
+
+    def test_two_unsplit_cells(self):
+        self._match_results("two unsplit cells")
+
+    def test_two_qualifiers(self):
+        self._match_results("two qualifiers")
+
+    def test_two_families(self):
+        self._match_results("two families")
+
+    def test_with_labels(self):
+        self._match_results("with labels")
+
+    def test_split_cell_bare_commit(self):
+        self._match_results("split cell, bare commit")
+
+    def test_split_cell(self):
+        self._match_results("split cell")
+
+    def test_split_four_ways(self):
+        self._match_results("split four ways")
+
+    def test_two_split_cells(self):
+        self._match_results("two split cells")
+
+    def test_multi_qualifier_splits(self):
+        self._match_results("multi-qualifier splits")
+
+    def test_multi_qualifier_multi_split(self):
+        self._match_results("multi-qualifier multi-split")
+
+    def test_multi_family_split(self):
+        self._match_results("multi-family split")
+
+    def test_two_rows(self):
+        self._match_results("two rows")
+
+    def test_two_rows_implicit_timestamp(self):
+        self._match_results("two rows implicit timestamp")
+
+    def test_two_rows_empty_value(self):
+        self._match_results("two rows empty value")
+
+    def test_two_rows_one_with_multiple_cells(self):
+        self._match_results("two rows, one with multiple cells")
+
+    def test_two_rows_multiple_cells_multiple_families(self):
+        self._match_results("two rows, multiple cells, multiple families")
+
+    def test_two_rows_multiple_cells(self):
+        self._match_results("two rows, multiple cells")
+
+    def test_two_rows_four_cells_two_labels(self):
+        self._match_results("two rows, four cells, 2 labels")
+
+    def test_two_rows_with_splits_same_timestamp(self):
+        self._match_results("two rows with splits, same timestamp")
+
+    def test_no_data_after_reset(self):
+        # JSON testcase has `"results": null`
+        self._match_results("no data after reset", expected_result=[])
+
+    def test_simple_reset(self):
+        self._match_results("simple reset")
+
+    def test_reset_to_new_val(self):
+        self._match_results("reset to new val")
+
+    def test_reset_to_new_qual(self):
+        self._match_results("reset to new qual")
+
+    def test_reset_with_splits(self):
+        self._match_results("reset with splits")
+
+    def test_two_resets(self):
+        self._match_results("two resets")
+
+    def test_reset_to_new_row(self):
+        self._match_results("reset to new row")
+
+    def test_reset_in_between_chunks(self):
+        self._match_results("reset in between chunks")
+
+    def test_empty_cell_chunk(self):
+        self._match_results("empty cell chunk")
+
+    def test_empty_second_qualifier(self):
+        self._match_results("empty second qualifier")
+
+
+def _flatten_cells(prd):
+    # Match results format from JSON testcases.
+    # Doesn't handle error cases.
+    from google.cloud._helpers import _bytes_to_unicode
+    from google.cloud._helpers import _microseconds_from_datetime
+
+    for row_key, row in prd.rows.items():
+        for family_name, family in row.cells.items():
+            for qualifier, column in family.items():
+                for cell in column:
+                    yield {
+                        u"rk": _bytes_to_unicode(row_key),
+                        u"fm": family_name,
+                        u"qual": _bytes_to_unicode(qualifier),
+                        u"ts": _microseconds_from_datetime(cell.timestamp),
+                        u"value": _bytes_to_unicode(cell.value),
+                        u"label": u" ".join(cell.labels),
+                        u"error": False,
+                    }
+
+
+class _MockCancellableIterator(object):
+
+    cancel_calls = 0
+
+    def __init__(self, *values):
+        self.iter_values = iter(values)
+
+    def cancel(self):
+        self.cancel_calls += 1
+
+    def next(self):
+        return next(self.iter_values)
+
+    __next__ = next
+
+
+class _MockFailureIterator_1(object):
+    def next(self):
+        raise DeadlineExceeded("Failed to read from server")
+
+    __next__ = next
+
+
+class _PartialCellData(object):
+
+    row_key = b""
+    family_name = u""
+    qualifier = None
+    timestamp_micros = 0
+
+    def __init__(self, **kw):
+        self.labels = kw.pop("labels", [])
+        self.__dict__.update(kw)
+
+
+class _ReadRowsResponseV2(object):
+    def __init__(self, chunks, last_scanned_row_key=""):
+        self.chunks = chunks
+        self.last_scanned_row_key = last_scanned_row_key
+
+
+def _generate_cell_chunks(chunk_text_pbs):
+    from google.protobuf.text_format import Merge
+    from google.cloud.bigtable_v2.proto.bigtable_pb2 import ReadRowsResponse
+
+    chunks = []
+
+    for chunk_text_pb in chunk_text_pbs:
+        chunk = ReadRowsResponse.CellChunk()
+        chunks.append(Merge(chunk_text_pb, chunk))
+
+    return chunks
+
+
+def _parse_readrows_acceptance_tests(filename):
+    """Parse acceptance tests from JSON
+
+    See
+    https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/\
+    4d3185662ca61bc9fa1bdf1ec0166f6e5ecf86c6/bigtable-client-core/src/\
+    test/resources/com/google/cloud/bigtable/grpc/scanner/v2/
+    read-rows-acceptance-test.json
+    """
+    import json
+
+    with open(filename) as json_file:
+        test_json = json.load(json_file)
+
+    for test in test_json["tests"]:
+        name = test["name"]
+        chunks = _generate_cell_chunks(test["chunks"])
+        results = test["results"]
+        yield name, chunks, results
+
+
+def _ReadRowsResponseCellChunkPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    family_name = kw.pop("family_name", None)
+    qualifier = kw.pop("qualifier", None)
+    message = messages_v2_pb2.ReadRowsResponse.CellChunk(*args, **kw)
+
+    if family_name:
+        message.family_name.value = family_name
+    if qualifier:
+        message.qualifier.value = qualifier
+
+    return message
+
+
+def _make_cell(value):
+    from google.cloud.bigtable import row_data
+
+    return row_data.Cell(value, TestCell.timestamp_micros)
+
+
+def _ReadRowsRequestPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    return messages_v2_pb2.ReadRowsRequest(*args, **kw)
+
+
+def _read_rows_retry_exception(exc):
+    return isinstance(exc, DeadlineExceeded)
diff --git a/bigtable/tests/unit/test_row_filters.py b/bigtable/tests/unit/test_row_filters.py
new file mode 100644
index 000000000000..1c51651d8c44
--- /dev/null
+++ b/bigtable/tests/unit/test_row_filters.py
@@ -0,0 +1,1033 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+
+class Test_BoolFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import _BoolFilter
+
+        return _BoolFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        flag = object()
+        row_filter = self._make_one(flag)
+        self.assertIs(row_filter.flag, flag)
+
+    def test___eq__type_differ(self):
+        flag = object()
+        row_filter1 = self._make_one(flag)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test___eq__same_value(self):
+        flag = object()
+        row_filter1 = self._make_one(flag)
+        row_filter2 = self._make_one(flag)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test___ne__same_value(self):
+        flag = object()
+        row_filter1 = self._make_one(flag)
+        row_filter2 = self._make_one(flag)
+        comparison_val = row_filter1 != row_filter2
+        self.assertFalse(comparison_val)
+
+
+class TestSinkFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import SinkFilter
+
+        return SinkFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        flag = True
+        row_filter = self._make_one(flag)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(sink=flag)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestPassAllFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import PassAllFilter
+
+        return PassAllFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        flag = True
+        row_filter = self._make_one(flag)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(pass_all_filter=flag)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestBlockAllFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import BlockAllFilter
+
+        return BlockAllFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        flag = True
+        row_filter = self._make_one(flag)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(block_all_filter=flag)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class Test_RegexFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import _RegexFilter
+
+        return _RegexFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        regex = b"abc"
+        row_filter = self._make_one(regex)
+        self.assertIs(row_filter.regex, regex)
+
+    def test_constructor_non_bytes(self):
+        regex = u"abc"
+        row_filter = self._make_one(regex)
+        self.assertEqual(row_filter.regex, b"abc")
+
+    def test___eq__type_differ(self):
+        regex = b"def-rgx"
+        row_filter1 = self._make_one(regex)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test___eq__same_value(self):
+        regex = b"trex-regex"
+        row_filter1 = self._make_one(regex)
+        row_filter2 = self._make_one(regex)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test___ne__same_value(self):
+        regex = b"abc"
+        row_filter1 = self._make_one(regex)
+        row_filter2 = self._make_one(regex)
+        comparison_val = row_filter1 != row_filter2
+        self.assertFalse(comparison_val)
+
+
+class TestRowKeyRegexFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import RowKeyRegexFilter
+
+        return RowKeyRegexFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        regex = b"row-key-regex"
+        row_filter = self._make_one(regex)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(row_key_regex_filter=regex)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestRowSampleFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        return RowSampleFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        sample = object()
+        row_filter = self._make_one(sample)
+        self.assertIs(row_filter.sample, sample)
+
+    def test___eq__type_differ(self):
+        sample = object()
+        row_filter1 = self._make_one(sample)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test___eq__same_value(self):
+        sample = object()
+        row_filter1 = self._make_one(sample)
+        row_filter2 = self._make_one(sample)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test_to_pb(self):
+        sample = 0.25
+        row_filter = self._make_one(sample)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(row_sample_filter=sample)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestFamilyNameRegexFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import FamilyNameRegexFilter
+
+        return FamilyNameRegexFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        regex = u"family-regex"
+        row_filter = self._make_one(regex)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(family_name_regex_filter=regex)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestColumnQualifierRegexFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import ColumnQualifierRegexFilter
+
+        return ColumnQualifierRegexFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        regex = b"column-regex"
+        row_filter = self._make_one(regex)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(column_qualifier_regex_filter=regex)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestTimestampRange(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import TimestampRange
+
+        return TimestampRange
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        start = object()
+        end = object()
+        time_range = self._make_one(start=start, end=end)
+        self.assertIs(time_range.start, start)
+        self.assertIs(time_range.end, end)
+
+    def test___eq__(self):
+        start = object()
+        end = object()
+        time_range1 = self._make_one(start=start, end=end)
+        time_range2 = self._make_one(start=start, end=end)
+        self.assertEqual(time_range1, time_range2)
+
+    def test___eq__type_differ(self):
+        start = object()
+        end = object()
+        time_range1 = self._make_one(start=start, end=end)
+        time_range2 = object()
+        self.assertNotEqual(time_range1, time_range2)
+
+    def test___ne__same_value(self):
+        start = object()
+        end = object()
+        time_range1 = self._make_one(start=start, end=end)
+        time_range2 = self._make_one(start=start, end=end)
+        comparison_val = time_range1 != time_range2
+        self.assertFalse(comparison_val)
+
+    def _to_pb_helper(self, pb_kwargs, start=None, end=None):
+        import datetime
+        from google.cloud._helpers import _EPOCH
+
+        if start is not None:
+            start = _EPOCH + datetime.timedelta(microseconds=start)
+        if end is not None:
+            end = _EPOCH + datetime.timedelta(microseconds=end)
+        time_range = self._make_one(start=start, end=end)
+        expected_pb = _TimestampRangePB(**pb_kwargs)
+        time_pb = time_range.to_pb()
+        self.assertEqual(
+            time_pb.start_timestamp_micros, expected_pb.start_timestamp_micros
+        )
+        self.assertEqual(time_pb.end_timestamp_micros, expected_pb.end_timestamp_micros)
+        self.assertEqual(time_pb, expected_pb)
+
+    def test_to_pb(self):
+        start_micros = 30871234
+        end_micros = 12939371234
+        start_millis = start_micros // 1000 * 1000
+        self.assertEqual(start_millis, 30871000)
+        end_millis = end_micros // 1000 * 1000 + 1000
+        self.assertEqual(end_millis, 12939372000)
+        pb_kwargs = {}
+        pb_kwargs["start_timestamp_micros"] = start_millis
+        pb_kwargs["end_timestamp_micros"] = end_millis
+        self._to_pb_helper(pb_kwargs, start=start_micros, end=end_micros)
+
+    def test_to_pb_start_only(self):
+        # Makes sure already milliseconds granularity
+        start_micros = 30871000
+        start_millis = start_micros // 1000 * 1000
+        self.assertEqual(start_millis, 30871000)
+        pb_kwargs = {}
+        pb_kwargs["start_timestamp_micros"] = start_millis
+        self._to_pb_helper(pb_kwargs, start=start_micros, end=None)
+
+    def test_to_pb_end_only(self):
+        # Makes sure already milliseconds granularity
+        end_micros = 12939371000
+        end_millis = end_micros // 1000 * 1000
+        self.assertEqual(end_millis, 12939371000)
+        pb_kwargs = {}
+        pb_kwargs["end_timestamp_micros"] = end_millis
+        self._to_pb_helper(pb_kwargs, start=None, end=end_micros)
+
+
+class TestTimestampRangeFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import TimestampRangeFilter
+
+        return TimestampRangeFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        range_ = object()
+        row_filter = self._make_one(range_)
+        self.assertIs(row_filter.range_, range_)
+
+    def test___eq__type_differ(self):
+        range_ = object()
+        row_filter1 = self._make_one(range_)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test___eq__same_value(self):
+        range_ = object()
+        row_filter1 = self._make_one(range_)
+        row_filter2 = self._make_one(range_)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test_to_pb(self):
+        from google.cloud.bigtable.row_filters import TimestampRange
+
+        range_ = TimestampRange()
+        row_filter = self._make_one(range_)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(timestamp_range_filter=_TimestampRangePB())
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestColumnRangeFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import ColumnRangeFilter
+
+        return ColumnRangeFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        column_family_id = object()
+        row_filter = self._make_one(column_family_id)
+        self.assertIs(row_filter.column_family_id, column_family_id)
+        self.assertIsNone(row_filter.start_column)
+        self.assertIsNone(row_filter.end_column)
+        self.assertTrue(row_filter.inclusive_start)
+        self.assertTrue(row_filter.inclusive_end)
+
+    def test_constructor_explicit(self):
+        column_family_id = object()
+        start_column = object()
+        end_column = object()
+        inclusive_start = object()
+        inclusive_end = object()
+        row_filter = self._make_one(
+            column_family_id,
+            start_column=start_column,
+            end_column=end_column,
+            inclusive_start=inclusive_start,
+            inclusive_end=inclusive_end,
+        )
+        self.assertIs(row_filter.column_family_id, column_family_id)
+        self.assertIs(row_filter.start_column, start_column)
+        self.assertIs(row_filter.end_column, end_column)
+        self.assertIs(row_filter.inclusive_start, inclusive_start)
+        self.assertIs(row_filter.inclusive_end, inclusive_end)
+
+    def test_constructor_bad_start(self):
+        column_family_id = object()
+        self.assertRaises(
+            ValueError, self._make_one, column_family_id, inclusive_start=True
+        )
+
+    def test_constructor_bad_end(self):
+        column_family_id = object()
+        self.assertRaises(
+            ValueError, self._make_one, column_family_id, inclusive_end=True
+        )
+
+    def test___eq__(self):
+        column_family_id = object()
+        start_column = object()
+        end_column = object()
+        inclusive_start = object()
+        inclusive_end = object()
+        row_filter1 = self._make_one(
+            column_family_id,
+            start_column=start_column,
+            end_column=end_column,
+            inclusive_start=inclusive_start,
+            inclusive_end=inclusive_end,
+        )
+        row_filter2 = self._make_one(
+            column_family_id,
+            start_column=start_column,
+            end_column=end_column,
+            inclusive_start=inclusive_start,
+            inclusive_end=inclusive_end,
+        )
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test___eq__type_differ(self):
+        column_family_id = object()
+        row_filter1 = self._make_one(column_family_id)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test_to_pb(self):
+        column_family_id = u"column-family-id"
+        row_filter = self._make_one(column_family_id)
+        col_range_pb = _ColumnRangePB(family_name=column_family_id)
+        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_inclusive_start(self):
+        column_family_id = u"column-family-id"
+        column = b"column"
+        row_filter = self._make_one(column_family_id, start_column=column)
+        col_range_pb = _ColumnRangePB(
+            family_name=column_family_id, start_qualifier_closed=column
+        )
+        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_exclusive_start(self):
+        column_family_id = u"column-family-id"
+        column = b"column"
+        row_filter = self._make_one(
+            column_family_id, start_column=column, inclusive_start=False
+        )
+        col_range_pb = _ColumnRangePB(
+            family_name=column_family_id, start_qualifier_open=column
+        )
+        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_inclusive_end(self):
+        column_family_id = u"column-family-id"
+        column = b"column"
+        row_filter = self._make_one(column_family_id, end_column=column)
+        col_range_pb = _ColumnRangePB(
+            family_name=column_family_id, end_qualifier_closed=column
+        )
+        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_exclusive_end(self):
+        column_family_id = u"column-family-id"
+        column = b"column"
+        row_filter = self._make_one(
+            column_family_id, end_column=column, inclusive_end=False
+        )
+        col_range_pb = _ColumnRangePB(
+            family_name=column_family_id, end_qualifier_open=column
+        )
+        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+
+class TestValueRegexFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import ValueRegexFilter
+
+        return ValueRegexFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        regex = b"value-regex"
+        row_filter = self._make_one(regex)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(value_regex_filter=regex)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestValueRangeFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import ValueRangeFilter
+
+        return ValueRangeFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        row_filter = self._make_one()
+        self.assertIsNone(row_filter.start_value)
+        self.assertIsNone(row_filter.end_value)
+        self.assertTrue(row_filter.inclusive_start)
+        self.assertTrue(row_filter.inclusive_end)
+
+    def test_constructor_explicit(self):
+        start_value = object()
+        end_value = object()
+        inclusive_start = object()
+        inclusive_end = object()
+        row_filter = self._make_one(
+            start_value=start_value,
+            end_value=end_value,
+            inclusive_start=inclusive_start,
+            inclusive_end=inclusive_end,
+        )
+        self.assertIs(row_filter.start_value, start_value)
+        self.assertIs(row_filter.end_value, end_value)
+        self.assertIs(row_filter.inclusive_start, inclusive_start)
+        self.assertIs(row_filter.inclusive_end, inclusive_end)
+
+    def test_constructor_bad_start(self):
+        self.assertRaises(ValueError, self._make_one, inclusive_start=True)
+
+    def test_constructor_bad_end(self):
+        self.assertRaises(ValueError, self._make_one, inclusive_end=True)
+
+    def test___eq__(self):
+        start_value = object()
+        end_value = object()
+        inclusive_start = object()
+        inclusive_end = object()
+        row_filter1 = self._make_one(
+            start_value=start_value,
+            end_value=end_value,
+            inclusive_start=inclusive_start,
+            inclusive_end=inclusive_end,
+        )
+        row_filter2 = self._make_one(
+            start_value=start_value,
+            end_value=end_value,
+            inclusive_start=inclusive_start,
+            inclusive_end=inclusive_end,
+        )
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test___eq__type_differ(self):
+        row_filter1 = self._make_one()
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test_to_pb(self):
+        row_filter = self._make_one()
+        expected_pb = _RowFilterPB(value_range_filter=_ValueRangePB())
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_inclusive_start(self):
+        value = b"some-value"
+        row_filter = self._make_one(start_value=value)
+        val_range_pb = _ValueRangePB(start_value_closed=value)
+        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_exclusive_start(self):
+        value = b"some-value"
+        row_filter = self._make_one(start_value=value, inclusive_start=False)
+        val_range_pb = _ValueRangePB(start_value_open=value)
+        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_inclusive_end(self):
+        value = b"some-value"
+        row_filter = self._make_one(end_value=value)
+        val_range_pb = _ValueRangePB(end_value_closed=value)
+        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+    def test_to_pb_exclusive_end(self):
+        value = b"some-value"
+        row_filter = self._make_one(end_value=value, inclusive_end=False)
+        val_range_pb = _ValueRangePB(end_value_open=value)
+        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
+        self.assertEqual(row_filter.to_pb(), expected_pb)
+
+
+class Test_CellCountFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import _CellCountFilter
+
+        return _CellCountFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        num_cells = object()
+        row_filter = self._make_one(num_cells)
+        self.assertIs(row_filter.num_cells, num_cells)
+
+    def test___eq__type_differ(self):
+        num_cells = object()
+        row_filter1 = self._make_one(num_cells)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test___eq__same_value(self):
+        num_cells = object()
+        row_filter1 = self._make_one(num_cells)
+        row_filter2 = self._make_one(num_cells)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test___ne__same_value(self):
+        num_cells = object()
+        row_filter1 = self._make_one(num_cells)
+        row_filter2 = self._make_one(num_cells)
+        comparison_val = row_filter1 != row_filter2
+        self.assertFalse(comparison_val)
+
+
+class TestCellsRowOffsetFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import CellsRowOffsetFilter
+
+        return CellsRowOffsetFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        num_cells = 76
+        row_filter = self._make_one(num_cells)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(cells_per_row_offset_filter=num_cells)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestCellsRowLimitFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import CellsRowLimitFilter
+
+        return CellsRowLimitFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        num_cells = 189
+        row_filter = self._make_one(num_cells)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(cells_per_row_limit_filter=num_cells)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestCellsColumnLimitFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import CellsColumnLimitFilter
+
+        return CellsColumnLimitFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        num_cells = 10
+        row_filter = self._make_one(num_cells)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(cells_per_column_limit_filter=num_cells)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestStripValueTransformerFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        return StripValueTransformerFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        flag = True
+        row_filter = self._make_one(flag)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(strip_value_transformer=flag)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class TestApplyLabelFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import ApplyLabelFilter
+
+        return ApplyLabelFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        label = object()
+        row_filter = self._make_one(label)
+        self.assertIs(row_filter.label, label)
+
+    def test___eq__type_differ(self):
+        label = object()
+        row_filter1 = self._make_one(label)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+    def test___eq__same_value(self):
+        label = object()
+        row_filter1 = self._make_one(label)
+        row_filter2 = self._make_one(label)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test_to_pb(self):
+        label = u"label"
+        row_filter = self._make_one(label)
+        pb_val = row_filter.to_pb()
+        expected_pb = _RowFilterPB(apply_label_transformer=label)
+        self.assertEqual(pb_val, expected_pb)
+
+
+class Test_FilterCombination(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import _FilterCombination
+
+        return _FilterCombination
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        row_filter = self._make_one()
+        self.assertEqual(row_filter.filters, [])
+
+    def test_constructor_explicit(self):
+        filters = object()
+        row_filter = self._make_one(filters=filters)
+        self.assertIs(row_filter.filters, filters)
+
+    def test___eq__(self):
+        filters = object()
+        row_filter1 = self._make_one(filters=filters)
+        row_filter2 = self._make_one(filters=filters)
+        self.assertEqual(row_filter1, row_filter2)
+
+    def test___eq__type_differ(self):
+        filters = object()
+        row_filter1 = self._make_one(filters=filters)
+        row_filter2 = object()
+        self.assertNotEqual(row_filter1, row_filter2)
+
+
+class TestRowFilterChain(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import RowFilterChain
+
+        return RowFilterChain
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter1_pb = row_filter1.to_pb()
+
+        row_filter2 = RowSampleFilter(0.25)
+        row_filter2_pb = row_filter2.to_pb()
+
+        row_filter3 = self._make_one(filters=[row_filter1, row_filter2])
+        filter_pb = row_filter3.to_pb()
+
+        expected_pb = _RowFilterPB(
+            chain=_RowFilterChainPB(filters=[row_filter1_pb, row_filter2_pb])
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_to_pb_nested(self):
+        from google.cloud.bigtable.row_filters import CellsRowLimitFilter
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter2 = RowSampleFilter(0.25)
+
+        row_filter3 = self._make_one(filters=[row_filter1, row_filter2])
+        row_filter3_pb = row_filter3.to_pb()
+
+        row_filter4 = CellsRowLimitFilter(11)
+        row_filter4_pb = row_filter4.to_pb()
+
+        row_filter5 = self._make_one(filters=[row_filter3, row_filter4])
+        filter_pb = row_filter5.to_pb()
+
+        expected_pb = _RowFilterPB(
+            chain=_RowFilterChainPB(filters=[row_filter3_pb, row_filter4_pb])
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+
+class TestRowFilterUnion(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import RowFilterUnion
+
+        return RowFilterUnion
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_to_pb(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter1_pb = row_filter1.to_pb()
+
+        row_filter2 = RowSampleFilter(0.25)
+        row_filter2_pb = row_filter2.to_pb()
+
+        row_filter3 = self._make_one(filters=[row_filter1, row_filter2])
+        filter_pb = row_filter3.to_pb()
+
+        expected_pb = _RowFilterPB(
+            interleave=_RowFilterInterleavePB(filters=[row_filter1_pb, row_filter2_pb])
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_to_pb_nested(self):
+        from google.cloud.bigtable.row_filters import CellsRowLimitFilter
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter2 = RowSampleFilter(0.25)
+
+        row_filter3 = self._make_one(filters=[row_filter1, row_filter2])
+        row_filter3_pb = row_filter3.to_pb()
+
+        row_filter4 = CellsRowLimitFilter(11)
+        row_filter4_pb = row_filter4.to_pb()
+
+        row_filter5 = self._make_one(filters=[row_filter3, row_filter4])
+        filter_pb = row_filter5.to_pb()
+
+        expected_pb = _RowFilterPB(
+            interleave=_RowFilterInterleavePB(filters=[row_filter3_pb, row_filter4_pb])
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+
+class TestConditionalRowFilter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_filters import ConditionalRowFilter
+
+        return ConditionalRowFilter
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        base_filter = object()
+        true_filter = object()
+        false_filter = object()
+        cond_filter = self._make_one(
+            base_filter, true_filter=true_filter, false_filter=false_filter
+        )
+        self.assertIs(cond_filter.base_filter, base_filter)
+        self.assertIs(cond_filter.true_filter, true_filter)
+        self.assertIs(cond_filter.false_filter, false_filter)
+
+    def test___eq__(self):
+        base_filter = object()
+        true_filter = object()
+        false_filter = object()
+        cond_filter1 = self._make_one(
+            base_filter, true_filter=true_filter, false_filter=false_filter
+        )
+        cond_filter2 = self._make_one(
+            base_filter, true_filter=true_filter, false_filter=false_filter
+        )
+        self.assertEqual(cond_filter1, cond_filter2)
+
+    def test___eq__type_differ(self):
+        base_filter = object()
+        true_filter = object()
+        false_filter = object()
+        cond_filter1 = self._make_one(
+            base_filter, true_filter=true_filter, false_filter=false_filter
+        )
+        cond_filter2 = object()
+        self.assertNotEqual(cond_filter1, cond_filter2)
+
+    def test_to_pb(self):
+        from google.cloud.bigtable.row_filters import CellsRowOffsetFilter
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter1_pb = row_filter1.to_pb()
+
+        row_filter2 = RowSampleFilter(0.25)
+        row_filter2_pb = row_filter2.to_pb()
+
+        row_filter3 = CellsRowOffsetFilter(11)
+        row_filter3_pb = row_filter3.to_pb()
+
+        row_filter4 = self._make_one(
+            row_filter1, true_filter=row_filter2, false_filter=row_filter3
+        )
+        filter_pb = row_filter4.to_pb()
+
+        expected_pb = _RowFilterPB(
+            condition=_RowFilterConditionPB(
+                predicate_filter=row_filter1_pb,
+                true_filter=row_filter2_pb,
+                false_filter=row_filter3_pb,
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_to_pb_true_only(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter1_pb = row_filter1.to_pb()
+
+        row_filter2 = RowSampleFilter(0.25)
+        row_filter2_pb = row_filter2.to_pb()
+
+        row_filter3 = self._make_one(row_filter1, true_filter=row_filter2)
+        filter_pb = row_filter3.to_pb()
+
+        expected_pb = _RowFilterPB(
+            condition=_RowFilterConditionPB(
+                predicate_filter=row_filter1_pb, true_filter=row_filter2_pb
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_to_pb_false_only(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+        from google.cloud.bigtable.row_filters import StripValueTransformerFilter
+
+        row_filter1 = StripValueTransformerFilter(True)
+        row_filter1_pb = row_filter1.to_pb()
+
+        row_filter2 = RowSampleFilter(0.25)
+        row_filter2_pb = row_filter2.to_pb()
+
+        row_filter3 = self._make_one(row_filter1, false_filter=row_filter2)
+        filter_pb = row_filter3.to_pb()
+
+        expected_pb = _RowFilterPB(
+            condition=_RowFilterConditionPB(
+                predicate_filter=row_filter1_pb, false_filter=row_filter2_pb
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+
+def _ColumnRangePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.ColumnRange(*args, **kw)
+
+
+def _RowFilterPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.RowFilter(*args, **kw)
+
+
+def _RowFilterChainPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.RowFilter.Chain(*args, **kw)
+
+
+def _RowFilterConditionPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.RowFilter.Condition(*args, **kw)
+
+
+def _RowFilterInterleavePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.RowFilter.Interleave(*args, **kw)
+
+
+def _TimestampRangePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.TimestampRange(*args, **kw)
+
+
+def _ValueRangePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import data_pb2 as data_v2_pb2
+
+    return data_v2_pb2.ValueRange(*args, **kw)
diff --git a/bigtable/tests/unit/test_row_set.py b/bigtable/tests/unit/test_row_set.py
new file mode 100644
index 000000000000..c66341b84ec6
--- /dev/null
+++ b/bigtable/tests/unit/test_row_set.py
@@ -0,0 +1,270 @@
+# 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.
+
+
+import unittest
+from google.cloud.bigtable.row_set import RowRange
+from google.cloud._helpers import _to_bytes
+
+
+class TestRowSet(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_set import RowSet
+
+        return RowSet
+
+    def _make_one(self):
+        return self._get_target_class()()
+
+    def test_constructor(self):
+        row_set = self._make_one()
+        self.assertEqual([], row_set.row_keys)
+        self.assertEqual([], row_set.row_ranges)
+
+    def test__eq__(self):
+        row_key1 = b"row_key1"
+        row_key2 = b"row_key1"
+        row_range1 = RowRange(b"row_key4", b"row_key9")
+        row_range2 = RowRange(b"row_key4", b"row_key9")
+
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_key(row_key1)
+        row_set2.add_row_key(row_key2)
+        row_set1.add_row_range(row_range1)
+        row_set2.add_row_range(row_range2)
+
+        self.assertEqual(row_set1, row_set2)
+
+    def test__eq__type_differ(self):
+        row_set1 = self._make_one()
+        row_set2 = object()
+        self.assertNotEqual(row_set1, row_set2)
+
+    def test__eq__len_row_keys_differ(self):
+        row_key1 = b"row_key1"
+        row_key2 = b"row_key1"
+
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_key(row_key1)
+        row_set1.add_row_key(row_key2)
+        row_set2.add_row_key(row_key2)
+
+        self.assertNotEqual(row_set1, row_set2)
+
+    def test__eq__len_row_ranges_differ(self):
+        row_range1 = RowRange(b"row_key4", b"row_key9")
+        row_range2 = RowRange(b"row_key4", b"row_key9")
+
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_range(row_range1)
+        row_set1.add_row_range(row_range2)
+        row_set2.add_row_range(row_range2)
+
+        self.assertNotEqual(row_set1, row_set2)
+
+    def test__eq__row_keys_differ(self):
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_key(b"row_key1")
+        row_set1.add_row_key(b"row_key2")
+        row_set1.add_row_key(b"row_key3")
+        row_set2.add_row_key(b"row_key1")
+        row_set2.add_row_key(b"row_key2")
+        row_set2.add_row_key(b"row_key4")
+
+        self.assertNotEqual(row_set1, row_set2)
+
+    def test__eq__row_ranges_differ(self):
+        row_range1 = RowRange(b"row_key4", b"row_key9")
+        row_range2 = RowRange(b"row_key14", b"row_key19")
+        row_range3 = RowRange(b"row_key24", b"row_key29")
+
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_range(row_range1)
+        row_set1.add_row_range(row_range2)
+        row_set1.add_row_range(row_range3)
+        row_set2.add_row_range(row_range1)
+        row_set2.add_row_range(row_range2)
+
+        self.assertNotEqual(row_set1, row_set2)
+
+    def test__ne__(self):
+        row_key1 = b"row_key1"
+        row_key2 = b"row_key1"
+        row_range1 = RowRange(b"row_key4", b"row_key9")
+        row_range2 = RowRange(b"row_key5", b"row_key9")
+
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_key(row_key1)
+        row_set2.add_row_key(row_key2)
+        row_set1.add_row_range(row_range1)
+        row_set2.add_row_range(row_range2)
+
+        self.assertNotEqual(row_set1, row_set2)
+
+    def test__ne__same_value(self):
+        row_key1 = b"row_key1"
+        row_key2 = b"row_key1"
+        row_range1 = RowRange(b"row_key4", b"row_key9")
+        row_range2 = RowRange(b"row_key4", b"row_key9")
+
+        row_set1 = self._make_one()
+        row_set2 = self._make_one()
+
+        row_set1.add_row_key(row_key1)
+        row_set2.add_row_key(row_key2)
+        row_set1.add_row_range(row_range1)
+        row_set2.add_row_range(row_range2)
+
+        comparison_val = row_set1 != row_set2
+        self.assertFalse(comparison_val)
+
+    def test_add_row_key(self):
+        row_set = self._make_one()
+        row_set.add_row_key("row_key1")
+        row_set.add_row_key("row_key2")
+        self.assertEqual(["row_key1", "row_key2"], row_set.row_keys)
+
+    def test_add_row_range(self):
+        row_set = self._make_one()
+        row_range1 = RowRange(b"row_key1", b"row_key9")
+        row_range2 = RowRange(b"row_key21", b"row_key29")
+        row_set.add_row_range(row_range1)
+        row_set.add_row_range(row_range2)
+        expected = [row_range1, row_range2]
+        self.assertEqual(expected, row_set.row_ranges)
+
+    def test_add_row_range_from_keys(self):
+        row_set = self._make_one()
+        row_set.add_row_range_from_keys(
+            start_key=b"row_key1",
+            end_key=b"row_key9",
+            start_inclusive=False,
+            end_inclusive=True,
+        )
+        self.assertEqual(row_set.row_ranges[0].end_key, b"row_key9")
+
+    def test__update_message_request(self):
+        row_set = self._make_one()
+        table_name = "table_name"
+        row_set.add_row_key("row_key1")
+        row_range1 = RowRange(b"row_key21", b"row_key29")
+        row_set.add_row_range(row_range1)
+
+        request = _ReadRowsRequestPB(table_name=table_name)
+        row_set._update_message_request(request)
+
+        expected_request = _ReadRowsRequestPB(table_name=table_name)
+        expected_request.rows.row_keys.append(_to_bytes("row_key1"))
+
+        expected_request.rows.row_ranges.add(**row_range1.get_range_kwargs())
+
+        self.assertEqual(request, expected_request)
+
+
+class TestRowRange(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.row_set import RowRange
+
+        return RowRange
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        start_key = "row_key1"
+        end_key = "row_key9"
+        row_range = self._make_one(start_key, end_key)
+        self.assertEqual(start_key, row_range.start_key)
+        self.assertEqual(end_key, row_range.end_key)
+        self.assertTrue(row_range.start_inclusive)
+        self.assertFalse(row_range.end_inclusive)
+
+    def test___hash__set_equality(self):
+        row_range1 = self._make_one("row_key1", "row_key9")
+        row_range2 = self._make_one("row_key1", "row_key9")
+        set_one = {row_range1, row_range2}
+        set_two = {row_range1, row_range2}
+        self.assertEqual(set_one, set_two)
+
+    def test___hash__not_equals(self):
+        row_range1 = self._make_one("row_key1", "row_key9")
+        row_range2 = self._make_one("row_key1", "row_key19")
+        set_one = {row_range1}
+        set_two = {row_range2}
+        self.assertNotEqual(set_one, set_two)
+
+    def test__eq__(self):
+        start_key = b"row_key1"
+        end_key = b"row_key9"
+        row_range1 = self._make_one(start_key, end_key, True, False)
+        row_range2 = self._make_one(start_key, end_key, True, False)
+        self.assertEqual(row_range1, row_range2)
+
+    def test___eq__type_differ(self):
+        start_key = b"row_key1"
+        end_key = b"row_key9"
+        row_range1 = self._make_one(start_key, end_key, True, False)
+        row_range2 = object()
+        self.assertNotEqual(row_range1, row_range2)
+
+    def test__ne__(self):
+        start_key = b"row_key1"
+        end_key = b"row_key9"
+        row_range1 = self._make_one(start_key, end_key, True, False)
+        row_range2 = self._make_one(start_key, end_key, False, True)
+        self.assertNotEqual(row_range1, row_range2)
+
+    def test__ne__same_value(self):
+        start_key = b"row_key1"
+        end_key = b"row_key9"
+        row_range1 = self._make_one(start_key, end_key, True, False)
+        row_range2 = self._make_one(start_key, end_key, True, False)
+        comparison_val = row_range1 != row_range2
+        self.assertFalse(comparison_val)
+
+    def test_get_range_kwargs_closed_open(self):
+        start_key = b"row_key1"
+        end_key = b"row_key9"
+        expected_result = {"start_key_closed": start_key, "end_key_open": end_key}
+        row_range = self._make_one(start_key, end_key)
+        actual_result = row_range.get_range_kwargs()
+        self.assertEqual(expected_result, actual_result)
+
+    def test_get_range_kwargs_open_closed(self):
+        start_key = b"row_key1"
+        end_key = b"row_key9"
+        expected_result = {"start_key_open": start_key, "end_key_closed": end_key}
+        row_range = self._make_one(start_key, end_key, False, True)
+        actual_result = row_range.get_range_kwargs()
+        self.assertEqual(expected_result, actual_result)
+
+
+def _ReadRowsRequestPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    return messages_v2_pb2.ReadRowsRequest(*args, **kw)
diff --git a/bigtable/tests/unit/test_table.py b/bigtable/tests/unit/test_table.py
new file mode 100644
index 000000000000..495d8660d1f7
--- /dev/null
+++ b/bigtable/tests/unit/test_table.py
@@ -0,0 +1,1832 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+import mock
+from ._testing import _make_credentials
+from google.api_core.exceptions import DeadlineExceeded
+
+
+class Test___mutate_rows_request(unittest.TestCase):
+    def _call_fut(self, table_name, rows):
+        from google.cloud.bigtable.table import _mutate_rows_request
+
+        return _mutate_rows_request(table_name, rows)
+
+    @mock.patch("google.cloud.bigtable.table._MAX_BULK_MUTATIONS", new=3)
+    def test__mutate_rows_too_many_mutations(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable.table import TooManyMutationsError
+
+        table = mock.Mock(name="table", spec=["name"])
+        table.name = "table"
+        rows = [
+            DirectRow(row_key=b"row_key", table=table),
+            DirectRow(row_key=b"row_key_2", table=table),
+        ]
+        rows[0].set_cell("cf1", b"c1", 1)
+        rows[0].set_cell("cf1", b"c1", 2)
+        rows[1].set_cell("cf1", b"c1", 3)
+        rows[1].set_cell("cf1", b"c1", 4)
+        with self.assertRaises(TooManyMutationsError):
+            self._call_fut("table", rows)
+
+    def test__mutate_rows_request(self):
+        from google.cloud.bigtable.row import DirectRow
+
+        table = mock.Mock(name="table", spec=["name"])
+        table.name = "table"
+        rows = [
+            DirectRow(row_key=b"row_key", table=table),
+            DirectRow(row_key=b"row_key_2"),
+        ]
+        rows[0].set_cell("cf1", b"c1", b"1")
+        rows[1].set_cell("cf1", b"c1", b"2")
+        result = self._call_fut("table", rows)
+
+        expected_result = _mutate_rows_request_pb(table_name="table")
+        entry1 = expected_result.entries.add()
+        entry1.row_key = b"row_key"
+        mutations1 = entry1.mutations.add()
+        mutations1.set_cell.family_name = "cf1"
+        mutations1.set_cell.column_qualifier = b"c1"
+        mutations1.set_cell.timestamp_micros = -1
+        mutations1.set_cell.value = b"1"
+        entry2 = expected_result.entries.add()
+        entry2.row_key = b"row_key_2"
+        mutations2 = entry2.mutations.add()
+        mutations2.set_cell.family_name = "cf1"
+        mutations2.set_cell.column_qualifier = b"c1"
+        mutations2.set_cell.timestamp_micros = -1
+        mutations2.set_cell.value = b"2"
+
+        self.assertEqual(result, expected_result)
+
+
+class Test__check_row_table_name(unittest.TestCase):
+    def _call_fut(self, table_name, row):
+        from google.cloud.bigtable.table import _check_row_table_name
+
+        return _check_row_table_name(table_name, row)
+
+    def test_wrong_table_name(self):
+        from google.cloud.bigtable.table import TableMismatchError
+        from google.cloud.bigtable.row import DirectRow
+
+        table = mock.Mock(name="table", spec=["name"])
+        table.name = "table"
+        row = DirectRow(row_key=b"row_key", table=table)
+        with self.assertRaises(TableMismatchError):
+            self._call_fut("other_table", row)
+
+    def test_right_table_name(self):
+        from google.cloud.bigtable.row import DirectRow
+
+        table = mock.Mock(name="table", spec=["name"])
+        table.name = "table"
+        row = DirectRow(row_key=b"row_key", table=table)
+        result = self._call_fut("table", row)
+        self.assertFalse(result)
+
+
+class Test__check_row_type(unittest.TestCase):
+    def _call_fut(self, row):
+        from google.cloud.bigtable.table import _check_row_type
+
+        return _check_row_type(row)
+
+    def test_test_wrong_row_type(self):
+        from google.cloud.bigtable.row import ConditionalRow
+
+        row = ConditionalRow(row_key=b"row_key", table="table", filter_=None)
+        with self.assertRaises(TypeError):
+            self._call_fut(row)
+
+    def test_right_row_type(self):
+        from google.cloud.bigtable.row import DirectRow
+
+        row = DirectRow(row_key=b"row_key", table="table")
+        result = self._call_fut(row)
+        self.assertFalse(result)
+
+
+class TestTable(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    TABLE_ID = "table-id"
+    TABLE_NAME = INSTANCE_NAME + "/tables/" + TABLE_ID
+    ROW_KEY = b"row-key"
+    ROW_KEY_1 = b"row-key-1"
+    ROW_KEY_2 = b"row-key-2"
+    ROW_KEY_3 = b"row-key-3"
+    FAMILY_NAME = u"family"
+    QUALIFIER = b"qualifier"
+    TIMESTAMP_MICROS = 100
+    VALUE = b"value"
+    _json_tests = None
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.bigtable.table import Table
+
+        return Table
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def test_constructor_w_admin(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT_ID, credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+        self.assertEqual(table.table_id, self.TABLE_ID)
+        self.assertIs(table._instance._client, client)
+        self.assertEqual(table.name, self.TABLE_NAME)
+
+    def test_constructor_wo_admin(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project=self.PROJECT_ID, credentials=credentials, admin=False
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+        self.assertEqual(table.table_id, self.TABLE_ID)
+        self.assertIs(table._instance._client, client)
+        self.assertEqual(table.name, self.TABLE_NAME)
+
+    def _row_methods_helper(self):
+        client = self._make_client(
+            project="project-id", credentials=_make_credentials(), admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+        row_key = b"row_key"
+        return table, row_key
+
+    def test_row_factory_direct(self):
+        from google.cloud.bigtable.row import DirectRow
+
+        table, row_key = self._row_methods_helper()
+        row = table.row(row_key)
+
+        self.assertIsInstance(row, DirectRow)
+        self.assertEqual(row._row_key, row_key)
+        self.assertEqual(row._table, table)
+
+    def test_row_factory_conditional(self):
+        from google.cloud.bigtable.row import ConditionalRow
+
+        table, row_key = self._row_methods_helper()
+        filter_ = object()
+        row = table.row(row_key, filter_=filter_)
+
+        self.assertIsInstance(row, ConditionalRow)
+        self.assertEqual(row._row_key, row_key)
+        self.assertEqual(row._table, table)
+
+    def test_row_factory_append(self):
+        from google.cloud.bigtable.row import AppendRow
+
+        table, row_key = self._row_methods_helper()
+        row = table.row(row_key, append=True)
+
+        self.assertIsInstance(row, AppendRow)
+        self.assertEqual(row._row_key, row_key)
+        self.assertEqual(row._table, table)
+
+    def test_direct_row(self):
+        from google.cloud.bigtable.row import DirectRow
+
+        table, row_key = self._row_methods_helper()
+        row = table.direct_row(row_key)
+
+        self.assertIsInstance(row, DirectRow)
+        self.assertEqual(row._row_key, row_key)
+        self.assertEqual(row._table, table)
+
+    def test_conditional_row(self):
+        from google.cloud.bigtable.row import ConditionalRow
+
+        table, row_key = self._row_methods_helper()
+        filter_ = object()
+        row = table.conditional_row(row_key, filter_=filter_)
+
+        self.assertIsInstance(row, ConditionalRow)
+        self.assertEqual(row._row_key, row_key)
+        self.assertEqual(row._table, table)
+
+    def test_append_row(self):
+        from google.cloud.bigtable.row import AppendRow
+
+        table, row_key = self._row_methods_helper()
+        row = table.append_row(row_key)
+
+        self.assertIsInstance(row, AppendRow)
+        self.assertEqual(row._row_key, row_key)
+        self.assertEqual(row._table, table)
+
+    def test_row_factory_failure(self):
+        table, row_key = self._row_methods_helper()
+        with self.assertRaises(ValueError):
+            table.row(row_key, filter_=object(), append=True)
+
+    def test___eq__(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table1 = self._make_one(self.TABLE_ID, instance)
+        table2 = self._make_one(self.TABLE_ID, instance)
+        self.assertEqual(table1, table2)
+
+    def test___eq__type_differ(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table1 = self._make_one(self.TABLE_ID, instance)
+        table2 = object()
+        self.assertNotEqual(table1, table2)
+
+    def test___ne__same_value(self):
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table1 = self._make_one(self.TABLE_ID, instance)
+        table2 = self._make_one(self.TABLE_ID, instance)
+        comparison_val = table1 != table2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        table1 = self._make_one("table_id1", None)
+        table2 = self._make_one("table_id2", None)
+        self.assertNotEqual(table1, table2)
+
+    def _create_test_helper(self, split_keys=[], column_families={}):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+        from google.cloud.bigtable_admin_v2.proto import table_pb2
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_table_admin_pb2 as table_admin_messages_v2_pb2,
+        )
+        from google.cloud.bigtable.column_family import ColumnFamily
+
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        # Patch API calls
+        client._table_admin_client = table_api
+
+        # Perform the method and check the result.
+        table.create(column_families=column_families, initial_split_keys=split_keys)
+
+        families = {
+            id: ColumnFamily(id, self, rule).to_pb()
+            for (id, rule) in column_families.items()
+        }
+
+        split = table_admin_messages_v2_pb2.CreateTableRequest.Split
+        splits = [split(key=split_key) for split_key in split_keys]
+
+        table_api.create_table.assert_called_once_with(
+            parent=self.INSTANCE_NAME,
+            table=table_pb2.Table(column_families=families),
+            table_id=self.TABLE_ID,
+            initial_splits=splits,
+        )
+
+    def test_create(self):
+        self._create_test_helper()
+
+    def test_create_with_families(self):
+        from google.cloud.bigtable.column_family import MaxVersionsGCRule
+
+        families = {"family": MaxVersionsGCRule(5)}
+        self._create_test_helper(column_families=families)
+
+    def test_create_with_split_keys(self):
+        self._create_test_helper(split_keys=[b"split1", b"split2", b"split3"])
+
+    def test_exists(self):
+        from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_data_v2_pb2
+        from google.cloud.bigtable_admin_v2.proto import (
+            bigtable_table_admin_pb2 as table_messages_v1_pb2,
+        )
+        from google.cloud.bigtable_admin_v2.gapic import (
+            bigtable_instance_admin_client,
+            bigtable_table_admin_client,
+        )
+        from google.api_core.exceptions import NotFound
+        from google.api_core.exceptions import BadRequest
+
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        instance_api = bigtable_instance_admin_client.BigtableInstanceAdminClient(
+            mock.Mock()
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        # Create response_pb
+        response_pb = table_messages_v1_pb2.ListTablesResponse(
+            tables=[table_data_v2_pb2.Table(name=self.TABLE_NAME)]
+        )
+
+        # Patch API calls
+        client._table_admin_client = table_api
+        client._instance_admin_client = instance_api
+        bigtable_table_stub = client._table_admin_client.transport
+        bigtable_table_stub.get_table.side_effect = [
+            response_pb,
+            NotFound("testing"),
+            BadRequest("testing"),
+        ]
+
+        # Perform the method and check the result.
+        table1 = instance.table(self.TABLE_ID)
+        table2 = instance.table("table-id2")
+
+        result = table1.exists()
+        self.assertEqual(True, result)
+
+        result = table2.exists()
+        self.assertEqual(False, result)
+
+        with self.assertRaises(BadRequest):
+            table2.exists()
+
+    def test_delete(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        # Patch API calls
+        client._table_admin_client = table_api
+
+        # Create expected_result.
+        expected_result = None  # delete() has no return value.
+
+        # Perform the method and check the result.
+        result = table.delete()
+        self.assertEqual(result, expected_result)
+
+    def _list_column_families_helper(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        # Create response_pb
+        COLUMN_FAMILY_ID = "foo"
+        column_family = _ColumnFamilyPB()
+        response_pb = _TablePB(column_families={COLUMN_FAMILY_ID: column_family})
+
+        # Patch the stub used by the API method.
+        client._table_admin_client = table_api
+        bigtable_table_stub = client._table_admin_client.transport
+        bigtable_table_stub.get_table.side_effect = [response_pb]
+
+        # Create expected_result.
+        expected_result = {COLUMN_FAMILY_ID: table.column_family(COLUMN_FAMILY_ID)}
+
+        # Perform the method and check the result.
+        result = table.list_column_families()
+        self.assertEqual(result, expected_result)
+
+    def test_list_column_families(self):
+        self._list_column_families_helper()
+
+    def test_get_cluster_states(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+        from google.cloud.bigtable.enums import Table as enum_table
+        from google.cloud.bigtable.table import ClusterState
+
+        INITIALIZING = enum_table.ReplicationState.INITIALIZING
+        PLANNED_MAINTENANCE = enum_table.ReplicationState.PLANNED_MAINTENANCE
+        READY = enum_table.ReplicationState.READY
+
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        response_pb = _TablePB(
+            cluster_states={
+                "cluster-id1": _ClusterStatePB(INITIALIZING),
+                "cluster-id2": _ClusterStatePB(PLANNED_MAINTENANCE),
+                "cluster-id3": _ClusterStatePB(READY),
+            }
+        )
+
+        # Patch the stub used by the API method.
+        client._table_admin_client = table_api
+        bigtable_table_stub = client._table_admin_client.transport
+        bigtable_table_stub.get_table.side_effect = [response_pb]
+
+        # build expected result
+        expected_result = {
+            u"cluster-id1": ClusterState(INITIALIZING),
+            u"cluster-id2": ClusterState(PLANNED_MAINTENANCE),
+            u"cluster-id3": ClusterState(READY),
+        }
+
+        # Perform the method and check the result.
+        result = table.get_cluster_states()
+        self.assertEqual(result, expected_result)
+
+    def _read_row_helper(self, chunks, expected_result, app_profile_id=None):
+
+        from google.cloud._testing import _Monkey
+        from google.cloud.bigtable import table as MUT
+        from google.cloud.bigtable.row_set import RowSet
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance, app_profile_id=app_profile_id)
+
+        # Create request_pb
+        request_pb = object()  # Returned by our mock.
+        mock_created = []
+
+        def mock_create_row_request(table_name, **kwargs):
+            mock_created.append((table_name, kwargs))
+            return request_pb
+
+        # Create response_iterator
+        if chunks is None:
+            response_iterator = iter(())  # no responses at all
+        else:
+            response_pb = _ReadRowsResponsePB(chunks=chunks)
+            response_iterator = iter([response_pb])
+
+        # Patch the stub used by the API method.
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        client._table_data_client.transport.read_rows = mock.Mock(
+            side_effect=[response_iterator]
+        )
+
+        # Perform the method and check the result.
+        filter_obj = RowSampleFilter(0.33)
+        result = None
+        with _Monkey(MUT, _create_row_request=mock_create_row_request):
+            result = table.read_row(self.ROW_KEY, filter_=filter_obj)
+        row_set = RowSet()
+        row_set.add_row_key(self.ROW_KEY)
+        expected_request = [
+            (
+                table.name,
+                {
+                    "end_inclusive": False,
+                    "row_set": row_set,
+                    "app_profile_id": app_profile_id,
+                    "end_key": None,
+                    "limit": None,
+                    "start_key": None,
+                    "filter_": filter_obj,
+                },
+            )
+        ]
+        self.assertEqual(result, expected_result)
+        self.assertEqual(mock_created, expected_request)
+
+    def test_read_row_miss_no__responses(self):
+        self._read_row_helper(None, None)
+
+    def test_read_row_miss_no_chunks_in_response(self):
+        chunks = []
+        self._read_row_helper(chunks, None)
+
+    def test_read_row_complete(self):
+        from google.cloud.bigtable.row_data import Cell
+        from google.cloud.bigtable.row_data import PartialRowData
+
+        app_profile_id = "app-profile-id"
+        chunk = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+        chunks = [chunk]
+        expected_result = PartialRowData(row_key=self.ROW_KEY)
+        family = expected_result._cells.setdefault(self.FAMILY_NAME, {})
+        column = family.setdefault(self.QUALIFIER, [])
+        column.append(Cell.from_pb(chunk))
+        self._read_row_helper(chunks, expected_result, app_profile_id)
+
+    def test_read_row_more_than_one_row_returned(self):
+        app_profile_id = "app-profile-id"
+        chunk_1 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+        chunk_2 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_2,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        chunks = [chunk_1, chunk_2]
+        with self.assertRaises(ValueError):
+            self._read_row_helper(chunks, None, app_profile_id)
+
+    def test_read_row_still_partial(self):
+        chunk = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+        )
+        # No "commit row".
+        chunks = [chunk]
+        with self.assertRaises(ValueError):
+            self._read_row_helper(chunks, None)
+
+    def test_mutate_rows(self):
+        from google.rpc.status_pb2 import Status
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        client._table_admin_client = table_api
+        table = self._make_one(self.TABLE_ID, instance)
+
+        response = [Status(code=0), Status(code=1)]
+
+        mock_worker = mock.Mock(return_value=response)
+        with mock.patch(
+            "google.cloud.bigtable.table._RetryableMutateRowsWorker",
+            new=mock.MagicMock(return_value=mock_worker),
+        ):
+            statuses = table.mutate_rows([mock.MagicMock(), mock.MagicMock()])
+        result = [status.code for status in statuses]
+        expected_result = [0, 1]
+
+        self.assertEqual(result, expected_result)
+
+    def test_read_rows(self):
+        from google.cloud._testing import _Monkey
+        from google.cloud.bigtable.row_data import PartialRowsData
+        from google.cloud.bigtable import table as MUT
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        app_profile_id = "app-profile-id"
+        table = self._make_one(self.TABLE_ID, instance, app_profile_id=app_profile_id)
+
+        # Create request_pb
+        request = retry = object()  # Returned by our mock.
+        mock_created = []
+
+        def mock_create_row_request(table_name, **kwargs):
+            mock_created.append((table_name, kwargs))
+            return request
+
+        # Create expected_result.
+        expected_result = PartialRowsData(
+            client._table_data_client.transport.read_rows, request, retry
+        )
+
+        # Perform the method and check the result.
+        start_key = b"start-key"
+        end_key = b"end-key"
+        filter_obj = object()
+        limit = 22
+        with _Monkey(MUT, _create_row_request=mock_create_row_request):
+            result = table.read_rows(
+                start_key=start_key,
+                end_key=end_key,
+                filter_=filter_obj,
+                limit=limit,
+                retry=retry,
+            )
+
+        self.assertEqual(result.rows, expected_result.rows)
+        self.assertEqual(result.retry, expected_result.retry)
+        created_kwargs = {
+            "start_key": start_key,
+            "end_key": end_key,
+            "filter_": filter_obj,
+            "limit": limit,
+            "end_inclusive": False,
+            "app_profile_id": app_profile_id,
+            "row_set": None,
+        }
+        self.assertEqual(mock_created, [(table.name, created_kwargs)])
+
+    def test_read_retry_rows(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+        from google.api_core import retry
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        retry_read_rows = retry.Retry(predicate=_read_rows_retry_exception)
+
+        # Create response_iterator
+        chunk_1 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_1,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        chunk_2 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_2,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        response_1 = _ReadRowsResponseV2([chunk_1])
+        response_2 = _ReadRowsResponseV2([chunk_2])
+        response_failure_iterator_1 = _MockFailureIterator_1()
+        response_failure_iterator_2 = _MockFailureIterator_2([response_1])
+        response_iterator = _MockReadRowsIterator(response_2)
+
+        # Patch the stub used by the API method.
+        client._table_data_client.transport.read_rows = mock.Mock(
+            side_effect=[
+                response_failure_iterator_1,
+                response_failure_iterator_2,
+                response_iterator,
+            ]
+        )
+
+        rows = []
+        for row in table.read_rows(
+            start_key=self.ROW_KEY_1, end_key=self.ROW_KEY_2, retry=retry_read_rows
+        ):
+            rows.append(row)
+
+        result = rows[1]
+        self.assertEqual(result.row_key, self.ROW_KEY_2)
+
+    def test_yield_retry_rows(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+        import warnings
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        # Create response_iterator
+        chunk_1 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_1,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        chunk_2 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_2,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        response_1 = _ReadRowsResponseV2([chunk_1])
+        response_2 = _ReadRowsResponseV2([chunk_2])
+        response_failure_iterator_1 = _MockFailureIterator_1()
+        response_failure_iterator_2 = _MockFailureIterator_2([response_1])
+        response_iterator = _MockReadRowsIterator(response_2)
+
+        # Patch the stub used by the API method.
+        client._table_data_client.transport.read_rows = mock.Mock(
+            side_effect=[
+                response_failure_iterator_1,
+                response_failure_iterator_2,
+                response_iterator,
+            ]
+        )
+
+        rows = []
+        with warnings.catch_warnings(record=True) as warned:
+            for row in table.yield_rows(
+                start_key=self.ROW_KEY_1, end_key=self.ROW_KEY_2
+            ):
+                rows.append(row)
+
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+        result = rows[1]
+        self.assertEqual(result.row_key, self.ROW_KEY_2)
+
+    def test_yield_rows_with_row_set(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+        from google.cloud.bigtable.row_set import RowSet
+        from google.cloud.bigtable.row_set import RowRange
+        import warnings
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        # Create response_iterator
+        chunk_1 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_1,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        chunk_2 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_2,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        chunk_3 = _ReadRowsResponseCellChunkPB(
+            row_key=self.ROW_KEY_3,
+            family_name=self.FAMILY_NAME,
+            qualifier=self.QUALIFIER,
+            timestamp_micros=self.TIMESTAMP_MICROS,
+            value=self.VALUE,
+            commit_row=True,
+        )
+
+        response_1 = _ReadRowsResponseV2([chunk_1])
+        response_2 = _ReadRowsResponseV2([chunk_2])
+        response_3 = _ReadRowsResponseV2([chunk_3])
+        response_iterator = _MockReadRowsIterator(response_1, response_2, response_3)
+
+        # Patch the stub used by the API method.
+        client._table_data_client.transport.read_rows = mock.Mock(
+            side_effect=[response_iterator]
+        )
+
+        rows = []
+        row_set = RowSet()
+        row_set.add_row_range(
+            RowRange(start_key=self.ROW_KEY_1, end_key=self.ROW_KEY_2)
+        )
+        row_set.add_row_key(self.ROW_KEY_3)
+
+        with warnings.catch_warnings(record=True) as warned:
+            for row in table.yield_rows(row_set=row_set):
+                rows.append(row)
+
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+        self.assertEqual(rows[0].row_key, self.ROW_KEY_1)
+        self.assertEqual(rows[1].row_key, self.ROW_KEY_2)
+        self.assertEqual(rows[2].row_key, self.ROW_KEY_3)
+
+    def test_sample_row_keys(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        # Create response_iterator
+        response_iterator = object()  # Just passed to a mock.
+
+        # Patch the stub used by the API method.
+        inner_api_calls = client._table_data_client._inner_api_calls
+        inner_api_calls["sample_row_keys"] = mock.Mock(
+            side_effect=[[response_iterator]]
+        )
+
+        # Create expected_result.
+        expected_result = response_iterator
+
+        # Perform the method and check the result.
+        result = table.sample_row_keys()
+        self.assertEqual(result[0], expected_result)
+
+    def test_truncate(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = mock.create_autospec(bigtable_client.BigtableClient)
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        expected_result = None  # truncate() has no return value.
+        with mock.patch("google.cloud.bigtable.table.Table.name", new=self.TABLE_NAME):
+            result = table.truncate()
+
+        table_api.drop_row_range.assert_called_once_with(
+            name=self.TABLE_NAME, delete_all_data_from_table=True
+        )
+
+        self.assertEqual(result, expected_result)
+
+    def test_truncate_w_timeout(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = mock.create_autospec(bigtable_client.BigtableClient)
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        expected_result = None  # truncate() has no return value.
+
+        timeout = 120
+        result = table.truncate(timeout=timeout)
+
+        self.assertEqual(result, expected_result)
+
+    def test_drop_by_prefix(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = mock.create_autospec(bigtable_client.BigtableClient)
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        expected_result = None  # drop_by_prefix() has no return value.
+
+        row_key_prefix = "row-key-prefix"
+
+        result = table.drop_by_prefix(row_key_prefix=row_key_prefix)
+
+        self.assertEqual(result, expected_result)
+
+    def test_drop_by_prefix_w_timeout(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = mock.create_autospec(bigtable_client.BigtableClient)
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_one(self.TABLE_ID, instance)
+
+        expected_result = None  # drop_by_prefix() has no return value.
+
+        row_key_prefix = "row-key-prefix"
+
+        timeout = 120
+        result = table.drop_by_prefix(row_key_prefix=row_key_prefix, timeout=timeout)
+
+        self.assertEqual(result, expected_result)
+
+    def test_mutations_batcher_factory(self):
+        flush_count = 100
+        max_row_bytes = 1000
+        table = self._make_one(self.TABLE_ID, None)
+        mutation_batcher = table.mutations_batcher(
+            flush_count=flush_count, max_row_bytes=max_row_bytes
+        )
+
+        self.assertEqual(mutation_batcher.table.table_id, self.TABLE_ID)
+        self.assertEqual(mutation_batcher.flush_count, flush_count)
+        self.assertEqual(mutation_batcher.max_row_bytes, max_row_bytes)
+
+
+class Test__RetryableMutateRowsWorker(unittest.TestCase):
+    from grpc import StatusCode
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    TABLE_ID = "table-id"
+
+    # RPC Status Codes
+    SUCCESS = StatusCode.OK.value[0]
+    RETRYABLE_1 = StatusCode.DEADLINE_EXCEEDED.value[0]
+    RETRYABLE_2 = StatusCode.ABORTED.value[0]
+    NON_RETRYABLE = StatusCode.CANCELLED.value[0]
+
+    @staticmethod
+    def _get_target_class_for_worker():
+        from google.cloud.bigtable.table import _RetryableMutateRowsWorker
+
+        return _RetryableMutateRowsWorker
+
+    def _make_worker(self, *args, **kwargs):
+        return self._get_target_class_for_worker()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_class_for_table():
+        from google.cloud.bigtable.table import Table
+
+        return Table
+
+    def _make_table(self, *args, **kwargs):
+        return self._get_target_class_for_table()(*args, **kwargs)
+
+    @staticmethod
+    def _get_target_client_class():
+        from google.cloud.bigtable.client import Client
+
+        return Client
+
+    def _make_client(self, *args, **kwargs):
+        return self._get_target_client_class()(*args, **kwargs)
+
+    def _make_responses_statuses(self, codes):
+        from google.rpc.status_pb2 import Status
+
+        response = [Status(code=code) for code in codes]
+        return response
+
+    def _make_responses(self, codes):
+        import six
+        from google.cloud.bigtable_v2.proto.bigtable_pb2 import MutateRowsResponse
+        from google.rpc.status_pb2 import Status
+
+        entries = [
+            MutateRowsResponse.Entry(index=i, status=Status(code=codes[i]))
+            for i in six.moves.xrange(len(codes))
+        ]
+        return MutateRowsResponse(entries=entries)
+
+    def test_callable_empty_rows(self):
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = mock.create_autospec(bigtable_client.BigtableClient)
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        worker = self._make_worker(client, table.name, [])
+        statuses = worker()
+
+        self.assertEqual(len(statuses), 0)
+
+    def test_callable_no_retry_strategy(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 3 rows.
+        # Action:
+        #   - Attempt to mutate the rows w/o any retry strategy.
+        # Expectation:
+        #   - Since no retry, should return statuses as they come back.
+        #   - Even if there are retryable errors, no retry attempt is made.
+        #   - State of responses_statuses should be
+        #       [success, retryable, non-retryable]
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+        row_3 = DirectRow(row_key=b"row_key_3", table=table)
+        row_3.set_cell("cf", b"col", b"value3")
+
+        response = self._make_responses(
+            [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE]
+        )
+
+        with mock.patch("google.cloud.bigtable.table.wrap_method") as patched:
+            patched.return_value = mock.Mock(return_value=[response])
+
+            worker = self._make_worker(client, table.name, [row_1, row_2, row_3])
+            statuses = worker(retry=None)
+
+        result = [status.code for status in statuses]
+        expected_result = [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE]
+
+        client._table_data_client._inner_api_calls["mutate_rows"].assert_called_once()
+        self.assertEqual(result, expected_result)
+
+    def test_callable_retry(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable.table import DEFAULT_RETRY
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 3 rows.
+        # Action:
+        #   - Initial attempt will mutate all 3 rows.
+        # Expectation:
+        #   - First attempt will result in one retryable error.
+        #   - Second attempt will result in success for the retry-ed row.
+        #   - Check MutateRows is called twice.
+        #   - State of responses_statuses should be
+        #       [success, success, non-retryable]
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+        row_3 = DirectRow(row_key=b"row_key_3", table=table)
+        row_3.set_cell("cf", b"col", b"value3")
+
+        response_1 = self._make_responses(
+            [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE]
+        )
+        response_2 = self._make_responses([self.SUCCESS])
+
+        # Patch the stub used by the API method.
+        client._table_data_client._inner_api_calls["mutate_rows"] = mock.Mock(
+            side_effect=[[response_1], [response_2]]
+        )
+
+        retry = DEFAULT_RETRY.with_delay(initial=0.1)
+        worker = self._make_worker(client, table.name, [row_1, row_2, row_3])
+        statuses = worker(retry=retry)
+
+        result = [status.code for status in statuses]
+        expected_result = [self.SUCCESS, self.SUCCESS, self.NON_RETRYABLE]
+
+        self.assertEqual(
+            client._table_data_client._inner_api_calls["mutate_rows"].call_count, 2
+        )
+        self.assertEqual(result, expected_result)
+
+    def test_do_mutate_retryable_rows_empty_rows(self):
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        worker = self._make_worker(client, table.name, [])
+        statuses = worker._do_mutate_retryable_rows()
+
+        self.assertEqual(len(statuses), 0)
+
+    def test_do_mutate_retryable_rows(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 2 rows.
+        # Action:
+        #   - Initial attempt will mutate all 2 rows.
+        # Expectation:
+        #   - Expect [success, non-retryable]
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+
+        response = self._make_responses([self.SUCCESS, self.NON_RETRYABLE])
+
+        # Patch the stub used by the API method.
+        inner_api_calls = client._table_data_client._inner_api_calls
+        inner_api_calls["mutate_rows"] = mock.Mock(side_effect=[[response]])
+
+        worker = self._make_worker(client, table.name, [row_1, row_2])
+        statuses = worker._do_mutate_retryable_rows()
+
+        result = [status.code for status in statuses]
+        expected_result = [self.SUCCESS, self.NON_RETRYABLE]
+
+        self.assertEqual(result, expected_result)
+
+    def test_do_mutate_retryable_rows_retry(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable.table import _BigtableRetryableError
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 3 rows.
+        # Action:
+        #   - Initial attempt will mutate all 3 rows.
+        # Expectation:
+        #   - Second row returns retryable error code, so expect a raise.
+        #   - State of responses_statuses should be
+        #       [success, retryable, non-retryable]
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+        row_3 = DirectRow(row_key=b"row_key_3", table=table)
+        row_3.set_cell("cf", b"col", b"value3")
+
+        response = self._make_responses(
+            [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE]
+        )
+
+        # Patch the stub used by the API method.
+        inner_api_calls = client._table_data_client._inner_api_calls
+        inner_api_calls["mutate_rows"] = mock.Mock(side_effect=[[response]])
+
+        worker = self._make_worker(client, table.name, [row_1, row_2, row_3])
+
+        with self.assertRaises(_BigtableRetryableError):
+            worker._do_mutate_retryable_rows()
+
+        statuses = worker.responses_statuses
+        result = [status.code for status in statuses]
+        expected_result = [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE]
+
+        self.assertEqual(result, expected_result)
+
+    def test_do_mutate_retryable_rows_second_retry(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable.table import _BigtableRetryableError
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 4 rows.
+        #   - First try results:
+        #       [success, retryable, non-retryable, retryable]
+        # Action:
+        #   - Second try should re-attempt the 'retryable' rows.
+        # Expectation:
+        #   - After second try:
+        #       [success, success, non-retryable, retryable]
+        #   - One of the rows tried second time returns retryable error code,
+        #     so expect a raise.
+        #   - Exception contains response whose index should be '3' even though
+        #     only two rows were retried.
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+        row_3 = DirectRow(row_key=b"row_key_3", table=table)
+        row_3.set_cell("cf", b"col", b"value3")
+        row_4 = DirectRow(row_key=b"row_key_4", table=table)
+        row_4.set_cell("cf", b"col", b"value4")
+
+        response = self._make_responses([self.SUCCESS, self.RETRYABLE_1])
+
+        # Patch the stub used by the API method.
+        inner_api_calls = client._table_data_client._inner_api_calls
+        inner_api_calls["mutate_rows"] = mock.Mock(side_effect=[[response]])
+
+        worker = self._make_worker(client, table.name, [row_1, row_2, row_3, row_4])
+        worker.responses_statuses = self._make_responses_statuses(
+            [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE, self.RETRYABLE_2]
+        )
+
+        with self.assertRaises(_BigtableRetryableError):
+            worker._do_mutate_retryable_rows()
+
+        statuses = worker.responses_statuses
+        result = [status.code for status in statuses]
+        expected_result = [
+            self.SUCCESS,
+            self.SUCCESS,
+            self.NON_RETRYABLE,
+            self.RETRYABLE_1,
+        ]
+
+        self.assertEqual(result, expected_result)
+
+    def test_do_mutate_retryable_rows_second_try(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 4 rows.
+        #   - First try results:
+        #       [success, retryable, non-retryable, retryable]
+        # Action:
+        #   - Second try should re-attempt the 'retryable' rows.
+        # Expectation:
+        #   - After second try:
+        #       [success, non-retryable, non-retryable, success]
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+        row_3 = DirectRow(row_key=b"row_key_3", table=table)
+        row_3.set_cell("cf", b"col", b"value3")
+        row_4 = DirectRow(row_key=b"row_key_4", table=table)
+        row_4.set_cell("cf", b"col", b"value4")
+
+        response = self._make_responses([self.NON_RETRYABLE, self.SUCCESS])
+
+        # Patch the stub used by the API method.
+        inner_api_calls = client._table_data_client._inner_api_calls
+        inner_api_calls["mutate_rows"] = mock.Mock(side_effect=[[response]])
+
+        worker = self._make_worker(client, table.name, [row_1, row_2, row_3, row_4])
+        worker.responses_statuses = self._make_responses_statuses(
+            [self.SUCCESS, self.RETRYABLE_1, self.NON_RETRYABLE, self.RETRYABLE_2]
+        )
+
+        statuses = worker._do_mutate_retryable_rows()
+
+        result = [status.code for status in statuses]
+        expected_result = [
+            self.SUCCESS,
+            self.NON_RETRYABLE,
+            self.NON_RETRYABLE,
+            self.SUCCESS,
+        ]
+
+        self.assertEqual(result, expected_result)
+
+    def test_do_mutate_retryable_rows_second_try_no_retryable(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        # Setup:
+        #   - Mutate 2 rows.
+        #   - First try results: [success, non-retryable]
+        # Action:
+        #   - Second try has no row to retry.
+        # Expectation:
+        #   - After second try: [success, non-retryable]
+
+        table_api = mock.create_autospec(
+            bigtable_table_admin_client.BigtableTableAdminClient
+        )
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+
+        worker = self._make_worker(client, table.name, [row_1, row_2])
+        worker.responses_statuses = self._make_responses_statuses(
+            [self.SUCCESS, self.NON_RETRYABLE]
+        )
+
+        statuses = worker._do_mutate_retryable_rows()
+
+        result = [status.code for status in statuses]
+        expected_result = [self.SUCCESS, self.NON_RETRYABLE]
+
+        self.assertEqual(result, expected_result)
+
+    def test_do_mutate_retryable_rows_mismatch_num_responses(self):
+        from google.cloud.bigtable.row import DirectRow
+        from google.cloud.bigtable_v2.gapic import bigtable_client
+        from google.cloud.bigtable_admin_v2.gapic import bigtable_table_admin_client
+
+        data_api = bigtable_client.BigtableClient(mock.Mock())
+        table_api = bigtable_table_admin_client.BigtableTableAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_client(
+            project="project-id", credentials=credentials, admin=True
+        )
+        client._table_data_client = data_api
+        client._table_admin_client = table_api
+        instance = client.instance(instance_id=self.INSTANCE_ID)
+        table = self._make_table(self.TABLE_ID, instance)
+
+        row_1 = DirectRow(row_key=b"row_key", table=table)
+        row_1.set_cell("cf", b"col", b"value1")
+        row_2 = DirectRow(row_key=b"row_key_2", table=table)
+        row_2.set_cell("cf", b"col", b"value2")
+
+        response = self._make_responses([self.SUCCESS])
+
+        # Patch the stub used by the API method.
+        inner_api_calls = client._table_data_client._inner_api_calls
+        inner_api_calls["mutate_rows"] = mock.Mock(side_effect=[[response]])
+
+        worker = self._make_worker(client, table.name, [row_1, row_2])
+        with self.assertRaises(RuntimeError):
+            worker._do_mutate_retryable_rows()
+
+
+class Test__create_row_request(unittest.TestCase):
+    def _call_fut(
+        self,
+        table_name,
+        start_key=None,
+        end_key=None,
+        filter_=None,
+        limit=None,
+        end_inclusive=False,
+        app_profile_id=None,
+        row_set=None,
+    ):
+
+        from google.cloud.bigtable.table import _create_row_request
+
+        return _create_row_request(
+            table_name,
+            start_key=start_key,
+            end_key=end_key,
+            filter_=filter_,
+            limit=limit,
+            end_inclusive=end_inclusive,
+            app_profile_id=app_profile_id,
+            row_set=row_set,
+        )
+
+    def test_table_name_only(self):
+        table_name = "table_name"
+        result = self._call_fut(table_name)
+        expected_result = _ReadRowsRequestPB(table_name=table_name)
+        self.assertEqual(result, expected_result)
+
+    def test_row_range_row_set_conflict(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(None, end_key=object(), row_set=object())
+
+    def test_row_range_start_key(self):
+        table_name = "table_name"
+        start_key = b"start_key"
+        result = self._call_fut(table_name, start_key=start_key)
+        expected_result = _ReadRowsRequestPB(table_name=table_name)
+        expected_result.rows.row_ranges.add(start_key_closed=start_key)
+        self.assertEqual(result, expected_result)
+
+    def test_row_range_end_key(self):
+        table_name = "table_name"
+        end_key = b"end_key"
+        result = self._call_fut(table_name, end_key=end_key)
+        expected_result = _ReadRowsRequestPB(table_name=table_name)
+        expected_result.rows.row_ranges.add(end_key_open=end_key)
+        self.assertEqual(result, expected_result)
+
+    def test_row_range_both_keys(self):
+        table_name = "table_name"
+        start_key = b"start_key"
+        end_key = b"end_key"
+        result = self._call_fut(table_name, start_key=start_key, end_key=end_key)
+        expected_result = _ReadRowsRequestPB(table_name=table_name)
+        expected_result.rows.row_ranges.add(
+            start_key_closed=start_key, end_key_open=end_key
+        )
+        self.assertEqual(result, expected_result)
+
+    def test_row_range_both_keys_inclusive(self):
+        table_name = "table_name"
+        start_key = b"start_key"
+        end_key = b"end_key"
+        result = self._call_fut(
+            table_name, start_key=start_key, end_key=end_key, end_inclusive=True
+        )
+        expected_result = _ReadRowsRequestPB(table_name=table_name)
+        expected_result.rows.row_ranges.add(
+            start_key_closed=start_key, end_key_closed=end_key
+        )
+        self.assertEqual(result, expected_result)
+
+    def test_with_filter(self):
+        from google.cloud.bigtable.row_filters import RowSampleFilter
+
+        table_name = "table_name"
+        row_filter = RowSampleFilter(0.33)
+        result = self._call_fut(table_name, filter_=row_filter)
+        expected_result = _ReadRowsRequestPB(
+            table_name=table_name, filter=row_filter.to_pb()
+        )
+        self.assertEqual(result, expected_result)
+
+    def test_with_limit(self):
+        table_name = "table_name"
+        limit = 1337
+        result = self._call_fut(table_name, limit=limit)
+        expected_result = _ReadRowsRequestPB(table_name=table_name, rows_limit=limit)
+        self.assertEqual(result, expected_result)
+
+    def test_with_row_set(self):
+        from google.cloud.bigtable.row_set import RowSet
+
+        table_name = "table_name"
+        row_set = RowSet()
+        result = self._call_fut(table_name, row_set=row_set)
+        expected_result = _ReadRowsRequestPB(table_name=table_name)
+        self.assertEqual(result, expected_result)
+
+    def test_with_app_profile_id(self):
+        table_name = "table_name"
+        limit = 1337
+        app_profile_id = "app-profile-id"
+        result = self._call_fut(table_name, limit=limit, app_profile_id=app_profile_id)
+        expected_result = _ReadRowsRequestPB(
+            table_name=table_name, rows_limit=limit, app_profile_id=app_profile_id
+        )
+        self.assertEqual(result, expected_result)
+
+
+def _ReadRowsRequestPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    return messages_v2_pb2.ReadRowsRequest(*args, **kw)
+
+
+class Test_ClusterState(unittest.TestCase):
+    def test___eq__(self):
+        from google.cloud.bigtable.enums import Table as enum_table
+        from google.cloud.bigtable.table import ClusterState
+
+        READY = enum_table.ReplicationState.READY
+        state1 = ClusterState(READY)
+        state2 = ClusterState(READY)
+        self.assertEqual(state1, state2)
+
+    def test___eq__type_differ(self):
+        from google.cloud.bigtable.enums import Table as enum_table
+        from google.cloud.bigtable.table import ClusterState
+
+        READY = enum_table.ReplicationState.READY
+        state1 = ClusterState(READY)
+        state2 = object()
+        self.assertNotEqual(state1, state2)
+
+    def test___ne__same_value(self):
+        from google.cloud.bigtable.enums import Table as enum_table
+        from google.cloud.bigtable.table import ClusterState
+
+        READY = enum_table.ReplicationState.READY
+        state1 = ClusterState(READY)
+        state2 = ClusterState(READY)
+        comparison_val = state1 != state2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        from google.cloud.bigtable.enums import Table as enum_table
+        from google.cloud.bigtable.table import ClusterState
+
+        READY = enum_table.ReplicationState.READY
+        INITIALIZING = enum_table.ReplicationState.INITIALIZING
+        state1 = ClusterState(READY)
+        state2 = ClusterState(INITIALIZING)
+        self.assertNotEqual(state1, state2)
+
+    def test__repr__(self):
+        from google.cloud.bigtable.enums import Table as enum_table
+        from google.cloud.bigtable.table import ClusterState
+
+        STATE_NOT_KNOWN = enum_table.ReplicationState.STATE_NOT_KNOWN
+        INITIALIZING = enum_table.ReplicationState.INITIALIZING
+        PLANNED_MAINTENANCE = enum_table.ReplicationState.PLANNED_MAINTENANCE
+        UNPLANNED_MAINTENANCE = enum_table.ReplicationState.UNPLANNED_MAINTENANCE
+        READY = enum_table.ReplicationState.READY
+
+        replication_dict = {
+            STATE_NOT_KNOWN: "STATE_NOT_KNOWN",
+            INITIALIZING: "INITIALIZING",
+            PLANNED_MAINTENANCE: "PLANNED_MAINTENANCE",
+            UNPLANNED_MAINTENANCE: "UNPLANNED_MAINTENANCE",
+            READY: "READY",
+        }
+
+        self.assertEqual(
+            str(ClusterState(STATE_NOT_KNOWN)), replication_dict[STATE_NOT_KNOWN]
+        )
+        self.assertEqual(
+            str(ClusterState(INITIALIZING)), replication_dict[INITIALIZING]
+        )
+        self.assertEqual(
+            str(ClusterState(PLANNED_MAINTENANCE)),
+            replication_dict[PLANNED_MAINTENANCE],
+        )
+        self.assertEqual(
+            str(ClusterState(UNPLANNED_MAINTENANCE)),
+            replication_dict[UNPLANNED_MAINTENANCE],
+        )
+        self.assertEqual(str(ClusterState(READY)), replication_dict[READY])
+
+        self.assertEqual(
+            ClusterState(STATE_NOT_KNOWN).replication_state, STATE_NOT_KNOWN
+        )
+        self.assertEqual(ClusterState(INITIALIZING).replication_state, INITIALIZING)
+        self.assertEqual(
+            ClusterState(PLANNED_MAINTENANCE).replication_state, PLANNED_MAINTENANCE
+        )
+        self.assertEqual(
+            ClusterState(UNPLANNED_MAINTENANCE).replication_state, UNPLANNED_MAINTENANCE
+        )
+        self.assertEqual(ClusterState(READY).replication_state, READY)
+
+
+def _ReadRowsResponseCellChunkPB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    family_name = kw.pop("family_name")
+    qualifier = kw.pop("qualifier")
+    message = messages_v2_pb2.ReadRowsResponse.CellChunk(*args, **kw)
+    message.family_name.value = family_name
+    message.qualifier.value = qualifier
+    return message
+
+
+def _ReadRowsResponsePB(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as messages_v2_pb2
+
+    return messages_v2_pb2.ReadRowsResponse(*args, **kw)
+
+
+def _mutate_rows_request_pb(*args, **kw):
+    from google.cloud.bigtable_v2.proto import bigtable_pb2 as data_messages_v2_pb2
+
+    return data_messages_v2_pb2.MutateRowsRequest(*args, **kw)
+
+
+class _MockReadRowsIterator(object):
+    def __init__(self, *values):
+        self.iter_values = iter(values)
+
+    def next(self):
+        return next(self.iter_values)
+
+    __next__ = next
+
+
+class _MockFailureIterator_1(object):
+    def next(self):
+        raise DeadlineExceeded("Failed to read from server")
+
+    __next__ = next
+
+
+class _MockFailureIterator_2(object):
+    def __init__(self, *values):
+        self.iter_values = values[0]
+        self.calls = 0
+
+    def next(self):
+        self.calls += 1
+        if self.calls == 1:
+            return self.iter_values[0]
+        else:
+            raise DeadlineExceeded("Failed to read from server")
+
+    __next__ = next
+
+
+class _ReadRowsResponseV2(object):
+    def __init__(self, chunks, last_scanned_row_key=""):
+        self.chunks = chunks
+        self.last_scanned_row_key = last_scanned_row_key
+
+
+def _TablePB(*args, **kw):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.Table(*args, **kw)
+
+
+def _ColumnFamilyPB(*args, **kw):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.ColumnFamily(*args, **kw)
+
+
+def _ClusterStatePB(replication_state):
+    from google.cloud.bigtable_admin_v2.proto import table_pb2 as table_v2_pb2
+
+    return table_v2_pb2.Table.ClusterState(replication_state=replication_state)
+
+
+def _read_rows_retry_exception(exc):
+    return isinstance(exc, DeadlineExceeded)
diff --git a/container/.coveragerc b/container/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/container/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/container/.flake8 b/container/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/container/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/container/.repo-metadata.json b/container/.repo-metadata.json
new file mode 100644
index 000000000000..9eff44e5832e
--- /dev/null
+++ b/container/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "container",
+  "name_pretty": "Kubernetes Engine",
+  "product_documentation": "https://cloud.google.com/kubernetes-engine/",
+  "client_documentation": "https://googleapis.dev/python/container/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559777",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-container",
+  "api_id": "container.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/container/CHANGELOG.md b/container/CHANGELOG.md
new file mode 100644
index 000000000000..4b550fcfed4a
--- /dev/null
+++ b/container/CHANGELOG.md
@@ -0,0 +1,117 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-container/#history
+
+## 0.3.0
+
+07-30-2019 10:28 PDT
+
+
+### Implementation Changes
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8501](https://github.com/googleapis/google-cloud-python/pull/8501))
+- Add synth support for v1beta1 API version (via manual synth). ([#8436](https://github.com/googleapis/google-cloud-python/pull/8436))
+-  Allow kwargs to be passed to create_channel (via synth).  ([#8384](https://github.com/googleapis/google-cloud-python/pull/8384))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### Documentation
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8575](https://github.com/googleapis/google-cloud-python/pull/8575))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8347](https://github.com/googleapis/google-cloud-python/pull/8347))
+- Add disclaimer to auto-generated template files (via synth).  ([#8309](https://github.com/googleapis/google-cloud-python/pull/8309))
+- Update noxfile and setup.py (via synth). ([#8298](https://github.com/googleapis/google-cloud-python/pull/8298))
+- Blacken (via synth). ([#8285](https://github.com/googleapis/google-cloud-python/pull/8285))
+- Add routing header to method metadata, add nox session `docs` (via synth). ([#7922](https://github.com/googleapis/google-cloud-python/pull/7922))
+- Copy proto files alongside protoc versions.
+- Minor gapic-generator change. ([#7225](https://github.com/googleapis/google-cloud-python/pull/7225))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers ([#7140](https://github.com/googleapis/google-cloud-python/pull/7140))
+- Protoc-generated serialization update. ([#7078](https://github.com/googleapis/google-cloud-python/pull/7078))
+- Pick up stub docstring fix in GAPIC generator. ([#6966](https://github.com/googleapis/google-cloud-python/pull/6966))
+
+## 0.2.1
+
+12-17-2018 16:36 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Improve linkage between container docs pages. ([#6852](https://github.com/googleapis/google-cloud-python/pull/6852))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+
+## 0.2.0
+
+12-04-2018 11:28 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core.iam.policy` ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6634](https://github.com/googleapis/google-cloud-python/pull/6634))
+- Fix `client_info` bug, update docstrings. ([#6407](https://github.com/googleapis/google-cloud-python/pull/6407))
+- Avoid overwriting '__module__' of messages from shared modules. ([#5364](https://github.com/googleapis/google-cloud-python/pull/5364))
+- Fix bad trove classifier
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Container: harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6018](https://github.com/googleapis/google-cloud-python/pull/6018))
+- Rename releases to changelog and include from CHANGELOG.md ([#5191](https://github.com/googleapis/google-cloud-python/pull/5191))
+
+### Internal / Testing Changes
+- Update noxfile.
+- blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local dependencies from coverage. ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Unblack container gapic and protos.
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Pass posargs to py.test ([#6653](https://github.com/googleapis/google-cloud-python/pull/6653))
+- Update synth.py yaml location ([#6480](https://github.com/googleapis/google-cloud-python/pull/6480))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Container: add 'synth.py'. ([#6084](https://github.com/googleapis/google-cloud-python/pull/6084))
+- Nox: use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Modify system tests to use prerelease versions of grpcio ([#5304](https://github.com/googleapis/google-cloud-python/pull/5304))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+
+## 0.1.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Replacing references to `stable/` docs with `latest/`. (#4638)
+
+### Testing and internal changes
+
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- nox unittest updates (#4646)
+
+## 0.1.0
+
+[![release level](https://img.shields.io/badge/release%20level-alpha-orange.svg?style&#x3D;flat)](https://cloud.google.com/terms/launch-stages)
+
+Google Kubernetes Engine is a managed environment for deploying containerized
+applications. It brings our latest innovations in developer productivity,
+resource efficiency, automated operations, and open source flexibility to
+accelerate your time to market.
+
+PyPI: https://pypi.org/project/google-cloud-container/0.1.0/
diff --git a/container/LICENSE b/container/LICENSE
new file mode 100644
index 000000000000..724a8807144b
--- /dev/null
+++ b/container/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/container/MANIFEST.in b/container/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/container/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/container/README.rst b/container/README.rst
new file mode 100644
index 000000000000..f98cd02b73c3
--- /dev/null
+++ b/container/README.rst
@@ -0,0 +1,101 @@
+Python Client for Google Kubernetes Engine API
+==============================================
+
+|alpha| |pypi| |versions| 
+
+`Google Kubernetes Engine API`_: The Google Kubernetes Engine API is used for
+building and managing container based applications, powered by the open source
+Kubernetes technology.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-container.svg
+   :target: https://pypi.org/project/google-cloud-container/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-container.svg
+   :target: https://pypi.org/project/google-cloud-container/
+.. _Google Kubernetes Engine API: https://cloud.google.com/kubernetes-engine
+.. _Client Library Documentation: https://googleapis.dev/python/container/latest
+.. _Product Documentation:  https://cloud.google.com/kubernetes-engine
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable the Google Container Engine API.`_
+3. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable the Google Container Engine API.:  https://cloud.google.com/container
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-container
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-container
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code:: py
+
+    from google.cloud import container_v1
+
+    client = container_v1.ClusterManagerClient()
+
+    project_id = ''
+    zone = ''
+
+    response = client.list_clusters(project_id, zone)
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client API Documentation`_ to see other available methods on the client.
+-  Read the `Product documentation`_ to learn more about the product and see
+   How-to Guides.
+
+.. _Client API Documentation: https://googleapis.dev/python/container/latest
diff --git a/container/docs/README.rst b/container/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/container/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/container/docs/changelog.md b/container/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/container/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/container/docs/conf.py b/container/docs/conf.py
new file mode 100644
index 000000000000..b303b529e88a
--- /dev/null
+++ b/container/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-container documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-container"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-container-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-container.tex",
+        u"google-cloud-container Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-container",
+        u"google-cloud-container Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-container",
+        u"google-cloud-container Documentation",
+        author,
+        "google-cloud-container",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/container/docs/gapic/v1/api.rst b/container/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..62435f64eb2a
--- /dev/null
+++ b/container/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Container Engine API
+======================================
+
+.. automodule:: google.cloud.container_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/container/docs/gapic/v1/types.rst b/container/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..7b1c1f951994
--- /dev/null
+++ b/container/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Container Engine API Client
+============================================
+
+.. automodule:: google.cloud.container_v1.types
+    :members:
\ No newline at end of file
diff --git a/container/docs/index.rst b/container/docs/index.rst
new file mode 100644
index 000000000000..9b788c6c01bf
--- /dev/null
+++ b/container/docs/index.rst
@@ -0,0 +1,19 @@
+.. include:: README.rst
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1/api
+   gapic/v1/types
+
+Changelog
+---------
+
+For a list of all ``google-cloud-container`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/container/google/__init__.py b/container/google/__init__.py
new file mode 100644
index 000000000000..2f4b4738aee1
--- /dev/null
+++ b/container/google/__init__.py
@@ -0,0 +1,8 @@
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/container/google/cloud/__init__.py b/container/google/cloud/__init__.py
new file mode 100644
index 000000000000..2f4b4738aee1
--- /dev/null
+++ b/container/google/cloud/__init__.py
@@ -0,0 +1,8 @@
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/container/google/cloud/container.py b/container/google/cloud/container.py
new file mode 100644
index 000000000000..aa663f733845
--- /dev/null
+++ b/container/google/cloud/container.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.container_v1 import ClusterManagerClient
+from google.cloud.container_v1 import enums
+from google.cloud.container_v1 import types
+
+
+__all__ = ("enums", "types", "ClusterManagerClient")
diff --git a/container/google/cloud/container_v1/__init__.py b/container/google/cloud/container_v1/__init__.py
new file mode 100644
index 000000000000..ffa2273ef616
--- /dev/null
+++ b/container/google/cloud/container_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.container_v1 import types
+from google.cloud.container_v1.gapic import cluster_manager_client
+from google.cloud.container_v1.gapic import enums
+
+
+class ClusterManagerClient(cluster_manager_client.ClusterManagerClient):
+    __doc__ = cluster_manager_client.ClusterManagerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ClusterManagerClient")
diff --git a/container/google/cloud/container_v1/gapic/__init__.py b/container/google/cloud/container_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/container/google/cloud/container_v1/gapic/cluster_manager_client.py b/container/google/cloud/container_v1/gapic/cluster_manager_client.py
new file mode 100644
index 000000000000..dec1e8ac2347
--- /dev/null
+++ b/container/google/cloud/container_v1/gapic/cluster_manager_client.py
@@ -0,0 +1,3219 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.container.v1 ClusterManager API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.container_v1.gapic import cluster_manager_client_config
+from google.cloud.container_v1.gapic import enums
+from google.cloud.container_v1.gapic.transports import cluster_manager_grpc_transport
+from google.cloud.container_v1.proto import cluster_service_pb2
+from google.cloud.container_v1.proto import cluster_service_pb2_grpc
+from google.protobuf import empty_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-container"
+).version
+
+
+class ClusterManagerClient(object):
+    """Google Kubernetes Engine Cluster Manager v1"""
+
+    SERVICE_ADDRESS = "container.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.container.v1.ClusterManager"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ClusterManagerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ClusterManagerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ClusterManagerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cluster_manager_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cluster_manager_grpc_transport.ClusterManagerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cluster_manager_grpc_transport.ClusterManagerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_clusters(
+        self,
+        project_id,
+        zone,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all clusters owned by a project in either the specified zone or all
+        zones.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> response = client.list_clusters(project_id, zone)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            parent (str): The parent (project and location) where the clusters will be listed.
+                Specified in the format 'projects/*/locations/*'. Location "-" matches
+                all zones and all regions.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.ListClustersResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_clusters" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_clusters"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_clusters,
+                default_retry=self._method_configs["ListClusters"].retry,
+                default_timeout=self._method_configs["ListClusters"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListClustersRequest(
+            project_id=project_id, zone=zone, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_clusters"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_cluster(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the details of a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.get_cluster(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to retrieve.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster) of the cluster to retrieve.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Cluster` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_cluster,
+                default_retry=self._method_configs["GetCluster"].retry,
+                default_timeout=self._method_configs["GetCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_cluster(
+        self,
+        project_id,
+        zone,
+        cluster,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 <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 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.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> response = client.create_cluster(project_id, zone, cluster)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster (Union[dict, ~google.cloud.container_v1.types.Cluster]): A `cluster
+                resource <https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.clusters>`__
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.Cluster`
+            parent (str): The parent (project and location) where the cluster will be created.
+                Specified in the format 'projects/*/locations/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_cluster,
+                default_retry=self._method_configs["CreateCluster"].retry,
+                default_timeout=self._method_configs["CreateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CreateClusterRequest(
+            project_id=project_id, zone=zone, cluster=cluster, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_cluster(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        update,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the settings of a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `update`:
+            >>> update = {}
+            >>>
+            >>> response = client.update_cluster(project_id, zone, cluster_id, update)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            update (Union[dict, ~google.cloud.container_v1.types.ClusterUpdate]): A description of the update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.ClusterUpdate`
+            name (str): The name (project, location, cluster) of the cluster to update.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_cluster,
+                default_retry=self._method_configs["UpdateCluster"].retry,
+                default_timeout=self._method_configs["UpdateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.UpdateClusterRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            update=update,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        node_version,
+        image_type,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the version and/or image type for a specific node pool.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `node_version`:
+            >>> node_version = ''
+            >>>
+            >>> # TODO: Initialize `image_type`:
+            >>> image_type = ''
+            >>>
+            >>> response = client.update_node_pool(project_id, zone, cluster_id, node_pool_id, node_version, image_type)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to upgrade.
+                This field has been deprecated and replaced by the name field.
+            node_version (str): The Kubernetes version to change the nodes to (typically an
+                upgrade).
+
+                Users may specify either explicit versions offered by Kubernetes Engine or
+                version aliases, which have the following behavior:
+
+                - "latest": picks the highest valid Kubernetes version
+                - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+                - "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
+            image_type (str): The desired image type for the node pool.
+            name (str): The name (project, location, cluster, node pool) of the node pool to
+                update. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_node_pool,
+                default_retry=self._method_configs["UpdateNodePool"].retry,
+                default_timeout=self._method_configs["UpdateNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.UpdateNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_version=node_version,
+            image_type=image_type,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_node_pool_autoscaling(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        autoscaling,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the autoscaling settings for a specific node pool.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `autoscaling`:
+            >>> autoscaling = {}
+            >>>
+            >>> response = client.set_node_pool_autoscaling(project_id, zone, cluster_id, node_pool_id, autoscaling)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to upgrade.
+                This field has been deprecated and replaced by the name field.
+            autoscaling (Union[dict, ~google.cloud.container_v1.types.NodePoolAutoscaling]): Autoscaling configuration for the node pool.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.NodePoolAutoscaling`
+            name (str): The name (project, location, cluster, node pool) of the node pool to set
+                autoscaler settings. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_node_pool_autoscaling" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_node_pool_autoscaling"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_node_pool_autoscaling,
+                default_retry=self._method_configs["SetNodePoolAutoscaling"].retry,
+                default_timeout=self._method_configs["SetNodePoolAutoscaling"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNodePoolAutoscalingRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            autoscaling=autoscaling,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_node_pool_autoscaling"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_logging_service(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        logging_service,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the logging service for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `logging_service`:
+            >>> logging_service = ''
+            >>>
+            >>> response = client.set_logging_service(project_id, zone, cluster_id, logging_service)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            logging_service (str): 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
+            name (str): The name (project, location, cluster) of the cluster to set logging.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_logging_service" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_logging_service"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_logging_service,
+                default_retry=self._method_configs["SetLoggingService"].retry,
+                default_timeout=self._method_configs["SetLoggingService"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLoggingServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            logging_service=logging_service,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_logging_service"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_monitoring_service(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        monitoring_service,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the monitoring service for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `monitoring_service`:
+            >>> monitoring_service = ''
+            >>>
+            >>> response = client.set_monitoring_service(project_id, zone, cluster_id, monitoring_service)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            monitoring_service (str): 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
+            name (str): The name (project, location, cluster) of the cluster to set monitoring.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_monitoring_service" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_monitoring_service"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_monitoring_service,
+                default_retry=self._method_configs["SetMonitoringService"].retry,
+                default_timeout=self._method_configs["SetMonitoringService"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetMonitoringServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            monitoring_service=monitoring_service,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_monitoring_service"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_addons_config(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        addons_config,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the addons for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `addons_config`:
+            >>> addons_config = {}
+            >>>
+            >>> response = client.set_addons_config(project_id, zone, cluster_id, addons_config)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            addons_config (Union[dict, ~google.cloud.container_v1.types.AddonsConfig]): The desired configurations for the various addons available to run in the
+                cluster.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.AddonsConfig`
+            name (str): The name (project, location, cluster) of the cluster to set addons.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_addons_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_addons_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_addons_config,
+                default_retry=self._method_configs["SetAddonsConfig"].retry,
+                default_timeout=self._method_configs["SetAddonsConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetAddonsConfigRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            addons_config=addons_config,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_addons_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_locations(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        locations,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the locations for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `locations`:
+            >>> locations = []
+            >>>
+            >>> response = client.set_locations(project_id, zone, cluster_id, locations)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            locations (list[str]): The desired list of Google Compute Engine
+                `locations <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.
+            name (str): The name (project, location, cluster) of the cluster to set locations.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_locations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_locations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_locations,
+                default_retry=self._method_configs["SetLocations"].retry,
+                default_timeout=self._method_configs["SetLocations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLocationsRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            locations=locations,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_locations"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_master(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        master_version,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the master for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `master_version`:
+            >>> master_version = ''
+            >>>
+            >>> response = client.update_master(project_id, zone, cluster_id, master_version)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            master_version (str): 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:
+
+                - "latest": picks the highest valid Kubernetes version
+                - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+                - "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
+            name (str): The name (project, location, cluster) of the cluster to update.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_master" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_master"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_master,
+                default_retry=self._method_configs["UpdateMaster"].retry,
+                default_timeout=self._method_configs["UpdateMaster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.UpdateMasterRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            master_version=master_version,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_master"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_master_auth(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        action,
+        update,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>> from google.cloud.container_v1 import enums
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `action`:
+            >>> action = enums.SetMasterAuthRequest.Action.UNKNOWN
+            >>>
+            >>> # TODO: Initialize `update`:
+            >>> update = {}
+            >>>
+            >>> response = client.set_master_auth(project_id, zone, cluster_id, action, update)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            action (~google.cloud.container_v1.types.Action): The exact form of action to be taken on the master auth.
+            update (Union[dict, ~google.cloud.container_v1.types.MasterAuth]): A description of the update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.MasterAuth`
+            name (str): The name (project, location, cluster) of the cluster to set auth.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_master_auth" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_master_auth"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_master_auth,
+                default_retry=self._method_configs["SetMasterAuth"].retry,
+                default_timeout=self._method_configs["SetMasterAuth"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetMasterAuthRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            action=action,
+            update=update,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_master_auth"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_cluster(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the cluster, including the Kubernetes endpoint and all worker
+        nodes.
+
+        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.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.delete_cluster(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to delete.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster) of the cluster to delete.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_cluster,
+                default_retry=self._method_configs["DeleteCluster"].retry,
+                default_timeout=self._method_configs["DeleteCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.DeleteClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["delete_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_operations(
+        self,
+        project_id,
+        zone,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all operations in a project in a specific zone or all zones.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> response = client.list_operations(project_id, zone)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            parent (str): The parent (project and location) where the operations will be listed.
+                Specified in the format 'projects/*/locations/*'. Location "-" matches
+                all zones and all regions.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.ListOperationsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_operations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_operations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_operations,
+                default_retry=self._method_configs["ListOperations"].retry,
+                default_timeout=self._method_configs["ListOperations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListOperationsRequest(
+            project_id=project_id, zone=zone, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_operations"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_operation(
+        self,
+        project_id,
+        zone,
+        operation_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the specified operation.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `operation_id`:
+            >>> operation_id = ''
+            >>>
+            >>> response = client.get_operation(project_id, zone, operation_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            operation_id (str): Deprecated. The server-assigned ``name`` of the operation. This field
+                has been deprecated and replaced by the name field.
+            name (str): The name (project, location, operation id) of the operation to get.
+                Specified in the format 'projects/*/locations/*/operations/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_operation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_operation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_operation,
+                default_retry=self._method_configs["GetOperation"].retry,
+                default_timeout=self._method_configs["GetOperation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_operation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_operation(
+        self,
+        project_id,
+        zone,
+        operation_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Cancels the specified operation.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `operation_id`:
+            >>> operation_id = ''
+            >>>
+            >>> client.cancel_operation(project_id, zone, operation_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            operation_id (str): Deprecated. The server-assigned ``name`` of the operation. This field
+                has been deprecated and replaced by the name field.
+            name (str): The name (project, location, operation id) of the operation to cancel.
+                Specified in the format 'projects/*/locations/*/operations/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_operation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_operation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_operation,
+                default_retry=self._method_configs["CancelOperation"].retry,
+                default_timeout=self._method_configs["CancelOperation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CancelOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["cancel_operation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_server_config(
+        self,
+        project_id,
+        zone,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns configuration info about the Kubernetes Engine service.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> response = client.get_server_config(project_id, zone)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            name (str): The name (project and location) of the server config to get Specified in
+                the format 'projects/*/locations/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.ServerConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_server_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_server_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_server_config,
+                default_retry=self._method_configs["GetServerConfig"].retry,
+                default_timeout=self._method_configs["GetServerConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetServerConfigRequest(
+            project_id=project_id, zone=zone, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_server_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_node_pools(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the node pools for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.list_node_pools(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the parent field.
+            parent (str): The parent (project, location, cluster id) where the node pools will be
+                listed. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.ListNodePoolsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_node_pools" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_node_pools"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_node_pools,
+                default_retry=self._method_configs["ListNodePools"].retry,
+                default_timeout=self._method_configs["ListNodePools"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListNodePoolsRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_node_pools"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves the node pool requested.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> response = client.get_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                get. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.NodePool` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_node_pool,
+                default_retry=self._method_configs["GetNodePool"].retry,
+                default_timeout=self._method_configs["GetNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a node pool for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool`:
+            >>> node_pool = {}
+            >>>
+            >>> response = client.create_node_pool(project_id, zone, cluster_id, node_pool)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the parent field.
+            node_pool (Union[dict, ~google.cloud.container_v1.types.NodePool]): The node pool to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.NodePool`
+            parent (str): The parent (project, location, cluster id) where the node pool will be
+                created. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_node_pool,
+                default_retry=self._method_configs["CreateNodePool"].retry,
+                default_timeout=self._method_configs["CreateNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CreateNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool=node_pool,
+            parent=parent,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a node pool from a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> response = client.delete_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to delete.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                delete. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_node_pool,
+                default_retry=self._method_configs["DeleteNodePool"].retry,
+                default_timeout=self._method_configs["DeleteNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.DeleteNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["delete_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rollback_node_pool_upgrade(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Roll back the previously Aborted or Failed NodePool upgrade.
+        This will be an no-op if the last upgrade successfully completed.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> response = client.rollback_node_pool_upgrade(project_id, zone, cluster_id, node_pool_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to rollback.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to rollback.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster, node pool id) of the node poll to
+                rollback upgrade. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rollback_node_pool_upgrade" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rollback_node_pool_upgrade"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rollback_node_pool_upgrade,
+                default_retry=self._method_configs["RollbackNodePoolUpgrade"].retry,
+                default_timeout=self._method_configs["RollbackNodePoolUpgrade"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.RollbackNodePoolUpgradeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["rollback_node_pool_upgrade"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_node_pool_management(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        management,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the NodeManagement options for a node pool.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `management`:
+            >>> management = {}
+            >>>
+            >>> response = client.set_node_pool_management(project_id, zone, cluster_id, node_pool_id, management)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to update.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to update.
+                This field has been deprecated and replaced by the name field.
+            management (Union[dict, ~google.cloud.container_v1.types.NodeManagement]): NodeManagement configuration for the node pool.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.NodeManagement`
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                set management properties. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_node_pool_management" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_node_pool_management"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_node_pool_management,
+                default_retry=self._method_configs["SetNodePoolManagement"].retry,
+                default_timeout=self._method_configs["SetNodePoolManagement"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNodePoolManagementRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            management=management,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_node_pool_management"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_labels(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        resource_labels,
+        label_fingerprint,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets labels on a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `resource_labels`:
+            >>> resource_labels = {}
+            >>>
+            >>> # TODO: Initialize `label_fingerprint`:
+            >>> label_fingerprint = ''
+            >>>
+            >>> response = client.set_labels(project_id, zone, cluster_id, resource_labels, label_fingerprint)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            resource_labels (dict[str -> str]): The labels to set for that cluster.
+            label_fingerprint (str): 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 <code>get()</code> request to the
+                resource to get the latest fingerprint.
+            name (str): The name (project, location, cluster id) of the cluster to set labels.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_labels" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_labels"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_labels,
+                default_retry=self._method_configs["SetLabels"].retry,
+                default_timeout=self._method_configs["SetLabels"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLabelsRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            resource_labels=resource_labels,
+            label_fingerprint=label_fingerprint,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_labels"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_legacy_abac(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        enabled,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Enables or disables the ABAC authorization mechanism on a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `enabled`:
+            >>> enabled = False
+            >>>
+            >>> response = client.set_legacy_abac(project_id, zone, cluster_id, enabled)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to update.
+                This field has been deprecated and replaced by the name field.
+            enabled (bool): Whether ABAC authorization will be enabled in the cluster.
+            name (str): The name (project, location, cluster id) of the cluster to set legacy
+                abac. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_legacy_abac" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_legacy_abac"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_legacy_abac,
+                default_retry=self._method_configs["SetLegacyAbac"].retry,
+                default_timeout=self._method_configs["SetLegacyAbac"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLegacyAbacRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            enabled=enabled,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_legacy_abac"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def start_i_p_rotation(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        rotate_credentials=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Start master IP rotation.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.start_i_p_rotation(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster id) of the cluster to start IP
+                rotation. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            rotate_credentials (bool): Whether to rotate credentials during IP rotation.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "start_i_p_rotation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "start_i_p_rotation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.start_i_p_rotation,
+                default_retry=self._method_configs["StartIPRotation"].retry,
+                default_timeout=self._method_configs["StartIPRotation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.StartIPRotationRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            name=name,
+            rotate_credentials=rotate_credentials,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["start_i_p_rotation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def complete_i_p_rotation(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Completes master IP rotation.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.complete_i_p_rotation(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster id) of the cluster to complete IP
+                rotation. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "complete_i_p_rotation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "complete_i_p_rotation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.complete_i_p_rotation,
+                default_retry=self._method_configs["CompleteIPRotation"].retry,
+                default_timeout=self._method_configs["CompleteIPRotation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CompleteIPRotationRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["complete_i_p_rotation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_node_pool_size(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        node_count,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the size for a specific node pool.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `node_count`:
+            >>> node_count = 0
+            >>>
+            >>> response = client.set_node_pool_size(project_id, zone, cluster_id, node_pool_id, node_count)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to update.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to update.
+                This field has been deprecated and replaced by the name field.
+            node_count (int): The desired node count for the pool.
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                set size. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_node_pool_size" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_node_pool_size"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_node_pool_size,
+                default_retry=self._method_configs["SetNodePoolSize"].retry,
+                default_timeout=self._method_configs["SetNodePoolSize"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNodePoolSizeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_count=node_count,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_node_pool_size"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_network_policy(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        network_policy,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Enables/Disables Network Policy for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `network_policy`:
+            >>> network_policy = {}
+            >>>
+            >>> response = client.set_network_policy(project_id, zone, cluster_id, network_policy)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            network_policy (Union[dict, ~google.cloud.container_v1.types.NetworkPolicy]): Configuration options for the NetworkPolicy feature.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.NetworkPolicy`
+            name (str): The name (project, location, cluster id) of the cluster to set
+                networking policy. Specified in the format
+                'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_network_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_network_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_network_policy,
+                default_retry=self._method_configs["SetNetworkPolicy"].retry,
+                default_timeout=self._method_configs["SetNetworkPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNetworkPolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            network_policy=network_policy,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_network_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_maintenance_policy(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        maintenance_policy,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the maintenance policy for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1
+            >>>
+            >>> client = container_v1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `maintenance_policy`:
+            >>> maintenance_policy = {}
+            >>>
+            >>> response = client.set_maintenance_policy(project_id, zone, cluster_id, maintenance_policy)
+
+        Args:
+            project_id (str): The Google Developers Console `project ID or project
+                number <https://support.google.com/cloud/answer/6158840>`__.
+            zone (str): The name of the Google Compute Engine
+                `zone <https://cloud.google.com/compute/docs/zones#available>`__ in
+                which the cluster resides.
+            cluster_id (str): The name of the cluster to update.
+            maintenance_policy (Union[dict, ~google.cloud.container_v1.types.MaintenancePolicy]): The maintenance policy to be set for the cluster. An empty field
+                clears the existing maintenance policy.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1.types.MaintenancePolicy`
+            name (str): The name (project, location, cluster id) of the cluster to set
+                maintenance policy. Specified in the format
+                'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_maintenance_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_maintenance_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_maintenance_policy,
+                default_retry=self._method_configs["SetMaintenancePolicy"].retry,
+                default_timeout=self._method_configs["SetMaintenancePolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetMaintenancePolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            maintenance_policy=maintenance_policy,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_maintenance_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/container/google/cloud/container_v1/gapic/cluster_manager_client_config.py b/container/google/cloud/container_v1/gapic/cluster_manager_client_config.py
new file mode 100644
index 000000000000..cf96a732a581
--- /dev/null
+++ b/container/google/cloud/container_v1/gapic/cluster_manager_client_config.py
@@ -0,0 +1,173 @@
+config = {
+    "interfaces": {
+        "google.container.v1.ClusterManager": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListClusters": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateCluster": {
+                    "timeout_millis": 45000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNodePoolAutoscaling": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLoggingService": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetMonitoringService": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetAddonsConfig": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLocations": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateMaster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetMasterAuth": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListOperations": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetOperation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelOperation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetServerConfig": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListNodePools": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RollbackNodePoolUpgrade": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNodePoolManagement": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLabels": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLegacyAbac": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "StartIPRotation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CompleteIPRotation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNodePoolSize": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNetworkPolicy": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetMaintenancePolicy": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/container/google/cloud/container_v1/gapic/enums.py b/container/google/cloud/container_v1/gapic/enums.py
new file mode 100644
index 000000000000..8acee05156cc
--- /dev/null
+++ b/container/google/cloud/container_v1/gapic/enums.py
@@ -0,0 +1,176 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Cluster(object):
+    class Status(enum.IntEnum):
+        """
+        The current status of the cluster.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int): Not set.
+          PROVISIONING (int): The PROVISIONING state indicates the cluster is being created.
+          RUNNING (int): The RUNNING state indicates the cluster has been created and is fully
+          usable.
+          RECONCILING (int): The RECONCILING state indicates that some work is actively being done on
+          the cluster, such as upgrading the master or node software. Details can
+          be found in the ``statusMessage`` field.
+          STOPPING (int): The STOPPING state indicates the cluster is being deleted.
+          ERROR (int): The ERROR state indicates the cluster may be unusable. Details can be
+          found in the ``statusMessage`` field.
+          DEGRADED (int): The DEGRADED state indicates the cluster requires user action to restore
+          full functionality. Details can be found in the ``statusMessage`` field.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        PROVISIONING = 1
+        RUNNING = 2
+        RECONCILING = 3
+        STOPPING = 4
+        ERROR = 5
+        DEGRADED = 6
+
+
+class NetworkPolicy(object):
+    class Provider(enum.IntEnum):
+        """
+        Allowed Network Policy providers.
+
+        Attributes:
+          PROVIDER_UNSPECIFIED (int): Not set
+          CALICO (int): Tigera (Calico Felix).
+        """
+
+        PROVIDER_UNSPECIFIED = 0
+        CALICO = 1
+
+
+class NodePool(object):
+    class Status(enum.IntEnum):
+        """
+        The current status of the node pool instance.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int): Not set.
+          PROVISIONING (int): The PROVISIONING state indicates the node pool is being created.
+          RUNNING (int): The RUNNING state indicates the node pool has been created
+          and is fully usable.
+          RUNNING_WITH_ERROR (int): The RUNNING\_WITH\_ERROR state indicates the node pool has been created
+          and is partially usable. Some error state has occurred and some
+          functionality may be impaired. Customer may need to reissue a request or
+          trigger a new update.
+          RECONCILING (int): The RECONCILING state indicates that some work is actively being done on
+          the node pool, such as upgrading node software. Details can be found in
+          the ``statusMessage`` field.
+          STOPPING (int): The STOPPING state indicates the node pool is being deleted.
+          ERROR (int): The ERROR state indicates the node pool may be unusable. Details can be
+          found in the ``statusMessage`` field.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        PROVISIONING = 1
+        RUNNING = 2
+        RUNNING_WITH_ERROR = 3
+        RECONCILING = 4
+        STOPPING = 5
+        ERROR = 6
+
+
+class Operation(object):
+    class Status(enum.IntEnum):
+        """
+        Current status of the operation.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int): Not set.
+          PENDING (int): The operation has been created.
+          RUNNING (int): The operation is currently running.
+          DONE (int): The operation is done, either cancelled or completed.
+          ABORTING (int): The operation is aborting.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+        ABORTING = 4
+
+    class Type(enum.IntEnum):
+        """
+        Operation type.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Not set.
+          CREATE_CLUSTER (int): Cluster create.
+          DELETE_CLUSTER (int): Cluster delete.
+          UPGRADE_MASTER (int): A master upgrade.
+          UPGRADE_NODES (int): A node upgrade.
+          REPAIR_CLUSTER (int): Cluster repair.
+          UPDATE_CLUSTER (int): Cluster update.
+          CREATE_NODE_POOL (int): Node pool create.
+          DELETE_NODE_POOL (int): Node pool delete.
+          SET_NODE_POOL_MANAGEMENT (int): Set node pool management.
+          AUTO_REPAIR_NODES (int): Automatic node pool repair.
+          AUTO_UPGRADE_NODES (int): Automatic node upgrade.
+          SET_LABELS (int): Set labels.
+          SET_MASTER_AUTH (int): Set/generate master auth materials
+          SET_NODE_POOL_SIZE (int): Set node pool size.
+          SET_NETWORK_POLICY (int): Updates network policy for a cluster.
+          SET_MAINTENANCE_POLICY (int): Set the maintenance policy.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        CREATE_CLUSTER = 1
+        DELETE_CLUSTER = 2
+        UPGRADE_MASTER = 3
+        UPGRADE_NODES = 4
+        REPAIR_CLUSTER = 5
+        UPDATE_CLUSTER = 6
+        CREATE_NODE_POOL = 7
+        DELETE_NODE_POOL = 8
+        SET_NODE_POOL_MANAGEMENT = 9
+        AUTO_REPAIR_NODES = 10
+        AUTO_UPGRADE_NODES = 11
+        SET_LABELS = 12
+        SET_MASTER_AUTH = 13
+        SET_NODE_POOL_SIZE = 14
+        SET_NETWORK_POLICY = 15
+        SET_MAINTENANCE_POLICY = 16
+
+
+class SetMasterAuthRequest(object):
+    class Action(enum.IntEnum):
+        """
+        Operation type: what type update to perform.
+
+        Attributes:
+          UNKNOWN (int): Operation is unknown and will error out.
+          SET_PASSWORD (int): Set the password to a user generated value.
+          GENERATE_PASSWORD (int): Generate a new password and set it to that.
+          SET_USERNAME (int): Set the username.  If an empty username is provided, basic authentication
+          is disabled for the cluster.  If a non-empty username is provided, basic
+          authentication is enabled, with either a provided password or a generated
+          one.
+        """
+
+        UNKNOWN = 0
+        SET_PASSWORD = 1
+        GENERATE_PASSWORD = 2
+        SET_USERNAME = 3
diff --git a/container/google/cloud/container_v1/gapic/transports/__init__.py b/container/google/cloud/container_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/container/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py b/container/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py
new file mode 100644
index 000000000000..cb838808f062
--- /dev/null
+++ b/container/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py
@@ -0,0 +1,521 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.container_v1.proto import cluster_service_pb2_grpc
+
+
+class ClusterManagerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.container.v1 ClusterManager API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="container.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "cluster_manager_stub": cluster_service_pb2_grpc.ClusterManagerStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="container.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_clusters(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_clusters`.
+
+        Lists all clusters owned by a project in either the specified zone or all
+        zones.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListClusters
+
+    @property
+    def get_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_cluster`.
+
+        Gets the details of a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetCluster
+
+    @property
+    def create_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.create_cluster`.
+
+        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 <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 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CreateCluster
+
+    @property
+    def update_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.update_cluster`.
+
+        Updates the settings of a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].UpdateCluster
+
+    @property
+    def update_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.update_node_pool`.
+
+        Updates the version and/or image type for a specific node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].UpdateNodePool
+
+    @property
+    def set_node_pool_autoscaling(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_autoscaling`.
+
+        Sets the autoscaling settings for a specific node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNodePoolAutoscaling
+
+    @property
+    def set_logging_service(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_logging_service`.
+
+        Sets the logging service for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLoggingService
+
+    @property
+    def set_monitoring_service(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_monitoring_service`.
+
+        Sets the monitoring service for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetMonitoringService
+
+    @property
+    def set_addons_config(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_addons_config`.
+
+        Sets the addons for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetAddonsConfig
+
+    @property
+    def set_locations(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_locations`.
+
+        Sets the locations for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLocations
+
+    @property
+    def update_master(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.update_master`.
+
+        Updates the master for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].UpdateMaster
+
+    @property
+    def set_master_auth(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_master_auth`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetMasterAuth
+
+    @property
+    def delete_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.delete_cluster`.
+
+        Deletes the cluster, including the Kubernetes endpoint and all worker
+        nodes.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].DeleteCluster
+
+    @property
+    def list_operations(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_operations`.
+
+        Lists all operations in a project in a specific zone or all zones.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListOperations
+
+    @property
+    def get_operation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_operation`.
+
+        Gets the specified operation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetOperation
+
+    @property
+    def cancel_operation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.cancel_operation`.
+
+        Cancels the specified operation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CancelOperation
+
+    @property
+    def get_server_config(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_server_config`.
+
+        Returns configuration info about the Kubernetes Engine service.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetServerConfig
+
+    @property
+    def list_node_pools(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_node_pools`.
+
+        Lists the node pools for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListNodePools
+
+    @property
+    def get_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_node_pool`.
+
+        Retrieves the node pool requested.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetNodePool
+
+    @property
+    def create_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.create_node_pool`.
+
+        Creates a node pool for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CreateNodePool
+
+    @property
+    def delete_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.delete_node_pool`.
+
+        Deletes a node pool from a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].DeleteNodePool
+
+    @property
+    def rollback_node_pool_upgrade(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.rollback_node_pool_upgrade`.
+
+        Roll back the previously Aborted or Failed NodePool upgrade.
+        This will be an no-op if the last upgrade successfully completed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].RollbackNodePoolUpgrade
+
+    @property
+    def set_node_pool_management(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_management`.
+
+        Sets the NodeManagement options for a node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNodePoolManagement
+
+    @property
+    def set_labels(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_labels`.
+
+        Sets labels on a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLabels
+
+    @property
+    def set_legacy_abac(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_legacy_abac`.
+
+        Enables or disables the ABAC authorization mechanism on a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLegacyAbac
+
+    @property
+    def start_i_p_rotation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.start_i_p_rotation`.
+
+        Start master IP rotation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].StartIPRotation
+
+    @property
+    def complete_i_p_rotation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.complete_i_p_rotation`.
+
+        Completes master IP rotation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CompleteIPRotation
+
+    @property
+    def set_node_pool_size(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_size`.
+
+        Sets the size for a specific node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNodePoolSize
+
+    @property
+    def set_network_policy(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_network_policy`.
+
+        Enables/Disables Network Policy for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNetworkPolicy
+
+    @property
+    def set_maintenance_policy(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_maintenance_policy`.
+
+        Sets the maintenance policy for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetMaintenancePolicy
diff --git a/container/google/cloud/container_v1/proto/__init__.py b/container/google/cloud/container_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/container/google/cloud/container_v1/proto/cluster_service.proto b/container/google/cloud/container_v1/proto/cluster_service.proto
new file mode 100644
index 000000000000..db7744d04e8e
--- /dev/null
+++ b/container/google/cloud/container_v1/proto/cluster_service.proto
@@ -0,0 +1,2214 @@
+// 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.container.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/empty.proto";
+
+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";
+
+
+// Google Kubernetes Engine Cluster Manager v1
+service ClusterManager {
+  // Lists all clusters owned by a project in either the specified zone or all
+  // zones.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/clusters"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/clusters"
+      }
+    };
+  }
+
+  // Gets the details of a specific cluster.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/clusters/*}"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/clusters/{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).
+  //
+  // One firewall is added for the cluster. After cluster creation,
+  // the cluster 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.
+  rpc CreateCluster(CreateClusterRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/clusters"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the settings of a specific cluster.
+  rpc UpdateCluster(UpdateClusterRequest) returns (Operation) {
+    option (google.api.http) = {
+      put: "/v1/{name=projects/*/locations/*/clusters/*}"
+      body: "*"
+      additional_bindings {
+        put: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the version and/or image type for a specific node pool.
+  rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation) {
+    option (google.api.http) = {
+      put: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/update"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the autoscaling settings for a specific node pool.
+  rpc SetNodePoolAutoscaling(SetNodePoolAutoscalingRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/autoscaling"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the logging service for a specific cluster.
+  rpc SetLoggingService(SetLoggingServiceRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setLogging"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/logging"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the monitoring service for a specific cluster.
+  rpc SetMonitoringService(SetMonitoringServiceRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setMonitoring"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/monitoring"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the addons for a specific cluster.
+  rpc SetAddonsConfig(SetAddonsConfigRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setAddons"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/addons"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the locations for a specific cluster.
+  rpc SetLocations(SetLocationsRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setLocations"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/locations"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the master for a specific cluster.
+  rpc UpdateMaster(UpdateMasterRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:updateMaster"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/master"
+        body: "*"
+      }
+    };
+  }
+
+  // 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.
+  rpc SetMasterAuth(SetMasterAuthRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setMasterAuth"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMasterAuth"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes the cluster, including the Kubernetes endpoint and all worker
+  // nodes.
+  //
+  // 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.
+  rpc DeleteCluster(DeleteClusterRequest) returns (Operation) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/clusters/*}"
+      additional_bindings {
+        delete: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+      }
+    };
+  }
+
+  // Lists all operations in a project in a specific zone or all zones.
+  rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/operations"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/operations"
+      }
+    };
+  }
+
+  // Gets the specified operation.
+  rpc GetOperation(GetOperationRequest) returns (Operation) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/operations/*}"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}"
+      }
+    };
+  }
+
+  // Cancels the specified operation.
+  rpc CancelOperation(CancelOperationRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/operations/*}:cancel"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}:cancel"
+        body: "*"
+      }
+    };
+  }
+
+  // Returns configuration info about the Kubernetes Engine service.
+  rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*}/serverConfig"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/serverconfig"
+      }
+    };
+  }
+
+  // Lists the node pools for a cluster.
+  rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/clusters/*}/nodePools"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
+      }
+    };
+  }
+
+  // Retrieves the node pool requested.
+  rpc GetNodePool(GetNodePoolRequest) returns (NodePool) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
+      additional_bindings {
+        get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+      }
+    };
+  }
+
+  // Creates a node pool for a cluster.
+  rpc CreateNodePool(CreateNodePoolRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/clusters/*}/nodePools"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes a node pool from a cluster.
+  rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
+      additional_bindings {
+        delete: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+      }
+    };
+  }
+
+  // Roll back the previously Aborted or Failed NodePool upgrade.
+  // This will be an no-op if the last upgrade successfully completed.
+  rpc RollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}:rollback"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the NodeManagement options for a node pool.
+  rpc SetNodePoolManagement(SetNodePoolManagementRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setManagement"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setManagement"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets labels on a cluster.
+  rpc SetLabels(SetLabelsRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setResourceLabels"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels"
+        body: "*"
+      }
+    };
+  }
+
+  // Enables or disables the ABAC authorization mechanism on a cluster.
+  rpc SetLegacyAbac(SetLegacyAbacRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac"
+        body: "*"
+      }
+    };
+  }
+
+  // Start master IP rotation.
+  rpc StartIPRotation(StartIPRotationRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:startIpRotation"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:startIpRotation"
+        body: "*"
+      }
+    };
+  }
+
+  // Completes master IP rotation.
+  rpc CompleteIPRotation(CompleteIPRotationRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:completeIpRotation"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:completeIpRotation"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the size for a specific node pool.
+  rpc SetNodePoolSize(SetNodePoolSizeRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setSize"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setSize"
+        body: "*"
+      }
+    };
+  }
+
+  // Enables/Disables Network Policy for a cluster.
+  rpc SetNetworkPolicy(SetNetworkPolicyRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setNetworkPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the maintenance policy for a cluster.
+  rpc SetMaintenancePolicy(SetMaintenancePolicyRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/clusters/*}:setMaintenancePolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMaintenancePolicy"
+        body: "*"
+      }
+    };
+  }
+}
+
+// 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.
+  // `n1-standard-1`).
+  //
+  // If unspecified, the default machine type is
+  // `n1-standard-1`.
+  string machine_type = 1;
+
+  // Size of the disk attached to each node, specified in GB.
+  // The smallest allowed disk size is 10GB.
+  //
+  // If unspecified, the default disk size is 100GB.
+  int32 disk_size_gb = 2;
+
+  // The set of Google API scopes to be made available on all of the
+  // node VMs under the "default" service account.
+  //
+  // The following scopes are recommended, but not required, and by default are
+  // not included:
+  //
+  // * `https://www.googleapis.com/auth/compute` is required for mounting
+  // 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/)).
+  //
+  // If unspecified, no scopes are added, unless Cloud Logging or Cloud
+  // Monitoring are enabled, in which case their required scopes will be added.
+  repeated string oauth_scopes = 3;
+
+  // The Google Cloud Platform Service Account to be used by the node VMs. If
+  // no Service Account is specified, the "default" service account is used.
+  string service_account = 9;
+
+  // The metadata key/value pairs assigned to instances in the cluster.
+  //
+  // Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+  // in length. These are reflected as part of a URL in the metadata server.
+  // Additionally, to avoid ambiguity, keys must not conflict with any other
+  // metadata keys for the project or be one of the reserved keys:
+  //  "cluster-location"
+  //  "cluster-name"
+  //  "cluster-uid"
+  //  "configure-sh"
+  //  "enable-os-login"
+  //  "gci-update-strategy"
+  //  "gci-ensure-gke-docker"
+  //  "instance-template"
+  //  "kube-env"
+  //  "startup-script"
+  //  "user-data"
+  //
+  // 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.
+  //
+  // The total size of all keys and values must be less than 512 KB.
+  map<string, string> metadata = 4;
+
+  // The image type to use for this node. Note that for a given image type,
+  // the latest version of it will be used.
+  string image_type = 5;
+
+  // The map of Kubernetes labels (key/value pairs) to be applied to each node.
+  // These will added in addition to any default label(s) that
+  // Kubernetes may apply to the node.
+  // In case of conflict in label keys, the applied set may differ depending on
+  // the Kubernetes version -- it's best to assume the behavior is undefined
+  // and conflicts should be avoided.
+  // For more information, including usage and the valid values, see:
+  // https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+  map<string, string> labels = 6;
+
+  // The number of local SSD disks to be attached to the node.
+  //
+  // The limit for this value is dependant 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
+  // for more information.
+  int32 local_ssd_count = 7;
+
+  // The list of instance tags applied to all nodes. Tags are used to identify
+  // valid sources or targets for network firewalls and are specified by
+  // the client during cluster or node pool creation. Each tag within the list
+  // must comply with RFC1035.
+  repeated string tags = 8;
+
+  // Whether the nodes are created as preemptible VM instances. See:
+  // https://cloud.google.com/compute/docs/instances/preemptible for more
+  // information about preemptible VM instances.
+  bool preemptible = 10;
+
+  // A list of hardware accelerators to be attached to each node.
+  // See https://cloud.google.com/compute/docs/gpus for more information about
+  // support for GPUs.
+  repeated AcceleratorConfig accelerators = 11;
+
+  // Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+  //
+  // If unspecified, the default disk type is 'pd-standard'
+  string disk_type = 12;
+
+  // Minimum CPU platform to be used by this instance. The instance may be
+  // scheduled on the specified or newer CPU platform. Applicable values are the
+  // friendly names of CPU platforms, such as
+  // <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+  // <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+  // information, read [how to specify min CPU
+  // platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+  string min_cpu_platform = 13;
+}
+
+// The authentication information for accessing the master endpoint.
+// Authentication can be done using HTTP basic auth or using client
+// 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.
+  string username = 1;
+
+  // The password to use for HTTP basic authentication to the master endpoint.
+  // Because the master endpoint is open to the Internet, you should create a
+  // strong password.  If a password is provided for cluster creation, username
+  // must be non-empty.
+  string password = 2;
+
+  // Configuration for client certificate authentication on the cluster. For
+  // clusters before v1.12, if no configuration is specified, a client
+  // certificate is issued.
+  ClientCertificateConfig client_certificate_config = 3;
+
+  // [Output only] Base64-encoded public certificate that is the root of
+  // trust for the cluster.
+  string cluster_ca_certificate = 100;
+
+  // [Output only] Base64-encoded public certificate used by clients to
+  // authenticate to the cluster endpoint.
+  string client_certificate = 101;
+
+  // [Output only] Base64-encoded private key used by clients to authenticate
+  // to the cluster endpoint.
+  string client_key = 102;
+}
+
+// Configuration for client certificates on the cluster.
+message ClientCertificateConfig {
+  // Issue a client certificate.
+  bool issue_client_certificate = 1;
+}
+
+// Configuration for the addons that can be automatically spun up in the
+// cluster, enabling additional functionality.
+message AddonsConfig {
+  // Configuration for the HTTP (L7) load balancing controller addon, which
+  // makes it easy to set up HTTP load balancers for services in a cluster.
+  HttpLoadBalancing http_load_balancing = 1;
+
+  // Configuration for the horizontal pod autoscaling feature, which
+  // increases or decreases the number of replica pods a replication controller
+  // has based on the resource usage of the existing pods.
+  HorizontalPodAutoscaling horizontal_pod_autoscaling = 2;
+
+  // Configuration for the Kubernetes Dashboard.
+  KubernetesDashboard kubernetes_dashboard = 3;
+
+  // 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 options for the HTTP (L7) load balancing controller addon,
+// which makes it easy to set up HTTP load balancers for services in a cluster.
+message HttpLoadBalancing {
+  // Whether the HTTP Load Balancing controller is enabled in the cluster.
+  // When enabled, it runs a small pod in the cluster that manages the load
+  // balancers.
+  bool disabled = 1;
+}
+
+// Configuration options for the horizontal pod autoscaling feature, which
+// increases or decreases the number of replica pods a replication controller
+// has based on the resource usage of the existing pods.
+message HorizontalPodAutoscaling {
+  // Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+  // When enabled, it ensures that a Heapster pod is running in the cluster,
+  // which is also used by the Cloud Monitoring service.
+  bool disabled = 1;
+}
+
+// Configuration for the Kubernetes Dashboard.
+message KubernetesDashboard {
+  // Whether the Kubernetes Dashboard is enabled for this cluster.
+  bool disabled = 1;
+}
+
+// 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.
+message NetworkPolicyConfig {
+  // Whether NetworkPolicy is enabled for this cluster.
+  bool disabled = 1;
+}
+
+// Configuration options for private clusters.
+message PrivateClusterConfig {
+  // Whether nodes have internal IP addresses only. If enabled, all nodes are
+  // given only RFC 1918 private addresses and communicate with the master via
+  // private networking.
+  bool enable_private_nodes = 1;
+
+  // Whether the master's internal IP address is used as the cluster endpoint.
+  bool enable_private_endpoint = 2;
+
+  // The IP range in CIDR notation to use for the hosted master network. This
+  // range will be used for assigning internal IP addresses to the master or
+  // set of masters, as well as the ILB VIP. This range must not overlap with
+  // any other ranges in use within the cluster's network.
+  string master_ipv4_cidr_block = 3;
+
+  // Output only. The internal IP address of this cluster's master endpoint.
+  string private_endpoint = 4;
+
+  // Output only. The external IP address of this cluster's master endpoint.
+  string public_endpoint = 5;
+}
+
+// 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,
+// Google Compute Engine Public IPs and Google Prod IPs.
+message MasterAuthorizedNetworksConfig {
+  // CidrBlock contains an optional name and one CIDR block.
+  message CidrBlock {
+    // display_name is an optional field for users to identify CIDR blocks.
+    string display_name = 1;
+
+    // cidr_block must be specified in CIDR notation.
+    string cidr_block = 2;
+  }
+
+  // Whether or not master authorized networks is enabled.
+  bool enabled = 1;
+
+  // cidr_blocks define up to 10 external networks that could access
+  // Kubernetes master through HTTPS.
+  repeated CidrBlock cidr_blocks = 2;
+}
+
+// Configuration for the legacy Attribute Based Access Control authorization
+// mode.
+message LegacyAbac {
+  // Whether the ABAC authorizer is enabled for this cluster. When enabled,
+  // identities in the system, including service accounts, nodes, and
+  // controllers, will have statically granted permissions beyond those
+  // provided by the RBAC configuration or IAM.
+  bool enabled = 1;
+}
+
+// Configuration options for the NetworkPolicy feature.
+// https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+message NetworkPolicy {
+  // Allowed Network Policy providers.
+  enum Provider {
+    // Not set
+    PROVIDER_UNSPECIFIED = 0;
+
+    // Tigera (Calico Felix).
+    CALICO = 1;
+  }
+
+  // The selected network policy provider.
+  Provider provider = 1;
+
+  // Whether network policy is enabled on the cluster.
+  bool enabled = 2;
+}
+
+// Configuration for controlling how IPs are allocated in the cluster.
+message IPAllocationPolicy {
+  // Whether alias IPs will be used for pod IPs in the cluster.
+  bool use_ip_aliases = 1;
+
+  // Whether a new subnetwork will be created automatically for the cluster.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  bool create_subnetwork = 2;
+
+  // A custom subnetwork name to be used if `create_subnetwork` is true.  If
+  // this field is empty, then an automatic name will be chosen for the new
+  // subnetwork.
+  string subnetwork_name = 3;
+
+  // This field is deprecated, use cluster_ipv4_cidr_block.
+  string cluster_ipv4_cidr = 4 [deprecated = true];
+
+  // This field is deprecated, use node_ipv4_cidr_block.
+  string node_ipv4_cidr = 5 [deprecated = true];
+
+  // This field is deprecated, use services_ipv4_cidr_block.
+  string services_ipv4_cidr = 6 [deprecated = true];
+
+  // The name of the secondary range to be used for the cluster CIDR
+  // block.  The secondary range will be used for pod IP
+  // addresses. This must be an existing secondary range associated
+  // with the cluster subnetwork.
+  //
+  // This field is only applicable with use_ip_aliases is true and
+  // create_subnetwork is false.
+  string cluster_secondary_range_name = 7;
+
+  // The name of the secondary range to be used as for the services
+  // CIDR block.  The secondary range will be used for service
+  // ClusterIPs. This must be an existing secondary range associated
+  // with the cluster subnetwork.
+  //
+  // This field is only applicable with use_ip_aliases is true and
+  // create_subnetwork is false.
+  string services_secondary_range_name = 8;
+
+  // The IP address range for the cluster pod IPs. If this field is set, then
+  // `cluster.cluster_ipv4_cidr` must be left blank.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  //
+  // Set to blank to have a range chosen with 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 cluster_ipv4_cidr_block = 9;
+
+  // The IP address range of the instance IPs in this cluster.
+  //
+  // This is applicable only if `create_subnetwork` is true.
+  //
+  // Set to blank to have a range chosen with 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 node_ipv4_cidr_block = 10;
+
+  // The IP address range of the services IPs in this cluster. If blank, a range
+  // will be automatically chosen with the default size.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  //
+  // Set to blank to have a range chosen with 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 services_ipv4_cidr_block = 11;
+}
+
+// A Google Kubernetes Engine cluster.
+message Cluster {
+  // The current status of the cluster.
+  enum Status {
+    // Not set.
+    STATUS_UNSPECIFIED = 0;
+
+    // The PROVISIONING state indicates the cluster is being created.
+    PROVISIONING = 1;
+
+    // The RUNNING state indicates the cluster has been created and is fully
+    // usable.
+    RUNNING = 2;
+
+    // The RECONCILING state indicates that some work is actively being done on
+    // the cluster, such as upgrading the master or node software. Details can
+    // be found in the `statusMessage` field.
+    RECONCILING = 3;
+
+    // The STOPPING state indicates the cluster is being deleted.
+    STOPPING = 4;
+
+    // The ERROR state indicates the cluster may be unusable. Details
+    // can be found in the `statusMessage` field.
+    ERROR = 5;
+
+    // The DEGRADED state indicates the cluster requires user action to restore
+    // full functionality. Details can be found in the `statusMessage` field.
+    DEGRADED = 6;
+  }
+
+  // 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:
+  //
+  // * Lowercase letters, numbers, and hyphens only.
+  // * Must start with a letter.
+  // * Must end with a number or a letter.
+  string name = 1;
+
+  // An optional description of this cluster.
+  string description = 2;
+
+  // The number of nodes to create in this cluster. You must ensure that your
+  // Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+  // is sufficient for this number of instances. You must also have available
+  // firewall and routes quota.
+  // For requests, this field should only be used in lieu of a
+  // "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;
+
+  // 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.
+  //
+  // If unspecified, the defaults are used.
+  NodeConfig node_config = 4;
+
+  // The authentication information for accessing the master endpoint.
+  MasterAuth master_auth = 5;
+
+  // The logging service the cluster should use to write logs.
+  // Currently available options:
+  //
+  // * `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.
+  string logging_service = 6;
+
+  // 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.
+  // * if left as an empty string, `monitoring.googleapis.com` will be used.
+  string monitoring_service = 7;
+
+  // The name of the Google Compute Engine
+  // [network](/compute/docs/networks-and-firewalls#networks) to which the
+  // cluster is connected. If left unspecified, the `default` network
+  // will be used.
+  string network = 8;
+
+  // The IP address range of the container pods in this cluster, in
+  // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+  // notation (e.g. `10.96.0.0/14`). Leave blank to have
+  // one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+  string cluster_ipv4_cidr = 9;
+
+  // Configurations for the various addons available to run in the cluster.
+  AddonsConfig addons_config = 10;
+
+  // The name of the Google Compute Engine
+  // [subnetwork](/compute/docs/subnetworks) to which the
+  // cluster is connected.
+  string subnetwork = 11;
+
+  // The node pools associated with this cluster.
+  // This field should not be set if "node_config" or "initial_node_count" are
+  // specified.
+  repeated NodePool node_pools = 12;
+
+  // The list of Google Compute Engine
+  // [locations](/compute/docs/zones#available) in which the cluster's nodes
+  // should be located.
+  repeated string locations = 13;
+
+  // Kubernetes alpha features are enabled on this cluster. This includes alpha
+  // API groups (e.g. v1alpha1) and features that may not be production ready in
+  // the kubernetes version of the master and nodes.
+  // The cluster has no SLA for uptime and master/node upgrades are disabled.
+  // Alpha enabled clusters are automatically deleted thirty days after
+  // creation.
+  bool enable_kubernetes_alpha = 14;
+
+  // The resource labels for the cluster to use to annotate any related
+  // Google Compute Engine resources.
+  map<string, string> resource_labels = 15;
+
+  // The fingerprint of the set of labels for this cluster.
+  string label_fingerprint = 16;
+
+  // Configuration for the legacy ABAC authorization mode.
+  LegacyAbac legacy_abac = 18;
+
+  // Configuration options for the NetworkPolicy feature.
+  NetworkPolicy network_policy = 19;
+
+  // Configuration for cluster IP allocation.
+  IPAllocationPolicy ip_allocation_policy = 20;
+
+  // The configuration options for master authorized networks feature.
+  MasterAuthorizedNetworksConfig master_authorized_networks_config = 22;
+
+  // Configure the maintenance policy for this cluster.
+  MaintenancePolicy maintenance_policy = 23;
+
+  // Configuration for cluster networking.
+  NetworkConfig network_config = 27;
+
+  // Configuration for private cluster.
+  PrivateClusterConfig private_cluster_config = 37;
+
+  // [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
+  // resides.
+  // This field is deprecated, use location instead.
+  string zone = 101 [deprecated = true];
+
+  // [Output only] The IP address of this cluster's master endpoint.
+  // The endpoint can be accessed from the internet at
+  // `https://username:password@endpoint/`.
+  //
+  // See the `masterAuth` property of this resource for username and
+  // password information.
+  string endpoint = 102;
+
+  // The initial Kubernetes version for this cluster.  Valid versions are those
+  // found in validMasterVersions returned by getServerConfig.  The version can
+  // be upgraded over time; such upgrades are reflected in
+  // currentMasterVersion and currentNodeVersion.
+  //
+  // Users may specify either explicit versions offered by
+  // Kubernetes Engine or version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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 initial_cluster_version = 103;
+
+  // [Output only] The current software version of the master endpoint.
+  string current_master_version = 104;
+
+  // [Output only] Deprecated, use
+  // [NodePool.version](/kubernetes-engine/docs/reference/rest/v1/projects.zones.clusters.nodePool)
+  // 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.
+  string current_node_version = 105 [deprecated = true];
+
+  // [Output only] The time the cluster was created, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string create_time = 106;
+
+  // [Output only] The current status of this cluster.
+  Status status = 107;
+
+  // [Output only] Additional information about the current status of this
+  // cluster, if available.
+  string status_message = 108;
+
+  // [Output only] The size of the address space on each node for hosting
+  // containers. This is provisioned from within the `container_ipv4_cidr`
+  // range.
+  int32 node_ipv4_cidr_size = 109;
+
+  // [Output only] The IP address range of the Kubernetes services in
+  // this cluster, in
+  // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+  // notation (e.g. `1.2.3.4/29`). Service addresses are
+  // typically put in the last `/16` from the container CIDR.
+  string services_ipv4_cidr = 110;
+
+  // 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 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
+  // the cluster resides.
+  string location = 114;
+}
+
+// ClusterUpdate describes an update to the cluster. Exactly one update can
+// be applied to a cluster with each request, so at most one field can be
+// provided.
+message ClusterUpdate {
+  // The Kubernetes version to change the nodes to (typically an
+  // upgrade).
+  //
+  // Users may specify either explicit versions offered by
+  // Kubernetes Engine or version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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 desired_node_version = 4;
+
+  // 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 desired_monitoring_service = 5;
+
+  // Configurations for the various addons available to run in the cluster.
+  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.
+  string desired_node_pool_id = 7;
+
+  // The desired image type for the node pool.
+  // NOTE: Set the "desired_node_pool" field as well.
+  string desired_image_type = 8;
+
+  // 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
+  // the change applies to that single node pool.
+  NodePoolAutoscaling desired_node_pool_autoscaling = 9;
+
+  // The desired list of Google Compute Engine
+  // [locations](/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 desired_locations = 10;
+
+  // The desired configuration options for master authorized networks feature.
+  MasterAuthorizedNetworksConfig desired_master_authorized_networks_config = 12;
+
+  // 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:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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 desired_master_version = 100;
+}
+
+// This operation resource represents operations that may have happened or are
+// happening on the cluster. All fields are output only.
+message Operation {
+  // Current status of the operation.
+  enum Status {
+    // Not set.
+    STATUS_UNSPECIFIED = 0;
+
+    // The operation has been created.
+    PENDING = 1;
+
+    // The operation is currently running.
+    RUNNING = 2;
+
+    // The operation is done, either cancelled or completed.
+    DONE = 3;
+
+    // The operation is aborting.
+    ABORTING = 4;
+  }
+
+  // Operation type.
+  enum Type {
+    // Not set.
+    TYPE_UNSPECIFIED = 0;
+
+    // Cluster create.
+    CREATE_CLUSTER = 1;
+
+    // Cluster delete.
+    DELETE_CLUSTER = 2;
+
+    // A master upgrade.
+    UPGRADE_MASTER = 3;
+
+    // A node upgrade.
+    UPGRADE_NODES = 4;
+
+    // Cluster repair.
+    REPAIR_CLUSTER = 5;
+
+    // Cluster update.
+    UPDATE_CLUSTER = 6;
+
+    // Node pool create.
+    CREATE_NODE_POOL = 7;
+
+    // Node pool delete.
+    DELETE_NODE_POOL = 8;
+
+    // Set node pool management.
+    SET_NODE_POOL_MANAGEMENT = 9;
+
+    // Automatic node pool repair.
+    AUTO_REPAIR_NODES = 10;
+
+    // Automatic node upgrade.
+    AUTO_UPGRADE_NODES = 11;
+
+    // Set labels.
+    SET_LABELS = 12;
+
+    // Set/generate master auth materials
+    SET_MASTER_AUTH = 13;
+
+    // Set node pool size.
+    SET_NODE_POOL_SIZE = 14;
+
+    // Updates network policy for a cluster.
+    SET_NETWORK_POLICY = 15;
+
+    // Set the maintenance policy.
+    SET_MAINTENANCE_POLICY = 16;
+  }
+
+  // The server-assigned ID for the operation.
+  string name = 1;
+
+  // The name of the Google Compute Engine
+  // [zone](/compute/docs/zones#available) in which the operation
+  // is taking place.
+  // This field is deprecated, use location instead.
+  string zone = 2 [deprecated = true];
+
+  // The operation type.
+  Type operation_type = 3;
+
+  // The current status of the operation.
+  Status status = 4;
+
+  // Detailed operation progress, if available.
+  string detail = 8;
+
+  // If an error has occurred, a textual description of the error.
+  string status_message = 5;
+
+  // Server-defined URL for the resource.
+  string self_link = 6;
+
+  // Server-defined URL for the target of the 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
+  // the cluster resides.
+  string location = 9;
+
+  // [Output only] The time the operation started, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string start_time = 10;
+
+  // [Output only] The time the operation completed, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string end_time = 11;
+}
+
+// CreateClusterRequest creates a cluster.
+message CreateClusterRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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;
+
+  // The parent (project and location) where the cluster will be created.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, cluster) of the cluster to retrieve.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // A description of the update.
+  ClusterUpdate update = 4;
+
+  // The name (project, location, cluster) of the cluster to update.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 5;
+}
+
+// UpdateNodePoolRequests update a node pool's image and/or version.
+message UpdateNodePoolRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // The Kubernetes version to change the nodes to (typically an
+  // upgrade).
+  //
+  // Users may specify either explicit versions offered by Kubernetes Engine or
+  // version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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;
+
+  // The desired image type for the node pool.
+  string image_type = 6;
+
+  // The name (project, location, cluster, node pool) of the node pool to
+  // update. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // Autoscaling configuration for the node pool.
+  NodePoolAutoscaling autoscaling = 5;
+
+  // The name (project, location, cluster, node pool) of the node pool to set
+  // autoscaler settings. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/compute/docs/zones#available) in which the cluster
+  // resides.
+  // This field has been deprecated and replaced by the name field.
+  string zone = 2;
+
+  // 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.
+  // Currently available options:
+  //
+  // * "logging.googleapis.com" - the Google Cloud Logging service
+  // * "none" - no metrics will be exported from the cluster
+  string logging_service = 4;
+
+  // The name (project, location, cluster) of the cluster to set logging.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 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;
+
+  // The name (project, location, cluster) of the cluster to set monitoring.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 6;
+}
+
+// SetAddonsConfigRequest sets the addons associated with the cluster.
+message SetAddonsConfigRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 desired configurations for the various addons available to run in the
+  // cluster.
+  AddonsConfig addons_config = 4;
+
+  // The name (project, location, cluster) of the cluster to set addons.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 desired list of Google Compute Engine
+  // [locations](/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;
+
+  // The name (project, location, cluster) of the cluster to set locations.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 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:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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;
+
+  // The name (project, location, cluster) of the cluster to update.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 7;
+}
+
+// SetMasterAuthRequest updates the admin password of a cluster.
+message SetMasterAuthRequest {
+  // Operation type: what type update to perform.
+  enum Action {
+    // Operation is unknown and will error out.
+    UNKNOWN = 0;
+
+    // Set the password to a user generated value.
+    SET_PASSWORD = 1;
+
+    // Generate a new password and set it to that.
+    GENERATE_PASSWORD = 2;
+
+    // Set the username.  If an empty username is provided, basic authentication
+    // is disabled for the cluster.  If a non-empty username is provided, basic
+    // authentication is enabled, with either a provided password or a generated
+    // one.
+    SET_USERNAME = 3;
+  }
+
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 exact form of action to be taken on the master auth.
+  Action action = 4;
+
+  // A description of the update.
+  MasterAuth update = 5;
+
+  // The name (project, location, cluster) of the cluster to set auth.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, cluster) of the cluster to delete.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 4;
+}
+
+// ListClustersRequest lists clusters.
+message ListClustersRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/*'.
+  // Location "-" matches all zones and all regions.
+  string parent = 4;
+}
+
+// ListClustersResponse is the result of ListClustersRequest.
+message ListClustersResponse {
+  // A list of clusters in the project in the specified zone, or
+  // across all ones.
+  repeated Cluster clusters = 1;
+
+  // If any zones are listed here, the list of clusters returned
+  // may be missing those zones.
+  repeated string missing_zones = 2;
+}
+
+// GetOperationRequest gets a single operation.
+message GetOperationRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, operation id) of the operation to get.
+  // Specified in the format 'projects/*/locations/*/operations/*'.
+  string name = 5;
+}
+
+// ListOperationsRequest lists operations.
+message ListOperationsRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/*'.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, operation id) of the operation to cancel.
+  // Specified in the format 'projects/*/locations/*/operations/*'.
+  string name = 4;
+}
+
+// ListOperationsResponse is the result of ListOperationsRequest.
+message ListOperationsResponse {
+  // A list of operations in the project in the specified zone.
+  repeated Operation operations = 1;
+
+  // If any zones are listed here, the list of operations returned
+  // may be missing the operations from those zones.
+  repeated string missing_zones = 2;
+}
+
+// Gets the current Kubernetes Engine service configuration.
+message GetServerConfigRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/*'.
+  string name = 4;
+}
+
+// Kubernetes Engine service configuration.
+message ServerConfig {
+  // Version of Kubernetes the service deploys by default.
+  string default_cluster_version = 1;
+
+  // List of valid node upgrade target versions.
+  repeated string valid_node_versions = 3;
+
+  // Default image type.
+  string default_image_type = 4;
+
+  // List of valid image types.
+  repeated string valid_image_types = 5;
+
+  // List of valid master versions.
+  repeated string valid_master_versions = 6;
+}
+
+// CreateNodePoolRequest creates a node pool for a cluster.
+message CreateNodePoolRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // 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;
+
+  // The parent (project, location, cluster id) where the node pool will be
+  // created. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  string cluster_id = 3 [deprecated = true];
+
+  // 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];
+
+  // The name (project, location, cluster, node pool id) of the node pool to
+  // delete. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the parent field.
+  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/*'.
+  string parent = 5;
+}
+
+// GetNodePoolRequest retrieves a node pool for a cluster.
+message GetNodePoolRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  string cluster_id = 3 [deprecated = true];
+
+  // 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];
+
+  // The name (project, location, cluster, node pool id) of the node pool to
+  // get. Specified in the format
+  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  string name = 6;
+}
+
+// NodePool contains the name and configuration for a cluster's node pool.
+// Node pools are a set of nodes (i.e. VM's), with a common configuration and
+// specification, under the control of the cluster master. They may have a set
+// of Kubernetes labels applied to them, which may be used to reference them
+// during pod scheduling. They may also be resized up or down, to accommodate
+// the workload.
+message NodePool {
+  // The current status of the node pool instance.
+  enum Status {
+    // Not set.
+    STATUS_UNSPECIFIED = 0;
+
+    // The PROVISIONING state indicates the node pool is being created.
+    PROVISIONING = 1;
+
+    // The RUNNING state indicates the node pool has been created
+    // and is fully usable.
+    RUNNING = 2;
+
+    // The RUNNING_WITH_ERROR state indicates the node pool has been created
+    // and is partially usable. Some error state has occurred and some
+    // functionality may be impaired. Customer may need to reissue a request
+    // or trigger a new update.
+    RUNNING_WITH_ERROR = 3;
+
+    // The RECONCILING state indicates that some work is actively being done on
+    // the node pool, such as upgrading node software. Details can
+    // be found in the `statusMessage` field.
+    RECONCILING = 4;
+
+    // The STOPPING state indicates the node pool is being deleted.
+    STOPPING = 5;
+
+    // The ERROR state indicates the node pool may be unusable. Details
+    // can be found in the `statusMessage` field.
+    ERROR = 6;
+  }
+
+  // The name of the node pool.
+  string name = 1;
+
+  // The node configuration of the pool.
+  NodeConfig config = 2;
+
+  // The initial node count for the pool. You must ensure that your
+  // Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+  // is sufficient for this number of instances. You must also have available
+  // firewall and routes quota.
+  int32 initial_node_count = 3;
+
+  // [Output only] Server-defined URL for the resource.
+  string self_link = 100;
+
+  // The version of the Kubernetes of this node.
+  string version = 101;
+
+  // [Output only] The resource URLs of the [managed instance
+  // groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+  // associated with this node pool.
+  repeated string instance_group_urls = 102;
+
+  // [Output only] The status of the nodes in this pool instance.
+  Status status = 103;
+
+  // [Output only] Additional information about the current status of this
+  // node pool instance, if available.
+  string status_message = 104;
+
+  // Autoscaler configuration for this NodePool. Autoscaler is enabled
+  // only if a valid configuration is present.
+  NodePoolAutoscaling autoscaling = 4;
+
+  // NodeManagement configuration for this NodePool.
+  NodeManagement management = 5;
+}
+
+// NodeManagement defines the set of node management services turned on for the
+// node pool.
+message NodeManagement {
+  // A flag that specifies whether node auto-upgrade is enabled for the node
+  // pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+  // up to date with the latest release version of Kubernetes.
+  bool auto_upgrade = 1;
+
+  // A flag that specifies whether the node auto-repair is enabled for the node
+  // pool. If enabled, the nodes in this node pool will be monitored and, if
+  // they fail health checks too many times, an automatic repair action will be
+  // triggered.
+  bool auto_repair = 2;
+
+  // Specifies the Auto Upgrade knobs for the node pool.
+  AutoUpgradeOptions upgrade_options = 10;
+}
+
+// AutoUpgradeOptions defines the set of options for the user to control how
+// the Auto Upgrades will proceed.
+message AutoUpgradeOptions {
+  // [Output only] This field is set when upgrades are about to commence
+  // with the approximate start time for the upgrades, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string auto_upgrade_start_time = 1;
+
+  // [Output only] This field is set when upgrades are about to commence
+  // with the description of the upgrade.
+  string description = 2;
+}
+
+// MaintenancePolicy defines the maintenance policy to be used for the cluster.
+message MaintenancePolicy {
+  // Specifies the maintenance window in which maintenance may be performed.
+  MaintenanceWindow window = 1;
+}
+
+// MaintenanceWindow defines the maintenance window to be used for the cluster.
+message MaintenanceWindow {
+  oneof policy {
+    // DailyMaintenanceWindow specifies a daily maintenance operation window.
+    DailyMaintenanceWindow daily_maintenance_window = 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.
+  string start_time = 2;
+
+  // [Output only] Duration of the time window, automatically chosen to be
+  // smallest possible in the given scenario.
+  // Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+  // format "PTnHnMnS".
+  string duration = 3;
+}
+
+// SetNodePoolManagementRequest sets the node management properties of a node
+// pool.
+message SetNodePoolManagementRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // NodeManagement configuration for the node pool.
+  NodeManagement management = 5;
+
+  // The name (project, location, cluster, node pool id) of the node pool to set
+  // management properties. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // The desired node count for the pool.
+  int32 node_count = 5;
+
+  // The name (project, location, cluster, node pool id) of the node pool to set
+  // size.
+  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  string name = 7;
+}
+
+// RollbackNodePoolUpgradeRequest rollbacks the previously Aborted or Failed
+// 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // The name (project, location, cluster, node pool id) of the node poll to
+  // rollback upgrade.
+  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  string name = 6;
+}
+
+// ListNodePoolsResponse is the result of ListNodePoolsRequest.
+message ListNodePoolsResponse {
+  // A list of node pools for a cluster.
+  repeated NodePool node_pools = 1;
+}
+
+// NodePoolAutoscaling contains information required by cluster autoscaler to
+// adjust the size of the node pool to the current cluster usage.
+message NodePoolAutoscaling {
+  // Is autoscaling enabled for this node pool.
+  bool enabled = 1;
+
+  // Minimum number of nodes in the NodePool. Must be >= 1 and <=
+  // max_node_count.
+  int32 min_node_count = 2;
+
+  // 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;
+}
+
+// SetLabelsRequest sets the Google Cloud Platform labels on a Google Container
+// 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // 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<string, string> resource_labels = 4;
+
+  // 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 <code>get()</code> request to the
+  // resource to get the latest fingerprint.
+  string label_fingerprint = 5;
+
+  // The name (project, location, cluster id) of the cluster to set labels.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // Whether ABAC authorization will be enabled in the cluster.
+  bool enabled = 4;
+
+  // The name (project, location, cluster id) of the cluster to set legacy abac.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  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/*'.
+  string name = 6;
+
+  // Whether to rotate credentials during IP rotation.
+  bool rotate_credentials = 7;
+}
+
+// CompleteIPRotationRequest moves the cluster master back into single-IP mode.
+message CompleteIPRotationRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  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/*'.
+  string name = 7;
+}
+
+// AcceleratorConfig represents a Hardware Accelerator request.
+message AcceleratorConfig {
+  // The number of the accelerator cards exposed to an instance.
+  int64 accelerator_count = 1;
+
+  // The accelerator type resource name. List of supported accelerators
+  // [here](/compute/docs/gpus/#Introduction)
+  string accelerator_type = 2;
+}
+
+// SetNetworkPolicyRequest enables/disables network policy for a cluster.
+message SetNetworkPolicyRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // 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;
+
+  // The name (project, location, cluster id) of the cluster to set networking
+  // 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
+  // number](https://support.google.com/cloud/answer/6158840).
+  string project_id = 1;
+
+  // The name of the Google Compute Engine
+  // [zone](/compute/docs/zones#available) in which the cluster
+  // resides.
+  string zone = 2;
+
+  // The name of the cluster to update.
+  string cluster_id = 3;
+
+  // The maintenance policy to be set for the cluster. An empty field
+  // clears the existing maintenance policy.
+  MaintenancePolicy maintenance_policy = 4;
+
+  // The name (project, location, cluster id) of the cluster to set maintenance
+  // policy.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 5;
+}
+
+// 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
+  // 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.
+  // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet
+  string subnetwork = 2;
+}
diff --git a/container/google/cloud/container_v1/proto/cluster_service_pb2.py b/container/google/cloud/container_v1/proto/cluster_service_pb2.py
new file mode 100644
index 000000000000..8e0e829a4d63
--- /dev/null
+++ b/container/google/cloud/container_v1/proto/cluster_service_pb2.py
@@ -0,0 +1,9844 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/container_v1/proto/cluster_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/container_v1/proto/cluster_service.proto",
+    package="google.container.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.container.v1B\023ClusterServiceProtoP\001Z<google.golang.org/genproto/googleapis/container/v1;container\252\002\031Google.Cloud.Container.V1\312\002\031Google\\Cloud\\Container\\V1"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/container_v1/proto/cluster_service.proto\x12\x13google.container.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto"\x80\x04\n\nNodeConfig\x12\x14\n\x0cmachine_type\x18\x01 \x01(\t\x12\x14\n\x0c\x64isk_size_gb\x18\x02 \x01(\x05\x12\x14\n\x0coauth_scopes\x18\x03 \x03(\t\x12\x17\n\x0fservice_account\x18\t \x01(\t\x12?\n\x08metadata\x18\x04 \x03(\x0b\x32-.google.container.v1.NodeConfig.MetadataEntry\x12\x12\n\nimage_type\x18\x05 \x01(\t\x12;\n\x06labels\x18\x06 \x03(\x0b\x32+.google.container.v1.NodeConfig.LabelsEntry\x12\x17\n\x0flocal_ssd_count\x18\x07 \x01(\x05\x12\x0c\n\x04tags\x18\x08 \x03(\t\x12\x13\n\x0bpreemptible\x18\n \x01(\x08\x12<\n\x0c\x61\x63\x63\x65lerators\x18\x0b \x03(\x0b\x32&.google.container.v1.AcceleratorConfig\x12\x11\n\tdisk_type\x18\x0c \x01(\t\x12\x18\n\x10min_cpu_platform\x18\r \x01(\t\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xd1\x01\n\nMasterAuth\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x12O\n\x19\x63lient_certificate_config\x18\x03 \x01(\x0b\x32,.google.container.v1.ClientCertificateConfig\x12\x1e\n\x16\x63luster_ca_certificate\x18\x64 \x01(\t\x12\x1a\n\x12\x63lient_certificate\x18\x65 \x01(\t\x12\x12\n\nclient_key\x18\x66 \x01(\t";\n\x17\x43lientCertificateConfig\x12 \n\x18issue_client_certificate\x18\x01 \x01(\x08"\xb7\x02\n\x0c\x41\x64\x64onsConfig\x12\x43\n\x13http_load_balancing\x18\x01 \x01(\x0b\x32&.google.container.v1.HttpLoadBalancing\x12Q\n\x1ahorizontal_pod_autoscaling\x18\x02 \x01(\x0b\x32-.google.container.v1.HorizontalPodAutoscaling\x12\x46\n\x14kubernetes_dashboard\x18\x03 \x01(\x0b\x32(.google.container.v1.KubernetesDashboard\x12G\n\x15network_policy_config\x18\x04 \x01(\x0b\x32(.google.container.v1.NetworkPolicyConfig"%\n\x11HttpLoadBalancing\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08",\n\x18HorizontalPodAutoscaling\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\'\n\x13KubernetesDashboard\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\'\n\x13NetworkPolicyConfig\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\xa8\x01\n\x14PrivateClusterConfig\x12\x1c\n\x14\x65nable_private_nodes\x18\x01 \x01(\x08\x12\x1f\n\x17\x65nable_private_endpoint\x18\x02 \x01(\x08\x12\x1e\n\x16master_ipv4_cidr_block\x18\x03 \x01(\t\x12\x18\n\x10private_endpoint\x18\x04 \x01(\t\x12\x17\n\x0fpublic_endpoint\x18\x05 \x01(\t"\xbc\x01\n\x1eMasterAuthorizedNetworksConfig\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x12R\n\x0b\x63idr_blocks\x18\x02 \x03(\x0b\x32=.google.container.v1.MasterAuthorizedNetworksConfig.CidrBlock\x1a\x35\n\tCidrBlock\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x12\n\ncidr_block\x18\x02 \x01(\t"\x1d\n\nLegacyAbac\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08"\x91\x01\n\rNetworkPolicy\x12=\n\x08provider\x18\x01 \x01(\x0e\x32+.google.container.v1.NetworkPolicy.Provider\x12\x0f\n\x07\x65nabled\x18\x02 \x01(\x08"0\n\x08Provider\x12\x18\n\x14PROVIDER_UNSPECIFIED\x10\x00\x12\n\n\x06\x43\x41LICO\x10\x01"\xe9\x02\n\x12IPAllocationPolicy\x12\x16\n\x0euse_ip_aliases\x18\x01 \x01(\x08\x12\x19\n\x11\x63reate_subnetwork\x18\x02 \x01(\x08\x12\x17\n\x0fsubnetwork_name\x18\x03 \x01(\t\x12\x1d\n\x11\x63luster_ipv4_cidr\x18\x04 \x01(\tB\x02\x18\x01\x12\x1a\n\x0enode_ipv4_cidr\x18\x05 \x01(\tB\x02\x18\x01\x12\x1e\n\x12services_ipv4_cidr\x18\x06 \x01(\tB\x02\x18\x01\x12$\n\x1c\x63luster_secondary_range_name\x18\x07 \x01(\t\x12%\n\x1dservices_secondary_range_name\x18\x08 \x01(\t\x12\x1f\n\x17\x63luster_ipv4_cidr_block\x18\t \x01(\t\x12\x1c\n\x14node_ipv4_cidr_block\x18\n \x01(\t\x12 \n\x18services_ipv4_cidr_block\x18\x0b \x01(\t"\xdd\x0c\n\x07\x43luster\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x1a\n\x12initial_node_count\x18\x03 \x01(\x05\x12\x34\n\x0bnode_config\x18\x04 \x01(\x0b\x32\x1f.google.container.v1.NodeConfig\x12\x34\n\x0bmaster_auth\x18\x05 \x01(\x0b\x32\x1f.google.container.v1.MasterAuth\x12\x17\n\x0flogging_service\x18\x06 \x01(\t\x12\x1a\n\x12monitoring_service\x18\x07 \x01(\t\x12\x0f\n\x07network\x18\x08 \x01(\t\x12\x19\n\x11\x63luster_ipv4_cidr\x18\t \x01(\t\x12\x38\n\raddons_config\x18\n \x01(\x0b\x32!.google.container.v1.AddonsConfig\x12\x12\n\nsubnetwork\x18\x0b \x01(\t\x12\x31\n\nnode_pools\x18\x0c \x03(\x0b\x32\x1d.google.container.v1.NodePool\x12\x11\n\tlocations\x18\r \x03(\t\x12\x1f\n\x17\x65nable_kubernetes_alpha\x18\x0e \x01(\x08\x12I\n\x0fresource_labels\x18\x0f \x03(\x0b\x32\x30.google.container.v1.Cluster.ResourceLabelsEntry\x12\x19\n\x11label_fingerprint\x18\x10 \x01(\t\x12\x34\n\x0blegacy_abac\x18\x12 \x01(\x0b\x32\x1f.google.container.v1.LegacyAbac\x12:\n\x0enetwork_policy\x18\x13 \x01(\x0b\x32".google.container.v1.NetworkPolicy\x12\x45\n\x14ip_allocation_policy\x18\x14 \x01(\x0b\x32\'.google.container.v1.IPAllocationPolicy\x12^\n!master_authorized_networks_config\x18\x16 \x01(\x0b\x32\x33.google.container.v1.MasterAuthorizedNetworksConfig\x12\x42\n\x12maintenance_policy\x18\x17 \x01(\x0b\x32&.google.container.v1.MaintenancePolicy\x12:\n\x0enetwork_config\x18\x1b \x01(\x0b\x32".google.container.v1.NetworkConfig\x12I\n\x16private_cluster_config\x18% \x01(\x0b\x32).google.container.v1.PrivateClusterConfig\x12\x11\n\tself_link\x18\x64 \x01(\t\x12\x10\n\x04zone\x18\x65 \x01(\tB\x02\x18\x01\x12\x10\n\x08\x65ndpoint\x18\x66 \x01(\t\x12\x1f\n\x17initial_cluster_version\x18g \x01(\t\x12\x1e\n\x16\x63urrent_master_version\x18h \x01(\t\x12 \n\x14\x63urrent_node_version\x18i \x01(\tB\x02\x18\x01\x12\x13\n\x0b\x63reate_time\x18j \x01(\t\x12\x33\n\x06status\x18k \x01(\x0e\x32#.google.container.v1.Cluster.Status\x12\x16\n\x0estatus_message\x18l \x01(\t\x12\x1b\n\x13node_ipv4_cidr_size\x18m \x01(\x05\x12\x1a\n\x12services_ipv4_cidr\x18n \x01(\t\x12\x1f\n\x13instance_group_urls\x18o \x03(\tB\x02\x18\x01\x12\x1a\n\x12\x63urrent_node_count\x18p \x01(\x05\x12\x13\n\x0b\x65xpire_time\x18q \x01(\t\x12\x10\n\x08location\x18r \x01(\t\x1a\x35\n\x13ResourceLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"w\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x10\n\x0cPROVISIONING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x0f\n\x0bRECONCILING\x10\x03\x12\x0c\n\x08STOPPING\x10\x04\x12\t\n\x05\x45RROR\x10\x05\x12\x0c\n\x08\x44\x45GRADED\x10\x06"\xc1\x03\n\rClusterUpdate\x12\x1c\n\x14\x64\x65sired_node_version\x18\x04 \x01(\t\x12"\n\x1a\x64\x65sired_monitoring_service\x18\x05 \x01(\t\x12@\n\x15\x64\x65sired_addons_config\x18\x06 \x01(\x0b\x32!.google.container.v1.AddonsConfig\x12\x1c\n\x14\x64\x65sired_node_pool_id\x18\x07 \x01(\t\x12\x1a\n\x12\x64\x65sired_image_type\x18\x08 \x01(\t\x12O\n\x1d\x64\x65sired_node_pool_autoscaling\x18\t \x01(\x0b\x32(.google.container.v1.NodePoolAutoscaling\x12\x19\n\x11\x64\x65sired_locations\x18\n \x03(\t\x12\x66\n)desired_master_authorized_networks_config\x18\x0c \x01(\x0b\x32\x33.google.container.v1.MasterAuthorizedNetworksConfig\x12\x1e\n\x16\x64\x65sired_master_version\x18\x64 \x01(\t"\xfb\x05\n\tOperation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12;\n\x0eoperation_type\x18\x03 \x01(\x0e\x32#.google.container.v1.Operation.Type\x12\x35\n\x06status\x18\x04 \x01(\x0e\x32%.google.container.v1.Operation.Status\x12\x0e\n\x06\x64\x65tail\x18\x08 \x01(\t\x12\x16\n\x0estatus_message\x18\x05 \x01(\t\x12\x11\n\tself_link\x18\x06 \x01(\t\x12\x13\n\x0btarget_link\x18\x07 \x01(\t\x12\x10\n\x08location\x18\t \x01(\t\x12\x12\n\nstart_time\x18\n \x01(\t\x12\x10\n\x08\x65nd_time\x18\x0b \x01(\t"R\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\x0c\n\x08\x41\x42ORTING\x10\x04"\xfd\x02\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43REATE_CLUSTER\x10\x01\x12\x12\n\x0e\x44\x45LETE_CLUSTER\x10\x02\x12\x12\n\x0eUPGRADE_MASTER\x10\x03\x12\x11\n\rUPGRADE_NODES\x10\x04\x12\x12\n\x0eREPAIR_CLUSTER\x10\x05\x12\x12\n\x0eUPDATE_CLUSTER\x10\x06\x12\x14\n\x10\x43REATE_NODE_POOL\x10\x07\x12\x14\n\x10\x44\x45LETE_NODE_POOL\x10\x08\x12\x1c\n\x18SET_NODE_POOL_MANAGEMENT\x10\t\x12\x15\n\x11\x41UTO_REPAIR_NODES\x10\n\x12\x16\n\x12\x41UTO_UPGRADE_NODES\x10\x0b\x12\x0e\n\nSET_LABELS\x10\x0c\x12\x13\n\x0fSET_MASTER_AUTH\x10\r\x12\x16\n\x12SET_NODE_POOL_SIZE\x10\x0e\x12\x16\n\x12SET_NETWORK_POLICY\x10\x0f\x12\x1a\n\x16SET_MAINTENANCE_POLICY\x10\x10"\x7f\n\x14\x43reateClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12-\n\x07\x63luster\x18\x03 \x01(\x0b\x32\x1c.google.container.v1.Cluster\x12\x0e\n\x06parent\x18\x05 \x01(\t"c\n\x11GetClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x05 \x01(\t"\x9a\x01\n\x14UpdateClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x32\n\x06update\x18\x04 \x01(\x0b\x32".google.container.v1.ClusterUpdate\x12\x0c\n\x04name\x18\x05 \x01(\t"\xab\x01\n\x15UpdateNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x14\n\x0cnode_version\x18\x05 \x01(\t\x12\x12\n\nimage_type\x18\x06 \x01(\t\x12\x0c\n\x04name\x18\x08 \x01(\t"\xc8\x01\n\x1dSetNodePoolAutoscalingRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12=\n\x0b\x61utoscaling\x18\x05 \x01(\x0b\x32(.google.container.v1.NodePoolAutoscaling\x12\x0c\n\x04name\x18\x06 \x01(\t"\x7f\n\x18SetLoggingServiceRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x0c\n\x04zone\x18\x02 \x01(\t\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x17\n\x0flogging_service\x18\x04 \x01(\t\x12\x0c\n\x04name\x18\x05 \x01(\t"\x89\x01\n\x1bSetMonitoringServiceRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x1a\n\x12monitoring_service\x18\x04 \x01(\t\x12\x0c\n\x04name\x18\x06 \x01(\t"\xa2\x01\n\x16SetAddonsConfigRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x38\n\raddons_config\x18\x04 \x01(\x0b\x32!.google.container.v1.AddonsConfig\x12\x0c\n\x04name\x18\x06 \x01(\t"x\n\x13SetLocationsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x11\n\tlocations\x18\x04 \x03(\t\x12\x0c\n\x04name\x18\x06 \x01(\t"}\n\x13UpdateMasterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x16\n\x0emaster_version\x18\x04 \x01(\t\x12\x0c\n\x04name\x18\x07 \x01(\t"\xab\x02\n\x14SetMasterAuthRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12@\n\x06\x61\x63tion\x18\x04 \x01(\x0e\x32\x30.google.container.v1.SetMasterAuthRequest.Action\x12/\n\x06update\x18\x05 \x01(\x0b\x32\x1f.google.container.v1.MasterAuth\x12\x0c\n\x04name\x18\x07 \x01(\t"P\n\x06\x41\x63tion\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x10\n\x0cSET_PASSWORD\x10\x01\x12\x15\n\x11GENERATE_PASSWORD\x10\x02\x12\x10\n\x0cSET_USERNAME\x10\x03"f\n\x14\x44\x65leteClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x04 \x01(\t"O\n\x13ListClustersRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x0e\n\x06parent\x18\x04 \x01(\t"]\n\x14ListClustersResponse\x12.\n\x08\x63lusters\x18\x01 \x03(\x0b\x32\x1c.google.container.v1.Cluster\x12\x15\n\rmissing_zones\x18\x02 \x03(\t"g\n\x13GetOperationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x18\n\x0coperation_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x05 \x01(\t"Q\n\x15ListOperationsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x0e\n\x06parent\x18\x04 \x01(\t"j\n\x16\x43\x61ncelOperationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x18\n\x0coperation_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x04 \x01(\t"c\n\x16ListOperationsResponse\x12\x32\n\noperations\x18\x01 \x03(\x0b\x32\x1e.google.container.v1.Operation\x12\x15\n\rmissing_zones\x18\x02 \x03(\t"P\n\x16GetServerConfigRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x04 \x01(\t"\xa2\x01\n\x0cServerConfig\x12\x1f\n\x17\x64\x65\x66\x61ult_cluster_version\x18\x01 \x01(\t\x12\x1b\n\x13valid_node_versions\x18\x03 \x03(\t\x12\x1a\n\x12\x64\x65\x66\x61ult_image_type\x18\x04 \x01(\t\x12\x19\n\x11valid_image_types\x18\x05 \x03(\t\x12\x1d\n\x15valid_master_versions\x18\x06 \x03(\t"\x9b\x01\n\x15\x43reateNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x30\n\tnode_pool\x18\x04 \x01(\x0b\x32\x1d.google.container.v1.NodePool\x12\x0e\n\x06parent\x18\x06 \x01(\t"\x81\x01\n\x15\x44\x65leteNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"h\n\x14ListNodePoolsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0e\n\x06parent\x18\x05 \x01(\t"~\n\x12GetNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"\xf0\x03\n\x08NodePool\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x06\x63onfig\x18\x02 \x01(\x0b\x32\x1f.google.container.v1.NodeConfig\x12\x1a\n\x12initial_node_count\x18\x03 \x01(\x05\x12\x11\n\tself_link\x18\x64 \x01(\t\x12\x0f\n\x07version\x18\x65 \x01(\t\x12\x1b\n\x13instance_group_urls\x18\x66 \x03(\t\x12\x34\n\x06status\x18g \x01(\x0e\x32$.google.container.v1.NodePool.Status\x12\x16\n\x0estatus_message\x18h \x01(\t\x12=\n\x0b\x61utoscaling\x18\x04 \x01(\x0b\x32(.google.container.v1.NodePoolAutoscaling\x12\x37\n\nmanagement\x18\x05 \x01(\x0b\x32#.google.container.v1.NodeManagement"\x81\x01\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x10\n\x0cPROVISIONING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x16\n\x12RUNNING_WITH_ERROR\x10\x03\x12\x0f\n\x0bRECONCILING\x10\x04\x12\x0c\n\x08STOPPING\x10\x05\x12\t\n\x05\x45RROR\x10\x06"}\n\x0eNodeManagement\x12\x14\n\x0c\x61uto_upgrade\x18\x01 \x01(\x08\x12\x13\n\x0b\x61uto_repair\x18\x02 \x01(\x08\x12@\n\x0fupgrade_options\x18\n \x01(\x0b\x32\'.google.container.v1.AutoUpgradeOptions"J\n\x12\x41utoUpgradeOptions\x12\x1f\n\x17\x61uto_upgrade_start_time\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t"K\n\x11MaintenancePolicy\x12\x36\n\x06window\x18\x01 \x01(\x0b\x32&.google.container.v1.MaintenanceWindow"n\n\x11MaintenanceWindow\x12O\n\x18\x64\x61ily_maintenance_window\x18\x02 \x01(\x0b\x32+.google.container.v1.DailyMaintenanceWindowH\x00\x42\x08\n\x06policy">\n\x16\x44\x61ilyMaintenanceWindow\x12\x12\n\nstart_time\x18\x02 \x01(\t\x12\x10\n\x08\x64uration\x18\x03 \x01(\t"\xc1\x01\n\x1cSetNodePoolManagementRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x37\n\nmanagement\x18\x05 \x01(\x0b\x32#.google.container.v1.NodeManagement\x12\x0c\n\x04name\x18\x07 \x01(\t"\x96\x01\n\x16SetNodePoolSizeRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x12\n\nnode_count\x18\x05 \x01(\x05\x12\x0c\n\x04name\x18\x07 \x01(\t"\x8a\x01\n\x1eRollbackNodePoolUpgradeRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"J\n\x15ListNodePoolsResponse\x12\x31\n\nnode_pools\x18\x01 \x03(\x0b\x32\x1d.google.container.v1.NodePool"V\n\x13NodePoolAutoscaling\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x12\x16\n\x0emin_node_count\x18\x02 \x01(\x05\x12\x16\n\x0emax_node_count\x18\x03 \x01(\x05"\x88\x02\n\x10SetLabelsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12R\n\x0fresource_labels\x18\x04 \x03(\x0b\x32\x39.google.container.v1.SetLabelsRequest.ResourceLabelsEntry\x12\x19\n\x11label_fingerprint\x18\x05 \x01(\t\x12\x0c\n\x04name\x18\x07 \x01(\t\x1a\x35\n\x13ResourceLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"w\n\x14SetLegacyAbacRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0f\n\x07\x65nabled\x18\x04 \x01(\x08\x12\x0c\n\x04name\x18\x06 \x01(\t"\x84\x01\n\x16StartIPRotationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x1a\n\x12rotate_credentials\x18\x07 \x01(\x08"k\n\x19\x43ompleteIPRotationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x07 \x01(\t"H\n\x11\x41\x63\x63\x65leratorConfig\x12\x19\n\x11\x61\x63\x63\x65lerator_count\x18\x01 \x01(\x03\x12\x18\n\x10\x61\x63\x63\x65lerator_type\x18\x02 \x01(\t"\xa5\x01\n\x17SetNetworkPolicyRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12:\n\x0enetwork_policy\x18\x04 \x01(\x0b\x32".google.container.v1.NetworkPolicy\x12\x0c\n\x04name\x18\x06 \x01(\t"\xa5\x01\n\x1bSetMaintenancePolicyRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0c\n\x04zone\x18\x02 \x01(\t\x12\x12\n\ncluster_id\x18\x03 \x01(\t\x12\x42\n\x12maintenance_policy\x18\x04 \x01(\x0b\x32&.google.container.v1.MaintenancePolicy\x12\x0c\n\x04name\x18\x05 \x01(\t"4\n\rNetworkConfig\x12\x0f\n\x07network\x18\x01 \x01(\t\x12\x12\n\nsubnetwork\x18\x02 \x01(\t2\xcb\x39\n\x0e\x43lusterManager\x12\xcc\x01\n\x0cListClusters\x12(.google.container.v1.ListClustersRequest\x1a).google.container.v1.ListClustersResponse"g\x82\xd3\xe4\x93\x02\x61\x12,/v1/{parent=projects/*/locations/*}/clustersZ1\x12//v1/projects/{project_id}/zones/{zone}/clusters\x12\xc8\x01\n\nGetCluster\x12&.google.container.v1.GetClusterRequest\x1a\x1c.google.container.v1.Cluster"t\x82\xd3\xe4\x93\x02n\x12,/v1/{name=projects/*/locations/*/clusters/*}Z>\x12</v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}\x12\xc9\x01\n\rCreateCluster\x12).google.container.v1.CreateClusterRequest\x1a\x1e.google.container.v1.Operation"m\x82\xd3\xe4\x93\x02g",/v1/{parent=projects/*/locations/*}/clusters:\x01*Z4"//v1/projects/{project_id}/zones/{zone}/clusters:\x01*\x12\xd6\x01\n\rUpdateCluster\x12).google.container.v1.UpdateClusterRequest\x1a\x1e.google.container.v1.Operation"z\x82\xd3\xe4\x93\x02t\x1a,/v1/{name=projects/*/locations/*/clusters/*}:\x01*ZA\x1a</v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:\x01*\x12\x86\x02\n\x0eUpdateNodePool\x12*.google.container.v1.UpdateNodePoolRequest\x1a\x1e.google.container.v1.Operation"\xa7\x01\x82\xd3\xe4\x93\x02\xa0\x01\x1a\x38/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:\x01*Za"\\/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/update:\x01*\x12\xaa\x02\n\x16SetNodePoolAutoscaling\x12\x32.google.container.v1.SetNodePoolAutoscalingRequest\x1a\x1e.google.container.v1.Operation"\xbb\x01\x82\xd3\xe4\x93\x02\xb4\x01"G/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling:\x01*Zf"a/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/autoscaling:\x01*\x12\xf3\x01\n\x11SetLoggingService\x12-.google.container.v1.SetLoggingServiceRequest\x1a\x1e.google.container.v1.Operation"\x8e\x01\x82\xd3\xe4\x93\x02\x87\x01"7/v1/{name=projects/*/locations/*/clusters/*}:setLogging:\x01*ZI"D/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/logging:\x01*\x12\xff\x01\n\x14SetMonitoringService\x12\x30.google.container.v1.SetMonitoringServiceRequest\x1a\x1e.google.container.v1.Operation"\x94\x01\x82\xd3\xe4\x93\x02\x8d\x01":/v1/{name=projects/*/locations/*/clusters/*}:setMonitoring:\x01*ZL"G/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/monitoring:\x01*\x12\xed\x01\n\x0fSetAddonsConfig\x12+.google.container.v1.SetAddonsConfigRequest\x1a\x1e.google.container.v1.Operation"\x8c\x01\x82\xd3\xe4\x93\x02\x85\x01"6/v1/{name=projects/*/locations/*/clusters/*}:setAddons:\x01*ZH"C/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/addons:\x01*\x12\xed\x01\n\x0cSetLocations\x12(.google.container.v1.SetLocationsRequest\x1a\x1e.google.container.v1.Operation"\x92\x01\x82\xd3\xe4\x93\x02\x8b\x01"9/v1/{name=projects/*/locations/*/clusters/*}:setLocations:\x01*ZK"F/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/locations:\x01*\x12\xea\x01\n\x0cUpdateMaster\x12(.google.container.v1.UpdateMasterRequest\x1a\x1e.google.container.v1.Operation"\x8f\x01\x82\xd3\xe4\x93\x02\x88\x01"9/v1/{name=projects/*/locations/*/clusters/*}:updateMaster:\x01*ZH"C/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/master:\x01*\x12\xf4\x01\n\rSetMasterAuth\x12).google.container.v1.SetMasterAuthRequest\x1a\x1e.google.container.v1.Operation"\x97\x01\x82\xd3\xe4\x93\x02\x90\x01":/v1/{name=projects/*/locations/*/clusters/*}:setMasterAuth:\x01*ZO"J/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMasterAuth:\x01*\x12\xd0\x01\n\rDeleteCluster\x12).google.container.v1.DeleteClusterRequest\x1a\x1e.google.container.v1.Operation"t\x82\xd3\xe4\x93\x02n*,/v1/{name=projects/*/locations/*/clusters/*}Z>*</v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}\x12\xd6\x01\n\x0eListOperations\x12*.google.container.v1.ListOperationsRequest\x1a+.google.container.v1.ListOperationsResponse"k\x82\xd3\xe4\x93\x02\x65\x12./v1/{parent=projects/*/locations/*}/operationsZ3\x12\x31/v1/projects/{project_id}/zones/{zone}/operations\x12\xd4\x01\n\x0cGetOperation\x12(.google.container.v1.GetOperationRequest\x1a\x1e.google.container.v1.Operation"z\x82\xd3\xe4\x93\x02t\x12./v1/{name=projects/*/locations/*/operations/*}ZB\x12@/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}\x12\xe8\x01\n\x0f\x43\x61ncelOperation\x12+.google.container.v1.CancelOperationRequest\x1a\x16.google.protobuf.Empty"\x8f\x01\x82\xd3\xe4\x93\x02\x88\x01"5/v1/{name=projects/*/locations/*/operations/*}:cancel:\x01*ZL"G/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}:cancel:\x01*\x12\xd0\x01\n\x0fGetServerConfig\x12+.google.container.v1.GetServerConfigRequest\x1a!.google.container.v1.ServerConfig"m\x82\xd3\xe4\x93\x02g\x12./v1/{name=projects/*/locations/*}/serverConfigZ5\x12\x33/v1/projects/{project_id}/zones/{zone}/serverconfig\x12\xf4\x01\n\rListNodePools\x12).google.container.v1.ListNodePoolsRequest\x1a*.google.container.v1.ListNodePoolsResponse"\x8b\x01\x82\xd3\xe4\x93\x02\x84\x01\x12\x38/v1/{parent=projects/*/locations/*/clusters/*}/nodePoolsZH\x12\x46/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools\x12\xf2\x01\n\x0bGetNodePool\x12\'.google.container.v1.GetNodePoolRequest\x1a\x1d.google.container.v1.NodePool"\x9a\x01\x82\xd3\xe4\x93\x02\x93\x01\x12\x38/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}ZW\x12U/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}\x12\xf0\x01\n\x0e\x43reateNodePool\x12*.google.container.v1.CreateNodePoolRequest\x1a\x1e.google.container.v1.Operation"\x91\x01\x82\xd3\xe4\x93\x02\x8a\x01"8/v1/{parent=projects/*/locations/*/clusters/*}/nodePools:\x01*ZK"F/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools:\x01*\x12\xf9\x01\n\x0e\x44\x65leteNodePool\x12*.google.container.v1.DeleteNodePoolRequest\x1a\x1e.google.container.v1.Operation"\x9a\x01\x82\xd3\xe4\x93\x02\x93\x01*8/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}ZW*U/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}\x12\xa3\x02\n\x17RollbackNodePoolUpgrade\x12\x33.google.container.v1.RollbackNodePoolUpgradeRequest\x1a\x1e.google.container.v1.Operation"\xb2\x01\x82\xd3\xe4\x93\x02\xab\x01"A/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback:\x01*Zc"^/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}:rollback:\x01*\x12\xa9\x02\n\x15SetNodePoolManagement\x12\x31.google.container.v1.SetNodePoolManagementRequest\x1a\x1e.google.container.v1.Operation"\xbc\x01\x82\xd3\xe4\x93\x02\xb5\x01"F/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setManagement:\x01*Zh"c/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setManagement:\x01*\x12\xf1\x01\n\tSetLabels\x12%.google.container.v1.SetLabelsRequest\x1a\x1e.google.container.v1.Operation"\x9c\x01\x82\xd3\xe4\x93\x02\x95\x01">/v1/{name=projects/*/locations/*/clusters/*}:setResourceLabels:\x01*ZP"K/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels:\x01*\x12\xf1\x01\n\rSetLegacyAbac\x12).google.container.v1.SetLegacyAbacRequest\x1a\x1e.google.container.v1.Operation"\x94\x01\x82\xd3\xe4\x93\x02\x8d\x01":/v1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac:\x01*ZL"G/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac:\x01*\x12\xfc\x01\n\x0fStartIPRotation\x12+.google.container.v1.StartIPRotationRequest\x1a\x1e.google.container.v1.Operation"\x9b\x01\x82\xd3\xe4\x93\x02\x94\x01"</v1/{name=projects/*/locations/*/clusters/*}:startIpRotation:\x01*ZQ"L/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:startIpRotation:\x01*\x12\x88\x02\n\x12\x43ompleteIPRotation\x12..google.container.v1.CompleteIPRotationRequest\x1a\x1e.google.container.v1.Operation"\xa1\x01\x82\xd3\xe4\x93\x02\x9a\x01"?/v1/{name=projects/*/locations/*/clusters/*}:completeIpRotation:\x01*ZT"O/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:completeIpRotation:\x01*\x12\x91\x02\n\x0fSetNodePoolSize\x12+.google.container.v1.SetNodePoolSizeRequest\x1a\x1e.google.container.v1.Operation"\xb0\x01\x82\xd3\xe4\x93\x02\xa9\x01"@/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setSize:\x01*Zb"]/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setSize:\x01*\x12\x80\x02\n\x10SetNetworkPolicy\x12,.google.container.v1.SetNetworkPolicyRequest\x1a\x1e.google.container.v1.Operation"\x9d\x01\x82\xd3\xe4\x93\x02\x96\x01"=/v1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy:\x01*ZR"M/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setNetworkPolicy:\x01*\x12\x90\x02\n\x14SetMaintenancePolicy\x12\x30.google.container.v1.SetMaintenancePolicyRequest\x1a\x1e.google.container.v1.Operation"\xa5\x01\x82\xd3\xe4\x93\x02\x9e\x01"A/v1/{name=projects/*/locations/*/clusters/*}:setMaintenancePolicy:\x01*ZV"Q/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMaintenancePolicy:\x01*B\xa6\x01\n\x17\x63om.google.container.v1B\x13\x43lusterServiceProtoP\x01Z<google.golang.org/genproto/googleapis/container/v1;container\xaa\x02\x19Google.Cloud.Container.V1\xca\x02\x19Google\\Cloud\\Container\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_NETWORKPOLICY_PROVIDER = _descriptor.EnumDescriptor(
+    name="Provider",
+    full_name="google.container.v1.NetworkPolicy.Provider",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PROVIDER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CALICO", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1897,
+    serialized_end=1945,
+)
+_sym_db.RegisterEnumDescriptor(_NETWORKPOLICY_PROVIDER)
+
+_CLUSTER_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1.Cluster.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROVISIONING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECONCILING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STOPPING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEGRADED", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3822,
+    serialized_end=3941,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTER_STATUS)
+
+_OPERATION_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1.Operation.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ABORTING", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4693,
+    serialized_end=4775,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATION_STATUS)
+
+_OPERATION_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.container.v1.Operation.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATE_CLUSTER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE_CLUSTER", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPGRADE_MASTER", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPGRADE_NODES", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPAIR_CLUSTER", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATE_CLUSTER", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATE_NODE_POOL",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE_NODE_POOL",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_NODE_POOL_MANAGEMENT",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTO_REPAIR_NODES",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTO_UPGRADE_NODES",
+            index=11,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_LABELS", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_MASTER_AUTH",
+            index=13,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_NODE_POOL_SIZE",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_NETWORK_POLICY",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_MAINTENANCE_POLICY",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4778,
+    serialized_end=5159,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATION_TYPE)
+
+_SETMASTERAUTHREQUEST_ACTION = _descriptor.EnumDescriptor(
+    name="Action",
+    full_name="google.container.v1.SetMasterAuthRequest.Action",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_PASSWORD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GENERATE_PASSWORD",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_USERNAME", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6828,
+    serialized_end=6908,
+)
+_sym_db.RegisterEnumDescriptor(_SETMASTERAUTHREQUEST_ACTION)
+
+_NODEPOOL_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1.NodePool.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROVISIONING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING_WITH_ERROR",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECONCILING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STOPPING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=8726,
+    serialized_end=8855,
+)
+_sym_db.RegisterEnumDescriptor(_NODEPOOL_STATUS)
+
+
+_NODECONFIG_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.container.v1.NodeConfig.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1.NodeConfig.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1.NodeConfig.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=556,
+    serialized_end=603,
+)
+
+_NODECONFIG_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.container.v1.NodeConfig.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1.NodeConfig.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1.NodeConfig.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=605,
+    serialized_end=650,
+)
+
+_NODECONFIG = _descriptor.Descriptor(
+    name="NodeConfig",
+    full_name="google.container.v1.NodeConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="machine_type",
+            full_name="google.container.v1.NodeConfig.machine_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disk_size_gb",
+            full_name="google.container.v1.NodeConfig.disk_size_gb",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oauth_scopes",
+            full_name="google.container.v1.NodeConfig.oauth_scopes",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account",
+            full_name="google.container.v1.NodeConfig.service_account",
+            index=3,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.container.v1.NodeConfig.metadata",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_type",
+            full_name="google.container.v1.NodeConfig.image_type",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.container.v1.NodeConfig.labels",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="local_ssd_count",
+            full_name="google.container.v1.NodeConfig.local_ssd_count",
+            index=7,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.container.v1.NodeConfig.tags",
+            index=8,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="preemptible",
+            full_name="google.container.v1.NodeConfig.preemptible",
+            index=9,
+            number=10,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerators",
+            full_name="google.container.v1.NodeConfig.accelerators",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disk_type",
+            full_name="google.container.v1.NodeConfig.disk_type",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_cpu_platform",
+            full_name="google.container.v1.NodeConfig.min_cpu_platform",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_NODECONFIG_METADATAENTRY, _NODECONFIG_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=138,
+    serialized_end=650,
+)
+
+
+_MASTERAUTH = _descriptor.Descriptor(
+    name="MasterAuth",
+    full_name="google.container.v1.MasterAuth",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.container.v1.MasterAuth.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.container.v1.MasterAuth.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_certificate_config",
+            full_name="google.container.v1.MasterAuth.client_certificate_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ca_certificate",
+            full_name="google.container.v1.MasterAuth.cluster_ca_certificate",
+            index=3,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_certificate",
+            full_name="google.container.v1.MasterAuth.client_certificate",
+            index=4,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_key",
+            full_name="google.container.v1.MasterAuth.client_key",
+            index=5,
+            number=102,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=653,
+    serialized_end=862,
+)
+
+
+_CLIENTCERTIFICATECONFIG = _descriptor.Descriptor(
+    name="ClientCertificateConfig",
+    full_name="google.container.v1.ClientCertificateConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="issue_client_certificate",
+            full_name="google.container.v1.ClientCertificateConfig.issue_client_certificate",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=864,
+    serialized_end=923,
+)
+
+
+_ADDONSCONFIG = _descriptor.Descriptor(
+    name="AddonsConfig",
+    full_name="google.container.v1.AddonsConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_load_balancing",
+            full_name="google.container.v1.AddonsConfig.http_load_balancing",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="horizontal_pod_autoscaling",
+            full_name="google.container.v1.AddonsConfig.horizontal_pod_autoscaling",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kubernetes_dashboard",
+            full_name="google.container.v1.AddonsConfig.kubernetes_dashboard",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_policy_config",
+            full_name="google.container.v1.AddonsConfig.network_policy_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=926,
+    serialized_end=1237,
+)
+
+
+_HTTPLOADBALANCING = _descriptor.Descriptor(
+    name="HttpLoadBalancing",
+    full_name="google.container.v1.HttpLoadBalancing",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1.HttpLoadBalancing.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1239,
+    serialized_end=1276,
+)
+
+
+_HORIZONTALPODAUTOSCALING = _descriptor.Descriptor(
+    name="HorizontalPodAutoscaling",
+    full_name="google.container.v1.HorizontalPodAutoscaling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1.HorizontalPodAutoscaling.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1278,
+    serialized_end=1322,
+)
+
+
+_KUBERNETESDASHBOARD = _descriptor.Descriptor(
+    name="KubernetesDashboard",
+    full_name="google.container.v1.KubernetesDashboard",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1.KubernetesDashboard.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1324,
+    serialized_end=1363,
+)
+
+
+_NETWORKPOLICYCONFIG = _descriptor.Descriptor(
+    name="NetworkPolicyConfig",
+    full_name="google.container.v1.NetworkPolicyConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1.NetworkPolicyConfig.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1365,
+    serialized_end=1404,
+)
+
+
+_PRIVATECLUSTERCONFIG = _descriptor.Descriptor(
+    name="PrivateClusterConfig",
+    full_name="google.container.v1.PrivateClusterConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_private_nodes",
+            full_name="google.container.v1.PrivateClusterConfig.enable_private_nodes",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_private_endpoint",
+            full_name="google.container.v1.PrivateClusterConfig.enable_private_endpoint",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_ipv4_cidr_block",
+            full_name="google.container.v1.PrivateClusterConfig.master_ipv4_cidr_block",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="private_endpoint",
+            full_name="google.container.v1.PrivateClusterConfig.private_endpoint",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="public_endpoint",
+            full_name="google.container.v1.PrivateClusterConfig.public_endpoint",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1407,
+    serialized_end=1575,
+)
+
+
+_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK = _descriptor.Descriptor(
+    name="CidrBlock",
+    full_name="google.container.v1.MasterAuthorizedNetworksConfig.CidrBlock",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.container.v1.MasterAuthorizedNetworksConfig.CidrBlock.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cidr_block",
+            full_name="google.container.v1.MasterAuthorizedNetworksConfig.CidrBlock.cidr_block",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1713,
+    serialized_end=1766,
+)
+
+_MASTERAUTHORIZEDNETWORKSCONFIG = _descriptor.Descriptor(
+    name="MasterAuthorizedNetworksConfig",
+    full_name="google.container.v1.MasterAuthorizedNetworksConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1.MasterAuthorizedNetworksConfig.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cidr_blocks",
+            full_name="google.container.v1.MasterAuthorizedNetworksConfig.cidr_blocks",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1578,
+    serialized_end=1766,
+)
+
+
+_LEGACYABAC = _descriptor.Descriptor(
+    name="LegacyAbac",
+    full_name="google.container.v1.LegacyAbac",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1.LegacyAbac.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1768,
+    serialized_end=1797,
+)
+
+
+_NETWORKPOLICY = _descriptor.Descriptor(
+    name="NetworkPolicy",
+    full_name="google.container.v1.NetworkPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="provider",
+            full_name="google.container.v1.NetworkPolicy.provider",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1.NetworkPolicy.enabled",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_NETWORKPOLICY_PROVIDER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1800,
+    serialized_end=1945,
+)
+
+
+_IPALLOCATIONPOLICY = _descriptor.Descriptor(
+    name="IPAllocationPolicy",
+    full_name="google.container.v1.IPAllocationPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="use_ip_aliases",
+            full_name="google.container.v1.IPAllocationPolicy.use_ip_aliases",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_subnetwork",
+            full_name="google.container.v1.IPAllocationPolicy.create_subnetwork",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork_name",
+            full_name="google.container.v1.IPAllocationPolicy.subnetwork_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ipv4_cidr",
+            full_name="google.container.v1.IPAllocationPolicy.cluster_ipv4_cidr",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_ipv4_cidr",
+            full_name="google.container.v1.IPAllocationPolicy.node_ipv4_cidr",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_ipv4_cidr",
+            full_name="google.container.v1.IPAllocationPolicy.services_ipv4_cidr",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_secondary_range_name",
+            full_name="google.container.v1.IPAllocationPolicy.cluster_secondary_range_name",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_secondary_range_name",
+            full_name="google.container.v1.IPAllocationPolicy.services_secondary_range_name",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ipv4_cidr_block",
+            full_name="google.container.v1.IPAllocationPolicy.cluster_ipv4_cidr_block",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_ipv4_cidr_block",
+            full_name="google.container.v1.IPAllocationPolicy.node_ipv4_cidr_block",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_ipv4_cidr_block",
+            full_name="google.container.v1.IPAllocationPolicy.services_ipv4_cidr_block",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1948,
+    serialized_end=2309,
+)
+
+
+_CLUSTER_RESOURCELABELSENTRY = _descriptor.Descriptor(
+    name="ResourceLabelsEntry",
+    full_name="google.container.v1.Cluster.ResourceLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1.Cluster.ResourceLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1.Cluster.ResourceLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3767,
+    serialized_end=3820,
+)
+
+_CLUSTER = _descriptor.Descriptor(
+    name="Cluster",
+    full_name="google.container.v1.Cluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.Cluster.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.container.v1.Cluster.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_node_count",
+            full_name="google.container.v1.Cluster.initial_node_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_config",
+            full_name="google.container.v1.Cluster.node_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_auth",
+            full_name="google.container.v1.Cluster.master_auth",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_service",
+            full_name="google.container.v1.Cluster.logging_service",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="monitoring_service",
+            full_name="google.container.v1.Cluster.monitoring_service",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network",
+            full_name="google.container.v1.Cluster.network",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ipv4_cidr",
+            full_name="google.container.v1.Cluster.cluster_ipv4_cidr",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="addons_config",
+            full_name="google.container.v1.Cluster.addons_config",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork",
+            full_name="google.container.v1.Cluster.subnetwork",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pools",
+            full_name="google.container.v1.Cluster.node_pools",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.container.v1.Cluster.locations",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_kubernetes_alpha",
+            full_name="google.container.v1.Cluster.enable_kubernetes_alpha",
+            index=13,
+            number=14,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_labels",
+            full_name="google.container.v1.Cluster.resource_labels",
+            index=14,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_fingerprint",
+            full_name="google.container.v1.Cluster.label_fingerprint",
+            index=15,
+            number=16,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="legacy_abac",
+            full_name="google.container.v1.Cluster.legacy_abac",
+            index=16,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_policy",
+            full_name="google.container.v1.Cluster.network_policy",
+            index=17,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ip_allocation_policy",
+            full_name="google.container.v1.Cluster.ip_allocation_policy",
+            index=18,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_authorized_networks_config",
+            full_name="google.container.v1.Cluster.master_authorized_networks_config",
+            index=19,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maintenance_policy",
+            full_name="google.container.v1.Cluster.maintenance_policy",
+            index=20,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_config",
+            full_name="google.container.v1.Cluster.network_config",
+            index=21,
+            number=27,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="private_cluster_config",
+            full_name="google.container.v1.Cluster.private_cluster_config",
+            index=22,
+            number=37,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="self_link",
+            full_name="google.container.v1.Cluster.self_link",
+            index=23,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.Cluster.zone",
+            index=24,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="endpoint",
+            full_name="google.container.v1.Cluster.endpoint",
+            index=25,
+            number=102,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_cluster_version",
+            full_name="google.container.v1.Cluster.initial_cluster_version",
+            index=26,
+            number=103,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_master_version",
+            full_name="google.container.v1.Cluster.current_master_version",
+            index=27,
+            number=104,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_node_version",
+            full_name="google.container.v1.Cluster.current_node_version",
+            index=28,
+            number=105,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.container.v1.Cluster.create_time",
+            index=29,
+            number=106,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1.Cluster.status",
+            index=30,
+            number=107,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1.Cluster.status_message",
+            index=31,
+            number=108,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_ipv4_cidr_size",
+            full_name="google.container.v1.Cluster.node_ipv4_cidr_size",
+            index=32,
+            number=109,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_ipv4_cidr",
+            full_name="google.container.v1.Cluster.services_ipv4_cidr",
+            index=33,
+            number=110,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_group_urls",
+            full_name="google.container.v1.Cluster.instance_group_urls",
+            index=34,
+            number=111,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_node_count",
+            full_name="google.container.v1.Cluster.current_node_count",
+            index=35,
+            number=112,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.container.v1.Cluster.expire_time",
+            index=36,
+            number=113,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.container.v1.Cluster.location",
+            index=37,
+            number=114,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTER_RESOURCELABELSENTRY],
+    enum_types=[_CLUSTER_STATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2312,
+    serialized_end=3941,
+)
+
+
+_CLUSTERUPDATE = _descriptor.Descriptor(
+    name="ClusterUpdate",
+    full_name="google.container.v1.ClusterUpdate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="desired_node_version",
+            full_name="google.container.v1.ClusterUpdate.desired_node_version",
+            index=0,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_monitoring_service",
+            full_name="google.container.v1.ClusterUpdate.desired_monitoring_service",
+            index=1,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_addons_config",
+            full_name="google.container.v1.ClusterUpdate.desired_addons_config",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_node_pool_id",
+            full_name="google.container.v1.ClusterUpdate.desired_node_pool_id",
+            index=3,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_image_type",
+            full_name="google.container.v1.ClusterUpdate.desired_image_type",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_node_pool_autoscaling",
+            full_name="google.container.v1.ClusterUpdate.desired_node_pool_autoscaling",
+            index=5,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_locations",
+            full_name="google.container.v1.ClusterUpdate.desired_locations",
+            index=6,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_master_authorized_networks_config",
+            full_name="google.container.v1.ClusterUpdate.desired_master_authorized_networks_config",
+            index=7,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_master_version",
+            full_name="google.container.v1.ClusterUpdate.desired_master_version",
+            index=8,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3944,
+    serialized_end=4393,
+)
+
+
+_OPERATION = _descriptor.Descriptor(
+    name="Operation",
+    full_name="google.container.v1.Operation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.Operation.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.Operation.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_type",
+            full_name="google.container.v1.Operation.operation_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1.Operation.status",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detail",
+            full_name="google.container.v1.Operation.detail",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1.Operation.status_message",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="self_link",
+            full_name="google.container.v1.Operation.self_link",
+            index=6,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_link",
+            full_name="google.container.v1.Operation.target_link",
+            index=7,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.container.v1.Operation.location",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.container.v1.Operation.start_time",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.container.v1.Operation.end_time",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OPERATION_STATUS, _OPERATION_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4396,
+    serialized_end=5159,
+)
+
+
+_CREATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="CreateClusterRequest",
+    full_name="google.container.v1.CreateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.CreateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.CreateClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.container.v1.CreateClusterRequest.cluster",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1.CreateClusterRequest.parent",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5161,
+    serialized_end=5288,
+)
+
+
+_GETCLUSTERREQUEST = _descriptor.Descriptor(
+    name="GetClusterRequest",
+    full_name="google.container.v1.GetClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.GetClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.GetClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.GetClusterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.GetClusterRequest.name",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5290,
+    serialized_end=5389,
+)
+
+
+_UPDATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="UpdateClusterRequest",
+    full_name="google.container.v1.UpdateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.UpdateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.UpdateClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.UpdateClusterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.container.v1.UpdateClusterRequest.update",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.UpdateClusterRequest.name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5392,
+    serialized_end=5546,
+)
+
+
+_UPDATENODEPOOLREQUEST = _descriptor.Descriptor(
+    name="UpdateNodePoolRequest",
+    full_name="google.container.v1.UpdateNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.UpdateNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.UpdateNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.UpdateNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.UpdateNodePoolRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_version",
+            full_name="google.container.v1.UpdateNodePoolRequest.node_version",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_type",
+            full_name="google.container.v1.UpdateNodePoolRequest.image_type",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.UpdateNodePoolRequest.name",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5549,
+    serialized_end=5720,
+)
+
+
+_SETNODEPOOLAUTOSCALINGREQUEST = _descriptor.Descriptor(
+    name="SetNodePoolAutoscalingRequest",
+    full_name="google.container.v1.SetNodePoolAutoscalingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetNodePoolAutoscalingRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetNodePoolAutoscalingRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetNodePoolAutoscalingRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.SetNodePoolAutoscalingRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoscaling",
+            full_name="google.container.v1.SetNodePoolAutoscalingRequest.autoscaling",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetNodePoolAutoscalingRequest.name",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5723,
+    serialized_end=5923,
+)
+
+
+_SETLOGGINGSERVICEREQUEST = _descriptor.Descriptor(
+    name="SetLoggingServiceRequest",
+    full_name="google.container.v1.SetLoggingServiceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetLoggingServiceRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetLoggingServiceRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetLoggingServiceRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_service",
+            full_name="google.container.v1.SetLoggingServiceRequest.logging_service",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetLoggingServiceRequest.name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5925,
+    serialized_end=6052,
+)
+
+
+_SETMONITORINGSERVICEREQUEST = _descriptor.Descriptor(
+    name="SetMonitoringServiceRequest",
+    full_name="google.container.v1.SetMonitoringServiceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetMonitoringServiceRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetMonitoringServiceRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetMonitoringServiceRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="monitoring_service",
+            full_name="google.container.v1.SetMonitoringServiceRequest.monitoring_service",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetMonitoringServiceRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6055,
+    serialized_end=6192,
+)
+
+
+_SETADDONSCONFIGREQUEST = _descriptor.Descriptor(
+    name="SetAddonsConfigRequest",
+    full_name="google.container.v1.SetAddonsConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetAddonsConfigRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetAddonsConfigRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetAddonsConfigRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="addons_config",
+            full_name="google.container.v1.SetAddonsConfigRequest.addons_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetAddonsConfigRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6195,
+    serialized_end=6357,
+)
+
+
+_SETLOCATIONSREQUEST = _descriptor.Descriptor(
+    name="SetLocationsRequest",
+    full_name="google.container.v1.SetLocationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetLocationsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetLocationsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetLocationsRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.container.v1.SetLocationsRequest.locations",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetLocationsRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6359,
+    serialized_end=6479,
+)
+
+
+_UPDATEMASTERREQUEST = _descriptor.Descriptor(
+    name="UpdateMasterRequest",
+    full_name="google.container.v1.UpdateMasterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.UpdateMasterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.UpdateMasterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.UpdateMasterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_version",
+            full_name="google.container.v1.UpdateMasterRequest.master_version",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.UpdateMasterRequest.name",
+            index=4,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6481,
+    serialized_end=6606,
+)
+
+
+_SETMASTERAUTHREQUEST = _descriptor.Descriptor(
+    name="SetMasterAuthRequest",
+    full_name="google.container.v1.SetMasterAuthRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetMasterAuthRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetMasterAuthRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetMasterAuthRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="action",
+            full_name="google.container.v1.SetMasterAuthRequest.action",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.container.v1.SetMasterAuthRequest.update",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetMasterAuthRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SETMASTERAUTHREQUEST_ACTION],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6609,
+    serialized_end=6908,
+)
+
+
+_DELETECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DeleteClusterRequest",
+    full_name="google.container.v1.DeleteClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.DeleteClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.DeleteClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.DeleteClusterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.DeleteClusterRequest.name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6910,
+    serialized_end=7012,
+)
+
+
+_LISTCLUSTERSREQUEST = _descriptor.Descriptor(
+    name="ListClustersRequest",
+    full_name="google.container.v1.ListClustersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.ListClustersRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.ListClustersRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1.ListClustersRequest.parent",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7014,
+    serialized_end=7093,
+)
+
+
+_LISTCLUSTERSRESPONSE = _descriptor.Descriptor(
+    name="ListClustersResponse",
+    full_name="google.container.v1.ListClustersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.container.v1.ListClustersResponse.clusters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing_zones",
+            full_name="google.container.v1.ListClustersResponse.missing_zones",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7095,
+    serialized_end=7188,
+)
+
+
+_GETOPERATIONREQUEST = _descriptor.Descriptor(
+    name="GetOperationRequest",
+    full_name="google.container.v1.GetOperationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.GetOperationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.GetOperationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.container.v1.GetOperationRequest.operation_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.GetOperationRequest.name",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7190,
+    serialized_end=7293,
+)
+
+
+_LISTOPERATIONSREQUEST = _descriptor.Descriptor(
+    name="ListOperationsRequest",
+    full_name="google.container.v1.ListOperationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.ListOperationsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.ListOperationsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1.ListOperationsRequest.parent",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7295,
+    serialized_end=7376,
+)
+
+
+_CANCELOPERATIONREQUEST = _descriptor.Descriptor(
+    name="CancelOperationRequest",
+    full_name="google.container.v1.CancelOperationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.CancelOperationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.CancelOperationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.container.v1.CancelOperationRequest.operation_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.CancelOperationRequest.name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7378,
+    serialized_end=7484,
+)
+
+
+_LISTOPERATIONSRESPONSE = _descriptor.Descriptor(
+    name="ListOperationsResponse",
+    full_name="google.container.v1.ListOperationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="operations",
+            full_name="google.container.v1.ListOperationsResponse.operations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing_zones",
+            full_name="google.container.v1.ListOperationsResponse.missing_zones",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7486,
+    serialized_end=7585,
+)
+
+
+_GETSERVERCONFIGREQUEST = _descriptor.Descriptor(
+    name="GetServerConfigRequest",
+    full_name="google.container.v1.GetServerConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.GetServerConfigRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.GetServerConfigRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.GetServerConfigRequest.name",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7587,
+    serialized_end=7667,
+)
+
+
+_SERVERCONFIG = _descriptor.Descriptor(
+    name="ServerConfig",
+    full_name="google.container.v1.ServerConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="default_cluster_version",
+            full_name="google.container.v1.ServerConfig.default_cluster_version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_node_versions",
+            full_name="google.container.v1.ServerConfig.valid_node_versions",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="default_image_type",
+            full_name="google.container.v1.ServerConfig.default_image_type",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_image_types",
+            full_name="google.container.v1.ServerConfig.valid_image_types",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_master_versions",
+            full_name="google.container.v1.ServerConfig.valid_master_versions",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7670,
+    serialized_end=7832,
+)
+
+
+_CREATENODEPOOLREQUEST = _descriptor.Descriptor(
+    name="CreateNodePoolRequest",
+    full_name="google.container.v1.CreateNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.CreateNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.CreateNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.CreateNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool",
+            full_name="google.container.v1.CreateNodePoolRequest.node_pool",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1.CreateNodePoolRequest.parent",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7835,
+    serialized_end=7990,
+)
+
+
+_DELETENODEPOOLREQUEST = _descriptor.Descriptor(
+    name="DeleteNodePoolRequest",
+    full_name="google.container.v1.DeleteNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.DeleteNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.DeleteNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.DeleteNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.DeleteNodePoolRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.DeleteNodePoolRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7993,
+    serialized_end=8122,
+)
+
+
+_LISTNODEPOOLSREQUEST = _descriptor.Descriptor(
+    name="ListNodePoolsRequest",
+    full_name="google.container.v1.ListNodePoolsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.ListNodePoolsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.ListNodePoolsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.ListNodePoolsRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1.ListNodePoolsRequest.parent",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8124,
+    serialized_end=8228,
+)
+
+
+_GETNODEPOOLREQUEST = _descriptor.Descriptor(
+    name="GetNodePoolRequest",
+    full_name="google.container.v1.GetNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.GetNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.GetNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.GetNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.GetNodePoolRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.GetNodePoolRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8230,
+    serialized_end=8356,
+)
+
+
+_NODEPOOL = _descriptor.Descriptor(
+    name="NodePool",
+    full_name="google.container.v1.NodePool",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.NodePool.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.container.v1.NodePool.config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_node_count",
+            full_name="google.container.v1.NodePool.initial_node_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="self_link",
+            full_name="google.container.v1.NodePool.self_link",
+            index=3,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.container.v1.NodePool.version",
+            index=4,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_group_urls",
+            full_name="google.container.v1.NodePool.instance_group_urls",
+            index=5,
+            number=102,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1.NodePool.status",
+            index=6,
+            number=103,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1.NodePool.status_message",
+            index=7,
+            number=104,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoscaling",
+            full_name="google.container.v1.NodePool.autoscaling",
+            index=8,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="management",
+            full_name="google.container.v1.NodePool.management",
+            index=9,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_NODEPOOL_STATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8359,
+    serialized_end=8855,
+)
+
+
+_NODEMANAGEMENT = _descriptor.Descriptor(
+    name="NodeManagement",
+    full_name="google.container.v1.NodeManagement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="auto_upgrade",
+            full_name="google.container.v1.NodeManagement.auto_upgrade",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auto_repair",
+            full_name="google.container.v1.NodeManagement.auto_repair",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="upgrade_options",
+            full_name="google.container.v1.NodeManagement.upgrade_options",
+            index=2,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8857,
+    serialized_end=8982,
+)
+
+
+_AUTOUPGRADEOPTIONS = _descriptor.Descriptor(
+    name="AutoUpgradeOptions",
+    full_name="google.container.v1.AutoUpgradeOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="auto_upgrade_start_time",
+            full_name="google.container.v1.AutoUpgradeOptions.auto_upgrade_start_time",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.container.v1.AutoUpgradeOptions.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8984,
+    serialized_end=9058,
+)
+
+
+_MAINTENANCEPOLICY = _descriptor.Descriptor(
+    name="MaintenancePolicy",
+    full_name="google.container.v1.MaintenancePolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="window",
+            full_name="google.container.v1.MaintenancePolicy.window",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9060,
+    serialized_end=9135,
+)
+
+
+_MAINTENANCEWINDOW = _descriptor.Descriptor(
+    name="MaintenanceWindow",
+    full_name="google.container.v1.MaintenanceWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="daily_maintenance_window",
+            full_name="google.container.v1.MaintenanceWindow.daily_maintenance_window",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="policy",
+            full_name="google.container.v1.MaintenanceWindow.policy",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=9137,
+    serialized_end=9247,
+)
+
+
+_DAILYMAINTENANCEWINDOW = _descriptor.Descriptor(
+    name="DailyMaintenanceWindow",
+    full_name="google.container.v1.DailyMaintenanceWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.container.v1.DailyMaintenanceWindow.start_time",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duration",
+            full_name="google.container.v1.DailyMaintenanceWindow.duration",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9249,
+    serialized_end=9311,
+)
+
+
+_SETNODEPOOLMANAGEMENTREQUEST = _descriptor.Descriptor(
+    name="SetNodePoolManagementRequest",
+    full_name="google.container.v1.SetNodePoolManagementRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetNodePoolManagementRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetNodePoolManagementRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetNodePoolManagementRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.SetNodePoolManagementRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="management",
+            full_name="google.container.v1.SetNodePoolManagementRequest.management",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetNodePoolManagementRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9314,
+    serialized_end=9507,
+)
+
+
+_SETNODEPOOLSIZEREQUEST = _descriptor.Descriptor(
+    name="SetNodePoolSizeRequest",
+    full_name="google.container.v1.SetNodePoolSizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetNodePoolSizeRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetNodePoolSizeRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetNodePoolSizeRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.SetNodePoolSizeRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_count",
+            full_name="google.container.v1.SetNodePoolSizeRequest.node_count",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetNodePoolSizeRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9510,
+    serialized_end=9660,
+)
+
+
+_ROLLBACKNODEPOOLUPGRADEREQUEST = _descriptor.Descriptor(
+    name="RollbackNodePoolUpgradeRequest",
+    full_name="google.container.v1.RollbackNodePoolUpgradeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.RollbackNodePoolUpgradeRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.RollbackNodePoolUpgradeRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.RollbackNodePoolUpgradeRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1.RollbackNodePoolUpgradeRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.RollbackNodePoolUpgradeRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9663,
+    serialized_end=9801,
+)
+
+
+_LISTNODEPOOLSRESPONSE = _descriptor.Descriptor(
+    name="ListNodePoolsResponse",
+    full_name="google.container.v1.ListNodePoolsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="node_pools",
+            full_name="google.container.v1.ListNodePoolsResponse.node_pools",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9803,
+    serialized_end=9877,
+)
+
+
+_NODEPOOLAUTOSCALING = _descriptor.Descriptor(
+    name="NodePoolAutoscaling",
+    full_name="google.container.v1.NodePoolAutoscaling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1.NodePoolAutoscaling.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_node_count",
+            full_name="google.container.v1.NodePoolAutoscaling.min_node_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_node_count",
+            full_name="google.container.v1.NodePoolAutoscaling.max_node_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9879,
+    serialized_end=9965,
+)
+
+
+_SETLABELSREQUEST_RESOURCELABELSENTRY = _descriptor.Descriptor(
+    name="ResourceLabelsEntry",
+    full_name="google.container.v1.SetLabelsRequest.ResourceLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1.SetLabelsRequest.ResourceLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1.SetLabelsRequest.ResourceLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3767,
+    serialized_end=3820,
+)
+
+_SETLABELSREQUEST = _descriptor.Descriptor(
+    name="SetLabelsRequest",
+    full_name="google.container.v1.SetLabelsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetLabelsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetLabelsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetLabelsRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_labels",
+            full_name="google.container.v1.SetLabelsRequest.resource_labels",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_fingerprint",
+            full_name="google.container.v1.SetLabelsRequest.label_fingerprint",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetLabelsRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SETLABELSREQUEST_RESOURCELABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9968,
+    serialized_end=10232,
+)
+
+
+_SETLEGACYABACREQUEST = _descriptor.Descriptor(
+    name="SetLegacyAbacRequest",
+    full_name="google.container.v1.SetLegacyAbacRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetLegacyAbacRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetLegacyAbacRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetLegacyAbacRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1.SetLegacyAbacRequest.enabled",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetLegacyAbacRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10234,
+    serialized_end=10353,
+)
+
+
+_STARTIPROTATIONREQUEST = _descriptor.Descriptor(
+    name="StartIPRotationRequest",
+    full_name="google.container.v1.StartIPRotationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.StartIPRotationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.StartIPRotationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.StartIPRotationRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.StartIPRotationRequest.name",
+            index=3,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rotate_credentials",
+            full_name="google.container.v1.StartIPRotationRequest.rotate_credentials",
+            index=4,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10356,
+    serialized_end=10488,
+)
+
+
+_COMPLETEIPROTATIONREQUEST = _descriptor.Descriptor(
+    name="CompleteIPRotationRequest",
+    full_name="google.container.v1.CompleteIPRotationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.CompleteIPRotationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.CompleteIPRotationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.CompleteIPRotationRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.CompleteIPRotationRequest.name",
+            index=3,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10490,
+    serialized_end=10597,
+)
+
+
+_ACCELERATORCONFIG = _descriptor.Descriptor(
+    name="AcceleratorConfig",
+    full_name="google.container.v1.AcceleratorConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="accelerator_count",
+            full_name="google.container.v1.AcceleratorConfig.accelerator_count",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerator_type",
+            full_name="google.container.v1.AcceleratorConfig.accelerator_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10599,
+    serialized_end=10671,
+)
+
+
+_SETNETWORKPOLICYREQUEST = _descriptor.Descriptor(
+    name="SetNetworkPolicyRequest",
+    full_name="google.container.v1.SetNetworkPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetNetworkPolicyRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetNetworkPolicyRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetNetworkPolicyRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_policy",
+            full_name="google.container.v1.SetNetworkPolicyRequest.network_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetNetworkPolicyRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10674,
+    serialized_end=10839,
+)
+
+
+_SETMAINTENANCEPOLICYREQUEST = _descriptor.Descriptor(
+    name="SetMaintenancePolicyRequest",
+    full_name="google.container.v1.SetMaintenancePolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1.SetMaintenancePolicyRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1.SetMaintenancePolicyRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1.SetMaintenancePolicyRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maintenance_policy",
+            full_name="google.container.v1.SetMaintenancePolicyRequest.maintenance_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1.SetMaintenancePolicyRequest.name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10842,
+    serialized_end=11007,
+)
+
+
+_NETWORKCONFIG = _descriptor.Descriptor(
+    name="NetworkConfig",
+    full_name="google.container.v1.NetworkConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="network",
+            full_name="google.container.v1.NetworkConfig.network",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork",
+            full_name="google.container.v1.NetworkConfig.subnetwork",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11009,
+    serialized_end=11061,
+)
+
+_NODECONFIG_METADATAENTRY.containing_type = _NODECONFIG
+_NODECONFIG_LABELSENTRY.containing_type = _NODECONFIG
+_NODECONFIG.fields_by_name["metadata"].message_type = _NODECONFIG_METADATAENTRY
+_NODECONFIG.fields_by_name["labels"].message_type = _NODECONFIG_LABELSENTRY
+_NODECONFIG.fields_by_name["accelerators"].message_type = _ACCELERATORCONFIG
+_MASTERAUTH.fields_by_name[
+    "client_certificate_config"
+].message_type = _CLIENTCERTIFICATECONFIG
+_ADDONSCONFIG.fields_by_name["http_load_balancing"].message_type = _HTTPLOADBALANCING
+_ADDONSCONFIG.fields_by_name[
+    "horizontal_pod_autoscaling"
+].message_type = _HORIZONTALPODAUTOSCALING
+_ADDONSCONFIG.fields_by_name["kubernetes_dashboard"].message_type = _KUBERNETESDASHBOARD
+_ADDONSCONFIG.fields_by_name[
+    "network_policy_config"
+].message_type = _NETWORKPOLICYCONFIG
+_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK.containing_type = (
+    _MASTERAUTHORIZEDNETWORKSCONFIG
+)
+_MASTERAUTHORIZEDNETWORKSCONFIG.fields_by_name[
+    "cidr_blocks"
+].message_type = _MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK
+_NETWORKPOLICY.fields_by_name["provider"].enum_type = _NETWORKPOLICY_PROVIDER
+_NETWORKPOLICY_PROVIDER.containing_type = _NETWORKPOLICY
+_CLUSTER_RESOURCELABELSENTRY.containing_type = _CLUSTER
+_CLUSTER.fields_by_name["node_config"].message_type = _NODECONFIG
+_CLUSTER.fields_by_name["master_auth"].message_type = _MASTERAUTH
+_CLUSTER.fields_by_name["addons_config"].message_type = _ADDONSCONFIG
+_CLUSTER.fields_by_name["node_pools"].message_type = _NODEPOOL
+_CLUSTER.fields_by_name["resource_labels"].message_type = _CLUSTER_RESOURCELABELSENTRY
+_CLUSTER.fields_by_name["legacy_abac"].message_type = _LEGACYABAC
+_CLUSTER.fields_by_name["network_policy"].message_type = _NETWORKPOLICY
+_CLUSTER.fields_by_name["ip_allocation_policy"].message_type = _IPALLOCATIONPOLICY
+_CLUSTER.fields_by_name[
+    "master_authorized_networks_config"
+].message_type = _MASTERAUTHORIZEDNETWORKSCONFIG
+_CLUSTER.fields_by_name["maintenance_policy"].message_type = _MAINTENANCEPOLICY
+_CLUSTER.fields_by_name["network_config"].message_type = _NETWORKCONFIG
+_CLUSTER.fields_by_name["private_cluster_config"].message_type = _PRIVATECLUSTERCONFIG
+_CLUSTER.fields_by_name["status"].enum_type = _CLUSTER_STATUS
+_CLUSTER_STATUS.containing_type = _CLUSTER
+_CLUSTERUPDATE.fields_by_name["desired_addons_config"].message_type = _ADDONSCONFIG
+_CLUSTERUPDATE.fields_by_name[
+    "desired_node_pool_autoscaling"
+].message_type = _NODEPOOLAUTOSCALING
+_CLUSTERUPDATE.fields_by_name[
+    "desired_master_authorized_networks_config"
+].message_type = _MASTERAUTHORIZEDNETWORKSCONFIG
+_OPERATION.fields_by_name["operation_type"].enum_type = _OPERATION_TYPE
+_OPERATION.fields_by_name["status"].enum_type = _OPERATION_STATUS
+_OPERATION_STATUS.containing_type = _OPERATION
+_OPERATION_TYPE.containing_type = _OPERATION
+_CREATECLUSTERREQUEST.fields_by_name["cluster"].message_type = _CLUSTER
+_UPDATECLUSTERREQUEST.fields_by_name["update"].message_type = _CLUSTERUPDATE
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name[
+    "autoscaling"
+].message_type = _NODEPOOLAUTOSCALING
+_SETADDONSCONFIGREQUEST.fields_by_name["addons_config"].message_type = _ADDONSCONFIG
+_SETMASTERAUTHREQUEST.fields_by_name["action"].enum_type = _SETMASTERAUTHREQUEST_ACTION
+_SETMASTERAUTHREQUEST.fields_by_name["update"].message_type = _MASTERAUTH
+_SETMASTERAUTHREQUEST_ACTION.containing_type = _SETMASTERAUTHREQUEST
+_LISTCLUSTERSRESPONSE.fields_by_name["clusters"].message_type = _CLUSTER
+_LISTOPERATIONSRESPONSE.fields_by_name["operations"].message_type = _OPERATION
+_CREATENODEPOOLREQUEST.fields_by_name["node_pool"].message_type = _NODEPOOL
+_NODEPOOL.fields_by_name["config"].message_type = _NODECONFIG
+_NODEPOOL.fields_by_name["status"].enum_type = _NODEPOOL_STATUS
+_NODEPOOL.fields_by_name["autoscaling"].message_type = _NODEPOOLAUTOSCALING
+_NODEPOOL.fields_by_name["management"].message_type = _NODEMANAGEMENT
+_NODEPOOL_STATUS.containing_type = _NODEPOOL
+_NODEMANAGEMENT.fields_by_name["upgrade_options"].message_type = _AUTOUPGRADEOPTIONS
+_MAINTENANCEPOLICY.fields_by_name["window"].message_type = _MAINTENANCEWINDOW
+_MAINTENANCEWINDOW.fields_by_name[
+    "daily_maintenance_window"
+].message_type = _DAILYMAINTENANCEWINDOW
+_MAINTENANCEWINDOW.oneofs_by_name["policy"].fields.append(
+    _MAINTENANCEWINDOW.fields_by_name["daily_maintenance_window"]
+)
+_MAINTENANCEWINDOW.fields_by_name[
+    "daily_maintenance_window"
+].containing_oneof = _MAINTENANCEWINDOW.oneofs_by_name["policy"]
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name[
+    "management"
+].message_type = _NODEMANAGEMENT
+_LISTNODEPOOLSRESPONSE.fields_by_name["node_pools"].message_type = _NODEPOOL
+_SETLABELSREQUEST_RESOURCELABELSENTRY.containing_type = _SETLABELSREQUEST
+_SETLABELSREQUEST.fields_by_name[
+    "resource_labels"
+].message_type = _SETLABELSREQUEST_RESOURCELABELSENTRY
+_SETNETWORKPOLICYREQUEST.fields_by_name["network_policy"].message_type = _NETWORKPOLICY
+_SETMAINTENANCEPOLICYREQUEST.fields_by_name[
+    "maintenance_policy"
+].message_type = _MAINTENANCEPOLICY
+DESCRIPTOR.message_types_by_name["NodeConfig"] = _NODECONFIG
+DESCRIPTOR.message_types_by_name["MasterAuth"] = _MASTERAUTH
+DESCRIPTOR.message_types_by_name["ClientCertificateConfig"] = _CLIENTCERTIFICATECONFIG
+DESCRIPTOR.message_types_by_name["AddonsConfig"] = _ADDONSCONFIG
+DESCRIPTOR.message_types_by_name["HttpLoadBalancing"] = _HTTPLOADBALANCING
+DESCRIPTOR.message_types_by_name["HorizontalPodAutoscaling"] = _HORIZONTALPODAUTOSCALING
+DESCRIPTOR.message_types_by_name["KubernetesDashboard"] = _KUBERNETESDASHBOARD
+DESCRIPTOR.message_types_by_name["NetworkPolicyConfig"] = _NETWORKPOLICYCONFIG
+DESCRIPTOR.message_types_by_name["PrivateClusterConfig"] = _PRIVATECLUSTERCONFIG
+DESCRIPTOR.message_types_by_name[
+    "MasterAuthorizedNetworksConfig"
+] = _MASTERAUTHORIZEDNETWORKSCONFIG
+DESCRIPTOR.message_types_by_name["LegacyAbac"] = _LEGACYABAC
+DESCRIPTOR.message_types_by_name["NetworkPolicy"] = _NETWORKPOLICY
+DESCRIPTOR.message_types_by_name["IPAllocationPolicy"] = _IPALLOCATIONPOLICY
+DESCRIPTOR.message_types_by_name["Cluster"] = _CLUSTER
+DESCRIPTOR.message_types_by_name["ClusterUpdate"] = _CLUSTERUPDATE
+DESCRIPTOR.message_types_by_name["Operation"] = _OPERATION
+DESCRIPTOR.message_types_by_name["CreateClusterRequest"] = _CREATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["GetClusterRequest"] = _GETCLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateClusterRequest"] = _UPDATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateNodePoolRequest"] = _UPDATENODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SetNodePoolAutoscalingRequest"
+] = _SETNODEPOOLAUTOSCALINGREQUEST
+DESCRIPTOR.message_types_by_name["SetLoggingServiceRequest"] = _SETLOGGINGSERVICEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SetMonitoringServiceRequest"
+] = _SETMONITORINGSERVICEREQUEST
+DESCRIPTOR.message_types_by_name["SetAddonsConfigRequest"] = _SETADDONSCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["SetLocationsRequest"] = _SETLOCATIONSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateMasterRequest"] = _UPDATEMASTERREQUEST
+DESCRIPTOR.message_types_by_name["SetMasterAuthRequest"] = _SETMASTERAUTHREQUEST
+DESCRIPTOR.message_types_by_name["DeleteClusterRequest"] = _DELETECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersRequest"] = _LISTCLUSTERSREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersResponse"] = _LISTCLUSTERSRESPONSE
+DESCRIPTOR.message_types_by_name["GetOperationRequest"] = _GETOPERATIONREQUEST
+DESCRIPTOR.message_types_by_name["ListOperationsRequest"] = _LISTOPERATIONSREQUEST
+DESCRIPTOR.message_types_by_name["CancelOperationRequest"] = _CANCELOPERATIONREQUEST
+DESCRIPTOR.message_types_by_name["ListOperationsResponse"] = _LISTOPERATIONSRESPONSE
+DESCRIPTOR.message_types_by_name["GetServerConfigRequest"] = _GETSERVERCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["ServerConfig"] = _SERVERCONFIG
+DESCRIPTOR.message_types_by_name["CreateNodePoolRequest"] = _CREATENODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name["DeleteNodePoolRequest"] = _DELETENODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name["ListNodePoolsRequest"] = _LISTNODEPOOLSREQUEST
+DESCRIPTOR.message_types_by_name["GetNodePoolRequest"] = _GETNODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name["NodePool"] = _NODEPOOL
+DESCRIPTOR.message_types_by_name["NodeManagement"] = _NODEMANAGEMENT
+DESCRIPTOR.message_types_by_name["AutoUpgradeOptions"] = _AUTOUPGRADEOPTIONS
+DESCRIPTOR.message_types_by_name["MaintenancePolicy"] = _MAINTENANCEPOLICY
+DESCRIPTOR.message_types_by_name["MaintenanceWindow"] = _MAINTENANCEWINDOW
+DESCRIPTOR.message_types_by_name["DailyMaintenanceWindow"] = _DAILYMAINTENANCEWINDOW
+DESCRIPTOR.message_types_by_name[
+    "SetNodePoolManagementRequest"
+] = _SETNODEPOOLMANAGEMENTREQUEST
+DESCRIPTOR.message_types_by_name["SetNodePoolSizeRequest"] = _SETNODEPOOLSIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RollbackNodePoolUpgradeRequest"
+] = _ROLLBACKNODEPOOLUPGRADEREQUEST
+DESCRIPTOR.message_types_by_name["ListNodePoolsResponse"] = _LISTNODEPOOLSRESPONSE
+DESCRIPTOR.message_types_by_name["NodePoolAutoscaling"] = _NODEPOOLAUTOSCALING
+DESCRIPTOR.message_types_by_name["SetLabelsRequest"] = _SETLABELSREQUEST
+DESCRIPTOR.message_types_by_name["SetLegacyAbacRequest"] = _SETLEGACYABACREQUEST
+DESCRIPTOR.message_types_by_name["StartIPRotationRequest"] = _STARTIPROTATIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CompleteIPRotationRequest"
+] = _COMPLETEIPROTATIONREQUEST
+DESCRIPTOR.message_types_by_name["AcceleratorConfig"] = _ACCELERATORCONFIG
+DESCRIPTOR.message_types_by_name["SetNetworkPolicyRequest"] = _SETNETWORKPOLICYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SetMaintenancePolicyRequest"
+] = _SETMAINTENANCEPOLICYREQUEST
+DESCRIPTOR.message_types_by_name["NetworkConfig"] = _NETWORKCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+NodeConfig = _reflection.GeneratedProtocolMessageType(
+    "NodeConfig",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_NODECONFIG_METADATAENTRY,
+                __module__="google.cloud.container_v1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1.NodeConfig.MetadataEntry)
+            ),
+        ),
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_NODECONFIG_LABELSENTRY,
+                __module__="google.cloud.container_v1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1.NodeConfig.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_NODECONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Parameters that describe the nodes in a cluster.
+  
+  
+  Attributes:
+      machine_type:
+          The name of a Google Compute Engine `machine type
+          </compute/docs/machine-types>`__ (e.g. ``n1-standard-1``).  If
+          unspecified, the default machine type is ``n1-standard-1``.
+      disk_size_gb:
+          Size of the disk attached to each node, specified in GB. The
+          smallest allowed disk size is 10GB.  If unspecified, the
+          default disk size is 100GB.
+      oauth_scopes:
+          The set of Google API scopes to be made available on all of
+          the node VMs under the "default" service account.  The
+          following scopes are recommended, but not required, and by
+          default are not included:  -
+          ``https://www.googleapis.com/auth/compute`` is required for
+          mounting    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/>`__).  If
+          unspecified, no scopes are added, unless Cloud Logging or
+          Cloud Monitoring are enabled, in which case their required
+          scopes will be added.
+      service_account:
+          The Google Cloud Platform Service Account to be used by the
+          node VMs. If no Service Account is specified, the "default"
+          service account is used.
+      metadata:
+          The metadata key/value pairs assigned to instances in the
+          cluster.  Keys must conform to the regexp [a-zA-Z0-9-\_]+ and
+          be less than 128 bytes in length. These are reflected as part
+          of a URL in the metadata server. Additionally, to avoid
+          ambiguity, keys must not conflict with any other metadata keys
+          for the project or be one of the reserved keys: "cluster-
+          location" "cluster-name" "cluster-uid" "configure-sh" "enable-
+          os-login" "gci-update-strategy" "gci-ensure-gke-docker"
+          "instance-template" "kube-env" "startup-script" "user-data"
+          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.  The total size of all keys and
+          values must be less than 512 KB.
+      image_type:
+          The image type to use for this node. Note that for a given
+          image type, the latest version of it will be used.
+      labels:
+          The map of Kubernetes labels (key/value pairs) to be applied
+          to each node. These will added in addition to any default
+          label(s) that Kubernetes may apply to the node. In case of
+          conflict in label keys, the applied set may differ depending
+          on the Kubernetes version -- it's best to assume the behavior
+          is undefined and conflicts should be avoided. For more
+          information, including usage and the valid values, see:
+          https://kubernetes.io/docs/concepts/overview/working-with-
+          objects/labels/
+      local_ssd_count:
+          The number of local SSD disks to be attached to the node.  The
+          limit for this value is dependant 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 for more information.
+      tags:
+          The list of instance tags applied to all nodes. Tags are used
+          to identify valid sources or targets for network firewalls and
+          are specified by the client during cluster or node pool
+          creation. Each tag within the list must comply with RFC1035.
+      preemptible:
+          Whether the nodes are created as preemptible VM instances.
+          See:
+          https://cloud.google.com/compute/docs/instances/preemptible
+          for more information about preemptible VM instances.
+      accelerators:
+          A list of hardware accelerators to be attached to each node.
+          See https://cloud.google.com/compute/docs/gpus for more
+          information about support for GPUs.
+      disk_type:
+          Type of the disk attached to each node (e.g. 'pd-standard' or
+          'pd-ssd')  If unspecified, the default disk type is 'pd-
+          standard'
+      min_cpu_platform:
+          Minimum CPU platform to be used by this instance. The instance
+          may be scheduled on the specified or newer CPU platform.
+          Applicable values are the friendly names of CPU platforms,
+          such as minCpuPlatform: "Intel Haswell" or 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>`__
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NodeConfig)
+    ),
+)
+_sym_db.RegisterMessage(NodeConfig)
+_sym_db.RegisterMessage(NodeConfig.MetadataEntry)
+_sym_db.RegisterMessage(NodeConfig.LabelsEntry)
+
+MasterAuth = _reflection.GeneratedProtocolMessageType(
+    "MasterAuth",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MASTERAUTH,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""The authentication information for accessing the master endpoint.
+  Authentication can be done using HTTP basic auth or using client
+  certificates.
+  
+  
+  Attributes:
+      username:
+          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.
+      password:
+          The password to use for HTTP basic authentication to the
+          master endpoint. Because the master endpoint is open to the
+          Internet, you should create a strong password. If a password
+          is provided for cluster creation, username must be non-empty.
+      client_certificate_config:
+          Configuration for client certificate authentication on the
+          cluster. For clusters before v1.12, if no configuration is
+          specified, a client certificate is issued.
+      cluster_ca_certificate:
+          [Output only] Base64-encoded public certificate that is the
+          root of trust for the cluster.
+      client_certificate:
+          [Output only] Base64-encoded public certificate used by
+          clients to authenticate to the cluster endpoint.
+      client_key:
+          [Output only] Base64-encoded private key used by clients to
+          authenticate to the cluster endpoint.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.MasterAuth)
+    ),
+)
+_sym_db.RegisterMessage(MasterAuth)
+
+ClientCertificateConfig = _reflection.GeneratedProtocolMessageType(
+    "ClientCertificateConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLIENTCERTIFICATECONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration for client certificates on the cluster.
+  
+  
+  Attributes:
+      issue_client_certificate:
+          Issue a client certificate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ClientCertificateConfig)
+    ),
+)
+_sym_db.RegisterMessage(ClientCertificateConfig)
+
+AddonsConfig = _reflection.GeneratedProtocolMessageType(
+    "AddonsConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDONSCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the addons that can be automatically spun up in the
+  cluster, enabling additional functionality.
+  
+  
+  Attributes:
+      http_load_balancing:
+          Configuration for the HTTP (L7) load balancing controller
+          addon, which makes it easy to set up HTTP load balancers for
+          services in a cluster.
+      horizontal_pod_autoscaling:
+          Configuration for the horizontal pod autoscaling feature,
+          which increases or decreases the number of replica pods a
+          replication controller has based on the resource usage of the
+          existing pods.
+      kubernetes_dashboard:
+          Configuration for the Kubernetes Dashboard.
+      network_policy_config:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.AddonsConfig)
+    ),
+)
+_sym_db.RegisterMessage(AddonsConfig)
+
+HttpLoadBalancing = _reflection.GeneratedProtocolMessageType(
+    "HttpLoadBalancing",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HTTPLOADBALANCING,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the HTTP (L7) load balancing controller addon,
+  which makes it easy to set up HTTP load balancers for services in a
+  cluster.
+  
+  
+  Attributes:
+      disabled:
+          Whether the HTTP Load Balancing controller is enabled in the
+          cluster. When enabled, it runs a small pod in the cluster that
+          manages the load balancers.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.HttpLoadBalancing)
+    ),
+)
+_sym_db.RegisterMessage(HttpLoadBalancing)
+
+HorizontalPodAutoscaling = _reflection.GeneratedProtocolMessageType(
+    "HorizontalPodAutoscaling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HORIZONTALPODAUTOSCALING,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the horizontal pod autoscaling feature, which
+  increases or decreases the number of replica pods a replication
+  controller has based on the resource usage of the existing pods.
+  
+  
+  Attributes:
+      disabled:
+          Whether the Horizontal Pod Autoscaling feature is enabled in
+          the cluster. When enabled, it ensures that a Heapster pod is
+          running in the cluster, which is also used by the Cloud
+          Monitoring service.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.HorizontalPodAutoscaling)
+    ),
+)
+_sym_db.RegisterMessage(HorizontalPodAutoscaling)
+
+KubernetesDashboard = _reflection.GeneratedProtocolMessageType(
+    "KubernetesDashboard",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KUBERNETESDASHBOARD,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the Kubernetes Dashboard.
+  
+  
+  Attributes:
+      disabled:
+          Whether the Kubernetes Dashboard is enabled for this cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.KubernetesDashboard)
+    ),
+)
+_sym_db.RegisterMessage(KubernetesDashboard)
+
+NetworkPolicyConfig = _reflection.GeneratedProtocolMessageType(
+    "NetworkPolicyConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NETWORKPOLICYCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      disabled:
+          Whether NetworkPolicy is enabled for this cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NetworkPolicyConfig)
+    ),
+)
+_sym_db.RegisterMessage(NetworkPolicyConfig)
+
+PrivateClusterConfig = _reflection.GeneratedProtocolMessageType(
+    "PrivateClusterConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRIVATECLUSTERCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for private clusters.
+  
+  
+  Attributes:
+      enable_private_nodes:
+          Whether nodes have internal IP addresses only. If enabled, all
+          nodes are given only RFC 1918 private addresses and
+          communicate with the master via private networking.
+      enable_private_endpoint:
+          Whether the master's internal IP address is used as the
+          cluster endpoint.
+      master_ipv4_cidr_block:
+          The IP range in CIDR notation to use for the hosted master
+          network. This range will be used for assigning internal IP
+          addresses to the master or set of masters, as well as the ILB
+          VIP. This range must not overlap with any other ranges in use
+          within the cluster's network.
+      private_endpoint:
+          Output only. The internal IP address of this cluster's master
+          endpoint.
+      public_endpoint:
+          Output only. The external IP address of this cluster's master
+          endpoint.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.PrivateClusterConfig)
+    ),
+)
+_sym_db.RegisterMessage(PrivateClusterConfig)
+
+MasterAuthorizedNetworksConfig = _reflection.GeneratedProtocolMessageType(
+    "MasterAuthorizedNetworksConfig",
+    (_message.Message,),
+    dict(
+        CidrBlock=_reflection.GeneratedProtocolMessageType(
+            "CidrBlock",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK,
+                __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+                __doc__="""CidrBlock contains an optional name and one CIDR block.
+    
+    
+    Attributes:
+        display_name:
+            display\_name is an optional field for users to identify CIDR
+            blocks.
+        cidr_block:
+            cidr\_block must be specified in CIDR notation.
+    """,
+                # @@protoc_insertion_point(class_scope:google.container.v1.MasterAuthorizedNetworksConfig.CidrBlock)
+            ),
+        ),
+        DESCRIPTOR=_MASTERAUTHORIZEDNETWORKSCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""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, Google Compute Engine Public IPs and Google Prod IPs.
+  
+  
+  Attributes:
+      enabled:
+          Whether or not master authorized networks is enabled.
+      cidr_blocks:
+          cidr\_blocks define up to 10 external networks that could
+          access Kubernetes master through HTTPS.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.MasterAuthorizedNetworksConfig)
+    ),
+)
+_sym_db.RegisterMessage(MasterAuthorizedNetworksConfig)
+_sym_db.RegisterMessage(MasterAuthorizedNetworksConfig.CidrBlock)
+
+LegacyAbac = _reflection.GeneratedProtocolMessageType(
+    "LegacyAbac",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LEGACYABAC,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the legacy Attribute Based Access Control
+  authorization mode.
+  
+  
+  Attributes:
+      enabled:
+          Whether the ABAC authorizer is enabled for this cluster. When
+          enabled, identities in the system, including service accounts,
+          nodes, and controllers, will have statically granted
+          permissions beyond those provided by the RBAC configuration or
+          IAM.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.LegacyAbac)
+    ),
+)
+_sym_db.RegisterMessage(LegacyAbac)
+
+NetworkPolicy = _reflection.GeneratedProtocolMessageType(
+    "NetworkPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NETWORKPOLICY,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the NetworkPolicy feature.
+  https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+  
+  
+  Attributes:
+      provider:
+          The selected network policy provider.
+      enabled:
+          Whether network policy is enabled on the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NetworkPolicy)
+    ),
+)
+_sym_db.RegisterMessage(NetworkPolicy)
+
+IPAllocationPolicy = _reflection.GeneratedProtocolMessageType(
+    "IPAllocationPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IPALLOCATIONPOLICY,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Configuration for controlling how IPs are allocated in the cluster.
+  
+  
+  Attributes:
+      use_ip_aliases:
+          Whether alias IPs will be used for pod IPs in the cluster.
+      create_subnetwork:
+          Whether a new subnetwork will be created automatically for the
+          cluster.  This field is only applicable when
+          ``use_ip_aliases`` is true.
+      subnetwork_name:
+          A custom subnetwork name to be used if ``create_subnetwork``
+          is true. If this field is empty, then an automatic name will
+          be chosen for the new subnetwork.
+      cluster_ipv4_cidr:
+          This field is deprecated, use cluster\_ipv4\_cidr\_block.
+      node_ipv4_cidr:
+          This field is deprecated, use node\_ipv4\_cidr\_block.
+      services_ipv4_cidr:
+          This field is deprecated, use services\_ipv4\_cidr\_block.
+      cluster_secondary_range_name:
+          The name of the secondary range to be used for the cluster
+          CIDR block. The secondary range will be used for pod IP
+          addresses. This must be an existing secondary range associated
+          with the cluster subnetwork.  This field is only applicable
+          with use\_ip\_aliases is true and create\_subnetwork is false.
+      services_secondary_range_name:
+          The name of the secondary range to be used as for the services
+          CIDR block. The secondary range will be used for service
+          ClusterIPs. This must be an existing secondary range
+          associated with the cluster subnetwork.  This field is only
+          applicable with use\_ip\_aliases is true and
+          create\_subnetwork is false.
+      cluster_ipv4_cidr_block:
+          The IP address range for the cluster pod IPs. If this field is
+          set, then ``cluster.cluster_ipv4_cidr`` must be left blank.
+          This field is only applicable when ``use_ip_aliases`` is true.
+          Set to blank to have a range chosen with 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.
+      node_ipv4_cidr_block:
+          The IP address range of the instance IPs in this cluster.
+          This is applicable only if ``create_subnetwork`` is true.  Set
+          to blank to have a range chosen with 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.
+      services_ipv4_cidr_block:
+          The IP address range of the services IPs in this cluster. If
+          blank, a range will be automatically chosen with the default
+          size.  This field is only applicable when ``use_ip_aliases``
+          is true.  Set to blank to have a range chosen with 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.IPAllocationPolicy)
+    ),
+)
+_sym_db.RegisterMessage(IPAllocationPolicy)
+
+Cluster = _reflection.GeneratedProtocolMessageType(
+    "Cluster",
+    (_message.Message,),
+    dict(
+        ResourceLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ResourceLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTER_RESOURCELABELSENTRY,
+                __module__="google.cloud.container_v1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1.Cluster.ResourceLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTER,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""A Google Kubernetes Engine cluster.
+  
+  
+  Attributes:
+      name:
+          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:  -  Lowercase letters, numbers, and
+          hyphens only. -  Must start with a letter. -  Must end with a
+          number or a letter.
+      description:
+          An optional description of this cluster.
+      initial_node_count:
+          The number of nodes to create in this cluster. You must ensure
+          that your Compute Engine resource quota is sufficient for this
+          number of instances. You must also have available firewall and
+          routes quota. For requests, this field should only be used in
+          lieu of a "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.
+      node_config:
+          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.
+          If unspecified, the defaults are used.
+      master_auth:
+          The authentication information for accessing the master
+          endpoint.
+      logging_service:
+          The logging service the cluster should use to write logs.
+          Currently available options:  -  ``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.
+      monitoring_service:
+          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. -  if left as an empty string,
+          ``monitoring.googleapis.com`` will be    used.
+      network:
+          The name of the Google Compute Engine `network
+          </compute/docs/networks-and-firewalls#networks>`__ to which
+          the cluster is connected. If left unspecified, the ``default``
+          network will be used.
+      cluster_ipv4_cidr:
+          The IP address range of the container pods in this cluster, in
+          `CIDR <http://en.wikipedia.org/wiki/Classless_Inter-
+          Domain_Routing>`__ notation (e.g. ``10.96.0.0/14``). Leave
+          blank to have one automatically chosen or specify a ``/14``
+          block in ``10.0.0.0/8``.
+      addons_config:
+          Configurations for the various addons available to run in the
+          cluster.
+      subnetwork:
+          The name of the Google Compute Engine `subnetwork
+          </compute/docs/subnetworks>`__ to which the cluster is
+          connected.
+      node_pools:
+          The node pools associated with this cluster. This field should
+          not be set if "node\_config" or "initial\_node\_count" are
+          specified.
+      locations:
+          The list of Google Compute Engine `locations
+          </compute/docs/zones#available>`__ in which the cluster's
+          nodes should be located.
+      enable_kubernetes_alpha:
+          Kubernetes alpha features are enabled on this cluster. This
+          includes alpha API groups (e.g. v1alpha1) and features that
+          may not be production ready in the kubernetes version of the
+          master and nodes. The cluster has no SLA for uptime and
+          master/node upgrades are disabled. Alpha enabled clusters are
+          automatically deleted thirty days after creation.
+      resource_labels:
+          The resource labels for the cluster to use to annotate any
+          related Google Compute Engine resources.
+      label_fingerprint:
+          The fingerprint of the set of labels for this cluster.
+      legacy_abac:
+          Configuration for the legacy ABAC authorization mode.
+      network_policy:
+          Configuration options for the NetworkPolicy feature.
+      ip_allocation_policy:
+          Configuration for cluster IP allocation.
+      master_authorized_networks_config:
+          The configuration options for master authorized networks
+          feature.
+      maintenance_policy:
+          Configure the maintenance policy for this cluster.
+      network_config:
+          Configuration for cluster networking.
+      private_cluster_config:
+          Configuration for private cluster.
+      self_link:
+          [Output only] Server-defined URL for the resource.
+      zone:
+          [Output only] The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field is deprecated, use location instead.
+      endpoint:
+          [Output only] The IP address of this cluster's master
+          endpoint. The endpoint can be accessed from the internet at
+          ``https://username:password@endpoint/``.  See the
+          ``masterAuth`` property of this resource for username and
+          password information.
+      initial_cluster_version:
+          The initial Kubernetes version for this cluster. Valid
+          versions are those found in validMasterVersions returned by
+          getServerConfig. The version can be upgraded over time; such
+          upgrades are reflected in currentMasterVersion and
+          currentNodeVersion.  Users may specify either explicit
+          versions offered by Kubernetes Engine or version aliases,
+          which have the following behavior:  -  "latest": picks the
+          highest valid Kubernetes version -  "1.X": picks the highest
+          valid patch+gke.N patch in the 1.X version -  "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
+      current_master_version:
+          [Output only] The current software version of the master
+          endpoint.
+      current_node_version:
+          [Output only] Deprecated, use `NodePool.version </kubernetes-e
+          ngine/docs/reference/rest/v1/projects.zones.clusters.nodePool>`__
+          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.
+      create_time:
+          [Output only] The time the cluster was created, in `RFC3339
+          <https://www.ietf.org/rfc/rfc3339.txt>`__ text format.
+      status:
+          [Output only] The current status of this cluster.
+      status_message:
+          [Output only] Additional information about the current status
+          of this cluster, if available.
+      node_ipv4_cidr_size:
+          [Output only] The size of the address space on each node for
+          hosting containers. This is provisioned from within the
+          ``container_ipv4_cidr`` range.
+      services_ipv4_cidr:
+          [Output only] The IP address range of the Kubernetes services
+          in this cluster, in `CIDR
+          <http://en.wikipedia.org/wiki/Classless_Inter-
+          Domain_Routing>`__ notation (e.g. ``1.2.3.4/29``). Service
+          addresses are typically put in the last ``/16`` from the
+          container CIDR.
+      instance_group_urls:
+          Deprecated. Use node\_pools.instance\_group\_urls.
+      current_node_count:
+          [Output only] The number of nodes currently in the cluster.
+      expire_time:
+          [Output only] The time the cluster will be automatically
+          deleted in `RFC3339 <https://www.ietf.org/rfc/rfc3339.txt>`__
+          text format.
+      location:
+          [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 the cluster resides.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.Cluster)
+    ),
+)
+_sym_db.RegisterMessage(Cluster)
+_sym_db.RegisterMessage(Cluster.ResourceLabelsEntry)
+
+ClusterUpdate = _reflection.GeneratedProtocolMessageType(
+    "ClusterUpdate",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERUPDATE,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ClusterUpdate describes an update to the cluster. Exactly one update can
+  be applied to a cluster with each request, so at most one field can be
+  provided.
+  
+  
+  Attributes:
+      desired_node_version:
+          The Kubernetes version to change the nodes to (typically an
+          upgrade).  Users may specify either explicit versions offered
+          by Kubernetes Engine or version aliases, which have the
+          following behavior:  -  "latest": picks the highest valid
+          Kubernetes version -  "1.X": picks the highest valid
+          patch+gke.N patch in the 1.X version -  "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
+      desired_monitoring_service:
+          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
+      desired_addons_config:
+          Configurations for the various addons available to run in the
+          cluster.
+      desired_node_pool_id:
+          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_image_type:
+          The desired image type for the node pool. NOTE: Set the
+          "desired\_node\_pool" field as well.
+      desired_node_pool_autoscaling:
+          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 the
+          change applies to that single node pool.
+      desired_locations:
+          The desired list of Google Compute Engine `locations
+          </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.
+      desired_master_authorized_networks_config:
+          The desired configuration options for master authorized
+          networks feature.
+      desired_master_version:
+          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:  -
+          "latest": picks the highest valid Kubernetes version -  "1.X":
+          picks the highest valid patch+gke.N patch in the 1.X version -
+          "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
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ClusterUpdate)
+    ),
+)
+_sym_db.RegisterMessage(ClusterUpdate)
+
+Operation = _reflection.GeneratedProtocolMessageType(
+    "Operation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATION,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""This operation resource represents operations that may have happened or
+  are happening on the cluster. All fields are output only.
+  
+  
+  Attributes:
+      name:
+          The server-assigned ID for the operation.
+      zone:
+          The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the operation is
+          taking place. This field is deprecated, use location instead.
+      operation_type:
+          The operation type.
+      status:
+          The current status of the operation.
+      detail:
+          Detailed operation progress, if available.
+      status_message:
+          If an error has occurred, a textual description of the error.
+      self_link:
+          Server-defined URL for the resource.
+      target_link:
+          Server-defined URL for the target of the operation.
+      location:
+          [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 the cluster resides.
+      start_time:
+          [Output only] The time the operation started, in `RFC3339
+          <https://www.ietf.org/rfc/rfc3339.txt>`__ text format.
+      end_time:
+          [Output only] The time the operation completed, in `RFC3339
+          <https://www.ietf.org/rfc/rfc3339.txt>`__ text format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.Operation)
+    ),
+)
+_sym_db.RegisterMessage(Operation)
+
+CreateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLUSTERREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""CreateClusterRequest creates a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          parent field.
+      cluster:
+          A `cluster resource </container-
+          engine/reference/rest/v1/projects.zones.clusters>`__
+      parent:
+          The parent (project and location) where the cluster will be
+          created. Specified in the format 'projects/*/locations/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.CreateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateClusterRequest)
+
+GetClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "GetClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCLUSTERREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""GetClusterRequest gets the settings of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to retrieve. This field
+          has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster) of the cluster to
+          retrieve. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.GetClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetClusterRequest)
+
+UpdateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECLUSTERREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""UpdateClusterRequest updates the settings of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      update:
+          A description of the update.
+      name:
+          The name (project, location, cluster) of the cluster to
+          update. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.UpdateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateClusterRequest)
+
+UpdateNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATENODEPOOLREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""UpdateNodePoolRequests update a node pool's image and/or version.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to upgrade. This field
+          has been deprecated and replaced by the name field.
+      node_version:
+          The Kubernetes version to change the nodes to (typically an
+          upgrade).  Users may specify either explicit versions offered
+          by Kubernetes Engine or version aliases, which have the
+          following behavior:  -  "latest": picks the highest valid
+          Kubernetes version -  "1.X": picks the highest valid
+          patch+gke.N patch in the 1.X version -  "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
+      image_type:
+          The desired image type for the node pool.
+      name:
+          The name (project, location, cluster, node pool) of the node
+          pool to update. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.UpdateNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateNodePoolRequest)
+
+SetNodePoolAutoscalingRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNodePoolAutoscalingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNODEPOOLAUTOSCALINGREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolAutoscalingRequest sets the autoscaler settings of a node
+  pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to upgrade. This field
+          has been deprecated and replaced by the name field.
+      autoscaling:
+          Autoscaling configuration for the node pool.
+      name:
+          The name (project, location, cluster, node pool) of the node
+          pool to set autoscaler settings. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetNodePoolAutoscalingRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNodePoolAutoscalingRequest)
+
+SetLoggingServiceRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLoggingServiceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETLOGGINGSERVICEREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetLoggingServiceRequest sets the logging service of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      logging_service:
+          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
+      name:
+          The name (project, location, cluster) of the cluster to set
+          logging. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetLoggingServiceRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLoggingServiceRequest)
+
+SetMonitoringServiceRequest = _reflection.GeneratedProtocolMessageType(
+    "SetMonitoringServiceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETMONITORINGSERVICEREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetMonitoringServiceRequest sets the monitoring service of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      monitoring_service:
+          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
+      name:
+          The name (project, location, cluster) of the cluster to set
+          monitoring. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetMonitoringServiceRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetMonitoringServiceRequest)
+
+SetAddonsConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "SetAddonsConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETADDONSCONFIGREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetAddonsConfigRequest sets the addons associated with the cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      addons_config:
+          The desired configurations for the various addons available to
+          run in the cluster.
+      name:
+          The name (project, location, cluster) of the cluster to set
+          addons. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetAddonsConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetAddonsConfigRequest)
+
+SetLocationsRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLocationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETLOCATIONSREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetLocationsRequest sets the locations of the cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      locations:
+          The desired list of Google Compute Engine `locations
+          </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.
+      name:
+          The name (project, location, cluster) of the cluster to set
+          locations. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetLocationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLocationsRequest)
+
+UpdateMasterRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateMasterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEMASTERREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""UpdateMasterRequest updates the master of the cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      master_version:
+          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:  -
+          "latest": picks the highest valid Kubernetes version -  "1.X":
+          picks the highest valid patch+gke.N patch in the 1.X version -
+          "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
+      name:
+          The name (project, location, cluster) of the cluster to
+          update. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.UpdateMasterRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateMasterRequest)
+
+SetMasterAuthRequest = _reflection.GeneratedProtocolMessageType(
+    "SetMasterAuthRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETMASTERAUTHREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetMasterAuthRequest updates the admin password of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      action:
+          The exact form of action to be taken on the master auth.
+      update:
+          A description of the update.
+      name:
+          The name (project, location, cluster) of the cluster to set
+          auth. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetMasterAuthRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetMasterAuthRequest)
+
+DeleteClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETECLUSTERREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""DeleteClusterRequest deletes a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to delete. This field has
+          been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster) of the cluster to
+          delete. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.DeleteClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteClusterRequest)
+
+ListClustersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListClustersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ListClustersRequest lists clusters.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides, or "-" for all zones. This field has been deprecated
+          and replaced by the parent field.
+      parent:
+          The parent (project and location) where the clusters will be
+          listed. Specified in the format 'projects/*/locations/*'.
+          Location "-" matches all zones and all regions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ListClustersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersRequest)
+
+ListClustersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListClustersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSRESPONSE,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ListClustersResponse is the result of ListClustersRequest.
+  
+  
+  Attributes:
+      clusters:
+          A list of clusters in the project in the specified zone, or
+          across all ones.
+      missing_zones:
+          If any zones are listed here, the list of clusters returned
+          may be missing those zones.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ListClustersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersResponse)
+
+GetOperationRequest = _reflection.GeneratedProtocolMessageType(
+    "GetOperationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETOPERATIONREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""GetOperationRequest gets a single operation.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      operation_id:
+          Deprecated. The server-assigned ``name`` of the operation.
+          This field has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, operation id) of the operation to
+          get. Specified in the format
+          'projects/*/locations/*/operations/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.GetOperationRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetOperationRequest)
+
+ListOperationsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListOperationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTOPERATIONSREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ListOperationsRequest lists operations.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ to return operations for,
+          or ``-`` for all zones. This field has been deprecated and
+          replaced by the parent field.
+      parent:
+          The parent (project and location) where the operations will be
+          listed. Specified in the format 'projects/*/locations/*'.
+          Location "-" matches all zones and all regions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ListOperationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListOperationsRequest)
+
+CancelOperationRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelOperationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELOPERATIONREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""CancelOperationRequest cancels a single operation.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the operation
+          resides. This field has been deprecated and replaced by the
+          name field.
+      operation_id:
+          Deprecated. The server-assigned ``name`` of the operation.
+          This field has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, operation id) of the operation to
+          cancel. Specified in the format
+          'projects/*/locations/*/operations/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.CancelOperationRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelOperationRequest)
+
+ListOperationsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListOperationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTOPERATIONSRESPONSE,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ListOperationsResponse is the result of ListOperationsRequest.
+  
+  
+  Attributes:
+      operations:
+          A list of operations in the project in the specified zone.
+      missing_zones:
+          If any zones are listed here, the list of operations returned
+          may be missing the operations from those zones.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ListOperationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListOperationsResponse)
+
+GetServerConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetServerConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSERVERCONFIGREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Gets the current Kubernetes Engine service configuration.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ to return operations for.
+          This field has been deprecated and replaced by the name field.
+      name:
+          The name (project and location) of the server config to get
+          Specified in the format 'projects/*/locations/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.GetServerConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetServerConfigRequest)
+
+ServerConfig = _reflection.GeneratedProtocolMessageType(
+    "ServerConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SERVERCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Kubernetes Engine service configuration.
+  
+  
+  Attributes:
+      default_cluster_version:
+          Version of Kubernetes the service deploys by default.
+      valid_node_versions:
+          List of valid node upgrade target versions.
+      default_image_type:
+          Default image type.
+      valid_image_types:
+          List of valid image types.
+      valid_master_versions:
+          List of valid master versions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ServerConfig)
+    ),
+)
+_sym_db.RegisterMessage(ServerConfig)
+
+CreateNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATENODEPOOLREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""CreateNodePoolRequest creates a node pool for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          parent field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the parent field.
+      node_pool:
+          The node pool to create.
+      parent:
+          The parent (project, location, cluster id) where the node pool
+          will be created. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.CreateNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateNodePoolRequest)
+
+DeleteNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETENODEPOOLREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""DeleteNodePoolRequest deletes a node pool for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to delete. This field
+          has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to delete. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.DeleteNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteNodePoolRequest)
+
+ListNodePoolsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListNodePoolsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNODEPOOLSREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ListNodePoolsRequest lists the node pool(s) for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          parent field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the parent field.
+      parent:
+          The parent (project, location, cluster id) where the node
+          pools will be listed. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ListNodePoolsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListNodePoolsRequest)
+
+GetNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "GetNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNODEPOOLREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""GetNodePoolRequest retrieves a node pool for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool. This field has been
+          deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to get. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.GetNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetNodePoolRequest)
+
+NodePool = _reflection.GeneratedProtocolMessageType(
+    "NodePool",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEPOOL,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""NodePool contains the name and configuration for a cluster's node pool.
+  Node pools are a set of nodes (i.e. VM's), with a common configuration
+  and specification, under the control of the cluster master. They may
+  have a set of Kubernetes labels applied to them, which may be used to
+  reference them during pod scheduling. They may also be resized up or
+  down, to accommodate the workload.
+  
+  
+  Attributes:
+      name:
+          The name of the node pool.
+      config:
+          The node configuration of the pool.
+      initial_node_count:
+          The initial node count for the pool. You must ensure that your
+          Compute Engine resource quota is sufficient for this number of
+          instances. You must also have available firewall and routes
+          quota.
+      self_link:
+          [Output only] Server-defined URL for the resource.
+      version:
+          The version of the Kubernetes of this node.
+      instance_group_urls:
+          [Output only] The resource URLs of the `managed instance
+          groups </compute/docs/instance-groups/creating-groups-of-
+          managed-instances>`__ associated with this node pool.
+      status:
+          [Output only] The status of the nodes in this pool instance.
+      status_message:
+          [Output only] Additional information about the current status
+          of this node pool instance, if available.
+      autoscaling:
+          Autoscaler configuration for this NodePool. Autoscaler is
+          enabled only if a valid configuration is present.
+      management:
+          NodeManagement configuration for this NodePool.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NodePool)
+    ),
+)
+_sym_db.RegisterMessage(NodePool)
+
+NodeManagement = _reflection.GeneratedProtocolMessageType(
+    "NodeManagement",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEMANAGEMENT,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""NodeManagement defines the set of node management services turned on for
+  the node pool.
+  
+  
+  Attributes:
+      auto_upgrade:
+          A flag that specifies whether node auto-upgrade is enabled for
+          the node pool. If enabled, node auto-upgrade helps keep the
+          nodes in your node pool up to date with the latest release
+          version of Kubernetes.
+      auto_repair:
+          A flag that specifies whether the node auto-repair is enabled
+          for the node pool. If enabled, the nodes in this node pool
+          will be monitored and, if they fail health checks too many
+          times, an automatic repair action will be triggered.
+      upgrade_options:
+          Specifies the Auto Upgrade knobs for the node pool.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NodeManagement)
+    ),
+)
+_sym_db.RegisterMessage(NodeManagement)
+
+AutoUpgradeOptions = _reflection.GeneratedProtocolMessageType(
+    "AutoUpgradeOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AUTOUPGRADEOPTIONS,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""AutoUpgradeOptions defines the set of options for the user to control
+  how the Auto Upgrades will proceed.
+  
+  
+  Attributes:
+      auto_upgrade_start_time:
+          [Output only] This field is set when upgrades are about to
+          commence with the approximate start time for the upgrades, in
+          `RFC3339 <https://www.ietf.org/rfc/rfc3339.txt>`__ text
+          format.
+      description:
+          [Output only] This field is set when upgrades are about to
+          commence with the description of the upgrade.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.AutoUpgradeOptions)
+    ),
+)
+_sym_db.RegisterMessage(AutoUpgradeOptions)
+
+MaintenancePolicy = _reflection.GeneratedProtocolMessageType(
+    "MaintenancePolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MAINTENANCEPOLICY,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""MaintenancePolicy defines the maintenance policy to be used for the
+  cluster.
+  
+  
+  Attributes:
+      window:
+          Specifies the maintenance window in which maintenance may be
+          performed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.MaintenancePolicy)
+    ),
+)
+_sym_db.RegisterMessage(MaintenancePolicy)
+
+MaintenanceWindow = _reflection.GeneratedProtocolMessageType(
+    "MaintenanceWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MAINTENANCEWINDOW,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""MaintenanceWindow defines the maintenance window to be used for the
+  cluster.
+  
+  
+  Attributes:
+      daily_maintenance_window:
+          DailyMaintenanceWindow specifies a daily maintenance operation
+          window.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.MaintenanceWindow)
+    ),
+)
+_sym_db.RegisterMessage(MaintenanceWindow)
+
+DailyMaintenanceWindow = _reflection.GeneratedProtocolMessageType(
+    "DailyMaintenanceWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DAILYMAINTENANCEWINDOW,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""Time window specified for daily maintenance operations.
+  
+  
+  Attributes:
+      start_time:
+          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.
+      duration:
+          [Output only] Duration of the time window, automatically
+          chosen to be smallest possible in the given scenario. Duration
+          will be in `RFC3339 <https://www.ietf.org/rfc/rfc3339.txt>`__
+          format "PTnHnMnS".
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.DailyMaintenanceWindow)
+    ),
+)
+_sym_db.RegisterMessage(DailyMaintenanceWindow)
+
+SetNodePoolManagementRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNodePoolManagementRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNODEPOOLMANAGEMENTREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolManagementRequest sets the node management properties of a
+  node pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to update. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to update. This field
+          has been deprecated and replaced by the name field.
+      management:
+          NodeManagement configuration for the node pool.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to set management properties. Specified in the
+          format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetNodePoolManagementRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNodePoolManagementRequest)
+
+SetNodePoolSizeRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNodePoolSizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNODEPOOLSIZEREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolSizeRequest sets the size a node pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to update. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to update. This field
+          has been deprecated and replaced by the name field.
+      node_count:
+          The desired node count for the pool.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to set size. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetNodePoolSizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNodePoolSizeRequest)
+
+RollbackNodePoolUpgradeRequest = _reflection.GeneratedProtocolMessageType(
+    "RollbackNodePoolUpgradeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKNODEPOOLUPGRADEREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""RollbackNodePoolUpgradeRequest rollbacks the previously Aborted or
+  Failed NodePool upgrade. This will be an no-op if the last upgrade
+  successfully completed.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to rollback. This field
+          has been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to rollback. This field
+          has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node poll to rollback upgrade. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.RollbackNodePoolUpgradeRequest)
+    ),
+)
+_sym_db.RegisterMessage(RollbackNodePoolUpgradeRequest)
+
+ListNodePoolsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListNodePoolsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNODEPOOLSRESPONSE,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""ListNodePoolsResponse is the result of ListNodePoolsRequest.
+  
+  
+  Attributes:
+      node_pools:
+          A list of node pools for a cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.ListNodePoolsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListNodePoolsResponse)
+
+NodePoolAutoscaling = _reflection.GeneratedProtocolMessageType(
+    "NodePoolAutoscaling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEPOOLAUTOSCALING,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""NodePoolAutoscaling contains information required by cluster autoscaler
+  to adjust the size of the node pool to the current cluster usage.
+  
+  
+  Attributes:
+      enabled:
+          Is autoscaling enabled for this node pool.
+      min_node_count:
+          Minimum number of nodes in the NodePool. Must be >= 1 and <=
+          max\_node\_count.
+      max_node_count:
+          Maximum number of nodes in the NodePool. Must be >=
+          min\_node\_count. There has to enough quota to scale up the
+          cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NodePoolAutoscaling)
+    ),
+)
+_sym_db.RegisterMessage(NodePoolAutoscaling)
+
+SetLabelsRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLabelsRequest",
+    (_message.Message,),
+    dict(
+        ResourceLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ResourceLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SETLABELSREQUEST_RESOURCELABELSENTRY,
+                __module__="google.cloud.container_v1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1.SetLabelsRequest.ResourceLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_SETLABELSREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetLabelsRequest sets the Google Cloud Platform labels on a Google
+  Container Engine cluster, which will in turn set them for Google Compute
+  Engine resources used by that cluster
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      resource_labels:
+          The labels to set for that cluster.
+      label_fingerprint:
+          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.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          labels. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetLabelsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLabelsRequest)
+_sym_db.RegisterMessage(SetLabelsRequest.ResourceLabelsEntry)
+
+SetLegacyAbacRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLegacyAbacRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETLEGACYABACREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetLegacyAbacRequest enables or disables the ABAC authorization
+  mechanism for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to update. This field has
+          been deprecated and replaced by the name field.
+      enabled:
+          Whether ABAC authorization will be enabled in the cluster.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          legacy abac. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetLegacyAbacRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLegacyAbacRequest)
+
+StartIPRotationRequest = _reflection.GeneratedProtocolMessageType(
+    "StartIPRotationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STARTIPROTATIONREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""StartIPRotationRequest creates a new IP for the cluster and then
+  performs a node upgrade on each node pool to point to the new IP.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster id) of the cluster to
+          start IP rotation. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+      rotate_credentials:
+          Whether to rotate credentials during IP rotation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.StartIPRotationRequest)
+    ),
+)
+_sym_db.RegisterMessage(StartIPRotationRequest)
+
+CompleteIPRotationRequest = _reflection.GeneratedProtocolMessageType(
+    "CompleteIPRotationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMPLETEIPROTATIONREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""CompleteIPRotationRequest moves the cluster master back into single-IP
+  mode.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster id) of the cluster to
+          complete IP rotation. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.CompleteIPRotationRequest)
+    ),
+)
+_sym_db.RegisterMessage(CompleteIPRotationRequest)
+
+AcceleratorConfig = _reflection.GeneratedProtocolMessageType(
+    "AcceleratorConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACCELERATORCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""AcceleratorConfig represents a Hardware Accelerator request.
+  
+  
+  Attributes:
+      accelerator_count:
+          The number of the accelerator cards exposed to an instance.
+      accelerator_type:
+          The accelerator type resource name. List of supported
+          accelerators `here </compute/docs/gpus/#Introduction>`__
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.AcceleratorConfig)
+    ),
+)
+_sym_db.RegisterMessage(AcceleratorConfig)
+
+SetNetworkPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNetworkPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNETWORKPOLICYREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetNetworkPolicyRequest enables/disables network policy for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      network_policy:
+          Configuration options for the NetworkPolicy feature.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          networking policy. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetNetworkPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNetworkPolicyRequest)
+
+SetMaintenancePolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "SetMaintenancePolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETMAINTENANCEPOLICYREQUEST,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""SetMaintenancePolicyRequest sets the maintenance policy for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          The Google Developers Console `project ID or project number
+          <https://support.google.com/cloud/answer/6158840>`__.
+      zone:
+          The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides.
+      cluster_id:
+          The name of the cluster to update.
+      maintenance_policy:
+          The maintenance policy to be set for the cluster. An empty
+          field clears the existing maintenance policy.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          maintenance policy. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.SetMaintenancePolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetMaintenancePolicyRequest)
+
+NetworkConfig = _reflection.GeneratedProtocolMessageType(
+    "NetworkConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NETWORKCONFIG,
+        __module__="google.cloud.container_v1.proto.cluster_service_pb2",
+        __doc__="""NetworkConfig reports the relative names of network & subnetwork.
+  
+  
+  Attributes:
+      network:
+          Output only. The relative name of the Google Compute Engine [n
+          etwork][google.container.v1.NetworkConfig.network](/compute/do
+          cs/networks-and-firewalls#networks) to which the cluster is
+          connected. Example: projects/my-project/global/networks/my-
+          network
+      subnetwork:
+          Output only. The relative name of the Google Compute Engine
+          `subnetwork </compute/docs/vpc>`__ to which the cluster is
+          connected. Example: projects/my-project/regions/us-
+          central1/subnetworks/my-subnet
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1.NetworkConfig)
+    ),
+)
+_sym_db.RegisterMessage(NetworkConfig)
+
+
+DESCRIPTOR._options = None
+_NODECONFIG_METADATAENTRY._options = None
+_NODECONFIG_LABELSENTRY._options = None
+_IPALLOCATIONPOLICY.fields_by_name["cluster_ipv4_cidr"]._options = None
+_IPALLOCATIONPOLICY.fields_by_name["node_ipv4_cidr"]._options = None
+_IPALLOCATIONPOLICY.fields_by_name["services_ipv4_cidr"]._options = None
+_CLUSTER_RESOURCELABELSENTRY._options = None
+_CLUSTER.fields_by_name["zone"]._options = None
+_CLUSTER.fields_by_name["current_node_version"]._options = None
+_CLUSTER.fields_by_name["instance_group_urls"]._options = None
+_OPERATION.fields_by_name["zone"]._options = None
+_CREATECLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_CREATECLUSTERREQUEST.fields_by_name["zone"]._options = None
+_GETCLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_GETCLUSTERREQUEST.fields_by_name["zone"]._options = None
+_GETCLUSTERREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATECLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_UPDATECLUSTERREQUEST.fields_by_name["zone"]._options = None
+_UPDATECLUSTERREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["project_id"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["zone"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETLOGGINGSERVICEREQUEST.fields_by_name["project_id"]._options = None
+_SETLOGGINGSERVICEREQUEST.fields_by_name["cluster_id"]._options = None
+_SETMONITORINGSERVICEREQUEST.fields_by_name["project_id"]._options = None
+_SETMONITORINGSERVICEREQUEST.fields_by_name["zone"]._options = None
+_SETMONITORINGSERVICEREQUEST.fields_by_name["cluster_id"]._options = None
+_SETADDONSCONFIGREQUEST.fields_by_name["project_id"]._options = None
+_SETADDONSCONFIGREQUEST.fields_by_name["zone"]._options = None
+_SETADDONSCONFIGREQUEST.fields_by_name["cluster_id"]._options = None
+_SETLOCATIONSREQUEST.fields_by_name["project_id"]._options = None
+_SETLOCATIONSREQUEST.fields_by_name["zone"]._options = None
+_SETLOCATIONSREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATEMASTERREQUEST.fields_by_name["project_id"]._options = None
+_UPDATEMASTERREQUEST.fields_by_name["zone"]._options = None
+_UPDATEMASTERREQUEST.fields_by_name["cluster_id"]._options = None
+_SETMASTERAUTHREQUEST.fields_by_name["project_id"]._options = None
+_SETMASTERAUTHREQUEST.fields_by_name["zone"]._options = None
+_SETMASTERAUTHREQUEST.fields_by_name["cluster_id"]._options = None
+_DELETECLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_DELETECLUSTERREQUEST.fields_by_name["zone"]._options = None
+_DELETECLUSTERREQUEST.fields_by_name["cluster_id"]._options = None
+_LISTCLUSTERSREQUEST.fields_by_name["project_id"]._options = None
+_LISTCLUSTERSREQUEST.fields_by_name["zone"]._options = None
+_GETOPERATIONREQUEST.fields_by_name["project_id"]._options = None
+_GETOPERATIONREQUEST.fields_by_name["zone"]._options = None
+_GETOPERATIONREQUEST.fields_by_name["operation_id"]._options = None
+_LISTOPERATIONSREQUEST.fields_by_name["project_id"]._options = None
+_LISTOPERATIONSREQUEST.fields_by_name["zone"]._options = None
+_CANCELOPERATIONREQUEST.fields_by_name["project_id"]._options = None
+_CANCELOPERATIONREQUEST.fields_by_name["zone"]._options = None
+_CANCELOPERATIONREQUEST.fields_by_name["operation_id"]._options = None
+_GETSERVERCONFIGREQUEST.fields_by_name["project_id"]._options = None
+_GETSERVERCONFIGREQUEST.fields_by_name["zone"]._options = None
+_CREATENODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_CREATENODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_CREATENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None
+_LISTNODEPOOLSREQUEST.fields_by_name["project_id"]._options = None
+_LISTNODEPOOLSREQUEST.fields_by_name["zone"]._options = None
+_LISTNODEPOOLSREQUEST.fields_by_name["cluster_id"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["project_id"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["zone"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["project_id"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["zone"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["node_pool_id"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["project_id"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["zone"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["cluster_id"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETLABELSREQUEST_RESOURCELABELSENTRY._options = None
+_SETLABELSREQUEST.fields_by_name["project_id"]._options = None
+_SETLABELSREQUEST.fields_by_name["zone"]._options = None
+_SETLABELSREQUEST.fields_by_name["cluster_id"]._options = None
+_SETLEGACYABACREQUEST.fields_by_name["project_id"]._options = None
+_SETLEGACYABACREQUEST.fields_by_name["zone"]._options = None
+_SETLEGACYABACREQUEST.fields_by_name["cluster_id"]._options = None
+_STARTIPROTATIONREQUEST.fields_by_name["project_id"]._options = None
+_STARTIPROTATIONREQUEST.fields_by_name["zone"]._options = None
+_STARTIPROTATIONREQUEST.fields_by_name["cluster_id"]._options = None
+_COMPLETEIPROTATIONREQUEST.fields_by_name["project_id"]._options = None
+_COMPLETEIPROTATIONREQUEST.fields_by_name["zone"]._options = None
+_COMPLETEIPROTATIONREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNETWORKPOLICYREQUEST.fields_by_name["project_id"]._options = None
+_SETNETWORKPOLICYREQUEST.fields_by_name["zone"]._options = None
+_SETNETWORKPOLICYREQUEST.fields_by_name["cluster_id"]._options = None
+
+_CLUSTERMANAGER = _descriptor.ServiceDescriptor(
+    name="ClusterManager",
+    full_name="google.container.v1.ClusterManager",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=11064,
+    serialized_end=18435,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListClusters",
+            full_name="google.container.v1.ClusterManager.ListClusters",
+            index=0,
+            containing_service=None,
+            input_type=_LISTCLUSTERSREQUEST,
+            output_type=_LISTCLUSTERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002a\022,/v1/{parent=projects/*/locations/*}/clustersZ1\022//v1/projects/{project_id}/zones/{zone}/clusters"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCluster",
+            full_name="google.container.v1.ClusterManager.GetCluster",
+            index=1,
+            containing_service=None,
+            input_type=_GETCLUSTERREQUEST,
+            output_type=_CLUSTER,
+            serialized_options=_b(
+                "\202\323\344\223\002n\022,/v1/{name=projects/*/locations/*/clusters/*}Z>\022</v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateCluster",
+            full_name="google.container.v1.ClusterManager.CreateCluster",
+            index=2,
+            containing_service=None,
+            input_type=_CREATECLUSTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002g",/v1/{parent=projects/*/locations/*}/clusters:\001*Z4"//v1/projects/{project_id}/zones/{zone}/clusters:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCluster",
+            full_name="google.container.v1.ClusterManager.UpdateCluster",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATECLUSTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002t\032,/v1/{name=projects/*/locations/*/clusters/*}:\001*ZA\032</v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateNodePool",
+            full_name="google.container.v1.ClusterManager.UpdateNodePool",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATENODEPOOLREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\240\001\0328/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:\001*Za"\\/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/update:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNodePoolAutoscaling",
+            full_name="google.container.v1.ClusterManager.SetNodePoolAutoscaling",
+            index=5,
+            containing_service=None,
+            input_type=_SETNODEPOOLAUTOSCALINGREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\264\001"G/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling:\001*Zf"a/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/autoscaling:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLoggingService",
+            full_name="google.container.v1.ClusterManager.SetLoggingService",
+            index=6,
+            containing_service=None,
+            input_type=_SETLOGGINGSERVICEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\207\001"7/v1/{name=projects/*/locations/*/clusters/*}:setLogging:\001*ZI"D/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/logging:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetMonitoringService",
+            full_name="google.container.v1.ClusterManager.SetMonitoringService",
+            index=7,
+            containing_service=None,
+            input_type=_SETMONITORINGSERVICEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\215\001":/v1/{name=projects/*/locations/*/clusters/*}:setMonitoring:\001*ZL"G/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/monitoring:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetAddonsConfig",
+            full_name="google.container.v1.ClusterManager.SetAddonsConfig",
+            index=8,
+            containing_service=None,
+            input_type=_SETADDONSCONFIGREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\205\001"6/v1/{name=projects/*/locations/*/clusters/*}:setAddons:\001*ZH"C/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/addons:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLocations",
+            full_name="google.container.v1.ClusterManager.SetLocations",
+            index=9,
+            containing_service=None,
+            input_type=_SETLOCATIONSREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\213\001"9/v1/{name=projects/*/locations/*/clusters/*}:setLocations:\001*ZK"F/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/locations:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateMaster",
+            full_name="google.container.v1.ClusterManager.UpdateMaster",
+            index=10,
+            containing_service=None,
+            input_type=_UPDATEMASTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\210\001"9/v1/{name=projects/*/locations/*/clusters/*}:updateMaster:\001*ZH"C/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/master:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetMasterAuth",
+            full_name="google.container.v1.ClusterManager.SetMasterAuth",
+            index=11,
+            containing_service=None,
+            input_type=_SETMASTERAUTHREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\220\001":/v1/{name=projects/*/locations/*/clusters/*}:setMasterAuth:\001*ZO"J/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMasterAuth:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteCluster",
+            full_name="google.container.v1.ClusterManager.DeleteCluster",
+            index=12,
+            containing_service=None,
+            input_type=_DELETECLUSTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002n*,/v1/{name=projects/*/locations/*/clusters/*}Z>*</v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListOperations",
+            full_name="google.container.v1.ClusterManager.ListOperations",
+            index=13,
+            containing_service=None,
+            input_type=_LISTOPERATIONSREQUEST,
+            output_type=_LISTOPERATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002e\022./v1/{parent=projects/*/locations/*}/operationsZ3\0221/v1/projects/{project_id}/zones/{zone}/operations"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetOperation",
+            full_name="google.container.v1.ClusterManager.GetOperation",
+            index=14,
+            containing_service=None,
+            input_type=_GETOPERATIONREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002t\022./v1/{name=projects/*/locations/*/operations/*}ZB\022@/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelOperation",
+            full_name="google.container.v1.ClusterManager.CancelOperation",
+            index=15,
+            containing_service=None,
+            input_type=_CANCELOPERATIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002\210\001"5/v1/{name=projects/*/locations/*/operations/*}:cancel:\001*ZL"G/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}:cancel:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetServerConfig",
+            full_name="google.container.v1.ClusterManager.GetServerConfig",
+            index=16,
+            containing_service=None,
+            input_type=_GETSERVERCONFIGREQUEST,
+            output_type=_SERVERCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002g\022./v1/{name=projects/*/locations/*}/serverConfigZ5\0223/v1/projects/{project_id}/zones/{zone}/serverconfig"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListNodePools",
+            full_name="google.container.v1.ClusterManager.ListNodePools",
+            index=17,
+            containing_service=None,
+            input_type=_LISTNODEPOOLSREQUEST,
+            output_type=_LISTNODEPOOLSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\204\001\0228/v1/{parent=projects/*/locations/*/clusters/*}/nodePoolsZH\022F/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetNodePool",
+            full_name="google.container.v1.ClusterManager.GetNodePool",
+            index=18,
+            containing_service=None,
+            input_type=_GETNODEPOOLREQUEST,
+            output_type=_NODEPOOL,
+            serialized_options=_b(
+                "\202\323\344\223\002\223\001\0228/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}ZW\022U/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateNodePool",
+            full_name="google.container.v1.ClusterManager.CreateNodePool",
+            index=19,
+            containing_service=None,
+            input_type=_CREATENODEPOOLREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\212\001"8/v1/{parent=projects/*/locations/*/clusters/*}/nodePools:\001*ZK"F/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteNodePool",
+            full_name="google.container.v1.ClusterManager.DeleteNodePool",
+            index=20,
+            containing_service=None,
+            input_type=_DELETENODEPOOLREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002\223\001*8/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}ZW*U/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RollbackNodePoolUpgrade",
+            full_name="google.container.v1.ClusterManager.RollbackNodePoolUpgrade",
+            index=21,
+            containing_service=None,
+            input_type=_ROLLBACKNODEPOOLUPGRADEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\253\001"A/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback:\001*Zc"^/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}:rollback:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNodePoolManagement",
+            full_name="google.container.v1.ClusterManager.SetNodePoolManagement",
+            index=22,
+            containing_service=None,
+            input_type=_SETNODEPOOLMANAGEMENTREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\265\001"F/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setManagement:\001*Zh"c/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setManagement:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLabels",
+            full_name="google.container.v1.ClusterManager.SetLabels",
+            index=23,
+            containing_service=None,
+            input_type=_SETLABELSREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\225\001">/v1/{name=projects/*/locations/*/clusters/*}:setResourceLabels:\001*ZP"K/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLegacyAbac",
+            full_name="google.container.v1.ClusterManager.SetLegacyAbac",
+            index=24,
+            containing_service=None,
+            input_type=_SETLEGACYABACREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\215\001":/v1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac:\001*ZL"G/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StartIPRotation",
+            full_name="google.container.v1.ClusterManager.StartIPRotation",
+            index=25,
+            containing_service=None,
+            input_type=_STARTIPROTATIONREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\224\001"</v1/{name=projects/*/locations/*/clusters/*}:startIpRotation:\001*ZQ"L/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:startIpRotation:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CompleteIPRotation",
+            full_name="google.container.v1.ClusterManager.CompleteIPRotation",
+            index=26,
+            containing_service=None,
+            input_type=_COMPLETEIPROTATIONREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\232\001"?/v1/{name=projects/*/locations/*/clusters/*}:completeIpRotation:\001*ZT"O/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:completeIpRotation:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNodePoolSize",
+            full_name="google.container.v1.ClusterManager.SetNodePoolSize",
+            index=27,
+            containing_service=None,
+            input_type=_SETNODEPOOLSIZEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\251\001"@/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setSize:\001*Zb"]/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setSize:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNetworkPolicy",
+            full_name="google.container.v1.ClusterManager.SetNetworkPolicy",
+            index=28,
+            containing_service=None,
+            input_type=_SETNETWORKPOLICYREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\226\001"=/v1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy:\001*ZR"M/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setNetworkPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetMaintenancePolicy",
+            full_name="google.container.v1.ClusterManager.SetMaintenancePolicy",
+            index=29,
+            containing_service=None,
+            input_type=_SETMAINTENANCEPOLICYREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\236\001"A/v1/{name=projects/*/locations/*/clusters/*}:setMaintenancePolicy:\001*ZV"Q/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMaintenancePolicy:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLUSTERMANAGER)
+
+DESCRIPTOR.services_by_name["ClusterManager"] = _CLUSTERMANAGER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/container/google/cloud/container_v1/proto/cluster_service_pb2_grpc.py b/container/google/cloud/container_v1/proto/cluster_service_pb2_grpc.py
new file mode 100644
index 000000000000..203a0f231022
--- /dev/null
+++ b/container/google/cloud/container_v1/proto/cluster_service_pb2_grpc.py
@@ -0,0 +1,567 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.container_v1.proto import (
+    cluster_service_pb2 as google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ClusterManagerStub(object):
+    """Google Kubernetes Engine Cluster Manager v1
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListClusters = channel.unary_unary(
+            "/google.container.v1.ClusterManager/ListClusters",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListClustersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListClustersResponse.FromString,
+        )
+        self.GetCluster = channel.unary_unary(
+            "/google.container.v1.ClusterManager/GetCluster",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Cluster.FromString,
+        )
+        self.CreateCluster = channel.unary_unary(
+            "/google.container.v1.ClusterManager/CreateCluster",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CreateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.UpdateCluster = channel.unary_unary(
+            "/google.container.v1.ClusterManager/UpdateCluster",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.UpdateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.UpdateNodePool = channel.unary_unary(
+            "/google.container.v1.ClusterManager/UpdateNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.UpdateNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNodePoolAutoscaling = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetNodePoolAutoscaling",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNodePoolAutoscalingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLoggingService = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetLoggingService",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLoggingServiceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetMonitoringService = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetMonitoringService",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetMonitoringServiceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetAddonsConfig = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetAddonsConfig",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetAddonsConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLocations = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetLocations",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLocationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.UpdateMaster = channel.unary_unary(
+            "/google.container.v1.ClusterManager/UpdateMaster",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.UpdateMasterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetMasterAuth = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetMasterAuth",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetMasterAuthRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.DeleteCluster = channel.unary_unary(
+            "/google.container.v1.ClusterManager/DeleteCluster",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.DeleteClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.ListOperations = channel.unary_unary(
+            "/google.container.v1.ClusterManager/ListOperations",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListOperationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListOperationsResponse.FromString,
+        )
+        self.GetOperation = channel.unary_unary(
+            "/google.container.v1.ClusterManager/GetOperation",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetOperationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.CancelOperation = channel.unary_unary(
+            "/google.container.v1.ClusterManager/CancelOperation",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CancelOperationRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetServerConfig = channel.unary_unary(
+            "/google.container.v1.ClusterManager/GetServerConfig",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetServerConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ServerConfig.FromString,
+        )
+        self.ListNodePools = channel.unary_unary(
+            "/google.container.v1.ClusterManager/ListNodePools",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListNodePoolsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListNodePoolsResponse.FromString,
+        )
+        self.GetNodePool = channel.unary_unary(
+            "/google.container.v1.ClusterManager/GetNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.NodePool.FromString,
+        )
+        self.CreateNodePool = channel.unary_unary(
+            "/google.container.v1.ClusterManager/CreateNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CreateNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.DeleteNodePool = channel.unary_unary(
+            "/google.container.v1.ClusterManager/DeleteNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.DeleteNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.RollbackNodePoolUpgrade = channel.unary_unary(
+            "/google.container.v1.ClusterManager/RollbackNodePoolUpgrade",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.RollbackNodePoolUpgradeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNodePoolManagement = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetNodePoolManagement",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNodePoolManagementRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLabels = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetLabels",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLabelsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLegacyAbac = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetLegacyAbac",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLegacyAbacRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.StartIPRotation = channel.unary_unary(
+            "/google.container.v1.ClusterManager/StartIPRotation",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.StartIPRotationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.CompleteIPRotation = channel.unary_unary(
+            "/google.container.v1.ClusterManager/CompleteIPRotation",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CompleteIPRotationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNodePoolSize = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetNodePoolSize",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNodePoolSizeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNetworkPolicy = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetNetworkPolicy",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNetworkPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetMaintenancePolicy = channel.unary_unary(
+            "/google.container.v1.ClusterManager/SetMaintenancePolicy",
+            request_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetMaintenancePolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+
+
+class ClusterManagerServicer(object):
+    """Google Kubernetes Engine Cluster Manager v1
+  """
+
+    def ListClusters(self, request, context):
+        """Lists all clusters owned by a project in either the specified zone or all
+    zones.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCluster(self, request, context):
+        """Gets the details of a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateCluster(self, request, context):
+        """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).
+
+    One firewall is added for the cluster. After cluster creation,
+    the cluster 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCluster(self, request, context):
+        """Updates the settings of a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateNodePool(self, request, context):
+        """Updates the version and/or image type for a specific node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNodePoolAutoscaling(self, request, context):
+        """Sets the autoscaling settings for a specific node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLoggingService(self, request, context):
+        """Sets the logging service for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetMonitoringService(self, request, context):
+        """Sets the monitoring service for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetAddonsConfig(self, request, context):
+        """Sets the addons for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLocations(self, request, context):
+        """Sets the locations for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateMaster(self, request, context):
+        """Updates the master for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetMasterAuth(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteCluster(self, request, context):
+        """Deletes the cluster, including the Kubernetes endpoint and all worker
+    nodes.
+
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListOperations(self, request, context):
+        """Lists all operations in a project in a specific zone or all zones.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetOperation(self, request, context):
+        """Gets the specified operation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelOperation(self, request, context):
+        """Cancels the specified operation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetServerConfig(self, request, context):
+        """Returns configuration info about the Kubernetes Engine service.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListNodePools(self, request, context):
+        """Lists the node pools for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetNodePool(self, request, context):
+        """Retrieves the node pool requested.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateNodePool(self, request, context):
+        """Creates a node pool for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteNodePool(self, request, context):
+        """Deletes a node pool from a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RollbackNodePoolUpgrade(self, request, context):
+        """Roll back the previously Aborted or Failed NodePool upgrade.
+    This will be an no-op if the last upgrade successfully completed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNodePoolManagement(self, request, context):
+        """Sets the NodeManagement options for a node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLabels(self, request, context):
+        """Sets labels on a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLegacyAbac(self, request, context):
+        """Enables or disables the ABAC authorization mechanism on a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StartIPRotation(self, request, context):
+        """Start master IP rotation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CompleteIPRotation(self, request, context):
+        """Completes master IP rotation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNodePoolSize(self, request, context):
+        """Sets the size for a specific node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNetworkPolicy(self, request, context):
+        """Enables/Disables Network Policy for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetMaintenancePolicy(self, request, context):
+        """Sets the maintenance policy for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ClusterManagerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListClusters": grpc.unary_unary_rpc_method_handler(
+            servicer.ListClusters,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListClustersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListClustersResponse.SerializeToString,
+        ),
+        "GetCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Cluster.SerializeToString,
+        ),
+        "CreateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CreateClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "UpdateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.UpdateClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "UpdateNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.UpdateNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNodePoolAutoscaling": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNodePoolAutoscaling,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNodePoolAutoscalingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLoggingService": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLoggingService,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLoggingServiceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetMonitoringService": grpc.unary_unary_rpc_method_handler(
+            servicer.SetMonitoringService,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetMonitoringServiceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetAddonsConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.SetAddonsConfig,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetAddonsConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLocations": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLocations,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLocationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "UpdateMaster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateMaster,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.UpdateMasterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetMasterAuth": grpc.unary_unary_rpc_method_handler(
+            servicer.SetMasterAuth,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetMasterAuthRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "DeleteCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.DeleteClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "ListOperations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListOperations,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListOperationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListOperationsResponse.SerializeToString,
+        ),
+        "GetOperation": grpc.unary_unary_rpc_method_handler(
+            servicer.GetOperation,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetOperationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "CancelOperation": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelOperation,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CancelOperationRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetServerConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetServerConfig,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetServerConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ServerConfig.SerializeToString,
+        ),
+        "ListNodePools": grpc.unary_unary_rpc_method_handler(
+            servicer.ListNodePools,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListNodePoolsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.ListNodePoolsResponse.SerializeToString,
+        ),
+        "GetNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.GetNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.GetNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.NodePool.SerializeToString,
+        ),
+        "CreateNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CreateNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "DeleteNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.DeleteNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "RollbackNodePoolUpgrade": grpc.unary_unary_rpc_method_handler(
+            servicer.RollbackNodePoolUpgrade,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.RollbackNodePoolUpgradeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNodePoolManagement": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNodePoolManagement,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNodePoolManagementRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLabels": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLabels,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLabelsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLegacyAbac": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLegacyAbac,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetLegacyAbacRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "StartIPRotation": grpc.unary_unary_rpc_method_handler(
+            servicer.StartIPRotation,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.StartIPRotationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "CompleteIPRotation": grpc.unary_unary_rpc_method_handler(
+            servicer.CompleteIPRotation,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.CompleteIPRotationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNodePoolSize": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNodePoolSize,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNodePoolSizeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNetworkPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNetworkPolicy,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetNetworkPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetMaintenancePolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetMaintenancePolicy,
+            request_deserializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.SetMaintenancePolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.container.v1.ClusterManager", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/container/google/cloud/container_v1/types.py b/container/google/cloud/container_v1/types.py
new file mode 100644
index 000000000000..933d4987e1fe
--- /dev/null
+++ b/container/google/cloud/container_v1/types.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.container_v1.proto import cluster_service_pb2
+from google.protobuf import empty_pb2
+
+
+_shared_modules = [empty_pb2]
+
+_local_modules = [cluster_service_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.container_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/container/google/cloud/container_v1beta1/__init__.py b/container/google/cloud/container_v1beta1/__init__.py
new file mode 100644
index 000000000000..9e3fc9561d9e
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.container_v1beta1 import types
+from google.cloud.container_v1beta1.gapic import cluster_manager_client
+from google.cloud.container_v1beta1.gapic import enums
+
+
+class ClusterManagerClient(cluster_manager_client.ClusterManagerClient):
+    __doc__ = cluster_manager_client.ClusterManagerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ClusterManagerClient")
diff --git a/container/google/cloud/container_v1beta1/gapic/__init__.py b/container/google/cloud/container_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/container/google/cloud/container_v1beta1/gapic/cluster_manager_client.py b/container/google/cloud/container_v1beta1/gapic/cluster_manager_client.py
new file mode 100644
index 000000000000..31cc3f122f11
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/gapic/cluster_manager_client.py
@@ -0,0 +1,3405 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.container.v1beta1 ClusterManager API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import grpc
+
+from google.cloud.container_v1beta1.gapic import cluster_manager_client_config
+from google.cloud.container_v1beta1.gapic import enums
+from google.cloud.container_v1beta1.gapic.transports import (
+    cluster_manager_grpc_transport,
+)
+from google.cloud.container_v1beta1.proto import cluster_service_pb2
+from google.cloud.container_v1beta1.proto import cluster_service_pb2_grpc
+from google.protobuf import empty_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-container"
+).version
+
+
+class ClusterManagerClient(object):
+    """Google Kubernetes Engine Cluster Manager v1beta1"""
+
+    SERVICE_ADDRESS = "container.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.container.v1beta1.ClusterManager"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ClusterManagerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ClusterManagerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ClusterManagerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cluster_manager_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cluster_manager_grpc_transport.ClusterManagerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cluster_manager_grpc_transport.ClusterManagerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_clusters(
+        self,
+        project_id,
+        zone,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all clusters owned by a project in either the specified zone or all
+        zones.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> response = client.list_clusters(project_id, zone)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            parent (str): The parent (project and location) where the clusters will be listed.
+                Specified in the format 'projects/*/locations/*'. Location "-" matches
+                all zones and all regions.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.ListClustersResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_clusters" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_clusters"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_clusters,
+                default_retry=self._method_configs["ListClusters"].retry,
+                default_timeout=self._method_configs["ListClusters"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListClustersRequest(
+            project_id=project_id, zone=zone, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_clusters"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_cluster(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the details for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.get_cluster(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to retrieve.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster) of the cluster to retrieve.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Cluster` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_cluster,
+                default_retry=self._method_configs["GetCluster"].retry,
+                default_timeout=self._method_configs["GetCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_cluster(
+        self,
+        project_id,
+        zone,
+        cluster,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 <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 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.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> response = client.create_cluster(project_id, zone, cluster)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster (Union[dict, ~google.cloud.container_v1beta1.types.Cluster]): A `cluster
+                resource <https://cloud.google.com/container-engine/reference/rest/v1beta1/projects.zones.clusters>`__
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.Cluster`
+            parent (str): The parent (project and location) where the cluster will be created.
+                Specified in the format 'projects/*/locations/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_cluster,
+                default_retry=self._method_configs["CreateCluster"].retry,
+                default_timeout=self._method_configs["CreateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CreateClusterRequest(
+            project_id=project_id, zone=zone, cluster=cluster, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_cluster(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        update,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the settings for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `update`:
+            >>> update = {}
+            >>>
+            >>> response = client.update_cluster(project_id, zone, cluster_id, update)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            update (Union[dict, ~google.cloud.container_v1beta1.types.ClusterUpdate]): A description of the update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.ClusterUpdate`
+            name (str): The name (project, location, cluster) of the cluster to update.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_cluster,
+                default_retry=self._method_configs["UpdateCluster"].retry,
+                default_timeout=self._method_configs["UpdateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.UpdateClusterRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            update=update,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        node_version,
+        image_type,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the version and/or image type of a specific node pool.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `node_version`:
+            >>> node_version = ''
+            >>>
+            >>> # TODO: Initialize `image_type`:
+            >>> image_type = ''
+            >>>
+            >>> response = client.update_node_pool(project_id, zone, cluster_id, node_pool_id, node_version, image_type)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to upgrade.
+                This field has been deprecated and replaced by the name field.
+            node_version (str): The Kubernetes version to change the nodes to (typically an
+                upgrade).
+
+                Users may specify either explicit versions offered by Kubernetes Engine or
+                version aliases, which have the following behavior:
+
+                - "latest": picks the highest valid Kubernetes version
+                - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+                - "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
+            image_type (str): The desired image type for the node pool.
+            name (str): The name (project, location, cluster, node pool) of the node pool to
+                update. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_node_pool,
+                default_retry=self._method_configs["UpdateNodePool"].retry,
+                default_timeout=self._method_configs["UpdateNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.UpdateNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_version=node_version,
+            image_type=image_type,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_node_pool_autoscaling(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        autoscaling,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the autoscaling settings of a specific node pool.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `autoscaling`:
+            >>> autoscaling = {}
+            >>>
+            >>> response = client.set_node_pool_autoscaling(project_id, zone, cluster_id, node_pool_id, autoscaling)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to upgrade.
+                This field has been deprecated and replaced by the name field.
+            autoscaling (Union[dict, ~google.cloud.container_v1beta1.types.NodePoolAutoscaling]): Autoscaling configuration for the node pool.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.NodePoolAutoscaling`
+            name (str): The name (project, location, cluster, node pool) of the node pool to set
+                autoscaler settings. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_node_pool_autoscaling" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_node_pool_autoscaling"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_node_pool_autoscaling,
+                default_retry=self._method_configs["SetNodePoolAutoscaling"].retry,
+                default_timeout=self._method_configs["SetNodePoolAutoscaling"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNodePoolAutoscalingRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            autoscaling=autoscaling,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_node_pool_autoscaling"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_logging_service(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        logging_service,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the logging service for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `logging_service`:
+            >>> logging_service = ''
+            >>>
+            >>> response = client.set_logging_service(project_id, zone, cluster_id, logging_service)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            logging_service (str): 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
+            name (str): The name (project, location, cluster) of the cluster to set logging.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_logging_service" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_logging_service"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_logging_service,
+                default_retry=self._method_configs["SetLoggingService"].retry,
+                default_timeout=self._method_configs["SetLoggingService"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLoggingServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            logging_service=logging_service,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_logging_service"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_monitoring_service(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        monitoring_service,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the monitoring service for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `monitoring_service`:
+            >>> monitoring_service = ''
+            >>>
+            >>> response = client.set_monitoring_service(project_id, zone, cluster_id, monitoring_service)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            monitoring_service (str): 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
+            name (str): The name (project, location, cluster) of the cluster to set monitoring.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_monitoring_service" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_monitoring_service"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_monitoring_service,
+                default_retry=self._method_configs["SetMonitoringService"].retry,
+                default_timeout=self._method_configs["SetMonitoringService"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetMonitoringServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            monitoring_service=monitoring_service,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_monitoring_service"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_addons_config(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        addons_config,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the addons for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `addons_config`:
+            >>> addons_config = {}
+            >>>
+            >>> response = client.set_addons_config(project_id, zone, cluster_id, addons_config)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            addons_config (Union[dict, ~google.cloud.container_v1beta1.types.AddonsConfig]): The desired configurations for the various addons available to run in the
+                cluster.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.AddonsConfig`
+            name (str): The name (project, location, cluster) of the cluster to set addons.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_addons_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_addons_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_addons_config,
+                default_retry=self._method_configs["SetAddonsConfig"].retry,
+                default_timeout=self._method_configs["SetAddonsConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetAddonsConfigRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            addons_config=addons_config,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_addons_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_locations(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        locations,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the locations for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `locations`:
+            >>> locations = []
+            >>>
+            >>> response = client.set_locations(project_id, zone, cluster_id, locations)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            locations (list[str]): 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.
+            name (str): The name (project, location, cluster) of the cluster to set locations.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_locations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_locations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_locations,
+                default_retry=self._method_configs["SetLocations"].retry,
+                default_timeout=self._method_configs["SetLocations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLocationsRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            locations=locations,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_locations"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_master(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        master_version,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the master for a specific cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `master_version`:
+            >>> master_version = ''
+            >>>
+            >>> response = client.update_master(project_id, zone, cluster_id, master_version)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            master_version (str): 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:
+
+                - "latest": picks the highest valid Kubernetes version
+                - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+                - "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
+            name (str): The name (project, location, cluster) of the cluster to update.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_master" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_master"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_master,
+                default_retry=self._method_configs["UpdateMaster"].retry,
+                default_timeout=self._method_configs["UpdateMaster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.UpdateMasterRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            master_version=master_version,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_master"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_master_auth(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        action,
+        update,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>> from google.cloud.container_v1beta1 import enums
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `action`:
+            >>> action = enums.SetMasterAuthRequest.Action.UNKNOWN
+            >>>
+            >>> # TODO: Initialize `update`:
+            >>> update = {}
+            >>>
+            >>> response = client.set_master_auth(project_id, zone, cluster_id, action, update)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to upgrade.
+                This field has been deprecated and replaced by the name field.
+            action (~google.cloud.container_v1beta1.types.Action): The exact form of action to be taken on the master auth.
+            update (Union[dict, ~google.cloud.container_v1beta1.types.MasterAuth]): A description of the update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.MasterAuth`
+            name (str): The name (project, location, cluster) of the cluster to set auth.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_master_auth" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_master_auth"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_master_auth,
+                default_retry=self._method_configs["SetMasterAuth"].retry,
+                default_timeout=self._method_configs["SetMasterAuth"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetMasterAuthRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            action=action,
+            update=update,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_master_auth"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_cluster(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the cluster, including the Kubernetes endpoint and all worker
+        nodes.
+
+        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.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.delete_cluster(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to delete.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster) of the cluster to delete.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_cluster,
+                default_retry=self._method_configs["DeleteCluster"].retry,
+                default_timeout=self._method_configs["DeleteCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.DeleteClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["delete_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_operations(
+        self,
+        project_id,
+        zone,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all operations in a project in a specific zone or all zones.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> response = client.list_operations(project_id, zone)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            parent (str): The parent (project and location) where the operations will be listed.
+                Specified in the format 'projects/*/locations/*'. Location "-" matches
+                all zones and all regions.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.ListOperationsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_operations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_operations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_operations,
+                default_retry=self._method_configs["ListOperations"].retry,
+                default_timeout=self._method_configs["ListOperations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListOperationsRequest(
+            project_id=project_id, zone=zone, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_operations"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_operation(
+        self,
+        project_id,
+        zone,
+        operation_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the specified operation.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `operation_id`:
+            >>> operation_id = ''
+            >>>
+            >>> response = client.get_operation(project_id, zone, operation_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            operation_id (str): Deprecated. The server-assigned ``name`` of the operation. This field
+                has been deprecated and replaced by the name field.
+            name (str): The name (project, location, operation id) of the operation to get.
+                Specified in the format 'projects/*/locations/*/operations/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_operation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_operation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_operation,
+                default_retry=self._method_configs["GetOperation"].retry,
+                default_timeout=self._method_configs["GetOperation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_operation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_operation(
+        self,
+        project_id,
+        zone,
+        operation_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Cancels the specified operation.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `operation_id`:
+            >>> operation_id = ''
+            >>>
+            >>> client.cancel_operation(project_id, zone, operation_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            operation_id (str): Deprecated. The server-assigned ``name`` of the operation. This field
+                has been deprecated and replaced by the name field.
+            name (str): The name (project, location, operation id) of the operation to cancel.
+                Specified in the format 'projects/*/locations/*/operations/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_operation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_operation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_operation,
+                default_retry=self._method_configs["CancelOperation"].retry,
+                default_timeout=self._method_configs["CancelOperation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CancelOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["cancel_operation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_server_config(
+        self,
+        project_id,
+        zone,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns configuration info about the Kubernetes Engine service.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> response = client.get_server_config(project_id, zone)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            name (str): The name (project and location) of the server config to get Specified in
+                the format 'projects/*/locations/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.ServerConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_server_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_server_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_server_config,
+                default_retry=self._method_configs["GetServerConfig"].retry,
+                default_timeout=self._method_configs["GetServerConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetServerConfigRequest(
+            project_id=project_id, zone=zone, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_server_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_node_pools(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the node pools for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.list_node_pools(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the parent field.
+            parent (str): The parent (project, location, cluster id) where the node pools will be
+                listed. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.ListNodePoolsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_node_pools" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_node_pools"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_node_pools,
+                default_retry=self._method_configs["ListNodePools"].retry,
+                default_timeout=self._method_configs["ListNodePools"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListNodePoolsRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_node_pools"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves the node pool requested.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> response = client.get_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                get. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.NodePool` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_node_pool,
+                default_retry=self._method_configs["GetNodePool"].retry,
+                default_timeout=self._method_configs["GetNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.GetNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a node pool for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool`:
+            >>> node_pool = {}
+            >>>
+            >>> response = client.create_node_pool(project_id, zone, cluster_id, node_pool)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the parent field.
+            node_pool (Union[dict, ~google.cloud.container_v1beta1.types.NodePool]): The node pool to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.NodePool`
+            parent (str): The parent (project, location, cluster id) where the node pool will be
+                created. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_node_pool,
+                default_retry=self._method_configs["CreateNodePool"].retry,
+                default_timeout=self._method_configs["CreateNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CreateNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool=node_pool,
+            parent=parent,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_node_pool(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a node pool from a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> response = client.delete_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to delete.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                delete. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_node_pool" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_node_pool"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_node_pool,
+                default_retry=self._method_configs["DeleteNodePool"].retry,
+                default_timeout=self._method_configs["DeleteNodePool"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.DeleteNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["delete_node_pool"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rollback_node_pool_upgrade(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Roll back the previously Aborted or Failed NodePool upgrade.
+        This will be an no-op if the last upgrade successfully completed.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> response = client.rollback_node_pool_upgrade(project_id, zone, cluster_id, node_pool_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to rollback.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to rollback.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster, node pool id) of the node poll to
+                rollback upgrade. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rollback_node_pool_upgrade" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rollback_node_pool_upgrade"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rollback_node_pool_upgrade,
+                default_retry=self._method_configs["RollbackNodePoolUpgrade"].retry,
+                default_timeout=self._method_configs["RollbackNodePoolUpgrade"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.RollbackNodePoolUpgradeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["rollback_node_pool_upgrade"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_node_pool_management(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        management,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the NodeManagement options for a node pool.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `management`:
+            >>> management = {}
+            >>>
+            >>> response = client.set_node_pool_management(project_id, zone, cluster_id, node_pool_id, management)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to update.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to update.
+                This field has been deprecated and replaced by the name field.
+            management (Union[dict, ~google.cloud.container_v1beta1.types.NodeManagement]): NodeManagement configuration for the node pool.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.NodeManagement`
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                set management properties. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_node_pool_management" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_node_pool_management"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_node_pool_management,
+                default_retry=self._method_configs["SetNodePoolManagement"].retry,
+                default_timeout=self._method_configs["SetNodePoolManagement"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNodePoolManagementRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            management=management,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_node_pool_management"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_labels(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        resource_labels,
+        label_fingerprint,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets labels on a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `resource_labels`:
+            >>> resource_labels = {}
+            >>>
+            >>> # TODO: Initialize `label_fingerprint`:
+            >>> label_fingerprint = ''
+            >>>
+            >>> response = client.set_labels(project_id, zone, cluster_id, resource_labels, label_fingerprint)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            resource_labels (dict[str -> str]): The labels to set for that cluster.
+            label_fingerprint (str): 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 <code>get()</code> request to the
+                resource to get the latest fingerprint.
+            name (str): The name (project, location, cluster id) of the cluster to set labels.
+                Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_labels" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_labels"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_labels,
+                default_retry=self._method_configs["SetLabels"].retry,
+                default_timeout=self._method_configs["SetLabels"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLabelsRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            resource_labels=resource_labels,
+            label_fingerprint=label_fingerprint,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_labels"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_legacy_abac(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        enabled,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Enables or disables the ABAC authorization mechanism on a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `enabled`:
+            >>> enabled = False
+            >>>
+            >>> response = client.set_legacy_abac(project_id, zone, cluster_id, enabled)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to update.
+                This field has been deprecated and replaced by the name field.
+            enabled (bool): Whether ABAC authorization will be enabled in the cluster.
+            name (str): The name (project, location, cluster id) of the cluster to set legacy
+                abac. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_legacy_abac" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_legacy_abac"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_legacy_abac,
+                default_retry=self._method_configs["SetLegacyAbac"].retry,
+                default_timeout=self._method_configs["SetLegacyAbac"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetLegacyAbacRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            enabled=enabled,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_legacy_abac"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def start_i_p_rotation(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        rotate_credentials=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Start master IP rotation.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.start_i_p_rotation(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster id) of the cluster to start IP
+                rotation. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            rotate_credentials (bool): Whether to rotate credentials during IP rotation.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "start_i_p_rotation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "start_i_p_rotation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.start_i_p_rotation,
+                default_retry=self._method_configs["StartIPRotation"].retry,
+                default_timeout=self._method_configs["StartIPRotation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.StartIPRotationRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            name=name,
+            rotate_credentials=rotate_credentials,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["start_i_p_rotation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def complete_i_p_rotation(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Completes master IP rotation.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> response = client.complete_i_p_rotation(project_id, zone, cluster_id)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            name (str): The name (project, location, cluster id) of the cluster to complete IP
+                rotation. Specified in the format 'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "complete_i_p_rotation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "complete_i_p_rotation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.complete_i_p_rotation,
+                default_retry=self._method_configs["CompleteIPRotation"].retry,
+                default_timeout=self._method_configs["CompleteIPRotation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.CompleteIPRotationRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["complete_i_p_rotation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_node_pool_size(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        node_pool_id,
+        node_count,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the size for a specific node pool.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `node_pool_id`:
+            >>> node_pool_id = ''
+            >>>
+            >>> # TODO: Initialize `node_count`:
+            >>> node_count = 0
+            >>>
+            >>> response = client.set_node_pool_size(project_id, zone, cluster_id, node_pool_id, node_count)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster to update.
+                This field has been deprecated and replaced by the name field.
+            node_pool_id (str): Deprecated. The name of the node pool to update.
+                This field has been deprecated and replaced by the name field.
+            node_count (int): The desired node count for the pool.
+            name (str): The name (project, location, cluster, node pool id) of the node pool to
+                set size. Specified in the format
+                'projects/*/locations/*/clusters/*/nodePools/*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_node_pool_size" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_node_pool_size"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_node_pool_size,
+                default_retry=self._method_configs["SetNodePoolSize"].retry,
+                default_timeout=self._method_configs["SetNodePoolSize"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNodePoolSizeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_count=node_count,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_node_pool_size"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_network_policy(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        network_policy,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Enables/Disables Network Policy for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `network_policy`:
+            >>> network_policy = {}
+            >>>
+            >>> response = client.set_network_policy(project_id, zone, cluster_id, network_policy)
+
+        Args:
+            project_id (str): 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.
+            zone (str): 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.
+            cluster_id (str): Deprecated. The name of the cluster.
+                This field has been deprecated and replaced by the name field.
+            network_policy (Union[dict, ~google.cloud.container_v1beta1.types.NetworkPolicy]): Configuration options for the NetworkPolicy feature.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.NetworkPolicy`
+            name (str): The name (project, location, cluster id) of the cluster to set
+                networking policy. Specified in the format
+                'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_network_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_network_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_network_policy,
+                default_retry=self._method_configs["SetNetworkPolicy"].retry,
+                default_timeout=self._method_configs["SetNetworkPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetNetworkPolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            network_policy=network_policy,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_network_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_maintenance_policy(
+        self,
+        project_id,
+        zone,
+        cluster_id,
+        maintenance_policy,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the maintenance policy for a cluster.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `zone`:
+            >>> zone = ''
+            >>>
+            >>> # TODO: Initialize `cluster_id`:
+            >>> cluster_id = ''
+            >>>
+            >>> # TODO: Initialize `maintenance_policy`:
+            >>> maintenance_policy = {}
+            >>>
+            >>> response = client.set_maintenance_policy(project_id, zone, cluster_id, maintenance_policy)
+
+        Args:
+            project_id (str): The Google Developers Console `project ID or project
+                number <https://support.google.com/cloud/answer/6158840>`__.
+            zone (str): The name of the Google Compute Engine
+                `zone <https://cloud.google.com/compute/docs/zones#available>`__ in
+                which the cluster resides.
+            cluster_id (str): The name of the cluster to update.
+            maintenance_policy (Union[dict, ~google.cloud.container_v1beta1.types.MaintenancePolicy]): The maintenance policy to be set for the cluster. An empty field
+                clears the existing maintenance policy.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.container_v1beta1.types.MaintenancePolicy`
+            name (str): The name (project, location, cluster id) of the cluster to set
+                maintenance policy. Specified in the format
+                'projects/*/locations/*/clusters/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_maintenance_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_maintenance_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_maintenance_policy,
+                default_retry=self._method_configs["SetMaintenancePolicy"].retry,
+                default_timeout=self._method_configs["SetMaintenancePolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.SetMaintenancePolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            maintenance_policy=maintenance_policy,
+            name=name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_maintenance_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_usable_subnetworks(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists subnetworks that are usable for creating clusters in a project.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_usable_subnetworks(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_usable_subnetworks(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The parent project where subnetworks are usable. Specified in the format
+                'projects/\*'.
+            filter_ (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.container_v1beta1.types.UsableSubnetwork` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_usable_subnetworks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_usable_subnetworks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_usable_subnetworks,
+                default_retry=self._method_configs["ListUsableSubnetworks"].retry,
+                default_timeout=self._method_configs["ListUsableSubnetworks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListUsableSubnetworksRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_usable_subnetworks"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="subnetworks",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_locations(
+        self,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Used to fetch locations that offer GKE.
+
+        Example:
+            >>> from google.cloud import container_v1beta1
+            >>>
+            >>> client = container_v1beta1.ClusterManagerClient()
+            >>>
+            >>> # TODO: Initialize `parent`:
+            >>> parent = ''
+            >>>
+            >>> response = client.list_locations(parent)
+
+        Args:
+            parent (str): Contains the name of the resource requested. Specified in the format
+                'projects/\*'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.container_v1beta1.types.ListLocationsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_locations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_locations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_locations,
+                default_retry=self._method_configs["ListLocations"].retry,
+                default_timeout=self._method_configs["ListLocations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cluster_service_pb2.ListLocationsRequest(parent=parent)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_locations"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/container/google/cloud/container_v1beta1/gapic/cluster_manager_client_config.py b/container/google/cloud/container_v1beta1/gapic/cluster_manager_client_config.py
new file mode 100644
index 000000000000..18e6f5b58bb6
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/gapic/cluster_manager_client_config.py
@@ -0,0 +1,183 @@
+config = {
+    "interfaces": {
+        "google.container.v1beta1.ClusterManager": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListClusters": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNodePoolAutoscaling": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLoggingService": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetMonitoringService": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetAddonsConfig": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLocations": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateMaster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetMasterAuth": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteCluster": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListOperations": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetOperation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelOperation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetServerConfig": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListNodePools": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteNodePool": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RollbackNodePoolUpgrade": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNodePoolManagement": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLabels": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetLegacyAbac": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "StartIPRotation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CompleteIPRotation": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNodePoolSize": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetNetworkPolicy": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetMaintenancePolicy": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListUsableSubnetworks": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListLocations": {
+                    "timeout_millis": 20000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/container/google/cloud/container_v1beta1/gapic/enums.py b/container/google/cloud/container_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..f9663fc54d4c
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/gapic/enums.py
@@ -0,0 +1,294 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Cluster(object):
+    class Status(enum.IntEnum):
+        """
+        The current status of the cluster.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int): Not set.
+          PROVISIONING (int): The PROVISIONING state indicates the cluster is being created.
+          RUNNING (int): The RUNNING state indicates the cluster has been created and is fully
+          usable.
+          RECONCILING (int): The RECONCILING state indicates that some work is actively being done on
+          the cluster, such as upgrading the master or node software. Details can
+          be found in the ``statusMessage`` field.
+          STOPPING (int): The STOPPING state indicates the cluster is being deleted.
+          ERROR (int): The ERROR state indicates the cluster may be unusable. Details can be
+          found in the ``statusMessage`` field.
+          DEGRADED (int): The DEGRADED state indicates the cluster requires user action to restore
+          full functionality. Details can be found in the ``statusMessage`` field.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        PROVISIONING = 1
+        RUNNING = 2
+        RECONCILING = 3
+        STOPPING = 4
+        ERROR = 5
+        DEGRADED = 6
+
+
+class IstioConfig(object):
+    class IstioAuthMode(enum.IntEnum):
+        """
+        Istio auth mode, https://istio.io/docs/concepts/security/mutual-tls.html
+
+        Attributes:
+          AUTH_NONE (int): auth not enabled
+          AUTH_MUTUAL_TLS (int): auth mutual TLS enabled
+        """
+
+        AUTH_NONE = 0
+        AUTH_MUTUAL_TLS = 1
+
+
+class Location(object):
+    class LocationType(enum.IntEnum):
+        """
+        LocationType is the type of GKE location, regional or zonal.
+
+        Attributes:
+          LOCATION_TYPE_UNSPECIFIED (int): LOCATION\_TYPE\_UNSPECIFIED means the location type was not determined.
+          ZONE (int): A GKE Location where Zonal clusters can be created.
+          REGION (int): A GKE Location where Regional clusters can be created.
+        """
+
+        LOCATION_TYPE_UNSPECIFIED = 0
+        ZONE = 1
+        REGION = 2
+
+
+class NetworkPolicy(object):
+    class Provider(enum.IntEnum):
+        """
+        Allowed Network Policy providers.
+
+        Attributes:
+          PROVIDER_UNSPECIFIED (int): Not set
+          CALICO (int): Tigera (Calico Felix).
+        """
+
+        PROVIDER_UNSPECIFIED = 0
+        CALICO = 1
+
+
+class NodePool(object):
+    class Status(enum.IntEnum):
+        """
+        The current status of the node pool instance.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int): Not set.
+          PROVISIONING (int): The PROVISIONING state indicates the node pool is being created.
+          RUNNING (int): The RUNNING state indicates the node pool has been created
+          and is fully usable.
+          RUNNING_WITH_ERROR (int): The RUNNING\_WITH\_ERROR state indicates the node pool has been created
+          and is partially usable. Some error state has occurred and some
+          functionality may be impaired. Customer may need to reissue a request or
+          trigger a new update.
+          RECONCILING (int): The RECONCILING state indicates that some work is actively being done on
+          the node pool, such as upgrading node software. Details can be found in
+          the ``statusMessage`` field.
+          STOPPING (int): The STOPPING state indicates the node pool is being deleted.
+          ERROR (int): The ERROR state indicates the node pool may be unusable. Details can be
+          found in the ``statusMessage`` field.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        PROVISIONING = 1
+        RUNNING = 2
+        RUNNING_WITH_ERROR = 3
+        RECONCILING = 4
+        STOPPING = 5
+        ERROR = 6
+
+
+class NodeTaint(object):
+    class Effect(enum.IntEnum):
+        """
+        Possible values for Effect in taint.
+
+        Attributes:
+          EFFECT_UNSPECIFIED (int): Not set
+          NO_SCHEDULE (int): NoSchedule
+          PREFER_NO_SCHEDULE (int): PreferNoSchedule
+          NO_EXECUTE (int): NoExecute
+        """
+
+        EFFECT_UNSPECIFIED = 0
+        NO_SCHEDULE = 1
+        PREFER_NO_SCHEDULE = 2
+        NO_EXECUTE = 3
+
+
+class Operation(object):
+    class Status(enum.IntEnum):
+        """
+        Current status of the operation.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int): Not set.
+          PENDING (int): The operation has been created.
+          RUNNING (int): The operation is currently running.
+          DONE (int): The operation is done, either cancelled or completed.
+          ABORTING (int): The operation is aborting.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+        ABORTING = 4
+
+    class Type(enum.IntEnum):
+        """
+        Operation type.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Not set.
+          CREATE_CLUSTER (int): Cluster create.
+          DELETE_CLUSTER (int): Cluster delete.
+          UPGRADE_MASTER (int): A master upgrade.
+          UPGRADE_NODES (int): A node upgrade.
+          REPAIR_CLUSTER (int): Cluster repair.
+          UPDATE_CLUSTER (int): Cluster update.
+          CREATE_NODE_POOL (int): Node pool create.
+          DELETE_NODE_POOL (int): Node pool delete.
+          SET_NODE_POOL_MANAGEMENT (int): Set node pool management.
+          AUTO_REPAIR_NODES (int): Automatic node pool repair.
+          AUTO_UPGRADE_NODES (int): Automatic node upgrade.
+          SET_LABELS (int): Set labels.
+          SET_MASTER_AUTH (int): Set/generate master auth materials
+          SET_NODE_POOL_SIZE (int): Set node pool size.
+          SET_NETWORK_POLICY (int): Updates network policy for a cluster.
+          SET_MAINTENANCE_POLICY (int): Set the maintenance policy.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        CREATE_CLUSTER = 1
+        DELETE_CLUSTER = 2
+        UPGRADE_MASTER = 3
+        UPGRADE_NODES = 4
+        REPAIR_CLUSTER = 5
+        UPDATE_CLUSTER = 6
+        CREATE_NODE_POOL = 7
+        DELETE_NODE_POOL = 8
+        SET_NODE_POOL_MANAGEMENT = 9
+        AUTO_REPAIR_NODES = 10
+        AUTO_UPGRADE_NODES = 11
+        SET_LABELS = 12
+        SET_MASTER_AUTH = 13
+        SET_NODE_POOL_SIZE = 14
+        SET_NETWORK_POLICY = 15
+        SET_MAINTENANCE_POLICY = 16
+
+
+class SetMasterAuthRequest(object):
+    class Action(enum.IntEnum):
+        """
+        Operation type: what type update to perform.
+
+        Attributes:
+          UNKNOWN (int): Operation is unknown and will error out.
+          SET_PASSWORD (int): Set the password to a user generated value.
+          GENERATE_PASSWORD (int): Generate a new password and set it to that.
+          SET_USERNAME (int): Set the username.  If an empty username is provided, basic authentication
+          is disabled for the cluster.  If a non-empty username is provided, basic
+          authentication is enabled, with either a provided password or a generated
+          one.
+        """
+
+        UNKNOWN = 0
+        SET_PASSWORD = 1
+        GENERATE_PASSWORD = 2
+        SET_USERNAME = 3
+
+
+class StatusCondition(object):
+    class Code(enum.IntEnum):
+        """
+        Code for each condition
+
+        Attributes:
+          UNKNOWN (int): UNKNOWN indicates a generic condition.
+          GCE_STOCKOUT (int): GCE\_STOCKOUT indicates a Google Compute Engine stockout.
+          GKE_SERVICE_ACCOUNT_DELETED (int): GKE\_SERVICE\_ACCOUNT\_DELETED indicates that the user deleted their
+          robot service account.
+          GCE_QUOTA_EXCEEDED (int): Google Compute Engine quota was exceeded.
+          SET_BY_OPERATOR (int): Cluster state was manually changed by an SRE due to a system logic error.
+          More codes TBA
+        """
+
+        UNKNOWN = 0
+        GCE_STOCKOUT = 1
+        GKE_SERVICE_ACCOUNT_DELETED = 2
+        GCE_QUOTA_EXCEEDED = 3
+        SET_BY_OPERATOR = 4
+
+
+class UsableSubnetworkSecondaryRange(object):
+    class Status(enum.IntEnum):
+        """
+        Status shows the current usage of a secondary IP range.
+
+        Attributes:
+          UNKNOWN (int): UNKNOWN is the zero value of the Status enum. It's not a valid status.
+          UNUSED (int): UNUSED denotes that this range is unclaimed by any cluster.
+          IN_USE_SERVICE (int): IN\_USE\_SERVICE denotes that this range is claimed by a cluster for
+          services. It cannot be used for other clusters.
+          IN_USE_SHAREABLE_POD (int): 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_MANAGED_POD (int): IN\_USE\_MANAGED\_POD denotes this range was created by GKE and is
+          claimed for pods. It cannot be used for other clusters.
+        """
+
+        UNKNOWN = 0
+        UNUSED = 1
+        IN_USE_SERVICE = 2
+        IN_USE_SHAREABLE_POD = 3
+        IN_USE_MANAGED_POD = 4
+
+
+class WorkloadMetadataConfig(object):
+    class NodeMetadata(enum.IntEnum):
+        """
+        NodeMetadata is the configuration for if and how to expose the node
+        metadata to the workload running on the node.
+
+        Attributes:
+          UNSPECIFIED (int): Not set.
+          SECURE (int): Prevent workloads not in hostNetwork from accessing certain VM metadata,
+          specifically kube-env, which contains Kubelet credentials, and the
+          instance identity token.
+
+          Metadata concealment is a temporary security solution available while the
+          bootstrapping process for cluster nodes is being redesigned with
+          significant security improvements.  This feature is scheduled to be
+          deprecated in the future and later removed.
+          EXPOSE (int): Expose all VM metadata to pods.
+        """
+
+        UNSPECIFIED = 0
+        SECURE = 1
+        EXPOSE = 2
diff --git a/container/google/cloud/container_v1beta1/gapic/transports/__init__.py b/container/google/cloud/container_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/container/google/cloud/container_v1beta1/gapic/transports/cluster_manager_grpc_transport.py b/container/google/cloud/container_v1beta1/gapic/transports/cluster_manager_grpc_transport.py
new file mode 100644
index 000000000000..e0fb837b8486
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/gapic/transports/cluster_manager_grpc_transport.py
@@ -0,0 +1,548 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.container_v1beta1.proto import cluster_service_pb2_grpc
+
+
+class ClusterManagerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.container.v1beta1 ClusterManager API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="container.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "cluster_manager_stub": cluster_service_pb2_grpc.ClusterManagerStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="container.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_clusters(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_clusters`.
+
+        Lists all clusters owned by a project in either the specified zone or all
+        zones.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListClusters
+
+    @property
+    def get_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_cluster`.
+
+        Gets the details for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetCluster
+
+    @property
+    def create_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.create_cluster`.
+
+        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 <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 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CreateCluster
+
+    @property
+    def update_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.update_cluster`.
+
+        Updates the settings for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].UpdateCluster
+
+    @property
+    def update_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.update_node_pool`.
+
+        Updates the version and/or image type of a specific node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].UpdateNodePool
+
+    @property
+    def set_node_pool_autoscaling(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_autoscaling`.
+
+        Sets the autoscaling settings of a specific node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNodePoolAutoscaling
+
+    @property
+    def set_logging_service(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_logging_service`.
+
+        Sets the logging service for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLoggingService
+
+    @property
+    def set_monitoring_service(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_monitoring_service`.
+
+        Sets the monitoring service for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetMonitoringService
+
+    @property
+    def set_addons_config(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_addons_config`.
+
+        Sets the addons for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetAddonsConfig
+
+    @property
+    def set_locations(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_locations`.
+
+        Sets the locations for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLocations
+
+    @property
+    def update_master(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.update_master`.
+
+        Updates the master for a specific cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].UpdateMaster
+
+    @property
+    def set_master_auth(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_master_auth`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetMasterAuth
+
+    @property
+    def delete_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.delete_cluster`.
+
+        Deletes the cluster, including the Kubernetes endpoint and all worker
+        nodes.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].DeleteCluster
+
+    @property
+    def list_operations(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_operations`.
+
+        Lists all operations in a project in a specific zone or all zones.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListOperations
+
+    @property
+    def get_operation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_operation`.
+
+        Gets the specified operation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetOperation
+
+    @property
+    def cancel_operation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.cancel_operation`.
+
+        Cancels the specified operation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CancelOperation
+
+    @property
+    def get_server_config(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_server_config`.
+
+        Returns configuration info about the Kubernetes Engine service.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetServerConfig
+
+    @property
+    def list_node_pools(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_node_pools`.
+
+        Lists the node pools for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListNodePools
+
+    @property
+    def get_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.get_node_pool`.
+
+        Retrieves the node pool requested.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].GetNodePool
+
+    @property
+    def create_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.create_node_pool`.
+
+        Creates a node pool for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CreateNodePool
+
+    @property
+    def delete_node_pool(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.delete_node_pool`.
+
+        Deletes a node pool from a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].DeleteNodePool
+
+    @property
+    def rollback_node_pool_upgrade(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.rollback_node_pool_upgrade`.
+
+        Roll back the previously Aborted or Failed NodePool upgrade.
+        This will be an no-op if the last upgrade successfully completed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].RollbackNodePoolUpgrade
+
+    @property
+    def set_node_pool_management(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_management`.
+
+        Sets the NodeManagement options for a node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNodePoolManagement
+
+    @property
+    def set_labels(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_labels`.
+
+        Sets labels on a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLabels
+
+    @property
+    def set_legacy_abac(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_legacy_abac`.
+
+        Enables or disables the ABAC authorization mechanism on a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetLegacyAbac
+
+    @property
+    def start_i_p_rotation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.start_i_p_rotation`.
+
+        Start master IP rotation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].StartIPRotation
+
+    @property
+    def complete_i_p_rotation(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.complete_i_p_rotation`.
+
+        Completes master IP rotation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].CompleteIPRotation
+
+    @property
+    def set_node_pool_size(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_size`.
+
+        Sets the size for a specific node pool.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNodePoolSize
+
+    @property
+    def set_network_policy(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_network_policy`.
+
+        Enables/Disables Network Policy for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetNetworkPolicy
+
+    @property
+    def set_maintenance_policy(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.set_maintenance_policy`.
+
+        Sets the maintenance policy for a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].SetMaintenancePolicy
+
+    @property
+    def list_usable_subnetworks(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_usable_subnetworks`.
+
+        Lists subnetworks that are usable for creating clusters in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListUsableSubnetworks
+
+    @property
+    def list_locations(self):
+        """Return the gRPC stub for :meth:`ClusterManagerClient.list_locations`.
+
+        Used to fetch locations that offer GKE.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_manager_stub"].ListLocations
diff --git a/container/google/cloud/container_v1beta1/proto/__init__.py b/container/google/cloud/container_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/container/google/cloud/container_v1beta1/proto/cluster_service.proto b/container/google/cloud/container_v1beta1/proto/cluster_service.proto
new file mode 100644
index 000000000000..37918d7c15a5
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/proto/cluster_service.proto
@@ -0,0 +1,2740 @@
+// 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.container.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/empty.proto";
+
+option csharp_namespace = "Google.Cloud.Container.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/container/v1beta1;container";
+option java_multiple_files = true;
+option java_outer_classname = "ClusterServiceProto";
+option java_package = "com.google.container.v1beta1";
+option php_namespace = "Google\\Cloud\\Container\\V1beta1";
+
+
+// Google Kubernetes Engine Cluster Manager v1beta1
+service ClusterManager {
+  // Lists all clusters owned by a project in either the specified zone or all
+  // zones.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/clusters"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters"
+      }
+    };
+  }
+
+  // Gets the details for a specific cluster.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/clusters/*}"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{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).
+  //
+  // One firewall is added for the cluster. After cluster creation,
+  // the cluster 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.
+  rpc CreateCluster(CreateClusterRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/clusters"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the settings for a specific cluster.
+  rpc UpdateCluster(UpdateClusterRequest) returns (Operation) {
+    option (google.api.http) = {
+      put: "/v1beta1/{name=projects/*/locations/*/clusters/*}"
+      body: "*"
+      additional_bindings {
+        put: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the version and/or image type of a specific node pool.
+  rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation) {
+    option (google.api.http) = {
+      put: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/update"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the autoscaling settings of a specific node pool.
+  rpc SetNodePoolAutoscaling(SetNodePoolAutoscalingRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/autoscaling"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the logging service for a specific cluster.
+  rpc SetLoggingService(SetLoggingServiceRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setLogging"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/logging"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the monitoring service for a specific cluster.
+  rpc SetMonitoringService(SetMonitoringServiceRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setMonitoring"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/monitoring"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the addons for a specific cluster.
+  rpc SetAddonsConfig(SetAddonsConfigRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setAddons"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/addons"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the locations for a specific cluster.
+  rpc SetLocations(SetLocationsRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setLocations"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/locations"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the master for a specific cluster.
+  rpc UpdateMaster(UpdateMasterRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:updateMaster"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/master"
+        body: "*"
+      }
+    };
+  }
+
+  // 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.
+  rpc SetMasterAuth(SetMasterAuthRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setMasterAuth"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMasterAuth"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes the cluster, including the Kubernetes endpoint and all worker
+  // nodes.
+  //
+  // 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.
+  rpc DeleteCluster(DeleteClusterRequest) returns (Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/clusters/*}"
+      additional_bindings {
+        delete: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+      }
+    };
+  }
+
+  // Lists all operations in a project in a specific zone or all zones.
+  rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/operations"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/operations"
+      }
+    };
+  }
+
+  // Gets the specified operation.
+  rpc GetOperation(GetOperationRequest) returns (Operation) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/operations/*}"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}"
+      }
+    };
+  }
+
+  // Cancels the specified operation.
+  rpc CancelOperation(CancelOperationRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/operations/*}:cancel"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}:cancel"
+        body: "*"
+      }
+    };
+  }
+
+  // Returns configuration info about the Kubernetes Engine service.
+  rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*}/serverConfig"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/serverconfig"
+      }
+    };
+  }
+
+  // Lists the node pools for a cluster.
+  rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/clusters/*}/nodePools"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
+      }
+    };
+  }
+
+  // Retrieves the node pool requested.
+  rpc GetNodePool(GetNodePoolRequest) returns (NodePool) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
+      additional_bindings {
+        get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+      }
+    };
+  }
+
+  // Creates a node pool for a cluster.
+  rpc CreateNodePool(CreateNodePoolRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/clusters/*}/nodePools"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes a node pool from a cluster.
+  rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
+      additional_bindings {
+        delete: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+      }
+    };
+  }
+
+  // Roll back the previously Aborted or Failed NodePool upgrade.
+  // This will be an no-op if the last upgrade successfully completed.
+  rpc RollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}:rollback"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the NodeManagement options for a node pool.
+  rpc SetNodePoolManagement(SetNodePoolManagementRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setManagement"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setManagement"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets labels on a cluster.
+  rpc SetLabels(SetLabelsRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setResourceLabels"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels"
+        body: "*"
+      }
+    };
+  }
+
+  // Enables or disables the ABAC authorization mechanism on a cluster.
+  rpc SetLegacyAbac(SetLegacyAbacRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac"
+        body: "*"
+      }
+    };
+  }
+
+  // Start master IP rotation.
+  rpc StartIPRotation(StartIPRotationRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:startIpRotation"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:startIpRotation"
+        body: "*"
+      }
+    };
+  }
+
+  // Completes master IP rotation.
+  rpc CompleteIPRotation(CompleteIPRotationRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:completeIpRotation"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:completeIpRotation"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the size for a specific node pool.
+  rpc SetNodePoolSize(SetNodePoolSizeRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setSize"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setSize"
+        body: "*"
+      }
+    };
+  }
+
+  // Enables/Disables Network Policy for a cluster.
+  rpc SetNetworkPolicy(SetNetworkPolicyRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setNetworkPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the maintenance policy for a cluster.
+  rpc SetMaintenancePolicy(SetMaintenancePolicyRequest) returns (Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setMaintenancePolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMaintenancePolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Lists subnetworks that are usable for creating clusters in a project.
+  rpc ListUsableSubnetworks(ListUsableSubnetworksRequest) returns (ListUsableSubnetworksResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/aggregated/usableSubnetworks"
+    };
+  }
+
+  // Used to fetch locations that offer GKE.
+  rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/locations"
+    };
+  }
+}
+
+// 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.
+  // `n1-standard-1`).
+  //
+  // If unspecified, the default machine type is
+  // `n1-standard-1`.
+  string machine_type = 1;
+
+  // Size of the disk attached to each node, specified in GB.
+  // The smallest allowed disk size is 10GB.
+  //
+  // If unspecified, the default disk size is 100GB.
+  int32 disk_size_gb = 2;
+
+  // The set of Google API scopes to be made available on all of the
+  // node VMs under the "default" service account.
+  //
+  // The following scopes are recommended, but not required, and by default are
+  // not included:
+  //
+  // * `https://www.googleapis.com/auth/compute` is required for mounting
+  // 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/)).
+  //
+  // If unspecified, no scopes are added, unless Cloud Logging or Cloud
+  // Monitoring are enabled, in which case their required scopes will be added.
+  repeated string oauth_scopes = 3;
+
+  // The Google Cloud Platform Service Account to be used by the node VMs. If
+  // no Service Account is specified, the "default" service account is used.
+  string service_account = 9;
+
+  // The metadata key/value pairs assigned to instances in the cluster.
+  //
+  // Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+  // in length. These are reflected as part of a URL in the metadata server.
+  // Additionally, to avoid ambiguity, keys must not conflict with any other
+  // metadata keys for the project or be one of the reserved keys:
+  //  "cluster-location"
+  //  "cluster-name"
+  //  "cluster-uid"
+  //  "configure-sh"
+  //  "enable-oslogin"
+  //  "gci-ensure-gke-docker"
+  //  "gci-update-strategy"
+  //  "instance-template"
+  //  "kube-env"
+  //  "startup-script"
+  //  "user-data"
+  //
+  // 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.
+  //
+  // The total size of all keys and values must be less than 512 KB.
+  map<string, string> metadata = 4;
+
+  // The image type to use for this node. Note that for a given image type,
+  // the latest version of it will be used.
+  string image_type = 5;
+
+  // The map of Kubernetes labels (key/value pairs) to be applied to each node.
+  // These will added in addition to any default label(s) that
+  // Kubernetes may apply to the node.
+  // In case of conflict in label keys, the applied set may differ depending on
+  // the Kubernetes version -- it's best to assume the behavior is undefined
+  // and conflicts should be avoided.
+  // For more information, including usage and the valid values, see:
+  // https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+  map<string, string> labels = 6;
+
+  // The number of local SSD disks to be attached to the node.
+  //
+  // The limit for this value is dependant 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
+  // for more information.
+  int32 local_ssd_count = 7;
+
+  // The list of instance tags applied to all nodes. Tags are used to identify
+  // valid sources or targets for network firewalls and are specified by
+  // the client during cluster or node pool creation. Each tag within the list
+  // must comply with RFC1035.
+  repeated string tags = 8;
+
+  // Whether the nodes are created as preemptible VM instances. See:
+  // https://cloud.google.com/compute/docs/instances/preemptible for more
+  // inforamtion about preemptible VM instances.
+  bool preemptible = 10;
+
+  // A list of hardware accelerators to be attached to each node.
+  // See https://cloud.google.com/compute/docs/gpus for more information about
+  // support for GPUs.
+  repeated AcceleratorConfig accelerators = 11;
+
+  // Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+  //
+  // If unspecified, the default disk type is 'pd-standard'
+  string disk_type = 12;
+
+  // Minimum CPU platform to be used by this instance. The instance may be
+  // scheduled on the specified or newer CPU platform. Applicable values are the
+  // friendly names of CPU platforms, such as
+  // <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+  // <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+  // information, read [how to specify min CPU
+  // platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+  string min_cpu_platform = 13;
+
+  // The workload metadata configuration for this node.
+  WorkloadMetadataConfig workload_metadata_config = 14;
+
+  // 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;
+}
+
+// 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.
+// Authentication can be done using HTTP basic auth or using client
+// certificates.
+message MasterAuth {
+  // The username to use for HTTP basic authentication to the master endpoint.
+  // 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.
+  // Because the master endpoint is open to the Internet, you should create a
+  // strong password.  If a password is provided for cluster creation, username
+  // must be non-empty.
+  string password = 2;
+
+  // Configuration for client certificate authentication on the cluster. For
+  // clusters before v1.12, if no configuration is specified, a client
+  // certificate is issued.
+  ClientCertificateConfig client_certificate_config = 3;
+
+  // [Output only] Base64-encoded public certificate that is the root of
+  // trust for the cluster.
+  string cluster_ca_certificate = 100;
+
+  // [Output only] Base64-encoded public certificate used by clients to
+  // authenticate to the cluster endpoint.
+  string client_certificate = 101;
+
+  // [Output only] Base64-encoded private key used by clients to authenticate
+  // to the cluster endpoint.
+  string client_key = 102;
+}
+
+// Configuration for client certificates on the cluster.
+message ClientCertificateConfig {
+  // Issue a client certificate.
+  bool issue_client_certificate = 1;
+}
+
+// Configuration for the addons that can be automatically spun up in the
+// cluster, enabling additional functionality.
+message AddonsConfig {
+  // Configuration for the HTTP (L7) load balancing controller addon, which
+  // makes it easy to set up HTTP load balancers for services in a cluster.
+  HttpLoadBalancing http_load_balancing = 1;
+
+  // Configuration for the horizontal pod autoscaling feature, which
+  // increases or decreases the number of replica pods a replication controller
+  // has based on the resource usage of the existing pods.
+  HorizontalPodAutoscaling horizontal_pod_autoscaling = 2;
+
+  // Configuration for the Kubernetes Dashboard.
+  KubernetesDashboard kubernetes_dashboard = 3;
+
+  // 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 Istio, an open platform to connect, manage, and secure
+  // microservices.
+  IstioConfig istio_config = 5;
+
+  // Configuration for the Cloud Run addon. The `IstioConfig` addon must be
+  // enabled in order to enable Cloud Run addon. This option can only be enabled
+  // at cluster creation time.
+  CloudRunConfig cloud_run_config = 7;
+}
+
+// Configuration options for the HTTP (L7) load balancing controller addon,
+// which makes it easy to set up HTTP load balancers for services in a cluster.
+message HttpLoadBalancing {
+  // Whether the HTTP Load Balancing controller is enabled in the cluster.
+  // When enabled, it runs a small pod in the cluster that manages the load
+  // balancers.
+  bool disabled = 1;
+}
+
+// Configuration options for the horizontal pod autoscaling feature, which
+// increases or decreases the number of replica pods a replication controller
+// has based on the resource usage of the existing pods.
+message HorizontalPodAutoscaling {
+  // Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+  // When enabled, it ensures that a Heapster pod is running in the cluster,
+  // which is also used by the Cloud Monitoring service.
+  bool disabled = 1;
+}
+
+// Configuration for the Kubernetes Dashboard.
+message KubernetesDashboard {
+  // Whether the Kubernetes Dashboard is enabled for this cluster.
+  bool disabled = 1;
+}
+
+// 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.
+message NetworkPolicyConfig {
+  // Whether NetworkPolicy is enabled for this cluster.
+  bool disabled = 1;
+}
+
+// Configuration options for private clusters.
+message PrivateClusterConfig {
+  // Whether nodes have internal IP addresses only. If enabled, all nodes are
+  // given only RFC 1918 private addresses and communicate with the master via
+  // private networking.
+  bool enable_private_nodes = 1;
+
+  // Whether the master's internal IP address is used as the cluster endpoint.
+  bool enable_private_endpoint = 2;
+
+  // The IP range in CIDR notation to use for the hosted master network. This
+  // range will be used for assigning internal IP addresses to the master or
+  // set of masters, as well as the ILB VIP. This range must not overlap with
+  // any other ranges in use within the cluster's network.
+  string master_ipv4_cidr_block = 3;
+
+  // Output only. The internal IP address of this cluster's master endpoint.
+  string private_endpoint = 4;
+
+  // Output only. The external IP address of this cluster's master endpoint.
+  string public_endpoint = 5;
+}
+
+// Configuration options for Istio addon.
+message IstioConfig {
+  // Istio auth mode, https://istio.io/docs/concepts/security/mutual-tls.html
+  enum IstioAuthMode {
+    // auth not enabled
+    AUTH_NONE = 0;
+
+    // auth mutual TLS enabled
+    AUTH_MUTUAL_TLS = 1;
+  }
+
+  // Whether Istio is enabled for this cluster.
+  bool disabled = 1;
+
+  // The specified Istio auth mode, either none, or mutual TLS.
+  IstioAuthMode auth = 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,
+// Google Compute Engine Public IPs and Google Prod IPs.
+message MasterAuthorizedNetworksConfig {
+  // CidrBlock contains an optional name and one CIDR block.
+  message CidrBlock {
+    // display_name is an optional field for users to identify CIDR blocks.
+    string display_name = 1;
+
+    // cidr_block must be specified in CIDR notation.
+    string cidr_block = 2;
+  }
+
+  // Whether or not master authorized networks is enabled.
+  bool enabled = 1;
+
+  // cidr_blocks define up to 10 external networks that could access
+  // Kubernetes master through HTTPS.
+  repeated CidrBlock cidr_blocks = 2;
+}
+
+// Configuration for the legacy Attribute Based Access Control authorization
+// mode.
+message LegacyAbac {
+  // Whether the ABAC authorizer is enabled for this cluster. When enabled,
+  // identities in the system, including service accounts, nodes, and
+  // controllers, will have statically granted permissions beyond those
+  // provided by the RBAC configuration or IAM.
+  bool enabled = 1;
+}
+
+// Configuration options for the NetworkPolicy feature.
+// https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+message NetworkPolicy {
+  // Allowed Network Policy providers.
+  enum Provider {
+    // Not set
+    PROVIDER_UNSPECIFIED = 0;
+
+    // Tigera (Calico Felix).
+    CALICO = 1;
+  }
+
+  // The selected network policy provider.
+  Provider provider = 1;
+
+  // Whether network policy is enabled on the cluster.
+  bool enabled = 2;
+}
+
+// Configuration for controlling how IPs are allocated in the cluster.
+message IPAllocationPolicy {
+  // Whether alias IPs will be used for pod IPs in the cluster.
+  bool use_ip_aliases = 1;
+
+  // Whether a new subnetwork will be created automatically for the cluster.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  bool create_subnetwork = 2;
+
+  // A custom subnetwork name to be used if `create_subnetwork` is true.  If
+  // this field is empty, then an automatic name will be chosen for the new
+  // subnetwork.
+  string subnetwork_name = 3;
+
+  // This field is deprecated, use cluster_ipv4_cidr_block.
+  string cluster_ipv4_cidr = 4 [deprecated = true];
+
+  // This field is deprecated, use node_ipv4_cidr_block.
+  string node_ipv4_cidr = 5 [deprecated = true];
+
+  // This field is deprecated, use services_ipv4_cidr_block.
+  string services_ipv4_cidr = 6 [deprecated = true];
+
+  // The name of the secondary range to be used for the cluster CIDR
+  // block.  The secondary range will be used for pod IP
+  // addresses. This must be an existing secondary range associated
+  // with the cluster subnetwork.
+  //
+  // This field is only applicable with use_ip_aliases and
+  // create_subnetwork is false.
+  string cluster_secondary_range_name = 7;
+
+  // The name of the secondary range to be used as for the services
+  // CIDR block.  The secondary range will be used for service
+  // ClusterIPs. This must be an existing secondary range associated
+  // with the cluster subnetwork.
+  //
+  // This field is only applicable with use_ip_aliases and
+  // create_subnetwork is false.
+  string services_secondary_range_name = 8;
+
+  // The IP address range for the cluster pod IPs. If this field is set, then
+  // `cluster.cluster_ipv4_cidr` must be left blank.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  //
+  // Set to blank to have a range chosen with 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 cluster_ipv4_cidr_block = 9;
+
+  // The IP address range of the instance IPs in this cluster.
+  //
+  // This is applicable only if `create_subnetwork` is true.
+  //
+  // Set to blank to have a range chosen with 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 node_ipv4_cidr_block = 10;
+
+  // The IP address range of the services IPs in this cluster. If blank, a range
+  // will be automatically chosen with the default size.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  //
+  // Set to blank to have a range chosen with 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 services_ipv4_cidr_block = 11;
+
+  // If true, allow allocation of cluster CIDR ranges that overlap with certain
+  // kinds of network routes. By default we do not allow cluster CIDR ranges to
+  // intersect with any user declared routes. With allow_route_overlap == true,
+  // we allow overlapping with CIDR ranges that are larger than the cluster CIDR
+  // range.
+  //
+  // If this field is set to true, then cluster and services CIDRs must be
+  // fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
+  // 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
+  //    `services_ipv4_cidr_block` must be fully-specified.
+  // 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
+  //    fully-specified.
+  bool allow_route_overlap = 12;
+
+  // 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;
+}
+
+// Configuration for Binary Authorization.
+message BinaryAuthorization {
+  // Enable Binary Authorization for this cluster. If enabled, all container
+  // images will be validated by Google Binauthz.
+  bool enabled = 1;
+}
+
+// Configuration for the PodSecurityPolicy feature.
+message PodSecurityPolicyConfig {
+  // Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
+  // must be valid under a PodSecurityPolicy to be created.
+  bool enabled = 1;
+}
+
+// A Google Kubernetes Engine cluster.
+message Cluster {
+  // The current status of the cluster.
+  enum Status {
+    // Not set.
+    STATUS_UNSPECIFIED = 0;
+
+    // The PROVISIONING state indicates the cluster is being created.
+    PROVISIONING = 1;
+
+    // The RUNNING state indicates the cluster has been created and is fully
+    // usable.
+    RUNNING = 2;
+
+    // The RECONCILING state indicates that some work is actively being done on
+    // the cluster, such as upgrading the master or node software. Details can
+    // be found in the `statusMessage` field.
+    RECONCILING = 3;
+
+    // The STOPPING state indicates the cluster is being deleted.
+    STOPPING = 4;
+
+    // The ERROR state indicates the cluster may be unusable. Details
+    // can be found in the `statusMessage` field.
+    ERROR = 5;
+
+    // The DEGRADED state indicates the cluster requires user action to restore
+    // full functionality. Details can be found in the `statusMessage` field.
+    DEGRADED = 6;
+  }
+
+  // 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:
+  //
+  // * Lowercase letters, numbers, and hyphens only.
+  // * Must start with a letter.
+  // * Must end with a number or a letter.
+  string name = 1;
+
+  // An optional description of this cluster.
+  string description = 2;
+
+  // The number of nodes to create in this cluster. You must ensure that your
+  // Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+  // is sufficient for this number of instances. You must also have available
+  // firewall and routes quota.
+  // For requests, this field should only be used in lieu of a
+  // "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;
+
+  // 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.
+  //
+  // If unspecified, the defaults are used.
+  NodeConfig node_config = 4;
+
+  // 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` - 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.
+  string logging_service = 6;
+
+  // 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.
+  // * if left as an empty string, `monitoring.googleapis.com` will be used.
+  string monitoring_service = 7;
+
+  // The name of the Google Compute Engine
+  // [network](/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.
+  string network = 8;
+
+  // The IP address range of the container pods in this cluster, in
+  // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+  // notation (e.g. `10.96.0.0/14`). Leave blank to have
+  // one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+  string cluster_ipv4_cidr = 9;
+
+  // Configurations for the various addons available to run in the cluster.
+  AddonsConfig addons_config = 10;
+
+  // The name of the Google Compute Engine
+  // [subnetwork](/compute/docs/subnetworks) to which the
+  // cluster is connected. On output this shows the subnetwork ID instead of
+  // the name.
+  string subnetwork = 11;
+
+  // The node pools associated with this cluster.
+  // This field should not be set if "node_config" or "initial_node_count" are
+  // specified.
+  repeated NodePool node_pools = 12;
+
+  // The list of Google Compute Engine
+  // [zones](/compute/docs/zones#available) in which the cluster's nodes
+  // should be located.
+  repeated string locations = 13;
+
+  // Kubernetes alpha features are enabled on this cluster. This includes alpha
+  // API groups (e.g. v1beta1) and features that may not be production ready in
+  // the kubernetes version of the master and nodes.
+  // The cluster has no SLA for uptime and master/node upgrades are disabled.
+  // Alpha enabled clusters are automatically deleted thirty days after
+  // creation.
+  bool enable_kubernetes_alpha = 14;
+
+  // The resource labels for the cluster to use to annotate any related
+  // Google Compute Engine resources.
+  map<string, string> resource_labels = 15;
+
+  // The fingerprint of the set of labels for this cluster.
+  string label_fingerprint = 16;
+
+  // Configuration for the legacy ABAC authorization mode.
+  LegacyAbac legacy_abac = 18;
+
+  // Configuration options for the NetworkPolicy feature.
+  NetworkPolicy network_policy = 19;
+
+  // Configuration for cluster IP allocation.
+  IPAllocationPolicy ip_allocation_policy = 20;
+
+  // The configuration options for master authorized networks feature.
+  MasterAuthorizedNetworksConfig master_authorized_networks_config = 22;
+
+  // Configure the maintenance policy for this cluster.
+  MaintenancePolicy maintenance_policy = 23;
+
+  // Configuration for Binary Authorization.
+  BinaryAuthorization binary_authorization = 24;
+
+  // Configuration for the PodSecurityPolicy feature.
+  PodSecurityPolicyConfig pod_security_policy_config = 25;
+
+  // Cluster-level autoscaling configuration.
+  ClusterAutoscaling autoscaling = 26;
+
+  // Configuration for cluster networking.
+  NetworkConfig network_config = 27;
+
+  // If this is a private cluster setup. Private clusters are clusters that, by
+  // default have no external IP addresses on the nodes and where nodes and the
+  // master communicate over private IP addresses.
+  // This field is deprecated, use private_cluster_config.enable_private_nodes
+  // instead.
+  bool private_cluster = 28 [deprecated = true];
+
+  // The IP prefix in CIDR notation to use for the hosted master network.
+  // This prefix will be used for assigning private IP addresses to the
+  // master or set of masters, as well as the ILB VIP.
+  // This field is deprecated, use
+  // private_cluster_config.master_ipv4_cidr_block instead.
+  string master_ipv4_cidr_block = 29 [deprecated = true];
+
+  // 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 unspecified.
+  ResourceUsageExportConfig resource_usage_export_config = 33;
+
+  // Configuration for private cluster.
+  PrivateClusterConfig private_cluster_config = 37;
+
+  // 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
+  // resides.
+  // This field is deprecated, use location instead.
+  string zone = 101 [deprecated = true];
+
+  // [Output only] The IP address of this cluster's master endpoint.
+  // The endpoint can be accessed from the internet at
+  // `https://username:password@endpoint/`.
+  //
+  // See the `masterAuth` property of this resource for username and
+  // password information.
+  string endpoint = 102;
+
+  // The initial Kubernetes version for this cluster.  Valid versions are those
+  // found in validMasterVersions returned by getServerConfig.  The version can
+  // be upgraded over time; such upgrades are reflected in
+  // currentMasterVersion and currentNodeVersion.
+  //
+  // Users may specify either explicit versions offered by
+  // Kubernetes Engine or version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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 initial_cluster_version = 103;
+
+  // [Output only] The current software version of the master endpoint.
+  string current_master_version = 104;
+
+  // [Output only] Deprecated, use
+  // [NodePool.version](/kubernetes-engine/docs/reference/rest/v1beta1/projects.zones.clusters.nodePool)
+  // 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.
+  string current_node_version = 105 [deprecated = true];
+
+  // [Output only] The time the cluster was created, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string create_time = 106;
+
+  // [Output only] The current status of this cluster.
+  Status status = 107;
+
+  // [Output only] Additional information about the current status of this
+  // cluster, if available.
+  string status_message = 108;
+
+  // [Output only] The size of the address space on each node for hosting
+  // containers. This is provisioned from within the `container_ipv4_cidr`
+  // range.
+  int32 node_ipv4_cidr_size = 109;
+
+  // [Output only] The IP address range of the Kubernetes services in
+  // this cluster, in
+  // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+  // notation (e.g. `1.2.3.4/29`). Service addresses are
+  // typically put in the last `/16` from the container CIDR.
+  string services_ipv4_cidr = 110;
+
+  // 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. 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
+  // 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
+// be applied to a cluster with each request, so at most one field can be
+// provided.
+message ClusterUpdate {
+  // The Kubernetes version to change the nodes to (typically an
+  // upgrade).
+  //
+  // Users may specify either explicit versions offered by
+  // Kubernetes Engine or version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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 desired_node_version = 4;
+
+  // 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 in Stackdriver
+  // * "monitoring.googleapis.com" - the Google Cloud Monitoring service
+  // * "none" - no metrics will be exported from the cluster
+  string desired_monitoring_service = 5;
+
+  // Configurations for the various addons available to run in the cluster.
+  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.
+  string desired_node_pool_id = 7;
+
+  // The desired image type for the node pool.
+  // NOTE: Set the "desired_node_pool" field as well.
+  string desired_image_type = 8;
+
+  // 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
+  // the change applies to that single node pool.
+  NodePoolAutoscaling desired_node_pool_autoscaling = 9;
+
+  // The desired list of Google Compute Engine
+  // [zones](/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 desired_locations = 10;
+
+  // The desired configuration options for master authorized networks feature.
+  MasterAuthorizedNetworksConfig desired_master_authorized_networks_config = 12;
+
+  // The desired configuration options for the PodSecurityPolicy feature.
+  PodSecurityPolicyConfig desired_pod_security_policy_config = 14;
+
+  // 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 metrics.
+  // Currently available options:
+  //
+  // * "logging.googleapis.com/kubernetes" - the Google Cloud Logging
+  // service with Kubernetes-native resource model in Stackdriver
+  // * "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 Kubernetes version to change the master to. The only valid value is the
+  // latest supported version.
+  //
+  // Users may specify either explicit versions offered by
+  // Kubernetes Engine or version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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 desired_master_version = 100;
+}
+
+// This operation resource represents operations that may have happened or are
+// happening on the cluster. All fields are output only.
+message Operation {
+  // Current status of the operation.
+  enum Status {
+    // Not set.
+    STATUS_UNSPECIFIED = 0;
+
+    // The operation has been created.
+    PENDING = 1;
+
+    // The operation is currently running.
+    RUNNING = 2;
+
+    // The operation is done, either cancelled or completed.
+    DONE = 3;
+
+    // The operation is aborting.
+    ABORTING = 4;
+  }
+
+  // Operation type.
+  enum Type {
+    // Not set.
+    TYPE_UNSPECIFIED = 0;
+
+    // Cluster create.
+    CREATE_CLUSTER = 1;
+
+    // Cluster delete.
+    DELETE_CLUSTER = 2;
+
+    // A master upgrade.
+    UPGRADE_MASTER = 3;
+
+    // A node upgrade.
+    UPGRADE_NODES = 4;
+
+    // Cluster repair.
+    REPAIR_CLUSTER = 5;
+
+    // Cluster update.
+    UPDATE_CLUSTER = 6;
+
+    // Node pool create.
+    CREATE_NODE_POOL = 7;
+
+    // Node pool delete.
+    DELETE_NODE_POOL = 8;
+
+    // Set node pool management.
+    SET_NODE_POOL_MANAGEMENT = 9;
+
+    // Automatic node pool repair.
+    AUTO_REPAIR_NODES = 10;
+
+    // Automatic node upgrade.
+    AUTO_UPGRADE_NODES = 11;
+
+    // Set labels.
+    SET_LABELS = 12;
+
+    // Set/generate master auth materials
+    SET_MASTER_AUTH = 13;
+
+    // Set node pool size.
+    SET_NODE_POOL_SIZE = 14;
+
+    // Updates network policy for a cluster.
+    SET_NETWORK_POLICY = 15;
+
+    // Set the maintenance policy.
+    SET_MAINTENANCE_POLICY = 16;
+  }
+
+  // The server-assigned ID for the operation.
+  string name = 1;
+
+  // The name of the Google Compute Engine
+  // [zone](/compute/docs/zones#available) in which the operation
+  // is taking place.
+  // This field is deprecated, use location instead.
+  string zone = 2 [deprecated = true];
+
+  // The operation type.
+  Type operation_type = 3;
+
+  // The current status of the operation.
+  Status status = 4;
+
+  // Detailed operation progress, if available.
+  string detail = 8;
+
+  // If an error has occurred, a textual description of the error.
+  string status_message = 5;
+
+  // Server-defined URL for the resource.
+  string self_link = 6;
+
+  // Server-defined URL for the target of the 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
+  // the cluster resides.
+  string location = 9;
+
+  // [Output only] The time the operation started, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string start_time = 10;
+
+  // [Output only] The time the operation completed, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string end_time = 11;
+
+  // [Output only] Progress information for an operation.
+  OperationProgress progress = 12;
+
+  // 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;
+}
+
+// Information about operation (or operation stage) progress.
+message OperationProgress {
+  // Progress metric is (string, int|float|string) pair.
+  message Metric {
+    // Metric name, required.
+    // e.g., "nodes total", "percent done"
+    string name = 1;
+
+    // Strictly one of the values is required.
+    oneof value {
+      // For metrics with integer value.
+      int64 int_value = 2;
+
+      // For metrics with floating point value.
+      double double_value = 3;
+
+      // For metrics with custom values (ratios, visual progress, etc.).
+      string string_value = 4;
+    }
+  }
+
+  // A non-parameterized string describing an operation stage.
+  // Unset for single-stage operations.
+  string name = 1;
+
+  // Status of an operation stage.
+  // Unset for single-stage operations.
+  Operation.Status status = 2;
+
+  // Progress metric bundle, for example:
+  //   metrics: [{name: "nodes done",     int_value: 15},
+  //             {name: "nodes total",    int_value: 32}]
+  // or
+  //   metrics: [{name: "progress",       double_value: 0.56},
+  //             {name: "progress scale", double_value: 1.0}]
+  repeated Metric metrics = 3;
+
+  // Substages of an operation or a stage.
+  repeated OperationProgress stages = 4;
+}
+
+// CreateClusterRequest creates a cluster.
+message CreateClusterRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/v1beta1/projects.zones.clusters)
+  Cluster cluster = 3;
+
+  // The parent (project and location) where the cluster will be created.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, cluster) of the cluster to retrieve.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // A description of the update.
+  ClusterUpdate update = 4;
+
+  // The name (project, location, cluster) of the cluster to update.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // The Kubernetes version to change the nodes to (typically an
+  // upgrade).
+  //
+  // Users may specify either explicit versions offered by Kubernetes Engine or
+  // version aliases, which have the following behavior:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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;
+
+  // The desired image type for the node pool.
+  string image_type = 6;
+
+  // The name (project, location, cluster, node pool) of the node pool to
+  // update. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // Autoscaling configuration for the node pool.
+  NodePoolAutoscaling autoscaling = 5;
+
+  // The name (project, location, cluster, node pool) of the node pool to set
+  // autoscaler settings. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/compute/docs/zones#available) in which the cluster
+  // resides.
+  // This field has been deprecated and replaced by the name field.
+  string zone = 2;
+
+  // 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.
+  // Currently available options:
+  //
+  // * "logging.googleapis.com" - the Google Cloud Logging service
+  // * "none" - no metrics will be exported from the cluster
+  string logging_service = 4;
+
+  // The name (project, location, cluster) of the cluster to set logging.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 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;
+
+  // The name (project, location, cluster) of the cluster to set monitoring.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 desired configurations for the various addons available to run in the
+  // cluster.
+  AddonsConfig addons_config = 4;
+
+  // The name (project, location, cluster) of the cluster to set addons.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 desired list of Google Compute Engine
+  // [zones](/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;
+
+  // The name (project, location, cluster) of the cluster to set locations.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 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:
+  //
+  // - "latest": picks the highest valid Kubernetes version
+  // - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+  // - "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;
+
+  // The name (project, location, cluster) of the cluster to update.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 7;
+}
+
+// SetMasterAuthRequest updates the admin password of a cluster.
+message SetMasterAuthRequest {
+  // Operation type: what type update to perform.
+  enum Action {
+    // Operation is unknown and will error out.
+    UNKNOWN = 0;
+
+    // Set the password to a user generated value.
+    SET_PASSWORD = 1;
+
+    // Generate a new password and set it to that.
+    GENERATE_PASSWORD = 2;
+
+    // Set the username.  If an empty username is provided, basic authentication
+    // is disabled for the cluster.  If a non-empty username is provided, basic
+    // authentication is enabled, with either a provided password or a generated
+    // one.
+    SET_USERNAME = 3;
+  }
+
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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 exact form of action to be taken on the master auth.
+  Action action = 4;
+
+  // A description of the update.
+  MasterAuth update = 5;
+
+  // The name (project, location, cluster) of the cluster to set auth.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, cluster) of the cluster to delete.
+  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  string name = 4;
+}
+
+// ListClustersRequest lists clusters.
+message ListClustersRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/*'.
+  // Location "-" matches all zones and all regions.
+  string parent = 4;
+}
+
+// ListClustersResponse is the result of ListClustersRequest.
+message ListClustersResponse {
+  // A list of clusters in the project in the specified zone, or
+  // across all ones.
+  repeated Cluster clusters = 1;
+
+  // If any zones are listed here, the list of clusters returned
+  // may be missing those zones.
+  repeated string missing_zones = 2;
+}
+
+// GetOperationRequest gets a single operation.
+message GetOperationRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, operation id) of the operation to get.
+  // Specified in the format 'projects/*/locations/*/operations/*'.
+  string name = 5;
+}
+
+// ListOperationsRequest lists operations.
+message ListOperationsRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/*'.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // The name (project, location, operation id) of the operation to cancel.
+  // Specified in the format 'projects/*/locations/*/operations/*'.
+  string name = 4;
+}
+
+// ListOperationsResponse is the result of ListOperationsRequest.
+message ListOperationsResponse {
+  // A list of operations in the project in the specified zone.
+  repeated Operation operations = 1;
+
+  // If any zones are listed here, the list of operations returned
+  // may be missing the operations from those zones.
+  repeated string missing_zones = 2;
+}
+
+// Gets the current Kubernetes Engine service configuration.
+message GetServerConfigRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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/*'.
+  string name = 4;
+}
+
+// Kubernetes Engine service configuration.
+message ServerConfig {
+  // Version of Kubernetes the service deploys by default.
+  string default_cluster_version = 1;
+
+  // List of valid node upgrade target versions.
+  repeated string valid_node_versions = 3;
+
+  // Default image type.
+  string default_image_type = 4;
+
+  // List of valid image types.
+  repeated string valid_image_types = 5;
+
+  // List of valid master versions.
+  repeated string valid_master_versions = 6;
+}
+
+// CreateNodePoolRequest creates a node pool for a cluster.
+message CreateNodePoolRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // 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;
+
+  // The parent (project, location, cluster id) where the node pool will be
+  // created. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  string cluster_id = 3 [deprecated = true];
+
+  // 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];
+
+  // The name (project, location, cluster, node pool id) of the node pool to
+  // delete. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the parent field.
+  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/*'.
+  string parent = 5;
+}
+
+// GetNodePoolRequest retrieves a node pool for a cluster.
+message GetNodePoolRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  string cluster_id = 3 [deprecated = true];
+
+  // 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];
+
+  // The name (project, location, cluster, node pool id) of the node pool to
+  // get. Specified in the format
+  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  string name = 6;
+}
+
+// NodePool contains the name and configuration for a cluster's node pool.
+// Node pools are a set of nodes (i.e. VM's), with a common configuration and
+// specification, under the control of the cluster master. They may have a set
+// of Kubernetes labels applied to them, which may be used to reference them
+// during pod scheduling. They may also be resized up or down, to accommodate
+// the workload.
+message NodePool {
+  // The current status of the node pool instance.
+  enum Status {
+    // Not set.
+    STATUS_UNSPECIFIED = 0;
+
+    // The PROVISIONING state indicates the node pool is being created.
+    PROVISIONING = 1;
+
+    // The RUNNING state indicates the node pool has been created
+    // and is fully usable.
+    RUNNING = 2;
+
+    // The RUNNING_WITH_ERROR state indicates the node pool has been created
+    // and is partially usable. Some error state has occurred and some
+    // functionality may be impaired. Customer may need to reissue a request
+    // or trigger a new update.
+    RUNNING_WITH_ERROR = 3;
+
+    // The RECONCILING state indicates that some work is actively being done on
+    // the node pool, such as upgrading node software. Details can
+    // be found in the `statusMessage` field.
+    RECONCILING = 4;
+
+    // The STOPPING state indicates the node pool is being deleted.
+    STOPPING = 5;
+
+    // The ERROR state indicates the node pool may be unusable. Details
+    // can be found in the `statusMessage` field.
+    ERROR = 6;
+  }
+
+  // The name of the node pool.
+  string name = 1;
+
+  // The node configuration of the pool.
+  NodeConfig config = 2;
+
+  // The initial node count for the pool. You must ensure that your
+  // Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+  // is sufficient for this number of instances. You must also have available
+  // firewall and routes quota.
+  int32 initial_node_count = 3;
+
+  // [Output only] Server-defined URL for the resource.
+  string self_link = 100;
+
+  // The version of the Kubernetes of this node.
+  string version = 101;
+
+  // [Output only] The resource URLs of the [managed instance
+  // groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+  // associated with this node pool.
+  repeated string instance_group_urls = 102;
+
+  // [Output only] The status of the nodes in this pool instance.
+  Status status = 103;
+
+  // [Output only] Additional information about the current status of this
+  // node pool instance, if available.
+  string status_message = 104;
+
+  // Autoscaler configuration for this NodePool. Autoscaler is enabled
+  // only if a valid configuration is present.
+  NodePoolAutoscaling autoscaling = 4;
+
+  // 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;
+}
+
+// NodeManagement defines the set of node management services turned on for the
+// node pool.
+message NodeManagement {
+  // Whether the nodes will be automatically upgraded.
+  bool auto_upgrade = 1;
+
+  // Whether the nodes will be automatically repaired.
+  bool auto_repair = 2;
+
+  // Specifies the Auto Upgrade knobs for the node pool.
+  AutoUpgradeOptions upgrade_options = 10;
+}
+
+// AutoUpgradeOptions defines the set of options for the user to control how
+// the Auto Upgrades will proceed.
+message AutoUpgradeOptions {
+  // [Output only] This field is set when upgrades are about to commence
+  // with the approximate start time for the upgrades, in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  string auto_upgrade_start_time = 1;
+
+  // [Output only] This field is set when upgrades are about to commence
+  // with the description of the upgrade.
+  string description = 2;
+}
+
+// MaintenancePolicy defines the maintenance policy to be used for the cluster.
+message MaintenancePolicy {
+  // Specifies the maintenance window in which maintenance may be performed.
+  MaintenanceWindow window = 1;
+}
+
+// MaintenanceWindow defines the maintenance window to be used for the cluster.
+message MaintenanceWindow {
+  // Unimplemented, reserved for future use.
+  // HourlyMaintenanceWindow hourly_maintenance_window = 1;
+  oneof policy {
+    // DailyMaintenanceWindow specifies a daily maintenance operation window.
+    DailyMaintenanceWindow daily_maintenance_window = 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.
+  string start_time = 2;
+
+  // [Output only] Duration of the time window, automatically chosen to be
+  // smallest possible in the given scenario.
+  string duration = 3;
+}
+
+// SetNodePoolManagementRequest sets the node management properties of a node
+// pool.
+message SetNodePoolManagementRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // NodeManagement configuration for the node pool.
+  NodeManagement management = 5;
+
+  // The name (project, location, cluster, node pool id) of the node pool to set
+  // management properties. Specified in the format
+  // '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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // The desired node count for the pool.
+  int32 node_count = 5;
+
+  // The name (project, location, cluster, node pool id) of the node pool to set
+  // size.
+  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  string name = 7;
+}
+
+// RollbackNodePoolUpgradeRequest rollbacks the previously Aborted or Failed
+// 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // 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];
+
+  // The name (project, location, cluster, node pool id) of the node poll to
+  // rollback upgrade.
+  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  string name = 6;
+}
+
+// ListNodePoolsResponse is the result of ListNodePoolsRequest.
+message ListNodePoolsResponse {
+  // A list of node pools for a cluster.
+  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;
+}
+
+// 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 {
+  // Is autoscaling enabled for this node pool.
+  bool enabled = 1;
+
+  // Minimum number of nodes in the NodePool. Must be >= 1 and <=
+  // max_node_count.
+  int32 min_node_count = 2;
+
+  // 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
+// 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // 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<string, string> resource_labels = 4;
+
+  // 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 <code>get()</code> request to the
+  // resource to get the latest fingerprint.
+  string label_fingerprint = 5;
+
+  // The name (project, location, cluster id) of the cluster to set labels.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // 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];
+
+  // Whether ABAC authorization will be enabled in the cluster.
+  bool enabled = 4;
+
+  // The name (project, location, cluster id) of the cluster to set legacy abac.
+  // 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  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/*'.
+  string name = 6;
+
+  // Whether to rotate credentials during IP rotation.
+  bool rotate_credentials = 7;
+}
+
+// CompleteIPRotationRequest moves the cluster master back into single-IP mode.
+message CompleteIPRotationRequest {
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // This field has been deprecated and replaced by the name field.
+  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/*'.
+  string name = 7;
+}
+
+// AcceleratorConfig represents a Hardware Accelerator request.
+message AcceleratorConfig {
+  // The number of the accelerator cards exposed to an instance.
+  int64 accelerator_count = 1;
+
+  // The accelerator type resource name. List of supported accelerators
+  // [here](/compute/docs/gpus/#Introduction)
+  string accelerator_type = 2;
+}
+
+// WorkloadMetadataConfig defines the metadata configuration to expose to
+// workloads on the node pool.
+message WorkloadMetadataConfig {
+  // NodeMetadata is the configuration for if and how to expose the node
+  // metadata to the workload running on the node.
+  enum NodeMetadata {
+    // Not set.
+    UNSPECIFIED = 0;
+
+    // Prevent workloads not in hostNetwork from accessing certain VM metadata,
+    // specifically kube-env, which contains Kubelet credentials, and the
+    // instance identity token.
+    //
+    // Metadata concealment is a temporary security solution available while the
+    // bootstrapping process for cluster nodes is being redesigned with
+    // significant security improvements.  This feature is scheduled to be
+    // deprecated in the future and later removed.
+    SECURE = 1;
+
+    // Expose all VM metadata to pods.
+    EXPOSE = 2;
+  }
+
+  // NodeMetadata is the configuration for how to expose the node metadata to
+  // the workload 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
+  // 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];
+
+  // Deprecated. The name of the Google Compute Engine
+  // [zone](/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];
+
+  // Deprecated. The name of the cluster.
+  // 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;
+
+  // The name (project, location, cluster id) of the cluster to set networking
+  // 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
+  // number](https://support.google.com/cloud/answer/6158840).
+  string project_id = 1;
+
+  // The name of the Google Compute Engine
+  // [zone](/compute/docs/zones#available) in which the cluster
+  // resides.
+  string zone = 2;
+
+  // The name of the cluster to update.
+  string cluster_id = 3;
+
+  // The maintenance policy to be set for the cluster. An empty field
+  // clears the existing maintenance policy.
+  MaintenancePolicy maintenance_policy = 4;
+
+  // The name (project, location, cluster id) of the cluster to set maintenance
+  // policy.
+  // 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;
+}
+
+// ListLocationsResponse returns the list of all GKE locations and their
+// recommendation state.
+message ListLocationsResponse {
+  // A full list of GKE locations.
+  repeated Location locations = 1;
+
+  // Only return ListLocationsResponse that occur after the page_token. This
+  // value should be populated from the ListLocationsResponse.next_page_token if
+  // that response token was set (which happens when listing more Locations than
+  // fit in a single ListLocationsResponse).
+  string next_page_token = 2;
+}
+
+// Location returns the location name, and if the location is recommended
+// for GKE cluster scheduling.
+message Location {
+  // LocationType is the type of GKE location, regional or zonal.
+  enum LocationType {
+    // LOCATION_TYPE_UNSPECIFIED means the location type was not determined.
+    LOCATION_TYPE_UNSPECIFIED = 0;
+
+    // A GKE Location where Zonal clusters can be created.
+    ZONE = 1;
+
+    // A GKE Location where Regional clusters can be created.
+    REGION = 2;
+  }
+
+  // Contains the type of location this Location is for.
+  // Regional or Zonal.
+  LocationType type = 1;
+
+  // Contains the name of the resource requested.
+  // Specified in the format 'projects/*/locations/*'.
+  string name = 2;
+
+  // Whether the location is recomended for GKE cluster scheduling.
+  bool recommended = 3;
+}
+
+// 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.
+    // More codes TBA
+    SET_BY_OPERATOR = 4;
+  }
+
+  // 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.v1beta1.NetworkConfig.network](/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.
+  // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet
+  string subnetwork = 2;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// Constraints applied to pods.
+message MaxPodsConstraint {
+  // Constraint enforced on the max num of pods per node.
+  int64 max_pods_per_node = 1;
+}
+
+// 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;
+  }
+
+  // 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;
+}
diff --git a/container/google/cloud/container_v1beta1/proto/cluster_service_pb2.py b/container/google/cloud/container_v1beta1/proto/cluster_service_pb2.py
new file mode 100644
index 000000000000..d680c84594f8
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/proto/cluster_service_pb2.py
@@ -0,0 +1,12672 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/container_v1beta1/proto/cluster_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/container_v1beta1/proto/cluster_service.proto",
+    package="google.container.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.container.v1beta1B\023ClusterServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/container/v1beta1;container\252\002\036Google.Cloud.Container.V1Beta1\312\002\036Google\\Cloud\\Container\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/container_v1beta1/proto/cluster_service.proto\x12\x18google.container.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto"\x98\x05\n\nNodeConfig\x12\x14\n\x0cmachine_type\x18\x01 \x01(\t\x12\x14\n\x0c\x64isk_size_gb\x18\x02 \x01(\x05\x12\x14\n\x0coauth_scopes\x18\x03 \x03(\t\x12\x17\n\x0fservice_account\x18\t \x01(\t\x12\x44\n\x08metadata\x18\x04 \x03(\x0b\x32\x32.google.container.v1beta1.NodeConfig.MetadataEntry\x12\x12\n\nimage_type\x18\x05 \x01(\t\x12@\n\x06labels\x18\x06 \x03(\x0b\x32\x30.google.container.v1beta1.NodeConfig.LabelsEntry\x12\x17\n\x0flocal_ssd_count\x18\x07 \x01(\x05\x12\x0c\n\x04tags\x18\x08 \x03(\t\x12\x13\n\x0bpreemptible\x18\n \x01(\x08\x12\x41\n\x0c\x61\x63\x63\x65lerators\x18\x0b \x03(\x0b\x32+.google.container.v1beta1.AcceleratorConfig\x12\x11\n\tdisk_type\x18\x0c \x01(\t\x12\x18\n\x10min_cpu_platform\x18\r \x01(\t\x12R\n\x18workload_metadata_config\x18\x0e \x01(\x0b\x32\x30.google.container.v1beta1.WorkloadMetadataConfig\x12\x33\n\x06taints\x18\x0f \x03(\x0b\x32#.google.container.v1beta1.NodeTaint\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xbe\x01\n\tNodeTaint\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12:\n\x06\x65\x66\x66\x65\x63t\x18\x03 \x01(\x0e\x32*.google.container.v1beta1.NodeTaint.Effect"Y\n\x06\x45\x66\x66\x65\x63t\x12\x16\n\x12\x45\x46\x46\x45\x43T_UNSPECIFIED\x10\x00\x12\x0f\n\x0bNO_SCHEDULE\x10\x01\x12\x16\n\x12PREFER_NO_SCHEDULE\x10\x02\x12\x0e\n\nNO_EXECUTE\x10\x03"\xd6\x01\n\nMasterAuth\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x12T\n\x19\x63lient_certificate_config\x18\x03 \x01(\x0b\x32\x31.google.container.v1beta1.ClientCertificateConfig\x12\x1e\n\x16\x63luster_ca_certificate\x18\x64 \x01(\t\x12\x1a\n\x12\x63lient_certificate\x18\x65 \x01(\t\x12\x12\n\nclient_key\x18\x66 \x01(\t";\n\x17\x43lientCertificateConfig\x12 \n\x18issue_client_certificate\x18\x01 \x01(\x08"\xcc\x03\n\x0c\x41\x64\x64onsConfig\x12H\n\x13http_load_balancing\x18\x01 \x01(\x0b\x32+.google.container.v1beta1.HttpLoadBalancing\x12V\n\x1ahorizontal_pod_autoscaling\x18\x02 \x01(\x0b\x32\x32.google.container.v1beta1.HorizontalPodAutoscaling\x12K\n\x14kubernetes_dashboard\x18\x03 \x01(\x0b\x32-.google.container.v1beta1.KubernetesDashboard\x12L\n\x15network_policy_config\x18\x04 \x01(\x0b\x32-.google.container.v1beta1.NetworkPolicyConfig\x12;\n\x0cistio_config\x18\x05 \x01(\x0b\x32%.google.container.v1beta1.IstioConfig\x12\x42\n\x10\x63loud_run_config\x18\x07 \x01(\x0b\x32(.google.container.v1beta1.CloudRunConfig"%\n\x11HttpLoadBalancing\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08",\n\x18HorizontalPodAutoscaling\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\'\n\x13KubernetesDashboard\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\'\n\x13NetworkPolicyConfig\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\xa8\x01\n\x14PrivateClusterConfig\x12\x1c\n\x14\x65nable_private_nodes\x18\x01 \x01(\x08\x12\x1f\n\x17\x65nable_private_endpoint\x18\x02 \x01(\x08\x12\x1e\n\x16master_ipv4_cidr_block\x18\x03 \x01(\t\x12\x18\n\x10private_endpoint\x18\x04 \x01(\t\x12\x17\n\x0fpublic_endpoint\x18\x05 \x01(\t"\x97\x01\n\x0bIstioConfig\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08\x12\x41\n\x04\x61uth\x18\x02 \x01(\x0e\x32\x33.google.container.v1beta1.IstioConfig.IstioAuthMode"3\n\rIstioAuthMode\x12\r\n\tAUTH_NONE\x10\x00\x12\x13\n\x0f\x41UTH_MUTUAL_TLS\x10\x01""\n\x0e\x43loudRunConfig\x12\x10\n\x08\x64isabled\x18\x01 \x01(\x08"\xc1\x01\n\x1eMasterAuthorizedNetworksConfig\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x12W\n\x0b\x63idr_blocks\x18\x02 \x03(\x0b\x32\x42.google.container.v1beta1.MasterAuthorizedNetworksConfig.CidrBlock\x1a\x35\n\tCidrBlock\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x12\n\ncidr_block\x18\x02 \x01(\t"\x1d\n\nLegacyAbac\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08"\x96\x01\n\rNetworkPolicy\x12\x42\n\x08provider\x18\x01 \x01(\x0e\x32\x30.google.container.v1beta1.NetworkPolicy.Provider\x12\x0f\n\x07\x65nabled\x18\x02 \x01(\x08"0\n\x08Provider\x12\x18\n\x14PROVIDER_UNSPECIFIED\x10\x00\x12\n\n\x06\x43\x41LICO\x10\x01"\xa3\x03\n\x12IPAllocationPolicy\x12\x16\n\x0euse_ip_aliases\x18\x01 \x01(\x08\x12\x19\n\x11\x63reate_subnetwork\x18\x02 \x01(\x08\x12\x17\n\x0fsubnetwork_name\x18\x03 \x01(\t\x12\x1d\n\x11\x63luster_ipv4_cidr\x18\x04 \x01(\tB\x02\x18\x01\x12\x1a\n\x0enode_ipv4_cidr\x18\x05 \x01(\tB\x02\x18\x01\x12\x1e\n\x12services_ipv4_cidr\x18\x06 \x01(\tB\x02\x18\x01\x12$\n\x1c\x63luster_secondary_range_name\x18\x07 \x01(\t\x12%\n\x1dservices_secondary_range_name\x18\x08 \x01(\t\x12\x1f\n\x17\x63luster_ipv4_cidr_block\x18\t \x01(\t\x12\x1c\n\x14node_ipv4_cidr_block\x18\n \x01(\t\x12 \n\x18services_ipv4_cidr_block\x18\x0b \x01(\t\x12\x1b\n\x13\x61llow_route_overlap\x18\x0c \x01(\x08\x12\x1b\n\x13tpu_ipv4_cidr_block\x18\r \x01(\t"&\n\x13\x42inaryAuthorization\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08"*\n\x17PodSecurityPolicyConfig\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08"\xbb\x12\n\x07\x43luster\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x1a\n\x12initial_node_count\x18\x03 \x01(\x05\x12\x39\n\x0bnode_config\x18\x04 \x01(\x0b\x32$.google.container.v1beta1.NodeConfig\x12\x39\n\x0bmaster_auth\x18\x05 \x01(\x0b\x32$.google.container.v1beta1.MasterAuth\x12\x17\n\x0flogging_service\x18\x06 \x01(\t\x12\x1a\n\x12monitoring_service\x18\x07 \x01(\t\x12\x0f\n\x07network\x18\x08 \x01(\t\x12\x19\n\x11\x63luster_ipv4_cidr\x18\t \x01(\t\x12=\n\raddons_config\x18\n \x01(\x0b\x32&.google.container.v1beta1.AddonsConfig\x12\x12\n\nsubnetwork\x18\x0b \x01(\t\x12\x36\n\nnode_pools\x18\x0c \x03(\x0b\x32".google.container.v1beta1.NodePool\x12\x11\n\tlocations\x18\r \x03(\t\x12\x1f\n\x17\x65nable_kubernetes_alpha\x18\x0e \x01(\x08\x12N\n\x0fresource_labels\x18\x0f \x03(\x0b\x32\x35.google.container.v1beta1.Cluster.ResourceLabelsEntry\x12\x19\n\x11label_fingerprint\x18\x10 \x01(\t\x12\x39\n\x0blegacy_abac\x18\x12 \x01(\x0b\x32$.google.container.v1beta1.LegacyAbac\x12?\n\x0enetwork_policy\x18\x13 \x01(\x0b\x32\'.google.container.v1beta1.NetworkPolicy\x12J\n\x14ip_allocation_policy\x18\x14 \x01(\x0b\x32,.google.container.v1beta1.IPAllocationPolicy\x12\x63\n!master_authorized_networks_config\x18\x16 \x01(\x0b\x32\x38.google.container.v1beta1.MasterAuthorizedNetworksConfig\x12G\n\x12maintenance_policy\x18\x17 \x01(\x0b\x32+.google.container.v1beta1.MaintenancePolicy\x12K\n\x14\x62inary_authorization\x18\x18 \x01(\x0b\x32-.google.container.v1beta1.BinaryAuthorization\x12U\n\x1apod_security_policy_config\x18\x19 \x01(\x0b\x32\x31.google.container.v1beta1.PodSecurityPolicyConfig\x12\x41\n\x0b\x61utoscaling\x18\x1a \x01(\x0b\x32,.google.container.v1beta1.ClusterAutoscaling\x12?\n\x0enetwork_config\x18\x1b \x01(\x0b\x32\'.google.container.v1beta1.NetworkConfig\x12\x1b\n\x0fprivate_cluster\x18\x1c \x01(\x08\x42\x02\x18\x01\x12"\n\x16master_ipv4_cidr_block\x18\x1d \x01(\tB\x02\x18\x01\x12P\n\x1b\x64\x65\x66\x61ult_max_pods_constraint\x18\x1e \x01(\x0b\x32+.google.container.v1beta1.MaxPodsConstraint\x12Y\n\x1cresource_usage_export_config\x18! \x01(\x0b\x32\x33.google.container.v1beta1.ResourceUsageExportConfig\x12N\n\x16private_cluster_config\x18% \x01(\x0b\x32..google.container.v1beta1.PrivateClusterConfig\x12R\n\x18vertical_pod_autoscaling\x18\' \x01(\x0b\x32\x30.google.container.v1beta1.VerticalPodAutoscaling\x12\x11\n\tself_link\x18\x64 \x01(\t\x12\x10\n\x04zone\x18\x65 \x01(\tB\x02\x18\x01\x12\x10\n\x08\x65ndpoint\x18\x66 \x01(\t\x12\x1f\n\x17initial_cluster_version\x18g \x01(\t\x12\x1e\n\x16\x63urrent_master_version\x18h \x01(\t\x12 \n\x14\x63urrent_node_version\x18i \x01(\tB\x02\x18\x01\x12\x13\n\x0b\x63reate_time\x18j \x01(\t\x12\x38\n\x06status\x18k \x01(\x0e\x32(.google.container.v1beta1.Cluster.Status\x12\x16\n\x0estatus_message\x18l \x01(\t\x12\x1b\n\x13node_ipv4_cidr_size\x18m \x01(\x05\x12\x1a\n\x12services_ipv4_cidr\x18n \x01(\t\x12\x1f\n\x13instance_group_urls\x18o \x03(\tB\x02\x18\x01\x12\x1e\n\x12\x63urrent_node_count\x18p \x01(\x05\x42\x02\x18\x01\x12\x13\n\x0b\x65xpire_time\x18q \x01(\t\x12\x10\n\x08location\x18r \x01(\t\x12\x12\n\nenable_tpu\x18s \x01(\x08\x12\x1b\n\x13tpu_ipv4_cidr_block\x18t \x01(\t\x12=\n\nconditions\x18v \x03(\x0b\x32).google.container.v1beta1.StatusCondition\x1a\x35\n\x13ResourceLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"w\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x10\n\x0cPROVISIONING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x0f\n\x0bRECONCILING\x10\x03\x12\x0c\n\x08STOPPING\x10\x04\x12\t\n\x05\x45RROR\x10\x05\x12\x0c\n\x08\x44\x45GRADED\x10\x06"\xb7\x07\n\rClusterUpdate\x12\x1c\n\x14\x64\x65sired_node_version\x18\x04 \x01(\t\x12"\n\x1a\x64\x65sired_monitoring_service\x18\x05 \x01(\t\x12\x45\n\x15\x64\x65sired_addons_config\x18\x06 \x01(\x0b\x32&.google.container.v1beta1.AddonsConfig\x12\x1c\n\x14\x64\x65sired_node_pool_id\x18\x07 \x01(\t\x12\x1a\n\x12\x64\x65sired_image_type\x18\x08 \x01(\t\x12T\n\x1d\x64\x65sired_node_pool_autoscaling\x18\t \x01(\x0b\x32-.google.container.v1beta1.NodePoolAutoscaling\x12\x19\n\x11\x64\x65sired_locations\x18\n \x03(\t\x12k\n)desired_master_authorized_networks_config\x18\x0c \x01(\x0b\x32\x38.google.container.v1beta1.MasterAuthorizedNetworksConfig\x12]\n"desired_pod_security_policy_config\x18\x0e \x01(\x0b\x32\x31.google.container.v1beta1.PodSecurityPolicyConfig\x12Q\n\x1b\x64\x65sired_cluster_autoscaling\x18\x0f \x01(\x0b\x32,.google.container.v1beta1.ClusterAutoscaling\x12S\n\x1c\x64\x65sired_binary_authorization\x18\x10 \x01(\x0b\x32-.google.container.v1beta1.BinaryAuthorization\x12\x1f\n\x17\x64\x65sired_logging_service\x18\x13 \x01(\t\x12\x61\n$desired_resource_usage_export_config\x18\x15 \x01(\x0b\x32\x33.google.container.v1beta1.ResourceUsageExportConfig\x12Z\n desired_vertical_pod_autoscaling\x18\x16 \x01(\x0b\x32\x30.google.container.v1beta1.VerticalPodAutoscaling\x12\x1e\n\x16\x64\x65sired_master_version\x18\x64 \x01(\t"\xd3\x07\n\tOperation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12@\n\x0eoperation_type\x18\x03 \x01(\x0e\x32(.google.container.v1beta1.Operation.Type\x12:\n\x06status\x18\x04 \x01(\x0e\x32*.google.container.v1beta1.Operation.Status\x12\x0e\n\x06\x64\x65tail\x18\x08 \x01(\t\x12\x16\n\x0estatus_message\x18\x05 \x01(\t\x12\x11\n\tself_link\x18\x06 \x01(\t\x12\x13\n\x0btarget_link\x18\x07 \x01(\t\x12\x10\n\x08location\x18\t \x01(\t\x12\x12\n\nstart_time\x18\n \x01(\t\x12\x10\n\x08\x65nd_time\x18\x0b \x01(\t\x12=\n\x08progress\x18\x0c \x01(\x0b\x32+.google.container.v1beta1.OperationProgress\x12\x45\n\x12\x63luster_conditions\x18\r \x03(\x0b\x32).google.container.v1beta1.StatusCondition\x12\x46\n\x13nodepool_conditions\x18\x0e \x03(\x0b\x32).google.container.v1beta1.StatusCondition"R\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\x0c\n\x08\x41\x42ORTING\x10\x04"\xfd\x02\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43REATE_CLUSTER\x10\x01\x12\x12\n\x0e\x44\x45LETE_CLUSTER\x10\x02\x12\x12\n\x0eUPGRADE_MASTER\x10\x03\x12\x11\n\rUPGRADE_NODES\x10\x04\x12\x12\n\x0eREPAIR_CLUSTER\x10\x05\x12\x12\n\x0eUPDATE_CLUSTER\x10\x06\x12\x14\n\x10\x43REATE_NODE_POOL\x10\x07\x12\x14\n\x10\x44\x45LETE_NODE_POOL\x10\x08\x12\x1c\n\x18SET_NODE_POOL_MANAGEMENT\x10\t\x12\x15\n\x11\x41UTO_REPAIR_NODES\x10\n\x12\x16\n\x12\x41UTO_UPGRADE_NODES\x10\x0b\x12\x0e\n\nSET_LABELS\x10\x0c\x12\x13\n\x0fSET_MASTER_AUTH\x10\r\x12\x16\n\x12SET_NODE_POOL_SIZE\x10\x0e\x12\x16\n\x12SET_NETWORK_POLICY\x10\x0f\x12\x1a\n\x16SET_MAINTENANCE_POLICY\x10\x10"\xc5\x02\n\x11OperationProgress\x12\x0c\n\x04name\x18\x01 \x01(\t\x12:\n\x06status\x18\x02 \x01(\x0e\x32*.google.container.v1beta1.Operation.Status\x12\x43\n\x07metrics\x18\x03 \x03(\x0b\x32\x32.google.container.v1beta1.OperationProgress.Metric\x12;\n\x06stages\x18\x04 \x03(\x0b\x32+.google.container.v1beta1.OperationProgress\x1a\x64\n\x06Metric\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\tint_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x04 \x01(\tH\x00\x42\x07\n\x05value"\x84\x01\n\x14\x43reateClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x32\n\x07\x63luster\x18\x03 \x01(\x0b\x32!.google.container.v1beta1.Cluster\x12\x0e\n\x06parent\x18\x05 \x01(\t"c\n\x11GetClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x05 \x01(\t"\x9f\x01\n\x14UpdateClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x37\n\x06update\x18\x04 \x01(\x0b\x32\'.google.container.v1beta1.ClusterUpdate\x12\x0c\n\x04name\x18\x05 \x01(\t"\xab\x01\n\x15UpdateNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x14\n\x0cnode_version\x18\x05 \x01(\t\x12\x12\n\nimage_type\x18\x06 \x01(\t\x12\x0c\n\x04name\x18\x08 \x01(\t"\xcd\x01\n\x1dSetNodePoolAutoscalingRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x42\n\x0b\x61utoscaling\x18\x05 \x01(\x0b\x32-.google.container.v1beta1.NodePoolAutoscaling\x12\x0c\n\x04name\x18\x06 \x01(\t"\x7f\n\x18SetLoggingServiceRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x0c\n\x04zone\x18\x02 \x01(\t\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x17\n\x0flogging_service\x18\x04 \x01(\t\x12\x0c\n\x04name\x18\x05 \x01(\t"\x89\x01\n\x1bSetMonitoringServiceRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x1a\n\x12monitoring_service\x18\x04 \x01(\t\x12\x0c\n\x04name\x18\x06 \x01(\t"\xa7\x01\n\x16SetAddonsConfigRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12=\n\raddons_config\x18\x04 \x01(\x0b\x32&.google.container.v1beta1.AddonsConfig\x12\x0c\n\x04name\x18\x06 \x01(\t"x\n\x13SetLocationsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x11\n\tlocations\x18\x04 \x03(\t\x12\x0c\n\x04name\x18\x06 \x01(\t"}\n\x13UpdateMasterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x16\n\x0emaster_version\x18\x04 \x01(\t\x12\x0c\n\x04name\x18\x07 \x01(\t"\xb5\x02\n\x14SetMasterAuthRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x45\n\x06\x61\x63tion\x18\x04 \x01(\x0e\x32\x35.google.container.v1beta1.SetMasterAuthRequest.Action\x12\x34\n\x06update\x18\x05 \x01(\x0b\x32$.google.container.v1beta1.MasterAuth\x12\x0c\n\x04name\x18\x07 \x01(\t"P\n\x06\x41\x63tion\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x10\n\x0cSET_PASSWORD\x10\x01\x12\x15\n\x11GENERATE_PASSWORD\x10\x02\x12\x10\n\x0cSET_USERNAME\x10\x03"f\n\x14\x44\x65leteClusterRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x04 \x01(\t"O\n\x13ListClustersRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x0e\n\x06parent\x18\x04 \x01(\t"b\n\x14ListClustersResponse\x12\x33\n\x08\x63lusters\x18\x01 \x03(\x0b\x32!.google.container.v1beta1.Cluster\x12\x15\n\rmissing_zones\x18\x02 \x03(\t"g\n\x13GetOperationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x18\n\x0coperation_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x05 \x01(\t"Q\n\x15ListOperationsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x0e\n\x06parent\x18\x04 \x01(\t"j\n\x16\x43\x61ncelOperationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x18\n\x0coperation_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x04 \x01(\t"h\n\x16ListOperationsResponse\x12\x37\n\noperations\x18\x01 \x03(\x0b\x32#.google.container.v1beta1.Operation\x12\x15\n\rmissing_zones\x18\x02 \x03(\t"P\n\x16GetServerConfigRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x04 \x01(\t"\xa2\x01\n\x0cServerConfig\x12\x1f\n\x17\x64\x65\x66\x61ult_cluster_version\x18\x01 \x01(\t\x12\x1b\n\x13valid_node_versions\x18\x03 \x03(\t\x12\x1a\n\x12\x64\x65\x66\x61ult_image_type\x18\x04 \x01(\t\x12\x19\n\x11valid_image_types\x18\x05 \x03(\t\x12\x1d\n\x15valid_master_versions\x18\x06 \x03(\t"\xa0\x01\n\x15\x43reateNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x35\n\tnode_pool\x18\x04 \x01(\x0b\x32".google.container.v1beta1.NodePool\x12\x0e\n\x06parent\x18\x06 \x01(\t"\x81\x01\n\x15\x44\x65leteNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"h\n\x14ListNodePoolsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0e\n\x06parent\x18\x05 \x01(\t"~\n\x12GetNodePoolRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"\x8d\x05\n\x08NodePool\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x06\x63onfig\x18\x02 \x01(\x0b\x32$.google.container.v1beta1.NodeConfig\x12\x1a\n\x12initial_node_count\x18\x03 \x01(\x05\x12\x11\n\tself_link\x18\x64 \x01(\t\x12\x0f\n\x07version\x18\x65 \x01(\t\x12\x1b\n\x13instance_group_urls\x18\x66 \x03(\t\x12\x39\n\x06status\x18g \x01(\x0e\x32).google.container.v1beta1.NodePool.Status\x12\x16\n\x0estatus_message\x18h \x01(\t\x12\x42\n\x0b\x61utoscaling\x18\x04 \x01(\x0b\x32-.google.container.v1beta1.NodePoolAutoscaling\x12<\n\nmanagement\x18\x05 \x01(\x0b\x32(.google.container.v1beta1.NodeManagement\x12H\n\x13max_pods_constraint\x18\x06 \x01(\x0b\x32+.google.container.v1beta1.MaxPodsConstraint\x12=\n\nconditions\x18i \x03(\x0b\x32).google.container.v1beta1.StatusCondition"\x81\x01\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x10\n\x0cPROVISIONING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x16\n\x12RUNNING_WITH_ERROR\x10\x03\x12\x0f\n\x0bRECONCILING\x10\x04\x12\x0c\n\x08STOPPING\x10\x05\x12\t\n\x05\x45RROR\x10\x06"\x82\x01\n\x0eNodeManagement\x12\x14\n\x0c\x61uto_upgrade\x18\x01 \x01(\x08\x12\x13\n\x0b\x61uto_repair\x18\x02 \x01(\x08\x12\x45\n\x0fupgrade_options\x18\n \x01(\x0b\x32,.google.container.v1beta1.AutoUpgradeOptions"J\n\x12\x41utoUpgradeOptions\x12\x1f\n\x17\x61uto_upgrade_start_time\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t"P\n\x11MaintenancePolicy\x12;\n\x06window\x18\x01 \x01(\x0b\x32+.google.container.v1beta1.MaintenanceWindow"s\n\x11MaintenanceWindow\x12T\n\x18\x64\x61ily_maintenance_window\x18\x02 \x01(\x0b\x32\x30.google.container.v1beta1.DailyMaintenanceWindowH\x00\x42\x08\n\x06policy">\n\x16\x44\x61ilyMaintenanceWindow\x12\x12\n\nstart_time\x18\x02 \x01(\t\x12\x10\n\x08\x64uration\x18\x03 \x01(\t"\xc6\x01\n\x1cSetNodePoolManagementRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12<\n\nmanagement\x18\x05 \x01(\x0b\x32(.google.container.v1beta1.NodeManagement\x12\x0c\n\x04name\x18\x07 \x01(\t"\x96\x01\n\x16SetNodePoolSizeRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x12\n\nnode_count\x18\x05 \x01(\x05\x12\x0c\n\x04name\x18\x07 \x01(\t"\x8a\x01\n\x1eRollbackNodePoolUpgradeRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"O\n\x15ListNodePoolsResponse\x12\x36\n\nnode_pools\x18\x01 \x03(\x0b\x32".google.container.v1beta1.NodePool"|\n\x12\x43lusterAutoscaling\x12$\n\x1c\x65nable_node_autoprovisioning\x18\x01 \x01(\x08\x12@\n\x0fresource_limits\x18\x02 \x03(\x0b\x32\'.google.container.v1beta1.ResourceLimit"H\n\rResourceLimit\x12\x15\n\rresource_type\x18\x01 \x01(\t\x12\x0f\n\x07minimum\x18\x02 \x01(\x03\x12\x0f\n\x07maximum\x18\x03 \x01(\x03"o\n\x13NodePoolAutoscaling\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x12\x16\n\x0emin_node_count\x18\x02 \x01(\x05\x12\x16\n\x0emax_node_count\x18\x03 \x01(\x05\x12\x17\n\x0f\x61utoprovisioned\x18\x04 \x01(\x08"\x8d\x02\n\x10SetLabelsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12W\n\x0fresource_labels\x18\x04 \x03(\x0b\x32>.google.container.v1beta1.SetLabelsRequest.ResourceLabelsEntry\x12\x19\n\x11label_fingerprint\x18\x05 \x01(\t\x12\x0c\n\x04name\x18\x07 \x01(\t\x1a\x35\n\x13ResourceLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"w\n\x14SetLegacyAbacRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0f\n\x07\x65nabled\x18\x04 \x01(\x08\x12\x0c\n\x04name\x18\x06 \x01(\t"\x84\x01\n\x16StartIPRotationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x1a\n\x12rotate_credentials\x18\x07 \x01(\x08"k\n\x19\x43ompleteIPRotationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x07 \x01(\t"H\n\x11\x41\x63\x63\x65leratorConfig\x12\x19\n\x11\x61\x63\x63\x65lerator_count\x18\x01 \x01(\x03\x12\x18\n\x10\x61\x63\x63\x65lerator_type\x18\x02 \x01(\t"\xa7\x01\n\x16WorkloadMetadataConfig\x12T\n\rnode_metadata\x18\x01 \x01(\x0e\x32=.google.container.v1beta1.WorkloadMetadataConfig.NodeMetadata"7\n\x0cNodeMetadata\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\n\n\x06SECURE\x10\x01\x12\n\n\x06\x45XPOSE\x10\x02"\xaa\x01\n\x17SetNetworkPolicyRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12?\n\x0enetwork_policy\x18\x04 \x01(\x0b\x32\'.google.container.v1beta1.NetworkPolicy\x12\x0c\n\x04name\x18\x06 \x01(\t"\xaa\x01\n\x1bSetMaintenancePolicyRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0c\n\x04zone\x18\x02 \x01(\t\x12\x12\n\ncluster_id\x18\x03 \x01(\t\x12G\n\x12maintenance_policy\x18\x04 \x01(\x0b\x32+.google.container.v1beta1.MaintenancePolicy\x12\x0c\n\x04name\x18\x05 \x01(\t"&\n\x14ListLocationsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t"g\n\x15ListLocationsResponse\x12\x35\n\tlocations\x18\x01 \x03(\x0b\x32".google.container.v1beta1.Location\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xb1\x01\n\x08Location\x12=\n\x04type\x18\x01 \x01(\x0e\x32/.google.container.v1beta1.Location.LocationType\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x13\n\x0brecommended\x18\x03 \x01(\x08"C\n\x0cLocationType\x12\x1d\n\x19LOCATION_TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04ZONE\x10\x01\x12\n\n\x06REGION\x10\x02"\xd5\x01\n\x0fStatusCondition\x12<\n\x04\x63ode\x18\x01 \x01(\x0e\x32..google.container.v1beta1.StatusCondition.Code\x12\x0f\n\x07message\x18\x02 \x01(\t"s\n\x04\x43ode\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x10\n\x0cGCE_STOCKOUT\x10\x01\x12\x1f\n\x1bGKE_SERVICE_ACCOUNT_DELETED\x10\x02\x12\x16\n\x12GCE_QUOTA_EXCEEDED\x10\x03\x12\x13\n\x0fSET_BY_OPERATOR\x10\x04"4\n\rNetworkConfig\x12\x0f\n\x07network\x18\x01 \x01(\t\x12\x12\n\nsubnetwork\x18\x02 \x01(\t"e\n\x1cListUsableSubnetworksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"y\n\x1dListUsableSubnetworksResponse\x12?\n\x0bsubnetworks\x18\x01 \x03(\x0b\x32*.google.container.v1beta1.UsableSubnetwork\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x85\x02\n\x1eUsableSubnetworkSecondaryRange\x12\x12\n\nrange_name\x18\x01 \x01(\t\x12\x15\n\rip_cidr_range\x18\x02 \x01(\t\x12O\n\x06status\x18\x03 \x01(\x0e\x32?.google.container.v1beta1.UsableSubnetworkSecondaryRange.Status"g\n\x06Status\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06UNUSED\x10\x01\x12\x12\n\x0eIN_USE_SERVICE\x10\x02\x12\x18\n\x14IN_USE_SHAREABLE_POD\x10\x03\x12\x16\n\x12IN_USE_MANAGED_POD\x10\x04"\xbd\x01\n\x10UsableSubnetwork\x12\x12\n\nsubnetwork\x18\x01 \x01(\t\x12\x0f\n\x07network\x18\x02 \x01(\t\x12\x15\n\rip_cidr_range\x18\x03 \x01(\t\x12U\n\x13secondary_ip_ranges\x18\x04 \x03(\x0b\x32\x38.google.container.v1beta1.UsableSubnetworkSecondaryRange\x12\x16\n\x0estatus_message\x18\x05 \x01(\t")\n\x16VerticalPodAutoscaling\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08".\n\x11MaxPodsConstraint\x12\x19\n\x11max_pods_per_node\x18\x01 \x01(\x03"\xd5\x01\n\x19ResourceUsageExportConfig\x12\x65\n\x14\x62igquery_destination\x18\x01 \x01(\x0b\x32G.google.container.v1beta1.ResourceUsageExportConfig.BigQueryDestination\x12&\n\x1e\x65nable_network_egress_metering\x18\x02 \x01(\x08\x1a)\n\x13\x42igQueryDestination\x12\x12\n\ndataset_id\x18\x01 \x01(\t2\x91\x41\n\x0e\x43lusterManager\x12\xe0\x01\n\x0cListClusters\x12-.google.container.v1beta1.ListClustersRequest\x1a..google.container.v1beta1.ListClustersResponse"q\x82\xd3\xe4\x93\x02k\x12\x31/v1beta1/{parent=projects/*/locations/*}/clustersZ6\x12\x34/v1beta1/projects/{project_id}/zones/{zone}/clusters\x12\xdc\x01\n\nGetCluster\x12+.google.container.v1beta1.GetClusterRequest\x1a!.google.container.v1beta1.Cluster"~\x82\xd3\xe4\x93\x02x\x12\x31/v1beta1/{name=projects/*/locations/*/clusters/*}ZC\x12\x41/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}\x12\xdd\x01\n\rCreateCluster\x12..google.container.v1beta1.CreateClusterRequest\x1a#.google.container.v1beta1.Operation"w\x82\xd3\xe4\x93\x02q"1/v1beta1/{parent=projects/*/locations/*}/clusters:\x01*Z9"4/v1beta1/projects/{project_id}/zones/{zone}/clusters:\x01*\x12\xeb\x01\n\rUpdateCluster\x12..google.container.v1beta1.UpdateClusterRequest\x1a#.google.container.v1beta1.Operation"\x84\x01\x82\xd3\xe4\x93\x02~\x1a\x31/v1beta1/{name=projects/*/locations/*/clusters/*}:\x01*ZF\x1a\x41/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:\x01*\x12\x9a\x02\n\x0eUpdateNodePool\x12/.google.container.v1beta1.UpdateNodePoolRequest\x1a#.google.container.v1beta1.Operation"\xb1\x01\x82\xd3\xe4\x93\x02\xaa\x01\x1a=/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:\x01*Zf"a/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/update:\x01*\x12\xbe\x02\n\x16SetNodePoolAutoscaling\x12\x37.google.container.v1beta1.SetNodePoolAutoscalingRequest\x1a#.google.container.v1beta1.Operation"\xc5\x01\x82\xd3\xe4\x93\x02\xbe\x01"L/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling:\x01*Zk"f/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/autoscaling:\x01*\x12\x87\x02\n\x11SetLoggingService\x12\x32.google.container.v1beta1.SetLoggingServiceRequest\x1a#.google.container.v1beta1.Operation"\x98\x01\x82\xd3\xe4\x93\x02\x91\x01"</v1beta1/{name=projects/*/locations/*/clusters/*}:setLogging:\x01*ZN"I/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/logging:\x01*\x12\x93\x02\n\x14SetMonitoringService\x12\x35.google.container.v1beta1.SetMonitoringServiceRequest\x1a#.google.container.v1beta1.Operation"\x9e\x01\x82\xd3\xe4\x93\x02\x97\x01"?/v1beta1/{name=projects/*/locations/*/clusters/*}:setMonitoring:\x01*ZQ"L/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/monitoring:\x01*\x12\x81\x02\n\x0fSetAddonsConfig\x12\x30.google.container.v1beta1.SetAddonsConfigRequest\x1a#.google.container.v1beta1.Operation"\x96\x01\x82\xd3\xe4\x93\x02\x8f\x01";/v1beta1/{name=projects/*/locations/*/clusters/*}:setAddons:\x01*ZM"H/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/addons:\x01*\x12\x81\x02\n\x0cSetLocations\x12-.google.container.v1beta1.SetLocationsRequest\x1a#.google.container.v1beta1.Operation"\x9c\x01\x82\xd3\xe4\x93\x02\x95\x01">/v1beta1/{name=projects/*/locations/*/clusters/*}:setLocations:\x01*ZP"K/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/locations:\x01*\x12\xfe\x01\n\x0cUpdateMaster\x12-.google.container.v1beta1.UpdateMasterRequest\x1a#.google.container.v1beta1.Operation"\x99\x01\x82\xd3\xe4\x93\x02\x92\x01">/v1beta1/{name=projects/*/locations/*/clusters/*}:updateMaster:\x01*ZM"H/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/master:\x01*\x12\x88\x02\n\rSetMasterAuth\x12..google.container.v1beta1.SetMasterAuthRequest\x1a#.google.container.v1beta1.Operation"\xa1\x01\x82\xd3\xe4\x93\x02\x9a\x01"?/v1beta1/{name=projects/*/locations/*/clusters/*}:setMasterAuth:\x01*ZT"O/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMasterAuth:\x01*\x12\xe4\x01\n\rDeleteCluster\x12..google.container.v1beta1.DeleteClusterRequest\x1a#.google.container.v1beta1.Operation"~\x82\xd3\xe4\x93\x02x*1/v1beta1/{name=projects/*/locations/*/clusters/*}ZC*A/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}\x12\xea\x01\n\x0eListOperations\x12/.google.container.v1beta1.ListOperationsRequest\x1a\x30.google.container.v1beta1.ListOperationsResponse"u\x82\xd3\xe4\x93\x02o\x12\x33/v1beta1/{parent=projects/*/locations/*}/operationsZ8\x12\x36/v1beta1/projects/{project_id}/zones/{zone}/operations\x12\xe9\x01\n\x0cGetOperation\x12-.google.container.v1beta1.GetOperationRequest\x1a#.google.container.v1beta1.Operation"\x84\x01\x82\xd3\xe4\x93\x02~\x12\x33/v1beta1/{name=projects/*/locations/*/operations/*}ZG\x12\x45/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}\x12\xf7\x01\n\x0f\x43\x61ncelOperation\x12\x30.google.container.v1beta1.CancelOperationRequest\x1a\x16.google.protobuf.Empty"\x99\x01\x82\xd3\xe4\x93\x02\x92\x01":/v1beta1/{name=projects/*/locations/*/operations/*}:cancel:\x01*ZQ"L/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}:cancel:\x01*\x12\xe4\x01\n\x0fGetServerConfig\x12\x30.google.container.v1beta1.GetServerConfigRequest\x1a&.google.container.v1beta1.ServerConfig"w\x82\xd3\xe4\x93\x02q\x12\x33/v1beta1/{name=projects/*/locations/*}/serverConfigZ:\x12\x38/v1beta1/projects/{project_id}/zones/{zone}/serverconfig\x12\x88\x02\n\rListNodePools\x12..google.container.v1beta1.ListNodePoolsRequest\x1a/.google.container.v1beta1.ListNodePoolsResponse"\x95\x01\x82\xd3\xe4\x93\x02\x8e\x01\x12=/v1beta1/{parent=projects/*/locations/*/clusters/*}/nodePoolsZM\x12K/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools\x12\x86\x02\n\x0bGetNodePool\x12,.google.container.v1beta1.GetNodePoolRequest\x1a".google.container.v1beta1.NodePool"\xa4\x01\x82\xd3\xe4\x93\x02\x9d\x01\x12=/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}Z\\\x12Z/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}\x12\x84\x02\n\x0e\x43reateNodePool\x12/.google.container.v1beta1.CreateNodePoolRequest\x1a#.google.container.v1beta1.Operation"\x9b\x01\x82\xd3\xe4\x93\x02\x94\x01"=/v1beta1/{parent=projects/*/locations/*/clusters/*}/nodePools:\x01*ZP"K/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools:\x01*\x12\x8d\x02\n\x0e\x44\x65leteNodePool\x12/.google.container.v1beta1.DeleteNodePoolRequest\x1a#.google.container.v1beta1.Operation"\xa4\x01\x82\xd3\xe4\x93\x02\x9d\x01*=/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}Z\\*Z/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}\x12\xb7\x02\n\x17RollbackNodePoolUpgrade\x12\x38.google.container.v1beta1.RollbackNodePoolUpgradeRequest\x1a#.google.container.v1beta1.Operation"\xbc\x01\x82\xd3\xe4\x93\x02\xb5\x01"F/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback:\x01*Zh"c/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}:rollback:\x01*\x12\xbd\x02\n\x15SetNodePoolManagement\x12\x36.google.container.v1beta1.SetNodePoolManagementRequest\x1a#.google.container.v1beta1.Operation"\xc6\x01\x82\xd3\xe4\x93\x02\xbf\x01"K/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setManagement:\x01*Zm"h/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setManagement:\x01*\x12\x85\x02\n\tSetLabels\x12*.google.container.v1beta1.SetLabelsRequest\x1a#.google.container.v1beta1.Operation"\xa6\x01\x82\xd3\xe4\x93\x02\x9f\x01"C/v1beta1/{name=projects/*/locations/*/clusters/*}:setResourceLabels:\x01*ZU"P/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels:\x01*\x12\x85\x02\n\rSetLegacyAbac\x12..google.container.v1beta1.SetLegacyAbacRequest\x1a#.google.container.v1beta1.Operation"\x9e\x01\x82\xd3\xe4\x93\x02\x97\x01"?/v1beta1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac:\x01*ZQ"L/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac:\x01*\x12\x90\x02\n\x0fStartIPRotation\x12\x30.google.container.v1beta1.StartIPRotationRequest\x1a#.google.container.v1beta1.Operation"\xa5\x01\x82\xd3\xe4\x93\x02\x9e\x01"A/v1beta1/{name=projects/*/locations/*/clusters/*}:startIpRotation:\x01*ZV"Q/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:startIpRotation:\x01*\x12\x9c\x02\n\x12\x43ompleteIPRotation\x12\x33.google.container.v1beta1.CompleteIPRotationRequest\x1a#.google.container.v1beta1.Operation"\xab\x01\x82\xd3\xe4\x93\x02\xa4\x01"D/v1beta1/{name=projects/*/locations/*/clusters/*}:completeIpRotation:\x01*ZY"T/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:completeIpRotation:\x01*\x12\xa5\x02\n\x0fSetNodePoolSize\x12\x30.google.container.v1beta1.SetNodePoolSizeRequest\x1a#.google.container.v1beta1.Operation"\xba\x01\x82\xd3\xe4\x93\x02\xb3\x01"E/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setSize:\x01*Zg"b/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setSize:\x01*\x12\x94\x02\n\x10SetNetworkPolicy\x12\x31.google.container.v1beta1.SetNetworkPolicyRequest\x1a#.google.container.v1beta1.Operation"\xa7\x01\x82\xd3\xe4\x93\x02\xa0\x01"B/v1beta1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy:\x01*ZW"R/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setNetworkPolicy:\x01*\x12\xa4\x02\n\x14SetMaintenancePolicy\x12\x35.google.container.v1beta1.SetMaintenancePolicyRequest\x1a#.google.container.v1beta1.Operation"\xaf\x01\x82\xd3\xe4\x93\x02\xa8\x01"F/v1beta1/{name=projects/*/locations/*/clusters/*}:setMaintenancePolicy:\x01*Z["V/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMaintenancePolicy:\x01*\x12\xcb\x01\n\x15ListUsableSubnetworks\x12\x36.google.container.v1beta1.ListUsableSubnetworksRequest\x1a\x37.google.container.v1beta1.ListUsableSubnetworksResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1beta1/{parent=projects/*}/aggregated/usableSubnetworks\x12\xa0\x01\n\rListLocations\x12..google.container.v1beta1.ListLocationsRequest\x1a/.google.container.v1beta1.ListLocationsResponse".\x82\xd3\xe4\x93\x02(\x12&/v1beta1/{parent=projects/*}/locationsB\xba\x01\n\x1c\x63om.google.container.v1beta1B\x13\x43lusterServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/container/v1beta1;container\xaa\x02\x1eGoogle.Cloud.Container.V1Beta1\xca\x02\x1eGoogle\\Cloud\\Container\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_NODETAINT_EFFECT = _descriptor.EnumDescriptor(
+    name="Effect",
+    full_name="google.container.v1beta1.NodeTaint.Effect",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EFFECT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NO_SCHEDULE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREFER_NO_SCHEDULE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NO_EXECUTE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=976,
+    serialized_end=1065,
+)
+_sym_db.RegisterEnumDescriptor(_NODETAINT_EFFECT)
+
+_ISTIOCONFIG_ISTIOAUTHMODE = _descriptor.EnumDescriptor(
+    name="IstioAuthMode",
+    full_name="google.container.v1beta1.IstioConfig.IstioAuthMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="AUTH_NONE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTH_MUTUAL_TLS",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2247,
+    serialized_end=2298,
+)
+_sym_db.RegisterEnumDescriptor(_ISTIOCONFIG_ISTIOAUTHMODE)
+
+_NETWORKPOLICY_PROVIDER = _descriptor.EnumDescriptor(
+    name="Provider",
+    full_name="google.container.v1beta1.NetworkPolicy.Provider",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PROVIDER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CALICO", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2666,
+    serialized_end=2714,
+)
+_sym_db.RegisterEnumDescriptor(_NETWORKPOLICY_PROVIDER)
+
+_CLUSTER_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1beta1.Cluster.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROVISIONING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECONCILING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STOPPING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEGRADED", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5467,
+    serialized_end=5586,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTER_STATUS)
+
+_OPERATION_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1beta1.Operation.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ABORTING", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7056,
+    serialized_end=7138,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATION_STATUS)
+
+_OPERATION_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.container.v1beta1.Operation.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATE_CLUSTER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE_CLUSTER", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPGRADE_MASTER", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPGRADE_NODES", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPAIR_CLUSTER", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATE_CLUSTER", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATE_NODE_POOL",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE_NODE_POOL",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_NODE_POOL_MANAGEMENT",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTO_REPAIR_NODES",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTO_UPGRADE_NODES",
+            index=11,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_LABELS", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_MASTER_AUTH",
+            index=13,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_NODE_POOL_SIZE",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_NETWORK_POLICY",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_MAINTENANCE_POLICY",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7141,
+    serialized_end=7522,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATION_TYPE)
+
+_SETMASTERAUTHREQUEST_ACTION = _descriptor.EnumDescriptor(
+    name="Action",
+    full_name="google.container.v1beta1.SetMasterAuthRequest.Action",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_PASSWORD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GENERATE_PASSWORD",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_USERNAME", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=9550,
+    serialized_end=9630,
+)
+_sym_db.RegisterEnumDescriptor(_SETMASTERAUTHREQUEST_ACTION)
+
+_NODEPOOL_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1beta1.NodePool.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROVISIONING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING_WITH_ERROR",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECONCILING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STOPPING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=11620,
+    serialized_end=11749,
+)
+_sym_db.RegisterEnumDescriptor(_NODEPOOL_STATUS)
+
+_WORKLOADMETADATACONFIG_NODEMETADATA = _descriptor.EnumDescriptor(
+    name="NodeMetadata",
+    full_name="google.container.v1beta1.WorkloadMetadataConfig.NodeMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SECURE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPOSE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=13936,
+    serialized_end=13991,
+)
+_sym_db.RegisterEnumDescriptor(_WORKLOADMETADATACONFIG_NODEMETADATA)
+
+_LOCATION_LOCATIONTYPE = _descriptor.EnumDescriptor(
+    name="LocationType",
+    full_name="google.container.v1beta1.Location.LocationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LOCATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ZONE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REGION", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=14595,
+    serialized_end=14662,
+)
+_sym_db.RegisterEnumDescriptor(_LOCATION_LOCATIONTYPE)
+
+_STATUSCONDITION_CODE = _descriptor.EnumDescriptor(
+    name="Code",
+    full_name="google.container.v1beta1.StatusCondition.Code",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GCE_STOCKOUT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GKE_SERVICE_ACCOUNT_DELETED",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GCE_QUOTA_EXCEEDED",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SET_BY_OPERATOR",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=14763,
+    serialized_end=14878,
+)
+_sym_db.RegisterEnumDescriptor(_STATUSCONDITION_CODE)
+
+_USABLESUBNETWORKSECONDARYRANGE_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.container.v1beta1.UsableSubnetworkSecondaryRange.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNUSED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IN_USE_SERVICE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IN_USE_SHAREABLE_POD",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IN_USE_MANAGED_POD",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=15319,
+    serialized_end=15422,
+)
+_sym_db.RegisterEnumDescriptor(_USABLESUBNETWORKSECONDARYRANGE_STATUS)
+
+
+_NODECONFIG_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.container.v1beta1.NodeConfig.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1beta1.NodeConfig.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1beta1.NodeConfig.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=778,
+    serialized_end=825,
+)
+
+_NODECONFIG_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.container.v1beta1.NodeConfig.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1beta1.NodeConfig.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1beta1.NodeConfig.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=827,
+    serialized_end=872,
+)
+
+_NODECONFIG = _descriptor.Descriptor(
+    name="NodeConfig",
+    full_name="google.container.v1beta1.NodeConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="machine_type",
+            full_name="google.container.v1beta1.NodeConfig.machine_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disk_size_gb",
+            full_name="google.container.v1beta1.NodeConfig.disk_size_gb",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oauth_scopes",
+            full_name="google.container.v1beta1.NodeConfig.oauth_scopes",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account",
+            full_name="google.container.v1beta1.NodeConfig.service_account",
+            index=3,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.container.v1beta1.NodeConfig.metadata",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_type",
+            full_name="google.container.v1beta1.NodeConfig.image_type",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.container.v1beta1.NodeConfig.labels",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="local_ssd_count",
+            full_name="google.container.v1beta1.NodeConfig.local_ssd_count",
+            index=7,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.container.v1beta1.NodeConfig.tags",
+            index=8,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="preemptible",
+            full_name="google.container.v1beta1.NodeConfig.preemptible",
+            index=9,
+            number=10,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerators",
+            full_name="google.container.v1beta1.NodeConfig.accelerators",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disk_type",
+            full_name="google.container.v1beta1.NodeConfig.disk_type",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_cpu_platform",
+            full_name="google.container.v1beta1.NodeConfig.min_cpu_platform",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="workload_metadata_config",
+            full_name="google.container.v1beta1.NodeConfig.workload_metadata_config",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="taints",
+            full_name="google.container.v1beta1.NodeConfig.taints",
+            index=14,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_NODECONFIG_METADATAENTRY, _NODECONFIG_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=208,
+    serialized_end=872,
+)
+
+
+_NODETAINT = _descriptor.Descriptor(
+    name="NodeTaint",
+    full_name="google.container.v1beta1.NodeTaint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1beta1.NodeTaint.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1beta1.NodeTaint.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="effect",
+            full_name="google.container.v1beta1.NodeTaint.effect",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_NODETAINT_EFFECT],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=875,
+    serialized_end=1065,
+)
+
+
+_MASTERAUTH = _descriptor.Descriptor(
+    name="MasterAuth",
+    full_name="google.container.v1beta1.MasterAuth",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.container.v1beta1.MasterAuth.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.container.v1beta1.MasterAuth.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_certificate_config",
+            full_name="google.container.v1beta1.MasterAuth.client_certificate_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ca_certificate",
+            full_name="google.container.v1beta1.MasterAuth.cluster_ca_certificate",
+            index=3,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_certificate",
+            full_name="google.container.v1beta1.MasterAuth.client_certificate",
+            index=4,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_key",
+            full_name="google.container.v1beta1.MasterAuth.client_key",
+            index=5,
+            number=102,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1068,
+    serialized_end=1282,
+)
+
+
+_CLIENTCERTIFICATECONFIG = _descriptor.Descriptor(
+    name="ClientCertificateConfig",
+    full_name="google.container.v1beta1.ClientCertificateConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="issue_client_certificate",
+            full_name="google.container.v1beta1.ClientCertificateConfig.issue_client_certificate",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1284,
+    serialized_end=1343,
+)
+
+
+_ADDONSCONFIG = _descriptor.Descriptor(
+    name="AddonsConfig",
+    full_name="google.container.v1beta1.AddonsConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_load_balancing",
+            full_name="google.container.v1beta1.AddonsConfig.http_load_balancing",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="horizontal_pod_autoscaling",
+            full_name="google.container.v1beta1.AddonsConfig.horizontal_pod_autoscaling",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kubernetes_dashboard",
+            full_name="google.container.v1beta1.AddonsConfig.kubernetes_dashboard",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_policy_config",
+            full_name="google.container.v1beta1.AddonsConfig.network_policy_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="istio_config",
+            full_name="google.container.v1beta1.AddonsConfig.istio_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cloud_run_config",
+            full_name="google.container.v1beta1.AddonsConfig.cloud_run_config",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1346,
+    serialized_end=1806,
+)
+
+
+_HTTPLOADBALANCING = _descriptor.Descriptor(
+    name="HttpLoadBalancing",
+    full_name="google.container.v1beta1.HttpLoadBalancing",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1beta1.HttpLoadBalancing.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1808,
+    serialized_end=1845,
+)
+
+
+_HORIZONTALPODAUTOSCALING = _descriptor.Descriptor(
+    name="HorizontalPodAutoscaling",
+    full_name="google.container.v1beta1.HorizontalPodAutoscaling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1beta1.HorizontalPodAutoscaling.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1847,
+    serialized_end=1891,
+)
+
+
+_KUBERNETESDASHBOARD = _descriptor.Descriptor(
+    name="KubernetesDashboard",
+    full_name="google.container.v1beta1.KubernetesDashboard",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1beta1.KubernetesDashboard.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1893,
+    serialized_end=1932,
+)
+
+
+_NETWORKPOLICYCONFIG = _descriptor.Descriptor(
+    name="NetworkPolicyConfig",
+    full_name="google.container.v1beta1.NetworkPolicyConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1beta1.NetworkPolicyConfig.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1934,
+    serialized_end=1973,
+)
+
+
+_PRIVATECLUSTERCONFIG = _descriptor.Descriptor(
+    name="PrivateClusterConfig",
+    full_name="google.container.v1beta1.PrivateClusterConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_private_nodes",
+            full_name="google.container.v1beta1.PrivateClusterConfig.enable_private_nodes",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_private_endpoint",
+            full_name="google.container.v1beta1.PrivateClusterConfig.enable_private_endpoint",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_ipv4_cidr_block",
+            full_name="google.container.v1beta1.PrivateClusterConfig.master_ipv4_cidr_block",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="private_endpoint",
+            full_name="google.container.v1beta1.PrivateClusterConfig.private_endpoint",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="public_endpoint",
+            full_name="google.container.v1beta1.PrivateClusterConfig.public_endpoint",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1976,
+    serialized_end=2144,
+)
+
+
+_ISTIOCONFIG = _descriptor.Descriptor(
+    name="IstioConfig",
+    full_name="google.container.v1beta1.IstioConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1beta1.IstioConfig.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auth",
+            full_name="google.container.v1beta1.IstioConfig.auth",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ISTIOCONFIG_ISTIOAUTHMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2147,
+    serialized_end=2298,
+)
+
+
+_CLOUDRUNCONFIG = _descriptor.Descriptor(
+    name="CloudRunConfig",
+    full_name="google.container.v1beta1.CloudRunConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.container.v1beta1.CloudRunConfig.disabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2300,
+    serialized_end=2334,
+)
+
+
+_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK = _descriptor.Descriptor(
+    name="CidrBlock",
+    full_name="google.container.v1beta1.MasterAuthorizedNetworksConfig.CidrBlock",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.container.v1beta1.MasterAuthorizedNetworksConfig.CidrBlock.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cidr_block",
+            full_name="google.container.v1beta1.MasterAuthorizedNetworksConfig.CidrBlock.cidr_block",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2477,
+    serialized_end=2530,
+)
+
+_MASTERAUTHORIZEDNETWORKSCONFIG = _descriptor.Descriptor(
+    name="MasterAuthorizedNetworksConfig",
+    full_name="google.container.v1beta1.MasterAuthorizedNetworksConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.MasterAuthorizedNetworksConfig.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cidr_blocks",
+            full_name="google.container.v1beta1.MasterAuthorizedNetworksConfig.cidr_blocks",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2337,
+    serialized_end=2530,
+)
+
+
+_LEGACYABAC = _descriptor.Descriptor(
+    name="LegacyAbac",
+    full_name="google.container.v1beta1.LegacyAbac",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.LegacyAbac.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2532,
+    serialized_end=2561,
+)
+
+
+_NETWORKPOLICY = _descriptor.Descriptor(
+    name="NetworkPolicy",
+    full_name="google.container.v1beta1.NetworkPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="provider",
+            full_name="google.container.v1beta1.NetworkPolicy.provider",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.NetworkPolicy.enabled",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_NETWORKPOLICY_PROVIDER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2564,
+    serialized_end=2714,
+)
+
+
+_IPALLOCATIONPOLICY = _descriptor.Descriptor(
+    name="IPAllocationPolicy",
+    full_name="google.container.v1beta1.IPAllocationPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="use_ip_aliases",
+            full_name="google.container.v1beta1.IPAllocationPolicy.use_ip_aliases",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_subnetwork",
+            full_name="google.container.v1beta1.IPAllocationPolicy.create_subnetwork",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork_name",
+            full_name="google.container.v1beta1.IPAllocationPolicy.subnetwork_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ipv4_cidr",
+            full_name="google.container.v1beta1.IPAllocationPolicy.cluster_ipv4_cidr",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_ipv4_cidr",
+            full_name="google.container.v1beta1.IPAllocationPolicy.node_ipv4_cidr",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_ipv4_cidr",
+            full_name="google.container.v1beta1.IPAllocationPolicy.services_ipv4_cidr",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_secondary_range_name",
+            full_name="google.container.v1beta1.IPAllocationPolicy.cluster_secondary_range_name",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_secondary_range_name",
+            full_name="google.container.v1beta1.IPAllocationPolicy.services_secondary_range_name",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ipv4_cidr_block",
+            full_name="google.container.v1beta1.IPAllocationPolicy.cluster_ipv4_cidr_block",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_ipv4_cidr_block",
+            full_name="google.container.v1beta1.IPAllocationPolicy.node_ipv4_cidr_block",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_ipv4_cidr_block",
+            full_name="google.container.v1beta1.IPAllocationPolicy.services_ipv4_cidr_block",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_route_overlap",
+            full_name="google.container.v1beta1.IPAllocationPolicy.allow_route_overlap",
+            index=11,
+            number=12,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tpu_ipv4_cidr_block",
+            full_name="google.container.v1beta1.IPAllocationPolicy.tpu_ipv4_cidr_block",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2717,
+    serialized_end=3136,
+)
+
+
+_BINARYAUTHORIZATION = _descriptor.Descriptor(
+    name="BinaryAuthorization",
+    full_name="google.container.v1beta1.BinaryAuthorization",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.BinaryAuthorization.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3138,
+    serialized_end=3176,
+)
+
+
+_PODSECURITYPOLICYCONFIG = _descriptor.Descriptor(
+    name="PodSecurityPolicyConfig",
+    full_name="google.container.v1beta1.PodSecurityPolicyConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.PodSecurityPolicyConfig.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3178,
+    serialized_end=3220,
+)
+
+
+_CLUSTER_RESOURCELABELSENTRY = _descriptor.Descriptor(
+    name="ResourceLabelsEntry",
+    full_name="google.container.v1beta1.Cluster.ResourceLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1beta1.Cluster.ResourceLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1beta1.Cluster.ResourceLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5412,
+    serialized_end=5465,
+)
+
+_CLUSTER = _descriptor.Descriptor(
+    name="Cluster",
+    full_name="google.container.v1beta1.Cluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.Cluster.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.container.v1beta1.Cluster.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_node_count",
+            full_name="google.container.v1beta1.Cluster.initial_node_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_config",
+            full_name="google.container.v1beta1.Cluster.node_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_auth",
+            full_name="google.container.v1beta1.Cluster.master_auth",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_service",
+            full_name="google.container.v1beta1.Cluster.logging_service",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="monitoring_service",
+            full_name="google.container.v1beta1.Cluster.monitoring_service",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network",
+            full_name="google.container.v1beta1.Cluster.network",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_ipv4_cidr",
+            full_name="google.container.v1beta1.Cluster.cluster_ipv4_cidr",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="addons_config",
+            full_name="google.container.v1beta1.Cluster.addons_config",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork",
+            full_name="google.container.v1beta1.Cluster.subnetwork",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pools",
+            full_name="google.container.v1beta1.Cluster.node_pools",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.container.v1beta1.Cluster.locations",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_kubernetes_alpha",
+            full_name="google.container.v1beta1.Cluster.enable_kubernetes_alpha",
+            index=13,
+            number=14,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_labels",
+            full_name="google.container.v1beta1.Cluster.resource_labels",
+            index=14,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_fingerprint",
+            full_name="google.container.v1beta1.Cluster.label_fingerprint",
+            index=15,
+            number=16,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="legacy_abac",
+            full_name="google.container.v1beta1.Cluster.legacy_abac",
+            index=16,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_policy",
+            full_name="google.container.v1beta1.Cluster.network_policy",
+            index=17,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ip_allocation_policy",
+            full_name="google.container.v1beta1.Cluster.ip_allocation_policy",
+            index=18,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_authorized_networks_config",
+            full_name="google.container.v1beta1.Cluster.master_authorized_networks_config",
+            index=19,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maintenance_policy",
+            full_name="google.container.v1beta1.Cluster.maintenance_policy",
+            index=20,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_authorization",
+            full_name="google.container.v1beta1.Cluster.binary_authorization",
+            index=21,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pod_security_policy_config",
+            full_name="google.container.v1beta1.Cluster.pod_security_policy_config",
+            index=22,
+            number=25,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoscaling",
+            full_name="google.container.v1beta1.Cluster.autoscaling",
+            index=23,
+            number=26,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_config",
+            full_name="google.container.v1beta1.Cluster.network_config",
+            index=24,
+            number=27,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="private_cluster",
+            full_name="google.container.v1beta1.Cluster.private_cluster",
+            index=25,
+            number=28,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_ipv4_cidr_block",
+            full_name="google.container.v1beta1.Cluster.master_ipv4_cidr_block",
+            index=26,
+            number=29,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="default_max_pods_constraint",
+            full_name="google.container.v1beta1.Cluster.default_max_pods_constraint",
+            index=27,
+            number=30,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_usage_export_config",
+            full_name="google.container.v1beta1.Cluster.resource_usage_export_config",
+            index=28,
+            number=33,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="private_cluster_config",
+            full_name="google.container.v1beta1.Cluster.private_cluster_config",
+            index=29,
+            number=37,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="vertical_pod_autoscaling",
+            full_name="google.container.v1beta1.Cluster.vertical_pod_autoscaling",
+            index=30,
+            number=39,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="self_link",
+            full_name="google.container.v1beta1.Cluster.self_link",
+            index=31,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.Cluster.zone",
+            index=32,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="endpoint",
+            full_name="google.container.v1beta1.Cluster.endpoint",
+            index=33,
+            number=102,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_cluster_version",
+            full_name="google.container.v1beta1.Cluster.initial_cluster_version",
+            index=34,
+            number=103,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_master_version",
+            full_name="google.container.v1beta1.Cluster.current_master_version",
+            index=35,
+            number=104,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_node_version",
+            full_name="google.container.v1beta1.Cluster.current_node_version",
+            index=36,
+            number=105,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.container.v1beta1.Cluster.create_time",
+            index=37,
+            number=106,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1beta1.Cluster.status",
+            index=38,
+            number=107,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1beta1.Cluster.status_message",
+            index=39,
+            number=108,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_ipv4_cidr_size",
+            full_name="google.container.v1beta1.Cluster.node_ipv4_cidr_size",
+            index=40,
+            number=109,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="services_ipv4_cidr",
+            full_name="google.container.v1beta1.Cluster.services_ipv4_cidr",
+            index=41,
+            number=110,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_group_urls",
+            full_name="google.container.v1beta1.Cluster.instance_group_urls",
+            index=42,
+            number=111,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_node_count",
+            full_name="google.container.v1beta1.Cluster.current_node_count",
+            index=43,
+            number=112,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.container.v1beta1.Cluster.expire_time",
+            index=44,
+            number=113,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.container.v1beta1.Cluster.location",
+            index=45,
+            number=114,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_tpu",
+            full_name="google.container.v1beta1.Cluster.enable_tpu",
+            index=46,
+            number=115,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tpu_ipv4_cidr_block",
+            full_name="google.container.v1beta1.Cluster.tpu_ipv4_cidr_block",
+            index=47,
+            number=116,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="conditions",
+            full_name="google.container.v1beta1.Cluster.conditions",
+            index=48,
+            number=118,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTER_RESOURCELABELSENTRY],
+    enum_types=[_CLUSTER_STATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3223,
+    serialized_end=5586,
+)
+
+
+_CLUSTERUPDATE = _descriptor.Descriptor(
+    name="ClusterUpdate",
+    full_name="google.container.v1beta1.ClusterUpdate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="desired_node_version",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_node_version",
+            index=0,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_monitoring_service",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_monitoring_service",
+            index=1,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_addons_config",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_addons_config",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_node_pool_id",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_node_pool_id",
+            index=3,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_image_type",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_image_type",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_node_pool_autoscaling",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_node_pool_autoscaling",
+            index=5,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_locations",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_locations",
+            index=6,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_master_authorized_networks_config",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_master_authorized_networks_config",
+            index=7,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_pod_security_policy_config",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_pod_security_policy_config",
+            index=8,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_cluster_autoscaling",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_cluster_autoscaling",
+            index=9,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_binary_authorization",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_binary_authorization",
+            index=10,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_logging_service",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_logging_service",
+            index=11,
+            number=19,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_resource_usage_export_config",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_resource_usage_export_config",
+            index=12,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_vertical_pod_autoscaling",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_vertical_pod_autoscaling",
+            index=13,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="desired_master_version",
+            full_name="google.container.v1beta1.ClusterUpdate.desired_master_version",
+            index=14,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5589,
+    serialized_end=6540,
+)
+
+
+_OPERATION = _descriptor.Descriptor(
+    name="Operation",
+    full_name="google.container.v1beta1.Operation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.Operation.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.Operation.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_type",
+            full_name="google.container.v1beta1.Operation.operation_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1beta1.Operation.status",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detail",
+            full_name="google.container.v1beta1.Operation.detail",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1beta1.Operation.status_message",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="self_link",
+            full_name="google.container.v1beta1.Operation.self_link",
+            index=6,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_link",
+            full_name="google.container.v1beta1.Operation.target_link",
+            index=7,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.container.v1beta1.Operation.location",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.container.v1beta1.Operation.start_time",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.container.v1beta1.Operation.end_time",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress",
+            full_name="google.container.v1beta1.Operation.progress",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_conditions",
+            full_name="google.container.v1beta1.Operation.cluster_conditions",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="nodepool_conditions",
+            full_name="google.container.v1beta1.Operation.nodepool_conditions",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OPERATION_STATUS, _OPERATION_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6543,
+    serialized_end=7522,
+)
+
+
+_OPERATIONPROGRESS_METRIC = _descriptor.Descriptor(
+    name="Metric",
+    full_name="google.container.v1beta1.OperationProgress.Metric",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.OperationProgress.Metric.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="int_value",
+            full_name="google.container.v1beta1.OperationProgress.Metric.int_value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="double_value",
+            full_name="google.container.v1beta1.OperationProgress.Metric.double_value",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.container.v1beta1.OperationProgress.Metric.string_value",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value",
+            full_name="google.container.v1beta1.OperationProgress.Metric.value",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=7750,
+    serialized_end=7850,
+)
+
+_OPERATIONPROGRESS = _descriptor.Descriptor(
+    name="OperationProgress",
+    full_name="google.container.v1beta1.OperationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.OperationProgress.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1beta1.OperationProgress.status",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metrics",
+            full_name="google.container.v1beta1.OperationProgress.metrics",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stages",
+            full_name="google.container.v1beta1.OperationProgress.stages",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_OPERATIONPROGRESS_METRIC],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7525,
+    serialized_end=7850,
+)
+
+
+_CREATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="CreateClusterRequest",
+    full_name="google.container.v1beta1.CreateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.CreateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.CreateClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.container.v1beta1.CreateClusterRequest.cluster",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.CreateClusterRequest.parent",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7853,
+    serialized_end=7985,
+)
+
+
+_GETCLUSTERREQUEST = _descriptor.Descriptor(
+    name="GetClusterRequest",
+    full_name="google.container.v1beta1.GetClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.GetClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.GetClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.GetClusterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.GetClusterRequest.name",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7987,
+    serialized_end=8086,
+)
+
+
+_UPDATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="UpdateClusterRequest",
+    full_name="google.container.v1beta1.UpdateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.UpdateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.UpdateClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.UpdateClusterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.container.v1beta1.UpdateClusterRequest.update",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.UpdateClusterRequest.name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8089,
+    serialized_end=8248,
+)
+
+
+_UPDATENODEPOOLREQUEST = _descriptor.Descriptor(
+    name="UpdateNodePoolRequest",
+    full_name="google.container.v1beta1.UpdateNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_version",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.node_version",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_type",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.image_type",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.UpdateNodePoolRequest.name",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8251,
+    serialized_end=8422,
+)
+
+
+_SETNODEPOOLAUTOSCALINGREQUEST = _descriptor.Descriptor(
+    name="SetNodePoolAutoscalingRequest",
+    full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoscaling",
+            full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest.autoscaling",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetNodePoolAutoscalingRequest.name",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8425,
+    serialized_end=8630,
+)
+
+
+_SETLOGGINGSERVICEREQUEST = _descriptor.Descriptor(
+    name="SetLoggingServiceRequest",
+    full_name="google.container.v1beta1.SetLoggingServiceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetLoggingServiceRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetLoggingServiceRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetLoggingServiceRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_service",
+            full_name="google.container.v1beta1.SetLoggingServiceRequest.logging_service",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetLoggingServiceRequest.name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8632,
+    serialized_end=8759,
+)
+
+
+_SETMONITORINGSERVICEREQUEST = _descriptor.Descriptor(
+    name="SetMonitoringServiceRequest",
+    full_name="google.container.v1beta1.SetMonitoringServiceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetMonitoringServiceRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetMonitoringServiceRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetMonitoringServiceRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="monitoring_service",
+            full_name="google.container.v1beta1.SetMonitoringServiceRequest.monitoring_service",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetMonitoringServiceRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8762,
+    serialized_end=8899,
+)
+
+
+_SETADDONSCONFIGREQUEST = _descriptor.Descriptor(
+    name="SetAddonsConfigRequest",
+    full_name="google.container.v1beta1.SetAddonsConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetAddonsConfigRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetAddonsConfigRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetAddonsConfigRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="addons_config",
+            full_name="google.container.v1beta1.SetAddonsConfigRequest.addons_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetAddonsConfigRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8902,
+    serialized_end=9069,
+)
+
+
+_SETLOCATIONSREQUEST = _descriptor.Descriptor(
+    name="SetLocationsRequest",
+    full_name="google.container.v1beta1.SetLocationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetLocationsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetLocationsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetLocationsRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.container.v1beta1.SetLocationsRequest.locations",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetLocationsRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9071,
+    serialized_end=9191,
+)
+
+
+_UPDATEMASTERREQUEST = _descriptor.Descriptor(
+    name="UpdateMasterRequest",
+    full_name="google.container.v1beta1.UpdateMasterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.UpdateMasterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.UpdateMasterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.UpdateMasterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_version",
+            full_name="google.container.v1beta1.UpdateMasterRequest.master_version",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.UpdateMasterRequest.name",
+            index=4,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9193,
+    serialized_end=9318,
+)
+
+
+_SETMASTERAUTHREQUEST = _descriptor.Descriptor(
+    name="SetMasterAuthRequest",
+    full_name="google.container.v1beta1.SetMasterAuthRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetMasterAuthRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetMasterAuthRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetMasterAuthRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="action",
+            full_name="google.container.v1beta1.SetMasterAuthRequest.action",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.container.v1beta1.SetMasterAuthRequest.update",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetMasterAuthRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SETMASTERAUTHREQUEST_ACTION],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9321,
+    serialized_end=9630,
+)
+
+
+_DELETECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DeleteClusterRequest",
+    full_name="google.container.v1beta1.DeleteClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.DeleteClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.DeleteClusterRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.DeleteClusterRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.DeleteClusterRequest.name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9632,
+    serialized_end=9734,
+)
+
+
+_LISTCLUSTERSREQUEST = _descriptor.Descriptor(
+    name="ListClustersRequest",
+    full_name="google.container.v1beta1.ListClustersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.ListClustersRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.ListClustersRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.ListClustersRequest.parent",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9736,
+    serialized_end=9815,
+)
+
+
+_LISTCLUSTERSRESPONSE = _descriptor.Descriptor(
+    name="ListClustersResponse",
+    full_name="google.container.v1beta1.ListClustersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.container.v1beta1.ListClustersResponse.clusters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing_zones",
+            full_name="google.container.v1beta1.ListClustersResponse.missing_zones",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9817,
+    serialized_end=9915,
+)
+
+
+_GETOPERATIONREQUEST = _descriptor.Descriptor(
+    name="GetOperationRequest",
+    full_name="google.container.v1beta1.GetOperationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.GetOperationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.GetOperationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.container.v1beta1.GetOperationRequest.operation_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.GetOperationRequest.name",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9917,
+    serialized_end=10020,
+)
+
+
+_LISTOPERATIONSREQUEST = _descriptor.Descriptor(
+    name="ListOperationsRequest",
+    full_name="google.container.v1beta1.ListOperationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.ListOperationsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.ListOperationsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.ListOperationsRequest.parent",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10022,
+    serialized_end=10103,
+)
+
+
+_CANCELOPERATIONREQUEST = _descriptor.Descriptor(
+    name="CancelOperationRequest",
+    full_name="google.container.v1beta1.CancelOperationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.CancelOperationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.CancelOperationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.container.v1beta1.CancelOperationRequest.operation_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.CancelOperationRequest.name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10105,
+    serialized_end=10211,
+)
+
+
+_LISTOPERATIONSRESPONSE = _descriptor.Descriptor(
+    name="ListOperationsResponse",
+    full_name="google.container.v1beta1.ListOperationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="operations",
+            full_name="google.container.v1beta1.ListOperationsResponse.operations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing_zones",
+            full_name="google.container.v1beta1.ListOperationsResponse.missing_zones",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10213,
+    serialized_end=10317,
+)
+
+
+_GETSERVERCONFIGREQUEST = _descriptor.Descriptor(
+    name="GetServerConfigRequest",
+    full_name="google.container.v1beta1.GetServerConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.GetServerConfigRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.GetServerConfigRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.GetServerConfigRequest.name",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10319,
+    serialized_end=10399,
+)
+
+
+_SERVERCONFIG = _descriptor.Descriptor(
+    name="ServerConfig",
+    full_name="google.container.v1beta1.ServerConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="default_cluster_version",
+            full_name="google.container.v1beta1.ServerConfig.default_cluster_version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_node_versions",
+            full_name="google.container.v1beta1.ServerConfig.valid_node_versions",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="default_image_type",
+            full_name="google.container.v1beta1.ServerConfig.default_image_type",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_image_types",
+            full_name="google.container.v1beta1.ServerConfig.valid_image_types",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="valid_master_versions",
+            full_name="google.container.v1beta1.ServerConfig.valid_master_versions",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10402,
+    serialized_end=10564,
+)
+
+
+_CREATENODEPOOLREQUEST = _descriptor.Descriptor(
+    name="CreateNodePoolRequest",
+    full_name="google.container.v1beta1.CreateNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.CreateNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.CreateNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.CreateNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool",
+            full_name="google.container.v1beta1.CreateNodePoolRequest.node_pool",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.CreateNodePoolRequest.parent",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10567,
+    serialized_end=10727,
+)
+
+
+_DELETENODEPOOLREQUEST = _descriptor.Descriptor(
+    name="DeleteNodePoolRequest",
+    full_name="google.container.v1beta1.DeleteNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.DeleteNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.DeleteNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.DeleteNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.DeleteNodePoolRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.DeleteNodePoolRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10730,
+    serialized_end=10859,
+)
+
+
+_LISTNODEPOOLSREQUEST = _descriptor.Descriptor(
+    name="ListNodePoolsRequest",
+    full_name="google.container.v1beta1.ListNodePoolsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.ListNodePoolsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.ListNodePoolsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.ListNodePoolsRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.ListNodePoolsRequest.parent",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10861,
+    serialized_end=10965,
+)
+
+
+_GETNODEPOOLREQUEST = _descriptor.Descriptor(
+    name="GetNodePoolRequest",
+    full_name="google.container.v1beta1.GetNodePoolRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.GetNodePoolRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.GetNodePoolRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.GetNodePoolRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.GetNodePoolRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.GetNodePoolRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10967,
+    serialized_end=11093,
+)
+
+
+_NODEPOOL = _descriptor.Descriptor(
+    name="NodePool",
+    full_name="google.container.v1beta1.NodePool",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.NodePool.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.container.v1beta1.NodePool.config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initial_node_count",
+            full_name="google.container.v1beta1.NodePool.initial_node_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="self_link",
+            full_name="google.container.v1beta1.NodePool.self_link",
+            index=3,
+            number=100,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.container.v1beta1.NodePool.version",
+            index=4,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_group_urls",
+            full_name="google.container.v1beta1.NodePool.instance_group_urls",
+            index=5,
+            number=102,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1beta1.NodePool.status",
+            index=6,
+            number=103,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1beta1.NodePool.status_message",
+            index=7,
+            number=104,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoscaling",
+            full_name="google.container.v1beta1.NodePool.autoscaling",
+            index=8,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="management",
+            full_name="google.container.v1beta1.NodePool.management",
+            index=9,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_pods_constraint",
+            full_name="google.container.v1beta1.NodePool.max_pods_constraint",
+            index=10,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="conditions",
+            full_name="google.container.v1beta1.NodePool.conditions",
+            index=11,
+            number=105,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_NODEPOOL_STATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11096,
+    serialized_end=11749,
+)
+
+
+_NODEMANAGEMENT = _descriptor.Descriptor(
+    name="NodeManagement",
+    full_name="google.container.v1beta1.NodeManagement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="auto_upgrade",
+            full_name="google.container.v1beta1.NodeManagement.auto_upgrade",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auto_repair",
+            full_name="google.container.v1beta1.NodeManagement.auto_repair",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="upgrade_options",
+            full_name="google.container.v1beta1.NodeManagement.upgrade_options",
+            index=2,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11752,
+    serialized_end=11882,
+)
+
+
+_AUTOUPGRADEOPTIONS = _descriptor.Descriptor(
+    name="AutoUpgradeOptions",
+    full_name="google.container.v1beta1.AutoUpgradeOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="auto_upgrade_start_time",
+            full_name="google.container.v1beta1.AutoUpgradeOptions.auto_upgrade_start_time",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.container.v1beta1.AutoUpgradeOptions.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11884,
+    serialized_end=11958,
+)
+
+
+_MAINTENANCEPOLICY = _descriptor.Descriptor(
+    name="MaintenancePolicy",
+    full_name="google.container.v1beta1.MaintenancePolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="window",
+            full_name="google.container.v1beta1.MaintenancePolicy.window",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11960,
+    serialized_end=12040,
+)
+
+
+_MAINTENANCEWINDOW = _descriptor.Descriptor(
+    name="MaintenanceWindow",
+    full_name="google.container.v1beta1.MaintenanceWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="daily_maintenance_window",
+            full_name="google.container.v1beta1.MaintenanceWindow.daily_maintenance_window",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="policy",
+            full_name="google.container.v1beta1.MaintenanceWindow.policy",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=12042,
+    serialized_end=12157,
+)
+
+
+_DAILYMAINTENANCEWINDOW = _descriptor.Descriptor(
+    name="DailyMaintenanceWindow",
+    full_name="google.container.v1beta1.DailyMaintenanceWindow",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.container.v1beta1.DailyMaintenanceWindow.start_time",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duration",
+            full_name="google.container.v1beta1.DailyMaintenanceWindow.duration",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12159,
+    serialized_end=12221,
+)
+
+
+_SETNODEPOOLMANAGEMENTREQUEST = _descriptor.Descriptor(
+    name="SetNodePoolManagementRequest",
+    full_name="google.container.v1beta1.SetNodePoolManagementRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetNodePoolManagementRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetNodePoolManagementRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetNodePoolManagementRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.SetNodePoolManagementRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="management",
+            full_name="google.container.v1beta1.SetNodePoolManagementRequest.management",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetNodePoolManagementRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12224,
+    serialized_end=12422,
+)
+
+
+_SETNODEPOOLSIZEREQUEST = _descriptor.Descriptor(
+    name="SetNodePoolSizeRequest",
+    full_name="google.container.v1beta1.SetNodePoolSizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetNodePoolSizeRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetNodePoolSizeRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetNodePoolSizeRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.SetNodePoolSizeRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_count",
+            full_name="google.container.v1beta1.SetNodePoolSizeRequest.node_count",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetNodePoolSizeRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12425,
+    serialized_end=12575,
+)
+
+
+_ROLLBACKNODEPOOLUPGRADEREQUEST = _descriptor.Descriptor(
+    name="RollbackNodePoolUpgradeRequest",
+    full_name="google.container.v1beta1.RollbackNodePoolUpgradeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.RollbackNodePoolUpgradeRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.RollbackNodePoolUpgradeRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.RollbackNodePoolUpgradeRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_pool_id",
+            full_name="google.container.v1beta1.RollbackNodePoolUpgradeRequest.node_pool_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.RollbackNodePoolUpgradeRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12578,
+    serialized_end=12716,
+)
+
+
+_LISTNODEPOOLSRESPONSE = _descriptor.Descriptor(
+    name="ListNodePoolsResponse",
+    full_name="google.container.v1beta1.ListNodePoolsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="node_pools",
+            full_name="google.container.v1beta1.ListNodePoolsResponse.node_pools",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12718,
+    serialized_end=12797,
+)
+
+
+_CLUSTERAUTOSCALING = _descriptor.Descriptor(
+    name="ClusterAutoscaling",
+    full_name="google.container.v1beta1.ClusterAutoscaling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_node_autoprovisioning",
+            full_name="google.container.v1beta1.ClusterAutoscaling.enable_node_autoprovisioning",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_limits",
+            full_name="google.container.v1beta1.ClusterAutoscaling.resource_limits",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12799,
+    serialized_end=12923,
+)
+
+
+_RESOURCELIMIT = _descriptor.Descriptor(
+    name="ResourceLimit",
+    full_name="google.container.v1beta1.ResourceLimit",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_type",
+            full_name="google.container.v1beta1.ResourceLimit.resource_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="minimum",
+            full_name="google.container.v1beta1.ResourceLimit.minimum",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maximum",
+            full_name="google.container.v1beta1.ResourceLimit.maximum",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12925,
+    serialized_end=12997,
+)
+
+
+_NODEPOOLAUTOSCALING = _descriptor.Descriptor(
+    name="NodePoolAutoscaling",
+    full_name="google.container.v1beta1.NodePoolAutoscaling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.NodePoolAutoscaling.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_node_count",
+            full_name="google.container.v1beta1.NodePoolAutoscaling.min_node_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_node_count",
+            full_name="google.container.v1beta1.NodePoolAutoscaling.max_node_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoprovisioned",
+            full_name="google.container.v1beta1.NodePoolAutoscaling.autoprovisioned",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12999,
+    serialized_end=13110,
+)
+
+
+_SETLABELSREQUEST_RESOURCELABELSENTRY = _descriptor.Descriptor(
+    name="ResourceLabelsEntry",
+    full_name="google.container.v1beta1.SetLabelsRequest.ResourceLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.container.v1beta1.SetLabelsRequest.ResourceLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.container.v1beta1.SetLabelsRequest.ResourceLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5412,
+    serialized_end=5465,
+)
+
+_SETLABELSREQUEST = _descriptor.Descriptor(
+    name="SetLabelsRequest",
+    full_name="google.container.v1beta1.SetLabelsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetLabelsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetLabelsRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetLabelsRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_labels",
+            full_name="google.container.v1beta1.SetLabelsRequest.resource_labels",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_fingerprint",
+            full_name="google.container.v1beta1.SetLabelsRequest.label_fingerprint",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetLabelsRequest.name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SETLABELSREQUEST_RESOURCELABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13113,
+    serialized_end=13382,
+)
+
+
+_SETLEGACYABACREQUEST = _descriptor.Descriptor(
+    name="SetLegacyAbacRequest",
+    full_name="google.container.v1beta1.SetLegacyAbacRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetLegacyAbacRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetLegacyAbacRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetLegacyAbacRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.SetLegacyAbacRequest.enabled",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetLegacyAbacRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13384,
+    serialized_end=13503,
+)
+
+
+_STARTIPROTATIONREQUEST = _descriptor.Descriptor(
+    name="StartIPRotationRequest",
+    full_name="google.container.v1beta1.StartIPRotationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.StartIPRotationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.StartIPRotationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.StartIPRotationRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.StartIPRotationRequest.name",
+            index=3,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rotate_credentials",
+            full_name="google.container.v1beta1.StartIPRotationRequest.rotate_credentials",
+            index=4,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13506,
+    serialized_end=13638,
+)
+
+
+_COMPLETEIPROTATIONREQUEST = _descriptor.Descriptor(
+    name="CompleteIPRotationRequest",
+    full_name="google.container.v1beta1.CompleteIPRotationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.CompleteIPRotationRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.CompleteIPRotationRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.CompleteIPRotationRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.CompleteIPRotationRequest.name",
+            index=3,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13640,
+    serialized_end=13747,
+)
+
+
+_ACCELERATORCONFIG = _descriptor.Descriptor(
+    name="AcceleratorConfig",
+    full_name="google.container.v1beta1.AcceleratorConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="accelerator_count",
+            full_name="google.container.v1beta1.AcceleratorConfig.accelerator_count",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerator_type",
+            full_name="google.container.v1beta1.AcceleratorConfig.accelerator_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13749,
+    serialized_end=13821,
+)
+
+
+_WORKLOADMETADATACONFIG = _descriptor.Descriptor(
+    name="WorkloadMetadataConfig",
+    full_name="google.container.v1beta1.WorkloadMetadataConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="node_metadata",
+            full_name="google.container.v1beta1.WorkloadMetadataConfig.node_metadata",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_WORKLOADMETADATACONFIG_NODEMETADATA],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13824,
+    serialized_end=13991,
+)
+
+
+_SETNETWORKPOLICYREQUEST = _descriptor.Descriptor(
+    name="SetNetworkPolicyRequest",
+    full_name="google.container.v1beta1.SetNetworkPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetNetworkPolicyRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetNetworkPolicyRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetNetworkPolicyRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_policy",
+            full_name="google.container.v1beta1.SetNetworkPolicyRequest.network_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetNetworkPolicyRequest.name",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13994,
+    serialized_end=14164,
+)
+
+
+_SETMAINTENANCEPOLICYREQUEST = _descriptor.Descriptor(
+    name="SetMaintenancePolicyRequest",
+    full_name="google.container.v1beta1.SetMaintenancePolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.container.v1beta1.SetMaintenancePolicyRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.container.v1beta1.SetMaintenancePolicyRequest.zone",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_id",
+            full_name="google.container.v1beta1.SetMaintenancePolicyRequest.cluster_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maintenance_policy",
+            full_name="google.container.v1beta1.SetMaintenancePolicyRequest.maintenance_policy",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.SetMaintenancePolicyRequest.name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14167,
+    serialized_end=14337,
+)
+
+
+_LISTLOCATIONSREQUEST = _descriptor.Descriptor(
+    name="ListLocationsRequest",
+    full_name="google.container.v1beta1.ListLocationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.ListLocationsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14339,
+    serialized_end=14377,
+)
+
+
+_LISTLOCATIONSRESPONSE = _descriptor.Descriptor(
+    name="ListLocationsResponse",
+    full_name="google.container.v1beta1.ListLocationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.container.v1beta1.ListLocationsResponse.locations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.container.v1beta1.ListLocationsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14379,
+    serialized_end=14482,
+)
+
+
+_LOCATION = _descriptor.Descriptor(
+    name="Location",
+    full_name="google.container.v1beta1.Location",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.container.v1beta1.Location.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.container.v1beta1.Location.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recommended",
+            full_name="google.container.v1beta1.Location.recommended",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LOCATION_LOCATIONTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14485,
+    serialized_end=14662,
+)
+
+
+_STATUSCONDITION = _descriptor.Descriptor(
+    name="StatusCondition",
+    full_name="google.container.v1beta1.StatusCondition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.container.v1beta1.StatusCondition.code",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message",
+            full_name="google.container.v1beta1.StatusCondition.message",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STATUSCONDITION_CODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14665,
+    serialized_end=14878,
+)
+
+
+_NETWORKCONFIG = _descriptor.Descriptor(
+    name="NetworkConfig",
+    full_name="google.container.v1beta1.NetworkConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="network",
+            full_name="google.container.v1beta1.NetworkConfig.network",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork",
+            full_name="google.container.v1beta1.NetworkConfig.subnetwork",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14880,
+    serialized_end=14932,
+)
+
+
+_LISTUSABLESUBNETWORKSREQUEST = _descriptor.Descriptor(
+    name="ListUsableSubnetworksRequest",
+    full_name="google.container.v1beta1.ListUsableSubnetworksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.container.v1beta1.ListUsableSubnetworksRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.container.v1beta1.ListUsableSubnetworksRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.container.v1beta1.ListUsableSubnetworksRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.container.v1beta1.ListUsableSubnetworksRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14934,
+    serialized_end=15035,
+)
+
+
+_LISTUSABLESUBNETWORKSRESPONSE = _descriptor.Descriptor(
+    name="ListUsableSubnetworksResponse",
+    full_name="google.container.v1beta1.ListUsableSubnetworksResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subnetworks",
+            full_name="google.container.v1beta1.ListUsableSubnetworksResponse.subnetworks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.container.v1beta1.ListUsableSubnetworksResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15037,
+    serialized_end=15158,
+)
+
+
+_USABLESUBNETWORKSECONDARYRANGE = _descriptor.Descriptor(
+    name="UsableSubnetworkSecondaryRange",
+    full_name="google.container.v1beta1.UsableSubnetworkSecondaryRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="range_name",
+            full_name="google.container.v1beta1.UsableSubnetworkSecondaryRange.range_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ip_cidr_range",
+            full_name="google.container.v1beta1.UsableSubnetworkSecondaryRange.ip_cidr_range",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.container.v1beta1.UsableSubnetworkSecondaryRange.status",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_USABLESUBNETWORKSECONDARYRANGE_STATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15161,
+    serialized_end=15422,
+)
+
+
+_USABLESUBNETWORK = _descriptor.Descriptor(
+    name="UsableSubnetwork",
+    full_name="google.container.v1beta1.UsableSubnetwork",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subnetwork",
+            full_name="google.container.v1beta1.UsableSubnetwork.subnetwork",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network",
+            full_name="google.container.v1beta1.UsableSubnetwork.network",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ip_cidr_range",
+            full_name="google.container.v1beta1.UsableSubnetwork.ip_cidr_range",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="secondary_ip_ranges",
+            full_name="google.container.v1beta1.UsableSubnetwork.secondary_ip_ranges",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.container.v1beta1.UsableSubnetwork.status_message",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15425,
+    serialized_end=15614,
+)
+
+
+_VERTICALPODAUTOSCALING = _descriptor.Descriptor(
+    name="VerticalPodAutoscaling",
+    full_name="google.container.v1beta1.VerticalPodAutoscaling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.container.v1beta1.VerticalPodAutoscaling.enabled",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15616,
+    serialized_end=15657,
+)
+
+
+_MAXPODSCONSTRAINT = _descriptor.Descriptor(
+    name="MaxPodsConstraint",
+    full_name="google.container.v1beta1.MaxPodsConstraint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_pods_per_node",
+            full_name="google.container.v1beta1.MaxPodsConstraint.max_pods_per_node",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15659,
+    serialized_end=15705,
+)
+
+
+_RESOURCEUSAGEEXPORTCONFIG_BIGQUERYDESTINATION = _descriptor.Descriptor(
+    name="BigQueryDestination",
+    full_name="google.container.v1beta1.ResourceUsageExportConfig.BigQueryDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.container.v1beta1.ResourceUsageExportConfig.BigQueryDestination.dataset_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15880,
+    serialized_end=15921,
+)
+
+_RESOURCEUSAGEEXPORTCONFIG = _descriptor.Descriptor(
+    name="ResourceUsageExportConfig",
+    full_name="google.container.v1beta1.ResourceUsageExportConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bigquery_destination",
+            full_name="google.container.v1beta1.ResourceUsageExportConfig.bigquery_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_network_egress_metering",
+            full_name="google.container.v1beta1.ResourceUsageExportConfig.enable_network_egress_metering",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_RESOURCEUSAGEEXPORTCONFIG_BIGQUERYDESTINATION],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15708,
+    serialized_end=15921,
+)
+
+_NODECONFIG_METADATAENTRY.containing_type = _NODECONFIG
+_NODECONFIG_LABELSENTRY.containing_type = _NODECONFIG
+_NODECONFIG.fields_by_name["metadata"].message_type = _NODECONFIG_METADATAENTRY
+_NODECONFIG.fields_by_name["labels"].message_type = _NODECONFIG_LABELSENTRY
+_NODECONFIG.fields_by_name["accelerators"].message_type = _ACCELERATORCONFIG
+_NODECONFIG.fields_by_name[
+    "workload_metadata_config"
+].message_type = _WORKLOADMETADATACONFIG
+_NODECONFIG.fields_by_name["taints"].message_type = _NODETAINT
+_NODETAINT.fields_by_name["effect"].enum_type = _NODETAINT_EFFECT
+_NODETAINT_EFFECT.containing_type = _NODETAINT
+_MASTERAUTH.fields_by_name[
+    "client_certificate_config"
+].message_type = _CLIENTCERTIFICATECONFIG
+_ADDONSCONFIG.fields_by_name["http_load_balancing"].message_type = _HTTPLOADBALANCING
+_ADDONSCONFIG.fields_by_name[
+    "horizontal_pod_autoscaling"
+].message_type = _HORIZONTALPODAUTOSCALING
+_ADDONSCONFIG.fields_by_name["kubernetes_dashboard"].message_type = _KUBERNETESDASHBOARD
+_ADDONSCONFIG.fields_by_name[
+    "network_policy_config"
+].message_type = _NETWORKPOLICYCONFIG
+_ADDONSCONFIG.fields_by_name["istio_config"].message_type = _ISTIOCONFIG
+_ADDONSCONFIG.fields_by_name["cloud_run_config"].message_type = _CLOUDRUNCONFIG
+_ISTIOCONFIG.fields_by_name["auth"].enum_type = _ISTIOCONFIG_ISTIOAUTHMODE
+_ISTIOCONFIG_ISTIOAUTHMODE.containing_type = _ISTIOCONFIG
+_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK.containing_type = (
+    _MASTERAUTHORIZEDNETWORKSCONFIG
+)
+_MASTERAUTHORIZEDNETWORKSCONFIG.fields_by_name[
+    "cidr_blocks"
+].message_type = _MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK
+_NETWORKPOLICY.fields_by_name["provider"].enum_type = _NETWORKPOLICY_PROVIDER
+_NETWORKPOLICY_PROVIDER.containing_type = _NETWORKPOLICY
+_CLUSTER_RESOURCELABELSENTRY.containing_type = _CLUSTER
+_CLUSTER.fields_by_name["node_config"].message_type = _NODECONFIG
+_CLUSTER.fields_by_name["master_auth"].message_type = _MASTERAUTH
+_CLUSTER.fields_by_name["addons_config"].message_type = _ADDONSCONFIG
+_CLUSTER.fields_by_name["node_pools"].message_type = _NODEPOOL
+_CLUSTER.fields_by_name["resource_labels"].message_type = _CLUSTER_RESOURCELABELSENTRY
+_CLUSTER.fields_by_name["legacy_abac"].message_type = _LEGACYABAC
+_CLUSTER.fields_by_name["network_policy"].message_type = _NETWORKPOLICY
+_CLUSTER.fields_by_name["ip_allocation_policy"].message_type = _IPALLOCATIONPOLICY
+_CLUSTER.fields_by_name[
+    "master_authorized_networks_config"
+].message_type = _MASTERAUTHORIZEDNETWORKSCONFIG
+_CLUSTER.fields_by_name["maintenance_policy"].message_type = _MAINTENANCEPOLICY
+_CLUSTER.fields_by_name["binary_authorization"].message_type = _BINARYAUTHORIZATION
+_CLUSTER.fields_by_name[
+    "pod_security_policy_config"
+].message_type = _PODSECURITYPOLICYCONFIG
+_CLUSTER.fields_by_name["autoscaling"].message_type = _CLUSTERAUTOSCALING
+_CLUSTER.fields_by_name["network_config"].message_type = _NETWORKCONFIG
+_CLUSTER.fields_by_name["default_max_pods_constraint"].message_type = _MAXPODSCONSTRAINT
+_CLUSTER.fields_by_name[
+    "resource_usage_export_config"
+].message_type = _RESOURCEUSAGEEXPORTCONFIG
+_CLUSTER.fields_by_name["private_cluster_config"].message_type = _PRIVATECLUSTERCONFIG
+_CLUSTER.fields_by_name[
+    "vertical_pod_autoscaling"
+].message_type = _VERTICALPODAUTOSCALING
+_CLUSTER.fields_by_name["status"].enum_type = _CLUSTER_STATUS
+_CLUSTER.fields_by_name["conditions"].message_type = _STATUSCONDITION
+_CLUSTER_STATUS.containing_type = _CLUSTER
+_CLUSTERUPDATE.fields_by_name["desired_addons_config"].message_type = _ADDONSCONFIG
+_CLUSTERUPDATE.fields_by_name[
+    "desired_node_pool_autoscaling"
+].message_type = _NODEPOOLAUTOSCALING
+_CLUSTERUPDATE.fields_by_name[
+    "desired_master_authorized_networks_config"
+].message_type = _MASTERAUTHORIZEDNETWORKSCONFIG
+_CLUSTERUPDATE.fields_by_name[
+    "desired_pod_security_policy_config"
+].message_type = _PODSECURITYPOLICYCONFIG
+_CLUSTERUPDATE.fields_by_name[
+    "desired_cluster_autoscaling"
+].message_type = _CLUSTERAUTOSCALING
+_CLUSTERUPDATE.fields_by_name[
+    "desired_binary_authorization"
+].message_type = _BINARYAUTHORIZATION
+_CLUSTERUPDATE.fields_by_name[
+    "desired_resource_usage_export_config"
+].message_type = _RESOURCEUSAGEEXPORTCONFIG
+_CLUSTERUPDATE.fields_by_name[
+    "desired_vertical_pod_autoscaling"
+].message_type = _VERTICALPODAUTOSCALING
+_OPERATION.fields_by_name["operation_type"].enum_type = _OPERATION_TYPE
+_OPERATION.fields_by_name["status"].enum_type = _OPERATION_STATUS
+_OPERATION.fields_by_name["progress"].message_type = _OPERATIONPROGRESS
+_OPERATION.fields_by_name["cluster_conditions"].message_type = _STATUSCONDITION
+_OPERATION.fields_by_name["nodepool_conditions"].message_type = _STATUSCONDITION
+_OPERATION_STATUS.containing_type = _OPERATION
+_OPERATION_TYPE.containing_type = _OPERATION
+_OPERATIONPROGRESS_METRIC.containing_type = _OPERATIONPROGRESS
+_OPERATIONPROGRESS_METRIC.oneofs_by_name["value"].fields.append(
+    _OPERATIONPROGRESS_METRIC.fields_by_name["int_value"]
+)
+_OPERATIONPROGRESS_METRIC.fields_by_name[
+    "int_value"
+].containing_oneof = _OPERATIONPROGRESS_METRIC.oneofs_by_name["value"]
+_OPERATIONPROGRESS_METRIC.oneofs_by_name["value"].fields.append(
+    _OPERATIONPROGRESS_METRIC.fields_by_name["double_value"]
+)
+_OPERATIONPROGRESS_METRIC.fields_by_name[
+    "double_value"
+].containing_oneof = _OPERATIONPROGRESS_METRIC.oneofs_by_name["value"]
+_OPERATIONPROGRESS_METRIC.oneofs_by_name["value"].fields.append(
+    _OPERATIONPROGRESS_METRIC.fields_by_name["string_value"]
+)
+_OPERATIONPROGRESS_METRIC.fields_by_name[
+    "string_value"
+].containing_oneof = _OPERATIONPROGRESS_METRIC.oneofs_by_name["value"]
+_OPERATIONPROGRESS.fields_by_name["status"].enum_type = _OPERATION_STATUS
+_OPERATIONPROGRESS.fields_by_name["metrics"].message_type = _OPERATIONPROGRESS_METRIC
+_OPERATIONPROGRESS.fields_by_name["stages"].message_type = _OPERATIONPROGRESS
+_CREATECLUSTERREQUEST.fields_by_name["cluster"].message_type = _CLUSTER
+_UPDATECLUSTERREQUEST.fields_by_name["update"].message_type = _CLUSTERUPDATE
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name[
+    "autoscaling"
+].message_type = _NODEPOOLAUTOSCALING
+_SETADDONSCONFIGREQUEST.fields_by_name["addons_config"].message_type = _ADDONSCONFIG
+_SETMASTERAUTHREQUEST.fields_by_name["action"].enum_type = _SETMASTERAUTHREQUEST_ACTION
+_SETMASTERAUTHREQUEST.fields_by_name["update"].message_type = _MASTERAUTH
+_SETMASTERAUTHREQUEST_ACTION.containing_type = _SETMASTERAUTHREQUEST
+_LISTCLUSTERSRESPONSE.fields_by_name["clusters"].message_type = _CLUSTER
+_LISTOPERATIONSRESPONSE.fields_by_name["operations"].message_type = _OPERATION
+_CREATENODEPOOLREQUEST.fields_by_name["node_pool"].message_type = _NODEPOOL
+_NODEPOOL.fields_by_name["config"].message_type = _NODECONFIG
+_NODEPOOL.fields_by_name["status"].enum_type = _NODEPOOL_STATUS
+_NODEPOOL.fields_by_name["autoscaling"].message_type = _NODEPOOLAUTOSCALING
+_NODEPOOL.fields_by_name["management"].message_type = _NODEMANAGEMENT
+_NODEPOOL.fields_by_name["max_pods_constraint"].message_type = _MAXPODSCONSTRAINT
+_NODEPOOL.fields_by_name["conditions"].message_type = _STATUSCONDITION
+_NODEPOOL_STATUS.containing_type = _NODEPOOL
+_NODEMANAGEMENT.fields_by_name["upgrade_options"].message_type = _AUTOUPGRADEOPTIONS
+_MAINTENANCEPOLICY.fields_by_name["window"].message_type = _MAINTENANCEWINDOW
+_MAINTENANCEWINDOW.fields_by_name[
+    "daily_maintenance_window"
+].message_type = _DAILYMAINTENANCEWINDOW
+_MAINTENANCEWINDOW.oneofs_by_name["policy"].fields.append(
+    _MAINTENANCEWINDOW.fields_by_name["daily_maintenance_window"]
+)
+_MAINTENANCEWINDOW.fields_by_name[
+    "daily_maintenance_window"
+].containing_oneof = _MAINTENANCEWINDOW.oneofs_by_name["policy"]
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name[
+    "management"
+].message_type = _NODEMANAGEMENT
+_LISTNODEPOOLSRESPONSE.fields_by_name["node_pools"].message_type = _NODEPOOL
+_CLUSTERAUTOSCALING.fields_by_name["resource_limits"].message_type = _RESOURCELIMIT
+_SETLABELSREQUEST_RESOURCELABELSENTRY.containing_type = _SETLABELSREQUEST
+_SETLABELSREQUEST.fields_by_name[
+    "resource_labels"
+].message_type = _SETLABELSREQUEST_RESOURCELABELSENTRY
+_WORKLOADMETADATACONFIG.fields_by_name[
+    "node_metadata"
+].enum_type = _WORKLOADMETADATACONFIG_NODEMETADATA
+_WORKLOADMETADATACONFIG_NODEMETADATA.containing_type = _WORKLOADMETADATACONFIG
+_SETNETWORKPOLICYREQUEST.fields_by_name["network_policy"].message_type = _NETWORKPOLICY
+_SETMAINTENANCEPOLICYREQUEST.fields_by_name[
+    "maintenance_policy"
+].message_type = _MAINTENANCEPOLICY
+_LISTLOCATIONSRESPONSE.fields_by_name["locations"].message_type = _LOCATION
+_LOCATION.fields_by_name["type"].enum_type = _LOCATION_LOCATIONTYPE
+_LOCATION_LOCATIONTYPE.containing_type = _LOCATION
+_STATUSCONDITION.fields_by_name["code"].enum_type = _STATUSCONDITION_CODE
+_STATUSCONDITION_CODE.containing_type = _STATUSCONDITION
+_LISTUSABLESUBNETWORKSRESPONSE.fields_by_name[
+    "subnetworks"
+].message_type = _USABLESUBNETWORK
+_USABLESUBNETWORKSECONDARYRANGE.fields_by_name[
+    "status"
+].enum_type = _USABLESUBNETWORKSECONDARYRANGE_STATUS
+_USABLESUBNETWORKSECONDARYRANGE_STATUS.containing_type = _USABLESUBNETWORKSECONDARYRANGE
+_USABLESUBNETWORK.fields_by_name[
+    "secondary_ip_ranges"
+].message_type = _USABLESUBNETWORKSECONDARYRANGE
+_RESOURCEUSAGEEXPORTCONFIG_BIGQUERYDESTINATION.containing_type = (
+    _RESOURCEUSAGEEXPORTCONFIG
+)
+_RESOURCEUSAGEEXPORTCONFIG.fields_by_name[
+    "bigquery_destination"
+].message_type = _RESOURCEUSAGEEXPORTCONFIG_BIGQUERYDESTINATION
+DESCRIPTOR.message_types_by_name["NodeConfig"] = _NODECONFIG
+DESCRIPTOR.message_types_by_name["NodeTaint"] = _NODETAINT
+DESCRIPTOR.message_types_by_name["MasterAuth"] = _MASTERAUTH
+DESCRIPTOR.message_types_by_name["ClientCertificateConfig"] = _CLIENTCERTIFICATECONFIG
+DESCRIPTOR.message_types_by_name["AddonsConfig"] = _ADDONSCONFIG
+DESCRIPTOR.message_types_by_name["HttpLoadBalancing"] = _HTTPLOADBALANCING
+DESCRIPTOR.message_types_by_name["HorizontalPodAutoscaling"] = _HORIZONTALPODAUTOSCALING
+DESCRIPTOR.message_types_by_name["KubernetesDashboard"] = _KUBERNETESDASHBOARD
+DESCRIPTOR.message_types_by_name["NetworkPolicyConfig"] = _NETWORKPOLICYCONFIG
+DESCRIPTOR.message_types_by_name["PrivateClusterConfig"] = _PRIVATECLUSTERCONFIG
+DESCRIPTOR.message_types_by_name["IstioConfig"] = _ISTIOCONFIG
+DESCRIPTOR.message_types_by_name["CloudRunConfig"] = _CLOUDRUNCONFIG
+DESCRIPTOR.message_types_by_name[
+    "MasterAuthorizedNetworksConfig"
+] = _MASTERAUTHORIZEDNETWORKSCONFIG
+DESCRIPTOR.message_types_by_name["LegacyAbac"] = _LEGACYABAC
+DESCRIPTOR.message_types_by_name["NetworkPolicy"] = _NETWORKPOLICY
+DESCRIPTOR.message_types_by_name["IPAllocationPolicy"] = _IPALLOCATIONPOLICY
+DESCRIPTOR.message_types_by_name["BinaryAuthorization"] = _BINARYAUTHORIZATION
+DESCRIPTOR.message_types_by_name["PodSecurityPolicyConfig"] = _PODSECURITYPOLICYCONFIG
+DESCRIPTOR.message_types_by_name["Cluster"] = _CLUSTER
+DESCRIPTOR.message_types_by_name["ClusterUpdate"] = _CLUSTERUPDATE
+DESCRIPTOR.message_types_by_name["Operation"] = _OPERATION
+DESCRIPTOR.message_types_by_name["OperationProgress"] = _OPERATIONPROGRESS
+DESCRIPTOR.message_types_by_name["CreateClusterRequest"] = _CREATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["GetClusterRequest"] = _GETCLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateClusterRequest"] = _UPDATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateNodePoolRequest"] = _UPDATENODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SetNodePoolAutoscalingRequest"
+] = _SETNODEPOOLAUTOSCALINGREQUEST
+DESCRIPTOR.message_types_by_name["SetLoggingServiceRequest"] = _SETLOGGINGSERVICEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SetMonitoringServiceRequest"
+] = _SETMONITORINGSERVICEREQUEST
+DESCRIPTOR.message_types_by_name["SetAddonsConfigRequest"] = _SETADDONSCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["SetLocationsRequest"] = _SETLOCATIONSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateMasterRequest"] = _UPDATEMASTERREQUEST
+DESCRIPTOR.message_types_by_name["SetMasterAuthRequest"] = _SETMASTERAUTHREQUEST
+DESCRIPTOR.message_types_by_name["DeleteClusterRequest"] = _DELETECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersRequest"] = _LISTCLUSTERSREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersResponse"] = _LISTCLUSTERSRESPONSE
+DESCRIPTOR.message_types_by_name["GetOperationRequest"] = _GETOPERATIONREQUEST
+DESCRIPTOR.message_types_by_name["ListOperationsRequest"] = _LISTOPERATIONSREQUEST
+DESCRIPTOR.message_types_by_name["CancelOperationRequest"] = _CANCELOPERATIONREQUEST
+DESCRIPTOR.message_types_by_name["ListOperationsResponse"] = _LISTOPERATIONSRESPONSE
+DESCRIPTOR.message_types_by_name["GetServerConfigRequest"] = _GETSERVERCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["ServerConfig"] = _SERVERCONFIG
+DESCRIPTOR.message_types_by_name["CreateNodePoolRequest"] = _CREATENODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name["DeleteNodePoolRequest"] = _DELETENODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name["ListNodePoolsRequest"] = _LISTNODEPOOLSREQUEST
+DESCRIPTOR.message_types_by_name["GetNodePoolRequest"] = _GETNODEPOOLREQUEST
+DESCRIPTOR.message_types_by_name["NodePool"] = _NODEPOOL
+DESCRIPTOR.message_types_by_name["NodeManagement"] = _NODEMANAGEMENT
+DESCRIPTOR.message_types_by_name["AutoUpgradeOptions"] = _AUTOUPGRADEOPTIONS
+DESCRIPTOR.message_types_by_name["MaintenancePolicy"] = _MAINTENANCEPOLICY
+DESCRIPTOR.message_types_by_name["MaintenanceWindow"] = _MAINTENANCEWINDOW
+DESCRIPTOR.message_types_by_name["DailyMaintenanceWindow"] = _DAILYMAINTENANCEWINDOW
+DESCRIPTOR.message_types_by_name[
+    "SetNodePoolManagementRequest"
+] = _SETNODEPOOLMANAGEMENTREQUEST
+DESCRIPTOR.message_types_by_name["SetNodePoolSizeRequest"] = _SETNODEPOOLSIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RollbackNodePoolUpgradeRequest"
+] = _ROLLBACKNODEPOOLUPGRADEREQUEST
+DESCRIPTOR.message_types_by_name["ListNodePoolsResponse"] = _LISTNODEPOOLSRESPONSE
+DESCRIPTOR.message_types_by_name["ClusterAutoscaling"] = _CLUSTERAUTOSCALING
+DESCRIPTOR.message_types_by_name["ResourceLimit"] = _RESOURCELIMIT
+DESCRIPTOR.message_types_by_name["NodePoolAutoscaling"] = _NODEPOOLAUTOSCALING
+DESCRIPTOR.message_types_by_name["SetLabelsRequest"] = _SETLABELSREQUEST
+DESCRIPTOR.message_types_by_name["SetLegacyAbacRequest"] = _SETLEGACYABACREQUEST
+DESCRIPTOR.message_types_by_name["StartIPRotationRequest"] = _STARTIPROTATIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CompleteIPRotationRequest"
+] = _COMPLETEIPROTATIONREQUEST
+DESCRIPTOR.message_types_by_name["AcceleratorConfig"] = _ACCELERATORCONFIG
+DESCRIPTOR.message_types_by_name["WorkloadMetadataConfig"] = _WORKLOADMETADATACONFIG
+DESCRIPTOR.message_types_by_name["SetNetworkPolicyRequest"] = _SETNETWORKPOLICYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SetMaintenancePolicyRequest"
+] = _SETMAINTENANCEPOLICYREQUEST
+DESCRIPTOR.message_types_by_name["ListLocationsRequest"] = _LISTLOCATIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListLocationsResponse"] = _LISTLOCATIONSRESPONSE
+DESCRIPTOR.message_types_by_name["Location"] = _LOCATION
+DESCRIPTOR.message_types_by_name["StatusCondition"] = _STATUSCONDITION
+DESCRIPTOR.message_types_by_name["NetworkConfig"] = _NETWORKCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ListUsableSubnetworksRequest"
+] = _LISTUSABLESUBNETWORKSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListUsableSubnetworksResponse"
+] = _LISTUSABLESUBNETWORKSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "UsableSubnetworkSecondaryRange"
+] = _USABLESUBNETWORKSECONDARYRANGE
+DESCRIPTOR.message_types_by_name["UsableSubnetwork"] = _USABLESUBNETWORK
+DESCRIPTOR.message_types_by_name["VerticalPodAutoscaling"] = _VERTICALPODAUTOSCALING
+DESCRIPTOR.message_types_by_name["MaxPodsConstraint"] = _MAXPODSCONSTRAINT
+DESCRIPTOR.message_types_by_name[
+    "ResourceUsageExportConfig"
+] = _RESOURCEUSAGEEXPORTCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+NodeConfig = _reflection.GeneratedProtocolMessageType(
+    "NodeConfig",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_NODECONFIG_METADATAENTRY,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodeConfig.MetadataEntry)
+            ),
+        ),
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_NODECONFIG_LABELSENTRY,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodeConfig.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_NODECONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Parameters that describe the nodes in a cluster.
+  
+  
+  Attributes:
+      machine_type:
+          The name of a Google Compute Engine `machine type
+          </compute/docs/machine-types>`__ (e.g. ``n1-standard-1``).  If
+          unspecified, the default machine type is ``n1-standard-1``.
+      disk_size_gb:
+          Size of the disk attached to each node, specified in GB. The
+          smallest allowed disk size is 10GB.  If unspecified, the
+          default disk size is 100GB.
+      oauth_scopes:
+          The set of Google API scopes to be made available on all of
+          the node VMs under the "default" service account.  The
+          following scopes are recommended, but not required, and by
+          default are not included:  -
+          ``https://www.googleapis.com/auth/compute`` is required for
+          mounting    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/>`__).  If
+          unspecified, no scopes are added, unless Cloud Logging or
+          Cloud Monitoring are enabled, in which case their required
+          scopes will be added.
+      service_account:
+          The Google Cloud Platform Service Account to be used by the
+          node VMs. If no Service Account is specified, the "default"
+          service account is used.
+      metadata:
+          The metadata key/value pairs assigned to instances in the
+          cluster.  Keys must conform to the regexp [a-zA-Z0-9-\_]+ and
+          be less than 128 bytes in length. These are reflected as part
+          of a URL in the metadata server. Additionally, to avoid
+          ambiguity, keys must not conflict with any other metadata keys
+          for the project or be one of the reserved keys: "cluster-
+          location" "cluster-name" "cluster-uid" "configure-sh" "enable-
+          oslogin" "gci-ensure-gke-docker" "gci-update-strategy"
+          "instance-template" "kube-env" "startup-script" "user-data"
+          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.  The total size of all keys and
+          values must be less than 512 KB.
+      image_type:
+          The image type to use for this node. Note that for a given
+          image type, the latest version of it will be used.
+      labels:
+          The map of Kubernetes labels (key/value pairs) to be applied
+          to each node. These will added in addition to any default
+          label(s) that Kubernetes may apply to the node. In case of
+          conflict in label keys, the applied set may differ depending
+          on the Kubernetes version -- it's best to assume the behavior
+          is undefined and conflicts should be avoided. For more
+          information, including usage and the valid values, see:
+          https://kubernetes.io/docs/concepts/overview/working-with-
+          objects/labels/
+      local_ssd_count:
+          The number of local SSD disks to be attached to the node.  The
+          limit for this value is dependant 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 for more information.
+      tags:
+          The list of instance tags applied to all nodes. Tags are used
+          to identify valid sources or targets for network firewalls and
+          are specified by the client during cluster or node pool
+          creation. Each tag within the list must comply with RFC1035.
+      preemptible:
+          Whether the nodes are created as preemptible VM instances.
+          See:
+          https://cloud.google.com/compute/docs/instances/preemptible
+          for more inforamtion about preemptible VM instances.
+      accelerators:
+          A list of hardware accelerators to be attached to each node.
+          See https://cloud.google.com/compute/docs/gpus for more
+          information about support for GPUs.
+      disk_type:
+          Type of the disk attached to each node (e.g. 'pd-standard' or
+          'pd-ssd')  If unspecified, the default disk type is 'pd-
+          standard'
+      min_cpu_platform:
+          Minimum CPU platform to be used by this instance. The instance
+          may be scheduled on the specified or newer CPU platform.
+          Applicable values are the friendly names of CPU platforms,
+          such as minCpuPlatform: "Intel Haswell" or 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>`__
+      workload_metadata_config:
+          The workload metadata configuration for this node.
+      taints:
+          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/
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodeConfig)
+    ),
+)
+_sym_db.RegisterMessage(NodeConfig)
+_sym_db.RegisterMessage(NodeConfig.MetadataEntry)
+_sym_db.RegisterMessage(NodeConfig.LabelsEntry)
+
+NodeTaint = _reflection.GeneratedProtocolMessageType(
+    "NodeTaint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODETAINT,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""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/
+  
+  
+  Attributes:
+      key:
+          Key for taint.
+      value:
+          Value for taint.
+      effect:
+          Effect for taint.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodeTaint)
+    ),
+)
+_sym_db.RegisterMessage(NodeTaint)
+
+MasterAuth = _reflection.GeneratedProtocolMessageType(
+    "MasterAuth",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MASTERAUTH,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""The authentication information for accessing the master endpoint.
+  Authentication can be done using HTTP basic auth or using client
+  certificates.
+  
+  
+  Attributes:
+      username:
+          The username to use for HTTP basic authentication to the
+          master endpoint. For clusters v1.6.0 and later, basic
+          authentication can be disabled by leaving username unspecified
+          (or setting it to the empty string).
+      password:
+          The password to use for HTTP basic authentication to the
+          master endpoint. Because the master endpoint is open to the
+          Internet, you should create a strong password. If a password
+          is provided for cluster creation, username must be non-empty.
+      client_certificate_config:
+          Configuration for client certificate authentication on the
+          cluster. For clusters before v1.12, if no configuration is
+          specified, a client certificate is issued.
+      cluster_ca_certificate:
+          [Output only] Base64-encoded public certificate that is the
+          root of trust for the cluster.
+      client_certificate:
+          [Output only] Base64-encoded public certificate used by
+          clients to authenticate to the cluster endpoint.
+      client_key:
+          [Output only] Base64-encoded private key used by clients to
+          authenticate to the cluster endpoint.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.MasterAuth)
+    ),
+)
+_sym_db.RegisterMessage(MasterAuth)
+
+ClientCertificateConfig = _reflection.GeneratedProtocolMessageType(
+    "ClientCertificateConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLIENTCERTIFICATECONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for client certificates on the cluster.
+  
+  
+  Attributes:
+      issue_client_certificate:
+          Issue a client certificate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ClientCertificateConfig)
+    ),
+)
+_sym_db.RegisterMessage(ClientCertificateConfig)
+
+AddonsConfig = _reflection.GeneratedProtocolMessageType(
+    "AddonsConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDONSCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the addons that can be automatically spun up in the
+  cluster, enabling additional functionality.
+  
+  
+  Attributes:
+      http_load_balancing:
+          Configuration for the HTTP (L7) load balancing controller
+          addon, which makes it easy to set up HTTP load balancers for
+          services in a cluster.
+      horizontal_pod_autoscaling:
+          Configuration for the horizontal pod autoscaling feature,
+          which increases or decreases the number of replica pods a
+          replication controller has based on the resource usage of the
+          existing pods.
+      kubernetes_dashboard:
+          Configuration for the Kubernetes Dashboard.
+      network_policy_config:
+          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.
+      istio_config:
+          Configuration for Istio, an open platform to connect, manage,
+          and secure microservices.
+      cloud_run_config:
+          Configuration for the Cloud Run addon. The ``IstioConfig``
+          addon must be enabled in order to enable Cloud Run addon. This
+          option can only be enabled at cluster creation time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.AddonsConfig)
+    ),
+)
+_sym_db.RegisterMessage(AddonsConfig)
+
+HttpLoadBalancing = _reflection.GeneratedProtocolMessageType(
+    "HttpLoadBalancing",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HTTPLOADBALANCING,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the HTTP (L7) load balancing controller addon,
+  which makes it easy to set up HTTP load balancers for services in a
+  cluster.
+  
+  
+  Attributes:
+      disabled:
+          Whether the HTTP Load Balancing controller is enabled in the
+          cluster. When enabled, it runs a small pod in the cluster that
+          manages the load balancers.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.HttpLoadBalancing)
+    ),
+)
+_sym_db.RegisterMessage(HttpLoadBalancing)
+
+HorizontalPodAutoscaling = _reflection.GeneratedProtocolMessageType(
+    "HorizontalPodAutoscaling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HORIZONTALPODAUTOSCALING,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the horizontal pod autoscaling feature, which
+  increases or decreases the number of replica pods a replication
+  controller has based on the resource usage of the existing pods.
+  
+  
+  Attributes:
+      disabled:
+          Whether the Horizontal Pod Autoscaling feature is enabled in
+          the cluster. When enabled, it ensures that a Heapster pod is
+          running in the cluster, which is also used by the Cloud
+          Monitoring service.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.HorizontalPodAutoscaling)
+    ),
+)
+_sym_db.RegisterMessage(HorizontalPodAutoscaling)
+
+KubernetesDashboard = _reflection.GeneratedProtocolMessageType(
+    "KubernetesDashboard",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KUBERNETESDASHBOARD,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the Kubernetes Dashboard.
+  
+  
+  Attributes:
+      disabled:
+          Whether the Kubernetes Dashboard is enabled for this cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.KubernetesDashboard)
+    ),
+)
+_sym_db.RegisterMessage(KubernetesDashboard)
+
+NetworkPolicyConfig = _reflection.GeneratedProtocolMessageType(
+    "NetworkPolicyConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NETWORKPOLICYCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      disabled:
+          Whether NetworkPolicy is enabled for this cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NetworkPolicyConfig)
+    ),
+)
+_sym_db.RegisterMessage(NetworkPolicyConfig)
+
+PrivateClusterConfig = _reflection.GeneratedProtocolMessageType(
+    "PrivateClusterConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRIVATECLUSTERCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for private clusters.
+  
+  
+  Attributes:
+      enable_private_nodes:
+          Whether nodes have internal IP addresses only. If enabled, all
+          nodes are given only RFC 1918 private addresses and
+          communicate with the master via private networking.
+      enable_private_endpoint:
+          Whether the master's internal IP address is used as the
+          cluster endpoint.
+      master_ipv4_cidr_block:
+          The IP range in CIDR notation to use for the hosted master
+          network. This range will be used for assigning internal IP
+          addresses to the master or set of masters, as well as the ILB
+          VIP. This range must not overlap with any other ranges in use
+          within the cluster's network.
+      private_endpoint:
+          Output only. The internal IP address of this cluster's master
+          endpoint.
+      public_endpoint:
+          Output only. The external IP address of this cluster's master
+          endpoint.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.PrivateClusterConfig)
+    ),
+)
+_sym_db.RegisterMessage(PrivateClusterConfig)
+
+IstioConfig = _reflection.GeneratedProtocolMessageType(
+    "IstioConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ISTIOCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for Istio addon.
+  
+  
+  Attributes:
+      disabled:
+          Whether Istio is enabled for this cluster.
+      auth:
+          The specified Istio auth mode, either none, or mutual TLS.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.IstioConfig)
+    ),
+)
+_sym_db.RegisterMessage(IstioConfig)
+
+CloudRunConfig = _reflection.GeneratedProtocolMessageType(
+    "CloudRunConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLOUDRUNCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the Cloud Run feature.
+  
+  
+  Attributes:
+      disabled:
+          Whether Cloud Run addon is enabled for this cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.CloudRunConfig)
+    ),
+)
+_sym_db.RegisterMessage(CloudRunConfig)
+
+MasterAuthorizedNetworksConfig = _reflection.GeneratedProtocolMessageType(
+    "MasterAuthorizedNetworksConfig",
+    (_message.Message,),
+    dict(
+        CidrBlock=_reflection.GeneratedProtocolMessageType(
+            "CidrBlock",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MASTERAUTHORIZEDNETWORKSCONFIG_CIDRBLOCK,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+                __doc__="""CidrBlock contains an optional name and one CIDR block.
+    
+    
+    Attributes:
+        display_name:
+            display\_name is an optional field for users to identify CIDR
+            blocks.
+        cidr_block:
+            cidr\_block must be specified in CIDR notation.
+    """,
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.MasterAuthorizedNetworksConfig.CidrBlock)
+            ),
+        ),
+        DESCRIPTOR=_MASTERAUTHORIZEDNETWORKSCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""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, Google Compute Engine Public IPs and Google Prod IPs.
+  
+  
+  Attributes:
+      enabled:
+          Whether or not master authorized networks is enabled.
+      cidr_blocks:
+          cidr\_blocks define up to 10 external networks that could
+          access Kubernetes master through HTTPS.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.MasterAuthorizedNetworksConfig)
+    ),
+)
+_sym_db.RegisterMessage(MasterAuthorizedNetworksConfig)
+_sym_db.RegisterMessage(MasterAuthorizedNetworksConfig.CidrBlock)
+
+LegacyAbac = _reflection.GeneratedProtocolMessageType(
+    "LegacyAbac",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LEGACYABAC,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the legacy Attribute Based Access Control
+  authorization mode.
+  
+  
+  Attributes:
+      enabled:
+          Whether the ABAC authorizer is enabled for this cluster. When
+          enabled, identities in the system, including service accounts,
+          nodes, and controllers, will have statically granted
+          permissions beyond those provided by the RBAC configuration or
+          IAM.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.LegacyAbac)
+    ),
+)
+_sym_db.RegisterMessage(LegacyAbac)
+
+NetworkPolicy = _reflection.GeneratedProtocolMessageType(
+    "NetworkPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NETWORKPOLICY,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration options for the NetworkPolicy feature.
+  https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+  
+  
+  Attributes:
+      provider:
+          The selected network policy provider.
+      enabled:
+          Whether network policy is enabled on the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NetworkPolicy)
+    ),
+)
+_sym_db.RegisterMessage(NetworkPolicy)
+
+IPAllocationPolicy = _reflection.GeneratedProtocolMessageType(
+    "IPAllocationPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IPALLOCATIONPOLICY,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for controlling how IPs are allocated in the cluster.
+  
+  
+  Attributes:
+      use_ip_aliases:
+          Whether alias IPs will be used for pod IPs in the cluster.
+      create_subnetwork:
+          Whether a new subnetwork will be created automatically for the
+          cluster.  This field is only applicable when
+          ``use_ip_aliases`` is true.
+      subnetwork_name:
+          A custom subnetwork name to be used if ``create_subnetwork``
+          is true. If this field is empty, then an automatic name will
+          be chosen for the new subnetwork.
+      cluster_ipv4_cidr:
+          This field is deprecated, use cluster\_ipv4\_cidr\_block.
+      node_ipv4_cidr:
+          This field is deprecated, use node\_ipv4\_cidr\_block.
+      services_ipv4_cidr:
+          This field is deprecated, use services\_ipv4\_cidr\_block.
+      cluster_secondary_range_name:
+          The name of the secondary range to be used for the cluster
+          CIDR block. The secondary range will be used for pod IP
+          addresses. This must be an existing secondary range associated
+          with the cluster subnetwork.  This field is only applicable
+          with use\_ip\_aliases and create\_subnetwork is false.
+      services_secondary_range_name:
+          The name of the secondary range to be used as for the services
+          CIDR block. The secondary range will be used for service
+          ClusterIPs. This must be an existing secondary range
+          associated with the cluster subnetwork.  This field is only
+          applicable with use\_ip\_aliases and create\_subnetwork is
+          false.
+      cluster_ipv4_cidr_block:
+          The IP address range for the cluster pod IPs. If this field is
+          set, then ``cluster.cluster_ipv4_cidr`` must be left blank.
+          This field is only applicable when ``use_ip_aliases`` is true.
+          Set to blank to have a range chosen with 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.
+      node_ipv4_cidr_block:
+          The IP address range of the instance IPs in this cluster.
+          This is applicable only if ``create_subnetwork`` is true.  Set
+          to blank to have a range chosen with 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.
+      services_ipv4_cidr_block:
+          The IP address range of the services IPs in this cluster. If
+          blank, a range will be automatically chosen with the default
+          size.  This field is only applicable when ``use_ip_aliases``
+          is true.  Set to blank to have a range chosen with 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.
+      allow_route_overlap:
+          If true, allow allocation of cluster CIDR ranges that overlap
+          with certain kinds of network routes. By default we do not
+          allow cluster CIDR ranges to intersect with any user declared
+          routes. With allow\_route\_overlap == true, we allow
+          overlapping with CIDR ranges that are larger than the cluster
+          CIDR range.  If this field is set to true, then cluster and
+          services CIDRs must be fully-specified (e.g. ``10.96.0.0/14``,
+          but not ``/14``), which means: 1) When ``use_ip_aliases`` is
+          true, ``cluster_ipv4_cidr_block`` and
+          ``services_ipv4_cidr_block`` must be fully-specified. 2) When
+          ``use_ip_aliases`` is false, ``cluster.cluster_ipv4_cidr``
+          muse be fully-specified.
+      tpu_ipv4_cidr_block:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.IPAllocationPolicy)
+    ),
+)
+_sym_db.RegisterMessage(IPAllocationPolicy)
+
+BinaryAuthorization = _reflection.GeneratedProtocolMessageType(
+    "BinaryAuthorization",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BINARYAUTHORIZATION,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for Binary Authorization.
+  
+  
+  Attributes:
+      enabled:
+          Enable Binary Authorization for this cluster. If enabled, all
+          container images will be validated by Google Binauthz.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.BinaryAuthorization)
+    ),
+)
+_sym_db.RegisterMessage(BinaryAuthorization)
+
+PodSecurityPolicyConfig = _reflection.GeneratedProtocolMessageType(
+    "PodSecurityPolicyConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PODSECURITYPOLICYCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for the PodSecurityPolicy feature.
+  
+  
+  Attributes:
+      enabled:
+          Enable the PodSecurityPolicy controller for this cluster. If
+          enabled, pods must be valid under a PodSecurityPolicy to be
+          created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.PodSecurityPolicyConfig)
+    ),
+)
+_sym_db.RegisterMessage(PodSecurityPolicyConfig)
+
+Cluster = _reflection.GeneratedProtocolMessageType(
+    "Cluster",
+    (_message.Message,),
+    dict(
+        ResourceLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ResourceLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTER_RESOURCELABELSENTRY,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.Cluster.ResourceLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTER,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""A Google Kubernetes Engine cluster.
+  
+  
+  Attributes:
+      name:
+          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:  -  Lowercase letters, numbers, and
+          hyphens only. -  Must start with a letter. -  Must end with a
+          number or a letter.
+      description:
+          An optional description of this cluster.
+      initial_node_count:
+          The number of nodes to create in this cluster. You must ensure
+          that your Compute Engine resource quota is sufficient for this
+          number of instances. You must also have available firewall and
+          routes quota. For requests, this field should only be used in
+          lieu of a "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.
+      node_config:
+          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.
+          If unspecified, the defaults are used.
+      master_auth:
+          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.
+      logging_service:
+          The logging service the cluster should use to write logs.
+          Currently available options:  -  ``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.
+      monitoring_service:
+          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. -  if left as an empty string,
+          ``monitoring.googleapis.com`` will be    used.
+      network:
+          The name of the Google Compute Engine `network
+          </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.
+      cluster_ipv4_cidr:
+          The IP address range of the container pods in this cluster, in
+          `CIDR <http://en.wikipedia.org/wiki/Classless_Inter-
+          Domain_Routing>`__ notation (e.g. ``10.96.0.0/14``). Leave
+          blank to have one automatically chosen or specify a ``/14``
+          block in ``10.0.0.0/8``.
+      addons_config:
+          Configurations for the various addons available to run in the
+          cluster.
+      subnetwork:
+          The name of the Google Compute Engine `subnetwork
+          </compute/docs/subnetworks>`__ to which the cluster is
+          connected. On output this shows the subnetwork ID instead of
+          the name.
+      node_pools:
+          The node pools associated with this cluster. This field should
+          not be set if "node\_config" or "initial\_node\_count" are
+          specified.
+      locations:
+          The list of Google Compute Engine `zones
+          </compute/docs/zones#available>`__ in which the cluster's
+          nodes should be located.
+      enable_kubernetes_alpha:
+          Kubernetes alpha features are enabled on this cluster. This
+          includes alpha API groups (e.g. v1beta1) and features that may
+          not be production ready in the kubernetes version of the
+          master and nodes. The cluster has no SLA for uptime and
+          master/node upgrades are disabled. Alpha enabled clusters are
+          automatically deleted thirty days after creation.
+      resource_labels:
+          The resource labels for the cluster to use to annotate any
+          related Google Compute Engine resources.
+      label_fingerprint:
+          The fingerprint of the set of labels for this cluster.
+      legacy_abac:
+          Configuration for the legacy ABAC authorization mode.
+      network_policy:
+          Configuration options for the NetworkPolicy feature.
+      ip_allocation_policy:
+          Configuration for cluster IP allocation.
+      master_authorized_networks_config:
+          The configuration options for master authorized networks
+          feature.
+      maintenance_policy:
+          Configure the maintenance policy for this cluster.
+      binary_authorization:
+          Configuration for Binary Authorization.
+      pod_security_policy_config:
+          Configuration for the PodSecurityPolicy feature.
+      autoscaling:
+          Cluster-level autoscaling configuration.
+      network_config:
+          Configuration for cluster networking.
+      private_cluster:
+          If this is a private cluster setup. Private clusters are
+          clusters that, by default have no external IP addresses on the
+          nodes and where nodes and the master communicate over private
+          IP addresses. This field is deprecated, use
+          private\_cluster\_config.enable\_private\_nodes instead.
+      master_ipv4_cidr_block:
+          The IP prefix in CIDR notation to use for the hosted master
+          network. This prefix will be used for assigning private IP
+          addresses to the master or set of masters, as well as the ILB
+          VIP. This field is deprecated, use
+          private\_cluster\_config.master\_ipv4\_cidr\_block instead.
+      default_max_pods_constraint:
+          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.
+      resource_usage_export_config:
+          Configuration for exporting resource usages. Resource usage
+          export is disabled when this config unspecified.
+      private_cluster_config:
+          Configuration for private cluster.
+      vertical_pod_autoscaling:
+          Cluster-level Vertical Pod Autoscaling configuration.
+      self_link:
+          [Output only] Server-defined URL for the resource.
+      zone:
+          [Output only] The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field is deprecated, use location instead.
+      endpoint:
+          [Output only] The IP address of this cluster's master
+          endpoint. The endpoint can be accessed from the internet at
+          ``https://username:password@endpoint/``.  See the
+          ``masterAuth`` property of this resource for username and
+          password information.
+      initial_cluster_version:
+          The initial Kubernetes version for this cluster. Valid
+          versions are those found in validMasterVersions returned by
+          getServerConfig. The version can be upgraded over time; such
+          upgrades are reflected in currentMasterVersion and
+          currentNodeVersion.  Users may specify either explicit
+          versions offered by Kubernetes Engine or version aliases,
+          which have the following behavior:  -  "latest": picks the
+          highest valid Kubernetes version -  "1.X": picks the highest
+          valid patch+gke.N patch in the 1.X version -  "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
+      current_master_version:
+          [Output only] The current software version of the master
+          endpoint.
+      current_node_version:
+          [Output only] Deprecated, use `NodePool.version </kubernetes-e
+          ngine/docs/reference/rest/v1beta1/projects.zones.clusters.node
+          Pool>`__ 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.
+      create_time:
+          [Output only] The time the cluster was created, in `RFC3339
+          <https://www.ietf.org/rfc/rfc3339.txt>`__ text format.
+      status:
+          [Output only] The current status of this cluster.
+      status_message:
+          [Output only] Additional information about the current status
+          of this cluster, if available.
+      node_ipv4_cidr_size:
+          [Output only] The size of the address space on each node for
+          hosting containers. This is provisioned from within the
+          ``container_ipv4_cidr`` range.
+      services_ipv4_cidr:
+          [Output only] The IP address range of the Kubernetes services
+          in this cluster, in `CIDR
+          <http://en.wikipedia.org/wiki/Classless_Inter-
+          Domain_Routing>`__ notation (e.g. ``1.2.3.4/29``). Service
+          addresses are typically put in the last ``/16`` from the
+          container CIDR.
+      instance_group_urls:
+          Deprecated. Use node\_pools.instance\_group\_urls.
+      current_node_count:
+          [Output only] The number of nodes currently in the cluster.
+          Deprecated. Call Kubernetes API directly to retrieve node
+          information.
+      expire_time:
+          [Output only] The time the cluster will be automatically
+          deleted in `RFC3339 <https://www.ietf.org/rfc/rfc3339.txt>`__
+          text format.
+      location:
+          [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 the cluster resides.
+      enable_tpu:
+          Enable the ability to use Cloud TPUs in this cluster.
+      tpu_ipv4_cidr_block:
+          [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``).
+      conditions:
+          Which conditions caused the current cluster state.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.Cluster)
+    ),
+)
+_sym_db.RegisterMessage(Cluster)
+_sym_db.RegisterMessage(Cluster.ResourceLabelsEntry)
+
+ClusterUpdate = _reflection.GeneratedProtocolMessageType(
+    "ClusterUpdate",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERUPDATE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ClusterUpdate describes an update to the cluster. Exactly one update can
+  be applied to a cluster with each request, so at most one field can be
+  provided.
+  
+  
+  Attributes:
+      desired_node_version:
+          The Kubernetes version to change the nodes to (typically an
+          upgrade).  Users may specify either explicit versions offered
+          by Kubernetes Engine or version aliases, which have the
+          following behavior:  -  "latest": picks the highest valid
+          Kubernetes version -  "1.X": picks the highest valid
+          patch+gke.N patch in the 1.X version -  "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
+      desired_monitoring_service:
+          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 in
+          Stackdriver -  "monitoring.googleapis.com" - the Google Cloud
+          Monitoring service -  "none" - no metrics will be exported
+          from the cluster
+      desired_addons_config:
+          Configurations for the various addons available to run in the
+          cluster.
+      desired_node_pool_id:
+          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_image_type:
+          The desired image type for the node pool. NOTE: Set the
+          "desired\_node\_pool" field as well.
+      desired_node_pool_autoscaling:
+          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 the
+          change applies to that single node pool.
+      desired_locations:
+          The desired list of Google Compute Engine `zones
+          </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.
+      desired_master_authorized_networks_config:
+          The desired configuration options for master authorized
+          networks feature.
+      desired_pod_security_policy_config:
+          The desired configuration options for the PodSecurityPolicy
+          feature.
+      desired_cluster_autoscaling:
+          Cluster-level autoscaling configuration.
+      desired_binary_authorization:
+          The desired configuration options for the Binary Authorization
+          feature.
+      desired_logging_service:
+          The logging service the cluster should use to write metrics.
+          Currently available options:  -
+          "logging.googleapis.com/kubernetes" - the Google Cloud Logging
+          service with Kubernetes-native resource model in Stackdriver -
+          "logging.googleapis.com" - the Google Cloud Logging service -
+          "none" - no logs will be exported from the cluster
+      desired_resource_usage_export_config:
+          The desired configuration for exporting resource usage.
+      desired_vertical_pod_autoscaling:
+          Cluster-level Vertical Pod Autoscaling configuration.
+      desired_master_version:
+          The Kubernetes version to change the master to. The only valid
+          value is the latest supported version.  Users may specify
+          either explicit versions offered by Kubernetes Engine or
+          version aliases, which have the following behavior:  -
+          "latest": picks the highest valid Kubernetes version -  "1.X":
+          picks the highest valid patch+gke.N patch in the 1.X version -
+          "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
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ClusterUpdate)
+    ),
+)
+_sym_db.RegisterMessage(ClusterUpdate)
+
+Operation = _reflection.GeneratedProtocolMessageType(
+    "Operation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATION,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""This operation resource represents operations that may have happened or
+  are happening on the cluster. All fields are output only.
+  
+  
+  Attributes:
+      name:
+          The server-assigned ID for the operation.
+      zone:
+          The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the operation is
+          taking place. This field is deprecated, use location instead.
+      operation_type:
+          The operation type.
+      status:
+          The current status of the operation.
+      detail:
+          Detailed operation progress, if available.
+      status_message:
+          If an error has occurred, a textual description of the error.
+      self_link:
+          Server-defined URL for the resource.
+      target_link:
+          Server-defined URL for the target of the operation.
+      location:
+          [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 the cluster resides.
+      start_time:
+          [Output only] The time the operation started, in `RFC3339
+          <https://www.ietf.org/rfc/rfc3339.txt>`__ text format.
+      end_time:
+          [Output only] The time the operation completed, in `RFC3339
+          <https://www.ietf.org/rfc/rfc3339.txt>`__ text format.
+      progress:
+          [Output only] Progress information for an operation.
+      cluster_conditions:
+          Which conditions caused the current cluster state.
+      nodepool_conditions:
+          Which conditions caused the current node pool state.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.Operation)
+    ),
+)
+_sym_db.RegisterMessage(Operation)
+
+OperationProgress = _reflection.GeneratedProtocolMessageType(
+    "OperationProgress",
+    (_message.Message,),
+    dict(
+        Metric=_reflection.GeneratedProtocolMessageType(
+            "Metric",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_OPERATIONPROGRESS_METRIC,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+                __doc__="""Progress metric is (string, int\|float\|string) pair.
+    
+    
+    Attributes:
+        name:
+            Metric name, required. e.g., "nodes total", "percent done"
+        value:
+            Strictly one of the values is required.
+        int_value:
+            For metrics with integer value.
+        double_value:
+            For metrics with floating point value.
+        string_value:
+            For metrics with custom values (ratios, visual progress,
+            etc.).
+    """,
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.OperationProgress.Metric)
+            ),
+        ),
+        DESCRIPTOR=_OPERATIONPROGRESS,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Information about operation (or operation stage) progress.
+  
+  
+  Attributes:
+      name:
+          A non-parameterized string describing an operation stage.
+          Unset for single-stage operations.
+      status:
+          Status of an operation stage. Unset for single-stage
+          operations.
+      metrics:
+          Progress metric bundle, for example: metrics: [{name: "nodes
+          done", int\_value: 15}, {name: "nodes total", int\_value: 32}]
+          or metrics: [{name: "progress", double\_value: 0.56}, {name:
+          "progress scale", double\_value: 1.0}]
+      stages:
+          Substages of an operation or a stage.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.OperationProgress)
+    ),
+)
+_sym_db.RegisterMessage(OperationProgress)
+_sym_db.RegisterMessage(OperationProgress.Metric)
+
+CreateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLUSTERREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""CreateClusterRequest creates a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          parent field.
+      cluster:
+          A `cluster resource </container-
+          engine/reference/rest/v1beta1/projects.zones.clusters>`__
+      parent:
+          The parent (project and location) where the cluster will be
+          created. Specified in the format 'projects/*/locations/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.CreateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateClusterRequest)
+
+GetClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "GetClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCLUSTERREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""GetClusterRequest gets the settings of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to retrieve. This field
+          has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster) of the cluster to
+          retrieve. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.GetClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetClusterRequest)
+
+UpdateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECLUSTERREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""UpdateClusterRequest updates the settings of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      update:
+          A description of the update.
+      name:
+          The name (project, location, cluster) of the cluster to
+          update. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.UpdateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateClusterRequest)
+
+UpdateNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATENODEPOOLREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolVersionRequest updates the version of a node pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to upgrade. This field
+          has been deprecated and replaced by the name field.
+      node_version:
+          The Kubernetes version to change the nodes to (typically an
+          upgrade).  Users may specify either explicit versions offered
+          by Kubernetes Engine or version aliases, which have the
+          following behavior:  -  "latest": picks the highest valid
+          Kubernetes version -  "1.X": picks the highest valid
+          patch+gke.N patch in the 1.X version -  "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
+      image_type:
+          The desired image type for the node pool.
+      name:
+          The name (project, location, cluster, node pool) of the node
+          pool to update. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.UpdateNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateNodePoolRequest)
+
+SetNodePoolAutoscalingRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNodePoolAutoscalingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNODEPOOLAUTOSCALINGREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolAutoscalingRequest sets the autoscaler settings of a node
+  pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to upgrade. This field
+          has been deprecated and replaced by the name field.
+      autoscaling:
+          Autoscaling configuration for the node pool.
+      name:
+          The name (project, location, cluster, node pool) of the node
+          pool to set autoscaler settings. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetNodePoolAutoscalingRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNodePoolAutoscalingRequest)
+
+SetLoggingServiceRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLoggingServiceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETLOGGINGSERVICEREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetLoggingServiceRequest sets the logging service of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      logging_service:
+          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
+      name:
+          The name (project, location, cluster) of the cluster to set
+          logging. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetLoggingServiceRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLoggingServiceRequest)
+
+SetMonitoringServiceRequest = _reflection.GeneratedProtocolMessageType(
+    "SetMonitoringServiceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETMONITORINGSERVICEREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetMonitoringServiceRequest sets the monitoring service of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      monitoring_service:
+          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
+      name:
+          The name (project, location, cluster) of the cluster to set
+          monitoring. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetMonitoringServiceRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetMonitoringServiceRequest)
+
+SetAddonsConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "SetAddonsConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETADDONSCONFIGREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetAddonsRequest sets the addons associated with the cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      addons_config:
+          The desired configurations for the various addons available to
+          run in the cluster.
+      name:
+          The name (project, location, cluster) of the cluster to set
+          addons. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetAddonsConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetAddonsConfigRequest)
+
+SetLocationsRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLocationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETLOCATIONSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetLocationsRequest sets the locations of the cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      locations:
+          The desired list of Google Compute Engine `zones
+          </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.
+      name:
+          The name (project, location, cluster) of the cluster to set
+          locations. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetLocationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLocationsRequest)
+
+UpdateMasterRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateMasterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEMASTERREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""UpdateMasterRequest updates the master of the cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      master_version:
+          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:  -
+          "latest": picks the highest valid Kubernetes version -  "1.X":
+          picks the highest valid patch+gke.N patch in the 1.X version -
+          "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
+      name:
+          The name (project, location, cluster) of the cluster to
+          update. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.UpdateMasterRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateMasterRequest)
+
+SetMasterAuthRequest = _reflection.GeneratedProtocolMessageType(
+    "SetMasterAuthRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETMASTERAUTHREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetMasterAuthRequest updates the admin password of a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to upgrade. This field has
+          been deprecated and replaced by the name field.
+      action:
+          The exact form of action to be taken on the master auth.
+      update:
+          A description of the update.
+      name:
+          The name (project, location, cluster) of the cluster to set
+          auth. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetMasterAuthRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetMasterAuthRequest)
+
+DeleteClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETECLUSTERREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""DeleteClusterRequest deletes a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to delete. This field has
+          been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster) of the cluster to
+          delete. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.DeleteClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteClusterRequest)
+
+ListClustersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListClustersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListClustersRequest lists clusters.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides, or "-" for all zones. This field has been deprecated
+          and replaced by the parent field.
+      parent:
+          The parent (project and location) where the clusters will be
+          listed. Specified in the format 'projects/*/locations/*'.
+          Location "-" matches all zones and all regions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListClustersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersRequest)
+
+ListClustersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListClustersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSRESPONSE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListClustersResponse is the result of ListClustersRequest.
+  
+  
+  Attributes:
+      clusters:
+          A list of clusters in the project in the specified zone, or
+          across all ones.
+      missing_zones:
+          If any zones are listed here, the list of clusters returned
+          may be missing those zones.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListClustersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersResponse)
+
+GetOperationRequest = _reflection.GeneratedProtocolMessageType(
+    "GetOperationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETOPERATIONREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""GetOperationRequest gets a single operation.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      operation_id:
+          Deprecated. The server-assigned ``name`` of the operation.
+          This field has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, operation id) of the operation to
+          get. Specified in the format
+          'projects/*/locations/*/operations/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.GetOperationRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetOperationRequest)
+
+ListOperationsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListOperationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTOPERATIONSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListOperationsRequest lists operations.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ to return operations for,
+          or ``-`` for all zones. This field has been deprecated and
+          replaced by the parent field.
+      parent:
+          The parent (project and location) where the operations will be
+          listed. Specified in the format 'projects/*/locations/*'.
+          Location "-" matches all zones and all regions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListOperationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListOperationsRequest)
+
+CancelOperationRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelOperationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELOPERATIONREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""CancelOperationRequest cancels a single operation.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the operation
+          resides. This field has been deprecated and replaced by the
+          name field.
+      operation_id:
+          Deprecated. The server-assigned ``name`` of the operation.
+          This field has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, operation id) of the operation to
+          cancel. Specified in the format
+          'projects/*/locations/*/operations/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.CancelOperationRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelOperationRequest)
+
+ListOperationsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListOperationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTOPERATIONSRESPONSE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListOperationsResponse is the result of ListOperationsRequest.
+  
+  
+  Attributes:
+      operations:
+          A list of operations in the project in the specified zone.
+      missing_zones:
+          If any zones are listed here, the list of operations returned
+          may be missing the operations from those zones.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListOperationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListOperationsResponse)
+
+GetServerConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetServerConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSERVERCONFIGREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Gets the current Kubernetes Engine service configuration.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ to return operations for.
+          This field has been deprecated and replaced by the name field.
+      name:
+          The name (project and location) of the server config to get
+          Specified in the format 'projects/*/locations/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.GetServerConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetServerConfigRequest)
+
+ServerConfig = _reflection.GeneratedProtocolMessageType(
+    "ServerConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SERVERCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Kubernetes Engine service configuration.
+  
+  
+  Attributes:
+      default_cluster_version:
+          Version of Kubernetes the service deploys by default.
+      valid_node_versions:
+          List of valid node upgrade target versions.
+      default_image_type:
+          Default image type.
+      valid_image_types:
+          List of valid image types.
+      valid_master_versions:
+          List of valid master versions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ServerConfig)
+    ),
+)
+_sym_db.RegisterMessage(ServerConfig)
+
+CreateNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATENODEPOOLREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""CreateNodePoolRequest creates a node pool for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          parent field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the parent field.
+      node_pool:
+          The node pool to create.
+      parent:
+          The parent (project, location, cluster id) where the node pool
+          will be created. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.CreateNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateNodePoolRequest)
+
+DeleteNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETENODEPOOLREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""DeleteNodePoolRequest deletes a node pool for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to delete. This field
+          has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to delete. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.DeleteNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteNodePoolRequest)
+
+ListNodePoolsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListNodePoolsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNODEPOOLSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListNodePoolsRequest lists the node pool(s) for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          parent field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the parent field.
+      parent:
+          The parent (project, location, cluster id) where the node
+          pools will be listed. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListNodePoolsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListNodePoolsRequest)
+
+GetNodePoolRequest = _reflection.GeneratedProtocolMessageType(
+    "GetNodePoolRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNODEPOOLREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""GetNodePoolRequest retrieves a node pool for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool. This field has been
+          deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to get. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.GetNodePoolRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetNodePoolRequest)
+
+NodePool = _reflection.GeneratedProtocolMessageType(
+    "NodePool",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEPOOL,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""NodePool contains the name and configuration for a cluster's node pool.
+  Node pools are a set of nodes (i.e. VM's), with a common configuration
+  and specification, under the control of the cluster master. They may
+  have a set of Kubernetes labels applied to them, which may be used to
+  reference them during pod scheduling. They may also be resized up or
+  down, to accommodate the workload.
+  
+  
+  Attributes:
+      name:
+          The name of the node pool.
+      config:
+          The node configuration of the pool.
+      initial_node_count:
+          The initial node count for the pool. You must ensure that your
+          Compute Engine resource quota is sufficient for this number of
+          instances. You must also have available firewall and routes
+          quota.
+      self_link:
+          [Output only] Server-defined URL for the resource.
+      version:
+          The version of the Kubernetes of this node.
+      instance_group_urls:
+          [Output only] The resource URLs of the `managed instance
+          groups </compute/docs/instance-groups/creating-groups-of-
+          managed-instances>`__ associated with this node pool.
+      status:
+          [Output only] The status of the nodes in this pool instance.
+      status_message:
+          [Output only] Additional information about the current status
+          of this node pool instance, if available.
+      autoscaling:
+          Autoscaler configuration for this NodePool. Autoscaler is
+          enabled only if a valid configuration is present.
+      management:
+          NodeManagement configuration for this NodePool.
+      max_pods_constraint:
+          The constraint on the maximum number of pods that can be run
+          simultaneously on a node in the node pool.
+      conditions:
+          Which conditions caused the current node pool state.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodePool)
+    ),
+)
+_sym_db.RegisterMessage(NodePool)
+
+NodeManagement = _reflection.GeneratedProtocolMessageType(
+    "NodeManagement",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEMANAGEMENT,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""NodeManagement defines the set of node management services turned on for
+  the node pool.
+  
+  
+  Attributes:
+      auto_upgrade:
+          Whether the nodes will be automatically upgraded.
+      auto_repair:
+          Whether the nodes will be automatically repaired.
+      upgrade_options:
+          Specifies the Auto Upgrade knobs for the node pool.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodeManagement)
+    ),
+)
+_sym_db.RegisterMessage(NodeManagement)
+
+AutoUpgradeOptions = _reflection.GeneratedProtocolMessageType(
+    "AutoUpgradeOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AUTOUPGRADEOPTIONS,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""AutoUpgradeOptions defines the set of options for the user to control
+  how the Auto Upgrades will proceed.
+  
+  
+  Attributes:
+      auto_upgrade_start_time:
+          [Output only] This field is set when upgrades are about to
+          commence with the approximate start time for the upgrades, in
+          `RFC3339 <https://www.ietf.org/rfc/rfc3339.txt>`__ text
+          format.
+      description:
+          [Output only] This field is set when upgrades are about to
+          commence with the description of the upgrade.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.AutoUpgradeOptions)
+    ),
+)
+_sym_db.RegisterMessage(AutoUpgradeOptions)
+
+MaintenancePolicy = _reflection.GeneratedProtocolMessageType(
+    "MaintenancePolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MAINTENANCEPOLICY,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""MaintenancePolicy defines the maintenance policy to be used for the
+  cluster.
+  
+  
+  Attributes:
+      window:
+          Specifies the maintenance window in which maintenance may be
+          performed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.MaintenancePolicy)
+    ),
+)
+_sym_db.RegisterMessage(MaintenancePolicy)
+
+MaintenanceWindow = _reflection.GeneratedProtocolMessageType(
+    "MaintenanceWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MAINTENANCEWINDOW,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""MaintenanceWindow defines the maintenance window to be used for the
+  cluster.
+  
+  
+  Attributes:
+      policy:
+          Unimplemented, reserved for future use.
+          HourlyMaintenanceWindow hourly\_maintenance\_window = 1;
+      daily_maintenance_window:
+          DailyMaintenanceWindow specifies a daily maintenance operation
+          window.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.MaintenanceWindow)
+    ),
+)
+_sym_db.RegisterMessage(MaintenanceWindow)
+
+DailyMaintenanceWindow = _reflection.GeneratedProtocolMessageType(
+    "DailyMaintenanceWindow",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DAILYMAINTENANCEWINDOW,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Time window specified for daily maintenance operations.
+  
+  
+  Attributes:
+      start_time:
+          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.
+      duration:
+          [Output only] Duration of the time window, automatically
+          chosen to be smallest possible in the given scenario.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.DailyMaintenanceWindow)
+    ),
+)
+_sym_db.RegisterMessage(DailyMaintenanceWindow)
+
+SetNodePoolManagementRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNodePoolManagementRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNODEPOOLMANAGEMENTREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolManagementRequest sets the node management properties of a
+  node pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to update. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to update. This field
+          has been deprecated and replaced by the name field.
+      management:
+          NodeManagement configuration for the node pool.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to set management properties. Specified in the
+          format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetNodePoolManagementRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNodePoolManagementRequest)
+
+SetNodePoolSizeRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNodePoolSizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNODEPOOLSIZEREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetNodePoolSizeRequest sets the size a node pool.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to update. This field has
+          been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to update. This field
+          has been deprecated and replaced by the name field.
+      node_count:
+          The desired node count for the pool.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node pool to set size. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetNodePoolSizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNodePoolSizeRequest)
+
+RollbackNodePoolUpgradeRequest = _reflection.GeneratedProtocolMessageType(
+    "RollbackNodePoolUpgradeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKNODEPOOLUPGRADEREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""RollbackNodePoolUpgradeRequest rollbacks the previously Aborted or
+  Failed NodePool upgrade. This will be an no-op if the last upgrade
+  successfully completed.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to rollback. This field
+          has been deprecated and replaced by the name field.
+      node_pool_id:
+          Deprecated. The name of the node pool to rollback. This field
+          has been deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster, node pool id) of the
+          node poll to rollback upgrade. Specified in the format
+          'projects/*/locations/*/clusters/*/nodePools/*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.RollbackNodePoolUpgradeRequest)
+    ),
+)
+_sym_db.RegisterMessage(RollbackNodePoolUpgradeRequest)
+
+ListNodePoolsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListNodePoolsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNODEPOOLSRESPONSE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListNodePoolsResponse is the result of ListNodePoolsRequest.
+  
+  
+  Attributes:
+      node_pools:
+          A list of node pools for a cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListNodePoolsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListNodePoolsResponse)
+
+ClusterAutoscaling = _reflection.GeneratedProtocolMessageType(
+    "ClusterAutoscaling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERAUTOSCALING,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      enable_node_autoprovisioning:
+          Enables automatic node pool creation and deletion.
+      resource_limits:
+          Contains global constraints regarding minimum and maximum
+          amount of resources in the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ClusterAutoscaling)
+    ),
+)
+_sym_db.RegisterMessage(ClusterAutoscaling)
+
+ResourceLimit = _reflection.GeneratedProtocolMessageType(
+    "ResourceLimit",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESOURCELIMIT,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Contains information about amount of some resource in the cluster. For
+  memory, value should be in GB.
+  
+  
+  Attributes:
+      resource_type:
+          Resource name "cpu", "memory" or gpu-specific string.
+      minimum:
+          Minimum amount of the resource in the cluster.
+      maximum:
+          Maximum amount of the resource in the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ResourceLimit)
+    ),
+)
+_sym_db.RegisterMessage(ResourceLimit)
+
+NodePoolAutoscaling = _reflection.GeneratedProtocolMessageType(
+    "NodePoolAutoscaling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEPOOLAUTOSCALING,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""NodePoolAutoscaling contains information required by cluster autoscaler
+  to adjust the size of the node pool to the current cluster usage.
+  
+  
+  Attributes:
+      enabled:
+          Is autoscaling enabled for this node pool.
+      min_node_count:
+          Minimum number of nodes in the NodePool. Must be >= 1 and <=
+          max\_node\_count.
+      max_node_count:
+          Maximum number of nodes in the NodePool. Must be >=
+          min\_node\_count. There has to enough quota to scale up the
+          cluster.
+      autoprovisioned:
+          Can this node pool be deleted automatically.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NodePoolAutoscaling)
+    ),
+)
+_sym_db.RegisterMessage(NodePoolAutoscaling)
+
+SetLabelsRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLabelsRequest",
+    (_message.Message,),
+    dict(
+        ResourceLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ResourceLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SETLABELSREQUEST_RESOURCELABELSENTRY,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetLabelsRequest.ResourceLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_SETLABELSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetLabelsRequest sets the Google Cloud Platform labels on a Google
+  Container Engine cluster, which will in turn set them for Google Compute
+  Engine resources used by that cluster
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      resource_labels:
+          The labels to set for that cluster.
+      label_fingerprint:
+          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.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          labels. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetLabelsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLabelsRequest)
+_sym_db.RegisterMessage(SetLabelsRequest.ResourceLabelsEntry)
+
+SetLegacyAbacRequest = _reflection.GeneratedProtocolMessageType(
+    "SetLegacyAbacRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETLEGACYABACREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetLegacyAbacRequest enables or disables the ABAC authorization
+  mechanism for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster to update. This field has
+          been deprecated and replaced by the name field.
+      enabled:
+          Whether ABAC authorization will be enabled in the cluster.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          legacy abac. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetLegacyAbacRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetLegacyAbacRequest)
+
+StartIPRotationRequest = _reflection.GeneratedProtocolMessageType(
+    "StartIPRotationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STARTIPROTATIONREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""StartIPRotationRequest creates a new IP for the cluster and then
+  performs a node upgrade on each node pool to point to the new IP.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster id) of the cluster to
+          start IP rotation. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+      rotate_credentials:
+          Whether to rotate credentials during IP rotation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.StartIPRotationRequest)
+    ),
+)
+_sym_db.RegisterMessage(StartIPRotationRequest)
+
+CompleteIPRotationRequest = _reflection.GeneratedProtocolMessageType(
+    "CompleteIPRotationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMPLETEIPROTATIONREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""CompleteIPRotationRequest moves the cluster master back into single-IP
+  mode.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      name:
+          The name (project, location, cluster id) of the cluster to
+          complete IP rotation. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.CompleteIPRotationRequest)
+    ),
+)
+_sym_db.RegisterMessage(CompleteIPRotationRequest)
+
+AcceleratorConfig = _reflection.GeneratedProtocolMessageType(
+    "AcceleratorConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACCELERATORCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""AcceleratorConfig represents a Hardware Accelerator request.
+  
+  
+  Attributes:
+      accelerator_count:
+          The number of the accelerator cards exposed to an instance.
+      accelerator_type:
+          The accelerator type resource name. List of supported
+          accelerators `here </compute/docs/gpus/#Introduction>`__
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.AcceleratorConfig)
+    ),
+)
+_sym_db.RegisterMessage(AcceleratorConfig)
+
+WorkloadMetadataConfig = _reflection.GeneratedProtocolMessageType(
+    "WorkloadMetadataConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKLOADMETADATACONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""WorkloadMetadataConfig defines the metadata configuration to expose to
+  workloads on the node pool.
+  
+  
+  Attributes:
+      node_metadata:
+          NodeMetadata is the configuration for how to expose the node
+          metadata to the workload running on the node.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.WorkloadMetadataConfig)
+    ),
+)
+_sym_db.RegisterMessage(WorkloadMetadataConfig)
+
+SetNetworkPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "SetNetworkPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETNETWORKPOLICYREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetNetworkPolicyRequest enables/disables network policy for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          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.
+      zone:
+          Deprecated. The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides. This field has been deprecated and replaced by the
+          name field.
+      cluster_id:
+          Deprecated. The name of the cluster. This field has been
+          deprecated and replaced by the name field.
+      network_policy:
+          Configuration options for the NetworkPolicy feature.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          networking policy. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetNetworkPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetNetworkPolicyRequest)
+
+SetMaintenancePolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "SetMaintenancePolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETMAINTENANCEPOLICYREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""SetMaintenancePolicyRequest sets the maintenance policy for a cluster.
+  
+  
+  Attributes:
+      project_id:
+          The Google Developers Console `project ID or project number
+          <https://support.google.com/cloud/answer/6158840>`__.
+      zone:
+          The name of the Google Compute Engine `zone
+          </compute/docs/zones#available>`__ in which the cluster
+          resides.
+      cluster_id:
+          The name of the cluster to update.
+      maintenance_policy:
+          The maintenance policy to be set for the cluster. An empty
+          field clears the existing maintenance policy.
+      name:
+          The name (project, location, cluster id) of the cluster to set
+          maintenance policy. Specified in the format
+          'projects/*/locations/*/clusters/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.SetMaintenancePolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetMaintenancePolicyRequest)
+
+ListLocationsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListLocationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOCATIONSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListLocationsRequest is used to request the locations that offer GKE.
+  
+  
+  Attributes:
+      parent:
+          Contains the name of the resource requested. Specified in the
+          format 'projects/\*'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListLocationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListLocationsRequest)
+
+ListLocationsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListLocationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOCATIONSRESPONSE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListLocationsResponse returns the list of all GKE locations and their
+  recommendation state.
+  
+  
+  Attributes:
+      locations:
+          A full list of GKE locations.
+      next_page_token:
+          Only return ListLocationsResponse that occur after the
+          page\_token. This value should be populated from the
+          ListLocationsResponse.next\_page\_token if that response token
+          was set (which happens when listing more Locations than fit in
+          a single ListLocationsResponse).
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListLocationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListLocationsResponse)
+
+Location = _reflection.GeneratedProtocolMessageType(
+    "Location",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATION,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Location returns the location name, and if the location is recommended
+  for GKE cluster scheduling.
+  
+  
+  Attributes:
+      type:
+          Contains the type of location this Location is for. Regional
+          or Zonal.
+      name:
+          Contains the name of the resource requested. Specified in the
+          format 'projects/*/locations/*'.
+      recommended:
+          Whether the location is recomended for GKE cluster scheduling.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.Location)
+    ),
+)
+_sym_db.RegisterMessage(Location)
+
+StatusCondition = _reflection.GeneratedProtocolMessageType(
+    "StatusCondition",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STATUSCONDITION,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""StatusCondition describes why a cluster or a node pool has a certain
+  status (e.g., ERROR or DEGRADED).
+  
+  
+  Attributes:
+      code:
+          Machine-friendly representation of the condition
+      message:
+          Human-friendly representation of the condition
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.StatusCondition)
+    ),
+)
+_sym_db.RegisterMessage(StatusCondition)
+
+NetworkConfig = _reflection.GeneratedProtocolMessageType(
+    "NetworkConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NETWORKCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""NetworkConfig reports the relative names of network & subnetwork.
+  
+  
+  Attributes:
+      network:
+          Output only. The relative name of the Google Compute Engine [n
+          etwork][google.container.v1beta1.NetworkConfig.network](/compu
+          te/docs/networks-and-firewalls#networks) to which the cluster
+          is connected. Example: projects/my-project/global/networks/my-
+          network
+      subnetwork:
+          Output only. The relative name of the Google Compute Engine
+          `subnetwork </compute/docs/vpc>`__ to which the cluster is
+          connected. Example: projects/my-project/regions/us-
+          central1/subnetworks/my-subnet
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.NetworkConfig)
+    ),
+)
+_sym_db.RegisterMessage(NetworkConfig)
+
+ListUsableSubnetworksRequest = _reflection.GeneratedProtocolMessageType(
+    "ListUsableSubnetworksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTUSABLESUBNETWORKSREQUEST,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListUsableSubnetworksRequest requests the list of usable subnetworks.
+  available to a user for creating clusters.
+  
+  
+  Attributes:
+      parent:
+          The parent project where subnetworks are usable. Specified in
+          the format 'projects/\*'.
+      filter:
+          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.
+      page_size:
+          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)
+      page_token:
+          Specifies a page token to use. Set this to the nextPageToken
+          returned by previous list requests to get the next page of
+          results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListUsableSubnetworksRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListUsableSubnetworksRequest)
+
+ListUsableSubnetworksResponse = _reflection.GeneratedProtocolMessageType(
+    "ListUsableSubnetworksResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTUSABLESUBNETWORKSRESPONSE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""ListUsableSubnetworksResponse is the response of
+  ListUsableSubnetworksRequest.
+  
+  
+  Attributes:
+      subnetworks:
+          A list of usable subnetworks in the specified network project.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ListUsableSubnetworksResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListUsableSubnetworksResponse)
+
+UsableSubnetworkSecondaryRange = _reflection.GeneratedProtocolMessageType(
+    "UsableSubnetworkSecondaryRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_USABLESUBNETWORKSECONDARYRANGE,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Secondary IP range of a usable subnetwork.
+  
+  
+  Attributes:
+      range_name:
+          The name associated with this subnetwork secondary range, used
+          when adding an alias IP range to a VM instance.
+      ip_cidr_range:
+          The range of IP addresses belonging to this subnetwork
+          secondary range.
+      status:
+          This field is to determine the status of the secondary range
+          programmably.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.UsableSubnetworkSecondaryRange)
+    ),
+)
+_sym_db.RegisterMessage(UsableSubnetworkSecondaryRange)
+
+UsableSubnetwork = _reflection.GeneratedProtocolMessageType(
+    "UsableSubnetwork",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_USABLESUBNETWORK,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Network Name. Example: projects/my-project/global/networks/my-network
+  
+  
+  Attributes:
+      subnetwork:
+          Subnetwork Name. Example: projects/my-project/regions/us-
+          central1/subnetworks/my-subnet
+      ip_cidr_range:
+          The range of internal addresses that are owned by this
+          subnetwork.
+      secondary_ip_ranges:
+          Secondary IP ranges.
+      status_message:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.UsableSubnetwork)
+    ),
+)
+_sym_db.RegisterMessage(UsableSubnetwork)
+
+VerticalPodAutoscaling = _reflection.GeneratedProtocolMessageType(
+    "VerticalPodAutoscaling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTICALPODAUTOSCALING,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""VerticalPodAutoscaling contains global, per-cluster information required
+  by Vertical Pod Autoscaler to automatically adjust the resources of pods
+  controlled by it.
+  
+  
+  Attributes:
+      enabled:
+          Enables vertical pod autoscaling.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.VerticalPodAutoscaling)
+    ),
+)
+_sym_db.RegisterMessage(VerticalPodAutoscaling)
+
+MaxPodsConstraint = _reflection.GeneratedProtocolMessageType(
+    "MaxPodsConstraint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MAXPODSCONSTRAINT,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Constraints applied to pods.
+  
+  
+  Attributes:
+      max_pods_per_node:
+          Constraint enforced on the max num of pods per node.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.MaxPodsConstraint)
+    ),
+)
+_sym_db.RegisterMessage(MaxPodsConstraint)
+
+ResourceUsageExportConfig = _reflection.GeneratedProtocolMessageType(
+    "ResourceUsageExportConfig",
+    (_message.Message,),
+    dict(
+        BigQueryDestination=_reflection.GeneratedProtocolMessageType(
+            "BigQueryDestination",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_RESOURCEUSAGEEXPORTCONFIG_BIGQUERYDESTINATION,
+                __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+                __doc__="""Parameters for using BigQuery as the destination of resource usage
+    export.
+    
+    
+    Attributes:
+        dataset_id:
+            The ID of a BigQuery Dataset.
+    """,
+                # @@protoc_insertion_point(class_scope:google.container.v1beta1.ResourceUsageExportConfig.BigQueryDestination)
+            ),
+        ),
+        DESCRIPTOR=_RESOURCEUSAGEEXPORTCONFIG,
+        __module__="google.cloud.container_v1beta1.proto.cluster_service_pb2",
+        __doc__="""Configuration for exporting cluster resource usages.
+  
+  
+  Attributes:
+      bigquery_destination:
+          Configuration to use BigQuery as usage export destination.
+      enable_network_egress_metering:
+          Whether to enable network egress metering for this cluster. If
+          enabled, a daemonset will be created in the cluster to meter
+          network egress traffic.
+  """,
+        # @@protoc_insertion_point(class_scope:google.container.v1beta1.ResourceUsageExportConfig)
+    ),
+)
+_sym_db.RegisterMessage(ResourceUsageExportConfig)
+_sym_db.RegisterMessage(ResourceUsageExportConfig.BigQueryDestination)
+
+
+DESCRIPTOR._options = None
+_NODECONFIG_METADATAENTRY._options = None
+_NODECONFIG_LABELSENTRY._options = None
+_IPALLOCATIONPOLICY.fields_by_name["cluster_ipv4_cidr"]._options = None
+_IPALLOCATIONPOLICY.fields_by_name["node_ipv4_cidr"]._options = None
+_IPALLOCATIONPOLICY.fields_by_name["services_ipv4_cidr"]._options = None
+_CLUSTER_RESOURCELABELSENTRY._options = None
+_CLUSTER.fields_by_name["private_cluster"]._options = None
+_CLUSTER.fields_by_name["master_ipv4_cidr_block"]._options = None
+_CLUSTER.fields_by_name["zone"]._options = None
+_CLUSTER.fields_by_name["current_node_version"]._options = None
+_CLUSTER.fields_by_name["instance_group_urls"]._options = None
+_CLUSTER.fields_by_name["current_node_count"]._options = None
+_OPERATION.fields_by_name["zone"]._options = None
+_CREATECLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_CREATECLUSTERREQUEST.fields_by_name["zone"]._options = None
+_GETCLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_GETCLUSTERREQUEST.fields_by_name["zone"]._options = None
+_GETCLUSTERREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATECLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_UPDATECLUSTERREQUEST.fields_by_name["zone"]._options = None
+_UPDATECLUSTERREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATENODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["project_id"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["zone"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETLOGGINGSERVICEREQUEST.fields_by_name["project_id"]._options = None
+_SETLOGGINGSERVICEREQUEST.fields_by_name["cluster_id"]._options = None
+_SETMONITORINGSERVICEREQUEST.fields_by_name["project_id"]._options = None
+_SETMONITORINGSERVICEREQUEST.fields_by_name["zone"]._options = None
+_SETMONITORINGSERVICEREQUEST.fields_by_name["cluster_id"]._options = None
+_SETADDONSCONFIGREQUEST.fields_by_name["project_id"]._options = None
+_SETADDONSCONFIGREQUEST.fields_by_name["zone"]._options = None
+_SETADDONSCONFIGREQUEST.fields_by_name["cluster_id"]._options = None
+_SETLOCATIONSREQUEST.fields_by_name["project_id"]._options = None
+_SETLOCATIONSREQUEST.fields_by_name["zone"]._options = None
+_SETLOCATIONSREQUEST.fields_by_name["cluster_id"]._options = None
+_UPDATEMASTERREQUEST.fields_by_name["project_id"]._options = None
+_UPDATEMASTERREQUEST.fields_by_name["zone"]._options = None
+_UPDATEMASTERREQUEST.fields_by_name["cluster_id"]._options = None
+_SETMASTERAUTHREQUEST.fields_by_name["project_id"]._options = None
+_SETMASTERAUTHREQUEST.fields_by_name["zone"]._options = None
+_SETMASTERAUTHREQUEST.fields_by_name["cluster_id"]._options = None
+_DELETECLUSTERREQUEST.fields_by_name["project_id"]._options = None
+_DELETECLUSTERREQUEST.fields_by_name["zone"]._options = None
+_DELETECLUSTERREQUEST.fields_by_name["cluster_id"]._options = None
+_LISTCLUSTERSREQUEST.fields_by_name["project_id"]._options = None
+_LISTCLUSTERSREQUEST.fields_by_name["zone"]._options = None
+_GETOPERATIONREQUEST.fields_by_name["project_id"]._options = None
+_GETOPERATIONREQUEST.fields_by_name["zone"]._options = None
+_GETOPERATIONREQUEST.fields_by_name["operation_id"]._options = None
+_LISTOPERATIONSREQUEST.fields_by_name["project_id"]._options = None
+_LISTOPERATIONSREQUEST.fields_by_name["zone"]._options = None
+_CANCELOPERATIONREQUEST.fields_by_name["project_id"]._options = None
+_CANCELOPERATIONREQUEST.fields_by_name["zone"]._options = None
+_CANCELOPERATIONREQUEST.fields_by_name["operation_id"]._options = None
+_GETSERVERCONFIGREQUEST.fields_by_name["project_id"]._options = None
+_GETSERVERCONFIGREQUEST.fields_by_name["zone"]._options = None
+_CREATENODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_CREATENODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_CREATENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_DELETENODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None
+_LISTNODEPOOLSREQUEST.fields_by_name["project_id"]._options = None
+_LISTNODEPOOLSREQUEST.fields_by_name["zone"]._options = None
+_LISTNODEPOOLSREQUEST.fields_by_name["cluster_id"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["project_id"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["zone"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None
+_GETNODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["project_id"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["zone"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["project_id"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["zone"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNODEPOOLSIZEREQUEST.fields_by_name["node_pool_id"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["project_id"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["zone"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["cluster_id"]._options = None
+_ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["node_pool_id"]._options = None
+_SETLABELSREQUEST_RESOURCELABELSENTRY._options = None
+_SETLABELSREQUEST.fields_by_name["project_id"]._options = None
+_SETLABELSREQUEST.fields_by_name["zone"]._options = None
+_SETLABELSREQUEST.fields_by_name["cluster_id"]._options = None
+_SETLEGACYABACREQUEST.fields_by_name["project_id"]._options = None
+_SETLEGACYABACREQUEST.fields_by_name["zone"]._options = None
+_SETLEGACYABACREQUEST.fields_by_name["cluster_id"]._options = None
+_STARTIPROTATIONREQUEST.fields_by_name["project_id"]._options = None
+_STARTIPROTATIONREQUEST.fields_by_name["zone"]._options = None
+_STARTIPROTATIONREQUEST.fields_by_name["cluster_id"]._options = None
+_COMPLETEIPROTATIONREQUEST.fields_by_name["project_id"]._options = None
+_COMPLETEIPROTATIONREQUEST.fields_by_name["zone"]._options = None
+_COMPLETEIPROTATIONREQUEST.fields_by_name["cluster_id"]._options = None
+_SETNETWORKPOLICYREQUEST.fields_by_name["project_id"]._options = None
+_SETNETWORKPOLICYREQUEST.fields_by_name["zone"]._options = None
+_SETNETWORKPOLICYREQUEST.fields_by_name["cluster_id"]._options = None
+
+_CLUSTERMANAGER = _descriptor.ServiceDescriptor(
+    name="ClusterManager",
+    full_name="google.container.v1beta1.ClusterManager",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=15924,
+    serialized_end=24261,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListClusters",
+            full_name="google.container.v1beta1.ClusterManager.ListClusters",
+            index=0,
+            containing_service=None,
+            input_type=_LISTCLUSTERSREQUEST,
+            output_type=_LISTCLUSTERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002k\0221/v1beta1/{parent=projects/*/locations/*}/clustersZ6\0224/v1beta1/projects/{project_id}/zones/{zone}/clusters"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCluster",
+            full_name="google.container.v1beta1.ClusterManager.GetCluster",
+            index=1,
+            containing_service=None,
+            input_type=_GETCLUSTERREQUEST,
+            output_type=_CLUSTER,
+            serialized_options=_b(
+                "\202\323\344\223\002x\0221/v1beta1/{name=projects/*/locations/*/clusters/*}ZC\022A/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateCluster",
+            full_name="google.container.v1beta1.ClusterManager.CreateCluster",
+            index=2,
+            containing_service=None,
+            input_type=_CREATECLUSTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002q"1/v1beta1/{parent=projects/*/locations/*}/clusters:\001*Z9"4/v1beta1/projects/{project_id}/zones/{zone}/clusters:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCluster",
+            full_name="google.container.v1beta1.ClusterManager.UpdateCluster",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATECLUSTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002~\0321/v1beta1/{name=projects/*/locations/*/clusters/*}:\001*ZF\032A/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateNodePool",
+            full_name="google.container.v1beta1.ClusterManager.UpdateNodePool",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATENODEPOOLREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\252\001\032=/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:\001*Zf"a/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/update:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNodePoolAutoscaling",
+            full_name="google.container.v1beta1.ClusterManager.SetNodePoolAutoscaling",
+            index=5,
+            containing_service=None,
+            input_type=_SETNODEPOOLAUTOSCALINGREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\276\001"L/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling:\001*Zk"f/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/autoscaling:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLoggingService",
+            full_name="google.container.v1beta1.ClusterManager.SetLoggingService",
+            index=6,
+            containing_service=None,
+            input_type=_SETLOGGINGSERVICEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\221\001"</v1beta1/{name=projects/*/locations/*/clusters/*}:setLogging:\001*ZN"I/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/logging:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetMonitoringService",
+            full_name="google.container.v1beta1.ClusterManager.SetMonitoringService",
+            index=7,
+            containing_service=None,
+            input_type=_SETMONITORINGSERVICEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\227\001"?/v1beta1/{name=projects/*/locations/*/clusters/*}:setMonitoring:\001*ZQ"L/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/monitoring:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetAddonsConfig",
+            full_name="google.container.v1beta1.ClusterManager.SetAddonsConfig",
+            index=8,
+            containing_service=None,
+            input_type=_SETADDONSCONFIGREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\217\001";/v1beta1/{name=projects/*/locations/*/clusters/*}:setAddons:\001*ZM"H/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/addons:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLocations",
+            full_name="google.container.v1beta1.ClusterManager.SetLocations",
+            index=9,
+            containing_service=None,
+            input_type=_SETLOCATIONSREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\225\001">/v1beta1/{name=projects/*/locations/*/clusters/*}:setLocations:\001*ZP"K/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/locations:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateMaster",
+            full_name="google.container.v1beta1.ClusterManager.UpdateMaster",
+            index=10,
+            containing_service=None,
+            input_type=_UPDATEMASTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\222\001">/v1beta1/{name=projects/*/locations/*/clusters/*}:updateMaster:\001*ZM"H/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/master:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetMasterAuth",
+            full_name="google.container.v1beta1.ClusterManager.SetMasterAuth",
+            index=11,
+            containing_service=None,
+            input_type=_SETMASTERAUTHREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\232\001"?/v1beta1/{name=projects/*/locations/*/clusters/*}:setMasterAuth:\001*ZT"O/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMasterAuth:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteCluster",
+            full_name="google.container.v1beta1.ClusterManager.DeleteCluster",
+            index=12,
+            containing_service=None,
+            input_type=_DELETECLUSTERREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002x*1/v1beta1/{name=projects/*/locations/*/clusters/*}ZC*A/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListOperations",
+            full_name="google.container.v1beta1.ClusterManager.ListOperations",
+            index=13,
+            containing_service=None,
+            input_type=_LISTOPERATIONSREQUEST,
+            output_type=_LISTOPERATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002o\0223/v1beta1/{parent=projects/*/locations/*}/operationsZ8\0226/v1beta1/projects/{project_id}/zones/{zone}/operations"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetOperation",
+            full_name="google.container.v1beta1.ClusterManager.GetOperation",
+            index=14,
+            containing_service=None,
+            input_type=_GETOPERATIONREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002~\0223/v1beta1/{name=projects/*/locations/*/operations/*}ZG\022E/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelOperation",
+            full_name="google.container.v1beta1.ClusterManager.CancelOperation",
+            index=15,
+            containing_service=None,
+            input_type=_CANCELOPERATIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002\222\001":/v1beta1/{name=projects/*/locations/*/operations/*}:cancel:\001*ZQ"L/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}:cancel:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetServerConfig",
+            full_name="google.container.v1beta1.ClusterManager.GetServerConfig",
+            index=16,
+            containing_service=None,
+            input_type=_GETSERVERCONFIGREQUEST,
+            output_type=_SERVERCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002q\0223/v1beta1/{name=projects/*/locations/*}/serverConfigZ:\0228/v1beta1/projects/{project_id}/zones/{zone}/serverconfig"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListNodePools",
+            full_name="google.container.v1beta1.ClusterManager.ListNodePools",
+            index=17,
+            containing_service=None,
+            input_type=_LISTNODEPOOLSREQUEST,
+            output_type=_LISTNODEPOOLSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\216\001\022=/v1beta1/{parent=projects/*/locations/*/clusters/*}/nodePoolsZM\022K/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetNodePool",
+            full_name="google.container.v1beta1.ClusterManager.GetNodePool",
+            index=18,
+            containing_service=None,
+            input_type=_GETNODEPOOLREQUEST,
+            output_type=_NODEPOOL,
+            serialized_options=_b(
+                "\202\323\344\223\002\235\001\022=/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}Z\\\022Z/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateNodePool",
+            full_name="google.container.v1beta1.ClusterManager.CreateNodePool",
+            index=19,
+            containing_service=None,
+            input_type=_CREATENODEPOOLREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\224\001"=/v1beta1/{parent=projects/*/locations/*/clusters/*}/nodePools:\001*ZP"K/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteNodePool",
+            full_name="google.container.v1beta1.ClusterManager.DeleteNodePool",
+            index=20,
+            containing_service=None,
+            input_type=_DELETENODEPOOLREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002\235\001*=/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}Z\\*Z/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RollbackNodePoolUpgrade",
+            full_name="google.container.v1beta1.ClusterManager.RollbackNodePoolUpgrade",
+            index=21,
+            containing_service=None,
+            input_type=_ROLLBACKNODEPOOLUPGRADEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\265\001"F/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback:\001*Zh"c/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}:rollback:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNodePoolManagement",
+            full_name="google.container.v1beta1.ClusterManager.SetNodePoolManagement",
+            index=22,
+            containing_service=None,
+            input_type=_SETNODEPOOLMANAGEMENTREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\277\001"K/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setManagement:\001*Zm"h/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setManagement:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLabels",
+            full_name="google.container.v1beta1.ClusterManager.SetLabels",
+            index=23,
+            containing_service=None,
+            input_type=_SETLABELSREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\237\001"C/v1beta1/{name=projects/*/locations/*/clusters/*}:setResourceLabels:\001*ZU"P/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetLegacyAbac",
+            full_name="google.container.v1beta1.ClusterManager.SetLegacyAbac",
+            index=24,
+            containing_service=None,
+            input_type=_SETLEGACYABACREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\227\001"?/v1beta1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac:\001*ZQ"L/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StartIPRotation",
+            full_name="google.container.v1beta1.ClusterManager.StartIPRotation",
+            index=25,
+            containing_service=None,
+            input_type=_STARTIPROTATIONREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\236\001"A/v1beta1/{name=projects/*/locations/*/clusters/*}:startIpRotation:\001*ZV"Q/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:startIpRotation:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CompleteIPRotation",
+            full_name="google.container.v1beta1.ClusterManager.CompleteIPRotation",
+            index=26,
+            containing_service=None,
+            input_type=_COMPLETEIPROTATIONREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\244\001"D/v1beta1/{name=projects/*/locations/*/clusters/*}:completeIpRotation:\001*ZY"T/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:completeIpRotation:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNodePoolSize",
+            full_name="google.container.v1beta1.ClusterManager.SetNodePoolSize",
+            index=27,
+            containing_service=None,
+            input_type=_SETNODEPOOLSIZEREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\263\001"E/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setSize:\001*Zg"b/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}/setSize:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetNetworkPolicy",
+            full_name="google.container.v1beta1.ClusterManager.SetNetworkPolicy",
+            index=28,
+            containing_service=None,
+            input_type=_SETNETWORKPOLICYREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\240\001"B/v1beta1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy:\001*ZW"R/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setNetworkPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetMaintenancePolicy",
+            full_name="google.container.v1beta1.ClusterManager.SetMaintenancePolicy",
+            index=29,
+            containing_service=None,
+            input_type=_SETMAINTENANCEPOLICYREQUEST,
+            output_type=_OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\250\001"F/v1beta1/{name=projects/*/locations/*/clusters/*}:setMaintenancePolicy:\001*Z["V/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}:setMaintenancePolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListUsableSubnetworks",
+            full_name="google.container.v1beta1.ClusterManager.ListUsableSubnetworks",
+            index=30,
+            containing_service=None,
+            input_type=_LISTUSABLESUBNETWORKSREQUEST,
+            output_type=_LISTUSABLESUBNETWORKSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1beta1/{parent=projects/*}/aggregated/usableSubnetworks"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListLocations",
+            full_name="google.container.v1beta1.ClusterManager.ListLocations",
+            index=31,
+            containing_service=None,
+            input_type=_LISTLOCATIONSREQUEST,
+            output_type=_LISTLOCATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002(\022&/v1beta1/{parent=projects/*}/locations"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLUSTERMANAGER)
+
+DESCRIPTOR.services_by_name["ClusterManager"] = _CLUSTERMANAGER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/container/google/cloud/container_v1beta1/proto/cluster_service_pb2_grpc.py b/container/google/cloud/container_v1beta1/proto/cluster_service_pb2_grpc.py
new file mode 100644
index 000000000000..f722b4a81338
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/proto/cluster_service_pb2_grpc.py
@@ -0,0 +1,602 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.container_v1beta1.proto import (
+    cluster_service_pb2 as google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ClusterManagerStub(object):
+    """Google Kubernetes Engine Cluster Manager v1beta1
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListClusters = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/ListClusters",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListClustersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListClustersResponse.FromString,
+        )
+        self.GetCluster = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/GetCluster",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Cluster.FromString,
+        )
+        self.CreateCluster = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/CreateCluster",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CreateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.UpdateCluster = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/UpdateCluster",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.UpdateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.UpdateNodePool = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/UpdateNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.UpdateNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNodePoolAutoscaling = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetNodePoolAutoscaling",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNodePoolAutoscalingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLoggingService = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetLoggingService",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLoggingServiceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetMonitoringService = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetMonitoringService",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetMonitoringServiceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetAddonsConfig = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetAddonsConfig",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetAddonsConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLocations = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetLocations",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLocationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.UpdateMaster = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/UpdateMaster",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.UpdateMasterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetMasterAuth = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetMasterAuth",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetMasterAuthRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.DeleteCluster = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/DeleteCluster",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.DeleteClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.ListOperations = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/ListOperations",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListOperationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListOperationsResponse.FromString,
+        )
+        self.GetOperation = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/GetOperation",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetOperationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.CancelOperation = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/CancelOperation",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CancelOperationRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetServerConfig = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/GetServerConfig",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetServerConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ServerConfig.FromString,
+        )
+        self.ListNodePools = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/ListNodePools",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListNodePoolsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListNodePoolsResponse.FromString,
+        )
+        self.GetNodePool = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/GetNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.NodePool.FromString,
+        )
+        self.CreateNodePool = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/CreateNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CreateNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.DeleteNodePool = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/DeleteNodePool",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.DeleteNodePoolRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.RollbackNodePoolUpgrade = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/RollbackNodePoolUpgrade",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.RollbackNodePoolUpgradeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNodePoolManagement = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetNodePoolManagement",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNodePoolManagementRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLabels = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetLabels",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLabelsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetLegacyAbac = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetLegacyAbac",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLegacyAbacRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.StartIPRotation = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/StartIPRotation",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.StartIPRotationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.CompleteIPRotation = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/CompleteIPRotation",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CompleteIPRotationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNodePoolSize = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetNodePoolSize",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNodePoolSizeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetNetworkPolicy = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetNetworkPolicy",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNetworkPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.SetMaintenancePolicy = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/SetMaintenancePolicy",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetMaintenancePolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.FromString,
+        )
+        self.ListUsableSubnetworks = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/ListUsableSubnetworks",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListUsableSubnetworksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListUsableSubnetworksResponse.FromString,
+        )
+        self.ListLocations = channel.unary_unary(
+            "/google.container.v1beta1.ClusterManager/ListLocations",
+            request_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListLocationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListLocationsResponse.FromString,
+        )
+
+
+class ClusterManagerServicer(object):
+    """Google Kubernetes Engine Cluster Manager v1beta1
+  """
+
+    def ListClusters(self, request, context):
+        """Lists all clusters owned by a project in either the specified zone or all
+    zones.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCluster(self, request, context):
+        """Gets the details for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateCluster(self, request, context):
+        """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).
+
+    One firewall is added for the cluster. After cluster creation,
+    the cluster 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCluster(self, request, context):
+        """Updates the settings for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateNodePool(self, request, context):
+        """Updates the version and/or image type of a specific node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNodePoolAutoscaling(self, request, context):
+        """Sets the autoscaling settings of a specific node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLoggingService(self, request, context):
+        """Sets the logging service for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetMonitoringService(self, request, context):
+        """Sets the monitoring service for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetAddonsConfig(self, request, context):
+        """Sets the addons for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLocations(self, request, context):
+        """Sets the locations for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateMaster(self, request, context):
+        """Updates the master for a specific cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetMasterAuth(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteCluster(self, request, context):
+        """Deletes the cluster, including the Kubernetes endpoint and all worker
+    nodes.
+
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListOperations(self, request, context):
+        """Lists all operations in a project in a specific zone or all zones.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetOperation(self, request, context):
+        """Gets the specified operation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelOperation(self, request, context):
+        """Cancels the specified operation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetServerConfig(self, request, context):
+        """Returns configuration info about the Kubernetes Engine service.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListNodePools(self, request, context):
+        """Lists the node pools for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetNodePool(self, request, context):
+        """Retrieves the node pool requested.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateNodePool(self, request, context):
+        """Creates a node pool for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteNodePool(self, request, context):
+        """Deletes a node pool from a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RollbackNodePoolUpgrade(self, request, context):
+        """Roll back the previously Aborted or Failed NodePool upgrade.
+    This will be an no-op if the last upgrade successfully completed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNodePoolManagement(self, request, context):
+        """Sets the NodeManagement options for a node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLabels(self, request, context):
+        """Sets labels on a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetLegacyAbac(self, request, context):
+        """Enables or disables the ABAC authorization mechanism on a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StartIPRotation(self, request, context):
+        """Start master IP rotation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CompleteIPRotation(self, request, context):
+        """Completes master IP rotation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNodePoolSize(self, request, context):
+        """Sets the size for a specific node pool.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetNetworkPolicy(self, request, context):
+        """Enables/Disables Network Policy for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetMaintenancePolicy(self, request, context):
+        """Sets the maintenance policy for a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListUsableSubnetworks(self, request, context):
+        """Lists subnetworks that are usable for creating clusters in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListLocations(self, request, context):
+        """Used to fetch locations that offer GKE.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ClusterManagerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListClusters": grpc.unary_unary_rpc_method_handler(
+            servicer.ListClusters,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListClustersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListClustersResponse.SerializeToString,
+        ),
+        "GetCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Cluster.SerializeToString,
+        ),
+        "CreateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CreateClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "UpdateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.UpdateClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "UpdateNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.UpdateNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNodePoolAutoscaling": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNodePoolAutoscaling,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNodePoolAutoscalingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLoggingService": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLoggingService,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLoggingServiceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetMonitoringService": grpc.unary_unary_rpc_method_handler(
+            servicer.SetMonitoringService,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetMonitoringServiceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetAddonsConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.SetAddonsConfig,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetAddonsConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLocations": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLocations,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLocationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "UpdateMaster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateMaster,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.UpdateMasterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetMasterAuth": grpc.unary_unary_rpc_method_handler(
+            servicer.SetMasterAuth,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetMasterAuthRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "DeleteCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteCluster,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.DeleteClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "ListOperations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListOperations,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListOperationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListOperationsResponse.SerializeToString,
+        ),
+        "GetOperation": grpc.unary_unary_rpc_method_handler(
+            servicer.GetOperation,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetOperationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "CancelOperation": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelOperation,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CancelOperationRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetServerConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetServerConfig,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetServerConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ServerConfig.SerializeToString,
+        ),
+        "ListNodePools": grpc.unary_unary_rpc_method_handler(
+            servicer.ListNodePools,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListNodePoolsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListNodePoolsResponse.SerializeToString,
+        ),
+        "GetNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.GetNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.GetNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.NodePool.SerializeToString,
+        ),
+        "CreateNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CreateNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "DeleteNodePool": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteNodePool,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.DeleteNodePoolRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "RollbackNodePoolUpgrade": grpc.unary_unary_rpc_method_handler(
+            servicer.RollbackNodePoolUpgrade,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.RollbackNodePoolUpgradeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNodePoolManagement": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNodePoolManagement,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNodePoolManagementRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLabels": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLabels,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLabelsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetLegacyAbac": grpc.unary_unary_rpc_method_handler(
+            servicer.SetLegacyAbac,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetLegacyAbacRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "StartIPRotation": grpc.unary_unary_rpc_method_handler(
+            servicer.StartIPRotation,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.StartIPRotationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "CompleteIPRotation": grpc.unary_unary_rpc_method_handler(
+            servicer.CompleteIPRotation,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.CompleteIPRotationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNodePoolSize": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNodePoolSize,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNodePoolSizeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetNetworkPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetNetworkPolicy,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetNetworkPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "SetMaintenancePolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetMaintenancePolicy,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.SetMaintenancePolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.Operation.SerializeToString,
+        ),
+        "ListUsableSubnetworks": grpc.unary_unary_rpc_method_handler(
+            servicer.ListUsableSubnetworks,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListUsableSubnetworksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListUsableSubnetworksResponse.SerializeToString,
+        ),
+        "ListLocations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListLocations,
+            request_deserializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListLocationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_container__v1beta1_dot_proto_dot_cluster__service__pb2.ListLocationsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.container.v1beta1.ClusterManager", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/container/google/cloud/container_v1beta1/types.py b/container/google/cloud/container_v1beta1/types.py
new file mode 100644
index 000000000000..9f3f9da25b8a
--- /dev/null
+++ b/container/google/cloud/container_v1beta1/types.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.container_v1beta1.proto import cluster_service_pb2
+from google.protobuf import empty_pb2
+
+
+_shared_modules = [empty_pb2]
+
+_local_modules = [cluster_service_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.container_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/container/noxfile.py b/container/noxfile.py
new file mode 100644
index 000000000000..60796a84144b
--- /dev/null
+++ b/container/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=70")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/container/setup.cfg b/container/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/container/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/container/setup.py b/container/setup.py
new file mode 100644
index 000000000000..389099256960
--- /dev/null
+++ b/container/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-container"
+description = "Google Container Engine API client library"
+version = "0.3.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/container/synth.metadata b/container/synth.metadata
new file mode 100644
index 000000000000..4e3dc125d2b7
--- /dev/null
+++ b/container/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:17:27.571283Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "container",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/container/artman_container_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "container",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/container/artman_container_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/container/synth.py b/container/synth.py
new file mode 100644
index 000000000000..b5cb4733dcf6
--- /dev/null
+++ b/container/synth.py
@@ -0,0 +1,67 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1", "v1"]
+
+# ----------------------------------------------------------------------------
+# Generate container GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library(
+        "container",
+        version,
+        config_path=f"/google/container/artman_container_{version}.yaml",
+        artman_output_name=f"container-{version}",
+        include_protos=True,
+    )
+
+    s.move(library / f"google/cloud/container_{version}")
+    s.move(library / f"tests/unit/gapic/{version}")
+
+# Use the highest version library to generate import alias.
+s.move(library / "google/cloud/container.py")
+
+# Issues exist where python files should define the source encoding
+# https://github.com/googleapis/gapic-generator/issues/2097
+s.replace(
+    "google/**/proto/*_pb2.py",
+    r"(^.*$\n)*",
+    r"# -*- coding: utf-8 -*-\n\g<0>")
+
+
+# Workaround https://github.com/googleapis/gapic-generator/issues/2449
+s.replace(
+    "google/**/proto/cluster_service_pb2.py",
+    r"nodePool>\n",
+    r"nodePool>`__\n",
+)
+s.replace(
+    "google/**/proto/cluster_service_pb2.py",
+    r"(\s+)`__ instead",
+    r"\g<1>instead",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=0, cov_level=70)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/container/tests/system/gapic/v1/test_system_cluster_manager_v1.py b/container/tests/system/gapic/v1/test_system_cluster_manager_v1.py
new file mode 100644
index 000000000000..edd29d99dfae
--- /dev/null
+++ b/container/tests/system/gapic/v1/test_system_cluster_manager_v1.py
@@ -0,0 +1,29 @@
+# Copyright 2017, Google LLC 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.
+
+import os
+import time
+
+from google.cloud import container_v1
+from google.cloud.container_v1.proto import cluster_service_pb2
+
+
+class TestSystemClusterManager(object):
+    def test_list_clusters(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = container_v1.ClusterManagerClient()
+        project_id_2 = project_id
+        zone = "us-central1-a"
+        response = client.list_clusters(project_id_2, zone)
diff --git a/container/tests/unit/gapic/v1/test_cluster_manager_client_v1.py b/container/tests/unit/gapic/v1/test_cluster_manager_client_v1.py
new file mode 100644
index 000000000000..5cfa0288e4d6
--- /dev/null
+++ b/container/tests/unit/gapic/v1/test_cluster_manager_client_v1.py
@@ -0,0 +1,1987 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import container_v1
+from google.cloud.container_v1 import enums
+from google.cloud.container_v1.proto import cluster_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestClusterManagerClient(object):
+    def test_list_clusters(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cluster_service_pb2.ListClustersResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        response = client.list_clusters(project_id, zone)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListClustersRequest(
+            project_id=project_id, zone=zone
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_clusters_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        with pytest.raises(CustomException):
+            client.list_clusters(project_id, zone)
+
+    def test_get_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        initial_node_count = 1682564205
+        logging_service = "loggingService-1700501035"
+        monitoring_service = "monitoringService1469270462"
+        network = "network1843485230"
+        cluster_ipv4_cidr = "clusterIpv4Cidr-141875831"
+        subnetwork = "subnetwork-1302785042"
+        enable_kubernetes_alpha = False
+        label_fingerprint = "labelFingerprint714995737"
+        self_link = "selfLink-1691268851"
+        zone_2 = "zone2-696322977"
+        endpoint = "endpoint1741102485"
+        initial_cluster_version = "initialClusterVersion-276373352"
+        current_master_version = "currentMasterVersion-920953983"
+        current_node_version = "currentNodeVersion-407476063"
+        create_time = "createTime-493574096"
+        status_message = "statusMessage-239442758"
+        node_ipv4_cidr_size = 1181176815
+        services_ipv4_cidr = "servicesIpv4Cidr1966438125"
+        current_node_count = 178977560
+        expire_time = "expireTime-96179731"
+        location = "location1901043637"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "initial_node_count": initial_node_count,
+            "logging_service": logging_service,
+            "monitoring_service": monitoring_service,
+            "network": network,
+            "cluster_ipv4_cidr": cluster_ipv4_cidr,
+            "subnetwork": subnetwork,
+            "enable_kubernetes_alpha": enable_kubernetes_alpha,
+            "label_fingerprint": label_fingerprint,
+            "self_link": self_link,
+            "zone": zone_2,
+            "endpoint": endpoint,
+            "initial_cluster_version": initial_cluster_version,
+            "current_master_version": current_master_version,
+            "current_node_version": current_node_version,
+            "create_time": create_time,
+            "status_message": status_message,
+            "node_ipv4_cidr_size": node_ipv4_cidr_size,
+            "services_ipv4_cidr": services_ipv4_cidr,
+            "current_node_count": current_node_count,
+            "expire_time": expire_time,
+            "location": location,
+        }
+        expected_response = cluster_service_pb2.Cluster(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.get_cluster(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.get_cluster(project_id, zone, cluster_id)
+
+    def test_create_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster = {}
+
+        response = client.create_cluster(project_id, zone, cluster)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CreateClusterRequest(
+            project_id=project_id, zone=zone, cluster=cluster
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster = {}
+
+        with pytest.raises(CustomException):
+            client.create_cluster(project_id, zone, cluster)
+
+    def test_update_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        update = {}
+
+        response = client.update_cluster(project_id, zone, cluster_id, update)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.UpdateClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, update=update
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        update = {}
+
+        with pytest.raises(CustomException):
+            client.update_cluster(project_id, zone, cluster_id, update)
+
+    def test_update_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_version = "nodeVersion1790136219"
+        image_type = "imageType-1442758754"
+
+        response = client.update_node_pool(
+            project_id, zone, cluster_id, node_pool_id, node_version, image_type
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.UpdateNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_version=node_version,
+            image_type=image_type,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_version = "nodeVersion1790136219"
+        image_type = "imageType-1442758754"
+
+        with pytest.raises(CustomException):
+            client.update_node_pool(
+                project_id, zone, cluster_id, node_pool_id, node_version, image_type
+            )
+
+    def test_set_node_pool_autoscaling(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        autoscaling = {}
+
+        response = client.set_node_pool_autoscaling(
+            project_id, zone, cluster_id, node_pool_id, autoscaling
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNodePoolAutoscalingRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            autoscaling=autoscaling,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_node_pool_autoscaling_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        autoscaling = {}
+
+        with pytest.raises(CustomException):
+            client.set_node_pool_autoscaling(
+                project_id, zone, cluster_id, node_pool_id, autoscaling
+            )
+
+    def test_set_logging_service(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        logging_service = "loggingService-1700501035"
+
+        response = client.set_logging_service(
+            project_id, zone, cluster_id, logging_service
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLoggingServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            logging_service=logging_service,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_logging_service_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        logging_service = "loggingService-1700501035"
+
+        with pytest.raises(CustomException):
+            client.set_logging_service(project_id, zone, cluster_id, logging_service)
+
+    def test_set_monitoring_service(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        monitoring_service = "monitoringService1469270462"
+
+        response = client.set_monitoring_service(
+            project_id, zone, cluster_id, monitoring_service
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetMonitoringServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            monitoring_service=monitoring_service,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_monitoring_service_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        monitoring_service = "monitoringService1469270462"
+
+        with pytest.raises(CustomException):
+            client.set_monitoring_service(
+                project_id, zone, cluster_id, monitoring_service
+            )
+
+    def test_set_addons_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        addons_config = {}
+
+        response = client.set_addons_config(project_id, zone, cluster_id, addons_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetAddonsConfigRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            addons_config=addons_config,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_addons_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        addons_config = {}
+
+        with pytest.raises(CustomException):
+            client.set_addons_config(project_id, zone, cluster_id, addons_config)
+
+    def test_set_locations(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        locations = []
+
+        response = client.set_locations(project_id, zone, cluster_id, locations)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLocationsRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, locations=locations
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_locations_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        locations = []
+
+        with pytest.raises(CustomException):
+            client.set_locations(project_id, zone, cluster_id, locations)
+
+    def test_update_master(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        master_version = "masterVersion-2139460613"
+
+        response = client.update_master(project_id, zone, cluster_id, master_version)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.UpdateMasterRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            master_version=master_version,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_master_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        master_version = "masterVersion-2139460613"
+
+        with pytest.raises(CustomException):
+            client.update_master(project_id, zone, cluster_id, master_version)
+
+    def test_set_master_auth(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        action = enums.SetMasterAuthRequest.Action.UNKNOWN
+        update = {}
+
+        response = client.set_master_auth(project_id, zone, cluster_id, action, update)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetMasterAuthRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            action=action,
+            update=update,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_master_auth_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        action = enums.SetMasterAuthRequest.Action.UNKNOWN
+        update = {}
+
+        with pytest.raises(CustomException):
+            client.set_master_auth(project_id, zone, cluster_id, action, update)
+
+    def test_delete_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.delete_cluster(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.DeleteClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.delete_cluster(project_id, zone, cluster_id)
+
+    def test_list_operations(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cluster_service_pb2.ListOperationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        response = client.list_operations(project_id, zone)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListOperationsRequest(
+            project_id=project_id, zone=zone
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_operations_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        with pytest.raises(CustomException):
+            client.list_operations(project_id, zone)
+
+    def test_get_operation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        response = client.get_operation(project_id, zone, operation_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_operation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        with pytest.raises(CustomException):
+            client.get_operation(project_id, zone, operation_id)
+
+    def test_cancel_operation(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        client.cancel_operation(project_id, zone, operation_id)
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CancelOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_operation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        with pytest.raises(CustomException):
+            client.cancel_operation(project_id, zone, operation_id)
+
+    def test_get_server_config(self):
+        # Setup Expected Response
+        default_cluster_version = "defaultClusterVersion111003029"
+        default_image_type = "defaultImageType-918225828"
+        expected_response = {
+            "default_cluster_version": default_cluster_version,
+            "default_image_type": default_image_type,
+        }
+        expected_response = cluster_service_pb2.ServerConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        response = client.get_server_config(project_id, zone)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetServerConfigRequest(
+            project_id=project_id, zone=zone
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_server_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        with pytest.raises(CustomException):
+            client.get_server_config(project_id, zone)
+
+    def test_list_node_pools(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cluster_service_pb2.ListNodePoolsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.list_node_pools(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListNodePoolsRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_node_pools_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.list_node_pools(project_id, zone, cluster_id)
+
+    def test_get_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        initial_node_count = 1682564205
+        self_link = "selfLink-1691268851"
+        version = "version351608024"
+        status_message = "statusMessage-239442758"
+        expected_response = {
+            "name": name,
+            "initial_node_count": initial_node_count,
+            "self_link": self_link,
+            "version": version,
+            "status_message": status_message,
+        }
+        expected_response = cluster_service_pb2.NodePool(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        response = client.get_node_pool(project_id, zone, cluster_id, node_pool_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        with pytest.raises(CustomException):
+            client.get_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+    def test_create_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool = {}
+
+        response = client.create_node_pool(project_id, zone, cluster_id, node_pool)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CreateNodePoolRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, node_pool=node_pool
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool = {}
+
+        with pytest.raises(CustomException):
+            client.create_node_pool(project_id, zone, cluster_id, node_pool)
+
+    def test_delete_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        response = client.delete_node_pool(project_id, zone, cluster_id, node_pool_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.DeleteNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        with pytest.raises(CustomException):
+            client.delete_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+    def test_rollback_node_pool_upgrade(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        response = client.rollback_node_pool_upgrade(
+            project_id, zone, cluster_id, node_pool_id
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.RollbackNodePoolUpgradeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rollback_node_pool_upgrade_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        with pytest.raises(CustomException):
+            client.rollback_node_pool_upgrade(
+                project_id, zone, cluster_id, node_pool_id
+            )
+
+    def test_set_node_pool_management(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        management = {}
+
+        response = client.set_node_pool_management(
+            project_id, zone, cluster_id, node_pool_id, management
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNodePoolManagementRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            management=management,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_node_pool_management_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        management = {}
+
+        with pytest.raises(CustomException):
+            client.set_node_pool_management(
+                project_id, zone, cluster_id, node_pool_id, management
+            )
+
+    def test_set_labels(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        resource_labels = {}
+        label_fingerprint = "labelFingerprint714995737"
+
+        response = client.set_labels(
+            project_id, zone, cluster_id, resource_labels, label_fingerprint
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLabelsRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            resource_labels=resource_labels,
+            label_fingerprint=label_fingerprint,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_labels_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        resource_labels = {}
+        label_fingerprint = "labelFingerprint714995737"
+
+        with pytest.raises(CustomException):
+            client.set_labels(
+                project_id, zone, cluster_id, resource_labels, label_fingerprint
+            )
+
+    def test_set_legacy_abac(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        enabled = False
+
+        response = client.set_legacy_abac(project_id, zone, cluster_id, enabled)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLegacyAbacRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, enabled=enabled
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_legacy_abac_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        enabled = False
+
+        with pytest.raises(CustomException):
+            client.set_legacy_abac(project_id, zone, cluster_id, enabled)
+
+    def test_start_i_p_rotation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.start_i_p_rotation(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.StartIPRotationRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_start_i_p_rotation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.start_i_p_rotation(project_id, zone, cluster_id)
+
+    def test_complete_i_p_rotation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.complete_i_p_rotation(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CompleteIPRotationRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_complete_i_p_rotation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.complete_i_p_rotation(project_id, zone, cluster_id)
+
+    def test_set_node_pool_size(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_count = 1539922066
+
+        response = client.set_node_pool_size(
+            project_id, zone, cluster_id, node_pool_id, node_count
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNodePoolSizeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_count=node_count,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_node_pool_size_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_count = 1539922066
+
+        with pytest.raises(CustomException):
+            client.set_node_pool_size(
+                project_id, zone, cluster_id, node_pool_id, node_count
+            )
+
+    def test_set_network_policy(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        network_policy = {}
+
+        response = client.set_network_policy(
+            project_id, zone, cluster_id, network_policy
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNetworkPolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            network_policy=network_policy,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_network_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        network_policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_network_policy(project_id, zone, cluster_id, network_policy)
+
+    def test_set_maintenance_policy(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        maintenance_policy = {}
+
+        response = client.set_maintenance_policy(
+            project_id, zone, cluster_id, maintenance_policy
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetMaintenancePolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            maintenance_policy=maintenance_policy,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_maintenance_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        maintenance_policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_maintenance_policy(
+                project_id, zone, cluster_id, maintenance_policy
+            )
diff --git a/container/tests/unit/gapic/v1beta1/test_cluster_manager_client_v1beta1.py b/container/tests/unit/gapic/v1beta1/test_cluster_manager_client_v1beta1.py
new file mode 100644
index 000000000000..0e02294c9d7a
--- /dev/null
+++ b/container/tests/unit/gapic/v1beta1/test_cluster_manager_client_v1beta1.py
@@ -0,0 +1,2085 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import container_v1beta1
+from google.cloud.container_v1beta1 import enums
+from google.cloud.container_v1beta1.proto import cluster_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestClusterManagerClient(object):
+    def test_list_clusters(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cluster_service_pb2.ListClustersResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        response = client.list_clusters(project_id, zone)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListClustersRequest(
+            project_id=project_id, zone=zone
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_clusters_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        with pytest.raises(CustomException):
+            client.list_clusters(project_id, zone)
+
+    def test_get_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        initial_node_count = 1682564205
+        logging_service = "loggingService-1700501035"
+        monitoring_service = "monitoringService1469270462"
+        network = "network1843485230"
+        cluster_ipv4_cidr = "clusterIpv4Cidr-141875831"
+        subnetwork = "subnetwork-1302785042"
+        enable_kubernetes_alpha = False
+        label_fingerprint = "labelFingerprint714995737"
+        private_cluster = True
+        master_ipv4_cidr_block = "masterIpv4CidrBlock-97940801"
+        self_link = "selfLink-1691268851"
+        zone_2 = "zone2-696322977"
+        endpoint = "endpoint1741102485"
+        initial_cluster_version = "initialClusterVersion-276373352"
+        current_master_version = "currentMasterVersion-920953983"
+        current_node_version = "currentNodeVersion-407476063"
+        create_time = "createTime-493574096"
+        status_message = "statusMessage-239442758"
+        node_ipv4_cidr_size = 1181176815
+        services_ipv4_cidr = "servicesIpv4Cidr1966438125"
+        current_node_count = 178977560
+        expire_time = "expireTime-96179731"
+        location = "location1901043637"
+        enable_tpu = False
+        tpu_ipv4_cidr_block = "tpuIpv4CidrBlock1137906646"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "initial_node_count": initial_node_count,
+            "logging_service": logging_service,
+            "monitoring_service": monitoring_service,
+            "network": network,
+            "cluster_ipv4_cidr": cluster_ipv4_cidr,
+            "subnetwork": subnetwork,
+            "enable_kubernetes_alpha": enable_kubernetes_alpha,
+            "label_fingerprint": label_fingerprint,
+            "private_cluster": private_cluster,
+            "master_ipv4_cidr_block": master_ipv4_cidr_block,
+            "self_link": self_link,
+            "zone": zone_2,
+            "endpoint": endpoint,
+            "initial_cluster_version": initial_cluster_version,
+            "current_master_version": current_master_version,
+            "current_node_version": current_node_version,
+            "create_time": create_time,
+            "status_message": status_message,
+            "node_ipv4_cidr_size": node_ipv4_cidr_size,
+            "services_ipv4_cidr": services_ipv4_cidr,
+            "current_node_count": current_node_count,
+            "expire_time": expire_time,
+            "location": location,
+            "enable_tpu": enable_tpu,
+            "tpu_ipv4_cidr_block": tpu_ipv4_cidr_block,
+        }
+        expected_response = cluster_service_pb2.Cluster(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.get_cluster(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.get_cluster(project_id, zone, cluster_id)
+
+    def test_create_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster = {}
+
+        response = client.create_cluster(project_id, zone, cluster)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CreateClusterRequest(
+            project_id=project_id, zone=zone, cluster=cluster
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster = {}
+
+        with pytest.raises(CustomException):
+            client.create_cluster(project_id, zone, cluster)
+
+    def test_update_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        update = {}
+
+        response = client.update_cluster(project_id, zone, cluster_id, update)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.UpdateClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, update=update
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        update = {}
+
+        with pytest.raises(CustomException):
+            client.update_cluster(project_id, zone, cluster_id, update)
+
+    def test_update_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_version = "nodeVersion1790136219"
+        image_type = "imageType-1442758754"
+
+        response = client.update_node_pool(
+            project_id, zone, cluster_id, node_pool_id, node_version, image_type
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.UpdateNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_version=node_version,
+            image_type=image_type,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_version = "nodeVersion1790136219"
+        image_type = "imageType-1442758754"
+
+        with pytest.raises(CustomException):
+            client.update_node_pool(
+                project_id, zone, cluster_id, node_pool_id, node_version, image_type
+            )
+
+    def test_set_node_pool_autoscaling(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        autoscaling = {}
+
+        response = client.set_node_pool_autoscaling(
+            project_id, zone, cluster_id, node_pool_id, autoscaling
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNodePoolAutoscalingRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            autoscaling=autoscaling,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_node_pool_autoscaling_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        autoscaling = {}
+
+        with pytest.raises(CustomException):
+            client.set_node_pool_autoscaling(
+                project_id, zone, cluster_id, node_pool_id, autoscaling
+            )
+
+    def test_set_logging_service(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        logging_service = "loggingService-1700501035"
+
+        response = client.set_logging_service(
+            project_id, zone, cluster_id, logging_service
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLoggingServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            logging_service=logging_service,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_logging_service_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        logging_service = "loggingService-1700501035"
+
+        with pytest.raises(CustomException):
+            client.set_logging_service(project_id, zone, cluster_id, logging_service)
+
+    def test_set_monitoring_service(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        monitoring_service = "monitoringService1469270462"
+
+        response = client.set_monitoring_service(
+            project_id, zone, cluster_id, monitoring_service
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetMonitoringServiceRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            monitoring_service=monitoring_service,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_monitoring_service_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        monitoring_service = "monitoringService1469270462"
+
+        with pytest.raises(CustomException):
+            client.set_monitoring_service(
+                project_id, zone, cluster_id, monitoring_service
+            )
+
+    def test_set_addons_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        addons_config = {}
+
+        response = client.set_addons_config(project_id, zone, cluster_id, addons_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetAddonsConfigRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            addons_config=addons_config,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_addons_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        addons_config = {}
+
+        with pytest.raises(CustomException):
+            client.set_addons_config(project_id, zone, cluster_id, addons_config)
+
+    def test_set_locations(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        locations = []
+
+        response = client.set_locations(project_id, zone, cluster_id, locations)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLocationsRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, locations=locations
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_locations_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        locations = []
+
+        with pytest.raises(CustomException):
+            client.set_locations(project_id, zone, cluster_id, locations)
+
+    def test_update_master(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        master_version = "masterVersion-2139460613"
+
+        response = client.update_master(project_id, zone, cluster_id, master_version)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.UpdateMasterRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            master_version=master_version,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_master_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        master_version = "masterVersion-2139460613"
+
+        with pytest.raises(CustomException):
+            client.update_master(project_id, zone, cluster_id, master_version)
+
+    def test_set_master_auth(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        action = enums.SetMasterAuthRequest.Action.UNKNOWN
+        update = {}
+
+        response = client.set_master_auth(project_id, zone, cluster_id, action, update)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetMasterAuthRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            action=action,
+            update=update,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_master_auth_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        action = enums.SetMasterAuthRequest.Action.UNKNOWN
+        update = {}
+
+        with pytest.raises(CustomException):
+            client.set_master_auth(project_id, zone, cluster_id, action, update)
+
+    def test_delete_cluster(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.delete_cluster(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.DeleteClusterRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.delete_cluster(project_id, zone, cluster_id)
+
+    def test_list_operations(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cluster_service_pb2.ListOperationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        response = client.list_operations(project_id, zone)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListOperationsRequest(
+            project_id=project_id, zone=zone
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_operations_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        with pytest.raises(CustomException):
+            client.list_operations(project_id, zone)
+
+    def test_get_operation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        response = client.get_operation(project_id, zone, operation_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_operation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        with pytest.raises(CustomException):
+            client.get_operation(project_id, zone, operation_id)
+
+    def test_cancel_operation(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        client.cancel_operation(project_id, zone, operation_id)
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CancelOperationRequest(
+            project_id=project_id, zone=zone, operation_id=operation_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_operation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        operation_id = "operationId-274116877"
+
+        with pytest.raises(CustomException):
+            client.cancel_operation(project_id, zone, operation_id)
+
+    def test_get_server_config(self):
+        # Setup Expected Response
+        default_cluster_version = "defaultClusterVersion111003029"
+        default_image_type = "defaultImageType-918225828"
+        expected_response = {
+            "default_cluster_version": default_cluster_version,
+            "default_image_type": default_image_type,
+        }
+        expected_response = cluster_service_pb2.ServerConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        response = client.get_server_config(project_id, zone)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetServerConfigRequest(
+            project_id=project_id, zone=zone
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_server_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+
+        with pytest.raises(CustomException):
+            client.get_server_config(project_id, zone)
+
+    def test_list_node_pools(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cluster_service_pb2.ListNodePoolsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.list_node_pools(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListNodePoolsRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_node_pools_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.list_node_pools(project_id, zone, cluster_id)
+
+    def test_get_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        initial_node_count = 1682564205
+        self_link = "selfLink-1691268851"
+        version = "version351608024"
+        status_message = "statusMessage-239442758"
+        expected_response = {
+            "name": name,
+            "initial_node_count": initial_node_count,
+            "self_link": self_link,
+            "version": version,
+            "status_message": status_message,
+        }
+        expected_response = cluster_service_pb2.NodePool(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        response = client.get_node_pool(project_id, zone, cluster_id, node_pool_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.GetNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        with pytest.raises(CustomException):
+            client.get_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+    def test_create_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool = {}
+
+        response = client.create_node_pool(project_id, zone, cluster_id, node_pool)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CreateNodePoolRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, node_pool=node_pool
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool = {}
+
+        with pytest.raises(CustomException):
+            client.create_node_pool(project_id, zone, cluster_id, node_pool)
+
+    def test_delete_node_pool(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        response = client.delete_node_pool(project_id, zone, cluster_id, node_pool_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.DeleteNodePoolRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_node_pool_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        with pytest.raises(CustomException):
+            client.delete_node_pool(project_id, zone, cluster_id, node_pool_id)
+
+    def test_rollback_node_pool_upgrade(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        response = client.rollback_node_pool_upgrade(
+            project_id, zone, cluster_id, node_pool_id
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.RollbackNodePoolUpgradeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rollback_node_pool_upgrade_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+
+        with pytest.raises(CustomException):
+            client.rollback_node_pool_upgrade(
+                project_id, zone, cluster_id, node_pool_id
+            )
+
+    def test_set_node_pool_management(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        management = {}
+
+        response = client.set_node_pool_management(
+            project_id, zone, cluster_id, node_pool_id, management
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNodePoolManagementRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            management=management,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_node_pool_management_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        management = {}
+
+        with pytest.raises(CustomException):
+            client.set_node_pool_management(
+                project_id, zone, cluster_id, node_pool_id, management
+            )
+
+    def test_set_labels(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        resource_labels = {}
+        label_fingerprint = "labelFingerprint714995737"
+
+        response = client.set_labels(
+            project_id, zone, cluster_id, resource_labels, label_fingerprint
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLabelsRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            resource_labels=resource_labels,
+            label_fingerprint=label_fingerprint,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_labels_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        resource_labels = {}
+        label_fingerprint = "labelFingerprint714995737"
+
+        with pytest.raises(CustomException):
+            client.set_labels(
+                project_id, zone, cluster_id, resource_labels, label_fingerprint
+            )
+
+    def test_set_legacy_abac(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        enabled = False
+
+        response = client.set_legacy_abac(project_id, zone, cluster_id, enabled)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetLegacyAbacRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id, enabled=enabled
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_legacy_abac_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        enabled = False
+
+        with pytest.raises(CustomException):
+            client.set_legacy_abac(project_id, zone, cluster_id, enabled)
+
+    def test_start_i_p_rotation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.start_i_p_rotation(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.StartIPRotationRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_start_i_p_rotation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.start_i_p_rotation(project_id, zone, cluster_id)
+
+    def test_complete_i_p_rotation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        response = client.complete_i_p_rotation(project_id, zone, cluster_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.CompleteIPRotationRequest(
+            project_id=project_id, zone=zone, cluster_id=cluster_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_complete_i_p_rotation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+
+        with pytest.raises(CustomException):
+            client.complete_i_p_rotation(project_id, zone, cluster_id)
+
+    def test_set_node_pool_size(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_count = 1539922066
+
+        response = client.set_node_pool_size(
+            project_id, zone, cluster_id, node_pool_id, node_count
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNodePoolSizeRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            node_pool_id=node_pool_id,
+            node_count=node_count,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_node_pool_size_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        node_pool_id = "nodePoolId1043384033"
+        node_count = 1539922066
+
+        with pytest.raises(CustomException):
+            client.set_node_pool_size(
+                project_id, zone, cluster_id, node_pool_id, node_count
+            )
+
+    def test_set_network_policy(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        network_policy = {}
+
+        response = client.set_network_policy(
+            project_id, zone, cluster_id, network_policy
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetNetworkPolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            network_policy=network_policy,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_network_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        network_policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_network_policy(project_id, zone, cluster_id, network_policy)
+
+    def test_set_maintenance_policy(self):
+        # Setup Expected Response
+        name = "name3373707"
+        zone_2 = "zone2-696322977"
+        detail = "detail-1335224239"
+        status_message = "statusMessage-239442758"
+        self_link = "selfLink-1691268851"
+        target_link = "targetLink-2084812312"
+        location = "location1901043637"
+        start_time = "startTime-1573145462"
+        end_time = "endTime1725551537"
+        expected_response = {
+            "name": name,
+            "zone": zone_2,
+            "detail": detail,
+            "status_message": status_message,
+            "self_link": self_link,
+            "target_link": target_link,
+            "location": location,
+            "start_time": start_time,
+            "end_time": end_time,
+        }
+        expected_response = cluster_service_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        maintenance_policy = {}
+
+        response = client.set_maintenance_policy(
+            project_id, zone, cluster_id, maintenance_policy
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.SetMaintenancePolicyRequest(
+            project_id=project_id,
+            zone=zone,
+            cluster_id=cluster_id,
+            maintenance_policy=maintenance_policy,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_maintenance_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        zone = "zone3744684"
+        cluster_id = "clusterId240280960"
+        maintenance_policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_maintenance_policy(
+                project_id, zone, cluster_id, maintenance_policy
+            )
+
+    def test_list_usable_subnetworks(self):
+        # Setup Expected Response
+        next_page_token = ""
+        subnetworks_element = {}
+        subnetworks = [subnetworks_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "subnetworks": subnetworks,
+        }
+        expected_response = cluster_service_pb2.ListUsableSubnetworksResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+
+        paged_list_response = client.list_usable_subnetworks(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.subnetworks[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListUsableSubnetworksRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_usable_subnetworks_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        parent = "parent-995424086"
+
+        paged_list_response = client.list_usable_subnetworks(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_locations(self):
+        # Setup Expected Response
+        next_page_token = "nextPageToken-1530815211"
+        expected_response = {"next_page_token": next_page_token}
+        expected_response = cluster_service_pb2.ListLocationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup Request
+        parent = "parent-995424086"
+
+        response = client.list_locations(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cluster_service_pb2.ListLocationsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_locations_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = container_v1beta1.ClusterManagerClient()
+
+        # Setup request
+        parent = "parent-995424086"
+
+        with pytest.raises(CustomException):
+            client.list_locations(parent)
diff --git a/containeranalysis/.coveragerc b/containeranalysis/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/containeranalysis/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/containeranalysis/.flake8 b/containeranalysis/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/containeranalysis/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/containeranalysis/.repo-metadata.json b/containeranalysis/.repo-metadata.json
new file mode 100644
index 000000000000..8e24dd81f175
--- /dev/null
+++ b/containeranalysis/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "containeranalysis",
+  "name_pretty": "Cloud Container Analysis",
+  "product_documentation": "https://cloud.google.com/container-registry/docs/container-analysis",
+  "client_documentation": "https://googleapis.dev/python/containeranalysis/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559777",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-containeranalysis",
+  "api_id": "containeranalysis.googleapis.com",
+  "requires_billing": false
+}
diff --git a/containeranalysis/CHANGELOG.md b/containeranalysis/CHANGELOG.md
new file mode 100644
index 000000000000..70798d534fa9
--- /dev/null
+++ b/containeranalysis/CHANGELOG.md
@@ -0,0 +1,42 @@
+# Changelog
+
+## 0.3.0
+
+08-12-2019 13:53 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8948](https://github.com/googleapis/google-cloud-python/pull/8948))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Normalize docs. ([#8994](https://github.com/googleapis/google-cloud-python/pull/8994))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.2.0
+
+07-12-2019 16:56 PDT
+
+### New Features
+- Add 'client_options' support (via synth). ([#8502](https://github.com/googleapis/google-cloud-python/pull/8502))
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8653](https://github.com/googleapis/google-cloud-python/pull/8653))
+
+### Dependencies
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Update READMEs. ([#8456](https://github.com/googleapis/google-cloud-python/pull/8456))
+
+### Internal / Testing Changes
+- Fix language in repo metadata. ([#8537](https://github.com/googleapis/google-cloud-python/pull/8537))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.1.0
+
+06-19-2019 11:02 PDT
+
+### New Features
+- Initial release of Container Analysis client library. ([#8381](https://github.com/googleapis/google-cloud-python/pull/8381))
+
diff --git a/containeranalysis/LICENSE b/containeranalysis/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/containeranalysis/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/containeranalysis/MANIFEST.in b/containeranalysis/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/containeranalysis/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/containeranalysis/README.rst b/containeranalysis/README.rst
new file mode 100644
index 000000000000..4a59b581c499
--- /dev/null
+++ b/containeranalysis/README.rst
@@ -0,0 +1,76 @@
+Python Client for Container Analysis API (`Alpha`_)
+===================================================
+
+`Container Analysis API`_: An implementation of the Grafeas API, which stores, and enables querying
+and retrieval of critical metadata about all of your software artifacts.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Container Analysis API: https://cloud.google.com/container-registry/docs/container-analysis
+.. _Client Library Documentation: https://googleapis.dev/python/containeranalysis/latest
+.. _Product Documentation:  https://cloud.google.com/container-registry/docs/container-analysis
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Container Analysis API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Container Analysis API.:  https://cloud.google.com/container-registry/docs/container-analysis
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-containeranalysis
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-containeranalysis
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Container Analysis API
+   API to see other available methods on the client.
+-  Read the `Container Analysis API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Container Analysis API Product documentation:  https://cloud.google.com/container-registry/docs/container-analysis
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/containeranalysis/docs/README.rst b/containeranalysis/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/containeranalysis/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/containeranalysis/docs/changelog.md b/containeranalysis/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/containeranalysis/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/containeranalysis/docs/conf.py b/containeranalysis/docs/conf.py
new file mode 100644
index 000000000000..4e3dd1dac2f6
--- /dev/null
+++ b/containeranalysis/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-containeranalysis documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-containeranalysis"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-containeranalysis-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-containeranalysis.tex",
+        u"google-cloud-containeranalysis Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-containeranalysis",
+        u"google-cloud-containeranalysis Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-containeranalysis",
+        u"google-cloud-containeranalysis Documentation",
+        author,
+        "google-cloud-containeranalysis",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/containeranalysis/docs/gapic/v1/api.rst b/containeranalysis/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..60a1b16a6927
--- /dev/null
+++ b/containeranalysis/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Container Analysis API
+=================================
+
+.. automodule:: google.cloud.devtools.containeranalysis_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/containeranalysis/docs/gapic/v1/types.rst b/containeranalysis/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..3940e6aeee95
--- /dev/null
+++ b/containeranalysis/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Container Analysis API Client
+=======================================
+
+.. automodule:: google.cloud.devtools.containeranalysis_v1.types
+    :members:
\ No newline at end of file
diff --git a/containeranalysis/docs/index.rst b/containeranalysis/docs/index.rst
new file mode 100644
index 000000000000..51824979bb1b
--- /dev/null
+++ b/containeranalysis/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+
+
+Changelog
+----------
+
+For all previous ``google-cloud-containeranalysis`` releases:
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/containeranalysis/google/__init__.py b/containeranalysis/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/containeranalysis/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/containeranalysis/google/cloud/__init__.py b/containeranalysis/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/containeranalysis/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/containeranalysis/google/cloud/containeranalysis_v1/proto/containeranalysis.proto b/containeranalysis/google/cloud/containeranalysis_v1/proto/containeranalysis.proto
new file mode 100644
index 000000000000..5c855acbd5ee
--- /dev/null
+++ b/containeranalysis/google/cloud/containeranalysis_v1/proto/containeranalysis.proto
@@ -0,0 +1,100 @@
+// 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.containeranalysis.v1;
+
+import "google/api/annotations.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.DevTools.ContainerAnalysis.V1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1;containeranalysis";
+option java_multiple_files = true;
+option java_package = "com.google.containeranalysis.v1";
+option objc_class_prefix = "GCA";
+
+// Retrieves analysis results of Cloud components such as Docker container
+// images. The Container Analysis API is an implementation of the
+// [Grafeas](grafeas.io) API.
+//
+// Analysis results are stored as a series of occurrences. An `Occurrence`
+// contains information about a specific analysis instance on a resource. An
+// occurrence refers to a `Note`. A note contains details describing the
+// analysis and is generally stored in a separate project, called a `Provider`.
+// Multiple occurrences can refer to the same note.
+//
+// For example, an SSL vulnerability could affect multiple images. In this case,
+// there would be one note for the vulnerability and an occurrence for each
+// image with the vulnerability referring to that note.
+service ContainerAnalysis {
+  // 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.
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/notes/*}:setIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{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.
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/notes/*}:getIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/occurrences/*}:getIamPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Returns the permissions that a caller has on the specified note or
+  // occurrence. Requires list permission on the project (for example,
+  // `containeranalysis.notes.list`).
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/notes/*}:testIamPermissions"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/occurrences/*}:testIamPermissions"
+        body: "*"
+      }
+    };
+  }
+}
diff --git a/containeranalysis/google/cloud/devtools/__init__.py b/containeranalysis/google/cloud/devtools/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis.py b/containeranalysis/google/cloud/devtools/containeranalysis.py
new file mode 100644
index 000000000000..364ca4063a47
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.devtools.containeranalysis_v1 import ContainerAnalysisClient
+from google.cloud.devtools.containeranalysis_v1 import types
+
+
+__all__ = ("types", "ContainerAnalysisClient")
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/__init__.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/__init__.py
new file mode 100644
index 000000000000..9695f705c912
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/__init__.py
@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.devtools.containeranalysis_v1 import types
+from google.cloud.devtools.containeranalysis_v1.gapic import container_analysis_client
+
+
+class ContainerAnalysisClient(container_analysis_client.ContainerAnalysisClient):
+    __doc__ = container_analysis_client.ContainerAnalysisClient.__doc__
+
+
+__all__ = ("types", "ContainerAnalysisClient")
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/__init__.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/container_analysis_client.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/container_analysis_client.py
new file mode 100644
index 000000000000..999346beec69
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/container_analysis_client.py
@@ -0,0 +1,495 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.devtools.containeranalysis.v1 ContainerAnalysis API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.devtools.containeranalysis_v1.gapic import (
+    container_analysis_client_config,
+)
+from google.cloud.devtools.containeranalysis_v1.gapic.transports import (
+    container_analysis_grpc_transport,
+)
+from google.cloud.devtools.containeranalysis_v1.proto import containeranalysis_pb2_grpc
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+
+
+from grafeas import grafeas_v1
+from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-containeranalysis"
+).version
+
+
+class ContainerAnalysisClient(object):
+    """
+    Retrieves analysis results of Cloud components such as Docker container
+    images. The Container Analysis API is an implementation of the
+    `Grafeas <https://grafeas.io>`__ API.
+
+    Analysis results are stored as a series of occurrences. An
+    ``Occurrence`` contains information about a specific analysis instance
+    on a resource. An occurrence refers to a ``Note``. A note contains
+    details describing the analysis and is generally stored in a separate
+    project, called a ``Provider``. Multiple occurrences can refer to the
+    same note.
+
+    For example, an SSL vulnerability could affect multiple images. In this
+    case, there would be one note for the vulnerability and an occurrence
+    for each image with the vulnerability referring to that note.
+    """
+
+    SERVICE_ADDRESS = "containeranalysis.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.devtools.containeranalysis.v1.ContainerAnalysis"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ContainerAnalysisClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def note_path(cls, project, note):
+        """Return a fully-qualified note string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/notes/{note}", project=project, note=note
+        )
+
+    @classmethod
+    def occurrence_path(cls, project, occurrence):
+        """Return a fully-qualified occurrence string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/occurrences/{occurrence}",
+            project=project,
+            occurrence=occurrence,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ContainerAnalysisGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ContainerAnalysisGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = container_analysis_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=container_analysis_grpc_transport.ContainerAnalysisGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = container_analysis_grpc_transport.ContainerAnalysisGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    def get_grafeas_client(self):
+        """Returns an equivalent grafeas client.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.GrafeasClient` instance.
+        """
+        grafeas_transport = grafeas_grpc_transport.GrafeasGrpcTransport(
+            self.SERVICE_ADDRESS, self.transport._OAUTH_SCOPES
+        )
+
+        return grafeas_v1.GrafeasClient(grafeas_transport)
+
+    # Service calls
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        The resource takes the format ``projects/[PROJECT_ID]/notes/[NOTE_ID]``
+        for notes and ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`` for
+        occurrences.
+
+        Example:
+            >>> from google.cloud.devtools import containeranalysis_v1
+            >>>
+            >>> client = containeranalysis_v1.ContainerAnalysisClient()
+            >>>
+            >>> resource = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.devtools.containeranalysis_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.devtools.containeranalysis_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.devtools.containeranalysis_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        The resource takes the format ``projects/[PROJECT_ID]/notes/[NOTE_ID]``
+        for notes and ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`` for
+        occurrences.
+
+        Example:
+            >>> from google.cloud.devtools import containeranalysis_v1
+            >>>
+            >>> client = containeranalysis_v1.ContainerAnalysisClient()
+            >>>
+            >>> resource = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.devtools.containeranalysis_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.devtools.containeranalysis_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.devtools.containeranalysis_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns the permissions that a caller has on the specified note or
+        occurrence. Requires list permission on the project (for example,
+        ``containeranalysis.notes.list``).
+
+        The resource takes the format ``projects/[PROJECT_ID]/notes/[NOTE_ID]``
+        for notes and ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`` for
+        occurrences.
+
+        Example:
+            >>> from google.cloud.devtools import containeranalysis_v1
+            >>>
+            >>> client = containeranalysis_v1.ContainerAnalysisClient()
+            >>>
+            >>> resource = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.devtools.containeranalysis_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/container_analysis_client_config.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/container_analysis_client_config.py
new file mode 100644
index 000000000000..f7e39b653e04
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/container_analysis_client_config.py
@@ -0,0 +1,38 @@
+config = {
+    "interfaces": {
+        "google.devtools.containeranalysis.v1.ContainerAnalysis": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "SetIamPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/transports/__init__.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/transports/container_analysis_grpc_transport.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/transports/container_analysis_grpc_transport.py
new file mode 100644
index 000000000000..dcb475629d29
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/gapic/transports/container_analysis_grpc_transport.py
@@ -0,0 +1,172 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.devtools.containeranalysis_v1.proto import containeranalysis_pb2_grpc
+
+
+class ContainerAnalysisGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.devtools.containeranalysis.v1 ContainerAnalysis API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="containeranalysis.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "container_analysis_stub": containeranalysis_pb2_grpc.ContainerAnalysisStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="containeranalysis.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`ContainerAnalysisClient.set_iam_policy`.
+
+        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.
+
+        The resource takes the format ``projects/[PROJECT_ID]/notes/[NOTE_ID]``
+        for notes and ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`` for
+        occurrences.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["container_analysis_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`ContainerAnalysisClient.get_iam_policy`.
+
+        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.
+
+        The resource takes the format ``projects/[PROJECT_ID]/notes/[NOTE_ID]``
+        for notes and ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`` for
+        occurrences.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["container_analysis_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`ContainerAnalysisClient.test_iam_permissions`.
+
+        Returns the permissions that a caller has on the specified note or
+        occurrence. Requires list permission on the project (for example,
+        ``containeranalysis.notes.list``).
+
+        The resource takes the format ``projects/[PROJECT_ID]/notes/[NOTE_ID]``
+        for notes and ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`` for
+        occurrences.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["container_analysis_stub"].TestIamPermissions
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/__init__.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis.proto b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis.proto
new file mode 100644
index 000000000000..0a54ccc6e7df
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis.proto
@@ -0,0 +1,101 @@
+// 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.containeranalysis.v1;
+
+import "google/api/annotations.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.DevTools.ContainerAnalysis.V1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1;containeranalysis";
+option java_multiple_files = true;
+option java_package = "com.google.containeranalysis.v1";
+option objc_class_prefix = "GCA";
+option ruby_package = "Google::Cloud::ContainerAnalysis::V1";
+
+// Retrieves analysis results of Cloud components such as Docker container
+// images. The Container Analysis API is an implementation of the
+// [Grafeas](https://grafeas.io) API.
+//
+// Analysis results are stored as a series of occurrences. An `Occurrence`
+// contains information about a specific analysis instance on a resource. An
+// occurrence refers to a `Note`. A note contains details describing the
+// analysis and is generally stored in a separate project, called a `Provider`.
+// Multiple occurrences can refer to the same note.
+//
+// For example, an SSL vulnerability could affect multiple images. In this case,
+// there would be one note for the vulnerability and an occurrence for each
+// image with the vulnerability referring to that note.
+service ContainerAnalysis {
+  // 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.
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/notes/*}:setIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{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.
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/notes/*}:getIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/occurrences/*}:getIamPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Returns the permissions that a caller has on the specified note or
+  // occurrence. Requires list permission on the project (for example,
+  // `containeranalysis.notes.list`).
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/notes/*}:testIamPermissions"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/occurrences/*}:testIamPermissions"
+        body: "*"
+      }
+    };
+  }
+}
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis_pb2.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis_pb2.py
new file mode 100644
index 000000000000..97ecb2b86f10
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis_pb2.py
@@ -0,0 +1,96 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/devtools/containeranalysis_v1/proto/containeranalysis.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/devtools/containeranalysis_v1/proto/containeranalysis.proto",
+    package="google.devtools.containeranalysis.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.containeranalysis.v1P\001ZUgoogle.golang.org/genproto/googleapis/devtools/containeranalysis/v1;containeranalysis\242\002\003GCA\252\002*Google.Cloud.DevTools.ContainerAnalysis.V1\352\002$Google::Cloud::ContainerAnalysis::V1"
+    ),
+    serialized_pb=_b(
+        '\nHgoogle/cloud/devtools/containeranalysis_v1/proto/containeranalysis.proto\x12$google.devtools.containeranalysis.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1fgoogle/protobuf/timestamp.proto2\x86\x05\n\x11\x43ontainerAnalysis\x12\xbf\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"t\x82\xd3\xe4\x93\x02n"./v1/{resource=projects/*/notes/*}:setIamPolicy:\x01*Z9"4/v1/{resource=projects/*/occurrences/*}:setIamPolicy:\x01*\x12\xbf\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"t\x82\xd3\xe4\x93\x02n"./v1/{resource=projects/*/notes/*}:getIamPolicy:\x01*Z9"4/v1/{resource=projects/*/occurrences/*}:getIamPolicy:\x01*\x12\xec\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"\x80\x01\x82\xd3\xe4\x93\x02z"4/v1/{resource=projects/*/notes/*}:testIamPermissions:\x01*Z?":/v1/{resource=projects/*/occurrences/*}:testIamPermissions:\x01*B\xd4\x01\n\x1f\x63om.google.containeranalysis.v1P\x01ZUgoogle.golang.org/genproto/googleapis/devtools/containeranalysis/v1;containeranalysis\xa2\x02\x03GCA\xaa\x02*Google.Cloud.DevTools.ContainerAnalysis.V1\xea\x02$Google::Cloud::ContainerAnalysis::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR._options = None
+
+_CONTAINERANALYSIS = _descriptor.ServiceDescriptor(
+    name="ContainerAnalysis",
+    full_name="google.devtools.containeranalysis.v1.ContainerAnalysis",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=238,
+    serialized_end=884,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.devtools.containeranalysis.v1.ContainerAnalysis.SetIamPolicy",
+            index=0,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002n"./v1/{resource=projects/*/notes/*}:setIamPolicy:\001*Z9"4/v1/{resource=projects/*/occurrences/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.devtools.containeranalysis.v1.ContainerAnalysis.GetIamPolicy",
+            index=1,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002n"./v1/{resource=projects/*/notes/*}:getIamPolicy:\001*Z9"4/v1/{resource=projects/*/occurrences/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.devtools.containeranalysis.v1.ContainerAnalysis.TestIamPermissions",
+            index=2,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002z"4/v1/{resource=projects/*/notes/*}:testIamPermissions:\001*Z?":/v1/{resource=projects/*/occurrences/*}:testIamPermissions:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CONTAINERANALYSIS)
+
+DESCRIPTOR.services_by_name["ContainerAnalysis"] = _CONTAINERANALYSIS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis_pb2_grpc.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis_pb2_grpc.py
new file mode 100644
index 000000000000..e7de182bc727
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/proto/containeranalysis_pb2_grpc.py
@@ -0,0 +1,126 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+
+
+class ContainerAnalysisStub(object):
+    """Retrieves analysis results of Cloud components such as Docker container
+  images. The Container Analysis API is an implementation of the
+  [Grafeas](https://grafeas.io) API.
+
+  Analysis results are stored as a series of occurrences. An `Occurrence`
+  contains information about a specific analysis instance on a resource. An
+  occurrence refers to a `Note`. A note contains details describing the
+  analysis and is generally stored in a separate project, called a `Provider`.
+  Multiple occurrences can refer to the same note.
+
+  For example, an SSL vulnerability could affect multiple images. In this case,
+  there would be one note for the vulnerability and an occurrence for each
+  image with the vulnerability referring to that note.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.devtools.containeranalysis.v1.ContainerAnalysis/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.devtools.containeranalysis.v1.ContainerAnalysis/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.devtools.containeranalysis.v1.ContainerAnalysis/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+
+
+class ContainerAnalysisServicer(object):
+    """Retrieves analysis results of Cloud components such as Docker container
+  images. The Container Analysis API is an implementation of the
+  [Grafeas](https://grafeas.io) API.
+
+  Analysis results are stored as a series of occurrences. An `Occurrence`
+  contains information about a specific analysis instance on a resource. An
+  occurrence refers to a `Note`. A note contains details describing the
+  analysis and is generally stored in a separate project, called a `Provider`.
+  Multiple occurrences can refer to the same note.
+
+  For example, an SSL vulnerability could affect multiple images. In this case,
+  there would be one note for the vulnerability and an occurrence for each
+  image with the vulnerability referring to that note.
+  """
+
+    def SetIamPolicy(self, request, context):
+        """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.
+
+    The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+    notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+    occurrences.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """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.
+
+    The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+    notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+    occurrences.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns the permissions that a caller has on the specified note or
+    occurrence. Requires list permission on the project (for example,
+    `containeranalysis.notes.list`).
+
+    The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+    notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+    occurrences.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ContainerAnalysisServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.devtools.containeranalysis.v1.ContainerAnalysis", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/containeranalysis/google/cloud/devtools/containeranalysis_v1/types.py b/containeranalysis/google/cloud/devtools/containeranalysis_v1/types.py
new file mode 100644
index 000000000000..2e4674710eb2
--- /dev/null
+++ b/containeranalysis/google/cloud/devtools/containeranalysis_v1/types.py
@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [iam_policy_pb2, options_pb2, policy_pb2, expr_pb2]
+
+_local_modules = []
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.devtools.containeranalysis_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/containeranalysis/noxfile.py b/containeranalysis/noxfile.py
new file mode 100644
index 000000000000..7b81e2c3bcdc
--- /dev/null
+++ b/containeranalysis/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=51")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/containeranalysis/setup.cfg b/containeranalysis/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/containeranalysis/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/containeranalysis/setup.py b/containeranalysis/setup.py
new file mode 100644
index 000000000000..d92c135af22c
--- /dev/null
+++ b/containeranalysis/setup.py
@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+
+name = "google-cloud-containeranalysis"
+description = "Container Analysis API API client library"
+version = "0.3.0"
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+    'enum34; python_version < "3.4"',
+    "grafeas",
+]
+
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/googleapis/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/containeranalysis/synth.metadata b/containeranalysis/synth.metadata
new file mode 100644
index 000000000000..1edc47ed9c3d
--- /dev/null
+++ b/containeranalysis/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:18:03.197749Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "containeranalysis",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/devtools/containeranalysis/artman_containeranalysis_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/containeranalysis/synth.py b/containeranalysis/synth.py
new file mode 100644
index 000000000000..35c1978464f2
--- /dev/null
+++ b/containeranalysis/synth.py
@@ -0,0 +1,79 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate Container Analysis GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "containeranalysis",
+    "v1",
+    config_path="/google/devtools/containeranalysis/artman_containeranalysis_v1.yaml",
+    include_protos=True,
+)
+
+excludes = ["nox.py", "setup.py", "google/cloud/containeranalysis_v1/proto", "README.rst", "docs/index.rst"]
+
+s.move(library, excludes=excludes)
+# .proto files end up in the wrong place by default
+s.move(library / "google/cloud/containeranalysis_v1/proto", "google/cloud/devtools/containeranalysis_v1/proto")
+
+
+# Insert helper method to get grafeas client
+s.replace("google/**/container_analysis_client.py", 
+r"""_GAPIC_LIBRARY_VERSION = pkg_resources\.get_distribution\(
+    'google-cloud-containeranalysis',
+\)\.version""",
+r"""from grafeas import grafeas_v1
+from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-containeranalysis"
+).version
+""")
+
+s.replace("google/**/container_analysis_client.py",
+r'''    \# Service calls
+    def set_iam_policy\(''',
+r'''    def get_grafeas_client(self):
+        """Returns an equivalent grafeas client.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.GrafeasClient` instance.
+        """
+        grafeas_transport = grafeas_grpc_transport.GrafeasGrpcTransport(
+            self.SERVICE_ADDRESS,
+            self.transport._OAUTH_SCOPES)
+
+        return grafeas_v1.GrafeasClient(grafeas_transport)
+
+    # Service calls
+    def set_iam_policy(''')
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=51, cov_level=51)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/containeranalysis/tests/unit/gapic/v1/test_container_analysis_client_v1.py b/containeranalysis/tests/unit/gapic/v1/test_container_analysis_client_v1.py
new file mode 100644
index 000000000000..416531cd88c0
--- /dev/null
+++ b/containeranalysis/tests/unit/gapic/v1/test_container_analysis_client_v1.py
@@ -0,0 +1,187 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.devtools import containeranalysis_v1
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestContainerAnalysisClient(object):
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = containeranalysis_v1.ContainerAnalysisClient()
+
+        # Setup Request
+        resource = client.note_path("[PROJECT]", "[NOTE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = containeranalysis_v1.ContainerAnalysisClient()
+
+        # Setup request
+        resource = client.note_path("[PROJECT]", "[NOTE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = containeranalysis_v1.ContainerAnalysisClient()
+
+        # Setup Request
+        resource = client.note_path("[PROJECT]", "[NOTE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = containeranalysis_v1.ContainerAnalysisClient()
+
+        # Setup request
+        resource = client.note_path("[PROJECT]", "[NOTE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = containeranalysis_v1.ContainerAnalysisClient()
+
+        # Setup Request
+        resource = client.note_path("[PROJECT]", "[NOTE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = containeranalysis_v1.ContainerAnalysisClient()
+
+        # Setup request
+        resource = client.note_path("[PROJECT]", "[NOTE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/core/.coveragerc b/core/.coveragerc
new file mode 100644
index 000000000000..ce75f605a508
--- /dev/null
+++ b/core/.coveragerc
@@ -0,0 +1,18 @@
+[run]
+branch = True
+
+[report]
+omit =
+    google/cloud/_testing.py
+    google/cloud/__init__.py
+    google/cloud/environment_vars.py
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+    raise NotImplementedError()
diff --git a/core/.flake8 b/core/.flake8
new file mode 100644
index 000000000000..3da787cdfbf3
--- /dev/null
+++ b/core/.flake8
@@ -0,0 +1,11 @@
+[flake8]
+import-order-style=google
+# Note: this forces all google imports to be in the third group. See
+# https://github.com/PyCQA/flake8-import-order/issues/111
+application-import-names=google
+ignore = E203, E266, E501, W503
+exclude =
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/core/.repo-metadata.json b/core/.repo-metadata.json
new file mode 100644
index 000000000000..aa91b47586b6
--- /dev/null
+++ b/core/.repo-metadata.json
@@ -0,0 +1,9 @@
+{
+  "name": "google-cloud-core",
+  "name_pretty": "Google API client core library",
+  "client_documentation": "https://googleapis.dev/python/google-cloud-core/latest",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-core"
+}
\ No newline at end of file
diff --git a/core/CHANGELOG.md b/core/CHANGELOG.md
new file mode 100644
index 000000000000..0239bcf2b71c
--- /dev/null
+++ b/core/CHANGELOG.md
@@ -0,0 +1,130 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-core/#history
+
+## 1.0.3
+
+07-26-2019 10:34 PDT
+
+
+### Implementation Changes
+- Make `Client.build_api_url` an instance method. ([#8747](https://github.com/googleapis/google-cloud-python/pull/8747))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Linkify the PR in the change log. ([#8790](https://github.com/googleapis/google-cloud-python/pull/8790))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Removing typing information for `**kwargs` in order to not conflict with type checkers. ([#8546](https://github.com/googleapis/google-cloud-python/pull/8546))
+
+### Internal / Testing Changes
+- Add nox session 'docs' to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 1.0.2
+
+06/11/2019 15:19 PDT
+
+### Internal Changes 
+- Prevent requests from hanging on SSL handshake issue by adding a max timeout of 5 minutes. ([#8207](https://github.com/googleapis/google-cloud-python/pull/8207))
+
+## 1.0.1
+
+05-28-2019 11:22 PDT
+
+### Dependencies
+- Pin `grpcio < 2.0dev`. ([#8182](https://github.com/googleapis/google-cloud-python/pull/8182))
+
+## 1.0.0
+
+05-15-2019 13:09 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Refactor `client_info` support. ([#7849](https://github.com/googleapis/google-cloud-python/pull/7849))
+
+### Dependencies
+- Update dep on `api_core` >= 1.11.0. ([#7986](https://github.com/googleapis/google-cloud-python/pull/7986))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+## 0.29.1
+
+12-17-2018 16:35 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+## 0.29.0
+
+12-03-2018 15:54 PST
+
+### Breaking Changes
+- Remove iam module from core. This module is now available as part of google-api-core. ([#6775](https://github.com/googleapis/google-cloud-python/pull/6775))
+
+### Implementation Changes
+- Fix `_time_from_iso8601_time_naive` for values with micros. ([#5756](https://github.com/googleapis/google-cloud-python/pull/5756))
+- Import stdlib ABCs from `collections.abc` rather than `collections`. ([#6451](https://github.com/googleapis/google-cloud-python/pull/6451))
+
+### Dependencies
+- Bump minimum `api_core` version to 1.0.0. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Internal / Testing Changes
+- Blacken api_core and core. ([#6668](https://github.com/googleapis/google-cloud-python/pull/6668))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox. ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Use inplace installs for nox ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Fix bad trove classifier.
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+
+## 0.28.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+- Requiring 'grpcio >= 1.8.2'. (#4642)
+
+### Documentation
+
+- DefaultCredentialsError could be raised if credentials not supplied (#4688)
+- Unreachable links in the readme files have been fixed. (#4406)
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 0.28.0
+
+### Notable Implementation Changes
+
+- A large portion of the implementation has moved into
+  [`google-api-core`][2] (#4022, #4041, #4057, #4067,
+  #4069, #4079, #4081, #4166, #4221)
+
+### Dependencies
+
+- Explicit depending on `google-api-core` and upgrading to
+  `grpcio >= 1.7.0` (see #4096, #4280 and
+  https://github.com/grpc/grpc/issues/12455)
+
+### Interface changes / additions
+
+- Rename `google.cloud.obselete` module to
+  `obsolete` (#3913, h/t to @dimaqq)
+
+PyPI: https://pypi.org/project/google-cloud-core/0.28.0/
+
+[2]: https://pypi.org/project/google-api-core/
diff --git a/core/LICENSE b/core/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/core/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/core/MANIFEST.in b/core/MANIFEST.in
new file mode 100644
index 000000000000..1fbc0d0b321e
--- /dev/null
+++ b/core/MANIFEST.in
@@ -0,0 +1,3 @@
+include README.rst LICENSE
+recursive-include tests *
+global-exclude *.pyc __pycache__
diff --git a/core/README.rst b/core/README.rst
new file mode 100644
index 000000000000..fa8647c91083
--- /dev/null
+++ b/core/README.rst
@@ -0,0 +1,39 @@
+Core Helpers for Google Cloud Python Client Library
+===================================================
+
+|pypi| |versions| 
+
+This library is not meant to stand-alone. Instead it defines
+common helpers (e.g. base ``Client`` classes) used by all of the
+``google-cloud-*`` packages.
+
+
+-  `Documentation`_
+
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-core.svg
+   :target: https://pypi.org/project/google-cloud-core/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-core.svg
+   :target: https://pypi.org/project/google-cloud-core/
+.. _Documentation: https://googleapis.dev/python/google-cloud-core/latest
+
+Quick Start
+-----------
+
+.. code-block:: console
+
+    $ pip install --upgrade google-cloud-core
+
+For more information on setting up your Python development environment,
+such as installing ``pip`` and ``virtualenv`` on your system, please refer
+to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
+
+.. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup
+
+
+Supported Python Versions
+-------------------------
+Python >= 3.5
+
+Deprecated Python Versions
+--------------------------
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
diff --git a/core/docs/changelog.md b/core/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/core/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/core/docs/client.rst b/core/docs/client.rst
new file mode 100644
index 000000000000..3d16e2aa9f54
--- /dev/null
+++ b/core/docs/client.rst
@@ -0,0 +1,6 @@
+Base Client
+===========
+
+.. automodule:: google.cloud.client
+  :members:
+  :show-inheritance:
diff --git a/core/docs/conf.py b/core/docs/conf.py
new file mode 100644
index 000000000000..893752870198
--- /dev/null
+++ b/core/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-core documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-core"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-core-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-core.tex",
+        u"google-cloud-core Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-core", u"google-cloud-core Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-core",
+        u"google-cloud-core Documentation",
+        author,
+        "google-cloud-core",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/core/docs/config.rst b/core/docs/config.rst
new file mode 100644
index 000000000000..b98922a4f627
--- /dev/null
+++ b/core/docs/config.rst
@@ -0,0 +1,68 @@
+Configuration
+*************
+
+Overview
+========
+
+Use service client objects to configure your applications.
+
+For example:
+
+.. code-block:: python
+
+    >>> from google.cloud import bigquery
+    >>> client = bigquery.Client()
+
+When creating a client in this way, the project ID will be determined by
+searching these locations in the following order.
+
+* GOOGLE_CLOUD_PROJECT environment variable
+* GOOGLE_APPLICATION_CREDENTIALS JSON file
+* Default service configuration path from
+  ``$ gcloud beta auth application-default login``.
+* Google App Engine application ID
+* Google Compute Engine project ID (from metadata server)
+
+You can override the detection of your default project by setting the
+ ``project`` parameter when creating client objects.
+
+.. code-block:: python
+
+    >>> from google.cloud import bigquery
+    >>> client = bigquery.Client(project='my-project')
+
+You can see what project ID a client is referencing by accessing the ``project``
+property on the client object.
+
+.. code-block:: python
+
+    >>> client.project
+    u'my-project'
+
+Authentication
+==============
+
+The authentication credentials can be implicitly determined from the
+environment or directly. See `Authentication <https://googleapis.dev/python/google-api-core/latest/auth.html#authentication>`_.
+
+Logging in via ``gcloud beta auth application-default login`` will
+automatically configure a JSON key file with your default project ID and
+credentials.
+
+Setting the ``GOOGLE_APPLICATION_CREDENTIALS`` and ``GOOGLE_CLOUD_PROJECT``
+environment variables will override the automatically configured credentials.
+
+You can change your default project ID to ``my-new-default-project`` by
+using the ``gcloud`` CLI tool to change the configuration.
+
+.. code-block:: bash
+
+    $ gcloud config set project my-new-default-project
+
+
+Environment Variables
+=====================
+
+.. automodule:: google.cloud.environment_vars
+  :members:
+  :show-inheritance:
diff --git a/core/docs/index.rst b/core/docs/index.rst
new file mode 100644
index 000000000000..fa77d7d4050a
--- /dev/null
+++ b/core/docs/index.rst
@@ -0,0 +1,20 @@
+The ``google-cloud-core`` package contains helpers common to all
+``google-cloud-*`` packages. In an attempt to reach a stable API,
+much of the functionality has been split out into a new package
+``google-api-core``.
+
+
+Core
+====
+
+.. toctree::
+    config
+    client
+
+Changelog
+~~~~~~~~~
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
diff --git a/core/google/__init__.py b/core/google/__init__.py
new file mode 100644
index 000000000000..0d0a4c3ab273
--- /dev/null
+++ b/core/google/__init__.py
@@ -0,0 +1,24 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google namespace package."""
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/core/google/cloud/__init__.py b/core/google/cloud/__init__.py
new file mode 100644
index 000000000000..f281ec007149
--- /dev/null
+++ b/core/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud namespace package."""
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/core/google/cloud/_helpers.py b/core/google/cloud/_helpers.py
new file mode 100644
index 000000000000..52a96b80e396
--- /dev/null
+++ b/core/google/cloud/_helpers.py
@@ -0,0 +1,636 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shared helpers for Google Cloud packages.
+
+This module is not part of the public API surface.
+"""
+
+from __future__ import absolute_import
+
+import calendar
+import datetime
+import os
+import re
+from threading import local as Local
+
+import six
+from six.moves import http_client
+
+import google.auth
+import google.auth.transport.requests
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+
+try:
+    import grpc
+    import google.auth.transport.grpc
+except ImportError:  # pragma: NO COVER
+    grpc = None
+
+
+_NOW = datetime.datetime.utcnow  # To be replaced by tests.
+_RFC3339_MICROS = "%Y-%m-%dT%H:%M:%S.%fZ"
+_RFC3339_NO_FRACTION = "%Y-%m-%dT%H:%M:%S"
+_TIMEONLY_W_MICROS = "%H:%M:%S.%f"
+_TIMEONLY_NO_FRACTION = "%H:%M:%S"
+# datetime.strptime cannot handle nanosecond precision:  parse w/ regex
+_RFC3339_NANOS = re.compile(
+    r"""
+    (?P<no_fraction>
+        \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}  # YYYY-MM-DDTHH:MM:SS
+    )
+    (                                        # Optional decimal part
+     \.                                      # decimal point
+     (?P<nanos>\d{1,9})                      # nanoseconds, maybe truncated
+    )?
+    Z                                        # Zulu
+""",
+    re.VERBOSE,
+)
+# NOTE: Catching this ImportError is a workaround for GAE not supporting the
+#       "pwd" module which is imported lazily when "expanduser" is called.
+try:
+    _USER_ROOT = os.path.expanduser("~")
+except ImportError:  # pragma: NO COVER
+    _USER_ROOT = None
+_GCLOUD_CONFIG_FILE = os.path.join("gcloud", "configurations", "config_default")
+_GCLOUD_CONFIG_SECTION = "core"
+_GCLOUD_CONFIG_KEY = "project"
+
+
+class _LocalStack(Local):
+    """Manage a thread-local LIFO stack of resources.
+
+    Intended for use in :class:`google.cloud.datastore.batch.Batch.__enter__`,
+    :class:`google.cloud.storage.batch.Batch.__enter__`, etc.
+    """
+
+    def __init__(self):
+        super(_LocalStack, self).__init__()
+        self._stack = []
+
+    def __iter__(self):
+        """Iterate the stack in LIFO order.
+        """
+        return iter(reversed(self._stack))
+
+    def push(self, resource):
+        """Push a resource onto our stack.
+        """
+        self._stack.append(resource)
+
+    def pop(self):
+        """Pop a resource from our stack.
+
+        :rtype: object
+        :returns: the top-most resource, after removing it.
+        :raises IndexError: if the stack is empty.
+        """
+        return self._stack.pop()
+
+    @property
+    def top(self):
+        """Get the top-most resource
+
+        :rtype: object
+        :returns: the top-most item, or None if the stack is empty.
+        """
+        if self._stack:
+            return self._stack[-1]
+
+
+class _UTC(datetime.tzinfo):
+    """Basic UTC implementation.
+
+    Implementing a small surface area to avoid depending on ``pytz``.
+    """
+
+    _dst = datetime.timedelta(0)
+    _tzname = "UTC"
+    _utcoffset = _dst
+
+    def dst(self, dt):  # pylint: disable=unused-argument
+        """Daylight savings time offset."""
+        return self._dst
+
+    def fromutc(self, dt):
+        """Convert a timestamp from (naive) UTC to this timezone."""
+        if dt.tzinfo is None:
+            return dt.replace(tzinfo=self)
+        return super(_UTC, self).fromutc(dt)
+
+    def tzname(self, dt):  # pylint: disable=unused-argument
+        """Get the name of this timezone."""
+        return self._tzname
+
+    def utcoffset(self, dt):  # pylint: disable=unused-argument
+        """UTC offset of this timezone."""
+        return self._utcoffset
+
+    def __repr__(self):
+        return "<%s>" % (self._tzname,)
+
+    def __str__(self):
+        return self._tzname
+
+
+def _ensure_tuple_or_list(arg_name, tuple_or_list):
+    """Ensures an input is a tuple or list.
+
+    This effectively reduces the iterable types allowed to a very short
+    whitelist: list and tuple.
+
+    :type arg_name: str
+    :param arg_name: Name of argument to use in error message.
+
+    :type tuple_or_list: sequence of str
+    :param tuple_or_list: Sequence to be verified.
+
+    :rtype: list of str
+    :returns: The ``tuple_or_list`` passed in cast to a ``list``.
+    :raises TypeError: if the ``tuple_or_list`` is not a tuple or list.
+    """
+    if not isinstance(tuple_or_list, (tuple, list)):
+        raise TypeError(
+            "Expected %s to be a tuple or list. "
+            "Received %r" % (arg_name, tuple_or_list)
+        )
+    return list(tuple_or_list)
+
+
+def _determine_default_project(project=None):
+    """Determine default project ID explicitly or implicitly as fall-back.
+
+    See :func:`google.auth.default` for details on how the default project
+    is determined.
+
+    :type project: str
+    :param project: Optional. The project name to use as default.
+
+    :rtype: str or ``NoneType``
+    :returns: Default project if it can be determined.
+    """
+    if project is None:
+        _, project = google.auth.default()
+    return project
+
+
+def _millis(when):
+    """Convert a zone-aware datetime to integer milliseconds.
+
+    :type when: :class:`datetime.datetime`
+    :param when: the datetime to convert
+
+    :rtype: int
+    :returns: milliseconds since epoch for ``when``
+    """
+    micros = _microseconds_from_datetime(when)
+    return micros // 1000
+
+
+def _datetime_from_microseconds(value):
+    """Convert timestamp to datetime, assuming UTC.
+
+    :type value: float
+    :param value: The timestamp to convert
+
+    :rtype: :class:`datetime.datetime`
+    :returns: The datetime object created from the value.
+    """
+    return _EPOCH + datetime.timedelta(microseconds=value)
+
+
+def _microseconds_from_datetime(value):
+    """Convert non-none datetime to microseconds.
+
+    :type value: :class:`datetime.datetime`
+    :param value: The timestamp to convert.
+
+    :rtype: int
+    :returns: The timestamp, in microseconds.
+    """
+    if not value.tzinfo:
+        value = value.replace(tzinfo=UTC)
+    # Regardless of what timezone is on the value, convert it to UTC.
+    value = value.astimezone(UTC)
+    # Convert the datetime to a microsecond timestamp.
+    return int(calendar.timegm(value.timetuple()) * 1e6) + value.microsecond
+
+
+def _millis_from_datetime(value):
+    """Convert non-none datetime to timestamp, assuming UTC.
+
+    :type value: :class:`datetime.datetime`
+    :param value: (Optional) the timestamp
+
+    :rtype: int, or ``NoneType``
+    :returns: the timestamp, in milliseconds, or None
+    """
+    if value is not None:
+        return _millis(value)
+
+
+def _date_from_iso8601_date(value):
+    """Convert a ISO8601 date string to native datetime date
+
+    :type value: str
+    :param value: The date string to convert
+
+    :rtype: :class:`datetime.date`
+    :returns: A datetime date object created from the string
+
+    """
+    return datetime.datetime.strptime(value, "%Y-%m-%d").date()
+
+
+def _time_from_iso8601_time_naive(value):
+    """Convert a zoneless ISO8601 time string to naive datetime time
+
+    :type value: str
+    :param value: The time string to convert
+
+    :rtype: :class:`datetime.time`
+    :returns: A datetime time object created from the string
+    :raises ValueError: if the value does not match a known format.
+    """
+    if len(value) == 8:  # HH:MM:SS
+        fmt = _TIMEONLY_NO_FRACTION
+    elif len(value) == 15:  # HH:MM:SS.micros
+        fmt = _TIMEONLY_W_MICROS
+    else:
+        raise ValueError("Unknown time format: {}".format(value))
+    return datetime.datetime.strptime(value, fmt).time()
+
+
+def _rfc3339_to_datetime(dt_str):
+    """Convert a microsecond-precision timestamp to a native datetime.
+
+    :type dt_str: str
+    :param dt_str: The string to convert.
+
+    :rtype: :class:`datetime.datetime`
+    :returns: The datetime object created from the string.
+    """
+    return datetime.datetime.strptime(dt_str, _RFC3339_MICROS).replace(tzinfo=UTC)
+
+
+def _rfc3339_nanos_to_datetime(dt_str):
+    """Convert a nanosecond-precision timestamp to a native datetime.
+
+    .. note::
+
+       Python datetimes do not support nanosecond precision;  this function
+       therefore truncates such values to microseconds.
+
+    :type dt_str: str
+    :param dt_str: The string to convert.
+
+    :rtype: :class:`datetime.datetime`
+    :returns: The datetime object created from the string.
+    :raises ValueError: If the timestamp does not match the RFC 3339
+                        regular expression.
+    """
+    with_nanos = _RFC3339_NANOS.match(dt_str)
+    if with_nanos is None:
+        raise ValueError(
+            "Timestamp: %r, does not match pattern: %r"
+            % (dt_str, _RFC3339_NANOS.pattern)
+        )
+    bare_seconds = datetime.datetime.strptime(
+        with_nanos.group("no_fraction"), _RFC3339_NO_FRACTION
+    )
+    fraction = with_nanos.group("nanos")
+    if fraction is None:
+        micros = 0
+    else:
+        scale = 9 - len(fraction)
+        nanos = int(fraction) * (10 ** scale)
+        micros = nanos // 1000
+    return bare_seconds.replace(microsecond=micros, tzinfo=UTC)
+
+
+def _datetime_to_rfc3339(value, ignore_zone=True):
+    """Convert a timestamp to a string.
+
+    :type value: :class:`datetime.datetime`
+    :param value: The datetime object to be converted to a string.
+
+    :type ignore_zone: bool
+    :param ignore_zone: If True, then the timezone (if any) of the datetime
+                        object is ignored.
+
+    :rtype: str
+    :returns: The string representing the datetime stamp.
+    """
+    if not ignore_zone and value.tzinfo is not None:
+        # Convert to UTC and remove the time zone info.
+        value = value.replace(tzinfo=None) - value.utcoffset()
+
+    return value.strftime(_RFC3339_MICROS)
+
+
+def _to_bytes(value, encoding="ascii"):
+    """Converts a string value to bytes, if necessary.
+
+    Unfortunately, ``six.b`` is insufficient for this task since in
+    Python2 it does not modify ``unicode`` objects.
+
+    :type value: str / bytes or unicode
+    :param value: The string/bytes value to be converted.
+
+    :type encoding: str
+    :param encoding: The encoding to use to convert unicode to bytes. Defaults
+                     to "ascii", which will not allow any characters from
+                     ordinals larger than 127. Other useful values are
+                     "latin-1", which which will only allows byte ordinals
+                     (up to 255) and "utf-8", which will encode any unicode
+                     that needs to be.
+
+    :rtype: str / bytes
+    :returns: The original value converted to bytes (if unicode) or as passed
+              in if it started out as bytes.
+    :raises TypeError: if the value could not be converted to bytes.
+    """
+    result = value.encode(encoding) if isinstance(value, six.text_type) else value
+    if isinstance(result, six.binary_type):
+        return result
+    else:
+        raise TypeError("%r could not be converted to bytes" % (value,))
+
+
+def _bytes_to_unicode(value):
+    """Converts bytes to a unicode value, if necessary.
+
+    :type value: bytes
+    :param value: bytes value to attempt string conversion on.
+
+    :rtype: str
+    :returns: The original value converted to unicode (if bytes) or as passed
+              in if it started out as unicode.
+
+    :raises ValueError: if the value could not be converted to unicode.
+    """
+    result = value.decode("utf-8") if isinstance(value, six.binary_type) else value
+    if isinstance(result, six.text_type):
+        return result
+    else:
+        raise ValueError("%r could not be converted to unicode" % (value,))
+
+
+def _from_any_pb(pb_type, any_pb):
+    """Converts an Any protobuf to the specified message type
+
+    Args:
+        pb_type (type): the type of the message that any_pb stores an instance
+            of.
+        any_pb (google.protobuf.any_pb2.Any): the object to be converted.
+
+    Returns:
+        pb_type: An instance of the pb_type message.
+
+    Raises:
+        TypeError: if the message could not be converted.
+    """
+    msg = pb_type()
+    if not any_pb.Unpack(msg):
+        raise TypeError(
+            "Could not convert {} to {}".format(
+                any_pb.__class__.__name__, pb_type.__name__
+            )
+        )
+
+    return msg
+
+
+def _pb_timestamp_to_datetime(timestamp_pb):
+    """Convert a Timestamp protobuf to a datetime object.
+
+    :type timestamp_pb: :class:`google.protobuf.timestamp_pb2.Timestamp`
+    :param timestamp_pb: A Google returned timestamp protobuf.
+
+    :rtype: :class:`datetime.datetime`
+    :returns: A UTC datetime object converted from a protobuf timestamp.
+    """
+    return _EPOCH + datetime.timedelta(
+        seconds=timestamp_pb.seconds, microseconds=(timestamp_pb.nanos / 1000.0)
+    )
+
+
+def _pb_timestamp_to_rfc3339(timestamp_pb):
+    """Convert a Timestamp protobuf to an RFC 3339 string.
+
+    :type timestamp_pb: :class:`google.protobuf.timestamp_pb2.Timestamp`
+    :param timestamp_pb: A Google returned timestamp protobuf.
+
+    :rtype: str
+    :returns: An RFC 3339 formatted timestamp string.
+    """
+    timestamp = _pb_timestamp_to_datetime(timestamp_pb)
+    return _datetime_to_rfc3339(timestamp)
+
+
+def _datetime_to_pb_timestamp(when):
+    """Convert a datetime object to a Timestamp protobuf.
+
+    :type when: :class:`datetime.datetime`
+    :param when: the datetime to convert
+
+    :rtype: :class:`google.protobuf.timestamp_pb2.Timestamp`
+    :returns: A timestamp protobuf corresponding to the object.
+    """
+    ms_value = _microseconds_from_datetime(when)
+    seconds, micros = divmod(ms_value, 10 ** 6)
+    nanos = micros * 10 ** 3
+    return timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
+
+
+def _timedelta_to_duration_pb(timedelta_val):
+    """Convert a Python timedelta object to a duration protobuf.
+
+    .. note::
+
+        The Python timedelta has a granularity of microseconds while
+        the protobuf duration type has a duration of nanoseconds.
+
+    :type timedelta_val: :class:`datetime.timedelta`
+    :param timedelta_val: A timedelta object.
+
+    :rtype: :class:`google.protobuf.duration_pb2.Duration`
+    :returns: A duration object equivalent to the time delta.
+    """
+    duration_pb = duration_pb2.Duration()
+    duration_pb.FromTimedelta(timedelta_val)
+    return duration_pb
+
+
+def _duration_pb_to_timedelta(duration_pb):
+    """Convert a duration protobuf to a Python timedelta object.
+
+    .. note::
+
+        The Python timedelta has a granularity of microseconds while
+        the protobuf duration type has a duration of nanoseconds.
+
+    :type duration_pb: :class:`google.protobuf.duration_pb2.Duration`
+    :param duration_pb: A protobuf duration object.
+
+    :rtype: :class:`datetime.timedelta`
+    :returns: The converted timedelta object.
+    """
+    return datetime.timedelta(
+        seconds=duration_pb.seconds, microseconds=(duration_pb.nanos / 1000.0)
+    )
+
+
+def _name_from_project_path(path, project, template):
+    """Validate a URI path and get the leaf object's name.
+
+    :type path: str
+    :param path: URI path containing the name.
+
+    :type project: str
+    :param project: (Optional) The project associated with the request. It is
+                    included for validation purposes.  If passed as None,
+                    disables validation.
+
+    :type template: str
+    :param template: Template regex describing the expected form of the path.
+                     The regex must have two named groups, 'project' and
+                     'name'.
+
+    :rtype: str
+    :returns: Name parsed from ``path``.
+    :raises ValueError: if the ``path`` is ill-formed or if the project from
+                        the ``path`` does not agree with the ``project``
+                        passed in.
+    """
+    if isinstance(template, str):
+        template = re.compile(template)
+
+    match = template.match(path)
+
+    if not match:
+        raise ValueError(
+            'path "%s" did not match expected pattern "%s"' % (path, template.pattern)
+        )
+
+    if project is not None:
+        found_project = match.group("project")
+        if found_project != project:
+            raise ValueError(
+                "Project from client (%s) should agree with "
+                "project from resource(%s)." % (project, found_project)
+            )
+
+    return match.group("name")
+
+
+def make_secure_channel(credentials, user_agent, host, extra_options=()):
+    """Makes a secure channel for an RPC service.
+
+    Uses / depends on gRPC.
+
+    :type credentials: :class:`google.auth.credentials.Credentials`
+    :param credentials: The OAuth2 Credentials to use for creating
+                        access tokens.
+
+    :type user_agent: str
+    :param user_agent: The user agent to be used with API requests.
+
+    :type host: str
+    :param host: The host for the service.
+
+    :type extra_options: tuple
+    :param extra_options: (Optional) Extra gRPC options used when creating the
+                          channel.
+
+    :rtype: :class:`grpc._channel.Channel`
+    :returns: gRPC secure channel with credentials attached.
+    """
+    target = "%s:%d" % (host, http_client.HTTPS_PORT)
+    http_request = google.auth.transport.requests.Request()
+
+    user_agent_option = ("grpc.primary_user_agent", user_agent)
+    options = (user_agent_option,) + extra_options
+    return google.auth.transport.grpc.secure_authorized_channel(
+        credentials, http_request, target, options=options
+    )
+
+
+def make_secure_stub(credentials, user_agent, stub_class, host, extra_options=()):
+    """Makes a secure stub for an RPC service.
+
+    Uses / depends on gRPC.
+
+    :type credentials: :class:`google.auth.credentials.Credentials`
+    :param credentials: The OAuth2 Credentials to use for creating
+                        access tokens.
+
+    :type user_agent: str
+    :param user_agent: The user agent to be used with API requests.
+
+    :type stub_class: type
+    :param stub_class: A gRPC stub type for a given service.
+
+    :type host: str
+    :param host: The host for the service.
+
+    :type extra_options: tuple
+    :param extra_options: (Optional) Extra gRPC options passed when creating
+                          the channel.
+
+    :rtype: object, instance of ``stub_class``
+    :returns: The stub object used to make gRPC requests to a given API.
+    """
+    channel = make_secure_channel(
+        credentials, user_agent, host, extra_options=extra_options
+    )
+    return stub_class(channel)
+
+
+def make_insecure_stub(stub_class, host, port=None):
+    """Makes an insecure stub for an RPC service.
+
+    Uses / depends on gRPC.
+
+    :type stub_class: type
+    :param stub_class: A gRPC stub type for a given service.
+
+    :type host: str
+    :param host: The host for the service. May also include the port
+                 if ``port`` is unspecified.
+
+    :type port: int
+    :param port: (Optional) The port for the service.
+
+    :rtype: object, instance of ``stub_class``
+    :returns: The stub object used to make gRPC requests to a given API.
+    """
+    if port is None:
+        target = host
+    else:
+        # NOTE: This assumes port != http_client.HTTPS_PORT:
+        target = "%s:%d" % (host, port)
+    channel = grpc.insecure_channel(target)
+    return stub_class(channel)
+
+
+try:
+    from pytz import UTC  # pylint: disable=unused-import,wrong-import-order
+except ImportError:  # pragma: NO COVER
+    UTC = _UTC()  # Singleton instance to be used throughout.
+
+# Need to define _EPOCH at the end of module since it relies on UTC.
+_EPOCH = datetime.datetime.utcfromtimestamp(0).replace(tzinfo=UTC)
diff --git a/core/google/cloud/_http.py b/core/google/cloud/_http.py
new file mode 100644
index 000000000000..1e145e3a5c34
--- /dev/null
+++ b/core/google/cloud/_http.py
@@ -0,0 +1,398 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shared implementation of connections to API servers."""
+
+import json
+import platform
+import warnings
+
+from pkg_resources import get_distribution
+from six.moves.urllib.parse import urlencode
+
+from google.api_core.client_info import ClientInfo
+from google.cloud import exceptions
+
+
+API_BASE_URL = "https://www.googleapis.com"
+"""The base of the API call URL."""
+
+DEFAULT_USER_AGENT = "gcloud-python/{0}".format(
+    get_distribution("google-cloud-core").version
+)
+"""The user agent for google-cloud-python requests."""
+
+CLIENT_INFO_HEADER = "X-Goog-API-Client"
+CLIENT_INFO_TEMPLATE = "gl-python/" + platform.python_version() + " gccl/{}"
+
+_USER_AGENT_ALL_CAPS_DEPRECATED = """\
+The 'USER_AGENT' class-level attribute is deprecated.  Please use
+'user_agent' instead.
+"""
+
+_EXTRA_HEADERS_ALL_CAPS_DEPRECATED = """\
+The '_EXTRA_HEADERS' class-level attribute is deprecated.  Please use
+'extra_headers' instead.
+"""
+
+
+class Connection(object):
+    """A generic connection to Google Cloud Platform.
+
+    :type client: :class:`~google.cloud.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+    """
+
+    _user_agent = DEFAULT_USER_AGENT
+
+    def __init__(self, client, client_info=None):
+        self._client = client
+
+        if client_info is None:
+            client_info = ClientInfo()
+
+        self._client_info = client_info
+        self._extra_headers = {}
+
+    @property
+    def USER_AGENT(self):
+        """Deprecated:  get / set user agent sent by connection.
+
+        :rtype: str
+        :returns: user agent
+        """
+        warnings.warn(
+            _USER_AGENT_ALL_CAPS_DEPRECATED, DeprecationWarning, stacklevel=2)
+        return self.user_agent
+
+    @USER_AGENT.setter
+    def USER_AGENT(self, value):
+        warnings.warn(
+            _USER_AGENT_ALL_CAPS_DEPRECATED, DeprecationWarning, stacklevel=2)
+        self.user_agent = value
+
+    @property
+    def user_agent(self):
+        """Get / set user agent sent by connection.
+
+        :rtype: str
+        :returns: user agent
+        """
+        return self._client_info.to_user_agent()
+
+    @user_agent.setter
+    def user_agent(self, value):
+        self._client_info.user_agent = value
+
+    @property
+    def _EXTRA_HEADERS(self):
+        """Deprecated:  get / set extra headers sent by connection.
+
+        :rtype: dict
+        :returns: header keys / values
+        """
+        warnings.warn(
+            _EXTRA_HEADERS_ALL_CAPS_DEPRECATED, DeprecationWarning, stacklevel=2)
+        return self.extra_headers
+
+    @_EXTRA_HEADERS.setter
+    def _EXTRA_HEADERS(self, value):
+        warnings.warn(
+            _EXTRA_HEADERS_ALL_CAPS_DEPRECATED, DeprecationWarning, stacklevel=2)
+        self.extra_headers = value
+
+    @property
+    def extra_headers(self):
+        """Get / set extra headers sent by connection.
+
+        :rtype: dict
+        :returns: header keys / values
+        """
+        return self._extra_headers
+
+    @extra_headers.setter
+    def extra_headers(self, value):
+        self._extra_headers = value
+
+    @property
+    def credentials(self):
+        """Getter for current credentials.
+
+        :rtype: :class:`google.auth.credentials.Credentials` or
+                :class:`NoneType`
+        :returns: The credentials object associated with this connection.
+        """
+        return self._client._credentials
+
+    @property
+    def http(self):
+        """A getter for the HTTP transport used in talking to the API.
+
+        Returns:
+            google.auth.transport.requests.AuthorizedSession:
+                A :class:`requests.Session` instance.
+        """
+        return self._client._http
+
+
+class JSONConnection(Connection):
+    """A connection to a Google JSON-based API.
+
+    These APIs are discovery based. For reference:
+
+        https://developers.google.com/discovery/
+
+    This defines :meth:`api_request` for making a generic JSON
+    API request and API requests are created elsewhere.
+
+    * :attr:`API_BASE_URL`
+    * :attr:`API_VERSION`
+    * :attr:`API_URL_TEMPLATE`
+
+    must be updated by subclasses.
+    """
+
+    API_BASE_URL = None
+    """The base of the API call URL."""
+
+    API_VERSION = None
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = None
+    """A template for the URL of a particular API call."""
+
+    def build_api_url(
+        self, path, query_params=None, api_base_url=None, api_version=None
+    ):
+        """Construct an API url given a few components, some optional.
+
+        Typically, you shouldn't need to use this method.
+
+        :type path: str
+        :param path: The path to the resource (ie, ``'/b/bucket-name'``).
+
+        :type query_params: dict or list
+        :param query_params: A dictionary of keys and values (or list of
+                             key-value pairs) to insert into the query
+                             string of the URL.
+
+        :type api_base_url: str
+        :param api_base_url: The base URL for the API endpoint.
+                             Typically you won't have to provide this.
+
+        :type api_version: str
+        :param api_version: The version of the API to call.
+                            Typically you shouldn't provide this and instead
+                            use the default for the library.
+
+        :rtype: str
+        :returns: The URL assembled from the pieces provided.
+        """
+        url = self.API_URL_TEMPLATE.format(
+            api_base_url=(api_base_url or self.API_BASE_URL),
+            api_version=(api_version or self.API_VERSION),
+            path=path,
+        )
+
+        query_params = query_params or {}
+        if query_params:
+            url += "?" + urlencode(query_params, doseq=True)
+
+        return url
+
+    def _make_request(
+        self,
+        method,
+        url,
+        data=None,
+        content_type=None,
+        headers=None,
+        target_object=None,
+    ):
+        """A low level method to send a request to the API.
+
+        Typically, you shouldn't need to use this method.
+
+        :type method: str
+        :param method: The HTTP method to use in the request.
+
+        :type url: str
+        :param url: The URL to send the request to.
+
+        :type data: str
+        :param data: The data to send as the body of the request.
+
+        :type content_type: str
+        :param content_type: The proper MIME type of the data provided.
+
+        :type headers: dict
+        :param headers: (Optional) A dictionary of HTTP headers to send with
+                        the request. If passed, will be modified directly
+                        here with added headers.
+
+        :type target_object: object
+        :param target_object:
+            (Optional) Argument to be used by library callers.  This can allow
+            custom behavior, for example, to defer an HTTP request and complete
+            initialization of the object at a later time.
+
+        :rtype: :class:`requests.Response`
+        :returns: The HTTP response.
+        """
+        headers = headers or {}
+        headers.update(self.extra_headers)
+        headers["Accept-Encoding"] = "gzip"
+
+        if content_type:
+            headers["Content-Type"] = content_type
+
+        headers[CLIENT_INFO_HEADER] = self.user_agent
+        headers["User-Agent"] = self.user_agent
+
+        return self._do_request(method, url, headers, data, target_object)
+
+    def _do_request(
+        self, method, url, headers, data, target_object
+    ):  # pylint: disable=unused-argument
+        """Low-level helper:  perform the actual API request over HTTP.
+
+        Allows batch context managers to override and defer a request.
+
+        :type method: str
+        :param method: The HTTP method to use in the request.
+
+        :type url: str
+        :param url: The URL to send the request to.
+
+        :type headers: dict
+        :param headers: A dictionary of HTTP headers to send with the request.
+
+        :type data: str
+        :param data: The data to send as the body of the request.
+
+        :type target_object: object
+        :param target_object:
+            (Optional) Unused ``target_object`` here but may be used by a
+            superclass.
+
+        :rtype: :class:`requests.Response`
+        :returns: The HTTP response.
+        """
+        return self.http.request(url=url, method=method, headers=headers, data=data)
+
+    def api_request(
+        self,
+        method,
+        path,
+        query_params=None,
+        data=None,
+        content_type=None,
+        headers=None,
+        api_base_url=None,
+        api_version=None,
+        expect_json=True,
+        _target_object=None,
+    ):
+        """Make a request over the HTTP transport to the API.
+
+        You shouldn't need to use this method, but if you plan to
+        interact with the API using these primitives, this is the
+        correct one to use.
+
+        :type method: str
+        :param method: The HTTP method name (ie, ``GET``, ``POST``, etc).
+                       Required.
+
+        :type path: str
+        :param path: The path to the resource (ie, ``'/b/bucket-name'``).
+                     Required.
+
+        :type query_params: dict or list
+        :param query_params: A dictionary of keys and values (or list of
+                             key-value pairs) to insert into the query
+                             string of the URL.
+
+        :type data: str
+        :param data: The data to send as the body of the request. Default is
+                     the empty string.
+
+        :type content_type: str
+        :param content_type: The proper MIME type of the data provided. Default
+                             is None.
+
+        :type headers: dict
+        :param headers: extra HTTP headers to be sent with the request.
+
+        :type api_base_url: str
+        :param api_base_url: The base URL for the API endpoint.
+                             Typically you won't have to provide this.
+                             Default is the standard API base URL.
+
+        :type api_version: str
+        :param api_version: The version of the API to call.  Typically
+                            you shouldn't provide this and instead use
+                            the default for the library.  Default is the
+                            latest API version supported by
+                            google-cloud-python.
+
+        :type expect_json: bool
+        :param expect_json: If True, this method will try to parse the
+                            response as JSON and raise an exception if
+                            that cannot be done.  Default is True.
+
+        :type _target_object: :class:`object`
+        :param _target_object:
+            (Optional) Protected argument to be used by library callers. This
+            can allow custom behavior, for example, to defer an HTTP request
+            and complete initialization of the object at a later time.
+
+        :raises ~google.cloud.exceptions.GoogleCloudError: if the response code
+            is not 200 OK.
+        :raises ValueError: if the response content type is not JSON.
+        :rtype: dict or str
+        :returns: The API response payload, either as a raw string or
+                  a dictionary if the response is valid JSON.
+        """
+        url = self.build_api_url(
+            path=path,
+            query_params=query_params,
+            api_base_url=api_base_url,
+            api_version=api_version,
+        )
+
+        # Making the executive decision that any dictionary
+        # data will be sent properly as JSON.
+        if data and isinstance(data, dict):
+            data = json.dumps(data)
+            content_type = "application/json"
+
+        response = self._make_request(
+            method=method,
+            url=url,
+            data=data,
+            content_type=content_type,
+            headers=headers,
+            target_object=_target_object,
+        )
+
+        if not 200 <= response.status_code < 300:
+            raise exceptions.from_http_response(response)
+
+        if expect_json and response.content:
+            return response.json()
+        else:
+            return response.content
diff --git a/core/google/cloud/_testing.py b/core/google/cloud/_testing.py
new file mode 100644
index 000000000000..04f0dba4ce9f
--- /dev/null
+++ b/core/google/cloud/_testing.py
@@ -0,0 +1,126 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shared testing utilities."""
+
+from __future__ import absolute_import
+
+
+class _Monkey(object):
+    """Context-manager for replacing module names in the scope of a test."""
+
+    def __init__(self, module, **kw):
+        self.module = module
+        if not kw:  # pragma: NO COVER
+            raise ValueError("_Monkey was used with nothing to monkey-patch")
+        self.to_restore = {key: getattr(module, key) for key in kw}
+        for key, value in kw.items():
+            setattr(module, key, value)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        for key, value in self.to_restore.items():
+            setattr(self.module, key, value)
+
+
+class _NamedTemporaryFile(object):
+    def __init__(self, suffix=""):
+        import os
+        import tempfile
+
+        filehandle, self.name = tempfile.mkstemp(suffix=suffix)
+        os.close(filehandle)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        import os
+
+        os.remove(self.name)
+
+
+def _tempdir_maker():
+    import contextlib
+    import shutil
+    import tempfile
+
+    @contextlib.contextmanager
+    def _tempdir_mgr():
+        temp_dir = tempfile.mkdtemp()
+        yield temp_dir
+        shutil.rmtree(temp_dir)
+
+    return _tempdir_mgr
+
+
+# pylint: disable=invalid-name
+# Retain _tempdir as a constant for backwards compatibility despite
+# being an invalid name.
+_tempdir = _tempdir_maker()
+del _tempdir_maker
+# pylint: enable=invalid-name
+
+
+class _GAXBaseAPI(object):
+
+    _random_gax_error = False
+
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+    @staticmethod
+    def _make_grpc_error(status_code, trailing=None):
+        from grpc._channel import _RPCState
+        from google.cloud.exceptions import GrpcRendezvous
+
+        details = "Some error details."
+        exc_state = _RPCState((), None, trailing, status_code, details)
+        return GrpcRendezvous(exc_state, None, None, None)
+
+    def _make_grpc_not_found(self):
+        from grpc import StatusCode
+
+        return self._make_grpc_error(StatusCode.NOT_FOUND)
+
+    def _make_grpc_failed_precondition(self):
+        from grpc import StatusCode
+
+        return self._make_grpc_error(StatusCode.FAILED_PRECONDITION)
+
+    def _make_grpc_already_exists(self):
+        from grpc import StatusCode
+
+        return self._make_grpc_error(StatusCode.ALREADY_EXISTS)
+
+    def _make_grpc_deadline_exceeded(self):
+        from grpc import StatusCode
+
+        return self._make_grpc_error(StatusCode.DEADLINE_EXCEEDED)
+
+
+class _GAXPageIterator(object):
+    def __init__(self, *pages, **kwargs):
+        self._pages = iter(pages)
+        self.page_token = kwargs.get("page_token")
+
+    def next(self):
+        """Iterate to the next page."""
+        import six
+
+        return six.next(self._pages)
+
+    __next__ = next
diff --git a/core/google/cloud/client.py b/core/google/cloud/client.py
new file mode 100644
index 000000000000..2623d030f00e
--- /dev/null
+++ b/core/google/cloud/client.py
@@ -0,0 +1,227 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Base classes for client used to interact with Google Cloud APIs."""
+
+import io
+import json
+from pickle import PicklingError
+
+import six
+
+import google.auth
+import google.auth.credentials
+import google.auth.transport.requests
+from google.cloud._helpers import _determine_default_project
+from google.oauth2 import service_account
+
+
+_GOOGLE_AUTH_CREDENTIALS_HELP = (
+    "This library only supports credentials from google-auth-library-python. "
+    "See https://google-cloud-python.readthedocs.io/en/latest/core/auth.html "
+    "for help on authentication with this library."
+)
+
+# Default timeout for auth requests.
+_CREDENTIALS_REFRESH_TIMEOUT = 300
+
+
+class _ClientFactoryMixin(object):
+    """Mixin to allow factories that create credentials.
+
+    .. note::
+
+        This class is virtual.
+    """
+
+    _SET_PROJECT = False
+
+    @classmethod
+    def from_service_account_json(cls, json_credentials_path, *args, **kwargs):
+        """Factory to retrieve JSON credentials while creating client.
+
+        :type json_credentials_path: str
+        :param json_credentials_path: The path to a private key file (this file
+                                      was given to you when you created the
+                                      service account). This file must contain
+                                      a JSON object with a private key and
+                                      other credentials information (downloaded
+                                      from the Google APIs console).
+
+        :type args: tuple
+        :param args: Remaining positional arguments to pass to constructor.
+
+        :param kwargs: Remaining keyword arguments to pass to constructor.
+
+        :rtype: :class:`_ClientFactoryMixin`
+        :returns: The client created with the retrieved JSON credentials.
+        :raises TypeError: if there is a conflict with the kwargs
+                 and the credentials created by the factory.
+        """
+        if "credentials" in kwargs:
+            raise TypeError("credentials must not be in keyword arguments")
+        with io.open(json_credentials_path, "r", encoding="utf-8") as json_fi:
+            credentials_info = json.load(json_fi)
+        credentials = service_account.Credentials.from_service_account_info(
+            credentials_info
+        )
+        if cls._SET_PROJECT:
+            if "project" not in kwargs:
+                kwargs["project"] = credentials_info.get("project_id")
+
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+
+class Client(_ClientFactoryMixin):
+    """Client to bundle configuration needed for API requests.
+
+    Stores ``credentials`` and an HTTP object so that subclasses
+    can pass them along to a connection class.
+
+    If no value is passed in for ``_http``, a :class:`requests.Session` object
+    will be created and authorized with the ``credentials``. If not, the
+    ``credentials`` and ``_http`` need not be related.
+
+    Callers and subclasses may seek to use the private key from
+    ``credentials`` to sign data.
+
+    Args:
+        credentials (google.auth.credentials.Credentials):
+            (Optional) The OAuth2 Credentials to use for this client. If not
+            passed (and if no ``_http`` object is passed), falls back to the
+            default inferred from the environment.
+        _http (requests.Session):
+            (Optional) HTTP object to make requests. Can be any object that
+            defines ``request()`` with the same interface as
+            :meth:`requests.Session.request`. If not passed, an ``_http``
+            object is created that is bound to the ``credentials`` for the
+            current object.
+            This parameter should be considered private, and could change in
+            the future.
+
+    Raises:
+        google.auth.exceptions.DefaultCredentialsError:
+            Raised if ``credentials`` is not specified and the library fails
+            to acquire default credentials.
+    """
+
+    SCOPE = None
+    """The scopes required for authenticating with a service.
+
+    Needs to be set by subclasses.
+    """
+
+    def __init__(self, credentials=None, _http=None):
+        if credentials is not None and not isinstance(
+            credentials, google.auth.credentials.Credentials
+        ):
+            raise ValueError(_GOOGLE_AUTH_CREDENTIALS_HELP)
+        if credentials is None and _http is None:
+            credentials, _ = google.auth.default()
+        self._credentials = google.auth.credentials.with_scopes_if_required(
+            credentials, self.SCOPE
+        )
+        self._http_internal = _http
+
+    def __getstate__(self):
+        """Explicitly state that clients are not pickleable."""
+        raise PicklingError(
+            "\n".join(
+                [
+                    "Pickling client objects is explicitly not supported.",
+                    "Clients have non-trivial state that is local and unpickleable.",
+                ]
+            )
+        )
+
+    @property
+    def _http(self):
+        """Getter for object used for HTTP transport.
+
+        :rtype: :class:`~requests.Session`
+        :returns: An HTTP object.
+        """
+        if self._http_internal is None:
+            self._http_internal = google.auth.transport.requests.AuthorizedSession(
+                self._credentials,
+                refresh_timeout=_CREDENTIALS_REFRESH_TIMEOUT,
+            )
+        return self._http_internal
+
+
+class _ClientProjectMixin(object):
+    """Mixin to allow setting the project on the client.
+
+    :type project: str
+    :param project: the project which the client acts on behalf of. If not
+                    passed falls back to the default inferred from the
+                    environment.
+
+    :raises: :class:`EnvironmentError` if the project is neither passed in nor
+             set in the environment. :class:`ValueError` if the project value
+             is invalid.
+    """
+
+    def __init__(self, project=None):
+        project = self._determine_default(project)
+        if project is None:
+            raise EnvironmentError(
+                "Project was not passed and could not be "
+                "determined from the environment."
+            )
+        if isinstance(project, six.binary_type):
+            project = project.decode("utf-8")
+        if not isinstance(project, six.string_types):
+            raise ValueError("Project must be a string.")
+        self.project = project
+
+    @staticmethod
+    def _determine_default(project):
+        """Helper:  use default project detection."""
+        return _determine_default_project(project)
+
+
+class ClientWithProject(Client, _ClientProjectMixin):
+    """Client that also stores a project.
+
+    :type project: str
+    :param project: the project which the client acts on behalf of. If not
+                    passed falls back to the default inferred from the
+                    environment.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`~requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :raises: :class:`ValueError` if the project is neither passed in nor
+             set in the environment.
+    """
+
+    _SET_PROJECT = True  # Used by from_service_account_json()
+
+    def __init__(self, project=None, credentials=None, _http=None):
+        _ClientProjectMixin.__init__(self, project=project)
+        Client.__init__(self, credentials=credentials, _http=_http)
diff --git a/core/google/cloud/environment_vars.py b/core/google/cloud/environment_vars.py
new file mode 100644
index 000000000000..d84afca35628
--- /dev/null
+++ b/core/google/cloud/environment_vars.py
@@ -0,0 +1,38 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Comprehensive list of environment variables used in google-cloud.
+
+These enable many types of implicit behavior in both production
+and tests.
+"""
+
+GCD_DATASET = "DATASTORE_DATASET"
+"""Environment variable defining default dataset ID under GCD."""
+
+GCD_HOST = "DATASTORE_EMULATOR_HOST"
+"""Environment variable defining host for GCD dataset server."""
+
+PUBSUB_EMULATOR = "PUBSUB_EMULATOR_HOST"
+"""Environment variable defining host for Pub/Sub emulator."""
+
+BIGTABLE_EMULATOR = "BIGTABLE_EMULATOR_HOST"
+"""Environment variable defining host for Bigtable emulator."""
+
+DISABLE_GRPC = "GOOGLE_CLOUD_DISABLE_GRPC"
+"""Environment variable acting as flag to disable gRPC.
+
+To be used for APIs where both an HTTP and gRPC implementation
+exist.
+"""
diff --git a/core/google/cloud/exceptions.py b/core/google/cloud/exceptions.py
new file mode 100644
index 000000000000..36ee6d14fcab
--- /dev/null
+++ b/core/google/cloud/exceptions.py
@@ -0,0 +1,59 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# pylint: disable=invalid-name
+# pylint recognizies all of these aliases as constants and thinks they have
+# invalid names.
+
+"""Custom exceptions for :mod:`google.cloud` package."""
+
+# Avoid the grpc and google.cloud.grpc collision.
+from __future__ import absolute_import
+
+from google.api_core import exceptions
+
+try:
+    from grpc._channel import _Rendezvous
+except ImportError:  # pragma: NO COVER
+    _Rendezvous = None
+
+GrpcRendezvous = _Rendezvous
+"""Exception class raised by gRPC stable."""
+
+# Aliases to moved classes.
+GoogleCloudError = exceptions.GoogleAPICallError
+Redirection = exceptions.Redirection
+MovedPermanently = exceptions.MovedPermanently
+NotModified = exceptions.NotModified
+TemporaryRedirect = exceptions.TemporaryRedirect
+ResumeIncomplete = exceptions.ResumeIncomplete
+ClientError = exceptions.ClientError
+BadRequest = exceptions.BadRequest
+Unauthorized = exceptions.Unauthorized
+Forbidden = exceptions.Forbidden
+NotFound = exceptions.NotFound
+MethodNotAllowed = exceptions.MethodNotAllowed
+Conflict = exceptions.Conflict
+LengthRequired = exceptions.LengthRequired
+PreconditionFailed = exceptions.PreconditionFailed
+RequestRangeNotSatisfiable = exceptions.RequestRangeNotSatisfiable
+TooManyRequests = exceptions.TooManyRequests
+ServerError = exceptions.ServerError
+InternalServerError = exceptions.InternalServerError
+MethodNotImplemented = exceptions.MethodNotImplemented
+BadGateway = exceptions.BadGateway
+ServiceUnavailable = exceptions.ServiceUnavailable
+GatewayTimeout = exceptions.GatewayTimeout
+from_http_status = exceptions.from_http_status
+from_http_response = exceptions.from_http_response
diff --git a/core/google/cloud/obsolete.py b/core/google/cloud/obsolete.py
new file mode 100644
index 000000000000..99a83f9cec1f
--- /dev/null
+++ b/core/google/cloud/obsolete.py
@@ -0,0 +1,42 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for deprecated code and modules."""
+
+import warnings
+
+import pkg_resources
+
+
+def complain(distribution_name):
+    """Issue a warning if `distribution_name` is installed.
+
+    In a future release, this method will be updated to raise ImportError
+    rather than just send a warning.
+
+    Args:
+        distribution_name (str): The name of the obsolete distribution.
+    """
+    try:
+        pkg_resources.get_distribution(distribution_name)
+        warnings.warn(
+            "The {pkg} distribution is now obsolete. "
+            "Please `pip uninstall {pkg}`. "
+            "In the future, this warning will become an ImportError.".format(
+                pkg=distribution_name
+            ),
+            DeprecationWarning,
+        )
+    except pkg_resources.DistributionNotFound:
+        pass
diff --git a/core/google/cloud/operation.py b/core/google/cloud/operation.py
new file mode 100644
index 000000000000..28ac8cf1cc50
--- /dev/null
+++ b/core/google/cloud/operation.py
@@ -0,0 +1,266 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrap long-running operations returned from Google Cloud APIs."""
+
+from google.longrunning import operations_pb2
+from google.protobuf import json_format
+
+
+_GOOGLE_APIS_PREFIX = "type.googleapis.com"
+
+_TYPE_URL_MAP = {}
+
+
+def _compute_type_url(klass, prefix=_GOOGLE_APIS_PREFIX):
+    """Compute a type URL for a klass.
+
+    :type klass: type
+    :param klass: class to be used as a factory for the given type
+
+    :type prefix: str
+    :param prefix: URL prefix for the type
+
+    :rtype: str
+    :returns: the URL, prefixed as appropriate
+    """
+    name = klass.DESCRIPTOR.full_name
+    return "%s/%s" % (prefix, name)
+
+
+def register_type(klass, type_url=None):
+    """Register a klass as the factory for a given type URL.
+
+    :type klass: :class:`type`
+    :param klass: class to be used as a factory for the given type
+
+    :type type_url: str
+    :param type_url: (Optional) URL naming the type. If not provided,
+                     infers the URL from the type descriptor.
+
+    :raises ValueError: if a registration already exists for the URL.
+    """
+    if type_url is None:
+        type_url = _compute_type_url(klass)
+    if type_url in _TYPE_URL_MAP:
+        if _TYPE_URL_MAP[type_url] is not klass:
+            raise ValueError("Conflict: %s" % (_TYPE_URL_MAP[type_url],))
+
+    _TYPE_URL_MAP[type_url] = klass
+
+
+def _from_any(any_pb):
+    """Convert an ``Any`` protobuf into the actual class.
+
+    Uses the type URL to do the conversion.
+
+    .. note::
+
+        This assumes that the type URL is already registered.
+
+    :type any_pb: :class:`google.protobuf.any_pb2.Any`
+    :param any_pb: An any object to be converted.
+
+    :rtype: object
+    :returns: The instance (of the correct type) stored in the any
+              instance.
+    """
+    klass = _TYPE_URL_MAP[any_pb.type_url]
+    return klass.FromString(any_pb.value)
+
+
+class Operation(object):
+    """Representation of a Google API Long-Running Operation.
+
+    .. _protobuf: https://github.com/googleapis/googleapis/blob/\
+                  050400df0fdb16f63b63e9dee53819044bffc857/\
+                  google/longrunning/operations.proto#L80
+    .. _service: https://github.com/googleapis/googleapis/blob/\
+                 050400df0fdb16f63b63e9dee53819044bffc857/\
+                 google/longrunning/operations.proto#L38
+    .. _JSON: https://cloud.google.com/speech/reference/rest/\
+              v1beta1/operations#Operation
+
+    This wraps an operation `protobuf`_ object and attempts to
+    interact with the long-running operations `service`_ (specific
+    to a given API). (Some services also offer a `JSON`_
+    API that maps the same underlying data type.)
+
+    :type name: str
+    :param name: The fully-qualified path naming the operation.
+
+    :type client: :class:`~google.cloud.client.Client`
+    :param client: The client used to poll for the status of the operation.
+                   If the operation was created via JSON/HTTP, the client
+                   must own a :class:`~google.cloud._http.Connection`
+                   to send polling requests. If created via protobuf, the
+                   client must have a gRPC stub in the ``_operations_stub``
+                   attribute.
+
+    :type caller_metadata: dict
+    :param caller_metadata: caller-assigned metadata about the operation
+    """
+
+    target = None
+    """Instance assocated with the operations:  callers may set."""
+
+    response = None
+    """Response returned from completed operation.
+
+    Only one of this and :attr:`error` can be populated.
+    """
+
+    error = None
+    """Error that resulted from a failed (complete) operation.
+
+    Only one of this and :attr:`response` can be populated.
+    """
+
+    metadata = None
+    """Metadata about the current operation (as a protobuf).
+
+    Code that uses operations must register the metadata types (via
+    :func:`register_type`) to ensure that the metadata fields can be
+    converted into the correct types.
+    """
+
+    _from_grpc = True
+
+    def __init__(self, name, client, **caller_metadata):
+        self.name = name
+        self.client = client
+        self.caller_metadata = caller_metadata.copy()
+        self._complete = False
+
+    @classmethod
+    def from_pb(cls, operation_pb, client, **caller_metadata):
+        """Factory:  construct an instance from a protobuf.
+
+        :type operation_pb:
+            :class:`~google.longrunning.operations_pb2.Operation`
+        :param operation_pb: Protobuf to be parsed.
+
+        :type client: object: must provide ``_operations_stub`` accessor.
+        :param client: The client used to poll for the status of the operation.
+
+        :type caller_metadata: dict
+        :param caller_metadata: caller-assigned metadata about the operation
+
+        :rtype: :class:`Operation`
+        :returns: new instance, with attributes based on the protobuf.
+        """
+        result = cls(operation_pb.name, client, **caller_metadata)
+        result._update_state(operation_pb)
+        result._from_grpc = True
+        return result
+
+    @classmethod
+    def from_dict(cls, operation, client, **caller_metadata):
+        """Factory: construct an instance from a dictionary.
+
+        :type operation: dict
+        :param operation: Operation as a JSON object.
+
+        :type client: :class:`~google.cloud.client.Client`
+        :param client: The client used to poll for the status of the operation.
+
+        :type caller_metadata: dict
+        :param caller_metadata: caller-assigned metadata about the operation
+
+        :rtype: :class:`Operation`
+        :returns: new instance, with attributes based on the protobuf.
+        """
+        operation_pb = json_format.ParseDict(operation, operations_pb2.Operation())
+        result = cls(operation_pb.name, client, **caller_metadata)
+        result._update_state(operation_pb)
+        result._from_grpc = False
+        return result
+
+    @property
+    def complete(self):
+        """Has the operation already completed?
+
+        :rtype: bool
+        :returns: True if already completed, else false.
+        """
+        return self._complete
+
+    def _get_operation_rpc(self):
+        """Polls the status of the current operation.
+
+        Uses gRPC request to check.
+
+        :rtype: :class:`~google.longrunning.operations_pb2.Operation`
+        :returns: The latest status of the current operation.
+        """
+        request_pb = operations_pb2.GetOperationRequest(name=self.name)
+        return self.client._operations_stub.GetOperation(request_pb)
+
+    def _get_operation_http(self):
+        """Checks the status of the current operation.
+
+        Uses HTTP request to check.
+
+        :rtype: :class:`~google.longrunning.operations_pb2.Operation`
+        :returns: The latest status of the current operation.
+        """
+        path = "operations/%s" % (self.name,)
+        api_response = self.client._connection.api_request(method="GET", path=path)
+        return json_format.ParseDict(api_response, operations_pb2.Operation())
+
+    def _get_operation(self):
+        """Checks the status of the current operation.
+
+        :rtype: :class:`~google.longrunning.operations_pb2.Operation`
+        :returns: The latest status of the current operation.
+        """
+        if self._from_grpc:
+            return self._get_operation_rpc()
+        else:
+            return self._get_operation_http()
+
+    def _update_state(self, operation_pb):
+        """Update the state of the current object based on operation.
+
+        :type operation_pb:
+            :class:`~google.longrunning.operations_pb2.Operation`
+        :param operation_pb: Protobuf to be parsed.
+        """
+        if operation_pb.done:
+            self._complete = True
+
+        if operation_pb.HasField("metadata"):
+            self.metadata = _from_any(operation_pb.metadata)
+
+        result_type = operation_pb.WhichOneof("result")
+        if result_type == "error":
+            self.error = operation_pb.error
+        elif result_type == "response":
+            self.response = _from_any(operation_pb.response)
+
+    def poll(self):
+        """Check if the operation has finished.
+
+        :rtype: bool
+        :returns: A boolean indicating if the current operation has completed.
+        :raises ValueError: if the operation
+                 has already completed.
+        """
+        if self.complete:
+            raise ValueError("The operation has completed.")
+
+        operation_pb = self._get_operation()
+        self._update_state(operation_pb)
+
+        return self.complete
diff --git a/core/noxfile.py b/core/noxfile.py
new file mode 100644
index 000000000000..5ac660e4c410
--- /dev/null
+++ b/core/noxfile.py
@@ -0,0 +1,111 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"),)
+
+
+def default(session):
+    """Default unit test session.
+    This is intended to be run **without** an interpreter set, so
+    that the current ``python`` (on the ``PATH``) or the version of
+    Python corresponding to the ``nox`` binary the ``PATH`` can
+    run the tests.
+    """
+
+    # Install all test dependencies, then install local packages in-place.
+    session.install("mock", "pytest", "pytest-cov", "grpcio >= 1.0.2")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Default unit test session."""
+    default(session)
+
+
+@nox.session(python="3.6")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "flake8-import-order")
+    session.install(".")
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+
+    session.install("docutils", "Pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+@nox.session(python="3.6")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+    session.run("coverage", "erase")
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install(".", "grpcio >= 1.8.2", "grpcio-gcp >= 0.2.2")
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
\ No newline at end of file
diff --git a/core/pylint.config.py b/core/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/core/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/core/setup.cfg b/core/setup.cfg
new file mode 100644
index 000000000000..2a9acf13daa9
--- /dev/null
+++ b/core/setup.cfg
@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1
diff --git a/core/setup.py b/core/setup.py
new file mode 100644
index 000000000000..a6b6a83df898
--- /dev/null
+++ b/core/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-core"
+description = "Google Cloud API client core library"
+version = "1.0.3"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 4 - Beta"
+dependencies = ["google-api-core >= 1.14.0, < 2.0.0dev"]
+extras = {"grpc": "grpcio >= 1.8.2, < 2.0dev"}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        'Programming Language :: Python :: 3.7',
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/core/tests/__init__.py b/core/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/core/tests/unit/__init__.py b/core/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/core/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/core/tests/unit/test__helpers.py b/core/tests/unit/test__helpers.py
new file mode 100644
index 000000000000..03e2ff2d2b51
--- /dev/null
+++ b/core/tests/unit/test__helpers.py
@@ -0,0 +1,921 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class Test__LocalStack(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud._helpers import _LocalStack
+
+        return _LocalStack
+
+    def _make_one(self):
+        return self._get_target_class()()
+
+    def test_it(self):
+        batch1, batch2 = object(), object()
+        batches = self._make_one()
+        self.assertEqual(list(batches), [])
+        self.assertIsNone(batches.top)
+        batches.push(batch1)
+        self.assertIs(batches.top, batch1)
+        batches.push(batch2)
+        self.assertIs(batches.top, batch2)
+        popped = batches.pop()
+        self.assertIs(popped, batch2)
+        self.assertIs(batches.top, batch1)
+        self.assertEqual(list(batches), [batch1])
+        popped = batches.pop()
+        self.assertIsNone(batches.top)
+        self.assertEqual(list(batches), [])
+
+
+class Test__UTC(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud._helpers import _UTC
+
+        return _UTC
+
+    def _make_one(self):
+        return self._get_target_class()()
+
+    def test_module_property(self):
+        from google.cloud import _helpers as MUT
+
+        klass = self._get_target_class()
+        try:
+            import pytz
+        except ImportError:  # pragma: NO COVER
+            self.assertIsInstance(MUT.UTC, klass)
+        else:
+            self.assertIs(MUT.UTC, pytz.UTC)
+
+    def test_dst(self):
+        import datetime
+
+        tz = self._make_one()
+        self.assertEqual(tz.dst(None), datetime.timedelta(0))
+
+    def test_fromutc(self):
+        import datetime
+
+        naive_epoch = datetime.datetime(1970, 1, 1, 0, 0, 1, tzinfo=None)
+        self.assertIsNone(naive_epoch.tzinfo)
+        tz = self._make_one()
+        epoch = tz.fromutc(naive_epoch)
+        self.assertEqual(epoch.tzinfo, tz)
+
+    def test_fromutc_with_tz(self):
+        import datetime
+
+        tz = self._make_one()
+        epoch_with_tz = datetime.datetime(1970, 1, 1, 0, 0, 1, tzinfo=tz)
+        epoch = tz.fromutc(epoch_with_tz)
+        self.assertEqual(epoch.tzinfo, tz)
+
+    def test_tzname(self):
+        tz = self._make_one()
+        self.assertEqual(tz.tzname(None), "UTC")
+
+    def test_utcoffset(self):
+        import datetime
+
+        tz = self._make_one()
+        self.assertEqual(tz.utcoffset(None), datetime.timedelta(0))
+
+    def test___repr__(self):
+        tz = self._make_one()
+        self.assertEqual(repr(tz), "<UTC>")
+
+    def test___str__(self):
+        tz = self._make_one()
+        self.assertEqual(str(tz), "UTC")
+
+
+class Test__ensure_tuple_or_list(unittest.TestCase):
+    def _call_fut(self, arg_name, tuple_or_list):
+        from google.cloud._helpers import _ensure_tuple_or_list
+
+        return _ensure_tuple_or_list(arg_name, tuple_or_list)
+
+    def test_valid_tuple(self):
+        valid_tuple_or_list = ("a", "b", "c", "d")
+        result = self._call_fut("ARGNAME", valid_tuple_or_list)
+        self.assertEqual(result, ["a", "b", "c", "d"])
+
+    def test_valid_list(self):
+        valid_tuple_or_list = ["a", "b", "c", "d"]
+        result = self._call_fut("ARGNAME", valid_tuple_or_list)
+        self.assertEqual(result, valid_tuple_or_list)
+
+    def test_invalid(self):
+        invalid_tuple_or_list = object()
+        with self.assertRaises(TypeError):
+            self._call_fut("ARGNAME", invalid_tuple_or_list)
+
+    def test_invalid_iterable(self):
+        invalid_tuple_or_list = "FOO"
+        with self.assertRaises(TypeError):
+            self._call_fut("ARGNAME", invalid_tuple_or_list)
+
+
+class Test__determine_default_project(unittest.TestCase):
+    def _call_fut(self, project=None):
+        from google.cloud._helpers import _determine_default_project
+
+        return _determine_default_project(project=project)
+
+    def test_it(self):
+        with mock.patch("google.auth.default", autospec=True) as default:
+            default.return_value = (mock.sentinel.credentials, mock.sentinel.project)
+            project = self._call_fut()
+
+        self.assertEqual(project, mock.sentinel.project)
+        default.assert_called_once_with()
+
+    def test_explicit(self):
+        with mock.patch("google.auth.default", autospec=True) as default:
+            project = self._call_fut(mock.sentinel.project)
+
+        self.assertEqual(project, mock.sentinel.project)
+        self.assertFalse(default.called)
+
+
+class Test__millis(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud._helpers import _millis
+
+        return _millis(value)
+
+    def test_one_second_from_epoch(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        WHEN = datetime.datetime(1970, 1, 1, 0, 0, 1, tzinfo=UTC)
+        self.assertEqual(self._call_fut(WHEN), 1000)
+
+
+class Test__microseconds_from_datetime(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        return _microseconds_from_datetime(value)
+
+    def test_it(self):
+        import datetime
+
+        microseconds = 314159
+        timestamp = datetime.datetime(
+            1970, 1, 1, hour=0, minute=0, second=0, microsecond=microseconds
+        )
+        result = self._call_fut(timestamp)
+        self.assertEqual(result, microseconds)
+
+
+class Test__millis_from_datetime(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud._helpers import _millis_from_datetime
+
+        return _millis_from_datetime(value)
+
+    def test_w_none(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_w_utc_datetime(self):
+        import datetime
+        import six
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        NOW = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        NOW_MICROS = _microseconds_from_datetime(NOW)
+        MILLIS = NOW_MICROS // 1000
+        result = self._call_fut(NOW)
+        self.assertIsInstance(result, six.integer_types)
+        self.assertEqual(result, MILLIS)
+
+    def test_w_non_utc_datetime(self):
+        import datetime
+        import six
+        from google.cloud._helpers import _UTC
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        class CET(_UTC):
+            _tzname = "CET"
+            _utcoffset = datetime.timedelta(hours=-1)
+
+        zone = CET()
+        NOW = datetime.datetime(2015, 7, 28, 16, 34, 47, tzinfo=zone)
+        NOW_MICROS = _microseconds_from_datetime(NOW)
+        MILLIS = NOW_MICROS // 1000
+        result = self._call_fut(NOW)
+        self.assertIsInstance(result, six.integer_types)
+        self.assertEqual(result, MILLIS)
+
+    def test_w_naive_datetime(self):
+        import datetime
+        import six
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        NOW = datetime.datetime.utcnow()
+        UTC_NOW = NOW.replace(tzinfo=UTC)
+        UTC_NOW_MICROS = _microseconds_from_datetime(UTC_NOW)
+        MILLIS = UTC_NOW_MICROS // 1000
+        result = self._call_fut(NOW)
+        self.assertIsInstance(result, six.integer_types)
+        self.assertEqual(result, MILLIS)
+
+
+class Test__datetime_from_microseconds(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud._helpers import _datetime_from_microseconds
+
+        return _datetime_from_microseconds(value)
+
+    def test_it(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _microseconds_from_datetime
+
+        NOW = datetime.datetime(2015, 7, 29, 17, 45, 21, 123456, tzinfo=UTC)
+        NOW_MICROS = _microseconds_from_datetime(NOW)
+        self.assertEqual(self._call_fut(NOW_MICROS), NOW)
+
+
+class Test___date_from_iso8601_date(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud._helpers import _date_from_iso8601_date
+
+        return _date_from_iso8601_date(value)
+
+    def test_todays_date(self):
+        import datetime
+
+        TODAY = datetime.date.today()
+        self.assertEqual(self._call_fut(TODAY.strftime("%Y-%m-%d")), TODAY)
+
+
+class Test___time_from_iso8601_time_naive(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud._helpers import _time_from_iso8601_time_naive
+
+        return _time_from_iso8601_time_naive(value)
+
+    def test_todays_date(self):
+        import datetime
+
+        WHEN = datetime.time(12, 9, 42)
+        self.assertEqual(self._call_fut(("12:09:42")), WHEN)
+
+    def test_w_microseconds(self):
+        import datetime
+
+        WHEN = datetime.time(12, 9, 42, 123456)
+        self.assertEqual(self._call_fut(("12:09:42.123456")), WHEN)
+
+    def test_w_millis_fail(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("12:09:42.123")
+
+
+class Test__rfc3339_to_datetime(unittest.TestCase):
+    def _call_fut(self, dt_str):
+        from google.cloud._helpers import _rfc3339_to_datetime
+
+        return _rfc3339_to_datetime(dt_str)
+
+    def test_w_bogus_zone(self):
+        year = 2009
+        month = 12
+        day = 17
+        hour = 12
+        minute = 44
+        seconds = 32
+        micros = 123456789
+
+        dt_str = "%d-%02d-%02dT%02d:%02d:%02d.%06dBOGUS" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+            micros,
+        )
+        with self.assertRaises(ValueError):
+            self._call_fut(dt_str)
+
+    def test_w_microseconds(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        year = 2009
+        month = 12
+        day = 17
+        hour = 12
+        minute = 44
+        seconds = 32
+        micros = 123456
+
+        dt_str = "%d-%02d-%02dT%02d:%02d:%02d.%06dZ" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+            micros,
+        )
+        result = self._call_fut(dt_str)
+        expected_result = datetime.datetime(
+            year, month, day, hour, minute, seconds, micros, UTC
+        )
+        self.assertEqual(result, expected_result)
+
+    def test_w_naonseconds(self):
+        year = 2009
+        month = 12
+        day = 17
+        hour = 12
+        minute = 44
+        seconds = 32
+        nanos = 123456789
+
+        dt_str = "%d-%02d-%02dT%02d:%02d:%02d.%09dZ" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+            nanos,
+        )
+        with self.assertRaises(ValueError):
+            self._call_fut(dt_str)
+
+
+class Test__rfc3339_nanos_to_datetime(unittest.TestCase):
+    def _call_fut(self, dt_str):
+        from google.cloud._helpers import _rfc3339_nanos_to_datetime
+
+        return _rfc3339_nanos_to_datetime(dt_str)
+
+    def test_w_bogus_zone(self):
+        year = 2009
+        month = 12
+        day = 17
+        hour = 12
+        minute = 44
+        seconds = 32
+        micros = 123456789
+
+        dt_str = "%d-%02d-%02dT%02d:%02d:%02d.%06dBOGUS" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+            micros,
+        )
+        with self.assertRaises(ValueError):
+            self._call_fut(dt_str)
+
+    def test_w_truncated_nanos(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        year = 2009
+        month = 12
+        day = 17
+        hour = 12
+        minute = 44
+        seconds = 32
+        truncateds_and_micros = [
+            ("12345678", 123456),
+            ("1234567", 123456),
+            ("123456", 123456),
+            ("12345", 123450),
+            ("1234", 123400),
+            ("123", 123000),
+            ("12", 120000),
+            ("1", 100000),
+        ]
+
+        for truncated, micros in truncateds_and_micros:
+            dt_str = "%d-%02d-%02dT%02d:%02d:%02d.%sZ" % (
+                year,
+                month,
+                day,
+                hour,
+                minute,
+                seconds,
+                truncated,
+            )
+            result = self._call_fut(dt_str)
+            expected_result = datetime.datetime(
+                year, month, day, hour, minute, seconds, micros, UTC
+            )
+            self.assertEqual(result, expected_result)
+
+    def test_without_nanos(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        year = 1988
+        month = 4
+        day = 29
+        hour = 12
+        minute = 12
+        seconds = 12
+
+        dt_str = "%d-%02d-%02dT%02d:%02d:%02dZ" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+        )
+        result = self._call_fut(dt_str)
+        expected_result = datetime.datetime(
+            year, month, day, hour, minute, seconds, 0, UTC
+        )
+        self.assertEqual(result, expected_result)
+
+    def test_w_naonseconds(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        year = 2009
+        month = 12
+        day = 17
+        hour = 12
+        minute = 44
+        seconds = 32
+        nanos = 123456789
+        micros = nanos // 1000
+
+        dt_str = "%d-%02d-%02dT%02d:%02d:%02d.%09dZ" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+            nanos,
+        )
+        result = self._call_fut(dt_str)
+        expected_result = datetime.datetime(
+            year, month, day, hour, minute, seconds, micros, UTC
+        )
+        self.assertEqual(result, expected_result)
+
+
+class Test__datetime_to_rfc3339(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        return _datetime_to_rfc3339(*args, **kwargs)
+
+    @staticmethod
+    def _make_timezone(offset):
+        from google.cloud._helpers import _UTC
+
+        class CET(_UTC):
+            _tzname = "CET"
+            _utcoffset = offset
+
+        return CET()
+
+    def test_w_utc_datetime(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=UTC)
+        result = self._call_fut(TIMESTAMP, ignore_zone=False)
+        self.assertEqual(result, "2016-04-05T13:30:00.000000Z")
+
+    def test_w_non_utc_datetime(self):
+        import datetime
+
+        zone = self._make_timezone(offset=datetime.timedelta(hours=-1))
+        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=zone)
+        result = self._call_fut(TIMESTAMP, ignore_zone=False)
+        self.assertEqual(result, "2016-04-05T14:30:00.000000Z")
+
+    def test_w_non_utc_datetime_and_ignore_zone(self):
+        import datetime
+
+        zone = self._make_timezone(offset=datetime.timedelta(hours=-1))
+        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=zone)
+        result = self._call_fut(TIMESTAMP)
+        self.assertEqual(result, "2016-04-05T13:30:00.000000Z")
+
+    def test_w_naive_datetime(self):
+        import datetime
+
+        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0)
+        result = self._call_fut(TIMESTAMP)
+        self.assertEqual(result, "2016-04-05T13:30:00.000000Z")
+
+
+class Test__to_bytes(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import _to_bytes
+
+        return _to_bytes(*args, **kwargs)
+
+    def test_with_bytes(self):
+        value = b"bytes-val"
+        self.assertEqual(self._call_fut(value), value)
+
+    def test_with_unicode(self):
+        value = u"string-val"
+        encoded_value = b"string-val"
+        self.assertEqual(self._call_fut(value), encoded_value)
+
+    def test_unicode_non_ascii(self):
+        value = u"\u2013"  # Long hyphen
+        encoded_value = b"\xe2\x80\x93"
+        self.assertRaises(UnicodeEncodeError, self._call_fut, value)
+        self.assertEqual(self._call_fut(value, encoding="utf-8"), encoded_value)
+
+    def test_with_nonstring_type(self):
+        value = object()
+        self.assertRaises(TypeError, self._call_fut, value)
+
+
+class Test__bytes_to_unicode(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import _bytes_to_unicode
+
+        return _bytes_to_unicode(*args, **kwargs)
+
+    def test_with_bytes(self):
+        value = b"bytes-val"
+        encoded_value = "bytes-val"
+        self.assertEqual(self._call_fut(value), encoded_value)
+
+    def test_with_unicode(self):
+        value = u"string-val"
+        encoded_value = "string-val"
+        self.assertEqual(self._call_fut(value), encoded_value)
+
+    def test_with_nonstring_type(self):
+        value = object()
+        self.assertRaises(ValueError, self._call_fut, value)
+
+
+class Test__pb_timestamp_to_datetime(unittest.TestCase):
+    def _call_fut(self, timestamp):
+        from google.cloud._helpers import _pb_timestamp_to_datetime
+
+        return _pb_timestamp_to_datetime(timestamp)
+
+    def test_it(self):
+        import datetime
+        from google.protobuf.timestamp_pb2 import Timestamp
+        from google.cloud._helpers import UTC
+
+        # Epoch is midnight on January 1, 1970 ...
+        dt_stamp = datetime.datetime(
+            1970,
+            month=1,
+            day=1,
+            hour=0,
+            minute=1,
+            second=1,
+            microsecond=1234,
+            tzinfo=UTC,
+        )
+        # ... so 1 minute and 1 second after is 61 seconds and 1234
+        # microseconds is 1234000 nanoseconds.
+        timestamp = Timestamp(seconds=61, nanos=1234000)
+        self.assertEqual(self._call_fut(timestamp), dt_stamp)
+
+
+class Test__from_any_pb(unittest.TestCase):
+    def _call_fut(self, pb_type, any_pb):
+        from google.cloud._helpers import _from_any_pb
+
+        return _from_any_pb(pb_type, any_pb)
+
+    def test_success(self):
+        from google.protobuf import any_pb2
+        from google.type import date_pb2
+
+        in_message = date_pb2.Date(year=1990)
+        in_message_any = any_pb2.Any()
+        in_message_any.Pack(in_message)
+        out_message = self._call_fut(date_pb2.Date, in_message_any)
+        self.assertEqual(in_message, out_message)
+
+    def test_failure(self,):
+        from google.protobuf import any_pb2
+        from google.type import date_pb2
+        from google.type import timeofday_pb2
+
+        in_message = any_pb2.Any()
+        in_message.Pack(date_pb2.Date(year=1990))
+
+        with self.assertRaises(TypeError):
+            self._call_fut(timeofday_pb2.TimeOfDay, in_message)
+
+
+class Test__pb_timestamp_to_rfc3339(unittest.TestCase):
+    def _call_fut(self, timestamp):
+        from google.cloud._helpers import _pb_timestamp_to_rfc3339
+
+        return _pb_timestamp_to_rfc3339(timestamp)
+
+    def test_it(self):
+        from google.protobuf.timestamp_pb2 import Timestamp
+
+        # Epoch is midnight on January 1, 1970 ...
+        # ... so 1 minute and 1 second after is 61 seconds and 1234
+        # microseconds is 1234000 nanoseconds.
+        timestamp = Timestamp(seconds=61, nanos=1234000)
+        self.assertEqual(self._call_fut(timestamp), "1970-01-01T00:01:01.001234Z")
+
+
+class Test__datetime_to_pb_timestamp(unittest.TestCase):
+    def _call_fut(self, when):
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        return _datetime_to_pb_timestamp(when)
+
+    def test_it(self):
+        import datetime
+        from google.protobuf.timestamp_pb2 import Timestamp
+        from google.cloud._helpers import UTC
+
+        # Epoch is midnight on January 1, 1970 ...
+        dt_stamp = datetime.datetime(
+            1970,
+            month=1,
+            day=1,
+            hour=0,
+            minute=1,
+            second=1,
+            microsecond=1234,
+            tzinfo=UTC,
+        )
+        # ... so 1 minute and 1 second after is 61 seconds and 1234
+        # microseconds is 1234000 nanoseconds.
+        timestamp = Timestamp(seconds=61, nanos=1234000)
+        self.assertEqual(self._call_fut(dt_stamp), timestamp)
+
+
+class Test__timedelta_to_duration_pb(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import _timedelta_to_duration_pb
+
+        return _timedelta_to_duration_pb(*args, **kwargs)
+
+    def test_it(self):
+        import datetime
+        from google.protobuf import duration_pb2
+
+        seconds = microseconds = 1
+        timedelta_val = datetime.timedelta(seconds=seconds, microseconds=microseconds)
+        result = self._call_fut(timedelta_val)
+        self.assertIsInstance(result, duration_pb2.Duration)
+        self.assertEqual(result.seconds, seconds)
+        self.assertEqual(result.nanos, 1000 * microseconds)
+
+    def test_with_negative_microseconds(self):
+        import datetime
+        from google.protobuf import duration_pb2
+
+        seconds = 1
+        microseconds = -5
+        timedelta_val = datetime.timedelta(seconds=seconds, microseconds=microseconds)
+        result = self._call_fut(timedelta_val)
+        self.assertIsInstance(result, duration_pb2.Duration)
+        self.assertEqual(result.seconds, seconds - 1)
+        self.assertEqual(result.nanos, 10 ** 9 + 1000 * microseconds)
+
+    def test_with_negative_seconds(self):
+        import datetime
+        from google.protobuf import duration_pb2
+
+        seconds = -1
+        microseconds = 5
+        timedelta_val = datetime.timedelta(seconds=seconds, microseconds=microseconds)
+        result = self._call_fut(timedelta_val)
+        self.assertIsInstance(result, duration_pb2.Duration)
+        self.assertEqual(result.seconds, seconds + 1)
+        self.assertEqual(result.nanos, -(10 ** 9 - 1000 * microseconds))
+
+
+class Test__duration_pb_to_timedelta(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import _duration_pb_to_timedelta
+
+        return _duration_pb_to_timedelta(*args, **kwargs)
+
+    def test_it(self):
+        import datetime
+        from google.protobuf import duration_pb2
+
+        seconds = microseconds = 1
+        duration_pb = duration_pb2.Duration(seconds=seconds, nanos=1000 * microseconds)
+        timedelta_val = datetime.timedelta(seconds=seconds, microseconds=microseconds)
+        result = self._call_fut(duration_pb)
+        self.assertIsInstance(result, datetime.timedelta)
+        self.assertEqual(result, timedelta_val)
+
+
+class Test__name_from_project_path(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    THING_NAME = "THING_NAME"
+    TEMPLATE = r"projects/(?P<project>\w+)/things/(?P<name>\w+)"
+
+    def _call_fut(self, path, project, template):
+        from google.cloud._helpers import _name_from_project_path
+
+        return _name_from_project_path(path, project, template)
+
+    def test_w_invalid_path_length(self):
+        PATH = "projects/foo"
+        with self.assertRaises(ValueError):
+            self._call_fut(PATH, None, self.TEMPLATE)
+
+    def test_w_invalid_path_segments(self):
+        PATH = "foo/%s/bar/%s" % (self.PROJECT, self.THING_NAME)
+        with self.assertRaises(ValueError):
+            self._call_fut(PATH, self.PROJECT, self.TEMPLATE)
+
+    def test_w_mismatched_project(self):
+        PROJECT1 = "PROJECT1"
+        PROJECT2 = "PROJECT2"
+        PATH = "projects/%s/things/%s" % (PROJECT1, self.THING_NAME)
+        with self.assertRaises(ValueError):
+            self._call_fut(PATH, PROJECT2, self.TEMPLATE)
+
+    def test_w_valid_data_w_compiled_regex(self):
+        import re
+
+        template = re.compile(self.TEMPLATE)
+        PATH = "projects/%s/things/%s" % (self.PROJECT, self.THING_NAME)
+        name = self._call_fut(PATH, self.PROJECT, template)
+        self.assertEqual(name, self.THING_NAME)
+
+    def test_w_project_passed_as_none(self):
+        PROJECT1 = "PROJECT1"
+        PATH = "projects/%s/things/%s" % (PROJECT1, self.THING_NAME)
+        self._call_fut(PATH, None, self.TEMPLATE)
+        name = self._call_fut(PATH, None, self.TEMPLATE)
+        self.assertEqual(name, self.THING_NAME)
+
+
+class Test_make_secure_channel(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import make_secure_channel
+
+        return make_secure_channel(*args, **kwargs)
+
+    def test_it(self):
+        from six.moves import http_client
+
+        credentials = object()
+        host = "HOST"
+        user_agent = "USER_AGENT"
+
+        secure_authorized_channel_patch = mock.patch(
+            "google.auth.transport.grpc.secure_authorized_channel", autospec=True
+        )
+
+        with secure_authorized_channel_patch as secure_authorized_channel:
+            result = self._call_fut(credentials, user_agent, host)
+
+        self.assertIs(result, secure_authorized_channel.return_value)
+
+        expected_target = "%s:%d" % (host, http_client.HTTPS_PORT)
+        expected_options = (("grpc.primary_user_agent", user_agent),)
+
+        secure_authorized_channel.assert_called_once_with(
+            credentials, mock.ANY, expected_target, options=expected_options
+        )
+
+    def test_extra_options(self):
+        from six.moves import http_client
+
+        credentials = object()
+        host = "HOST"
+        user_agent = "USER_AGENT"
+        extra_options = (("some", "option"),)
+
+        secure_authorized_channel_patch = mock.patch(
+            "google.auth.transport.grpc.secure_authorized_channel", autospec=True
+        )
+
+        with secure_authorized_channel_patch as secure_authorized_channel:
+            result = self._call_fut(credentials, user_agent, host, extra_options)
+
+        self.assertIs(result, secure_authorized_channel.return_value)
+
+        expected_target = "%s:%d" % (host, http_client.HTTPS_PORT)
+        expected_options = (("grpc.primary_user_agent", user_agent), extra_options[0])
+
+        secure_authorized_channel.assert_called_once_with(
+            credentials, mock.ANY, expected_target, options=expected_options
+        )
+
+
+class Test_make_secure_stub(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import make_secure_stub
+
+        return make_secure_stub(*args, **kwargs)
+
+    def test_it(self):
+        from google.cloud._testing import _Monkey
+        from google.cloud import _helpers as MUT
+
+        result = object()
+        channel_obj = object()
+        channels = []
+        channel_args = []
+
+        def stub_class(channel):
+            channels.append(channel)
+            return result
+
+        def mock_channel(*args, **kwargs):
+            channel_args.append(args)
+            channel_args.append(kwargs)
+            return channel_obj
+
+        credentials = object()
+        user_agent = "you-sir-age-int"
+        host = "localhost"
+        extra_options = {"extra_options": ()}
+        with _Monkey(MUT, make_secure_channel=mock_channel):
+            stub = self._call_fut(credentials, user_agent, stub_class, host)
+
+        self.assertIs(stub, result)
+        self.assertEqual(channels, [channel_obj])
+        self.assertEqual(channel_args, [(credentials, user_agent, host), extra_options])
+
+
+class Test_make_insecure_stub(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud._helpers import make_insecure_stub
+
+        return make_insecure_stub(*args, **kwargs)
+
+    def _helper(self, target, host, port=None):
+        from google.cloud._testing import _Monkey
+        from google.cloud import _helpers as MUT
+
+        mock_result = object()
+        stub_inputs = []
+        CHANNEL = object()
+
+        class _GRPCModule(object):
+            def insecure_channel(self, *args):
+                self.insecure_channel_args = args
+                return CHANNEL
+
+        grpc_mod = _GRPCModule()
+
+        def mock_stub_class(channel):
+            stub_inputs.append(channel)
+            return mock_result
+
+        with _Monkey(MUT, grpc=grpc_mod):
+            result = self._call_fut(mock_stub_class, host, port=port)
+
+        self.assertIs(result, mock_result)
+        self.assertEqual(stub_inputs, [CHANNEL])
+        self.assertEqual(grpc_mod.insecure_channel_args, (target,))
+
+    def test_with_port_argument(self):
+        host = "HOST"
+        port = 1025
+        target = "%s:%d" % (host, port)
+        self._helper(target, host, port=port)
+
+    def test_without_port_argument(self):
+        host = "HOST:1114"
+        self._helper(host, host)
diff --git a/core/tests/unit/test__http.py b/core/tests/unit/test__http.py
new file mode 100644
index 000000000000..d50494e8eadc
--- /dev/null
+++ b/core/tests/unit/test__http.py
@@ -0,0 +1,424 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import unittest
+import warnings
+
+import mock
+import requests
+from six.moves import http_client
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        from google.api_core.client_info import ClientInfo
+
+        client = object()
+        conn = self._make_one(client)
+        self.assertIs(conn._client, client)
+        self.assertIsInstance(conn._client_info, ClientInfo)
+
+    def test_constructor_explicit(self):
+        client = object()
+        client_info = object()
+        conn = self._make_one(client, client_info=client_info)
+        self.assertIs(conn._client, client)
+
+    def test_user_agent_all_caps_getter_deprecated(self):
+        client = object()
+        conn = self._make_one(client)
+
+        with mock.patch.object(warnings, "warn", autospec=True) as warn:
+            self.assertEqual(conn.USER_AGENT, conn._client_info.to_user_agent())
+
+        warn.assert_called_once_with(mock.ANY, DeprecationWarning, stacklevel=2)
+
+    def test_user_agent_all_caps_setter_deprecated(self):
+        conn = self._make_one(object())
+        user_agent = "testing"
+
+        with mock.patch.object(warnings, "warn", autospec=True) as warn:
+            conn.USER_AGENT = user_agent
+
+        self.assertEqual(conn._client_info.user_agent, user_agent)
+        warn.assert_called_once_with(mock.ANY, DeprecationWarning, stacklevel=2)
+
+    def test_user_agent_getter(self):
+        conn = self._make_one(object())
+        self.assertEqual(conn.user_agent, conn._client_info.to_user_agent())
+
+    def test_user_agent_setter(self):
+        conn = self._make_one(object())
+        user_agent = "testing"
+        conn.user_agent = user_agent
+        self.assertEqual(conn._client_info.user_agent, user_agent)
+
+    def test_extra_headers_all_caps_getter_deprecated(self):
+        client = object()
+        conn = self._make_one(client)
+        expected = conn._extra_headers = {"foo": "bar"}
+
+        with mock.patch.object(warnings, "warn", autospec=True) as warn:
+            self.assertEqual(conn._EXTRA_HEADERS, expected)
+
+        warn.assert_called_once_with(mock.ANY, DeprecationWarning, stacklevel=2)
+
+    def test_extra_headers_all_caps_setter_deprecated(self):
+        conn = self._make_one(object())
+        extra_headers = {"foo": "bar"}
+
+        with mock.patch.object(warnings, "warn", autospec=True) as warn:
+            conn._EXTRA_HEADERS = extra_headers
+
+        self.assertEqual(conn._extra_headers, extra_headers)
+        warn.assert_called_once_with(mock.ANY, DeprecationWarning, stacklevel=2)
+
+    def test_extra_headers_getter_default(self):
+        conn = self._make_one(object())
+        expected = {}
+        self.assertEqual(conn.extra_headers, expected)
+
+    def test_extra_headers_getter_overridden(self):
+        conn = self._make_one(object())
+        expected = conn._extra_headers = {"foo": "bar"}
+        self.assertEqual(conn.extra_headers, expected)
+
+    def test_extra_headers_item_assignment(self):
+        conn = self._make_one(object())
+        expected = {"foo": "bar"}
+        conn.extra_headers["foo"] = "bar"
+        self.assertEqual(conn._extra_headers, expected)
+
+    def test_extra_headers_setter(self):
+        conn = self._make_one(object())
+        expected = {"foo": "bar"}
+        conn.extra_headers = expected
+        self.assertEqual(conn._extra_headers, expected)
+
+    def test_credentials_property(self):
+        client = mock.Mock(spec=["_credentials"])
+        conn = self._make_one(client)
+        self.assertIs(conn.credentials, client._credentials)
+
+    def test_http_property(self):
+        client = mock.Mock(spec=["_http"])
+        conn = self._make_one(client)
+        self.assertIs(conn.http, client._http)
+
+
+def make_response(status=http_client.OK, content=b"", headers={}):
+    response = requests.Response()
+    response.status_code = status
+    response._content = content
+    response.headers = headers
+    response.request = requests.Request()
+    return response
+
+
+def make_requests_session(responses):
+    session = mock.create_autospec(requests.Session, instance=True)
+    session.request.side_effect = responses
+    return session
+
+
+class TestJSONConnection(unittest.TestCase):
+    JSON_HEADERS = {"content-type": "application/json"}
+    EMPTY_JSON_RESPONSE = make_response(content=b"{}", headers=JSON_HEADERS)
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud._http import JSONConnection
+
+        return JSONConnection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _make_mock_one(self, *args, **kw):
+        class MockConnection(self._get_target_class()):
+            API_URL_TEMPLATE = "{api_base_url}/mock/{api_version}{path}"
+            API_BASE_URL = "http://mock"
+            API_VERSION = "vMOCK"
+
+        return MockConnection(*args, **kw)
+
+    def test_class_defaults(self):
+        klass = self._get_target_class()
+        self.assertIsNone(klass.API_URL_TEMPLATE)
+        self.assertIsNone(klass.API_BASE_URL)
+        self.assertIsNone(klass.API_VERSION)
+
+    def test_constructor(self):
+        client = object()
+        conn = self._make_one(client)
+        self.assertIs(conn._client, client)
+
+    def test_build_api_url_no_extra_query_params(self):
+        client = object()
+        conn = self._make_mock_one(client)
+        # Intended to emulate self.mock_template
+        URI = "/".join([conn.API_BASE_URL, "mock", conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_extra_query_params(self):
+        from six.moves.urllib.parse import parse_qs
+        from six.moves.urllib.parse import urlsplit
+
+        client = object()
+        conn = self._make_mock_one(client)
+        uri = conn.build_api_url("/foo", {"bar": "baz", "qux": ["quux", "corge"]})
+
+        scheme, netloc, path, qs, _ = urlsplit(uri)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        # Intended to emulate mock_template
+        PATH = "/".join(["", "mock", conn.API_VERSION, "foo"])
+        self.assertEqual(path, PATH)
+        parms = dict(parse_qs(qs))
+        self.assertEqual(parms["bar"], ["baz"])
+        self.assertEqual(parms["qux"], ["quux", "corge"])
+
+    def test__make_request_no_data_no_content_type_no_headers(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([make_response()])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_one(client)
+        url = "http://example.com/test"
+
+        response = conn._make_request("GET", url)
+
+        self.assertEqual(response.status_code, http_client.OK)
+        self.assertEqual(response.content, b"")
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "User-Agent": conn.user_agent,
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=url, headers=expected_headers, data=None
+        )
+
+    def test__make_request_w_data_no_extra_headers(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([make_response()])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_one(client)
+        url = "http://example.com/test"
+        data = b"data"
+
+        conn._make_request("GET", url, data, "application/json")
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "Content-Type": "application/json",
+            "User-Agent": conn.user_agent,
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=url, headers=expected_headers, data=data
+        )
+
+    def test__make_request_w_extra_headers(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([make_response()])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_one(client)
+
+        url = "http://example.com/test"
+        conn._make_request("GET", url, headers={"X-Foo": "foo"})
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "X-Foo": "foo",
+            "User-Agent": conn.user_agent,
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=url, headers=expected_headers, data=None
+        )
+
+    def test_api_request_defaults(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session(
+            [make_response(content=b"{}", headers=self.JSON_HEADERS)]
+        )
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+        path = "/path/required"
+
+        self.assertEqual(conn.api_request("GET", path), {})
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "User-Agent": conn.user_agent,
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        expected_url = "{base}/mock/{version}{path}".format(
+            base=conn.API_BASE_URL, version=conn.API_VERSION, path=path
+        )
+        http.request.assert_called_once_with(
+            method="GET", url=expected_url, headers=expected_headers, data=None
+        )
+
+    def test_api_request_w_non_json_response(self):
+        http = make_requests_session([make_response(content=b"content")])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        with self.assertRaises(ValueError):
+            conn.api_request("GET", "/")
+
+    def test_api_request_wo_json_expected(self):
+        http = make_requests_session([make_response(content=b"content")])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        result = conn.api_request("GET", "/", expect_json=False)
+
+        self.assertEqual(result, b"content")
+
+    def test_api_request_w_query_params(self):
+        from six.moves.urllib.parse import parse_qs
+        from six.moves.urllib.parse import urlsplit
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([self.EMPTY_JSON_RESPONSE])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        result = conn.api_request("GET", "/", {"foo": "bar", "baz": ["qux", "quux"]})
+
+        self.assertEqual(result, {})
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "User-Agent": conn.user_agent,
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, headers=expected_headers, data=None
+        )
+
+        url = http.request.call_args[1]["url"]
+        scheme, netloc, path, qs, _ = urlsplit(url)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        # Intended to emulate self.mock_template
+        PATH = "/".join(["", "mock", conn.API_VERSION, ""])
+        self.assertEqual(path, PATH)
+        parms = dict(parse_qs(qs))
+        self.assertEqual(parms["foo"], ["bar"])
+        self.assertEqual(parms["baz"], ["qux", "quux"])
+
+    def test_api_request_w_headers(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([self.EMPTY_JSON_RESPONSE])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        result = conn.api_request("GET", "/", headers={"X-Foo": "bar"})
+        self.assertEqual(result, {})
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "User-Agent": conn.user_agent,
+            "X-Foo": "bar",
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, headers=expected_headers, data=None
+        )
+
+    def test_api_request_w_extra_headers(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([self.EMPTY_JSON_RESPONSE])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+        conn.extra_headers = {
+            "X-Baz": "dax-quux",
+            "X-Foo": "not-bar",  # Collision with ``headers``.
+        }
+
+        result = conn.api_request("GET", "/", headers={"X-Foo": "bar"})
+
+        self.assertEqual(result, {})
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "User-Agent": conn.user_agent,
+            "X-Foo": "not-bar",  # The one passed-in is overridden.
+            "X-Baz": "dax-quux",
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, headers=expected_headers, data=None
+        )
+
+    def test_api_request_w_data(self):
+        from google.cloud._http import CLIENT_INFO_HEADER
+
+        http = make_requests_session([self.EMPTY_JSON_RESPONSE])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        data = {"foo": "bar"}
+        self.assertEqual(conn.api_request("POST", "/", data=data), {})
+
+        expected_data = json.dumps(data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            "Content-Type": "application/json",
+            "User-Agent": conn.user_agent,
+            CLIENT_INFO_HEADER: conn.user_agent,
+        }
+
+        http.request.assert_called_once_with(
+            method="POST", url=mock.ANY, headers=expected_headers, data=expected_data
+        )
+
+    def test_api_request_w_404(self):
+        from google.cloud import exceptions
+
+        http = make_requests_session([make_response(http_client.NOT_FOUND)])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        with self.assertRaises(exceptions.NotFound):
+            conn.api_request("GET", "/")
+
+    def test_api_request_w_500(self):
+        from google.cloud import exceptions
+
+        http = make_requests_session([make_response(http_client.INTERNAL_SERVER_ERROR)])
+        client = mock.Mock(_http=http, spec=["_http"])
+        conn = self._make_mock_one(client)
+
+        with self.assertRaises(exceptions.InternalServerError):
+            conn.api_request("GET", "/")
diff --git a/core/tests/unit/test_client.py b/core/tests/unit/test_client.py
new file mode 100644
index 000000000000..7aec69ffc701
--- /dev/null
+++ b/core/tests/unit/test_client.py
@@ -0,0 +1,259 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import json
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class Test_ClientFactoryMixin(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.client import _ClientFactoryMixin
+
+        return _ClientFactoryMixin
+
+    def test_virtual(self):
+        klass = self._get_target_class()
+        self.assertFalse("__init__" in klass.__dict__)
+
+
+class TestClient(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_unpickleable(self):
+        import pickle
+
+        CREDENTIALS = _make_credentials()
+        HTTP = object()
+
+        client_obj = self._make_one(credentials=CREDENTIALS, _http=HTTP)
+        with self.assertRaises(pickle.PicklingError):
+            pickle.dumps(client_obj)
+
+    def test_constructor_defaults(self):
+        credentials = _make_credentials()
+
+        patch = mock.patch("google.auth.default", return_value=(credentials, None))
+        with patch as default:
+            client_obj = self._make_one()
+
+        self.assertIs(client_obj._credentials, credentials)
+        self.assertIsNone(client_obj._http_internal)
+        default.assert_called_once_with()
+
+    def test_constructor_explicit(self):
+        credentials = _make_credentials()
+        http = mock.sentinel.http
+        client_obj = self._make_one(credentials=credentials, _http=http)
+
+        self.assertIs(client_obj._credentials, credentials)
+        self.assertIs(client_obj._http_internal, http)
+
+    def test_constructor_bad_credentials(self):
+        credentials = mock.sentinel.credentials
+
+        with self.assertRaises(ValueError):
+            self._make_one(credentials=credentials)
+
+    def test_from_service_account_json(self):
+        from google.cloud import _helpers
+
+        klass = self._get_target_class()
+
+        # Mock both the file opening and the credentials constructor.
+        info = {"dummy": "value", "valid": "json"}
+        json_fi = io.StringIO(_helpers._bytes_to_unicode(json.dumps(info)))
+        file_open_patch = mock.patch("io.open", return_value=json_fi)
+        constructor_patch = mock.patch(
+            "google.oauth2.service_account.Credentials." "from_service_account_info",
+            return_value=_make_credentials(),
+        )
+
+        with file_open_patch as file_open:
+            with constructor_patch as constructor:
+                client_obj = klass.from_service_account_json(mock.sentinel.filename)
+
+        self.assertIs(client_obj._credentials, constructor.return_value)
+        self.assertIsNone(client_obj._http_internal)
+        # Check that mocks were called as expected.
+        file_open.assert_called_once_with(mock.sentinel.filename, "r", encoding="utf-8")
+        constructor.assert_called_once_with(info)
+
+    def test_from_service_account_json_bad_args(self):
+        KLASS = self._get_target_class()
+
+        with self.assertRaises(TypeError):
+            KLASS.from_service_account_json(
+                mock.sentinel.filename, credentials=mock.sentinel.credentials
+            )
+
+    def test__http_property_existing(self):
+        credentials = _make_credentials()
+        http = object()
+        client = self._make_one(credentials=credentials, _http=http)
+        self.assertIs(client._http_internal, http)
+        self.assertIs(client._http, http)
+
+    def test__http_property_new(self):
+        from google.cloud.client import _CREDENTIALS_REFRESH_TIMEOUT
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+        self.assertIsNone(client._http_internal)
+
+        authorized_session_patch = mock.patch(
+            "google.auth.transport.requests.AuthorizedSession",
+            return_value=mock.sentinel.http,
+        )
+        with authorized_session_patch as AuthorizedSession:
+            self.assertIs(client._http, mock.sentinel.http)
+            # Check the mock.
+            AuthorizedSession.assert_called_once_with(credentials, refresh_timeout=_CREDENTIALS_REFRESH_TIMEOUT)
+            # Make sure the cached value is used on subsequent access.
+            self.assertIs(client._http_internal, mock.sentinel.http)
+            self.assertIs(client._http, mock.sentinel.http)
+            self.assertEqual(AuthorizedSession.call_count, 1)
+
+
+class TestClientWithProject(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.client import ClientWithProject
+
+        return ClientWithProject
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        credentials = _make_credentials()
+        patch1 = mock.patch("google.auth.default", return_value=(credentials, None))
+
+        project = "prahj-ekt"
+        patch2 = mock.patch(
+            "google.cloud.client._determine_default_project", return_value=project
+        )
+
+        with patch1 as default:
+            with patch2 as _determine_default_project:
+                client_obj = self._make_one()
+
+        self.assertEqual(client_obj.project, project)
+        self.assertIs(client_obj._credentials, credentials)
+        self.assertIsNone(client_obj._http_internal)
+        default.assert_called_once_with()
+        _determine_default_project.assert_called_once_with(None)
+
+    def test_constructor_missing_project(self):
+        from google.cloud._testing import _Monkey
+        from google.cloud import client
+
+        FUNC_CALLS = []
+
+        def mock_determine_proj(project):
+            FUNC_CALLS.append((project, "_determine_default_project"))
+            return None
+
+        with _Monkey(client, _determine_default_project=mock_determine_proj):
+            self.assertRaises(EnvironmentError, self._make_one)
+
+        self.assertEqual(FUNC_CALLS, [(None, "_determine_default_project")])
+
+    def test_constructor_w_invalid_project(self):
+        CREDENTIALS = _make_credentials()
+        HTTP = object()
+        with self.assertRaises(ValueError):
+            self._make_one(project=object(), credentials=CREDENTIALS, _http=HTTP)
+
+    def _explicit_ctor_helper(self, project):
+        import six
+
+        CREDENTIALS = _make_credentials()
+        HTTP = object()
+
+        client_obj = self._make_one(
+            project=project, credentials=CREDENTIALS, _http=HTTP
+        )
+
+        if isinstance(project, six.binary_type):
+            self.assertEqual(client_obj.project, project.decode("utf-8"))
+        else:
+            self.assertEqual(client_obj.project, project)
+        self.assertIs(client_obj._credentials, CREDENTIALS)
+        self.assertIs(client_obj._http_internal, HTTP)
+
+    def test_constructor_explicit_bytes(self):
+        PROJECT = b"PROJECT"
+        self._explicit_ctor_helper(PROJECT)
+
+    def test_constructor_explicit_unicode(self):
+        PROJECT = u"PROJECT"
+        self._explicit_ctor_helper(PROJECT)
+
+    def _from_service_account_json_helper(self, project=None):
+        from google.cloud import _helpers
+
+        klass = self._get_target_class()
+
+        info = {"dummy": "value", "valid": "json"}
+        if project is None:
+            expected_project = "eye-d-of-project"
+        else:
+            expected_project = project
+
+        info["project_id"] = expected_project
+        # Mock both the file opening and the credentials constructor.
+        json_fi = io.StringIO(_helpers._bytes_to_unicode(json.dumps(info)))
+        file_open_patch = mock.patch("io.open", return_value=json_fi)
+        constructor_patch = mock.patch(
+            "google.oauth2.service_account.Credentials." "from_service_account_info",
+            return_value=_make_credentials(),
+        )
+
+        with file_open_patch as file_open:
+            with constructor_patch as constructor:
+                kwargs = {}
+                if project is not None:
+                    kwargs["project"] = project
+                client_obj = klass.from_service_account_json(
+                    mock.sentinel.filename, **kwargs
+                )
+
+        self.assertIs(client_obj._credentials, constructor.return_value)
+        self.assertIsNone(client_obj._http_internal)
+        self.assertEqual(client_obj.project, expected_project)
+        # Check that mocks were called as expected.
+        file_open.assert_called_once_with(mock.sentinel.filename, "r", encoding="utf-8")
+        constructor.assert_called_once_with(info)
+
+    def test_from_service_account_json(self):
+        self._from_service_account_json_helper()
+
+    def test_from_service_account_json_project_set(self):
+        self._from_service_account_json_helper(project="prah-jekt")
diff --git a/core/tests/unit/test_exceptions.py b/core/tests/unit/test_exceptions.py
new file mode 100644
index 000000000000..8c9a04d6decf
--- /dev/null
+++ b/core/tests/unit/test_exceptions.py
@@ -0,0 +1,128 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+
+import requests
+from six.moves import http_client
+
+from google.cloud import exceptions
+
+
+def test_create_google_cloud_error():
+    exception = exceptions.GoogleCloudError("Testing")
+    exception.code = 600
+    assert str(exception) == "600 Testing"
+    assert exception.message == "Testing"
+    assert exception.errors == []
+
+
+def test_create_google_cloud_error_with_args():
+    error = {
+        "domain": "global",
+        "location": "test",
+        "locationType": "testing",
+        "message": "Testing",
+        "reason": "test",
+    }
+    exception = exceptions.GoogleCloudError("Testing", [error])
+    exception.code = 600
+    assert str(exception) == "600 Testing"
+    assert exception.message == "Testing"
+    assert exception.errors == [error]
+
+
+def test_from_http_status():
+    message = "message"
+    exception = exceptions.from_http_status(http_client.NOT_FOUND, message)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == message
+    assert exception.errors == []
+
+
+def test_from_http_status_with_errors():
+    message = "message"
+    errors = ["1", "2"]
+    exception = exceptions.from_http_status(
+        http_client.NOT_FOUND, message, errors=errors
+    )
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == message
+    assert exception.errors == errors
+
+
+def test_from_http_status_unknown_code():
+    message = "message"
+    status_code = 156
+    exception = exceptions.from_http_status(status_code, message)
+    assert exception.code == status_code
+    assert exception.message == message
+
+
+def make_response(content):
+    response = requests.Response()
+    response._content = content
+    response.status_code = http_client.NOT_FOUND
+    response.request = requests.Request(
+        method="POST", url="https://example.com"
+    ).prepare()
+    return response
+
+
+def test_from_http_response_no_content():
+    response = make_response(None)
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: unknown error"
+    assert exception.response == response
+
+
+def test_from_http_response_text_content():
+    response = make_response(b"message")
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: message"
+
+
+def test_from_http_response_json_content():
+    response = make_response(
+        json.dumps({"error": {"message": "json message", "errors": ["1", "2"]}}).encode(
+            "utf-8"
+        )
+    )
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: json message"
+    assert exception.errors == ["1", "2"]
+
+
+def test_from_http_response_bad_json_content():
+    response = make_response(json.dumps({"meep": "moop"}).encode("utf-8"))
+
+    exception = exceptions.from_http_response(response)
+
+    assert isinstance(exception, exceptions.NotFound)
+    assert exception.code == http_client.NOT_FOUND
+    assert exception.message == "POST https://example.com/: unknown error"
diff --git a/core/tests/unit/test_obsolete.py b/core/tests/unit/test_obsolete.py
new file mode 100644
index 000000000000..3c38005fb5b6
--- /dev/null
+++ b/core/tests/unit/test_obsolete.py
@@ -0,0 +1,31 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import warnings
+
+import mock
+
+from google.cloud import obsolete
+
+
+def test_complain_noop():
+    with mock.patch.object(warnings, "warn", autospec=True) as warn:
+        obsolete.complain("bogus_package")
+        assert warn.call_count == 0
+
+
+def test_complain():
+    with mock.patch.object(warnings, "warn", autospec=True) as warn:
+        obsolete.complain("google-cloud-core")
+        warn.assert_called_once_with(mock.ANY, DeprecationWarning)
diff --git a/core/tests/unit/test_operation.py b/core/tests/unit/test_operation.py
new file mode 100644
index 000000000000..5a86dbed9e4e
--- /dev/null
+++ b/core/tests/unit/test_operation.py
@@ -0,0 +1,410 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class Test__compute_type_url(unittest.TestCase):
+    def _call_fut(self, klass, prefix=None):
+        from google.cloud.operation import _compute_type_url
+
+        if prefix is None:
+            return _compute_type_url(klass)
+        return _compute_type_url(klass, prefix)
+
+    def test_wo_prefix(self):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.operation import _GOOGLE_APIS_PREFIX
+
+        type_url = self._call_fut(Struct)
+
+        self.assertEqual(
+            type_url, "%s/%s" % (_GOOGLE_APIS_PREFIX, Struct.DESCRIPTOR.full_name)
+        )
+
+    def test_w_prefix(self):
+        from google.protobuf.struct_pb2 import Struct
+
+        PREFIX = "test.google-cloud-python.com"
+
+        type_url = self._call_fut(Struct, PREFIX)
+
+        self.assertEqual(type_url, "%s/%s" % (PREFIX, Struct.DESCRIPTOR.full_name))
+
+
+class Test_register_type(unittest.TestCase):
+    def _call_fut(self, klass, type_url=None):
+        from google.cloud.operation import register_type
+
+        register_type(klass, type_url=type_url)
+
+    def test_explicit(self):
+        from google.cloud import operation as MUT
+        from google.cloud._testing import _Monkey
+
+        type_url = "testing.google-cloud-python.com/testing"
+        klass = object()
+        type_url_map = {}
+
+        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
+            self._call_fut(klass, type_url)
+
+        self.assertEqual(type_url_map, {type_url: klass})
+
+    def test_default(self):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud._testing import _Monkey
+        from google.cloud import operation as MUT
+
+        type_url_map = {}
+        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
+            self._call_fut(Struct)
+
+        type_url = MUT._compute_type_url(Struct)
+        self.assertEqual(type_url_map, {type_url: Struct})
+
+    def test_w_same_class(self):
+        from google.cloud import operation as MUT
+        from google.cloud._testing import _Monkey
+
+        type_url = "testing.google-cloud-python.com/testing"
+        klass = object()
+        type_url_map = {type_url: klass}
+
+        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
+            self._call_fut(klass, type_url)
+
+        self.assertEqual(type_url_map, {type_url: klass})
+
+    def test_w_conflict(self):
+        from google.cloud import operation as MUT
+        from google.cloud._testing import _Monkey
+
+        type_url = "testing.google-cloud-python.com/testing"
+        klass, other = object(), object()
+        type_url_map = {type_url: other}
+
+        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
+            with self.assertRaises(ValueError):
+                self._call_fut(klass, type_url)
+
+        self.assertEqual(type_url_map, {type_url: other})
+
+
+class TestOperation(unittest.TestCase):
+
+    OPERATION_NAME = "operations/projects/foo/instances/bar/operations/123"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.operation import Operation
+
+        return Operation
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        client = _Client()
+        operation = self._make_one(self.OPERATION_NAME, client)
+        self.assertEqual(operation.name, self.OPERATION_NAME)
+        self.assertIs(operation.client, client)
+        self.assertIsNone(operation.target)
+        self.assertIsNone(operation.response)
+        self.assertIsNone(operation.error)
+        self.assertIsNone(operation.metadata)
+        self.assertEqual(operation.caller_metadata, {})
+        self.assertTrue(operation._from_grpc)
+
+    def test_ctor_explicit(self):
+        client = _Client()
+        operation = self._make_one(self.OPERATION_NAME, client, foo="bar")
+
+        self.assertEqual(operation.name, self.OPERATION_NAME)
+        self.assertIs(operation.client, client)
+        self.assertIsNone(operation.target)
+        self.assertIsNone(operation.response)
+        self.assertIsNone(operation.error)
+        self.assertIsNone(operation.metadata)
+        self.assertEqual(operation.caller_metadata, {"foo": "bar"})
+        self.assertTrue(operation._from_grpc)
+
+    def test_from_pb_wo_metadata_or_kw(self):
+        from google.longrunning import operations_pb2
+
+        client = _Client()
+        operation_pb = operations_pb2.Operation(name=self.OPERATION_NAME)
+        klass = self._get_target_class()
+
+        operation = klass.from_pb(operation_pb, client)
+
+        self.assertEqual(operation.name, self.OPERATION_NAME)
+        self.assertIs(operation.client, client)
+        self.assertIsNone(operation.metadata)
+        self.assertEqual(operation.caller_metadata, {})
+
+    def test_from_pb_w_unknown_metadata(self):
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.protobuf.json_format import ParseDict
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud._testing import _Monkey
+        from google.cloud import operation as MUT
+
+        type_url = "type.googleapis.com/%s" % (Struct.DESCRIPTOR.full_name,)
+        client = _Client()
+        meta = ParseDict({"foo": "Bar"}, Struct())
+        metadata_pb = Any(type_url=type_url, value=meta.SerializeToString())
+        operation_pb = operations_pb2.Operation(
+            name=self.OPERATION_NAME, metadata=metadata_pb
+        )
+        klass = self._get_target_class()
+
+        with _Monkey(MUT, _TYPE_URL_MAP={type_url: Struct}):
+            operation = klass.from_pb(operation_pb, client)
+
+        self.assertEqual(operation.name, self.OPERATION_NAME)
+        self.assertIs(operation.client, client)
+        self.assertEqual(operation.metadata, meta)
+        self.assertEqual(operation.caller_metadata, {})
+
+    def test_from_pb_w_metadata_and_kwargs(self):
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud import operation as MUT
+        from google.cloud._testing import _Monkey
+
+        type_url = "type.googleapis.com/%s" % (Struct.DESCRIPTOR.full_name,)
+        type_url_map = {type_url: Struct}
+
+        client = _Client()
+        meta = Struct(fields={"foo": Value(string_value=u"Bar")})
+        metadata_pb = Any(type_url=type_url, value=meta.SerializeToString())
+        operation_pb = operations_pb2.Operation(
+            name=self.OPERATION_NAME, metadata=metadata_pb
+        )
+        klass = self._get_target_class()
+
+        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
+            operation = klass.from_pb(operation_pb, client, baz="qux")
+
+        self.assertEqual(operation.name, self.OPERATION_NAME)
+        self.assertIs(operation.client, client)
+        self.assertEqual(operation.metadata, meta)
+        self.assertEqual(operation.caller_metadata, {"baz": "qux"})
+
+    def test_from_dict(self):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud._testing import _Monkey
+        from google.cloud import operation as MUT
+
+        type_url = "type.googleapis.com/%s" % (Struct.DESCRIPTOR.full_name,)
+        api_response = {
+            "name": self.OPERATION_NAME,
+            "metadata": {"@type": type_url, "value": {"foo": "Bar"}},
+        }
+
+        client = _Client()
+        klass = self._get_target_class()
+
+        with _Monkey(MUT, _TYPE_URL_MAP={type_url: Struct}):
+            operation = klass.from_dict(api_response, client)
+
+        self.assertEqual(operation.name, self.OPERATION_NAME)
+        self.assertIs(operation.client, client)
+        self.assertIsNone(operation.target)
+        self.assertIsNone(operation.response)
+        self.assertIsNone(operation.error)
+        self.assertIsInstance(operation.metadata, Struct)
+        self.assertEqual(len(operation.metadata.fields), 1)
+        self.assertEqual(operation.metadata.fields["foo"].string_value, "Bar")
+        self.assertEqual(operation.caller_metadata, {})
+        self.assertFalse(operation._from_grpc)
+
+    def test_complete_property(self):
+        client = _Client()
+        operation = self._make_one(self.OPERATION_NAME, client)
+        self.assertFalse(operation.complete)
+        operation._complete = True
+        self.assertTrue(operation.complete)
+        with self.assertRaises(AttributeError):
+            operation.complete = False
+
+    def test_poll_already_complete(self):
+        client = _Client()
+        operation = self._make_one(self.OPERATION_NAME, client)
+        operation._complete = True
+
+        with self.assertRaises(ValueError):
+            operation.poll()
+
+    def test_poll_false(self):
+        from google.longrunning import operations_pb2
+
+        response_pb = operations_pb2.Operation(done=False)
+        client = _Client()
+        stub = client._operations_stub
+        stub._get_operation_response = response_pb
+        operation = self._make_one(self.OPERATION_NAME, client)
+
+        self.assertFalse(operation.poll())
+
+        request_pb = stub._get_operation_requested
+        self.assertIsInstance(request_pb, operations_pb2.GetOperationRequest)
+        self.assertEqual(request_pb.name, self.OPERATION_NAME)
+
+    def test_poll_true(self):
+        from google.longrunning import operations_pb2
+
+        response_pb = operations_pb2.Operation(done=True)
+        client = _Client()
+        stub = client._operations_stub
+        stub._get_operation_response = response_pb
+        operation = self._make_one(self.OPERATION_NAME, client)
+
+        self.assertTrue(operation.poll())
+
+        request_pb = stub._get_operation_requested
+        self.assertIsInstance(request_pb, operations_pb2.GetOperationRequest)
+        self.assertEqual(request_pb.name, self.OPERATION_NAME)
+
+    def test_poll_http(self):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud._testing import _Monkey
+        from google.cloud import operation as MUT
+
+        type_url = "type.googleapis.com/%s" % (Struct.DESCRIPTOR.full_name,)
+        name = "2302903294023"
+        api_response = {
+            "name": name,
+            "done": True,
+            "metadata": {"@type": type_url, "value": {"foo": "Bar"}},
+        }
+        connection = _Connection(api_response)
+        client = _Client(connection)
+        operation = self._make_one(name, client)
+        operation._from_grpc = False
+
+        with _Monkey(MUT, _TYPE_URL_MAP={type_url: Struct}):
+            self.assertTrue(operation.poll())
+
+        expected_path = "operations/%s" % (name,)
+        self.assertEqual(
+            connection._requested, [{"method": "GET", "path": expected_path}]
+        )
+
+    def test__update_state_done(self):
+        from google.longrunning import operations_pb2
+
+        operation = self._make_one(None, None)
+        self.assertFalse(operation.complete)
+        operation_pb = operations_pb2.Operation(done=True)
+        operation._update_state(operation_pb)
+        self.assertTrue(operation.complete)
+
+    def test__update_state_metadata(self):
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud._testing import _Monkey
+        from google.cloud import operation as MUT
+
+        operation = self._make_one(None, None)
+        self.assertIsNone(operation.metadata)
+
+        val_pb = Value(number_value=1337)
+        type_url = "type.googleapis.com/%s" % (Value.DESCRIPTOR.full_name,)
+        val_any = Any(type_url=type_url, value=val_pb.SerializeToString())
+        operation_pb = operations_pb2.Operation(metadata=val_any)
+
+        with _Monkey(MUT, _TYPE_URL_MAP={type_url: Value}):
+            operation._update_state(operation_pb)
+
+        self.assertEqual(operation.metadata, val_pb)
+
+    def test__update_state_error(self):
+        from google.longrunning import operations_pb2
+        from google.rpc.status_pb2 import Status
+
+        operation = self._make_one(None, None)
+        self.assertIsNone(operation.error)
+        self.assertIsNone(operation.response)
+
+        error_pb = Status(code=1)
+        operation_pb = operations_pb2.Operation(error=error_pb)
+        operation._update_state(operation_pb)
+
+        self.assertEqual(operation.error, error_pb)
+        self.assertIsNone(operation.response)
+
+    def test__update_state_response(self):
+        from google.longrunning import operations_pb2
+        from google.protobuf.any_pb2 import Any
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud._testing import _Monkey
+        from google.cloud import operation as MUT
+
+        operation = self._make_one(None, None)
+        self.assertIsNone(operation.error)
+        self.assertIsNone(operation.response)
+
+        response_pb = Value(string_value="totes a response")
+        type_url = "type.googleapis.com/%s" % (Value.DESCRIPTOR.full_name,)
+        response_any = Any(type_url=type_url, value=response_pb.SerializeToString())
+        operation_pb = operations_pb2.Operation(response=response_any)
+
+        with _Monkey(MUT, _TYPE_URL_MAP={type_url: Value}):
+            operation._update_state(operation_pb)
+
+        self.assertIsNone(operation.error)
+        self.assertEqual(operation.response, response_pb)
+
+    def test__update_state_no_result(self):
+        from google.longrunning import operations_pb2
+
+        operation = self._make_one(None, None)
+        self.assertIsNone(operation.error)
+        self.assertIsNone(operation.response)
+
+        operation_pb = operations_pb2.Operation()
+        operation._update_state(operation_pb)
+
+        # Make sure nothing changed.
+        self.assertIsNone(operation.error)
+        self.assertIsNone(operation.response)
+
+
+class _OperationsStub(object):
+    def GetOperation(self, request_pb):
+        self._get_operation_requested = request_pb
+        return self._get_operation_response
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
+
+
+class _Client(object):
+    def __init__(self, connection=None):
+        self._operations_stub = _OperationsStub()
+        self._connection = connection
diff --git a/datacatalog/.coveragerc b/datacatalog/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/datacatalog/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/datacatalog/.flake8 b/datacatalog/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/datacatalog/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/datacatalog/.repo-metadata.json b/datacatalog/.repo-metadata.json
new file mode 100644
index 000000000000..1f4146d07caf
--- /dev/null
+++ b/datacatalog/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "datacatalog ",
+  "name_pretty": "Google Cloud Data Catalog",
+  "product_documentation": "https://cloud.google.com/data-catalog",
+  "client_documentation": "https://googleapis.dev/python/datacatalog/latest",
+  "issue_tracker": "",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-datacatalog",
+  "api_id": "datacatalog.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/datacatalog/CHANGELOG.md b/datacatalog/CHANGELOG.md
new file mode 100644
index 000000000000..f8cce1a5f3f5
--- /dev/null
+++ b/datacatalog/CHANGELOG.md
@@ -0,0 +1,62 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-datacatalog/#history
+
+## 0.3.0
+
+07-24-2019 15:58 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8425](https://github.com/googleapis/google-cloud-python/pull/8425))
+
+### New Features
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8654](https://github.com/googleapis/google-cloud-python/pull/8654))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8503](https://github.com/googleapis/google-cloud-python/pull/8503))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Add get_entry sample (via synth). ([#8725](https://github.com/googleapis/google-cloud-python/pull/8725))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add generated samples (via synth). ([#8710](https://github.com/googleapis/google-cloud-python/pull/8710))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Update docstrings (via synth). ([#8299](https://github.com/googleapis/google-cloud-python/pull/8299))
+
+### Internal / Testing Changes
+- Enable Sample Generator Tool for Data Catalog ([#8708](https://github.com/googleapis/google-cloud-python/pull/8708))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.2.0
+
+06-12-2019 12:46 PDT
+
+### New Features
+
+- Add search capability, tags that match a query, and IAM policies ([#8266](https://github.com/googleapis/google-cloud-python/pull/8266))
+- Add protos as an artifact to library (via synth). ([#8018](https://github.com/googleapis/google-cloud-python/pull/8018))
+
+### Documentation
+
+- Add nox session `docs`, reorder methods (via synth). ([#7766](https://github.com/googleapis/google-cloud-python/pull/7766))
+- Fix broken link to client library docs in README ([#7713](https://github.com/googleapis/google-cloud-python/pull/7713))
+
+### Internal / Testing Changes
+
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8235](https://github.com/googleapis/google-cloud-python/pull/8235))
+- Fix coverage in 'types.py' (via synth). ([#8150](https://github.com/googleapis/google-cloud-python/pull/8150))
+- Blacken noxfile.py, setup.py (via synth). ([#8117](https://github.com/googleapis/google-cloud-python/pull/8117))
+- Add empty lines (via synth). ([#8052](https://github.com/googleapis/google-cloud-python/pull/8052))
+
+## 0.1.0
+
+04-15-2019 15:46 PDT
+
+### New Features
+
+- Initial release of Cloud Data Catalog client. ([#7708](https://github.com/googleapis/google-cloud-python/pull/7708))
+
diff --git a/datacatalog/LICENSE b/datacatalog/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/datacatalog/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/datacatalog/MANIFEST.in b/datacatalog/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/datacatalog/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/datacatalog/README.rst b/datacatalog/README.rst
new file mode 100644
index 000000000000..89e94822d38c
--- /dev/null
+++ b/datacatalog/README.rst
@@ -0,0 +1,79 @@
+Python Client for Google Cloud Data Catalog API (`Alpha`_)
+==========================================================
+
+
+
+`Google Cloud Data Catalog API`_: Google Cloud Data Catalog API provides features to attach metadata to
+Google Cloud Platform resources like BigQuery Tables. Key critical resources
+include: Entries (Data Catalog representation of a cloud resource).
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Google Cloud Data Catalog API: https://cloud.google.com/data-catalog
+.. _Client Library Documentation: https://googleapis.dev/python/datacatalog/latest
+.. _Product Documentation:  https://cloud.google.com/data-catalog
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Data Catalog API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Data Catalog API.:  https://cloud.google.com/data-catalog
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-datacatalog
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-datacatalog
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Data Catalog API
+   API to see other available methods on the client.
+-  Read the `Google Cloud Data Catalog API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Google Cloud Data Catalog API Product documentation:  https://cloud.google.com/data-catalog
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/datacatalog/docs/README.rst b/datacatalog/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/datacatalog/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/datacatalog/docs/changelog.md b/datacatalog/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/datacatalog/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/datacatalog/docs/conf.py b/datacatalog/docs/conf.py
new file mode 100644
index 000000000000..194ca0394eeb
--- /dev/null
+++ b/datacatalog/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-datacatalog documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-datacatalog"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-datacatalog-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-datacatalog.tex",
+        u"google-cloud-datacatalog Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-datacatalog",
+        u"google-cloud-datacatalog Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-datacatalog",
+        u"google-cloud-datacatalog Documentation",
+        author,
+        "google-cloud-datacatalog",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/datacatalog/docs/gapic/v1beta1/api.rst b/datacatalog/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..4c56460c09d7
--- /dev/null
+++ b/datacatalog/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Data Catalog API
+========================================
+
+.. automodule:: google.cloud.datacatalog_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/datacatalog/docs/gapic/v1beta1/types.rst b/datacatalog/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..bcc6cefbd1f7
--- /dev/null
+++ b/datacatalog/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Data Catalog API Client
+==============================================
+
+.. automodule:: google.cloud.datacatalog_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/datacatalog/docs/index.rst b/datacatalog/docs/index.rst
new file mode 100644
index 000000000000..3964113dcdcd
--- /dev/null
+++ b/datacatalog/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1beta1/api
+   gapic/v1beta1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-datacatalog`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/datacatalog/google/__init__.py b/datacatalog/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/datacatalog/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/datacatalog/google/cloud/__init__.py b/datacatalog/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/datacatalog/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/datacatalog/google/cloud/datacatalog.py b/datacatalog/google/cloud/datacatalog.py
new file mode 100644
index 000000000000..f26d34f6712d
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.datacatalog_v1beta1 import DataCatalogClient
+from google.cloud.datacatalog_v1beta1 import enums
+from google.cloud.datacatalog_v1beta1 import types
+
+
+__all__ = ("enums", "types", "DataCatalogClient")
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/__init__.py b/datacatalog/google/cloud/datacatalog_v1beta1/__init__.py
new file mode 100644
index 000000000000..b025cf9d805e
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/__init__.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.datacatalog_v1beta1 import types
+from google.cloud.datacatalog_v1beta1.gapic import data_catalog_client
+from google.cloud.datacatalog_v1beta1.gapic import enums
+
+
+class DataCatalogClient(data_catalog_client.DataCatalogClient):
+    __doc__ = data_catalog_client.DataCatalogClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DataCatalogClient")
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/gapic/__init__.py b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py
new file mode 100644
index 000000000000..3be193c2d2f0
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py
@@ -0,0 +1,1902 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.datacatalog.v1beta1 DataCatalog API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.datacatalog_v1beta1.gapic import data_catalog_client_config
+from google.cloud.datacatalog_v1beta1.gapic import enums
+from google.cloud.datacatalog_v1beta1.gapic.transports import (
+    data_catalog_grpc_transport,
+)
+from google.cloud.datacatalog_v1beta1.proto import datacatalog_pb2
+from google.cloud.datacatalog_v1beta1.proto import datacatalog_pb2_grpc
+from google.cloud.datacatalog_v1beta1.proto import tags_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-datacatalog"
+).version
+
+
+class DataCatalogClient(object):
+    """
+    Data Catalog API service allows clients to discover, understand, and manage
+    their data.
+    """
+
+    SERVICE_ADDRESS = "datacatalog.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.datacatalog.v1beta1.DataCatalog"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DataCatalogClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def entry_path(cls, project, location, entry_group, entry):
+        """Return a fully-qualified entry string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}",
+            project=project,
+            location=location,
+            entry_group=entry_group,
+            entry=entry,
+        )
+
+    @classmethod
+    def field_path(cls, project, location, tag_template, field):
+        """Return a fully-qualified field string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}",
+            project=project,
+            location=location,
+            tag_template=tag_template,
+            field=field,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def tag_path(cls, project, location, entry_group, entry, tag):
+        """Return a fully-qualified tag string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}",
+            project=project,
+            location=location,
+            entry_group=entry_group,
+            entry=entry,
+            tag=tag,
+        )
+
+    @classmethod
+    def tag_template_path(cls, project, location, tag_template):
+        """Return a fully-qualified tag_template string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/tagTemplates/{tag_template}",
+            project=project,
+            location=location,
+            tag_template=tag_template,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DataCatalogGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DataCatalogGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = data_catalog_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=data_catalog_grpc_transport.DataCatalogGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = data_catalog_grpc_transport.DataCatalogGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def search_catalog(
+        self,
+        scope,
+        query,
+        page_size=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 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.
+
+        See `Data Catalog Search
+        Syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__
+        for more information.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> # TODO: Initialize `scope`:
+            >>> scope = {}
+            >>>
+            >>> # TODO: Initialize `query`:
+            >>> query = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_catalog(scope, query):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_catalog(scope, query).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            scope (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Scope]): Required. The scope of this search request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.Scope`
+            query (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Specifies the ordering of results, currently supported case-sensitive
+                choices are:
+
+                .. raw:: html
+
+                    <ul>
+                      <li> relevance </li>
+                      <li> last_access_timestamp [asc|desc], defaults to descending if not
+                      specified, </li>
+                      <li> last_modified_timestamp [asc|desc], defaults to descending if not
+                      specified. </li>
+                    </ul>
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datacatalog_v1beta1.types.SearchCatalogResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_catalog" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_catalog"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_catalog,
+                default_retry=self._method_configs["SearchCatalog"].retry,
+                default_timeout=self._method_configs["SearchCatalog"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.SearchCatalogRequest(
+            scope=scope, query=query, page_size=page_size, order_by=order_by
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_catalog"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_entry(
+        self,
+        entry,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing entry.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> # TODO: Initialize `entry`:
+            >>> entry = {}
+            >>>
+            >>> response = client.update_entry(entry)
+
+        Args:
+            entry (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Entry]): Required. The updated Entry.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.Entry`
+            update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Optional. The fields to update on the entry. If absent or empty, all
+                modifiable fields are updated.
+
+                Modifiable fields in synced entries:
+
+                1. schema (Pub/Sub topics only)
+
+                Modifiable fields in native entries:
+
+                1. display\_name
+                2. description
+                3. schema
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Entry` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_entry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_entry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_entry,
+                default_retry=self._method_configs["UpdateEntry"].retry,
+                default_timeout=self._method_configs["UpdateEntry"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.UpdateEntryRequest(
+            entry=entry, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("entry.name", entry.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_entry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_entry(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an entry.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]')
+            >>>
+            >>> response = client.get_entry(name)
+
+        Args:
+            name (str): Required. The name of the entry. For example,
+                "projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id}".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Entry` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_entry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_entry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_entry,
+                default_retry=self._method_configs["GetEntry"].retry,
+                default_timeout=self._method_configs["GetEntry"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.GetEntryRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_entry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def lookup_entry(
+        self,
+        linked_resource=None,
+        sql_resource=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> response = client.lookup_entry()
+
+        Args:
+            linked_resource (str): 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"
+            sql_resource (str): The SQL name of the entry. SQL names are case-sensitive.
+
+                Examples:
+
+                .. raw:: html
+
+                    <ul>
+                      <li>cloud_pubsub.project_id.topic_id</li>
+                      <li>pubsub.project_id.`topic.id.with.dots`</li>
+                      <li>bigquery.project_id.dataset_id.table_id</li>
+                      <li>datacatalog.project_id.location_id.entry_group_id.entry_id</li>
+                    </ul>
+                    *_ids shoud satisfy the standard SQL rules for identifiers.
+                    https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Entry` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "lookup_entry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "lookup_entry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.lookup_entry,
+                default_retry=self._method_configs["LookupEntry"].retry,
+                default_timeout=self._method_configs["LookupEntry"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            linked_resource=linked_resource, sql_resource=sql_resource
+        )
+
+        request = datacatalog_pb2.LookupEntryRequest(
+            linked_resource=linked_resource, sql_resource=sql_resource
+        )
+        return self._inner_api_calls["lookup_entry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_tag_template(
+        self,
+        parent,
+        tag_template_id,
+        tag_template,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a tag template.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `tag_template_id`:
+            >>> tag_template_id = ''
+            >>>
+            >>> # TODO: Initialize `tag_template`:
+            >>> tag_template = {}
+            >>>
+            >>> response = client.create_tag_template(parent, tag_template_id, tag_template)
+
+        Args:
+            parent (str): 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.
+            tag_template_id (str): Required. The id of the tag template to create.
+            tag_template (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplate]): Required. The tag template to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplate`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_tag_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_tag_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_tag_template,
+                default_retry=self._method_configs["CreateTagTemplate"].retry,
+                default_timeout=self._method_configs["CreateTagTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.CreateTagTemplateRequest(
+            parent=parent, tag_template_id=tag_template_id, tag_template=tag_template
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_tag_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_tag_template(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a tag template.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]')
+            >>>
+            >>> response = client.get_tag_template(name)
+
+        Args:
+            name (str): Required. The name of the tag template. For example,
+                "projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_tag_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_tag_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_tag_template,
+                default_retry=self._method_configs["GetTagTemplate"].retry,
+                default_timeout=self._method_configs["GetTagTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.GetTagTemplateRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_tag_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_tag_template(
+        self,
+        tag_template,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> # TODO: Initialize `tag_template`:
+            >>> tag_template = {}
+            >>>
+            >>> response = client.update_tag_template(tag_template)
+
+        Args:
+            tag_template (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplate]): Required. The template to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplate`
+            update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Optional. The field mask specifies the parts of the template to
+                overwrite.
+
+                Allowed fields:
+
+                -  display\_name
+
+                If update\_mask is omitted, all of the allowed fields above will be
+                updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_tag_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_tag_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_tag_template,
+                default_retry=self._method_configs["UpdateTagTemplate"].retry,
+                default_timeout=self._method_configs["UpdateTagTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.UpdateTagTemplateRequest(
+            tag_template=tag_template, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("tag_template.name", tag_template.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_tag_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_tag_template(
+        self,
+        name,
+        force,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a tag template and all tags using the template.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]')
+            >>>
+            >>> # TODO: Initialize `force`:
+            >>> force = False
+            >>>
+            >>> client.delete_tag_template(name, force)
+
+        Args:
+            name (str): Required. The name of the tag template to delete. For example,
+                "projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}".
+            force (bool): Required. Currently, this field must always be set to <code>true</code>.
+                This confirms the deletion of any possible tags using this template.
+                <code>force = false</code> will be supported in the future.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_tag_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_tag_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_tag_template,
+                default_retry=self._method_configs["DeleteTagTemplate"].retry,
+                default_timeout=self._method_configs["DeleteTagTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.DeleteTagTemplateRequest(name=name, force=force)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_tag_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_tag_template_field(
+        self,
+        parent,
+        tag_template_field_id,
+        tag_template_field,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a field in a tag template.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> parent = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]')
+            >>>
+            >>> # TODO: Initialize `tag_template_field_id`:
+            >>> tag_template_field_id = ''
+            >>>
+            >>> # TODO: Initialize `tag_template_field`:
+            >>> tag_template_field = {}
+            >>>
+            >>> response = client.create_tag_template_field(parent, tag_template_field_id, tag_template_field)
+
+        Args:
+            parent (str): 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.
+            tag_template_field_id (str): 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.
+            tag_template_field (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplateField]): Required. The tag template field to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplateField`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplateField` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_tag_template_field" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_tag_template_field"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_tag_template_field,
+                default_retry=self._method_configs["CreateTagTemplateField"].retry,
+                default_timeout=self._method_configs["CreateTagTemplateField"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.CreateTagTemplateFieldRequest(
+            parent=parent,
+            tag_template_field_id=tag_template_field_id,
+            tag_template_field=tag_template_field,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_tag_template_field"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_tag_template_field(
+        self,
+        name,
+        tag_template_field,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a field in a tag template. This method cannot be used to update the
+        field type.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.field_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]', '[FIELD]')
+            >>>
+            >>> # TODO: Initialize `tag_template_field`:
+            >>> tag_template_field = {}
+            >>>
+            >>> response = client.update_tag_template_field(name, tag_template_field)
+
+        Args:
+            name (str): Required. The name of the tag template field. For example,
+                "projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}/fields/{tag\_template\_field\_id}".
+            tag_template_field (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplateField]): Required. The template to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplateField`
+            update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): Optional. The field mask specifies the parts of the template to
+                overwrite. Allowed fields:
+
+                -  display\_name
+                -  type.enum\_type
+
+                If update\_mask is omitted, 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplateField` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_tag_template_field" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_tag_template_field"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_tag_template_field,
+                default_retry=self._method_configs["UpdateTagTemplateField"].retry,
+                default_timeout=self._method_configs["UpdateTagTemplateField"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.UpdateTagTemplateFieldRequest(
+            name=name, tag_template_field=tag_template_field, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_tag_template_field"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rename_tag_template_field(
+        self,
+        name,
+        new_tag_template_field_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Renames a field in a tag template.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.field_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]', '[FIELD]')
+            >>>
+            >>> # TODO: Initialize `new_tag_template_field_id`:
+            >>> new_tag_template_field_id = ''
+            >>>
+            >>> response = client.rename_tag_template_field(name, new_tag_template_field_id)
+
+        Args:
+            name (str): Required. The name of the tag template. For example,
+                "projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}/fields/{tag\_template\_field\_id}".
+            new_tag_template_field_id (str): Required. The new ID of this tag template field. For example,
+                "my\_new\_field".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TagTemplateField` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rename_tag_template_field" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rename_tag_template_field"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rename_tag_template_field,
+                default_retry=self._method_configs["RenameTagTemplateField"].retry,
+                default_timeout=self._method_configs["RenameTagTemplateField"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.RenameTagTemplateFieldRequest(
+            name=name, new_tag_template_field_id=new_tag_template_field_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["rename_tag_template_field"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_tag_template_field(
+        self,
+        name,
+        force,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a field in a tag template and all uses of that field.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.field_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]', '[FIELD]')
+            >>>
+            >>> # TODO: Initialize `force`:
+            >>> force = False
+            >>>
+            >>> client.delete_tag_template_field(name, force)
+
+        Args:
+            name (str): 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}".
+            force (bool): Required. Currently, this field must always be set to <code>true</code>.
+                This confirms the deletion of this field from any tags using this field.
+                <code>force = false</code> will be supported in the future.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_tag_template_field" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_tag_template_field"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_tag_template_field,
+                default_retry=self._method_configs["DeleteTagTemplateField"].retry,
+                default_timeout=self._method_configs["DeleteTagTemplateField"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.DeleteTagTemplateFieldRequest(name=name, force=force)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_tag_template_field"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_tag(
+        self,
+        parent,
+        tag,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a tag on an ``Entry``.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> parent = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]')
+            >>>
+            >>> # TODO: Initialize `tag`:
+            >>> tag = {}
+            >>>
+            >>> response = client.create_tag(parent, tag)
+
+        Args:
+            parent (str): 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.
+            tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Tag]): Required. The tag to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.Tag`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Tag` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_tag" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_tag"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_tag,
+                default_retry=self._method_configs["CreateTag"].retry,
+                default_timeout=self._method_configs["CreateTag"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.CreateTagRequest(parent=parent, tag=tag)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_tag"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_tag(
+        self,
+        tag,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing tag.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> # TODO: Initialize `tag`:
+            >>> tag = {}
+            >>>
+            >>> response = client.update_tag(tag)
+
+        Args:
+            tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Tag]): Required. The updated tag.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.Tag`
+            update_mask (Union[dict, ~google.cloud.datacatalog_v1beta1.types.FieldMask]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Tag` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_tag" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_tag"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_tag,
+                default_retry=self._method_configs["UpdateTag"].retry,
+                default_timeout=self._method_configs["UpdateTag"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.UpdateTagRequest(tag=tag, update_mask=update_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("tag.name", tag.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_tag"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_tag(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a tag.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> name = client.tag_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]', '[TAG]')
+            >>>
+            >>> client.delete_tag(name)
+
+        Args:
+            name (str): 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}".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_tag" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_tag"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_tag,
+                default_retry=self._method_configs["DeleteTag"].retry,
+                default_timeout=self._method_configs["DeleteTag"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.DeleteTagRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_tag"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_tags(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the tags on an ``Entry``.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> parent = client.entry_path('[PROJECT]', '[LOCATION]', '[ENTRY_GROUP]', '[ENTRY]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tags(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tags(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The name of the Data Catalog resource to list the tags of. The
+                resource could be an ``Entry``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datacatalog_v1beta1.types.Tag` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tags" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tags"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tags,
+                default_retry=self._method_configs["ListTags"].retry,
+                default_timeout=self._method_configs["ListTags"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datacatalog_pb2.ListTagsRequest(parent=parent, page_size=page_size)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tags"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tags",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Callers must have following Google IAM permission
+        ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag
+        templates.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> resource = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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. 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.
+
+        Callers must have following Google IAM permission
+        ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag
+        templates.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> resource = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datacatalog_v1beta1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        A caller is not required to have Google IAM permission to make this
+        request.
+
+        Example:
+            >>> from google.cloud import datacatalog_v1beta1
+            >>>
+            >>> client = datacatalog_v1beta1.DataCatalogClient()
+            >>>
+            >>> resource = client.tag_template_path('[PROJECT]', '[LOCATION]', '[TAG_TEMPLATE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datacatalog_v1beta1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client_config.py b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client_config.py
new file mode 100644
index 000000000000..a1bda46164f0
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client_config.py
@@ -0,0 +1,118 @@
+config = {
+    "interfaces": {
+        "google.cloud.datacatalog.v1beta1.DataCatalog": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "SearchCatalog": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateEntry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetEntry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "LookupEntry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTagTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTagTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTagTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTagTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTagTemplateField": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTagTemplateField": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "RenameTagTemplateField": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTagTemplateField": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTag": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTag": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTag": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTags": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/gapic/enums.py b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..954b282e5021
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/enums.py
@@ -0,0 +1,86 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class EntryType(enum.IntEnum):
+    """
+    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.
+
+    Attributes:
+      ENTRY_TYPE_UNSPECIFIED (int): Default unknown type
+      TABLE (int): The type of entry that has a GoogleSQL schema, including logical views.
+      DATA_STREAM (int): An entry type which is used for streaming entries. Example - Pub/Sub.
+    """
+
+    ENTRY_TYPE_UNSPECIFIED = 0
+    TABLE = 2
+    DATA_STREAM = 3
+
+
+class SearchResultType(enum.IntEnum):
+    """
+    The different types of resources that can be returned in search.
+
+    Attributes:
+      SEARCH_RESULT_TYPE_UNSPECIFIED (int): Default unknown type.
+      ENTRY (int): An ``Entry``.
+      TAG_TEMPLATE (int): A ``TagTemplate``.
+      ENTRY_GROUP (int): An ``EntryGroup``.
+    """
+
+    SEARCH_RESULT_TYPE_UNSPECIFIED = 0
+    ENTRY = 1
+    TAG_TEMPLATE = 2
+    ENTRY_GROUP = 3
+
+
+class TableSourceType(enum.IntEnum):
+    """
+    Table source type.
+
+    Attributes:
+      TABLE_SOURCE_TYPE_UNSPECIFIED (int): Default unknown type.
+      BIGQUERY_VIEW (int): Table view.
+      BIGQUERY_TABLE (int): BigQuery native table.
+    """
+
+    TABLE_SOURCE_TYPE_UNSPECIFIED = 0
+    BIGQUERY_VIEW = 2
+    BIGQUERY_TABLE = 5
+
+
+class FieldType(object):
+    class PrimitiveType(enum.IntEnum):
+        """
+        Attributes:
+          PRIMITIVE_TYPE_UNSPECIFIED (int): This is the default invalid value for a type.
+          DOUBLE (int): A double precision number.
+          STRING (int): An UTF-8 string.
+          BOOL (int): A boolean value.
+          TIMESTAMP (int): A timestamp.
+        """
+
+        PRIMITIVE_TYPE_UNSPECIFIED = 0
+        DOUBLE = 1
+        STRING = 2
+        BOOL = 3
+        TIMESTAMP = 4
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/gapic/transports/__init__.py b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py
new file mode 100644
index 000000000000..5f1e9639e7a6
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py
@@ -0,0 +1,407 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.datacatalog_v1beta1.proto import datacatalog_pb2_grpc
+
+
+class DataCatalogGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.datacatalog.v1beta1 DataCatalog API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="datacatalog.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "data_catalog_stub": datacatalog_pb2_grpc.DataCatalogStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="datacatalog.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def search_catalog(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.search_catalog`.
+
+        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 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.
+
+        See `Data Catalog Search
+        Syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__
+        for more information.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].SearchCatalog
+
+    @property
+    def update_entry(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.update_entry`.
+
+        Updates an existing entry.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].UpdateEntry
+
+    @property
+    def get_entry(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.get_entry`.
+
+        Gets an entry.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].GetEntry
+
+    @property
+    def lookup_entry(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.lookup_entry`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].LookupEntry
+
+    @property
+    def create_tag_template(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template`.
+
+        Creates a tag template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].CreateTagTemplate
+
+    @property
+    def get_tag_template(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.get_tag_template`.
+
+        Gets a tag template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].GetTagTemplate
+
+    @property
+    def update_tag_template(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].UpdateTagTemplate
+
+    @property
+    def delete_tag_template(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template`.
+
+        Deletes a tag template and all tags using the template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].DeleteTagTemplate
+
+    @property
+    def create_tag_template_field(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.create_tag_template_field`.
+
+        Creates a field in a tag template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].CreateTagTemplateField
+
+    @property
+    def update_tag_template_field(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.update_tag_template_field`.
+
+        Updates a field in a tag template. This method cannot be used to update the
+        field type.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].UpdateTagTemplateField
+
+    @property
+    def rename_tag_template_field(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.rename_tag_template_field`.
+
+        Renames a field in a tag template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].RenameTagTemplateField
+
+    @property
+    def delete_tag_template_field(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag_template_field`.
+
+        Deletes a field in a tag template and all uses of that field.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].DeleteTagTemplateField
+
+    @property
+    def create_tag(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.create_tag`.
+
+        Creates a tag on an ``Entry``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].CreateTag
+
+    @property
+    def update_tag(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.update_tag`.
+
+        Updates an existing tag.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].UpdateTag
+
+    @property
+    def delete_tag(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.delete_tag`.
+
+        Deletes a tag.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].DeleteTag
+
+    @property
+    def list_tags(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.list_tags`.
+
+        Lists the tags on an ``Entry``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].ListTags
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.set_iam_policy`.
+
+        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.
+
+        Callers must have following Google IAM permission
+        ``datacatalog.tagTemplates.setIamPolicy`` to set policies on tag
+        templates.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.get_iam_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. 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.
+
+        Callers must have following Google IAM permission
+        ``datacatalog.tagTemplates.getIamPolicy`` to get policies on tag
+        templates.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`DataCatalogClient.test_iam_permissions`.
+
+        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.
+
+        A caller is not required to have Google IAM permission to make this
+        request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_catalog_stub"].TestIamPermissions
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/__init__.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog.proto b/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog.proto
new file mode 100644
index 000000000000..e89e7ad62671
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog.proto
@@ -0,0 +1,634 @@
+// 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.datacatalog.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datacatalog/v1beta1/schema.proto";
+import "google/cloud/datacatalog/v1beta1/search.proto";
+import "google/cloud/datacatalog/v1beta1/table_spec.proto";
+import "google/cloud/datacatalog/v1beta1/tags.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";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datacatalog";
+
+// 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 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.
+  //
+  // See [Data Catalog Search
+  // Syntax](/data-catalog/docs/how-to/search-reference) for more information.
+  rpc SearchCatalog(SearchCatalogRequest) returns (SearchCatalogResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/catalog:search"
+      body: "*"
+    };
+  }
+
+  // Updates an existing entry.
+  rpc UpdateEntry(UpdateEntryRequest) returns (Entry) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}"
+      body: "entry"
+    };
+  }
+
+  // Gets an entry.
+  rpc GetEntry(GetEntryRequest) returns (Entry) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}"
+    };
+  }
+
+  // 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: "/v1beta1/entries:lookup"
+    };
+  }
+
+  // Creates a tag template.
+  rpc CreateTagTemplate(CreateTagTemplateRequest) returns (TagTemplate) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/tagTemplates"
+      body: "tag_template"
+    };
+  }
+
+  // Gets a tag template.
+  rpc GetTagTemplate(GetTagTemplateRequest) returns (TagTemplate) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*}"
+    };
+  }
+
+  // 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.
+  rpc UpdateTagTemplate(UpdateTagTemplateRequest) returns (TagTemplate) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}"
+      body: "tag_template"
+    };
+  }
+
+  // Deletes a tag template and all tags using the template.
+  rpc DeleteTagTemplate(DeleteTagTemplateRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*}"
+    };
+  }
+
+  // Creates a field in a tag template.
+  rpc CreateTagTemplateField(CreateTagTemplateFieldRequest) returns (TagTemplateField) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields"
+      body: "tag_template_field"
+    };
+  }
+
+  // Updates a field in a tag template. This method cannot be used to update the
+  // field type.
+  rpc UpdateTagTemplateField(UpdateTagTemplateFieldRequest) returns (TagTemplateField) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}"
+      body: "tag_template_field"
+    };
+  }
+
+  // Renames a field in a tag template.
+  rpc RenameTagTemplateField(RenameTagTemplateFieldRequest) returns (TagTemplateField) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename"
+      body: "*"
+    };
+  }
+
+  // Deletes a field in a tag template and all uses of that field.
+  rpc DeleteTagTemplateField(DeleteTagTemplateFieldRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}"
+    };
+  }
+
+  // Creates a tag on an [Entry][google.cloud.datacatalog.v1beta1.Entry].
+  rpc CreateTag(CreateTagRequest) returns (Tag) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags"
+      body: "tag"
+    };
+  }
+
+  // Updates an existing tag.
+  rpc UpdateTag(UpdateTagRequest) returns (Tag) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}"
+      body: "tag"
+    };
+  }
+
+  // Deletes a tag.
+  rpc DeleteTag(DeleteTagRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}"
+    };
+  }
+
+  // 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"
+    };
+  }
+
+  // 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.
+  //
+  // Callers must have following Google IAM permission
+  // `datacatalog.tagTemplates.setIamPolicy` to set policies on tag templates.
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // 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.
+  // 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.
+  //
+  // Callers must have following Google IAM permission
+  // `datacatalog.tagTemplates.getIamPolicy` to get policies on tag templates.
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // 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.
+  //
+  // 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: "/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// Request message for
+// [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog].
+message SearchCatalogRequest {
+  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
+    repeated string include_org_ids = 2;
+
+    // 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;
+  }
+
+  // Required. The scope of this search request.
+  Scope scope = 6;
+
+  // 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](/data-catalog/docs/how-to/search-reference) for more information.
+  string query = 1;
+
+  // 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];
+  // 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;
+
+  // Specifies the ordering of results, currently supported case-sensitive
+  // choices are:
+  // <ul>
+  //   <li> relevance </li>
+  //   <li> last_access_timestamp [asc|desc], defaults to descending if not
+  //   specified, </li>
+  //   <li> last_modified_timestamp [asc|desc], defaults to descending if not
+  //   specified. </li>
+  // </ul>
+  string order_by = 5;
+}
+
+// Response message for
+// [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog].
+message SearchCatalogResponse {
+  // Search results in descending order of relevance.
+  repeated SearchCatalogResult results = 1;
+
+  // The token that can be used to retrieve the next page of results.
+  string next_page_token = 3;
+}
+
+// Request message for
+// [UpdateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntry].
+message UpdateEntryRequest {
+  // Required. The updated Entry.
+  Entry entry = 1;
+
+  // Optional. The fields to update on the entry.  If absent or empty, all
+  // modifiable fields are updated.
+  //
+  // Modifiable fields in synced entries:
+  //
+  // 1. schema (Pub/Sub topics only)
+  //
+  // Modifiable fields in native entries:
+  //
+  // 1. display_name
+  // 2. description
+  // 3. schema
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// 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;
+}
+
+// Request message for
+// [LookupEntry][google.cloud.datacatalog.v1beta1.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:
+    // <ul>
+    //   <li>cloud_pubsub.project_id.topic_id</li>
+    //   <li>pubsub.project_id.`topic.id.with.dots`</li>
+    //   <li>bigquery.project_id.dataset_id.table_id</li>
+    //   <li>datacatalog.project_id.location_id.entry_group_id.entry_id</li>
+    // </ul>
+    // *_ids 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.
+//
+// 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}".
+  // Note that this Entry and its child resources may not actually be stored in
+  // the location in this name.
+  string name = 1;
+
+  // 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
+  //
+  // Data Catalog supports resources from select Google Cloud Platform systems.
+  // `linked_resource` is the full name of the Google Cloud Platform resource.
+  // For example, the `linked_resource` for a table resource from BigQuery is:
+  //
+  // "//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId".
+  string linked_resource = 9;
+
+  // Required. Type of entry.
+  EntryType type = 2;
+
+  // Optional. Type specification information.
+  oneof type_spec {
+    // 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;
+  }
+
+  // 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.
+  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.
+  string description = 4;
+
+  // Optional. 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;
+}
+
+// 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 id of the tag template to create.
+  string tag_template_id = 3;
+
+  // Required. The tag template to create.
+  TagTemplate tag_template = 2;
+}
+
+// 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;
+}
+
+// Request message for
+// [UpdateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplate].
+message UpdateTagTemplateRequest {
+  // Required. The template to update.
+  TagTemplate tag_template = 1;
+
+  // Optional. The field mask specifies the parts of the template to overwrite.
+  //
+  // Allowed fields:
+  //
+  //   * display_name
+  //
+  // If update_mask is omitted, 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 <code>true</code>.
+  // This confirms the deletion of any possible tags using this template.
+  // <code>force = false</code> will be supported in the future.
+  bool force = 2;
+}
+
+// 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}").
+  // Note that this Tag and its child resources may not actually be stored in
+  // the location in this name.
+  string parent = 1;
+
+  // Required. The tag to create.
+  Tag tag = 2;
+}
+
+// Request message for
+// [UpdateTag][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTag].
+message UpdateTagRequest {
+  // Required. The updated tag.
+  Tag tag = 1;
+
+  // 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`.
+  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;
+}
+
+// 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.
+  // 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;
+
+  // Required. The tag template field to create.
+  TagTemplateField tag_template_field = 3;
+}
+
+// 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 template to update.
+  TagTemplateField tag_template_field = 2;
+
+  // Optional. The field mask specifies the parts of the template to overwrite.
+  // Allowed fields:
+  //
+  //   * display_name
+  //   * type.enum_type
+  //
+  // If update_mask is omitted, 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;
+}
+
+// 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;
+}
+
+// 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 <code>true</code>.
+  // This confirms the deletion of this field from any tags using this field.
+  // <code>force = false</code> will be supported in the future.
+  bool force = 2;
+}
+
+// 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.
+  int32 page_size = 2;
+
+  // Optional. 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.v1beta1.DataCatalog.ListTags].
+message ListTagsResponse {
+  // [Tag][google.cloud.datacatalog.v1beta1.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;
+}
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py
new file mode 100644
index 000000000000..10641f51e1ab
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py
@@ -0,0 +1,2404 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog_v1beta1/proto/datacatalog.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datacatalog_v1beta1.proto import (
+    schema_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_schema__pb2,
+)
+from google.cloud.datacatalog_v1beta1.proto import (
+    search_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_search__pb2,
+)
+from google.cloud.datacatalog_v1beta1.proto import (
+    table_spec_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_table__spec__pb2,
+)
+from google.cloud.datacatalog_v1beta1.proto import (
+    tags_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2,
+)
+from google.cloud.datacatalog_v1beta1.proto import (
+    timestamps_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_timestamps__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datacatalog_v1beta1/proto/datacatalog.proto",
+    package="google.cloud.datacatalog.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.datacatalogP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/datacatalog_v1beta1/proto/datacatalog.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/schema.proto\x1a\x33google/cloud/datacatalog_v1beta1/proto/search.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/table_spec.proto\x1a\x31google/cloud/datacatalog_v1beta1/proto/tags.proto\x1a\x37google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/api/client.proto"\x8f\x02\n\x14SearchCatalogRequest\x12K\n\x05scope\x18\x06 \x01(\x0b\x32<.google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope\x12\r\n\x05query\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t\x1a\x62\n\x05Scope\x12\x17\n\x0finclude_org_ids\x18\x02 \x03(\t\x12\x1b\n\x13include_project_ids\x18\x03 \x03(\t\x12#\n\x1binclude_gcp_public_datasets\x18\x07 \x01(\x08"x\n\x15SearchCatalogResponse\x12\x46\n\x07results\x18\x01 \x03(\x0b\x32\x35.google.cloud.datacatalog.v1beta1.SearchCatalogResult\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"}\n\x12UpdateEntryRequest\x12\x36\n\x05\x65ntry\x18\x01 \x01(\x0b\x32\'.google.cloud.datacatalog.v1beta1.Entry\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x1f\n\x0fGetEntryRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"V\n\x12LookupEntryRequest\x12\x19\n\x0flinked_resource\x18\x01 \x01(\tH\x00\x12\x16\n\x0csql_resource\x18\x03 \x01(\tH\x00\x42\r\n\x0btarget_name"\xe6\x03\n\x05\x45ntry\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x17\n\x0flinked_resource\x18\t \x01(\t\x12\x39\n\x04type\x18\x02 \x01(\x0e\x32+.google.cloud.datacatalog.v1beta1.EntryType\x12R\n\x13\x62igquery_table_spec\x18\x0c \x01(\x0b\x32\x33.google.cloud.datacatalog.v1beta1.BigQueryTableSpecH\x00\x12_\n\x1a\x62igquery_date_sharded_spec\x18\x0f \x01(\x0b\x32\x39.google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpecH\x00\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x38\n\x06schema\x18\x05 \x01(\x0b\x32(.google.cloud.datacatalog.v1beta1.Schema\x12T\n\x18source_system_timestamps\x18\x07 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.SystemTimestampsB\x0b\n\ttype_spec"\x88\x01\n\x18\x43reateTagTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x17\n\x0ftag_template_id\x18\x03 \x01(\t\x12\x43\n\x0ctag_template\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1beta1.TagTemplate"%\n\x15GetTagTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x90\x01\n\x18UpdateTagTemplateRequest\x12\x43\n\x0ctag_template\x18\x01 \x01(\x0b\x32-.google.cloud.datacatalog.v1beta1.TagTemplate\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"7\n\x18\x44\x65leteTagTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05\x66orce\x18\x02 \x01(\x08"V\n\x10\x43reateTagRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x32\n\x03tag\x18\x02 \x01(\x0b\x32%.google.cloud.datacatalog.v1beta1.Tag"w\n\x10UpdateTagRequest\x12\x32\n\x03tag\x18\x01 \x01(\x0b\x32%.google.cloud.datacatalog.v1beta1.Tag\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask" \n\x10\x44\x65leteTagRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x9e\x01\n\x1d\x43reateTagTemplateFieldRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x1d\n\x15tag_template_field_id\x18\x02 \x01(\t\x12N\n\x12tag_template_field\x18\x03 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"\xae\x01\n\x1dUpdateTagTemplateFieldRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x12tag_template_field\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateField\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"P\n\x1dRenameTagTemplateFieldRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12!\n\x19new_tag_template_field_id\x18\x02 \x01(\t"<\n\x1d\x44\x65leteTagTemplateFieldRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05\x66orce\x18\x02 \x01(\x08"H\n\x0fListTagsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"`\n\x10ListTagsResponse\x12\x33\n\x04tags\x18\x01 \x03(\x0b\x32%.google.cloud.datacatalog.v1beta1.Tag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t*C\n\tEntryType\x12\x1a\n\x16\x45NTRY_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05TABLE\x10\x02\x12\x0f\n\x0b\x44\x41TA_STREAM\x10\x03\x32\xf8\x1c\n\x0b\x44\x61taCatalog\x12\xa4\x01\n\rSearchCatalog\x12\x36.google.cloud.datacatalog.v1beta1.SearchCatalogRequest\x1a\x37.google.cloud.datacatalog.v1beta1.SearchCatalogResponse""\x82\xd3\xe4\x93\x02\x1c"\x17/v1beta1/catalog:search:\x01*\x12\xc1\x01\n\x0bUpdateEntry\x12\x34.google.cloud.datacatalog.v1beta1.UpdateEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"S\x82\xd3\xe4\x93\x02M2D/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\x05\x65ntry\x12\xae\x01\n\x08GetEntry\x12\x31.google.cloud.datacatalog.v1beta1.GetEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"F\x82\xd3\xe4\x93\x02@\x12>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}\x12\x8d\x01\n\x0bLookupEntry\x12\x34.google.cloud.datacatalog.v1beta1.LookupEntryRequest\x1a\'.google.cloud.datacatalog.v1beta1.Entry"\x1f\x82\xd3\xe4\x93\x02\x19\x12\x17/v1beta1/entries:lookup\x12\xcb\x01\n\x11\x43reateTagTemplate\x12:.google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"K\x82\xd3\xe4\x93\x02\x45"5/v1beta1/{parent=projects/*/locations/*}/tagTemplates:\x0ctag_template\x12\xb7\x01\n\x0eGetTagTemplate\x12\x37.google.cloud.datacatalog.v1beta1.GetTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"=\x82\xd3\xe4\x93\x02\x37\x12\x35/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\x12\xd8\x01\n\x11UpdateTagTemplate\x12:.google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest\x1a-.google.cloud.datacatalog.v1beta1.TagTemplate"X\x82\xd3\xe4\x93\x02R2B/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\x0ctag_template\x12\xa6\x01\n\x11\x44\x65leteTagTemplate\x12:.google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest\x1a\x16.google.protobuf.Empty"=\x82\xd3\xe4\x93\x02\x37*5/v1beta1/{name=projects/*/locations/*/tagTemplates/*}\x12\xe9\x01\n\x16\x43reateTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"Z\x82\xd3\xe4\x93\x02T">/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\x12tag_template_field\x12\xe9\x01\n\x16UpdateTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"Z\x82\xd3\xe4\x93\x02T2>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\x12tag_template_field\x12\xdf\x01\n\x16RenameTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest\x1a\x32.google.cloud.datacatalog.v1beta1.TagTemplateField"P\x82\xd3\xe4\x93\x02J"E/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\x01*\x12\xb9\x01\n\x16\x44\x65leteTagTemplateField\x12?.google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02@*>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}\x12\xba\x01\n\tCreateTag\x12\x32.google.cloud.datacatalog.v1beta1.CreateTagRequest\x1a%.google.cloud.datacatalog.v1beta1.Tag"R\x82\xd3\xe4\x93\x02L"E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\x03tag\x12\xbe\x01\n\tUpdateTag\x12\x32.google.cloud.datacatalog.v1beta1.UpdateTagRequest\x1a%.google.cloud.datacatalog.v1beta1.Tag"V\x82\xd3\xe4\x93\x02P2I/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\x03tag\x12\xa6\x01\n\tDeleteTag\x12\x32.google.cloud.datacatalog.v1beta1.DeleteTagRequest\x1a\x16.google.protobuf.Empty"M\x82\xd3\xe4\x93\x02G*E/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}\x12\xc0\x01\n\x08ListTags\x12\x31.google.cloud.datacatalog.v1beta1.ListTagsRequest\x1a\x32.google.cloud.datacatalog.v1beta1.ListTagsResponse"M\x82\xd3\xe4\x93\x02G\x12\x45/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags\x12\x9c\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"Q\x82\xd3\xe4\x93\x02K"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\x01*\x12\x9c\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"Q\x82\xd3\xe4\x93\x02K"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\x01*\x12\xc2\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"W\x82\xd3\xe4\x93\x02Q"L/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\x01*\x1aN\xca\x41\x1a\x64\x61tacatalog.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBp\n\x1c\x63om.google.cloud.datacatalogP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_schema__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_search__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_table__spec__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_timestamps__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+_ENTRYTYPE = _descriptor.EnumDescriptor(
+    name="EntryType",
+    full_name="google.cloud.datacatalog.v1beta1.EntryType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ENTRY_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=1, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATA_STREAM", index=2, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2955,
+    serialized_end=3022,
+)
+_sym_db.RegisterEnumDescriptor(_ENTRYTYPE)
+
+EntryType = enum_type_wrapper.EnumTypeWrapper(_ENTRYTYPE)
+ENTRY_TYPE_UNSPECIFIED = 0
+TABLE = 2
+DATA_STREAM = 3
+
+
+_SEARCHCATALOGREQUEST_SCOPE = _descriptor.Descriptor(
+    name="Scope",
+    full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="include_org_ids",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope.include_org_ids",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_project_ids",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope.include_project_ids",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_gcp_public_datasets",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope.include_gcp_public_datasets",
+            index=2,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=717,
+    serialized_end=815,
+)
+
+_SEARCHCATALOGREQUEST = _descriptor.Descriptor(
+    name="SearchCatalogRequest",
+    full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.scope",
+            index=0,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.query",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.page_size",
+            index=2,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.page_token",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogRequest.order_by",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SEARCHCATALOGREQUEST_SCOPE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=544,
+    serialized_end=815,
+)
+
+
+_SEARCHCATALOGRESPONSE = _descriptor.Descriptor(
+    name="SearchCatalogResponse",
+    full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResponse.results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResponse.next_page_token",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=817,
+    serialized_end=937,
+)
+
+
+_UPDATEENTRYREQUEST = _descriptor.Descriptor(
+    name="UpdateEntryRequest",
+    full_name="google.cloud.datacatalog.v1beta1.UpdateEntryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entry",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateEntryRequest.entry",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateEntryRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=939,
+    serialized_end=1064,
+)
+
+
+_GETENTRYREQUEST = _descriptor.Descriptor(
+    name="GetEntryRequest",
+    full_name="google.cloud.datacatalog.v1beta1.GetEntryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.GetEntryRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1066,
+    serialized_end=1097,
+)
+
+
+_LOOKUPENTRYREQUEST = _descriptor.Descriptor(
+    name="LookupEntryRequest",
+    full_name="google.cloud.datacatalog.v1beta1.LookupEntryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="linked_resource",
+            full_name="google.cloud.datacatalog.v1beta1.LookupEntryRequest.linked_resource",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sql_resource",
+            full_name="google.cloud.datacatalog.v1beta1.LookupEntryRequest.sql_resource",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target_name",
+            full_name="google.cloud.datacatalog.v1beta1.LookupEntryRequest.target_name",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1099,
+    serialized_end=1185,
+)
+
+
+_ENTRY = _descriptor.Descriptor(
+    name="Entry",
+    full_name="google.cloud.datacatalog.v1beta1.Entry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="linked_resource",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.linked_resource",
+            index=1,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.type",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_table_spec",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.bigquery_table_spec",
+            index=3,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_date_sharded_spec",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.bigquery_date_sharded_spec",
+            index=4,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.display_name",
+            index=5,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.description",
+            index=6,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schema",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.schema",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_system_timestamps",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.source_system_timestamps",
+            index=8,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type_spec",
+            full_name="google.cloud.datacatalog.v1beta1.Entry.type_spec",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1188,
+    serialized_end=1674,
+)
+
+
+_CREATETAGTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="CreateTagTemplateRequest",
+    full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag_template_id",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest.tag_template_id",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag_template",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest.tag_template",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1677,
+    serialized_end=1813,
+)
+
+
+_GETTAGTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="GetTagTemplateRequest",
+    full_name="google.cloud.datacatalog.v1beta1.GetTagTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.GetTagTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1815,
+    serialized_end=1852,
+)
+
+
+_UPDATETAGTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="UpdateTagTemplateRequest",
+    full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tag_template",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest.tag_template",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1855,
+    serialized_end=1999,
+)
+
+
+_DELETETAGTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="DeleteTagTemplateRequest",
+    full_name="google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="force",
+            full_name="google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest.force",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2001,
+    serialized_end=2056,
+)
+
+
+_CREATETAGREQUEST = _descriptor.Descriptor(
+    name="CreateTagRequest",
+    full_name="google.cloud.datacatalog.v1beta1.CreateTagRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagRequest.tag",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2058,
+    serialized_end=2144,
+)
+
+
+_UPDATETAGREQUEST = _descriptor.Descriptor(
+    name="UpdateTagRequest",
+    full_name="google.cloud.datacatalog.v1beta1.UpdateTagRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tag",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagRequest.tag",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2146,
+    serialized_end=2265,
+)
+
+
+_DELETETAGREQUEST = _descriptor.Descriptor(
+    name="DeleteTagRequest",
+    full_name="google.cloud.datacatalog.v1beta1.DeleteTagRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.DeleteTagRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2267,
+    serialized_end=2299,
+)
+
+
+_CREATETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor(
+    name="CreateTagTemplateFieldRequest",
+    full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag_template_field_id",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest.tag_template_field_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag_template_field",
+            full_name="google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest.tag_template_field",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2302,
+    serialized_end=2460,
+)
+
+
+_UPDATETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor(
+    name="UpdateTagTemplateFieldRequest",
+    full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag_template_field",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest.tag_template_field",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2463,
+    serialized_end=2637,
+)
+
+
+_RENAMETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor(
+    name="RenameTagTemplateFieldRequest",
+    full_name="google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_tag_template_field_id",
+            full_name="google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest.new_tag_template_field_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2639,
+    serialized_end=2719,
+)
+
+
+_DELETETAGTEMPLATEFIELDREQUEST = _descriptor.Descriptor(
+    name="DeleteTagTemplateFieldRequest",
+    full_name="google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="force",
+            full_name="google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest.force",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2721,
+    serialized_end=2781,
+)
+
+
+_LISTTAGSREQUEST = _descriptor.Descriptor(
+    name="ListTagsRequest",
+    full_name="google.cloud.datacatalog.v1beta1.ListTagsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datacatalog.v1beta1.ListTagsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datacatalog.v1beta1.ListTagsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datacatalog.v1beta1.ListTagsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2783,
+    serialized_end=2855,
+)
+
+
+_LISTTAGSRESPONSE = _descriptor.Descriptor(
+    name="ListTagsResponse",
+    full_name="google.cloud.datacatalog.v1beta1.ListTagsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.cloud.datacatalog.v1beta1.ListTagsResponse.tags",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datacatalog.v1beta1.ListTagsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2857,
+    serialized_end=2953,
+)
+
+_SEARCHCATALOGREQUEST_SCOPE.containing_type = _SEARCHCATALOGREQUEST
+_SEARCHCATALOGREQUEST.fields_by_name["scope"].message_type = _SEARCHCATALOGREQUEST_SCOPE
+_SEARCHCATALOGRESPONSE.fields_by_name[
+    "results"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_search__pb2._SEARCHCATALOGRESULT
+)
+_UPDATEENTRYREQUEST.fields_by_name["entry"].message_type = _ENTRY
+_UPDATEENTRYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LOOKUPENTRYREQUEST.oneofs_by_name["target_name"].fields.append(
+    _LOOKUPENTRYREQUEST.fields_by_name["linked_resource"]
+)
+_LOOKUPENTRYREQUEST.fields_by_name[
+    "linked_resource"
+].containing_oneof = _LOOKUPENTRYREQUEST.oneofs_by_name["target_name"]
+_LOOKUPENTRYREQUEST.oneofs_by_name["target_name"].fields.append(
+    _LOOKUPENTRYREQUEST.fields_by_name["sql_resource"]
+)
+_LOOKUPENTRYREQUEST.fields_by_name[
+    "sql_resource"
+].containing_oneof = _LOOKUPENTRYREQUEST.oneofs_by_name["target_name"]
+_ENTRY.fields_by_name["type"].enum_type = _ENTRYTYPE
+_ENTRY.fields_by_name[
+    "bigquery_table_spec"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_table__spec__pb2._BIGQUERYTABLESPEC
+)
+_ENTRY.fields_by_name[
+    "bigquery_date_sharded_spec"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_table__spec__pb2._BIGQUERYDATESHARDEDSPEC
+)
+_ENTRY.fields_by_name[
+    "schema"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_schema__pb2._SCHEMA
+)
+_ENTRY.fields_by_name[
+    "source_system_timestamps"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_timestamps__pb2._SYSTEMTIMESTAMPS
+)
+_ENTRY.oneofs_by_name["type_spec"].fields.append(
+    _ENTRY.fields_by_name["bigquery_table_spec"]
+)
+_ENTRY.fields_by_name["bigquery_table_spec"].containing_oneof = _ENTRY.oneofs_by_name[
+    "type_spec"
+]
+_ENTRY.oneofs_by_name["type_spec"].fields.append(
+    _ENTRY.fields_by_name["bigquery_date_sharded_spec"]
+)
+_ENTRY.fields_by_name[
+    "bigquery_date_sharded_spec"
+].containing_oneof = _ENTRY.oneofs_by_name["type_spec"]
+_CREATETAGTEMPLATEREQUEST.fields_by_name[
+    "tag_template"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE
+)
+_UPDATETAGTEMPLATEREQUEST.fields_by_name[
+    "tag_template"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE
+)
+_UPDATETAGTEMPLATEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATETAGREQUEST.fields_by_name[
+    "tag"
+].message_type = google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG
+_UPDATETAGREQUEST.fields_by_name[
+    "tag"
+].message_type = google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG
+_UPDATETAGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATETAGTEMPLATEFIELDREQUEST.fields_by_name[
+    "tag_template_field"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD
+)
+_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name[
+    "tag_template_field"
+].message_type = (
+    google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD
+)
+_UPDATETAGTEMPLATEFIELDREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTAGSRESPONSE.fields_by_name[
+    "tags"
+].message_type = google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG
+DESCRIPTOR.message_types_by_name["SearchCatalogRequest"] = _SEARCHCATALOGREQUEST
+DESCRIPTOR.message_types_by_name["SearchCatalogResponse"] = _SEARCHCATALOGRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateEntryRequest"] = _UPDATEENTRYREQUEST
+DESCRIPTOR.message_types_by_name["GetEntryRequest"] = _GETENTRYREQUEST
+DESCRIPTOR.message_types_by_name["LookupEntryRequest"] = _LOOKUPENTRYREQUEST
+DESCRIPTOR.message_types_by_name["Entry"] = _ENTRY
+DESCRIPTOR.message_types_by_name["CreateTagTemplateRequest"] = _CREATETAGTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name["GetTagTemplateRequest"] = _GETTAGTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateTagTemplateRequest"] = _UPDATETAGTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTagTemplateRequest"] = _DELETETAGTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name["CreateTagRequest"] = _CREATETAGREQUEST
+DESCRIPTOR.message_types_by_name["UpdateTagRequest"] = _UPDATETAGREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTagRequest"] = _DELETETAGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateTagTemplateFieldRequest"
+] = _CREATETAGTEMPLATEFIELDREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateTagTemplateFieldRequest"
+] = _UPDATETAGTEMPLATEFIELDREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RenameTagTemplateFieldRequest"
+] = _RENAMETAGTEMPLATEFIELDREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteTagTemplateFieldRequest"
+] = _DELETETAGTEMPLATEFIELDREQUEST
+DESCRIPTOR.message_types_by_name["ListTagsRequest"] = _LISTTAGSREQUEST
+DESCRIPTOR.message_types_by_name["ListTagsResponse"] = _LISTTAGSRESPONSE
+DESCRIPTOR.enum_types_by_name["EntryType"] = _ENTRYTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SearchCatalogRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchCatalogRequest",
+    (_message.Message,),
+    dict(
+        Scope=_reflection.GeneratedProtocolMessageType(
+            "Scope",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHCATALOGREQUEST_SCOPE,
+                __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+                __doc__="""
+    Attributes:
+        include_org_ids:
+            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
+        include_project_ids:
+            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
+        include_gcp_public_datasets:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogRequest.Scope)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHCATALOGREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog].
+  
+  
+  Attributes:
+      scope:
+          Required. The scope of this search request.
+      query:
+          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 </data-catalog/docs/how-to/search-reference>`__ for
+          more information.
+      page_size:
+          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.
+      page_token:
+          Optional pagination token returned in an earlier [SearchCatalo
+          gResponse.next\_page\_token][google.cloud.datacatalog.v1beta1.
+          DataCatalog.SearchCatalogResponse.next\_page\_token];
+          indicates that this is a continuation of a prior [SearchCatalo
+          g][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.
+      order_by:
+          Specifies the ordering of results, currently supported case-
+          sensitive choices are:  .. raw:: html     <ul>  .. raw:: html
+          <li>  relevance  .. raw:: html     </li>  .. raw:: html
+          <li>  last\_access\_timestamp [asc\|desc], defaults to
+          descending if not specified,  .. raw:: html     </li>  ..
+          raw:: html     <li>  last\_modified\_timestamp [asc\|desc],
+          defaults to descending if not specified.  .. raw:: html
+          </li>  .. raw:: html     </ul>
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchCatalogRequest)
+_sym_db.RegisterMessage(SearchCatalogRequest.Scope)
+
+SearchCatalogResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchCatalogResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHCATALOGRESPONSE,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Response message for
+  [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog].
+  
+  
+  Attributes:
+      results:
+          Search results in descending order of relevance.
+      next_page_token:
+          The token that can be used to retrieve the next page of
+          results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchCatalogResponse)
+
+UpdateEntryRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateEntryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEENTRYREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [UpdateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntry].
+  
+  
+  Attributes:
+      entry:
+          Required. The updated Entry.
+      update_mask:
+          Optional. The fields to update on the entry. If absent or
+          empty, all modifiable fields are updated.  Modifiable fields
+          in synced entries:  1. schema (Pub/Sub topics only)
+          Modifiable fields in native entries:  1. display\_name 2.
+          description 3. schema
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateEntryRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateEntryRequest)
+
+GetEntryRequest = _reflection.GeneratedProtocolMessageType(
+    "GetEntryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETENTRYREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [GetEntry][google.cloud.datacatalog.v1beta1.DataCatalog.GetEntry].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the entry. For example, "projects/{proje
+          ct\_id}/locations/{location}/entryGroups/{entry\_group\_id}/en
+          tries/{entry\_id}".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetEntryRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetEntryRequest)
+
+LookupEntryRequest = _reflection.GeneratedProtocolMessageType(
+    "LookupEntryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOOKUPENTRYREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [LookupEntry][google.cloud.datacatalog.v1beta1.DataCatalog.LookupEntry].
+  
+  
+  Attributes:
+      target_name:
+          Required. Represents either the Google Cloud Platform resource
+          or SQL name for a Google Cloud Platform resource.
+      linked_resource:
+          The full name of the Google Cloud Platform resource the Data
+          Catalog entry represents. See: https://cloud.google.com/apis/d
+          esign/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"
+      sql_resource:
+          The SQL name of the entry. SQL names are case-sensitive.
+          Examples:  .. raw:: html     <ul>  .. raw:: html     <li>
+          cloud\_pubsub.project\_id.topic\_id  .. raw:: html     </li>
+          .. raw:: html     <li>  pubsub.project\_id.\
+          ``topic.id.with.dots``  .. raw:: html     </li>  .. raw:: html
+          <li>  bigquery.project\_id.dataset\_id.table\_id  .. raw::
+          html     </li>  .. raw:: html     <li>  datacatalog.project\_i
+          d.location\_id.entry\_group\_id.entry\_id  .. raw:: html
+          </li>  .. raw:: html     </ul>  \*\_ids shoud satisfy the
+          standard SQL rules for identifiers.
+          https://cloud.google.com/bigquery/docs/reference/standard-
+          sql/lexical
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.LookupEntryRequest)
+    ),
+)
+_sym_db.RegisterMessage(LookupEntryRequest)
+
+Entry = _reflection.GeneratedProtocolMessageType(
+    "Entry",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTRY,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""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.
+  
+  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].
+  
+  
+  Attributes:
+      name:
+          Required when used in [UpdateEntryRequest][google.cloud.dataca
+          talog.v1beta1.UpdateEntryRequest]. The Data Catalog resource
+          name of the entry in URL format. For example, "projects/{proje
+          ct\_id}/locations/{location}/entryGroups/{entry\_group\_id}/en
+          tries/{entry\_id}". Note that this Entry and its child
+          resources may not actually be stored in the location in this
+          name.
+      linked_resource:
+          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  Data Catalog supports resources
+          from select Google Cloud Platform systems. ``linked_resource``
+          is the full name of the Google Cloud Platform resource. For
+          example, the ``linked_resource`` for a table resource from
+          BigQuery is:  "//bigquery.googleapis.com/projects/projectId/da
+          tasets/datasetId/tables/tableId".
+      type:
+          Required. Type of entry.
+      type_spec:
+          Optional. Type specification information.
+      bigquery_table_spec:
+          Specification that applies to a BigQuery table. This is only
+          valid on entries of type TABLE.
+      bigquery_date_sharded_spec:
+          Specification for a group of BigQuery tables with name pattern
+          [prefix]YYYYMMDD. Context:
+          https://cloud.google.com/bigquery/docs/partitioned-
+          tables#partitioning\_versus\_sharding
+      display_name:
+          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.
+      description:
+          Optional. Entry description, which can consist of several
+          sentences or paragraphs that describe entry contents. Default
+          value is an empty string.
+      schema:
+          Optional. Schema of the entry. An entry might not have any
+          schema attached to it.
+      source_system_timestamps:
+          Output only. Timestamps about the underlying Google Cloud
+          Platform resource -- not about this Data Catalog Entry.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Entry)
+    ),
+)
+_sym_db.RegisterMessage(Entry)
+
+CreateTagTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTagTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETAGTEMPLATEREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [CreateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplate].
+  
+  
+  Attributes:
+      parent:
+          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.
+      tag_template_id:
+          Required. The id of the tag template to create.
+      tag_template:
+          Required. The tag template to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTagTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTagTemplateRequest)
+
+GetTagTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTagTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTAGTEMPLATEREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [GetTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.GetTagTemplate].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the tag template. For example, "projects
+          /{project\_id}/locations/{location}/tagTemplates/{tag\_templat
+          e\_id}".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.GetTagTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTagTemplateRequest)
+
+UpdateTagTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTagTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETAGTEMPLATEREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [UpdateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplate].
+  
+  
+  Attributes:
+      tag_template:
+          Required. The template to update.
+      update_mask:
+          Optional. The field mask specifies the parts of the template
+          to overwrite.  Allowed fields:  -  display\_name  If
+          update\_mask is omitted, all of the allowed fields above will
+          be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTagTemplateRequest)
+
+DeleteTagTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTagTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETAGTEMPLATEREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [DeleteTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplate].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the tag template to delete. For example,
+          "projects/{project\_id}/locations/{location}/tagTemplates/{tag
+          \_template\_id}".
+      force:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTagTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTagTemplateRequest)
+
+CreateTagRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTagRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETAGREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [CreateTag][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTag].
+  
+  
+  Attributes:
+      parent:
+          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/{e
+          ntry\_id}"). Note that this Tag and its child resources may
+          not actually be stored in the location in this name.
+      tag:
+          Required. The tag to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTagRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTagRequest)
+
+UpdateTagRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTagRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETAGREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [UpdateTag][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTag].
+  
+  
+  Attributes:
+      tag:
+          Required. The updated tag.
+      update_mask:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTagRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTagRequest)
+
+DeleteTagRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTagRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETAGREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [DeleteTag][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTag].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the tag to delete. For example, "project
+          s/{project\_id}/locations/{location}/entryGroups/{entry\_group
+          \_id}/entries/{entry\_id}/tags/{tag\_id}".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTagRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTagRequest)
+
+CreateTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTagTemplateFieldRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETAGTEMPLATEFIELDREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [CreateTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplateField].
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project this template is in.
+          Example: "projects/{project\_id}/locations/{location}/tagTempl
+          ates/{tag\_template\_id}". Note that this TagTemplateField may
+          not actually be stored in the location in this name.
+      tag_template_field_id:
+          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.
+      tag_template_field:
+          Required. The tag template field to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.CreateTagTemplateFieldRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTagTemplateFieldRequest)
+
+UpdateTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTagTemplateFieldRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETAGTEMPLATEFIELDREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [UpdateTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplateField].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the tag template field. For example, "pr
+          ojects/{project\_id}/locations/{location}/tagTemplates/{tag\_t
+          emplate\_id}/fields/{tag\_template\_field\_id}".
+      tag_template_field:
+          Required. The template to update.
+      update_mask:
+          Optional. The field mask specifies the parts of the template
+          to overwrite. Allowed fields:  -  display\_name -
+          type.enum\_type  If update\_mask is omitted, 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.UpdateTagTemplateFieldRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTagTemplateFieldRequest)
+
+RenameTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType(
+    "RenameTagTemplateFieldRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RENAMETAGTEMPLATEFIELDREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [RenameTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.RenameTagTemplateField].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the tag template. For example, "projects
+          /{project\_id}/locations/{location}/tagTemplates/{tag\_templat
+          e\_id}/fields/{tag\_template\_field\_id}".
+      new_tag_template_field_id:
+          Required. The new ID of this tag template field. For example,
+          "my\_new\_field".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.RenameTagTemplateFieldRequest)
+    ),
+)
+_sym_db.RegisterMessage(RenameTagTemplateFieldRequest)
+
+DeleteTagTemplateFieldRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTagTemplateFieldRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETAGTEMPLATEFIELDREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [DeleteTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplateField].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the tag template field to delete. For
+          example, "projects/{project\_id}/locations/{location}/tagTempl
+          ates/{tag\_template\_id}/fields/{tag\_template\_field\_id}".
+      force:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.DeleteTagTemplateFieldRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTagTemplateFieldRequest)
+
+ListTagsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTagsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTAGSREQUEST,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Request message for
+  [ListTags][google.cloud.datacatalog.v1beta1.DataCatalog.ListTags].
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the Data Catalog resource to list the
+          tags of. The resource could be an
+          [Entry][google.cloud.datacatalog.v1beta1.Entry].
+      page_size:
+          Optional. The maximum number of tags to return. Default is 10.
+          Max limit is 1000.
+      page_token:
+          Optional. Token that specifies which page is requested. If
+          empty, the first page is returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListTagsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTagsRequest)
+
+ListTagsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTagsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTAGSRESPONSE,
+        __module__="google.cloud.datacatalog_v1beta1.proto.datacatalog_pb2",
+        __doc__="""Response message for
+  [ListTags][google.cloud.datacatalog.v1beta1.DataCatalog.ListTags].
+  
+  
+  Attributes:
+      tags:
+          [Tag][google.cloud.datacatalog.v1beta1.Tag] details.
+      next_page_token:
+          Token to retrieve the next page of results. It is set to empty
+          if no items remain in results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ListTagsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTagsResponse)
+
+
+DESCRIPTOR._options = None
+
+_DATACATALOG = _descriptor.ServiceDescriptor(
+    name="DataCatalog",
+    full_name="google.cloud.datacatalog.v1beta1.DataCatalog",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\032datacatalog.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=3025,
+    serialized_end=6729,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="SearchCatalog",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog",
+            index=0,
+            containing_service=None,
+            input_type=_SEARCHCATALOGREQUEST,
+            output_type=_SEARCHCATALOGRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\034"\027/v1beta1/catalog:search:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateEntry",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntry",
+            index=1,
+            containing_service=None,
+            input_type=_UPDATEENTRYREQUEST,
+            output_type=_ENTRY,
+            serialized_options=_b(
+                "\202\323\344\223\002M2D/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}:\005entry"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetEntry",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.GetEntry",
+            index=2,
+            containing_service=None,
+            input_type=_GETENTRYREQUEST,
+            output_type=_ENTRY,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LookupEntry",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.LookupEntry",
+            index=3,
+            containing_service=None,
+            input_type=_LOOKUPENTRYREQUEST,
+            output_type=_ENTRY,
+            serialized_options=_b(
+                "\202\323\344\223\002\031\022\027/v1beta1/entries:lookup"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTagTemplate",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplate",
+            index=4,
+            containing_service=None,
+            input_type=_CREATETAGTEMPLATEREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE,
+            serialized_options=_b(
+                '\202\323\344\223\002E"5/v1beta1/{parent=projects/*/locations/*}/tagTemplates:\014tag_template'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTagTemplate",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.GetTagTemplate",
+            index=5,
+            containing_service=None,
+            input_type=_GETTAGTEMPLATEREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\0027\0225/v1beta1/{name=projects/*/locations/*/tagTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTagTemplate",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplate",
+            index=6,
+            containing_service=None,
+            input_type=_UPDATETAGTEMPLATEREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002R2B/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}:\014tag_template"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTagTemplate",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplate",
+            index=7,
+            containing_service=None,
+            input_type=_DELETETAGTEMPLATEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0027*5/v1beta1/{name=projects/*/locations/*/tagTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTagTemplateField",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplateField",
+            index=8,
+            containing_service=None,
+            input_type=_CREATETAGTEMPLATEFIELDREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD,
+            serialized_options=_b(
+                '\202\323\344\223\002T">/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields:\022tag_template_field'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTagTemplateField",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplateField",
+            index=9,
+            containing_service=None,
+            input_type=_UPDATETAGTEMPLATEFIELDREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD,
+            serialized_options=_b(
+                "\202\323\344\223\002T2>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:\022tag_template_field"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RenameTagTemplateField",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.RenameTagTemplateField",
+            index=10,
+            containing_service=None,
+            input_type=_RENAMETAGTEMPLATEFIELDREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAGTEMPLATEFIELD,
+            serialized_options=_b(
+                '\202\323\344\223\002J"E/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTagTemplateField",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplateField",
+            index=11,
+            containing_service=None,
+            input_type=_DELETETAGTEMPLATEFIELDREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002@*>/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTag",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.CreateTag",
+            index=12,
+            containing_service=None,
+            input_type=_CREATETAGREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG,
+            serialized_options=_b(
+                '\202\323\344\223\002L"E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags:\003tag'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTag",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTag",
+            index=13,
+            containing_service=None,
+            input_type=_UPDATETAGREQUEST,
+            output_type=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2._TAG,
+            serialized_options=_b(
+                "\202\323\344\223\002P2I/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}:\003tag"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTag",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTag",
+            index=14,
+            containing_service=None,
+            input_type=_DELETETAGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002G*E/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTags",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.ListTags",
+            index=15,
+            containing_service=None,
+            input_type=_LISTTAGSREQUEST,
+            output_type=_LISTTAGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002G\022E/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.SetIamPolicy",
+            index=16,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.GetIamPolicy",
+            index=17,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.datacatalog.v1beta1.DataCatalog.TestIamPermissions",
+            index=18,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002Q"L/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DATACATALOG)
+
+DESCRIPTOR.services_by_name["DataCatalog"] = _DATACATALOG
+
+# @@protoc_insertion_point(module_scope)
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2_grpc.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2_grpc.py
new file mode 100644
index 000000000000..c9af06b41c0c
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2_grpc.py
@@ -0,0 +1,413 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.datacatalog_v1beta1.proto import (
+    datacatalog_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2,
+)
+from google.cloud.datacatalog_v1beta1.proto import (
+    tags_pb2 as google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DataCatalogStub(object):
+    """Data Catalog API service allows clients to discover, understand, and manage
+  their data.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.SearchCatalog = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/SearchCatalog",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.SearchCatalogRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.SearchCatalogResponse.FromString,
+        )
+        self.UpdateEntry = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/UpdateEntry",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateEntryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.Entry.FromString,
+        )
+        self.GetEntry = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/GetEntry",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.GetEntryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.Entry.FromString,
+        )
+        self.LookupEntry = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/LookupEntry",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.LookupEntryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.Entry.FromString,
+        )
+        self.CreateTagTemplate = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/CreateTagTemplate",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplate.FromString,
+        )
+        self.GetTagTemplate = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/GetTagTemplate",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.GetTagTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplate.FromString,
+        )
+        self.UpdateTagTemplate = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/UpdateTagTemplate",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplate.FromString,
+        )
+        self.DeleteTagTemplate = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/DeleteTagTemplate",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateTagTemplateField = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/CreateTagTemplateField",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateFieldRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplateField.FromString,
+        )
+        self.UpdateTagTemplateField = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/UpdateTagTemplateField",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateFieldRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplateField.FromString,
+        )
+        self.RenameTagTemplateField = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/RenameTagTemplateField",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.RenameTagTemplateFieldRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplateField.FromString,
+        )
+        self.DeleteTagTemplateField = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/DeleteTagTemplateField",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateFieldRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateTag = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/CreateTag",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.CreateTagRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.Tag.FromString,
+        )
+        self.UpdateTag = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/UpdateTag",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateTagRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.Tag.FromString,
+        )
+        self.DeleteTag = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/DeleteTag",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.DeleteTagRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListTags = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/ListTags",
+            request_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.ListTagsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.ListTagsResponse.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.datacatalog.v1beta1.DataCatalog/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+
+
+class DataCatalogServicer(object):
+    """Data Catalog API service allows clients to discover, understand, and manage
+  their data.
+  """
+
+    def SearchCatalog(self, request, context):
+        """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 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.
+
+    See [Data Catalog Search
+    Syntax](/data-catalog/docs/how-to/search-reference) for more information.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateEntry(self, request, context):
+        """Updates an existing entry.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetEntry(self, request, context):
+        """Gets an entry.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LookupEntry(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTagTemplate(self, request, context):
+        """Creates a tag template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTagTemplate(self, request, context):
+        """Gets a tag template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTagTemplate(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTagTemplate(self, request, context):
+        """Deletes a tag template and all tags using the template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTagTemplateField(self, request, context):
+        """Creates a field in a tag template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTagTemplateField(self, request, context):
+        """Updates a field in a tag template. This method cannot be used to update the
+    field type.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RenameTagTemplateField(self, request, context):
+        """Renames a field in a tag template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTagTemplateField(self, request, context):
+        """Deletes a field in a tag template and all uses of that field.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTag(self, request, context):
+        """Creates a tag on an [Entry][google.cloud.datacatalog.v1beta1.Entry].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTag(self, request, context):
+        """Updates an existing tag.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTag(self, request, context):
+        """Deletes a tag.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTags(self, request, context):
+        """Lists the tags on an [Entry][google.cloud.datacatalog.v1beta1.Entry].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """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.
+
+    Callers must have following Google IAM permission
+    `datacatalog.tagTemplates.setIamPolicy` to set policies on tag templates.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """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.
+    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.
+
+    Callers must have following Google IAM permission
+    `datacatalog.tagTemplates.getIamPolicy` to get policies on tag templates.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """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.
+
+    A caller is not required to have Google IAM permission to make this
+    request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DataCatalogServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "SearchCatalog": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchCatalog,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.SearchCatalogRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.SearchCatalogResponse.SerializeToString,
+        ),
+        "UpdateEntry": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateEntry,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateEntryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString,
+        ),
+        "GetEntry": grpc.unary_unary_rpc_method_handler(
+            servicer.GetEntry,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.GetEntryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString,
+        ),
+        "LookupEntry": grpc.unary_unary_rpc_method_handler(
+            servicer.LookupEntry,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.LookupEntryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.Entry.SerializeToString,
+        ),
+        "CreateTagTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTagTemplate,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplate.SerializeToString,
+        ),
+        "GetTagTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTagTemplate,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.GetTagTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplate.SerializeToString,
+        ),
+        "UpdateTagTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTagTemplate,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplate.SerializeToString,
+        ),
+        "DeleteTagTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTagTemplate,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateTagTemplateField": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTagTemplateField,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.CreateTagTemplateFieldRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplateField.SerializeToString,
+        ),
+        "UpdateTagTemplateField": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTagTemplateField,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateTagTemplateFieldRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplateField.SerializeToString,
+        ),
+        "RenameTagTemplateField": grpc.unary_unary_rpc_method_handler(
+            servicer.RenameTagTemplateField,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.RenameTagTemplateFieldRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.TagTemplateField.SerializeToString,
+        ),
+        "DeleteTagTemplateField": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTagTemplateField,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.DeleteTagTemplateFieldRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateTag": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTag,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.CreateTagRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.Tag.SerializeToString,
+        ),
+        "UpdateTag": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTag,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.UpdateTagRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_tags__pb2.Tag.SerializeToString,
+        ),
+        "DeleteTag": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTag,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.DeleteTagRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListTags": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTags,
+            request_deserializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.ListTagsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datacatalog__v1beta1_dot_proto_dot_datacatalog__pb2.ListTagsResponse.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.datacatalog.v1beta1.DataCatalog", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema.proto b/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema.proto
new file mode 100644
index 000000000000..839ef1d8ca50
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema.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.cloud.datacatalog.v1beta1;
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datacatalog";
+
+// 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;
+}
+
+// Representation of a column within a schema. Columns could be nested inside
+// other columns.
+message ColumnSchema {
+  // Required. Name of the column.
+  string column = 6;
+
+  // Required. Type of the column.
+  string type = 1;
+
+  // Optional. Description of the column. Default value is an empty string.
+  string description = 2;
+
+  // 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. Schema of sub-columns. A column can have zero or more
+  // sub-columns.
+  repeated ColumnSchema subcolumns = 7;
+}
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py
new file mode 100644
index 000000000000..e7643ae11df4
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema_pb2.py
@@ -0,0 +1,239 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog_v1beta1/proto/schema.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datacatalog_v1beta1/proto/schema.proto",
+    package="google.cloud.datacatalog.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.datacatalogP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/datacatalog_v1beta1/proto/schema.proto\x12 google.cloud.datacatalog.v1beta1"I\n\x06Schema\x12?\n\x07\x63olumns\x18\x02 \x03(\x0b\x32..google.cloud.datacatalog.v1beta1.ColumnSchema"\x93\x01\n\x0c\x43olumnSchema\x12\x0e\n\x06\x63olumn\x18\x06 \x01(\t\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x0c\n\x04mode\x18\x03 \x01(\t\x12\x42\n\nsubcolumns\x18\x07 \x03(\x0b\x32..google.cloud.datacatalog.v1beta1.ColumnSchemaBp\n\x1c\x63om.google.cloud.datacatalogP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3'
+    ),
+)
+
+
+_SCHEMA = _descriptor.Descriptor(
+    name="Schema",
+    full_name="google.cloud.datacatalog.v1beta1.Schema",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="columns",
+            full_name="google.cloud.datacatalog.v1beta1.Schema.columns",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=89,
+    serialized_end=162,
+)
+
+
+_COLUMNSCHEMA = _descriptor.Descriptor(
+    name="ColumnSchema",
+    full_name="google.cloud.datacatalog.v1beta1.ColumnSchema",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="column",
+            full_name="google.cloud.datacatalog.v1beta1.ColumnSchema.column",
+            index=0,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.datacatalog.v1beta1.ColumnSchema.type",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datacatalog.v1beta1.ColumnSchema.description",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mode",
+            full_name="google.cloud.datacatalog.v1beta1.ColumnSchema.mode",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subcolumns",
+            full_name="google.cloud.datacatalog.v1beta1.ColumnSchema.subcolumns",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=165,
+    serialized_end=312,
+)
+
+_SCHEMA.fields_by_name["columns"].message_type = _COLUMNSCHEMA
+_COLUMNSCHEMA.fields_by_name["subcolumns"].message_type = _COLUMNSCHEMA
+DESCRIPTOR.message_types_by_name["Schema"] = _SCHEMA
+DESCRIPTOR.message_types_by_name["ColumnSchema"] = _COLUMNSCHEMA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Schema = _reflection.GeneratedProtocolMessageType(
+    "Schema",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCHEMA,
+        __module__="google.cloud.datacatalog_v1beta1.proto.schema_pb2",
+        __doc__="""Represents a schema (e.g. BigQuery, GoogleSQL, Avro schema).
+  
+  
+  Attributes:
+      columns:
+          Required. Schema of columns. A maximum of 10,000 columns and
+          sub-columns can be specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Schema)
+    ),
+)
+_sym_db.RegisterMessage(Schema)
+
+ColumnSchema = _reflection.GeneratedProtocolMessageType(
+    "ColumnSchema",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLUMNSCHEMA,
+        __module__="google.cloud.datacatalog_v1beta1.proto.schema_pb2",
+        __doc__="""Representation of a column within a schema. Columns could be nested
+  inside other columns.
+  
+  
+  Attributes:
+      column:
+          Required. Name of the column.
+      type:
+          Required. Type of the column.
+      description:
+          Optional. Description of the column. Default value is an empty
+          string.
+      mode:
+          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'.
+      subcolumns:
+          Optional. Schema of sub-columns. A column can have zero or
+          more sub-columns.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ColumnSchema)
+    ),
+)
+_sym_db.RegisterMessage(ColumnSchema)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema_pb2_grpc.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/schema_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/search.proto b/datacatalog/google/cloud/datacatalog_v1beta1/proto/search.proto
new file mode 100644
index 000000000000..2a31dd94543a
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/search.proto
@@ -0,0 +1,67 @@
+// 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.datacatalog.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datacatalog";
+
+// 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 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.v1beta1.Entry].
+  ENTRY = 1;
+
+  // A [TagTemplate][google.cloud.datacatalog.v1beta1.TagTemplate].
+  TAG_TEMPLATE = 2;
+
+  // An [EntryGroup][google.cloud.datacatalog.v1beta1.EntryGroup].
+  ENTRY_GROUP = 3;
+}
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/search_pb2.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/search_pb2.py
new file mode 100644
index 000000000000..5c7ea4466f44
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/search_pb2.py
@@ -0,0 +1,210 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog_v1beta1/proto/search.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datacatalog_v1beta1/proto/search.proto",
+    package="google.cloud.datacatalog.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.datacatalogP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/datacatalog_v1beta1/proto/search.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xbd\x01\n\x13SearchCatalogResult\x12N\n\x12search_result_type\x18\x01 \x01(\x0e\x32\x32.google.cloud.datacatalog.v1beta1.SearchResultType\x12\x1d\n\x15search_result_subtype\x18\x02 \x01(\t\x12\x1e\n\x16relative_resource_name\x18\x03 \x01(\t\x12\x17\n\x0flinked_resource\x18\x04 \x01(\t*d\n\x10SearchResultType\x12"\n\x1eSEARCH_RESULT_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x45NTRY\x10\x01\x12\x10\n\x0cTAG_TEMPLATE\x10\x02\x12\x0f\n\x0b\x45NTRY_GROUP\x10\x03\x42p\n\x1c\x63om.google.cloud.datacatalogP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_SEARCHRESULTTYPE = _descriptor.EnumDescriptor(
+    name="SearchResultType",
+    full_name="google.cloud.datacatalog.v1beta1.SearchResultType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SEARCH_RESULT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENTRY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TAG_TEMPLATE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENTRY_GROUP", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=344,
+    serialized_end=444,
+)
+_sym_db.RegisterEnumDescriptor(_SEARCHRESULTTYPE)
+
+SearchResultType = enum_type_wrapper.EnumTypeWrapper(_SEARCHRESULTTYPE)
+SEARCH_RESULT_TYPE_UNSPECIFIED = 0
+ENTRY = 1
+TAG_TEMPLATE = 2
+ENTRY_GROUP = 3
+
+
+_SEARCHCATALOGRESULT = _descriptor.Descriptor(
+    name="SearchCatalogResult",
+    full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="search_result_type",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResult.search_result_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="search_result_subtype",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResult.search_result_subtype",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_resource_name",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResult.relative_resource_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="linked_resource",
+            full_name="google.cloud.datacatalog.v1beta1.SearchCatalogResult.linked_resource",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=153,
+    serialized_end=342,
+)
+
+_SEARCHCATALOGRESULT.fields_by_name["search_result_type"].enum_type = _SEARCHRESULTTYPE
+DESCRIPTOR.message_types_by_name["SearchCatalogResult"] = _SEARCHCATALOGRESULT
+DESCRIPTOR.enum_types_by_name["SearchResultType"] = _SEARCHRESULTTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SearchCatalogResult = _reflection.GeneratedProtocolMessageType(
+    "SearchCatalogResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHCATALOGRESULT,
+        __module__="google.cloud.datacatalog_v1beta1.proto.search_pb2",
+        __doc__="""A result that appears in the response of a search request. Each result
+  captures details of one entry that matches the search.
+  
+  
+  Attributes:
+      search_result_type:
+          Type of the search result. This field can be used to determine
+          which Get method to call to fetch the full resource.
+      search_result_subtype:
+          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"
+      relative_resource_name:
+          The relative resource name of the resource in URL format.
+          Examples: "projects/{project\_id}/locations/{location\_id}/ent
+          ryGroups/{entry\_group\_id}/entries/{entry\_id}".
+          "projects/{project\_id}/tagTemplates/{tag\_template\_id}".
+      linked_resource:
+          The full name of the cloud resource the entry belongs to. See:
+          https://cloud.google.com/apis/design/resource\_names#full\_res
+          ource\_name Example: "//bigquery.googleapis.com/projects/proje
+          ctId/datasets/datasetId/tables/tableId".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SearchCatalogResult)
+    ),
+)
+_sym_db.RegisterMessage(SearchCatalogResult)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/search_pb2_grpc.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/search_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/search_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec.proto b/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec.proto
new file mode 100644
index 000000000000..8e9547fea783
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec.proto
@@ -0,0 +1,88 @@
+// 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.datacatalog.v1beta1;
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datacatalog";
+
+// Describes a BigQuery table.
+message BigQueryTableSpec {
+  // Output only. The table source type.
+  TableSourceType table_source_type = 1;
+
+  // 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;
+}
+
+// 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;
+}
+
+// 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 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. Total number of shards.
+  int64 shard_count = 3;
+}
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py
new file mode 100644
index 000000000000..c2fcf4ba9ea1
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2.py
@@ -0,0 +1,419 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog_v1beta1/proto/table_spec.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datacatalog_v1beta1/proto/table_spec.proto",
+    package="google.cloud.datacatalog.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.datacatalogP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/datacatalog_v1beta1/proto/table_spec.proto\x12 google.cloud.datacatalog.v1beta1"\xf2\x01\n\x11\x42igQueryTableSpec\x12L\n\x11table_source_type\x18\x01 \x01(\x0e\x32\x31.google.cloud.datacatalog.v1beta1.TableSourceType\x12?\n\tview_spec\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.ViewSpecH\x00\x12\x41\n\ntable_spec\x18\x03 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.TableSpecH\x00\x42\x0b\n\ttype_spec"\x1e\n\x08ViewSpec\x12\x12\n\nview_query\x18\x01 \x01(\t""\n\tTableSpec\x12\x15\n\rgrouped_entry\x18\x01 \x01(\t"U\n\x17\x42igQueryDateShardedSpec\x12\x0f\n\x07\x64\x61taset\x18\x01 \x01(\t\x12\x14\n\x0ctable_prefix\x18\x02 \x01(\t\x12\x13\n\x0bshard_count\x18\x03 \x01(\x03*[\n\x0fTableSourceType\x12!\n\x1dTABLE_SOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x11\n\rBIGQUERY_VIEW\x10\x02\x12\x12\n\x0e\x42IGQUERY_TABLE\x10\x05\x42p\n\x1c\x63om.google.cloud.datacatalogP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3'
+    ),
+)
+
+_TABLESOURCETYPE = _descriptor.EnumDescriptor(
+    name="TableSourceType",
+    full_name="google.cloud.datacatalog.v1beta1.TableSourceType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TABLE_SOURCE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BIGQUERY_VIEW", index=1, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BIGQUERY_TABLE", index=2, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=493,
+    serialized_end=584,
+)
+_sym_db.RegisterEnumDescriptor(_TABLESOURCETYPE)
+
+TableSourceType = enum_type_wrapper.EnumTypeWrapper(_TABLESOURCETYPE)
+TABLE_SOURCE_TYPE_UNSPECIFIED = 0
+BIGQUERY_VIEW = 2
+BIGQUERY_TABLE = 5
+
+
+_BIGQUERYTABLESPEC = _descriptor.Descriptor(
+    name="BigQueryTableSpec",
+    full_name="google.cloud.datacatalog.v1beta1.BigQueryTableSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_source_type",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryTableSpec.table_source_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view_spec",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryTableSpec.view_spec",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_spec",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryTableSpec.table_spec",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type_spec",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryTableSpec.type_spec",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=94,
+    serialized_end=336,
+)
+
+
+_VIEWSPEC = _descriptor.Descriptor(
+    name="ViewSpec",
+    full_name="google.cloud.datacatalog.v1beta1.ViewSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="view_query",
+            full_name="google.cloud.datacatalog.v1beta1.ViewSpec.view_query",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=338,
+    serialized_end=368,
+)
+
+
+_TABLESPEC = _descriptor.Descriptor(
+    name="TableSpec",
+    full_name="google.cloud.datacatalog.v1beta1.TableSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="grouped_entry",
+            full_name="google.cloud.datacatalog.v1beta1.TableSpec.grouped_entry",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=370,
+    serialized_end=404,
+)
+
+
+_BIGQUERYDATESHARDEDSPEC = _descriptor.Descriptor(
+    name="BigQueryDateShardedSpec",
+    full_name="google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpec.dataset",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_prefix",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpec.table_prefix",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shard_count",
+            full_name="google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpec.shard_count",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=406,
+    serialized_end=491,
+)
+
+_BIGQUERYTABLESPEC.fields_by_name["table_source_type"].enum_type = _TABLESOURCETYPE
+_BIGQUERYTABLESPEC.fields_by_name["view_spec"].message_type = _VIEWSPEC
+_BIGQUERYTABLESPEC.fields_by_name["table_spec"].message_type = _TABLESPEC
+_BIGQUERYTABLESPEC.oneofs_by_name["type_spec"].fields.append(
+    _BIGQUERYTABLESPEC.fields_by_name["view_spec"]
+)
+_BIGQUERYTABLESPEC.fields_by_name[
+    "view_spec"
+].containing_oneof = _BIGQUERYTABLESPEC.oneofs_by_name["type_spec"]
+_BIGQUERYTABLESPEC.oneofs_by_name["type_spec"].fields.append(
+    _BIGQUERYTABLESPEC.fields_by_name["table_spec"]
+)
+_BIGQUERYTABLESPEC.fields_by_name[
+    "table_spec"
+].containing_oneof = _BIGQUERYTABLESPEC.oneofs_by_name["type_spec"]
+DESCRIPTOR.message_types_by_name["BigQueryTableSpec"] = _BIGQUERYTABLESPEC
+DESCRIPTOR.message_types_by_name["ViewSpec"] = _VIEWSPEC
+DESCRIPTOR.message_types_by_name["TableSpec"] = _TABLESPEC
+DESCRIPTOR.message_types_by_name["BigQueryDateShardedSpec"] = _BIGQUERYDATESHARDEDSPEC
+DESCRIPTOR.enum_types_by_name["TableSourceType"] = _TABLESOURCETYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+BigQueryTableSpec = _reflection.GeneratedProtocolMessageType(
+    "BigQueryTableSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYTABLESPEC,
+        __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2",
+        __doc__="""Describes a BigQuery table.
+  
+  
+  Attributes:
+      table_source_type:
+          Output only. The table source type.
+      type_spec:
+          Output only.
+      view_spec:
+          Table view specification. This field should only be populated
+          if table\_source\_type is BIGQUERY\_VIEW.
+      table_spec:
+          Spec of a BigQuery table. This field should only be populated
+          if table\_source\_type is BIGQUERY\_TABLE.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.BigQueryTableSpec)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryTableSpec)
+
+ViewSpec = _reflection.GeneratedProtocolMessageType(
+    "ViewSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIEWSPEC,
+        __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2",
+        __doc__="""Table view specification.
+  
+  
+  Attributes:
+      view_query:
+          Output only. The query that defines the table view.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.ViewSpec)
+    ),
+)
+_sym_db.RegisterMessage(ViewSpec)
+
+TableSpec = _reflection.GeneratedProtocolMessageType(
+    "TableSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLESPEC,
+        __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2",
+        __doc__="""Normal BigQuery table spec.
+  
+  
+  Attributes:
+      grouped_entry:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TableSpec)
+    ),
+)
+_sym_db.RegisterMessage(TableSpec)
+
+BigQueryDateShardedSpec = _reflection.GeneratedProtocolMessageType(
+    "BigQueryDateShardedSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYDATESHARDEDSPEC,
+        __module__="google.cloud.datacatalog_v1beta1.proto.table_spec_pb2",
+        __doc__="""Spec for a group of BigQuery tables with name pattern [prefix]YYYYMMDD.
+  Context:
+  https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning\_versus\_sharding
+  
+  
+  Attributes:
+      dataset:
+          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}
+      table_prefix:
+          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"
+      shard_count:
+          Output only. Total number of shards.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.BigQueryDateShardedSpec)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryDateShardedSpec)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2_grpc.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/table_spec_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags.proto b/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags.proto
new file mode 100644
index 000000000000..f01843c206e9
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags.proto
@@ -0,0 +1,177 @@
+// 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.datacatalog.v1beta1;
+
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datacatalog";
+
+// Tags are used to attach custom metadata to Data Catalog resources. Tags
+// conform to the specifications within their tag template.
+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.
+  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}.
+  // This field cannot be modified after creation.
+  string template = 2;
+
+  // Output only. The display name of the tag template.
+  string template_display_name = 5;
+
+  // 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.
+  // 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".
+    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<string, TagField> fields = 3;
+}
+
+// Contains the value and supporting information for a field within
+// a [Tag][google.cloud.datacatalog.v1beta1.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;
+
+  // 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;
+  }
+}
+
+// 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.
+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}.
+  // 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.
+  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<string, TagTemplateField> fields = 3;
+}
+
+// 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.
+  string display_name = 1;
+
+  // Required. The type of value this tag field can contain.
+  FieldType type = 2;
+}
+
+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 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/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py
new file mode 100644
index 000000000000..c9d36922e79e
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags_pb2.py
@@ -0,0 +1,1049 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog_v1beta1/proto/tags.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datacatalog_v1beta1/proto/tags.proto",
+    package="google.cloud.datacatalog.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.datacatalogP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/datacatalog_v1beta1/proto/tags.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/protobuf/timestamp.proto"\xfd\x01\n\x03Tag\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08template\x18\x02 \x01(\t\x12\x1d\n\x15template_display_name\x18\x05 \x01(\t\x12\x10\n\x06\x63olumn\x18\x04 \x01(\tH\x00\x12\x41\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x31.google.cloud.datacatalog.v1beta1.Tag.FieldsEntry\x1aY\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x39\n\x05value\x18\x02 \x01(\x0b\x32*.google.cloud.datacatalog.v1beta1.TagField:\x02\x38\x01\x42\x07\n\x05scope"\x94\x02\n\x08TagField\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x16\n\x0c\x64ouble_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\x0ftimestamp_value\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12J\n\nenum_value\x18\x06 \x01(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.TagField.EnumValueH\x00\x1a!\n\tEnumValue\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x06\n\x04kind"\xdf\x01\n\x0bTagTemplate\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12I\n\x06\x66ields\x18\x03 \x03(\x0b\x32\x39.google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntry\x1a\x61\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x41\n\x05value\x18\x02 \x01(\x0b\x32\x32.google.cloud.datacatalog.v1beta1.TagTemplateField:\x02\x38\x01"c\n\x10TagTemplateField\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x39\n\x04type\x18\x02 \x01(\x0b\x32+.google.cloud.datacatalog.v1beta1.FieldType"\xa2\x03\n\tFieldType\x12S\n\x0eprimitive_type\x18\x01 \x01(\x0e\x32\x39.google.cloud.datacatalog.v1beta1.FieldType.PrimitiveTypeH\x00\x12I\n\tenum_type\x18\x02 \x01(\x0b\x32\x34.google.cloud.datacatalog.v1beta1.FieldType.EnumTypeH\x00\x1a\x85\x01\n\x08\x45numType\x12V\n\x0e\x61llowed_values\x18\x01 \x03(\x0b\x32>.google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue\x1a!\n\tEnumValue\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t"`\n\rPrimitiveType\x12\x1e\n\x1aPRIMITIVE_TYPE_UNSPECIFIED\x10\x00\x12\n\n\x06\x44OUBLE\x10\x01\x12\n\n\x06STRING\x10\x02\x12\x08\n\x04\x42OOL\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x42\x0b\n\ttype_declBp\n\x1c\x63om.google.cloud.datacatalogP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR],
+)
+
+
+_FIELDTYPE_PRIMITIVETYPE = _descriptor.EnumDescriptor(
+    name="PrimitiveType",
+    full_name="google.cloud.datacatalog.v1beta1.FieldType.PrimitiveType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PRIMITIVE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOUBLE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIMESTAMP", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1292,
+    serialized_end=1388,
+)
+_sym_db.RegisterEnumDescriptor(_FIELDTYPE_PRIMITIVETYPE)
+
+
+_TAG_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.cloud.datacatalog.v1beta1.Tag.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=276,
+    serialized_end=365,
+)
+
+_TAG = _descriptor.Descriptor(
+    name="Tag",
+    full_name="google.cloud.datacatalog.v1beta1.Tag",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.template",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template_display_name",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.template_display_name",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.column",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.fields",
+            index=4,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TAG_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="scope",
+            full_name="google.cloud.datacatalog.v1beta1.Tag.scope",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=121,
+    serialized_end=374,
+)
+
+
+_TAGFIELD_ENUMVALUE = _descriptor.Descriptor(
+    name="EnumValue",
+    full_name="google.cloud.datacatalog.v1beta1.TagField.EnumValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.EnumValue.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=612,
+    serialized_end=645,
+)
+
+_TAGFIELD = _descriptor.Descriptor(
+    name="TagField",
+    full_name="google.cloud.datacatalog.v1beta1.TagField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="double_value",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.double_value",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.string_value",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bool_value",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.bool_value",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_value",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.timestamp_value",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enum_value",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.enum_value",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TAGFIELD_ENUMVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="kind",
+            full_name="google.cloud.datacatalog.v1beta1.TagField.kind",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=377,
+    serialized_end=653,
+)
+
+
+_TAGTEMPLATE_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=782,
+    serialized_end=879,
+)
+
+_TAGTEMPLATE = _descriptor.Descriptor(
+    name="TagTemplate",
+    full_name="google.cloud.datacatalog.v1beta1.TagTemplate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplate.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplate.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplate.fields",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TAGTEMPLATE_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=656,
+    serialized_end=879,
+)
+
+
+_TAGTEMPLATEFIELD = _descriptor.Descriptor(
+    name="TagTemplateField",
+    full_name="google.cloud.datacatalog.v1beta1.TagTemplateField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplateField.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.datacatalog.v1beta1.TagTemplateField.type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=881,
+    serialized_end=980,
+)
+
+
+_FIELDTYPE_ENUMTYPE_ENUMVALUE = _descriptor.Descriptor(
+    name="EnumValue",
+    full_name="google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=612,
+    serialized_end=645,
+)
+
+_FIELDTYPE_ENUMTYPE = _descriptor.Descriptor(
+    name="EnumType",
+    full_name="google.cloud.datacatalog.v1beta1.FieldType.EnumType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="allowed_values",
+            full_name="google.cloud.datacatalog.v1beta1.FieldType.EnumType.allowed_values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_FIELDTYPE_ENUMTYPE_ENUMVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1157,
+    serialized_end=1290,
+)
+
+_FIELDTYPE = _descriptor.Descriptor(
+    name="FieldType",
+    full_name="google.cloud.datacatalog.v1beta1.FieldType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="primitive_type",
+            full_name="google.cloud.datacatalog.v1beta1.FieldType.primitive_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enum_type",
+            full_name="google.cloud.datacatalog.v1beta1.FieldType.enum_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FIELDTYPE_ENUMTYPE],
+    enum_types=[_FIELDTYPE_PRIMITIVETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type_decl",
+            full_name="google.cloud.datacatalog.v1beta1.FieldType.type_decl",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=983,
+    serialized_end=1401,
+)
+
+_TAG_FIELDSENTRY.fields_by_name["value"].message_type = _TAGFIELD
+_TAG_FIELDSENTRY.containing_type = _TAG
+_TAG.fields_by_name["fields"].message_type = _TAG_FIELDSENTRY
+_TAG.oneofs_by_name["scope"].fields.append(_TAG.fields_by_name["column"])
+_TAG.fields_by_name["column"].containing_oneof = _TAG.oneofs_by_name["scope"]
+_TAGFIELD_ENUMVALUE.containing_type = _TAGFIELD
+_TAGFIELD.fields_by_name[
+    "timestamp_value"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TAGFIELD.fields_by_name["enum_value"].message_type = _TAGFIELD_ENUMVALUE
+_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["double_value"])
+_TAGFIELD.fields_by_name["double_value"].containing_oneof = _TAGFIELD.oneofs_by_name[
+    "kind"
+]
+_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["string_value"])
+_TAGFIELD.fields_by_name["string_value"].containing_oneof = _TAGFIELD.oneofs_by_name[
+    "kind"
+]
+_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["bool_value"])
+_TAGFIELD.fields_by_name["bool_value"].containing_oneof = _TAGFIELD.oneofs_by_name[
+    "kind"
+]
+_TAGFIELD.oneofs_by_name["kind"].fields.append(
+    _TAGFIELD.fields_by_name["timestamp_value"]
+)
+_TAGFIELD.fields_by_name["timestamp_value"].containing_oneof = _TAGFIELD.oneofs_by_name[
+    "kind"
+]
+_TAGFIELD.oneofs_by_name["kind"].fields.append(_TAGFIELD.fields_by_name["enum_value"])
+_TAGFIELD.fields_by_name["enum_value"].containing_oneof = _TAGFIELD.oneofs_by_name[
+    "kind"
+]
+_TAGTEMPLATE_FIELDSENTRY.fields_by_name["value"].message_type = _TAGTEMPLATEFIELD
+_TAGTEMPLATE_FIELDSENTRY.containing_type = _TAGTEMPLATE
+_TAGTEMPLATE.fields_by_name["fields"].message_type = _TAGTEMPLATE_FIELDSENTRY
+_TAGTEMPLATEFIELD.fields_by_name["type"].message_type = _FIELDTYPE
+_FIELDTYPE_ENUMTYPE_ENUMVALUE.containing_type = _FIELDTYPE_ENUMTYPE
+_FIELDTYPE_ENUMTYPE.fields_by_name[
+    "allowed_values"
+].message_type = _FIELDTYPE_ENUMTYPE_ENUMVALUE
+_FIELDTYPE_ENUMTYPE.containing_type = _FIELDTYPE
+_FIELDTYPE.fields_by_name["primitive_type"].enum_type = _FIELDTYPE_PRIMITIVETYPE
+_FIELDTYPE.fields_by_name["enum_type"].message_type = _FIELDTYPE_ENUMTYPE
+_FIELDTYPE_PRIMITIVETYPE.containing_type = _FIELDTYPE
+_FIELDTYPE.oneofs_by_name["type_decl"].fields.append(
+    _FIELDTYPE.fields_by_name["primitive_type"]
+)
+_FIELDTYPE.fields_by_name[
+    "primitive_type"
+].containing_oneof = _FIELDTYPE.oneofs_by_name["type_decl"]
+_FIELDTYPE.oneofs_by_name["type_decl"].fields.append(
+    _FIELDTYPE.fields_by_name["enum_type"]
+)
+_FIELDTYPE.fields_by_name["enum_type"].containing_oneof = _FIELDTYPE.oneofs_by_name[
+    "type_decl"
+]
+DESCRIPTOR.message_types_by_name["Tag"] = _TAG
+DESCRIPTOR.message_types_by_name["TagField"] = _TAGFIELD
+DESCRIPTOR.message_types_by_name["TagTemplate"] = _TAGTEMPLATE
+DESCRIPTOR.message_types_by_name["TagTemplateField"] = _TAGTEMPLATEFIELD
+DESCRIPTOR.message_types_by_name["FieldType"] = _FIELDTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Tag = _reflection.GeneratedProtocolMessageType(
+    "Tag",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TAG_FIELDSENTRY,
+                __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Tag.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TAG,
+        __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+        __doc__="""Tags are used to attach custom metadata to Data Catalog resources. Tags
+  conform to the specifications within their tag template.
+  
+  
+  Attributes:
+      name:
+          Required when used in [UpdateTagRequest][google.cloud.datacata
+          log.v1beta1.UpdateTagRequest]. The resource name of the tag in
+          URL format. For example, projects/{project\_id}/locations/{loc
+          ation}/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.
+      template:
+          Required. The resource name of the tag template that this tag
+          uses. For example, projects/{project\_id}/locations/{location}
+          /tagTemplates/{tag\_template\_id}. This field cannot be
+          modified after creation.
+      template_display_name:
+          Output only. The display name of the tag template.
+      scope:
+          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. Deleting the scope from the parent
+          resource will delete all tags attached to that scope. These
+          fields cannot be updated after creation.
+      column:
+          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".
+      fields:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.Tag)
+    ),
+)
+_sym_db.RegisterMessage(Tag)
+_sym_db.RegisterMessage(Tag.FieldsEntry)
+
+TagField = _reflection.GeneratedProtocolMessageType(
+    "TagField",
+    (_message.Message,),
+    dict(
+        EnumValue=_reflection.GeneratedProtocolMessageType(
+            "EnumValue",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TAGFIELD_ENUMVALUE,
+                __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+                __doc__="""Holds an enum value.
+    
+    
+    Attributes:
+        display_name:
+            The display name of the enum value.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagField.EnumValue)
+            ),
+        ),
+        DESCRIPTOR=_TAGFIELD,
+        __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+        __doc__="""Contains the value and supporting information for a field within a
+  [Tag][google.cloud.datacatalog.v1beta1.Tag].
+  
+  
+  Attributes:
+      display_name:
+          Output only. The display name of this field.
+      kind:
+          Required. The value of this field.
+      double_value:
+          Holds the value for a tag field with double type.
+      string_value:
+          Holds the value for a tag field with string type.
+      bool_value:
+          Holds the value for a tag field with boolean type.
+      timestamp_value:
+          Holds the value for a tag field with timestamp type.
+      enum_value:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagField)
+    ),
+)
+_sym_db.RegisterMessage(TagField)
+_sym_db.RegisterMessage(TagField.EnumValue)
+
+TagTemplate = _reflection.GeneratedProtocolMessageType(
+    "TagTemplate",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TAGTEMPLATE_FIELDSENTRY,
+                __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagTemplate.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TAGTEMPLATE,
+        __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          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}. Note that this TagTemplate and its child resources may
+          not actually be stored in the location in this name.
+      display_name:
+          Optional. The display name for this template. Default value is
+          an empty string.
+      fields:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagTemplate)
+    ),
+)
+_sym_db.RegisterMessage(TagTemplate)
+_sym_db.RegisterMessage(TagTemplate.FieldsEntry)
+
+TagTemplateField = _reflection.GeneratedProtocolMessageType(
+    "TagTemplateField",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TAGTEMPLATEFIELD,
+        __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+        __doc__="""The template for an individual field within a tag template.
+  
+  
+  Attributes:
+      display_name:
+          Optional. The display name for this field. Default value is an
+          empty string.
+      type:
+          Required. The type of value this tag field can contain.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.TagTemplateField)
+    ),
+)
+_sym_db.RegisterMessage(TagTemplateField)
+
+FieldType = _reflection.GeneratedProtocolMessageType(
+    "FieldType",
+    (_message.Message,),
+    dict(
+        EnumType=_reflection.GeneratedProtocolMessageType(
+            "EnumType",
+            (_message.Message,),
+            dict(
+                EnumValue=_reflection.GeneratedProtocolMessageType(
+                    "EnumValue",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_FIELDTYPE_ENUMTYPE_ENUMVALUE,
+                        __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+                        __doc__="""
+    Attributes:
+          display_name:
+              Required. The display name of the enum value. Must not be an
+              empty string.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.FieldType.EnumType.EnumValue)
+                    ),
+                ),
+                DESCRIPTOR=_FIELDTYPE_ENUMTYPE,
+                __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+                __doc__="""
+    Attributes:
+        allowed_values:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.FieldType.EnumType)
+            ),
+        ),
+        DESCRIPTOR=_FIELDTYPE,
+        __module__="google.cloud.datacatalog_v1beta1.proto.tags_pb2",
+        __doc__="""
+    Attributes:
+      type_decl:
+          Required.
+      primitive_type:
+          Represents primitive types - string, bool etc.
+      enum_type:
+          Represents an enum type.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.FieldType)
+    ),
+)
+_sym_db.RegisterMessage(FieldType)
+_sym_db.RegisterMessage(FieldType.EnumType)
+_sym_db.RegisterMessage(FieldType.EnumType.EnumValue)
+
+
+DESCRIPTOR._options = None
+_TAG_FIELDSENTRY._options = None
+_TAGTEMPLATE_FIELDSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags_pb2_grpc.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/tags_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps.proto b/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps.proto
new file mode 100644
index 000000000000..bb048b915223
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps.proto
@@ -0,0 +1,38 @@
+// 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.datacatalog.v1beta1;
+
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datacatalog";
+
+// Timestamps about this resource according to a particular system.
+message SystemTimestamps {
+  // Output only. 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.
+  google.protobuf.Timestamp update_time = 2;
+
+  // Output only. The expiration time of the resource within the given system.
+  google.protobuf.Timestamp expire_time = 3;
+}
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py
new file mode 100644
index 000000000000..3c1c341f65ce
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2.py
@@ -0,0 +1,148 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog_v1beta1/proto/timestamps.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datacatalog_v1beta1/proto/timestamps.proto",
+    package="google.cloud.datacatalog.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.datacatalogP\001ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/datacatalog_v1beta1/proto/timestamps.proto\x12 google.cloud.datacatalog.v1beta1\x1a\x1fgoogle/protobuf/timestamp.proto"\xa5\x01\n\x10SystemTimestamps\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampBp\n\x1c\x63om.google.cloud.datacatalogP\x01ZKgoogle.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR],
+)
+
+
+_SYSTEMTIMESTAMPS = _descriptor.Descriptor(
+    name="SystemTimestamps",
+    full_name="google.cloud.datacatalog.v1beta1.SystemTimestamps",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datacatalog.v1beta1.SystemTimestamps.create_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.datacatalog.v1beta1.SystemTimestamps.update_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.cloud.datacatalog.v1beta1.SystemTimestamps.expire_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=127,
+    serialized_end=292,
+)
+
+_SYSTEMTIMESTAMPS.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SYSTEMTIMESTAMPS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SYSTEMTIMESTAMPS.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["SystemTimestamps"] = _SYSTEMTIMESTAMPS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SystemTimestamps = _reflection.GeneratedProtocolMessageType(
+    "SystemTimestamps",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYSTEMTIMESTAMPS,
+        __module__="google.cloud.datacatalog_v1beta1.proto.timestamps_pb2",
+        __doc__="""Timestamps about this resource according to a particular system.
+  
+  
+  Attributes:
+      create_time:
+          Output only. The creation time of the resource within the
+          given system.
+      update_time:
+          Output only. The last-modified time of the resource within the
+          given system.
+      expire_time:
+          Output only. The expiration time of the resource within the
+          given system.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datacatalog.v1beta1.SystemTimestamps)
+    ),
+)
+_sym_db.RegisterMessage(SystemTimestamps)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2_grpc.py b/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/proto/timestamps_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datacatalog/google/cloud/datacatalog_v1beta1/types.py b/datacatalog/google/cloud/datacatalog_v1beta1/types.py
new file mode 100644
index 000000000000..05d90716fc84
--- /dev/null
+++ b/datacatalog/google/cloud/datacatalog_v1beta1/types.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.datacatalog_v1beta1.proto import datacatalog_pb2
+from google.cloud.datacatalog_v1beta1.proto import schema_pb2
+from google.cloud.datacatalog_v1beta1.proto import search_pb2
+from google.cloud.datacatalog_v1beta1.proto import table_spec_pb2
+from google.cloud.datacatalog_v1beta1.proto import tags_pb2
+from google.cloud.datacatalog_v1beta1.proto import timestamps_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    expr_pb2,
+]
+
+_local_modules = [
+    datacatalog_pb2,
+    schema_pb2,
+    search_pb2,
+    table_spec_pb2,
+    tags_pb2,
+    timestamps_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.datacatalog_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/datacatalog/noxfile.py b/datacatalog/noxfile.py
new file mode 100644
index 000000000000..3d92df19084f
--- /dev/null
+++ b/datacatalog/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=80")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/datacatalog/samples/v1beta1/datacatalog_get_entry.py b/datacatalog/samples/v1beta1/datacatalog_get_entry.py
new file mode 100644
index 000000000000..97a4a92c8106
--- /dev/null
+++ b/datacatalog/samples/v1beta1/datacatalog_get_entry.py
@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# DO NOT EDIT! This is a generated sample ("Request",  "datacatalog_get_entry")
+
+# To install the latest published package dependency, execute the following:
+#   pip install google-cloud-datacatalog
+
+# sample-metadata
+#   title:
+#   description: Get Entry
+#   usage: python3 samples/v1beta1/datacatalog_get_entry.py [--project_id "[Google Cloud Project ID]"] [--location_id "[Google Cloud Location ID]"] [--entry_group_id "[Entry Group ID]"] [--entry_id "[Entry ID]"]
+
+# [START datacatalog_get_entry]
+from google.cloud import datacatalog_v1beta1
+from google.cloud.datacatalog_v1beta1 import enums
+
+
+def sample_get_entry(project_id, location_id, entry_group_id, entry_id):
+    """
+    Get Entry
+
+    Args:
+      project_id Your Google Cloud project ID
+      location_id Google Cloud region, e.g. us-central1
+      entry_group_id ID of the Entry Group, e.g. @bigquery, @pubsub, my_entry_group
+      entry_id ID of the Entry
+    """
+
+    client = datacatalog_v1beta1.DataCatalogClient()
+
+    # project_id = '[Google Cloud Project ID]'
+    # location_id = '[Google Cloud Location ID]'
+    # entry_group_id = '[Entry Group ID]'
+    # entry_id = '[Entry ID]'
+    name = client.entry_path(project_id, location_id, entry_group_id, entry_id)
+
+    response = client.get_entry(name)
+    entry = response
+    print(u"Entry name: {}".format(entry.name))
+    print(u"Entry type: {}".format(enums.EntryType(entry.type).name))
+    print(u"Linked resource: {}".format(entry.linked_resource))
+
+
+# [END datacatalog_get_entry]
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--project_id", type=str, default="[Google Cloud Project ID]")
+    parser.add_argument("--location_id", type=str, default="[Google Cloud Location ID]")
+    parser.add_argument("--entry_group_id", type=str, default="[Entry Group ID]")
+    parser.add_argument("--entry_id", type=str, default="[Entry ID]")
+    args = parser.parse_args()
+
+    sample_get_entry(
+        args.project_id, args.location_id, args.entry_group_id, args.entry_id
+    )
+
+
+if __name__ == "__main__":
+    main()
diff --git a/datacatalog/samples/v1beta1/datacatalog_lookup_entry.py b/datacatalog/samples/v1beta1/datacatalog_lookup_entry.py
new file mode 100644
index 000000000000..42c3c6ff4ce8
--- /dev/null
+++ b/datacatalog/samples/v1beta1/datacatalog_lookup_entry.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# DO NOT EDIT! This is a generated sample ("Request",  "datacatalog_lookup_entry")
+
+# To install the latest published package dependency, execute the following:
+#   pip install google-cloud-datacatalog
+
+# sample-metadata
+#   title:
+#   description: Lookup Entry
+#   usage: python3 samples/v1beta1/datacatalog_lookup_entry.py [--resource_name "[Full Resource Name]"]
+
+# [START datacatalog_lookup_entry]
+from google.cloud import datacatalog_v1beta1
+from google.cloud.datacatalog_v1beta1 import enums
+
+
+def sample_lookup_entry(resource_name):
+    """
+    Lookup Entry
+
+    Args:
+      resource_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
+      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
+    """
+
+    client = datacatalog_v1beta1.DataCatalogClient()
+
+    # resource_name = '[Full Resource Name]'
+    response = client.lookup_entry(linked_resource=resource_name)
+    entry = response
+    print(u"Entry name: {}".format(entry.name))
+    print(u"Entry type: {}".format(enums.EntryType(entry.type).name))
+    print(u"Linked resource: {}".format(entry.linked_resource))
+
+
+# [END datacatalog_lookup_entry]
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--resource_name", type=str, default="[Full Resource Name]")
+    args = parser.parse_args()
+
+    sample_lookup_entry(args.resource_name)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/datacatalog/samples/v1beta1/datacatalog_lookup_entry_sql_resource.py b/datacatalog/samples/v1beta1/datacatalog_lookup_entry_sql_resource.py
new file mode 100644
index 000000000000..1b19a57f8189
--- /dev/null
+++ b/datacatalog/samples/v1beta1/datacatalog_lookup_entry_sql_resource.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# DO NOT EDIT! This is a generated sample ("Request",  "datacatalog_lookup_entry_sql_resource")
+
+# To install the latest published package dependency, execute the following:
+#   pip install google-cloud-datacatalog
+
+# sample-metadata
+#   title:
+#   description: Lookup Entry using SQL resource
+#   usage: python3 samples/v1beta1/datacatalog_lookup_entry_sql_resource.py [--sql_name "[SQL Resource Name]"]
+
+# [START datacatalog_lookup_entry_sql_resource]
+from google.cloud import datacatalog_v1beta1
+from google.cloud.datacatalog_v1beta1 import enums
+
+
+def sample_lookup_entry(sql_name):
+    """
+    Lookup Entry using SQL resource
+
+    Args:
+      sql_name 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`
+    """
+
+    client = datacatalog_v1beta1.DataCatalogClient()
+
+    # sql_name = '[SQL Resource Name]'
+    response = client.lookup_entry(sql_resource=sql_name)
+    entry = response
+    print(u"Entry name: {}".format(entry.name))
+    print(u"Entry type: {}".format(enums.EntryType(entry.type).name))
+    print(u"Linked resource: {}".format(entry.linked_resource))
+
+
+# [END datacatalog_lookup_entry_sql_resource]
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--sql_name", type=str, default="[SQL Resource Name]")
+    args = parser.parse_args()
+
+    sample_lookup_entry(args.sql_name)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/datacatalog/samples/v1beta1/datacatalog_search.py b/datacatalog/samples/v1beta1/datacatalog_search.py
new file mode 100644
index 000000000000..a49107de520f
--- /dev/null
+++ b/datacatalog/samples/v1beta1/datacatalog_search.py
@@ -0,0 +1,90 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# DO NOT EDIT! This is a generated sample ("RequestPagedAll",  "datacatalog_search")
+
+# To install the latest published package dependency, execute the following:
+#   pip install google-cloud-datacatalog
+
+# sample-metadata
+#   title:
+#   description: Search Catalog
+#   usage: python3 samples/v1beta1/datacatalog_search.py [--include_project_id "[Google Cloud Project ID]"] [--include_gcp_public_datasets false] [--query "[String in search query syntax]"]
+
+# [START datacatalog_search]
+from google.cloud import datacatalog_v1beta1
+from google.cloud.datacatalog_v1beta1 import enums
+
+
+def sample_search_catalog(include_project_id, include_gcp_public_datasets, query):
+    """
+    Search Catalog
+
+    Args:
+      include_project_id Your Google Cloud project ID.
+      include_gcp_public_datasets If true, include Google Cloud Platform (GCP) public
+      datasets in the search results.
+      query Your query string.
+      See: https://cloud.google.com/data-catalog/docs/how-to/search-reference
+      Example: system=bigquery type=dataset
+    """
+
+    client = datacatalog_v1beta1.DataCatalogClient()
+
+    # include_project_id = '[Google Cloud Project ID]'
+    # include_gcp_public_datasets = False
+    # query = '[String in search query syntax]'
+    include_project_ids = [include_project_id]
+    scope = {
+        "include_project_ids": include_project_ids,
+        "include_gcp_public_datasets": include_gcp_public_datasets,
+    }
+
+    # Iterate over all results
+    for response_item in client.search_catalog(scope, query):
+        print(
+            u"Result type: {}".format(
+                enums.SearchResultType(response_item.search_result_type).name
+            )
+        )
+        print(u"Result subtype: {}".format(response_item.search_result_subtype))
+        print(
+            u"Relative resource name: {}".format(response_item.relative_resource_name)
+        )
+        print(u"Linked resource: {}\n".format(response_item.linked_resource))
+
+
+# [END datacatalog_search]
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "--include_project_id", type=str, default="[Google Cloud Project ID]"
+    )
+    parser.add_argument("--include_gcp_public_datasets", type=bool, default=False)
+    parser.add_argument("--query", type=str, default="[String in search query syntax]")
+    args = parser.parse_args()
+
+    sample_search_catalog(
+        args.include_project_id, args.include_gcp_public_datasets, args.query
+    )
+
+
+if __name__ == "__main__":
+    main()
diff --git a/datacatalog/setup.cfg b/datacatalog/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/datacatalog/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/datacatalog/setup.py b/datacatalog/setup.py
new file mode 100644
index 000000000000..29bbee31b9d8
--- /dev/null
+++ b/datacatalog/setup.py
@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-datacatalog"
+description = "Google Cloud Data Catalog API API client library"
+version = "0.3.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/googleapis/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/datacatalog/synth.metadata b/datacatalog/synth.metadata
new file mode 100644
index 000000000000..39cb85fb4bd1
--- /dev/null
+++ b/datacatalog/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-27T12:16:56.566500Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.35.1",
+        "dockerImage": "googleapis/artman@sha256:b11c7ea0d0831c54016fb50f4b796d24d1971439b30fbc32a369ba1ac887c384"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "650caad718bb063f189405c23972dc9818886358",
+        "internalRef": "265565344"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "datacatalog",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/datacatalog/artman_datacatalog_v1beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/datacatalog/synth.py b/datacatalog/synth.py
new file mode 100644
index 000000000000..468dc63c713d
--- /dev/null
+++ b/datacatalog/synth.py
@@ -0,0 +1,63 @@
+# 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 script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+version = 'v1beta1'
+
+# ----------------------------------------------------------------------------
+# Generate datacatalog GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    'datacatalog',
+    version,
+    config_path='/google/cloud/datacatalog/artman_datacatalog_v1beta1.yaml',
+    artman_output_name='datacatalog-v1beta1',
+    include_protos=True,
+    generator_args=["--dev_samples"],
+)
+
+s.move(
+    library,
+    excludes=[
+        'docs/conf.py',
+        'docs/index.rst',
+        'google/cloud/datacatalog_v1beta1/__init__.py',
+        'README.rst',
+        'nox*.py',
+        'setup.py',
+        'setup.cfg',
+    ],
+)
+
+# Fix docstring issue for classes with no summary line
+s.replace(
+    "google/cloud/**/proto/*_pb2.py",
+    '''__doc__ = """Attributes:''',
+    '''__doc__ = """
+    Attributes:''',
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=80, cov_level=80)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/datacatalog/tests/unit/gapic/v1beta1/test_data_catalog_client_v1beta1.py b/datacatalog/tests/unit/gapic/v1beta1/test_data_catalog_client_v1beta1.py
new file mode 100644
index 000000000000..35dc0b31db1a
--- /dev/null
+++ b/datacatalog/tests/unit/gapic/v1beta1/test_data_catalog_client_v1beta1.py
@@ -0,0 +1,879 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import datacatalog_v1beta1
+from google.cloud.datacatalog_v1beta1.proto import datacatalog_pb2
+from google.cloud.datacatalog_v1beta1.proto import search_pb2
+from google.cloud.datacatalog_v1beta1.proto import tags_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDataCatalogClient(object):
+    def test_search_catalog(self):
+        # Setup Expected Response
+        next_page_token = ""
+        results_element = {}
+        results = [results_element]
+        expected_response = {"next_page_token": next_page_token, "results": results}
+        expected_response = datacatalog_pb2.SearchCatalogResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        scope = {}
+        query = "query107944136"
+
+        paged_list_response = client.search_catalog(scope, query)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.SearchCatalogRequest(
+            scope=scope, query=query
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_catalog_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        scope = {}
+        query = "query107944136"
+
+        paged_list_response = client.search_catalog(scope, query)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_entry(self):
+        # Setup Expected Response
+        name = "name3373707"
+        linked_resource = "linkedResource1544625012"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "linked_resource": linked_resource,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = datacatalog_pb2.Entry(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        entry = {}
+
+        response = client.update_entry(entry)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.UpdateEntryRequest(entry=entry)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_entry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        entry = {}
+
+        with pytest.raises(CustomException):
+            client.update_entry(entry)
+
+    def test_get_entry(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        linked_resource = "linkedResource1544625012"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "linked_resource": linked_resource,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = datacatalog_pb2.Entry(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]")
+
+        response = client.get_entry(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.GetEntryRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_entry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.entry_path("[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]")
+
+        with pytest.raises(CustomException):
+            client.get_entry(name)
+
+    def test_lookup_entry(self):
+        # Setup Expected Response
+        name = "name3373707"
+        linked_resource = "linkedResource1544625012"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "linked_resource": linked_resource,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = datacatalog_pb2.Entry(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        response = client.lookup_entry()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.LookupEntryRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_lookup_entry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        with pytest.raises(CustomException):
+            client.lookup_entry()
+
+    def test_create_tag_template(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = tags_pb2.TagTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        tag_template_id = "tagTemplateId-2020335141"
+        tag_template = {}
+
+        response = client.create_tag_template(parent, tag_template_id, tag_template)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.CreateTagTemplateRequest(
+            parent=parent, tag_template_id=tag_template_id, tag_template=tag_template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_tag_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        tag_template_id = "tagTemplateId-2020335141"
+        tag_template = {}
+
+        with pytest.raises(CustomException):
+            client.create_tag_template(parent, tag_template_id, tag_template)
+
+    def test_get_tag_template(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = tags_pb2.TagTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+
+        response = client.get_tag_template(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.GetTagTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_tag_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+
+        with pytest.raises(CustomException):
+            client.get_tag_template(name)
+
+    def test_update_tag_template(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = tags_pb2.TagTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        tag_template = {}
+
+        response = client.update_tag_template(tag_template)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.UpdateTagTemplateRequest(
+            tag_template=tag_template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_tag_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        tag_template = {}
+
+        with pytest.raises(CustomException):
+            client.update_tag_template(tag_template)
+
+    def test_delete_tag_template(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        force = False
+
+        client.delete_tag_template(name, force)
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.DeleteTagTemplateRequest(
+            name=name, force=force
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_tag_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        force = False
+
+        with pytest.raises(CustomException):
+            client.delete_tag_template(name, force)
+
+    def test_create_tag_template_field(self):
+        # Setup Expected Response
+        display_name = "displayName1615086568"
+        expected_response = {"display_name": display_name}
+        expected_response = tags_pb2.TagTemplateField(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        parent = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        tag_template_field_id = "tagTemplateFieldId-92144832"
+        tag_template_field = {}
+
+        response = client.create_tag_template_field(
+            parent, tag_template_field_id, tag_template_field
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.CreateTagTemplateFieldRequest(
+            parent=parent,
+            tag_template_field_id=tag_template_field_id,
+            tag_template_field=tag_template_field,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_tag_template_field_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        parent = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        tag_template_field_id = "tagTemplateFieldId-92144832"
+        tag_template_field = {}
+
+        with pytest.raises(CustomException):
+            client.create_tag_template_field(
+                parent, tag_template_field_id, tag_template_field
+            )
+
+    def test_update_tag_template_field(self):
+        # Setup Expected Response
+        display_name = "displayName1615086568"
+        expected_response = {"display_name": display_name}
+        expected_response = tags_pb2.TagTemplateField(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.field_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]")
+        tag_template_field = {}
+
+        response = client.update_tag_template_field(name, tag_template_field)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.UpdateTagTemplateFieldRequest(
+            name=name, tag_template_field=tag_template_field
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_tag_template_field_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.field_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]")
+        tag_template_field = {}
+
+        with pytest.raises(CustomException):
+            client.update_tag_template_field(name, tag_template_field)
+
+    def test_rename_tag_template_field(self):
+        # Setup Expected Response
+        display_name = "displayName1615086568"
+        expected_response = {"display_name": display_name}
+        expected_response = tags_pb2.TagTemplateField(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.field_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]")
+        new_tag_template_field_id = "newTagTemplateFieldId-1668354591"
+
+        response = client.rename_tag_template_field(name, new_tag_template_field_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.RenameTagTemplateFieldRequest(
+            name=name, new_tag_template_field_id=new_tag_template_field_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rename_tag_template_field_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.field_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]")
+        new_tag_template_field_id = "newTagTemplateFieldId-1668354591"
+
+        with pytest.raises(CustomException):
+            client.rename_tag_template_field(name, new_tag_template_field_id)
+
+    def test_delete_tag_template_field(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.field_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]")
+        force = False
+
+        client.delete_tag_template_field(name, force)
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.DeleteTagTemplateFieldRequest(
+            name=name, force=force
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_tag_template_field_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.field_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]", "[FIELD]")
+        force = False
+
+        with pytest.raises(CustomException):
+            client.delete_tag_template_field(name, force)
+
+    def test_create_tag(self):
+        # Setup Expected Response
+        name = "name3373707"
+        template = "template-1321546630"
+        template_display_name = "templateDisplayName-532252787"
+        column = "column-1354837162"
+        expected_response = {
+            "name": name,
+            "template": template,
+            "template_display_name": template_display_name,
+            "column": column,
+        }
+        expected_response = tags_pb2.Tag(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        parent = client.entry_path(
+            "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]"
+        )
+        tag = {}
+
+        response = client.create_tag(parent, tag)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.CreateTagRequest(parent=parent, tag=tag)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_tag_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        parent = client.entry_path(
+            "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]"
+        )
+        tag = {}
+
+        with pytest.raises(CustomException):
+            client.create_tag(parent, tag)
+
+    def test_update_tag(self):
+        # Setup Expected Response
+        name = "name3373707"
+        template = "template-1321546630"
+        template_display_name = "templateDisplayName-532252787"
+        column = "column-1354837162"
+        expected_response = {
+            "name": name,
+            "template": template,
+            "template_display_name": template_display_name,
+            "column": column,
+        }
+        expected_response = tags_pb2.Tag(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        tag = {}
+
+        response = client.update_tag(tag)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.UpdateTagRequest(tag=tag)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_tag_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        tag = {}
+
+        with pytest.raises(CustomException):
+            client.update_tag(tag)
+
+    def test_delete_tag(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        name = client.tag_path(
+            "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]", "[TAG]"
+        )
+
+        client.delete_tag(name)
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.DeleteTagRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_tag_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        name = client.tag_path(
+            "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]", "[TAG]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_tag(name)
+
+    def test_list_tags(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tags_element = {}
+        tags = [tags_element]
+        expected_response = {"next_page_token": next_page_token, "tags": tags}
+        expected_response = datacatalog_pb2.ListTagsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        parent = client.entry_path(
+            "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]"
+        )
+
+        paged_list_response = client.list_tags(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tags[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = datacatalog_pb2.ListTagsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tags_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        parent = client.entry_path(
+            "[PROJECT]", "[LOCATION]", "[ENTRY_GROUP]", "[ENTRY]"
+        )
+
+        paged_list_response = client.list_tags(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        resource = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        resource = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        resource = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        resource = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup Request
+        resource = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datacatalog_v1beta1.DataCatalogClient()
+
+        # Setup request
+        resource = client.tag_template_path("[PROJECT]", "[LOCATION]", "[TAG_TEMPLATE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/datalabeling/.coveragerc b/datalabeling/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/datalabeling/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/datalabeling/.flake8 b/datalabeling/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/datalabeling/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/datalabeling/.gitignore b/datalabeling/.gitignore
new file mode 100644
index 000000000000..9e3a5f25770c
--- /dev/null
+++ b/datalabeling/.gitignore
@@ -0,0 +1 @@
+docs/_build
\ No newline at end of file
diff --git a/datalabeling/.repo-metadata.json b/datalabeling/.repo-metadata.json
new file mode 100644
index 000000000000..aa6fd203cb49
--- /dev/null
+++ b/datalabeling/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "datalabeling",
+  "name_pretty": "Google Cloud Data Labeling",
+  "product_documentation": "https://cloud.google.com/data-labeling/docs/",
+  "client_documentation": "https://googleapis.dev/python/datalabeling/latest",
+  "issue_tracker": "",
+  "release_level": "beta",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-datalabeling",
+  "api_id": "datalabeling.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/datalabeling/CHANGELOG.md b/datalabeling/CHANGELOG.md
new file mode 100644
index 000000000000..a97c3cab80fb
--- /dev/null
+++ b/datalabeling/CHANGELOG.md
@@ -0,0 +1,59 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-datalabeling/#history
+
+## 0.2.1
+
+07-16-2019 10:17 PDT
+
+
+### Implementation Changes
+- Import operations.proto (via synth). ([#8678](https://github.com/googleapis/google-cloud-python/pull/8678))
+
+### Documentation
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fix links in README.rst. ([#8626](https://github.com/googleapis/google-cloud-python/pull/8626))
+
+## 0.2.0
+
+07-09-2019 12:56 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8386](https://github.com/googleapis/google-cloud-python/pull/8386))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8504](https://github.com/googleapis/google-cloud-python/pull/8504))
+- [BREAKING] Remove audio type, add general_data type, blocking_resources (via synth). ([#8459](https://github.com/googleapis/google-cloud-python/pull/8459))
+
+### Documentation
+- Update index.rst ([#7764](https://github.com/googleapis/google-cloud-python/pull/7764))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8578](https://github.com/googleapis/google-cloud-python/pull/8578))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8348](https://github.com/googleapis/google-cloud-python/pull/8348))
+- Add disclaimer to auto-generated template files (via synth). ([#8310](https://github.com/googleapis/google-cloud-python/pull/8310))
+- Supress checking 'cov-fail-under' in nox default session (via synth). ([#8236](https://github.com/googleapis/google-cloud-python/pull/8236))
+- Fix coverage in 'types.py' (via synth). ([#8151](https://github.com/googleapis/google-cloud-python/pull/8151))
+- Blacken noxfile.py, setup.py (via synth). ([#8118](https://github.com/googleapis/google-cloud-python/pull/8118))
+- Add empty lines (via synth). ([#8053](https://github.com/googleapis/google-cloud-python/pull/8053))
+- Add nox session `docs`, reorder methods (via synth). ([#7767](https://github.com/googleapis/google-cloud-python/pull/7767))
+
+## 0.1.1
+
+04-02-2019 11:29 PDT
+
+### Internal / Testing Changes
+
+- Fix release classifier. ([#7643](https://github.com/googleapis/google-cloud-python/pull/7643))
+
+## 0.1.0
+
+04-01-2019 17:32 PDT
+
+### New Features
+
+- Create Data Labeling Python client. (#7635)
diff --git a/datalabeling/LICENSE b/datalabeling/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/datalabeling/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/datalabeling/MANIFEST.in b/datalabeling/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/datalabeling/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/datalabeling/README.rst b/datalabeling/README.rst
new file mode 100644
index 000000000000..068e1573eb49
--- /dev/null
+++ b/datalabeling/README.rst
@@ -0,0 +1,89 @@
+Python Client for Data Labeling API (`Beta`_)
+==============================================
+
+
+
+`Data Labeling API`_: Public API for Google Cloud AI Data Labeling Service.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Beta: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/README.rst
+.. _Data Labeling API: https://cloud.google.com/data-labeling
+.. _Client Library Documentation: https://googleapis.dev/python/datalabeling/latest
+.. _Product Documentation:  https://cloud.google.com/data-labeling/docs/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Data Labeling API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Data Labeling API.:  https://cloud.google.com/data-labeling
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Python >= 3.5
+
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-datalabeling
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-datalabeling
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Data Labeling API
+   API to see other available methods on the client.
+-  Read the `Data Labeling API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Data Labeling API Product documentation:  https://cloud.google.com/data-labeling/docs
+.. _repository’s main README: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/README.rst
diff --git a/datalabeling/docs/README.rst b/datalabeling/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/datalabeling/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/datalabeling/docs/changelog.md b/datalabeling/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/datalabeling/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/datalabeling/docs/conf.py b/datalabeling/docs/conf.py
new file mode 100644
index 000000000000..f4fc20a29491
--- /dev/null
+++ b/datalabeling/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-datalabeling documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-datalabeling"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-datalabeling-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-datalabeling.tex",
+        u"google-cloud-datalabeling Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-datalabeling",
+        u"google-cloud-datalabeling Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-datalabeling",
+        u"google-cloud-datalabeling Documentation",
+        author,
+        "google-cloud-datalabeling",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/datalabeling/docs/gapic/v1beta1/api.rst b/datalabeling/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..78258fac24c6
--- /dev/null
+++ b/datalabeling/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Data Labeling API
+============================
+
+.. automodule:: google.cloud.datalabeling_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/datalabeling/docs/gapic/v1beta1/types.rst b/datalabeling/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..07d64dc8da3b
--- /dev/null
+++ b/datalabeling/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Data Labeling API Client
+==================================
+
+.. automodule:: google.cloud.datalabeling_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/datalabeling/docs/index.rst b/datalabeling/docs/index.rst
new file mode 100644
index 000000000000..c7068aa8b15b
--- /dev/null
+++ b/datalabeling/docs/index.rst
@@ -0,0 +1,19 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+    
+Changelog
+---------
+
+For a list of all ``google-cloud-datalabeling`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/datalabeling/google/__init__.py b/datalabeling/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/datalabeling/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/datalabeling/google/cloud/__init__.py b/datalabeling/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/datalabeling/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/datalabeling/google/cloud/datalabeling.py b/datalabeling/google/cloud/datalabeling.py
new file mode 100644
index 000000000000..f852ea6c3b1a
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.datalabeling_v1beta1 import DataLabelingServiceClient
+from google.cloud.datalabeling_v1beta1 import enums
+from google.cloud.datalabeling_v1beta1 import types
+
+
+__all__ = ("enums", "types", "DataLabelingServiceClient")
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/__init__.py b/datalabeling/google/cloud/datalabeling_v1beta1/__init__.py
new file mode 100644
index 000000000000..908930d63de2
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/__init__.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.datalabeling_v1beta1 import types
+from google.cloud.datalabeling_v1beta1.gapic import data_labeling_service_client
+from google.cloud.datalabeling_v1beta1.gapic import enums
+
+
+class DataLabelingServiceClient(data_labeling_service_client.DataLabelingServiceClient):
+    __doc__ = data_labeling_service_client.DataLabelingServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DataLabelingServiceClient")
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/__init__.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py
new file mode 100644
index 000000000000..c4de47d05a63
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client.py
@@ -0,0 +1,3340 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.datalabeling.v1beta1 DataLabelingService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.datalabeling_v1beta1.gapic import data_labeling_service_client_config
+from google.cloud.datalabeling_v1beta1.gapic import enums
+from google.cloud.datalabeling_v1beta1.gapic.transports import (
+    data_labeling_service_grpc_transport,
+)
+from google.cloud.datalabeling_v1beta1.proto import annotation_spec_set_pb2
+from google.cloud.datalabeling_v1beta1.proto import data_labeling_service_pb2
+from google.cloud.datalabeling_v1beta1.proto import data_labeling_service_pb2_grpc
+from google.cloud.datalabeling_v1beta1.proto import dataset_pb2
+from google.cloud.datalabeling_v1beta1.proto import evaluation_job_pb2
+from google.cloud.datalabeling_v1beta1.proto import evaluation_pb2
+from google.cloud.datalabeling_v1beta1.proto import human_annotation_config_pb2
+from google.cloud.datalabeling_v1beta1.proto import instruction_pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    operations_pb2 as proto_operations_pb2,
+)
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-datalabeling"
+).version
+
+
+class DataLabelingServiceClient(object):
+    SERVICE_ADDRESS = "datalabeling.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.datalabeling.v1beta1.DataLabelingService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DataLabelingServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def annotated_dataset_path(cls, project, dataset, annotated_dataset):
+        """Return a fully-qualified annotated_dataset string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}",
+            project=project,
+            dataset=dataset,
+            annotated_dataset=annotated_dataset,
+        )
+
+    @classmethod
+    def annotation_spec_set_path(cls, project, annotation_spec_set):
+        """Return a fully-qualified annotation_spec_set string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/annotationSpecSets/{annotation_spec_set}",
+            project=project,
+            annotation_spec_set=annotation_spec_set,
+        )
+
+    @classmethod
+    def data_item_path(cls, project, dataset, data_item):
+        """Return a fully-qualified data_item string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/datasets/{dataset}/dataItems/{data_item}",
+            project=project,
+            dataset=dataset,
+            data_item=data_item,
+        )
+
+    @classmethod
+    def dataset_path(cls, project, dataset):
+        """Return a fully-qualified dataset string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/datasets/{dataset}", project=project, dataset=dataset
+        )
+
+    @classmethod
+    def evaluation_path(cls, project, dataset, evaluation):
+        """Return a fully-qualified evaluation string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/datasets/{dataset}/evaluations/{evaluation}",
+            project=project,
+            dataset=dataset,
+            evaluation=evaluation,
+        )
+
+    @classmethod
+    def evaluation_job_path(cls, project, evaluation_job):
+        """Return a fully-qualified evaluation_job string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/evaluationJobs/{evaluation_job}",
+            project=project,
+            evaluation_job=evaluation_job,
+        )
+
+    @classmethod
+    def example_path(cls, project, dataset, annotated_dataset, example):
+        """Return a fully-qualified example string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}/examples/{example}",
+            project=project,
+            dataset=dataset,
+            annotated_dataset=annotated_dataset,
+            example=example,
+        )
+
+    @classmethod
+    def instruction_path(cls, project, instruction):
+        """Return a fully-qualified instruction string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instructions/{instruction}",
+            project=project,
+            instruction=instruction,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DataLabelingServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DataLabelingServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = data_labeling_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=data_labeling_service_grpc_transport.DataLabelingServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = data_labeling_service_grpc_transport.DataLabelingServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_dataset(
+        self,
+        parent,
+        dataset,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates dataset. If success return a Dataset resource.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `dataset`:
+            >>> dataset = {}
+            >>>
+            >>> response = client.create_dataset(parent, dataset)
+
+        Args:
+            parent (str): Required. Dataset resource parent, format: projects/{project\_id}
+            dataset (Union[dict, ~google.cloud.datalabeling_v1beta1.types.Dataset]): Required. The dataset to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.Dataset`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_dataset,
+                default_retry=self._method_configs["CreateDataset"].retry,
+                default_timeout=self._method_configs["CreateDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.CreateDatasetRequest(
+            parent=parent, dataset=dataset
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_dataset(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets dataset by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> response = client.get_dataset(name)
+
+        Args:
+            name (str): Required. Dataset resource name, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.Dataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_dataset,
+                default_retry=self._method_configs["GetDataset"].retry,
+                default_timeout=self._method_configs["GetDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetDatasetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_datasets(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists datasets under a project. Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_datasets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_datasets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Dataset resource parent, format: projects/{project\_id}
+            filter_ (str): Optional. Filter on dataset is not supported at this moment.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.Dataset` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_datasets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_datasets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_datasets,
+                default_retry=self._method_configs["ListDatasets"].retry,
+                default_timeout=self._method_configs["ListDatasets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListDatasetsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_datasets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="datasets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_dataset(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a dataset by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> client.delete_dataset(name)
+
+        Args:
+            name (str): Required. Dataset resource name, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_dataset,
+                default_retry=self._method_configs["DeleteDataset"].retry,
+                default_timeout=self._method_configs["DeleteDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.DeleteDatasetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def import_data(
+        self,
+        name,
+        input_config,
+        user_email_address=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Imports data into dataset based on source locations defined in request.
+        It can be called multiple times for the same dataset. Each dataset can
+        only have one long running operation running on it. For example, no
+        labeling task (also long running operation) can be started while
+        importing is still ongoing. Vice versa.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_data(name, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. Dataset resource name, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            input_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.InputConfig]): Required. Specify the input source of the data.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.InputConfig`
+            user_email_address (str): Email of the user who started the import task and should be notified by
+                email. If empty no notification will be sent.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_data" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_data"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_data,
+                default_retry=self._method_configs["ImportData"].retry,
+                default_timeout=self._method_configs["ImportData"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ImportDataRequest(
+            name=name, input_config=input_config, user_email_address=user_email_address
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_data"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            proto_operations_pb2.ImportDataOperationResponse,
+            metadata_type=proto_operations_pb2.ImportDataOperationMetadata,
+        )
+
+    def export_data(
+        self,
+        name,
+        annotated_dataset,
+        output_config,
+        filter_=None,
+        user_email_address=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Exports data and annotations from dataset.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `annotated_dataset`:
+            >>> annotated_dataset = ''
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_data(name, annotated_dataset, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. Dataset resource name, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            annotated_dataset (str): 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}
+            output_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.OutputConfig]): Required. Specify the output destination.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.OutputConfig`
+            filter_ (str): Optional. Filter is not supported at this moment.
+            user_email_address (str): Email of the user who started the export task and should be notified by
+                email. If empty no notification will be sent.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_data" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_data"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_data,
+                default_retry=self._method_configs["ExportData"].retry,
+                default_timeout=self._method_configs["ExportData"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ExportDataRequest(
+            name=name,
+            annotated_dataset=annotated_dataset,
+            output_config=output_config,
+            filter=filter_,
+            user_email_address=user_email_address,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_data"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            proto_operations_pb2.ExportDataOperationResponse,
+            metadata_type=proto_operations_pb2.ExportDataOperationMetadata,
+        )
+
+    def get_data_item(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a data item in a dataset by resource name. This API can be
+        called after data are imported into dataset.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.data_item_path('[PROJECT]', '[DATASET]', '[DATA_ITEM]')
+            >>>
+            >>> response = client.get_data_item(name)
+
+        Args:
+            name (str): Required. The name of the data item to get, format:
+                projects/{project\_id}/datasets/{dataset\_id}/dataItems/{data\_item\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.DataItem` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_data_item" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_data_item"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_data_item,
+                default_retry=self._method_configs["GetDataItem"].retry,
+                default_timeout=self._method_configs["GetDataItem"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetDataItemRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_data_item"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_data_items(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists data items in a dataset. This API can be called after data
+        are imported into dataset. Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_data_items(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_data_items(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Name of the dataset to list data items, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            filter_ (str): Optional. Filter is not supported at this moment.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.DataItem` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_data_items" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_data_items"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_data_items,
+                default_retry=self._method_configs["ListDataItems"].retry,
+                default_timeout=self._method_configs["ListDataItems"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListDataItemsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_data_items"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="data_items",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_annotated_dataset(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an annotated dataset by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.annotated_dataset_path('[PROJECT]', '[DATASET]', '[ANNOTATED_DATASET]')
+            >>>
+            >>> response = client.get_annotated_dataset(name)
+
+        Args:
+            name (str): Required. Name of the annotated dataset to get, format:
+                projects/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/
+                {annotated\_dataset\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.AnnotatedDataset` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_annotated_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_annotated_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_annotated_dataset,
+                default_retry=self._method_configs["GetAnnotatedDataset"].retry,
+                default_timeout=self._method_configs["GetAnnotatedDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetAnnotatedDatasetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_annotated_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_annotated_datasets(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists annotated datasets for a dataset. Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_annotated_datasets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_annotated_datasets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Name of the dataset to list annotated datasets, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            filter_ (str): Optional. Filter is not supported at this moment.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.AnnotatedDataset` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_annotated_datasets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_annotated_datasets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_annotated_datasets,
+                default_retry=self._method_configs["ListAnnotatedDatasets"].retry,
+                default_timeout=self._method_configs["ListAnnotatedDatasets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListAnnotatedDatasetsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_annotated_datasets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="annotated_datasets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def label_image(
+        self,
+        parent,
+        basic_config,
+        feature,
+        image_classification_config=None,
+        bounding_poly_config=None,
+        polyline_config=None,
+        segmentation_config=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a labeling task for image. The type of image labeling task is
+        configured by feature in the request.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>> from google.cloud.datalabeling_v1beta1 import enums
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `basic_config`:
+            >>> basic_config = {}
+            >>>
+            >>> # TODO: Initialize `feature`:
+            >>> feature = enums.LabelImageRequest.Feature.FEATURE_UNSPECIFIED
+            >>>
+            >>> response = client.label_image(parent, basic_config, feature)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. Name of the dataset to request labeling task, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            basic_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.HumanAnnotationConfig]): Required. Basic human annotation config.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.HumanAnnotationConfig`
+            feature (~google.cloud.datalabeling_v1beta1.types.Feature): Required. The type of image labeling task.
+            image_classification_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.ImageClassificationConfig]): Configuration for image classification task. One of
+                image\_classification\_config, bounding\_poly\_config, polyline\_config
+                and segmentation\_config are required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.ImageClassificationConfig`
+            bounding_poly_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.BoundingPolyConfig]): Configuration for bounding box and bounding poly task. One of
+                image\_classification\_config, bounding\_poly\_config, polyline\_config
+                and segmentation\_config are required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.BoundingPolyConfig`
+            polyline_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.PolylineConfig]): Configuration for polyline task. One of image\_classification\_config,
+                bounding\_poly\_config, polyline\_config and segmentation\_config are
+                required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.PolylineConfig`
+            segmentation_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.SegmentationConfig]): Configuration for segmentation task. One of
+                image\_classification\_config, bounding\_poly\_config, polyline\_config
+                and segmentation\_config are required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.SegmentationConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "label_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "label_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.label_image,
+                default_retry=self._method_configs["LabelImage"].retry,
+                default_timeout=self._method_configs["LabelImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            image_classification_config=image_classification_config,
+            bounding_poly_config=bounding_poly_config,
+            polyline_config=polyline_config,
+            segmentation_config=segmentation_config,
+        )
+
+        request = data_labeling_service_pb2.LabelImageRequest(
+            parent=parent,
+            basic_config=basic_config,
+            feature=feature,
+            image_classification_config=image_classification_config,
+            bounding_poly_config=bounding_poly_config,
+            polyline_config=polyline_config,
+            segmentation_config=segmentation_config,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["label_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            dataset_pb2.AnnotatedDataset,
+            metadata_type=proto_operations_pb2.LabelOperationMetadata,
+        )
+
+    def label_video(
+        self,
+        parent,
+        basic_config,
+        feature,
+        video_classification_config=None,
+        object_detection_config=None,
+        object_tracking_config=None,
+        event_config=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a labeling task for video. The type of video labeling task is
+        configured by feature in the request.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>> from google.cloud.datalabeling_v1beta1 import enums
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `basic_config`:
+            >>> basic_config = {}
+            >>>
+            >>> # TODO: Initialize `feature`:
+            >>> feature = enums.LabelVideoRequest.Feature.FEATURE_UNSPECIFIED
+            >>>
+            >>> response = client.label_video(parent, basic_config, feature)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. Name of the dataset to request labeling task, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            basic_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.HumanAnnotationConfig]): Required. Basic human annotation config.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.HumanAnnotationConfig`
+            feature (~google.cloud.datalabeling_v1beta1.types.Feature): Required. The type of video labeling task.
+            video_classification_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.VideoClassificationConfig]): Configuration for video classification task. One of
+                video\_classification\_config, object\_detection\_config,
+                object\_tracking\_config and event\_config is required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.VideoClassificationConfig`
+            object_detection_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.ObjectDetectionConfig]): Configuration for video object detection task. One of
+                video\_classification\_config, object\_detection\_config,
+                object\_tracking\_config and event\_config is required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.ObjectDetectionConfig`
+            object_tracking_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.ObjectTrackingConfig]): Configuration for video object tracking task. One of
+                video\_classification\_config, object\_detection\_config,
+                object\_tracking\_config and event\_config is required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.ObjectTrackingConfig`
+            event_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.EventConfig]): Configuration for video event task. One of
+                video\_classification\_config, object\_detection\_config,
+                object\_tracking\_config and event\_config is required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.EventConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "label_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "label_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.label_video,
+                default_retry=self._method_configs["LabelVideo"].retry,
+                default_timeout=self._method_configs["LabelVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            video_classification_config=video_classification_config,
+            object_detection_config=object_detection_config,
+            object_tracking_config=object_tracking_config,
+            event_config=event_config,
+        )
+
+        request = data_labeling_service_pb2.LabelVideoRequest(
+            parent=parent,
+            basic_config=basic_config,
+            feature=feature,
+            video_classification_config=video_classification_config,
+            object_detection_config=object_detection_config,
+            object_tracking_config=object_tracking_config,
+            event_config=event_config,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["label_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            dataset_pb2.AnnotatedDataset,
+            metadata_type=proto_operations_pb2.LabelOperationMetadata,
+        )
+
+    def label_text(
+        self,
+        parent,
+        basic_config,
+        feature,
+        text_classification_config=None,
+        text_entity_extraction_config=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a labeling task for text. The type of text labeling task is
+        configured by feature in the request.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>> from google.cloud.datalabeling_v1beta1 import enums
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.dataset_path('[PROJECT]', '[DATASET]')
+            >>>
+            >>> # TODO: Initialize `basic_config`:
+            >>> basic_config = {}
+            >>>
+            >>> # TODO: Initialize `feature`:
+            >>> feature = enums.LabelTextRequest.Feature.FEATURE_UNSPECIFIED
+            >>>
+            >>> response = client.label_text(parent, basic_config, feature)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. Name of the data set to request labeling task, format:
+                projects/{project\_id}/datasets/{dataset\_id}
+            basic_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.HumanAnnotationConfig]): Required. Basic human annotation config.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.HumanAnnotationConfig`
+            feature (~google.cloud.datalabeling_v1beta1.types.Feature): Required. The type of text labeling task.
+            text_classification_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.TextClassificationConfig]): Configuration for text classification task. One of
+                text\_classification\_config and text\_entity\_extraction\_config is
+                required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.TextClassificationConfig`
+            text_entity_extraction_config (Union[dict, ~google.cloud.datalabeling_v1beta1.types.TextEntityExtractionConfig]): Configuration for entity extraction task. One of
+                text\_classification\_config and text\_entity\_extraction\_config is
+                required.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.TextEntityExtractionConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "label_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "label_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.label_text,
+                default_retry=self._method_configs["LabelText"].retry,
+                default_timeout=self._method_configs["LabelText"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            text_classification_config=text_classification_config,
+            text_entity_extraction_config=text_entity_extraction_config,
+        )
+
+        request = data_labeling_service_pb2.LabelTextRequest(
+            parent=parent,
+            basic_config=basic_config,
+            feature=feature,
+            text_classification_config=text_classification_config,
+            text_entity_extraction_config=text_entity_extraction_config,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["label_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            dataset_pb2.AnnotatedDataset,
+            metadata_type=proto_operations_pb2.LabelOperationMetadata,
+        )
+
+    def get_example(
+        self,
+        name,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an example by resource name, including both data and annotation.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.example_path('[PROJECT]', '[DATASET]', '[ANNOTATED_DATASET]', '[EXAMPLE]')
+            >>>
+            >>> response = client.get_example(name)
+
+        Args:
+            name (str): Required. Name of example, format:
+                projects/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/
+                {annotated\_dataset\_id}/examples/{example\_id}
+            filter_ (str): Optional. An expression for filtering Examples. Filter by
+                annotation\_spec.display\_name is supported. Format
+                "annotation\_spec.display\_name = {display\_name}"
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.Example` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_example" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_example"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_example,
+                default_retry=self._method_configs["GetExample"].retry,
+                default_timeout=self._method_configs["GetExample"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetExampleRequest(name=name, filter=filter_)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_example"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_examples(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists examples in an annotated dataset. Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.annotated_dataset_path('[PROJECT]', '[DATASET]', '[ANNOTATED_DATASET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_examples(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_examples(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Example resource parent.
+            filter_ (str): 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}"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.Example` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_examples" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_examples"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_examples,
+                default_retry=self._method_configs["ListExamples"].retry,
+                default_timeout=self._method_configs["ListExamples"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListExamplesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_examples"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="examples",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_annotation_spec_set(
+        self,
+        parent,
+        annotation_spec_set,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an annotation spec set by providing a set of labels.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `annotation_spec_set`:
+            >>> annotation_spec_set = {}
+            >>>
+            >>> response = client.create_annotation_spec_set(parent, annotation_spec_set)
+
+        Args:
+            parent (str): Required. AnnotationSpecSet resource parent, format:
+                projects/{project\_id}
+            annotation_spec_set (Union[dict, ~google.cloud.datalabeling_v1beta1.types.AnnotationSpecSet]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.AnnotationSpecSet`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.AnnotationSpecSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_annotation_spec_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_annotation_spec_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_annotation_spec_set,
+                default_retry=self._method_configs["CreateAnnotationSpecSet"].retry,
+                default_timeout=self._method_configs["CreateAnnotationSpecSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.CreateAnnotationSpecSetRequest(
+            parent=parent, annotation_spec_set=annotation_spec_set
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_annotation_spec_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_annotation_spec_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an annotation spec set by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.annotation_spec_set_path('[PROJECT]', '[ANNOTATION_SPEC_SET]')
+            >>>
+            >>> response = client.get_annotation_spec_set(name)
+
+        Args:
+            name (str): Required. AnnotationSpecSet resource name, format:
+                projects/{project\_id}/annotationSpecSets/{annotation\_spec\_set\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.AnnotationSpecSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_annotation_spec_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_annotation_spec_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_annotation_spec_set,
+                default_retry=self._method_configs["GetAnnotationSpecSet"].retry,
+                default_timeout=self._method_configs["GetAnnotationSpecSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetAnnotationSpecSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_annotation_spec_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_annotation_spec_sets(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists annotation spec sets for a project. Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_annotation_spec_sets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_annotation_spec_sets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Parent of AnnotationSpecSet resource, format:
+                projects/{project\_id}
+            filter_ (str): Optional. Filter is not supported at this moment.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.AnnotationSpecSet` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_annotation_spec_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_annotation_spec_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_annotation_spec_sets,
+                default_retry=self._method_configs["ListAnnotationSpecSets"].retry,
+                default_timeout=self._method_configs["ListAnnotationSpecSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListAnnotationSpecSetsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_annotation_spec_sets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="annotation_spec_sets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_annotation_spec_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an annotation spec set by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.annotation_spec_set_path('[PROJECT]', '[ANNOTATION_SPEC_SET]')
+            >>>
+            >>> client.delete_annotation_spec_set(name)
+
+        Args:
+            name (str): Required. AnnotationSpec resource name, format:
+                ``projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_annotation_spec_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_annotation_spec_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_annotation_spec_set,
+                default_retry=self._method_configs["DeleteAnnotationSpecSet"].retry,
+                default_timeout=self._method_configs["DeleteAnnotationSpecSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.DeleteAnnotationSpecSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_annotation_spec_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_instruction(
+        self,
+        parent,
+        instruction,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an instruction for how data should be labeled.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `instruction`:
+            >>> instruction = {}
+            >>>
+            >>> response = client.create_instruction(parent, instruction)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. Instruction resource parent, format: projects/{project\_id}
+            instruction (Union[dict, ~google.cloud.datalabeling_v1beta1.types.Instruction]): Required. Instruction of how to perform the labeling task.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.Instruction`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_instruction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_instruction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_instruction,
+                default_retry=self._method_configs["CreateInstruction"].retry,
+                default_timeout=self._method_configs["CreateInstruction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.CreateInstructionRequest(
+            parent=parent, instruction=instruction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_instruction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            instruction_pb2.Instruction,
+            metadata_type=proto_operations_pb2.CreateInstructionMetadata,
+        )
+
+    def get_instruction(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an instruction by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.instruction_path('[PROJECT]', '[INSTRUCTION]')
+            >>>
+            >>> response = client.get_instruction(name)
+
+        Args:
+            name (str): Required. Instruction resource name, format:
+                projects/{project\_id}/instructions/{instruction\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.Instruction` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_instruction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_instruction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_instruction,
+                default_retry=self._method_configs["GetInstruction"].retry,
+                default_timeout=self._method_configs["GetInstruction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetInstructionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_instruction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_instructions(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists instructions for a project. Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_instructions(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_instructions(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Instruction resource parent, format: projects/{project\_id}
+            filter_ (str): Optional. Filter is not supported at this moment.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.Instruction` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_instructions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_instructions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_instructions,
+                default_retry=self._method_configs["ListInstructions"].retry,
+                default_timeout=self._method_configs["ListInstructions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListInstructionsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_instructions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="instructions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_instruction(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an instruction object by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.instruction_path('[PROJECT]', '[INSTRUCTION]')
+            >>>
+            >>> client.delete_instruction(name)
+
+        Args:
+            name (str): Required. Instruction resource name, format:
+                projects/{project\_id}/instructions/{instruction\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_instruction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_instruction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_instruction,
+                default_retry=self._method_configs["DeleteInstruction"].retry,
+                default_timeout=self._method_configs["DeleteInstruction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.DeleteInstructionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_instruction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_evaluation(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an evaluation by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.evaluation_path('[PROJECT]', '[DATASET]', '[EVALUATION]')
+            >>>
+            >>> response = client.get_evaluation(name)
+
+        Args:
+            name (str): Required. Name of the evaluation. Format:
+                'projects/{project\_id}/datasets/{dataset\_id}/evaluations/{evaluation\_id}'
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.Evaluation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_evaluation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_evaluation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_evaluation,
+                default_retry=self._method_configs["GetEvaluation"].retry,
+                default_timeout=self._method_configs["GetEvaluation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetEvaluationRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_evaluation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_evaluations(
+        self,
+        parent,
+        filter_,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Searchs evaluations within a project. Supported filter: evaluation\_job,
+        evaluation\_time.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_evaluations(parent, filter_):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_evaluations(parent, filter_).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Evaluation search parent. Format: projects/{project\_id}
+            filter_ (str): 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}"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.Evaluation` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_evaluations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_evaluations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_evaluations,
+                default_retry=self._method_configs["SearchEvaluations"].retry,
+                default_timeout=self._method_configs["SearchEvaluations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.SearchEvaluationsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_evaluations"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="evaluations",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def search_example_comparisons(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.evaluation_path('[PROJECT]', '[DATASET]', '[EVALUATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_example_comparisons(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_example_comparisons(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Name of the Evaluation resource to search example comparison
+                from. Format:
+                projects/{project\_id}/datasets/{dataset\_id}/evaluations/{evaluation\_id}
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.ExampleComparison` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_example_comparisons" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_example_comparisons"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_example_comparisons,
+                default_retry=self._method_configs["SearchExampleComparisons"].retry,
+                default_timeout=self._method_configs[
+                    "SearchExampleComparisons"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.SearchExampleComparisonsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_example_comparisons"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="example_comparisons",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_evaluation_job(
+        self,
+        parent,
+        job,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an evaluation job.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.create_evaluation_job(parent, job)
+
+        Args:
+            parent (str): Required. Evaluation job resource parent, format:
+                projects/{project\_id}.
+            job (Union[dict, ~google.cloud.datalabeling_v1beta1.types.EvaluationJob]): Required. The evaluation job to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.EvaluationJob`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.EvaluationJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_evaluation_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_evaluation_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_evaluation_job,
+                default_retry=self._method_configs["CreateEvaluationJob"].retry,
+                default_timeout=self._method_configs["CreateEvaluationJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.CreateEvaluationJobRequest(
+            parent=parent, job=job
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_evaluation_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_evaluation_job(
+        self,
+        evaluation_job,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an evaluation job.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> # TODO: Initialize `evaluation_job`:
+            >>> evaluation_job = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_evaluation_job(evaluation_job, update_mask)
+
+        Args:
+            evaluation_job (Union[dict, ~google.cloud.datalabeling_v1beta1.types.EvaluationJob]): Required. Evaluation job that is going to be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.EvaluationJob`
+            update_mask (Union[dict, ~google.cloud.datalabeling_v1beta1.types.FieldMask]): Optional. Mask for which field in evaluation\_job should be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datalabeling_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.EvaluationJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_evaluation_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_evaluation_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_evaluation_job,
+                default_retry=self._method_configs["UpdateEvaluationJob"].retry,
+                default_timeout=self._method_configs["UpdateEvaluationJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.UpdateEvaluationJobRequest(
+            evaluation_job=evaluation_job, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("evaluation_job.name", evaluation_job.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_evaluation_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_evaluation_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an evaluation job by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.evaluation_job_path('[PROJECT]', '[EVALUATION_JOB]')
+            >>>
+            >>> response = client.get_evaluation_job(name)
+
+        Args:
+            name (str): Required. Name of the evaluation job. Format:
+                'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datalabeling_v1beta1.types.EvaluationJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_evaluation_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_evaluation_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_evaluation_job,
+                default_retry=self._method_configs["GetEvaluationJob"].retry,
+                default_timeout=self._method_configs["GetEvaluationJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.GetEvaluationJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_evaluation_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pause_evaluation_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pauses an evaluation job. Pausing a evaluation job that is already in
+        PAUSED state will be a no-op.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.evaluation_job_path('[PROJECT]', '[EVALUATION_JOB]')
+            >>>
+            >>> client.pause_evaluation_job(name)
+
+        Args:
+            name (str): Required. Name of the evaluation job that is going to be paused. Format:
+                'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pause_evaluation_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "pause_evaluation_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pause_evaluation_job,
+                default_retry=self._method_configs["PauseEvaluationJob"].retry,
+                default_timeout=self._method_configs["PauseEvaluationJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.PauseEvaluationJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["pause_evaluation_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def resume_evaluation_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Resumes a paused evaluation job. Deleted evaluation job can't be resumed.
+        Resuming a running evaluation job will be a no-op.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.evaluation_job_path('[PROJECT]', '[EVALUATION_JOB]')
+            >>>
+            >>> client.resume_evaluation_job(name)
+
+        Args:
+            name (str): Required. Name of the evaluation job that is going to be resumed.
+                Format: 'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "resume_evaluation_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "resume_evaluation_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.resume_evaluation_job,
+                default_retry=self._method_configs["ResumeEvaluationJob"].retry,
+                default_timeout=self._method_configs["ResumeEvaluationJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ResumeEvaluationJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["resume_evaluation_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_evaluation_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Stops and deletes an evaluation job.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> name = client.evaluation_job_path('[PROJECT]', '[EVALUATION_JOB]')
+            >>>
+            >>> client.delete_evaluation_job(name)
+
+        Args:
+            name (str): Required. Name of the evaluation job that is going to be deleted.
+                Format: 'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_evaluation_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_evaluation_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_evaluation_job,
+                default_retry=self._method_configs["DeleteEvaluationJob"].retry,
+                default_timeout=self._method_configs["DeleteEvaluationJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.DeleteEvaluationJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_evaluation_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_evaluation_jobs(
+        self,
+        parent,
+        filter_,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all evaluation jobs within a project with possible filters.
+        Pagination is supported.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_evaluation_jobs(parent, filter_):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_evaluation_jobs(parent, filter_).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Evaluation resource parent. Format: "projects/{project\_id}"
+            filter_ (str): Optional. Only support filter by model id and job state. Format:
+                "evaluation\_job.model\_id = {model\_id} AND evaluation\_job.state =
+                {EvaluationJob::State}"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.datalabeling_v1beta1.types.EvaluationJob` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_evaluation_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_evaluation_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_evaluation_jobs,
+                default_retry=self._method_configs["ListEvaluationJobs"].retry,
+                default_timeout=self._method_configs["ListEvaluationJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.ListEvaluationJobsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_evaluation_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="evaluation_jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_annotated_dataset(
+        self,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an annotated dataset by resource name.
+
+        Example:
+            >>> from google.cloud import datalabeling_v1beta1
+            >>>
+            >>> client = datalabeling_v1beta1.DataLabelingServiceClient()
+            >>>
+            >>> client.delete_annotated_dataset()
+
+        Args:
+            name (str): Required. Name of the annotated dataset to delete, format:
+                projects/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/
+                {annotated\_dataset\_id}
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_annotated_dataset" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_annotated_dataset"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_annotated_dataset,
+                default_retry=self._method_configs["DeleteAnnotatedDataset"].retry,
+                default_timeout=self._method_configs["DeleteAnnotatedDataset"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = data_labeling_service_pb2.DeleteAnnotatedDatasetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_annotated_dataset"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client_config.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client_config.py
new file mode 100644
index 000000000000..2c22921218c2
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/data_labeling_service_client_config.py
@@ -0,0 +1,193 @@
+config = {
+    "interfaces": {
+        "google.cloud.datalabeling.v1beta1.DataLabelingService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 300000,
+                }
+            },
+            "methods": {
+                "CreateDataset": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDataset": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDatasets": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDataset": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportData": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportData": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDataItem": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDataItems": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetAnnotatedDataset": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListAnnotatedDatasets": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "LabelImage": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "LabelVideo": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "LabelText": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetExample": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListExamples": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateAnnotationSpecSet": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetAnnotationSpecSet": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListAnnotationSpecSets": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteAnnotationSpecSet": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateInstruction": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetInstruction": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListInstructions": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteInstruction": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetEvaluation": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchEvaluations": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchExampleComparisons": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateEvaluationJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateEvaluationJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetEvaluationJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PauseEvaluationJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ResumeEvaluationJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteEvaluationJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListEvaluationJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteAnnotatedDataset": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/enums.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..c066882020ac
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/enums.py
@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class AnnotationSentiment(enum.IntEnum):
+    """
+    Attributes:
+      ANNOTATION_SENTIMENT_UNSPECIFIED (int)
+      NEGATIVE (int): This annotation describes negatively about the data.
+      POSITIVE (int): This label describes positively about the data.
+    """
+
+    ANNOTATION_SENTIMENT_UNSPECIFIED = 0
+    NEGATIVE = 1
+    POSITIVE = 2
+
+
+class AnnotationSource(enum.IntEnum):
+    """
+    Specifies where is the answer from.
+
+    Attributes:
+      ANNOTATION_SOURCE_UNSPECIFIED (int)
+      OPERATOR (int): Answer is provided by a human contributor.
+    """
+
+    ANNOTATION_SOURCE_UNSPECIFIED = 0
+    OPERATOR = 3
+
+
+class AnnotationType(enum.IntEnum):
+    """
+    Attributes:
+      ANNOTATION_TYPE_UNSPECIFIED (int)
+      IMAGE_CLASSIFICATION_ANNOTATION (int): Classification annotations in an image.
+      IMAGE_BOUNDING_BOX_ANNOTATION (int): Bounding box annotations in an image.
+      IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION (int): Oriented bounding box. The box does not have to be parallel to horizontal
+      line.
+      IMAGE_BOUNDING_POLY_ANNOTATION (int): Bounding poly annotations in an image.
+      IMAGE_POLYLINE_ANNOTATION (int): Polyline annotations in an image.
+      IMAGE_SEGMENTATION_ANNOTATION (int): Segmentation annotations in an image.
+      VIDEO_SHOTS_CLASSIFICATION_ANNOTATION (int): Classification annotations in video shots.
+      VIDEO_OBJECT_TRACKING_ANNOTATION (int): Video object tracking annotation.
+      VIDEO_OBJECT_DETECTION_ANNOTATION (int): Video object detection annotation.
+      VIDEO_EVENT_ANNOTATION (int): Video event annotation.
+      TEXT_CLASSIFICATION_ANNOTATION (int): Classification for text.
+      TEXT_ENTITY_EXTRACTION_ANNOTATION (int): Entity extraction for text.
+      GENERAL_CLASSIFICATION_ANNOTATION (int): General classification.
+    """
+
+    ANNOTATION_TYPE_UNSPECIFIED = 0
+    IMAGE_CLASSIFICATION_ANNOTATION = 1
+    IMAGE_BOUNDING_BOX_ANNOTATION = 2
+    IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION = 13
+    IMAGE_BOUNDING_POLY_ANNOTATION = 10
+    IMAGE_POLYLINE_ANNOTATION = 11
+    IMAGE_SEGMENTATION_ANNOTATION = 12
+    VIDEO_SHOTS_CLASSIFICATION_ANNOTATION = 3
+    VIDEO_OBJECT_TRACKING_ANNOTATION = 4
+    VIDEO_OBJECT_DETECTION_ANNOTATION = 5
+    VIDEO_EVENT_ANNOTATION = 6
+    TEXT_CLASSIFICATION_ANNOTATION = 8
+    TEXT_ENTITY_EXTRACTION_ANNOTATION = 9
+    GENERAL_CLASSIFICATION_ANNOTATION = 14
+
+
+class DataType(enum.IntEnum):
+    """
+    Attributes:
+      DATA_TYPE_UNSPECIFIED (int)
+      IMAGE (int)
+      VIDEO (int)
+      TEXT (int)
+      GENERAL_DATA (int)
+    """
+
+    DATA_TYPE_UNSPECIFIED = 0
+    IMAGE = 1
+    VIDEO = 2
+    TEXT = 4
+    GENERAL_DATA = 6
+
+
+class StringAggregationType(enum.IntEnum):
+    """
+    Attributes:
+      STRING_AGGREGATION_TYPE_UNSPECIFIED (int)
+      MAJORITY_VOTE (int): Majority vote to aggregate answers.
+      UNANIMOUS_VOTE (int): Unanimous answers will be adopted.
+      NO_AGGREGATION (int): Preserve all answers by crowd compute.
+    """
+
+    STRING_AGGREGATION_TYPE_UNSPECIFIED = 0
+    MAJORITY_VOTE = 1
+    UNANIMOUS_VOTE = 2
+    NO_AGGREGATION = 3
+
+
+class EvaluationJob(object):
+    class State(enum.IntEnum):
+        """
+        State of the job.
+
+        Attributes:
+          STATE_UNSPECIFIED (int)
+          SCHEDULED (int)
+          RUNNING (int)
+          PAUSED (int)
+          STOPPED (int)
+        """
+
+        STATE_UNSPECIFIED = 0
+        SCHEDULED = 1
+        RUNNING = 2
+        PAUSED = 3
+        STOPPED = 4
+
+
+class LabelImageRequest(object):
+    class Feature(enum.IntEnum):
+        """
+        Image labeling task feature.
+
+        Attributes:
+          FEATURE_UNSPECIFIED (int)
+          CLASSIFICATION (int): Label whole image with one or more of labels.
+          BOUNDING_BOX (int): Label image with bounding boxes for labels.
+          ORIENTED_BOUNDING_BOX (int): Label oriented bounding box. The box does not have to be parallel to
+          horizontal line.
+          BOUNDING_POLY (int): Label images with bounding poly. A bounding poly is a plane figure that
+          is bounded by a finite chain of straight line segments closing in a loop.
+          POLYLINE (int): Label images with polyline. Polyline is formed by connected line segments
+          which are not in closed form.
+          SEGMENTATION (int): Label images with segmentation. Segmentation is different from bounding
+          poly since it is more fine-grained, pixel level annotation.
+        """
+
+        FEATURE_UNSPECIFIED = 0
+        CLASSIFICATION = 1
+        BOUNDING_BOX = 2
+        ORIENTED_BOUNDING_BOX = 6
+        BOUNDING_POLY = 3
+        POLYLINE = 4
+        SEGMENTATION = 5
+
+
+class LabelTextRequest(object):
+    class Feature(enum.IntEnum):
+        """
+        Text labeling task feature.
+
+        Attributes:
+          FEATURE_UNSPECIFIED (int)
+          TEXT_CLASSIFICATION (int): Label text content to one of more labels.
+          TEXT_ENTITY_EXTRACTION (int): Label entities and their span in text.
+        """
+
+        FEATURE_UNSPECIFIED = 0
+        TEXT_CLASSIFICATION = 1
+        TEXT_ENTITY_EXTRACTION = 2
+
+
+class LabelVideoRequest(object):
+    class Feature(enum.IntEnum):
+        """
+        Video labeling task feature.
+
+        Attributes:
+          FEATURE_UNSPECIFIED (int)
+          CLASSIFICATION (int): Label whole video or video segment with one or more labels.
+          OBJECT_DETECTION (int): Label objects with bounding box on image frames extracted from the video.
+          OBJECT_TRACKING (int): Label and track objects in video.
+          EVENT (int): Label the range of video for the specified events.
+        """
+
+        FEATURE_UNSPECIFIED = 0
+        CLASSIFICATION = 1
+        OBJECT_DETECTION = 2
+        OBJECT_TRACKING = 3
+        EVENT = 4
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/transports/__init__.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/gapic/transports/data_labeling_service_grpc_transport.py b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/transports/data_labeling_service_grpc_transport.py
new file mode 100644
index 000000000000..c429a412c130
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/gapic/transports/data_labeling_service_grpc_transport.py
@@ -0,0 +1,575 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.datalabeling_v1beta1.proto import data_labeling_service_pb2_grpc
+
+
+class DataLabelingServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.datalabeling.v1beta1 DataLabelingService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="datalabeling.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "data_labeling_service_stub": data_labeling_service_pb2_grpc.DataLabelingServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="datalabeling.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_dataset(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.create_dataset`.
+
+        Creates dataset. If success return a Dataset resource.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].CreateDataset
+
+    @property
+    def get_dataset(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_dataset`.
+
+        Gets dataset by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetDataset
+
+    @property
+    def list_datasets(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_datasets`.
+
+        Lists datasets under a project. Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListDatasets
+
+    @property
+    def delete_dataset(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.delete_dataset`.
+
+        Deletes a dataset by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].DeleteDataset
+
+    @property
+    def import_data(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.import_data`.
+
+        Imports data into dataset based on source locations defined in request.
+        It can be called multiple times for the same dataset. Each dataset can
+        only have one long running operation running on it. For example, no
+        labeling task (also long running operation) can be started while
+        importing is still ongoing. Vice versa.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ImportData
+
+    @property
+    def export_data(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.export_data`.
+
+        Exports data and annotations from dataset.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ExportData
+
+    @property
+    def get_data_item(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_data_item`.
+
+        Gets a data item in a dataset by resource name. This API can be
+        called after data are imported into dataset.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetDataItem
+
+    @property
+    def list_data_items(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_data_items`.
+
+        Lists data items in a dataset. This API can be called after data
+        are imported into dataset. Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListDataItems
+
+    @property
+    def get_annotated_dataset(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_annotated_dataset`.
+
+        Gets an annotated dataset by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetAnnotatedDataset
+
+    @property
+    def list_annotated_datasets(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_annotated_datasets`.
+
+        Lists annotated datasets for a dataset. Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListAnnotatedDatasets
+
+    @property
+    def label_image(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.label_image`.
+
+        Starts a labeling task for image. The type of image labeling task is
+        configured by feature in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].LabelImage
+
+    @property
+    def label_video(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.label_video`.
+
+        Starts a labeling task for video. The type of video labeling task is
+        configured by feature in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].LabelVideo
+
+    @property
+    def label_text(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.label_text`.
+
+        Starts a labeling task for text. The type of text labeling task is
+        configured by feature in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].LabelText
+
+    @property
+    def get_example(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_example`.
+
+        Gets an example by resource name, including both data and annotation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetExample
+
+    @property
+    def list_examples(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_examples`.
+
+        Lists examples in an annotated dataset. Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListExamples
+
+    @property
+    def create_annotation_spec_set(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.create_annotation_spec_set`.
+
+        Creates an annotation spec set by providing a set of labels.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].CreateAnnotationSpecSet
+
+    @property
+    def get_annotation_spec_set(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_annotation_spec_set`.
+
+        Gets an annotation spec set by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetAnnotationSpecSet
+
+    @property
+    def list_annotation_spec_sets(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_annotation_spec_sets`.
+
+        Lists annotation spec sets for a project. Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListAnnotationSpecSets
+
+    @property
+    def delete_annotation_spec_set(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.delete_annotation_spec_set`.
+
+        Deletes an annotation spec set by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].DeleteAnnotationSpecSet
+
+    @property
+    def create_instruction(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.create_instruction`.
+
+        Creates an instruction for how data should be labeled.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].CreateInstruction
+
+    @property
+    def get_instruction(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_instruction`.
+
+        Gets an instruction by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetInstruction
+
+    @property
+    def list_instructions(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_instructions`.
+
+        Lists instructions for a project. Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListInstructions
+
+    @property
+    def delete_instruction(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.delete_instruction`.
+
+        Deletes an instruction object by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].DeleteInstruction
+
+    @property
+    def get_evaluation(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_evaluation`.
+
+        Gets an evaluation by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetEvaluation
+
+    @property
+    def search_evaluations(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.search_evaluations`.
+
+        Searchs evaluations within a project. Supported filter: evaluation\_job,
+        evaluation\_time.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].SearchEvaluations
+
+    @property
+    def search_example_comparisons(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.search_example_comparisons`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].SearchExampleComparisons
+
+    @property
+    def create_evaluation_job(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.create_evaluation_job`.
+
+        Creates an evaluation job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].CreateEvaluationJob
+
+    @property
+    def update_evaluation_job(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.update_evaluation_job`.
+
+        Updates an evaluation job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].UpdateEvaluationJob
+
+    @property
+    def get_evaluation_job(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.get_evaluation_job`.
+
+        Gets an evaluation job by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].GetEvaluationJob
+
+    @property
+    def pause_evaluation_job(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.pause_evaluation_job`.
+
+        Pauses an evaluation job. Pausing a evaluation job that is already in
+        PAUSED state will be a no-op.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].PauseEvaluationJob
+
+    @property
+    def resume_evaluation_job(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.resume_evaluation_job`.
+
+        Resumes a paused evaluation job. Deleted evaluation job can't be resumed.
+        Resuming a running evaluation job will be a no-op.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ResumeEvaluationJob
+
+    @property
+    def delete_evaluation_job(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.delete_evaluation_job`.
+
+        Stops and deletes an evaluation job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].DeleteEvaluationJob
+
+    @property
+    def list_evaluation_jobs(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.list_evaluation_jobs`.
+
+        Lists all evaluation jobs within a project with possible filters.
+        Pagination is supported.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].ListEvaluationJobs
+
+    @property
+    def delete_annotated_dataset(self):
+        """Return the gRPC stub for :meth:`DataLabelingServiceClient.delete_annotated_dataset`.
+
+        Deletes an annotated dataset by resource name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["data_labeling_service_stub"].DeleteAnnotatedDataset
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/__init__.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation.proto
new file mode 100644
index 000000000000..b71e4598090a
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation.proto
@@ -0,0 +1,342 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.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.
+enum AnnotationSource {
+  ANNOTATION_SOURCE_UNSPECIFIED = 0;
+
+  // Answer is provided by a human contributor.
+  OPERATOR = 3;
+}
+
+// Annotation for Example. Each example may have one or more annotations. For
+// example in image classification problem, each image might have one or more
+// labels. We call labels binded with this image an Annotation.
+message Annotation {
+  // Output only. Unique name of this annotation, format is:
+  //
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/{annotated_dataset}/examples/{example_id}/annotations/{annotation_id}
+  string name = 1;
+
+  // Output only. The source of the annotation.
+  AnnotationSource annotation_source = 2;
+
+  // Output only. This is the actual annotation value, e.g classification,
+  // bounding box values are stored here.
+  AnnotationValue annotation_value = 3;
+
+  // Output only. Annotation metadata, including information like votes
+  // for labels.
+  AnnotationMetadata annotation_metadata = 4;
+
+  // Output only. Sentiment for this annotation.
+  AnnotationSentiment annotation_sentiment = 6;
+}
+
+enum AnnotationSentiment {
+  ANNOTATION_SENTIMENT_UNSPECIFIED = 0;
+
+  // This annotation describes negatively about the data.
+  NEGATIVE = 1;
+
+  // This label describes positively about the data.
+  POSITIVE = 2;
+}
+
+enum AnnotationType {
+  ANNOTATION_TYPE_UNSPECIFIED = 0;
+
+  // Classification annotations in an image.
+  IMAGE_CLASSIFICATION_ANNOTATION = 1;
+
+  // Bounding box annotations in an image.
+  IMAGE_BOUNDING_BOX_ANNOTATION = 2;
+
+  // Oriented bounding box. The box does not have to be parallel to horizontal
+  // line.
+  IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION = 13;
+
+  // Bounding poly annotations in an image.
+  IMAGE_BOUNDING_POLY_ANNOTATION = 10;
+
+  // Polyline annotations in an image.
+  IMAGE_POLYLINE_ANNOTATION = 11;
+
+  // Segmentation annotations in an image.
+  IMAGE_SEGMENTATION_ANNOTATION = 12;
+
+  // Classification annotations in video shots.
+  VIDEO_SHOTS_CLASSIFICATION_ANNOTATION = 3;
+
+  // Video object tracking annotation.
+  VIDEO_OBJECT_TRACKING_ANNOTATION = 4;
+
+  // Video object detection annotation.
+  VIDEO_OBJECT_DETECTION_ANNOTATION = 5;
+
+  // Video event annotation.
+  VIDEO_EVENT_ANNOTATION = 6;
+
+  // Classification for text.
+  TEXT_CLASSIFICATION_ANNOTATION = 8;
+
+  // Entity extraction for text.
+  TEXT_ENTITY_EXTRACTION_ANNOTATION = 9;
+
+  // General classification.
+  GENERAL_CLASSIFICATION_ANNOTATION = 14;
+}
+
+// Annotation value for an example.
+message AnnotationValue {
+  oneof value_type {
+    // Annotation value for image classification case.
+    ImageClassificationAnnotation image_classification_annotation = 1;
+
+    // Annotation value for image bounding box, oriented bounding box
+    // and polygon cases.
+    ImageBoundingPolyAnnotation image_bounding_poly_annotation = 2;
+
+    // Annotation value for image polyline cases.
+    // Polyline here is different from BoundingPoly. It is formed by
+    // line segments connected to each other but not closed form(Bounding Poly).
+    // The line segments can cross each other.
+    ImagePolylineAnnotation image_polyline_annotation = 8;
+
+    // Annotation value for image segmentation.
+    ImageSegmentationAnnotation image_segmentation_annotation = 9;
+
+    // Annotation value for text classification case.
+    TextClassificationAnnotation text_classification_annotation = 3;
+
+    // Annotation value for text entity extraction case.
+    TextEntityExtractionAnnotation text_entity_extraction_annotation = 10;
+
+    // Annotation value for video classification case.
+    VideoClassificationAnnotation video_classification_annotation = 4;
+
+    // Annotation value for video object detection and tracking case.
+    VideoObjectTrackingAnnotation video_object_tracking_annotation = 5;
+
+    // Annotation value for video event case.
+    VideoEventAnnotation video_event_annotation = 6;
+  }
+}
+
+// Image classification annotation definition.
+message ImageClassificationAnnotation {
+  // Label of image.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// 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 in the image.
+message BoundingPoly {
+  // The bounding polygon vertices.
+  repeated Vertex vertices = 1;
+}
+
+// Normalized bounding polygon.
+message NormalizedBoundingPoly {
+  // The bounding polygon normalized vertices.
+  repeated NormalizedVertex normalized_vertices = 1;
+}
+
+// Image bounding poly annotation. It represents a polygon including
+// bounding box in the image.
+message ImageBoundingPolyAnnotation {
+  // The region of the polygon. If it is a bounding box, it is guaranteed to be
+  // four points.
+  oneof bounded_area {
+    BoundingPoly bounding_poly = 2;
+
+    NormalizedBoundingPoly normalized_bounding_poly = 3;
+  }
+
+  // Label of object in this bounding polygon.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// A line with multiple line segments.
+message Polyline {
+  // The polyline vertices.
+  repeated Vertex vertices = 1;
+}
+
+// Normalized polyline.
+message NormalizedPolyline {
+  // The normalized polyline vertices.
+  repeated NormalizedVertex normalized_vertices = 1;
+}
+
+// A polyline for the image annotation.
+message ImagePolylineAnnotation {
+  oneof poly {
+    Polyline polyline = 2;
+
+    NormalizedPolyline normalized_polyline = 3;
+  }
+
+  // Label of this polyline.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// Image segmentation annotation.
+message ImageSegmentationAnnotation {
+  // The mapping between rgb color and annotation spec. The key is the rgb
+  // color represented in format of rgb(0, 0, 0). The value is the
+  // AnnotationSpec.
+  map<string, AnnotationSpec> annotation_colors = 1;
+
+  // Image format.
+  string mime_type = 2;
+
+  // A byte string of a full image's color map.
+  bytes image_bytes = 3;
+}
+
+// Text classification annotation.
+message TextClassificationAnnotation {
+  // Label of the text.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// Text entity extraction annotation.
+message TextEntityExtractionAnnotation {
+  // Label of the text entities.
+  AnnotationSpec annotation_spec = 1;
+
+  // Position of the entity.
+  SequentialSegment sequential_segment = 2;
+}
+
+// Start and end position in a sequence (e.g. text segment).
+message SequentialSegment {
+  // Start position (inclusive).
+  int32 start = 1;
+
+  // End position (exclusive).
+  int32 end = 2;
+}
+
+// A time period inside of an example that has a time dimension (e.g. video).
+message TimeSegment {
+  // Start of the time segment (inclusive), represented as the duration since
+  // the example start.
+  google.protobuf.Duration start_time_offset = 1;
+
+  // End of the time segment (exclusive), represented as the duration since the
+  // example start.
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video classification annotation.
+message VideoClassificationAnnotation {
+  // The time segment of the video to which the annotation applies.
+  TimeSegment time_segment = 1;
+
+  // Label of the segment specified by time_segment.
+  AnnotationSpec annotation_spec = 2;
+}
+
+// Video frame level annotation for object detection and tracking.
+message ObjectTrackingFrame {
+  // The bounding box location of this object track for the frame.
+  oneof bounded_area {
+    BoundingPoly bounding_poly = 1;
+
+    NormalizedBoundingPoly normalized_bounding_poly = 2;
+  }
+
+  // The time offset of this frame relative to the beginning of the video.
+  google.protobuf.Duration time_offset = 3;
+}
+
+// Video object tracking annotation.
+message VideoObjectTrackingAnnotation {
+  // Label of the object tracked in this annotation.
+  AnnotationSpec annotation_spec = 1;
+
+  // The time segment of the video to which object tracking applies.
+  TimeSegment time_segment = 2;
+
+  // The list of frames where this object track appears.
+  repeated ObjectTrackingFrame object_tracking_frames = 3;
+}
+
+// Video event annotation.
+message VideoEventAnnotation {
+  // Label of the event in this annotation.
+  AnnotationSpec annotation_spec = 1;
+
+  // The time segment of the video to which the annotation applies.
+  TimeSegment time_segment = 2;
+}
+
+// Additional information associated with the annotation.
+message AnnotationMetadata {
+  // Metadata related to human labeling.
+  OperatorMetadata operator_metadata = 2;
+}
+
+// General information useful for labels coming from contributors.
+message OperatorMetadata {
+  // Confidence score corresponding to a label. For examle, if 3 contributors
+  // have answered the question and 2 of them agree on the final label, the
+  // confidence score will be 0.67 (2/3).
+  float score = 1;
+
+  // The total number of contributors that answer this question.
+  int32 total_votes = 2;
+
+  // The total number of contributors that choose this label.
+  int32 label_votes = 3;
+
+  // Comments from contributors.
+  repeated string comments = 4;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_pb2.py
new file mode 100644
index 000000000000..01bc066bdfc1
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_pb2.py
@@ -0,0 +1,2496 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/annotation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_spec_set_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    data_payloads_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/annotation.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/datalabeling_v1beta1/proto/annotation.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x41google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto\x1a;google/cloud/datalabeling_v1beta1/proto/data_payloads.proto\x1a\x1egoogle/protobuf/duration.proto"\xe2\x02\n\nAnnotation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x11\x61nnotation_source\x18\x02 \x01(\x0e\x32\x33.google.cloud.datalabeling.v1beta1.AnnotationSource\x12L\n\x10\x61nnotation_value\x18\x03 \x01(\x0b\x32\x32.google.cloud.datalabeling.v1beta1.AnnotationValue\x12R\n\x13\x61nnotation_metadata\x18\x04 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.AnnotationMetadata\x12T\n\x14\x61nnotation_sentiment\x18\x06 \x01(\x0e\x32\x36.google.cloud.datalabeling.v1beta1.AnnotationSentiment"\xd1\x07\n\x0f\x41nnotationValue\x12k\n\x1fimage_classification_annotation\x18\x01 \x01(\x0b\x32@.google.cloud.datalabeling.v1beta1.ImageClassificationAnnotationH\x00\x12h\n\x1eimage_bounding_poly_annotation\x18\x02 \x01(\x0b\x32>.google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotationH\x00\x12_\n\x19image_polyline_annotation\x18\x08 \x01(\x0b\x32:.google.cloud.datalabeling.v1beta1.ImagePolylineAnnotationH\x00\x12g\n\x1dimage_segmentation_annotation\x18\t \x01(\x0b\x32>.google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotationH\x00\x12i\n\x1etext_classification_annotation\x18\x03 \x01(\x0b\x32?.google.cloud.datalabeling.v1beta1.TextClassificationAnnotationH\x00\x12n\n!text_entity_extraction_annotation\x18\n \x01(\x0b\x32\x41.google.cloud.datalabeling.v1beta1.TextEntityExtractionAnnotationH\x00\x12k\n\x1fvideo_classification_annotation\x18\x04 \x01(\x0b\x32@.google.cloud.datalabeling.v1beta1.VideoClassificationAnnotationH\x00\x12l\n video_object_tracking_annotation\x18\x05 \x01(\x0b\x32@.google.cloud.datalabeling.v1beta1.VideoObjectTrackingAnnotationH\x00\x12Y\n\x16video_event_annotation\x18\x06 \x01(\x0b\x32\x37.google.cloud.datalabeling.v1beta1.VideoEventAnnotationH\x00\x42\x0c\n\nvalue_type"k\n\x1dImageClassificationAnnotation\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec"\x1e\n\x06Vertex\x12\t\n\x01x\x18\x01 \x01(\x05\x12\t\n\x01y\x18\x02 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"K\n\x0c\x42oundingPoly\x12;\n\x08vertices\x18\x01 \x03(\x0b\x32).google.cloud.datalabeling.v1beta1.Vertex"j\n\x16NormalizedBoundingPoly\x12P\n\x13normalized_vertices\x18\x01 \x03(\x0b\x32\x33.google.cloud.datalabeling.v1beta1.NormalizedVertex"\xa2\x02\n\x1bImageBoundingPolyAnnotation\x12H\n\rbounding_poly\x18\x02 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.BoundingPolyH\x00\x12]\n\x18normalized_bounding_poly\x18\x03 \x01(\x0b\x32\x39.google.cloud.datalabeling.v1beta1.NormalizedBoundingPolyH\x00\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpecB\x0e\n\x0c\x62ounded_area"G\n\x08Polyline\x12;\n\x08vertices\x18\x01 \x03(\x0b\x32).google.cloud.datalabeling.v1beta1.Vertex"f\n\x12NormalizedPolyline\x12P\n\x13normalized_vertices\x18\x01 \x03(\x0b\x32\x33.google.cloud.datalabeling.v1beta1.NormalizedVertex"\x84\x02\n\x17ImagePolylineAnnotation\x12?\n\x08polyline\x18\x02 \x01(\x0b\x32+.google.cloud.datalabeling.v1beta1.PolylineH\x00\x12T\n\x13normalized_polyline\x18\x03 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.NormalizedPolylineH\x00\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpecB\x06\n\x04poly"\xa2\x02\n\x1bImageSegmentationAnnotation\x12o\n\x11\x61nnotation_colors\x18\x01 \x03(\x0b\x32T.google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.AnnotationColorsEntry\x12\x11\n\tmime_type\x18\x02 \x01(\t\x12\x13\n\x0bimage_bytes\x18\x03 \x01(\x0c\x1aj\n\x15\x41nnotationColorsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12@\n\x05value\x18\x02 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec:\x02\x38\x01"j\n\x1cTextClassificationAnnotation\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec"\xbe\x01\n\x1eTextEntityExtractionAnnotation\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12P\n\x12sequential_segment\x18\x02 \x01(\x0b\x32\x34.google.cloud.datalabeling.v1beta1.SequentialSegment"/\n\x11SequentialSegment\x12\r\n\x05start\x18\x01 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x05"w\n\x0bTimeSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xb1\x01\n\x1dVideoClassificationAnnotation\x12\x44\n\x0ctime_segment\x18\x01 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.TimeSegment\x12J\n\x0f\x61nnotation_spec\x18\x02 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec"\xfe\x01\n\x13ObjectTrackingFrame\x12H\n\rbounding_poly\x18\x01 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.BoundingPolyH\x00\x12]\n\x18normalized_bounding_poly\x18\x02 \x01(\x0b\x32\x39.google.cloud.datalabeling.v1beta1.NormalizedBoundingPolyH\x00\x12.\n\x0btime_offset\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x0e\n\x0c\x62ounded_area"\x89\x02\n\x1dVideoObjectTrackingAnnotation\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12\x44\n\x0ctime_segment\x18\x02 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.TimeSegment\x12V\n\x16object_tracking_frames\x18\x03 \x03(\x0b\x32\x36.google.cloud.datalabeling.v1beta1.ObjectTrackingFrame"\xa8\x01\n\x14VideoEventAnnotation\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12\x44\n\x0ctime_segment\x18\x02 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.TimeSegment"d\n\x12\x41nnotationMetadata\x12N\n\x11operator_metadata\x18\x02 \x01(\x0b\x32\x33.google.cloud.datalabeling.v1beta1.OperatorMetadata"]\n\x10OperatorMetadata\x12\r\n\x05score\x18\x01 \x01(\x02\x12\x13\n\x0btotal_votes\x18\x02 \x01(\x05\x12\x13\n\x0blabel_votes\x18\x03 \x01(\x05\x12\x10\n\x08\x63omments\x18\x04 \x03(\t*C\n\x10\x41nnotationSource\x12!\n\x1d\x41NNOTATION_SOURCE_UNSPECIFIED\x10\x00\x12\x0c\n\x08OPERATOR\x10\x03*W\n\x13\x41nnotationSentiment\x12$\n ANNOTATION_SENTIMENT_UNSPECIFIED\x10\x00\x12\x0c\n\x08NEGATIVE\x10\x01\x12\x0c\n\x08POSITIVE\x10\x02*\x91\x04\n\x0e\x41nnotationType\x12\x1f\n\x1b\x41NNOTATION_TYPE_UNSPECIFIED\x10\x00\x12#\n\x1fIMAGE_CLASSIFICATION_ANNOTATION\x10\x01\x12!\n\x1dIMAGE_BOUNDING_BOX_ANNOTATION\x10\x02\x12*\n&IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION\x10\r\x12"\n\x1eIMAGE_BOUNDING_POLY_ANNOTATION\x10\n\x12\x1d\n\x19IMAGE_POLYLINE_ANNOTATION\x10\x0b\x12!\n\x1dIMAGE_SEGMENTATION_ANNOTATION\x10\x0c\x12)\n%VIDEO_SHOTS_CLASSIFICATION_ANNOTATION\x10\x03\x12$\n VIDEO_OBJECT_TRACKING_ANNOTATION\x10\x04\x12%\n!VIDEO_OBJECT_DETECTION_ANNOTATION\x10\x05\x12\x1a\n\x16VIDEO_EVENT_ANNOTATION\x10\x06\x12"\n\x1eTEXT_CLASSIFICATION_ANNOTATION\x10\x08\x12%\n!TEXT_ENTITY_EXTRACTION_ANNOTATION\x10\t\x12%\n!GENERAL_CLASSIFICATION_ANNOTATION\x10\x0e\x42x\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+    ],
+)
+
+_ANNOTATIONSOURCE = _descriptor.EnumDescriptor(
+    name="AnnotationSource",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationSource",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ANNOTATION_SOURCE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR", index=1, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4560,
+    serialized_end=4627,
+)
+_sym_db.RegisterEnumDescriptor(_ANNOTATIONSOURCE)
+
+AnnotationSource = enum_type_wrapper.EnumTypeWrapper(_ANNOTATIONSOURCE)
+_ANNOTATIONSENTIMENT = _descriptor.EnumDescriptor(
+    name="AnnotationSentiment",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationSentiment",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ANNOTATION_SENTIMENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEGATIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSITIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4629,
+    serialized_end=4716,
+)
+_sym_db.RegisterEnumDescriptor(_ANNOTATIONSENTIMENT)
+
+AnnotationSentiment = enum_type_wrapper.EnumTypeWrapper(_ANNOTATIONSENTIMENT)
+_ANNOTATIONTYPE = _descriptor.EnumDescriptor(
+    name="AnnotationType",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ANNOTATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_CLASSIFICATION_ANNOTATION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_BOUNDING_BOX_ANNOTATION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION",
+            index=3,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_BOUNDING_POLY_ANNOTATION",
+            index=4,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_POLYLINE_ANNOTATION",
+            index=5,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_SEGMENTATION_ANNOTATION",
+            index=6,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO_SHOTS_CLASSIFICATION_ANNOTATION",
+            index=7,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO_OBJECT_TRACKING_ANNOTATION",
+            index=8,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO_OBJECT_DETECTION_ANNOTATION",
+            index=9,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO_EVENT_ANNOTATION",
+            index=10,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_CLASSIFICATION_ANNOTATION",
+            index=11,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_ENTITY_EXTRACTION_ANNOTATION",
+            index=12,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GENERAL_CLASSIFICATION_ANNOTATION",
+            index=13,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4719,
+    serialized_end=5248,
+)
+_sym_db.RegisterEnumDescriptor(_ANNOTATIONTYPE)
+
+AnnotationType = enum_type_wrapper.EnumTypeWrapper(_ANNOTATIONTYPE)
+ANNOTATION_SOURCE_UNSPECIFIED = 0
+OPERATOR = 3
+ANNOTATION_SENTIMENT_UNSPECIFIED = 0
+NEGATIVE = 1
+POSITIVE = 2
+ANNOTATION_TYPE_UNSPECIFIED = 0
+IMAGE_CLASSIFICATION_ANNOTATION = 1
+IMAGE_BOUNDING_BOX_ANNOTATION = 2
+IMAGE_ORIENTED_BOUNDING_BOX_ANNOTATION = 13
+IMAGE_BOUNDING_POLY_ANNOTATION = 10
+IMAGE_POLYLINE_ANNOTATION = 11
+IMAGE_SEGMENTATION_ANNOTATION = 12
+VIDEO_SHOTS_CLASSIFICATION_ANNOTATION = 3
+VIDEO_OBJECT_TRACKING_ANNOTATION = 4
+VIDEO_OBJECT_DETECTION_ANNOTATION = 5
+VIDEO_EVENT_ANNOTATION = 6
+TEXT_CLASSIFICATION_ANNOTATION = 8
+TEXT_ENTITY_EXTRACTION_ANNOTATION = 9
+GENERAL_CLASSIFICATION_ANNOTATION = 14
+
+
+_ANNOTATION = _descriptor.Descriptor(
+    name="Annotation",
+    full_name="google.cloud.datalabeling.v1beta1.Annotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.Annotation.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_source",
+            full_name="google.cloud.datalabeling.v1beta1.Annotation.annotation_source",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_value",
+            full_name="google.cloud.datalabeling.v1beta1.Annotation.annotation_value",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_metadata",
+            full_name="google.cloud.datalabeling.v1beta1.Annotation.annotation_metadata",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_sentiment",
+            full_name="google.cloud.datalabeling.v1beta1.Annotation.annotation_sentiment",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=286,
+    serialized_end=640,
+)
+
+
+_ANNOTATIONVALUE = _descriptor.Descriptor(
+    name="AnnotationValue",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_classification_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.image_classification_annotation",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_bounding_poly_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.image_bounding_poly_annotation",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_polyline_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.image_polyline_annotation",
+            index=2,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_segmentation_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.image_segmentation_annotation",
+            index=3,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_classification_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.text_classification_annotation",
+            index=4,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_entity_extraction_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.text_entity_extraction_annotation",
+            index=5,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.video_classification_annotation",
+            index=6,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_tracking_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.video_object_tracking_annotation",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_event_annotation",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.video_event_annotation",
+            index=8,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value_type",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationValue.value_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=643,
+    serialized_end=1620,
+)
+
+
+_IMAGECLASSIFICATIONANNOTATION = _descriptor.Descriptor(
+    name="ImageClassificationAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.ImageClassificationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.ImageClassificationAnnotation.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1622,
+    serialized_end=1729,
+)
+
+
+_VERTEX = _descriptor.Descriptor(
+    name="Vertex",
+    full_name="google.cloud.datalabeling.v1beta1.Vertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.datalabeling.v1beta1.Vertex.x",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.datalabeling.v1beta1.Vertex.y",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1731,
+    serialized_end=1761,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.datalabeling.v1beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.datalabeling.v1beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.datalabeling.v1beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1763,
+    serialized_end=1803,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.datalabeling.v1beta1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.datalabeling.v1beta1.BoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1805,
+    serialized_end=1880,
+)
+
+
+_NORMALIZEDBOUNDINGPOLY = _descriptor.Descriptor(
+    name="NormalizedBoundingPoly",
+    full_name="google.cloud.datalabeling.v1beta1.NormalizedBoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.datalabeling.v1beta1.NormalizedBoundingPoly.normalized_vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1882,
+    serialized_end=1988,
+)
+
+
+_IMAGEBOUNDINGPOLYANNOTATION = _descriptor.Descriptor(
+    name="ImageBoundingPolyAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotation.bounding_poly",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_poly",
+            full_name="google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotation.normalized_bounding_poly",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotation.annotation_spec",
+            index=2,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="bounded_area",
+            full_name="google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotation.bounded_area",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1991,
+    serialized_end=2281,
+)
+
+
+_POLYLINE = _descriptor.Descriptor(
+    name="Polyline",
+    full_name="google.cloud.datalabeling.v1beta1.Polyline",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.datalabeling.v1beta1.Polyline.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2283,
+    serialized_end=2354,
+)
+
+
+_NORMALIZEDPOLYLINE = _descriptor.Descriptor(
+    name="NormalizedPolyline",
+    full_name="google.cloud.datalabeling.v1beta1.NormalizedPolyline",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.datalabeling.v1beta1.NormalizedPolyline.normalized_vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2356,
+    serialized_end=2458,
+)
+
+
+_IMAGEPOLYLINEANNOTATION = _descriptor.Descriptor(
+    name="ImagePolylineAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.ImagePolylineAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="polyline",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePolylineAnnotation.polyline",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_polyline",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePolylineAnnotation.normalized_polyline",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePolylineAnnotation.annotation_spec",
+            index=2,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="poly",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePolylineAnnotation.poly",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2461,
+    serialized_end=2721,
+)
+
+
+_IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY = _descriptor.Descriptor(
+    name="AnnotationColorsEntry",
+    full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.AnnotationColorsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.AnnotationColorsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.AnnotationColorsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2908,
+    serialized_end=3014,
+)
+
+_IMAGESEGMENTATIONANNOTATION = _descriptor.Descriptor(
+    name="ImageSegmentationAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_colors",
+            full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.annotation_colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_bytes",
+            full_name="google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.image_bytes",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2724,
+    serialized_end=3014,
+)
+
+
+_TEXTCLASSIFICATIONANNOTATION = _descriptor.Descriptor(
+    name="TextClassificationAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.TextClassificationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.TextClassificationAnnotation.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3016,
+    serialized_end=3122,
+)
+
+
+_TEXTENTITYEXTRACTIONANNOTATION = _descriptor.Descriptor(
+    name="TextEntityExtractionAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.TextEntityExtractionAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.TextEntityExtractionAnnotation.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sequential_segment",
+            full_name="google.cloud.datalabeling.v1beta1.TextEntityExtractionAnnotation.sequential_segment",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3125,
+    serialized_end=3315,
+)
+
+
+_SEQUENTIALSEGMENT = _descriptor.Descriptor(
+    name="SequentialSegment",
+    full_name="google.cloud.datalabeling.v1beta1.SequentialSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start",
+            full_name="google.cloud.datalabeling.v1beta1.SequentialSegment.start",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end",
+            full_name="google.cloud.datalabeling.v1beta1.SequentialSegment.end",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3317,
+    serialized_end=3364,
+)
+
+
+_TIMESEGMENT = _descriptor.Descriptor(
+    name="TimeSegment",
+    full_name="google.cloud.datalabeling.v1beta1.TimeSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.datalabeling.v1beta1.TimeSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.datalabeling.v1beta1.TimeSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3366,
+    serialized_end=3485,
+)
+
+
+_VIDEOCLASSIFICATIONANNOTATION = _descriptor.Descriptor(
+    name="VideoClassificationAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.VideoClassificationAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_segment",
+            full_name="google.cloud.datalabeling.v1beta1.VideoClassificationAnnotation.time_segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.VideoClassificationAnnotation.annotation_spec",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3488,
+    serialized_end=3665,
+)
+
+
+_OBJECTTRACKINGFRAME = _descriptor.Descriptor(
+    name="ObjectTrackingFrame",
+    full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingFrame.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_poly",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingFrame.normalized_bounding_poly",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingFrame.time_offset",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="bounded_area",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingFrame.bounded_area",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3668,
+    serialized_end=3922,
+)
+
+
+_VIDEOOBJECTTRACKINGANNOTATION = _descriptor.Descriptor(
+    name="VideoObjectTrackingAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.VideoObjectTrackingAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.VideoObjectTrackingAnnotation.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_segment",
+            full_name="google.cloud.datalabeling.v1beta1.VideoObjectTrackingAnnotation.time_segment",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_frames",
+            full_name="google.cloud.datalabeling.v1beta1.VideoObjectTrackingAnnotation.object_tracking_frames",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3925,
+    serialized_end=4190,
+)
+
+
+_VIDEOEVENTANNOTATION = _descriptor.Descriptor(
+    name="VideoEventAnnotation",
+    full_name="google.cloud.datalabeling.v1beta1.VideoEventAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.VideoEventAnnotation.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_segment",
+            full_name="google.cloud.datalabeling.v1beta1.VideoEventAnnotation.time_segment",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4193,
+    serialized_end=4361,
+)
+
+
+_ANNOTATIONMETADATA = _descriptor.Descriptor(
+    name="AnnotationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="operator_metadata",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationMetadata.operator_metadata",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4363,
+    serialized_end=4463,
+)
+
+
+_OPERATORMETADATA = _descriptor.Descriptor(
+    name="OperatorMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.OperatorMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.datalabeling.v1beta1.OperatorMetadata.score",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_votes",
+            full_name="google.cloud.datalabeling.v1beta1.OperatorMetadata.total_votes",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_votes",
+            full_name="google.cloud.datalabeling.v1beta1.OperatorMetadata.label_votes",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="comments",
+            full_name="google.cloud.datalabeling.v1beta1.OperatorMetadata.comments",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4465,
+    serialized_end=4558,
+)
+
+_ANNOTATION.fields_by_name["annotation_source"].enum_type = _ANNOTATIONSOURCE
+_ANNOTATION.fields_by_name["annotation_value"].message_type = _ANNOTATIONVALUE
+_ANNOTATION.fields_by_name["annotation_metadata"].message_type = _ANNOTATIONMETADATA
+_ANNOTATION.fields_by_name["annotation_sentiment"].enum_type = _ANNOTATIONSENTIMENT
+_ANNOTATIONVALUE.fields_by_name[
+    "image_classification_annotation"
+].message_type = _IMAGECLASSIFICATIONANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "image_bounding_poly_annotation"
+].message_type = _IMAGEBOUNDINGPOLYANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "image_polyline_annotation"
+].message_type = _IMAGEPOLYLINEANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "image_segmentation_annotation"
+].message_type = _IMAGESEGMENTATIONANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "text_classification_annotation"
+].message_type = _TEXTCLASSIFICATIONANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "text_entity_extraction_annotation"
+].message_type = _TEXTENTITYEXTRACTIONANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "video_classification_annotation"
+].message_type = _VIDEOCLASSIFICATIONANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "video_object_tracking_annotation"
+].message_type = _VIDEOOBJECTTRACKINGANNOTATION
+_ANNOTATIONVALUE.fields_by_name[
+    "video_event_annotation"
+].message_type = _VIDEOEVENTANNOTATION
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["image_classification_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "image_classification_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["image_bounding_poly_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "image_bounding_poly_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["image_polyline_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "image_polyline_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["image_segmentation_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "image_segmentation_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["text_classification_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "text_classification_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["text_entity_extraction_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "text_entity_extraction_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["video_classification_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "video_classification_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["video_object_tracking_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "video_object_tracking_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_ANNOTATIONVALUE.oneofs_by_name["value_type"].fields.append(
+    _ANNOTATIONVALUE.fields_by_name["video_event_annotation"]
+)
+_ANNOTATIONVALUE.fields_by_name[
+    "video_event_annotation"
+].containing_oneof = _ANNOTATIONVALUE.oneofs_by_name["value_type"]
+_IMAGECLASSIFICATIONANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_BOUNDINGPOLY.fields_by_name["vertices"].message_type = _VERTEX
+_NORMALIZEDBOUNDINGPOLY.fields_by_name[
+    "normalized_vertices"
+].message_type = _NORMALIZEDVERTEX
+_IMAGEBOUNDINGPOLYANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = _BOUNDINGPOLY
+_IMAGEBOUNDINGPOLYANNOTATION.fields_by_name[
+    "normalized_bounding_poly"
+].message_type = _NORMALIZEDBOUNDINGPOLY
+_IMAGEBOUNDINGPOLYANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_IMAGEBOUNDINGPOLYANNOTATION.oneofs_by_name["bounded_area"].fields.append(
+    _IMAGEBOUNDINGPOLYANNOTATION.fields_by_name["bounding_poly"]
+)
+_IMAGEBOUNDINGPOLYANNOTATION.fields_by_name[
+    "bounding_poly"
+].containing_oneof = _IMAGEBOUNDINGPOLYANNOTATION.oneofs_by_name["bounded_area"]
+_IMAGEBOUNDINGPOLYANNOTATION.oneofs_by_name["bounded_area"].fields.append(
+    _IMAGEBOUNDINGPOLYANNOTATION.fields_by_name["normalized_bounding_poly"]
+)
+_IMAGEBOUNDINGPOLYANNOTATION.fields_by_name[
+    "normalized_bounding_poly"
+].containing_oneof = _IMAGEBOUNDINGPOLYANNOTATION.oneofs_by_name["bounded_area"]
+_POLYLINE.fields_by_name["vertices"].message_type = _VERTEX
+_NORMALIZEDPOLYLINE.fields_by_name[
+    "normalized_vertices"
+].message_type = _NORMALIZEDVERTEX
+_IMAGEPOLYLINEANNOTATION.fields_by_name["polyline"].message_type = _POLYLINE
+_IMAGEPOLYLINEANNOTATION.fields_by_name[
+    "normalized_polyline"
+].message_type = _NORMALIZEDPOLYLINE
+_IMAGEPOLYLINEANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_IMAGEPOLYLINEANNOTATION.oneofs_by_name["poly"].fields.append(
+    _IMAGEPOLYLINEANNOTATION.fields_by_name["polyline"]
+)
+_IMAGEPOLYLINEANNOTATION.fields_by_name[
+    "polyline"
+].containing_oneof = _IMAGEPOLYLINEANNOTATION.oneofs_by_name["poly"]
+_IMAGEPOLYLINEANNOTATION.oneofs_by_name["poly"].fields.append(
+    _IMAGEPOLYLINEANNOTATION.fields_by_name["normalized_polyline"]
+)
+_IMAGEPOLYLINEANNOTATION.fields_by_name[
+    "normalized_polyline"
+].containing_oneof = _IMAGEPOLYLINEANNOTATION.oneofs_by_name["poly"]
+_IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY.containing_type = (
+    _IMAGESEGMENTATIONANNOTATION
+)
+_IMAGESEGMENTATIONANNOTATION.fields_by_name[
+    "annotation_colors"
+].message_type = _IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY
+_TEXTCLASSIFICATIONANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_TEXTENTITYEXTRACTIONANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_TEXTENTITYEXTRACTIONANNOTATION.fields_by_name[
+    "sequential_segment"
+].message_type = _SEQUENTIALSEGMENT
+_TIMESEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TIMESEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOCLASSIFICATIONANNOTATION.fields_by_name[
+    "time_segment"
+].message_type = _TIMESEGMENT
+_VIDEOCLASSIFICATIONANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_OBJECTTRACKINGFRAME.fields_by_name["bounding_poly"].message_type = _BOUNDINGPOLY
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "normalized_bounding_poly"
+].message_type = _NORMALIZEDBOUNDINGPOLY
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_OBJECTTRACKINGFRAME.oneofs_by_name["bounded_area"].fields.append(
+    _OBJECTTRACKINGFRAME.fields_by_name["bounding_poly"]
+)
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "bounding_poly"
+].containing_oneof = _OBJECTTRACKINGFRAME.oneofs_by_name["bounded_area"]
+_OBJECTTRACKINGFRAME.oneofs_by_name["bounded_area"].fields.append(
+    _OBJECTTRACKINGFRAME.fields_by_name["normalized_bounding_poly"]
+)
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "normalized_bounding_poly"
+].containing_oneof = _OBJECTTRACKINGFRAME.oneofs_by_name["bounded_area"]
+_VIDEOOBJECTTRACKINGANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_VIDEOOBJECTTRACKINGANNOTATION.fields_by_name[
+    "time_segment"
+].message_type = _TIMESEGMENT
+_VIDEOOBJECTTRACKINGANNOTATION.fields_by_name[
+    "object_tracking_frames"
+].message_type = _OBJECTTRACKINGFRAME
+_VIDEOEVENTANNOTATION.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_VIDEOEVENTANNOTATION.fields_by_name["time_segment"].message_type = _TIMESEGMENT
+_ANNOTATIONMETADATA.fields_by_name["operator_metadata"].message_type = _OPERATORMETADATA
+DESCRIPTOR.message_types_by_name["Annotation"] = _ANNOTATION
+DESCRIPTOR.message_types_by_name["AnnotationValue"] = _ANNOTATIONVALUE
+DESCRIPTOR.message_types_by_name[
+    "ImageClassificationAnnotation"
+] = _IMAGECLASSIFICATIONANNOTATION
+DESCRIPTOR.message_types_by_name["Vertex"] = _VERTEX
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["NormalizedBoundingPoly"] = _NORMALIZEDBOUNDINGPOLY
+DESCRIPTOR.message_types_by_name[
+    "ImageBoundingPolyAnnotation"
+] = _IMAGEBOUNDINGPOLYANNOTATION
+DESCRIPTOR.message_types_by_name["Polyline"] = _POLYLINE
+DESCRIPTOR.message_types_by_name["NormalizedPolyline"] = _NORMALIZEDPOLYLINE
+DESCRIPTOR.message_types_by_name["ImagePolylineAnnotation"] = _IMAGEPOLYLINEANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "ImageSegmentationAnnotation"
+] = _IMAGESEGMENTATIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "TextClassificationAnnotation"
+] = _TEXTCLASSIFICATIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "TextEntityExtractionAnnotation"
+] = _TEXTENTITYEXTRACTIONANNOTATION
+DESCRIPTOR.message_types_by_name["SequentialSegment"] = _SEQUENTIALSEGMENT
+DESCRIPTOR.message_types_by_name["TimeSegment"] = _TIMESEGMENT
+DESCRIPTOR.message_types_by_name[
+    "VideoClassificationAnnotation"
+] = _VIDEOCLASSIFICATIONANNOTATION
+DESCRIPTOR.message_types_by_name["ObjectTrackingFrame"] = _OBJECTTRACKINGFRAME
+DESCRIPTOR.message_types_by_name[
+    "VideoObjectTrackingAnnotation"
+] = _VIDEOOBJECTTRACKINGANNOTATION
+DESCRIPTOR.message_types_by_name["VideoEventAnnotation"] = _VIDEOEVENTANNOTATION
+DESCRIPTOR.message_types_by_name["AnnotationMetadata"] = _ANNOTATIONMETADATA
+DESCRIPTOR.message_types_by_name["OperatorMetadata"] = _OPERATORMETADATA
+DESCRIPTOR.enum_types_by_name["AnnotationSource"] = _ANNOTATIONSOURCE
+DESCRIPTOR.enum_types_by_name["AnnotationSentiment"] = _ANNOTATIONSENTIMENT
+DESCRIPTOR.enum_types_by_name["AnnotationType"] = _ANNOTATIONTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Annotation = _reflection.GeneratedProtocolMessageType(
+    "Annotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Annotation for Example. Each example may have one or more annotations.
+  For example in image classification problem, each image might have one
+  or more labels. We call labels binded with this image an Annotation.
+  
+  
+  Attributes:
+      name:
+          Output only. Unique name of this annotation, format is:  proje
+          cts/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/{an
+          notated\_dataset}/examples/{example\_id}/annotations/{annotati
+          on\_id}
+      annotation_source:
+          Output only. The source of the annotation.
+      annotation_value:
+          Output only. This is the actual annotation value, e.g
+          classification, bounding box values are stored here.
+      annotation_metadata:
+          Output only. Annotation metadata, including information like
+          votes for labels.
+      annotation_sentiment:
+          Output only. Sentiment for this annotation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Annotation)
+    ),
+)
+_sym_db.RegisterMessage(Annotation)
+
+AnnotationValue = _reflection.GeneratedProtocolMessageType(
+    "AnnotationValue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATIONVALUE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Annotation value for an example.
+  
+  
+  Attributes:
+      image_classification_annotation:
+          Annotation value for image classification case.
+      image_bounding_poly_annotation:
+          Annotation value for image bounding box, oriented bounding box
+          and polygon cases.
+      image_polyline_annotation:
+          Annotation value for image polyline cases. Polyline here is
+          different from BoundingPoly. It is formed by line segments
+          connected to each other but not closed form(Bounding Poly).
+          The line segments can cross each other.
+      image_segmentation_annotation:
+          Annotation value for image segmentation.
+      text_classification_annotation:
+          Annotation value for text classification case.
+      text_entity_extraction_annotation:
+          Annotation value for text entity extraction case.
+      video_classification_annotation:
+          Annotation value for video classification case.
+      video_object_tracking_annotation:
+          Annotation value for video object detection and tracking case.
+      video_event_annotation:
+          Annotation value for video event case.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.AnnotationValue)
+    ),
+)
+_sym_db.RegisterMessage(AnnotationValue)
+
+ImageClassificationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ImageClassificationAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECLASSIFICATIONANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Image classification annotation definition.
+  
+  
+  Attributes:
+      annotation_spec:
+          Label of image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImageClassificationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ImageClassificationAnnotation)
+
+Vertex = _reflection.GeneratedProtocolMessageType(
+    "Vertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTEX,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Vertex)
+    ),
+)
+_sym_db.RegisterMessage(Vertex)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""A bounding polygon in the image.
+  
+  
+  Attributes:
+      vertices:
+          The bounding polygon vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+NormalizedBoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGPOLY,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Normalized bounding polygon.
+  
+  
+  Attributes:
+      normalized_vertices:
+          The bounding polygon normalized vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.NormalizedBoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingPoly)
+
+ImageBoundingPolyAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ImageBoundingPolyAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEBOUNDINGPOLYANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Image bounding poly annotation. It represents a polygon including
+  bounding box in the image.
+  
+  
+  Attributes:
+      bounded_area:
+          The region of the polygon. If it is a bounding box, it is
+          guaranteed to be four points.
+      annotation_spec:
+          Label of object in this bounding polygon.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImageBoundingPolyAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ImageBoundingPolyAnnotation)
+
+Polyline = _reflection.GeneratedProtocolMessageType(
+    "Polyline",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POLYLINE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""A line with multiple line segments.
+  
+  
+  Attributes:
+      vertices:
+          The polyline vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Polyline)
+    ),
+)
+_sym_db.RegisterMessage(Polyline)
+
+NormalizedPolyline = _reflection.GeneratedProtocolMessageType(
+    "NormalizedPolyline",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDPOLYLINE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Normalized polyline.
+  
+  
+  Attributes:
+      normalized_vertices:
+          The normalized polyline vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.NormalizedPolyline)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedPolyline)
+
+ImagePolylineAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ImagePolylineAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPOLYLINEANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""A polyline for the image annotation.
+  
+  
+  Attributes:
+      annotation_spec:
+          Label of this polyline.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImagePolylineAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ImagePolylineAnnotation)
+
+ImageSegmentationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ImageSegmentationAnnotation",
+    (_message.Message,),
+    dict(
+        AnnotationColorsEntry=_reflection.GeneratedProtocolMessageType(
+            "AnnotationColorsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY,
+                __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation.AnnotationColorsEntry)
+            ),
+        ),
+        DESCRIPTOR=_IMAGESEGMENTATIONANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Image segmentation annotation.
+  
+  
+  Attributes:
+      annotation_colors:
+          The mapping between rgb color and annotation spec. The key is
+          the rgb color represented in format of rgb(0, 0, 0). The value
+          is the AnnotationSpec.
+      mime_type:
+          Image format.
+      image_bytes:
+          A byte string of a full image's color map.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImageSegmentationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ImageSegmentationAnnotation)
+_sym_db.RegisterMessage(ImageSegmentationAnnotation.AnnotationColorsEntry)
+
+TextClassificationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextClassificationAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTCLASSIFICATIONANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Text classification annotation.
+  
+  
+  Attributes:
+      annotation_spec:
+          Label of the text.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TextClassificationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextClassificationAnnotation)
+
+TextEntityExtractionAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextEntityExtractionAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTENTITYEXTRACTIONANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Text entity extraction annotation.
+  
+  
+  Attributes:
+      annotation_spec:
+          Label of the text entities.
+      sequential_segment:
+          Position of the entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TextEntityExtractionAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextEntityExtractionAnnotation)
+
+SequentialSegment = _reflection.GeneratedProtocolMessageType(
+    "SequentialSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEQUENTIALSEGMENT,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Start and end position in a sequence (e.g. text segment).
+  
+  
+  Attributes:
+      start:
+          Start position (inclusive).
+      end:
+          End position (exclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SequentialSegment)
+    ),
+)
+_sym_db.RegisterMessage(SequentialSegment)
+
+TimeSegment = _reflection.GeneratedProtocolMessageType(
+    "TimeSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMESEGMENT,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""A time period inside of an example that has a time dimension (e.g.
+  video).
+  
+  
+  Attributes:
+      start_time_offset:
+          Start of the time segment (inclusive), represented as the
+          duration since the example start.
+      end_time_offset:
+          End of the time segment (exclusive), represented as the
+          duration since the example start.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TimeSegment)
+    ),
+)
+_sym_db.RegisterMessage(TimeSegment)
+
+VideoClassificationAnnotation = _reflection.GeneratedProtocolMessageType(
+    "VideoClassificationAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCLASSIFICATIONANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Video classification annotation.
+  
+  
+  Attributes:
+      time_segment:
+          The time segment of the video to which the annotation applies.
+      annotation_spec:
+          Label of the segment specified by time\_segment.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoClassificationAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(VideoClassificationAnnotation)
+
+ObjectTrackingFrame = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGFRAME,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Video frame level annotation for object detection and tracking.
+  
+  
+  Attributes:
+      bounded_area:
+          The bounding box location of this object track for the frame.
+      time_offset:
+          The time offset of this frame relative to the beginning of the
+          video.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ObjectTrackingFrame)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingFrame)
+
+VideoObjectTrackingAnnotation = _reflection.GeneratedProtocolMessageType(
+    "VideoObjectTrackingAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOOBJECTTRACKINGANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Video object tracking annotation.
+  
+  
+  Attributes:
+      annotation_spec:
+          Label of the object tracked in this annotation.
+      time_segment:
+          The time segment of the video to which object tracking
+          applies.
+      object_tracking_frames:
+          The list of frames where this object track appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoObjectTrackingAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(VideoObjectTrackingAnnotation)
+
+VideoEventAnnotation = _reflection.GeneratedProtocolMessageType(
+    "VideoEventAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOEVENTANNOTATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Video event annotation.
+  
+  
+  Attributes:
+      annotation_spec:
+          Label of the event in this annotation.
+      time_segment:
+          The time segment of the video to which the annotation applies.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoEventAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(VideoEventAnnotation)
+
+AnnotationMetadata = _reflection.GeneratedProtocolMessageType(
+    "AnnotationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""Additional information associated with the annotation.
+  
+  
+  Attributes:
+      operator_metadata:
+          Metadata related to human labeling.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.AnnotationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(AnnotationMetadata)
+
+OperatorMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperatorMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATORMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_pb2",
+        __doc__="""General information useful for labels coming from contributors.
+  
+  
+  Attributes:
+      score:
+          Confidence score corresponding to a label. For examle, if 3
+          contributors have answered the question and 2 of them agree on
+          the final label, the confidence score will be 0.67 (2/3).
+      total_votes:
+          The total number of contributors that answer this question.
+      label_votes:
+          The total number of contributors that choose this label.
+      comments:
+          Comments from contributors.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.OperatorMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperatorMetadata)
+
+
+DESCRIPTOR._options = None
+_IMAGESEGMENTATIONANNOTATION_ANNOTATIONCOLORSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto
new file mode 100644
index 000000000000..bd5413dc714d
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.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.datalabeling.v1beta1;
+
+import "google/api/annotations.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.
+message AnnotationSpecSet {
+  // Output only. AnnotationSpecSet resource name, 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.
+  string display_name = 2;
+
+  // Optional. User-provided description of the annotation specification set.
+  // The description can be up to 10000 characters long.
+  string description = 3;
+
+  // Required. The actual spec set defined by the users.
+  repeated AnnotationSpec annotation_specs = 4;
+
+  // Output only. The names of any related resources that are blocking changes
+  // to the annotation spec set.
+  repeated string blocking_resources = 5;
+}
+
+// Container of information related to one annotation spec.
+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.
+  string description = 2;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set_pb2.py
new file mode 100644
index 000000000000..e1674fb539a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set_pb2.py
@@ -0,0 +1,265 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\nAgoogle/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto"\xb5\x01\n\x11\x41nnotationSpecSet\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12K\n\x10\x61nnotation_specs\x18\x04 \x03(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12\x1a\n\x12\x62locking_resources\x18\x05 \x03(\t";\n\x0e\x41nnotationSpec\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\tBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_ANNOTATIONSPECSET = _descriptor.Descriptor(
+    name="AnnotationSpecSet",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationSpecSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpecSet.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpecSet.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpecSet.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_specs",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpecSet.annotation_specs",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocking_resources",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpecSet.blocking_resources",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=135,
+    serialized_end=316,
+)
+
+
+_ANNOTATIONSPEC = _descriptor.Descriptor(
+    name="AnnotationSpec",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotationSpec",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpec.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotationSpec.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=318,
+    serialized_end=377,
+)
+
+_ANNOTATIONSPECSET.fields_by_name["annotation_specs"].message_type = _ANNOTATIONSPEC
+DESCRIPTOR.message_types_by_name["AnnotationSpecSet"] = _ANNOTATIONSPECSET
+DESCRIPTOR.message_types_by_name["AnnotationSpec"] = _ANNOTATIONSPEC
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotationSpecSet = _reflection.GeneratedProtocolMessageType(
+    "AnnotationSpecSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATIONSPECSET,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_spec_set_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          Output only. AnnotationSpecSet resource name, format: projects
+          /{project\_id}/annotationSpecSets/{annotation\_spec\_set\_id}
+      display_name:
+          Required. The display name for AnnotationSpecSet defined by
+          user. Maximum of 64 characters.
+      description:
+          Optional. User-provided description of the annotation
+          specification set. The description can be up to 10000
+          characters long.
+      annotation_specs:
+          Required. The actual spec set defined by the users.
+      blocking_resources:
+          Output only. The names of any related resources that are
+          blocking changes to the annotation spec set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.AnnotationSpecSet)
+    ),
+)
+_sym_db.RegisterMessage(AnnotationSpecSet)
+
+AnnotationSpec = _reflection.GeneratedProtocolMessageType(
+    "AnnotationSpec",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATIONSPEC,
+        __module__="google.cloud.datalabeling_v1beta1.proto.annotation_spec_set_pb2",
+        __doc__="""Container of information related to one annotation spec.
+  
+  
+  Attributes:
+      display_name:
+          Required. The display name of the AnnotationSpec. Maximum of
+          64 characters.
+      description:
+          Optional. User-provided description of the annotation
+          specification. The description can be up to 10000 characters
+          long.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.AnnotationSpec)
+    ),
+)
+_sym_db.RegisterMessage(AnnotationSpec)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/annotation_spec_set_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service.proto
new file mode 100644
index 000000000000..8395206d9bea
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service.proto
@@ -0,0 +1,966 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/datalabeling/v1beta1/annotation.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";
+
+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";
+
+service DataLabelingService {
+  option (google.api.default_host) = "datalabeling.googleapis.com";
+  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) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/datasets"
+      body: "*"
+    };
+  }
+
+  // Gets dataset by resource name.
+  rpc GetDataset(GetDatasetRequest) returns (Dataset) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*}"
+    };
+  }
+
+  // Lists datasets under a project. Pagination is supported.
+  rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/datasets"
+    };
+  }
+
+  // Deletes a dataset by resource name.
+  rpc DeleteDataset(DeleteDatasetRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/datasets/*}"
+    };
+  }
+
+  // Imports data into dataset based on source locations defined in request.
+  // It can be called multiple times for the same dataset. Each dataset can
+  // only have one long running operation running on it. For example, no
+  // labeling task (also long running operation) can be started while
+  // importing is still ongoing. Vice versa.
+  rpc ImportData(ImportDataRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/datasets/*}:importData"
+      body: "*"
+    };
+  }
+
+  // Exports data and annotations from dataset.
+  rpc ExportData(ExportDataRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/datasets/*}:exportData"
+      body: "*"
+    };
+  }
+
+  // Gets a data item in a dataset by resource name. This API can be
+  // called after data are imported into dataset.
+  rpc GetDataItem(GetDataItemRequest) returns (DataItem) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/dataItems/*}"
+    };
+  }
+
+  // Lists data items in a dataset. This API can be called after data
+  // are imported into dataset. Pagination is supported.
+  rpc ListDataItems(ListDataItemsRequest) returns (ListDataItemsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/datasets/*}/dataItems"
+    };
+  }
+
+  // Gets an annotated dataset by resource name.
+  rpc GetAnnotatedDataset(GetAnnotatedDatasetRequest)
+      returns (AnnotatedDataset) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}"
+    };
+  }
+
+  // Lists annotated datasets for a dataset. Pagination is supported.
+  rpc ListAnnotatedDatasets(ListAnnotatedDatasetsRequest)
+      returns (ListAnnotatedDatasetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/datasets/*}/annotatedDatasets"
+    };
+  }
+
+  // Deletes an annotated dataset by resource name.
+  rpc DeleteAnnotatedDataset(DeleteAnnotatedDatasetRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}"
+    };
+  }
+
+  // Starts a labeling task for image. The type of image labeling task is
+  // configured by feature in the request.
+  rpc LabelImage(LabelImageRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/image:label"
+      body: "*"
+    };
+  }
+
+  // Starts a labeling task for video. The type of video labeling task is
+  // configured by feature in the request.
+  rpc LabelVideo(LabelVideoRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/video:label"
+      body: "*"
+    };
+  }
+
+  // Starts a labeling task for text. The type of text labeling task is
+  // configured by feature in the request.
+  rpc LabelText(LabelTextRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/text:label"
+      body: "*"
+    };
+  }
+
+  // Gets an example by resource name, including both data and annotation.
+  rpc GetExample(GetExampleRequest) returns (Example) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*/examples/*}"
+    };
+  }
+
+  // Lists examples in an annotated dataset. Pagination is supported.
+  rpc ListExamples(ListExamplesRequest) returns (ListExamplesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/datasets/*/annotatedDatasets/*}/examples"
+    };
+  }
+
+  // Creates an annotation spec set by providing a set of labels.
+  rpc CreateAnnotationSpecSet(CreateAnnotationSpecSetRequest)
+      returns (AnnotationSpecSet) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/annotationSpecSets"
+      body: "*"
+    };
+  }
+
+  // Gets an annotation spec set by resource name.
+  rpc GetAnnotationSpecSet(GetAnnotationSpecSetRequest)
+      returns (AnnotationSpecSet) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/annotationSpecSets/*}"
+    };
+  }
+
+  // Lists annotation spec sets for a project. Pagination is supported.
+  rpc ListAnnotationSpecSets(ListAnnotationSpecSetsRequest)
+      returns (ListAnnotationSpecSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/annotationSpecSets"
+    };
+  }
+
+  // Deletes an annotation spec set by resource name.
+  rpc DeleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/annotationSpecSets/*}"
+    };
+  }
+
+  // Creates an instruction for how data should be labeled.
+  rpc CreateInstruction(CreateInstructionRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/instructions"
+      body: "*"
+    };
+  }
+
+  // Gets an instruction by resource name.
+  rpc GetInstruction(GetInstructionRequest) returns (Instruction) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/instructions/*}"
+    };
+  }
+
+  // Lists instructions for a project. Pagination is supported.
+  rpc ListInstructions(ListInstructionsRequest)
+      returns (ListInstructionsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/instructions"
+    };
+  }
+
+  // Deletes an instruction object by resource name.
+  rpc DeleteInstruction(DeleteInstructionRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/instructions/*}"
+    };
+  }
+
+  // Gets an evaluation by resource name.
+  rpc GetEvaluation(GetEvaluationRequest) returns (Evaluation) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/evaluations/*}"
+    };
+  }
+
+  // Searchs evaluations within a project. Supported filter: evaluation_job,
+  // evaluation_time.
+  rpc SearchEvaluations(SearchEvaluationsRequest)
+      returns (SearchEvaluationsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/evaluations:search"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*/evaluations/*}/exampleComparisons:search"
+      body: "*"
+    };
+  }
+
+  // Creates an evaluation job.
+  rpc CreateEvaluationJob(CreateEvaluationJobRequest) returns (EvaluationJob) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/evaluationJobs"
+      body: "*"
+    };
+  }
+
+  // Updates an evaluation job.
+  rpc UpdateEvaluationJob(UpdateEvaluationJobRequest) returns (EvaluationJob) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{evaluation_job.name=projects/*/evaluationJobs/*}"
+      body: "evaluation_job"
+    };
+  }
+
+  // Gets an evaluation job by resource name.
+  rpc GetEvaluationJob(GetEvaluationJobRequest) returns (EvaluationJob) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/evaluationJobs/*}"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/evaluationJobs/*}:pause"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/evaluationJobs/*}:resume"
+      body: "*"
+    };
+  }
+
+  // Stops and deletes an evaluation job.
+  rpc DeleteEvaluationJob(DeleteEvaluationJobRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/evaluationJobs/*}"
+    };
+  }
+
+  // Lists all evaluation jobs within a project with possible filters.
+  // Pagination is supported.
+  rpc ListEvaluationJobs(ListEvaluationJobsRequest)
+      returns (ListEvaluationJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/evaluationJobs"
+    };
+  }
+}
+
+// Request message for CreateDataset.
+message CreateDatasetRequest {
+  // Required. Dataset resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Required. The dataset to be created.
+  Dataset dataset = 2;
+}
+
+// Request message for GetDataSet.
+message GetDatasetRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+}
+
+// Request message for ListDataset.
+message ListDatasetsRequest {
+  // Required. Dataset resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Optional. Filter on dataset is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing datasets within a project.
+message ListDatasetsResponse {
+  // The list of datasets to return.
+  repeated Dataset datasets = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteDataset.
+message DeleteDatasetRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+}
+
+// Request message for ImportData API.
+message ImportDataRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+
+  // Required. Specify the input source of the data.
+  InputConfig input_config = 2;
+
+  // Email of the user who started the import task and should be notified by
+  // email. If empty no notification will be sent.
+  string user_email_address = 3;
+}
+
+// Request message for ExportData API.
+message ExportDataRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+
+  // 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;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 3;
+
+  // Required. Specify the output destination.
+  OutputConfig output_config = 4;
+
+  // Email of the user who started the export task and should be notified by
+  // email. If empty no notification will be sent.
+  string user_email_address = 5;
+}
+
+// Request message for GetDataItem.
+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;
+}
+
+// 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;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing data items in a dataset.
+message ListDataItemsResponse {
+  // The list of data items to return.
+  repeated DataItem data_items = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for GetAnnotatedDataset.
+message GetAnnotatedDatasetRequest {
+  // Required. Name of the annotated dataset to get, format:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}
+  string name = 1;
+}
+
+// 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;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing annotated datasets for a dataset.
+message ListAnnotatedDatasetsResponse {
+  // The list of annotated datasets to return.
+  repeated AnnotatedDataset annotated_datasets = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteAnnotatedDataset.
+message DeleteAnnotatedDatasetRequest {
+  // Required. Name of the annotated dataset to delete, format:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}
+  string name = 1;
+}
+
+// Request message for starting an image labeling task.
+message LabelImageRequest {
+  // Image labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Label whole image with one or more of labels.
+    CLASSIFICATION = 1;
+
+    // Label image with bounding boxes for labels.
+    BOUNDING_BOX = 2;
+
+    // Label oriented bounding box. The box does not have to be parallel to
+    // horizontal line.
+    ORIENTED_BOUNDING_BOX = 6;
+
+    // Label images with bounding poly. A bounding poly is a plane figure that
+    // is bounded by a finite chain of straight line segments closing in a loop.
+    BOUNDING_POLY = 3;
+
+    // Label images with polyline. Polyline is formed by connected line segments
+    // which are not in closed form.
+    POLYLINE = 4;
+
+    // Label images with segmentation. Segmentation is different from bounding
+    // poly since it is more fine-grained, pixel level annotation.
+    SEGMENTATION = 5;
+  }
+
+  // Required. Config for labeling tasks. The type of request config must
+  // match the selected feature.
+  oneof request_config {
+    // Configuration for image classification task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config are required.
+    ImageClassificationConfig image_classification_config = 4;
+
+    // Configuration for bounding box and bounding poly task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config are required.
+    BoundingPolyConfig bounding_poly_config = 5;
+
+    // Configuration for polyline task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config are required.
+    PolylineConfig polyline_config = 6;
+
+    // Configuration for segmentation task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config are required.
+    SegmentationConfig segmentation_config = 7;
+  }
+
+  // Required. Name of the dataset to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of image labeling task.
+  Feature feature = 3;
+}
+
+// Request message for LabelVideo.
+message LabelVideoRequest {
+  // Video labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Label whole video or video segment with one or more labels.
+    CLASSIFICATION = 1;
+
+    // Label objects with bounding box on image frames extracted from the video.
+    OBJECT_DETECTION = 2;
+
+    // Label and track objects in video.
+    OBJECT_TRACKING = 3;
+
+    // Label the range of video for the specified events.
+    EVENT = 4;
+  }
+
+  // Required. Config for labeling tasks. The type of request config must
+  // match the selected feature.
+  oneof request_config {
+    // Configuration for video classification task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    VideoClassificationConfig video_classification_config = 4;
+
+    // Configuration for video object detection task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    ObjectDetectionConfig object_detection_config = 5;
+
+    // Configuration for video object tracking task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    ObjectTrackingConfig object_tracking_config = 6;
+
+    // Configuration for video event task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    EventConfig event_config = 7;
+  }
+
+  // Required. Name of the dataset to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of video labeling task.
+  Feature feature = 3;
+}
+
+// Request message for LabelText.
+message LabelTextRequest {
+  // Text labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Label text content to one of more labels.
+    TEXT_CLASSIFICATION = 1;
+
+    // Label entities and their span in text.
+    TEXT_ENTITY_EXTRACTION = 2;
+  }
+
+  // Required. Config for labeling tasks. The type of request config must
+  // match the selected feature.
+  oneof request_config {
+    // Configuration for text classification task.
+    // One of text_classification_config and text_entity_extraction_config
+    // is required.
+    TextClassificationConfig text_classification_config = 4;
+
+    // Configuration for entity extraction task.
+    // One of text_classification_config and text_entity_extraction_config
+    // is required.
+    TextEntityExtractionConfig text_entity_extraction_config = 5;
+  }
+
+  // Required. Name of the data set to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of text labeling task.
+  Feature feature = 6;
+}
+
+// Request message for GetExample
+message GetExampleRequest {
+  // Required. Name of example, format:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}/examples/{example_id}
+  string name = 1;
+
+  // Optional. An expression for filtering Examples. Filter by
+  // annotation_spec.display_name is supported. Format
+  // "annotation_spec.display_name = {display_name}"
+  string filter = 2;
+}
+
+// Request message for ListExamples.
+message ListExamplesRequest {
+  // Required. Example resource parent.
+  string parent = 1;
+
+  // 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;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing Examples in and annotated dataset.
+message ListExamplesResponse {
+  // The list of examples to return.
+  repeated Example examples = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for CreateAnnotationSpecSet.
+message CreateAnnotationSpecSetRequest {
+  // Required. AnnotationSpecSet resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // 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;
+}
+
+// Request message for GetAnnotationSpecSet.
+message GetAnnotationSpecSetRequest {
+  // Required. AnnotationSpecSet resource name, format:
+  // projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}
+  string name = 1;
+}
+
+// Request message for ListAnnotationSpecSets.
+message ListAnnotationSpecSetsRequest {
+  // Required. Parent of AnnotationSpecSet resource, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing annotation spec set under a project.
+message ListAnnotationSpecSetsResponse {
+  // The list of annotation spec sets.
+  repeated AnnotationSpecSet annotation_spec_sets = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteAnnotationSpecSet.
+message DeleteAnnotationSpecSetRequest {
+  // Required. AnnotationSpec resource name, format:
+  // `projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}`.
+  string name = 1;
+}
+
+// Request message for CreateInstruction.
+message CreateInstructionRequest {
+  // Required. Instruction resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Required. Instruction of how to perform the labeling task.
+  Instruction instruction = 2;
+}
+
+// Request message for GetInstruction.
+message GetInstructionRequest {
+  // Required. Instruction resource name, format:
+  // projects/{project_id}/instructions/{instruction_id}
+  string name = 1;
+}
+
+// Request message for DeleteInstruction.
+message DeleteInstructionRequest {
+  // Required. Instruction resource name, format:
+  // projects/{project_id}/instructions/{instruction_id}
+  string name = 1;
+}
+
+// Request message for ListInstructions.
+message ListInstructionsRequest {
+  // Required. Instruction resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing instructions under a project.
+message ListInstructionsResponse {
+  // The list of Instructions to return.
+  repeated Instruction instructions = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for GetEvaluation.
+message GetEvaluationRequest {
+  // Required. Name of the evaluation. Format:
+  // 'projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}'
+  string name = 1;
+}
+
+// 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;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of searching evaluations.
+message SearchEvaluationsResponse {
+  // The list of evaluations to return.
+  repeated Evaluation evaluations = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 2;
+
+  // 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;
+}
+
+// Results of searching example comparisons.
+message SearchExampleComparisonsResponse {
+  // Example comparisons containing annotation comparison between groundtruth
+  // and predictions.
+  message ExampleComparison {
+    Example ground_truth_example = 1;
+
+    repeated Example model_created_examples = 2;
+  }
+
+  repeated ExampleComparison example_comparisons = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for CreateEvaluationJob.
+message CreateEvaluationJobRequest {
+  // Required. Evaluation job resource parent, format:
+  // projects/{project_id}.
+  string parent = 1;
+
+  // Required. The evaluation job to create.
+  EvaluationJob job = 2;
+}
+
+// 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;
+}
+
+// Request message for GetEvaluationJob.
+message GetEvaluationJobRequest {
+  // Required. Name of the evaluation job. Format:
+  // 'projects/{project_id}/evaluationJobs/{evaluation_job_id}'
+  string name = 1;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results for listing evaluation jobs.
+message ListEvaluationJobsResponse {
+  // The list of evaluation jobs to return.
+  repeated EvaluationJob evaluation_jobs = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service_pb2.py
new file mode 100644
index 000000000000..87f44e316714
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service_pb2.py
@@ -0,0 +1,4843 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/data_labeling_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_spec_set_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    evaluation_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    evaluation_job_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    human_annotation_config_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    instruction_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    operations_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_operations__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/data_labeling_service.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\nCgoogle/cloud/datalabeling_v1beta1/proto/data_labeling_service.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x38google/cloud/datalabeling_v1beta1/proto/annotation.proto\x1a\x41google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto\x1a\x35google/cloud/datalabeling_v1beta1/proto/dataset.proto\x1a\x38google/cloud/datalabeling_v1beta1/proto/evaluation.proto\x1a<google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto\x1a\x45google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto\x1a\x39google/cloud/datalabeling_v1beta1/proto/instruction.proto\x1a\x38google/cloud/datalabeling_v1beta1/proto/operations.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"c\n\x14\x43reateDatasetRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12;\n\x07\x64\x61taset\x18\x02 \x01(\x0b\x32*.google.cloud.datalabeling.v1beta1.Dataset"!\n\x11GetDatasetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x13ListDatasetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"m\n\x14ListDatasetsResponse\x12<\n\x08\x64\x61tasets\x18\x01 \x03(\x0b\x32*.google.cloud.datalabeling.v1beta1.Dataset\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"$\n\x14\x44\x65leteDatasetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x83\x01\n\x11ImportDataRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x44\n\x0cinput_config\x18\x02 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.InputConfig\x12\x1a\n\x12user_email_address\x18\x03 \x01(\t"\xb0\x01\n\x11\x45xportDataRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x11\x61nnotated_dataset\x18\x02 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x46\n\routput_config\x18\x04 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.OutputConfig\x12\x1a\n\x12user_email_address\x18\x05 \x01(\t""\n\x12GetDataItemRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"]\n\x14ListDataItemsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"q\n\x15ListDataItemsResponse\x12?\n\ndata_items\x18\x01 \x03(\x0b\x32+.google.cloud.datalabeling.v1beta1.DataItem\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"*\n\x1aGetAnnotatedDatasetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"e\n\x1cListAnnotatedDatasetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x89\x01\n\x1dListAnnotatedDatasetsResponse\x12O\n\x12\x61nnotated_datasets\x18\x01 \x03(\x0b\x32\x33.google.cloud.datalabeling.v1beta1.AnnotatedDataset\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"-\n\x1d\x44\x65leteAnnotatedDatasetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xcd\x05\n\x11LabelImageRequest\x12\x63\n\x1bimage_classification_config\x18\x04 \x01(\x0b\x32<.google.cloud.datalabeling.v1beta1.ImageClassificationConfigH\x00\x12U\n\x14\x62ounding_poly_config\x18\x05 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.BoundingPolyConfigH\x00\x12L\n\x0fpolyline_config\x18\x06 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.PolylineConfigH\x00\x12T\n\x13segmentation_config\x18\x07 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.SegmentationConfigH\x00\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12N\n\x0c\x62\x61sic_config\x18\x02 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig\x12M\n\x07\x66\x65\x61ture\x18\x03 \x01(\x0e\x32<.google.cloud.datalabeling.v1beta1.LabelImageRequest.Feature"\x96\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43LASSIFICATION\x10\x01\x12\x10\n\x0c\x42OUNDING_BOX\x10\x02\x12\x19\n\x15ORIENTED_BOUNDING_BOX\x10\x06\x12\x11\n\rBOUNDING_POLY\x10\x03\x12\x0c\n\x08POLYLINE\x10\x04\x12\x10\n\x0cSEGMENTATION\x10\x05\x42\x10\n\x0erequest_config"\xa7\x05\n\x11LabelVideoRequest\x12\x63\n\x1bvideo_classification_config\x18\x04 \x01(\x0b\x32<.google.cloud.datalabeling.v1beta1.VideoClassificationConfigH\x00\x12[\n\x17object_detection_config\x18\x05 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.ObjectDetectionConfigH\x00\x12Y\n\x16object_tracking_config\x18\x06 \x01(\x0b\x32\x37.google.cloud.datalabeling.v1beta1.ObjectTrackingConfigH\x00\x12\x46\n\x0c\x65vent_config\x18\x07 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.EventConfigH\x00\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12N\n\x0c\x62\x61sic_config\x18\x02 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig\x12M\n\x07\x66\x65\x61ture\x18\x03 \x01(\x0e\x32<.google.cloud.datalabeling.v1beta1.LabelVideoRequest.Feature"l\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43LASSIFICATION\x10\x01\x12\x14\n\x10OBJECT_DETECTION\x10\x02\x12\x13\n\x0fOBJECT_TRACKING\x10\x03\x12\t\n\x05\x45VENT\x10\x04\x42\x10\n\x0erequest_config"\xf6\x03\n\x10LabelTextRequest\x12\x61\n\x1atext_classification_config\x18\x04 \x01(\x0b\x32;.google.cloud.datalabeling.v1beta1.TextClassificationConfigH\x00\x12\x66\n\x1dtext_entity_extraction_config\x18\x05 \x01(\x0b\x32=.google.cloud.datalabeling.v1beta1.TextEntityExtractionConfigH\x00\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12N\n\x0c\x62\x61sic_config\x18\x02 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig\x12L\n\x07\x66\x65\x61ture\x18\x06 \x01(\x0e\x32;.google.cloud.datalabeling.v1beta1.LabelTextRequest.Feature"W\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x17\n\x13TEXT_CLASSIFICATION\x10\x01\x12\x1a\n\x16TEXT_ENTITY_EXTRACTION\x10\x02\x42\x10\n\x0erequest_config"1\n\x11GetExampleRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t"\\\n\x13ListExamplesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"m\n\x14ListExamplesResponse\x12<\n\x08\x65xamples\x18\x01 \x03(\x0b\x32*.google.cloud.datalabeling.v1beta1.Example\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x83\x01\n\x1e\x43reateAnnotationSpecSetRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12Q\n\x13\x61nnotation_spec_set\x18\x02 \x01(\x0b\x32\x34.google.cloud.datalabeling.v1beta1.AnnotationSpecSet"+\n\x1bGetAnnotationSpecSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"f\n\x1dListAnnotationSpecSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x8d\x01\n\x1eListAnnotationSpecSetsResponse\x12R\n\x14\x61nnotation_spec_sets\x18\x01 \x03(\x0b\x32\x34.google.cloud.datalabeling.v1beta1.AnnotationSpecSet\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t".\n\x1e\x44\x65leteAnnotationSpecSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"o\n\x18\x43reateInstructionRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x43\n\x0binstruction\x18\x02 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.Instruction"%\n\x15GetInstructionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"(\n\x18\x44\x65leteInstructionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"`\n\x17ListInstructionsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"y\n\x18ListInstructionsResponse\x12\x44\n\x0cinstructions\x18\x01 \x03(\x0b\x32..google.cloud.datalabeling.v1beta1.Instruction\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"$\n\x14GetEvaluationRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"a\n\x18SearchEvaluationsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"x\n\x19SearchEvaluationsResponse\x12\x42\n\x0b\x65valuations\x18\x01 \x03(\x0b\x32-.google.cloud.datalabeling.v1beta1.Evaluation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"X\n\x1fSearchExampleComparisonsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\xdb\x02\n SearchExampleComparisonsResponse\x12r\n\x13\x65xample_comparisons\x18\x01 \x03(\x0b\x32U.google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.ExampleComparison\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x1a\xa9\x01\n\x11\x45xampleComparison\x12H\n\x14ground_truth_example\x18\x01 \x01(\x0b\x32*.google.cloud.datalabeling.v1beta1.Example\x12J\n\x16model_created_examples\x18\x02 \x03(\x0b\x32*.google.cloud.datalabeling.v1beta1.Example"k\n\x1a\x43reateEvaluationJobRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12=\n\x03job\x18\x02 \x01(\x0b\x32\x30.google.cloud.datalabeling.v1beta1.EvaluationJob"\x97\x01\n\x1aUpdateEvaluationJobRequest\x12H\n\x0e\x65valuation_job\x18\x01 \x01(\x0b\x32\x30.google.cloud.datalabeling.v1beta1.EvaluationJob\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\'\n\x17GetEvaluationJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t")\n\x19PauseEvaluationJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"*\n\x1aResumeEvaluationJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"*\n\x1a\x44\x65leteEvaluationJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"b\n\x19ListEvaluationJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x80\x01\n\x1aListEvaluationJobsResponse\x12I\n\x0f\x65valuation_jobs\x18\x01 \x03(\x0b\x32\x30.google.cloud.datalabeling.v1beta1.EvaluationJob\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xfa\x31\n\x13\x44\x61taLabelingService\x12\xa6\x01\n\rCreateDataset\x12\x37.google.cloud.datalabeling.v1beta1.CreateDatasetRequest\x1a*.google.cloud.datalabeling.v1beta1.Dataset"0\x82\xd3\xe4\x93\x02*"%/v1beta1/{parent=projects/*}/datasets:\x01*\x12\x9d\x01\n\nGetDataset\x12\x34.google.cloud.datalabeling.v1beta1.GetDatasetRequest\x1a*.google.cloud.datalabeling.v1beta1.Dataset"-\x82\xd3\xe4\x93\x02\'\x12%/v1beta1/{name=projects/*/datasets/*}\x12\xae\x01\n\x0cListDatasets\x12\x36.google.cloud.datalabeling.v1beta1.ListDatasetsRequest\x1a\x37.google.cloud.datalabeling.v1beta1.ListDatasetsResponse"-\x82\xd3\xe4\x93\x02\'\x12%/v1beta1/{parent=projects/*}/datasets\x12\x8f\x01\n\rDeleteDataset\x12\x37.google.cloud.datalabeling.v1beta1.DeleteDatasetRequest\x1a\x16.google.protobuf.Empty"-\x82\xd3\xe4\x93\x02\'*%/v1beta1/{name=projects/*/datasets/*}\x12\x9e\x01\n\nImportData\x12\x34.google.cloud.datalabeling.v1beta1.ImportDataRequest\x1a\x1d.google.longrunning.Operation";\x82\xd3\xe4\x93\x02\x35"0/v1beta1/{name=projects/*/datasets/*}:importData:\x01*\x12\x9e\x01\n\nExportData\x12\x34.google.cloud.datalabeling.v1beta1.ExportDataRequest\x1a\x1d.google.longrunning.Operation";\x82\xd3\xe4\x93\x02\x35"0/v1beta1/{name=projects/*/datasets/*}:exportData:\x01*\x12\xac\x01\n\x0bGetDataItem\x12\x35.google.cloud.datalabeling.v1beta1.GetDataItemRequest\x1a+.google.cloud.datalabeling.v1beta1.DataItem"9\x82\xd3\xe4\x93\x02\x33\x12\x31/v1beta1/{name=projects/*/datasets/*/dataItems/*}\x12\xbd\x01\n\rListDataItems\x12\x37.google.cloud.datalabeling.v1beta1.ListDataItemsRequest\x1a\x38.google.cloud.datalabeling.v1beta1.ListDataItemsResponse"9\x82\xd3\xe4\x93\x02\x33\x12\x31/v1beta1/{parent=projects/*/datasets/*}/dataItems\x12\xcc\x01\n\x13GetAnnotatedDataset\x12=.google.cloud.datalabeling.v1beta1.GetAnnotatedDatasetRequest\x1a\x33.google.cloud.datalabeling.v1beta1.AnnotatedDataset"A\x82\xd3\xe4\x93\x02;\x12\x39/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}\x12\xdd\x01\n\x15ListAnnotatedDatasets\x12?.google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest\x1a@.google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1beta1/{parent=projects/*/datasets/*}/annotatedDatasets\x12\xb5\x01\n\x16\x44\x65leteAnnotatedDataset\x12@.google.cloud.datalabeling.v1beta1.DeleteAnnotatedDatasetRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02;*9/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}\x12\xa1\x01\n\nLabelImage\x12\x34.google.cloud.datalabeling.v1beta1.LabelImageRequest\x1a\x1d.google.longrunning.Operation">\x82\xd3\xe4\x93\x02\x38"3/v1beta1/{parent=projects/*/datasets/*}/image:label:\x01*\x12\xa1\x01\n\nLabelVideo\x12\x34.google.cloud.datalabeling.v1beta1.LabelVideoRequest\x1a\x1d.google.longrunning.Operation">\x82\xd3\xe4\x93\x02\x38"3/v1beta1/{parent=projects/*/datasets/*}/video:label:\x01*\x12\x9e\x01\n\tLabelText\x12\x33.google.cloud.datalabeling.v1beta1.LabelTextRequest\x1a\x1d.google.longrunning.Operation"=\x82\xd3\xe4\x93\x02\x37"2/v1beta1/{parent=projects/*/datasets/*}/text:label:\x01*\x12\xbc\x01\n\nGetExample\x12\x34.google.cloud.datalabeling.v1beta1.GetExampleRequest\x1a*.google.cloud.datalabeling.v1beta1.Example"L\x82\xd3\xe4\x93\x02\x46\x12\x44/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*/examples/*}\x12\xcd\x01\n\x0cListExamples\x12\x36.google.cloud.datalabeling.v1beta1.ListExamplesRequest\x1a\x37.google.cloud.datalabeling.v1beta1.ListExamplesResponse"L\x82\xd3\xe4\x93\x02\x46\x12\x44/v1beta1/{parent=projects/*/datasets/*/annotatedDatasets/*}/examples\x12\xce\x01\n\x17\x43reateAnnotationSpecSet\x12\x41.google.cloud.datalabeling.v1beta1.CreateAnnotationSpecSetRequest\x1a\x34.google.cloud.datalabeling.v1beta1.AnnotationSpecSet":\x82\xd3\xe4\x93\x02\x34"//v1beta1/{parent=projects/*}/annotationSpecSets:\x01*\x12\xc5\x01\n\x14GetAnnotationSpecSet\x12>.google.cloud.datalabeling.v1beta1.GetAnnotationSpecSetRequest\x1a\x34.google.cloud.datalabeling.v1beta1.AnnotationSpecSet"7\x82\xd3\xe4\x93\x02\x31\x12//v1beta1/{name=projects/*/annotationSpecSets/*}\x12\xd6\x01\n\x16ListAnnotationSpecSets\x12@.google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest\x1a\x41.google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v1beta1/{parent=projects/*}/annotationSpecSets\x12\xad\x01\n\x17\x44\x65leteAnnotationSpecSet\x12\x41.google.cloud.datalabeling.v1beta1.DeleteAnnotationSpecSetRequest\x1a\x16.google.protobuf.Empty"7\x82\xd3\xe4\x93\x02\x31*//v1beta1/{name=projects/*/annotationSpecSets/*}\x12\xa5\x01\n\x11\x43reateInstruction\x12;.google.cloud.datalabeling.v1beta1.CreateInstructionRequest\x1a\x1d.google.longrunning.Operation"4\x82\xd3\xe4\x93\x02.")/v1beta1/{parent=projects/*}/instructions:\x01*\x12\xad\x01\n\x0eGetInstruction\x12\x38.google.cloud.datalabeling.v1beta1.GetInstructionRequest\x1a..google.cloud.datalabeling.v1beta1.Instruction"1\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{name=projects/*/instructions/*}\x12\xbe\x01\n\x10ListInstructions\x12:.google.cloud.datalabeling.v1beta1.ListInstructionsRequest\x1a;.google.cloud.datalabeling.v1beta1.ListInstructionsResponse"1\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{parent=projects/*}/instructions\x12\x9b\x01\n\x11\x44\x65leteInstruction\x12;.google.cloud.datalabeling.v1beta1.DeleteInstructionRequest\x1a\x16.google.protobuf.Empty"1\x82\xd3\xe4\x93\x02+*)/v1beta1/{name=projects/*/instructions/*}\x12\xb4\x01\n\rGetEvaluation\x12\x37.google.cloud.datalabeling.v1beta1.GetEvaluationRequest\x1a-.google.cloud.datalabeling.v1beta1.Evaluation";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1beta1/{name=projects/*/datasets/*/evaluations/*}\x12\xc7\x01\n\x11SearchEvaluations\x12;.google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest\x1a<.google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v1beta1/{parent=projects/*}/evaluations:search\x12\xff\x01\n\x18SearchExampleComparisons\x12\x42.google.cloud.datalabeling.v1beta1.SearchExampleComparisonsRequest\x1a\x43.google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse"Z\x82\xd3\xe4\x93\x02T"O/v1beta1/{parent=projects/*/datasets/*/evaluations/*}/exampleComparisons:search:\x01*\x12\xbe\x01\n\x13\x43reateEvaluationJob\x12=.google.cloud.datalabeling.v1beta1.CreateEvaluationJobRequest\x1a\x30.google.cloud.datalabeling.v1beta1.EvaluationJob"6\x82\xd3\xe4\x93\x02\x30"+/v1beta1/{parent=projects/*}/evaluationJobs:\x01*\x12\xda\x01\n\x13UpdateEvaluationJob\x12=.google.cloud.datalabeling.v1beta1.UpdateEvaluationJobRequest\x1a\x30.google.cloud.datalabeling.v1beta1.EvaluationJob"R\x82\xd3\xe4\x93\x02L2:/v1beta1/{evaluation_job.name=projects/*/evaluationJobs/*}:\x0e\x65valuation_job\x12\xb5\x01\n\x10GetEvaluationJob\x12:.google.cloud.datalabeling.v1beta1.GetEvaluationJobRequest\x1a\x30.google.cloud.datalabeling.v1beta1.EvaluationJob"3\x82\xd3\xe4\x93\x02-\x12+/v1beta1/{name=projects/*/evaluationJobs/*}\x12\xa8\x01\n\x12PauseEvaluationJob\x12<.google.cloud.datalabeling.v1beta1.PauseEvaluationJobRequest\x1a\x16.google.protobuf.Empty"<\x82\xd3\xe4\x93\x02\x36"1/v1beta1/{name=projects/*/evaluationJobs/*}:pause:\x01*\x12\xab\x01\n\x13ResumeEvaluationJob\x12=.google.cloud.datalabeling.v1beta1.ResumeEvaluationJobRequest\x1a\x16.google.protobuf.Empty"=\x82\xd3\xe4\x93\x02\x37"2/v1beta1/{name=projects/*/evaluationJobs/*}:resume:\x01*\x12\xa1\x01\n\x13\x44\x65leteEvaluationJob\x12=.google.cloud.datalabeling.v1beta1.DeleteEvaluationJobRequest\x1a\x16.google.protobuf.Empty"3\x82\xd3\xe4\x93\x02-*+/v1beta1/{name=projects/*/evaluationJobs/*}\x12\xc6\x01\n\x12ListEvaluationJobs\x12<.google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest\x1a=.google.cloud.datalabeling.v1beta1.ListEvaluationJobsResponse"3\x82\xd3\xe4\x93\x02-\x12+/v1beta1/{parent=projects/*}/evaluationJobs\x1aO\xca\x41\x1b\x64\x61talabeling.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_operations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LABELIMAGEREQUEST_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CLASSIFICATION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOUNDING_BOX", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORIENTED_BOUNDING_BOX",
+            index=3,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOUNDING_POLY", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POLYLINE", index=5, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEGMENTATION", index=6, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2571,
+    serialized_end=2721,
+)
+_sym_db.RegisterEnumDescriptor(_LABELIMAGEREQUEST_FEATURE)
+
+_LABELVIDEOREQUEST_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CLASSIFICATION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_TRACKING",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3295,
+    serialized_end=3403,
+)
+_sym_db.RegisterEnumDescriptor(_LABELVIDEOREQUEST_FEATURE)
+
+_LABELTEXTREQUEST_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_CLASSIFICATION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_ENTITY_EXTRACTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3821,
+    serialized_end=3908,
+)
+_sym_db.RegisterEnumDescriptor(_LABELTEXTREQUEST_FEATURE)
+
+
+_CREATEDATASETREQUEST = _descriptor.Descriptor(
+    name="CreateDatasetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.CreateDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.CreateDatasetRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.datalabeling.v1beta1.CreateDatasetRequest.dataset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=749,
+    serialized_end=848,
+)
+
+
+_GETDATASETREQUEST = _descriptor.Descriptor(
+    name="GetDatasetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetDatasetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=850,
+    serialized_end=883,
+)
+
+
+_LISTDATASETSREQUEST = _descriptor.Descriptor(
+    name="ListDatasetsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListDatasetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListDatasetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListDatasetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListDatasetsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListDatasetsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=885,
+    serialized_end=977,
+)
+
+
+_LISTDATASETSRESPONSE = _descriptor.Descriptor(
+    name="ListDatasetsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListDatasetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="datasets",
+            full_name="google.cloud.datalabeling.v1beta1.ListDatasetsResponse.datasets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListDatasetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=979,
+    serialized_end=1088,
+)
+
+
+_DELETEDATASETREQUEST = _descriptor.Descriptor(
+    name="DeleteDatasetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.DeleteDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.DeleteDatasetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1090,
+    serialized_end=1126,
+)
+
+
+_IMPORTDATAREQUEST = _descriptor.Descriptor(
+    name="ImportDataRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ImportDataRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataRequest.input_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_email_address",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataRequest.user_email_address",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1129,
+    serialized_end=1260,
+)
+
+
+_EXPORTDATAREQUEST = _descriptor.Descriptor(
+    name="ExportDataRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ExportDataRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotated_dataset",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataRequest.annotated_dataset",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataRequest.filter",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataRequest.output_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_email_address",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataRequest.user_email_address",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1263,
+    serialized_end=1439,
+)
+
+
+_GETDATAITEMREQUEST = _descriptor.Descriptor(
+    name="GetDataItemRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetDataItemRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetDataItemRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1441,
+    serialized_end=1475,
+)
+
+
+_LISTDATAITEMSREQUEST = _descriptor.Descriptor(
+    name="ListDataItemsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListDataItemsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListDataItemsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListDataItemsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListDataItemsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListDataItemsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1477,
+    serialized_end=1570,
+)
+
+
+_LISTDATAITEMSRESPONSE = _descriptor.Descriptor(
+    name="ListDataItemsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListDataItemsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="data_items",
+            full_name="google.cloud.datalabeling.v1beta1.ListDataItemsResponse.data_items",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListDataItemsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1572,
+    serialized_end=1685,
+)
+
+
+_GETANNOTATEDDATASETREQUEST = _descriptor.Descriptor(
+    name="GetAnnotatedDatasetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetAnnotatedDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetAnnotatedDatasetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1687,
+    serialized_end=1729,
+)
+
+
+_LISTANNOTATEDDATASETSREQUEST = _descriptor.Descriptor(
+    name="ListAnnotatedDatasetsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1731,
+    serialized_end=1832,
+)
+
+
+_LISTANNOTATEDDATASETSRESPONSE = _descriptor.Descriptor(
+    name="ListAnnotatedDatasetsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotated_datasets",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse.annotated_datasets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1835,
+    serialized_end=1972,
+)
+
+
+_DELETEANNOTATEDDATASETREQUEST = _descriptor.Descriptor(
+    name="DeleteAnnotatedDatasetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.DeleteAnnotatedDatasetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.DeleteAnnotatedDatasetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1974,
+    serialized_end=2019,
+)
+
+
+_LABELIMAGEREQUEST = _descriptor.Descriptor(
+    name="LabelImageRequest",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.image_classification_config",
+            index=0,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.bounding_poly_config",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="polyline_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.polyline_config",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segmentation_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.segmentation_config",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.parent",
+            index=4,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.basic_config",
+            index=5,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.feature",
+            index=6,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LABELIMAGEREQUEST_FEATURE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="request_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageRequest.request_config",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2022,
+    serialized_end=2739,
+)
+
+
+_LABELVIDEOREQUEST = _descriptor.Descriptor(
+    name="LabelVideoRequest",
+    full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="video_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.video_classification_config",
+            index=0,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_detection_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.object_detection_config",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.object_tracking_config",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.event_config",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.parent",
+            index=4,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.basic_config",
+            index=5,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.feature",
+            index=6,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LABELVIDEOREQUEST_FEATURE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="request_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoRequest.request_config",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2742,
+    serialized_end=3421,
+)
+
+
+_LABELTEXTREQUEST = _descriptor.Descriptor(
+    name="LabelTextRequest",
+    full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.text_classification_config",
+            index=0,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_entity_extraction_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.text_entity_extraction_config",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.parent",
+            index=2,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.basic_config",
+            index=3,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.feature",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LABELTEXTREQUEST_FEATURE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="request_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextRequest.request_config",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3424,
+    serialized_end=3926,
+)
+
+
+_GETEXAMPLEREQUEST = _descriptor.Descriptor(
+    name="GetExampleRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetExampleRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetExampleRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.GetExampleRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3928,
+    serialized_end=3977,
+)
+
+
+_LISTEXAMPLESREQUEST = _descriptor.Descriptor(
+    name="ListExamplesRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListExamplesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListExamplesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListExamplesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListExamplesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListExamplesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3979,
+    serialized_end=4071,
+)
+
+
+_LISTEXAMPLESRESPONSE = _descriptor.Descriptor(
+    name="ListExamplesResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListExamplesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="examples",
+            full_name="google.cloud.datalabeling.v1beta1.ListExamplesResponse.examples",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListExamplesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4073,
+    serialized_end=4182,
+)
+
+
+_CREATEANNOTATIONSPECSETREQUEST = _descriptor.Descriptor(
+    name="CreateAnnotationSpecSetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.CreateAnnotationSpecSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.CreateAnnotationSpecSetRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.CreateAnnotationSpecSetRequest.annotation_spec_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4185,
+    serialized_end=4316,
+)
+
+
+_GETANNOTATIONSPECSETREQUEST = _descriptor.Descriptor(
+    name="GetAnnotationSpecSetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetAnnotationSpecSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetAnnotationSpecSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4318,
+    serialized_end=4361,
+)
+
+
+_LISTANNOTATIONSPECSETSREQUEST = _descriptor.Descriptor(
+    name="ListAnnotationSpecSetsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4363,
+    serialized_end=4465,
+)
+
+
+_LISTANNOTATIONSPECSETSRESPONSE = _descriptor.Descriptor(
+    name="ListAnnotationSpecSetsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_sets",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse.annotation_spec_sets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4468,
+    serialized_end=4609,
+)
+
+
+_DELETEANNOTATIONSPECSETREQUEST = _descriptor.Descriptor(
+    name="DeleteAnnotationSpecSetRequest",
+    full_name="google.cloud.datalabeling.v1beta1.DeleteAnnotationSpecSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.DeleteAnnotationSpecSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4611,
+    serialized_end=4657,
+)
+
+
+_CREATEINSTRUCTIONREQUEST = _descriptor.Descriptor(
+    name="CreateInstructionRequest",
+    full_name="google.cloud.datalabeling.v1beta1.CreateInstructionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.CreateInstructionRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instruction",
+            full_name="google.cloud.datalabeling.v1beta1.CreateInstructionRequest.instruction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4659,
+    serialized_end=4770,
+)
+
+
+_GETINSTRUCTIONREQUEST = _descriptor.Descriptor(
+    name="GetInstructionRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetInstructionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetInstructionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4772,
+    serialized_end=4809,
+)
+
+
+_DELETEINSTRUCTIONREQUEST = _descriptor.Descriptor(
+    name="DeleteInstructionRequest",
+    full_name="google.cloud.datalabeling.v1beta1.DeleteInstructionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.DeleteInstructionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4811,
+    serialized_end=4851,
+)
+
+
+_LISTINSTRUCTIONSREQUEST = _descriptor.Descriptor(
+    name="ListInstructionsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListInstructionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListInstructionsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListInstructionsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListInstructionsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListInstructionsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4853,
+    serialized_end=4949,
+)
+
+
+_LISTINSTRUCTIONSRESPONSE = _descriptor.Descriptor(
+    name="ListInstructionsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListInstructionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instructions",
+            full_name="google.cloud.datalabeling.v1beta1.ListInstructionsResponse.instructions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListInstructionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4951,
+    serialized_end=5072,
+)
+
+
+_GETEVALUATIONREQUEST = _descriptor.Descriptor(
+    name="GetEvaluationRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetEvaluationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetEvaluationRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5074,
+    serialized_end=5110,
+)
+
+
+_SEARCHEVALUATIONSREQUEST = _descriptor.Descriptor(
+    name="SearchEvaluationsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5112,
+    serialized_end=5209,
+)
+
+
+_SEARCHEVALUATIONSRESPONSE = _descriptor.Descriptor(
+    name="SearchEvaluationsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="evaluations",
+            full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse.evaluations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5211,
+    serialized_end=5331,
+)
+
+
+_SEARCHEXAMPLECOMPARISONSREQUEST = _descriptor.Descriptor(
+    name="SearchExampleComparisonsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5333,
+    serialized_end=5421,
+)
+
+
+_SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON = _descriptor.Descriptor(
+    name="ExampleComparison",
+    full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.ExampleComparison",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="ground_truth_example",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.ExampleComparison.ground_truth_example",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_created_examples",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.ExampleComparison.model_created_examples",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5602,
+    serialized_end=5771,
+)
+
+_SEARCHEXAMPLECOMPARISONSRESPONSE = _descriptor.Descriptor(
+    name="SearchExampleComparisonsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="example_comparisons",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.example_comparisons",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5424,
+    serialized_end=5771,
+)
+
+
+_CREATEEVALUATIONJOBREQUEST = _descriptor.Descriptor(
+    name="CreateEvaluationJobRequest",
+    full_name="google.cloud.datalabeling.v1beta1.CreateEvaluationJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.CreateEvaluationJobRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.datalabeling.v1beta1.CreateEvaluationJobRequest.job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5773,
+    serialized_end=5880,
+)
+
+
+_UPDATEEVALUATIONJOBREQUEST = _descriptor.Descriptor(
+    name="UpdateEvaluationJobRequest",
+    full_name="google.cloud.datalabeling.v1beta1.UpdateEvaluationJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="evaluation_job",
+            full_name="google.cloud.datalabeling.v1beta1.UpdateEvaluationJobRequest.evaluation_job",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.datalabeling.v1beta1.UpdateEvaluationJobRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5883,
+    serialized_end=6034,
+)
+
+
+_GETEVALUATIONJOBREQUEST = _descriptor.Descriptor(
+    name="GetEvaluationJobRequest",
+    full_name="google.cloud.datalabeling.v1beta1.GetEvaluationJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.GetEvaluationJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6036,
+    serialized_end=6075,
+)
+
+
+_PAUSEEVALUATIONJOBREQUEST = _descriptor.Descriptor(
+    name="PauseEvaluationJobRequest",
+    full_name="google.cloud.datalabeling.v1beta1.PauseEvaluationJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.PauseEvaluationJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6077,
+    serialized_end=6118,
+)
+
+
+_RESUMEEVALUATIONJOBREQUEST = _descriptor.Descriptor(
+    name="ResumeEvaluationJobRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ResumeEvaluationJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.ResumeEvaluationJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6120,
+    serialized_end=6162,
+)
+
+
+_DELETEEVALUATIONJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteEvaluationJobRequest",
+    full_name="google.cloud.datalabeling.v1beta1.DeleteEvaluationJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.DeleteEvaluationJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6164,
+    serialized_end=6206,
+)
+
+
+_LISTEVALUATIONJOBSREQUEST = _descriptor.Descriptor(
+    name="ListEvaluationJobsRequest",
+    full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6208,
+    serialized_end=6306,
+)
+
+
+_LISTEVALUATIONJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListEvaluationJobsResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="evaluation_jobs",
+            full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsResponse.evaluation_jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.datalabeling.v1beta1.ListEvaluationJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6309,
+    serialized_end=6437,
+)
+
+_CREATEDATASETREQUEST.fields_by_name[
+    "dataset"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATASET
+)
+_LISTDATASETSRESPONSE.fields_by_name[
+    "datasets"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATASET
+)
+_IMPORTDATAREQUEST.fields_by_name[
+    "input_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._INPUTCONFIG
+)
+_EXPORTDATAREQUEST.fields_by_name[
+    "output_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._OUTPUTCONFIG
+)
+_LISTDATAITEMSRESPONSE.fields_by_name[
+    "data_items"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATAITEM
+)
+_LISTANNOTATEDDATASETSRESPONSE.fields_by_name[
+    "annotated_datasets"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._ANNOTATEDDATASET
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "image_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._IMAGECLASSIFICATIONCONFIG
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "bounding_poly_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._BOUNDINGPOLYCONFIG
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "polyline_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._POLYLINECONFIG
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "segmentation_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._SEGMENTATIONCONFIG
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELIMAGEREQUEST.fields_by_name["feature"].enum_type = _LABELIMAGEREQUEST_FEATURE
+_LABELIMAGEREQUEST_FEATURE.containing_type = _LABELIMAGEREQUEST
+_LABELIMAGEREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELIMAGEREQUEST.fields_by_name["image_classification_config"]
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "image_classification_config"
+].containing_oneof = _LABELIMAGEREQUEST.oneofs_by_name["request_config"]
+_LABELIMAGEREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELIMAGEREQUEST.fields_by_name["bounding_poly_config"]
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "bounding_poly_config"
+].containing_oneof = _LABELIMAGEREQUEST.oneofs_by_name["request_config"]
+_LABELIMAGEREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELIMAGEREQUEST.fields_by_name["polyline_config"]
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "polyline_config"
+].containing_oneof = _LABELIMAGEREQUEST.oneofs_by_name["request_config"]
+_LABELIMAGEREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELIMAGEREQUEST.fields_by_name["segmentation_config"]
+)
+_LABELIMAGEREQUEST.fields_by_name[
+    "segmentation_config"
+].containing_oneof = _LABELIMAGEREQUEST.oneofs_by_name["request_config"]
+_LABELVIDEOREQUEST.fields_by_name[
+    "video_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._VIDEOCLASSIFICATIONCONFIG
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "object_detection_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._OBJECTDETECTIONCONFIG
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "object_tracking_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._OBJECTTRACKINGCONFIG
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "event_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._EVENTCONFIG
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELVIDEOREQUEST.fields_by_name["feature"].enum_type = _LABELVIDEOREQUEST_FEATURE
+_LABELVIDEOREQUEST_FEATURE.containing_type = _LABELVIDEOREQUEST
+_LABELVIDEOREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELVIDEOREQUEST.fields_by_name["video_classification_config"]
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "video_classification_config"
+].containing_oneof = _LABELVIDEOREQUEST.oneofs_by_name["request_config"]
+_LABELVIDEOREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELVIDEOREQUEST.fields_by_name["object_detection_config"]
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "object_detection_config"
+].containing_oneof = _LABELVIDEOREQUEST.oneofs_by_name["request_config"]
+_LABELVIDEOREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELVIDEOREQUEST.fields_by_name["object_tracking_config"]
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "object_tracking_config"
+].containing_oneof = _LABELVIDEOREQUEST.oneofs_by_name["request_config"]
+_LABELVIDEOREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELVIDEOREQUEST.fields_by_name["event_config"]
+)
+_LABELVIDEOREQUEST.fields_by_name[
+    "event_config"
+].containing_oneof = _LABELVIDEOREQUEST.oneofs_by_name["request_config"]
+_LABELTEXTREQUEST.fields_by_name[
+    "text_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._TEXTCLASSIFICATIONCONFIG
+)
+_LABELTEXTREQUEST.fields_by_name[
+    "text_entity_extraction_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._TEXTENTITYEXTRACTIONCONFIG
+)
+_LABELTEXTREQUEST.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELTEXTREQUEST.fields_by_name["feature"].enum_type = _LABELTEXTREQUEST_FEATURE
+_LABELTEXTREQUEST_FEATURE.containing_type = _LABELTEXTREQUEST
+_LABELTEXTREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELTEXTREQUEST.fields_by_name["text_classification_config"]
+)
+_LABELTEXTREQUEST.fields_by_name[
+    "text_classification_config"
+].containing_oneof = _LABELTEXTREQUEST.oneofs_by_name["request_config"]
+_LABELTEXTREQUEST.oneofs_by_name["request_config"].fields.append(
+    _LABELTEXTREQUEST.fields_by_name["text_entity_extraction_config"]
+)
+_LABELTEXTREQUEST.fields_by_name[
+    "text_entity_extraction_config"
+].containing_oneof = _LABELTEXTREQUEST.oneofs_by_name["request_config"]
+_LISTEXAMPLESRESPONSE.fields_by_name[
+    "examples"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._EXAMPLE
+)
+_CREATEANNOTATIONSPECSETREQUEST.fields_by_name[
+    "annotation_spec_set"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPECSET
+)
+_LISTANNOTATIONSPECSETSRESPONSE.fields_by_name[
+    "annotation_spec_sets"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPECSET
+)
+_CREATEINSTRUCTIONREQUEST.fields_by_name[
+    "instruction"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2._INSTRUCTION
+)
+_LISTINSTRUCTIONSRESPONSE.fields_by_name[
+    "instructions"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2._INSTRUCTION
+)
+_SEARCHEVALUATIONSRESPONSE.fields_by_name[
+    "evaluations"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2._EVALUATION
+)
+_SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON.fields_by_name[
+    "ground_truth_example"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._EXAMPLE
+)
+_SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON.fields_by_name[
+    "model_created_examples"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._EXAMPLE
+)
+_SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON.containing_type = (
+    _SEARCHEXAMPLECOMPARISONSRESPONSE
+)
+_SEARCHEXAMPLECOMPARISONSRESPONSE.fields_by_name[
+    "example_comparisons"
+].message_type = _SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON
+_CREATEEVALUATIONJOBREQUEST.fields_by_name[
+    "job"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2._EVALUATIONJOB
+)
+_UPDATEEVALUATIONJOBREQUEST.fields_by_name[
+    "evaluation_job"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2._EVALUATIONJOB
+)
+_UPDATEEVALUATIONJOBREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTEVALUATIONJOBSRESPONSE.fields_by_name[
+    "evaluation_jobs"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2._EVALUATIONJOB
+)
+DESCRIPTOR.message_types_by_name["CreateDatasetRequest"] = _CREATEDATASETREQUEST
+DESCRIPTOR.message_types_by_name["GetDatasetRequest"] = _GETDATASETREQUEST
+DESCRIPTOR.message_types_by_name["ListDatasetsRequest"] = _LISTDATASETSREQUEST
+DESCRIPTOR.message_types_by_name["ListDatasetsResponse"] = _LISTDATASETSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteDatasetRequest"] = _DELETEDATASETREQUEST
+DESCRIPTOR.message_types_by_name["ImportDataRequest"] = _IMPORTDATAREQUEST
+DESCRIPTOR.message_types_by_name["ExportDataRequest"] = _EXPORTDATAREQUEST
+DESCRIPTOR.message_types_by_name["GetDataItemRequest"] = _GETDATAITEMREQUEST
+DESCRIPTOR.message_types_by_name["ListDataItemsRequest"] = _LISTDATAITEMSREQUEST
+DESCRIPTOR.message_types_by_name["ListDataItemsResponse"] = _LISTDATAITEMSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetAnnotatedDatasetRequest"
+] = _GETANNOTATEDDATASETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAnnotatedDatasetsRequest"
+] = _LISTANNOTATEDDATASETSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAnnotatedDatasetsResponse"
+] = _LISTANNOTATEDDATASETSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteAnnotatedDatasetRequest"
+] = _DELETEANNOTATEDDATASETREQUEST
+DESCRIPTOR.message_types_by_name["LabelImageRequest"] = _LABELIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["LabelVideoRequest"] = _LABELVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["LabelTextRequest"] = _LABELTEXTREQUEST
+DESCRIPTOR.message_types_by_name["GetExampleRequest"] = _GETEXAMPLEREQUEST
+DESCRIPTOR.message_types_by_name["ListExamplesRequest"] = _LISTEXAMPLESREQUEST
+DESCRIPTOR.message_types_by_name["ListExamplesResponse"] = _LISTEXAMPLESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "CreateAnnotationSpecSetRequest"
+] = _CREATEANNOTATIONSPECSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetAnnotationSpecSetRequest"
+] = _GETANNOTATIONSPECSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAnnotationSpecSetsRequest"
+] = _LISTANNOTATIONSPECSETSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAnnotationSpecSetsResponse"
+] = _LISTANNOTATIONSPECSETSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteAnnotationSpecSetRequest"
+] = _DELETEANNOTATIONSPECSETREQUEST
+DESCRIPTOR.message_types_by_name["CreateInstructionRequest"] = _CREATEINSTRUCTIONREQUEST
+DESCRIPTOR.message_types_by_name["GetInstructionRequest"] = _GETINSTRUCTIONREQUEST
+DESCRIPTOR.message_types_by_name["DeleteInstructionRequest"] = _DELETEINSTRUCTIONREQUEST
+DESCRIPTOR.message_types_by_name["ListInstructionsRequest"] = _LISTINSTRUCTIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListInstructionsResponse"] = _LISTINSTRUCTIONSRESPONSE
+DESCRIPTOR.message_types_by_name["GetEvaluationRequest"] = _GETEVALUATIONREQUEST
+DESCRIPTOR.message_types_by_name["SearchEvaluationsRequest"] = _SEARCHEVALUATIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SearchEvaluationsResponse"
+] = _SEARCHEVALUATIONSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "SearchExampleComparisonsRequest"
+] = _SEARCHEXAMPLECOMPARISONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SearchExampleComparisonsResponse"
+] = _SEARCHEXAMPLECOMPARISONSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "CreateEvaluationJobRequest"
+] = _CREATEEVALUATIONJOBREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateEvaluationJobRequest"
+] = _UPDATEEVALUATIONJOBREQUEST
+DESCRIPTOR.message_types_by_name["GetEvaluationJobRequest"] = _GETEVALUATIONJOBREQUEST
+DESCRIPTOR.message_types_by_name[
+    "PauseEvaluationJobRequest"
+] = _PAUSEEVALUATIONJOBREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ResumeEvaluationJobRequest"
+] = _RESUMEEVALUATIONJOBREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteEvaluationJobRequest"
+] = _DELETEEVALUATIONJOBREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListEvaluationJobsRequest"
+] = _LISTEVALUATIONJOBSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListEvaluationJobsResponse"
+] = _LISTEVALUATIONJOBSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDATASETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for CreateDataset.
+  
+  
+  Attributes:
+      parent:
+          Required. Dataset resource parent, format:
+          projects/{project\_id}
+      dataset:
+          Required. The dataset to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.CreateDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDatasetRequest)
+
+GetDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATASETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetDataSet.
+  
+  
+  Attributes:
+      name:
+          Required. Dataset resource name, format:
+          projects/{project\_id}/datasets/{dataset\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDatasetRequest)
+
+ListDatasetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDatasetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASETSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListDataset.
+  
+  
+  Attributes:
+      parent:
+          Required. Dataset resource parent, format:
+          projects/{project\_id}
+      filter:
+          Optional. Filter on dataset is not supported at this moment.
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [ListDatasetsResponse.next\_p
+          age\_token][google.cloud.datalabeling.v1beta1.ListDatasetsResp
+          onse.next\_page\_token] of the previous
+          [DataLabelingService.ListDatasets] call. Returns the first
+          page if empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListDatasetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDatasetsRequest)
+
+ListDatasetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDatasetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATASETSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of listing datasets within a project.
+  
+  
+  Attributes:
+      datasets:
+          The list of datasets to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListDatasetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDatasetsResponse)
+
+DeleteDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDATASETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for DeleteDataset.
+  
+  
+  Attributes:
+      name:
+          Required. Dataset resource name, format:
+          projects/{project\_id}/datasets/{dataset\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.DeleteDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDatasetRequest)
+
+ImportDataRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportDataRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDATAREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ImportData API.
+  
+  
+  Attributes:
+      name:
+          Required. Dataset resource name, format:
+          projects/{project\_id}/datasets/{dataset\_id}
+      input_config:
+          Required. Specify the input source of the data.
+      user_email_address:
+          Email of the user who started the import task and should be
+          notified by email. If empty no notification will be sent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImportDataRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportDataRequest)
+
+ExportDataRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportDataRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDATAREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ExportData API.
+  
+  
+  Attributes:
+      name:
+          Required. Dataset resource name, format:
+          projects/{project\_id}/datasets/{dataset\_id}
+      annotated_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/{d
+          ataset\_id}/annotatedDatasets/ {annotated\_dataset\_id}
+      filter:
+          Optional. Filter is not supported at this moment.
+      output_config:
+          Required. Specify the output destination.
+      user_email_address:
+          Email of the user who started the export task and should be
+          notified by email. If empty no notification will be sent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ExportDataRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportDataRequest)
+
+GetDataItemRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDataItemRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATAITEMREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetDataItem.
+  
+  
+  Attributes:
+      name:
+          Required. The name of the data item to get, format: projects/{
+          project\_id}/datasets/{dataset\_id}/dataItems/{data\_item\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetDataItemRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDataItemRequest)
+
+ListDataItemsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDataItemsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATAITEMSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListDataItems.
+  
+  
+  Attributes:
+      parent:
+          Required. Name of the dataset to list data items, format:
+          projects/{project\_id}/datasets/{dataset\_id}
+      filter:
+          Optional. Filter is not supported at this moment.
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [ListDataItemsResponse.next\_
+          page\_token][google.cloud.datalabeling.v1beta1.ListDataItemsRe
+          sponse.next\_page\_token] of the previous
+          [DataLabelingService.ListDataItems] call. Return first page if
+          empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListDataItemsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDataItemsRequest)
+
+ListDataItemsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDataItemsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATAITEMSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of listing data items in a dataset.
+  
+  
+  Attributes:
+      data_items:
+          The list of data items to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListDataItemsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDataItemsResponse)
+
+GetAnnotatedDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetAnnotatedDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETANNOTATEDDATASETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetAnnotatedDataset.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the annotated dataset to get, format: projec
+          ts/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/
+          {annotated\_dataset\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetAnnotatedDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetAnnotatedDatasetRequest)
+
+ListAnnotatedDatasetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAnnotatedDatasetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTANNOTATEDDATASETSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListAnnotatedDatasets.
+  
+  
+  Attributes:
+      parent:
+          Required. Name of the dataset to list annotated datasets,
+          format: projects/{project\_id}/datasets/{dataset\_id}
+      filter:
+          Optional. Filter is not supported at this moment.
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [ListAnnotatedDatasetsRespons
+          e.next\_page\_token][google.cloud.datalabeling.v1beta1.ListAnn
+          otatedDatasetsResponse.next\_page\_token] of the previous
+          [DataLabelingService.ListAnnotatedDatasets] call. Return first
+          page if empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAnnotatedDatasetsRequest)
+
+ListAnnotatedDatasetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAnnotatedDatasetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTANNOTATEDDATASETSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of listing annotated datasets for a dataset.
+  
+  
+  Attributes:
+      annotated_datasets:
+          The list of annotated datasets to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAnnotatedDatasetsResponse)
+
+DeleteAnnotatedDatasetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteAnnotatedDatasetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEANNOTATEDDATASETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for DeleteAnnotatedDataset.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the annotated dataset to delete, format: pro
+          jects/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/
+          {annotated\_dataset\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.DeleteAnnotatedDatasetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteAnnotatedDatasetRequest)
+
+LabelImageRequest = _reflection.GeneratedProtocolMessageType(
+    "LabelImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGEREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for starting an image labeling task.
+  
+  
+  Attributes:
+      request_config:
+          Required. Config for labeling tasks. The type of request
+          config must match the selected feature.
+      image_classification_config:
+          Configuration for image classification task. One of
+          image\_classification\_config, bounding\_poly\_config,
+          polyline\_config and segmentation\_config are required.
+      bounding_poly_config:
+          Configuration for bounding box and bounding poly task. One of
+          image\_classification\_config, bounding\_poly\_config,
+          polyline\_config and segmentation\_config are required.
+      polyline_config:
+          Configuration for polyline task. One of
+          image\_classification\_config, bounding\_poly\_config,
+          polyline\_config and segmentation\_config are required.
+      segmentation_config:
+          Configuration for segmentation task. One of
+          image\_classification\_config, bounding\_poly\_config,
+          polyline\_config and segmentation\_config are required.
+      parent:
+          Required. Name of the dataset to request labeling task,
+          format: projects/{project\_id}/datasets/{dataset\_id}
+      basic_config:
+          Required. Basic human annotation config.
+      feature:
+          Required. The type of image labeling task.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(LabelImageRequest)
+
+LabelVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "LabelVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELVIDEOREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for LabelVideo.
+  
+  
+  Attributes:
+      request_config:
+          Required. Config for labeling tasks. The type of request
+          config must match the selected feature.
+      video_classification_config:
+          Configuration for video classification task. One of
+          video\_classification\_config, object\_detection\_config,
+          object\_tracking\_config and event\_config is required.
+      object_detection_config:
+          Configuration for video object detection task. One of
+          video\_classification\_config, object\_detection\_config,
+          object\_tracking\_config and event\_config is required.
+      object_tracking_config:
+          Configuration for video object tracking task. One of
+          video\_classification\_config, object\_detection\_config,
+          object\_tracking\_config and event\_config is required.
+      event_config:
+          Configuration for video event task. One of
+          video\_classification\_config, object\_detection\_config,
+          object\_tracking\_config and event\_config is required.
+      parent:
+          Required. Name of the dataset to request labeling task,
+          format: projects/{project\_id}/datasets/{dataset\_id}
+      basic_config:
+          Required. Basic human annotation config.
+      feature:
+          Required. The type of video labeling task.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(LabelVideoRequest)
+
+LabelTextRequest = _reflection.GeneratedProtocolMessageType(
+    "LabelTextRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELTEXTREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for LabelText.
+  
+  
+  Attributes:
+      request_config:
+          Required. Config for labeling tasks. The type of request
+          config must match the selected feature.
+      text_classification_config:
+          Configuration for text classification task. One of
+          text\_classification\_config and
+          text\_entity\_extraction\_config is required.
+      text_entity_extraction_config:
+          Configuration for entity extraction task. One of
+          text\_classification\_config and
+          text\_entity\_extraction\_config is required.
+      parent:
+          Required. Name of the data set to request labeling task,
+          format: projects/{project\_id}/datasets/{dataset\_id}
+      basic_config:
+          Required. Basic human annotation config.
+      feature:
+          Required. The type of text labeling task.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(LabelTextRequest)
+
+GetExampleRequest = _reflection.GeneratedProtocolMessageType(
+    "GetExampleRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETEXAMPLEREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetExample
+  
+  
+  Attributes:
+      name:
+          Required. Name of example, format: projects/{project\_id}/data
+          sets/{dataset\_id}/annotatedDatasets/
+          {annotated\_dataset\_id}/examples/{example\_id}
+      filter:
+          Optional. An expression for filtering Examples. Filter by
+          annotation\_spec.display\_name is supported. Format
+          "annotation\_spec.display\_name = {display\_name}"
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetExampleRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetExampleRequest)
+
+ListExamplesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListExamplesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEXAMPLESREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListExamples.
+  
+  
+  Attributes:
+      parent:
+          Required. Example resource parent.
+      filter:
+          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}"
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [ListExamplesResponse.next\_p
+          age\_token][google.cloud.datalabeling.v1beta1.ListExamplesResp
+          onse.next\_page\_token] of the previous
+          [DataLabelingService.ListExamples] call. Return first page if
+          empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListExamplesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListExamplesRequest)
+
+ListExamplesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListExamplesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEXAMPLESRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of listing Examples in and annotated dataset.
+  
+  
+  Attributes:
+      examples:
+          The list of examples to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListExamplesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListExamplesResponse)
+
+CreateAnnotationSpecSetRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateAnnotationSpecSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEANNOTATIONSPECSETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for CreateAnnotationSpecSet.
+  
+  
+  Attributes:
+      parent:
+          Required. AnnotationSpecSet resource parent, format:
+          projects/{project\_id}
+      annotation_spec_set:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.CreateAnnotationSpecSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateAnnotationSpecSetRequest)
+
+GetAnnotationSpecSetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetAnnotationSpecSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETANNOTATIONSPECSETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetAnnotationSpecSet.
+  
+  
+  Attributes:
+      name:
+          Required. AnnotationSpecSet resource name, format: projects/{p
+          roject\_id}/annotationSpecSets/{annotation\_spec\_set\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetAnnotationSpecSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetAnnotationSpecSetRequest)
+
+ListAnnotationSpecSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAnnotationSpecSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTANNOTATIONSPECSETSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListAnnotationSpecSets.
+  
+  
+  Attributes:
+      parent:
+          Required. Parent of AnnotationSpecSet resource, format:
+          projects/{project\_id}
+      filter:
+          Optional. Filter is not supported at this moment.
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [ListAnnotationSpecSetsRespon
+          se.next\_page\_token][google.cloud.datalabeling.v1beta1.ListAn
+          notationSpecSetsResponse.next\_page\_token] of the previous
+          [DataLabelingService.ListAnnotationSpecSets] call. Return
+          first page if empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAnnotationSpecSetsRequest)
+
+ListAnnotationSpecSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAnnotationSpecSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTANNOTATIONSPECSETSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of listing annotation spec set under a project.
+  
+  
+  Attributes:
+      annotation_spec_sets:
+          The list of annotation spec sets.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAnnotationSpecSetsResponse)
+
+DeleteAnnotationSpecSetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteAnnotationSpecSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEANNOTATIONSPECSETREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for DeleteAnnotationSpecSet.
+  
+  
+  Attributes:
+      name:
+          Required. AnnotationSpec resource name, format: ``projects/{pr
+          oject_id}/annotationSpecSets/{annotation_spec_set_id}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.DeleteAnnotationSpecSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteAnnotationSpecSetRequest)
+
+CreateInstructionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateInstructionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTRUCTIONREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for CreateInstruction.
+  
+  
+  Attributes:
+      parent:
+          Required. Instruction resource parent, format:
+          projects/{project\_id}
+      instruction:
+          Required. Instruction of how to perform the labeling task.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.CreateInstructionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstructionRequest)
+
+GetInstructionRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInstructionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSTRUCTIONREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetInstruction.
+  
+  
+  Attributes:
+      name:
+          Required. Instruction resource name, format:
+          projects/{project\_id}/instructions/{instruction\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetInstructionRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInstructionRequest)
+
+DeleteInstructionRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteInstructionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINSTRUCTIONREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for DeleteInstruction.
+  
+  
+  Attributes:
+      name:
+          Required. Instruction resource name, format:
+          projects/{project\_id}/instructions/{instruction\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.DeleteInstructionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteInstructionRequest)
+
+ListInstructionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInstructionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTRUCTIONSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListInstructions.
+  
+  
+  Attributes:
+      parent:
+          Required. Instruction resource parent, format:
+          projects/{project\_id}
+      filter:
+          Optional. Filter is not supported at this moment.
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [ListInstructionsResponse.nex
+          t\_page\_token][google.cloud.datalabeling.v1beta1.ListInstruct
+          ionsResponse.next\_page\_token] of the previous
+          [DataLabelingService.ListInstructions] call. Return first page
+          if empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListInstructionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInstructionsRequest)
+
+ListInstructionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInstructionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTRUCTIONSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of listing instructions under a project.
+  
+  
+  Attributes:
+      instructions:
+          The list of Instructions to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListInstructionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInstructionsResponse)
+
+GetEvaluationRequest = _reflection.GeneratedProtocolMessageType(
+    "GetEvaluationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETEVALUATIONREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetEvaluation.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the evaluation. Format: 'projects/{project\_
+          id}/datasets/{dataset\_id}/evaluations/{evaluation\_id}'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetEvaluationRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetEvaluationRequest)
+
+SearchEvaluationsRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchEvaluationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHEVALUATIONSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for SearchEvaluation.
+  
+  
+  Attributes:
+      parent:
+          Required. Evaluation search parent. Format:
+          projects/{project\_id}
+      filter:
+          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}"
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          Optional. A token identifying a page of results for the server
+          to return. Typically obtained by [SearchEvaluationsResponse.ne
+          xt\_page\_token][google.cloud.datalabeling.v1beta1.SearchEvalu
+          ationsResponse.next\_page\_token] of the previous
+          [DataLabelingService.SearchEvaluations] call. Return first
+          page if empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SearchEvaluationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchEvaluationsRequest)
+
+SearchEvaluationsResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchEvaluationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHEVALUATIONSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of searching evaluations.
+  
+  
+  Attributes:
+      evaluations:
+          The list of evaluations to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchEvaluationsResponse)
+
+SearchExampleComparisonsRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchExampleComparisonsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHEXAMPLECOMPARISONSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message of SearchExampleComparisons.
+  
+  
+  Attributes:
+      parent:
+          Required. Name of the Evaluation resource to search example
+          comparison from. Format: projects/{project\_id}/datasets/{data
+          set\_id}/evaluations/{evaluation\_id}
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SearchExampleComparisonsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchExampleComparisonsRequest)
+
+SearchExampleComparisonsResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchExampleComparisonsResponse",
+    (_message.Message,),
+    dict(
+        ExampleComparison=_reflection.GeneratedProtocolMessageType(
+            "ExampleComparison",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHEXAMPLECOMPARISONSRESPONSE_EXAMPLECOMPARISON,
+                __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+                __doc__="""Example comparisons containing annotation comparison between groundtruth
+    and predictions.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse.ExampleComparison)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHEXAMPLECOMPARISONSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results of searching example comparisons.
+  
+  
+  Attributes:
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SearchExampleComparisonsResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchExampleComparisonsResponse)
+_sym_db.RegisterMessage(SearchExampleComparisonsResponse.ExampleComparison)
+
+CreateEvaluationJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateEvaluationJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEEVALUATIONJOBREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for CreateEvaluationJob.
+  
+  
+  Attributes:
+      parent:
+          Required. Evaluation job resource parent, format:
+          projects/{project\_id}.
+      job:
+          Required. The evaluation job to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.CreateEvaluationJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateEvaluationJobRequest)
+
+UpdateEvaluationJobRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateEvaluationJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEEVALUATIONJOBREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for UpdateEvaluationJob.
+  
+  
+  Attributes:
+      evaluation_job:
+          Required. Evaluation job that is going to be updated.
+      update_mask:
+          Optional. Mask for which field in evaluation\_job should be
+          updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.UpdateEvaluationJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateEvaluationJobRequest)
+
+GetEvaluationJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetEvaluationJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETEVALUATIONJOBREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for GetEvaluationJob.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the evaluation job. Format:
+          'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GetEvaluationJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetEvaluationJobRequest)
+
+PauseEvaluationJobRequest = _reflection.GeneratedProtocolMessageType(
+    "PauseEvaluationJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAUSEEVALUATIONJOBREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for PauseEvaluationJob.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the evaluation job that is going to be
+          paused. Format:
+          'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.PauseEvaluationJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(PauseEvaluationJobRequest)
+
+ResumeEvaluationJobRequest = _reflection.GeneratedProtocolMessageType(
+    "ResumeEvaluationJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUMEEVALUATIONJOBREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message ResumeEvaluationJob.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the evaluation job that is going to be
+          resumed. Format:
+          'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ResumeEvaluationJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(ResumeEvaluationJobRequest)
+
+DeleteEvaluationJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteEvaluationJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEEVALUATIONJOBREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message DeleteEvaluationJob.
+  
+  
+  Attributes:
+      name:
+          Required. Name of the evaluation job that is going to be
+          deleted. Format:
+          'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.DeleteEvaluationJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteEvaluationJobRequest)
+
+ListEvaluationJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListEvaluationJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEVALUATIONJOBSREQUEST,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Request message for ListEvaluationJobs.
+  
+  
+  Attributes:
+      parent:
+          Required. Evaluation resource parent. Format:
+          "projects/{project\_id}"
+      filter:
+          Optional. Only support filter by model id and job state.
+          Format: "evaluation\_job.model\_id = {model\_id} AND
+          evaluation\_job.state = {EvaluationJob::State}"
+      page_size:
+          Optional. Requested page size. Server may return fewer results
+          than requested. Default value is 100.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListEvaluationJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListEvaluationJobsRequest)
+
+ListEvaluationJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListEvaluationJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEVALUATIONJOBSRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_labeling_service_pb2",
+        __doc__="""Results for listing evaluation jobs.
+  
+  
+  Attributes:
+      evaluation_jobs:
+          The list of evaluation jobs to return.
+      next_page_token:
+          A token to retrieve next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ListEvaluationJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListEvaluationJobsResponse)
+
+
+DESCRIPTOR._options = None
+
+_DATALABELINGSERVICE = _descriptor.ServiceDescriptor(
+    name="DataLabelingService",
+    full_name="google.cloud.datalabeling.v1beta1.DataLabelingService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\033datalabeling.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=6440,
+    serialized_end=12834,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateDataset",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.CreateDataset",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEDATASETREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATASET,
+            serialized_options=_b(
+                '\202\323\344\223\002*"%/v1beta1/{parent=projects/*}/datasets:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDataset",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetDataset",
+            index=1,
+            containing_service=None,
+            input_type=_GETDATASETREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATASET,
+            serialized_options=_b(
+                "\202\323\344\223\002'\022%/v1beta1/{name=projects/*/datasets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDatasets",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListDatasets",
+            index=2,
+            containing_service=None,
+            input_type=_LISTDATASETSREQUEST,
+            output_type=_LISTDATASETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002'\022%/v1beta1/{parent=projects/*}/datasets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDataset",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.DeleteDataset",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEDATASETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002'*%/v1beta1/{name=projects/*/datasets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportData",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ImportData",
+            index=4,
+            containing_service=None,
+            input_type=_IMPORTDATAREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0025"0/v1beta1/{name=projects/*/datasets/*}:importData:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportData",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ExportData",
+            index=5,
+            containing_service=None,
+            input_type=_EXPORTDATAREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0025"0/v1beta1/{name=projects/*/datasets/*}:exportData:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDataItem",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetDataItem",
+            index=6,
+            containing_service=None,
+            input_type=_GETDATAITEMREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATAITEM,
+            serialized_options=_b(
+                "\202\323\344\223\0023\0221/v1beta1/{name=projects/*/datasets/*/dataItems/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDataItems",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListDataItems",
+            index=7,
+            containing_service=None,
+            input_type=_LISTDATAITEMSREQUEST,
+            output_type=_LISTDATAITEMSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0023\0221/v1beta1/{parent=projects/*/datasets/*}/dataItems"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetAnnotatedDataset",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetAnnotatedDataset",
+            index=8,
+            containing_service=None,
+            input_type=_GETANNOTATEDDATASETREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._ANNOTATEDDATASET,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAnnotatedDatasets",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListAnnotatedDatasets",
+            index=9,
+            containing_service=None,
+            input_type=_LISTANNOTATEDDATASETSREQUEST,
+            output_type=_LISTANNOTATEDDATASETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1beta1/{parent=projects/*/datasets/*}/annotatedDatasets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteAnnotatedDataset",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.DeleteAnnotatedDataset",
+            index=10,
+            containing_service=None,
+            input_type=_DELETEANNOTATEDDATASETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002;*9/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LabelImage",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.LabelImage",
+            index=11,
+            containing_service=None,
+            input_type=_LABELIMAGEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0028"3/v1beta1/{parent=projects/*/datasets/*}/image:label:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LabelVideo",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.LabelVideo",
+            index=12,
+            containing_service=None,
+            input_type=_LABELVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0028"3/v1beta1/{parent=projects/*/datasets/*}/video:label:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LabelText",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.LabelText",
+            index=13,
+            containing_service=None,
+            input_type=_LABELTEXTREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1beta1/{parent=projects/*/datasets/*}/text:label:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetExample",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetExample",
+            index=14,
+            containing_service=None,
+            input_type=_GETEXAMPLEREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._EXAMPLE,
+            serialized_options=_b(
+                "\202\323\344\223\002F\022D/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*/examples/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListExamples",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListExamples",
+            index=15,
+            containing_service=None,
+            input_type=_LISTEXAMPLESREQUEST,
+            output_type=_LISTEXAMPLESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002F\022D/v1beta1/{parent=projects/*/datasets/*/annotatedDatasets/*}/examples"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateAnnotationSpecSet",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.CreateAnnotationSpecSet",
+            index=16,
+            containing_service=None,
+            input_type=_CREATEANNOTATIONSPECSETREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPECSET,
+            serialized_options=_b(
+                '\202\323\344\223\0024"//v1beta1/{parent=projects/*}/annotationSpecSets:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetAnnotationSpecSet",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetAnnotationSpecSet",
+            index=17,
+            containing_service=None,
+            input_type=_GETANNOTATIONSPECSETREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPECSET,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1beta1/{name=projects/*/annotationSpecSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAnnotationSpecSets",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListAnnotationSpecSets",
+            index=18,
+            containing_service=None,
+            input_type=_LISTANNOTATIONSPECSETSREQUEST,
+            output_type=_LISTANNOTATIONSPECSETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1beta1/{parent=projects/*}/annotationSpecSets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteAnnotationSpecSet",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.DeleteAnnotationSpecSet",
+            index=19,
+            containing_service=None,
+            input_type=_DELETEANNOTATIONSPECSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v1beta1/{name=projects/*/annotationSpecSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateInstruction",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.CreateInstruction",
+            index=20,
+            containing_service=None,
+            input_type=_CREATEINSTRUCTIONREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002.")/v1beta1/{parent=projects/*}/instructions:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInstruction",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetInstruction",
+            index=21,
+            containing_service=None,
+            input_type=_GETINSTRUCTIONREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2._INSTRUCTION,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1beta1/{name=projects/*/instructions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListInstructions",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListInstructions",
+            index=22,
+            containing_service=None,
+            input_type=_LISTINSTRUCTIONSREQUEST,
+            output_type=_LISTINSTRUCTIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1beta1/{parent=projects/*}/instructions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteInstruction",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.DeleteInstruction",
+            index=23,
+            containing_service=None,
+            input_type=_DELETEINSTRUCTIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002+*)/v1beta1/{name=projects/*/instructions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetEvaluation",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetEvaluation",
+            index=24,
+            containing_service=None,
+            input_type=_GETEVALUATIONREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2._EVALUATION,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1beta1/{name=projects/*/datasets/*/evaluations/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchEvaluations",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.SearchEvaluations",
+            index=25,
+            containing_service=None,
+            input_type=_SEARCHEVALUATIONSREQUEST,
+            output_type=_SEARCHEVALUATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1beta1/{parent=projects/*}/evaluations:search"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchExampleComparisons",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.SearchExampleComparisons",
+            index=26,
+            containing_service=None,
+            input_type=_SEARCHEXAMPLECOMPARISONSREQUEST,
+            output_type=_SEARCHEXAMPLECOMPARISONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002T"O/v1beta1/{parent=projects/*/datasets/*/evaluations/*}/exampleComparisons:search:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateEvaluationJob",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.CreateEvaluationJob",
+            index=27,
+            containing_service=None,
+            input_type=_CREATEEVALUATIONJOBREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2._EVALUATIONJOB,
+            serialized_options=_b(
+                '\202\323\344\223\0020"+/v1beta1/{parent=projects/*}/evaluationJobs:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateEvaluationJob",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.UpdateEvaluationJob",
+            index=28,
+            containing_service=None,
+            input_type=_UPDATEEVALUATIONJOBREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2._EVALUATIONJOB,
+            serialized_options=_b(
+                "\202\323\344\223\002L2:/v1beta1/{evaluation_job.name=projects/*/evaluationJobs/*}:\016evaluation_job"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetEvaluationJob",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.GetEvaluationJob",
+            index=29,
+            containing_service=None,
+            input_type=_GETEVALUATIONJOBREQUEST,
+            output_type=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2._EVALUATIONJOB,
+            serialized_options=_b(
+                "\202\323\344\223\002-\022+/v1beta1/{name=projects/*/evaluationJobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PauseEvaluationJob",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.PauseEvaluationJob",
+            index=30,
+            containing_service=None,
+            input_type=_PAUSEEVALUATIONJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\0026"1/v1beta1/{name=projects/*/evaluationJobs/*}:pause:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ResumeEvaluationJob",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ResumeEvaluationJob",
+            index=31,
+            containing_service=None,
+            input_type=_RESUMEEVALUATIONJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1beta1/{name=projects/*/evaluationJobs/*}:resume:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteEvaluationJob",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.DeleteEvaluationJob",
+            index=32,
+            containing_service=None,
+            input_type=_DELETEEVALUATIONJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002-*+/v1beta1/{name=projects/*/evaluationJobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListEvaluationJobs",
+            full_name="google.cloud.datalabeling.v1beta1.DataLabelingService.ListEvaluationJobs",
+            index=33,
+            containing_service=None,
+            input_type=_LISTEVALUATIONJOBSREQUEST,
+            output_type=_LISTEVALUATIONJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002-\022+/v1beta1/{parent=projects/*}/evaluationJobs"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DATALABELINGSERVICE)
+
+DESCRIPTOR.services_by_name["DataLabelingService"] = _DATALABELINGSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service_pb2_grpc.py
new file mode 100644
index 000000000000..679841fb13e9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_labeling_service_pb2_grpc.py
@@ -0,0 +1,644 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_spec_set_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    data_labeling_service_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    evaluation_job_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    evaluation_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    instruction_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DataLabelingServiceStub(object):
+    # missing associated documentation comment in .proto file
+    pass
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateDataset = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/CreateDataset",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.Dataset.FromString,
+        )
+        self.GetDataset = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetDataset",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.Dataset.FromString,
+        )
+        self.ListDatasets = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListDatasets",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDatasetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDatasetsResponse.FromString,
+        )
+        self.DeleteDataset = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/DeleteDataset",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ImportData = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ImportData",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ImportDataRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ExportData = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ExportData",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ExportDataRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetDataItem = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetDataItem",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetDataItemRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.DataItem.FromString,
+        )
+        self.ListDataItems = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListDataItems",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDataItemsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDataItemsResponse.FromString,
+        )
+        self.GetAnnotatedDataset = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetAnnotatedDataset",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetAnnotatedDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.AnnotatedDataset.FromString,
+        )
+        self.ListAnnotatedDatasets = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListAnnotatedDatasets",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotatedDatasetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotatedDatasetsResponse.FromString,
+        )
+        self.DeleteAnnotatedDataset = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/DeleteAnnotatedDataset",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteAnnotatedDatasetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.LabelImage = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/LabelImage",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.LabelImageRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.LabelVideo = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/LabelVideo",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.LabelVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.LabelText = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/LabelText",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.LabelTextRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetExample = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetExample",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetExampleRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.Example.FromString,
+        )
+        self.ListExamples = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListExamples",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListExamplesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListExamplesResponse.FromString,
+        )
+        self.CreateAnnotationSpecSet = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/CreateAnnotationSpecSet",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateAnnotationSpecSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.AnnotationSpecSet.FromString,
+        )
+        self.GetAnnotationSpecSet = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetAnnotationSpecSet",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetAnnotationSpecSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.AnnotationSpecSet.FromString,
+        )
+        self.ListAnnotationSpecSets = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListAnnotationSpecSets",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotationSpecSetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotationSpecSetsResponse.FromString,
+        )
+        self.DeleteAnnotationSpecSet = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/DeleteAnnotationSpecSet",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteAnnotationSpecSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateInstruction = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/CreateInstruction",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateInstructionRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetInstruction = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetInstruction",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetInstructionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2.Instruction.FromString,
+        )
+        self.ListInstructions = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListInstructions",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListInstructionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListInstructionsResponse.FromString,
+        )
+        self.DeleteInstruction = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/DeleteInstruction",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteInstructionRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetEvaluation = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetEvaluation",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetEvaluationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2.Evaluation.FromString,
+        )
+        self.SearchEvaluations = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/SearchEvaluations",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchEvaluationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchEvaluationsResponse.FromString,
+        )
+        self.SearchExampleComparisons = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/SearchExampleComparisons",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchExampleComparisonsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchExampleComparisonsResponse.FromString,
+        )
+        self.CreateEvaluationJob = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/CreateEvaluationJob",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateEvaluationJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.EvaluationJob.FromString,
+        )
+        self.UpdateEvaluationJob = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/UpdateEvaluationJob",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.UpdateEvaluationJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.EvaluationJob.FromString,
+        )
+        self.GetEvaluationJob = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/GetEvaluationJob",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetEvaluationJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.EvaluationJob.FromString,
+        )
+        self.PauseEvaluationJob = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/PauseEvaluationJob",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.PauseEvaluationJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ResumeEvaluationJob = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ResumeEvaluationJob",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ResumeEvaluationJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.DeleteEvaluationJob = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/DeleteEvaluationJob",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteEvaluationJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListEvaluationJobs = channel.unary_unary(
+            "/google.cloud.datalabeling.v1beta1.DataLabelingService/ListEvaluationJobs",
+            request_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListEvaluationJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListEvaluationJobsResponse.FromString,
+        )
+
+
+class DataLabelingServiceServicer(object):
+    # missing associated documentation comment in .proto file
+    pass
+
+    def CreateDataset(self, request, context):
+        """Creates dataset. If success return a Dataset resource.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDataset(self, request, context):
+        """Gets dataset by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDatasets(self, request, context):
+        """Lists datasets under a project. Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDataset(self, request, context):
+        """Deletes a dataset by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportData(self, request, context):
+        """Imports data into dataset based on source locations defined in request.
+    It can be called multiple times for the same dataset. Each dataset can
+    only have one long running operation running on it. For example, no
+    labeling task (also long running operation) can be started while
+    importing is still ongoing. Vice versa.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportData(self, request, context):
+        """Exports data and annotations from dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDataItem(self, request, context):
+        """Gets a data item in a dataset by resource name. This API can be
+    called after data are imported into dataset.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDataItems(self, request, context):
+        """Lists data items in a dataset. This API can be called after data
+    are imported into dataset. Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetAnnotatedDataset(self, request, context):
+        """Gets an annotated dataset by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAnnotatedDatasets(self, request, context):
+        """Lists annotated datasets for a dataset. Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteAnnotatedDataset(self, request, context):
+        """Deletes an annotated dataset by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LabelImage(self, request, context):
+        """Starts a labeling task for image. The type of image labeling task is
+    configured by feature in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LabelVideo(self, request, context):
+        """Starts a labeling task for video. The type of video labeling task is
+    configured by feature in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LabelText(self, request, context):
+        """Starts a labeling task for text. The type of text labeling task is
+    configured by feature in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetExample(self, request, context):
+        """Gets an example by resource name, including both data and annotation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListExamples(self, request, context):
+        """Lists examples in an annotated dataset. Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateAnnotationSpecSet(self, request, context):
+        """Creates an annotation spec set by providing a set of labels.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetAnnotationSpecSet(self, request, context):
+        """Gets an annotation spec set by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAnnotationSpecSets(self, request, context):
+        """Lists annotation spec sets for a project. Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteAnnotationSpecSet(self, request, context):
+        """Deletes an annotation spec set by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateInstruction(self, request, context):
+        """Creates an instruction for how data should be labeled.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInstruction(self, request, context):
+        """Gets an instruction by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListInstructions(self, request, context):
+        """Lists instructions for a project. Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteInstruction(self, request, context):
+        """Deletes an instruction object by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetEvaluation(self, request, context):
+        """Gets an evaluation by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchEvaluations(self, request, context):
+        """Searchs evaluations within a project. Supported filter: evaluation_job,
+    evaluation_time.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchExampleComparisons(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateEvaluationJob(self, request, context):
+        """Creates an evaluation job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateEvaluationJob(self, request, context):
+        """Updates an evaluation job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetEvaluationJob(self, request, context):
+        """Gets an evaluation job by resource name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PauseEvaluationJob(self, request, context):
+        """Pauses an evaluation job. Pausing a evaluation job that is already in
+    PAUSED state will be a no-op.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ResumeEvaluationJob(self, request, context):
+        """Resumes a paused evaluation job. Deleted evaluation job can't be resumed.
+    Resuming a running evaluation job will be a no-op.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteEvaluationJob(self, request, context):
+        """Stops and deletes an evaluation job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListEvaluationJobs(self, request, context):
+        """Lists all evaluation jobs within a project with possible filters.
+    Pagination is supported.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DataLabelingServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDataset,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateDatasetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.Dataset.SerializeToString,
+        ),
+        "GetDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDataset,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetDatasetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.Dataset.SerializeToString,
+        ),
+        "ListDatasets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDatasets,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDatasetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDatasetsResponse.SerializeToString,
+        ),
+        "DeleteDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDataset,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteDatasetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ImportData": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportData,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ImportDataRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ExportData": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportData,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ExportDataRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetDataItem": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDataItem,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetDataItemRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.DataItem.SerializeToString,
+        ),
+        "ListDataItems": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDataItems,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDataItemsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListDataItemsResponse.SerializeToString,
+        ),
+        "GetAnnotatedDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.GetAnnotatedDataset,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetAnnotatedDatasetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.AnnotatedDataset.SerializeToString,
+        ),
+        "ListAnnotatedDatasets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAnnotatedDatasets,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotatedDatasetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotatedDatasetsResponse.SerializeToString,
+        ),
+        "DeleteAnnotatedDataset": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteAnnotatedDataset,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteAnnotatedDatasetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "LabelImage": grpc.unary_unary_rpc_method_handler(
+            servicer.LabelImage,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.LabelImageRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "LabelVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.LabelVideo,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.LabelVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "LabelText": grpc.unary_unary_rpc_method_handler(
+            servicer.LabelText,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.LabelTextRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetExample": grpc.unary_unary_rpc_method_handler(
+            servicer.GetExample,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetExampleRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.Example.SerializeToString,
+        ),
+        "ListExamples": grpc.unary_unary_rpc_method_handler(
+            servicer.ListExamples,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListExamplesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListExamplesResponse.SerializeToString,
+        ),
+        "CreateAnnotationSpecSet": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateAnnotationSpecSet,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateAnnotationSpecSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.AnnotationSpecSet.SerializeToString,
+        ),
+        "GetAnnotationSpecSet": grpc.unary_unary_rpc_method_handler(
+            servicer.GetAnnotationSpecSet,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetAnnotationSpecSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.AnnotationSpecSet.SerializeToString,
+        ),
+        "ListAnnotationSpecSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAnnotationSpecSets,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotationSpecSetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListAnnotationSpecSetsResponse.SerializeToString,
+        ),
+        "DeleteAnnotationSpecSet": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteAnnotationSpecSet,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteAnnotationSpecSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateInstruction": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateInstruction,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateInstructionRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetInstruction": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInstruction,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetInstructionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_instruction__pb2.Instruction.SerializeToString,
+        ),
+        "ListInstructions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInstructions,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListInstructionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListInstructionsResponse.SerializeToString,
+        ),
+        "DeleteInstruction": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteInstruction,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteInstructionRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetEvaluation": grpc.unary_unary_rpc_method_handler(
+            servicer.GetEvaluation,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetEvaluationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2.Evaluation.SerializeToString,
+        ),
+        "SearchEvaluations": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchEvaluations,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchEvaluationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchEvaluationsResponse.SerializeToString,
+        ),
+        "SearchExampleComparisons": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchExampleComparisons,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchExampleComparisonsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.SearchExampleComparisonsResponse.SerializeToString,
+        ),
+        "CreateEvaluationJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateEvaluationJob,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.CreateEvaluationJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.EvaluationJob.SerializeToString,
+        ),
+        "UpdateEvaluationJob": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateEvaluationJob,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.UpdateEvaluationJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.EvaluationJob.SerializeToString,
+        ),
+        "GetEvaluationJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetEvaluationJob,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.GetEvaluationJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__job__pb2.EvaluationJob.SerializeToString,
+        ),
+        "PauseEvaluationJob": grpc.unary_unary_rpc_method_handler(
+            servicer.PauseEvaluationJob,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.PauseEvaluationJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ResumeEvaluationJob": grpc.unary_unary_rpc_method_handler(
+            servicer.ResumeEvaluationJob,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ResumeEvaluationJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "DeleteEvaluationJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteEvaluationJob,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.DeleteEvaluationJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListEvaluationJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListEvaluationJobs,
+            request_deserializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListEvaluationJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__labeling__service__pb2.ListEvaluationJobsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.datalabeling.v1beta1.DataLabelingService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads.proto
new file mode 100644
index 000000000000..721e20019e39
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads.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.cloud.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.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";
+
+// Container of information about an image.
+message ImagePayload {
+  // Image format.
+  string mime_type = 1;
+
+  // A byte string of a thumbnail image.
+  bytes image_thumbnail = 2;
+
+  // Image uri from the user bucket.
+  string image_uri = 3;
+
+  // Signed uri of the image file in the service bucket.
+  string signed_uri = 4;
+}
+
+// Container of information about a piece of text.
+message TextPayload {
+  // Text content.
+  string text_content = 1;
+}
+
+// Container of information of a video thumbnail.
+message VideoThumbnail {
+  // A byte string of the video frame.
+  bytes thumbnail = 1;
+
+  // Time offset relative to the beginning of the video, corresponding to the
+  // video frame where the thumbnail has been extracted from.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Container of information of a video.
+message VideoPayload {
+  // Video format.
+  string mime_type = 1;
+
+  // Video uri from the user bucket.
+  string video_uri = 2;
+
+  // The list of video thumbnails.
+  repeated VideoThumbnail video_thumbnails = 3;
+
+  // FPS of the video.
+  float frame_rate = 4;
+
+  // Signed uri of the video file in the service bucket.
+  string signed_uri = 5;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads_pb2.py
new file mode 100644
index 000000000000..36b898b591e4
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads_pb2.py
@@ -0,0 +1,442 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/data_payloads.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/data_payloads.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n;google/cloud/datalabeling_v1beta1/proto/data_payloads.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"a\n\x0cImagePayload\x12\x11\n\tmime_type\x18\x01 \x01(\t\x12\x17\n\x0fimage_thumbnail\x18\x02 \x01(\x0c\x12\x11\n\timage_uri\x18\x03 \x01(\t\x12\x12\n\nsigned_uri\x18\x04 \x01(\t"#\n\x0bTextPayload\x12\x14\n\x0ctext_content\x18\x01 \x01(\t"S\n\x0eVideoThumbnail\x12\x11\n\tthumbnail\x18\x01 \x01(\x0c\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xa9\x01\n\x0cVideoPayload\x12\x11\n\tmime_type\x18\x01 \x01(\t\x12\x11\n\tvideo_uri\x18\x02 \x01(\t\x12K\n\x10video_thumbnails\x18\x03 \x03(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.VideoThumbnail\x12\x12\n\nframe_rate\x18\x04 \x01(\x02\x12\x12\n\nsigned_uri\x18\x05 \x01(\tBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_IMAGEPAYLOAD = _descriptor.Descriptor(
+    name="ImagePayload",
+    full_name="google.cloud.datalabeling.v1beta1.ImagePayload",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePayload.mime_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_thumbnail",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePayload.image_thumbnail",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePayload.image_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signed_uri",
+            full_name="google.cloud.datalabeling.v1beta1.ImagePayload.signed_uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=193,
+    serialized_end=290,
+)
+
+
+_TEXTPAYLOAD = _descriptor.Descriptor(
+    name="TextPayload",
+    full_name="google.cloud.datalabeling.v1beta1.TextPayload",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text_content",
+            full_name="google.cloud.datalabeling.v1beta1.TextPayload.text_content",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=292,
+    serialized_end=327,
+)
+
+
+_VIDEOTHUMBNAIL = _descriptor.Descriptor(
+    name="VideoThumbnail",
+    full_name="google.cloud.datalabeling.v1beta1.VideoThumbnail",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="thumbnail",
+            full_name="google.cloud.datalabeling.v1beta1.VideoThumbnail.thumbnail",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.datalabeling.v1beta1.VideoThumbnail.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=329,
+    serialized_end=412,
+)
+
+
+_VIDEOPAYLOAD = _descriptor.Descriptor(
+    name="VideoPayload",
+    full_name="google.cloud.datalabeling.v1beta1.VideoPayload",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.datalabeling.v1beta1.VideoPayload.mime_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_uri",
+            full_name="google.cloud.datalabeling.v1beta1.VideoPayload.video_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_thumbnails",
+            full_name="google.cloud.datalabeling.v1beta1.VideoPayload.video_thumbnails",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_rate",
+            full_name="google.cloud.datalabeling.v1beta1.VideoPayload.frame_rate",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signed_uri",
+            full_name="google.cloud.datalabeling.v1beta1.VideoPayload.signed_uri",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=415,
+    serialized_end=584,
+)
+
+_VIDEOTHUMBNAIL.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOPAYLOAD.fields_by_name["video_thumbnails"].message_type = _VIDEOTHUMBNAIL
+DESCRIPTOR.message_types_by_name["ImagePayload"] = _IMAGEPAYLOAD
+DESCRIPTOR.message_types_by_name["TextPayload"] = _TEXTPAYLOAD
+DESCRIPTOR.message_types_by_name["VideoThumbnail"] = _VIDEOTHUMBNAIL
+DESCRIPTOR.message_types_by_name["VideoPayload"] = _VIDEOPAYLOAD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ImagePayload = _reflection.GeneratedProtocolMessageType(
+    "ImagePayload",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPAYLOAD,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_payloads_pb2",
+        __doc__="""Container of information about an image.
+  
+  
+  Attributes:
+      mime_type:
+          Image format.
+      image_thumbnail:
+          A byte string of a thumbnail image.
+      image_uri:
+          Image uri from the user bucket.
+      signed_uri:
+          Signed uri of the image file in the service bucket.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImagePayload)
+    ),
+)
+_sym_db.RegisterMessage(ImagePayload)
+
+TextPayload = _reflection.GeneratedProtocolMessageType(
+    "TextPayload",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTPAYLOAD,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_payloads_pb2",
+        __doc__="""Container of information about a piece of text.
+  
+  
+  Attributes:
+      text_content:
+          Text content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TextPayload)
+    ),
+)
+_sym_db.RegisterMessage(TextPayload)
+
+VideoThumbnail = _reflection.GeneratedProtocolMessageType(
+    "VideoThumbnail",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOTHUMBNAIL,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_payloads_pb2",
+        __doc__="""Container of information of a video thumbnail.
+  
+  
+  Attributes:
+      thumbnail:
+          A byte string of the video frame.
+      time_offset:
+          Time offset relative to the beginning of the video,
+          corresponding to the video frame where the thumbnail has been
+          extracted from.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoThumbnail)
+    ),
+)
+_sym_db.RegisterMessage(VideoThumbnail)
+
+VideoPayload = _reflection.GeneratedProtocolMessageType(
+    "VideoPayload",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOPAYLOAD,
+        __module__="google.cloud.datalabeling_v1beta1.proto.data_payloads_pb2",
+        __doc__="""Container of information of a video.
+  
+  
+  Attributes:
+      mime_type:
+          Video format.
+      video_uri:
+          Video uri from the user bucket.
+      video_thumbnails:
+          The list of video thumbnails.
+      frame_rate:
+          FPS of the video.
+      signed_uri:
+          Signed uri of the video file in the service bucket.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoPayload)
+    ),
+)
+_sym_db.RegisterMessage(VideoPayload)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/data_payloads_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset.proto
new file mode 100644
index 000000000000..5289abcc9daf
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset.proto
@@ -0,0 +1,304 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datalabeling/v1beta1/annotation.proto";
+import "google/cloud/datalabeling/v1beta1/data_payloads.proto";
+import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto";
+import "google/protobuf/timestamp.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";
+
+enum DataType {
+  DATA_TYPE_UNSPECIFIED = 0;
+
+  IMAGE = 1;
+
+  VIDEO = 2;
+
+  TEXT = 4;
+
+  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 {
+  // Output only. Dataset resource name, format is:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+
+  // Required. The display name of the dataset. 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.
+  string description = 3;
+
+  // Output only. Time the dataset is created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. This is populated with the original input configs
+  // where ImportData is called. It is available only after the clients
+  // import data to this dataset.
+  repeated InputConfig input_configs = 5;
+
+  // Output only. The names of any related resources that are blocking changes
+  // to the dataset.
+  repeated string blocking_resources = 6;
+
+  // Output only. The number of data items in the dataset.
+  int64 data_item_count = 7;
+}
+
+// The configuration of input data, including data type, location, etc.
+message InputConfig {
+  // Optional. The metadata associated with each data type.
+  oneof data_type_metadata {
+    // Required for text import, as language code must be specified.
+    TextMetadata text_metadata = 6;
+  }
+
+  // Required. Where the data is from.
+  oneof source {
+    // Source located in Cloud Storage.
+    GcsSource gcs_source = 2;
+
+    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.
+  AnnotationType annotation_type = 3;
+
+  // Optional. Metadata about annotations in the input. Each annotation type may
+  // have different metadata.
+  // Metadata for classification problem.
+  ClassificationMetadata classification_metadata = 4;
+}
+
+// Metadata for the text.
+message TextMetadata {
+  // The language of this text, as a
+  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt).
+  // Default value is en-US.
+  string language_code = 1;
+}
+
+// Metadata for classification annotations.
+message ClassificationMetadata {
+  // Whether the classification task is multi-label or not.
+  bool is_multi_label = 1;
+}
+
+// Source of the Cloud Storage file to be imported.
+message GcsSource {
+  // Required. The input URI of source file. This must be a Cloud Storage path
+  // (`gs://...`).
+  string input_uri = 1;
+
+  // Required. The format of the source file. Only "text/csv" is supported.
+  string mime_type = 2;
+}
+
+// The BigQuery location for the input content.
+message BigQuerySource {
+  // Required. BigQuery URI to a table, up to 2000 characters long.
+  // Accepted forms: BigQuery gs path e.g. bq://projectId.bqDatasetId.bqTableId
+  string input_uri = 1;
+}
+
+// The configuration of output data.
+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.
+    GcsDestination gcs_destination = 1;
+
+    // Output to a folder in Cloud Storage. Should be used for image
+    // segmentation labeling output.
+    GcsFolderDestination gcs_folder_destination = 2;
+  }
+}
+
+// Export destination of the data.Only gcs path is allowed in
+// output_uri.
+message GcsDestination {
+  // Required. The output uri of destination file.
+  string output_uri = 1;
+
+  // Required. The format of the gcs destination. Only "text/csv" and
+  // "application/json"
+  // are supported.
+  string mime_type = 2;
+}
+
+// Export folder destination of the data.
+message GcsFolderDestination {
+  // Required. Cloud Storage directory to export data to.
+  string output_folder_uri = 1;
+}
+
+// DataItem is a piece of data, without annotation. For example, an image.
+message DataItem {
+  // Output only.
+  oneof payload {
+    // The image payload, a container of the image bytes/uri.
+    ImagePayload image_payload = 2;
+
+    // The text payload, a container of text content.
+    TextPayload text_payload = 3;
+
+    // The video payload, a container of the video uri.
+    VideoPayload video_payload = 4;
+  }
+
+  // Output only. Name of the data item, in format of:
+  // projects/{project_id}/datasets/{dataset_id}/dataItems/{data_item_id}
+  string name = 1;
+}
+
+// AnnotatedDataset is a set holding annotations for data in a Dataset. Each
+// labeling task will generate an AnnotatedDataset under the Dataset that the
+// task is requested for.
+message AnnotatedDataset {
+  // Output only. AnnotatedDataset resource name in format of:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}
+  string name = 1;
+
+  // Output only. The display name of the AnnotatedDataset. It is specified in
+  // HumanAnnotationConfig when user starts a labeling task. Maximum of 64
+  // characters.
+  string display_name = 2;
+
+  // Output only. The description of the AnnotatedDataset. It is specified in
+  // HumanAnnotationConfig when user starts a labeling task. Maximum of 10000
+  // characters.
+  string description = 9;
+
+  // Output only. Source of the annotation.
+  AnnotationSource annotation_source = 3;
+
+  // Output only. Type of the annotation. It is specified when starting labeling
+  // task.
+  AnnotationType annotation_type = 8;
+
+  // Output only. Number of examples in the annotated dataset.
+  int64 example_count = 4;
+
+  // Output only. Number of examples that have annotation in the annotated
+  // dataset.
+  int64 completed_example_count = 5;
+
+  // Output only. Per label statistics.
+  LabelStats label_stats = 6;
+
+  // Output only. Time the AnnotatedDataset was created.
+  google.protobuf.Timestamp create_time = 7;
+
+  // Output only. Additional information about AnnotatedDataset.
+  AnnotatedDatasetMetadata metadata = 10;
+
+  // Output only. The names of any related resources that are blocking changes
+  // to the annotated dataset.
+  repeated string blocking_resources = 11;
+}
+
+// Statistics about annotation specs.
+message LabelStats {
+  // Map of each annotation spec's example count. Key is the annotation spec
+  // name and value is the number of examples for that annotation spec.
+  // If the annotated dataset does not have annotation spec, the map will return
+  // a pair where the key is empty string and value is the total number of
+  // annotations.
+  map<string, int64> example_count = 1;
+}
+
+// Metadata on AnnotatedDataset.
+message AnnotatedDatasetMetadata {
+  // Specific request configuration used when requesting the labeling task.
+  oneof annotation_request_config {
+    // Configuration for image classification task.
+    ImageClassificationConfig image_classification_config = 2;
+
+    // Configuration for image bounding box and bounding poly task.
+    BoundingPolyConfig bounding_poly_config = 3;
+
+    // Configuration for image polyline task.
+    PolylineConfig polyline_config = 4;
+
+    // Configuration for image segmentation task.
+    SegmentationConfig segmentation_config = 5;
+
+    // Configuration for video classification task.
+    VideoClassificationConfig video_classification_config = 6;
+
+    // Configuration for video object detection task.
+    ObjectDetectionConfig object_detection_config = 7;
+
+    // Configuration for video object tracking task.
+    ObjectTrackingConfig object_tracking_config = 8;
+
+    // Configuration for video event labeling task.
+    EventConfig event_config = 9;
+
+    // Configuration for text classification task.
+    TextClassificationConfig text_classification_config = 10;
+
+    // Configuration for text entity extraction task.
+    TextEntityExtractionConfig text_entity_extraction_config = 11;
+  }
+
+  // HumanAnnotationConfig used when requesting the human labeling task for this
+  // AnnotatedDataset.
+  HumanAnnotationConfig human_annotation_config = 1;
+}
+
+// An Example is a piece of data and its annotation. For example, an image with
+// label "house".
+message Example {
+  // Output only. The data part of Example.
+  oneof payload {
+    // The image payload, a container of the image bytes/uri.
+    ImagePayload image_payload = 2;
+
+    // The text payload, a container of the text content.
+    TextPayload text_payload = 6;
+
+    // The video payload, a container of the video uri.
+    VideoPayload video_payload = 7;
+  }
+
+  // Output only. Name of the example, in format of:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}/examples/{example_id}
+  string name = 1;
+
+  // Output only. Annotations for the piece of data in Example.
+  // One piece of data can have multiple annotations.
+  repeated Annotation annotations = 5;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset_pb2.py
new file mode 100644
index 000000000000..cf6e07d873a0
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset_pb2.py
@@ -0,0 +1,2169 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/dataset.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    data_payloads_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    human_annotation_config_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/dataset.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/datalabeling_v1beta1/proto/dataset.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x38google/cloud/datalabeling_v1beta1/proto/annotation.proto\x1a;google/cloud/datalabeling_v1beta1/proto/data_payloads.proto\x1a\x45google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xef\x01\n\x07\x44\x61taset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x45\n\rinput_configs\x18\x05 \x03(\x0b\x32..google.cloud.datalabeling.v1beta1.InputConfig\x12\x1a\n\x12\x62locking_resources\x18\x06 \x03(\t\x12\x17\n\x0f\x64\x61ta_item_count\x18\x07 \x01(\x03"\xf1\x03\n\x0bInputConfig\x12H\n\rtext_metadata\x18\x06 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.TextMetadataH\x00\x12\x42\n\ngcs_source\x18\x02 \x01(\x0b\x32,.google.cloud.datalabeling.v1beta1.GcsSourceH\x01\x12L\n\x0f\x62igquery_source\x18\x05 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.BigQuerySourceH\x01\x12>\n\tdata_type\x18\x01 \x01(\x0e\x32+.google.cloud.datalabeling.v1beta1.DataType\x12J\n\x0f\x61nnotation_type\x18\x03 \x01(\x0e\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationType\x12Z\n\x17\x63lassification_metadata\x18\x04 \x01(\x0b\x32\x39.google.cloud.datalabeling.v1beta1.ClassificationMetadataB\x14\n\x12\x64\x61ta_type_metadataB\x08\n\x06source"%\n\x0cTextMetadata\x12\x15\n\rlanguage_code\x18\x01 \x01(\t"0\n\x16\x43lassificationMetadata\x12\x16\n\x0eis_multi_label\x18\x01 \x01(\x08"1\n\tGcsSource\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t"#\n\x0e\x42igQuerySource\x12\x11\n\tinput_uri\x18\x01 \x01(\t"\xc6\x01\n\x0cOutputConfig\x12L\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.GcsDestinationH\x00\x12Y\n\x16gcs_folder_destination\x18\x02 \x01(\x0b\x32\x37.google.cloud.datalabeling.v1beta1.GcsFolderDestinationH\x00\x42\r\n\x0b\x64\x65stination"7\n\x0eGcsDestination\x12\x12\n\noutput_uri\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t"1\n\x14GcsFolderDestination\x12\x19\n\x11output_folder_uri\x18\x01 \x01(\t"\xff\x01\n\x08\x44\x61taItem\x12H\n\rimage_payload\x18\x02 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.ImagePayloadH\x00\x12\x46\n\x0ctext_payload\x18\x03 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.TextPayloadH\x00\x12H\n\rvideo_payload\x18\x04 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.VideoPayloadH\x00\x12\x0c\n\x04name\x18\x01 \x01(\tB\t\n\x07payload"\xff\x03\n\x10\x41nnotatedDataset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\t \x01(\t\x12N\n\x11\x61nnotation_source\x18\x03 \x01(\x0e\x32\x33.google.cloud.datalabeling.v1beta1.AnnotationSource\x12J\n\x0f\x61nnotation_type\x18\x08 \x01(\x0e\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationType\x12\x15\n\rexample_count\x18\x04 \x01(\x03\x12\x1f\n\x17\x63ompleted_example_count\x18\x05 \x01(\x03\x12\x42\n\x0blabel_stats\x18\x06 \x01(\x0b\x32-.google.cloud.datalabeling.v1beta1.LabelStats\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12M\n\x08metadata\x18\n \x01(\x0b\x32;.google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata\x12\x1a\n\x12\x62locking_resources\x18\x0b \x03(\t"\x99\x01\n\nLabelStats\x12V\n\rexample_count\x18\x01 \x03(\x0b\x32?.google.cloud.datalabeling.v1beta1.LabelStats.ExampleCountEntry\x1a\x33\n\x11\x45xampleCountEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01"\xa2\x08\n\x18\x41nnotatedDatasetMetadata\x12\x63\n\x1bimage_classification_config\x18\x02 \x01(\x0b\x32<.google.cloud.datalabeling.v1beta1.ImageClassificationConfigH\x00\x12U\n\x14\x62ounding_poly_config\x18\x03 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.BoundingPolyConfigH\x00\x12L\n\x0fpolyline_config\x18\x04 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.PolylineConfigH\x00\x12T\n\x13segmentation_config\x18\x05 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.SegmentationConfigH\x00\x12\x63\n\x1bvideo_classification_config\x18\x06 \x01(\x0b\x32<.google.cloud.datalabeling.v1beta1.VideoClassificationConfigH\x00\x12[\n\x17object_detection_config\x18\x07 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.ObjectDetectionConfigH\x00\x12Y\n\x16object_tracking_config\x18\x08 \x01(\x0b\x32\x37.google.cloud.datalabeling.v1beta1.ObjectTrackingConfigH\x00\x12\x46\n\x0c\x65vent_config\x18\t \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.EventConfigH\x00\x12\x61\n\x1atext_classification_config\x18\n \x01(\x0b\x32;.google.cloud.datalabeling.v1beta1.TextClassificationConfigH\x00\x12\x66\n\x1dtext_entity_extraction_config\x18\x0b \x01(\x0b\x32=.google.cloud.datalabeling.v1beta1.TextEntityExtractionConfigH\x00\x12Y\n\x17human_annotation_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfigB\x1b\n\x19\x61nnotation_request_config"\xc2\x02\n\x07\x45xample\x12H\n\rimage_payload\x18\x02 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.ImagePayloadH\x00\x12\x46\n\x0ctext_payload\x18\x06 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.TextPayloadH\x00\x12H\n\rvideo_payload\x18\x07 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.VideoPayloadH\x00\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x42\n\x0b\x61nnotations\x18\x05 \x03(\x0b\x32-.google.cloud.datalabeling.v1beta1.AnnotationB\t\n\x07payload*W\n\x08\x44\x61taType\x12\x19\n\x15\x44\x41TA_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05IMAGE\x10\x01\x12\t\n\x05VIDEO\x10\x02\x12\x08\n\x04TEXT\x10\x04\x12\x10\n\x0cGENERAL_DATA\x10\x06\x42x\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_DATATYPE = _descriptor.EnumDescriptor(
+    name="DataType",
+    full_name="google.cloud.datalabeling.v1beta1.DataType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT", index=3, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GENERAL_DATA", index=4, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3887,
+    serialized_end=3974,
+)
+_sym_db.RegisterEnumDescriptor(_DATATYPE)
+
+DataType = enum_type_wrapper.EnumTypeWrapper(_DATATYPE)
+DATA_TYPE_UNSPECIFIED = 0
+IMAGE = 1
+VIDEO = 2
+TEXT = 4
+GENERAL_DATA = 6
+
+
+_DATASET = _descriptor.Descriptor(
+    name="Dataset",
+    full_name="google.cloud.datalabeling.v1beta1.Dataset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_configs",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.input_configs",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocking_resources",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.blocking_resources",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_item_count",
+            full_name="google.cloud.datalabeling.v1beta1.Dataset.data_item_count",
+            index=6,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=346,
+    serialized_end=585,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.datalabeling.v1beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text_metadata",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.text_metadata",
+            index=0,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.gcs_source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_source",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.bigquery_source",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_type",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.data_type",
+            index=3,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_type",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.annotation_type",
+            index=4,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="classification_metadata",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.classification_metadata",
+            index=5,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="data_type_metadata",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.data_type_metadata",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.datalabeling.v1beta1.InputConfig.source",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=588,
+    serialized_end=1085,
+)
+
+
+_TEXTMETADATA = _descriptor.Descriptor(
+    name="TextMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.TextMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.datalabeling.v1beta1.TextMetadata.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1087,
+    serialized_end=1124,
+)
+
+
+_CLASSIFICATIONMETADATA = _descriptor.Descriptor(
+    name="ClassificationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.ClassificationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="is_multi_label",
+            full_name="google.cloud.datalabeling.v1beta1.ClassificationMetadata.is_multi_label",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1126,
+    serialized_end=1174,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.datalabeling.v1beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.datalabeling.v1beta1.GcsSource.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.datalabeling.v1beta1.GcsSource.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1176,
+    serialized_end=1225,
+)
+
+
+_BIGQUERYSOURCE = _descriptor.Descriptor(
+    name="BigQuerySource",
+    full_name="google.cloud.datalabeling.v1beta1.BigQuerySource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.datalabeling.v1beta1.BigQuerySource.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1227,
+    serialized_end=1262,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.datalabeling.v1beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.datalabeling.v1beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcs_folder_destination",
+            full_name="google.cloud.datalabeling.v1beta1.OutputConfig.gcs_folder_destination",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.datalabeling.v1beta1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1265,
+    serialized_end=1463,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.datalabeling.v1beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.datalabeling.v1beta1.GcsDestination.output_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.datalabeling.v1beta1.GcsDestination.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1465,
+    serialized_end=1520,
+)
+
+
+_GCSFOLDERDESTINATION = _descriptor.Descriptor(
+    name="GcsFolderDestination",
+    full_name="google.cloud.datalabeling.v1beta1.GcsFolderDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_folder_uri",
+            full_name="google.cloud.datalabeling.v1beta1.GcsFolderDestination.output_folder_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1522,
+    serialized_end=1571,
+)
+
+
+_DATAITEM = _descriptor.Descriptor(
+    name="DataItem",
+    full_name="google.cloud.datalabeling.v1beta1.DataItem",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_payload",
+            full_name="google.cloud.datalabeling.v1beta1.DataItem.image_payload",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_payload",
+            full_name="google.cloud.datalabeling.v1beta1.DataItem.text_payload",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_payload",
+            full_name="google.cloud.datalabeling.v1beta1.DataItem.video_payload",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.DataItem.name",
+            index=3,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="payload",
+            full_name="google.cloud.datalabeling.v1beta1.DataItem.payload",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1574,
+    serialized_end=1829,
+)
+
+
+_ANNOTATEDDATASET = _descriptor.Descriptor(
+    name="AnnotatedDataset",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.description",
+            index=2,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_source",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.annotation_source",
+            index=3,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_type",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.annotation_type",
+            index=4,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="example_count",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.example_count",
+            index=5,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="completed_example_count",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.completed_example_count",
+            index=6,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_stats",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.label_stats",
+            index=7,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.create_time",
+            index=8,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.metadata",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocking_resources",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDataset.blocking_resources",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1832,
+    serialized_end=2343,
+)
+
+
+_LABELSTATS_EXAMPLECOUNTENTRY = _descriptor.Descriptor(
+    name="ExampleCountEntry",
+    full_name="google.cloud.datalabeling.v1beta1.LabelStats.ExampleCountEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.datalabeling.v1beta1.LabelStats.ExampleCountEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.datalabeling.v1beta1.LabelStats.ExampleCountEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2448,
+    serialized_end=2499,
+)
+
+_LABELSTATS = _descriptor.Descriptor(
+    name="LabelStats",
+    full_name="google.cloud.datalabeling.v1beta1.LabelStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="example_count",
+            full_name="google.cloud.datalabeling.v1beta1.LabelStats.example_count",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_LABELSTATS_EXAMPLECOUNTENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2346,
+    serialized_end=2499,
+)
+
+
+_ANNOTATEDDATASETMETADATA = _descriptor.Descriptor(
+    name="AnnotatedDatasetMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.image_classification_config",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.bounding_poly_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="polyline_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.polyline_config",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segmentation_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.segmentation_config",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.video_classification_config",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_detection_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.object_detection_config",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.object_tracking_config",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.event_config",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.text_classification_config",
+            index=8,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_entity_extraction_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.text_entity_extraction_config",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="human_annotation_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.human_annotation_config",
+            index=10,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="annotation_request_config",
+            full_name="google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata.annotation_request_config",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2502,
+    serialized_end=3560,
+)
+
+
+_EXAMPLE = _descriptor.Descriptor(
+    name="Example",
+    full_name="google.cloud.datalabeling.v1beta1.Example",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_payload",
+            full_name="google.cloud.datalabeling.v1beta1.Example.image_payload",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_payload",
+            full_name="google.cloud.datalabeling.v1beta1.Example.text_payload",
+            index=1,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_payload",
+            full_name="google.cloud.datalabeling.v1beta1.Example.video_payload",
+            index=2,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.Example.name",
+            index=3,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotations",
+            full_name="google.cloud.datalabeling.v1beta1.Example.annotations",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="payload",
+            full_name="google.cloud.datalabeling.v1beta1.Example.payload",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3563,
+    serialized_end=3885,
+)
+
+_DATASET.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DATASET.fields_by_name["input_configs"].message_type = _INPUTCONFIG
+_INPUTCONFIG.fields_by_name["text_metadata"].message_type = _TEXTMETADATA
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_INPUTCONFIG.fields_by_name["bigquery_source"].message_type = _BIGQUERYSOURCE
+_INPUTCONFIG.fields_by_name["data_type"].enum_type = _DATATYPE
+_INPUTCONFIG.fields_by_name[
+    "annotation_type"
+].enum_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2._ANNOTATIONTYPE
+)
+_INPUTCONFIG.fields_by_name[
+    "classification_metadata"
+].message_type = _CLASSIFICATIONMETADATA
+_INPUTCONFIG.oneofs_by_name["data_type_metadata"].fields.append(
+    _INPUTCONFIG.fields_by_name["text_metadata"]
+)
+_INPUTCONFIG.fields_by_name[
+    "text_metadata"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["data_type_metadata"]
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["gcs_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["bigquery_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "bigquery_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_folder_destination"
+].message_type = _GCSFOLDERDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_folder_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_folder_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_DATAITEM.fields_by_name[
+    "image_payload"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2._IMAGEPAYLOAD
+)
+_DATAITEM.fields_by_name[
+    "text_payload"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2._TEXTPAYLOAD
+)
+_DATAITEM.fields_by_name[
+    "video_payload"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2._VIDEOPAYLOAD
+)
+_DATAITEM.oneofs_by_name["payload"].fields.append(
+    _DATAITEM.fields_by_name["image_payload"]
+)
+_DATAITEM.fields_by_name["image_payload"].containing_oneof = _DATAITEM.oneofs_by_name[
+    "payload"
+]
+_DATAITEM.oneofs_by_name["payload"].fields.append(
+    _DATAITEM.fields_by_name["text_payload"]
+)
+_DATAITEM.fields_by_name["text_payload"].containing_oneof = _DATAITEM.oneofs_by_name[
+    "payload"
+]
+_DATAITEM.oneofs_by_name["payload"].fields.append(
+    _DATAITEM.fields_by_name["video_payload"]
+)
+_DATAITEM.fields_by_name["video_payload"].containing_oneof = _DATAITEM.oneofs_by_name[
+    "payload"
+]
+_ANNOTATEDDATASET.fields_by_name[
+    "annotation_source"
+].enum_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2._ANNOTATIONSOURCE
+)
+_ANNOTATEDDATASET.fields_by_name[
+    "annotation_type"
+].enum_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2._ANNOTATIONTYPE
+)
+_ANNOTATEDDATASET.fields_by_name["label_stats"].message_type = _LABELSTATS
+_ANNOTATEDDATASET.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ANNOTATEDDATASET.fields_by_name["metadata"].message_type = _ANNOTATEDDATASETMETADATA
+_LABELSTATS_EXAMPLECOUNTENTRY.containing_type = _LABELSTATS
+_LABELSTATS.fields_by_name["example_count"].message_type = _LABELSTATS_EXAMPLECOUNTENTRY
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "image_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._IMAGECLASSIFICATIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "bounding_poly_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._BOUNDINGPOLYCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "polyline_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._POLYLINECONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "segmentation_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._SEGMENTATIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "video_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._VIDEOCLASSIFICATIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "object_detection_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._OBJECTDETECTIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "object_tracking_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._OBJECTTRACKINGCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "event_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._EVENTCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "text_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._TEXTCLASSIFICATIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "text_entity_extraction_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._TEXTENTITYEXTRACTIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "human_annotation_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["image_classification_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "image_classification_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["bounding_poly_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "bounding_poly_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["polyline_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "polyline_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["segmentation_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "segmentation_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["video_classification_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "video_classification_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["object_detection_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "object_detection_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["object_tracking_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "object_tracking_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["event_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "event_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["text_classification_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "text_classification_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_ANNOTATEDDATASETMETADATA.oneofs_by_name["annotation_request_config"].fields.append(
+    _ANNOTATEDDATASETMETADATA.fields_by_name["text_entity_extraction_config"]
+)
+_ANNOTATEDDATASETMETADATA.fields_by_name[
+    "text_entity_extraction_config"
+].containing_oneof = _ANNOTATEDDATASETMETADATA.oneofs_by_name[
+    "annotation_request_config"
+]
+_EXAMPLE.fields_by_name[
+    "image_payload"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2._IMAGEPAYLOAD
+)
+_EXAMPLE.fields_by_name[
+    "text_payload"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2._TEXTPAYLOAD
+)
+_EXAMPLE.fields_by_name[
+    "video_payload"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_data__payloads__pb2._VIDEOPAYLOAD
+)
+_EXAMPLE.fields_by_name[
+    "annotations"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2._ANNOTATION
+)
+_EXAMPLE.oneofs_by_name["payload"].fields.append(
+    _EXAMPLE.fields_by_name["image_payload"]
+)
+_EXAMPLE.fields_by_name["image_payload"].containing_oneof = _EXAMPLE.oneofs_by_name[
+    "payload"
+]
+_EXAMPLE.oneofs_by_name["payload"].fields.append(
+    _EXAMPLE.fields_by_name["text_payload"]
+)
+_EXAMPLE.fields_by_name["text_payload"].containing_oneof = _EXAMPLE.oneofs_by_name[
+    "payload"
+]
+_EXAMPLE.oneofs_by_name["payload"].fields.append(
+    _EXAMPLE.fields_by_name["video_payload"]
+)
+_EXAMPLE.fields_by_name["video_payload"].containing_oneof = _EXAMPLE.oneofs_by_name[
+    "payload"
+]
+DESCRIPTOR.message_types_by_name["Dataset"] = _DATASET
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["TextMetadata"] = _TEXTMETADATA
+DESCRIPTOR.message_types_by_name["ClassificationMetadata"] = _CLASSIFICATIONMETADATA
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["BigQuerySource"] = _BIGQUERYSOURCE
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["GcsFolderDestination"] = _GCSFOLDERDESTINATION
+DESCRIPTOR.message_types_by_name["DataItem"] = _DATAITEM
+DESCRIPTOR.message_types_by_name["AnnotatedDataset"] = _ANNOTATEDDATASET
+DESCRIPTOR.message_types_by_name["LabelStats"] = _LABELSTATS
+DESCRIPTOR.message_types_by_name["AnnotatedDatasetMetadata"] = _ANNOTATEDDATASETMETADATA
+DESCRIPTOR.message_types_by_name["Example"] = _EXAMPLE
+DESCRIPTOR.enum_types_by_name["DataType"] = _DATATYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Dataset = _reflection.GeneratedProtocolMessageType(
+    "Dataset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASET,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Dataset is the resource to hold your data. You can request multiple
+  labeling tasks for a dataset while each one will generate an
+  AnnotatedDataset.
+  
+  
+  Attributes:
+      name:
+          Output only. Dataset resource name, format is:
+          projects/{project\_id}/datasets/{dataset\_id}
+      display_name:
+          Required. The display name of the dataset. Maximum of 64
+          characters.
+      description:
+          Optional. User-provided description of the annotation
+          specification set. The description can be up to 10000
+          characters long.
+      create_time:
+          Output only. Time the dataset is created.
+      input_configs:
+          Output only. This is populated with the original input configs
+          where ImportData is called. It is available only after the
+          clients import data to this dataset.
+      blocking_resources:
+          Output only. The names of any related resources that are
+          blocking changes to the dataset.
+      data_item_count:
+          Output only. The number of data items in the dataset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Dataset)
+    ),
+)
+_sym_db.RegisterMessage(Dataset)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""The configuration of input data, including data type, location, etc.
+  
+  
+  Attributes:
+      data_type_metadata:
+          Optional. The metadata associated with each data type.
+      text_metadata:
+          Required for text import, as language code must be specified.
+      source:
+          Required. Where the data is from.
+      gcs_source:
+          Source located in Cloud Storage.
+      data_type:
+          Required. Data type must be specifed when user tries to import
+          data.
+      annotation_type:
+          Optional. If input contains annotation, user needs to specify
+          the type and metadata of the annotation when creating it as an
+          annotated dataset.
+      classification_metadata:
+          Optional. Metadata about annotations in the input. Each
+          annotation type may have different metadata. Metadata for
+          classification problem.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+TextMetadata = _reflection.GeneratedProtocolMessageType(
+    "TextMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Metadata for the text.
+  
+  
+  Attributes:
+      language_code:
+          The language of this text, as a `BCP-47 <https://www.rfc-
+          editor.org/rfc/bcp/bcp47.txt>`__. Default value is en-US.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TextMetadata)
+    ),
+)
+_sym_db.RegisterMessage(TextMetadata)
+
+ClassificationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ClassificationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFICATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Metadata for classification annotations.
+  
+  
+  Attributes:
+      is_multi_label:
+          Whether the classification task is multi-label or not.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ClassificationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ClassificationMetadata)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Source of the Cloud Storage file to be imported.
+  
+  
+  Attributes:
+      input_uri:
+          Required. The input URI of source file. This must be a Cloud
+          Storage path (``gs://...``).
+      mime_type:
+          Required. The format of the source file. Only "text/csv" is
+          supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+BigQuerySource = _reflection.GeneratedProtocolMessageType(
+    "BigQuerySource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYSOURCE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""The BigQuery location for the input content.
+  
+  
+  Attributes:
+      input_uri:
+          Required. BigQuery URI to a table, up to 2000 characters long.
+          Accepted forms: BigQuery gs path e.g.
+          bq://projectId.bqDatasetId.bqTableId
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.BigQuerySource)
+    ),
+)
+_sym_db.RegisterMessage(BigQuerySource)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""The configuration of output data.
+  
+  
+  Attributes:
+      destination:
+          Required. Location to output data to.
+      gcs_destination:
+          Output to a file in Cloud Storage. Should be used for labeling
+          output other thanimage segmentation.
+      gcs_folder_destination:
+          Output to a folder in Cloud Storage. Should be used for image
+          segmentation labeling output.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Export destination of the data.Only gcs path is allowed in output\_uri.
+  
+  
+  Attributes:
+      output_uri:
+          Required. The output uri of destination file.
+      mime_type:
+          Required. The format of the gcs destination. Only "text/csv"
+          and "application/json" are supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+GcsFolderDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsFolderDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSFOLDERDESTINATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Export folder destination of the data.
+  
+  
+  Attributes:
+      output_folder_uri:
+          Required. Cloud Storage directory to export data to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.GcsFolderDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsFolderDestination)
+
+DataItem = _reflection.GeneratedProtocolMessageType(
+    "DataItem",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATAITEM,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""DataItem is a piece of data, without annotation. For example, an image.
+  
+  
+  Attributes:
+      payload:
+          Output only.
+      image_payload:
+          The image payload, a container of the image bytes/uri.
+      text_payload:
+          The text payload, a container of text content.
+      video_payload:
+          The video payload, a container of the video uri.
+      name:
+          Output only. Name of the data item, in format of: projects/{pr
+          oject\_id}/datasets/{dataset\_id}/dataItems/{data\_item\_id}
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.DataItem)
+    ),
+)
+_sym_db.RegisterMessage(DataItem)
+
+AnnotatedDataset = _reflection.GeneratedProtocolMessageType(
+    "AnnotatedDataset",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEDDATASET,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""AnnotatedDataset is a set holding annotations for data in a Dataset.
+  Each labeling task will generate an AnnotatedDataset under the Dataset
+  that the task is requested for.
+  
+  
+  Attributes:
+      name:
+          Output only. AnnotatedDataset resource name in format of: proj
+          ects/{project\_id}/datasets/{dataset\_id}/annotatedDatasets/
+          {annotated\_dataset\_id}
+      display_name:
+          Output only. The display name of the AnnotatedDataset. It is
+          specified in HumanAnnotationConfig when user starts a labeling
+          task. Maximum of 64 characters.
+      description:
+          Output only. The description of the AnnotatedDataset. It is
+          specified in HumanAnnotationConfig when user starts a labeling
+          task. Maximum of 10000 characters.
+      annotation_source:
+          Output only. Source of the annotation.
+      annotation_type:
+          Output only. Type of the annotation. It is specified when
+          starting labeling task.
+      example_count:
+          Output only. Number of examples in the annotated dataset.
+      completed_example_count:
+          Output only. Number of examples that have annotation in the
+          annotated dataset.
+      label_stats:
+          Output only. Per label statistics.
+      create_time:
+          Output only. Time the AnnotatedDataset was created.
+      metadata:
+          Output only. Additional information about AnnotatedDataset.
+      blocking_resources:
+          Output only. The names of any related resources that are
+          blocking changes to the annotated dataset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.AnnotatedDataset)
+    ),
+)
+_sym_db.RegisterMessage(AnnotatedDataset)
+
+LabelStats = _reflection.GeneratedProtocolMessageType(
+    "LabelStats",
+    (_message.Message,),
+    dict(
+        ExampleCountEntry=_reflection.GeneratedProtocolMessageType(
+            "ExampleCountEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LABELSTATS_EXAMPLECOUNTENTRY,
+                __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelStats.ExampleCountEntry)
+            ),
+        ),
+        DESCRIPTOR=_LABELSTATS,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Statistics about annotation specs.
+  
+  
+  Attributes:
+      example_count:
+          Map of each annotation spec's example count. Key is the
+          annotation spec name and value is the number of examples for
+          that annotation spec. If the annotated dataset does not have
+          annotation spec, the map will return a pair where the key is
+          empty string and value is the total number of annotations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelStats)
+    ),
+)
+_sym_db.RegisterMessage(LabelStats)
+_sym_db.RegisterMessage(LabelStats.ExampleCountEntry)
+
+AnnotatedDatasetMetadata = _reflection.GeneratedProtocolMessageType(
+    "AnnotatedDatasetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEDDATASETMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""Metadata on AnnotatedDataset.
+  
+  
+  Attributes:
+      annotation_request_config:
+          Specific request configuration used when requesting the
+          labeling task.
+      image_classification_config:
+          Configuration for image classification task.
+      bounding_poly_config:
+          Configuration for image bounding box and bounding poly task.
+      polyline_config:
+          Configuration for image polyline task.
+      segmentation_config:
+          Configuration for image segmentation task.
+      video_classification_config:
+          Configuration for video classification task.
+      object_detection_config:
+          Configuration for video object detection task.
+      object_tracking_config:
+          Configuration for video object tracking task.
+      event_config:
+          Configuration for video event labeling task.
+      text_classification_config:
+          Configuration for text classification task.
+      text_entity_extraction_config:
+          Configuration for text entity extraction task.
+      human_annotation_config:
+          HumanAnnotationConfig used when requesting the human labeling
+          task for this AnnotatedDataset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.AnnotatedDatasetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(AnnotatedDatasetMetadata)
+
+Example = _reflection.GeneratedProtocolMessageType(
+    "Example",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXAMPLE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.dataset_pb2",
+        __doc__="""An Example is a piece of data and its annotation. For example, an image
+  with label "house".
+  
+  
+  Attributes:
+      payload:
+          Output only. The data part of Example.
+      image_payload:
+          The image payload, a container of the image bytes/uri.
+      text_payload:
+          The text payload, a container of the text content.
+      video_payload:
+          The video payload, a container of the video uri.
+      name:
+          Output only. Name of the example, in format of: projects/{proj
+          ect\_id}/datasets/{dataset\_id}/annotatedDatasets/
+          {annotated\_dataset\_id}/examples/{example\_id}
+      annotations:
+          Output only. Annotations for the piece of data in Example. One
+          piece of data can have multiple annotations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Example)
+    ),
+)
+_sym_db.RegisterMessage(Example)
+
+
+DESCRIPTOR._options = None
+_LABELSTATS_EXAMPLECOUNTENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/dataset_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation.proto
new file mode 100644
index 000000000000..ad1e975a30b2
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation.proto
@@ -0,0 +1,167 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datalabeling/v1beta1/annotation.proto";
+import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto";
+import "google/protobuf/timestamp.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";
+
+// Describes an evaluation between 2 annotated datasets. Created by an
+// evaluation plan.
+message Evaluation {
+  // Resource name of an evaluation.
+  // Format:
+  // 'projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}'
+  string name = 1;
+
+  // Options used in evaluation plan for creating the evaluation.
+  EvaluationConfig config = 2;
+
+  // Output only. Timestamp when the evaluation plan triggered this evaluation
+  // flow.
+  google.protobuf.Timestamp evaluation_job_run_time = 3;
+
+  // Output only. Timestamp when this model evaluation was created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. Metrics of the evaluation.
+  EvaluationMetrics evaluation_metrics = 5;
+
+  // Type of the annotation to compute metrics for in the groundtruth and
+  // annotation labeled dataset. Required for creation.
+  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.
+  int64 evaluated_item_count = 7;
+}
+
+message EvaluationConfig {
+  // Vertical specific options for general metrics.
+  oneof vertical_option {
+    BoundingBoxEvaluationOptions bounding_box_evaluation_options = 1;
+  }
+}
+
+// Options regarding evaluation between bounding boxes.
+message BoundingBoxEvaluationOptions {
+  // Minimize IoU required to consider 2 bounding boxes are matched.
+  float iou_threshold = 1;
+}
+
+message EvaluationMetrics {
+  // Common metrics covering most genernal cases.
+  oneof metrics {
+    ClassificationMetrics classification_metrics = 1;
+
+    ObjectDetectionMetrics object_detection_metrics = 2;
+  }
+}
+
+message ClassificationMetrics {
+  // Precision-recall curve.
+  PrCurve pr_curve = 1;
+
+  ConfusionMatrix confusion_matrix = 2;
+}
+
+message ObjectDetectionMetrics {
+  // Precision-recall curve.
+  PrCurve pr_curve = 1;
+}
+
+message PrCurve {
+  message ConfidenceMetricsEntry {
+    // Threshold used for this entry, for example, IoU threshold for bounding
+    // box problem, or detection threshold for classification.
+    float confidence_threshold = 1;
+
+    // Recall value.
+    float recall = 2;
+
+    // Precision value.
+    float precision = 3;
+
+    // Harmonic mean of recall and precision.
+    float f1_score = 4;
+
+    // Recall value for entries with label that has highest score.
+    float recall_at1 = 5;
+
+    // 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].
+    float f1_score_at1 = 7;
+
+    // Recall value for entries with label that has highest 5 scores.
+    float recall_at5 = 8;
+
+    // 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].
+    float f1_score_at5 = 10;
+  }
+
+  // PR curve against which annotation spec. Could be empty.
+  AnnotationSpec annotation_spec = 1;
+
+  // Area under precision recall curve.
+  float area_under_curve = 2;
+
+  // entries to draw PR graph.
+  repeated ConfidenceMetricsEntry confidence_metrics_entries = 3;
+
+  // 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.
+message ConfusionMatrix {
+  message ConfusionMatrixEntry {
+    // The predicted annotation spec.
+    AnnotationSpec annotation_spec = 1;
+
+    // Number of items being predicted as this label.
+    int32 item_count = 2;
+  }
+
+  // A row in the confusion matrix.
+  message Row {
+    // the original annotation spec of this row.
+    AnnotationSpec annotation_spec = 1;
+
+    // Info describing predicted label distribution.
+    repeated ConfusionMatrixEntry entries = 2;
+  }
+
+  repeated Row row = 1;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto
new file mode 100644
index 000000000000..ad642464347d
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto
@@ -0,0 +1,151 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datalabeling/v1beta1/dataset.proto";
+import "google/cloud/datalabeling/v1beta1/evaluation.proto";
+import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.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";
+
+// Defines an evaluation job that is triggered periodically to generate
+// evaluations.
+message EvaluationJob {
+  // State of the job.
+  enum State {
+    STATE_UNSPECIFIED = 0;
+
+    SCHEDULED = 1;
+
+    RUNNING = 2;
+
+    PAUSED = 3;
+
+    STOPPED = 4;
+  }
+
+  // Format: 'projects/{project_id}/evaluationJobs/{evaluation_job_id}'
+  string name = 1;
+
+  // Description of the job. The description can be up to
+  // 25000 characters long.
+  string description = 2;
+
+  State state = 3;
+
+  // Describes the schedule on which the job will be executed. Minimum schedule
+  // unit is 1 day.
+  //
+  // The schedule can be either of the following types:
+  // * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview)
+  // * English-like
+  //
+  // [schedule](https:
+  // //cloud.google.com/scheduler/docs/configuring/cron-job-schedules)
+  string schedule = 4;
+
+  // The versioned model that is being evaluated here.
+  // Only one job is allowed for each model name.
+  // Format: 'projects/*/models/*/versions/*'
+  string model_version = 5;
+
+  // Detailed config for running this eval job.
+  EvaluationJobConfig evaluation_job_config = 6;
+
+  // Name of the AnnotationSpecSet.
+  string annotation_spec_set = 7;
+
+  // If a human annotation should be requested when some data don't have ground
+  // truth.
+  bool label_missing_ground_truth = 8;
+
+  // Output only. Any attempts with errors happening in evaluation job runs each
+  // time will be recorded here incrementally.
+  repeated Attempt attempts = 9;
+
+  // Timestamp when this evaluation job was created.
+  google.protobuf.Timestamp create_time = 10;
+}
+
+message EvaluationJobConfig {
+  // config specific to different supported human annotation use cases.
+  oneof human_annotation_request_config {
+    ImageClassificationConfig image_classification_config = 4;
+
+    BoundingPolyConfig bounding_poly_config = 5;
+
+    VideoClassificationConfig video_classification_config = 6;
+
+    ObjectDetectionConfig object_detection_config = 7;
+
+    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.
+  InputConfig input_config = 1;
+
+  // Config used to create evaluation.
+  EvaluationConfig evaluation_config = 2;
+
+  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:
+  //
+  // https:
+  // //docs.google.com/document/d/1bg1meMIBGY
+  // // 9I5QEoFoHSX6u9LsZQYBSmPt6E9SxqHZc/edit#heading=h.tfyjhxhvsqem
+  map<string, string> bigquery_import_keys = 9;
+
+  // Max number of examples to collect in each period.
+  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.
+  double example_sample_percentage = 11;
+
+  // Alert config for the evaluation job. The alert will be triggered when its
+  // criteria is met.
+  EvaluationJobAlertConfig evaluation_job_alert_config = 13;
+}
+
+message EvaluationJobAlertConfig {
+  // Required. Email of the user who will be receiving the alert.
+  string email = 1;
+
+  // If a single evaluation run's aggregate mean average precision is
+  // lower than this threshold, the alert will be triggered.
+  double min_acceptable_mean_average_precision = 2;
+}
+
+// Records a failed attempt.
+message Attempt {
+  google.protobuf.Timestamp attempt_time = 1;
+
+  repeated google.rpc.Status partial_failures = 2;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job_pb2.py
new file mode 100644
index 000000000000..ac1522440268
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job_pb2.py
@@ -0,0 +1,972 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    evaluation_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    human_annotation_config_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n<google/cloud/datalabeling_v1beta1/proto/evaluation_job.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x35google/cloud/datalabeling_v1beta1/proto/dataset.proto\x1a\x38google/cloud/datalabeling_v1beta1/proto/evaluation.proto\x1a\x45google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xfe\x03\n\rEvaluationJob\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x45\n\x05state\x18\x03 \x01(\x0e\x32\x36.google.cloud.datalabeling.v1beta1.EvaluationJob.State\x12\x10\n\x08schedule\x18\x04 \x01(\t\x12\x15\n\rmodel_version\x18\x05 \x01(\t\x12U\n\x15\x65valuation_job_config\x18\x06 \x01(\x0b\x32\x36.google.cloud.datalabeling.v1beta1.EvaluationJobConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x07 \x01(\t\x12"\n\x1alabel_missing_ground_truth\x18\x08 \x01(\x08\x12<\n\x08\x61ttempts\x18\t \x03(\x0b\x32*.google.cloud.datalabeling.v1beta1.Attempt\x12/\n\x0b\x63reate_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp"S\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\r\n\tSCHEDULED\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\n\n\x06PAUSED\x10\x03\x12\x0b\n\x07STOPPED\x10\x04"\xaa\t\n\x13\x45valuationJobConfig\x12\x63\n\x1bimage_classification_config\x18\x04 \x01(\x0b\x32<.google.cloud.datalabeling.v1beta1.ImageClassificationConfigH\x00\x12U\n\x14\x62ounding_poly_config\x18\x05 \x01(\x0b\x32\x35.google.cloud.datalabeling.v1beta1.BoundingPolyConfigH\x00\x12\x63\n\x1bvideo_classification_config\x18\x06 \x01(\x0b\x32<.google.cloud.datalabeling.v1beta1.VideoClassificationConfigH\x00\x12[\n\x17object_detection_config\x18\x07 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.ObjectDetectionConfigH\x00\x12\x61\n\x1atext_classification_config\x18\x08 \x01(\x0b\x32;.google.cloud.datalabeling.v1beta1.TextClassificationConfigH\x00\x12Y\n\x16object_tracking_config\x18\x0c \x01(\x0b\x32\x37.google.cloud.datalabeling.v1beta1.ObjectTrackingConfigH\x00\x12\x44\n\x0cinput_config\x18\x01 \x01(\x0b\x32..google.cloud.datalabeling.v1beta1.InputConfig\x12N\n\x11\x65valuation_config\x18\x02 \x01(\x0b\x32\x33.google.cloud.datalabeling.v1beta1.EvaluationConfig\x12Y\n\x17human_annotation_config\x18\x03 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig\x12l\n\x14\x62igquery_import_keys\x18\t \x03(\x0b\x32N.google.cloud.datalabeling.v1beta1.EvaluationJobConfig.BigqueryImportKeysEntry\x12\x15\n\rexample_count\x18\n \x01(\x05\x12!\n\x19\x65xample_sample_percentage\x18\x0b \x01(\x01\x12`\n\x1b\x65valuation_job_alert_config\x18\r \x01(\x0b\x32;.google.cloud.datalabeling.v1beta1.EvaluationJobAlertConfig\x1a\x39\n\x17\x42igqueryImportKeysEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42!\n\x1fhuman_annotation_request_config"X\n\x18\x45valuationJobAlertConfig\x12\r\n\x05\x65mail\x18\x01 \x01(\t\x12-\n%min_acceptable_mean_average_precision\x18\x02 \x01(\x01"i\n\x07\x41ttempt\x12\x30\n\x0c\x61ttempt_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x10partial_failures\x18\x02 \x03(\x0b\x32\x12.google.rpc.StatusBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_EVALUATIONJOB_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCHEDULED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STOPPED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=799,
+    serialized_end=882,
+)
+_sym_db.RegisterEnumDescriptor(_EVALUATIONJOB_STATE)
+
+
+_EVALUATIONJOB = _descriptor.Descriptor(
+    name="EvaluationJob",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.schedule",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model_version",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.model_version",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluation_job_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.evaluation_job_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.annotation_spec_set",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_missing_ground_truth",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.label_missing_ground_truth",
+            index=7,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attempts",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.attempts",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJob.create_time",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_EVALUATIONJOB_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=372,
+    serialized_end=882,
+)
+
+
+_EVALUATIONJOBCONFIG_BIGQUERYIMPORTKEYSENTRY = _descriptor.Descriptor(
+    name="BigqueryImportKeysEntry",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.BigqueryImportKeysEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.BigqueryImportKeysEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.BigqueryImportKeysEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1987,
+    serialized_end=2044,
+)
+
+_EVALUATIONJOBCONFIG = _descriptor.Descriptor(
+    name="EvaluationJobConfig",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.image_classification_config",
+            index=0,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.bounding_poly_config",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.video_classification_config",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_detection_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.object_detection_config",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_classification_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.text_classification_config",
+            index=4,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.object_tracking_config",
+            index=5,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.input_config",
+            index=6,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluation_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.evaluation_config",
+            index=7,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="human_annotation_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.human_annotation_config",
+            index=8,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bigquery_import_keys",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.bigquery_import_keys",
+            index=9,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="example_count",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.example_count",
+            index=10,
+            number=10,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="example_sample_percentage",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.example_sample_percentage",
+            index=11,
+            number=11,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluation_job_alert_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.evaluation_job_alert_config",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_EVALUATIONJOBCONFIG_BIGQUERYIMPORTKEYSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="human_annotation_request_config",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobConfig.human_annotation_request_config",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=885,
+    serialized_end=2079,
+)
+
+
+_EVALUATIONJOBALERTCONFIG = _descriptor.Descriptor(
+    name="EvaluationJobAlertConfig",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationJobAlertConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="email",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobAlertConfig.email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_acceptable_mean_average_precision",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationJobAlertConfig.min_acceptable_mean_average_precision",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2081,
+    serialized_end=2169,
+)
+
+
+_ATTEMPT = _descriptor.Descriptor(
+    name="Attempt",
+    full_name="google.cloud.datalabeling.v1beta1.Attempt",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="attempt_time",
+            full_name="google.cloud.datalabeling.v1beta1.Attempt.attempt_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_failures",
+            full_name="google.cloud.datalabeling.v1beta1.Attempt.partial_failures",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2171,
+    serialized_end=2276,
+)
+
+_EVALUATIONJOB.fields_by_name["state"].enum_type = _EVALUATIONJOB_STATE
+_EVALUATIONJOB.fields_by_name[
+    "evaluation_job_config"
+].message_type = _EVALUATIONJOBCONFIG
+_EVALUATIONJOB.fields_by_name["attempts"].message_type = _ATTEMPT
+_EVALUATIONJOB.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EVALUATIONJOB_STATE.containing_type = _EVALUATIONJOB
+_EVALUATIONJOBCONFIG_BIGQUERYIMPORTKEYSENTRY.containing_type = _EVALUATIONJOBCONFIG
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "image_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._IMAGECLASSIFICATIONCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "bounding_poly_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._BOUNDINGPOLYCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "video_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._VIDEOCLASSIFICATIONCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "object_detection_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._OBJECTDETECTIONCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "text_classification_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._TEXTCLASSIFICATIONCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "object_tracking_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._OBJECTTRACKINGCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "input_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._INPUTCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "evaluation_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_evaluation__pb2._EVALUATIONCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "human_annotation_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "bigquery_import_keys"
+].message_type = _EVALUATIONJOBCONFIG_BIGQUERYIMPORTKEYSENTRY
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "evaluation_job_alert_config"
+].message_type = _EVALUATIONJOBALERTCONFIG
+_EVALUATIONJOBCONFIG.oneofs_by_name["human_annotation_request_config"].fields.append(
+    _EVALUATIONJOBCONFIG.fields_by_name["image_classification_config"]
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "image_classification_config"
+].containing_oneof = _EVALUATIONJOBCONFIG.oneofs_by_name[
+    "human_annotation_request_config"
+]
+_EVALUATIONJOBCONFIG.oneofs_by_name["human_annotation_request_config"].fields.append(
+    _EVALUATIONJOBCONFIG.fields_by_name["bounding_poly_config"]
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "bounding_poly_config"
+].containing_oneof = _EVALUATIONJOBCONFIG.oneofs_by_name[
+    "human_annotation_request_config"
+]
+_EVALUATIONJOBCONFIG.oneofs_by_name["human_annotation_request_config"].fields.append(
+    _EVALUATIONJOBCONFIG.fields_by_name["video_classification_config"]
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "video_classification_config"
+].containing_oneof = _EVALUATIONJOBCONFIG.oneofs_by_name[
+    "human_annotation_request_config"
+]
+_EVALUATIONJOBCONFIG.oneofs_by_name["human_annotation_request_config"].fields.append(
+    _EVALUATIONJOBCONFIG.fields_by_name["object_detection_config"]
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "object_detection_config"
+].containing_oneof = _EVALUATIONJOBCONFIG.oneofs_by_name[
+    "human_annotation_request_config"
+]
+_EVALUATIONJOBCONFIG.oneofs_by_name["human_annotation_request_config"].fields.append(
+    _EVALUATIONJOBCONFIG.fields_by_name["text_classification_config"]
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "text_classification_config"
+].containing_oneof = _EVALUATIONJOBCONFIG.oneofs_by_name[
+    "human_annotation_request_config"
+]
+_EVALUATIONJOBCONFIG.oneofs_by_name["human_annotation_request_config"].fields.append(
+    _EVALUATIONJOBCONFIG.fields_by_name["object_tracking_config"]
+)
+_EVALUATIONJOBCONFIG.fields_by_name[
+    "object_tracking_config"
+].containing_oneof = _EVALUATIONJOBCONFIG.oneofs_by_name[
+    "human_annotation_request_config"
+]
+_ATTEMPT.fields_by_name[
+    "attempt_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "partial_failures"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+DESCRIPTOR.message_types_by_name["EvaluationJob"] = _EVALUATIONJOB
+DESCRIPTOR.message_types_by_name["EvaluationJobConfig"] = _EVALUATIONJOBCONFIG
+DESCRIPTOR.message_types_by_name["EvaluationJobAlertConfig"] = _EVALUATIONJOBALERTCONFIG
+DESCRIPTOR.message_types_by_name["Attempt"] = _ATTEMPT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+EvaluationJob = _reflection.GeneratedProtocolMessageType(
+    "EvaluationJob",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVALUATIONJOB,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_job_pb2",
+        __doc__="""Defines an evaluation job that is triggered periodically to generate
+  evaluations.
+  
+  
+  Attributes:
+      name:
+          Format:
+          'projects/{project\_id}/evaluationJobs/{evaluation\_job\_id}'
+      description:
+          Description of the job. The description can be up to 25000
+          characters long.
+      schedule:
+          Describes the schedule on which the job will be executed.
+          Minimum schedule unit is 1 day.  The schedule can be either of
+          the following types: \* `Crontab
+          <http://en.wikipedia.org/wiki/Cron#Overview>`__ \* English-
+          like  `schedule
+          <https:%20//cloud.google.com/scheduler/docs/configuring/cron-
+          job-schedules>`__
+      model_version:
+          The versioned model that is being evaluated here. Only one job
+          is allowed for each model name. Format:
+          'projects/*/models/*/versions/\*'
+      evaluation_job_config:
+          Detailed config for running this eval job.
+      annotation_spec_set:
+          Name of the AnnotationSpecSet.
+      label_missing_ground_truth:
+          If a human annotation should be requested when some data don't
+          have ground truth.
+      attempts:
+          Output only. Any attempts with errors happening in evaluation
+          job runs each time will be recorded here incrementally.
+      create_time:
+          Timestamp when this evaluation job was created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EvaluationJob)
+    ),
+)
+_sym_db.RegisterMessage(EvaluationJob)
+
+EvaluationJobConfig = _reflection.GeneratedProtocolMessageType(
+    "EvaluationJobConfig",
+    (_message.Message,),
+    dict(
+        BigqueryImportKeysEntry=_reflection.GeneratedProtocolMessageType(
+            "BigqueryImportKeysEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_EVALUATIONJOBCONFIG_BIGQUERYIMPORTKEYSENTRY,
+                __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_job_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EvaluationJobConfig.BigqueryImportKeysEntry)
+            ),
+        ),
+        DESCRIPTOR=_EVALUATIONJOBCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_job_pb2",
+        __doc__="""
+    Attributes:
+      human_annotation_request_config:
+          config specific to different supported human annotation use
+          cases.
+      input_config:
+          Input config for data, gcs\_source in the config will be the
+          root path for data. Data should be organzied chronically under
+          that path.
+      evaluation_config:
+          Config used to create evaluation.
+      bigquery_import_keys:
+          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:  https: //docs.google.com/document/d/1bg1meMIBGY //
+          9I5QEoFoHSX6u9LsZQYBSmPt6E9SxqHZc/edit#heading=h.tfyjhxhvsqem
+      example_count:
+          Max number of examples to collect in each period.
+      example_sample_percentage:
+          Percentage of examples to collect in each period. 0.1 means
+          10% of total examples will be collected, and 0.0 means no
+          collection.
+      evaluation_job_alert_config:
+          Alert config for the evaluation job. The alert will be
+          triggered when its criteria is met.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EvaluationJobConfig)
+    ),
+)
+_sym_db.RegisterMessage(EvaluationJobConfig)
+_sym_db.RegisterMessage(EvaluationJobConfig.BigqueryImportKeysEntry)
+
+EvaluationJobAlertConfig = _reflection.GeneratedProtocolMessageType(
+    "EvaluationJobAlertConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVALUATIONJOBALERTCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_job_pb2",
+        __doc__="""
+    Attributes:
+      email:
+          Required. Email of the user who will be receiving the alert.
+      min_acceptable_mean_average_precision:
+          If a single evaluation run's aggregate mean average precision
+          is lower than this threshold, the alert will be triggered.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EvaluationJobAlertConfig)
+    ),
+)
+_sym_db.RegisterMessage(EvaluationJobAlertConfig)
+
+Attempt = _reflection.GeneratedProtocolMessageType(
+    "Attempt",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ATTEMPT,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_job_pb2",
+        __doc__="""Records a failed attempt.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Attempt)
+    ),
+)
+_sym_db.RegisterMessage(Attempt)
+
+
+DESCRIPTOR._options = None
+_EVALUATIONJOBCONFIG_BIGQUERYIMPORTKEYSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_job_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_pb2.py
new file mode 100644
index 000000000000..d3f231f6d05c
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_pb2.py
@@ -0,0 +1,1202 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/evaluation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    annotation_spec_set_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/evaluation.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/datalabeling_v1beta1/proto/evaluation.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x38google/cloud/datalabeling_v1beta1/proto/annotation.proto\x1a\x41google/cloud/datalabeling_v1beta1/proto/annotation_spec_set.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x89\x03\n\nEvaluation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x43\n\x06\x63onfig\x18\x02 \x01(\x0b\x32\x33.google.cloud.datalabeling.v1beta1.EvaluationConfig\x12;\n\x17\x65valuation_job_run_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12P\n\x12\x65valuation_metrics\x18\x05 \x01(\x0b\x32\x34.google.cloud.datalabeling.v1beta1.EvaluationMetrics\x12J\n\x0f\x61nnotation_type\x18\x06 \x01(\x0e\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationType\x12\x1c\n\x14\x65valuated_item_count\x18\x07 \x01(\x03"\x91\x01\n\x10\x45valuationConfig\x12j\n\x1f\x62ounding_box_evaluation_options\x18\x01 \x01(\x0b\x32?.google.cloud.datalabeling.v1beta1.BoundingBoxEvaluationOptionsH\x00\x42\x11\n\x0fvertical_option"5\n\x1c\x42oundingBoxEvaluationOptions\x12\x15\n\riou_threshold\x18\x01 \x01(\x02"\xd9\x01\n\x11\x45valuationMetrics\x12Z\n\x16\x63lassification_metrics\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.ClassificationMetricsH\x00\x12]\n\x18object_detection_metrics\x18\x02 \x01(\x0b\x32\x39.google.cloud.datalabeling.v1beta1.ObjectDetectionMetricsH\x00\x42\t\n\x07metrics"\xa3\x01\n\x15\x43lassificationMetrics\x12<\n\x08pr_curve\x18\x01 \x01(\x0b\x32*.google.cloud.datalabeling.v1beta1.PrCurve\x12L\n\x10\x63onfusion_matrix\x18\x02 \x01(\x0b\x32\x32.google.cloud.datalabeling.v1beta1.ConfusionMatrix"V\n\x16ObjectDetectionMetrics\x12<\n\x08pr_curve\x18\x01 \x01(\x0b\x32*.google.cloud.datalabeling.v1beta1.PrCurve"\xe6\x03\n\x07PrCurve\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12\x18\n\x10\x61rea_under_curve\x18\x02 \x01(\x02\x12\x65\n\x1a\x63onfidence_metrics_entries\x18\x03 \x03(\x0b\x32\x41.google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry\x12\x1e\n\x16mean_average_precision\x18\x04 \x01(\x02\x1a\xed\x01\n\x16\x43onfidenceMetricsEntry\x12\x1c\n\x14\x63onfidence_threshold\x18\x01 \x01(\x02\x12\x0e\n\x06recall\x18\x02 \x01(\x02\x12\x11\n\tprecision\x18\x03 \x01(\x02\x12\x10\n\x08\x66\x31_score\x18\x04 \x01(\x02\x12\x12\n\nrecall_at1\x18\x05 \x01(\x02\x12\x15\n\rprecision_at1\x18\x06 \x01(\x02\x12\x14\n\x0c\x66\x31_score_at1\x18\x07 \x01(\x02\x12\x12\n\nrecall_at5\x18\x08 \x01(\x02\x12\x15\n\rprecision_at5\x18\t \x01(\x02\x12\x14\n\x0c\x66\x31_score_at5\x18\n \x01(\x02"\xfc\x02\n\x0f\x43onfusionMatrix\x12\x43\n\x03row\x18\x01 \x03(\x0b\x32\x36.google.cloud.datalabeling.v1beta1.ConfusionMatrix.Row\x1av\n\x14\x43onfusionMatrixEntry\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12\x12\n\nitem_count\x18\x02 \x01(\x05\x1a\xab\x01\n\x03Row\x12J\n\x0f\x61nnotation_spec\x18\x01 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.AnnotationSpec\x12X\n\x07\x65ntries\x18\x02 \x03(\x0b\x32G.google.cloud.datalabeling.v1beta1.ConfusionMatrix.ConfusionMatrixEntryBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_EVALUATION = _descriptor.Descriptor(
+    name="Evaluation",
+    full_name="google.cloud.datalabeling.v1beta1.Evaluation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluation_job_run_time",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.evaluation_job_run_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluation_metrics",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.evaluation_metrics",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_type",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.annotation_type",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="evaluated_item_count",
+            full_name="google.cloud.datalabeling.v1beta1.Evaluation.evaluated_item_count",
+            index=6,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=284,
+    serialized_end=677,
+)
+
+
+_EVALUATIONCONFIG = _descriptor.Descriptor(
+    name="EvaluationConfig",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_box_evaluation_options",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationConfig.bounding_box_evaluation_options",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="vertical_option",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationConfig.vertical_option",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=680,
+    serialized_end=825,
+)
+
+
+_BOUNDINGBOXEVALUATIONOPTIONS = _descriptor.Descriptor(
+    name="BoundingBoxEvaluationOptions",
+    full_name="google.cloud.datalabeling.v1beta1.BoundingBoxEvaluationOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="iou_threshold",
+            full_name="google.cloud.datalabeling.v1beta1.BoundingBoxEvaluationOptions.iou_threshold",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=827,
+    serialized_end=880,
+)
+
+
+_EVALUATIONMETRICS = _descriptor.Descriptor(
+    name="EvaluationMetrics",
+    full_name="google.cloud.datalabeling.v1beta1.EvaluationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="classification_metrics",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationMetrics.classification_metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_detection_metrics",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationMetrics.object_detection_metrics",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="metrics",
+            full_name="google.cloud.datalabeling.v1beta1.EvaluationMetrics.metrics",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=883,
+    serialized_end=1100,
+)
+
+
+_CLASSIFICATIONMETRICS = _descriptor.Descriptor(
+    name="ClassificationMetrics",
+    full_name="google.cloud.datalabeling.v1beta1.ClassificationMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pr_curve",
+            full_name="google.cloud.datalabeling.v1beta1.ClassificationMetrics.pr_curve",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confusion_matrix",
+            full_name="google.cloud.datalabeling.v1beta1.ClassificationMetrics.confusion_matrix",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1103,
+    serialized_end=1266,
+)
+
+
+_OBJECTDETECTIONMETRICS = _descriptor.Descriptor(
+    name="ObjectDetectionMetrics",
+    full_name="google.cloud.datalabeling.v1beta1.ObjectDetectionMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pr_curve",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectDetectionMetrics.pr_curve",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1268,
+    serialized_end=1354,
+)
+
+
+_PRCURVE_CONFIDENCEMETRICSENTRY = _descriptor.Descriptor(
+    name="ConfidenceMetricsEntry",
+    full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="confidence_threshold",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.confidence_threshold",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.f1_score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall_at1",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall_at1",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision_at1",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision_at1",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score_at1",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.f1_score_at1",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recall_at5",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall_at5",
+            index=7,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precision_at5",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision_at5",
+            index=8,
+            number=9,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="f1_score_at5",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.f1_score_at5",
+            index=9,
+            number=10,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1606,
+    serialized_end=1843,
+)
+
+_PRCURVE = _descriptor.Descriptor(
+    name="PrCurve",
+    full_name="google.cloud.datalabeling.v1beta1.PrCurve",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="area_under_curve",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.area_under_curve",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence_metrics_entries",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.confidence_metrics_entries",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mean_average_precision",
+            full_name="google.cloud.datalabeling.v1beta1.PrCurve.mean_average_precision",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRCURVE_CONFIDENCEMETRICSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1357,
+    serialized_end=1843,
+)
+
+
+_CONFUSIONMATRIX_CONFUSIONMATRIXENTRY = _descriptor.Descriptor(
+    name="ConfusionMatrixEntry",
+    full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.ConfusionMatrixEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.ConfusionMatrixEntry.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="item_count",
+            full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.ConfusionMatrixEntry.item_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1934,
+    serialized_end=2052,
+)
+
+_CONFUSIONMATRIX_ROW = _descriptor.Descriptor(
+    name="Row",
+    full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.Row",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec",
+            full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.Row.annotation_spec",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.Row.entries",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2055,
+    serialized_end=2226,
+)
+
+_CONFUSIONMATRIX = _descriptor.Descriptor(
+    name="ConfusionMatrix",
+    full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row",
+            full_name="google.cloud.datalabeling.v1beta1.ConfusionMatrix.row",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_CONFUSIONMATRIX_CONFUSIONMATRIXENTRY, _CONFUSIONMATRIX_ROW],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1846,
+    serialized_end=2226,
+)
+
+_EVALUATION.fields_by_name["config"].message_type = _EVALUATIONCONFIG
+_EVALUATION.fields_by_name[
+    "evaluation_job_run_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EVALUATION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EVALUATION.fields_by_name["evaluation_metrics"].message_type = _EVALUATIONMETRICS
+_EVALUATION.fields_by_name[
+    "annotation_type"
+].enum_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__pb2._ANNOTATIONTYPE
+)
+_EVALUATIONCONFIG.fields_by_name[
+    "bounding_box_evaluation_options"
+].message_type = _BOUNDINGBOXEVALUATIONOPTIONS
+_EVALUATIONCONFIG.oneofs_by_name["vertical_option"].fields.append(
+    _EVALUATIONCONFIG.fields_by_name["bounding_box_evaluation_options"]
+)
+_EVALUATIONCONFIG.fields_by_name[
+    "bounding_box_evaluation_options"
+].containing_oneof = _EVALUATIONCONFIG.oneofs_by_name["vertical_option"]
+_EVALUATIONMETRICS.fields_by_name[
+    "classification_metrics"
+].message_type = _CLASSIFICATIONMETRICS
+_EVALUATIONMETRICS.fields_by_name[
+    "object_detection_metrics"
+].message_type = _OBJECTDETECTIONMETRICS
+_EVALUATIONMETRICS.oneofs_by_name["metrics"].fields.append(
+    _EVALUATIONMETRICS.fields_by_name["classification_metrics"]
+)
+_EVALUATIONMETRICS.fields_by_name[
+    "classification_metrics"
+].containing_oneof = _EVALUATIONMETRICS.oneofs_by_name["metrics"]
+_EVALUATIONMETRICS.oneofs_by_name["metrics"].fields.append(
+    _EVALUATIONMETRICS.fields_by_name["object_detection_metrics"]
+)
+_EVALUATIONMETRICS.fields_by_name[
+    "object_detection_metrics"
+].containing_oneof = _EVALUATIONMETRICS.oneofs_by_name["metrics"]
+_CLASSIFICATIONMETRICS.fields_by_name["pr_curve"].message_type = _PRCURVE
+_CLASSIFICATIONMETRICS.fields_by_name[
+    "confusion_matrix"
+].message_type = _CONFUSIONMATRIX
+_OBJECTDETECTIONMETRICS.fields_by_name["pr_curve"].message_type = _PRCURVE
+_PRCURVE_CONFIDENCEMETRICSENTRY.containing_type = _PRCURVE
+_PRCURVE.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_PRCURVE.fields_by_name[
+    "confidence_metrics_entries"
+].message_type = _PRCURVE_CONFIDENCEMETRICSENTRY
+_CONFUSIONMATRIX_CONFUSIONMATRIXENTRY.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_CONFUSIONMATRIX_CONFUSIONMATRIXENTRY.containing_type = _CONFUSIONMATRIX
+_CONFUSIONMATRIX_ROW.fields_by_name[
+    "annotation_spec"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_annotation__spec__set__pb2._ANNOTATIONSPEC
+)
+_CONFUSIONMATRIX_ROW.fields_by_name[
+    "entries"
+].message_type = _CONFUSIONMATRIX_CONFUSIONMATRIXENTRY
+_CONFUSIONMATRIX_ROW.containing_type = _CONFUSIONMATRIX
+_CONFUSIONMATRIX.fields_by_name["row"].message_type = _CONFUSIONMATRIX_ROW
+DESCRIPTOR.message_types_by_name["Evaluation"] = _EVALUATION
+DESCRIPTOR.message_types_by_name["EvaluationConfig"] = _EVALUATIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "BoundingBoxEvaluationOptions"
+] = _BOUNDINGBOXEVALUATIONOPTIONS
+DESCRIPTOR.message_types_by_name["EvaluationMetrics"] = _EVALUATIONMETRICS
+DESCRIPTOR.message_types_by_name["ClassificationMetrics"] = _CLASSIFICATIONMETRICS
+DESCRIPTOR.message_types_by_name["ObjectDetectionMetrics"] = _OBJECTDETECTIONMETRICS
+DESCRIPTOR.message_types_by_name["PrCurve"] = _PRCURVE
+DESCRIPTOR.message_types_by_name["ConfusionMatrix"] = _CONFUSIONMATRIX
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Evaluation = _reflection.GeneratedProtocolMessageType(
+    "Evaluation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVALUATION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""Describes an evaluation between 2 annotated datasets. Created by an
+  evaluation plan.
+  
+  
+  Attributes:
+      name:
+          Resource name of an evaluation. Format: 'projects/{project\_id
+          }/datasets/{dataset\_id}/evaluations/{evaluation\_id}'
+      config:
+          Options used in evaluation plan for creating the evaluation.
+      evaluation_job_run_time:
+          Output only. Timestamp when the evaluation plan triggered this
+          evaluation flow.
+      create_time:
+          Output only. Timestamp when this model evaluation was created.
+      evaluation_metrics:
+          Output only. Metrics of the evaluation.
+      annotation_type:
+          Type of the annotation to compute metrics for in the
+          groundtruth and annotation labeled dataset. Required for
+          creation.
+      evaluated_item_count:
+          Output only. Count of items in groundtruth dataset included in
+          this evaluation. Will be unset if annotation type is not
+          applicable.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Evaluation)
+    ),
+)
+_sym_db.RegisterMessage(Evaluation)
+
+EvaluationConfig = _reflection.GeneratedProtocolMessageType(
+    "EvaluationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVALUATIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""
+    Attributes:
+      vertical_option:
+          Vertical specific options for general metrics.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EvaluationConfig)
+    ),
+)
+_sym_db.RegisterMessage(EvaluationConfig)
+
+BoundingBoxEvaluationOptions = _reflection.GeneratedProtocolMessageType(
+    "BoundingBoxEvaluationOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGBOXEVALUATIONOPTIONS,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""Options regarding evaluation between bounding boxes.
+  
+  
+  Attributes:
+      iou_threshold:
+          Minimize IoU required to consider 2 bounding boxes are
+          matched.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.BoundingBoxEvaluationOptions)
+    ),
+)
+_sym_db.RegisterMessage(BoundingBoxEvaluationOptions)
+
+EvaluationMetrics = _reflection.GeneratedProtocolMessageType(
+    "EvaluationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVALUATIONMETRICS,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""
+    Attributes:
+      metrics:
+          Common metrics covering most genernal cases.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EvaluationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(EvaluationMetrics)
+
+ClassificationMetrics = _reflection.GeneratedProtocolMessageType(
+    "ClassificationMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFICATIONMETRICS,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""
+    Attributes:
+      pr_curve:
+          Precision-recall curve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ClassificationMetrics)
+    ),
+)
+_sym_db.RegisterMessage(ClassificationMetrics)
+
+ObjectDetectionMetrics = _reflection.GeneratedProtocolMessageType(
+    "ObjectDetectionMetrics",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTDETECTIONMETRICS,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""
+    Attributes:
+      pr_curve:
+          Precision-recall curve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ObjectDetectionMetrics)
+    ),
+)
+_sym_db.RegisterMessage(ObjectDetectionMetrics)
+
+PrCurve = _reflection.GeneratedProtocolMessageType(
+    "PrCurve",
+    (_message.Message,),
+    dict(
+        ConfidenceMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "ConfidenceMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRCURVE_CONFIDENCEMETRICSENTRY,
+                __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+                __doc__="""
+    Attributes:
+        confidence_threshold:
+            Threshold used for this entry, for example, IoU threshold for
+            bounding box problem, or detection threshold for
+            classification.
+        recall:
+            Recall value.
+        precision:
+            Precision value.
+        f1_score:
+            Harmonic mean of recall and precision.
+        recall_at1:
+            Recall value for entries with label that has highest score.
+        precision_at1:
+            Precision value for entries with label that has highest score.
+        f1_score_at1:
+            The harmonic mean of [recall\_at1][google.cloud.datalabeling.v
+            1beta1.PrCurve.ConfidenceMetricsEntry.recall\_at1] and [precis
+            ion\_at1][google.cloud.datalabeling.v1beta1.PrCurve.Confidence
+            MetricsEntry.precision\_at1].
+        recall_at5:
+            Recall value for entries with label that has highest 5 scores.
+        precision_at5:
+            Precision value for entries with label that has highest 5
+            scores.
+        f1_score_at5:
+            The harmonic mean of [recall\_at5][google.cloud.datalabeling.v
+            1beta1.PrCurve.ConfidenceMetricsEntry.recall\_at5] and [precis
+            ion\_at5][google.cloud.datalabeling.v1beta1.PrCurve.Confidence
+            MetricsEntry.precision\_at5].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry)
+            ),
+        ),
+        DESCRIPTOR=_PRCURVE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""
+    Attributes:
+      annotation_spec:
+          PR curve against which annotation spec. Could be empty.
+      area_under_curve:
+          Area under precision recall curve.
+      confidence_metrics_entries:
+          entries to draw PR graph.
+      mean_average_precision:
+          mean average prcision of this curve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.PrCurve)
+    ),
+)
+_sym_db.RegisterMessage(PrCurve)
+_sym_db.RegisterMessage(PrCurve.ConfidenceMetricsEntry)
+
+ConfusionMatrix = _reflection.GeneratedProtocolMessageType(
+    "ConfusionMatrix",
+    (_message.Message,),
+    dict(
+        ConfusionMatrixEntry=_reflection.GeneratedProtocolMessageType(
+            "ConfusionMatrixEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CONFUSIONMATRIX_CONFUSIONMATRIXENTRY,
+                __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+                __doc__="""
+    Attributes:
+        annotation_spec:
+            The predicted annotation spec.
+        item_count:
+            Number of items being predicted as this label.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ConfusionMatrix.ConfusionMatrixEntry)
+            ),
+        ),
+        Row=_reflection.GeneratedProtocolMessageType(
+            "Row",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CONFUSIONMATRIX_ROW,
+                __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+                __doc__="""A row in the confusion matrix.
+    
+    
+    Attributes:
+        annotation_spec:
+            the original annotation spec of this row.
+        entries:
+            Info describing predicted label distribution.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ConfusionMatrix.Row)
+            ),
+        ),
+        DESCRIPTOR=_CONFUSIONMATRIX,
+        __module__="google.cloud.datalabeling_v1beta1.proto.evaluation_pb2",
+        __doc__="""Confusion matrix of the model running the classification. Not applicable
+  when label filtering is specified in evaluation option.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ConfusionMatrix)
+    ),
+)
+_sym_db.RegisterMessage(ConfusionMatrix)
+_sym_db.RegisterMessage(ConfusionMatrix.ConfusionMatrixEntry)
+_sym_db.RegisterMessage(ConfusionMatrix.Row)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/evaluation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto
new file mode 100644
index 000000000000..d392aca70c1a
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto
@@ -0,0 +1,208 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.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";
+
+enum StringAggregationType {
+  STRING_AGGREGATION_TYPE_UNSPECIFIED = 0;
+
+  // Majority vote to aggregate answers.
+  MAJORITY_VOTE = 1;
+
+  // Unanimous answers will be adopted.
+  UNANIMOUS_VOTE = 2;
+
+  // Preserve all answers by crowd compute.
+  NO_AGGREGATION = 3;
+}
+
+// Configuration for how human labeling task should be done.
+message HumanAnnotationConfig {
+  // Required except for LabelAudio case. Instruction resource name.
+  string instruction = 1;
+
+  // Required. A human-readable name for AnnotatedDataset defined by
+  // users. Maximum of 64 characters
+  // .
+  string annotated_dataset_display_name = 2;
+
+  // Optional. A human-readable description for AnnotatedDataset.
+  // The description can be up to 10000 characters long.
+  string annotated_dataset_description = 3;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // Optional. Maximum duration for contributors to answer a question. Default
+  // is 1800 seconds.
+  google.protobuf.Duration question_duration = 7;
+
+  // 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;
+
+  // Email of the user who started the labeling task and should be notified by
+  // email. If empty no notification will be sent.
+  string user_email_address = 10;
+}
+
+// Config for image classification human labeling task.
+message ImageClassificationConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. If allow_multi_label is true, contributors are able to choose
+  // multiple labels for one image.
+  bool allow_multi_label = 2;
+
+  // Optional. The type of how to aggregate answers.
+  StringAggregationType answer_aggregation_type = 3;
+}
+
+// Config for image bounding poly (and bounding box) human labeling task.
+message BoundingPolyConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. Instruction message showed on contributors UI.
+  string instruction_message = 2;
+}
+
+// Config for image polyline human labeling task.
+message PolylineConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. Instruction message showed on contributors UI.
+  string instruction_message = 2;
+}
+
+// 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;
+
+  // Instruction message showed on labelers UI.
+  string instruction_message = 2;
+}
+
+// Config for video classification human labeling task.
+// Currently two types of video classification are supported:
+// 1. Assign labels on the entire video.
+// 2. Split the video into multiple video clips based on camera shot, and
+// assign labels on each video clip.
+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;
+
+    // Optional. If allow_multi_label is true, contributors are able to
+    // choose multiple labels from one annotation spec set.
+    bool allow_multi_label = 2;
+  }
+
+  // Required. The list of annotation spec set configs.
+  // Since watching a video clip takes much longer time than an image, we
+  // support label with multiple AnnotationSpecSet at the same time. Labels
+  // 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;
+
+  // Optional. Option to apply shot detection on the video.
+  bool apply_shot_detection = 2;
+}
+
+// Config for video object detection human labeling task.
+// Object detection will be conducted on the images extracted from the video,
+// and those objects will be labeled with bounding boxes.
+// User need to specify the number of images to be extracted per second as the
+// extraction frame rate.
+message ObjectDetectionConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Required. Number of frames per second to be extracted from the video.
+  double extraction_frame_rate = 3;
+}
+
+// Config for video object tracking human labeling task.
+message ObjectTrackingConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+}
+
+// Config for video event human labeling task.
+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;
+}
+
+// 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;
+
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 2;
+
+  // Optional. Configs for sentiment selection.
+  SentimentConfig sentiment_config = 3;
+}
+
+// Config for setting up sentiments.
+message SentimentConfig {
+  // If set to true, contributors will have the option to select sentiment of
+  // the label they selected, to mark it as negative or positive label. Default
+  // is false.
+  bool enable_label_sentiment_selection = 1;
+}
+
+// Config for text entity extraction human labeling task.
+message TextEntityExtractionConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config_pb2.py
new file mode 100644
index 000000000000..6dfa274db139
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config_pb2.py
@@ -0,0 +1,1252 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\nEgoogle/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto"\xac\x02\n\x15HumanAnnotationConfig\x12\x13\n\x0binstruction\x18\x01 \x01(\t\x12&\n\x1e\x61nnotated_dataset_display_name\x18\x02 \x01(\t\x12%\n\x1d\x61nnotated_dataset_description\x18\x03 \x01(\t\x12\x13\n\x0blabel_group\x18\x04 \x01(\t\x12\x15\n\rlanguage_code\x18\x05 \x01(\t\x12\x15\n\rreplica_count\x18\x06 \x01(\x05\x12\x34\n\x11question_duration\x18\x07 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x1a\n\x12\x63ontributor_emails\x18\t \x03(\t\x12\x1a\n\x12user_email_address\x18\n \x01(\t"\xae\x01\n\x19ImageClassificationConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t\x12\x19\n\x11\x61llow_multi_label\x18\x02 \x01(\x08\x12Y\n\x17\x61nswer_aggregation_type\x18\x03 \x01(\x0e\x32\x38.google.cloud.datalabeling.v1beta1.StringAggregationType"N\n\x12\x42oundingPolyConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t\x12\x1b\n\x13instruction_message\x18\x02 \x01(\t"J\n\x0ePolylineConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t\x12\x1b\n\x13instruction_message\x18\x02 \x01(\t"N\n\x12SegmentationConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t\x12\x1b\n\x13instruction_message\x18\x02 \x01(\t"\x87\x02\n\x19VideoClassificationConfig\x12y\n\x1b\x61nnotation_spec_set_configs\x18\x01 \x03(\x0b\x32T.google.cloud.datalabeling.v1beta1.VideoClassificationConfig.AnnotationSpecSetConfig\x12\x1c\n\x14\x61pply_shot_detection\x18\x02 \x01(\x08\x1aQ\n\x17\x41nnotationSpecSetConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t\x12\x19\n\x11\x61llow_multi_label\x18\x02 \x01(\x08"S\n\x15ObjectDetectionConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t\x12\x1d\n\x15\x65xtraction_frame_rate\x18\x03 \x01(\x01"3\n\x14ObjectTrackingConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t"+\n\x0b\x45ventConfig\x12\x1c\n\x14\x61nnotation_spec_sets\x18\x01 \x03(\t"\xa0\x01\n\x18TextClassificationConfig\x12\x19\n\x11\x61llow_multi_label\x18\x01 \x01(\x08\x12\x1b\n\x13\x61nnotation_spec_set\x18\x02 \x01(\t\x12L\n\x10sentiment_config\x18\x03 \x01(\x0b\x32\x32.google.cloud.datalabeling.v1beta1.SentimentConfig";\n\x0fSentimentConfig\x12(\n enable_label_sentiment_selection\x18\x01 \x01(\x08"9\n\x1aTextEntityExtractionConfig\x12\x1b\n\x13\x61nnotation_spec_set\x18\x01 \x01(\t*{\n\x15StringAggregationType\x12\'\n#STRING_AGGREGATION_TYPE_UNSPECIFIED\x10\x00\x12\x11\n\rMAJORITY_VOTE\x10\x01\x12\x12\n\x0eUNANIMOUS_VOTE\x10\x02\x12\x12\n\x0eNO_AGGREGATION\x10\x03\x42x\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+    ],
+)
+
+_STRINGAGGREGATIONTYPE = _descriptor.EnumDescriptor(
+    name="StringAggregationType",
+    full_name="google.cloud.datalabeling.v1beta1.StringAggregationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STRING_AGGREGATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MAJORITY_VOTE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNANIMOUS_VOTE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NO_AGGREGATION", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1618,
+    serialized_end=1741,
+)
+_sym_db.RegisterEnumDescriptor(_STRINGAGGREGATIONTYPE)
+
+StringAggregationType = enum_type_wrapper.EnumTypeWrapper(_STRINGAGGREGATIONTYPE)
+STRING_AGGREGATION_TYPE_UNSPECIFIED = 0
+MAJORITY_VOTE = 1
+UNANIMOUS_VOTE = 2
+NO_AGGREGATION = 3
+
+
+_HUMANANNOTATIONCONFIG = _descriptor.Descriptor(
+    name="HumanAnnotationConfig",
+    full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instruction",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.instruction",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotated_dataset_display_name",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.annotated_dataset_display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotated_dataset_description",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.annotated_dataset_description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_group",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.label_group",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.language_code",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="replica_count",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.replica_count",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="question_duration",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.question_duration",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="contributor_emails",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.contributor_emails",
+            index=7,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_email_address",
+            full_name="google.cloud.datalabeling.v1beta1.HumanAnnotationConfig.user_email_address",
+            index=8,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=171,
+    serialized_end=471,
+)
+
+
+_IMAGECLASSIFICATIONCONFIG = _descriptor.Descriptor(
+    name="ImageClassificationConfig",
+    full_name="google.cloud.datalabeling.v1beta1.ImageClassificationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.ImageClassificationConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_multi_label",
+            full_name="google.cloud.datalabeling.v1beta1.ImageClassificationConfig.allow_multi_label",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="answer_aggregation_type",
+            full_name="google.cloud.datalabeling.v1beta1.ImageClassificationConfig.answer_aggregation_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=474,
+    serialized_end=648,
+)
+
+
+_BOUNDINGPOLYCONFIG = _descriptor.Descriptor(
+    name="BoundingPolyConfig",
+    full_name="google.cloud.datalabeling.v1beta1.BoundingPolyConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.BoundingPolyConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instruction_message",
+            full_name="google.cloud.datalabeling.v1beta1.BoundingPolyConfig.instruction_message",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=650,
+    serialized_end=728,
+)
+
+
+_POLYLINECONFIG = _descriptor.Descriptor(
+    name="PolylineConfig",
+    full_name="google.cloud.datalabeling.v1beta1.PolylineConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.PolylineConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instruction_message",
+            full_name="google.cloud.datalabeling.v1beta1.PolylineConfig.instruction_message",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=730,
+    serialized_end=804,
+)
+
+
+_SEGMENTATIONCONFIG = _descriptor.Descriptor(
+    name="SegmentationConfig",
+    full_name="google.cloud.datalabeling.v1beta1.SegmentationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.SegmentationConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instruction_message",
+            full_name="google.cloud.datalabeling.v1beta1.SegmentationConfig.instruction_message",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=806,
+    serialized_end=884,
+)
+
+
+_VIDEOCLASSIFICATIONCONFIG_ANNOTATIONSPECSETCONFIG = _descriptor.Descriptor(
+    name="AnnotationSpecSetConfig",
+    full_name="google.cloud.datalabeling.v1beta1.VideoClassificationConfig.AnnotationSpecSetConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.VideoClassificationConfig.AnnotationSpecSetConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_multi_label",
+            full_name="google.cloud.datalabeling.v1beta1.VideoClassificationConfig.AnnotationSpecSetConfig.allow_multi_label",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1069,
+    serialized_end=1150,
+)
+
+_VIDEOCLASSIFICATIONCONFIG = _descriptor.Descriptor(
+    name="VideoClassificationConfig",
+    full_name="google.cloud.datalabeling.v1beta1.VideoClassificationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set_configs",
+            full_name="google.cloud.datalabeling.v1beta1.VideoClassificationConfig.annotation_spec_set_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="apply_shot_detection",
+            full_name="google.cloud.datalabeling.v1beta1.VideoClassificationConfig.apply_shot_detection",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_VIDEOCLASSIFICATIONCONFIG_ANNOTATIONSPECSETCONFIG],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=887,
+    serialized_end=1150,
+)
+
+
+_OBJECTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ObjectDetectionConfig",
+    full_name="google.cloud.datalabeling.v1beta1.ObjectDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectDetectionConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extraction_frame_rate",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectDetectionConfig.extraction_frame_rate",
+            index=1,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1152,
+    serialized_end=1235,
+)
+
+
+_OBJECTTRACKINGCONFIG = _descriptor.Descriptor(
+    name="ObjectTrackingConfig",
+    full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.ObjectTrackingConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1237,
+    serialized_end=1288,
+)
+
+
+_EVENTCONFIG = _descriptor.Descriptor(
+    name="EventConfig",
+    full_name="google.cloud.datalabeling.v1beta1.EventConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_sets",
+            full_name="google.cloud.datalabeling.v1beta1.EventConfig.annotation_spec_sets",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1290,
+    serialized_end=1333,
+)
+
+
+_TEXTCLASSIFICATIONCONFIG = _descriptor.Descriptor(
+    name="TextClassificationConfig",
+    full_name="google.cloud.datalabeling.v1beta1.TextClassificationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="allow_multi_label",
+            full_name="google.cloud.datalabeling.v1beta1.TextClassificationConfig.allow_multi_label",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.TextClassificationConfig.annotation_spec_set",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment_config",
+            full_name="google.cloud.datalabeling.v1beta1.TextClassificationConfig.sentiment_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1336,
+    serialized_end=1496,
+)
+
+
+_SENTIMENTCONFIG = _descriptor.Descriptor(
+    name="SentimentConfig",
+    full_name="google.cloud.datalabeling.v1beta1.SentimentConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_label_sentiment_selection",
+            full_name="google.cloud.datalabeling.v1beta1.SentimentConfig.enable_label_sentiment_selection",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1498,
+    serialized_end=1557,
+)
+
+
+_TEXTENTITYEXTRACTIONCONFIG = _descriptor.Descriptor(
+    name="TextEntityExtractionConfig",
+    full_name="google.cloud.datalabeling.v1beta1.TextEntityExtractionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_spec_set",
+            full_name="google.cloud.datalabeling.v1beta1.TextEntityExtractionConfig.annotation_spec_set",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1559,
+    serialized_end=1616,
+)
+
+_HUMANANNOTATIONCONFIG.fields_by_name[
+    "question_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_IMAGECLASSIFICATIONCONFIG.fields_by_name[
+    "answer_aggregation_type"
+].enum_type = _STRINGAGGREGATIONTYPE
+_VIDEOCLASSIFICATIONCONFIG_ANNOTATIONSPECSETCONFIG.containing_type = (
+    _VIDEOCLASSIFICATIONCONFIG
+)
+_VIDEOCLASSIFICATIONCONFIG.fields_by_name[
+    "annotation_spec_set_configs"
+].message_type = _VIDEOCLASSIFICATIONCONFIG_ANNOTATIONSPECSETCONFIG
+_TEXTCLASSIFICATIONCONFIG.fields_by_name[
+    "sentiment_config"
+].message_type = _SENTIMENTCONFIG
+DESCRIPTOR.message_types_by_name["HumanAnnotationConfig"] = _HUMANANNOTATIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ImageClassificationConfig"
+] = _IMAGECLASSIFICATIONCONFIG
+DESCRIPTOR.message_types_by_name["BoundingPolyConfig"] = _BOUNDINGPOLYCONFIG
+DESCRIPTOR.message_types_by_name["PolylineConfig"] = _POLYLINECONFIG
+DESCRIPTOR.message_types_by_name["SegmentationConfig"] = _SEGMENTATIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "VideoClassificationConfig"
+] = _VIDEOCLASSIFICATIONCONFIG
+DESCRIPTOR.message_types_by_name["ObjectDetectionConfig"] = _OBJECTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["ObjectTrackingConfig"] = _OBJECTTRACKINGCONFIG
+DESCRIPTOR.message_types_by_name["EventConfig"] = _EVENTCONFIG
+DESCRIPTOR.message_types_by_name["TextClassificationConfig"] = _TEXTCLASSIFICATIONCONFIG
+DESCRIPTOR.message_types_by_name["SentimentConfig"] = _SENTIMENTCONFIG
+DESCRIPTOR.message_types_by_name[
+    "TextEntityExtractionConfig"
+] = _TEXTENTITYEXTRACTIONCONFIG
+DESCRIPTOR.enum_types_by_name["StringAggregationType"] = _STRINGAGGREGATIONTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+HumanAnnotationConfig = _reflection.GeneratedProtocolMessageType(
+    "HumanAnnotationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HUMANANNOTATIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Configuration for how human labeling task should be done.
+  
+  
+  Attributes:
+      instruction:
+          Required except for LabelAudio case. Instruction resource
+          name.
+      annotated_dataset_display_name:
+          Required. A human-readable name for AnnotatedDataset defined
+          by users. Maximum of 64 characters .
+      annotated_dataset_description:
+          Optional. A human-readable description for AnnotatedDataset.
+          The description can be up to 10000 characters long.
+      label_group:
+          Optional. A human-readable label used to logically group
+          labeling tasks. This string must match the regular expression
+          ``[a-zA-Z\\d_-]{0,128}``.
+      language_code:
+          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.
+      replica_count:
+          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.
+      question_duration:
+          Optional. Maximum duration for contributors to answer a
+          question. Default is 1800 seconds.
+      contributor_emails:
+          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/
+      user_email_address:
+          Email of the user who started the labeling task and should be
+          notified by email. If empty no notification will be sent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.HumanAnnotationConfig)
+    ),
+)
+_sym_db.RegisterMessage(HumanAnnotationConfig)
+
+ImageClassificationConfig = _reflection.GeneratedProtocolMessageType(
+    "ImageClassificationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECLASSIFICATIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for image classification human labeling task.
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+      allow_multi_label:
+          Optional. If allow\_multi\_label is true, contributors are
+          able to choose multiple labels for one image.
+      answer_aggregation_type:
+          Optional. The type of how to aggregate answers.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImageClassificationConfig)
+    ),
+)
+_sym_db.RegisterMessage(ImageClassificationConfig)
+
+BoundingPolyConfig = _reflection.GeneratedProtocolMessageType(
+    "BoundingPolyConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLYCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for image bounding poly (and bounding box) human labeling task.
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+      instruction_message:
+          Optional. Instruction message showed on contributors UI.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.BoundingPolyConfig)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPolyConfig)
+
+PolylineConfig = _reflection.GeneratedProtocolMessageType(
+    "PolylineConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POLYLINECONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for image polyline human labeling task.
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+      instruction_message:
+          Optional. Instruction message showed on contributors UI.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.PolylineConfig)
+    ),
+)
+_sym_db.RegisterMessage(PolylineConfig)
+
+SegmentationConfig = _reflection.GeneratedProtocolMessageType(
+    "SegmentationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEGMENTATIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for image segmentation
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name. format: projects/
+          {project\_id}/annotationSpecSets/{annotation\_spec\_set\_id}
+      instruction_message:
+          Instruction message showed on labelers UI.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SegmentationConfig)
+    ),
+)
+_sym_db.RegisterMessage(SegmentationConfig)
+
+VideoClassificationConfig = _reflection.GeneratedProtocolMessageType(
+    "VideoClassificationConfig",
+    (_message.Message,),
+    dict(
+        AnnotationSpecSetConfig=_reflection.GeneratedProtocolMessageType(
+            "AnnotationSpecSetConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_VIDEOCLASSIFICATIONCONFIG_ANNOTATIONSPECSETCONFIG,
+                __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+                __doc__="""Annotation spec set with the setting of allowing multi labels or not.
+    
+    
+    Attributes:
+        annotation_spec_set:
+            Required. Annotation spec set resource name.
+        allow_multi_label:
+            Optional. If allow\_multi\_label is true, contributors are
+            able to choose multiple labels from one annotation spec set.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoClassificationConfig.AnnotationSpecSetConfig)
+            ),
+        ),
+        DESCRIPTOR=_VIDEOCLASSIFICATIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for video classification human labeling task. Currently two types
+  of video classification are supported: 1. Assign labels on the entire
+  video. 2. Split the video into multiple video clips based on camera
+  shot, and assign labels on each video clip.
+  
+  
+  Attributes:
+      annotation_spec_set_configs:
+          Required. The list of annotation spec set configs. Since
+          watching a video clip takes much longer time than an image, we
+          support label with multiple AnnotationSpecSet at the same
+          time. Labels 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.
+      apply_shot_detection:
+          Optional. Option to apply shot detection on the video.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.VideoClassificationConfig)
+    ),
+)
+_sym_db.RegisterMessage(VideoClassificationConfig)
+_sym_db.RegisterMessage(VideoClassificationConfig.AnnotationSpecSetConfig)
+
+ObjectDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ObjectDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTDETECTIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for video object detection human labeling task. Object detection
+  will be conducted on the images extracted from the video, and those
+  objects will be labeled with bounding boxes. User need to specify the
+  number of images to be extracted per second as the extraction frame
+  rate.
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+      extraction_frame_rate:
+          Required. Number of frames per second to be extracted from the
+          video.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ObjectDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ObjectDetectionConfig)
+
+ObjectTrackingConfig = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for video object tracking human labeling task.
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ObjectTrackingConfig)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingConfig)
+
+EventConfig = _reflection.GeneratedProtocolMessageType(
+    "EventConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVENTCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for video event human labeling task.
+  
+  
+  Attributes:
+      annotation_spec_sets:
+          Required. The list of annotation spec set resource name.
+          Similar to video classification, we support selecting event
+          from multiple AnnotationSpecSet at the same time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.EventConfig)
+    ),
+)
+_sym_db.RegisterMessage(EventConfig)
+
+TextClassificationConfig = _reflection.GeneratedProtocolMessageType(
+    "TextClassificationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTCLASSIFICATIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for text classification human labeling task.
+  
+  
+  Attributes:
+      allow_multi_label:
+          Optional. If allow\_multi\_label is true, contributors are
+          able to choose multiple labels for one text segment.
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+      sentiment_config:
+          Optional. Configs for sentiment selection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TextClassificationConfig)
+    ),
+)
+_sym_db.RegisterMessage(TextClassificationConfig)
+
+SentimentConfig = _reflection.GeneratedProtocolMessageType(
+    "SentimentConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENTIMENTCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for setting up sentiments.
+  
+  
+  Attributes:
+      enable_label_sentiment_selection:
+          If set to true, contributors will have the option to select
+          sentiment of the label they selected, to mark it as negative
+          or positive label. Default is false.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.SentimentConfig)
+    ),
+)
+_sym_db.RegisterMessage(SentimentConfig)
+
+TextEntityExtractionConfig = _reflection.GeneratedProtocolMessageType(
+    "TextEntityExtractionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTENTITYEXTRACTIONCONFIG,
+        __module__="google.cloud.datalabeling_v1beta1.proto.human_annotation_config_pb2",
+        __doc__="""Config for text entity extraction human labeling task.
+  
+  
+  Attributes:
+      annotation_spec_set:
+          Required. Annotation spec set resource name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.TextEntityExtractionConfig)
+    ),
+)
+_sym_db.RegisterMessage(TextEntityExtractionConfig)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/human_annotation_config_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction.proto
new file mode 100644
index 000000000000..6cb7b50f3156
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction.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.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datalabeling/v1beta1/dataset.proto";
+import "google/protobuf/timestamp.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";
+
+// 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.
+message Instruction {
+  // Output only. Instruction resource name, format:
+  // projects/{project_id}/instructions/{instruction_id}
+  string name = 1;
+
+  // Required. The display name of the instruction. Maximum of 64 characters.
+  string display_name = 2;
+
+  // Optional. User-provided description of the instruction.
+  // The description can be up to 10000 characters long.
+  string description = 3;
+
+  // Output only. Creation time of instruction.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. Last update time of instruction.
+  google.protobuf.Timestamp update_time = 5;
+
+  // Required. The data type of this instruction.
+  DataType data_type = 6;
+
+  // One of CSV or PDF instruction is required.
+  // 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;
+
+  // 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;
+
+  // Output only. The names of any related resources that are blocking changes
+  // to the instruction.
+  repeated string blocking_resources = 10;
+}
+
+// Instruction from a CSV file.
+message CsvInstruction {
+  // CSV file for the instruction. Only gcs path is allowed.
+  string gcs_file_uri = 1;
+}
+
+// Instruction from a PDF file.
+message PdfInstruction {
+  // PDF file for the instruction. Only gcs path is allowed.
+  string gcs_file_uri = 1;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction_pb2.py
new file mode 100644
index 000000000000..7365416f6704
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction_pb2.py
@@ -0,0 +1,408 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/instruction.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/instruction.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/datalabeling_v1beta1/proto/instruction.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x35google/cloud/datalabeling_v1beta1/proto/dataset.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x9c\x03\n\x0bInstruction\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12>\n\tdata_type\x18\x06 \x01(\x0e\x32+.google.cloud.datalabeling.v1beta1.DataType\x12J\n\x0f\x63sv_instruction\x18\x07 \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.CsvInstruction\x12J\n\x0fpdf_instruction\x18\t \x01(\x0b\x32\x31.google.cloud.datalabeling.v1beta1.PdfInstruction\x12\x1a\n\x12\x62locking_resources\x18\n \x03(\t"&\n\x0e\x43svInstruction\x12\x14\n\x0cgcs_file_uri\x18\x01 \x01(\t"&\n\x0ePdfInstruction\x12\x14\n\x0cgcs_file_uri\x18\x01 \x01(\tBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_INSTRUCTION = _descriptor.Descriptor(
+    name="Instruction",
+    full_name="google.cloud.datalabeling.v1beta1.Instruction",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.update_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_type",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.data_type",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="csv_instruction",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.csv_instruction",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pdf_instruction",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.pdf_instruction",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocking_resources",
+            full_name="google.cloud.datalabeling.v1beta1.Instruction.blocking_resources",
+            index=8,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=215,
+    serialized_end=627,
+)
+
+
+_CSVINSTRUCTION = _descriptor.Descriptor(
+    name="CsvInstruction",
+    full_name="google.cloud.datalabeling.v1beta1.CsvInstruction",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_file_uri",
+            full_name="google.cloud.datalabeling.v1beta1.CsvInstruction.gcs_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=629,
+    serialized_end=667,
+)
+
+
+_PDFINSTRUCTION = _descriptor.Descriptor(
+    name="PdfInstruction",
+    full_name="google.cloud.datalabeling.v1beta1.PdfInstruction",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_file_uri",
+            full_name="google.cloud.datalabeling.v1beta1.PdfInstruction.gcs_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=669,
+    serialized_end=707,
+)
+
+_INSTRUCTION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INSTRUCTION.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INSTRUCTION.fields_by_name[
+    "data_type"
+].enum_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._DATATYPE
+)
+_INSTRUCTION.fields_by_name["csv_instruction"].message_type = _CSVINSTRUCTION
+_INSTRUCTION.fields_by_name["pdf_instruction"].message_type = _PDFINSTRUCTION
+DESCRIPTOR.message_types_by_name["Instruction"] = _INSTRUCTION
+DESCRIPTOR.message_types_by_name["CsvInstruction"] = _CSVINSTRUCTION
+DESCRIPTOR.message_types_by_name["PdfInstruction"] = _PDFINSTRUCTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Instruction = _reflection.GeneratedProtocolMessageType(
+    "Instruction",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTRUCTION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.instruction_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          Output only. Instruction resource name, format:
+          projects/{project\_id}/instructions/{instruction\_id}
+      display_name:
+          Required. The display name of the instruction. Maximum of 64
+          characters.
+      description:
+          Optional. User-provided description of the instruction. The
+          description can be up to 10000 characters long.
+      create_time:
+          Output only. Creation time of instruction.
+      update_time:
+          Output only. Last update time of instruction.
+      data_type:
+          Required. The data type of this instruction.
+      csv_instruction:
+          One of CSV or PDF instruction is required. 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.
+      pdf_instruction:
+          One of CSV or PDF instruction is required. Instruction from a
+          PDF document. The PDF should be in a Cloud Storage bucket.
+      blocking_resources:
+          Output only. The names of any related resources that are
+          blocking changes to the instruction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.Instruction)
+    ),
+)
+_sym_db.RegisterMessage(Instruction)
+
+CsvInstruction = _reflection.GeneratedProtocolMessageType(
+    "CsvInstruction",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CSVINSTRUCTION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.instruction_pb2",
+        __doc__="""Instruction from a CSV file.
+  
+  
+  Attributes:
+      gcs_file_uri:
+          CSV file for the instruction. Only gcs path is allowed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.CsvInstruction)
+    ),
+)
+_sym_db.RegisterMessage(CsvInstruction)
+
+PdfInstruction = _reflection.GeneratedProtocolMessageType(
+    "PdfInstruction",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PDFINSTRUCTION,
+        __module__="google.cloud.datalabeling_v1beta1.proto.instruction_pb2",
+        __doc__="""Instruction from a PDF file.
+  
+  
+  Attributes:
+      gcs_file_uri:
+          PDF file for the instruction. Only gcs path is allowed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.PdfInstruction)
+    ),
+)
+_sym_db.RegisterMessage(PdfInstruction)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/instruction_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations.proto b/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations.proto
new file mode 100644
index 000000000000..80371d0e2322
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations.proto
@@ -0,0 +1,233 @@
+// 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.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datalabeling/v1beta1/dataset.proto";
+import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.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";
+
+// Response used for ImportData longrunning operation.
+message ImportDataOperationResponse {
+  // Ouptut only. The name of imported dataset.
+  string dataset = 1;
+
+  // Output only. Total number of examples requested to import
+  int32 total_count = 2;
+
+  // Output only. Number of examples imported successfully.
+  int32 import_count = 3;
+}
+
+// Response used for ExportDataset longrunning operation.
+message ExportDataOperationResponse {
+  // Ouptut only. The name of dataset.
+  // "projects/*/datasets/*/Datasets/*"
+  string dataset = 1;
+
+  // Output only. Total number of examples requested to export
+  int32 total_count = 2;
+
+  // Output only. Number of examples exported successfully.
+  int32 export_count = 3;
+
+  // Output only. Statistic infos of labels in the exported dataset.
+  LabelStats label_stats = 4;
+
+  // Output only. output_config in the ExportData request.
+  OutputConfig output_config = 5;
+}
+
+// Metadata of an ImportData operation.
+message ImportDataOperationMetadata {
+  // Ouptut only. The name of imported dataset.
+  // "projects/*/datasets/*"
+  string dataset = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+
+  // Output only. Timestamp when import dataset request was created.
+  google.protobuf.Timestamp create_time = 3;
+}
+
+// Metadata of an ExportData operation.
+message ExportDataOperationMetadata {
+  // Output only. The name of dataset to be exported.
+  // "projects/*/datasets/*/Datasets/*"
+  string dataset = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+
+  // Output only. Timestamp when export dataset request was created.
+  google.protobuf.Timestamp create_time = 3;
+}
+
+// Metadata of a labeling operation, such as LabelImage or LabelVideo.
+// Next tag: 18
+message LabelOperationMetadata {
+  // Ouptut only. Details of specific label operation.
+  oneof details {
+    // Details of label image classification operation.
+    LabelImageClassificationOperationMetadata image_classification_details = 3;
+
+    // Details of label image bounding box operation.
+    LabelImageBoundingBoxOperationMetadata image_bounding_box_details = 4;
+
+    // Details of label image bounding poly operation.
+    LabelImageBoundingPolyOperationMetadata image_bounding_poly_details = 11;
+
+    // Details of label image oriented bounding box operation.
+    LabelImageOrientedBoundingBoxOperationMetadata
+        image_oriented_bounding_box_details = 14;
+
+    // Details of label image polyline operation.
+    LabelImagePolylineOperationMetadata image_polyline_details = 12;
+
+    // Details of label image segmentation operation.
+    LabelImageSegmentationOperationMetadata image_segmentation_details = 15;
+
+    // Details of label video classification operation.
+    LabelVideoClassificationOperationMetadata video_classification_details = 5;
+
+    // Details of label video object detection operation.
+    LabelVideoObjectDetectionOperationMetadata video_object_detection_details =
+        6;
+
+    // Details of label video object tracking operation.
+    LabelVideoObjectTrackingOperationMetadata video_object_tracking_details = 7;
+
+    // Details of label video event operation.
+    LabelVideoEventOperationMetadata video_event_details = 8;
+
+    // Details of label text classification operation.
+    LabelTextClassificationOperationMetadata text_classification_details = 9;
+
+    // Details of label text entity extraction operation.
+    LabelTextEntityExtractionOperationMetadata text_entity_extraction_details =
+        13;
+  }
+
+  // Output only. Progress of label operation. Range: [0, 100].
+  int32 progress_percent = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+
+  // Output only. Timestamp when labeling request was created.
+  google.protobuf.Timestamp create_time = 16;
+}
+
+// Metadata of a LabelImageClassification operation.
+message LabelImageClassificationOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelImageBoundingBox operation metadata.
+message LabelImageBoundingBoxOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelImageOrientedBoundingBox operation metadata.
+message LabelImageOrientedBoundingBoxOperationMetadata {
+  // Basic human annotation config.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of LabelImageBoundingPoly operation metadata.
+message LabelImageBoundingPolyOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of LabelImagePolyline operation metadata.
+message LabelImagePolylineOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelImageSegmentation operation metadata.
+message LabelImageSegmentationOperationMetadata {
+  // Basic human annotation config.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoClassification operation metadata.
+message LabelVideoClassificationOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoObjectDetection operation metadata.
+message LabelVideoObjectDetectionOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoObjectTracking operation metadata.
+message LabelVideoObjectTrackingOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoEvent operation metadata.
+message LabelVideoEventOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelTextClassification operation metadata.
+message LabelTextClassificationOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelTextEntityExtraction operation metadata.
+message LabelTextEntityExtractionOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Metadata of a CreateInstruction operation.
+message CreateInstructionMetadata {
+  // The name of the created Instruction.
+  // projects/{project_id}/instructions/{instruction_id}
+  string instruction = 1;
+
+  // Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+
+  // Timestamp when create instruction request was created.
+  google.protobuf.Timestamp create_time = 3;
+}
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations_pb2.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations_pb2.py
new file mode 100644
index 000000000000..78c02a3477c0
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations_pb2.py
@@ -0,0 +1,1878 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datalabeling_v1beta1/proto/operations.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    dataset_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2,
+)
+from google.cloud.datalabeling_v1beta1.proto import (
+    human_annotation_config_pb2 as google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datalabeling_v1beta1/proto/operations.proto",
+    package="google.cloud.datalabeling.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.datalabeling.v1beta1P\001ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/datalabeling_v1beta1/proto/operations.proto\x12!google.cloud.datalabeling.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x35google/cloud/datalabeling_v1beta1/proto/dataset.proto\x1a\x45google/cloud/datalabeling_v1beta1/proto/human_annotation_config.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"Y\n\x1bImportDataOperationResponse\x12\x0f\n\x07\x64\x61taset\x18\x01 \x01(\t\x12\x13\n\x0btotal_count\x18\x02 \x01(\x05\x12\x14\n\x0cimport_count\x18\x03 \x01(\x05"\xe5\x01\n\x1b\x45xportDataOperationResponse\x12\x0f\n\x07\x64\x61taset\x18\x01 \x01(\t\x12\x13\n\x0btotal_count\x18\x02 \x01(\x05\x12\x14\n\x0c\x65xport_count\x18\x03 \x01(\x05\x12\x42\n\x0blabel_stats\x18\x04 \x01(\x0b\x32-.google.cloud.datalabeling.v1beta1.LabelStats\x12\x46\n\routput_config\x18\x05 \x01(\x0b\x32/.google.cloud.datalabeling.v1beta1.OutputConfig"\x8d\x01\n\x1bImportDataOperationMetadata\x12\x0f\n\x07\x64\x61taset\x18\x01 \x01(\t\x12,\n\x10partial_failures\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8d\x01\n\x1b\x45xportDataOperationMetadata\x12\x0f\n\x07\x64\x61taset\x18\x01 \x01(\t\x12,\n\x10partial_failures\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8c\x0c\n\x16LabelOperationMetadata\x12t\n\x1cimage_classification_details\x18\x03 \x01(\x0b\x32L.google.cloud.datalabeling.v1beta1.LabelImageClassificationOperationMetadataH\x00\x12o\n\x1aimage_bounding_box_details\x18\x04 \x01(\x0b\x32I.google.cloud.datalabeling.v1beta1.LabelImageBoundingBoxOperationMetadataH\x00\x12q\n\x1bimage_bounding_poly_details\x18\x0b \x01(\x0b\x32J.google.cloud.datalabeling.v1beta1.LabelImageBoundingPolyOperationMetadataH\x00\x12\x80\x01\n#image_oriented_bounding_box_details\x18\x0e \x01(\x0b\x32Q.google.cloud.datalabeling.v1beta1.LabelImageOrientedBoundingBoxOperationMetadataH\x00\x12h\n\x16image_polyline_details\x18\x0c \x01(\x0b\x32\x46.google.cloud.datalabeling.v1beta1.LabelImagePolylineOperationMetadataH\x00\x12p\n\x1aimage_segmentation_details\x18\x0f \x01(\x0b\x32J.google.cloud.datalabeling.v1beta1.LabelImageSegmentationOperationMetadataH\x00\x12t\n\x1cvideo_classification_details\x18\x05 \x01(\x0b\x32L.google.cloud.datalabeling.v1beta1.LabelVideoClassificationOperationMetadataH\x00\x12w\n\x1evideo_object_detection_details\x18\x06 \x01(\x0b\x32M.google.cloud.datalabeling.v1beta1.LabelVideoObjectDetectionOperationMetadataH\x00\x12u\n\x1dvideo_object_tracking_details\x18\x07 \x01(\x0b\x32L.google.cloud.datalabeling.v1beta1.LabelVideoObjectTrackingOperationMetadataH\x00\x12\x62\n\x13video_event_details\x18\x08 \x01(\x0b\x32\x43.google.cloud.datalabeling.v1beta1.LabelVideoEventOperationMetadataH\x00\x12r\n\x1btext_classification_details\x18\t \x01(\x0b\x32K.google.cloud.datalabeling.v1beta1.LabelTextClassificationOperationMetadataH\x00\x12w\n\x1etext_entity_extraction_details\x18\r \x01(\x0b\x32M.google.cloud.datalabeling.v1beta1.LabelTextEntityExtractionOperationMetadataH\x00\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12,\n\x10partial_failures\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status\x12/\n\x0b\x63reate_time\x18\x10 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\t\n\x07\x64\x65tails"{\n)LabelImageClassificationOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"x\n&LabelImageBoundingBoxOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"\x80\x01\n.LabelImageOrientedBoundingBoxOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"y\n\'LabelImageBoundingPolyOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"u\n#LabelImagePolylineOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"y\n\'LabelImageSegmentationOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"{\n)LabelVideoClassificationOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"|\n*LabelVideoObjectDetectionOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"{\n)LabelVideoObjectTrackingOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"r\n LabelVideoEventOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"z\n(LabelTextClassificationOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"|\n*LabelTextEntityExtractionOperationMetadata\x12N\n\x0c\x62\x61sic_config\x18\x01 \x01(\x0b\x32\x38.google.cloud.datalabeling.v1beta1.HumanAnnotationConfig"\x8f\x01\n\x19\x43reateInstructionMetadata\x12\x13\n\x0binstruction\x18\x01 \x01(\t\x12,\n\x10partial_failures\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampBx\n%com.google.cloud.datalabeling.v1beta1P\x01ZMgoogle.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabelingb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_IMPORTDATAOPERATIONRESPONSE = _descriptor.Descriptor(
+    name="ImportDataOperationResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationResponse.dataset",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_count",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationResponse.total_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_count",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationResponse.import_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=309,
+    serialized_end=398,
+)
+
+
+_EXPORTDATAOPERATIONRESPONSE = _descriptor.Descriptor(
+    name="ExportDataOperationResponse",
+    full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationResponse.dataset",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_count",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationResponse.total_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="export_count",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationResponse.export_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_stats",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationResponse.label_stats",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationResponse.output_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=401,
+    serialized_end=630,
+)
+
+
+_IMPORTDATAOPERATIONMETADATA = _descriptor.Descriptor(
+    name="ImportDataOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata.dataset",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_failures",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata.partial_failures",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=633,
+    serialized_end=774,
+)
+
+
+_EXPORTDATAOPERATIONMETADATA = _descriptor.Descriptor(
+    name="ExportDataOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dataset",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata.dataset",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_failures",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata.partial_failures",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=777,
+    serialized_end=918,
+)
+
+
+_LABELOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_classification_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.image_classification_details",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_bounding_box_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.image_bounding_box_details",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_bounding_poly_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.image_bounding_poly_details",
+            index=2,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_oriented_bounding_box_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.image_oriented_bounding_box_details",
+            index=3,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_polyline_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.image_polyline_details",
+            index=4,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_segmentation_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.image_segmentation_details",
+            index=5,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_classification_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.video_classification_details",
+            index=6,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_detection_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.video_object_detection_details",
+            index=7,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_object_tracking_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.video_object_tracking_details",
+            index=8,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_event_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.video_event_details",
+            index=9,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_classification_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.text_classification_details",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_entity_extraction_details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.text_entity_extraction_details",
+            index=11,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.progress_percent",
+            index=12,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_failures",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.partial_failures",
+            index=13,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.create_time",
+            index=14,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="details",
+            full_name="google.cloud.datalabeling.v1beta1.LabelOperationMetadata.details",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=921,
+    serialized_end=2469,
+)
+
+
+_LABELIMAGECLASSIFICATIONOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelImageClassificationOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageClassificationOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageClassificationOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2471,
+    serialized_end=2594,
+)
+
+
+_LABELIMAGEBOUNDINGBOXOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelImageBoundingBoxOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageBoundingBoxOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageBoundingBoxOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2596,
+    serialized_end=2716,
+)
+
+
+_LABELIMAGEORIENTEDBOUNDINGBOXOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelImageOrientedBoundingBoxOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageOrientedBoundingBoxOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageOrientedBoundingBoxOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2719,
+    serialized_end=2847,
+)
+
+
+_LABELIMAGEBOUNDINGPOLYOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelImageBoundingPolyOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageBoundingPolyOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageBoundingPolyOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2849,
+    serialized_end=2970,
+)
+
+
+_LABELIMAGEPOLYLINEOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelImagePolylineOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImagePolylineOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImagePolylineOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2972,
+    serialized_end=3089,
+)
+
+
+_LABELIMAGESEGMENTATIONOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelImageSegmentationOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelImageSegmentationOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelImageSegmentationOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3091,
+    serialized_end=3212,
+)
+
+
+_LABELVIDEOCLASSIFICATIONOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelVideoClassificationOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelVideoClassificationOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoClassificationOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3214,
+    serialized_end=3337,
+)
+
+
+_LABELVIDEOOBJECTDETECTIONOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelVideoObjectDetectionOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelVideoObjectDetectionOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoObjectDetectionOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3339,
+    serialized_end=3463,
+)
+
+
+_LABELVIDEOOBJECTTRACKINGOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelVideoObjectTrackingOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelVideoObjectTrackingOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoObjectTrackingOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3465,
+    serialized_end=3588,
+)
+
+
+_LABELVIDEOEVENTOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelVideoEventOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelVideoEventOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelVideoEventOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3590,
+    serialized_end=3704,
+)
+
+
+_LABELTEXTCLASSIFICATIONOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelTextClassificationOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelTextClassificationOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextClassificationOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3706,
+    serialized_end=3828,
+)
+
+
+_LABELTEXTENTITYEXTRACTIONOPERATIONMETADATA = _descriptor.Descriptor(
+    name="LabelTextEntityExtractionOperationMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.LabelTextEntityExtractionOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="basic_config",
+            full_name="google.cloud.datalabeling.v1beta1.LabelTextEntityExtractionOperationMetadata.basic_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3830,
+    serialized_end=3954,
+)
+
+
+_CREATEINSTRUCTIONMETADATA = _descriptor.Descriptor(
+    name="CreateInstructionMetadata",
+    full_name="google.cloud.datalabeling.v1beta1.CreateInstructionMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instruction",
+            full_name="google.cloud.datalabeling.v1beta1.CreateInstructionMetadata.instruction",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_failures",
+            full_name="google.cloud.datalabeling.v1beta1.CreateInstructionMetadata.partial_failures",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.datalabeling.v1beta1.CreateInstructionMetadata.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3957,
+    serialized_end=4100,
+)
+
+_EXPORTDATAOPERATIONRESPONSE.fields_by_name[
+    "label_stats"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._LABELSTATS
+)
+_EXPORTDATAOPERATIONRESPONSE.fields_by_name[
+    "output_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_dataset__pb2._OUTPUTCONFIG
+)
+_IMPORTDATAOPERATIONMETADATA.fields_by_name[
+    "partial_failures"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_IMPORTDATAOPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTDATAOPERATIONMETADATA.fields_by_name[
+    "partial_failures"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_EXPORTDATAOPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_classification_details"
+].message_type = _LABELIMAGECLASSIFICATIONOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_bounding_box_details"
+].message_type = _LABELIMAGEBOUNDINGBOXOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_bounding_poly_details"
+].message_type = _LABELIMAGEBOUNDINGPOLYOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_oriented_bounding_box_details"
+].message_type = _LABELIMAGEORIENTEDBOUNDINGBOXOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_polyline_details"
+].message_type = _LABELIMAGEPOLYLINEOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_segmentation_details"
+].message_type = _LABELIMAGESEGMENTATIONOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_classification_details"
+].message_type = _LABELVIDEOCLASSIFICATIONOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_object_detection_details"
+].message_type = _LABELVIDEOOBJECTDETECTIONOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_object_tracking_details"
+].message_type = _LABELVIDEOOBJECTTRACKINGOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_event_details"
+].message_type = _LABELVIDEOEVENTOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "text_classification_details"
+].message_type = _LABELTEXTCLASSIFICATIONOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "text_entity_extraction_details"
+].message_type = _LABELTEXTENTITYEXTRACTIONOPERATIONMETADATA
+_LABELOPERATIONMETADATA.fields_by_name[
+    "partial_failures"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_LABELOPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["image_classification_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_classification_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["image_bounding_box_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_bounding_box_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["image_bounding_poly_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_bounding_poly_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["image_oriented_bounding_box_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_oriented_bounding_box_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["image_polyline_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_polyline_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["image_segmentation_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "image_segmentation_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["video_classification_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_classification_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["video_object_detection_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_object_detection_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["video_object_tracking_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_object_tracking_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["video_event_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "video_event_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["text_classification_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "text_classification_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELOPERATIONMETADATA.oneofs_by_name["details"].fields.append(
+    _LABELOPERATIONMETADATA.fields_by_name["text_entity_extraction_details"]
+)
+_LABELOPERATIONMETADATA.fields_by_name[
+    "text_entity_extraction_details"
+].containing_oneof = _LABELOPERATIONMETADATA.oneofs_by_name["details"]
+_LABELIMAGECLASSIFICATIONOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELIMAGEBOUNDINGBOXOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELIMAGEORIENTEDBOUNDINGBOXOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELIMAGEBOUNDINGPOLYOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELIMAGEPOLYLINEOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELIMAGESEGMENTATIONOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELVIDEOCLASSIFICATIONOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELVIDEOOBJECTDETECTIONOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELVIDEOOBJECTTRACKINGOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELVIDEOEVENTOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELTEXTCLASSIFICATIONOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_LABELTEXTENTITYEXTRACTIONOPERATIONMETADATA.fields_by_name[
+    "basic_config"
+].message_type = (
+    google_dot_cloud_dot_datalabeling__v1beta1_dot_proto_dot_human__annotation__config__pb2._HUMANANNOTATIONCONFIG
+)
+_CREATEINSTRUCTIONMETADATA.fields_by_name[
+    "partial_failures"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_CREATEINSTRUCTIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name[
+    "ImportDataOperationResponse"
+] = _IMPORTDATAOPERATIONRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ExportDataOperationResponse"
+] = _EXPORTDATAOPERATIONRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ImportDataOperationMetadata"
+] = _IMPORTDATAOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "ExportDataOperationMetadata"
+] = _EXPORTDATAOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["LabelOperationMetadata"] = _LABELOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelImageClassificationOperationMetadata"
+] = _LABELIMAGECLASSIFICATIONOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelImageBoundingBoxOperationMetadata"
+] = _LABELIMAGEBOUNDINGBOXOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelImageOrientedBoundingBoxOperationMetadata"
+] = _LABELIMAGEORIENTEDBOUNDINGBOXOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelImageBoundingPolyOperationMetadata"
+] = _LABELIMAGEBOUNDINGPOLYOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelImagePolylineOperationMetadata"
+] = _LABELIMAGEPOLYLINEOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelImageSegmentationOperationMetadata"
+] = _LABELIMAGESEGMENTATIONOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelVideoClassificationOperationMetadata"
+] = _LABELVIDEOCLASSIFICATIONOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelVideoObjectDetectionOperationMetadata"
+] = _LABELVIDEOOBJECTDETECTIONOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelVideoObjectTrackingOperationMetadata"
+] = _LABELVIDEOOBJECTTRACKINGOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelVideoEventOperationMetadata"
+] = _LABELVIDEOEVENTOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelTextClassificationOperationMetadata"
+] = _LABELTEXTCLASSIFICATIONOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "LabelTextEntityExtractionOperationMetadata"
+] = _LABELTEXTENTITYEXTRACTIONOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name[
+    "CreateInstructionMetadata"
+] = _CREATEINSTRUCTIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ImportDataOperationResponse = _reflection.GeneratedProtocolMessageType(
+    "ImportDataOperationResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDATAOPERATIONRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Response used for ImportData longrunning operation.
+  
+  
+  Attributes:
+      dataset:
+          Ouptut only. The name of imported dataset.
+      total_count:
+          Output only. Total number of examples requested to import
+      import_count:
+          Output only. Number of examples imported successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImportDataOperationResponse)
+    ),
+)
+_sym_db.RegisterMessage(ImportDataOperationResponse)
+
+ExportDataOperationResponse = _reflection.GeneratedProtocolMessageType(
+    "ExportDataOperationResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDATAOPERATIONRESPONSE,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Response used for ExportDataset longrunning operation.
+  
+  
+  Attributes:
+      dataset:
+          Ouptut only. The name of dataset.
+          "projects/*/datasets/*/Datasets/\*"
+      total_count:
+          Output only. Total number of examples requested to export
+      export_count:
+          Output only. Number of examples exported successfully.
+      label_stats:
+          Output only. Statistic infos of labels in the exported
+          dataset.
+      output_config:
+          Output only. output\_config in the ExportData request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ExportDataOperationResponse)
+    ),
+)
+_sym_db.RegisterMessage(ExportDataOperationResponse)
+
+ImportDataOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImportDataOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDATAOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Metadata of an ImportData operation.
+  
+  
+  Attributes:
+      dataset:
+          Ouptut only. The name of imported dataset.
+          "projects/*/datasets/*"
+      partial_failures:
+          Output only. Partial failures encountered. E.g. single files
+          that couldn't be read. Status details field will contain
+          standard GCP error details.
+      create_time:
+          Output only. Timestamp when import dataset request was
+          created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImportDataOperationMetadata)
+
+ExportDataOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ExportDataOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDATAOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Metadata of an ExportData operation.
+  
+  
+  Attributes:
+      dataset:
+          Output only. The name of dataset to be exported.
+          "projects/*/datasets/*/Datasets/\*"
+      partial_failures:
+          Output only. Partial failures encountered. E.g. single files
+          that couldn't be read. Status details field will contain
+          standard GCP error details.
+      create_time:
+          Output only. Timestamp when export dataset request was
+          created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ExportDataOperationMetadata)
+
+LabelOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Metadata of a labeling operation, such as LabelImage or LabelVideo. Next
+  tag: 18
+  
+  
+  Attributes:
+      details:
+          Ouptut only. Details of specific label operation.
+      image_classification_details:
+          Details of label image classification operation.
+      image_bounding_box_details:
+          Details of label image bounding box operation.
+      image_bounding_poly_details:
+          Details of label image bounding poly operation.
+      image_oriented_bounding_box_details:
+          Details of label image oriented bounding box operation.
+      image_polyline_details:
+          Details of label image polyline operation.
+      image_segmentation_details:
+          Details of label image segmentation operation.
+      video_classification_details:
+          Details of label video classification operation.
+      video_object_detection_details:
+          Details of label video object detection operation.
+      video_object_tracking_details:
+          Details of label video object tracking operation.
+      video_event_details:
+          Details of label video event operation.
+      text_classification_details:
+          Details of label text classification operation.
+      text_entity_extraction_details:
+          Details of label text entity extraction operation.
+      progress_percent:
+          Output only. Progress of label operation. Range: [0, 100].
+      partial_failures:
+          Output only. Partial failures encountered. E.g. single files
+          that couldn't be read. Status details field will contain
+          standard GCP error details.
+      create_time:
+          Output only. Timestamp when labeling request was created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelOperationMetadata)
+
+LabelImageClassificationOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelImageClassificationOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGECLASSIFICATIONOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Metadata of a LabelImageClassification operation.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImageClassificationOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelImageClassificationOperationMetadata)
+
+LabelImageBoundingBoxOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelImageBoundingBoxOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGEBOUNDINGBOXOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelImageBoundingBox operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImageBoundingBoxOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelImageBoundingBoxOperationMetadata)
+
+LabelImageOrientedBoundingBoxOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelImageOrientedBoundingBoxOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGEORIENTEDBOUNDINGBOXOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelImageOrientedBoundingBox operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImageOrientedBoundingBoxOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelImageOrientedBoundingBoxOperationMetadata)
+
+LabelImageBoundingPolyOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelImageBoundingPolyOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGEBOUNDINGPOLYOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of LabelImageBoundingPoly operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImageBoundingPolyOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelImageBoundingPolyOperationMetadata)
+
+LabelImagePolylineOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelImagePolylineOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGEPOLYLINEOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of LabelImagePolyline operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImagePolylineOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelImagePolylineOperationMetadata)
+
+LabelImageSegmentationOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelImageSegmentationOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELIMAGESEGMENTATIONOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelImageSegmentation operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelImageSegmentationOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelImageSegmentationOperationMetadata)
+
+LabelVideoClassificationOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelVideoClassificationOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELVIDEOCLASSIFICATIONOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelVideoClassification operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelVideoClassificationOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelVideoClassificationOperationMetadata)
+
+LabelVideoObjectDetectionOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelVideoObjectDetectionOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELVIDEOOBJECTDETECTIONOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelVideoObjectDetection operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelVideoObjectDetectionOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelVideoObjectDetectionOperationMetadata)
+
+LabelVideoObjectTrackingOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelVideoObjectTrackingOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELVIDEOOBJECTTRACKINGOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelVideoObjectTracking operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelVideoObjectTrackingOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelVideoObjectTrackingOperationMetadata)
+
+LabelVideoEventOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelVideoEventOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELVIDEOEVENTOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelVideoEvent operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelVideoEventOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelVideoEventOperationMetadata)
+
+LabelTextClassificationOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelTextClassificationOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELTEXTCLASSIFICATIONOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelTextClassification operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelTextClassificationOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelTextClassificationOperationMetadata)
+
+LabelTextEntityExtractionOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LabelTextEntityExtractionOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELTEXTENTITYEXTRACTIONOPERATIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Details of a LabelTextEntityExtraction operation metadata.
+  
+  
+  Attributes:
+      basic_config:
+          Basic human annotation config used in labeling request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.LabelTextEntityExtractionOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LabelTextEntityExtractionOperationMetadata)
+
+CreateInstructionMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateInstructionMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTRUCTIONMETADATA,
+        __module__="google.cloud.datalabeling_v1beta1.proto.operations_pb2",
+        __doc__="""Metadata of a CreateInstruction operation.
+  
+  
+  Attributes:
+      instruction:
+          The name of the created Instruction.
+          projects/{project\_id}/instructions/{instruction\_id}
+      partial_failures:
+          Partial failures encountered. E.g. single files that couldn't
+          be read. Status details field will contain standard GCP error
+          details.
+      create_time:
+          Timestamp when create instruction request was created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.datalabeling.v1beta1.CreateInstructionMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstructionMetadata)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations_pb2_grpc.py b/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/proto/operations_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datalabeling/google/cloud/datalabeling_v1beta1/types.py b/datalabeling/google/cloud/datalabeling_v1beta1/types.py
new file mode 100644
index 000000000000..45aef871a7c1
--- /dev/null
+++ b/datalabeling/google/cloud/datalabeling_v1beta1/types.py
@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.datalabeling_v1beta1.proto import annotation_pb2
+from google.cloud.datalabeling_v1beta1.proto import annotation_spec_set_pb2
+from google.cloud.datalabeling_v1beta1.proto import data_labeling_service_pb2
+from google.cloud.datalabeling_v1beta1.proto import data_payloads_pb2
+from google.cloud.datalabeling_v1beta1.proto import dataset_pb2
+from google.cloud.datalabeling_v1beta1.proto import evaluation_job_pb2
+from google.cloud.datalabeling_v1beta1.proto import evaluation_pb2
+from google.cloud.datalabeling_v1beta1.proto import human_annotation_config_pb2
+from google.cloud.datalabeling_v1beta1.proto import instruction_pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    operations_pb2 as proto_operations_pb2,
+)
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    longrunning_operations_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [
+    annotation_pb2,
+    annotation_spec_set_pb2,
+    data_labeling_service_pb2,
+    data_payloads_pb2,
+    dataset_pb2,
+    evaluation_job_pb2,
+    evaluation_pb2,
+    human_annotation_config_pb2,
+    instruction_pb2,
+    proto_operations_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.datalabeling_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/datalabeling/noxfile.py b/datalabeling/noxfile.py
new file mode 100644
index 000000000000..3d92df19084f
--- /dev/null
+++ b/datalabeling/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=80")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/datalabeling/protos/annotation.proto b/datalabeling/protos/annotation.proto
new file mode 100644
index 000000000000..d2f77344bbbc
--- /dev/null
+++ b/datalabeling/protos/annotation.proto
@@ -0,0 +1,294 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto";
+import "google/protobuf/duration.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/datalabeling/v1beta1;datalabeling";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datalabeling.v1beta1";
+
+
+// Specifies where is the answer from.
+enum AnnotationSource {
+  ANNOTATION_SOURCE_UNSPECIFIED = 0;
+
+  // Answer is provided by a human contributor.
+  OPERATOR = 3;
+}
+
+enum AnnotationSentiment {
+  ANNOTATION_SENTIMENT_UNSPECIFIED = 0;
+
+  // This annotation describes negatively about the data.
+  NEGATIVE = 1;
+
+  // This label describes positively about the data.
+  POSITIVE = 2;
+}
+
+enum AnnotationType {
+  ANNOTATION_TYPE_UNSPECIFIED = 0;
+
+  // Classification annotations in an image.
+  IMAGE_CLASSIFICATION_ANNOTATION = 1;
+
+  // Bounding box annotations in an image.
+  IMAGE_BOUNDING_BOX_ANNOTATION = 2;
+
+  // Bounding poly annotations in an image.
+  IMAGE_BOUNDING_POLY_ANNOTATION = 10;
+
+  // Polyline annotations in an image.
+  IMAGE_POLYLINE_ANNOTATION = 11;
+
+  // Classification annotations in video shots.
+  VIDEO_SHOTS_CLASSIFICATION_ANNOTATION = 3;
+
+  // Video object tracking annotation.
+  VIDEO_OBJECT_TRACKING_ANNOTATION = 4;
+
+  // Video object detection annotation.
+  VIDEO_OBJECT_DETECTION_ANNOTATION = 5;
+
+  // Video event annotation.
+  VIDEO_EVENT_ANNOTATION = 6;
+
+  // Classification for text.
+  TEXT_CLASSIFICATION_ANNOTATION = 8;
+
+  // Entity extraction for text.
+  TEXT_ENTITY_EXTRACTION_ANNOTATION = 9;
+}
+
+// Annotation for Example. Each example may have one or more annotations. For
+// example in image classification problem, each image might have one or more
+// labels. We call labels binded with this image an Annotation.
+message Annotation {
+  // Output only. Unique name of this annotation, format is:
+  //
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/{annotated_dataset}/examples/{example_id}/annotations/{annotation_id}
+  string name = 1;
+
+  // Output only. The source of the annotation.
+  AnnotationSource annotation_source = 2;
+
+  // Output only. This is the actual annotation value, e.g classification,
+  // bounding box values are stored here.
+  AnnotationValue annotation_value = 3;
+
+  // Output only. Annotation metadata, including information like votes
+  // for labels.
+  AnnotationMetadata annotation_metadata = 4;
+
+  // Output only. Sentiment for this annotation.
+  AnnotationSentiment annotation_sentiment = 6;
+}
+
+// Annotation value for an example.
+message AnnotationValue {
+  oneof value_type {
+    // Annotation value for image classification case.
+    ImageClassificationAnnotation image_classification_annotation = 1;
+
+    // Annotation value for image bounding box and polygon cases.
+    ImageBoundingPolyAnnotation image_bounding_poly_annotation = 2;
+
+    // Annotation value for image polyline cases.
+    // Polyline here is different from BoundingPoly. It is formed by
+    // line segments connected to each other but not closed form(Bounding Poly).
+    // The line segments can cross each other.
+    ImagePolylineAnnotation image_polyline_annotation = 8;
+
+    // Annotation value for text classification case.
+    TextClassificationAnnotation text_classification_annotation = 3;
+
+    // Annotation value for video classification case.
+    VideoClassificationAnnotation video_classification_annotation = 4;
+
+    // Annotation value for video object detection and tracking case.
+    VideoObjectTrackingAnnotation video_object_tracking_annotation = 5;
+
+    // Annotation value for video event case.
+    VideoEventAnnotation video_event_annotation = 6;
+  }
+}
+
+// Image classification annotation definition.
+message ImageClassificationAnnotation {
+  // Label of image.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// 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 in the image.
+message BoundingPoly {
+  // The bounding polygon vertices.
+  repeated Vertex vertices = 1;
+}
+
+// Normalized bounding polygon.
+message NormalizedBoundingPoly {
+  // The bounding polygon normalized vertices.
+  repeated NormalizedVertex normalized_vertices = 1;
+}
+
+// Image bounding poly annotation. It represents a polygon including
+// bounding box in the image.
+message ImageBoundingPolyAnnotation {
+  // The region of the polygon. If it is a bounding box, it is guaranteed to be
+  // four points.
+  oneof bounded_area {
+    BoundingPoly bounding_poly = 2;
+
+    NormalizedBoundingPoly normalized_bounding_poly = 3;
+  }
+
+  // Label of object in this bounding polygon.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// A line with multiple line segments.
+message Polyline {
+  // The polyline vertices.
+  repeated Vertex vertices = 1;
+}
+
+// Normalized polyline.
+message NormalizedPolyline {
+  // The normalized polyline vertices.
+  repeated NormalizedVertex normalized_vertices = 1;
+}
+
+// A polyline for the image annotation.
+message ImagePolylineAnnotation {
+  oneof poly {
+    Polyline polyline = 2;
+
+    NormalizedPolyline normalized_polyline = 3;
+  }
+
+  // Label of this polyline.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// Text classification annotation.
+message TextClassificationAnnotation {
+  // Label of the text.
+  AnnotationSpec annotation_spec = 1;
+}
+
+// A time period inside of an example that has a time dimension (e.g. video).
+message TimeSegment {
+  // Start of the time segment (inclusive), represented as the duration since
+  // the example start.
+  google.protobuf.Duration start_time_offset = 1;
+
+  // End of the time segment (exclusive), represented as the duration since the
+  // example start.
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video classification annotation.
+message VideoClassificationAnnotation {
+  // The time segment of the video to which the annotation applies.
+  TimeSegment time_segment = 1;
+
+  // Label of the segment specified by time_segment.
+  AnnotationSpec annotation_spec = 2;
+}
+
+// Video frame level annotation for object detection and tracking.
+message ObjectTrackingFrame {
+  // The bounding box location of this object track for the frame.
+  oneof bounded_area {
+    BoundingPoly bounding_poly = 1;
+
+    NormalizedBoundingPoly normalized_bounding_poly = 2;
+  }
+
+  // The time offset of this frame relative to the beginning of the video.
+  google.protobuf.Duration time_offset = 3;
+}
+
+// Video object tracking annotation.
+message VideoObjectTrackingAnnotation {
+  // Label of the object tracked in this annotation.
+  AnnotationSpec annotation_spec = 1;
+
+  // The time segment of the video to which object tracking applies.
+  TimeSegment time_segment = 2;
+
+  // The list of frames where this object track appears.
+  repeated ObjectTrackingFrame object_tracking_frames = 3;
+}
+
+// Video event annotation.
+message VideoEventAnnotation {
+  // Label of the event in this annotation.
+  AnnotationSpec annotation_spec = 1;
+
+  // The time segment of the video to which the annotation applies.
+  TimeSegment time_segment = 2;
+}
+
+// Additional information associated with the annotation.
+message AnnotationMetadata {
+  // Metadata related to human labeling.
+  OperatorMetadata operator_metadata = 2;
+}
+
+// General information useful for labels coming from contributors.
+message OperatorMetadata {
+  // Confidence score corresponding to a label. For examle, if 3 contributors
+  // have answered the question and 2 of them agree on the final label, the
+  // confidence score will be 0.67 (2/3).
+  float score = 1;
+
+  // The total number of contributors that answer this question.
+  int32 total_votes = 2;
+
+  // The total number of contributors that choose this label.
+  int32 label_votes = 3;
+
+  repeated string comments = 4;
+}
diff --git a/datalabeling/protos/annotation_spec_set.proto b/datalabeling/protos/annotation_spec_set.proto
new file mode 100644
index 000000000000..20fdec73c4d9
--- /dev/null
+++ b/datalabeling/protos/annotation_spec_set.proto
@@ -0,0 +1,56 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/api/annotations.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.
+message AnnotationSpecSet {
+  // Output only.
+  // AnnotationSpecSet resource name, 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.
+  string display_name = 2;
+
+  // Optional. User-provided description of the annotation specification set.
+  // The description can be up to 10000 characters long.
+  string description = 3;
+
+  // Required. The actual spec set defined by the users.
+  repeated AnnotationSpec annotation_specs = 4;
+}
+
+// Container of information related to one annotation spec.
+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.
+  string description = 2;
+}
diff --git a/datalabeling/protos/data_labeling_service.proto b/datalabeling/protos/data_labeling_service.proto
new file mode 100644
index 000000000000..ee044911b874
--- /dev/null
+++ b/datalabeling/protos/data_labeling_service.proto
@@ -0,0 +1,727 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto";
+import "google/cloud/datalabeling/v1beta1/dataset.proto";
+import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto";
+import "google/cloud/datalabeling/v1beta1/instruction.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.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";
+
+
+service DataLabelingService {
+  // Creates dataset. If success return a Dataset resource.
+  rpc CreateDataset(CreateDatasetRequest) returns (Dataset) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/datasets"
+      body: "*"
+    };
+  }
+
+  // Gets dataset by resource name.
+  rpc GetDataset(GetDatasetRequest) returns (Dataset) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*}"
+    };
+  }
+
+  // Lists datasets under a project. Pagination is supported.
+  rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/datasets"
+    };
+  }
+
+  // Deletes a dataset by resource name.
+  rpc DeleteDataset(DeleteDatasetRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/datasets/*}"
+    };
+  }
+
+  // Imports data into dataset based on source locations defined in request.
+  // It can be called multiple times for the same dataset. Each dataset can
+  // only have one long running operation running on it. For example, no
+  // labeling task (also long running operation) can be started while
+  // importing is still ongoing. Vice versa.
+  rpc ImportData(ImportDataRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/datasets/*}:importData"
+      body: "*"
+    };
+  }
+
+  // Exports data and annotations from dataset.
+  rpc ExportData(ExportDataRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/datasets/*}:exportData"
+      body: "*"
+    };
+  }
+
+  // Gets a data item in a dataset by resource name. This API can be
+  // called after data are imported into dataset.
+  rpc GetDataItem(GetDataItemRequest) returns (DataItem) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/dataItems/*}"
+    };
+  }
+
+  // Lists data items in a dataset. This API can be called after data
+  // are imported into dataset. Pagination is supported.
+  rpc ListDataItems(ListDataItemsRequest) returns (ListDataItemsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/datasets/*}/dataItems"
+    };
+  }
+
+  // Gets an annotated dataset by resource name.
+  rpc GetAnnotatedDataset(GetAnnotatedDatasetRequest) returns (AnnotatedDataset) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}"
+    };
+  }
+
+  // Lists annotated datasets for a dataset. Pagination is supported.
+  rpc ListAnnotatedDatasets(ListAnnotatedDatasetsRequest) returns (ListAnnotatedDatasetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/datasets/*}/annotatedDatasets"
+    };
+  }
+
+  // Deletes an annotated dataset by resource name.
+  rpc DeleteAnnotatedDataset(DeleteAnnotatedDatasetRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}"
+    };
+  }
+
+  // Starts a labeling task for image. The type of image labeling task is
+  // configured by feature in the request.
+  rpc LabelImage(LabelImageRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/image:label"
+      body: "*"
+    };
+  }
+
+  // Starts a labeling task for video. The type of video labeling task is
+  // configured by feature in the request.
+  rpc LabelVideo(LabelVideoRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/video:label"
+      body: "*"
+    };
+  }
+
+  // Starts a labeling task for text. The type of text labeling task is
+  // configured by feature in the request.
+  rpc LabelText(LabelTextRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/text:label"
+      body: "*"
+    };
+  }
+
+  // Starts a labeling task for audio. The type of audio labeling task is
+  // configured by feature in the request.
+  rpc LabelAudio(LabelAudioRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/datasets/*}/audio:label"
+      body: "*"
+    };
+  }
+
+  // Gets an example by resource name, including both data and annotation.
+  rpc GetExample(GetExampleRequest) returns (Example) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*/examples/*}"
+    };
+  }
+
+  // Lists examples in an annotated dataset. Pagination is supported.
+  rpc ListExamples(ListExamplesRequest) returns (ListExamplesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/datasets/*/annotatedDatasets/*}/examples"
+    };
+  }
+
+  // Creates an annotation spec set by providing a set of labels.
+  rpc CreateAnnotationSpecSet(CreateAnnotationSpecSetRequest) returns (AnnotationSpecSet) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/annotationSpecSets"
+      body: "*"
+    };
+  }
+
+  // Gets an annotation spec set by resource name.
+  rpc GetAnnotationSpecSet(GetAnnotationSpecSetRequest) returns (AnnotationSpecSet) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/annotationSpecSets/*}"
+    };
+  }
+
+  // Lists annotation spec sets for a project. Pagination is supported.
+  rpc ListAnnotationSpecSets(ListAnnotationSpecSetsRequest) returns (ListAnnotationSpecSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/annotationSpecSets"
+    };
+  }
+
+  // Deletes an annotation spec set by resource name.
+  rpc DeleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/annotationSpecSets/*}"
+    };
+  }
+
+  // Creates an instruction for how data should be labeled.
+  rpc CreateInstruction(CreateInstructionRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/instructions"
+      body: "*"
+    };
+  }
+
+  // Gets an instruction by resource name.
+  rpc GetInstruction(GetInstructionRequest) returns (Instruction) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/instructions/*}"
+    };
+  }
+
+  // Lists instructions for a project. Pagination is supported.
+  rpc ListInstructions(ListInstructionsRequest) returns (ListInstructionsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/instructions"
+    };
+  }
+
+  // Deletes an instruction object by resource name.
+  rpc DeleteInstruction(DeleteInstructionRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/instructions/*}"
+    };
+  }
+}
+
+// Request message for CreateDataset.
+message CreateDatasetRequest {
+  // Required. Dataset resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Required. The dataset to be created.
+  Dataset dataset = 2;
+}
+
+// Request message for GetDataSet.
+message GetDatasetRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+}
+
+// Request message for ListDataset.
+message ListDatasetsRequest {
+  // Required. Dataset resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Optional. Filter on dataset is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing datasets within a project.
+message ListDatasetsResponse {
+  // The list of datasets to return.
+  repeated Dataset datasets = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteDataset.
+message DeleteDatasetRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+}
+
+// Request message for ImportData API.
+message ImportDataRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+
+  // Required. Specify the input source of the data.
+  InputConfig input_config = 2;
+}
+
+// Request message for ExportData API.
+message ExportDataRequest {
+  // Required. Dataset resource name, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+
+  // 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;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 3;
+
+  // Required. Specify the output destination.
+  OutputConfig output_config = 4;
+}
+
+// Request message for GetDataItem.
+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;
+}
+
+// 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;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing data items in a dataset.
+message ListDataItemsResponse {
+  // The list of data items to return.
+  repeated DataItem data_items = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for GetAnnotatedDataset.
+message GetAnnotatedDatasetRequest {
+  // Required. Name of the annotated dataset to get, format:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}
+  string name = 1;
+}
+
+// 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;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Request message for DeleteAnnotatedDataset.
+message DeleteAnnotatedDatasetRequest {
+  // Required. Name of the annotated dataset to delete, format:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}
+  string name = 1;
+}
+
+// Results of listing annotated datasets for a dataset.
+message ListAnnotatedDatasetsResponse {
+  // The list of annotated datasets to return.
+  repeated AnnotatedDataset annotated_datasets = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for starting an image labeling task.
+message LabelImageRequest {
+  // Image labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Label whole image with one or more of labels.
+    CLASSIFICATION = 1;
+
+    // Label image with bounding boxes for labels.
+    BOUNDING_BOX = 2;
+
+    // Label oriented bounding box. The box does not have to be parallel to
+    // horizontal line.
+    ORIENTED_BOUNDING_BOX = 6;
+
+    // Label images with bounding poly. A bounding poly is a plane figure that
+    // is bounded by a finite chain of straight line segments closing in a loop.
+    BOUNDING_POLY = 3;
+
+    // Label images with polyline. Polyline is formed by connected line segments
+    // which are not in closed form.
+    POLYLINE = 4;
+
+    // Label images with segmentation. Segmentation is different from bounding
+    // poly since it is more fine-grained, pixel level annotation.
+    SEGMENTATION = 5;
+  }
+
+  // Required. Config for labeling tasks. The type of request config must
+  // match the selected feature.
+  oneof request_config {
+    // Configuration for image classification task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config is required.
+    ImageClassificationConfig image_classification_config = 4;
+
+    // Configuration for bounding box and bounding poly task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config is required.
+    BoundingPolyConfig bounding_poly_config = 5;
+
+    // Configuration for polyline task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config is required.
+    PolylineConfig polyline_config = 6;
+
+    // Configuration for segmentation task.
+    // One of image_classification_config, bounding_poly_config,
+    // polyline_config and segmentation_config is required.
+    SegmentationConfig segmentation_config = 7;
+  }
+
+  // Required. Name of the dataset to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of image labeling task.
+  Feature feature = 3;
+}
+
+// Request message for LabelVideo.
+message LabelVideoRequest {
+  // Video labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Label whole video or video segment with one or more labels.
+    CLASSIFICATION = 1;
+
+    // Label objects with bounding box on image frames extracted from the video.
+    OBJECT_DETECTION = 2;
+
+    // Label and track objects in video.
+    OBJECT_TRACKING = 3;
+
+    // Label the range of video for the specified events.
+    EVENT = 4;
+  }
+
+  // Required. Config for labeling tasks. The type of request config must
+  // match the selected feature.
+  oneof request_config {
+    // Configuration for video classification task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    VideoClassificationConfig video_classification_config = 4;
+
+    // Configuration for video object detection task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    ObjectDetectionConfig object_detection_config = 5;
+
+    // Configuration for video object tracking task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    ObjectTrackingConfig object_tracking_config = 6;
+
+    // Configuration for video event task.
+    // One of video_classification_config, object_detection_config,
+    // object_tracking_config and event_config is required.
+    EventConfig event_config = 7;
+  }
+
+  // Required. Name of the dataset to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of video labeling task.
+  Feature feature = 3;
+}
+
+// Request message for LabelText.
+message LabelTextRequest {
+  // Text labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Label text content to one of more labels.
+    TEXT_CLASSIFICATION = 1;
+
+    // Label entities and their span in text.
+    TEXT_ENTITY_EXTRACTION = 2;
+  }
+
+  // Required. Config for labeling tasks. The type of request config must
+  // match the selected feature.
+  oneof request_config {
+    // Configuration for text classification task.
+    // One of text_classification_config and text_entity_extraction_config
+    // is required.
+    TextClassificationConfig text_classification_config = 4;
+
+    // Configuration for entity extraction task.
+    // One of text_classification_config and text_entity_extraction_config
+    // is required.
+    TextEntityExtractionConfig text_entity_extraction_config = 5;
+  }
+
+  // Required. Name of the data set to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of text labeling task.
+  Feature feature = 6;
+}
+
+// Request message for LabelAudio.
+message LabelAudioRequest {
+  // Audio labeling task feature.
+  enum Feature {
+    FEATURE_UNSPECIFIED = 0;
+
+    // Transcribe the audios into text.
+    AUDIO_TRANSCRIPTION = 1;
+  }
+
+  // Required. Name of the dataset to request labeling task, format:
+  // projects/{project_id}/datasets/{dataset_id}
+  string parent = 1;
+
+  // Required. Basic human annotation config.
+  HumanAnnotationConfig basic_config = 2;
+
+  // Required. The type of audio labeling task.
+  Feature feature = 3;
+}
+
+// Request message for GetExample
+message GetExampleRequest {
+  // Required. Name of example, format:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}/examples/{example_id}
+  string name = 1;
+
+  // Optional. An expression for filtering Examples. Filter by
+  // annotation_spec.display_name is supported. Format
+  // "annotation_spec.display_name = {display_name}"
+  string filter = 2;
+}
+
+// Request message for ListExamples.
+message ListExamplesRequest {
+  // Required. Example resource parent.
+  string parent = 1;
+
+  // 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;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing Examples in and annotated dataset.
+message ListExamplesResponse {
+  // The list of examples to return.
+  repeated Example examples = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for CreateAnnotationSpecSet.
+message CreateAnnotationSpecSetRequest {
+  // Required. AnnotationSpecSet resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // 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;
+}
+
+// Request message for GetAnnotationSpecSet.
+message GetAnnotationSpecSetRequest {
+  // Required. AnnotationSpecSet resource name, format:
+  // projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}
+  string name = 1;
+}
+
+// Request message for ListAnnotationSpecSets.
+message ListAnnotationSpecSetsRequest {
+  // Required. Parent of AnnotationSpecSet resource, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing annotation spec set under a project.
+message ListAnnotationSpecSetsResponse {
+  // The list of annotation spec sets.
+  repeated AnnotationSpecSet annotation_spec_sets = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteAnnotationSpecSet.
+message DeleteAnnotationSpecSetRequest {
+  // Required. AnnotationSpec resource name, format:
+  // `projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}`.
+  string name = 1;
+}
+
+// Request message for CreateInstruction.
+message CreateInstructionRequest {
+  // Required. Instruction resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Required. Instruction of how to perform the labeling task.
+  Instruction instruction = 2;
+}
+
+// Request message for GetInstruction.
+message GetInstructionRequest {
+  // Required. Instruction resource name, format:
+  // projects/{project_id}/instructions/{instruction_id}
+  string name = 1;
+}
+
+// Request message for DeleteInstruction.
+message DeleteInstructionRequest {
+  // Required. Instruction resource name, format:
+  // projects/{project_id}/instructions/{instruction_id}
+  string name = 1;
+}
+
+// Request message for ListInstructions.
+message ListInstructionsRequest {
+  // Required. Instruction resource parent, format:
+  // projects/{project_id}
+  string parent = 1;
+
+  // Optional. Filter is not supported at this moment.
+  string filter = 2;
+
+  // Optional. Requested page size. Server may return fewer results than
+  // requested. Default value is 100.
+  int32 page_size = 3;
+
+  // 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;
+}
+
+// Results of listing instructions under a project.
+message ListInstructionsResponse {
+  // The list of Instructions to return.
+  repeated Instruction instructions = 1;
+
+  // A token to retrieve next page of results.
+  string next_page_token = 2;
+}
diff --git a/datalabeling/protos/dataset.proto b/datalabeling/protos/dataset.proto
new file mode 100644
index 000000000000..952daf38d626
--- /dev/null
+++ b/datalabeling/protos/dataset.proto
@@ -0,0 +1,306 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/cloud/datalabeling/v1beta1/annotation.proto";
+import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto";
+import "google/protobuf/duration.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/datalabeling/v1beta1;datalabeling";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datalabeling.v1beta1";
+
+
+enum DataType {
+  DATA_TYPE_UNSPECIFIED = 0;
+
+  IMAGE = 1;
+
+  VIDEO = 2;
+
+  TEXT = 4;
+
+  AUDIO = 5;
+}
+
+// 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 {
+  // Output only.
+  // Dataset resource name, format is:
+  // projects/{project_id}/datasets/{dataset_id}
+  string name = 1;
+
+  // Required. The display name of the dataset. 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.
+  string description = 3;
+
+  // Output only. Time the dataset is created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. This is populated with the original input configs
+  // where ImportData is called. It is available only after the clients
+  // import data to this dataset.
+  repeated InputConfig input_configs = 5;
+}
+
+// The configuration of input data, including data type, location, etc.
+message InputConfig {
+  // Required. Where the data is from.
+  oneof source {
+    GcsSource gcs_source = 2;
+  }
+
+  // Required. Data type must be specifed when user tries to import data.
+  DataType data_type = 1;
+}
+
+// Source of the GCS file to be imported. Only gcs path is allowed in
+// input_uri.
+message GcsSource {
+  // Required. The input uri of source file.
+  string input_uri = 1;
+
+  // Required. The format of the gcs source. Only "text/csv" is supported.
+  string mime_type = 2;
+}
+
+// The configuration of output data.
+message OutputConfig {
+  // Required. Location to output data to.
+  oneof destination {
+    // Output to a GCS file. Should be used for labeling output other than Audio
+    // transcription.
+    GcsDestination gcs_destination = 1;
+
+    // Output to a GCS folder. Should be used for Audio transcription
+    // labeling output.
+    GcsFolderDestination gcs_folder_destination = 2;
+  }
+}
+
+// Export destination of the data.Only gcs path is allowed in
+// output_uri.
+message GcsDestination {
+  // Required. The output uri of destination file.
+  string output_uri = 1;
+
+  // Required. The format of the gcs destination. Only "text/csv" and
+  // "application/json"
+  // are supported.
+  string mime_type = 2;
+}
+
+// Export folder destination of the data.
+message GcsFolderDestination {
+  // Required. GCS folder to export data to.
+  string output_folder_uri = 1;
+}
+
+// DataItem is a piece of data, without annotation. For example, an image.
+message DataItem {
+  // Output only.
+  oneof payload {
+    // The image payload, a container of the image bytes/uri.
+    ImagePayload image_payload = 2;
+
+    // The text payload, a container of text content.
+    TextPayload text_payload = 3;
+
+    // The video payload, a container of the video uri.
+    VideoPayload video_payload = 4;
+
+    // The audio payload, a container of the audio uri.
+    AudioPayload audio_payload = 5;
+  }
+
+  // Output only. Name of the data item, in format of:
+  // projects/{project_id}/datasets/{dataset_id}/dataItems/{data_item_id}
+  string name = 1;
+}
+
+// AnnotatedDataset is a set holding annotations for data in a Dataset. Each
+// labeling task will generate an AnnotatedDataset under the Dataset that the
+// task is requested for.
+message AnnotatedDataset {
+  // Output only.
+  // AnnotatedDataset resource name in format of:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}
+  string name = 1;
+
+  // Output only. The display name of the AnnotatedDataset. It is specified in
+  // HumanAnnotationConfig when user starts a labeling task. Maximum of 64
+  // characters.
+  string display_name = 2;
+
+  // Output only. The description of the AnnotatedDataset. It is specified in
+  // HumanAnnotationConfig when user starts a labeling task. Maximum of 10000
+  // characters.
+  string description = 9;
+
+  // Output only. Source of the annotation.
+  AnnotationSource annotation_source = 3;
+
+  // Output only. Type of the annotation. It is specified when starting labeling
+  // task.
+  AnnotationType annotation_type = 8;
+
+  // Output only. Number of examples in the annotated dataset.
+  int64 example_count = 4;
+
+  // Output only. Number of examples that have annotation in the annotated
+  // dataset.
+  int64 completed_example_count = 5;
+
+  // Output only. Per label statistics.
+  LabelStats label_stats = 6;
+
+  // Output only. Time the AnnotatedDataset was created.
+  google.protobuf.Timestamp create_time = 7;
+
+  // Output only. Additional information about AnnotatedDataset.
+  AnnotatedDatasetMetadata metadata = 10;
+}
+
+// Metadata on AnnotatedDataset.
+message AnnotatedDatasetMetadata {
+  // HumanAnnotationConfig used when requesting the human labeling task for this
+  // AnnotatedDataset.
+  HumanAnnotationConfig human_annotation_config = 1;
+
+  // Specific request configuration used when requesting the labeling task.
+  oneof annotation_request_config {
+    // Configuration for image classification task.
+    ImageClassificationConfig image_classification_config = 2;
+    // Configuration for image bounding box and bounding poly task.
+    BoundingPolyConfig bounding_poly_config = 3;
+    // Configuration for image polyline task.
+    PolylineConfig polyline_config = 4;
+    // Configuration for image segmentation task.
+    SegmentationConfig segmentation_config = 5;
+    // Configuration for video classification task.
+    VideoClassificationConfig video_classification_config = 6;
+    // Configuration for video object detection task.
+    ObjectDetectionConfig object_detection_config = 7;
+    // Configuration for video object tracking task.
+    ObjectTrackingConfig object_tracking_config = 8;
+    // Configuration for video event labeling task.
+    EventConfig event_config = 9;
+    // Configuration for text classification task.
+    TextClassificationConfig text_classification_config = 10;
+    // Configuration for text entity extraction task.
+    TextEntityExtractionConfig text_entity_extraction_config = 11;
+  }
+}
+
+// Statistics about annotation specs.
+message LabelStats {
+  // Map of each annotation spec's example count. Key is the annotation spec
+  // name and value is the number of examples for that annotation spec.
+  map<string, int64> example_count = 1;
+}
+
+// An Example is a piece of data and its annotation. For example, an image with
+// label "house".
+message Example {
+  // Output only. The data part of Example.
+  oneof payload {
+    // The image payload, a container of the image bytes/uri.
+    ImagePayload image_payload = 2;
+
+    // The text payload, a container of the text content.
+    TextPayload text_payload = 6;
+
+    // The video payload, a container of the video uri.
+    VideoPayload video_payload = 7;
+
+    // The audio payload, a container of the audio uri.
+    AudioPayload audio_payload = 8;
+  }
+
+  // Output only. Name of the example, in format of:
+  // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/
+  // {annotated_dataset_id}/examples/{example_id}
+  string name = 1;
+
+  // Output only. Annotations for the piece of data in Example.
+  // One piece of data can have multiple annotations.
+  repeated Annotation annotations = 5;
+}
+
+// Container of information about an image.
+message ImagePayload {
+  // Image format.
+  string mime_type = 1;
+
+  // A byte string of a full image.
+  bytes image_thumbnail = 2;
+
+  // Image uri from the user bucket.
+  string image_uri = 3;
+}
+
+// Container of information about a piece of text.
+message TextPayload {
+  // Text content.
+  string text_content = 1;
+}
+
+// Container of information of a video thumbnail.
+message VideoThumbnail {
+  // A byte string of the video frame.
+  bytes thumbnail = 1;
+
+  // Time offset relative to the beginning of the video, corresponding to the
+  // video frame where the thumbnail has been extracted from.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Container of information of a video.
+message VideoPayload {
+  // Video format.
+  string mime_type = 1;
+
+  // Video uri from the user bucket.
+  string video_uri = 2;
+
+  // The list of video thumbnails.
+  repeated VideoThumbnail video_thumbnails = 3;
+
+  // FPS of the video.
+  float frame_rate = 4;
+}
+
+// Container of information of an audio.
+message AudioPayload {
+  // Audio uri in user bucket.
+  string audio_uri = 1;
+
+  // Sample rate in Hertz of the 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.datalabeling.v1beta1.AudioPayload.AudioEncoding].
+  int32 sample_rate_hertz = 3;
+}
diff --git a/datalabeling/protos/human_annotation_config.proto b/datalabeling/protos/human_annotation_config.proto
new file mode 100644
index 000000000000..96672aedaf53
--- /dev/null
+++ b/datalabeling/protos/human_annotation_config.proto
@@ -0,0 +1,208 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/protobuf/duration.proto";
+import "google/api/annotations.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";
+
+
+enum StringAggregationType {
+  STRING_AGGREGATION_TYPE_UNSPECIFIED = 0;
+
+  // Majority vote to aggregate answers.
+  MAJORITY_VOTE = 1;
+
+  // Unanimous answers will be adopted.
+  UNANIMOUS_VOTE = 2;
+
+  // Preserve all answers by crowd compute.
+  NO_AGGREGATION = 3;
+}
+
+// Configuration for how human labeling task should be done.
+message HumanAnnotationConfig {
+  // Required except for LabelAudio case. Instruction resource name.
+  string instruction = 1;
+
+  // Required. A human-readable name for AnnotatedDataset defined by
+  // users. Maximum of 64 characters
+  // .
+  string annotated_dataset_display_name = 2;
+
+  // Optional. A human-readable description for AnnotatedDataset.
+  // The description can be up to 10000 characters long.
+  string annotated_dataset_description = 3;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // Optional. Maximum duration for contributors to answer a question. Default
+  // is 1800 seconds.
+  google.protobuf.Duration question_duration = 7;
+
+  // 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;
+}
+
+// Config for image classification human labeling task.
+message ImageClassificationConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. If allow_multi_label is true, contributors are able to choose
+  // multiple labels for one image.
+  bool allow_multi_label = 2;
+
+  // Optional. The type of how to aggregate answers.
+  StringAggregationType answer_aggregation_type = 3;
+}
+
+// Config for image bounding poly (and bounding box) human labeling task.
+message BoundingPolyConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. Instruction message showed on contributors UI.
+  string instruction_message = 2;
+}
+
+// Config for image polyline human labeling task.
+message PolylineConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. Instruction message showed on contributors UI.
+  string instruction_message = 2;
+}
+
+// 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;
+
+  // Instruction message showed on labelers UI.
+  string instruction_message = 2;
+}
+
+// Config for video classification human labeling task.
+// Currently two types of video classification are supported:
+// 1. Assign labels on the entire video.
+// 2. Split the video into multiple video clips based on camera shot, and
+// assign labels on each video clip.
+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;
+
+    // Optional. If allow_multi_label is true, contributors are able to
+    // choose multiple labels from one annotation spec set.
+    bool allow_multi_label = 2;
+  }
+
+  // Required. The list of annotation spec set configs.
+  // Since watching a video clip takes much longer time than an image, we
+  // support label with multiple AnnotationSpecSet at the same time. Labels
+  // 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;
+
+  // Optional. Option to apply shot detection on the video.
+  bool apply_shot_detection = 2;
+}
+
+// Config for video object detection human labeling task.
+// Object detection will be conducted on the images extracted from the video,
+// and those objects will be labeled with bounding boxes.
+// User need to specify the number of images to be extracted per second as the
+// extraction frame rate.
+message ObjectDetectionConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+
+  // Optional. Instruction message showed on labelers UI.
+  string instruction_message = 2;
+
+  // Required. Number of frames per second to be extracted from the video.
+  double extraction_frame_rate = 3;
+}
+
+// Config for video object tracking human labeling task.
+message ObjectTrackingConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+}
+
+// Config for video event human labeling task.
+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;
+}
+
+// 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;
+
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 2;
+
+  // Optional. Configs for sentiment selection.
+  SentimentConfig sentiment_config = 3;
+}
+
+// Config for setting up sentiments.
+message SentimentConfig {
+  // If set to true, contributors will have the option to select sentiment of
+  // the label they selected, to mark it as negative or positive label. Default
+  // is false.
+  bool enable_label_sentiment_selection = 1;
+}
+
+// Config for text entity extraction human labeling task.
+message TextEntityExtractionConfig {
+  // Required. Annotation spec set resource name.
+  string annotation_spec_set = 1;
+}
diff --git a/datalabeling/protos/instruction.proto b/datalabeling/protos/instruction.proto
new file mode 100644
index 000000000000..d1a1e751c9a3
--- /dev/null
+++ b/datalabeling/protos/instruction.proto
@@ -0,0 +1,78 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/cloud/datalabeling/v1beta1/dataset.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.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";
+
+
+// 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.
+message Instruction {
+  // Output only. Instruction resource name, format:
+  // projects/{project_id}/instructions/{instruction_id}
+  string name = 1;
+
+  // Required. The display name of the instruction. Maximum of 64 characters.
+  string display_name = 2;
+
+  // Optional. User-provided description of the instruction.
+  // The description can be up to 10000 characters long.
+  string description = 3;
+
+  // Output only. Creation time of instruction.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. Last update time of instruction.
+  google.protobuf.Timestamp update_time = 5;
+
+  // Required. The data type of this instruction.
+  DataType data_type = 6;
+
+  // One of CSV and PDF instruction is required.
+  // Instruction from a csv file, such as for classification task.
+  // Csv file should have exact two columns, in the format of:
+  // The first column is labeled data, such as image reference, text.
+  // The second column is comma separated labels associated with data.
+  CsvInstruction csv_instruction = 7;
+
+  // One of CSV and PDF instruction is required.
+  // Instruction from a PDF doc. The PDF doc should be in GCS bucket.
+  PdfInstruction pdf_instruction = 9;
+}
+
+// Instruction from a CSV file.
+message CsvInstruction {
+  // CSV file for the instruction. Only gcs path is allowed.
+  string gcs_file_uri = 1;
+}
+
+// Instruction from a PDF file.
+message PdfInstruction {
+  // PDF file for the instruction. Only gcs path is allowed.
+  string gcs_file_uri = 1;
+}
diff --git a/datalabeling/protos/operations.proto b/datalabeling/protos/operations.proto
new file mode 100644
index 000000000000..71815e5310e3
--- /dev/null
+++ b/datalabeling/protos/operations.proto
@@ -0,0 +1,206 @@
+// 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.cloud.datalabeling.v1beta1;
+
+import "google/cloud/datalabeling/v1beta1/dataset.proto";
+import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto";
+import "google/cloud/datalabeling/v1beta1/instruction.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/datalabeling/v1beta1;datalabeling";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.datalabeling.v1beta1";
+
+// Response used for ImportData longrunning operation.
+message ImportDataOperationResponse {
+  // Ouptut only. The name of imported dataset.
+  string dataset = 1;
+
+  // Output only. Total number of examples requested to import
+  int32 total_count = 2;
+
+  // Output only. Number of examples imported successfully.
+  int32 import_count = 3;
+}
+
+// Response used for ExportDataset longrunning operation.
+message ExportDataOperationResponse {
+  // Ouptut only. The name of dataset.
+  // "projects/*/datasets/*/Datasets/*"
+  string dataset = 1;
+
+  // Output only. Total number of examples requested to export
+  int32 total_count = 2;
+
+  // Output only. Number of examples exported successfully.
+  int32 export_count = 3;
+
+  // Output only. Statistic infos of labels in the exported dataset.
+  LabelStats label_stats = 4;
+
+  // Output only. output_config in the ExportData request.
+  OutputConfig output_config = 5;
+}
+
+// Metadata of an ImportData operation.
+message ImportDataOperationMetadata {
+  // Ouptut only. The name of imported dataset.
+  // "projects/*/datasets/*"
+  string dataset = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+}
+
+// Metadata of an ExportData operation.
+message ExportDataOperationMetadata {
+  // Output only. The name of dataset to be exported.
+  // "projects/*/datasets/*/Datasets/*"
+  string dataset = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+}
+
+// Metadata of a labeling operation, such as LabelImage or LabelVideo.
+// Next tag: 16
+message LabelOperationMetadata {
+  // Output only. Progress of label operation. Range: [0, 100].
+  // Currently not supported.
+  int32 progress_percent = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+
+  // Ouptut only. Details of specific label operation.
+  oneof details {
+    LabelImageClassificationOperationMetadata image_classification_details = 3;
+    LabelImageBoundingBoxOperationMetadata image_bounding_box_details = 4;
+    LabelImageBoundingPolyOperationMetadata image_bounding_poly_details = 11;
+    LabelImageOrientedBoundingBoxOperationMetadata
+        image_oriented_bounding_box_details = 14;
+    LabelImagePolylineOperationMetadata image_polyline_details = 12;
+    LabelImageSegmentationOperationMetadata image_segmentation_details = 15;
+    LabelVideoClassificationOperationMetadata video_classification_details = 5;
+    LabelVideoObjectDetectionOperationMetadata video_object_detection_details =
+        6;
+    LabelVideoObjectTrackingOperationMetadata video_object_tracking_details = 7;
+    LabelVideoEventOperationMetadata video_event_details = 8;
+    LabelTextClassificationOperationMetadata text_classification_details = 9;
+    LabelAudioTranscriptionOperationMetadata audio_transcription_details = 10;
+    LabelTextEntityExtractionOperationMetadata text_entity_extraction_details =
+        13;
+  }
+}
+
+// Metadata of a LabelImageClassification operation.
+message LabelImageClassificationOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelImageBoundingBox operation metadata.
+message LabelImageBoundingBoxOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelImageOrientedBoundingBox operation metadata.
+message LabelImageOrientedBoundingBoxOperationMetadata {
+  // Basic human annotation config.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of LabelImageBoundingPoly operation metadata.
+message LabelImageBoundingPolyOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of LabelImagePolyline operation metadata.
+message LabelImagePolylineOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelImageSegmentation operation metadata.
+message LabelImageSegmentationOperationMetadata {
+  // Basic human annotation config.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoClassification operation metadata.
+message LabelVideoClassificationOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoObjectDetection operation metadata.
+message LabelVideoObjectDetectionOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoObjectTracking operation metadata.
+message LabelVideoObjectTrackingOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelVideoEvent operation metadata.
+message LabelVideoEventOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelTextClassification operation metadata.
+message LabelTextClassificationOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+message LabelAudioTranscriptionOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Details of a LabelTextEntityExtraction operation metadata.
+message LabelTextEntityExtractionOperationMetadata {
+  // Basic human annotation config used in labeling request.
+  HumanAnnotationConfig basic_config = 1;
+}
+
+// Metadata of a CreateInstruction operation.
+message CreateInstructionMetadata {
+  // Output only. The name of the created Instruction.
+  // projects/{project_id}/instructions/{instruction_id}
+  string instruction = 1;
+
+  // Output only. Partial failures encountered.
+  // E.g. single files that couldn't be read.
+  // Status details field will contain standard GCP error details.
+  repeated google.rpc.Status partial_failures = 2;
+}
diff --git a/datalabeling/setup.cfg b/datalabeling/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/datalabeling/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/datalabeling/setup.py b/datalabeling/setup.py
new file mode 100644
index 000000000000..d72653c651fe
--- /dev/null
+++ b/datalabeling/setup.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-datalabeling"
+description = "Data Labeling API client library"
+version = "0.2.1"
+release_status = "Development Status :: 4 - Beta"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/datalabeling/synth.metadata b/datalabeling/synth.metadata
new file mode 100644
index 000000000000..f1a8c9f726e1
--- /dev/null
+++ b/datalabeling/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:19:50.381278Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "datalabeling",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/datalabeling/artman_datalabeling_v1beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/datalabeling/synth.py b/datalabeling/synth.py
new file mode 100644
index 000000000000..af1823fd6e4f
--- /dev/null
+++ b/datalabeling/synth.py
@@ -0,0 +1,80 @@
+# 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 script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+version = 'v1beta1'
+
+library = gapic.py_library(
+    'datalabeling',
+    version,
+    config_path='/google/cloud/datalabeling/'
+                'artman_datalabeling_v1beta1.yaml',
+    artman_output_name='datalabeling-v1beta1',
+    include_protos=True,
+)
+
+s.move(
+    library,
+    excludes=[
+        'docs/conf.py',
+        'docs/index.rst',
+        'google/cloud/datalabeling_v1beta1/__init__.py',
+        'README.rst',
+        'nox*.py',
+        'setup.py',
+        'setup.cfg',
+    ],
+)
+
+# Fixup issues in generated code
+s.replace(
+    "./**/gapic/**/*client.py",
+    r"operations_pb2.ImportDataOperationResponse",
+    "proto_operations_pb2.ImportDataOperationResponse",
+)
+
+s.replace(
+    "./**/gapic/**/*client.py",
+    r"operations_pb2.ImportDataOperationMetadata",
+    "proto_operations_pb2.ImportDataOperationMetadata",
+)
+
+s.replace(
+    "./tests/unit/gapic/**/test*_client*.py",
+    r"operations_pb2.Operation\(",
+    "longrunning_operations_pb2.Operation(",
+)
+
+# Fix docstrings with no summary line
+s.replace(
+    "google/cloud/**/proto/*_pb2.py",
+    '''__doc__ = """Attributes:''',
+    '''__doc__ = """
+    Attributes:''',
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=80, cov_level=80)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/datalabeling/tests/unit/gapic/v1beta1/test_data_labeling_service_client_v1beta1.py b/datalabeling/tests/unit/gapic/v1beta1/test_data_labeling_service_client_v1beta1.py
new file mode 100644
index 000000000000..dbc214ba0f26
--- /dev/null
+++ b/datalabeling/tests/unit/gapic/v1beta1/test_data_labeling_service_client_v1beta1.py
@@ -0,0 +1,1703 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import datalabeling_v1beta1
+from google.cloud.datalabeling_v1beta1 import enums
+from google.cloud.datalabeling_v1beta1.proto import annotation_spec_set_pb2
+from google.cloud.datalabeling_v1beta1.proto import data_labeling_service_pb2
+from google.cloud.datalabeling_v1beta1.proto import dataset_pb2
+from google.cloud.datalabeling_v1beta1.proto import evaluation_job_pb2
+from google.cloud.datalabeling_v1beta1.proto import evaluation_pb2
+from google.cloud.datalabeling_v1beta1.proto import human_annotation_config_pb2
+from google.cloud.datalabeling_v1beta1.proto import instruction_pb2
+from google.cloud.datalabeling_v1beta1.proto import (
+    operations_pb2 as proto_operations_pb2,
+)
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDataLabelingServiceClient(object):
+    def test_create_dataset(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        data_item_count = 2014260376
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "data_item_count": data_item_count,
+        }
+        expected_response = dataset_pb2.Dataset(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        dataset = {}
+
+        response = client.create_dataset(parent, dataset)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.CreateDatasetRequest(
+            parent=parent, dataset=dataset
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        dataset = {}
+
+        with pytest.raises(CustomException):
+            client.create_dataset(parent, dataset)
+
+    def test_get_dataset(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        data_item_count = 2014260376
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+            "data_item_count": data_item_count,
+        }
+        expected_response = dataset_pb2.Dataset(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        response = client.get_dataset(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetDatasetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        with pytest.raises(CustomException):
+            client.get_dataset(name)
+
+    def test_list_datasets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        datasets_element = {}
+        datasets = [datasets_element]
+        expected_response = {"next_page_token": next_page_token, "datasets": datasets}
+        expected_response = data_labeling_service_pb2.ListDatasetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_datasets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.datasets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListDatasetsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_datasets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_datasets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_dataset(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        client.delete_dataset(name)
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.DeleteDatasetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        with pytest.raises(CustomException):
+            client.delete_dataset(name)
+
+    def test_import_data(self):
+        # Setup Expected Response
+        dataset = "dataset1443214456"
+        total_count = 407761836
+        import_count = 1721296907
+        expected_response = {
+            "dataset": dataset,
+            "total_count": total_count,
+            "import_count": import_count,
+        }
+        expected_response = proto_operations_pb2.ImportDataOperationResponse(
+            **expected_response
+        )
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_import_data", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+        input_config = {}
+
+        response = client.import_data(name, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ImportDataRequest(
+            name=name, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_data_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_import_data_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+        input_config = {}
+
+        response = client.import_data(name, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_export_data(self):
+        # Setup Expected Response
+        dataset = "dataset1443214456"
+        total_count = 407761836
+        export_count = 529256252
+        expected_response = {
+            "dataset": dataset,
+            "total_count": total_count,
+            "export_count": export_count,
+        }
+        expected_response = proto_operations_pb2.ExportDataOperationResponse(
+            **expected_response
+        )
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_export_data", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+        annotated_dataset = "annotatedDataset-1407812655"
+        output_config = {}
+
+        response = client.export_data(name, annotated_dataset, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ExportDataRequest(
+            name=name, annotated_dataset=annotated_dataset, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_data_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_export_data_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.dataset_path("[PROJECT]", "[DATASET]")
+        annotated_dataset = "annotatedDataset-1407812655"
+        output_config = {}
+
+        response = client.export_data(name, annotated_dataset, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_data_item(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = dataset_pb2.DataItem(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.data_item_path("[PROJECT]", "[DATASET]", "[DATA_ITEM]")
+
+        response = client.get_data_item(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetDataItemRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_data_item_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.data_item_path("[PROJECT]", "[DATASET]", "[DATA_ITEM]")
+
+        with pytest.raises(CustomException):
+            client.get_data_item(name)
+
+    def test_list_data_items(self):
+        # Setup Expected Response
+        next_page_token = ""
+        data_items_element = {}
+        data_items = [data_items_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "data_items": data_items,
+        }
+        expected_response = data_labeling_service_pb2.ListDataItemsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        paged_list_response = client.list_data_items(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.data_items[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListDataItemsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_data_items_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        paged_list_response = client.list_data_items(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_annotated_dataset(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        completed_example_count = 612567290
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "completed_example_count": completed_example_count,
+        }
+        expected_response = dataset_pb2.AnnotatedDataset(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.annotated_dataset_path(
+            "[PROJECT]", "[DATASET]", "[ANNOTATED_DATASET]"
+        )
+
+        response = client.get_annotated_dataset(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetAnnotatedDatasetRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_annotated_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.annotated_dataset_path(
+            "[PROJECT]", "[DATASET]", "[ANNOTATED_DATASET]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_annotated_dataset(name)
+
+    def test_list_annotated_datasets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        annotated_datasets_element = {}
+        annotated_datasets = [annotated_datasets_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "annotated_datasets": annotated_datasets,
+        }
+        expected_response = data_labeling_service_pb2.ListAnnotatedDatasetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        paged_list_response = client.list_annotated_datasets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.annotated_datasets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListAnnotatedDatasetsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_annotated_datasets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+
+        paged_list_response = client.list_annotated_datasets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_label_image(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        completed_example_count = 612567290
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "completed_example_count": completed_example_count,
+        }
+        expected_response = dataset_pb2.AnnotatedDataset(**expected_response)
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_label_image", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+        basic_config = {}
+        feature = enums.LabelImageRequest.Feature.FEATURE_UNSPECIFIED
+
+        response = client.label_image(parent, basic_config, feature)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.LabelImageRequest(
+            parent=parent, basic_config=basic_config, feature=feature
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_label_image_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_label_image_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+        basic_config = {}
+        feature = enums.LabelImageRequest.Feature.FEATURE_UNSPECIFIED
+
+        response = client.label_image(parent, basic_config, feature)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_label_video(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        completed_example_count = 612567290
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "completed_example_count": completed_example_count,
+        }
+        expected_response = dataset_pb2.AnnotatedDataset(**expected_response)
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_label_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+        basic_config = {}
+        feature = enums.LabelVideoRequest.Feature.FEATURE_UNSPECIFIED
+
+        response = client.label_video(parent, basic_config, feature)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.LabelVideoRequest(
+            parent=parent, basic_config=basic_config, feature=feature
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_label_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_label_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+        basic_config = {}
+        feature = enums.LabelVideoRequest.Feature.FEATURE_UNSPECIFIED
+
+        response = client.label_video(parent, basic_config, feature)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_label_text(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        example_count = 1517063674
+        completed_example_count = 612567290
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "example_count": example_count,
+            "completed_example_count": completed_example_count,
+        }
+        expected_response = dataset_pb2.AnnotatedDataset(**expected_response)
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_label_text", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+        basic_config = {}
+        feature = enums.LabelTextRequest.Feature.FEATURE_UNSPECIFIED
+
+        response = client.label_text(parent, basic_config, feature)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.LabelTextRequest(
+            parent=parent, basic_config=basic_config, feature=feature
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_label_text_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_label_text_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.dataset_path("[PROJECT]", "[DATASET]")
+        basic_config = {}
+        feature = enums.LabelTextRequest.Feature.FEATURE_UNSPECIFIED
+
+        response = client.label_text(parent, basic_config, feature)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_example(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = dataset_pb2.Example(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.example_path(
+            "[PROJECT]", "[DATASET]", "[ANNOTATED_DATASET]", "[EXAMPLE]"
+        )
+
+        response = client.get_example(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetExampleRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_example_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.example_path(
+            "[PROJECT]", "[DATASET]", "[ANNOTATED_DATASET]", "[EXAMPLE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_example(name)
+
+    def test_list_examples(self):
+        # Setup Expected Response
+        next_page_token = ""
+        examples_element = {}
+        examples = [examples_element]
+        expected_response = {"next_page_token": next_page_token, "examples": examples}
+        expected_response = data_labeling_service_pb2.ListExamplesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.annotated_dataset_path(
+            "[PROJECT]", "[DATASET]", "[ANNOTATED_DATASET]"
+        )
+
+        paged_list_response = client.list_examples(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.examples[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListExamplesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_examples_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.annotated_dataset_path(
+            "[PROJECT]", "[DATASET]", "[ANNOTATED_DATASET]"
+        )
+
+        paged_list_response = client.list_examples(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_annotation_spec_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = annotation_spec_set_pb2.AnnotationSpecSet(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        annotation_spec_set = {}
+
+        response = client.create_annotation_spec_set(parent, annotation_spec_set)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.CreateAnnotationSpecSetRequest(
+            parent=parent, annotation_spec_set=annotation_spec_set
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_annotation_spec_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        annotation_spec_set = {}
+
+        with pytest.raises(CustomException):
+            client.create_annotation_spec_set(parent, annotation_spec_set)
+
+    def test_get_annotation_spec_set(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = annotation_spec_set_pb2.AnnotationSpecSet(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.annotation_spec_set_path("[PROJECT]", "[ANNOTATION_SPEC_SET]")
+
+        response = client.get_annotation_spec_set(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetAnnotationSpecSetRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_annotation_spec_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.annotation_spec_set_path("[PROJECT]", "[ANNOTATION_SPEC_SET]")
+
+        with pytest.raises(CustomException):
+            client.get_annotation_spec_set(name)
+
+    def test_list_annotation_spec_sets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        annotation_spec_sets_element = {}
+        annotation_spec_sets = [annotation_spec_sets_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "annotation_spec_sets": annotation_spec_sets,
+        }
+        expected_response = data_labeling_service_pb2.ListAnnotationSpecSetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_annotation_spec_sets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.annotation_spec_sets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListAnnotationSpecSetsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_annotation_spec_sets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_annotation_spec_sets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_annotation_spec_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.annotation_spec_set_path("[PROJECT]", "[ANNOTATION_SPEC_SET]")
+
+        client.delete_annotation_spec_set(name)
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.DeleteAnnotationSpecSetRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_annotation_spec_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.annotation_spec_set_path("[PROJECT]", "[ANNOTATION_SPEC_SET]")
+
+        with pytest.raises(CustomException):
+            client.delete_annotation_spec_set(name)
+
+    def test_create_instruction(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = instruction_pb2.Instruction(**expected_response)
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_create_instruction", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        instruction = {}
+
+        response = client.create_instruction(parent, instruction)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.CreateInstructionRequest(
+            parent=parent, instruction=instruction
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_instruction_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = longrunning_operations_pb2.Operation(
+            name="operations/test_create_instruction_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        instruction = {}
+
+        response = client.create_instruction(parent, instruction)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_instruction(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = instruction_pb2.Instruction(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.instruction_path("[PROJECT]", "[INSTRUCTION]")
+
+        response = client.get_instruction(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetInstructionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_instruction_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.instruction_path("[PROJECT]", "[INSTRUCTION]")
+
+        with pytest.raises(CustomException):
+            client.get_instruction(name)
+
+    def test_list_instructions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        instructions_element = {}
+        instructions = [instructions_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "instructions": instructions,
+        }
+        expected_response = data_labeling_service_pb2.ListInstructionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_instructions(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.instructions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListInstructionsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_instructions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_instructions(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_instruction(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.instruction_path("[PROJECT]", "[INSTRUCTION]")
+
+        client.delete_instruction(name)
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.DeleteInstructionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_instruction_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.instruction_path("[PROJECT]", "[INSTRUCTION]")
+
+        with pytest.raises(CustomException):
+            client.delete_instruction(name)
+
+    def test_get_evaluation(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        evaluated_item_count = 358077111
+        expected_response = {
+            "name": name_2,
+            "evaluated_item_count": evaluated_item_count,
+        }
+        expected_response = evaluation_pb2.Evaluation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.evaluation_path("[PROJECT]", "[DATASET]", "[EVALUATION]")
+
+        response = client.get_evaluation(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetEvaluationRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_evaluation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.evaluation_path("[PROJECT]", "[DATASET]", "[EVALUATION]")
+
+        with pytest.raises(CustomException):
+            client.get_evaluation(name)
+
+    def test_search_evaluations(self):
+        # Setup Expected Response
+        next_page_token = ""
+        evaluations_element = {}
+        evaluations = [evaluations_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "evaluations": evaluations,
+        }
+        expected_response = data_labeling_service_pb2.SearchEvaluationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.search_evaluations(parent, filter_)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.evaluations[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.SearchEvaluationsRequest(
+            parent=parent, filter=filter_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_evaluations_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.search_evaluations(parent, filter_)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_search_example_comparisons(self):
+        # Setup Expected Response
+        next_page_token = ""
+        example_comparisons_element = {}
+        example_comparisons = [example_comparisons_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "example_comparisons": example_comparisons,
+        }
+        expected_response = data_labeling_service_pb2.SearchExampleComparisonsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.evaluation_path("[PROJECT]", "[DATASET]", "[EVALUATION]")
+
+        paged_list_response = client.search_example_comparisons(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.example_comparisons[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.SearchExampleComparisonsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_example_comparisons_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.evaluation_path("[PROJECT]", "[DATASET]", "[EVALUATION]")
+
+        paged_list_response = client.search_example_comparisons(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_evaluation_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        model_version = "modelVersion-1669102142"
+        annotation_spec_set = "annotationSpecSet1881405678"
+        label_missing_ground_truth = False
+        expected_response = {
+            "name": name,
+            "description": description,
+            "schedule": schedule,
+            "model_version": model_version,
+            "annotation_spec_set": annotation_spec_set,
+            "label_missing_ground_truth": label_missing_ground_truth,
+        }
+        expected_response = evaluation_job_pb2.EvaluationJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        job = {}
+
+        response = client.create_evaluation_job(parent, job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.CreateEvaluationJobRequest(
+            parent=parent, job=job
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_evaluation_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.create_evaluation_job(parent, job)
+
+    def test_update_evaluation_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        model_version = "modelVersion-1669102142"
+        annotation_spec_set = "annotationSpecSet1881405678"
+        label_missing_ground_truth = False
+        expected_response = {
+            "name": name,
+            "description": description,
+            "schedule": schedule,
+            "model_version": model_version,
+            "annotation_spec_set": annotation_spec_set,
+            "label_missing_ground_truth": label_missing_ground_truth,
+        }
+        expected_response = evaluation_job_pb2.EvaluationJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        evaluation_job = {}
+        update_mask = {}
+
+        response = client.update_evaluation_job(evaluation_job, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.UpdateEvaluationJobRequest(
+            evaluation_job=evaluation_job, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_evaluation_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        evaluation_job = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_evaluation_job(evaluation_job, update_mask)
+
+    def test_get_evaluation_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        model_version = "modelVersion-1669102142"
+        annotation_spec_set = "annotationSpecSet1881405678"
+        label_missing_ground_truth = False
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "model_version": model_version,
+            "annotation_spec_set": annotation_spec_set,
+            "label_missing_ground_truth": label_missing_ground_truth,
+        }
+        expected_response = evaluation_job_pb2.EvaluationJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        response = client.get_evaluation_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.GetEvaluationJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_evaluation_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        with pytest.raises(CustomException):
+            client.get_evaluation_job(name)
+
+    def test_pause_evaluation_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        client.pause_evaluation_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.PauseEvaluationJobRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pause_evaluation_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        with pytest.raises(CustomException):
+            client.pause_evaluation_job(name)
+
+    def test_resume_evaluation_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        client.resume_evaluation_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ResumeEvaluationJobRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_resume_evaluation_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        with pytest.raises(CustomException):
+            client.resume_evaluation_job(name)
+
+    def test_delete_evaluation_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        client.delete_evaluation_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.DeleteEvaluationJobRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_evaluation_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        name = client.evaluation_job_path("[PROJECT]", "[EVALUATION_JOB]")
+
+        with pytest.raises(CustomException):
+            client.delete_evaluation_job(name)
+
+    def test_list_evaluation_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        evaluation_jobs_element = {}
+        evaluation_jobs = [evaluation_jobs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "evaluation_jobs": evaluation_jobs,
+        }
+        expected_response = data_labeling_service_pb2.ListEvaluationJobsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_evaluation_jobs(parent, filter_)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.evaluation_jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.ListEvaluationJobsRequest(
+            parent=parent, filter=filter_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_evaluation_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_evaluation_jobs(parent, filter_)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_annotated_dataset(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        client.delete_annotated_dataset()
+
+        assert len(channel.requests) == 1
+        expected_request = data_labeling_service_pb2.DeleteAnnotatedDatasetRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_annotated_dataset_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = datalabeling_v1beta1.DataLabelingServiceClient()
+
+        with pytest.raises(CustomException):
+            client.delete_annotated_dataset()
diff --git a/dataproc/.coveragerc b/dataproc/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/dataproc/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/dataproc/.flake8 b/dataproc/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/dataproc/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/dataproc/.repo-metadata.json b/dataproc/.repo-metadata.json
new file mode 100644
index 000000000000..c7d1f8c00a9b
--- /dev/null
+++ b/dataproc/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "dataproc",
+  "name_pretty": "Google Cloud Dataproc",
+  "product_documentation": "https://cloud.google.com/dataproc",
+  "client_documentation": "https://googleapis.dev/python/dataproc/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559745",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-dataproc",
+  "api_id": "dataproc.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/dataproc/CHANGELOG.md b/dataproc/CHANGELOG.md
new file mode 100644
index 000000000000..2a3ece527b32
--- /dev/null
+++ b/dataproc/CHANGELOG.md
@@ -0,0 +1,133 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-dataproc/#history
+
+## 0.5.0
+
+07-24-2019 16:02 PDT
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8387](https://github.com/googleapis/google-cloud-python/pull/8387))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8505](https://github.com/googleapis/google-cloud-python/pull/8505))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8579](https://github.com/googleapis/google-cloud-python/pull/8579))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8349](https://github.com/googleapis/google-cloud-python/pull/8349))
+- Add disclaimer to auto-generated template files (via synth).  ([#8311](https://github.com/googleapis/google-cloud-python/pull/8311))
+- Supress checking 'cov-fail-under' in nox default session (via synth). ([#8237](https://github.com/googleapis/google-cloud-python/pull/8237))
+
+## 0.4.0
+
+05-30-2019 05:52 PDT
+
+### Implementation Changes
+- Update docs/conf.py, add routing header to method metadata, fix docstrings (via synth). ([#7924](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7924))
+
+### New Features
+- Add new service features for v1, including autoscaling (via synth). ([#8152](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8152))
+- Add new service features for v1beta2, including autoscaling (via synth). ([#8119](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8119))
+
+### Documentation
+- Add nox session `docs` ([#7429](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7429))
+- Add clarifying comment to blacken nox target. ([#7388](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7388))
+
+### Internal / Testing Changes
+- Re-add import of 'operations.proto' to V1 'clusters.proto' (via synth). ([#8188](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8188))
+- Add empty lines (via synth). ([#8054](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8054))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7535))
+- Copy lintified proto files (via synth). ([#7465](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7465))
+
+## 0.3.1
+
+02-15-2019 12:36 PST
+
+
+### Implementation Changes
+- Remove unused message exports. ([#7266](https://github.com/googleapis/google-cloud-python/pull/7266))
+- Protoc-generated serialization update.. ([#7079](https://github.com/googleapis/google-cloud-python/pull/7079))
+- Trivial housekeeping change to .proto files. ([#7067](https://github.com/googleapis/google-cloud-python/pull/7067))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Pick up stub docstring fix in GAPIC generator. ([#6967](https://github.com/googleapis/google-cloud-python/pull/6967))
+
+### Internal / Testing Changes
+- Copy proto files alongside protoc versions.
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers
+
+## 0.3.0
+
+12-17-2018 18:20 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Update `cluster_controller_client` GAPIC config (via synth). ([#6659](https://github.com/googleapis/google-cloud-python/pull/6659))
+- Add 'WorkflowTemplateServiceClient', optional args; update timeouts (via synth). ([#6655](https://github.com/googleapis/google-cloud-python/pull/6655))
+- Pick up enum fixes in the GAPIC generator. ([#6609](https://github.com/googleapis/google-cloud-python/pull/6609))
+- Pick up fixes in GAPIC generator. ([#6493](https://github.com/googleapis/google-cloud-python/pull/6493))
+- Fix client_info bug, update docstrings. ([#6408](https://github.com/googleapis/google-cloud-python/pull/6408))
+- Re-generate library using dataproc/synth.py ([#6056](https://github.com/googleapis/google-cloud-python/pull/6056))
+- Re-generate library using dataproc/synth.py ([#5975](https://github.com/googleapis/google-cloud-python/pull/5975))
+- Re-generate library using dataproc/synth.py ([#5949](https://github.com/googleapis/google-cloud-python/pull/5949))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Update Dataproc docs URL ([#6455](https://github.com/googleapis/google-cloud-python/pull/6455))
+- Docs: fix GAX fossils ([#6264](https://github.com/googleapis/google-cloud-python/pull/6264))
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Dataproc: harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6019](https://github.com/googleapis/google-cloud-python/pull/6019))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Unblack dataproc gapic and protos.
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6563](https://github.com/googleapis/google-cloud-python/pull/6563))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.2.0
+
+### New Features
+- Regenerate v1 endpoint. Add v1beta2 endpoint (#5717)
+
+## 0.1.2
+
+### Implementation Changes
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+
+### Internal / Testing Changes
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+
+## 0.1.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+
diff --git a/dataproc/LICENSE b/dataproc/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/dataproc/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/dataproc/MANIFEST.in b/dataproc/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/dataproc/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/dataproc/README.rst b/dataproc/README.rst
new file mode 100644
index 000000000000..c06fe058630e
--- /dev/null
+++ b/dataproc/README.rst
@@ -0,0 +1,110 @@
+Python Client for Google Cloud Dataproc API
+===========================================
+
+|alpha| |pypi| |versions| 
+
+`Google Cloud Dataproc API`_: Manages Hadoop-based clusters and jobs on Google Cloud Platform.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-dataproc.svg
+   :target: https://pypi.org/project/google-cloud-dataproc/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-dataproc.svg
+   :target: https://pypi.org/project/google-cloud-dataproc/
+.. _Google Cloud Dataproc API: https://cloud.google.com/dataproc
+.. _Client Library Documentation: https://googleapis.dev/python/dataproc/latest
+.. _Product Documentation:  https://cloud.google.com/dataproc
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Dataproc API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Dataproc API.:  https://cloud.google.com/dataproc
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-dataproc
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-dataproc
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code:: py
+
+    from google.cloud import dataproc_v1
+
+    client = dataproc_v1.ClusterControllerClient()
+
+    project_id = ''
+    region = ''
+
+
+    # Iterate over all results
+    for element in client.list_clusters(project_id, region):
+        # process element
+        pass
+
+    # Or iterate over results one page at a time
+    for page in client.list_clusters(project_id, region).pages:
+        for element in page:
+            # process element
+            pass
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Dataproc API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn more about the product and see
+   How-to Guides.
diff --git a/dataproc/docs/README.rst b/dataproc/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/dataproc/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/dataproc/docs/changelog.md b/dataproc/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/dataproc/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/dataproc/docs/conf.py b/dataproc/docs/conf.py
new file mode 100644
index 000000000000..d51adac42167
--- /dev/null
+++ b/dataproc/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-dataproc documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-dataproc"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-dataproc-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-dataproc.tex",
+        u"google-cloud-dataproc Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-dataproc",
+        u"google-cloud-dataproc Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-dataproc",
+        u"google-cloud-dataproc Documentation",
+        author,
+        "google-cloud-dataproc",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/dataproc/docs/gapic/v1/api.rst b/dataproc/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..633bbed170ea
--- /dev/null
+++ b/dataproc/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Dataproc API
+====================================
+
+.. automodule:: google.cloud.dataproc_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/dataproc/docs/gapic/v1/types.rst b/dataproc/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..0dfeadcfbaa7
--- /dev/null
+++ b/dataproc/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Dataproc API Client
+==========================================
+
+.. automodule:: google.cloud.dataproc_v1.types
+    :members:
\ No newline at end of file
diff --git a/dataproc/docs/gapic/v1beta2/api.rst b/dataproc/docs/gapic/v1beta2/api.rst
new file mode 100644
index 000000000000..bac320b8e069
--- /dev/null
+++ b/dataproc/docs/gapic/v1beta2/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Dataproc API
+====================================
+
+.. automodule:: google.cloud.dataproc_v1beta2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/dataproc/docs/gapic/v1beta2/types.rst b/dataproc/docs/gapic/v1beta2/types.rst
new file mode 100644
index 000000000000..5bed9e2cd25c
--- /dev/null
+++ b/dataproc/docs/gapic/v1beta2/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Dataproc API Client
+==========================================
+
+.. automodule:: google.cloud.dataproc_v1beta2.types
+    :members:
\ No newline at end of file
diff --git a/dataproc/docs/index.rst b/dataproc/docs/index.rst
new file mode 100644
index 000000000000..d4dd5e345115
--- /dev/null
+++ b/dataproc/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1/api
+   gapic/v1/types
+   gapic/v1beta2/api
+   gapic/v1beta2/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-dataproc`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/dataproc/google/__init__.py b/dataproc/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/dataproc/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/dataproc/google/cloud/__init__.py b/dataproc/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/dataproc/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/dataproc/google/cloud/dataproc.py b/dataproc/google/cloud/dataproc.py
new file mode 100644
index 000000000000..772a0dbfd0de
--- /dev/null
+++ b/dataproc/google/cloud/dataproc.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.dataproc_v1 import ClusterControllerClient
+from google.cloud.dataproc_v1 import JobControllerClient
+from google.cloud.dataproc_v1 import WorkflowTemplateServiceClient
+from google.cloud.dataproc_v1 import enums
+from google.cloud.dataproc_v1 import types
+
+
+__all__ = (
+    "enums",
+    "types",
+    "ClusterControllerClient",
+    "JobControllerClient",
+    "WorkflowTemplateServiceClient",
+)
diff --git a/dataproc/google/cloud/dataproc_v1/__init__.py b/dataproc/google/cloud/dataproc_v1/__init__.py
new file mode 100644
index 000000000000..e82a68ed0d9e
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/__init__.py
@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.dataproc_v1 import types
+from google.cloud.dataproc_v1.gapic import cluster_controller_client
+from google.cloud.dataproc_v1.gapic import enums
+from google.cloud.dataproc_v1.gapic import job_controller_client
+from google.cloud.dataproc_v1.gapic import workflow_template_service_client
+
+
+class ClusterControllerClient(cluster_controller_client.ClusterControllerClient):
+    __doc__ = cluster_controller_client.ClusterControllerClient.__doc__
+    enums = enums
+
+
+class JobControllerClient(job_controller_client.JobControllerClient):
+    __doc__ = job_controller_client.JobControllerClient.__doc__
+    enums = enums
+
+
+class WorkflowTemplateServiceClient(
+    workflow_template_service_client.WorkflowTemplateServiceClient
+):
+    __doc__ = workflow_template_service_client.WorkflowTemplateServiceClient.__doc__
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "ClusterControllerClient",
+    "JobControllerClient",
+    "WorkflowTemplateServiceClient",
+)
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/__init__.py b/dataproc/google/cloud/dataproc_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/cluster_controller_client.py b/dataproc/google/cloud/dataproc_v1/gapic/cluster_controller_client.py
new file mode 100644
index 000000000000..4cda9a051e29
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/cluster_controller_client.py
@@ -0,0 +1,856 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1 ClusterController API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import grpc
+
+from google.cloud.dataproc_v1.gapic import cluster_controller_client_config
+from google.cloud.dataproc_v1.gapic import enums
+from google.cloud.dataproc_v1.gapic.transports import cluster_controller_grpc_transport
+from google.cloud.dataproc_v1.proto import clusters_pb2
+from google.cloud.dataproc_v1.proto import clusters_pb2_grpc
+from google.cloud.dataproc_v1.proto import operations_pb2 as proto_operations_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class ClusterControllerClient(object):
+    """
+    The ClusterControllerService provides methods to manage clusters
+    of Compute Engine instances.
+    """
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1.ClusterController"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ClusterControllerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ClusterControllerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ClusterControllerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cluster_controller_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cluster_controller_grpc_transport.ClusterControllerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cluster_controller_grpc_transport.ClusterControllerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_cluster(
+        self,
+        project_id,
+        region,
+        cluster,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> response = client.create_cluster(project_id, region, cluster)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster (Union[dict, ~google.cloud.dataproc_v1.types.Cluster]): Required. The cluster to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.Cluster`
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``CreateClusterRequest`` requests with the same id, then
+                the second request will be ignored and the first
+                ``google.longrunning.Operation`` created and stored in the backend is
+                returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_cluster,
+                default_retry=self._method_configs["CreateCluster"].retry,
+                default_timeout=self._method_configs["CreateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.CreateClusterRequest(
+            project_id=project_id, region=region, cluster=cluster, request_id=request_id
+        )
+        operation = self._inner_api_calls["create_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            clusters_pb2.Cluster,
+            metadata_type=proto_operations_pb2.ClusterOperationMetadata,
+        )
+
+    def update_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        cluster,
+        update_mask,
+        graceful_decommission_timeout=None,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_cluster(project_id, region, cluster_name, cluster, update_mask)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project the
+                cluster belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            cluster (Union[dict, ~google.cloud.dataproc_v1.types.Cluster]): Required. The changes to the cluster.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.Cluster`
+            update_mask (Union[dict, ~google.cloud.dataproc_v1.types.FieldMask]): Required. Specifies the path, relative to ``Cluster``, of the field to
+                update. For example, to change the number of workers in a cluster to 5,
+                the ``update_mask`` parameter would be specified as
+                ``config.worker_config.num_instances``, and the ``PATCH`` request body
+                would specify the new value, as follows:
+
+                ::
+
+                     {
+                       "config":{
+                         "workerConfig":{
+                           "numInstances":"5"
+                         }
+                       }
+                     }
+
+                Similarly, to change the number of preemptible workers in a cluster to
+                5, the ``update_mask`` parameter would be
+                ``config.secondary_worker_config.num_instances``, and the ``PATCH``
+                request body would be set as follows:
+
+                ::
+
+                     {
+                       "config":{
+                         "secondaryWorkerConfig":{
+                           "numInstances":"5"
+                         }
+                       }
+                     }
+
+                Note: Currently, only the following fields can be updated:
+
+                .. raw:: html
+
+                     <table>
+                     <tbody>
+                     <tr>
+                     <td><strong>Mask</strong></td>
+                     <td><strong>Purpose</strong></td>
+                     </tr>
+                     <tr>
+                     <td><strong><em>labels</em></strong></td>
+                     <td>Update labels</td>
+                     </tr>
+                     <tr>
+                     <td><strong><em>config.worker_config.num_instances</em></strong></td>
+                     <td>Resize primary worker group</td>
+                     </tr>
+                     <tr>
+                     <td><strong><em>config.secondary_worker_config.num_instances</em></strong></td>
+                     <td>Resize secondary worker group</td>
+                     </tr>
+                     </tbody>
+                     </table>
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.FieldMask`
+            graceful_decommission_timeout (Union[dict, ~google.cloud.dataproc_v1.types.Duration]): 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.
+
+                Only supported on Dataproc image versions 1.2 and higher.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.Duration`
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``UpdateClusterRequest`` requests with the same id, then
+                the second request will be ignored and the first
+                ``google.longrunning.Operation`` created and stored in the backend is
+                returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_cluster,
+                default_retry=self._method_configs["UpdateCluster"].retry,
+                default_timeout=self._method_configs["UpdateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.UpdateClusterRequest(
+            project_id=project_id,
+            region=region,
+            cluster_name=cluster_name,
+            cluster=cluster,
+            update_mask=update_mask,
+            graceful_decommission_timeout=graceful_decommission_timeout,
+            request_id=request_id,
+        )
+        operation = self._inner_api_calls["update_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            clusters_pb2.Cluster,
+            metadata_type=proto_operations_pb2.ClusterOperationMetadata,
+        )
+
+    def delete_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        cluster_uuid=None,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> response = client.delete_cluster(project_id, region, cluster_name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            cluster_uuid (str): Optional. Specifying the ``cluster_uuid`` means the RPC should fail
+                (with error NOT\_FOUND) if cluster with specified UUID does not exist.
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``DeleteClusterRequest`` requests with the same id, then
+                the second request will be ignored and the first
+                ``google.longrunning.Operation`` created and stored in the backend is
+                returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_cluster,
+                default_retry=self._method_configs["DeleteCluster"].retry,
+                default_timeout=self._method_configs["DeleteCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.DeleteClusterRequest(
+            project_id=project_id,
+            region=region,
+            cluster_name=cluster_name,
+            cluster_uuid=cluster_uuid,
+            request_id=request_id,
+        )
+        operation = self._inner_api_calls["delete_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.ClusterOperationMetadata,
+        )
+
+    def get_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the resource representation for a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> response = client.get_cluster(project_id, region, cluster_name)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.Cluster` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_cluster,
+                default_retry=self._method_configs["GetCluster"].retry,
+                default_timeout=self._method_configs["GetCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.GetClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        return self._inner_api_calls["get_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_clusters(
+        self,
+        project_id,
+        region,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all regions/{region}/clusters in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_clusters(project_id, region):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_clusters(project_id, region).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            filter_ (str): Optional. A filter constraining the clusters to list. Filters are
+                case-sensitive and have the following syntax:
+
+                field = value [AND [field = value]] ...
+
+                where **field** is one of ``status.state``, ``clusterName``, or
+                ``labels.[KEY]``, and ``[KEY]`` is a label key. **value** can be ``*``
+                to match all values. ``status.state`` can be one of the following:
+                ``ACTIVE``, ``INACTIVE``, ``CREATING``, ``RUNNING``, ``ERROR``,
+                ``DELETING``, or ``UPDATING``. ``ACTIVE`` contains the ``CREATING``,
+                ``UPDATING``, and ``RUNNING`` states. ``INACTIVE`` contains the
+                ``DELETING`` and ``ERROR`` states. ``clusterName`` is the name of the
+                cluster provided at creation time. Only the logical ``AND`` operator is
+                supported; space-separated items are treated as having an implicit
+                ``AND`` operator.
+
+                Example filter:
+
+                status.state = ACTIVE AND clusterName = mycluster AND labels.env =
+                staging AND labels.starred = \*
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1.types.Cluster` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_clusters" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_clusters"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_clusters,
+                default_retry=self._method_configs["ListClusters"].retry,
+                default_timeout=self._method_configs["ListClusters"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.ListClustersRequest(
+            project_id=project_id, region=region, filter=filter_, page_size=page_size
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_clusters"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="clusters",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def diagnose_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets cluster diagnostic information. After the operation completes, the
+        Operation.response field contains ``DiagnoseClusterOutputLocation``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> response = client.diagnose_cluster(project_id, region, cluster_name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "diagnose_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "diagnose_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.diagnose_cluster,
+                default_retry=self._method_configs["DiagnoseCluster"].retry,
+                default_timeout=self._method_configs["DiagnoseCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.DiagnoseClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        operation = self._inner_api_calls["diagnose_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=clusters_pb2.DiagnoseClusterResults,
+        )
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/cluster_controller_client_config.py b/dataproc/google/cloud/dataproc_v1/gapic/cluster_controller_client_config.py
new file mode 100644
index 000000000000..02c0cb49d099
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/cluster_controller_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1.ClusterController": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 10000,
+                    "total_timeout_millis": 300000,
+                }
+            },
+            "methods": {
+                "CreateCluster": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateCluster": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteCluster": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListClusters": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DiagnoseCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/enums.py b/dataproc/google/cloud/dataproc_v1/gapic/enums.py
new file mode 100644
index 000000000000..e29c9d7fbb26
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/enums.py
@@ -0,0 +1,277 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Component(enum.IntEnum):
+    """
+    Cluster components that can be activated.
+
+    Attributes:
+      COMPONENT_UNSPECIFIED (int): Unspecified component.
+      ANACONDA (int): The Anaconda python distribution.
+      HIVE_WEBHCAT (int): The Hive Web HCatalog (the REST service for accessing HCatalog).
+      JUPYTER (int): The Jupyter Notebook.
+      ZEPPELIN (int): The Zeppelin notebook.
+    """
+
+    COMPONENT_UNSPECIFIED = 0
+    ANACONDA = 5
+    HIVE_WEBHCAT = 3
+    JUPYTER = 1
+    ZEPPELIN = 4
+
+
+class ClusterOperationStatus(object):
+    class State(enum.IntEnum):
+        """
+        The operation state.
+
+        Attributes:
+          UNKNOWN (int): Unused.
+          PENDING (int): The operation has been created.
+          RUNNING (int): The operation is running.
+          DONE (int): The operation is done; either cancelled or completed.
+        """
+
+        UNKNOWN = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+
+
+class ClusterStatus(object):
+    class State(enum.IntEnum):
+        """
+        The cluster state.
+
+        Attributes:
+          UNKNOWN (int): The cluster state is unknown.
+          CREATING (int): The cluster is being created and set up. It is not ready for use.
+          RUNNING (int): The cluster is currently running and healthy. It is ready for use.
+          ERROR (int): The cluster encountered an error. It is not ready for use.
+          DELETING (int): The cluster is being deleted. It cannot be used.
+          UPDATING (int): The cluster is being updated. It continues to accept and process jobs.
+        """
+
+        UNKNOWN = 0
+        CREATING = 1
+        RUNNING = 2
+        ERROR = 3
+        DELETING = 4
+        UPDATING = 5
+
+    class Substate(enum.IntEnum):
+        """
+        The cluster substate.
+
+        Attributes:
+          UNSPECIFIED (int): The cluster substate is unknown.
+          UNHEALTHY (int): The cluster is known to be in an unhealthy state
+          (for example, critical daemons are not running or HDFS capacity is
+          exhausted).
+
+          Applies to RUNNING state.
+          STALE_STATUS (int): The agent-reported status is out of date (may occur if
+          Cloud Dataproc loses communication with Agent).
+
+          Applies to RUNNING state.
+        """
+
+        UNSPECIFIED = 0
+        UNHEALTHY = 1
+        STALE_STATUS = 2
+
+
+class JobStatus(object):
+    class State(enum.IntEnum):
+        """
+        The job state.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): The job state is unknown.
+          PENDING (int): The job is pending; it has been submitted, but is not yet running.
+          SETUP_DONE (int): Job has been received by the service and completed initial setup;
+          it will soon be submitted to the cluster.
+          RUNNING (int): The job is running on the cluster.
+          CANCEL_PENDING (int): A CancelJob request has been received, but is pending.
+          CANCEL_STARTED (int): Transient in-flight resources have been canceled, and the request to
+          cancel the running job has been issued to the cluster.
+          CANCELLED (int): The job cancellation was successful.
+          DONE (int): The job has completed successfully.
+          ERROR (int): The job has completed, but encountered an error.
+          ATTEMPT_FAILURE (int): Job attempt has failed. The detail field contains failure details for
+          this attempt.
+
+          Applies to restartable jobs only.
+        """
+
+        STATE_UNSPECIFIED = 0
+        PENDING = 1
+        SETUP_DONE = 8
+        RUNNING = 2
+        CANCEL_PENDING = 3
+        CANCEL_STARTED = 7
+        CANCELLED = 4
+        DONE = 5
+        ERROR = 6
+        ATTEMPT_FAILURE = 9
+
+    class Substate(enum.IntEnum):
+        """
+        The job substate.
+
+        Attributes:
+          UNSPECIFIED (int): The job substate is unknown.
+          SUBMITTED (int): The Job is submitted to the agent.
+
+          Applies to RUNNING state.
+          QUEUED (int): The Job has been received and is awaiting execution (it may be waiting
+          for a condition to be met). See the "details" field for the reason for
+          the delay.
+
+          Applies to RUNNING state.
+          STALE_STATUS (int): 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
+          agent does not send a timely update, the job will fail.
+
+          Applies to RUNNING state.
+        """
+
+        UNSPECIFIED = 0
+        SUBMITTED = 1
+        QUEUED = 2
+        STALE_STATUS = 3
+
+
+class ListJobsRequest(object):
+    class JobStateMatcher(enum.IntEnum):
+        """
+        A matcher that specifies categories of job states.
+
+        Attributes:
+          ALL (int): Match all jobs, regardless of state.
+          ACTIVE (int): Only match jobs in non-terminal states: PENDING, RUNNING, or
+          CANCEL\_PENDING.
+          NON_ACTIVE (int): Only match jobs in terminal states: CANCELLED, DONE, or ERROR.
+        """
+
+        ALL = 0
+        ACTIVE = 1
+        NON_ACTIVE = 2
+
+
+class LoggingConfig(object):
+    class Level(enum.IntEnum):
+        """
+        The Log4j level for job execution. When running an `Apache
+        Hive <http://hive.apache.org/>`__ job, Cloud Dataproc configures the
+        Hive client to an equivalent verbosity level.
+
+        Attributes:
+          LEVEL_UNSPECIFIED (int): Level is unspecified. Use default level for log4j.
+          ALL (int): Use ALL level for log4j.
+          TRACE (int): Use TRACE level for log4j.
+          DEBUG (int): Use DEBUG level for log4j.
+          INFO (int): Use INFO level for log4j.
+          WARN (int): Use WARN level for log4j.
+          ERROR (int): Use ERROR level for log4j.
+          FATAL (int): Use FATAL level for log4j.
+          OFF (int): Turn off log4j.
+        """
+
+        LEVEL_UNSPECIFIED = 0
+        ALL = 1
+        TRACE = 2
+        DEBUG = 3
+        INFO = 4
+        WARN = 5
+        ERROR = 6
+        FATAL = 7
+        OFF = 8
+
+
+class WorkflowMetadata(object):
+    class State(enum.IntEnum):
+        """
+        The operation state.
+
+        Attributes:
+          UNKNOWN (int): Unused.
+          PENDING (int): The operation has been created.
+          RUNNING (int): The operation is running.
+          DONE (int): The operation is done; either cancelled or completed.
+        """
+
+        UNKNOWN = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+
+
+class WorkflowNode(object):
+    class NodeState(enum.IntEnum):
+        """
+        The workflow node state.
+
+        Attributes:
+          NODE_STATE_UNSPECIFIED (int): State is unspecified.
+          BLOCKED (int): The node is awaiting prerequisite node to finish.
+          RUNNABLE (int): The node is runnable but not running.
+          RUNNING (int): The node is running.
+          COMPLETED (int): The node completed successfully.
+          FAILED (int): The node failed. A node can be marked FAILED because
+          its ancestor or peer failed.
+        """
+
+        NODE_STATE_UNSPECIFIED = 0
+        BLOCKED = 1
+        RUNNABLE = 2
+        RUNNING = 3
+        COMPLETED = 4
+        FAILED = 5
+
+
+class YarnApplication(object):
+    class State(enum.IntEnum):
+        """
+        The application state, corresponding to
+        <code>YarnProtos.YarnApplicationStateProto</code>.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Status is unspecified.
+          NEW (int): Status is NEW.
+          NEW_SAVING (int): Status is NEW\_SAVING.
+          SUBMITTED (int): Status is SUBMITTED.
+          ACCEPTED (int): Status is ACCEPTED.
+          RUNNING (int): Status is RUNNING.
+          FINISHED (int): Status is FINISHED.
+          FAILED (int): Status is FAILED.
+          KILLED (int): Status is KILLED.
+        """
+
+        STATE_UNSPECIFIED = 0
+        NEW = 1
+        NEW_SAVING = 2
+        SUBMITTED = 3
+        ACCEPTED = 4
+        RUNNING = 5
+        FINISHED = 6
+        FAILED = 7
+        KILLED = 8
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/job_controller_client.py b/dataproc/google/cloud/dataproc_v1/gapic/job_controller_client.py
new file mode 100644
index 000000000000..6bf8c7d76275
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/job_controller_client.py
@@ -0,0 +1,705 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1 JobController API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import grpc
+
+from google.cloud.dataproc_v1.gapic import enums
+from google.cloud.dataproc_v1.gapic import job_controller_client_config
+from google.cloud.dataproc_v1.gapic.transports import job_controller_grpc_transport
+from google.cloud.dataproc_v1.proto import clusters_pb2
+from google.cloud.dataproc_v1.proto import clusters_pb2_grpc
+from google.cloud.dataproc_v1.proto import jobs_pb2
+from google.cloud.dataproc_v1.proto import jobs_pb2_grpc
+from google.cloud.dataproc_v1.proto import operations_pb2 as proto_operations_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class JobControllerClient(object):
+    """The JobController provides methods to manage jobs."""
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1.JobController"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            JobControllerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.JobControllerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.JobControllerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = job_controller_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=job_controller_grpc_transport.JobControllerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = job_controller_grpc_transport.JobControllerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def submit_job(
+        self,
+        project_id,
+        region,
+        job,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Submits a job to a cluster.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.submit_job(project_id, region, job)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job (Union[dict, ~google.cloud.dataproc_v1.types.Job]): Required. The job resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.Job`
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``SubmitJobRequest`` requests with the same id, then the
+                second request will be ignored and the first ``Job`` created and stored
+                in the backend is returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "submit_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "submit_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.submit_job,
+                default_retry=self._method_configs["SubmitJob"].retry,
+                default_timeout=self._method_configs["SubmitJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.SubmitJobRequest(
+            project_id=project_id, region=region, job=job, request_id=request_id
+        )
+        return self._inner_api_calls["submit_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the resource representation for a job in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> response = client.get_job(project_id, region, job_id)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_job,
+                default_retry=self._method_configs["GetJob"].retry,
+                default_timeout=self._method_configs["GetJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.GetJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        return self._inner_api_calls["get_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_jobs(
+        self,
+        project_id,
+        region,
+        page_size=None,
+        cluster_name=None,
+        job_state_matcher=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists regions/{region}/jobs in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_jobs(project_id, region):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_jobs(project_id, region).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            cluster_name (str): Optional. If set, the returned jobs list includes only jobs that were
+                submitted to the named cluster.
+            job_state_matcher (~google.cloud.dataproc_v1.types.JobStateMatcher): Optional. Specifies enumerated categories of jobs to list. (default =
+                match ALL jobs).
+
+                If ``filter`` is provided, ``jobStateMatcher`` will be ignored.
+            filter_ (str): Optional. A filter constraining the jobs to list. Filters are
+                case-sensitive and have the following syntax:
+
+                [field = value] AND [field [= value]] ...
+
+                where **field** is ``status.state`` or ``labels.[KEY]``, and ``[KEY]``
+                is a label key. **value** can be ``*`` to match all values.
+                ``status.state`` can be either ``ACTIVE`` or ``NON_ACTIVE``. Only the
+                logical ``AND`` operator is supported; space-separated items are treated
+                as having an implicit ``AND`` operator.
+
+                Example filter:
+
+                status.state = ACTIVE AND labels.env = staging AND labels.starred = \*
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1.types.Job` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_jobs,
+                default_retry=self._method_configs["ListJobs"].retry,
+                default_timeout=self._method_configs["ListJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.ListJobsRequest(
+            project_id=project_id,
+            region=region,
+            page_size=page_size,
+            cluster_name=cluster_name,
+            job_state_matcher=job_state_matcher,
+            filter=filter_,
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        job,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a job in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_job(project_id, region, job_id, job, update_mask)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            job (Union[dict, ~google.cloud.dataproc_v1.types.Job]): Required. The changes to the job.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.Job`
+            update_mask (Union[dict, ~google.cloud.dataproc_v1.types.FieldMask]): Required. Specifies the path, relative to Job, of the field to update.
+                For example, to update the labels of a Job the update\_mask parameter
+                would be specified as labels, and the ``PATCH`` request body would
+                specify the new value. Note: Currently, labels is the only field that
+                can be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_job,
+                default_retry=self._method_configs["UpdateJob"].retry,
+                default_timeout=self._method_configs["UpdateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.UpdateJobRequest(
+            project_id=project_id,
+            region=region,
+            job_id=job_id,
+            job=job,
+            update_mask=update_mask,
+        )
+        return self._inner_api_calls["update_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a job cancellation request. To access the job resource after
+        cancellation, call
+        `regions/{region}/jobs.list <https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/list>`__
+        or
+        `regions/{region}/jobs.get <https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/get>`__.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> response = client.cancel_job(project_id, region, job_id)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_job,
+                default_retry=self._method_configs["CancelJob"].retry,
+                default_timeout=self._method_configs["CancelJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.CancelJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        return self._inner_api_calls["cancel_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the job from the project. If the job is active, the delete
+        fails, and the response returns ``FAILED_PRECONDITION``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> client.delete_job(project_id, region, job_id)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_job,
+                default_retry=self._method_configs["DeleteJob"].retry,
+                default_timeout=self._method_configs["DeleteJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.DeleteJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        self._inner_api_calls["delete_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/job_controller_client_config.py b/dataproc/google/cloud/dataproc_v1/gapic/job_controller_client_config.py
new file mode 100644
index 000000000000..7cc7eaba38df
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/job_controller_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1.JobController": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 30000,
+                    "total_timeout_millis": 900000,
+                }
+            },
+            "methods": {
+                "SubmitJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListJobs": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/transports/__init__.py b/dataproc/google/cloud/dataproc_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/transports/cluster_controller_grpc_transport.py b/dataproc/google/cloud/dataproc_v1/gapic/transports/cluster_controller_grpc_transport.py
new file mode 100644
index 000000000000..b3c8b7d50f64
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/transports/cluster_controller_grpc_transport.py
@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.dataproc_v1.proto import clusters_pb2_grpc
+
+
+class ClusterControllerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1 ClusterController API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "cluster_controller_stub": clusters_pb2_grpc.ClusterControllerStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.create_cluster`.
+
+        Creates a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].CreateCluster
+
+    @property
+    def update_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.update_cluster`.
+
+        Updates a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].UpdateCluster
+
+    @property
+    def delete_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.delete_cluster`.
+
+        Deletes a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].DeleteCluster
+
+    @property
+    def get_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.get_cluster`.
+
+        Gets the resource representation for a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].GetCluster
+
+    @property
+    def list_clusters(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.list_clusters`.
+
+        Lists all regions/{region}/clusters in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].ListClusters
+
+    @property
+    def diagnose_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.diagnose_cluster`.
+
+        Gets cluster diagnostic information. After the operation completes, the
+        Operation.response field contains ``DiagnoseClusterOutputLocation``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].DiagnoseCluster
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/transports/job_controller_grpc_transport.py b/dataproc/google/cloud/dataproc_v1/gapic/transports/job_controller_grpc_transport.py
new file mode 100644
index 000000000000..e1fc88fb22ac
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/transports/job_controller_grpc_transport.py
@@ -0,0 +1,189 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.dataproc_v1.proto import jobs_pb2_grpc
+
+
+class JobControllerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1 JobController API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"job_controller_stub": jobs_pb2_grpc.JobControllerStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def submit_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.submit_job`.
+
+        Submits a job to a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].SubmitJob
+
+    @property
+    def get_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.get_job`.
+
+        Gets the resource representation for a job in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].GetJob
+
+    @property
+    def list_jobs(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.list_jobs`.
+
+        Lists regions/{region}/jobs in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].ListJobs
+
+    @property
+    def update_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.update_job`.
+
+        Updates a job in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].UpdateJob
+
+    @property
+    def cancel_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.cancel_job`.
+
+        Starts a job cancellation request. To access the job resource after
+        cancellation, call
+        `regions/{region}/jobs.list <https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/list>`__
+        or
+        `regions/{region}/jobs.get <https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/get>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].CancelJob
+
+    @property
+    def delete_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.delete_job`.
+
+        Deletes the job from the project. If the job is active, the delete
+        fails, and the response returns ``FAILED_PRECONDITION``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].DeleteJob
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/transports/workflow_template_service_grpc_transport.py b/dataproc/google/cloud/dataproc_v1/gapic/transports/workflow_template_service_grpc_transport.py
new file mode 100644
index 000000000000..73955041c6fb
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/transports/workflow_template_service_grpc_transport.py
@@ -0,0 +1,243 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.dataproc_v1.proto import workflow_templates_pb2_grpc
+
+
+class WorkflowTemplateServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1 WorkflowTemplateService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "workflow_template_service_stub": workflow_templates_pb2_grpc.WorkflowTemplateServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.create_workflow_template`.
+
+        Creates new workflow template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].CreateWorkflowTemplate
+
+    @property
+    def get_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.get_workflow_template`.
+
+        Retrieves the latest workflow template.
+
+        Can retrieve previously instantiated template by specifying optional
+        version parameter.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].GetWorkflowTemplate
+
+    @property
+    def instantiate_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.instantiate_workflow_template`.
+
+        Instantiates a template and begins execution.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].InstantiateWorkflowTemplate
+
+    @property
+    def instantiate_inline_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.instantiate_inline_workflow_template`.
+
+        Instantiates a template and begins execution.
+
+        This method is equivalent to executing the sequence
+        ``CreateWorkflowTemplate``, ``InstantiateWorkflowTemplate``,
+        ``DeleteWorkflowTemplate``.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "workflow_template_service_stub"
+        ].InstantiateInlineWorkflowTemplate
+
+    @property
+    def update_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.update_workflow_template`.
+
+        Updates (replaces) workflow template. The updated template
+        must contain version that matches the current server version.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].UpdateWorkflowTemplate
+
+    @property
+    def list_workflow_templates(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.list_workflow_templates`.
+
+        Lists workflows that match the specified filter in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].ListWorkflowTemplates
+
+    @property
+    def delete_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.delete_workflow_template`.
+
+        Deletes a workflow template. It does not cancel in-progress workflows.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].DeleteWorkflowTemplate
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/workflow_template_service_client.py b/dataproc/google/cloud/dataproc_v1/gapic/workflow_template_service_client.py
new file mode 100644
index 000000000000..b3b38728fc47
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/workflow_template_service_client.py
@@ -0,0 +1,885 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1 WorkflowTemplateService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.dataproc_v1.gapic import enums
+from google.cloud.dataproc_v1.gapic import workflow_template_service_client_config
+from google.cloud.dataproc_v1.gapic.transports import (
+    workflow_template_service_grpc_transport,
+)
+from google.cloud.dataproc_v1.proto import clusters_pb2
+from google.cloud.dataproc_v1.proto import clusters_pb2_grpc
+from google.cloud.dataproc_v1.proto import jobs_pb2
+from google.cloud.dataproc_v1.proto import jobs_pb2_grpc
+from google.cloud.dataproc_v1.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.dataproc_v1.proto import workflow_templates_pb2
+from google.cloud.dataproc_v1.proto import workflow_templates_pb2_grpc
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class WorkflowTemplateServiceClient(object):
+    """
+    The API interface for managing Workflow Templates in the
+    Cloud Dataproc API.
+    """
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1.WorkflowTemplateService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            WorkflowTemplateServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def region_path(cls, project, region):
+        """Return a fully-qualified region string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/regions/{region}", project=project, region=region
+        )
+
+    @classmethod
+    def workflow_template_path(cls, project, region, workflow_template):
+        """Return a fully-qualified workflow_template string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/regions/{region}/workflowTemplates/{workflow_template}",
+            project=project,
+            region=region,
+            workflow_template=workflow_template,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.WorkflowTemplateServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.WorkflowTemplateServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = workflow_template_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=workflow_template_service_grpc_transport.WorkflowTemplateServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = workflow_template_service_grpc_transport.WorkflowTemplateServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_workflow_template(
+        self,
+        parent,
+        template,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates new workflow template.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # TODO: Initialize `template`:
+            >>> template = {}
+            >>>
+            >>> response = client.create_workflow_template(parent, template)
+
+        Args:
+            parent (str): 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}``
+            template (Union[dict, ~google.cloud.dataproc_v1.types.WorkflowTemplate]): Required. The Dataproc workflow template to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_workflow_template,
+                default_retry=self._method_configs["CreateWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["CreateWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.CreateWorkflowTemplateRequest(
+            parent=parent, template=template
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_workflow_template(
+        self,
+        name,
+        version=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves the latest workflow template.
+
+        Can retrieve previously instantiated template by specifying optional
+        version parameter.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> name = client.workflow_template_path('[PROJECT]', '[REGION]', '[WORKFLOW_TEMPLATE]')
+            >>>
+            >>> response = client.get_workflow_template(name)
+
+        Args:
+            name (str): 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}``
+            version (int): Optional. The version of workflow template to retrieve. Only previously
+                instatiated versions can be retrieved.
+
+                If unspecified, retrieves the current version.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_workflow_template,
+                default_retry=self._method_configs["GetWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["GetWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.GetWorkflowTemplateRequest(
+            name=name, version=version
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def instantiate_workflow_template(
+        self,
+        name,
+        version=None,
+        request_id=None,
+        parameters=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Instantiates a template and begins execution.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> name = client.workflow_template_path('[PROJECT]', '[REGION]', '[WORKFLOW_TEMPLATE]')
+            >>>
+            >>> response = client.instantiate_workflow_template(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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}``
+            version (int): Optional. The version of workflow template to instantiate. If specified,
+                the workflow will be instantiated only if the current version of
+                the workflow template has the supplied version.
+
+                This option cannot be used to instantiate a previous version of
+                workflow template.
+            request_id (str): Optional. A tag that prevents multiple concurrent workflow instances
+                with the same tag from running. This mitigates risk of concurrent
+                instances started due to retries.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The tag must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            parameters (dict[str -> str]): Optional. Map from parameter names to values that should be used for those
+                parameters. Values may not exceed 100 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "instantiate_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "instantiate_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.instantiate_workflow_template,
+                default_retry=self._method_configs["InstantiateWorkflowTemplate"].retry,
+                default_timeout=self._method_configs[
+                    "InstantiateWorkflowTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.InstantiateWorkflowTemplateRequest(
+            name=name, version=version, request_id=request_id, parameters=parameters
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["instantiate_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=workflow_templates_pb2.WorkflowMetadata,
+        )
+
+    def instantiate_inline_workflow_template(
+        self,
+        parent,
+        template,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Instantiates a template and begins execution.
+
+        This method is equivalent to executing the sequence
+        ``CreateWorkflowTemplate``, ``InstantiateWorkflowTemplate``,
+        ``DeleteWorkflowTemplate``.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # TODO: Initialize `template`:
+            >>> template = {}
+            >>>
+            >>> response = client.instantiate_inline_workflow_template(parent, template)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): 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}``
+            template (Union[dict, ~google.cloud.dataproc_v1.types.WorkflowTemplate]): Required. The workflow template to instantiate.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate`
+            request_id (str): Optional. A tag that prevents multiple concurrent workflow instances
+                with the same tag from running. This mitigates risk of concurrent
+                instances started due to retries.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The tag must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "instantiate_inline_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "instantiate_inline_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.instantiate_inline_workflow_template,
+                default_retry=self._method_configs[
+                    "InstantiateInlineWorkflowTemplate"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "InstantiateInlineWorkflowTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.InstantiateInlineWorkflowTemplateRequest(
+            parent=parent, template=template, request_id=request_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["instantiate_inline_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=workflow_templates_pb2.WorkflowMetadata,
+        )
+
+    def update_workflow_template(
+        self,
+        template,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates (replaces) workflow template. The updated template
+        must contain version that matches the current server version.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> # TODO: Initialize `template`:
+            >>> template = {}
+            >>>
+            >>> response = client.update_workflow_template(template)
+
+        Args:
+            template (Union[dict, ~google.cloud.dataproc_v1.types.WorkflowTemplate]): Required. The updated workflow template.
+
+                The ``template.version`` field must match the current version.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_workflow_template,
+                default_retry=self._method_configs["UpdateWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["UpdateWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.UpdateWorkflowTemplateRequest(
+            template=template
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("template.name", template.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_workflow_templates(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists workflows that match the specified filter in the request.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_workflow_templates(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_workflow_templates(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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}``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1.types.WorkflowTemplate` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_workflow_templates" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_workflow_templates"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_workflow_templates,
+                default_retry=self._method_configs["ListWorkflowTemplates"].retry,
+                default_timeout=self._method_configs["ListWorkflowTemplates"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.ListWorkflowTemplatesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_workflow_templates"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="templates",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_workflow_template(
+        self,
+        name,
+        version=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a workflow template. It does not cancel in-progress workflows.
+
+        Example:
+            >>> from google.cloud import dataproc_v1
+            >>>
+            >>> client = dataproc_v1.WorkflowTemplateServiceClient()
+            >>>
+            >>> name = client.workflow_template_path('[PROJECT]', '[REGION]', '[WORKFLOW_TEMPLATE]')
+            >>>
+            >>> client.delete_workflow_template(name)
+
+        Args:
+            name (str): 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}``
+            version (int): Optional. The version of workflow template to delete. If specified,
+                will only delete the template if the current server version matches
+                specified version.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_workflow_template,
+                default_retry=self._method_configs["DeleteWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["DeleteWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.DeleteWorkflowTemplateRequest(
+            name=name, version=version
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/dataproc/google/cloud/dataproc_v1/gapic/workflow_template_service_client_config.py b/dataproc/google/cloud/dataproc_v1/gapic/workflow_template_service_client_config.py
new file mode 100644
index 000000000000..65b6260b5801
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/gapic/workflow_template_service_client_config.py
@@ -0,0 +1,58 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1.WorkflowTemplateService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateWorkflowTemplate": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "InstantiateWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "InstantiateInlineWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListWorkflowTemplates": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1/proto/__init__.py b/dataproc/google/cloud/dataproc_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dataproc/google/cloud/dataproc_v1/proto/clusters.proto b/dataproc/google/cloud/dataproc_v1/proto/clusters.proto
new file mode 100644
index 000000000000..ab2cc2d02557
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/clusters.proto
@@ -0,0 +1,713 @@
+// 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.dataproc.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/dataproc/v1/operations.proto";
+import "google/cloud/dataproc/v1/shared.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc";
+option java_multiple_files = true;
+option java_outer_classname = "ClustersProto";
+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.
+  rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}/regions/{region}/clusters"
+      body: "cluster"
+    };
+  }
+
+  // Updates a cluster in a project.
+  rpc UpdateCluster(UpdateClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+      body: "cluster"
+    };
+  }
+
+  // Deletes a cluster in a project.
+  rpc DeleteCluster(DeleteClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+    };
+  }
+
+  // Gets the resource representation for a cluster in a project.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = {
+      get: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+    };
+  }
+
+  // Lists all regions/{region}/clusters in a project.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = {
+      get: "/v1/projects/{project_id}/regions/{region}/clusters"
+    };
+  }
+
+  // Gets cluster diagnostic information.
+  // After the operation completes, the Operation.response field
+  // contains `DiagnoseClusterOutputLocation`.
+  rpc DiagnoseCluster(DiagnoseClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose"
+      body: "*"
+    };
+  }
+}
+
+// Describes the identifying information, config, and status of
+// a cluster of Compute Engine instances.
+message Cluster {
+  // Required. The Google Cloud Platform project ID that the cluster belongs to.
+  string project_id = 1;
+
+  // Required. The cluster name. Cluster names within a project must be
+  // unique. Names of deleted clusters can be reused.
+  string cluster_name = 2;
+
+  // Required. The cluster config. Note that Cloud Dataproc may set
+  // default values, and values may change when clusters are updated.
+  ClusterConfig config = 3;
+
+  // Optional. The labels to associate with this cluster.
+  // Label **keys** must contain 1 to 63 characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  // Label **values** may be empty, but, if present, must contain 1 to 63
+  // 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<string, string> labels = 8;
+
+  // Output only. Cluster status.
+  ClusterStatus status = 4;
+
+  // Output only. The previous cluster status.
+  repeated ClusterStatus status_history = 7;
+
+  // Output only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc
+  // generates this value when it creates the cluster.
+  string cluster_uuid = 6;
+
+  // 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;
+}
+
+// The cluster config.
+message ClusterConfig {
+  // Optional. A Google 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
+  // 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;
+
+  // Optional. The shared Compute Engine config settings for
+  // all instances in a cluster.
+  GceClusterConfig gce_cluster_config = 8;
+
+  // Optional. The Compute Engine config settings for
+  // the master instance in a cluster.
+  InstanceGroupConfig master_config = 9;
+
+  // Optional. The Compute Engine config settings for
+  // worker instances in a cluster.
+  InstanceGroupConfig worker_config = 10;
+
+  // Optional. The Compute Engine config settings for
+  // additional worker instances in a cluster.
+  InstanceGroupConfig secondary_worker_config = 12;
+
+  // Optional. The config settings for software inside the cluster.
+  SoftwareConfig software_config = 13;
+
+  // Optional. Commands to execute on each node after config is
+  // completed. By default, executables are run on master and all worker nodes.
+  // You can test a node's `role` metadata to run an executable on
+  // a master or worker node, as shown below using `curl` (you can also use
+  // `wget`):
+  //
+  //     ROLE=$(curl -H Metadata-Flavor:Google
+  //     http://metadata/computeMetadata/v1/instance/attributes/dataproc-role)
+  //     if [[ "${ROLE}" == 'Master' ]]; then
+  //       ... master specific actions ...
+  //     else
+  //       ... worker specific actions ...
+  //     fi
+  repeated NodeInitializationAction initialization_actions = 11;
+
+  // Optional. Encryption settings for the cluster.
+  EncryptionConfig encryption_config = 15;
+}
+
+// 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;
+}
+
+// Common config settings for resources of Compute Engine cluster
+// instances, applicable to all instances in the cluster.
+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
+  // corresponding Compute Engine region. On a get request, zone will
+  // always be present.
+  //
+  // A full URL, partial URI, or short name are valid. Examples:
+  //
+  // * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`
+  // * `projects/[project_id]/zones/[zone]`
+  // * `us-central1-f`
+  string zone_uri = 1;
+
+  // 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).
+  //
+  // 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;
+
+  // Optional. The Compute Engine subnetwork to be used for machine
+  // communications. Cannot be specified with network_uri.
+  //
+  // A full URL, partial URI, or short name are valid. Examples:
+  //
+  // * `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;
+
+  // Optional. If true, all instances in the cluster will only have internal IP
+  // addresses. By default, clusters are not restricted to internal IP
+  // addresses, and will have ephemeral external IP addresses assigned to each
+  // 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;
+
+  // 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:
+  //
+  // * 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;
+
+  // Optional. The URIs of service account scopes to be included in
+  // Compute Engine instances. The following base set of scopes is always
+  // included:
+  //
+  // * https://www.googleapis.com/auth/cloud.useraccounts.readonly
+  // * https://www.googleapis.com/auth/devstorage.read_write
+  // * https://www.googleapis.com/auth/logging.write
+  //
+  // If no scopes are specified, the following defaults are also provided:
+  //
+  // * https://www.googleapis.com/auth/bigquery
+  // * 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;
+
+  // The Compute Engine tags to add to all instances (see
+  // [Tagging instances](/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<string, string> metadata = 5;
+}
+
+// Optional. 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;
+
+  // Output only. The list of instance names. Cloud Dataproc derives the names
+  // from `cluster_name`, `num_instances`, and the instance group.
+  repeated string instance_names = 2;
+
+  // 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 machine type used for cluster instances.
+  //
+  // A full URL, partial URI, or short name are valid. Examples:
+  //
+  // * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`
+  // * `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
+  // Placement](/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;
+
+  // Optional. Disk option config settings.
+  DiskConfig disk_config = 5;
+
+  // Optional. Specifies that this instance group contains preemptible
+  // instances.
+  bool is_preemptible = 6;
+
+  // 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;
+
+  // 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;
+}
+
+// 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;
+
+  // Output only. The name of the Instance Group Manager for this group.
+  string instance_group_manager_name = 2;
+}
+
+// Specifies the type and number of accelerator cards attached to the instances
+// of an instance. See [GPUs on Compute Engine](/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).
+  //
+  // 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
+  // Placement](/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;
+
+  // The number of the accelerator cards of this type exposed to this instance.
+  int32 accelerator_count = 2;
+}
+
+// Specifies the config of disk options for a group of VM instances.
+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;
+
+  // Optional. Size in GB of the boot disk (default is 500GB).
+  int32 boot_disk_size_gb = 1;
+
+  // 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
+  // [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data.
+  // 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;
+}
+
+// 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;
+
+  // Optional. Amount of time executable has to complete. Default is
+  // 10 minutes. 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;
+}
+
+// The status of a cluster and its instances.
+message ClusterStatus {
+  // The cluster state.
+  enum State {
+    // The cluster state is unknown.
+    UNKNOWN = 0;
+
+    // The cluster is being created and set up. It is not ready for use.
+    CREATING = 1;
+
+    // The cluster is currently running and healthy. It is ready for use.
+    RUNNING = 2;
+
+    // The cluster encountered an error. It is not ready for use.
+    ERROR = 3;
+
+    // The cluster is being deleted. It cannot be used.
+    DELETING = 4;
+
+    // The cluster is being updated. It continues to accept and process jobs.
+    UPDATING = 5;
+  }
+
+  // The cluster substate.
+  enum Substate {
+    // The cluster substate is unknown.
+    UNSPECIFIED = 0;
+
+    // The cluster is known to be in an unhealthy state
+    // (for example, critical daemons are not running or HDFS capacity is
+    // exhausted).
+    //
+    // Applies to RUNNING state.
+    UNHEALTHY = 1;
+
+    // The agent-reported status is out of date (may occur if
+    // Cloud Dataproc loses communication with Agent).
+    //
+    // Applies to RUNNING state.
+    STALE_STATUS = 2;
+  }
+
+  // Output only. The cluster's state.
+  State state = 1;
+
+  // Output only. Optional details of cluster's state.
+  string detail = 2;
+
+  // Output only. Time when this state was entered.
+  google.protobuf.Timestamp state_start_time = 3;
+
+  // Output only. Additional state information that includes
+  // status reported by the agent.
+  Substate substate = 4;
+}
+
+// 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),
+  // 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).
+  // If unspecified, it defaults to the latest Debian version.
+  string image_version = 1;
+
+  // Optional. The properties to set on daemon config files.
+  //
+  // Property keys are specified in `prefix:property` format, for example
+  // `core:hadoop.tmp.dir`. The following are supported prefixes
+  // and their mappings:
+  //
+  // * capacity-scheduler: `capacity-scheduler.xml`
+  // * core:   `core-site.xml`
+  // * distcp: `distcp-default.xml`
+  // * hdfs:   `hdfs-site.xml`
+  // * hive:   `hive-site.xml`
+  // * mapred: `mapred-site.xml`
+  // * pig:    `pig.properties`
+  // * spark:  `spark-defaults.conf`
+  // * yarn:   `yarn-site.xml`
+  //
+  // For more information, see
+  // [Cluster properties](/dataproc/docs/concepts/cluster-properties).
+  map<string, string> properties = 2;
+
+  // The set of optional components to activate on the cluster.
+  repeated Component optional_components = 3;
+}
+
+// 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.
+message ClusterMetrics {
+  // The HDFS metrics.
+  map<string, int64> hdfs_metrics = 1;
+
+  // The YARN metrics.
+  map<string, int64> yarn_metrics = 2;
+}
+
+// A request to create a cluster.
+message CreateClusterRequest {
+  // Required. The ID of the Google Cloud Platform project that the cluster
+  // belongs to.
+  string project_id = 1;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster to create.
+  Cluster cluster = 2;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [CreateClusterRequest][google.cloud.dataproc.v1.CreateClusterRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the backend
+  // is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 5;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+
+  // Required. The changes to the cluster.
+  Cluster cluster = 3;
+
+  // 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.
+  //
+  // Only supported on Dataproc image versions 1.2 and higher.
+  google.protobuf.Duration graceful_decommission_timeout = 6;
+
+  // Required. Specifies the path, relative to `Cluster`, of
+  // the field to update. For example, to change the number of workers
+  // in a cluster to 5, the `update_mask` parameter would be
+  // specified as `config.worker_config.num_instances`,
+  // and the `PATCH` request body would specify the new value, as follows:
+  //
+  //     {
+  //       "config":{
+  //         "workerConfig":{
+  //           "numInstances":"5"
+  //         }
+  //       }
+  //     }
+  // Similarly, to change the number of preemptible workers in a cluster to 5,
+  // the `update_mask` parameter would be
+  // `config.secondary_worker_config.num_instances`, and the `PATCH` request
+  // body would be set as follows:
+  //
+  //     {
+  //       "config":{
+  //         "secondaryWorkerConfig":{
+  //           "numInstances":"5"
+  //         }
+  //       }
+  //     }
+  // <strong>Note:</strong> Currently, only the following fields can be updated:
+  //
+  //  <table>
+  //  <tbody>
+  //  <tr>
+  //  <td><strong>Mask</strong></td>
+  //  <td><strong>Purpose</strong></td>
+  //  </tr>
+  //  <tr>
+  //  <td><strong><em>labels</em></strong></td>
+  //  <td>Update labels</td>
+  //  </tr>
+  //  <tr>
+  //  <td><strong><em>config.worker_config.num_instances</em></strong></td>
+  //  <td>Resize primary worker group</td>
+  //  </tr>
+  //  <tr>
+  //  <td><strong><em>config.secondary_worker_config.num_instances</em></strong></td>
+  //  <td>Resize secondary worker group</td>
+  //  </tr>
+  //  </tbody>
+  //  </table>
+  google.protobuf.FieldMask update_mask = 4;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [UpdateClusterRequest][google.cloud.dataproc.v1.UpdateClusterRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
+  // backend is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+
+  // 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;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [DeleteClusterRequest][google.cloud.dataproc.v1.DeleteClusterRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
+  // backend is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 4;
+
+  // Optional. A filter constraining the clusters to list. Filters are
+  // case-sensitive and have the following syntax:
+  //
+  // field = value [AND [field = value]] ...
+  //
+  // where **field** is one of `status.state`, `clusterName`, or `labels.[KEY]`,
+  // and `[KEY]` is a label key. **value** can be `*` to match all values.
+  // `status.state` can be one of the following: `ACTIVE`, `INACTIVE`,
+  // `CREATING`, `RUNNING`, `ERROR`, `DELETING`, or `UPDATING`. `ACTIVE`
+  // contains the `CREATING`, `UPDATING`, and `RUNNING` states. `INACTIVE`
+  // contains the `DELETING` and `ERROR` states.
+  // `clusterName` is the name of the cluster provided at creation time.
+  // Only the logical `AND` operator is supported; space-separated items are
+  // treated as having an implicit `AND` operator.
+  //
+  // Example filter:
+  //
+  // status.state = ACTIVE AND clusterName = mycluster
+  // AND labels.env = staging AND labels.starred = *
+  string filter = 5;
+
+  // Optional. The standard List page size.
+  int32 page_size = 2;
+
+  // Optional. The standard List page token.
+  string page_token = 3;
+}
+
+// The list of all clusters in a project.
+message ListClustersResponse {
+  // Output only. The clusters in the project.
+  repeated Cluster clusters = 1;
+
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+}
+
+// The location of diagnostic output.
+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;
+}
diff --git a/dataproc/google/cloud/dataproc_v1/proto/clusters_pb2.py b/dataproc/google/cloud/dataproc_v1/proto/clusters_pb2.py
new file mode 100644
index 000000000000..a5f3e98dd301
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/clusters_pb2.py
@@ -0,0 +1,3231 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1/proto/clusters.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.dataproc_v1.proto import (
+    operations_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_operations__pb2,
+)
+from google.cloud.dataproc_v1.proto import (
+    shared_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_shared__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1/proto/clusters.proto",
+    package="google.cloud.dataproc.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.dataproc.v1B\rClustersProtoP\001Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/dataproc_v1/proto/clusters.proto\x12\x18google.cloud.dataproc.v1\x1a\x1cgoogle/api/annotations.proto\x1a/google/cloud/dataproc_v1/proto/operations.proto\x1a+google/cloud/dataproc_v1/proto/shared.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xa5\x03\n\x07\x43luster\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x37\n\x06\x63onfig\x18\x03 \x01(\x0b\x32\'.google.cloud.dataproc.v1.ClusterConfig\x12=\n\x06labels\x18\x08 \x03(\x0b\x32-.google.cloud.dataproc.v1.Cluster.LabelsEntry\x12\x37\n\x06status\x18\x04 \x01(\x0b\x32\'.google.cloud.dataproc.v1.ClusterStatus\x12?\n\x0estatus_history\x18\x07 \x03(\x0b\x32\'.google.cloud.dataproc.v1.ClusterStatus\x12\x14\n\x0c\x63luster_uuid\x18\x06 \x01(\t\x12\x39\n\x07metrics\x18\t \x01(\x0b\x32(.google.cloud.dataproc.v1.ClusterMetrics\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xa8\x04\n\rClusterConfig\x12\x15\n\rconfig_bucket\x18\x01 \x01(\t\x12\x46\n\x12gce_cluster_config\x18\x08 \x01(\x0b\x32*.google.cloud.dataproc.v1.GceClusterConfig\x12\x44\n\rmaster_config\x18\t \x01(\x0b\x32-.google.cloud.dataproc.v1.InstanceGroupConfig\x12\x44\n\rworker_config\x18\n \x01(\x0b\x32-.google.cloud.dataproc.v1.InstanceGroupConfig\x12N\n\x17secondary_worker_config\x18\x0c \x01(\x0b\x32-.google.cloud.dataproc.v1.InstanceGroupConfig\x12\x41\n\x0fsoftware_config\x18\r \x01(\x0b\x32(.google.cloud.dataproc.v1.SoftwareConfig\x12R\n\x16initialization_actions\x18\x0b \x03(\x0b\x32\x32.google.cloud.dataproc.v1.NodeInitializationAction\x12\x45\n\x11\x65ncryption_config\x18\x0f \x01(\x0b\x32*.google.cloud.dataproc.v1.EncryptionConfig"/\n\x10\x45ncryptionConfig\x12\x1b\n\x13gce_pd_kms_key_name\x18\x01 \x01(\t"\xaf\x02\n\x10GceClusterConfig\x12\x10\n\x08zone_uri\x18\x01 \x01(\t\x12\x13\n\x0bnetwork_uri\x18\x02 \x01(\t\x12\x16\n\x0esubnetwork_uri\x18\x06 \x01(\t\x12\x18\n\x10internal_ip_only\x18\x07 \x01(\x08\x12\x17\n\x0fservice_account\x18\x08 \x01(\t\x12\x1e\n\x16service_account_scopes\x18\x03 \x03(\t\x12\x0c\n\x04tags\x18\x04 \x03(\t\x12J\n\x08metadata\x18\x05 \x03(\x0b\x32\x38.google.cloud.dataproc.v1.GceClusterConfig.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xd3\x02\n\x13InstanceGroupConfig\x12\x15\n\rnum_instances\x18\x01 \x01(\x05\x12\x16\n\x0einstance_names\x18\x02 \x03(\t\x12\x11\n\timage_uri\x18\x03 \x01(\t\x12\x18\n\x10machine_type_uri\x18\x04 \x01(\t\x12\x39\n\x0b\x64isk_config\x18\x05 \x01(\x0b\x32$.google.cloud.dataproc.v1.DiskConfig\x12\x16\n\x0eis_preemptible\x18\x06 \x01(\x08\x12J\n\x14managed_group_config\x18\x07 \x01(\x0b\x32,.google.cloud.dataproc.v1.ManagedGroupConfig\x12\x41\n\x0c\x61\x63\x63\x65lerators\x18\x08 \x03(\x0b\x32+.google.cloud.dataproc.v1.AcceleratorConfig"Y\n\x12ManagedGroupConfig\x12\x1e\n\x16instance_template_name\x18\x01 \x01(\t\x12#\n\x1binstance_group_manager_name\x18\x02 \x01(\t"L\n\x11\x41\x63\x63\x65leratorConfig\x12\x1c\n\x14\x61\x63\x63\x65lerator_type_uri\x18\x01 \x01(\t\x12\x19\n\x11\x61\x63\x63\x65lerator_count\x18\x02 \x01(\x05"W\n\nDiskConfig\x12\x16\n\x0e\x62oot_disk_type\x18\x03 \x01(\t\x12\x19\n\x11\x62oot_disk_size_gb\x18\x01 \x01(\x05\x12\x16\n\x0enum_local_ssds\x18\x02 \x01(\x05"i\n\x18NodeInitializationAction\x12\x17\n\x0f\x65xecutable_file\x18\x01 \x01(\t\x12\x34\n\x11\x65xecution_timeout\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xed\x02\n\rClusterStatus\x12<\n\x05state\x18\x01 \x01(\x0e\x32-.google.cloud.dataproc.v1.ClusterStatus.State\x12\x0e\n\x06\x64\x65tail\x18\x02 \x01(\t\x12\x34\n\x10state_start_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x42\n\x08substate\x18\x04 \x01(\x0e\x32\x30.google.cloud.dataproc.v1.ClusterStatus.Substate"V\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\x12\x0c\n\x08\x44\x45LETING\x10\x04\x12\x0c\n\x08UPDATING\x10\x05"<\n\x08Substate\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\r\n\tUNHEALTHY\x10\x01\x12\x10\n\x0cSTALE_STATUS\x10\x02"\xea\x01\n\x0eSoftwareConfig\x12\x15\n\rimage_version\x18\x01 \x01(\t\x12L\n\nproperties\x18\x02 \x03(\x0b\x32\x38.google.cloud.dataproc.v1.SoftwareConfig.PropertiesEntry\x12@\n\x13optional_components\x18\x03 \x03(\x0e\x32#.google.cloud.dataproc.v1.Component\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x9a\x02\n\x0e\x43lusterMetrics\x12O\n\x0chdfs_metrics\x18\x01 \x03(\x0b\x32\x39.google.cloud.dataproc.v1.ClusterMetrics.HdfsMetricsEntry\x12O\n\x0cyarn_metrics\x18\x02 \x03(\x0b\x32\x39.google.cloud.dataproc.v1.ClusterMetrics.YarnMetricsEntry\x1a\x32\n\x10HdfsMetricsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01\x1a\x32\n\x10YarnMetricsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01"\x82\x01\n\x14\x43reateClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x32\n\x07\x63luster\x18\x02 \x01(\x0b\x32!.google.cloud.dataproc.v1.Cluster\x12\x12\n\nrequest_id\x18\x04 \x01(\t"\x8b\x02\n\x14UpdateClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x05 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x32\n\x07\x63luster\x18\x03 \x01(\x0b\x32!.google.cloud.dataproc.v1.Cluster\x12@\n\x1dgraceful_decommission_timeout\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12/\n\x0bupdate_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x12\n\nrequest_id\x18\x07 \x01(\t"z\n\x14\x44\x65leteClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x14\n\x0c\x63luster_uuid\x18\x04 \x01(\t\x12\x12\n\nrequest_id\x18\x05 \x01(\t"M\n\x11GetClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t"p\n\x13ListClustersRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"d\n\x14ListClustersResponse\x12\x33\n\x08\x63lusters\x18\x01 \x03(\x0b\x32!.google.cloud.dataproc.v1.Cluster\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"R\n\x16\x44iagnoseClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t",\n\x16\x44iagnoseClusterResults\x12\x12\n\noutput_uri\x18\x01 \x01(\t2\xb2\x08\n\x11\x43lusterController\x12\xa4\x01\n\rCreateCluster\x12..google.cloud.dataproc.v1.CreateClusterRequest\x1a\x1d.google.longrunning.Operation"D\x82\xd3\xe4\x93\x02>"3/v1/projects/{project_id}/regions/{region}/clusters:\x07\x63luster\x12\xb3\x01\n\rUpdateCluster\x12..google.cloud.dataproc.v1.UpdateClusterRequest\x1a\x1d.google.longrunning.Operation"S\x82\xd3\xe4\x93\x02M2B/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:\x07\x63luster\x12\xaa\x01\n\rDeleteCluster\x12..google.cloud.dataproc.v1.DeleteClusterRequest\x1a\x1d.google.longrunning.Operation"J\x82\xd3\xe4\x93\x02\x44*B/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}\x12\xa8\x01\n\nGetCluster\x12+.google.cloud.dataproc.v1.GetClusterRequest\x1a!.google.cloud.dataproc.v1.Cluster"J\x82\xd3\xe4\x93\x02\x44\x12\x42/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}\x12\xaa\x01\n\x0cListClusters\x12-.google.cloud.dataproc.v1.ListClustersRequest\x1a..google.cloud.dataproc.v1.ListClustersResponse";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1/projects/{project_id}/regions/{region}/clusters\x12\xba\x01\n\x0f\x44iagnoseCluster\x12\x30.google.cloud.dataproc.v1.DiagnoseClusterRequest\x1a\x1d.google.longrunning.Operation"V\x82\xd3\xe4\x93\x02P"K/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose:\x01*Bq\n\x1c\x63om.google.cloud.dataproc.v1B\rClustersProtoP\x01Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1_dot_proto_dot_operations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1_dot_proto_dot_shared__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CLUSTERSTATUS_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1.ClusterStatus.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATING", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2594,
+    serialized_end=2680,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTERSTATUS_STATE)
+
+_CLUSTERSTATUS_SUBSTATE = _descriptor.EnumDescriptor(
+    name="Substate",
+    full_name="google.cloud.dataproc.v1.ClusterStatus.Substate",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNHEALTHY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STALE_STATUS", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2682,
+    serialized_end=2742,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTERSTATUS_SUBSTATE)
+
+
+_CLUSTER_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1.Cluster.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.Cluster.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.Cluster.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=712,
+    serialized_end=757,
+)
+
+_CLUSTER = _descriptor.Descriptor(
+    name="Cluster",
+    full_name="google.cloud.dataproc.v1.Cluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.Cluster.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.Cluster.cluster_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.dataproc.v1.Cluster.config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1.Cluster.labels",
+            index=3,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.dataproc.v1.Cluster.status",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_history",
+            full_name="google.cloud.dataproc.v1.Cluster.status_history",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1.Cluster.cluster_uuid",
+            index=6,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metrics",
+            full_name="google.cloud.dataproc.v1.Cluster.metrics",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTER_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=336,
+    serialized_end=757,
+)
+
+
+_CLUSTERCONFIG = _descriptor.Descriptor(
+    name="ClusterConfig",
+    full_name="google.cloud.dataproc.v1.ClusterConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config_bucket",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.config_bucket",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gce_cluster_config",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.gce_cluster_config",
+            index=1,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_config",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.master_config",
+            index=2,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="worker_config",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.worker_config",
+            index=3,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="secondary_worker_config",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.secondary_worker_config",
+            index=4,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="software_config",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.software_config",
+            index=5,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initialization_actions",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.initialization_actions",
+            index=6,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encryption_config",
+            full_name="google.cloud.dataproc.v1.ClusterConfig.encryption_config",
+            index=7,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=760,
+    serialized_end=1312,
+)
+
+
+_ENCRYPTIONCONFIG = _descriptor.Descriptor(
+    name="EncryptionConfig",
+    full_name="google.cloud.dataproc.v1.EncryptionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gce_pd_kms_key_name",
+            full_name="google.cloud.dataproc.v1.EncryptionConfig.gce_pd_kms_key_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1314,
+    serialized_end=1361,
+)
+
+
+_GCECLUSTERCONFIG_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.dataproc.v1.GceClusterConfig.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1620,
+    serialized_end=1667,
+)
+
+_GCECLUSTERCONFIG = _descriptor.Descriptor(
+    name="GceClusterConfig",
+    full_name="google.cloud.dataproc.v1.GceClusterConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="zone_uri",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.zone_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_uri",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.network_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork_uri",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.subnetwork_uri",
+            index=2,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="internal_ip_only",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.internal_ip_only",
+            index=3,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.service_account",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account_scopes",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.service_account_scopes",
+            index=5,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.tags",
+            index=6,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.dataproc.v1.GceClusterConfig.metadata",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GCECLUSTERCONFIG_METADATAENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1364,
+    serialized_end=1667,
+)
+
+
+_INSTANCEGROUPCONFIG = _descriptor.Descriptor(
+    name="InstanceGroupConfig",
+    full_name="google.cloud.dataproc.v1.InstanceGroupConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="num_instances",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.num_instances",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_names",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.instance_names",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.image_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="machine_type_uri",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.machine_type_uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disk_config",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.disk_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_preemptible",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.is_preemptible",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="managed_group_config",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.managed_group_config",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerators",
+            full_name="google.cloud.dataproc.v1.InstanceGroupConfig.accelerators",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1670,
+    serialized_end=2009,
+)
+
+
+_MANAGEDGROUPCONFIG = _descriptor.Descriptor(
+    name="ManagedGroupConfig",
+    full_name="google.cloud.dataproc.v1.ManagedGroupConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance_template_name",
+            full_name="google.cloud.dataproc.v1.ManagedGroupConfig.instance_template_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_group_manager_name",
+            full_name="google.cloud.dataproc.v1.ManagedGroupConfig.instance_group_manager_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2011,
+    serialized_end=2100,
+)
+
+
+_ACCELERATORCONFIG = _descriptor.Descriptor(
+    name="AcceleratorConfig",
+    full_name="google.cloud.dataproc.v1.AcceleratorConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="accelerator_type_uri",
+            full_name="google.cloud.dataproc.v1.AcceleratorConfig.accelerator_type_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerator_count",
+            full_name="google.cloud.dataproc.v1.AcceleratorConfig.accelerator_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2102,
+    serialized_end=2178,
+)
+
+
+_DISKCONFIG = _descriptor.Descriptor(
+    name="DiskConfig",
+    full_name="google.cloud.dataproc.v1.DiskConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="boot_disk_type",
+            full_name="google.cloud.dataproc.v1.DiskConfig.boot_disk_type",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boot_disk_size_gb",
+            full_name="google.cloud.dataproc.v1.DiskConfig.boot_disk_size_gb",
+            index=1,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_local_ssds",
+            full_name="google.cloud.dataproc.v1.DiskConfig.num_local_ssds",
+            index=2,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2180,
+    serialized_end=2267,
+)
+
+
+_NODEINITIALIZATIONACTION = _descriptor.Descriptor(
+    name="NodeInitializationAction",
+    full_name="google.cloud.dataproc.v1.NodeInitializationAction",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="executable_file",
+            full_name="google.cloud.dataproc.v1.NodeInitializationAction.executable_file",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="execution_timeout",
+            full_name="google.cloud.dataproc.v1.NodeInitializationAction.execution_timeout",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2269,
+    serialized_end=2374,
+)
+
+
+_CLUSTERSTATUS = _descriptor.Descriptor(
+    name="ClusterStatus",
+    full_name="google.cloud.dataproc.v1.ClusterStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1.ClusterStatus.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detail",
+            full_name="google.cloud.dataproc.v1.ClusterStatus.detail",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_start_time",
+            full_name="google.cloud.dataproc.v1.ClusterStatus.state_start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="substate",
+            full_name="google.cloud.dataproc.v1.ClusterStatus.substate",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CLUSTERSTATUS_STATE, _CLUSTERSTATUS_SUBSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2377,
+    serialized_end=2742,
+)
+
+
+_SOFTWARECONFIG_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.SoftwareConfig.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.SoftwareConfig.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.SoftwareConfig.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2930,
+    serialized_end=2979,
+)
+
+_SOFTWARECONFIG = _descriptor.Descriptor(
+    name="SoftwareConfig",
+    full_name="google.cloud.dataproc.v1.SoftwareConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_version",
+            full_name="google.cloud.dataproc.v1.SoftwareConfig.image_version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.SoftwareConfig.properties",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="optional_components",
+            full_name="google.cloud.dataproc.v1.SoftwareConfig.optional_components",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SOFTWARECONFIG_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2745,
+    serialized_end=2979,
+)
+
+
+_CLUSTERMETRICS_HDFSMETRICSENTRY = _descriptor.Descriptor(
+    name="HdfsMetricsEntry",
+    full_name="google.cloud.dataproc.v1.ClusterMetrics.HdfsMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.ClusterMetrics.HdfsMetricsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.ClusterMetrics.HdfsMetricsEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3162,
+    serialized_end=3212,
+)
+
+_CLUSTERMETRICS_YARNMETRICSENTRY = _descriptor.Descriptor(
+    name="YarnMetricsEntry",
+    full_name="google.cloud.dataproc.v1.ClusterMetrics.YarnMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.ClusterMetrics.YarnMetricsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.ClusterMetrics.YarnMetricsEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3214,
+    serialized_end=3264,
+)
+
+_CLUSTERMETRICS = _descriptor.Descriptor(
+    name="ClusterMetrics",
+    full_name="google.cloud.dataproc.v1.ClusterMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hdfs_metrics",
+            full_name="google.cloud.dataproc.v1.ClusterMetrics.hdfs_metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="yarn_metrics",
+            full_name="google.cloud.dataproc.v1.ClusterMetrics.yarn_metrics",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTERMETRICS_HDFSMETRICSENTRY, _CLUSTERMETRICS_YARNMETRICSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2982,
+    serialized_end=3264,
+)
+
+
+_CREATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="CreateClusterRequest",
+    full_name="google.cloud.dataproc.v1.CreateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.CreateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.CreateClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.cloud.dataproc.v1.CreateClusterRequest.cluster",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1.CreateClusterRequest.request_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3267,
+    serialized_end=3397,
+)
+
+
+_UPDATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="UpdateClusterRequest",
+    full_name="google.cloud.dataproc.v1.UpdateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.region",
+            index=1,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.cluster",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="graceful_decommission_timeout",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.graceful_decommission_timeout",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.update_mask",
+            index=5,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1.UpdateClusterRequest.request_id",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3400,
+    serialized_end=3667,
+)
+
+
+_DELETECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DeleteClusterRequest",
+    full_name="google.cloud.dataproc.v1.DeleteClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.DeleteClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.DeleteClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.DeleteClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1.DeleteClusterRequest.cluster_uuid",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1.DeleteClusterRequest.request_id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3669,
+    serialized_end=3791,
+)
+
+
+_GETCLUSTERREQUEST = _descriptor.Descriptor(
+    name="GetClusterRequest",
+    full_name="google.cloud.dataproc.v1.GetClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.GetClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.GetClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.GetClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3793,
+    serialized_end=3870,
+)
+
+
+_LISTCLUSTERSREQUEST = _descriptor.Descriptor(
+    name="ListClustersRequest",
+    full_name="google.cloud.dataproc.v1.ListClustersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.ListClustersRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.ListClustersRequest.region",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.dataproc.v1.ListClustersRequest.filter",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1.ListClustersRequest.page_size",
+            index=3,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1.ListClustersRequest.page_token",
+            index=4,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3872,
+    serialized_end=3984,
+)
+
+
+_LISTCLUSTERSRESPONSE = _descriptor.Descriptor(
+    name="ListClustersResponse",
+    full_name="google.cloud.dataproc.v1.ListClustersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.cloud.dataproc.v1.ListClustersResponse.clusters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1.ListClustersResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3986,
+    serialized_end=4086,
+)
+
+
+_DIAGNOSECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DiagnoseClusterRequest",
+    full_name="google.cloud.dataproc.v1.DiagnoseClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.DiagnoseClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.DiagnoseClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.DiagnoseClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4088,
+    serialized_end=4170,
+)
+
+
+_DIAGNOSECLUSTERRESULTS = _descriptor.Descriptor(
+    name="DiagnoseClusterResults",
+    full_name="google.cloud.dataproc.v1.DiagnoseClusterResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.dataproc.v1.DiagnoseClusterResults.output_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4172,
+    serialized_end=4216,
+)
+
+_CLUSTER_LABELSENTRY.containing_type = _CLUSTER
+_CLUSTER.fields_by_name["config"].message_type = _CLUSTERCONFIG
+_CLUSTER.fields_by_name["labels"].message_type = _CLUSTER_LABELSENTRY
+_CLUSTER.fields_by_name["status"].message_type = _CLUSTERSTATUS
+_CLUSTER.fields_by_name["status_history"].message_type = _CLUSTERSTATUS
+_CLUSTER.fields_by_name["metrics"].message_type = _CLUSTERMETRICS
+_CLUSTERCONFIG.fields_by_name["gce_cluster_config"].message_type = _GCECLUSTERCONFIG
+_CLUSTERCONFIG.fields_by_name["master_config"].message_type = _INSTANCEGROUPCONFIG
+_CLUSTERCONFIG.fields_by_name["worker_config"].message_type = _INSTANCEGROUPCONFIG
+_CLUSTERCONFIG.fields_by_name[
+    "secondary_worker_config"
+].message_type = _INSTANCEGROUPCONFIG
+_CLUSTERCONFIG.fields_by_name["software_config"].message_type = _SOFTWARECONFIG
+_CLUSTERCONFIG.fields_by_name[
+    "initialization_actions"
+].message_type = _NODEINITIALIZATIONACTION
+_CLUSTERCONFIG.fields_by_name["encryption_config"].message_type = _ENCRYPTIONCONFIG
+_GCECLUSTERCONFIG_METADATAENTRY.containing_type = _GCECLUSTERCONFIG
+_GCECLUSTERCONFIG.fields_by_name[
+    "metadata"
+].message_type = _GCECLUSTERCONFIG_METADATAENTRY
+_INSTANCEGROUPCONFIG.fields_by_name["disk_config"].message_type = _DISKCONFIG
+_INSTANCEGROUPCONFIG.fields_by_name[
+    "managed_group_config"
+].message_type = _MANAGEDGROUPCONFIG
+_INSTANCEGROUPCONFIG.fields_by_name["accelerators"].message_type = _ACCELERATORCONFIG
+_NODEINITIALIZATIONACTION.fields_by_name[
+    "execution_timeout"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_CLUSTERSTATUS.fields_by_name["state"].enum_type = _CLUSTERSTATUS_STATE
+_CLUSTERSTATUS.fields_by_name[
+    "state_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CLUSTERSTATUS.fields_by_name["substate"].enum_type = _CLUSTERSTATUS_SUBSTATE
+_CLUSTERSTATUS_STATE.containing_type = _CLUSTERSTATUS
+_CLUSTERSTATUS_SUBSTATE.containing_type = _CLUSTERSTATUS
+_SOFTWARECONFIG_PROPERTIESENTRY.containing_type = _SOFTWARECONFIG
+_SOFTWARECONFIG.fields_by_name[
+    "properties"
+].message_type = _SOFTWARECONFIG_PROPERTIESENTRY
+_SOFTWARECONFIG.fields_by_name[
+    "optional_components"
+].enum_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_shared__pb2._COMPONENT
+_CLUSTERMETRICS_HDFSMETRICSENTRY.containing_type = _CLUSTERMETRICS
+_CLUSTERMETRICS_YARNMETRICSENTRY.containing_type = _CLUSTERMETRICS
+_CLUSTERMETRICS.fields_by_name[
+    "hdfs_metrics"
+].message_type = _CLUSTERMETRICS_HDFSMETRICSENTRY
+_CLUSTERMETRICS.fields_by_name[
+    "yarn_metrics"
+].message_type = _CLUSTERMETRICS_YARNMETRICSENTRY
+_CREATECLUSTERREQUEST.fields_by_name["cluster"].message_type = _CLUSTER
+_UPDATECLUSTERREQUEST.fields_by_name["cluster"].message_type = _CLUSTER
+_UPDATECLUSTERREQUEST.fields_by_name[
+    "graceful_decommission_timeout"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_UPDATECLUSTERREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTCLUSTERSRESPONSE.fields_by_name["clusters"].message_type = _CLUSTER
+DESCRIPTOR.message_types_by_name["Cluster"] = _CLUSTER
+DESCRIPTOR.message_types_by_name["ClusterConfig"] = _CLUSTERCONFIG
+DESCRIPTOR.message_types_by_name["EncryptionConfig"] = _ENCRYPTIONCONFIG
+DESCRIPTOR.message_types_by_name["GceClusterConfig"] = _GCECLUSTERCONFIG
+DESCRIPTOR.message_types_by_name["InstanceGroupConfig"] = _INSTANCEGROUPCONFIG
+DESCRIPTOR.message_types_by_name["ManagedGroupConfig"] = _MANAGEDGROUPCONFIG
+DESCRIPTOR.message_types_by_name["AcceleratorConfig"] = _ACCELERATORCONFIG
+DESCRIPTOR.message_types_by_name["DiskConfig"] = _DISKCONFIG
+DESCRIPTOR.message_types_by_name["NodeInitializationAction"] = _NODEINITIALIZATIONACTION
+DESCRIPTOR.message_types_by_name["ClusterStatus"] = _CLUSTERSTATUS
+DESCRIPTOR.message_types_by_name["SoftwareConfig"] = _SOFTWARECONFIG
+DESCRIPTOR.message_types_by_name["ClusterMetrics"] = _CLUSTERMETRICS
+DESCRIPTOR.message_types_by_name["CreateClusterRequest"] = _CREATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateClusterRequest"] = _UPDATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["DeleteClusterRequest"] = _DELETECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["GetClusterRequest"] = _GETCLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersRequest"] = _LISTCLUSTERSREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersResponse"] = _LISTCLUSTERSRESPONSE
+DESCRIPTOR.message_types_by_name["DiagnoseClusterRequest"] = _DIAGNOSECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["DiagnoseClusterResults"] = _DIAGNOSECLUSTERRESULTS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Cluster = _reflection.GeneratedProtocolMessageType(
+    "Cluster",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTER_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.Cluster.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTER,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Describes the identifying information, config, and status of a cluster
+  of Compute Engine instances.
+  
+  
+  Attributes:
+      project_id:
+          Required. The Google Cloud Platform project ID that the
+          cluster belongs to.
+      cluster_name:
+          Required. The cluster name. Cluster names within a project
+          must be unique. Names of deleted clusters can be reused.
+      config:
+          Required. The cluster config. Note that Cloud Dataproc may set
+          default values, and values may change when clusters are
+          updated.
+      labels:
+          Optional. The labels to associate with this cluster. Label
+          **keys** must contain 1 to 63 characters, and must conform to
+          `RFC 1035 <https://www.ietf.org/rfc/rfc1035.txt>`__. Label
+          **values** may be empty, but, if present, must contain 1 to 63
+          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.
+      status:
+          Output only. Cluster status.
+      status_history:
+          Output only. The previous cluster status.
+      cluster_uuid:
+          Output only. A cluster UUID (Unique Universal Identifier).
+          Cloud Dataproc generates this value when it creates the
+          cluster.
+      metrics:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.Cluster)
+    ),
+)
+_sym_db.RegisterMessage(Cluster)
+_sym_db.RegisterMessage(Cluster.LabelsEntry)
+
+ClusterConfig = _reflection.GeneratedProtocolMessageType(
+    "ClusterConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""The cluster config.
+  
+  
+  Attributes:
+      config_bucket:
+          Optional. A Google 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 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>`__).
+      gce_cluster_config:
+          Optional. The shared Compute Engine config settings for all
+          instances in a cluster.
+      master_config:
+          Optional. The Compute Engine config settings for the master
+          instance in a cluster.
+      worker_config:
+          Optional. The Compute Engine config settings for worker
+          instances in a cluster.
+      secondary_worker_config:
+          Optional. The Compute Engine config settings for additional
+          worker instances in a cluster.
+      software_config:
+          Optional. The config settings for software inside the cluster.
+      initialization_actions:
+          Optional. Commands to execute on each node after config is
+          completed. By default, executables are run on master and all
+          worker nodes. You can test a node's ``role`` metadata to run
+          an executable on a master or worker node, as shown below using
+          ``curl`` (you can also use ``wget``):  ::      ROLE=$(curl -H
+          Metadata-Flavor:Google     http://metadata/computeMetadata/v1/
+          instance/attributes/dataproc-role)     if [[ "${ROLE}" ==
+          'Master' ]]; then       ... master specific actions ...
+          else       ... worker specific actions ...     fi
+      encryption_config:
+          Optional. Encryption settings for the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterConfig)
+    ),
+)
+_sym_db.RegisterMessage(ClusterConfig)
+
+EncryptionConfig = _reflection.GeneratedProtocolMessageType(
+    "EncryptionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENCRYPTIONCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Encryption settings for the cluster.
+  
+  
+  Attributes:
+      gce_pd_kms_key_name:
+          Optional. The Cloud KMS key name to use for PD disk encryption
+          for all instances in the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.EncryptionConfig)
+    ),
+)
+_sym_db.RegisterMessage(EncryptionConfig)
+
+GceClusterConfig = _reflection.GeneratedProtocolMessageType(
+    "GceClusterConfig",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GCECLUSTERCONFIG_METADATAENTRY,
+                __module__="google.cloud.dataproc_v1.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.GceClusterConfig.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_GCECLUSTERCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Common config settings for resources of Compute Engine cluster
+  instances, applicable to all instances in the cluster.
+  
+  
+  Attributes:
+      zone_uri:
+          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 corresponding Compute Engine
+          region. On a get request, zone will always be present.  A full
+          URL, partial URI, or short name are valid. Examples:  -  ``htt
+          ps://www.googleapis.com/compute/v1/projects/[project_id]/zones
+          /[zone]`` -  ``projects/[project_id]/zones/[zone]`` -  ``us-
+          central1-f``
+      network_uri:
+          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).  A full
+          URL, partial URI, or short name are valid. Examples:  -  ``htt
+          ps://www.googleapis.com/compute/v1/projects/[project_id]/regio
+          ns/global/default`` -
+          ``projects/[project_id]/regions/global/default`` -
+          ``default``
+      subnetwork_uri:
+          Optional. The Compute Engine subnetwork to be used for machine
+          communications. Cannot be specified with network\_uri.  A full
+          URL, partial URI, or short name are valid. Examples:  -  ``htt
+          ps://www.googleapis.com/compute/v1/projects/[project_id]/regio
+          ns/us-east1/subnetworks/sub0`` -
+          ``projects/[project_id]/regions/us-east1/subnetworks/sub0`` -
+          ``sub0``
+      internal_ip_only:
+          Optional. If true, all instances in the cluster will only have
+          internal IP addresses. By default, clusters are not restricted
+          to internal IP addresses, and will have ephemeral external IP
+          addresses assigned to each 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.
+      service_account:
+          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:  -  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``
+      service_account_scopes:
+          Optional. The URIs of service account scopes to be included in
+          Compute Engine instances. The following base set of scopes is
+          always included:  -
+          https://www.googleapis.com/auth/cloud.useraccounts.readonly -
+          https://www.googleapis.com/auth/devstorage.read\_write -
+          https://www.googleapis.com/auth/logging.write  If no scopes
+          are specified, the following defaults are also provided:  -
+          https://www.googleapis.com/auth/bigquery -
+          https://www.googleapis.com/auth/bigtable.admin.table -
+          https://www.googleapis.com/auth/bigtable.data -
+          https://www.googleapis.com/auth/devstorage.full\_control
+      tags:
+          The Compute Engine tags to add to all instances (see `Tagging
+          instances </compute/docs/label-or-tag-resources#tags>`__).
+      metadata:
+          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>`__).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.GceClusterConfig)
+    ),
+)
+_sym_db.RegisterMessage(GceClusterConfig)
+_sym_db.RegisterMessage(GceClusterConfig.MetadataEntry)
+
+InstanceGroupConfig = _reflection.GeneratedProtocolMessageType(
+    "InstanceGroupConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTANCEGROUPCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Optional. The config settings for Compute Engine resources in an
+  instance group, such as a master or worker group.
+  
+  
+  Attributes:
+      num_instances:
+          Optional. The number of VM instances in the instance group.
+          For master instance groups, must be set to 1.
+      instance_names:
+          Output only. The list of instance names. Cloud Dataproc
+          derives the names from ``cluster_name``, ``num_instances``,
+          and the instance group.
+      image_uri:
+          Optional. The Compute Engine image resource used for cluster
+          instances. It can be specified or may be inferred from
+          ``SoftwareConfig.image_version``.
+      machine_type_uri:
+          Optional. The Compute Engine machine type used for cluster
+          instances.  A full URL, partial URI, or short name are valid.
+          Examples:  -  ``https://www.googleapis.com/compute/v1/projects
+          /[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`` -
+          ``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 Placement </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``.
+      disk_config:
+          Optional. Disk option config settings.
+      is_preemptible:
+          Optional. Specifies that this instance group contains
+          preemptible instances.
+      managed_group_config:
+          Output only. The config for Compute Engine Instance Group
+          Manager that manages this group. This is only used for
+          preemptible instance groups.
+      accelerators:
+          Optional. The Compute Engine accelerator configuration for
+          these instances.  **Beta Feature**: This feature is still
+          under development. It may be changed before final release.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.InstanceGroupConfig)
+    ),
+)
+_sym_db.RegisterMessage(InstanceGroupConfig)
+
+ManagedGroupConfig = _reflection.GeneratedProtocolMessageType(
+    "ManagedGroupConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MANAGEDGROUPCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Specifies the resources used to actively manage an instance group.
+  
+  
+  Attributes:
+      instance_template_name:
+          Output only. The name of the Instance Template used for the
+          Managed Instance Group.
+      instance_group_manager_name:
+          Output only. The name of the Instance Group Manager for this
+          group.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ManagedGroupConfig)
+    ),
+)
+_sym_db.RegisterMessage(ManagedGroupConfig)
+
+AcceleratorConfig = _reflection.GeneratedProtocolMessageType(
+    "AcceleratorConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACCELERATORCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Specifies the type and number of accelerator cards attached to the
+  instances of an instance. See `GPUs on Compute
+  Engine </compute/docs/gpus/>`__.
+  
+  
+  Attributes:
+      accelerator_type_uri:
+          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>`__.  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 Placement
+          </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``.
+      accelerator_count:
+          The number of the accelerator cards of this type exposed to
+          this instance.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.AcceleratorConfig)
+    ),
+)
+_sym_db.RegisterMessage(AcceleratorConfig)
+
+DiskConfig = _reflection.GeneratedProtocolMessageType(
+    "DiskConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DISKCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Specifies the config of disk options for a group of VM instances.
+  
+  
+  Attributes:
+      boot_disk_type:
+          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).
+      boot_disk_size_gb:
+          Optional. Size in GB of the boot disk (default is 500GB).
+      num_local_ssds:
+          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 `HDFS <https://hadoop.apache.org/docs/r1.2.1/
+          hdfs_user_guide.html>`__ data. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.DiskConfig)
+    ),
+)
+_sym_db.RegisterMessage(DiskConfig)
+
+NodeInitializationAction = _reflection.GeneratedProtocolMessageType(
+    "NodeInitializationAction",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEINITIALIZATIONACTION,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Specifies an executable to run on a fully configured node and a timeout
+  period for executable completion.
+  
+  
+  Attributes:
+      executable_file:
+          Required. Cloud Storage URI of executable file.
+      execution_timeout:
+          Optional. Amount of time executable has to complete. Default
+          is 10 minutes. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.NodeInitializationAction)
+    ),
+)
+_sym_db.RegisterMessage(NodeInitializationAction)
+
+ClusterStatus = _reflection.GeneratedProtocolMessageType(
+    "ClusterStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERSTATUS,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""The status of a cluster and its instances.
+  
+  
+  Attributes:
+      state:
+          Output only. The cluster's state.
+      detail:
+          Output only. Optional details of cluster's state.
+      state_start_time:
+          Output only. Time when this state was entered.
+      substate:
+          Output only. Additional state information that includes status
+          reported by the agent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterStatus)
+    ),
+)
+_sym_db.RegisterMessage(ClusterStatus)
+
+SoftwareConfig = _reflection.GeneratedProtocolMessageType(
+    "SoftwareConfig",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SOFTWARECONFIG_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SoftwareConfig.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SOFTWARECONFIG,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Specifies the selection and config of software inside the cluster.
+  
+  
+  Attributes:
+      image_version:
+          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>`__, 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>`__. If unspecified, it defaults to
+          the latest Debian version.
+      properties:
+          Optional. The properties to set on daemon config files.
+          Property keys are specified in ``prefix:property`` format, for
+          example ``core:hadoop.tmp.dir``. The following are supported
+          prefixes and their mappings:  -  capacity-scheduler:
+          ``capacity-scheduler.xml`` -  core: ``core-site.xml`` -
+          distcp: ``distcp-default.xml`` -  hdfs: ``hdfs-site.xml`` -
+          hive: ``hive-site.xml`` -  mapred: ``mapred-site.xml`` -  pig:
+          ``pig.properties`` -  spark: ``spark-defaults.conf`` -  yarn:
+          ``yarn-site.xml``  For more information, see `Cluster
+          properties </dataproc/docs/concepts/cluster-properties>`__.
+      optional_components:
+          The set of optional components to activate on the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SoftwareConfig)
+    ),
+)
+_sym_db.RegisterMessage(SoftwareConfig)
+_sym_db.RegisterMessage(SoftwareConfig.PropertiesEntry)
+
+ClusterMetrics = _reflection.GeneratedProtocolMessageType(
+    "ClusterMetrics",
+    (_message.Message,),
+    dict(
+        HdfsMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "HdfsMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTERMETRICS_HDFSMETRICSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterMetrics.HdfsMetricsEntry)
+            ),
+        ),
+        YarnMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "YarnMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTERMETRICS_YARNMETRICSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterMetrics.YarnMetricsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTERMETRICS,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      hdfs_metrics:
+          The HDFS metrics.
+      yarn_metrics:
+          The YARN metrics.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterMetrics)
+    ),
+)
+_sym_db.RegisterMessage(ClusterMetrics)
+_sym_db.RegisterMessage(ClusterMetrics.HdfsMetricsEntry)
+_sym_db.RegisterMessage(ClusterMetrics.YarnMetricsEntry)
+
+CreateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""A request to create a cluster.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster:
+          Required. The cluster to create.
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [CreateClusterRequest][google.cloud.datapr
+          oc.v1.CreateClusterRequest] requests with the same id, then
+          the second request will be ignored and the first
+          [google.longrunning.Operation][google.longrunning.Operation]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.CreateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateClusterRequest)
+
+UpdateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""A request to update a cluster.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+      cluster:
+          Required. The changes to the cluster.
+      graceful_decommission_timeout:
+          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.  Only supported on Dataproc image versions 1.2 and
+          higher.
+      update_mask:
+          Required. Specifies the path, relative to ``Cluster``, of the
+          field to update. For example, to change the number of workers
+          in a cluster to 5, the ``update_mask`` parameter would be
+          specified as ``config.worker_config.num_instances``, and the
+          ``PATCH`` request body would specify the new value, as
+          follows:  ::      {       "config":{         "workerConfig":{
+          "numInstances":"5"         }       }     }  Similarly, to
+          change the number of preemptible workers in a cluster to 5,
+          the ``update_mask`` parameter would be
+          ``config.secondary_worker_config.num_instances``, and the
+          ``PATCH`` request body would be set as follows:  ::      {
+          "config":{         "secondaryWorkerConfig":{
+          "numInstances":"5"         }       }     }  Note: Currently,
+          only the following fields can be updated:  .. raw:: html
+          <table>  .. raw:: html     <tbody>  .. raw:: html     <tr>  ..
+          raw:: html     <td>  Mask  .. raw:: html     </td>  .. raw::
+          html     <td>  Purpose  .. raw:: html     </td>  .. raw:: html
+          </tr>  .. raw:: html     <tr>  .. raw:: html     <td>  labels
+          .. raw:: html     </td>  .. raw:: html     <td>  Update labels
+          .. raw:: html     </td>  .. raw:: html     </tr>  .. raw::
+          html     <tr>  .. raw:: html     <td>
+          config.worker\_config.num\_instances  .. raw:: html     </td>
+          .. raw:: html     <td>  Resize primary worker group  .. raw::
+          html     </td>  .. raw:: html     </tr>  .. raw:: html
+          <tr>  .. raw:: html     <td>
+          config.secondary\_worker\_config.num\_instances  .. raw:: html
+          </td>  .. raw:: html     <td>  Resize secondary worker group
+          .. raw:: html     </td>  .. raw:: html     </tr>  .. raw::
+          html     </tbody>  .. raw:: html     </table>
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [UpdateClusterRequest][google.cloud.datapr
+          oc.v1.UpdateClusterRequest] requests with the same id, then
+          the second request will be ignored and the first
+          [google.longrunning.Operation][google.longrunning.Operation]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.UpdateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateClusterRequest)
+
+DeleteClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""A request to delete a cluster.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+      cluster_uuid:
+          Optional. Specifying the ``cluster_uuid`` means the RPC should
+          fail (with error NOT\_FOUND) if cluster with specified UUID
+          does not exist.
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [DeleteClusterRequest][google.cloud.datapr
+          oc.v1.DeleteClusterRequest] requests with the same id, then
+          the second request will be ignored and the first
+          [google.longrunning.Operation][google.longrunning.Operation]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.DeleteClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteClusterRequest)
+
+GetClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "GetClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""Request to get the resource representation for a cluster in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.GetClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetClusterRequest)
+
+ListClustersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListClustersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""A request to list the clusters in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      filter:
+          Optional. A filter constraining the clusters to list. Filters
+          are case-sensitive and have the following syntax:  field =
+          value [AND [field = value]] ...  where **field** is one of
+          ``status.state``, ``clusterName``, or ``labels.[KEY]``, and
+          ``[KEY]`` is a label key. **value** can be ``*`` to match all
+          values. ``status.state`` can be one of the following:
+          ``ACTIVE``, ``INACTIVE``, ``CREATING``, ``RUNNING``,
+          ``ERROR``, ``DELETING``, or ``UPDATING``. ``ACTIVE`` contains
+          the ``CREATING``, ``UPDATING``, and ``RUNNING`` states.
+          ``INACTIVE`` contains the ``DELETING`` and ``ERROR`` states.
+          ``clusterName`` is the name of the cluster provided at
+          creation time. Only the logical ``AND`` operator is supported;
+          space-separated items are treated as having an implicit
+          ``AND`` operator.  Example filter:  status.state = ACTIVE AND
+          clusterName = mycluster AND labels.env = staging AND
+          labels.starred = \*
+      page_size:
+          Optional. The standard List page size.
+      page_token:
+          Optional. The standard List page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ListClustersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersRequest)
+
+ListClustersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListClustersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSRESPONSE,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""The list of all clusters in a project.
+  
+  
+  Attributes:
+      clusters:
+          Output only. The clusters in the project.
+      next_page_token:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ListClustersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersResponse)
+
+DiagnoseClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DiagnoseClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DIAGNOSECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""A request to collect cluster diagnostic information.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.DiagnoseClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DiagnoseClusterRequest)
+
+DiagnoseClusterResults = _reflection.GeneratedProtocolMessageType(
+    "DiagnoseClusterResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DIAGNOSECLUSTERRESULTS,
+        __module__="google.cloud.dataproc_v1.proto.clusters_pb2",
+        __doc__="""The location of diagnostic output.
+  
+  
+  Attributes:
+      output_uri:
+          Output only. The Cloud Storage URI of the diagnostic output.
+          The output report is a plain text file with a summary of
+          collected diagnostics.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.DiagnoseClusterResults)
+    ),
+)
+_sym_db.RegisterMessage(DiagnoseClusterResults)
+
+
+DESCRIPTOR._options = None
+_CLUSTER_LABELSENTRY._options = None
+_GCECLUSTERCONFIG_METADATAENTRY._options = None
+_SOFTWARECONFIG_PROPERTIESENTRY._options = None
+_CLUSTERMETRICS_HDFSMETRICSENTRY._options = None
+_CLUSTERMETRICS_YARNMETRICSENTRY._options = None
+
+_CLUSTERCONTROLLER = _descriptor.ServiceDescriptor(
+    name="ClusterController",
+    full_name="google.cloud.dataproc.v1.ClusterController",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4219,
+    serialized_end=5293,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateCluster",
+            full_name="google.cloud.dataproc.v1.ClusterController.CreateCluster",
+            index=0,
+            containing_service=None,
+            input_type=_CREATECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002>"3/v1/projects/{project_id}/regions/{region}/clusters:\007cluster'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCluster",
+            full_name="google.cloud.dataproc.v1.ClusterController.UpdateCluster",
+            index=1,
+            containing_service=None,
+            input_type=_UPDATECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002M2B/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:\007cluster"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteCluster",
+            full_name="google.cloud.dataproc.v1.ClusterController.DeleteCluster",
+            index=2,
+            containing_service=None,
+            input_type=_DELETECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002D*B/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCluster",
+            full_name="google.cloud.dataproc.v1.ClusterController.GetCluster",
+            index=3,
+            containing_service=None,
+            input_type=_GETCLUSTERREQUEST,
+            output_type=_CLUSTER,
+            serialized_options=_b(
+                "\202\323\344\223\002D\022B/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListClusters",
+            full_name="google.cloud.dataproc.v1.ClusterController.ListClusters",
+            index=4,
+            containing_service=None,
+            input_type=_LISTCLUSTERSREQUEST,
+            output_type=_LISTCLUSTERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1/projects/{project_id}/regions/{region}/clusters"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DiagnoseCluster",
+            full_name="google.cloud.dataproc.v1.ClusterController.DiagnoseCluster",
+            index=5,
+            containing_service=None,
+            input_type=_DIAGNOSECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002P"K/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLUSTERCONTROLLER)
+
+DESCRIPTOR.services_by_name["ClusterController"] = _CLUSTERCONTROLLER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1/proto/clusters_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1/proto/clusters_pb2_grpc.py
new file mode 100644
index 000000000000..5d4b275b8ab0
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/clusters_pb2_grpc.py
@@ -0,0 +1,141 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1.proto import (
+    clusters_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class ClusterControllerStub(object):
+    """The ClusterControllerService provides methods to manage clusters
+  of Compute Engine instances.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1.ClusterController/CreateCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.CreateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1.ClusterController/UpdateCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.UpdateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1.ClusterController/DeleteCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.DeleteClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1.ClusterController/GetCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.GetClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.Cluster.FromString,
+        )
+        self.ListClusters = channel.unary_unary(
+            "/google.cloud.dataproc.v1.ClusterController/ListClusters",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.ListClustersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.ListClustersResponse.FromString,
+        )
+        self.DiagnoseCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1.ClusterController/DiagnoseCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.DiagnoseClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ClusterControllerServicer(object):
+    """The ClusterControllerService provides methods to manage clusters
+  of Compute Engine instances.
+  """
+
+    def CreateCluster(self, request, context):
+        """Creates a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCluster(self, request, context):
+        """Updates a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteCluster(self, request, context):
+        """Deletes a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCluster(self, request, context):
+        """Gets the resource representation for a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListClusters(self, request, context):
+        """Lists all regions/{region}/clusters in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DiagnoseCluster(self, request, context):
+        """Gets cluster diagnostic information.
+    After the operation completes, the Operation.response field
+    contains `DiagnoseClusterOutputLocation`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ClusterControllerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.CreateClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.UpdateClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.DeleteClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.GetClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.Cluster.SerializeToString,
+        ),
+        "ListClusters": grpc.unary_unary_rpc_method_handler(
+            servicer.ListClusters,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.ListClustersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.ListClustersResponse.SerializeToString,
+        ),
+        "DiagnoseCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DiagnoseCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.DiagnoseClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1.ClusterController", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1/proto/jobs.proto b/dataproc/google/cloud/dataproc_v1/proto/jobs.proto
new file mode 100644
index 000000000000..7ead7bb95ca0
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/jobs.proto
@@ -0,0 +1,779 @@
+// 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.dataproc.v1;
+
+import "google/api/annotations.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/dataproc/v1;dataproc";
+option java_multiple_files = true;
+option java_outer_classname = "JobsProto";
+option java_package = "com.google.cloud.dataproc.v1";
+
+// The JobController provides methods to manage jobs.
+service JobController {
+  // 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: "*"
+    };
+  }
+
+  // Gets the resource representation for a job in a project.
+  rpc GetJob(GetJobRequest) returns (Job) {
+    option (google.api.http) = {
+      get: "/v1/projects/{project_id}/regions/{region}/jobs/{job_id}"
+    };
+  }
+
+  // Lists regions/{region}/jobs in a project.
+  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1/projects/{project_id}/regions/{region}/jobs"
+    };
+  }
+
+  // Updates a job in a project.
+  rpc UpdateJob(UpdateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      patch: "/v1/projects/{project_id}/regions/{region}/jobs/{job_id}"
+      body: "job"
+    };
+  }
+
+  // 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)
+  // or
+  // [regions/{region}/jobs.get](/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: "*"
+    };
+  }
+
+  // Deletes the job from the project. If the job is active, the delete fails,
+  // and the response returns `FAILED_PRECONDITION`.
+  rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/projects/{project_id}/regions/{region}/jobs/{job_id}"
+    };
+  }
+}
+
+// The runtime logging config of the job.
+message LoggingConfig {
+  // The Log4j level for job execution. When running an
+  // [Apache Hive](http://hive.apache.org/) job, Cloud
+  // Dataproc configures the Hive client to an equivalent verbosity level.
+  enum Level {
+    // Level is unspecified. Use default level for log4j.
+    LEVEL_UNSPECIFIED = 0;
+
+    // Use ALL level for log4j.
+    ALL = 1;
+
+    // Use TRACE level for log4j.
+    TRACE = 2;
+
+    // Use DEBUG level for log4j.
+    DEBUG = 3;
+
+    // Use INFO level for log4j.
+    INFO = 4;
+
+    // Use WARN level for log4j.
+    WARN = 5;
+
+    // Use ERROR level for log4j.
+    ERROR = 6;
+
+    // Use FATAL level for log4j.
+    FATAL = 7;
+
+    // Turn off log4j.
+    OFF = 8;
+  }
+
+  // The per-package log levels for the driver. This may include
+  // "root" package name to configure rootLogger.
+  // Examples:
+  //   'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG'
+  map<string, Level> driver_log_levels = 2;
+}
+
+// A Cloud 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
+// YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html).
+message HadoopJob {
+  // Required. Indicates the location of the driver's main class. Specify
+  // either the jar file that contains the main class or the main class name.
+  // To specify both, add the jar file to `jar_file_uris`, and then specify
+  // the main class name in this property.
+  oneof driver {
+    // The HCFS URI of the jar file containing the main class.
+    // Examples:
+    //     'gs://foo-bucket/analytics-binaries/extract-useful-metrics-mr.jar'
+    //     'hdfs:/tmp/test-samples/custom-wordcount.jar'
+    //     'file:///home/usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar'
+    string main_jar_file_uri = 1;
+
+    // The name of the driver's main class. The jar file containing the class
+    // must be in the default CLASSPATH or specified in `jar_file_uris`.
+    string main_class = 2;
+  }
+
+  // Optional. The arguments to pass to the driver. Do not
+  // 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;
+
+  // Optional. Jar file URIs to add to the CLASSPATHs of the
+  // Hadoop driver and tasks.
+  repeated string jar_file_uris = 4;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in /etc/hadoop/conf/*-site and
+  // classes in user code.
+  map<string, string> properties = 7;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 8;
+}
+
+// A Cloud 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.
+  // 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;
+
+    // The name of the driver's main class. The jar file that contains the class
+    // must be in the default CLASSPATH or specified in `jar_file_uris`.
+    string main_class = 2;
+  }
+
+  // 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;
+
+  // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+  // Spark driver and tasks.
+  repeated string jar_file_uris = 4;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in
+  // /etc/spark/conf/spark-defaults.conf and classes in user code.
+  map<string, string> properties = 7;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 8;
+}
+
+// A Cloud 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;
+
+  // 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;
+
+  // 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;
+
+  // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+  // Python driver and tasks.
+  repeated string jar_file_uris = 4;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in
+  // /etc/spark/conf/spark-defaults.conf and classes in user code.
+  map<string, string> properties = 7;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 8;
+}
+
+// A list of queries to run on a cluster.
+message QueryList {
+  // Required. The queries to execute. You do not need to terminate a query
+  // with a semicolon. Multiple queries can be specified in one string
+  // by separating each with a semicolon. Here is an example of an Cloud
+  // Dataproc API snippet that uses a QueryList to specify a HiveJob:
+  //
+  //     "hiveJob": {
+  //       "queryList": {
+  //         "queries": [
+  //           "query1",
+  //           "query2",
+  //           "query3;query4",
+  //         ]
+  //       }
+  //     }
+  repeated string queries = 1;
+}
+
+// A Cloud 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
+  // an HCFS file URI or a list of queries.
+  oneof queries {
+    // The HCFS URI of the script that contains Hive 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;
+
+  // Optional. Mapping of query variable names to values (equivalent to the
+  // Hive command: `SET name="value";`).
+  map<string, string> script_variables = 4;
+
+  // 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
+  // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml,
+  // /etc/hive/conf/hive-site.xml, and classes in user code.
+  map<string, string> properties = 5;
+
+  // 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;
+}
+
+// A Cloud 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
+  // 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. Mapping of query variable names to values (equivalent to the
+  // Spark SQL command: SET `name="value";`).
+  map<string, string> script_variables = 3;
+
+  // 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<string, string> properties = 4;
+
+  // Optional. HCFS URIs of jar files to be added to the Spark CLASSPATH.
+  repeated string jar_file_uris = 56;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 6;
+}
+
+// A Cloud 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
+  // file URI or a list of queries.
+  oneof queries {
+    // The HCFS URI of the script that contains the Pig 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;
+
+  // Optional. Mapping of query variable names to values (equivalent to the Pig
+  // command: `name=[value]`).
+  map<string, string> script_variables = 4;
+
+  // 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
+  // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml,
+  // /etc/pig/conf/pig.properties, and classes in user code.
+  map<string, string> properties = 5;
+
+  // 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;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 7;
+}
+
+// Cloud Dataproc job config.
+message JobPlacement {
+  // Required. The name of the cluster where the job will be submitted.
+  string cluster_name = 1;
+
+  // Output only. A cluster UUID generated by the Cloud Dataproc service when
+  // the job is submitted.
+  string cluster_uuid = 2;
+}
+
+// Cloud Dataproc job status.
+message JobStatus {
+  // The job state.
+  enum State {
+    // The job state is unknown.
+    STATE_UNSPECIFIED = 0;
+
+    // The job is pending; it has been submitted, but is not yet running.
+    PENDING = 1;
+
+    // Job has been received by the service and completed initial setup;
+    // it will soon be submitted to the cluster.
+    SETUP_DONE = 8;
+
+    // The job is running on the cluster.
+    RUNNING = 2;
+
+    // A CancelJob request has been received, but is pending.
+    CANCEL_PENDING = 3;
+
+    // Transient in-flight resources have been canceled, and the request to
+    // cancel the running job has been issued to the cluster.
+    CANCEL_STARTED = 7;
+
+    // The job cancellation was successful.
+    CANCELLED = 4;
+
+    // The job has completed successfully.
+    DONE = 5;
+
+    // The job has completed, but encountered an error.
+    ERROR = 6;
+
+    // Job attempt has failed. The detail field contains failure details for
+    // this attempt.
+    //
+    // Applies to restartable jobs only.
+    ATTEMPT_FAILURE = 9;
+  }
+
+  // The job substate.
+  enum Substate {
+    // The job substate is unknown.
+    UNSPECIFIED = 0;
+
+    // The Job is submitted to the agent.
+    //
+    // Applies to RUNNING state.
+    SUBMITTED = 1;
+
+    // The Job has been received and is awaiting execution (it may be waiting
+    // for a condition to be met). See the "details" field for the reason for
+    // the delay.
+    //
+    // Applies to RUNNING state.
+    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
+    // agent does not send a timely update, the job will fail.
+    //
+    // Applies to RUNNING state.
+    STALE_STATUS = 3;
+  }
+
+  // Output only. A state message specifying the overall job state.
+  State state = 1;
+
+  // Output only. Optional job state details, such as an error
+  // description if the state is <code>ERROR</code>.
+  string details = 2;
+
+  // Output only. The time when this state was entered.
+  google.protobuf.Timestamp state_start_time = 6;
+
+  // Output only. Additional state information, which includes
+  // status reported by the agent.
+  Substate substate = 7;
+}
+
+// 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;
+
+  // 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;
+}
+
+// A YARN application created by a job. Application information is a subset of
+// <code>org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto</code>.
+//
+// **Beta Feature**: This report is available for testing purposes only. It may
+// be changed before final release.
+message YarnApplication {
+  // The application state, corresponding to
+  // <code>YarnProtos.YarnApplicationStateProto</code>.
+  enum State {
+    // Status is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // Status is NEW.
+    NEW = 1;
+
+    // Status is NEW_SAVING.
+    NEW_SAVING = 2;
+
+    // Status is SUBMITTED.
+    SUBMITTED = 3;
+
+    // Status is ACCEPTED.
+    ACCEPTED = 4;
+
+    // Status is RUNNING.
+    RUNNING = 5;
+
+    // Status is FINISHED.
+    FINISHED = 6;
+
+    // Status is FAILED.
+    FAILED = 7;
+
+    // Status is KILLED.
+    KILLED = 8;
+  }
+
+  // Required. The application name.
+  string name = 1;
+
+  // Required. The application state.
+  State state = 2;
+
+  // Required. The numerical progress of the application, from 1 to 100.
+  float progress = 3;
+
+  // 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;
+}
+
+// A Cloud 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
+  // <code>job_id</code>.
+  JobReference reference = 1;
+
+  // Required. Job information, including how, when, and where to
+  // run the job.
+  JobPlacement placement = 2;
+
+  // Required. The application/framework-specific portion of the job.
+  oneof type_job {
+    // Job is a Hadoop job.
+    HadoopJob hadoop_job = 3;
+
+    // Job is a Spark job.
+    SparkJob spark_job = 4;
+
+    // Job is a Pyspark job.
+    PySparkJob pyspark_job = 5;
+
+    // Job is a Hive job.
+    HiveJob hive_job = 6;
+
+    // Job is a Pig job.
+    PigJob pig_job = 7;
+
+    // Job is a SparkSql job.
+    SparkSqlJob spark_sql_job = 12;
+  }
+
+  // Output only. The job status. Additional application-specific
+  // status information may be contained in the <code>type_job</code>
+  // and <code>yarn_applications</code> fields.
+  JobStatus status = 8;
+
+  // Output only. The previous job status.
+  repeated JobStatus status_history = 13;
+
+  // 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;
+
+  // Output only. A URI pointing to the location of the stdout of the job's
+  // driver program.
+  string driver_output_resource_uri = 17;
+
+  // 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;
+
+  // Optional. The labels to associate with this job.
+  // Label **keys** must contain 1 to 63 characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  // Label **values** may be empty, but, if present, must contain 1 to 63
+  // 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<string, string> labels = 18;
+
+  // Optional. Job scheduling configuration.
+  JobScheduling scheduling = 20;
+
+  // 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;
+}
+
+// Job scheduling options.
+message JobScheduling {
+  // Optional. Maximum number of times per hour a driver may be restarted as
+  // a result of driver terminating with non-zero code before job is
+  // reported failed.
+  //
+  // A job may be reported as thrashing if driver exits with non-zero code
+  // 4 times within 10 minute window.
+  //
+  // Maximum value is 10.
+  int32 max_failures_per_hour = 1;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job resource.
+  Job job = 2;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [SubmitJobRequest][google.cloud.dataproc.v1.SubmitJobRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [Job][google.cloud.dataproc.v1.Job] created and stored in the backend
+  // is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job ID.
+  string job_id = 2;
+}
+
+// A request to list jobs in a project.
+message ListJobsRequest {
+  // A matcher that specifies categories of job states.
+  enum JobStateMatcher {
+    // Match all jobs, regardless of state.
+    ALL = 0;
+
+    // Only match jobs in non-terminal states: PENDING, RUNNING, or
+    // CANCEL_PENDING.
+    ACTIVE = 1;
+
+    // Only match jobs in terminal states: CANCELLED, DONE, or ERROR.
+    NON_ACTIVE = 2;
+  }
+
+  // Required. The ID of the Google Cloud Platform project that the job
+  // belongs to.
+  string project_id = 1;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 6;
+
+  // Optional. The number of results to return in each response.
+  int32 page_size = 2;
+
+  // Optional. The page token, returned by a previous call, to request the
+  // next page of results.
+  string page_token = 3;
+
+  // Optional. If set, the returned jobs list includes only jobs that were
+  // submitted to the named cluster.
+  string cluster_name = 4;
+
+  // 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;
+
+  // Optional. A filter constraining the jobs to list. Filters are
+  // case-sensitive and have the following syntax:
+  //
+  // [field = value] AND [field [= value]] ...
+  //
+  // where **field** is `status.state` or `labels.[KEY]`, and `[KEY]` is a label
+  // key. **value** can be `*` to match all values.
+  // `status.state` can be either `ACTIVE` or `NON_ACTIVE`.
+  // Only the logical `AND` operator is supported; space-separated items are
+  // treated as having an implicit `AND` operator.
+  //
+  // Example filter:
+  //
+  // status.state = ACTIVE AND labels.env = staging AND labels.starred = *
+  string filter = 7;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 2;
+
+  // Required. The job ID.
+  string job_id = 3;
+
+  // Required. The changes to the job.
+  Job job = 4;
+
+  // Required. Specifies the path, relative to <code>Job</code>, of
+  // the field to update. For example, to update the labels of a Job the
+  // <code>update_mask</code> parameter would be specified as
+  // <code>labels</code>, and the `PATCH` request body would specify the new
+  // value. <strong>Note:</strong> Currently, <code>labels</code> is the only
+  // field that can be updated.
+  google.protobuf.FieldMask update_mask = 5;
+}
+
+// A list of jobs in a project.
+message ListJobsResponse {
+  // Output only. Jobs list.
+  repeated Job jobs = 1;
+
+  // 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 <code>ListJobsRequest</code>.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job ID.
+  string job_id = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job ID.
+  string job_id = 2;
+}
diff --git a/dataproc/google/cloud/dataproc_v1/proto/jobs_pb2.py b/dataproc/google/cloud/dataproc_v1/proto/jobs_pb2.py
new file mode 100644
index 000000000000..67011adb07f3
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/jobs_pb2.py
@@ -0,0 +1,4250 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1/proto/jobs.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1/proto/jobs.proto",
+    package="google.cloud.dataproc.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.dataproc.v1B\tJobsProtoP\001Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n)google/cloud/dataproc_v1/proto/jobs.proto\x12\x18google.cloud.dataproc.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xc1\x02\n\rLoggingConfig\x12W\n\x11\x64river_log_levels\x18\x02 \x03(\x0b\x32<.google.cloud.dataproc.v1.LoggingConfig.DriverLogLevelsEntry\x1a\x65\n\x14\x44riverLogLevelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12<\n\x05value\x18\x02 \x01(\x0e\x32-.google.cloud.dataproc.v1.LoggingConfig.Level:\x02\x38\x01"p\n\x05Level\x12\x15\n\x11LEVEL_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41LL\x10\x01\x12\t\n\x05TRACE\x10\x02\x12\t\n\x05\x44\x45\x42UG\x10\x03\x12\x08\n\x04INFO\x10\x04\x12\x08\n\x04WARN\x10\x05\x12\t\n\x05\x45RROR\x10\x06\x12\t\n\x05\x46\x41TAL\x10\x07\x12\x07\n\x03OFF\x10\x08"\xd3\x02\n\tHadoopJob\x12\x1b\n\x11main_jar_file_uri\x18\x01 \x01(\tH\x00\x12\x14\n\nmain_class\x18\x02 \x01(\tH\x00\x12\x0c\n\x04\x61rgs\x18\x03 \x03(\t\x12\x15\n\rjar_file_uris\x18\x04 \x03(\t\x12\x11\n\tfile_uris\x18\x05 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x06 \x03(\t\x12G\n\nproperties\x18\x07 \x03(\x0b\x32\x33.google.cloud.dataproc.v1.HadoopJob.PropertiesEntry\x12?\n\x0elogging_config\x18\x08 \x01(\x0b\x32\'.google.cloud.dataproc.v1.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x08\n\x06\x64river"\xd1\x02\n\x08SparkJob\x12\x1b\n\x11main_jar_file_uri\x18\x01 \x01(\tH\x00\x12\x14\n\nmain_class\x18\x02 \x01(\tH\x00\x12\x0c\n\x04\x61rgs\x18\x03 \x03(\t\x12\x15\n\rjar_file_uris\x18\x04 \x03(\t\x12\x11\n\tfile_uris\x18\x05 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x06 \x03(\t\x12\x46\n\nproperties\x18\x07 \x03(\x0b\x32\x32.google.cloud.dataproc.v1.SparkJob.PropertiesEntry\x12?\n\x0elogging_config\x18\x08 \x01(\x0b\x32\'.google.cloud.dataproc.v1.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x08\n\x06\x64river"\xd0\x02\n\nPySparkJob\x12\x1c\n\x14main_python_file_uri\x18\x01 \x01(\t\x12\x0c\n\x04\x61rgs\x18\x02 \x03(\t\x12\x18\n\x10python_file_uris\x18\x03 \x03(\t\x12\x15\n\rjar_file_uris\x18\x04 \x03(\t\x12\x11\n\tfile_uris\x18\x05 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x06 \x03(\t\x12H\n\nproperties\x18\x07 \x03(\x0b\x32\x34.google.cloud.dataproc.v1.PySparkJob.PropertiesEntry\x12?\n\x0elogging_config\x18\x08 \x01(\x0b\x32\'.google.cloud.dataproc.v1.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x1c\n\tQueryList\x12\x0f\n\x07queries\x18\x01 \x03(\t"\xa1\x03\n\x07HiveJob\x12\x18\n\x0equery_file_uri\x18\x01 \x01(\tH\x00\x12\x39\n\nquery_list\x18\x02 \x01(\x0b\x32#.google.cloud.dataproc.v1.QueryListH\x00\x12\x1b\n\x13\x63ontinue_on_failure\x18\x03 \x01(\x08\x12P\n\x10script_variables\x18\x04 \x03(\x0b\x32\x36.google.cloud.dataproc.v1.HiveJob.ScriptVariablesEntry\x12\x45\n\nproperties\x18\x05 \x03(\x0b\x32\x31.google.cloud.dataproc.v1.HiveJob.PropertiesEntry\x12\x15\n\rjar_file_uris\x18\x06 \x03(\t\x1a\x36\n\x14ScriptVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07queries"\xd1\x03\n\x0bSparkSqlJob\x12\x18\n\x0equery_file_uri\x18\x01 \x01(\tH\x00\x12\x39\n\nquery_list\x18\x02 \x01(\x0b\x32#.google.cloud.dataproc.v1.QueryListH\x00\x12T\n\x10script_variables\x18\x03 \x03(\x0b\x32:.google.cloud.dataproc.v1.SparkSqlJob.ScriptVariablesEntry\x12I\n\nproperties\x18\x04 \x03(\x0b\x32\x35.google.cloud.dataproc.v1.SparkSqlJob.PropertiesEntry\x12\x15\n\rjar_file_uris\x18\x38 \x03(\t\x12?\n\x0elogging_config\x18\x06 \x01(\x0b\x32\'.google.cloud.dataproc.v1.LoggingConfig\x1a\x36\n\x14ScriptVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07queries"\xdf\x03\n\x06PigJob\x12\x18\n\x0equery_file_uri\x18\x01 \x01(\tH\x00\x12\x39\n\nquery_list\x18\x02 \x01(\x0b\x32#.google.cloud.dataproc.v1.QueryListH\x00\x12\x1b\n\x13\x63ontinue_on_failure\x18\x03 \x01(\x08\x12O\n\x10script_variables\x18\x04 \x03(\x0b\x32\x35.google.cloud.dataproc.v1.PigJob.ScriptVariablesEntry\x12\x44\n\nproperties\x18\x05 \x03(\x0b\x32\x30.google.cloud.dataproc.v1.PigJob.PropertiesEntry\x12\x15\n\rjar_file_uris\x18\x06 \x03(\t\x12?\n\x0elogging_config\x18\x07 \x01(\x0b\x32\'.google.cloud.dataproc.v1.LoggingConfig\x1a\x36\n\x14ScriptVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07queries":\n\x0cJobPlacement\x12\x14\n\x0c\x63luster_name\x18\x01 \x01(\t\x12\x14\n\x0c\x63luster_uuid\x18\x02 \x01(\t"\xc2\x03\n\tJobStatus\x12\x38\n\x05state\x18\x01 \x01(\x0e\x32).google.cloud.dataproc.v1.JobStatus.State\x12\x0f\n\x07\x64\x65tails\x18\x02 \x01(\t\x12\x34\n\x10state_start_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12>\n\x08substate\x18\x07 \x01(\x0e\x32,.google.cloud.dataproc.v1.JobStatus.Substate"\xa9\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0e\n\nSETUP_DONE\x10\x08\x12\x0b\n\x07RUNNING\x10\x02\x12\x12\n\x0e\x43\x41NCEL_PENDING\x10\x03\x12\x12\n\x0e\x43\x41NCEL_STARTED\x10\x07\x12\r\n\tCANCELLED\x10\x04\x12\x08\n\x04\x44ONE\x10\x05\x12\t\n\x05\x45RROR\x10\x06\x12\x13\n\x0f\x41TTEMPT_FAILURE\x10\t"H\n\x08Substate\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\r\n\tSUBMITTED\x10\x01\x12\n\n\x06QUEUED\x10\x02\x12\x10\n\x0cSTALE_STATUS\x10\x03"2\n\x0cJobReference\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t"\x91\x02\n\x0fYarnApplication\x12\x0c\n\x04name\x18\x01 \x01(\t\x12>\n\x05state\x18\x02 \x01(\x0e\x32/.google.cloud.dataproc.v1.YarnApplication.State\x12\x10\n\x08progress\x18\x03 \x01(\x02\x12\x14\n\x0ctracking_url\x18\x04 \x01(\t"\x87\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x07\n\x03NEW\x10\x01\x12\x0e\n\nNEW_SAVING\x10\x02\x12\r\n\tSUBMITTED\x10\x03\x12\x0c\n\x08\x41\x43\x43\x45PTED\x10\x04\x12\x0b\n\x07RUNNING\x10\x05\x12\x0c\n\x08\x46INISHED\x10\x06\x12\n\n\x06\x46\x41ILED\x10\x07\x12\n\n\x06KILLED\x10\x08"\x9b\x07\n\x03Job\x12\x39\n\treference\x18\x01 \x01(\x0b\x32&.google.cloud.dataproc.v1.JobReference\x12\x39\n\tplacement\x18\x02 \x01(\x0b\x32&.google.cloud.dataproc.v1.JobPlacement\x12\x39\n\nhadoop_job\x18\x03 \x01(\x0b\x32#.google.cloud.dataproc.v1.HadoopJobH\x00\x12\x37\n\tspark_job\x18\x04 \x01(\x0b\x32".google.cloud.dataproc.v1.SparkJobH\x00\x12;\n\x0bpyspark_job\x18\x05 \x01(\x0b\x32$.google.cloud.dataproc.v1.PySparkJobH\x00\x12\x35\n\x08hive_job\x18\x06 \x01(\x0b\x32!.google.cloud.dataproc.v1.HiveJobH\x00\x12\x33\n\x07pig_job\x18\x07 \x01(\x0b\x32 .google.cloud.dataproc.v1.PigJobH\x00\x12>\n\rspark_sql_job\x18\x0c \x01(\x0b\x32%.google.cloud.dataproc.v1.SparkSqlJobH\x00\x12\x33\n\x06status\x18\x08 \x01(\x0b\x32#.google.cloud.dataproc.v1.JobStatus\x12;\n\x0estatus_history\x18\r \x03(\x0b\x32#.google.cloud.dataproc.v1.JobStatus\x12\x44\n\x11yarn_applications\x18\t \x03(\x0b\x32).google.cloud.dataproc.v1.YarnApplication\x12"\n\x1a\x64river_output_resource_uri\x18\x11 \x01(\t\x12 \n\x18\x64river_control_files_uri\x18\x0f \x01(\t\x12\x39\n\x06labels\x18\x12 \x03(\x0b\x32).google.cloud.dataproc.v1.Job.LabelsEntry\x12;\n\nscheduling\x18\x14 \x01(\x0b\x32\'.google.cloud.dataproc.v1.JobScheduling\x12\x10\n\x08job_uuid\x18\x16 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\n\n\x08type_job".\n\rJobScheduling\x12\x1d\n\x15max_failures_per_hour\x18\x01 \x01(\x05"v\n\x10SubmitJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12*\n\x03job\x18\x02 \x01(\x0b\x32\x1d.google.cloud.dataproc.v1.Job\x12\x12\n\nrequest_id\x18\x04 \x01(\t"C\n\rGetJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t"\x90\x02\n\x0fListJobsRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x06 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x04 \x01(\t\x12T\n\x11job_state_matcher\x18\x05 \x01(\x0e\x32\x39.google.cloud.dataproc.v1.ListJobsRequest.JobStateMatcher\x12\x0e\n\x06\x66ilter\x18\x07 \x01(\t"6\n\x0fJobStateMatcher\x12\x07\n\x03\x41LL\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0e\n\nNON_ACTIVE\x10\x02"\xa3\x01\n\x10UpdateJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x02 \x01(\t\x12\x0e\n\x06job_id\x18\x03 \x01(\t\x12*\n\x03job\x18\x04 \x01(\x0b\x32\x1d.google.cloud.dataproc.v1.Job\x12/\n\x0bupdate_mask\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"X\n\x10ListJobsResponse\x12+\n\x04jobs\x18\x01 \x03(\x0b\x32\x1d.google.cloud.dataproc.v1.Job\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"F\n\x10\x43\x61ncelJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t"F\n\x10\x44\x65leteJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t2\xb6\x07\n\rJobController\x12\x99\x01\n\tSubmitJob\x12*.google.cloud.dataproc.v1.SubmitJobRequest\x1a\x1d.google.cloud.dataproc.v1.Job"A\x82\xd3\xe4\x93\x02;"6/v1/projects/{project_id}/regions/{region}/jobs:submit:\x01*\x12\x92\x01\n\x06GetJob\x12\'.google.cloud.dataproc.v1.GetJobRequest\x1a\x1d.google.cloud.dataproc.v1.Job"@\x82\xd3\xe4\x93\x02:\x12\x38/v1/projects/{project_id}/regions/{region}/jobs/{job_id}\x12\x9a\x01\n\x08ListJobs\x12).google.cloud.dataproc.v1.ListJobsRequest\x1a*.google.cloud.dataproc.v1.ListJobsResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v1/projects/{project_id}/regions/{region}/jobs\x12\x9d\x01\n\tUpdateJob\x12*.google.cloud.dataproc.v1.UpdateJobRequest\x1a\x1d.google.cloud.dataproc.v1.Job"E\x82\xd3\xe4\x93\x02?28/v1/projects/{project_id}/regions/{region}/jobs/{job_id}:\x03job\x12\xa2\x01\n\tCancelJob\x12*.google.cloud.dataproc.v1.CancelJobRequest\x1a\x1d.google.cloud.dataproc.v1.Job"J\x82\xd3\xe4\x93\x02\x44"?/v1/projects/{project_id}/regions/{region}/jobs/{job_id}:cancel:\x01*\x12\x91\x01\n\tDeleteJob\x12*.google.cloud.dataproc.v1.DeleteJobRequest\x1a\x16.google.protobuf.Empty"@\x82\xd3\xe4\x93\x02:*8/v1/projects/{project_id}/regions/{region}/jobs/{job_id}Bm\n\x1c\x63om.google.cloud.dataproc.v1B\tJobsProtoP\x01Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGGINGCONFIG_LEVEL = _descriptor.EnumDescriptor(
+    name="Level",
+    full_name="google.cloud.dataproc.v1.LoggingConfig.Level",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TRACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEBUG", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INFO", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WARN", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FATAL", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OFF", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=407,
+    serialized_end=519,
+)
+_sym_db.RegisterEnumDescriptor(_LOGGINGCONFIG_LEVEL)
+
+_JOBSTATUS_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1.JobStatus.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SETUP_DONE", index=2, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=3, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCEL_PENDING", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCEL_STARTED", index=5, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=6, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=7, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=8, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTEMPT_FAILURE",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3210,
+    serialized_end=3379,
+)
+_sym_db.RegisterEnumDescriptor(_JOBSTATUS_STATE)
+
+_JOBSTATUS_SUBSTATE = _descriptor.EnumDescriptor(
+    name="Substate",
+    full_name="google.cloud.dataproc.v1.JobStatus.Substate",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUBMITTED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="QUEUED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STALE_STATUS", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3381,
+    serialized_end=3453,
+)
+_sym_db.RegisterEnumDescriptor(_JOBSTATUS_SUBSTATE)
+
+_YARNAPPLICATION_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1.YarnApplication.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEW", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEW_SAVING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUBMITTED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCEPTED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KILLED", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3646,
+    serialized_end=3781,
+)
+_sym_db.RegisterEnumDescriptor(_YARNAPPLICATION_STATE)
+
+_LISTJOBSREQUEST_JOBSTATEMATCHER = _descriptor.EnumDescriptor(
+    name="JobStateMatcher",
+    full_name="google.cloud.dataproc.v1.ListJobsRequest.JobStateMatcher",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ALL", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NON_ACTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5165,
+    serialized_end=5219,
+)
+_sym_db.RegisterEnumDescriptor(_LISTJOBSREQUEST_JOBSTATEMATCHER)
+
+
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY = _descriptor.Descriptor(
+    name="DriverLogLevelsEntry",
+    full_name="google.cloud.dataproc.v1.LoggingConfig.DriverLogLevelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.LoggingConfig.DriverLogLevelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.LoggingConfig.DriverLogLevelsEntry.value",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=304,
+    serialized_end=405,
+)
+
+_LOGGINGCONFIG = _descriptor.Descriptor(
+    name="LoggingConfig",
+    full_name="google.cloud.dataproc.v1.LoggingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="driver_log_levels",
+            full_name="google.cloud.dataproc.v1.LoggingConfig.driver_log_levels",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY],
+    enum_types=[_LOGGINGCONFIG_LEVEL],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=198,
+    serialized_end=519,
+)
+
+
+_HADOOPJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.HadoopJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.HadoopJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.HadoopJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=851,
+)
+
+_HADOOPJOB = _descriptor.Descriptor(
+    name="HadoopJob",
+    full_name="google.cloud.dataproc.v1.HadoopJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_jar_file_uri",
+            full_name="google.cloud.dataproc.v1.HadoopJob.main_jar_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="main_class",
+            full_name="google.cloud.dataproc.v1.HadoopJob.main_class",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1.HadoopJob.args",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1.HadoopJob.jar_file_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1.HadoopJob.file_uris",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1.HadoopJob.archive_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.HadoopJob.properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1.HadoopJob.logging_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HADOOPJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="driver",
+            full_name="google.cloud.dataproc.v1.HadoopJob.driver",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=522,
+    serialized_end=861,
+)
+
+
+_SPARKJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.SparkJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.SparkJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.SparkJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=851,
+)
+
+_SPARKJOB = _descriptor.Descriptor(
+    name="SparkJob",
+    full_name="google.cloud.dataproc.v1.SparkJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_jar_file_uri",
+            full_name="google.cloud.dataproc.v1.SparkJob.main_jar_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="main_class",
+            full_name="google.cloud.dataproc.v1.SparkJob.main_class",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1.SparkJob.args",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1.SparkJob.jar_file_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1.SparkJob.file_uris",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1.SparkJob.archive_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.SparkJob.properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1.SparkJob.logging_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPARKJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="driver",
+            full_name="google.cloud.dataproc.v1.SparkJob.driver",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=864,
+    serialized_end=1201,
+)
+
+
+_PYSPARKJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.PySparkJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.PySparkJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.PySparkJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=851,
+)
+
+_PYSPARKJOB = _descriptor.Descriptor(
+    name="PySparkJob",
+    full_name="google.cloud.dataproc.v1.PySparkJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_python_file_uri",
+            full_name="google.cloud.dataproc.v1.PySparkJob.main_python_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1.PySparkJob.args",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="python_file_uris",
+            full_name="google.cloud.dataproc.v1.PySparkJob.python_file_uris",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1.PySparkJob.jar_file_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1.PySparkJob.file_uris",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1.PySparkJob.archive_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.PySparkJob.properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1.PySparkJob.logging_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PYSPARKJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1204,
+    serialized_end=1540,
+)
+
+
+_QUERYLIST = _descriptor.Descriptor(
+    name="QueryList",
+    full_name="google.cloud.dataproc.v1.QueryList",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1.QueryList.queries",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1542,
+    serialized_end=1570,
+)
+
+
+_HIVEJOB_SCRIPTVARIABLESENTRY = _descriptor.Descriptor(
+    name="ScriptVariablesEntry",
+    full_name="google.cloud.dataproc.v1.HiveJob.ScriptVariablesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.HiveJob.ScriptVariablesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.HiveJob.ScriptVariablesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1874,
+    serialized_end=1928,
+)
+
+_HIVEJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.HiveJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.HiveJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.HiveJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=851,
+)
+
+_HIVEJOB = _descriptor.Descriptor(
+    name="HiveJob",
+    full_name="google.cloud.dataproc.v1.HiveJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_file_uri",
+            full_name="google.cloud.dataproc.v1.HiveJob.query_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_list",
+            full_name="google.cloud.dataproc.v1.HiveJob.query_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="continue_on_failure",
+            full_name="google.cloud.dataproc.v1.HiveJob.continue_on_failure",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="script_variables",
+            full_name="google.cloud.dataproc.v1.HiveJob.script_variables",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.HiveJob.properties",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1.HiveJob.jar_file_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HIVEJOB_SCRIPTVARIABLESENTRY, _HIVEJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1.HiveJob.queries",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1573,
+    serialized_end=1990,
+)
+
+
+_SPARKSQLJOB_SCRIPTVARIABLESENTRY = _descriptor.Descriptor(
+    name="ScriptVariablesEntry",
+    full_name="google.cloud.dataproc.v1.SparkSqlJob.ScriptVariablesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.ScriptVariablesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.ScriptVariablesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1874,
+    serialized_end=1928,
+)
+
+_SPARKSQLJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.SparkSqlJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=851,
+)
+
+_SPARKSQLJOB = _descriptor.Descriptor(
+    name="SparkSqlJob",
+    full_name="google.cloud.dataproc.v1.SparkSqlJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_file_uri",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.query_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_list",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.query_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="script_variables",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.script_variables",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.properties",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.jar_file_uris",
+            index=4,
+            number=56,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.logging_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPARKSQLJOB_SCRIPTVARIABLESENTRY, _SPARKSQLJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1.SparkSqlJob.queries",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1993,
+    serialized_end=2458,
+)
+
+
+_PIGJOB_SCRIPTVARIABLESENTRY = _descriptor.Descriptor(
+    name="ScriptVariablesEntry",
+    full_name="google.cloud.dataproc.v1.PigJob.ScriptVariablesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.PigJob.ScriptVariablesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.PigJob.ScriptVariablesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1874,
+    serialized_end=1928,
+)
+
+_PIGJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1.PigJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.PigJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.PigJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=851,
+)
+
+_PIGJOB = _descriptor.Descriptor(
+    name="PigJob",
+    full_name="google.cloud.dataproc.v1.PigJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_file_uri",
+            full_name="google.cloud.dataproc.v1.PigJob.query_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_list",
+            full_name="google.cloud.dataproc.v1.PigJob.query_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="continue_on_failure",
+            full_name="google.cloud.dataproc.v1.PigJob.continue_on_failure",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="script_variables",
+            full_name="google.cloud.dataproc.v1.PigJob.script_variables",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1.PigJob.properties",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1.PigJob.jar_file_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1.PigJob.logging_config",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PIGJOB_SCRIPTVARIABLESENTRY, _PIGJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1.PigJob.queries",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2461,
+    serialized_end=2940,
+)
+
+
+_JOBPLACEMENT = _descriptor.Descriptor(
+    name="JobPlacement",
+    full_name="google.cloud.dataproc.v1.JobPlacement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.JobPlacement.cluster_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1.JobPlacement.cluster_uuid",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2942,
+    serialized_end=3000,
+)
+
+
+_JOBSTATUS = _descriptor.Descriptor(
+    name="JobStatus",
+    full_name="google.cloud.dataproc.v1.JobStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1.JobStatus.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="google.cloud.dataproc.v1.JobStatus.details",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_start_time",
+            full_name="google.cloud.dataproc.v1.JobStatus.state_start_time",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="substate",
+            full_name="google.cloud.dataproc.v1.JobStatus.substate",
+            index=3,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_JOBSTATUS_STATE, _JOBSTATUS_SUBSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3003,
+    serialized_end=3453,
+)
+
+
+_JOBREFERENCE = _descriptor.Descriptor(
+    name="JobReference",
+    full_name="google.cloud.dataproc.v1.JobReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.JobReference.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1.JobReference.job_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3455,
+    serialized_end=3505,
+)
+
+
+_YARNAPPLICATION = _descriptor.Descriptor(
+    name="YarnApplication",
+    full_name="google.cloud.dataproc.v1.YarnApplication",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1.YarnApplication.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1.YarnApplication.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress",
+            full_name="google.cloud.dataproc.v1.YarnApplication.progress",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tracking_url",
+            full_name="google.cloud.dataproc.v1.YarnApplication.tracking_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_YARNAPPLICATION_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3508,
+    serialized_end=3781,
+)
+
+
+_JOB_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1.Job.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.Job.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.Job.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4650,
+    serialized_end=4695,
+)
+
+_JOB = _descriptor.Descriptor(
+    name="Job",
+    full_name="google.cloud.dataproc.v1.Job",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference",
+            full_name="google.cloud.dataproc.v1.Job.reference",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="placement",
+            full_name="google.cloud.dataproc.v1.Job.placement",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hadoop_job",
+            full_name="google.cloud.dataproc.v1.Job.hadoop_job",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_job",
+            full_name="google.cloud.dataproc.v1.Job.spark_job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pyspark_job",
+            full_name="google.cloud.dataproc.v1.Job.pyspark_job",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hive_job",
+            full_name="google.cloud.dataproc.v1.Job.hive_job",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pig_job",
+            full_name="google.cloud.dataproc.v1.Job.pig_job",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_sql_job",
+            full_name="google.cloud.dataproc.v1.Job.spark_sql_job",
+            index=7,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.dataproc.v1.Job.status",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_history",
+            full_name="google.cloud.dataproc.v1.Job.status_history",
+            index=9,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="yarn_applications",
+            full_name="google.cloud.dataproc.v1.Job.yarn_applications",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="driver_output_resource_uri",
+            full_name="google.cloud.dataproc.v1.Job.driver_output_resource_uri",
+            index=11,
+            number=17,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="driver_control_files_uri",
+            full_name="google.cloud.dataproc.v1.Job.driver_control_files_uri",
+            index=12,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1.Job.labels",
+            index=13,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scheduling",
+            full_name="google.cloud.dataproc.v1.Job.scheduling",
+            index=14,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_uuid",
+            full_name="google.cloud.dataproc.v1.Job.job_uuid",
+            index=15,
+            number=22,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_JOB_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type_job",
+            full_name="google.cloud.dataproc.v1.Job.type_job",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3784,
+    serialized_end=4707,
+)
+
+
+_JOBSCHEDULING = _descriptor.Descriptor(
+    name="JobScheduling",
+    full_name="google.cloud.dataproc.v1.JobScheduling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_failures_per_hour",
+            full_name="google.cloud.dataproc.v1.JobScheduling.max_failures_per_hour",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4709,
+    serialized_end=4755,
+)
+
+
+_SUBMITJOBREQUEST = _descriptor.Descriptor(
+    name="SubmitJobRequest",
+    full_name="google.cloud.dataproc.v1.SubmitJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.SubmitJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.SubmitJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.dataproc.v1.SubmitJobRequest.job",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1.SubmitJobRequest.request_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4757,
+    serialized_end=4875,
+)
+
+
+_GETJOBREQUEST = _descriptor.Descriptor(
+    name="GetJobRequest",
+    full_name="google.cloud.dataproc.v1.GetJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.GetJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.GetJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1.GetJobRequest.job_id",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4877,
+    serialized_end=4944,
+)
+
+
+_LISTJOBSREQUEST = _descriptor.Descriptor(
+    name="ListJobsRequest",
+    full_name="google.cloud.dataproc.v1.ListJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.region",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.page_size",
+            index=2,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.page_token",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.cluster_name",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_state_matcher",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.job_state_matcher",
+            index=5,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.dataproc.v1.ListJobsRequest.filter",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTJOBSREQUEST_JOBSTATEMATCHER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4947,
+    serialized_end=5219,
+)
+
+
+_UPDATEJOBREQUEST = _descriptor.Descriptor(
+    name="UpdateJobRequest",
+    full_name="google.cloud.dataproc.v1.UpdateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.UpdateJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.UpdateJobRequest.region",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1.UpdateJobRequest.job_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.dataproc.v1.UpdateJobRequest.job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.dataproc.v1.UpdateJobRequest.update_mask",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5222,
+    serialized_end=5385,
+)
+
+
+_LISTJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListJobsResponse",
+    full_name="google.cloud.dataproc.v1.ListJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.dataproc.v1.ListJobsResponse.jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1.ListJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5387,
+    serialized_end=5475,
+)
+
+
+_CANCELJOBREQUEST = _descriptor.Descriptor(
+    name="CancelJobRequest",
+    full_name="google.cloud.dataproc.v1.CancelJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.CancelJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.CancelJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1.CancelJobRequest.job_id",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5477,
+    serialized_end=5547,
+)
+
+
+_DELETEJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteJobRequest",
+    full_name="google.cloud.dataproc.v1.DeleteJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1.DeleteJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1.DeleteJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1.DeleteJobRequest.job_id",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5549,
+    serialized_end=5619,
+)
+
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY.fields_by_name[
+    "value"
+].enum_type = _LOGGINGCONFIG_LEVEL
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY.containing_type = _LOGGINGCONFIG
+_LOGGINGCONFIG.fields_by_name[
+    "driver_log_levels"
+].message_type = _LOGGINGCONFIG_DRIVERLOGLEVELSENTRY
+_LOGGINGCONFIG_LEVEL.containing_type = _LOGGINGCONFIG
+_HADOOPJOB_PROPERTIESENTRY.containing_type = _HADOOPJOB
+_HADOOPJOB.fields_by_name["properties"].message_type = _HADOOPJOB_PROPERTIESENTRY
+_HADOOPJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_HADOOPJOB.oneofs_by_name["driver"].fields.append(
+    _HADOOPJOB.fields_by_name["main_jar_file_uri"]
+)
+_HADOOPJOB.fields_by_name[
+    "main_jar_file_uri"
+].containing_oneof = _HADOOPJOB.oneofs_by_name["driver"]
+_HADOOPJOB.oneofs_by_name["driver"].fields.append(
+    _HADOOPJOB.fields_by_name["main_class"]
+)
+_HADOOPJOB.fields_by_name["main_class"].containing_oneof = _HADOOPJOB.oneofs_by_name[
+    "driver"
+]
+_SPARKJOB_PROPERTIESENTRY.containing_type = _SPARKJOB
+_SPARKJOB.fields_by_name["properties"].message_type = _SPARKJOB_PROPERTIESENTRY
+_SPARKJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_SPARKJOB.oneofs_by_name["driver"].fields.append(
+    _SPARKJOB.fields_by_name["main_jar_file_uri"]
+)
+_SPARKJOB.fields_by_name[
+    "main_jar_file_uri"
+].containing_oneof = _SPARKJOB.oneofs_by_name["driver"]
+_SPARKJOB.oneofs_by_name["driver"].fields.append(_SPARKJOB.fields_by_name["main_class"])
+_SPARKJOB.fields_by_name["main_class"].containing_oneof = _SPARKJOB.oneofs_by_name[
+    "driver"
+]
+_PYSPARKJOB_PROPERTIESENTRY.containing_type = _PYSPARKJOB
+_PYSPARKJOB.fields_by_name["properties"].message_type = _PYSPARKJOB_PROPERTIESENTRY
+_PYSPARKJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_HIVEJOB_SCRIPTVARIABLESENTRY.containing_type = _HIVEJOB
+_HIVEJOB_PROPERTIESENTRY.containing_type = _HIVEJOB
+_HIVEJOB.fields_by_name["query_list"].message_type = _QUERYLIST
+_HIVEJOB.fields_by_name["script_variables"].message_type = _HIVEJOB_SCRIPTVARIABLESENTRY
+_HIVEJOB.fields_by_name["properties"].message_type = _HIVEJOB_PROPERTIESENTRY
+_HIVEJOB.oneofs_by_name["queries"].fields.append(
+    _HIVEJOB.fields_by_name["query_file_uri"]
+)
+_HIVEJOB.fields_by_name["query_file_uri"].containing_oneof = _HIVEJOB.oneofs_by_name[
+    "queries"
+]
+_HIVEJOB.oneofs_by_name["queries"].fields.append(_HIVEJOB.fields_by_name["query_list"])
+_HIVEJOB.fields_by_name["query_list"].containing_oneof = _HIVEJOB.oneofs_by_name[
+    "queries"
+]
+_SPARKSQLJOB_SCRIPTVARIABLESENTRY.containing_type = _SPARKSQLJOB
+_SPARKSQLJOB_PROPERTIESENTRY.containing_type = _SPARKSQLJOB
+_SPARKSQLJOB.fields_by_name["query_list"].message_type = _QUERYLIST
+_SPARKSQLJOB.fields_by_name[
+    "script_variables"
+].message_type = _SPARKSQLJOB_SCRIPTVARIABLESENTRY
+_SPARKSQLJOB.fields_by_name["properties"].message_type = _SPARKSQLJOB_PROPERTIESENTRY
+_SPARKSQLJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_SPARKSQLJOB.oneofs_by_name["queries"].fields.append(
+    _SPARKSQLJOB.fields_by_name["query_file_uri"]
+)
+_SPARKSQLJOB.fields_by_name[
+    "query_file_uri"
+].containing_oneof = _SPARKSQLJOB.oneofs_by_name["queries"]
+_SPARKSQLJOB.oneofs_by_name["queries"].fields.append(
+    _SPARKSQLJOB.fields_by_name["query_list"]
+)
+_SPARKSQLJOB.fields_by_name[
+    "query_list"
+].containing_oneof = _SPARKSQLJOB.oneofs_by_name["queries"]
+_PIGJOB_SCRIPTVARIABLESENTRY.containing_type = _PIGJOB
+_PIGJOB_PROPERTIESENTRY.containing_type = _PIGJOB
+_PIGJOB.fields_by_name["query_list"].message_type = _QUERYLIST
+_PIGJOB.fields_by_name["script_variables"].message_type = _PIGJOB_SCRIPTVARIABLESENTRY
+_PIGJOB.fields_by_name["properties"].message_type = _PIGJOB_PROPERTIESENTRY
+_PIGJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_PIGJOB.oneofs_by_name["queries"].fields.append(
+    _PIGJOB.fields_by_name["query_file_uri"]
+)
+_PIGJOB.fields_by_name["query_file_uri"].containing_oneof = _PIGJOB.oneofs_by_name[
+    "queries"
+]
+_PIGJOB.oneofs_by_name["queries"].fields.append(_PIGJOB.fields_by_name["query_list"])
+_PIGJOB.fields_by_name["query_list"].containing_oneof = _PIGJOB.oneofs_by_name[
+    "queries"
+]
+_JOBSTATUS.fields_by_name["state"].enum_type = _JOBSTATUS_STATE
+_JOBSTATUS.fields_by_name[
+    "state_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOBSTATUS.fields_by_name["substate"].enum_type = _JOBSTATUS_SUBSTATE
+_JOBSTATUS_STATE.containing_type = _JOBSTATUS
+_JOBSTATUS_SUBSTATE.containing_type = _JOBSTATUS
+_YARNAPPLICATION.fields_by_name["state"].enum_type = _YARNAPPLICATION_STATE
+_YARNAPPLICATION_STATE.containing_type = _YARNAPPLICATION
+_JOB_LABELSENTRY.containing_type = _JOB
+_JOB.fields_by_name["reference"].message_type = _JOBREFERENCE
+_JOB.fields_by_name["placement"].message_type = _JOBPLACEMENT
+_JOB.fields_by_name["hadoop_job"].message_type = _HADOOPJOB
+_JOB.fields_by_name["spark_job"].message_type = _SPARKJOB
+_JOB.fields_by_name["pyspark_job"].message_type = _PYSPARKJOB
+_JOB.fields_by_name["hive_job"].message_type = _HIVEJOB
+_JOB.fields_by_name["pig_job"].message_type = _PIGJOB
+_JOB.fields_by_name["spark_sql_job"].message_type = _SPARKSQLJOB
+_JOB.fields_by_name["status"].message_type = _JOBSTATUS
+_JOB.fields_by_name["status_history"].message_type = _JOBSTATUS
+_JOB.fields_by_name["yarn_applications"].message_type = _YARNAPPLICATION
+_JOB.fields_by_name["labels"].message_type = _JOB_LABELSENTRY
+_JOB.fields_by_name["scheduling"].message_type = _JOBSCHEDULING
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["hadoop_job"])
+_JOB.fields_by_name["hadoop_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["spark_job"])
+_JOB.fields_by_name["spark_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["pyspark_job"])
+_JOB.fields_by_name["pyspark_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["hive_job"])
+_JOB.fields_by_name["hive_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["pig_job"])
+_JOB.fields_by_name["pig_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["spark_sql_job"])
+_JOB.fields_by_name["spark_sql_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_SUBMITJOBREQUEST.fields_by_name["job"].message_type = _JOB
+_LISTJOBSREQUEST.fields_by_name[
+    "job_state_matcher"
+].enum_type = _LISTJOBSREQUEST_JOBSTATEMATCHER
+_LISTJOBSREQUEST_JOBSTATEMATCHER.containing_type = _LISTJOBSREQUEST
+_UPDATEJOBREQUEST.fields_by_name["job"].message_type = _JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTJOBSRESPONSE.fields_by_name["jobs"].message_type = _JOB
+DESCRIPTOR.message_types_by_name["LoggingConfig"] = _LOGGINGCONFIG
+DESCRIPTOR.message_types_by_name["HadoopJob"] = _HADOOPJOB
+DESCRIPTOR.message_types_by_name["SparkJob"] = _SPARKJOB
+DESCRIPTOR.message_types_by_name["PySparkJob"] = _PYSPARKJOB
+DESCRIPTOR.message_types_by_name["QueryList"] = _QUERYLIST
+DESCRIPTOR.message_types_by_name["HiveJob"] = _HIVEJOB
+DESCRIPTOR.message_types_by_name["SparkSqlJob"] = _SPARKSQLJOB
+DESCRIPTOR.message_types_by_name["PigJob"] = _PIGJOB
+DESCRIPTOR.message_types_by_name["JobPlacement"] = _JOBPLACEMENT
+DESCRIPTOR.message_types_by_name["JobStatus"] = _JOBSTATUS
+DESCRIPTOR.message_types_by_name["JobReference"] = _JOBREFERENCE
+DESCRIPTOR.message_types_by_name["YarnApplication"] = _YARNAPPLICATION
+DESCRIPTOR.message_types_by_name["Job"] = _JOB
+DESCRIPTOR.message_types_by_name["JobScheduling"] = _JOBSCHEDULING
+DESCRIPTOR.message_types_by_name["SubmitJobRequest"] = _SUBMITJOBREQUEST
+DESCRIPTOR.message_types_by_name["GetJobRequest"] = _GETJOBREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsRequest"] = _LISTJOBSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateJobRequest"] = _UPDATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsResponse"] = _LISTJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["CancelJobRequest"] = _CANCELJOBREQUEST
+DESCRIPTOR.message_types_by_name["DeleteJobRequest"] = _DELETEJOBREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LoggingConfig = _reflection.GeneratedProtocolMessageType(
+    "LoggingConfig",
+    (_message.Message,),
+    dict(
+        DriverLogLevelsEntry=_reflection.GeneratedProtocolMessageType(
+            "DriverLogLevelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.LoggingConfig.DriverLogLevelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOGGINGCONFIG,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""The runtime logging config of the job.
+  
+  
+  Attributes:
+      driver_log_levels:
+          The per-package log levels for the driver. This may include
+          "root" package name to configure rootLogger. Examples:
+          'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.LoggingConfig)
+    ),
+)
+_sym_db.RegisterMessage(LoggingConfig)
+_sym_db.RegisterMessage(LoggingConfig.DriverLogLevelsEntry)
+
+HadoopJob = _reflection.GeneratedProtocolMessageType(
+    "HadoopJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HADOOPJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.HadoopJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_HADOOPJOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud 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
+  YARN <https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html>`__.
+  
+  
+  Attributes:
+      driver:
+          Required. Indicates the location of the driver's main class.
+          Specify either the jar file that contains the main class or
+          the main class name. To specify both, add the jar file to
+          ``jar_file_uris``, and then specify the main class name in
+          this property.
+      main_jar_file_uri:
+          The HCFS URI of the jar file containing the main class.
+          Examples: 'gs://foo-bucket/analytics-binaries/extract-useful-
+          metrics-mr.jar' 'hdfs:/tmp/test-samples/custom-wordcount.jar'
+          'file:///home/usr/lib/hadoop-mapreduce/hadoop-mapreduce-
+          examples.jar'
+      main_class:
+          The name of the driver's main class. The jar file containing
+          the class must be in the default CLASSPATH or specified in
+          ``jar_file_uris``.
+      args:
+          Optional. The arguments to pass to the driver. Do not 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.
+      jar_file_uris:
+          Optional. Jar file URIs to add to the CLASSPATHs of the Hadoop
+          driver and tasks.
+      file_uris:
+          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.
+      archive_uris:
+          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.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/hadoop/conf/\*-site and classes in user
+          code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.HadoopJob)
+    ),
+)
+_sym_db.RegisterMessage(HadoopJob)
+_sym_db.RegisterMessage(HadoopJob.PropertiesEntry)
+
+SparkJob = _reflection.GeneratedProtocolMessageType(
+    "SparkJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SparkJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SPARKJOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  Spark <http://spark.apache.org/>`__ applications on YARN.
+  
+  
+  Attributes:
+      driver:
+          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``.
+      main_jar_file_uri:
+          The HCFS URI of the jar file that contains the main class.
+      main_class:
+          The name of the driver's main class. The jar file that
+          contains the class must be in the default CLASSPATH or
+          specified in ``jar_file_uris``.
+      args:
+          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.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to add to the CLASSPATHs of
+          the Spark driver and tasks.
+      file_uris:
+          Optional. HCFS URIs of files to be copied to the working
+          directory of Spark drivers and distributed tasks. Useful for
+          naively parallel tasks.
+      archive_uris:
+          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.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/spark/conf/spark-defaults.conf and
+          classes in user code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SparkJob)
+    ),
+)
+_sym_db.RegisterMessage(SparkJob)
+_sym_db.RegisterMessage(SparkJob.PropertiesEntry)
+
+PySparkJob = _reflection.GeneratedProtocolMessageType(
+    "PySparkJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PYSPARKJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.PySparkJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PYSPARKJOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  PySpark <https://spark.apache.org/docs/0.9.0/python-programming-guide.html>`__
+  applications on YARN.
+  
+  
+  Attributes:
+      main_python_file_uri:
+          Required. The HCFS URI of the main Python file to use as the
+          driver. Must be a .py file.
+      args:
+          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.
+      python_file_uris:
+          Optional. HCFS file URIs of Python files to pass to the
+          PySpark framework. Supported file types: .py, .egg, and .zip.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to add to the CLASSPATHs of
+          the Python driver and tasks.
+      file_uris:
+          Optional. HCFS URIs of files to be copied to the working
+          directory of Python drivers and distributed tasks. Useful for
+          naively parallel tasks.
+      archive_uris:
+          Optional. HCFS URIs of archives to be extracted in the working
+          directory of .jar, .tar, .tar.gz, .tgz, and .zip.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/spark/conf/spark-defaults.conf and
+          classes in user code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.PySparkJob)
+    ),
+)
+_sym_db.RegisterMessage(PySparkJob)
+_sym_db.RegisterMessage(PySparkJob.PropertiesEntry)
+
+QueryList = _reflection.GeneratedProtocolMessageType(
+    "QueryList",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYLIST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A list of queries to run on a cluster.
+  
+  
+  Attributes:
+      queries:
+          Required. The queries to execute. You do not need to terminate
+          a query with a semicolon. Multiple queries can be specified in
+          one string by separating each with a semicolon. Here is an
+          example of an Cloud Dataproc API snippet that uses a QueryList
+          to specify a HiveJob:  ::      "hiveJob": {       "queryList":
+          {         "queries": [           "query1",           "query2",
+          "query3;query4",         ]       }     }
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.QueryList)
+    ),
+)
+_sym_db.RegisterMessage(QueryList)
+
+HiveJob = _reflection.GeneratedProtocolMessageType(
+    "HiveJob",
+    (_message.Message,),
+    dict(
+        ScriptVariablesEntry=_reflection.GeneratedProtocolMessageType(
+            "ScriptVariablesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HIVEJOB_SCRIPTVARIABLESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.HiveJob.ScriptVariablesEntry)
+            ),
+        ),
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HIVEJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.HiveJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_HIVEJOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  Hive <https://hive.apache.org/>`__ queries on YARN.
+  
+  
+  Attributes:
+      queries:
+          Required. The sequence of Hive queries to execute, specified
+          as either an HCFS file URI or a list of queries.
+      query_file_uri:
+          The HCFS URI of the script that contains Hive queries.
+      query_list:
+          A list of queries.
+      continue_on_failure:
+          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.
+      script_variables:
+          Optional. Mapping of query variable names to values
+          (equivalent to the Hive command: ``SET name="value";``).
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/hadoop/conf/\*-site.xml,
+          /etc/hive/conf/hive-site.xml, and classes in user code.
+      jar_file_uris:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.HiveJob)
+    ),
+)
+_sym_db.RegisterMessage(HiveJob)
+_sym_db.RegisterMessage(HiveJob.ScriptVariablesEntry)
+_sym_db.RegisterMessage(HiveJob.PropertiesEntry)
+
+SparkSqlJob = _reflection.GeneratedProtocolMessageType(
+    "SparkSqlJob",
+    (_message.Message,),
+    dict(
+        ScriptVariablesEntry=_reflection.GeneratedProtocolMessageType(
+            "ScriptVariablesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKSQLJOB_SCRIPTVARIABLESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SparkSqlJob.ScriptVariablesEntry)
+            ),
+        ),
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKSQLJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SparkSqlJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SPARKSQLJOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache Spark
+  SQL <http://spark.apache.org/sql/>`__ queries.
+  
+  
+  Attributes:
+      queries:
+          Required. The sequence of Spark SQL queries to execute,
+          specified as either an HCFS file URI or as a list of queries.
+      query_file_uri:
+          The HCFS URI of the script that contains SQL queries.
+      query_list:
+          A list of queries.
+      script_variables:
+          Optional. Mapping of query variable names to values
+          (equivalent to the Spark SQL command: SET ``name="value";``).
+      properties:
+          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.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to be added to the Spark
+          CLASSPATH.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SparkSqlJob)
+    ),
+)
+_sym_db.RegisterMessage(SparkSqlJob)
+_sym_db.RegisterMessage(SparkSqlJob.ScriptVariablesEntry)
+_sym_db.RegisterMessage(SparkSqlJob.PropertiesEntry)
+
+PigJob = _reflection.GeneratedProtocolMessageType(
+    "PigJob",
+    (_message.Message,),
+    dict(
+        ScriptVariablesEntry=_reflection.GeneratedProtocolMessageType(
+            "ScriptVariablesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PIGJOB_SCRIPTVARIABLESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.PigJob.ScriptVariablesEntry)
+            ),
+        ),
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PIGJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.PigJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PIGJOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  Pig <https://pig.apache.org/>`__ queries on YARN.
+  
+  
+  Attributes:
+      queries:
+          Required. The sequence of Pig queries to execute, specified as
+          an HCFS file URI or a list of queries.
+      query_file_uri:
+          The HCFS URI of the script that contains the Pig queries.
+      query_list:
+          A list of queries.
+      continue_on_failure:
+          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.
+      script_variables:
+          Optional. Mapping of query variable names to values
+          (equivalent to the Pig command: ``name=[value]``).
+      properties:
+          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 overwritten. Can include properties
+          set in /etc/hadoop/conf/\*-site.xml,
+          /etc/pig/conf/pig.properties, and classes in user code.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to add to the CLASSPATH of
+          the Pig Client and Hadoop MapReduce (MR) tasks. Can contain
+          Pig UDFs.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.PigJob)
+    ),
+)
+_sym_db.RegisterMessage(PigJob)
+_sym_db.RegisterMessage(PigJob.ScriptVariablesEntry)
+_sym_db.RegisterMessage(PigJob.PropertiesEntry)
+
+JobPlacement = _reflection.GeneratedProtocolMessageType(
+    "JobPlacement",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBPLACEMENT,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""Cloud Dataproc job config.
+  
+  
+  Attributes:
+      cluster_name:
+          Required. The name of the cluster where the job will be
+          submitted.
+      cluster_uuid:
+          Output only. A cluster UUID generated by the Cloud Dataproc
+          service when the job is submitted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.JobPlacement)
+    ),
+)
+_sym_db.RegisterMessage(JobPlacement)
+
+JobStatus = _reflection.GeneratedProtocolMessageType(
+    "JobStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBSTATUS,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""Cloud Dataproc job status.
+  
+  
+  Attributes:
+      state:
+          Output only. A state message specifying the overall job state.
+      details:
+          Output only. Optional job state details, such as an error
+          description if the state is ERROR.
+      state_start_time:
+          Output only. The time when this state was entered.
+      substate:
+          Output only. Additional state information, which includes
+          status reported by the agent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.JobStatus)
+    ),
+)
+_sym_db.RegisterMessage(JobStatus)
+
+JobReference = _reflection.GeneratedProtocolMessageType(
+    "JobReference",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBREFERENCE,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""Encapsulates the full scoping used to reference a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      job_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.JobReference)
+    ),
+)
+_sym_db.RegisterMessage(JobReference)
+
+YarnApplication = _reflection.GeneratedProtocolMessageType(
+    "YarnApplication",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_YARNAPPLICATION,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A YARN application created by a job. Application information is a subset
+  of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto.
+  
+  **Beta Feature**: This report is available for testing purposes only. It
+  may be changed before final release.
+  
+  
+  Attributes:
+      name:
+          Required. The application name.
+      state:
+          Required. The application state.
+      progress:
+          Required. The numerical progress of the application, from 1 to
+          100.
+      tracking_url:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.YarnApplication)
+    ),
+)
+_sym_db.RegisterMessage(YarnApplication)
+
+Job = _reflection.GeneratedProtocolMessageType(
+    "Job",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOB_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.Job.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_JOB,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job resource.
+  
+  
+  Attributes:
+      reference:
+          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.
+      placement:
+          Required. Job information, including how, when, and where to
+          run the job.
+      type_job:
+          Required. The application/framework-specific portion of the
+          job.
+      hadoop_job:
+          Job is a Hadoop job.
+      spark_job:
+          Job is a Spark job.
+      pyspark_job:
+          Job is a Pyspark job.
+      hive_job:
+          Job is a Hive job.
+      pig_job:
+          Job is a Pig job.
+      spark_sql_job:
+          Job is a SparkSql job.
+      status:
+          Output only. The job status. Additional application-specific
+          status information may be contained in the type\_job and
+          yarn\_applications fields.
+      status_history:
+          Output only. The previous job status.
+      yarn_applications:
+          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.
+      driver_output_resource_uri:
+          Output only. A URI pointing to the location of the stdout of
+          the job's driver program.
+      driver_control_files_uri:
+          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``.
+      labels:
+          Optional. The labels to associate with this job. Label
+          **keys** must contain 1 to 63 characters, and must conform to
+          `RFC 1035 <https://www.ietf.org/rfc/rfc1035.txt>`__. Label
+          **values** may be empty, but, if present, must contain 1 to 63
+          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.
+      scheduling:
+          Optional. Job scheduling configuration.
+      job_uuid:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.Job)
+    ),
+)
+_sym_db.RegisterMessage(Job)
+_sym_db.RegisterMessage(Job.LabelsEntry)
+
+JobScheduling = _reflection.GeneratedProtocolMessageType(
+    "JobScheduling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBSCHEDULING,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""Job scheduling options.
+  
+  
+  Attributes:
+      max_failures_per_hour:
+          Optional. Maximum number of times per hour a driver may be
+          restarted as a result of driver terminating with non-zero code
+          before job is reported failed.  A job may be reported as
+          thrashing if driver exits with non-zero code 4 times within 10
+          minute window.  Maximum value is 10.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.JobScheduling)
+    ),
+)
+_sym_db.RegisterMessage(JobScheduling)
+
+SubmitJobRequest = _reflection.GeneratedProtocolMessageType(
+    "SubmitJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SUBMITJOBREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A request to submit a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job:
+          Required. The job resource.
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two
+          [SubmitJobRequest][google.cloud.dataproc.v1.SubmitJobRequest]
+          requests with the same id, then the second request will be
+          ignored and the first [Job][google.cloud.dataproc.v1.Job]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.SubmitJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(SubmitJobRequest)
+
+GetJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETJOBREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A request to get the resource representation for a job in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.GetJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetJobRequest)
+
+ListJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A request to list jobs in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      page_size:
+          Optional. The number of results to return in each response.
+      page_token:
+          Optional. The page token, returned by a previous call, to
+          request the next page of results.
+      cluster_name:
+          Optional. If set, the returned jobs list includes only jobs
+          that were submitted to the named cluster.
+      job_state_matcher:
+          Optional. Specifies enumerated categories of jobs to list.
+          (default = match ALL jobs).  If ``filter`` is provided,
+          ``jobStateMatcher`` will be ignored.
+      filter:
+          Optional. A filter constraining the jobs to list. Filters are
+          case-sensitive and have the following syntax:  [field = value]
+          AND [field [= value]] ...  where **field** is ``status.state``
+          or ``labels.[KEY]``, and ``[KEY]`` is a label key. **value**
+          can be ``*`` to match all values. ``status.state`` can be
+          either ``ACTIVE`` or ``NON_ACTIVE``. Only the logical ``AND``
+          operator is supported; space-separated items are treated as
+          having an implicit ``AND`` operator.  Example filter:
+          status.state = ACTIVE AND labels.env = staging AND
+          labels.starred = \*
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ListJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsRequest)
+
+UpdateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEJOBREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A request to update a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+      job:
+          Required. The changes to the job.
+      update_mask:
+          Required. Specifies the path, relative to Job, of the field to
+          update. For example, to update the labels of a Job the
+          update\_mask parameter would be specified as labels, and the
+          ``PATCH`` request body would specify the new value. Note:
+          Currently, labels is the only field that can be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.UpdateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateJobRequest)
+
+ListJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSRESPONSE,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A list of jobs in a project.
+  
+  
+  Attributes:
+      jobs:
+          Output only. Jobs list.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ListJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsResponse)
+
+CancelJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELJOBREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A request to cancel a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.CancelJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelJobRequest)
+
+DeleteJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEJOBREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.jobs_pb2",
+        __doc__="""A request to delete a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.DeleteJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteJobRequest)
+
+
+DESCRIPTOR._options = None
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY._options = None
+_HADOOPJOB_PROPERTIESENTRY._options = None
+_SPARKJOB_PROPERTIESENTRY._options = None
+_PYSPARKJOB_PROPERTIESENTRY._options = None
+_HIVEJOB_SCRIPTVARIABLESENTRY._options = None
+_HIVEJOB_PROPERTIESENTRY._options = None
+_SPARKSQLJOB_SCRIPTVARIABLESENTRY._options = None
+_SPARKSQLJOB_PROPERTIESENTRY._options = None
+_PIGJOB_SCRIPTVARIABLESENTRY._options = None
+_PIGJOB_PROPERTIESENTRY._options = None
+_JOB_LABELSENTRY._options = None
+
+_JOBCONTROLLER = _descriptor.ServiceDescriptor(
+    name="JobController",
+    full_name="google.cloud.dataproc.v1.JobController",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=5622,
+    serialized_end=6572,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="SubmitJob",
+            full_name="google.cloud.dataproc.v1.JobController.SubmitJob",
+            index=0,
+            containing_service=None,
+            input_type=_SUBMITJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1/projects/{project_id}/regions/{region}/jobs:submit:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetJob",
+            full_name="google.cloud.dataproc.v1.JobController.GetJob",
+            index=1,
+            containing_service=None,
+            input_type=_GETJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002:\0228/v1/projects/{project_id}/regions/{region}/jobs/{job_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListJobs",
+            full_name="google.cloud.dataproc.v1.JobController.ListJobs",
+            index=2,
+            containing_service=None,
+            input_type=_LISTJOBSREQUEST,
+            output_type=_LISTJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1/projects/{project_id}/regions/{region}/jobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateJob",
+            full_name="google.cloud.dataproc.v1.JobController.UpdateJob",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002?28/v1/projects/{project_id}/regions/{region}/jobs/{job_id}:\003job"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelJob",
+            full_name="google.cloud.dataproc.v1.JobController.CancelJob",
+            index=4,
+            containing_service=None,
+            input_type=_CANCELJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                '\202\323\344\223\002D"?/v1/projects/{project_id}/regions/{region}/jobs/{job_id}:cancel:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteJob",
+            full_name="google.cloud.dataproc.v1.JobController.DeleteJob",
+            index=5,
+            containing_service=None,
+            input_type=_DELETEJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002:*8/v1/projects/{project_id}/regions/{region}/jobs/{job_id}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_JOBCONTROLLER)
+
+DESCRIPTOR.services_by_name["JobController"] = _JOBCONTROLLER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1/proto/jobs_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1/proto/jobs_pb2_grpc.py
new file mode 100644
index 000000000000..d2706382307b
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/jobs_pb2_grpc.py
@@ -0,0 +1,140 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1.proto import (
+    jobs_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class JobControllerStub(object):
+    """The JobController provides methods to manage jobs.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.SubmitJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1.JobController/SubmitJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.SubmitJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.GetJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1.JobController/GetJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.GetJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.ListJobs = channel.unary_unary(
+            "/google.cloud.dataproc.v1.JobController/ListJobs",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.ListJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.ListJobsResponse.FromString,
+        )
+        self.UpdateJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1.JobController/UpdateJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.UpdateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.CancelJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1.JobController/CancelJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.CancelJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.DeleteJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1.JobController/DeleteJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.DeleteJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class JobControllerServicer(object):
+    """The JobController provides methods to manage jobs.
+  """
+
+    def SubmitJob(self, request, context):
+        """Submits a job to a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetJob(self, request, context):
+        """Gets the resource representation for a job in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListJobs(self, request, context):
+        """Lists regions/{region}/jobs in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateJob(self, request, context):
+        """Updates a job in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelJob(self, request, context):
+        """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)
+    or
+    [regions/{region}/jobs.get](/dataproc/docs/reference/rest/v1/projects.regions.jobs/get).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteJob(self, request, context):
+        """Deletes the job from the project. If the job is active, the delete fails,
+    and the response returns `FAILED_PRECONDITION`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_JobControllerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "SubmitJob": grpc.unary_unary_rpc_method_handler(
+            servicer.SubmitJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.SubmitJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "GetJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.GetJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "ListJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListJobs,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.ListJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.ListJobsResponse.SerializeToString,
+        ),
+        "UpdateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.UpdateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "CancelJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.CancelJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "DeleteJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.DeleteJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1.JobController", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1/proto/operations.proto b/dataproc/google/cloud/dataproc_v1/proto/operations.proto
new file mode 100644
index 000000000000..c820cd8e65dc
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/operations.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.dataproc.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc";
+option java_multiple_files = true;
+option java_outer_classname = "OperationsProto";
+option java_package = "com.google.cloud.dataproc.v1";
+
+// The status of the operation.
+message ClusterOperationStatus {
+  // The operation state.
+  enum State {
+    // Unused.
+    UNKNOWN = 0;
+
+    // The operation has been created.
+    PENDING = 1;
+
+    // The operation is running.
+    RUNNING = 2;
+
+    // The operation is done; either cancelled or completed.
+    DONE = 3;
+  }
+
+  // Output only. A message containing the operation state.
+  State state = 1;
+
+  // Output only. A message containing the detailed operation state.
+  string inner_state = 2;
+
+  // Output only. A message containing any operation metadata details.
+  string details = 3;
+
+  // Output only. The time this state was entered.
+  google.protobuf.Timestamp state_start_time = 4;
+}
+
+// Metadata describing the operation.
+message ClusterOperationMetadata {
+  // Output only. Name of the cluster for the operation.
+  string cluster_name = 7;
+
+  // Output only. Cluster UUID for the operation.
+  string cluster_uuid = 8;
+
+  // Output only. Current operation status.
+  ClusterOperationStatus status = 9;
+
+  // Output only. The previous operation status.
+  repeated ClusterOperationStatus status_history = 10;
+
+  // Output only. The operation type.
+  string operation_type = 11;
+
+  // Output only. Short description of operation.
+  string description = 12;
+
+  // Output only. Labels associated with the operation
+  map<string, string> labels = 13;
+
+  // Output only. Errors encountered during operation execution.
+  repeated string warnings = 14;
+}
diff --git a/dataproc/google/cloud/dataproc_v1/proto/operations_pb2.py b/dataproc/google/cloud/dataproc_v1/proto/operations_pb2.py
new file mode 100644
index 000000000000..0f09da0c701d
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/operations_pb2.py
@@ -0,0 +1,471 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1/proto/operations.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1/proto/operations.proto",
+    package="google.cloud.dataproc.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.dataproc.v1B\017OperationsProtoP\001Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/dataproc_v1/proto/operations.proto\x12\x18google.cloud.dataproc.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xf5\x01\n\x16\x43lusterOperationStatus\x12\x45\n\x05state\x18\x01 \x01(\x0e\x32\x36.google.cloud.dataproc.v1.ClusterOperationStatus.State\x12\x13\n\x0binner_state\x18\x02 \x01(\t\x12\x0f\n\x07\x64\x65tails\x18\x03 \x01(\t\x12\x34\n\x10state_start_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"8\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03"\x90\x03\n\x18\x43lusterOperationMetadata\x12\x14\n\x0c\x63luster_name\x18\x07 \x01(\t\x12\x14\n\x0c\x63luster_uuid\x18\x08 \x01(\t\x12@\n\x06status\x18\t \x01(\x0b\x32\x30.google.cloud.dataproc.v1.ClusterOperationStatus\x12H\n\x0estatus_history\x18\n \x03(\x0b\x32\x30.google.cloud.dataproc.v1.ClusterOperationStatus\x12\x16\n\x0eoperation_type\x18\x0b \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x0c \x01(\t\x12N\n\x06labels\x18\r \x03(\x0b\x32>.google.cloud.dataproc.v1.ClusterOperationMetadata.LabelsEntry\x12\x10\n\x08warnings\x18\x0e \x03(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42s\n\x1c\x63om.google.cloud.dataproc.v1B\x0fOperationsProtoP\x01Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CLUSTEROPERATIONSTATUS_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1.ClusterOperationStatus.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=330,
+    serialized_end=386,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTEROPERATIONSTATUS_STATE)
+
+
+_CLUSTEROPERATIONSTATUS = _descriptor.Descriptor(
+    name="ClusterOperationStatus",
+    full_name="google.cloud.dataproc.v1.ClusterOperationStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1.ClusterOperationStatus.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inner_state",
+            full_name="google.cloud.dataproc.v1.ClusterOperationStatus.inner_state",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="google.cloud.dataproc.v1.ClusterOperationStatus.details",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_start_time",
+            full_name="google.cloud.dataproc.v1.ClusterOperationStatus.state_start_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CLUSTEROPERATIONSTATUS_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=141,
+    serialized_end=386,
+)
+
+
+_CLUSTEROPERATIONMETADATA_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=744,
+    serialized_end=789,
+)
+
+_CLUSTEROPERATIONMETADATA = _descriptor.Descriptor(
+    name="ClusterOperationMetadata",
+    full_name="google.cloud.dataproc.v1.ClusterOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.cluster_name",
+            index=0,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.cluster_uuid",
+            index=1,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.status",
+            index=2,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_history",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.status_history",
+            index=3,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_type",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.operation_type",
+            index=4,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.description",
+            index=5,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.labels",
+            index=6,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="warnings",
+            full_name="google.cloud.dataproc.v1.ClusterOperationMetadata.warnings",
+            index=7,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTEROPERATIONMETADATA_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=389,
+    serialized_end=789,
+)
+
+_CLUSTEROPERATIONSTATUS.fields_by_name[
+    "state"
+].enum_type = _CLUSTEROPERATIONSTATUS_STATE
+_CLUSTEROPERATIONSTATUS.fields_by_name[
+    "state_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CLUSTEROPERATIONSTATUS_STATE.containing_type = _CLUSTEROPERATIONSTATUS
+_CLUSTEROPERATIONMETADATA_LABELSENTRY.containing_type = _CLUSTEROPERATIONMETADATA
+_CLUSTEROPERATIONMETADATA.fields_by_name[
+    "status"
+].message_type = _CLUSTEROPERATIONSTATUS
+_CLUSTEROPERATIONMETADATA.fields_by_name[
+    "status_history"
+].message_type = _CLUSTEROPERATIONSTATUS
+_CLUSTEROPERATIONMETADATA.fields_by_name[
+    "labels"
+].message_type = _CLUSTEROPERATIONMETADATA_LABELSENTRY
+DESCRIPTOR.message_types_by_name["ClusterOperationStatus"] = _CLUSTEROPERATIONSTATUS
+DESCRIPTOR.message_types_by_name["ClusterOperationMetadata"] = _CLUSTEROPERATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ClusterOperationStatus = _reflection.GeneratedProtocolMessageType(
+    "ClusterOperationStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTEROPERATIONSTATUS,
+        __module__="google.cloud.dataproc_v1.proto.operations_pb2",
+        __doc__="""The status of the operation.
+  
+  
+  Attributes:
+      state:
+          Output only. A message containing the operation state.
+      inner_state:
+          Output only. A message containing the detailed operation
+          state.
+      details:
+          Output only. A message containing any operation metadata
+          details.
+      state_start_time:
+          Output only. The time this state was entered.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterOperationStatus)
+    ),
+)
+_sym_db.RegisterMessage(ClusterOperationStatus)
+
+ClusterOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ClusterOperationMetadata",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTEROPERATIONMETADATA_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.operations_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterOperationMetadata.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTEROPERATIONMETADATA,
+        __module__="google.cloud.dataproc_v1.proto.operations_pb2",
+        __doc__="""Metadata describing the operation.
+  
+  
+  Attributes:
+      cluster_name:
+          Output only. Name of the cluster for the operation.
+      cluster_uuid:
+          Output only. Cluster UUID for the operation.
+      status:
+          Output only. Current operation status.
+      status_history:
+          Output only. The previous operation status.
+      operation_type:
+          Output only. The operation type.
+      description:
+          Output only. Short description of operation.
+      labels:
+          Output only. Labels associated with the operation
+      warnings:
+          Output only. Errors encountered during operation execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ClusterOperationMetadata)
+_sym_db.RegisterMessage(ClusterOperationMetadata.LabelsEntry)
+
+
+DESCRIPTOR._options = None
+_CLUSTEROPERATIONMETADATA_LABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1/proto/operations_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1/proto/operations_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/operations_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/dataproc/google/cloud/dataproc_v1/proto/shared.proto b/dataproc/google/cloud/dataproc_v1/proto/shared.proto
new file mode 100644
index 000000000000..74bd56a80875
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/shared.proto
@@ -0,0 +1,43 @@
+// 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.dataproc.v1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc";
+option java_multiple_files = true;
+option java_outer_classname = "SharedProto";
+option java_package = "com.google.cloud.dataproc.v1";
+
+// Cluster components that can be activated.
+enum Component {
+  // Unspecified component.
+  COMPONENT_UNSPECIFIED = 0;
+
+  // The Anaconda python distribution.
+  ANACONDA = 5;
+
+  // The Hive Web HCatalog (the REST service for accessing HCatalog).
+  HIVE_WEBHCAT = 3;
+
+  // The Jupyter Notebook.
+  JUPYTER = 1;
+
+  // The Zeppelin notebook.
+  ZEPPELIN = 4;
+}
diff --git a/dataproc/google/cloud/dataproc_v1/proto/shared_pb2.py b/dataproc/google/cloud/dataproc_v1/proto/shared_pb2.py
new file mode 100644
index 000000000000..748c8e01d2e9
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/shared_pb2.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1/proto/shared.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1/proto/shared.proto",
+    package="google.cloud.dataproc.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.dataproc.v1B\013SharedProtoP\001Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"
+    ),
+    serialized_pb=_b(
+        "\n+google/cloud/dataproc_v1/proto/shared.proto\x12\x18google.cloud.dataproc.v1\x1a\x1cgoogle/api/annotations.proto*a\n\tComponent\x12\x19\n\x15\x43OMPONENT_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x41NACONDA\x10\x05\x12\x10\n\x0cHIVE_WEBHCAT\x10\x03\x12\x0b\n\x07JUPYTER\x10\x01\x12\x0c\n\x08ZEPPELIN\x10\x04\x42o\n\x1c\x63om.google.cloud.dataproc.v1B\x0bSharedProtoP\x01Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataprocb\x06proto3"
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_COMPONENT = _descriptor.EnumDescriptor(
+    name="Component",
+    full_name="google.cloud.dataproc.v1.Component",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPONENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANACONDA", index=1, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HIVE_WEBHCAT", index=2, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JUPYTER", index=3, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ZEPPELIN", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=103,
+    serialized_end=200,
+)
+_sym_db.RegisterEnumDescriptor(_COMPONENT)
+
+Component = enum_type_wrapper.EnumTypeWrapper(_COMPONENT)
+COMPONENT_UNSPECIFIED = 0
+ANACONDA = 5
+HIVE_WEBHCAT = 3
+JUPYTER = 1
+ZEPPELIN = 4
+
+
+DESCRIPTOR.enum_types_by_name["Component"] = _COMPONENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1/proto/shared_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1/proto/shared_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/shared_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/dataproc/google/cloud/dataproc_v1/proto/workflow_templates.proto b/dataproc/google/cloud/dataproc_v1/proto/workflow_templates.proto
new file mode 100644
index 000000000000..61295a5500dc
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/workflow_templates.proto
@@ -0,0 +1,661 @@
+// 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.dataproc.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/dataproc/v1/clusters.proto";
+import "google/cloud/dataproc/v1/jobs.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc";
+option java_multiple_files = true;
+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.
+service WorkflowTemplateService {
+  // Creates new workflow template.
+  rpc CreateWorkflowTemplate(CreateWorkflowTemplateRequest) returns (WorkflowTemplate) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/workflowTemplates"
+      body: "template"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/regions/*}/workflowTemplates"
+        body: "template"
+      }
+    };
+  }
+
+  // Retrieves the latest workflow template.
+  //
+  // Can retrieve previously instantiated template by specifying optional
+  // version parameter.
+  rpc GetWorkflowTemplate(GetWorkflowTemplateRequest) returns (WorkflowTemplate) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/workflowTemplates/*}"
+      additional_bindings {
+        get: "/v1/{name=projects/*/regions/*/workflowTemplates/*}"
+      }
+    };
+  }
+
+  // Instantiates a template and begins execution.
+  //
+  // The returned Operation can be used to track execution of
+  // workflow by polling
+  // [operations.get][google.longrunning.Operations.GetOperation].
+  // The Operation will complete when entire workflow is finished.
+  //
+  // The running workflow can be aborted via
+  // [operations.cancel][google.longrunning.Operations.CancelOperation].
+  // This will cause any inflight jobs to be cancelled and workflow-owned
+  // clusters to be deleted.
+  //
+  // The [Operation.metadata][google.longrunning.Operation.metadata] will be
+  // [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata].
+  //
+  // On successful completion,
+  // [Operation.response][google.longrunning.Operation.response] will be
+  // [Empty][google.protobuf.Empty].
+  rpc InstantiateWorkflowTemplate(InstantiateWorkflowTemplateRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/workflowTemplates/*}:instantiate"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{name=projects/*/regions/*/workflowTemplates/*}:instantiate"
+        body: "*"
+      }
+    };
+  }
+
+  // Instantiates a template and begins execution.
+  //
+  // This method is equivalent to executing the sequence
+  // [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate],
+  // [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate].
+  //
+  // The returned Operation can be used to track execution of
+  // workflow by polling
+  // [operations.get][google.longrunning.Operations.GetOperation].
+  // The Operation will complete when entire workflow is finished.
+  //
+  // The running workflow can be aborted via
+  // [operations.cancel][google.longrunning.Operations.CancelOperation].
+  // This will cause any inflight jobs to be cancelled and workflow-owned
+  // clusters to be deleted.
+  //
+  // The [Operation.metadata][google.longrunning.Operation.metadata] will be
+  // [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata].
+  //
+  // On successful completion,
+  // [Operation.response][google.longrunning.Operation.response] will be
+  // [Empty][google.protobuf.Empty].
+  rpc InstantiateInlineWorkflowTemplate(InstantiateInlineWorkflowTemplateRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/workflowTemplates:instantiateInline"
+      body: "template"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/regions/*}/workflowTemplates:instantiateInline"
+        body: "template"
+      }
+    };
+  }
+
+  // Updates (replaces) workflow template. The updated template
+  // must contain version that matches the current server version.
+  rpc UpdateWorkflowTemplate(UpdateWorkflowTemplateRequest) returns (WorkflowTemplate) {
+    option (google.api.http) = {
+      put: "/v1/{template.name=projects/*/locations/*/workflowTemplates/*}"
+      body: "template"
+      additional_bindings {
+        put: "/v1/{template.name=projects/*/regions/*/workflowTemplates/*}"
+        body: "template"
+      }
+    };
+  }
+
+  // Lists workflows that match the specified filter in the request.
+  rpc ListWorkflowTemplates(ListWorkflowTemplatesRequest) returns (ListWorkflowTemplatesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/workflowTemplates"
+      additional_bindings {
+        get: "/v1/{parent=projects/*/regions/*}/workflowTemplates"
+      }
+    };
+  }
+
+  // Deletes a workflow template. It does not cancel in-progress workflows.
+  rpc DeleteWorkflowTemplate(DeleteWorkflowTemplateRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/workflowTemplates/*}"
+      additional_bindings {
+        delete: "/v1/{name=projects/*/regions/*/workflowTemplates/*}"
+      }
+    };
+  }
+}
+
+// A Cloud 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;
+
+  // 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;
+
+  // Optional. Used to perform a consistent read-modify-write.
+  //
+  // This field should be left blank for a `CreateWorkflowTemplate` request. It
+  // is required for an `UpdateWorkflowTemplate` request, and must match the
+  // current server version. A typical update template flow would fetch the
+  // current template with a `GetWorkflowTemplate` request, which will return
+  // 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;
+
+  // Output only. The time template was created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. The time template was last updated.
+  google.protobuf.Timestamp update_time = 5;
+
+  // Optional. The labels to associate with this template. These labels
+  // will be propagated to all jobs and clusters created by the workflow
+  // instance.
+  //
+  // Label **keys** must contain 1 to 63 characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  //
+  // Label **values** may be empty, but, if present, must contain 1 to 63
+  // characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  //
+  // No more than 32 labels can be associated with a template.
+  map<string, string> labels = 6;
+
+  // Required. WorkflowTemplate scheduling information.
+  WorkflowTemplatePlacement placement = 7;
+
+  // Required. The Directed Acyclic Graph of Jobs to submit.
+  repeated OrderedJob jobs = 8;
+
+  // 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;
+}
+
+// Specifies workflow execution target.
+//
+// Either `managed_cluster` or `cluster_selector` is required.
+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.
+    ManagedCluster managed_cluster = 1;
+
+    // Optional. A selector that chooses target cluster for jobs based
+    // on metadata.
+    //
+    // The selector is evaluated at the time each job is submitted.
+    ClusterSelector cluster_selector = 2;
+  }
+}
+
+// Cluster that is managed by the workflow.
+message ManagedCluster {
+  // Required. The cluster name prefix. A unique cluster name will be formed by
+  // appending a random suffix.
+  //
+  // 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;
+
+  // Required. The cluster configuration.
+  ClusterConfig config = 3;
+
+  // Optional. The labels to associate with this cluster.
+  //
+  // Label keys must be between 1 and 63 characters long, 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 1 and 63 characters long, and must conform to
+  // 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<string, string> labels = 4;
+}
+
+// A selector that chooses target cluster for jobs based on metadata.
+message ClusterSelector {
+  // Optional. The zone where workflow process executes. This parameter does not
+  // affect the selection of the cluster.
+  //
+  // If unspecified, the zone of the first cluster matching the selector
+  // is used.
+  string zone = 1;
+
+  // Required. The cluster labels. Cluster must have all labels
+  // to match.
+  map<string, string> cluster_labels = 2;
+}
+
+// A job executed by the workflow.
+message OrderedJob {
+  // Required. The step id. The id must be unique among all jobs
+  // within the template.
+  //
+  // The step id is used as prefix for job id, as job
+  // `goog-dataproc-workflow-step-id` label, and in
+  // [prerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids] field from other
+  // steps.
+  //
+  // 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;
+
+  // 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.
+    SparkSqlJob spark_sql_job = 7;
+  }
+
+  // Optional. The labels to associate with this job.
+  //
+  // Label keys must be between 1 and 63 characters long, and must conform to
+  // the following regular expression:
+  // [\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}
+  //
+  // Label values must be between 1 and 63 characters long, and must conform to
+  // 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<string, string> labels = 8;
+
+  // Optional. Job scheduling configuration.
+  JobScheduling scheduling = 9;
+
+  // 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;
+}
+
+// A configurable parameter that replaces one or more fields in the template.
+// Parameterizable fields:
+// - Labels
+// - File uris
+// - Job properties
+// - Job arguments
+// - Script variables
+// - Main class (in HadoopJob and SparkJob)
+// - Zone (in ClusterSelector)
+message TemplateParameter {
+  // 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;
+
+  // Required. Paths to all fields that the parameter replaces.
+  // A field is allowed to appear in at most one parameter's list of field
+  // paths.
+  //
+  // A field path is similar in syntax to a [google.protobuf.FieldMask][google.protobuf.FieldMask].
+  // For example, a field path that references the zone field of a workflow
+  // template's cluster selector would be specified as
+  // `placement.clusterSelector.zone`.
+  //
+  // Also, field paths can reference fields using the following syntax:
+  //
+  // * Values in maps can be referenced by key:
+  //     * labels['key']
+  //     * placement.clusterSelector.clusterLabels['key']
+  //     * placement.managedCluster.labels['key']
+  //     * placement.clusterSelector.clusterLabels['key']
+  //     * jobs['step-id'].labels['key']
+  //
+  // * Jobs in the jobs list can be referenced by step-id:
+  //     * jobs['step-id'].hadoopJob.mainJarFileUri
+  //     * jobs['step-id'].hiveJob.queryFileUri
+  //     * jobs['step-id'].pySparkJob.mainPythonFileUri
+  //     * jobs['step-id'].hadoopJob.jarFileUris[0]
+  //     * jobs['step-id'].hadoopJob.archiveUris[0]
+  //     * jobs['step-id'].hadoopJob.fileUris[0]
+  //     * jobs['step-id'].pySparkJob.pythonFileUris[0]
+  //
+  // * Items in repeated fields can be referenced by a zero-based index:
+  //     * jobs['step-id'].sparkJob.args[0]
+  //
+  // * Other examples:
+  //     * jobs['step-id'].hadoopJob.properties['key']
+  //     * jobs['step-id'].hadoopJob.args[0]
+  //     * jobs['step-id'].hiveJob.scriptVariables['key']
+  //     * jobs['step-id'].hadoopJob.mainJarFileUri
+  //     * placement.clusterSelector.zone
+  //
+  // It may not be possible to parameterize maps and repeated fields in their
+  // entirety since only individual map values and individual items in repeated
+  // fields can be referenced. For example, the following field paths are
+  // invalid:
+  //
+  // - placement.clusterSelector.clusterLabels
+  // - jobs['step-id'].sparkJob.args
+  repeated string fields = 2;
+
+  // Optional. Brief description of the parameter.
+  // Must not exceed 1024 characters.
+  string description = 3;
+
+  // Optional. Validation rules to be applied to this parameter's value.
+  ParameterValidation validation = 4;
+}
+
+// Configuration for parameter validation.
+message ParameterValidation {
+  // Required. The type of validation to be performed.
+  oneof validation_type {
+    // Validation based on regular expressions.
+    RegexValidation regex = 1;
+
+    // Validation based on a list of allowed values.
+    ValueValidation values = 2;
+  }
+}
+
+// Validation based on regular expressions.
+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;
+}
+
+// Validation based on a list of allowed values.
+message ValueValidation {
+  // Required. List of allowed values for the parameter.
+  repeated string values = 1;
+}
+
+// A Cloud Dataproc workflow template resource.
+message WorkflowMetadata {
+  // The operation state.
+  enum State {
+    // Unused.
+    UNKNOWN = 0;
+
+    // The operation has been created.
+    PENDING = 1;
+
+    // The operation is running.
+    RUNNING = 2;
+
+    // The operation is done; either cancelled or completed.
+    DONE = 3;
+  }
+
+  // Output only. The "resource name" of the template.
+  string template = 1;
+
+  // Output only. The version of template at the time of
+  // workflow instantiation.
+  int32 version = 2;
+
+  // Output only. The create cluster operation metadata.
+  ClusterOperation create_cluster = 3;
+
+  // Output only. The workflow graph.
+  WorkflowGraph graph = 4;
+
+  // Output only. The delete cluster operation metadata.
+  ClusterOperation delete_cluster = 5;
+
+  // Output only. The workflow state.
+  State state = 6;
+
+  // Output only. The name of the target cluster.
+  string cluster_name = 7;
+
+  // Map from parameter names to values that were used for those parameters.
+  map<string, string> parameters = 8;
+
+  // Output only. Workflow start time.
+  google.protobuf.Timestamp start_time = 9;
+
+  // Output only. Workflow end time.
+  google.protobuf.Timestamp end_time = 10;
+
+  // Output only. The UUID of target cluster.
+  string cluster_uuid = 11;
+}
+
+// The cluster operation triggered by a workflow.
+message ClusterOperation {
+  // Output only. The id of the cluster operation.
+  string operation_id = 1;
+
+  // Output only. Error, if operation failed.
+  string error = 2;
+
+  // Output only. Indicates the operation is done.
+  bool done = 3;
+}
+
+// The workflow graph.
+message WorkflowGraph {
+  // Output only. The workflow nodes.
+  repeated WorkflowNode nodes = 1;
+}
+
+// The workflow node.
+message WorkflowNode {
+  // The workflow node state.
+  enum NodeState {
+    // State is unspecified.
+    NODE_STATE_UNSPECIFIED = 0;
+
+    // The node is awaiting prerequisite node to finish.
+    BLOCKED = 1;
+
+    // The node is runnable but not running.
+    RUNNABLE = 2;
+
+    // The node is running.
+    RUNNING = 3;
+
+    // The node completed successfully.
+    COMPLETED = 4;
+
+    // The node failed. A node can be marked FAILED because
+    // its ancestor or peer failed.
+    FAILED = 5;
+  }
+
+  // Output only. The name of the node.
+  string step_id = 1;
+
+  // Output only. Node's prerequisite nodes.
+  repeated string prerequisite_step_ids = 2;
+
+  // Output only. The job id; populated after the node enters RUNNING state.
+  string job_id = 3;
+
+  // Output only. The node state.
+  NodeState state = 5;
+
+  // Output only. The error detail.
+  string error = 6;
+}
+
+// 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 Dataproc workflow template to create.
+  WorkflowTemplate template = 2;
+}
+
+// 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;
+
+  // Optional. The version of workflow template to retrieve. Only previously
+  // instatiated versions can be retrieved.
+  //
+  // If unspecified, retrieves the current version.
+  int32 version = 2;
+}
+
+// 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;
+
+  // Optional. The version of workflow template to instantiate. If specified,
+  // the workflow will be instantiated only if the current version of
+  // the workflow template has the supplied version.
+  //
+  // This option cannot be used to instantiate a previous version of
+  // workflow template.
+  int32 version = 2;
+
+  // Optional. A tag that prevents multiple concurrent workflow
+  // instances with the same tag from running. This mitigates risk of
+  // concurrent instances started due to retries.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+
+  // Optional. Map from parameter names to values that should be used for those
+  // parameters. Values may not exceed 100 characters.
+  map<string, string> parameters = 6;
+}
+
+// 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 workflow template to instantiate.
+  WorkflowTemplate template = 2;
+
+  // Optional. A tag that prevents multiple concurrent workflow
+  // instances with the same tag from running. This mitigates risk of
+  // concurrent instances started due to retries.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// A request to update a workflow template.
+message UpdateWorkflowTemplateRequest {
+  // Required. The updated workflow template.
+  //
+  // The `template.version` field must match the current version.
+  WorkflowTemplate template = 1;
+}
+
+// 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;
+
+  // Optional. The maximum number of results to return in each response.
+  int32 page_size = 2;
+
+  // Optional. The page token, returned by a previous call, to request the
+  // next page of results.
+  string page_token = 3;
+}
+
+// A response to a request to list workflow templates in a project.
+message ListWorkflowTemplatesResponse {
+  // Output only. WorkflowTemplates list.
+  repeated WorkflowTemplate templates = 1;
+
+  // 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 <code>ListWorkflowTemplatesRequest</code>.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // 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;
+}
diff --git a/dataproc/google/cloud/dataproc_v1/proto/workflow_templates_pb2.py b/dataproc/google/cloud/dataproc_v1/proto/workflow_templates_pb2.py
new file mode 100644
index 000000000000..a8f2903a1152
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/workflow_templates_pb2.py
@@ -0,0 +1,3223 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1/proto/workflow_templates.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.dataproc_v1.proto import (
+    clusters_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2,
+)
+from google.cloud.dataproc_v1.proto import (
+    jobs_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1/proto/workflow_templates.proto",
+    package="google.cloud.dataproc.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.dataproc.v1B\026WorkflowTemplatesProtoP\001Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/dataproc_v1/proto/workflow_templates.proto\x12\x18google.cloud.dataproc.v1\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/dataproc_v1/proto/clusters.proto\x1a)google/cloud/dataproc_v1/proto/jobs.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xd3\x03\n\x10WorkflowTemplate\x12\n\n\x02id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x03 \x01(\x05\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x46\n\x06labels\x18\x06 \x03(\x0b\x32\x36.google.cloud.dataproc.v1.WorkflowTemplate.LabelsEntry\x12\x46\n\tplacement\x18\x07 \x01(\x0b\x32\x33.google.cloud.dataproc.v1.WorkflowTemplatePlacement\x12\x32\n\x04jobs\x18\x08 \x03(\x0b\x32$.google.cloud.dataproc.v1.OrderedJob\x12?\n\nparameters\x18\t \x03(\x0b\x32+.google.cloud.dataproc.v1.TemplateParameter\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xb4\x01\n\x19WorkflowTemplatePlacement\x12\x43\n\x0fmanaged_cluster\x18\x01 \x01(\x0b\x32(.google.cloud.dataproc.v1.ManagedClusterH\x00\x12\x45\n\x10\x63luster_selector\x18\x02 \x01(\x0b\x32).google.cloud.dataproc.v1.ClusterSelectorH\x00\x42\x0b\n\tplacement"\xd4\x01\n\x0eManagedCluster\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x37\n\x06\x63onfig\x18\x03 \x01(\x0b\x32\'.google.cloud.dataproc.v1.ClusterConfig\x12\x44\n\x06labels\x18\x04 \x03(\x0b\x32\x34.google.cloud.dataproc.v1.ManagedCluster.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xab\x01\n\x0f\x43lusterSelector\x12\x0c\n\x04zone\x18\x01 \x01(\t\x12T\n\x0e\x63luster_labels\x18\x02 \x03(\x0b\x32<.google.cloud.dataproc.v1.ClusterSelector.ClusterLabelsEntry\x1a\x34\n\x12\x43lusterLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xd3\x04\n\nOrderedJob\x12\x0f\n\x07step_id\x18\x01 \x01(\t\x12\x39\n\nhadoop_job\x18\x02 \x01(\x0b\x32#.google.cloud.dataproc.v1.HadoopJobH\x00\x12\x37\n\tspark_job\x18\x03 \x01(\x0b\x32".google.cloud.dataproc.v1.SparkJobH\x00\x12;\n\x0bpyspark_job\x18\x04 \x01(\x0b\x32$.google.cloud.dataproc.v1.PySparkJobH\x00\x12\x35\n\x08hive_job\x18\x05 \x01(\x0b\x32!.google.cloud.dataproc.v1.HiveJobH\x00\x12\x33\n\x07pig_job\x18\x06 \x01(\x0b\x32 .google.cloud.dataproc.v1.PigJobH\x00\x12>\n\rspark_sql_job\x18\x07 \x01(\x0b\x32%.google.cloud.dataproc.v1.SparkSqlJobH\x00\x12@\n\x06labels\x18\x08 \x03(\x0b\x32\x30.google.cloud.dataproc.v1.OrderedJob.LabelsEntry\x12;\n\nscheduling\x18\t \x01(\x0b\x32\'.google.cloud.dataproc.v1.JobScheduling\x12\x1d\n\x15prerequisite_step_ids\x18\n \x03(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\n\n\x08job_type"\x89\x01\n\x11TemplateParameter\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x66ields\x18\x02 \x03(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x41\n\nvalidation\x18\x04 \x01(\x0b\x32-.google.cloud.dataproc.v1.ParameterValidation"\xa1\x01\n\x13ParameterValidation\x12:\n\x05regex\x18\x01 \x01(\x0b\x32).google.cloud.dataproc.v1.RegexValidationH\x00\x12;\n\x06values\x18\x02 \x01(\x0b\x32).google.cloud.dataproc.v1.ValueValidationH\x00\x42\x11\n\x0fvalidation_type""\n\x0fRegexValidation\x12\x0f\n\x07regexes\x18\x01 \x03(\t"!\n\x0fValueValidation\x12\x0e\n\x06values\x18\x01 \x03(\t"\xfd\x04\n\x10WorkflowMetadata\x12\x10\n\x08template\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05\x12\x42\n\x0e\x63reate_cluster\x18\x03 \x01(\x0b\x32*.google.cloud.dataproc.v1.ClusterOperation\x12\x36\n\x05graph\x18\x04 \x01(\x0b\x32\'.google.cloud.dataproc.v1.WorkflowGraph\x12\x42\n\x0e\x64\x65lete_cluster\x18\x05 \x01(\x0b\x32*.google.cloud.dataproc.v1.ClusterOperation\x12?\n\x05state\x18\x06 \x01(\x0e\x32\x30.google.cloud.dataproc.v1.WorkflowMetadata.State\x12\x14\n\x0c\x63luster_name\x18\x07 \x01(\t\x12N\n\nparameters\x18\x08 \x03(\x0b\x32:.google.cloud.dataproc.v1.WorkflowMetadata.ParametersEntry\x12.\n\nstart_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x14\n\x0c\x63luster_uuid\x18\x0b \x01(\t\x1a\x31\n\x0fParametersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"8\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03"E\n\x10\x43lusterOperation\x12\x14\n\x0coperation_id\x18\x01 \x01(\t\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x0c\n\x04\x64one\x18\x03 \x01(\x08"F\n\rWorkflowGraph\x12\x35\n\x05nodes\x18\x01 \x03(\x0b\x32&.google.cloud.dataproc.v1.WorkflowNode"\x8a\x02\n\x0cWorkflowNode\x12\x0f\n\x07step_id\x18\x01 \x01(\t\x12\x1d\n\x15prerequisite_step_ids\x18\x02 \x03(\t\x12\x0e\n\x06job_id\x18\x03 \x01(\t\x12?\n\x05state\x18\x05 \x01(\x0e\x32\x30.google.cloud.dataproc.v1.WorkflowNode.NodeState\x12\r\n\x05\x65rror\x18\x06 \x01(\t"j\n\tNodeState\x12\x1a\n\x16NODE_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x42LOCKED\x10\x01\x12\x0c\n\x08RUNNABLE\x10\x02\x12\x0b\n\x07RUNNING\x10\x03\x12\r\n\tCOMPLETED\x10\x04\x12\n\n\x06\x46\x41ILED\x10\x05"m\n\x1d\x43reateWorkflowTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x08template\x18\x02 \x01(\x0b\x32*.google.cloud.dataproc.v1.WorkflowTemplate";\n\x1aGetWorkflowTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05"\xec\x01\n"InstantiateWorkflowTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05\x12\x12\n\nrequest_id\x18\x05 \x01(\t\x12`\n\nparameters\x18\x06 \x03(\x0b\x32L.google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.ParametersEntry\x1a\x31\n\x0fParametersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x8c\x01\n(InstantiateInlineWorkflowTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x08template\x18\x02 \x01(\x0b\x32*.google.cloud.dataproc.v1.WorkflowTemplate\x12\x12\n\nrequest_id\x18\x03 \x01(\t"]\n\x1dUpdateWorkflowTemplateRequest\x12<\n\x08template\x18\x01 \x01(\x0b\x32*.google.cloud.dataproc.v1.WorkflowTemplate"U\n\x1cListWorkflowTemplatesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"w\n\x1dListWorkflowTemplatesResponse\x12=\n\ttemplates\x18\x01 \x03(\x0b\x32*.google.cloud.dataproc.v1.WorkflowTemplate\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t">\n\x1d\x44\x65leteWorkflowTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05\x32\xe2\x0e\n\x17WorkflowTemplateService\x12\x89\x02\n\x16\x43reateWorkflowTemplate\x12\x37.google.cloud.dataproc.v1.CreateWorkflowTemplateRequest\x1a*.google.cloud.dataproc.v1.WorkflowTemplate"\x89\x01\x82\xd3\xe4\x93\x02\x82\x01"5/v1/{parent=projects/*/locations/*}/workflowTemplates:\x08templateZ?"3/v1/{parent=projects/*/regions/*}/workflowTemplates:\x08template\x12\xed\x01\n\x13GetWorkflowTemplate\x12\x34.google.cloud.dataproc.v1.GetWorkflowTemplateRequest\x1a*.google.cloud.dataproc.v1.WorkflowTemplate"t\x82\xd3\xe4\x93\x02n\x12\x35/v1/{name=projects/*/locations/*/workflowTemplates/*}Z5\x12\x33/v1/{name=projects/*/regions/*/workflowTemplates/*}\x12\x90\x02\n\x1bInstantiateWorkflowTemplate\x12<.google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest\x1a\x1d.google.longrunning.Operation"\x93\x01\x82\xd3\xe4\x93\x02\x8c\x01"A/v1/{name=projects/*/locations/*/workflowTemplates/*}:instantiate:\x01*ZD"?/v1/{name=projects/*/regions/*/workflowTemplates/*}:instantiate:\x01*\x12\xb6\x02\n!InstantiateInlineWorkflowTemplate\x12\x42.google.cloud.dataproc.v1.InstantiateInlineWorkflowTemplateRequest\x1a\x1d.google.longrunning.Operation"\xad\x01\x82\xd3\xe4\x93\x02\xa6\x01"G/v1/{parent=projects/*/locations/*}/workflowTemplates:instantiateInline:\x08templateZQ"E/v1/{parent=projects/*/regions/*}/workflowTemplates:instantiateInline:\x08template\x12\x9b\x02\n\x16UpdateWorkflowTemplate\x12\x37.google.cloud.dataproc.v1.UpdateWorkflowTemplateRequest\x1a*.google.cloud.dataproc.v1.WorkflowTemplate"\x9b\x01\x82\xd3\xe4\x93\x02\x94\x01\x1a>/v1/{template.name=projects/*/locations/*/workflowTemplates/*}:\x08templateZH\x1a</v1/{template.name=projects/*/regions/*/workflowTemplates/*}:\x08template\x12\xfe\x01\n\x15ListWorkflowTemplates\x12\x36.google.cloud.dataproc.v1.ListWorkflowTemplatesRequest\x1a\x37.google.cloud.dataproc.v1.ListWorkflowTemplatesResponse"t\x82\xd3\xe4\x93\x02n\x12\x35/v1/{parent=projects/*/locations/*}/workflowTemplatesZ5\x12\x33/v1/{parent=projects/*/regions/*}/workflowTemplates\x12\xdf\x01\n\x16\x44\x65leteWorkflowTemplate\x12\x37.google.cloud.dataproc.v1.DeleteWorkflowTemplateRequest\x1a\x16.google.protobuf.Empty"t\x82\xd3\xe4\x93\x02n*5/v1/{name=projects/*/locations/*/workflowTemplates/*}Z5*3/v1/{name=projects/*/regions/*/workflowTemplates/*}Bz\n\x1c\x63om.google.cloud.dataproc.v1B\x16WorkflowTemplatesProtoP\x01Z@google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_WORKFLOWMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1.WorkflowMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2901,
+    serialized_end=2957,
+)
+_sym_db.RegisterEnumDescriptor(_WORKFLOWMETADATA_STATE)
+
+_WORKFLOWNODE_NODESTATE = _descriptor.EnumDescriptor(
+    name="NodeState",
+    full_name="google.cloud.dataproc.v1.WorkflowNode.NodeState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NODE_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BLOCKED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3263,
+    serialized_end=3369,
+)
+_sym_db.RegisterEnumDescriptor(_WORKFLOWNODE_NODESTATE)
+
+
+_WORKFLOWTEMPLATE_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1.WorkflowTemplate.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=727,
+    serialized_end=772,
+)
+
+_WORKFLOWTEMPLATE = _descriptor.Descriptor(
+    name="WorkflowTemplate",
+    full_name="google.cloud.dataproc.v1.WorkflowTemplate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.name",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.version",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.update_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.labels",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="placement",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.placement",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.jobs",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplate.parameters",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WORKFLOWTEMPLATE_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=305,
+    serialized_end=772,
+)
+
+
+_WORKFLOWTEMPLATEPLACEMENT = _descriptor.Descriptor(
+    name="WorkflowTemplatePlacement",
+    full_name="google.cloud.dataproc.v1.WorkflowTemplatePlacement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="managed_cluster",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplatePlacement.managed_cluster",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_selector",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplatePlacement.cluster_selector",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="placement",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplatePlacement.placement",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=775,
+    serialized_end=955,
+)
+
+
+_MANAGEDCLUSTER_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1.ManagedCluster.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.ManagedCluster.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.ManagedCluster.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=727,
+    serialized_end=772,
+)
+
+_MANAGEDCLUSTER = _descriptor.Descriptor(
+    name="ManagedCluster",
+    full_name="google.cloud.dataproc.v1.ManagedCluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.ManagedCluster.cluster_name",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.dataproc.v1.ManagedCluster.config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1.ManagedCluster.labels",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MANAGEDCLUSTER_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=958,
+    serialized_end=1170,
+)
+
+
+_CLUSTERSELECTOR_CLUSTERLABELSENTRY = _descriptor.Descriptor(
+    name="ClusterLabelsEntry",
+    full_name="google.cloud.dataproc.v1.ClusterSelector.ClusterLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.ClusterSelector.ClusterLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.ClusterSelector.ClusterLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1292,
+    serialized_end=1344,
+)
+
+_CLUSTERSELECTOR = _descriptor.Descriptor(
+    name="ClusterSelector",
+    full_name="google.cloud.dataproc.v1.ClusterSelector",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.cloud.dataproc.v1.ClusterSelector.zone",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_labels",
+            full_name="google.cloud.dataproc.v1.ClusterSelector.cluster_labels",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTERSELECTOR_CLUSTERLABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1173,
+    serialized_end=1344,
+)
+
+
+_ORDEREDJOB_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1.OrderedJob.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.OrderedJob.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.OrderedJob.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=727,
+    serialized_end=772,
+)
+
+_ORDEREDJOB = _descriptor.Descriptor(
+    name="OrderedJob",
+    full_name="google.cloud.dataproc.v1.OrderedJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="step_id",
+            full_name="google.cloud.dataproc.v1.OrderedJob.step_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hadoop_job",
+            full_name="google.cloud.dataproc.v1.OrderedJob.hadoop_job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_job",
+            full_name="google.cloud.dataproc.v1.OrderedJob.spark_job",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pyspark_job",
+            full_name="google.cloud.dataproc.v1.OrderedJob.pyspark_job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hive_job",
+            full_name="google.cloud.dataproc.v1.OrderedJob.hive_job",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pig_job",
+            full_name="google.cloud.dataproc.v1.OrderedJob.pig_job",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_sql_job",
+            full_name="google.cloud.dataproc.v1.OrderedJob.spark_sql_job",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1.OrderedJob.labels",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scheduling",
+            full_name="google.cloud.dataproc.v1.OrderedJob.scheduling",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="prerequisite_step_ids",
+            full_name="google.cloud.dataproc.v1.OrderedJob.prerequisite_step_ids",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ORDEREDJOB_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="job_type",
+            full_name="google.cloud.dataproc.v1.OrderedJob.job_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1347,
+    serialized_end=1942,
+)
+
+
+_TEMPLATEPARAMETER = _descriptor.Descriptor(
+    name="TemplateParameter",
+    full_name="google.cloud.dataproc.v1.TemplateParameter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1.TemplateParameter.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.dataproc.v1.TemplateParameter.fields",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.dataproc.v1.TemplateParameter.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validation",
+            full_name="google.cloud.dataproc.v1.TemplateParameter.validation",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1945,
+    serialized_end=2082,
+)
+
+
+_PARAMETERVALIDATION = _descriptor.Descriptor(
+    name="ParameterValidation",
+    full_name="google.cloud.dataproc.v1.ParameterValidation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="regex",
+            full_name="google.cloud.dataproc.v1.ParameterValidation.regex",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.cloud.dataproc.v1.ParameterValidation.values",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="validation_type",
+            full_name="google.cloud.dataproc.v1.ParameterValidation.validation_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2085,
+    serialized_end=2246,
+)
+
+
+_REGEXVALIDATION = _descriptor.Descriptor(
+    name="RegexValidation",
+    full_name="google.cloud.dataproc.v1.RegexValidation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="regexes",
+            full_name="google.cloud.dataproc.v1.RegexValidation.regexes",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2248,
+    serialized_end=2282,
+)
+
+
+_VALUEVALIDATION = _descriptor.Descriptor(
+    name="ValueValidation",
+    full_name="google.cloud.dataproc.v1.ValueValidation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.cloud.dataproc.v1.ValueValidation.values",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2284,
+    serialized_end=2317,
+)
+
+
+_WORKFLOWMETADATA_PARAMETERSENTRY = _descriptor.Descriptor(
+    name="ParametersEntry",
+    full_name="google.cloud.dataproc.v1.WorkflowMetadata.ParametersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.ParametersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.ParametersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2850,
+    serialized_end=2899,
+)
+
+_WORKFLOWMETADATA = _descriptor.Descriptor(
+    name="WorkflowMetadata",
+    full_name="google.cloud.dataproc.v1.WorkflowMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.template",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_cluster",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.create_cluster",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="graph",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.graph",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_cluster",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.delete_cluster",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.state",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.cluster_name",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.parameters",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.start_time",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.end_time",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1.WorkflowMetadata.cluster_uuid",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WORKFLOWMETADATA_PARAMETERSENTRY],
+    enum_types=[_WORKFLOWMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2320,
+    serialized_end=2957,
+)
+
+
+_CLUSTEROPERATION = _descriptor.Descriptor(
+    name="ClusterOperation",
+    full_name="google.cloud.dataproc.v1.ClusterOperation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.cloud.dataproc.v1.ClusterOperation.operation_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.dataproc.v1.ClusterOperation.error",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="done",
+            full_name="google.cloud.dataproc.v1.ClusterOperation.done",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2959,
+    serialized_end=3028,
+)
+
+
+_WORKFLOWGRAPH = _descriptor.Descriptor(
+    name="WorkflowGraph",
+    full_name="google.cloud.dataproc.v1.WorkflowGraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="nodes",
+            full_name="google.cloud.dataproc.v1.WorkflowGraph.nodes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3030,
+    serialized_end=3100,
+)
+
+
+_WORKFLOWNODE = _descriptor.Descriptor(
+    name="WorkflowNode",
+    full_name="google.cloud.dataproc.v1.WorkflowNode",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="step_id",
+            full_name="google.cloud.dataproc.v1.WorkflowNode.step_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="prerequisite_step_ids",
+            full_name="google.cloud.dataproc.v1.WorkflowNode.prerequisite_step_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1.WorkflowNode.job_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1.WorkflowNode.state",
+            index=3,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.dataproc.v1.WorkflowNode.error",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_WORKFLOWNODE_NODESTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3103,
+    serialized_end=3369,
+)
+
+
+_CREATEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="CreateWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1.CreateWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1.CreateWorkflowTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1.CreateWorkflowTemplateRequest.template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3371,
+    serialized_end=3480,
+)
+
+
+_GETWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="GetWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1.GetWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1.GetWorkflowTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1.GetWorkflowTemplateRequest.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3482,
+    serialized_end=3541,
+)
+
+
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY = _descriptor.Descriptor(
+    name="ParametersEntry",
+    full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.ParametersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.ParametersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.ParametersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2850,
+    serialized_end=2899,
+)
+
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="InstantiateWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.request_id",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.parameters",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3544,
+    serialized_end=3780,
+)
+
+
+_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="InstantiateInlineWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1.InstantiateInlineWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1.InstantiateInlineWorkflowTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1.InstantiateInlineWorkflowTemplateRequest.template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1.InstantiateInlineWorkflowTemplateRequest.request_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3783,
+    serialized_end=3923,
+)
+
+
+_UPDATEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="UpdateWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1.UpdateWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1.UpdateWorkflowTemplateRequest.template",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3925,
+    serialized_end=4018,
+)
+
+
+_LISTWORKFLOWTEMPLATESREQUEST = _descriptor.Descriptor(
+    name="ListWorkflowTemplatesRequest",
+    full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4020,
+    serialized_end=4105,
+)
+
+
+_LISTWORKFLOWTEMPLATESRESPONSE = _descriptor.Descriptor(
+    name="ListWorkflowTemplatesResponse",
+    full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="templates",
+            full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesResponse.templates",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1.ListWorkflowTemplatesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4107,
+    serialized_end=4226,
+)
+
+
+_DELETEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="DeleteWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1.DeleteWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1.DeleteWorkflowTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1.DeleteWorkflowTemplateRequest.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4228,
+    serialized_end=4290,
+)
+
+_WORKFLOWTEMPLATE_LABELSENTRY.containing_type = _WORKFLOWTEMPLATE
+_WORKFLOWTEMPLATE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWTEMPLATE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWTEMPLATE.fields_by_name["labels"].message_type = _WORKFLOWTEMPLATE_LABELSENTRY
+_WORKFLOWTEMPLATE.fields_by_name["placement"].message_type = _WORKFLOWTEMPLATEPLACEMENT
+_WORKFLOWTEMPLATE.fields_by_name["jobs"].message_type = _ORDEREDJOB
+_WORKFLOWTEMPLATE.fields_by_name["parameters"].message_type = _TEMPLATEPARAMETER
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "managed_cluster"
+].message_type = _MANAGEDCLUSTER
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "cluster_selector"
+].message_type = _CLUSTERSELECTOR
+_WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"].fields.append(
+    _WORKFLOWTEMPLATEPLACEMENT.fields_by_name["managed_cluster"]
+)
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "managed_cluster"
+].containing_oneof = _WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"]
+_WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"].fields.append(
+    _WORKFLOWTEMPLATEPLACEMENT.fields_by_name["cluster_selector"]
+)
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "cluster_selector"
+].containing_oneof = _WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"]
+_MANAGEDCLUSTER_LABELSENTRY.containing_type = _MANAGEDCLUSTER
+_MANAGEDCLUSTER.fields_by_name[
+    "config"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1_dot_proto_dot_clusters__pb2._CLUSTERCONFIG
+)
+_MANAGEDCLUSTER.fields_by_name["labels"].message_type = _MANAGEDCLUSTER_LABELSENTRY
+_CLUSTERSELECTOR_CLUSTERLABELSENTRY.containing_type = _CLUSTERSELECTOR
+_CLUSTERSELECTOR.fields_by_name[
+    "cluster_labels"
+].message_type = _CLUSTERSELECTOR_CLUSTERLABELSENTRY
+_ORDEREDJOB_LABELSENTRY.containing_type = _ORDEREDJOB
+_ORDEREDJOB.fields_by_name[
+    "hadoop_job"
+].message_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._HADOOPJOB
+_ORDEREDJOB.fields_by_name[
+    "spark_job"
+].message_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._SPARKJOB
+_ORDEREDJOB.fields_by_name[
+    "pyspark_job"
+].message_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._PYSPARKJOB
+_ORDEREDJOB.fields_by_name[
+    "hive_job"
+].message_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._HIVEJOB
+_ORDEREDJOB.fields_by_name[
+    "pig_job"
+].message_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._PIGJOB
+_ORDEREDJOB.fields_by_name[
+    "spark_sql_job"
+].message_type = google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._SPARKSQLJOB
+_ORDEREDJOB.fields_by_name["labels"].message_type = _ORDEREDJOB_LABELSENTRY
+_ORDEREDJOB.fields_by_name[
+    "scheduling"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1_dot_proto_dot_jobs__pb2._JOBSCHEDULING
+)
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["hadoop_job"]
+)
+_ORDEREDJOB.fields_by_name["hadoop_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["spark_job"]
+)
+_ORDEREDJOB.fields_by_name["spark_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["pyspark_job"]
+)
+_ORDEREDJOB.fields_by_name["pyspark_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["hive_job"]
+)
+_ORDEREDJOB.fields_by_name["hive_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["pig_job"]
+)
+_ORDEREDJOB.fields_by_name["pig_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["spark_sql_job"]
+)
+_ORDEREDJOB.fields_by_name[
+    "spark_sql_job"
+].containing_oneof = _ORDEREDJOB.oneofs_by_name["job_type"]
+_TEMPLATEPARAMETER.fields_by_name["validation"].message_type = _PARAMETERVALIDATION
+_PARAMETERVALIDATION.fields_by_name["regex"].message_type = _REGEXVALIDATION
+_PARAMETERVALIDATION.fields_by_name["values"].message_type = _VALUEVALIDATION
+_PARAMETERVALIDATION.oneofs_by_name["validation_type"].fields.append(
+    _PARAMETERVALIDATION.fields_by_name["regex"]
+)
+_PARAMETERVALIDATION.fields_by_name[
+    "regex"
+].containing_oneof = _PARAMETERVALIDATION.oneofs_by_name["validation_type"]
+_PARAMETERVALIDATION.oneofs_by_name["validation_type"].fields.append(
+    _PARAMETERVALIDATION.fields_by_name["values"]
+)
+_PARAMETERVALIDATION.fields_by_name[
+    "values"
+].containing_oneof = _PARAMETERVALIDATION.oneofs_by_name["validation_type"]
+_WORKFLOWMETADATA_PARAMETERSENTRY.containing_type = _WORKFLOWMETADATA
+_WORKFLOWMETADATA.fields_by_name["create_cluster"].message_type = _CLUSTEROPERATION
+_WORKFLOWMETADATA.fields_by_name["graph"].message_type = _WORKFLOWGRAPH
+_WORKFLOWMETADATA.fields_by_name["delete_cluster"].message_type = _CLUSTEROPERATION
+_WORKFLOWMETADATA.fields_by_name["state"].enum_type = _WORKFLOWMETADATA_STATE
+_WORKFLOWMETADATA.fields_by_name[
+    "parameters"
+].message_type = _WORKFLOWMETADATA_PARAMETERSENTRY
+_WORKFLOWMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWMETADATA_STATE.containing_type = _WORKFLOWMETADATA
+_WORKFLOWGRAPH.fields_by_name["nodes"].message_type = _WORKFLOWNODE
+_WORKFLOWNODE.fields_by_name["state"].enum_type = _WORKFLOWNODE_NODESTATE
+_WORKFLOWNODE_NODESTATE.containing_type = _WORKFLOWNODE
+_CREATEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "template"
+].message_type = _WORKFLOWTEMPLATE
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY.containing_type = (
+    _INSTANTIATEWORKFLOWTEMPLATEREQUEST
+)
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "parameters"
+].message_type = _INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY
+_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "template"
+].message_type = _WORKFLOWTEMPLATE
+_UPDATEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "template"
+].message_type = _WORKFLOWTEMPLATE
+_LISTWORKFLOWTEMPLATESRESPONSE.fields_by_name[
+    "templates"
+].message_type = _WORKFLOWTEMPLATE
+DESCRIPTOR.message_types_by_name["WorkflowTemplate"] = _WORKFLOWTEMPLATE
+DESCRIPTOR.message_types_by_name[
+    "WorkflowTemplatePlacement"
+] = _WORKFLOWTEMPLATEPLACEMENT
+DESCRIPTOR.message_types_by_name["ManagedCluster"] = _MANAGEDCLUSTER
+DESCRIPTOR.message_types_by_name["ClusterSelector"] = _CLUSTERSELECTOR
+DESCRIPTOR.message_types_by_name["OrderedJob"] = _ORDEREDJOB
+DESCRIPTOR.message_types_by_name["TemplateParameter"] = _TEMPLATEPARAMETER
+DESCRIPTOR.message_types_by_name["ParameterValidation"] = _PARAMETERVALIDATION
+DESCRIPTOR.message_types_by_name["RegexValidation"] = _REGEXVALIDATION
+DESCRIPTOR.message_types_by_name["ValueValidation"] = _VALUEVALIDATION
+DESCRIPTOR.message_types_by_name["WorkflowMetadata"] = _WORKFLOWMETADATA
+DESCRIPTOR.message_types_by_name["ClusterOperation"] = _CLUSTEROPERATION
+DESCRIPTOR.message_types_by_name["WorkflowGraph"] = _WORKFLOWGRAPH
+DESCRIPTOR.message_types_by_name["WorkflowNode"] = _WORKFLOWNODE
+DESCRIPTOR.message_types_by_name[
+    "CreateWorkflowTemplateRequest"
+] = _CREATEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetWorkflowTemplateRequest"
+] = _GETWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "InstantiateWorkflowTemplateRequest"
+] = _INSTANTIATEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "InstantiateInlineWorkflowTemplateRequest"
+] = _INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateWorkflowTemplateRequest"
+] = _UPDATEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListWorkflowTemplatesRequest"
+] = _LISTWORKFLOWTEMPLATESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListWorkflowTemplatesResponse"
+] = _LISTWORKFLOWTEMPLATESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteWorkflowTemplateRequest"
+] = _DELETEWORKFLOWTEMPLATEREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WorkflowTemplate = _reflection.GeneratedProtocolMessageType(
+    "WorkflowTemplate",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WORKFLOWTEMPLATE_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowTemplate.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_WORKFLOWTEMPLATE,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A Cloud Dataproc workflow template resource.
+  
+  
+  Attributes:
+      id:
+          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.
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. Used to perform a consistent read-modify-write.
+          This field should be left blank for a
+          ``CreateWorkflowTemplate`` request. It is required for an
+          ``UpdateWorkflowTemplate`` request, and must match the current
+          server version. A typical update template flow would fetch the
+          current template with a ``GetWorkflowTemplate`` request, which
+          will return 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.
+      create_time:
+          Output only. The time template was created.
+      update_time:
+          Output only. The time template was last updated.
+      labels:
+          Optional. The labels to associate with this template. These
+          labels will be propagated to all jobs and clusters created by
+          the workflow instance.  Label **keys** must contain 1 to 63
+          characters, and must conform to `RFC 1035
+          <https://www.ietf.org/rfc/rfc1035.txt>`__.  Label **values**
+          may be empty, but, if present, must contain 1 to 63
+          characters, and must conform to `RFC 1035
+          <https://www.ietf.org/rfc/rfc1035.txt>`__.  No more than 32
+          labels can be associated with a template.
+      placement:
+          Required. WorkflowTemplate scheduling information.
+      jobs:
+          Required. The Directed Acyclic Graph of Jobs to submit.
+      parameters:
+          Optional. Template parameters whose values are substituted
+          into the template. Values for parameters must be provided when
+          the template is instantiated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowTemplate)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowTemplate)
+_sym_db.RegisterMessage(WorkflowTemplate.LabelsEntry)
+
+WorkflowTemplatePlacement = _reflection.GeneratedProtocolMessageType(
+    "WorkflowTemplatePlacement",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKFLOWTEMPLATEPLACEMENT,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""Specifies workflow execution target.
+  
+  Either ``managed_cluster`` or ``cluster_selector`` is required.
+  
+  
+  Attributes:
+      placement:
+          Required. Specifies where workflow executes; either on a
+          managed cluster or an existing cluster chosen by labels.
+      managed_cluster:
+          Optional. A cluster that is managed by the workflow.
+      cluster_selector:
+          Optional. A selector that chooses target cluster for jobs
+          based on metadata.  The selector is evaluated at the time each
+          job is submitted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowTemplatePlacement)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowTemplatePlacement)
+
+ManagedCluster = _reflection.GeneratedProtocolMessageType(
+    "ManagedCluster",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MANAGEDCLUSTER_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ManagedCluster.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_MANAGEDCLUSTER,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""Cluster that is managed by the workflow.
+  
+  
+  Attributes:
+      cluster_name:
+          Required. The cluster name prefix. A unique cluster name will
+          be formed by appending a random suffix.  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.
+      config:
+          Required. The cluster configuration.
+      labels:
+          Optional. The labels to associate with this cluster.  Label
+          keys must be between 1 and 63 characters long. Label values must be between
+          1 and 63 characters long. No more than 32
+          labels can be associated with a given cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ManagedCluster)
+    ),
+)
+_sym_db.RegisterMessage(ManagedCluster)
+_sym_db.RegisterMessage(ManagedCluster.LabelsEntry)
+
+ClusterSelector = _reflection.GeneratedProtocolMessageType(
+    "ClusterSelector",
+    (_message.Message,),
+    dict(
+        ClusterLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ClusterLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTERSELECTOR_CLUSTERLABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterSelector.ClusterLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTERSELECTOR,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A selector that chooses target cluster for jobs based on metadata.
+  
+  
+  Attributes:
+      zone:
+          Optional. The zone where workflow process executes. This
+          parameter does not affect the selection of the cluster.  If
+          unspecified, the zone of the first cluster matching the
+          selector is used.
+      cluster_labels:
+          Required. The cluster labels. Cluster must have all labels to
+          match.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterSelector)
+    ),
+)
+_sym_db.RegisterMessage(ClusterSelector)
+_sym_db.RegisterMessage(ClusterSelector.ClusterLabelsEntry)
+
+OrderedJob = _reflection.GeneratedProtocolMessageType(
+    "OrderedJob",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ORDEREDJOB_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.OrderedJob.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_ORDEREDJOB,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A job executed by the workflow.
+  
+  
+  Attributes:
+      step_id:
+          Required. The step id. The id must be unique among all jobs
+          within the template.  The step id is used as prefix for job
+          id, as job ``goog-dataproc-workflow-step-id`` label, and in [p
+          rerequisiteStepIds][google.cloud.dataproc.v1.OrderedJob.prereq
+          uisite\_step\_ids] field from other steps.  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.
+      job_type:
+          Required. The job definition.
+      hadoop_job:
+          Job is a Hadoop job.
+      spark_job:
+          Job is a Spark job.
+      pyspark_job:
+          Job is a Pyspark job.
+      hive_job:
+          Job is a Hive job.
+      pig_job:
+          Job is a Pig job.
+      spark_sql_job:
+          Job is a SparkSql job.
+      labels:
+          Optional. The labels to associate with this job.  Label keys
+          must be between 1 and 63 characters long. Label values must be between
+          1 and 63 characters long. No more than 32 labels can be
+          associated with a given job.
+      scheduling:
+          Optional. Job scheduling configuration.
+      prerequisite_step_ids:
+          Optional. The optional list of prerequisite job step\_ids. If
+          not specified, the job will start at the beginning of
+          workflow.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.OrderedJob)
+    ),
+)
+_sym_db.RegisterMessage(OrderedJob)
+_sym_db.RegisterMessage(OrderedJob.LabelsEntry)
+
+TemplateParameter = _reflection.GeneratedProtocolMessageType(
+    "TemplateParameter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEMPLATEPARAMETER,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A configurable parameter that replaces one or more fields in the
+  template. Parameterizable fields: - Labels - File uris - Job properties
+  - Job arguments - Script variables - Main class (in HadoopJob and
+  SparkJob) - Zone (in ClusterSelector)
+  
+  
+  Attributes:
+      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.
+      fields:
+          Required. Paths to all fields that the parameter replaces. A
+          field is allowed to appear in at most one parameter's list of
+          field paths.  A field path is similar in syntax to a
+          [google.protobuf.FieldMask][google.protobuf.FieldMask]. For
+          example, a field path that references the zone field of a
+          workflow template's cluster selector would be specified as
+          ``placement.clusterSelector.zone``.  Also, field paths can
+          reference fields using the following syntax:  -  Values in
+          maps can be referenced by key:     -  labels['key']    -
+          placement.clusterSelector.clusterLabels['key']    -
+          placement.managedCluster.labels['key']    -
+          placement.clusterSelector.clusterLabels['key']    -
+          jobs['step-id'].labels['key']  -  Jobs in the jobs list can be
+          referenced by step-id:     -  jobs['step-
+          id'].hadoopJob.mainJarFileUri    -  jobs['step-
+          id'].hiveJob.queryFileUri    -  jobs['step-
+          id'].pySparkJob.mainPythonFileUri    -  jobs['step-
+          id'].hadoopJob.jarFileUris[0]    -  jobs['step-
+          id'].hadoopJob.archiveUris[0]    -  jobs['step-
+          id'].hadoopJob.fileUris[0]    -  jobs['step-
+          id'].pySparkJob.pythonFileUris[0]  -  Items in repeated fields
+          can be referenced by a zero-based index:     -  jobs['step-
+          id'].sparkJob.args[0]  -  Other examples:     -  jobs['step-
+          id'].hadoopJob.properties['key']    -  jobs['step-
+          id'].hadoopJob.args[0]    -  jobs['step-
+          id'].hiveJob.scriptVariables['key']    -  jobs['step-
+          id'].hadoopJob.mainJarFileUri    -
+          placement.clusterSelector.zone  It may not be possible to
+          parameterize maps and repeated fields in their entirety since
+          only individual map values and individual items in repeated
+          fields can be referenced. For example, the following field
+          paths are invalid:  -  placement.clusterSelector.clusterLabels
+          -  jobs['step-id'].sparkJob.args
+      description:
+          Optional. Brief description of the parameter. Must not exceed
+          1024 characters.
+      validation:
+          Optional. Validation rules to be applied to this parameter's
+          value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.TemplateParameter)
+    ),
+)
+_sym_db.RegisterMessage(TemplateParameter)
+
+ParameterValidation = _reflection.GeneratedProtocolMessageType(
+    "ParameterValidation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAMETERVALIDATION,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""Configuration for parameter validation.
+  
+  
+  Attributes:
+      validation_type:
+          Required. The type of validation to be performed.
+      regex:
+          Validation based on regular expressions.
+      values:
+          Validation based on a list of allowed values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ParameterValidation)
+    ),
+)
+_sym_db.RegisterMessage(ParameterValidation)
+
+RegexValidation = _reflection.GeneratedProtocolMessageType(
+    "RegexValidation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REGEXVALIDATION,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""Validation based on regular expressions.
+  
+  
+  Attributes:
+      regexes:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.RegexValidation)
+    ),
+)
+_sym_db.RegisterMessage(RegexValidation)
+
+ValueValidation = _reflection.GeneratedProtocolMessageType(
+    "ValueValidation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUEVALIDATION,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""Validation based on a list of allowed values.
+  
+  
+  Attributes:
+      values:
+          Required. List of allowed values for the parameter.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ValueValidation)
+    ),
+)
+_sym_db.RegisterMessage(ValueValidation)
+
+WorkflowMetadata = _reflection.GeneratedProtocolMessageType(
+    "WorkflowMetadata",
+    (_message.Message,),
+    dict(
+        ParametersEntry=_reflection.GeneratedProtocolMessageType(
+            "ParametersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WORKFLOWMETADATA_PARAMETERSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowMetadata.ParametersEntry)
+            ),
+        ),
+        DESCRIPTOR=_WORKFLOWMETADATA,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A Cloud Dataproc workflow template resource.
+  
+  
+  Attributes:
+      template:
+          Output only. The "resource name" of the template.
+      version:
+          Output only. The version of template at the time of workflow
+          instantiation.
+      create_cluster:
+          Output only. The create cluster operation metadata.
+      graph:
+          Output only. The workflow graph.
+      delete_cluster:
+          Output only. The delete cluster operation metadata.
+      state:
+          Output only. The workflow state.
+      cluster_name:
+          Output only. The name of the target cluster.
+      parameters:
+          Map from parameter names to values that were used for those
+          parameters.
+      start_time:
+          Output only. Workflow start time.
+      end_time:
+          Output only. Workflow end time.
+      cluster_uuid:
+          Output only. The UUID of target cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowMetadata)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowMetadata)
+_sym_db.RegisterMessage(WorkflowMetadata.ParametersEntry)
+
+ClusterOperation = _reflection.GeneratedProtocolMessageType(
+    "ClusterOperation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTEROPERATION,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""The cluster operation triggered by a workflow.
+  
+  
+  Attributes:
+      operation_id:
+          Output only. The id of the cluster operation.
+      error:
+          Output only. Error, if operation failed.
+      done:
+          Output only. Indicates the operation is done.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ClusterOperation)
+    ),
+)
+_sym_db.RegisterMessage(ClusterOperation)
+
+WorkflowGraph = _reflection.GeneratedProtocolMessageType(
+    "WorkflowGraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKFLOWGRAPH,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""The workflow graph.
+  
+  
+  Attributes:
+      nodes:
+          Output only. The workflow nodes.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowGraph)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowGraph)
+
+WorkflowNode = _reflection.GeneratedProtocolMessageType(
+    "WorkflowNode",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKFLOWNODE,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""The workflow node.
+  
+  
+  Attributes:
+      step_id:
+          Output only. The name of the node.
+      prerequisite_step_ids:
+          Output only. Node's prerequisite nodes.
+      job_id:
+          Output only. The job id; populated after the node enters
+          RUNNING state.
+      state:
+          Output only. The node state.
+      error:
+          Output only. The error detail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.WorkflowNode)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowNode)
+
+CreateWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to create a workflow template.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      template:
+          Required. The Dataproc workflow template to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.CreateWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateWorkflowTemplateRequest)
+
+GetWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "GetWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to fetch a workflow template.
+  
+  
+  Attributes:
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. The version of workflow template to retrieve. Only
+          previously instatiated versions can be retrieved.  If
+          unspecified, retrieves the current version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.GetWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetWorkflowTemplateRequest)
+
+InstantiateWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "InstantiateWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        ParametersEntry=_reflection.GeneratedProtocolMessageType(
+            "ParametersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY,
+                __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest.ParametersEntry)
+            ),
+        ),
+        DESCRIPTOR=_INSTANTIATEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to instantiate a workflow template.
+  
+  
+  Attributes:
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. The version of workflow template to instantiate. If
+          specified, the workflow will be instantiated only if the
+          current version of the workflow template has the supplied
+          version.  This option cannot be used to instantiate a previous
+          version of workflow template.
+      request_id:
+          Optional. A tag that prevents multiple concurrent workflow
+          instances with the same tag from running. This mitigates risk
+          of concurrent instances started due to retries.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The tag
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+      parameters:
+          Optional. Map from parameter names to values that should be
+          used for those parameters. Values may not exceed 100
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.InstantiateWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(InstantiateWorkflowTemplateRequest)
+_sym_db.RegisterMessage(InstantiateWorkflowTemplateRequest.ParametersEntry)
+
+InstantiateInlineWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "InstantiateInlineWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to instantiate an inline workflow template.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      template:
+          Required. The workflow template to instantiate.
+      request_id:
+          Optional. A tag that prevents multiple concurrent workflow
+          instances with the same tag from running. This mitigates risk
+          of concurrent instances started due to retries.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The tag
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.InstantiateInlineWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(InstantiateInlineWorkflowTemplateRequest)
+
+UpdateWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to update a workflow template.
+  
+  
+  Attributes:
+      template:
+          Required. The updated workflow template.  The
+          ``template.version`` field must match the current version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.UpdateWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateWorkflowTemplateRequest)
+
+ListWorkflowTemplatesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListWorkflowTemplatesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTWORKFLOWTEMPLATESREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to list workflow templates in a project.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      page_size:
+          Optional. The maximum number of results to return in each
+          response.
+      page_token:
+          Optional. The page token, returned by a previous call, to
+          request the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ListWorkflowTemplatesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListWorkflowTemplatesRequest)
+
+ListWorkflowTemplatesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListWorkflowTemplatesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTWORKFLOWTEMPLATESRESPONSE,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A response to a request to list workflow templates in a project.
+  
+  
+  Attributes:
+      templates:
+          Output only. WorkflowTemplates list.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.ListWorkflowTemplatesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListWorkflowTemplatesResponse)
+
+DeleteWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1.proto.workflow_templates_pb2",
+        __doc__="""A request to delete a workflow template.
+  
+  Currently started workflows will remain running.
+  
+  
+  Attributes:
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. The version of workflow template to delete. If
+          specified, will only delete the template if the current server
+          version matches specified version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1.DeleteWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteWorkflowTemplateRequest)
+
+
+DESCRIPTOR._options = None
+_WORKFLOWTEMPLATE_LABELSENTRY._options = None
+_MANAGEDCLUSTER_LABELSENTRY._options = None
+_CLUSTERSELECTOR_CLUSTERLABELSENTRY._options = None
+_ORDEREDJOB_LABELSENTRY._options = None
+_WORKFLOWMETADATA_PARAMETERSENTRY._options = None
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY._options = None
+
+_WORKFLOWTEMPLATESERVICE = _descriptor.ServiceDescriptor(
+    name="WorkflowTemplateService",
+    full_name="google.cloud.dataproc.v1.WorkflowTemplateService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4293,
+    serialized_end=6183,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEWORKFLOWTEMPLATEREQUEST,
+            output_type=_WORKFLOWTEMPLATE,
+            serialized_options=_b(
+                '\202\323\344\223\002\202\001"5/v1/{parent=projects/*/locations/*}/workflowTemplates:\010templateZ?"3/v1/{parent=projects/*/regions/*}/workflowTemplates:\010template'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.GetWorkflowTemplate",
+            index=1,
+            containing_service=None,
+            input_type=_GETWORKFLOWTEMPLATEREQUEST,
+            output_type=_WORKFLOWTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002n\0225/v1/{name=projects/*/locations/*/workflowTemplates/*}Z5\0223/v1/{name=projects/*/regions/*/workflowTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="InstantiateWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate",
+            index=2,
+            containing_service=None,
+            input_type=_INSTANTIATEWORKFLOWTEMPLATEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\214\001"A/v1/{name=projects/*/locations/*/workflowTemplates/*}:instantiate:\001*ZD"?/v1/{name=projects/*/regions/*/workflowTemplates/*}:instantiate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="InstantiateInlineWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateInlineWorkflowTemplate",
+            index=3,
+            containing_service=None,
+            input_type=_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\246\001"G/v1/{parent=projects/*/locations/*}/workflowTemplates:instantiateInline:\010templateZQ"E/v1/{parent=projects/*/regions/*}/workflowTemplates:instantiateInline:\010template'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.UpdateWorkflowTemplate",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATEWORKFLOWTEMPLATEREQUEST,
+            output_type=_WORKFLOWTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002\224\001\032>/v1/{template.name=projects/*/locations/*/workflowTemplates/*}:\010templateZH\032</v1/{template.name=projects/*/regions/*/workflowTemplates/*}:\010template"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListWorkflowTemplates",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.ListWorkflowTemplates",
+            index=5,
+            containing_service=None,
+            input_type=_LISTWORKFLOWTEMPLATESREQUEST,
+            output_type=_LISTWORKFLOWTEMPLATESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002n\0225/v1/{parent=projects/*/locations/*}/workflowTemplatesZ5\0223/v1/{parent=projects/*/regions/*}/workflowTemplates"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate",
+            index=6,
+            containing_service=None,
+            input_type=_DELETEWORKFLOWTEMPLATEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002n*5/v1/{name=projects/*/locations/*/workflowTemplates/*}Z5*3/v1/{name=projects/*/regions/*/workflowTemplates/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_WORKFLOWTEMPLATESERVICE)
+
+DESCRIPTOR.services_by_name["WorkflowTemplateService"] = _WORKFLOWTEMPLATESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1/proto/workflow_templates_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1/proto/workflow_templates_pb2_grpc.py
new file mode 100644
index 000000000000..413ede8c6d1d
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/proto/workflow_templates_pb2_grpc.py
@@ -0,0 +1,199 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1.proto import (
+    workflow_templates_pb2 as google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class WorkflowTemplateServiceStub(object):
+    """The API interface for managing Workflow Templates in the
+  Cloud Dataproc API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/CreateWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.CreateWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.FromString,
+        )
+        self.GetWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/GetWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.GetWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.FromString,
+        )
+        self.InstantiateWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/InstantiateWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.InstantiateWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.InstantiateInlineWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/InstantiateInlineWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.InstantiateInlineWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/UpdateWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.UpdateWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.FromString,
+        )
+        self.ListWorkflowTemplates = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/ListWorkflowTemplates",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesResponse.FromString,
+        )
+        self.DeleteWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1.WorkflowTemplateService/DeleteWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.DeleteWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class WorkflowTemplateServiceServicer(object):
+    """The API interface for managing Workflow Templates in the
+  Cloud Dataproc API.
+  """
+
+    def CreateWorkflowTemplate(self, request, context):
+        """Creates new workflow template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetWorkflowTemplate(self, request, context):
+        """Retrieves the latest workflow template.
+
+    Can retrieve previously instantiated template by specifying optional
+    version parameter.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def InstantiateWorkflowTemplate(self, request, context):
+        """Instantiates a template and begins execution.
+
+    The returned Operation can be used to track execution of
+    workflow by polling
+    [operations.get][google.longrunning.Operations.GetOperation].
+    The Operation will complete when entire workflow is finished.
+
+    The running workflow can be aborted via
+    [operations.cancel][google.longrunning.Operations.CancelOperation].
+    This will cause any inflight jobs to be cancelled and workflow-owned
+    clusters to be deleted.
+
+    The [Operation.metadata][google.longrunning.Operation.metadata] will be
+    [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata].
+
+    On successful completion,
+    [Operation.response][google.longrunning.Operation.response] will be
+    [Empty][google.protobuf.Empty].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def InstantiateInlineWorkflowTemplate(self, request, context):
+        """Instantiates a template and begins execution.
+
+    This method is equivalent to executing the sequence
+    [CreateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.InstantiateWorkflowTemplate],
+    [DeleteWorkflowTemplate][google.cloud.dataproc.v1.WorkflowTemplateService.DeleteWorkflowTemplate].
+
+    The returned Operation can be used to track execution of
+    workflow by polling
+    [operations.get][google.longrunning.Operations.GetOperation].
+    The Operation will complete when entire workflow is finished.
+
+    The running workflow can be aborted via
+    [operations.cancel][google.longrunning.Operations.CancelOperation].
+    This will cause any inflight jobs to be cancelled and workflow-owned
+    clusters to be deleted.
+
+    The [Operation.metadata][google.longrunning.Operation.metadata] will be
+    [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata].
+
+    On successful completion,
+    [Operation.response][google.longrunning.Operation.response] will be
+    [Empty][google.protobuf.Empty].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateWorkflowTemplate(self, request, context):
+        """Updates (replaces) workflow template. The updated template
+    must contain version that matches the current server version.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListWorkflowTemplates(self, request, context):
+        """Lists workflows that match the specified filter in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteWorkflowTemplate(self, request, context):
+        """Deletes a workflow template. It does not cancel in-progress workflows.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_WorkflowTemplateServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.CreateWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.SerializeToString,
+        ),
+        "GetWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.GetWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.GetWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.SerializeToString,
+        ),
+        "InstantiateWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.InstantiateWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.InstantiateWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "InstantiateInlineWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.InstantiateInlineWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.InstantiateInlineWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.UpdateWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.SerializeToString,
+        ),
+        "ListWorkflowTemplates": grpc.unary_unary_rpc_method_handler(
+            servicer.ListWorkflowTemplates,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesResponse.SerializeToString,
+        ),
+        "DeleteWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1_dot_proto_dot_workflow__templates__pb2.DeleteWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1.WorkflowTemplateService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1/types.py b/dataproc/google/cloud/dataproc_v1/types.py
new file mode 100644
index 000000000000..4d3c90bc9abc
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1/types.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.dataproc_v1.proto import clusters_pb2
+from google.cloud.dataproc_v1.proto import jobs_pb2
+from google.cloud.dataproc_v1.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.dataproc_v1.proto import workflow_templates_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    longrunning_operations_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [clusters_pb2, jobs_pb2, proto_operations_pb2, workflow_templates_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.dataproc_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/dataproc/google/cloud/dataproc_v1beta2/__init__.py b/dataproc/google/cloud/dataproc_v1beta2/__init__.py
new file mode 100644
index 000000000000..5d5232f1d392
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/__init__.py
@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.dataproc_v1beta2 import types
+from google.cloud.dataproc_v1beta2.gapic import autoscaling_policy_service_client
+from google.cloud.dataproc_v1beta2.gapic import cluster_controller_client
+from google.cloud.dataproc_v1beta2.gapic import enums
+from google.cloud.dataproc_v1beta2.gapic import job_controller_client
+from google.cloud.dataproc_v1beta2.gapic import workflow_template_service_client
+
+
+class AutoscalingPolicyServiceClient(
+    autoscaling_policy_service_client.AutoscalingPolicyServiceClient
+):
+    __doc__ = autoscaling_policy_service_client.AutoscalingPolicyServiceClient.__doc__
+    enums = enums
+
+
+class ClusterControllerClient(cluster_controller_client.ClusterControllerClient):
+    __doc__ = cluster_controller_client.ClusterControllerClient.__doc__
+    enums = enums
+
+
+class JobControllerClient(job_controller_client.JobControllerClient):
+    __doc__ = job_controller_client.JobControllerClient.__doc__
+    enums = enums
+
+
+class WorkflowTemplateServiceClient(
+    workflow_template_service_client.WorkflowTemplateServiceClient
+):
+    __doc__ = workflow_template_service_client.WorkflowTemplateServiceClient.__doc__
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "AutoscalingPolicyServiceClient",
+    "ClusterControllerClient",
+    "JobControllerClient",
+    "WorkflowTemplateServiceClient",
+)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/__init__.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/autoscaling_policy_service_client.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/autoscaling_policy_service_client.py
new file mode 100644
index 000000000000..6a2a3af20139
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/autoscaling_policy_service_client.py
@@ -0,0 +1,610 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1beta2 AutoscalingPolicyService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.dataproc_v1beta2.gapic import autoscaling_policy_service_client_config
+from google.cloud.dataproc_v1beta2.gapic import enums
+from google.cloud.dataproc_v1beta2.gapic.transports import (
+    autoscaling_policy_service_grpc_transport,
+)
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2_grpc
+from google.protobuf import empty_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class AutoscalingPolicyServiceClient(object):
+    """
+    The API interface for managing autoscaling policies in the
+    Google Cloud Dataproc API.
+    """
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1beta2.AutoscalingPolicyService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            AutoscalingPolicyServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def autoscaling_policy_path(cls, project, region, autoscaling_policy):
+        """Return a fully-qualified autoscaling_policy string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/regions/{region}/autoscalingPolicies/{autoscaling_policy}",
+            project=project,
+            region=region,
+            autoscaling_policy=autoscaling_policy,
+        )
+
+    @classmethod
+    def region_path(cls, project, region):
+        """Return a fully-qualified region string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/regions/{region}", project=project, region=region
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.AutoscalingPolicyServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.AutoscalingPolicyServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = autoscaling_policy_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=autoscaling_policy_service_grpc_transport.AutoscalingPolicyServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = autoscaling_policy_service_grpc_transport.AutoscalingPolicyServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_autoscaling_policy(
+        self,
+        parent,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates new autoscaling policy.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.create_autoscaling_policy(parent, policy)
+
+        Args:
+            parent (str): 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}``.
+            policy (Union[dict, ~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy]): The autoscaling policy to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_autoscaling_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_autoscaling_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_autoscaling_policy,
+                default_retry=self._method_configs["CreateAutoscalingPolicy"].retry,
+                default_timeout=self._method_configs["CreateAutoscalingPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = autoscaling_policies_pb2.CreateAutoscalingPolicyRequest(
+            parent=parent, policy=policy
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_autoscaling_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_autoscaling_policy(
+        self,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates (replaces) autoscaling policy.
+
+        Disabled check for update\_mask, because all updates will be full
+        replacements.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.update_autoscaling_policy(policy)
+
+        Args:
+            policy (Union[dict, ~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy]): Required. The updated autoscaling policy.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_autoscaling_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_autoscaling_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_autoscaling_policy,
+                default_retry=self._method_configs["UpdateAutoscalingPolicy"].retry,
+                default_timeout=self._method_configs["UpdateAutoscalingPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = autoscaling_policies_pb2.UpdateAutoscalingPolicyRequest(policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("policy.name", policy.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_autoscaling_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_autoscaling_policy(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves autoscaling policy.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+            >>>
+            >>> name = client.autoscaling_policy_path('[PROJECT]', '[REGION]', '[AUTOSCALING_POLICY]')
+            >>>
+            >>> response = client.get_autoscaling_policy(name)
+
+        Args:
+            name (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_autoscaling_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_autoscaling_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_autoscaling_policy,
+                default_retry=self._method_configs["GetAutoscalingPolicy"].retry,
+                default_timeout=self._method_configs["GetAutoscalingPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = autoscaling_policies_pb2.GetAutoscalingPolicyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_autoscaling_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_autoscaling_policies(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists autoscaling policies in the project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_autoscaling_policies(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_autoscaling_policies(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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}``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1beta2.types.AutoscalingPolicy` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_autoscaling_policies" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_autoscaling_policies"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_autoscaling_policies,
+                default_retry=self._method_configs["ListAutoscalingPolicies"].retry,
+                default_timeout=self._method_configs["ListAutoscalingPolicies"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = autoscaling_policies_pb2.ListAutoscalingPoliciesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_autoscaling_policies"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="policies",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_autoscaling_policy(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an autoscaling policy. It is an error to delete an autoscaling
+        policy that is in use by one or more clusters.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+            >>>
+            >>> name = client.autoscaling_policy_path('[PROJECT]', '[REGION]', '[AUTOSCALING_POLICY]')
+            >>>
+            >>> client.delete_autoscaling_policy(name)
+
+        Args:
+            name (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_autoscaling_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_autoscaling_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_autoscaling_policy,
+                default_retry=self._method_configs["DeleteAutoscalingPolicy"].retry,
+                default_timeout=self._method_configs["DeleteAutoscalingPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = autoscaling_policies_pb2.DeleteAutoscalingPolicyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_autoscaling_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/autoscaling_policy_service_client_config.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/autoscaling_policy_service_client_config.py
new file mode 100644
index 000000000000..f41732281d42
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/autoscaling_policy_service_client_config.py
@@ -0,0 +1,48 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1beta2.AutoscalingPolicyService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateAutoscalingPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateAutoscalingPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetAutoscalingPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListAutoscalingPolicies": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteAutoscalingPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/cluster_controller_client.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/cluster_controller_client.py
new file mode 100644
index 000000000000..1c422994b9f5
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/cluster_controller_client.py
@@ -0,0 +1,872 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1beta2 ClusterController API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import grpc
+
+from google.cloud.dataproc_v1beta2.gapic import cluster_controller_client_config
+from google.cloud.dataproc_v1beta2.gapic import enums
+from google.cloud.dataproc_v1beta2.gapic.transports import (
+    cluster_controller_grpc_transport,
+)
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import operations_pb2 as proto_operations_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class ClusterControllerClient(object):
+    """
+    The ClusterControllerService provides methods to manage clusters
+    of Compute Engine instances.
+    """
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1beta2.ClusterController"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ClusterControllerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ClusterControllerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ClusterControllerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cluster_controller_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cluster_controller_grpc_transport.ClusterControllerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cluster_controller_grpc_transport.ClusterControllerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_cluster(
+        self,
+        project_id,
+        region,
+        cluster,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> response = client.create_cluster(project_id, region, cluster)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster (Union[dict, ~google.cloud.dataproc_v1beta2.types.Cluster]): Required. The cluster to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.Cluster`
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``CreateClusterRequest`` requests with the same id, then
+                the second request will be ignored and the first
+                ``google.longrunning.Operation`` created and stored in the backend is
+                returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_cluster,
+                default_retry=self._method_configs["CreateCluster"].retry,
+                default_timeout=self._method_configs["CreateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.CreateClusterRequest(
+            project_id=project_id, region=region, cluster=cluster, request_id=request_id
+        )
+        operation = self._inner_api_calls["create_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            clusters_pb2.Cluster,
+            metadata_type=proto_operations_pb2.ClusterOperationMetadata,
+        )
+
+    def update_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        cluster,
+        update_mask,
+        graceful_decommission_timeout=None,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> # TODO: Initialize `cluster`:
+            >>> cluster = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_cluster(project_id, region, cluster_name, cluster, update_mask)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project the
+                cluster belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            cluster (Union[dict, ~google.cloud.dataproc_v1beta2.types.Cluster]): Required. The changes to the cluster.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.Cluster`
+            update_mask (Union[dict, ~google.cloud.dataproc_v1beta2.types.FieldMask]): Required. Specifies the path, relative to ``Cluster``, of the field to
+                update. For example, to change the number of workers in a cluster to 5,
+                the ``update_mask`` parameter would be specified as
+                ``config.worker_config.num_instances``, and the ``PATCH`` request body
+                would specify the new value, as follows:
+
+                ::
+
+                     {
+                       "config":{
+                         "workerConfig":{
+                           "numInstances":"5"
+                         }
+                       }
+                     }
+
+                Similarly, to change the number of preemptible workers in a cluster to
+                5, the ``update_mask`` parameter would be
+                ``config.secondary_worker_config.num_instances``, and the ``PATCH``
+                request body would be set as follows:
+
+                ::
+
+                     {
+                       "config":{
+                         "secondaryWorkerConfig":{
+                           "numInstances":"5"
+                         }
+                       }
+                     }
+
+                Note: currently only the following fields can be updated:
+
+                .. raw:: html
+
+                    <table>
+                    <tr>
+                    <td><strong>Mask</strong></td><td><strong>Purpose</strong></td>
+                    </tr>
+                    <tr>
+                    <td>labels</td><td>Updates labels</td>
+                    </tr>
+                    <tr>
+                    <td>config.worker_config.num_instances</td><td>Resize primary worker
+                    group</td>
+                    </tr>
+                    <tr>
+                    <td>config.secondary_worker_config.num_instances</td><td>Resize secondary
+                    worker group</td>
+                    </tr>
+                    <tr>
+                    <td>config.lifecycle_config.auto_delete_ttl</td><td>Reset MAX TTL
+                    duration</td>
+                    </tr>
+                    <tr>
+                    <td>config.lifecycle_config.auto_delete_time</td><td>Update MAX TTL
+                    deletion timestamp</td>
+                    </tr>
+                    <tr>
+                    <td>config.lifecycle_config.idle_delete_ttl</td><td>Update Idle TTL
+                    duration</td>
+                    </tr>
+                    <tr>
+                    <td>config.autoscaling_config.policy_uri</td><td>Use, stop using, or change
+                    autoscaling policies</td>
+                    </tr>
+                    </table>
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.FieldMask`
+            graceful_decommission_timeout (Union[dict, ~google.cloud.dataproc_v1beta2.types.Duration]): 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.
+
+                Only supported on Dataproc image versions 1.2 and higher.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.Duration`
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``UpdateClusterRequest`` requests with the same id, then
+                the second request will be ignored and the first
+                ``google.longrunning.Operation`` created and stored in the backend is
+                returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_cluster,
+                default_retry=self._method_configs["UpdateCluster"].retry,
+                default_timeout=self._method_configs["UpdateCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.UpdateClusterRequest(
+            project_id=project_id,
+            region=region,
+            cluster_name=cluster_name,
+            cluster=cluster,
+            update_mask=update_mask,
+            graceful_decommission_timeout=graceful_decommission_timeout,
+            request_id=request_id,
+        )
+        operation = self._inner_api_calls["update_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            clusters_pb2.Cluster,
+            metadata_type=proto_operations_pb2.ClusterOperationMetadata,
+        )
+
+    def delete_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        cluster_uuid=None,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> response = client.delete_cluster(project_id, region, cluster_name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            cluster_uuid (str): Optional. Specifying the ``cluster_uuid`` means the RPC should fail
+                (with error NOT\_FOUND) if cluster with specified UUID does not exist.
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``DeleteClusterRequest`` requests with the same id, then
+                the second request will be ignored and the first
+                ``google.longrunning.Operation`` created and stored in the backend is
+                returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_cluster,
+                default_retry=self._method_configs["DeleteCluster"].retry,
+                default_timeout=self._method_configs["DeleteCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.DeleteClusterRequest(
+            project_id=project_id,
+            region=region,
+            cluster_name=cluster_name,
+            cluster_uuid=cluster_uuid,
+            request_id=request_id,
+        )
+        operation = self._inner_api_calls["delete_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=proto_operations_pb2.ClusterOperationMetadata,
+        )
+
+    def get_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the resource representation for a cluster in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> response = client.get_cluster(project_id, region, cluster_name)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.Cluster` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_cluster,
+                default_retry=self._method_configs["GetCluster"].retry,
+                default_timeout=self._method_configs["GetCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.GetClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        return self._inner_api_calls["get_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_clusters(
+        self,
+        project_id,
+        region,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all regions/{region}/clusters in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_clusters(project_id, region):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_clusters(project_id, region).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            filter_ (str): Optional. A filter constraining the clusters to list. Filters are
+                case-sensitive and have the following syntax:
+
+                field = value [AND [field = value]] ...
+
+                where **field** is one of ``status.state``, ``clusterName``, or
+                ``labels.[KEY]``, and ``[KEY]`` is a label key. **value** can be ``*``
+                to match all values. ``status.state`` can be one of the following:
+                ``ACTIVE``, ``INACTIVE``, ``CREATING``, ``RUNNING``, ``ERROR``,
+                ``DELETING``, or ``UPDATING``. ``ACTIVE`` contains the ``CREATING``,
+                ``UPDATING``, and ``RUNNING`` states. ``INACTIVE`` contains the
+                ``DELETING`` and ``ERROR`` states. ``clusterName`` is the name of the
+                cluster provided at creation time. Only the logical ``AND`` operator is
+                supported; space-separated items are treated as having an implicit
+                ``AND`` operator.
+
+                Example filter:
+
+                status.state = ACTIVE AND clusterName = mycluster AND labels.env =
+                staging AND labels.starred = \*
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1beta2.types.Cluster` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_clusters" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_clusters"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_clusters,
+                default_retry=self._method_configs["ListClusters"].retry,
+                default_timeout=self._method_configs["ListClusters"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.ListClustersRequest(
+            project_id=project_id, region=region, filter=filter_, page_size=page_size
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_clusters"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="clusters",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def diagnose_cluster(
+        self,
+        project_id,
+        region,
+        cluster_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets cluster diagnostic information. After the operation completes, the
+        Operation.response field contains ``DiagnoseClusterOutputLocation``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.ClusterControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `cluster_name`:
+            >>> cluster_name = ''
+            >>>
+            >>> response = client.diagnose_cluster(project_id, region, cluster_name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the cluster
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            cluster_name (str): Required. The cluster name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "diagnose_cluster" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "diagnose_cluster"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.diagnose_cluster,
+                default_retry=self._method_configs["DiagnoseCluster"].retry,
+                default_timeout=self._method_configs["DiagnoseCluster"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = clusters_pb2.DiagnoseClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        operation = self._inner_api_calls["diagnose_cluster"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=clusters_pb2.DiagnoseClusterResults,
+        )
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/cluster_controller_client_config.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/cluster_controller_client_config.py
new file mode 100644
index 000000000000..e551c9299161
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/cluster_controller_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1beta2.ClusterController": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 10000,
+                    "total_timeout_millis": 300000,
+                }
+            },
+            "methods": {
+                "CreateCluster": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateCluster": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteCluster": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListClusters": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DiagnoseCluster": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/enums.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/enums.py
new file mode 100644
index 000000000000..f99be1fed1c7
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/enums.py
@@ -0,0 +1,304 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Component(enum.IntEnum):
+    """
+    Cluster components that can be activated.
+
+    Attributes:
+      COMPONENT_UNSPECIFIED (int): Unspecified component.
+      ANACONDA (int): The Anaconda python distribution.
+      DRUID (int): The Druid query engine.
+      HIVE_WEBHCAT (int): The Hive Web HCatalog (the REST service for accessing HCatalog).
+      JUPYTER (int): The Jupyter Notebook.
+      KERBEROS (int): The Kerberos security feature.
+      PRESTO (int): The Presto query engine.
+      ZEPPELIN (int): The Zeppelin notebook.
+      ZOOKEEPER (int): The Zookeeper service.
+    """
+
+    COMPONENT_UNSPECIFIED = 0
+    ANACONDA = 5
+    DRUID = 9
+    HIVE_WEBHCAT = 3
+    JUPYTER = 1
+    KERBEROS = 7
+    PRESTO = 6
+    ZEPPELIN = 4
+    ZOOKEEPER = 8
+
+
+class ClusterOperationStatus(object):
+    class State(enum.IntEnum):
+        """
+        The operation state.
+
+        Attributes:
+          UNKNOWN (int): Unused.
+          PENDING (int): The operation has been created.
+          RUNNING (int): The operation is running.
+          DONE (int): The operation is done; either cancelled or completed.
+        """
+
+        UNKNOWN = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+
+
+class ClusterStatus(object):
+    class State(enum.IntEnum):
+        """
+        The cluster state.
+
+        Attributes:
+          UNKNOWN (int): The cluster state is unknown.
+          CREATING (int): The cluster is being created and set up. It is not ready for use.
+          RUNNING (int): The cluster is currently running and healthy. It is ready for use.
+          ERROR (int): The cluster encountered an error. It is not ready for use.
+          DELETING (int): The cluster is being deleted. It cannot be used.
+          UPDATING (int): The cluster is being updated. It continues to accept and process jobs.
+        """
+
+        UNKNOWN = 0
+        CREATING = 1
+        RUNNING = 2
+        ERROR = 3
+        DELETING = 4
+        UPDATING = 5
+
+    class Substate(enum.IntEnum):
+        """
+        The cluster substate.
+
+        Attributes:
+          UNSPECIFIED (int): The cluster substate is unknown.
+          UNHEALTHY (int): The cluster is known to be in an unhealthy state
+          (for example, critical daemons are not running or HDFS capacity is
+          exhausted).
+
+          Applies to RUNNING state.
+          STALE_STATUS (int): The agent-reported status is out of date (may occur if
+          Cloud Dataproc loses communication with Agent).
+
+          Applies to RUNNING state.
+        """
+
+        UNSPECIFIED = 0
+        UNHEALTHY = 1
+        STALE_STATUS = 2
+
+
+class JobStatus(object):
+    class State(enum.IntEnum):
+        """
+        The job state.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): The job state is unknown.
+          PENDING (int): The job is pending; it has been submitted, but is not yet running.
+          SETUP_DONE (int): Job has been received by the service and completed initial setup;
+          it will soon be submitted to the cluster.
+          RUNNING (int): The job is running on the cluster.
+          CANCEL_PENDING (int): A CancelJob request has been received, but is pending.
+          CANCEL_STARTED (int): Transient in-flight resources have been canceled, and the request to
+          cancel the running job has been issued to the cluster.
+          CANCELLED (int): The job cancellation was successful.
+          DONE (int): The job has completed successfully.
+          ERROR (int): The job has completed, but encountered an error.
+          ATTEMPT_FAILURE (int): Job attempt has failed. The detail field contains failure details for
+          this attempt.
+
+          Applies to restartable jobs only.
+        """
+
+        STATE_UNSPECIFIED = 0
+        PENDING = 1
+        SETUP_DONE = 8
+        RUNNING = 2
+        CANCEL_PENDING = 3
+        CANCEL_STARTED = 7
+        CANCELLED = 4
+        DONE = 5
+        ERROR = 6
+        ATTEMPT_FAILURE = 9
+
+    class Substate(enum.IntEnum):
+        """
+        The job substate.
+
+        Attributes:
+          UNSPECIFIED (int): The job substate is unknown.
+          SUBMITTED (int): The Job is submitted to the agent.
+
+          Applies to RUNNING state.
+          QUEUED (int): The Job has been received and is awaiting execution (it may be waiting
+          for a condition to be met). See the "details" field for the reason for
+          the delay.
+
+          Applies to RUNNING state.
+          STALE_STATUS (int): 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
+          agent does not send a timely update, the job will fail.
+
+          Applies to RUNNING state.
+        """
+
+        UNSPECIFIED = 0
+        SUBMITTED = 1
+        QUEUED = 2
+        STALE_STATUS = 3
+
+
+class ListJobsRequest(object):
+    class JobStateMatcher(enum.IntEnum):
+        """
+        A matcher that specifies categories of job states.
+
+        Attributes:
+          ALL (int): Match all jobs, regardless of state.
+          ACTIVE (int): Only match jobs in non-terminal states: PENDING, RUNNING, or
+          CANCEL\_PENDING.
+          NON_ACTIVE (int): Only match jobs in terminal states: CANCELLED, DONE, or ERROR.
+        """
+
+        ALL = 0
+        ACTIVE = 1
+        NON_ACTIVE = 2
+
+
+class LoggingConfig(object):
+    class Level(enum.IntEnum):
+        """
+        The Log4j level for job execution. When running an `Apache
+        Hive <http://hive.apache.org/>`__ job, Cloud Dataproc configures the
+        Hive client to an equivalent verbosity level.
+
+        Attributes:
+          LEVEL_UNSPECIFIED (int): Level is unspecified. Use default level for log4j.
+          ALL (int): Use ALL level for log4j.
+          TRACE (int): Use TRACE level for log4j.
+          DEBUG (int): Use DEBUG level for log4j.
+          INFO (int): Use INFO level for log4j.
+          WARN (int): Use WARN level for log4j.
+          ERROR (int): Use ERROR level for log4j.
+          FATAL (int): Use FATAL level for log4j.
+          OFF (int): Turn off log4j.
+        """
+
+        LEVEL_UNSPECIFIED = 0
+        ALL = 1
+        TRACE = 2
+        DEBUG = 3
+        INFO = 4
+        WARN = 5
+        ERROR = 6
+        FATAL = 7
+        OFF = 8
+
+
+class ReservationAffinity(object):
+    class Type(enum.IntEnum):
+        """
+        Indicates whether to consume capacity from an reservation or not.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int)
+          NO_RESERVATION (int): Do not consume from any allocated capacity.
+          ANY_RESERVATION (int): Consume any reservation available.
+          SPECIFIC_RESERVATION (int): Must consume from a specific reservation. Must specify key value fields
+          for specifying the reservations.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        NO_RESERVATION = 1
+        ANY_RESERVATION = 2
+        SPECIFIC_RESERVATION = 3
+
+
+class WorkflowMetadata(object):
+    class State(enum.IntEnum):
+        """
+        The operation state.
+
+        Attributes:
+          UNKNOWN (int): Unused.
+          PENDING (int): The operation has been created.
+          RUNNING (int): The operation is running.
+          DONE (int): The operation is done; either cancelled or completed.
+        """
+
+        UNKNOWN = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+
+
+class WorkflowNode(object):
+    class NodeState(enum.IntEnum):
+        """
+        The workflow node state.
+
+        Attributes:
+          NODE_STATUS_UNSPECIFIED (int): State is unspecified.
+          BLOCKED (int): The node is awaiting prerequisite node to finish.
+          RUNNABLE (int): The node is runnable but not running.
+          RUNNING (int): The node is running.
+          COMPLETED (int): The node completed successfully.
+          FAILED (int): The node failed. A node can be marked FAILED because
+          its ancestor or peer failed.
+        """
+
+        NODE_STATUS_UNSPECIFIED = 0
+        BLOCKED = 1
+        RUNNABLE = 2
+        RUNNING = 3
+        COMPLETED = 4
+        FAILED = 5
+
+
+class YarnApplication(object):
+    class State(enum.IntEnum):
+        """
+        The application state, corresponding to
+        <code>YarnProtos.YarnApplicationStateProto</code>.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Status is unspecified.
+          NEW (int): Status is NEW.
+          NEW_SAVING (int): Status is NEW\_SAVING.
+          SUBMITTED (int): Status is SUBMITTED.
+          ACCEPTED (int): Status is ACCEPTED.
+          RUNNING (int): Status is RUNNING.
+          FINISHED (int): Status is FINISHED.
+          FAILED (int): Status is FAILED.
+          KILLED (int): Status is KILLED.
+        """
+
+        STATE_UNSPECIFIED = 0
+        NEW = 1
+        NEW_SAVING = 2
+        SUBMITTED = 3
+        ACCEPTED = 4
+        RUNNING = 5
+        FINISHED = 6
+        FAILED = 7
+        KILLED = 8
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/job_controller_client.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/job_controller_client.py
new file mode 100644
index 000000000000..22c84bbcb456
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/job_controller_client.py
@@ -0,0 +1,707 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1beta2 JobController API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import grpc
+
+from google.cloud.dataproc_v1beta2.gapic import enums
+from google.cloud.dataproc_v1beta2.gapic import job_controller_client_config
+from google.cloud.dataproc_v1beta2.gapic.transports import job_controller_grpc_transport
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import operations_pb2 as proto_operations_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class JobControllerClient(object):
+    """The JobController provides methods to manage jobs."""
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1beta2.JobController"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            JobControllerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.JobControllerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.JobControllerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = job_controller_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=job_controller_grpc_transport.JobControllerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = job_controller_grpc_transport.JobControllerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def submit_job(
+        self,
+        project_id,
+        region,
+        job,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Submits a job to a cluster.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.submit_job(project_id, region, job)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job (Union[dict, ~google.cloud.dataproc_v1beta2.types.Job]): Required. The job resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.Job`
+            request_id (str): Optional. A unique id used to identify the request. If the server
+                receives two ``SubmitJobRequest`` requests with the same id, then the
+                second request will be ignored and the first ``Job`` created and stored
+                in the backend is returned.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "submit_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "submit_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.submit_job,
+                default_retry=self._method_configs["SubmitJob"].retry,
+                default_timeout=self._method_configs["SubmitJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.SubmitJobRequest(
+            project_id=project_id, region=region, job=job, request_id=request_id
+        )
+        return self._inner_api_calls["submit_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the resource representation for a job in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> response = client.get_job(project_id, region, job_id)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_job,
+                default_retry=self._method_configs["GetJob"].retry,
+                default_timeout=self._method_configs["GetJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.GetJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        return self._inner_api_calls["get_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_jobs(
+        self,
+        project_id,
+        region,
+        page_size=None,
+        cluster_name=None,
+        job_state_matcher=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists regions/{region}/jobs in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_jobs(project_id, region):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_jobs(project_id, region).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            cluster_name (str): Optional. If set, the returned jobs list includes only jobs that were
+                submitted to the named cluster.
+            job_state_matcher (~google.cloud.dataproc_v1beta2.types.JobStateMatcher): Optional. Specifies enumerated categories of jobs to list. (default =
+                match ALL jobs).
+
+                If ``filter`` is provided, ``jobStateMatcher`` will be ignored.
+            filter_ (str): Optional. A filter constraining the jobs to list. Filters are
+                case-sensitive and have the following syntax:
+
+                [field = value] AND [field [= value]] ...
+
+                where **field** is ``status.state`` or ``labels.[KEY]``, and ``[KEY]``
+                is a label key. **value** can be ``*`` to match all values.
+                ``status.state`` can be either ``ACTIVE`` or ``NON_ACTIVE``. Only the
+                logical ``AND`` operator is supported; space-separated items are treated
+                as having an implicit ``AND`` operator.
+
+                Example filter:
+
+                status.state = ACTIVE AND labels.env = staging AND labels.starred = \*
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1beta2.types.Job` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_jobs,
+                default_retry=self._method_configs["ListJobs"].retry,
+                default_timeout=self._method_configs["ListJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.ListJobsRequest(
+            project_id=project_id,
+            region=region,
+            page_size=page_size,
+            cluster_name=cluster_name,
+            job_state_matcher=job_state_matcher,
+            filter=filter_,
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        job,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a job in a project.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_job(project_id, region, job_id, job, update_mask)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            job (Union[dict, ~google.cloud.dataproc_v1beta2.types.Job]): Required. The changes to the job.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.Job`
+            update_mask (Union[dict, ~google.cloud.dataproc_v1beta2.types.FieldMask]): Required. Specifies the path, relative to Job, of the field to update.
+                For example, to update the labels of a Job the update\_mask parameter
+                would be specified as labels, and the ``PATCH`` request body would
+                specify the new value. Note: Currently, labels is the only field that
+                can be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_job,
+                default_retry=self._method_configs["UpdateJob"].retry,
+                default_timeout=self._method_configs["UpdateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.UpdateJobRequest(
+            project_id=project_id,
+            region=region,
+            job_id=job_id,
+            job=job,
+            update_mask=update_mask,
+        )
+        return self._inner_api_calls["update_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a job cancellation request. To access the job resource after
+        cancellation, call
+        `regions/{region}/jobs.list <https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/list>`__
+        or
+        `regions/{region}/jobs.get <https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/get>`__.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> response = client.cancel_job(project_id, region, job_id)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_job,
+                default_retry=self._method_configs["CancelJob"].retry,
+                default_timeout=self._method_configs["CancelJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.CancelJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        return self._inner_api_calls["cancel_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_job(
+        self,
+        project_id,
+        region,
+        job_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the job from the project. If the job is active, the delete
+        fails, and the response returns ``FAILED_PRECONDITION``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.JobControllerClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `region`:
+            >>> region = ''
+            >>>
+            >>> # TODO: Initialize `job_id`:
+            >>> job_id = ''
+            >>>
+            >>> client.delete_job(project_id, region, job_id)
+
+        Args:
+            project_id (str): Required. The ID of the Google Cloud Platform project that the job
+                belongs to.
+            region (str): Required. The Cloud Dataproc region in which to handle the request.
+            job_id (str): Required. The job ID.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_job,
+                default_retry=self._method_configs["DeleteJob"].retry,
+                default_timeout=self._method_configs["DeleteJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = jobs_pb2.DeleteJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        self._inner_api_calls["delete_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/job_controller_client_config.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/job_controller_client_config.py
new file mode 100644
index 000000000000..9bacf1251078
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/job_controller_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1beta2.JobController": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 30000,
+                    "total_timeout_millis": 900000,
+                }
+            },
+            "methods": {
+                "SubmitJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListJobs": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/__init__.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/autoscaling_policy_service_grpc_transport.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/autoscaling_policy_service_grpc_transport.py
new file mode 100644
index 000000000000..ff40b5b2d361
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/autoscaling_policy_service_grpc_transport.py
@@ -0,0 +1,179 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2_grpc
+
+
+class AutoscalingPolicyServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1beta2 AutoscalingPolicyService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "autoscaling_policy_service_stub": autoscaling_policies_pb2_grpc.AutoscalingPolicyServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_autoscaling_policy(self):
+        """Return the gRPC stub for :meth:`AutoscalingPolicyServiceClient.create_autoscaling_policy`.
+
+        Creates new autoscaling policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["autoscaling_policy_service_stub"].CreateAutoscalingPolicy
+
+    @property
+    def update_autoscaling_policy(self):
+        """Return the gRPC stub for :meth:`AutoscalingPolicyServiceClient.update_autoscaling_policy`.
+
+        Updates (replaces) autoscaling policy.
+
+        Disabled check for update\_mask, because all updates will be full
+        replacements.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["autoscaling_policy_service_stub"].UpdateAutoscalingPolicy
+
+    @property
+    def get_autoscaling_policy(self):
+        """Return the gRPC stub for :meth:`AutoscalingPolicyServiceClient.get_autoscaling_policy`.
+
+        Retrieves autoscaling policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["autoscaling_policy_service_stub"].GetAutoscalingPolicy
+
+    @property
+    def list_autoscaling_policies(self):
+        """Return the gRPC stub for :meth:`AutoscalingPolicyServiceClient.list_autoscaling_policies`.
+
+        Lists autoscaling policies in the project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["autoscaling_policy_service_stub"].ListAutoscalingPolicies
+
+    @property
+    def delete_autoscaling_policy(self):
+        """Return the gRPC stub for :meth:`AutoscalingPolicyServiceClient.delete_autoscaling_policy`.
+
+        Deletes an autoscaling policy. It is an error to delete an autoscaling
+        policy that is in use by one or more clusters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["autoscaling_policy_service_stub"].DeleteAutoscalingPolicy
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/cluster_controller_grpc_transport.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/cluster_controller_grpc_transport.py
new file mode 100644
index 000000000000..72cee7d4b47b
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/cluster_controller_grpc_transport.py
@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2_grpc
+
+
+class ClusterControllerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1beta2 ClusterController API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "cluster_controller_stub": clusters_pb2_grpc.ClusterControllerStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.create_cluster`.
+
+        Creates a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].CreateCluster
+
+    @property
+    def update_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.update_cluster`.
+
+        Updates a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].UpdateCluster
+
+    @property
+    def delete_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.delete_cluster`.
+
+        Deletes a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].DeleteCluster
+
+    @property
+    def get_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.get_cluster`.
+
+        Gets the resource representation for a cluster in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].GetCluster
+
+    @property
+    def list_clusters(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.list_clusters`.
+
+        Lists all regions/{region}/clusters in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].ListClusters
+
+    @property
+    def diagnose_cluster(self):
+        """Return the gRPC stub for :meth:`ClusterControllerClient.diagnose_cluster`.
+
+        Gets cluster diagnostic information. After the operation completes, the
+        Operation.response field contains ``DiagnoseClusterOutputLocation``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cluster_controller_stub"].DiagnoseCluster
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/job_controller_grpc_transport.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/job_controller_grpc_transport.py
new file mode 100644
index 000000000000..f906f9cf1e43
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/job_controller_grpc_transport.py
@@ -0,0 +1,189 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2_grpc
+
+
+class JobControllerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1beta2 JobController API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"job_controller_stub": jobs_pb2_grpc.JobControllerStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def submit_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.submit_job`.
+
+        Submits a job to a cluster.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].SubmitJob
+
+    @property
+    def get_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.get_job`.
+
+        Gets the resource representation for a job in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].GetJob
+
+    @property
+    def list_jobs(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.list_jobs`.
+
+        Lists regions/{region}/jobs in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].ListJobs
+
+    @property
+    def update_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.update_job`.
+
+        Updates a job in a project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].UpdateJob
+
+    @property
+    def cancel_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.cancel_job`.
+
+        Starts a job cancellation request. To access the job resource after
+        cancellation, call
+        `regions/{region}/jobs.list <https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/list>`__
+        or
+        `regions/{region}/jobs.get <https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/get>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].CancelJob
+
+    @property
+    def delete_job(self):
+        """Return the gRPC stub for :meth:`JobControllerClient.delete_job`.
+
+        Deletes the job from the project. If the job is active, the delete
+        fails, and the response returns ``FAILED_PRECONDITION``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_controller_stub"].DeleteJob
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/workflow_template_service_grpc_transport.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/workflow_template_service_grpc_transport.py
new file mode 100644
index 000000000000..86bc98b33810
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/transports/workflow_template_service_grpc_transport.py
@@ -0,0 +1,243 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.dataproc_v1beta2.proto import workflow_templates_pb2_grpc
+
+
+class WorkflowTemplateServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.dataproc.v1beta2 WorkflowTemplateService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dataproc.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "workflow_template_service_stub": workflow_templates_pb2_grpc.WorkflowTemplateServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="dataproc.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.create_workflow_template`.
+
+        Creates new workflow template.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].CreateWorkflowTemplate
+
+    @property
+    def get_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.get_workflow_template`.
+
+        Retrieves the latest workflow template.
+
+        Can retrieve previously instantiated template by specifying optional
+        version parameter.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].GetWorkflowTemplate
+
+    @property
+    def instantiate_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.instantiate_workflow_template`.
+
+        Instantiates a template and begins execution.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].InstantiateWorkflowTemplate
+
+    @property
+    def instantiate_inline_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.instantiate_inline_workflow_template`.
+
+        Instantiates a template and begins execution.
+
+        This method is equivalent to executing the sequence
+        ``CreateWorkflowTemplate``, ``InstantiateWorkflowTemplate``,
+        ``DeleteWorkflowTemplate``.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "workflow_template_service_stub"
+        ].InstantiateInlineWorkflowTemplate
+
+    @property
+    def update_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.update_workflow_template`.
+
+        Updates (replaces) workflow template. The updated template
+        must contain version that matches the current server version.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].UpdateWorkflowTemplate
+
+    @property
+    def list_workflow_templates(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.list_workflow_templates`.
+
+        Lists workflows that match the specified filter in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].ListWorkflowTemplates
+
+    @property
+    def delete_workflow_template(self):
+        """Return the gRPC stub for :meth:`WorkflowTemplateServiceClient.delete_workflow_template`.
+
+        Deletes a workflow template. It does not cancel in-progress workflows.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["workflow_template_service_stub"].DeleteWorkflowTemplate
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/workflow_template_service_client.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/workflow_template_service_client.py
new file mode 100644
index 000000000000..f7ad32daf927
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/workflow_template_service_client.py
@@ -0,0 +1,898 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.dataproc.v1beta2 WorkflowTemplateService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.dataproc_v1beta2.gapic import enums
+from google.cloud.dataproc_v1beta2.gapic import workflow_template_service_client_config
+from google.cloud.dataproc_v1beta2.gapic.transports import (
+    workflow_template_service_grpc_transport,
+)
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2_grpc
+from google.cloud.dataproc_v1beta2.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.dataproc_v1beta2.proto import workflow_templates_pb2
+from google.cloud.dataproc_v1beta2.proto import workflow_templates_pb2_grpc
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dataproc").version
+
+
+class WorkflowTemplateServiceClient(object):
+    """
+    The API interface for managing Workflow Templates in the
+    Cloud Dataproc API.
+    """
+
+    SERVICE_ADDRESS = "dataproc.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.dataproc.v1beta2.WorkflowTemplateService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            WorkflowTemplateServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def region_path(cls, project, region):
+        """Return a fully-qualified region string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/regions/{region}", project=project, region=region
+        )
+
+    @classmethod
+    def workflow_template_path(cls, project, region, workflow_template):
+        """Return a fully-qualified workflow_template string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/regions/{region}/workflowTemplates/{workflow_template}",
+            project=project,
+            region=region,
+            workflow_template=workflow_template,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.WorkflowTemplateServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.WorkflowTemplateServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = workflow_template_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=workflow_template_service_grpc_transport.WorkflowTemplateServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = workflow_template_service_grpc_transport.WorkflowTemplateServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_workflow_template(
+        self,
+        parent,
+        template,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates new workflow template.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # TODO: Initialize `template`:
+            >>> template = {}
+            >>>
+            >>> response = client.create_workflow_template(parent, template)
+
+        Args:
+            parent (str): 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}``
+            template (Union[dict, ~google.cloud.dataproc_v1beta2.types.WorkflowTemplate]): Required. The Dataproc workflow template to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_workflow_template,
+                default_retry=self._method_configs["CreateWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["CreateWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.CreateWorkflowTemplateRequest(
+            parent=parent, template=template
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_workflow_template(
+        self,
+        name,
+        version=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves the latest workflow template.
+
+        Can retrieve previously instantiated template by specifying optional
+        version parameter.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> name = client.workflow_template_path('[PROJECT]', '[REGION]', '[WORKFLOW_TEMPLATE]')
+            >>>
+            >>> response = client.get_workflow_template(name)
+
+        Args:
+            name (str): 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}``
+            version (int): Optional. The version of workflow template to retrieve. Only previously
+                instatiated versions can be retrieved.
+
+                If unspecified, retrieves the current version.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_workflow_template,
+                default_retry=self._method_configs["GetWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["GetWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.GetWorkflowTemplateRequest(
+            name=name, version=version
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def instantiate_workflow_template(
+        self,
+        name,
+        version=None,
+        instance_id=None,
+        request_id=None,
+        parameters=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Instantiates a template and begins execution.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> name = client.workflow_template_path('[PROJECT]', '[REGION]', '[WORKFLOW_TEMPLATE]')
+            >>>
+            >>> response = client.instantiate_workflow_template(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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}``
+            version (int): Optional. The version of workflow template to instantiate. If specified,
+                the workflow will be instantiated only if the current version of
+                the workflow template has the supplied version.
+
+                This option cannot be used to instantiate a previous version of
+                workflow template.
+            instance_id (str): Deprecated. Please use ``request_id`` field instead.
+            request_id (str): Optional. A tag that prevents multiple concurrent workflow instances
+                with the same tag from running. This mitigates risk of concurrent
+                instances started due to retries.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The tag must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            parameters (dict[str -> str]): Optional. Map from parameter names to values that should be used for those
+                parameters. Values may not exceed 100 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "instantiate_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "instantiate_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.instantiate_workflow_template,
+                default_retry=self._method_configs["InstantiateWorkflowTemplate"].retry,
+                default_timeout=self._method_configs[
+                    "InstantiateWorkflowTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.InstantiateWorkflowTemplateRequest(
+            name=name,
+            version=version,
+            instance_id=instance_id,
+            request_id=request_id,
+            parameters=parameters,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["instantiate_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=workflow_templates_pb2.WorkflowMetadata,
+        )
+
+    def instantiate_inline_workflow_template(
+        self,
+        parent,
+        template,
+        instance_id=None,
+        request_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Instantiates a template and begins execution.
+
+        This method is equivalent to executing the sequence
+        ``CreateWorkflowTemplate``, ``InstantiateWorkflowTemplate``,
+        ``DeleteWorkflowTemplate``.
+
+        The returned Operation can be used to track execution of workflow by
+        polling ``operations.get``. The Operation will complete when entire
+        workflow is finished.
+
+        The running workflow can be aborted via ``operations.cancel``. This will
+        cause any inflight jobs to be cancelled and workflow-owned clusters to
+        be deleted.
+
+        The ``Operation.metadata`` will be ``WorkflowMetadata``.
+
+        On successful completion, ``Operation.response`` will be ``Empty``.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # TODO: Initialize `template`:
+            >>> template = {}
+            >>>
+            >>> response = client.instantiate_inline_workflow_template(parent, template)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): 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}``
+            template (Union[dict, ~google.cloud.dataproc_v1beta2.types.WorkflowTemplate]): Required. The workflow template to instantiate.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate`
+            instance_id (str): Deprecated. Please use ``request_id`` field instead.
+            request_id (str): Optional. A tag that prevents multiple concurrent workflow instances
+                with the same tag from running. This mitigates risk of concurrent
+                instances started due to retries.
+
+                It is recommended to always set this value to a
+                `UUID <https://en.wikipedia.org/wiki/Universally_unique_identifier>`__.
+
+                The tag must contain only letters (a-z, A-Z), numbers (0-9), underscores
+                (\_), and hyphens (-). The maximum length is 40 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "instantiate_inline_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "instantiate_inline_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.instantiate_inline_workflow_template,
+                default_retry=self._method_configs[
+                    "InstantiateInlineWorkflowTemplate"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "InstantiateInlineWorkflowTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.InstantiateInlineWorkflowTemplateRequest(
+            parent=parent,
+            template=template,
+            instance_id=instance_id,
+            request_id=request_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["instantiate_inline_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=workflow_templates_pb2.WorkflowMetadata,
+        )
+
+    def update_workflow_template(
+        self,
+        template,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates (replaces) workflow template. The updated template
+        must contain version that matches the current server version.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> # TODO: Initialize `template`:
+            >>> template = {}
+            >>>
+            >>> response = client.update_workflow_template(template)
+
+        Args:
+            template (Union[dict, ~google.cloud.dataproc_v1beta2.types.WorkflowTemplate]): Required. The updated workflow template.
+
+                The ``template.version`` field must match the current version.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_workflow_template,
+                default_retry=self._method_configs["UpdateWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["UpdateWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.UpdateWorkflowTemplateRequest(
+            template=template
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("template.name", template.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_workflow_templates(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists workflows that match the specified filter in the request.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> parent = client.region_path('[PROJECT]', '[REGION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_workflow_templates(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_workflow_templates(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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}``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dataproc_v1beta2.types.WorkflowTemplate` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_workflow_templates" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_workflow_templates"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_workflow_templates,
+                default_retry=self._method_configs["ListWorkflowTemplates"].retry,
+                default_timeout=self._method_configs["ListWorkflowTemplates"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.ListWorkflowTemplatesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_workflow_templates"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="templates",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_workflow_template(
+        self,
+        name,
+        version=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a workflow template. It does not cancel in-progress workflows.
+
+        Example:
+            >>> from google.cloud import dataproc_v1beta2
+            >>>
+            >>> client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+            >>>
+            >>> name = client.workflow_template_path('[PROJECT]', '[REGION]', '[WORKFLOW_TEMPLATE]')
+            >>>
+            >>> client.delete_workflow_template(name)
+
+        Args:
+            name (str): 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}``
+            version (int): Optional. The version of workflow template to delete. If specified,
+                will only delete the template if the current server version matches
+                specified version.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_workflow_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_workflow_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_workflow_template,
+                default_retry=self._method_configs["DeleteWorkflowTemplate"].retry,
+                default_timeout=self._method_configs["DeleteWorkflowTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = workflow_templates_pb2.DeleteWorkflowTemplateRequest(
+            name=name, version=version
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_workflow_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/dataproc/google/cloud/dataproc_v1beta2/gapic/workflow_template_service_client_config.py b/dataproc/google/cloud/dataproc_v1beta2/gapic/workflow_template_service_client_config.py
new file mode 100644
index 000000000000..75aad0b5f8bf
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/gapic/workflow_template_service_client_config.py
@@ -0,0 +1,58 @@
+config = {
+    "interfaces": {
+        "google.cloud.dataproc.v1beta2.WorkflowTemplateService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateWorkflowTemplate": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "InstantiateWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "InstantiateInlineWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListWorkflowTemplates": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteWorkflowTemplate": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/__init__.py b/dataproc/google/cloud/dataproc_v1beta2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies.proto b/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies.proto
new file mode 100644
index 000000000000..0c3efbd067ae
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies.proto
@@ -0,0 +1,276 @@
+// 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.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/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";
+
+// The API interface for managing autoscaling policies in the
+// Google Cloud Dataproc API.
+service AutoscalingPolicyService {
+  // Creates new autoscaling policy.
+  rpc CreateAutoscalingPolicy(CreateAutoscalingPolicyRequest) returns (AutoscalingPolicy) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/locations/*}/autoscalingPolicies"
+      body: "policy"
+      additional_bindings {
+        post: "/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies"
+        body: "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: "/v1beta2/{policy.name=projects/*/locations/*/autoscalingPolicies/*}"
+      body: "policy"
+      additional_bindings {
+        put: "/v1beta2/{policy.name=projects/*/regions/*/autoscalingPolicies/*}"
+        body: "policy"
+      }
+    };
+  }
+
+  // Retrieves autoscaling policy.
+  rpc GetAutoscalingPolicy(GetAutoscalingPolicyRequest) returns (AutoscalingPolicy) {
+    option (google.api.http) = {
+      get: "/v1beta2/{name=projects/*/locations/*/autoscalingPolicies/*}"
+      additional_bindings {
+        get: "/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}"
+      }
+    };
+  }
+
+  // Lists autoscaling policies in the project.
+  rpc ListAutoscalingPolicies(ListAutoscalingPoliciesRequest) returns (ListAutoscalingPoliciesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta2/{parent=projects/*/locations/*}/autoscalingPolicies"
+      additional_bindings {
+        get: "/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies"
+      }
+    };
+  }
+
+  // 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: "/v1beta2/{name=projects/*/locations/*/autoscalingPolicies/*}"
+      additional_bindings {
+        delete: "/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}"
+      }
+    };
+  }
+}
+
+// Describes an autoscaling policy for Dataproc cluster autoscaler.
+message AutoscalingPolicy {
+  // 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 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;
+
+  // Required. Autoscaling algorithm for policy.
+  oneof algorithm {
+    BasicAutoscalingAlgorithm basic_algorithm = 3;
+  }
+
+  // Required. Describes how the autoscaler will operate for primary workers.
+  InstanceGroupAutoscalingPolicyConfig worker_config = 4;
+
+  // Optional. Describes how the autoscaler will operate for secondary workers.
+  InstanceGroupAutoscalingPolicyConfig secondary_worker_config = 5;
+}
+
+// Basic algorithm for autoscaling.
+message BasicAutoscalingAlgorithm {
+  // Required. YARN autoscaling configuration.
+  BasicYarnAutoscalingConfig yarn_config = 1;
+
+  // 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;
+}
+
+// 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;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+}
+
+// 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;
+
+  // Optional. 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, ). Required.
+  // Secondary workers - Bounds: [min_instances, ). Default: 0.
+  int32 max_instances = 2;
+
+  // 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;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// A request to update an autoscaling policy.
+message UpdateAutoscalingPolicyRequest {
+  // Required. The updated autoscaling policy.
+  AutoscalingPolicy policy = 1;
+}
+
+// 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 of the form
+  // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`.
+  string name = 1;
+}
+
+// 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;
+
+  // Optional. The maximum number of results to return in each response.
+  int32 page_size = 2;
+
+  // Optional. The page token, returned by a previous call, to request the
+  // next page of results.
+  string page_token = 3;
+}
+
+// A response to a request to list autoscaling policies in a project.
+message ListAutoscalingPoliciesResponse {
+  // Output only. Autoscaling policies list.
+  repeated AutoscalingPolicy policies = 1;
+
+  // Output only. This token is included in the response if there are more
+  // results to fetch.
+  string next_page_token = 2;
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies_pb2.py b/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies_pb2.py
new file mode 100644
index 000000000000..880fe573d879
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies_pb2.py
@@ -0,0 +1,1146 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1beta2/proto/autoscaling_policies.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.dataproc_v1beta2.proto import (
+    clusters_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2,
+)
+from google.cloud.dataproc_v1beta2.proto import (
+    jobs_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1beta2/proto/autoscaling_policies.proto",
+    package="google.cloud.dataproc.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.dataproc.v1beta2B\030AutoscalingPoliciesProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n>google/cloud/dataproc_v1beta2/proto/autoscaling_policies.proto\x12\x1dgoogle.cloud.dataproc.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/dataproc_v1beta2/proto/clusters.proto\x1a.google/cloud/dataproc_v1beta2/proto/jobs.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xd1\x02\n\x11\x41utoscalingPolicy\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12S\n\x0f\x62\x61sic_algorithm\x18\x03 \x01(\x0b\x32\x38.google.cloud.dataproc.v1beta2.BasicAutoscalingAlgorithmH\x00\x12Z\n\rworker_config\x18\x04 \x01(\x0b\x32\x43.google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfig\x12\x64\n\x17secondary_worker_config\x18\x05 \x01(\x0b\x32\x43.google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfigB\x0b\n\talgorithm"\x9f\x01\n\x19\x42\x61sicAutoscalingAlgorithm\x12N\n\x0byarn_config\x18\x01 \x01(\x0b\x32\x39.google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig\x12\x32\n\x0f\x63ooldown_period\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xe0\x01\n\x1a\x42\x61sicYarnAutoscalingConfig\x12@\n\x1dgraceful_decommission_timeout\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x17\n\x0fscale_up_factor\x18\x01 \x01(\x01\x12\x19\n\x11scale_down_factor\x18\x02 \x01(\x01\x12$\n\x1cscale_up_min_worker_fraction\x18\x03 \x01(\x01\x12&\n\x1escale_down_min_worker_fraction\x18\x04 \x01(\x01"d\n$InstanceGroupAutoscalingPolicyConfig\x12\x15\n\rmin_instances\x18\x01 \x01(\x05\x12\x15\n\rmax_instances\x18\x02 \x01(\x05\x12\x0e\n\x06weight\x18\x03 \x01(\x05"r\n\x1e\x43reateAutoscalingPolicyRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12@\n\x06policy\x18\x02 \x01(\x0b\x32\x30.google.cloud.dataproc.v1beta2.AutoscalingPolicy"+\n\x1bGetAutoscalingPolicyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"b\n\x1eUpdateAutoscalingPolicyRequest\x12@\n\x06policy\x18\x01 \x01(\x0b\x32\x30.google.cloud.dataproc.v1beta2.AutoscalingPolicy".\n\x1e\x44\x65leteAutoscalingPolicyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"W\n\x1eListAutoscalingPoliciesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"~\n\x1fListAutoscalingPoliciesResponse\x12\x42\n\x08policies\x18\x01 \x03(\x0b\x32\x30.google.cloud.dataproc.v1beta2.AutoscalingPolicy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\x92\x0b\n\x18\x41utoscalingPolicyService\x12\xa0\x02\n\x17\x43reateAutoscalingPolicy\x12=.google.cloud.dataproc.v1beta2.CreateAutoscalingPolicyRequest\x1a\x30.google.cloud.dataproc.v1beta2.AutoscalingPolicy"\x93\x01\x82\xd3\xe4\x93\x02\x8c\x01"</v1beta2/{parent=projects/*/locations/*}/autoscalingPolicies:\x06policyZD":/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies:\x06policy\x12\xae\x02\n\x17UpdateAutoscalingPolicy\x12=.google.cloud.dataproc.v1beta2.UpdateAutoscalingPolicyRequest\x1a\x30.google.cloud.dataproc.v1beta2.AutoscalingPolicy"\xa1\x01\x82\xd3\xe4\x93\x02\x9a\x01\x1a\x43/v1beta2/{policy.name=projects/*/locations/*/autoscalingPolicies/*}:\x06policyZK\x1a\x41/v1beta2/{policy.name=projects/*/regions/*/autoscalingPolicies/*}:\x06policy\x12\x89\x02\n\x14GetAutoscalingPolicy\x12:.google.cloud.dataproc.v1beta2.GetAutoscalingPolicyRequest\x1a\x30.google.cloud.dataproc.v1beta2.AutoscalingPolicy"\x82\x01\x82\xd3\xe4\x93\x02|\x12</v1beta2/{name=projects/*/locations/*/autoscalingPolicies/*}Z<\x12:/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}\x12\x9d\x02\n\x17ListAutoscalingPolicies\x12=.google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesRequest\x1a>.google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesResponse"\x82\x01\x82\xd3\xe4\x93\x02|\x12</v1beta2/{parent=projects/*/locations/*}/autoscalingPoliciesZ<\x12:/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies\x12\xf5\x01\n\x17\x44\x65leteAutoscalingPolicy\x12=.google.cloud.dataproc.v1beta2.DeleteAutoscalingPolicyRequest\x1a\x16.google.protobuf.Empty"\x82\x01\x82\xd3\xe4\x93\x02|*</v1beta2/{name=projects/*/locations/*/autoscalingPolicies/*}Z<*:/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}B\x86\x01\n!com.google.cloud.dataproc.v1beta2B\x18\x41utoscalingPoliciesProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_AUTOSCALINGPOLICY = _descriptor.Descriptor(
+    name="AutoscalingPolicy",
+    full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy.id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="basic_algorithm",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy.basic_algorithm",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="worker_config",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy.worker_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="secondary_worker_config",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy.secondary_worker_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="algorithm",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicy.algorithm",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=359,
+    serialized_end=696,
+)
+
+
+_BASICAUTOSCALINGALGORITHM = _descriptor.Descriptor(
+    name="BasicAutoscalingAlgorithm",
+    full_name="google.cloud.dataproc.v1beta2.BasicAutoscalingAlgorithm",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="yarn_config",
+            full_name="google.cloud.dataproc.v1beta2.BasicAutoscalingAlgorithm.yarn_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cooldown_period",
+            full_name="google.cloud.dataproc.v1beta2.BasicAutoscalingAlgorithm.cooldown_period",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=699,
+    serialized_end=858,
+)
+
+
+_BASICYARNAUTOSCALINGCONFIG = _descriptor.Descriptor(
+    name="BasicYarnAutoscalingConfig",
+    full_name="google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="graceful_decommission_timeout",
+            full_name="google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig.graceful_decommission_timeout",
+            index=0,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scale_up_factor",
+            full_name="google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig.scale_up_factor",
+            index=1,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scale_down_factor",
+            full_name="google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig.scale_down_factor",
+            index=2,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scale_up_min_worker_fraction",
+            full_name="google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig.scale_up_min_worker_fraction",
+            index=3,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scale_down_min_worker_fraction",
+            full_name="google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig.scale_down_min_worker_fraction",
+            index=4,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=861,
+    serialized_end=1085,
+)
+
+
+_INSTANCEGROUPAUTOSCALINGPOLICYCONFIG = _descriptor.Descriptor(
+    name="InstanceGroupAutoscalingPolicyConfig",
+    full_name="google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_instances",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfig.min_instances",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_instances",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfig.max_instances",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="weight",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfig.weight",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1087,
+    serialized_end=1187,
+)
+
+
+_CREATEAUTOSCALINGPOLICYREQUEST = _descriptor.Descriptor(
+    name="CreateAutoscalingPolicyRequest",
+    full_name="google.cloud.dataproc.v1beta2.CreateAutoscalingPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1beta2.CreateAutoscalingPolicyRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="policy",
+            full_name="google.cloud.dataproc.v1beta2.CreateAutoscalingPolicyRequest.policy",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1189,
+    serialized_end=1303,
+)
+
+
+_GETAUTOSCALINGPOLICYREQUEST = _descriptor.Descriptor(
+    name="GetAutoscalingPolicyRequest",
+    full_name="google.cloud.dataproc.v1beta2.GetAutoscalingPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.GetAutoscalingPolicyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1305,
+    serialized_end=1348,
+)
+
+
+_UPDATEAUTOSCALINGPOLICYREQUEST = _descriptor.Descriptor(
+    name="UpdateAutoscalingPolicyRequest",
+    full_name="google.cloud.dataproc.v1beta2.UpdateAutoscalingPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="policy",
+            full_name="google.cloud.dataproc.v1beta2.UpdateAutoscalingPolicyRequest.policy",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1350,
+    serialized_end=1448,
+)
+
+
+_DELETEAUTOSCALINGPOLICYREQUEST = _descriptor.Descriptor(
+    name="DeleteAutoscalingPolicyRequest",
+    full_name="google.cloud.dataproc.v1beta2.DeleteAutoscalingPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.DeleteAutoscalingPolicyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1450,
+    serialized_end=1496,
+)
+
+
+_LISTAUTOSCALINGPOLICIESREQUEST = _descriptor.Descriptor(
+    name="ListAutoscalingPoliciesRequest",
+    full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1498,
+    serialized_end=1585,
+)
+
+
+_LISTAUTOSCALINGPOLICIESRESPONSE = _descriptor.Descriptor(
+    name="ListAutoscalingPoliciesResponse",
+    full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="policies",
+            full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesResponse.policies",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1587,
+    serialized_end=1713,
+)
+
+_AUTOSCALINGPOLICY.fields_by_name[
+    "basic_algorithm"
+].message_type = _BASICAUTOSCALINGALGORITHM
+_AUTOSCALINGPOLICY.fields_by_name[
+    "worker_config"
+].message_type = _INSTANCEGROUPAUTOSCALINGPOLICYCONFIG
+_AUTOSCALINGPOLICY.fields_by_name[
+    "secondary_worker_config"
+].message_type = _INSTANCEGROUPAUTOSCALINGPOLICYCONFIG
+_AUTOSCALINGPOLICY.oneofs_by_name["algorithm"].fields.append(
+    _AUTOSCALINGPOLICY.fields_by_name["basic_algorithm"]
+)
+_AUTOSCALINGPOLICY.fields_by_name[
+    "basic_algorithm"
+].containing_oneof = _AUTOSCALINGPOLICY.oneofs_by_name["algorithm"]
+_BASICAUTOSCALINGALGORITHM.fields_by_name[
+    "yarn_config"
+].message_type = _BASICYARNAUTOSCALINGCONFIG
+_BASICAUTOSCALINGALGORITHM.fields_by_name[
+    "cooldown_period"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_BASICYARNAUTOSCALINGCONFIG.fields_by_name[
+    "graceful_decommission_timeout"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_CREATEAUTOSCALINGPOLICYREQUEST.fields_by_name[
+    "policy"
+].message_type = _AUTOSCALINGPOLICY
+_UPDATEAUTOSCALINGPOLICYREQUEST.fields_by_name[
+    "policy"
+].message_type = _AUTOSCALINGPOLICY
+_LISTAUTOSCALINGPOLICIESRESPONSE.fields_by_name[
+    "policies"
+].message_type = _AUTOSCALINGPOLICY
+DESCRIPTOR.message_types_by_name["AutoscalingPolicy"] = _AUTOSCALINGPOLICY
+DESCRIPTOR.message_types_by_name[
+    "BasicAutoscalingAlgorithm"
+] = _BASICAUTOSCALINGALGORITHM
+DESCRIPTOR.message_types_by_name[
+    "BasicYarnAutoscalingConfig"
+] = _BASICYARNAUTOSCALINGCONFIG
+DESCRIPTOR.message_types_by_name[
+    "InstanceGroupAutoscalingPolicyConfig"
+] = _INSTANCEGROUPAUTOSCALINGPOLICYCONFIG
+DESCRIPTOR.message_types_by_name[
+    "CreateAutoscalingPolicyRequest"
+] = _CREATEAUTOSCALINGPOLICYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetAutoscalingPolicyRequest"
+] = _GETAUTOSCALINGPOLICYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateAutoscalingPolicyRequest"
+] = _UPDATEAUTOSCALINGPOLICYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteAutoscalingPolicyRequest"
+] = _DELETEAUTOSCALINGPOLICYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAutoscalingPoliciesRequest"
+] = _LISTAUTOSCALINGPOLICIESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAutoscalingPoliciesResponse"
+] = _LISTAUTOSCALINGPOLICIESRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AutoscalingPolicy = _reflection.GeneratedProtocolMessageType(
+    "AutoscalingPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AUTOSCALINGPOLICY,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""Describes an autoscaling policy for Dataproc cluster autoscaler.
+  
+  
+  Attributes:
+      id:
+          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.
+      name:
+          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}/autoscalingPolic
+          ies/{policy_id}``.
+      algorithm:
+          Required. Autoscaling algorithm for policy.
+      worker_config:
+          Required. Describes how the autoscaler will operate for
+          primary workers.
+      secondary_worker_config:
+          Optional. Describes how the autoscaler will operate for
+          secondary workers.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.AutoscalingPolicy)
+    ),
+)
+_sym_db.RegisterMessage(AutoscalingPolicy)
+
+BasicAutoscalingAlgorithm = _reflection.GeneratedProtocolMessageType(
+    "BasicAutoscalingAlgorithm",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BASICAUTOSCALINGALGORITHM,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""Basic algorithm for autoscaling.
+  
+  
+  Attributes:
+      yarn_config:
+          Required. YARN autoscaling configuration.
+      cooldown_period:
+          Optional. Duration between scaling events. A scaling period
+          starts after the update operation from the previous event has
+          completed.  Bounds: [2m, 1d]. Default: 2m.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.BasicAutoscalingAlgorithm)
+    ),
+)
+_sym_db.RegisterMessage(BasicAutoscalingAlgorithm)
+
+BasicYarnAutoscalingConfig = _reflection.GeneratedProtocolMessageType(
+    "BasicYarnAutoscalingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BASICYARNAUTOSCALINGCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""Basic autoscaling configurations for YARN.
+  
+  
+  Attributes:
+      graceful_decommission_timeout:
+          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].
+      scale_up_factor:
+          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].
+      scale_down_factor:
+          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].
+      scale_up_min_worker_fraction:
+          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.
+      scale_down_min_worker_fraction:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.BasicYarnAutoscalingConfig)
+    ),
+)
+_sym_db.RegisterMessage(BasicYarnAutoscalingConfig)
+
+InstanceGroupAutoscalingPolicyConfig = _reflection.GeneratedProtocolMessageType(
+    "InstanceGroupAutoscalingPolicyConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTANCEGROUPAUTOSCALINGPOLICYCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""Configuration for the size bounds of an instance group, including its
+  proportional size to other groups.
+  
+  
+  Attributes:
+      min_instances:
+          Optional. Minimum number of instances for this group.  Primary
+          workers - Bounds: [2, max\_instances]. Default: 2. Secondary
+          workers - Bounds: [0, max\_instances]. Default: 0.
+      max_instances:
+          Optional. 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, ). Required. Secondary workers - Bounds:
+          [min\_instances, ). Default: 0.
+      weight:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.InstanceGroupAutoscalingPolicyConfig)
+    ),
+)
+_sym_db.RegisterMessage(InstanceGroupAutoscalingPolicyConfig)
+
+CreateAutoscalingPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateAutoscalingPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEAUTOSCALINGPOLICYREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""A request to create an autoscaling policy.
+  
+  
+  Attributes:
+      parent:
+          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}``.
+      policy:
+          The autoscaling policy to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.CreateAutoscalingPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateAutoscalingPolicyRequest)
+
+GetAutoscalingPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetAutoscalingPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETAUTOSCALINGPOLICYREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""A request to fetch an autoscaling policy.
+  
+  
+  Attributes:
+      name:
+          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}/autoscalingPolic
+          ies/{policy_id}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.GetAutoscalingPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetAutoscalingPolicyRequest)
+
+UpdateAutoscalingPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateAutoscalingPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEAUTOSCALINGPOLICYREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""A request to update an autoscaling policy.
+  
+  
+  Attributes:
+      policy:
+          Required. The updated autoscaling policy.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.UpdateAutoscalingPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateAutoscalingPolicyRequest)
+
+DeleteAutoscalingPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteAutoscalingPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEAUTOSCALINGPOLICYREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""A request to delete an autoscaling policy.
+  
+  Autoscaling policies in use by one or more clusters will not be deleted.
+  
+  
+  Attributes:
+      name:
+          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}/autoscalingPolic
+          ies/{policy_id}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DeleteAutoscalingPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteAutoscalingPolicyRequest)
+
+ListAutoscalingPoliciesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAutoscalingPoliciesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTAUTOSCALINGPOLICIESREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""A request to list autoscaling policies in a project.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      page_size:
+          Optional. The maximum number of results to return in each
+          response.
+      page_token:
+          Optional. The page token, returned by a previous call, to
+          request the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAutoscalingPoliciesRequest)
+
+ListAutoscalingPoliciesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAutoscalingPoliciesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTAUTOSCALINGPOLICIESRESPONSE,
+        __module__="google.cloud.dataproc_v1beta2.proto.autoscaling_policies_pb2",
+        __doc__="""A response to a request to list autoscaling policies in a project.
+  
+  
+  Attributes:
+      policies:
+          Output only. Autoscaling policies list.
+      next_page_token:
+          Output only. This token is included in the response if there
+          are more results to fetch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListAutoscalingPoliciesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAutoscalingPoliciesResponse)
+
+
+DESCRIPTOR._options = None
+
+_AUTOSCALINGPOLICYSERVICE = _descriptor.ServiceDescriptor(
+    name="AutoscalingPolicyService",
+    full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicyService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1716,
+    serialized_end=3142,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateAutoscalingPolicy",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicyService.CreateAutoscalingPolicy",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEAUTOSCALINGPOLICYREQUEST,
+            output_type=_AUTOSCALINGPOLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002\214\001"</v1beta2/{parent=projects/*/locations/*}/autoscalingPolicies:\006policyZD":/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies:\006policy'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateAutoscalingPolicy",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicyService.UpdateAutoscalingPolicy",
+            index=1,
+            containing_service=None,
+            input_type=_UPDATEAUTOSCALINGPOLICYREQUEST,
+            output_type=_AUTOSCALINGPOLICY,
+            serialized_options=_b(
+                "\202\323\344\223\002\232\001\032C/v1beta2/{policy.name=projects/*/locations/*/autoscalingPolicies/*}:\006policyZK\032A/v1beta2/{policy.name=projects/*/regions/*/autoscalingPolicies/*}:\006policy"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetAutoscalingPolicy",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicyService.GetAutoscalingPolicy",
+            index=2,
+            containing_service=None,
+            input_type=_GETAUTOSCALINGPOLICYREQUEST,
+            output_type=_AUTOSCALINGPOLICY,
+            serialized_options=_b(
+                "\202\323\344\223\002|\022</v1beta2/{name=projects/*/locations/*/autoscalingPolicies/*}Z<\022:/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAutoscalingPolicies",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicyService.ListAutoscalingPolicies",
+            index=3,
+            containing_service=None,
+            input_type=_LISTAUTOSCALINGPOLICIESREQUEST,
+            output_type=_LISTAUTOSCALINGPOLICIESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002|\022</v1beta2/{parent=projects/*/locations/*}/autoscalingPoliciesZ<\022:/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteAutoscalingPolicy",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingPolicyService.DeleteAutoscalingPolicy",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEAUTOSCALINGPOLICYREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002|*</v1beta2/{name=projects/*/locations/*/autoscalingPolicies/*}Z<*:/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_AUTOSCALINGPOLICYSERVICE)
+
+DESCRIPTOR.services_by_name["AutoscalingPolicyService"] = _AUTOSCALINGPOLICYSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies_pb2_grpc.py
new file mode 100644
index 000000000000..1e6910a545ae
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/autoscaling_policies_pb2_grpc.py
@@ -0,0 +1,124 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1beta2.proto import (
+    autoscaling_policies_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class AutoscalingPolicyServiceStub(object):
+    """The API interface for managing autoscaling policies in the
+  Google Cloud Dataproc API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateAutoscalingPolicy = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.AutoscalingPolicyService/CreateAutoscalingPolicy",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.CreateAutoscalingPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.AutoscalingPolicy.FromString,
+        )
+        self.UpdateAutoscalingPolicy = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.AutoscalingPolicyService/UpdateAutoscalingPolicy",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.UpdateAutoscalingPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.AutoscalingPolicy.FromString,
+        )
+        self.GetAutoscalingPolicy = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.AutoscalingPolicyService/GetAutoscalingPolicy",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.GetAutoscalingPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.AutoscalingPolicy.FromString,
+        )
+        self.ListAutoscalingPolicies = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.AutoscalingPolicyService/ListAutoscalingPolicies",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.ListAutoscalingPoliciesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.ListAutoscalingPoliciesResponse.FromString,
+        )
+        self.DeleteAutoscalingPolicy = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.AutoscalingPolicyService/DeleteAutoscalingPolicy",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.DeleteAutoscalingPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class AutoscalingPolicyServiceServicer(object):
+    """The API interface for managing autoscaling policies in the
+  Google Cloud Dataproc API.
+  """
+
+    def CreateAutoscalingPolicy(self, request, context):
+        """Creates new autoscaling policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateAutoscalingPolicy(self, request, context):
+        """Updates (replaces) autoscaling policy.
+
+    Disabled check for update_mask, because all updates will be full
+    replacements.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetAutoscalingPolicy(self, request, context):
+        """Retrieves autoscaling policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAutoscalingPolicies(self, request, context):
+        """Lists autoscaling policies in the project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteAutoscalingPolicy(self, request, context):
+        """Deletes an autoscaling policy. It is an error to delete an autoscaling
+    policy that is in use by one or more clusters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_AutoscalingPolicyServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateAutoscalingPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateAutoscalingPolicy,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.CreateAutoscalingPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.AutoscalingPolicy.SerializeToString,
+        ),
+        "UpdateAutoscalingPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateAutoscalingPolicy,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.UpdateAutoscalingPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.AutoscalingPolicy.SerializeToString,
+        ),
+        "GetAutoscalingPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetAutoscalingPolicy,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.GetAutoscalingPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.AutoscalingPolicy.SerializeToString,
+        ),
+        "ListAutoscalingPolicies": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAutoscalingPolicies,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.ListAutoscalingPoliciesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.ListAutoscalingPoliciesResponse.SerializeToString,
+        ),
+        "DeleteAutoscalingPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteAutoscalingPolicy,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_autoscaling__policies__pb2.DeleteAutoscalingPolicyRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1beta2.AutoscalingPolicyService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/clusters.proto b/dataproc/google/cloud/dataproc_v1beta2/proto/clusters.proto
new file mode 100644
index 000000000000..d3bed6b3f244
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/clusters.proto
@@ -0,0 +1,893 @@
+// 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.dataproc.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/cloud/dataproc/v1beta2/operations.proto";
+import "google/cloud/dataproc/v1beta2/shared.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.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 = "ClustersProto";
+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.
+  rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/projects/{project_id}/regions/{region}/clusters"
+      body: "cluster"
+    };
+  }
+
+  // Updates a cluster in a project.
+  rpc UpdateCluster(UpdateClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+      body: "cluster"
+    };
+  }
+
+  // Deletes a cluster in a project.
+  rpc DeleteCluster(DeleteClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+    };
+  }
+
+  // Gets the resource representation for a cluster in a project.
+  rpc GetCluster(GetClusterRequest) returns (Cluster) {
+    option (google.api.http) = {
+      get: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+    };
+  }
+
+  // Lists all regions/{region}/clusters in a project.
+  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
+    option (google.api.http) = {
+      get: "/v1beta2/projects/{project_id}/regions/{region}/clusters"
+    };
+  }
+
+  // Gets cluster diagnostic information.
+  // After the operation completes, the Operation.response field
+  // contains `DiagnoseClusterOutputLocation`.
+  rpc DiagnoseCluster(DiagnoseClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose"
+      body: "*"
+    };
+  }
+}
+
+// Describes the identifying information, config, and status of
+// a cluster of Compute Engine instances.
+message Cluster {
+  // Required. The Google Cloud Platform project ID that the cluster belongs to.
+  string project_id = 1;
+
+  // Required. The cluster name. Cluster names within a project must be
+  // unique. Names of deleted clusters can be reused.
+  string cluster_name = 2;
+
+  // Required. The cluster config. Note that Cloud Dataproc may set
+  // default values, and values may change when clusters are updated.
+  ClusterConfig config = 3;
+
+  // Optional. The labels to associate with this cluster.
+  // Label **keys** must contain 1 to 63 characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  // Label **values** may be empty, but, if present, must contain 1 to 63
+  // 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<string, string> labels = 8;
+
+  // Output only. Cluster status.
+  ClusterStatus status = 4;
+
+  // Output only. The previous cluster status.
+  repeated ClusterStatus status_history = 7;
+
+  // Output only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc
+  // generates this value when it creates the cluster.
+  string cluster_uuid = 6;
+
+  // 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;
+}
+
+// The cluster config.
+message ClusterConfig {
+  // Optional. A Google 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
+  // 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;
+
+  // Optional. The shared Compute Engine config settings for
+  // all instances in a cluster.
+  GceClusterConfig gce_cluster_config = 8;
+
+  // Optional. The Compute Engine config settings for
+  // the master instance in a cluster.
+  InstanceGroupConfig master_config = 9;
+
+  // Optional. The Compute Engine config settings for
+  // worker instances in a cluster.
+  InstanceGroupConfig worker_config = 10;
+
+  // Optional. The Compute Engine config settings for
+  // additional worker instances in a cluster.
+  InstanceGroupConfig secondary_worker_config = 12;
+
+  // Optional. The config settings for software inside the cluster.
+  SoftwareConfig software_config = 13;
+
+  // Optional. The config setting for auto delete cluster schedule.
+  LifecycleConfig lifecycle_config = 14;
+
+  // Optional. Commands to execute on each node after config is
+  // completed. By default, executables are run on master and all worker nodes.
+  // You can test a node's <code>role</code> metadata to run an executable on
+  // a master or worker node, as shown below using `curl` (you can also use
+  // `wget`):
+  //
+  //     ROLE=$(curl -H Metadata-Flavor:Google
+  //     http://metadata/computeMetadata/v1beta2/instance/attributes/dataproc-role)
+  //     if [[ "${ROLE}" == 'Master' ]]; then
+  //       ... master specific actions ...
+  //     else
+  //       ... worker specific actions ...
+  //     fi
+  repeated NodeInitializationAction initialization_actions = 11;
+
+  // Optional. Encryption settings for the cluster.
+  EncryptionConfig encryption_config = 15;
+
+  // Optional. Autoscaling config for the policy associated with the cluster.
+  // Cluster does not autoscale if this field is unset.
+  AutoscalingConfig autoscaling_config = 16;
+
+  // Optional. Port/endpoint configuration for this cluster
+  EndpointConfig endpoint_config = 17;
+
+  // Optional. Security related configuration.
+  SecurityConfig security_config = 18;
+}
+
+// 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<string, string> http_ports = 1;
+
+  // Optional. If true, enable http access to specific ports on the cluster
+  // from external sources. Defaults to false.
+  bool enable_http_port_access = 2;
+}
+
+// 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 Cloud Dataproc region.
+  string policy_uri = 1;
+}
+
+// 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;
+}
+
+// Common config settings for resources of Compute Engine cluster
+// instances, applicable to all instances in the cluster.
+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
+  // corresponding Compute Engine region. On a get request, zone will always be
+  // present.
+  //
+  // A full URL, partial URI, or short name are valid. Examples:
+  //
+  // * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]`
+  // * `projects/[project_id]/zones/[zone]`
+  // * `us-central1-f`
+  string zone_uri = 1;
+
+  // 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).
+  //
+  // 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;
+
+  // Optional. The Compute Engine subnetwork to be used for machine
+  // communications. Cannot be specified with network_uri.
+  //
+  // A full URL, partial URI, or short name are valid. Examples:
+  //
+  // * `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;
+
+  // Optional. If true, all instances in the cluster will only have internal IP
+  // addresses. By default, clusters are not restricted to internal IP
+  // addresses, and will have ephemeral external IP addresses assigned to each
+  // 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;
+
+  // 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:
+  //
+  // * 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;
+
+  // Optional. The URIs of service account scopes to be included in
+  // Compute Engine instances. The following base set of scopes is always
+  // included:
+  //
+  // * https://www.googleapis.com/auth/cloud.useraccounts.readonly
+  // * https://www.googleapis.com/auth/devstorage.read_write
+  // * https://www.googleapis.com/auth/logging.write
+  //
+  // If no scopes are specified, the following defaults are also provided:
+  //
+  // * https://www.googleapis.com/auth/bigquery
+  // * 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;
+
+  // The Compute Engine tags to add to all instances (see
+  // [Tagging instances](/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<string, string> metadata = 5;
+
+  // Optional. Reservation Affinity for consuming Zonal reservation.
+  ReservationAffinity reservation_affinity = 11;
+}
+
+// Optional. 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;
+
+  // Output only. The list of instance names. Cloud Dataproc derives the names
+  // from `cluster_name`, `num_instances`, and the instance group.
+  repeated string instance_names = 2;
+
+  // 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 machine type used for cluster instances.
+  //
+  // A full URL, partial URI, or short name are valid. Examples:
+  //
+  // * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`
+  // * `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
+  // Placement](/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;
+
+  // Optional. Disk option config settings.
+  DiskConfig disk_config = 5;
+
+  // Optional. Specifies that this instance group contains preemptible
+  // instances.
+  bool is_preemptible = 6;
+
+  // 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;
+
+  // 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;
+
+  // Optional. Specifies the minimum cpu platform for the Instance Group.
+  // See [Cloud Dataproc&rarr;Minimum CPU Platform]
+  // (/dataproc/docs/concepts/compute/dataproc-min-cpu).
+  string min_cpu_platform = 9;
+}
+
+// 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;
+
+  // Output only. The name of the Instance Group Manager for this group.
+  string instance_group_manager_name = 2;
+}
+
+// Specifies the type and number of accelerator cards attached to the instances
+// of an instance group (see [GPUs on Compute Engine](/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)
+  //
+  // 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
+  // Placement](/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;
+
+  // The number of the accelerator cards of this type exposed to this instance.
+  int32 accelerator_count = 2;
+}
+
+// Specifies the config of disk options for a group of VM instances.
+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;
+
+  // Optional. Size in GB of the boot disk (default is 500GB).
+  int32 boot_disk_size_gb = 1;
+
+  // 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
+  // [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data.
+  // 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;
+}
+
+// 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
+  // the cluster maximum age.
+  oneof ttl {
+    // Optional. The time when cluster will be auto-deleted.
+    google.protobuf.Timestamp auto_delete_time = 2;
+
+    // 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;
+  }
+}
+
+// Security related configuration, including encryption, Kerberos, etc.
+message SecurityConfig {
+  // Kerberos related configuration.
+  KerberosConfig kerberos_config = 1;
+}
+
+// Specifies Kerberos related configuration.
+message KerberosConfig {
+  // Optional. Flag to indicate whether to Kerberize the cluster.
+  bool enable_kerberos = 1;
+
+  // Required. The Cloud Storage URI of a KMS encrypted file containing the root
+  // principal password.
+  string root_principal_password_uri = 2;
+
+  // Required. The uri of the KMS key used to encrypt various sensitive
+  // files.
+  string kms_key_uri = 3;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // Optional. The remote realm the Dataproc on-cluster KDC will trust, should
+  // the user enable cross realm trust.
+  string cross_realm_trust_realm = 9;
+
+  // Optional. The KDC (IP or hostname) for the remote trusted realm in a cross
+  // realm trust relationship.
+  string cross_realm_trust_kdc = 10;
+
+  // 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;
+
+  // 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;
+
+  // Optional. The Cloud Storage URI of a KMS encrypted file containing the
+  // master key of the KDC database.
+  string kdc_db_key_uri = 13;
+
+  // 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;
+}
+
+// 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;
+
+  // Optional. Amount of time executable has to complete. Default is
+  // 10 minutes. 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;
+}
+
+// The status of a cluster and its instances.
+message ClusterStatus {
+  // The cluster state.
+  enum State {
+    // The cluster state is unknown.
+    UNKNOWN = 0;
+
+    // The cluster is being created and set up. It is not ready for use.
+    CREATING = 1;
+
+    // The cluster is currently running and healthy. It is ready for use.
+    RUNNING = 2;
+
+    // The cluster encountered an error. It is not ready for use.
+    ERROR = 3;
+
+    // The cluster is being deleted. It cannot be used.
+    DELETING = 4;
+
+    // The cluster is being updated. It continues to accept and process jobs.
+    UPDATING = 5;
+  }
+
+  // The cluster substate.
+  enum Substate {
+    // The cluster substate is unknown.
+    UNSPECIFIED = 0;
+
+    // The cluster is known to be in an unhealthy state
+    // (for example, critical daemons are not running or HDFS capacity is
+    // exhausted).
+    //
+    // Applies to RUNNING state.
+    UNHEALTHY = 1;
+
+    // The agent-reported status is out of date (may occur if
+    // Cloud Dataproc loses communication with Agent).
+    //
+    // Applies to RUNNING state.
+    STALE_STATUS = 2;
+  }
+
+  // Output only. The cluster's state.
+  State state = 1;
+
+  // Output only. Optional details of cluster's state.
+  string detail = 2;
+
+  // Output only. Time when this state was entered.
+  google.protobuf.Timestamp state_start_time = 3;
+
+  // Output only. Additional state information that includes
+  // status reported by the agent.
+  Substate substate = 4;
+}
+
+// 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),
+  // 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).
+  // If unspecified, it defaults to the latest Debian version.
+  string image_version = 1;
+
+  // Optional. The properties to set on daemon config files.
+  //
+  // Property keys are specified in `prefix:property` format, for example
+  // `core:hadoop.tmp.dir`. The following are supported prefixes
+  // and their mappings:
+  //
+  // * capacity-scheduler: `capacity-scheduler.xml`
+  // * core:   `core-site.xml`
+  // * distcp: `distcp-default.xml`
+  // * hdfs:   `hdfs-site.xml`
+  // * hive:   `hive-site.xml`
+  // * mapred: `mapred-site.xml`
+  // * pig:    `pig.properties`
+  // * spark:  `spark-defaults.conf`
+  // * yarn:   `yarn-site.xml`
+  //
+  // For more information, see
+  // [Cluster properties](/dataproc/docs/concepts/cluster-properties).
+  map<string, string> properties = 2;
+
+  // The set of optional components to activate on the cluster.
+  repeated Component optional_components = 3;
+}
+
+// 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.
+message ClusterMetrics {
+  // The HDFS metrics.
+  map<string, int64> hdfs_metrics = 1;
+
+  // The YARN metrics.
+  map<string, int64> yarn_metrics = 2;
+}
+
+// A request to create a cluster.
+message CreateClusterRequest {
+  // Required. The ID of the Google Cloud Platform project that the cluster
+  // belongs to.
+  string project_id = 1;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster to create.
+  Cluster cluster = 2;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [CreateClusterRequest][google.cloud.dataproc.v1beta2.CreateClusterRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the backend
+  // is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 5;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+
+  // Required. The changes to the cluster.
+  Cluster cluster = 3;
+
+  // 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.
+  //
+  // Only supported on Dataproc image versions 1.2 and higher.
+  google.protobuf.Duration graceful_decommission_timeout = 6;
+
+  // Required. Specifies the path, relative to `Cluster`, of
+  // the field to update. For example, to change the number of workers
+  // in a cluster to 5, the `update_mask` parameter would be
+  // specified as `config.worker_config.num_instances`,
+  // and the `PATCH` request body would specify the new value, as follows:
+  //
+  //     {
+  //       "config":{
+  //         "workerConfig":{
+  //           "numInstances":"5"
+  //         }
+  //       }
+  //     }
+  //
+  // Similarly, to change the number of preemptible workers in a cluster to 5,
+  // the `update_mask` parameter would be
+  // `config.secondary_worker_config.num_instances`, and the `PATCH` request
+  // body would be set as follows:
+  //
+  //     {
+  //       "config":{
+  //         "secondaryWorkerConfig":{
+  //           "numInstances":"5"
+  //         }
+  //       }
+  //     }
+  // <strong>Note:</strong> currently only the following fields can be updated:
+  //
+  // <table>
+  // <tr>
+  // <td><strong>Mask</strong></td><td><strong>Purpose</strong></td>
+  // </tr>
+  // <tr>
+  // <td>labels</td><td>Updates labels</td>
+  // </tr>
+  // <tr>
+  // <td>config.worker_config.num_instances</td><td>Resize primary worker
+  // group</td>
+  // </tr>
+  // <tr>
+  // <td>config.secondary_worker_config.num_instances</td><td>Resize secondary
+  // worker group</td>
+  // </tr>
+  // <tr>
+  // <td>config.lifecycle_config.auto_delete_ttl</td><td>Reset MAX TTL
+  // duration</td>
+  // </tr>
+  // <tr>
+  // <td>config.lifecycle_config.auto_delete_time</td><td>Update MAX TTL
+  // deletion timestamp</td>
+  // </tr>
+  // <tr>
+  // <td>config.lifecycle_config.idle_delete_ttl</td><td>Update Idle TTL
+  // duration</td>
+  // </tr>
+  // <tr>
+  // <td>config.autoscaling_config.policy_uri</td><td>Use, stop using, or change
+  // autoscaling policies</td>
+  // </tr>
+  // </table>
+  google.protobuf.FieldMask update_mask = 4;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [UpdateClusterRequest][google.cloud.dataproc.v1beta2.UpdateClusterRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
+  // backend is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+
+  // 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;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [DeleteClusterRequest][google.cloud.dataproc.v1beta2.DeleteClusterRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [google.longrunning.Operation][google.longrunning.Operation] created and stored in the
+  // backend is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 4;
+
+  // Optional. A filter constraining the clusters to list. Filters are
+  // case-sensitive and have the following syntax:
+  //
+  // field = value [AND [field = value]] ...
+  //
+  // where **field** is one of `status.state`, `clusterName`, or `labels.[KEY]`,
+  // and `[KEY]` is a label key. **value** can be `*` to match all values.
+  // `status.state` can be one of the following: `ACTIVE`, `INACTIVE`,
+  // `CREATING`, `RUNNING`, `ERROR`, `DELETING`, or `UPDATING`. `ACTIVE`
+  // contains the `CREATING`, `UPDATING`, and `RUNNING` states. `INACTIVE`
+  // contains the `DELETING` and `ERROR` states.
+  // `clusterName` is the name of the cluster provided at creation time.
+  // Only the logical `AND` operator is supported; space-separated items are
+  // treated as having an implicit `AND` operator.
+  //
+  // Example filter:
+  //
+  // status.state = ACTIVE AND clusterName = mycluster
+  // AND labels.env = staging AND labels.starred = *
+  string filter = 5;
+
+  // Optional. The standard List page size.
+  int32 page_size = 2;
+
+  // Optional. The standard List page token.
+  string page_token = 3;
+}
+
+// The list of all clusters in a project.
+message ListClustersResponse {
+  // Output only. The clusters in the project.
+  repeated Cluster clusters = 1;
+
+  // 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 <code>ListClustersRequest</code>.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The cluster name.
+  string cluster_name = 2;
+}
+
+// The location of diagnostic output.
+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;
+}
+
+// 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;
+
+  // Optional. Corresponds to the label key of reservation resource.
+  string key = 2;
+
+  // Optional. Corresponds to the label values of reservation resource.
+  repeated string values = 3;
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/clusters_pb2.py b/dataproc/google/cloud/dataproc_v1beta2/proto/clusters_pb2.py
new file mode 100644
index 000000000000..bfe5208a5e7e
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/clusters_pb2.py
@@ -0,0 +1,4276 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1beta2/proto/clusters.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.dataproc_v1beta2.proto import (
+    operations_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_operations__pb2,
+)
+from google.cloud.dataproc_v1beta2.proto import (
+    shared_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_shared__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1beta2/proto/clusters.proto",
+    package="google.cloud.dataproc.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.dataproc.v1beta2B\rClustersProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/dataproc_v1beta2/proto/clusters.proto\x12\x1dgoogle.cloud.dataproc.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x34google/cloud/dataproc_v1beta2/proto/operations.proto\x1a\x30google/cloud/dataproc_v1beta2/proto/shared.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xbe\x03\n\x07\x43luster\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12<\n\x06\x63onfig\x18\x03 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.ClusterConfig\x12\x42\n\x06labels\x18\x08 \x03(\x0b\x32\x32.google.cloud.dataproc.v1beta2.Cluster.LabelsEntry\x12<\n\x06status\x18\x04 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.ClusterStatus\x12\x44\n\x0estatus_history\x18\x07 \x03(\x0b\x32,.google.cloud.dataproc.v1beta2.ClusterStatus\x12\x14\n\x0c\x63luster_uuid\x18\x06 \x01(\t\x12>\n\x07metrics\x18\t \x01(\x0b\x32-.google.cloud.dataproc.v1beta2.ClusterMetrics\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xf3\x06\n\rClusterConfig\x12\x15\n\rconfig_bucket\x18\x01 \x01(\t\x12K\n\x12gce_cluster_config\x18\x08 \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.GceClusterConfig\x12I\n\rmaster_config\x18\t \x01(\x0b\x32\x32.google.cloud.dataproc.v1beta2.InstanceGroupConfig\x12I\n\rworker_config\x18\n \x01(\x0b\x32\x32.google.cloud.dataproc.v1beta2.InstanceGroupConfig\x12S\n\x17secondary_worker_config\x18\x0c \x01(\x0b\x32\x32.google.cloud.dataproc.v1beta2.InstanceGroupConfig\x12\x46\n\x0fsoftware_config\x18\r \x01(\x0b\x32-.google.cloud.dataproc.v1beta2.SoftwareConfig\x12H\n\x10lifecycle_config\x18\x0e \x01(\x0b\x32..google.cloud.dataproc.v1beta2.LifecycleConfig\x12W\n\x16initialization_actions\x18\x0b \x03(\x0b\x32\x37.google.cloud.dataproc.v1beta2.NodeInitializationAction\x12J\n\x11\x65ncryption_config\x18\x0f \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.EncryptionConfig\x12L\n\x12\x61utoscaling_config\x18\x10 \x01(\x0b\x32\x30.google.cloud.dataproc.v1beta2.AutoscalingConfig\x12\x46\n\x0f\x65ndpoint_config\x18\x11 \x01(\x0b\x32-.google.cloud.dataproc.v1beta2.EndpointConfig\x12\x46\n\x0fsecurity_config\x18\x12 \x01(\x0b\x32-.google.cloud.dataproc.v1beta2.SecurityConfig"\xb5\x01\n\x0e\x45ndpointConfig\x12P\n\nhttp_ports\x18\x01 \x03(\x0b\x32<.google.cloud.dataproc.v1beta2.EndpointConfig.HttpPortsEntry\x12\x1f\n\x17\x65nable_http_port_access\x18\x02 \x01(\x08\x1a\x30\n\x0eHttpPortsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\'\n\x11\x41utoscalingConfig\x12\x12\n\npolicy_uri\x18\x01 \x01(\t"/\n\x10\x45ncryptionConfig\x12\x1b\n\x13gce_pd_kms_key_name\x18\x01 \x01(\t"\x86\x03\n\x10GceClusterConfig\x12\x10\n\x08zone_uri\x18\x01 \x01(\t\x12\x13\n\x0bnetwork_uri\x18\x02 \x01(\t\x12\x16\n\x0esubnetwork_uri\x18\x06 \x01(\t\x12\x18\n\x10internal_ip_only\x18\x07 \x01(\x08\x12\x17\n\x0fservice_account\x18\x08 \x01(\t\x12\x1e\n\x16service_account_scopes\x18\x03 \x03(\t\x12\x0c\n\x04tags\x18\x04 \x03(\t\x12O\n\x08metadata\x18\x05 \x03(\x0b\x32=.google.cloud.dataproc.v1beta2.GceClusterConfig.MetadataEntry\x12P\n\x14reservation_affinity\x18\x0b \x01(\x0b\x32\x32.google.cloud.dataproc.v1beta2.ReservationAffinity\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xfc\x02\n\x13InstanceGroupConfig\x12\x15\n\rnum_instances\x18\x01 \x01(\x05\x12\x16\n\x0einstance_names\x18\x02 \x03(\t\x12\x11\n\timage_uri\x18\x03 \x01(\t\x12\x18\n\x10machine_type_uri\x18\x04 \x01(\t\x12>\n\x0b\x64isk_config\x18\x05 \x01(\x0b\x32).google.cloud.dataproc.v1beta2.DiskConfig\x12\x16\n\x0eis_preemptible\x18\x06 \x01(\x08\x12O\n\x14managed_group_config\x18\x07 \x01(\x0b\x32\x31.google.cloud.dataproc.v1beta2.ManagedGroupConfig\x12\x46\n\x0c\x61\x63\x63\x65lerators\x18\x08 \x03(\x0b\x32\x30.google.cloud.dataproc.v1beta2.AcceleratorConfig\x12\x18\n\x10min_cpu_platform\x18\t \x01(\t"Y\n\x12ManagedGroupConfig\x12\x1e\n\x16instance_template_name\x18\x01 \x01(\t\x12#\n\x1binstance_group_manager_name\x18\x02 \x01(\t"L\n\x11\x41\x63\x63\x65leratorConfig\x12\x1c\n\x14\x61\x63\x63\x65lerator_type_uri\x18\x01 \x01(\t\x12\x19\n\x11\x61\x63\x63\x65lerator_count\x18\x02 \x01(\x05"W\n\nDiskConfig\x12\x16\n\x0e\x62oot_disk_type\x18\x03 \x01(\t\x12\x19\n\x11\x62oot_disk_size_gb\x18\x01 \x01(\x05\x12\x16\n\x0enum_local_ssds\x18\x02 \x01(\x05"\xba\x01\n\x0fLifecycleConfig\x12\x32\n\x0fidle_delete_ttl\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x36\n\x10\x61uto_delete_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x61uto_delete_ttl\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x42\x05\n\x03ttl"X\n\x0eSecurityConfig\x12\x46\n\x0fkerberos_config\x18\x01 \x01(\x0b\x32-.google.cloud.dataproc.v1beta2.KerberosConfig"\xb6\x03\n\x0eKerberosConfig\x12\x17\n\x0f\x65nable_kerberos\x18\x01 \x01(\x08\x12#\n\x1broot_principal_password_uri\x18\x02 \x01(\t\x12\x13\n\x0bkms_key_uri\x18\x03 \x01(\t\x12\x14\n\x0ckeystore_uri\x18\x04 \x01(\t\x12\x16\n\x0etruststore_uri\x18\x05 \x01(\t\x12\x1d\n\x15keystore_password_uri\x18\x06 \x01(\t\x12\x18\n\x10key_password_uri\x18\x07 \x01(\t\x12\x1f\n\x17truststore_password_uri\x18\x08 \x01(\t\x12\x1f\n\x17\x63ross_realm_trust_realm\x18\t \x01(\t\x12\x1d\n\x15\x63ross_realm_trust_kdc\x18\n \x01(\t\x12&\n\x1e\x63ross_realm_trust_admin_server\x18\x0b \x01(\t\x12-\n%cross_realm_trust_shared_password_uri\x18\x0c \x01(\t\x12\x16\n\x0ekdc_db_key_uri\x18\r \x01(\t\x12\x1a\n\x12tgt_lifetime_hours\x18\x0e \x01(\x05"i\n\x18NodeInitializationAction\x12\x17\n\x0f\x65xecutable_file\x18\x01 \x01(\t\x12\x34\n\x11\x65xecution_timeout\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xf7\x02\n\rClusterStatus\x12\x41\n\x05state\x18\x01 \x01(\x0e\x32\x32.google.cloud.dataproc.v1beta2.ClusterStatus.State\x12\x0e\n\x06\x64\x65tail\x18\x02 \x01(\t\x12\x34\n\x10state_start_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12G\n\x08substate\x18\x04 \x01(\x0e\x32\x35.google.cloud.dataproc.v1beta2.ClusterStatus.Substate"V\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\x12\x0c\n\x08\x44\x45LETING\x10\x04\x12\x0c\n\x08UPDATING\x10\x05"<\n\x08Substate\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\r\n\tUNHEALTHY\x10\x01\x12\x10\n\x0cSTALE_STATUS\x10\x02"\xf4\x01\n\x0eSoftwareConfig\x12\x15\n\rimage_version\x18\x01 \x01(\t\x12Q\n\nproperties\x18\x02 \x03(\x0b\x32=.google.cloud.dataproc.v1beta2.SoftwareConfig.PropertiesEntry\x12\x45\n\x13optional_components\x18\x03 \x03(\x0e\x32(.google.cloud.dataproc.v1beta2.Component\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xa4\x02\n\x0e\x43lusterMetrics\x12T\n\x0chdfs_metrics\x18\x01 \x03(\x0b\x32>.google.cloud.dataproc.v1beta2.ClusterMetrics.HdfsMetricsEntry\x12T\n\x0cyarn_metrics\x18\x02 \x03(\x0b\x32>.google.cloud.dataproc.v1beta2.ClusterMetrics.YarnMetricsEntry\x1a\x32\n\x10HdfsMetricsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01\x1a\x32\n\x10YarnMetricsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01"\x87\x01\n\x14\x43reateClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x37\n\x07\x63luster\x18\x02 \x01(\x0b\x32&.google.cloud.dataproc.v1beta2.Cluster\x12\x12\n\nrequest_id\x18\x04 \x01(\t"\x90\x02\n\x14UpdateClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x05 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x37\n\x07\x63luster\x18\x03 \x01(\x0b\x32&.google.cloud.dataproc.v1beta2.Cluster\x12@\n\x1dgraceful_decommission_timeout\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12/\n\x0bupdate_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x12\n\nrequest_id\x18\x07 \x01(\t"z\n\x14\x44\x65leteClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12\x14\n\x0c\x63luster_uuid\x18\x04 \x01(\t\x12\x12\n\nrequest_id\x18\x05 \x01(\t"M\n\x11GetClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t"p\n\x13ListClustersRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"i\n\x14ListClustersResponse\x12\x38\n\x08\x63lusters\x18\x01 \x03(\x0b\x32&.google.cloud.dataproc.v1beta2.Cluster\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"R\n\x16\x44iagnoseClusterRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t",\n\x16\x44iagnoseClusterResults\x12\x12\n\noutput_uri\x18\x01 \x01(\t"\xee\x01\n\x13ReservationAffinity\x12Y\n\x18\x63onsume_reservation_type\x18\x01 \x01(\x0e\x32\x37.google.cloud.dataproc.v1beta2.ReservationAffinity.Type\x12\x0b\n\x03key\x18\x02 \x01(\t\x12\x0e\n\x06values\x18\x03 \x03(\t"_\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0eNO_RESERVATION\x10\x01\x12\x13\n\x0f\x41NY_RESERVATION\x10\x02\x12\x18\n\x14SPECIFIC_RESERVATION\x10\x03\x32\xf8\x08\n\x11\x43lusterController\x12\xae\x01\n\rCreateCluster\x12\x33.google.cloud.dataproc.v1beta2.CreateClusterRequest\x1a\x1d.google.longrunning.Operation"I\x82\xd3\xe4\x93\x02\x43"8/v1beta2/projects/{project_id}/regions/{region}/clusters:\x07\x63luster\x12\xbd\x01\n\rUpdateCluster\x12\x33.google.cloud.dataproc.v1beta2.UpdateClusterRequest\x1a\x1d.google.longrunning.Operation"X\x82\xd3\xe4\x93\x02R2G/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}:\x07\x63luster\x12\xb4\x01\n\rDeleteCluster\x12\x33.google.cloud.dataproc.v1beta2.DeleteClusterRequest\x1a\x1d.google.longrunning.Operation"O\x82\xd3\xe4\x93\x02I*G/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}\x12\xb7\x01\n\nGetCluster\x12\x30.google.cloud.dataproc.v1beta2.GetClusterRequest\x1a&.google.cloud.dataproc.v1beta2.Cluster"O\x82\xd3\xe4\x93\x02I\x12G/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}\x12\xb9\x01\n\x0cListClusters\x12\x32.google.cloud.dataproc.v1beta2.ListClustersRequest\x1a\x33.google.cloud.dataproc.v1beta2.ListClustersResponse"@\x82\xd3\xe4\x93\x02:\x12\x38/v1beta2/projects/{project_id}/regions/{region}/clusters\x12\xc4\x01\n\x0f\x44iagnoseCluster\x12\x35.google.cloud.dataproc.v1beta2.DiagnoseClusterRequest\x1a\x1d.google.longrunning.Operation"[\x82\xd3\xe4\x93\x02U"P/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose:\x01*B{\n!com.google.cloud.dataproc.v1beta2B\rClustersProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_operations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_shared__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CLUSTERSTATUS_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1beta2.ClusterStatus.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATING", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4053,
+    serialized_end=4139,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTERSTATUS_STATE)
+
+_CLUSTERSTATUS_SUBSTATE = _descriptor.EnumDescriptor(
+    name="Substate",
+    full_name="google.cloud.dataproc.v1beta2.ClusterStatus.Substate",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNHEALTHY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STALE_STATUS", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4141,
+    serialized_end=4201,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTERSTATUS_SUBSTATE)
+
+_RESERVATIONAFFINITY_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.dataproc.v1beta2.ReservationAffinity.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NO_RESERVATION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANY_RESERVATION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPECIFIC_RESERVATION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5856,
+    serialized_end=5951,
+)
+_sym_db.RegisterEnumDescriptor(_RESERVATIONAFFINITY_TYPE)
+
+
+_CLUSTER_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.Cluster.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=757,
+    serialized_end=802,
+)
+
+_CLUSTER = _descriptor.Descriptor(
+    name="Cluster",
+    full_name="google.cloud.dataproc.v1beta2.Cluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.cluster_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.labels",
+            index=3,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.status",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_history",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.status_history",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.cluster_uuid",
+            index=6,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metrics",
+            full_name="google.cloud.dataproc.v1beta2.Cluster.metrics",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTER_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=356,
+    serialized_end=802,
+)
+
+
+_CLUSTERCONFIG = _descriptor.Descriptor(
+    name="ClusterConfig",
+    full_name="google.cloud.dataproc.v1beta2.ClusterConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config_bucket",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.config_bucket",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gce_cluster_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.gce_cluster_config",
+            index=1,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="master_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.master_config",
+            index=2,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="worker_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.worker_config",
+            index=3,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="secondary_worker_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.secondary_worker_config",
+            index=4,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="software_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.software_config",
+            index=5,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lifecycle_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.lifecycle_config",
+            index=6,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="initialization_actions",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.initialization_actions",
+            index=7,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encryption_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.encryption_config",
+            index=8,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="autoscaling_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.autoscaling_config",
+            index=9,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="endpoint_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.endpoint_config",
+            index=10,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_config",
+            full_name="google.cloud.dataproc.v1beta2.ClusterConfig.security_config",
+            index=11,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=805,
+    serialized_end=1688,
+)
+
+
+_ENDPOINTCONFIG_HTTPPORTSENTRY = _descriptor.Descriptor(
+    name="HttpPortsEntry",
+    full_name="google.cloud.dataproc.v1beta2.EndpointConfig.HttpPortsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.EndpointConfig.HttpPortsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.EndpointConfig.HttpPortsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1824,
+    serialized_end=1872,
+)
+
+_ENDPOINTCONFIG = _descriptor.Descriptor(
+    name="EndpointConfig",
+    full_name="google.cloud.dataproc.v1beta2.EndpointConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_ports",
+            full_name="google.cloud.dataproc.v1beta2.EndpointConfig.http_ports",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_http_port_access",
+            full_name="google.cloud.dataproc.v1beta2.EndpointConfig.enable_http_port_access",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ENDPOINTCONFIG_HTTPPORTSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1691,
+    serialized_end=1872,
+)
+
+
+_AUTOSCALINGCONFIG = _descriptor.Descriptor(
+    name="AutoscalingConfig",
+    full_name="google.cloud.dataproc.v1beta2.AutoscalingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="policy_uri",
+            full_name="google.cloud.dataproc.v1beta2.AutoscalingConfig.policy_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1874,
+    serialized_end=1913,
+)
+
+
+_ENCRYPTIONCONFIG = _descriptor.Descriptor(
+    name="EncryptionConfig",
+    full_name="google.cloud.dataproc.v1beta2.EncryptionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gce_pd_kms_key_name",
+            full_name="google.cloud.dataproc.v1beta2.EncryptionConfig.gce_pd_kms_key_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1915,
+    serialized_end=1962,
+)
+
+
+_GCECLUSTERCONFIG_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2308,
+    serialized_end=2355,
+)
+
+_GCECLUSTERCONFIG = _descriptor.Descriptor(
+    name="GceClusterConfig",
+    full_name="google.cloud.dataproc.v1beta2.GceClusterConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="zone_uri",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.zone_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network_uri",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.network_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subnetwork_uri",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.subnetwork_uri",
+            index=2,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="internal_ip_only",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.internal_ip_only",
+            index=3,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.service_account",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_account_scopes",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.service_account_scopes",
+            index=5,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.tags",
+            index=6,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.metadata",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reservation_affinity",
+            full_name="google.cloud.dataproc.v1beta2.GceClusterConfig.reservation_affinity",
+            index=8,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GCECLUSTERCONFIG_METADATAENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1965,
+    serialized_end=2355,
+)
+
+
+_INSTANCEGROUPCONFIG = _descriptor.Descriptor(
+    name="InstanceGroupConfig",
+    full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="num_instances",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.num_instances",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_names",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.instance_names",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.image_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="machine_type_uri",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.machine_type_uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disk_config",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.disk_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_preemptible",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.is_preemptible",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="managed_group_config",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.managed_group_config",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerators",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.accelerators",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_cpu_platform",
+            full_name="google.cloud.dataproc.v1beta2.InstanceGroupConfig.min_cpu_platform",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2358,
+    serialized_end=2738,
+)
+
+
+_MANAGEDGROUPCONFIG = _descriptor.Descriptor(
+    name="ManagedGroupConfig",
+    full_name="google.cloud.dataproc.v1beta2.ManagedGroupConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance_template_name",
+            full_name="google.cloud.dataproc.v1beta2.ManagedGroupConfig.instance_template_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_group_manager_name",
+            full_name="google.cloud.dataproc.v1beta2.ManagedGroupConfig.instance_group_manager_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2740,
+    serialized_end=2829,
+)
+
+
+_ACCELERATORCONFIG = _descriptor.Descriptor(
+    name="AcceleratorConfig",
+    full_name="google.cloud.dataproc.v1beta2.AcceleratorConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="accelerator_type_uri",
+            full_name="google.cloud.dataproc.v1beta2.AcceleratorConfig.accelerator_type_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="accelerator_count",
+            full_name="google.cloud.dataproc.v1beta2.AcceleratorConfig.accelerator_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2831,
+    serialized_end=2907,
+)
+
+
+_DISKCONFIG = _descriptor.Descriptor(
+    name="DiskConfig",
+    full_name="google.cloud.dataproc.v1beta2.DiskConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="boot_disk_type",
+            full_name="google.cloud.dataproc.v1beta2.DiskConfig.boot_disk_type",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boot_disk_size_gb",
+            full_name="google.cloud.dataproc.v1beta2.DiskConfig.boot_disk_size_gb",
+            index=1,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_local_ssds",
+            full_name="google.cloud.dataproc.v1beta2.DiskConfig.num_local_ssds",
+            index=2,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2909,
+    serialized_end=2996,
+)
+
+
+_LIFECYCLECONFIG = _descriptor.Descriptor(
+    name="LifecycleConfig",
+    full_name="google.cloud.dataproc.v1beta2.LifecycleConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="idle_delete_ttl",
+            full_name="google.cloud.dataproc.v1beta2.LifecycleConfig.idle_delete_ttl",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auto_delete_time",
+            full_name="google.cloud.dataproc.v1beta2.LifecycleConfig.auto_delete_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auto_delete_ttl",
+            full_name="google.cloud.dataproc.v1beta2.LifecycleConfig.auto_delete_ttl",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="ttl",
+            full_name="google.cloud.dataproc.v1beta2.LifecycleConfig.ttl",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2999,
+    serialized_end=3185,
+)
+
+
+_SECURITYCONFIG = _descriptor.Descriptor(
+    name="SecurityConfig",
+    full_name="google.cloud.dataproc.v1beta2.SecurityConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kerberos_config",
+            full_name="google.cloud.dataproc.v1beta2.SecurityConfig.kerberos_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3187,
+    serialized_end=3275,
+)
+
+
+_KERBEROSCONFIG = _descriptor.Descriptor(
+    name="KerberosConfig",
+    full_name="google.cloud.dataproc.v1beta2.KerberosConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_kerberos",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.enable_kerberos",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="root_principal_password_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.root_principal_password_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kms_key_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.kms_key_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keystore_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.keystore_uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="truststore_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.truststore_uri",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keystore_password_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.keystore_password_uri",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_password_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.key_password_uri",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="truststore_password_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.truststore_password_uri",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cross_realm_trust_realm",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.cross_realm_trust_realm",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cross_realm_trust_kdc",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.cross_realm_trust_kdc",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cross_realm_trust_admin_server",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.cross_realm_trust_admin_server",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cross_realm_trust_shared_password_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.cross_realm_trust_shared_password_uri",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kdc_db_key_uri",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.kdc_db_key_uri",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tgt_lifetime_hours",
+            full_name="google.cloud.dataproc.v1beta2.KerberosConfig.tgt_lifetime_hours",
+            index=13,
+            number=14,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3278,
+    serialized_end=3716,
+)
+
+
+_NODEINITIALIZATIONACTION = _descriptor.Descriptor(
+    name="NodeInitializationAction",
+    full_name="google.cloud.dataproc.v1beta2.NodeInitializationAction",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="executable_file",
+            full_name="google.cloud.dataproc.v1beta2.NodeInitializationAction.executable_file",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="execution_timeout",
+            full_name="google.cloud.dataproc.v1beta2.NodeInitializationAction.execution_timeout",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3718,
+    serialized_end=3823,
+)
+
+
+_CLUSTERSTATUS = _descriptor.Descriptor(
+    name="ClusterStatus",
+    full_name="google.cloud.dataproc.v1beta2.ClusterStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1beta2.ClusterStatus.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detail",
+            full_name="google.cloud.dataproc.v1beta2.ClusterStatus.detail",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_start_time",
+            full_name="google.cloud.dataproc.v1beta2.ClusterStatus.state_start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="substate",
+            full_name="google.cloud.dataproc.v1beta2.ClusterStatus.substate",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CLUSTERSTATUS_STATE, _CLUSTERSTATUS_SUBSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3826,
+    serialized_end=4201,
+)
+
+
+_SOFTWARECONFIG_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.SoftwareConfig.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.SoftwareConfig.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.SoftwareConfig.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4399,
+    serialized_end=4448,
+)
+
+_SOFTWARECONFIG = _descriptor.Descriptor(
+    name="SoftwareConfig",
+    full_name="google.cloud.dataproc.v1beta2.SoftwareConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image_version",
+            full_name="google.cloud.dataproc.v1beta2.SoftwareConfig.image_version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.SoftwareConfig.properties",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="optional_components",
+            full_name="google.cloud.dataproc.v1beta2.SoftwareConfig.optional_components",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SOFTWARECONFIG_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4204,
+    serialized_end=4448,
+)
+
+
+_CLUSTERMETRICS_HDFSMETRICSENTRY = _descriptor.Descriptor(
+    name="HdfsMetricsEntry",
+    full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.HdfsMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.HdfsMetricsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.HdfsMetricsEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4641,
+    serialized_end=4691,
+)
+
+_CLUSTERMETRICS_YARNMETRICSENTRY = _descriptor.Descriptor(
+    name="YarnMetricsEntry",
+    full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.YarnMetricsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.YarnMetricsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.YarnMetricsEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4693,
+    serialized_end=4743,
+)
+
+_CLUSTERMETRICS = _descriptor.Descriptor(
+    name="ClusterMetrics",
+    full_name="google.cloud.dataproc.v1beta2.ClusterMetrics",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hdfs_metrics",
+            full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.hdfs_metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="yarn_metrics",
+            full_name="google.cloud.dataproc.v1beta2.ClusterMetrics.yarn_metrics",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTERMETRICS_HDFSMETRICSENTRY, _CLUSTERMETRICS_YARNMETRICSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4451,
+    serialized_end=4743,
+)
+
+
+_CREATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="CreateClusterRequest",
+    full_name="google.cloud.dataproc.v1beta2.CreateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.CreateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.CreateClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.cloud.dataproc.v1beta2.CreateClusterRequest.cluster",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1beta2.CreateClusterRequest.request_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4746,
+    serialized_end=4881,
+)
+
+
+_UPDATECLUSTERREQUEST = _descriptor.Descriptor(
+    name="UpdateClusterRequest",
+    full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.region",
+            index=1,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.cluster",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="graceful_decommission_timeout",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.graceful_decommission_timeout",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.update_mask",
+            index=5,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1beta2.UpdateClusterRequest.request_id",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4884,
+    serialized_end=5156,
+)
+
+
+_DELETECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DeleteClusterRequest",
+    full_name="google.cloud.dataproc.v1beta2.DeleteClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.DeleteClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.DeleteClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.DeleteClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1beta2.DeleteClusterRequest.cluster_uuid",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1beta2.DeleteClusterRequest.request_id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5158,
+    serialized_end=5280,
+)
+
+
+_GETCLUSTERREQUEST = _descriptor.Descriptor(
+    name="GetClusterRequest",
+    full_name="google.cloud.dataproc.v1beta2.GetClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.GetClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.GetClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.GetClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5282,
+    serialized_end=5359,
+)
+
+
+_LISTCLUSTERSREQUEST = _descriptor.Descriptor(
+    name="ListClustersRequest",
+    full_name="google.cloud.dataproc.v1beta2.ListClustersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersRequest.region",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersRequest.filter",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersRequest.page_size",
+            index=3,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersRequest.page_token",
+            index=4,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5361,
+    serialized_end=5473,
+)
+
+
+_LISTCLUSTERSRESPONSE = _descriptor.Descriptor(
+    name="ListClustersResponse",
+    full_name="google.cloud.dataproc.v1beta2.ListClustersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="clusters",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersResponse.clusters",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListClustersResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5475,
+    serialized_end=5580,
+)
+
+
+_DIAGNOSECLUSTERREQUEST = _descriptor.Descriptor(
+    name="DiagnoseClusterRequest",
+    full_name="google.cloud.dataproc.v1beta2.DiagnoseClusterRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.DiagnoseClusterRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.DiagnoseClusterRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.DiagnoseClusterRequest.cluster_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5582,
+    serialized_end=5664,
+)
+
+
+_DIAGNOSECLUSTERRESULTS = _descriptor.Descriptor(
+    name="DiagnoseClusterResults",
+    full_name="google.cloud.dataproc.v1beta2.DiagnoseClusterResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.dataproc.v1beta2.DiagnoseClusterResults.output_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5666,
+    serialized_end=5710,
+)
+
+
+_RESERVATIONAFFINITY = _descriptor.Descriptor(
+    name="ReservationAffinity",
+    full_name="google.cloud.dataproc.v1beta2.ReservationAffinity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="consume_reservation_type",
+            full_name="google.cloud.dataproc.v1beta2.ReservationAffinity.consume_reservation_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.ReservationAffinity.key",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.cloud.dataproc.v1beta2.ReservationAffinity.values",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_RESERVATIONAFFINITY_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5713,
+    serialized_end=5951,
+)
+
+_CLUSTER_LABELSENTRY.containing_type = _CLUSTER
+_CLUSTER.fields_by_name["config"].message_type = _CLUSTERCONFIG
+_CLUSTER.fields_by_name["labels"].message_type = _CLUSTER_LABELSENTRY
+_CLUSTER.fields_by_name["status"].message_type = _CLUSTERSTATUS
+_CLUSTER.fields_by_name["status_history"].message_type = _CLUSTERSTATUS
+_CLUSTER.fields_by_name["metrics"].message_type = _CLUSTERMETRICS
+_CLUSTERCONFIG.fields_by_name["gce_cluster_config"].message_type = _GCECLUSTERCONFIG
+_CLUSTERCONFIG.fields_by_name["master_config"].message_type = _INSTANCEGROUPCONFIG
+_CLUSTERCONFIG.fields_by_name["worker_config"].message_type = _INSTANCEGROUPCONFIG
+_CLUSTERCONFIG.fields_by_name[
+    "secondary_worker_config"
+].message_type = _INSTANCEGROUPCONFIG
+_CLUSTERCONFIG.fields_by_name["software_config"].message_type = _SOFTWARECONFIG
+_CLUSTERCONFIG.fields_by_name["lifecycle_config"].message_type = _LIFECYCLECONFIG
+_CLUSTERCONFIG.fields_by_name[
+    "initialization_actions"
+].message_type = _NODEINITIALIZATIONACTION
+_CLUSTERCONFIG.fields_by_name["encryption_config"].message_type = _ENCRYPTIONCONFIG
+_CLUSTERCONFIG.fields_by_name["autoscaling_config"].message_type = _AUTOSCALINGCONFIG
+_CLUSTERCONFIG.fields_by_name["endpoint_config"].message_type = _ENDPOINTCONFIG
+_CLUSTERCONFIG.fields_by_name["security_config"].message_type = _SECURITYCONFIG
+_ENDPOINTCONFIG_HTTPPORTSENTRY.containing_type = _ENDPOINTCONFIG
+_ENDPOINTCONFIG.fields_by_name[
+    "http_ports"
+].message_type = _ENDPOINTCONFIG_HTTPPORTSENTRY
+_GCECLUSTERCONFIG_METADATAENTRY.containing_type = _GCECLUSTERCONFIG
+_GCECLUSTERCONFIG.fields_by_name[
+    "metadata"
+].message_type = _GCECLUSTERCONFIG_METADATAENTRY
+_GCECLUSTERCONFIG.fields_by_name[
+    "reservation_affinity"
+].message_type = _RESERVATIONAFFINITY
+_INSTANCEGROUPCONFIG.fields_by_name["disk_config"].message_type = _DISKCONFIG
+_INSTANCEGROUPCONFIG.fields_by_name[
+    "managed_group_config"
+].message_type = _MANAGEDGROUPCONFIG
+_INSTANCEGROUPCONFIG.fields_by_name["accelerators"].message_type = _ACCELERATORCONFIG
+_LIFECYCLECONFIG.fields_by_name[
+    "idle_delete_ttl"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LIFECYCLECONFIG.fields_by_name[
+    "auto_delete_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LIFECYCLECONFIG.fields_by_name[
+    "auto_delete_ttl"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LIFECYCLECONFIG.oneofs_by_name["ttl"].fields.append(
+    _LIFECYCLECONFIG.fields_by_name["auto_delete_time"]
+)
+_LIFECYCLECONFIG.fields_by_name[
+    "auto_delete_time"
+].containing_oneof = _LIFECYCLECONFIG.oneofs_by_name["ttl"]
+_LIFECYCLECONFIG.oneofs_by_name["ttl"].fields.append(
+    _LIFECYCLECONFIG.fields_by_name["auto_delete_ttl"]
+)
+_LIFECYCLECONFIG.fields_by_name[
+    "auto_delete_ttl"
+].containing_oneof = _LIFECYCLECONFIG.oneofs_by_name["ttl"]
+_SECURITYCONFIG.fields_by_name["kerberos_config"].message_type = _KERBEROSCONFIG
+_NODEINITIALIZATIONACTION.fields_by_name[
+    "execution_timeout"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_CLUSTERSTATUS.fields_by_name["state"].enum_type = _CLUSTERSTATUS_STATE
+_CLUSTERSTATUS.fields_by_name[
+    "state_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CLUSTERSTATUS.fields_by_name["substate"].enum_type = _CLUSTERSTATUS_SUBSTATE
+_CLUSTERSTATUS_STATE.containing_type = _CLUSTERSTATUS
+_CLUSTERSTATUS_SUBSTATE.containing_type = _CLUSTERSTATUS
+_SOFTWARECONFIG_PROPERTIESENTRY.containing_type = _SOFTWARECONFIG
+_SOFTWARECONFIG.fields_by_name[
+    "properties"
+].message_type = _SOFTWARECONFIG_PROPERTIESENTRY
+_SOFTWARECONFIG.fields_by_name[
+    "optional_components"
+].enum_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_shared__pb2._COMPONENT
+)
+_CLUSTERMETRICS_HDFSMETRICSENTRY.containing_type = _CLUSTERMETRICS
+_CLUSTERMETRICS_YARNMETRICSENTRY.containing_type = _CLUSTERMETRICS
+_CLUSTERMETRICS.fields_by_name[
+    "hdfs_metrics"
+].message_type = _CLUSTERMETRICS_HDFSMETRICSENTRY
+_CLUSTERMETRICS.fields_by_name[
+    "yarn_metrics"
+].message_type = _CLUSTERMETRICS_YARNMETRICSENTRY
+_CREATECLUSTERREQUEST.fields_by_name["cluster"].message_type = _CLUSTER
+_UPDATECLUSTERREQUEST.fields_by_name["cluster"].message_type = _CLUSTER
+_UPDATECLUSTERREQUEST.fields_by_name[
+    "graceful_decommission_timeout"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_UPDATECLUSTERREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTCLUSTERSRESPONSE.fields_by_name["clusters"].message_type = _CLUSTER
+_RESERVATIONAFFINITY.fields_by_name[
+    "consume_reservation_type"
+].enum_type = _RESERVATIONAFFINITY_TYPE
+_RESERVATIONAFFINITY_TYPE.containing_type = _RESERVATIONAFFINITY
+DESCRIPTOR.message_types_by_name["Cluster"] = _CLUSTER
+DESCRIPTOR.message_types_by_name["ClusterConfig"] = _CLUSTERCONFIG
+DESCRIPTOR.message_types_by_name["EndpointConfig"] = _ENDPOINTCONFIG
+DESCRIPTOR.message_types_by_name["AutoscalingConfig"] = _AUTOSCALINGCONFIG
+DESCRIPTOR.message_types_by_name["EncryptionConfig"] = _ENCRYPTIONCONFIG
+DESCRIPTOR.message_types_by_name["GceClusterConfig"] = _GCECLUSTERCONFIG
+DESCRIPTOR.message_types_by_name["InstanceGroupConfig"] = _INSTANCEGROUPCONFIG
+DESCRIPTOR.message_types_by_name["ManagedGroupConfig"] = _MANAGEDGROUPCONFIG
+DESCRIPTOR.message_types_by_name["AcceleratorConfig"] = _ACCELERATORCONFIG
+DESCRIPTOR.message_types_by_name["DiskConfig"] = _DISKCONFIG
+DESCRIPTOR.message_types_by_name["LifecycleConfig"] = _LIFECYCLECONFIG
+DESCRIPTOR.message_types_by_name["SecurityConfig"] = _SECURITYCONFIG
+DESCRIPTOR.message_types_by_name["KerberosConfig"] = _KERBEROSCONFIG
+DESCRIPTOR.message_types_by_name["NodeInitializationAction"] = _NODEINITIALIZATIONACTION
+DESCRIPTOR.message_types_by_name["ClusterStatus"] = _CLUSTERSTATUS
+DESCRIPTOR.message_types_by_name["SoftwareConfig"] = _SOFTWARECONFIG
+DESCRIPTOR.message_types_by_name["ClusterMetrics"] = _CLUSTERMETRICS
+DESCRIPTOR.message_types_by_name["CreateClusterRequest"] = _CREATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateClusterRequest"] = _UPDATECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["DeleteClusterRequest"] = _DELETECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["GetClusterRequest"] = _GETCLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersRequest"] = _LISTCLUSTERSREQUEST
+DESCRIPTOR.message_types_by_name["ListClustersResponse"] = _LISTCLUSTERSRESPONSE
+DESCRIPTOR.message_types_by_name["DiagnoseClusterRequest"] = _DIAGNOSECLUSTERREQUEST
+DESCRIPTOR.message_types_by_name["DiagnoseClusterResults"] = _DIAGNOSECLUSTERRESULTS
+DESCRIPTOR.message_types_by_name["ReservationAffinity"] = _RESERVATIONAFFINITY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Cluster = _reflection.GeneratedProtocolMessageType(
+    "Cluster",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTER_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.Cluster.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTER,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Describes the identifying information, config, and status of a cluster
+  of Compute Engine instances.
+  
+  
+  Attributes:
+      project_id:
+          Required. The Google Cloud Platform project ID that the
+          cluster belongs to.
+      cluster_name:
+          Required. The cluster name. Cluster names within a project
+          must be unique. Names of deleted clusters can be reused.
+      config:
+          Required. The cluster config. Note that Cloud Dataproc may set
+          default values, and values may change when clusters are
+          updated.
+      labels:
+          Optional. The labels to associate with this cluster. Label
+          **keys** must contain 1 to 63 characters, and must conform to
+          `RFC 1035 <https://www.ietf.org/rfc/rfc1035.txt>`__. Label
+          **values** may be empty, but, if present, must contain 1 to 63
+          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.
+      status:
+          Output only. Cluster status.
+      status_history:
+          Output only. The previous cluster status.
+      cluster_uuid:
+          Output only. A cluster UUID (Unique Universal Identifier).
+          Cloud Dataproc generates this value when it creates the
+          cluster.
+      metrics:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.Cluster)
+    ),
+)
+_sym_db.RegisterMessage(Cluster)
+_sym_db.RegisterMessage(Cluster.LabelsEntry)
+
+ClusterConfig = _reflection.GeneratedProtocolMessageType(
+    "ClusterConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""The cluster config.
+  
+  
+  Attributes:
+      config_bucket:
+          Optional. A Google 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 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>`__).
+      gce_cluster_config:
+          Optional. The shared Compute Engine config settings for all
+          instances in a cluster.
+      master_config:
+          Optional. The Compute Engine config settings for the master
+          instance in a cluster.
+      worker_config:
+          Optional. The Compute Engine config settings for worker
+          instances in a cluster.
+      secondary_worker_config:
+          Optional. The Compute Engine config settings for additional
+          worker instances in a cluster.
+      software_config:
+          Optional. The config settings for software inside the cluster.
+      lifecycle_config:
+          Optional. The config setting for auto delete cluster schedule.
+      initialization_actions:
+          Optional. Commands to execute on each node after config is
+          completed. By default, executables are run on master and all
+          worker nodes. You can test a node's role metadata to run an
+          executable on a master or worker node, as shown below using
+          ``curl`` (you can also use ``wget``):  ::      ROLE=$(curl -H
+          Metadata-Flavor:Google     http://metadata/computeMetadata/v1b
+          eta2/instance/attributes/dataproc-role)     if [[ "${ROLE}" ==
+          'Master' ]]; then       ... master specific actions ...
+          else       ... worker specific actions ...     fi
+      encryption_config:
+          Optional. Encryption settings for the cluster.
+      autoscaling_config:
+          Optional. Autoscaling config for the policy associated with
+          the cluster. Cluster does not autoscale if this field is
+          unset.
+      endpoint_config:
+          Optional. Port/endpoint configuration for this cluster
+      security_config:
+          Optional. Security related configuration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterConfig)
+    ),
+)
+_sym_db.RegisterMessage(ClusterConfig)
+
+EndpointConfig = _reflection.GeneratedProtocolMessageType(
+    "EndpointConfig",
+    (_message.Message,),
+    dict(
+        HttpPortsEntry=_reflection.GeneratedProtocolMessageType(
+            "HttpPortsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ENDPOINTCONFIG_HTTPPORTSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.EndpointConfig.HttpPortsEntry)
+            ),
+        ),
+        DESCRIPTOR=_ENDPOINTCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Endpoint config for this cluster
+  
+  
+  Attributes:
+      http_ports:
+          Output only. The map of port descriptions to URLs. Will only
+          be populated if enable\_http\_port\_access is true.
+      enable_http_port_access:
+          Optional. If true, enable http access to specific ports on the
+          cluster from external sources. Defaults to false.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.EndpointConfig)
+    ),
+)
+_sym_db.RegisterMessage(EndpointConfig)
+_sym_db.RegisterMessage(EndpointConfig.HttpPortsEntry)
+
+AutoscalingConfig = _reflection.GeneratedProtocolMessageType(
+    "AutoscalingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AUTOSCALINGCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Autoscaling Policy config associated with the cluster.
+  
+  
+  Attributes:
+      policy_uri:
+          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/p
+          rojects/[project_id]/locations/[dataproc_region]/autoscalingPo
+          licies/[policy_id]`` -  ``projects/[project_id]/locations/[dat
+          aproc_region]/autoscalingPolicies/[policy_id]``  Note that the
+          policy must be in the same project and Cloud Dataproc region.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.AutoscalingConfig)
+    ),
+)
+_sym_db.RegisterMessage(AutoscalingConfig)
+
+EncryptionConfig = _reflection.GeneratedProtocolMessageType(
+    "EncryptionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENCRYPTIONCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Encryption settings for the cluster.
+  
+  
+  Attributes:
+      gce_pd_kms_key_name:
+          Optional. The Cloud KMS key name to use for PD disk encryption
+          for all instances in the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.EncryptionConfig)
+    ),
+)
+_sym_db.RegisterMessage(EncryptionConfig)
+
+GceClusterConfig = _reflection.GeneratedProtocolMessageType(
+    "GceClusterConfig",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GCECLUSTERCONFIG_METADATAENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.GceClusterConfig.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_GCECLUSTERCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Common config settings for resources of Compute Engine cluster
+  instances, applicable to all instances in the cluster.
+  
+  
+  Attributes:
+      zone_uri:
+          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 corresponding Compute Engine
+          region. On a get request, zone will always be present.  A full
+          URL, partial URI, or short name are valid. Examples:  -  ``htt
+          ps://www.googleapis.com/compute/v1/projects/[project_id]/zones
+          /[zone]`` -  ``projects/[project_id]/zones/[zone]`` -  ``us-
+          central1-f``
+      network_uri:
+          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).  A full
+          URL, partial URI, or short name are valid. Examples:  -  ``htt
+          ps://www.googleapis.com/compute/v1/projects/[project_id]/regio
+          ns/global/default`` -
+          ``projects/[project_id]/regions/global/default`` -
+          ``default``
+      subnetwork_uri:
+          Optional. The Compute Engine subnetwork to be used for machine
+          communications. Cannot be specified with network\_uri.  A full
+          URL, partial URI, or short name are valid. Examples:  -  ``htt
+          ps://www.googleapis.com/compute/v1/projects/[project_id]/regio
+          ns/us-east1/subnetworks/sub0`` -
+          ``projects/[project_id]/regions/us-east1/subnetworks/sub0`` -
+          ``sub0``
+      internal_ip_only:
+          Optional. If true, all instances in the cluster will only have
+          internal IP addresses. By default, clusters are not restricted
+          to internal IP addresses, and will have ephemeral external IP
+          addresses assigned to each 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.
+      service_account:
+          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:  -  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``
+      service_account_scopes:
+          Optional. The URIs of service account scopes to be included in
+          Compute Engine instances. The following base set of scopes is
+          always included:  -
+          https://www.googleapis.com/auth/cloud.useraccounts.readonly -
+          https://www.googleapis.com/auth/devstorage.read\_write -
+          https://www.googleapis.com/auth/logging.write  If no scopes
+          are specified, the following defaults are also provided:  -
+          https://www.googleapis.com/auth/bigquery -
+          https://www.googleapis.com/auth/bigtable.admin.table -
+          https://www.googleapis.com/auth/bigtable.data -
+          https://www.googleapis.com/auth/devstorage.full\_control
+      tags:
+          The Compute Engine tags to add to all instances (see `Tagging
+          instances </compute/docs/label-or-tag-resources#tags>`__).
+      metadata:
+          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>`__).
+      reservation_affinity:
+          Optional. Reservation Affinity for consuming Zonal
+          reservation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.GceClusterConfig)
+    ),
+)
+_sym_db.RegisterMessage(GceClusterConfig)
+_sym_db.RegisterMessage(GceClusterConfig.MetadataEntry)
+
+InstanceGroupConfig = _reflection.GeneratedProtocolMessageType(
+    "InstanceGroupConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTANCEGROUPCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Optional. The config settings for Compute Engine resources in an
+  instance group, such as a master or worker group.
+  
+  
+  Attributes:
+      num_instances:
+          Optional. The number of VM instances in the instance group.
+          For master instance groups, must be set to 1.
+      instance_names:
+          Output only. The list of instance names. Cloud Dataproc
+          derives the names from ``cluster_name``, ``num_instances``,
+          and the instance group.
+      image_uri:
+          Optional. The Compute Engine image resource used for cluster
+          instances. It can be specified or may be inferred from
+          ``SoftwareConfig.image_version``.
+      machine_type_uri:
+          Optional. The Compute Engine machine type used for cluster
+          instances.  A full URL, partial URI, or short name are valid.
+          Examples:  -  ``https://www.googleapis.com/compute/v1/projects
+          /[project_id]/zones/us-east1-a/machineTypes/n1-standard-2`` -
+          ``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 Placement </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``.
+      disk_config:
+          Optional. Disk option config settings.
+      is_preemptible:
+          Optional. Specifies that this instance group contains
+          preemptible instances.
+      managed_group_config:
+          Output only. The config for Compute Engine Instance Group
+          Manager that manages this group. This is only used for
+          preemptible instance groups.
+      accelerators:
+          Optional. The Compute Engine accelerator configuration for
+          these instances.  **Beta Feature**: This feature is still
+          under development. It may be changed before final release.
+      min_cpu_platform:
+          Optional. Specifies the minimum cpu platform for the Instance
+          Group. See [Cloud Dataproc→Minimum CPU Platform]
+          (/dataproc/docs/concepts/compute/dataproc-min-cpu).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.InstanceGroupConfig)
+    ),
+)
+_sym_db.RegisterMessage(InstanceGroupConfig)
+
+ManagedGroupConfig = _reflection.GeneratedProtocolMessageType(
+    "ManagedGroupConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MANAGEDGROUPCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies the resources used to actively manage an instance group.
+  
+  
+  Attributes:
+      instance_template_name:
+          Output only. The name of the Instance Template used for the
+          Managed Instance Group.
+      instance_group_manager_name:
+          Output only. The name of the Instance Group Manager for this
+          group.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ManagedGroupConfig)
+    ),
+)
+_sym_db.RegisterMessage(ManagedGroupConfig)
+
+AcceleratorConfig = _reflection.GeneratedProtocolMessageType(
+    "AcceleratorConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACCELERATORCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies the type and number of accelerator cards attached to the
+  instances of an instance group (see `GPUs on Compute
+  Engine </compute/docs/gpus/>`__).
+  
+  
+  Attributes:
+      accelerator_type_uri:
+          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>`__  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 Placement
+          </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``.
+      accelerator_count:
+          The number of the accelerator cards of this type exposed to
+          this instance.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.AcceleratorConfig)
+    ),
+)
+_sym_db.RegisterMessage(AcceleratorConfig)
+
+DiskConfig = _reflection.GeneratedProtocolMessageType(
+    "DiskConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DISKCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies the config of disk options for a group of VM instances.
+  
+  
+  Attributes:
+      boot_disk_type:
+          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).
+      boot_disk_size_gb:
+          Optional. Size in GB of the boot disk (default is 500GB).
+      num_local_ssds:
+          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 `HDFS <https://hadoop.apache.org/docs/r1.2.1/
+          hdfs_user_guide.html>`__ data. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DiskConfig)
+    ),
+)
+_sym_db.RegisterMessage(DiskConfig)
+
+LifecycleConfig = _reflection.GeneratedProtocolMessageType(
+    "LifecycleConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LIFECYCLECONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies the cluster auto-delete schedule configuration.
+  
+  
+  Attributes:
+      idle_delete_ttl:
+          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.
+      ttl:
+          Optional. Either the exact time the cluster should be deleted
+          at or the cluster maximum age.
+      auto_delete_time:
+          Optional. The time when cluster will be auto-deleted.
+      auto_delete_ttl:
+          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..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.LifecycleConfig)
+    ),
+)
+_sym_db.RegisterMessage(LifecycleConfig)
+
+SecurityConfig = _reflection.GeneratedProtocolMessageType(
+    "SecurityConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SECURITYCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Security related configuration, including encryption, Kerberos, etc.
+  
+  
+  Attributes:
+      kerberos_config:
+          Kerberos related configuration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SecurityConfig)
+    ),
+)
+_sym_db.RegisterMessage(SecurityConfig)
+
+KerberosConfig = _reflection.GeneratedProtocolMessageType(
+    "KerberosConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KERBEROSCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies Kerberos related configuration.
+  
+  
+  Attributes:
+      enable_kerberos:
+          Optional. Flag to indicate whether to Kerberize the cluster.
+      root_principal_password_uri:
+          Required. The Cloud Storage URI of a KMS encrypted file
+          containing the root principal password.
+      kms_key_uri:
+          Required. The uri of the KMS key used to encrypt various
+          sensitive files.
+      keystore_uri:
+          Optional. The Cloud Storage URI of the keystore file used for
+          SSL encryption. If not provided, Dataproc will provide a self-
+          signed certificate.
+      truststore_uri:
+          Optional. The Cloud Storage URI of the truststore file used
+          for SSL encryption. If not provided, Dataproc will provide a
+          self-signed certificate.
+      keystore_password_uri:
+          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.
+      key_password_uri:
+          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.
+      truststore_password_uri:
+          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.
+      cross_realm_trust_realm:
+          Optional. The remote realm the Dataproc on-cluster KDC will
+          trust, should the user enable cross realm trust.
+      cross_realm_trust_kdc:
+          Optional. The KDC (IP or hostname) for the remote trusted
+          realm in a cross realm trust relationship.
+      cross_realm_trust_admin_server:
+          Optional. The admin server (IP or hostname) for the remote
+          trusted realm in a cross realm trust relationship.
+      cross_realm_trust_shared_password_uri:
+          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.
+      kdc_db_key_uri:
+          Optional. The Cloud Storage URI of a KMS encrypted file
+          containing the master key of the KDC database.
+      tgt_lifetime_hours:
+          Optional. The lifetime of the ticket granting ticket, in
+          hours. If not specified, or user specifies 0, then default
+          value 10 will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.KerberosConfig)
+    ),
+)
+_sym_db.RegisterMessage(KerberosConfig)
+
+NodeInitializationAction = _reflection.GeneratedProtocolMessageType(
+    "NodeInitializationAction",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NODEINITIALIZATIONACTION,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies an executable to run on a fully configured node and a timeout
+  period for executable completion.
+  
+  
+  Attributes:
+      executable_file:
+          Required. Cloud Storage URI of executable file.
+      execution_timeout:
+          Optional. Amount of time executable has to complete. Default
+          is 10 minutes. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.NodeInitializationAction)
+    ),
+)
+_sym_db.RegisterMessage(NodeInitializationAction)
+
+ClusterStatus = _reflection.GeneratedProtocolMessageType(
+    "ClusterStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTERSTATUS,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""The status of a cluster and its instances.
+  
+  
+  Attributes:
+      state:
+          Output only. The cluster's state.
+      detail:
+          Output only. Optional details of cluster's state.
+      state_start_time:
+          Output only. Time when this state was entered.
+      substate:
+          Output only. Additional state information that includes status
+          reported by the agent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterStatus)
+    ),
+)
+_sym_db.RegisterMessage(ClusterStatus)
+
+SoftwareConfig = _reflection.GeneratedProtocolMessageType(
+    "SoftwareConfig",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SOFTWARECONFIG_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SoftwareConfig.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SOFTWARECONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Specifies the selection and config of software inside the cluster.
+  
+  
+  Attributes:
+      image_version:
+          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>`__, 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>`__. If unspecified, it defaults to
+          the latest Debian version.
+      properties:
+          Optional. The properties to set on daemon config files.
+          Property keys are specified in ``prefix:property`` format, for
+          example ``core:hadoop.tmp.dir``. The following are supported
+          prefixes and their mappings:  -  capacity-scheduler:
+          ``capacity-scheduler.xml`` -  core: ``core-site.xml`` -
+          distcp: ``distcp-default.xml`` -  hdfs: ``hdfs-site.xml`` -
+          hive: ``hive-site.xml`` -  mapred: ``mapred-site.xml`` -  pig:
+          ``pig.properties`` -  spark: ``spark-defaults.conf`` -  yarn:
+          ``yarn-site.xml``  For more information, see `Cluster
+          properties </dataproc/docs/concepts/cluster-properties>`__.
+      optional_components:
+          The set of optional components to activate on the cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SoftwareConfig)
+    ),
+)
+_sym_db.RegisterMessage(SoftwareConfig)
+_sym_db.RegisterMessage(SoftwareConfig.PropertiesEntry)
+
+ClusterMetrics = _reflection.GeneratedProtocolMessageType(
+    "ClusterMetrics",
+    (_message.Message,),
+    dict(
+        HdfsMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "HdfsMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTERMETRICS_HDFSMETRICSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterMetrics.HdfsMetricsEntry)
+            ),
+        ),
+        YarnMetricsEntry=_reflection.GeneratedProtocolMessageType(
+            "YarnMetricsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTERMETRICS_YARNMETRICSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterMetrics.YarnMetricsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTERMETRICS,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      hdfs_metrics:
+          The HDFS metrics.
+      yarn_metrics:
+          The YARN metrics.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterMetrics)
+    ),
+)
+_sym_db.RegisterMessage(ClusterMetrics)
+_sym_db.RegisterMessage(ClusterMetrics.HdfsMetricsEntry)
+_sym_db.RegisterMessage(ClusterMetrics.YarnMetricsEntry)
+
+CreateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""A request to create a cluster.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster:
+          Required. The cluster to create.
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [CreateClusterRequest][google.cloud.datapr
+          oc.v1beta2.CreateClusterRequest] requests with the same id,
+          then the second request will be ignored and the first
+          [google.longrunning.Operation][google.longrunning.Operation]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.CreateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateClusterRequest)
+
+UpdateClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""A request to update a cluster.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+      cluster:
+          Required. The changes to the cluster.
+      graceful_decommission_timeout:
+          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.  Only supported on Dataproc image versions 1.2 and
+          higher.
+      update_mask:
+          Required. Specifies the path, relative to ``Cluster``, of the
+          field to update. For example, to change the number of workers
+          in a cluster to 5, the ``update_mask`` parameter would be
+          specified as ``config.worker_config.num_instances``, and the
+          ``PATCH`` request body would specify the new value, as
+          follows:  ::      {       "config":{         "workerConfig":{
+          "numInstances":"5"         }       }     }  Similarly, to
+          change the number of preemptible workers in a cluster to 5,
+          the ``update_mask`` parameter would be
+          ``config.secondary_worker_config.num_instances``, and the
+          ``PATCH`` request body would be set as follows:  ::      {
+          "config":{         "secondaryWorkerConfig":{
+          "numInstances":"5"         }       }     }  Note: currently
+          only the following fields can be updated:  .. raw:: html
+          <table>  .. raw:: html     <tr>  .. raw:: html     <td>  Mask
+          .. raw:: html     </td>  .. raw:: html     <td>  Purpose  ..
+          raw:: html     </td>  .. raw:: html     </tr>  .. raw:: html
+          <tr>  .. raw:: html     <td>  labels  .. raw:: html     </td>
+          .. raw:: html     <td>  Updates labels  .. raw:: html
+          </td>  .. raw:: html     </tr>  .. raw:: html     <tr>  ..
+          raw:: html     <td>  config.worker\_config.num\_instances  ..
+          raw:: html     </td>  .. raw:: html     <td>  Resize primary
+          worker group  .. raw:: html     </td>  .. raw:: html     </tr>
+          .. raw:: html     <tr>  .. raw:: html     <td>
+          config.secondary\_worker\_config.num\_instances  .. raw:: html
+          </td>  .. raw:: html     <td>  Resize secondary worker group
+          .. raw:: html     </td>  .. raw:: html     </tr>  .. raw::
+          html     <tr>  .. raw:: html     <td>
+          config.lifecycle\_config.auto\_delete\_ttl  .. raw:: html
+          </td>  .. raw:: html     <td>  Reset MAX TTL duration  ..
+          raw:: html     </td>  .. raw:: html     </tr>  .. raw:: html
+          <tr>  .. raw:: html     <td>
+          config.lifecycle\_config.auto\_delete\_time  .. raw:: html
+          </td>  .. raw:: html     <td>  Update MAX TTL deletion
+          timestamp  .. raw:: html     </td>  .. raw:: html     </tr>
+          .. raw:: html     <tr>  .. raw:: html     <td>
+          config.lifecycle\_config.idle\_delete\_ttl  .. raw:: html
+          </td>  .. raw:: html     <td>  Update Idle TTL duration  ..
+          raw:: html     </td>  .. raw:: html     </tr>  .. raw:: html
+          <tr>  .. raw:: html     <td>
+          config.autoscaling\_config.policy\_uri  .. raw:: html
+          </td>  .. raw:: html     <td>  Use, stop using, or change
+          autoscaling policies  .. raw:: html     </td>  .. raw:: html
+          </tr>  .. raw:: html     </table>
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [UpdateClusterRequest][google.cloud.datapr
+          oc.v1beta2.UpdateClusterRequest] requests with the same id,
+          then the second request will be ignored and the first
+          [google.longrunning.Operation][google.longrunning.Operation]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.UpdateClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateClusterRequest)
+
+DeleteClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""A request to delete a cluster.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+      cluster_uuid:
+          Optional. Specifying the ``cluster_uuid`` means the RPC should
+          fail (with error NOT\_FOUND) if cluster with specified UUID
+          does not exist.
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [DeleteClusterRequest][google.cloud.datapr
+          oc.v1beta2.DeleteClusterRequest] requests with the same id,
+          then the second request will be ignored and the first
+          [google.longrunning.Operation][google.longrunning.Operation]
+          created and stored in the backend is returned.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The id
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DeleteClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteClusterRequest)
+
+GetClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "GetClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Request to get the resource representation for a cluster in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.GetClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetClusterRequest)
+
+ListClustersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListClustersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""A request to list the clusters in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      filter:
+          Optional. A filter constraining the clusters to list. Filters
+          are case-sensitive and have the following syntax:  field =
+          value [AND [field = value]] ...  where **field** is one of
+          ``status.state``, ``clusterName``, or ``labels.[KEY]``, and
+          ``[KEY]`` is a label key. **value** can be ``*`` to match all
+          values. ``status.state`` can be one of the following:
+          ``ACTIVE``, ``INACTIVE``, ``CREATING``, ``RUNNING``,
+          ``ERROR``, ``DELETING``, or ``UPDATING``. ``ACTIVE`` contains
+          the ``CREATING``, ``UPDATING``, and ``RUNNING`` states.
+          ``INACTIVE`` contains the ``DELETING`` and ``ERROR`` states.
+          ``clusterName`` is the name of the cluster provided at
+          creation time. Only the logical ``AND`` operator is supported;
+          space-separated items are treated as having an implicit
+          ``AND`` operator.  Example filter:  status.state = ACTIVE AND
+          clusterName = mycluster AND labels.env = staging AND
+          labels.starred = \*
+      page_size:
+          Optional. The standard List page size.
+      page_token:
+          Optional. The standard List page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListClustersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersRequest)
+
+ListClustersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListClustersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCLUSTERSRESPONSE,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""The list of all clusters in a project.
+  
+  
+  Attributes:
+      clusters:
+          Output only. The clusters in the project.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListClustersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListClustersResponse)
+
+DiagnoseClusterRequest = _reflection.GeneratedProtocolMessageType(
+    "DiagnoseClusterRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DIAGNOSECLUSTERREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""A request to collect cluster diagnostic information.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          cluster belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      cluster_name:
+          Required. The cluster name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DiagnoseClusterRequest)
+    ),
+)
+_sym_db.RegisterMessage(DiagnoseClusterRequest)
+
+DiagnoseClusterResults = _reflection.GeneratedProtocolMessageType(
+    "DiagnoseClusterResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DIAGNOSECLUSTERRESULTS,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""The location of diagnostic output.
+  
+  
+  Attributes:
+      output_uri:
+          Output only. The Cloud Storage URI of the diagnostic output.
+          The output report is a plain text file with a summary of
+          collected diagnostics.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DiagnoseClusterResults)
+    ),
+)
+_sym_db.RegisterMessage(DiagnoseClusterResults)
+
+ReservationAffinity = _reflection.GeneratedProtocolMessageType(
+    "ReservationAffinity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESERVATIONAFFINITY,
+        __module__="google.cloud.dataproc_v1beta2.proto.clusters_pb2",
+        __doc__="""Reservation Affinity for consuming Zonal reservation.
+  
+  
+  Attributes:
+      consume_reservation_type:
+          Optional. Type of reservation to consume
+      key:
+          Optional. Corresponds to the label key of reservation
+          resource.
+      values:
+          Optional. Corresponds to the label values of reservation
+          resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ReservationAffinity)
+    ),
+)
+_sym_db.RegisterMessage(ReservationAffinity)
+
+
+DESCRIPTOR._options = None
+_CLUSTER_LABELSENTRY._options = None
+_ENDPOINTCONFIG_HTTPPORTSENTRY._options = None
+_GCECLUSTERCONFIG_METADATAENTRY._options = None
+_SOFTWARECONFIG_PROPERTIESENTRY._options = None
+_CLUSTERMETRICS_HDFSMETRICSENTRY._options = None
+_CLUSTERMETRICS_YARNMETRICSENTRY._options = None
+
+_CLUSTERCONTROLLER = _descriptor.ServiceDescriptor(
+    name="ClusterController",
+    full_name="google.cloud.dataproc.v1beta2.ClusterController",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=5954,
+    serialized_end=7098,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateCluster",
+            full_name="google.cloud.dataproc.v1beta2.ClusterController.CreateCluster",
+            index=0,
+            containing_service=None,
+            input_type=_CREATECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002C"8/v1beta2/projects/{project_id}/regions/{region}/clusters:\007cluster'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCluster",
+            full_name="google.cloud.dataproc.v1beta2.ClusterController.UpdateCluster",
+            index=1,
+            containing_service=None,
+            input_type=_UPDATECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002R2G/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}:\007cluster"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteCluster",
+            full_name="google.cloud.dataproc.v1beta2.ClusterController.DeleteCluster",
+            index=2,
+            containing_service=None,
+            input_type=_DELETECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002I*G/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCluster",
+            full_name="google.cloud.dataproc.v1beta2.ClusterController.GetCluster",
+            index=3,
+            containing_service=None,
+            input_type=_GETCLUSTERREQUEST,
+            output_type=_CLUSTER,
+            serialized_options=_b(
+                "\202\323\344\223\002I\022G/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListClusters",
+            full_name="google.cloud.dataproc.v1beta2.ClusterController.ListClusters",
+            index=4,
+            containing_service=None,
+            input_type=_LISTCLUSTERSREQUEST,
+            output_type=_LISTCLUSTERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002:\0228/v1beta2/projects/{project_id}/regions/{region}/clusters"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DiagnoseCluster",
+            full_name="google.cloud.dataproc.v1beta2.ClusterController.DiagnoseCluster",
+            index=5,
+            containing_service=None,
+            input_type=_DIAGNOSECLUSTERREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002U"P/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLUSTERCONTROLLER)
+
+DESCRIPTOR.services_by_name["ClusterController"] = _CLUSTERCONTROLLER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/clusters_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1beta2/proto/clusters_pb2_grpc.py
new file mode 100644
index 000000000000..aa8da2e86652
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/clusters_pb2_grpc.py
@@ -0,0 +1,141 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1beta2.proto import (
+    clusters_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class ClusterControllerStub(object):
+    """The ClusterControllerService provides methods to manage clusters
+  of Compute Engine instances.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.ClusterController/CreateCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.CreateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.ClusterController/UpdateCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.UpdateClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.ClusterController/DeleteCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.DeleteClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.ClusterController/GetCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.GetClusterRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.Cluster.FromString,
+        )
+        self.ListClusters = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.ClusterController/ListClusters",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.ListClustersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.ListClustersResponse.FromString,
+        )
+        self.DiagnoseCluster = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.ClusterController/DiagnoseCluster",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.DiagnoseClusterRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ClusterControllerServicer(object):
+    """The ClusterControllerService provides methods to manage clusters
+  of Compute Engine instances.
+  """
+
+    def CreateCluster(self, request, context):
+        """Creates a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCluster(self, request, context):
+        """Updates a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteCluster(self, request, context):
+        """Deletes a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCluster(self, request, context):
+        """Gets the resource representation for a cluster in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListClusters(self, request, context):
+        """Lists all regions/{region}/clusters in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DiagnoseCluster(self, request, context):
+        """Gets cluster diagnostic information.
+    After the operation completes, the Operation.response field
+    contains `DiagnoseClusterOutputLocation`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ClusterControllerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.CreateClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.UpdateClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.DeleteClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.GetClusterRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.Cluster.SerializeToString,
+        ),
+        "ListClusters": grpc.unary_unary_rpc_method_handler(
+            servicer.ListClusters,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.ListClustersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.ListClustersResponse.SerializeToString,
+        ),
+        "DiagnoseCluster": grpc.unary_unary_rpc_method_handler(
+            servicer.DiagnoseCluster,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.DiagnoseClusterRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1beta2.ClusterController", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/jobs.proto b/dataproc/google/cloud/dataproc_v1beta2/proto/jobs.proto
new file mode 100644
index 000000000000..4d888dafc011
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/jobs.proto
@@ -0,0 +1,818 @@
+// 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.dataproc.v1beta2;
+
+import "google/api/annotations.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/dataproc/v1beta2;dataproc";
+option java_multiple_files = true;
+option java_outer_classname = "JobsProto";
+option java_package = "com.google.cloud.dataproc.v1beta2";
+
+// The JobController provides methods to manage jobs.
+service JobController {
+  // 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: "*"
+    };
+  }
+
+  // Gets the resource representation for a job in a project.
+  rpc GetJob(GetJobRequest) returns (Job) {
+    option (google.api.http) = {
+      get: "/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}"
+    };
+  }
+
+  // Lists regions/{region}/jobs in a project.
+  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta2/projects/{project_id}/regions/{region}/jobs"
+    };
+  }
+
+  // Updates a job in a project.
+  rpc UpdateJob(UpdateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      patch: "/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}"
+      body: "job"
+    };
+  }
+
+  // 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)
+  // or
+  // [regions/{region}/jobs.get](/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: "*"
+    };
+  }
+
+  // Deletes the job from the project. If the job is active, the delete fails,
+  // and the response returns `FAILED_PRECONDITION`.
+  rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}"
+    };
+  }
+}
+
+// The runtime logging config of the job.
+message LoggingConfig {
+  // The Log4j level for job execution. When running an
+  // [Apache Hive](http://hive.apache.org/) job, Cloud
+  // Dataproc configures the Hive client to an equivalent verbosity level.
+  enum Level {
+    // Level is unspecified. Use default level for log4j.
+    LEVEL_UNSPECIFIED = 0;
+
+    // Use ALL level for log4j.
+    ALL = 1;
+
+    // Use TRACE level for log4j.
+    TRACE = 2;
+
+    // Use DEBUG level for log4j.
+    DEBUG = 3;
+
+    // Use INFO level for log4j.
+    INFO = 4;
+
+    // Use WARN level for log4j.
+    WARN = 5;
+
+    // Use ERROR level for log4j.
+    ERROR = 6;
+
+    // Use FATAL level for log4j.
+    FATAL = 7;
+
+    // Turn off log4j.
+    OFF = 8;
+  }
+
+  // The per-package log levels for the driver. This may include
+  // "root" package name to configure rootLogger.
+  // Examples:
+  //   'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG'
+  map<string, Level> driver_log_levels = 2;
+}
+
+// A Cloud 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
+// YARN](https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html).
+message HadoopJob {
+  // Required. Indicates the location of the driver's main class. Specify
+  // either the jar file that contains the main class or the main class name.
+  // To specify both, add the jar file to `jar_file_uris`, and then specify
+  // the main class name in this property.
+  oneof driver {
+    // The HCFS URI of the jar file containing the main class.
+    // Examples:
+    //     'gs://foo-bucket/analytics-binaries/extract-useful-metrics-mr.jar'
+    //     'hdfs:/tmp/test-samples/custom-wordcount.jar'
+    //     'file:///home/usr/lib/hadoop-mapreduce/hadoop-mapreduce-examples.jar'
+    string main_jar_file_uri = 1;
+
+    // The name of the driver's main class. The jar file containing the class
+    // must be in the default CLASSPATH or specified in `jar_file_uris`.
+    string main_class = 2;
+  }
+
+  // Optional. The arguments to pass to the driver. Do not
+  // 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;
+
+  // Optional. Jar file URIs to add to the CLASSPATHs of the
+  // Hadoop driver and tasks.
+  repeated string jar_file_uris = 4;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in /etc/hadoop/conf/*-site and
+  // classes in user code.
+  map<string, string> properties = 7;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 8;
+}
+
+// A Cloud 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.
+  // 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;
+
+    // The name of the driver's main class. The jar file that contains the class
+    // must be in the default CLASSPATH or specified in `jar_file_uris`.
+    string main_class = 2;
+  }
+
+  // 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;
+
+  // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+  // Spark driver and tasks.
+  repeated string jar_file_uris = 4;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in
+  // /etc/spark/conf/spark-defaults.conf and classes in user code.
+  map<string, string> properties = 7;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 8;
+}
+
+// A Cloud 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;
+
+  // 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;
+
+  // 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;
+
+  // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the
+  // Python driver and tasks.
+  repeated string jar_file_uris = 4;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in
+  // /etc/spark/conf/spark-defaults.conf and classes in user code.
+  map<string, string> properties = 7;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 8;
+}
+
+// A list of queries to run on a cluster.
+message QueryList {
+  // Required. The queries to execute. You do not need to terminate a query
+  // with a semicolon. Multiple queries can be specified in one string
+  // by separating each with a semicolon. Here is an example of an Cloud
+  // Dataproc API snippet that uses a QueryList to specify a HiveJob:
+  //
+  //     "hiveJob": {
+  //       "queryList": {
+  //         "queries": [
+  //           "query1",
+  //           "query2",
+  //           "query3;query4",
+  //         ]
+  //       }
+  //     }
+  repeated string queries = 1;
+}
+
+// A Cloud 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
+  // an HCFS file URI or a list of queries.
+  oneof queries {
+    // The HCFS URI of the script that contains Hive 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;
+
+  // Optional. Mapping of query variable names to values (equivalent to the
+  // Hive command: `SET name="value";`).
+  map<string, string> script_variables = 4;
+
+  // 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
+  // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml,
+  // /etc/hive/conf/hive-site.xml, and classes in user code.
+  map<string, string> properties = 5;
+
+  // 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;
+}
+
+// A Cloud 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
+  // 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. Mapping of query variable names to values (equivalent to the
+  // Spark SQL command: SET `name="value";`).
+  map<string, string> script_variables = 3;
+
+  // 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<string, string> properties = 4;
+
+  // Optional. HCFS URIs of jar files to be added to the Spark CLASSPATH.
+  repeated string jar_file_uris = 56;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 6;
+}
+
+// A Cloud 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
+  // file URI or a list of queries.
+  oneof queries {
+    // The HCFS URI of the script that contains the Pig 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;
+
+  // Optional. Mapping of query variable names to values (equivalent to the Pig
+  // command: `name=[value]`).
+  map<string, string> script_variables = 4;
+
+  // 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
+  // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml,
+  // /etc/pig/conf/pig.properties, and classes in user code.
+  map<string, string> properties = 5;
+
+  // 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;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 7;
+}
+
+// A Cloud 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;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // 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
+  // overwritten. Can include properties set in
+  // /etc/spark/conf/spark-defaults.conf and classes in user code.
+  map<string, string> properties = 5;
+
+  // Optional. The runtime log config for job execution.
+  LoggingConfig logging_config = 6;
+}
+
+// Cloud Dataproc job config.
+message JobPlacement {
+  // Required. The name of the cluster where the job will be submitted.
+  string cluster_name = 1;
+
+  // Output only. A cluster UUID generated by the Cloud Dataproc service when
+  // the job is submitted.
+  string cluster_uuid = 2;
+}
+
+// Cloud Dataproc job status.
+message JobStatus {
+  // The job state.
+  enum State {
+    // The job state is unknown.
+    STATE_UNSPECIFIED = 0;
+
+    // The job is pending; it has been submitted, but is not yet running.
+    PENDING = 1;
+
+    // Job has been received by the service and completed initial setup;
+    // it will soon be submitted to the cluster.
+    SETUP_DONE = 8;
+
+    // The job is running on the cluster.
+    RUNNING = 2;
+
+    // A CancelJob request has been received, but is pending.
+    CANCEL_PENDING = 3;
+
+    // Transient in-flight resources have been canceled, and the request to
+    // cancel the running job has been issued to the cluster.
+    CANCEL_STARTED = 7;
+
+    // The job cancellation was successful.
+    CANCELLED = 4;
+
+    // The job has completed successfully.
+    DONE = 5;
+
+    // The job has completed, but encountered an error.
+    ERROR = 6;
+
+    // Job attempt has failed. The detail field contains failure details for
+    // this attempt.
+    //
+    // Applies to restartable jobs only.
+    ATTEMPT_FAILURE = 9;
+  }
+
+  // The job substate.
+  enum Substate {
+    // The job substate is unknown.
+    UNSPECIFIED = 0;
+
+    // The Job is submitted to the agent.
+    //
+    // Applies to RUNNING state.
+    SUBMITTED = 1;
+
+    // The Job has been received and is awaiting execution (it may be waiting
+    // for a condition to be met). See the "details" field for the reason for
+    // the delay.
+    //
+    // Applies to RUNNING state.
+    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
+    // agent does not send a timely update, the job will fail.
+    //
+    // Applies to RUNNING state.
+    STALE_STATUS = 3;
+  }
+
+  // Output only. A state message specifying the overall job state.
+  State state = 1;
+
+  // Output only. Optional job state details, such as an error
+  // description if the state is <code>ERROR</code>.
+  string details = 2;
+
+  // Output only. The time when this state was entered.
+  google.protobuf.Timestamp state_start_time = 6;
+
+  // Output only. Additional state information, which includes
+  // status reported by the agent.
+  Substate substate = 7;
+}
+
+// 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;
+
+  // 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;
+}
+
+// A YARN application created by a job. Application information is a subset of
+// <code>org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto</code>.
+//
+// **Beta Feature**: This report is available for testing purposes only. It may
+// be changed before final release.
+message YarnApplication {
+  // The application state, corresponding to
+  // <code>YarnProtos.YarnApplicationStateProto</code>.
+  enum State {
+    // Status is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // Status is NEW.
+    NEW = 1;
+
+    // Status is NEW_SAVING.
+    NEW_SAVING = 2;
+
+    // Status is SUBMITTED.
+    SUBMITTED = 3;
+
+    // Status is ACCEPTED.
+    ACCEPTED = 4;
+
+    // Status is RUNNING.
+    RUNNING = 5;
+
+    // Status is FINISHED.
+    FINISHED = 6;
+
+    // Status is FAILED.
+    FAILED = 7;
+
+    // Status is KILLED.
+    KILLED = 8;
+  }
+
+  // Required. The application name.
+  string name = 1;
+
+  // Required. The application state.
+  State state = 2;
+
+  // Required. The numerical progress of the application, from 1 to 100.
+  float progress = 3;
+
+  // 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;
+}
+
+// A Cloud 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
+  // <code>job_id</code>.
+  JobReference reference = 1;
+
+  // Required. Job information, including how, when, and where to
+  // run the job.
+  JobPlacement placement = 2;
+
+  // Required. The application/framework-specific portion of the job.
+  oneof type_job {
+    // Job is a Hadoop job.
+    HadoopJob hadoop_job = 3;
+
+    // Job is a Spark job.
+    SparkJob spark_job = 4;
+
+    // Job is a Pyspark job.
+    PySparkJob pyspark_job = 5;
+
+    // Job is a Hive job.
+    HiveJob hive_job = 6;
+
+    // Job is a Pig job.
+    PigJob pig_job = 7;
+
+    // Job is a SparkR job.
+    SparkRJob spark_r_job = 21;
+
+    // Job is a SparkSql job.
+    SparkSqlJob spark_sql_job = 12;
+  }
+
+  // Output only. The job status. Additional application-specific
+  // status information may be contained in the <code>type_job</code>
+  // and <code>yarn_applications</code> fields.
+  JobStatus status = 8;
+
+  // Output only. The previous job status.
+  repeated JobStatus status_history = 13;
+
+  // 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;
+
+  // Output only. The email address of the user submitting the job. For jobs
+  // submitted on the cluster, the address is <code>username@hostname</code>.
+  string submitted_by = 10;
+
+  // Output only. A URI pointing to the location of the stdout of the job's
+  // driver program.
+  string driver_output_resource_uri = 17;
+
+  // 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;
+
+  // Optional. The labels to associate with this job.
+  // Label **keys** must contain 1 to 63 characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  // Label **values** may be empty, but, if present, must contain 1 to 63
+  // 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<string, string> labels = 18;
+
+  // Optional. Job scheduling configuration.
+  JobScheduling scheduling = 20;
+
+  // 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;
+}
+
+// Job scheduling options.
+message JobScheduling {
+  // Optional. Maximum number of times per hour a driver may be restarted as
+  // a result of driver terminating with non-zero code before job is
+  // reported failed.
+  //
+  // A job may be reported as thrashing if driver exits with non-zero code
+  // 4 times within 10 minute window.
+  //
+  // Maximum value is 10.
+  int32 max_failures_per_hour = 1;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job resource.
+  Job job = 2;
+
+  // Optional. A unique id used to identify the request. If the server
+  // receives two [SubmitJobRequest][google.cloud.dataproc.v1beta2.SubmitJobRequest] requests  with the same
+  // id, then the second request will be ignored and the
+  // first [Job][google.cloud.dataproc.v1beta2.Job] created and stored in the backend
+  // is returned.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job ID.
+  string job_id = 2;
+}
+
+// A request to list jobs in a project.
+message ListJobsRequest {
+  // A matcher that specifies categories of job states.
+  enum JobStateMatcher {
+    // Match all jobs, regardless of state.
+    ALL = 0;
+
+    // Only match jobs in non-terminal states: PENDING, RUNNING, or
+    // CANCEL_PENDING.
+    ACTIVE = 1;
+
+    // Only match jobs in terminal states: CANCELLED, DONE, or ERROR.
+    NON_ACTIVE = 2;
+  }
+
+  // Required. The ID of the Google Cloud Platform project that the job
+  // belongs to.
+  string project_id = 1;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 6;
+
+  // Optional. The number of results to return in each response.
+  int32 page_size = 2;
+
+  // Optional. The page token, returned by a previous call, to request the
+  // next page of results.
+  string page_token = 3;
+
+  // Optional. If set, the returned jobs list includes only jobs that were
+  // submitted to the named cluster.
+  string cluster_name = 4;
+
+  // 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;
+
+  // Optional. A filter constraining the jobs to list. Filters are
+  // case-sensitive and have the following syntax:
+  //
+  // [field = value] AND [field [= value]] ...
+  //
+  // where **field** is `status.state` or `labels.[KEY]`, and `[KEY]` is a label
+  // key. **value** can be `*` to match all values.
+  // `status.state` can be either `ACTIVE` or `NON_ACTIVE`.
+  // Only the logical `AND` operator is supported; space-separated items are
+  // treated as having an implicit `AND` operator.
+  //
+  // Example filter:
+  //
+  // status.state = ACTIVE AND labels.env = staging AND labels.starred = *
+  string filter = 7;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 2;
+
+  // Required. The job ID.
+  string job_id = 3;
+
+  // Required. The changes to the job.
+  Job job = 4;
+
+  // Required. Specifies the path, relative to <code>Job</code>, of
+  // the field to update. For example, to update the labels of a Job the
+  // <code>update_mask</code> parameter would be specified as
+  // <code>labels</code>, and the `PATCH` request body would specify the new
+  // value. <strong>Note:</strong> Currently, <code>labels</code> is the only
+  // field that can be updated.
+  google.protobuf.FieldMask update_mask = 5;
+}
+
+// A list of jobs in a project.
+message ListJobsResponse {
+  // Output only. Jobs list.
+  repeated Job jobs = 1;
+
+  // 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 <code>ListJobsRequest</code>.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job ID.
+  string job_id = 2;
+}
+
+// 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;
+
+  // Required. The Cloud Dataproc region in which to handle the request.
+  string region = 3;
+
+  // Required. The job ID.
+  string job_id = 2;
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/jobs_pb2.py b/dataproc/google/cloud/dataproc_v1beta2/proto/jobs_pb2.py
new file mode 100644
index 000000000000..6379fd2c8bbc
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/jobs_pb2.py
@@ -0,0 +1,4536 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1beta2/proto/jobs.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1beta2/proto/jobs.proto",
+    package="google.cloud.dataproc.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.dataproc.v1beta2B\tJobsProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/dataproc_v1beta2/proto/jobs.proto\x12\x1dgoogle.cloud.dataproc.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xcb\x02\n\rLoggingConfig\x12\\\n\x11\x64river_log_levels\x18\x02 \x03(\x0b\x32\x41.google.cloud.dataproc.v1beta2.LoggingConfig.DriverLogLevelsEntry\x1aj\n\x14\x44riverLogLevelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x41\n\x05value\x18\x02 \x01(\x0e\x32\x32.google.cloud.dataproc.v1beta2.LoggingConfig.Level:\x02\x38\x01"p\n\x05Level\x12\x15\n\x11LEVEL_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41LL\x10\x01\x12\t\n\x05TRACE\x10\x02\x12\t\n\x05\x44\x45\x42UG\x10\x03\x12\x08\n\x04INFO\x10\x04\x12\x08\n\x04WARN\x10\x05\x12\t\n\x05\x45RROR\x10\x06\x12\t\n\x05\x46\x41TAL\x10\x07\x12\x07\n\x03OFF\x10\x08"\xdd\x02\n\tHadoopJob\x12\x1b\n\x11main_jar_file_uri\x18\x01 \x01(\tH\x00\x12\x14\n\nmain_class\x18\x02 \x01(\tH\x00\x12\x0c\n\x04\x61rgs\x18\x03 \x03(\t\x12\x15\n\rjar_file_uris\x18\x04 \x03(\t\x12\x11\n\tfile_uris\x18\x05 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x06 \x03(\t\x12L\n\nproperties\x18\x07 \x03(\x0b\x32\x38.google.cloud.dataproc.v1beta2.HadoopJob.PropertiesEntry\x12\x44\n\x0elogging_config\x18\x08 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x08\n\x06\x64river"\xdb\x02\n\x08SparkJob\x12\x1b\n\x11main_jar_file_uri\x18\x01 \x01(\tH\x00\x12\x14\n\nmain_class\x18\x02 \x01(\tH\x00\x12\x0c\n\x04\x61rgs\x18\x03 \x03(\t\x12\x15\n\rjar_file_uris\x18\x04 \x03(\t\x12\x11\n\tfile_uris\x18\x05 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x06 \x03(\t\x12K\n\nproperties\x18\x07 \x03(\x0b\x32\x37.google.cloud.dataproc.v1beta2.SparkJob.PropertiesEntry\x12\x44\n\x0elogging_config\x18\x08 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x08\n\x06\x64river"\xda\x02\n\nPySparkJob\x12\x1c\n\x14main_python_file_uri\x18\x01 \x01(\t\x12\x0c\n\x04\x61rgs\x18\x02 \x03(\t\x12\x18\n\x10python_file_uris\x18\x03 \x03(\t\x12\x15\n\rjar_file_uris\x18\x04 \x03(\t\x12\x11\n\tfile_uris\x18\x05 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x06 \x03(\t\x12M\n\nproperties\x18\x07 \x03(\x0b\x32\x39.google.cloud.dataproc.v1beta2.PySparkJob.PropertiesEntry\x12\x44\n\x0elogging_config\x18\x08 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x1c\n\tQueryList\x12\x0f\n\x07queries\x18\x01 \x03(\t"\xb0\x03\n\x07HiveJob\x12\x18\n\x0equery_file_uri\x18\x01 \x01(\tH\x00\x12>\n\nquery_list\x18\x02 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.QueryListH\x00\x12\x1b\n\x13\x63ontinue_on_failure\x18\x03 \x01(\x08\x12U\n\x10script_variables\x18\x04 \x03(\x0b\x32;.google.cloud.dataproc.v1beta2.HiveJob.ScriptVariablesEntry\x12J\n\nproperties\x18\x05 \x03(\x0b\x32\x36.google.cloud.dataproc.v1beta2.HiveJob.PropertiesEntry\x12\x15\n\rjar_file_uris\x18\x06 \x03(\t\x1a\x36\n\x14ScriptVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07queries"\xe5\x03\n\x0bSparkSqlJob\x12\x18\n\x0equery_file_uri\x18\x01 \x01(\tH\x00\x12>\n\nquery_list\x18\x02 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.QueryListH\x00\x12Y\n\x10script_variables\x18\x03 \x03(\x0b\x32?.google.cloud.dataproc.v1beta2.SparkSqlJob.ScriptVariablesEntry\x12N\n\nproperties\x18\x04 \x03(\x0b\x32:.google.cloud.dataproc.v1beta2.SparkSqlJob.PropertiesEntry\x12\x15\n\rjar_file_uris\x18\x38 \x03(\t\x12\x44\n\x0elogging_config\x18\x06 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.LoggingConfig\x1a\x36\n\x14ScriptVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07queries"\xf3\x03\n\x06PigJob\x12\x18\n\x0equery_file_uri\x18\x01 \x01(\tH\x00\x12>\n\nquery_list\x18\x02 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.QueryListH\x00\x12\x1b\n\x13\x63ontinue_on_failure\x18\x03 \x01(\x08\x12T\n\x10script_variables\x18\x04 \x03(\x0b\x32:.google.cloud.dataproc.v1beta2.PigJob.ScriptVariablesEntry\x12I\n\nproperties\x18\x05 \x03(\x0b\x32\x35.google.cloud.dataproc.v1beta2.PigJob.PropertiesEntry\x12\x15\n\rjar_file_uris\x18\x06 \x03(\t\x12\x44\n\x0elogging_config\x18\x07 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.LoggingConfig\x1a\x36\n\x14ScriptVariablesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07queries"\xa2\x02\n\tSparkRJob\x12\x17\n\x0fmain_r_file_uri\x18\x01 \x01(\t\x12\x0c\n\x04\x61rgs\x18\x02 \x03(\t\x12\x11\n\tfile_uris\x18\x03 \x03(\t\x12\x14\n\x0c\x61rchive_uris\x18\x04 \x03(\t\x12L\n\nproperties\x18\x05 \x03(\x0b\x32\x38.google.cloud.dataproc.v1beta2.SparkRJob.PropertiesEntry\x12\x44\n\x0elogging_config\x18\x06 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.LoggingConfig\x1a\x31\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01":\n\x0cJobPlacement\x12\x14\n\x0c\x63luster_name\x18\x01 \x01(\t\x12\x14\n\x0c\x63luster_uuid\x18\x02 \x01(\t"\xcc\x03\n\tJobStatus\x12=\n\x05state\x18\x01 \x01(\x0e\x32..google.cloud.dataproc.v1beta2.JobStatus.State\x12\x0f\n\x07\x64\x65tails\x18\x02 \x01(\t\x12\x34\n\x10state_start_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x43\n\x08substate\x18\x07 \x01(\x0e\x32\x31.google.cloud.dataproc.v1beta2.JobStatus.Substate"\xa9\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0e\n\nSETUP_DONE\x10\x08\x12\x0b\n\x07RUNNING\x10\x02\x12\x12\n\x0e\x43\x41NCEL_PENDING\x10\x03\x12\x12\n\x0e\x43\x41NCEL_STARTED\x10\x07\x12\r\n\tCANCELLED\x10\x04\x12\x08\n\x04\x44ONE\x10\x05\x12\t\n\x05\x45RROR\x10\x06\x12\x13\n\x0f\x41TTEMPT_FAILURE\x10\t"H\n\x08Substate\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\r\n\tSUBMITTED\x10\x01\x12\n\n\x06QUEUED\x10\x02\x12\x10\n\x0cSTALE_STATUS\x10\x03"2\n\x0cJobReference\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t"\x96\x02\n\x0fYarnApplication\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x43\n\x05state\x18\x02 \x01(\x0e\x32\x34.google.cloud.dataproc.v1beta2.YarnApplication.State\x12\x10\n\x08progress\x18\x03 \x01(\x02\x12\x14\n\x0ctracking_url\x18\x04 \x01(\t"\x87\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x07\n\x03NEW\x10\x01\x12\x0e\n\nNEW_SAVING\x10\x02\x12\r\n\tSUBMITTED\x10\x03\x12\x0c\n\x08\x41\x43\x43\x45PTED\x10\x04\x12\x0b\n\x07RUNNING\x10\x05\x12\x0c\n\x08\x46INISHED\x10\x06\x12\n\n\x06\x46\x41ILED\x10\x07\x12\n\n\x06KILLED\x10\x08"\xb3\x08\n\x03Job\x12>\n\treference\x18\x01 \x01(\x0b\x32+.google.cloud.dataproc.v1beta2.JobReference\x12>\n\tplacement\x18\x02 \x01(\x0b\x32+.google.cloud.dataproc.v1beta2.JobPlacement\x12>\n\nhadoop_job\x18\x03 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.HadoopJobH\x00\x12<\n\tspark_job\x18\x04 \x01(\x0b\x32\'.google.cloud.dataproc.v1beta2.SparkJobH\x00\x12@\n\x0bpyspark_job\x18\x05 \x01(\x0b\x32).google.cloud.dataproc.v1beta2.PySparkJobH\x00\x12:\n\x08hive_job\x18\x06 \x01(\x0b\x32&.google.cloud.dataproc.v1beta2.HiveJobH\x00\x12\x38\n\x07pig_job\x18\x07 \x01(\x0b\x32%.google.cloud.dataproc.v1beta2.PigJobH\x00\x12?\n\x0bspark_r_job\x18\x15 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.SparkRJobH\x00\x12\x43\n\rspark_sql_job\x18\x0c \x01(\x0b\x32*.google.cloud.dataproc.v1beta2.SparkSqlJobH\x00\x12\x38\n\x06status\x18\x08 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.JobStatus\x12@\n\x0estatus_history\x18\r \x03(\x0b\x32(.google.cloud.dataproc.v1beta2.JobStatus\x12I\n\x11yarn_applications\x18\t \x03(\x0b\x32..google.cloud.dataproc.v1beta2.YarnApplication\x12\x14\n\x0csubmitted_by\x18\n \x01(\t\x12"\n\x1a\x64river_output_resource_uri\x18\x11 \x01(\t\x12 \n\x18\x64river_control_files_uri\x18\x0f \x01(\t\x12>\n\x06labels\x18\x12 \x03(\x0b\x32..google.cloud.dataproc.v1beta2.Job.LabelsEntry\x12@\n\nscheduling\x18\x14 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.JobScheduling\x12\x10\n\x08job_uuid\x18\x16 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\n\n\x08type_job".\n\rJobScheduling\x12\x1d\n\x15max_failures_per_hour\x18\x01 \x01(\x05"{\n\x10SubmitJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12/\n\x03job\x18\x02 \x01(\x0b\x32".google.cloud.dataproc.v1beta2.Job\x12\x12\n\nrequest_id\x18\x04 \x01(\t"C\n\rGetJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t"\x95\x02\n\x0fListJobsRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x06 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x14\n\x0c\x63luster_name\x18\x04 \x01(\t\x12Y\n\x11job_state_matcher\x18\x05 \x01(\x0e\x32>.google.cloud.dataproc.v1beta2.ListJobsRequest.JobStateMatcher\x12\x0e\n\x06\x66ilter\x18\x07 \x01(\t"6\n\x0fJobStateMatcher\x12\x07\n\x03\x41LL\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0e\n\nNON_ACTIVE\x10\x02"\xa8\x01\n\x10UpdateJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x02 \x01(\t\x12\x0e\n\x06job_id\x18\x03 \x01(\t\x12/\n\x03job\x18\x04 \x01(\x0b\x32".google.cloud.dataproc.v1beta2.Job\x12/\n\x0bupdate_mask\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"]\n\x10ListJobsResponse\x12\x30\n\x04jobs\x18\x01 \x03(\x0b\x32".google.cloud.dataproc.v1beta2.Job\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"F\n\x10\x43\x61ncelJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t"F\n\x10\x44\x65leteJobRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0e\n\x06region\x18\x03 \x01(\t\x12\x0e\n\x06job_id\x18\x02 \x01(\t2\x8b\x08\n\rJobController\x12\xa8\x01\n\tSubmitJob\x12/.google.cloud.dataproc.v1beta2.SubmitJobRequest\x1a".google.cloud.dataproc.v1beta2.Job"F\x82\xd3\xe4\x93\x02@";/v1beta2/projects/{project_id}/regions/{region}/jobs:submit:\x01*\x12\xa1\x01\n\x06GetJob\x12,.google.cloud.dataproc.v1beta2.GetJobRequest\x1a".google.cloud.dataproc.v1beta2.Job"E\x82\xd3\xe4\x93\x02?\x12=/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}\x12\xa9\x01\n\x08ListJobs\x12..google.cloud.dataproc.v1beta2.ListJobsRequest\x1a/.google.cloud.dataproc.v1beta2.ListJobsResponse"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta2/projects/{project_id}/regions/{region}/jobs\x12\xac\x01\n\tUpdateJob\x12/.google.cloud.dataproc.v1beta2.UpdateJobRequest\x1a".google.cloud.dataproc.v1beta2.Job"J\x82\xd3\xe4\x93\x02\x44\x32=/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}:\x03job\x12\xb1\x01\n\tCancelJob\x12/.google.cloud.dataproc.v1beta2.CancelJobRequest\x1a".google.cloud.dataproc.v1beta2.Job"O\x82\xd3\xe4\x93\x02I"D/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}:cancel:\x01*\x12\x9b\x01\n\tDeleteJob\x12/.google.cloud.dataproc.v1beta2.DeleteJobRequest\x1a\x16.google.protobuf.Empty"E\x82\xd3\xe4\x93\x02?*=/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}Bw\n!com.google.cloud.dataproc.v1beta2B\tJobsProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGGINGCONFIG_LEVEL = _descriptor.EnumDescriptor(
+    name="Level",
+    full_name="google.cloud.dataproc.v1beta2.LoggingConfig.Level",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TRACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEBUG", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INFO", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WARN", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FATAL", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OFF", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=427,
+    serialized_end=539,
+)
+_sym_db.RegisterEnumDescriptor(_LOGGINGCONFIG_LEVEL)
+
+_JOBSTATUS_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1beta2.JobStatus.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SETUP_DONE", index=2, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=3, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCEL_PENDING", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCEL_STARTED", index=5, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=6, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=7, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=8, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTEMPT_FAILURE",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3618,
+    serialized_end=3787,
+)
+_sym_db.RegisterEnumDescriptor(_JOBSTATUS_STATE)
+
+_JOBSTATUS_SUBSTATE = _descriptor.EnumDescriptor(
+    name="Substate",
+    full_name="google.cloud.dataproc.v1beta2.JobStatus.Substate",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUBMITTED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="QUEUED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STALE_STATUS", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3789,
+    serialized_end=3861,
+)
+_sym_db.RegisterEnumDescriptor(_JOBSTATUS_SUBSTATE)
+
+_YARNAPPLICATION_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1beta2.YarnApplication.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEW", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEW_SAVING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUBMITTED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCEPTED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KILLED", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4059,
+    serialized_end=4194,
+)
+_sym_db.RegisterEnumDescriptor(_YARNAPPLICATION_STATE)
+
+_LISTJOBSREQUEST_JOBSTATEMATCHER = _descriptor.EnumDescriptor(
+    name="JobStateMatcher",
+    full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.JobStateMatcher",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ALL", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NON_ACTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5740,
+    serialized_end=5794,
+)
+_sym_db.RegisterEnumDescriptor(_LISTJOBSREQUEST_JOBSTATEMATCHER)
+
+
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY = _descriptor.Descriptor(
+    name="DriverLogLevelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.LoggingConfig.DriverLogLevelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.LoggingConfig.DriverLogLevelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.LoggingConfig.DriverLogLevelsEntry.value",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=319,
+    serialized_end=425,
+)
+
+_LOGGINGCONFIG = _descriptor.Descriptor(
+    name="LoggingConfig",
+    full_name="google.cloud.dataproc.v1beta2.LoggingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="driver_log_levels",
+            full_name="google.cloud.dataproc.v1beta2.LoggingConfig.driver_log_levels",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY],
+    enum_types=[_LOGGINGCONFIG_LEVEL],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=208,
+    serialized_end=539,
+)
+
+
+_HADOOPJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.HadoopJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_HADOOPJOB = _descriptor.Descriptor(
+    name="HadoopJob",
+    full_name="google.cloud.dataproc.v1beta2.HadoopJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_jar_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.main_jar_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="main_class",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.main_class",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.args",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.jar_file_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.file_uris",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.archive_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.logging_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HADOOPJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="driver",
+            full_name="google.cloud.dataproc.v1beta2.HadoopJob.driver",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=542,
+    serialized_end=891,
+)
+
+
+_SPARKJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.SparkJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_SPARKJOB = _descriptor.Descriptor(
+    name="SparkJob",
+    full_name="google.cloud.dataproc.v1beta2.SparkJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_jar_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.main_jar_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="main_class",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.main_class",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.args",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.jar_file_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.file_uris",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.archive_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.logging_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPARKJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="driver",
+            full_name="google.cloud.dataproc.v1beta2.SparkJob.driver",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=894,
+    serialized_end=1241,
+)
+
+
+_PYSPARKJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.PySparkJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_PYSPARKJOB = _descriptor.Descriptor(
+    name="PySparkJob",
+    full_name="google.cloud.dataproc.v1beta2.PySparkJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_python_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.main_python_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.args",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="python_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.python_file_uris",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.jar_file_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.file_uris",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.archive_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1beta2.PySparkJob.logging_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PYSPARKJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1244,
+    serialized_end=1590,
+)
+
+
+_QUERYLIST = _descriptor.Descriptor(
+    name="QueryList",
+    full_name="google.cloud.dataproc.v1beta2.QueryList",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1beta2.QueryList.queries",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1592,
+    serialized_end=1620,
+)
+
+
+_HIVEJOB_SCRIPTVARIABLESENTRY = _descriptor.Descriptor(
+    name="ScriptVariablesEntry",
+    full_name="google.cloud.dataproc.v1beta2.HiveJob.ScriptVariablesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.ScriptVariablesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.ScriptVariablesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1939,
+    serialized_end=1993,
+)
+
+_HIVEJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.HiveJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_HIVEJOB = _descriptor.Descriptor(
+    name="HiveJob",
+    full_name="google.cloud.dataproc.v1beta2.HiveJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.query_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_list",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.query_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="continue_on_failure",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.continue_on_failure",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="script_variables",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.script_variables",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.properties",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.jar_file_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HIVEJOB_SCRIPTVARIABLESENTRY, _HIVEJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1beta2.HiveJob.queries",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1623,
+    serialized_end=2055,
+)
+
+
+_SPARKSQLJOB_SCRIPTVARIABLESENTRY = _descriptor.Descriptor(
+    name="ScriptVariablesEntry",
+    full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.ScriptVariablesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.ScriptVariablesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.ScriptVariablesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1939,
+    serialized_end=1993,
+)
+
+_SPARKSQLJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_SPARKSQLJOB = _descriptor.Descriptor(
+    name="SparkSqlJob",
+    full_name="google.cloud.dataproc.v1beta2.SparkSqlJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.query_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_list",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.query_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="script_variables",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.script_variables",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.properties",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.jar_file_uris",
+            index=4,
+            number=56,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.logging_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPARKSQLJOB_SCRIPTVARIABLESENTRY, _SPARKSQLJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1beta2.SparkSqlJob.queries",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2058,
+    serialized_end=2543,
+)
+
+
+_PIGJOB_SCRIPTVARIABLESENTRY = _descriptor.Descriptor(
+    name="ScriptVariablesEntry",
+    full_name="google.cloud.dataproc.v1beta2.PigJob.ScriptVariablesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.ScriptVariablesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.ScriptVariablesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1939,
+    serialized_end=1993,
+)
+
+_PIGJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.PigJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_PIGJOB = _descriptor.Descriptor(
+    name="PigJob",
+    full_name="google.cloud.dataproc.v1beta2.PigJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.query_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_list",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.query_list",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="continue_on_failure",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.continue_on_failure",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="script_variables",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.script_variables",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.properties",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jar_file_uris",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.jar_file_uris",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.logging_config",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PIGJOB_SCRIPTVARIABLESENTRY, _PIGJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queries",
+            full_name="google.cloud.dataproc.v1beta2.PigJob.queries",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2546,
+    serialized_end=3045,
+)
+
+
+_SPARKRJOB_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.dataproc.v1beta2.SparkRJob.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=881,
+)
+
+_SPARKRJOB = _descriptor.Descriptor(
+    name="SparkRJob",
+    full_name="google.cloud.dataproc.v1beta2.SparkRJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="main_r_file_uri",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.main_r_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.args",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_uris",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.file_uris",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="archive_uris",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.archive_uris",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.properties",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logging_config",
+            full_name="google.cloud.dataproc.v1beta2.SparkRJob.logging_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPARKRJOB_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3048,
+    serialized_end=3338,
+)
+
+
+_JOBPLACEMENT = _descriptor.Descriptor(
+    name="JobPlacement",
+    full_name="google.cloud.dataproc.v1beta2.JobPlacement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.JobPlacement.cluster_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1beta2.JobPlacement.cluster_uuid",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3340,
+    serialized_end=3398,
+)
+
+
+_JOBSTATUS = _descriptor.Descriptor(
+    name="JobStatus",
+    full_name="google.cloud.dataproc.v1beta2.JobStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1beta2.JobStatus.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="google.cloud.dataproc.v1beta2.JobStatus.details",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_start_time",
+            full_name="google.cloud.dataproc.v1beta2.JobStatus.state_start_time",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="substate",
+            full_name="google.cloud.dataproc.v1beta2.JobStatus.substate",
+            index=3,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_JOBSTATUS_STATE, _JOBSTATUS_SUBSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3401,
+    serialized_end=3861,
+)
+
+
+_JOBREFERENCE = _descriptor.Descriptor(
+    name="JobReference",
+    full_name="google.cloud.dataproc.v1beta2.JobReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.JobReference.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1beta2.JobReference.job_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3863,
+    serialized_end=3913,
+)
+
+
+_YARNAPPLICATION = _descriptor.Descriptor(
+    name="YarnApplication",
+    full_name="google.cloud.dataproc.v1beta2.YarnApplication",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.YarnApplication.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1beta2.YarnApplication.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress",
+            full_name="google.cloud.dataproc.v1beta2.YarnApplication.progress",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tracking_url",
+            full_name="google.cloud.dataproc.v1beta2.YarnApplication.tracking_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_YARNAPPLICATION_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3916,
+    serialized_end=4194,
+)
+
+
+_JOB_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.Job.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.Job.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.Job.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5215,
+    serialized_end=5260,
+)
+
+_JOB = _descriptor.Descriptor(
+    name="Job",
+    full_name="google.cloud.dataproc.v1beta2.Job",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference",
+            full_name="google.cloud.dataproc.v1beta2.Job.reference",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="placement",
+            full_name="google.cloud.dataproc.v1beta2.Job.placement",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hadoop_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.hadoop_job",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.spark_job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pyspark_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.pyspark_job",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hive_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.hive_job",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pig_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.pig_job",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_r_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.spark_r_job",
+            index=7,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_sql_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.spark_sql_job",
+            index=8,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.dataproc.v1beta2.Job.status",
+            index=9,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_history",
+            full_name="google.cloud.dataproc.v1beta2.Job.status_history",
+            index=10,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="yarn_applications",
+            full_name="google.cloud.dataproc.v1beta2.Job.yarn_applications",
+            index=11,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submitted_by",
+            full_name="google.cloud.dataproc.v1beta2.Job.submitted_by",
+            index=12,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="driver_output_resource_uri",
+            full_name="google.cloud.dataproc.v1beta2.Job.driver_output_resource_uri",
+            index=13,
+            number=17,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="driver_control_files_uri",
+            full_name="google.cloud.dataproc.v1beta2.Job.driver_control_files_uri",
+            index=14,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1beta2.Job.labels",
+            index=15,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scheduling",
+            full_name="google.cloud.dataproc.v1beta2.Job.scheduling",
+            index=16,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_uuid",
+            full_name="google.cloud.dataproc.v1beta2.Job.job_uuid",
+            index=17,
+            number=22,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_JOB_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type_job",
+            full_name="google.cloud.dataproc.v1beta2.Job.type_job",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=4197,
+    serialized_end=5272,
+)
+
+
+_JOBSCHEDULING = _descriptor.Descriptor(
+    name="JobScheduling",
+    full_name="google.cloud.dataproc.v1beta2.JobScheduling",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_failures_per_hour",
+            full_name="google.cloud.dataproc.v1beta2.JobScheduling.max_failures_per_hour",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5274,
+    serialized_end=5320,
+)
+
+
+_SUBMITJOBREQUEST = _descriptor.Descriptor(
+    name="SubmitJobRequest",
+    full_name="google.cloud.dataproc.v1beta2.SubmitJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.SubmitJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.SubmitJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.dataproc.v1beta2.SubmitJobRequest.job",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1beta2.SubmitJobRequest.request_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5322,
+    serialized_end=5445,
+)
+
+
+_GETJOBREQUEST = _descriptor.Descriptor(
+    name="GetJobRequest",
+    full_name="google.cloud.dataproc.v1beta2.GetJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.GetJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.GetJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1beta2.GetJobRequest.job_id",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5447,
+    serialized_end=5514,
+)
+
+
+_LISTJOBSREQUEST = _descriptor.Descriptor(
+    name="ListJobsRequest",
+    full_name="google.cloud.dataproc.v1beta2.ListJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.region",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.page_size",
+            index=2,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.page_token",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.cluster_name",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_state_matcher",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.job_state_matcher",
+            index=5,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsRequest.filter",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTJOBSREQUEST_JOBSTATEMATCHER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5517,
+    serialized_end=5794,
+)
+
+
+_UPDATEJOBREQUEST = _descriptor.Descriptor(
+    name="UpdateJobRequest",
+    full_name="google.cloud.dataproc.v1beta2.UpdateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.UpdateJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.UpdateJobRequest.region",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1beta2.UpdateJobRequest.job_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.dataproc.v1beta2.UpdateJobRequest.job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.dataproc.v1beta2.UpdateJobRequest.update_mask",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5797,
+    serialized_end=5965,
+)
+
+
+_LISTJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListJobsResponse",
+    full_name="google.cloud.dataproc.v1beta2.ListJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsResponse.jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5967,
+    serialized_end=6060,
+)
+
+
+_CANCELJOBREQUEST = _descriptor.Descriptor(
+    name="CancelJobRequest",
+    full_name="google.cloud.dataproc.v1beta2.CancelJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.CancelJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.CancelJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1beta2.CancelJobRequest.job_id",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6062,
+    serialized_end=6132,
+)
+
+
+_DELETEJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteJobRequest",
+    full_name="google.cloud.dataproc.v1beta2.DeleteJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.dataproc.v1beta2.DeleteJobRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.cloud.dataproc.v1beta2.DeleteJobRequest.region",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1beta2.DeleteJobRequest.job_id",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6134,
+    serialized_end=6204,
+)
+
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY.fields_by_name[
+    "value"
+].enum_type = _LOGGINGCONFIG_LEVEL
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY.containing_type = _LOGGINGCONFIG
+_LOGGINGCONFIG.fields_by_name[
+    "driver_log_levels"
+].message_type = _LOGGINGCONFIG_DRIVERLOGLEVELSENTRY
+_LOGGINGCONFIG_LEVEL.containing_type = _LOGGINGCONFIG
+_HADOOPJOB_PROPERTIESENTRY.containing_type = _HADOOPJOB
+_HADOOPJOB.fields_by_name["properties"].message_type = _HADOOPJOB_PROPERTIESENTRY
+_HADOOPJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_HADOOPJOB.oneofs_by_name["driver"].fields.append(
+    _HADOOPJOB.fields_by_name["main_jar_file_uri"]
+)
+_HADOOPJOB.fields_by_name[
+    "main_jar_file_uri"
+].containing_oneof = _HADOOPJOB.oneofs_by_name["driver"]
+_HADOOPJOB.oneofs_by_name["driver"].fields.append(
+    _HADOOPJOB.fields_by_name["main_class"]
+)
+_HADOOPJOB.fields_by_name["main_class"].containing_oneof = _HADOOPJOB.oneofs_by_name[
+    "driver"
+]
+_SPARKJOB_PROPERTIESENTRY.containing_type = _SPARKJOB
+_SPARKJOB.fields_by_name["properties"].message_type = _SPARKJOB_PROPERTIESENTRY
+_SPARKJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_SPARKJOB.oneofs_by_name["driver"].fields.append(
+    _SPARKJOB.fields_by_name["main_jar_file_uri"]
+)
+_SPARKJOB.fields_by_name[
+    "main_jar_file_uri"
+].containing_oneof = _SPARKJOB.oneofs_by_name["driver"]
+_SPARKJOB.oneofs_by_name["driver"].fields.append(_SPARKJOB.fields_by_name["main_class"])
+_SPARKJOB.fields_by_name["main_class"].containing_oneof = _SPARKJOB.oneofs_by_name[
+    "driver"
+]
+_PYSPARKJOB_PROPERTIESENTRY.containing_type = _PYSPARKJOB
+_PYSPARKJOB.fields_by_name["properties"].message_type = _PYSPARKJOB_PROPERTIESENTRY
+_PYSPARKJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_HIVEJOB_SCRIPTVARIABLESENTRY.containing_type = _HIVEJOB
+_HIVEJOB_PROPERTIESENTRY.containing_type = _HIVEJOB
+_HIVEJOB.fields_by_name["query_list"].message_type = _QUERYLIST
+_HIVEJOB.fields_by_name["script_variables"].message_type = _HIVEJOB_SCRIPTVARIABLESENTRY
+_HIVEJOB.fields_by_name["properties"].message_type = _HIVEJOB_PROPERTIESENTRY
+_HIVEJOB.oneofs_by_name["queries"].fields.append(
+    _HIVEJOB.fields_by_name["query_file_uri"]
+)
+_HIVEJOB.fields_by_name["query_file_uri"].containing_oneof = _HIVEJOB.oneofs_by_name[
+    "queries"
+]
+_HIVEJOB.oneofs_by_name["queries"].fields.append(_HIVEJOB.fields_by_name["query_list"])
+_HIVEJOB.fields_by_name["query_list"].containing_oneof = _HIVEJOB.oneofs_by_name[
+    "queries"
+]
+_SPARKSQLJOB_SCRIPTVARIABLESENTRY.containing_type = _SPARKSQLJOB
+_SPARKSQLJOB_PROPERTIESENTRY.containing_type = _SPARKSQLJOB
+_SPARKSQLJOB.fields_by_name["query_list"].message_type = _QUERYLIST
+_SPARKSQLJOB.fields_by_name[
+    "script_variables"
+].message_type = _SPARKSQLJOB_SCRIPTVARIABLESENTRY
+_SPARKSQLJOB.fields_by_name["properties"].message_type = _SPARKSQLJOB_PROPERTIESENTRY
+_SPARKSQLJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_SPARKSQLJOB.oneofs_by_name["queries"].fields.append(
+    _SPARKSQLJOB.fields_by_name["query_file_uri"]
+)
+_SPARKSQLJOB.fields_by_name[
+    "query_file_uri"
+].containing_oneof = _SPARKSQLJOB.oneofs_by_name["queries"]
+_SPARKSQLJOB.oneofs_by_name["queries"].fields.append(
+    _SPARKSQLJOB.fields_by_name["query_list"]
+)
+_SPARKSQLJOB.fields_by_name[
+    "query_list"
+].containing_oneof = _SPARKSQLJOB.oneofs_by_name["queries"]
+_PIGJOB_SCRIPTVARIABLESENTRY.containing_type = _PIGJOB
+_PIGJOB_PROPERTIESENTRY.containing_type = _PIGJOB
+_PIGJOB.fields_by_name["query_list"].message_type = _QUERYLIST
+_PIGJOB.fields_by_name["script_variables"].message_type = _PIGJOB_SCRIPTVARIABLESENTRY
+_PIGJOB.fields_by_name["properties"].message_type = _PIGJOB_PROPERTIESENTRY
+_PIGJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_PIGJOB.oneofs_by_name["queries"].fields.append(
+    _PIGJOB.fields_by_name["query_file_uri"]
+)
+_PIGJOB.fields_by_name["query_file_uri"].containing_oneof = _PIGJOB.oneofs_by_name[
+    "queries"
+]
+_PIGJOB.oneofs_by_name["queries"].fields.append(_PIGJOB.fields_by_name["query_list"])
+_PIGJOB.fields_by_name["query_list"].containing_oneof = _PIGJOB.oneofs_by_name[
+    "queries"
+]
+_SPARKRJOB_PROPERTIESENTRY.containing_type = _SPARKRJOB
+_SPARKRJOB.fields_by_name["properties"].message_type = _SPARKRJOB_PROPERTIESENTRY
+_SPARKRJOB.fields_by_name["logging_config"].message_type = _LOGGINGCONFIG
+_JOBSTATUS.fields_by_name["state"].enum_type = _JOBSTATUS_STATE
+_JOBSTATUS.fields_by_name[
+    "state_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOBSTATUS.fields_by_name["substate"].enum_type = _JOBSTATUS_SUBSTATE
+_JOBSTATUS_STATE.containing_type = _JOBSTATUS
+_JOBSTATUS_SUBSTATE.containing_type = _JOBSTATUS
+_YARNAPPLICATION.fields_by_name["state"].enum_type = _YARNAPPLICATION_STATE
+_YARNAPPLICATION_STATE.containing_type = _YARNAPPLICATION
+_JOB_LABELSENTRY.containing_type = _JOB
+_JOB.fields_by_name["reference"].message_type = _JOBREFERENCE
+_JOB.fields_by_name["placement"].message_type = _JOBPLACEMENT
+_JOB.fields_by_name["hadoop_job"].message_type = _HADOOPJOB
+_JOB.fields_by_name["spark_job"].message_type = _SPARKJOB
+_JOB.fields_by_name["pyspark_job"].message_type = _PYSPARKJOB
+_JOB.fields_by_name["hive_job"].message_type = _HIVEJOB
+_JOB.fields_by_name["pig_job"].message_type = _PIGJOB
+_JOB.fields_by_name["spark_r_job"].message_type = _SPARKRJOB
+_JOB.fields_by_name["spark_sql_job"].message_type = _SPARKSQLJOB
+_JOB.fields_by_name["status"].message_type = _JOBSTATUS
+_JOB.fields_by_name["status_history"].message_type = _JOBSTATUS
+_JOB.fields_by_name["yarn_applications"].message_type = _YARNAPPLICATION
+_JOB.fields_by_name["labels"].message_type = _JOB_LABELSENTRY
+_JOB.fields_by_name["scheduling"].message_type = _JOBSCHEDULING
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["hadoop_job"])
+_JOB.fields_by_name["hadoop_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["spark_job"])
+_JOB.fields_by_name["spark_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["pyspark_job"])
+_JOB.fields_by_name["pyspark_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["hive_job"])
+_JOB.fields_by_name["hive_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["pig_job"])
+_JOB.fields_by_name["pig_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["spark_r_job"])
+_JOB.fields_by_name["spark_r_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_JOB.oneofs_by_name["type_job"].fields.append(_JOB.fields_by_name["spark_sql_job"])
+_JOB.fields_by_name["spark_sql_job"].containing_oneof = _JOB.oneofs_by_name["type_job"]
+_SUBMITJOBREQUEST.fields_by_name["job"].message_type = _JOB
+_LISTJOBSREQUEST.fields_by_name[
+    "job_state_matcher"
+].enum_type = _LISTJOBSREQUEST_JOBSTATEMATCHER
+_LISTJOBSREQUEST_JOBSTATEMATCHER.containing_type = _LISTJOBSREQUEST
+_UPDATEJOBREQUEST.fields_by_name["job"].message_type = _JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTJOBSRESPONSE.fields_by_name["jobs"].message_type = _JOB
+DESCRIPTOR.message_types_by_name["LoggingConfig"] = _LOGGINGCONFIG
+DESCRIPTOR.message_types_by_name["HadoopJob"] = _HADOOPJOB
+DESCRIPTOR.message_types_by_name["SparkJob"] = _SPARKJOB
+DESCRIPTOR.message_types_by_name["PySparkJob"] = _PYSPARKJOB
+DESCRIPTOR.message_types_by_name["QueryList"] = _QUERYLIST
+DESCRIPTOR.message_types_by_name["HiveJob"] = _HIVEJOB
+DESCRIPTOR.message_types_by_name["SparkSqlJob"] = _SPARKSQLJOB
+DESCRIPTOR.message_types_by_name["PigJob"] = _PIGJOB
+DESCRIPTOR.message_types_by_name["SparkRJob"] = _SPARKRJOB
+DESCRIPTOR.message_types_by_name["JobPlacement"] = _JOBPLACEMENT
+DESCRIPTOR.message_types_by_name["JobStatus"] = _JOBSTATUS
+DESCRIPTOR.message_types_by_name["JobReference"] = _JOBREFERENCE
+DESCRIPTOR.message_types_by_name["YarnApplication"] = _YARNAPPLICATION
+DESCRIPTOR.message_types_by_name["Job"] = _JOB
+DESCRIPTOR.message_types_by_name["JobScheduling"] = _JOBSCHEDULING
+DESCRIPTOR.message_types_by_name["SubmitJobRequest"] = _SUBMITJOBREQUEST
+DESCRIPTOR.message_types_by_name["GetJobRequest"] = _GETJOBREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsRequest"] = _LISTJOBSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateJobRequest"] = _UPDATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsResponse"] = _LISTJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["CancelJobRequest"] = _CANCELJOBREQUEST
+DESCRIPTOR.message_types_by_name["DeleteJobRequest"] = _DELETEJOBREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LoggingConfig = _reflection.GeneratedProtocolMessageType(
+    "LoggingConfig",
+    (_message.Message,),
+    dict(
+        DriverLogLevelsEntry=_reflection.GeneratedProtocolMessageType(
+            "DriverLogLevelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.LoggingConfig.DriverLogLevelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOGGINGCONFIG,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""The runtime logging config of the job.
+  
+  
+  Attributes:
+      driver_log_levels:
+          The per-package log levels for the driver. This may include
+          "root" package name to configure rootLogger. Examples:
+          'com.google = FATAL', 'root = INFO', 'org.apache = DEBUG'
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.LoggingConfig)
+    ),
+)
+_sym_db.RegisterMessage(LoggingConfig)
+_sym_db.RegisterMessage(LoggingConfig.DriverLogLevelsEntry)
+
+HadoopJob = _reflection.GeneratedProtocolMessageType(
+    "HadoopJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HADOOPJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.HadoopJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_HADOOPJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud 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
+  YARN <https://hadoop.apache.org/docs/r2.7.1/hadoop-yarn/hadoop-yarn-site/YARN.html>`__.
+  
+  
+  Attributes:
+      driver:
+          Required. Indicates the location of the driver's main class.
+          Specify either the jar file that contains the main class or
+          the main class name. To specify both, add the jar file to
+          ``jar_file_uris``, and then specify the main class name in
+          this property.
+      main_jar_file_uri:
+          The HCFS URI of the jar file containing the main class.
+          Examples: 'gs://foo-bucket/analytics-binaries/extract-useful-
+          metrics-mr.jar' 'hdfs:/tmp/test-samples/custom-wordcount.jar'
+          'file:///home/usr/lib/hadoop-mapreduce/hadoop-mapreduce-
+          examples.jar'
+      main_class:
+          The name of the driver's main class. The jar file containing
+          the class must be in the default CLASSPATH or specified in
+          ``jar_file_uris``.
+      args:
+          Optional. The arguments to pass to the driver. Do not 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.
+      jar_file_uris:
+          Optional. Jar file URIs to add to the CLASSPATHs of the Hadoop
+          driver and tasks.
+      file_uris:
+          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.
+      archive_uris:
+          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.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/hadoop/conf/\*-site and classes in user
+          code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.HadoopJob)
+    ),
+)
+_sym_db.RegisterMessage(HadoopJob)
+_sym_db.RegisterMessage(HadoopJob.PropertiesEntry)
+
+SparkJob = _reflection.GeneratedProtocolMessageType(
+    "SparkJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SPARKJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  Spark <http://spark.apache.org/>`__ applications on YARN.
+  
+  
+  Attributes:
+      driver:
+          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``.
+      main_jar_file_uri:
+          The HCFS URI of the jar file that contains the main class.
+      main_class:
+          The name of the driver's main class. The jar file that
+          contains the class must be in the default CLASSPATH or
+          specified in ``jar_file_uris``.
+      args:
+          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.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to add to the CLASSPATHs of
+          the Spark driver and tasks.
+      file_uris:
+          Optional. HCFS URIs of files to be copied to the working
+          directory of Spark drivers and distributed tasks. Useful for
+          naively parallel tasks.
+      archive_uris:
+          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.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/spark/conf/spark-defaults.conf and
+          classes in user code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkJob)
+    ),
+)
+_sym_db.RegisterMessage(SparkJob)
+_sym_db.RegisterMessage(SparkJob.PropertiesEntry)
+
+PySparkJob = _reflection.GeneratedProtocolMessageType(
+    "PySparkJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PYSPARKJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.PySparkJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PYSPARKJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  PySpark <https://spark.apache.org/docs/0.9.0/python-programming-guide.html>`__
+  applications on YARN.
+  
+  
+  Attributes:
+      main_python_file_uri:
+          Required. The HCFS URI of the main Python file to use as the
+          driver. Must be a .py file.
+      args:
+          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.
+      python_file_uris:
+          Optional. HCFS file URIs of Python files to pass to the
+          PySpark framework. Supported file types: .py, .egg, and .zip.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to add to the CLASSPATHs of
+          the Python driver and tasks.
+      file_uris:
+          Optional. HCFS URIs of files to be copied to the working
+          directory of Python drivers and distributed tasks. Useful for
+          naively parallel tasks.
+      archive_uris:
+          Optional. HCFS URIs of archives to be extracted in the working
+          directory of .jar, .tar, .tar.gz, .tgz, and .zip.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/spark/conf/spark-defaults.conf and
+          classes in user code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.PySparkJob)
+    ),
+)
+_sym_db.RegisterMessage(PySparkJob)
+_sym_db.RegisterMessage(PySparkJob.PropertiesEntry)
+
+QueryList = _reflection.GeneratedProtocolMessageType(
+    "QueryList",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYLIST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A list of queries to run on a cluster.
+  
+  
+  Attributes:
+      queries:
+          Required. The queries to execute. You do not need to terminate
+          a query with a semicolon. Multiple queries can be specified in
+          one string by separating each with a semicolon. Here is an
+          example of an Cloud Dataproc API snippet that uses a QueryList
+          to specify a HiveJob:  ::      "hiveJob": {       "queryList":
+          {         "queries": [           "query1",           "query2",
+          "query3;query4",         ]       }     }
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.QueryList)
+    ),
+)
+_sym_db.RegisterMessage(QueryList)
+
+HiveJob = _reflection.GeneratedProtocolMessageType(
+    "HiveJob",
+    (_message.Message,),
+    dict(
+        ScriptVariablesEntry=_reflection.GeneratedProtocolMessageType(
+            "ScriptVariablesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HIVEJOB_SCRIPTVARIABLESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.HiveJob.ScriptVariablesEntry)
+            ),
+        ),
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HIVEJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.HiveJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_HIVEJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  Hive <https://hive.apache.org/>`__ queries on YARN.
+  
+  
+  Attributes:
+      queries:
+          Required. The sequence of Hive queries to execute, specified
+          as either an HCFS file URI or a list of queries.
+      query_file_uri:
+          The HCFS URI of the script that contains Hive queries.
+      query_list:
+          A list of queries.
+      continue_on_failure:
+          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.
+      script_variables:
+          Optional. Mapping of query variable names to values
+          (equivalent to the Hive command: ``SET name="value";``).
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/hadoop/conf/\*-site.xml,
+          /etc/hive/conf/hive-site.xml, and classes in user code.
+      jar_file_uris:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.HiveJob)
+    ),
+)
+_sym_db.RegisterMessage(HiveJob)
+_sym_db.RegisterMessage(HiveJob.ScriptVariablesEntry)
+_sym_db.RegisterMessage(HiveJob.PropertiesEntry)
+
+SparkSqlJob = _reflection.GeneratedProtocolMessageType(
+    "SparkSqlJob",
+    (_message.Message,),
+    dict(
+        ScriptVariablesEntry=_reflection.GeneratedProtocolMessageType(
+            "ScriptVariablesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKSQLJOB_SCRIPTVARIABLESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkSqlJob.ScriptVariablesEntry)
+            ),
+        ),
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKSQLJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkSqlJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SPARKSQLJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache Spark
+  SQL <http://spark.apache.org/sql/>`__ queries.
+  
+  
+  Attributes:
+      queries:
+          Required. The sequence of Spark SQL queries to execute,
+          specified as either an HCFS file URI or as a list of queries.
+      query_file_uri:
+          The HCFS URI of the script that contains SQL queries.
+      query_list:
+          A list of queries.
+      script_variables:
+          Optional. Mapping of query variable names to values
+          (equivalent to the Spark SQL command: SET ``name="value";``).
+      properties:
+          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.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to be added to the Spark
+          CLASSPATH.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkSqlJob)
+    ),
+)
+_sym_db.RegisterMessage(SparkSqlJob)
+_sym_db.RegisterMessage(SparkSqlJob.ScriptVariablesEntry)
+_sym_db.RegisterMessage(SparkSqlJob.PropertiesEntry)
+
+PigJob = _reflection.GeneratedProtocolMessageType(
+    "PigJob",
+    (_message.Message,),
+    dict(
+        ScriptVariablesEntry=_reflection.GeneratedProtocolMessageType(
+            "ScriptVariablesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PIGJOB_SCRIPTVARIABLESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.PigJob.ScriptVariablesEntry)
+            ),
+        ),
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PIGJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.PigJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PIGJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  Pig <https://pig.apache.org/>`__ queries on YARN.
+  
+  
+  Attributes:
+      queries:
+          Required. The sequence of Pig queries to execute, specified as
+          an HCFS file URI or a list of queries.
+      query_file_uri:
+          The HCFS URI of the script that contains the Pig queries.
+      query_list:
+          A list of queries.
+      continue_on_failure:
+          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.
+      script_variables:
+          Optional. Mapping of query variable names to values
+          (equivalent to the Pig command: ``name=[value]``).
+      properties:
+          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 overwritten. Can include properties
+          set in /etc/hadoop/conf/\*-site.xml,
+          /etc/pig/conf/pig.properties, and classes in user code.
+      jar_file_uris:
+          Optional. HCFS URIs of jar files to add to the CLASSPATH of
+          the Pig Client and Hadoop MapReduce (MR) tasks. Can contain
+          Pig UDFs.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.PigJob)
+    ),
+)
+_sym_db.RegisterMessage(PigJob)
+_sym_db.RegisterMessage(PigJob.ScriptVariablesEntry)
+_sym_db.RegisterMessage(PigJob.PropertiesEntry)
+
+SparkRJob = _reflection.GeneratedProtocolMessageType(
+    "SparkRJob",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPARKRJOB_PROPERTIESENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkRJob.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SPARKRJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job for running `Apache
+  SparkR <https://spark.apache.org/docs/latest/sparkr.html>`__
+  applications on YARN.
+  
+  
+  Attributes:
+      main_r_file_uri:
+          Required. The HCFS URI of the main R file to use as the
+          driver. Must be a .R file.
+      args:
+          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.
+      file_uris:
+          Optional. HCFS URIs of files to be copied to the working
+          directory of R drivers and distributed tasks. Useful for
+          naively parallel tasks.
+      archive_uris:
+          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.
+      properties:
+          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 overwritten. Can include
+          properties set in /etc/spark/conf/spark-defaults.conf and
+          classes in user code.
+      logging_config:
+          Optional. The runtime log config for job execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SparkRJob)
+    ),
+)
+_sym_db.RegisterMessage(SparkRJob)
+_sym_db.RegisterMessage(SparkRJob.PropertiesEntry)
+
+JobPlacement = _reflection.GeneratedProtocolMessageType(
+    "JobPlacement",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBPLACEMENT,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""Cloud Dataproc job config.
+  
+  
+  Attributes:
+      cluster_name:
+          Required. The name of the cluster where the job will be
+          submitted.
+      cluster_uuid:
+          Output only. A cluster UUID generated by the Cloud Dataproc
+          service when the job is submitted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.JobPlacement)
+    ),
+)
+_sym_db.RegisterMessage(JobPlacement)
+
+JobStatus = _reflection.GeneratedProtocolMessageType(
+    "JobStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBSTATUS,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""Cloud Dataproc job status.
+  
+  
+  Attributes:
+      state:
+          Output only. A state message specifying the overall job state.
+      details:
+          Output only. Optional job state details, such as an error
+          description if the state is ERROR.
+      state_start_time:
+          Output only. The time when this state was entered.
+      substate:
+          Output only. Additional state information, which includes
+          status reported by the agent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.JobStatus)
+    ),
+)
+_sym_db.RegisterMessage(JobStatus)
+
+JobReference = _reflection.GeneratedProtocolMessageType(
+    "JobReference",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBREFERENCE,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""Encapsulates the full scoping used to reference a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      job_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.JobReference)
+    ),
+)
+_sym_db.RegisterMessage(JobReference)
+
+YarnApplication = _reflection.GeneratedProtocolMessageType(
+    "YarnApplication",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_YARNAPPLICATION,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A YARN application created by a job. Application information is a subset
+  of org.apache.hadoop.yarn.proto.YarnProtos.ApplicationReportProto.
+  
+  **Beta Feature**: This report is available for testing purposes only. It
+  may be changed before final release.
+  
+  
+  Attributes:
+      name:
+          Required. The application name.
+      state:
+          Required. The application state.
+      progress:
+          Required. The numerical progress of the application, from 1 to
+          100.
+      tracking_url:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.YarnApplication)
+    ),
+)
+_sym_db.RegisterMessage(YarnApplication)
+
+Job = _reflection.GeneratedProtocolMessageType(
+    "Job",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOB_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.Job.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_JOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A Cloud Dataproc job resource.
+  
+  
+  Attributes:
+      reference:
+          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.
+      placement:
+          Required. Job information, including how, when, and where to
+          run the job.
+      type_job:
+          Required. The application/framework-specific portion of the
+          job.
+      hadoop_job:
+          Job is a Hadoop job.
+      spark_job:
+          Job is a Spark job.
+      pyspark_job:
+          Job is a Pyspark job.
+      hive_job:
+          Job is a Hive job.
+      pig_job:
+          Job is a Pig job.
+      spark_r_job:
+          Job is a SparkR job.
+      spark_sql_job:
+          Job is a SparkSql job.
+      status:
+          Output only. The job status. Additional application-specific
+          status information may be contained in the type\_job and
+          yarn\_applications fields.
+      status_history:
+          Output only. The previous job status.
+      yarn_applications:
+          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.
+      submitted_by:
+          Output only. The email address of the user submitting the job.
+          For jobs submitted on the cluster, the address is
+          username@hostname.
+      driver_output_resource_uri:
+          Output only. A URI pointing to the location of the stdout of
+          the job's driver program.
+      driver_control_files_uri:
+          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``.
+      labels:
+          Optional. The labels to associate with this job. Label
+          **keys** must contain 1 to 63 characters, and must conform to
+          `RFC 1035 <https://www.ietf.org/rfc/rfc1035.txt>`__. Label
+          **values** may be empty, but, if present, must contain 1 to 63
+          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.
+      scheduling:
+          Optional. Job scheduling configuration.
+      job_uuid:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.Job)
+    ),
+)
+_sym_db.RegisterMessage(Job)
+_sym_db.RegisterMessage(Job.LabelsEntry)
+
+JobScheduling = _reflection.GeneratedProtocolMessageType(
+    "JobScheduling",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBSCHEDULING,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""Job scheduling options.
+  
+  
+  Attributes:
+      max_failures_per_hour:
+          Optional. Maximum number of times per hour a driver may be
+          restarted as a result of driver terminating with non-zero code
+          before job is reported failed.  A job may be reported as
+          thrashing if driver exits with non-zero code 4 times within 10
+          minute window.  Maximum value is 10.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.JobScheduling)
+    ),
+)
+_sym_db.RegisterMessage(JobScheduling)
+
+SubmitJobRequest = _reflection.GeneratedProtocolMessageType(
+    "SubmitJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SUBMITJOBREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A request to submit a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job:
+          Required. The job resource.
+      request_id:
+          Optional. A unique id used to identify the request. If the
+          server receives two [SubmitJobRequest][google.cloud.dataproc.v
+          1beta2.SubmitJobRequest] requests with the same id, then the
+          second request will be ignored and the first
+          [Job][google.cloud.dataproc.v1beta2.Job] created and stored in
+          the backend is returned.  It is recommended to always set this
+          value to a `UUID <https://en.wikipedia.org/wiki/Universally_un
+          ique_identifier>`__.  The id must contain only letters (a-z,
+          A-Z), numbers (0-9), underscores (\_), and hyphens (-). The
+          maximum length is 40 characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.SubmitJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(SubmitJobRequest)
+
+GetJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETJOBREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A request to get the resource representation for a job in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.GetJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetJobRequest)
+
+ListJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A request to list jobs in a project.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      page_size:
+          Optional. The number of results to return in each response.
+      page_token:
+          Optional. The page token, returned by a previous call, to
+          request the next page of results.
+      cluster_name:
+          Optional. If set, the returned jobs list includes only jobs
+          that were submitted to the named cluster.
+      job_state_matcher:
+          Optional. Specifies enumerated categories of jobs to list.
+          (default = match ALL jobs).  If ``filter`` is provided,
+          ``jobStateMatcher`` will be ignored.
+      filter:
+          Optional. A filter constraining the jobs to list. Filters are
+          case-sensitive and have the following syntax:  [field = value]
+          AND [field [= value]] ...  where **field** is ``status.state``
+          or ``labels.[KEY]``, and ``[KEY]`` is a label key. **value**
+          can be ``*`` to match all values. ``status.state`` can be
+          either ``ACTIVE`` or ``NON_ACTIVE``. Only the logical ``AND``
+          operator is supported; space-separated items are treated as
+          having an implicit ``AND`` operator.  Example filter:
+          status.state = ACTIVE AND labels.env = staging AND
+          labels.starred = \*
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsRequest)
+
+UpdateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEJOBREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A request to update a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+      job:
+          Required. The changes to the job.
+      update_mask:
+          Required. Specifies the path, relative to Job, of the field to
+          update. For example, to update the labels of a Job the
+          update\_mask parameter would be specified as labels, and the
+          ``PATCH`` request body would specify the new value. Note:
+          Currently, labels is the only field that can be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.UpdateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateJobRequest)
+
+ListJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSRESPONSE,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A list of jobs in a project.
+  
+  
+  Attributes:
+      jobs:
+          Output only. Jobs list.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsResponse)
+
+CancelJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELJOBREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A request to cancel a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.CancelJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelJobRequest)
+
+DeleteJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEJOBREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.jobs_pb2",
+        __doc__="""A request to delete a job.
+  
+  
+  Attributes:
+      project_id:
+          Required. The ID of the Google Cloud Platform project that the
+          job belongs to.
+      region:
+          Required. The Cloud Dataproc region in which to handle the
+          request.
+      job_id:
+          Required. The job ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DeleteJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteJobRequest)
+
+
+DESCRIPTOR._options = None
+_LOGGINGCONFIG_DRIVERLOGLEVELSENTRY._options = None
+_HADOOPJOB_PROPERTIESENTRY._options = None
+_SPARKJOB_PROPERTIESENTRY._options = None
+_PYSPARKJOB_PROPERTIESENTRY._options = None
+_HIVEJOB_SCRIPTVARIABLESENTRY._options = None
+_HIVEJOB_PROPERTIESENTRY._options = None
+_SPARKSQLJOB_SCRIPTVARIABLESENTRY._options = None
+_SPARKSQLJOB_PROPERTIESENTRY._options = None
+_PIGJOB_SCRIPTVARIABLESENTRY._options = None
+_PIGJOB_PROPERTIESENTRY._options = None
+_SPARKRJOB_PROPERTIESENTRY._options = None
+_JOB_LABELSENTRY._options = None
+
+_JOBCONTROLLER = _descriptor.ServiceDescriptor(
+    name="JobController",
+    full_name="google.cloud.dataproc.v1beta2.JobController",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=6207,
+    serialized_end=7242,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="SubmitJob",
+            full_name="google.cloud.dataproc.v1beta2.JobController.SubmitJob",
+            index=0,
+            containing_service=None,
+            input_type=_SUBMITJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v1beta2/projects/{project_id}/regions/{region}/jobs:submit:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetJob",
+            full_name="google.cloud.dataproc.v1beta2.JobController.GetJob",
+            index=1,
+            containing_service=None,
+            input_type=_GETJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002?\022=/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListJobs",
+            full_name="google.cloud.dataproc.v1beta2.JobController.ListJobs",
+            index=2,
+            containing_service=None,
+            input_type=_LISTJOBSREQUEST,
+            output_type=_LISTJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0026\0224/v1beta2/projects/{project_id}/regions/{region}/jobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateJob",
+            full_name="google.cloud.dataproc.v1beta2.JobController.UpdateJob",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002D2=/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}:\003job"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelJob",
+            full_name="google.cloud.dataproc.v1beta2.JobController.CancelJob",
+            index=4,
+            containing_service=None,
+            input_type=_CANCELJOBREQUEST,
+            output_type=_JOB,
+            serialized_options=_b(
+                '\202\323\344\223\002I"D/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}:cancel:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteJob",
+            full_name="google.cloud.dataproc.v1beta2.JobController.DeleteJob",
+            index=5,
+            containing_service=None,
+            input_type=_DELETEJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002?*=/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_JOBCONTROLLER)
+
+DESCRIPTOR.services_by_name["JobController"] = _JOBCONTROLLER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/jobs_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1beta2/proto/jobs_pb2_grpc.py
new file mode 100644
index 000000000000..9a07fdbb8aaa
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/jobs_pb2_grpc.py
@@ -0,0 +1,140 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1beta2.proto import (
+    jobs_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class JobControllerStub(object):
+    """The JobController provides methods to manage jobs.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.SubmitJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.JobController/SubmitJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.SubmitJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.GetJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.JobController/GetJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.GetJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.ListJobs = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.JobController/ListJobs",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.ListJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.ListJobsResponse.FromString,
+        )
+        self.UpdateJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.JobController/UpdateJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.UpdateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.CancelJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.JobController/CancelJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.CancelJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.FromString,
+        )
+        self.DeleteJob = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.JobController/DeleteJob",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.DeleteJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class JobControllerServicer(object):
+    """The JobController provides methods to manage jobs.
+  """
+
+    def SubmitJob(self, request, context):
+        """Submits a job to a cluster.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetJob(self, request, context):
+        """Gets the resource representation for a job in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListJobs(self, request, context):
+        """Lists regions/{region}/jobs in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateJob(self, request, context):
+        """Updates a job in a project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelJob(self, request, context):
+        """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)
+    or
+    [regions/{region}/jobs.get](/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/get).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteJob(self, request, context):
+        """Deletes the job from the project. If the job is active, the delete fails,
+    and the response returns `FAILED_PRECONDITION`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_JobControllerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "SubmitJob": grpc.unary_unary_rpc_method_handler(
+            servicer.SubmitJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.SubmitJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "GetJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.GetJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "ListJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListJobs,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.ListJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.ListJobsResponse.SerializeToString,
+        ),
+        "UpdateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.UpdateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "CancelJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.CancelJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.Job.SerializeToString,
+        ),
+        "DeleteJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteJob,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.DeleteJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1beta2.JobController", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/operations.proto b/dataproc/google/cloud/dataproc_v1beta2/proto/operations.proto
new file mode 100644
index 000000000000..8f9252a46716
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/operations.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.dataproc.v1beta2;
+
+import "google/api/annotations.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 = "OperationsProto";
+option java_package = "com.google.cloud.dataproc.v1beta2";
+
+// The status of the operation.
+message ClusterOperationStatus {
+  // The operation state.
+  enum State {
+    // Unused.
+    UNKNOWN = 0;
+
+    // The operation has been created.
+    PENDING = 1;
+
+    // The operation is running.
+    RUNNING = 2;
+
+    // The operation is done; either cancelled or completed.
+    DONE = 3;
+  }
+
+  // Output only. A message containing the operation state.
+  State state = 1;
+
+  // Output only. A message containing the detailed operation state.
+  string inner_state = 2;
+
+  // Output only. A message containing any operation metadata details.
+  string details = 3;
+
+  // Output only. The time this state was entered.
+  google.protobuf.Timestamp state_start_time = 4;
+}
+
+// Metadata describing the operation.
+message ClusterOperationMetadata {
+  // Output only. Name of the cluster for the operation.
+  string cluster_name = 7;
+
+  // Output only. Cluster UUID for the operation.
+  string cluster_uuid = 8;
+
+  // Output only. Current operation status.
+  ClusterOperationStatus status = 9;
+
+  // Output only. The previous operation status.
+  repeated ClusterOperationStatus status_history = 10;
+
+  // Output only. The operation type.
+  string operation_type = 11;
+
+  // Output only. Short description of operation.
+  string description = 12;
+
+  // Output only. Labels associated with the operation
+  map<string, string> labels = 13;
+
+  // Output only. Errors encountered during operation execution.
+  repeated string warnings = 14;
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/operations_pb2.py b/dataproc/google/cloud/dataproc_v1beta2/proto/operations_pb2.py
new file mode 100644
index 000000000000..6c260f017d19
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/operations_pb2.py
@@ -0,0 +1,471 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1beta2/proto/operations.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1beta2/proto/operations.proto",
+    package="google.cloud.dataproc.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.dataproc.v1beta2B\017OperationsProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/dataproc_v1beta2/proto/operations.proto\x12\x1dgoogle.cloud.dataproc.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xfa\x01\n\x16\x43lusterOperationStatus\x12J\n\x05state\x18\x01 \x01(\x0e\x32;.google.cloud.dataproc.v1beta2.ClusterOperationStatus.State\x12\x13\n\x0binner_state\x18\x02 \x01(\t\x12\x0f\n\x07\x64\x65tails\x18\x03 \x01(\t\x12\x34\n\x10state_start_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"8\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03"\x9f\x03\n\x18\x43lusterOperationMetadata\x12\x14\n\x0c\x63luster_name\x18\x07 \x01(\t\x12\x14\n\x0c\x63luster_uuid\x18\x08 \x01(\t\x12\x45\n\x06status\x18\t \x01(\x0b\x32\x35.google.cloud.dataproc.v1beta2.ClusterOperationStatus\x12M\n\x0estatus_history\x18\n \x03(\x0b\x32\x35.google.cloud.dataproc.v1beta2.ClusterOperationStatus\x12\x16\n\x0eoperation_type\x18\x0b \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x0c \x01(\t\x12S\n\x06labels\x18\r \x03(\x0b\x32\x43.google.cloud.dataproc.v1beta2.ClusterOperationMetadata.LabelsEntry\x12\x10\n\x08warnings\x18\x0e \x03(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42}\n!com.google.cloud.dataproc.v1beta2B\x0fOperationsProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CLUSTEROPERATIONSTATUS_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1beta2.ClusterOperationStatus.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=345,
+    serialized_end=401,
+)
+_sym_db.RegisterEnumDescriptor(_CLUSTEROPERATIONSTATUS_STATE)
+
+
+_CLUSTEROPERATIONSTATUS = _descriptor.Descriptor(
+    name="ClusterOperationStatus",
+    full_name="google.cloud.dataproc.v1beta2.ClusterOperationStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationStatus.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inner_state",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationStatus.inner_state",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationStatus.details",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_start_time",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationStatus.state_start_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CLUSTEROPERATIONSTATUS_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=151,
+    serialized_end=401,
+)
+
+
+_CLUSTEROPERATIONMETADATA_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=774,
+    serialized_end=819,
+)
+
+_CLUSTEROPERATIONMETADATA = _descriptor.Descriptor(
+    name="ClusterOperationMetadata",
+    full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.cluster_name",
+            index=0,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.cluster_uuid",
+            index=1,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.status",
+            index=2,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_history",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.status_history",
+            index=3,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_type",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.operation_type",
+            index=4,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.description",
+            index=5,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.labels",
+            index=6,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="warnings",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperationMetadata.warnings",
+            index=7,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTEROPERATIONMETADATA_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=404,
+    serialized_end=819,
+)
+
+_CLUSTEROPERATIONSTATUS.fields_by_name[
+    "state"
+].enum_type = _CLUSTEROPERATIONSTATUS_STATE
+_CLUSTEROPERATIONSTATUS.fields_by_name[
+    "state_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CLUSTEROPERATIONSTATUS_STATE.containing_type = _CLUSTEROPERATIONSTATUS
+_CLUSTEROPERATIONMETADATA_LABELSENTRY.containing_type = _CLUSTEROPERATIONMETADATA
+_CLUSTEROPERATIONMETADATA.fields_by_name[
+    "status"
+].message_type = _CLUSTEROPERATIONSTATUS
+_CLUSTEROPERATIONMETADATA.fields_by_name[
+    "status_history"
+].message_type = _CLUSTEROPERATIONSTATUS
+_CLUSTEROPERATIONMETADATA.fields_by_name[
+    "labels"
+].message_type = _CLUSTEROPERATIONMETADATA_LABELSENTRY
+DESCRIPTOR.message_types_by_name["ClusterOperationStatus"] = _CLUSTEROPERATIONSTATUS
+DESCRIPTOR.message_types_by_name["ClusterOperationMetadata"] = _CLUSTEROPERATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ClusterOperationStatus = _reflection.GeneratedProtocolMessageType(
+    "ClusterOperationStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTEROPERATIONSTATUS,
+        __module__="google.cloud.dataproc_v1beta2.proto.operations_pb2",
+        __doc__="""The status of the operation.
+  
+  
+  Attributes:
+      state:
+          Output only. A message containing the operation state.
+      inner_state:
+          Output only. A message containing the detailed operation
+          state.
+      details:
+          Output only. A message containing any operation metadata
+          details.
+      state_start_time:
+          Output only. The time this state was entered.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterOperationStatus)
+    ),
+)
+_sym_db.RegisterMessage(ClusterOperationStatus)
+
+ClusterOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "ClusterOperationMetadata",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTEROPERATIONMETADATA_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.operations_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterOperationMetadata.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTEROPERATIONMETADATA,
+        __module__="google.cloud.dataproc_v1beta2.proto.operations_pb2",
+        __doc__="""Metadata describing the operation.
+  
+  
+  Attributes:
+      cluster_name:
+          Output only. Name of the cluster for the operation.
+      cluster_uuid:
+          Output only. Cluster UUID for the operation.
+      status:
+          Output only. Current operation status.
+      status_history:
+          Output only. The previous operation status.
+      operation_type:
+          Output only. The operation type.
+      description:
+          Output only. Short description of operation.
+      labels:
+          Output only. Labels associated with the operation
+      warnings:
+          Output only. Errors encountered during operation execution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ClusterOperationMetadata)
+_sym_db.RegisterMessage(ClusterOperationMetadata.LabelsEntry)
+
+
+DESCRIPTOR._options = None
+_CLUSTEROPERATIONMETADATA_LABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/operations_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1beta2/proto/operations_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/operations_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/shared.proto b/dataproc/google/cloud/dataproc_v1beta2/proto/shared.proto
new file mode 100644
index 000000000000..de1130d9c0b1
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/shared.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.dataproc.v1beta2;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc";
+option java_multiple_files = true;
+option java_outer_classname = "SharedProto";
+option java_package = "com.google.cloud.dataproc.v1beta2";
+
+// Cluster components that can be activated.
+enum Component {
+  // Unspecified component.
+  COMPONENT_UNSPECIFIED = 0;
+
+  // The Anaconda python distribution.
+  ANACONDA = 5;
+
+  // The Druid query engine.
+  DRUID = 9;
+
+  // The Hive Web HCatalog (the REST service for accessing HCatalog).
+  HIVE_WEBHCAT = 3;
+
+  // The Jupyter Notebook.
+  JUPYTER = 1;
+
+  // The Kerberos security feature.
+  KERBEROS = 7;
+
+  // The Presto query engine.
+  PRESTO = 6;
+
+  // The Zeppelin notebook.
+  ZEPPELIN = 4;
+
+  // The Zookeeper service.
+  ZOOKEEPER = 8;
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/shared_pb2.py b/dataproc/google/cloud/dataproc_v1beta2/proto/shared_pb2.py
new file mode 100644
index 000000000000..391bfa139f90
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/shared_pb2.py
@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1beta2/proto/shared.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1beta2/proto/shared.proto",
+    package="google.cloud.dataproc.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.dataproc.v1beta2B\013SharedProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"
+    ),
+    serialized_pb=_b(
+        "\n0google/cloud/dataproc_v1beta2/proto/shared.proto\x12\x1dgoogle.cloud.dataproc.v1beta2\x1a\x1cgoogle/api/annotations.proto*\x95\x01\n\tComponent\x12\x19\n\x15\x43OMPONENT_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x41NACONDA\x10\x05\x12\t\n\x05\x44RUID\x10\t\x12\x10\n\x0cHIVE_WEBHCAT\x10\x03\x12\x0b\n\x07JUPYTER\x10\x01\x12\x0c\n\x08KERBEROS\x10\x07\x12\n\n\x06PRESTO\x10\x06\x12\x0c\n\x08ZEPPELIN\x10\x04\x12\r\n\tZOOKEEPER\x10\x08\x42y\n!com.google.cloud.dataproc.v1beta2B\x0bSharedProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataprocb\x06proto3"
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_COMPONENT = _descriptor.EnumDescriptor(
+    name="Component",
+    full_name="google.cloud.dataproc.v1beta2.Component",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPONENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANACONDA", index=1, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DRUID", index=2, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HIVE_WEBHCAT", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JUPYTER", index=4, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KERBEROS", index=5, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRESTO", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ZEPPELIN", index=7, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ZOOKEEPER", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=114,
+    serialized_end=263,
+)
+_sym_db.RegisterEnumDescriptor(_COMPONENT)
+
+Component = enum_type_wrapper.EnumTypeWrapper(_COMPONENT)
+COMPONENT_UNSPECIFIED = 0
+ANACONDA = 5
+DRUID = 9
+HIVE_WEBHCAT = 3
+JUPYTER = 1
+KERBEROS = 7
+PRESTO = 6
+ZEPPELIN = 4
+ZOOKEEPER = 8
+
+
+DESCRIPTOR.enum_types_by_name["Component"] = _COMPONENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/shared_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1beta2/proto/shared_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/shared_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates.proto b/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates.proto
new file mode 100644
index 000000000000..edaf357cc6c5
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates.proto
@@ -0,0 +1,669 @@
+// 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.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/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 = "WorkflowTemplatesProto";
+option java_package = "com.google.cloud.dataproc.v1beta2";
+
+// The API interface for managing Workflow Templates in the
+// Cloud Dataproc API.
+service WorkflowTemplateService {
+  // Creates new workflow template.
+  rpc CreateWorkflowTemplate(CreateWorkflowTemplateRequest) returns (WorkflowTemplate) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/regions/*}/workflowTemplates"
+      body: "template"
+      additional_bindings {
+        post: "/v1beta2/{parent=projects/*/locations/*}/workflowTemplates"
+        body: "template"
+      }
+    };
+  }
+
+  // Retrieves the latest workflow template.
+  //
+  // Can retrieve previously instantiated template by specifying optional
+  // version parameter.
+  rpc GetWorkflowTemplate(GetWorkflowTemplateRequest) returns (WorkflowTemplate) {
+    option (google.api.http) = {
+      get: "/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}"
+      additional_bindings {
+        get: "/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}"
+      }
+    };
+  }
+
+  // Instantiates a template and begins execution.
+  //
+  // The returned Operation can be used to track execution of
+  // workflow by polling
+  // [operations.get][google.longrunning.Operations.GetOperation].
+  // The Operation will complete when entire workflow is finished.
+  //
+  // The running workflow can be aborted via
+  // [operations.cancel][google.longrunning.Operations.CancelOperation].
+  // This will cause any inflight jobs to be cancelled and workflow-owned
+  // clusters to be deleted.
+  //
+  // The [Operation.metadata][google.longrunning.Operation.metadata] will be
+  // [WorkflowMetadata][google.cloud.dataproc.v1beta2.WorkflowMetadata].
+  //
+  // On successful completion,
+  // [Operation.response][google.longrunning.Operation.response] will be
+  // [Empty][google.protobuf.Empty].
+  rpc InstantiateWorkflowTemplate(InstantiateWorkflowTemplateRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}:instantiate"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}:instantiate"
+        body: "*"
+      }
+    };
+  }
+
+  // Instantiates a template and begins execution.
+  //
+  // This method is equivalent to executing the sequence
+  // [CreateWorkflowTemplate][google.cloud.dataproc.v1beta2.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1beta2.WorkflowTemplateService.InstantiateWorkflowTemplate],
+  // [DeleteWorkflowTemplate][google.cloud.dataproc.v1beta2.WorkflowTemplateService.DeleteWorkflowTemplate].
+  //
+  // The returned Operation can be used to track execution of
+  // workflow by polling
+  // [operations.get][google.longrunning.Operations.GetOperation].
+  // The Operation will complete when entire workflow is finished.
+  //
+  // The running workflow can be aborted via
+  // [operations.cancel][google.longrunning.Operations.CancelOperation].
+  // This will cause any inflight jobs to be cancelled and workflow-owned
+  // clusters to be deleted.
+  //
+  // The [Operation.metadata][google.longrunning.Operation.metadata] will be
+  // [WorkflowMetadata][google.cloud.dataproc.v1beta2.WorkflowMetadata].
+  //
+  // On successful completion,
+  // [Operation.response][google.longrunning.Operation.response] will be
+  // [Empty][google.protobuf.Empty].
+  rpc InstantiateInlineWorkflowTemplate(InstantiateInlineWorkflowTemplateRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/locations/*}/workflowTemplates:instantiateInline"
+      body: "template"
+      additional_bindings {
+        post: "/v1beta2/{parent=projects/*/regions/*}/workflowTemplates:instantiateInline"
+        body: "template"
+      }
+    };
+  }
+
+  // Updates (replaces) workflow template. The updated template
+  // must contain version that matches the current server version.
+  rpc UpdateWorkflowTemplate(UpdateWorkflowTemplateRequest) returns (WorkflowTemplate) {
+    option (google.api.http) = {
+      put: "/v1beta2/{template.name=projects/*/regions/*/workflowTemplates/*}"
+      body: "template"
+      additional_bindings {
+        put: "/v1beta2/{template.name=projects/*/locations/*/workflowTemplates/*}"
+        body: "template"
+      }
+    };
+  }
+
+  // Lists workflows that match the specified filter in the request.
+  rpc ListWorkflowTemplates(ListWorkflowTemplatesRequest) returns (ListWorkflowTemplatesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta2/{parent=projects/*/regions/*}/workflowTemplates"
+      additional_bindings {
+        get: "/v1beta2/{parent=projects/*/locations/*}/workflowTemplates"
+      }
+    };
+  }
+
+  // Deletes a workflow template. It does not cancel in-progress workflows.
+  rpc DeleteWorkflowTemplate(DeleteWorkflowTemplateRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}"
+      additional_bindings {
+        delete: "/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}"
+      }
+    };
+  }
+}
+
+// A Cloud 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;
+
+  // 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;
+
+  // Optional. Used to perform a consistent read-modify-write.
+  //
+  // This field should be left blank for a `CreateWorkflowTemplate` request. It
+  // is required for an `UpdateWorkflowTemplate` request, and must match the
+  // current server version. A typical update template flow would fetch the
+  // current template with a `GetWorkflowTemplate` request, which will return
+  // 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;
+
+  // Output only. The time template was created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. The time template was last updated.
+  google.protobuf.Timestamp update_time = 5;
+
+  // Optional. The labels to associate with this template. These labels
+  // will be propagated to all jobs and clusters created by the workflow
+  // instance.
+  //
+  // Label **keys** must contain 1 to 63 characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  //
+  // Label **values** may be empty, but, if present, must contain 1 to 63
+  // characters, and must conform to
+  // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt).
+  //
+  // No more than 32 labels can be associated with a template.
+  map<string, string> labels = 6;
+
+  // Required. WorkflowTemplate scheduling information.
+  WorkflowTemplatePlacement placement = 7;
+
+  // Required. The Directed Acyclic Graph of Jobs to submit.
+  repeated OrderedJob jobs = 8;
+
+  // 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;
+}
+
+// Specifies workflow execution target.
+//
+// Either `managed_cluster` or `cluster_selector` is required.
+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.
+    ManagedCluster managed_cluster = 1;
+
+    // Optional. A selector that chooses target cluster for jobs based
+    // on metadata.
+    //
+    // The selector is evaluated at the time each job is submitted.
+    ClusterSelector cluster_selector = 2;
+  }
+}
+
+// Cluster that is managed by the workflow.
+message ManagedCluster {
+  // Required. The cluster name prefix. A unique cluster name will be formed by
+  // appending a random suffix.
+  //
+  // 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;
+
+  // Required. The cluster configuration.
+  ClusterConfig config = 3;
+
+  // Optional. The labels to associate with this cluster.
+  //
+  // Label keys must be between 1 and 63 characters long, 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 1 and 63 characters long, and must conform to
+  // 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<string, string> labels = 4;
+}
+
+// A selector that chooses target cluster for jobs based on metadata.
+message ClusterSelector {
+  // Optional. The zone where workflow process executes. This parameter does not
+  // affect the selection of the cluster.
+  //
+  // If unspecified, the zone of the first cluster matching the selector
+  // is used.
+  string zone = 1;
+
+  // Required. The cluster labels. Cluster must have all labels
+  // to match.
+  map<string, string> cluster_labels = 2;
+}
+
+// A job executed by the workflow.
+message OrderedJob {
+  // Required. The step id. The id must be unique among all jobs
+  // within the template.
+  //
+  // The step id is used as prefix for job id, as job
+  // `goog-dataproc-workflow-step-id` label, and in
+  // [prerequisiteStepIds][google.cloud.dataproc.v1beta2.OrderedJob.prerequisite_step_ids] field from other
+  // steps.
+  //
+  // 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;
+
+  // 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.
+    SparkSqlJob spark_sql_job = 7;
+  }
+
+  // Optional. The labels to associate with this job.
+  //
+  // Label keys must be between 1 and 63 characters long, and must conform to
+  // the following regular expression:
+  // [\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}
+  //
+  // Label values must be between 1 and 63 characters long, and must conform to
+  // 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<string, string> labels = 8;
+
+  // Optional. Job scheduling configuration.
+  JobScheduling scheduling = 9;
+
+  // 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;
+}
+
+// A configurable parameter that replaces one or more fields in the template.
+// Parameterizable fields:
+// - Labels
+// - File uris
+// - Job properties
+// - Job arguments
+// - Script variables
+// - Main class (in HadoopJob and SparkJob)
+// - Zone (in ClusterSelector)
+message TemplateParameter {
+  // 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;
+
+  // Required. Paths to all fields that the parameter replaces.
+  // A field is allowed to appear in at most one parameter's list of field
+  // paths.
+  //
+  // A field path is similar in syntax to a [google.protobuf.FieldMask][google.protobuf.FieldMask].
+  // For example, a field path that references the zone field of a workflow
+  // template's cluster selector would be specified as
+  // `placement.clusterSelector.zone`.
+  //
+  // Also, field paths can reference fields using the following syntax:
+  //
+  // * Values in maps can be referenced by key:
+  //     * labels['key']
+  //     * placement.clusterSelector.clusterLabels['key']
+  //     * placement.managedCluster.labels['key']
+  //     * placement.clusterSelector.clusterLabels['key']
+  //     * jobs['step-id'].labels['key']
+  //
+  // * Jobs in the jobs list can be referenced by step-id:
+  //     * jobs['step-id'].hadoopJob.mainJarFileUri
+  //     * jobs['step-id'].hiveJob.queryFileUri
+  //     * jobs['step-id'].pySparkJob.mainPythonFileUri
+  //     * jobs['step-id'].hadoopJob.jarFileUris[0]
+  //     * jobs['step-id'].hadoopJob.archiveUris[0]
+  //     * jobs['step-id'].hadoopJob.fileUris[0]
+  //     * jobs['step-id'].pySparkJob.pythonFileUris[0]
+  //
+  // * Items in repeated fields can be referenced by a zero-based index:
+  //     * jobs['step-id'].sparkJob.args[0]
+  //
+  // * Other examples:
+  //     * jobs['step-id'].hadoopJob.properties['key']
+  //     * jobs['step-id'].hadoopJob.args[0]
+  //     * jobs['step-id'].hiveJob.scriptVariables['key']
+  //     * jobs['step-id'].hadoopJob.mainJarFileUri
+  //     * placement.clusterSelector.zone
+  //
+  // It may not be possible to parameterize maps and repeated fields in their
+  // entirety since only individual map values and individual items in repeated
+  // fields can be referenced. For example, the following field paths are
+  // invalid:
+  //
+  // - placement.clusterSelector.clusterLabels
+  // - jobs['step-id'].sparkJob.args
+  repeated string fields = 2;
+
+  // Optional. Brief description of the parameter.
+  // Must not exceed 1024 characters.
+  string description = 3;
+
+  // Optional. Validation rules to be applied to this parameter's value.
+  ParameterValidation validation = 4;
+}
+
+// Configuration for parameter validation.
+message ParameterValidation {
+  // Required. The type of validation to be performed.
+  oneof validation_type {
+    // Validation based on regular expressions.
+    RegexValidation regex = 1;
+
+    // Validation based on a list of allowed values.
+    ValueValidation values = 2;
+  }
+}
+
+// Validation based on regular expressions.
+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;
+}
+
+// Validation based on a list of allowed values.
+message ValueValidation {
+  // Required. List of allowed values for the parameter.
+  repeated string values = 1;
+}
+
+// A Cloud Dataproc workflow template resource.
+message WorkflowMetadata {
+  // The operation state.
+  enum State {
+    // Unused.
+    UNKNOWN = 0;
+
+    // The operation has been created.
+    PENDING = 1;
+
+    // The operation is running.
+    RUNNING = 2;
+
+    // The operation is done; either cancelled or completed.
+    DONE = 3;
+  }
+
+  // Output only. The "resource name" of the template.
+  string template = 1;
+
+  // Output only. The version of template at the time of
+  // workflow instantiation.
+  int32 version = 2;
+
+  // Output only. The create cluster operation metadata.
+  ClusterOperation create_cluster = 3;
+
+  // Output only. The workflow graph.
+  WorkflowGraph graph = 4;
+
+  // Output only. The delete cluster operation metadata.
+  ClusterOperation delete_cluster = 5;
+
+  // Output only. The workflow state.
+  State state = 6;
+
+  // Output only. The name of the target cluster.
+  string cluster_name = 7;
+
+  // Map from parameter names to values that were used for those parameters.
+  map<string, string> parameters = 8;
+
+  // Output only. Workflow start time.
+  google.protobuf.Timestamp start_time = 9;
+
+  // Output only. Workflow end time.
+  google.protobuf.Timestamp end_time = 10;
+
+  // Output only. The UUID of target cluster.
+  string cluster_uuid = 11;
+}
+
+// The cluster operation triggered by a workflow.
+message ClusterOperation {
+  // Output only. The id of the cluster operation.
+  string operation_id = 1;
+
+  // Output only. Error, if operation failed.
+  string error = 2;
+
+  // Output only. Indicates the operation is done.
+  bool done = 3;
+}
+
+// The workflow graph.
+message WorkflowGraph {
+  // Output only. The workflow nodes.
+  repeated WorkflowNode nodes = 1;
+}
+
+// The workflow node.
+message WorkflowNode {
+  // The workflow node state.
+  enum NodeState {
+    // State is unspecified.
+    NODE_STATUS_UNSPECIFIED = 0;
+
+    // The node is awaiting prerequisite node to finish.
+    BLOCKED = 1;
+
+    // The node is runnable but not running.
+    RUNNABLE = 2;
+
+    // The node is running.
+    RUNNING = 3;
+
+    // The node completed successfully.
+    COMPLETED = 4;
+
+    // The node failed. A node can be marked FAILED because
+    // its ancestor or peer failed.
+    FAILED = 5;
+  }
+
+  // Output only. The name of the node.
+  string step_id = 1;
+
+  // Output only. Node's prerequisite nodes.
+  repeated string prerequisite_step_ids = 2;
+
+  // Output only. The job id; populated after the node enters RUNNING state.
+  string job_id = 3;
+
+  // Output only. The node state.
+  NodeState state = 5;
+
+  // Output only. The error detail.
+  string error = 6;
+}
+
+// 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 Dataproc workflow template to create.
+  WorkflowTemplate template = 2;
+}
+
+// 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;
+
+  // Optional. The version of workflow template to retrieve. Only previously
+  // instatiated versions can be retrieved.
+  //
+  // If unspecified, retrieves the current version.
+  int32 version = 2;
+}
+
+// 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;
+
+  // Optional. The version of workflow template to instantiate. If specified,
+  // the workflow will be instantiated only if the current version of
+  // the workflow template has the supplied version.
+  //
+  // This option cannot be used to instantiate a previous version of
+  // workflow template.
+  int32 version = 2;
+
+  // Deprecated. Please use `request_id` field instead.
+  string instance_id = 3 [deprecated = true];
+
+  // Optional. A tag that prevents multiple concurrent workflow
+  // instances with the same tag from running. This mitigates risk of
+  // concurrent instances started due to retries.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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;
+
+  // Optional. Map from parameter names to values that should be used for those
+  // parameters. Values may not exceed 100 characters.
+  map<string, string> parameters = 4;
+}
+
+// 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 workflow template to instantiate.
+  WorkflowTemplate template = 2;
+
+  // Deprecated. Please use `request_id` field instead.
+  string instance_id = 3;
+
+  // Optional. A tag that prevents multiple concurrent workflow
+  // instances with the same tag from running. This mitigates risk of
+  // concurrent instances started due to retries.
+  //
+  // It is recommended to always set this value to a
+  // [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier).
+  //
+  // 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 = 4;
+}
+
+// A request to update a workflow template.
+message UpdateWorkflowTemplateRequest {
+  // Required. The updated workflow template.
+  //
+  // The `template.version` field must match the current version.
+  WorkflowTemplate template = 1;
+}
+
+// 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;
+
+  // Optional. The maximum number of results to return in each response.
+  int32 page_size = 2;
+
+  // Optional. The page token, returned by a previous call, to request the
+  // next page of results.
+  string page_token = 3;
+}
+
+// A response to a request to list workflow templates in a project.
+message ListWorkflowTemplatesResponse {
+  // Output only. WorkflowTemplates list.
+  repeated WorkflowTemplate templates = 1;
+
+  // 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 <code>ListWorkflowTemplatesRequest</code>.
+  string next_page_token = 2;
+}
+
+// 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;
+
+  // 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;
+}
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates_pb2.py b/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates_pb2.py
new file mode 100644
index 000000000000..850d445dff25
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates_pb2.py
@@ -0,0 +1,3272 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/dataproc_v1beta2/proto/workflow_templates.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.dataproc_v1beta2.proto import (
+    clusters_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2,
+)
+from google.cloud.dataproc_v1beta2.proto import (
+    jobs_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/dataproc_v1beta2/proto/workflow_templates.proto",
+    package="google.cloud.dataproc.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.dataproc.v1beta2B\026WorkflowTemplatesProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"
+    ),
+    serialized_pb=_b(
+        '\n<google/cloud/dataproc_v1beta2/proto/workflow_templates.proto\x12\x1dgoogle.cloud.dataproc.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/dataproc_v1beta2/proto/clusters.proto\x1a.google/cloud/dataproc_v1beta2/proto/jobs.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xe7\x03\n\x10WorkflowTemplate\x12\n\n\x02id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x03 \x01(\x05\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12K\n\x06labels\x18\x06 \x03(\x0b\x32;.google.cloud.dataproc.v1beta2.WorkflowTemplate.LabelsEntry\x12K\n\tplacement\x18\x07 \x01(\x0b\x32\x38.google.cloud.dataproc.v1beta2.WorkflowTemplatePlacement\x12\x37\n\x04jobs\x18\x08 \x03(\x0b\x32).google.cloud.dataproc.v1beta2.OrderedJob\x12\x44\n\nparameters\x18\t \x03(\x0b\x32\x30.google.cloud.dataproc.v1beta2.TemplateParameter\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xbe\x01\n\x19WorkflowTemplatePlacement\x12H\n\x0fmanaged_cluster\x18\x01 \x01(\x0b\x32-.google.cloud.dataproc.v1beta2.ManagedClusterH\x00\x12J\n\x10\x63luster_selector\x18\x02 \x01(\x0b\x32..google.cloud.dataproc.v1beta2.ClusterSelectorH\x00\x42\x0b\n\tplacement"\xde\x01\n\x0eManagedCluster\x12\x14\n\x0c\x63luster_name\x18\x02 \x01(\t\x12<\n\x06\x63onfig\x18\x03 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.ClusterConfig\x12I\n\x06labels\x18\x04 \x03(\x0b\x32\x39.google.cloud.dataproc.v1beta2.ManagedCluster.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xb0\x01\n\x0f\x43lusterSelector\x12\x0c\n\x04zone\x18\x01 \x01(\t\x12Y\n\x0e\x63luster_labels\x18\x02 \x03(\x0b\x32\x41.google.cloud.dataproc.v1beta2.ClusterSelector.ClusterLabelsEntry\x1a\x34\n\x12\x43lusterLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xfb\x04\n\nOrderedJob\x12\x0f\n\x07step_id\x18\x01 \x01(\t\x12>\n\nhadoop_job\x18\x02 \x01(\x0b\x32(.google.cloud.dataproc.v1beta2.HadoopJobH\x00\x12<\n\tspark_job\x18\x03 \x01(\x0b\x32\'.google.cloud.dataproc.v1beta2.SparkJobH\x00\x12@\n\x0bpyspark_job\x18\x04 \x01(\x0b\x32).google.cloud.dataproc.v1beta2.PySparkJobH\x00\x12:\n\x08hive_job\x18\x05 \x01(\x0b\x32&.google.cloud.dataproc.v1beta2.HiveJobH\x00\x12\x38\n\x07pig_job\x18\x06 \x01(\x0b\x32%.google.cloud.dataproc.v1beta2.PigJobH\x00\x12\x43\n\rspark_sql_job\x18\x07 \x01(\x0b\x32*.google.cloud.dataproc.v1beta2.SparkSqlJobH\x00\x12\x45\n\x06labels\x18\x08 \x03(\x0b\x32\x35.google.cloud.dataproc.v1beta2.OrderedJob.LabelsEntry\x12@\n\nscheduling\x18\t \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.JobScheduling\x12\x1d\n\x15prerequisite_step_ids\x18\n \x03(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\n\n\x08job_type"\x8e\x01\n\x11TemplateParameter\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x66ields\x18\x02 \x03(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x46\n\nvalidation\x18\x04 \x01(\x0b\x32\x32.google.cloud.dataproc.v1beta2.ParameterValidation"\xab\x01\n\x13ParameterValidation\x12?\n\x05regex\x18\x01 \x01(\x0b\x32..google.cloud.dataproc.v1beta2.RegexValidationH\x00\x12@\n\x06values\x18\x02 \x01(\x0b\x32..google.cloud.dataproc.v1beta2.ValueValidationH\x00\x42\x11\n\x0fvalidation_type""\n\x0fRegexValidation\x12\x0f\n\x07regexes\x18\x01 \x03(\t"!\n\x0fValueValidation\x12\x0e\n\x06values\x18\x01 \x03(\t"\x96\x05\n\x10WorkflowMetadata\x12\x10\n\x08template\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05\x12G\n\x0e\x63reate_cluster\x18\x03 \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.ClusterOperation\x12;\n\x05graph\x18\x04 \x01(\x0b\x32,.google.cloud.dataproc.v1beta2.WorkflowGraph\x12G\n\x0e\x64\x65lete_cluster\x18\x05 \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.ClusterOperation\x12\x44\n\x05state\x18\x06 \x01(\x0e\x32\x35.google.cloud.dataproc.v1beta2.WorkflowMetadata.State\x12\x14\n\x0c\x63luster_name\x18\x07 \x01(\t\x12S\n\nparameters\x18\x08 \x03(\x0b\x32?.google.cloud.dataproc.v1beta2.WorkflowMetadata.ParametersEntry\x12.\n\nstart_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x14\n\x0c\x63luster_uuid\x18\x0b \x01(\t\x1a\x31\n\x0fParametersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"8\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03"E\n\x10\x43lusterOperation\x12\x14\n\x0coperation_id\x18\x01 \x01(\t\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x0c\n\x04\x64one\x18\x03 \x01(\x08"K\n\rWorkflowGraph\x12:\n\x05nodes\x18\x01 \x03(\x0b\x32+.google.cloud.dataproc.v1beta2.WorkflowNode"\x90\x02\n\x0cWorkflowNode\x12\x0f\n\x07step_id\x18\x01 \x01(\t\x12\x1d\n\x15prerequisite_step_ids\x18\x02 \x03(\t\x12\x0e\n\x06job_id\x18\x03 \x01(\t\x12\x44\n\x05state\x18\x05 \x01(\x0e\x32\x35.google.cloud.dataproc.v1beta2.WorkflowNode.NodeState\x12\r\n\x05\x65rror\x18\x06 \x01(\t"k\n\tNodeState\x12\x1b\n\x17NODE_STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x42LOCKED\x10\x01\x12\x0c\n\x08RUNNABLE\x10\x02\x12\x0b\n\x07RUNNING\x10\x03\x12\r\n\tCOMPLETED\x10\x04\x12\n\n\x06\x46\x41ILED\x10\x05"r\n\x1d\x43reateWorkflowTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x41\n\x08template\x18\x02 \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.WorkflowTemplate";\n\x1aGetWorkflowTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05"\x8a\x02\n"InstantiateWorkflowTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05\x12\x17\n\x0binstance_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x12\n\nrequest_id\x18\x05 \x01(\t\x12\x65\n\nparameters\x18\x04 \x03(\x0b\x32Q.google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.ParametersEntry\x1a\x31\n\x0fParametersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xa6\x01\n(InstantiateInlineWorkflowTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x41\n\x08template\x18\x02 \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.WorkflowTemplate\x12\x13\n\x0binstance_id\x18\x03 \x01(\t\x12\x12\n\nrequest_id\x18\x04 \x01(\t"b\n\x1dUpdateWorkflowTemplateRequest\x12\x41\n\x08template\x18\x01 \x01(\x0b\x32/.google.cloud.dataproc.v1beta2.WorkflowTemplate"U\n\x1cListWorkflowTemplatesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"|\n\x1dListWorkflowTemplatesResponse\x12\x42\n\ttemplates\x18\x01 \x03(\x0b\x32/.google.cloud.dataproc.v1beta2.WorkflowTemplate\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t">\n\x1d\x44\x65leteWorkflowTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\x05\x32\xdf\x0f\n\x17WorkflowTemplateService\x12\x9d\x02\n\x16\x43reateWorkflowTemplate\x12<.google.cloud.dataproc.v1beta2.CreateWorkflowTemplateRequest\x1a/.google.cloud.dataproc.v1beta2.WorkflowTemplate"\x93\x01\x82\xd3\xe4\x93\x02\x8c\x01"8/v1beta2/{parent=projects/*/regions/*}/workflowTemplates:\x08templateZF":/v1beta2/{parent=projects/*/locations/*}/workflowTemplates:\x08template\x12\x81\x02\n\x13GetWorkflowTemplate\x12\x39.google.cloud.dataproc.v1beta2.GetWorkflowTemplateRequest\x1a/.google.cloud.dataproc.v1beta2.WorkflowTemplate"~\x82\xd3\xe4\x93\x02x\x12\x38/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}Z<\x12:/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}\x12\x9f\x02\n\x1bInstantiateWorkflowTemplate\x12\x41.google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest\x1a\x1d.google.longrunning.Operation"\x9d\x01\x82\xd3\xe4\x93\x02\x96\x01"D/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}:instantiate:\x01*ZK"F/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}:instantiate:\x01*\x12\xc5\x02\n!InstantiateInlineWorkflowTemplate\x12G.google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest\x1a\x1d.google.longrunning.Operation"\xb7\x01\x82\xd3\xe4\x93\x02\xb0\x01"L/v1beta2/{parent=projects/*/locations/*}/workflowTemplates:instantiateInline:\x08templateZV"J/v1beta2/{parent=projects/*/regions/*}/workflowTemplates:instantiateInline:\x08template\x12\xaf\x02\n\x16UpdateWorkflowTemplate\x12<.google.cloud.dataproc.v1beta2.UpdateWorkflowTemplateRequest\x1a/.google.cloud.dataproc.v1beta2.WorkflowTemplate"\xa5\x01\x82\xd3\xe4\x93\x02\x9e\x01\x1a\x41/v1beta2/{template.name=projects/*/regions/*/workflowTemplates/*}:\x08templateZO\x1a\x43/v1beta2/{template.name=projects/*/locations/*/workflowTemplates/*}:\x08template\x12\x92\x02\n\x15ListWorkflowTemplates\x12;.google.cloud.dataproc.v1beta2.ListWorkflowTemplatesRequest\x1a<.google.cloud.dataproc.v1beta2.ListWorkflowTemplatesResponse"~\x82\xd3\xe4\x93\x02x\x12\x38/v1beta2/{parent=projects/*/regions/*}/workflowTemplatesZ<\x12:/v1beta2/{parent=projects/*/locations/*}/workflowTemplates\x12\xee\x01\n\x16\x44\x65leteWorkflowTemplate\x12<.google.cloud.dataproc.v1beta2.DeleteWorkflowTemplateRequest\x1a\x16.google.protobuf.Empty"~\x82\xd3\xe4\x93\x02x*8/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}Z<*:/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}B\x84\x01\n!com.google.cloud.dataproc.v1beta2B\x16WorkflowTemplatesProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataprocb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_WORKFLOWMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3046,
+    serialized_end=3102,
+)
+_sym_db.RegisterEnumDescriptor(_WORKFLOWMETADATA_STATE)
+
+_WORKFLOWNODE_NODESTATE = _descriptor.EnumDescriptor(
+    name="NodeState",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowNode.NodeState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NODE_STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BLOCKED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3418,
+    serialized_end=3525,
+)
+_sym_db.RegisterEnumDescriptor(_WORKFLOWNODE_NODESTATE)
+
+
+_WORKFLOWTEMPLATE_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=767,
+    serialized_end=812,
+)
+
+_WORKFLOWTEMPLATE = _descriptor.Descriptor(
+    name="WorkflowTemplate",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.name",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.version",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.update_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.labels",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="placement",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.placement",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.jobs",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplate.parameters",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WORKFLOWTEMPLATE_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=325,
+    serialized_end=812,
+)
+
+
+_WORKFLOWTEMPLATEPLACEMENT = _descriptor.Descriptor(
+    name="WorkflowTemplatePlacement",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowTemplatePlacement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="managed_cluster",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplatePlacement.managed_cluster",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_selector",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplatePlacement.cluster_selector",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="placement",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplatePlacement.placement",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=815,
+    serialized_end=1005,
+)
+
+
+_MANAGEDCLUSTER_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.ManagedCluster.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.ManagedCluster.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.ManagedCluster.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=767,
+    serialized_end=812,
+)
+
+_MANAGEDCLUSTER = _descriptor.Descriptor(
+    name="ManagedCluster",
+    full_name="google.cloud.dataproc.v1beta2.ManagedCluster",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.ManagedCluster.cluster_name",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.dataproc.v1beta2.ManagedCluster.config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1beta2.ManagedCluster.labels",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MANAGEDCLUSTER_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1008,
+    serialized_end=1230,
+)
+
+
+_CLUSTERSELECTOR_CLUSTERLABELSENTRY = _descriptor.Descriptor(
+    name="ClusterLabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.ClusterSelector.ClusterLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.ClusterSelector.ClusterLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.ClusterSelector.ClusterLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1357,
+    serialized_end=1409,
+)
+
+_CLUSTERSELECTOR = _descriptor.Descriptor(
+    name="ClusterSelector",
+    full_name="google.cloud.dataproc.v1beta2.ClusterSelector",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="zone",
+            full_name="google.cloud.dataproc.v1beta2.ClusterSelector.zone",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_labels",
+            full_name="google.cloud.dataproc.v1beta2.ClusterSelector.cluster_labels",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLUSTERSELECTOR_CLUSTERLABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1233,
+    serialized_end=1409,
+)
+
+
+_ORDEREDJOB_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.dataproc.v1beta2.OrderedJob.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=767,
+    serialized_end=812,
+)
+
+_ORDEREDJOB = _descriptor.Descriptor(
+    name="OrderedJob",
+    full_name="google.cloud.dataproc.v1beta2.OrderedJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="step_id",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.step_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hadoop_job",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.hadoop_job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_job",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.spark_job",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pyspark_job",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.pyspark_job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hive_job",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.hive_job",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pig_job",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.pig_job",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spark_sql_job",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.spark_sql_job",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.labels",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scheduling",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.scheduling",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="prerequisite_step_ids",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.prerequisite_step_ids",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ORDEREDJOB_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="job_type",
+            full_name="google.cloud.dataproc.v1beta2.OrderedJob.job_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1412,
+    serialized_end=2047,
+)
+
+
+_TEMPLATEPARAMETER = _descriptor.Descriptor(
+    name="TemplateParameter",
+    full_name="google.cloud.dataproc.v1beta2.TemplateParameter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.TemplateParameter.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.dataproc.v1beta2.TemplateParameter.fields",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.dataproc.v1beta2.TemplateParameter.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validation",
+            full_name="google.cloud.dataproc.v1beta2.TemplateParameter.validation",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2050,
+    serialized_end=2192,
+)
+
+
+_PARAMETERVALIDATION = _descriptor.Descriptor(
+    name="ParameterValidation",
+    full_name="google.cloud.dataproc.v1beta2.ParameterValidation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="regex",
+            full_name="google.cloud.dataproc.v1beta2.ParameterValidation.regex",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.cloud.dataproc.v1beta2.ParameterValidation.values",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="validation_type",
+            full_name="google.cloud.dataproc.v1beta2.ParameterValidation.validation_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2195,
+    serialized_end=2366,
+)
+
+
+_REGEXVALIDATION = _descriptor.Descriptor(
+    name="RegexValidation",
+    full_name="google.cloud.dataproc.v1beta2.RegexValidation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="regexes",
+            full_name="google.cloud.dataproc.v1beta2.RegexValidation.regexes",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2368,
+    serialized_end=2402,
+)
+
+
+_VALUEVALIDATION = _descriptor.Descriptor(
+    name="ValueValidation",
+    full_name="google.cloud.dataproc.v1beta2.ValueValidation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.cloud.dataproc.v1beta2.ValueValidation.values",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2404,
+    serialized_end=2437,
+)
+
+
+_WORKFLOWMETADATA_PARAMETERSENTRY = _descriptor.Descriptor(
+    name="ParametersEntry",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.ParametersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.ParametersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.ParametersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2995,
+    serialized_end=3044,
+)
+
+_WORKFLOWMETADATA = _descriptor.Descriptor(
+    name="WorkflowMetadata",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.template",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_cluster",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.create_cluster",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="graph",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.graph",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_cluster",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.delete_cluster",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.state",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_name",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.cluster_name",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.parameters",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.start_time",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.end_time",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cluster_uuid",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowMetadata.cluster_uuid",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WORKFLOWMETADATA_PARAMETERSENTRY],
+    enum_types=[_WORKFLOWMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2440,
+    serialized_end=3102,
+)
+
+
+_CLUSTEROPERATION = _descriptor.Descriptor(
+    name="ClusterOperation",
+    full_name="google.cloud.dataproc.v1beta2.ClusterOperation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperation.operation_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperation.error",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="done",
+            full_name="google.cloud.dataproc.v1beta2.ClusterOperation.done",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3104,
+    serialized_end=3173,
+)
+
+
+_WORKFLOWGRAPH = _descriptor.Descriptor(
+    name="WorkflowGraph",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowGraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="nodes",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowGraph.nodes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3175,
+    serialized_end=3250,
+)
+
+
+_WORKFLOWNODE = _descriptor.Descriptor(
+    name="WorkflowNode",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowNode",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="step_id",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowNode.step_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="prerequisite_step_ids",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowNode.prerequisite_step_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowNode.job_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowNode.state",
+            index=3,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowNode.error",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_WORKFLOWNODE_NODESTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3253,
+    serialized_end=3525,
+)
+
+
+_CREATEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="CreateWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1beta2.CreateWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1beta2.CreateWorkflowTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1beta2.CreateWorkflowTemplateRequest.template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3527,
+    serialized_end=3641,
+)
+
+
+_GETWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="GetWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1beta2.GetWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.GetWorkflowTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1beta2.GetWorkflowTemplateRequest.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3643,
+    serialized_end=3702,
+)
+
+
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY = _descriptor.Descriptor(
+    name="ParametersEntry",
+    full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.ParametersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.ParametersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.ParametersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2995,
+    serialized_end=3044,
+)
+
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="InstantiateWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.instance_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.request_id",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parameters",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.parameters",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3705,
+    serialized_end=3971,
+)
+
+
+_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="InstantiateInlineWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest.template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest.instance_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest.request_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3974,
+    serialized_end=4140,
+)
+
+
+_UPDATEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="UpdateWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1beta2.UpdateWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="template",
+            full_name="google.cloud.dataproc.v1beta2.UpdateWorkflowTemplateRequest.template",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4142,
+    serialized_end=4240,
+)
+
+
+_LISTWORKFLOWTEMPLATESREQUEST = _descriptor.Descriptor(
+    name="ListWorkflowTemplatesRequest",
+    full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4242,
+    serialized_end=4327,
+)
+
+
+_LISTWORKFLOWTEMPLATESRESPONSE = _descriptor.Descriptor(
+    name="ListWorkflowTemplatesResponse",
+    full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="templates",
+            full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesResponse.templates",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.dataproc.v1beta2.ListWorkflowTemplatesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4329,
+    serialized_end=4453,
+)
+
+
+_DELETEWORKFLOWTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="DeleteWorkflowTemplateRequest",
+    full_name="google.cloud.dataproc.v1beta2.DeleteWorkflowTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.dataproc.v1beta2.DeleteWorkflowTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.dataproc.v1beta2.DeleteWorkflowTemplateRequest.version",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4455,
+    serialized_end=4517,
+)
+
+_WORKFLOWTEMPLATE_LABELSENTRY.containing_type = _WORKFLOWTEMPLATE
+_WORKFLOWTEMPLATE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWTEMPLATE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWTEMPLATE.fields_by_name["labels"].message_type = _WORKFLOWTEMPLATE_LABELSENTRY
+_WORKFLOWTEMPLATE.fields_by_name["placement"].message_type = _WORKFLOWTEMPLATEPLACEMENT
+_WORKFLOWTEMPLATE.fields_by_name["jobs"].message_type = _ORDEREDJOB
+_WORKFLOWTEMPLATE.fields_by_name["parameters"].message_type = _TEMPLATEPARAMETER
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "managed_cluster"
+].message_type = _MANAGEDCLUSTER
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "cluster_selector"
+].message_type = _CLUSTERSELECTOR
+_WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"].fields.append(
+    _WORKFLOWTEMPLATEPLACEMENT.fields_by_name["managed_cluster"]
+)
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "managed_cluster"
+].containing_oneof = _WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"]
+_WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"].fields.append(
+    _WORKFLOWTEMPLATEPLACEMENT.fields_by_name["cluster_selector"]
+)
+_WORKFLOWTEMPLATEPLACEMENT.fields_by_name[
+    "cluster_selector"
+].containing_oneof = _WORKFLOWTEMPLATEPLACEMENT.oneofs_by_name["placement"]
+_MANAGEDCLUSTER_LABELSENTRY.containing_type = _MANAGEDCLUSTER
+_MANAGEDCLUSTER.fields_by_name[
+    "config"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_clusters__pb2._CLUSTERCONFIG
+)
+_MANAGEDCLUSTER.fields_by_name["labels"].message_type = _MANAGEDCLUSTER_LABELSENTRY
+_CLUSTERSELECTOR_CLUSTERLABELSENTRY.containing_type = _CLUSTERSELECTOR
+_CLUSTERSELECTOR.fields_by_name[
+    "cluster_labels"
+].message_type = _CLUSTERSELECTOR_CLUSTERLABELSENTRY
+_ORDEREDJOB_LABELSENTRY.containing_type = _ORDEREDJOB
+_ORDEREDJOB.fields_by_name[
+    "hadoop_job"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._HADOOPJOB
+)
+_ORDEREDJOB.fields_by_name[
+    "spark_job"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._SPARKJOB
+)
+_ORDEREDJOB.fields_by_name[
+    "pyspark_job"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._PYSPARKJOB
+)
+_ORDEREDJOB.fields_by_name[
+    "hive_job"
+].message_type = google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._HIVEJOB
+_ORDEREDJOB.fields_by_name[
+    "pig_job"
+].message_type = google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._PIGJOB
+_ORDEREDJOB.fields_by_name[
+    "spark_sql_job"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._SPARKSQLJOB
+)
+_ORDEREDJOB.fields_by_name["labels"].message_type = _ORDEREDJOB_LABELSENTRY
+_ORDEREDJOB.fields_by_name[
+    "scheduling"
+].message_type = (
+    google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_jobs__pb2._JOBSCHEDULING
+)
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["hadoop_job"]
+)
+_ORDEREDJOB.fields_by_name["hadoop_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["spark_job"]
+)
+_ORDEREDJOB.fields_by_name["spark_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["pyspark_job"]
+)
+_ORDEREDJOB.fields_by_name["pyspark_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["hive_job"]
+)
+_ORDEREDJOB.fields_by_name["hive_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["pig_job"]
+)
+_ORDEREDJOB.fields_by_name["pig_job"].containing_oneof = _ORDEREDJOB.oneofs_by_name[
+    "job_type"
+]
+_ORDEREDJOB.oneofs_by_name["job_type"].fields.append(
+    _ORDEREDJOB.fields_by_name["spark_sql_job"]
+)
+_ORDEREDJOB.fields_by_name[
+    "spark_sql_job"
+].containing_oneof = _ORDEREDJOB.oneofs_by_name["job_type"]
+_TEMPLATEPARAMETER.fields_by_name["validation"].message_type = _PARAMETERVALIDATION
+_PARAMETERVALIDATION.fields_by_name["regex"].message_type = _REGEXVALIDATION
+_PARAMETERVALIDATION.fields_by_name["values"].message_type = _VALUEVALIDATION
+_PARAMETERVALIDATION.oneofs_by_name["validation_type"].fields.append(
+    _PARAMETERVALIDATION.fields_by_name["regex"]
+)
+_PARAMETERVALIDATION.fields_by_name[
+    "regex"
+].containing_oneof = _PARAMETERVALIDATION.oneofs_by_name["validation_type"]
+_PARAMETERVALIDATION.oneofs_by_name["validation_type"].fields.append(
+    _PARAMETERVALIDATION.fields_by_name["values"]
+)
+_PARAMETERVALIDATION.fields_by_name[
+    "values"
+].containing_oneof = _PARAMETERVALIDATION.oneofs_by_name["validation_type"]
+_WORKFLOWMETADATA_PARAMETERSENTRY.containing_type = _WORKFLOWMETADATA
+_WORKFLOWMETADATA.fields_by_name["create_cluster"].message_type = _CLUSTEROPERATION
+_WORKFLOWMETADATA.fields_by_name["graph"].message_type = _WORKFLOWGRAPH
+_WORKFLOWMETADATA.fields_by_name["delete_cluster"].message_type = _CLUSTEROPERATION
+_WORKFLOWMETADATA.fields_by_name["state"].enum_type = _WORKFLOWMETADATA_STATE
+_WORKFLOWMETADATA.fields_by_name[
+    "parameters"
+].message_type = _WORKFLOWMETADATA_PARAMETERSENTRY
+_WORKFLOWMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WORKFLOWMETADATA_STATE.containing_type = _WORKFLOWMETADATA
+_WORKFLOWGRAPH.fields_by_name["nodes"].message_type = _WORKFLOWNODE
+_WORKFLOWNODE.fields_by_name["state"].enum_type = _WORKFLOWNODE_NODESTATE
+_WORKFLOWNODE_NODESTATE.containing_type = _WORKFLOWNODE
+_CREATEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "template"
+].message_type = _WORKFLOWTEMPLATE
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY.containing_type = (
+    _INSTANTIATEWORKFLOWTEMPLATEREQUEST
+)
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "parameters"
+].message_type = _INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY
+_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "template"
+].message_type = _WORKFLOWTEMPLATE
+_UPDATEWORKFLOWTEMPLATEREQUEST.fields_by_name[
+    "template"
+].message_type = _WORKFLOWTEMPLATE
+_LISTWORKFLOWTEMPLATESRESPONSE.fields_by_name[
+    "templates"
+].message_type = _WORKFLOWTEMPLATE
+DESCRIPTOR.message_types_by_name["WorkflowTemplate"] = _WORKFLOWTEMPLATE
+DESCRIPTOR.message_types_by_name[
+    "WorkflowTemplatePlacement"
+] = _WORKFLOWTEMPLATEPLACEMENT
+DESCRIPTOR.message_types_by_name["ManagedCluster"] = _MANAGEDCLUSTER
+DESCRIPTOR.message_types_by_name["ClusterSelector"] = _CLUSTERSELECTOR
+DESCRIPTOR.message_types_by_name["OrderedJob"] = _ORDEREDJOB
+DESCRIPTOR.message_types_by_name["TemplateParameter"] = _TEMPLATEPARAMETER
+DESCRIPTOR.message_types_by_name["ParameterValidation"] = _PARAMETERVALIDATION
+DESCRIPTOR.message_types_by_name["RegexValidation"] = _REGEXVALIDATION
+DESCRIPTOR.message_types_by_name["ValueValidation"] = _VALUEVALIDATION
+DESCRIPTOR.message_types_by_name["WorkflowMetadata"] = _WORKFLOWMETADATA
+DESCRIPTOR.message_types_by_name["ClusterOperation"] = _CLUSTEROPERATION
+DESCRIPTOR.message_types_by_name["WorkflowGraph"] = _WORKFLOWGRAPH
+DESCRIPTOR.message_types_by_name["WorkflowNode"] = _WORKFLOWNODE
+DESCRIPTOR.message_types_by_name[
+    "CreateWorkflowTemplateRequest"
+] = _CREATEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetWorkflowTemplateRequest"
+] = _GETWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "InstantiateWorkflowTemplateRequest"
+] = _INSTANTIATEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "InstantiateInlineWorkflowTemplateRequest"
+] = _INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateWorkflowTemplateRequest"
+] = _UPDATEWORKFLOWTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListWorkflowTemplatesRequest"
+] = _LISTWORKFLOWTEMPLATESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListWorkflowTemplatesResponse"
+] = _LISTWORKFLOWTEMPLATESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteWorkflowTemplateRequest"
+] = _DELETEWORKFLOWTEMPLATEREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WorkflowTemplate = _reflection.GeneratedProtocolMessageType(
+    "WorkflowTemplate",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WORKFLOWTEMPLATE_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowTemplate.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_WORKFLOWTEMPLATE,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A Cloud Dataproc workflow template resource.
+  
+  
+  Attributes:
+      id:
+          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.  .
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. Used to perform a consistent read-modify-write.
+          This field should be left blank for a
+          ``CreateWorkflowTemplate`` request. It is required for an
+          ``UpdateWorkflowTemplate`` request, and must match the current
+          server version. A typical update template flow would fetch the
+          current template with a ``GetWorkflowTemplate`` request, which
+          will return 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.
+      create_time:
+          Output only. The time template was created.
+      update_time:
+          Output only. The time template was last updated.
+      labels:
+          Optional. The labels to associate with this template. These
+          labels will be propagated to all jobs and clusters created by
+          the workflow instance.  Label **keys** must contain 1 to 63
+          characters, and must conform to `RFC 1035
+          <https://www.ietf.org/rfc/rfc1035.txt>`__.  Label **values**
+          may be empty, but, if present, must contain 1 to 63
+          characters, and must conform to `RFC 1035
+          <https://www.ietf.org/rfc/rfc1035.txt>`__.  No more than 32
+          labels can be associated with a template.
+      placement:
+          Required. WorkflowTemplate scheduling information.
+      jobs:
+          Required. The Directed Acyclic Graph of Jobs to submit.
+      parameters:
+          Optional. Template parameters whose values are substituted
+          into the template. Values for parameters must be provided when
+          the template is instantiated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowTemplate)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowTemplate)
+_sym_db.RegisterMessage(WorkflowTemplate.LabelsEntry)
+
+WorkflowTemplatePlacement = _reflection.GeneratedProtocolMessageType(
+    "WorkflowTemplatePlacement",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKFLOWTEMPLATEPLACEMENT,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""Specifies workflow execution target.
+  
+  Either ``managed_cluster`` or ``cluster_selector`` is required.
+  
+  
+  Attributes:
+      placement:
+          Required. Specifies where workflow executes; either on a
+          managed cluster or an existing cluster chosen by labels.
+      managed_cluster:
+          Optional. A cluster that is managed by the workflow.
+      cluster_selector:
+          Optional. A selector that chooses target cluster for jobs
+          based on metadata.  The selector is evaluated at the time each
+          job is submitted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowTemplatePlacement)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowTemplatePlacement)
+
+ManagedCluster = _reflection.GeneratedProtocolMessageType(
+    "ManagedCluster",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MANAGEDCLUSTER_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ManagedCluster.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_MANAGEDCLUSTER,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""Cluster that is managed by the workflow.
+  
+  
+  Attributes:
+      cluster_name:
+          Required. The cluster name prefix. A unique cluster name will
+          be formed by appending a random suffix.  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.
+      config:
+          Required. The cluster configuration.
+      labels:
+          Optional. The labels to associate with this cluster.  Label
+          keys must be between 1 and 63 characters long. Label values must be between
+          1 and 63 characters long. No more than 32
+          labels can be associated with a given cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ManagedCluster)
+    ),
+)
+_sym_db.RegisterMessage(ManagedCluster)
+_sym_db.RegisterMessage(ManagedCluster.LabelsEntry)
+
+ClusterSelector = _reflection.GeneratedProtocolMessageType(
+    "ClusterSelector",
+    (_message.Message,),
+    dict(
+        ClusterLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ClusterLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLUSTERSELECTOR_CLUSTERLABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterSelector.ClusterLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CLUSTERSELECTOR,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A selector that chooses target cluster for jobs based on metadata.
+  
+  
+  Attributes:
+      zone:
+          Optional. The zone where workflow process executes. This
+          parameter does not affect the selection of the cluster.  If
+          unspecified, the zone of the first cluster matching the
+          selector is used.
+      cluster_labels:
+          Required. The cluster labels. Cluster must have all labels to
+          match.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterSelector)
+    ),
+)
+_sym_db.RegisterMessage(ClusterSelector)
+_sym_db.RegisterMessage(ClusterSelector.ClusterLabelsEntry)
+
+OrderedJob = _reflection.GeneratedProtocolMessageType(
+    "OrderedJob",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ORDEREDJOB_LABELSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.OrderedJob.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_ORDEREDJOB,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A job executed by the workflow.
+  
+  
+  Attributes:
+      step_id:
+          Required. The step id. The id must be unique among all jobs
+          within the template.  The step id is used as prefix for job
+          id, as job ``goog-dataproc-workflow-step-id`` label, and in [p
+          rerequisiteStepIds][google.cloud.dataproc.v1beta2.OrderedJob.p
+          rerequisite\_step\_ids] field from other steps.  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.
+      job_type:
+          Required. The job definition.
+      hadoop_job:
+          Job is a Hadoop job.
+      spark_job:
+          Job is a Spark job.
+      pyspark_job:
+          Job is a Pyspark job.
+      hive_job:
+          Job is a Hive job.
+      pig_job:
+          Job is a Pig job.
+      spark_sql_job:
+          Job is a SparkSql job.
+      labels:
+          Optional. The labels to associate with this job.  Label keys
+          must be between 1 and 63 characters long. Label values must be between
+          1 and 63 characters long. No more than 32 labels can be
+          associated with a given job.
+      scheduling:
+          Optional. Job scheduling configuration.
+      prerequisite_step_ids:
+          Optional. The optional list of prerequisite job step\_ids. If
+          not specified, the job will start at the beginning of
+          workflow.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.OrderedJob)
+    ),
+)
+_sym_db.RegisterMessage(OrderedJob)
+_sym_db.RegisterMessage(OrderedJob.LabelsEntry)
+
+TemplateParameter = _reflection.GeneratedProtocolMessageType(
+    "TemplateParameter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEMPLATEPARAMETER,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A configurable parameter that replaces one or more fields in the
+  template. Parameterizable fields: - Labels - File uris - Job properties
+  - Job arguments - Script variables - Main class (in HadoopJob and
+  SparkJob) - Zone (in ClusterSelector)
+  
+  
+  Attributes:
+      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.
+      fields:
+          Required. Paths to all fields that the parameter replaces. A
+          field is allowed to appear in at most one parameter's list of
+          field paths.  A field path is similar in syntax to a
+          [google.protobuf.FieldMask][google.protobuf.FieldMask]. For
+          example, a field path that references the zone field of a
+          workflow template's cluster selector would be specified as
+          ``placement.clusterSelector.zone``.  Also, field paths can
+          reference fields using the following syntax:  -  Values in
+          maps can be referenced by key:     -  labels['key']    -
+          placement.clusterSelector.clusterLabels['key']    -
+          placement.managedCluster.labels['key']    -
+          placement.clusterSelector.clusterLabels['key']    -
+          jobs['step-id'].labels['key']  -  Jobs in the jobs list can be
+          referenced by step-id:     -  jobs['step-
+          id'].hadoopJob.mainJarFileUri    -  jobs['step-
+          id'].hiveJob.queryFileUri    -  jobs['step-
+          id'].pySparkJob.mainPythonFileUri    -  jobs['step-
+          id'].hadoopJob.jarFileUris[0]    -  jobs['step-
+          id'].hadoopJob.archiveUris[0]    -  jobs['step-
+          id'].hadoopJob.fileUris[0]    -  jobs['step-
+          id'].pySparkJob.pythonFileUris[0]  -  Items in repeated fields
+          can be referenced by a zero-based index:     -  jobs['step-
+          id'].sparkJob.args[0]  -  Other examples:     -  jobs['step-
+          id'].hadoopJob.properties['key']    -  jobs['step-
+          id'].hadoopJob.args[0]    -  jobs['step-
+          id'].hiveJob.scriptVariables['key']    -  jobs['step-
+          id'].hadoopJob.mainJarFileUri    -
+          placement.clusterSelector.zone  It may not be possible to
+          parameterize maps and repeated fields in their entirety since
+          only individual map values and individual items in repeated
+          fields can be referenced. For example, the following field
+          paths are invalid:  -  placement.clusterSelector.clusterLabels
+          -  jobs['step-id'].sparkJob.args
+      description:
+          Optional. Brief description of the parameter. Must not exceed
+          1024 characters.
+      validation:
+          Optional. Validation rules to be applied to this parameter's
+          value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.TemplateParameter)
+    ),
+)
+_sym_db.RegisterMessage(TemplateParameter)
+
+ParameterValidation = _reflection.GeneratedProtocolMessageType(
+    "ParameterValidation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAMETERVALIDATION,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""Configuration for parameter validation.
+  
+  
+  Attributes:
+      validation_type:
+          Required. The type of validation to be performed.
+      regex:
+          Validation based on regular expressions.
+      values:
+          Validation based on a list of allowed values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ParameterValidation)
+    ),
+)
+_sym_db.RegisterMessage(ParameterValidation)
+
+RegexValidation = _reflection.GeneratedProtocolMessageType(
+    "RegexValidation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REGEXVALIDATION,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""Validation based on regular expressions.
+  
+  
+  Attributes:
+      regexes:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.RegexValidation)
+    ),
+)
+_sym_db.RegisterMessage(RegexValidation)
+
+ValueValidation = _reflection.GeneratedProtocolMessageType(
+    "ValueValidation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUEVALIDATION,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""Validation based on a list of allowed values.
+  
+  
+  Attributes:
+      values:
+          Required. List of allowed values for the parameter.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ValueValidation)
+    ),
+)
+_sym_db.RegisterMessage(ValueValidation)
+
+WorkflowMetadata = _reflection.GeneratedProtocolMessageType(
+    "WorkflowMetadata",
+    (_message.Message,),
+    dict(
+        ParametersEntry=_reflection.GeneratedProtocolMessageType(
+            "ParametersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WORKFLOWMETADATA_PARAMETERSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowMetadata.ParametersEntry)
+            ),
+        ),
+        DESCRIPTOR=_WORKFLOWMETADATA,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A Cloud Dataproc workflow template resource.
+  
+  
+  Attributes:
+      template:
+          Output only. The "resource name" of the template.
+      version:
+          Output only. The version of template at the time of workflow
+          instantiation.
+      create_cluster:
+          Output only. The create cluster operation metadata.
+      graph:
+          Output only. The workflow graph.
+      delete_cluster:
+          Output only. The delete cluster operation metadata.
+      state:
+          Output only. The workflow state.
+      cluster_name:
+          Output only. The name of the target cluster.
+      parameters:
+          Map from parameter names to values that were used for those
+          parameters.
+      start_time:
+          Output only. Workflow start time.
+      end_time:
+          Output only. Workflow end time.
+      cluster_uuid:
+          Output only. The UUID of target cluster.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowMetadata)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowMetadata)
+_sym_db.RegisterMessage(WorkflowMetadata.ParametersEntry)
+
+ClusterOperation = _reflection.GeneratedProtocolMessageType(
+    "ClusterOperation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLUSTEROPERATION,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""The cluster operation triggered by a workflow.
+  
+  
+  Attributes:
+      operation_id:
+          Output only. The id of the cluster operation.
+      error:
+          Output only. Error, if operation failed.
+      done:
+          Output only. Indicates the operation is done.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ClusterOperation)
+    ),
+)
+_sym_db.RegisterMessage(ClusterOperation)
+
+WorkflowGraph = _reflection.GeneratedProtocolMessageType(
+    "WorkflowGraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKFLOWGRAPH,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""The workflow graph.
+  
+  
+  Attributes:
+      nodes:
+          Output only. The workflow nodes.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowGraph)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowGraph)
+
+WorkflowNode = _reflection.GeneratedProtocolMessageType(
+    "WorkflowNode",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKFLOWNODE,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""The workflow node.
+  
+  
+  Attributes:
+      step_id:
+          Output only. The name of the node.
+      prerequisite_step_ids:
+          Output only. Node's prerequisite nodes.
+      job_id:
+          Output only. The job id; populated after the node enters
+          RUNNING state.
+      state:
+          Output only. The node state.
+      error:
+          Output only. The error detail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.WorkflowNode)
+    ),
+)
+_sym_db.RegisterMessage(WorkflowNode)
+
+CreateWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to create a workflow template.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      template:
+          Required. The Dataproc workflow template to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.CreateWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateWorkflowTemplateRequest)
+
+GetWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "GetWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to fetch a workflow template.
+  
+  
+  Attributes:
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. The version of workflow template to retrieve. Only
+          previously instatiated versions can be retrieved.  If
+          unspecified, retrieves the current version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.GetWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetWorkflowTemplateRequest)
+
+InstantiateWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "InstantiateWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        ParametersEntry=_reflection.GeneratedProtocolMessageType(
+            "ParametersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY,
+                __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest.ParametersEntry)
+            ),
+        ),
+        DESCRIPTOR=_INSTANTIATEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to instantiate a workflow template.
+  
+  
+  Attributes:
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. The version of workflow template to instantiate. If
+          specified, the workflow will be instantiated only if the
+          current version of the workflow template has the supplied
+          version.  This option cannot be used to instantiate a previous
+          version of workflow template.
+      instance_id:
+          Deprecated. Please use ``request_id`` field instead.
+      request_id:
+          Optional. A tag that prevents multiple concurrent workflow
+          instances with the same tag from running. This mitigates risk
+          of concurrent instances started due to retries.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The tag
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+      parameters:
+          Optional. Map from parameter names to values that should be
+          used for those parameters. Values may not exceed 100
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.InstantiateWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(InstantiateWorkflowTemplateRequest)
+_sym_db.RegisterMessage(InstantiateWorkflowTemplateRequest.ParametersEntry)
+
+InstantiateInlineWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "InstantiateInlineWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to instantiate an inline workflow template.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      template:
+          Required. The workflow template to instantiate.
+      instance_id:
+          Deprecated. Please use ``request_id`` field instead.
+      request_id:
+          Optional. A tag that prevents multiple concurrent workflow
+          instances with the same tag from running. This mitigates risk
+          of concurrent instances started due to retries.  It is
+          recommended to always set this value to a `UUID <https://en.wi
+          kipedia.org/wiki/Universally_unique_identifier>`__.  The tag
+          must contain only letters (a-z, A-Z), numbers (0-9),
+          underscores (\_), and hyphens (-). The maximum length is 40
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.InstantiateInlineWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(InstantiateInlineWorkflowTemplateRequest)
+
+UpdateWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to update a workflow template.
+  
+  
+  Attributes:
+      template:
+          Required. The updated workflow template.  The
+          ``template.version`` field must match the current version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.UpdateWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateWorkflowTemplateRequest)
+
+ListWorkflowTemplatesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListWorkflowTemplatesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTWORKFLOWTEMPLATESREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to list workflow templates in a project.
+  
+  
+  Attributes:
+      parent:
+          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}``
+      page_size:
+          Optional. The maximum number of results to return in each
+          response.
+      page_token:
+          Optional. The page token, returned by a previous call, to
+          request the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListWorkflowTemplatesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListWorkflowTemplatesRequest)
+
+ListWorkflowTemplatesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListWorkflowTemplatesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTWORKFLOWTEMPLATESRESPONSE,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A response to a request to list workflow templates in a project.
+  
+  
+  Attributes:
+      templates:
+          Output only. WorkflowTemplates list.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.ListWorkflowTemplatesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListWorkflowTemplatesResponse)
+
+DeleteWorkflowTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteWorkflowTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEWORKFLOWTEMPLATEREQUEST,
+        __module__="google.cloud.dataproc_v1beta2.proto.workflow_templates_pb2",
+        __doc__="""A request to delete a workflow template.
+  
+  Currently started workflows will remain running.
+  
+  
+  Attributes:
+      name:
+          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}/workflowTemplate
+          s/{template_id}``
+      version:
+          Optional. The version of workflow template to delete. If
+          specified, will only delete the template if the current server
+          version matches specified version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.dataproc.v1beta2.DeleteWorkflowTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteWorkflowTemplateRequest)
+
+
+DESCRIPTOR._options = None
+_WORKFLOWTEMPLATE_LABELSENTRY._options = None
+_MANAGEDCLUSTER_LABELSENTRY._options = None
+_CLUSTERSELECTOR_CLUSTERLABELSENTRY._options = None
+_ORDEREDJOB_LABELSENTRY._options = None
+_WORKFLOWMETADATA_PARAMETERSENTRY._options = None
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST_PARAMETERSENTRY._options = None
+_INSTANTIATEWORKFLOWTEMPLATEREQUEST.fields_by_name["instance_id"]._options = None
+
+_WORKFLOWTEMPLATESERVICE = _descriptor.ServiceDescriptor(
+    name="WorkflowTemplateService",
+    full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4520,
+    serialized_end=6535,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.CreateWorkflowTemplate",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEWORKFLOWTEMPLATEREQUEST,
+            output_type=_WORKFLOWTEMPLATE,
+            serialized_options=_b(
+                '\202\323\344\223\002\214\001"8/v1beta2/{parent=projects/*/regions/*}/workflowTemplates:\010templateZF":/v1beta2/{parent=projects/*/locations/*}/workflowTemplates:\010template'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.GetWorkflowTemplate",
+            index=1,
+            containing_service=None,
+            input_type=_GETWORKFLOWTEMPLATEREQUEST,
+            output_type=_WORKFLOWTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002x\0228/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}Z<\022:/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="InstantiateWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.InstantiateWorkflowTemplate",
+            index=2,
+            containing_service=None,
+            input_type=_INSTANTIATEWORKFLOWTEMPLATEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\226\001"D/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}:instantiate:\001*ZK"F/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}:instantiate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="InstantiateInlineWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.InstantiateInlineWorkflowTemplate",
+            index=3,
+            containing_service=None,
+            input_type=_INSTANTIATEINLINEWORKFLOWTEMPLATEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\260\001"L/v1beta2/{parent=projects/*/locations/*}/workflowTemplates:instantiateInline:\010templateZV"J/v1beta2/{parent=projects/*/regions/*}/workflowTemplates:instantiateInline:\010template'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.UpdateWorkflowTemplate",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATEWORKFLOWTEMPLATEREQUEST,
+            output_type=_WORKFLOWTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002\236\001\032A/v1beta2/{template.name=projects/*/regions/*/workflowTemplates/*}:\010templateZO\032C/v1beta2/{template.name=projects/*/locations/*/workflowTemplates/*}:\010template"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListWorkflowTemplates",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.ListWorkflowTemplates",
+            index=5,
+            containing_service=None,
+            input_type=_LISTWORKFLOWTEMPLATESREQUEST,
+            output_type=_LISTWORKFLOWTEMPLATESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002x\0228/v1beta2/{parent=projects/*/regions/*}/workflowTemplatesZ<\022:/v1beta2/{parent=projects/*/locations/*}/workflowTemplates"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteWorkflowTemplate",
+            full_name="google.cloud.dataproc.v1beta2.WorkflowTemplateService.DeleteWorkflowTemplate",
+            index=6,
+            containing_service=None,
+            input_type=_DELETEWORKFLOWTEMPLATEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002x*8/v1beta2/{name=projects/*/regions/*/workflowTemplates/*}Z<*:/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_WORKFLOWTEMPLATESERVICE)
+
+DESCRIPTOR.services_by_name["WorkflowTemplateService"] = _WORKFLOWTEMPLATESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates_pb2_grpc.py b/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates_pb2_grpc.py
new file mode 100644
index 000000000000..012152a68d1a
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/proto/workflow_templates_pb2_grpc.py
@@ -0,0 +1,199 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dataproc_v1beta2.proto import (
+    workflow_templates_pb2 as google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class WorkflowTemplateServiceStub(object):
+    """The API interface for managing Workflow Templates in the
+  Cloud Dataproc API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/CreateWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.CreateWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.FromString,
+        )
+        self.GetWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/GetWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.GetWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.FromString,
+        )
+        self.InstantiateWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/InstantiateWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.InstantiateWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.InstantiateInlineWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/InstantiateInlineWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.InstantiateInlineWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/UpdateWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.UpdateWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.FromString,
+        )
+        self.ListWorkflowTemplates = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/ListWorkflowTemplates",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesResponse.FromString,
+        )
+        self.DeleteWorkflowTemplate = channel.unary_unary(
+            "/google.cloud.dataproc.v1beta2.WorkflowTemplateService/DeleteWorkflowTemplate",
+            request_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.DeleteWorkflowTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class WorkflowTemplateServiceServicer(object):
+    """The API interface for managing Workflow Templates in the
+  Cloud Dataproc API.
+  """
+
+    def CreateWorkflowTemplate(self, request, context):
+        """Creates new workflow template.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetWorkflowTemplate(self, request, context):
+        """Retrieves the latest workflow template.
+
+    Can retrieve previously instantiated template by specifying optional
+    version parameter.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def InstantiateWorkflowTemplate(self, request, context):
+        """Instantiates a template and begins execution.
+
+    The returned Operation can be used to track execution of
+    workflow by polling
+    [operations.get][google.longrunning.Operations.GetOperation].
+    The Operation will complete when entire workflow is finished.
+
+    The running workflow can be aborted via
+    [operations.cancel][google.longrunning.Operations.CancelOperation].
+    This will cause any inflight jobs to be cancelled and workflow-owned
+    clusters to be deleted.
+
+    The [Operation.metadata][google.longrunning.Operation.metadata] will be
+    [WorkflowMetadata][google.cloud.dataproc.v1beta2.WorkflowMetadata].
+
+    On successful completion,
+    [Operation.response][google.longrunning.Operation.response] will be
+    [Empty][google.protobuf.Empty].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def InstantiateInlineWorkflowTemplate(self, request, context):
+        """Instantiates a template and begins execution.
+
+    This method is equivalent to executing the sequence
+    [CreateWorkflowTemplate][google.cloud.dataproc.v1beta2.WorkflowTemplateService.CreateWorkflowTemplate], [InstantiateWorkflowTemplate][google.cloud.dataproc.v1beta2.WorkflowTemplateService.InstantiateWorkflowTemplate],
+    [DeleteWorkflowTemplate][google.cloud.dataproc.v1beta2.WorkflowTemplateService.DeleteWorkflowTemplate].
+
+    The returned Operation can be used to track execution of
+    workflow by polling
+    [operations.get][google.longrunning.Operations.GetOperation].
+    The Operation will complete when entire workflow is finished.
+
+    The running workflow can be aborted via
+    [operations.cancel][google.longrunning.Operations.CancelOperation].
+    This will cause any inflight jobs to be cancelled and workflow-owned
+    clusters to be deleted.
+
+    The [Operation.metadata][google.longrunning.Operation.metadata] will be
+    [WorkflowMetadata][google.cloud.dataproc.v1beta2.WorkflowMetadata].
+
+    On successful completion,
+    [Operation.response][google.longrunning.Operation.response] will be
+    [Empty][google.protobuf.Empty].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateWorkflowTemplate(self, request, context):
+        """Updates (replaces) workflow template. The updated template
+    must contain version that matches the current server version.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListWorkflowTemplates(self, request, context):
+        """Lists workflows that match the specified filter in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteWorkflowTemplate(self, request, context):
+        """Deletes a workflow template. It does not cancel in-progress workflows.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_WorkflowTemplateServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.CreateWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.SerializeToString,
+        ),
+        "GetWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.GetWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.GetWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.SerializeToString,
+        ),
+        "InstantiateWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.InstantiateWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.InstantiateWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "InstantiateInlineWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.InstantiateInlineWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.InstantiateInlineWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.UpdateWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.WorkflowTemplate.SerializeToString,
+        ),
+        "ListWorkflowTemplates": grpc.unary_unary_rpc_method_handler(
+            servicer.ListWorkflowTemplates,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.ListWorkflowTemplatesResponse.SerializeToString,
+        ),
+        "DeleteWorkflowTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteWorkflowTemplate,
+            request_deserializer=google_dot_cloud_dot_dataproc__v1beta2_dot_proto_dot_workflow__templates__pb2.DeleteWorkflowTemplateRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.dataproc.v1beta2.WorkflowTemplateService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dataproc/google/cloud/dataproc_v1beta2/types.py b/dataproc/google/cloud/dataproc_v1beta2/types.py
new file mode 100644
index 000000000000..811c656a00af
--- /dev/null
+++ b/dataproc/google/cloud/dataproc_v1beta2/types.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2
+from google.cloud.dataproc_v1beta2.proto import operations_pb2 as proto_operations_pb2
+from google.cloud.dataproc_v1beta2.proto import workflow_templates_pb2
+from google.longrunning import operations_pb2 as longrunning_operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    longrunning_operations_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [
+    autoscaling_policies_pb2,
+    clusters_pb2,
+    jobs_pb2,
+    proto_operations_pb2,
+    workflow_templates_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.dataproc_v1beta2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/dataproc/noxfile.py b/dataproc/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/dataproc/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/dataproc/setup.cfg b/dataproc/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/dataproc/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/dataproc/setup.py b/dataproc/setup.py
new file mode 100644
index 000000000000..57e8a728b526
--- /dev/null
+++ b/dataproc/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-dataproc"
+description = "Google Cloud Dataproc API client library"
+version = "0.5.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/dataproc/synth.metadata b/dataproc/synth.metadata
new file mode 100644
index 000000000000..99c6b1a0eb60
--- /dev/null
+++ b/dataproc/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:21:27.830464Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "dataproc",
+        "apiVersion": "v1beta2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/dataproc/artman_dataproc_v1beta2.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "dataproc",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/dataproc/artman_dataproc_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/dataproc/synth.py b/dataproc/synth.py
new file mode 100644
index 000000000000..a2c50b0e4a86
--- /dev/null
+++ b/dataproc/synth.py
@@ -0,0 +1,87 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import re
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta2", "v1"]
+
+# ----------------------------------------------------------------------------
+# Generate dataproc GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("dataproc", version, include_protos=True,)
+    s.move(library, excludes=["docs/index.rst", "nox.py", "README.rst", "setup.py"])
+
+    s.replace(
+        f"google/cloud/dataproc_{version}/gapic/cluster_controller_client.py",
+        "metadata_type=operations_pb2.ClusterOperationMetadata,",
+        "metadata_type=proto_operations_pb2.ClusterOperationMetadata,",
+    )
+
+    s.replace(
+        f"google/cloud/dataproc_{version}/gapic/cluster_controller_client.py",
+        "\s+<strong>Note:</strong>.*\n(.*\n)+?.*types.FieldMask.",
+        f"""
+
+
+                .. note::
+
+                    Currently, only the following fields can be updated:
+
+                    * ``labels``: Update labels
+                    * ``config.worker_config.num_instances``: Resize primary
+                      worker group
+                    * ``config.secondary_worker_config.num_instances``: Resize
+                      secondary worker group
+
+                    If a dict is provided, it must be of the same form as the protobuf
+                    message :class:`~google.cloud.dataproc_{version}.types.FieldMask`""",
+    )
+
+    s.replace(
+        f'google/cloud/dataproc_{version}/proto/workflow_templates_pb2.py',
+        ', and must\n\s+conform to the following PCRE regular expression:'
+        '(.*\n)+?.*No more than 32',
+        '. Label values must be between\n'
+        '          1 and 63 characters long. No more than 32'
+    )
+    s.replace(
+        f'google/cloud/dataproc_{version}/proto/workflow_templates_pb2.py',
+        ', and must conform to\n'
+        '\s+the following regular expression:(.*\n)+?.* No more than',
+        '. Label values must be between\n'
+        '          1 and 63 characters long. No more than'
+    )
+
+s.replace(
+    "google/cloud/dataproc_v1beta2/proto/clusters_pb2.py",
+    "# Generated by the protocol buffer compiler.  DO NOT EDIT!",
+    "# -*- coding: utf-8 -*-\n"
+    "# Generated by the protocol buffer compiler.  DO NOT EDIT!",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/dataproc/tests/system/gapic/v1/test_system_cluster_controller_v1.py b/dataproc/tests/system/gapic/v1/test_system_cluster_controller_v1.py
new file mode 100644
index 000000000000..86fbb3c7bb66
--- /dev/null
+++ b/dataproc/tests/system/gapic/v1/test_system_cluster_controller_v1.py
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import dataproc_v1
+from google.cloud.dataproc_v1.proto import clusters_pb2
+
+
+class TestSystemClusterController(object):
+    def test_list_clusters(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = dataproc_v1.ClusterControllerClient()
+        project_id_2 = project_id
+        region = "global"
+        response = client.list_clusters(project_id_2, region)
diff --git a/dataproc/tests/system/gapic/v1beta2/test_system_cluster_controller_v1beta2.py b/dataproc/tests/system/gapic/v1beta2/test_system_cluster_controller_v1beta2.py
new file mode 100644
index 000000000000..15d2ad67ce0c
--- /dev/null
+++ b/dataproc/tests/system/gapic/v1beta2/test_system_cluster_controller_v1beta2.py
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import dataproc_v1beta2
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2
+
+
+class TestSystemClusterController(object):
+    def test_list_clusters(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = dataproc_v1beta2.ClusterControllerClient()
+        project_id_2 = project_id
+        region = "global"
+        response = client.list_clusters(project_id_2, region)
diff --git a/dataproc/tests/unit/gapic/v1/test_cluster_controller_client_v1.py b/dataproc/tests/unit/gapic/v1/test_cluster_controller_client_v1.py
new file mode 100644
index 000000000000..10d2c29e4cef
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1/test_cluster_controller_client_v1.py
@@ -0,0 +1,413 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import dataproc_v1
+from google.cloud.dataproc_v1.proto import clusters_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestClusterControllerClient(object):
+    def test_create_cluster(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        cluster_name = "clusterName-1018081872"
+        cluster_uuid = "clusterUuid-1017854240"
+        expected_response = {
+            "project_id": project_id_2,
+            "cluster_name": cluster_name,
+            "cluster_uuid": cluster_uuid,
+        }
+        expected_response = clusters_pb2.Cluster(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster = {}
+
+        response = client.create_cluster(project_id, region, cluster)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.CreateClusterRequest(
+            project_id=project_id, region=region, cluster=cluster
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster = {}
+
+        response = client.create_cluster(project_id, region, cluster)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_cluster(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        cluster_name_2 = "clusterName2875867491"
+        cluster_uuid = "clusterUuid-1017854240"
+        expected_response = {
+            "project_id": project_id_2,
+            "cluster_name": cluster_name_2,
+            "cluster_uuid": cluster_uuid,
+        }
+        expected_response = clusters_pb2.Cluster(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+        cluster = {}
+        update_mask = {}
+
+        response = client.update_cluster(
+            project_id, region, cluster_name, cluster, update_mask
+        )
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.UpdateClusterRequest(
+            project_id=project_id,
+            region=region,
+            cluster_name=cluster_name,
+            cluster=cluster,
+            update_mask=update_mask,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+        cluster = {}
+        update_mask = {}
+
+        response = client.update_cluster(
+            project_id, region, cluster_name, cluster, update_mask
+        )
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_cluster(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.delete_cluster(project_id, region, cluster_name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.DeleteClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.delete_cluster(project_id, region, cluster_name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_cluster(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        cluster_name_2 = "clusterName2875867491"
+        cluster_uuid = "clusterUuid-1017854240"
+        expected_response = {
+            "project_id": project_id_2,
+            "cluster_name": cluster_name_2,
+            "cluster_uuid": cluster_uuid,
+        }
+        expected_response = clusters_pb2.Cluster(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.get_cluster(project_id, region, cluster_name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.GetClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        with pytest.raises(CustomException):
+            client.get_cluster(project_id, region, cluster_name)
+
+    def test_list_clusters(self):
+        # Setup Expected Response
+        next_page_token = ""
+        clusters_element = {}
+        clusters = [clusters_element]
+        expected_response = {"next_page_token": next_page_token, "clusters": clusters}
+        expected_response = clusters_pb2.ListClustersResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_clusters(project_id, region)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.clusters[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.ListClustersRequest(
+            project_id=project_id, region=region
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_clusters_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_clusters(project_id, region)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_diagnose_cluster(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_diagnose_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.diagnose_cluster(project_id, region, cluster_name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.DiagnoseClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_diagnose_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_diagnose_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.diagnose_cluster(project_id, region, cluster_name)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/dataproc/tests/unit/gapic/v1/test_job_controller_client_v1.py b/dataproc/tests/unit/gapic/v1/test_job_controller_client_v1.py
new file mode 100644
index 000000000000..c3a0c0a65b1b
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1/test_job_controller_client_v1.py
@@ -0,0 +1,355 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import dataproc_v1
+from google.cloud.dataproc_v1.proto import jobs_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestJobControllerClient(object):
+    def test_submit_job(self):
+        # Setup Expected Response
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job = {}
+
+        response = client.submit_job(project_id, region, job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.SubmitJobRequest(
+            project_id=project_id, region=region, job=job
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_submit_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.submit_job(project_id, region, job)
+
+    def test_get_job(self):
+        # Setup Expected Response
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        response = client.get_job(project_id, region, job_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.GetJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        with pytest.raises(CustomException):
+            client.get_job(project_id, region, job_id)
+
+    def test_list_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        jobs_element = {}
+        jobs = [jobs_element]
+        expected_response = {"next_page_token": next_page_token, "jobs": jobs}
+        expected_response = jobs_pb2.ListJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_jobs(project_id, region)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.ListJobsRequest(
+            project_id=project_id, region=region
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_jobs(project_id, region)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_job(self):
+        # Setup Expected Response
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+        job = {}
+        update_mask = {}
+
+        response = client.update_job(project_id, region, job_id, job, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.UpdateJobRequest(
+            project_id=project_id,
+            region=region,
+            job_id=job_id,
+            job=job,
+            update_mask=update_mask,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+        job = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_job(project_id, region, job_id, job, update_mask)
+
+    def test_cancel_job(self):
+        # Setup Expected Response
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        response = client.cancel_job(project_id, region, job_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.CancelJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        with pytest.raises(CustomException):
+            client.cancel_job(project_id, region, job_id)
+
+    def test_delete_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        client.delete_job(project_id, region, job_id)
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.DeleteJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        with pytest.raises(CustomException):
+            client.delete_job(project_id, region, job_id)
diff --git a/dataproc/tests/unit/gapic/v1/test_workflow_template_service_client_v1.py b/dataproc/tests/unit/gapic/v1/test_workflow_template_service_client_v1.py
new file mode 100644
index 000000000000..33024817d843
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1/test_workflow_template_service_client_v1.py
@@ -0,0 +1,390 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import dataproc_v1
+from google.cloud.dataproc_v1.proto import workflow_templates_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestWorkflowTemplateServiceClient(object):
+    def test_create_workflow_template(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        version = 351608024
+        expected_response = {"id": id_, "name": name, "version": version}
+        expected_response = workflow_templates_pb2.WorkflowTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        response = client.create_workflow_template(parent, template)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.CreateWorkflowTemplateRequest(
+            parent=parent, template=template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        with pytest.raises(CustomException):
+            client.create_workflow_template(parent, template)
+
+    def test_get_workflow_template(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name_2 = "name2-1052831874"
+        version = 351608024
+        expected_response = {"id": id_, "name": name_2, "version": version}
+        expected_response = workflow_templates_pb2.WorkflowTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        response = client.get_workflow_template(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.GetWorkflowTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_workflow_template(name)
+
+    def test_instantiate_workflow_template(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_workflow_template", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        response = client.instantiate_workflow_template(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.InstantiateWorkflowTemplateRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_instantiate_workflow_template_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_workflow_template_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        response = client.instantiate_workflow_template(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_instantiate_inline_workflow_template(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_inline_workflow_template", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        response = client.instantiate_inline_workflow_template(parent, template)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.InstantiateInlineWorkflowTemplateRequest(
+            parent=parent, template=template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_instantiate_inline_workflow_template_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_inline_workflow_template_exception",
+            done=True,
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        response = client.instantiate_inline_workflow_template(parent, template)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_workflow_template(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        version = 351608024
+        expected_response = {"id": id_, "name": name, "version": version}
+        expected_response = workflow_templates_pb2.WorkflowTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        template = {}
+
+        response = client.update_workflow_template(template)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.UpdateWorkflowTemplateRequest(
+            template=template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup request
+        template = {}
+
+        with pytest.raises(CustomException):
+            client.update_workflow_template(template)
+
+    def test_list_workflow_templates(self):
+        # Setup Expected Response
+        next_page_token = ""
+        templates_element = {}
+        templates = [templates_element]
+        expected_response = {"next_page_token": next_page_token, "templates": templates}
+        expected_response = workflow_templates_pb2.ListWorkflowTemplatesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+
+        paged_list_response = client.list_workflow_templates(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.templates[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.ListWorkflowTemplatesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_workflow_templates_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+
+        paged_list_response = client.list_workflow_templates(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_workflow_template(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        client.delete_workflow_template(name)
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.DeleteWorkflowTemplateRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1.WorkflowTemplateServiceClient()
+
+        # Setup request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_workflow_template(name)
diff --git a/dataproc/tests/unit/gapic/v1beta2/test_autoscaling_policy_service_client_v1beta2.py b/dataproc/tests/unit/gapic/v1beta2/test_autoscaling_policy_service_client_v1beta2.py
new file mode 100644
index 000000000000..6679ddd642fa
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1beta2/test_autoscaling_policy_service_client_v1beta2.py
@@ -0,0 +1,281 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import dataproc_v1beta2
+from google.cloud.dataproc_v1beta2.proto import autoscaling_policies_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestAutoscalingPolicyServiceClient(object):
+    def test_create_autoscaling_policy(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        expected_response = {"id": id_, "name": name}
+        expected_response = autoscaling_policies_pb2.AutoscalingPolicy(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        policy = {}
+
+        response = client.create_autoscaling_policy(parent, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = autoscaling_policies_pb2.CreateAutoscalingPolicyRequest(
+            parent=parent, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_autoscaling_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.create_autoscaling_policy(parent, policy)
+
+    def test_update_autoscaling_policy(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        expected_response = {"id": id_, "name": name}
+        expected_response = autoscaling_policies_pb2.AutoscalingPolicy(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup Request
+        policy = {}
+
+        response = client.update_autoscaling_policy(policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = autoscaling_policies_pb2.UpdateAutoscalingPolicyRequest(
+            policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_autoscaling_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup request
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.update_autoscaling_policy(policy)
+
+    def test_get_autoscaling_policy(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name_2 = "name2-1052831874"
+        expected_response = {"id": id_, "name": name_2}
+        expected_response = autoscaling_policies_pb2.AutoscalingPolicy(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup Request
+        name = client.autoscaling_policy_path(
+            "[PROJECT]", "[REGION]", "[AUTOSCALING_POLICY]"
+        )
+
+        response = client.get_autoscaling_policy(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = autoscaling_policies_pb2.GetAutoscalingPolicyRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_autoscaling_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup request
+        name = client.autoscaling_policy_path(
+            "[PROJECT]", "[REGION]", "[AUTOSCALING_POLICY]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_autoscaling_policy(name)
+
+    def test_list_autoscaling_policies(self):
+        # Setup Expected Response
+        next_page_token = ""
+        policies_element = {}
+        policies = [policies_element]
+        expected_response = {"next_page_token": next_page_token, "policies": policies}
+        expected_response = autoscaling_policies_pb2.ListAutoscalingPoliciesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+
+        paged_list_response = client.list_autoscaling_policies(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.policies[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = autoscaling_policies_pb2.ListAutoscalingPoliciesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_autoscaling_policies_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+
+        paged_list_response = client.list_autoscaling_policies(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_autoscaling_policy(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup Request
+        name = client.autoscaling_policy_path(
+            "[PROJECT]", "[REGION]", "[AUTOSCALING_POLICY]"
+        )
+
+        client.delete_autoscaling_policy(name)
+
+        assert len(channel.requests) == 1
+        expected_request = autoscaling_policies_pb2.DeleteAutoscalingPolicyRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_autoscaling_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.AutoscalingPolicyServiceClient()
+
+        # Setup request
+        name = client.autoscaling_policy_path(
+            "[PROJECT]", "[REGION]", "[AUTOSCALING_POLICY]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_autoscaling_policy(name)
diff --git a/dataproc/tests/unit/gapic/v1beta2/test_cluster_controller_client_v1beta2.py b/dataproc/tests/unit/gapic/v1beta2/test_cluster_controller_client_v1beta2.py
new file mode 100644
index 000000000000..2953b818b9fd
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1beta2/test_cluster_controller_client_v1beta2.py
@@ -0,0 +1,413 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import dataproc_v1beta2
+from google.cloud.dataproc_v1beta2.proto import clusters_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestClusterControllerClient(object):
+    def test_create_cluster(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        cluster_name = "clusterName-1018081872"
+        cluster_uuid = "clusterUuid-1017854240"
+        expected_response = {
+            "project_id": project_id_2,
+            "cluster_name": cluster_name,
+            "cluster_uuid": cluster_uuid,
+        }
+        expected_response = clusters_pb2.Cluster(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster = {}
+
+        response = client.create_cluster(project_id, region, cluster)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.CreateClusterRequest(
+            project_id=project_id, region=region, cluster=cluster
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster = {}
+
+        response = client.create_cluster(project_id, region, cluster)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_cluster(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        cluster_name_2 = "clusterName2875867491"
+        cluster_uuid = "clusterUuid-1017854240"
+        expected_response = {
+            "project_id": project_id_2,
+            "cluster_name": cluster_name_2,
+            "cluster_uuid": cluster_uuid,
+        }
+        expected_response = clusters_pb2.Cluster(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+        cluster = {}
+        update_mask = {}
+
+        response = client.update_cluster(
+            project_id, region, cluster_name, cluster, update_mask
+        )
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.UpdateClusterRequest(
+            project_id=project_id,
+            region=region,
+            cluster_name=cluster_name,
+            cluster=cluster,
+            update_mask=update_mask,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+        cluster = {}
+        update_mask = {}
+
+        response = client.update_cluster(
+            project_id, region, cluster_name, cluster, update_mask
+        )
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_cluster(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.delete_cluster(project_id, region, cluster_name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.DeleteClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.delete_cluster(project_id, region, cluster_name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_cluster(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        cluster_name_2 = "clusterName2875867491"
+        cluster_uuid = "clusterUuid-1017854240"
+        expected_response = {
+            "project_id": project_id_2,
+            "cluster_name": cluster_name_2,
+            "cluster_uuid": cluster_uuid,
+        }
+        expected_response = clusters_pb2.Cluster(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.get_cluster(project_id, region, cluster_name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.GetClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_cluster_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        with pytest.raises(CustomException):
+            client.get_cluster(project_id, region, cluster_name)
+
+    def test_list_clusters(self):
+        # Setup Expected Response
+        next_page_token = ""
+        clusters_element = {}
+        clusters = [clusters_element]
+        expected_response = {"next_page_token": next_page_token, "clusters": clusters}
+        expected_response = clusters_pb2.ListClustersResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_clusters(project_id, region)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.clusters[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.ListClustersRequest(
+            project_id=project_id, region=region
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_clusters_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_clusters(project_id, region)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_diagnose_cluster(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_diagnose_cluster", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.diagnose_cluster(project_id, region, cluster_name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = clusters_pb2.DiagnoseClusterRequest(
+            project_id=project_id, region=region, cluster_name=cluster_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_diagnose_cluster_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_diagnose_cluster_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.ClusterControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        cluster_name = "clusterName-1018081872"
+
+        response = client.diagnose_cluster(project_id, region, cluster_name)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/dataproc/tests/unit/gapic/v1beta2/test_job_controller_client_v1beta2.py b/dataproc/tests/unit/gapic/v1beta2/test_job_controller_client_v1beta2.py
new file mode 100644
index 000000000000..517a7bcd753f
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1beta2/test_job_controller_client_v1beta2.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import dataproc_v1beta2
+from google.cloud.dataproc_v1beta2.proto import jobs_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestJobControllerClient(object):
+    def test_submit_job(self):
+        # Setup Expected Response
+        submitted_by = "submittedBy-2047729125"
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "submitted_by": submitted_by,
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job = {}
+
+        response = client.submit_job(project_id, region, job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.SubmitJobRequest(
+            project_id=project_id, region=region, job=job
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_submit_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.submit_job(project_id, region, job)
+
+    def test_get_job(self):
+        # Setup Expected Response
+        submitted_by = "submittedBy-2047729125"
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "submitted_by": submitted_by,
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        response = client.get_job(project_id, region, job_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.GetJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        with pytest.raises(CustomException):
+            client.get_job(project_id, region, job_id)
+
+    def test_list_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        jobs_element = {}
+        jobs = [jobs_element]
+        expected_response = {"next_page_token": next_page_token, "jobs": jobs}
+        expected_response = jobs_pb2.ListJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_jobs(project_id, region)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.ListJobsRequest(
+            project_id=project_id, region=region
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+
+        paged_list_response = client.list_jobs(project_id, region)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_job(self):
+        # Setup Expected Response
+        submitted_by = "submittedBy-2047729125"
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "submitted_by": submitted_by,
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+        job = {}
+        update_mask = {}
+
+        response = client.update_job(project_id, region, job_id, job, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.UpdateJobRequest(
+            project_id=project_id,
+            region=region,
+            job_id=job_id,
+            job=job,
+            update_mask=update_mask,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+        job = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_job(project_id, region, job_id, job, update_mask)
+
+    def test_cancel_job(self):
+        # Setup Expected Response
+        submitted_by = "submittedBy-2047729125"
+        driver_output_resource_uri = "driverOutputResourceUri-542229086"
+        driver_control_files_uri = "driverControlFilesUri207057643"
+        job_uuid = "jobUuid-1615012099"
+        expected_response = {
+            "submitted_by": submitted_by,
+            "driver_output_resource_uri": driver_output_resource_uri,
+            "driver_control_files_uri": driver_control_files_uri,
+            "job_uuid": job_uuid,
+        }
+        expected_response = jobs_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        response = client.cancel_job(project_id, region, job_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.CancelJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        with pytest.raises(CustomException):
+            client.cancel_job(project_id, region, job_id)
+
+    def test_delete_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        client.delete_job(project_id, region, job_id)
+
+        assert len(channel.requests) == 1
+        expected_request = jobs_pb2.DeleteJobRequest(
+            project_id=project_id, region=region, job_id=job_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.JobControllerClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        region = "region-934795532"
+        job_id = "jobId-1154752291"
+
+        with pytest.raises(CustomException):
+            client.delete_job(project_id, region, job_id)
diff --git a/dataproc/tests/unit/gapic/v1beta2/test_workflow_template_service_client_v1beta2.py b/dataproc/tests/unit/gapic/v1beta2/test_workflow_template_service_client_v1beta2.py
new file mode 100644
index 000000000000..05f990cafb15
--- /dev/null
+++ b/dataproc/tests/unit/gapic/v1beta2/test_workflow_template_service_client_v1beta2.py
@@ -0,0 +1,390 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import dataproc_v1beta2
+from google.cloud.dataproc_v1beta2.proto import workflow_templates_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestWorkflowTemplateServiceClient(object):
+    def test_create_workflow_template(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        version = 351608024
+        expected_response = {"id": id_, "name": name, "version": version}
+        expected_response = workflow_templates_pb2.WorkflowTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        response = client.create_workflow_template(parent, template)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.CreateWorkflowTemplateRequest(
+            parent=parent, template=template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        with pytest.raises(CustomException):
+            client.create_workflow_template(parent, template)
+
+    def test_get_workflow_template(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name_2 = "name2-1052831874"
+        version = 351608024
+        expected_response = {"id": id_, "name": name_2, "version": version}
+        expected_response = workflow_templates_pb2.WorkflowTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        response = client.get_workflow_template(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.GetWorkflowTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_workflow_template(name)
+
+    def test_instantiate_workflow_template(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_workflow_template", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        response = client.instantiate_workflow_template(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.InstantiateWorkflowTemplateRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_instantiate_workflow_template_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_workflow_template_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        response = client.instantiate_workflow_template(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_instantiate_inline_workflow_template(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_inline_workflow_template", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        response = client.instantiate_inline_workflow_template(parent, template)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.InstantiateInlineWorkflowTemplateRequest(
+            parent=parent, template=template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_instantiate_inline_workflow_template_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_instantiate_inline_workflow_template_exception",
+            done=True,
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+        template = {}
+
+        response = client.instantiate_inline_workflow_template(parent, template)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_workflow_template(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        version = 351608024
+        expected_response = {"id": id_, "name": name, "version": version}
+        expected_response = workflow_templates_pb2.WorkflowTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        template = {}
+
+        response = client.update_workflow_template(template)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.UpdateWorkflowTemplateRequest(
+            template=template
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup request
+        template = {}
+
+        with pytest.raises(CustomException):
+            client.update_workflow_template(template)
+
+    def test_list_workflow_templates(self):
+        # Setup Expected Response
+        next_page_token = ""
+        templates_element = {}
+        templates = [templates_element]
+        expected_response = {"next_page_token": next_page_token, "templates": templates}
+        expected_response = workflow_templates_pb2.ListWorkflowTemplatesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+
+        paged_list_response = client.list_workflow_templates(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.templates[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.ListWorkflowTemplatesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_workflow_templates_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup request
+        parent = client.region_path("[PROJECT]", "[REGION]")
+
+        paged_list_response = client.list_workflow_templates(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_workflow_template(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup Request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        client.delete_workflow_template(name)
+
+        assert len(channel.requests) == 1
+        expected_request = workflow_templates_pb2.DeleteWorkflowTemplateRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_workflow_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dataproc_v1beta2.WorkflowTemplateServiceClient()
+
+        # Setup request
+        name = client.workflow_template_path(
+            "[PROJECT]", "[REGION]", "[WORKFLOW_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_workflow_template(name)
diff --git a/datastore/.coveragerc b/datastore/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/datastore/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/datastore/.flake8 b/datastore/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/datastore/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/datastore/.repo-metadata.json b/datastore/.repo-metadata.json
new file mode 100644
index 000000000000..f28b9d74ef7c
--- /dev/null
+++ b/datastore/.repo-metadata.json
@@ -0,0 +1,12 @@
+{
+  "name": "datastore",
+  "name_pretty": "Google Cloud Datastore",
+  "product_documentation": "https://cloud.google.com/datastore",
+  "client_documentation": "https://googleapis.dev/python/datastore/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559768",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-datastore",
+  "api_id": "datastore.googleapis.com"
+}
\ No newline at end of file
diff --git a/datastore/CHANGELOG.md b/datastore/CHANGELOG.md
new file mode 100644
index 000000000000..621e31cd680b
--- /dev/null
+++ b/datastore/CHANGELOG.md
@@ -0,0 +1,194 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-datastore/#history
+
+## 1.9.0
+
+07-24-2019 16:04 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8388](https://github.com/googleapis/google-cloud-python/pull/8388))
+
+### New Features
+- Add 'client_options' support (via synth). ([#8506](https://github.com/googleapis/google-cloud-python/pull/8506))
+- Add 'Client.reserve_ids' API wrapper. ([#8178](https://github.com/googleapis/google-cloud-python/pull/8178))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8580](https://github.com/googleapis/google-cloud-python/pull/8580))
+- Remove typing information for kwargs to not conflict with type checkers ([#8546](https://github.com/googleapis/google-cloud-python/pull/8546))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8350](https://github.com/googleapis/google-cloud-python/pull/8350))
+- Add disclaimer to auto-generated template files (via synth). ([#8312](https://github.com/googleapis/google-cloud-python/pull/8312))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8238](https://github.com/googleapis/google-cloud-python/pull/8238))
+- Blacken noxfile.py, setup.py (via synth). ([#8120](https://github.com/googleapis/google-cloud-python/pull/8120))
+- Add empty lines (via synth). ([#8055](https://github.com/googleapis/google-cloud-python/pull/8055))
+
+## 1.8.0
+
+05-17-2019 08:28 PDT
+
+### Implementation Changes
+- Add routing header to method metadata (via synth). ([#7593](https://github.com/googleapis/google-cloud-python/pull/7593))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to client. ([#8013](https://github.com/googleapis/google-cloud-python/pull/8013))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Pick up stub docstring fix in GAPIC generator. ([#6968](https://github.com/googleapis/google-cloud-python/pull/6968))
+
+### Internal / Testing Changes
+- Add nox session `docs` (via synth). ([#7768](https://github.com/googleapis/google-cloud-python/pull/7768))
+- Copy lintified proto files (via synth). ([#7446](https://github.com/googleapis/google-cloud-python/pull/7446))
+- Add clarifying comment to blacken nox target. ([#7389](https://github.com/googleapis/google-cloud-python/pull/7389))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers ([#7142](https://github.com/googleapis/google-cloud-python/pull/7142))
+- Protoc-generated serialization update. ([#7080](https://github.com/googleapis/google-cloud-python/pull/7080))
+
+## 1.7.3
+
+12-17-2018 16:45 PST
+
+
+### Documentation
+- Show use of 'batch.begin()' in docstring example. ([#6932](https://github.com/googleapis/google-cloud-python/pull/6932))
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+## 1.7.2
+
+12-10-2018 12:37 PST
+
+
+### Implementation Changes
+- Fix client_info bug, update docstrings. ([#6409](https://github.com/googleapis/google-cloud-python/pull/6409))
+- Pick up fixes in GAPIC generator. ([#6494](https://github.com/googleapis/google-cloud-python/pull/6494))
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up enum fixes in the GAPIC generator. ([#6610](https://github.com/googleapis/google-cloud-python/pull/6610))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Update version of google-cloud-core ([#6858](https://github.com/googleapis/google-cloud-python/pull/6858))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Add synth metadata. ([#6564](https://github.com/googleapis/google-cloud-python/pull/6564))
+- blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+
+## 1.7.1
+
+10-29-2018 10:38 PDT
+
+### Implementation Changes
+- Propagate empty arrays in entity values. ([#6285](https://github.com/googleapis/google-cloud-python/pull/6285))
+- Expose 'Client.base_url' property to allow alternate endpoints. ([#5821](https://github.com/googleapis/google-cloud-python/pull/5821))
+
+### Documentation
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Redirect renamed 'usage.html'/'client.html' -> 'index.html'. ([#5996](https://github.com/googleapis/google-cloud-python/pull/5996))
+- Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add 'synth.py'. ([#6078](https://github.com/googleapis/google-cloud-python/pull/6078))
+- Prep datastore docs for repo split. ([#5919](https://github.com/googleapis/google-cloud-python/pull/5919))
+- Use inplace installs under `nox` ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+
+## 1.7.0
+
+### Implementation Changes
+
+- Do not pass 'offset' once the query iterator has a cursor (#5503)
+- Add test runs for Python 3.7 and remove run for 3.4 (#5295)
+
+### Documentation
+
+- minor fix to datastore example (#5452)
+- Add example showing explicit unicode for text values in entities. (#5263)
+
+### Internal / Testing Changes
+
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+- Attempt again to reproduce #4264. (#5403)
+- Fix bad trove classifier
+
+## 1.6.0
+
+### Implementation changes
+
+- Don't check `exclude_from_indexes` for empty lists. (#4915)
+
+### Dependencies
+
+- The minimum version for `google-api-core` has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Exercise datastore query result paging (#4905)
+- Pass `*session.posargs` through on command line for system tests. (#4904)
+
+## 1.5.0
+
+### Interface additions
+
+- Added `Entity.id` property (#4640)
+- Added optional `location_prefix` kwarg in `to_legacy_urlsafe` (#4635)
+- Added support for transaction options (#4357)
+- Added the ability to specify read consistency (#4343, #4376)
+
+### Implementation changes
+
+- The underlying autogenerated code was rengereated to pick up new features and bugfixes. (#4348, #4877)
+- Updated the HTTP implementation to match the gRPC implementation. (#4388)
+- Set `next_page_token` to `None` if there are no more results (#4349)
+
+### Documentation
+
+- Entity doc consistency (#4641)
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing
+
+- Update datastore doctests to reflect change in cursor behavior. (#4382)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+
+## 1.4.0
+
+### Interface changes / additions
+
+- Allowing `dict` (as an `Entity`) for property values. (#3927)
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-datastore/1.4.0/
diff --git a/datastore/LICENSE b/datastore/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/datastore/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/datastore/MANIFEST.in b/datastore/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/datastore/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/datastore/README.rst b/datastore/README.rst
new file mode 100644
index 000000000000..e613092a58bf
--- /dev/null
+++ b/datastore/README.rst
@@ -0,0 +1,111 @@
+Python Client for Google Cloud Datastore
+========================================
+
+|GA| |pypi| |versions| 
+
+`Google Cloud Datastore API`_ is a fully managed, schemaless database for
+storing non-relational data. Cloud Datastore automatically scales with your
+users and supports ACID transactions, high availability of reads and writes,
+strong consistency for reads and ancestor queries, and eventual consistency for
+all other queries.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-datastore.svg
+   :target: https://pypi.org/project/google-cloud-datastore/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-datastore.svg
+   :target: https://pypi.org/project/google-cloud-datastore/
+.. _Google Cloud Datastore API: https://cloud.google.com/datastore/docs
+.. _Product Documentation:  https://cloud.google.com/datastore/docs
+.. _Client Library Documentation: https://googleapis.dev/python/datastore/latest
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Datastore API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Datastore API.:  https://cloud.google.com/datastore
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-datastore
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-datastore
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code:: python
+
+    from google.cloud import datastore
+    # Create, populate and persist an entity with keyID=1234
+    client = datastore.Client()
+    key = client.key('EntityKind', 1234)
+    entity = datastore.Entity(key=key)
+    entity.update({
+        'foo': u'bar',
+        'baz': 1337,
+        'qux': False,
+    })
+    client.put(entity)
+    # Then get by key for this entity
+    result = client.get(key)
+    print(result)
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Datastore API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/datastore/docs/README.rst b/datastore/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/datastore/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/docs/datastore-batches.rst b/datastore/docs/batches.rst
similarity index 100%
rename from docs/datastore-batches.rst
rename to datastore/docs/batches.rst
diff --git a/datastore/docs/changelog.md b/datastore/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/datastore/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/datastore/docs/client.rst b/datastore/docs/client.rst
new file mode 100644
index 000000000000..060477ec12fd
--- /dev/null
+++ b/datastore/docs/client.rst
@@ -0,0 +1,6 @@
+Datastore Client
+================
+
+.. automodule:: google.cloud.datastore.client
+  :members:
+  :show-inheritance:
diff --git a/datastore/docs/conf.py b/datastore/docs/conf.py
new file mode 100644
index 000000000000..a4c30084718e
--- /dev/null
+++ b/datastore/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-datastore documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.doctest",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-datastore"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-datastore-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-datastore.tex",
+        u"google-cloud-datastore Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-datastore",
+        u"google-cloud-datastore Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-datastore",
+        u"google-cloud-datastore Documentation",
+        author,
+        "google-cloud-datastore",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/docs/datastore-entities.rst b/datastore/docs/entities.rst
similarity index 100%
rename from docs/datastore-entities.rst
rename to datastore/docs/entities.rst
diff --git a/docs/datastore-helpers.rst b/datastore/docs/helpers.rst
similarity index 100%
rename from docs/datastore-helpers.rst
rename to datastore/docs/helpers.rst
diff --git a/datastore/docs/index.rst b/datastore/docs/index.rst
new file mode 100644
index 000000000000..30d0575a2294
--- /dev/null
+++ b/datastore/docs/index.rst
@@ -0,0 +1,26 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+.. toctree::
+  :maxdepth: 2
+
+  client
+  entities
+  keys
+  queries
+  transactions
+  batches
+  helpers
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-datastore`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/docs/datastore-keys.rst b/datastore/docs/keys.rst
similarity index 100%
rename from docs/datastore-keys.rst
rename to datastore/docs/keys.rst
diff --git a/docs/datastore-queries.rst b/datastore/docs/queries.rst
similarity index 100%
rename from docs/datastore-queries.rst
rename to datastore/docs/queries.rst
diff --git a/docs/datastore-transactions.rst b/datastore/docs/transactions.rst
similarity index 100%
rename from docs/datastore-transactions.rst
rename to datastore/docs/transactions.rst
diff --git a/datastore/docs/usage.html b/datastore/docs/usage.html
new file mode 100644
index 000000000000..9b81d6976cda
--- /dev/null
+++ b/datastore/docs/usage.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <script>
+   window.location.href = "./index.html"
+ </script>
+</head>
+</html>
diff --git a/datastore/google/__init__.py b/datastore/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/datastore/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/datastore/google/cloud/__init__.py b/datastore/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/datastore/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/datastore/google/cloud/datastore/__init__.py b/datastore/google/cloud/datastore/__init__.py
new file mode 100644
index 000000000000..078180f57128
--- /dev/null
+++ b/datastore/google/cloud/datastore/__init__.py
@@ -0,0 +1,69 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shortcut methods for getting set up with Google Cloud Datastore.
+
+You'll typically use these to get started with the API:
+
+.. doctest:: constructors
+
+   >>> from google.cloud import datastore
+   >>>
+   >>> client = datastore.Client()
+   >>> key = client.key('EntityKind', 1234)
+   >>> key
+   <Key('EntityKind', 1234), project=...>
+   >>> entity = datastore.Entity(key)
+   >>> entity['question'] = u'Life, universe?'  # Explicit unicode for text
+   >>> entity['answer'] = 42
+   >>> entity
+   <Entity('EntityKind', 1234) {'question': 'Life, universe?', 'answer': 42}>
+   >>> query = client.query(kind='EntityKind')
+
+The main concepts with this API are:
+
+- :class:`~google.cloud.datastore.client.Client`
+  which represents a project (string) and namespace (string) bundled with
+  a connection and has convenience methods for constructing objects with that
+  project / namespace.
+
+- :class:`~google.cloud.datastore.entity.Entity`
+  which represents a single entity in the datastore
+  (akin to a row in relational database world).
+
+- :class:`~google.cloud.datastore.key.Key`
+  which represents a pointer to a particular entity in the datastore
+  (akin to a unique identifier in relational database world).
+
+- :class:`~google.cloud.datastore.query.Query`
+  which represents a lookup or search over the rows in the datastore.
+
+- :class:`~google.cloud.datastore.transaction.Transaction`
+  which represents an all-or-none transaction and enables consistency
+  when race conditions may occur.
+"""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-datastore").version
+
+from google.cloud.datastore.batch import Batch
+from google.cloud.datastore.client import Client
+from google.cloud.datastore.entity import Entity
+from google.cloud.datastore.key import Key
+from google.cloud.datastore.query import Query
+from google.cloud.datastore.transaction import Transaction
+
+__all__ = ["__version__", "Batch", "Client", "Entity", "Key", "Query", "Transaction"]
diff --git a/datastore/google/cloud/datastore/_app_engine_key.proto b/datastore/google/cloud/datastore/_app_engine_key.proto
new file mode 100644
index 000000000000..ea6a25b22eea
--- /dev/null
+++ b/datastore/google/cloud/datastore/_app_engine_key.proto
@@ -0,0 +1,30 @@
+// Copyright 2017 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto2";
+
+message Reference {
+  required string app = 13;
+  optional string name_space = 20;
+  required Path path = 14;
+  optional string database_id = 23;
+}
+
+message Path {
+  repeated group Element = 1 {
+    required string type = 2;
+    optional int64 id = 3;
+    optional string name = 4;
+  }
+}
diff --git a/datastore/google/cloud/datastore/_app_engine_key_pb2.py b/datastore/google/cloud/datastore/_app_engine_key_pb2.py
new file mode 100644
index 000000000000..7fcd8fb181a4
--- /dev/null
+++ b/datastore/google/cloud/datastore/_app_engine_key_pb2.py
@@ -0,0 +1,265 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: _app_engine_key.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="_app_engine_key.proto",
+    package="",
+    syntax="proto2",
+    serialized_pb=_b(
+        '\n\x15_app_engine_key.proto"V\n\tReference\x12\x0b\n\x03\x61pp\x18\r \x02(\t\x12\x12\n\nname_space\x18\x14 \x01(\t\x12\x13\n\x04path\x18\x0e \x02(\x0b\x32\x05.Path\x12\x13\n\x0b\x64\x61tabase_id\x18\x17 \x01(\t"Y\n\x04Path\x12\x1e\n\x07\x65lement\x18\x01 \x03(\n2\r.Path.Element\x1a\x31\n\x07\x45lement\x12\x0c\n\x04type\x18\x02 \x02(\t\x12\n\n\x02id\x18\x03 \x01(\x03\x12\x0c\n\x04name\x18\x04 \x01(\t'
+    ),
+)
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+_REFERENCE = _descriptor.Descriptor(
+    name="Reference",
+    full_name="Reference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="app",
+            full_name="Reference.app",
+            index=0,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=2,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name_space",
+            full_name="Reference.name_space",
+            index=1,
+            number=20,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="Reference.path",
+            index=2,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=2,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="database_id",
+            full_name="Reference.database_id",
+            index=3,
+            number=23,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto2",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=25,
+    serialized_end=111,
+)
+
+
+_PATH_ELEMENT = _descriptor.Descriptor(
+    name="Element",
+    full_name="Path.Element",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="Path.Element.type",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=2,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="Path.Element.id",
+            index=1,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="Path.Element.name",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto2",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=153,
+    serialized_end=202,
+)
+
+_PATH = _descriptor.Descriptor(
+    name="Path",
+    full_name="Path",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="element",
+            full_name="Path.element",
+            index=0,
+            number=1,
+            type=10,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        )
+    ],
+    extensions=[],
+    nested_types=[_PATH_ELEMENT],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto2",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=113,
+    serialized_end=202,
+)
+
+_REFERENCE.fields_by_name["path"].message_type = _PATH
+_PATH_ELEMENT.containing_type = _PATH
+_PATH.fields_by_name["element"].message_type = _PATH_ELEMENT
+DESCRIPTOR.message_types_by_name["Reference"] = _REFERENCE
+DESCRIPTOR.message_types_by_name["Path"] = _PATH
+
+Reference = _reflection.GeneratedProtocolMessageType(
+    "Reference",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REFERENCE,
+        __module__="_app_engine_key_pb2"
+        # @@protoc_insertion_point(class_scope:Reference)
+    ),
+)
+_sym_db.RegisterMessage(Reference)
+
+Path = _reflection.GeneratedProtocolMessageType(
+    "Path",
+    (_message.Message,),
+    dict(
+        Element=_reflection.GeneratedProtocolMessageType(
+            "Element",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PATH_ELEMENT,
+                __module__="_app_engine_key_pb2"
+                # @@protoc_insertion_point(class_scope:Path.Element)
+            ),
+        ),
+        DESCRIPTOR=_PATH,
+        __module__="_app_engine_key_pb2"
+        # @@protoc_insertion_point(class_scope:Path)
+    ),
+)
+_sym_db.RegisterMessage(Path)
+_sym_db.RegisterMessage(Path.Element)
+
+
+# @@protoc_insertion_point(module_scope)
diff --git a/datastore/google/cloud/datastore/_gapic.py b/datastore/google/cloud/datastore/_gapic.py
new file mode 100644
index 000000000000..18c2ce917bc2
--- /dev/null
+++ b/datastore/google/cloud/datastore/_gapic.py
@@ -0,0 +1,43 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helpers for making API requests via gapic / gRPC."""
+
+from grpc import insecure_channel
+import six
+
+from google.cloud._helpers import make_secure_channel
+from google.cloud._http import DEFAULT_USER_AGENT
+from google.cloud.datastore_v1.gapic import datastore_client
+
+
+def make_datastore_api(client):
+    """Create an instance of the GAPIC Datastore API.
+
+    :type client: :class:`~google.cloud.datastore.client.Client`
+    :param client: The client that holds configuration details.
+
+    :rtype: :class:`.datastore.v1.datastore_client.DatastoreClient`
+    :returns: A datastore API instance with the proper credentials.
+    """
+    parse_result = six.moves.urllib_parse.urlparse(client._base_url)
+    host = parse_result.netloc
+    if parse_result.scheme == "https":
+        channel = make_secure_channel(client._credentials, DEFAULT_USER_AGENT, host)
+    else:
+        channel = insecure_channel(host)
+
+    return datastore_client.DatastoreClient(
+        channel=channel, client_info=client._client_info
+    )
diff --git a/datastore/google/cloud/datastore/_http.py b/datastore/google/cloud/datastore/_http.py
new file mode 100644
index 000000000000..0d10035340c6
--- /dev/null
+++ b/datastore/google/cloud/datastore/_http.py
@@ -0,0 +1,341 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Connections to Google Cloud Datastore API servers."""
+
+from google.rpc import status_pb2
+
+from google.cloud import _http as connection_module
+from google.cloud import exceptions
+from google.cloud.datastore_v1.proto import datastore_pb2 as _datastore_pb2
+
+
+DATASTORE_API_HOST = "datastore.googleapis.com"
+"""Datastore API request host."""
+API_BASE_URL = "https://" + DATASTORE_API_HOST
+"""The base of the API call URL."""
+API_VERSION = "v1"
+"""The version of the API, used in building the API call's URL."""
+API_URL_TEMPLATE = "{api_base}/{api_version}/projects" "/{project}:{method}"
+"""A template for the URL of a particular API call."""
+
+
+def _request(http, project, method, data, base_url, client_info):
+    """Make a request over the Http transport to the Cloud Datastore API.
+
+    :type http: :class:`requests.Session`
+    :param http: HTTP object to make requests.
+
+    :type project: str
+    :param project: The project to make the request for.
+
+    :type method: str
+    :param method: The API call method name (ie, ``runQuery``,
+                   ``lookup``, etc)
+
+    :type data: str
+    :param data: The data to send with the API call.
+                 Typically this is a serialized Protobuf string.
+
+    :type base_url: str
+    :param base_url: The base URL where the API lives.
+
+    :type client_info: :class:`google.api_core.client_info.ClientInfo`
+    :param client_info: used to generate user agent.
+
+    :rtype: str
+    :returns: The string response content from the API call.
+    :raises: :class:`google.cloud.exceptions.GoogleCloudError` if the
+             response code is not 200 OK.
+    """
+    user_agent = client_info.to_user_agent()
+    headers = {
+        "Content-Type": "application/x-protobuf",
+        "User-Agent": user_agent,
+        connection_module.CLIENT_INFO_HEADER: user_agent,
+    }
+    api_url = build_api_url(project, method, base_url)
+
+    response = http.request(url=api_url, method="POST", headers=headers, data=data)
+
+    if response.status_code != 200:
+        error_status = status_pb2.Status.FromString(response.content)
+        raise exceptions.from_http_status(
+            response.status_code, error_status.message, errors=[error_status]
+        )
+
+    return response.content
+
+
+def _rpc(http, project, method, base_url, client_info, request_pb, response_pb_cls):
+    """Make a protobuf RPC request.
+
+    :type http: :class:`requests.Session`
+    :param http: HTTP object to make requests.
+
+    :type project: str
+    :param project: The project to connect to. This is
+                    usually your project name in the cloud console.
+
+    :type method: str
+    :param method: The name of the method to invoke.
+
+    :type base_url: str
+    :param base_url: The base URL where the API lives.
+
+    :type client_info: :class:`google.api_core.client_info.ClientInfo`
+    :param client_info: used to generate user agent.
+
+    :type request_pb: :class:`google.protobuf.message.Message` instance
+    :param request_pb: the protobuf instance representing the request.
+
+    :type response_pb_cls: A :class:`google.protobuf.message.Message`
+                           subclass.
+    :param response_pb_cls: The class used to unmarshall the response
+                            protobuf.
+
+    :rtype: :class:`google.protobuf.message.Message`
+    :returns: The RPC message parsed from the response.
+    """
+    req_data = request_pb.SerializeToString()
+    response = _request(http, project, method, req_data, base_url, client_info)
+    return response_pb_cls.FromString(response)
+
+
+def build_api_url(project, method, base_url):
+    """Construct the URL for a particular API call.
+
+    This method is used internally to come up with the URL to use when
+    making RPCs to the Cloud Datastore API.
+
+    :type project: str
+    :param project: The project to connect to. This is
+                    usually your project name in the cloud console.
+
+    :type method: str
+    :param method: The API method to call (e.g. 'runQuery', 'lookup').
+
+    :type base_url: str
+    :param base_url: The base URL where the API lives.
+
+    :rtype: str
+    :returns: The API URL created.
+    """
+    return API_URL_TEMPLATE.format(
+        api_base=base_url, api_version=API_VERSION, project=project, method=method
+    )
+
+
+class HTTPDatastoreAPI(object):
+    """An API object that sends proto-over-HTTP requests.
+
+    Intended to provide the same methods as the GAPIC ``DatastoreClient``.
+
+    :type client: :class:`~google.cloud.datastore.client.Client`
+    :param client: The client that provides configuration.
+    """
+
+    def __init__(self, client):
+        self.client = client
+
+    def lookup(self, project_id, keys, read_options=None):
+        """Perform a ``lookup`` request.
+
+        :type project_id: str
+        :param project_id: The project to connect to. This is
+                           usually your project name in the cloud console.
+
+        :type keys: List[.entity_pb2.Key]
+        :param keys: The keys to retrieve from the datastore.
+
+        :type read_options: :class:`.datastore_pb2.ReadOptions`
+        :param read_options: (Optional) The options for this lookup. Contains
+                             either the transaction for the read or
+                             ``STRONG`` or ``EVENTUAL`` read consistency.
+
+        :rtype: :class:`.datastore_pb2.LookupResponse`
+        :returns: The returned protobuf response object.
+        """
+        request_pb = _datastore_pb2.LookupRequest(
+            project_id=project_id, read_options=read_options, keys=keys
+        )
+        return _rpc(
+            self.client._http,
+            project_id,
+            "lookup",
+            self.client._base_url,
+            self.client._client_info,
+            request_pb,
+            _datastore_pb2.LookupResponse,
+        )
+
+    def run_query(
+        self, project_id, partition_id, read_options=None, query=None, gql_query=None
+    ):
+        """Perform a ``runQuery`` request.
+
+        :type project_id: str
+        :param project_id: The project to connect to. This is
+                           usually your project name in the cloud console.
+
+        :type partition_id: :class:`.entity_pb2.PartitionId`
+        :param partition_id: Partition ID corresponding to an optional
+                             namespace and project ID.
+
+        :type read_options: :class:`.datastore_pb2.ReadOptions`
+        :param read_options: (Optional) The options for this query. Contains
+                             either the transaction for the read or
+                             ``STRONG`` or ``EVENTUAL`` read consistency.
+
+        :type query: :class:`.query_pb2.Query`
+        :param query: (Optional) The query protobuf to run. At most one of
+                      ``query`` and ``gql_query`` can be specified.
+
+        :type gql_query: :class:`.query_pb2.GqlQuery`
+        :param gql_query: (Optional) The GQL query to run. At most one of
+                          ``query`` and ``gql_query`` can be specified.
+
+        :rtype: :class:`.datastore_pb2.RunQueryResponse`
+        :returns: The returned protobuf response object.
+        """
+        request_pb = _datastore_pb2.RunQueryRequest(
+            project_id=project_id,
+            partition_id=partition_id,
+            read_options=read_options,
+            query=query,
+            gql_query=gql_query,
+        )
+        return _rpc(
+            self.client._http,
+            project_id,
+            "runQuery",
+            self.client._base_url,
+            self.client._client_info,
+            request_pb,
+            _datastore_pb2.RunQueryResponse,
+        )
+
+    def begin_transaction(self, project_id, transaction_options=None):
+        """Perform a ``beginTransaction`` request.
+
+        :type project_id: str
+        :param project_id: The project to connect to. This is
+                           usually your project name in the cloud console.
+
+        :type transaction_options: ~.datastore_v1.types.TransactionOptions
+        :param transaction_options: (Optional) Options for a new transaction.
+
+        :rtype: :class:`.datastore_pb2.BeginTransactionResponse`
+        :returns: The returned protobuf response object.
+        """
+        request_pb = _datastore_pb2.BeginTransactionRequest()
+        return _rpc(
+            self.client._http,
+            project_id,
+            "beginTransaction",
+            self.client._base_url,
+            self.client._client_info,
+            request_pb,
+            _datastore_pb2.BeginTransactionResponse,
+        )
+
+    def commit(self, project_id, mode, mutations, transaction=None):
+        """Perform a ``commit`` request.
+
+        :type project_id: str
+        :param project_id: The project to connect to. This is
+                           usually your project name in the cloud console.
+
+        :type mode: :class:`.gapic.datastore.v1.enums.CommitRequest.Mode`
+        :param mode: The type of commit to perform. Expected to be one of
+                     ``TRANSACTIONAL`` or ``NON_TRANSACTIONAL``.
+
+        :type mutations: list
+        :param mutations: List of :class:`.datastore_pb2.Mutation`, the
+                          mutations to perform.
+
+        :type transaction: bytes
+        :param transaction: (Optional) The transaction ID returned from
+                            :meth:`begin_transaction`.  Non-transactional
+                            commits must pass :data:`None`.
+
+        :rtype: :class:`.datastore_pb2.CommitResponse`
+        :returns: The returned protobuf response object.
+        """
+        request_pb = _datastore_pb2.CommitRequest(
+            project_id=project_id,
+            mode=mode,
+            transaction=transaction,
+            mutations=mutations,
+        )
+        return _rpc(
+            self.client._http,
+            project_id,
+            "commit",
+            self.client._base_url,
+            self.client._client_info,
+            request_pb,
+            _datastore_pb2.CommitResponse,
+        )
+
+    def rollback(self, project_id, transaction):
+        """Perform a ``rollback`` request.
+
+        :type project_id: str
+        :param project_id: The project to connect to. This is
+                           usually your project name in the cloud console.
+
+        :type transaction: bytes
+        :param transaction: The transaction ID to rollback.
+
+        :rtype: :class:`.datastore_pb2.RollbackResponse`
+        :returns: The returned protobuf response object.
+        """
+        request_pb = _datastore_pb2.RollbackRequest(
+            project_id=project_id, transaction=transaction
+        )
+        # Response is empty (i.e. no fields) but we return it anyway.
+        return _rpc(
+            self.client._http,
+            project_id,
+            "rollback",
+            self.client._base_url,
+            self.client._client_info,
+            request_pb,
+            _datastore_pb2.RollbackResponse,
+        )
+
+    def allocate_ids(self, project_id, keys):
+        """Perform an ``allocateIds`` request.
+
+        :type project_id: str
+        :param project_id: The project to connect to. This is
+                           usually your project name in the cloud console.
+
+        :type keys: List[.entity_pb2.Key]
+        :param keys: The keys for which the backend should allocate IDs.
+
+        :rtype: :class:`.datastore_pb2.AllocateIdsResponse`
+        :returns: The returned protobuf response object.
+        """
+        request_pb = _datastore_pb2.AllocateIdsRequest(keys=keys)
+        return _rpc(
+            self.client._http,
+            project_id,
+            "allocateIds",
+            self.client._base_url,
+            self.client._client_info,
+            request_pb,
+            _datastore_pb2.AllocateIdsResponse,
+        )
diff --git a/datastore/google/cloud/datastore/batch.py b/datastore/google/cloud/datastore/batch.py
new file mode 100644
index 000000000000..dc8463f3f973
--- /dev/null
+++ b/datastore/google/cloud/datastore/batch.py
@@ -0,0 +1,341 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with a batch of updates / deletes.
+
+Batches provide the ability to execute multiple operations
+in a single request to the Cloud Datastore API.
+
+See
+https://cloud.google.com/datastore/docs/concepts/entities#batch_operations
+"""
+
+from google.cloud.datastore import helpers
+from google.cloud.datastore_v1.proto import datastore_pb2 as _datastore_pb2
+
+
+class Batch(object):
+    """An abstraction representing a collected group of updates / deletes.
+
+    Used to build up a bulk mutation.
+
+    For example, the following snippet of code will put the two ``save``
+    operations and the ``delete`` operation into the same mutation, and send
+    them to the server in a single API request::
+
+      >>> from google.cloud import datastore
+      >>> client = datastore.Client()
+      >>> batch = client.batch()
+      >>> batch.begin()
+      >>> batch.put(entity1)
+      >>> batch.put(entity2)
+      >>> batch.delete(key3)
+      >>> batch.commit()
+
+    You can also use a batch as a context manager, in which case
+    :meth:`commit` will be called automatically if its block exits without
+    raising an exception::
+
+      >>> with batch:
+      ...     batch.put(entity1)
+      ...     batch.put(entity2)
+      ...     batch.delete(key3)
+
+    By default, no updates will be sent if the block exits with an error::
+
+      >>> with batch:
+      ...     do_some_work(batch)
+      ...     raise Exception()  # rolls back
+
+    :type client: :class:`google.cloud.datastore.client.Client`
+    :param client: The client used to connect to datastore.
+    """
+
+    _id = None  # "protected" attribute, always None for non-transactions
+
+    _INITIAL = 0
+    """Enum value for _INITIAL status of batch/transaction."""
+
+    _IN_PROGRESS = 1
+    """Enum value for _IN_PROGRESS status of batch/transaction."""
+
+    _ABORTED = 2
+    """Enum value for _ABORTED status of batch/transaction."""
+
+    _FINISHED = 3
+    """Enum value for _FINISHED status of batch/transaction."""
+
+    def __init__(self, client):
+        self._client = client
+        self._mutations = []
+        self._partial_key_entities = []
+        self._status = self._INITIAL
+
+    def current(self):
+        """Return the topmost batch / transaction, or None."""
+        return self._client.current_batch
+
+    @property
+    def project(self):
+        """Getter for project in which the batch will run.
+
+        :rtype: :class:`str`
+        :returns: The project in which the batch will run.
+        """
+        return self._client.project
+
+    @property
+    def namespace(self):
+        """Getter for namespace in which the batch will run.
+
+        :rtype: :class:`str`
+        :returns: The namespace in which the batch will run.
+        """
+        return self._client.namespace
+
+    def _add_partial_key_entity_pb(self):
+        """Adds a new mutation for an entity with a partial key.
+
+        :rtype: :class:`.entity_pb2.Entity`
+        :returns: The newly created entity protobuf that will be
+                  updated and sent with a commit.
+        """
+        new_mutation = _datastore_pb2.Mutation()
+        self._mutations.append(new_mutation)
+        return new_mutation.insert
+
+    def _add_complete_key_entity_pb(self):
+        """Adds a new mutation for an entity with a completed key.
+
+        :rtype: :class:`.entity_pb2.Entity`
+        :returns: The newly created entity protobuf that will be
+                  updated and sent with a commit.
+        """
+        # We use ``upsert`` for entities with completed keys, rather than
+        # ``insert`` or ``update``, in order not to create race conditions
+        # based on prior existence / removal of the entity.
+        new_mutation = _datastore_pb2.Mutation()
+        self._mutations.append(new_mutation)
+        return new_mutation.upsert
+
+    def _add_delete_key_pb(self):
+        """Adds a new mutation for a key to be deleted.
+
+        :rtype: :class:`.entity_pb2.Key`
+        :returns: The newly created key protobuf that will be
+                  deleted when sent with a commit.
+        """
+        new_mutation = _datastore_pb2.Mutation()
+        self._mutations.append(new_mutation)
+        return new_mutation.delete
+
+    @property
+    def mutations(self):
+        """Getter for the changes accumulated by this batch.
+
+        Every batch is committed with a single commit request containing all
+        the work to be done as mutations. Inside a batch, calling :meth:`put`
+        with an entity, or :meth:`delete` with a key, builds up the request by
+        adding a new mutation. This getter returns the protobuf that has been
+        built-up so far.
+
+        :rtype: iterable
+        :returns: The list of :class:`.datastore_pb2.Mutation`
+                  protobufs to be sent in the commit request.
+        """
+        return self._mutations
+
+    def put(self, entity):
+        """Remember an entity's state to be saved during :meth:`commit`.
+
+        .. note::
+           Any existing properties for the entity will be replaced by those
+           currently set on this instance.  Already-stored properties which do
+           not correspond to keys set on this instance will be removed from
+           the datastore.
+
+        .. note::
+           Property values which are "text" ('unicode' in Python2, 'str' in
+           Python3) map to 'string_value' in the datastore;  values which are
+           "bytes" ('str' in Python2, 'bytes' in Python3) map to 'blob_value'.
+
+        When an entity has a partial key, calling :meth:`commit` sends it as
+        an ``insert`` mutation and the key is completed. On return,
+        the key for the ``entity`` passed in is updated to match the key ID
+        assigned by the server.
+
+        :type entity: :class:`google.cloud.datastore.entity.Entity`
+        :param entity: the entity to be saved.
+
+        :raises: :class:`~exceptions.ValueError` if the batch is not in
+                 progress, if entity has no key assigned, or if the key's
+                 ``project`` does not match ours.
+        """
+        if self._status != self._IN_PROGRESS:
+            raise ValueError("Batch must be in progress to put()")
+
+        if entity.key is None:
+            raise ValueError("Entity must have a key")
+
+        if self.project != entity.key.project:
+            raise ValueError("Key must be from same project as batch")
+
+        if entity.key.is_partial:
+            entity_pb = self._add_partial_key_entity_pb()
+            self._partial_key_entities.append(entity)
+        else:
+            entity_pb = self._add_complete_key_entity_pb()
+
+        _assign_entity_to_pb(entity_pb, entity)
+
+    def delete(self, key):
+        """Remember a key to be deleted during :meth:`commit`.
+
+        :type key: :class:`google.cloud.datastore.key.Key`
+        :param key: the key to be deleted.
+
+        :raises: :class:`~exceptions.ValueError` if the batch is not in
+                 progress, if key is not complete, or if the key's
+                 ``project`` does not match ours.
+        """
+        if self._status != self._IN_PROGRESS:
+            raise ValueError("Batch must be in progress to delete()")
+
+        if key.is_partial:
+            raise ValueError("Key must be complete")
+
+        if self.project != key.project:
+            raise ValueError("Key must be from same project as batch")
+
+        key_pb = key.to_protobuf()
+        self._add_delete_key_pb().CopyFrom(key_pb)
+
+    def begin(self):
+        """Begins a batch.
+
+        This method is called automatically when entering a with
+        statement, however it can be called explicitly if you don't want
+        to use a context manager.
+
+        Overridden by :class:`google.cloud.datastore.transaction.Transaction`.
+
+        :raises: :class:`ValueError` if the batch has already begun.
+        """
+        if self._status != self._INITIAL:
+            raise ValueError("Batch already started previously.")
+        self._status = self._IN_PROGRESS
+
+    def _commit(self):
+        """Commits the batch.
+
+        This is called by :meth:`commit`.
+        """
+        if self._id is None:
+            mode = _datastore_pb2.CommitRequest.NON_TRANSACTIONAL
+        else:
+            mode = _datastore_pb2.CommitRequest.TRANSACTIONAL
+
+        commit_response_pb = self._client._datastore_api.commit(
+            self.project, mode, self._mutations, transaction=self._id
+        )
+        _, updated_keys = _parse_commit_response(commit_response_pb)
+        # If the back-end returns without error, we are guaranteed that
+        # ``commit`` will return keys that match (length and
+        # order) directly ``_partial_key_entities``.
+        for new_key_pb, entity in zip(updated_keys, self._partial_key_entities):
+            new_id = new_key_pb.path[-1].id
+            entity.key = entity.key.completed_key(new_id)
+
+    def commit(self):
+        """Commits the batch.
+
+        This is called automatically upon exiting a with statement,
+        however it can be called explicitly if you don't want to use a
+        context manager.
+
+        :raises: :class:`~exceptions.ValueError` if the batch is not
+                 in progress.
+        """
+        if self._status != self._IN_PROGRESS:
+            raise ValueError("Batch must be in progress to commit()")
+
+        try:
+            self._commit()
+        finally:
+            self._status = self._FINISHED
+
+    def rollback(self):
+        """Rolls back the current batch.
+
+        Marks the batch as aborted (can't be used again).
+
+        Overridden by :class:`google.cloud.datastore.transaction.Transaction`.
+
+        :raises: :class:`~exceptions.ValueError` if the batch is not
+                 in progress.
+        """
+        if self._status != self._IN_PROGRESS:
+            raise ValueError("Batch must be in progress to rollback()")
+
+        self._status = self._ABORTED
+
+    def __enter__(self):
+        self.begin()
+        # NOTE: We make sure begin() succeeds before pushing onto the stack.
+        self._client._push_batch(self)
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        try:
+            if exc_type is None:
+                self.commit()
+            else:
+                self.rollback()
+        finally:
+            self._client._pop_batch()
+
+
+def _assign_entity_to_pb(entity_pb, entity):
+    """Copy ``entity`` into ``entity_pb``.
+
+    Helper method for ``Batch.put``.
+
+    :type entity_pb: :class:`.entity_pb2.Entity`
+    :param entity_pb: The entity owned by a mutation.
+
+    :type entity: :class:`google.cloud.datastore.entity.Entity`
+    :param entity: The entity being updated within the batch / transaction.
+    """
+    bare_entity_pb = helpers.entity_to_protobuf(entity)
+    bare_entity_pb.key.CopyFrom(bare_entity_pb.key)
+    entity_pb.CopyFrom(bare_entity_pb)
+
+
+def _parse_commit_response(commit_response_pb):
+    """Extract response data from a commit response.
+
+    :type commit_response_pb: :class:`.datastore_pb2.CommitResponse`
+    :param commit_response_pb: The protobuf response from a commit request.
+
+    :rtype: tuple
+    :returns: The pair of the number of index updates and a list of
+              :class:`.entity_pb2.Key` for each incomplete key
+              that was completed in the commit.
+    """
+    mut_results = commit_response_pb.mutation_results
+    index_updates = commit_response_pb.index_updates
+    completed_keys = [
+        mut_result.key for mut_result in mut_results if mut_result.HasField("key")
+    ]  # Message field (Key)
+    return index_updates, completed_keys
diff --git a/datastore/google/cloud/datastore/client.py b/datastore/google/cloud/datastore/client.py
new file mode 100644
index 000000000000..df9ce33a0bdf
--- /dev/null
+++ b/datastore/google/cloud/datastore/client.py
@@ -0,0 +1,675 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Convenience wrapper for invoking APIs/factories w/ a project."""
+
+import os
+
+from google.cloud._helpers import _LocalStack
+from google.cloud._helpers import _determine_default_project as _base_default_project
+from google.cloud.client import ClientWithProject
+from google.cloud.datastore import __version__
+from google.cloud.datastore import helpers
+from google.cloud.datastore._http import HTTPDatastoreAPI
+from google.cloud.datastore.batch import Batch
+from google.cloud.datastore.entity import Entity
+from google.cloud.datastore.key import Key
+from google.cloud.datastore.query import Query
+from google.cloud.datastore.transaction import Transaction
+from google.cloud.environment_vars import DISABLE_GRPC
+from google.cloud.environment_vars import GCD_DATASET
+from google.cloud.environment_vars import GCD_HOST
+
+try:
+    from google.cloud.datastore._gapic import make_datastore_api
+
+except ImportError:  # pragma: NO COVER
+    from google.api_core import client_info
+
+    make_datastore_api = None
+    _HAVE_GRPC = False
+    _CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+else:
+    from google.api_core.gapic_v1 import client_info
+
+    _HAVE_GRPC = True
+    _CLIENT_INFO = client_info.ClientInfo(
+        client_library_version=__version__, gapic_version=__version__
+    )
+
+
+_MAX_LOOPS = 128
+"""Maximum number of iterations to wait for deferred keys."""
+_DATASTORE_BASE_URL = "https://datastore.googleapis.com"
+"""Datastore API request URL base."""
+
+
+_USE_GRPC = _HAVE_GRPC and not os.getenv(DISABLE_GRPC, False)
+
+
+def _get_gcd_project():
+    """Gets the GCD application ID if it can be inferred."""
+    return os.getenv(GCD_DATASET)
+
+
+def _determine_default_project(project=None):
+    """Determine default project explicitly or implicitly as fall-back.
+
+    In implicit case, supports four environments. In order of precedence, the
+    implicit environments are:
+
+    * DATASTORE_DATASET environment variable (for ``gcd`` / emulator testing)
+    * GOOGLE_CLOUD_PROJECT environment variable
+    * Google App Engine application ID
+    * Google Compute Engine project ID (from metadata server)
+
+    :type project: str
+    :param project: Optional. The project to use as default.
+
+    :rtype: str or ``NoneType``
+    :returns: Default project if it can be determined.
+    """
+    if project is None:
+        project = _get_gcd_project()
+
+    if project is None:
+        project = _base_default_project(project=project)
+
+    return project
+
+
+def _extended_lookup(
+    datastore_api,
+    project,
+    key_pbs,
+    missing=None,
+    deferred=None,
+    eventual=False,
+    transaction_id=None,
+):
+    """Repeat lookup until all keys found (unless stop requested).
+
+    Helper function for :meth:`Client.get_multi`.
+
+    :type datastore_api:
+        :class:`google.cloud.datastore._http.HTTPDatastoreAPI`
+        or :class:`google.cloud.datastore_v1.gapic.DatastoreClient`
+    :param datastore_api: The datastore API object used to connect
+                          to datastore.
+
+    :type project: str
+    :param project: The project to make the request for.
+
+    :type key_pbs: list of :class:`.entity_pb2.Key`
+    :param key_pbs: The keys to retrieve from the datastore.
+
+    :type missing: list
+    :param missing: (Optional) If a list is passed, the key-only entity
+                    protobufs returned by the backend as "missing" will be
+                    copied into it.
+
+    :type deferred: list
+    :param deferred: (Optional) If a list is passed, the key protobufs returned
+                     by the backend as "deferred" will be copied into it.
+
+    :type eventual: bool
+    :param eventual: If False (the default), request ``STRONG`` read
+                     consistency.  If True, request ``EVENTUAL`` read
+                     consistency.
+
+    :type transaction_id: str
+    :param transaction_id: If passed, make the request in the scope of
+                           the given transaction.  Incompatible with
+                           ``eventual==True``.
+
+    :rtype: list of :class:`.entity_pb2.Entity`
+    :returns: The requested entities.
+    :raises: :class:`ValueError` if missing / deferred are not null or
+             empty list.
+    """
+    if missing is not None and missing != []:
+        raise ValueError("missing must be None or an empty list")
+
+    if deferred is not None and deferred != []:
+        raise ValueError("deferred must be None or an empty list")
+
+    results = []
+
+    loop_num = 0
+    read_options = helpers.get_read_options(eventual, transaction_id)
+    while loop_num < _MAX_LOOPS:  # loop against possible deferred.
+        loop_num += 1
+        lookup_response = datastore_api.lookup(
+            project, key_pbs, read_options=read_options
+        )
+
+        # Accumulate the new results.
+        results.extend(result.entity for result in lookup_response.found)
+
+        if missing is not None:
+            missing.extend(result.entity for result in lookup_response.missing)
+
+        if deferred is not None:
+            deferred.extend(lookup_response.deferred)
+            break
+
+        if len(lookup_response.deferred) == 0:
+            break
+
+        # We have deferred keys, and the user didn't ask to know about
+        # them, so retry (but only with the deferred ones).
+        key_pbs = lookup_response.deferred
+
+    return results
+
+
+class Client(ClientWithProject):
+    """Convenience wrapper for invoking APIs/factories w/ a project.
+
+    .. doctest::
+
+       >>> from google.cloud import datastore
+       >>> client = datastore.Client()
+
+    :type project: str
+    :param project: (Optional) The project to pass to proxied API methods.
+
+    :type namespace: str
+    :param namespace: (Optional) namespace to pass to proxied API methods.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type client_info: :class:`google.api_core.gapic_v1.client_info.ClientInfo`
+                       or :class:`google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) The client info used to send a user-agent
+                        string along with API requests. If ``None``, then
+                        default info will be used. Generally,
+                        you only need to set this if you're developing your
+                        own library or partner tool.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type _use_grpc: bool
+    :param _use_grpc: (Optional) Explicitly specifies whether
+                      to use the gRPC transport (via GAX) or HTTP. If unset,
+                      falls back to the ``GOOGLE_CLOUD_DISABLE_GRPC``
+                      environment variable.
+                      This parameter should be considered private, and could
+                      change in the future.
+    """
+
+    SCOPE = ("https://www.googleapis.com/auth/datastore",)
+    """The scopes required for authenticating as a Cloud Datastore consumer."""
+
+    def __init__(
+        self,
+        project=None,
+        namespace=None,
+        credentials=None,
+        client_info=_CLIENT_INFO,
+        _http=None,
+        _use_grpc=None,
+    ):
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+        self.namespace = namespace
+        self._client_info = client_info
+        self._batch_stack = _LocalStack()
+        self._datastore_api_internal = None
+        if _use_grpc is None:
+            self._use_grpc = _USE_GRPC
+        else:
+            self._use_grpc = _use_grpc
+        try:
+            host = os.environ[GCD_HOST]
+            self._base_url = "http://" + host
+        except KeyError:
+            self._base_url = _DATASTORE_BASE_URL
+
+    @staticmethod
+    def _determine_default(project):
+        """Helper:  override default project detection."""
+        return _determine_default_project(project)
+
+    @property
+    def base_url(self):
+        """Getter for API base URL."""
+        return self._base_url
+
+    @base_url.setter
+    def base_url(self, value):
+        """Setter for API base URL."""
+        self._base_url = value
+
+    @property
+    def _datastore_api(self):
+        """Getter for a wrapped API object."""
+        if self._datastore_api_internal is None:
+            if self._use_grpc:
+                self._datastore_api_internal = make_datastore_api(self)
+            else:
+                self._datastore_api_internal = HTTPDatastoreAPI(self)
+        return self._datastore_api_internal
+
+    def _push_batch(self, batch):
+        """Push a batch/transaction onto our stack.
+
+        "Protected", intended for use by batch / transaction context mgrs.
+
+        :type batch: :class:`google.cloud.datastore.batch.Batch`, or an object
+                     implementing its API.
+        :param batch: newly-active batch/transaction.
+        """
+        self._batch_stack.push(batch)
+
+    def _pop_batch(self):
+        """Pop a batch/transaction from our stack.
+
+        "Protected", intended for use by batch / transaction context mgrs.
+
+        :raises: IndexError if the stack is empty.
+        :rtype: :class:`google.cloud.datastore.batch.Batch`, or an object
+                 implementing its API.
+        :returns: the top-most batch/transaction, after removing it.
+        """
+        return self._batch_stack.pop()
+
+    @property
+    def current_batch(self):
+        """Currently-active batch.
+
+        :rtype: :class:`google.cloud.datastore.batch.Batch`, or an object
+                implementing its API, or ``NoneType`` (if no batch is active).
+        :returns: The batch/transaction at the top of the batch stack.
+        """
+        return self._batch_stack.top
+
+    @property
+    def current_transaction(self):
+        """Currently-active transaction.
+
+        :rtype: :class:`google.cloud.datastore.transaction.Transaction`, or an
+                object implementing its API, or ``NoneType`` (if no transaction
+                is active).
+        :returns: The transaction at the top of the batch stack.
+        """
+        transaction = self.current_batch
+        if isinstance(transaction, Transaction):
+            return transaction
+
+    def get(self, key, missing=None, deferred=None, transaction=None, eventual=False):
+        """Retrieve an entity from a single key (if it exists).
+
+        .. note::
+
+           This is just a thin wrapper over :meth:`get_multi`.
+           The backend API does not make a distinction between a single key or
+           multiple keys in a lookup request.
+
+        :type key: :class:`google.cloud.datastore.key.Key`
+        :param key: The key to be retrieved from the datastore.
+
+        :type missing: list
+        :param missing: (Optional) If a list is passed, the key-only entities
+                        returned by the backend as "missing" will be copied
+                        into it.
+
+        :type deferred: list
+        :param deferred: (Optional) If a list is passed, the keys returned
+                         by the backend as "deferred" will be copied into it.
+
+        :type transaction:
+            :class:`~google.cloud.datastore.transaction.Transaction`
+        :param transaction: (Optional) Transaction to use for read consistency.
+                            If not passed, uses current transaction, if set.
+
+        :type eventual: bool
+        :param eventual: (Optional) Defaults to strongly consistent (False).
+                         Setting True will use eventual consistency, but cannot
+                         be used inside a transaction or will raise ValueError.
+
+        :rtype: :class:`google.cloud.datastore.entity.Entity` or ``NoneType``
+        :returns: The requested entity if it exists.
+
+        :raises: :class:`ValueError` if eventual is True and in a transaction.
+        """
+        entities = self.get_multi(
+            keys=[key],
+            missing=missing,
+            deferred=deferred,
+            transaction=transaction,
+            eventual=eventual,
+        )
+        if entities:
+            return entities[0]
+
+    def get_multi(
+        self, keys, missing=None, deferred=None, transaction=None, eventual=False
+    ):
+        """Retrieve entities, along with their attributes.
+
+        :type keys: list of :class:`google.cloud.datastore.key.Key`
+        :param keys: The keys to be retrieved from the datastore.
+
+        :type missing: list
+        :param missing: (Optional) If a list is passed, the key-only entities
+                        returned by the backend as "missing" will be copied
+                        into it. If the list is not empty, an error will occur.
+
+        :type deferred: list
+        :param deferred: (Optional) If a list is passed, the keys returned
+                         by the backend as "deferred" will be copied into it.
+                         If the list is not empty, an error will occur.
+
+        :type transaction:
+            :class:`~google.cloud.datastore.transaction.Transaction`
+        :param transaction: (Optional) Transaction to use for read consistency.
+                            If not passed, uses current transaction, if set.
+
+        :type eventual: bool
+        :param eventual: (Optional) Defaults to strongly consistent (False).
+                         Setting True will use eventual consistency, but cannot
+                         be used inside a transaction or will raise ValueError.
+
+        :rtype: list of :class:`google.cloud.datastore.entity.Entity`
+        :returns: The requested entities.
+        :raises: :class:`ValueError` if one or more of ``keys`` has a project
+                 which does not match our project.
+        :raises: :class:`ValueError` if eventual is True and in a transaction.
+        """
+        if not keys:
+            return []
+
+        ids = set(key.project for key in keys)
+        for current_id in ids:
+            if current_id != self.project:
+                raise ValueError("Keys do not match project")
+
+        if transaction is None:
+            transaction = self.current_transaction
+
+        entity_pbs = _extended_lookup(
+            datastore_api=self._datastore_api,
+            project=self.project,
+            key_pbs=[key.to_protobuf() for key in keys],
+            eventual=eventual,
+            missing=missing,
+            deferred=deferred,
+            transaction_id=transaction and transaction.id,
+        )
+
+        if missing is not None:
+            missing[:] = [
+                helpers.entity_from_protobuf(missed_pb) for missed_pb in missing
+            ]
+
+        if deferred is not None:
+            deferred[:] = [
+                helpers.key_from_protobuf(deferred_pb) for deferred_pb in deferred
+            ]
+
+        return [helpers.entity_from_protobuf(entity_pb) for entity_pb in entity_pbs]
+
+    def put(self, entity):
+        """Save an entity in the Cloud Datastore.
+
+        .. note::
+
+           This is just a thin wrapper over :meth:`put_multi`.
+           The backend API does not make a distinction between a single
+           entity or multiple entities in a commit request.
+
+        :type entity: :class:`google.cloud.datastore.entity.Entity`
+        :param entity: The entity to be saved to the datastore.
+        """
+        self.put_multi(entities=[entity])
+
+    def put_multi(self, entities):
+        """Save entities in the Cloud Datastore.
+
+        :type entities: list of :class:`google.cloud.datastore.entity.Entity`
+        :param entities: The entities to be saved to the datastore.
+
+        :raises: :class:`ValueError` if ``entities`` is a single entity.
+        """
+        if isinstance(entities, Entity):
+            raise ValueError("Pass a sequence of entities")
+
+        if not entities:
+            return
+
+        current = self.current_batch
+        in_batch = current is not None
+
+        if not in_batch:
+            current = self.batch()
+            current.begin()
+
+        for entity in entities:
+            current.put(entity)
+
+        if not in_batch:
+            current.commit()
+
+    def delete(self, key):
+        """Delete the key in the Cloud Datastore.
+
+        .. note::
+
+           This is just a thin wrapper over :meth:`delete_multi`.
+           The backend API does not make a distinction between a single key or
+           multiple keys in a commit request.
+
+        :type key: :class:`google.cloud.datastore.key.Key`
+        :param key: The key to be deleted from the datastore.
+        """
+        self.delete_multi(keys=[key])
+
+    def delete_multi(self, keys):
+        """Delete keys from the Cloud Datastore.
+
+        :type keys: list of :class:`google.cloud.datastore.key.Key`
+        :param keys: The keys to be deleted from the Datastore.
+        """
+        if not keys:
+            return
+
+        # We allow partial keys to attempt a delete, the backend will fail.
+        current = self.current_batch
+        in_batch = current is not None
+
+        if not in_batch:
+            current = self.batch()
+            current.begin()
+
+        for key in keys:
+            current.delete(key)
+
+        if not in_batch:
+            current.commit()
+
+    def allocate_ids(self, incomplete_key, num_ids):
+        """Allocate a list of IDs from a partial key.
+
+        :type incomplete_key: :class:`google.cloud.datastore.key.Key`
+        :param incomplete_key: Partial key to use as base for allocated IDs.
+
+        :type num_ids: int
+        :param num_ids: The number of IDs to allocate.
+
+        :rtype: list of :class:`google.cloud.datastore.key.Key`
+        :returns: The (complete) keys allocated with ``incomplete_key`` as
+                  root.
+        :raises: :class:`ValueError` if ``incomplete_key`` is not a
+                 partial key.
+        """
+        if not incomplete_key.is_partial:
+            raise ValueError(("Key is not partial.", incomplete_key))
+
+        incomplete_key_pb = incomplete_key.to_protobuf()
+        incomplete_key_pbs = [incomplete_key_pb] * num_ids
+
+        response_pb = self._datastore_api.allocate_ids(
+            incomplete_key.project, incomplete_key_pbs
+        )
+        allocated_ids = [
+            allocated_key_pb.path[-1].id for allocated_key_pb in response_pb.keys
+        ]
+        return [
+            incomplete_key.completed_key(allocated_id) for allocated_id in allocated_ids
+        ]
+
+    def key(self, *path_args, **kwargs):
+        """Proxy to :class:`google.cloud.datastore.key.Key`.
+
+        Passes our ``project``.
+        """
+        if "project" in kwargs:
+            raise TypeError("Cannot pass project")
+        kwargs["project"] = self.project
+        if "namespace" not in kwargs:
+            kwargs["namespace"] = self.namespace
+        return Key(*path_args, **kwargs)
+
+    def batch(self):
+        """Proxy to :class:`google.cloud.datastore.batch.Batch`."""
+        return Batch(self)
+
+    def transaction(self, **kwargs):
+        """Proxy to :class:`google.cloud.datastore.transaction.Transaction`.
+
+        :param kwargs: Keyword arguments to be passed in.
+        """
+        return Transaction(self, **kwargs)
+
+    def query(self, **kwargs):
+        """Proxy to :class:`google.cloud.datastore.query.Query`.
+
+        Passes our ``project``.
+
+        Using query to search a datastore:
+
+        .. testsetup:: query
+
+            import os
+            import uuid
+
+            from google.cloud import datastore
+
+            unique = os.getenv('CIRCLE_BUILD_NUM', str(uuid.uuid4())[0:8])
+            client = datastore.Client(namespace='ns{}'.format(unique))
+            query = client.query(kind='_Doctest')
+
+            def do_something(entity):
+                pass
+
+        .. doctest:: query
+
+            >>> query = client.query(kind='MyKind')
+            >>> query.add_filter('property', '=', 'val')
+
+        Using the query iterator
+
+        .. doctest:: query
+
+            >>> query_iter = query.fetch()
+            >>> for entity in query_iter:
+            ...     do_something(entity)
+
+        or manually page through results
+
+        .. testsetup:: query-page
+
+            import os
+            import uuid
+
+            from google.cloud import datastore
+            from tests.system.test_system import Config  # system tests
+
+            unique = os.getenv('CIRCLE_BUILD_NUM', str(uuid.uuid4())[0:8])
+            client = datastore.Client(namespace='ns{}'.format(unique))
+
+            key = client.key('_Doctest')
+            entity1 = datastore.Entity(key=key)
+            entity1['foo'] = 1337
+            entity2 = datastore.Entity(key=key)
+            entity2['foo'] = 42
+            Config.TO_DELETE.extend([entity1, entity2])
+            client.put_multi([entity1, entity2])
+
+            query = client.query(kind='_Doctest')
+            cursor = None
+
+        .. doctest:: query-page
+
+            >>> query_iter = query.fetch(start_cursor=cursor)
+            >>> pages = query_iter.pages
+            >>>
+            >>> first_page = next(pages)
+            >>> first_page_entities = list(first_page)
+            >>> query_iter.next_page_token is None
+            True
+
+        :param kwargs: Parameters for initializing and instance of
+                       :class:`~google.cloud.datastore.query.Query`.
+
+        :rtype: :class:`~google.cloud.datastore.query.Query`
+        :returns: A query object.
+        """
+        if "client" in kwargs:
+            raise TypeError("Cannot pass client")
+        if "project" in kwargs:
+            raise TypeError("Cannot pass project")
+        kwargs["project"] = self.project
+        if "namespace" not in kwargs:
+            kwargs["namespace"] = self.namespace
+        return Query(self, **kwargs)
+
+    def reserve_ids(self, complete_key, num_ids):
+        """Reserve a list of IDs from a complete key.
+
+        :type complete_key: :class:`google.cloud.datastore.key.Key`
+        :param complete_key: Partial key to use as base for reserved IDs.
+
+        :type num_ids: int
+        :param num_ids: The number of IDs to reserve.
+
+        :rtype: class:`NoneType`
+        :returns: None
+        :raises: :class:`ValueError` if `complete_key`` is not a
+                 Complete key.
+        """
+        if complete_key.is_partial:
+            raise ValueError(("Key is not Complete.", complete_key))
+
+        if not isinstance(num_ids, int):
+            raise ValueError(("num_ids is not a valid integer.", num_ids))
+
+        complete_key_pb = complete_key.to_protobuf()
+        complete_key_pbs = [complete_key_pb] * num_ids
+
+        self._datastore_api.reserve_ids(complete_key.project, complete_key_pbs)
+
+        return None
diff --git a/datastore/google/cloud/datastore/entity.py b/datastore/google/cloud/datastore/entity.py
new file mode 100644
index 000000000000..c317bdda85fd
--- /dev/null
+++ b/datastore/google/cloud/datastore/entity.py
@@ -0,0 +1,213 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Class for representing a single entity in the Cloud Datastore."""
+
+
+from google.cloud._helpers import _ensure_tuple_or_list
+
+
+class Entity(dict):
+    """Entities are akin to rows in a relational database
+
+    An entity storing the actual instance of data.
+
+    Each entity is officially represented with a
+    :class:`~google.cloud.datastore.key.Key`, however it is possible that
+    you might create an entity with only a partial key (that is, a key
+    with a kind, and possibly a parent, but without an ID).  In such a
+    case, the datastore service will automatically assign an ID to the
+    partial key.
+
+    Entities in this API act like dictionaries with extras built in that
+    allow you to delete or persist the data stored on the entity.
+
+    Entities are mutable and act like a subclass of a dictionary.
+    This means you could take an existing entity and change the key
+    to duplicate the object.
+
+    Use :meth:`~google.cloud.datastore.client.Client.get` to retrieve an
+    existing entity:
+
+    .. testsetup:: entity-ctor
+
+        import os
+        import uuid
+
+        from google.cloud import datastore
+        from tests.system.test_system import Config  # system tests
+
+        unique = os.getenv('CIRCLE_BUILD_NUM', str(uuid.uuid4())[0:8])
+        client = datastore.Client(namespace='ns{}'.format(unique))
+        key = client.key('EntityKind', 1234, namespace='_Doctest')
+        entity = datastore.Entity(key=key)
+        entity['property'] = 'value'
+        Config.TO_DELETE.append(entity)
+
+        client.put(entity)
+
+    .. doctest:: entity-ctor
+
+        >>> client.get(key)
+        <Entity('EntityKind', 1234) {'property': 'value'}>
+
+    You can the set values on the entity just like you would on any
+    other dictionary.
+
+    .. doctest:: entity-ctor
+
+        >>> entity['age'] = 20
+        >>> entity['name'] = 'JJ'
+
+    However, not all types are allowed as a value for a Google Cloud Datastore
+    entity. The following basic types are supported by the API:
+
+    * :class:`datetime.datetime`
+    * :class:`~google.cloud.datastore.key.Key`
+    * :class:`bool`
+    * :class:`float`
+    * :class:`int` (as well as :class:`long` in Python 2)
+    * ``unicode`` (called ``str`` in Python 3)
+    * ``bytes`` (called ``str`` in Python 2)
+    * :class:`~google.cloud.datastore.helpers.GeoPoint`
+    * :data:`None`
+
+    In addition, three container types are supported:
+
+    * :class:`list`
+    * :class:`~google.cloud.datastore.entity.Entity`
+    * :class:`dict` (will just be treated like an ``Entity`` without
+      a key or ``exclude_from_indexes``)
+
+    Each entry in a list must be one of the value types (basic or
+    container) and each value in an
+    :class:`~google.cloud.datastore.entity.Entity` must as well. In
+    this case an :class:`~google.cloud.datastore.entity.Entity` **as a
+    container** acts as a :class:`dict`, but also has the special annotations
+    of ``key`` and ``exclude_from_indexes``.
+
+    And you can treat an entity like a regular Python dictionary:
+
+    .. testsetup:: entity-dict
+
+        from google.cloud import datastore
+
+        entity = datastore.Entity()
+        entity['age'] = 20
+        entity['name'] = 'JJ'
+
+    .. doctest:: entity-dict
+
+        >>> sorted(entity.keys())
+        ['age', 'name']
+        >>> sorted(entity.items())
+        [('age', 20), ('name', 'JJ')]
+
+    .. note::
+
+        When saving an entity to the backend, values which are "text"
+        (``unicode`` in Python2, ``str`` in Python3) will be saved using
+        the 'text_value' field, after being encoded to UTF-8.  When
+        retrieved from the back-end, such values will be decoded to "text"
+        again.  Values which are "bytes" (``str`` in Python2, ``bytes`` in
+        Python3), will be saved using the 'blob_value' field, without
+        any decoding / encoding step.
+
+    :type key: :class:`google.cloud.datastore.key.Key`
+    :param key: Optional key to be set on entity.
+
+    :type exclude_from_indexes: tuple of string
+    :param exclude_from_indexes: Names of fields whose values are not to be
+                                 indexed for this entity.
+    """
+
+    def __init__(self, key=None, exclude_from_indexes=()):
+        super(Entity, self).__init__()
+        self.key = key
+        self.exclude_from_indexes = set(
+            _ensure_tuple_or_list("exclude_from_indexes", exclude_from_indexes)
+        )
+        """Names of fields which are *not* to be indexed for this entity."""
+        # NOTE: This will be populated when parsing a protobuf in
+        #       google.cloud.datastore.helpers.entity_from_protobuf.
+        self._meanings = {}
+
+    def __eq__(self, other):
+        """Compare two entities for equality.
+
+        Entities compare equal if their keys compare equal and their
+        properties compare equal.
+
+        :rtype: bool
+        :returns: True if the entities compare equal, else False.
+        """
+        if not isinstance(other, Entity):
+            return NotImplemented
+
+        return (
+            self.key == other.key
+            and self.exclude_from_indexes == other.exclude_from_indexes
+            and self._meanings == other._meanings
+            and super(Entity, self).__eq__(other)
+        )
+
+    def __ne__(self, other):
+        """Compare two entities for inequality.
+
+        Entities compare equal if their keys compare equal and their
+        properties compare equal.
+
+        :rtype: bool
+        :returns: False if the entities compare equal, else True.
+        """
+        return not self == other
+
+    @property
+    def kind(self):
+        """Get the kind of the current entity.
+
+        .. note::
+
+            This relies entirely on the :class:`google.cloud.datastore.key.Key`
+            set on the entity.  That means that we're not storing the kind
+            of the entity at all, just the properties and a pointer to a
+            Key which knows its Kind.
+        """
+        if self.key:
+            return self.key.kind
+
+    @property
+    def id(self):
+        """Get the ID of the current entity.
+
+        .. note::
+
+            This relies entirely on the :class:`google.cloud.datastore.key.Key`
+            set on the entity.  That means that we're not storing the ID
+            of the entity at all, just the properties and a pointer to a
+            Key which knows its ID.
+        """
+        if self.key is None:
+            return None
+        else:
+            return self.key.id
+
+    def __repr__(self):
+        if self.key:
+            return "<Entity%s %s>" % (
+                self.key._flat_path,
+                super(Entity, self).__repr__(),
+            )
+        else:
+            return "<Entity %s>" % (super(Entity, self).__repr__(),)
diff --git a/datastore/google/cloud/datastore/helpers.py b/datastore/google/cloud/datastore/helpers.py
new file mode 100644
index 000000000000..db6f150eff8b
--- /dev/null
+++ b/datastore/google/cloud/datastore/helpers.py
@@ -0,0 +1,513 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helper functions for dealing with Cloud Datastore's Protobuf API.
+
+The non-private functions are part of the API.
+"""
+
+import datetime
+import itertools
+
+from google.protobuf import struct_pb2
+from google.type import latlng_pb2
+import six
+
+from google.cloud._helpers import _datetime_to_pb_timestamp
+from google.cloud._helpers import _pb_timestamp_to_datetime
+from google.cloud.datastore_v1.proto import datastore_pb2
+from google.cloud.datastore_v1.proto import entity_pb2
+from google.cloud.datastore.entity import Entity
+from google.cloud.datastore.key import Key
+
+
+def _get_meaning(value_pb, is_list=False):
+    """Get the meaning from a protobuf value.
+
+    :type value_pb: :class:`.entity_pb2.Value`
+    :param value_pb: The protobuf value to be checked for an
+                     associated meaning.
+
+    :type is_list: bool
+    :param is_list: Boolean indicating if the ``value_pb`` contains
+                    a list value.
+
+    :rtype: int
+    :returns: The meaning for the ``value_pb`` if one is set, else
+              :data:`None`. For a list value, if there are disagreeing
+              means it just returns a list of meanings. If all the
+              list meanings agree, it just condenses them.
+    """
+    meaning = None
+    if is_list:
+        # An empty list will have no values, hence no shared meaning
+        # set among them.
+        if len(value_pb.array_value.values) == 0:
+            return None
+
+        # We check among all the meanings, some of which may be None,
+        # the rest which may be enum/int values.
+        all_meanings = [
+            _get_meaning(sub_value_pb) for sub_value_pb in value_pb.array_value.values
+        ]
+        unique_meanings = set(all_meanings)
+        if len(unique_meanings) == 1:
+            # If there is a unique meaning, we preserve it.
+            meaning = unique_meanings.pop()
+        else:  # We know len(value_pb.array_value.values) > 0.
+            # If the meaning is not unique, just return all of them.
+            meaning = all_meanings
+    elif value_pb.meaning:  # Simple field (int32).
+        meaning = value_pb.meaning
+
+    return meaning
+
+
+def _new_value_pb(entity_pb, name):
+    """Add (by name) a new ``Value`` protobuf to an entity protobuf.
+
+    :type entity_pb: :class:`.entity_pb2.Entity`
+    :param entity_pb: An entity protobuf to add a new property to.
+
+    :type name: str
+    :param name: The name of the new property.
+
+    :rtype: :class:`.entity_pb2.Value`
+    :returns: The new ``Value`` protobuf that was added to the entity.
+    """
+    return entity_pb.properties.get_or_create(name)
+
+
+def _property_tuples(entity_pb):
+    """Iterator of name, ``Value`` tuples from entity properties.
+
+    :type entity_pb: :class:`.entity_pb2.Entity`
+    :param entity_pb: An entity protobuf to add a new property to.
+
+    :rtype: :class:`generator`
+    :returns: An iterator that yields tuples of a name and ``Value``
+              corresponding to properties on the entity.
+    """
+    return six.iteritems(entity_pb.properties)
+
+
+def entity_from_protobuf(pb):
+    """Factory method for creating an entity based on a protobuf.
+
+    The protobuf should be one returned from the Cloud Datastore
+    Protobuf API.
+
+    :type pb: :class:`.entity_pb2.Entity`
+    :param pb: The Protobuf representing the entity.
+
+    :rtype: :class:`google.cloud.datastore.entity.Entity`
+    :returns: The entity derived from the protobuf.
+    """
+    key = None
+    if pb.HasField("key"):  # Message field (Key)
+        key = key_from_protobuf(pb.key)
+
+    entity_props = {}
+    entity_meanings = {}
+    exclude_from_indexes = []
+
+    for prop_name, value_pb in _property_tuples(pb):
+        value = _get_value_from_value_pb(value_pb)
+        entity_props[prop_name] = value
+
+        # Check if the property has an associated meaning.
+        is_list = isinstance(value, list)
+        meaning = _get_meaning(value_pb, is_list=is_list)
+        if meaning is not None:
+            entity_meanings[prop_name] = (meaning, value)
+
+        # Check if ``value_pb`` was excluded from index. Lists need to be
+        # special-cased and we require all ``exclude_from_indexes`` values
+        # in a list agree.
+        if is_list and len(value) > 0:
+            exclude_values = set(
+                value_pb.exclude_from_indexes
+                for value_pb in value_pb.array_value.values
+            )
+            if len(exclude_values) != 1:
+                raise ValueError(
+                    "For an array_value, subvalues must either "
+                    "all be indexed or all excluded from "
+                    "indexes."
+                )
+
+            if exclude_values.pop():
+                exclude_from_indexes.append(prop_name)
+        else:
+            if value_pb.exclude_from_indexes:
+                exclude_from_indexes.append(prop_name)
+
+    entity = Entity(key=key, exclude_from_indexes=exclude_from_indexes)
+    entity.update(entity_props)
+    entity._meanings.update(entity_meanings)
+    return entity
+
+
+def _set_pb_meaning_from_entity(entity, name, value, value_pb, is_list=False):
+    """Add meaning information (from an entity) to a protobuf.
+
+    :type entity: :class:`google.cloud.datastore.entity.Entity`
+    :param entity: The entity to be turned into a protobuf.
+
+    :type name: str
+    :param name: The name of the property.
+
+    :type value: object
+    :param value: The current value stored as property ``name``.
+
+    :type value_pb: :class:`.entity_pb2.Value`
+    :param value_pb: The protobuf value to add meaning / meanings to.
+
+    :type is_list: bool
+    :param is_list: (Optional) Boolean indicating if the ``value`` is
+                    a list value.
+    """
+    if name not in entity._meanings:
+        return
+
+    meaning, orig_value = entity._meanings[name]
+    # Only add the meaning back to the protobuf if the value is
+    # unchanged from when it was originally read from the API.
+    if orig_value is not value:
+        return
+
+    # For lists, we set meaning on each sub-element.
+    if is_list:
+        if not isinstance(meaning, list):
+            meaning = itertools.repeat(meaning)
+        val_iter = six.moves.zip(value_pb.array_value.values, meaning)
+        for sub_value_pb, sub_meaning in val_iter:
+            if sub_meaning is not None:
+                sub_value_pb.meaning = sub_meaning
+    else:
+        value_pb.meaning = meaning
+
+
+def entity_to_protobuf(entity):
+    """Converts an entity into a protobuf.
+
+    :type entity: :class:`google.cloud.datastore.entity.Entity`
+    :param entity: The entity to be turned into a protobuf.
+
+    :rtype: :class:`.entity_pb2.Entity`
+    :returns: The protobuf representing the entity.
+    """
+    entity_pb = entity_pb2.Entity()
+    if entity.key is not None:
+        key_pb = entity.key.to_protobuf()
+        entity_pb.key.CopyFrom(key_pb)
+
+    for name, value in entity.items():
+        value_is_list = isinstance(value, list)
+
+        value_pb = _new_value_pb(entity_pb, name)
+        # Set the appropriate value.
+        _set_protobuf_value(value_pb, value)
+
+        # Add index information to protobuf.
+        if name in entity.exclude_from_indexes:
+            if not value_is_list:
+                value_pb.exclude_from_indexes = True
+
+            for sub_value in value_pb.array_value.values:
+                sub_value.exclude_from_indexes = True
+
+        # Add meaning information to protobuf.
+        _set_pb_meaning_from_entity(
+            entity, name, value, value_pb, is_list=value_is_list
+        )
+
+    return entity_pb
+
+
+def get_read_options(eventual, transaction_id):
+    """Validate rules for read options, and assign to the request.
+
+    Helper method for ``lookup()`` and ``run_query``.
+
+    :type eventual: bool
+    :param eventual: Flag indicating if ``EVENTUAL`` or ``STRONG``
+                     consistency should be used.
+
+    :type transaction_id: bytes
+    :param transaction_id: A transaction identifier (may be null).
+
+    :rtype: :class:`.datastore_pb2.ReadOptions`
+    :returns: The read options corresponding to the inputs.
+    :raises: :class:`ValueError` if ``eventual`` is ``True`` and the
+             ``transaction_id`` is not ``None``.
+    """
+    if transaction_id is None:
+        if eventual:
+            return datastore_pb2.ReadOptions(
+                read_consistency=datastore_pb2.ReadOptions.EVENTUAL
+            )
+        else:
+            return datastore_pb2.ReadOptions()
+    else:
+        if eventual:
+            raise ValueError("eventual must be False when in a transaction")
+        else:
+            return datastore_pb2.ReadOptions(transaction=transaction_id)
+
+
+def key_from_protobuf(pb):
+    """Factory method for creating a key based on a protobuf.
+
+    The protobuf should be one returned from the Cloud Datastore
+    Protobuf API.
+
+    :type pb: :class:`.entity_pb2.Key`
+    :param pb: The Protobuf representing the key.
+
+    :rtype: :class:`google.cloud.datastore.key.Key`
+    :returns: a new `Key` instance
+    """
+    path_args = []
+    for element in pb.path:
+        path_args.append(element.kind)
+        if element.id:  # Simple field (int64)
+            path_args.append(element.id)
+        # This is safe: we expect proto objects returned will only have
+        # one of `name` or `id` set.
+        if element.name:  # Simple field (string)
+            path_args.append(element.name)
+
+    project = None
+    if pb.partition_id.project_id:  # Simple field (string)
+        project = pb.partition_id.project_id
+    namespace = None
+    if pb.partition_id.namespace_id:  # Simple field (string)
+        namespace = pb.partition_id.namespace_id
+
+    return Key(*path_args, namespace=namespace, project=project)
+
+
+def _pb_attr_value(val):
+    """Given a value, return the protobuf attribute name and proper value.
+
+    The Protobuf API uses different attribute names based on value types
+    rather than inferring the type.  This function simply determines the
+    proper attribute name based on the type of the value provided and
+    returns the attribute name as well as a properly formatted value.
+
+    Certain value types need to be coerced into a different type (such
+    as a `datetime.datetime` into an integer timestamp, or a
+    `google.cloud.datastore.key.Key` into a Protobuf representation.  This
+    function handles that for you.
+
+    .. note::
+       Values which are "text" ('unicode' in Python2, 'str' in Python3) map
+       to 'string_value' in the datastore;  values which are "bytes"
+       ('str' in Python2, 'bytes' in Python3) map to 'blob_value'.
+
+    For example:
+
+    >>> _pb_attr_value(1234)
+    ('integer_value', 1234)
+    >>> _pb_attr_value('my_string')
+    ('string_value', 'my_string')
+
+    :type val:
+        :class:`datetime.datetime`, :class:`google.cloud.datastore.key.Key`,
+        bool, float, integer, bytes, str, unicode,
+        :class:`google.cloud.datastore.entity.Entity`, dict, list,
+        :class:`google.cloud.datastore.helpers.GeoPoint`, NoneType
+    :param val: The value to be scrutinized.
+
+    :rtype: tuple
+    :returns: A tuple of the attribute name and proper value type.
+    """
+
+    if isinstance(val, datetime.datetime):
+        name = "timestamp"
+        value = _datetime_to_pb_timestamp(val)
+    elif isinstance(val, Key):
+        name, value = "key", val.to_protobuf()
+    elif isinstance(val, bool):
+        name, value = "boolean", val
+    elif isinstance(val, float):
+        name, value = "double", val
+    elif isinstance(val, six.integer_types):
+        name, value = "integer", val
+    elif isinstance(val, six.text_type):
+        name, value = "string", val
+    elif isinstance(val, six.binary_type):
+        name, value = "blob", val
+    elif isinstance(val, Entity):
+        name, value = "entity", val
+    elif isinstance(val, dict):
+        entity_val = Entity(key=None)
+        entity_val.update(val)
+        name, value = "entity", entity_val
+    elif isinstance(val, list):
+        name, value = "array", val
+    elif isinstance(val, GeoPoint):
+        name, value = "geo_point", val.to_protobuf()
+    elif val is None:
+        name, value = "null", struct_pb2.NULL_VALUE
+    else:
+        raise ValueError("Unknown protobuf attr type", type(val))
+
+    return name + "_value", value
+
+
+def _get_value_from_value_pb(value_pb):
+    """Given a protobuf for a Value, get the correct value.
+
+    The Cloud Datastore Protobuf API returns a Property Protobuf which
+    has one value set and the rest blank.  This function retrieves the
+    the one value provided.
+
+    Some work is done to coerce the return value into a more useful type
+    (particularly in the case of a timestamp value, or a key value).
+
+    :type value_pb: :class:`.entity_pb2.Value`
+    :param value_pb: The Value Protobuf.
+
+    :rtype: object
+    :returns: The value provided by the Protobuf.
+    :raises: :class:`ValueError <exceptions.ValueError>` if no value type
+             has been set.
+    """
+    value_type = value_pb.WhichOneof("value_type")
+
+    if value_type == "timestamp_value":
+        result = _pb_timestamp_to_datetime(value_pb.timestamp_value)
+
+    elif value_type == "key_value":
+        result = key_from_protobuf(value_pb.key_value)
+
+    elif value_type == "boolean_value":
+        result = value_pb.boolean_value
+
+    elif value_type == "double_value":
+        result = value_pb.double_value
+
+    elif value_type == "integer_value":
+        result = value_pb.integer_value
+
+    elif value_type == "string_value":
+        result = value_pb.string_value
+
+    elif value_type == "blob_value":
+        result = value_pb.blob_value
+
+    elif value_type == "entity_value":
+        result = entity_from_protobuf(value_pb.entity_value)
+
+    elif value_type == "array_value":
+        result = [
+            _get_value_from_value_pb(value) for value in value_pb.array_value.values
+        ]
+
+    elif value_type == "geo_point_value":
+        result = GeoPoint(
+            value_pb.geo_point_value.latitude, value_pb.geo_point_value.longitude
+        )
+
+    elif value_type == "null_value":
+        result = None
+
+    else:
+        raise ValueError("Value protobuf did not have any value set")
+
+    return result
+
+
+def _set_protobuf_value(value_pb, val):
+    """Assign 'val' to the correct subfield of 'value_pb'.
+
+    The Protobuf API uses different attribute names based on value types
+    rather than inferring the type.
+
+    Some value types (entities, keys, lists) cannot be directly
+    assigned; this function handles them correctly.
+
+    :type value_pb: :class:`.entity_pb2.Value`
+    :param value_pb: The value protobuf to which the value is being assigned.
+
+    :type val: :class:`datetime.datetime`, boolean, float, integer, string,
+               :class:`google.cloud.datastore.key.Key`,
+               :class:`google.cloud.datastore.entity.Entity`
+    :param val: The value to be assigned.
+    """
+    attr, val = _pb_attr_value(val)
+    if attr == "key_value":
+        value_pb.key_value.CopyFrom(val)
+    elif attr == "timestamp_value":
+        value_pb.timestamp_value.CopyFrom(val)
+    elif attr == "entity_value":
+        entity_pb = entity_to_protobuf(val)
+        value_pb.entity_value.CopyFrom(entity_pb)
+    elif attr == "array_value":
+        if len(val) == 0:
+            array_value = entity_pb2.ArrayValue(values=[])
+            value_pb.array_value.CopyFrom(array_value)
+        else:
+            l_pb = value_pb.array_value.values
+            for item in val:
+                i_pb = l_pb.add()
+                _set_protobuf_value(i_pb, item)
+    elif attr == "geo_point_value":
+        value_pb.geo_point_value.CopyFrom(val)
+    else:  # scalar, just assign
+        setattr(value_pb, attr, val)
+
+
+class GeoPoint(object):
+    """Simple container for a geo point value.
+
+    :type latitude: float
+    :param latitude: Latitude of a point.
+
+    :type longitude: float
+    :param longitude: Longitude of a point.
+    """
+
+    def __init__(self, latitude, longitude):
+        self.latitude = latitude
+        self.longitude = longitude
+
+    def to_protobuf(self):
+        """Convert the current object to protobuf.
+
+        :rtype: :class:`google.type.latlng_pb2.LatLng`.
+        :returns: The current point as a protobuf.
+        """
+        return latlng_pb2.LatLng(latitude=self.latitude, longitude=self.longitude)
+
+    def __eq__(self, other):
+        """Compare two geo points for equality.
+
+        :rtype: bool
+        :returns: True if the points compare equal, else False.
+        """
+        if not isinstance(other, GeoPoint):
+            return NotImplemented
+
+        return self.latitude == other.latitude and self.longitude == other.longitude
+
+    def __ne__(self, other):
+        """Compare two geo points for inequality.
+
+        :rtype: bool
+        :returns: False if the points compare equal, else True.
+        """
+        return not self == other
diff --git a/datastore/google/cloud/datastore/key.py b/datastore/google/cloud/datastore/key.py
new file mode 100644
index 000000000000..c988eebd80af
--- /dev/null
+++ b/datastore/google/cloud/datastore/key.py
@@ -0,0 +1,655 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Datastore keys."""
+
+import base64
+import copy
+import six
+
+from google.cloud.datastore_v1.proto import entity_pb2 as _entity_pb2
+
+from google.cloud._helpers import _to_bytes
+from google.cloud.datastore import _app_engine_key_pb2
+
+
+_DATABASE_ID_TEMPLATE = (
+    "Received non-empty database ID: {!r}.\n"
+    "urlsafe strings are not expected to encode a Reference that "
+    "contains a database ID."
+)
+_BAD_ELEMENT_TEMPLATE = (
+    "At most one of ID and name can be set on an element. Received "
+    "id = {!r} and name = {!r}."
+)
+_EMPTY_ELEMENT = (
+    "Exactly one of ID and name must be set on an element. "
+    "Encountered an element with neither set that was not the last "
+    "element of a path."
+)
+
+
+class Key(object):
+    """An immutable representation of a datastore Key.
+
+    .. testsetup:: key-ctor
+
+       from google.cloud import datastore
+
+       project = 'my-special-pony'
+       client = datastore.Client(project=project)
+       Key = datastore.Key
+
+       parent_key = client.key('Parent', 'foo')
+
+    To create a basic key directly:
+
+    .. doctest:: key-ctor
+
+       >>> Key('EntityKind', 1234, project=project)
+       <Key('EntityKind', 1234), project=...>
+       >>> Key('EntityKind', 'foo', project=project)
+       <Key('EntityKind', 'foo'), project=...>
+
+    Though typical usage comes via the
+    :meth:`~google.cloud.datastore.client.Client.key` factory:
+
+    .. doctest:: key-ctor
+
+       >>> client.key('EntityKind', 1234)
+       <Key('EntityKind', 1234), project=...>
+       >>> client.key('EntityKind', 'foo')
+       <Key('EntityKind', 'foo'), project=...>
+
+    To create a key with a parent:
+
+    .. doctest:: key-ctor
+
+       >>> client.key('Parent', 'foo', 'Child', 1234)
+       <Key('Parent', 'foo', 'Child', 1234), project=...>
+       >>> client.key('Child', 1234, parent=parent_key)
+       <Key('Parent', 'foo', 'Child', 1234), project=...>
+
+    To create a partial key:
+
+    .. doctest:: key-ctor
+
+       >>> client.key('Parent', 'foo', 'Child')
+       <Key('Parent', 'foo', 'Child'), project=...>
+
+    :type path_args: tuple of string and integer
+    :param path_args: May represent a partial (odd length) or full (even
+                      length) key path.
+
+    :param kwargs: Keyword arguments to be passed in.
+
+    Accepted keyword arguments are
+
+    * namespace (string): A namespace identifier for the key.
+    * project (string): The project associated with the key.
+    * parent (:class:`~google.cloud.datastore.key.Key`): The parent of the key.
+
+    The project argument is required unless it has been set implicitly.
+    """
+
+    def __init__(self, *path_args, **kwargs):
+        self._flat_path = path_args
+        parent = self._parent = kwargs.get("parent")
+        self._namespace = kwargs.get("namespace")
+        project = kwargs.get("project")
+        self._project = _validate_project(project, parent)
+        # _flat_path, _parent, _namespace and _project must be set before
+        # _combine_args() is called.
+        self._path = self._combine_args()
+
+    def __eq__(self, other):
+        """Compare two keys for equality.
+
+        Incomplete keys never compare equal to any other key.
+
+        Completed keys compare equal if they have the same path, project,
+        and namespace.
+
+        :rtype: bool
+        :returns: True if the keys compare equal, else False.
+        """
+        if not isinstance(other, Key):
+            return NotImplemented
+
+        if self.is_partial or other.is_partial:
+            return False
+
+        return (
+            self.flat_path == other.flat_path
+            and self.project == other.project
+            and self.namespace == other.namespace
+        )
+
+    def __ne__(self, other):
+        """Compare two keys for inequality.
+
+        Incomplete keys never compare equal to any other key.
+
+        Completed keys compare equal if they have the same path, project,
+        and namespace.
+
+        :rtype: bool
+        :returns: False if the keys compare equal, else True.
+        """
+        return not self == other
+
+    def __hash__(self):
+        """Hash a keys for use in a dictionary lookp.
+
+        :rtype: int
+        :returns: a hash of the key's state.
+        """
+        return hash(self.flat_path) + hash(self.project) + hash(self.namespace)
+
+    @staticmethod
+    def _parse_path(path_args):
+        """Parses positional arguments into key path with kinds and IDs.
+
+        :type path_args: tuple
+        :param path_args: A tuple from positional arguments. Should be
+                          alternating list of kinds (string) and ID/name
+                          parts (int or string).
+
+        :rtype: :class:`list` of :class:`dict`
+        :returns: A list of key parts with kind and ID or name set.
+        :raises: :class:`ValueError` if there are no ``path_args``, if one of
+                 the kinds is not a string or if one of the IDs/names is not
+                 a string or an integer.
+        """
+        if len(path_args) == 0:
+            raise ValueError("Key path must not be empty.")
+
+        kind_list = path_args[::2]
+        id_or_name_list = path_args[1::2]
+        # Dummy sentinel value to pad incomplete key to even length path.
+        partial_ending = object()
+        if len(path_args) % 2 == 1:
+            id_or_name_list += (partial_ending,)
+
+        result = []
+        for kind, id_or_name in zip(kind_list, id_or_name_list):
+            curr_key_part = {}
+            if isinstance(kind, six.string_types):
+                curr_key_part["kind"] = kind
+            else:
+                raise ValueError(kind, "Kind was not a string.")
+
+            if isinstance(id_or_name, six.string_types):
+                curr_key_part["name"] = id_or_name
+            elif isinstance(id_or_name, six.integer_types):
+                curr_key_part["id"] = id_or_name
+            elif id_or_name is not partial_ending:
+                raise ValueError(id_or_name, "ID/name was not a string or integer.")
+
+            result.append(curr_key_part)
+
+        return result
+
+    def _combine_args(self):
+        """Sets protected data by combining raw data set from the constructor.
+
+        If a ``_parent`` is set, updates the ``_flat_path`` and sets the
+        ``_namespace`` and ``_project`` if not already set.
+
+        :rtype: :class:`list` of :class:`dict`
+        :returns: A list of key parts with kind and ID or name set.
+        :raises: :class:`ValueError` if the parent key is not complete.
+        """
+        child_path = self._parse_path(self._flat_path)
+
+        if self._parent is not None:
+            if self._parent.is_partial:
+                raise ValueError("Parent key must be complete.")
+
+            # We know that _parent.path() will return a copy.
+            child_path = self._parent.path + child_path
+            self._flat_path = self._parent.flat_path + self._flat_path
+            if (
+                self._namespace is not None
+                and self._namespace != self._parent.namespace
+            ):
+                raise ValueError("Child namespace must agree with parent's.")
+            self._namespace = self._parent.namespace
+            if self._project is not None and self._project != self._parent.project:
+                raise ValueError("Child project must agree with parent's.")
+            self._project = self._parent.project
+
+        return child_path
+
+    def _clone(self):
+        """Duplicates the Key.
+
+        Most attributes are simple types, so don't require copying. Other
+        attributes like ``parent`` are long-lived and so we re-use them.
+
+        :rtype: :class:`google.cloud.datastore.key.Key`
+        :returns: A new ``Key`` instance with the same data as the current one.
+        """
+        cloned_self = self.__class__(
+            *self.flat_path, project=self.project, namespace=self.namespace
+        )
+        # If the current parent has already been set, we re-use
+        # the same instance
+        cloned_self._parent = self._parent
+        return cloned_self
+
+    def completed_key(self, id_or_name):
+        """Creates new key from existing partial key by adding final ID/name.
+
+        :type id_or_name: str or integer
+        :param id_or_name: ID or name to be added to the key.
+
+        :rtype: :class:`google.cloud.datastore.key.Key`
+        :returns: A new ``Key`` instance with the same data as the current one
+                  and an extra ID or name added.
+        :raises: :class:`ValueError` if the current key is not partial or if
+                 ``id_or_name`` is not a string or integer.
+        """
+        if not self.is_partial:
+            raise ValueError("Only a partial key can be completed.")
+
+        if isinstance(id_or_name, six.string_types):
+            id_or_name_key = "name"
+        elif isinstance(id_or_name, six.integer_types):
+            id_or_name_key = "id"
+        else:
+            raise ValueError(id_or_name, "ID/name was not a string or integer.")
+
+        new_key = self._clone()
+        new_key._path[-1][id_or_name_key] = id_or_name
+        new_key._flat_path += (id_or_name,)
+        return new_key
+
+    def to_protobuf(self):
+        """Return a protobuf corresponding to the key.
+
+        :rtype: :class:`.entity_pb2.Key`
+        :returns: The protobuf representing the key.
+        """
+        key = _entity_pb2.Key()
+        key.partition_id.project_id = self.project
+
+        if self.namespace:
+            key.partition_id.namespace_id = self.namespace
+
+        for item in self.path:
+            element = key.path.add()
+            if "kind" in item:
+                element.kind = item["kind"]
+            if "id" in item:
+                element.id = item["id"]
+            if "name" in item:
+                element.name = item["name"]
+
+        return key
+
+    def to_legacy_urlsafe(self, location_prefix=None):
+        """Convert to a base64 encode urlsafe string for App Engine.
+
+        This is intended to work with the "legacy" representation of a
+        datastore "Key" used within Google App Engine (a so-called
+        "Reference"). The returned string can be used as the ``urlsafe``
+        argument to ``ndb.Key(urlsafe=...)``. The base64 encoded values
+        will have padding removed.
+
+        .. note::
+
+            The string returned by ``to_legacy_urlsafe`` is equivalent, but
+            not identical, to the string returned by ``ndb``. The location
+            prefix may need to be specified to obtain identical urlsafe
+            keys.
+
+        :type location_prefix: str
+        :param location_prefix: The location prefix of an App Engine project
+                                ID. Often this value is 's~', but may also be
+                                'e~', or other location prefixes currently
+                                unknown.
+
+        :rtype: bytes
+        :returns: A bytestring containing the key encoded as URL-safe base64.
+        """
+        if location_prefix is None:
+            project_id = self.project
+        else:
+            project_id = location_prefix + self.project
+
+        reference = _app_engine_key_pb2.Reference(
+            app=project_id,
+            path=_to_legacy_path(self._path),  # Avoid the copy.
+            name_space=self.namespace,
+        )
+        raw_bytes = reference.SerializeToString()
+        return base64.urlsafe_b64encode(raw_bytes).strip(b"=")
+
+    @classmethod
+    def from_legacy_urlsafe(cls, urlsafe):
+        """Convert urlsafe string to :class:`~google.cloud.datastore.key.Key`.
+
+        This is intended to work with the "legacy" representation of a
+        datastore "Key" used within Google App Engine (a so-called
+        "Reference"). This assumes that ``urlsafe`` was created within an App
+        Engine app via something like ``ndb.Key(...).urlsafe()``.
+
+        :type urlsafe: bytes or unicode
+        :param urlsafe: The base64 encoded (ASCII) string corresponding to a
+                        datastore "Key" / "Reference".
+
+        :rtype: :class:`~google.cloud.datastore.key.Key`.
+        :returns: The key corresponding to ``urlsafe``.
+        """
+        urlsafe = _to_bytes(urlsafe, encoding="ascii")
+        padding = b"=" * (-len(urlsafe) % 4)
+        urlsafe += padding
+        raw_bytes = base64.urlsafe_b64decode(urlsafe)
+
+        reference = _app_engine_key_pb2.Reference()
+        reference.ParseFromString(raw_bytes)
+
+        project = _clean_app(reference.app)
+        namespace = _get_empty(reference.name_space, u"")
+        _check_database_id(reference.database_id)
+        flat_path = _get_flat_path(reference.path)
+        return cls(*flat_path, project=project, namespace=namespace)
+
+    @property
+    def is_partial(self):
+        """Boolean indicating if the key has an ID (or name).
+
+        :rtype: bool
+        :returns: ``True`` if the last element of the key's path does not have
+                  an ``id`` or a ``name``.
+        """
+        return self.id_or_name is None
+
+    @property
+    def namespace(self):
+        """Namespace getter.
+
+        :rtype: str
+        :returns: The namespace of the current key.
+        """
+        return self._namespace
+
+    @property
+    def path(self):
+        """Path getter.
+
+        Returns a copy so that the key remains immutable.
+
+        :rtype: :class:`list` of :class:`dict`
+        :returns: The (key) path of the current key.
+        """
+        return copy.deepcopy(self._path)
+
+    @property
+    def flat_path(self):
+        """Getter for the key path as a tuple.
+
+        :rtype: tuple of string and integer
+        :returns: The tuple of elements in the path.
+        """
+        return self._flat_path
+
+    @property
+    def kind(self):
+        """Kind getter. Based on the last element of path.
+
+        :rtype: str
+        :returns: The kind of the current key.
+        """
+        return self.path[-1]["kind"]
+
+    @property
+    def id(self):
+        """ID getter. Based on the last element of path.
+
+        :rtype: int
+        :returns: The (integer) ID of the key.
+        """
+        return self.path[-1].get("id")
+
+    @property
+    def name(self):
+        """Name getter. Based on the last element of path.
+
+        :rtype: str
+        :returns: The (string) name of the key.
+        """
+        return self.path[-1].get("name")
+
+    @property
+    def id_or_name(self):
+        """Getter. Based on the last element of path.
+
+        :rtype: int (if ``id``) or string (if ``name``)
+        :returns: The last element of the key's path if it is either an ``id``
+                  or a ``name``.
+        """
+        return self.id or self.name
+
+    @property
+    def project(self):
+        """Project getter.
+
+        :rtype: str
+        :returns: The key's project.
+        """
+        return self._project
+
+    def _make_parent(self):
+        """Creates a parent key for the current path.
+
+        Extracts all but the last element in the key path and creates a new
+        key, while still matching the namespace and the project.
+
+        :rtype: :class:`google.cloud.datastore.key.Key` or :class:`NoneType`
+        :returns: A new ``Key`` instance, whose path consists of all but the
+                  last element of current path. If the current key has only
+                  one path element, returns ``None``.
+        """
+        if self.is_partial:
+            parent_args = self.flat_path[:-1]
+        else:
+            parent_args = self.flat_path[:-2]
+        if parent_args:
+            return self.__class__(
+                *parent_args, project=self.project, namespace=self.namespace
+            )
+
+    @property
+    def parent(self):
+        """The parent of the current key.
+
+        :rtype: :class:`google.cloud.datastore.key.Key` or :class:`NoneType`
+        :returns: A new ``Key`` instance, whose path consists of all but the
+                  last element of current path. If the current key has only
+                  one path element, returns ``None``.
+        """
+        if self._parent is None:
+            self._parent = self._make_parent()
+
+        return self._parent
+
+    def __repr__(self):
+        return "<Key%s, project=%s>" % (self._flat_path, self.project)
+
+
+def _validate_project(project, parent):
+    """Ensure the project is set appropriately.
+
+    If ``parent`` is passed, skip the test (it will be checked / fixed up
+    later).
+
+    If ``project`` is unset, attempt to infer the project from the environment.
+
+    :type project: str
+    :param project: A project.
+
+    :type parent: :class:`google.cloud.datastore.key.Key`
+    :param parent: (Optional) The parent of the key or ``None``.
+
+    :rtype: str
+    :returns: The ``project`` passed in, or implied from the environment.
+    :raises: :class:`ValueError` if ``project`` is ``None`` and no project
+             can be inferred from the parent.
+    """
+    if parent is None:
+        if project is None:
+            raise ValueError("A Key must have a project set.")
+
+    return project
+
+
+def _clean_app(app_str):
+    """Clean a legacy (i.e. from App Engine) app string.
+
+    :type app_str: str
+    :param app_str: The ``app`` value stored in a "Reference" pb.
+
+    :rtype: str
+    :returns: The cleaned value.
+    """
+    parts = app_str.split("~", 1)
+    return parts[-1]
+
+
+def _get_empty(value, empty_value):
+    """Check if a protobuf field is "empty".
+
+    :type value: object
+    :param value: A basic field from a protobuf.
+
+    :type empty_value: object
+    :param empty_value: The "empty" value for the same type as
+                        ``value``.
+    """
+    if value == empty_value:
+        return None
+    else:
+        return value
+
+
+def _check_database_id(database_id):
+    """Make sure a "Reference" database ID is empty.
+
+    :type database_id: unicode
+    :param database_id: The ``database_id`` field from a "Reference" protobuf.
+
+    :raises: :exc:`ValueError` if the ``database_id`` is not empty.
+    """
+    if database_id != u"":
+        msg = _DATABASE_ID_TEMPLATE.format(database_id)
+        raise ValueError(msg)
+
+
+def _add_id_or_name(flat_path, element_pb, empty_allowed):
+    """Add the ID or name from an element to a list.
+
+    :type flat_path: list
+    :param flat_path: List of accumulated path parts.
+
+    :type element_pb: :class:`._app_engine_key_pb2.Path.Element`
+    :param element_pb: The element containing ID or name.
+
+    :type empty_allowed: bool
+    :param empty_allowed: Indicates if neither ID or name need be set. If
+                          :data:`False`, then **exactly** one of them must be.
+
+    :raises: :exc:`ValueError` if 0 or 2 of ID/name are set (unless
+             ``empty_allowed=True`` and 0 are set).
+    """
+    id_ = element_pb.id
+    name = element_pb.name
+    # NOTE: Below 0 and the empty string are the "null" values for their
+    #       respective types, indicating that the value is unset.
+    if id_ == 0:
+        if name == u"":
+            if not empty_allowed:
+                raise ValueError(_EMPTY_ELEMENT)
+        else:
+            flat_path.append(name)
+    else:
+        if name == u"":
+            flat_path.append(id_)
+        else:
+            msg = _BAD_ELEMENT_TEMPLATE.format(id_, name)
+            raise ValueError(msg)
+
+
+def _get_flat_path(path_pb):
+    """Convert a legacy "Path" protobuf to a flat path.
+
+    For example
+
+        Element {
+          type: "parent"
+          id: 59
+        }
+        Element {
+          type: "child"
+          name: "naem"
+        }
+
+    would convert to ``('parent', 59, 'child', 'naem')``.
+
+    :type path_pb: :class:`._app_engine_key_pb2.Path`
+    :param path_pb: Legacy protobuf "Path" object (from a "Reference").
+
+    :rtype: tuple
+    :returns: The path parts from ``path_pb``.
+    """
+    num_elts = len(path_pb.element)
+    last_index = num_elts - 1
+
+    result = []
+    for index, element in enumerate(path_pb.element):
+        result.append(element.type)
+        _add_id_or_name(result, element, index == last_index)
+
+    return tuple(result)
+
+
+def _to_legacy_path(dict_path):
+    """Convert a tuple of ints and strings in a legacy "Path".
+
+    .. note:
+
+        This assumes, but does not verify, that each entry in
+        ``dict_path`` is valid (i.e. doesn't have more than one
+        key out of "name" / "id").
+
+    :type dict_path: lsit
+    :param dict_path: The "structured" path for a key, i.e. it
+                      is a list of dictionaries, each of which has
+                      "kind" and one of "name" / "id" as keys.
+
+    :rtype: :class:`._app_engine_key_pb2.Path`
+    :returns: The legacy path corresponding to ``dict_path``.
+    """
+    elements = []
+    for part in dict_path:
+        element_kwargs = {"type": part["kind"]}
+        if "id" in part:
+            element_kwargs["id"] = part["id"]
+        elif "name" in part:
+            element_kwargs["name"] = part["name"]
+        element = _app_engine_key_pb2.Path.Element(**element_kwargs)
+        elements.append(element)
+
+    return _app_engine_key_pb2.Path(element=elements)
diff --git a/datastore/google/cloud/datastore/query.py b/datastore/google/cloud/datastore/query.py
new file mode 100644
index 000000000000..f7979d12be70
--- /dev/null
+++ b/datastore/google/cloud/datastore/query.py
@@ -0,0 +1,625 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Datastore queries."""
+
+import base64
+
+from google.api_core import page_iterator
+from google.cloud._helpers import _ensure_tuple_or_list
+
+from google.cloud.datastore_v1.proto import entity_pb2
+from google.cloud.datastore_v1.proto import query_pb2
+from google.cloud.datastore import helpers
+from google.cloud.datastore.key import Key
+
+
+_NOT_FINISHED = query_pb2.QueryResultBatch.NOT_FINISHED
+_NO_MORE_RESULTS = query_pb2.QueryResultBatch.NO_MORE_RESULTS
+
+_FINISHED = (
+    _NO_MORE_RESULTS,
+    query_pb2.QueryResultBatch.MORE_RESULTS_AFTER_LIMIT,
+    query_pb2.QueryResultBatch.MORE_RESULTS_AFTER_CURSOR,
+)
+
+
+class Query(object):
+    """A Query against the Cloud Datastore.
+
+    This class serves as an abstraction for creating a query over data
+    stored in the Cloud Datastore.
+
+    :type client: :class:`google.cloud.datastore.client.Client`
+    :param client: The client used to connect to Datastore.
+
+    :type kind: str
+    :param kind: The kind to query.
+
+    :type project: str
+    :param project:
+        (Optional) The project associated with the query.  If not passed, uses
+        the client's value.
+
+    :type namespace: str
+    :param namespace:
+        (Optional) The namespace to which to restrict results.  If not passed,
+        uses the client's value.
+
+    :type ancestor: :class:`~google.cloud.datastore.key.Key`
+    :param ancestor:
+        (Optional) key of the ancestor to which this query's results are
+        restricted.
+
+    :type filters: tuple[str, str, str]
+    :param filters: Property filters applied by this query. The sequence
+        is ``(property_name, operator, value)``.
+
+    :type projection: sequence of string
+    :param projection:  fields returned as part of query results.
+
+    :type order: sequence of string
+    :param order:  field names used to order query results. Prepend ``-``
+                   to a field name to sort it in descending order.
+
+    :type distinct_on: sequence of string
+    :param distinct_on: field names used to group query results.
+
+    :raises: ValueError if ``project`` is not passed and no implicit
+             default is set.
+    """
+
+    OPERATORS = {
+        "<=": query_pb2.PropertyFilter.LESS_THAN_OR_EQUAL,
+        ">=": query_pb2.PropertyFilter.GREATER_THAN_OR_EQUAL,
+        "<": query_pb2.PropertyFilter.LESS_THAN,
+        ">": query_pb2.PropertyFilter.GREATER_THAN,
+        "=": query_pb2.PropertyFilter.EQUAL,
+    }
+    """Mapping of operator strings and their protobuf equivalents."""
+
+    def __init__(
+        self,
+        client,
+        kind=None,
+        project=None,
+        namespace=None,
+        ancestor=None,
+        filters=(),
+        projection=(),
+        order=(),
+        distinct_on=(),
+    ):
+
+        self._client = client
+        self._kind = kind
+        self._project = project or client.project
+        self._namespace = namespace or client.namespace
+        self._ancestor = ancestor
+        self._filters = []
+        # Verify filters passed in.
+        for property_name, operator, value in filters:
+            self.add_filter(property_name, operator, value)
+        self._projection = _ensure_tuple_or_list("projection", projection)
+        self._order = _ensure_tuple_or_list("order", order)
+        self._distinct_on = _ensure_tuple_or_list("distinct_on", distinct_on)
+
+    @property
+    def project(self):
+        """Get the project for this Query.
+
+        :rtype: str
+        :returns: The project for the query.
+        """
+        return self._project or self._client.project
+
+    @property
+    def namespace(self):
+        """This query's namespace
+
+        :rtype: str or None
+        :returns: the namespace assigned to this query
+        """
+        return self._namespace or self._client.namespace
+
+    @namespace.setter
+    def namespace(self, value):
+        """Update the query's namespace.
+
+        :type value: str
+        """
+        if not isinstance(value, str):
+            raise ValueError("Namespace must be a string")
+        self._namespace = value
+
+    @property
+    def kind(self):
+        """Get the Kind of the Query.
+
+        :rtype: str
+        :returns: The kind for the query.
+        """
+        return self._kind
+
+    @kind.setter
+    def kind(self, value):
+        """Update the Kind of the Query.
+
+        :type value: str
+        :param value: updated kind for the query.
+
+        .. note::
+
+           The protobuf specification allows for ``kind`` to be repeated,
+           but the current implementation returns an error if more than
+           one value is passed.  If the back-end changes in the future to
+           allow multiple values, this method will be updated to allow passing
+           either a string or a sequence of strings.
+        """
+        if not isinstance(value, str):
+            raise TypeError("Kind must be a string")
+        self._kind = value
+
+    @property
+    def ancestor(self):
+        """The ancestor key for the query.
+
+        :rtype: :class:`~google.cloud.datastore.key.Key` or None
+        :returns: The ancestor for the query.
+        """
+        return self._ancestor
+
+    @ancestor.setter
+    def ancestor(self, value):
+        """Set the ancestor for the query
+
+        :type value: :class:`~google.cloud.datastore.key.Key`
+        :param value: the new ancestor key
+        """
+        if not isinstance(value, Key):
+            raise TypeError("Ancestor must be a Key")
+        self._ancestor = value
+
+    @ancestor.deleter
+    def ancestor(self):
+        """Remove the ancestor for the query."""
+        self._ancestor = None
+
+    @property
+    def filters(self):
+        """Filters set on the query.
+
+        :rtype: tuple[str, str, str]
+        :returns: The filters set on the query. The sequence is
+            ``(property_name, operator, value)``.
+        """
+        return self._filters[:]
+
+    def add_filter(self, property_name, operator, value):
+        """Filter the query based on a property name, operator and a value.
+
+        Expressions take the form of::
+
+          .add_filter('<property>', '<operator>', <value>)
+
+        where property is a property stored on the entity in the datastore
+        and operator is one of ``OPERATORS``
+        (ie, ``=``, ``<``, ``<=``, ``>``, ``>=``)::
+
+          >>> from google.cloud import datastore
+          >>> client = datastore.Client()
+          >>> query = client.query(kind='Person')
+          >>> query.add_filter('name', '=', 'James')
+          >>> query.add_filter('age', '>', 50)
+
+        :type property_name: str
+        :param property_name: A property name.
+
+        :type operator: str
+        :param operator: One of ``=``, ``<``, ``<=``, ``>``, ``>=``.
+
+        :type value: :class:`int`, :class:`str`, :class:`bool`,
+                     :class:`float`, :class:`NoneType`,
+                     :class:`datetime.datetime`,
+                     :class:`google.cloud.datastore.key.Key`
+        :param value: The value to filter on.
+
+        :raises: :class:`ValueError` if ``operation`` is not one of the
+                 specified values, or if a filter names ``'__key__'`` but
+                 passes an invalid value (a key is required).
+        """
+        if self.OPERATORS.get(operator) is None:
+            error_message = 'Invalid expression: "%s"' % (operator,)
+            choices_message = "Please use one of: =, <, <=, >, >=."
+            raise ValueError(error_message, choices_message)
+
+        if property_name == "__key__" and not isinstance(value, Key):
+            raise ValueError('Invalid key: "%s"' % value)
+
+        self._filters.append((property_name, operator, value))
+
+    @property
+    def projection(self):
+        """Fields names returned by the query.
+
+        :rtype: sequence of string
+        :returns: Names of fields in query results.
+        """
+        return self._projection[:]
+
+    @projection.setter
+    def projection(self, projection):
+        """Set the fields returned the query.
+
+        :type projection: str or sequence of strings
+        :param projection: Each value is a string giving the name of a
+                           property to be included in the projection query.
+        """
+        if isinstance(projection, str):
+            projection = [projection]
+        self._projection[:] = projection
+
+    def keys_only(self):
+        """Set the projection to include only keys."""
+        self._projection[:] = ["__key__"]
+
+    def key_filter(self, key, operator="="):
+        """Filter on a key.
+
+        :type key: :class:`google.cloud.datastore.key.Key`
+        :param key: The key to filter on.
+
+        :type operator: str
+        :param operator: (Optional) One of ``=``, ``<``, ``<=``, ``>``, ``>=``.
+                         Defaults to ``=``.
+        """
+        self.add_filter("__key__", operator, key)
+
+    @property
+    def order(self):
+        """Names of fields used to sort query results.
+
+        :rtype: sequence of string
+        :returns: The order(s) set on the query.
+        """
+        return self._order[:]
+
+    @order.setter
+    def order(self, value):
+        """Set the fields used to sort query results.
+
+        Sort fields will be applied in the order specified.
+
+        :type value: str or sequence of strings
+        :param value: Each value is a string giving the name of the
+                      property on which to sort, optionally preceded by a
+                      hyphen (-) to specify descending order.
+                      Omitting the hyphen implies ascending order.
+        """
+        if isinstance(value, str):
+            value = [value]
+        self._order[:] = value
+
+    @property
+    def distinct_on(self):
+        """Names of fields used to group query results.
+
+        :rtype: sequence of string
+        :returns: The "distinct on" fields set on the query.
+        """
+        return self._distinct_on[:]
+
+    @distinct_on.setter
+    def distinct_on(self, value):
+        """Set fields used to group query results.
+
+        :type value: str or sequence of strings
+        :param value: Each value is a string giving the name of a
+                      property to use to group results together.
+        """
+        if isinstance(value, str):
+            value = [value]
+        self._distinct_on[:] = value
+
+    def fetch(
+        self,
+        limit=None,
+        offset=0,
+        start_cursor=None,
+        end_cursor=None,
+        client=None,
+        eventual=False,
+    ):
+        """Execute the Query; return an iterator for the matching entities.
+
+        For example::
+
+          >>> from google.cloud import datastore
+          >>> client = datastore.Client()
+          >>> query = client.query(kind='Person')
+          >>> query.add_filter('name', '=', 'Sally')
+          >>> list(query.fetch())
+          [<Entity object>, <Entity object>, ...]
+          >>> list(query.fetch(1))
+          [<Entity object>]
+
+        :type limit: int
+        :param limit: (Optional) limit passed through to the iterator.
+
+        :type offset: int
+        :param offset: (Optional) offset passed through to the iterator.
+
+        :type start_cursor: bytes
+        :param start_cursor: (Optional) cursor passed through to the iterator.
+
+        :type end_cursor: bytes
+        :param end_cursor: (Optional) cursor passed through to the iterator.
+
+        :type client: :class:`google.cloud.datastore.client.Client`
+        :param client: (Optional) client used to connect to datastore.
+                       If not supplied, uses the query's value.
+
+        :type eventual: bool
+        :param eventual: (Optional) Defaults to strongly consistent (False).
+                                    Setting True will use eventual consistency,
+                                    but cannot be used inside a transaction or
+                                    will raise ValueError.
+
+        :rtype: :class:`Iterator`
+        :returns: The iterator for the query.
+        """
+        if client is None:
+            client = self._client
+
+        return Iterator(
+            self,
+            client,
+            limit=limit,
+            offset=offset,
+            start_cursor=start_cursor,
+            end_cursor=end_cursor,
+            eventual=eventual,
+        )
+
+
+class Iterator(page_iterator.Iterator):
+    """Represent the state of a given execution of a Query.
+
+    :type query: :class:`~google.cloud.datastore.query.Query`
+    :param query: Query object holding permanent configuration (i.e.
+                  things that don't change on with each page in
+                  a results set).
+
+    :type client: :class:`~google.cloud.datastore.client.Client`
+    :param client: The client used to make a request.
+
+    :type limit: int
+    :param limit: (Optional) Limit the number of results returned.
+
+    :type offset: int
+    :param offset: (Optional) Offset used to begin a query.
+
+    :type start_cursor: bytes
+    :param start_cursor: (Optional) Cursor to begin paging through
+                         query results.
+
+    :type end_cursor: bytes
+    :param end_cursor: (Optional) Cursor to end paging through
+                       query results.
+
+    :type eventual: bool
+    :param eventual: (Optional) Defaults to strongly consistent (False).
+                                Setting True will use eventual consistency,
+                                but cannot be used inside a transaction or
+                                will raise ValueError.
+    """
+
+    next_page_token = None
+
+    def __init__(
+        self,
+        query,
+        client,
+        limit=None,
+        offset=None,
+        start_cursor=None,
+        end_cursor=None,
+        eventual=False,
+    ):
+        super(Iterator, self).__init__(
+            client=client,
+            item_to_value=_item_to_entity,
+            page_token=start_cursor,
+            max_results=limit,
+        )
+        self._query = query
+        self._offset = offset
+        self._end_cursor = end_cursor
+        self._eventual = eventual
+        # The attributes below will change over the life of the iterator.
+        self._more_results = True
+        self._skipped_results = 0
+
+    def _build_protobuf(self):
+        """Build a query protobuf.
+
+        Relies on the current state of the iterator.
+
+        :rtype:
+            :class:`.query_pb2.Query`
+        :returns: The query protobuf object for the current
+                  state of the iterator.
+        """
+        pb = _pb_from_query(self._query)
+
+        start_cursor = self.next_page_token
+        if start_cursor is not None:
+            pb.start_cursor = base64.urlsafe_b64decode(start_cursor)
+
+        end_cursor = self._end_cursor
+        if end_cursor is not None:
+            pb.end_cursor = base64.urlsafe_b64decode(end_cursor)
+
+        if self.max_results is not None:
+            pb.limit.value = self.max_results - self.num_results
+
+        if start_cursor is None and self._offset is not None:
+            # NOTE: We don't need to add an offset to the request protobuf
+            #       if we are using an existing cursor, because the offset
+            #       is only relative to the start of the result set, not
+            #       relative to each page (this method is called per-page)
+            pb.offset = self._offset
+
+        return pb
+
+    def _process_query_results(self, response_pb):
+        """Process the response from a datastore query.
+
+        :type response_pb: :class:`.datastore_pb2.RunQueryResponse`
+        :param response_pb: The protobuf response from a ``runQuery`` request.
+
+        :rtype: iterable
+        :returns: The next page of entity results.
+        :raises ValueError: If ``more_results`` is an unexpected value.
+        """
+        self._skipped_results = response_pb.batch.skipped_results
+
+        if response_pb.batch.more_results == _NO_MORE_RESULTS:
+            self.next_page_token = None
+        else:
+            self.next_page_token = base64.urlsafe_b64encode(
+                response_pb.batch.end_cursor
+            )
+        self._end_cursor = None
+
+        if response_pb.batch.more_results == _NOT_FINISHED:
+            self._more_results = True
+        elif response_pb.batch.more_results in _FINISHED:
+            self._more_results = False
+        else:
+            raise ValueError("Unexpected value returned for `more_results`.")
+
+        return [result.entity for result in response_pb.batch.entity_results]
+
+    def _next_page(self):
+        """Get the next page in the iterator.
+
+        :rtype: :class:`~google.cloud.iterator.Page`
+        :returns: The next page in the iterator (or :data:`None` if
+                  there are no pages left).
+        """
+        if not self._more_results:
+            return None
+
+        query_pb = self._build_protobuf()
+        transaction = self.client.current_transaction
+        if transaction is None:
+            transaction_id = None
+        else:
+            transaction_id = transaction.id
+        read_options = helpers.get_read_options(self._eventual, transaction_id)
+
+        partition_id = entity_pb2.PartitionId(
+            project_id=self._query.project, namespace_id=self._query.namespace
+        )
+        response_pb = self.client._datastore_api.run_query(
+            self._query.project, partition_id, read_options, query=query_pb
+        )
+        entity_pbs = self._process_query_results(response_pb)
+        return page_iterator.Page(self, entity_pbs, self.item_to_value)
+
+
+def _pb_from_query(query):
+    """Convert a Query instance to the corresponding protobuf.
+
+    :type query: :class:`Query`
+    :param query: The source query.
+
+    :rtype: :class:`.query_pb2.Query`
+    :returns: A protobuf that can be sent to the protobuf API.  N.b. that
+              it does not contain "in-flight" fields for ongoing query
+              executions (cursors, offset, limit).
+    """
+    pb = query_pb2.Query()
+
+    for projection_name in query.projection:
+        pb.projection.add().property.name = projection_name
+
+    if query.kind:
+        pb.kind.add().name = query.kind
+
+    composite_filter = pb.filter.composite_filter
+    composite_filter.op = query_pb2.CompositeFilter.AND
+
+    if query.ancestor:
+        ancestor_pb = query.ancestor.to_protobuf()
+
+        # Filter on __key__ HAS_ANCESTOR == ancestor.
+        ancestor_filter = composite_filter.filters.add().property_filter
+        ancestor_filter.property.name = "__key__"
+        ancestor_filter.op = query_pb2.PropertyFilter.HAS_ANCESTOR
+        ancestor_filter.value.key_value.CopyFrom(ancestor_pb)
+
+    for property_name, operator, value in query.filters:
+        pb_op_enum = query.OPERATORS.get(operator)
+
+        # Add the specific filter
+        property_filter = composite_filter.filters.add().property_filter
+        property_filter.property.name = property_name
+        property_filter.op = pb_op_enum
+
+        # Set the value to filter on based on the type.
+        if property_name == "__key__":
+            key_pb = value.to_protobuf()
+            property_filter.value.key_value.CopyFrom(key_pb)
+        else:
+            helpers._set_protobuf_value(property_filter.value, value)
+
+    if not composite_filter.filters:
+        pb.ClearField("filter")
+
+    for prop in query.order:
+        property_order = pb.order.add()
+
+        if prop.startswith("-"):
+            property_order.property.name = prop[1:]
+            property_order.direction = property_order.DESCENDING
+        else:
+            property_order.property.name = prop
+            property_order.direction = property_order.ASCENDING
+
+    for distinct_on_name in query.distinct_on:
+        pb.distinct_on.add().name = distinct_on_name
+
+    return pb
+
+
+# pylint: disable=unused-argument
+def _item_to_entity(iterator, entity_pb):
+    """Convert a raw protobuf entity to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type entity_pb:
+        :class:`.entity_pb2.Entity`
+    :param entity_pb: An entity protobuf to convert to a native entity.
+
+    :rtype: :class:`~google.cloud.datastore.entity.Entity`
+    :returns: The next entity in the page.
+    """
+    return helpers.entity_from_protobuf(entity_pb)
+
+
+# pylint: enable=unused-argument
diff --git a/datastore/google/cloud/datastore/transaction.py b/datastore/google/cloud/datastore/transaction.py
new file mode 100644
index 000000000000..ccff5561c644
--- /dev/null
+++ b/datastore/google/cloud/datastore/transaction.py
@@ -0,0 +1,262 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Datastore transactions."""
+
+from google.cloud.datastore.batch import Batch
+from google.cloud.datastore_v1.types import TransactionOptions
+
+
+class Transaction(Batch):
+    """An abstraction representing datastore Transactions.
+
+    Transactions can be used to build up a bulk mutation and ensure all
+    or none succeed (transactionally).
+
+    For example, the following snippet of code will put the two ``save``
+    operations (either ``insert`` or ``upsert``) into the same
+    mutation, and execute those within a transaction:
+
+    .. testsetup:: txn-put-multi, txn-api
+
+        import os
+        import uuid
+
+        from google.cloud import datastore
+        from tests.system.test_system import Config  # system tests
+
+        unique = os.getenv('CIRCLE_BUILD_NUM', str(uuid.uuid4())[0:8])
+        client = datastore.Client(namespace='ns{}'.format(unique))
+        key1 = client.key('_Doctest')
+        entity1 = datastore.Entity(key=key1)
+        entity1['foo'] = 1337
+
+        key2 = client.key('_Doctest', 'abcd1234')
+        entity2 = datastore.Entity(key=key2)
+        entity2['foo'] = 42
+
+        Config.TO_DELETE.extend([entity1, entity2])
+
+    .. doctest:: txn-put-multi
+
+        >>> with client.transaction():
+        ...     client.put_multi([entity1, entity2])
+
+    Because it derives from :class:`~google.cloud.datastore.batch.Batch`,
+    :class:`Transaction` also provides :meth:`put` and :meth:`delete` methods:
+
+    .. doctest:: txn-api
+
+       >>> with client.transaction() as xact:
+       ...     xact.put(entity1)
+       ...     xact.delete(entity2.key)
+
+    By default, the transaction is rolled back if the transaction block
+    exits with an error:
+
+    .. testsetup:: txn-error
+
+        import os
+        import uuid
+
+        from google.cloud import datastore
+
+        unique = os.getenv('CIRCLE_BUILD_NUM', str(uuid.uuid4())[0:8])
+        client = datastore.Client(namespace='ns{}'.format(unique))
+
+        def do_some_work():
+            return
+
+        class SomeException(Exception):
+            pass
+
+    .. doctest:: txn-error
+
+        >>> with client.transaction():
+        ...     do_some_work()
+        ...     raise SomeException  # rolls back
+        Traceback (most recent call last):
+          ...
+        SomeException
+
+    If the transaction block exits without an exception, it will commit
+    by default.
+
+    .. warning::
+
+        Inside a transaction, automatically assigned IDs for
+        entities will not be available at save time!  That means, if you
+        try:
+
+        .. testsetup:: txn-entity-key, txn-entity-key-after, txn-manual
+
+            import os
+            import uuid
+
+            from google.cloud import datastore
+            from tests.system.test_system import Config  # system tests
+
+            unique = os.getenv('CIRCLE_BUILD_NUM', str(uuid.uuid4())[0:8])
+            client = datastore.Client(namespace='ns{}'.format(unique))
+
+            def Entity(*args, **kwargs):
+                entity = datastore.Entity(*args, **kwargs)
+                Config.TO_DELETE.append(entity)
+                return entity
+
+        .. doctest:: txn-entity-key
+
+            >>> with client.transaction():
+            ...     entity = Entity(key=client.key('Thing'))
+            ...     client.put(entity)
+
+       ``entity`` won't have a complete key until the transaction is
+       committed.
+
+       Once you exit the transaction (or call :meth:`commit`), the
+       automatically generated ID will be assigned to the entity:
+
+       .. doctest:: txn-entity-key-after
+
+          >>> with client.transaction():
+          ...     entity = Entity(key=client.key('Thing'))
+          ...     client.put(entity)
+          ...     print(entity.key.is_partial)  # There is no ID on this key.
+          ...
+          True
+          >>> print(entity.key.is_partial)  # There *is* an ID.
+          False
+
+    If you don't want to use the context manager you can initialize a
+    transaction manually:
+
+    .. doctest:: txn-manual
+
+       >>> transaction = client.transaction()
+       >>> transaction.begin()
+       >>>
+       >>> entity = Entity(key=client.key('Thing'))
+       >>> transaction.put(entity)
+       >>>
+       >>> transaction.commit()
+
+    :type client: :class:`google.cloud.datastore.client.Client`
+    :param client: the client used to connect to datastore.
+
+    :type read_only: bool
+    :param read_only: indicates the transaction is read only.
+    """
+
+    _status = None
+
+    def __init__(self, client, read_only=False):
+        super(Transaction, self).__init__(client)
+        self._id = None
+        if read_only:
+            options = TransactionOptions(read_only=TransactionOptions.ReadOnly())
+        else:
+            options = TransactionOptions()
+        self._options = options
+
+    @property
+    def id(self):
+        """Getter for the transaction ID.
+
+        :rtype: str
+        :returns: The ID of the current transaction.
+        """
+        return self._id
+
+    def current(self):
+        """Return the topmost transaction.
+
+        .. note::
+
+            If the topmost element on the stack is not a transaction,
+            returns None.
+
+        :rtype: :class:`google.cloud.datastore.transaction.Transaction` or None
+        :returns: The current transaction (if any are active).
+        """
+        top = super(Transaction, self).current()
+        if isinstance(top, Transaction):
+            return top
+
+    def begin(self):
+        """Begins a transaction.
+
+        This method is called automatically when entering a with
+        statement, however it can be called explicitly if you don't want
+        to use a context manager.
+
+        :raises: :class:`~exceptions.ValueError` if the transaction has
+                 already begun.
+        """
+        super(Transaction, self).begin()
+        try:
+            response_pb = self._client._datastore_api.begin_transaction(self.project)
+            self._id = response_pb.transaction
+        except:  # noqa: E722 do not use bare except, specify exception instead
+            self._status = self._ABORTED
+            raise
+
+    def rollback(self):
+        """Rolls back the current transaction.
+
+        This method has necessary side-effects:
+
+        - Sets the current transaction's ID to None.
+        """
+        try:
+            # No need to use the response it contains nothing.
+            self._client._datastore_api.rollback(self.project, self._id)
+        finally:
+            super(Transaction, self).rollback()
+            # Clear our own ID in case this gets accidentally reused.
+            self._id = None
+
+    def commit(self):
+        """Commits the transaction.
+
+        This is called automatically upon exiting a with statement,
+        however it can be called explicitly if you don't want to use a
+        context manager.
+
+        This method has necessary side-effects:
+
+        - Sets the current transaction's ID to None.
+        """
+        try:
+            super(Transaction, self).commit()
+        finally:
+            # Clear our own ID in case this gets accidentally reused.
+            self._id = None
+
+    def put(self, entity):
+        """Adds an entity to be committed.
+
+        Ensures the transaction is not marked readonly.
+        Please see documentation at
+        :meth:`~google.cloud.datastore.batch.Batch.put`
+
+        :type entity: :class:`~google.cloud.datastore.entity.Entity`
+        :param entity: the entity to be saved.
+
+        :raises: :class:`RuntimeError` if the transaction
+                 is marked ReadOnly
+        """
+        if self._options.HasField("read_only"):
+            raise RuntimeError("Transaction is read only")
+        else:
+            super(Transaction, self).put(entity)
diff --git a/datastore/google/cloud/datastore_v1/__init__.py b/datastore/google/cloud/datastore_v1/__init__.py
new file mode 100644
index 000000000000..0308f10c0a6a
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/__init__.py
@@ -0,0 +1,27 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.datastore_v1 import types
+from google.cloud.datastore_v1.gapic import datastore_client
+from google.cloud.datastore_v1.gapic import enums
+
+
+class DatastoreClient(datastore_client.DatastoreClient):
+    __doc__ = datastore_client.DatastoreClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DatastoreClient")
diff --git a/datastore/google/cloud/datastore_v1/gapic/__init__.py b/datastore/google/cloud/datastore_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datastore/google/cloud/datastore_v1/gapic/datastore_client.py b/datastore/google/cloud/datastore_v1/gapic/datastore_client.py
new file mode 100644
index 000000000000..12958c41a487
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/gapic/datastore_client.py
@@ -0,0 +1,814 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.datastore.v1 Datastore API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.datastore_v1.gapic import datastore_client_config
+from google.cloud.datastore_v1.gapic import enums
+from google.cloud.datastore_v1.gapic.transports import datastore_grpc_transport
+from google.cloud.datastore_v1.proto import datastore_pb2
+from google.cloud.datastore_v1.proto import datastore_pb2_grpc
+from google.cloud.datastore_v1.proto import entity_pb2
+from google.cloud.datastore_v1.proto import query_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-datastore"
+).version
+
+
+class DatastoreClient(object):
+    """
+    Each RPC normalizes the partition IDs of the keys in its input entities,
+    and always returns entities with keys with normalized partition IDs.
+    This applies to all keys and entities, including those in values, except keys
+    with both an empty path and an empty or unset partition ID. Normalization of
+    input keys sets the project ID (if not already set) to the project ID from
+    the request.
+    """
+
+    SERVICE_ADDRESS = "datastore.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.datastore.v1.Datastore"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DatastoreClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DatastoreGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DatastoreGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = datastore_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=datastore_grpc_transport.DatastoreGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = datastore_grpc_transport.DatastoreGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def lookup(
+        self,
+        project_id,
+        keys,
+        read_options=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Looks up entities by key.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `keys`:
+            >>> keys = []
+            >>>
+            >>> response = client.lookup(project_id, keys)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            keys (list[Union[dict, ~google.cloud.datastore_v1.types.Key]]): Keys of entities to look up.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.Key`
+            read_options (Union[dict, ~google.cloud.datastore_v1.types.ReadOptions]): The options for this lookup request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.ReadOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.LookupResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "lookup" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "lookup"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.lookup,
+                default_retry=self._method_configs["Lookup"].retry,
+                default_timeout=self._method_configs["Lookup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datastore_pb2.LookupRequest(
+            project_id=project_id, keys=keys, read_options=read_options
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["lookup"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_query(
+        self,
+        project_id,
+        partition_id,
+        read_options=None,
+        query=None,
+        gql_query=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Queries for entities.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `partition_id`:
+            >>> partition_id = {}
+            >>>
+            >>> response = client.run_query(project_id, partition_id)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            partition_id (Union[dict, ~google.cloud.datastore_v1.types.PartitionId]): Entities are partitioned into subsets, identified by a partition ID.
+                Queries are scoped to a single partition.
+                This partition ID is normalized with the standard default context
+                partition ID.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.PartitionId`
+            read_options (Union[dict, ~google.cloud.datastore_v1.types.ReadOptions]): The options for this query.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.ReadOptions`
+            query (Union[dict, ~google.cloud.datastore_v1.types.Query]): The query to run.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.Query`
+            gql_query (Union[dict, ~google.cloud.datastore_v1.types.GqlQuery]): The GQL query to run.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.GqlQuery`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.RunQueryResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_query" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_query"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_query,
+                default_retry=self._method_configs["RunQuery"].retry,
+                default_timeout=self._method_configs["RunQuery"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(query=query, gql_query=gql_query)
+
+        request = datastore_pb2.RunQueryRequest(
+            project_id=project_id,
+            partition_id=partition_id,
+            read_options=read_options,
+            query=query,
+            gql_query=gql_query,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_query"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def begin_transaction(
+        self,
+        project_id,
+        transaction_options=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Begins a new transaction.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> response = client.begin_transaction(project_id)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            transaction_options (Union[dict, ~google.cloud.datastore_v1.types.TransactionOptions]): Options for a new transaction.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.TransactionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.BeginTransactionResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "begin_transaction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "begin_transaction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.begin_transaction,
+                default_retry=self._method_configs["BeginTransaction"].retry,
+                default_timeout=self._method_configs["BeginTransaction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datastore_pb2.BeginTransactionRequest(
+            project_id=project_id, transaction_options=transaction_options
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["begin_transaction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def commit(
+        self,
+        project_id,
+        mode,
+        mutations,
+        transaction=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Commits a transaction, optionally creating, deleting or modifying some
+        entities.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>> from google.cloud.datastore_v1 import enums
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `mode`:
+            >>> mode = enums.CommitRequest.Mode.MODE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `mutations`:
+            >>> mutations = []
+            >>>
+            >>> response = client.commit(project_id, mode, mutations)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            mode (~google.cloud.datastore_v1.types.Mode): The type of commit to perform. Defaults to ``TRANSACTIONAL``.
+            mutations (list[Union[dict, ~google.cloud.datastore_v1.types.Mutation]]): The mutations to perform.
+
+                When mode is ``TRANSACTIONAL``, mutations affecting a single entity are
+                applied in order. The following sequences of mutations affecting a
+                single entity are not permitted in a single ``Commit`` request:
+
+                -  ``insert`` followed by ``insert``
+                -  ``update`` followed by ``insert``
+                -  ``upsert`` followed by ``insert``
+                -  ``delete`` followed by ``update``
+
+                When mode is ``NON_TRANSACTIONAL``, no two mutations may affect a single
+                entity.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.Mutation`
+            transaction (bytes): The identifier of the transaction associated with the commit. A
+                transaction identifier is returned by a call to
+                ``Datastore.BeginTransaction``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.CommitResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "commit" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "commit"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.commit,
+                default_retry=self._method_configs["Commit"].retry,
+                default_timeout=self._method_configs["Commit"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(transaction=transaction)
+
+        request = datastore_pb2.CommitRequest(
+            project_id=project_id,
+            mode=mode,
+            mutations=mutations,
+            transaction=transaction,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["commit"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rollback(
+        self,
+        project_id,
+        transaction,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Rolls back a transaction.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `transaction`:
+            >>> transaction = b''
+            >>>
+            >>> response = client.rollback(project_id, transaction)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            transaction (bytes): The transaction identifier, returned by a call to
+                ``Datastore.BeginTransaction``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.RollbackResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rollback" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rollback"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rollback,
+                default_retry=self._method_configs["Rollback"].retry,
+                default_timeout=self._method_configs["Rollback"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datastore_pb2.RollbackRequest(
+            project_id=project_id, transaction=transaction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["rollback"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def allocate_ids(
+        self,
+        project_id,
+        keys,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Allocates IDs for the given keys, which is useful for referencing an entity
+        before it is inserted.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `keys`:
+            >>> keys = []
+            >>>
+            >>> response = client.allocate_ids(project_id, keys)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            keys (list[Union[dict, ~google.cloud.datastore_v1.types.Key]]): A list of keys with incomplete key paths for which to allocate IDs.
+                No key may be reserved/read-only.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.Key`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.AllocateIdsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "allocate_ids" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "allocate_ids"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.allocate_ids,
+                default_retry=self._method_configs["AllocateIds"].retry,
+                default_timeout=self._method_configs["AllocateIds"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datastore_pb2.AllocateIdsRequest(project_id=project_id, keys=keys)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["allocate_ids"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def reserve_ids(
+        self,
+        project_id,
+        keys,
+        database_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Prevents the supplied keys' IDs from being auto-allocated by Cloud
+        Datastore.
+
+        Example:
+            >>> from google.cloud import datastore_v1
+            >>>
+            >>> client = datastore_v1.DatastoreClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `keys`:
+            >>> keys = []
+            >>>
+            >>> response = client.reserve_ids(project_id, keys)
+
+        Args:
+            project_id (str): The ID of the project against which to make the request.
+            keys (list[Union[dict, ~google.cloud.datastore_v1.types.Key]]): A list of keys with complete key paths whose numeric IDs should not be
+                auto-allocated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.datastore_v1.types.Key`
+            database_id (str): If not empty, the ID of the database against which to make the request.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.datastore_v1.types.ReserveIdsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "reserve_ids" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "reserve_ids"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.reserve_ids,
+                default_retry=self._method_configs["ReserveIds"].retry,
+                default_timeout=self._method_configs["ReserveIds"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = datastore_pb2.ReserveIdsRequest(
+            project_id=project_id, keys=keys, database_id=database_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["reserve_ids"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/datastore/google/cloud/datastore_v1/gapic/datastore_client_config.py b/datastore/google/cloud/datastore_v1/gapic/datastore_client_config.py
new file mode 100644
index 000000000000..95822b8babfc
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/gapic/datastore_client_config.py
@@ -0,0 +1,58 @@
+config = {
+    "interfaces": {
+        "google.datastore.v1.Datastore": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "Lookup": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunQuery": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BeginTransaction": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Commit": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Rollback": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "AllocateIds": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ReserveIds": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/datastore/google/cloud/datastore_v1/gapic/enums.py b/datastore/google/cloud/datastore_v1/gapic/enums.py
new file mode 100644
index 000000000000..b56d0fd39269
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/gapic/enums.py
@@ -0,0 +1,165 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class CommitRequest(object):
+    class Mode(enum.IntEnum):
+        """
+        The modes available for commits.
+
+        Attributes:
+          MODE_UNSPECIFIED (int): Unspecified. This value must not be used.
+          TRANSACTIONAL (int): Transactional: The mutations are either all applied, or none are
+          applied. Learn about transactions
+          `here <https://cloud.google.com/datastore/docs/concepts/transactions>`__.
+          NON_TRANSACTIONAL (int): Non-transactional: The mutations may not apply as all or none.
+        """
+
+        MODE_UNSPECIFIED = 0
+        TRANSACTIONAL = 1
+        NON_TRANSACTIONAL = 2
+
+
+class CompositeFilter(object):
+    class Operator(enum.IntEnum):
+        """
+        A composite filter operator.
+
+        Attributes:
+          OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+          AND (int): The results are required to satisfy each of the combined filters.
+        """
+
+        OPERATOR_UNSPECIFIED = 0
+        AND = 1
+
+
+class EntityResult(object):
+    class ResultType(enum.IntEnum):
+        """
+        Specifies what data the 'entity' field contains. A ``ResultType`` is
+        either implied (for example, in ``LookupResponse.missing`` from
+        ``datastore.proto``, it is always ``KEY_ONLY``) or specified by context
+        (for example, in message ``QueryResultBatch``, field
+        ``entity_result_type`` specifies a ``ResultType`` for all the values in
+        field ``entity_results``).
+
+        Attributes:
+          RESULT_TYPE_UNSPECIFIED (int): Unspecified. This value is never used.
+          FULL (int): The key and properties.
+          PROJECTION (int): A projected subset of properties. The entity may have no key.
+          KEY_ONLY (int): Only the key.
+        """
+
+        RESULT_TYPE_UNSPECIFIED = 0
+        FULL = 1
+        PROJECTION = 2
+        KEY_ONLY = 3
+
+
+class PropertyFilter(object):
+    class Operator(enum.IntEnum):
+        """
+        A property filter operator.
+
+        Attributes:
+          OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+          LESS_THAN (int): Less than.
+          LESS_THAN_OR_EQUAL (int): Less than or equal.
+          GREATER_THAN (int): Greater than.
+          GREATER_THAN_OR_EQUAL (int): Greater than or equal.
+          EQUAL (int): Equal.
+          HAS_ANCESTOR (int): Has ancestor.
+        """
+
+        OPERATOR_UNSPECIFIED = 0
+        LESS_THAN = 1
+        LESS_THAN_OR_EQUAL = 2
+        GREATER_THAN = 3
+        GREATER_THAN_OR_EQUAL = 4
+        EQUAL = 5
+        HAS_ANCESTOR = 11
+
+
+class PropertyOrder(object):
+    class Direction(enum.IntEnum):
+        """
+        The sort direction.
+
+        Attributes:
+          DIRECTION_UNSPECIFIED (int): Unspecified. This value must not be used.
+          ASCENDING (int): Ascending.
+          DESCENDING (int): Descending.
+        """
+
+        DIRECTION_UNSPECIFIED = 0
+        ASCENDING = 1
+        DESCENDING = 2
+
+
+class QueryResultBatch(object):
+    class MoreResultsType(enum.IntEnum):
+        """
+        The possible values for the ``more_results`` field.
+
+        Attributes:
+          MORE_RESULTS_TYPE_UNSPECIFIED (int): Unspecified. This value is never used.
+          NOT_FINISHED (int): There may be additional batches to fetch from this query.
+          MORE_RESULTS_AFTER_LIMIT (int): The query is finished, but there may be more results after the limit.
+          MORE_RESULTS_AFTER_CURSOR (int): The query is finished, but there may be more results after the end
+          cursor.
+          NO_MORE_RESULTS (int): The query is finished, and there are no more results.
+        """
+
+        MORE_RESULTS_TYPE_UNSPECIFIED = 0
+        NOT_FINISHED = 1
+        MORE_RESULTS_AFTER_LIMIT = 2
+        MORE_RESULTS_AFTER_CURSOR = 4
+        NO_MORE_RESULTS = 3
+
+
+class ReadOptions(object):
+    class ReadConsistency(enum.IntEnum):
+        """
+        The possible values for read consistencies.
+
+        Attributes:
+          READ_CONSISTENCY_UNSPECIFIED (int): Unspecified. This value must not be used.
+          STRONG (int): Strong consistency.
+          EVENTUAL (int): Eventual consistency.
+        """
+
+        READ_CONSISTENCY_UNSPECIFIED = 0
+        STRONG = 1
+        EVENTUAL = 2
diff --git a/datastore/google/cloud/datastore_v1/gapic/transports/__init__.py b/datastore/google/cloud/datastore_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datastore/google/cloud/datastore_v1/gapic/transports/datastore_grpc_transport.py b/datastore/google/cloud/datastore_v1/gapic/transports/datastore_grpc_transport.py
new file mode 100644
index 000000000000..c7c640c472e1
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/gapic/transports/datastore_grpc_transport.py
@@ -0,0 +1,203 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.datastore_v1.proto import datastore_pb2_grpc
+
+
+class DatastoreGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.datastore.v1 Datastore API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/datastore",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="datastore.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"datastore_stub": datastore_pb2_grpc.DatastoreStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="datastore.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def lookup(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.lookup`.
+
+        Looks up entities by key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].Lookup
+
+    @property
+    def run_query(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.run_query`.
+
+        Queries for entities.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].RunQuery
+
+    @property
+    def begin_transaction(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.begin_transaction`.
+
+        Begins a new transaction.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].BeginTransaction
+
+    @property
+    def commit(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.commit`.
+
+        Commits a transaction, optionally creating, deleting or modifying some
+        entities.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].Commit
+
+    @property
+    def rollback(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.rollback`.
+
+        Rolls back a transaction.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].Rollback
+
+    @property
+    def allocate_ids(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.allocate_ids`.
+
+        Allocates IDs for the given keys, which is useful for referencing an entity
+        before it is inserted.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].AllocateIds
+
+    @property
+    def reserve_ids(self):
+        """Return the gRPC stub for :meth:`DatastoreClient.reserve_ids`.
+
+        Prevents the supplied keys' IDs from being auto-allocated by Cloud
+        Datastore.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["datastore_stub"].ReserveIds
diff --git a/datastore/google/cloud/datastore_v1/proto/__init__.py b/datastore/google/cloud/datastore_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datastore/google/cloud/datastore_v1/proto/datastore.proto b/datastore/google/cloud/datastore_v1/proto/datastore.proto
new file mode 100644
index 000000000000..51d69acb9db8
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/datastore.proto
@@ -0,0 +1,400 @@
+// 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.datastore.v1;
+
+import "google/api/annotations.proto";
+import "google/datastore/v1/entity.proto";
+import "google/datastore/v1/query.proto";
+
+option csharp_namespace = "Google.Cloud.Datastore.V1";
+option go_package = "google.golang.org/genproto/googleapis/datastore/v1;datastore";
+option java_multiple_files = true;
+option java_outer_classname = "DatastoreProto";
+option java_package = "com.google.datastore.v1";
+option php_namespace = "Google\\Cloud\\Datastore\\V1";
+
+// Each RPC normalizes the partition IDs of the keys in its input entities,
+// and always returns entities with keys with normalized partition IDs.
+// This applies to all keys and entities, including those in values, except keys
+// with both an empty path and an empty or unset partition ID. Normalization of
+// input keys sets the project ID (if not already set) to the project ID from
+// the request.
+//
+service Datastore {
+  // Looks up entities by key.
+  rpc Lookup(LookupRequest) returns (LookupResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:lookup"
+      body: "*"
+    };
+  }
+
+  // Queries for entities.
+  rpc RunQuery(RunQueryRequest) returns (RunQueryResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:runQuery"
+      body: "*"
+    };
+  }
+
+  // Begins a new transaction.
+  rpc BeginTransaction(BeginTransactionRequest)
+      returns (BeginTransactionResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:beginTransaction"
+      body: "*"
+    };
+  }
+
+  // Commits a transaction, optionally creating, deleting or modifying some
+  // entities.
+  rpc Commit(CommitRequest) returns (CommitResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:commit"
+      body: "*"
+    };
+  }
+
+  // Rolls back a transaction.
+  rpc Rollback(RollbackRequest) returns (RollbackResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:rollback"
+      body: "*"
+    };
+  }
+
+  // Allocates IDs for the given keys, which is useful for referencing an entity
+  // before it is inserted.
+  rpc AllocateIds(AllocateIdsRequest) returns (AllocateIdsResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:allocateIds"
+      body: "*"
+    };
+  }
+
+  // Prevents the supplied keys' IDs from being auto-allocated by Cloud
+  // Datastore.
+  rpc ReserveIds(ReserveIdsRequest) returns (ReserveIdsResponse) {
+    option (google.api.http) = {
+      post: "/v1/projects/{project_id}:reserveIds"
+      body: "*"
+    };
+  }
+}
+
+// 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;
+
+  // The options for this lookup request.
+  ReadOptions read_options = 1;
+
+  // Keys of entities to look up.
+  repeated Key keys = 3;
+}
+
+// The response for [Datastore.Lookup][google.datastore.v1.Datastore.Lookup].
+message LookupResponse {
+  // Entities found as `ResultType.FULL` entities. The order of results in this
+  // field is undefined and has no relation to the order of the keys in the
+  // input.
+  repeated EntityResult found = 1;
+
+  // Entities not found as `ResultType.KEY_ONLY` entities. The order of results
+  // in this field is undefined and has no relation to the order of the keys
+  // in the input.
+  repeated EntityResult missing = 2;
+
+  // A list of keys that were not looked up due to resource constraints. The
+  // order of results in this field is undefined and has no relation to the
+  // order of the keys in the input.
+  repeated Key deferred = 3;
+}
+
+// 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;
+
+  // Entities are partitioned into subsets, identified by a partition ID.
+  // Queries are scoped to a single partition.
+  // This partition ID is normalized with the standard default context
+  // partition ID.
+  PartitionId partition_id = 2;
+
+  // The options for this query.
+  ReadOptions read_options = 1;
+
+  // The type of query.
+  oneof query_type {
+    // The query to run.
+    Query query = 3;
+
+    // The GQL query to run.
+    GqlQuery gql_query = 7;
+  }
+}
+
+// The response for
+// [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
+message RunQueryResponse {
+  // A batch of query results (always present).
+  QueryResultBatch batch = 1;
+
+  // The parsed form of the `GqlQuery` from the request, if it was set.
+  Query query = 2;
+}
+
+// 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;
+
+  // Options for a new transaction.
+  TransactionOptions transaction_options = 10;
+}
+
+// The response for
+// [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+message BeginTransactionResponse {
+  // The transaction identifier (always present).
+  bytes transaction = 1;
+}
+
+// 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;
+
+  // The transaction identifier, returned by a call to
+  // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+  bytes transaction = 1;
+}
+
+// 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 {
+  // The modes available for commits.
+  enum Mode {
+    // Unspecified. This value must not be used.
+    MODE_UNSPECIFIED = 0;
+
+    // Transactional: The mutations are either all applied, or none are applied.
+    // Learn about transactions
+    // [here](https://cloud.google.com/datastore/docs/concepts/transactions).
+    TRANSACTIONAL = 1;
+
+    // Non-transactional: The mutations may not apply as all or none.
+    NON_TRANSACTIONAL = 2;
+  }
+
+  // The ID of the project against which to make the request.
+  string project_id = 8;
+
+  // The type of commit to perform. Defaults to `TRANSACTIONAL`.
+  Mode mode = 5;
+
+  // Must be set when mode is `TRANSACTIONAL`.
+  oneof transaction_selector {
+    // The identifier of the transaction associated with the commit. A
+    // transaction identifier is returned by a call to
+    // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+    bytes transaction = 1;
+  }
+
+  // The mutations to perform.
+  //
+  // When mode is `TRANSACTIONAL`, mutations affecting a single entity are
+  // applied in order. The following sequences of mutations affecting a single
+  // entity are not permitted in a single `Commit` request:
+  //
+  // - `insert` followed by `insert`
+  // - `update` followed by `insert`
+  // - `upsert` followed by `insert`
+  // - `delete` followed by `update`
+  //
+  // When mode is `NON_TRANSACTIONAL`, no two mutations may affect a single
+  // entity.
+  repeated Mutation mutations = 6;
+}
+
+// The response for [Datastore.Commit][google.datastore.v1.Datastore.Commit].
+message CommitResponse {
+  // The result of performing the mutations.
+  // The i-th mutation result corresponds to the i-th mutation in the request.
+  repeated MutationResult mutation_results = 3;
+
+  // The number of index entries updated during the commit, or zero if none were
+  // updated.
+  int32 index_updates = 4;
+}
+
+// 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;
+
+  // A list of keys with incomplete key paths for which to allocate IDs.
+  // No key may be reserved/read-only.
+  repeated Key keys = 1;
+}
+
+// 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].
+message ReserveIdsRequest {
+  // The ID of the project against which to make the request.
+  string project_id = 8;
+
+  // 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
+  // auto-allocated.
+  repeated Key keys = 1;
+}
+
+// The response for
+// [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
+message ReserveIdsResponse {}
+
+// A mutation to apply to an entity.
+message Mutation {
+  // The mutation operation.
+  //
+  // For `insert`, `update`, and `upsert`:
+  // - The entity's key must not be reserved/read-only.
+  // - No property in the entity may have a reserved name,
+  //   not even a property in an entity in a value.
+  // - No value in the entity may have meaning 18,
+  //   not even a value in an entity in another value.
+  oneof operation {
+    // The entity to insert. The entity must not already exist.
+    // The entity key's final path element may be incomplete.
+    Entity insert = 4;
+
+    // The entity to update. The entity must already exist.
+    // Must have a complete key path.
+    Entity update = 5;
+
+    // The entity to upsert. The entity may or may not already exist.
+    // The entity key's final path element may be incomplete.
+    Entity upsert = 6;
+
+    // The key of the entity to delete. The entity may or may not already exist.
+    // Must have a complete key path and must not be reserved/read-only.
+    Key delete = 7;
+  }
+
+  // When set, the server will detect whether or not this mutation conflicts
+  // with the current version of the entity on the server. Conflicting mutations
+  // are not applied, and are marked as such in MutationResult.
+  oneof conflict_detection_strategy {
+    // The version of the entity that this mutation is being applied to. If this
+    // does not match the current version on the server, the mutation conflicts.
+    int64 base_version = 8;
+  }
+}
+
+// The result of applying a mutation.
+message MutationResult {
+  // The automatically allocated key.
+  // Set only when the mutation allocated a key.
+  Key key = 3;
+
+  // The version of the entity on the server after processing the mutation. If
+  // the mutation doesn't change anything on the server, then the version will
+  // be the version of the current entity or, if no entity is present, a version
+  // that is strictly greater than the version of any previous entity and less
+  // than the version of any possible future entity.
+  int64 version = 4;
+
+  // Whether a conflict was detected for this mutation. Always false when a
+  // conflict detection strategy field is not set in the mutation.
+  bool conflict_detected = 5;
+}
+
+// The options shared by read requests.
+message ReadOptions {
+  // The possible values for read consistencies.
+  enum ReadConsistency {
+    // Unspecified. This value must not be used.
+    READ_CONSISTENCY_UNSPECIFIED = 0;
+
+    // Strong consistency.
+    STRONG = 1;
+
+    // Eventual consistency.
+    EVENTUAL = 2;
+  }
+
+  // If not specified, lookups and ancestor queries default to
+  // `read_consistency`=`STRONG`, global queries default to
+  // `read_consistency`=`EVENTUAL`.
+  oneof consistency_type {
+    // The non-transactional read consistency to use.
+    // Cannot be set to `STRONG` for global queries.
+    ReadConsistency read_consistency = 1;
+
+    // The identifier of the transaction in which to read. A
+    // transaction identifier is returned by a call to
+    // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+    bytes transaction = 2;
+  }
+}
+
+// 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.
+message TransactionOptions {
+  // Options specific to read / write transactions.
+  message ReadWrite {
+    // The transaction identifier of the transaction being retried.
+    bytes previous_transaction = 1;
+  }
+
+  // Options specific to read-only transactions.
+  message ReadOnly {}
+
+  // The `mode` of the transaction, indicating whether write operations are
+  // supported.
+  oneof mode {
+    // The transaction should allow both reads and writes.
+    ReadWrite read_write = 1;
+
+    // The transaction should only allow reads.
+    ReadOnly read_only = 2;
+  }
+}
diff --git a/datastore/google/cloud/datastore_v1/proto/datastore_admin.proto b/datastore/google/cloud/datastore_v1/proto/datastore_admin.proto
new file mode 100644
index 000000000000..c730de79c0f3
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/datastore_admin.proto
@@ -0,0 +1,329 @@
+// 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.datastore.admin.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Datastore.Admin.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/datastore/admin/v1beta1;admin";
+option java_multiple_files = true;
+option java_outer_classname = "DatastoreAdminProto";
+option java_package = "com.google.datastore.admin.v1beta1";
+
+
+// Google Cloud Datastore Admin API
+//
+// The Datastore Admin API provides several admin services for Cloud Datastore.
+//
+// -----------------------------------------------------------------------------
+// ## Concepts
+//
+// Project, namespace, kind, and entity as defined in the Google Cloud Datastore
+// API.
+//
+// Operation: An Operation represents work being performed in the background.
+//
+// EntityFilter: Allows specifying a subset of entities in a project. This is
+// specified as a combination of kinds and namespaces (either or both of which
+// may be all).
+//
+// -----------------------------------------------------------------------------
+// ## Services
+//
+// # Export/Import
+//
+// The Export/Import service provides the ability to copy all or a subset of
+// entities to/from Google Cloud Storage.
+//
+// Exported data may be imported into Cloud Datastore for any Google Cloud
+// Platform project. It is not restricted to the export source project. It is
+// possible to export from one project and then import into another.
+//
+// Exported data can also be loaded into Google BigQuery for analysis.
+//
+// Exports and imports are performed asynchronously. An Operation resource is
+// created for each export/import. The state (including any errors encountered)
+// of the export/import may be queried via the Operation resource.
+//
+// # Operation
+//
+// The Operations collection provides a record of actions performed for the
+// specified project (including any operations in progress). Operations are not
+// created directly but through calls on other collections or resources.
+//
+// An operation that is not yet done may be cancelled. The request to cancel is
+// asynchronous and the operation may continue to run for some time after the
+// request to cancel is made.
+//
+// An operation that is done may be deleted so that it is no longer listed as
+// part of the Operation collection.
+//
+// ListOperations returns all pending operations, but not completed operations.
+//
+// Operations are created by service DatastoreAdmin,
+// but are accessed via service google.longrunning.Operations.
+service DatastoreAdmin {
+  // 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
+  // background and its progress can be monitored and managed via the
+  // Operation resource that is created. The output of an export may only be
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1beta1/projects/{project_id}:export"
+      body: "*"
+    };
+  }
+
+  // Imports entities into Google Cloud Datastore. Existing entities with the
+  // same key are overwritten. The import occurs in the background and its
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1beta1/projects/{project_id}:import"
+      body: "*"
+    };
+  }
+}
+
+// Metadata common to all Datastore Admin operations.
+message CommonMetadata {
+  // The various possible states for an ongoing Operation.
+  enum State {
+    // Unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is being prepared for processing.
+    INITIALIZING = 1;
+
+    // Request is actively being processed.
+    PROCESSING = 2;
+
+    // Request is in the process of being cancelled after user called
+    // google.longrunning.Operations.CancelOperation on the operation.
+    CANCELLING = 3;
+
+    // Request has been processed and is in its finalization stage.
+    FINALIZING = 4;
+
+    // Request has completed successfully.
+    SUCCESSFUL = 5;
+
+    // Request has finished being processed, but encountered an error.
+    FAILED = 6;
+
+    // Request has finished being cancelled after user called
+    // google.longrunning.Operations.CancelOperation.
+    CANCELLED = 7;
+  }
+
+  // The time that work began on the operation.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time the operation ended, either successfully or otherwise.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The type of the operation. Can be used as a filter in
+  // ListOperationsRequest.
+  OperationType operation_type = 3;
+
+  // The client-assigned labels which were provided when the operation was
+  // created. May also include additional labels.
+  map<string, string> labels = 4;
+
+  // The current state of the Operation.
+  State state = 5;
+}
+
+// Measures the progress of a particular metric.
+message Progress {
+  // The amount of work that has been completed. Note that this may be greater
+  // than work_estimated.
+  int64 work_completed = 1;
+
+  // An estimate of how much work needs to be performed. May be zero if the
+  // work estimate is unavailable.
+  int64 work_estimated = 2;
+}
+
+// The request for
+// [google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities][google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities].
+message ExportEntitiesRequest {
+  // Project ID against which to make the request.
+  string project_id = 1;
+
+  // Client-assigned labels.
+  map<string, string> labels = 2;
+
+  // Description of what data from the project is included in the export.
+  EntityFilter entity_filter = 3;
+
+  // 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
+  // form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the
+  // name of the Cloud Storage bucket and `NAMESPACE_PATH` is an optional Cloud
+  // Storage namespace path (this is not a Cloud Datastore namespace). For more
+  // information about Cloud Storage namespace paths, see
+  // [Object name
+  // considerations](https://cloud.google.com/storage/docs/naming#object-considerations).
+  //
+  // The resulting files will be nested deeper than the specified URL prefix.
+  // The final output URL will be provided in the
+  // [google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url][google.datastore.admin.v1beta1.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;
+}
+
+// The request for
+// [google.datastore.admin.v1beta1.DatastoreAdmin.ImportEntities][google.datastore.admin.v1beta1.DatastoreAdmin.ImportEntities].
+message ImportEntitiesRequest {
+  // Project ID against which to make the request.
+  string project_id = 1;
+
+  // Client-assigned labels.
+  map<string, string> labels = 2;
+
+  // 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
+  // an optional Cloud Storage namespace path (this is not a Cloud Datastore
+  // namespace), and `OVERALL_EXPORT_METADATA_FILE` is the metadata file written
+  // by the ExportEntities operation. For more information about Cloud Storage
+  // namespace paths, see
+  // [Object name
+  // considerations](https://cloud.google.com/storage/docs/naming#object-considerations).
+  //
+  // For more information, see
+  // [google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url][google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url].
+  string input_url = 3;
+
+  // 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,
+  // otherwise a FAILED_PRECONDITION error will be returned. If no filter is
+  // specified then all entities from the export are imported.
+  EntityFilter entity_filter = 4;
+}
+
+// The response for
+// [google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities][google.datastore.admin.v1beta1.DatastoreAdmin.ExportEntities].
+message ExportEntitiesResponse {
+  // Location of the output metadata file. This can be used to begin an import
+  // into Cloud Datastore (this project or another project). See
+  // [google.datastore.admin.v1beta1.ImportEntitiesRequest.input_url][google.datastore.admin.v1beta1.ImportEntitiesRequest.input_url].
+  // Only present if the operation completed successfully.
+  string output_url = 1;
+}
+
+// Metadata for ExportEntities operations.
+message ExportEntitiesMetadata {
+  // Metadata common to all Datastore Admin operations.
+  CommonMetadata common = 1;
+
+  // An estimate of the number of entities processed.
+  Progress progress_entities = 2;
+
+  // An estimate of the number of bytes processed.
+  Progress progress_bytes = 3;
+
+  // Description of which entities are being exported.
+  EntityFilter entity_filter = 4;
+
+  // Location for the export metadata and data files. This will be the same
+  // value as the
+  // [google.datastore.admin.v1beta1.ExportEntitiesRequest.output_url_prefix][google.datastore.admin.v1beta1.ExportEntitiesRequest.output_url_prefix]
+  // field. The final output location is provided in
+  // [google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url][google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url].
+  string output_url_prefix = 5;
+}
+
+// Metadata for ImportEntities operations.
+message ImportEntitiesMetadata {
+  // Metadata common to all Datastore Admin operations.
+  CommonMetadata common = 1;
+
+  // An estimate of the number of entities processed.
+  Progress progress_entities = 2;
+
+  // An estimate of the number of bytes processed.
+  Progress progress_bytes = 3;
+
+  // Description of which entities are being imported.
+  EntityFilter entity_filter = 4;
+
+  // The location of the import metadata file. This will be the same value as
+  // the [google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url][google.datastore.admin.v1beta1.ExportEntitiesResponse.output_url]
+  // field.
+  string input_url = 5;
+}
+
+// Identifies a subset of entities in a project. This is specified as
+// combinations of kinds and namespaces (either or both of which may be all, as
+// described in the following examples).
+// Example usage:
+//
+// Entire project:
+//   kinds=[], namespace_ids=[]
+//
+// Kinds Foo and Bar in all namespaces:
+//   kinds=['Foo', 'Bar'], namespace_ids=[]
+//
+// Kinds Foo and Bar only in the default namespace:
+//   kinds=['Foo', 'Bar'], namespace_ids=['']
+//
+// Kinds Foo and Bar in both the default and Baz namespaces:
+//   kinds=['Foo', 'Bar'], namespace_ids=['', 'Baz']
+//
+// The entire Baz namespace:
+//   kinds=[], namespace_ids=['Baz']
+message EntityFilter {
+  // If empty, then this represents all kinds.
+  repeated string kinds = 1;
+
+  // An empty list represents all namespaces. This is the preferred
+  // usage for projects that don't use namespaces.
+  //
+  // An empty string element represents the default namespace. This should be
+  // used if the project has data in non-default namespaces, but doesn't want to
+  // include them.
+  // Each namespace in this list must be unique.
+  repeated string namespace_ids = 2;
+}
+
+// Operation types.
+enum OperationType {
+  // Unspecified.
+  OPERATION_TYPE_UNSPECIFIED = 0;
+
+  // ExportEntities.
+  EXPORT_ENTITIES = 1;
+
+  // ImportEntities.
+  IMPORT_ENTITIES = 2;
+}
diff --git a/datastore/google/cloud/datastore_v1/proto/datastore_pb2.py b/datastore/google/cloud/datastore_v1/proto/datastore_pb2.py
new file mode 100644
index 000000000000..c62dea6375e0
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/datastore_pb2.py
@@ -0,0 +1,2082 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datastore_v1/proto/datastore.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datastore_v1.proto import (
+    entity_pb2 as google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2,
+)
+from google.cloud.datastore_v1.proto import (
+    query_pb2 as google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datastore_v1/proto/datastore.proto",
+    package="google.datastore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.datastore.v1B\016DatastoreProtoP\001Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\252\002\031Google.Cloud.Datastore.V1\312\002\031Google\\Cloud\\Datastore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/datastore_v1/proto/datastore.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a,google/cloud/datastore_v1/proto/entity.proto\x1a+google/cloud/datastore_v1/proto/query.proto"\x83\x01\n\rLookupRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12&\n\x04keys\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key"\xa2\x01\n\x0eLookupResponse\x12\x30\n\x05\x66ound\x18\x01 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x32\n\x07missing\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12*\n\x08\x64\x65\x66\x65rred\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key"\x84\x02\n\x0fRunQueryRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x05query\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.QueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x42\x0c\n\nquery_type"s\n\x10RunQueryResponse\x12\x34\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32%.google.datastore.v1.QueryResultBatch\x12)\n\x05query\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Query"s\n\x17\x42\x65ginTransactionRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x44\n\x13transaction_options\x18\n \x01(\x0b\x32\'.google.datastore.v1.TransactionOptions"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c":\n\x0fRollbackRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c"\x12\n\x10RollbackResponse"\x83\x02\n\rCommitRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x35\n\x04mode\x18\x05 \x01(\x0e\x32\'.google.datastore.v1.CommitRequest.Mode\x12\x15\n\x0btransaction\x18\x01 \x01(\x0cH\x00\x12\x30\n\tmutations\x18\x06 \x03(\x0b\x32\x1d.google.datastore.v1.Mutation"F\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rTRANSACTIONAL\x10\x01\x12\x15\n\x11NON_TRANSACTIONAL\x10\x02\x42\x16\n\x14transaction_selector"f\n\x0e\x43ommitResponse\x12=\n\x10mutation_results\x18\x03 \x03(\x0b\x32#.google.datastore.v1.MutationResult\x12\x15\n\rindex_updates\x18\x04 \x01(\x05"P\n\x12\x41llocateIdsRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key"=\n\x13\x41llocateIdsResponse\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key"d\n\x11ReserveIdsRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x13\n\x0b\x64\x61tabase_id\x18\t \x01(\t\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key"\x14\n\x12ReserveIdsResponse"\x87\x02\n\x08Mutation\x12-\n\x06insert\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06update\x18\x05 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06upsert\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12*\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0c\x62\x61se_version\x18\x08 \x01(\x03H\x01\x42\x0b\n\toperationB\x1d\n\x1b\x63onflict_detection_strategy"c\n\x0eMutationResult\x12%\n\x03key\x18\x03 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12\x19\n\x11\x63onflict_detected\x18\x05 \x01(\x08"\xd5\x01\n\x0bReadOptions\x12L\n\x10read_consistency\x18\x01 \x01(\x0e\x32\x30.google.datastore.v1.ReadOptions.ReadConsistencyH\x00\x12\x15\n\x0btransaction\x18\x02 \x01(\x0cH\x00"M\n\x0fReadConsistency\x12 \n\x1cREAD_CONSISTENCY_UNSPECIFIED\x10\x00\x12\n\n\x06STRONG\x10\x01\x12\x0c\n\x08\x45VENTUAL\x10\x02\x42\x12\n\x10\x63onsistency_type"\xe3\x01\n\x12TransactionOptions\x12G\n\nread_write\x18\x01 \x01(\x0b\x32\x31.google.datastore.v1.TransactionOptions.ReadWriteH\x00\x12\x45\n\tread_only\x18\x02 \x01(\x0b\x32\x30.google.datastore.v1.TransactionOptions.ReadOnlyH\x00\x1a)\n\tReadWrite\x12\x1c\n\x14previous_transaction\x18\x01 \x01(\x0c\x1a\n\n\x08ReadOnlyB\x06\n\x04mode2\xec\x07\n\tDatastore\x12~\n\x06Lookup\x12".google.datastore.v1.LookupRequest\x1a#.google.datastore.v1.LookupResponse"+\x82\xd3\xe4\x93\x02%" /v1/projects/{project_id}:lookup:\x01*\x12\x86\x01\n\x08RunQuery\x12$.google.datastore.v1.RunQueryRequest\x1a%.google.datastore.v1.RunQueryResponse"-\x82\xd3\xe4\x93\x02\'""/v1/projects/{project_id}:runQuery:\x01*\x12\xa6\x01\n\x10\x42\x65ginTransaction\x12,.google.datastore.v1.BeginTransactionRequest\x1a-.google.datastore.v1.BeginTransactionResponse"5\x82\xd3\xe4\x93\x02/"*/v1/projects/{project_id}:beginTransaction:\x01*\x12~\n\x06\x43ommit\x12".google.datastore.v1.CommitRequest\x1a#.google.datastore.v1.CommitResponse"+\x82\xd3\xe4\x93\x02%" /v1/projects/{project_id}:commit:\x01*\x12\x86\x01\n\x08Rollback\x12$.google.datastore.v1.RollbackRequest\x1a%.google.datastore.v1.RollbackResponse"-\x82\xd3\xe4\x93\x02\'""/v1/projects/{project_id}:rollback:\x01*\x12\x92\x01\n\x0b\x41llocateIds\x12\'.google.datastore.v1.AllocateIdsRequest\x1a(.google.datastore.v1.AllocateIdsResponse"0\x82\xd3\xe4\x93\x02*"%/v1/projects/{project_id}:allocateIds:\x01*\x12\x8e\x01\n\nReserveIds\x12&.google.datastore.v1.ReserveIdsRequest\x1a\'.google.datastore.v1.ReserveIdsResponse"/\x82\xd3\xe4\x93\x02)"$/v1/projects/{project_id}:reserveIds:\x01*B\xa1\x01\n\x17\x63om.google.datastore.v1B\x0e\x44\x61tastoreProtoP\x01Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_COMMITREQUEST_MODE = _descriptor.EnumDescriptor(
+    name="Mode",
+    full_name="google.datastore.v1.CommitRequest.Mode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TRANSACTIONAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NON_TRANSACTIONAL",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1284,
+    serialized_end=1354,
+)
+_sym_db.RegisterEnumDescriptor(_COMMITREQUEST_MODE)
+
+_READOPTIONS_READCONSISTENCY = _descriptor.EnumDescriptor(
+    name="ReadConsistency",
+    full_name="google.datastore.v1.ReadOptions.ReadConsistency",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="READ_CONSISTENCY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRONG", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENTUAL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2237,
+    serialized_end=2314,
+)
+_sym_db.RegisterEnumDescriptor(_READOPTIONS_READCONSISTENCY)
+
+
+_LOOKUPREQUEST = _descriptor.Descriptor(
+    name="LookupRequest",
+    full_name="google.datastore.v1.LookupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.LookupRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_options",
+            full_name="google.datastore.v1.LookupRequest.read_options",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keys",
+            full_name="google.datastore.v1.LookupRequest.keys",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=194,
+    serialized_end=325,
+)
+
+
+_LOOKUPRESPONSE = _descriptor.Descriptor(
+    name="LookupResponse",
+    full_name="google.datastore.v1.LookupResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="found",
+            full_name="google.datastore.v1.LookupResponse.found",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing",
+            full_name="google.datastore.v1.LookupResponse.missing",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deferred",
+            full_name="google.datastore.v1.LookupResponse.deferred",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=328,
+    serialized_end=490,
+)
+
+
+_RUNQUERYREQUEST = _descriptor.Descriptor(
+    name="RunQueryRequest",
+    full_name="google.datastore.v1.RunQueryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.RunQueryRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partition_id",
+            full_name="google.datastore.v1.RunQueryRequest.partition_id",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_options",
+            full_name="google.datastore.v1.RunQueryRequest.read_options",
+            index=2,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.datastore.v1.RunQueryRequest.query",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gql_query",
+            full_name="google.datastore.v1.RunQueryRequest.gql_query",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="query_type",
+            full_name="google.datastore.v1.RunQueryRequest.query_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=493,
+    serialized_end=753,
+)
+
+
+_RUNQUERYRESPONSE = _descriptor.Descriptor(
+    name="RunQueryResponse",
+    full_name="google.datastore.v1.RunQueryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="batch",
+            full_name="google.datastore.v1.RunQueryResponse.batch",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.datastore.v1.RunQueryResponse.query",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=755,
+    serialized_end=870,
+)
+
+
+_BEGINTRANSACTIONREQUEST = _descriptor.Descriptor(
+    name="BeginTransactionRequest",
+    full_name="google.datastore.v1.BeginTransactionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.BeginTransactionRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction_options",
+            full_name="google.datastore.v1.BeginTransactionRequest.transaction_options",
+            index=1,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=872,
+    serialized_end=987,
+)
+
+
+_BEGINTRANSACTIONRESPONSE = _descriptor.Descriptor(
+    name="BeginTransactionResponse",
+    full_name="google.datastore.v1.BeginTransactionResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.datastore.v1.BeginTransactionResponse.transaction",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=989,
+    serialized_end=1036,
+)
+
+
+_ROLLBACKREQUEST = _descriptor.Descriptor(
+    name="RollbackRequest",
+    full_name="google.datastore.v1.RollbackRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.RollbackRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.datastore.v1.RollbackRequest.transaction",
+            index=1,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1038,
+    serialized_end=1096,
+)
+
+
+_ROLLBACKRESPONSE = _descriptor.Descriptor(
+    name="RollbackResponse",
+    full_name="google.datastore.v1.RollbackResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1098,
+    serialized_end=1116,
+)
+
+
+_COMMITREQUEST = _descriptor.Descriptor(
+    name="CommitRequest",
+    full_name="google.datastore.v1.CommitRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.CommitRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mode",
+            full_name="google.datastore.v1.CommitRequest.mode",
+            index=1,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.datastore.v1.CommitRequest.transaction",
+            index=2,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mutations",
+            full_name="google.datastore.v1.CommitRequest.mutations",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_COMMITREQUEST_MODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transaction_selector",
+            full_name="google.datastore.v1.CommitRequest.transaction_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1119,
+    serialized_end=1378,
+)
+
+
+_COMMITRESPONSE = _descriptor.Descriptor(
+    name="CommitResponse",
+    full_name="google.datastore.v1.CommitResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mutation_results",
+            full_name="google.datastore.v1.CommitResponse.mutation_results",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_updates",
+            full_name="google.datastore.v1.CommitResponse.index_updates",
+            index=1,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1380,
+    serialized_end=1482,
+)
+
+
+_ALLOCATEIDSREQUEST = _descriptor.Descriptor(
+    name="AllocateIdsRequest",
+    full_name="google.datastore.v1.AllocateIdsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.AllocateIdsRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keys",
+            full_name="google.datastore.v1.AllocateIdsRequest.keys",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1484,
+    serialized_end=1564,
+)
+
+
+_ALLOCATEIDSRESPONSE = _descriptor.Descriptor(
+    name="AllocateIdsResponse",
+    full_name="google.datastore.v1.AllocateIdsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="keys",
+            full_name="google.datastore.v1.AllocateIdsResponse.keys",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1566,
+    serialized_end=1627,
+)
+
+
+_RESERVEIDSREQUEST = _descriptor.Descriptor(
+    name="ReserveIdsRequest",
+    full_name="google.datastore.v1.ReserveIdsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.ReserveIdsRequest.project_id",
+            index=0,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="database_id",
+            full_name="google.datastore.v1.ReserveIdsRequest.database_id",
+            index=1,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keys",
+            full_name="google.datastore.v1.ReserveIdsRequest.keys",
+            index=2,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1629,
+    serialized_end=1729,
+)
+
+
+_RESERVEIDSRESPONSE = _descriptor.Descriptor(
+    name="ReserveIdsResponse",
+    full_name="google.datastore.v1.ReserveIdsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1731,
+    serialized_end=1751,
+)
+
+
+_MUTATION = _descriptor.Descriptor(
+    name="Mutation",
+    full_name="google.datastore.v1.Mutation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="insert",
+            full_name="google.datastore.v1.Mutation.insert",
+            index=0,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.datastore.v1.Mutation.update",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="upsert",
+            full_name="google.datastore.v1.Mutation.upsert",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="google.datastore.v1.Mutation.delete",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="base_version",
+            full_name="google.datastore.v1.Mutation.base_version",
+            index=4,
+            number=8,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="operation",
+            full_name="google.datastore.v1.Mutation.operation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="conflict_detection_strategy",
+            full_name="google.datastore.v1.Mutation.conflict_detection_strategy",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=1754,
+    serialized_end=2017,
+)
+
+
+_MUTATIONRESULT = _descriptor.Descriptor(
+    name="MutationResult",
+    full_name="google.datastore.v1.MutationResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.datastore.v1.MutationResult.key",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.datastore.v1.MutationResult.version",
+            index=1,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="conflict_detected",
+            full_name="google.datastore.v1.MutationResult.conflict_detected",
+            index=2,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2019,
+    serialized_end=2118,
+)
+
+
+_READOPTIONS = _descriptor.Descriptor(
+    name="ReadOptions",
+    full_name="google.datastore.v1.ReadOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_consistency",
+            full_name="google.datastore.v1.ReadOptions.read_consistency",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.datastore.v1.ReadOptions.transaction",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_READOPTIONS_READCONSISTENCY],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_type",
+            full_name="google.datastore.v1.ReadOptions.consistency_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2121,
+    serialized_end=2334,
+)
+
+
+_TRANSACTIONOPTIONS_READWRITE = _descriptor.Descriptor(
+    name="ReadWrite",
+    full_name="google.datastore.v1.TransactionOptions.ReadWrite",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="previous_transaction",
+            full_name="google.datastore.v1.TransactionOptions.ReadWrite.previous_transaction",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2503,
+    serialized_end=2544,
+)
+
+_TRANSACTIONOPTIONS_READONLY = _descriptor.Descriptor(
+    name="ReadOnly",
+    full_name="google.datastore.v1.TransactionOptions.ReadOnly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2546,
+    serialized_end=2556,
+)
+
+_TRANSACTIONOPTIONS = _descriptor.Descriptor(
+    name="TransactionOptions",
+    full_name="google.datastore.v1.TransactionOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_write",
+            full_name="google.datastore.v1.TransactionOptions.read_write",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_only",
+            full_name="google.datastore.v1.TransactionOptions.read_only",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TRANSACTIONOPTIONS_READWRITE, _TRANSACTIONOPTIONS_READONLY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="mode",
+            full_name="google.datastore.v1.TransactionOptions.mode",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2337,
+    serialized_end=2564,
+)
+
+_LOOKUPREQUEST.fields_by_name["read_options"].message_type = _READOPTIONS
+_LOOKUPREQUEST.fields_by_name[
+    "keys"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_LOOKUPRESPONSE.fields_by_name[
+    "found"
+].message_type = (
+    google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2._ENTITYRESULT
+)
+_LOOKUPRESPONSE.fields_by_name[
+    "missing"
+].message_type = (
+    google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2._ENTITYRESULT
+)
+_LOOKUPRESPONSE.fields_by_name[
+    "deferred"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_RUNQUERYREQUEST.fields_by_name[
+    "partition_id"
+].message_type = (
+    google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._PARTITIONID
+)
+_RUNQUERYREQUEST.fields_by_name["read_options"].message_type = _READOPTIONS
+_RUNQUERYREQUEST.fields_by_name[
+    "query"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2._QUERY
+_RUNQUERYREQUEST.fields_by_name[
+    "gql_query"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2._GQLQUERY
+_RUNQUERYREQUEST.oneofs_by_name["query_type"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["query"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "query"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["query_type"]
+_RUNQUERYREQUEST.oneofs_by_name["query_type"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["gql_query"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "gql_query"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["query_type"]
+_RUNQUERYRESPONSE.fields_by_name[
+    "batch"
+].message_type = (
+    google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2._QUERYRESULTBATCH
+)
+_RUNQUERYRESPONSE.fields_by_name[
+    "query"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_query__pb2._QUERY
+_BEGINTRANSACTIONREQUEST.fields_by_name[
+    "transaction_options"
+].message_type = _TRANSACTIONOPTIONS
+_COMMITREQUEST.fields_by_name["mode"].enum_type = _COMMITREQUEST_MODE
+_COMMITREQUEST.fields_by_name["mutations"].message_type = _MUTATION
+_COMMITREQUEST_MODE.containing_type = _COMMITREQUEST
+_COMMITREQUEST.oneofs_by_name["transaction_selector"].fields.append(
+    _COMMITREQUEST.fields_by_name["transaction"]
+)
+_COMMITREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _COMMITREQUEST.oneofs_by_name["transaction_selector"]
+_COMMITRESPONSE.fields_by_name["mutation_results"].message_type = _MUTATIONRESULT
+_ALLOCATEIDSREQUEST.fields_by_name[
+    "keys"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_ALLOCATEIDSRESPONSE.fields_by_name[
+    "keys"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_RESERVEIDSREQUEST.fields_by_name[
+    "keys"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_MUTATION.fields_by_name[
+    "insert"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._ENTITY
+_MUTATION.fields_by_name[
+    "update"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._ENTITY
+_MUTATION.fields_by_name[
+    "upsert"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._ENTITY
+_MUTATION.fields_by_name[
+    "delete"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["insert"])
+_MUTATION.fields_by_name["insert"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["update"])
+_MUTATION.fields_by_name["update"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["upsert"])
+_MUTATION.fields_by_name["upsert"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["delete"])
+_MUTATION.fields_by_name["delete"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["conflict_detection_strategy"].fields.append(
+    _MUTATION.fields_by_name["base_version"]
+)
+_MUTATION.fields_by_name["base_version"].containing_oneof = _MUTATION.oneofs_by_name[
+    "conflict_detection_strategy"
+]
+_MUTATIONRESULT.fields_by_name[
+    "key"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._KEY
+_READOPTIONS.fields_by_name["read_consistency"].enum_type = _READOPTIONS_READCONSISTENCY
+_READOPTIONS_READCONSISTENCY.containing_type = _READOPTIONS
+_READOPTIONS.oneofs_by_name["consistency_type"].fields.append(
+    _READOPTIONS.fields_by_name["read_consistency"]
+)
+_READOPTIONS.fields_by_name[
+    "read_consistency"
+].containing_oneof = _READOPTIONS.oneofs_by_name["consistency_type"]
+_READOPTIONS.oneofs_by_name["consistency_type"].fields.append(
+    _READOPTIONS.fields_by_name["transaction"]
+)
+_READOPTIONS.fields_by_name[
+    "transaction"
+].containing_oneof = _READOPTIONS.oneofs_by_name["consistency_type"]
+_TRANSACTIONOPTIONS_READWRITE.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].message_type = _TRANSACTIONOPTIONS_READWRITE
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].message_type = _TRANSACTIONOPTIONS_READONLY
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_write"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_only"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+DESCRIPTOR.message_types_by_name["LookupRequest"] = _LOOKUPREQUEST
+DESCRIPTOR.message_types_by_name["LookupResponse"] = _LOOKUPRESPONSE
+DESCRIPTOR.message_types_by_name["RunQueryRequest"] = _RUNQUERYREQUEST
+DESCRIPTOR.message_types_by_name["RunQueryResponse"] = _RUNQUERYRESPONSE
+DESCRIPTOR.message_types_by_name["BeginTransactionRequest"] = _BEGINTRANSACTIONREQUEST
+DESCRIPTOR.message_types_by_name["BeginTransactionResponse"] = _BEGINTRANSACTIONRESPONSE
+DESCRIPTOR.message_types_by_name["RollbackRequest"] = _ROLLBACKREQUEST
+DESCRIPTOR.message_types_by_name["RollbackResponse"] = _ROLLBACKRESPONSE
+DESCRIPTOR.message_types_by_name["CommitRequest"] = _COMMITREQUEST
+DESCRIPTOR.message_types_by_name["CommitResponse"] = _COMMITRESPONSE
+DESCRIPTOR.message_types_by_name["AllocateIdsRequest"] = _ALLOCATEIDSREQUEST
+DESCRIPTOR.message_types_by_name["AllocateIdsResponse"] = _ALLOCATEIDSRESPONSE
+DESCRIPTOR.message_types_by_name["ReserveIdsRequest"] = _RESERVEIDSREQUEST
+DESCRIPTOR.message_types_by_name["ReserveIdsResponse"] = _RESERVEIDSRESPONSE
+DESCRIPTOR.message_types_by_name["Mutation"] = _MUTATION
+DESCRIPTOR.message_types_by_name["MutationResult"] = _MUTATIONRESULT
+DESCRIPTOR.message_types_by_name["ReadOptions"] = _READOPTIONS
+DESCRIPTOR.message_types_by_name["TransactionOptions"] = _TRANSACTIONOPTIONS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LookupRequest = _reflection.GeneratedProtocolMessageType(
+    "LookupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOOKUPREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.Lookup][google.datastore.v1.Datastore.Lookup].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      read_options:
+          The options for this lookup request.
+      keys:
+          Keys of entities to look up.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.LookupRequest)
+    ),
+)
+_sym_db.RegisterMessage(LookupRequest)
+
+LookupResponse = _reflection.GeneratedProtocolMessageType(
+    "LookupResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOOKUPRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.Lookup][google.datastore.v1.Datastore.Lookup].
+  
+  
+  Attributes:
+      found:
+          Entities found as ``ResultType.FULL`` entities. The order of
+          results in this field is undefined and has no relation to the
+          order of the keys in the input.
+      missing:
+          Entities not found as ``ResultType.KEY_ONLY`` entities. The
+          order of results in this field is undefined and has no
+          relation to the order of the keys in the input.
+      deferred:
+          A list of keys that were not looked up due to resource
+          constraints. The order of results in this field is undefined
+          and has no relation to the order of the keys in the input.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.LookupResponse)
+    ),
+)
+_sym_db.RegisterMessage(LookupResponse)
+
+RunQueryRequest = _reflection.GeneratedProtocolMessageType(
+    "RunQueryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNQUERYREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      partition_id:
+          Entities are partitioned into subsets, identified by a
+          partition ID. Queries are scoped to a single partition. This
+          partition ID is normalized with the standard default context
+          partition ID.
+      read_options:
+          The options for this query.
+      query_type:
+          The type of query.
+      query:
+          The query to run.
+      gql_query:
+          The GQL query to run.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.RunQueryRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunQueryRequest)
+
+RunQueryResponse = _reflection.GeneratedProtocolMessageType(
+    "RunQueryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNQUERYRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
+  
+  
+  Attributes:
+      batch:
+          A batch of query results (always present).
+      query:
+          The parsed form of the ``GqlQuery`` from the request, if it
+          was set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.RunQueryResponse)
+    ),
+)
+_sym_db.RegisterMessage(RunQueryResponse)
+
+BeginTransactionRequest = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      transaction_options:
+          Options for a new transaction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.BeginTransactionRequest)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionRequest)
+
+BeginTransactionResponse = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+  
+  
+  Attributes:
+      transaction:
+          The transaction identifier (always present).
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.BeginTransactionResponse)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionResponse)
+
+RollbackRequest = _reflection.GeneratedProtocolMessageType(
+    "RollbackRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.Rollback][google.datastore.v1.Datastore.Rollback].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      transaction:
+          The transaction identifier, returned by a call to [Datastore.B
+          eginTransaction][google.datastore.v1.Datastore.BeginTransactio
+          n].
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.RollbackRequest)
+    ),
+)
+_sym_db.RegisterMessage(RollbackRequest)
+
+RollbackResponse = _reflection.GeneratedProtocolMessageType(
+    "RollbackResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.Rollback][google.datastore.v1.Datastore.Rollback]. (an empty
+  message).
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.RollbackResponse)
+    ),
+)
+_sym_db.RegisterMessage(RollbackResponse)
+
+CommitRequest = _reflection.GeneratedProtocolMessageType(
+    "CommitRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.Commit][google.datastore.v1.Datastore.Commit].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      mode:
+          The type of commit to perform. Defaults to ``TRANSACTIONAL``.
+      transaction_selector:
+          Must be set when mode is ``TRANSACTIONAL``.
+      transaction:
+          The identifier of the transaction associated with the commit.
+          A transaction identifier is returned by a call to [Datastore.B
+          eginTransaction][google.datastore.v1.Datastore.BeginTransactio
+          n].
+      mutations:
+          The mutations to perform.  When mode is ``TRANSACTIONAL``,
+          mutations affecting a single entity are applied in order. The
+          following sequences of mutations affecting a single entity are
+          not permitted in a single ``Commit`` request:  -  ``insert``
+          followed by ``insert`` -  ``update`` followed by ``insert`` -
+          ``upsert`` followed by ``insert`` -  ``delete`` followed by
+          ``update``  When mode is ``NON_TRANSACTIONAL``, no two
+          mutations may affect a single entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.CommitRequest)
+    ),
+)
+_sym_db.RegisterMessage(CommitRequest)
+
+CommitResponse = _reflection.GeneratedProtocolMessageType(
+    "CommitResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.Commit][google.datastore.v1.Datastore.Commit].
+  
+  
+  Attributes:
+      mutation_results:
+          The result of performing the mutations. The i-th mutation
+          result corresponds to the i-th mutation in the request.
+      index_updates:
+          The number of index entries updated during the commit, or zero
+          if none were updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.CommitResponse)
+    ),
+)
+_sym_db.RegisterMessage(CommitResponse)
+
+AllocateIdsRequest = _reflection.GeneratedProtocolMessageType(
+    "AllocateIdsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ALLOCATEIDSREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.AllocateIds][google.datastore.v1.Datastore.AllocateIds].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      keys:
+          A list of keys with incomplete key paths for which to allocate
+          IDs. No key may be reserved/read-only.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.AllocateIdsRequest)
+    ),
+)
+_sym_db.RegisterMessage(AllocateIdsRequest)
+
+AllocateIdsResponse = _reflection.GeneratedProtocolMessageType(
+    "AllocateIdsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ALLOCATEIDSRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.AllocateIds][google.datastore.v1.Datastore.AllocateIds].
+  
+  
+  Attributes:
+      keys:
+          The keys specified in the request (in the same order), each
+          with its key path completed with a newly allocated ID.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.AllocateIdsResponse)
+    ),
+)
+_sym_db.RegisterMessage(AllocateIdsResponse)
+
+ReserveIdsRequest = _reflection.GeneratedProtocolMessageType(
+    "ReserveIdsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESERVEIDSREQUEST,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The request for
+  [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project against which to make the request.
+      database_id:
+          If not empty, the ID of the database against which to make the
+          request.
+      keys:
+          A list of keys with complete key paths whose numeric IDs
+          should not be auto-allocated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.ReserveIdsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReserveIdsRequest)
+
+ReserveIdsResponse = _reflection.GeneratedProtocolMessageType(
+    "ReserveIdsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESERVEIDSRESPONSE,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The response for
+  [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.ReserveIdsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReserveIdsResponse)
+
+Mutation = _reflection.GeneratedProtocolMessageType(
+    "Mutation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MUTATION,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""A mutation to apply to an entity.
+  
+  
+  Attributes:
+      operation:
+          The mutation operation.  For ``insert``, ``update``, and
+          ``upsert``: - The entity's key must not be reserved/read-only.
+          - No property in the entity may have a reserved name, not even
+          a property in an entity in a value. - No value in the entity
+          may have meaning 18, not even a value in an entity in another
+          value.
+      insert:
+          The entity to insert. The entity must not already exist. The
+          entity key's final path element may be incomplete.
+      update:
+          The entity to update. The entity must already exist. Must have
+          a complete key path.
+      upsert:
+          The entity to upsert. The entity may or may not already exist.
+          The entity key's final path element may be incomplete.
+      delete:
+          The key of the entity to delete. The entity may or may not
+          already exist. Must have a complete key path and must not be
+          reserved/read-only.
+      conflict_detection_strategy:
+          When set, the server will detect whether or not this mutation
+          conflicts with the current version of the entity on the
+          server. Conflicting mutations are not applied, and are marked
+          as such in MutationResult.
+      base_version:
+          The version of the entity that this mutation is being applied
+          to. If this does not match the current version on the server,
+          the mutation conflicts.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Mutation)
+    ),
+)
+_sym_db.RegisterMessage(Mutation)
+
+MutationResult = _reflection.GeneratedProtocolMessageType(
+    "MutationResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MUTATIONRESULT,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The result of applying a mutation.
+  
+  
+  Attributes:
+      key:
+          The automatically allocated key. Set only when the mutation
+          allocated a key.
+      version:
+          The version of the entity on the server after processing the
+          mutation. If the mutation doesn't change anything on the
+          server, then the version will be the version of the current
+          entity or, if no entity is present, a version that is strictly
+          greater than the version of any previous entity and less than
+          the version of any possible future entity.
+      conflict_detected:
+          Whether a conflict was detected for this mutation. Always
+          false when a conflict detection strategy field is not set in
+          the mutation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.MutationResult)
+    ),
+)
+_sym_db.RegisterMessage(MutationResult)
+
+ReadOptions = _reflection.GeneratedProtocolMessageType(
+    "ReadOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READOPTIONS,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""The options shared by read requests.
+  
+  
+  Attributes:
+      consistency_type:
+          If not specified, lookups and ancestor queries default to
+          ``read_consistency``\ =\ ``STRONG``, global queries default to
+          ``read_consistency``\ =\ ``EVENTUAL``.
+      read_consistency:
+          The non-transactional read consistency to use. Cannot be set
+          to ``STRONG`` for global queries.
+      transaction:
+          The identifier of the transaction in which to read. A
+          transaction identifier is returned by a call to [Datastore.Beg
+          inTransaction][google.datastore.v1.Datastore.BeginTransaction]
+          .
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.ReadOptions)
+    ),
+)
+_sym_db.RegisterMessage(ReadOptions)
+
+TransactionOptions = _reflection.GeneratedProtocolMessageType(
+    "TransactionOptions",
+    (_message.Message,),
+    dict(
+        ReadWrite=_reflection.GeneratedProtocolMessageType(
+            "ReadWrite",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READWRITE,
+                __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+                __doc__="""Options specific to read / write transactions.
+    
+    
+    Attributes:
+        previous_transaction:
+            The transaction identifier of the transaction being retried.
+    """,
+                # @@protoc_insertion_point(class_scope:google.datastore.v1.TransactionOptions.ReadWrite)
+            ),
+        ),
+        ReadOnly=_reflection.GeneratedProtocolMessageType(
+            "ReadOnly",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READONLY,
+                __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+                __doc__="""Options specific to read-only transactions.
+    """,
+                # @@protoc_insertion_point(class_scope:google.datastore.v1.TransactionOptions.ReadOnly)
+            ),
+        ),
+        DESCRIPTOR=_TRANSACTIONOPTIONS,
+        __module__="google.cloud.datastore_v1.proto.datastore_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      mode:
+          The ``mode`` of the transaction, indicating whether write
+          operations are supported.
+      read_write:
+          The transaction should allow both reads and writes.
+      read_only:
+          The transaction should only allow reads.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.TransactionOptions)
+    ),
+)
+_sym_db.RegisterMessage(TransactionOptions)
+_sym_db.RegisterMessage(TransactionOptions.ReadWrite)
+_sym_db.RegisterMessage(TransactionOptions.ReadOnly)
+
+
+DESCRIPTOR._options = None
+
+_DATASTORE = _descriptor.ServiceDescriptor(
+    name="Datastore",
+    full_name="google.datastore.v1.Datastore",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2567,
+    serialized_end=3571,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="Lookup",
+            full_name="google.datastore.v1.Datastore.Lookup",
+            index=0,
+            containing_service=None,
+            input_type=_LOOKUPREQUEST,
+            output_type=_LOOKUPRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002%" /v1/projects/{project_id}:lookup:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunQuery",
+            full_name="google.datastore.v1.Datastore.RunQuery",
+            index=1,
+            containing_service=None,
+            input_type=_RUNQUERYREQUEST,
+            output_type=_RUNQUERYRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\'""/v1/projects/{project_id}:runQuery:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BeginTransaction",
+            full_name="google.datastore.v1.Datastore.BeginTransaction",
+            index=2,
+            containing_service=None,
+            input_type=_BEGINTRANSACTIONREQUEST,
+            output_type=_BEGINTRANSACTIONRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002/"*/v1/projects/{project_id}:beginTransaction:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Commit",
+            full_name="google.datastore.v1.Datastore.Commit",
+            index=3,
+            containing_service=None,
+            input_type=_COMMITREQUEST,
+            output_type=_COMMITRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002%" /v1/projects/{project_id}:commit:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Rollback",
+            full_name="google.datastore.v1.Datastore.Rollback",
+            index=4,
+            containing_service=None,
+            input_type=_ROLLBACKREQUEST,
+            output_type=_ROLLBACKRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\'""/v1/projects/{project_id}:rollback:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AllocateIds",
+            full_name="google.datastore.v1.Datastore.AllocateIds",
+            index=5,
+            containing_service=None,
+            input_type=_ALLOCATEIDSREQUEST,
+            output_type=_ALLOCATEIDSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002*"%/v1/projects/{project_id}:allocateIds:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ReserveIds",
+            full_name="google.datastore.v1.Datastore.ReserveIds",
+            index=6,
+            containing_service=None,
+            input_type=_RESERVEIDSREQUEST,
+            output_type=_RESERVEIDSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v1/projects/{project_id}:reserveIds:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DATASTORE)
+
+DESCRIPTOR.services_by_name["Datastore"] = _DATASTORE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/datastore/google/cloud/datastore_v1/proto/datastore_pb2_grpc.py b/datastore/google/cloud/datastore_v1/proto/datastore_pb2_grpc.py
new file mode 100644
index 000000000000..5de1128a7c95
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/datastore_pb2_grpc.py
@@ -0,0 +1,166 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.datastore_v1.proto import (
+    datastore_pb2 as google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2,
+)
+
+
+class DatastoreStub(object):
+    """Each RPC normalizes the partition IDs of the keys in its input entities,
+  and always returns entities with keys with normalized partition IDs.
+  This applies to all keys and entities, including those in values, except keys
+  with both an empty path and an empty or unset partition ID. Normalization of
+  input keys sets the project ID (if not already set) to the project ID from
+  the request.
+
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.Lookup = channel.unary_unary(
+            "/google.datastore.v1.Datastore/Lookup",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.LookupRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.LookupResponse.FromString,
+        )
+        self.RunQuery = channel.unary_unary(
+            "/google.datastore.v1.Datastore/RunQuery",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RunQueryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RunQueryResponse.FromString,
+        )
+        self.BeginTransaction = channel.unary_unary(
+            "/google.datastore.v1.Datastore/BeginTransaction",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.BeginTransactionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.BeginTransactionResponse.FromString,
+        )
+        self.Commit = channel.unary_unary(
+            "/google.datastore.v1.Datastore/Commit",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.CommitRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.CommitResponse.FromString,
+        )
+        self.Rollback = channel.unary_unary(
+            "/google.datastore.v1.Datastore/Rollback",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RollbackRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RollbackResponse.FromString,
+        )
+        self.AllocateIds = channel.unary_unary(
+            "/google.datastore.v1.Datastore/AllocateIds",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.AllocateIdsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.AllocateIdsResponse.FromString,
+        )
+        self.ReserveIds = channel.unary_unary(
+            "/google.datastore.v1.Datastore/ReserveIds",
+            request_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.ReserveIdsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.ReserveIdsResponse.FromString,
+        )
+
+
+class DatastoreServicer(object):
+    """Each RPC normalizes the partition IDs of the keys in its input entities,
+  and always returns entities with keys with normalized partition IDs.
+  This applies to all keys and entities, including those in values, except keys
+  with both an empty path and an empty or unset partition ID. Normalization of
+  input keys sets the project ID (if not already set) to the project ID from
+  the request.
+
+  """
+
+    def Lookup(self, request, context):
+        """Looks up entities by key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunQuery(self, request, context):
+        """Queries for entities.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BeginTransaction(self, request, context):
+        """Begins a new transaction.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Commit(self, request, context):
+        """Commits a transaction, optionally creating, deleting or modifying some
+    entities.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Rollback(self, request, context):
+        """Rolls back a transaction.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AllocateIds(self, request, context):
+        """Allocates IDs for the given keys, which is useful for referencing an entity
+    before it is inserted.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ReserveIds(self, request, context):
+        """Prevents the supplied keys' IDs from being auto-allocated by Cloud
+    Datastore.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DatastoreServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "Lookup": grpc.unary_unary_rpc_method_handler(
+            servicer.Lookup,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.LookupRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.LookupResponse.SerializeToString,
+        ),
+        "RunQuery": grpc.unary_unary_rpc_method_handler(
+            servicer.RunQuery,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RunQueryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RunQueryResponse.SerializeToString,
+        ),
+        "BeginTransaction": grpc.unary_unary_rpc_method_handler(
+            servicer.BeginTransaction,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.BeginTransactionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.BeginTransactionResponse.SerializeToString,
+        ),
+        "Commit": grpc.unary_unary_rpc_method_handler(
+            servicer.Commit,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.CommitRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.CommitResponse.SerializeToString,
+        ),
+        "Rollback": grpc.unary_unary_rpc_method_handler(
+            servicer.Rollback,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RollbackRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.RollbackResponse.SerializeToString,
+        ),
+        "AllocateIds": grpc.unary_unary_rpc_method_handler(
+            servicer.AllocateIds,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.AllocateIdsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.AllocateIdsResponse.SerializeToString,
+        ),
+        "ReserveIds": grpc.unary_unary_rpc_method_handler(
+            servicer.ReserveIds,
+            request_deserializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.ReserveIdsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_datastore__v1_dot_proto_dot_datastore__pb2.ReserveIdsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.datastore.v1.Datastore", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/datastore/google/cloud/datastore_v1/proto/entity.proto b/datastore/google/cloud/datastore_v1/proto/entity.proto
new file mode 100644
index 000000000000..9decd2b53802
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/entity.proto
@@ -0,0 +1,204 @@
+// 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.datastore.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/latlng.proto";
+
+option csharp_namespace = "Google.Cloud.Datastore.V1";
+option go_package = "google.golang.org/genproto/googleapis/datastore/v1;datastore";
+option java_multiple_files = true;
+option java_outer_classname = "EntityProto";
+option java_package = "com.google.datastore.v1";
+option php_namespace = "Google\\Cloud\\Datastore\\V1";
+
+// A partition ID identifies a grouping of entities. The grouping is always
+// by project and namespace, however the namespace ID may be empty.
+//
+// A partition ID contains several dimensions:
+// project ID and namespace ID.
+//
+// Partition dimensions:
+//
+// - May be `""`.
+// - Must be valid UTF-8 bytes.
+// - Must have values that match regex `[A-Za-z\d\.\-_]{1,100}`
+// If the value of any dimension matches regex `__.*__`, the partition is
+// reserved/read-only.
+// A reserved/read-only partition ID is forbidden in certain documented
+// contexts.
+//
+// Foreign partition IDs (in which the project ID does
+// not match the context project ID ) are discouraged.
+// Reads and writes of foreign partition IDs may fail if the project is not in
+// an active state.
+message PartitionId {
+  // The ID of the project to which the entities belong.
+  string project_id = 2;
+
+  // If not empty, the ID of the namespace to which the entities belong.
+  string namespace_id = 4;
+}
+
+// A unique identifier for an entity.
+// If a key's partition ID or any of its path kinds or names are
+// reserved/read-only, the key is reserved/read-only.
+// A reserved/read-only key is forbidden in certain documented contexts.
+message Key {
+  // A (kind, ID/name) pair used to construct a key path.
+  //
+  // If either name or ID is set, the element is complete.
+  // If neither is set, the element is incomplete.
+  message PathElement {
+    // The kind of the entity.
+    // A kind matching regex `__.*__` is reserved/read-only.
+    // A kind must not contain more than 1500 bytes when UTF-8 encoded.
+    // Cannot be `""`.
+    string kind = 1;
+
+    // The type of ID.
+    oneof id_type {
+      // The auto-allocated ID of the entity.
+      // Never equal to zero. Values less than zero are discouraged and may not
+      // be supported in the future.
+      int64 id = 2;
+
+      // The name of the entity.
+      // A name matching regex `__.*__` is reserved/read-only.
+      // A name must not be more than 1500 bytes when UTF-8 encoded.
+      // Cannot be `""`.
+      string name = 3;
+    }
+  }
+
+  // Entities are partitioned into subsets, currently identified by a project
+  // ID and namespace ID.
+  // Queries are scoped to a single partition.
+  PartitionId partition_id = 1;
+
+  // The entity path.
+  // An entity path consists of one or more elements composed of a kind and a
+  // string or numerical identifier, which identify entities. The first
+  // element identifies a _root entity_, the second element identifies
+  // a _child_ of the root entity, the third element identifies a child of the
+  // second entity, and so forth. The entities identified by all prefixes of
+  // the path are called the element's _ancestors_.
+  //
+  // An entity path is always fully complete: *all* of the entity's ancestors
+  // are required to be in the path along with the entity identifier itself.
+  // The only exception is that in some documented cases, the identifier in the
+  // last path element (for the entity) itself may be omitted. For example,
+  // the last path element of the key of `Mutation.insert` may have no
+  // identifier.
+  //
+  // A path can never be empty, and a path can have at most 100 elements.
+  repeated PathElement path = 2;
+}
+
+// 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.
+  repeated Value values = 1;
+}
+
+// A message that can hold any of the supported value types and associated
+// metadata.
+message Value {
+  // Must have a value set.
+  oneof value_type {
+    // A null value.
+    google.protobuf.NullValue null_value = 11;
+
+    // A boolean value.
+    bool boolean_value = 1;
+
+    // An integer value.
+    int64 integer_value = 2;
+
+    // A double value.
+    double double_value = 3;
+
+    // A timestamp value.
+    // When stored in the Datastore, precise only to microseconds;
+    // any additional precision is rounded down.
+    google.protobuf.Timestamp timestamp_value = 10;
+
+    // A key 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.
+    string string_value = 17;
+
+    // A blob value.
+    // May have at most 1,000,000 bytes.
+    // When `exclude_from_indexes` is false, may have at most 1500 bytes.
+    // In JSON requests, must be base64-encoded.
+    bytes blob_value = 18;
+
+    // A geo point value representing a point on the surface of Earth.
+    google.type.LatLng geo_point_value = 8;
+
+    // An entity value.
+    //
+    // - May have no key.
+    // - May have a key with an incomplete key path.
+    // - May have a reserved/read-only key.
+    Entity entity_value = 6;
+
+    // An array value.
+    // Cannot contain another array value.
+    // A `Value` instance that sets field `array_value` must not set fields
+    // `meaning` or `exclude_from_indexes`.
+    ArrayValue array_value = 9;
+  }
+
+  // The `meaning` field should only be populated for backwards compatibility.
+  int32 meaning = 14;
+
+  // If the value should be excluded from all indexes including those defined
+  // explicitly.
+  bool exclude_from_indexes = 19;
+}
+
+// A Datastore data object.
+//
+// An entity is limited to 1 megabyte when stored. That _roughly_
+// corresponds to a limit of 1 megabyte for the serialized form of this
+// message.
+message Entity {
+  // The entity's key.
+  //
+  // An entity must have a key, unless otherwise documented (for example,
+  // an entity in `Value.entity_value` may have no key).
+  // An entity's kind is its key path's last element's kind,
+  // or null if it has no key.
+  Key key = 1;
+
+  // The entity's properties.
+  // The map's keys are property names.
+  // A property name matching regex `__.*__` is reserved.
+  // A reserved property name is forbidden in certain documented contexts.
+  // The name must not contain more than 500 characters.
+  // The name cannot be `""`.
+  map<string, Value> properties = 3;
+}
diff --git a/datastore/google/cloud/datastore_v1/proto/entity_pb2.py b/datastore/google/cloud/datastore_v1/proto/entity_pb2.py
new file mode 100644
index 000000000000..00ee58deadaf
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/entity_pb2.py
@@ -0,0 +1,972 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datastore_v1/proto/entity.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datastore_v1/proto/entity.proto",
+    package="google.datastore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.datastore.v1B\013EntityProtoP\001Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\252\002\031Google.Cloud.Datastore.V1\312\002\031Google\\Cloud\\Datastore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/datastore_v1/proto/entity.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x18google/type/latlng.proto"7\n\x0bPartitionId\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x14\n\x0cnamespace_id\x18\x04 \x01(\t"\xb7\x01\n\x03Key\x12\x36\n\x0cpartition_id\x18\x01 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x32\n\x04path\x18\x02 \x03(\x0b\x32$.google.datastore.v1.Key.PathElement\x1a\x44\n\x0bPathElement\x12\x0c\n\x04kind\x18\x01 \x01(\t\x12\x0c\n\x02id\x18\x02 \x01(\x03H\x00\x12\x0e\n\x04name\x18\x03 \x01(\tH\x00\x42\t\n\x07id_type"8\n\nArrayValue\x12*\n\x06values\x18\x01 \x03(\x0b\x32\x1a.google.datastore.v1.Value"\xf1\x03\n\x05Value\x12\x30\n\nnull_value\x18\x0b \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00\x12\x17\n\rboolean_value\x18\x01 \x01(\x08H\x00\x12\x17\n\rinteger_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x35\n\x0ftimestamp_value\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12-\n\tkey_value\x18\x05 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0cstring_value\x18\x11 \x01(\tH\x00\x12\x14\n\nblob_value\x18\x12 \x01(\x0cH\x00\x12.\n\x0fgeo_point_value\x18\x08 \x01(\x0b\x32\x13.google.type.LatLngH\x00\x12\x33\n\x0c\x65ntity_value\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12\x36\n\x0b\x61rray_value\x18\t \x01(\x0b\x32\x1f.google.datastore.v1.ArrayValueH\x00\x12\x0f\n\x07meaning\x18\x0e \x01(\x05\x12\x1c\n\x14\x65xclude_from_indexes\x18\x13 \x01(\x08\x42\x0c\n\nvalue_type"\xbf\x01\n\x06\x45ntity\x12%\n\x03key\x18\x01 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12?\n\nproperties\x18\x03 \x03(\x0b\x32+.google.datastore.v1.Entity.PropertiesEntry\x1aM\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12)\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Value:\x02\x38\x01\x42\x9e\x01\n\x17\x63om.google.datastore.v1B\x0b\x45ntityProtoP\x01Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_PARTITIONID = _descriptor.Descriptor(
+    name="PartitionId",
+    full_name="google.datastore.v1.PartitionId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.datastore.v1.PartitionId.project_id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="namespace_id",
+            full_name="google.datastore.v1.PartitionId.namespace_id",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=188,
+    serialized_end=243,
+)
+
+
+_KEY_PATHELEMENT = _descriptor.Descriptor(
+    name="PathElement",
+    full_name="google.datastore.v1.Key.PathElement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.datastore.v1.Key.PathElement.kind",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.datastore.v1.Key.PathElement.id",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.datastore.v1.Key.PathElement.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="id_type",
+            full_name="google.datastore.v1.Key.PathElement.id_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=361,
+    serialized_end=429,
+)
+
+_KEY = _descriptor.Descriptor(
+    name="Key",
+    full_name="google.datastore.v1.Key",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="partition_id",
+            full_name="google.datastore.v1.Key.partition_id",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.datastore.v1.Key.path",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_KEY_PATHELEMENT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=246,
+    serialized_end=429,
+)
+
+
+_ARRAYVALUE = _descriptor.Descriptor(
+    name="ArrayValue",
+    full_name="google.datastore.v1.ArrayValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.datastore.v1.ArrayValue.values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=431,
+    serialized_end=487,
+)
+
+
+_VALUE = _descriptor.Descriptor(
+    name="Value",
+    full_name="google.datastore.v1.Value",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="null_value",
+            full_name="google.datastore.v1.Value.null_value",
+            index=0,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boolean_value",
+            full_name="google.datastore.v1.Value.boolean_value",
+            index=1,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="integer_value",
+            full_name="google.datastore.v1.Value.integer_value",
+            index=2,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="double_value",
+            full_name="google.datastore.v1.Value.double_value",
+            index=3,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_value",
+            full_name="google.datastore.v1.Value.timestamp_value",
+            index=4,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_value",
+            full_name="google.datastore.v1.Value.key_value",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.datastore.v1.Value.string_value",
+            index=6,
+            number=17,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blob_value",
+            full_name="google.datastore.v1.Value.blob_value",
+            index=7,
+            number=18,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="geo_point_value",
+            full_name="google.datastore.v1.Value.geo_point_value",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entity_value",
+            full_name="google.datastore.v1.Value.entity_value",
+            index=9,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_value",
+            full_name="google.datastore.v1.Value.array_value",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="meaning",
+            full_name="google.datastore.v1.Value.meaning",
+            index=11,
+            number=14,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclude_from_indexes",
+            full_name="google.datastore.v1.Value.exclude_from_indexes",
+            index=12,
+            number=19,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value_type",
+            full_name="google.datastore.v1.Value.value_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=490,
+    serialized_end=987,
+)
+
+
+_ENTITY_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.datastore.v1.Entity.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.datastore.v1.Entity.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.datastore.v1.Entity.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1104,
+    serialized_end=1181,
+)
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.datastore.v1.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.datastore.v1.Entity.key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.datastore.v1.Entity.properties",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ENTITY_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=990,
+    serialized_end=1181,
+)
+
+_KEY_PATHELEMENT.containing_type = _KEY
+_KEY_PATHELEMENT.oneofs_by_name["id_type"].fields.append(
+    _KEY_PATHELEMENT.fields_by_name["id"]
+)
+_KEY_PATHELEMENT.fields_by_name[
+    "id"
+].containing_oneof = _KEY_PATHELEMENT.oneofs_by_name["id_type"]
+_KEY_PATHELEMENT.oneofs_by_name["id_type"].fields.append(
+    _KEY_PATHELEMENT.fields_by_name["name"]
+)
+_KEY_PATHELEMENT.fields_by_name[
+    "name"
+].containing_oneof = _KEY_PATHELEMENT.oneofs_by_name["id_type"]
+_KEY.fields_by_name["partition_id"].message_type = _PARTITIONID
+_KEY.fields_by_name["path"].message_type = _KEY_PATHELEMENT
+_ARRAYVALUE.fields_by_name["values"].message_type = _VALUE
+_VALUE.fields_by_name[
+    "null_value"
+].enum_type = google_dot_protobuf_dot_struct__pb2._NULLVALUE
+_VALUE.fields_by_name[
+    "timestamp_value"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VALUE.fields_by_name["key_value"].message_type = _KEY
+_VALUE.fields_by_name[
+    "geo_point_value"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_VALUE.fields_by_name["entity_value"].message_type = _ENTITY
+_VALUE.fields_by_name["array_value"].message_type = _ARRAYVALUE
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["null_value"])
+_VALUE.fields_by_name["null_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["boolean_value"]
+)
+_VALUE.fields_by_name["boolean_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["integer_value"]
+)
+_VALUE.fields_by_name["integer_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["double_value"])
+_VALUE.fields_by_name["double_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["timestamp_value"]
+)
+_VALUE.fields_by_name["timestamp_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["key_value"])
+_VALUE.fields_by_name["key_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["string_value"])
+_VALUE.fields_by_name["string_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["blob_value"])
+_VALUE.fields_by_name["blob_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["geo_point_value"]
+)
+_VALUE.fields_by_name["geo_point_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["entity_value"])
+_VALUE.fields_by_name["entity_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["array_value"])
+_VALUE.fields_by_name["array_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_ENTITY_PROPERTIESENTRY.fields_by_name["value"].message_type = _VALUE
+_ENTITY_PROPERTIESENTRY.containing_type = _ENTITY
+_ENTITY.fields_by_name["key"].message_type = _KEY
+_ENTITY.fields_by_name["properties"].message_type = _ENTITY_PROPERTIESENTRY
+DESCRIPTOR.message_types_by_name["PartitionId"] = _PARTITIONID
+DESCRIPTOR.message_types_by_name["Key"] = _KEY
+DESCRIPTOR.message_types_by_name["ArrayValue"] = _ARRAYVALUE
+DESCRIPTOR.message_types_by_name["Value"] = _VALUE
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+PartitionId = _reflection.GeneratedProtocolMessageType(
+    "PartitionId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTITIONID,
+        __module__="google.cloud.datastore_v1.proto.entity_pb2",
+        __doc__="""A partition ID identifies a grouping of entities. The grouping is always
+  by project and namespace, however the namespace ID may be empty.
+  
+  A partition ID contains several dimensions: project ID and namespace ID.
+  
+  Partition dimensions:
+  
+  -  May be ``""``.
+  -  Must be valid UTF-8 bytes.
+  -  Must have values that match regex ``[A-Za-z\d\.\-_]{1,100}`` If the
+     value of any dimension matches regex ``__.*__``, the partition is
+     reserved/read-only. A reserved/read-only partition ID is forbidden in
+     certain documented contexts.
+  
+  Foreign partition IDs (in which the project ID does not match the
+  context project ID ) are discouraged. Reads and writes of foreign
+  partition IDs may fail if the project is not in an active state.
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project to which the entities belong.
+      namespace_id:
+          If not empty, the ID of the namespace to which the entities
+          belong.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.PartitionId)
+    ),
+)
+_sym_db.RegisterMessage(PartitionId)
+
+Key = _reflection.GeneratedProtocolMessageType(
+    "Key",
+    (_message.Message,),
+    dict(
+        PathElement=_reflection.GeneratedProtocolMessageType(
+            "PathElement",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_KEY_PATHELEMENT,
+                __module__="google.cloud.datastore_v1.proto.entity_pb2",
+                __doc__="""A (kind, ID/name) pair used to construct a key path.
+    
+    If either name or ID is set, the element is complete. If neither is set,
+    the element is incomplete.
+    
+    
+    Attributes:
+        kind:
+            The kind of the entity. A kind matching regex ``__.*__`` is
+            reserved/read-only. A kind must not contain more than 1500
+            bytes when UTF-8 encoded. Cannot be ``""``.
+        id_type:
+            The type of ID.
+        id:
+            The auto-allocated ID of the entity. Never equal to zero.
+            Values less than zero are discouraged and may not be supported
+            in the future.
+        name:
+            The name of the entity. A name matching regex ``__.*__`` is
+            reserved/read-only. A name must not be more than 1500 bytes
+            when UTF-8 encoded. Cannot be ``""``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.datastore.v1.Key.PathElement)
+            ),
+        ),
+        DESCRIPTOR=_KEY,
+        __module__="google.cloud.datastore_v1.proto.entity_pb2",
+        __doc__="""A unique identifier for an entity. If a key's partition ID or any of its
+  path kinds or names are reserved/read-only, the key is
+  reserved/read-only. A reserved/read-only key is forbidden in certain
+  documented contexts.
+  
+  
+  Attributes:
+      partition_id:
+          Entities are partitioned into subsets, currently identified by
+          a project ID and namespace ID. Queries are scoped to a single
+          partition.
+      path:
+          The entity path. An entity path consists of one or more
+          elements composed of a kind and a string or numerical
+          identifier, which identify entities. The first element
+          identifies a *root entity*, the second element identifies a
+          *child* of the root entity, the third element identifies a
+          child of the second entity, and so forth. The entities
+          identified by all prefixes of the path are called the
+          element's *ancestors*.  An entity path is always fully
+          complete: *all* of the entity's ancestors are required to be
+          in the path along with the entity identifier itself. The only
+          exception is that in some documented cases, the identifier in
+          the last path element (for the entity) itself may be omitted.
+          For example, the last path element of the key of
+          ``Mutation.insert`` may have no identifier.  A path can never
+          be empty, and a path can have at most 100 elements.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Key)
+    ),
+)
+_sym_db.RegisterMessage(Key)
+_sym_db.RegisterMessage(Key.PathElement)
+
+ArrayValue = _reflection.GeneratedProtocolMessageType(
+    "ArrayValue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARRAYVALUE,
+        __module__="google.cloud.datastore_v1.proto.entity_pb2",
+        __doc__="""An array value.
+  
+  
+  Attributes:
+      values:
+          Values in the array. The order of this array may not be
+          preserved if it contains a mix of indexed and unindexed
+          values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.ArrayValue)
+    ),
+)
+_sym_db.RegisterMessage(ArrayValue)
+
+Value = _reflection.GeneratedProtocolMessageType(
+    "Value",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUE,
+        __module__="google.cloud.datastore_v1.proto.entity_pb2",
+        __doc__="""A message that can hold any of the supported value types and associated
+  metadata.
+  
+  
+  Attributes:
+      value_type:
+          Must have a value set.
+      null_value:
+          A null value.
+      boolean_value:
+          A boolean value.
+      integer_value:
+          An integer value.
+      double_value:
+          A double value.
+      timestamp_value:
+          A timestamp value. When stored in the Datastore, precise only
+          to microseconds; any additional precision is rounded down.
+      key_value:
+          A key value.
+      string_value:
+          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.
+      blob_value:
+          A blob value. May have at most 1,000,000 bytes. When
+          ``exclude_from_indexes`` is false, may have at most 1500
+          bytes. In JSON requests, must be base64-encoded.
+      geo_point_value:
+          A geo point value representing a point on the surface of
+          Earth.
+      entity_value:
+          An entity value.  -  May have no key. -  May have a key with
+          an incomplete key path. -  May have a reserved/read-only key.
+      array_value:
+          An array value. Cannot contain another array value. A
+          ``Value`` instance that sets field ``array_value`` must not
+          set fields ``meaning`` or ``exclude_from_indexes``.
+      meaning:
+          The ``meaning`` field should only be populated for backwards
+          compatibility.
+      exclude_from_indexes:
+          If the value should be excluded from all indexes including
+          those defined explicitly.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Value)
+    ),
+)
+_sym_db.RegisterMessage(Value)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ENTITY_PROPERTIESENTRY,
+                __module__="google.cloud.datastore_v1.proto.entity_pb2"
+                # @@protoc_insertion_point(class_scope:google.datastore.v1.Entity.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.datastore_v1.proto.entity_pb2",
+        __doc__="""A Datastore data object.
+  
+  An entity is limited to 1 megabyte when stored. That *roughly*
+  corresponds to a limit of 1 megabyte for the serialized form of this
+  message.
+  
+  
+  Attributes:
+      key:
+          The entity's key.  An entity must have a key, unless otherwise
+          documented (for example, an entity in ``Value.entity_value``
+          may have no key). An entity's kind is its key path's last
+          element's kind, or null if it has no key.
+      properties:
+          The entity's properties. The map's keys are property names. A
+          property name matching regex ``__.*__`` is reserved. A
+          reserved property name is forbidden in certain documented
+          contexts. The name must not contain more than 500 characters.
+          The name cannot be ``""``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+_sym_db.RegisterMessage(Entity.PropertiesEntry)
+
+
+DESCRIPTOR._options = None
+_ENTITY_PROPERTIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datastore/google/cloud/datastore_v1/proto/entity_pb2_grpc.py b/datastore/google/cloud/datastore_v1/proto/entity_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/entity_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datastore/google/cloud/datastore_v1/proto/index.proto b/datastore/google/cloud/datastore_v1/proto/index.proto
new file mode 100644
index 000000000000..15013d557ea2
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/index.proto
@@ -0,0 +1,122 @@
+// 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.datastore.admin.v1;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Datastore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/datastore/admin/v1;admin";
+option java_multiple_files = true;
+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
+  message IndexedProperty {
+    // The property name to index.
+    // Required.
+    string name = 1;
+
+    // The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+    // Required.
+    Direction direction = 2;
+  }
+
+  // For an ordered index, specifies whether each of the entity's ancestors
+  // will be included.
+  enum AncestorMode {
+    // The ancestor mode is unspecified.
+    ANCESTOR_MODE_UNSPECIFIED = 0;
+
+    // Do not include the entity's ancestors in the index.
+    NONE = 1;
+
+    // Include all the entity's ancestors in the index.
+    ALL_ANCESTORS = 2;
+  }
+
+  // The direction determines how a property is indexed.
+  enum Direction {
+    // The direction is unspecified.
+    DIRECTION_UNSPECIFIED = 0;
+
+    // The property's values are indexed so as to support sequencing in
+    // ascending order and also query by <, >, <=, >=, and =.
+    ASCENDING = 1;
+
+    // The property's values are indexed so as to support sequencing in
+    // descending order and also query by <, >, <=, >=, and =.
+    DESCENDING = 2;
+  }
+
+  // The possible set of states of an index.
+  enum State {
+    // The state is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // The index is being created, and cannot be used by queries.
+    // There is an active long-running operation for the index.
+    // The index is updated when writing an entity.
+    // Some index data may exist.
+    CREATING = 1;
+
+    // The index is ready to be used.
+    // The index is updated when writing an entity.
+    // The index is fully populated from all stored entities it applies to.
+    READY = 2;
+
+    // The index is being deleted, and cannot be used by queries.
+    // There is an active long-running operation for the index.
+    // The index is not updated when writing an entity.
+    // Some index data may exist.
+    DELETING = 3;
+
+    // The index was being created or deleted, but something went wrong.
+    // The index cannot by used by queries.
+    // There is no active long-running operation for the index,
+    // and the most recently finished long-running operation failed.
+    // The index is not updated when writing an entity.
+    // Some index data may exist.
+    ERROR = 4;
+  }
+
+  // Project ID.
+  // Output only.
+  string project_id = 1;
+
+  // The resource ID of the index.
+  // Output only.
+  string index_id = 3;
+
+  // The entity kind to which this index applies.
+  // Required.
+  string kind = 4;
+
+  // The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+  // Required.
+  AncestorMode ancestor = 5;
+
+  // An ordered sequence of property names and their index attributes.
+  // Required.
+  repeated IndexedProperty properties = 6;
+
+  // The state of the index.
+  // Output only.
+  State state = 7;
+}
diff --git a/datastore/google/cloud/datastore_v1/proto/query.proto b/datastore/google/cloud/datastore_v1/proto/query.proto
new file mode 100644
index 000000000000..872612c5dd24
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/query.proto
@@ -0,0 +1,312 @@
+// 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.datastore.v1;
+
+import "google/api/annotations.proto";
+import "google/datastore/v1/entity.proto";
+import "google/protobuf/wrappers.proto";
+import "google/type/latlng.proto";
+
+option csharp_namespace = "Google.Cloud.Datastore.V1";
+option go_package = "google.golang.org/genproto/googleapis/datastore/v1;datastore";
+option java_multiple_files = true;
+option java_outer_classname = "QueryProto";
+option java_package = "com.google.datastore.v1";
+option php_namespace = "Google\\Cloud\\Datastore\\V1";
+
+// The result of fetching an entity from Datastore.
+message EntityResult {
+  // Specifies what data the 'entity' field contains.
+  // A `ResultType` is either implied (for example, in `LookupResponse.missing`
+  // from `datastore.proto`, it is always `KEY_ONLY`) or specified by context
+  // (for example, in message `QueryResultBatch`, field `entity_result_type`
+  // specifies a `ResultType` for all the values in field `entity_results`).
+  enum ResultType {
+    // Unspecified. This value is never used.
+    RESULT_TYPE_UNSPECIFIED = 0;
+
+    // The key and properties.
+    FULL = 1;
+
+    // A projected subset of properties. The entity may have no key.
+    PROJECTION = 2;
+
+    // Only the key.
+    KEY_ONLY = 3;
+  }
+
+  // The resulting entity.
+  Entity entity = 1;
+
+  // 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.
+  //
+  // 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.
+  // Set only when the `EntityResult` is part of a `QueryResultBatch` message.
+  bytes cursor = 3;
+}
+
+// A query for entities.
+message Query {
+  // The projection to return. Defaults to returning all properties.
+  repeated Projection projection = 2;
+
+  // The kinds to query (if empty, returns entities of all kinds).
+  // Currently at most 1 kind may be specified.
+  repeated KindExpression kind = 3;
+
+  // The filter to apply.
+  Filter filter = 4;
+
+  // The order to apply to the query results (if empty, order is unspecified).
+  repeated PropertyOrder order = 5;
+
+  // The properties to make distinct. The query results will contain the first
+  // result for each distinct combination of values for the given properties
+  // (if empty, all results are returned).
+  repeated PropertyReference distinct_on = 6;
+
+  // A starting point for the query results. Query cursors are
+  // returned in query result batches and
+  // [can only be used to continue the same
+  // query](https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets).
+  bytes start_cursor = 7;
+
+  // An ending point for the query results. Query cursors are
+  // returned in query result batches and
+  // [can only be used to limit the same
+  // query](https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets).
+  bytes end_cursor = 8;
+
+  // The number of results to skip. Applies before limit, but after all other
+  // constraints. Optional. Must be >= 0 if specified.
+  int32 offset = 10;
+
+  // The maximum number of results to return. Applies after all other
+  // constraints. Optional.
+  // Unspecified is interpreted as no limit.
+  // Must be >= 0 if specified.
+  google.protobuf.Int32Value limit = 12;
+}
+
+// A representation of a kind.
+message KindExpression {
+  // The name of the kind.
+  string name = 1;
+}
+
+// A reference to a property relative to the kind expressions.
+message PropertyReference {
+  // The name of the property.
+  // If name includes "."s, it may be interpreted as a property name path.
+  string name = 2;
+}
+
+// A representation of a property in a projection.
+message Projection {
+  // The property to project.
+  PropertyReference property = 1;
+}
+
+// The desired order for a specific property.
+message PropertyOrder {
+  // The sort direction.
+  enum Direction {
+    // Unspecified. This value must not be used.
+    DIRECTION_UNSPECIFIED = 0;
+
+    // Ascending.
+    ASCENDING = 1;
+
+    // Descending.
+    DESCENDING = 2;
+  }
+
+  // The property to order by.
+  PropertyReference property = 1;
+
+  // The direction to order by. Defaults to `ASCENDING`.
+  Direction direction = 2;
+}
+
+// A holder for any type of filter.
+message Filter {
+  // The type of filter.
+  oneof filter_type {
+    // A composite filter.
+    CompositeFilter composite_filter = 1;
+
+    // A filter on a property.
+    PropertyFilter property_filter = 2;
+  }
+}
+
+// A filter that merges multiple other filters using the given operator.
+message CompositeFilter {
+  // A composite filter operator.
+  enum Operator {
+    // Unspecified. This value must not be used.
+    OPERATOR_UNSPECIFIED = 0;
+
+    // The results are required to satisfy each of the combined filters.
+    AND = 1;
+  }
+
+  // The operator for combining multiple filters.
+  Operator op = 1;
+
+  // The list of filters to combine.
+  // Must contain at least one filter.
+  repeated Filter filters = 2;
+}
+
+// A filter on a specific property.
+message PropertyFilter {
+  // A property filter operator.
+  enum Operator {
+    // Unspecified. This value must not be used.
+    OPERATOR_UNSPECIFIED = 0;
+
+    // Less than.
+    LESS_THAN = 1;
+
+    // Less than or equal.
+    LESS_THAN_OR_EQUAL = 2;
+
+    // Greater than.
+    GREATER_THAN = 3;
+
+    // Greater than or equal.
+    GREATER_THAN_OR_EQUAL = 4;
+
+    // Equal.
+    EQUAL = 5;
+
+    // Has ancestor.
+    HAS_ANCESTOR = 11;
+  }
+
+  // The property to filter by.
+  PropertyReference property = 1;
+
+  // The operator to filter by.
+  Operator op = 2;
+
+  // The value to compare the property to.
+  Value value = 3;
+}
+
+// A [GQL
+// query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
+message GqlQuery {
+  // A string of the format described
+  // [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
+  string query_string = 1;
+
+  // When false, the query string must not contain any literals and instead must
+  // bind all values. For example,
+  // `SELECT * FROM Kind WHERE a = 'string literal'` is not allowed, while
+  // `SELECT * FROM Kind WHERE a = @value` is.
+  bool allow_literals = 2;
+
+  // For each non-reserved named binding site in the query string, there must be
+  // a named parameter with that name, but not necessarily the inverse.
+  //
+  // Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
+  // `__.*__`, and must not be `""`.
+  map<string, GqlQueryParameter> named_bindings = 5;
+
+  // Numbered binding site @1 references the first numbered parameter,
+  // effectively using 1-based indexing, rather than the usual 0.
+  //
+  // For each binding site numbered i in `query_string`, there must be an i-th
+  // numbered parameter. The inverse must also be true.
+  repeated GqlQueryParameter positional_bindings = 4;
+}
+
+// A binding parameter for a GQL query.
+message GqlQueryParameter {
+  // The type of parameter.
+  oneof parameter_type {
+    // A value parameter.
+    Value value = 2;
+
+    // A query cursor. Query cursors are returned in query
+    // result batches.
+    bytes cursor = 3;
+  }
+}
+
+// A batch of results produced by a query.
+message QueryResultBatch {
+  // The possible values for the `more_results` field.
+  enum MoreResultsType {
+    // Unspecified. This value is never used.
+    MORE_RESULTS_TYPE_UNSPECIFIED = 0;
+
+    // There may be additional batches to fetch from this query.
+    NOT_FINISHED = 1;
+
+    // The query is finished, but there may be more results after the limit.
+    MORE_RESULTS_AFTER_LIMIT = 2;
+
+    // The query is finished, but there may be more results after the end
+    // cursor.
+    MORE_RESULTS_AFTER_CURSOR = 4;
+
+    // The query is finished, and there are no more results.
+    NO_MORE_RESULTS = 3;
+  }
+
+  // The number of results skipped, typically because of an offset.
+  int32 skipped_results = 6;
+
+  // A cursor that points to the position after the last skipped result.
+  // Will be set when `skipped_results` != 0.
+  bytes skipped_cursor = 3;
+
+  // The result type for every entity in `entity_results`.
+  EntityResult.ResultType entity_result_type = 1;
+
+  // The results for this batch.
+  repeated EntityResult entity_results = 2;
+
+  // A cursor that points to the position after the last result in the batch.
+  bytes end_cursor = 4;
+
+  // The state of the query after the current batch.
+  MoreResultsType more_results = 5;
+
+  // The version number of the snapshot this batch was returned from.
+  // This applies to the range of results from the query's `start_cursor` (or
+  // the beginning of the query if no cursor was given) to this batch's
+  // `end_cursor` (not the query's `end_cursor`).
+  //
+  // In a single transaction, subsequent query result batches for the same query
+  // can have a greater snapshot version number. Each batch's snapshot version
+  // is valid for all preceding batches.
+  // The value will be zero for eventually consistent queries.
+  int64 snapshot_version = 7;
+}
diff --git a/datastore/google/cloud/datastore_v1/proto/query_pb2.py b/datastore/google/cloud/datastore_v1/proto/query_pb2.py
new file mode 100644
index 000000000000..50a68509948a
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/query_pb2.py
@@ -0,0 +1,1622 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datastore_v1/proto/query.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.datastore_v1.proto import (
+    entity_pb2 as google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2,
+)
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/datastore_v1/proto/query.proto",
+    package="google.datastore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.datastore.v1B\nQueryProtoP\001Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\252\002\031Google.Cloud.Datastore.V1\312\002\031Google\\Cloud\\Datastore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/datastore_v1/proto/query.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a,google/cloud/datastore_v1/proto/entity.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x18google/type/latlng.proto"\xaf\x01\n\x0c\x45ntityResult\x12+\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x1b.google.datastore.v1.Entity\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12\x0e\n\x06\x63ursor\x18\x03 \x01(\x0c"Q\n\nResultType\x12\x1b\n\x17RESULT_TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x46ULL\x10\x01\x12\x0e\n\nPROJECTION\x10\x02\x12\x0c\n\x08KEY_ONLY\x10\x03"\xf2\x02\n\x05Query\x12\x33\n\nprojection\x18\x02 \x03(\x0b\x32\x1f.google.datastore.v1.Projection\x12\x31\n\x04kind\x18\x03 \x03(\x0b\x32#.google.datastore.v1.KindExpression\x12+\n\x06\x66ilter\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.Filter\x12\x31\n\x05order\x18\x05 \x03(\x0b\x32".google.datastore.v1.PropertyOrder\x12;\n\x0b\x64istinct_on\x18\x06 \x03(\x0b\x32&.google.datastore.v1.PropertyReference\x12\x14\n\x0cstart_cursor\x18\x07 \x01(\x0c\x12\x12\n\nend_cursor\x18\x08 \x01(\x0c\x12\x0e\n\x06offset\x18\n \x01(\x05\x12*\n\x05limit\x18\x0c \x01(\x0b\x32\x1b.google.protobuf.Int32Value"\x1e\n\x0eKindExpression\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11PropertyReference\x12\x0c\n\x04name\x18\x02 \x01(\t"F\n\nProjection\x12\x38\n\x08property\x18\x01 \x01(\x0b\x32&.google.datastore.v1.PropertyReference"\xd1\x01\n\rPropertyOrder\x12\x38\n\x08property\x18\x01 \x01(\x0b\x32&.google.datastore.v1.PropertyReference\x12?\n\tdirection\x18\x02 \x01(\x0e\x32,.google.datastore.v1.PropertyOrder.Direction"E\n\tDirection\x12\x19\n\x15\x44IRECTION_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x01\x12\x0e\n\nDESCENDING\x10\x02"\x99\x01\n\x06\x46ilter\x12@\n\x10\x63omposite_filter\x18\x01 \x01(\x0b\x32$.google.datastore.v1.CompositeFilterH\x00\x12>\n\x0fproperty_filter\x18\x02 \x01(\x0b\x32#.google.datastore.v1.PropertyFilterH\x00\x42\r\n\x0b\x66ilter_type"\xa9\x01\n\x0f\x43ompositeFilter\x12\x39\n\x02op\x18\x01 \x01(\x0e\x32-.google.datastore.v1.CompositeFilter.Operator\x12,\n\x07\x66ilters\x18\x02 \x03(\x0b\x32\x1b.google.datastore.v1.Filter"-\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01"\xc7\x02\n\x0ePropertyFilter\x12\x38\n\x08property\x18\x01 \x01(\x0b\x32&.google.datastore.v1.PropertyReference\x12\x38\n\x02op\x18\x02 \x01(\x0e\x32,.google.datastore.v1.PropertyFilter.Operator\x12)\n\x05value\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.Value"\x95\x01\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\r\n\tLESS_THAN\x10\x01\x12\x16\n\x12LESS_THAN_OR_EQUAL\x10\x02\x12\x10\n\x0cGREATER_THAN\x10\x03\x12\x19\n\x15GREATER_THAN_OR_EQUAL\x10\x04\x12\t\n\x05\x45QUAL\x10\x05\x12\x10\n\x0cHAS_ANCESTOR\x10\x0b"\xa5\x02\n\x08GqlQuery\x12\x14\n\x0cquery_string\x18\x01 \x01(\t\x12\x16\n\x0e\x61llow_literals\x18\x02 \x01(\x08\x12H\n\x0enamed_bindings\x18\x05 \x03(\x0b\x32\x30.google.datastore.v1.GqlQuery.NamedBindingsEntry\x12\x43\n\x13positional_bindings\x18\x04 \x03(\x0b\x32&.google.datastore.v1.GqlQueryParameter\x1a\\\n\x12NamedBindingsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x35\n\x05value\x18\x02 \x01(\x0b\x32&.google.datastore.v1.GqlQueryParameter:\x02\x38\x01"d\n\x11GqlQueryParameter\x12+\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12\x10\n\x06\x63ursor\x18\x03 \x01(\x0cH\x00\x42\x10\n\x0eparameter_type"\xde\x03\n\x10QueryResultBatch\x12\x17\n\x0fskipped_results\x18\x06 \x01(\x05\x12\x16\n\x0eskipped_cursor\x18\x03 \x01(\x0c\x12H\n\x12\x65ntity_result_type\x18\x01 \x01(\x0e\x32,.google.datastore.v1.EntityResult.ResultType\x12\x39\n\x0e\x65ntity_results\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x12\n\nend_cursor\x18\x04 \x01(\x0c\x12K\n\x0cmore_results\x18\x05 \x01(\x0e\x32\x35.google.datastore.v1.QueryResultBatch.MoreResultsType\x12\x18\n\x10snapshot_version\x18\x07 \x01(\x03"\x98\x01\n\x0fMoreResultsType\x12!\n\x1dMORE_RESULTS_TYPE_UNSPECIFIED\x10\x00\x12\x10\n\x0cNOT_FINISHED\x10\x01\x12\x1c\n\x18MORE_RESULTS_AFTER_LIMIT\x10\x02\x12\x1d\n\x19MORE_RESULTS_AFTER_CURSOR\x10\x04\x12\x13\n\x0fNO_MORE_RESULTS\x10\x03\x42\x9d\x01\n\x17\x63om.google.datastore.v1B\nQueryProtoP\x01Z<google.golang.org/genproto/googleapis/datastore/v1;datastore\xaa\x02\x19Google.Cloud.Datastore.V1\xca\x02\x19Google\\Cloud\\Datastore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_ENTITYRESULT_RESULTTYPE = _descriptor.EnumDescriptor(
+    name="ResultType",
+    full_name="google.datastore.v1.EntityResult.ResultType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RESULT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROJECTION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KEY_ONLY", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=297,
+    serialized_end=378,
+)
+_sym_db.RegisterEnumDescriptor(_ENTITYRESULT_RESULTTYPE)
+
+_PROPERTYORDER_DIRECTION = _descriptor.EnumDescriptor(
+    name="Direction",
+    full_name="google.datastore.v1.PropertyOrder.Direction",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DIRECTION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASCENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESCENDING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1033,
+    serialized_end=1102,
+)
+_sym_db.RegisterEnumDescriptor(_PROPERTYORDER_DIRECTION)
+
+_COMPOSITEFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.datastore.v1.CompositeFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AND", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1385,
+    serialized_end=1430,
+)
+_sym_db.RegisterEnumDescriptor(_COMPOSITEFILTER_OPERATOR)
+
+_PROPERTYFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.datastore.v1.PropertyFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN_OR_EQUAL",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN_OR_EQUAL",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EQUAL", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HAS_ANCESTOR", index=6, number=11, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1611,
+    serialized_end=1760,
+)
+_sym_db.RegisterEnumDescriptor(_PROPERTYFILTER_OPERATOR)
+
+_QUERYRESULTBATCH_MORERESULTSTYPE = _descriptor.EnumDescriptor(
+    name="MoreResultsType",
+    full_name="google.datastore.v1.QueryResultBatch.MoreResultsType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MORE_RESULTS_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOT_FINISHED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MORE_RESULTS_AFTER_LIMIT",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MORE_RESULTS_AFTER_CURSOR",
+            index=3,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NO_MORE_RESULTS",
+            index=4,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2487,
+    serialized_end=2639,
+)
+_sym_db.RegisterEnumDescriptor(_QUERYRESULTBATCH_MORERESULTSTYPE)
+
+
+_ENTITYRESULT = _descriptor.Descriptor(
+    name="EntityResult",
+    full_name="google.datastore.v1.EntityResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.datastore.v1.EntityResult.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.datastore.v1.EntityResult.version",
+            index=1,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cursor",
+            full_name="google.datastore.v1.EntityResult.cursor",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ENTITYRESULT_RESULTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=203,
+    serialized_end=378,
+)
+
+
+_QUERY = _descriptor.Descriptor(
+    name="Query",
+    full_name="google.datastore.v1.Query",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="projection",
+            full_name="google.datastore.v1.Query.projection",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.datastore.v1.Query.kind",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.datastore.v1.Query.filter",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order",
+            full_name="google.datastore.v1.Query.order",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distinct_on",
+            full_name="google.datastore.v1.Query.distinct_on",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_cursor",
+            full_name="google.datastore.v1.Query.start_cursor",
+            index=5,
+            number=7,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_cursor",
+            full_name="google.datastore.v1.Query.end_cursor",
+            index=6,
+            number=8,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.datastore.v1.Query.offset",
+            index=7,
+            number=10,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="google.datastore.v1.Query.limit",
+            index=8,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=381,
+    serialized_end=751,
+)
+
+
+_KINDEXPRESSION = _descriptor.Descriptor(
+    name="KindExpression",
+    full_name="google.datastore.v1.KindExpression",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.datastore.v1.KindExpression.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=753,
+    serialized_end=783,
+)
+
+
+_PROPERTYREFERENCE = _descriptor.Descriptor(
+    name="PropertyReference",
+    full_name="google.datastore.v1.PropertyReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.datastore.v1.PropertyReference.name",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=785,
+    serialized_end=818,
+)
+
+
+_PROJECTION = _descriptor.Descriptor(
+    name="Projection",
+    full_name="google.datastore.v1.Projection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.datastore.v1.Projection.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=820,
+    serialized_end=890,
+)
+
+
+_PROPERTYORDER = _descriptor.Descriptor(
+    name="PropertyOrder",
+    full_name="google.datastore.v1.PropertyOrder",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.datastore.v1.PropertyOrder.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="direction",
+            full_name="google.datastore.v1.PropertyOrder.direction",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_PROPERTYORDER_DIRECTION],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=893,
+    serialized_end=1102,
+)
+
+
+_FILTER = _descriptor.Descriptor(
+    name="Filter",
+    full_name="google.datastore.v1.Filter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="composite_filter",
+            full_name="google.datastore.v1.Filter.composite_filter",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="property_filter",
+            full_name="google.datastore.v1.Filter.property_filter",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="filter_type",
+            full_name="google.datastore.v1.Filter.filter_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1105,
+    serialized_end=1258,
+)
+
+
+_COMPOSITEFILTER = _descriptor.Descriptor(
+    name="CompositeFilter",
+    full_name="google.datastore.v1.CompositeFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.datastore.v1.CompositeFilter.op",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filters",
+            full_name="google.datastore.v1.CompositeFilter.filters",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_COMPOSITEFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1261,
+    serialized_end=1430,
+)
+
+
+_PROPERTYFILTER = _descriptor.Descriptor(
+    name="PropertyFilter",
+    full_name="google.datastore.v1.PropertyFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.datastore.v1.PropertyFilter.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.datastore.v1.PropertyFilter.op",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.datastore.v1.PropertyFilter.value",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_PROPERTYFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1433,
+    serialized_end=1760,
+)
+
+
+_GQLQUERY_NAMEDBINDINGSENTRY = _descriptor.Descriptor(
+    name="NamedBindingsEntry",
+    full_name="google.datastore.v1.GqlQuery.NamedBindingsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.datastore.v1.GqlQuery.NamedBindingsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.datastore.v1.GqlQuery.NamedBindingsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1964,
+    serialized_end=2056,
+)
+
+_GQLQUERY = _descriptor.Descriptor(
+    name="GqlQuery",
+    full_name="google.datastore.v1.GqlQuery",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_string",
+            full_name="google.datastore.v1.GqlQuery.query_string",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_literals",
+            full_name="google.datastore.v1.GqlQuery.allow_literals",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="named_bindings",
+            full_name="google.datastore.v1.GqlQuery.named_bindings",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="positional_bindings",
+            full_name="google.datastore.v1.GqlQuery.positional_bindings",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GQLQUERY_NAMEDBINDINGSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1763,
+    serialized_end=2056,
+)
+
+
+_GQLQUERYPARAMETER = _descriptor.Descriptor(
+    name="GqlQueryParameter",
+    full_name="google.datastore.v1.GqlQueryParameter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.datastore.v1.GqlQueryParameter.value",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cursor",
+            full_name="google.datastore.v1.GqlQueryParameter.cursor",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="parameter_type",
+            full_name="google.datastore.v1.GqlQueryParameter.parameter_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2058,
+    serialized_end=2158,
+)
+
+
+_QUERYRESULTBATCH = _descriptor.Descriptor(
+    name="QueryResultBatch",
+    full_name="google.datastore.v1.QueryResultBatch",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="skipped_results",
+            full_name="google.datastore.v1.QueryResultBatch.skipped_results",
+            index=0,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skipped_cursor",
+            full_name="google.datastore.v1.QueryResultBatch.skipped_cursor",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entity_result_type",
+            full_name="google.datastore.v1.QueryResultBatch.entity_result_type",
+            index=2,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entity_results",
+            full_name="google.datastore.v1.QueryResultBatch.entity_results",
+            index=3,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_cursor",
+            full_name="google.datastore.v1.QueryResultBatch.end_cursor",
+            index=4,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="more_results",
+            full_name="google.datastore.v1.QueryResultBatch.more_results",
+            index=5,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="snapshot_version",
+            full_name="google.datastore.v1.QueryResultBatch.snapshot_version",
+            index=6,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_QUERYRESULTBATCH_MORERESULTSTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2161,
+    serialized_end=2639,
+)
+
+_ENTITYRESULT.fields_by_name[
+    "entity"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._ENTITY
+_ENTITYRESULT_RESULTTYPE.containing_type = _ENTITYRESULT
+_QUERY.fields_by_name["projection"].message_type = _PROJECTION
+_QUERY.fields_by_name["kind"].message_type = _KINDEXPRESSION
+_QUERY.fields_by_name["filter"].message_type = _FILTER
+_QUERY.fields_by_name["order"].message_type = _PROPERTYORDER
+_QUERY.fields_by_name["distinct_on"].message_type = _PROPERTYREFERENCE
+_QUERY.fields_by_name[
+    "limit"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_PROJECTION.fields_by_name["property"].message_type = _PROPERTYREFERENCE
+_PROPERTYORDER.fields_by_name["property"].message_type = _PROPERTYREFERENCE
+_PROPERTYORDER.fields_by_name["direction"].enum_type = _PROPERTYORDER_DIRECTION
+_PROPERTYORDER_DIRECTION.containing_type = _PROPERTYORDER
+_FILTER.fields_by_name["composite_filter"].message_type = _COMPOSITEFILTER
+_FILTER.fields_by_name["property_filter"].message_type = _PROPERTYFILTER
+_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _FILTER.fields_by_name["composite_filter"]
+)
+_FILTER.fields_by_name["composite_filter"].containing_oneof = _FILTER.oneofs_by_name[
+    "filter_type"
+]
+_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _FILTER.fields_by_name["property_filter"]
+)
+_FILTER.fields_by_name["property_filter"].containing_oneof = _FILTER.oneofs_by_name[
+    "filter_type"
+]
+_COMPOSITEFILTER.fields_by_name["op"].enum_type = _COMPOSITEFILTER_OPERATOR
+_COMPOSITEFILTER.fields_by_name["filters"].message_type = _FILTER
+_COMPOSITEFILTER_OPERATOR.containing_type = _COMPOSITEFILTER
+_PROPERTYFILTER.fields_by_name["property"].message_type = _PROPERTYREFERENCE
+_PROPERTYFILTER.fields_by_name["op"].enum_type = _PROPERTYFILTER_OPERATOR
+_PROPERTYFILTER.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._VALUE
+_PROPERTYFILTER_OPERATOR.containing_type = _PROPERTYFILTER
+_GQLQUERY_NAMEDBINDINGSENTRY.fields_by_name["value"].message_type = _GQLQUERYPARAMETER
+_GQLQUERY_NAMEDBINDINGSENTRY.containing_type = _GQLQUERY
+_GQLQUERY.fields_by_name["named_bindings"].message_type = _GQLQUERY_NAMEDBINDINGSENTRY
+_GQLQUERY.fields_by_name["positional_bindings"].message_type = _GQLQUERYPARAMETER
+_GQLQUERYPARAMETER.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_datastore__v1_dot_proto_dot_entity__pb2._VALUE
+_GQLQUERYPARAMETER.oneofs_by_name["parameter_type"].fields.append(
+    _GQLQUERYPARAMETER.fields_by_name["value"]
+)
+_GQLQUERYPARAMETER.fields_by_name[
+    "value"
+].containing_oneof = _GQLQUERYPARAMETER.oneofs_by_name["parameter_type"]
+_GQLQUERYPARAMETER.oneofs_by_name["parameter_type"].fields.append(
+    _GQLQUERYPARAMETER.fields_by_name["cursor"]
+)
+_GQLQUERYPARAMETER.fields_by_name[
+    "cursor"
+].containing_oneof = _GQLQUERYPARAMETER.oneofs_by_name["parameter_type"]
+_QUERYRESULTBATCH.fields_by_name[
+    "entity_result_type"
+].enum_type = _ENTITYRESULT_RESULTTYPE
+_QUERYRESULTBATCH.fields_by_name["entity_results"].message_type = _ENTITYRESULT
+_QUERYRESULTBATCH.fields_by_name[
+    "more_results"
+].enum_type = _QUERYRESULTBATCH_MORERESULTSTYPE
+_QUERYRESULTBATCH_MORERESULTSTYPE.containing_type = _QUERYRESULTBATCH
+DESCRIPTOR.message_types_by_name["EntityResult"] = _ENTITYRESULT
+DESCRIPTOR.message_types_by_name["Query"] = _QUERY
+DESCRIPTOR.message_types_by_name["KindExpression"] = _KINDEXPRESSION
+DESCRIPTOR.message_types_by_name["PropertyReference"] = _PROPERTYREFERENCE
+DESCRIPTOR.message_types_by_name["Projection"] = _PROJECTION
+DESCRIPTOR.message_types_by_name["PropertyOrder"] = _PROPERTYORDER
+DESCRIPTOR.message_types_by_name["Filter"] = _FILTER
+DESCRIPTOR.message_types_by_name["CompositeFilter"] = _COMPOSITEFILTER
+DESCRIPTOR.message_types_by_name["PropertyFilter"] = _PROPERTYFILTER
+DESCRIPTOR.message_types_by_name["GqlQuery"] = _GQLQUERY
+DESCRIPTOR.message_types_by_name["GqlQueryParameter"] = _GQLQUERYPARAMETER
+DESCRIPTOR.message_types_by_name["QueryResultBatch"] = _QUERYRESULTBATCH
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+EntityResult = _reflection.GeneratedProtocolMessageType(
+    "EntityResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYRESULT,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""The result of fetching an entity from Datastore.
+  
+  
+  Attributes:
+      entity:
+          The resulting entity.
+      version:
+          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.  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.
+      cursor:
+          A cursor that points to the position after the result entity.
+          Set only when the ``EntityResult`` is part of a
+          ``QueryResultBatch`` message.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.EntityResult)
+    ),
+)
+_sym_db.RegisterMessage(EntityResult)
+
+Query = _reflection.GeneratedProtocolMessageType(
+    "Query",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERY,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A query for entities.
+  
+  
+  Attributes:
+      projection:
+          The projection to return. Defaults to returning all
+          properties.
+      kind:
+          The kinds to query (if empty, returns entities of all kinds).
+          Currently at most 1 kind may be specified.
+      filter:
+          The filter to apply.
+      order:
+          The order to apply to the query results (if empty, order is
+          unspecified).
+      distinct_on:
+          The properties to make distinct. The query results will
+          contain the first result for each distinct combination of
+          values for the given properties (if empty, all results are
+          returned).
+      start_cursor:
+          A starting point for the query results. Query cursors are
+          returned in query result batches and `can only be used to
+          continue the same query <https://cloud.google.com/datastore/do
+          cs/concepts/queries#cursors_limits_and_offsets>`__.
+      end_cursor:
+          An ending point for the query results. Query cursors are
+          returned in query result batches and `can only be used to
+          limit the same query <https://cloud.google.com/datastore/docs/
+          concepts/queries#cursors_limits_and_offsets>`__.
+      offset:
+          The number of results to skip. Applies before limit, but after
+          all other constraints. Optional. Must be >= 0 if specified.
+      limit:
+          The maximum number of results to return. Applies after all
+          other constraints. Optional. Unspecified is interpreted as no
+          limit. Must be >= 0 if specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Query)
+    ),
+)
+_sym_db.RegisterMessage(Query)
+
+KindExpression = _reflection.GeneratedProtocolMessageType(
+    "KindExpression",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KINDEXPRESSION,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A representation of a kind.
+  
+  
+  Attributes:
+      name:
+          The name of the kind.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.KindExpression)
+    ),
+)
+_sym_db.RegisterMessage(KindExpression)
+
+PropertyReference = _reflection.GeneratedProtocolMessageType(
+    "PropertyReference",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTYREFERENCE,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A reference to a property relative to the kind expressions.
+  
+  
+  Attributes:
+      name:
+          The name of the property. If name includes "."s, it may be
+          interpreted as a property name path.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.PropertyReference)
+    ),
+)
+_sym_db.RegisterMessage(PropertyReference)
+
+Projection = _reflection.GeneratedProtocolMessageType(
+    "Projection",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROJECTION,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A representation of a property in a projection.
+  
+  
+  Attributes:
+      property:
+          The property to project.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Projection)
+    ),
+)
+_sym_db.RegisterMessage(Projection)
+
+PropertyOrder = _reflection.GeneratedProtocolMessageType(
+    "PropertyOrder",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTYORDER,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""The desired order for a specific property.
+  
+  
+  Attributes:
+      property:
+          The property to order by.
+      direction:
+          The direction to order by. Defaults to ``ASCENDING``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.PropertyOrder)
+    ),
+)
+_sym_db.RegisterMessage(PropertyOrder)
+
+Filter = _reflection.GeneratedProtocolMessageType(
+    "Filter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FILTER,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A holder for any type of filter.
+  
+  
+  Attributes:
+      filter_type:
+          The type of filter.
+      composite_filter:
+          A composite filter.
+      property_filter:
+          A filter on a property.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.Filter)
+    ),
+)
+_sym_db.RegisterMessage(Filter)
+
+CompositeFilter = _reflection.GeneratedProtocolMessageType(
+    "CompositeFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMPOSITEFILTER,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A filter that merges multiple other filters using the given operator.
+  
+  
+  Attributes:
+      op:
+          The operator for combining multiple filters.
+      filters:
+          The list of filters to combine. Must contain at least one
+          filter.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.CompositeFilter)
+    ),
+)
+_sym_db.RegisterMessage(CompositeFilter)
+
+PropertyFilter = _reflection.GeneratedProtocolMessageType(
+    "PropertyFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTYFILTER,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A filter on a specific property.
+  
+  
+  Attributes:
+      property:
+          The property to filter by.
+      op:
+          The operator to filter by.
+      value:
+          The value to compare the property to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.PropertyFilter)
+    ),
+)
+_sym_db.RegisterMessage(PropertyFilter)
+
+GqlQuery = _reflection.GeneratedProtocolMessageType(
+    "GqlQuery",
+    (_message.Message,),
+    dict(
+        NamedBindingsEntry=_reflection.GeneratedProtocolMessageType(
+            "NamedBindingsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GQLQUERY_NAMEDBINDINGSENTRY,
+                __module__="google.cloud.datastore_v1.proto.query_pb2"
+                # @@protoc_insertion_point(class_scope:google.datastore.v1.GqlQuery.NamedBindingsEntry)
+            ),
+        ),
+        DESCRIPTOR=_GQLQUERY,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A `GQL
+  query <https://cloud.google.com/datastore/docs/apis/gql/gql_reference>`__.
+  
+  
+  Attributes:
+      query_string:
+          A string of the format described `here <https://cloud.google.c
+          om/datastore/docs/apis/gql/gql_reference>`__.
+      allow_literals:
+          When false, the query string must not contain any literals and
+          instead must bind all values. For example, ``SELECT * FROM
+          Kind WHERE a = 'string literal'`` is not allowed, while
+          ``SELECT * FROM Kind WHERE a = @value`` is.
+      named_bindings:
+          For each non-reserved named binding site in the query string,
+          there must be a named parameter with that name, but not
+          necessarily the inverse.  Key must match regex ``[A-Za-
+          z_$][A-Za-z_$0-9]*``, must not match regex ``__.*__``, and
+          must not be ``""``.
+      positional_bindings:
+          Numbered binding site @1 references the first numbered
+          parameter, effectively using 1-based indexing, rather than the
+          usual 0.  For each binding site numbered i in
+          ``query_string``, there must be an i-th numbered parameter.
+          The inverse must also be true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.GqlQuery)
+    ),
+)
+_sym_db.RegisterMessage(GqlQuery)
+_sym_db.RegisterMessage(GqlQuery.NamedBindingsEntry)
+
+GqlQueryParameter = _reflection.GeneratedProtocolMessageType(
+    "GqlQueryParameter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GQLQUERYPARAMETER,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A binding parameter for a GQL query.
+  
+  
+  Attributes:
+      parameter_type:
+          The type of parameter.
+      value:
+          A value parameter.
+      cursor:
+          A query cursor. Query cursors are returned in query result
+          batches.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.GqlQueryParameter)
+    ),
+)
+_sym_db.RegisterMessage(GqlQueryParameter)
+
+QueryResultBatch = _reflection.GeneratedProtocolMessageType(
+    "QueryResultBatch",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYRESULTBATCH,
+        __module__="google.cloud.datastore_v1.proto.query_pb2",
+        __doc__="""A batch of results produced by a query.
+  
+  
+  Attributes:
+      skipped_results:
+          The number of results skipped, typically because of an offset.
+      skipped_cursor:
+          A cursor that points to the position after the last skipped
+          result. Will be set when ``skipped_results`` != 0.
+      entity_result_type:
+          The result type for every entity in ``entity_results``.
+      entity_results:
+          The results for this batch.
+      end_cursor:
+          A cursor that points to the position after the last result in
+          the batch.
+      more_results:
+          The state of the query after the current batch.
+      snapshot_version:
+          The version number of the snapshot this batch was returned
+          from. This applies to the range of results from the query's
+          ``start_cursor`` (or the beginning of the query if no cursor
+          was given) to this batch's ``end_cursor`` (not the query's
+          ``end_cursor``).  In a single transaction, subsequent query
+          result batches for the same query can have a greater snapshot
+          version number. Each batch's snapshot version is valid for all
+          preceding batches. The value will be zero for eventually
+          consistent queries.
+  """,
+        # @@protoc_insertion_point(class_scope:google.datastore.v1.QueryResultBatch)
+    ),
+)
+_sym_db.RegisterMessage(QueryResultBatch)
+
+
+DESCRIPTOR._options = None
+_GQLQUERY_NAMEDBINDINGSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/datastore/google/cloud/datastore_v1/proto/query_pb2_grpc.py b/datastore/google/cloud/datastore_v1/proto/query_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/proto/query_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/datastore/google/cloud/datastore_v1/types.py b/datastore/google/cloud/datastore_v1/types.py
new file mode 100644
index 000000000000..ac154bda0e67
--- /dev/null
+++ b/datastore/google/cloud/datastore_v1/types.py
@@ -0,0 +1,55 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.type import latlng_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.datastore_v1.proto import datastore_pb2
+from google.cloud.datastore_v1.proto import entity_pb2
+from google.cloud.datastore_v1.proto import query_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    descriptor_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [datastore_pb2, entity_pb2, query_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.datastore_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/datastore/noxfile.py b/datastore/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/datastore/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/datastore/pylint.config.py b/datastore/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/datastore/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/datastore/setup.cfg b/datastore/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/datastore/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/datastore/setup.py b/datastore/setup.py
new file mode 100644
index 000000000000..7414c0ed29da
--- /dev/null
+++ b/datastore/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-datastore"
+description = "Google Cloud Datastore API client library"
+version = "1.9.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/datastore/synth.metadata b/datastore/synth.metadata
new file mode 100644
index 000000000000..8bff1cea3c7c
--- /dev/null
+++ b/datastore/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:22:10.473851Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "datastore",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/datastore/artman_datastore.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/datastore/synth.py b/datastore/synth.py
new file mode 100644
index 000000000000..0d477f5f179d
--- /dev/null
+++ b/datastore/synth.py
@@ -0,0 +1,42 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate datastore GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "datastore",
+    "v1",
+    config_path="/google/datastore/artman_datastore.yaml",
+    artman_output_name="datastore-v1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/datastore_v1/proto")
+s.move(library / "google/cloud/datastore_v1/gapic")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/datastore/tests/__init__.py b/datastore/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datastore/tests/doctests.py b/datastore/tests/doctests.py
new file mode 100644
index 000000000000..329b3d416d3b
--- /dev/null
+++ b/datastore/tests/doctests.py
@@ -0,0 +1,97 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import pkgutil
+import tempfile
+import unittest
+
+import six
+
+from google.cloud import datastore
+
+
+SPHINX_CONF = """\
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.doctest',
+]
+"""
+
+SPHINX_SECTION_TEMPLATE = """\
+Section %02d
+===========
+
+.. automodule:: google.cloud.%s
+  :members:
+
+"""
+
+
+@unittest.skipIf(six.PY2, "Doctests run against Python 3 only.")
+class TestDoctest(unittest.TestCase):
+    def _submodules(self):
+        pkg_iter = pkgutil.iter_modules(datastore.__path__)
+        result = []
+        for _, mod_name, ispkg in pkg_iter:
+            self.assertFalse(ispkg)
+            result.append(mod_name)
+
+        self.assertNotIn("__init__", result)
+        return result
+
+    @staticmethod
+    def _add_section(index, mod_name, file_obj):
+        mod_part = "datastore"
+        if mod_name != "__init__":
+            mod_part += "." + mod_name
+        content = SPHINX_SECTION_TEMPLATE % (index, mod_part)
+        file_obj.write(content)
+
+    def _make_temp_docs(self):
+        docs_dir = tempfile.mkdtemp(prefix="datastore-")
+
+        conf_file = os.path.join(docs_dir, "conf.py")
+
+        with open(conf_file, "w") as file_obj:
+            file_obj.write(SPHINX_CONF)
+
+        index_file = os.path.join(docs_dir, "contents.rst")
+        datastore_modules = self._submodules()
+        with open(index_file, "w") as file_obj:
+            self._add_section(0, "__init__", file_obj)
+            for index, datastore_module in enumerate(datastore_modules):
+                self._add_section(index + 1, datastore_module, file_obj)
+
+        return docs_dir
+
+    def test_it(self):
+        from sphinx import application
+
+        docs_dir = self._make_temp_docs()
+        outdir = os.path.join(docs_dir, "doctest", "out")
+        doctreedir = os.path.join(docs_dir, "doctest", "doctrees")
+
+        app = application.Sphinx(
+            srcdir=docs_dir,
+            confdir=docs_dir,
+            outdir=outdir,
+            doctreedir=doctreedir,
+            buildername="doctest",
+            warningiserror=True,
+            parallel=1,
+        )
+
+        app.build()
+        self.assertEqual(app.statuscode, 0)
diff --git a/datastore/tests/system/__init__.py b/datastore/tests/system/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/system_tests/data/index.yaml b/datastore/tests/system/index.yaml
similarity index 100%
rename from system_tests/data/index.yaml
rename to datastore/tests/system/index.yaml
diff --git a/datastore/tests/system/test_system.py b/datastore/tests/system/test_system.py
new file mode 100644
index 000000000000..482b0b80ba7d
--- /dev/null
+++ b/datastore/tests/system/test_system.py
@@ -0,0 +1,554 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import os
+import unittest
+
+import requests
+import six
+
+from google.cloud._helpers import UTC
+from google.cloud import datastore
+from google.cloud.datastore.helpers import GeoPoint
+from google.cloud.environment_vars import GCD_DATASET
+from google.cloud.exceptions import Conflict
+
+from test_utils.system import EmulatorCreds
+from test_utils.system import unique_resource_id
+
+from tests.system.utils import clear_datastore
+from tests.system.utils import populate_datastore
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    TO_DELETE = []
+
+
+def clone_client(client):
+    return datastore.Client(
+        project=client.project,
+        namespace=client.namespace,
+        credentials=client._credentials,
+        _http=client._http,
+    )
+
+
+def setUpModule():
+    emulator_dataset = os.getenv(GCD_DATASET)
+    # Isolated namespace so concurrent test runs don't collide.
+    test_namespace = "ns" + unique_resource_id()
+    if emulator_dataset is None:
+        Config.CLIENT = datastore.Client(namespace=test_namespace)
+    else:
+        credentials = EmulatorCreds()
+        http = requests.Session()  # Un-authorized.
+        Config.CLIENT = datastore.Client(
+            project=emulator_dataset,
+            namespace=test_namespace,
+            credentials=credentials,
+            _http=http,
+        )
+
+
+def tearDownModule():
+    keys = [entity.key for entity in Config.TO_DELETE]
+    with Config.CLIENT.transaction():
+        Config.CLIENT.delete_multi(keys)
+
+
+class TestDatastore(unittest.TestCase):
+    def setUp(self):
+        self.case_entities_to_delete = []
+
+    def tearDown(self):
+        with Config.CLIENT.transaction():
+            keys = [entity.key for entity in self.case_entities_to_delete]
+            Config.CLIENT.delete_multi(keys)
+
+
+class TestDatastoreAllocateIDs(TestDatastore):
+    def test_allocate_ids(self):
+        num_ids = 10
+        allocated_keys = Config.CLIENT.allocate_ids(Config.CLIENT.key("Kind"), num_ids)
+        self.assertEqual(len(allocated_keys), num_ids)
+
+        unique_ids = set()
+        for key in allocated_keys:
+            unique_ids.add(key.id)
+            self.assertIsNone(key.name)
+            self.assertNotEqual(key.id, None)
+
+        self.assertEqual(len(unique_ids), num_ids)
+
+
+class TestDatastoreSave(TestDatastore):
+    @classmethod
+    def setUpClass(cls):
+        cls.PARENT = Config.CLIENT.key("Blog", "PizzaMan")
+
+    def _get_post(self, id_or_name=None, post_content=None):
+        post_content = post_content or {
+            "title": u"How to make the perfect pizza in your grill",
+            "tags": [u"pizza", u"grill"],
+            "publishedAt": datetime.datetime(2001, 1, 1, tzinfo=UTC),
+            "author": u"Silvano",
+            "isDraft": False,
+            "wordCount": 400,
+            "rating": 5.0,
+        }
+        # Create an entity with the given content.
+        # NOTE: Using a parent to ensure consistency for query
+        #       in `test_empty_kind`.
+        key = Config.CLIENT.key("Post", parent=self.PARENT)
+        entity = datastore.Entity(key=key)
+        entity.update(post_content)
+
+        # Update the entity key.
+        if id_or_name is not None:
+            entity.key = entity.key.completed_key(id_or_name)
+
+        return entity
+
+    def _generic_test_post(self, name=None, key_id=None):
+        entity = self._get_post(id_or_name=(name or key_id))
+        Config.CLIENT.put(entity)
+
+        # Register entity to be deleted.
+        self.case_entities_to_delete.append(entity)
+
+        if name is not None:
+            self.assertEqual(entity.key.name, name)
+        if key_id is not None:
+            self.assertEqual(entity.key.id, key_id)
+        retrieved_entity = Config.CLIENT.get(entity.key)
+        # Check the given and retrieved are the the same.
+        self.assertEqual(retrieved_entity, entity)
+
+    def test_post_with_name(self):
+        self._generic_test_post(name="post1")
+
+    def test_post_with_id(self):
+        self._generic_test_post(key_id=123456789)
+
+    def test_post_with_generated_id(self):
+        self._generic_test_post()
+
+    def test_save_multiple(self):
+        with Config.CLIENT.transaction() as xact:
+            entity1 = self._get_post()
+            xact.put(entity1)
+            # Register entity to be deleted.
+            self.case_entities_to_delete.append(entity1)
+
+            second_post_content = {
+                "title": u"How to make the perfect homemade pasta",
+                "tags": [u"pasta", u"homemade"],
+                "publishedAt": datetime.datetime(2001, 1, 1),
+                "author": u"Silvano",
+                "isDraft": False,
+                "wordCount": 450,
+                "rating": 4.5,
+            }
+            entity2 = self._get_post(post_content=second_post_content)
+            xact.put(entity2)
+            # Register entity to be deleted.
+            self.case_entities_to_delete.append(entity2)
+
+        keys = [entity1.key, entity2.key]
+        matches = Config.CLIENT.get_multi(keys)
+        self.assertEqual(len(matches), 2)
+
+    def test_empty_kind(self):
+        query = Config.CLIENT.query(kind="Post")
+        query.ancestor = self.PARENT
+        posts = list(query.fetch(limit=2))
+        self.assertEqual(posts, [])
+
+    def test_all_value_types(self):
+        key = Config.CLIENT.key("TestPanObject", 1234)
+        entity = datastore.Entity(key=key)
+        entity["timestamp"] = datetime.datetime(2014, 9, 9, tzinfo=UTC)
+        key_stored = Config.CLIENT.key("SavedKey", "right-here")
+        entity["key"] = key_stored
+        entity["truthy"] = True
+        entity["float"] = 2.718281828
+        entity["int"] = 3735928559
+        entity["words"] = u"foo"
+        entity["blob"] = b"seekretz"
+        entity_stored = datastore.Entity(key=key_stored)
+        entity_stored["hi"] = "bye"
+        entity["nested"] = entity_stored
+        entity["items"] = [1, 2, 3]
+        entity["geo"] = GeoPoint(1.0, 2.0)
+        entity["nothing_here"] = None
+
+        # Store the entity.
+        self.case_entities_to_delete.append(entity)
+        Config.CLIENT.put(entity)
+
+        # Check the original and retrieved are the the same.
+        retrieved_entity = Config.CLIENT.get(entity.key)
+        self.assertEqual(retrieved_entity, entity)
+
+
+class TestDatastoreSaveKeys(TestDatastore):
+    def test_save_key_self_reference(self):
+        parent_key = Config.CLIENT.key("Residence", "NewYork")
+        key = Config.CLIENT.key("Person", "name", parent=parent_key)
+        entity = datastore.Entity(key=key)
+        entity["fullName"] = u"Full name"
+        entity["linkedTo"] = key  # Self reference.
+
+        Config.CLIENT.put(entity)
+        self.case_entities_to_delete.append(entity)
+
+        query = Config.CLIENT.query(kind="Person")
+        # Adding ancestor to ensure consistency.
+        query.ancestor = parent_key
+        query.add_filter("linkedTo", "=", key)
+
+        stored_persons = list(query.fetch(limit=2))
+        self.assertEqual(stored_persons, [entity])
+
+
+class TestDatastoreQuery(TestDatastore):
+    @classmethod
+    def setUpClass(cls):
+        cls.CLIENT = clone_client(Config.CLIENT)
+        # Remove the namespace from the cloned client, since these
+        # query tests rely on the entities to be already stored and indexed,
+        # hence ``test_namespace`` set at runtime can't be used.
+        cls.CLIENT.namespace = None
+
+        # In the emulator, re-populating the datastore is cheap.
+        if os.getenv(GCD_DATASET) is not None:
+            # Populate the datastore with the cloned client.
+            populate_datastore.add_characters(client=cls.CLIENT)
+
+        cls.CHARACTERS = populate_datastore.CHARACTERS
+        # Use the client for this test instead of the global.
+        cls.ANCESTOR_KEY = cls.CLIENT.key(*populate_datastore.ANCESTOR)
+
+    @classmethod
+    def tearDownClass(cls):
+        # In the emulator, destroy the query entities.
+        if os.getenv(GCD_DATASET) is not None:
+            # Use the client for this test instead of the global.
+            clear_datastore.remove_all_entities(client=cls.CLIENT)
+
+    def _base_query(self):
+        # Use the client for this test instead of the global.
+        return self.CLIENT.query(kind="Character", ancestor=self.ANCESTOR_KEY)
+
+    def test_limit_queries(self):
+        limit = 5
+        query = self._base_query()
+
+        # Fetch characters.
+        iterator = query.fetch(limit=limit)
+        page = six.next(iterator.pages)
+        character_entities = list(page)
+        cursor = iterator.next_page_token
+        self.assertEqual(len(character_entities), limit)
+
+        # Check cursor after fetch.
+        self.assertIsNotNone(cursor)
+
+        # Fetch remaining characters.
+        new_character_entities = list(query.fetch(start_cursor=cursor))
+        characters_remaining = len(self.CHARACTERS) - limit
+        self.assertEqual(len(new_character_entities), characters_remaining)
+
+    def test_query_simple_filter(self):
+        query = self._base_query()
+        query.add_filter("appearances", ">=", 20)
+        expected_matches = 6
+        # We expect 6, but allow the query to get 1 extra.
+        entities = list(query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+    def test_query_multiple_filters(self):
+        query = self._base_query()
+        query.add_filter("appearances", ">=", 26)
+        query.add_filter("family", "=", "Stark")
+        expected_matches = 4
+        # We expect 4, but allow the query to get 1 extra.
+        entities = list(query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+    def test_ancestor_query(self):
+        filtered_query = self._base_query()
+
+        expected_matches = 8
+        # We expect 8, but allow the query to get 1 extra.
+        entities = list(filtered_query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+    def test_query_key_filter(self):
+        # Use the client for this test instead of the global.
+        rickard_key = self.CLIENT.key(*populate_datastore.RICKARD)
+
+        query = self._base_query()
+        query.key_filter(rickard_key)
+        expected_matches = 1
+        # We expect 1, but allow the query to get 1 extra.
+        entities = list(query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+    def test_ordered_query(self):
+        query = self._base_query()
+        query.order = "appearances"
+        expected_matches = 8
+        # We expect 8, but allow the query to get 1 extra.
+        entities = list(query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+        # Actually check the ordered data returned.
+        self.assertEqual(entities[0]["name"], self.CHARACTERS[0]["name"])
+        self.assertEqual(entities[7]["name"], self.CHARACTERS[3]["name"])
+
+    def test_projection_query(self):
+        filtered_query = self._base_query()
+        filtered_query.projection = ["name", "family"]
+        filtered_query.order = ["name", "family"]
+
+        # NOTE: There are 9 responses because of Catelyn. She has both
+        #       Stark and Tully as her families, hence occurs twice in
+        #       the results.
+        expected_matches = 9
+        # We expect 9, but allow the query to get 1 extra.
+        entities = list(filtered_query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+        arya_entity = entities[0]
+        catelyn_tully_entity = entities[3]
+        sansa_entity = entities[8]
+
+        arya_dict = dict(arya_entity)
+        self.assertEqual(arya_dict, {"name": "Arya", "family": "Stark"})
+
+        catelyn_stark_entity = entities[2]
+        catelyn_stark_dict = dict(catelyn_stark_entity)
+        self.assertEqual(catelyn_stark_dict, {"name": "Catelyn", "family": "Stark"})
+
+        catelyn_tully_dict = dict(catelyn_tully_entity)
+        self.assertEqual(catelyn_tully_dict, {"name": "Catelyn", "family": "Tully"})
+
+        # Check both Catelyn keys are the same.
+        self.assertEqual(catelyn_stark_entity.key, catelyn_tully_entity.key)
+
+        sansa_dict = dict(sansa_entity)
+        self.assertEqual(sansa_dict, {"name": "Sansa", "family": "Stark"})
+
+    def test_query_paginate_simple_uuid_keys(self):
+
+        # See issue #4264
+        page_query = self.CLIENT.query(kind="uuid_key")
+        iterator = page_query.fetch()
+
+        seen = set()
+        page_count = 0
+        for page in iterator.pages:
+            page_count += 1
+            for entity in page:
+                uuid_str = entity.key.name
+                self.assertNotIn(uuid_str, seen, uuid_str)
+                seen.add(uuid_str)
+
+        self.assertTrue(page_count > 1)
+
+    def test_query_paginate_simple_timestamp_keys(self):
+
+        # See issue #4264
+        page_query = self.CLIENT.query(kind="timestamp_key")
+        iterator = page_query.fetch()
+
+        seen = set()
+        page_count = 0
+        for page in iterator.pages:
+            page_count += 1
+            for entity in page:
+                timestamp = entity.key.id
+                self.assertNotIn(timestamp, seen, timestamp)
+                seen.add(timestamp)
+
+        self.assertTrue(page_count > 1)
+
+    def test_query_offset_timestamp_keys(self):
+        # See issue #4675
+        max_all = 10000
+        offset = 1
+        max_offset = max_all - offset
+        query = self.CLIENT.query(kind="timestamp_key")
+        all_w_limit = list(query.fetch(limit=max_all))
+        self.assertEqual(len(all_w_limit), max_all)
+
+        offset_w_limit = list(query.fetch(offset=offset, limit=max_offset))
+        self.assertEqual(offset_w_limit, all_w_limit[offset:])
+
+    def test_query_paginate_with_offset(self):
+        page_query = self._base_query()
+        page_query.order = "appearances"
+        offset = 2
+        limit = 3
+        iterator = page_query.fetch(limit=limit, offset=offset)
+
+        # Fetch characters.
+        page = six.next(iterator.pages)
+        entities = list(page)
+        cursor = iterator.next_page_token
+        self.assertEqual(len(entities), limit)
+        self.assertEqual(entities[0]["name"], "Robb")
+        self.assertEqual(entities[1]["name"], "Bran")
+        self.assertEqual(entities[2]["name"], "Catelyn")
+
+        # Fetch next set of characters.
+        new_iterator = page_query.fetch(limit=limit, offset=0, start_cursor=cursor)
+        entities = list(new_iterator)
+        self.assertEqual(len(entities), limit)
+        self.assertEqual(entities[0]["name"], "Sansa")
+        self.assertEqual(entities[1]["name"], "Jon Snow")
+        self.assertEqual(entities[2]["name"], "Arya")
+
+    def test_query_paginate_with_start_cursor(self):
+        page_query = self._base_query()
+        page_query.order = "appearances"
+        limit = 3
+        offset = 2
+        iterator = page_query.fetch(limit=limit, offset=offset)
+
+        # Fetch characters.
+        page = six.next(iterator.pages)
+        entities = list(page)
+        cursor = iterator.next_page_token
+        self.assertEqual(len(entities), limit)
+
+        # Use cursor to create a fresh query.
+        fresh_query = self._base_query()
+        fresh_query.order = "appearances"
+
+        new_entities = list(fresh_query.fetch(start_cursor=cursor, limit=limit))
+        characters_remaining = len(self.CHARACTERS) - limit - offset
+        self.assertEqual(len(new_entities), characters_remaining)
+        self.assertEqual(new_entities[0]["name"], "Sansa")
+        self.assertEqual(new_entities[2]["name"], "Arya")
+
+    def test_query_distinct_on(self):
+        query = self._base_query()
+        query.distinct_on = ["alive"]
+
+        expected_matches = 2
+        # We expect 2, but allow the query to get 1 extra.
+        entities = list(query.fetch(limit=expected_matches + 1))
+        self.assertEqual(len(entities), expected_matches)
+
+        self.assertEqual(entities[0]["name"], "Catelyn")
+        self.assertEqual(entities[1]["name"], "Arya")
+
+
+class TestDatastoreTransaction(TestDatastore):
+    def test_transaction_via_with_statement(self):
+        entity = datastore.Entity(key=Config.CLIENT.key("Company", "Google"))
+        entity["url"] = u"www.google.com"
+
+        with Config.CLIENT.transaction() as xact:
+            result = Config.CLIENT.get(entity.key)
+            if result is None:
+                xact.put(entity)
+                self.case_entities_to_delete.append(entity)
+
+        # This will always return after the transaction.
+        retrieved_entity = Config.CLIENT.get(entity.key)
+        self.case_entities_to_delete.append(retrieved_entity)
+        self.assertEqual(retrieved_entity, entity)
+
+    def test_transaction_via_explicit_begin_get_commit(self):
+        # See
+        # github.com/GoogleCloudPlatform/google-cloud-python/issues/1859
+        # Note that this example lacks the threading which provokes the race
+        # condition in that issue:  we are basically just exercising the
+        # "explict" path for using transactions.
+        BEFORE_1 = 100
+        BEFORE_2 = 0
+        TRANSFER_AMOUNT = 40
+        key1 = Config.CLIENT.key("account", "123")
+        account1 = datastore.Entity(key=key1)
+        account1["balance"] = BEFORE_1
+        key2 = Config.CLIENT.key("account", "234")
+        account2 = datastore.Entity(key=key2)
+        account2["balance"] = BEFORE_2
+        Config.CLIENT.put_multi([account1, account2])
+        self.case_entities_to_delete.append(account1)
+        self.case_entities_to_delete.append(account2)
+
+        xact = Config.CLIENT.transaction()
+        xact.begin()
+        from_account = Config.CLIENT.get(key1, transaction=xact)
+        to_account = Config.CLIENT.get(key2, transaction=xact)
+        from_account["balance"] -= TRANSFER_AMOUNT
+        to_account["balance"] += TRANSFER_AMOUNT
+
+        xact.put(from_account)
+        xact.put(to_account)
+        xact.commit()
+
+        after1 = Config.CLIENT.get(key1)
+        after2 = Config.CLIENT.get(key2)
+        self.assertEqual(after1["balance"], BEFORE_1 - TRANSFER_AMOUNT)
+        self.assertEqual(after2["balance"], BEFORE_2 + TRANSFER_AMOUNT)
+
+    def test_failure_with_contention(self):
+        contention_prop_name = "baz"
+        local_client = clone_client(Config.CLIENT)
+
+        # Insert an entity which will be retrieved in a transaction
+        # and updated outside it with a contentious value.
+        key = local_client.key("BreakTxn", 1234)
+        orig_entity = datastore.Entity(key=key)
+        orig_entity["foo"] = u"bar"
+        local_client.put(orig_entity)
+        self.case_entities_to_delete.append(orig_entity)
+
+        with self.assertRaises(Conflict):
+            with local_client.transaction() as txn:
+                entity_in_txn = local_client.get(key)
+
+                # Update the original entity outside the transaction.
+                orig_entity[contention_prop_name] = u"outside"
+                Config.CLIENT.put(orig_entity)
+
+                # Try to update the entity which we already updated outside the
+                # transaction.
+                entity_in_txn[contention_prop_name] = u"inside"
+                txn.put(entity_in_txn)
+
+    def test_empty_array_put(self):
+        local_client = clone_client(Config.CLIENT)
+
+        key = local_client.key("EmptyArray", 1234)
+        local_client = datastore.Client()
+        entity = datastore.Entity(key=key)
+        entity["children"] = []
+        local_client.put(entity)
+        retrieved = local_client.get(entity.key)
+
+        self.assertEqual(entity["children"], retrieved["children"])
diff --git a/datastore/tests/system/utils/__init__.py b/datastore/tests/system/utils/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/datastore/tests/system/utils/clear_datastore.py b/datastore/tests/system/utils/clear_datastore.py
new file mode 100644
index 000000000000..03f5ffddbe10
--- /dev/null
+++ b/datastore/tests/system/utils/clear_datastore.py
@@ -0,0 +1,104 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Script to populate datastore with system test data."""
+
+from __future__ import print_function
+
+import os
+import sys
+
+import six
+
+from google.cloud import datastore
+
+
+FETCH_MAX = 20
+ALL_KINDS = (
+    "Character",
+    "Company",
+    "Kind",
+    "Person",
+    "Post",
+    "uuid_key",
+    "timestamp_key",
+)
+TRANSACTION_MAX_GROUPS = 5
+MAX_DEL_ENTITIES = 500
+
+
+def print_func(message):
+    if os.getenv("GOOGLE_CLOUD_NO_PRINT") != "true":
+        print(message)
+
+
+def get_ancestors(entities):
+    # NOTE: A key will always have at least one path element.
+    key_roots = [entity.key.flat_path[:2] for entity in entities]
+    # Return the unique roots.
+    return list(set(key_roots))
+
+
+def delete_chunks(client, results):
+    while results:
+        chunk, results = results[:MAX_DEL_ENTITIES], results[MAX_DEL_ENTITIES:]
+        client.delete_multi([result.key for result in chunk])
+
+
+def remove_kind(kind, client):
+    query = client.query(kind=kind)
+    query.keys_only()
+    results = list(query.fetch())
+
+    if not results:
+        return
+
+    delete_outside_transaction = False
+    with client.transaction():
+        # Now that we have all results, we seek to delete.
+        print_func("Deleting keys:")
+        print_func(results)
+
+        ancestors = get_ancestors(results)
+        if len(ancestors) > TRANSACTION_MAX_GROUPS:
+            delete_outside_transaction = True
+        else:
+            delete_chunks(client, results)
+
+    if delete_outside_transaction:
+        delete_chunks(client, results)
+
+
+def main():
+    client = datastore.Client()
+    kinds = sys.argv[1:]
+
+    if len(kinds) == 0:
+        kinds = ALL_KINDS
+
+    print_func("This command will remove all entities for " "the following kinds:")
+    print_func("\n".join("- " + val for val in kinds))
+    response = six.moves.input("Is this OK [y/n]? ")
+
+    if response.lower() == "y":
+
+        for kind in kinds:
+            remove_kind(kind, client)
+
+    else:
+        print_func("Doing nothing.")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/datastore/tests/system/utils/populate_datastore.py b/datastore/tests/system/utils/populate_datastore.py
new file mode 100644
index 000000000000..2c266a8ac4bc
--- /dev/null
+++ b/datastore/tests/system/utils/populate_datastore.py
@@ -0,0 +1,142 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Script to populate datastore with system test data."""
+
+
+from __future__ import print_function
+
+import os
+import sys
+import time
+import uuid
+
+import six
+
+from google.cloud import datastore
+
+
+ANCESTOR = ("Book", "GoT")
+RICKARD = ANCESTOR + ("Character", "Rickard")
+EDDARD = RICKARD + ("Character", "Eddard")
+KEY_PATHS = (
+    RICKARD,
+    EDDARD,
+    ANCESTOR + ("Character", "Catelyn"),
+    EDDARD + ("Character", "Arya"),
+    EDDARD + ("Character", "Sansa"),
+    EDDARD + ("Character", "Robb"),
+    EDDARD + ("Character", "Bran"),
+    EDDARD + ("Character", "Jon Snow"),
+)
+CHARACTERS = (
+    {"name": u"Rickard", "family": u"Stark", "appearances": 0, "alive": False},
+    {"name": u"Eddard", "family": u"Stark", "appearances": 9, "alive": False},
+    {
+        "name": u"Catelyn",
+        "family": [u"Stark", u"Tully"],
+        "appearances": 26,
+        "alive": False,
+    },
+    {"name": u"Arya", "family": u"Stark", "appearances": 33, "alive": True},
+    {"name": u"Sansa", "family": u"Stark", "appearances": 31, "alive": True},
+    {"name": u"Robb", "family": u"Stark", "appearances": 22, "alive": False},
+    {"name": u"Bran", "family": u"Stark", "appearances": 25, "alive": True},
+    {"name": u"Jon Snow", "family": u"Stark", "appearances": 32, "alive": True},
+)
+
+
+def print_func(message):
+    if os.getenv("GOOGLE_CLOUD_NO_PRINT") != "true":
+        print(message)
+
+
+def add_characters(client=None):
+    if client is None:
+        # Get a client that uses the test dataset.
+        client = datastore.Client()
+    with client.transaction() as xact:
+        for key_path, character in six.moves.zip(KEY_PATHS, CHARACTERS):
+            if key_path[-1] != character["name"]:
+                raise ValueError(("Character and key don't agree", key_path, character))
+            entity = datastore.Entity(key=client.key(*key_path))
+            entity.update(character)
+            xact.put(entity)
+            print_func(
+                "Adding Character %s %s" % (character["name"], character["family"])
+            )
+
+
+def add_uid_keys(client=None):
+    if client is None:
+        # Get a client that uses the test dataset.
+        client = datastore.Client()
+
+    num_batches = 2
+    batch_size = 500
+
+    for batch_num in range(num_batches):
+        with client.batch() as batch:
+            for seq_no in range(batch_size):
+                uid = str(uuid.uuid4())
+                key = client.key("uuid_key", uid)
+                entity = datastore.Entity(key=key)
+                entity["batch_num"] = batch_num
+                entity["seq_no"] = seq_no
+                batch.put(entity)
+
+
+def add_timestamp_keys(client=None):
+    if client is None:
+        # Get a client that uses the test dataset.
+        client = datastore.Client()
+
+    num_batches = 2
+    batch_size = 500
+
+    timestamp_micros = set()
+    for batch_num in range(num_batches):
+        with client.batch() as batch:
+            for seq_no in range(batch_size):
+                print("time_time: batch: {}, sequence: {}".format(batch_num, seq_no))
+                now_micros = int(time.time() * 1e6)
+                while now_micros in timestamp_micros:
+                    now_micros = int(time.time() * 1e6)
+                timestamp_micros.add(now_micros)
+                key = client.key("timestamp_key", now_micros)
+                entity = datastore.Entity(key=key)
+                entity["batch_num"] = batch_num
+                entity["seq_no"] = seq_no
+                batch.put(entity)
+
+
+def main():
+    client = datastore.Client()
+    flags = sys.argv[1:]
+
+    if len(flags) == 0:
+        flags = ["--characters", "--uuid", "--timestamps"]
+
+    if "--characters" in flags:
+        add_characters(client)
+
+    if "--uuid" in flags:
+        add_uid_keys(client)
+
+    if "--timestamps" in flags:
+        add_timestamp_keys(client)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/datastore/tests/unit/__init__.py b/datastore/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/datastore/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/datastore/tests/unit/gapic/v1/test_datastore_client_v1.py b/datastore/tests/unit/gapic/v1/test_datastore_client_v1.py
new file mode 100644
index 000000000000..7dfb27ed129e
--- /dev/null
+++ b/datastore/tests/unit/gapic/v1/test_datastore_client_v1.py
@@ -0,0 +1,302 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Unit tests."""
+
+import pytest
+
+from google.cloud import datastore_v1
+from google.cloud.datastore_v1 import enums
+from google.cloud.datastore_v1.proto import datastore_pb2
+from google.cloud.datastore_v1.proto import entity_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDatastoreClient(object):
+    def test_lookup(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datastore_pb2.LookupResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        keys = []
+
+        response = client.lookup(project_id, keys)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.LookupRequest(project_id=project_id, keys=keys)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_lookup_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        keys = []
+
+        with pytest.raises(CustomException):
+            client.lookup(project_id, keys)
+
+    def test_run_query(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datastore_pb2.RunQueryResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        partition_id = {}
+
+        response = client.run_query(project_id, partition_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.RunQueryRequest(
+            project_id=project_id, partition_id=partition_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_query_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        partition_id = {}
+
+        with pytest.raises(CustomException):
+            client.run_query(project_id, partition_id)
+
+    def test_begin_transaction(self):
+        # Setup Expected Response
+        transaction = b"-34"
+        expected_response = {"transaction": transaction}
+        expected_response = datastore_pb2.BeginTransactionResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+
+        response = client.begin_transaction(project_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.BeginTransactionRequest(project_id=project_id)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_begin_transaction_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+
+        with pytest.raises(CustomException):
+            client.begin_transaction(project_id)
+
+    def test_commit(self):
+        # Setup Expected Response
+        index_updates = 1425228195
+        expected_response = {"index_updates": index_updates}
+        expected_response = datastore_pb2.CommitResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        mode = enums.CommitRequest.Mode.MODE_UNSPECIFIED
+        mutations = []
+
+        response = client.commit(project_id, mode, mutations)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.CommitRequest(
+            project_id=project_id, mode=mode, mutations=mutations
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_commit_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        mode = enums.CommitRequest.Mode.MODE_UNSPECIFIED
+        mutations = []
+
+        with pytest.raises(CustomException):
+            client.commit(project_id, mode, mutations)
+
+    def test_rollback(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datastore_pb2.RollbackResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        transaction = b"-34"
+
+        response = client.rollback(project_id, transaction)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.RollbackRequest(
+            project_id=project_id, transaction=transaction
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rollback_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        transaction = b"-34"
+
+        with pytest.raises(CustomException):
+            client.rollback(project_id, transaction)
+
+    def test_allocate_ids(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datastore_pb2.AllocateIdsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        keys = []
+
+        response = client.allocate_ids(project_id, keys)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.AllocateIdsRequest(
+            project_id=project_id, keys=keys
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_allocate_ids_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        keys = []
+
+        with pytest.raises(CustomException):
+            client.allocate_ids(project_id, keys)
+
+    def test_reserve_ids(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = datastore_pb2.ReserveIdsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        keys = []
+
+        response = client.reserve_ids(project_id, keys)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = datastore_pb2.ReserveIdsRequest(
+            project_id=project_id, keys=keys
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_reserve_ids_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        client = datastore_v1.DatastoreClient(channel=channel)
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        keys = []
+
+        with pytest.raises(CustomException):
+            client.reserve_ids(project_id, keys)
diff --git a/datastore/tests/unit/test__gapic.py b/datastore/tests/unit/test__gapic.py
new file mode 100644
index 000000000000..c404dc79c109
--- /dev/null
+++ b/datastore/tests/unit/test__gapic.py
@@ -0,0 +1,83 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+from google.cloud.datastore.client import _HAVE_GRPC
+
+
+@unittest.skipUnless(_HAVE_GRPC, "No gRPC")
+class Test_make_datastore_api(unittest.TestCase):
+    def _call_fut(self, client):
+        from google.cloud.datastore._gapic import make_datastore_api
+
+        return make_datastore_api(client)
+
+    @mock.patch(
+        "google.cloud.datastore_v1.gapic.datastore_client.DatastoreClient",
+        return_value=mock.sentinel.ds_client,
+    )
+    @mock.patch(
+        "google.cloud.datastore._gapic.make_secure_channel",
+        return_value=mock.sentinel.channel,
+    )
+    def test_live_api(self, make_chan, mock_klass):
+        from google.cloud._http import DEFAULT_USER_AGENT
+
+        base_url = "https://datastore.googleapis.com:443"
+        client = mock.Mock(
+            _base_url=base_url,
+            _credentials=mock.sentinel.credentials,
+            _client_info=mock.sentinel.client_info,
+            spec=["_base_url", "_credentials", "_client_info"],
+        )
+        ds_api = self._call_fut(client)
+        self.assertIs(ds_api, mock.sentinel.ds_client)
+
+        make_chan.assert_called_once_with(
+            mock.sentinel.credentials,
+            DEFAULT_USER_AGENT,
+            "datastore.googleapis.com:443",
+        )
+        mock_klass.assert_called_once_with(
+            channel=mock.sentinel.channel, client_info=mock.sentinel.client_info
+        )
+
+    @mock.patch(
+        "google.cloud.datastore_v1.gapic.datastore_client.DatastoreClient",
+        return_value=mock.sentinel.ds_client,
+    )
+    @mock.patch(
+        "google.cloud.datastore._gapic.insecure_channel",
+        return_value=mock.sentinel.channel,
+    )
+    def test_emulator(self, make_chan, mock_klass):
+
+        host = "localhost:8901"
+        base_url = "http://" + host
+        client = mock.Mock(
+            _base_url=base_url,
+            _credentials=mock.sentinel.credentials,
+            _client_info=mock.sentinel.client_info,
+            spec=["_base_url", "_credentials", "_client_info"],
+        )
+        ds_api = self._call_fut(client)
+        self.assertIs(ds_api, mock.sentinel.ds_client)
+
+        make_chan.assert_called_once_with(host)
+        mock_klass.assert_called_once_with(
+            channel=mock.sentinel.channel, client_info=mock.sentinel.client_info
+        )
diff --git a/datastore/tests/unit/test__http.py b/datastore/tests/unit/test__http.py
new file mode 100644
index 000000000000..b332c946d40a
--- /dev/null
+++ b/datastore/tests/unit/test__http.py
@@ -0,0 +1,867 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+from six.moves import http_client
+
+import requests
+
+
+class Test__request(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.datastore._http import _request
+
+        return _request(*args, **kwargs)
+
+    def test_success(self):
+        from google.cloud import _http as connection_module
+
+        project = "PROJECT"
+        method = "METHOD"
+        data = b"DATA"
+        base_url = "http://api-url"
+        user_agent = "USER AGENT"
+        client_info = _make_client_info(user_agent)
+        response_data = "CONTENT"
+
+        http = _make_requests_session([_make_response(content=response_data)])
+
+        # Call actual function under test.
+        response = self._call_fut(http, project, method, data, base_url, client_info)
+        self.assertEqual(response, response_data)
+
+        # Check that the mocks were called as expected.
+        expected_url = _build_expected_url(base_url, project, method)
+        expected_headers = {
+            "Content-Type": "application/x-protobuf",
+            "User-Agent": user_agent,
+            connection_module.CLIENT_INFO_HEADER: user_agent,
+        }
+        http.request.assert_called_once_with(
+            method="POST", url=expected_url, headers=expected_headers, data=data
+        )
+
+    def test_failure(self):
+        from google.cloud.exceptions import BadRequest
+        from google.rpc import code_pb2
+        from google.rpc import status_pb2
+
+        project = "PROJECT"
+        method = "METHOD"
+        data = "DATA"
+        uri = "http://api-url"
+        user_agent = "USER AGENT"
+        client_info = _make_client_info(user_agent)
+
+        error = status_pb2.Status()
+        error.message = "Entity value is indexed."
+        error.code = code_pb2.FAILED_PRECONDITION
+
+        http = _make_requests_session(
+            [_make_response(http_client.BAD_REQUEST, content=error.SerializeToString())]
+        )
+
+        with self.assertRaises(BadRequest) as exc:
+            self._call_fut(http, project, method, data, uri, client_info)
+
+        expected_message = "400 Entity value is indexed."
+        self.assertEqual(str(exc.exception), expected_message)
+
+
+class Test__rpc(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.datastore._http import _rpc
+
+        return _rpc(*args, **kwargs)
+
+    def test_it(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        http = object()
+        project = "projectOK"
+        method = "beginTransaction"
+        base_url = "test.invalid"
+        client_info = _make_client_info()
+        request_pb = datastore_pb2.BeginTransactionRequest(project_id=project)
+
+        response_pb = datastore_pb2.BeginTransactionResponse(transaction=b"7830rmc")
+        patch = mock.patch(
+            "google.cloud.datastore._http._request",
+            return_value=response_pb.SerializeToString(),
+        )
+        with patch as mock_request:
+            result = self._call_fut(
+                http,
+                project,
+                method,
+                base_url,
+                client_info,
+                request_pb,
+                datastore_pb2.BeginTransactionResponse,
+            )
+            self.assertEqual(result, response_pb)
+
+            mock_request.assert_called_once_with(
+                http,
+                project,
+                method,
+                request_pb.SerializeToString(),
+                base_url,
+                client_info,
+            )
+
+
+class TestHTTPDatastoreAPI(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore._http import HTTPDatastoreAPI
+
+        return HTTPDatastoreAPI
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _make_query_pb(kind):
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        return query_pb2.Query(kind=[query_pb2.KindExpression(name=kind)])
+
+    def test_constructor(self):
+        client = object()
+        ds_api = self._make_one(client)
+        self.assertIs(ds_api.client, client)
+
+    def test_lookup_single_key_empty_response(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        key_pb = _make_key_pb(project)
+        rsp_pb = datastore_pb2.LookupResponse()
+        read_options = datastore_pb2.ReadOptions()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 0)
+        self.assertEqual(len(response.missing), 0)
+        self.assertEqual(len(response.deferred), 0)
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_lookup_single_key_empty_response_w_eventual(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        key_pb = _make_key_pb(project)
+        rsp_pb = datastore_pb2.LookupResponse()
+        read_options = datastore_pb2.ReadOptions(
+            read_consistency=datastore_pb2.ReadOptions.EVENTUAL
+        )
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 0)
+        self.assertEqual(len(response.missing), 0)
+        self.assertEqual(len(response.deferred), 0)
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_lookup_single_key_empty_response_w_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        transaction = b"TRANSACTION"
+        key_pb = _make_key_pb(project)
+        rsp_pb = datastore_pb2.LookupResponse()
+        read_options = datastore_pb2.ReadOptions(transaction=transaction)
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 0)
+        self.assertEqual(len(response.missing), 0)
+        self.assertEqual(len(response.deferred), 0)
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_lookup_single_key_nonempty_response(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        project = "PROJECT"
+        key_pb = _make_key_pb(project)
+        rsp_pb = datastore_pb2.LookupResponse()
+        entity = entity_pb2.Entity()
+        entity.key.CopyFrom(key_pb)
+        rsp_pb.found.add(entity=entity)
+        read_options = datastore_pb2.ReadOptions()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 1)
+        self.assertEqual(len(response.missing), 0)
+        self.assertEqual(len(response.deferred), 0)
+        found = response.found[0].entity
+        self.assertEqual(found.key.path[0].kind, "Kind")
+        self.assertEqual(found.key.path[0].id, 1234)
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_lookup_multiple_keys_empty_response(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        key_pb1 = _make_key_pb(project)
+        key_pb2 = _make_key_pb(project, id_=2345)
+        rsp_pb = datastore_pb2.LookupResponse()
+        read_options = datastore_pb2.ReadOptions()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb1, key_pb2], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 0)
+        self.assertEqual(len(response.missing), 0)
+        self.assertEqual(len(response.deferred), 0)
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb1, key_pb2])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_lookup_multiple_keys_w_missing(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        key_pb1 = _make_key_pb(project)
+        key_pb2 = _make_key_pb(project, id_=2345)
+        rsp_pb = datastore_pb2.LookupResponse()
+        er_1 = rsp_pb.missing.add()
+        er_1.entity.key.CopyFrom(key_pb1)
+        er_2 = rsp_pb.missing.add()
+        er_2.entity.key.CopyFrom(key_pb2)
+        read_options = datastore_pb2.ReadOptions()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb1, key_pb2], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 0)
+        self.assertEqual(len(response.deferred), 0)
+        missing_keys = [result.entity.key for result in response.missing]
+        self.assertEqual(missing_keys, [key_pb1, key_pb2])
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb1, key_pb2])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_lookup_multiple_keys_w_deferred(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        key_pb1 = _make_key_pb(project)
+        key_pb2 = _make_key_pb(project, id_=2345)
+        rsp_pb = datastore_pb2.LookupResponse()
+        rsp_pb.deferred.add().CopyFrom(key_pb1)
+        rsp_pb.deferred.add().CopyFrom(key_pb2)
+        read_options = datastore_pb2.ReadOptions()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.lookup(project, [key_pb1, key_pb2], read_options=read_options)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        uri = _build_expected_url(client._base_url, project, "lookup")
+        self.assertEqual(len(response.found), 0)
+        self.assertEqual(len(response.missing), 0)
+        self.assertEqual(list(response.deferred), [key_pb1, key_pb2])
+
+        request = _verify_protobuf_call(http, uri, datastore_pb2.LookupRequest())
+        self.assertEqual(list(request.keys), [key_pb1, key_pb2])
+        self.assertEqual(request.read_options, read_options)
+
+    def test_run_query_w_eventual_no_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        project = "PROJECT"
+        kind = "Nonesuch"
+        cursor = b"\x00"
+        query_pb = self._make_query_pb(kind)
+        partition_id = entity_pb2.PartitionId(project_id=project)
+        read_options = datastore_pb2.ReadOptions(
+            read_consistency=datastore_pb2.ReadOptions.EVENTUAL
+        )
+        rsp_pb = datastore_pb2.RunQueryResponse(
+            batch=query_pb2.QueryResultBatch(
+                entity_result_type=query_pb2.EntityResult.FULL,
+                end_cursor=cursor,
+                more_results=query_pb2.QueryResultBatch.NO_MORE_RESULTS,
+            )
+        )
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.run_query(project, partition_id, read_options, query=query_pb)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "runQuery")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.RunQueryRequest())
+        self.assertEqual(request.partition_id, partition_id)
+        self.assertEqual(request.query, query_pb)
+        self.assertEqual(request.read_options, read_options)
+
+    def test_run_query_wo_eventual_w_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        project = "PROJECT"
+        kind = "Nonesuch"
+        cursor = b"\x00"
+        transaction = b"TRANSACTION"
+        query_pb = self._make_query_pb(kind)
+        partition_id = entity_pb2.PartitionId(project_id=project)
+        read_options = datastore_pb2.ReadOptions(transaction=transaction)
+        rsp_pb = datastore_pb2.RunQueryResponse(
+            batch=query_pb2.QueryResultBatch(
+                entity_result_type=query_pb2.EntityResult.FULL,
+                end_cursor=cursor,
+                more_results=query_pb2.QueryResultBatch.NO_MORE_RESULTS,
+            )
+        )
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.run_query(project, partition_id, read_options, query=query_pb)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "runQuery")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.RunQueryRequest())
+        self.assertEqual(request.partition_id, partition_id)
+        self.assertEqual(request.query, query_pb)
+        self.assertEqual(request.read_options, read_options)
+
+    def test_run_query_wo_namespace_empty_result(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        project = "PROJECT"
+        kind = "Nonesuch"
+        cursor = b"\x00"
+        query_pb = self._make_query_pb(kind)
+        partition_id = entity_pb2.PartitionId(project_id=project)
+        read_options = datastore_pb2.ReadOptions()
+        rsp_pb = datastore_pb2.RunQueryResponse(
+            batch=query_pb2.QueryResultBatch(
+                entity_result_type=query_pb2.EntityResult.FULL,
+                end_cursor=cursor,
+                more_results=query_pb2.QueryResultBatch.NO_MORE_RESULTS,
+            )
+        )
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.run_query(project, partition_id, read_options, query=query_pb)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "runQuery")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.RunQueryRequest())
+        self.assertEqual(request.partition_id, partition_id)
+        self.assertEqual(request.query, query_pb)
+        self.assertEqual(request.read_options, read_options)
+
+    def test_run_query_w_namespace_nonempty_result(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        project = "PROJECT"
+        kind = "Kind"
+        namespace = "NS"
+        query_pb = self._make_query_pb(kind)
+        partition_id = entity_pb2.PartitionId(
+            project_id=project, namespace_id=namespace
+        )
+        read_options = datastore_pb2.ReadOptions()
+        rsp_pb = datastore_pb2.RunQueryResponse(
+            batch=query_pb2.QueryResultBatch(
+                entity_result_type=query_pb2.EntityResult.FULL,
+                entity_results=[query_pb2.EntityResult(entity=entity_pb2.Entity())],
+                more_results=query_pb2.QueryResultBatch.NO_MORE_RESULTS,
+            )
+        )
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.run_query(project, partition_id, read_options, query=query_pb)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "runQuery")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.RunQueryRequest())
+        self.assertEqual(request.partition_id, partition_id)
+        self.assertEqual(request.query, query_pb)
+
+    def test_begin_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        transaction = b"TRANSACTION"
+        rsp_pb = datastore_pb2.BeginTransactionResponse()
+        rsp_pb.transaction = transaction
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.begin_transaction(project)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "beginTransaction")
+        request = _verify_protobuf_call(
+            http, uri, datastore_pb2.BeginTransactionRequest()
+        )
+        # The RPC-over-HTTP request does not set the project in the request.
+        self.assertEqual(request.project_id, u"")
+
+    def test_commit_wo_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        project = "PROJECT"
+        key_pb = _make_key_pb(project)
+        rsp_pb = datastore_pb2.CommitResponse()
+        req_pb = datastore_pb2.CommitRequest()
+        mutation = req_pb.mutations.add()
+        insert = mutation.upsert
+        insert.key.CopyFrom(key_pb)
+        value_pb = _new_value_pb(insert, "foo")
+        value_pb.string_value = u"Foo"
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        rq_class = datastore_pb2.CommitRequest
+        ds_api = self._make_one(client)
+        mode = rq_class.NON_TRANSACTIONAL
+        result = ds_api.commit(project, mode, [mutation])
+
+        # Check the result and verify the callers.
+        self.assertEqual(result, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "commit")
+        request = _verify_protobuf_call(http, uri, rq_class())
+        self.assertEqual(request.transaction, b"")
+        self.assertEqual(list(request.mutations), [mutation])
+        self.assertEqual(request.mode, rq_class.NON_TRANSACTIONAL)
+
+    def test_commit_w_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        project = "PROJECT"
+        key_pb = _make_key_pb(project)
+        rsp_pb = datastore_pb2.CommitResponse()
+        req_pb = datastore_pb2.CommitRequest()
+        mutation = req_pb.mutations.add()
+        insert = mutation.upsert
+        insert.key.CopyFrom(key_pb)
+        value_pb = _new_value_pb(insert, "foo")
+        value_pb.string_value = u"Foo"
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        rq_class = datastore_pb2.CommitRequest
+        ds_api = self._make_one(client)
+        mode = rq_class.TRANSACTIONAL
+        result = ds_api.commit(project, mode, [mutation], transaction=b"xact")
+
+        # Check the result and verify the callers.
+        self.assertEqual(result, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "commit")
+        request = _verify_protobuf_call(http, uri, rq_class())
+        self.assertEqual(request.transaction, b"xact")
+        self.assertEqual(list(request.mutations), [mutation])
+        self.assertEqual(request.mode, rq_class.TRANSACTIONAL)
+
+    def test_rollback_ok(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        transaction = b"xact"
+        rsp_pb = datastore_pb2.RollbackResponse()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.rollback(project, transaction)
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "rollback")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.RollbackRequest())
+        self.assertEqual(request.transaction, transaction)
+
+    def test_allocate_ids_empty(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        rsp_pb = datastore_pb2.AllocateIdsResponse()
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.allocate_ids(project, [])
+
+        # Check the result and verify the callers.
+        self.assertEqual(response, rsp_pb)
+        self.assertEqual(list(response.keys), [])
+
+        uri = _build_expected_url(client._base_url, project, "allocateIds")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.AllocateIdsRequest())
+        self.assertEqual(list(request.keys), [])
+
+    def test_allocate_ids_non_empty(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        before_key_pbs = [
+            _make_key_pb(project, id_=None),
+            _make_key_pb(project, id_=None),
+        ]
+        after_key_pbs = [_make_key_pb(project), _make_key_pb(project, id_=2345)]
+        rsp_pb = datastore_pb2.AllocateIdsResponse()
+        rsp_pb.keys.add().CopyFrom(after_key_pbs[0])
+        rsp_pb.keys.add().CopyFrom(after_key_pbs[1])
+
+        # Create mock HTTP and client with response.
+        http = _make_requests_session(
+            [_make_response(content=rsp_pb.SerializeToString())]
+        )
+        client_info = _make_client_info()
+        client = mock.Mock(
+            _http=http,
+            _base_url="test.invalid",
+            _client_info=client_info,
+            spec=["_http", "_base_url", "_client_info"],
+        )
+
+        # Make request.
+        ds_api = self._make_one(client)
+        response = ds_api.allocate_ids(project, before_key_pbs)
+
+        # Check the result and verify the callers.
+        self.assertEqual(list(response.keys), after_key_pbs)
+        self.assertEqual(response, rsp_pb)
+
+        uri = _build_expected_url(client._base_url, project, "allocateIds")
+        request = _verify_protobuf_call(http, uri, datastore_pb2.AllocateIdsRequest())
+        self.assertEqual(len(request.keys), len(before_key_pbs))
+        for key_before, key_after in zip(before_key_pbs, request.keys):
+            self.assertEqual(key_before, key_after)
+
+
+def _make_response(status=http_client.OK, content=b"", headers={}):
+    response = requests.Response()
+    response.status_code = status
+    response._content = content
+    response.headers = headers
+    response.request = requests.Request()
+    return response
+
+
+def _make_requests_session(responses):
+    session = mock.create_autospec(requests.Session, instance=True)
+    session.request.side_effect = responses
+    return session
+
+
+def _build_expected_url(api_base_url, project, method):
+    from google.cloud.datastore._http import API_VERSION
+
+    return "/".join([api_base_url, API_VERSION, "projects", project + ":" + method])
+
+
+def _make_key_pb(project, id_=1234):
+    from google.cloud.datastore.key import Key
+
+    path_args = ("Kind",)
+    if id_ is not None:
+        path_args += (id_,)
+    return Key(*path_args, project=project).to_protobuf()
+
+
+_USER_AGENT = "TESTING USER AGENT"
+
+
+def _make_client_info(user_agent=_USER_AGENT):
+    from google.api_core.client_info import ClientInfo
+
+    client_info = mock.create_autospec(ClientInfo)
+    client_info.to_user_agent.return_value = user_agent
+    return client_info
+
+
+def _verify_protobuf_call(http, expected_url, pb):
+    from google.cloud import _http as connection_module
+
+    expected_headers = {
+        "Content-Type": "application/x-protobuf",
+        "User-Agent": _USER_AGENT,
+        connection_module.CLIENT_INFO_HEADER: _USER_AGENT,
+    }
+
+    http.request.assert_called_once_with(
+        method="POST", url=expected_url, headers=expected_headers, data=mock.ANY
+    )
+
+    data = http.request.mock_calls[0][2]["data"]
+    pb.ParseFromString(data)
+    return pb
diff --git a/datastore/tests/unit/test_batch.py b/datastore/tests/unit/test_batch.py
new file mode 100644
index 000000000000..8516e78c0c7a
--- /dev/null
+++ b/datastore/tests/unit/test_batch.py
@@ -0,0 +1,493 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestBatch(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.batch import Batch
+
+        return Batch
+
+    def _make_one(self, client):
+        return self._get_target_class()(client)
+
+    def test_ctor(self):
+        project = "PROJECT"
+        namespace = "NAMESPACE"
+        client = _Client(project, namespace=namespace)
+        batch = self._make_one(client)
+
+        self.assertEqual(batch.project, project)
+        self.assertIs(batch._client, client)
+        self.assertEqual(batch.namespace, namespace)
+        self.assertIsNone(batch._id)
+        self.assertEqual(batch._status, batch._INITIAL)
+        self.assertEqual(batch._mutations, [])
+        self.assertEqual(batch._partial_key_entities, [])
+
+    def test_current(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        client = _Client(project)
+        batch1 = self._make_one(client)
+        batch2 = self._make_one(client)
+        self.assertIsNone(batch1.current())
+        self.assertIsNone(batch2.current())
+        with batch1:
+            self.assertIs(batch1.current(), batch1)
+            self.assertIs(batch2.current(), batch1)
+            with batch2:
+                self.assertIs(batch1.current(), batch2)
+                self.assertIs(batch2.current(), batch2)
+            self.assertIs(batch1.current(), batch1)
+            self.assertIs(batch2.current(), batch1)
+        self.assertIsNone(batch1.current())
+        self.assertIsNone(batch2.current())
+
+        commit_method = client._datastore_api.commit
+        self.assertEqual(commit_method.call_count, 2)
+        mode = datastore_pb2.CommitRequest.NON_TRANSACTIONAL
+        commit_method.assert_called_with(project, mode, [], transaction=None)
+
+    def test_put_entity_wo_key(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+
+        batch.begin()
+        self.assertRaises(ValueError, batch.put, _Entity())
+
+    def test_put_entity_wrong_status(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+        entity = _Entity()
+        entity.key = _Key("OTHER")
+
+        self.assertEqual(batch._status, batch._INITIAL)
+        self.assertRaises(ValueError, batch.put, entity)
+
+    def test_put_entity_w_key_wrong_project(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+        entity = _Entity()
+        entity.key = _Key("OTHER")
+
+        batch.begin()
+        self.assertRaises(ValueError, batch.put, entity)
+
+    def test_put_entity_w_partial_key(self):
+        project = "PROJECT"
+        properties = {"foo": "bar"}
+        client = _Client(project)
+        batch = self._make_one(client)
+        entity = _Entity(properties)
+        key = entity.key = _Key(project)
+        key._id = None
+
+        batch.begin()
+        batch.put(entity)
+
+        mutated_entity = _mutated_pb(self, batch.mutations, "insert")
+        self.assertEqual(mutated_entity.key, key._key)
+        self.assertEqual(batch._partial_key_entities, [entity])
+
+    def test_put_entity_w_completed_key(self):
+        from google.cloud.datastore.helpers import _property_tuples
+
+        project = "PROJECT"
+        properties = {"foo": "bar", "baz": "qux", "spam": [1, 2, 3], "frotz": []}
+        client = _Client(project)
+        batch = self._make_one(client)
+        entity = _Entity(properties)
+        entity.exclude_from_indexes = ("baz", "spam")
+        key = entity.key = _Key(project)
+
+        batch.begin()
+        batch.put(entity)
+
+        mutated_entity = _mutated_pb(self, batch.mutations, "upsert")
+        self.assertEqual(mutated_entity.key, key._key)
+
+        prop_dict = dict(_property_tuples(mutated_entity))
+        self.assertEqual(len(prop_dict), 4)
+        self.assertFalse(prop_dict["foo"].exclude_from_indexes)
+        self.assertTrue(prop_dict["baz"].exclude_from_indexes)
+        self.assertFalse(prop_dict["spam"].exclude_from_indexes)
+        spam_values = prop_dict["spam"].array_value.values
+        self.assertTrue(spam_values[0].exclude_from_indexes)
+        self.assertTrue(spam_values[1].exclude_from_indexes)
+        self.assertTrue(spam_values[2].exclude_from_indexes)
+        self.assertTrue("frotz" in prop_dict)
+
+    def test_delete_wrong_status(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+        key = _Key(project)
+        key._id = None
+
+        self.assertEqual(batch._status, batch._INITIAL)
+        self.assertRaises(ValueError, batch.delete, key)
+
+    def test_delete_w_partial_key(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+        key = _Key(project)
+        key._id = None
+
+        batch.begin()
+        self.assertRaises(ValueError, batch.delete, key)
+
+    def test_delete_w_key_wrong_project(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+        key = _Key("OTHER")
+
+        batch.begin()
+        self.assertRaises(ValueError, batch.delete, key)
+
+    def test_delete_w_completed_key(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+        key = _Key(project)
+
+        batch.begin()
+        batch.delete(key)
+
+        mutated_key = _mutated_pb(self, batch.mutations, "delete")
+        self.assertEqual(mutated_key, key._key)
+
+    def test_begin(self):
+        project = "PROJECT"
+        client = _Client(project, None)
+        batch = self._make_one(client)
+        self.assertEqual(batch._status, batch._INITIAL)
+        batch.begin()
+        self.assertEqual(batch._status, batch._IN_PROGRESS)
+
+    def test_begin_fail(self):
+        project = "PROJECT"
+        client = _Client(project, None)
+        batch = self._make_one(client)
+        batch._status = batch._IN_PROGRESS
+        with self.assertRaises(ValueError):
+            batch.begin()
+
+    def test_rollback(self):
+        project = "PROJECT"
+        client = _Client(project, None)
+        batch = self._make_one(client)
+        batch.begin()
+        self.assertEqual(batch._status, batch._IN_PROGRESS)
+        batch.rollback()
+        self.assertEqual(batch._status, batch._ABORTED)
+
+    def test_rollback_wrong_status(self):
+        project = "PROJECT"
+        client = _Client(project, None)
+        batch = self._make_one(client)
+
+        self.assertEqual(batch._status, batch._INITIAL)
+        self.assertRaises(ValueError, batch.rollback)
+
+    def test_commit(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+
+        self.assertEqual(batch._status, batch._INITIAL)
+        batch.begin()
+        self.assertEqual(batch._status, batch._IN_PROGRESS)
+        batch.commit()
+        self.assertEqual(batch._status, batch._FINISHED)
+
+        commit_method = client._datastore_api.commit
+        mode = datastore_pb2.CommitRequest.NON_TRANSACTIONAL
+        commit_method.assert_called_with(project, mode, [], transaction=None)
+
+    def test_commit_wrong_status(self):
+        project = "PROJECT"
+        client = _Client(project)
+        batch = self._make_one(client)
+
+        self.assertEqual(batch._status, batch._INITIAL)
+        self.assertRaises(ValueError, batch.commit)
+
+    def test_commit_w_partial_key_entities(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        new_id = 1234
+        ds_api = _make_datastore_api(new_id)
+        client = _Client(project, datastore_api=ds_api)
+        batch = self._make_one(client)
+        entity = _Entity({})
+        key = entity.key = _Key(project)
+        key._id = None
+        batch._partial_key_entities.append(entity)
+
+        self.assertEqual(batch._status, batch._INITIAL)
+        batch.begin()
+        self.assertEqual(batch._status, batch._IN_PROGRESS)
+        batch.commit()
+        self.assertEqual(batch._status, batch._FINISHED)
+
+        mode = datastore_pb2.CommitRequest.NON_TRANSACTIONAL
+        ds_api.commit.assert_called_once_with(project, mode, [], transaction=None)
+        self.assertFalse(entity.key.is_partial)
+        self.assertEqual(entity.key._id, new_id)
+
+    def test_as_context_mgr_wo_error(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        properties = {"foo": "bar"}
+        entity = _Entity(properties)
+        key = entity.key = _Key(project)
+
+        client = _Client(project)
+        self.assertEqual(list(client._batches), [])
+
+        with self._make_one(client) as batch:
+            self.assertEqual(list(client._batches), [batch])
+            batch.put(entity)
+
+        self.assertEqual(list(client._batches), [])
+
+        mutated_entity = _mutated_pb(self, batch.mutations, "upsert")
+        self.assertEqual(mutated_entity.key, key._key)
+        commit_method = client._datastore_api.commit
+        mode = datastore_pb2.CommitRequest.NON_TRANSACTIONAL
+        commit_method.assert_called_with(
+            project, mode, batch.mutations, transaction=None
+        )
+
+    def test_as_context_mgr_nested(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        properties = {"foo": "bar"}
+        entity1 = _Entity(properties)
+        key1 = entity1.key = _Key(project)
+        entity2 = _Entity(properties)
+        key2 = entity2.key = _Key(project)
+
+        client = _Client(project)
+        self.assertEqual(list(client._batches), [])
+
+        with self._make_one(client) as batch1:
+            self.assertEqual(list(client._batches), [batch1])
+            batch1.put(entity1)
+            with self._make_one(client) as batch2:
+                self.assertEqual(list(client._batches), [batch2, batch1])
+                batch2.put(entity2)
+
+            self.assertEqual(list(client._batches), [batch1])
+
+        self.assertEqual(list(client._batches), [])
+
+        mutated_entity1 = _mutated_pb(self, batch1.mutations, "upsert")
+        self.assertEqual(mutated_entity1.key, key1._key)
+
+        mutated_entity2 = _mutated_pb(self, batch2.mutations, "upsert")
+        self.assertEqual(mutated_entity2.key, key2._key)
+
+        commit_method = client._datastore_api.commit
+        self.assertEqual(commit_method.call_count, 2)
+        mode = datastore_pb2.CommitRequest.NON_TRANSACTIONAL
+        commit_method.assert_called_with(
+            project, mode, batch1.mutations, transaction=None
+        )
+        commit_method.assert_called_with(
+            project, mode, batch2.mutations, transaction=None
+        )
+
+    def test_as_context_mgr_w_error(self):
+        project = "PROJECT"
+        properties = {"foo": "bar"}
+        entity = _Entity(properties)
+        key = entity.key = _Key(project)
+
+        client = _Client(project)
+        self.assertEqual(list(client._batches), [])
+
+        try:
+            with self._make_one(client) as batch:
+                self.assertEqual(list(client._batches), [batch])
+                batch.put(entity)
+                raise ValueError("testing")
+        except ValueError:
+            pass
+
+        self.assertEqual(list(client._batches), [])
+
+        mutated_entity = _mutated_pb(self, batch.mutations, "upsert")
+        self.assertEqual(mutated_entity.key, key._key)
+
+    def test_as_context_mgr_enter_fails(self):
+        klass = self._get_target_class()
+
+        class FailedBegin(klass):
+            def begin(self):
+                raise RuntimeError
+
+        client = _Client(None, None)
+        self.assertEqual(client._batches, [])
+
+        batch = FailedBegin(client)
+        with self.assertRaises(RuntimeError):
+            # The context manager will never be entered because
+            # of the failure.
+            with batch:  # pragma: NO COVER
+                pass
+        # Make sure no batch was added.
+        self.assertEqual(client._batches, [])
+
+
+class Test__parse_commit_response(unittest.TestCase):
+    def _call_fut(self, commit_response_pb):
+        from google.cloud.datastore.batch import _parse_commit_response
+
+        return _parse_commit_response(commit_response_pb)
+
+    def test_it(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        index_updates = 1337
+        keys = [
+            entity_pb2.Key(path=[entity_pb2.Key.PathElement(kind="Foo", id=1234)]),
+            entity_pb2.Key(path=[entity_pb2.Key.PathElement(kind="Bar", name="baz")]),
+        ]
+        response = datastore_pb2.CommitResponse(
+            mutation_results=[datastore_pb2.MutationResult(key=key) for key in keys],
+            index_updates=index_updates,
+        )
+        result = self._call_fut(response)
+        self.assertEqual(result, (index_updates, keys))
+
+
+class _Entity(dict):
+    key = None
+    exclude_from_indexes = ()
+    _meanings = {}
+
+
+class _Key(object):
+    _kind = "KIND"
+    _key = "KEY"
+    _path = None
+    _id = 1234
+    _stored = None
+
+    def __init__(self, project):
+        self.project = project
+
+    @property
+    def is_partial(self):
+        return self._id is None
+
+    def to_protobuf(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        key = self._key = entity_pb2.Key()
+        # Don't assign it, because it will just get ripped out
+        # key.partition_id.project_id = self.project
+
+        element = key.path.add()
+        element.kind = self._kind
+        if self._id is not None:
+            element.id = self._id
+
+        return key
+
+    def completed_key(self, new_id):
+        assert self.is_partial
+        new_key = self.__class__(self.project)
+        new_key._id = new_id
+        return new_key
+
+
+class _Client(object):
+    def __init__(self, project, datastore_api=None, namespace=None):
+        self.project = project
+        if datastore_api is None:
+            datastore_api = _make_datastore_api()
+        self._datastore_api = datastore_api
+        self.namespace = namespace
+        self._batches = []
+
+    def _push_batch(self, batch):
+        self._batches.insert(0, batch)
+
+    def _pop_batch(self):
+        return self._batches.pop(0)
+
+    @property
+    def current_batch(self):
+        if self._batches:
+            return self._batches[0]
+
+
+def _assert_num_mutations(test_case, mutation_pb_list, num_mutations):
+    test_case.assertEqual(len(mutation_pb_list), num_mutations)
+
+
+def _mutated_pb(test_case, mutation_pb_list, mutation_type):
+    # Make sure there is only one mutation.
+    _assert_num_mutations(test_case, mutation_pb_list, 1)
+
+    # We grab the only mutation.
+    mutated_pb = mutation_pb_list[0]
+    # Then check if it is the correct type.
+    test_case.assertEqual(mutated_pb.WhichOneof("operation"), mutation_type)
+
+    return getattr(mutated_pb, mutation_type)
+
+
+def _make_mutation(id_):
+    from google.cloud.datastore_v1.proto import datastore_pb2
+    from google.cloud.datastore_v1.proto import entity_pb2
+
+    key = entity_pb2.Key()
+    key.partition_id.project_id = "PROJECT"
+    elem = key.path.add()
+    elem.kind = "Kind"
+    elem.id = id_
+    return datastore_pb2.MutationResult(key=key)
+
+
+def _make_commit_response(*new_key_ids):
+    from google.cloud.datastore_v1.proto import datastore_pb2
+
+    mutation_results = [_make_mutation(key_id) for key_id in new_key_ids]
+    return datastore_pb2.CommitResponse(mutation_results=mutation_results)
+
+
+def _make_datastore_api(*new_key_ids):
+    commit_method = mock.Mock(return_value=_make_commit_response(*new_key_ids), spec=[])
+    return mock.Mock(commit=commit_method, spec=["commit"])
diff --git a/datastore/tests/unit/test_client.py b/datastore/tests/unit/test_client.py
new file mode 100644
index 000000000000..171a93eda4db
--- /dev/null
+++ b/datastore/tests/unit/test_client.py
@@ -0,0 +1,1228 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_entity_pb(project, kind, integer_id, name=None, str_val=None):
+    from google.cloud.datastore_v1.proto import entity_pb2
+    from google.cloud.datastore.helpers import _new_value_pb
+
+    entity_pb = entity_pb2.Entity()
+    entity_pb.key.partition_id.project_id = project
+    path_element = entity_pb.key.path.add()
+    path_element.kind = kind
+    path_element.id = integer_id
+    if name is not None and str_val is not None:
+        value_pb = _new_value_pb(entity_pb, name)
+        value_pb.string_value = str_val
+
+    return entity_pb
+
+
+class Test__get_gcd_project(unittest.TestCase):
+    def _call_fut(self):
+        from google.cloud.datastore.client import _get_gcd_project
+
+        return _get_gcd_project()
+
+    def test_no_value(self):
+        environ = {}
+        with mock.patch("os.getenv", new=environ.get):
+            project = self._call_fut()
+            self.assertIsNone(project)
+
+    def test_value_set(self):
+        from google.cloud.datastore.client import GCD_DATASET
+
+        MOCK_PROJECT = object()
+        environ = {GCD_DATASET: MOCK_PROJECT}
+        with mock.patch("os.getenv", new=environ.get):
+            project = self._call_fut()
+            self.assertEqual(project, MOCK_PROJECT)
+
+
+class Test__determine_default_project(unittest.TestCase):
+    def _call_fut(self, project=None):
+        from google.cloud.datastore.client import _determine_default_project
+
+        return _determine_default_project(project=project)
+
+    def _determine_default_helper(self, gcd=None, fallback=None, project_called=None):
+        _callers = []
+
+        def gcd_mock():
+            _callers.append("gcd_mock")
+            return gcd
+
+        def fallback_mock(project=None):
+            _callers.append(("fallback_mock", project))
+            return fallback
+
+        patch = mock.patch.multiple(
+            "google.cloud.datastore.client",
+            _get_gcd_project=gcd_mock,
+            _base_default_project=fallback_mock,
+        )
+        with patch:
+            returned_project = self._call_fut(project_called)
+
+        return returned_project, _callers
+
+    def test_no_value(self):
+        project, callers = self._determine_default_helper()
+        self.assertIsNone(project)
+        self.assertEqual(callers, ["gcd_mock", ("fallback_mock", None)])
+
+    def test_explicit(self):
+        PROJECT = object()
+        project, callers = self._determine_default_helper(project_called=PROJECT)
+        self.assertEqual(project, PROJECT)
+        self.assertEqual(callers, [])
+
+    def test_gcd(self):
+        PROJECT = object()
+        project, callers = self._determine_default_helper(gcd=PROJECT)
+        self.assertEqual(project, PROJECT)
+        self.assertEqual(callers, ["gcd_mock"])
+
+    def test_fallback(self):
+        PROJECT = object()
+        project, callers = self._determine_default_helper(fallback=PROJECT)
+        self.assertEqual(project, PROJECT)
+        self.assertEqual(callers, ["gcd_mock", ("fallback_mock", None)])
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.client import Client
+
+        return Client
+
+    def _make_one(
+        self,
+        project=PROJECT,
+        namespace=None,
+        credentials=None,
+        client_info=None,
+        _http=None,
+        _use_grpc=None,
+    ):
+        return self._get_target_class()(
+            project=project,
+            namespace=namespace,
+            credentials=credentials,
+            client_info=client_info,
+            _http=_http,
+            _use_grpc=_use_grpc,
+        )
+
+    def test_constructor_w_project_no_environ(self):
+        # Some environments (e.g. AppVeyor CI) run in GCE, so
+        # this test would fail artificially.
+        patch = mock.patch(
+            "google.cloud.datastore.client._base_default_project", return_value=None
+        )
+        with patch:
+            self.assertRaises(EnvironmentError, self._make_one, None)
+
+    def test_constructor_w_implicit_inputs(self):
+        from google.cloud.datastore.client import _CLIENT_INFO
+        from google.cloud.datastore.client import _DATASTORE_BASE_URL
+
+        other = "other"
+        creds = _make_credentials()
+
+        klass = self._get_target_class()
+        patch1 = mock.patch(
+            "google.cloud.datastore.client._determine_default_project",
+            return_value=other,
+        )
+        patch2 = mock.patch("google.auth.default", return_value=(creds, None))
+
+        with patch1 as _determine_default_project:
+            with patch2 as default:
+                client = klass()
+
+        self.assertEqual(client.project, other)
+        self.assertIsNone(client.namespace)
+        self.assertIs(client._credentials, creds)
+        self.assertIs(client._client_info, _CLIENT_INFO)
+        self.assertIsNone(client._http_internal)
+        self.assertEqual(client.base_url, _DATASTORE_BASE_URL)
+
+        self.assertIsNone(client.current_batch)
+        self.assertIsNone(client.current_transaction)
+
+        default.assert_called_once_with()
+        _determine_default_project.assert_called_once_with(None)
+
+    def test_constructor_w_explicit_inputs(self):
+        from google.cloud.datastore.client import _DATASTORE_BASE_URL
+
+        other = "other"
+        namespace = "namespace"
+        creds = _make_credentials()
+        client_info = mock.Mock()
+        http = object()
+        client = self._make_one(
+            project=other,
+            namespace=namespace,
+            credentials=creds,
+            client_info=client_info,
+            _http=http,
+        )
+        self.assertEqual(client.project, other)
+        self.assertEqual(client.namespace, namespace)
+        self.assertIs(client._credentials, creds)
+        self.assertIs(client._client_info, client_info)
+        self.assertIs(client._http_internal, http)
+        self.assertIsNone(client.current_batch)
+        self.assertEqual(list(client._batch_stack), [])
+        self.assertEqual(client.base_url, _DATASTORE_BASE_URL)
+
+    def test_constructor_use_grpc_default(self):
+        import google.cloud.datastore.client as MUT
+
+        project = "PROJECT"
+        creds = _make_credentials()
+        http = object()
+
+        with mock.patch.object(MUT, "_USE_GRPC", new=True):
+            client1 = self._make_one(project=project, credentials=creds, _http=http)
+            self.assertTrue(client1._use_grpc)
+            # Explicitly over-ride the environment.
+            client2 = self._make_one(
+                project=project, credentials=creds, _http=http, _use_grpc=False
+            )
+            self.assertFalse(client2._use_grpc)
+
+        with mock.patch.object(MUT, "_USE_GRPC", new=False):
+            client3 = self._make_one(project=project, credentials=creds, _http=http)
+            self.assertFalse(client3._use_grpc)
+            # Explicitly over-ride the environment.
+            client4 = self._make_one(
+                project=project, credentials=creds, _http=http, _use_grpc=True
+            )
+            self.assertTrue(client4._use_grpc)
+
+    def test_constructor_gcd_host(self):
+        from google.cloud.environment_vars import GCD_HOST
+
+        host = "localhost:1234"
+        fake_environ = {GCD_HOST: host}
+        project = "PROJECT"
+        creds = _make_credentials()
+        http = object()
+
+        with mock.patch("os.environ", new=fake_environ):
+            client = self._make_one(project=project, credentials=creds, _http=http)
+            self.assertEqual(client.base_url, "http://" + host)
+
+    def test_base_url_property(self):
+        alternate_url = "https://alias.example.com/"
+        project = "PROJECT"
+        creds = _make_credentials()
+        http = object()
+
+        client = self._make_one(project=project, credentials=creds, _http=http)
+        client.base_url = alternate_url
+        self.assertEqual(client.base_url, alternate_url)
+
+    def test__datastore_api_property_already_set(self):
+        client = self._make_one(
+            project="prahj-ekt", credentials=_make_credentials(), _use_grpc=True
+        )
+        already = client._datastore_api_internal = object()
+        self.assertIs(client._datastore_api, already)
+
+    def test__datastore_api_property_gapic(self):
+        client_info = mock.Mock()
+        client = self._make_one(
+            project="prahj-ekt",
+            credentials=_make_credentials(),
+            client_info=client_info,
+            _http=object(),
+            _use_grpc=True,
+        )
+
+        self.assertIsNone(client._datastore_api_internal)
+        patch = mock.patch(
+            "google.cloud.datastore.client.make_datastore_api",
+            return_value=mock.sentinel.ds_api,
+        )
+        with patch as make_api:
+            ds_api = client._datastore_api
+
+        self.assertIs(ds_api, mock.sentinel.ds_api)
+        self.assertIs(client._datastore_api_internal, mock.sentinel.ds_api)
+        make_api.assert_called_once_with(client)
+
+    def test__datastore_api_property_http(self):
+        client_info = mock.Mock()
+        client = self._make_one(
+            project="prahj-ekt",
+            credentials=_make_credentials(),
+            client_info=client_info,
+            _http=object(),
+            _use_grpc=False,
+        )
+
+        self.assertIsNone(client._datastore_api_internal)
+        patch = mock.patch(
+            "google.cloud.datastore.client.HTTPDatastoreAPI",
+            return_value=mock.sentinel.ds_api,
+        )
+        with patch as make_api:
+            ds_api = client._datastore_api
+
+        self.assertIs(ds_api, mock.sentinel.ds_api)
+        self.assertIs(client._datastore_api_internal, mock.sentinel.ds_api)
+        make_api.assert_called_once_with(client)
+
+    def test__push_batch_and__pop_batch(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        batch = client.batch()
+        xact = client.transaction()
+        client._push_batch(batch)
+        self.assertEqual(list(client._batch_stack), [batch])
+        self.assertIs(client.current_batch, batch)
+        self.assertIsNone(client.current_transaction)
+        client._push_batch(xact)
+        self.assertIs(client.current_batch, xact)
+        self.assertIs(client.current_transaction, xact)
+        # list(_LocalStack) returns in reverse order.
+        self.assertEqual(list(client._batch_stack), [xact, batch])
+        self.assertIs(client._pop_batch(), xact)
+        self.assertEqual(list(client._batch_stack), [batch])
+        self.assertIs(client._pop_batch(), batch)
+        self.assertEqual(list(client._batch_stack), [])
+
+    def test_get_miss(self):
+        _called_with = []
+
+        def _get_multi(*args, **kw):
+            _called_with.append((args, kw))
+            return []
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client.get_multi = _get_multi
+
+        key = object()
+
+        self.assertIsNone(client.get(key))
+
+        self.assertEqual(_called_with[0][0], ())
+        self.assertEqual(_called_with[0][1]["keys"], [key])
+        self.assertIsNone(_called_with[0][1]["missing"])
+        self.assertIsNone(_called_with[0][1]["deferred"])
+        self.assertIsNone(_called_with[0][1]["transaction"])
+
+    def test_get_hit(self):
+        TXN_ID = "123"
+        _called_with = []
+        _entity = object()
+
+        def _get_multi(*args, **kw):
+            _called_with.append((args, kw))
+            return [_entity]
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client.get_multi = _get_multi
+
+        key, missing, deferred = object(), [], []
+
+        self.assertIs(client.get(key, missing, deferred, TXN_ID), _entity)
+
+        self.assertEqual(_called_with[0][0], ())
+        self.assertEqual(_called_with[0][1]["keys"], [key])
+        self.assertIs(_called_with[0][1]["missing"], missing)
+        self.assertIs(_called_with[0][1]["deferred"], deferred)
+        self.assertEqual(_called_with[0][1]["transaction"], TXN_ID)
+
+    def test_get_multi_no_keys(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        results = client.get_multi([])
+        self.assertEqual(results, [])
+
+    def test_get_multi_miss(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.key import Key
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        ds_api = _make_datastore_api()
+        client._datastore_api_internal = ds_api
+
+        key = Key("Kind", 1234, project=self.PROJECT)
+        results = client.get_multi([key])
+        self.assertEqual(results, [])
+
+        read_options = datastore_pb2.ReadOptions()
+        ds_api.lookup.assert_called_once_with(
+            self.PROJECT, [key.to_protobuf()], read_options=read_options
+        )
+
+    def test_get_multi_miss_w_missing(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.key import Key
+
+        KIND = "Kind"
+        ID = 1234
+
+        # Make a missing entity pb to be returned from mock backend.
+        missed = entity_pb2.Entity()
+        missed.key.partition_id.project_id = self.PROJECT
+        path_element = missed.key.path.add()
+        path_element.kind = KIND
+        path_element.id = ID
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        # Set missing entity on mock connection.
+        lookup_response = _make_lookup_response(missing=[missed])
+        ds_api = _make_datastore_api(lookup_response=lookup_response)
+        client._datastore_api_internal = ds_api
+
+        key = Key(KIND, ID, project=self.PROJECT)
+        missing = []
+        entities = client.get_multi([key], missing=missing)
+        self.assertEqual(entities, [])
+        key_pb = key.to_protobuf()
+        self.assertEqual([missed.key.to_protobuf() for missed in missing], [key_pb])
+
+        read_options = datastore_pb2.ReadOptions()
+        ds_api.lookup.assert_called_once_with(
+            self.PROJECT, [key_pb], read_options=read_options
+        )
+
+    def test_get_multi_w_missing_non_empty(self):
+        from google.cloud.datastore.key import Key
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        key = Key("Kind", 1234, project=self.PROJECT)
+
+        missing = ["this", "list", "is", "not", "empty"]
+        self.assertRaises(ValueError, client.get_multi, [key], missing=missing)
+
+    def test_get_multi_w_deferred_non_empty(self):
+        from google.cloud.datastore.key import Key
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        key = Key("Kind", 1234, project=self.PROJECT)
+
+        deferred = ["this", "list", "is", "not", "empty"]
+        self.assertRaises(ValueError, client.get_multi, [key], deferred=deferred)
+
+    def test_get_multi_miss_w_deferred(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.key import Key
+
+        key = Key("Kind", 1234, project=self.PROJECT)
+        key_pb = key.to_protobuf()
+
+        # Set deferred entity on mock connection.
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        lookup_response = _make_lookup_response(deferred=[key_pb])
+        ds_api = _make_datastore_api(lookup_response=lookup_response)
+        client._datastore_api_internal = ds_api
+
+        deferred = []
+        entities = client.get_multi([key], deferred=deferred)
+        self.assertEqual(entities, [])
+        self.assertEqual([def_key.to_protobuf() for def_key in deferred], [key_pb])
+
+        read_options = datastore_pb2.ReadOptions()
+        ds_api.lookup.assert_called_once_with(
+            self.PROJECT, [key_pb], read_options=read_options
+        )
+
+    def test_get_multi_w_deferred_from_backend_but_not_passed(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.key import Key
+
+        key1 = Key("Kind", project=self.PROJECT)
+        key1_pb = key1.to_protobuf()
+        key2 = Key("Kind", 2345, project=self.PROJECT)
+        key2_pb = key2.to_protobuf()
+
+        entity1_pb = entity_pb2.Entity()
+        entity1_pb.key.CopyFrom(key1_pb)
+        entity2_pb = entity_pb2.Entity()
+        entity2_pb.key.CopyFrom(key2_pb)
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        # Mock up two separate requests. Using an iterable as side_effect
+        # allows multiple return values.
+        lookup_response1 = _make_lookup_response(
+            results=[entity1_pb], deferred=[key2_pb]
+        )
+        lookup_response2 = _make_lookup_response(results=[entity2_pb])
+        ds_api = _make_datastore_api()
+        ds_api.lookup = mock.Mock(
+            side_effect=[lookup_response1, lookup_response2], spec=[]
+        )
+        client._datastore_api_internal = ds_api
+
+        missing = []
+        found = client.get_multi([key1, key2], missing=missing)
+        self.assertEqual(len(found), 2)
+        self.assertEqual(len(missing), 0)
+
+        # Check the actual contents on the response.
+        self.assertIsInstance(found[0], Entity)
+        self.assertEqual(found[0].key.path, key1.path)
+        self.assertEqual(found[0].key.project, key1.project)
+
+        self.assertIsInstance(found[1], Entity)
+        self.assertEqual(found[1].key.path, key2.path)
+        self.assertEqual(found[1].key.project, key2.project)
+
+        self.assertEqual(ds_api.lookup.call_count, 2)
+        read_options = datastore_pb2.ReadOptions()
+        ds_api.lookup.assert_any_call(
+            self.PROJECT, [key2_pb], read_options=read_options
+        )
+        ds_api.lookup.assert_any_call(
+            self.PROJECT, [key1_pb, key2_pb], read_options=read_options
+        )
+
+    def test_get_multi_hit(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.key import Key
+
+        kind = "Kind"
+        id_ = 1234
+        path = [{"kind": kind, "id": id_}]
+
+        # Make a found entity pb to be returned from mock backend.
+        entity_pb = _make_entity_pb(self.PROJECT, kind, id_, "foo", "Foo")
+
+        # Make a connection to return the entity pb.
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        lookup_response = _make_lookup_response(results=[entity_pb])
+        ds_api = _make_datastore_api(lookup_response=lookup_response)
+        client._datastore_api_internal = ds_api
+
+        key = Key(kind, id_, project=self.PROJECT)
+        result, = client.get_multi([key])
+        new_key = result.key
+
+        # Check the returned value is as expected.
+        self.assertIsNot(new_key, key)
+        self.assertEqual(new_key.project, self.PROJECT)
+        self.assertEqual(new_key.path, path)
+        self.assertEqual(list(result), ["foo"])
+        self.assertEqual(result["foo"], "Foo")
+
+        read_options = datastore_pb2.ReadOptions()
+        ds_api.lookup.assert_called_once_with(
+            self.PROJECT, [key.to_protobuf()], read_options=read_options
+        )
+
+    def test_get_multi_hit_w_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.key import Key
+
+        txn_id = b"123"
+        kind = "Kind"
+        id_ = 1234
+        path = [{"kind": kind, "id": id_}]
+
+        # Make a found entity pb to be returned from mock backend.
+        entity_pb = _make_entity_pb(self.PROJECT, kind, id_, "foo", "Foo")
+
+        # Make a connection to return the entity pb.
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        lookup_response = _make_lookup_response(results=[entity_pb])
+        ds_api = _make_datastore_api(lookup_response=lookup_response)
+        client._datastore_api_internal = ds_api
+
+        key = Key(kind, id_, project=self.PROJECT)
+        txn = client.transaction()
+        txn._id = txn_id
+        result, = client.get_multi([key], transaction=txn)
+        new_key = result.key
+
+        # Check the returned value is as expected.
+        self.assertIsNot(new_key, key)
+        self.assertEqual(new_key.project, self.PROJECT)
+        self.assertEqual(new_key.path, path)
+        self.assertEqual(list(result), ["foo"])
+        self.assertEqual(result["foo"], "Foo")
+
+        read_options = datastore_pb2.ReadOptions(transaction=txn_id)
+        ds_api.lookup.assert_called_once_with(
+            self.PROJECT, [key.to_protobuf()], read_options=read_options
+        )
+
+    def test_get_multi_hit_multiple_keys_same_project(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.key import Key
+
+        kind = "Kind"
+        id1 = 1234
+        id2 = 2345
+
+        # Make a found entity pb to be returned from mock backend.
+        entity_pb1 = _make_entity_pb(self.PROJECT, kind, id1)
+        entity_pb2 = _make_entity_pb(self.PROJECT, kind, id2)
+
+        # Make a connection to return the entity pbs.
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        lookup_response = _make_lookup_response(results=[entity_pb1, entity_pb2])
+        ds_api = _make_datastore_api(lookup_response=lookup_response)
+        client._datastore_api_internal = ds_api
+
+        key1 = Key(kind, id1, project=self.PROJECT)
+        key2 = Key(kind, id2, project=self.PROJECT)
+        retrieved1, retrieved2 = client.get_multi([key1, key2])
+
+        # Check values match.
+        self.assertEqual(retrieved1.key.path, key1.path)
+        self.assertEqual(dict(retrieved1), {})
+        self.assertEqual(retrieved2.key.path, key2.path)
+        self.assertEqual(dict(retrieved2), {})
+
+        read_options = datastore_pb2.ReadOptions()
+        ds_api.lookup.assert_called_once_with(
+            self.PROJECT,
+            [key1.to_protobuf(), key2.to_protobuf()],
+            read_options=read_options,
+        )
+
+    def test_get_multi_hit_multiple_keys_different_project(self):
+        from google.cloud.datastore.key import Key
+
+        PROJECT1 = "PROJECT"
+        PROJECT2 = "PROJECT-ALT"
+
+        # Make sure our IDs are actually different.
+        self.assertNotEqual(PROJECT1, PROJECT2)
+
+        key1 = Key("KIND", 1234, project=PROJECT1)
+        key2 = Key("KIND", 1234, project=PROJECT2)
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        with self.assertRaises(ValueError):
+            client.get_multi([key1, key2])
+
+    def test_get_multi_max_loops(self):
+        from google.cloud.datastore.key import Key
+
+        kind = "Kind"
+        id_ = 1234
+
+        # Make a found entity pb to be returned from mock backend.
+        entity_pb = _make_entity_pb(self.PROJECT, kind, id_, "foo", "Foo")
+
+        # Make a connection to return the entity pb.
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        lookup_response = _make_lookup_response(results=[entity_pb])
+        ds_api = _make_datastore_api(lookup_response=lookup_response)
+        client._datastore_api_internal = ds_api
+
+        key = Key(kind, id_, project=self.PROJECT)
+        deferred = []
+        missing = []
+
+        patch = mock.patch("google.cloud.datastore.client._MAX_LOOPS", new=-1)
+        with patch:
+            result = client.get_multi([key], missing=missing, deferred=deferred)
+
+        # Make sure we have no results, even though the connection has been
+        # set up as in `test_hit` to return a single result.
+        self.assertEqual(result, [])
+        self.assertEqual(missing, [])
+        self.assertEqual(deferred, [])
+        ds_api.lookup.assert_not_called()
+
+    def test_put(self):
+        _called_with = []
+
+        def _put_multi(*args, **kw):
+            _called_with.append((args, kw))
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client.put_multi = _put_multi
+        entity = object()
+
+        client.put(entity)
+
+        self.assertEqual(_called_with[0][0], ())
+        self.assertEqual(_called_with[0][1]["entities"], [entity])
+
+    def test_put_multi_no_entities(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        self.assertIsNone(client.put_multi([]))
+
+    def test_put_multi_w_single_empty_entity(self):
+        # https://github.com/GoogleCloudPlatform/google-cloud-python/issues/649
+        from google.cloud.datastore.entity import Entity
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        self.assertRaises(ValueError, client.put_multi, Entity())
+
+    def test_put_multi_no_batch_w_partial_key(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore.helpers import _property_tuples
+
+        entity = _Entity(foo=u"bar")
+        key = entity.key = _Key(self.PROJECT)
+        key._id = None
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        key_pb = _make_key(234)
+        ds_api = _make_datastore_api(key_pb)
+        client._datastore_api_internal = ds_api
+
+        result = client.put_multi([entity])
+        self.assertIsNone(result)
+
+        self.assertEqual(ds_api.commit.call_count, 1)
+        _, positional, keyword = ds_api.commit.mock_calls[0]
+        self.assertEqual(keyword, {"transaction": None})
+
+        self.assertEqual(len(positional), 3)
+        self.assertEqual(positional[0], self.PROJECT)
+        self.assertEqual(positional[1], datastore_pb2.CommitRequest.NON_TRANSACTIONAL)
+
+        mutations = positional[2]
+        mutated_entity = _mutated_pb(self, mutations, "insert")
+        self.assertEqual(mutated_entity.key, key.to_protobuf())
+
+        prop_list = list(_property_tuples(mutated_entity))
+        self.assertTrue(len(prop_list), 1)
+        name, value_pb = prop_list[0]
+        self.assertEqual(name, "foo")
+        self.assertEqual(value_pb.string_value, u"bar")
+
+    def test_put_multi_existing_batch_w_completed_key(self):
+        from google.cloud.datastore.helpers import _property_tuples
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        entity = _Entity(foo=u"bar")
+        key = entity.key = _Key(self.PROJECT)
+
+        with _NoCommitBatch(client) as CURR_BATCH:
+            result = client.put_multi([entity])
+
+        self.assertIsNone(result)
+        mutated_entity = _mutated_pb(self, CURR_BATCH.mutations, "upsert")
+        self.assertEqual(mutated_entity.key, key.to_protobuf())
+
+        prop_list = list(_property_tuples(mutated_entity))
+        self.assertTrue(len(prop_list), 1)
+        name, value_pb = prop_list[0]
+        self.assertEqual(name, "foo")
+        self.assertEqual(value_pb.string_value, u"bar")
+
+    def test_delete(self):
+        _called_with = []
+
+        def _delete_multi(*args, **kw):
+            _called_with.append((args, kw))
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client.delete_multi = _delete_multi
+        key = object()
+
+        client.delete(key)
+
+        self.assertEqual(_called_with[0][0], ())
+        self.assertEqual(_called_with[0][1]["keys"], [key])
+
+    def test_delete_multi_no_keys(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client._datastore_api_internal = _make_datastore_api()
+
+        result = client.delete_multi([])
+        self.assertIsNone(result)
+        client._datastore_api_internal.commit.assert_not_called()
+
+    def test_delete_multi_no_batch(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        key = _Key(self.PROJECT)
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        ds_api = _make_datastore_api()
+        client._datastore_api_internal = ds_api
+
+        result = client.delete_multi([key])
+        self.assertIsNone(result)
+
+        self.assertEqual(ds_api.commit.call_count, 1)
+        _, positional, keyword = ds_api.commit.mock_calls[0]
+        self.assertEqual(keyword, {"transaction": None})
+
+        self.assertEqual(len(positional), 3)
+        self.assertEqual(positional[0], self.PROJECT)
+        self.assertEqual(positional[1], datastore_pb2.CommitRequest.NON_TRANSACTIONAL)
+
+        mutations = positional[2]
+        mutated_key = _mutated_pb(self, mutations, "delete")
+        self.assertEqual(mutated_key, key.to_protobuf())
+
+    def test_delete_multi_w_existing_batch(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client._datastore_api_internal = _make_datastore_api()
+
+        key = _Key(self.PROJECT)
+
+        with _NoCommitBatch(client) as CURR_BATCH:
+            result = client.delete_multi([key])
+
+        self.assertIsNone(result)
+        mutated_key = _mutated_pb(self, CURR_BATCH.mutations, "delete")
+        self.assertEqual(mutated_key, key._key)
+        client._datastore_api_internal.commit.assert_not_called()
+
+    def test_delete_multi_w_existing_transaction(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        client._datastore_api_internal = _make_datastore_api()
+
+        key = _Key(self.PROJECT)
+
+        with _NoCommitTransaction(client) as CURR_XACT:
+            result = client.delete_multi([key])
+
+        self.assertIsNone(result)
+        mutated_key = _mutated_pb(self, CURR_XACT.mutations, "delete")
+        self.assertEqual(mutated_key, key._key)
+        client._datastore_api_internal.commit.assert_not_called()
+
+    def test_allocate_ids_w_partial_key(self):
+        num_ids = 2
+
+        incomplete_key = _Key(self.PROJECT)
+        incomplete_key._id = None
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds, _use_grpc=False)
+        allocated = mock.Mock(keys=[_KeyPB(i) for i in range(num_ids)], spec=["keys"])
+        alloc_ids = mock.Mock(return_value=allocated, spec=[])
+        ds_api = mock.Mock(allocate_ids=alloc_ids, spec=["allocate_ids"])
+        client._datastore_api_internal = ds_api
+
+        result = client.allocate_ids(incomplete_key, num_ids)
+
+        # Check the IDs returned.
+        self.assertEqual([key._id for key in result], list(range(num_ids)))
+
+    def test_allocate_ids_w_completed_key(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        complete_key = _Key(self.PROJECT)
+        self.assertRaises(ValueError, client.allocate_ids, complete_key, 2)
+
+    def test_reserve_ids_w_completed_key(self):
+        num_ids = 2
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds, _use_grpc=False)
+        complete_key = _Key(self.PROJECT)
+        reserve_ids = mock.Mock()
+        ds_api = mock.Mock(reserve_ids=reserve_ids, spec=["reserve_ids"])
+        client._datastore_api_internal = ds_api
+        self.assertTrue(not complete_key.is_partial)
+        client.reserve_ids(complete_key, num_ids)
+        expected_keys = [complete_key.to_protobuf()] * num_ids
+        reserve_ids.assert_called_once_with(self.PROJECT, expected_keys)
+
+    def test_reserve_ids_w_partial_key(self):
+        num_ids = 2
+        incomplete_key = _Key(self.PROJECT)
+        incomplete_key._id = None
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        with self.assertRaises(ValueError):
+            client.reserve_ids(incomplete_key, num_ids)
+
+    def test_reserve_ids_w_wrong_num_ids(self):
+        num_ids = "2"
+        complete_key = _Key(self.PROJECT)
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        with self.assertRaises(ValueError):
+            client.reserve_ids(complete_key, num_ids)
+
+    def test_key_w_project(self):
+        KIND = "KIND"
+        ID = 1234
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        self.assertRaises(TypeError, client.key, KIND, ID, project=self.PROJECT)
+
+    def test_key_wo_project(self):
+        kind = "KIND"
+        id_ = 1234
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Key", spec=["__call__"])
+        with patch as mock_klass:
+            key = client.key(kind, id_)
+            self.assertIs(key, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                kind, id_, project=self.PROJECT, namespace=None
+            )
+
+    def test_key_w_namespace(self):
+        kind = "KIND"
+        id_ = 1234
+        namespace = object()
+
+        creds = _make_credentials()
+        client = self._make_one(namespace=namespace, credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Key", spec=["__call__"])
+        with patch as mock_klass:
+            key = client.key(kind, id_)
+            self.assertIs(key, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                kind, id_, project=self.PROJECT, namespace=namespace
+            )
+
+    def test_key_w_namespace_collision(self):
+        kind = "KIND"
+        id_ = 1234
+        namespace1 = object()
+        namespace2 = object()
+
+        creds = _make_credentials()
+        client = self._make_one(namespace=namespace1, credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Key", spec=["__call__"])
+        with patch as mock_klass:
+            key = client.key(kind, id_, namespace=namespace2)
+            self.assertIs(key, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                kind, id_, project=self.PROJECT, namespace=namespace2
+            )
+
+    def test_batch(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Batch", spec=["__call__"])
+        with patch as mock_klass:
+            batch = client.batch()
+            self.assertIs(batch, mock_klass.return_value)
+            mock_klass.assert_called_once_with(client)
+
+    def test_transaction_defaults(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        patch = mock.patch(
+            "google.cloud.datastore.client.Transaction", spec=["__call__"]
+        )
+        with patch as mock_klass:
+            xact = client.transaction()
+            self.assertIs(xact, mock_klass.return_value)
+            mock_klass.assert_called_once_with(client)
+
+    def test_read_only_transaction_defaults(self):
+        from google.cloud.datastore_v1.types import TransactionOptions
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        xact = client.transaction(read_only=True)
+        self.assertEqual(
+            xact._options, TransactionOptions(read_only=TransactionOptions.ReadOnly())
+        )
+        self.assertFalse(xact._options.HasField("read_write"))
+        self.assertTrue(xact._options.HasField("read_only"))
+        self.assertEqual(xact._options.read_only, TransactionOptions.ReadOnly())
+
+    def test_query_w_client(self):
+        KIND = "KIND"
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+        other = self._make_one(credentials=_make_credentials())
+
+        self.assertRaises(TypeError, client.query, kind=KIND, client=other)
+
+    def test_query_w_project(self):
+        KIND = "KIND"
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        self.assertRaises(TypeError, client.query, kind=KIND, project=self.PROJECT)
+
+    def test_query_w_defaults(self):
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Query", spec=["__call__"])
+        with patch as mock_klass:
+            query = client.query()
+            self.assertIs(query, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                client, project=self.PROJECT, namespace=None
+            )
+
+    def test_query_explicit(self):
+        kind = "KIND"
+        namespace = "NAMESPACE"
+        ancestor = object()
+        filters = [("PROPERTY", "==", "VALUE")]
+        projection = ["__key__"]
+        order = ["PROPERTY"]
+        distinct_on = ["DISTINCT_ON"]
+
+        creds = _make_credentials()
+        client = self._make_one(credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Query", spec=["__call__"])
+        with patch as mock_klass:
+            query = client.query(
+                kind=kind,
+                namespace=namespace,
+                ancestor=ancestor,
+                filters=filters,
+                projection=projection,
+                order=order,
+                distinct_on=distinct_on,
+            )
+            self.assertIs(query, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                client,
+                project=self.PROJECT,
+                kind=kind,
+                namespace=namespace,
+                ancestor=ancestor,
+                filters=filters,
+                projection=projection,
+                order=order,
+                distinct_on=distinct_on,
+            )
+
+    def test_query_w_namespace(self):
+        kind = "KIND"
+        namespace = object()
+
+        creds = _make_credentials()
+        client = self._make_one(namespace=namespace, credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Query", spec=["__call__"])
+        with patch as mock_klass:
+            query = client.query(kind=kind)
+            self.assertIs(query, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                client, project=self.PROJECT, namespace=namespace, kind=kind
+            )
+
+    def test_query_w_namespace_collision(self):
+        kind = "KIND"
+        namespace1 = object()
+        namespace2 = object()
+
+        creds = _make_credentials()
+        client = self._make_one(namespace=namespace1, credentials=creds)
+
+        patch = mock.patch("google.cloud.datastore.client.Query", spec=["__call__"])
+        with patch as mock_klass:
+            query = client.query(kind=kind, namespace=namespace2)
+            self.assertIs(query, mock_klass.return_value)
+            mock_klass.assert_called_once_with(
+                client, project=self.PROJECT, namespace=namespace2, kind=kind
+            )
+
+
+class _NoCommitBatch(object):
+    def __init__(self, client):
+        from google.cloud.datastore.batch import Batch
+
+        self._client = client
+        self._batch = Batch(client)
+        self._batch.begin()
+
+    def __enter__(self):
+        self._client._push_batch(self._batch)
+        return self._batch
+
+    def __exit__(self, *args):
+        self._client._pop_batch()
+
+
+class _NoCommitTransaction(object):
+    def __init__(self, client, transaction_id="TRANSACTION"):
+        from google.cloud.datastore.batch import Batch
+        from google.cloud.datastore.transaction import Transaction
+
+        self._client = client
+        xact = self._transaction = Transaction(client)
+        xact._id = transaction_id
+        Batch.begin(xact)
+
+    def __enter__(self):
+        self._client._push_batch(self._transaction)
+        return self._transaction
+
+    def __exit__(self, *args):
+        self._client._pop_batch()
+
+
+class _Entity(dict):
+    key = None
+    exclude_from_indexes = ()
+    _meanings = {}
+
+
+class _Key(object):
+    _MARKER = object()
+    _kind = "KIND"
+    _key = "KEY"
+    _path = None
+    _id = 1234
+    _stored = None
+
+    def __init__(self, project):
+        self.project = project
+
+    @property
+    def is_partial(self):
+        return self._id is None
+
+    def to_protobuf(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        key = self._key = entity_pb2.Key()
+        # Don't assign it, because it will just get ripped out
+        # key.partition_id.project_id = self.project
+
+        element = key.path.add()
+        element.kind = self._kind
+        if self._id is not None:
+            element.id = self._id
+
+        return key
+
+    def completed_key(self, new_id):
+        assert self.is_partial
+        new_key = self.__class__(self.project)
+        new_key._id = new_id
+        return new_key
+
+
+class _PathElementPB(object):
+    def __init__(self, id_):
+        self.id = id_
+
+
+class _KeyPB(object):
+    def __init__(self, id_):
+        self.path = [_PathElementPB(id_)]
+
+
+def _assert_num_mutations(test_case, mutation_pb_list, num_mutations):
+    test_case.assertEqual(len(mutation_pb_list), num_mutations)
+
+
+def _mutated_pb(test_case, mutation_pb_list, mutation_type):
+    # Make sure there is only one mutation.
+    _assert_num_mutations(test_case, mutation_pb_list, 1)
+
+    # We grab the only mutation.
+    mutated_pb = mutation_pb_list[0]
+    # Then check if it is the correct type.
+    test_case.assertEqual(mutated_pb.WhichOneof("operation"), mutation_type)
+
+    return getattr(mutated_pb, mutation_type)
+
+
+def _make_key(id_):
+    from google.cloud.datastore_v1.proto import entity_pb2
+
+    key = entity_pb2.Key()
+    elem = key.path.add()
+    elem.id = id_
+    return key
+
+
+def _make_commit_response(*keys):
+    from google.cloud.datastore_v1.proto import datastore_pb2
+
+    mutation_results = [datastore_pb2.MutationResult(key=key) for key in keys]
+    return datastore_pb2.CommitResponse(mutation_results=mutation_results)
+
+
+def _make_lookup_response(results=(), missing=(), deferred=()):
+    entity_results_found = [
+        mock.Mock(entity=result, spec=["entity"]) for result in results
+    ]
+    entity_results_missing = [
+        mock.Mock(entity=missing_entity, spec=["entity"]) for missing_entity in missing
+    ]
+    return mock.Mock(
+        found=entity_results_found,
+        missing=entity_results_missing,
+        deferred=deferred,
+        spec=["found", "missing", "deferred"],
+    )
+
+
+def _make_datastore_api(*keys, **kwargs):
+    commit_method = mock.Mock(return_value=_make_commit_response(*keys), spec=[])
+    lookup_response = kwargs.pop("lookup_response", _make_lookup_response())
+    lookup_method = mock.Mock(return_value=lookup_response, spec=[])
+    return mock.Mock(
+        commit=commit_method, lookup=lookup_method, spec=["commit", "lookup"]
+    )
diff --git a/datastore/tests/unit/test_entity.py b/datastore/tests/unit/test_entity.py
new file mode 100644
index 000000000000..c65541a45854
--- /dev/null
+++ b/datastore/tests/unit/test_entity.py
@@ -0,0 +1,234 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+_PROJECT = "PROJECT"
+_KIND = "KIND"
+_ID = 1234
+
+
+class TestEntity(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.entity import Entity
+
+        return Entity
+
+    def _make_one(self, key=None, exclude_from_indexes=()):
+        klass = self._get_target_class()
+        return klass(key=key, exclude_from_indexes=exclude_from_indexes)
+
+    def test_ctor_defaults(self):
+        klass = self._get_target_class()
+        entity = klass()
+        self.assertIsNone(entity.key)
+        self.assertIsNone(entity.kind)
+        self.assertEqual(sorted(entity.exclude_from_indexes), [])
+
+    def test_ctor_explicit(self):
+        _EXCLUDE_FROM_INDEXES = ["foo", "bar"]
+        key = _Key()
+        entity = self._make_one(key=key, exclude_from_indexes=_EXCLUDE_FROM_INDEXES)
+        self.assertEqual(
+            sorted(entity.exclude_from_indexes), sorted(_EXCLUDE_FROM_INDEXES)
+        )
+
+    def test_ctor_bad_exclude_from_indexes(self):
+        BAD_EXCLUDE_FROM_INDEXES = object()
+        key = _Key()
+        self.assertRaises(
+            TypeError,
+            self._make_one,
+            key=key,
+            exclude_from_indexes=BAD_EXCLUDE_FROM_INDEXES,
+        )
+
+    def test___eq_____ne___w_non_entity(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key(_KIND, _ID, project=_PROJECT)
+        entity = self._make_one(key=key)
+        self.assertFalse(entity == object())
+        self.assertTrue(entity != object())
+
+    def test___eq_____ne___w_different_keys(self):
+        from google.cloud.datastore.key import Key
+
+        _ID1 = 1234
+        _ID2 = 2345
+        key1 = Key(_KIND, _ID1, project=_PROJECT)
+        entity1 = self._make_one(key=key1)
+        key2 = Key(_KIND, _ID2, project=_PROJECT)
+        entity2 = self._make_one(key=key2)
+        self.assertFalse(entity1 == entity2)
+        self.assertTrue(entity1 != entity2)
+
+    def test___eq_____ne___w_same_keys(self):
+        from google.cloud.datastore.key import Key
+
+        name = "foo"
+        value = 42
+        meaning = 9
+
+        key1 = Key(_KIND, _ID, project=_PROJECT)
+        entity1 = self._make_one(key=key1, exclude_from_indexes=(name,))
+        entity1[name] = value
+        entity1._meanings[name] = (meaning, value)
+
+        key2 = Key(_KIND, _ID, project=_PROJECT)
+        entity2 = self._make_one(key=key2, exclude_from_indexes=(name,))
+        entity2[name] = value
+        entity2._meanings[name] = (meaning, value)
+
+        self.assertTrue(entity1 == entity2)
+        self.assertFalse(entity1 != entity2)
+
+    def test___eq_____ne___w_same_keys_different_props(self):
+        from google.cloud.datastore.key import Key
+
+        key1 = Key(_KIND, _ID, project=_PROJECT)
+        entity1 = self._make_one(key=key1)
+        entity1["foo"] = "Foo"
+        key2 = Key(_KIND, _ID, project=_PROJECT)
+        entity2 = self._make_one(key=key2)
+        entity1["bar"] = "Bar"
+        self.assertFalse(entity1 == entity2)
+        self.assertTrue(entity1 != entity2)
+
+    def test___eq_____ne___w_same_keys_props_w_equiv_keys_as_value(self):
+        from google.cloud.datastore.key import Key
+
+        key1 = Key(_KIND, _ID, project=_PROJECT)
+        key2 = Key(_KIND, _ID, project=_PROJECT)
+        entity1 = self._make_one(key=key1)
+        entity1["some_key"] = key1
+        entity2 = self._make_one(key=key1)
+        entity2["some_key"] = key2
+        self.assertTrue(entity1 == entity2)
+        self.assertFalse(entity1 != entity2)
+
+    def test___eq_____ne___w_same_keys_props_w_diff_keys_as_value(self):
+        from google.cloud.datastore.key import Key
+
+        _ID1 = 1234
+        _ID2 = 2345
+        key1 = Key(_KIND, _ID1, project=_PROJECT)
+        key2 = Key(_KIND, _ID2, project=_PROJECT)
+        entity1 = self._make_one(key=key1)
+        entity1["some_key"] = key1
+        entity2 = self._make_one(key=key1)
+        entity2["some_key"] = key2
+        self.assertFalse(entity1 == entity2)
+        self.assertTrue(entity1 != entity2)
+
+    def test___eq_____ne___w_same_keys_props_w_equiv_entities_as_value(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key(_KIND, _ID, project=_PROJECT)
+        entity1 = self._make_one(key=key)
+        sub1 = self._make_one()
+        sub1.update({"foo": "Foo"})
+        entity1["some_entity"] = sub1
+        entity2 = self._make_one(key=key)
+        sub2 = self._make_one()
+        sub2.update({"foo": "Foo"})
+        entity2["some_entity"] = sub2
+        self.assertTrue(entity1 == entity2)
+        self.assertFalse(entity1 != entity2)
+
+    def test___eq_____ne___w_same_keys_props_w_diff_entities_as_value(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key(_KIND, _ID, project=_PROJECT)
+        entity1 = self._make_one(key=key)
+        sub1 = self._make_one()
+        sub1.update({"foo": "Foo"})
+        entity1["some_entity"] = sub1
+        entity2 = self._make_one(key=key)
+        sub2 = self._make_one()
+        sub2.update({"foo": "Bar"})
+        entity2["some_entity"] = sub2
+        self.assertFalse(entity1 == entity2)
+        self.assertTrue(entity1 != entity2)
+
+    def test__eq__same_value_different_exclude(self):
+        from google.cloud.datastore.key import Key
+
+        name = "foo"
+        value = 42
+        key = Key(_KIND, _ID, project=_PROJECT)
+
+        entity1 = self._make_one(key=key, exclude_from_indexes=(name,))
+        entity1[name] = value
+
+        entity2 = self._make_one(key=key, exclude_from_indexes=())
+        entity2[name] = value
+
+        self.assertFalse(entity1 == entity2)
+
+    def test__eq__same_value_different_meanings(self):
+        from google.cloud.datastore.key import Key
+
+        name = "foo"
+        value = 42
+        meaning = 9
+        key = Key(_KIND, _ID, project=_PROJECT)
+
+        entity1 = self._make_one(key=key, exclude_from_indexes=(name,))
+        entity1[name] = value
+
+        entity2 = self._make_one(key=key, exclude_from_indexes=(name,))
+        entity2[name] = value
+        entity2._meanings[name] = (meaning, value)
+
+        self.assertFalse(entity1 == entity2)
+
+    def test_id(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key(_KIND, _ID, project=_PROJECT)
+        entity = self._make_one(key=key)
+        self.assertEqual(entity.id, _ID)
+
+    def test_id_none(self):
+
+        entity = self._make_one(key=None)
+        self.assertEqual(entity.id, None)
+
+    def test___repr___no_key_empty(self):
+        entity = self._make_one()
+        self.assertEqual(repr(entity), "<Entity {}>")
+
+    def test___repr___w_key_non_empty(self):
+        key = _Key()
+        flat_path = ("bar", 12, "baz", "himom")
+        key._flat_path = flat_path
+        entity = self._make_one(key=key)
+        entity_vals = {"foo": "Foo"}
+        entity.update(entity_vals)
+        expected = "<Entity%s %s>" % (flat_path, entity_vals)
+        self.assertEqual(repr(entity), expected)
+
+
+class _Key(object):
+    _MARKER = object()
+    _key = "KEY"
+    _partial = False
+    _path = None
+    _id = None
+    _stored = None
+
+    def __init__(self, project=_PROJECT):
+        self.project = project
diff --git a/datastore/tests/unit/test_helpers.py b/datastore/tests/unit/test_helpers.py
new file mode 100644
index 000000000000..995d9cfa2330
--- /dev/null
+++ b/datastore/tests/unit/test_helpers.py
@@ -0,0 +1,1046 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class Test__new_value_pb(unittest.TestCase):
+    def _call_fut(self, entity_pb, name):
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        return _new_value_pb(entity_pb, name)
+
+    def test_it(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        entity_pb = entity_pb2.Entity()
+        name = "foo"
+        result = self._call_fut(entity_pb, name)
+
+        self.assertIsInstance(result, entity_pb2.Value)
+        self.assertEqual(len(entity_pb.properties), 1)
+        self.assertEqual(entity_pb.properties[name], result)
+
+
+class Test__property_tuples(unittest.TestCase):
+    def _call_fut(self, entity_pb):
+        from google.cloud.datastore.helpers import _property_tuples
+
+        return _property_tuples(entity_pb)
+
+    def test_it(self):
+        import types
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        entity_pb = entity_pb2.Entity()
+        name1 = "foo"
+        name2 = "bar"
+        val_pb1 = _new_value_pb(entity_pb, name1)
+        val_pb2 = _new_value_pb(entity_pb, name2)
+
+        result = self._call_fut(entity_pb)
+        self.assertIsInstance(result, types.GeneratorType)
+        self.assertEqual(sorted(result), sorted([(name1, val_pb1), (name2, val_pb2)]))
+
+
+class Test_entity_from_protobuf(unittest.TestCase):
+    def _call_fut(self, val):
+        from google.cloud.datastore.helpers import entity_from_protobuf
+
+        return entity_from_protobuf(val)
+
+    def test_it(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+        entity_pb = entity_pb2.Entity()
+        entity_pb.key.partition_id.project_id = _PROJECT
+        entity_pb.key.path.add(kind=_KIND, id=_ID)
+
+        value_pb = _new_value_pb(entity_pb, "foo")
+        value_pb.string_value = "Foo"
+
+        unindexed_val_pb = _new_value_pb(entity_pb, "bar")
+        unindexed_val_pb.integer_value = 10
+        unindexed_val_pb.exclude_from_indexes = True
+
+        array_val_pb1 = _new_value_pb(entity_pb, "baz")
+        array_pb1 = array_val_pb1.array_value.values
+
+        unindexed_array_val_pb = array_pb1.add()
+        unindexed_array_val_pb.integer_value = 11
+        unindexed_array_val_pb.exclude_from_indexes = True
+
+        array_val_pb2 = _new_value_pb(entity_pb, "qux")
+        array_pb2 = array_val_pb2.array_value.values
+
+        indexed_array_val_pb = array_pb2.add()
+        indexed_array_val_pb.integer_value = 12
+
+        entity = self._call_fut(entity_pb)
+        self.assertEqual(entity.kind, _KIND)
+        self.assertEqual(entity.exclude_from_indexes, frozenset(["bar", "baz"]))
+        entity_props = dict(entity)
+        self.assertEqual(
+            entity_props, {"foo": "Foo", "bar": 10, "baz": [11], "qux": [12]}
+        )
+
+        # Also check the key.
+        key = entity.key
+        self.assertEqual(key.project, _PROJECT)
+        self.assertIsNone(key.namespace)
+        self.assertEqual(key.kind, _KIND)
+        self.assertEqual(key.id, _ID)
+
+    def test_mismatched_value_indexed(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+        entity_pb = entity_pb2.Entity()
+        entity_pb.key.partition_id.project_id = _PROJECT
+        entity_pb.key.path.add(kind=_KIND, id=_ID)
+
+        array_val_pb = _new_value_pb(entity_pb, "baz")
+        array_pb = array_val_pb.array_value.values
+
+        unindexed_value_pb1 = array_pb.add()
+        unindexed_value_pb1.integer_value = 10
+        unindexed_value_pb1.exclude_from_indexes = True
+
+        unindexed_value_pb2 = array_pb.add()
+        unindexed_value_pb2.integer_value = 11
+
+        with self.assertRaises(ValueError):
+            self._call_fut(entity_pb)
+
+    def test_entity_no_key(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        entity_pb = entity_pb2.Entity()
+        entity = self._call_fut(entity_pb)
+
+        self.assertIsNone(entity.key)
+        self.assertEqual(dict(entity), {})
+
+    def test_entity_with_meaning(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        entity_pb = entity_pb2.Entity()
+        name = "hello"
+        value_pb = _new_value_pb(entity_pb, name)
+        value_pb.meaning = meaning = 9
+        value_pb.string_value = val = u"something"
+
+        entity = self._call_fut(entity_pb)
+        self.assertIsNone(entity.key)
+        self.assertEqual(dict(entity), {name: val})
+        self.assertEqual(entity._meanings, {name: (meaning, val)})
+
+    def test_nested_entity_no_key(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        PROJECT = "FOO"
+        KIND = "KIND"
+        INSIDE_NAME = "IFOO"
+        OUTSIDE_NAME = "OBAR"
+        INSIDE_VALUE = 1337
+
+        entity_inside = entity_pb2.Entity()
+        inside_val_pb = _new_value_pb(entity_inside, INSIDE_NAME)
+        inside_val_pb.integer_value = INSIDE_VALUE
+
+        entity_pb = entity_pb2.Entity()
+        entity_pb.key.partition_id.project_id = PROJECT
+        element = entity_pb.key.path.add()
+        element.kind = KIND
+
+        outside_val_pb = _new_value_pb(entity_pb, OUTSIDE_NAME)
+        outside_val_pb.entity_value.CopyFrom(entity_inside)
+
+        entity = self._call_fut(entity_pb)
+        self.assertEqual(entity.key.project, PROJECT)
+        self.assertEqual(entity.key.flat_path, (KIND,))
+        self.assertEqual(len(entity), 1)
+
+        inside_entity = entity[OUTSIDE_NAME]
+        self.assertIsNone(inside_entity.key)
+        self.assertEqual(len(inside_entity), 1)
+        self.assertEqual(inside_entity[INSIDE_NAME], INSIDE_VALUE)
+
+    def test_index_mismatch_ignores_empty_list(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+
+        array_val_pb = entity_pb2.Value(array_value=entity_pb2.ArrayValue(values=[]))
+
+        entity_pb = entity_pb2.Entity(properties={"baz": array_val_pb})
+        entity_pb.key.partition_id.project_id = _PROJECT
+        entity_pb.key.path.add(kind=_KIND, id=_ID)
+
+        entity = self._call_fut(entity_pb)
+        entity_dict = dict(entity)
+        self.assertEqual(entity_dict["baz"], [])
+
+
+class Test_entity_to_protobuf(unittest.TestCase):
+    def _call_fut(self, entity):
+        from google.cloud.datastore.helpers import entity_to_protobuf
+
+        return entity_to_protobuf(entity)
+
+    def _compare_entity_proto(self, entity_pb1, entity_pb2):
+        from google.cloud.datastore.helpers import _property_tuples
+
+        self.assertEqual(entity_pb1.key, entity_pb2.key)
+        value_list1 = sorted(_property_tuples(entity_pb1))
+        value_list2 = sorted(_property_tuples(entity_pb2))
+        self.assertEqual(len(value_list1), len(value_list2))
+        for pair1, pair2 in zip(value_list1, value_list2):
+            name1, val1 = pair1
+            name2, val2 = pair2
+            self.assertEqual(name1, name2)
+            if val1.HasField("entity_value"):  # Message field (Entity)
+                self.assertEqual(val1.meaning, val2.meaning)
+                self._compare_entity_proto(val1.entity_value, val2.entity_value)
+            else:
+                self.assertEqual(val1, val2)
+
+    def test_empty(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+
+        entity = Entity()
+        entity_pb = self._call_fut(entity)
+        self._compare_entity_proto(entity_pb, entity_pb2.Entity())
+
+    def test_key_only(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.key import Key
+
+        kind, name = "PATH", "NAME"
+        project = "PROJECT"
+        key = Key(kind, name, project=project)
+        entity = Entity(key=key)
+        entity_pb = self._call_fut(entity)
+
+        expected_pb = entity_pb2.Entity()
+        expected_pb.key.partition_id.project_id = project
+        path_elt = expected_pb.key.path.add()
+        path_elt.kind = kind
+        path_elt.name = name
+
+        self._compare_entity_proto(entity_pb, expected_pb)
+
+    def test_simple_fields(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        entity = Entity()
+        name1 = "foo"
+        entity[name1] = value1 = 42
+        name2 = "bar"
+        entity[name2] = value2 = u"some-string"
+        entity_pb = self._call_fut(entity)
+
+        expected_pb = entity_pb2.Entity()
+        val_pb1 = _new_value_pb(expected_pb, name1)
+        val_pb1.integer_value = value1
+        val_pb2 = _new_value_pb(expected_pb, name2)
+        val_pb2.string_value = value2
+
+        self._compare_entity_proto(entity_pb, expected_pb)
+
+    def test_with_empty_list(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+
+        entity = Entity()
+        entity["foo"] = []
+        entity_pb = self._call_fut(entity)
+
+        expected_pb = entity_pb2.Entity()
+        prop = expected_pb.properties.get_or_create("foo")
+        prop.array_value.CopyFrom(entity_pb2.ArrayValue(values=[]))
+
+        self._compare_entity_proto(entity_pb, expected_pb)
+
+    def test_inverts_to_protobuf(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import _new_value_pb
+        from google.cloud.datastore.helpers import entity_from_protobuf
+
+        original_pb = entity_pb2.Entity()
+        # Add a key.
+        original_pb.key.partition_id.project_id = project = "PROJECT"
+        elem1 = original_pb.key.path.add()
+        elem1.kind = "Family"
+        elem1.id = 1234
+        elem2 = original_pb.key.path.add()
+        elem2.kind = "King"
+        elem2.name = "Spades"
+
+        # Add an integer property.
+        val_pb1 = _new_value_pb(original_pb, "foo")
+        val_pb1.integer_value = 1337
+        val_pb1.exclude_from_indexes = True
+        # Add a string property.
+        val_pb2 = _new_value_pb(original_pb, "bar")
+        val_pb2.string_value = u"hello"
+
+        # Add a nested (entity) property.
+        val_pb3 = _new_value_pb(original_pb, "entity-baz")
+        sub_pb = entity_pb2.Entity()
+        sub_val_pb1 = _new_value_pb(sub_pb, "x")
+        sub_val_pb1.double_value = 3.14
+        sub_val_pb2 = _new_value_pb(sub_pb, "y")
+        sub_val_pb2.double_value = 2.718281828
+        val_pb3.meaning = 9
+        val_pb3.entity_value.CopyFrom(sub_pb)
+
+        # Add a list property.
+        val_pb4 = _new_value_pb(original_pb, "list-quux")
+        array_val1 = val_pb4.array_value.values.add()
+        array_val1.exclude_from_indexes = False
+        array_val1.meaning = meaning = 22
+        array_val1.blob_value = b"\xe2\x98\x83"
+        array_val2 = val_pb4.array_value.values.add()
+        array_val2.exclude_from_indexes = False
+        array_val2.meaning = meaning
+        array_val2.blob_value = b"\xe2\x98\x85"
+
+        # Convert to the user-space Entity.
+        entity = entity_from_protobuf(original_pb)
+        # Convert the user-space Entity back to a protobuf.
+        new_pb = self._call_fut(entity)
+
+        # NOTE: entity_to_protobuf() strips the project so we "cheat".
+        new_pb.key.partition_id.project_id = project
+        self._compare_entity_proto(original_pb, new_pb)
+
+    def test_meaning_with_change(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        entity = Entity()
+        name = "foo"
+        entity[name] = value = 42
+        entity._meanings[name] = (9, 1337)
+        entity_pb = self._call_fut(entity)
+
+        expected_pb = entity_pb2.Entity()
+        value_pb = _new_value_pb(expected_pb, name)
+        value_pb.integer_value = value
+        # NOTE: No meaning is used since the value differs from the
+        #       value stored.
+        self._compare_entity_proto(entity_pb, expected_pb)
+
+    def test_variable_meanings(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        entity = Entity()
+        name = "quux"
+        entity[name] = values = [1, 20, 300]
+        meaning = 9
+        entity._meanings[name] = ([None, meaning, None], values)
+        entity_pb = self._call_fut(entity)
+
+        # Construct the expected protobuf.
+        expected_pb = entity_pb2.Entity()
+        value_pb = _new_value_pb(expected_pb, name)
+        value0 = value_pb.array_value.values.add()
+        value0.integer_value = values[0]
+        # The only array entry with a meaning is the middle one.
+        value1 = value_pb.array_value.values.add()
+        value1.integer_value = values[1]
+        value1.meaning = meaning
+        value2 = value_pb.array_value.values.add()
+        value2.integer_value = values[2]
+
+        self._compare_entity_proto(entity_pb, expected_pb)
+
+    def test_dict_to_entity(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+
+        entity = Entity()
+        entity["a"] = {"b": u"c"}
+        entity_pb = self._call_fut(entity)
+
+        expected_pb = entity_pb2.Entity(
+            properties={
+                "a": entity_pb2.Value(
+                    entity_value=entity_pb2.Entity(
+                        properties={"b": entity_pb2.Value(string_value="c")}
+                    )
+                )
+            }
+        )
+        self.assertEqual(entity_pb, expected_pb)
+
+    def test_dict_to_entity_recursive(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+
+        entity = Entity()
+        entity["a"] = {"b": {"c": {"d": 1.25}, "e": True}, "f": 10}
+        entity_pb = self._call_fut(entity)
+
+        b_entity_pb = entity_pb2.Entity(
+            properties={
+                "c": entity_pb2.Value(
+                    entity_value=entity_pb2.Entity(
+                        properties={"d": entity_pb2.Value(double_value=1.25)}
+                    )
+                ),
+                "e": entity_pb2.Value(boolean_value=True),
+            }
+        )
+        expected_pb = entity_pb2.Entity(
+            properties={
+                "a": entity_pb2.Value(
+                    entity_value=entity_pb2.Entity(
+                        properties={
+                            "b": entity_pb2.Value(entity_value=b_entity_pb),
+                            "f": entity_pb2.Value(integer_value=10),
+                        }
+                    )
+                )
+            }
+        )
+        self.assertEqual(entity_pb, expected_pb)
+
+
+class Test_key_from_protobuf(unittest.TestCase):
+    def _call_fut(self, val):
+        from google.cloud.datastore.helpers import key_from_protobuf
+
+        return key_from_protobuf(val)
+
+    def _makePB(self, project=None, namespace=None, path=()):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        pb = entity_pb2.Key()
+        if project is not None:
+            pb.partition_id.project_id = project
+        if namespace is not None:
+            pb.partition_id.namespace_id = namespace
+        for elem in path:
+            added = pb.path.add()
+            added.kind = elem["kind"]
+            if "id" in elem:
+                added.id = elem["id"]
+            if "name" in elem:
+                added.name = elem["name"]
+        return pb
+
+    def test_wo_namespace_in_pb(self):
+        _PROJECT = "PROJECT"
+        pb = self._makePB(path=[{"kind": "KIND"}], project=_PROJECT)
+        key = self._call_fut(pb)
+        self.assertEqual(key.project, _PROJECT)
+        self.assertIsNone(key.namespace)
+
+    def test_w_namespace_in_pb(self):
+        _PROJECT = "PROJECT"
+        _NAMESPACE = "NAMESPACE"
+        pb = self._makePB(
+            path=[{"kind": "KIND"}], namespace=_NAMESPACE, project=_PROJECT
+        )
+        key = self._call_fut(pb)
+        self.assertEqual(key.project, _PROJECT)
+        self.assertEqual(key.namespace, _NAMESPACE)
+
+    def test_w_nested_path_in_pb(self):
+        _PATH = [
+            {"kind": "PARENT", "name": "NAME"},
+            {"kind": "CHILD", "id": 1234},
+            {"kind": "GRANDCHILD", "id": 5678},
+        ]
+        pb = self._makePB(path=_PATH, project="PROJECT")
+        key = self._call_fut(pb)
+        self.assertEqual(key.path, _PATH)
+
+    def test_w_nothing_in_pb(self):
+        pb = self._makePB()
+        self.assertRaises(ValueError, self._call_fut, pb)
+
+
+class Test__get_read_options(unittest.TestCase):
+    def _call_fut(self, eventual, transaction_id):
+        from google.cloud.datastore.helpers import get_read_options
+
+        return get_read_options(eventual, transaction_id)
+
+    def test_eventual_w_transaction(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(True, b"123")
+
+    def test_eventual_wo_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        read_options = self._call_fut(True, None)
+        expected = datastore_pb2.ReadOptions(
+            read_consistency=datastore_pb2.ReadOptions.EVENTUAL
+        )
+        self.assertEqual(read_options, expected)
+
+    def test_default_w_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        txn_id = b"123abc-easy-as"
+        read_options = self._call_fut(False, txn_id)
+        expected = datastore_pb2.ReadOptions(transaction=txn_id)
+        self.assertEqual(read_options, expected)
+
+    def test_default_wo_transaction(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        read_options = self._call_fut(False, None)
+        expected = datastore_pb2.ReadOptions()
+        self.assertEqual(read_options, expected)
+
+
+class Test__pb_attr_value(unittest.TestCase):
+    def _call_fut(self, val):
+        from google.cloud.datastore.helpers import _pb_attr_value
+
+        return _pb_attr_value(val)
+
+    def test_datetime_naive(self):
+        import calendar
+        import datetime
+        from google.cloud._helpers import UTC
+
+        micros = 4375
+        naive = datetime.datetime(2014, 9, 16, 10, 19, 32, micros)  # No zone.
+        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
+        name, value = self._call_fut(naive)
+        self.assertEqual(name, "timestamp_value")
+        self.assertEqual(value.seconds, calendar.timegm(utc.timetuple()))
+        self.assertEqual(value.nanos, 1000 * micros)
+
+    def test_datetime_w_zone(self):
+        import calendar
+        import datetime
+        from google.cloud._helpers import UTC
+
+        micros = 4375
+        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
+        name, value = self._call_fut(utc)
+        self.assertEqual(name, "timestamp_value")
+        self.assertEqual(value.seconds, calendar.timegm(utc.timetuple()))
+        self.assertEqual(value.nanos, 1000 * micros)
+
+    def test_key(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key("PATH", 1234, project="PROJECT")
+        name, value = self._call_fut(key)
+        self.assertEqual(name, "key_value")
+        self.assertEqual(value, key.to_protobuf())
+
+    def test_bool(self):
+        name, value = self._call_fut(False)
+        self.assertEqual(name, "boolean_value")
+        self.assertEqual(value, False)
+
+    def test_float(self):
+        name, value = self._call_fut(3.1415926)
+        self.assertEqual(name, "double_value")
+        self.assertEqual(value, 3.1415926)
+
+    def test_int(self):
+        name, value = self._call_fut(42)
+        self.assertEqual(name, "integer_value")
+        self.assertEqual(value, 42)
+
+    def test_long(self):
+        must_be_long = (1 << 63) - 1
+        name, value = self._call_fut(must_be_long)
+        self.assertEqual(name, "integer_value")
+        self.assertEqual(value, must_be_long)
+
+    def test_native_str(self):
+        import six
+
+        name, value = self._call_fut("str")
+        if six.PY2:
+            self.assertEqual(name, "blob_value")
+        else:  # pragma: NO COVER Python 3
+            self.assertEqual(name, "string_value")
+        self.assertEqual(value, "str")
+
+    def test_bytes(self):
+        name, value = self._call_fut(b"bytes")
+        self.assertEqual(name, "blob_value")
+        self.assertEqual(value, b"bytes")
+
+    def test_unicode(self):
+        name, value = self._call_fut(u"str")
+        self.assertEqual(name, "string_value")
+        self.assertEqual(value, u"str")
+
+    def test_entity(self):
+        from google.cloud.datastore.entity import Entity
+
+        entity = Entity()
+        name, value = self._call_fut(entity)
+        self.assertEqual(name, "entity_value")
+        self.assertIs(value, entity)
+
+    def test_dict(self):
+        from google.cloud.datastore.entity import Entity
+
+        orig_value = {"richard": b"feynman"}
+        name, value = self._call_fut(orig_value)
+        self.assertEqual(name, "entity_value")
+        self.assertIsInstance(value, Entity)
+        self.assertIsNone(value.key)
+        self.assertEqual(value._meanings, {})
+        self.assertEqual(value.exclude_from_indexes, set())
+        self.assertEqual(dict(value), orig_value)
+
+    def test_array(self):
+        values = ["a", 0, 3.14]
+        name, value = self._call_fut(values)
+        self.assertEqual(name, "array_value")
+        self.assertIs(value, values)
+
+    def test_geo_point(self):
+        from google.type import latlng_pb2
+        from google.cloud.datastore.helpers import GeoPoint
+
+        lat = 42.42
+        lng = 99.0007
+        geo_pt = GeoPoint(latitude=lat, longitude=lng)
+        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
+        name, value = self._call_fut(geo_pt)
+        self.assertEqual(name, "geo_point_value")
+        self.assertEqual(value, geo_pt_pb)
+
+    def test_null(self):
+        from google.protobuf import struct_pb2
+
+        name, value = self._call_fut(None)
+        self.assertEqual(name, "null_value")
+        self.assertEqual(value, struct_pb2.NULL_VALUE)
+
+    def test_object(self):
+        self.assertRaises(ValueError, self._call_fut, object())
+
+
+class Test__get_value_from_value_pb(unittest.TestCase):
+    def _call_fut(self, pb):
+        from google.cloud.datastore.helpers import _get_value_from_value_pb
+
+        return _get_value_from_value_pb(pb)
+
+    def _makePB(self, attr_name, value):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        pb = entity_pb2.Value()
+        setattr(pb, attr_name, value)
+        return pb
+
+    def test_datetime(self):
+        import calendar
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        micros = 4375
+        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
+        pb = entity_pb2.Value()
+        pb.timestamp_value.seconds = calendar.timegm(utc.timetuple())
+        pb.timestamp_value.nanos = 1000 * micros
+        self.assertEqual(self._call_fut(pb), utc)
+
+    def test_key(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.key import Key
+
+        pb = entity_pb2.Value()
+        expected = Key("KIND", 1234, project="PROJECT").to_protobuf()
+        pb.key_value.CopyFrom(expected)
+        found = self._call_fut(pb)
+        self.assertEqual(found.to_protobuf(), expected)
+
+    def test_bool(self):
+        pb = self._makePB("boolean_value", False)
+        self.assertEqual(self._call_fut(pb), False)
+
+    def test_float(self):
+        pb = self._makePB("double_value", 3.1415926)
+        self.assertEqual(self._call_fut(pb), 3.1415926)
+
+    def test_int(self):
+        pb = self._makePB("integer_value", 42)
+        self.assertEqual(self._call_fut(pb), 42)
+
+    def test_bytes(self):
+        pb = self._makePB("blob_value", b"str")
+        self.assertEqual(self._call_fut(pb), b"str")
+
+    def test_unicode(self):
+        pb = self._makePB("string_value", u"str")
+        self.assertEqual(self._call_fut(pb), u"str")
+
+    def test_entity(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.helpers import _new_value_pb
+
+        pb = entity_pb2.Value()
+        entity_pb = pb.entity_value
+        entity_pb.key.path.add(kind="KIND")
+        entity_pb.key.partition_id.project_id = "PROJECT"
+
+        value_pb = _new_value_pb(entity_pb, "foo")
+        value_pb.string_value = "Foo"
+        entity = self._call_fut(pb)
+        self.assertIsInstance(entity, Entity)
+        self.assertEqual(entity["foo"], "Foo")
+
+    def test_array(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        pb = entity_pb2.Value()
+        array_pb = pb.array_value.values
+        item_pb = array_pb.add()
+        item_pb.string_value = "Foo"
+        item_pb = array_pb.add()
+        item_pb.string_value = "Bar"
+        items = self._call_fut(pb)
+        self.assertEqual(items, ["Foo", "Bar"])
+
+    def test_geo_point(self):
+        from google.type import latlng_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore.helpers import GeoPoint
+
+        lat = -3.14
+        lng = 13.37
+        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
+        pb = entity_pb2.Value(geo_point_value=geo_pt_pb)
+        result = self._call_fut(pb)
+        self.assertIsInstance(result, GeoPoint)
+        self.assertEqual(result.latitude, lat)
+        self.assertEqual(result.longitude, lng)
+
+    def test_null(self):
+        from google.protobuf import struct_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        pb = entity_pb2.Value(null_value=struct_pb2.NULL_VALUE)
+        result = self._call_fut(pb)
+        self.assertIsNone(result)
+
+    def test_unknown(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        pb = entity_pb2.Value()
+        with self.assertRaises(ValueError):
+            self._call_fut(pb)
+
+
+class Test_set_protobuf_value(unittest.TestCase):
+    def _call_fut(self, value_pb, val):
+        from google.cloud.datastore.helpers import _set_protobuf_value
+
+        return _set_protobuf_value(value_pb, val)
+
+    def _makePB(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        return entity_pb2.Value()
+
+    def test_datetime(self):
+        import calendar
+        import datetime
+        from google.cloud._helpers import UTC
+
+        pb = self._makePB()
+        micros = 4375
+        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
+        self._call_fut(pb, utc)
+        value = pb.timestamp_value
+        self.assertEqual(value.seconds, calendar.timegm(utc.timetuple()))
+        self.assertEqual(value.nanos, 1000 * micros)
+
+    def test_key(self):
+        from google.cloud.datastore.key import Key
+
+        pb = self._makePB()
+        key = Key("KIND", 1234, project="PROJECT")
+        self._call_fut(pb, key)
+        value = pb.key_value
+        self.assertEqual(value, key.to_protobuf())
+
+    def test_none(self):
+        pb = self._makePB()
+        self._call_fut(pb, None)
+        self.assertEqual(pb.WhichOneof("value_type"), "null_value")
+
+    def test_bool(self):
+        pb = self._makePB()
+        self._call_fut(pb, False)
+        value = pb.boolean_value
+        self.assertEqual(value, False)
+
+    def test_float(self):
+        pb = self._makePB()
+        self._call_fut(pb, 3.1415926)
+        value = pb.double_value
+        self.assertEqual(value, 3.1415926)
+
+    def test_int(self):
+        pb = self._makePB()
+        self._call_fut(pb, 42)
+        value = pb.integer_value
+        self.assertEqual(value, 42)
+
+    def test_long(self):
+        pb = self._makePB()
+        must_be_long = (1 << 63) - 1
+        self._call_fut(pb, must_be_long)
+        value = pb.integer_value
+        self.assertEqual(value, must_be_long)
+
+    def test_native_str(self):
+        import six
+
+        pb = self._makePB()
+        self._call_fut(pb, "str")
+        if six.PY2:
+            value = pb.blob_value
+        else:  # pragma: NO COVER Python 3
+            value = pb.string_value
+        self.assertEqual(value, "str")
+
+    def test_bytes(self):
+        pb = self._makePB()
+        self._call_fut(pb, b"str")
+        value = pb.blob_value
+        self.assertEqual(value, b"str")
+
+    def test_unicode(self):
+        pb = self._makePB()
+        self._call_fut(pb, u"str")
+        value = pb.string_value
+        self.assertEqual(value, u"str")
+
+    def test_entity_empty_wo_key(self):
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.helpers import _property_tuples
+
+        pb = self._makePB()
+        entity = Entity()
+        self._call_fut(pb, entity)
+        value = pb.entity_value
+        self.assertEqual(value.key.SerializeToString(), b"")
+        self.assertEqual(len(list(_property_tuples(value))), 0)
+
+    def test_entity_w_key(self):
+        from google.cloud.datastore.entity import Entity
+        from google.cloud.datastore.helpers import _property_tuples
+        from google.cloud.datastore.key import Key
+
+        name = "foo"
+        value = u"Foo"
+        pb = self._makePB()
+        key = Key("KIND", 123, project="PROJECT")
+        entity = Entity(key=key)
+        entity[name] = value
+        self._call_fut(pb, entity)
+        entity_pb = pb.entity_value
+        self.assertEqual(entity_pb.key, key.to_protobuf())
+
+        prop_dict = dict(_property_tuples(entity_pb))
+        self.assertEqual(len(prop_dict), 1)
+        self.assertEqual(list(prop_dict.keys()), [name])
+        self.assertEqual(prop_dict[name].string_value, value)
+
+    def test_array(self):
+        pb = self._makePB()
+        values = [u"a", 0, 3.14]
+        self._call_fut(pb, values)
+        marshalled = pb.array_value.values
+        self.assertEqual(len(marshalled), len(values))
+        self.assertEqual(marshalled[0].string_value, values[0])
+        self.assertEqual(marshalled[1].integer_value, values[1])
+        self.assertEqual(marshalled[2].double_value, values[2])
+
+    def test_geo_point(self):
+        from google.type import latlng_pb2
+        from google.cloud.datastore.helpers import GeoPoint
+
+        pb = self._makePB()
+        lat = 9.11
+        lng = 3.337
+        geo_pt = GeoPoint(latitude=lat, longitude=lng)
+        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
+        self._call_fut(pb, geo_pt)
+        self.assertEqual(pb.geo_point_value, geo_pt_pb)
+
+
+class Test__get_meaning(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud.datastore.helpers import _get_meaning
+
+        return _get_meaning(*args, **kwargs)
+
+    def test_no_meaning(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        value_pb = entity_pb2.Value()
+        result = self._call_fut(value_pb)
+        self.assertIsNone(result)
+
+    def test_single(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        value_pb = entity_pb2.Value()
+        value_pb.meaning = meaning = 22
+        value_pb.string_value = u"hi"
+        result = self._call_fut(value_pb)
+        self.assertEqual(meaning, result)
+
+    def test_empty_array_value(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        value_pb = entity_pb2.Value()
+        value_pb.array_value.values.add()
+        value_pb.array_value.values.pop()
+
+        result = self._call_fut(value_pb, is_list=True)
+        self.assertEqual(None, result)
+
+    def test_array_value(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        value_pb = entity_pb2.Value()
+        meaning = 9
+        sub_value_pb1 = value_pb.array_value.values.add()
+        sub_value_pb2 = value_pb.array_value.values.add()
+
+        sub_value_pb1.meaning = sub_value_pb2.meaning = meaning
+        sub_value_pb1.string_value = u"hi"
+        sub_value_pb2.string_value = u"bye"
+
+        result = self._call_fut(value_pb, is_list=True)
+        self.assertEqual(meaning, result)
+
+    def test_array_value_multiple_meanings(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        value_pb = entity_pb2.Value()
+        meaning1 = 9
+        meaning2 = 10
+        sub_value_pb1 = value_pb.array_value.values.add()
+        sub_value_pb2 = value_pb.array_value.values.add()
+
+        sub_value_pb1.meaning = meaning1
+        sub_value_pb2.meaning = meaning2
+        sub_value_pb1.string_value = u"hi"
+        sub_value_pb2.string_value = u"bye"
+
+        result = self._call_fut(value_pb, is_list=True)
+        self.assertEqual(result, [meaning1, meaning2])
+
+    def test_array_value_meaning_partially_unset(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        value_pb = entity_pb2.Value()
+        meaning1 = 9
+        sub_value_pb1 = value_pb.array_value.values.add()
+        sub_value_pb2 = value_pb.array_value.values.add()
+
+        sub_value_pb1.meaning = meaning1
+        sub_value_pb1.string_value = u"hi"
+        sub_value_pb2.string_value = u"bye"
+
+        result = self._call_fut(value_pb, is_list=True)
+        self.assertEqual(result, [meaning1, None])
+
+
+class TestGeoPoint(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.helpers import GeoPoint
+
+        return GeoPoint
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_constructor(self):
+        lat = 81.2
+        lng = 359.9999
+        geo_pt = self._make_one(lat, lng)
+        self.assertEqual(geo_pt.latitude, lat)
+        self.assertEqual(geo_pt.longitude, lng)
+
+    def test_to_protobuf(self):
+        from google.type import latlng_pb2
+
+        lat = 0.0001
+        lng = 20.03
+        geo_pt = self._make_one(lat, lng)
+        result = geo_pt.to_protobuf()
+        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
+        self.assertEqual(result, geo_pt_pb)
+
+    def test___eq__(self):
+        lat = 0.0001
+        lng = 20.03
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = self._make_one(lat, lng)
+        self.assertEqual(geo_pt1, geo_pt2)
+
+    def test___eq__type_differ(self):
+        lat = 0.0001
+        lng = 20.03
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = object()
+        self.assertNotEqual(geo_pt1, geo_pt2)
+
+    def test___ne__same_value(self):
+        lat = 0.0001
+        lng = 20.03
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = self._make_one(lat, lng)
+        comparison_val = geo_pt1 != geo_pt2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        geo_pt1 = self._make_one(0.0, 1.0)
+        geo_pt2 = self._make_one(2.0, 3.0)
+        self.assertNotEqual(geo_pt1, geo_pt2)
diff --git a/datastore/tests/unit/test_key.py b/datastore/tests/unit/test_key.py
new file mode 100644
index 000000000000..a157d50b576a
--- /dev/null
+++ b/datastore/tests/unit/test_key.py
@@ -0,0 +1,750 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestKey(unittest.TestCase):
+
+    _DEFAULT_PROJECT = "PROJECT"
+    # NOTE: This comes directly from a running (in the dev appserver)
+    #       App Engine app. Created via:
+    #
+    #           from google.appengine.ext import ndb
+    #           key = ndb.Key(
+    #               'Parent', 59, 'Child', 'Feather',
+    #               namespace='space', app='s~sample-app')
+    #           urlsafe = key.urlsafe()
+    _URLSAFE_EXAMPLE1 = (
+        b"agxzfnNhbXBsZS1hcHByHgsSBlBhcmVudBg7DAsSBUNoaWxkIgdGZ" b"WF0aGVyDKIBBXNwYWNl"
+    )
+    _URLSAFE_APP1 = "s~sample-app"
+    _URLSAFE_NAMESPACE1 = "space"
+    _URLSAFE_FLAT_PATH1 = ("Parent", 59, "Child", "Feather")
+    _URLSAFE_EXAMPLE2 = b"agZzfmZpcmVyDwsSBEtpbmQiBVRoaW5nDA"
+    _URLSAFE_APP2 = "s~fire"
+    _URLSAFE_FLAT_PATH2 = ("Kind", "Thing")
+    _URLSAFE_EXAMPLE3 = b"ahhzfnNhbXBsZS1hcHAtbm8tbG9jYXRpb25yCgsSBFpvcnAYWAw"
+    _URLSAFE_APP3 = "sample-app-no-location"
+    _URLSAFE_FLAT_PATH3 = ("Zorp", 88)
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.key import Key
+
+        return Key
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_ctor_empty(self):
+        self.assertRaises(ValueError, self._make_one)
+
+    def test_ctor_no_project(self):
+        klass = self._get_target_class()
+        self.assertRaises(ValueError, klass, "KIND")
+
+    def test_ctor_w_explicit_project_empty_path(self):
+        _PROJECT = "PROJECT"
+        self.assertRaises(ValueError, self._make_one, project=_PROJECT)
+
+    def test_ctor_parent(self):
+        _PARENT_KIND = "KIND1"
+        _PARENT_ID = 1234
+        _PARENT_PROJECT = "PROJECT-ALT"
+        _PARENT_NAMESPACE = "NAMESPACE"
+        _CHILD_KIND = "KIND2"
+        _CHILD_ID = 2345
+        _PATH = [
+            {"kind": _PARENT_KIND, "id": _PARENT_ID},
+            {"kind": _CHILD_KIND, "id": _CHILD_ID},
+        ]
+        parent_key = self._make_one(
+            _PARENT_KIND,
+            _PARENT_ID,
+            project=_PARENT_PROJECT,
+            namespace=_PARENT_NAMESPACE,
+        )
+        key = self._make_one(_CHILD_KIND, _CHILD_ID, parent=parent_key)
+        self.assertEqual(key.project, parent_key.project)
+        self.assertEqual(key.namespace, parent_key.namespace)
+        self.assertEqual(key.kind, _CHILD_KIND)
+        self.assertEqual(key.path, _PATH)
+        self.assertIs(key.parent, parent_key)
+
+    def test_ctor_partial_parent(self):
+        parent_key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        with self.assertRaises(ValueError):
+            self._make_one("KIND2", 1234, parent=parent_key)
+
+    def test_ctor_parent_bad_type(self):
+        with self.assertRaises(AttributeError):
+            self._make_one(
+                "KIND2", 1234, parent=("KIND1", 1234), project=self._DEFAULT_PROJECT
+            )
+
+    def test_ctor_parent_bad_namespace(self):
+        parent_key = self._make_one(
+            "KIND", 1234, namespace="FOO", project=self._DEFAULT_PROJECT
+        )
+        with self.assertRaises(ValueError):
+            self._make_one(
+                "KIND2",
+                1234,
+                namespace="BAR",
+                parent=parent_key,
+                PROJECT=self._DEFAULT_PROJECT,
+            )
+
+    def test_ctor_parent_bad_project(self):
+        parent_key = self._make_one("KIND", 1234, project="FOO")
+        with self.assertRaises(ValueError):
+            self._make_one("KIND2", 1234, parent=parent_key, project="BAR")
+
+    def test_ctor_parent_empty_path(self):
+        parent_key = self._make_one("KIND", 1234, project=self._DEFAULT_PROJECT)
+        with self.assertRaises(ValueError):
+            self._make_one(parent=parent_key)
+
+    def test_ctor_explicit(self):
+        _PROJECT = "PROJECT-ALT"
+        _NAMESPACE = "NAMESPACE"
+        _KIND = "KIND"
+        _ID = 1234
+        _PATH = [{"kind": _KIND, "id": _ID}]
+        key = self._make_one(_KIND, _ID, namespace=_NAMESPACE, project=_PROJECT)
+        self.assertEqual(key.project, _PROJECT)
+        self.assertEqual(key.namespace, _NAMESPACE)
+        self.assertEqual(key.kind, _KIND)
+        self.assertEqual(key.path, _PATH)
+
+    def test_ctor_bad_kind(self):
+        self.assertRaises(
+            ValueError, self._make_one, object(), project=self._DEFAULT_PROJECT
+        )
+
+    def test_ctor_bad_id_or_name(self):
+        self.assertRaises(
+            ValueError, self._make_one, "KIND", object(), project=self._DEFAULT_PROJECT
+        )
+        self.assertRaises(
+            ValueError, self._make_one, "KIND", None, project=self._DEFAULT_PROJECT
+        )
+        self.assertRaises(
+            ValueError,
+            self._make_one,
+            "KIND",
+            10,
+            "KIND2",
+            None,
+            project=self._DEFAULT_PROJECT,
+        )
+
+    def test__clone(self):
+        _PROJECT = "PROJECT-ALT"
+        _NAMESPACE = "NAMESPACE"
+        _KIND = "KIND"
+        _ID = 1234
+        _PATH = [{"kind": _KIND, "id": _ID}]
+        key = self._make_one(_KIND, _ID, namespace=_NAMESPACE, project=_PROJECT)
+        clone = key._clone()
+        self.assertEqual(clone.project, _PROJECT)
+        self.assertEqual(clone.namespace, _NAMESPACE)
+        self.assertEqual(clone.kind, _KIND)
+        self.assertEqual(clone.path, _PATH)
+
+    def test__clone_with_parent(self):
+        _PROJECT = "PROJECT-ALT"
+        _NAMESPACE = "NAMESPACE"
+        _KIND1 = "PARENT"
+        _KIND2 = "KIND"
+        _ID1 = 1234
+        _ID2 = 2345
+        _PATH = [{"kind": _KIND1, "id": _ID1}, {"kind": _KIND2, "id": _ID2}]
+
+        parent = self._make_one(_KIND1, _ID1, namespace=_NAMESPACE, project=_PROJECT)
+        key = self._make_one(_KIND2, _ID2, parent=parent)
+        self.assertIs(key.parent, parent)
+        clone = key._clone()
+        self.assertIs(clone.parent, key.parent)
+        self.assertEqual(clone.project, _PROJECT)
+        self.assertEqual(clone.namespace, _NAMESPACE)
+        self.assertEqual(clone.path, _PATH)
+
+    def test___eq_____ne___w_non_key(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _NAME = "one"
+        key = self._make_one(_KIND, _NAME, project=_PROJECT)
+        self.assertFalse(key == object())
+        self.assertTrue(key != object())
+
+    def test___eq_____ne___two_incomplete_keys_same_kind(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        key1 = self._make_one(_KIND, project=_PROJECT)
+        key2 = self._make_one(_KIND, project=_PROJECT)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___incomplete_key_w_complete_key_same_kind(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+        key1 = self._make_one(_KIND, project=_PROJECT)
+        key2 = self._make_one(_KIND, _ID, project=_PROJECT)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___complete_key_w_incomplete_key_same_kind(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+        key1 = self._make_one(_KIND, _ID, project=_PROJECT)
+        key2 = self._make_one(_KIND, project=_PROJECT)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___same_kind_different_ids(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID1 = 1234
+        _ID2 = 2345
+        key1 = self._make_one(_KIND, _ID1, project=_PROJECT)
+        key2 = self._make_one(_KIND, _ID2, project=_PROJECT)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___same_kind_and_id(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+        key1 = self._make_one(_KIND, _ID, project=_PROJECT)
+        key2 = self._make_one(_KIND, _ID, project=_PROJECT)
+        self.assertTrue(key1 == key2)
+        self.assertFalse(key1 != key2)
+
+    def test___eq_____ne___same_kind_and_id_different_project(self):
+        _PROJECT1 = "PROJECT1"
+        _PROJECT2 = "PROJECT2"
+        _KIND = "KIND"
+        _ID = 1234
+        key1 = self._make_one(_KIND, _ID, project=_PROJECT1)
+        key2 = self._make_one(_KIND, _ID, project=_PROJECT2)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___same_kind_and_id_different_namespace(self):
+        _PROJECT = "PROJECT"
+        _NAMESPACE1 = "NAMESPACE1"
+        _NAMESPACE2 = "NAMESPACE2"
+        _KIND = "KIND"
+        _ID = 1234
+        key1 = self._make_one(_KIND, _ID, project=_PROJECT, namespace=_NAMESPACE1)
+        key2 = self._make_one(_KIND, _ID, project=_PROJECT, namespace=_NAMESPACE2)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___same_kind_different_names(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _NAME1 = "one"
+        _NAME2 = "two"
+        key1 = self._make_one(_KIND, _NAME1, project=_PROJECT)
+        key2 = self._make_one(_KIND, _NAME2, project=_PROJECT)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___same_kind_and_name(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _NAME = "one"
+        key1 = self._make_one(_KIND, _NAME, project=_PROJECT)
+        key2 = self._make_one(_KIND, _NAME, project=_PROJECT)
+        self.assertTrue(key1 == key2)
+        self.assertFalse(key1 != key2)
+
+    def test___eq_____ne___same_kind_and_name_different_project(self):
+        _PROJECT1 = "PROJECT1"
+        _PROJECT2 = "PROJECT2"
+        _KIND = "KIND"
+        _NAME = "one"
+        key1 = self._make_one(_KIND, _NAME, project=_PROJECT1)
+        key2 = self._make_one(_KIND, _NAME, project=_PROJECT2)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___eq_____ne___same_kind_and_name_different_namespace(self):
+        _PROJECT = "PROJECT"
+        _NAMESPACE1 = "NAMESPACE1"
+        _NAMESPACE2 = "NAMESPACE2"
+        _KIND = "KIND"
+        _NAME = "one"
+        key1 = self._make_one(_KIND, _NAME, project=_PROJECT, namespace=_NAMESPACE1)
+        key2 = self._make_one(_KIND, _NAME, project=_PROJECT, namespace=_NAMESPACE2)
+        self.assertFalse(key1 == key2)
+        self.assertTrue(key1 != key2)
+
+    def test___hash___incomplete(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        key = self._make_one(_KIND, project=_PROJECT)
+        self.assertNotEqual(hash(key), hash(_KIND) + hash(_PROJECT) + hash(None))
+
+    def test___hash___completed_w_id(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _ID = 1234
+        key = self._make_one(_KIND, _ID, project=_PROJECT)
+        self.assertNotEqual(
+            hash(key), hash(_KIND) + hash(_ID) + hash(_PROJECT) + hash(None)
+        )
+
+    def test___hash___completed_w_name(self):
+        _PROJECT = "PROJECT"
+        _KIND = "KIND"
+        _NAME = "NAME"
+        key = self._make_one(_KIND, _NAME, project=_PROJECT)
+        self.assertNotEqual(
+            hash(key), hash(_KIND) + hash(_NAME) + hash(_PROJECT) + hash(None)
+        )
+
+    def test_completed_key_on_partial_w_id(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        _ID = 1234
+        new_key = key.completed_key(_ID)
+        self.assertIsNot(key, new_key)
+        self.assertEqual(new_key.id, _ID)
+        self.assertIsNone(new_key.name)
+
+    def test_completed_key_on_partial_w_name(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        _NAME = "NAME"
+        new_key = key.completed_key(_NAME)
+        self.assertIsNot(key, new_key)
+        self.assertIsNone(new_key.id)
+        self.assertEqual(new_key.name, _NAME)
+
+    def test_completed_key_on_partial_w_invalid(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        self.assertRaises(ValueError, key.completed_key, object())
+
+    def test_completed_key_on_complete(self):
+        key = self._make_one("KIND", 1234, project=self._DEFAULT_PROJECT)
+        self.assertRaises(ValueError, key.completed_key, 5678)
+
+    def test_to_protobuf_defaults(self):
+        from google.cloud.datastore_v1.proto import entity_pb2
+
+        _KIND = "KIND"
+        key = self._make_one(_KIND, project=self._DEFAULT_PROJECT)
+        pb = key.to_protobuf()
+        self.assertIsInstance(pb, entity_pb2.Key)
+
+        # Check partition ID.
+        self.assertEqual(pb.partition_id.project_id, self._DEFAULT_PROJECT)
+        # Unset values are False-y.
+        self.assertEqual(pb.partition_id.namespace_id, "")
+
+        # Check the element PB matches the partial key and kind.
+        elem, = list(pb.path)
+        self.assertEqual(elem.kind, _KIND)
+        # Unset values are False-y.
+        self.assertEqual(elem.name, "")
+        # Unset values are False-y.
+        self.assertEqual(elem.id, 0)
+
+    def test_to_protobuf_w_explicit_project(self):
+        _PROJECT = "PROJECT-ALT"
+        key = self._make_one("KIND", project=_PROJECT)
+        pb = key.to_protobuf()
+        self.assertEqual(pb.partition_id.project_id, _PROJECT)
+
+    def test_to_protobuf_w_explicit_namespace(self):
+        _NAMESPACE = "NAMESPACE"
+        key = self._make_one(
+            "KIND", namespace=_NAMESPACE, project=self._DEFAULT_PROJECT
+        )
+        pb = key.to_protobuf()
+        self.assertEqual(pb.partition_id.namespace_id, _NAMESPACE)
+
+    def test_to_protobuf_w_explicit_path(self):
+        _PARENT = "PARENT"
+        _CHILD = "CHILD"
+        _ID = 1234
+        _NAME = "NAME"
+        key = self._make_one(_PARENT, _NAME, _CHILD, _ID, project=self._DEFAULT_PROJECT)
+        pb = key.to_protobuf()
+        elems = list(pb.path)
+        self.assertEqual(len(elems), 2)
+        self.assertEqual(elems[0].kind, _PARENT)
+        self.assertEqual(elems[0].name, _NAME)
+        self.assertEqual(elems[1].kind, _CHILD)
+        self.assertEqual(elems[1].id, _ID)
+
+    def test_to_protobuf_w_no_kind(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        # Force the 'kind' to be unset. Maybe `to_protobuf` should fail
+        # on this? The backend certainly will.
+        key._path[-1].pop("kind")
+        pb = key.to_protobuf()
+        # Unset values are False-y.
+        self.assertEqual(pb.path[0].kind, "")
+
+    def test_to_legacy_urlsafe(self):
+        key = self._make_one(
+            *self._URLSAFE_FLAT_PATH1,
+            project=self._URLSAFE_APP1,
+            namespace=self._URLSAFE_NAMESPACE1
+        )
+        # NOTE: ``key.project`` is somewhat "invalid" but that is OK.
+        urlsafe = key.to_legacy_urlsafe()
+        self.assertEqual(urlsafe, self._URLSAFE_EXAMPLE1)
+
+    def test_to_legacy_urlsafe_strip_padding(self):
+        key = self._make_one(*self._URLSAFE_FLAT_PATH2, project=self._URLSAFE_APP2)
+        # NOTE: ``key.project`` is somewhat "invalid" but that is OK.
+        urlsafe = key.to_legacy_urlsafe()
+        self.assertEqual(urlsafe, self._URLSAFE_EXAMPLE2)
+        # Make sure it started with base64 padding.
+        self.assertNotEqual(len(self._URLSAFE_EXAMPLE2) % 4, 0)
+
+    def test_to_legacy_urlsafe_with_location_prefix(self):
+        key = self._make_one(*self._URLSAFE_FLAT_PATH3, project=self._URLSAFE_APP3)
+        urlsafe = key.to_legacy_urlsafe(location_prefix="s~")
+        self.assertEqual(urlsafe, self._URLSAFE_EXAMPLE3)
+
+    def test_from_legacy_urlsafe(self):
+        klass = self._get_target_class()
+        key = klass.from_legacy_urlsafe(self._URLSAFE_EXAMPLE1)
+
+        self.assertEqual("s~" + key.project, self._URLSAFE_APP1)
+        self.assertEqual(key.namespace, self._URLSAFE_NAMESPACE1)
+        self.assertEqual(key.flat_path, self._URLSAFE_FLAT_PATH1)
+        # Also make sure we didn't accidentally set the parent.
+        self.assertIsNone(key._parent)
+        self.assertIsNotNone(key.parent)
+        self.assertIs(key._parent, key.parent)
+
+    def test_from_legacy_urlsafe_needs_padding(self):
+        klass = self._get_target_class()
+        # Make sure it will have base64 padding added.
+        self.assertNotEqual(len(self._URLSAFE_EXAMPLE2) % 4, 0)
+        key = klass.from_legacy_urlsafe(self._URLSAFE_EXAMPLE2)
+
+        self.assertEqual("s~" + key.project, self._URLSAFE_APP2)
+        self.assertIsNone(key.namespace)
+        self.assertEqual(key.flat_path, self._URLSAFE_FLAT_PATH2)
+
+    def test_from_legacy_urlsafe_with_location_prefix(self):
+        klass = self._get_target_class()
+        # Make sure it will have base64 padding added.
+        key = klass.from_legacy_urlsafe(self._URLSAFE_EXAMPLE3)
+
+        self.assertEqual(key.project, self._URLSAFE_APP3)
+        self.assertIsNone(key.namespace)
+        self.assertEqual(key.flat_path, self._URLSAFE_FLAT_PATH3)
+
+    def test_is_partial_no_name_or_id(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        self.assertTrue(key.is_partial)
+
+    def test_is_partial_w_id(self):
+        _ID = 1234
+        key = self._make_one("KIND", _ID, project=self._DEFAULT_PROJECT)
+        self.assertFalse(key.is_partial)
+
+    def test_is_partial_w_name(self):
+        _NAME = "NAME"
+        key = self._make_one("KIND", _NAME, project=self._DEFAULT_PROJECT)
+        self.assertFalse(key.is_partial)
+
+    def test_id_or_name_no_name_or_id(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        self.assertIsNone(key.id_or_name)
+
+    def test_id_or_name_no_name_or_id_child(self):
+        key = self._make_one("KIND1", 1234, "KIND2", project=self._DEFAULT_PROJECT)
+        self.assertIsNone(key.id_or_name)
+
+    def test_id_or_name_w_id_only(self):
+        _ID = 1234
+        key = self._make_one("KIND", _ID, project=self._DEFAULT_PROJECT)
+        self.assertEqual(key.id_or_name, _ID)
+
+    def test_id_or_name_w_name_only(self):
+        _NAME = "NAME"
+        key = self._make_one("KIND", _NAME, project=self._DEFAULT_PROJECT)
+        self.assertEqual(key.id_or_name, _NAME)
+
+    def test_parent_default(self):
+        key = self._make_one("KIND", project=self._DEFAULT_PROJECT)
+        self.assertIsNone(key.parent)
+
+    def test_parent_explicit_top_level(self):
+        key = self._make_one("KIND", 1234, project=self._DEFAULT_PROJECT)
+        self.assertIsNone(key.parent)
+
+    def test_parent_explicit_nested(self):
+        _PARENT_KIND = "KIND1"
+        _PARENT_ID = 1234
+        _PARENT_PATH = [{"kind": _PARENT_KIND, "id": _PARENT_ID}]
+        key = self._make_one(
+            _PARENT_KIND, _PARENT_ID, "KIND2", project=self._DEFAULT_PROJECT
+        )
+        self.assertEqual(key.parent.path, _PARENT_PATH)
+
+    def test_parent_multiple_calls(self):
+        _PARENT_KIND = "KIND1"
+        _PARENT_ID = 1234
+        _PARENT_PATH = [{"kind": _PARENT_KIND, "id": _PARENT_ID}]
+        key = self._make_one(
+            _PARENT_KIND, _PARENT_ID, "KIND2", project=self._DEFAULT_PROJECT
+        )
+        parent = key.parent
+        self.assertEqual(parent.path, _PARENT_PATH)
+        new_parent = key.parent
+        self.assertIs(parent, new_parent)
+
+
+class Test__clean_app(unittest.TestCase):
+
+    PROJECT = "my-prahjekt"
+
+    @staticmethod
+    def _call_fut(app_str):
+        from google.cloud.datastore.key import _clean_app
+
+        return _clean_app(app_str)
+
+    def test_already_clean(self):
+        app_str = self.PROJECT
+        self.assertEqual(self._call_fut(app_str), self.PROJECT)
+
+    def test_standard(self):
+        app_str = "s~" + self.PROJECT
+        self.assertEqual(self._call_fut(app_str), self.PROJECT)
+
+    def test_european(self):
+        app_str = "e~" + self.PROJECT
+        self.assertEqual(self._call_fut(app_str), self.PROJECT)
+
+    def test_dev_server(self):
+        app_str = "dev~" + self.PROJECT
+        self.assertEqual(self._call_fut(app_str), self.PROJECT)
+
+
+class Test__get_empty(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value, empty_value):
+        from google.cloud.datastore.key import _get_empty
+
+        return _get_empty(value, empty_value)
+
+    def test_unset(self):
+        for empty_value in (u"", 0, 0.0, []):
+            ret_val = self._call_fut(empty_value, empty_value)
+            self.assertIsNone(ret_val)
+
+    def test_actually_set(self):
+        value_pairs = ((u"hello", u""), (10, 0), (3.14, 0.0), (["stuff", "here"], []))
+        for value, empty_value in value_pairs:
+            ret_val = self._call_fut(value, empty_value)
+            self.assertIs(ret_val, value)
+
+
+class Test__check_database_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut(database_id):
+        from google.cloud.datastore.key import _check_database_id
+
+        return _check_database_id(database_id)
+
+    def test_empty_value(self):
+        ret_val = self._call_fut(u"")
+        # Really we are just happy there was no exception.
+        self.assertIsNone(ret_val)
+
+    def test_failure(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(u"some-database-id")
+
+
+class Test__add_id_or_name(unittest.TestCase):
+    @staticmethod
+    def _call_fut(flat_path, element_pb, empty_allowed):
+        from google.cloud.datastore.key import _add_id_or_name
+
+        return _add_id_or_name(flat_path, element_pb, empty_allowed)
+
+    def test_add_id(self):
+        flat_path = []
+        id_ = 123
+        element_pb = _make_element_pb(id=id_)
+
+        ret_val = self._call_fut(flat_path, element_pb, False)
+        self.assertIsNone(ret_val)
+        self.assertEqual(flat_path, [id_])
+        ret_val = self._call_fut(flat_path, element_pb, True)
+        self.assertIsNone(ret_val)
+        self.assertEqual(flat_path, [id_, id_])
+
+    def test_add_name(self):
+        flat_path = []
+        name = "moon-shadow"
+        element_pb = _make_element_pb(name=name)
+
+        ret_val = self._call_fut(flat_path, element_pb, False)
+        self.assertIsNone(ret_val)
+        self.assertEqual(flat_path, [name])
+        ret_val = self._call_fut(flat_path, element_pb, True)
+        self.assertIsNone(ret_val)
+        self.assertEqual(flat_path, [name, name])
+
+    def test_both_present(self):
+        element_pb = _make_element_pb(id=17, name="seventeen")
+        flat_path = []
+        with self.assertRaises(ValueError):
+            self._call_fut(flat_path, element_pb, False)
+        with self.assertRaises(ValueError):
+            self._call_fut(flat_path, element_pb, True)
+
+        self.assertEqual(flat_path, [])
+
+    def test_both_empty_failure(self):
+        element_pb = _make_element_pb()
+        flat_path = []
+        with self.assertRaises(ValueError):
+            self._call_fut(flat_path, element_pb, False)
+
+        self.assertEqual(flat_path, [])
+
+    def test_both_empty_allowed(self):
+        element_pb = _make_element_pb()
+        flat_path = []
+        ret_val = self._call_fut(flat_path, element_pb, True)
+        self.assertIsNone(ret_val)
+        self.assertEqual(flat_path, [])
+
+
+class Test__get_flat_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path_pb):
+        from google.cloud.datastore.key import _get_flat_path
+
+        return _get_flat_path(path_pb)
+
+    def test_one_pair(self):
+        kind = "Widget"
+        name = "Scooter"
+        element_pb = _make_element_pb(type=kind, name=name)
+        path_pb = _make_path_pb(element_pb)
+        flat_path = self._call_fut(path_pb)
+        self.assertEqual(flat_path, (kind, name))
+
+    def test_two_pairs(self):
+        kind1 = "parent"
+        id1 = 59
+        element_pb1 = _make_element_pb(type=kind1, id=id1)
+
+        kind2 = "child"
+        name2 = "naem"
+        element_pb2 = _make_element_pb(type=kind2, name=name2)
+
+        path_pb = _make_path_pb(element_pb1, element_pb2)
+        flat_path = self._call_fut(path_pb)
+        self.assertEqual(flat_path, (kind1, id1, kind2, name2))
+
+    def test_partial_key(self):
+        kind1 = "grandparent"
+        name1 = "cats"
+        element_pb1 = _make_element_pb(type=kind1, name=name1)
+
+        kind2 = "parent"
+        id2 = 1337
+        element_pb2 = _make_element_pb(type=kind2, id=id2)
+
+        kind3 = "child"
+        element_pb3 = _make_element_pb(type=kind3)
+
+        path_pb = _make_path_pb(element_pb1, element_pb2, element_pb3)
+        flat_path = self._call_fut(path_pb)
+        self.assertEqual(flat_path, (kind1, name1, kind2, id2, kind3))
+
+
+class Test__to_legacy_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(dict_path):
+        from google.cloud.datastore.key import _to_legacy_path
+
+        return _to_legacy_path(dict_path)
+
+    def test_one_pair(self):
+        kind = "Widget"
+        name = "Scooter"
+        dict_path = [{"kind": kind, "name": name}]
+        path_pb = self._call_fut(dict_path)
+
+        element_pb = _make_element_pb(type=kind, name=name)
+        expected_pb = _make_path_pb(element_pb)
+        self.assertEqual(path_pb, expected_pb)
+
+    def test_two_pairs(self):
+        kind1 = "parent"
+        id1 = 59
+
+        kind2 = "child"
+        name2 = "naem"
+
+        dict_path = [{"kind": kind1, "id": id1}, {"kind": kind2, "name": name2}]
+        path_pb = self._call_fut(dict_path)
+
+        element_pb1 = _make_element_pb(type=kind1, id=id1)
+        element_pb2 = _make_element_pb(type=kind2, name=name2)
+        expected_pb = _make_path_pb(element_pb1, element_pb2)
+        self.assertEqual(path_pb, expected_pb)
+
+    def test_partial_key(self):
+        kind1 = "grandparent"
+        name1 = "cats"
+
+        kind2 = "parent"
+        id2 = 1337
+
+        kind3 = "child"
+
+        dict_path = [
+            {"kind": kind1, "name": name1},
+            {"kind": kind2, "id": id2},
+            {"kind": kind3},
+        ]
+        path_pb = self._call_fut(dict_path)
+
+        element_pb1 = _make_element_pb(type=kind1, name=name1)
+        element_pb2 = _make_element_pb(type=kind2, id=id2)
+        element_pb3 = _make_element_pb(type=kind3)
+        expected_pb = _make_path_pb(element_pb1, element_pb2, element_pb3)
+        self.assertEqual(path_pb, expected_pb)
+
+
+def _make_element_pb(**kwargs):
+    from google.cloud.datastore import _app_engine_key_pb2
+
+    return _app_engine_key_pb2.Path.Element(**kwargs)
+
+
+def _make_path_pb(*element_pbs):
+    from google.cloud.datastore import _app_engine_key_pb2
+
+    return _app_engine_key_pb2.Path(element=element_pbs)
diff --git a/datastore/tests/unit/test_query.py b/datastore/tests/unit/test_query.py
new file mode 100644
index 000000000000..01a005f4eb78
--- /dev/null
+++ b/datastore/tests/unit/test_query.py
@@ -0,0 +1,741 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestQuery(unittest.TestCase):
+
+    _PROJECT = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.query import Query
+
+        return Query
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _make_client(self):
+        return _Client(self._PROJECT)
+
+    def test_ctor_defaults(self):
+        client = self._make_client()
+        query = self._make_one(client)
+        self.assertIs(query._client, client)
+        self.assertEqual(query.project, client.project)
+        self.assertIsNone(query.kind)
+        self.assertEqual(query.namespace, client.namespace)
+        self.assertIsNone(query.ancestor)
+        self.assertEqual(query.filters, [])
+        self.assertEqual(query.projection, [])
+        self.assertEqual(query.order, [])
+        self.assertEqual(query.distinct_on, [])
+
+    def test_ctor_explicit(self):
+        from google.cloud.datastore.key import Key
+
+        _PROJECT = "OTHER_PROJECT"
+        _KIND = "KIND"
+        _NAMESPACE = "OTHER_NAMESPACE"
+        client = self._make_client()
+        ancestor = Key("ANCESTOR", 123, project=_PROJECT)
+        FILTERS = [("foo", "=", "Qux"), ("bar", "<", 17)]
+        PROJECTION = ["foo", "bar", "baz"]
+        ORDER = ["foo", "bar"]
+        DISTINCT_ON = ["foo"]
+        query = self._make_one(
+            client,
+            kind=_KIND,
+            project=_PROJECT,
+            namespace=_NAMESPACE,
+            ancestor=ancestor,
+            filters=FILTERS,
+            projection=PROJECTION,
+            order=ORDER,
+            distinct_on=DISTINCT_ON,
+        )
+        self.assertIs(query._client, client)
+        self.assertEqual(query.project, _PROJECT)
+        self.assertEqual(query.kind, _KIND)
+        self.assertEqual(query.namespace, _NAMESPACE)
+        self.assertEqual(query.ancestor.path, ancestor.path)
+        self.assertEqual(query.filters, FILTERS)
+        self.assertEqual(query.projection, PROJECTION)
+        self.assertEqual(query.order, ORDER)
+        self.assertEqual(query.distinct_on, DISTINCT_ON)
+
+    def test_ctor_bad_projection(self):
+        BAD_PROJECTION = object()
+        self.assertRaises(
+            TypeError, self._make_one, self._make_client(), projection=BAD_PROJECTION
+        )
+
+    def test_ctor_bad_order(self):
+        BAD_ORDER = object()
+        self.assertRaises(
+            TypeError, self._make_one, self._make_client(), order=BAD_ORDER
+        )
+
+    def test_ctor_bad_distinct_on(self):
+        BAD_DISTINCT_ON = object()
+        self.assertRaises(
+            TypeError, self._make_one, self._make_client(), distinct_on=BAD_DISTINCT_ON
+        )
+
+    def test_ctor_bad_filters(self):
+        FILTERS_CANT_UNPACK = [("one", "two")]
+        self.assertRaises(
+            ValueError, self._make_one, self._make_client(), filters=FILTERS_CANT_UNPACK
+        )
+
+    def test_namespace_setter_w_non_string(self):
+        query = self._make_one(self._make_client())
+
+        def _assign(val):
+            query.namespace = val
+
+        self.assertRaises(ValueError, _assign, object())
+
+    def test_namespace_setter(self):
+        _NAMESPACE = "OTHER_NAMESPACE"
+        query = self._make_one(self._make_client())
+        query.namespace = _NAMESPACE
+        self.assertEqual(query.namespace, _NAMESPACE)
+
+    def test_kind_setter_w_non_string(self):
+        query = self._make_one(self._make_client())
+
+        def _assign(val):
+            query.kind = val
+
+        self.assertRaises(TypeError, _assign, object())
+
+    def test_kind_setter_wo_existing(self):
+        _KIND = "KIND"
+        query = self._make_one(self._make_client())
+        query.kind = _KIND
+        self.assertEqual(query.kind, _KIND)
+
+    def test_kind_setter_w_existing(self):
+        _KIND_BEFORE = "KIND_BEFORE"
+        _KIND_AFTER = "KIND_AFTER"
+        query = self._make_one(self._make_client(), kind=_KIND_BEFORE)
+        self.assertEqual(query.kind, _KIND_BEFORE)
+        query.kind = _KIND_AFTER
+        self.assertEqual(query.project, self._PROJECT)
+        self.assertEqual(query.kind, _KIND_AFTER)
+
+    def test_ancestor_setter_w_non_key(self):
+        query = self._make_one(self._make_client())
+
+        def _assign(val):
+            query.ancestor = val
+
+        self.assertRaises(TypeError, _assign, object())
+        self.assertRaises(TypeError, _assign, ["KIND", "NAME"])
+
+    def test_ancestor_setter_w_key(self):
+        from google.cloud.datastore.key import Key
+
+        _NAME = u"NAME"
+        key = Key("KIND", 123, project=self._PROJECT)
+        query = self._make_one(self._make_client())
+        query.add_filter("name", "=", _NAME)
+        query.ancestor = key
+        self.assertEqual(query.ancestor.path, key.path)
+
+    def test_ancestor_deleter_w_key(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key("KIND", 123, project=self._PROJECT)
+        query = self._make_one(client=self._make_client(), ancestor=key)
+        del query.ancestor
+        self.assertIsNone(query.ancestor)
+
+    def test_add_filter_setter_w_unknown_operator(self):
+        query = self._make_one(self._make_client())
+        self.assertRaises(ValueError, query.add_filter, "firstname", "~~", "John")
+
+    def test_add_filter_w_known_operator(self):
+        query = self._make_one(self._make_client())
+        query.add_filter("firstname", "=", u"John")
+        self.assertEqual(query.filters, [("firstname", "=", u"John")])
+
+    def test_add_filter_w_all_operators(self):
+        query = self._make_one(self._make_client())
+        query.add_filter("leq_prop", "<=", u"val1")
+        query.add_filter("geq_prop", ">=", u"val2")
+        query.add_filter("lt_prop", "<", u"val3")
+        query.add_filter("gt_prop", ">", u"val4")
+        query.add_filter("eq_prop", "=", u"val5")
+        self.assertEqual(len(query.filters), 5)
+        self.assertEqual(query.filters[0], ("leq_prop", "<=", u"val1"))
+        self.assertEqual(query.filters[1], ("geq_prop", ">=", u"val2"))
+        self.assertEqual(query.filters[2], ("lt_prop", "<", u"val3"))
+        self.assertEqual(query.filters[3], ("gt_prop", ">", u"val4"))
+        self.assertEqual(query.filters[4], ("eq_prop", "=", u"val5"))
+
+    def test_add_filter_w_known_operator_and_entity(self):
+        from google.cloud.datastore.entity import Entity
+
+        query = self._make_one(self._make_client())
+        other = Entity()
+        other["firstname"] = u"John"
+        other["lastname"] = u"Smith"
+        query.add_filter("other", "=", other)
+        self.assertEqual(query.filters, [("other", "=", other)])
+
+    def test_add_filter_w_whitespace_property_name(self):
+        query = self._make_one(self._make_client())
+        PROPERTY_NAME = "  property with lots of space "
+        query.add_filter(PROPERTY_NAME, "=", u"John")
+        self.assertEqual(query.filters, [(PROPERTY_NAME, "=", u"John")])
+
+    def test_add_filter___key__valid_key(self):
+        from google.cloud.datastore.key import Key
+
+        query = self._make_one(self._make_client())
+        key = Key("Foo", project=self._PROJECT)
+        query.add_filter("__key__", "=", key)
+        self.assertEqual(query.filters, [("__key__", "=", key)])
+
+    def test_filter___key__not_equal_operator(self):
+        from google.cloud.datastore.key import Key
+
+        key = Key("Foo", project=self._PROJECT)
+        query = self._make_one(self._make_client())
+        query.add_filter("__key__", "<", key)
+        self.assertEqual(query.filters, [("__key__", "<", key)])
+
+    def test_filter___key__invalid_value(self):
+        query = self._make_one(self._make_client())
+        self.assertRaises(ValueError, query.add_filter, "__key__", "=", None)
+
+    def test_projection_setter_empty(self):
+        query = self._make_one(self._make_client())
+        query.projection = []
+        self.assertEqual(query.projection, [])
+
+    def test_projection_setter_string(self):
+        query = self._make_one(self._make_client())
+        query.projection = "field1"
+        self.assertEqual(query.projection, ["field1"])
+
+    def test_projection_setter_non_empty(self):
+        query = self._make_one(self._make_client())
+        query.projection = ["field1", "field2"]
+        self.assertEqual(query.projection, ["field1", "field2"])
+
+    def test_projection_setter_multiple_calls(self):
+        _PROJECTION1 = ["field1", "field2"]
+        _PROJECTION2 = ["field3"]
+        query = self._make_one(self._make_client())
+        query.projection = _PROJECTION1
+        self.assertEqual(query.projection, _PROJECTION1)
+        query.projection = _PROJECTION2
+        self.assertEqual(query.projection, _PROJECTION2)
+
+    def test_keys_only(self):
+        query = self._make_one(self._make_client())
+        query.keys_only()
+        self.assertEqual(query.projection, ["__key__"])
+
+    def test_key_filter_defaults(self):
+        from google.cloud.datastore.key import Key
+
+        client = self._make_client()
+        query = self._make_one(client)
+        self.assertEqual(query.filters, [])
+        key = Key("Kind", 1234, project="project")
+        query.key_filter(key)
+        self.assertEqual(query.filters, [("__key__", "=", key)])
+
+    def test_key_filter_explicit(self):
+        from google.cloud.datastore.key import Key
+
+        client = self._make_client()
+        query = self._make_one(client)
+        self.assertEqual(query.filters, [])
+        key = Key("Kind", 1234, project="project")
+        query.key_filter(key, operator=">")
+        self.assertEqual(query.filters, [("__key__", ">", key)])
+
+    def test_order_setter_empty(self):
+        query = self._make_one(self._make_client(), order=["foo", "-bar"])
+        query.order = []
+        self.assertEqual(query.order, [])
+
+    def test_order_setter_string(self):
+        query = self._make_one(self._make_client())
+        query.order = "field"
+        self.assertEqual(query.order, ["field"])
+
+    def test_order_setter_single_item_list_desc(self):
+        query = self._make_one(self._make_client())
+        query.order = ["-field"]
+        self.assertEqual(query.order, ["-field"])
+
+    def test_order_setter_multiple(self):
+        query = self._make_one(self._make_client())
+        query.order = ["foo", "-bar"]
+        self.assertEqual(query.order, ["foo", "-bar"])
+
+    def test_distinct_on_setter_empty(self):
+        query = self._make_one(self._make_client(), distinct_on=["foo", "bar"])
+        query.distinct_on = []
+        self.assertEqual(query.distinct_on, [])
+
+    def test_distinct_on_setter_string(self):
+        query = self._make_one(self._make_client())
+        query.distinct_on = "field1"
+        self.assertEqual(query.distinct_on, ["field1"])
+
+    def test_distinct_on_setter_non_empty(self):
+        query = self._make_one(self._make_client())
+        query.distinct_on = ["field1", "field2"]
+        self.assertEqual(query.distinct_on, ["field1", "field2"])
+
+    def test_distinct_on_multiple_calls(self):
+        _DISTINCT_ON1 = ["field1", "field2"]
+        _DISTINCT_ON2 = ["field3"]
+        query = self._make_one(self._make_client())
+        query.distinct_on = _DISTINCT_ON1
+        self.assertEqual(query.distinct_on, _DISTINCT_ON1)
+        query.distinct_on = _DISTINCT_ON2
+        self.assertEqual(query.distinct_on, _DISTINCT_ON2)
+
+    def test_fetch_defaults_w_client_attr(self):
+        from google.cloud.datastore.query import Iterator
+
+        client = self._make_client()
+        query = self._make_one(client)
+        iterator = query.fetch()
+
+        self.assertIsInstance(iterator, Iterator)
+        self.assertIs(iterator._query, query)
+        self.assertIs(iterator.client, client)
+        self.assertIsNone(iterator.max_results)
+        self.assertEqual(iterator._offset, 0)
+
+    def test_fetch_w_explicit_client(self):
+        from google.cloud.datastore.query import Iterator
+
+        client = self._make_client()
+        other_client = self._make_client()
+        query = self._make_one(client)
+        iterator = query.fetch(limit=7, offset=8, client=other_client)
+        self.assertIsInstance(iterator, Iterator)
+        self.assertIs(iterator._query, query)
+        self.assertIs(iterator.client, other_client)
+        self.assertEqual(iterator.max_results, 7)
+        self.assertEqual(iterator._offset, 8)
+
+
+class TestIterator(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.query import Iterator
+
+        return Iterator
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        query = object()
+        client = object()
+        iterator = self._make_one(query, client)
+
+        self.assertFalse(iterator._started)
+        self.assertIs(iterator.client, client)
+        self.assertIsNone(iterator.max_results)
+        self.assertEqual(iterator.page_number, 0)
+        self.assertIsNone(iterator.next_page_token)
+        self.assertEqual(iterator.num_results, 0)
+        self.assertIs(iterator._query, query)
+        self.assertIsNone(iterator._offset)
+        self.assertIsNone(iterator._end_cursor)
+        self.assertTrue(iterator._more_results)
+
+    def test_constructor_explicit(self):
+        query = object()
+        client = object()
+        limit = 43
+        offset = 9
+        start_cursor = b"8290\xff"
+        end_cursor = b"so20rc\ta"
+        iterator = self._make_one(
+            query,
+            client,
+            limit=limit,
+            offset=offset,
+            start_cursor=start_cursor,
+            end_cursor=end_cursor,
+        )
+
+        self.assertFalse(iterator._started)
+        self.assertIs(iterator.client, client)
+        self.assertEqual(iterator.max_results, limit)
+        self.assertEqual(iterator.page_number, 0)
+        self.assertEqual(iterator.next_page_token, start_cursor)
+        self.assertEqual(iterator.num_results, 0)
+        self.assertIs(iterator._query, query)
+        self.assertEqual(iterator._offset, offset)
+        self.assertEqual(iterator._end_cursor, end_cursor)
+        self.assertTrue(iterator._more_results)
+
+    def test__build_protobuf_empty(self):
+        from google.cloud.datastore_v1.proto import query_pb2
+        from google.cloud.datastore.query import Query
+
+        client = _Client(None)
+        query = Query(client)
+        iterator = self._make_one(query, client)
+
+        pb = iterator._build_protobuf()
+        expected_pb = query_pb2.Query()
+        self.assertEqual(pb, expected_pb)
+
+    def test__build_protobuf_all_values_except_offset(self):
+        # this test and the following (all_values_except_start_and_end_cursor)
+        # test mutually exclusive states; the offset is ignored
+        # if a start_cursor is supplied
+        from google.cloud.datastore_v1.proto import query_pb2
+        from google.cloud.datastore.query import Query
+
+        client = _Client(None)
+        query = Query(client)
+        limit = 15
+        start_bytes = b"i\xb7\x1d"
+        start_cursor = "abcd"
+        end_bytes = b"\xc3\x1c\xb3"
+        end_cursor = "wxyz"
+        iterator = self._make_one(
+            query, client, limit=limit, start_cursor=start_cursor, end_cursor=end_cursor
+        )
+        self.assertEqual(iterator.max_results, limit)
+        iterator.num_results = 4
+        iterator._skipped_results = 1
+
+        pb = iterator._build_protobuf()
+        expected_pb = query_pb2.Query(start_cursor=start_bytes, end_cursor=end_bytes)
+        expected_pb.limit.value = limit - iterator.num_results
+        self.assertEqual(pb, expected_pb)
+
+    def test__build_protobuf_all_values_except_start_and_end_cursor(self):
+        # this test and the previous (all_values_except_start_offset)
+        # test mutually exclusive states; the offset is ignored
+        # if a start_cursor is supplied
+        from google.cloud.datastore_v1.proto import query_pb2
+        from google.cloud.datastore.query import Query
+
+        client = _Client(None)
+        query = Query(client)
+        limit = 15
+        offset = 9
+        iterator = self._make_one(query, client, limit=limit, offset=offset)
+        self.assertEqual(iterator.max_results, limit)
+        iterator.num_results = 4
+
+        pb = iterator._build_protobuf()
+        expected_pb = query_pb2.Query(offset=offset - iterator._skipped_results)
+        expected_pb.limit.value = limit - iterator.num_results
+        self.assertEqual(pb, expected_pb)
+
+    def test__process_query_results(self):
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        iterator = self._make_one(None, None, end_cursor="abcd")
+        self.assertIsNotNone(iterator._end_cursor)
+
+        entity_pbs = [_make_entity("Hello", 9998, "PRAHJEKT")]
+        cursor_as_bytes = b"\x9ai\xe7"
+        cursor = b"mmnn"
+        skipped_results = 4
+        more_results_enum = query_pb2.QueryResultBatch.NOT_FINISHED
+        response_pb = _make_query_response(
+            entity_pbs, cursor_as_bytes, more_results_enum, skipped_results
+        )
+        result = iterator._process_query_results(response_pb)
+        self.assertEqual(result, entity_pbs)
+
+        self.assertEqual(iterator._skipped_results, skipped_results)
+        self.assertEqual(iterator.next_page_token, cursor)
+        self.assertTrue(iterator._more_results)
+
+    def test__process_query_results_done(self):
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        iterator = self._make_one(None, None, end_cursor="abcd")
+        self.assertIsNotNone(iterator._end_cursor)
+
+        entity_pbs = [_make_entity("World", 1234, "PROJECT")]
+        cursor_as_bytes = b"\x9ai\xe7"
+        skipped_results = 44
+        more_results_enum = query_pb2.QueryResultBatch.NO_MORE_RESULTS
+        response_pb = _make_query_response(
+            entity_pbs, cursor_as_bytes, more_results_enum, skipped_results
+        )
+        result = iterator._process_query_results(response_pb)
+        self.assertEqual(result, entity_pbs)
+
+        self.assertEqual(iterator._skipped_results, skipped_results)
+        self.assertIsNone(iterator.next_page_token)
+        self.assertFalse(iterator._more_results)
+
+    def test__process_query_results_bad_enum(self):
+        iterator = self._make_one(None, None)
+        more_results_enum = 999
+        response_pb = _make_query_response([], b"", more_results_enum, 0)
+        with self.assertRaises(ValueError):
+            iterator._process_query_results(response_pb)
+
+    def _next_page_helper(self, txn_id=None):
+        from google.api_core import page_iterator
+        from google.cloud.datastore_v1.proto import datastore_pb2
+        from google.cloud.datastore_v1.proto import entity_pb2
+        from google.cloud.datastore_v1.proto import query_pb2
+        from google.cloud.datastore.query import Query
+
+        more_enum = query_pb2.QueryResultBatch.NOT_FINISHED
+        result = _make_query_response([], b"", more_enum, 0)
+        project = "prujekt"
+        ds_api = _make_datastore_api(result)
+        if txn_id is None:
+            client = _Client(project, datastore_api=ds_api)
+        else:
+            transaction = mock.Mock(id=txn_id, spec=["id"])
+            client = _Client(project, datastore_api=ds_api, transaction=transaction)
+
+        query = Query(client)
+        iterator = self._make_one(query, client)
+
+        page = iterator._next_page()
+        self.assertIsInstance(page, page_iterator.Page)
+        self.assertIs(page._parent, iterator)
+
+        partition_id = entity_pb2.PartitionId(project_id=project)
+        if txn_id is None:
+            read_options = datastore_pb2.ReadOptions()
+        else:
+            read_options = datastore_pb2.ReadOptions(transaction=txn_id)
+        empty_query = query_pb2.Query()
+        ds_api.run_query.assert_called_once_with(
+            project, partition_id, read_options, query=empty_query
+        )
+
+    def test__next_page(self):
+        self._next_page_helper()
+
+    def test__next_page_in_transaction(self):
+        txn_id = b"1xo1md\xe2\x98\x83"
+        self._next_page_helper(txn_id)
+
+    def test__next_page_no_more(self):
+        from google.cloud.datastore.query import Query
+
+        ds_api = _make_datastore_api()
+        client = _Client(None, datastore_api=ds_api)
+        query = Query(client)
+        iterator = self._make_one(query, client)
+        iterator._more_results = False
+
+        page = iterator._next_page()
+        self.assertIsNone(page)
+        ds_api.run_query.assert_not_called()
+
+
+class Test__item_to_entity(unittest.TestCase):
+    def _call_fut(self, iterator, entity_pb):
+        from google.cloud.datastore.query import _item_to_entity
+
+        return _item_to_entity(iterator, entity_pb)
+
+    def test_it(self):
+        entity_pb = mock.sentinel.entity_pb
+        patch = mock.patch("google.cloud.datastore.helpers.entity_from_protobuf")
+        with patch as entity_from_protobuf:
+            result = self._call_fut(None, entity_pb)
+            self.assertIs(result, entity_from_protobuf.return_value)
+
+        entity_from_protobuf.assert_called_once_with(entity_pb)
+
+
+class Test__pb_from_query(unittest.TestCase):
+    def _call_fut(self, query):
+        from google.cloud.datastore.query import _pb_from_query
+
+        return _pb_from_query(query)
+
+    def test_empty(self):
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        pb = self._call_fut(_Query())
+        self.assertEqual(list(pb.projection), [])
+        self.assertEqual(list(pb.kind), [])
+        self.assertEqual(list(pb.order), [])
+        self.assertEqual(list(pb.distinct_on), [])
+        self.assertEqual(pb.filter.property_filter.property.name, "")
+        cfilter = pb.filter.composite_filter
+        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.OPERATOR_UNSPECIFIED)
+        self.assertEqual(list(cfilter.filters), [])
+        self.assertEqual(pb.start_cursor, b"")
+        self.assertEqual(pb.end_cursor, b"")
+        self.assertEqual(pb.limit.value, 0)
+        self.assertEqual(pb.offset, 0)
+
+    def test_projection(self):
+        pb = self._call_fut(_Query(projection=["a", "b", "c"]))
+        self.assertEqual(
+            [item.property.name for item in pb.projection], ["a", "b", "c"]
+        )
+
+    def test_kind(self):
+        pb = self._call_fut(_Query(kind="KIND"))
+        self.assertEqual([item.name for item in pb.kind], ["KIND"])
+
+    def test_ancestor(self):
+        from google.cloud.datastore.key import Key
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        ancestor = Key("Ancestor", 123, project="PROJECT")
+        pb = self._call_fut(_Query(ancestor=ancestor))
+        cfilter = pb.filter.composite_filter
+        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.AND)
+        self.assertEqual(len(cfilter.filters), 1)
+        pfilter = cfilter.filters[0].property_filter
+        self.assertEqual(pfilter.property.name, "__key__")
+        ancestor_pb = ancestor.to_protobuf()
+        self.assertEqual(pfilter.value.key_value, ancestor_pb)
+
+    def test_filter(self):
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        query = _Query(filters=[("name", "=", u"John")])
+        query.OPERATORS = {"=": query_pb2.PropertyFilter.EQUAL}
+        pb = self._call_fut(query)
+        cfilter = pb.filter.composite_filter
+        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.AND)
+        self.assertEqual(len(cfilter.filters), 1)
+        pfilter = cfilter.filters[0].property_filter
+        self.assertEqual(pfilter.property.name, "name")
+        self.assertEqual(pfilter.value.string_value, u"John")
+
+    def test_filter_key(self):
+        from google.cloud.datastore.key import Key
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        key = Key("Kind", 123, project="PROJECT")
+        query = _Query(filters=[("__key__", "=", key)])
+        query.OPERATORS = {"=": query_pb2.PropertyFilter.EQUAL}
+        pb = self._call_fut(query)
+        cfilter = pb.filter.composite_filter
+        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.AND)
+        self.assertEqual(len(cfilter.filters), 1)
+        pfilter = cfilter.filters[0].property_filter
+        self.assertEqual(pfilter.property.name, "__key__")
+        key_pb = key.to_protobuf()
+        self.assertEqual(pfilter.value.key_value, key_pb)
+
+    def test_order(self):
+        from google.cloud.datastore_v1.proto import query_pb2
+
+        pb = self._call_fut(_Query(order=["a", "-b", "c"]))
+        self.assertEqual([item.property.name for item in pb.order], ["a", "b", "c"])
+        self.assertEqual(
+            [item.direction for item in pb.order],
+            [
+                query_pb2.PropertyOrder.ASCENDING,
+                query_pb2.PropertyOrder.DESCENDING,
+                query_pb2.PropertyOrder.ASCENDING,
+            ],
+        )
+
+    def test_distinct_on(self):
+        pb = self._call_fut(_Query(distinct_on=["a", "b", "c"]))
+        self.assertEqual([item.name for item in pb.distinct_on], ["a", "b", "c"])
+
+
+class _Query(object):
+    def __init__(
+        self,
+        client=object(),
+        kind=None,
+        project=None,
+        namespace=None,
+        ancestor=None,
+        filters=(),
+        projection=(),
+        order=(),
+        distinct_on=(),
+    ):
+        self._client = client
+        self.kind = kind
+        self.project = project
+        self.namespace = namespace
+        self.ancestor = ancestor
+        self.filters = filters
+        self.projection = projection
+        self.order = order
+        self.distinct_on = distinct_on
+
+
+class _Client(object):
+    def __init__(self, project, datastore_api=None, namespace=None, transaction=None):
+        self.project = project
+        self._datastore_api = datastore_api
+        self.namespace = namespace
+        self._transaction = transaction
+
+    @property
+    def current_transaction(self):
+        return self._transaction
+
+
+def _make_entity(kind, id_, project):
+    from google.cloud.datastore_v1.proto import entity_pb2
+
+    key = entity_pb2.Key()
+    key.partition_id.project_id = project
+    elem = key.path.add()
+    elem.kind = kind
+    elem.id = id_
+    return entity_pb2.Entity(key=key)
+
+
+def _make_query_response(
+    entity_pbs, cursor_as_bytes, more_results_enum, skipped_results
+):
+    from google.cloud.datastore_v1.proto import datastore_pb2
+    from google.cloud.datastore_v1.proto import query_pb2
+
+    return datastore_pb2.RunQueryResponse(
+        batch=query_pb2.QueryResultBatch(
+            skipped_results=skipped_results,
+            end_cursor=cursor_as_bytes,
+            more_results=more_results_enum,
+            entity_results=[
+                query_pb2.EntityResult(entity=entity) for entity in entity_pbs
+            ],
+        )
+    )
+
+
+def _make_datastore_api(result=None):
+    run_query = mock.Mock(return_value=result, spec=[])
+    return mock.Mock(run_query=run_query, spec=["run_query"])
diff --git a/datastore/tests/unit/test_transaction.py b/datastore/tests/unit/test_transaction.py
new file mode 100644
index 000000000000..a1e23610368a
--- /dev/null
+++ b/datastore/tests/unit/test_transaction.py
@@ -0,0 +1,317 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestTransaction(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.datastore.transaction import Transaction
+
+        return Transaction
+
+    def _get_options_class(self, **kw):
+        from google.cloud.datastore_v1.types import TransactionOptions
+
+        return TransactionOptions
+
+    def _make_one(self, client, **kw):
+        return self._get_target_class()(client, **kw)
+
+    def _make_options(self, **kw):
+        return self._get_options_class()(**kw)
+
+    def test_ctor_defaults(self):
+        project = "PROJECT"
+        client = _Client(project)
+        xact = self._make_one(client)
+        self.assertEqual(xact.project, project)
+        self.assertIs(xact._client, client)
+        self.assertIsNone(xact.id)
+        self.assertEqual(xact._status, self._get_target_class()._INITIAL)
+        self.assertEqual(xact._mutations, [])
+        self.assertEqual(len(xact._partial_key_entities), 0)
+
+    def test_current(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        id_ = 678
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact1 = self._make_one(client)
+        xact2 = self._make_one(client)
+        self.assertIsNone(xact1.current())
+        self.assertIsNone(xact2.current())
+        with xact1:
+            self.assertIs(xact1.current(), xact1)
+            self.assertIs(xact2.current(), xact1)
+            with _NoCommitBatch(client):
+                self.assertIsNone(xact1.current())
+                self.assertIsNone(xact2.current())
+            with xact2:
+                self.assertIs(xact1.current(), xact2)
+                self.assertIs(xact2.current(), xact2)
+                with _NoCommitBatch(client):
+                    self.assertIsNone(xact1.current())
+                    self.assertIsNone(xact2.current())
+            self.assertIs(xact1.current(), xact1)
+            self.assertIs(xact2.current(), xact1)
+        self.assertIsNone(xact1.current())
+        self.assertIsNone(xact2.current())
+
+        ds_api.rollback.assert_not_called()
+        commit_method = ds_api.commit
+        self.assertEqual(commit_method.call_count, 2)
+        mode = datastore_pb2.CommitRequest.TRANSACTIONAL
+        commit_method.assert_called_with(project, mode, [], transaction=id_)
+
+        begin_txn = ds_api.begin_transaction
+        self.assertEqual(begin_txn.call_count, 2)
+        begin_txn.assert_called_with(project)
+
+    def test_begin(self):
+        project = "PROJECT"
+        id_ = 889
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        xact.begin()
+        self.assertEqual(xact.id, id_)
+        ds_api.begin_transaction.assert_called_once_with(project)
+
+    def test_begin_tombstoned(self):
+        project = "PROJECT"
+        id_ = 1094
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        xact.begin()
+        self.assertEqual(xact.id, id_)
+        ds_api.begin_transaction.assert_called_once_with(project)
+
+        xact.rollback()
+        client._datastore_api.rollback.assert_called_once_with(project, id_)
+        self.assertIsNone(xact.id)
+
+        self.assertRaises(ValueError, xact.begin)
+
+    def test_begin_w_begin_transaction_failure(self):
+        project = "PROJECT"
+        id_ = 712
+        ds_api = _make_datastore_api(xact_id=id_)
+        ds_api.begin_transaction = mock.Mock(side_effect=RuntimeError, spec=[])
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+
+        with self.assertRaises(RuntimeError):
+            xact.begin()
+
+        self.assertIsNone(xact.id)
+        ds_api.begin_transaction.assert_called_once_with(project)
+
+    def test_rollback(self):
+        project = "PROJECT"
+        id_ = 239
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        xact.begin()
+        xact.rollback()
+        client._datastore_api.rollback.assert_called_once_with(project, id_)
+        self.assertIsNone(xact.id)
+        ds_api.begin_transaction.assert_called_once_with(project)
+
+    def test_commit_no_partial_keys(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        id_ = 1002930
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        xact.begin()
+        xact.commit()
+
+        mode = datastore_pb2.CommitRequest.TRANSACTIONAL
+        client._datastore_api.commit.assert_called_once_with(
+            project, mode, [], transaction=id_
+        )
+        self.assertIsNone(xact.id)
+        ds_api.begin_transaction.assert_called_once_with(project)
+
+    def test_commit_w_partial_keys(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        kind = "KIND"
+        id1 = 123
+        key = _make_key(kind, id1, project)
+        id2 = 234
+        ds_api = _make_datastore_api(key, xact_id=id2)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        xact.begin()
+        entity = _Entity()
+        xact.put(entity)
+        xact.commit()
+
+        mode = datastore_pb2.CommitRequest.TRANSACTIONAL
+        ds_api.commit.assert_called_once_with(
+            project, mode, xact.mutations, transaction=id2
+        )
+        self.assertIsNone(xact.id)
+        self.assertEqual(entity.key.path, [{"kind": kind, "id": id1}])
+        ds_api.begin_transaction.assert_called_once_with(project)
+
+    def test_context_manager_no_raise(self):
+        from google.cloud.datastore_v1.proto import datastore_pb2
+
+        project = "PROJECT"
+        id_ = 912830
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        with xact:
+            self.assertEqual(xact.id, id_)
+            ds_api.begin_transaction.assert_called_once_with(project)
+
+        mode = datastore_pb2.CommitRequest.TRANSACTIONAL
+        client._datastore_api.commit.assert_called_once_with(
+            project, mode, [], transaction=id_
+        )
+        self.assertIsNone(xact.id)
+        self.assertEqual(ds_api.begin_transaction.call_count, 1)
+
+    def test_context_manager_w_raise(self):
+        class Foo(Exception):
+            pass
+
+        project = "PROJECT"
+        id_ = 614416
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        xact = self._make_one(client)
+        xact._mutation = object()
+        try:
+            with xact:
+                self.assertEqual(xact.id, id_)
+                ds_api.begin_transaction.assert_called_once_with(project)
+                raise Foo()
+        except Foo:
+            self.assertIsNone(xact.id)
+            client._datastore_api.rollback.assert_called_once_with(project, id_)
+
+        client._datastore_api.commit.assert_not_called()
+        self.assertIsNone(xact.id)
+        self.assertEqual(ds_api.begin_transaction.call_count, 1)
+
+    def test_constructor_read_only(self):
+        project = "PROJECT"
+        id_ = 850302
+        ds_api = _make_datastore_api(xact=id_)
+        client = _Client(project, datastore_api=ds_api)
+        read_only = self._get_options_class().ReadOnly()
+        options = self._make_options(read_only=read_only)
+        xact = self._make_one(client, read_only=True)
+        self.assertEqual(xact._options, options)
+
+    def test_put_read_only(self):
+        project = "PROJECT"
+        id_ = 943243
+        ds_api = _make_datastore_api(xact_id=id_)
+        client = _Client(project, datastore_api=ds_api)
+        entity = _Entity()
+        xact = self._make_one(client, read_only=True)
+        xact.begin()
+        with self.assertRaises(RuntimeError):
+            xact.put(entity)
+
+
+def _make_key(kind, id_, project):
+    from google.cloud.datastore_v1.proto import entity_pb2
+
+    key = entity_pb2.Key()
+    key.partition_id.project_id = project
+    elem = key.path.add()
+    elem.kind = kind
+    elem.id = id_
+    return key
+
+
+class _Entity(dict):
+    def __init__(self):
+        super(_Entity, self).__init__()
+        from google.cloud.datastore.key import Key
+
+        self.key = Key("KIND", project="PROJECT")
+
+
+class _Client(object):
+    def __init__(self, project, datastore_api=None, namespace=None):
+        self.project = project
+        if datastore_api is None:
+            datastore_api = _make_datastore_api()
+        self._datastore_api = datastore_api
+        self.namespace = namespace
+        self._batches = []
+
+    def _push_batch(self, batch):
+        self._batches.insert(0, batch)
+
+    def _pop_batch(self):
+        return self._batches.pop(0)
+
+    @property
+    def current_batch(self):
+        return self._batches and self._batches[0] or None
+
+
+class _NoCommitBatch(object):
+    def __init__(self, client):
+        from google.cloud.datastore.batch import Batch
+
+        self._client = client
+        self._batch = Batch(client)
+
+    def __enter__(self):
+        self._client._push_batch(self._batch)
+        return self._batch
+
+    def __exit__(self, *args):
+        self._client._pop_batch()
+
+
+def _make_commit_response(*keys):
+    from google.cloud.datastore_v1.proto import datastore_pb2
+
+    mutation_results = [datastore_pb2.MutationResult(key=key) for key in keys]
+    return datastore_pb2.CommitResponse(mutation_results=mutation_results)
+
+
+def _make_datastore_api(*keys, **kwargs):
+    commit_method = mock.Mock(return_value=_make_commit_response(*keys), spec=[])
+
+    xact_id = kwargs.pop("xact_id", 123)
+    txn_pb = mock.Mock(transaction=xact_id, spec=["transaction"])
+    begin_txn = mock.Mock(return_value=txn_pb, spec=[])
+
+    return mock.Mock(
+        commit=commit_method,
+        begin_transaction=begin_txn,
+        spec=["begin_transaction", "commit", "rollback"],
+    )
diff --git a/dlp/.coveragerc b/dlp/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/dlp/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/dlp/.flake8 b/dlp/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/dlp/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/dlp/.repo-metadata.json b/dlp/.repo-metadata.json
new file mode 100644
index 000000000000..7aa7a207aade
--- /dev/null
+++ b/dlp/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "dlp",
+  "name_pretty": "Cloud Data Loss Prevention",
+  "product_documentation": "https://cloud.google.com/dlp/docs/",
+  "client_documentation": "https://googleapis.dev/python/dlp/latest",
+  "issue_tracker": "",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-dlp",
+  "api_id": "dlp.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/dlp/CHANGELOG.md b/dlp/CHANGELOG.md
new file mode 100644
index 000000000000..6da76c3ebe36
--- /dev/null
+++ b/dlp/CHANGELOG.md
@@ -0,0 +1,173 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-dlp/#history
+
+## 0.12.1
+
+07-24-2019 16:16 PDT
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Fix docs navigation issues. ([#8723](https://github.com/googleapis/google-cloud-python/pull/8723))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+## 0.12.0
+
+07-09-2019 13:20 PDT
+
+### New Features
+- Add support for publishing findings to GCS; deprecate 'DetectionRule' message (via synth). ([#8610](https://github.com/googleapis/google-cloud-python/pull/8610))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8507](https://github.com/googleapis/google-cloud-python/pull/8507))
+- Allow kwargs to be passed to create_channel; expose support for AVRO files (via synth). ([#8443](https://github.com/googleapis/google-cloud-python/pull/8443))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8581](https://github.com/googleapis/google-cloud-python/pull/8581))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Update docstrings, format protos, update noxfile (via synth).  ([#8239](https://github.com/googleapis/google-cloud-python/pull/8239))
+- Fix coverage in 'types.py' (via synth). ([#8153](https://github.com/googleapis/google-cloud-python/pull/8153))
+- Blacken noxfile.py, setup.py (via synth). ([#8121](https://github.com/googleapis/google-cloud-python/pull/8121))
+- Add empty lines (via synth). ([#8056](https://github.com/googleapis/google-cloud-python/pull/8056))
+- Add nox session `docs`, reorder methods (via synth). ([#7769](https://github.com/googleapis/google-cloud-python/pull/7769))
+
+## 0.11.0
+
+04-15-2019 15:05 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Remove unused message exports. ([#7267](https://github.com/googleapis/google-cloud-python/pull/7267))
+- Protoc-generated serialization update. ([#7081](https://github.com/googleapis/google-cloud-python/pull/7081))
+
+### New Features
+- Add support for filtering job triggers; add CryptoDeterministicConfig; update docs/conf.py. (via synth). ([#7390](https://github.com/googleapis/google-cloud-python/pull/7390))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+- Pick up stub docstring fix in GAPIC generator. ([#6969](https://github.com/googleapis/google-cloud-python/pull/6969))
+
+### Internal / Testing Changes
+- Copy in proto files. ([#7227](https://github.com/googleapis/google-cloud-python/pull/7227))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.10.0
+
+12-17-2018 18:07 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up enum fixes in the GAPIC generator. ([#6611](https://github.com/googleapis/google-cloud-python/pull/6611))
+- Pick up fixes in GAPIC generator. ([#6495](https://github.com/googleapis/google-cloud-python/pull/6495))
+- Fix `client_info` bug, update docstrings via synth. ([#6440](https://github.com/googleapis/google-cloud-python/pull/6440))
+- Assorted synth fixups / cleanups ([#6400](https://github.com/googleapis/google-cloud-python/pull/6400))
+
+### New Features
+- Add `BigQueryOptions.excluded_fields`. ([#6312](https://github.com/googleapis/google-cloud-python/pull/6312))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Pick up docstring fix via synth. ([#6874](https://github.com/googleapis/google-cloud-python/pull/6874))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6565](https://github.com/googleapis/google-cloud-python/pull/6565))
+
+## 0.9.0
+
+10-18-2018 10:44 PDT
+
+### New Features
+
+- Added `stored_info_type` methods to v2. ([#6221](https://github.com/googleapis/google-cloud-python/pull/6221))
+
+### Documentation
+
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+
+### Internal / Testing Changes
+
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Avoid replacing/scribbling on 'setup.py' during synth. ([#6125](https://github.com/googleapis/google-cloud-python/pull/6125))
+
+## 0.8.0
+
+### New Features
+- Add support for exclude findings. ([#6091](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6091))
+- Add support for stored info type support. ([#5950](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5950))
+
+### Documentation
+- Fix docs issue in DLP generation. ([#5668](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5668), [#5815](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5815))
+- Docs: Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5901))
+
+## 0.7.0
+
+### New Features
+- Add StoredInfoTypes (#5809)
+
+## 0.6.0
+
+### New Features
+- Regenerate DLP v2 endpoint (redact image, delta presence) (#5666)
+
+### Internal / Testing Changes
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+
+## 0.5.0
+
+### New Features
+- Add PublishSummaryToCscc (#5246)
+- Add configurable row limit (#5246)
+- Add EntityID added to risk stats (#5246)
+- Add dictionaries via GCS (#5246)
+
+## 0.4.0
+
+### Implementation Changes
+
+- Remove DLP client version V2Beta1 (#5155)
+
+## 0.3.0
+
+### Implementation changes
+
+- The library has been regenerated to pick up changes from the API's proto definition. (#5131)
+
+## 0.2.0
+
+### Interface additions
+
+- Add DLP v2 (#5059)
+
+## 0.1.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Normalize all setup.py files (#4909)
+
+## 0.1.0
+
+Initial release of the DLP (Data Loss Prevention) client library. (#4879)
+
+
diff --git a/dlp/LICENSE b/dlp/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/dlp/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/dlp/MANIFEST.in b/dlp/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/dlp/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/dlp/README.rst b/dlp/README.rst
new file mode 100644
index 000000000000..4c33c0cdeba3
--- /dev/null
+++ b/dlp/README.rst
@@ -0,0 +1,111 @@
+Python Client for Cloud Data Loss Prevention (DLP) API
+======================================================
+
+|alpha| |pypi| |versions| 
+
+`Cloud Data Loss Prevention (DLP) API`_: Provides methods for detection, risk analysis, and de-identification of
+privacy-sensitive fragments in text, images, and Google Cloud Platform
+storage repositories.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-dlp.svg
+   :target: https://pypi.org/project/google-cloud-dlp/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-dlp.svg
+   :target: https://pypi.org/project/google-cloud-dlp/
+.. _Cloud Data Loss Prevention (DLP) API: https://cloud.google.com/dlp
+.. _Client Library Documentation: https://googleapis.dev/python/dlp/latest
+.. _Product Documentation:  https://cloud.google.com/dlp
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Data Loss Prevention (DLP) API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Data Loss Prevention (DLP) API.:  https://cloud.google.com/dlp
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-dlp
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-dlp
+
+Preview
+~~~~~~~
+
+DlpServiceClient
+^^^^^^^^^^^^^^^^
+
+.. code:: py
+
+    from google.cloud import dlp_v2
+
+    client = dlp_v2.DlpServiceClient()
+
+    name = 'EMAIL_ADDRESS'
+    info_types_element = {'name': name}
+    info_types = [info_types_element]
+    inspect_config = {'info_types': info_types}
+    type_ = 'text/plain'
+    value = 'My email is example@example.com.'
+    items_element = {'type': type_, 'value': value}
+    items = [items_element]
+
+    response = client.inspect_content(inspect_config, items)
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Data Loss Prevention
+   (DLP) API to see other available methods on the client.
+-  Read the `Product documentation`_ to
+   learn more about the product and see How-to Guides.
diff --git a/dlp/docs/README.rst b/dlp/docs/README.rst
new file mode 120000
index 000000000000..44473becd35c
--- /dev/null
+++ b/dlp/docs/README.rst
@@ -0,0 +1 @@
+../../dlp/README.rst
\ No newline at end of file
diff --git a/dlp/docs/changelog.md b/dlp/docs/changelog.md
new file mode 120000
index 000000000000..f4979b74fd50
--- /dev/null
+++ b/dlp/docs/changelog.md
@@ -0,0 +1 @@
+../../dlp/CHANGELOG.md
\ No newline at end of file
diff --git a/dlp/docs/conf.py b/dlp/docs/conf.py
new file mode 100644
index 000000000000..1385e6dd16f7
--- /dev/null
+++ b/dlp/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-dlp documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-dlp"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-dlp-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-dlp.tex",
+        u"google-cloud-dlp Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-dlp", u"google-cloud-dlp Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-dlp",
+        u"google-cloud-dlp Documentation",
+        author,
+        "google-cloud-dlp",
+        "GAPIC library for the {metadata.shortName} v2 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/dlp/docs/gapic/v2/api.rst b/dlp/docs/gapic/v2/api.rst
new file mode 100644
index 000000000000..2e6e3f989229
--- /dev/null
+++ b/dlp/docs/gapic/v2/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Data Loss Prevention (DLP) API
+===============================================
+
+.. automodule:: google.cloud.dlp_v2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/dlp/docs/gapic/v2/types.rst b/dlp/docs/gapic/v2/types.rst
new file mode 100644
index 000000000000..3c8e8e79b180
--- /dev/null
+++ b/dlp/docs/gapic/v2/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Data Loss Prevention (DLP) API Client
+=====================================================
+
+.. automodule:: google.cloud.dlp_v2.types
+    :members:
\ No newline at end of file
diff --git a/dlp/docs/index.rst b/dlp/docs/index.rst
new file mode 100644
index 000000000000..ac9eaec1ba32
--- /dev/null
+++ b/dlp/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v2/api
+    gapic/v2/types
+    changelog
+
+Changelog
+---------
+
+For a list of all ``google-cloud-dlp`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/dlp/google/__init__.py b/dlp/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/dlp/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/dlp/google/cloud/__init__.py b/dlp/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/dlp/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/dlp/google/cloud/dlp.py b/dlp/google/cloud/dlp.py
new file mode 100644
index 000000000000..3fe2b696107c
--- /dev/null
+++ b/dlp/google/cloud/dlp.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.dlp_v2 import DlpServiceClient
+from google.cloud.dlp_v2 import enums
+from google.cloud.dlp_v2 import types
+
+
+__all__ = ("enums", "types", "DlpServiceClient")
diff --git a/dlp/google/cloud/dlp_v2/__init__.py b/dlp/google/cloud/dlp_v2/__init__.py
new file mode 100644
index 000000000000..b1e8b05ef8eb
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.dlp_v2 import types
+from google.cloud.dlp_v2.gapic import dlp_service_client
+from google.cloud.dlp_v2.gapic import enums
+
+
+class DlpServiceClient(dlp_service_client.DlpServiceClient):
+    __doc__ = dlp_service_client.DlpServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DlpServiceClient")
diff --git a/dlp/google/cloud/dlp_v2/gapic/__init__.py b/dlp/google/cloud/dlp_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dlp/google/cloud/dlp_v2/gapic/dlp_service_client.py b/dlp/google/cloud/dlp_v2/gapic/dlp_service_client.py
new file mode 100644
index 000000000000..d44f76ef23c7
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/gapic/dlp_service_client.py
@@ -0,0 +1,2993 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.privacy.dlp.v2 DlpService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.dlp_v2.gapic import dlp_service_client_config
+from google.cloud.dlp_v2.gapic import enums
+from google.cloud.dlp_v2.gapic.transports import dlp_service_grpc_transport
+from google.cloud.dlp_v2.proto import dlp_pb2
+from google.cloud.dlp_v2.proto import dlp_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-dlp").version
+
+
+class DlpServiceClient(object):
+    """
+    The Cloud Data Loss Prevention (DLP) API is a service that allows clients
+    to detect the presence of Personally Identifiable Information (PII) and other
+    privacy-sensitive data in user-supplied, unstructured data streams, like text
+    blocks or images.
+    The service also includes methods for sensitive data redaction and
+    scheduling of data scans on Google Cloud Platform based data sets.
+
+    To learn more about concepts and find how-to guides see
+    https://cloud.google.com/dlp/docs/.
+    """
+
+    SERVICE_ADDRESS = "dlp.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.privacy.dlp.v2.DlpService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DlpServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def dlp_job_path(cls, project, dlp_job):
+        """Return a fully-qualified dlp_job string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/dlpJobs/{dlp_job}", project=project, dlp_job=dlp_job
+        )
+
+    @classmethod
+    def organization_path(cls, organization):
+        """Return a fully-qualified organization string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}", organization=organization
+        )
+
+    @classmethod
+    def organization_deidentify_template_path(cls, organization, deidentify_template):
+        """Return a fully-qualified organization_deidentify_template string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/deidentifyTemplates/{deidentify_template}",
+            organization=organization,
+            deidentify_template=deidentify_template,
+        )
+
+    @classmethod
+    def organization_inspect_template_path(cls, organization, inspect_template):
+        """Return a fully-qualified organization_inspect_template string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/inspectTemplates/{inspect_template}",
+            organization=organization,
+            inspect_template=inspect_template,
+        )
+
+    @classmethod
+    def organization_stored_info_type_path(cls, organization, stored_info_type):
+        """Return a fully-qualified organization_stored_info_type string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/storedInfoTypes/{stored_info_type}",
+            organization=organization,
+            stored_info_type=stored_info_type,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def project_deidentify_template_path(cls, project, deidentify_template):
+        """Return a fully-qualified project_deidentify_template string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/deidentifyTemplates/{deidentify_template}",
+            project=project,
+            deidentify_template=deidentify_template,
+        )
+
+    @classmethod
+    def project_inspect_template_path(cls, project, inspect_template):
+        """Return a fully-qualified project_inspect_template string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/inspectTemplates/{inspect_template}",
+            project=project,
+            inspect_template=inspect_template,
+        )
+
+    @classmethod
+    def project_job_trigger_path(cls, project, job_trigger):
+        """Return a fully-qualified project_job_trigger string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/jobTriggers/{job_trigger}",
+            project=project,
+            job_trigger=job_trigger,
+        )
+
+    @classmethod
+    def project_stored_info_type_path(cls, project, stored_info_type):
+        """Return a fully-qualified project_stored_info_type string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/storedInfoTypes/{stored_info_type}",
+            project=project,
+            stored_info_type=stored_info_type,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DlpServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DlpServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = dlp_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=dlp_service_grpc_transport.DlpServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = dlp_service_grpc_transport.DlpServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def inspect_content(
+        self,
+        parent,
+        inspect_config=None,
+        item=None,
+        inspect_template_name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Finds potentially sensitive info in content.
+        This method has limits on input size, processing time, and output size.
+
+        When no InfoTypes or CustomInfoTypes are specified in this request, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images
+        and https://cloud.google.com/dlp/docs/inspecting-text,
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.inspect_content(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id.
+            inspect_config (Union[dict, ~google.cloud.dlp_v2.types.InspectConfig]): Configuration for the inspector. What specified here will override the
+                template referenced by the inspect\_template\_name argument.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectConfig`
+            item (Union[dict, ~google.cloud.dlp_v2.types.ContentItem]): The item to inspect.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.ContentItem`
+            inspect_template_name (str): Optional 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.InspectContentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "inspect_content" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "inspect_content"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.inspect_content,
+                default_retry=self._method_configs["InspectContent"].retry,
+                default_timeout=self._method_configs["InspectContent"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.InspectContentRequest(
+            parent=parent,
+            inspect_config=inspect_config,
+            item=item,
+            inspect_template_name=inspect_template_name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["inspect_content"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def redact_image(
+        self,
+        parent,
+        inspect_config=None,
+        image_redaction_configs=None,
+        include_findings=None,
+        byte_item=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Redacts potentially sensitive info from an image.
+        This method has limits on input size, processing time, and output size.
+        See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to
+        learn more.
+
+        When no InfoTypes or CustomInfoTypes are specified in this request, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.redact_image(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id.
+            inspect_config (Union[dict, ~google.cloud.dlp_v2.types.InspectConfig]): Configuration for the inspector.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectConfig`
+            image_redaction_configs (list[Union[dict, ~google.cloud.dlp_v2.types.ImageRedactionConfig]]): The configuration for specifying what content to redact from images.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.ImageRedactionConfig`
+            include_findings (bool): Whether the response should include findings along with the redacted
+                image.
+            byte_item (Union[dict, ~google.cloud.dlp_v2.types.ByteContentItem]): The content must be PNG, JPEG, SVG or BMP.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.ByteContentItem`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.RedactImageResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "redact_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "redact_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.redact_image,
+                default_retry=self._method_configs["RedactImage"].retry,
+                default_timeout=self._method_configs["RedactImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.RedactImageRequest(
+            parent=parent,
+            inspect_config=inspect_config,
+            image_redaction_configs=image_redaction_configs,
+            include_findings=include_findings,
+            byte_item=byte_item,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["redact_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def deidentify_content(
+        self,
+        parent,
+        deidentify_config=None,
+        inspect_config=None,
+        item=None,
+        inspect_template_name=None,
+        deidentify_template_name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        De-identifies potentially sensitive info from a ContentItem.
+        This method has limits on input size and output size.
+        See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to
+        learn more.
+
+        When no InfoTypes or CustomInfoTypes are specified in this request, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.deidentify_content(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id.
+            deidentify_config (Union[dict, ~google.cloud.dlp_v2.types.DeidentifyConfig]): Configuration for the de-identification of the content item. Items
+                specified here will override the template referenced by the
+                deidentify\_template\_name argument.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.DeidentifyConfig`
+            inspect_config (Union[dict, ~google.cloud.dlp_v2.types.InspectConfig]): Configuration for the inspector. Items specified here will override the
+                template referenced by the inspect\_template\_name argument.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectConfig`
+            item (Union[dict, ~google.cloud.dlp_v2.types.ContentItem]): The item to de-identify. Will be treated as text.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.ContentItem`
+            inspect_template_name (str): Optional 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.
+            deidentify_template_name (str): Optional 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.DeidentifyContentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "deidentify_content" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "deidentify_content"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.deidentify_content,
+                default_retry=self._method_configs["DeidentifyContent"].retry,
+                default_timeout=self._method_configs["DeidentifyContent"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.DeidentifyContentRequest(
+            parent=parent,
+            deidentify_config=deidentify_config,
+            inspect_config=inspect_config,
+            item=item,
+            inspect_template_name=inspect_template_name,
+            deidentify_template_name=deidentify_template_name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["deidentify_content"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def reidentify_content(
+        self,
+        parent,
+        reidentify_config=None,
+        inspect_config=None,
+        item=None,
+        inspect_template_name=None,
+        reidentify_template_name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Re-identifies content that has been de-identified. See
+        https://cloud.google.com/dlp/docs/pseudonymization#re-identification\_in\_free\_text\_code\_example
+        to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.reidentify_content(parent)
+
+        Args:
+            parent (str): The parent resource name.
+            reidentify_config (Union[dict, ~google.cloud.dlp_v2.types.DeidentifyConfig]): Configuration for the re-identification of the content item. This field
+                shares the same proto message type that is used for de-identification,
+                however its usage here is for the reversal of the previous
+                de-identification. Re-identification is performed by examining the
+                transformations used to de-identify the items and executing the reverse.
+                This requires that only reversible transformations be provided here. The
+                reversible transformations are:
+
+                -  ``CryptoReplaceFfxFpeConfig``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.DeidentifyConfig`
+            inspect_config (Union[dict, ~google.cloud.dlp_v2.types.InspectConfig]): Configuration for the inspector.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectConfig`
+            item (Union[dict, ~google.cloud.dlp_v2.types.ContentItem]): The item to re-identify. Will be treated as text.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.ContentItem`
+            inspect_template_name (str): Optional 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.
+            reidentify_template_name (str): Optional 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.ReidentifyContentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "reidentify_content" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "reidentify_content"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.reidentify_content,
+                default_retry=self._method_configs["ReidentifyContent"].retry,
+                default_timeout=self._method_configs["ReidentifyContent"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ReidentifyContentRequest(
+            parent=parent,
+            reidentify_config=reidentify_config,
+            inspect_config=inspect_config,
+            item=item,
+            inspect_template_name=inspect_template_name,
+            reidentify_template_name=reidentify_template_name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["reidentify_content"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_info_types(
+        self,
+        language_code=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of the sensitive information types that the DLP API
+        supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
+        learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> response = client.list_info_types()
+
+        Args:
+            language_code (str): Optional BCP-47 language code for localized infoType friendly
+                names. If omitted, or if localized strings are not available,
+                en-US strings will be returned.
+            filter_ (str): Optional filter to only return infoTypes supported by certain parts of
+                the API. Defaults to supported\_by=INSPECT.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.ListInfoTypesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_info_types" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_info_types"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_info_types,
+                default_retry=self._method_configs["ListInfoTypes"].retry,
+                default_timeout=self._method_configs["ListInfoTypes"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ListInfoTypesRequest(
+            language_code=language_code, filter=filter_
+        )
+        return self._inner_api_calls["list_info_types"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_inspect_template(
+        self,
+        parent,
+        inspect_template=None,
+        template_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an InspectTemplate for re-using frequently used configuration
+        for inspecting content, images, and storage.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.create_inspect_template(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id or
+                organizations/my-org-id.
+            inspect_template (Union[dict, ~google.cloud.dlp_v2.types.InspectTemplate]): The InspectTemplate to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectTemplate`
+            template_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.InspectTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_inspect_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_inspect_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_inspect_template,
+                default_retry=self._method_configs["CreateInspectTemplate"].retry,
+                default_timeout=self._method_configs["CreateInspectTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.CreateInspectTemplateRequest(
+            parent=parent, inspect_template=inspect_template, template_id=template_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_inspect_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_inspect_template(
+        self,
+        name,
+        inspect_template=None,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the InspectTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_inspect_template_path('[ORGANIZATION]', '[INSPECT_TEMPLATE]')
+            >>>
+            >>> response = client.update_inspect_template(name)
+
+        Args:
+            name (str): Resource name of organization and inspectTemplate to be updated, for
+                example ``organizations/433245324/inspectTemplates/432452342`` or
+                projects/project-id/inspectTemplates/432452342.
+            inspect_template (Union[dict, ~google.cloud.dlp_v2.types.InspectTemplate]): New InspectTemplate value.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectTemplate`
+            update_mask (Union[dict, ~google.cloud.dlp_v2.types.FieldMask]): Mask to control which fields get updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.InspectTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_inspect_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_inspect_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_inspect_template,
+                default_retry=self._method_configs["UpdateInspectTemplate"].retry,
+                default_timeout=self._method_configs["UpdateInspectTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.UpdateInspectTemplateRequest(
+            name=name, inspect_template=inspect_template, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_inspect_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_inspect_template(
+        self,
+        name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets an InspectTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> response = client.get_inspect_template()
+
+        Args:
+            name (str): Resource name of the organization and inspectTemplate to be read, for
+                example ``organizations/433245324/inspectTemplates/432452342`` or
+                projects/project-id/inspectTemplates/432452342.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.InspectTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_inspect_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_inspect_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_inspect_template,
+                default_retry=self._method_configs["GetInspectTemplate"].retry,
+                default_timeout=self._method_configs["GetInspectTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.GetInspectTemplateRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_inspect_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_inspect_templates(
+        self,
+        parent,
+        page_size=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists InspectTemplates.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_inspect_templates(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_inspect_templates(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id or
+                organizations/my-org-id.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Optional 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.
+
+                Example: ``name asc,update_time, create_time desc``
+
+                Supported fields are:
+
+                -  ``create_time``: corresponds to time the template was created.
+                -  ``update_time``: corresponds to time the template was last updated.
+                -  ``name``: corresponds to template's name.
+                -  ``display_name``: corresponds to template's display name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dlp_v2.types.InspectTemplate` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_inspect_templates" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_inspect_templates"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_inspect_templates,
+                default_retry=self._method_configs["ListInspectTemplates"].retry,
+                default_timeout=self._method_configs["ListInspectTemplates"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ListInspectTemplatesRequest(
+            parent=parent, page_size=page_size, order_by=order_by
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_inspect_templates"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="inspect_templates",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_inspect_template(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an InspectTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_inspect_template_path('[ORGANIZATION]', '[INSPECT_TEMPLATE]')
+            >>>
+            >>> client.delete_inspect_template(name)
+
+        Args:
+            name (str): Resource name of the organization and inspectTemplate to be deleted, for
+                example ``organizations/433245324/inspectTemplates/432452342`` or
+                projects/project-id/inspectTemplates/432452342.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_inspect_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_inspect_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_inspect_template,
+                default_retry=self._method_configs["DeleteInspectTemplate"].retry,
+                default_timeout=self._method_configs["DeleteInspectTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.DeleteInspectTemplateRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_inspect_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_deidentify_template(
+        self,
+        parent,
+        deidentify_template=None,
+        template_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a DeidentifyTemplate for re-using frequently used configuration
+        for de-identifying content, images, and storage.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.create_deidentify_template(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id or
+                organizations/my-org-id.
+            deidentify_template (Union[dict, ~google.cloud.dlp_v2.types.DeidentifyTemplate]): The DeidentifyTemplate to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate`
+            template_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_deidentify_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_deidentify_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_deidentify_template,
+                default_retry=self._method_configs["CreateDeidentifyTemplate"].retry,
+                default_timeout=self._method_configs[
+                    "CreateDeidentifyTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.CreateDeidentifyTemplateRequest(
+            parent=parent,
+            deidentify_template=deidentify_template,
+            template_id=template_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_deidentify_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_deidentify_template(
+        self,
+        name,
+        deidentify_template=None,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the DeidentifyTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_deidentify_template_path('[ORGANIZATION]', '[DEIDENTIFY_TEMPLATE]')
+            >>>
+            >>> response = client.update_deidentify_template(name)
+
+        Args:
+            name (str): Resource name of organization and deidentify template to be updated, for
+                example ``organizations/433245324/deidentifyTemplates/432452342`` or
+                projects/project-id/deidentifyTemplates/432452342.
+            deidentify_template (Union[dict, ~google.cloud.dlp_v2.types.DeidentifyTemplate]): New DeidentifyTemplate value.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate`
+            update_mask (Union[dict, ~google.cloud.dlp_v2.types.FieldMask]): Mask to control which fields get updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_deidentify_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_deidentify_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_deidentify_template,
+                default_retry=self._method_configs["UpdateDeidentifyTemplate"].retry,
+                default_timeout=self._method_configs[
+                    "UpdateDeidentifyTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.UpdateDeidentifyTemplateRequest(
+            name=name, deidentify_template=deidentify_template, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_deidentify_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_deidentify_template(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a DeidentifyTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_deidentify_template_path('[ORGANIZATION]', '[DEIDENTIFY_TEMPLATE]')
+            >>>
+            >>> response = client.get_deidentify_template(name)
+
+        Args:
+            name (str): Resource name of the organization and deidentify template to be read,
+                for example ``organizations/433245324/deidentifyTemplates/432452342`` or
+                projects/project-id/deidentifyTemplates/432452342.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_deidentify_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_deidentify_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_deidentify_template,
+                default_retry=self._method_configs["GetDeidentifyTemplate"].retry,
+                default_timeout=self._method_configs["GetDeidentifyTemplate"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.GetDeidentifyTemplateRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_deidentify_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_deidentify_templates(
+        self,
+        parent,
+        page_size=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists DeidentifyTemplates.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_deidentify_templates(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_deidentify_templates(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id or
+                organizations/my-org-id.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Optional 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.
+
+                Example: ``name asc,update_time, create_time desc``
+
+                Supported fields are:
+
+                -  ``create_time``: corresponds to time the template was created.
+                -  ``update_time``: corresponds to time the template was last updated.
+                -  ``name``: corresponds to template's name.
+                -  ``display_name``: corresponds to template's display name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_deidentify_templates" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_deidentify_templates"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_deidentify_templates,
+                default_retry=self._method_configs["ListDeidentifyTemplates"].retry,
+                default_timeout=self._method_configs["ListDeidentifyTemplates"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ListDeidentifyTemplatesRequest(
+            parent=parent, page_size=page_size, order_by=order_by
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_deidentify_templates"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="deidentify_templates",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_deidentify_template(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a DeidentifyTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_deidentify_template_path('[ORGANIZATION]', '[DEIDENTIFY_TEMPLATE]')
+            >>>
+            >>> client.delete_deidentify_template(name)
+
+        Args:
+            name (str): Resource name of the organization and deidentify template to be deleted,
+                for example ``organizations/433245324/deidentifyTemplates/432452342`` or
+                projects/project-id/deidentifyTemplates/432452342.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_deidentify_template" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_deidentify_template"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_deidentify_template,
+                default_retry=self._method_configs["DeleteDeidentifyTemplate"].retry,
+                default_timeout=self._method_configs[
+                    "DeleteDeidentifyTemplate"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.DeleteDeidentifyTemplateRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_deidentify_template"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_dlp_job(
+        self,
+        parent,
+        inspect_job=None,
+        risk_job=None,
+        job_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new job to inspect storage or calculate risk metrics.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.create_dlp_job(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id.
+            inspect_job (Union[dict, ~google.cloud.dlp_v2.types.InspectJobConfig]):
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.InspectJobConfig`
+            risk_job (Union[dict, ~google.cloud.dlp_v2.types.RiskAnalysisJobConfig]):
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.RiskAnalysisJobConfig`
+            job_id (str): The job 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.DlpJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_dlp_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_dlp_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_dlp_job,
+                default_retry=self._method_configs["CreateDlpJob"].retry,
+                default_timeout=self._method_configs["CreateDlpJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            inspect_job=inspect_job, risk_job=risk_job
+        )
+
+        request = dlp_pb2.CreateDlpJobRequest(
+            parent=parent, inspect_job=inspect_job, risk_job=risk_job, job_id=job_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_dlp_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_dlp_jobs(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        type_=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists DlpJobs that match the specified filter in the request.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_dlp_jobs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_dlp_jobs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id.
+            filter_ (str): Optional. 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 ``<field> <operator> <value>``.
+                -  Supported fields/values for inspect jobs:
+
+                   -  ``state`` - PENDING\|RUNNING\|CANCELED\|FINISHED\|FAILED
+                   -  ``inspected_storage`` - DATASTORE\|CLOUD\_STORAGE\|BIGQUERY
+                   -  ``trigger_name`` - The resource name of the trigger that created
+                      job.
+                   -  'end\_time\` - Corresponds to time the job finished.
+                   -  'start\_time\` - Corresponds to time the job finished.
+
+                -  Supported fields for risk analysis jobs:
+
+                   -  ``state`` - RUNNING\|CANCELED\|FINISHED\|FAILED
+                   -  'end\_time\` - Corresponds to time the job finished.
+                   -  'start\_time\` - Corresponds to time the job finished.
+
+                -  The operator must be ``=`` or ``!=``.
+
+                Examples:
+
+                -  inspected\_storage = cloud\_storage AND state = done
+                -  inspected\_storage = cloud\_storage OR inspected\_storage = bigquery
+                -  inspected\_storage = cloud\_storage AND (state = done OR state =
+                   canceled)
+                -  end\_time > "2017-12-12T00:00:00+00:00"
+
+                The length of this field should be no more than 500 characters.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            type_ (~google.cloud.dlp_v2.types.DlpJobType): The type of job. Defaults to ``DlpJobType.INSPECT``
+            order_by (str): Optional 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.
+
+                Example: ``name asc, end_time asc, create_time desc``
+
+                Supported fields are:
+
+                -  ``create_time``: corresponds to time the job was created.
+                -  ``end_time``: corresponds to time the job ended.
+                -  ``name``: corresponds to job's name.
+                -  ``state``: corresponds to ``state``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dlp_v2.types.DlpJob` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_dlp_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_dlp_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_dlp_jobs,
+                default_retry=self._method_configs["ListDlpJobs"].retry,
+                default_timeout=self._method_configs["ListDlpJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ListDlpJobsRequest(
+            parent=parent,
+            filter=filter_,
+            page_size=page_size,
+            type=type_,
+            order_by=order_by,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_dlp_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_dlp_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the latest state of a long-running DlpJob.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.dlp_job_path('[PROJECT]', '[DLP_JOB]')
+            >>>
+            >>> response = client.get_dlp_job(name)
+
+        Args:
+            name (str): The name of the DlpJob resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.DlpJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_dlp_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_dlp_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_dlp_job,
+                default_retry=self._method_configs["GetDlpJob"].retry,
+                default_timeout=self._method_configs["GetDlpJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.GetDlpJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_dlp_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_dlp_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a long-running DlpJob. This method indicates that the client is
+        no longer interested in the DlpJob result. The job will be cancelled if
+        possible.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.dlp_job_path('[PROJECT]', '[DLP_JOB]')
+            >>>
+            >>> client.delete_dlp_job(name)
+
+        Args:
+            name (str): The name of the DlpJob resource to be deleted.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_dlp_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_dlp_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_dlp_job,
+                default_retry=self._method_configs["DeleteDlpJob"].retry,
+                default_timeout=self._method_configs["DeleteDlpJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.DeleteDlpJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_dlp_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_dlp_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts asynchronous cancellation on a long-running DlpJob. The server
+        makes a best effort to cancel the DlpJob, but success is not
+        guaranteed.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.dlp_job_path('[PROJECT]', '[DLP_JOB]')
+            >>>
+            >>> client.cancel_dlp_job(name)
+
+        Args:
+            name (str): The name of the DlpJob resource to be cancelled.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_dlp_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_dlp_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_dlp_job,
+                default_retry=self._method_configs["CancelDlpJob"].retry,
+                default_timeout=self._method_configs["CancelDlpJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.CancelDlpJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["cancel_dlp_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_job_triggers(
+        self,
+        parent,
+        page_size=None,
+        order_by=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists job triggers.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_job_triggers(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_job_triggers(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The parent resource name, for example ``projects/my-project-id``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Optional 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.
+
+                Example: ``name asc,update_time, create_time desc``
+
+                Supported fields are:
+
+                -  ``create_time``: corresponds to time the JobTrigger was created.
+                -  ``update_time``: corresponds to time the JobTrigger was last updated.
+                -  ``last_run_time``: corresponds to the last time the JobTrigger ran.
+                -  ``name``: corresponds to JobTrigger's name.
+                -  ``display_name``: corresponds to JobTrigger's display name.
+                -  ``status``: corresponds to JobTrigger's status.
+            filter_ (str): Optional. 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 ``<field> <operator> <value>``.
+                -  Supported fields/values for inspect jobs:
+
+                   -  ``status`` - HEALTHY\|PAUSED\|CANCELLED
+                   -  ``inspected_storage`` - DATASTORE\|CLOUD\_STORAGE\|BIGQUERY
+                   -  'last\_run\_time\` - RFC 3339 formatted timestamp, surrounded by
+                      quotation marks. Nanoseconds are ignored.
+                   -  'error\_count' - Number of errors that have occurred while
+                      running.
+
+                -  The operator must be ``=`` or ``!=`` for status and
+                   inspected\_storage.
+
+                Examples:
+
+                -  inspected\_storage = cloud\_storage AND status = HEALTHY
+                -  inspected\_storage = cloud\_storage OR inspected\_storage = bigquery
+                -  inspected\_storage = cloud\_storage AND (state = PAUSED OR state =
+                   HEALTHY)
+                -  last\_run\_time > "2017-12-12T00:00:00+00:00"
+
+                The length of this field should be no more than 500 characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dlp_v2.types.JobTrigger` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_job_triggers" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_job_triggers"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_job_triggers,
+                default_retry=self._method_configs["ListJobTriggers"].retry,
+                default_timeout=self._method_configs["ListJobTriggers"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ListJobTriggersRequest(
+            parent=parent, page_size=page_size, order_by=order_by, filter=filter_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_job_triggers"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="job_triggers",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_job_trigger(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a job trigger.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.project_job_trigger_path('[PROJECT]', '[JOB_TRIGGER]')
+            >>>
+            >>> response = client.get_job_trigger(name)
+
+        Args:
+            name (str): Resource name of the project and the triggeredJob, for example
+                ``projects/dlp-test-project/jobTriggers/53234423``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.JobTrigger` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_job_trigger" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_job_trigger"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_job_trigger,
+                default_retry=self._method_configs["GetJobTrigger"].retry,
+                default_timeout=self._method_configs["GetJobTrigger"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.GetJobTriggerRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_job_trigger"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_job_trigger(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a job trigger.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> # TODO: Initialize `name`:
+            >>> name = ''
+            >>>
+            >>> client.delete_job_trigger(name)
+
+        Args:
+            name (str): Resource name of the project and the triggeredJob, for example
+                ``projects/dlp-test-project/jobTriggers/53234423``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_job_trigger" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_job_trigger"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_job_trigger,
+                default_retry=self._method_configs["DeleteJobTrigger"].retry,
+                default_timeout=self._method_configs["DeleteJobTrigger"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.DeleteJobTriggerRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_job_trigger"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_job_trigger(
+        self,
+        name,
+        job_trigger=None,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a job trigger.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.project_job_trigger_path('[PROJECT]', '[JOB_TRIGGER]')
+            >>>
+            >>> response = client.update_job_trigger(name)
+
+        Args:
+            name (str): Resource name of the project and the triggeredJob, for example
+                ``projects/dlp-test-project/jobTriggers/53234423``.
+            job_trigger (Union[dict, ~google.cloud.dlp_v2.types.JobTrigger]): New JobTrigger value.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.JobTrigger`
+            update_mask (Union[dict, ~google.cloud.dlp_v2.types.FieldMask]): Mask to control which fields get updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.JobTrigger` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_job_trigger" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_job_trigger"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_job_trigger,
+                default_retry=self._method_configs["UpdateJobTrigger"].retry,
+                default_timeout=self._method_configs["UpdateJobTrigger"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.UpdateJobTriggerRequest(
+            name=name, job_trigger=job_trigger, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_job_trigger"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_job_trigger(
+        self,
+        parent,
+        job_trigger=None,
+        trigger_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a job trigger to run DLP actions such as scanning storage for
+        sensitive information on a set schedule.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.create_job_trigger(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id.
+            job_trigger (Union[dict, ~google.cloud.dlp_v2.types.JobTrigger]): The JobTrigger to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.JobTrigger`
+            trigger_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.JobTrigger` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_job_trigger" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_job_trigger"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_job_trigger,
+                default_retry=self._method_configs["CreateJobTrigger"].retry,
+                default_timeout=self._method_configs["CreateJobTrigger"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.CreateJobTriggerRequest(
+            parent=parent, job_trigger=job_trigger, trigger_id=trigger_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_job_trigger"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_stored_info_type(
+        self,
+        parent,
+        config=None,
+        stored_info_type_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a pre-built stored infoType to be used for inspection.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.create_stored_info_type(parent)
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id or
+                organizations/my-org-id.
+            config (Union[dict, ~google.cloud.dlp_v2.types.StoredInfoTypeConfig]): Configuration of the storedInfoType to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.StoredInfoTypeConfig`
+            stored_info_type_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.StoredInfoType` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_stored_info_type" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_stored_info_type"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_stored_info_type,
+                default_retry=self._method_configs["CreateStoredInfoType"].retry,
+                default_timeout=self._method_configs["CreateStoredInfoType"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.CreateStoredInfoTypeRequest(
+            parent=parent, config=config, stored_info_type_id=stored_info_type_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_stored_info_type"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_stored_info_type(
+        self,
+        name,
+        config=None,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the stored infoType by creating a new version. The existing version
+        will continue to be used until the new version is ready.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_stored_info_type_path('[ORGANIZATION]', '[STORED_INFO_TYPE]')
+            >>>
+            >>> response = client.update_stored_info_type(name)
+
+        Args:
+            name (str): Resource name of organization and storedInfoType to be updated, for
+                example ``organizations/433245324/storedInfoTypes/432452342`` or
+                projects/project-id/storedInfoTypes/432452342.
+            config (Union[dict, ~google.cloud.dlp_v2.types.StoredInfoTypeConfig]): Updated configuration for the storedInfoType. If not provided, a new
+                version of the storedInfoType will be created with the existing
+                configuration.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.StoredInfoTypeConfig`
+            update_mask (Union[dict, ~google.cloud.dlp_v2.types.FieldMask]): Mask to control which fields get updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.dlp_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.StoredInfoType` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_stored_info_type" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_stored_info_type"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_stored_info_type,
+                default_retry=self._method_configs["UpdateStoredInfoType"].retry,
+                default_timeout=self._method_configs["UpdateStoredInfoType"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.UpdateStoredInfoTypeRequest(
+            name=name, config=config, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_stored_info_type"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_stored_info_type(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a stored infoType.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_stored_info_type_path('[ORGANIZATION]', '[STORED_INFO_TYPE]')
+            >>>
+            >>> response = client.get_stored_info_type(name)
+
+        Args:
+            name (str): Resource name of the organization and storedInfoType to be read, for
+                example ``organizations/433245324/storedInfoTypes/432452342`` or
+                projects/project-id/storedInfoTypes/432452342.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.dlp_v2.types.StoredInfoType` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_stored_info_type" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_stored_info_type"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_stored_info_type,
+                default_retry=self._method_configs["GetStoredInfoType"].retry,
+                default_timeout=self._method_configs["GetStoredInfoType"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.GetStoredInfoTypeRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_stored_info_type"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_stored_info_types(
+        self,
+        parent,
+        page_size=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists stored infoTypes.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_stored_info_types(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_stored_info_types(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The parent resource name, for example projects/my-project-id or
+                organizations/my-org-id.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Optional 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.
+
+                Example: ``name asc, display_name, create_time desc``
+
+                Supported fields are:
+
+                -  ``create_time``: corresponds to time the most recent version of the
+                     resource was created.
+                -  ``state``: corresponds to the state of the resource.
+                -  ``name``: corresponds to resource name.
+                -  ``display_name``: corresponds to info type's display name.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.dlp_v2.types.StoredInfoType` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_stored_info_types" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_stored_info_types"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_stored_info_types,
+                default_retry=self._method_configs["ListStoredInfoTypes"].retry,
+                default_timeout=self._method_configs["ListStoredInfoTypes"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.ListStoredInfoTypesRequest(
+            parent=parent, page_size=page_size, order_by=order_by
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_stored_info_types"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="stored_info_types",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_stored_info_type(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a stored infoType.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Example:
+            >>> from google.cloud import dlp_v2
+            >>>
+            >>> client = dlp_v2.DlpServiceClient()
+            >>>
+            >>> name = client.organization_stored_info_type_path('[ORGANIZATION]', '[STORED_INFO_TYPE]')
+            >>>
+            >>> client.delete_stored_info_type(name)
+
+        Args:
+            name (str): Resource name of the organization and storedInfoType to be deleted, for
+                example ``organizations/433245324/storedInfoTypes/432452342`` or
+                projects/project-id/storedInfoTypes/432452342.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_stored_info_type" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_stored_info_type"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_stored_info_type,
+                default_retry=self._method_configs["DeleteStoredInfoType"].retry,
+                default_timeout=self._method_configs["DeleteStoredInfoType"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = dlp_pb2.DeleteStoredInfoTypeRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_stored_info_type"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/dlp/google/cloud/dlp_v2/gapic/dlp_service_client_config.py b/dlp/google/cloud/dlp_v2/gapic/dlp_service_client_config.py
new file mode 100644
index 000000000000..c0034706ad9d
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/gapic/dlp_service_client_config.py
@@ -0,0 +1,173 @@
+config = {
+    "interfaces": {
+        "google.privacy.dlp.v2.DlpService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "InspectContent": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RedactImage": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeidentifyContent": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ReidentifyContent": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListInfoTypes": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateInspectTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateInspectTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetInspectTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListInspectTemplates": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteInspectTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateDeidentifyTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDeidentifyTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDeidentifyTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDeidentifyTemplates": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDeidentifyTemplate": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateDlpJob": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDlpJobs": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDlpJob": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDlpJob": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelDlpJob": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListJobTriggers": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetJobTrigger": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteJobTrigger": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateJobTrigger": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateJobTrigger": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateStoredInfoType": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateStoredInfoType": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetStoredInfoType": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListStoredInfoTypes": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteStoredInfoType": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/dlp/google/cloud/dlp_v2/gapic/enums.py b/dlp/google/cloud/dlp_v2/gapic/enums.py
new file mode 100644
index 000000000000..915b5acc088a
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/gapic/enums.py
@@ -0,0 +1,446 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ContentOption(enum.IntEnum):
+    """
+    Options describing which parts of the provided content should be scanned.
+
+    Attributes:
+      CONTENT_UNSPECIFIED (int): Includes entire content of a file or a data stream.
+      CONTENT_TEXT (int): Text content within the data, excluding any metadata.
+      CONTENT_IMAGE (int): Images found in the data.
+    """
+
+    CONTENT_UNSPECIFIED = 0
+    CONTENT_TEXT = 1
+    CONTENT_IMAGE = 2
+
+
+class DayOfWeek(enum.IntEnum):
+    """
+    Represents a day of week.
+
+    Attributes:
+      DAY_OF_WEEK_UNSPECIFIED (int): The unspecified day-of-week.
+      MONDAY (int): The day-of-week of Monday.
+      TUESDAY (int): The day-of-week of Tuesday.
+      WEDNESDAY (int): The day-of-week of Wednesday.
+      THURSDAY (int): The day-of-week of Thursday.
+      FRIDAY (int): The day-of-week of Friday.
+      SATURDAY (int): The day-of-week of Saturday.
+      SUNDAY (int): The day-of-week of Sunday.
+    """
+
+    DAY_OF_WEEK_UNSPECIFIED = 0
+    MONDAY = 1
+    TUESDAY = 2
+    WEDNESDAY = 3
+    THURSDAY = 4
+    FRIDAY = 5
+    SATURDAY = 6
+    SUNDAY = 7
+
+
+class DlpJobType(enum.IntEnum):
+    """
+    An enum to represent the various type of DLP jobs.
+
+    Attributes:
+      DLP_JOB_TYPE_UNSPECIFIED (int)
+      INSPECT_JOB (int): The job inspected Google Cloud for sensitive data.
+      RISK_ANALYSIS_JOB (int): The job executed a Risk Analysis computation.
+    """
+
+    DLP_JOB_TYPE_UNSPECIFIED = 0
+    INSPECT_JOB = 1
+    RISK_ANALYSIS_JOB = 2
+
+
+class FileType(enum.IntEnum):
+    """
+    Definitions of file type groups to scan.
+
+    Attributes:
+      FILE_TYPE_UNSPECIFIED (int): Includes all files.
+      BINARY_FILE (int): Includes all file extensions not covered by text file types.
+      TEXT_FILE (int): Included file extensions:
+        asc, brf, c, cc, cpp, csv, cxx, c++, cs, css, dart, eml, go, h, hh, hpp,
+        hxx, h++, hs, html, htm, shtml, shtm, xhtml, lhs, ini, java, js, json,
+        ocaml, md, mkd, markdown, m, ml, mli, pl, pm, php, phtml, pht, py, pyw,
+        rb, rbw, rs, rc, scala, sh, sql, tex, txt, text, tsv, vcard, vcs, wml,
+        xml, xsl, xsd, yml, yaml.
+      IMAGE (int): Included file extensions: bmp, gif, jpg, jpeg, jpe, png.
+      bytes\_limit\_per\_file has no effect on image files.
+      AVRO (int): Included file extensions:
+        avro
+    """
+
+    FILE_TYPE_UNSPECIFIED = 0
+    BINARY_FILE = 1
+    TEXT_FILE = 2
+    IMAGE = 3
+    AVRO = 7
+
+
+class InfoTypeSupportedBy(enum.IntEnum):
+    """
+    Parts of the APIs which use certain infoTypes.
+
+    Attributes:
+      ENUM_TYPE_UNSPECIFIED (int)
+      INSPECT (int): Supported by the inspect operations.
+      RISK_ANALYSIS (int): Supported by the risk analysis operations.
+    """
+
+    ENUM_TYPE_UNSPECIFIED = 0
+    INSPECT = 1
+    RISK_ANALYSIS = 2
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Categorization of results based on how likely they are to represent a match,
+    based on the number of elements they contain which imply a match.
+
+    Attributes:
+      LIKELIHOOD_UNSPECIFIED (int): Default value; same as POSSIBLE.
+      VERY_UNLIKELY (int): Few matching elements.
+      UNLIKELY (int)
+      POSSIBLE (int): Some matching elements.
+      LIKELY (int)
+      VERY_LIKELY (int): Many matching elements.
+    """
+
+    LIKELIHOOD_UNSPECIFIED = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class MatchingType(enum.IntEnum):
+    """
+    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.
+
+    Attributes:
+      MATCHING_TYPE_UNSPECIFIED (int): Invalid.
+      MATCHING_TYPE_FULL_MATCH (int): 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_PARTIAL_MATCH (int): 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_INVERSE_MATCH (int): 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_UNSPECIFIED = 0
+    MATCHING_TYPE_FULL_MATCH = 1
+    MATCHING_TYPE_PARTIAL_MATCH = 2
+    MATCHING_TYPE_INVERSE_MATCH = 3
+
+
+class RelationalOperator(enum.IntEnum):
+    """
+    Operators available for comparing the value of fields.
+
+    Attributes:
+      RELATIONAL_OPERATOR_UNSPECIFIED (int)
+      EQUAL_TO (int): Equal. Attempts to match even with incompatible types.
+      NOT_EQUAL_TO (int): Not equal to. Attempts to match even with incompatible types.
+      GREATER_THAN (int): Greater than.
+      LESS_THAN (int): Less than.
+      GREATER_THAN_OR_EQUALS (int): Greater than or equals.
+      LESS_THAN_OR_EQUALS (int): Less than or equals.
+      EXISTS (int): Exists
+    """
+
+    RELATIONAL_OPERATOR_UNSPECIFIED = 0
+    EQUAL_TO = 1
+    NOT_EQUAL_TO = 2
+    GREATER_THAN = 3
+    LESS_THAN = 4
+    GREATER_THAN_OR_EQUALS = 5
+    LESS_THAN_OR_EQUALS = 6
+    EXISTS = 7
+
+
+class StoredInfoTypeState(enum.IntEnum):
+    """
+    State of a StoredInfoType version.
+
+    Attributes:
+      STORED_INFO_TYPE_STATE_UNSPECIFIED (int)
+      PENDING (int): StoredInfoType version is being created.
+      READY (int): StoredInfoType version is ready for use.
+      FAILED (int): StoredInfoType creation failed. All relevant error messages are returned
+      in the ``StoredInfoTypeVersion`` message.
+      INVALID (int): StoredInfoType is no longer valid because artifacts stored in
+      user-controlled storage were modified. To fix an invalid StoredInfoType,
+      use the ``UpdateStoredInfoType`` method to create a new version.
+    """
+
+    STORED_INFO_TYPE_STATE_UNSPECIFIED = 0
+    PENDING = 1
+    READY = 2
+    FAILED = 3
+    INVALID = 4
+
+
+class BigQueryOptions(object):
+    class SampleMethod(enum.IntEnum):
+        """
+        How to sample rows if not all rows are scanned. Meaningful only when
+        used in conjunction with either rows\_limit or rows\_limit\_percent. If
+        not specified, scanning would start from the top.
+
+        Attributes:
+          SAMPLE_METHOD_UNSPECIFIED (int)
+          TOP (int): Scan from the top (default).
+          RANDOM_START (int): Randomly pick the row to start scanning. The scanned rows are contiguous.
+        """
+
+        SAMPLE_METHOD_UNSPECIFIED = 0
+        TOP = 1
+        RANDOM_START = 2
+
+
+class ByteContentItem(object):
+    class BytesType(enum.IntEnum):
+        """
+        Attributes:
+          BYTES_TYPE_UNSPECIFIED (int)
+          IMAGE (int)
+          IMAGE_JPEG (int)
+          IMAGE_BMP (int)
+          IMAGE_PNG (int)
+          IMAGE_SVG (int)
+          TEXT_UTF8 (int)
+          AVRO (int)
+        """
+
+        BYTES_TYPE_UNSPECIFIED = 0
+        IMAGE = 6
+        IMAGE_JPEG = 1
+        IMAGE_BMP = 2
+        IMAGE_PNG = 3
+        IMAGE_SVG = 4
+        TEXT_UTF8 = 5
+        AVRO = 11
+
+
+class CharsToIgnore(object):
+    class CommonCharsToIgnore(enum.IntEnum):
+        """
+        Attributes:
+          COMMON_CHARS_TO_IGNORE_UNSPECIFIED (int)
+          NUMERIC (int): 0-9
+          ALPHA_UPPER_CASE (int): A-Z
+          ALPHA_LOWER_CASE (int): a-z
+          PUNCTUATION (int): US Punctuation, one of !"#$%&'()\*+,-./:;<=>?@[]^\_\`{\|}~
+          WHITESPACE (int): Whitespace character
+        """
+
+        COMMON_CHARS_TO_IGNORE_UNSPECIFIED = 0
+        NUMERIC = 1
+        ALPHA_UPPER_CASE = 2
+        ALPHA_LOWER_CASE = 3
+        PUNCTUATION = 4
+        WHITESPACE = 5
+
+
+class CloudStorageOptions(object):
+    class SampleMethod(enum.IntEnum):
+        """
+        How to sample bytes if not all bytes are scanned. Meaningful only when
+        used in conjunction with bytes\_limit\_per\_file. If not specified,
+        scanning would start from the top.
+
+        Attributes:
+          SAMPLE_METHOD_UNSPECIFIED (int)
+          TOP (int): Scan from the top (default).
+          RANDOM_START (int): For each file larger than bytes\_limit\_per\_file, randomly pick the
+          offset to start scanning. The scanned bytes are contiguous.
+        """
+
+        SAMPLE_METHOD_UNSPECIFIED = 0
+        TOP = 1
+        RANDOM_START = 2
+
+
+class CryptoReplaceFfxFpeConfig(object):
+    class FfxCommonNativeAlphabet(enum.IntEnum):
+        """
+        These are commonly used subsets of the alphabet that the FFX mode
+        natively supports. In the algorithm, the alphabet is selected using
+        the "radix". Therefore each corresponds to particular radix.
+
+        Attributes:
+          FFX_COMMON_NATIVE_ALPHABET_UNSPECIFIED (int)
+          NUMERIC (int): [0-9] (radix of 10)
+          HEXADECIMAL (int): [0-9A-F] (radix of 16)
+          UPPER_CASE_ALPHA_NUMERIC (int): [0-9A-Z] (radix of 36)
+          ALPHA_NUMERIC (int): [0-9A-Za-z] (radix of 62)
+        """
+
+        FFX_COMMON_NATIVE_ALPHABET_UNSPECIFIED = 0
+        NUMERIC = 1
+        HEXADECIMAL = 2
+        UPPER_CASE_ALPHA_NUMERIC = 3
+        ALPHA_NUMERIC = 4
+
+
+class CustomInfoType(object):
+    class ExclusionType(enum.IntEnum):
+        """
+        Attributes:
+          EXCLUSION_TYPE_UNSPECIFIED (int): A finding of this custom info type will not be excluded from results.
+          EXCLUSION_TYPE_EXCLUDE (int): A finding of this custom info type will be excluded from final results,
+          but can still affect rule execution.
+        """
+
+        EXCLUSION_TYPE_UNSPECIFIED = 0
+        EXCLUSION_TYPE_EXCLUDE = 1
+
+
+class DlpJob(object):
+    class JobState(enum.IntEnum):
+        """
+        Attributes:
+          JOB_STATE_UNSPECIFIED (int)
+          PENDING (int): The job has not yet started.
+          RUNNING (int): The job is currently running.
+          DONE (int): The job is no longer running.
+          CANCELED (int): The job was canceled before it could complete.
+          FAILED (int): The job had an error and did not complete.
+        """
+
+        JOB_STATE_UNSPECIFIED = 0
+        PENDING = 1
+        RUNNING = 2
+        DONE = 3
+        CANCELED = 4
+        FAILED = 5
+
+
+class JobTrigger(object):
+    class Status(enum.IntEnum):
+        """
+        Whether the trigger is currently active. If PAUSED or CANCELLED, no jobs
+        will be created with this configuration. The service may automatically
+        pause triggers experiencing frequent errors. To restart a job, set the
+        status to HEALTHY after correcting user errors.
+
+        Attributes:
+          STATUS_UNSPECIFIED (int)
+          HEALTHY (int): Trigger is healthy.
+          PAUSED (int): Trigger is temporarily paused.
+          CANCELLED (int): Trigger is cancelled and can not be resumed.
+        """
+
+        STATUS_UNSPECIFIED = 0
+        HEALTHY = 1
+        PAUSED = 2
+        CANCELLED = 3
+
+
+class OutputStorageConfig(object):
+    class OutputSchema(enum.IntEnum):
+        """
+        Predefined schemas for storing findings.
+
+        Attributes:
+          OUTPUT_SCHEMA_UNSPECIFIED (int)
+          BASIC_COLUMNS (int): Basic schema including only ``info_type``, ``quote``, ``certainty``, and
+          ``timestamp``.
+          GCS_COLUMNS (int): Schema tailored to findings from scanning Google Cloud Storage.
+          DATASTORE_COLUMNS (int): Schema tailored to findings from scanning Google Datastore.
+          BIG_QUERY_COLUMNS (int): Schema tailored to findings from scanning Google BigQuery.
+          ALL_COLUMNS (int): Schema containing all columns.
+        """
+
+        OUTPUT_SCHEMA_UNSPECIFIED = 0
+        BASIC_COLUMNS = 1
+        GCS_COLUMNS = 2
+        DATASTORE_COLUMNS = 3
+        BIG_QUERY_COLUMNS = 4
+        ALL_COLUMNS = 5
+
+
+class RecordCondition(object):
+    class Expressions(object):
+        class LogicalOperator(enum.IntEnum):
+            """
+            Attributes:
+              LOGICAL_OPERATOR_UNSPECIFIED (int)
+              AND (int)
+            """
+
+            LOGICAL_OPERATOR_UNSPECIFIED = 0
+            AND = 1
+
+
+class TimePartConfig(object):
+    class TimePart(enum.IntEnum):
+        """
+        Attributes:
+          TIME_PART_UNSPECIFIED (int)
+          YEAR (int): [0-9999]
+          MONTH (int): [1-12]
+          DAY_OF_MONTH (int): [1-31]
+          DAY_OF_WEEK (int): [1-7]
+          WEEK_OF_YEAR (int): [1-52]
+          HOUR_OF_DAY (int): [0-23]
+        """
+
+        TIME_PART_UNSPECIFIED = 0
+        YEAR = 1
+        MONTH = 2
+        DAY_OF_MONTH = 3
+        DAY_OF_WEEK = 4
+        WEEK_OF_YEAR = 5
+        HOUR_OF_DAY = 6
+
+
+class TransformationSummary(object):
+    class TransformationResultCode(enum.IntEnum):
+        """
+        Possible outcomes of transformations.
+
+        Attributes:
+          TRANSFORMATION_RESULT_CODE_UNSPECIFIED (int)
+          SUCCESS (int)
+          ERROR (int)
+        """
+
+        TRANSFORMATION_RESULT_CODE_UNSPECIFIED = 0
+        SUCCESS = 1
+        ERROR = 2
diff --git a/dlp/google/cloud/dlp_v2/gapic/transports/__init__.py b/dlp/google/cloud/dlp_v2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dlp/google/cloud/dlp_v2/gapic/transports/dlp_service_grpc_transport.py b/dlp/google/cloud/dlp_v2/gapic/transports/dlp_service_grpc_transport.py
new file mode 100644
index 000000000000..ad5e2e8d4957
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/gapic/transports/dlp_service_grpc_transport.py
@@ -0,0 +1,574 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.dlp_v2.proto import dlp_pb2_grpc
+
+
+class DlpServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.privacy.dlp.v2 DlpService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="dlp.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"dlp_service_stub": dlp_pb2_grpc.DlpServiceStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="dlp.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def inspect_content(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.inspect_content`.
+
+        Finds potentially sensitive info in content.
+        This method has limits on input size, processing time, and output size.
+
+        When no InfoTypes or CustomInfoTypes are specified in this request, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images
+        and https://cloud.google.com/dlp/docs/inspecting-text,
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].InspectContent
+
+    @property
+    def redact_image(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.redact_image`.
+
+        Redacts potentially sensitive info from an image.
+        This method has limits on input size, processing time, and output size.
+        See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to
+        learn more.
+
+        When no InfoTypes or CustomInfoTypes are specified in this request, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].RedactImage
+
+    @property
+    def deidentify_content(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.deidentify_content`.
+
+        De-identifies potentially sensitive info from a ContentItem.
+        This method has limits on input size and output size.
+        See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to
+        learn more.
+
+        When no InfoTypes or CustomInfoTypes are specified in this request, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].DeidentifyContent
+
+    @property
+    def reidentify_content(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.reidentify_content`.
+
+        Re-identifies content that has been de-identified. See
+        https://cloud.google.com/dlp/docs/pseudonymization#re-identification\_in\_free\_text\_code\_example
+        to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ReidentifyContent
+
+    @property
+    def list_info_types(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.list_info_types`.
+
+        Returns a list of the sensitive information types that the DLP API
+        supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
+        learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ListInfoTypes
+
+    @property
+    def create_inspect_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.create_inspect_template`.
+
+        Creates an InspectTemplate for re-using frequently used configuration
+        for inspecting content, images, and storage.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].CreateInspectTemplate
+
+    @property
+    def update_inspect_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.update_inspect_template`.
+
+        Updates the InspectTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].UpdateInspectTemplate
+
+    @property
+    def get_inspect_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.get_inspect_template`.
+
+        Gets an InspectTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].GetInspectTemplate
+
+    @property
+    def list_inspect_templates(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.list_inspect_templates`.
+
+        Lists InspectTemplates.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ListInspectTemplates
+
+    @property
+    def delete_inspect_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.delete_inspect_template`.
+
+        Deletes an InspectTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].DeleteInspectTemplate
+
+    @property
+    def create_deidentify_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.create_deidentify_template`.
+
+        Creates a DeidentifyTemplate for re-using frequently used configuration
+        for de-identifying content, images, and storage.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].CreateDeidentifyTemplate
+
+    @property
+    def update_deidentify_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.update_deidentify_template`.
+
+        Updates the DeidentifyTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].UpdateDeidentifyTemplate
+
+    @property
+    def get_deidentify_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.get_deidentify_template`.
+
+        Gets a DeidentifyTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].GetDeidentifyTemplate
+
+    @property
+    def list_deidentify_templates(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.list_deidentify_templates`.
+
+        Lists DeidentifyTemplates.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ListDeidentifyTemplates
+
+    @property
+    def delete_deidentify_template(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.delete_deidentify_template`.
+
+        Deletes a DeidentifyTemplate.
+        See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+        more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].DeleteDeidentifyTemplate
+
+    @property
+    def create_dlp_job(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.create_dlp_job`.
+
+        Creates a new job to inspect storage or calculate risk metrics.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the
+        system will automatically choose what detectors to run. By default this may
+        be all types, but may change over time as detectors are updated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].CreateDlpJob
+
+    @property
+    def list_dlp_jobs(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.list_dlp_jobs`.
+
+        Lists DlpJobs that match the specified filter in the request.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ListDlpJobs
+
+    @property
+    def get_dlp_job(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.get_dlp_job`.
+
+        Gets the latest state of a long-running DlpJob.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].GetDlpJob
+
+    @property
+    def delete_dlp_job(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.delete_dlp_job`.
+
+        Deletes a long-running DlpJob. This method indicates that the client is
+        no longer interested in the DlpJob result. The job will be cancelled if
+        possible.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].DeleteDlpJob
+
+    @property
+    def cancel_dlp_job(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.cancel_dlp_job`.
+
+        Starts asynchronous cancellation on a long-running DlpJob. The server
+        makes a best effort to cancel the DlpJob, but success is not
+        guaranteed.
+        See https://cloud.google.com/dlp/docs/inspecting-storage and
+        https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].CancelDlpJob
+
+    @property
+    def list_job_triggers(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.list_job_triggers`.
+
+        Lists job triggers.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ListJobTriggers
+
+    @property
+    def get_job_trigger(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.get_job_trigger`.
+
+        Gets a job trigger.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].GetJobTrigger
+
+    @property
+    def delete_job_trigger(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.delete_job_trigger`.
+
+        Deletes a job trigger.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].DeleteJobTrigger
+
+    @property
+    def update_job_trigger(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.update_job_trigger`.
+
+        Updates a job trigger.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].UpdateJobTrigger
+
+    @property
+    def create_job_trigger(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.create_job_trigger`.
+
+        Creates a job trigger to run DLP actions such as scanning storage for
+        sensitive information on a set schedule.
+        See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].CreateJobTrigger
+
+    @property
+    def create_stored_info_type(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.create_stored_info_type`.
+
+        Creates a pre-built stored infoType to be used for inspection.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].CreateStoredInfoType
+
+    @property
+    def update_stored_info_type(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.update_stored_info_type`.
+
+        Updates the stored infoType by creating a new version. The existing version
+        will continue to be used until the new version is ready.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].UpdateStoredInfoType
+
+    @property
+    def get_stored_info_type(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.get_stored_info_type`.
+
+        Gets a stored infoType.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].GetStoredInfoType
+
+    @property
+    def list_stored_info_types(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.list_stored_info_types`.
+
+        Lists stored infoTypes.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].ListStoredInfoTypes
+
+    @property
+    def delete_stored_info_type(self):
+        """Return the gRPC stub for :meth:`DlpServiceClient.delete_stored_info_type`.
+
+        Deletes a stored infoType.
+        See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+        learn more.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["dlp_service_stub"].DeleteStoredInfoType
diff --git a/dlp/google/cloud/dlp_v2/proto/__init__.py b/dlp/google/cloud/dlp_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dlp/google/cloud/dlp_v2/proto/dlp.proto b/dlp/google/cloud/dlp_v2/proto/dlp.proto
new file mode 100644
index 000000000000..b138c3b59b0d
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/proto/dlp.proto
@@ -0,0 +1,3228 @@
+// 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.privacy.dlp.v2;
+
+import "google/api/annotations.proto";
+import "google/privacy/dlp/v2/storage.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";
+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";
+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";
+
+// The Cloud Data Loss Prevention (DLP) API is a service that allows clients
+// to detect the presence of Personally Identifiable Information (PII) and other
+// privacy-sensitive data in user-supplied, unstructured data streams, like text
+// blocks or images.
+// The service also includes methods for sensitive data redaction and
+// scheduling of data scans on Google Cloud Platform based data sets.
+//
+// To learn more about concepts and find how-to guides see
+// https://cloud.google.com/dlp/docs/.
+service DlpService {
+  option (google.api.default_host) = "dlp.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Finds potentially sensitive info in content.
+  // This method has limits on input size, processing time, and output size.
+  //
+  // When no InfoTypes or CustomInfoTypes are specified in this request, the
+  // system will automatically choose what detectors to run. By default this may
+  // be all types, but may change over time as detectors are updated.
+  //
+  // For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images
+  // and https://cloud.google.com/dlp/docs/inspecting-text,
+  rpc InspectContent(InspectContentRequest) returns (InspectContentResponse) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/content:inspect"
+      body: "*"
+    };
+  }
+
+  // Redacts potentially sensitive info from an image.
+  // This method has limits on input size, processing time, and output size.
+  // See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to
+  // learn more.
+  //
+  // When no InfoTypes or CustomInfoTypes are specified in this request, the
+  // system will automatically choose what detectors to run. By default this may
+  // be all types, but may change over time as detectors are updated.
+  rpc RedactImage(RedactImageRequest) returns (RedactImageResponse) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/image:redact"
+      body: "*"
+    };
+  }
+
+  // De-identifies potentially sensitive info from a ContentItem.
+  // This method has limits on input size and output size.
+  // See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to
+  // learn more.
+  //
+  // When no InfoTypes or CustomInfoTypes are specified in this request, the
+  // system will automatically choose what detectors to run. By default this may
+  // be all types, but may change over time as detectors are updated.
+  rpc DeidentifyContent(DeidentifyContentRequest) returns (DeidentifyContentResponse) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/content:deidentify"
+      body: "*"
+    };
+  }
+
+  // Re-identifies content that has been de-identified.
+  // See
+  // https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example
+  // to learn more.
+  rpc ReidentifyContent(ReidentifyContentRequest) returns (ReidentifyContentResponse) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/content:reidentify"
+      body: "*"
+    };
+  }
+
+  // Returns a list of the sensitive information types that the DLP API
+  // supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
+  // learn more.
+  rpc ListInfoTypes(ListInfoTypesRequest) returns (ListInfoTypesResponse) {
+    option (google.api.http) = {
+      get: "/v2/infoTypes"
+    };
+  }
+
+  // Creates an InspectTemplate for re-using frequently used configuration
+  // for inspecting content, images, and storage.
+  // See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+  rpc CreateInspectTemplate(CreateInspectTemplateRequest) returns (InspectTemplate) {
+    option (google.api.http) = {
+      post: "/v2/{parent=organizations/*}/inspectTemplates"
+      body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*}/inspectTemplates"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the InspectTemplate.
+  // See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+  rpc UpdateInspectTemplate(UpdateInspectTemplateRequest) returns (InspectTemplate) {
+    option (google.api.http) = {
+      patch: "/v2/{name=organizations/*/inspectTemplates/*}"
+      body: "*"
+      additional_bindings {
+        patch: "/v2/{name=projects/*/inspectTemplates/*}"
+        body: "*"
+      }
+    };
+  }
+
+  // Gets an InspectTemplate.
+  // See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+  rpc GetInspectTemplate(GetInspectTemplateRequest) returns (InspectTemplate) {
+    option (google.api.http) = {
+      get: "/v2/{name=organizations/*/inspectTemplates/*}"
+      additional_bindings {
+        get: "/v2/{name=projects/*/inspectTemplates/*}"
+      }
+    };
+  }
+
+  // Lists InspectTemplates.
+  // See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+  rpc ListInspectTemplates(ListInspectTemplatesRequest) returns (ListInspectTemplatesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=organizations/*}/inspectTemplates"
+      additional_bindings {
+        get: "/v2/{parent=projects/*}/inspectTemplates"
+      }
+    };
+  }
+
+  // Deletes an InspectTemplate.
+  // See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+  rpc DeleteInspectTemplate(DeleteInspectTemplateRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=organizations/*/inspectTemplates/*}"
+      additional_bindings {
+        delete: "/v2/{name=projects/*/inspectTemplates/*}"
+      }
+    };
+  }
+
+  // Creates a DeidentifyTemplate for re-using frequently used configuration
+  // for de-identifying content, images, and storage.
+  // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+  // more.
+  rpc CreateDeidentifyTemplate(CreateDeidentifyTemplateRequest) returns (DeidentifyTemplate) {
+    option (google.api.http) = {
+      post: "/v2/{parent=organizations/*}/deidentifyTemplates"
+      body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*}/deidentifyTemplates"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the DeidentifyTemplate.
+  // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+  // more.
+  rpc UpdateDeidentifyTemplate(UpdateDeidentifyTemplateRequest) returns (DeidentifyTemplate) {
+    option (google.api.http) = {
+      patch: "/v2/{name=organizations/*/deidentifyTemplates/*}"
+      body: "*"
+      additional_bindings {
+        patch: "/v2/{name=projects/*/deidentifyTemplates/*}"
+        body: "*"
+      }
+    };
+  }
+
+  // Gets a DeidentifyTemplate.
+  // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+  // more.
+  rpc GetDeidentifyTemplate(GetDeidentifyTemplateRequest) returns (DeidentifyTemplate) {
+    option (google.api.http) = {
+      get: "/v2/{name=organizations/*/deidentifyTemplates/*}"
+      additional_bindings {
+        get: "/v2/{name=projects/*/deidentifyTemplates/*}"
+      }
+    };
+  }
+
+  // Lists DeidentifyTemplates.
+  // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+  // more.
+  rpc ListDeidentifyTemplates(ListDeidentifyTemplatesRequest) returns (ListDeidentifyTemplatesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=organizations/*}/deidentifyTemplates"
+      additional_bindings {
+        get: "/v2/{parent=projects/*}/deidentifyTemplates"
+      }
+    };
+  }
+
+  // Deletes a DeidentifyTemplate.
+  // See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+  // more.
+  rpc DeleteDeidentifyTemplate(DeleteDeidentifyTemplateRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=organizations/*/deidentifyTemplates/*}"
+      additional_bindings {
+        delete: "/v2/{name=projects/*/deidentifyTemplates/*}"
+      }
+    };
+  }
+
+  // Creates a job trigger to run DLP actions such as scanning storage for
+  // sensitive information on a set schedule.
+  // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+  rpc CreateJobTrigger(CreateJobTriggerRequest) returns (JobTrigger) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/jobTriggers"
+      body: "*"
+    };
+  }
+
+  // Updates a job trigger.
+  // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+  rpc UpdateJobTrigger(UpdateJobTriggerRequest) returns (JobTrigger) {
+    option (google.api.http) = {
+      patch: "/v2/{name=projects/*/jobTriggers/*}"
+      body: "*"
+    };
+  }
+
+  // Gets a job trigger.
+  // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+  rpc GetJobTrigger(GetJobTriggerRequest) returns (JobTrigger) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/jobTriggers/*}"
+    };
+  }
+
+  // Lists job triggers.
+  // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+  rpc ListJobTriggers(ListJobTriggersRequest) returns (ListJobTriggersResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*}/jobTriggers"
+    };
+  }
+
+  // Deletes a job trigger.
+  // See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+  rpc DeleteJobTrigger(DeleteJobTriggerRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/jobTriggers/*}"
+    };
+  }
+
+  // Activate a job trigger. Causes the immediate execute of a trigger
+  // instead of waiting on the trigger event to occur.
+  rpc ActivateJobTrigger(ActivateJobTriggerRequest) returns (DlpJob) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/jobTriggers/*}:activate"
+      body: "*"
+    };
+  }
+
+  // Creates a new job to inspect storage or calculate risk metrics.
+  // See https://cloud.google.com/dlp/docs/inspecting-storage and
+  // https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+  //
+  // When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the
+  // system will automatically choose what detectors to run. By default this may
+  // be all types, but may change over time as detectors are updated.
+  rpc CreateDlpJob(CreateDlpJobRequest) returns (DlpJob) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/dlpJobs"
+      body: "*"
+    };
+  }
+
+  // Lists DlpJobs that match the specified filter in the request.
+  // See https://cloud.google.com/dlp/docs/inspecting-storage and
+  // https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+  rpc ListDlpJobs(ListDlpJobsRequest) returns (ListDlpJobsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*}/dlpJobs"
+    };
+  }
+
+  // Gets the latest state of a long-running DlpJob.
+  // See https://cloud.google.com/dlp/docs/inspecting-storage and
+  // https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+  rpc GetDlpJob(GetDlpJobRequest) returns (DlpJob) {
+    option (google.api.http) = {
+      get: "/v2/{name=projects/*/dlpJobs/*}"
+    };
+  }
+
+  // Deletes a long-running DlpJob. This method indicates that the client is
+  // no longer interested in the DlpJob result. The job will be cancelled if
+  // possible.
+  // See https://cloud.google.com/dlp/docs/inspecting-storage and
+  // https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+  rpc DeleteDlpJob(DeleteDlpJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/dlpJobs/*}"
+    };
+  }
+
+  // Starts asynchronous cancellation on a long-running DlpJob. The server
+  // makes a best effort to cancel the DlpJob, but success is not
+  // guaranteed.
+  // See https://cloud.google.com/dlp/docs/inspecting-storage and
+  // https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+  rpc CancelDlpJob(CancelDlpJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/dlpJobs/*}:cancel"
+      body: "*"
+    };
+  }
+
+  // Creates a pre-built stored infoType to be used for inspection.
+  // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+  // learn more.
+  rpc CreateStoredInfoType(CreateStoredInfoTypeRequest) returns (StoredInfoType) {
+    option (google.api.http) = {
+      post: "/v2/{parent=organizations/*}/storedInfoTypes"
+      body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*}/storedInfoTypes"
+        body: "*"
+      }
+    };
+  }
+
+  // Updates the stored infoType by creating a new version. The existing version
+  // will continue to be used until the new version is ready.
+  // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+  // learn more.
+  rpc UpdateStoredInfoType(UpdateStoredInfoTypeRequest) returns (StoredInfoType) {
+    option (google.api.http) = {
+      patch: "/v2/{name=organizations/*/storedInfoTypes/*}"
+      body: "*"
+      additional_bindings {
+        patch: "/v2/{name=projects/*/storedInfoTypes/*}"
+        body: "*"
+      }
+    };
+  }
+
+  // Gets a stored infoType.
+  // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+  // learn more.
+  rpc GetStoredInfoType(GetStoredInfoTypeRequest) returns (StoredInfoType) {
+    option (google.api.http) = {
+      get: "/v2/{name=organizations/*/storedInfoTypes/*}"
+      additional_bindings {
+        get: "/v2/{name=projects/*/storedInfoTypes/*}"
+      }
+    };
+  }
+
+  // Lists stored infoTypes.
+  // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+  // learn more.
+  rpc ListStoredInfoTypes(ListStoredInfoTypesRequest) returns (ListStoredInfoTypesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=organizations/*}/storedInfoTypes"
+      additional_bindings {
+        get: "/v2/{parent=projects/*}/storedInfoTypes"
+      }
+    };
+  }
+
+  // Deletes a stored infoType.
+  // See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+  // learn more.
+  rpc DeleteStoredInfoType(DeleteStoredInfoTypeRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=organizations/*/storedInfoTypes/*}"
+      additional_bindings {
+        delete: "/v2/{name=projects/*/storedInfoTypes/*}"
+      }
+    };
+  }
+}
+
+// List of exclude infoTypes.
+message ExcludeInfoTypes {
+  // InfoType list in ExclusionRule rule drops a finding when it overlaps or
+  // contained within with a finding of an infoType from this list. For
+  // example, for `InspectionRuleSet.info_types` containing "PHONE_NUMBER"` and
+  // `exclusion_rule` containing `exclude_info_types.info_types` with
+  // "EMAIL_ADDRESS" the phone number findings are dropped if they overlap
+  // with EMAIL_ADDRESS finding.
+  // That leads to "555-222-2222@example.org" to generate only a single
+  // finding, namely email address.
+  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 {
+  oneof type {
+    // Dictionary which defines the rule.
+    CustomInfoType.Dictionary dictionary = 1;
+
+    // Regular expression which defines the rule.
+    CustomInfoType.Regex regex = 2;
+
+    // Set of infoTypes for which findings would affect this rule.
+    ExcludeInfoTypes exclude_info_types = 3;
+  }
+
+  // How the rule is applied, see MatchingType documentation for details.
+  MatchingType matching_type = 4;
+}
+
+// A single inspection rule to be applied to infoTypes, specified in
+// `InspectionRuleSet`.
+message InspectionRule {
+  oneof type {
+    // Hotword-based detection rule.
+    CustomInfoType.DetectionRule.HotwordRule hotword_rule = 1;
+
+    // Exclusion rule.
+    ExclusionRule exclusion_rule = 2;
+  }
+}
+
+// Rule set for modifying a set of infoTypes to alter behavior under certain
+// circumstances, depending on the specific details of the rules within the set.
+message InspectionRuleSet {
+  // List of infoTypes this rule set is applied to.
+  repeated InfoType info_types = 1;
+
+  // Set of rules to be applied to infoTypes. The rules are applied in order.
+  repeated InspectionRule rules = 2;
+}
+
+// Configuration description of the scanning process.
+// When used with redactContent only info_types and min_likelihood are currently
+// used.
+message InspectConfig {
+  message FindingLimits {
+    // Max findings configuration per infoType, per content item or long
+    // running DlpJob.
+    message InfoTypeLimit {
+      // Type of information the findings limit applies to. Only one limit per
+      // info_type should be provided. If InfoTypeLimit does not have an
+      // info_type, the DLP API applies the limit against all info_types that
+      // are found but not specified in another InfoTypeLimit.
+      InfoType info_type = 1;
+
+      // Max findings limit for the given infoType.
+      int32 max_findings = 2;
+    }
+
+    // Max number of findings that will be returned for each item scanned.
+    // When set within `InspectDataSourceRequest`,
+    // 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;
+
+    // Max number of findings that will be returned per request/job.
+    // When set within `InspectContentRequest`, the maximum returned is 2000
+    // regardless if this is set higher.
+    int32 max_findings_per_request = 2;
+
+    // Configuration of findings limit given for specified infoTypes.
+    repeated InfoTypeLimit max_findings_per_info_type = 3;
+  }
+
+  // Restricts what info_types to look for. The values must correspond to
+  // InfoType values returned by ListInfoTypes or listed at
+  // https://cloud.google.com/dlp/docs/infotypes-reference.
+  //
+  // When no InfoTypes or CustomInfoTypes are specified in a request, the
+  // 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.
+  repeated InfoType info_types = 1;
+
+  // Only returns findings equal or above this threshold. The default is
+  // POSSIBLE.
+  // See https://cloud.google.com/dlp/docs/likelihood to learn more.
+  Likelihood min_likelihood = 2;
+
+  FindingLimits limits = 3;
+
+  // When true, a contextual quote from the data that triggered a finding is
+  // included in the response; see Finding.quote.
+  bool include_quote = 4;
+
+  // When true, excludes type information of the findings.
+  bool exclude_info_types = 5;
+
+  // CustomInfoTypes provided by the user. See
+  // https://cloud.google.com/dlp/docs/creating-custom-infotypes to learn more.
+  repeated CustomInfoType custom_info_types = 6;
+
+  // List of options defining data content to scan.
+  // If empty, text, images, and other content will be included.
+  repeated ContentOption content_options = 8;
+
+  // Set of rules to apply to the findings for this InspectConfig.
+  // Exclusion rules, contained in the set are executed in the end, other
+  // rules are executed in the order they are specified for each info type.
+  repeated InspectionRuleSet rule_set = 10;
+}
+
+// Container for bytes to inspect or redact.
+message ByteContentItem {
+  enum BytesType {
+    BYTES_TYPE_UNSPECIFIED = 0;
+
+    IMAGE = 6;
+
+    IMAGE_JPEG = 1;
+
+    IMAGE_BMP = 2;
+
+    IMAGE_PNG = 3;
+
+    IMAGE_SVG = 4;
+
+    TEXT_UTF8 = 5;
+
+    AVRO = 11;
+  }
+
+  // The type of data stored in the bytes string. Default will be TEXT_UTF8.
+  BytesType type = 1;
+
+  // Content data to inspect or redact.
+  bytes data = 2;
+}
+
+// Container structure for the content to inspect.
+message ContentItem {
+  // Data of the item either in the byte array or UTF-8 string form, or table.
+  oneof data_item {
+    // String data to inspect or redact.
+    string value = 3;
+
+    // Structured content for inspection. See
+    // https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to
+    // learn more.
+    Table table = 4;
+
+    // Content data to inspect or redact. Replaces `type` and `data`.
+    ByteContentItem byte_item = 5;
+  }
+}
+
+// Structured content to inspect. Up to 50,000 `Value`s per request allowed.
+// See https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to
+// learn more.
+message Table {
+  message Row {
+    repeated Value values = 1;
+  }
+
+  repeated FieldId headers = 1;
+
+  repeated Row rows = 2;
+}
+
+// All the findings for a single scanned item.
+message InspectResult {
+  // List of findings for an item.
+  repeated Finding findings = 1;
+
+  // If true, then this item might have more findings than were returned,
+  // and the findings returned are an arbitrary subset of all findings.
+  // The findings list might be truncated because the input items were too
+  // large, or because the server reached the maximum amount of resources
+  // allowed for a single API call. For best results, divide the input into
+  // smaller batches.
+  bool findings_truncated = 2;
+}
+
+// Represents a piece of potentially sensitive content.
+message Finding {
+  // 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
+  // less than or equal to 4096 bytes long. If the finding exceeds 4096 bytes
+  // in length, the quote may be omitted.
+  string quote = 1;
+
+  // The type of content that might have been found.
+  // Provided if `excluded_types` is false.
+  InfoType info_type = 2;
+
+  // Confidence of how likely it is that the `info_type` is correct.
+  Likelihood likelihood = 3;
+
+  // Where the content was found.
+  Location location = 4;
+
+  // Timestamp when finding was detected.
+  google.protobuf.Timestamp create_time = 6;
+
+  // Contains data parsed from quotes. Only populated if include_quote was set
+  // to true and a supported infoType was requested. Currently supported
+  // infoTypes: DATE, DATE_OF_BIRTH and TIME.
+  QuoteInfo quote_info = 7;
+}
+
+// Specifies the location of the finding.
+message Location {
+  // Zero-based byte offsets delimiting the finding.
+  // These are relative to the finding's containing element.
+  // Note that when the content is not textual, this references
+  // the UTF-8 encoded textual representation of the content.
+  // Omitted if content is an image.
+  Range byte_range = 1;
+
+  // Unicode character offsets delimiting the finding.
+  // These are relative to the finding's containing element.
+  // Provided when the content is text.
+  Range codepoint_range = 2;
+
+  // 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;
+}
+
+// Findings container location data.
+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:  `<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).
+  string container_name = 1;
+
+  // Type of the container within the file with location of the finding.
+  oneof location {
+    // Location within a row or record of a database table.
+    RecordLocation record_location = 2;
+
+    // Location within an image's pixels.
+    ImageLocation image_location = 3;
+
+    // Location data for document files.
+    DocumentLocation document_location = 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 container_timestamp = 6;
+
+  // Findings container version, if available
+  // ("generation" for Google Cloud Storage).
+  string container_version = 7;
+}
+
+// Location of a finding within a document.
+message DocumentLocation {
+  // Offset of the line, from the beginning of the file, where the finding
+  // is located.
+  int64 file_offset = 1;
+}
+
+// Location of a finding within a row or record.
+message RecordLocation {
+  // Key of the finding.
+  RecordKey record_key = 1;
+
+  // Field id of the field containing the finding.
+  FieldId field_id = 2;
+
+  // Location within a `ContentItem.Table`.
+  TableLocation table_location = 3;
+}
+
+// Location of a finding within a table.
+message TableLocation {
+  // The zero-based index of the row where the finding is located.
+  int64 row_index = 1;
+}
+
+// Generic half-open interval [start, end)
+message Range {
+  // Index of the first character of the range (inclusive).
+  int64 start = 1;
+
+  // Index of the last character of the range (exclusive).
+  int64 end = 2;
+}
+
+// Location of the finding within an image.
+message ImageLocation {
+  // Bounding boxes locating the pixels within the image containing the finding.
+  repeated BoundingBox bounding_boxes = 1;
+}
+
+// Bounding box encompassing detected text within an image.
+message BoundingBox {
+  // Top coordinate of the bounding box. (0,0) is upper left.
+  int32 top = 1;
+
+  // Left coordinate of the bounding box. (0,0) is upper left.
+  int32 left = 2;
+
+  // Width of the bounding box in pixels.
+  int32 width = 3;
+
+  // Height of the bounding box in pixels.
+  int32 height = 4;
+}
+
+// Request to search for potentially sensitive info in an image and redact it
+// by covering it with a colored rectangle.
+message RedactImageRequest {
+  // Configuration for determining how redaction of images should occur.
+  message ImageRedactionConfig {
+    // Type of information to redact from images.
+    oneof target {
+      // Only one per info_type should be provided per request. If not
+      // specified, and redact_all_text is false, the DLP API will redact all
+      // text that it matches against all info_types that are found, but not
+      // specified in another ImageRedactionConfig.
+      InfoType info_type = 1;
+
+      // If true, all text found in the image, regardless whether it matches an
+      // info_type, is redacted. Only one should be provided.
+      bool redact_all_text = 2;
+    }
+
+    // The color to use when redacting content from an image. If not specified,
+    // the default is black.
+    Color redaction_color = 3;
+  }
+
+  // The parent resource name, for example projects/my-project-id.
+  string parent = 1;
+
+  // Configuration for the inspector.
+  InspectConfig inspect_config = 2;
+
+  // The configuration for specifying what content to redact from images.
+  repeated ImageRedactionConfig image_redaction_configs = 5;
+
+  // Whether the response should include findings along with the redacted
+  // image.
+  bool include_findings = 6;
+
+  // The content must be PNG, JPEG, SVG or BMP.
+  ByteContentItem byte_item = 7;
+}
+
+// Represents a color in the RGB color space.
+message Color {
+  // The amount of red in the color as a value in the interval [0, 1].
+  float red = 1;
+
+  // The amount of green in the color as a value in the interval [0, 1].
+  float green = 2;
+
+  // The amount of blue in the color as a value in the interval [0, 1].
+  float blue = 3;
+}
+
+// Results of redacting an image.
+message RedactImageResponse {
+  // The redacted image. The type will be the same as the original image.
+  bytes redacted_image = 1;
+
+  // If an image was being inspected and the InspectConfig's include_quote was
+  // set to true, then this field will include all text, if any, that was found
+  // in the image.
+  string extracted_text = 2;
+
+  // The findings. Populated when include_findings in the request is true.
+  InspectResult inspect_result = 3;
+}
+
+// Request to de-identify a list of items.
+message DeidentifyContentRequest {
+  // The parent resource name, for example projects/my-project-id.
+  string parent = 1;
+
+  // Configuration for the de-identification of the content item.
+  // Items specified here will override the template referenced by the
+  // deidentify_template_name argument.
+  DeidentifyConfig deidentify_config = 2;
+
+  // Configuration for the inspector.
+  // Items specified here will override the template referenced by the
+  // inspect_template_name argument.
+  InspectConfig inspect_config = 3;
+
+  // The item to de-identify. Will be treated as text.
+  ContentItem item = 4;
+
+  // Optional 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
+  // 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;
+}
+
+// Results of de-identifying a ContentItem.
+message DeidentifyContentResponse {
+  // The de-identified item.
+  ContentItem item = 1;
+
+  // An overview of the changes that were made on the `item`.
+  TransformationOverview overview = 2;
+}
+
+// Request to re-identify an item.
+message ReidentifyContentRequest {
+  // The parent resource name.
+  string parent = 1;
+
+  // Configuration for the re-identification of the content item.
+  // This field shares the same proto message type that is used for
+  // de-identification, however its usage here is for the reversal of the
+  // previous de-identification. Re-identification is performed by examining
+  // the transformations used to de-identify the items and executing the
+  // reverse. This requires that only reversible transformations
+  // be provided here. The reversible transformations are:
+  //
+  //  - `CryptoReplaceFfxFpeConfig`
+  DeidentifyConfig reidentify_config = 2;
+
+  // Configuration for the inspector.
+  InspectConfig inspect_config = 3;
+
+  // The item to re-identify. Will be treated as text.
+  ContentItem item = 4;
+
+  // Optional 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`.
+  // 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;
+}
+
+// Results of re-identifying a item.
+message ReidentifyContentResponse {
+  // The re-identified item.
+  ContentItem item = 1;
+
+  // An overview of the changes that were made to the `item`.
+  TransformationOverview overview = 2;
+}
+
+// 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;
+
+  // Configuration for the inspector. What specified here will override
+  // the template referenced by the inspect_template_name argument.
+  InspectConfig inspect_config = 2;
+
+  // The item to inspect.
+  ContentItem item = 3;
+
+  // Optional 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;
+}
+
+// Results of inspecting an item.
+message InspectContentResponse {
+  // The findings.
+  InspectResult result = 1;
+}
+
+// Cloud repository for storing output.
+message OutputStorageConfig {
+  // Predefined schemas for storing findings.
+  enum OutputSchema {
+    OUTPUT_SCHEMA_UNSPECIFIED = 0;
+
+    // Basic schema including only `info_type`, `quote`, `certainty`, and
+    // `timestamp`.
+    BASIC_COLUMNS = 1;
+
+    // Schema tailored to findings from scanning Google Cloud Storage.
+    GCS_COLUMNS = 2;
+
+    // Schema tailored to findings from scanning Google Datastore.
+    DATASTORE_COLUMNS = 3;
+
+    // Schema tailored to findings from scanning Google BigQuery.
+    BIG_QUERY_COLUMNS = 4;
+
+    // Schema containing all columns.
+    ALL_COLUMNS = 5;
+  }
+
+  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
+    // for you with the following format:
+    // dlp_googleapis_yyyy_mm_dd_[dlp_job_id]. Pacific timezone will be used for
+    // generating the date details.
+    //
+    // For Inspect, each column in an existing output table must have the same
+    // name, type, and mode of a field in the `Finding` object.
+    //
+    // For Risk, an existing output table should be the output of a previous
+    // Risk analysis job run on the same source table, with the same privacy
+    // metric and quasi-identifiers. Risk jobs that analyze the same table but
+    // compute a different privacy metric, or use different sets of
+    // quasi-identifiers, cannot store their results in the same table.
+    BigQueryTable table = 1;
+  }
+
+  // Schema used for writing the findings for Inspect jobs. This field is only
+  // used for Inspect and must be unspecified for Risk jobs. Columns are derived
+  // from the `Finding` object. If appending to an existing table, any columns
+  // from the predefined schema that are missing will be added. No columns in
+  // the existing table will be deleted.
+  //
+  // 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.
+  OutputSchema output_schema = 3;
+}
+
+// Statistics regarding a specific InfoType.
+message InfoTypeStats {
+  // The type of finding this stat is for.
+  InfoType info_type = 1;
+
+  // Number of findings for this infoType.
+  int64 count = 2;
+}
+
+// The results of an inspect DataSource job.
+message InspectDataSourceDetails {
+  message RequestedOptions {
+    // If run with an InspectTemplate, a snapshot of its state at the time of
+    // this run.
+    InspectTemplate snapshot_inspect_template = 1;
+
+    InspectJobConfig job_config = 3;
+  }
+
+  // All result fields mentioned below are updated while the job is processing.
+  message Result {
+    // Total size in bytes that were processed.
+    int64 processed_bytes = 1;
+
+    // Estimate of the number of bytes to process.
+    int64 total_estimated_bytes = 2;
+
+    // Statistics of how many instances of each info type were found during
+    // inspect job.
+    repeated InfoTypeStats info_type_stats = 3;
+  }
+
+  // The configuration used for this job.
+  RequestedOptions requested_options = 2;
+
+  // A summary of the outcome of this inspect job.
+  Result result = 3;
+}
+
+// InfoType description.
+message InfoTypeDescription {
+  // Internal name of the infoType.
+  string name = 1;
+
+  // Human readable form of the infoType name.
+  string display_name = 2;
+
+  // Which parts of the API supports this InfoType.
+  repeated InfoTypeSupportedBy supported_by = 3;
+
+  // Description of the infotype. Translated when language is provided in the
+  // request.
+  string description = 4;
+}
+
+// Request for the list of infoTypes.
+message ListInfoTypesRequest {
+  // Optional 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
+  // API. Defaults to supported_by=INSPECT.
+  string filter = 2;
+}
+
+// Response to the ListInfoTypes request.
+message ListInfoTypesResponse {
+  // Set of sensitive infoTypes.
+  repeated InfoTypeDescription info_types = 1;
+}
+
+// Configuration for a risk analysis job. See
+// https://cloud.google.com/dlp/docs/concepts-risk-analysis to learn more.
+message RiskAnalysisJobConfig {
+  // Privacy metric to compute.
+  PrivacyMetric privacy_metric = 1;
+
+  // Input dataset to compute metrics over.
+  BigQueryTable source_table = 2;
+
+  // Actions to execute at the completion of the job. Are executed in the order
+  // provided.
+  repeated Action actions = 3;
+}
+
+// A column with a semantic tag attached.
+message QuasiId {
+  // Identifies the column. [required]
+  FieldId field = 1;
+
+  // Semantic tag that identifies what a column contains, to determine which
+  // statistical model to use to estimate the reidentifiability of each
+  // value. [required]
+  oneof tag {
+    // A column can be tagged with a InfoType to use the relevant public
+    // dataset as a statistical model of population, if available. We
+    // currently support US ZIP codes, region codes, ages and genders.
+    // To programmatically obtain the list of supported InfoTypes, use
+    // ListInfoTypes with the supported_by=RISK_ANALYSIS filter.
+    InfoType info_type = 2;
+
+    // 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 = 3;
+
+    // If no semantic tag is indicated, we infer the statistical model from
+    // the distribution of values in the input data
+    google.protobuf.Empty inferred = 4;
+  }
+}
+
+// An auxiliary table containing statistical information on the relative
+// frequency of different quasi-identifiers values. It has one or several
+// quasi-identifiers columns, and one column that indicates the relative
+// frequency of each quasi-identifier tuple.
+// If a tuple is present in the data but not in the auxiliary table, the
+// corresponding relative frequency is assumed to be zero (and thus, the
+// tuple is highly reidentifiable).
+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 {
+    FieldId field = 1;
+
+    string custom_tag = 2;
+  }
+
+  // Auxiliary table location. [required]
+  BigQueryTable table = 3;
+
+  // Quasi-identifier columns. [required]
+  repeated QuasiIdentifierField quasi_ids = 1;
+
+  // 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;
+}
+
+// Privacy metric to compute for reidentification risk analysis.
+message PrivacyMetric {
+  // Compute numerical stats over an individual column, including
+  // min, max, and quantiles.
+  message NumericalStatsConfig {
+    // Field to compute numerical stats on. Supported types are
+    // integer, float, date, datetime, timestamp, time.
+    FieldId field = 1;
+  }
+
+  // Compute numerical stats over an individual column, including
+  // number of distinct values and value count distribution.
+  message CategoricalStatsConfig {
+    // Field to compute categorical stats on. All column types are
+    // supported except for arrays and structs. However, it may be more
+    // informative to use NumericalStats when the field type is supported,
+    // depending on the data.
+    FieldId field = 1;
+  }
+
+  // k-anonymity metric, used for analysis of reidentification risk.
+  message KAnonymityConfig {
+    // Set of fields to compute k-anonymity over. When multiple fields are
+    // specified, they are considered a single composite key. Structs and
+    // repeated data types are not supported; however, nested fields are
+    // supported so long as they are not structs themselves or nested within
+    // a repeated field.
+    repeated FieldId quasi_ids = 1;
+
+    // Optional 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
+    // is a multiset: the order in which the different tuples appear in the
+    // dataset is ignored, but their frequency is taken into account.
+    //
+    // Important note: a maximum of 1000 rows can be associated to a single
+    // entity ID. If more rows are associated with the same entity ID, some
+    // might be ignored.
+    EntityId entity_id = 2;
+  }
+
+  // l-diversity metric, used for analysis of reidentification risk.
+  message LDiversityConfig {
+    // Set of quasi-identifiers indicating how equivalence classes are
+    // defined for the l-diversity computation. When multiple fields are
+    // specified, they are considered a single composite key.
+    repeated FieldId quasi_ids = 1;
+
+    // Sensitive field for computing the l-value.
+    FieldId sensitive_attribute = 2;
+  }
+
+  // Reidentifiability metric. This corresponds to a risk model similar to what
+  // is called "journalist risk" in the literature, except the attack dataset is
+  // statistically modeled instead of being perfectly known. This can be done
+  // 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 {
+    message TaggedField {
+      // Identifies the column. [required]
+      FieldId field = 1;
+
+      // Semantic tag that identifies what a column contains, to determine which
+      // statistical model to use to estimate the reidentifiability of each
+      // value. [required]
+      oneof tag {
+        // A column can be tagged with a InfoType to use the relevant public
+        // dataset as a statistical model of population, if available. We
+        // currently support US ZIP codes, region codes, ages and genders.
+        // To programmatically obtain the list of supported InfoTypes, use
+        // ListInfoTypes with the supported_by=RISK_ANALYSIS filter.
+        InfoType info_type = 2;
+
+        // 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 = 3;
+
+        // If no semantic tag is indicated, we infer the statistical model from
+        // the distribution of values in the input data
+        google.protobuf.Empty inferred = 4;
+      }
+    }
+
+    // An auxiliary table contains statistical information on the relative
+    // frequency of different quasi-identifiers values. It has one or several
+    // quasi-identifiers columns, and one column that indicates the relative
+    // frequency of each quasi-identifier tuple.
+    // If a tuple is present in the data but not in the auxiliary table, the
+    // corresponding relative frequency is assumed to be zero (and thus, the
+    // tuple is highly reidentifiable).
+    message AuxiliaryTable {
+      // 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 {
+        FieldId field = 1;
+
+        string custom_tag = 2;
+      }
+
+      // Auxiliary table location. [required]
+      BigQueryTable table = 3;
+
+      // Quasi-identifier columns. [required]
+      repeated QuasiIdField quasi_ids = 1;
+
+      // 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;
+    }
+
+    // Fields considered to be quasi-identifiers. No two columns can have the
+    // same tag. [required]
+    repeated TaggedField quasi_ids = 1;
+
+    // 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
+    // US_ZIP_5) or a region code.
+    string region_code = 2;
+
+    // Several auxiliary tables can be used in the analysis. Each custom_tag
+    // used to tag a quasi-identifiers column must appear in exactly one column
+    // of one auxiliary table.
+    repeated AuxiliaryTable auxiliary_tables = 3;
+  }
+
+  // δ-presence metric, used to estimate how likely it is for an attacker to
+  // figure out that one given individual appears in a de-identified dataset.
+  // 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;
+
+    // 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
+    // US_ZIP_5) or a region code.
+    string region_code = 2;
+
+    // Several auxiliary tables can be used in the analysis. Each custom_tag
+    // used to tag a quasi-identifiers field must appear in exactly one
+    // field of one auxiliary table.
+    repeated StatisticalTable auxiliary_tables = 3;
+  }
+
+  oneof type {
+    NumericalStatsConfig numerical_stats_config = 1;
+
+    CategoricalStatsConfig categorical_stats_config = 2;
+
+    KAnonymityConfig k_anonymity_config = 3;
+
+    LDiversityConfig l_diversity_config = 4;
+
+    KMapEstimationConfig k_map_estimation_config = 5;
+
+    DeltaPresenceEstimationConfig delta_presence_estimation_config = 6;
+  }
+}
+
+// Result of a risk analysis operation request.
+message AnalyzeDataSourceRiskDetails {
+  // Result of the numerical stats computation.
+  message NumericalStatsResult {
+    // Minimum value appearing in the column.
+    Value min_value = 1;
+
+    // Maximum value appearing in the column.
+    Value max_value = 2;
+
+    // List of 99 values that partition the set of field values into 100 equal
+    // sized buckets.
+    repeated Value quantile_values = 4;
+  }
+
+  // Result of the categorical stats computation.
+  message CategoricalStatsResult {
+    message CategoricalStatsHistogramBucket {
+      // Lower bound on the value frequency of the values in this bucket.
+      int64 value_frequency_lower_bound = 1;
+
+      // Upper bound on the value frequency of the values in this bucket.
+      int64 value_frequency_upper_bound = 2;
+
+      // Total number of values in this bucket.
+      int64 bucket_size = 3;
+
+      // Sample of value frequencies in this bucket. The total number of
+      // values returned per bucket is capped at 20.
+      repeated ValueFrequency bucket_values = 4;
+
+      // Total number of distinct values in this bucket.
+      int64 bucket_value_count = 5;
+    }
+
+    // Histogram of value frequencies in the column.
+    repeated CategoricalStatsHistogramBucket value_frequency_histogram_buckets = 5;
+  }
+
+  // Result of the k-anonymity computation.
+  message KAnonymityResult {
+    // The set of columns' values that share the same ldiversity value
+    message KAnonymityEquivalenceClass {
+      // Set of values defining the equivalence class. One value per
+      // quasi-identifier column in the original KAnonymity metric message.
+      // The order is always the same as the original request.
+      repeated Value quasi_ids_values = 1;
+
+      // Size of the equivalence class, for example number of rows with the
+      // above set of values.
+      int64 equivalence_class_size = 2;
+    }
+
+    message KAnonymityHistogramBucket {
+      // Lower bound on the size of the equivalence classes in this bucket.
+      int64 equivalence_class_size_lower_bound = 1;
+
+      // Upper bound on the size of the equivalence classes in this bucket.
+      int64 equivalence_class_size_upper_bound = 2;
+
+      // Total number of equivalence classes in this bucket.
+      int64 bucket_size = 3;
+
+      // Sample of equivalence classes in this bucket. The total number of
+      // classes returned per bucket is capped at 20.
+      repeated KAnonymityEquivalenceClass bucket_values = 4;
+
+      // Total number of distinct equivalence classes in this bucket.
+      int64 bucket_value_count = 5;
+    }
+
+    // Histogram of k-anonymity equivalence classes.
+    repeated KAnonymityHistogramBucket equivalence_class_histogram_buckets = 5;
+  }
+
+  // Result of the l-diversity computation.
+  message LDiversityResult {
+    // The set of columns' values that share the same ldiversity value.
+    message LDiversityEquivalenceClass {
+      // Quasi-identifier values defining the k-anonymity equivalence
+      // class. The order is always the same as the original request.
+      repeated Value quasi_ids_values = 1;
+
+      // Size of the k-anonymity equivalence class.
+      int64 equivalence_class_size = 2;
+
+      // Number of distinct sensitive values in this equivalence class.
+      int64 num_distinct_sensitive_values = 3;
+
+      // Estimated frequencies of top sensitive values.
+      repeated ValueFrequency top_sensitive_values = 4;
+    }
+
+    message LDiversityHistogramBucket {
+      // Lower bound on the sensitive value frequencies of the equivalence
+      // classes in this bucket.
+      int64 sensitive_value_frequency_lower_bound = 1;
+
+      // Upper bound on the sensitive value frequencies of the equivalence
+      // classes in this bucket.
+      int64 sensitive_value_frequency_upper_bound = 2;
+
+      // Total number of equivalence classes in this bucket.
+      int64 bucket_size = 3;
+
+      // Sample of equivalence classes in this bucket. The total number of
+      // classes returned per bucket is capped at 20.
+      repeated LDiversityEquivalenceClass bucket_values = 4;
+
+      // Total number of distinct equivalence classes in this bucket.
+      int64 bucket_value_count = 5;
+    }
+
+    // Histogram of l-diversity equivalence class sensitive value frequencies.
+    repeated LDiversityHistogramBucket sensitive_value_frequency_histogram_buckets = 5;
+  }
+
+  // Result of the reidentifiability analysis. Note that these results are an
+  // estimation, not exact values.
+  message KMapEstimationResult {
+    // A tuple of values for the quasi-identifier columns.
+    message KMapEstimationQuasiIdValues {
+      // The quasi-identifier values.
+      repeated Value quasi_ids_values = 1;
+
+      // The estimated anonymity for these quasi-identifier values.
+      int64 estimated_anonymity = 2;
+    }
+
+    // A KMapEstimationHistogramBucket message with the following values:
+    //   min_anonymity: 3
+    //   max_anonymity: 5
+    //   frequency: 42
+    // means that there are 42 records whose quasi-identifier values correspond
+    // to 3, 4 or 5 people in the overlying population. An important particular
+    // case is when min_anonymity = max_anonymity = 1: the frequency field then
+    // corresponds to the number of uniquely identifiable records.
+    message KMapEstimationHistogramBucket {
+      // Always positive.
+      int64 min_anonymity = 1;
+
+      // Always greater than or equal to min_anonymity.
+      int64 max_anonymity = 2;
+
+      // Number of records within these anonymity bounds.
+      int64 bucket_size = 5;
+
+      // Sample of quasi-identifier tuple values in this bucket. The total
+      // number of classes returned per bucket is capped at 20.
+      repeated KMapEstimationQuasiIdValues bucket_values = 6;
+
+      // Total number of distinct quasi-identifier tuple values in this bucket.
+      int64 bucket_value_count = 7;
+    }
+
+    // The intervals [min_anonymity, max_anonymity] do not overlap. If a value
+    // doesn't correspond to any such interval, the associated frequency is
+    // zero. For example, the following records:
+    //   {min_anonymity: 1, max_anonymity: 1, frequency: 17}
+    //   {min_anonymity: 2, max_anonymity: 3, frequency: 42}
+    //   {min_anonymity: 5, max_anonymity: 10, frequency: 99}
+    // mean that there are no record with an estimated anonymity of 4, 5, or
+    // larger than 10.
+    repeated KMapEstimationHistogramBucket k_map_estimation_histogram = 1;
+  }
+
+  // Result of the δ-presence computation. Note that these results are an
+  // estimation, not exact values.
+  message DeltaPresenceEstimationResult {
+    // A tuple of values for the quasi-identifier columns.
+    message DeltaPresenceEstimationQuasiIdValues {
+      // The quasi-identifier values.
+      repeated Value quasi_ids_values = 1;
+
+      // The estimated probability that a given individual sharing these
+      // quasi-identifier values is in the dataset. This value, typically called
+      // δ, is the ratio between the number of records in the dataset with these
+      // quasi-identifier values, and the total number of individuals (inside
+      // *and* outside the dataset) with these quasi-identifier values.
+      // For example, if there are 15 individuals in the dataset who share the
+      // same quasi-identifier values, and an estimated 100 people in the entire
+      // population with these values, then δ is 0.15.
+      double estimated_probability = 2;
+    }
+
+    // A DeltaPresenceEstimationHistogramBucket message with the following
+    // values:
+    //   min_probability: 0.1
+    //   max_probability: 0.2
+    //   frequency: 42
+    // means that there are 42 records for which δ is in [0.1, 0.2). An
+    // important particular case is when min_probability = max_probability = 1:
+    // then, every individual who shares this quasi-identifier combination is in
+    // the dataset.
+    message DeltaPresenceEstimationHistogramBucket {
+      // Between 0 and 1.
+      double min_probability = 1;
+
+      // Always greater than or equal to min_probability.
+      double max_probability = 2;
+
+      // Number of records within these probability bounds.
+      int64 bucket_size = 5;
+
+      // Sample of quasi-identifier tuple values in this bucket. The total
+      // number of classes returned per bucket is capped at 20.
+      repeated DeltaPresenceEstimationQuasiIdValues bucket_values = 6;
+
+      // Total number of distinct quasi-identifier tuple values in this bucket.
+      int64 bucket_value_count = 7;
+    }
+
+    // The intervals [min_probability, max_probability) do not overlap. If a
+    // value doesn't correspond to any such interval, the associated frequency
+    // is zero. For example, the following records:
+    //   {min_probability: 0, max_probability: 0.1, frequency: 17}
+    //   {min_probability: 0.2, max_probability: 0.3, frequency: 42}
+    //   {min_probability: 0.3, max_probability: 0.4, frequency: 99}
+    // mean that there are no record with an estimated probability in [0.1, 0.2)
+    // nor larger or equal to 0.4.
+    repeated DeltaPresenceEstimationHistogramBucket delta_presence_estimation_histogram = 1;
+  }
+
+  // Privacy metric to compute.
+  PrivacyMetric requested_privacy_metric = 1;
+
+  // Input dataset to compute metrics over.
+  BigQueryTable requested_source_table = 2;
+
+  // Values associated with this metric.
+  oneof result {
+    NumericalStatsResult numerical_stats_result = 3;
+
+    CategoricalStatsResult categorical_stats_result = 4;
+
+    KAnonymityResult k_anonymity_result = 5;
+
+    LDiversityResult l_diversity_result = 6;
+
+    KMapEstimationResult k_map_estimation_result = 7;
+
+    DeltaPresenceEstimationResult delta_presence_estimation_result = 9;
+  }
+}
+
+// A value of a field, including its frequency.
+message ValueFrequency {
+  // A value contained in the field in question.
+  Value value = 1;
+
+  // How many times the value is contained in the field.
+  int64 count = 2;
+}
+
+// Set of primitive values supported by the system.
+// Note that for the purposes of inspection or transformation, the number
+// of bytes considered to comprise a 'Value' is based on its representation
+// as a UTF-8 encoded string. For example, if 'integer_value' is set to
+// 123456789, the number of bytes would be counted as 9, even though an
+// int64 only holds up to 8 bytes of data.
+message Value {
+  oneof type {
+    int64 integer_value = 1;
+
+    double float_value = 2;
+
+    string string_value = 3;
+
+    bool boolean_value = 4;
+
+    google.protobuf.Timestamp timestamp_value = 5;
+
+    google.type.TimeOfDay time_value = 6;
+
+    google.type.Date date_value = 7;
+
+    google.type.DayOfWeek day_of_week_value = 8;
+  }
+}
+
+// Message for infoType-dependent details parsed from quote.
+message QuoteInfo {
+  // Object representation of the quote.
+  oneof parsed_quote {
+    // The date time indicated by the quote.
+    DateTime date_time = 2;
+  }
+}
+
+// Message for a date time object.
+// e.g. 2018-01-01, 5th August.
+message DateTime {
+  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.
+  google.type.Date date = 1;
+
+  google.type.DayOfWeek day_of_week = 2;
+
+  google.type.TimeOfDay time = 3;
+
+  TimeZone time_zone = 4;
+}
+
+// The configuration that controls how the data will change.
+message DeidentifyConfig {
+  oneof transformation {
+    // Treat the dataset as free-form text and apply the same free text
+    // transformation everywhere.
+    InfoTypeTransformations info_type_transformations = 1;
+
+    // Treat the dataset as structured. Transformations can be applied to
+    // specific locations within structured datasets, such as transforming
+    // a column within a table.
+    RecordTransformations record_transformations = 2;
+  }
+}
+
+// A rule for transforming a value.
+message PrimitiveTransformation {
+  oneof transformation {
+    ReplaceValueConfig replace_config = 1;
+
+    RedactConfig redact_config = 2;
+
+    CharacterMaskConfig character_mask_config = 3;
+
+    CryptoReplaceFfxFpeConfig crypto_replace_ffx_fpe_config = 4;
+
+    FixedSizeBucketingConfig fixed_size_bucketing_config = 5;
+
+    BucketingConfig bucketing_config = 6;
+
+    ReplaceWithInfoTypeConfig replace_with_info_type_config = 7;
+
+    TimePartConfig time_part_config = 8;
+
+    CryptoHashConfig crypto_hash_config = 9;
+
+    DateShiftConfig date_shift_config = 11;
+
+    CryptoDeterministicConfig crypto_deterministic_config = 12;
+  }
+}
+
+// For use with `Date`, `Timestamp`, and `TimeOfDay`, extract or preserve a
+// portion of the value.
+message TimePartConfig {
+  enum TimePart {
+    TIME_PART_UNSPECIFIED = 0;
+
+    // [0-9999]
+    YEAR = 1;
+
+    // [1-12]
+    MONTH = 2;
+
+    // [1-31]
+    DAY_OF_MONTH = 3;
+
+    // [1-7]
+    DAY_OF_WEEK = 4;
+
+    // [1-52]
+    WEEK_OF_YEAR = 5;
+
+    // [0-23]
+    HOUR_OF_DAY = 6;
+  }
+
+  TimePart part_to_extract = 1;
+}
+
+// Pseudonymization method that generates surrogates via cryptographic hashing.
+// Uses SHA-256.
+// The key size must be either 32 or 64 bytes.
+// Outputs a base64 encoded representation of the hashed output
+// (for example, L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=).
+// Currently, only string and integer values can be hashed.
+// See https://cloud.google.com/dlp/docs/pseudonymization to learn more.
+message CryptoHashConfig {
+  // The key used by the hash function.
+  CryptoKey crypto_key = 1;
+}
+
+// Pseudonymization method that generates deterministic encryption for the given
+// input. Outputs a base64 encoded representation of the encrypted output.
+// Uses AES-SIV based on the RFC https://tools.ietf.org/html/rfc5297.
+message CryptoDeterministicConfig {
+  // The key used by the encryption function.
+  CryptoKey crypto_key = 1;
+
+  // The custom info type to annotate the surrogate with.
+  // 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: <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
+  // will be: 'MY_TOKEN_INFO_TYPE(3):abc'
+  //
+  // This annotation identifies the surrogate when inspecting content using the
+  // custom info type 'Surrogate'. This facilitates reversal of the
+  // surrogate when it occurs in free 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
+  //
+  // - reverse a surrogate that does not correspond to an actual identifier
+  // - be unable to parse the surrogate and result in an error
+  //
+  // Therefore, choose your custom info type name carefully after considering
+  // what your data looks like. One way to select a name that has a high chance
+  // of yielding reliable detection is to include one or more unicode characters
+  // 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
+  InfoType surrogate_info_type = 2;
+
+  // Optional. 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
+  // validated against the value used during encryption. If a context was
+  // provided during encryption, same context must be provided during decryption
+  // as well.
+  //
+  // If the context is not set, plaintext would be used as is for encryption.
+  // If the context is set but:
+  //
+  // 1. there is no record present when transforming a given value or
+  // 2. the field is not present when transforming a given value,
+  //
+  // plaintext would be used as is for encryption.
+  //
+  // Note that case (1) is expected when an `InfoTypeTransformation` is
+  // applied to both structured and non-structured `ContentItem`s.
+  FieldId context = 3;
+}
+
+// Replace each input value with a given `Value`.
+message ReplaceValueConfig {
+  // Value to replace it with.
+  Value new_value = 1;
+}
+
+// Replace each matching finding with the name of the info_type.
+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 {
+
+}
+
+// Characters to skip when doing deidentification of a value. These will be left
+// alone and skipped.
+message CharsToIgnore {
+  enum CommonCharsToIgnore {
+    COMMON_CHARS_TO_IGNORE_UNSPECIFIED = 0;
+
+    // 0-9
+    NUMERIC = 1;
+
+    // A-Z
+    ALPHA_UPPER_CASE = 2;
+
+    // a-z
+    ALPHA_LOWER_CASE = 3;
+
+    // US Punctuation, one of !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
+    PUNCTUATION = 4;
+
+    // Whitespace character, one of [ \t\n\x0B\f\r]
+    WHITESPACE = 5;
+  }
+
+  oneof characters {
+    string characters_to_skip = 1;
+
+    CommonCharsToIgnore common_characters_to_ignore = 2;
+  }
+}
+
+// Partially mask a string by replacing a given number of characters with a
+// fixed character. Masking can start from the beginning or end of the string.
+// This can be used on data of any type (numbers, longs, and so on) and when
+// de-identifying structured data we'll attempt to preserve the original data's
+// 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&mdash;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.
+  string masking_character = 1;
+
+  // Number of characters to mask. If not set, all matching chars will be
+  // masked. Skipped characters do not count towards this tally.
+  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***
+  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.
+  repeated CharsToIgnore characters_to_ignore = 4;
+}
+
+// Buckets values based on fixed size ranges. The
+// Bucketing transformation can provide all of this functionality,
+// but requires more configuration. This message is provided as a convenience to
+// the user for simple bucketing strategies.
+//
+// The transformed value will be a hyphenated string of
+// <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.
+//
+// If the bound Value type differs from the type of data
+// being transformed, we will first attempt converting the type of the data to
+// be transformed to match the type of the bound before comparing.
+//
+// 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
+  // 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;
+}
+
+// Generalization function that buckets values based on ranges. The ranges and
+// replacement values are dynamically provided by the user for custom behavior,
+// such as 1-30 -> LOW 31-65 -> MEDIUM 66-100 -> HIGH
+// This can be used on
+// data of type: number, long, string, timestamp.
+// If the bound `Value` type differs from the type of data being transformed, we
+// will first attempt converting the type of the data to be transformed to match
+// the type of the bound before comparing.
+// See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more.
+message BucketingConfig {
+  // Bucket is represented as a range, along with replacement values.
+  message Bucket {
+    // Lower bound of the range, inclusive. Type should be the same as max if
+    // used.
+    Value min = 1;
+
+    // Upper bound of the range, exclusive; type must match min.
+    Value max = 2;
+
+    // Replacement value for this bucket. If not provided
+    // the default behavior will be to hyphenate the min-max range.
+    Value replacement_value = 3;
+  }
+
+  // Set of buckets. Ranges must be non-overlapping.
+  repeated Bucket buckets = 1;
+}
+
+// Replaces an identifier with a surrogate using Format Preserving Encryption
+// (FPE) with the FFX mode of operation; however when used in the
+// `ReidentifyContent` API method, it serves the opposite function by reversing
+// the surrogate back into the original identifier. The identifier must be
+// encoded as ASCII. For a given crypto key and context, the same identifier
+// will be replaced with the same surrogate. Identifiers must be at least two
+// characters long. In the case that the identifier is the empty string, it will
+// be skipped. See https://cloud.google.com/dlp/docs/pseudonymization to learn
+// more.
+//
+// Note: We recommend using  CryptoDeterministicConfig for all use cases which
+// do not require preserving the input alphabet space and size, plus warrant
+// referential integrity.
+message CryptoReplaceFfxFpeConfig {
+  // These are commonly used subsets of the alphabet that the FFX mode
+  // natively supports. In the algorithm, the alphabet is selected using
+  // the "radix". Therefore each corresponds to particular radix.
+  enum FfxCommonNativeAlphabet {
+    FFX_COMMON_NATIVE_ALPHABET_UNSPECIFIED = 0;
+
+    // [0-9] (radix of 10)
+    NUMERIC = 1;
+
+    // [0-9A-F] (radix of 16)
+    HEXADECIMAL = 2;
+
+    // [0-9A-Z] (radix of 36)
+    UPPER_CASE_ALPHA_NUMERIC = 3;
+
+    // [0-9A-Za-z] (radix of 62)
+    ALPHA_NUMERIC = 4;
+  }
+
+  // The key used by the encryption algorithm. [required]
+  CryptoKey crypto_key = 1;
+
+  // 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
+  // the context is not set, a default tweak will be used.
+  //
+  // If the context is set but:
+  //
+  // 1. there is no record present when transforming a given value or
+  // 1. the field is not present when transforming a given value,
+  //
+  // a default tweak will be used.
+  //
+  // Note that case (1) is expected when an `InfoTypeTransformation` is
+  // applied to both structured and non-structured `ContentItem`s.
+  // Currently, the referenced field may be of value type integer or string.
+  //
+  // The tweak is constructed as a sequence of bytes in big endian byte order
+  // such that:
+  //
+  // - a 64 bit integer is encoded followed by a single byte of value 1
+  // - a string is encoded in UTF-8 format followed by a single byte of value 2
+  FieldId context = 2;
+
+  oneof alphabet {
+    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].
+    // 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].
+    int32 radix = 6;
+  }
+
+  // The custom infoType to annotate the surrogate with.
+  // This annotation will be applied to the surrogate by prefixing it with
+  // the name of the custom infoType followed by the number of
+  // characters comprising the surrogate. The following scheme defines the
+  // format: info_type_name(surrogate_character_count):surrogate
+  //
+  // For example, if the name of custom infoType is 'MY_TOKEN_INFO_TYPE' and
+  // the surrogate is 'abc', the full replacement value
+  // will be: 'MY_TOKEN_INFO_TYPE(3):abc'
+  //
+  // This annotation identifies the surrogate when inspecting content using the
+  // custom infoType
+  // [`SurrogateType`](/dlp/docs/reference/rest/v2/InspectConfig#surrogatetype).
+  // This facilitates reversal of the surrogate when it occurs in free text.
+  //
+  // In order for inspection to work properly, the name of this infoType must
+  // not occur naturally anywhere in your data; otherwise, inspection may
+  // find a surrogate that does not correspond to an actual identifier.
+  // Therefore, choose your custom infoType name carefully after considering
+  // what your data looks like. One way to select a name that has a high chance
+  // of yielding reliable detection is to include one or more unicode characters
+  // 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
+  InfoType surrogate_info_type = 8;
+}
+
+// This is a data encryption key (DEK) (as opposed to
+// a key encryption key (KEK) stored by KMS).
+// When using KMS to wrap/unwrap DEKs, be sure to set an appropriate
+// IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot
+// unwrap the data crypto key.
+message CryptoKey {
+  oneof source {
+    TransientCryptoKey transient = 1;
+
+    UnwrappedCryptoKey unwrapped = 2;
+
+    KmsWrappedCryptoKey kms_wrapped = 3;
+  }
+}
+
+// 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]
+  // 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;
+}
+
+// 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;
+}
+
+// Include to use an existing data crypto key wrapped by KMS.
+// The wrapped key must be a 128/192/256 bit key.
+// Authorization requires the following IAM permissions when sending a request
+// 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;
+
+  // The resource name of the KMS CryptoKey to use for unwrapping. [required]
+  string crypto_key_name = 2;
+}
+
+// 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.
+  //
+  // For example, 3 means shift date to at most 3 days into the future.
+  // [Required]
+  int32 upper_bound_days = 1;
+
+  // For example, -5 means shift date to at most 5 days back in the past.
+  // [Required]
+  int32 lower_bound_days = 2;
+
+  // 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
+  // given context.
+  FieldId context = 3;
+
+  // Method for calculating shift that takes context into consideration. If
+  // 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.
+    CryptoKey crypto_key = 4;
+  }
+}
+
+// A type of transformation that will scan unstructured text and
+// apply various `PrimitiveTransformation`s to each finding, where the
+// transformation is applied to only values that were identified as a specific
+// info_type.
+message InfoTypeTransformations {
+  // A transformation to apply to text that is identified as a specific
+  // info_type.
+  message InfoTypeTransformation {
+    // InfoTypes to apply the transformation to. An empty list will cause
+    // this transformation to apply to all findings that correspond to
+    // infoTypes that were requested in `InspectConfig`.
+    repeated InfoType info_types = 1;
+
+    // Primitive transformation to apply to the infoType. [required]
+    PrimitiveTransformation primitive_transformation = 2;
+  }
+
+  // Transformation for each infoType. Cannot specify more than one
+  // for a given infoType. [required]
+  repeated InfoTypeTransformation transformations = 1;
+}
+
+// The transformation to apply to the field.
+message FieldTransformation {
+  // Input field(s) to apply the transformation to. [required]
+  repeated FieldId fields = 1;
+
+  // 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]
+  //
+  // Example Use Cases:
+  //
+  // - Apply a different bucket transformation to an age column if the zip code
+  // column for the same record is within a specific range.
+  // - Redact a field if the date of birth field is greater than 85.
+  RecordCondition condition = 3;
+
+  // Transformation to apply. [required]
+  oneof transformation {
+    // Apply the transformation to the entire field.
+    PrimitiveTransformation primitive_transformation = 4;
+
+    // Treat the contents of the field as free text, and selectively
+    // transform content that matches an `InfoType`.
+    InfoTypeTransformations info_type_transformations = 5;
+  }
+}
+
+// A type of transformation that is applied over structured data such as a
+// table.
+message RecordTransformations {
+  // Transform the record by applying various field transformations.
+  repeated FieldTransformation field_transformations = 1;
+
+  // Configuration defining which records get suppressed entirely. Records that
+  // match any suppression rule are omitted from the output [optional].
+  repeated RecordSuppression record_suppressions = 2;
+}
+
+// Configuration to suppress records whose suppression conditions evaluate to
+// true.
+message RecordSuppression {
+  // A condition that when it evaluates to true will result in the record being
+  // evaluated to be suppressed from the transformed content.
+  RecordCondition condition = 1;
+}
+
+// A condition for determining whether a transformation should be applied to
+// a field.
+message RecordCondition {
+  // The field type of `value` and `field` do not need to match to be
+  // considered equal, but not all comparisons are possible.
+  // EQUAL_TO and NOT_EQUAL_TO attempt to compare even with incompatible types,
+  // but all other comparisons are invalid with incompatible types.
+  // A `value` of type:
+  //
+  // - `string` can be compared against all other types
+  // - `boolean` can only be compared against other booleans
+  // - `integer` can be compared against doubles or a string if the string value
+  // can be parsed as an integer.
+  // - `double` can be compared against integers or a string if the string can
+  // be parsed as a double.
+  // - `Timestamp` can be compared against strings in RFC 3339 date string
+  // format.
+  // - `TimeOfDay` can be compared against timestamps and strings in the format
+  // of 'HH:mm:ss'.
+  //
+  // 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;
+
+    // Operator used to compare the field or infoType to the value. [required]
+    RelationalOperator operator = 3;
+
+    // Value to compare against. [Required, except for `EXISTS` tests.]
+    Value value = 4;
+  }
+
+  // A collection of conditions.
+  message Conditions {
+    repeated Condition conditions = 1;
+  }
+
+  // An expression, consisting or an operator and conditions.
+  message Expressions {
+    enum LogicalOperator {
+      LOGICAL_OPERATOR_UNSPECIFIED = 0;
+
+      AND = 1;
+    }
+
+    // The operator to apply to the result of conditions. Default and currently
+    // only supported value is `AND`.
+    LogicalOperator logical_operator = 1;
+
+    oneof type {
+      Conditions conditions = 3;
+    }
+  }
+
+  // An expression.
+  Expressions expressions = 3;
+}
+
+// Overview of the modifications that occurred.
+message TransformationOverview {
+  // Total size in bytes that were transformed in some way.
+  int64 transformed_bytes = 2;
+
+  // Transformations applied to the dataset.
+  repeated TransformationSummary transformation_summaries = 3;
+}
+
+// Summary of a single transformation.
+// Only one of 'transformation', 'field_transformation', or 'record_suppress'
+// will be set.
+message TransformationSummary {
+  // A collection that informs the user the number of times a particular
+  // `TransformationResultCode` and error details occurred.
+  message SummaryResult {
+    int64 count = 1;
+
+    TransformationResultCode code = 2;
+
+    // A place for warnings or errors to show up if a transformation didn't
+    // work as expected.
+    string details = 3;
+  }
+
+  // Possible outcomes of transformations.
+  enum TransformationResultCode {
+    TRANSFORMATION_RESULT_CODE_UNSPECIFIED = 0;
+
+    SUCCESS = 1;
+
+    ERROR = 2;
+  }
+
+  // Set if the transformation was limited to a specific InfoType.
+  InfoType info_type = 1;
+
+  // Set if the transformation was limited to a specific FieldId.
+  FieldId field = 2;
+
+  // The specific transformation these stats apply to.
+  PrimitiveTransformation transformation = 3;
+
+  // The field transformation that was applied.
+  // If multiple field transformations are requested for a single field,
+  // this list will contain all of them; otherwise, only one is supplied.
+  repeated FieldTransformation field_transformations = 5;
+
+  // The specific suppression option these stats apply to.
+  RecordSuppression record_suppress = 6;
+
+  repeated SummaryResult results = 4;
+
+  // Total size in bytes that were transformed in some way.
+  int64 transformed_bytes = 7;
+}
+
+// Schedule for triggeredJobs.
+message Schedule {
+  oneof option {
+    // With this option a job is started a regular periodic basis. For
+    // example: every day (86400 seconds).
+    //
+    // A scheduled start time will be skipped if the previous
+    // execution has not ended when its scheduled time occurs.
+    //
+    // This value must be set to a time duration greater than or equal
+    // to 1 day and can be no longer than 60 days.
+    google.protobuf.Duration recurrence_period_duration = 1;
+  }
+}
+
+// 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.
+  //
+  // 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;
+
+  // Display name (max 256 chars).
+  string display_name = 2;
+
+  // Short description (max 256 chars).
+  string description = 3;
+
+  // The creation timestamp of a inspectTemplate, output only field.
+  google.protobuf.Timestamp create_time = 4;
+
+  // The last update timestamp of a inspectTemplate, output only field.
+  google.protobuf.Timestamp update_time = 5;
+
+  // The core content of the template. Configuration of the scanning process.
+  InspectConfig inspect_config = 6;
+}
+
+// The DeidentifyTemplates contains instructions on how to deidentify content.
+// See https://cloud.google.com/dlp/docs/concepts-templates to learn more.
+message DeidentifyTemplate {
+  // The template name. Output only.
+  //
+  // 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;
+
+  // Display name (max 256 chars).
+  string display_name = 2;
+
+  // Short description (max 256 chars).
+  string description = 3;
+
+  // The creation timestamp of a inspectTemplate, output only field.
+  google.protobuf.Timestamp create_time = 4;
+
+  // The last update timestamp of a inspectTemplate, output only field.
+  google.protobuf.Timestamp update_time = 5;
+
+  // ///////////// // The core content of the template  // ///////////////
+  DeidentifyConfig deidentify_config = 6;
+}
+
+// Details information about an error encountered during job execution or
+// the results of an unsuccessful activation of the JobTrigger.
+// Output only field.
+message Error {
+  google.rpc.Status details = 1;
+
+  // The times the error occurred.
+  repeated google.protobuf.Timestamp timestamps = 2;
+}
+
+// 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 {
+  // 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;
+    }
+  }
+
+  // Whether the trigger is currently active. If PAUSED or CANCELLED, no jobs
+  // will be created with this configuration. The service may automatically
+  // pause triggers experiencing frequent errors. To restart a job, set the
+  // status to HEALTHY after correcting user errors.
+  enum Status {
+    STATUS_UNSPECIFIED = 0;
+
+    // Trigger is healthy.
+    HEALTHY = 1;
+
+    // Trigger is temporarily paused.
+    PAUSED = 2;
+
+    // Trigger is cancelled and can not be resumed.
+    CANCELLED = 3;
+  }
+
+  // Unique resource name for the triggeredJob, assigned by the service when the
+  // triggeredJob is created, for example
+  // `projects/dlp-test-project/triggeredJobs/53234423`.
+  string name = 1;
+
+  // Display name (max 100 chars)
+  string display_name = 2;
+
+  // User provided description (max 256 chars)
+  string description = 3;
+
+  // The configuration details for the specific type of job to run.
+  oneof job {
+    InspectJobConfig inspect_job = 4;
+  }
+
+  // A list of triggers which will be OR'ed together. Only one in the list
+  // needs to trigger for a job to be started. The list may contain only
+  // 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
+  // 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;
+
+  // The creation timestamp of a triggeredJob, output only field.
+  google.protobuf.Timestamp create_time = 7;
+
+  // The last update timestamp of a triggeredJob, output only field.
+  google.protobuf.Timestamp update_time = 8;
+
+  // The timestamp of the last time this trigger executed, output only field.
+  google.protobuf.Timestamp last_run_time = 9;
+
+  // A status for this trigger. [required]
+  Status status = 10;
+}
+
+// A task to execute on the completion of a job.
+// See https://cloud.google.com/dlp/docs/concepts-actions to learn more.
+message Action {
+  // If set, the detailed findings will be persisted to the specified
+  // OutputStorageConfig. Only a single instance of this action can be
+  // specified.
+  // Compatible with: Inspect, Risk
+  message SaveFindings {
+    OutputStorageConfig output_config = 1;
+  }
+
+  // Publish a message into given Pub/Sub topic when DlpJob has completed. The
+  // message contains a single field, `DlpJobName`, which is equal to the
+  // finished job's
+  // [`DlpJob.name`](/dlp/docs/reference/rest/v2/projects.dlpJobs#DlpJob).
+  // Compatible with: Inspect, Risk
+  message PublishToPubSub {
+    // Cloud Pub/Sub topic to send notifications to. The topic must have given
+    // publishing access rights to the DLP API service account executing
+    // the long running DlpJob sending the notifications.
+    // Format is projects/{project}/topics/{topic}.
+    string topic = 1;
+  }
+
+  // Publish the result summary of a DlpJob to the Cloud Security
+  // Command Center (CSCC Alpha).
+  // This action is only available for projects which are parts of
+  // an organization and whitelisted for the alpha Cloud Security Command
+  // Center.
+  // The action will publish count of finding instances and their info types.
+  // The summary of findings will be persisted in CSCC and are governed by CSCC
+  // service-specific policy, see https://cloud.google.com/terms/service-terms
+  // Only a single instance of this action can be specified.
+  // Compatible with: Inspect
+  message PublishSummaryToCscc {
+
+  }
+
+  // Publish findings of a DlpJob to Cloud Data Catalog. Labels summarizing the
+  // results of the DlpJob will be applied to the entry for the resource scanned
+  // in Cloud Data Catalog. Any labels previously written by another DlpJob will
+  // be deleted. InfoType naming patterns are strictly enforced when using this
+  // feature. Note that the findings will be persisted in Cloud Data Catalog
+  // storage and are governed by Data Catalog service-specific policy, see
+  // https://cloud.google.com/terms/service-terms
+  // Only a single instance of this action can be specified and only allowed if
+  // all resources being scanned are BigQuery tables.
+  // Compatible with: Inspect
+  message PublishFindingsToCloudDataCatalog {
+
+  }
+
+  // Enable email notification to project owners and editors on jobs's
+  // completion/failure.
+  message JobNotificationEmails {
+
+  }
+
+  oneof action {
+    // Save resulting findings in a provided location.
+    SaveFindings save_findings = 1;
+
+    // Publish a notification to a pubsub topic.
+    PublishToPubSub pub_sub = 2;
+
+    // Publish summary to Cloud Security Command Center (Alpha).
+    PublishSummaryToCscc publish_summary_to_cscc = 3;
+
+    // Publish findings to Cloud Datahub.
+    PublishFindingsToCloudDataCatalog publish_findings_to_cloud_data_catalog = 5;
+
+    // Enable email notification to project owners and editors on job's
+    // completion/failure.
+    JobNotificationEmails job_notification_emails = 8;
+  }
+}
+
+// Request message for CreateInspectTemplate.
+message CreateInspectTemplateRequest {
+  // The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id.
+  string parent = 1;
+
+  // The InspectTemplate to create.
+  InspectTemplate inspect_template = 2;
+
+  // 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;
+}
+
+// Request message for UpdateInspectTemplate.
+message UpdateInspectTemplateRequest {
+  // Resource name of organization and inspectTemplate to be updated, for
+  // example `organizations/433245324/inspectTemplates/432452342` or
+  // projects/project-id/inspectTemplates/432452342.
+  string name = 1;
+
+  // New InspectTemplate value.
+  InspectTemplate inspect_template = 2;
+
+  // Mask to control which fields get updated.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// Request message for GetInspectTemplate.
+message GetInspectTemplateRequest {
+  // 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;
+}
+
+// Request message for ListInspectTemplates.
+message ListInspectTemplatesRequest {
+  // The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id.
+  string parent = 1;
+
+  // Optional 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
+  // a page of max size 100.
+  int32 page_size = 3;
+
+  // Optional 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.
+  //
+  // Example: `name asc,update_time, create_time desc`
+  //
+  // Supported fields are:
+  //
+  // - `create_time`: corresponds to time the template was created.
+  // - `update_time`: corresponds to time the template was last updated.
+  // - `name`: corresponds to template's name.
+  // - `display_name`: corresponds to template's display name.
+  string order_by = 4;
+}
+
+// Response message for ListInspectTemplates.
+message ListInspectTemplatesResponse {
+  // List of inspectTemplates, up to page_size in ListInspectTemplatesRequest.
+  repeated InspectTemplate inspect_templates = 1;
+
+  // If the next page is available then the next page token to be used
+  // in following ListInspectTemplates request.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// Request message for CreateJobTrigger.
+message CreateJobTriggerRequest {
+  // The parent resource name, for example projects/my-project-id.
+  string parent = 1;
+
+  // The JobTrigger to create.
+  JobTrigger job_trigger = 2;
+
+  // 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;
+}
+
+// Request message for ActivateJobTrigger.
+message ActivateJobTriggerRequest {
+  // Resource name of the trigger to activate, for example
+  // `projects/dlp-test-project/jobTriggers/53234423`.
+  string name = 1;
+}
+
+// Request message for UpdateJobTrigger.
+message UpdateJobTriggerRequest {
+  // Resource name of the project and the triggeredJob, for example
+  // `projects/dlp-test-project/jobTriggers/53234423`.
+  string name = 1;
+
+  // New JobTrigger value.
+  JobTrigger job_trigger = 2;
+
+  // Mask to control which fields get updated.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// Request message for GetJobTrigger.
+message GetJobTriggerRequest {
+  // Resource name of the project and the triggeredJob, for example
+  // `projects/dlp-test-project/jobTriggers/53234423`.
+  string name = 1;
+}
+
+// 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;
+
+  // The configuration details for the specific type of job to run.
+  oneof job {
+    InspectJobConfig inspect_job = 2;
+
+    RiskAnalysisJobConfig risk_job = 3;
+  }
+
+  // The job 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 job_id = 4;
+}
+
+// Request message for ListJobTriggers.
+message ListJobTriggersRequest {
+  // The parent resource name, for example `projects/my-project-id`.
+  string parent = 1;
+
+  // Optional 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.
+  int32 page_size = 3;
+
+  // Optional 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.
+  //
+  // Example: `name asc,update_time, create_time desc`
+  //
+  // Supported fields are:
+  //
+  // - `create_time`: corresponds to time the JobTrigger was created.
+  // - `update_time`: corresponds to time the JobTrigger was last updated.
+  // - `last_run_time`: corresponds to the last time the JobTrigger ran.
+  // - `name`: corresponds to JobTrigger's name.
+  // - `display_name`: corresponds to JobTrigger's display name.
+  // - `status`: corresponds to JobTrigger's status.
+  string order_by = 4;
+
+  // Optional. 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 `<field> <operator> <value>`.
+  // * Supported fields/values for inspect jobs:
+  //     - `status` - HEALTHY|PAUSED|CANCELLED
+  //     - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
+  //     - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by
+  //     quotation marks. Nanoseconds are ignored.
+  //     - 'error_count' - Number of errors that have occurred while running.
+  // * The operator must be `=` or `!=` for status and inspected_storage.
+  //
+  // Examples:
+  //
+  // * inspected_storage = cloud_storage AND status = HEALTHY
+  // * inspected_storage = cloud_storage OR inspected_storage = bigquery
+  // * inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY)
+  // * last_run_time > \"2017-12-12T00:00:00+00:00\"
+  //
+  // The length of this field should be no more than 500 characters.
+  string filter = 5;
+}
+
+// Response message for ListJobTriggers.
+message ListJobTriggersResponse {
+  // List of triggeredJobs, up to page_size in ListJobTriggersRequest.
+  repeated JobTrigger job_triggers = 1;
+
+  // If the next page is available then the next page token to be used
+  // in following ListJobTriggers request.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteJobTrigger.
+message DeleteJobTriggerRequest {
+  // Resource name of the project and the triggeredJob, for example
+  // `projects/dlp-test-project/jobTriggers/53234423`.
+  string name = 1;
+}
+
+message InspectJobConfig {
+  // The data to scan.
+  StorageConfig storage_config = 1;
+
+  // How and what to scan for.
+  InspectConfig inspect_config = 2;
+
+  // If provided, will be used as the default for all values in InspectConfig.
+  // `inspect_config` will be merged into the values persisted as part of the
+  // template.
+  string inspect_template_name = 3;
+
+  // Actions to execute at the completion of the job.
+  repeated Action actions = 4;
+}
+
+// Combines all of the information about a DLP job.
+message DlpJob {
+  enum JobState {
+    JOB_STATE_UNSPECIFIED = 0;
+
+    // The job has not yet started.
+    PENDING = 1;
+
+    // The job is currently running.
+    RUNNING = 2;
+
+    // The job is no longer running.
+    DONE = 3;
+
+    // The job was canceled before it could complete.
+    CANCELED = 4;
+
+    // The job had an error and did not complete.
+    FAILED = 5;
+  }
+
+  // The server-assigned name.
+  string name = 1;
+
+  // The type of job.
+  DlpJobType type = 2;
+
+  // State of a job.
+  JobState state = 3;
+
+  oneof details {
+    // Results from analyzing risk of a data source.
+    AnalyzeDataSourceRiskDetails risk_details = 4;
+
+    // Results from inspecting a data source.
+    InspectDataSourceDetails inspect_details = 5;
+  }
+
+  // Time when the job was created.
+  google.protobuf.Timestamp create_time = 6;
+
+  // Time when the job started.
+  google.protobuf.Timestamp start_time = 7;
+
+  // Time when the job finished.
+  google.protobuf.Timestamp end_time = 8;
+
+  // If created by a job trigger, the resource name of the trigger that
+  // instantiated the job.
+  string job_trigger_name = 10;
+
+  // A stream of errors encountered running the job.
+  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;
+}
+
+// The request message for listing DLP jobs.
+message ListDlpJobsRequest {
+  // The parent resource name, for example projects/my-project-id.
+  string parent = 4;
+
+  // Optional. 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 `<field> <operator> <value>`.
+  // * Supported fields/values for inspect jobs:
+  //     - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
+  //     - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
+  //     - `trigger_name` - The resource name of the trigger that created job.
+  //     - 'end_time` - Corresponds to time the job finished.
+  //     - 'start_time` - Corresponds to time the job finished.
+  // * Supported fields for risk analysis jobs:
+  //     - `state` - RUNNING|CANCELED|FINISHED|FAILED
+  //     - 'end_time` - Corresponds to time the job finished.
+  //     - 'start_time` - Corresponds to time the job finished.
+  // * The operator must be `=` or `!=`.
+  //
+  // Examples:
+  //
+  // * inspected_storage = cloud_storage AND state = done
+  // * inspected_storage = cloud_storage OR inspected_storage = bigquery
+  // * inspected_storage = cloud_storage AND (state = done OR state = canceled)
+  // * end_time > \"2017-12-12T00:00:00+00:00\"
+  //
+  // The length of this field should be no more than 500 characters.
+  string filter = 1;
+
+  // The standard list page size.
+  int32 page_size = 2;
+
+  // The standard list page token.
+  string page_token = 3;
+
+  // The type of job. Defaults to `DlpJobType.INSPECT`
+  DlpJobType type = 5;
+
+  // Optional 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.
+  //
+  // Example: `name asc, end_time asc, create_time desc`
+  //
+  // Supported fields are:
+  //
+  // - `create_time`: corresponds to time the job was created.
+  // - `end_time`: corresponds to time the job ended.
+  // - `name`: corresponds to job's name.
+  // - `state`: corresponds to `state`
+  string order_by = 6;
+}
+
+// The response message for listing DLP jobs.
+message ListDlpJobsResponse {
+  // A list of DlpJobs that matches the specified filter in the request.
+  repeated DlpJob jobs = 1;
+
+  // The standard List next-page token.
+  string next_page_token = 2;
+}
+
+// The request message for canceling a DLP job.
+message CancelDlpJobRequest {
+  // The name of the DlpJob resource to be cancelled.
+  string name = 1;
+}
+
+// The request message for deleting a DLP job.
+message DeleteDlpJobRequest {
+  // The name of the DlpJob resource to be deleted.
+  string name = 1;
+}
+
+// Request message for CreateDeidentifyTemplate.
+message CreateDeidentifyTemplateRequest {
+  // The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id.
+  string parent = 1;
+
+  // The DeidentifyTemplate to create.
+  DeidentifyTemplate deidentify_template = 2;
+
+  // 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;
+}
+
+// Request message for UpdateDeidentifyTemplate.
+message UpdateDeidentifyTemplateRequest {
+  // 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;
+
+  // New DeidentifyTemplate value.
+  DeidentifyTemplate deidentify_template = 2;
+
+  // Mask to control which fields get updated.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// 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;
+}
+
+// Request message for ListDeidentifyTemplates.
+message ListDeidentifyTemplatesRequest {
+  // The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id.
+  string parent = 1;
+
+  // Optional 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
+  // a page of max size 100.
+  int32 page_size = 3;
+
+  // Optional 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.
+  //
+  // Example: `name asc,update_time, create_time desc`
+  //
+  // Supported fields are:
+  //
+  // - `create_time`: corresponds to time the template was created.
+  // - `update_time`: corresponds to time the template was last updated.
+  // - `name`: corresponds to template's name.
+  // - `display_name`: corresponds to template's display name.
+  string order_by = 4;
+}
+
+// Response message for ListDeidentifyTemplates.
+message ListDeidentifyTemplatesResponse {
+  // List of deidentify templates, up to page_size in
+  // ListDeidentifyTemplatesRequest.
+  repeated DeidentifyTemplate deidentify_templates = 1;
+
+  // If the next page is available then the next page token to be used
+  // in following ListDeidentifyTemplates request.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteDeidentifyTemplate.
+message DeleteDeidentifyTemplateRequest {
+  // 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;
+}
+
+// Configuration for a custom dictionary created from a data source of any size
+// up to the maximum size defined in the
+// [limits](https://cloud.google.com/dlp/limits) page. The artifacts of
+// dictionary creation are stored in the specified Google Cloud Storage
+// location. Consider using `CustomInfoType.Dictionary` for smaller dictionaries
+// that satisfy the size requirements.
+message LargeCustomDictionaryConfig {
+  // Location to store dictionary artifacts in Google Cloud Storage. These files
+  // will only be accessible by project owners and the DLP API. If any of these
+  // artifacts are modified, the dictionary is considered invalid and can no
+  // longer be used.
+  CloudStoragePath output_path = 1;
+
+  oneof source {
+    // Set of files containing newline-delimited lists of dictionary phrases.
+    CloudStorageFileSet cloud_storage_file_set = 2;
+
+    // Field in a BigQuery table where each cell represents a dictionary phrase.
+    BigQueryField big_query_field = 3;
+  }
+}
+
+// Summary statistics of a custom dictionary.
+message LargeCustomDictionaryStats {
+  // Approximate number of distinct phrases in the dictionary.
+  int64 approx_num_phrases = 1;
+}
+
+// Configuration for a StoredInfoType.
+message StoredInfoTypeConfig {
+  // Display name of the StoredInfoType (max 256 characters).
+  string display_name = 1;
+
+  // Description of the StoredInfoType (max 256 characters).
+  string description = 2;
+
+  oneof type {
+    // StoredInfoType where findings are defined by a dictionary of phrases.
+    LargeCustomDictionaryConfig large_custom_dictionary = 3;
+  }
+}
+
+// Statistics for a StoredInfoType.
+message StoredInfoTypeStats {
+  oneof type {
+    // StoredInfoType where findings are defined by a dictionary of phrases.
+    LargeCustomDictionaryStats large_custom_dictionary = 1;
+  }
+}
+
+// Version of a StoredInfoType, including the configuration used to build it,
+// create timestamp, and current state.
+message StoredInfoTypeVersion {
+  // StoredInfoType configuration.
+  StoredInfoTypeConfig config = 1;
+
+  // Create timestamp of the version. Read-only, determined by the system
+  // when the version is created.
+  google.protobuf.Timestamp create_time = 2;
+
+  // Stored info type version state. Read-only, updated by the system
+  // during dictionary creation.
+  StoredInfoTypeState state = 3;
+
+  // Errors that occurred when creating this storedInfoType version, or
+  // 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.
+  // <p>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.
+  // <p>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.
+  repeated Error errors = 4;
+
+  // Statistics about this storedInfoType version.
+  StoredInfoTypeStats stats = 5;
+}
+
+// StoredInfoType resource message that contains information about the current
+// version and any pending updates.
+message StoredInfoType {
+  // Resource name.
+  string name = 1;
+
+  // Current version of the stored info type.
+  StoredInfoTypeVersion current_version = 2;
+
+  // Pending versions of the stored info type. Empty if no versions are
+  // pending.
+  repeated StoredInfoTypeVersion pending_versions = 3;
+}
+
+// Request message for CreateStoredInfoType.
+message CreateStoredInfoTypeRequest {
+  // The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id.
+  string parent = 1;
+
+  // Configuration of the storedInfoType to create.
+  StoredInfoTypeConfig config = 2;
+
+  // 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;
+}
+
+// Request message for UpdateStoredInfoType.
+message UpdateStoredInfoTypeRequest {
+  // Resource name of organization and storedInfoType to be updated, for
+  // example `organizations/433245324/storedInfoTypes/432452342` or
+  // projects/project-id/storedInfoTypes/432452342.
+  string name = 1;
+
+  // Updated configuration for the storedInfoType. If not provided, a new
+  // version of the storedInfoType will be created with the existing
+  // configuration.
+  StoredInfoTypeConfig config = 2;
+
+  // Mask to control which fields get updated.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// Request message for GetStoredInfoType.
+message GetStoredInfoTypeRequest {
+  // 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;
+}
+
+// Request message for ListStoredInfoTypes.
+message ListStoredInfoTypesRequest {
+  // The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id.
+  string parent = 1;
+
+  // Optional 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
+  // a page of max size 100.
+  int32 page_size = 3;
+
+  // Optional 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.
+  //
+  // Example: `name asc, display_name, create_time desc`
+  //
+  // Supported fields are:
+  //
+  // - `create_time`: corresponds to time the most recent version of the
+  // resource was created.
+  // - `state`: corresponds to the state of the resource.
+  // - `name`: corresponds to resource name.
+  // - `display_name`: corresponds to info type's display name.
+  string order_by = 4;
+}
+
+// Response message for ListStoredInfoTypes.
+message ListStoredInfoTypesResponse {
+  // List of storedInfoTypes, up to page_size in ListStoredInfoTypesRequest.
+  repeated StoredInfoType stored_info_types = 1;
+
+  // If the next page is available then the next page token to be used
+  // in following ListStoredInfoTypes request.
+  string next_page_token = 2;
+}
+
+// Request message for DeleteStoredInfoType.
+message DeleteStoredInfoTypeRequest {
+  // 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;
+}
+
+// An enum to represent the various type of DLP jobs.
+enum DlpJobType {
+  DLP_JOB_TYPE_UNSPECIFIED = 0;
+
+  // The job inspected Google Cloud for sensitive data.
+  INSPECT_JOB = 1;
+
+  // The job executed a Risk Analysis computation.
+  RISK_ANALYSIS_JOB = 2;
+}
+
+// State of a StoredInfoType version.
+enum StoredInfoTypeState {
+  STORED_INFO_TYPE_STATE_UNSPECIFIED = 0;
+
+  // StoredInfoType version is being created.
+  PENDING = 1;
+
+  // StoredInfoType version is ready for use.
+  READY = 2;
+
+  // StoredInfoType creation failed. All relevant error messages are returned in
+  // the `StoredInfoTypeVersion` message.
+  FAILED = 3;
+
+  // StoredInfoType is no longer valid because artifacts stored in
+  // user-controlled storage were modified. To fix an invalid StoredInfoType,
+  // use the `UpdateStoredInfoType` method to create a new version.
+  INVALID = 4;
+}
diff --git a/dlp/google/cloud/dlp_v2/proto/dlp_pb2.py b/dlp/google/cloud/dlp_v2/proto/dlp_pb2.py
new file mode 100644
index 000000000000..793c7267f74d
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/proto/dlp_pb2.py
@@ -0,0 +1,17652 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/privacy/dlp_v2/proto/dlp.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.dlp_v2.proto import (
+    storage_pb2 as google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.type import date_pb2 as google_dot_type_dot_date__pb2
+from google.type import dayofweek_pb2 as google_dot_type_dot_dayofweek__pb2
+from google.type import timeofday_pb2 as google_dot_type_dot_timeofday__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/privacy/dlp_v2/proto/dlp.proto",
+    package="google.privacy.dlp.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.privacy.dlp.v2B\010DlpProtoP\001Z8google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp\252\002\023Google.Cloud.Dlp.V2\312\002\023Google\\Cloud\\Dlp\\V2"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/privacy/dlp_v2/proto/dlp.proto\x12\x15google.privacy.dlp.v2\x1a\x1cgoogle/api/annotations.proto\x1a/google/cloud/privacy/dlp_v2/proto/storage.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x16google/type/date.proto\x1a\x1bgoogle/type/dayofweek.proto\x1a\x1bgoogle/type/timeofday.proto\x1a\x17google/api/client.proto"G\n\x10\x45xcludeInfoTypes\x12\x33\n\ninfo_types\x18\x01 \x03(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType"\xa0\x02\n\rExclusionRule\x12\x46\n\ndictionary\x18\x01 \x01(\x0b\x32\x30.google.privacy.dlp.v2.CustomInfoType.DictionaryH\x00\x12<\n\x05regex\x18\x02 \x01(\x0b\x32+.google.privacy.dlp.v2.CustomInfoType.RegexH\x00\x12\x45\n\x12\x65xclude_info_types\x18\x03 \x01(\x0b\x32\'.google.privacy.dlp.v2.ExcludeInfoTypesH\x00\x12:\n\rmatching_type\x18\x04 \x01(\x0e\x32#.google.privacy.dlp.v2.MatchingTypeB\x06\n\x04type"\xb1\x01\n\x0eInspectionRule\x12W\n\x0chotword_rule\x18\x01 \x01(\x0b\x32?.google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRuleH\x00\x12>\n\x0e\x65xclusion_rule\x18\x02 \x01(\x0b\x32$.google.privacy.dlp.v2.ExclusionRuleH\x00\x42\x06\n\x04type"~\n\x11InspectionRuleSet\x12\x33\n\ninfo_types\x18\x01 \x03(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12\x34\n\x05rules\x18\x02 \x03(\x0b\x32%.google.privacy.dlp.v2.InspectionRule"\xc7\x05\n\rInspectConfig\x12\x33\n\ninfo_types\x18\x01 \x03(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12\x39\n\x0emin_likelihood\x18\x02 \x01(\x0e\x32!.google.privacy.dlp.v2.Likelihood\x12\x42\n\x06limits\x18\x03 \x01(\x0b\x32\x32.google.privacy.dlp.v2.InspectConfig.FindingLimits\x12\x15\n\rinclude_quote\x18\x04 \x01(\x08\x12\x1a\n\x12\x65xclude_info_types\x18\x05 \x01(\x08\x12@\n\x11\x63ustom_info_types\x18\x06 \x03(\x0b\x32%.google.privacy.dlp.v2.CustomInfoType\x12=\n\x0f\x63ontent_options\x18\x08 \x03(\x0e\x32$.google.privacy.dlp.v2.ContentOption\x12:\n\x08rule_set\x18\n \x03(\x0b\x32(.google.privacy.dlp.v2.InspectionRuleSet\x1a\x91\x02\n\rFindingLimits\x12\x1d\n\x15max_findings_per_item\x18\x01 \x01(\x05\x12 \n\x18max_findings_per_request\x18\x02 \x01(\x05\x12\x64\n\x1amax_findings_per_info_type\x18\x03 \x03(\x0b\x32@.google.privacy.dlp.v2.InspectConfig.FindingLimits.InfoTypeLimit\x1aY\n\rInfoTypeLimit\x12\x32\n\tinfo_type\x18\x01 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12\x14\n\x0cmax_findings\x18\x02 \x01(\x05"\xea\x01\n\x0f\x42yteContentItem\x12>\n\x04type\x18\x01 \x01(\x0e\x32\x30.google.privacy.dlp.v2.ByteContentItem.BytesType\x12\x0c\n\x04\x64\x61ta\x18\x02 \x01(\x0c"\x88\x01\n\tBytesType\x12\x1a\n\x16\x42YTES_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05IMAGE\x10\x06\x12\x0e\n\nIMAGE_JPEG\x10\x01\x12\r\n\tIMAGE_BMP\x10\x02\x12\r\n\tIMAGE_PNG\x10\x03\x12\r\n\tIMAGE_SVG\x10\x04\x12\r\n\tTEXT_UTF8\x10\x05\x12\x08\n\x04\x41VRO\x10\x0b"\x97\x01\n\x0b\x43ontentItem\x12\x0f\n\x05value\x18\x03 \x01(\tH\x00\x12-\n\x05table\x18\x04 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.TableH\x00\x12;\n\tbyte_item\x18\x05 \x01(\x0b\x32&.google.privacy.dlp.v2.ByteContentItemH\x00\x42\x0b\n\tdata_item"\x9d\x01\n\x05Table\x12/\n\x07headers\x18\x01 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12.\n\x04rows\x18\x02 \x03(\x0b\x32 .google.privacy.dlp.v2.Table.Row\x1a\x33\n\x03Row\x12,\n\x06values\x18\x01 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Value"]\n\rInspectResult\x12\x30\n\x08\x66indings\x18\x01 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.Finding\x12\x1a\n\x12\x66indings_truncated\x18\x02 \x01(\x08"\x9d\x02\n\x07\x46inding\x12\r\n\x05quote\x18\x01 \x01(\t\x12\x32\n\tinfo_type\x18\x02 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12\x35\n\nlikelihood\x18\x03 \x01(\x0e\x32!.google.privacy.dlp.v2.Likelihood\x12\x31\n\x08location\x18\x04 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.Location\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\nquote_info\x18\x07 \x01(\x0b\x32 .google.privacy.dlp.v2.QuoteInfo"\xb6\x01\n\x08Location\x12\x30\n\nbyte_range\x18\x01 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Range\x12\x35\n\x0f\x63odepoint_range\x18\x02 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Range\x12\x41\n\x11\x63ontent_locations\x18\x07 \x03(\x0b\x32&.google.privacy.dlp.v2.ContentLocation"\xd1\x02\n\x0f\x43ontentLocation\x12\x16\n\x0e\x63ontainer_name\x18\x01 \x01(\t\x12@\n\x0frecord_location\x18\x02 \x01(\x0b\x32%.google.privacy.dlp.v2.RecordLocationH\x00\x12>\n\x0eimage_location\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.ImageLocationH\x00\x12\x44\n\x11\x64ocument_location\x18\x05 \x01(\x0b\x32\'.google.privacy.dlp.v2.DocumentLocationH\x00\x12\x37\n\x13\x63ontainer_timestamp\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x19\n\x11\x63ontainer_version\x18\x07 \x01(\tB\n\n\x08location"\'\n\x10\x44ocumentLocation\x12\x13\n\x0b\x66ile_offset\x18\x01 \x01(\x03"\xb6\x01\n\x0eRecordLocation\x12\x34\n\nrecord_key\x18\x01 \x01(\x0b\x32 .google.privacy.dlp.v2.RecordKey\x12\x30\n\x08\x66ield_id\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12<\n\x0etable_location\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.TableLocation""\n\rTableLocation\x12\x11\n\trow_index\x18\x01 \x01(\x03"#\n\x05Range\x12\r\n\x05start\x18\x01 \x01(\x03\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x03"K\n\rImageLocation\x12:\n\x0e\x62ounding_boxes\x18\x01 \x03(\x0b\x32".google.privacy.dlp.v2.BoundingBox"G\n\x0b\x42oundingBox\x12\x0b\n\x03top\x18\x01 \x01(\x05\x12\x0c\n\x04left\x18\x02 \x01(\x05\x12\r\n\x05width\x18\x03 \x01(\x05\x12\x0e\n\x06height\x18\x04 \x01(\x05"\xc3\x03\n\x12RedactImageRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x0einspect_config\x18\x02 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectConfig\x12_\n\x17image_redaction_configs\x18\x05 \x03(\x0b\x32>.google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig\x12\x18\n\x10include_findings\x18\x06 \x01(\x08\x12\x39\n\tbyte_item\x18\x07 \x01(\x0b\x32&.google.privacy.dlp.v2.ByteContentItem\x1a\xa8\x01\n\x14ImageRedactionConfig\x12\x34\n\tinfo_type\x18\x01 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoTypeH\x00\x12\x19\n\x0fredact_all_text\x18\x02 \x01(\x08H\x00\x12\x35\n\x0fredaction_color\x18\x03 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.ColorB\x08\n\x06target"1\n\x05\x43olor\x12\x0b\n\x03red\x18\x01 \x01(\x02\x12\r\n\x05green\x18\x02 \x01(\x02\x12\x0c\n\x04\x62lue\x18\x03 \x01(\x02"\x83\x01\n\x13RedactImageResponse\x12\x16\n\x0eredacted_image\x18\x01 \x01(\x0c\x12\x16\n\x0e\x65xtracted_text\x18\x02 \x01(\t\x12<\n\x0einspect_result\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectResult"\x9f\x02\n\x18\x44\x65identifyContentRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x42\n\x11\x64\x65identify_config\x18\x02 \x01(\x0b\x32\'.google.privacy.dlp.v2.DeidentifyConfig\x12<\n\x0einspect_config\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectConfig\x12\x30\n\x04item\x18\x04 \x01(\x0b\x32".google.privacy.dlp.v2.ContentItem\x12\x1d\n\x15inspect_template_name\x18\x05 \x01(\t\x12 \n\x18\x64\x65identify_template_name\x18\x06 \x01(\t"\x8e\x01\n\x19\x44\x65identifyContentResponse\x12\x30\n\x04item\x18\x01 \x01(\x0b\x32".google.privacy.dlp.v2.ContentItem\x12?\n\x08overview\x18\x02 \x01(\x0b\x32-.google.privacy.dlp.v2.TransformationOverview"\x9f\x02\n\x18ReidentifyContentRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x42\n\x11reidentify_config\x18\x02 \x01(\x0b\x32\'.google.privacy.dlp.v2.DeidentifyConfig\x12<\n\x0einspect_config\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectConfig\x12\x30\n\x04item\x18\x04 \x01(\x0b\x32".google.privacy.dlp.v2.ContentItem\x12\x1d\n\x15inspect_template_name\x18\x05 \x01(\t\x12 \n\x18reidentify_template_name\x18\x06 \x01(\t"\x8e\x01\n\x19ReidentifyContentResponse\x12\x30\n\x04item\x18\x01 \x01(\x0b\x32".google.privacy.dlp.v2.ContentItem\x12?\n\x08overview\x18\x02 \x01(\x0b\x32-.google.privacy.dlp.v2.TransformationOverview"\xb6\x01\n\x15InspectContentRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x0einspect_config\x18\x02 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectConfig\x12\x30\n\x04item\x18\x03 \x01(\x0b\x32".google.privacy.dlp.v2.ContentItem\x12\x1d\n\x15inspect_template_name\x18\x04 \x01(\t"N\n\x16InspectContentResponse\x12\x34\n\x06result\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectResult"\xb7\x02\n\x13OutputStorageConfig\x12\x35\n\x05table\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTableH\x00\x12N\n\routput_schema\x18\x03 \x01(\x0e\x32\x37.google.privacy.dlp.v2.OutputStorageConfig.OutputSchema"\x90\x01\n\x0cOutputSchema\x12\x1d\n\x19OUTPUT_SCHEMA_UNSPECIFIED\x10\x00\x12\x11\n\rBASIC_COLUMNS\x10\x01\x12\x0f\n\x0bGCS_COLUMNS\x10\x02\x12\x15\n\x11\x44\x41TASTORE_COLUMNS\x10\x03\x12\x15\n\x11\x42IG_QUERY_COLUMNS\x10\x04\x12\x0f\n\x0b\x41LL_COLUMNS\x10\x05\x42\x06\n\x04type"R\n\rInfoTypeStats\x12\x32\n\tinfo_type\x18\x01 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12\r\n\x05\x63ount\x18\x02 \x01(\x03"\xdd\x03\n\x18InspectDataSourceDetails\x12[\n\x11requested_options\x18\x02 \x01(\x0b\x32@.google.privacy.dlp.v2.InspectDataSourceDetails.RequestedOptions\x12\x46\n\x06result\x18\x03 \x01(\x0b\x32\x36.google.privacy.dlp.v2.InspectDataSourceDetails.Result\x1a\x9a\x01\n\x10RequestedOptions\x12I\n\x19snapshot_inspect_template\x18\x01 \x01(\x0b\x32&.google.privacy.dlp.v2.InspectTemplate\x12;\n\njob_config\x18\x03 \x01(\x0b\x32\'.google.privacy.dlp.v2.InspectJobConfig\x1a\x7f\n\x06Result\x12\x17\n\x0fprocessed_bytes\x18\x01 \x01(\x03\x12\x1d\n\x15total_estimated_bytes\x18\x02 \x01(\x03\x12=\n\x0finfo_type_stats\x18\x03 \x03(\x0b\x32$.google.privacy.dlp.v2.InfoTypeStats"\x90\x01\n\x13InfoTypeDescription\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12@\n\x0csupported_by\x18\x03 \x03(\x0e\x32*.google.privacy.dlp.v2.InfoTypeSupportedBy\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t"=\n\x14ListInfoTypesRequest\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t"W\n\x15ListInfoTypesResponse\x12>\n\ninfo_types\x18\x01 \x03(\x0b\x32*.google.privacy.dlp.v2.InfoTypeDescription"\xc1\x01\n\x15RiskAnalysisJobConfig\x12<\n\x0eprivacy_metric\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.PrivacyMetric\x12:\n\x0csource_table\x18\x02 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12.\n\x07\x61\x63tions\x18\x03 \x03(\x0b\x32\x1d.google.privacy.dlp.v2.Action"\xb7\x01\n\x07QuasiId\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x34\n\tinfo_type\x18\x02 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoTypeH\x00\x12\x14\n\ncustom_tag\x18\x03 \x01(\tH\x00\x12*\n\x08inferred\x18\x04 \x01(\x0b\x32\x16.google.protobuf.EmptyH\x00\x42\x05\n\x03tag"\xaf\x02\n\x10StatisticalTable\x12\x33\n\x05table\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12O\n\tquasi_ids\x18\x01 \x03(\x0b\x32<.google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField\x12:\n\x12relative_frequency\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x1aY\n\x14QuasiIdentifierField\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x12\n\ncustom_tag\x18\x02 \x01(\t"\xf5\x0e\n\rPrivacyMetric\x12[\n\x16numerical_stats_config\x18\x01 \x01(\x0b\x32\x39.google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfigH\x00\x12_\n\x18\x63\x61tegorical_stats_config\x18\x02 \x01(\x0b\x32;.google.privacy.dlp.v2.PrivacyMetric.CategoricalStatsConfigH\x00\x12S\n\x12k_anonymity_config\x18\x03 \x01(\x0b\x32\x35.google.privacy.dlp.v2.PrivacyMetric.KAnonymityConfigH\x00\x12S\n\x12l_diversity_config\x18\x04 \x01(\x0b\x32\x35.google.privacy.dlp.v2.PrivacyMetric.LDiversityConfigH\x00\x12\\\n\x17k_map_estimation_config\x18\x05 \x01(\x0b\x32\x39.google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfigH\x00\x12n\n delta_presence_estimation_config\x18\x06 \x01(\x0b\x32\x42.google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfigH\x00\x1a\x45\n\x14NumericalStatsConfig\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x1aG\n\x16\x43\x61tegoricalStatsConfig\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x1ay\n\x10KAnonymityConfig\x12\x31\n\tquasi_ids\x18\x01 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x32\n\tentity_id\x18\x02 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.EntityId\x1a\x82\x01\n\x10LDiversityConfig\x12\x31\n\tquasi_ids\x18\x01 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12;\n\x13sensitive_attribute\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x1a\xe8\x05\n\x14KMapEstimationConfig\x12X\n\tquasi_ids\x18\x01 \x03(\x0b\x32\x45.google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField\x12\x13\n\x0bregion_code\x18\x02 \x01(\t\x12\x62\n\x10\x61uxiliary_tables\x18\x03 \x03(\x0b\x32H.google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable\x1a\xbb\x01\n\x0bTaggedField\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x34\n\tinfo_type\x18\x02 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoTypeH\x00\x12\x14\n\ncustom_tag\x18\x03 \x01(\tH\x00\x12*\n\x08inferred\x18\x04 \x01(\x0b\x32\x16.google.protobuf.EmptyH\x00\x42\x05\n\x03tag\x1a\xbe\x02\n\x0e\x41uxiliaryTable\x12\x33\n\x05table\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12h\n\tquasi_ids\x18\x01 \x03(\x0b\x32U.google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField\x12:\n\x12relative_frequency\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x1aQ\n\x0cQuasiIdField\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x12\n\ncustom_tag\x18\x02 \x01(\t\x1a\xaa\x01\n\x1d\x44\x65ltaPresenceEstimationConfig\x12\x31\n\tquasi_ids\x18\x01 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.QuasiId\x12\x13\n\x0bregion_code\x18\x02 \x01(\t\x12\x41\n\x10\x61uxiliary_tables\x18\x03 \x03(\x0b\x32\'.google.privacy.dlp.v2.StatisticalTableB\x06\n\x04type"\xf2\x1d\n\x1c\x41nalyzeDataSourceRiskDetails\x12\x46\n\x18requested_privacy_metric\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.PrivacyMetric\x12\x44\n\x16requested_source_table\x18\x02 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12j\n\x16numerical_stats_result\x18\x03 \x01(\x0b\x32H.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResultH\x00\x12n\n\x18\x63\x61tegorical_stats_result\x18\x04 \x01(\x0b\x32J.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResultH\x00\x12\x62\n\x12k_anonymity_result\x18\x05 \x01(\x0b\x32\x44.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResultH\x00\x12\x62\n\x12l_diversity_result\x18\x06 \x01(\x0b\x32\x44.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResultH\x00\x12k\n\x17k_map_estimation_result\x18\x07 \x01(\x0b\x32H.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResultH\x00\x12}\n delta_presence_estimation_result\x18\t \x01(\x0b\x32Q.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResultH\x00\x1a\xaf\x01\n\x14NumericalStatsResult\x12/\n\tmin_value\x18\x01 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12/\n\tmax_value\x18\x02 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x35\n\x0fquantile_values\x18\x04 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x1a\x8d\x03\n\x16\x43\x61tegoricalStatsResult\x12\x95\x01\n!value_frequency_histogram_buckets\x18\x05 \x03(\x0b\x32j.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket\x1a\xda\x01\n\x1f\x43\x61tegoricalStatsHistogramBucket\x12#\n\x1bvalue_frequency_lower_bound\x18\x01 \x01(\x03\x12#\n\x1bvalue_frequency_upper_bound\x18\x02 \x01(\x03\x12\x13\n\x0b\x62ucket_size\x18\x03 \x01(\x03\x12<\n\rbucket_values\x18\x04 \x03(\x0b\x32%.google.privacy.dlp.v2.ValueFrequency\x12\x1a\n\x12\x62ucket_value_count\x18\x05 \x01(\x03\x1a\xb5\x04\n\x10KAnonymityResult\x12\x8b\x01\n#equivalence_class_histogram_buckets\x18\x05 \x03(\x0b\x32^.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket\x1at\n\x1aKAnonymityEquivalenceClass\x12\x36\n\x10quasi_ids_values\x18\x01 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x1e\n\x16\x65quivalence_class_size\x18\x02 \x01(\x03\x1a\x9c\x02\n\x19KAnonymityHistogramBucket\x12*\n"equivalence_class_size_lower_bound\x18\x01 \x01(\x03\x12*\n"equivalence_class_size_upper_bound\x18\x02 \x01(\x03\x12\x13\n\x0b\x62ucket_size\x18\x03 \x01(\x03\x12v\n\rbucket_values\x18\x04 \x03(\x0b\x32_.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityEquivalenceClass\x12\x1a\n\x12\x62ucket_value_count\x18\x05 \x01(\x03\x1a\xb0\x05\n\x10LDiversityResult\x12\x93\x01\n+sensitive_value_frequency_histogram_buckets\x18\x05 \x03(\x0b\x32^.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket\x1a\xe0\x01\n\x1aLDiversityEquivalenceClass\x12\x36\n\x10quasi_ids_values\x18\x01 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x1e\n\x16\x65quivalence_class_size\x18\x02 \x01(\x03\x12%\n\x1dnum_distinct_sensitive_values\x18\x03 \x01(\x03\x12\x43\n\x14top_sensitive_values\x18\x04 \x03(\x0b\x32%.google.privacy.dlp.v2.ValueFrequency\x1a\xa2\x02\n\x19LDiversityHistogramBucket\x12-\n%sensitive_value_frequency_lower_bound\x18\x01 \x01(\x03\x12-\n%sensitive_value_frequency_upper_bound\x18\x02 \x01(\x03\x12\x13\n\x0b\x62ucket_size\x18\x03 \x01(\x03\x12v\n\rbucket_values\x18\x04 \x03(\x0b\x32_.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass\x12\x1a\n\x12\x62ucket_value_count\x18\x05 \x01(\x03\x1a\x95\x04\n\x14KMapEstimationResult\x12\x8a\x01\n\x1ak_map_estimation_histogram\x18\x01 \x03(\x0b\x32\x66.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket\x1ar\n\x1bKMapEstimationQuasiIdValues\x12\x36\n\x10quasi_ids_values\x18\x01 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x1b\n\x13\x65stimated_anonymity\x18\x02 \x01(\x03\x1a\xfb\x01\n\x1dKMapEstimationHistogramBucket\x12\x15\n\rmin_anonymity\x18\x01 \x01(\x03\x12\x15\n\rmax_anonymity\x18\x02 \x01(\x03\x12\x13\n\x0b\x62ucket_size\x18\x05 \x01(\x03\x12{\n\rbucket_values\x18\x06 \x03(\x0b\x32\x64.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues\x12\x1a\n\x12\x62ucket_value_count\x18\x07 \x01(\x03\x1a\xe4\x04\n\x1d\x44\x65ltaPresenceEstimationResult\x12\xa5\x01\n#delta_presence_estimation_histogram\x18\x01 \x03(\x0b\x32x.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket\x1a}\n$DeltaPresenceEstimationQuasiIdValues\x12\x36\n\x10quasi_ids_values\x18\x01 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x1d\n\x15\x65stimated_probability\x18\x02 \x01(\x01\x1a\x9b\x02\n&DeltaPresenceEstimationHistogramBucket\x12\x17\n\x0fmin_probability\x18\x01 \x01(\x01\x12\x17\n\x0fmax_probability\x18\x02 \x01(\x01\x12\x13\n\x0b\x62ucket_size\x18\x05 \x01(\x03\x12\x8d\x01\n\rbucket_values\x18\x06 \x03(\x0b\x32v.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues\x12\x1a\n\x12\x62ucket_value_count\x18\x07 \x01(\x03\x42\x08\n\x06result"L\n\x0eValueFrequency\x12+\n\x05value\x18\x01 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\r\n\x05\x63ount\x18\x02 \x01(\x03"\xb3\x02\n\x05Value\x12\x17\n\rinteger_value\x18\x01 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x17\n\rboolean_value\x18\x04 \x01(\x08H\x00\x12\x35\n\x0ftimestamp_value\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12,\n\ntime_value\x18\x06 \x01(\x0b\x32\x16.google.type.TimeOfDayH\x00\x12\'\n\ndate_value\x18\x07 \x01(\x0b\x32\x11.google.type.DateH\x00\x12\x33\n\x11\x64\x61y_of_week_value\x18\x08 \x01(\x0e\x32\x16.google.type.DayOfWeekH\x00\x42\x06\n\x04type"Q\n\tQuoteInfo\x12\x34\n\tdate_time\x18\x02 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.DateTimeH\x00\x42\x0e\n\x0cparsed_quote"\xdf\x01\n\x08\x44\x61teTime\x12\x1f\n\x04\x64\x61te\x18\x01 \x01(\x0b\x32\x11.google.type.Date\x12+\n\x0b\x64\x61y_of_week\x18\x02 \x01(\x0e\x32\x16.google.type.DayOfWeek\x12$\n\x04time\x18\x03 \x01(\x0b\x32\x16.google.type.TimeOfDay\x12;\n\ttime_zone\x18\x04 \x01(\x0b\x32(.google.privacy.dlp.v2.DateTime.TimeZone\x1a"\n\x08TimeZone\x12\x16\n\x0eoffset_minutes\x18\x01 \x01(\x05"\xc9\x01\n\x10\x44\x65identifyConfig\x12S\n\x19info_type_transformations\x18\x01 \x01(\x0b\x32..google.privacy.dlp.v2.InfoTypeTransformationsH\x00\x12N\n\x16record_transformations\x18\x02 \x01(\x0b\x32,.google.privacy.dlp.v2.RecordTransformationsH\x00\x42\x10\n\x0etransformation"\xf5\x06\n\x17PrimitiveTransformation\x12\x43\n\x0ereplace_config\x18\x01 \x01(\x0b\x32).google.privacy.dlp.v2.ReplaceValueConfigH\x00\x12<\n\rredact_config\x18\x02 \x01(\x0b\x32#.google.privacy.dlp.v2.RedactConfigH\x00\x12K\n\x15\x63haracter_mask_config\x18\x03 \x01(\x0b\x32*.google.privacy.dlp.v2.CharacterMaskConfigH\x00\x12Y\n\x1d\x63rypto_replace_ffx_fpe_config\x18\x04 \x01(\x0b\x32\x30.google.privacy.dlp.v2.CryptoReplaceFfxFpeConfigH\x00\x12V\n\x1b\x66ixed_size_bucketing_config\x18\x05 \x01(\x0b\x32/.google.privacy.dlp.v2.FixedSizeBucketingConfigH\x00\x12\x42\n\x10\x62ucketing_config\x18\x06 \x01(\x0b\x32&.google.privacy.dlp.v2.BucketingConfigH\x00\x12Y\n\x1dreplace_with_info_type_config\x18\x07 \x01(\x0b\x32\x30.google.privacy.dlp.v2.ReplaceWithInfoTypeConfigH\x00\x12\x41\n\x10time_part_config\x18\x08 \x01(\x0b\x32%.google.privacy.dlp.v2.TimePartConfigH\x00\x12\x45\n\x12\x63rypto_hash_config\x18\t \x01(\x0b\x32\'.google.privacy.dlp.v2.CryptoHashConfigH\x00\x12\x43\n\x11\x64\x61te_shift_config\x18\x0b \x01(\x0b\x32&.google.privacy.dlp.v2.DateShiftConfigH\x00\x12W\n\x1b\x63rypto_deterministic_config\x18\x0c \x01(\x0b\x32\x30.google.privacy.dlp.v2.CryptoDeterministicConfigH\x00\x42\x10\n\x0etransformation"\xdc\x01\n\x0eTimePartConfig\x12G\n\x0fpart_to_extract\x18\x01 \x01(\x0e\x32..google.privacy.dlp.v2.TimePartConfig.TimePart"\x80\x01\n\x08TimePart\x12\x19\n\x15TIME_PART_UNSPECIFIED\x10\x00\x12\x08\n\x04YEAR\x10\x01\x12\t\n\x05MONTH\x10\x02\x12\x10\n\x0c\x44\x41Y_OF_MONTH\x10\x03\x12\x0f\n\x0b\x44\x41Y_OF_WEEK\x10\x04\x12\x10\n\x0cWEEK_OF_YEAR\x10\x05\x12\x0f\n\x0bHOUR_OF_DAY\x10\x06"H\n\x10\x43ryptoHashConfig\x12\x34\n\ncrypto_key\x18\x01 \x01(\x0b\x32 .google.privacy.dlp.v2.CryptoKey"\xc0\x01\n\x19\x43ryptoDeterministicConfig\x12\x34\n\ncrypto_key\x18\x01 \x01(\x0b\x32 .google.privacy.dlp.v2.CryptoKey\x12<\n\x13surrogate_info_type\x18\x02 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12/\n\x07\x63ontext\x18\x03 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId"E\n\x12ReplaceValueConfig\x12/\n\tnew_value\x18\x01 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value"\x1b\n\x19ReplaceWithInfoTypeConfig"\x0e\n\x0cRedactConfig"\xb6\x02\n\rCharsToIgnore\x12\x1c\n\x12\x63haracters_to_skip\x18\x01 \x01(\tH\x00\x12_\n\x1b\x63ommon_characters_to_ignore\x18\x02 \x01(\x0e\x32\x38.google.privacy.dlp.v2.CharsToIgnore.CommonCharsToIgnoreH\x00"\x97\x01\n\x13\x43ommonCharsToIgnore\x12&\n"COMMON_CHARS_TO_IGNORE_UNSPECIFIED\x10\x00\x12\x0b\n\x07NUMERIC\x10\x01\x12\x14\n\x10\x41LPHA_UPPER_CASE\x10\x02\x12\x14\n\x10\x41LPHA_LOWER_CASE\x10\x03\x12\x0f\n\x0bPUNCTUATION\x10\x04\x12\x0e\n\nWHITESPACE\x10\x05\x42\x0c\n\ncharacters"\xa3\x01\n\x13\x43haracterMaskConfig\x12\x19\n\x11masking_character\x18\x01 \x01(\t\x12\x16\n\x0enumber_to_mask\x18\x02 \x01(\x05\x12\x15\n\rreverse_order\x18\x03 \x01(\x08\x12\x42\n\x14\x63haracters_to_ignore\x18\x04 \x03(\x0b\x32$.google.privacy.dlp.v2.CharsToIgnore"\x95\x01\n\x18\x46ixedSizeBucketingConfig\x12\x31\n\x0blower_bound\x18\x01 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x31\n\x0bupper_bound\x18\x02 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x13\n\x0b\x62ucket_size\x18\x03 \x01(\x01"\xeb\x01\n\x0f\x42ucketingConfig\x12>\n\x07\x62uckets\x18\x01 \x03(\x0b\x32-.google.privacy.dlp.v2.BucketingConfig.Bucket\x1a\x97\x01\n\x06\x42ucket\x12)\n\x03min\x18\x01 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12)\n\x03max\x18\x02 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x12\x37\n\x11replacement_value\x18\x03 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value"\xf4\x03\n\x19\x43ryptoReplaceFfxFpeConfig\x12\x34\n\ncrypto_key\x18\x01 \x01(\x0b\x32 .google.privacy.dlp.v2.CryptoKey\x12/\n\x07\x63ontext\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x63\n\x0f\x63ommon_alphabet\x18\x04 \x01(\x0e\x32H.google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.FfxCommonNativeAlphabetH\x00\x12\x19\n\x0f\x63ustom_alphabet\x18\x05 \x01(\tH\x00\x12\x0f\n\x05radix\x18\x06 \x01(\x05H\x00\x12<\n\x13surrogate_info_type\x18\x08 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType"\x94\x01\n\x17\x46\x66xCommonNativeAlphabet\x12*\n&FFX_COMMON_NATIVE_ALPHABET_UNSPECIFIED\x10\x00\x12\x0b\n\x07NUMERIC\x10\x01\x12\x0f\n\x0bHEXADECIMAL\x10\x02\x12\x1c\n\x18UPPER_CASE_ALPHA_NUMERIC\x10\x03\x12\x11\n\rALPHA_NUMERIC\x10\x04\x42\n\n\x08\x61lphabet"\xd8\x01\n\tCryptoKey\x12>\n\ttransient\x18\x01 \x01(\x0b\x32).google.privacy.dlp.v2.TransientCryptoKeyH\x00\x12>\n\tunwrapped\x18\x02 \x01(\x0b\x32).google.privacy.dlp.v2.UnwrappedCryptoKeyH\x00\x12\x41\n\x0bkms_wrapped\x18\x03 \x01(\x0b\x32*.google.privacy.dlp.v2.KmsWrappedCryptoKeyH\x00\x42\x08\n\x06source""\n\x12TransientCryptoKey\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x12UnwrappedCryptoKey\x12\x0b\n\x03key\x18\x01 \x01(\x0c"C\n\x13KmsWrappedCryptoKey\x12\x13\n\x0bwrapped_key\x18\x01 \x01(\x0c\x12\x17\n\x0f\x63rypto_key_name\x18\x02 \x01(\t"\xb8\x01\n\x0f\x44\x61teShiftConfig\x12\x18\n\x10upper_bound_days\x18\x01 \x01(\x05\x12\x18\n\x10lower_bound_days\x18\x02 \x01(\x05\x12/\n\x07\x63ontext\x18\x03 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x36\n\ncrypto_key\x18\x04 \x01(\x0b\x32 .google.privacy.dlp.v2.CryptoKeyH\x00\x42\x08\n\x06method"\x9b\x02\n\x17InfoTypeTransformations\x12^\n\x0ftransformations\x18\x01 \x03(\x0b\x32\x45.google.privacy.dlp.v2.InfoTypeTransformations.InfoTypeTransformation\x1a\x9f\x01\n\x16InfoTypeTransformation\x12\x33\n\ninfo_types\x18\x01 \x03(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12P\n\x18primitive_transformation\x18\x02 \x01(\x0b\x32..google.privacy.dlp.v2.PrimitiveTransformation"\xbb\x02\n\x13\x46ieldTransformation\x12.\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x39\n\tcondition\x18\x03 \x01(\x0b\x32&.google.privacy.dlp.v2.RecordCondition\x12R\n\x18primitive_transformation\x18\x04 \x01(\x0b\x32..google.privacy.dlp.v2.PrimitiveTransformationH\x00\x12S\n\x19info_type_transformations\x18\x05 \x01(\x0b\x32..google.privacy.dlp.v2.InfoTypeTransformationsH\x00\x42\x10\n\x0etransformation"\xa9\x01\n\x15RecordTransformations\x12I\n\x15\x66ield_transformations\x18\x01 \x03(\x0b\x32*.google.privacy.dlp.v2.FieldTransformation\x12\x45\n\x13record_suppressions\x18\x02 \x03(\x0b\x32(.google.privacy.dlp.v2.RecordSuppression"N\n\x11RecordSuppression\x12\x39\n\tcondition\x18\x01 \x01(\x0b\x32&.google.privacy.dlp.v2.RecordCondition"\xd2\x04\n\x0fRecordCondition\x12G\n\x0b\x65xpressions\x18\x03 \x01(\x0b\x32\x32.google.privacy.dlp.v2.RecordCondition.Expressions\x1a\xa4\x01\n\tCondition\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12;\n\x08operator\x18\x03 \x01(\x0e\x32).google.privacy.dlp.v2.RelationalOperator\x12+\n\x05value\x18\x04 \x01(\x0b\x32\x1c.google.privacy.dlp.v2.Value\x1aR\n\nConditions\x12\x44\n\nconditions\x18\x01 \x03(\x0b\x32\x30.google.privacy.dlp.v2.RecordCondition.Condition\x1a\xfa\x01\n\x0b\x45xpressions\x12\\\n\x10logical_operator\x18\x01 \x01(\x0e\x32\x42.google.privacy.dlp.v2.RecordCondition.Expressions.LogicalOperator\x12G\n\nconditions\x18\x03 \x01(\x0b\x32\x31.google.privacy.dlp.v2.RecordCondition.ConditionsH\x00"<\n\x0fLogicalOperator\x12 \n\x1cLOGICAL_OPERATOR_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x42\x06\n\x04type"\x83\x01\n\x16TransformationOverview\x12\x19\n\x11transformed_bytes\x18\x02 \x01(\x03\x12N\n\x18transformation_summaries\x18\x03 \x03(\x0b\x32,.google.privacy.dlp.v2.TransformationSummary"\x9f\x05\n\x15TransformationSummary\x12\x32\n\tinfo_type\x18\x01 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12-\n\x05\x66ield\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x46\n\x0etransformation\x18\x03 \x01(\x0b\x32..google.privacy.dlp.v2.PrimitiveTransformation\x12I\n\x15\x66ield_transformations\x18\x05 \x03(\x0b\x32*.google.privacy.dlp.v2.FieldTransformation\x12\x41\n\x0frecord_suppress\x18\x06 \x01(\x0b\x32(.google.privacy.dlp.v2.RecordSuppression\x12K\n\x07results\x18\x04 \x03(\x0b\x32:.google.privacy.dlp.v2.TransformationSummary.SummaryResult\x12\x19\n\x11transformed_bytes\x18\x07 \x01(\x03\x1a\x84\x01\n\rSummaryResult\x12\r\n\x05\x63ount\x18\x01 \x01(\x03\x12S\n\x04\x63ode\x18\x02 \x01(\x0e\x32\x45.google.privacy.dlp.v2.TransformationSummary.TransformationResultCode\x12\x0f\n\x07\x64\x65tails\x18\x03 \x01(\t"^\n\x18TransformationResultCode\x12*\n&TRANSFORMATION_RESULT_CODE_UNSPECIFIED\x10\x00\x12\x0b\n\x07SUCCESS\x10\x01\x12\t\n\x05\x45RROR\x10\x02"U\n\x08Schedule\x12?\n\x1arecurrence_period_duration\x18\x01 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x42\x08\n\x06option"\xea\x01\n\x0fInspectTemplate\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\x0einspect_config\x18\x06 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectConfig"\xf3\x01\n\x12\x44\x65identifyTemplate\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x42\n\x11\x64\x65identify_config\x18\x06 \x01(\x0b\x32\'.google.privacy.dlp.v2.DeidentifyConfig"\\\n\x05\x45rror\x12#\n\x07\x64\x65tails\x18\x01 \x01(\x0b\x32\x12.google.rpc.Status\x12.\n\ntimestamps\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.Timestamp"\xdb\x04\n\nJobTrigger\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12>\n\x0binspect_job\x18\x04 \x01(\x0b\x32\'.google.privacy.dlp.v2.InspectJobConfigH\x00\x12;\n\x08triggers\x18\x05 \x03(\x0b\x32).google.privacy.dlp.v2.JobTrigger.Trigger\x12,\n\x06\x65rrors\x18\x06 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Error\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rlast_run_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x38\n\x06status\x18\n \x01(\x0e\x32(.google.privacy.dlp.v2.JobTrigger.Status\x1aI\n\x07Trigger\x12\x33\n\x08schedule\x18\x01 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.ScheduleH\x00\x42\t\n\x07trigger"H\n\x06Status\x12\x16\n\x12STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07HEALTHY\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\r\n\tCANCELLED\x10\x03\x42\x05\n\x03job"\x86\x05\n\x06\x41\x63tion\x12\x43\n\rsave_findings\x18\x01 \x01(\x0b\x32*.google.privacy.dlp.v2.Action.SaveFindingsH\x00\x12@\n\x07pub_sub\x18\x02 \x01(\x0b\x32-.google.privacy.dlp.v2.Action.PublishToPubSubH\x00\x12U\n\x17publish_summary_to_cscc\x18\x03 \x01(\x0b\x32\x32.google.privacy.dlp.v2.Action.PublishSummaryToCsccH\x00\x12q\n&publish_findings_to_cloud_data_catalog\x18\x05 \x01(\x0b\x32?.google.privacy.dlp.v2.Action.PublishFindingsToCloudDataCatalogH\x00\x12V\n\x17job_notification_emails\x18\x08 \x01(\x0b\x32\x33.google.privacy.dlp.v2.Action.JobNotificationEmailsH\x00\x1aQ\n\x0cSaveFindings\x12\x41\n\routput_config\x18\x01 \x01(\x0b\x32*.google.privacy.dlp.v2.OutputStorageConfig\x1a \n\x0fPublishToPubSub\x12\r\n\x05topic\x18\x01 \x01(\t\x1a\x16\n\x14PublishSummaryToCscc\x1a#\n!PublishFindingsToCloudDataCatalog\x1a\x17\n\x15JobNotificationEmailsB\x08\n\x06\x61\x63tion"\x85\x01\n\x1c\x43reateInspectTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12@\n\x10inspect_template\x18\x02 \x01(\x0b\x32&.google.privacy.dlp.v2.InspectTemplate\x12\x13\n\x0btemplate_id\x18\x03 \x01(\t"\x9f\x01\n\x1cUpdateInspectTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12@\n\x10inspect_template\x18\x02 \x01(\x0b\x32&.google.privacy.dlp.v2.InspectTemplate\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask")\n\x19GetInspectTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"f\n\x1bListInspectTemplatesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x10\n\x08order_by\x18\x04 \x01(\t"z\n\x1cListInspectTemplatesResponse\x12\x41\n\x11inspect_templates\x18\x01 \x03(\x0b\x32&.google.privacy.dlp.v2.InspectTemplate\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t",\n\x1c\x44\x65leteInspectTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"u\n\x17\x43reateJobTriggerRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x36\n\x0bjob_trigger\x18\x02 \x01(\x0b\x32!.google.privacy.dlp.v2.JobTrigger\x12\x12\n\ntrigger_id\x18\x03 \x01(\t")\n\x19\x41\x63tivateJobTriggerRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x90\x01\n\x17UpdateJobTriggerRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x36\n\x0bjob_trigger\x18\x02 \x01(\x0b\x32!.google.privacy.dlp.v2.JobTrigger\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14GetJobTriggerRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xbe\x01\n\x13\x43reateDlpJobRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12>\n\x0binspect_job\x18\x02 \x01(\x0b\x32\'.google.privacy.dlp.v2.InspectJobConfigH\x00\x12@\n\x08risk_job\x18\x03 \x01(\x0b\x32,.google.privacy.dlp.v2.RiskAnalysisJobConfigH\x00\x12\x0e\n\x06job_id\x18\x04 \x01(\tB\x05\n\x03job"q\n\x16ListJobTriggersRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x10\n\x08order_by\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t"k\n\x17ListJobTriggersResponse\x12\x37\n\x0cjob_triggers\x18\x01 \x03(\x0b\x32!.google.privacy.dlp.v2.JobTrigger\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\'\n\x17\x44\x65leteJobTriggerRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xdd\x01\n\x10InspectJobConfig\x12<\n\x0estorage_config\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.StorageConfig\x12<\n\x0einspect_config\x18\x02 \x01(\x0b\x32$.google.privacy.dlp.v2.InspectConfig\x12\x1d\n\x15inspect_template_name\x18\x03 \x01(\t\x12.\n\x07\x61\x63tions\x18\x04 \x03(\x0b\x32\x1d.google.privacy.dlp.v2.Action"\xde\x04\n\x06\x44lpJob\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x04type\x18\x02 \x01(\x0e\x32!.google.privacy.dlp.v2.DlpJobType\x12\x35\n\x05state\x18\x03 \x01(\x0e\x32&.google.privacy.dlp.v2.DlpJob.JobState\x12K\n\x0crisk_details\x18\x04 \x01(\x0b\x32\x33.google.privacy.dlp.v2.AnalyzeDataSourceRiskDetailsH\x00\x12J\n\x0finspect_details\x18\x05 \x01(\x0b\x32/.google.privacy.dlp.v2.InspectDataSourceDetailsH\x00\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nstart_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x18\n\x10job_trigger_name\x18\n \x01(\t\x12,\n\x06\x65rrors\x18\x0b \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Error"c\n\x08JobState\x12\x19\n\x15JOB_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\x0c\n\x08\x43\x41NCELED\x10\x04\x12\n\n\x06\x46\x41ILED\x10\x05\x42\t\n\x07\x64\x65tails" \n\x10GetDlpJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x9e\x01\n\x12ListDlpJobsRequest\x12\x0e\n\x06parent\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12/\n\x04type\x18\x05 \x01(\x0e\x32!.google.privacy.dlp.v2.DlpJobType\x12\x10\n\x08order_by\x18\x06 \x01(\t"[\n\x13ListDlpJobsResponse\x12+\n\x04jobs\x18\x01 \x03(\x0b\x32\x1d.google.privacy.dlp.v2.DlpJob\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"#\n\x13\x43\x61ncelDlpJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"#\n\x13\x44\x65leteDlpJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8e\x01\n\x1f\x43reateDeidentifyTemplateRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x46\n\x13\x64\x65identify_template\x18\x02 \x01(\x0b\x32).google.privacy.dlp.v2.DeidentifyTemplate\x12\x13\n\x0btemplate_id\x18\x03 \x01(\t"\xa8\x01\n\x1fUpdateDeidentifyTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x46\n\x13\x64\x65identify_template\x18\x02 \x01(\x0b\x32).google.privacy.dlp.v2.DeidentifyTemplate\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask",\n\x1cGetDeidentifyTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"i\n\x1eListDeidentifyTemplatesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x10\n\x08order_by\x18\x04 \x01(\t"\x83\x01\n\x1fListDeidentifyTemplatesResponse\x12G\n\x14\x64\x65identify_templates\x18\x01 \x03(\x0b\x32).google.privacy.dlp.v2.DeidentifyTemplate\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"/\n\x1f\x44\x65leteDeidentifyTemplateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xf4\x01\n\x1bLargeCustomDictionaryConfig\x12<\n\x0boutput_path\x18\x01 \x01(\x0b\x32\'.google.privacy.dlp.v2.CloudStoragePath\x12L\n\x16\x63loud_storage_file_set\x18\x02 \x01(\x0b\x32*.google.privacy.dlp.v2.CloudStorageFileSetH\x00\x12?\n\x0f\x62ig_query_field\x18\x03 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryFieldH\x00\x42\x08\n\x06source"8\n\x1aLargeCustomDictionaryStats\x12\x1a\n\x12\x61pprox_num_phrases\x18\x01 \x01(\x03"\xa0\x01\n\x14StoredInfoTypeConfig\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12U\n\x17large_custom_dictionary\x18\x03 \x01(\x0b\x32\x32.google.privacy.dlp.v2.LargeCustomDictionaryConfigH\x00\x42\x06\n\x04type"s\n\x13StoredInfoTypeStats\x12T\n\x17large_custom_dictionary\x18\x01 \x01(\x0b\x32\x31.google.privacy.dlp.v2.LargeCustomDictionaryStatsH\x00\x42\x06\n\x04type"\xa9\x02\n\x15StoredInfoTypeVersion\x12;\n\x06\x63onfig\x18\x01 \x01(\x0b\x32+.google.privacy.dlp.v2.StoredInfoTypeConfig\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x39\n\x05state\x18\x03 \x01(\x0e\x32*.google.privacy.dlp.v2.StoredInfoTypeState\x12,\n\x06\x65rrors\x18\x04 \x03(\x0b\x32\x1c.google.privacy.dlp.v2.Error\x12\x39\n\x05stats\x18\x05 \x01(\x0b\x32*.google.privacy.dlp.v2.StoredInfoTypeStats"\xad\x01\n\x0eStoredInfoType\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x45\n\x0f\x63urrent_version\x18\x02 \x01(\x0b\x32,.google.privacy.dlp.v2.StoredInfoTypeVersion\x12\x46\n\x10pending_versions\x18\x03 \x03(\x0b\x32,.google.privacy.dlp.v2.StoredInfoTypeVersion"\x87\x01\n\x1b\x43reateStoredInfoTypeRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12;\n\x06\x63onfig\x18\x02 \x01(\x0b\x32+.google.privacy.dlp.v2.StoredInfoTypeConfig\x12\x1b\n\x13stored_info_type_id\x18\x03 \x01(\t"\x99\x01\n\x1bUpdateStoredInfoTypeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12;\n\x06\x63onfig\x18\x02 \x01(\x0b\x32+.google.privacy.dlp.v2.StoredInfoTypeConfig\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"(\n\x18GetStoredInfoTypeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"e\n\x1aListStoredInfoTypesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x10\n\x08order_by\x18\x04 \x01(\t"x\n\x1bListStoredInfoTypesResponse\x12@\n\x11stored_info_types\x18\x01 \x03(\x0b\x32%.google.privacy.dlp.v2.StoredInfoType\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"+\n\x1b\x44\x65leteStoredInfoTypeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t*M\n\rContentOption\x12\x17\n\x13\x43ONTENT_UNSPECIFIED\x10\x00\x12\x10\n\x0c\x43ONTENT_TEXT\x10\x01\x12\x11\n\rCONTENT_IMAGE\x10\x02*\x8d\x01\n\x0cMatchingType\x12\x1d\n\x19MATCHING_TYPE_UNSPECIFIED\x10\x00\x12\x1c\n\x18MATCHING_TYPE_FULL_MATCH\x10\x01\x12\x1f\n\x1bMATCHING_TYPE_PARTIAL_MATCH\x10\x02\x12\x1f\n\x1bMATCHING_TYPE_INVERSE_MATCH\x10\x03*P\n\x13InfoTypeSupportedBy\x12\x19\n\x15\x45NUM_TYPE_UNSPECIFIED\x10\x00\x12\x0b\n\x07INSPECT\x10\x01\x12\x11\n\rRISK_ANALYSIS\x10\x02*\xbb\x01\n\x12RelationalOperator\x12#\n\x1fRELATIONAL_OPERATOR_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x45QUAL_TO\x10\x01\x12\x10\n\x0cNOT_EQUAL_TO\x10\x02\x12\x10\n\x0cGREATER_THAN\x10\x03\x12\r\n\tLESS_THAN\x10\x04\x12\x1a\n\x16GREATER_THAN_OR_EQUALS\x10\x05\x12\x17\n\x13LESS_THAN_OR_EQUALS\x10\x06\x12\n\n\x06\x45XISTS\x10\x07*R\n\nDlpJobType\x12\x1c\n\x18\x44LP_JOB_TYPE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bINSPECT_JOB\x10\x01\x12\x15\n\x11RISK_ANALYSIS_JOB\x10\x02*n\n\x13StoredInfoTypeState\x12&\n"STORED_INFO_TYPE_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\t\n\x05READY\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\x0b\n\x07INVALID\x10\x04\x32\x92-\n\nDlpService\x12\xa1\x01\n\x0eInspectContent\x12,.google.privacy.dlp.v2.InspectContentRequest\x1a-.google.privacy.dlp.v2.InspectContentResponse"2\x82\xd3\xe4\x93\x02,"\'/v2/{parent=projects/*}/content:inspect:\x01*\x12\x95\x01\n\x0bRedactImage\x12).google.privacy.dlp.v2.RedactImageRequest\x1a*.google.privacy.dlp.v2.RedactImageResponse"/\x82\xd3\xe4\x93\x02)"$/v2/{parent=projects/*}/image:redact:\x01*\x12\xad\x01\n\x11\x44\x65identifyContent\x12/.google.privacy.dlp.v2.DeidentifyContentRequest\x1a\x30.google.privacy.dlp.v2.DeidentifyContentResponse"5\x82\xd3\xe4\x93\x02/"*/v2/{parent=projects/*}/content:deidentify:\x01*\x12\xad\x01\n\x11ReidentifyContent\x12/.google.privacy.dlp.v2.ReidentifyContentRequest\x1a\x30.google.privacy.dlp.v2.ReidentifyContentResponse"5\x82\xd3\xe4\x93\x02/"*/v2/{parent=projects/*}/content:reidentify:\x01*\x12\x81\x01\n\rListInfoTypes\x12+.google.privacy.dlp.v2.ListInfoTypesRequest\x1a,.google.privacy.dlp.v2.ListInfoTypesResponse"\x15\x82\xd3\xe4\x93\x02\x0f\x12\r/v2/infoTypes\x12\xdd\x01\n\x15\x43reateInspectTemplate\x12\x33.google.privacy.dlp.v2.CreateInspectTemplateRequest\x1a&.google.privacy.dlp.v2.InspectTemplate"g\x82\xd3\xe4\x93\x02\x61"-/v2/{parent=organizations/*}/inspectTemplates:\x01*Z-"(/v2/{parent=projects/*}/inspectTemplates:\x01*\x12\xdd\x01\n\x15UpdateInspectTemplate\x12\x33.google.privacy.dlp.v2.UpdateInspectTemplateRequest\x1a&.google.privacy.dlp.v2.InspectTemplate"g\x82\xd3\xe4\x93\x02\x61\x32-/v2/{name=organizations/*/inspectTemplates/*}:\x01*Z-2(/v2/{name=projects/*/inspectTemplates/*}:\x01*\x12\xd1\x01\n\x12GetInspectTemplate\x12\x30.google.privacy.dlp.v2.GetInspectTemplateRequest\x1a&.google.privacy.dlp.v2.InspectTemplate"a\x82\xd3\xe4\x93\x02[\x12-/v2/{name=organizations/*/inspectTemplates/*}Z*\x12(/v2/{name=projects/*/inspectTemplates/*}\x12\xe2\x01\n\x14ListInspectTemplates\x12\x32.google.privacy.dlp.v2.ListInspectTemplatesRequest\x1a\x33.google.privacy.dlp.v2.ListInspectTemplatesResponse"a\x82\xd3\xe4\x93\x02[\x12-/v2/{parent=organizations/*}/inspectTemplatesZ*\x12(/v2/{parent=projects/*}/inspectTemplates\x12\xc7\x01\n\x15\x44\x65leteInspectTemplate\x12\x33.google.privacy.dlp.v2.DeleteInspectTemplateRequest\x1a\x16.google.protobuf.Empty"a\x82\xd3\xe4\x93\x02[*-/v2/{name=organizations/*/inspectTemplates/*}Z**(/v2/{name=projects/*/inspectTemplates/*}\x12\xec\x01\n\x18\x43reateDeidentifyTemplate\x12\x36.google.privacy.dlp.v2.CreateDeidentifyTemplateRequest\x1a).google.privacy.dlp.v2.DeidentifyTemplate"m\x82\xd3\xe4\x93\x02g"0/v2/{parent=organizations/*}/deidentifyTemplates:\x01*Z0"+/v2/{parent=projects/*}/deidentifyTemplates:\x01*\x12\xec\x01\n\x18UpdateDeidentifyTemplate\x12\x36.google.privacy.dlp.v2.UpdateDeidentifyTemplateRequest\x1a).google.privacy.dlp.v2.DeidentifyTemplate"m\x82\xd3\xe4\x93\x02g20/v2/{name=organizations/*/deidentifyTemplates/*}:\x01*Z02+/v2/{name=projects/*/deidentifyTemplates/*}:\x01*\x12\xe0\x01\n\x15GetDeidentifyTemplate\x12\x33.google.privacy.dlp.v2.GetDeidentifyTemplateRequest\x1a).google.privacy.dlp.v2.DeidentifyTemplate"g\x82\xd3\xe4\x93\x02\x61\x12\x30/v2/{name=organizations/*/deidentifyTemplates/*}Z-\x12+/v2/{name=projects/*/deidentifyTemplates/*}\x12\xf1\x01\n\x17ListDeidentifyTemplates\x12\x35.google.privacy.dlp.v2.ListDeidentifyTemplatesRequest\x1a\x36.google.privacy.dlp.v2.ListDeidentifyTemplatesResponse"g\x82\xd3\xe4\x93\x02\x61\x12\x30/v2/{parent=organizations/*}/deidentifyTemplatesZ-\x12+/v2/{parent=projects/*}/deidentifyTemplates\x12\xd3\x01\n\x18\x44\x65leteDeidentifyTemplate\x12\x36.google.privacy.dlp.v2.DeleteDeidentifyTemplateRequest\x1a\x16.google.protobuf.Empty"g\x82\xd3\xe4\x93\x02\x61*0/v2/{name=organizations/*/deidentifyTemplates/*}Z-*+/v2/{name=projects/*/deidentifyTemplates/*}\x12\x95\x01\n\x10\x43reateJobTrigger\x12..google.privacy.dlp.v2.CreateJobTriggerRequest\x1a!.google.privacy.dlp.v2.JobTrigger".\x82\xd3\xe4\x93\x02("#/v2/{parent=projects/*}/jobTriggers:\x01*\x12\x95\x01\n\x10UpdateJobTrigger\x12..google.privacy.dlp.v2.UpdateJobTriggerRequest\x1a!.google.privacy.dlp.v2.JobTrigger".\x82\xd3\xe4\x93\x02(2#/v2/{name=projects/*/jobTriggers/*}:\x01*\x12\x8c\x01\n\rGetJobTrigger\x12+.google.privacy.dlp.v2.GetJobTriggerRequest\x1a!.google.privacy.dlp.v2.JobTrigger"+\x82\xd3\xe4\x93\x02%\x12#/v2/{name=projects/*/jobTriggers/*}\x12\x9d\x01\n\x0fListJobTriggers\x12-.google.privacy.dlp.v2.ListJobTriggersRequest\x1a..google.privacy.dlp.v2.ListJobTriggersResponse"+\x82\xd3\xe4\x93\x02%\x12#/v2/{parent=projects/*}/jobTriggers\x12\x87\x01\n\x10\x44\x65leteJobTrigger\x12..google.privacy.dlp.v2.DeleteJobTriggerRequest\x1a\x16.google.protobuf.Empty"+\x82\xd3\xe4\x93\x02%*#/v2/{name=projects/*/jobTriggers/*}\x12\x9e\x01\n\x12\x41\x63tivateJobTrigger\x12\x30.google.privacy.dlp.v2.ActivateJobTriggerRequest\x1a\x1d.google.privacy.dlp.v2.DlpJob"7\x82\xd3\xe4\x93\x02\x31",/v2/{name=projects/*/jobTriggers/*}:activate:\x01*\x12\x85\x01\n\x0c\x43reateDlpJob\x12*.google.privacy.dlp.v2.CreateDlpJobRequest\x1a\x1d.google.privacy.dlp.v2.DlpJob"*\x82\xd3\xe4\x93\x02$"\x1f/v2/{parent=projects/*}/dlpJobs:\x01*\x12\x8d\x01\n\x0bListDlpJobs\x12).google.privacy.dlp.v2.ListDlpJobsRequest\x1a*.google.privacy.dlp.v2.ListDlpJobsResponse"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v2/{parent=projects/*}/dlpJobs\x12|\n\tGetDlpJob\x12\'.google.privacy.dlp.v2.GetDlpJobRequest\x1a\x1d.google.privacy.dlp.v2.DlpJob"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v2/{name=projects/*/dlpJobs/*}\x12{\n\x0c\x44\x65leteDlpJob\x12*.google.privacy.dlp.v2.DeleteDlpJobRequest\x1a\x16.google.protobuf.Empty"\'\x82\xd3\xe4\x93\x02!*\x1f/v2/{name=projects/*/dlpJobs/*}\x12\x85\x01\n\x0c\x43\x61ncelDlpJob\x12*.google.privacy.dlp.v2.CancelDlpJobRequest\x1a\x16.google.protobuf.Empty"1\x82\xd3\xe4\x93\x02+"&/v2/{name=projects/*/dlpJobs/*}:cancel:\x01*\x12\xd8\x01\n\x14\x43reateStoredInfoType\x12\x32.google.privacy.dlp.v2.CreateStoredInfoTypeRequest\x1a%.google.privacy.dlp.v2.StoredInfoType"e\x82\xd3\xe4\x93\x02_",/v2/{parent=organizations/*}/storedInfoTypes:\x01*Z,"\'/v2/{parent=projects/*}/storedInfoTypes:\x01*\x12\xd8\x01\n\x14UpdateStoredInfoType\x12\x32.google.privacy.dlp.v2.UpdateStoredInfoTypeRequest\x1a%.google.privacy.dlp.v2.StoredInfoType"e\x82\xd3\xe4\x93\x02_2,/v2/{name=organizations/*/storedInfoTypes/*}:\x01*Z,2\'/v2/{name=projects/*/storedInfoTypes/*}:\x01*\x12\xcc\x01\n\x11GetStoredInfoType\x12/.google.privacy.dlp.v2.GetStoredInfoTypeRequest\x1a%.google.privacy.dlp.v2.StoredInfoType"_\x82\xd3\xe4\x93\x02Y\x12,/v2/{name=organizations/*/storedInfoTypes/*}Z)\x12\'/v2/{name=projects/*/storedInfoTypes/*}\x12\xdd\x01\n\x13ListStoredInfoTypes\x12\x31.google.privacy.dlp.v2.ListStoredInfoTypesRequest\x1a\x32.google.privacy.dlp.v2.ListStoredInfoTypesResponse"_\x82\xd3\xe4\x93\x02Y\x12,/v2/{parent=organizations/*}/storedInfoTypesZ)\x12\'/v2/{parent=projects/*}/storedInfoTypes\x12\xc3\x01\n\x14\x44\x65leteStoredInfoType\x12\x32.google.privacy.dlp.v2.DeleteStoredInfoTypeRequest\x1a\x16.google.protobuf.Empty"_\x82\xd3\xe4\x93\x02Y*,/v2/{name=organizations/*/storedInfoTypes/*}Z)*\'/v2/{name=projects/*/storedInfoTypes/*}\x1a\x46\xca\x41\x12\x64lp.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x8d\x01\n\x19\x63om.google.privacy.dlp.v2B\x08\x44lpProtoP\x01Z8google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp\xaa\x02\x13Google.Cloud.Dlp.V2\xca\x02\x13Google\\Cloud\\Dlp\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_type_dot_date__pb2.DESCRIPTOR,
+        google_dot_type_dot_dayofweek__pb2.DESCRIPTOR,
+        google_dot_type_dot_timeofday__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+_CONTENTOPTION = _descriptor.EnumDescriptor(
+    name="ContentOption",
+    full_name="google.privacy.dlp.v2.ContentOption",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CONTENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONTENT_TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONTENT_IMAGE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=26512,
+    serialized_end=26589,
+)
+_sym_db.RegisterEnumDescriptor(_CONTENTOPTION)
+
+ContentOption = enum_type_wrapper.EnumTypeWrapper(_CONTENTOPTION)
+_MATCHINGTYPE = _descriptor.EnumDescriptor(
+    name="MatchingType",
+    full_name="google.privacy.dlp.v2.MatchingType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MATCHING_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MATCHING_TYPE_FULL_MATCH",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MATCHING_TYPE_PARTIAL_MATCH",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MATCHING_TYPE_INVERSE_MATCH",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=26592,
+    serialized_end=26733,
+)
+_sym_db.RegisterEnumDescriptor(_MATCHINGTYPE)
+
+MatchingType = enum_type_wrapper.EnumTypeWrapper(_MATCHINGTYPE)
+_INFOTYPESUPPORTEDBY = _descriptor.EnumDescriptor(
+    name="InfoTypeSupportedBy",
+    full_name="google.privacy.dlp.v2.InfoTypeSupportedBy",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ENUM_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSPECT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RISK_ANALYSIS", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=26735,
+    serialized_end=26815,
+)
+_sym_db.RegisterEnumDescriptor(_INFOTYPESUPPORTEDBY)
+
+InfoTypeSupportedBy = enum_type_wrapper.EnumTypeWrapper(_INFOTYPESUPPORTEDBY)
+_RELATIONALOPERATOR = _descriptor.EnumDescriptor(
+    name="RelationalOperator",
+    full_name="google.privacy.dlp.v2.RelationalOperator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RELATIONAL_OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EQUAL_TO", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOT_EQUAL_TO", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN_OR_EQUALS",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN_OR_EQUALS",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXISTS", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=26818,
+    serialized_end=27005,
+)
+_sym_db.RegisterEnumDescriptor(_RELATIONALOPERATOR)
+
+RelationalOperator = enum_type_wrapper.EnumTypeWrapper(_RELATIONALOPERATOR)
+_DLPJOBTYPE = _descriptor.EnumDescriptor(
+    name="DlpJobType",
+    full_name="google.privacy.dlp.v2.DlpJobType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DLP_JOB_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSPECT_JOB", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RISK_ANALYSIS_JOB",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=27007,
+    serialized_end=27089,
+)
+_sym_db.RegisterEnumDescriptor(_DLPJOBTYPE)
+
+DlpJobType = enum_type_wrapper.EnumTypeWrapper(_DLPJOBTYPE)
+_STOREDINFOTYPESTATE = _descriptor.EnumDescriptor(
+    name="StoredInfoTypeState",
+    full_name="google.privacy.dlp.v2.StoredInfoTypeState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STORED_INFO_TYPE_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INVALID", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=27091,
+    serialized_end=27201,
+)
+_sym_db.RegisterEnumDescriptor(_STOREDINFOTYPESTATE)
+
+StoredInfoTypeState = enum_type_wrapper.EnumTypeWrapper(_STOREDINFOTYPESTATE)
+CONTENT_UNSPECIFIED = 0
+CONTENT_TEXT = 1
+CONTENT_IMAGE = 2
+MATCHING_TYPE_UNSPECIFIED = 0
+MATCHING_TYPE_FULL_MATCH = 1
+MATCHING_TYPE_PARTIAL_MATCH = 2
+MATCHING_TYPE_INVERSE_MATCH = 3
+ENUM_TYPE_UNSPECIFIED = 0
+INSPECT = 1
+RISK_ANALYSIS = 2
+RELATIONAL_OPERATOR_UNSPECIFIED = 0
+EQUAL_TO = 1
+NOT_EQUAL_TO = 2
+GREATER_THAN = 3
+LESS_THAN = 4
+GREATER_THAN_OR_EQUALS = 5
+LESS_THAN_OR_EQUALS = 6
+EXISTS = 7
+DLP_JOB_TYPE_UNSPECIFIED = 0
+INSPECT_JOB = 1
+RISK_ANALYSIS_JOB = 2
+STORED_INFO_TYPE_STATE_UNSPECIFIED = 0
+PENDING = 1
+READY = 2
+FAILED = 3
+INVALID = 4
+
+
+_BYTECONTENTITEM_BYTESTYPE = _descriptor.EnumDescriptor(
+    name="BytesType",
+    full_name="google.privacy.dlp.v2.ByteContentItem.BytesType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="BYTES_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE", index=1, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_JPEG", index=2, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_BMP", index=3, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_PNG", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_SVG", index=5, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_UTF8", index=6, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AVRO", index=7, number=11, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1894,
+    serialized_end=2030,
+)
+_sym_db.RegisterEnumDescriptor(_BYTECONTENTITEM_BYTESTYPE)
+
+_OUTPUTSTORAGECONFIG_OUTPUTSCHEMA = _descriptor.EnumDescriptor(
+    name="OutputSchema",
+    full_name="google.privacy.dlp.v2.OutputStorageConfig.OutputSchema",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OUTPUT_SCHEMA_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASIC_COLUMNS", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GCS_COLUMNS", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATASTORE_COLUMNS",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BIG_QUERY_COLUMNS",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALL_COLUMNS", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5637,
+    serialized_end=5781,
+)
+_sym_db.RegisterEnumDescriptor(_OUTPUTSTORAGECONFIG_OUTPUTSCHEMA)
+
+_TIMEPARTCONFIG_TIMEPART = _descriptor.EnumDescriptor(
+    name="TimePart",
+    full_name="google.privacy.dlp.v2.TimePartConfig.TimePart",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TIME_PART_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="YEAR", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MONTH", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DAY_OF_MONTH", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DAY_OF_WEEK", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEEK_OF_YEAR", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HOUR_OF_DAY", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=14965,
+    serialized_end=15093,
+)
+_sym_db.RegisterEnumDescriptor(_TIMEPARTCONFIG_TIMEPART)
+
+_CHARSTOIGNORE_COMMONCHARSTOIGNORE = _descriptor.EnumDescriptor(
+    name="CommonCharsToIgnore",
+    full_name="google.privacy.dlp.v2.CharsToIgnore.CommonCharsToIgnore",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMMON_CHARS_TO_IGNORE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMERIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALPHA_UPPER_CASE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALPHA_LOWER_CASE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUNCTUATION", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WHITESPACE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=15626,
+    serialized_end=15777,
+)
+_sym_db.RegisterEnumDescriptor(_CHARSTOIGNORE_COMMONCHARSTOIGNORE)
+
+_CRYPTOREPLACEFFXFPECONFIG_FFXCOMMONNATIVEALPHABET = _descriptor.EnumDescriptor(
+    name="FfxCommonNativeAlphabet",
+    full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.FfxCommonNativeAlphabet",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FFX_COMMON_NATIVE_ALPHABET_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMERIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEXADECIMAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_CASE_ALPHA_NUMERIC",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALPHA_NUMERIC", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=16690,
+    serialized_end=16838,
+)
+_sym_db.RegisterEnumDescriptor(_CRYPTOREPLACEFFXFPECONFIG_FFXCOMMONNATIVEALPHABET)
+
+_RECORDCONDITION_EXPRESSIONS_LOGICALOPERATOR = _descriptor.EnumDescriptor(
+    name="LogicalOperator",
+    full_name="google.privacy.dlp.v2.RecordCondition.Expressions.LogicalOperator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LOGICAL_OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AND", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=18781,
+    serialized_end=18841,
+)
+_sym_db.RegisterEnumDescriptor(_RECORDCONDITION_EXPRESSIONS_LOGICALOPERATOR)
+
+_TRANSFORMATIONSUMMARY_TRANSFORMATIONRESULTCODE = _descriptor.EnumDescriptor(
+    name="TransformationResultCode",
+    full_name="google.privacy.dlp.v2.TransformationSummary.TransformationResultCode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TRANSFORMATION_RESULT_CODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESS", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=19563,
+    serialized_end=19657,
+)
+_sym_db.RegisterEnumDescriptor(_TRANSFORMATIONSUMMARY_TRANSFORMATIONRESULTCODE)
+
+_JOBTRIGGER_STATUS = _descriptor.EnumDescriptor(
+    name="Status",
+    full_name="google.privacy.dlp.v2.JobTrigger.Status",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEALTHY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=20848,
+    serialized_end=20920,
+)
+_sym_db.RegisterEnumDescriptor(_JOBTRIGGER_STATUS)
+
+_DLPJOB_JOBSTATE = _descriptor.EnumDescriptor(
+    name="JobState",
+    full_name="google.privacy.dlp.v2.DlpJob.JobState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="JOB_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=23719,
+    serialized_end=23818,
+)
+_sym_db.RegisterEnumDescriptor(_DLPJOB_JOBSTATE)
+
+
+_EXCLUDEINFOTYPES = _descriptor.Descriptor(
+    name="ExcludeInfoTypes",
+    full_name="google.privacy.dlp.v2.ExcludeInfoTypes",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_types",
+            full_name="google.privacy.dlp.v2.ExcludeInfoTypes.info_types",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=409,
+    serialized_end=480,
+)
+
+
+_EXCLUSIONRULE = _descriptor.Descriptor(
+    name="ExclusionRule",
+    full_name="google.privacy.dlp.v2.ExclusionRule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dictionary",
+            full_name="google.privacy.dlp.v2.ExclusionRule.dictionary",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="regex",
+            full_name="google.privacy.dlp.v2.ExclusionRule.regex",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclude_info_types",
+            full_name="google.privacy.dlp.v2.ExclusionRule.exclude_info_types",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="matching_type",
+            full_name="google.privacy.dlp.v2.ExclusionRule.matching_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.ExclusionRule.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=483,
+    serialized_end=771,
+)
+
+
+_INSPECTIONRULE = _descriptor.Descriptor(
+    name="InspectionRule",
+    full_name="google.privacy.dlp.v2.InspectionRule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hotword_rule",
+            full_name="google.privacy.dlp.v2.InspectionRule.hotword_rule",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclusion_rule",
+            full_name="google.privacy.dlp.v2.InspectionRule.exclusion_rule",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.InspectionRule.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=774,
+    serialized_end=951,
+)
+
+
+_INSPECTIONRULESET = _descriptor.Descriptor(
+    name="InspectionRuleSet",
+    full_name="google.privacy.dlp.v2.InspectionRuleSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_types",
+            full_name="google.privacy.dlp.v2.InspectionRuleSet.info_types",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rules",
+            full_name="google.privacy.dlp.v2.InspectionRuleSet.rules",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=953,
+    serialized_end=1079,
+)
+
+
+_INSPECTCONFIG_FINDINGLIMITS_INFOTYPELIMIT = _descriptor.Descriptor(
+    name="InfoTypeLimit",
+    full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits.InfoTypeLimit",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits.InfoTypeLimit.info_type",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_findings",
+            full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits.InfoTypeLimit.max_findings",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1704,
+    serialized_end=1793,
+)
+
+_INSPECTCONFIG_FINDINGLIMITS = _descriptor.Descriptor(
+    name="FindingLimits",
+    full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_findings_per_item",
+            full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits.max_findings_per_item",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_findings_per_request",
+            full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits.max_findings_per_request",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_findings_per_info_type",
+            full_name="google.privacy.dlp.v2.InspectConfig.FindingLimits.max_findings_per_info_type",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSPECTCONFIG_FINDINGLIMITS_INFOTYPELIMIT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1520,
+    serialized_end=1793,
+)
+
+_INSPECTCONFIG = _descriptor.Descriptor(
+    name="InspectConfig",
+    full_name="google.privacy.dlp.v2.InspectConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_types",
+            full_name="google.privacy.dlp.v2.InspectConfig.info_types",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_likelihood",
+            full_name="google.privacy.dlp.v2.InspectConfig.min_likelihood",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limits",
+            full_name="google.privacy.dlp.v2.InspectConfig.limits",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_quote",
+            full_name="google.privacy.dlp.v2.InspectConfig.include_quote",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclude_info_types",
+            full_name="google.privacy.dlp.v2.InspectConfig.exclude_info_types",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_info_types",
+            full_name="google.privacy.dlp.v2.InspectConfig.custom_info_types",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_options",
+            full_name="google.privacy.dlp.v2.InspectConfig.content_options",
+            index=6,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rule_set",
+            full_name="google.privacy.dlp.v2.InspectConfig.rule_set",
+            index=7,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSPECTCONFIG_FINDINGLIMITS],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1082,
+    serialized_end=1793,
+)
+
+
+_BYTECONTENTITEM = _descriptor.Descriptor(
+    name="ByteContentItem",
+    full_name="google.privacy.dlp.v2.ByteContentItem",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.ByteContentItem.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.privacy.dlp.v2.ByteContentItem.data",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BYTECONTENTITEM_BYTESTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1796,
+    serialized_end=2030,
+)
+
+
+_CONTENTITEM = _descriptor.Descriptor(
+    name="ContentItem",
+    full_name="google.privacy.dlp.v2.ContentItem",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.privacy.dlp.v2.ContentItem.value",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.privacy.dlp.v2.ContentItem.table",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="byte_item",
+            full_name="google.privacy.dlp.v2.ContentItem.byte_item",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="data_item",
+            full_name="google.privacy.dlp.v2.ContentItem.data_item",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2033,
+    serialized_end=2184,
+)
+
+
+_TABLE_ROW = _descriptor.Descriptor(
+    name="Row",
+    full_name="google.privacy.dlp.v2.Table.Row",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.privacy.dlp.v2.Table.Row.values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2293,
+    serialized_end=2344,
+)
+
+_TABLE = _descriptor.Descriptor(
+    name="Table",
+    full_name="google.privacy.dlp.v2.Table",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.privacy.dlp.v2.Table.headers",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows",
+            full_name="google.privacy.dlp.v2.Table.rows",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TABLE_ROW],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2187,
+    serialized_end=2344,
+)
+
+
+_INSPECTRESULT = _descriptor.Descriptor(
+    name="InspectResult",
+    full_name="google.privacy.dlp.v2.InspectResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="findings",
+            full_name="google.privacy.dlp.v2.InspectResult.findings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="findings_truncated",
+            full_name="google.privacy.dlp.v2.InspectResult.findings_truncated",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2346,
+    serialized_end=2439,
+)
+
+
+_FINDING = _descriptor.Descriptor(
+    name="Finding",
+    full_name="google.privacy.dlp.v2.Finding",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quote",
+            full_name="google.privacy.dlp.v2.Finding.quote",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.Finding.info_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="likelihood",
+            full_name="google.privacy.dlp.v2.Finding.likelihood",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.privacy.dlp.v2.Finding.location",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.Finding.create_time",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quote_info",
+            full_name="google.privacy.dlp.v2.Finding.quote_info",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2442,
+    serialized_end=2727,
+)
+
+
+_LOCATION = _descriptor.Descriptor(
+    name="Location",
+    full_name="google.privacy.dlp.v2.Location",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="byte_range",
+            full_name="google.privacy.dlp.v2.Location.byte_range",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="codepoint_range",
+            full_name="google.privacy.dlp.v2.Location.codepoint_range",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_locations",
+            full_name="google.privacy.dlp.v2.Location.content_locations",
+            index=2,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2730,
+    serialized_end=2912,
+)
+
+
+_CONTENTLOCATION = _descriptor.Descriptor(
+    name="ContentLocation",
+    full_name="google.privacy.dlp.v2.ContentLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="container_name",
+            full_name="google.privacy.dlp.v2.ContentLocation.container_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="record_location",
+            full_name="google.privacy.dlp.v2.ContentLocation.record_location",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_location",
+            full_name="google.privacy.dlp.v2.ContentLocation.image_location",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_location",
+            full_name="google.privacy.dlp.v2.ContentLocation.document_location",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="container_timestamp",
+            full_name="google.privacy.dlp.v2.ContentLocation.container_timestamp",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="container_version",
+            full_name="google.privacy.dlp.v2.ContentLocation.container_version",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="location",
+            full_name="google.privacy.dlp.v2.ContentLocation.location",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2915,
+    serialized_end=3252,
+)
+
+
+_DOCUMENTLOCATION = _descriptor.Descriptor(
+    name="DocumentLocation",
+    full_name="google.privacy.dlp.v2.DocumentLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="file_offset",
+            full_name="google.privacy.dlp.v2.DocumentLocation.file_offset",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3254,
+    serialized_end=3293,
+)
+
+
+_RECORDLOCATION = _descriptor.Descriptor(
+    name="RecordLocation",
+    full_name="google.privacy.dlp.v2.RecordLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="record_key",
+            full_name="google.privacy.dlp.v2.RecordLocation.record_key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_id",
+            full_name="google.privacy.dlp.v2.RecordLocation.field_id",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_location",
+            full_name="google.privacy.dlp.v2.RecordLocation.table_location",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3296,
+    serialized_end=3478,
+)
+
+
+_TABLELOCATION = _descriptor.Descriptor(
+    name="TableLocation",
+    full_name="google.privacy.dlp.v2.TableLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row_index",
+            full_name="google.privacy.dlp.v2.TableLocation.row_index",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3480,
+    serialized_end=3514,
+)
+
+
+_RANGE = _descriptor.Descriptor(
+    name="Range",
+    full_name="google.privacy.dlp.v2.Range",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start",
+            full_name="google.privacy.dlp.v2.Range.start",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end",
+            full_name="google.privacy.dlp.v2.Range.end",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3516,
+    serialized_end=3551,
+)
+
+
+_IMAGELOCATION = _descriptor.Descriptor(
+    name="ImageLocation",
+    full_name="google.privacy.dlp.v2.ImageLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_boxes",
+            full_name="google.privacy.dlp.v2.ImageLocation.bounding_boxes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3553,
+    serialized_end=3628,
+)
+
+
+_BOUNDINGBOX = _descriptor.Descriptor(
+    name="BoundingBox",
+    full_name="google.privacy.dlp.v2.BoundingBox",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="top",
+            full_name="google.privacy.dlp.v2.BoundingBox.top",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="left",
+            full_name="google.privacy.dlp.v2.BoundingBox.left",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.privacy.dlp.v2.BoundingBox.width",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.privacy.dlp.v2.BoundingBox.height",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3630,
+    serialized_end=3701,
+)
+
+
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG = _descriptor.Descriptor(
+    name="ImageRedactionConfig",
+    full_name="google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig.info_type",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redact_all_text",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig.redact_all_text",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redaction_color",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig.redaction_color",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig.target",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3987,
+    serialized_end=4155,
+)
+
+_REDACTIMAGEREQUEST = _descriptor.Descriptor(
+    name="RedactImageRequest",
+    full_name="google.privacy.dlp.v2.RedactImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_config",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.inspect_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_redaction_configs",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.image_redaction_configs",
+            index=2,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_findings",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.include_findings",
+            index=3,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="byte_item",
+            full_name="google.privacy.dlp.v2.RedactImageRequest.byte_item",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3704,
+    serialized_end=4155,
+)
+
+
+_COLOR = _descriptor.Descriptor(
+    name="Color",
+    full_name="google.privacy.dlp.v2.Color",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="red",
+            full_name="google.privacy.dlp.v2.Color.red",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="green",
+            full_name="google.privacy.dlp.v2.Color.green",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blue",
+            full_name="google.privacy.dlp.v2.Color.blue",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4157,
+    serialized_end=4206,
+)
+
+
+_REDACTIMAGERESPONSE = _descriptor.Descriptor(
+    name="RedactImageResponse",
+    full_name="google.privacy.dlp.v2.RedactImageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="redacted_image",
+            full_name="google.privacy.dlp.v2.RedactImageResponse.redacted_image",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extracted_text",
+            full_name="google.privacy.dlp.v2.RedactImageResponse.extracted_text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_result",
+            full_name="google.privacy.dlp.v2.RedactImageResponse.inspect_result",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4209,
+    serialized_end=4340,
+)
+
+
+_DEIDENTIFYCONTENTREQUEST = _descriptor.Descriptor(
+    name="DeidentifyContentRequest",
+    full_name="google.privacy.dlp.v2.DeidentifyContentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.DeidentifyContentRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deidentify_config",
+            full_name="google.privacy.dlp.v2.DeidentifyContentRequest.deidentify_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_config",
+            full_name="google.privacy.dlp.v2.DeidentifyContentRequest.inspect_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="item",
+            full_name="google.privacy.dlp.v2.DeidentifyContentRequest.item",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_template_name",
+            full_name="google.privacy.dlp.v2.DeidentifyContentRequest.inspect_template_name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deidentify_template_name",
+            full_name="google.privacy.dlp.v2.DeidentifyContentRequest.deidentify_template_name",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4343,
+    serialized_end=4630,
+)
+
+
+_DEIDENTIFYCONTENTRESPONSE = _descriptor.Descriptor(
+    name="DeidentifyContentResponse",
+    full_name="google.privacy.dlp.v2.DeidentifyContentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="item",
+            full_name="google.privacy.dlp.v2.DeidentifyContentResponse.item",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="overview",
+            full_name="google.privacy.dlp.v2.DeidentifyContentResponse.overview",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4633,
+    serialized_end=4775,
+)
+
+
+_REIDENTIFYCONTENTREQUEST = _descriptor.Descriptor(
+    name="ReidentifyContentRequest",
+    full_name="google.privacy.dlp.v2.ReidentifyContentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.ReidentifyContentRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reidentify_config",
+            full_name="google.privacy.dlp.v2.ReidentifyContentRequest.reidentify_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_config",
+            full_name="google.privacy.dlp.v2.ReidentifyContentRequest.inspect_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="item",
+            full_name="google.privacy.dlp.v2.ReidentifyContentRequest.item",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_template_name",
+            full_name="google.privacy.dlp.v2.ReidentifyContentRequest.inspect_template_name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reidentify_template_name",
+            full_name="google.privacy.dlp.v2.ReidentifyContentRequest.reidentify_template_name",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4778,
+    serialized_end=5065,
+)
+
+
+_REIDENTIFYCONTENTRESPONSE = _descriptor.Descriptor(
+    name="ReidentifyContentResponse",
+    full_name="google.privacy.dlp.v2.ReidentifyContentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="item",
+            full_name="google.privacy.dlp.v2.ReidentifyContentResponse.item",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="overview",
+            full_name="google.privacy.dlp.v2.ReidentifyContentResponse.overview",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5068,
+    serialized_end=5210,
+)
+
+
+_INSPECTCONTENTREQUEST = _descriptor.Descriptor(
+    name="InspectContentRequest",
+    full_name="google.privacy.dlp.v2.InspectContentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.InspectContentRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_config",
+            full_name="google.privacy.dlp.v2.InspectContentRequest.inspect_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="item",
+            full_name="google.privacy.dlp.v2.InspectContentRequest.item",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_template_name",
+            full_name="google.privacy.dlp.v2.InspectContentRequest.inspect_template_name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5213,
+    serialized_end=5395,
+)
+
+
+_INSPECTCONTENTRESPONSE = _descriptor.Descriptor(
+    name="InspectContentResponse",
+    full_name="google.privacy.dlp.v2.InspectContentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="result",
+            full_name="google.privacy.dlp.v2.InspectContentResponse.result",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5397,
+    serialized_end=5475,
+)
+
+
+_OUTPUTSTORAGECONFIG = _descriptor.Descriptor(
+    name="OutputStorageConfig",
+    full_name="google.privacy.dlp.v2.OutputStorageConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.privacy.dlp.v2.OutputStorageConfig.table",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_schema",
+            full_name="google.privacy.dlp.v2.OutputStorageConfig.output_schema",
+            index=1,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OUTPUTSTORAGECONFIG_OUTPUTSCHEMA],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.OutputStorageConfig.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=5478,
+    serialized_end=5789,
+)
+
+
+_INFOTYPESTATS = _descriptor.Descriptor(
+    name="InfoTypeStats",
+    full_name="google.privacy.dlp.v2.InfoTypeStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.InfoTypeStats.info_type",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.privacy.dlp.v2.InfoTypeStats.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5791,
+    serialized_end=5873,
+)
+
+
+_INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS = _descriptor.Descriptor(
+    name="RequestedOptions",
+    full_name="google.privacy.dlp.v2.InspectDataSourceDetails.RequestedOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshot_inspect_template",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.RequestedOptions.snapshot_inspect_template",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_config",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.RequestedOptions.job_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6070,
+    serialized_end=6224,
+)
+
+_INSPECTDATASOURCEDETAILS_RESULT = _descriptor.Descriptor(
+    name="Result",
+    full_name="google.privacy.dlp.v2.InspectDataSourceDetails.Result",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="processed_bytes",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.Result.processed_bytes",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_estimated_bytes",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.Result.total_estimated_bytes",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="info_type_stats",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.Result.info_type_stats",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6226,
+    serialized_end=6353,
+)
+
+_INSPECTDATASOURCEDETAILS = _descriptor.Descriptor(
+    name="InspectDataSourceDetails",
+    full_name="google.privacy.dlp.v2.InspectDataSourceDetails",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requested_options",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.requested_options",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result",
+            full_name="google.privacy.dlp.v2.InspectDataSourceDetails.result",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS,
+        _INSPECTDATASOURCEDETAILS_RESULT,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5876,
+    serialized_end=6353,
+)
+
+
+_INFOTYPEDESCRIPTION = _descriptor.Descriptor(
+    name="InfoTypeDescription",
+    full_name="google.privacy.dlp.v2.InfoTypeDescription",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.InfoTypeDescription.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.privacy.dlp.v2.InfoTypeDescription.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="supported_by",
+            full_name="google.privacy.dlp.v2.InfoTypeDescription.supported_by",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.privacy.dlp.v2.InfoTypeDescription.description",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6356,
+    serialized_end=6500,
+)
+
+
+_LISTINFOTYPESREQUEST = _descriptor.Descriptor(
+    name="ListInfoTypesRequest",
+    full_name="google.privacy.dlp.v2.ListInfoTypesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.privacy.dlp.v2.ListInfoTypesRequest.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.privacy.dlp.v2.ListInfoTypesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6502,
+    serialized_end=6563,
+)
+
+
+_LISTINFOTYPESRESPONSE = _descriptor.Descriptor(
+    name="ListInfoTypesResponse",
+    full_name="google.privacy.dlp.v2.ListInfoTypesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_types",
+            full_name="google.privacy.dlp.v2.ListInfoTypesResponse.info_types",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6565,
+    serialized_end=6652,
+)
+
+
+_RISKANALYSISJOBCONFIG = _descriptor.Descriptor(
+    name="RiskAnalysisJobConfig",
+    full_name="google.privacy.dlp.v2.RiskAnalysisJobConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="privacy_metric",
+            full_name="google.privacy.dlp.v2.RiskAnalysisJobConfig.privacy_metric",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_table",
+            full_name="google.privacy.dlp.v2.RiskAnalysisJobConfig.source_table",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="actions",
+            full_name="google.privacy.dlp.v2.RiskAnalysisJobConfig.actions",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6655,
+    serialized_end=6848,
+)
+
+
+_QUASIID = _descriptor.Descriptor(
+    name="QuasiId",
+    full_name="google.privacy.dlp.v2.QuasiId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.QuasiId.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.QuasiId.info_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_tag",
+            full_name="google.privacy.dlp.v2.QuasiId.custom_tag",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inferred",
+            full_name="google.privacy.dlp.v2.QuasiId.inferred",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="tag",
+            full_name="google.privacy.dlp.v2.QuasiId.tag",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=6851,
+    serialized_end=7034,
+)
+
+
+_STATISTICALTABLE_QUASIIDENTIFIERFIELD = _descriptor.Descriptor(
+    name="QuasiIdentifierField",
+    full_name="google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_tag",
+            full_name="google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField.custom_tag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7251,
+    serialized_end=7340,
+)
+
+_STATISTICALTABLE = _descriptor.Descriptor(
+    name="StatisticalTable",
+    full_name="google.privacy.dlp.v2.StatisticalTable",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.privacy.dlp.v2.StatisticalTable.table",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quasi_ids",
+            full_name="google.privacy.dlp.v2.StatisticalTable.quasi_ids",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_frequency",
+            full_name="google.privacy.dlp.v2.StatisticalTable.relative_frequency",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_STATISTICALTABLE_QUASIIDENTIFIERFIELD],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7037,
+    serialized_end=7340,
+)
+
+
+_PRIVACYMETRIC_NUMERICALSTATSCONFIG = _descriptor.Descriptor(
+    name="NumericalStatsConfig",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfig.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7926,
+    serialized_end=7995,
+)
+
+_PRIVACYMETRIC_CATEGORICALSTATSCONFIG = _descriptor.Descriptor(
+    name="CategoricalStatsConfig",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.CategoricalStatsConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.CategoricalStatsConfig.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7997,
+    serialized_end=8068,
+)
+
+_PRIVACYMETRIC_KANONYMITYCONFIG = _descriptor.Descriptor(
+    name="KAnonymityConfig",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.KAnonymityConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KAnonymityConfig.quasi_ids",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KAnonymityConfig.entity_id",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8070,
+    serialized_end=8191,
+)
+
+_PRIVACYMETRIC_LDIVERSITYCONFIG = _descriptor.Descriptor(
+    name="LDiversityConfig",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.LDiversityConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.LDiversityConfig.quasi_ids",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sensitive_attribute",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.LDiversityConfig.sensitive_attribute",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8194,
+    serialized_end=8324,
+)
+
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD = _descriptor.Descriptor(
+    name="TaggedField",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField.info_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_tag",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField.custom_tag",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inferred",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField.inferred",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="tag",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField.tag",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=8563,
+    serialized_end=8750,
+)
+
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE_QUASIIDFIELD = _descriptor.Descriptor(
+    name="QuasiIdField",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_tag",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField.custom_tag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8990,
+    serialized_end=9071,
+)
+
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE = _descriptor.Descriptor(
+    name="AuxiliaryTable",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.table",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quasi_ids",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.quasi_ids",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_frequency",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.relative_frequency",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE_QUASIIDFIELD],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8753,
+    serialized_end=9071,
+)
+
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG = _descriptor.Descriptor(
+    name="KMapEstimationConfig",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.quasi_ids",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region_code",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.region_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auxiliary_tables",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.auxiliary_tables",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD,
+        _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8327,
+    serialized_end=9071,
+)
+
+_PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG = _descriptor.Descriptor(
+    name="DeltaPresenceEstimationConfig",
+    full_name="google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig.quasi_ids",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region_code",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig.region_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auxiliary_tables",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig.auxiliary_tables",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=9074,
+    serialized_end=9244,
+)
+
+_PRIVACYMETRIC = _descriptor.Descriptor(
+    name="PrivacyMetric",
+    full_name="google.privacy.dlp.v2.PrivacyMetric",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="numerical_stats_config",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.numerical_stats_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="categorical_stats_config",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.categorical_stats_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="k_anonymity_config",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.k_anonymity_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="l_diversity_config",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.l_diversity_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="k_map_estimation_config",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.k_map_estimation_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delta_presence_estimation_config",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.delta_presence_estimation_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _PRIVACYMETRIC_NUMERICALSTATSCONFIG,
+        _PRIVACYMETRIC_CATEGORICALSTATSCONFIG,
+        _PRIVACYMETRIC_KANONYMITYCONFIG,
+        _PRIVACYMETRIC_LDIVERSITYCONFIG,
+        _PRIVACYMETRIC_KMAPESTIMATIONCONFIG,
+        _PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.PrivacyMetric.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=7343,
+    serialized_end=9252,
+)
+
+
+_ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT = _descriptor.Descriptor(
+    name="NumericalStatsResult",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_value",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult.min_value",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_value",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult.max_value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="quantile_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult.quantile_values",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10086,
+    serialized_end=10261,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT_CATEGORICALSTATSHISTOGRAMBUCKET = _descriptor.Descriptor(
+    name="CategoricalStatsHistogramBucket",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value_frequency_lower_bound",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket.value_frequency_lower_bound",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value_frequency_upper_bound",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket.value_frequency_upper_bound",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket.bucket_size",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket.bucket_values",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_value_count",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket.bucket_value_count",
+            index=4,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10443,
+    serialized_end=10661,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT = _descriptor.Descriptor(
+    name="CategoricalStatsResult",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value_frequency_histogram_buckets",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.value_frequency_histogram_buckets",
+            index=0,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT_CATEGORICALSTATSHISTOGRAMBUCKET
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10264,
+    serialized_end=10661,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYEQUIVALENCECLASS = _descriptor.Descriptor(
+    name="KAnonymityEquivalenceClass",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityEquivalenceClass",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityEquivalenceClass.quasi_ids_values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="equivalence_class_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityEquivalenceClass.equivalence_class_size",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10826,
+    serialized_end=10942,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYHISTOGRAMBUCKET = _descriptor.Descriptor(
+    name="KAnonymityHistogramBucket",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="equivalence_class_size_lower_bound",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket.equivalence_class_size_lower_bound",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="equivalence_class_size_upper_bound",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket.equivalence_class_size_upper_bound",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket.bucket_size",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket.bucket_values",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_value_count",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket.bucket_value_count",
+            index=4,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10945,
+    serialized_end=11229,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT = _descriptor.Descriptor(
+    name="KAnonymityResult",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="equivalence_class_histogram_buckets",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.equivalence_class_histogram_buckets",
+            index=0,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYEQUIVALENCECLASS,
+        _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYHISTOGRAMBUCKET,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=10664,
+    serialized_end=11229,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS = _descriptor.Descriptor(
+    name="LDiversityEquivalenceClass",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass.quasi_ids_values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="equivalence_class_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass.equivalence_class_size",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_distinct_sensitive_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass.num_distinct_sensitive_values",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top_sensitive_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass.top_sensitive_values",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11403,
+    serialized_end=11627,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYHISTOGRAMBUCKET = _descriptor.Descriptor(
+    name="LDiversityHistogramBucket",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sensitive_value_frequency_lower_bound",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket.sensitive_value_frequency_lower_bound",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sensitive_value_frequency_upper_bound",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket.sensitive_value_frequency_upper_bound",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket.bucket_size",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket.bucket_values",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_value_count",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket.bucket_value_count",
+            index=4,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11630,
+    serialized_end=11920,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT = _descriptor.Descriptor(
+    name="LDiversityResult",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sensitive_value_frequency_histogram_buckets",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.sensitive_value_frequency_histogram_buckets",
+            index=0,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS,
+        _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYHISTOGRAMBUCKET,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11232,
+    serialized_end=11920,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONQUASIIDVALUES = _descriptor.Descriptor(
+    name="KMapEstimationQuasiIdValues",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues.quasi_ids_values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="estimated_anonymity",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues.estimated_anonymity",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12088,
+    serialized_end=12202,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONHISTOGRAMBUCKET = _descriptor.Descriptor(
+    name="KMapEstimationHistogramBucket",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_anonymity",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket.min_anonymity",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_anonymity",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket.max_anonymity",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket.bucket_size",
+            index=2,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket.bucket_values",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_value_count",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket.bucket_value_count",
+            index=4,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12205,
+    serialized_end=12456,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT = _descriptor.Descriptor(
+    name="KMapEstimationResult",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="k_map_estimation_histogram",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.k_map_estimation_histogram",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONQUASIIDVALUES,
+        _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONHISTOGRAMBUCKET,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=11923,
+    serialized_end=12456,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONQUASIIDVALUES = _descriptor.Descriptor(
+    name="DeltaPresenceEstimationQuasiIdValues",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="quasi_ids_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues.quasi_ids_values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="estimated_probability",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues.estimated_probability",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12660,
+    serialized_end=12785,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONHISTOGRAMBUCKET = _descriptor.Descriptor(
+    name="DeltaPresenceEstimationHistogramBucket",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_probability",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket.min_probability",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_probability",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket.max_probability",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_size",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket.bucket_size",
+            index=2,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_values",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket.bucket_values",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_value_count",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket.bucket_value_count",
+            index=4,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12788,
+    serialized_end=13071,
+)
+
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT = _descriptor.Descriptor(
+    name="DeltaPresenceEstimationResult",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="delta_presence_estimation_histogram",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.delta_presence_estimation_histogram",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONQUASIIDVALUES,
+        _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONHISTOGRAMBUCKET,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=12459,
+    serialized_end=13071,
+)
+
+_ANALYZEDATASOURCERISKDETAILS = _descriptor.Descriptor(
+    name="AnalyzeDataSourceRiskDetails",
+    full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requested_privacy_metric",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.requested_privacy_metric",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="requested_source_table",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.requested_source_table",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="numerical_stats_result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.numerical_stats_result",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="categorical_stats_result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.categorical_stats_result",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="k_anonymity_result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.k_anonymity_result",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="l_diversity_result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.l_diversity_result",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="k_map_estimation_result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.k_map_estimation_result",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delta_presence_estimation_result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.delta_presence_estimation_result",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT,
+        _ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT,
+        _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT,
+        _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT,
+        _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT,
+        _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="result",
+            full_name="google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.result",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=9255,
+    serialized_end=13081,
+)
+
+
+_VALUEFREQUENCY = _descriptor.Descriptor(
+    name="ValueFrequency",
+    full_name="google.privacy.dlp.v2.ValueFrequency",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.privacy.dlp.v2.ValueFrequency.value",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.privacy.dlp.v2.ValueFrequency.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13083,
+    serialized_end=13159,
+)
+
+
+_VALUE = _descriptor.Descriptor(
+    name="Value",
+    full_name="google.privacy.dlp.v2.Value",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="integer_value",
+            full_name="google.privacy.dlp.v2.Value.integer_value",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="float_value",
+            full_name="google.privacy.dlp.v2.Value.float_value",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.privacy.dlp.v2.Value.string_value",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boolean_value",
+            full_name="google.privacy.dlp.v2.Value.boolean_value",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_value",
+            full_name="google.privacy.dlp.v2.Value.timestamp_value",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_value",
+            full_name="google.privacy.dlp.v2.Value.time_value",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="date_value",
+            full_name="google.privacy.dlp.v2.Value.date_value",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="day_of_week_value",
+            full_name="google.privacy.dlp.v2.Value.day_of_week_value",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.Value.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=13162,
+    serialized_end=13469,
+)
+
+
+_QUOTEINFO = _descriptor.Descriptor(
+    name="QuoteInfo",
+    full_name="google.privacy.dlp.v2.QuoteInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="date_time",
+            full_name="google.privacy.dlp.v2.QuoteInfo.date_time",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="parsed_quote",
+            full_name="google.privacy.dlp.v2.QuoteInfo.parsed_quote",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=13471,
+    serialized_end=13552,
+)
+
+
+_DATETIME_TIMEZONE = _descriptor.Descriptor(
+    name="TimeZone",
+    full_name="google.privacy.dlp.v2.DateTime.TimeZone",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="offset_minutes",
+            full_name="google.privacy.dlp.v2.DateTime.TimeZone.offset_minutes",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13744,
+    serialized_end=13778,
+)
+
+_DATETIME = _descriptor.Descriptor(
+    name="DateTime",
+    full_name="google.privacy.dlp.v2.DateTime",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="date",
+            full_name="google.privacy.dlp.v2.DateTime.date",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="day_of_week",
+            full_name="google.privacy.dlp.v2.DateTime.day_of_week",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time",
+            full_name="google.privacy.dlp.v2.DateTime.time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_zone",
+            full_name="google.privacy.dlp.v2.DateTime.time_zone",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DATETIME_TIMEZONE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=13555,
+    serialized_end=13778,
+)
+
+
+_DEIDENTIFYCONFIG = _descriptor.Descriptor(
+    name="DeidentifyConfig",
+    full_name="google.privacy.dlp.v2.DeidentifyConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_type_transformations",
+            full_name="google.privacy.dlp.v2.DeidentifyConfig.info_type_transformations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="record_transformations",
+            full_name="google.privacy.dlp.v2.DeidentifyConfig.record_transformations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transformation",
+            full_name="google.privacy.dlp.v2.DeidentifyConfig.transformation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=13781,
+    serialized_end=13982,
+)
+
+
+_PRIMITIVETRANSFORMATION = _descriptor.Descriptor(
+    name="PrimitiveTransformation",
+    full_name="google.privacy.dlp.v2.PrimitiveTransformation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="replace_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.replace_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redact_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.redact_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="character_mask_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.character_mask_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_replace_ffx_fpe_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.crypto_replace_ffx_fpe_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_size_bucketing_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.fixed_size_bucketing_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucketing_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.bucketing_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="replace_with_info_type_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.replace_with_info_type_config",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_part_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.time_part_config",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_hash_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.crypto_hash_config",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="date_shift_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.date_shift_config",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_deterministic_config",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.crypto_deterministic_config",
+            index=10,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transformation",
+            full_name="google.privacy.dlp.v2.PrimitiveTransformation.transformation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=13985,
+    serialized_end=14870,
+)
+
+
+_TIMEPARTCONFIG = _descriptor.Descriptor(
+    name="TimePartConfig",
+    full_name="google.privacy.dlp.v2.TimePartConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="part_to_extract",
+            full_name="google.privacy.dlp.v2.TimePartConfig.part_to_extract",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TIMEPARTCONFIG_TIMEPART],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=14873,
+    serialized_end=15093,
+)
+
+
+_CRYPTOHASHCONFIG = _descriptor.Descriptor(
+    name="CryptoHashConfig",
+    full_name="google.privacy.dlp.v2.CryptoHashConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_key",
+            full_name="google.privacy.dlp.v2.CryptoHashConfig.crypto_key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15095,
+    serialized_end=15167,
+)
+
+
+_CRYPTODETERMINISTICCONFIG = _descriptor.Descriptor(
+    name="CryptoDeterministicConfig",
+    full_name="google.privacy.dlp.v2.CryptoDeterministicConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_key",
+            full_name="google.privacy.dlp.v2.CryptoDeterministicConfig.crypto_key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surrogate_info_type",
+            full_name="google.privacy.dlp.v2.CryptoDeterministicConfig.surrogate_info_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.privacy.dlp.v2.CryptoDeterministicConfig.context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15170,
+    serialized_end=15362,
+)
+
+
+_REPLACEVALUECONFIG = _descriptor.Descriptor(
+    name="ReplaceValueConfig",
+    full_name="google.privacy.dlp.v2.ReplaceValueConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="new_value",
+            full_name="google.privacy.dlp.v2.ReplaceValueConfig.new_value",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15364,
+    serialized_end=15433,
+)
+
+
+_REPLACEWITHINFOTYPECONFIG = _descriptor.Descriptor(
+    name="ReplaceWithInfoTypeConfig",
+    full_name="google.privacy.dlp.v2.ReplaceWithInfoTypeConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15435,
+    serialized_end=15462,
+)
+
+
+_REDACTCONFIG = _descriptor.Descriptor(
+    name="RedactConfig",
+    full_name="google.privacy.dlp.v2.RedactConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15464,
+    serialized_end=15478,
+)
+
+
+_CHARSTOIGNORE = _descriptor.Descriptor(
+    name="CharsToIgnore",
+    full_name="google.privacy.dlp.v2.CharsToIgnore",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="characters_to_skip",
+            full_name="google.privacy.dlp.v2.CharsToIgnore.characters_to_skip",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="common_characters_to_ignore",
+            full_name="google.privacy.dlp.v2.CharsToIgnore.common_characters_to_ignore",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CHARSTOIGNORE_COMMONCHARSTOIGNORE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="characters",
+            full_name="google.privacy.dlp.v2.CharsToIgnore.characters",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=15481,
+    serialized_end=15791,
+)
+
+
+_CHARACTERMASKCONFIG = _descriptor.Descriptor(
+    name="CharacterMaskConfig",
+    full_name="google.privacy.dlp.v2.CharacterMaskConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="masking_character",
+            full_name="google.privacy.dlp.v2.CharacterMaskConfig.masking_character",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="number_to_mask",
+            full_name="google.privacy.dlp.v2.CharacterMaskConfig.number_to_mask",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reverse_order",
+            full_name="google.privacy.dlp.v2.CharacterMaskConfig.reverse_order",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="characters_to_ignore",
+            full_name="google.privacy.dlp.v2.CharacterMaskConfig.characters_to_ignore",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15794,
+    serialized_end=15957,
+)
+
+
+_FIXEDSIZEBUCKETINGCONFIG = _descriptor.Descriptor(
+    name="FixedSizeBucketingConfig",
+    full_name="google.privacy.dlp.v2.FixedSizeBucketingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lower_bound",
+            full_name="google.privacy.dlp.v2.FixedSizeBucketingConfig.lower_bound",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="upper_bound",
+            full_name="google.privacy.dlp.v2.FixedSizeBucketingConfig.upper_bound",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_size",
+            full_name="google.privacy.dlp.v2.FixedSizeBucketingConfig.bucket_size",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=15960,
+    serialized_end=16109,
+)
+
+
+_BUCKETINGCONFIG_BUCKET = _descriptor.Descriptor(
+    name="Bucket",
+    full_name="google.privacy.dlp.v2.BucketingConfig.Bucket",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min",
+            full_name="google.privacy.dlp.v2.BucketingConfig.Bucket.min",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max",
+            full_name="google.privacy.dlp.v2.BucketingConfig.Bucket.max",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="replacement_value",
+            full_name="google.privacy.dlp.v2.BucketingConfig.Bucket.replacement_value",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=16196,
+    serialized_end=16347,
+)
+
+_BUCKETINGCONFIG = _descriptor.Descriptor(
+    name="BucketingConfig",
+    full_name="google.privacy.dlp.v2.BucketingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="buckets",
+            full_name="google.privacy.dlp.v2.BucketingConfig.buckets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_BUCKETINGCONFIG_BUCKET],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=16112,
+    serialized_end=16347,
+)
+
+
+_CRYPTOREPLACEFFXFPECONFIG = _descriptor.Descriptor(
+    name="CryptoReplaceFfxFpeConfig",
+    full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_key",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.crypto_key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.context",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="common_alphabet",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.common_alphabet",
+            index=2,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_alphabet",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.custom_alphabet",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="radix",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.radix",
+            index=4,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surrogate_info_type",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.surrogate_info_type",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CRYPTOREPLACEFFXFPECONFIG_FFXCOMMONNATIVEALPHABET],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="alphabet",
+            full_name="google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig.alphabet",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=16350,
+    serialized_end=16850,
+)
+
+
+_CRYPTOKEY = _descriptor.Descriptor(
+    name="CryptoKey",
+    full_name="google.privacy.dlp.v2.CryptoKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transient",
+            full_name="google.privacy.dlp.v2.CryptoKey.transient",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unwrapped",
+            full_name="google.privacy.dlp.v2.CryptoKey.unwrapped",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kms_wrapped",
+            full_name="google.privacy.dlp.v2.CryptoKey.kms_wrapped",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.privacy.dlp.v2.CryptoKey.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=16853,
+    serialized_end=17069,
+)
+
+
+_TRANSIENTCRYPTOKEY = _descriptor.Descriptor(
+    name="TransientCryptoKey",
+    full_name="google.privacy.dlp.v2.TransientCryptoKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.TransientCryptoKey.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=17071,
+    serialized_end=17105,
+)
+
+
+_UNWRAPPEDCRYPTOKEY = _descriptor.Descriptor(
+    name="UnwrappedCryptoKey",
+    full_name="google.privacy.dlp.v2.UnwrappedCryptoKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.privacy.dlp.v2.UnwrappedCryptoKey.key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=17107,
+    serialized_end=17140,
+)
+
+
+_KMSWRAPPEDCRYPTOKEY = _descriptor.Descriptor(
+    name="KmsWrappedCryptoKey",
+    full_name="google.privacy.dlp.v2.KmsWrappedCryptoKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="wrapped_key",
+            full_name="google.privacy.dlp.v2.KmsWrappedCryptoKey.wrapped_key",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_key_name",
+            full_name="google.privacy.dlp.v2.KmsWrappedCryptoKey.crypto_key_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=17142,
+    serialized_end=17209,
+)
+
+
+_DATESHIFTCONFIG = _descriptor.Descriptor(
+    name="DateShiftConfig",
+    full_name="google.privacy.dlp.v2.DateShiftConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="upper_bound_days",
+            full_name="google.privacy.dlp.v2.DateShiftConfig.upper_bound_days",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lower_bound_days",
+            full_name="google.privacy.dlp.v2.DateShiftConfig.lower_bound_days",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.privacy.dlp.v2.DateShiftConfig.context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_key",
+            full_name="google.privacy.dlp.v2.DateShiftConfig.crypto_key",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="method",
+            full_name="google.privacy.dlp.v2.DateShiftConfig.method",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=17212,
+    serialized_end=17396,
+)
+
+
+_INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION = _descriptor.Descriptor(
+    name="InfoTypeTransformation",
+    full_name="google.privacy.dlp.v2.InfoTypeTransformations.InfoTypeTransformation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_types",
+            full_name="google.privacy.dlp.v2.InfoTypeTransformations.InfoTypeTransformation.info_types",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="primitive_transformation",
+            full_name="google.privacy.dlp.v2.InfoTypeTransformations.InfoTypeTransformation.primitive_transformation",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=17523,
+    serialized_end=17682,
+)
+
+_INFOTYPETRANSFORMATIONS = _descriptor.Descriptor(
+    name="InfoTypeTransformations",
+    full_name="google.privacy.dlp.v2.InfoTypeTransformations",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transformations",
+            full_name="google.privacy.dlp.v2.InfoTypeTransformations.transformations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=17399,
+    serialized_end=17682,
+)
+
+
+_FIELDTRANSFORMATION = _descriptor.Descriptor(
+    name="FieldTransformation",
+    full_name="google.privacy.dlp.v2.FieldTransformation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.privacy.dlp.v2.FieldTransformation.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="condition",
+            full_name="google.privacy.dlp.v2.FieldTransformation.condition",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="primitive_transformation",
+            full_name="google.privacy.dlp.v2.FieldTransformation.primitive_transformation",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="info_type_transformations",
+            full_name="google.privacy.dlp.v2.FieldTransformation.info_type_transformations",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transformation",
+            full_name="google.privacy.dlp.v2.FieldTransformation.transformation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=17685,
+    serialized_end=18000,
+)
+
+
+_RECORDTRANSFORMATIONS = _descriptor.Descriptor(
+    name="RecordTransformations",
+    full_name="google.privacy.dlp.v2.RecordTransformations",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_transformations",
+            full_name="google.privacy.dlp.v2.RecordTransformations.field_transformations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="record_suppressions",
+            full_name="google.privacy.dlp.v2.RecordTransformations.record_suppressions",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18003,
+    serialized_end=18172,
+)
+
+
+_RECORDSUPPRESSION = _descriptor.Descriptor(
+    name="RecordSuppression",
+    full_name="google.privacy.dlp.v2.RecordSuppression",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="condition",
+            full_name="google.privacy.dlp.v2.RecordSuppression.condition",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18174,
+    serialized_end=18252,
+)
+
+
+_RECORDCONDITION_CONDITION = _descriptor.Descriptor(
+    name="Condition",
+    full_name="google.privacy.dlp.v2.RecordCondition.Condition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.RecordCondition.Condition.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operator",
+            full_name="google.privacy.dlp.v2.RecordCondition.Condition.operator",
+            index=1,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.privacy.dlp.v2.RecordCondition.Condition.value",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18348,
+    serialized_end=18512,
+)
+
+_RECORDCONDITION_CONDITIONS = _descriptor.Descriptor(
+    name="Conditions",
+    full_name="google.privacy.dlp.v2.RecordCondition.Conditions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="conditions",
+            full_name="google.privacy.dlp.v2.RecordCondition.Conditions.conditions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18514,
+    serialized_end=18596,
+)
+
+_RECORDCONDITION_EXPRESSIONS = _descriptor.Descriptor(
+    name="Expressions",
+    full_name="google.privacy.dlp.v2.RecordCondition.Expressions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="logical_operator",
+            full_name="google.privacy.dlp.v2.RecordCondition.Expressions.logical_operator",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="conditions",
+            full_name="google.privacy.dlp.v2.RecordCondition.Expressions.conditions",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_RECORDCONDITION_EXPRESSIONS_LOGICALOPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.RecordCondition.Expressions.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=18599,
+    serialized_end=18849,
+)
+
+_RECORDCONDITION = _descriptor.Descriptor(
+    name="RecordCondition",
+    full_name="google.privacy.dlp.v2.RecordCondition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="expressions",
+            full_name="google.privacy.dlp.v2.RecordCondition.expressions",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _RECORDCONDITION_CONDITION,
+        _RECORDCONDITION_CONDITIONS,
+        _RECORDCONDITION_EXPRESSIONS,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18255,
+    serialized_end=18849,
+)
+
+
+_TRANSFORMATIONOVERVIEW = _descriptor.Descriptor(
+    name="TransformationOverview",
+    full_name="google.privacy.dlp.v2.TransformationOverview",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transformed_bytes",
+            full_name="google.privacy.dlp.v2.TransformationOverview.transformed_bytes",
+            index=0,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transformation_summaries",
+            full_name="google.privacy.dlp.v2.TransformationOverview.transformation_summaries",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18852,
+    serialized_end=18983,
+)
+
+
+_TRANSFORMATIONSUMMARY_SUMMARYRESULT = _descriptor.Descriptor(
+    name="SummaryResult",
+    full_name="google.privacy.dlp.v2.TransformationSummary.SummaryResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.privacy.dlp.v2.TransformationSummary.SummaryResult.count",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.privacy.dlp.v2.TransformationSummary.SummaryResult.code",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="google.privacy.dlp.v2.TransformationSummary.SummaryResult.details",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=19429,
+    serialized_end=19561,
+)
+
+_TRANSFORMATIONSUMMARY = _descriptor.Descriptor(
+    name="TransformationSummary",
+    full_name="google.privacy.dlp.v2.TransformationSummary",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.TransformationSummary.info_type",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.TransformationSummary.field",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transformation",
+            full_name="google.privacy.dlp.v2.TransformationSummary.transformation",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_transformations",
+            full_name="google.privacy.dlp.v2.TransformationSummary.field_transformations",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="record_suppress",
+            full_name="google.privacy.dlp.v2.TransformationSummary.record_suppress",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.privacy.dlp.v2.TransformationSummary.results",
+            index=5,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transformed_bytes",
+            full_name="google.privacy.dlp.v2.TransformationSummary.transformed_bytes",
+            index=6,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TRANSFORMATIONSUMMARY_SUMMARYRESULT],
+    enum_types=[_TRANSFORMATIONSUMMARY_TRANSFORMATIONRESULTCODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=18986,
+    serialized_end=19657,
+)
+
+
+_SCHEDULE = _descriptor.Descriptor(
+    name="Schedule",
+    full_name="google.privacy.dlp.v2.Schedule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="recurrence_period_duration",
+            full_name="google.privacy.dlp.v2.Schedule.recurrence_period_duration",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="option",
+            full_name="google.privacy.dlp.v2.Schedule.option",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=19659,
+    serialized_end=19744,
+)
+
+
+_INSPECTTEMPLATE = _descriptor.Descriptor(
+    name="InspectTemplate",
+    full_name="google.privacy.dlp.v2.InspectTemplate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.InspectTemplate.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.privacy.dlp.v2.InspectTemplate.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.privacy.dlp.v2.InspectTemplate.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.InspectTemplate.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.privacy.dlp.v2.InspectTemplate.update_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_config",
+            full_name="google.privacy.dlp.v2.InspectTemplate.inspect_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=19747,
+    serialized_end=19981,
+)
+
+
+_DEIDENTIFYTEMPLATE = _descriptor.Descriptor(
+    name="DeidentifyTemplate",
+    full_name="google.privacy.dlp.v2.DeidentifyTemplate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DeidentifyTemplate.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.privacy.dlp.v2.DeidentifyTemplate.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.privacy.dlp.v2.DeidentifyTemplate.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.DeidentifyTemplate.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.privacy.dlp.v2.DeidentifyTemplate.update_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deidentify_config",
+            full_name="google.privacy.dlp.v2.DeidentifyTemplate.deidentify_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=19984,
+    serialized_end=20227,
+)
+
+
+_ERROR = _descriptor.Descriptor(
+    name="Error",
+    full_name="google.privacy.dlp.v2.Error",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="google.privacy.dlp.v2.Error.details",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamps",
+            full_name="google.privacy.dlp.v2.Error.timestamps",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=20229,
+    serialized_end=20321,
+)
+
+
+_JOBTRIGGER_TRIGGER = _descriptor.Descriptor(
+    name="Trigger",
+    full_name="google.privacy.dlp.v2.JobTrigger.Trigger",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.privacy.dlp.v2.JobTrigger.Trigger.schedule",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="trigger",
+            full_name="google.privacy.dlp.v2.JobTrigger.Trigger.trigger",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=20773,
+    serialized_end=20846,
+)
+
+_JOBTRIGGER = _descriptor.Descriptor(
+    name="JobTrigger",
+    full_name="google.privacy.dlp.v2.JobTrigger",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.JobTrigger.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.privacy.dlp.v2.JobTrigger.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.privacy.dlp.v2.JobTrigger.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_job",
+            full_name="google.privacy.dlp.v2.JobTrigger.inspect_job",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="triggers",
+            full_name="google.privacy.dlp.v2.JobTrigger.triggers",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="errors",
+            full_name="google.privacy.dlp.v2.JobTrigger.errors",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.JobTrigger.create_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.privacy.dlp.v2.JobTrigger.update_time",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_run_time",
+            full_name="google.privacy.dlp.v2.JobTrigger.last_run_time",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.privacy.dlp.v2.JobTrigger.status",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_JOBTRIGGER_TRIGGER],
+    enum_types=[_JOBTRIGGER_STATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="job",
+            full_name="google.privacy.dlp.v2.JobTrigger.job",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=20324,
+    serialized_end=20927,
+)
+
+
+_ACTION_SAVEFINDINGS = _descriptor.Descriptor(
+    name="SaveFindings",
+    full_name="google.privacy.dlp.v2.Action.SaveFindings",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.privacy.dlp.v2.Action.SaveFindings.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21365,
+    serialized_end=21446,
+)
+
+_ACTION_PUBLISHTOPUBSUB = _descriptor.Descriptor(
+    name="PublishToPubSub",
+    full_name="google.privacy.dlp.v2.Action.PublishToPubSub",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.privacy.dlp.v2.Action.PublishToPubSub.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21448,
+    serialized_end=21480,
+)
+
+_ACTION_PUBLISHSUMMARYTOCSCC = _descriptor.Descriptor(
+    name="PublishSummaryToCscc",
+    full_name="google.privacy.dlp.v2.Action.PublishSummaryToCscc",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21482,
+    serialized_end=21504,
+)
+
+_ACTION_PUBLISHFINDINGSTOCLOUDDATACATALOG = _descriptor.Descriptor(
+    name="PublishFindingsToCloudDataCatalog",
+    full_name="google.privacy.dlp.v2.Action.PublishFindingsToCloudDataCatalog",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21506,
+    serialized_end=21541,
+)
+
+_ACTION_JOBNOTIFICATIONEMAILS = _descriptor.Descriptor(
+    name="JobNotificationEmails",
+    full_name="google.privacy.dlp.v2.Action.JobNotificationEmails",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21543,
+    serialized_end=21566,
+)
+
+_ACTION = _descriptor.Descriptor(
+    name="Action",
+    full_name="google.privacy.dlp.v2.Action",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="save_findings",
+            full_name="google.privacy.dlp.v2.Action.save_findings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pub_sub",
+            full_name="google.privacy.dlp.v2.Action.pub_sub",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publish_summary_to_cscc",
+            full_name="google.privacy.dlp.v2.Action.publish_summary_to_cscc",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publish_findings_to_cloud_data_catalog",
+            full_name="google.privacy.dlp.v2.Action.publish_findings_to_cloud_data_catalog",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_notification_emails",
+            full_name="google.privacy.dlp.v2.Action.job_notification_emails",
+            index=4,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _ACTION_SAVEFINDINGS,
+        _ACTION_PUBLISHTOPUBSUB,
+        _ACTION_PUBLISHSUMMARYTOCSCC,
+        _ACTION_PUBLISHFINDINGSTOCLOUDDATACATALOG,
+        _ACTION_JOBNOTIFICATIONEMAILS,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="action",
+            full_name="google.privacy.dlp.v2.Action.action",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=20930,
+    serialized_end=21576,
+)
+
+
+_CREATEINSPECTTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="CreateInspectTemplateRequest",
+    full_name="google.privacy.dlp.v2.CreateInspectTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.CreateInspectTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_template",
+            full_name="google.privacy.dlp.v2.CreateInspectTemplateRequest.inspect_template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template_id",
+            full_name="google.privacy.dlp.v2.CreateInspectTemplateRequest.template_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21579,
+    serialized_end=21712,
+)
+
+
+_UPDATEINSPECTTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="UpdateInspectTemplateRequest",
+    full_name="google.privacy.dlp.v2.UpdateInspectTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.UpdateInspectTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_template",
+            full_name="google.privacy.dlp.v2.UpdateInspectTemplateRequest.inspect_template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.privacy.dlp.v2.UpdateInspectTemplateRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21715,
+    serialized_end=21874,
+)
+
+
+_GETINSPECTTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="GetInspectTemplateRequest",
+    full_name="google.privacy.dlp.v2.GetInspectTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.GetInspectTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21876,
+    serialized_end=21917,
+)
+
+
+_LISTINSPECTTEMPLATESREQUEST = _descriptor.Descriptor(
+    name="ListInspectTemplatesRequest",
+    full_name="google.privacy.dlp.v2.ListInspectTemplatesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.ListInspectTemplatesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.privacy.dlp.v2.ListInspectTemplatesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.privacy.dlp.v2.ListInspectTemplatesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.privacy.dlp.v2.ListInspectTemplatesRequest.order_by",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=21919,
+    serialized_end=22021,
+)
+
+
+_LISTINSPECTTEMPLATESRESPONSE = _descriptor.Descriptor(
+    name="ListInspectTemplatesResponse",
+    full_name="google.privacy.dlp.v2.ListInspectTemplatesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="inspect_templates",
+            full_name="google.privacy.dlp.v2.ListInspectTemplatesResponse.inspect_templates",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.privacy.dlp.v2.ListInspectTemplatesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22023,
+    serialized_end=22145,
+)
+
+
+_DELETEINSPECTTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="DeleteInspectTemplateRequest",
+    full_name="google.privacy.dlp.v2.DeleteInspectTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DeleteInspectTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22147,
+    serialized_end=22191,
+)
+
+
+_CREATEJOBTRIGGERREQUEST = _descriptor.Descriptor(
+    name="CreateJobTriggerRequest",
+    full_name="google.privacy.dlp.v2.CreateJobTriggerRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.CreateJobTriggerRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_trigger",
+            full_name="google.privacy.dlp.v2.CreateJobTriggerRequest.job_trigger",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trigger_id",
+            full_name="google.privacy.dlp.v2.CreateJobTriggerRequest.trigger_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22193,
+    serialized_end=22310,
+)
+
+
+_ACTIVATEJOBTRIGGERREQUEST = _descriptor.Descriptor(
+    name="ActivateJobTriggerRequest",
+    full_name="google.privacy.dlp.v2.ActivateJobTriggerRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.ActivateJobTriggerRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22312,
+    serialized_end=22353,
+)
+
+
+_UPDATEJOBTRIGGERREQUEST = _descriptor.Descriptor(
+    name="UpdateJobTriggerRequest",
+    full_name="google.privacy.dlp.v2.UpdateJobTriggerRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.UpdateJobTriggerRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_trigger",
+            full_name="google.privacy.dlp.v2.UpdateJobTriggerRequest.job_trigger",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.privacy.dlp.v2.UpdateJobTriggerRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22356,
+    serialized_end=22500,
+)
+
+
+_GETJOBTRIGGERREQUEST = _descriptor.Descriptor(
+    name="GetJobTriggerRequest",
+    full_name="google.privacy.dlp.v2.GetJobTriggerRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.GetJobTriggerRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22502,
+    serialized_end=22538,
+)
+
+
+_CREATEDLPJOBREQUEST = _descriptor.Descriptor(
+    name="CreateDlpJobRequest",
+    full_name="google.privacy.dlp.v2.CreateDlpJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.CreateDlpJobRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_job",
+            full_name="google.privacy.dlp.v2.CreateDlpJobRequest.inspect_job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="risk_job",
+            full_name="google.privacy.dlp.v2.CreateDlpJobRequest.risk_job",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_id",
+            full_name="google.privacy.dlp.v2.CreateDlpJobRequest.job_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="job",
+            full_name="google.privacy.dlp.v2.CreateDlpJobRequest.job",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=22541,
+    serialized_end=22731,
+)
+
+
+_LISTJOBTRIGGERSREQUEST = _descriptor.Descriptor(
+    name="ListJobTriggersRequest",
+    full_name="google.privacy.dlp.v2.ListJobTriggersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.ListJobTriggersRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.privacy.dlp.v2.ListJobTriggersRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.privacy.dlp.v2.ListJobTriggersRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.privacy.dlp.v2.ListJobTriggersRequest.order_by",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.privacy.dlp.v2.ListJobTriggersRequest.filter",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22733,
+    serialized_end=22846,
+)
+
+
+_LISTJOBTRIGGERSRESPONSE = _descriptor.Descriptor(
+    name="ListJobTriggersResponse",
+    full_name="google.privacy.dlp.v2.ListJobTriggersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job_triggers",
+            full_name="google.privacy.dlp.v2.ListJobTriggersResponse.job_triggers",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.privacy.dlp.v2.ListJobTriggersResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22848,
+    serialized_end=22955,
+)
+
+
+_DELETEJOBTRIGGERREQUEST = _descriptor.Descriptor(
+    name="DeleteJobTriggerRequest",
+    full_name="google.privacy.dlp.v2.DeleteJobTriggerRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DeleteJobTriggerRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22957,
+    serialized_end=22996,
+)
+
+
+_INSPECTJOBCONFIG = _descriptor.Descriptor(
+    name="InspectJobConfig",
+    full_name="google.privacy.dlp.v2.InspectJobConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="storage_config",
+            full_name="google.privacy.dlp.v2.InspectJobConfig.storage_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_config",
+            full_name="google.privacy.dlp.v2.InspectJobConfig.inspect_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_template_name",
+            full_name="google.privacy.dlp.v2.InspectJobConfig.inspect_template_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="actions",
+            full_name="google.privacy.dlp.v2.InspectJobConfig.actions",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=22999,
+    serialized_end=23220,
+)
+
+
+_DLPJOB = _descriptor.Descriptor(
+    name="DlpJob",
+    full_name="google.privacy.dlp.v2.DlpJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DlpJob.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.DlpJob.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.privacy.dlp.v2.DlpJob.state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="risk_details",
+            full_name="google.privacy.dlp.v2.DlpJob.risk_details",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inspect_details",
+            full_name="google.privacy.dlp.v2.DlpJob.inspect_details",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.DlpJob.create_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.privacy.dlp.v2.DlpJob.start_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.privacy.dlp.v2.DlpJob.end_time",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_trigger_name",
+            full_name="google.privacy.dlp.v2.DlpJob.job_trigger_name",
+            index=8,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="errors",
+            full_name="google.privacy.dlp.v2.DlpJob.errors",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DLPJOB_JOBSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="details",
+            full_name="google.privacy.dlp.v2.DlpJob.details",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=23223,
+    serialized_end=23829,
+)
+
+
+_GETDLPJOBREQUEST = _descriptor.Descriptor(
+    name="GetDlpJobRequest",
+    full_name="google.privacy.dlp.v2.GetDlpJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.GetDlpJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=23831,
+    serialized_end=23863,
+)
+
+
+_LISTDLPJOBSREQUEST = _descriptor.Descriptor(
+    name="ListDlpJobsRequest",
+    full_name="google.privacy.dlp.v2.ListDlpJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.ListDlpJobsRequest.parent",
+            index=0,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.privacy.dlp.v2.ListDlpJobsRequest.filter",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.privacy.dlp.v2.ListDlpJobsRequest.page_size",
+            index=2,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.privacy.dlp.v2.ListDlpJobsRequest.page_token",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.ListDlpJobsRequest.type",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.privacy.dlp.v2.ListDlpJobsRequest.order_by",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=23866,
+    serialized_end=24024,
+)
+
+
+_LISTDLPJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListDlpJobsResponse",
+    full_name="google.privacy.dlp.v2.ListDlpJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.privacy.dlp.v2.ListDlpJobsResponse.jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.privacy.dlp.v2.ListDlpJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24026,
+    serialized_end=24117,
+)
+
+
+_CANCELDLPJOBREQUEST = _descriptor.Descriptor(
+    name="CancelDlpJobRequest",
+    full_name="google.privacy.dlp.v2.CancelDlpJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.CancelDlpJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24119,
+    serialized_end=24154,
+)
+
+
+_DELETEDLPJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteDlpJobRequest",
+    full_name="google.privacy.dlp.v2.DeleteDlpJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DeleteDlpJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24156,
+    serialized_end=24191,
+)
+
+
+_CREATEDEIDENTIFYTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="CreateDeidentifyTemplateRequest",
+    full_name="google.privacy.dlp.v2.CreateDeidentifyTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.CreateDeidentifyTemplateRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deidentify_template",
+            full_name="google.privacy.dlp.v2.CreateDeidentifyTemplateRequest.deidentify_template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="template_id",
+            full_name="google.privacy.dlp.v2.CreateDeidentifyTemplateRequest.template_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24194,
+    serialized_end=24336,
+)
+
+
+_UPDATEDEIDENTIFYTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="UpdateDeidentifyTemplateRequest",
+    full_name="google.privacy.dlp.v2.UpdateDeidentifyTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.UpdateDeidentifyTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deidentify_template",
+            full_name="google.privacy.dlp.v2.UpdateDeidentifyTemplateRequest.deidentify_template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.privacy.dlp.v2.UpdateDeidentifyTemplateRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24339,
+    serialized_end=24507,
+)
+
+
+_GETDEIDENTIFYTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="GetDeidentifyTemplateRequest",
+    full_name="google.privacy.dlp.v2.GetDeidentifyTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.GetDeidentifyTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24509,
+    serialized_end=24553,
+)
+
+
+_LISTDEIDENTIFYTEMPLATESREQUEST = _descriptor.Descriptor(
+    name="ListDeidentifyTemplatesRequest",
+    full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesRequest.order_by",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24555,
+    serialized_end=24660,
+)
+
+
+_LISTDEIDENTIFYTEMPLATESRESPONSE = _descriptor.Descriptor(
+    name="ListDeidentifyTemplatesResponse",
+    full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="deidentify_templates",
+            full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesResponse.deidentify_templates",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.privacy.dlp.v2.ListDeidentifyTemplatesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24663,
+    serialized_end=24794,
+)
+
+
+_DELETEDEIDENTIFYTEMPLATEREQUEST = _descriptor.Descriptor(
+    name="DeleteDeidentifyTemplateRequest",
+    full_name="google.privacy.dlp.v2.DeleteDeidentifyTemplateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DeleteDeidentifyTemplateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=24796,
+    serialized_end=24843,
+)
+
+
+_LARGECUSTOMDICTIONARYCONFIG = _descriptor.Descriptor(
+    name="LargeCustomDictionaryConfig",
+    full_name="google.privacy.dlp.v2.LargeCustomDictionaryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_path",
+            full_name="google.privacy.dlp.v2.LargeCustomDictionaryConfig.output_path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cloud_storage_file_set",
+            full_name="google.privacy.dlp.v2.LargeCustomDictionaryConfig.cloud_storage_file_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="big_query_field",
+            full_name="google.privacy.dlp.v2.LargeCustomDictionaryConfig.big_query_field",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.privacy.dlp.v2.LargeCustomDictionaryConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=24846,
+    serialized_end=25090,
+)
+
+
+_LARGECUSTOMDICTIONARYSTATS = _descriptor.Descriptor(
+    name="LargeCustomDictionaryStats",
+    full_name="google.privacy.dlp.v2.LargeCustomDictionaryStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="approx_num_phrases",
+            full_name="google.privacy.dlp.v2.LargeCustomDictionaryStats.approx_num_phrases",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=25092,
+    serialized_end=25148,
+)
+
+
+_STOREDINFOTYPECONFIG = _descriptor.Descriptor(
+    name="StoredInfoTypeConfig",
+    full_name="google.privacy.dlp.v2.StoredInfoTypeConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeConfig.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeConfig.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="large_custom_dictionary",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeConfig.large_custom_dictionary",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeConfig.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=25151,
+    serialized_end=25311,
+)
+
+
+_STOREDINFOTYPESTATS = _descriptor.Descriptor(
+    name="StoredInfoTypeStats",
+    full_name="google.privacy.dlp.v2.StoredInfoTypeStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="large_custom_dictionary",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeStats.large_custom_dictionary",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeStats.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=25313,
+    serialized_end=25428,
+)
+
+
+_STOREDINFOTYPEVERSION = _descriptor.Descriptor(
+    name="StoredInfoTypeVersion",
+    full_name="google.privacy.dlp.v2.StoredInfoTypeVersion",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeVersion.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeVersion.create_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeVersion.state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="errors",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeVersion.errors",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stats",
+            full_name="google.privacy.dlp.v2.StoredInfoTypeVersion.stats",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=25431,
+    serialized_end=25728,
+)
+
+
+_STOREDINFOTYPE = _descriptor.Descriptor(
+    name="StoredInfoType",
+    full_name="google.privacy.dlp.v2.StoredInfoType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.StoredInfoType.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_version",
+            full_name="google.privacy.dlp.v2.StoredInfoType.current_version",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pending_versions",
+            full_name="google.privacy.dlp.v2.StoredInfoType.pending_versions",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=25731,
+    serialized_end=25904,
+)
+
+
+_CREATESTOREDINFOTYPEREQUEST = _descriptor.Descriptor(
+    name="CreateStoredInfoTypeRequest",
+    full_name="google.privacy.dlp.v2.CreateStoredInfoTypeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.CreateStoredInfoTypeRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.privacy.dlp.v2.CreateStoredInfoTypeRequest.config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stored_info_type_id",
+            full_name="google.privacy.dlp.v2.CreateStoredInfoTypeRequest.stored_info_type_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=25907,
+    serialized_end=26042,
+)
+
+
+_UPDATESTOREDINFOTYPEREQUEST = _descriptor.Descriptor(
+    name="UpdateStoredInfoTypeRequest",
+    full_name="google.privacy.dlp.v2.UpdateStoredInfoTypeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.UpdateStoredInfoTypeRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.privacy.dlp.v2.UpdateStoredInfoTypeRequest.config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.privacy.dlp.v2.UpdateStoredInfoTypeRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=26045,
+    serialized_end=26198,
+)
+
+
+_GETSTOREDINFOTYPEREQUEST = _descriptor.Descriptor(
+    name="GetStoredInfoTypeRequest",
+    full_name="google.privacy.dlp.v2.GetStoredInfoTypeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.GetStoredInfoTypeRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=26200,
+    serialized_end=26240,
+)
+
+
+_LISTSTOREDINFOTYPESREQUEST = _descriptor.Descriptor(
+    name="ListStoredInfoTypesRequest",
+    full_name="google.privacy.dlp.v2.ListStoredInfoTypesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.privacy.dlp.v2.ListStoredInfoTypesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.privacy.dlp.v2.ListStoredInfoTypesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.privacy.dlp.v2.ListStoredInfoTypesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.privacy.dlp.v2.ListStoredInfoTypesRequest.order_by",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=26242,
+    serialized_end=26343,
+)
+
+
+_LISTSTOREDINFOTYPESRESPONSE = _descriptor.Descriptor(
+    name="ListStoredInfoTypesResponse",
+    full_name="google.privacy.dlp.v2.ListStoredInfoTypesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stored_info_types",
+            full_name="google.privacy.dlp.v2.ListStoredInfoTypesResponse.stored_info_types",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.privacy.dlp.v2.ListStoredInfoTypesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=26345,
+    serialized_end=26465,
+)
+
+
+_DELETESTOREDINFOTYPEREQUEST = _descriptor.Descriptor(
+    name="DeleteStoredInfoTypeRequest",
+    full_name="google.privacy.dlp.v2.DeleteStoredInfoTypeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.DeleteStoredInfoTypeRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=26467,
+    serialized_end=26510,
+)
+
+_EXCLUDEINFOTYPES.fields_by_name[
+    "info_types"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_EXCLUSIONRULE.fields_by_name[
+    "dictionary"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._CUSTOMINFOTYPE_DICTIONARY
+)
+_EXCLUSIONRULE.fields_by_name[
+    "regex"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._CUSTOMINFOTYPE_REGEX
+)
+_EXCLUSIONRULE.fields_by_name["exclude_info_types"].message_type = _EXCLUDEINFOTYPES
+_EXCLUSIONRULE.fields_by_name["matching_type"].enum_type = _MATCHINGTYPE
+_EXCLUSIONRULE.oneofs_by_name["type"].fields.append(
+    _EXCLUSIONRULE.fields_by_name["dictionary"]
+)
+_EXCLUSIONRULE.fields_by_name[
+    "dictionary"
+].containing_oneof = _EXCLUSIONRULE.oneofs_by_name["type"]
+_EXCLUSIONRULE.oneofs_by_name["type"].fields.append(
+    _EXCLUSIONRULE.fields_by_name["regex"]
+)
+_EXCLUSIONRULE.fields_by_name["regex"].containing_oneof = _EXCLUSIONRULE.oneofs_by_name[
+    "type"
+]
+_EXCLUSIONRULE.oneofs_by_name["type"].fields.append(
+    _EXCLUSIONRULE.fields_by_name["exclude_info_types"]
+)
+_EXCLUSIONRULE.fields_by_name[
+    "exclude_info_types"
+].containing_oneof = _EXCLUSIONRULE.oneofs_by_name["type"]
+_INSPECTIONRULE.fields_by_name[
+    "hotword_rule"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE
+)
+_INSPECTIONRULE.fields_by_name["exclusion_rule"].message_type = _EXCLUSIONRULE
+_INSPECTIONRULE.oneofs_by_name["type"].fields.append(
+    _INSPECTIONRULE.fields_by_name["hotword_rule"]
+)
+_INSPECTIONRULE.fields_by_name[
+    "hotword_rule"
+].containing_oneof = _INSPECTIONRULE.oneofs_by_name["type"]
+_INSPECTIONRULE.oneofs_by_name["type"].fields.append(
+    _INSPECTIONRULE.fields_by_name["exclusion_rule"]
+)
+_INSPECTIONRULE.fields_by_name[
+    "exclusion_rule"
+].containing_oneof = _INSPECTIONRULE.oneofs_by_name["type"]
+_INSPECTIONRULESET.fields_by_name[
+    "info_types"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_INSPECTIONRULESET.fields_by_name["rules"].message_type = _INSPECTIONRULE
+_INSPECTCONFIG_FINDINGLIMITS_INFOTYPELIMIT.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_INSPECTCONFIG_FINDINGLIMITS_INFOTYPELIMIT.containing_type = (
+    _INSPECTCONFIG_FINDINGLIMITS
+)
+_INSPECTCONFIG_FINDINGLIMITS.fields_by_name[
+    "max_findings_per_info_type"
+].message_type = _INSPECTCONFIG_FINDINGLIMITS_INFOTYPELIMIT
+_INSPECTCONFIG_FINDINGLIMITS.containing_type = _INSPECTCONFIG
+_INSPECTCONFIG.fields_by_name[
+    "info_types"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_INSPECTCONFIG.fields_by_name[
+    "min_likelihood"
+].enum_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._LIKELIHOOD
+)
+_INSPECTCONFIG.fields_by_name["limits"].message_type = _INSPECTCONFIG_FINDINGLIMITS
+_INSPECTCONFIG.fields_by_name[
+    "custom_info_types"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._CUSTOMINFOTYPE
+)
+_INSPECTCONFIG.fields_by_name["content_options"].enum_type = _CONTENTOPTION
+_INSPECTCONFIG.fields_by_name["rule_set"].message_type = _INSPECTIONRULESET
+_BYTECONTENTITEM.fields_by_name["type"].enum_type = _BYTECONTENTITEM_BYTESTYPE
+_BYTECONTENTITEM_BYTESTYPE.containing_type = _BYTECONTENTITEM
+_CONTENTITEM.fields_by_name["table"].message_type = _TABLE
+_CONTENTITEM.fields_by_name["byte_item"].message_type = _BYTECONTENTITEM
+_CONTENTITEM.oneofs_by_name["data_item"].fields.append(
+    _CONTENTITEM.fields_by_name["value"]
+)
+_CONTENTITEM.fields_by_name["value"].containing_oneof = _CONTENTITEM.oneofs_by_name[
+    "data_item"
+]
+_CONTENTITEM.oneofs_by_name["data_item"].fields.append(
+    _CONTENTITEM.fields_by_name["table"]
+)
+_CONTENTITEM.fields_by_name["table"].containing_oneof = _CONTENTITEM.oneofs_by_name[
+    "data_item"
+]
+_CONTENTITEM.oneofs_by_name["data_item"].fields.append(
+    _CONTENTITEM.fields_by_name["byte_item"]
+)
+_CONTENTITEM.fields_by_name["byte_item"].containing_oneof = _CONTENTITEM.oneofs_by_name[
+    "data_item"
+]
+_TABLE_ROW.fields_by_name["values"].message_type = _VALUE
+_TABLE_ROW.containing_type = _TABLE
+_TABLE.fields_by_name[
+    "headers"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_TABLE.fields_by_name["rows"].message_type = _TABLE_ROW
+_INSPECTRESULT.fields_by_name["findings"].message_type = _FINDING
+_FINDING.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_FINDING.fields_by_name[
+    "likelihood"
+].enum_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._LIKELIHOOD
+)
+_FINDING.fields_by_name["location"].message_type = _LOCATION
+_FINDING.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FINDING.fields_by_name["quote_info"].message_type = _QUOTEINFO
+_LOCATION.fields_by_name["byte_range"].message_type = _RANGE
+_LOCATION.fields_by_name["codepoint_range"].message_type = _RANGE
+_LOCATION.fields_by_name["content_locations"].message_type = _CONTENTLOCATION
+_CONTENTLOCATION.fields_by_name["record_location"].message_type = _RECORDLOCATION
+_CONTENTLOCATION.fields_by_name["image_location"].message_type = _IMAGELOCATION
+_CONTENTLOCATION.fields_by_name["document_location"].message_type = _DOCUMENTLOCATION
+_CONTENTLOCATION.fields_by_name[
+    "container_timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CONTENTLOCATION.oneofs_by_name["location"].fields.append(
+    _CONTENTLOCATION.fields_by_name["record_location"]
+)
+_CONTENTLOCATION.fields_by_name[
+    "record_location"
+].containing_oneof = _CONTENTLOCATION.oneofs_by_name["location"]
+_CONTENTLOCATION.oneofs_by_name["location"].fields.append(
+    _CONTENTLOCATION.fields_by_name["image_location"]
+)
+_CONTENTLOCATION.fields_by_name[
+    "image_location"
+].containing_oneof = _CONTENTLOCATION.oneofs_by_name["location"]
+_CONTENTLOCATION.oneofs_by_name["location"].fields.append(
+    _CONTENTLOCATION.fields_by_name["document_location"]
+)
+_CONTENTLOCATION.fields_by_name[
+    "document_location"
+].containing_oneof = _CONTENTLOCATION.oneofs_by_name["location"]
+_RECORDLOCATION.fields_by_name[
+    "record_key"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._RECORDKEY
+)
+_RECORDLOCATION.fields_by_name[
+    "field_id"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_RECORDLOCATION.fields_by_name["table_location"].message_type = _TABLELOCATION
+_IMAGELOCATION.fields_by_name["bounding_boxes"].message_type = _BOUNDINGBOX
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.fields_by_name[
+    "redaction_color"
+].message_type = _COLOR
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.containing_type = _REDACTIMAGEREQUEST
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.oneofs_by_name["target"].fields.append(
+    _REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.fields_by_name["info_type"]
+)
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.fields_by_name[
+    "info_type"
+].containing_oneof = _REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.oneofs_by_name["target"]
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.oneofs_by_name["target"].fields.append(
+    _REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.fields_by_name["redact_all_text"]
+)
+_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.fields_by_name[
+    "redact_all_text"
+].containing_oneof = _REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG.oneofs_by_name["target"]
+_REDACTIMAGEREQUEST.fields_by_name["inspect_config"].message_type = _INSPECTCONFIG
+_REDACTIMAGEREQUEST.fields_by_name[
+    "image_redaction_configs"
+].message_type = _REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG
+_REDACTIMAGEREQUEST.fields_by_name["byte_item"].message_type = _BYTECONTENTITEM
+_REDACTIMAGERESPONSE.fields_by_name["inspect_result"].message_type = _INSPECTRESULT
+_DEIDENTIFYCONTENTREQUEST.fields_by_name[
+    "deidentify_config"
+].message_type = _DEIDENTIFYCONFIG
+_DEIDENTIFYCONTENTREQUEST.fields_by_name["inspect_config"].message_type = _INSPECTCONFIG
+_DEIDENTIFYCONTENTREQUEST.fields_by_name["item"].message_type = _CONTENTITEM
+_DEIDENTIFYCONTENTRESPONSE.fields_by_name["item"].message_type = _CONTENTITEM
+_DEIDENTIFYCONTENTRESPONSE.fields_by_name[
+    "overview"
+].message_type = _TRANSFORMATIONOVERVIEW
+_REIDENTIFYCONTENTREQUEST.fields_by_name[
+    "reidentify_config"
+].message_type = _DEIDENTIFYCONFIG
+_REIDENTIFYCONTENTREQUEST.fields_by_name["inspect_config"].message_type = _INSPECTCONFIG
+_REIDENTIFYCONTENTREQUEST.fields_by_name["item"].message_type = _CONTENTITEM
+_REIDENTIFYCONTENTRESPONSE.fields_by_name["item"].message_type = _CONTENTITEM
+_REIDENTIFYCONTENTRESPONSE.fields_by_name[
+    "overview"
+].message_type = _TRANSFORMATIONOVERVIEW
+_INSPECTCONTENTREQUEST.fields_by_name["inspect_config"].message_type = _INSPECTCONFIG
+_INSPECTCONTENTREQUEST.fields_by_name["item"].message_type = _CONTENTITEM
+_INSPECTCONTENTRESPONSE.fields_by_name["result"].message_type = _INSPECTRESULT
+_OUTPUTSTORAGECONFIG.fields_by_name[
+    "table"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._BIGQUERYTABLE
+)
+_OUTPUTSTORAGECONFIG.fields_by_name[
+    "output_schema"
+].enum_type = _OUTPUTSTORAGECONFIG_OUTPUTSCHEMA
+_OUTPUTSTORAGECONFIG_OUTPUTSCHEMA.containing_type = _OUTPUTSTORAGECONFIG
+_OUTPUTSTORAGECONFIG.oneofs_by_name["type"].fields.append(
+    _OUTPUTSTORAGECONFIG.fields_by_name["table"]
+)
+_OUTPUTSTORAGECONFIG.fields_by_name[
+    "table"
+].containing_oneof = _OUTPUTSTORAGECONFIG.oneofs_by_name["type"]
+_INFOTYPESTATS.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS.fields_by_name[
+    "snapshot_inspect_template"
+].message_type = _INSPECTTEMPLATE
+_INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS.fields_by_name[
+    "job_config"
+].message_type = _INSPECTJOBCONFIG
+_INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS.containing_type = _INSPECTDATASOURCEDETAILS
+_INSPECTDATASOURCEDETAILS_RESULT.fields_by_name[
+    "info_type_stats"
+].message_type = _INFOTYPESTATS
+_INSPECTDATASOURCEDETAILS_RESULT.containing_type = _INSPECTDATASOURCEDETAILS
+_INSPECTDATASOURCEDETAILS.fields_by_name[
+    "requested_options"
+].message_type = _INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS
+_INSPECTDATASOURCEDETAILS.fields_by_name[
+    "result"
+].message_type = _INSPECTDATASOURCEDETAILS_RESULT
+_INFOTYPEDESCRIPTION.fields_by_name["supported_by"].enum_type = _INFOTYPESUPPORTEDBY
+_LISTINFOTYPESRESPONSE.fields_by_name["info_types"].message_type = _INFOTYPEDESCRIPTION
+_RISKANALYSISJOBCONFIG.fields_by_name["privacy_metric"].message_type = _PRIVACYMETRIC
+_RISKANALYSISJOBCONFIG.fields_by_name[
+    "source_table"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._BIGQUERYTABLE
+)
+_RISKANALYSISJOBCONFIG.fields_by_name["actions"].message_type = _ACTION
+_QUASIID.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_QUASIID.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_QUASIID.fields_by_name[
+    "inferred"
+].message_type = google_dot_protobuf_dot_empty__pb2._EMPTY
+_QUASIID.oneofs_by_name["tag"].fields.append(_QUASIID.fields_by_name["info_type"])
+_QUASIID.fields_by_name["info_type"].containing_oneof = _QUASIID.oneofs_by_name["tag"]
+_QUASIID.oneofs_by_name["tag"].fields.append(_QUASIID.fields_by_name["custom_tag"])
+_QUASIID.fields_by_name["custom_tag"].containing_oneof = _QUASIID.oneofs_by_name["tag"]
+_QUASIID.oneofs_by_name["tag"].fields.append(_QUASIID.fields_by_name["inferred"])
+_QUASIID.fields_by_name["inferred"].containing_oneof = _QUASIID.oneofs_by_name["tag"]
+_STATISTICALTABLE_QUASIIDENTIFIERFIELD.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_STATISTICALTABLE_QUASIIDENTIFIERFIELD.containing_type = _STATISTICALTABLE
+_STATISTICALTABLE.fields_by_name[
+    "table"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._BIGQUERYTABLE
+)
+_STATISTICALTABLE.fields_by_name[
+    "quasi_ids"
+].message_type = _STATISTICALTABLE_QUASIIDENTIFIERFIELD
+_STATISTICALTABLE.fields_by_name[
+    "relative_frequency"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_NUMERICALSTATSCONFIG.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_NUMERICALSTATSCONFIG.containing_type = _PRIVACYMETRIC
+_PRIVACYMETRIC_CATEGORICALSTATSCONFIG.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_CATEGORICALSTATSCONFIG.containing_type = _PRIVACYMETRIC
+_PRIVACYMETRIC_KANONYMITYCONFIG.fields_by_name[
+    "quasi_ids"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_KANONYMITYCONFIG.fields_by_name[
+    "entity_id"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._ENTITYID
+)
+_PRIVACYMETRIC_KANONYMITYCONFIG.containing_type = _PRIVACYMETRIC
+_PRIVACYMETRIC_LDIVERSITYCONFIG.fields_by_name[
+    "quasi_ids"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_LDIVERSITYCONFIG.fields_by_name[
+    "sensitive_attribute"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_LDIVERSITYCONFIG.containing_type = _PRIVACYMETRIC
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name[
+    "inferred"
+].message_type = google_dot_protobuf_dot_empty__pb2._EMPTY
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.containing_type = (
+    _PRIVACYMETRIC_KMAPESTIMATIONCONFIG
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.oneofs_by_name["tag"].fields.append(
+    _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name["info_type"]
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name[
+    "info_type"
+].containing_oneof = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.oneofs_by_name[
+    "tag"
+]
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.oneofs_by_name["tag"].fields.append(
+    _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name["custom_tag"]
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name[
+    "custom_tag"
+].containing_oneof = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.oneofs_by_name[
+    "tag"
+]
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.oneofs_by_name["tag"].fields.append(
+    _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name["inferred"]
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.fields_by_name[
+    "inferred"
+].containing_oneof = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD.oneofs_by_name[
+    "tag"
+]
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE_QUASIIDFIELD.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE_QUASIIDFIELD.containing_type = (
+    _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE.fields_by_name[
+    "table"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._BIGQUERYTABLE
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE.fields_by_name[
+    "quasi_ids"
+].message_type = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE_QUASIIDFIELD
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE.fields_by_name[
+    "relative_frequency"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE.containing_type = (
+    _PRIVACYMETRIC_KMAPESTIMATIONCONFIG
+)
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG.fields_by_name[
+    "quasi_ids"
+].message_type = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG.fields_by_name[
+    "auxiliary_tables"
+].message_type = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE
+_PRIVACYMETRIC_KMAPESTIMATIONCONFIG.containing_type = _PRIVACYMETRIC
+_PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG.fields_by_name[
+    "quasi_ids"
+].message_type = _QUASIID
+_PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG.fields_by_name[
+    "auxiliary_tables"
+].message_type = _STATISTICALTABLE
+_PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG.containing_type = _PRIVACYMETRIC
+_PRIVACYMETRIC.fields_by_name[
+    "numerical_stats_config"
+].message_type = _PRIVACYMETRIC_NUMERICALSTATSCONFIG
+_PRIVACYMETRIC.fields_by_name[
+    "categorical_stats_config"
+].message_type = _PRIVACYMETRIC_CATEGORICALSTATSCONFIG
+_PRIVACYMETRIC.fields_by_name[
+    "k_anonymity_config"
+].message_type = _PRIVACYMETRIC_KANONYMITYCONFIG
+_PRIVACYMETRIC.fields_by_name[
+    "l_diversity_config"
+].message_type = _PRIVACYMETRIC_LDIVERSITYCONFIG
+_PRIVACYMETRIC.fields_by_name[
+    "k_map_estimation_config"
+].message_type = _PRIVACYMETRIC_KMAPESTIMATIONCONFIG
+_PRIVACYMETRIC.fields_by_name[
+    "delta_presence_estimation_config"
+].message_type = _PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG
+_PRIVACYMETRIC.oneofs_by_name["type"].fields.append(
+    _PRIVACYMETRIC.fields_by_name["numerical_stats_config"]
+)
+_PRIVACYMETRIC.fields_by_name[
+    "numerical_stats_config"
+].containing_oneof = _PRIVACYMETRIC.oneofs_by_name["type"]
+_PRIVACYMETRIC.oneofs_by_name["type"].fields.append(
+    _PRIVACYMETRIC.fields_by_name["categorical_stats_config"]
+)
+_PRIVACYMETRIC.fields_by_name[
+    "categorical_stats_config"
+].containing_oneof = _PRIVACYMETRIC.oneofs_by_name["type"]
+_PRIVACYMETRIC.oneofs_by_name["type"].fields.append(
+    _PRIVACYMETRIC.fields_by_name["k_anonymity_config"]
+)
+_PRIVACYMETRIC.fields_by_name[
+    "k_anonymity_config"
+].containing_oneof = _PRIVACYMETRIC.oneofs_by_name["type"]
+_PRIVACYMETRIC.oneofs_by_name["type"].fields.append(
+    _PRIVACYMETRIC.fields_by_name["l_diversity_config"]
+)
+_PRIVACYMETRIC.fields_by_name[
+    "l_diversity_config"
+].containing_oneof = _PRIVACYMETRIC.oneofs_by_name["type"]
+_PRIVACYMETRIC.oneofs_by_name["type"].fields.append(
+    _PRIVACYMETRIC.fields_by_name["k_map_estimation_config"]
+)
+_PRIVACYMETRIC.fields_by_name[
+    "k_map_estimation_config"
+].containing_oneof = _PRIVACYMETRIC.oneofs_by_name["type"]
+_PRIVACYMETRIC.oneofs_by_name["type"].fields.append(
+    _PRIVACYMETRIC.fields_by_name["delta_presence_estimation_config"]
+)
+_PRIVACYMETRIC.fields_by_name[
+    "delta_presence_estimation_config"
+].containing_oneof = _PRIVACYMETRIC.oneofs_by_name["type"]
+_ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT.fields_by_name[
+    "min_value"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT.fields_by_name[
+    "max_value"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT.fields_by_name[
+    "quantile_values"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS
+)
+_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT_CATEGORICALSTATSHISTOGRAMBUCKET.fields_by_name[
+    "bucket_values"
+].message_type = _VALUEFREQUENCY
+_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT_CATEGORICALSTATSHISTOGRAMBUCKET.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT.fields_by_name[
+    "value_frequency_histogram_buckets"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT_CATEGORICALSTATSHISTOGRAMBUCKET
+)
+_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS
+)
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYEQUIVALENCECLASS.fields_by_name[
+    "quasi_ids_values"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYEQUIVALENCECLASS.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYHISTOGRAMBUCKET.fields_by_name[
+    "bucket_values"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYEQUIVALENCECLASS
+)
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYHISTOGRAMBUCKET.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT.fields_by_name[
+    "equivalence_class_histogram_buckets"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYHISTOGRAMBUCKET
+)
+_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS
+)
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS.fields_by_name[
+    "quasi_ids_values"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS.fields_by_name[
+    "top_sensitive_values"
+].message_type = _VALUEFREQUENCY
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYHISTOGRAMBUCKET.fields_by_name[
+    "bucket_values"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS
+)
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYHISTOGRAMBUCKET.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT.fields_by_name[
+    "sensitive_value_frequency_histogram_buckets"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYHISTOGRAMBUCKET
+)
+_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS
+)
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONQUASIIDVALUES.fields_by_name[
+    "quasi_ids_values"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONQUASIIDVALUES.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONHISTOGRAMBUCKET.fields_by_name[
+    "bucket_values"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONQUASIIDVALUES
+)
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONHISTOGRAMBUCKET.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT.fields_by_name[
+    "k_map_estimation_histogram"
+].message_type = (
+    _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONHISTOGRAMBUCKET
+)
+_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS
+)
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONQUASIIDVALUES.fields_by_name[
+    "quasi_ids_values"
+].message_type = _VALUE
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONQUASIIDVALUES.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONHISTOGRAMBUCKET.fields_by_name[
+    "bucket_values"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONQUASIIDVALUES
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONHISTOGRAMBUCKET.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT
+)
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT.fields_by_name[
+    "delta_presence_estimation_histogram"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONHISTOGRAMBUCKET
+_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT.containing_type = (
+    _ANALYZEDATASOURCERISKDETAILS
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "requested_privacy_metric"
+].message_type = _PRIVACYMETRIC
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "requested_source_table"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._BIGQUERYTABLE
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "numerical_stats_result"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "categorical_stats_result"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "k_anonymity_result"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "l_diversity_result"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "k_map_estimation_result"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "delta_presence_estimation_result"
+].message_type = _ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT
+_ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"].fields.append(
+    _ANALYZEDATASOURCERISKDETAILS.fields_by_name["numerical_stats_result"]
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "numerical_stats_result"
+].containing_oneof = _ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"]
+_ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"].fields.append(
+    _ANALYZEDATASOURCERISKDETAILS.fields_by_name["categorical_stats_result"]
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "categorical_stats_result"
+].containing_oneof = _ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"]
+_ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"].fields.append(
+    _ANALYZEDATASOURCERISKDETAILS.fields_by_name["k_anonymity_result"]
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "k_anonymity_result"
+].containing_oneof = _ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"]
+_ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"].fields.append(
+    _ANALYZEDATASOURCERISKDETAILS.fields_by_name["l_diversity_result"]
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "l_diversity_result"
+].containing_oneof = _ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"]
+_ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"].fields.append(
+    _ANALYZEDATASOURCERISKDETAILS.fields_by_name["k_map_estimation_result"]
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "k_map_estimation_result"
+].containing_oneof = _ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"]
+_ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"].fields.append(
+    _ANALYZEDATASOURCERISKDETAILS.fields_by_name["delta_presence_estimation_result"]
+)
+_ANALYZEDATASOURCERISKDETAILS.fields_by_name[
+    "delta_presence_estimation_result"
+].containing_oneof = _ANALYZEDATASOURCERISKDETAILS.oneofs_by_name["result"]
+_VALUEFREQUENCY.fields_by_name["value"].message_type = _VALUE
+_VALUE.fields_by_name[
+    "timestamp_value"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VALUE.fields_by_name[
+    "time_value"
+].message_type = google_dot_type_dot_timeofday__pb2._TIMEOFDAY
+_VALUE.fields_by_name["date_value"].message_type = google_dot_type_dot_date__pb2._DATE
+_VALUE.fields_by_name[
+    "day_of_week_value"
+].enum_type = google_dot_type_dot_dayofweek__pb2._DAYOFWEEK
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["integer_value"])
+_VALUE.fields_by_name["integer_value"].containing_oneof = _VALUE.oneofs_by_name["type"]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["float_value"])
+_VALUE.fields_by_name["float_value"].containing_oneof = _VALUE.oneofs_by_name["type"]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["string_value"])
+_VALUE.fields_by_name["string_value"].containing_oneof = _VALUE.oneofs_by_name["type"]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["boolean_value"])
+_VALUE.fields_by_name["boolean_value"].containing_oneof = _VALUE.oneofs_by_name["type"]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["timestamp_value"])
+_VALUE.fields_by_name["timestamp_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "type"
+]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["time_value"])
+_VALUE.fields_by_name["time_value"].containing_oneof = _VALUE.oneofs_by_name["type"]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["date_value"])
+_VALUE.fields_by_name["date_value"].containing_oneof = _VALUE.oneofs_by_name["type"]
+_VALUE.oneofs_by_name["type"].fields.append(_VALUE.fields_by_name["day_of_week_value"])
+_VALUE.fields_by_name["day_of_week_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "type"
+]
+_QUOTEINFO.fields_by_name["date_time"].message_type = _DATETIME
+_QUOTEINFO.oneofs_by_name["parsed_quote"].fields.append(
+    _QUOTEINFO.fields_by_name["date_time"]
+)
+_QUOTEINFO.fields_by_name["date_time"].containing_oneof = _QUOTEINFO.oneofs_by_name[
+    "parsed_quote"
+]
+_DATETIME_TIMEZONE.containing_type = _DATETIME
+_DATETIME.fields_by_name["date"].message_type = google_dot_type_dot_date__pb2._DATE
+_DATETIME.fields_by_name[
+    "day_of_week"
+].enum_type = google_dot_type_dot_dayofweek__pb2._DAYOFWEEK
+_DATETIME.fields_by_name[
+    "time"
+].message_type = google_dot_type_dot_timeofday__pb2._TIMEOFDAY
+_DATETIME.fields_by_name["time_zone"].message_type = _DATETIME_TIMEZONE
+_DEIDENTIFYCONFIG.fields_by_name[
+    "info_type_transformations"
+].message_type = _INFOTYPETRANSFORMATIONS
+_DEIDENTIFYCONFIG.fields_by_name[
+    "record_transformations"
+].message_type = _RECORDTRANSFORMATIONS
+_DEIDENTIFYCONFIG.oneofs_by_name["transformation"].fields.append(
+    _DEIDENTIFYCONFIG.fields_by_name["info_type_transformations"]
+)
+_DEIDENTIFYCONFIG.fields_by_name[
+    "info_type_transformations"
+].containing_oneof = _DEIDENTIFYCONFIG.oneofs_by_name["transformation"]
+_DEIDENTIFYCONFIG.oneofs_by_name["transformation"].fields.append(
+    _DEIDENTIFYCONFIG.fields_by_name["record_transformations"]
+)
+_DEIDENTIFYCONFIG.fields_by_name[
+    "record_transformations"
+].containing_oneof = _DEIDENTIFYCONFIG.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "replace_config"
+].message_type = _REPLACEVALUECONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name["redact_config"].message_type = _REDACTCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "character_mask_config"
+].message_type = _CHARACTERMASKCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "crypto_replace_ffx_fpe_config"
+].message_type = _CRYPTOREPLACEFFXFPECONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "fixed_size_bucketing_config"
+].message_type = _FIXEDSIZEBUCKETINGCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "bucketing_config"
+].message_type = _BUCKETINGCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "replace_with_info_type_config"
+].message_type = _REPLACEWITHINFOTYPECONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "time_part_config"
+].message_type = _TIMEPARTCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "crypto_hash_config"
+].message_type = _CRYPTOHASHCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "date_shift_config"
+].message_type = _DATESHIFTCONFIG
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "crypto_deterministic_config"
+].message_type = _CRYPTODETERMINISTICCONFIG
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["replace_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "replace_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["redact_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "redact_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["character_mask_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "character_mask_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["crypto_replace_ffx_fpe_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "crypto_replace_ffx_fpe_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["fixed_size_bucketing_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "fixed_size_bucketing_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["bucketing_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "bucketing_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["replace_with_info_type_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "replace_with_info_type_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["time_part_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "time_part_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["crypto_hash_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "crypto_hash_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["date_shift_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "date_shift_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _PRIMITIVETRANSFORMATION.fields_by_name["crypto_deterministic_config"]
+)
+_PRIMITIVETRANSFORMATION.fields_by_name[
+    "crypto_deterministic_config"
+].containing_oneof = _PRIMITIVETRANSFORMATION.oneofs_by_name["transformation"]
+_TIMEPARTCONFIG.fields_by_name["part_to_extract"].enum_type = _TIMEPARTCONFIG_TIMEPART
+_TIMEPARTCONFIG_TIMEPART.containing_type = _TIMEPARTCONFIG
+_CRYPTOHASHCONFIG.fields_by_name["crypto_key"].message_type = _CRYPTOKEY
+_CRYPTODETERMINISTICCONFIG.fields_by_name["crypto_key"].message_type = _CRYPTOKEY
+_CRYPTODETERMINISTICCONFIG.fields_by_name[
+    "surrogate_info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_CRYPTODETERMINISTICCONFIG.fields_by_name[
+    "context"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_REPLACEVALUECONFIG.fields_by_name["new_value"].message_type = _VALUE
+_CHARSTOIGNORE.fields_by_name[
+    "common_characters_to_ignore"
+].enum_type = _CHARSTOIGNORE_COMMONCHARSTOIGNORE
+_CHARSTOIGNORE_COMMONCHARSTOIGNORE.containing_type = _CHARSTOIGNORE
+_CHARSTOIGNORE.oneofs_by_name["characters"].fields.append(
+    _CHARSTOIGNORE.fields_by_name["characters_to_skip"]
+)
+_CHARSTOIGNORE.fields_by_name[
+    "characters_to_skip"
+].containing_oneof = _CHARSTOIGNORE.oneofs_by_name["characters"]
+_CHARSTOIGNORE.oneofs_by_name["characters"].fields.append(
+    _CHARSTOIGNORE.fields_by_name["common_characters_to_ignore"]
+)
+_CHARSTOIGNORE.fields_by_name[
+    "common_characters_to_ignore"
+].containing_oneof = _CHARSTOIGNORE.oneofs_by_name["characters"]
+_CHARACTERMASKCONFIG.fields_by_name[
+    "characters_to_ignore"
+].message_type = _CHARSTOIGNORE
+_FIXEDSIZEBUCKETINGCONFIG.fields_by_name["lower_bound"].message_type = _VALUE
+_FIXEDSIZEBUCKETINGCONFIG.fields_by_name["upper_bound"].message_type = _VALUE
+_BUCKETINGCONFIG_BUCKET.fields_by_name["min"].message_type = _VALUE
+_BUCKETINGCONFIG_BUCKET.fields_by_name["max"].message_type = _VALUE
+_BUCKETINGCONFIG_BUCKET.fields_by_name["replacement_value"].message_type = _VALUE
+_BUCKETINGCONFIG_BUCKET.containing_type = _BUCKETINGCONFIG
+_BUCKETINGCONFIG.fields_by_name["buckets"].message_type = _BUCKETINGCONFIG_BUCKET
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name["crypto_key"].message_type = _CRYPTOKEY
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name[
+    "context"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name[
+    "common_alphabet"
+].enum_type = _CRYPTOREPLACEFFXFPECONFIG_FFXCOMMONNATIVEALPHABET
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name[
+    "surrogate_info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_CRYPTOREPLACEFFXFPECONFIG_FFXCOMMONNATIVEALPHABET.containing_type = (
+    _CRYPTOREPLACEFFXFPECONFIG
+)
+_CRYPTOREPLACEFFXFPECONFIG.oneofs_by_name["alphabet"].fields.append(
+    _CRYPTOREPLACEFFXFPECONFIG.fields_by_name["common_alphabet"]
+)
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name[
+    "common_alphabet"
+].containing_oneof = _CRYPTOREPLACEFFXFPECONFIG.oneofs_by_name["alphabet"]
+_CRYPTOREPLACEFFXFPECONFIG.oneofs_by_name["alphabet"].fields.append(
+    _CRYPTOREPLACEFFXFPECONFIG.fields_by_name["custom_alphabet"]
+)
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name[
+    "custom_alphabet"
+].containing_oneof = _CRYPTOREPLACEFFXFPECONFIG.oneofs_by_name["alphabet"]
+_CRYPTOREPLACEFFXFPECONFIG.oneofs_by_name["alphabet"].fields.append(
+    _CRYPTOREPLACEFFXFPECONFIG.fields_by_name["radix"]
+)
+_CRYPTOREPLACEFFXFPECONFIG.fields_by_name[
+    "radix"
+].containing_oneof = _CRYPTOREPLACEFFXFPECONFIG.oneofs_by_name["alphabet"]
+_CRYPTOKEY.fields_by_name["transient"].message_type = _TRANSIENTCRYPTOKEY
+_CRYPTOKEY.fields_by_name["unwrapped"].message_type = _UNWRAPPEDCRYPTOKEY
+_CRYPTOKEY.fields_by_name["kms_wrapped"].message_type = _KMSWRAPPEDCRYPTOKEY
+_CRYPTOKEY.oneofs_by_name["source"].fields.append(
+    _CRYPTOKEY.fields_by_name["transient"]
+)
+_CRYPTOKEY.fields_by_name["transient"].containing_oneof = _CRYPTOKEY.oneofs_by_name[
+    "source"
+]
+_CRYPTOKEY.oneofs_by_name["source"].fields.append(
+    _CRYPTOKEY.fields_by_name["unwrapped"]
+)
+_CRYPTOKEY.fields_by_name["unwrapped"].containing_oneof = _CRYPTOKEY.oneofs_by_name[
+    "source"
+]
+_CRYPTOKEY.oneofs_by_name["source"].fields.append(
+    _CRYPTOKEY.fields_by_name["kms_wrapped"]
+)
+_CRYPTOKEY.fields_by_name["kms_wrapped"].containing_oneof = _CRYPTOKEY.oneofs_by_name[
+    "source"
+]
+_DATESHIFTCONFIG.fields_by_name[
+    "context"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_DATESHIFTCONFIG.fields_by_name["crypto_key"].message_type = _CRYPTOKEY
+_DATESHIFTCONFIG.oneofs_by_name["method"].fields.append(
+    _DATESHIFTCONFIG.fields_by_name["crypto_key"]
+)
+_DATESHIFTCONFIG.fields_by_name[
+    "crypto_key"
+].containing_oneof = _DATESHIFTCONFIG.oneofs_by_name["method"]
+_INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION.fields_by_name[
+    "info_types"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION.fields_by_name[
+    "primitive_transformation"
+].message_type = _PRIMITIVETRANSFORMATION
+_INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION.containing_type = (
+    _INFOTYPETRANSFORMATIONS
+)
+_INFOTYPETRANSFORMATIONS.fields_by_name[
+    "transformations"
+].message_type = _INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION
+_FIELDTRANSFORMATION.fields_by_name[
+    "fields"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_FIELDTRANSFORMATION.fields_by_name["condition"].message_type = _RECORDCONDITION
+_FIELDTRANSFORMATION.fields_by_name[
+    "primitive_transformation"
+].message_type = _PRIMITIVETRANSFORMATION
+_FIELDTRANSFORMATION.fields_by_name[
+    "info_type_transformations"
+].message_type = _INFOTYPETRANSFORMATIONS
+_FIELDTRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _FIELDTRANSFORMATION.fields_by_name["primitive_transformation"]
+)
+_FIELDTRANSFORMATION.fields_by_name[
+    "primitive_transformation"
+].containing_oneof = _FIELDTRANSFORMATION.oneofs_by_name["transformation"]
+_FIELDTRANSFORMATION.oneofs_by_name["transformation"].fields.append(
+    _FIELDTRANSFORMATION.fields_by_name["info_type_transformations"]
+)
+_FIELDTRANSFORMATION.fields_by_name[
+    "info_type_transformations"
+].containing_oneof = _FIELDTRANSFORMATION.oneofs_by_name["transformation"]
+_RECORDTRANSFORMATIONS.fields_by_name[
+    "field_transformations"
+].message_type = _FIELDTRANSFORMATION
+_RECORDTRANSFORMATIONS.fields_by_name[
+    "record_suppressions"
+].message_type = _RECORDSUPPRESSION
+_RECORDSUPPRESSION.fields_by_name["condition"].message_type = _RECORDCONDITION
+_RECORDCONDITION_CONDITION.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_RECORDCONDITION_CONDITION.fields_by_name["operator"].enum_type = _RELATIONALOPERATOR
+_RECORDCONDITION_CONDITION.fields_by_name["value"].message_type = _VALUE
+_RECORDCONDITION_CONDITION.containing_type = _RECORDCONDITION
+_RECORDCONDITION_CONDITIONS.fields_by_name[
+    "conditions"
+].message_type = _RECORDCONDITION_CONDITION
+_RECORDCONDITION_CONDITIONS.containing_type = _RECORDCONDITION
+_RECORDCONDITION_EXPRESSIONS.fields_by_name[
+    "logical_operator"
+].enum_type = _RECORDCONDITION_EXPRESSIONS_LOGICALOPERATOR
+_RECORDCONDITION_EXPRESSIONS.fields_by_name[
+    "conditions"
+].message_type = _RECORDCONDITION_CONDITIONS
+_RECORDCONDITION_EXPRESSIONS.containing_type = _RECORDCONDITION
+_RECORDCONDITION_EXPRESSIONS_LOGICALOPERATOR.containing_type = (
+    _RECORDCONDITION_EXPRESSIONS
+)
+_RECORDCONDITION_EXPRESSIONS.oneofs_by_name["type"].fields.append(
+    _RECORDCONDITION_EXPRESSIONS.fields_by_name["conditions"]
+)
+_RECORDCONDITION_EXPRESSIONS.fields_by_name[
+    "conditions"
+].containing_oneof = _RECORDCONDITION_EXPRESSIONS.oneofs_by_name["type"]
+_RECORDCONDITION.fields_by_name[
+    "expressions"
+].message_type = _RECORDCONDITION_EXPRESSIONS
+_TRANSFORMATIONOVERVIEW.fields_by_name[
+    "transformation_summaries"
+].message_type = _TRANSFORMATIONSUMMARY
+_TRANSFORMATIONSUMMARY_SUMMARYRESULT.fields_by_name[
+    "code"
+].enum_type = _TRANSFORMATIONSUMMARY_TRANSFORMATIONRESULTCODE
+_TRANSFORMATIONSUMMARY_SUMMARYRESULT.containing_type = _TRANSFORMATIONSUMMARY
+_TRANSFORMATIONSUMMARY.fields_by_name[
+    "info_type"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._INFOTYPE
+)
+_TRANSFORMATIONSUMMARY.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._FIELDID
+)
+_TRANSFORMATIONSUMMARY.fields_by_name[
+    "transformation"
+].message_type = _PRIMITIVETRANSFORMATION
+_TRANSFORMATIONSUMMARY.fields_by_name[
+    "field_transformations"
+].message_type = _FIELDTRANSFORMATION
+_TRANSFORMATIONSUMMARY.fields_by_name[
+    "record_suppress"
+].message_type = _RECORDSUPPRESSION
+_TRANSFORMATIONSUMMARY.fields_by_name[
+    "results"
+].message_type = _TRANSFORMATIONSUMMARY_SUMMARYRESULT
+_TRANSFORMATIONSUMMARY_TRANSFORMATIONRESULTCODE.containing_type = _TRANSFORMATIONSUMMARY
+_SCHEDULE.fields_by_name[
+    "recurrence_period_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_SCHEDULE.oneofs_by_name["option"].fields.append(
+    _SCHEDULE.fields_by_name["recurrence_period_duration"]
+)
+_SCHEDULE.fields_by_name[
+    "recurrence_period_duration"
+].containing_oneof = _SCHEDULE.oneofs_by_name["option"]
+_INSPECTTEMPLATE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INSPECTTEMPLATE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INSPECTTEMPLATE.fields_by_name["inspect_config"].message_type = _INSPECTCONFIG
+_DEIDENTIFYTEMPLATE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEIDENTIFYTEMPLATE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEIDENTIFYTEMPLATE.fields_by_name["deidentify_config"].message_type = _DEIDENTIFYCONFIG
+_ERROR.fields_by_name["details"].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ERROR.fields_by_name[
+    "timestamps"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOBTRIGGER_TRIGGER.fields_by_name["schedule"].message_type = _SCHEDULE
+_JOBTRIGGER_TRIGGER.containing_type = _JOBTRIGGER
+_JOBTRIGGER_TRIGGER.oneofs_by_name["trigger"].fields.append(
+    _JOBTRIGGER_TRIGGER.fields_by_name["schedule"]
+)
+_JOBTRIGGER_TRIGGER.fields_by_name[
+    "schedule"
+].containing_oneof = _JOBTRIGGER_TRIGGER.oneofs_by_name["trigger"]
+_JOBTRIGGER.fields_by_name["inspect_job"].message_type = _INSPECTJOBCONFIG
+_JOBTRIGGER.fields_by_name["triggers"].message_type = _JOBTRIGGER_TRIGGER
+_JOBTRIGGER.fields_by_name["errors"].message_type = _ERROR
+_JOBTRIGGER.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOBTRIGGER.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOBTRIGGER.fields_by_name[
+    "last_run_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOBTRIGGER.fields_by_name["status"].enum_type = _JOBTRIGGER_STATUS
+_JOBTRIGGER_STATUS.containing_type = _JOBTRIGGER
+_JOBTRIGGER.oneofs_by_name["job"].fields.append(
+    _JOBTRIGGER.fields_by_name["inspect_job"]
+)
+_JOBTRIGGER.fields_by_name["inspect_job"].containing_oneof = _JOBTRIGGER.oneofs_by_name[
+    "job"
+]
+_ACTION_SAVEFINDINGS.fields_by_name["output_config"].message_type = _OUTPUTSTORAGECONFIG
+_ACTION_SAVEFINDINGS.containing_type = _ACTION
+_ACTION_PUBLISHTOPUBSUB.containing_type = _ACTION
+_ACTION_PUBLISHSUMMARYTOCSCC.containing_type = _ACTION
+_ACTION_PUBLISHFINDINGSTOCLOUDDATACATALOG.containing_type = _ACTION
+_ACTION_JOBNOTIFICATIONEMAILS.containing_type = _ACTION
+_ACTION.fields_by_name["save_findings"].message_type = _ACTION_SAVEFINDINGS
+_ACTION.fields_by_name["pub_sub"].message_type = _ACTION_PUBLISHTOPUBSUB
+_ACTION.fields_by_name[
+    "publish_summary_to_cscc"
+].message_type = _ACTION_PUBLISHSUMMARYTOCSCC
+_ACTION.fields_by_name[
+    "publish_findings_to_cloud_data_catalog"
+].message_type = _ACTION_PUBLISHFINDINGSTOCLOUDDATACATALOG
+_ACTION.fields_by_name[
+    "job_notification_emails"
+].message_type = _ACTION_JOBNOTIFICATIONEMAILS
+_ACTION.oneofs_by_name["action"].fields.append(_ACTION.fields_by_name["save_findings"])
+_ACTION.fields_by_name["save_findings"].containing_oneof = _ACTION.oneofs_by_name[
+    "action"
+]
+_ACTION.oneofs_by_name["action"].fields.append(_ACTION.fields_by_name["pub_sub"])
+_ACTION.fields_by_name["pub_sub"].containing_oneof = _ACTION.oneofs_by_name["action"]
+_ACTION.oneofs_by_name["action"].fields.append(
+    _ACTION.fields_by_name["publish_summary_to_cscc"]
+)
+_ACTION.fields_by_name[
+    "publish_summary_to_cscc"
+].containing_oneof = _ACTION.oneofs_by_name["action"]
+_ACTION.oneofs_by_name["action"].fields.append(
+    _ACTION.fields_by_name["publish_findings_to_cloud_data_catalog"]
+)
+_ACTION.fields_by_name[
+    "publish_findings_to_cloud_data_catalog"
+].containing_oneof = _ACTION.oneofs_by_name["action"]
+_ACTION.oneofs_by_name["action"].fields.append(
+    _ACTION.fields_by_name["job_notification_emails"]
+)
+_ACTION.fields_by_name[
+    "job_notification_emails"
+].containing_oneof = _ACTION.oneofs_by_name["action"]
+_CREATEINSPECTTEMPLATEREQUEST.fields_by_name[
+    "inspect_template"
+].message_type = _INSPECTTEMPLATE
+_UPDATEINSPECTTEMPLATEREQUEST.fields_by_name[
+    "inspect_template"
+].message_type = _INSPECTTEMPLATE
+_UPDATEINSPECTTEMPLATEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTINSPECTTEMPLATESRESPONSE.fields_by_name[
+    "inspect_templates"
+].message_type = _INSPECTTEMPLATE
+_CREATEJOBTRIGGERREQUEST.fields_by_name["job_trigger"].message_type = _JOBTRIGGER
+_UPDATEJOBTRIGGERREQUEST.fields_by_name["job_trigger"].message_type = _JOBTRIGGER
+_UPDATEJOBTRIGGERREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEDLPJOBREQUEST.fields_by_name["inspect_job"].message_type = _INSPECTJOBCONFIG
+_CREATEDLPJOBREQUEST.fields_by_name["risk_job"].message_type = _RISKANALYSISJOBCONFIG
+_CREATEDLPJOBREQUEST.oneofs_by_name["job"].fields.append(
+    _CREATEDLPJOBREQUEST.fields_by_name["inspect_job"]
+)
+_CREATEDLPJOBREQUEST.fields_by_name[
+    "inspect_job"
+].containing_oneof = _CREATEDLPJOBREQUEST.oneofs_by_name["job"]
+_CREATEDLPJOBREQUEST.oneofs_by_name["job"].fields.append(
+    _CREATEDLPJOBREQUEST.fields_by_name["risk_job"]
+)
+_CREATEDLPJOBREQUEST.fields_by_name[
+    "risk_job"
+].containing_oneof = _CREATEDLPJOBREQUEST.oneofs_by_name["job"]
+_LISTJOBTRIGGERSRESPONSE.fields_by_name["job_triggers"].message_type = _JOBTRIGGER
+_INSPECTJOBCONFIG.fields_by_name[
+    "storage_config"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._STORAGECONFIG
+)
+_INSPECTJOBCONFIG.fields_by_name["inspect_config"].message_type = _INSPECTCONFIG
+_INSPECTJOBCONFIG.fields_by_name["actions"].message_type = _ACTION
+_DLPJOB.fields_by_name["type"].enum_type = _DLPJOBTYPE
+_DLPJOB.fields_by_name["state"].enum_type = _DLPJOB_JOBSTATE
+_DLPJOB.fields_by_name["risk_details"].message_type = _ANALYZEDATASOURCERISKDETAILS
+_DLPJOB.fields_by_name["inspect_details"].message_type = _INSPECTDATASOURCEDETAILS
+_DLPJOB.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DLPJOB.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DLPJOB.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DLPJOB.fields_by_name["errors"].message_type = _ERROR
+_DLPJOB_JOBSTATE.containing_type = _DLPJOB
+_DLPJOB.oneofs_by_name["details"].fields.append(_DLPJOB.fields_by_name["risk_details"])
+_DLPJOB.fields_by_name["risk_details"].containing_oneof = _DLPJOB.oneofs_by_name[
+    "details"
+]
+_DLPJOB.oneofs_by_name["details"].fields.append(
+    _DLPJOB.fields_by_name["inspect_details"]
+)
+_DLPJOB.fields_by_name["inspect_details"].containing_oneof = _DLPJOB.oneofs_by_name[
+    "details"
+]
+_LISTDLPJOBSREQUEST.fields_by_name["type"].enum_type = _DLPJOBTYPE
+_LISTDLPJOBSRESPONSE.fields_by_name["jobs"].message_type = _DLPJOB
+_CREATEDEIDENTIFYTEMPLATEREQUEST.fields_by_name[
+    "deidentify_template"
+].message_type = _DEIDENTIFYTEMPLATE
+_UPDATEDEIDENTIFYTEMPLATEREQUEST.fields_by_name[
+    "deidentify_template"
+].message_type = _DEIDENTIFYTEMPLATE
+_UPDATEDEIDENTIFYTEMPLATEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTDEIDENTIFYTEMPLATESRESPONSE.fields_by_name[
+    "deidentify_templates"
+].message_type = _DEIDENTIFYTEMPLATE
+_LARGECUSTOMDICTIONARYCONFIG.fields_by_name[
+    "output_path"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._CLOUDSTORAGEPATH
+)
+_LARGECUSTOMDICTIONARYCONFIG.fields_by_name[
+    "cloud_storage_file_set"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._CLOUDSTORAGEFILESET
+)
+_LARGECUSTOMDICTIONARYCONFIG.fields_by_name[
+    "big_query_field"
+].message_type = (
+    google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_storage__pb2._BIGQUERYFIELD
+)
+_LARGECUSTOMDICTIONARYCONFIG.oneofs_by_name["source"].fields.append(
+    _LARGECUSTOMDICTIONARYCONFIG.fields_by_name["cloud_storage_file_set"]
+)
+_LARGECUSTOMDICTIONARYCONFIG.fields_by_name[
+    "cloud_storage_file_set"
+].containing_oneof = _LARGECUSTOMDICTIONARYCONFIG.oneofs_by_name["source"]
+_LARGECUSTOMDICTIONARYCONFIG.oneofs_by_name["source"].fields.append(
+    _LARGECUSTOMDICTIONARYCONFIG.fields_by_name["big_query_field"]
+)
+_LARGECUSTOMDICTIONARYCONFIG.fields_by_name[
+    "big_query_field"
+].containing_oneof = _LARGECUSTOMDICTIONARYCONFIG.oneofs_by_name["source"]
+_STOREDINFOTYPECONFIG.fields_by_name[
+    "large_custom_dictionary"
+].message_type = _LARGECUSTOMDICTIONARYCONFIG
+_STOREDINFOTYPECONFIG.oneofs_by_name["type"].fields.append(
+    _STOREDINFOTYPECONFIG.fields_by_name["large_custom_dictionary"]
+)
+_STOREDINFOTYPECONFIG.fields_by_name[
+    "large_custom_dictionary"
+].containing_oneof = _STOREDINFOTYPECONFIG.oneofs_by_name["type"]
+_STOREDINFOTYPESTATS.fields_by_name[
+    "large_custom_dictionary"
+].message_type = _LARGECUSTOMDICTIONARYSTATS
+_STOREDINFOTYPESTATS.oneofs_by_name["type"].fields.append(
+    _STOREDINFOTYPESTATS.fields_by_name["large_custom_dictionary"]
+)
+_STOREDINFOTYPESTATS.fields_by_name[
+    "large_custom_dictionary"
+].containing_oneof = _STOREDINFOTYPESTATS.oneofs_by_name["type"]
+_STOREDINFOTYPEVERSION.fields_by_name["config"].message_type = _STOREDINFOTYPECONFIG
+_STOREDINFOTYPEVERSION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STOREDINFOTYPEVERSION.fields_by_name["state"].enum_type = _STOREDINFOTYPESTATE
+_STOREDINFOTYPEVERSION.fields_by_name["errors"].message_type = _ERROR
+_STOREDINFOTYPEVERSION.fields_by_name["stats"].message_type = _STOREDINFOTYPESTATS
+_STOREDINFOTYPE.fields_by_name["current_version"].message_type = _STOREDINFOTYPEVERSION
+_STOREDINFOTYPE.fields_by_name["pending_versions"].message_type = _STOREDINFOTYPEVERSION
+_CREATESTOREDINFOTYPEREQUEST.fields_by_name[
+    "config"
+].message_type = _STOREDINFOTYPECONFIG
+_UPDATESTOREDINFOTYPEREQUEST.fields_by_name[
+    "config"
+].message_type = _STOREDINFOTYPECONFIG
+_UPDATESTOREDINFOTYPEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTSTOREDINFOTYPESRESPONSE.fields_by_name[
+    "stored_info_types"
+].message_type = _STOREDINFOTYPE
+DESCRIPTOR.message_types_by_name["ExcludeInfoTypes"] = _EXCLUDEINFOTYPES
+DESCRIPTOR.message_types_by_name["ExclusionRule"] = _EXCLUSIONRULE
+DESCRIPTOR.message_types_by_name["InspectionRule"] = _INSPECTIONRULE
+DESCRIPTOR.message_types_by_name["InspectionRuleSet"] = _INSPECTIONRULESET
+DESCRIPTOR.message_types_by_name["InspectConfig"] = _INSPECTCONFIG
+DESCRIPTOR.message_types_by_name["ByteContentItem"] = _BYTECONTENTITEM
+DESCRIPTOR.message_types_by_name["ContentItem"] = _CONTENTITEM
+DESCRIPTOR.message_types_by_name["Table"] = _TABLE
+DESCRIPTOR.message_types_by_name["InspectResult"] = _INSPECTRESULT
+DESCRIPTOR.message_types_by_name["Finding"] = _FINDING
+DESCRIPTOR.message_types_by_name["Location"] = _LOCATION
+DESCRIPTOR.message_types_by_name["ContentLocation"] = _CONTENTLOCATION
+DESCRIPTOR.message_types_by_name["DocumentLocation"] = _DOCUMENTLOCATION
+DESCRIPTOR.message_types_by_name["RecordLocation"] = _RECORDLOCATION
+DESCRIPTOR.message_types_by_name["TableLocation"] = _TABLELOCATION
+DESCRIPTOR.message_types_by_name["Range"] = _RANGE
+DESCRIPTOR.message_types_by_name["ImageLocation"] = _IMAGELOCATION
+DESCRIPTOR.message_types_by_name["BoundingBox"] = _BOUNDINGBOX
+DESCRIPTOR.message_types_by_name["RedactImageRequest"] = _REDACTIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["Color"] = _COLOR
+DESCRIPTOR.message_types_by_name["RedactImageResponse"] = _REDACTIMAGERESPONSE
+DESCRIPTOR.message_types_by_name["DeidentifyContentRequest"] = _DEIDENTIFYCONTENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeidentifyContentResponse"
+] = _DEIDENTIFYCONTENTRESPONSE
+DESCRIPTOR.message_types_by_name["ReidentifyContentRequest"] = _REIDENTIFYCONTENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ReidentifyContentResponse"
+] = _REIDENTIFYCONTENTRESPONSE
+DESCRIPTOR.message_types_by_name["InspectContentRequest"] = _INSPECTCONTENTREQUEST
+DESCRIPTOR.message_types_by_name["InspectContentResponse"] = _INSPECTCONTENTRESPONSE
+DESCRIPTOR.message_types_by_name["OutputStorageConfig"] = _OUTPUTSTORAGECONFIG
+DESCRIPTOR.message_types_by_name["InfoTypeStats"] = _INFOTYPESTATS
+DESCRIPTOR.message_types_by_name["InspectDataSourceDetails"] = _INSPECTDATASOURCEDETAILS
+DESCRIPTOR.message_types_by_name["InfoTypeDescription"] = _INFOTYPEDESCRIPTION
+DESCRIPTOR.message_types_by_name["ListInfoTypesRequest"] = _LISTINFOTYPESREQUEST
+DESCRIPTOR.message_types_by_name["ListInfoTypesResponse"] = _LISTINFOTYPESRESPONSE
+DESCRIPTOR.message_types_by_name["RiskAnalysisJobConfig"] = _RISKANALYSISJOBCONFIG
+DESCRIPTOR.message_types_by_name["QuasiId"] = _QUASIID
+DESCRIPTOR.message_types_by_name["StatisticalTable"] = _STATISTICALTABLE
+DESCRIPTOR.message_types_by_name["PrivacyMetric"] = _PRIVACYMETRIC
+DESCRIPTOR.message_types_by_name[
+    "AnalyzeDataSourceRiskDetails"
+] = _ANALYZEDATASOURCERISKDETAILS
+DESCRIPTOR.message_types_by_name["ValueFrequency"] = _VALUEFREQUENCY
+DESCRIPTOR.message_types_by_name["Value"] = _VALUE
+DESCRIPTOR.message_types_by_name["QuoteInfo"] = _QUOTEINFO
+DESCRIPTOR.message_types_by_name["DateTime"] = _DATETIME
+DESCRIPTOR.message_types_by_name["DeidentifyConfig"] = _DEIDENTIFYCONFIG
+DESCRIPTOR.message_types_by_name["PrimitiveTransformation"] = _PRIMITIVETRANSFORMATION
+DESCRIPTOR.message_types_by_name["TimePartConfig"] = _TIMEPARTCONFIG
+DESCRIPTOR.message_types_by_name["CryptoHashConfig"] = _CRYPTOHASHCONFIG
+DESCRIPTOR.message_types_by_name[
+    "CryptoDeterministicConfig"
+] = _CRYPTODETERMINISTICCONFIG
+DESCRIPTOR.message_types_by_name["ReplaceValueConfig"] = _REPLACEVALUECONFIG
+DESCRIPTOR.message_types_by_name[
+    "ReplaceWithInfoTypeConfig"
+] = _REPLACEWITHINFOTYPECONFIG
+DESCRIPTOR.message_types_by_name["RedactConfig"] = _REDACTCONFIG
+DESCRIPTOR.message_types_by_name["CharsToIgnore"] = _CHARSTOIGNORE
+DESCRIPTOR.message_types_by_name["CharacterMaskConfig"] = _CHARACTERMASKCONFIG
+DESCRIPTOR.message_types_by_name["FixedSizeBucketingConfig"] = _FIXEDSIZEBUCKETINGCONFIG
+DESCRIPTOR.message_types_by_name["BucketingConfig"] = _BUCKETINGCONFIG
+DESCRIPTOR.message_types_by_name[
+    "CryptoReplaceFfxFpeConfig"
+] = _CRYPTOREPLACEFFXFPECONFIG
+DESCRIPTOR.message_types_by_name["CryptoKey"] = _CRYPTOKEY
+DESCRIPTOR.message_types_by_name["TransientCryptoKey"] = _TRANSIENTCRYPTOKEY
+DESCRIPTOR.message_types_by_name["UnwrappedCryptoKey"] = _UNWRAPPEDCRYPTOKEY
+DESCRIPTOR.message_types_by_name["KmsWrappedCryptoKey"] = _KMSWRAPPEDCRYPTOKEY
+DESCRIPTOR.message_types_by_name["DateShiftConfig"] = _DATESHIFTCONFIG
+DESCRIPTOR.message_types_by_name["InfoTypeTransformations"] = _INFOTYPETRANSFORMATIONS
+DESCRIPTOR.message_types_by_name["FieldTransformation"] = _FIELDTRANSFORMATION
+DESCRIPTOR.message_types_by_name["RecordTransformations"] = _RECORDTRANSFORMATIONS
+DESCRIPTOR.message_types_by_name["RecordSuppression"] = _RECORDSUPPRESSION
+DESCRIPTOR.message_types_by_name["RecordCondition"] = _RECORDCONDITION
+DESCRIPTOR.message_types_by_name["TransformationOverview"] = _TRANSFORMATIONOVERVIEW
+DESCRIPTOR.message_types_by_name["TransformationSummary"] = _TRANSFORMATIONSUMMARY
+DESCRIPTOR.message_types_by_name["Schedule"] = _SCHEDULE
+DESCRIPTOR.message_types_by_name["InspectTemplate"] = _INSPECTTEMPLATE
+DESCRIPTOR.message_types_by_name["DeidentifyTemplate"] = _DEIDENTIFYTEMPLATE
+DESCRIPTOR.message_types_by_name["Error"] = _ERROR
+DESCRIPTOR.message_types_by_name["JobTrigger"] = _JOBTRIGGER
+DESCRIPTOR.message_types_by_name["Action"] = _ACTION
+DESCRIPTOR.message_types_by_name[
+    "CreateInspectTemplateRequest"
+] = _CREATEINSPECTTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateInspectTemplateRequest"
+] = _UPDATEINSPECTTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetInspectTemplateRequest"
+] = _GETINSPECTTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListInspectTemplatesRequest"
+] = _LISTINSPECTTEMPLATESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListInspectTemplatesResponse"
+] = _LISTINSPECTTEMPLATESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteInspectTemplateRequest"
+] = _DELETEINSPECTTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name["CreateJobTriggerRequest"] = _CREATEJOBTRIGGERREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ActivateJobTriggerRequest"
+] = _ACTIVATEJOBTRIGGERREQUEST
+DESCRIPTOR.message_types_by_name["UpdateJobTriggerRequest"] = _UPDATEJOBTRIGGERREQUEST
+DESCRIPTOR.message_types_by_name["GetJobTriggerRequest"] = _GETJOBTRIGGERREQUEST
+DESCRIPTOR.message_types_by_name["CreateDlpJobRequest"] = _CREATEDLPJOBREQUEST
+DESCRIPTOR.message_types_by_name["ListJobTriggersRequest"] = _LISTJOBTRIGGERSREQUEST
+DESCRIPTOR.message_types_by_name["ListJobTriggersResponse"] = _LISTJOBTRIGGERSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteJobTriggerRequest"] = _DELETEJOBTRIGGERREQUEST
+DESCRIPTOR.message_types_by_name["InspectJobConfig"] = _INSPECTJOBCONFIG
+DESCRIPTOR.message_types_by_name["DlpJob"] = _DLPJOB
+DESCRIPTOR.message_types_by_name["GetDlpJobRequest"] = _GETDLPJOBREQUEST
+DESCRIPTOR.message_types_by_name["ListDlpJobsRequest"] = _LISTDLPJOBSREQUEST
+DESCRIPTOR.message_types_by_name["ListDlpJobsResponse"] = _LISTDLPJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["CancelDlpJobRequest"] = _CANCELDLPJOBREQUEST
+DESCRIPTOR.message_types_by_name["DeleteDlpJobRequest"] = _DELETEDLPJOBREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateDeidentifyTemplateRequest"
+] = _CREATEDEIDENTIFYTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateDeidentifyTemplateRequest"
+] = _UPDATEDEIDENTIFYTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetDeidentifyTemplateRequest"
+] = _GETDEIDENTIFYTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDeidentifyTemplatesRequest"
+] = _LISTDEIDENTIFYTEMPLATESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDeidentifyTemplatesResponse"
+] = _LISTDEIDENTIFYTEMPLATESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteDeidentifyTemplateRequest"
+] = _DELETEDEIDENTIFYTEMPLATEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "LargeCustomDictionaryConfig"
+] = _LARGECUSTOMDICTIONARYCONFIG
+DESCRIPTOR.message_types_by_name[
+    "LargeCustomDictionaryStats"
+] = _LARGECUSTOMDICTIONARYSTATS
+DESCRIPTOR.message_types_by_name["StoredInfoTypeConfig"] = _STOREDINFOTYPECONFIG
+DESCRIPTOR.message_types_by_name["StoredInfoTypeStats"] = _STOREDINFOTYPESTATS
+DESCRIPTOR.message_types_by_name["StoredInfoTypeVersion"] = _STOREDINFOTYPEVERSION
+DESCRIPTOR.message_types_by_name["StoredInfoType"] = _STOREDINFOTYPE
+DESCRIPTOR.message_types_by_name[
+    "CreateStoredInfoTypeRequest"
+] = _CREATESTOREDINFOTYPEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateStoredInfoTypeRequest"
+] = _UPDATESTOREDINFOTYPEREQUEST
+DESCRIPTOR.message_types_by_name["GetStoredInfoTypeRequest"] = _GETSTOREDINFOTYPEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListStoredInfoTypesRequest"
+] = _LISTSTOREDINFOTYPESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListStoredInfoTypesResponse"
+] = _LISTSTOREDINFOTYPESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteStoredInfoTypeRequest"
+] = _DELETESTOREDINFOTYPEREQUEST
+DESCRIPTOR.enum_types_by_name["ContentOption"] = _CONTENTOPTION
+DESCRIPTOR.enum_types_by_name["MatchingType"] = _MATCHINGTYPE
+DESCRIPTOR.enum_types_by_name["InfoTypeSupportedBy"] = _INFOTYPESUPPORTEDBY
+DESCRIPTOR.enum_types_by_name["RelationalOperator"] = _RELATIONALOPERATOR
+DESCRIPTOR.enum_types_by_name["DlpJobType"] = _DLPJOBTYPE
+DESCRIPTOR.enum_types_by_name["StoredInfoTypeState"] = _STOREDINFOTYPESTATE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ExcludeInfoTypes = _reflection.GeneratedProtocolMessageType(
+    "ExcludeInfoTypes",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXCLUDEINFOTYPES,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""List of exclude infoTypes.
+  
+  
+  Attributes:
+      info_types:
+          InfoType list in ExclusionRule rule drops a finding when it
+          overlaps or contained within with a finding of an infoType
+          from this list. For example, for
+          ``InspectionRuleSet.info_types`` containing
+          "PHONE\_NUMBER"``and``\ exclusion\_rule\ ``containing``\
+          exclude\_info\_types.info\_types\` with "EMAIL\_ADDRESS" the
+          phone number findings are dropped if they overlap with
+          EMAIL\_ADDRESS finding. That leads to
+          "555-222-2222@example.org" to generate only a single finding,
+          namely email address.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ExcludeInfoTypes)
+    ),
+)
+_sym_db.RegisterMessage(ExcludeInfoTypes)
+
+ExclusionRule = _reflection.GeneratedProtocolMessageType(
+    "ExclusionRule",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXCLUSIONRULE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The rule that specifies conditions when findings of infoTypes specified
+  in ``InspectionRuleSet`` are removed from results.
+  
+  
+  Attributes:
+      dictionary:
+          Dictionary which defines the rule.
+      regex:
+          Regular expression which defines the rule.
+      exclude_info_types:
+          Set of infoTypes for which findings would affect this rule.
+      matching_type:
+          How the rule is applied, see MatchingType documentation for
+          details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ExclusionRule)
+    ),
+)
+_sym_db.RegisterMessage(ExclusionRule)
+
+InspectionRule = _reflection.GeneratedProtocolMessageType(
+    "InspectionRule",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTIONRULE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A single inspection rule to be applied to infoTypes, specified in
+  ``InspectionRuleSet``.
+  
+  
+  Attributes:
+      hotword_rule:
+          Hotword-based detection rule.
+      exclusion_rule:
+          Exclusion rule.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectionRule)
+    ),
+)
+_sym_db.RegisterMessage(InspectionRule)
+
+InspectionRuleSet = _reflection.GeneratedProtocolMessageType(
+    "InspectionRuleSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTIONRULESET,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Rule set for modifying a set of infoTypes to alter behavior under
+  certain circumstances, depending on the specific details of the rules
+  within the set.
+  
+  
+  Attributes:
+      info_types:
+          List of infoTypes this rule set is applied to.
+      rules:
+          Set of rules to be applied to infoTypes. The rules are applied
+          in order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectionRuleSet)
+    ),
+)
+_sym_db.RegisterMessage(InspectionRuleSet)
+
+InspectConfig = _reflection.GeneratedProtocolMessageType(
+    "InspectConfig",
+    (_message.Message,),
+    dict(
+        FindingLimits=_reflection.GeneratedProtocolMessageType(
+            "FindingLimits",
+            (_message.Message,),
+            dict(
+                InfoTypeLimit=_reflection.GeneratedProtocolMessageType(
+                    "InfoTypeLimit",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_INSPECTCONFIG_FINDINGLIMITS_INFOTYPELIMIT,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""Max findings configuration per infoType, per content item or long
+      running DlpJob.
+      
+      
+      Attributes:
+          info_type:
+              Type of information the findings limit applies to. Only one
+              limit per info\_type should be provided. If InfoTypeLimit does
+              not have an info\_type, the DLP API applies the limit against
+              all info\_types that are found but not specified in another
+              InfoTypeLimit.
+          max_findings:
+              Max findings limit for the given infoType.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectConfig.FindingLimits.InfoTypeLimit)
+                    ),
+                ),
+                DESCRIPTOR=_INSPECTCONFIG_FINDINGLIMITS,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc="""
+    Attributes:
+        max_findings_per_item:
+            Max number of findings that will be returned for each item
+            scanned. When set within ``InspectDataSourceRequest``, the
+            maximum returned is 2000 regardless if this is set higher.
+            When set within ``InspectContentRequest``, this field is
+            ignored.
+        max_findings_per_request: \
+            Max number of findings that will be returned per request/job. \
+            When set within ``InspectContentRequest``, the maximum \
+            returned is 2000 regardless if this is set higher.
+        max_findings_per_info_type: \
+            Configuration of findings limit given for specified infoTypes.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectConfig.FindingLimits)
+            ),
+        ),
+        DESCRIPTOR=_INSPECTCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Configuration description of the scanning process. When used with
+  redactContent only info\_types and min\_likelihood are currently used.
+  
+  
+  Attributes:
+      info_types:
+          Restricts what info\_types to look for. The values must
+          correspond to InfoType values returned by ListInfoTypes or
+          listed at https://cloud.google.com/dlp/docs/infotypes-
+          reference.  When no InfoTypes or CustomInfoTypes are specified
+          in a request, the 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.
+      min_likelihood:
+          Only returns findings equal or above this threshold. The
+          default is POSSIBLE. See
+          https://cloud.google.com/dlp/docs/likelihood to learn more.
+      include_quote:
+          When true, a contextual quote from the data that triggered a
+          finding is included in the response; see Finding.quote.
+      exclude_info_types:
+          When true, excludes type information of the findings.
+      custom_info_types:
+          CustomInfoTypes provided by the user. See
+          https://cloud.google.com/dlp/docs/creating-custom-infotypes to
+          learn more.
+      content_options:
+          List of options defining data content to scan. If empty, text,
+          images, and other content will be included.
+      rule_set:
+          Set of rules to apply to the findings for this InspectConfig.
+          Exclusion rules, contained in the set are executed in the end,
+          other rules are executed in the order they are specified for
+          each info type.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectConfig)
+    ),
+)
+_sym_db.RegisterMessage(InspectConfig)
+_sym_db.RegisterMessage(InspectConfig.FindingLimits)
+_sym_db.RegisterMessage(InspectConfig.FindingLimits.InfoTypeLimit)
+
+ByteContentItem = _reflection.GeneratedProtocolMessageType(
+    "ByteContentItem",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BYTECONTENTITEM,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Container for bytes to inspect or redact.
+  
+  
+  Attributes:
+      type:
+          The type of data stored in the bytes string. Default will be
+          TEXT\_UTF8.
+      data:
+          Content data to inspect or redact.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ByteContentItem)
+    ),
+)
+_sym_db.RegisterMessage(ByteContentItem)
+
+ContentItem = _reflection.GeneratedProtocolMessageType(
+    "ContentItem",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CONTENTITEM,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Container structure for the content to inspect.
+  
+  
+  Attributes:
+      data_item:
+          Data of the item either in the byte array or UTF-8 string
+          form, or table.
+      value:
+          String data to inspect or redact.
+      table:
+          Structured content for inspection. See
+          https://cloud.google.com/dlp/docs/inspecting-
+          text#inspecting\_a\_table to learn more.
+      byte_item:
+          Content data to inspect or redact. Replaces ``type`` and
+          ``data``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ContentItem)
+    ),
+)
+_sym_db.RegisterMessage(ContentItem)
+
+Table = _reflection.GeneratedProtocolMessageType(
+    "Table",
+    (_message.Message,),
+    dict(
+        Row=_reflection.GeneratedProtocolMessageType(
+            "Row",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TABLE_ROW,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2"
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Table.Row)
+            ),
+        ),
+        DESCRIPTOR=_TABLE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Structured content to inspect. Up to 50,000 ``Value``\ s per request
+  allowed. See
+  https://cloud.google.com/dlp/docs/inspecting-text#inspecting\_a\_table
+  to learn more.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Table)
+    ),
+)
+_sym_db.RegisterMessage(Table)
+_sym_db.RegisterMessage(Table.Row)
+
+InspectResult = _reflection.GeneratedProtocolMessageType(
+    "InspectResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTRESULT,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""All the findings for a single scanned item.
+  
+  
+  Attributes:
+      findings:
+          List of findings for an item.
+      findings_truncated:
+          If true, then this item might have more findings than were
+          returned, and the findings returned are an arbitrary subset of
+          all findings. The findings list might be truncated because the
+          input items were too large, or because the server reached the
+          maximum amount of resources allowed for a single API call. For
+          best results, divide the input into smaller batches.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectResult)
+    ),
+)
+_sym_db.RegisterMessage(InspectResult)
+
+Finding = _reflection.GeneratedProtocolMessageType(
+    "Finding",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINDING,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Represents a piece of potentially sensitive content.
+  
+  
+  Attributes:
+      quote:
+          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 less
+          than or equal to 4096 bytes long. If the finding exceeds 4096
+          bytes in length, the quote may be omitted.
+      info_type:
+          The type of content that might have been found. Provided if
+          ``excluded_types`` is false.
+      likelihood:
+          Confidence of how likely it is that the ``info_type`` is
+          correct.
+      location:
+          Where the content was found.
+      create_time:
+          Timestamp when finding was detected.
+      quote_info:
+          Contains data parsed from quotes. Only populated if
+          include\_quote was set to true and a supported infoType was
+          requested. Currently supported infoTypes: DATE,
+          DATE\_OF\_BIRTH and TIME.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Finding)
+    ),
+)
+_sym_db.RegisterMessage(Finding)
+
+Location = _reflection.GeneratedProtocolMessageType(
+    "Location",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Specifies the location of the finding.
+  
+  
+  Attributes:
+      byte_range:
+          Zero-based byte offsets delimiting the finding. These are
+          relative to the finding's containing element. Note that when
+          the content is not textual, this references the UTF-8 encoded
+          textual representation of the content. Omitted if content is
+          an image.
+      codepoint_range:
+          Unicode character offsets delimiting the finding. These are
+          relative to the finding's containing element. Provided when
+          the content is text.
+      content_locations:
+          List of nested objects pointing to the precise location of the
+          finding within the file or record.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Location)
+    ),
+)
+_sym_db.RegisterMessage(Location)
+
+ContentLocation = _reflection.GeneratedProtocolMessageType(
+    "ContentLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CONTENTLOCATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Findings container location data.
+  
+  
+  Attributes:
+      container_name:
+          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: ``<project_id>:<dataset_id>.<table_id>`` -
+          Cloud Storage files: ``gs://<bucket>/<path>`` -  Datastore
+          namespace:  Nested names could be absent if the embedded
+          object has no string identifier (for an example an image
+          contained within a document).
+      location:
+          Type of the container within the file with location of the
+          finding.
+      record_location:
+          Location within a row or record of a database table.
+      image_location:
+          Location within an image's pixels.
+      document_location:
+          Location data for document files.
+      container_timestamp:
+          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.
+      container_version:
+          Findings container version, if available ("generation" for
+          Google Cloud Storage).
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ContentLocation)
+    ),
+)
+_sym_db.RegisterMessage(ContentLocation)
+
+DocumentLocation = _reflection.GeneratedProtocolMessageType(
+    "DocumentLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTLOCATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Location of a finding within a document.
+  
+  
+  Attributes:
+      file_offset:
+          Offset of the line, from the beginning of the file, where the
+          finding is located.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DocumentLocation)
+    ),
+)
+_sym_db.RegisterMessage(DocumentLocation)
+
+RecordLocation = _reflection.GeneratedProtocolMessageType(
+    "RecordLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECORDLOCATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Location of a finding within a row or record.
+  
+  
+  Attributes:
+      record_key:
+          Key of the finding.
+      field_id:
+          Field id of the field containing the finding.
+      table_location:
+          Location within a ``ContentItem.Table``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordLocation)
+    ),
+)
+_sym_db.RegisterMessage(RecordLocation)
+
+TableLocation = _reflection.GeneratedProtocolMessageType(
+    "TableLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TABLELOCATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Location of a finding within a table.
+  
+  
+  Attributes:
+      row_index:
+          The zero-based index of the row where the finding is located.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.TableLocation)
+    ),
+)
+_sym_db.RegisterMessage(TableLocation)
+
+Range = _reflection.GeneratedProtocolMessageType(
+    "Range",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RANGE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Generic half-open interval [start, end)
+  
+  
+  Attributes:
+      start:
+          Index of the first character of the range (inclusive).
+      end:
+          Index of the last character of the range (exclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Range)
+    ),
+)
+_sym_db.RegisterMessage(Range)
+
+ImageLocation = _reflection.GeneratedProtocolMessageType(
+    "ImageLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGELOCATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Location of the finding within an image.
+  
+  
+  Attributes:
+      bounding_boxes:
+          Bounding boxes locating the pixels within the image containing
+          the finding.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ImageLocation)
+    ),
+)
+_sym_db.RegisterMessage(ImageLocation)
+
+BoundingBox = _reflection.GeneratedProtocolMessageType(
+    "BoundingBox",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGBOX,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Bounding box encompassing detected text within an image.
+  
+  
+  Attributes:
+      top:
+          Top coordinate of the bounding box. (0,0) is upper left.
+      left:
+          Left coordinate of the bounding box. (0,0) is upper left.
+      width:
+          Width of the bounding box in pixels.
+      height:
+          Height of the bounding box in pixels.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BoundingBox)
+    ),
+)
+_sym_db.RegisterMessage(BoundingBox)
+
+RedactImageRequest = _reflection.GeneratedProtocolMessageType(
+    "RedactImageRequest",
+    (_message.Message,),
+    dict(
+        ImageRedactionConfig=_reflection.GeneratedProtocolMessageType(
+            "ImageRedactionConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_REDACTIMAGEREQUEST_IMAGEREDACTIONCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Configuration for determining how redaction of images should occur.
+    
+    
+    Attributes:
+        target:
+            Type of information to redact from images.
+        info_type:
+            Only one per info\_type should be provided per request. If not
+            specified, and redact\_all\_text is false, the DLP API will
+            redact all text that it matches against all info\_types that
+            are found, but not specified in another ImageRedactionConfig.
+        redact_all_text:
+            If true, all text found in the image, regardless whether it
+            matches an info\_type, is redacted. Only one should be
+            provided.
+        redaction_color:
+            The color to use when redacting content from an image. If not
+            specified, the default is black.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig)
+            ),
+        ),
+        DESCRIPTOR=_REDACTIMAGEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request to search for potentially sensitive info in an image and redact
+  it by covering it with a colored rectangle.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id.
+      inspect_config:
+          Configuration for the inspector.
+      image_redaction_configs:
+          The configuration for specifying what content to redact from
+          images.
+      include_findings:
+          Whether the response should include findings along with the
+          redacted image.
+      byte_item:
+          The content must be PNG, JPEG, SVG or BMP.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RedactImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(RedactImageRequest)
+_sym_db.RegisterMessage(RedactImageRequest.ImageRedactionConfig)
+
+Color = _reflection.GeneratedProtocolMessageType(
+    "Color",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLOR,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Represents a color in the RGB color space.
+  
+  
+  Attributes:
+      red:
+          The amount of red in the color as a value in the interval [0,
+          1].
+      green:
+          The amount of green in the color as a value in the interval
+          [0, 1].
+      blue:
+          The amount of blue in the color as a value in the interval [0,
+          1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Color)
+    ),
+)
+_sym_db.RegisterMessage(Color)
+
+RedactImageResponse = _reflection.GeneratedProtocolMessageType(
+    "RedactImageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REDACTIMAGERESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Results of redacting an image.
+  
+  
+  Attributes:
+      redacted_image:
+          The redacted image. The type will be the same as the original
+          image.
+      extracted_text:
+          If an image was being inspected and the InspectConfig's
+          include\_quote was set to true, then this field will include
+          all text, if any, that was found in the image.
+      inspect_result:
+          The findings. Populated when include\_findings in the request
+          is true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RedactImageResponse)
+    ),
+)
+_sym_db.RegisterMessage(RedactImageResponse)
+
+DeidentifyContentRequest = _reflection.GeneratedProtocolMessageType(
+    "DeidentifyContentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEIDENTIFYCONTENTREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request to de-identify a list of items.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id.
+      deidentify_config:
+          Configuration for the de-identification of the content item.
+          Items specified here will override the template referenced by
+          the deidentify\_template\_name argument.
+      inspect_config:
+          Configuration for the inspector. Items specified here will
+          override the template referenced by the
+          inspect\_template\_name argument.
+      item:
+          The item to de-identify. Will be treated as text.
+      inspect_template_name:
+          Optional 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.
+      deidentify_template_name:
+          Optional 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeidentifyContentRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeidentifyContentRequest)
+
+DeidentifyContentResponse = _reflection.GeneratedProtocolMessageType(
+    "DeidentifyContentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEIDENTIFYCONTENTRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Results of de-identifying a ContentItem.
+  
+  
+  Attributes:
+      item:
+          The de-identified item.
+      overview:
+          An overview of the changes that were made on the ``item``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeidentifyContentResponse)
+    ),
+)
+_sym_db.RegisterMessage(DeidentifyContentResponse)
+
+ReidentifyContentRequest = _reflection.GeneratedProtocolMessageType(
+    "ReidentifyContentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REIDENTIFYCONTENTREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request to re-identify an item.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name.
+      reidentify_config:
+          Configuration for the re-identification of the content item.
+          This field shares the same proto message type that is used for
+          de-identification, however its usage here is for the reversal
+          of the previous de-identification. Re-identification is
+          performed by examining the transformations used to de-identify
+          the items and executing the reverse. This requires that only
+          reversible transformations be provided here. The reversible
+          transformations are:  -  ``CryptoReplaceFfxFpeConfig``
+      inspect_config:
+          Configuration for the inspector.
+      item:
+          The item to re-identify. Will be treated as text.
+      inspect_template_name:
+          Optional 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.
+      reidentify_template_name:
+          Optional 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ReidentifyContentRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReidentifyContentRequest)
+
+ReidentifyContentResponse = _reflection.GeneratedProtocolMessageType(
+    "ReidentifyContentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REIDENTIFYCONTENTRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Results of re-identifying a item.
+  
+  
+  Attributes:
+      item:
+          The re-identified item.
+      overview:
+          An overview of the changes that were made to the ``item``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ReidentifyContentResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReidentifyContentResponse)
+
+InspectContentRequest = _reflection.GeneratedProtocolMessageType(
+    "InspectContentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTCONTENTREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request to search for potentially sensitive info in a ContentItem.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id.
+      inspect_config:
+          Configuration for the inspector. What specified here will
+          override the template referenced by the
+          inspect\_template\_name argument.
+      item:
+          The item to inspect.
+      inspect_template_name:
+          Optional 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectContentRequest)
+    ),
+)
+_sym_db.RegisterMessage(InspectContentRequest)
+
+InspectContentResponse = _reflection.GeneratedProtocolMessageType(
+    "InspectContentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTCONTENTRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Results of inspecting an item.
+  
+  
+  Attributes:
+      result:
+          The findings.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectContentResponse)
+    ),
+)
+_sym_db.RegisterMessage(InspectContentResponse)
+
+OutputStorageConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputStorageConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTSTORAGECONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Cloud repository for storing output.
+  
+  
+  Attributes:
+      table:
+          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 for you with the following format:
+          dlp\_googleapis\_yyyy\_mm\_dd\_[dlp\_job\_id]. Pacific
+          timezone will be used for generating the date details.  For
+          Inspect, each column in an existing output table must have the
+          same name, type, and mode of a field in the ``Finding``
+          object.  For Risk, an existing output table should be the
+          output of a previous Risk analysis job run on the same source
+          table, with the same privacy metric and quasi-identifiers.
+          Risk jobs that analyze the same table but compute a different
+          privacy metric, or use different sets of quasi-identifiers,
+          cannot store their results in the same table.
+      output_schema:
+          Schema used for writing the findings for Inspect jobs. This
+          field is only used for Inspect and must be unspecified for
+          Risk jobs. Columns are derived from the ``Finding`` object. If
+          appending to an existing table, any columns from the
+          predefined schema that are missing will be added. No columns
+          in the existing table will be deleted.  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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.OutputStorageConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputStorageConfig)
+
+InfoTypeStats = _reflection.GeneratedProtocolMessageType(
+    "InfoTypeStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INFOTYPESTATS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Statistics regarding a specific InfoType.
+  
+  
+  Attributes:
+      info_type:
+          The type of finding this stat is for.
+      count:
+          Number of findings for this infoType.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InfoTypeStats)
+    ),
+)
+_sym_db.RegisterMessage(InfoTypeStats)
+
+InspectDataSourceDetails = _reflection.GeneratedProtocolMessageType(
+    "InspectDataSourceDetails",
+    (_message.Message,),
+    dict(
+        RequestedOptions=_reflection.GeneratedProtocolMessageType(
+            "RequestedOptions",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSPECTDATASOURCEDETAILS_REQUESTEDOPTIONS,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc="""
+    Attributes:
+        snapshot_inspect_template: \
+            If run with an InspectTemplate, a snapshot of its state at the \
+            time of this run.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectDataSourceDetails.RequestedOptions)
+            ),
+        ),
+        Result=_reflection.GeneratedProtocolMessageType(
+            "Result",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSPECTDATASOURCEDETAILS_RESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""All result fields mentioned below are updated while the job is
+    processing.
+    
+    
+    Attributes:
+        processed_bytes: \
+            Total size in bytes that were processed.
+        total_estimated_bytes: \
+            Estimate of the number of bytes to process.
+        info_type_stats: \
+            Statistics of how many instances of each info type were found \
+            during inspect job.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectDataSourceDetails.Result)
+            ),
+        ),
+        DESCRIPTOR=_INSPECTDATASOURCEDETAILS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The results of an inspect DataSource job.
+  
+  
+  Attributes:
+      requested_options: \
+          The configuration used for this job.
+      result: \
+          A summary of the outcome of this inspect job.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectDataSourceDetails)
+    ),
+)
+_sym_db.RegisterMessage(InspectDataSourceDetails)
+_sym_db.RegisterMessage(InspectDataSourceDetails.RequestedOptions)
+_sym_db.RegisterMessage(InspectDataSourceDetails.Result)
+
+InfoTypeDescription = _reflection.GeneratedProtocolMessageType(
+    "InfoTypeDescription",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INFOTYPEDESCRIPTION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""InfoType description.
+  
+  
+  Attributes:
+      name:
+          Internal name of the infoType.
+      display_name:
+          Human readable form of the infoType name.
+      supported_by:
+          Which parts of the API supports this InfoType.
+      description:
+          Description of the infotype. Translated when language is
+          provided in the request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InfoTypeDescription)
+    ),
+)
+_sym_db.RegisterMessage(InfoTypeDescription)
+
+ListInfoTypesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInfoTypesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINFOTYPESREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request for the list of infoTypes.
+  
+  
+  Attributes:
+      language_code:
+          Optional BCP-47 language code for localized infoType friendly
+          names. If omitted, or if localized strings are not available,
+          en-US strings will be returned.
+      filter:
+          Optional filter to only return infoTypes supported by certain
+          parts of the API. Defaults to supported\_by=INSPECT.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListInfoTypesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInfoTypesRequest)
+
+ListInfoTypesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInfoTypesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINFOTYPESRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Response to the ListInfoTypes request.
+  
+  
+  Attributes:
+      info_types:
+          Set of sensitive infoTypes.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListInfoTypesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInfoTypesResponse)
+
+RiskAnalysisJobConfig = _reflection.GeneratedProtocolMessageType(
+    "RiskAnalysisJobConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RISKANALYSISJOBCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Configuration for a risk analysis job. See
+  https://cloud.google.com/dlp/docs/concepts-risk-analysis to learn more.
+  
+  
+  Attributes:
+      privacy_metric:
+          Privacy metric to compute.
+      source_table:
+          Input dataset to compute metrics over.
+      actions:
+          Actions to execute at the completion of the job. Are executed
+          in the order provided.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RiskAnalysisJobConfig)
+    ),
+)
+_sym_db.RegisterMessage(RiskAnalysisJobConfig)
+
+QuasiId = _reflection.GeneratedProtocolMessageType(
+    "QuasiId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUASIID,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A column with a semantic tag attached.
+  
+  
+  Attributes:
+      field:
+          Identifies the column. [required]
+      tag:
+          Semantic tag that identifies what a column contains, to
+          determine which statistical model to use to estimate the
+          reidentifiability of each value. [required]
+      info_type:
+          A column can be tagged with a InfoType to use the relevant
+          public dataset as a statistical model of population, if
+          available. We currently support US ZIP codes, region codes,
+          ages and genders. To programmatically obtain the list of
+          supported InfoTypes, use ListInfoTypes with the
+          supported\_by=RISK\_ANALYSIS filter.
+      custom_tag:
+          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).
+      inferred:
+          If no semantic tag is indicated, we infer the statistical
+          model from the distribution of values in the input data
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.QuasiId)
+    ),
+)
+_sym_db.RegisterMessage(QuasiId)
+
+StatisticalTable = _reflection.GeneratedProtocolMessageType(
+    "StatisticalTable",
+    (_message.Message,),
+    dict(
+        QuasiIdentifierField=_reflection.GeneratedProtocolMessageType(
+            "QuasiIdentifierField",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STATISTICALTABLE_QUASIIDENTIFIERFIELD,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""A quasi-identifier column has a custom\_tag, used to know which column
+    in the data corresponds to which column in the statistical model.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField)
+            ),
+        ),
+        DESCRIPTOR=_STATISTICALTABLE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""An auxiliary table containing statistical information on the relative
+  frequency of different quasi-identifiers values. It has one or several
+  quasi-identifiers columns, and one column that indicates the relative
+  frequency of each quasi-identifier tuple. If a tuple is present in the
+  data but not in the auxiliary table, the corresponding relative
+  frequency is assumed to be zero (and thus, the tuple is highly
+  reidentifiable).
+  
+  
+  Attributes:
+      table:
+          Auxiliary table location. [required]
+      quasi_ids:
+          Quasi-identifier columns. [required]
+      relative_frequency:
+          The relative frequency column must contain a floating-point
+          number between 0 and 1 (inclusive). Null values are assumed to
+          be zero. [required]
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StatisticalTable)
+    ),
+)
+_sym_db.RegisterMessage(StatisticalTable)
+_sym_db.RegisterMessage(StatisticalTable.QuasiIdentifierField)
+
+PrivacyMetric = _reflection.GeneratedProtocolMessageType(
+    "PrivacyMetric",
+    (_message.Message,),
+    dict(
+        NumericalStatsConfig=_reflection.GeneratedProtocolMessageType(
+            "NumericalStatsConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRIVACYMETRIC_NUMERICALSTATSCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Compute numerical stats over an individual column, including min, max,
+    and quantiles.
+    
+    
+    Attributes:
+        field:
+            Field to compute numerical stats on. Supported types are
+            integer, float, date, datetime, timestamp, time.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfig)
+            ),
+        ),
+        CategoricalStatsConfig=_reflection.GeneratedProtocolMessageType(
+            "CategoricalStatsConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRIVACYMETRIC_CATEGORICALSTATSCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Compute numerical stats over an individual column, including number of
+    distinct values and value count distribution.
+    
+    
+    Attributes:
+        field:
+            Field to compute categorical stats on. All column types are
+            supported except for arrays and structs. However, it may be
+            more informative to use NumericalStats when the field type is
+            supported, depending on the data.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.CategoricalStatsConfig)
+            ),
+        ),
+        KAnonymityConfig=_reflection.GeneratedProtocolMessageType(
+            "KAnonymityConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRIVACYMETRIC_KANONYMITYCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""k-anonymity metric, used for analysis of reidentification risk.
+    
+    
+    Attributes:
+        quasi_ids:
+            Set of fields to compute k-anonymity over. When multiple
+            fields are specified, they are considered a single composite
+            key. Structs and repeated data types are not supported;
+            however, nested fields are supported so long as they are not
+            structs themselves or nested within a repeated field.
+        entity_id:
+            Optional 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 is a multiset: the
+            order in which the different tuples appear in the dataset is
+            ignored, but their frequency is taken into account.  Important
+            note: a maximum of 1000 rows can be associated to a single
+            entity ID. If more rows are associated with the same entity
+            ID, some might be ignored.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.KAnonymityConfig)
+            ),
+        ),
+        LDiversityConfig=_reflection.GeneratedProtocolMessageType(
+            "LDiversityConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRIVACYMETRIC_LDIVERSITYCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""l-diversity metric, used for analysis of reidentification risk.
+    
+    
+    Attributes:
+        quasi_ids:
+            Set of quasi-identifiers indicating how equivalence classes
+            are defined for the l-diversity computation. When multiple
+            fields are specified, they are considered a single composite
+            key.
+        sensitive_attribute:
+            Sensitive field for computing the l-value.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.LDiversityConfig)
+            ),
+        ),
+        KMapEstimationConfig=_reflection.GeneratedProtocolMessageType(
+            "KMapEstimationConfig",
+            (_message.Message,),
+            dict(
+                TaggedField=_reflection.GeneratedProtocolMessageType(
+                    "TaggedField",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_TAGGEDFIELD,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc="""
+    Attributes:
+          field: \
+              Identifies the column. [required]
+          tag: \
+              Semantic tag that identifies what a column contains, to \
+              determine which statistical model to use to estimate the \
+              reidentifiability of each value. [required] \
+          info_type: \
+              A column can be tagged with a InfoType to use the relevant \
+              public dataset as a statistical model of population, if \
+              available. We currently support US ZIP codes, region codes, \
+              ages and genders. To programmatically obtain the list of \
+              supported InfoTypes, use ListInfoTypes with the \
+              supported\_by=RISK\_ANALYSIS filter.
+          custom_tag: \
+              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).
+          inferred: \
+              If no semantic tag is indicated, we infer the statistical \
+              model from the distribution of values in the input data
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField)
+                    ),
+                ),
+                AuxiliaryTable=_reflection.GeneratedProtocolMessageType(
+                    "AuxiliaryTable",
+                    (_message.Message,),
+                    dict(
+                        QuasiIdField=_reflection.GeneratedProtocolMessageType(
+                            "QuasiIdField",
+                            (_message.Message,),
+                            dict(
+                                DESCRIPTOR=_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE_QUASIIDFIELD,
+                                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                                __doc__="""A quasi-identifier column has a custom\_tag, used to know which column
+        in the data corresponds to which column in the statistical model.
+        """,
+                                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField)
+                            ),
+                        ),
+                        DESCRIPTOR=_PRIVACYMETRIC_KMAPESTIMATIONCONFIG_AUXILIARYTABLE,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""An auxiliary table contains statistical information on the relative
+      frequency of different quasi-identifiers values. It has one or several
+      quasi-identifiers columns, and one column that indicates the relative
+      frequency of each quasi-identifier tuple. If a tuple is present in the
+      data but not in the auxiliary table, the corresponding relative
+      frequency is assumed to be zero (and thus, the tuple is highly
+      reidentifiable).
+      
+      
+      Attributes:
+          table:
+              Auxiliary table location. [required]
+          quasi_ids:
+              Quasi-identifier columns. [required]
+          relative_frequency:
+              The relative frequency column must contain a floating-point
+              number between 0 and 1 (inclusive). Null values are assumed to
+              be zero. [required]
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable)
+                    ),
+                ),
+                DESCRIPTOR=_PRIVACYMETRIC_KMAPESTIMATIONCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Reidentifiability metric. This corresponds to a risk model similar to
+    what is called "journalist risk" in the literature, except the attack
+    dataset is statistically modeled instead of being perfectly known. This
+    can be done 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.
+    
+    
+    Attributes:
+        quasi_ids:
+            Fields considered to be quasi-identifiers. No two columns can
+            have the same tag. [required]
+        region_code:
+            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 US\_ZIP\_5) or a region code.
+        auxiliary_tables:
+            Several auxiliary tables can be used in the analysis. Each
+            custom\_tag used to tag a quasi-identifiers column must appear
+            in exactly one column of one auxiliary table.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig)
+            ),
+        ),
+        DeltaPresenceEstimationConfig=_reflection.GeneratedProtocolMessageType(
+            "DeltaPresenceEstimationConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRIVACYMETRIC_DELTAPRESENCEESTIMATIONCONFIG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""δ-presence metric, used to estimate how likely it is for an attacker to
+    figure out that one given individual appears in a de-identified dataset.
+    Similarly to the k-map metric, we cannot compute δ-presence exactly
+    without knowing the attack dataset, so we use a statistical model
+    instead.
+    
+    
+    Attributes:
+        quasi_ids:
+            Fields considered to be quasi-identifiers. No two fields can
+            have the same tag. [required]
+        region_code:
+            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 US\_ZIP\_5) or a region code.
+        auxiliary_tables:
+            Several auxiliary tables can be used in the analysis. Each
+            custom\_tag used to tag a quasi-identifiers field must appear
+            in exactly one field of one auxiliary table.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig)
+            ),
+        ),
+        DESCRIPTOR=_PRIVACYMETRIC,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Privacy metric to compute for reidentification risk analysis.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrivacyMetric)
+    ),
+)
+_sym_db.RegisterMessage(PrivacyMetric)
+_sym_db.RegisterMessage(PrivacyMetric.NumericalStatsConfig)
+_sym_db.RegisterMessage(PrivacyMetric.CategoricalStatsConfig)
+_sym_db.RegisterMessage(PrivacyMetric.KAnonymityConfig)
+_sym_db.RegisterMessage(PrivacyMetric.LDiversityConfig)
+_sym_db.RegisterMessage(PrivacyMetric.KMapEstimationConfig)
+_sym_db.RegisterMessage(PrivacyMetric.KMapEstimationConfig.TaggedField)
+_sym_db.RegisterMessage(PrivacyMetric.KMapEstimationConfig.AuxiliaryTable)
+_sym_db.RegisterMessage(PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField)
+_sym_db.RegisterMessage(PrivacyMetric.DeltaPresenceEstimationConfig)
+
+AnalyzeDataSourceRiskDetails = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeDataSourceRiskDetails",
+    (_message.Message,),
+    dict(
+        NumericalStatsResult=_reflection.GeneratedProtocolMessageType(
+            "NumericalStatsResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_NUMERICALSTATSRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Result of the numerical stats computation.
+    
+    
+    Attributes:
+        min_value:
+            Minimum value appearing in the column.
+        max_value:
+            Maximum value appearing in the column.
+        quantile_values:
+            List of 99 values that partition the set of field values into
+            100 equal sized buckets.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult)
+            ),
+        ),
+        CategoricalStatsResult=_reflection.GeneratedProtocolMessageType(
+            "CategoricalStatsResult",
+            (_message.Message,),
+            dict(
+                CategoricalStatsHistogramBucket=_reflection.GeneratedProtocolMessageType(
+                    "CategoricalStatsHistogramBucket",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT_CATEGORICALSTATSHISTOGRAMBUCKET,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc="""
+    Attributes:
+          value_frequency_lower_bound: Lower bound on the value frequency of the values in this bucket.
+          value_frequency_upper_bound: Upper bound on the value frequency of the values in this bucket.
+          bucket_size: Total number of values in this bucket.
+          bucket_values: Sample of value frequencies in this bucket. The total number of values returned per bucket is capped at 20.
+          bucket_value_count: Total number of distinct values in this bucket.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket)
+                    ),
+                ),
+                DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_CATEGORICALSTATSRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Result of the categorical stats computation.
+    
+    
+    Attributes:
+        value_frequency_histogram_buckets:
+            Histogram of value frequencies in the column.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult)
+            ),
+        ),
+        KAnonymityResult=_reflection.GeneratedProtocolMessageType(
+            "KAnonymityResult",
+            (_message.Message,),
+            dict(
+                KAnonymityEquivalenceClass=_reflection.GeneratedProtocolMessageType(
+                    "KAnonymityEquivalenceClass",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYEQUIVALENCECLASS,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""The set of columns' values that share the same ldiversity value
+      
+      
+      Attributes:
+          quasi_ids_values:
+          Set of values defining the equivalence class. One value per \
+          quasi-identifier column in the original KAnonymity metric \
+          message. The order is always the same as the original request.
+          equivalence_class_size:
+          Size of the equivalence class, for example number of rows with \
+          the above set of values.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityEquivalenceClass)
+                    ),
+                ),
+                KAnonymityHistogramBucket=_reflection.GeneratedProtocolMessageType(
+                    "KAnonymityHistogramBucket",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT_KANONYMITYHISTOGRAMBUCKET,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc="""
+    Attributes:
+          equivalence_class_size_lower_bound: \
+              Lower bound on the size of the equivalence classes in this \
+              bucket.
+          equivalence_class_size_upper_bound: \
+              Upper bound on the size of the equivalence classes in this \
+              bucket.
+          bucket_size: \
+              Total number of equivalence classes in this bucket.
+          bucket_values: \
+              Sample of equivalence classes in this bucket. The total number \
+              of classes returned per bucket is capped at 20.
+          bucket_value_count: \
+              Total number of distinct equivalence classes in this bucket.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket)
+                    ),
+                ),
+                DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_KANONYMITYRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Result of the k-anonymity computation.
+    
+    
+    Attributes:
+        equivalence_class_histogram_buckets:
+            Histogram of k-anonymity equivalence classes.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult)
+            ),
+        ),
+        LDiversityResult=_reflection.GeneratedProtocolMessageType(
+            "LDiversityResult",
+            (_message.Message,),
+            dict(
+                LDiversityEquivalenceClass=_reflection.GeneratedProtocolMessageType(
+                    "LDiversityEquivalenceClass",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYEQUIVALENCECLASS,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""The set of columns' values that share the same ldiversity value.
+      
+      
+      Attributes:
+          quasi_ids_values:
+              Quasi-identifier values defining the k-anonymity equivalence
+              class. The order is always the same as the original request.
+          equivalence_class_size:
+              Size of the k-anonymity equivalence class.
+          num_distinct_sensitive_values:
+              Number of distinct sensitive values in this equivalence class.
+          top_sensitive_values:
+              Estimated frequencies of top sensitive values.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass)
+                    ),
+                ),
+                LDiversityHistogramBucket=_reflection.GeneratedProtocolMessageType(
+                    "LDiversityHistogramBucket",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT_LDIVERSITYHISTOGRAMBUCKET,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc="""
+    Attributes:
+          sensitive_value_frequency_lower_bound: \
+              Lower bound on the sensitive value frequencies of the \
+              equivalence classes in this bucket.
+          sensitive_value_frequency_upper_bound: \
+              Upper bound on the sensitive value frequencies of the \
+              equivalence classes in this bucket.
+          bucket_size: \
+              Total number of equivalence classes in this bucket.
+          bucket_values: \
+              Sample of equivalence classes in this bucket. The total number \
+              of classes returned per bucket is capped at 20.
+          bucket_value_count: \
+              Total number of distinct equivalence classes in this bucket.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket)
+                    ),
+                ),
+                DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_LDIVERSITYRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Result of the l-diversity computation.
+    
+    
+    Attributes:
+        sensitive_value_frequency_histogram_buckets:
+            Histogram of l-diversity equivalence class sensitive value
+            frequencies.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult)
+            ),
+        ),
+        KMapEstimationResult=_reflection.GeneratedProtocolMessageType(
+            "KMapEstimationResult",
+            (_message.Message,),
+            dict(
+                KMapEstimationQuasiIdValues=_reflection.GeneratedProtocolMessageType(
+                    "KMapEstimationQuasiIdValues",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONQUASIIDVALUES,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""A tuple of values for the quasi-identifier columns.
+      
+      
+      Attributes:
+          quasi_ids_values:
+              The quasi-identifier values.
+          estimated_anonymity:
+              The estimated anonymity for these quasi-identifier values.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues)
+                    ),
+                ),
+                KMapEstimationHistogramBucket=_reflection.GeneratedProtocolMessageType(
+                    "KMapEstimationHistogramBucket",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT_KMAPESTIMATIONHISTOGRAMBUCKET,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""A KMapEstimationHistogramBucket message with the following values:
+      min\_anonymity: 3 max\_anonymity: 5 frequency: 42 means that there are
+      42 records whose quasi-identifier values correspond to 3, 4 or 5 people
+      in the overlying population. An important particular case is when
+      min\_anonymity = max\_anonymity = 1: the frequency field then
+      corresponds to the number of uniquely identifiable records.
+      
+      
+      Attributes:
+          min_anonymity:
+              Always positive.
+          max_anonymity:
+              Always greater than or equal to min\_anonymity.
+          bucket_size:
+              Number of records within these anonymity bounds.
+          bucket_values:
+              Sample of quasi-identifier tuple values in this bucket. The
+              total number of classes returned per bucket is capped at 20.
+          bucket_value_count:
+              Total number of distinct quasi-identifier tuple values in this
+              bucket.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket)
+                    ),
+                ),
+                DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_KMAPESTIMATIONRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Result of the reidentifiability analysis. Note that these results are an
+    estimation, not exact values.
+    
+    
+    Attributes:
+        k_map_estimation_histogram:
+            The intervals [min\_anonymity, max\_anonymity] do not overlap.
+            If a value doesn't correspond to any such interval, the
+            associated frequency is zero. For example, the following
+            records: {min\_anonymity: 1, max\_anonymity: 1, frequency: 17}
+            {min\_anonymity: 2, max\_anonymity: 3, frequency: 42}
+            {min\_anonymity: 5, max\_anonymity: 10, frequency: 99} mean
+            that there are no record with an estimated anonymity of 4, 5,
+            or larger than 10.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult)
+            ),
+        ),
+        DeltaPresenceEstimationResult=_reflection.GeneratedProtocolMessageType(
+            "DeltaPresenceEstimationResult",
+            (_message.Message,),
+            dict(
+                DeltaPresenceEstimationQuasiIdValues=_reflection.GeneratedProtocolMessageType(
+                    "DeltaPresenceEstimationQuasiIdValues",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONQUASIIDVALUES,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""A tuple of values for the quasi-identifier columns.
+      
+      
+      Attributes:
+          quasi_ids_values:
+              The quasi-identifier values.
+          estimated_probability:
+              The estimated probability that a given individual sharing
+              these quasi-identifier values is in the dataset. This value,
+              typically called δ, is the ratio between the number of records
+              in the dataset with these quasi-identifier values, and the
+              total number of individuals (inside *and* outside the dataset)
+              with these quasi-identifier values. For example, if there are
+              15 individuals in the dataset who share the same quasi-
+              identifier values, and an estimated 100 people in the entire
+              population with these values, then δ is 0.15.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues)
+                    ),
+                ),
+                DeltaPresenceEstimationHistogramBucket=_reflection.GeneratedProtocolMessageType(
+                    "DeltaPresenceEstimationHistogramBucket",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT_DELTAPRESENCEESTIMATIONHISTOGRAMBUCKET,
+                        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                        __doc__="""A DeltaPresenceEstimationHistogramBucket message with the following
+      values: min\_probability: 0.1 max\_probability: 0.2 frequency: 42 means
+      that there are 42 records for which δ is in [0.1, 0.2). An important
+      particular case is when min\_probability = max\_probability = 1: then,
+      every individual who shares this quasi-identifier combination is in the
+      dataset.
+      
+      
+      Attributes:
+          min_probability:
+              Between 0 and 1.
+          max_probability:
+              Always greater than or equal to min\_probability.
+          bucket_size:
+              Number of records within these probability bounds.
+          bucket_values:
+              Sample of quasi-identifier tuple values in this bucket. The
+              total number of classes returned per bucket is capped at 20.
+          bucket_value_count:
+              Total number of distinct quasi-identifier tuple values in this
+              bucket.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket)
+                    ),
+                ),
+                DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS_DELTAPRESENCEESTIMATIONRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Result of the δ-presence computation. Note that these results are an
+    estimation, not exact values.
+    
+    
+    Attributes:
+        delta_presence_estimation_histogram:
+            The intervals [min\_probability, max\_probability) do not
+            overlap. If a value doesn't correspond to any such interval,
+            the associated frequency is zero. For example, the following
+            records: {min\_probability: 0, max\_probability: 0.1,
+            frequency: 17} {min\_probability: 0.2, max\_probability: 0.3,
+            frequency: 42} {min\_probability: 0.3, max\_probability: 0.4,
+            frequency: 99} mean that there are no record with an estimated
+            probability in [0.1, 0.2) nor larger or equal to 0.4.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult)
+            ),
+        ),
+        DESCRIPTOR=_ANALYZEDATASOURCERISKDETAILS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Result of a risk analysis operation request.
+  
+  
+  Attributes:
+      requested_privacy_metric:
+          Privacy metric to compute.
+      requested_source_table:
+          Input dataset to compute metrics over.
+      result:
+          Values associated with this metric.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails.NumericalStatsResult)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails.CategoricalStatsResult)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.CategoricalStatsResult.CategoricalStatsHistogramBucket
+)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails.KAnonymityResult)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityEquivalenceClass
+)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.KAnonymityResult.KAnonymityHistogramBucket
+)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails.LDiversityResult)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityEquivalenceClass
+)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.LDiversityResult.LDiversityHistogramBucket
+)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails.KMapEstimationResult)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues
+)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket
+)
+_sym_db.RegisterMessage(AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues
+)
+_sym_db.RegisterMessage(
+    AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket
+)
+
+ValueFrequency = _reflection.GeneratedProtocolMessageType(
+    "ValueFrequency",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUEFREQUENCY,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A value of a field, including its frequency.
+  
+  
+  Attributes:
+      value:
+          A value contained in the field in question.
+      count:
+          How many times the value is contained in the field.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ValueFrequency)
+    ),
+)
+_sym_db.RegisterMessage(ValueFrequency)
+
+Value = _reflection.GeneratedProtocolMessageType(
+    "Value",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Set of primitive values supported by the system. Note that for the
+  purposes of inspection or transformation, the number of bytes considered
+  to comprise a 'Value' is based on its representation as a UTF-8 encoded
+  string. For example, if 'integer\_value' is set to 123456789, the number
+  of bytes would be counted as 9, even though an int64 only holds up to 8
+  bytes of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Value)
+    ),
+)
+_sym_db.RegisterMessage(Value)
+
+QuoteInfo = _reflection.GeneratedProtocolMessageType(
+    "QuoteInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUOTEINFO,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Message for infoType-dependent details parsed from quote.
+  
+  
+  Attributes:
+      parsed_quote:
+          Object representation of the quote.
+      date_time:
+          The date time indicated by the quote.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.QuoteInfo)
+    ),
+)
+_sym_db.RegisterMessage(QuoteInfo)
+
+DateTime = _reflection.GeneratedProtocolMessageType(
+    "DateTime",
+    (_message.Message,),
+    dict(
+        TimeZone=_reflection.GeneratedProtocolMessageType(
+            "TimeZone",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DATETIME_TIMEZONE,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc="""
+    Attributes:
+        offset_minutes: \
+            Set only if the offset can be determined. Positive for time \
+            ahead of UTC. E.g. For "UTC-9", this value is -540.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DateTime.TimeZone)
+            ),
+        ),
+        DESCRIPTOR=_DATETIME,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Message for a date time object. e.g. 2018-01-01, 5th August.
+  
+  
+  Attributes:
+      date:
+          One or more of the following must be set. All fields are
+          optional, but when set must be valid date or time values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DateTime)
+    ),
+)
+_sym_db.RegisterMessage(DateTime)
+_sym_db.RegisterMessage(DateTime.TimeZone)
+
+DeidentifyConfig = _reflection.GeneratedProtocolMessageType(
+    "DeidentifyConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEIDENTIFYCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The configuration that controls how the data will change.
+  
+  
+  Attributes:
+      info_type_transformations:
+          Treat the dataset as free-form text and apply the same free
+          text transformation everywhere.
+      record_transformations:
+          Treat the dataset as structured. Transformations can be
+          applied to specific locations within structured datasets, such
+          as transforming a column within a table.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeidentifyConfig)
+    ),
+)
+_sym_db.RegisterMessage(DeidentifyConfig)
+
+PrimitiveTransformation = _reflection.GeneratedProtocolMessageType(
+    "PrimitiveTransformation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRIMITIVETRANSFORMATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A rule for transforming a value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PrimitiveTransformation)
+    ),
+)
+_sym_db.RegisterMessage(PrimitiveTransformation)
+
+TimePartConfig = _reflection.GeneratedProtocolMessageType(
+    "TimePartConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEPARTCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""For use with ``Date``, ``Timestamp``, and ``TimeOfDay``, extract or
+  preserve a portion of the value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.TimePartConfig)
+    ),
+)
+_sym_db.RegisterMessage(TimePartConfig)
+
+CryptoHashConfig = _reflection.GeneratedProtocolMessageType(
+    "CryptoHashConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRYPTOHASHCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Pseudonymization method that generates surrogates via cryptographic
+  hashing. Uses SHA-256. The key size must be either 32 or 64 bytes.
+  Outputs a base64 encoded representation of the hashed output (for
+  example, L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=). Currently, only
+  string and integer values can be hashed. See
+  https://cloud.google.com/dlp/docs/pseudonymization to learn more.
+  
+  
+  Attributes:
+      crypto_key:
+          The key used by the hash function.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CryptoHashConfig)
+    ),
+)
+_sym_db.RegisterMessage(CryptoHashConfig)
+
+CryptoDeterministicConfig = _reflection.GeneratedProtocolMessageType(
+    "CryptoDeterministicConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRYPTODETERMINISTICCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Pseudonymization method that generates deterministic encryption for the
+  given input. Outputs a base64 encoded representation of the encrypted
+  output. Uses AES-SIV based on the RFC
+  https://tools.ietf.org/html/rfc5297.
+  
+  
+  Attributes:
+      crypto_key:
+          The key used by the encryption function.
+      surrogate_info_type:
+          The custom info type to annotate the surrogate with. 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: ():  For example, if the name of custom
+          info type is 'MY\_TOKEN\_INFO\_TYPE' and the surrogate is
+          'abc', the full replacement value will be:
+          'MY\_TOKEN\_INFO\_TYPE(3):abc'  This annotation identifies the
+          surrogate when inspecting content using the custom info type
+          'Surrogate'. This facilitates reversal of the surrogate when
+          it occurs in free 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  -
+          reverse a surrogate that does not correspond to an actual
+          identifier -  be unable to parse the surrogate and result in
+          an error  Therefore, choose your custom info type name
+          carefully after considering what your data looks like. One way
+          to select a name that has a high chance of yielding reliable
+          detection is to include one or more unicode characters 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
+      context:
+          Optional. 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 validated
+          against the value used during encryption. If a context was
+          provided during encryption, same context must be provided
+          during decryption as well.  If the context is not set,
+          plaintext would be used as is for encryption. If the context
+          is set but:  1. there is no record present when transforming a
+          given value or 2. the field is not present when transforming a
+          given value,  plaintext would be used as is for encryption.
+          Note that case (1) is expected when an
+          ``InfoTypeTransformation`` is applied to both structured and
+          non-structured ``ContentItem``\ s.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CryptoDeterministicConfig)
+    ),
+)
+_sym_db.RegisterMessage(CryptoDeterministicConfig)
+
+ReplaceValueConfig = _reflection.GeneratedProtocolMessageType(
+    "ReplaceValueConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPLACEVALUECONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Replace each input value with a given ``Value``.
+  
+  
+  Attributes:
+      new_value:
+          Value to replace it with.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ReplaceValueConfig)
+    ),
+)
+_sym_db.RegisterMessage(ReplaceValueConfig)
+
+ReplaceWithInfoTypeConfig = _reflection.GeneratedProtocolMessageType(
+    "ReplaceWithInfoTypeConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPLACEWITHINFOTYPECONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Replace each matching finding with the name of the info\_type.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ReplaceWithInfoTypeConfig)
+    ),
+)
+_sym_db.RegisterMessage(ReplaceWithInfoTypeConfig)
+
+RedactConfig = _reflection.GeneratedProtocolMessageType(
+    "RedactConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REDACTCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""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
+  '.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RedactConfig)
+    ),
+)
+_sym_db.RegisterMessage(RedactConfig)
+
+CharsToIgnore = _reflection.GeneratedProtocolMessageType(
+    "CharsToIgnore",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHARSTOIGNORE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Characters to skip when doing deidentification of a value. These will be
+  left alone and skipped.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CharsToIgnore)
+    ),
+)
+_sym_db.RegisterMessage(CharsToIgnore)
+
+CharacterMaskConfig = _reflection.GeneratedProtocolMessageType(
+    "CharacterMaskConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CHARACTERMASKCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Partially mask a string by replacing a given number of characters with a
+  fixed character. Masking can start from the beginning or end of the
+  string. This can be used on data of any type (numbers, longs, and so on)
+  and when de-identifying structured data we'll attempt to preserve the
+  original data's type. (This allows you to take a long like 123 and
+  modify it to a string like \*\*3.
+  
+  
+  Attributes:
+      masking_character:
+          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.
+      number_to_mask:
+          Number of characters to mask. If not set, all matching chars
+          will be masked. Skipped characters do not count towards this
+          tally.
+      reverse_order:
+          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*\ \*\*
+      characters_to_ignore:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CharacterMaskConfig)
+    ),
+)
+_sym_db.RegisterMessage(CharacterMaskConfig)
+
+FixedSizeBucketingConfig = _reflection.GeneratedProtocolMessageType(
+    "FixedSizeBucketingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FIXEDSIZEBUCKETINGCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Buckets values based on fixed size ranges. The Bucketing transformation
+  can provide all of this functionality, but requires more configuration.
+  This message is provided as a convenience to 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 all values that are within this
+  bucket will be replaced with "10-20".
+  
+  This can be used on data of type: double, long.
+  
+  If the bound Value type differs from the type of data being transformed,
+  we will first attempt converting the type of the data to be transformed
+  to match the type of the bound before comparing.
+  
+  See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more.
+  
+  
+  Attributes:
+      lower_bound:
+          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].
+      upper_bound:
+          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].
+      bucket_size:
+          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].
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.FixedSizeBucketingConfig)
+    ),
+)
+_sym_db.RegisterMessage(FixedSizeBucketingConfig)
+
+BucketingConfig = _reflection.GeneratedProtocolMessageType(
+    "BucketingConfig",
+    (_message.Message,),
+    dict(
+        Bucket=_reflection.GeneratedProtocolMessageType(
+            "Bucket",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BUCKETINGCONFIG_BUCKET,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Bucket is represented as a range, along with replacement values.
+    
+    
+    Attributes:
+        min:
+            Lower bound of the range, inclusive. Type should be the same
+            as max if used.
+        max:
+            Upper bound of the range, exclusive; type must match min.
+        replacement_value:
+            Replacement value for this bucket. If not provided the default
+            behavior will be to hyphenate the min-max range.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BucketingConfig.Bucket)
+            ),
+        ),
+        DESCRIPTOR=_BUCKETINGCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Generalization function that buckets values based on ranges. The ranges
+  and replacement values are dynamically provided by the user for custom
+  behavior, such as 1-30 -> LOW 31-65 -> MEDIUM 66-100 -> HIGH This can be
+  used on data of type: number, long, string, timestamp. If the bound
+  ``Value`` type differs from the type of data being transformed, we will
+  first attempt converting the type of the data to be transformed to match
+  the type of the bound before comparing. See
+  https://cloud.google.com/dlp/docs/concepts-bucketing to learn more.
+  
+  
+  Attributes:
+      buckets:
+          Set of buckets. Ranges must be non-overlapping.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BucketingConfig)
+    ),
+)
+_sym_db.RegisterMessage(BucketingConfig)
+_sym_db.RegisterMessage(BucketingConfig.Bucket)
+
+CryptoReplaceFfxFpeConfig = _reflection.GeneratedProtocolMessageType(
+    "CryptoReplaceFfxFpeConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRYPTOREPLACEFFXFPECONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Replaces an identifier with a surrogate using Format Preserving
+  Encryption (FPE) with the FFX mode of operation; however when used in
+  the ``ReidentifyContent`` API method, it serves the opposite function by
+  reversing the surrogate back into the original identifier. The
+  identifier must be encoded as ASCII. For a given crypto key and context,
+  the same identifier will be replaced with the same surrogate.
+  Identifiers must be at least two characters long. In the case that the
+  identifier is the empty string, it will be skipped. See
+  https://cloud.google.com/dlp/docs/pseudonymization to learn more.
+  
+  Note: We recommend using CryptoDeterministicConfig for all use cases
+  which do not require preserving the input alphabet space and size, plus
+  warrant referential integrity.
+  
+  
+  Attributes:
+      crypto_key:
+          The key used by the encryption algorithm. [required]
+      context:
+          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 the context is not set, a default tweak
+          will be used.  If the context is set but:  1. there is no
+          record present when transforming a given value or 2. the field
+          is not present when transforming a given value,  a default
+          tweak will be used.  Note that case (1) is expected when an
+          ``InfoTypeTransformation`` is applied to both structured and
+          non-structured ``ContentItem``\ s. Currently, the referenced
+          field may be of value type integer or string.  The tweak is
+          constructed as a sequence of bytes in big endian byte order
+          such that:  -  a 64 bit integer is encoded followed by a
+          single byte of value 1 -  a string is encoded in UTF-8 format
+          followed by a single byte of    value 2
+      custom_alphabet:
+          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]. This must be encoded as ASCII. The order of
+          characters does not matter.
+      radix:
+          The native way to select the alphabet. Must be in the range
+          [2, 62].
+      surrogate_info_type:
+          The custom infoType to annotate the surrogate with. This
+          annotation will be applied to the surrogate by prefixing it
+          with the name of the custom infoType followed by the number of
+          characters comprising the surrogate. The following scheme
+          defines the format:
+          info\_type\_name(surrogate\_character\_count):surrogate  For
+          example, if the name of custom infoType is
+          'MY\_TOKEN\_INFO\_TYPE' and the surrogate is 'abc', the full
+          replacement value will be: 'MY\_TOKEN\_INFO\_TYPE(3):abc'
+          This annotation identifies the surrogate when inspecting
+          content using the custom infoType ```SurrogateType``
+          </dlp/docs/reference/rest/v2/InspectConfig#surrogatetype>`__.
+          This facilitates reversal of the surrogate when it occurs in
+          free text.  In order for inspection to work properly, the name
+          of this infoType must not occur naturally anywhere in your
+          data; otherwise, inspection may find a surrogate that does not
+          correspond to an actual identifier. Therefore, choose your
+          custom infoType name carefully after considering what your
+          data looks like. One way to select a name that has a high
+          chance of yielding reliable detection is to include one or
+          more unicode characters 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
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CryptoReplaceFfxFpeConfig)
+    ),
+)
+_sym_db.RegisterMessage(CryptoReplaceFfxFpeConfig)
+
+CryptoKey = _reflection.GeneratedProtocolMessageType(
+    "CryptoKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRYPTOKEY,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""This is a data encryption key (DEK) (as opposed to a key encryption key
+  (KEK) stored by KMS). When using KMS to wrap/unwrap DEKs, be sure to set
+  an appropriate IAM policy on the KMS CryptoKey (KEK) to ensure an
+  attacker cannot unwrap the data crypto key.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CryptoKey)
+    ),
+)
+_sym_db.RegisterMessage(CryptoKey)
+
+TransientCryptoKey = _reflection.GeneratedProtocolMessageType(
+    "TransientCryptoKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSIENTCRYPTOKEY,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Use this to have a random data crypto key generated. It will be
+  discarded after the request finishes.
+  
+  
+  Attributes:
+      name:
+          Name of the key. [required] 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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.TransientCryptoKey)
+    ),
+)
+_sym_db.RegisterMessage(TransientCryptoKey)
+
+UnwrappedCryptoKey = _reflection.GeneratedProtocolMessageType(
+    "UnwrappedCryptoKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UNWRAPPEDCRYPTOKEY,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Using raw keys is prone to security risks due to accidentally leaking
+  the key. Choose another type of key if possible.
+  
+  
+  Attributes:
+      key:
+          A 128/192/256 bit key. [required]
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.UnwrappedCryptoKey)
+    ),
+)
+_sym_db.RegisterMessage(UnwrappedCryptoKey)
+
+KmsWrappedCryptoKey = _reflection.GeneratedProtocolMessageType(
+    "KmsWrappedCryptoKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KMSWRAPPEDCRYPTOKEY,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Include to use an existing data crypto key wrapped by KMS. The wrapped
+  key must be a 128/192/256 bit key. Authorization requires the following
+  IAM permissions when sending a request to perform a crypto
+  transformation using a kms-wrapped crypto key: dlp.kms.encrypt
+  
+  
+  Attributes:
+      wrapped_key:
+          The wrapped data crypto key. [required]
+      crypto_key_name:
+          The resource name of the KMS CryptoKey to use for unwrapping.
+          [required]
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.KmsWrappedCryptoKey)
+    ),
+)
+_sym_db.RegisterMessage(KmsWrappedCryptoKey)
+
+DateShiftConfig = _reflection.GeneratedProtocolMessageType(
+    "DateShiftConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATESHIFTCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      upper_bound_days:
+          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]
+      lower_bound_days:
+          For example, -5 means shift date to at most 5 days back in the
+          past. [Required]
+      context:
+          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 given context.
+      method:
+          Method for calculating shift that takes context into
+          consideration. If set, must also set context. Can only be
+          applied to table items.
+      crypto_key:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DateShiftConfig)
+    ),
+)
+_sym_db.RegisterMessage(DateShiftConfig)
+
+InfoTypeTransformations = _reflection.GeneratedProtocolMessageType(
+    "InfoTypeTransformations",
+    (_message.Message,),
+    dict(
+        InfoTypeTransformation=_reflection.GeneratedProtocolMessageType(
+            "InfoTypeTransformation",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INFOTYPETRANSFORMATIONS_INFOTYPETRANSFORMATION,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""A transformation to apply to text that is identified as a specific
+    info\_type.
+    
+    
+    Attributes:
+        info_types:
+            InfoTypes to apply the transformation to. An empty list will
+            cause this transformation to apply to all findings that
+            correspond to infoTypes that were requested in
+            ``InspectConfig``.
+        primitive_transformation:
+            Primitive transformation to apply to the infoType. [required]
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InfoTypeTransformations.InfoTypeTransformation)
+            ),
+        ),
+        DESCRIPTOR=_INFOTYPETRANSFORMATIONS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A type of transformation that will scan unstructured text and apply
+  various ``PrimitiveTransformation``\ s to each finding, where the
+  transformation is applied to only values that were identified as a
+  specific info\_type.
+  
+  
+  Attributes:
+      transformations:
+          Transformation for each infoType. Cannot specify more than one
+          for a given infoType. [required]
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InfoTypeTransformations)
+    ),
+)
+_sym_db.RegisterMessage(InfoTypeTransformations)
+_sym_db.RegisterMessage(InfoTypeTransformations.InfoTypeTransformation)
+
+FieldTransformation = _reflection.GeneratedProtocolMessageType(
+    "FieldTransformation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FIELDTRANSFORMATION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The transformation to apply to the field.
+  
+  
+  Attributes:
+      fields:
+          Input field(s) to apply the transformation to. [required]
+      condition:
+          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]  Example Use Cases:  -  Apply a
+          different bucket transformation to an age column if the zip
+          code column for the same record is within a specific range. -
+          Redact a field if the date of birth field is greater than 85.
+      transformation:
+          Transformation to apply. [required]
+      primitive_transformation:
+          Apply the transformation to the entire field.
+      info_type_transformations:
+          Treat the contents of the field as free text, and selectively
+          transform content that matches an ``InfoType``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.FieldTransformation)
+    ),
+)
+_sym_db.RegisterMessage(FieldTransformation)
+
+RecordTransformations = _reflection.GeneratedProtocolMessageType(
+    "RecordTransformations",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECORDTRANSFORMATIONS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A type of transformation that is applied over structured data such as a
+  table.
+  
+  
+  Attributes:
+      field_transformations:
+          Transform the record by applying various field
+          transformations.
+      record_suppressions:
+          Configuration defining which records get suppressed entirely.
+          Records that match any suppression rule are omitted from the
+          output [optional].
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordTransformations)
+    ),
+)
+_sym_db.RegisterMessage(RecordTransformations)
+
+RecordSuppression = _reflection.GeneratedProtocolMessageType(
+    "RecordSuppression",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECORDSUPPRESSION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Configuration to suppress records whose suppression conditions evaluate
+  to true.
+  
+  
+  Attributes:
+      condition:
+          A condition that when it evaluates to true will result in the
+          record being evaluated to be suppressed from the transformed
+          content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordSuppression)
+    ),
+)
+_sym_db.RegisterMessage(RecordSuppression)
+
+RecordCondition = _reflection.GeneratedProtocolMessageType(
+    "RecordCondition",
+    (_message.Message,),
+    dict(
+        Condition=_reflection.GeneratedProtocolMessageType(
+            "Condition",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_RECORDCONDITION_CONDITION,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2"
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordCondition.Condition)
+            ),
+        ),
+        Conditions=_reflection.GeneratedProtocolMessageType(
+            "Conditions",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_RECORDCONDITION_CONDITIONS,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""A collection of conditions.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordCondition.Conditions)
+            ),
+        ),
+        Expressions=_reflection.GeneratedProtocolMessageType(
+            "Expressions",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_RECORDCONDITION_EXPRESSIONS,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""An expression, consisting or an operator and conditions.
+    
+    
+    Attributes:
+        logical_operator:
+            The operator to apply to the result of conditions. Default and
+            currently only supported value is ``AND``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordCondition.Expressions)
+            ),
+        ),
+        DESCRIPTOR=_RECORDCONDITION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The field type of ``value`` and ``field`` do not need to match to be
+  considered equal, but not all comparisons are possible. EQUAL\_TO and
+  NOT\_EQUAL\_TO attempt to compare even with incompatible types, but all
+  other comparisons are invalid with incompatible types. A ``value`` of
+  type:
+  
+  -  ``string`` can be compared against all other types
+  -  ``boolean`` can only be compared against other booleans
+  -  ``integer`` can be compared against doubles or a string if the string
+     value can be parsed as an integer.
+  -  ``double`` can be compared against integers or a string if the string
+     can be parsed as a double.
+  -  ``Timestamp`` can be compared against strings in RFC 3339 date string
+     format.
+  -  ``TimeOfDay`` can be compared against timestamps and strings in the
+     format of 'HH:mm:ss'.
+  
+  If we fail to compare do to type mismatch, a warning will be given and
+  the condition will evaluate to false.
+  
+  
+  Attributes:
+      field:
+          Field within the record this condition is evaluated against.
+          [required]
+      operator:
+          Operator used to compare the field or infoType to the value.
+          [required]
+      value:
+          Value to compare against. [Required, except for ``EXISTS``
+          tests.]
+      expressions:
+          An expression.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordCondition)
+    ),
+)
+_sym_db.RegisterMessage(RecordCondition)
+_sym_db.RegisterMessage(RecordCondition.Condition)
+_sym_db.RegisterMessage(RecordCondition.Conditions)
+_sym_db.RegisterMessage(RecordCondition.Expressions)
+
+TransformationOverview = _reflection.GeneratedProtocolMessageType(
+    "TransformationOverview",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSFORMATIONOVERVIEW,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Overview of the modifications that occurred.
+  
+  
+  Attributes:
+      transformed_bytes:
+          Total size in bytes that were transformed in some way.
+      transformation_summaries:
+          Transformations applied to the dataset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.TransformationOverview)
+    ),
+)
+_sym_db.RegisterMessage(TransformationOverview)
+
+TransformationSummary = _reflection.GeneratedProtocolMessageType(
+    "TransformationSummary",
+    (_message.Message,),
+    dict(
+        SummaryResult=_reflection.GeneratedProtocolMessageType(
+            "SummaryResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSFORMATIONSUMMARY_SUMMARYRESULT,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""A collection that informs the user the number of times a particular
+    ``TransformationResultCode`` and error details occurred.
+    
+    
+    Attributes:
+        details:
+            A place for warnings or errors to show up if a transformation
+            didn't work as expected.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.TransformationSummary.SummaryResult)
+            ),
+        ),
+        DESCRIPTOR=_TRANSFORMATIONSUMMARY,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Summary of a single transformation. Only one of 'transformation',
+  'field\_transformation', or 'record\_suppress' will be set.
+  
+  
+  Attributes:
+      info_type:
+          Set if the transformation was limited to a specific InfoType.
+      field:
+          Set if the transformation was limited to a specific FieldId.
+      transformation:
+          The specific transformation these stats apply to.
+      field_transformations:
+          The field transformation that was applied. If multiple field
+          transformations are requested for a single field, this list
+          will contain all of them; otherwise, only one is supplied.
+      record_suppress:
+          The specific suppression option these stats apply to.
+      transformed_bytes:
+          Total size in bytes that were transformed in some way.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.TransformationSummary)
+    ),
+)
+_sym_db.RegisterMessage(TransformationSummary)
+_sym_db.RegisterMessage(TransformationSummary.SummaryResult)
+
+Schedule = _reflection.GeneratedProtocolMessageType(
+    "Schedule",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCHEDULE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Schedule for triggeredJobs.
+  
+  
+  Attributes:
+      recurrence_period_duration:
+          With this option a job is started a regular periodic basis.
+          For example: every day (86400 seconds).  A scheduled start
+          time will be skipped if the previous execution has not ended
+          when its scheduled time occurs.  This value must be set to a
+          time duration greater than or equal to 1 day and can be no
+          longer than 60 days.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Schedule)
+    ),
+)
+_sym_db.RegisterMessage(Schedule)
+
+InspectTemplate = _reflection.GeneratedProtocolMessageType(
+    "InspectTemplate",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTTEMPLATE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The template name. Output only.  The template will have one of
+          the following formats:
+          ``projects/PROJECT_ID/inspectTemplates/TEMPLATE_ID`` OR
+          ``organizations/ORGANIZATION_ID/inspectTemplates/TEMPLATE_ID``
+      display_name:
+          Display name (max 256 chars).
+      description:
+          Short description (max 256 chars).
+      create_time:
+          The creation timestamp of a inspectTemplate, output only
+          field.
+      update_time:
+          The last update timestamp of a inspectTemplate, output only
+          field.
+      inspect_config:
+          The core content of the template. Configuration of the
+          scanning process.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectTemplate)
+    ),
+)
+_sym_db.RegisterMessage(InspectTemplate)
+
+DeidentifyTemplate = _reflection.GeneratedProtocolMessageType(
+    "DeidentifyTemplate",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEIDENTIFYTEMPLATE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The DeidentifyTemplates contains instructions on how to deidentify
+  content. See https://cloud.google.com/dlp/docs/concepts-templates to
+  learn more.
+  
+  
+  Attributes:
+      name:
+          The template name. Output only.  The template will have one of
+          the following formats:
+          ``projects/PROJECT_ID/deidentifyTemplates/TEMPLATE_ID`` OR ``o
+          rganizations/ORGANIZATION_ID/deidentifyTemplates/TEMPLATE_ID``
+      display_name:
+          Display name (max 256 chars).
+      description:
+          Short description (max 256 chars).
+      create_time:
+          The creation timestamp of a inspectTemplate, output only
+          field.
+      update_time:
+          The last update timestamp of a inspectTemplate, output only
+          field.
+      deidentify_config:
+          ///////////// // The core content of the template // ///////////////
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeidentifyTemplate)
+    ),
+)
+_sym_db.RegisterMessage(DeidentifyTemplate)
+
+Error = _reflection.GeneratedProtocolMessageType(
+    "Error",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ERROR,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Details information about an error encountered during job execution or
+  the results of an unsuccessful activation of the JobTrigger. Output only
+  field.
+  
+  
+  Attributes:
+      timestamps:
+          The times the error occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Error)
+    ),
+)
+_sym_db.RegisterMessage(Error)
+
+JobTrigger = _reflection.GeneratedProtocolMessageType(
+    "JobTrigger",
+    (_message.Message,),
+    dict(
+        Trigger=_reflection.GeneratedProtocolMessageType(
+            "Trigger",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOBTRIGGER_TRIGGER,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2"
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.JobTrigger.Trigger)
+            ),
+        ),
+        DESCRIPTOR=_JOBTRIGGER,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""What event needs to occur for a new job to be started.
+  
+  
+  Attributes:
+      schedule:
+          Create a job on a repeating basis based on the elapse of time.
+      name:
+          Unique resource name for the triggeredJob, assigned by the
+          service when the triggeredJob is created, for example
+          ``projects/dlp-test-project/triggeredJobs/53234423``.
+      display_name:
+          Display name (max 100 chars)
+      description:
+          User provided description (max 256 chars)
+      job:
+          The configuration details for the specific type of job to run.
+      triggers:
+          A list of triggers which will be OR'ed together. Only one in
+          the list needs to trigger for a job to be started. The list
+          may contain only a single Schedule trigger and must have at
+          least one object.
+      errors:
+          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.
+      create_time:
+          The creation timestamp of a triggeredJob, output only field.
+      update_time:
+          The last update timestamp of a triggeredJob, output only
+          field.
+      last_run_time:
+          The timestamp of the last time this trigger executed, output
+          only field.
+      status:
+          A status for this trigger. [required]
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.JobTrigger)
+    ),
+)
+_sym_db.RegisterMessage(JobTrigger)
+_sym_db.RegisterMessage(JobTrigger.Trigger)
+
+Action = _reflection.GeneratedProtocolMessageType(
+    "Action",
+    (_message.Message,),
+    dict(
+        SaveFindings=_reflection.GeneratedProtocolMessageType(
+            "SaveFindings",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ACTION_SAVEFINDINGS,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""If set, the detailed findings will be persisted to the specified
+    OutputStorageConfig. Only a single instance of this action can be
+    specified. Compatible with: Inspect, Risk
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Action.SaveFindings)
+            ),
+        ),
+        PublishToPubSub=_reflection.GeneratedProtocolMessageType(
+            "PublishToPubSub",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ACTION_PUBLISHTOPUBSUB,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Publish a message into given Pub/Sub topic when DlpJob has completed.
+    The message contains a single field, ``DlpJobName``, which is equal to
+    the finished job's
+    ```DlpJob.name`` </dlp/docs/reference/rest/v2/projects.dlpJobs#DlpJob>`__.
+    Compatible with: Inspect, Risk
+    
+    
+    Attributes:
+        topic:
+            Cloud Pub/Sub topic to send notifications to. The topic must
+            have given publishing access rights to the DLP API service
+            account executing the long running DlpJob sending the
+            notifications. Format is projects/{project}/topics/{topic}.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Action.PublishToPubSub)
+            ),
+        ),
+        PublishSummaryToCscc=_reflection.GeneratedProtocolMessageType(
+            "PublishSummaryToCscc",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ACTION_PUBLISHSUMMARYTOCSCC,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Publish the result summary of a DlpJob to the Cloud Security Command
+    Center (CSCC Alpha). This action is only available for projects which
+    are parts of an organization and whitelisted for the alpha Cloud
+    Security Command Center. The action will publish count of finding
+    instances and their info types. The summary of findings will be
+    persisted in CSCC and are governed by CSCC service-specific policy, see
+    https://cloud.google.com/terms/service-terms Only a single instance of
+    this action can be specified. Compatible with: Inspect
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Action.PublishSummaryToCscc)
+            ),
+        ),
+        PublishFindingsToCloudDataCatalog=_reflection.GeneratedProtocolMessageType(
+            "PublishFindingsToCloudDataCatalog",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ACTION_PUBLISHFINDINGSTOCLOUDDATACATALOG,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Publish findings of a DlpJob to Cloud Data Catalog. Labels summarizing
+    the results of the DlpJob will be applied to the entry for the resource
+    scanned in Cloud Data Catalog. Any labels previously written by another
+    DlpJob will be deleted. InfoType naming patterns are strictly enforced
+    when using this feature. Note that the findings will be persisted in
+    Cloud Data Catalog storage and are governed by Data Catalog
+    service-specific policy, see
+    https://cloud.google.com/terms/service-terms Only a single instance of
+    this action can be specified and only allowed if all resources being
+    scanned are BigQuery tables. Compatible with: Inspect
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Action.PublishFindingsToCloudDataCatalog)
+            ),
+        ),
+        JobNotificationEmails=_reflection.GeneratedProtocolMessageType(
+            "JobNotificationEmails",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ACTION_JOBNOTIFICATIONEMAILS,
+                __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+                __doc__="""Enable email notification to project owners and editors on jobs's
+    completion/failure.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Action.JobNotificationEmails)
+            ),
+        ),
+        DESCRIPTOR=_ACTION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""A task to execute on the completion of a job. See
+  https://cloud.google.com/dlp/docs/concepts-actions to learn more.
+  
+  
+  Attributes:
+      save_findings:
+          Save resulting findings in a provided location.
+      pub_sub:
+          Publish a notification to a pubsub topic.
+      publish_summary_to_cscc:
+          Publish summary to Cloud Security Command Center (Alpha).
+      publish_findings_to_cloud_data_catalog:
+          Publish findings to Cloud Datahub.
+      job_notification_emails:
+          Enable email notification to project owners and editors on
+          job's completion/failure.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Action)
+    ),
+)
+_sym_db.RegisterMessage(Action)
+_sym_db.RegisterMessage(Action.SaveFindings)
+_sym_db.RegisterMessage(Action.PublishToPubSub)
+_sym_db.RegisterMessage(Action.PublishSummaryToCscc)
+_sym_db.RegisterMessage(Action.PublishFindingsToCloudDataCatalog)
+_sym_db.RegisterMessage(Action.JobNotificationEmails)
+
+CreateInspectTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateInspectTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSPECTTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for CreateInspectTemplate.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id
+          or organizations/my-org-id.
+      inspect_template:
+          The InspectTemplate to create.
+      template_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CreateInspectTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateInspectTemplateRequest)
+
+UpdateInspectTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateInspectTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINSPECTTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for UpdateInspectTemplate.
+  
+  
+  Attributes:
+      name:
+          Resource name of organization and inspectTemplate to be
+          updated, for example
+          ``organizations/433245324/inspectTemplates/432452342`` or
+          projects/project-id/inspectTemplates/432452342.
+      inspect_template:
+          New InspectTemplate value.
+      update_mask:
+          Mask to control which fields get updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.UpdateInspectTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateInspectTemplateRequest)
+
+GetInspectTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInspectTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSPECTTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for GetInspectTemplate.
+  
+  
+  Attributes:
+      name:
+          Resource name of the organization and inspectTemplate to be
+          read, for example
+          ``organizations/433245324/inspectTemplates/432452342`` or
+          projects/project-id/inspectTemplates/432452342.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.GetInspectTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInspectTemplateRequest)
+
+ListInspectTemplatesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInspectTemplatesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSPECTTEMPLATESREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for ListInspectTemplates.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id
+          or organizations/my-org-id.
+      page_token:
+          Optional page token to continue retrieval. Comes from previous
+          call to ``ListInspectTemplates``.
+      page_size:
+          Optional size of the page, can be limited by server. If zero
+          server returns a page of max size 100.
+      order_by:
+          Optional 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.  Example: ``name asc,update_time,
+          create_time desc``  Supported fields are:  -  ``create_time``:
+          corresponds to time the template was created. -
+          ``update_time``: corresponds to time the template was last
+          updated. -  ``name``: corresponds to template's name. -
+          ``display_name``: corresponds to template's display name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListInspectTemplatesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInspectTemplatesRequest)
+
+ListInspectTemplatesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInspectTemplatesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSPECTTEMPLATESRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Response message for ListInspectTemplates.
+  
+  
+  Attributes:
+      inspect_templates:
+          List of inspectTemplates, up to page\_size in
+          ListInspectTemplatesRequest.
+      next_page_token:
+          If the next page is available then the next page token to be
+          used in following ListInspectTemplates request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListInspectTemplatesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInspectTemplatesResponse)
+
+DeleteInspectTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteInspectTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINSPECTTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for DeleteInspectTemplate.
+  
+  
+  Attributes:
+      name:
+          Resource name of the organization and inspectTemplate to be
+          deleted, for example
+          ``organizations/433245324/inspectTemplates/432452342`` or
+          projects/project-id/inspectTemplates/432452342.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeleteInspectTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteInspectTemplateRequest)
+
+CreateJobTriggerRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateJobTriggerRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEJOBTRIGGERREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for CreateJobTrigger.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id.
+      job_trigger:
+          The JobTrigger to create.
+      trigger_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CreateJobTriggerRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateJobTriggerRequest)
+
+ActivateJobTriggerRequest = _reflection.GeneratedProtocolMessageType(
+    "ActivateJobTriggerRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACTIVATEJOBTRIGGERREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for ActivateJobTrigger.
+  
+  
+  Attributes:
+      name:
+          Resource name of the trigger to activate, for example
+          ``projects/dlp-test-project/jobTriggers/53234423``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ActivateJobTriggerRequest)
+    ),
+)
+_sym_db.RegisterMessage(ActivateJobTriggerRequest)
+
+UpdateJobTriggerRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateJobTriggerRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEJOBTRIGGERREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for UpdateJobTrigger.
+  
+  
+  Attributes:
+      name:
+          Resource name of the project and the triggeredJob, for example
+          ``projects/dlp-test-project/jobTriggers/53234423``.
+      job_trigger:
+          New JobTrigger value.
+      update_mask:
+          Mask to control which fields get updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.UpdateJobTriggerRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateJobTriggerRequest)
+
+GetJobTriggerRequest = _reflection.GeneratedProtocolMessageType(
+    "GetJobTriggerRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETJOBTRIGGERREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for GetJobTrigger.
+  
+  
+  Attributes:
+      name:
+          Resource name of the project and the triggeredJob, for example
+          ``projects/dlp-test-project/jobTriggers/53234423``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.GetJobTriggerRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetJobTriggerRequest)
+
+CreateDlpJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDlpJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDLPJOBREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for CreateDlpJobRequest. Used to initiate long running
+  jobs such as calculating risk metrics or inspecting Google Cloud
+  Storage.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id.
+      job:
+          The configuration details for the specific type of job to run.
+      job_id:
+          The job 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CreateDlpJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDlpJobRequest)
+
+ListJobTriggersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListJobTriggersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBTRIGGERSREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for ListJobTriggers.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example ``projects/my-project-
+          id``.
+      page_token:
+          Optional page token to continue retrieval. Comes from previous
+          call to ListJobTriggers. ``order_by`` field must not change
+          for subsequent calls.
+      page_size:
+          Optional size of the page, can be limited by a server.
+      order_by:
+          Optional 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.  Example: ``name
+          asc,update_time, create_time desc``  Supported fields are:  -
+          ``create_time``: corresponds to time the JobTrigger was
+          created. -  ``update_time``: corresponds to time the
+          JobTrigger was last updated. -  ``last_run_time``: corresponds
+          to the last time the JobTrigger ran. -  ``name``: corresponds
+          to JobTrigger's name. -  ``display_name``: corresponds to
+          JobTrigger's display name. -  ``status``: corresponds to
+          JobTrigger's status.
+      filter:
+          Optional. 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 ``<field> <operator>
+          <value>``. -  Supported fields/values for inspect jobs:     -
+          ``status`` - HEALTHY\|PAUSED\|CANCELLED    -
+          ``inspected_storage`` - DATASTORE\|CLOUD\_STORAGE\|BIGQUERY
+          -  'last\_run\_time\` - RFC 3339 formatted timestamp,
+          surrounded by       quotation marks. Nanoseconds are ignored.
+          -  'error\_count' - Number of errors that have occurred while
+          running.  -  The operator must be ``=`` or ``!=`` for status
+          and    inspected\_storage.  Examples:  -  inspected\_storage =
+          cloud\_storage AND status = HEALTHY -  inspected\_storage =
+          cloud\_storage OR inspected\_storage = bigquery -
+          inspected\_storage = cloud\_storage AND (state = PAUSED OR
+          state =    HEALTHY) -  last\_run\_time >
+          "2017-12-12T00:00:00+00:00"  The length of this field should
+          be no more than 500 characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListJobTriggersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListJobTriggersRequest)
+
+ListJobTriggersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListJobTriggersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBTRIGGERSRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Response message for ListJobTriggers.
+  
+  
+  Attributes:
+      job_triggers:
+          List of triggeredJobs, up to page\_size in
+          ListJobTriggersRequest.
+      next_page_token:
+          If the next page is available then the next page token to be
+          used in following ListJobTriggers request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListJobTriggersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListJobTriggersResponse)
+
+DeleteJobTriggerRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteJobTriggerRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEJOBTRIGGERREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for DeleteJobTrigger.
+  
+  
+  Attributes:
+      name:
+          Resource name of the project and the triggeredJob, for example
+          ``projects/dlp-test-project/jobTriggers/53234423``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeleteJobTriggerRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteJobTriggerRequest)
+
+InspectJobConfig = _reflection.GeneratedProtocolMessageType(
+    "InspectJobConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSPECTJOBCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc="""
+    Attributes:
+      storage_config: \
+          The data to scan.
+      inspect_config: \
+          How and what to scan for.
+      inspect_template_name: \
+          If provided, will be used as the default for all values in \
+          InspectConfig. ``inspect_config`` will be merged into the \
+          values persisted as part of the template. \
+      actions: \
+          Actions to execute at the completion of the job. \
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InspectJobConfig)
+    ),
+)
+_sym_db.RegisterMessage(InspectJobConfig)
+
+DlpJob = _reflection.GeneratedProtocolMessageType(
+    "DlpJob",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DLPJOB,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Combines all of the information about a DLP job.
+  
+  
+  Attributes:
+      name:
+          The server-assigned name.
+      type:
+          The type of job.
+      state:
+          State of a job.
+      risk_details:
+          Results from analyzing risk of a data source.
+      inspect_details:
+          Results from inspecting a data source.
+      create_time:
+          Time when the job was created.
+      start_time:
+          Time when the job started.
+      end_time:
+          Time when the job finished.
+      job_trigger_name:
+          If created by a job trigger, the resource name of the trigger
+          that instantiated the job.
+      errors:
+          A stream of errors encountered running the job.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DlpJob)
+    ),
+)
+_sym_db.RegisterMessage(DlpJob)
+
+GetDlpJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDlpJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDLPJOBREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The request message for [DlpJobs.GetDlpJob][].
+  
+  
+  Attributes:
+      name:
+          The name of the DlpJob resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.GetDlpJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDlpJobRequest)
+
+ListDlpJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDlpJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDLPJOBSREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The request message for listing DLP jobs.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id.
+      filter:
+          Optional. 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 ``<field> <operator>
+          <value>``. -  Supported fields/values for inspect jobs:     -
+          ``state`` - PENDING\|RUNNING\|CANCELED\|FINISHED\|FAILED    -
+          ``inspected_storage`` - DATASTORE\|CLOUD\_STORAGE\|BIGQUERY
+          -  ``trigger_name`` - The resource name of the trigger that
+          created       job.    -  'end\_time\` - Corresponds to time
+          the job finished.    -  'start\_time\` - Corresponds to time
+          the job finished.  -  Supported fields for risk analysis jobs:
+          -  ``state`` - RUNNING\|CANCELED\|FINISHED\|FAILED    -
+          'end\_time\` - Corresponds to time the job finished.    -
+          'start\_time\` - Corresponds to time the job finished.  -  The
+          operator must be ``=`` or ``!=``.  Examples:  -
+          inspected\_storage = cloud\_storage AND state = done -
+          inspected\_storage = cloud\_storage OR inspected\_storage =
+          bigquery -  inspected\_storage = cloud\_storage AND (state =
+          done OR state =    canceled) -  end\_time >
+          "2017-12-12T00:00:00+00:00"  The length of this field should
+          be no more than 500 characters.
+      page_size:
+          The standard list page size.
+      page_token:
+          The standard list page token.
+      type:
+          The type of job. Defaults to ``DlpJobType.INSPECT``
+      order_by:
+          Optional 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.  Example: ``name asc, end_time asc,
+          create_time desc``  Supported fields are:  -  ``create_time``:
+          corresponds to time the job was created. -  ``end_time``:
+          corresponds to time the job ended. -  ``name``: corresponds to
+          job's name. -  ``state``: corresponds to ``state``
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListDlpJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDlpJobsRequest)
+
+ListDlpJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDlpJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDLPJOBSRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The response message for listing DLP jobs.
+  
+  
+  Attributes:
+      jobs:
+          A list of DlpJobs that matches the specified filter in the
+          request.
+      next_page_token:
+          The standard List next-page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListDlpJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDlpJobsResponse)
+
+CancelDlpJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelDlpJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELDLPJOBREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The request message for canceling a DLP job.
+  
+  
+  Attributes:
+      name:
+          The name of the DlpJob resource to be cancelled.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CancelDlpJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelDlpJobRequest)
+
+DeleteDlpJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDlpJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDLPJOBREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""The request message for deleting a DLP job.
+  
+  
+  Attributes:
+      name:
+          The name of the DlpJob resource to be deleted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeleteDlpJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDlpJobRequest)
+
+CreateDeidentifyTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDeidentifyTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDEIDENTIFYTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for CreateDeidentifyTemplate.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id
+          or organizations/my-org-id.
+      deidentify_template:
+          The DeidentifyTemplate to create.
+      template_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CreateDeidentifyTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDeidentifyTemplateRequest)
+
+UpdateDeidentifyTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDeidentifyTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDEIDENTIFYTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for UpdateDeidentifyTemplate.
+  
+  
+  Attributes:
+      name:
+          Resource name of organization and deidentify template to be
+          updated, for example
+          ``organizations/433245324/deidentifyTemplates/432452342`` or
+          projects/project-id/deidentifyTemplates/432452342.
+      deidentify_template:
+          New DeidentifyTemplate value.
+      update_mask:
+          Mask to control which fields get updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.UpdateDeidentifyTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDeidentifyTemplateRequest)
+
+GetDeidentifyTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDeidentifyTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDEIDENTIFYTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for GetDeidentifyTemplate.
+  
+  
+  Attributes:
+      name:
+          Resource name of the organization and deidentify template to
+          be read, for example
+          ``organizations/433245324/deidentifyTemplates/432452342`` or
+          projects/project-id/deidentifyTemplates/432452342.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.GetDeidentifyTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDeidentifyTemplateRequest)
+
+ListDeidentifyTemplatesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDeidentifyTemplatesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEIDENTIFYTEMPLATESREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for ListDeidentifyTemplates.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id
+          or organizations/my-org-id.
+      page_token:
+          Optional page token to continue retrieval. Comes from previous
+          call to ``ListDeidentifyTemplates``.
+      page_size:
+          Optional size of the page, can be limited by server. If zero
+          server returns a page of max size 100.
+      order_by:
+          Optional 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.  Example: ``name asc,update_time,
+          create_time desc``  Supported fields are:  -  ``create_time``:
+          corresponds to time the template was created. -
+          ``update_time``: corresponds to time the template was last
+          updated. -  ``name``: corresponds to template's name. -
+          ``display_name``: corresponds to template's display name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListDeidentifyTemplatesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDeidentifyTemplatesRequest)
+
+ListDeidentifyTemplatesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDeidentifyTemplatesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEIDENTIFYTEMPLATESRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Response message for ListDeidentifyTemplates.
+  
+  
+  Attributes:
+      deidentify_templates:
+          List of deidentify templates, up to page\_size in
+          ListDeidentifyTemplatesRequest.
+      next_page_token:
+          If the next page is available then the next page token to be
+          used in following ListDeidentifyTemplates request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListDeidentifyTemplatesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDeidentifyTemplatesResponse)
+
+DeleteDeidentifyTemplateRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDeidentifyTemplateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDEIDENTIFYTEMPLATEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for DeleteDeidentifyTemplate.
+  
+  
+  Attributes:
+      name:
+          Resource name of the organization and deidentify template to
+          be deleted, for example
+          ``organizations/433245324/deidentifyTemplates/432452342`` or
+          projects/project-id/deidentifyTemplates/432452342.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeleteDeidentifyTemplateRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDeidentifyTemplateRequest)
+
+LargeCustomDictionaryConfig = _reflection.GeneratedProtocolMessageType(
+    "LargeCustomDictionaryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LARGECUSTOMDICTIONARYCONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Configuration for a custom dictionary created from a data source of any
+  size up to the maximum size defined in the
+  `limits <https://cloud.google.com/dlp/limits>`__ page. The artifacts of
+  dictionary creation are stored in the specified Google Cloud Storage
+  location. Consider using ``CustomInfoType.Dictionary`` for smaller
+  dictionaries that satisfy the size requirements.
+  
+  
+  Attributes:
+      output_path:
+          Location to store dictionary artifacts in Google Cloud
+          Storage. These files will only be accessible by project owners
+          and the DLP API. If any of these artifacts are modified, the
+          dictionary is considered invalid and can no longer be used.
+      cloud_storage_file_set:
+          Set of files containing newline-delimited lists of dictionary
+          phrases.
+      big_query_field:
+          Field in a BigQuery table where each cell represents a
+          dictionary phrase.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.LargeCustomDictionaryConfig)
+    ),
+)
+_sym_db.RegisterMessage(LargeCustomDictionaryConfig)
+
+LargeCustomDictionaryStats = _reflection.GeneratedProtocolMessageType(
+    "LargeCustomDictionaryStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LARGECUSTOMDICTIONARYSTATS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Summary statistics of a custom dictionary.
+  
+  
+  Attributes:
+      approx_num_phrases:
+          Approximate number of distinct phrases in the dictionary.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.LargeCustomDictionaryStats)
+    ),
+)
+_sym_db.RegisterMessage(LargeCustomDictionaryStats)
+
+StoredInfoTypeConfig = _reflection.GeneratedProtocolMessageType(
+    "StoredInfoTypeConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOREDINFOTYPECONFIG,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Configuration for a StoredInfoType.
+  
+  
+  Attributes:
+      display_name:
+          Display name of the StoredInfoType (max 256 characters).
+      description:
+          Description of the StoredInfoType (max 256 characters).
+      large_custom_dictionary:
+          StoredInfoType where findings are defined by a dictionary of
+          phrases.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StoredInfoTypeConfig)
+    ),
+)
+_sym_db.RegisterMessage(StoredInfoTypeConfig)
+
+StoredInfoTypeStats = _reflection.GeneratedProtocolMessageType(
+    "StoredInfoTypeStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOREDINFOTYPESTATS,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Statistics for a StoredInfoType.
+  
+  
+  Attributes:
+      large_custom_dictionary:
+          StoredInfoType where findings are defined by a dictionary of
+          phrases.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StoredInfoTypeStats)
+    ),
+)
+_sym_db.RegisterMessage(StoredInfoTypeStats)
+
+StoredInfoTypeVersion = _reflection.GeneratedProtocolMessageType(
+    "StoredInfoTypeVersion",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOREDINFOTYPEVERSION,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Version of a StoredInfoType, including the configuration used to build
+  it, create timestamp, and current state.
+  
+  
+  Attributes:
+      config:
+          StoredInfoType configuration.
+      create_time:
+          Create timestamp of the version. Read-only, determined by the
+          system when the version is created.
+      state:
+          Stored info type version state. Read-only, updated by the
+          system during dictionary creation.
+      errors:
+          Errors that occurred when creating this storedInfoType
+          version, or 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.  ..
+          raw:: html     <p>  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.  .. raw:: html
+          <p>  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.
+      stats:
+          Statistics about this storedInfoType version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StoredInfoTypeVersion)
+    ),
+)
+_sym_db.RegisterMessage(StoredInfoTypeVersion)
+
+StoredInfoType = _reflection.GeneratedProtocolMessageType(
+    "StoredInfoType",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOREDINFOTYPE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""StoredInfoType resource message that contains information about the
+  current version and any pending updates.
+  
+  
+  Attributes:
+      name:
+          Resource name.
+      current_version:
+          Current version of the stored info type.
+      pending_versions:
+          Pending versions of the stored info type. Empty if no versions
+          are pending.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StoredInfoType)
+    ),
+)
+_sym_db.RegisterMessage(StoredInfoType)
+
+CreateStoredInfoTypeRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateStoredInfoTypeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESTOREDINFOTYPEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for CreateStoredInfoType.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id
+          or organizations/my-org-id.
+      config:
+          Configuration of the storedInfoType to create.
+      stored_info_type_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CreateStoredInfoTypeRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateStoredInfoTypeRequest)
+
+UpdateStoredInfoTypeRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateStoredInfoTypeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESTOREDINFOTYPEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for UpdateStoredInfoType.
+  
+  
+  Attributes:
+      name:
+          Resource name of organization and storedInfoType to be
+          updated, for example
+          ``organizations/433245324/storedInfoTypes/432452342`` or
+          projects/project-id/storedInfoTypes/432452342.
+      config:
+          Updated configuration for the storedInfoType. If not provided,
+          a new version of the storedInfoType will be created with the
+          existing configuration.
+      update_mask:
+          Mask to control which fields get updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.UpdateStoredInfoTypeRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateStoredInfoTypeRequest)
+
+GetStoredInfoTypeRequest = _reflection.GeneratedProtocolMessageType(
+    "GetStoredInfoTypeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSTOREDINFOTYPEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for GetStoredInfoType.
+  
+  
+  Attributes:
+      name:
+          Resource name of the organization and storedInfoType to be
+          read, for example
+          ``organizations/433245324/storedInfoTypes/432452342`` or
+          projects/project-id/storedInfoTypes/432452342.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.GetStoredInfoTypeRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetStoredInfoTypeRequest)
+
+ListStoredInfoTypesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListStoredInfoTypesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSTOREDINFOTYPESREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for ListStoredInfoTypes.
+  
+  
+  Attributes:
+      parent:
+          The parent resource name, for example projects/my-project-id
+          or organizations/my-org-id.
+      page_token:
+          Optional page token to continue retrieval. Comes from previous
+          call to ``ListStoredInfoTypes``.
+      page_size:
+          Optional size of the page, can be limited by server. If zero
+          server returns a page of max size 100.
+      order_by:
+          Optional 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.  Example: ``name asc, display_name,
+          create_time desc``  Supported fields are:  -  ``create_time``:
+          corresponds to time the most recent version of the    resource
+          was created. -  ``state``: corresponds to the state of the
+          resource. -  ``name``: corresponds to resource name. -
+          ``display_name``: corresponds to info type's display name.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListStoredInfoTypesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListStoredInfoTypesRequest)
+
+ListStoredInfoTypesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListStoredInfoTypesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSTOREDINFOTYPESRESPONSE,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Response message for ListStoredInfoTypes.
+  
+  
+  Attributes:
+      stored_info_types:
+          List of storedInfoTypes, up to page\_size in
+          ListStoredInfoTypesRequest.
+      next_page_token:
+          If the next page is available then the next page token to be
+          used in following ListStoredInfoTypes request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.ListStoredInfoTypesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListStoredInfoTypesResponse)
+
+DeleteStoredInfoTypeRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteStoredInfoTypeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESTOREDINFOTYPEREQUEST,
+        __module__="google.cloud.dlp_v2.proto.dlp_pb2",
+        __doc__="""Request message for DeleteStoredInfoType.
+  
+  
+  Attributes:
+      name:
+          Resource name of the organization and storedInfoType to be
+          deleted, for example
+          ``organizations/433245324/storedInfoTypes/432452342`` or
+          projects/project-id/storedInfoTypes/432452342.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DeleteStoredInfoTypeRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteStoredInfoTypeRequest)
+
+
+DESCRIPTOR._options = None
+
+_DLPSERVICE = _descriptor.ServiceDescriptor(
+    name="DlpService",
+    full_name="google.privacy.dlp.v2.DlpService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\022dlp.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=27204,
+    serialized_end=32982,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="InspectContent",
+            full_name="google.privacy.dlp.v2.DlpService.InspectContent",
+            index=0,
+            containing_service=None,
+            input_type=_INSPECTCONTENTREQUEST,
+            output_type=_INSPECTCONTENTRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\"'/v2/{parent=projects/*}/content:inspect:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RedactImage",
+            full_name="google.privacy.dlp.v2.DlpService.RedactImage",
+            index=1,
+            containing_service=None,
+            input_type=_REDACTIMAGEREQUEST,
+            output_type=_REDACTIMAGERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v2/{parent=projects/*}/image:redact:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeidentifyContent",
+            full_name="google.privacy.dlp.v2.DlpService.DeidentifyContent",
+            index=2,
+            containing_service=None,
+            input_type=_DEIDENTIFYCONTENTREQUEST,
+            output_type=_DEIDENTIFYCONTENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002/"*/v2/{parent=projects/*}/content:deidentify:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ReidentifyContent",
+            full_name="google.privacy.dlp.v2.DlpService.ReidentifyContent",
+            index=3,
+            containing_service=None,
+            input_type=_REIDENTIFYCONTENTREQUEST,
+            output_type=_REIDENTIFYCONTENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002/"*/v2/{parent=projects/*}/content:reidentify:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListInfoTypes",
+            full_name="google.privacy.dlp.v2.DlpService.ListInfoTypes",
+            index=4,
+            containing_service=None,
+            input_type=_LISTINFOTYPESREQUEST,
+            output_type=_LISTINFOTYPESRESPONSE,
+            serialized_options=_b("\202\323\344\223\002\017\022\r/v2/infoTypes"),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateInspectTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.CreateInspectTemplate",
+            index=5,
+            containing_service=None,
+            input_type=_CREATEINSPECTTEMPLATEREQUEST,
+            output_type=_INSPECTTEMPLATE,
+            serialized_options=_b(
+                '\202\323\344\223\002a"-/v2/{parent=organizations/*}/inspectTemplates:\001*Z-"(/v2/{parent=projects/*}/inspectTemplates:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateInspectTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.UpdateInspectTemplate",
+            index=6,
+            containing_service=None,
+            input_type=_UPDATEINSPECTTEMPLATEREQUEST,
+            output_type=_INSPECTTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002a2-/v2/{name=organizations/*/inspectTemplates/*}:\001*Z-2(/v2/{name=projects/*/inspectTemplates/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInspectTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.GetInspectTemplate",
+            index=7,
+            containing_service=None,
+            input_type=_GETINSPECTTEMPLATEREQUEST,
+            output_type=_INSPECTTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002[\022-/v2/{name=organizations/*/inspectTemplates/*}Z*\022(/v2/{name=projects/*/inspectTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListInspectTemplates",
+            full_name="google.privacy.dlp.v2.DlpService.ListInspectTemplates",
+            index=8,
+            containing_service=None,
+            input_type=_LISTINSPECTTEMPLATESREQUEST,
+            output_type=_LISTINSPECTTEMPLATESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002[\022-/v2/{parent=organizations/*}/inspectTemplatesZ*\022(/v2/{parent=projects/*}/inspectTemplates"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteInspectTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.DeleteInspectTemplate",
+            index=9,
+            containing_service=None,
+            input_type=_DELETEINSPECTTEMPLATEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002[*-/v2/{name=organizations/*/inspectTemplates/*}Z**(/v2/{name=projects/*/inspectTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDeidentifyTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.CreateDeidentifyTemplate",
+            index=10,
+            containing_service=None,
+            input_type=_CREATEDEIDENTIFYTEMPLATEREQUEST,
+            output_type=_DEIDENTIFYTEMPLATE,
+            serialized_options=_b(
+                '\202\323\344\223\002g"0/v2/{parent=organizations/*}/deidentifyTemplates:\001*Z0"+/v2/{parent=projects/*}/deidentifyTemplates:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDeidentifyTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.UpdateDeidentifyTemplate",
+            index=11,
+            containing_service=None,
+            input_type=_UPDATEDEIDENTIFYTEMPLATEREQUEST,
+            output_type=_DEIDENTIFYTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002g20/v2/{name=organizations/*/deidentifyTemplates/*}:\001*Z02+/v2/{name=projects/*/deidentifyTemplates/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDeidentifyTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.GetDeidentifyTemplate",
+            index=12,
+            containing_service=None,
+            input_type=_GETDEIDENTIFYTEMPLATEREQUEST,
+            output_type=_DEIDENTIFYTEMPLATE,
+            serialized_options=_b(
+                "\202\323\344\223\002a\0220/v2/{name=organizations/*/deidentifyTemplates/*}Z-\022+/v2/{name=projects/*/deidentifyTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDeidentifyTemplates",
+            full_name="google.privacy.dlp.v2.DlpService.ListDeidentifyTemplates",
+            index=13,
+            containing_service=None,
+            input_type=_LISTDEIDENTIFYTEMPLATESREQUEST,
+            output_type=_LISTDEIDENTIFYTEMPLATESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002a\0220/v2/{parent=organizations/*}/deidentifyTemplatesZ-\022+/v2/{parent=projects/*}/deidentifyTemplates"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDeidentifyTemplate",
+            full_name="google.privacy.dlp.v2.DlpService.DeleteDeidentifyTemplate",
+            index=14,
+            containing_service=None,
+            input_type=_DELETEDEIDENTIFYTEMPLATEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002a*0/v2/{name=organizations/*/deidentifyTemplates/*}Z-*+/v2/{name=projects/*/deidentifyTemplates/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateJobTrigger",
+            full_name="google.privacy.dlp.v2.DlpService.CreateJobTrigger",
+            index=15,
+            containing_service=None,
+            input_type=_CREATEJOBTRIGGERREQUEST,
+            output_type=_JOBTRIGGER,
+            serialized_options=_b(
+                '\202\323\344\223\002("#/v2/{parent=projects/*}/jobTriggers:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateJobTrigger",
+            full_name="google.privacy.dlp.v2.DlpService.UpdateJobTrigger",
+            index=16,
+            containing_service=None,
+            input_type=_UPDATEJOBTRIGGERREQUEST,
+            output_type=_JOBTRIGGER,
+            serialized_options=_b(
+                "\202\323\344\223\002(2#/v2/{name=projects/*/jobTriggers/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetJobTrigger",
+            full_name="google.privacy.dlp.v2.DlpService.GetJobTrigger",
+            index=17,
+            containing_service=None,
+            input_type=_GETJOBTRIGGERREQUEST,
+            output_type=_JOBTRIGGER,
+            serialized_options=_b(
+                "\202\323\344\223\002%\022#/v2/{name=projects/*/jobTriggers/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListJobTriggers",
+            full_name="google.privacy.dlp.v2.DlpService.ListJobTriggers",
+            index=18,
+            containing_service=None,
+            input_type=_LISTJOBTRIGGERSREQUEST,
+            output_type=_LISTJOBTRIGGERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002%\022#/v2/{parent=projects/*}/jobTriggers"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteJobTrigger",
+            full_name="google.privacy.dlp.v2.DlpService.DeleteJobTrigger",
+            index=19,
+            containing_service=None,
+            input_type=_DELETEJOBTRIGGERREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002%*#/v2/{name=projects/*/jobTriggers/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ActivateJobTrigger",
+            full_name="google.privacy.dlp.v2.DlpService.ActivateJobTrigger",
+            index=20,
+            containing_service=None,
+            input_type=_ACTIVATEJOBTRIGGERREQUEST,
+            output_type=_DLPJOB,
+            serialized_options=_b(
+                '\202\323\344\223\0021",/v2/{name=projects/*/jobTriggers/*}:activate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDlpJob",
+            full_name="google.privacy.dlp.v2.DlpService.CreateDlpJob",
+            index=21,
+            containing_service=None,
+            input_type=_CREATEDLPJOBREQUEST,
+            output_type=_DLPJOB,
+            serialized_options=_b(
+                '\202\323\344\223\002$"\037/v2/{parent=projects/*}/dlpJobs:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDlpJobs",
+            full_name="google.privacy.dlp.v2.DlpService.ListDlpJobs",
+            index=22,
+            containing_service=None,
+            input_type=_LISTDLPJOBSREQUEST,
+            output_type=_LISTDLPJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v2/{parent=projects/*}/dlpJobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDlpJob",
+            full_name="google.privacy.dlp.v2.DlpService.GetDlpJob",
+            index=23,
+            containing_service=None,
+            input_type=_GETDLPJOBREQUEST,
+            output_type=_DLPJOB,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v2/{name=projects/*/dlpJobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDlpJob",
+            full_name="google.privacy.dlp.v2.DlpService.DeleteDlpJob",
+            index=24,
+            containing_service=None,
+            input_type=_DELETEDLPJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002!*\037/v2/{name=projects/*/dlpJobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelDlpJob",
+            full_name="google.privacy.dlp.v2.DlpService.CancelDlpJob",
+            index=25,
+            containing_service=None,
+            input_type=_CANCELDLPJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002+"&/v2/{name=projects/*/dlpJobs/*}:cancel:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateStoredInfoType",
+            full_name="google.privacy.dlp.v2.DlpService.CreateStoredInfoType",
+            index=26,
+            containing_service=None,
+            input_type=_CREATESTOREDINFOTYPEREQUEST,
+            output_type=_STOREDINFOTYPE,
+            serialized_options=_b(
+                '\202\323\344\223\002_",/v2/{parent=organizations/*}/storedInfoTypes:\001*Z,"\'/v2/{parent=projects/*}/storedInfoTypes:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateStoredInfoType",
+            full_name="google.privacy.dlp.v2.DlpService.UpdateStoredInfoType",
+            index=27,
+            containing_service=None,
+            input_type=_UPDATESTOREDINFOTYPEREQUEST,
+            output_type=_STOREDINFOTYPE,
+            serialized_options=_b(
+                "\202\323\344\223\002_2,/v2/{name=organizations/*/storedInfoTypes/*}:\001*Z,2'/v2/{name=projects/*/storedInfoTypes/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetStoredInfoType",
+            full_name="google.privacy.dlp.v2.DlpService.GetStoredInfoType",
+            index=28,
+            containing_service=None,
+            input_type=_GETSTOREDINFOTYPEREQUEST,
+            output_type=_STOREDINFOTYPE,
+            serialized_options=_b(
+                "\202\323\344\223\002Y\022,/v2/{name=organizations/*/storedInfoTypes/*}Z)\022'/v2/{name=projects/*/storedInfoTypes/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListStoredInfoTypes",
+            full_name="google.privacy.dlp.v2.DlpService.ListStoredInfoTypes",
+            index=29,
+            containing_service=None,
+            input_type=_LISTSTOREDINFOTYPESREQUEST,
+            output_type=_LISTSTOREDINFOTYPESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002Y\022,/v2/{parent=organizations/*}/storedInfoTypesZ)\022'/v2/{parent=projects/*}/storedInfoTypes"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteStoredInfoType",
+            full_name="google.privacy.dlp.v2.DlpService.DeleteStoredInfoType",
+            index=30,
+            containing_service=None,
+            input_type=_DELETESTOREDINFOTYPEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002Y*,/v2/{name=organizations/*/storedInfoTypes/*}Z)*'/v2/{name=projects/*/storedInfoTypes/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DLPSERVICE)
+
+DESCRIPTOR.services_by_name["DlpService"] = _DLPSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/dlp/google/cloud/dlp_v2/proto/dlp_pb2_grpc.py b/dlp/google/cloud/dlp_v2/proto/dlp_pb2_grpc.py
new file mode 100644
index 000000000000..6114dc83e7e1
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/proto/dlp_pb2_grpc.py
@@ -0,0 +1,656 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.dlp_v2.proto import (
+    dlp_pb2 as google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DlpServiceStub(object):
+    """The Cloud Data Loss Prevention (DLP) API is a service that allows clients
+  to detect the presence of Personally Identifiable Information (PII) and other
+  privacy-sensitive data in user-supplied, unstructured data streams, like text
+  blocks or images.
+  The service also includes methods for sensitive data redaction and
+  scheduling of data scans on Google Cloud Platform based data sets.
+
+  To learn more about concepts and find how-to guides see
+  https://cloud.google.com/dlp/docs/.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.InspectContent = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/InspectContent",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectContentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectContentResponse.FromString,
+        )
+        self.RedactImage = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/RedactImage",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.RedactImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.RedactImageResponse.FromString,
+        )
+        self.DeidentifyContent = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/DeidentifyContent",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyContentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyContentResponse.FromString,
+        )
+        self.ReidentifyContent = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ReidentifyContent",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ReidentifyContentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ReidentifyContentResponse.FromString,
+        )
+        self.ListInfoTypes = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ListInfoTypes",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInfoTypesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInfoTypesResponse.FromString,
+        )
+        self.CreateInspectTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/CreateInspectTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateInspectTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectTemplate.FromString,
+        )
+        self.UpdateInspectTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/UpdateInspectTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateInspectTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectTemplate.FromString,
+        )
+        self.GetInspectTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/GetInspectTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetInspectTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectTemplate.FromString,
+        )
+        self.ListInspectTemplates = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ListInspectTemplates",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInspectTemplatesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInspectTemplatesResponse.FromString,
+        )
+        self.DeleteInspectTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/DeleteInspectTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteInspectTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateDeidentifyTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/CreateDeidentifyTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateDeidentifyTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyTemplate.FromString,
+        )
+        self.UpdateDeidentifyTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/UpdateDeidentifyTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateDeidentifyTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyTemplate.FromString,
+        )
+        self.GetDeidentifyTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/GetDeidentifyTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetDeidentifyTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyTemplate.FromString,
+        )
+        self.ListDeidentifyTemplates = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ListDeidentifyTemplates",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDeidentifyTemplatesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDeidentifyTemplatesResponse.FromString,
+        )
+        self.DeleteDeidentifyTemplate = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/DeleteDeidentifyTemplate",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteDeidentifyTemplateRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateJobTrigger = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/CreateJobTrigger",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateJobTriggerRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.JobTrigger.FromString,
+        )
+        self.UpdateJobTrigger = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/UpdateJobTrigger",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateJobTriggerRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.JobTrigger.FromString,
+        )
+        self.GetJobTrigger = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/GetJobTrigger",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetJobTriggerRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.JobTrigger.FromString,
+        )
+        self.ListJobTriggers = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ListJobTriggers",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListJobTriggersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListJobTriggersResponse.FromString,
+        )
+        self.DeleteJobTrigger = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/DeleteJobTrigger",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteJobTriggerRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ActivateJobTrigger = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ActivateJobTrigger",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ActivateJobTriggerRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DlpJob.FromString,
+        )
+        self.CreateDlpJob = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/CreateDlpJob",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateDlpJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DlpJob.FromString,
+        )
+        self.ListDlpJobs = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ListDlpJobs",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDlpJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDlpJobsResponse.FromString,
+        )
+        self.GetDlpJob = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/GetDlpJob",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetDlpJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DlpJob.FromString,
+        )
+        self.DeleteDlpJob = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/DeleteDlpJob",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteDlpJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CancelDlpJob = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/CancelDlpJob",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CancelDlpJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateStoredInfoType = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/CreateStoredInfoType",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateStoredInfoTypeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.StoredInfoType.FromString,
+        )
+        self.UpdateStoredInfoType = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/UpdateStoredInfoType",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateStoredInfoTypeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.StoredInfoType.FromString,
+        )
+        self.GetStoredInfoType = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/GetStoredInfoType",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetStoredInfoTypeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.StoredInfoType.FromString,
+        )
+        self.ListStoredInfoTypes = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/ListStoredInfoTypes",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListStoredInfoTypesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListStoredInfoTypesResponse.FromString,
+        )
+        self.DeleteStoredInfoType = channel.unary_unary(
+            "/google.privacy.dlp.v2.DlpService/DeleteStoredInfoType",
+            request_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteStoredInfoTypeRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class DlpServiceServicer(object):
+    """The Cloud Data Loss Prevention (DLP) API is a service that allows clients
+  to detect the presence of Personally Identifiable Information (PII) and other
+  privacy-sensitive data in user-supplied, unstructured data streams, like text
+  blocks or images.
+  The service also includes methods for sensitive data redaction and
+  scheduling of data scans on Google Cloud Platform based data sets.
+
+  To learn more about concepts and find how-to guides see
+  https://cloud.google.com/dlp/docs/.
+  """
+
+    def InspectContent(self, request, context):
+        """Finds potentially sensitive info in content.
+    This method has limits on input size, processing time, and output size.
+
+    When no InfoTypes or CustomInfoTypes are specified in this request, the
+    system will automatically choose what detectors to run. By default this may
+    be all types, but may change over time as detectors are updated.
+
+    For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images
+    and https://cloud.google.com/dlp/docs/inspecting-text,
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RedactImage(self, request, context):
+        """Redacts potentially sensitive info from an image.
+    This method has limits on input size, processing time, and output size.
+    See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to
+    learn more.
+
+    When no InfoTypes or CustomInfoTypes are specified in this request, the
+    system will automatically choose what detectors to run. By default this may
+    be all types, but may change over time as detectors are updated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeidentifyContent(self, request, context):
+        """De-identifies potentially sensitive info from a ContentItem.
+    This method has limits on input size and output size.
+    See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to
+    learn more.
+
+    When no InfoTypes or CustomInfoTypes are specified in this request, the
+    system will automatically choose what detectors to run. By default this may
+    be all types, but may change over time as detectors are updated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ReidentifyContent(self, request, context):
+        """Re-identifies content that has been de-identified.
+    See
+    https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example
+    to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListInfoTypes(self, request, context):
+        """Returns a list of the sensitive information types that the DLP API
+    supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
+    learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateInspectTemplate(self, request, context):
+        """Creates an InspectTemplate for re-using frequently used configuration
+    for inspecting content, images, and storage.
+    See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateInspectTemplate(self, request, context):
+        """Updates the InspectTemplate.
+    See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInspectTemplate(self, request, context):
+        """Gets an InspectTemplate.
+    See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListInspectTemplates(self, request, context):
+        """Lists InspectTemplates.
+    See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteInspectTemplate(self, request, context):
+        """Deletes an InspectTemplate.
+    See https://cloud.google.com/dlp/docs/creating-templates to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDeidentifyTemplate(self, request, context):
+        """Creates a DeidentifyTemplate for re-using frequently used configuration
+    for de-identifying content, images, and storage.
+    See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+    more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDeidentifyTemplate(self, request, context):
+        """Updates the DeidentifyTemplate.
+    See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+    more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDeidentifyTemplate(self, request, context):
+        """Gets a DeidentifyTemplate.
+    See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+    more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDeidentifyTemplates(self, request, context):
+        """Lists DeidentifyTemplates.
+    See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+    more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDeidentifyTemplate(self, request, context):
+        """Deletes a DeidentifyTemplate.
+    See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+    more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateJobTrigger(self, request, context):
+        """Creates a job trigger to run DLP actions such as scanning storage for
+    sensitive information on a set schedule.
+    See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateJobTrigger(self, request, context):
+        """Updates a job trigger.
+    See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetJobTrigger(self, request, context):
+        """Gets a job trigger.
+    See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListJobTriggers(self, request, context):
+        """Lists job triggers.
+    See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteJobTrigger(self, request, context):
+        """Deletes a job trigger.
+    See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ActivateJobTrigger(self, request, context):
+        """Activate a job trigger. Causes the immediate execute of a trigger
+    instead of waiting on the trigger event to occur.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDlpJob(self, request, context):
+        """Creates a new job to inspect storage or calculate risk metrics.
+    See https://cloud.google.com/dlp/docs/inspecting-storage and
+    https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+
+    When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the
+    system will automatically choose what detectors to run. By default this may
+    be all types, but may change over time as detectors are updated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDlpJobs(self, request, context):
+        """Lists DlpJobs that match the specified filter in the request.
+    See https://cloud.google.com/dlp/docs/inspecting-storage and
+    https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDlpJob(self, request, context):
+        """Gets the latest state of a long-running DlpJob.
+    See https://cloud.google.com/dlp/docs/inspecting-storage and
+    https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDlpJob(self, request, context):
+        """Deletes a long-running DlpJob. This method indicates that the client is
+    no longer interested in the DlpJob result. The job will be cancelled if
+    possible.
+    See https://cloud.google.com/dlp/docs/inspecting-storage and
+    https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelDlpJob(self, request, context):
+        """Starts asynchronous cancellation on a long-running DlpJob. The server
+    makes a best effort to cancel the DlpJob, but success is not
+    guaranteed.
+    See https://cloud.google.com/dlp/docs/inspecting-storage and
+    https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateStoredInfoType(self, request, context):
+        """Creates a pre-built stored infoType to be used for inspection.
+    See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+    learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateStoredInfoType(self, request, context):
+        """Updates the stored infoType by creating a new version. The existing version
+    will continue to be used until the new version is ready.
+    See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+    learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetStoredInfoType(self, request, context):
+        """Gets a stored infoType.
+    See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+    learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListStoredInfoTypes(self, request, context):
+        """Lists stored infoTypes.
+    See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+    learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteStoredInfoType(self, request, context):
+        """Deletes a stored infoType.
+    See https://cloud.google.com/dlp/docs/creating-stored-infotypes to
+    learn more.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DlpServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "InspectContent": grpc.unary_unary_rpc_method_handler(
+            servicer.InspectContent,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectContentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectContentResponse.SerializeToString,
+        ),
+        "RedactImage": grpc.unary_unary_rpc_method_handler(
+            servicer.RedactImage,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.RedactImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.RedactImageResponse.SerializeToString,
+        ),
+        "DeidentifyContent": grpc.unary_unary_rpc_method_handler(
+            servicer.DeidentifyContent,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyContentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyContentResponse.SerializeToString,
+        ),
+        "ReidentifyContent": grpc.unary_unary_rpc_method_handler(
+            servicer.ReidentifyContent,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ReidentifyContentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ReidentifyContentResponse.SerializeToString,
+        ),
+        "ListInfoTypes": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInfoTypes,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInfoTypesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInfoTypesResponse.SerializeToString,
+        ),
+        "CreateInspectTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateInspectTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateInspectTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectTemplate.SerializeToString,
+        ),
+        "UpdateInspectTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateInspectTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateInspectTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectTemplate.SerializeToString,
+        ),
+        "GetInspectTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInspectTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetInspectTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.InspectTemplate.SerializeToString,
+        ),
+        "ListInspectTemplates": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInspectTemplates,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInspectTemplatesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListInspectTemplatesResponse.SerializeToString,
+        ),
+        "DeleteInspectTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteInspectTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteInspectTemplateRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateDeidentifyTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDeidentifyTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateDeidentifyTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyTemplate.SerializeToString,
+        ),
+        "UpdateDeidentifyTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDeidentifyTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateDeidentifyTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyTemplate.SerializeToString,
+        ),
+        "GetDeidentifyTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDeidentifyTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetDeidentifyTemplateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeidentifyTemplate.SerializeToString,
+        ),
+        "ListDeidentifyTemplates": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDeidentifyTemplates,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDeidentifyTemplatesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDeidentifyTemplatesResponse.SerializeToString,
+        ),
+        "DeleteDeidentifyTemplate": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDeidentifyTemplate,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteDeidentifyTemplateRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateJobTrigger": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateJobTrigger,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateJobTriggerRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.JobTrigger.SerializeToString,
+        ),
+        "UpdateJobTrigger": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateJobTrigger,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateJobTriggerRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.JobTrigger.SerializeToString,
+        ),
+        "GetJobTrigger": grpc.unary_unary_rpc_method_handler(
+            servicer.GetJobTrigger,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetJobTriggerRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.JobTrigger.SerializeToString,
+        ),
+        "ListJobTriggers": grpc.unary_unary_rpc_method_handler(
+            servicer.ListJobTriggers,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListJobTriggersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListJobTriggersResponse.SerializeToString,
+        ),
+        "DeleteJobTrigger": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteJobTrigger,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteJobTriggerRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ActivateJobTrigger": grpc.unary_unary_rpc_method_handler(
+            servicer.ActivateJobTrigger,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ActivateJobTriggerRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DlpJob.SerializeToString,
+        ),
+        "CreateDlpJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDlpJob,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateDlpJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DlpJob.SerializeToString,
+        ),
+        "ListDlpJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDlpJobs,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDlpJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListDlpJobsResponse.SerializeToString,
+        ),
+        "GetDlpJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDlpJob,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetDlpJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DlpJob.SerializeToString,
+        ),
+        "DeleteDlpJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDlpJob,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteDlpJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CancelDlpJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelDlpJob,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CancelDlpJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateStoredInfoType": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateStoredInfoType,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.CreateStoredInfoTypeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.StoredInfoType.SerializeToString,
+        ),
+        "UpdateStoredInfoType": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateStoredInfoType,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.UpdateStoredInfoTypeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.StoredInfoType.SerializeToString,
+        ),
+        "GetStoredInfoType": grpc.unary_unary_rpc_method_handler(
+            servicer.GetStoredInfoType,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.GetStoredInfoTypeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.StoredInfoType.SerializeToString,
+        ),
+        "ListStoredInfoTypes": grpc.unary_unary_rpc_method_handler(
+            servicer.ListStoredInfoTypes,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListStoredInfoTypesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.ListStoredInfoTypesResponse.SerializeToString,
+        ),
+        "DeleteStoredInfoType": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteStoredInfoType,
+            request_deserializer=google_dot_cloud_dot_privacy_dot_dlp__v2_dot_proto_dot_dlp__pb2.DeleteStoredInfoTypeRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.privacy.dlp.v2.DlpService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/dlp/google/cloud/dlp_v2/proto/storage.proto b/dlp/google/cloud/dlp_v2/proto/storage.proto
new file mode 100644
index 000000000000..c2f38a61304c
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/proto/storage.proto
@@ -0,0 +1,643 @@
+// 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.privacy.dlp.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Dlp.V2";
+option go_package = "google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp";
+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";
+
+// Type of information detected by the API.
+message InfoType {
+  // Name of the information type. Either a name of your choosing when
+  // 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}.
+  string name = 1;
+}
+
+// A reference to a StoredInfoType to use with scanning.
+message StoredType {
+  // Resource name of the requested `StoredInfoType`, for example
+  // `organizations/433245324/storedInfoTypes/432452342` or
+  // `projects/project-id/storedInfoTypes/432452342`.
+  string name = 1;
+
+  // Timestamp indicating when the version of the `StoredInfoType` used for
+  // inspection was created. Output-only field, populated by the system.
+  google.protobuf.Timestamp create_time = 2;
+}
+
+// Categorization of results based on how likely they are to represent a match,
+// based on the number of elements they contain which imply a match.
+enum Likelihood {
+  // Default value; same as POSSIBLE.
+  LIKELIHOOD_UNSPECIFIED = 0;
+
+  // Few matching elements.
+  VERY_UNLIKELY = 1;
+
+  UNLIKELY = 2;
+
+  // Some matching elements.
+  POSSIBLE = 3;
+
+  LIKELY = 4;
+
+  // Many matching elements.
+  VERY_LIKELY = 5;
+}
+
+// Custom information type provided by the user. Used to find domain-specific
+// sensitive information configurable to the data in question.
+message CustomInfoType {
+  // Custom information type based on a dictionary of words or phrases. This can
+  // be used to match sensitive information specific to the data, such as a list
+  // of employee IDs or job titles.
+  //
+  // Dictionary words are case-insensitive and all characters other than letters
+  // and digits in the unicode [Basic Multilingual
+  // Plane](https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane)
+  // will be replaced with whitespace when scanning for matches, so the
+  // dictionary phrase "Sam Johnson" will match all three phrases "sam johnson",
+  // "Sam, Johnson", and "Sam (Johnson)". Additionally, the characters
+  // surrounding any match must be of a different type than the adjacent
+  // characters within the word, so letters must be next to non-letters and
+  // digits next to non-digits. For example, the dictionary word "jen" will
+  // match the first three letters of the text "jen123" but will return no
+  // matches for "jennifer".
+  //
+  // Dictionary words containing a large number of characters that are not
+  // letters or digits may result in unexpected findings because such characters
+  // are treated as whitespace. The
+  // [limits](https://cloud.google.com/dlp/limits) page contains details about
+  // the size limits of dictionaries. For dictionaries that do not fit within
+  // these constraints, consider using `LargeCustomDictionaryConfig` in the
+  // `StoredInfoType` API.
+  message Dictionary {
+    // Message defining a list of words or phrases to search for in the data.
+    message WordList {
+      // Words or phrases defining the dictionary. The dictionary must contain
+      // at least one phrase and every phrase must contain at least 2 characters
+      // that are letters or digits. [required]
+      repeated string words = 1;
+    }
+
+    oneof source {
+      // List of words or phrases to search for.
+      WordList word_list = 1;
+
+      // Newline-delimited file of words in Cloud Storage. Only a single file
+      // is accepted.
+      CloudStoragePath cloud_storage_path = 3;
+    }
+  }
+
+  // Message defining a custom regular expression.
+  message Regex {
+    // Pattern defining the regular expression. Its syntax
+    // (https://github.com/google/re2/wiki/Syntax) can be found under the
+    // google/re2 repository on GitHub.
+    string pattern = 1;
+
+    // The index of the submatch to extract as findings. When not
+    // specified, the entire match is returned. No more than 3 may be included.
+    repeated int32 group_indexes = 2;
+  }
+
+  // Message for detecting output from deidentification transformations
+  // such as
+  // [`CryptoReplaceFfxFpeConfig`](/dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig).
+  // These types of transformations are
+  // those that perform pseudonymization, thereby producing a "surrogate" as
+  // output. This should be used in conjunction with a field on the
+  // transformation such as `surrogate_info_type`. This CustomInfoType does
+  // not support the use of `detection_rules`.
+  message SurrogateType {
+
+  }
+
+  // Deprecated; use `InspectionRuleSet` instead. Rule for modifying a
+  // `CustomInfoType` to alter behavior under certain circumstances, depending
+  // on the specific details of the rule. Not supported for the `surrogate_type`
+  // custom infoType.
+  message DetectionRule {
+    // Message for specifying a window around a finding to apply a detection
+    // rule.
+    message Proximity {
+      // Number of characters before the finding to consider.
+      int32 window_before = 1;
+
+      // Number of characters after the finding to consider.
+      int32 window_after = 2;
+    }
+
+    // Message for specifying an adjustment to the likelihood of a finding as
+    // part of a detection rule.
+    message LikelihoodAdjustment {
+      oneof adjustment {
+        // Set the likelihood of a finding to a fixed value.
+        Likelihood fixed_likelihood = 1;
+
+        // Increase or decrease the likelihood by the specified number of
+        // levels. For example, if a finding would be `POSSIBLE` without the
+        // detection rule and `relative_likelihood` is 1, then it is upgraded to
+        // `LIKELY`, while a value of -1 would downgrade it to `UNLIKELY`.
+        // Likelihood may never drop below `VERY_UNLIKELY` or exceed
+        // `VERY_LIKELY`, so applying an adjustment of 1 followed by an
+        // adjustment of -1 when base likelihood is `VERY_LIKELY` will result in
+        // a final likelihood of `LIKELY`.
+        int32 relative_likelihood = 2;
+      }
+    }
+
+    // The rule that adjusts the likelihood of findings within a certain
+    // proximity of hotwords.
+    message HotwordRule {
+      // Regular expression pattern defining what qualifies as a hotword.
+      Regex hotword_regex = 1;
+
+      // Proximity of the finding within which the entire hotword must reside.
+      // The total length of the window cannot exceed 1000 characters. Note that
+      // the finding itself will be included in the window, so that hotwords may
+      // be used to match substrings of the finding itself. For example, the
+      // certainty of a phone number regex "\(\d{3}\) \d{3}-\d{4}" could be
+      // adjusted upwards if the area code is known to be the local area code of
+      // a company office using the hotword regex "\(xxx\)", where "xxx"
+      // is the area code in question.
+      Proximity proximity = 2;
+
+      // Likelihood adjustment to apply to all matching findings.
+      LikelihoodAdjustment likelihood_adjustment = 3;
+    }
+
+    oneof type {
+      // Hotword-based detection rule.
+      HotwordRule hotword_rule = 1;
+    }
+  }
+
+  enum ExclusionType {
+    // A finding of this custom info type will not be excluded from results.
+    EXCLUSION_TYPE_UNSPECIFIED = 0;
+
+    // A finding of this custom info type will be excluded from final results,
+    // but can still affect rule execution.
+    EXCLUSION_TYPE_EXCLUDE = 1;
+  }
+
+  // CustomInfoType can either be a new infoType, or an extension of built-in
+  // infoType, when the name matches one of existing infoTypes and that infoType
+  // is specified in `InspectContent.info_types` field. Specifying the latter
+  // adds findings to the one detected by the system. If built-in info type is
+  // not specified in `InspectContent.info_types` list then the name is treated
+  // as a custom info type.
+  InfoType info_type = 1;
+
+  // Likelihood to return for this CustomInfoType. This base value can be
+  // altered by a detection rule if the finding meets the criteria specified by
+  // the rule. Defaults to `VERY_LIKELY` if not specified.
+  Likelihood likelihood = 6;
+
+  oneof type {
+    // A list of phrases to detect as a CustomInfoType.
+    Dictionary dictionary = 2;
+
+    // Regular expression based CustomInfoType.
+    Regex regex = 3;
+
+    // Message for detecting output from deidentification transformations that
+    // support reversing.
+    SurrogateType surrogate_type = 4;
+
+    // Load an existing `StoredInfoType` resource for use in
+    // `InspectDataSource`. Not currently supported in `InspectContent`.
+    StoredType stored_type = 5;
+  }
+
+  // Set of detection rules to apply to all findings of this CustomInfoType.
+  // Rules are applied in order that they are specified. Not supported for the
+  // `surrogate_type` CustomInfoType.
+  repeated DetectionRule detection_rules = 7;
+
+  // If set to EXCLUSION_TYPE_EXCLUDE this infoType will not cause a finding
+  // to be returned. It still can be used for rules matching.
+  ExclusionType exclusion_type = 8;
+}
+
+// General identifier of a data field in a storage service.
+message FieldId {
+  // Name describing the field.
+  string name = 1;
+}
+
+// Datastore partition ID.
+// A partition ID identifies a grouping of entities. The grouping is always
+// by project and namespace, however the namespace ID may be empty.
+//
+// A partition ID contains several dimensions:
+// project ID and namespace ID.
+message PartitionId {
+  // The ID of the project to which the entities belong.
+  string project_id = 2;
+
+  // If not empty, the ID of the namespace to which the entities belong.
+  string namespace_id = 4;
+}
+
+// A representation of a Datastore kind.
+message KindExpression {
+  // The name of the kind.
+  string name = 1;
+}
+
+// Options defining a data set within Google Cloud Datastore.
+message DatastoreOptions {
+  // A partition ID identifies a grouping of entities. The grouping is always
+  // by project and namespace, however the namespace ID may be empty.
+  PartitionId partition_id = 1;
+
+  // The kind to process.
+  KindExpression kind = 2;
+}
+
+// Message representing a set of files in a Cloud Storage bucket. Regular
+// expressions are used to allow fine-grained control over which files in the
+// bucket to include.
+//
+// Included files are those that match at least one item in `include_regex` and
+// do not match any items in `exclude_regex`. Note that a file that matches
+// items from both lists will _not_ be included. For a match to occur, the
+// entire file path (i.e., everything in the url after the bucket name) must
+// match the regular expression.
+//
+// For example, given the input `{bucket_name: "mybucket", include_regex:
+// ["directory1/.*"], exclude_regex:
+// ["directory1/excluded.*"]}`:
+//
+// * `gs://mybucket/directory1/myfile` will be included
+// * `gs://mybucket/directory1/directory2/myfile` will be included (`.*` matches
+// across `/`)
+// * `gs://mybucket/directory0/directory1/myfile` will _not_ be included (the
+// full path doesn't match any items in `include_regex`)
+// * `gs://mybucket/directory1/excludedfile` will _not_ be included (the path
+// matches an item in `exclude_regex`)
+//
+// If `include_regex` is left empty, it will match all files by default
+// (this is equivalent to setting `include_regex: [".*"]`).
+//
+// Some other common use cases:
+//
+// * `{bucket_name: "mybucket", exclude_regex: [".*\.pdf"]}` will include all
+// files in `mybucket` except for .pdf files
+// * `{bucket_name: "mybucket", include_regex: ["directory/[^/]+"]}` will
+// include all files directly under `gs://mybucket/directory/`, without matching
+// across `/`
+message CloudStorageRegexFileSet {
+  // The name of a Cloud Storage bucket. Required.
+  string bucket_name = 1;
+
+  // A list of regular expressions matching file paths to include. All files in
+  // the bucket that match at least one of these regular expressions will be
+  // included in the set of files, except for those that also match an item in
+  // `exclude_regex`. Leaving this field empty will match all files by default
+  // (this is equivalent to including `.*` in the list).
+  //
+  // Regular expressions use RE2
+  // [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be found
+  // under the google/re2 repository on GitHub.
+  repeated string include_regex = 2;
+
+  // A list of regular expressions matching file paths to exclude. All files in
+  // the bucket that match at least one of these regular expressions will be
+  // excluded from the scan.
+  //
+  // Regular expressions use RE2
+  // [syntax](https://github.com/google/re2/wiki/Syntax); a guide can be found
+  // under the google/re2 repository on GitHub.
+  repeated string exclude_regex = 3;
+}
+
+// Options defining a file or a set of files within a Google Cloud Storage
+// bucket.
+message CloudStorageOptions {
+  // Set of files to scan.
+  message FileSet {
+    // The Cloud Storage url of the file(s) to scan, in the format
+    // `gs://<bucket>/<path>`. Trailing wildcard in the path is allowed.
+    //
+    // If the url ends in a trailing slash, the bucket or directory represented
+    // by the url will be scanned non-recursively (content in sub-directories
+    // will not be scanned). This means that `gs://mybucket/` is equivalent to
+    // `gs://mybucket/*`, and `gs://mybucket/directory/` is equivalent to
+    // `gs://mybucket/directory/*`.
+    //
+    // Exactly one of `url` or `regex_file_set` must be set.
+    string url = 1;
+
+    // The regex-filtered set of files to scan. Exactly one of `url` or
+    // `regex_file_set` must be set.
+    CloudStorageRegexFileSet regex_file_set = 2;
+  }
+
+  // How to sample bytes if not all bytes are scanned. Meaningful only when used
+  // in conjunction with bytes_limit_per_file. If not specified, scanning would
+  // start from the top.
+  enum SampleMethod {
+    SAMPLE_METHOD_UNSPECIFIED = 0;
+
+    // Scan from the top (default).
+    TOP = 1;
+
+    // For each file larger than bytes_limit_per_file, randomly pick the offset
+    // to start scanning. The scanned bytes are contiguous.
+    RANDOM_START = 2;
+  }
+
+  // The set of one or more files to scan.
+  FileSet file_set = 1;
+
+  // Max number of bytes to scan from a file. If a scanned file's size is bigger
+  // than this value then the rest of the bytes are omitted. Only one
+  // of bytes_limit_per_file and bytes_limit_per_file_percent can be specified.
+  int64 bytes_limit_per_file = 4;
+
+  // Max percentage of bytes to scan from a file. The rest are omitted. The
+  // number of bytes scanned is rounded down. Must be between 0 and 100,
+  // inclusively. Both 0 and 100 means no limit. Defaults to 0. Only one
+  // of bytes_limit_per_file and bytes_limit_per_file_percent can be specified.
+  int32 bytes_limit_per_file_percent = 8;
+
+  // List of file type groups to include in the scan.
+  // 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.
+  repeated FileType file_types = 5;
+
+  SampleMethod sample_method = 6;
+
+  // Limits the number of files to scan to this percentage of the input FileSet.
+  // Number of files scanned is rounded down. Must be between 0 and 100,
+  // inclusively. Both 0 and 100 means no limit. Defaults to 0.
+  int32 files_limit_percent = 7;
+}
+
+// Message representing a set of files in Cloud Storage.
+message CloudStorageFileSet {
+  // The url, in the format `gs://<bucket>/<path>`. Trailing wildcard in the
+  // path is allowed.
+  string url = 1;
+}
+
+// Message representing a single file or path in Cloud Storage.
+message CloudStoragePath {
+  // A url representing a file or path (no wildcards) in Cloud Storage.
+  // Example: gs://[BUCKET_NAME]/dictionary.txt
+  string path = 1;
+}
+
+// Options defining BigQuery table and row identifiers.
+message BigQueryOptions {
+  // How to sample rows if not all rows are scanned. Meaningful only when used
+  // in conjunction with either rows_limit or rows_limit_percent. If not
+  // specified, scanning would start from the top.
+  enum SampleMethod {
+    SAMPLE_METHOD_UNSPECIFIED = 0;
+
+    // Scan from the top (default).
+    TOP = 1;
+
+    // Randomly pick the row to start scanning. The scanned rows are contiguous.
+    RANDOM_START = 2;
+  }
+
+  // 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.
+  repeated FieldId identifying_fields = 2;
+
+  // Max number of rows to scan. If the table has more rows than this value, the
+  // rest of the rows are omitted. If not set, or if set to 0, all rows will be
+  // scanned. Only one of rows_limit and rows_limit_percent can be specified.
+  // Cannot be used in conjunction with TimespanConfig.
+  int64 rows_limit = 3;
+
+  // Max percentage of rows to scan. The rest are omitted. The number of rows
+  // scanned is rounded down. Must be between 0 and 100, inclusively. Both 0 and
+  // 100 means no limit. Defaults to 0. Only one of rows_limit and
+  // rows_limit_percent can be specified. Cannot be used in conjunction with
+  // TimespanConfig.
+  int32 rows_limit_percent = 6;
+
+  SampleMethod sample_method = 4;
+
+  // References to fields excluded from scanning. This allows you to skip
+  // inspection of entire columns which you know have no findings.
+  repeated FieldId excluded_fields = 5;
+}
+
+// Shared message indicating Cloud storage type.
+message StorageConfig {
+  // Configuration of the timespan of the items to include in scanning.
+  // Currently only supported when inspecting Google Cloud Storage and BigQuery.
+  message TimespanConfig {
+    // Exclude files or rows older than this value.
+    google.protobuf.Timestamp start_time = 1;
+
+    // Exclude files or rows newer than this value.
+    // If set to zero, no upper time limit is applied.
+    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.
+    FieldId timestamp_field = 3;
+
+    // When the job is started by a JobTrigger we will automatically figure out
+    // a valid start_time to avoid scanning files that have not been modified
+    // since the last time the JobTrigger executed. This will be based on the
+    // time of the execution of the last run of the JobTrigger.
+    bool enable_auto_population_of_timespan_config = 4;
+  }
+
+  oneof type {
+    // Google Cloud Datastore options specification.
+    DatastoreOptions datastore_options = 2;
+
+    // Google Cloud Storage options specification.
+    CloudStorageOptions cloud_storage_options = 3;
+
+    // BigQuery options specification.
+    BigQueryOptions big_query_options = 4;
+  }
+
+  TimespanConfig timespan_config = 6;
+}
+
+// Definitions of file type groups to scan.
+enum FileType {
+  // Includes all files.
+  FILE_TYPE_UNSPECIFIED = 0;
+
+  // Includes all file extensions not covered by text file types.
+  BINARY_FILE = 1;
+
+  // Included file extensions:
+  //   asc, brf, c, cc, cpp, csv, cxx, c++, cs, css, dart, eml, go, h, hh, hpp,
+  //   hxx, h++, hs, html, htm, shtml, shtm, xhtml, lhs, ini, java, js, json,
+  //   ocaml, md, mkd, markdown, m, ml, mli, pl, pm, php, phtml, pht, py, pyw,
+  //   rb, rbw, rs, rc, scala, sh, sql, tex, txt, text, tsv, vcard, vcs, wml,
+  //   xml, xsl, xsd, yml, yaml.
+  TEXT_FILE = 2;
+
+  // Included file extensions:
+  //   bmp, gif, jpg, jpeg, jpe, png.
+  // bytes_limit_per_file has no effect on image files.
+  IMAGE = 3;
+
+  // Included file extensions:
+  //   avro
+  AVRO = 7;
+}
+
+// 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.
+  int64 row_number = 2;
+}
+
+// Record key for a finding in Cloud Datastore.
+message DatastoreKey {
+  // Datastore entity key.
+  Key entity_key = 1;
+}
+
+// A unique identifier for a Datastore entity.
+// If a key's partition ID or any of its path kinds or names are
+// reserved/read-only, the key is reserved/read-only.
+// A reserved/read-only key is forbidden in certain documented contexts.
+message Key {
+  // A (kind, ID/name) pair used to construct a key path.
+  //
+  // If either name or ID is set, the element is complete.
+  // If neither is set, the element is incomplete.
+  message PathElement {
+    // The kind of the entity.
+    // A kind matching regex `__.*__` is reserved/read-only.
+    // A kind must not contain more than 1500 bytes when UTF-8 encoded.
+    // Cannot be `""`.
+    string kind = 1;
+
+    // The type of ID.
+    oneof id_type {
+      // The auto-allocated ID of the entity.
+      // Never equal to zero. Values less than zero are discouraged and may not
+      // be supported in the future.
+      int64 id = 2;
+
+      // The name of the entity.
+      // A name matching regex `__.*__` is reserved/read-only.
+      // A name must not be more than 1500 bytes when UTF-8 encoded.
+      // Cannot be `""`.
+      string name = 3;
+    }
+  }
+
+  // Entities are partitioned into subsets, currently identified by a project
+  // ID and namespace ID.
+  // Queries are scoped to a single partition.
+  PartitionId partition_id = 1;
+
+  // The entity path.
+  // An entity path consists of one or more elements composed of a kind and a
+  // string or numerical identifier, which identify entities. The first
+  // element identifies a _root entity_, the second element identifies
+  // a _child_ of the root entity, the third element identifies a child of the
+  // second entity, and so forth. The entities identified by all prefixes of
+  // the path are called the element's _ancestors_.
+  //
+  // A path can never be empty, and a path can have at most 100 elements.
+  repeated PathElement path = 2;
+}
+
+// Message for a unique key indicating a record that contains a finding.
+message RecordKey {
+  oneof type {
+    DatastoreKey datastore_key = 2;
+
+    BigQueryKey big_query_key = 3;
+  }
+
+  // Values of identifying columns in the given row. Order of values matches
+  // the order of field identifiers specified in the scanning request.
+  repeated string id_values = 5;
+}
+
+// Message defining the location of a BigQuery table. A table is uniquely
+// identified  by its project_id, dataset_id, and table_name. Within a query
+// a table is often referenced with a string in the format of:
+// `<project_id>:<dataset_id>.<table_id>` or
+// `<project_id>.<dataset_id>.<table_id>`.
+message BigQueryTable {
+  // The Google Cloud Platform project ID of the project containing the table.
+  // If omitted, project ID is inferred from the API call.
+  string project_id = 1;
+
+  // Dataset ID of the table.
+  string dataset_id = 2;
+
+  // Name of the table.
+  string table_id = 3;
+}
+
+// Message defining a field of a BigQuery table.
+message BigQueryField {
+  // Source table of the field.
+  BigQueryTable table = 1;
+
+  // Designated field in the BigQuery table.
+  FieldId field = 2;
+}
+
+// An entity in a dataset is a field or set of fields that correspond to a
+// single person. For example, in medical records the `EntityId` might be a
+// patient identifier, or for financial records it might be an account
+// identifier. This message is used when generalizations or analysis must take
+// into account that multiple rows correspond to the same entity.
+message EntityId {
+  // Composite key indicating which field contains the entity identifier.
+  FieldId field = 1;
+}
diff --git a/dlp/google/cloud/dlp_v2/proto/storage_pb2.py b/dlp/google/cloud/dlp_v2/proto/storage_pb2.py
new file mode 100644
index 000000000000..5658de07e2ea
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/proto/storage_pb2.py
@@ -0,0 +1,3319 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/privacy/dlp_v2/proto/storage.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/privacy/dlp_v2/proto/storage.proto",
+    package="google.privacy.dlp.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.privacy.dlp.v2B\nDlpStorageP\001Z8google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp\252\002\023Google.Cloud.Dlp.V2\312\002\023Google\\Cloud\\Dlp\\V2"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/privacy/dlp_v2/proto/storage.proto\x12\x15google.privacy.dlp.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x18\n\x08InfoType\x12\x0c\n\x04name\x18\x01 \x01(\t"K\n\nStoredType\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xc8\x0b\n\x0e\x43ustomInfoType\x12\x32\n\tinfo_type\x18\x01 \x01(\x0b\x32\x1f.google.privacy.dlp.v2.InfoType\x12\x35\n\nlikelihood\x18\x06 \x01(\x0e\x32!.google.privacy.dlp.v2.Likelihood\x12\x46\n\ndictionary\x18\x02 \x01(\x0b\x32\x30.google.privacy.dlp.v2.CustomInfoType.DictionaryH\x00\x12<\n\x05regex\x18\x03 \x01(\x0b\x32+.google.privacy.dlp.v2.CustomInfoType.RegexH\x00\x12M\n\x0esurrogate_type\x18\x04 \x01(\x0b\x32\x33.google.privacy.dlp.v2.CustomInfoType.SurrogateTypeH\x00\x12\x38\n\x0bstored_type\x18\x05 \x01(\x0b\x32!.google.privacy.dlp.v2.StoredTypeH\x00\x12L\n\x0f\x64\x65tection_rules\x18\x07 \x03(\x0b\x32\x33.google.privacy.dlp.v2.CustomInfoType.DetectionRule\x12K\n\x0e\x65xclusion_type\x18\x08 \x01(\x0e\x32\x33.google.privacy.dlp.v2.CustomInfoType.ExclusionType\x1a\xc8\x01\n\nDictionary\x12N\n\tword_list\x18\x01 \x01(\x0b\x32\x39.google.privacy.dlp.v2.CustomInfoType.Dictionary.WordListH\x00\x12\x45\n\x12\x63loud_storage_path\x18\x03 \x01(\x0b\x32\'.google.privacy.dlp.v2.CloudStoragePathH\x00\x1a\x19\n\x08WordList\x12\r\n\x05words\x18\x01 \x03(\tB\x08\n\x06source\x1a/\n\x05Regex\x12\x0f\n\x07pattern\x18\x01 \x01(\t\x12\x15\n\rgroup_indexes\x18\x02 \x03(\x05\x1a\x0f\n\rSurrogateType\x1a\xbe\x04\n\rDetectionRule\x12W\n\x0chotword_rule\x18\x01 \x01(\x0b\x32?.google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRuleH\x00\x1a\x38\n\tProximity\x12\x15\n\rwindow_before\x18\x01 \x01(\x05\x12\x14\n\x0cwindow_after\x18\x02 \x01(\x05\x1a\x82\x01\n\x14LikelihoodAdjustment\x12=\n\x10\x66ixed_likelihood\x18\x01 \x01(\x0e\x32!.google.privacy.dlp.v2.LikelihoodH\x00\x12\x1d\n\x13relative_likelihood\x18\x02 \x01(\x05H\x00\x42\x0c\n\nadjustment\x1a\x8c\x02\n\x0bHotwordRule\x12\x42\n\rhotword_regex\x18\x01 \x01(\x0b\x32+.google.privacy.dlp.v2.CustomInfoType.Regex\x12P\n\tproximity\x18\x02 \x01(\x0b\x32=.google.privacy.dlp.v2.CustomInfoType.DetectionRule.Proximity\x12g\n\x15likelihood_adjustment\x18\x03 \x01(\x0b\x32H.google.privacy.dlp.v2.CustomInfoType.DetectionRule.LikelihoodAdjustmentB\x06\n\x04type"K\n\rExclusionType\x12\x1e\n\x1a\x45XCLUSION_TYPE_UNSPECIFIED\x10\x00\x12\x1a\n\x16\x45XCLUSION_TYPE_EXCLUDE\x10\x01\x42\x06\n\x04type"\x17\n\x07\x46ieldId\x12\x0c\n\x04name\x18\x01 \x01(\t"7\n\x0bPartitionId\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x14\n\x0cnamespace_id\x18\x04 \x01(\t"\x1e\n\x0eKindExpression\x12\x0c\n\x04name\x18\x01 \x01(\t"\x81\x01\n\x10\x44\x61tastoreOptions\x12\x38\n\x0cpartition_id\x18\x01 \x01(\x0b\x32".google.privacy.dlp.v2.PartitionId\x12\x33\n\x04kind\x18\x02 \x01(\x0b\x32%.google.privacy.dlp.v2.KindExpression"]\n\x18\x43loudStorageRegexFileSet\x12\x13\n\x0b\x62ucket_name\x18\x01 \x01(\t\x12\x15\n\rinclude_regex\x18\x02 \x03(\t\x12\x15\n\rexclude_regex\x18\x03 \x03(\t"\xec\x03\n\x13\x43loudStorageOptions\x12\x44\n\x08\x66ile_set\x18\x01 \x01(\x0b\x32\x32.google.privacy.dlp.v2.CloudStorageOptions.FileSet\x12\x1c\n\x14\x62ytes_limit_per_file\x18\x04 \x01(\x03\x12$\n\x1c\x62ytes_limit_per_file_percent\x18\x08 \x01(\x05\x12\x33\n\nfile_types\x18\x05 \x03(\x0e\x32\x1f.google.privacy.dlp.v2.FileType\x12N\n\rsample_method\x18\x06 \x01(\x0e\x32\x37.google.privacy.dlp.v2.CloudStorageOptions.SampleMethod\x12\x1b\n\x13\x66iles_limit_percent\x18\x07 \x01(\x05\x1a_\n\x07\x46ileSet\x12\x0b\n\x03url\x18\x01 \x01(\t\x12G\n\x0eregex_file_set\x18\x02 \x01(\x0b\x32/.google.privacy.dlp.v2.CloudStorageRegexFileSet"H\n\x0cSampleMethod\x12\x1d\n\x19SAMPLE_METHOD_UNSPECIFIED\x10\x00\x12\x07\n\x03TOP\x10\x01\x12\x10\n\x0cRANDOM_START\x10\x02""\n\x13\x43loudStorageFileSet\x12\x0b\n\x03url\x18\x01 \x01(\t" \n\x10\x43loudStoragePath\x12\x0c\n\x04path\x18\x01 \x01(\t"\x8b\x03\n\x0f\x42igQueryOptions\x12=\n\x0ftable_reference\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12:\n\x12identifying_fields\x18\x02 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x12\n\nrows_limit\x18\x03 \x01(\x03\x12\x1a\n\x12rows_limit_percent\x18\x06 \x01(\x05\x12J\n\rsample_method\x18\x04 \x01(\x0e\x32\x33.google.privacy.dlp.v2.BigQueryOptions.SampleMethod\x12\x37\n\x0f\x65xcluded_fields\x18\x05 \x03(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId"H\n\x0cSampleMethod\x12\x1d\n\x19SAMPLE_METHOD_UNSPECIFIED\x10\x00\x12\x07\n\x03TOP\x10\x01\x12\x10\n\x0cRANDOM_START\x10\x02"\x9a\x04\n\rStorageConfig\x12\x44\n\x11\x64\x61tastore_options\x18\x02 \x01(\x0b\x32\'.google.privacy.dlp.v2.DatastoreOptionsH\x00\x12K\n\x15\x63loud_storage_options\x18\x03 \x01(\x0b\x32*.google.privacy.dlp.v2.CloudStorageOptionsH\x00\x12\x43\n\x11\x62ig_query_options\x18\x04 \x01(\x0b\x32&.google.privacy.dlp.v2.BigQueryOptionsH\x00\x12L\n\x0ftimespan_config\x18\x06 \x01(\x0b\x32\x33.google.privacy.dlp.v2.StorageConfig.TimespanConfig\x1a\xda\x01\n\x0eTimespanConfig\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x37\n\x0ftimestamp_field\x18\x03 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId\x12\x31\n)enable_auto_population_of_timespan_config\x18\x04 \x01(\x08\x42\x06\n\x04type"`\n\x0b\x42igQueryKey\x12=\n\x0ftable_reference\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12\x12\n\nrow_number\x18\x02 \x01(\x03">\n\x0c\x44\x61tastoreKey\x12.\n\nentity_key\x18\x01 \x01(\x0b\x32\x1a.google.privacy.dlp.v2.Key"\xbb\x01\n\x03Key\x12\x38\n\x0cpartition_id\x18\x01 \x01(\x0b\x32".google.privacy.dlp.v2.PartitionId\x12\x34\n\x04path\x18\x02 \x03(\x0b\x32&.google.privacy.dlp.v2.Key.PathElement\x1a\x44\n\x0bPathElement\x12\x0c\n\x04kind\x18\x01 \x01(\t\x12\x0c\n\x02id\x18\x02 \x01(\x03H\x00\x12\x0e\n\x04name\x18\x03 \x01(\tH\x00\x42\t\n\x07id_type"\xa1\x01\n\tRecordKey\x12<\n\rdatastore_key\x18\x02 \x01(\x0b\x32#.google.privacy.dlp.v2.DatastoreKeyH\x00\x12;\n\rbig_query_key\x18\x03 \x01(\x0b\x32".google.privacy.dlp.v2.BigQueryKeyH\x00\x12\x11\n\tid_values\x18\x05 \x03(\tB\x06\n\x04type"I\n\rBigQueryTable\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x12\n\ndataset_id\x18\x02 \x01(\t\x12\x10\n\x08table_id\x18\x03 \x01(\t"s\n\rBigQueryField\x12\x33\n\x05table\x18\x01 \x01(\x0b\x32$.google.privacy.dlp.v2.BigQueryTable\x12-\n\x05\x66ield\x18\x02 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId"9\n\x08\x45ntityId\x12-\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x1e.google.privacy.dlp.v2.FieldId*t\n\nLikelihood\x12\x1a\n\x16LIKELIHOOD_UNSPECIFIED\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05*Z\n\x08\x46ileType\x12\x19\n\x15\x46ILE_TYPE_UNSPECIFIED\x10\x00\x12\x0f\n\x0b\x42INARY_FILE\x10\x01\x12\r\n\tTEXT_FILE\x10\x02\x12\t\n\x05IMAGE\x10\x03\x12\x08\n\x04\x41VRO\x10\x07\x42\x8f\x01\n\x19\x63om.google.privacy.dlp.v2B\nDlpStorageP\x01Z8google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp\xaa\x02\x13Google.Cloud.Dlp.V2\xca\x02\x13Google\\Cloud\\Dlp\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.privacy.dlp.v2.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LIKELIHOOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4335,
+    serialized_end=4451,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+_FILETYPE = _descriptor.EnumDescriptor(
+    name="FileType",
+    full_name="google.privacy.dlp.v2.FileType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FILE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BINARY_FILE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_FILE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AVRO", index=4, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4453,
+    serialized_end=4543,
+)
+_sym_db.RegisterEnumDescriptor(_FILETYPE)
+
+FileType = enum_type_wrapper.EnumTypeWrapper(_FILETYPE)
+LIKELIHOOD_UNSPECIFIED = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+FILE_TYPE_UNSPECIFIED = 0
+BINARY_FILE = 1
+TEXT_FILE = 2
+IMAGE = 3
+AVRO = 7
+
+
+_CUSTOMINFOTYPE_EXCLUSIONTYPE = _descriptor.EnumDescriptor(
+    name="ExclusionType",
+    full_name="google.privacy.dlp.v2.CustomInfoType.ExclusionType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EXCLUSION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXCLUSION_TYPE_EXCLUDE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1638,
+    serialized_end=1713,
+)
+_sym_db.RegisterEnumDescriptor(_CUSTOMINFOTYPE_EXCLUSIONTYPE)
+
+_CLOUDSTORAGEOPTIONS_SAMPLEMETHOD = _descriptor.EnumDescriptor(
+    name="SampleMethod",
+    full_name="google.privacy.dlp.v2.CloudStorageOptions.SampleMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SAMPLE_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOP", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RANDOM_START", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2485,
+    serialized_end=2557,
+)
+_sym_db.RegisterEnumDescriptor(_CLOUDSTORAGEOPTIONS_SAMPLEMETHOD)
+
+_BIGQUERYOPTIONS_SAMPLEMETHOD = _descriptor.EnumDescriptor(
+    name="SampleMethod",
+    full_name="google.privacy.dlp.v2.BigQueryOptions.SampleMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SAMPLE_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOP", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RANDOM_START", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2485,
+    serialized_end=2557,
+)
+_sym_db.RegisterEnumDescriptor(_BIGQUERYOPTIONS_SAMPLEMETHOD)
+
+
+_INFOTYPE = _descriptor.Descriptor(
+    name="InfoType",
+    full_name="google.privacy.dlp.v2.InfoType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.InfoType.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=137,
+    serialized_end=161,
+)
+
+
+_STOREDTYPE = _descriptor.Descriptor(
+    name="StoredType",
+    full_name="google.privacy.dlp.v2.StoredType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.StoredType.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.privacy.dlp.v2.StoredType.create_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=163,
+    serialized_end=238,
+)
+
+
+_CUSTOMINFOTYPE_DICTIONARY_WORDLIST = _descriptor.Descriptor(
+    name="WordList",
+    full_name="google.privacy.dlp.v2.CustomInfoType.Dictionary.WordList",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.privacy.dlp.v2.CustomInfoType.Dictionary.WordList.words",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=958,
+    serialized_end=983,
+)
+
+_CUSTOMINFOTYPE_DICTIONARY = _descriptor.Descriptor(
+    name="Dictionary",
+    full_name="google.privacy.dlp.v2.CustomInfoType.Dictionary",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="word_list",
+            full_name="google.privacy.dlp.v2.CustomInfoType.Dictionary.word_list",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cloud_storage_path",
+            full_name="google.privacy.dlp.v2.CustomInfoType.Dictionary.cloud_storage_path",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CUSTOMINFOTYPE_DICTIONARY_WORDLIST],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.privacy.dlp.v2.CustomInfoType.Dictionary.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=793,
+    serialized_end=993,
+)
+
+_CUSTOMINFOTYPE_REGEX = _descriptor.Descriptor(
+    name="Regex",
+    full_name="google.privacy.dlp.v2.CustomInfoType.Regex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pattern",
+            full_name="google.privacy.dlp.v2.CustomInfoType.Regex.pattern",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_indexes",
+            full_name="google.privacy.dlp.v2.CustomInfoType.Regex.group_indexes",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=995,
+    serialized_end=1042,
+)
+
+_CUSTOMINFOTYPE_SURROGATETYPE = _descriptor.Descriptor(
+    name="SurrogateType",
+    full_name="google.privacy.dlp.v2.CustomInfoType.SurrogateType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1044,
+    serialized_end=1059,
+)
+
+_CUSTOMINFOTYPE_DETECTIONRULE_PROXIMITY = _descriptor.Descriptor(
+    name="Proximity",
+    full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.Proximity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="window_before",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.Proximity.window_before",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="window_after",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.Proximity.window_after",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1168,
+    serialized_end=1224,
+)
+
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT = _descriptor.Descriptor(
+    name="LikelihoodAdjustment",
+    full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.LikelihoodAdjustment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fixed_likelihood",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.LikelihoodAdjustment.fixed_likelihood",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_likelihood",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.LikelihoodAdjustment.relative_likelihood",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="adjustment",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.LikelihoodAdjustment.adjustment",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1227,
+    serialized_end=1357,
+)
+
+_CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE = _descriptor.Descriptor(
+    name="HotwordRule",
+    full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hotword_regex",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRule.hotword_regex",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="proximity",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRule.proximity",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="likelihood_adjustment",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRule.likelihood_adjustment",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1360,
+    serialized_end=1628,
+)
+
+_CUSTOMINFOTYPE_DETECTIONRULE = _descriptor.Descriptor(
+    name="DetectionRule",
+    full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hotword_rule",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.hotword_rule",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[
+        _CUSTOMINFOTYPE_DETECTIONRULE_PROXIMITY,
+        _CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT,
+        _CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.CustomInfoType.DetectionRule.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1062,
+    serialized_end=1636,
+)
+
+_CUSTOMINFOTYPE = _descriptor.Descriptor(
+    name="CustomInfoType",
+    full_name="google.privacy.dlp.v2.CustomInfoType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="info_type",
+            full_name="google.privacy.dlp.v2.CustomInfoType.info_type",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="likelihood",
+            full_name="google.privacy.dlp.v2.CustomInfoType.likelihood",
+            index=1,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dictionary",
+            full_name="google.privacy.dlp.v2.CustomInfoType.dictionary",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="regex",
+            full_name="google.privacy.dlp.v2.CustomInfoType.regex",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surrogate_type",
+            full_name="google.privacy.dlp.v2.CustomInfoType.surrogate_type",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stored_type",
+            full_name="google.privacy.dlp.v2.CustomInfoType.stored_type",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detection_rules",
+            full_name="google.privacy.dlp.v2.CustomInfoType.detection_rules",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclusion_type",
+            full_name="google.privacy.dlp.v2.CustomInfoType.exclusion_type",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _CUSTOMINFOTYPE_DICTIONARY,
+        _CUSTOMINFOTYPE_REGEX,
+        _CUSTOMINFOTYPE_SURROGATETYPE,
+        _CUSTOMINFOTYPE_DETECTIONRULE,
+    ],
+    enum_types=[_CUSTOMINFOTYPE_EXCLUSIONTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.CustomInfoType.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=241,
+    serialized_end=1721,
+)
+
+
+_FIELDID = _descriptor.Descriptor(
+    name="FieldId",
+    full_name="google.privacy.dlp.v2.FieldId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.FieldId.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1723,
+    serialized_end=1746,
+)
+
+
+_PARTITIONID = _descriptor.Descriptor(
+    name="PartitionId",
+    full_name="google.privacy.dlp.v2.PartitionId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.privacy.dlp.v2.PartitionId.project_id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="namespace_id",
+            full_name="google.privacy.dlp.v2.PartitionId.namespace_id",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1748,
+    serialized_end=1803,
+)
+
+
+_KINDEXPRESSION = _descriptor.Descriptor(
+    name="KindExpression",
+    full_name="google.privacy.dlp.v2.KindExpression",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.KindExpression.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1805,
+    serialized_end=1835,
+)
+
+
+_DATASTOREOPTIONS = _descriptor.Descriptor(
+    name="DatastoreOptions",
+    full_name="google.privacy.dlp.v2.DatastoreOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="partition_id",
+            full_name="google.privacy.dlp.v2.DatastoreOptions.partition_id",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.privacy.dlp.v2.DatastoreOptions.kind",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1838,
+    serialized_end=1967,
+)
+
+
+_CLOUDSTORAGEREGEXFILESET = _descriptor.Descriptor(
+    name="CloudStorageRegexFileSet",
+    full_name="google.privacy.dlp.v2.CloudStorageRegexFileSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bucket_name",
+            full_name="google.privacy.dlp.v2.CloudStorageRegexFileSet.bucket_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_regex",
+            full_name="google.privacy.dlp.v2.CloudStorageRegexFileSet.include_regex",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclude_regex",
+            full_name="google.privacy.dlp.v2.CloudStorageRegexFileSet.exclude_regex",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1969,
+    serialized_end=2062,
+)
+
+
+_CLOUDSTORAGEOPTIONS_FILESET = _descriptor.Descriptor(
+    name="FileSet",
+    full_name="google.privacy.dlp.v2.CloudStorageOptions.FileSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.FileSet.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="regex_file_set",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.FileSet.regex_file_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2388,
+    serialized_end=2483,
+)
+
+_CLOUDSTORAGEOPTIONS = _descriptor.Descriptor(
+    name="CloudStorageOptions",
+    full_name="google.privacy.dlp.v2.CloudStorageOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="file_set",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.file_set",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bytes_limit_per_file",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.bytes_limit_per_file",
+            index=1,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bytes_limit_per_file_percent",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.bytes_limit_per_file_percent",
+            index=2,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_types",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.file_types",
+            index=3,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sample_method",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.sample_method",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="files_limit_percent",
+            full_name="google.privacy.dlp.v2.CloudStorageOptions.files_limit_percent",
+            index=5,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CLOUDSTORAGEOPTIONS_FILESET],
+    enum_types=[_CLOUDSTORAGEOPTIONS_SAMPLEMETHOD],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2065,
+    serialized_end=2557,
+)
+
+
+_CLOUDSTORAGEFILESET = _descriptor.Descriptor(
+    name="CloudStorageFileSet",
+    full_name="google.privacy.dlp.v2.CloudStorageFileSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.privacy.dlp.v2.CloudStorageFileSet.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2559,
+    serialized_end=2593,
+)
+
+
+_CLOUDSTORAGEPATH = _descriptor.Descriptor(
+    name="CloudStoragePath",
+    full_name="google.privacy.dlp.v2.CloudStoragePath",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.privacy.dlp.v2.CloudStoragePath.path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2595,
+    serialized_end=2627,
+)
+
+
+_BIGQUERYOPTIONS = _descriptor.Descriptor(
+    name="BigQueryOptions",
+    full_name="google.privacy.dlp.v2.BigQueryOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_reference",
+            full_name="google.privacy.dlp.v2.BigQueryOptions.table_reference",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="identifying_fields",
+            full_name="google.privacy.dlp.v2.BigQueryOptions.identifying_fields",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows_limit",
+            full_name="google.privacy.dlp.v2.BigQueryOptions.rows_limit",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows_limit_percent",
+            full_name="google.privacy.dlp.v2.BigQueryOptions.rows_limit_percent",
+            index=3,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sample_method",
+            full_name="google.privacy.dlp.v2.BigQueryOptions.sample_method",
+            index=4,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="excluded_fields",
+            full_name="google.privacy.dlp.v2.BigQueryOptions.excluded_fields",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BIGQUERYOPTIONS_SAMPLEMETHOD],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2630,
+    serialized_end=3025,
+)
+
+
+_STORAGECONFIG_TIMESPANCONFIG = _descriptor.Descriptor(
+    name="TimespanConfig",
+    full_name="google.privacy.dlp.v2.StorageConfig.TimespanConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.privacy.dlp.v2.StorageConfig.TimespanConfig.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.privacy.dlp.v2.StorageConfig.TimespanConfig.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_field",
+            full_name="google.privacy.dlp.v2.StorageConfig.TimespanConfig.timestamp_field",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_auto_population_of_timespan_config",
+            full_name="google.privacy.dlp.v2.StorageConfig.TimespanConfig.enable_auto_population_of_timespan_config",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3340,
+    serialized_end=3558,
+)
+
+_STORAGECONFIG = _descriptor.Descriptor(
+    name="StorageConfig",
+    full_name="google.privacy.dlp.v2.StorageConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="datastore_options",
+            full_name="google.privacy.dlp.v2.StorageConfig.datastore_options",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cloud_storage_options",
+            full_name="google.privacy.dlp.v2.StorageConfig.cloud_storage_options",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="big_query_options",
+            full_name="google.privacy.dlp.v2.StorageConfig.big_query_options",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timespan_config",
+            full_name="google.privacy.dlp.v2.StorageConfig.timespan_config",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_STORAGECONFIG_TIMESPANCONFIG],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.StorageConfig.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3028,
+    serialized_end=3566,
+)
+
+
+_BIGQUERYKEY = _descriptor.Descriptor(
+    name="BigQueryKey",
+    full_name="google.privacy.dlp.v2.BigQueryKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table_reference",
+            full_name="google.privacy.dlp.v2.BigQueryKey.table_reference",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_number",
+            full_name="google.privacy.dlp.v2.BigQueryKey.row_number",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3568,
+    serialized_end=3664,
+)
+
+
+_DATASTOREKEY = _descriptor.Descriptor(
+    name="DatastoreKey",
+    full_name="google.privacy.dlp.v2.DatastoreKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_key",
+            full_name="google.privacy.dlp.v2.DatastoreKey.entity_key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3666,
+    serialized_end=3728,
+)
+
+
+_KEY_PATHELEMENT = _descriptor.Descriptor(
+    name="PathElement",
+    full_name="google.privacy.dlp.v2.Key.PathElement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.privacy.dlp.v2.Key.PathElement.kind",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.privacy.dlp.v2.Key.PathElement.id",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.privacy.dlp.v2.Key.PathElement.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="id_type",
+            full_name="google.privacy.dlp.v2.Key.PathElement.id_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3850,
+    serialized_end=3918,
+)
+
+_KEY = _descriptor.Descriptor(
+    name="Key",
+    full_name="google.privacy.dlp.v2.Key",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="partition_id",
+            full_name="google.privacy.dlp.v2.Key.partition_id",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.privacy.dlp.v2.Key.path",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_KEY_PATHELEMENT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3731,
+    serialized_end=3918,
+)
+
+
+_RECORDKEY = _descriptor.Descriptor(
+    name="RecordKey",
+    full_name="google.privacy.dlp.v2.RecordKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="datastore_key",
+            full_name="google.privacy.dlp.v2.RecordKey.datastore_key",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="big_query_key",
+            full_name="google.privacy.dlp.v2.RecordKey.big_query_key",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id_values",
+            full_name="google.privacy.dlp.v2.RecordKey.id_values",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.privacy.dlp.v2.RecordKey.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3921,
+    serialized_end=4082,
+)
+
+
+_BIGQUERYTABLE = _descriptor.Descriptor(
+    name="BigQueryTable",
+    full_name="google.privacy.dlp.v2.BigQueryTable",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.privacy.dlp.v2.BigQueryTable.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dataset_id",
+            full_name="google.privacy.dlp.v2.BigQueryTable.dataset_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table_id",
+            full_name="google.privacy.dlp.v2.BigQueryTable.table_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4084,
+    serialized_end=4157,
+)
+
+
+_BIGQUERYFIELD = _descriptor.Descriptor(
+    name="BigQueryField",
+    full_name="google.privacy.dlp.v2.BigQueryField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.privacy.dlp.v2.BigQueryField.table",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.BigQueryField.field",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4159,
+    serialized_end=4274,
+)
+
+
+_ENTITYID = _descriptor.Descriptor(
+    name="EntityId",
+    full_name="google.privacy.dlp.v2.EntityId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.privacy.dlp.v2.EntityId.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4276,
+    serialized_end=4333,
+)
+
+_STOREDTYPE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CUSTOMINFOTYPE_DICTIONARY_WORDLIST.containing_type = _CUSTOMINFOTYPE_DICTIONARY
+_CUSTOMINFOTYPE_DICTIONARY.fields_by_name[
+    "word_list"
+].message_type = _CUSTOMINFOTYPE_DICTIONARY_WORDLIST
+_CUSTOMINFOTYPE_DICTIONARY.fields_by_name[
+    "cloud_storage_path"
+].message_type = _CLOUDSTORAGEPATH
+_CUSTOMINFOTYPE_DICTIONARY.containing_type = _CUSTOMINFOTYPE
+_CUSTOMINFOTYPE_DICTIONARY.oneofs_by_name["source"].fields.append(
+    _CUSTOMINFOTYPE_DICTIONARY.fields_by_name["word_list"]
+)
+_CUSTOMINFOTYPE_DICTIONARY.fields_by_name[
+    "word_list"
+].containing_oneof = _CUSTOMINFOTYPE_DICTIONARY.oneofs_by_name["source"]
+_CUSTOMINFOTYPE_DICTIONARY.oneofs_by_name["source"].fields.append(
+    _CUSTOMINFOTYPE_DICTIONARY.fields_by_name["cloud_storage_path"]
+)
+_CUSTOMINFOTYPE_DICTIONARY.fields_by_name[
+    "cloud_storage_path"
+].containing_oneof = _CUSTOMINFOTYPE_DICTIONARY.oneofs_by_name["source"]
+_CUSTOMINFOTYPE_REGEX.containing_type = _CUSTOMINFOTYPE
+_CUSTOMINFOTYPE_SURROGATETYPE.containing_type = _CUSTOMINFOTYPE
+_CUSTOMINFOTYPE_DETECTIONRULE_PROXIMITY.containing_type = _CUSTOMINFOTYPE_DETECTIONRULE
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.fields_by_name[
+    "fixed_likelihood"
+].enum_type = _LIKELIHOOD
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.containing_type = (
+    _CUSTOMINFOTYPE_DETECTIONRULE
+)
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.oneofs_by_name[
+    "adjustment"
+].fields.append(
+    _CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.fields_by_name[
+        "fixed_likelihood"
+    ]
+)
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.fields_by_name[
+    "fixed_likelihood"
+].containing_oneof = _CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.oneofs_by_name[
+    "adjustment"
+]
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.oneofs_by_name[
+    "adjustment"
+].fields.append(
+    _CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.fields_by_name[
+        "relative_likelihood"
+    ]
+)
+_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.fields_by_name[
+    "relative_likelihood"
+].containing_oneof = _CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT.oneofs_by_name[
+    "adjustment"
+]
+_CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE.fields_by_name[
+    "hotword_regex"
+].message_type = _CUSTOMINFOTYPE_REGEX
+_CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE.fields_by_name[
+    "proximity"
+].message_type = _CUSTOMINFOTYPE_DETECTIONRULE_PROXIMITY
+_CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE.fields_by_name[
+    "likelihood_adjustment"
+].message_type = _CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT
+_CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE.containing_type = (
+    _CUSTOMINFOTYPE_DETECTIONRULE
+)
+_CUSTOMINFOTYPE_DETECTIONRULE.fields_by_name[
+    "hotword_rule"
+].message_type = _CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE
+_CUSTOMINFOTYPE_DETECTIONRULE.containing_type = _CUSTOMINFOTYPE
+_CUSTOMINFOTYPE_DETECTIONRULE.oneofs_by_name["type"].fields.append(
+    _CUSTOMINFOTYPE_DETECTIONRULE.fields_by_name["hotword_rule"]
+)
+_CUSTOMINFOTYPE_DETECTIONRULE.fields_by_name[
+    "hotword_rule"
+].containing_oneof = _CUSTOMINFOTYPE_DETECTIONRULE.oneofs_by_name["type"]
+_CUSTOMINFOTYPE.fields_by_name["info_type"].message_type = _INFOTYPE
+_CUSTOMINFOTYPE.fields_by_name["likelihood"].enum_type = _LIKELIHOOD
+_CUSTOMINFOTYPE.fields_by_name["dictionary"].message_type = _CUSTOMINFOTYPE_DICTIONARY
+_CUSTOMINFOTYPE.fields_by_name["regex"].message_type = _CUSTOMINFOTYPE_REGEX
+_CUSTOMINFOTYPE.fields_by_name[
+    "surrogate_type"
+].message_type = _CUSTOMINFOTYPE_SURROGATETYPE
+_CUSTOMINFOTYPE.fields_by_name["stored_type"].message_type = _STOREDTYPE
+_CUSTOMINFOTYPE.fields_by_name[
+    "detection_rules"
+].message_type = _CUSTOMINFOTYPE_DETECTIONRULE
+_CUSTOMINFOTYPE.fields_by_name[
+    "exclusion_type"
+].enum_type = _CUSTOMINFOTYPE_EXCLUSIONTYPE
+_CUSTOMINFOTYPE_EXCLUSIONTYPE.containing_type = _CUSTOMINFOTYPE
+_CUSTOMINFOTYPE.oneofs_by_name["type"].fields.append(
+    _CUSTOMINFOTYPE.fields_by_name["dictionary"]
+)
+_CUSTOMINFOTYPE.fields_by_name[
+    "dictionary"
+].containing_oneof = _CUSTOMINFOTYPE.oneofs_by_name["type"]
+_CUSTOMINFOTYPE.oneofs_by_name["type"].fields.append(
+    _CUSTOMINFOTYPE.fields_by_name["regex"]
+)
+_CUSTOMINFOTYPE.fields_by_name[
+    "regex"
+].containing_oneof = _CUSTOMINFOTYPE.oneofs_by_name["type"]
+_CUSTOMINFOTYPE.oneofs_by_name["type"].fields.append(
+    _CUSTOMINFOTYPE.fields_by_name["surrogate_type"]
+)
+_CUSTOMINFOTYPE.fields_by_name[
+    "surrogate_type"
+].containing_oneof = _CUSTOMINFOTYPE.oneofs_by_name["type"]
+_CUSTOMINFOTYPE.oneofs_by_name["type"].fields.append(
+    _CUSTOMINFOTYPE.fields_by_name["stored_type"]
+)
+_CUSTOMINFOTYPE.fields_by_name[
+    "stored_type"
+].containing_oneof = _CUSTOMINFOTYPE.oneofs_by_name["type"]
+_DATASTOREOPTIONS.fields_by_name["partition_id"].message_type = _PARTITIONID
+_DATASTOREOPTIONS.fields_by_name["kind"].message_type = _KINDEXPRESSION
+_CLOUDSTORAGEOPTIONS_FILESET.fields_by_name[
+    "regex_file_set"
+].message_type = _CLOUDSTORAGEREGEXFILESET
+_CLOUDSTORAGEOPTIONS_FILESET.containing_type = _CLOUDSTORAGEOPTIONS
+_CLOUDSTORAGEOPTIONS.fields_by_name[
+    "file_set"
+].message_type = _CLOUDSTORAGEOPTIONS_FILESET
+_CLOUDSTORAGEOPTIONS.fields_by_name["file_types"].enum_type = _FILETYPE
+_CLOUDSTORAGEOPTIONS.fields_by_name[
+    "sample_method"
+].enum_type = _CLOUDSTORAGEOPTIONS_SAMPLEMETHOD
+_CLOUDSTORAGEOPTIONS_SAMPLEMETHOD.containing_type = _CLOUDSTORAGEOPTIONS
+_BIGQUERYOPTIONS.fields_by_name["table_reference"].message_type = _BIGQUERYTABLE
+_BIGQUERYOPTIONS.fields_by_name["identifying_fields"].message_type = _FIELDID
+_BIGQUERYOPTIONS.fields_by_name[
+    "sample_method"
+].enum_type = _BIGQUERYOPTIONS_SAMPLEMETHOD
+_BIGQUERYOPTIONS.fields_by_name["excluded_fields"].message_type = _FIELDID
+_BIGQUERYOPTIONS_SAMPLEMETHOD.containing_type = _BIGQUERYOPTIONS
+_STORAGECONFIG_TIMESPANCONFIG.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STORAGECONFIG_TIMESPANCONFIG.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STORAGECONFIG_TIMESPANCONFIG.fields_by_name["timestamp_field"].message_type = _FIELDID
+_STORAGECONFIG_TIMESPANCONFIG.containing_type = _STORAGECONFIG
+_STORAGECONFIG.fields_by_name["datastore_options"].message_type = _DATASTOREOPTIONS
+_STORAGECONFIG.fields_by_name[
+    "cloud_storage_options"
+].message_type = _CLOUDSTORAGEOPTIONS
+_STORAGECONFIG.fields_by_name["big_query_options"].message_type = _BIGQUERYOPTIONS
+_STORAGECONFIG.fields_by_name[
+    "timespan_config"
+].message_type = _STORAGECONFIG_TIMESPANCONFIG
+_STORAGECONFIG.oneofs_by_name["type"].fields.append(
+    _STORAGECONFIG.fields_by_name["datastore_options"]
+)
+_STORAGECONFIG.fields_by_name[
+    "datastore_options"
+].containing_oneof = _STORAGECONFIG.oneofs_by_name["type"]
+_STORAGECONFIG.oneofs_by_name["type"].fields.append(
+    _STORAGECONFIG.fields_by_name["cloud_storage_options"]
+)
+_STORAGECONFIG.fields_by_name[
+    "cloud_storage_options"
+].containing_oneof = _STORAGECONFIG.oneofs_by_name["type"]
+_STORAGECONFIG.oneofs_by_name["type"].fields.append(
+    _STORAGECONFIG.fields_by_name["big_query_options"]
+)
+_STORAGECONFIG.fields_by_name[
+    "big_query_options"
+].containing_oneof = _STORAGECONFIG.oneofs_by_name["type"]
+_BIGQUERYKEY.fields_by_name["table_reference"].message_type = _BIGQUERYTABLE
+_DATASTOREKEY.fields_by_name["entity_key"].message_type = _KEY
+_KEY_PATHELEMENT.containing_type = _KEY
+_KEY_PATHELEMENT.oneofs_by_name["id_type"].fields.append(
+    _KEY_PATHELEMENT.fields_by_name["id"]
+)
+_KEY_PATHELEMENT.fields_by_name[
+    "id"
+].containing_oneof = _KEY_PATHELEMENT.oneofs_by_name["id_type"]
+_KEY_PATHELEMENT.oneofs_by_name["id_type"].fields.append(
+    _KEY_PATHELEMENT.fields_by_name["name"]
+)
+_KEY_PATHELEMENT.fields_by_name[
+    "name"
+].containing_oneof = _KEY_PATHELEMENT.oneofs_by_name["id_type"]
+_KEY.fields_by_name["partition_id"].message_type = _PARTITIONID
+_KEY.fields_by_name["path"].message_type = _KEY_PATHELEMENT
+_RECORDKEY.fields_by_name["datastore_key"].message_type = _DATASTOREKEY
+_RECORDKEY.fields_by_name["big_query_key"].message_type = _BIGQUERYKEY
+_RECORDKEY.oneofs_by_name["type"].fields.append(
+    _RECORDKEY.fields_by_name["datastore_key"]
+)
+_RECORDKEY.fields_by_name["datastore_key"].containing_oneof = _RECORDKEY.oneofs_by_name[
+    "type"
+]
+_RECORDKEY.oneofs_by_name["type"].fields.append(
+    _RECORDKEY.fields_by_name["big_query_key"]
+)
+_RECORDKEY.fields_by_name["big_query_key"].containing_oneof = _RECORDKEY.oneofs_by_name[
+    "type"
+]
+_BIGQUERYFIELD.fields_by_name["table"].message_type = _BIGQUERYTABLE
+_BIGQUERYFIELD.fields_by_name["field"].message_type = _FIELDID
+_ENTITYID.fields_by_name["field"].message_type = _FIELDID
+DESCRIPTOR.message_types_by_name["InfoType"] = _INFOTYPE
+DESCRIPTOR.message_types_by_name["StoredType"] = _STOREDTYPE
+DESCRIPTOR.message_types_by_name["CustomInfoType"] = _CUSTOMINFOTYPE
+DESCRIPTOR.message_types_by_name["FieldId"] = _FIELDID
+DESCRIPTOR.message_types_by_name["PartitionId"] = _PARTITIONID
+DESCRIPTOR.message_types_by_name["KindExpression"] = _KINDEXPRESSION
+DESCRIPTOR.message_types_by_name["DatastoreOptions"] = _DATASTOREOPTIONS
+DESCRIPTOR.message_types_by_name["CloudStorageRegexFileSet"] = _CLOUDSTORAGEREGEXFILESET
+DESCRIPTOR.message_types_by_name["CloudStorageOptions"] = _CLOUDSTORAGEOPTIONS
+DESCRIPTOR.message_types_by_name["CloudStorageFileSet"] = _CLOUDSTORAGEFILESET
+DESCRIPTOR.message_types_by_name["CloudStoragePath"] = _CLOUDSTORAGEPATH
+DESCRIPTOR.message_types_by_name["BigQueryOptions"] = _BIGQUERYOPTIONS
+DESCRIPTOR.message_types_by_name["StorageConfig"] = _STORAGECONFIG
+DESCRIPTOR.message_types_by_name["BigQueryKey"] = _BIGQUERYKEY
+DESCRIPTOR.message_types_by_name["DatastoreKey"] = _DATASTOREKEY
+DESCRIPTOR.message_types_by_name["Key"] = _KEY
+DESCRIPTOR.message_types_by_name["RecordKey"] = _RECORDKEY
+DESCRIPTOR.message_types_by_name["BigQueryTable"] = _BIGQUERYTABLE
+DESCRIPTOR.message_types_by_name["BigQueryField"] = _BIGQUERYFIELD
+DESCRIPTOR.message_types_by_name["EntityId"] = _ENTITYID
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+DESCRIPTOR.enum_types_by_name["FileType"] = _FILETYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+InfoType = _reflection.GeneratedProtocolMessageType(
+    "InfoType",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INFOTYPE,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Type of information detected by the API.
+  
+  
+  Attributes:
+      name:
+          Name of the information type. Either a name of your choosing
+          when 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}.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.InfoType)
+    ),
+)
+_sym_db.RegisterMessage(InfoType)
+
+StoredType = _reflection.GeneratedProtocolMessageType(
+    "StoredType",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOREDTYPE,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""A reference to a StoredInfoType to use with scanning.
+  
+  
+  Attributes:
+      name:
+          Resource name of the requested ``StoredInfoType``, for example
+          ``organizations/433245324/storedInfoTypes/432452342`` or
+          ``projects/project-id/storedInfoTypes/432452342``.
+      create_time:
+          Timestamp indicating when the version of the
+          ``StoredInfoType`` used for inspection was created. Output-
+          only field, populated by the system.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StoredType)
+    ),
+)
+_sym_db.RegisterMessage(StoredType)
+
+CustomInfoType = _reflection.GeneratedProtocolMessageType(
+    "CustomInfoType",
+    (_message.Message,),
+    dict(
+        Dictionary=_reflection.GeneratedProtocolMessageType(
+            "Dictionary",
+            (_message.Message,),
+            dict(
+                WordList=_reflection.GeneratedProtocolMessageType(
+                    "WordList",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_CUSTOMINFOTYPE_DICTIONARY_WORDLIST,
+                        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                        __doc__="""Message defining a list of words or phrases to search for in the data.
+      
+      
+      Attributes:
+          words:
+              Words or phrases defining the dictionary. The dictionary must
+              contain at least one phrase and every phrase must contain at
+              least 2 characters that are letters or digits. [required]
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.Dictionary.WordList)
+                    ),
+                ),
+                DESCRIPTOR=_CUSTOMINFOTYPE_DICTIONARY,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""Custom information type based on a dictionary of words or phrases. This
+    can be used to match sensitive information specific to the data, such as
+    a list of employee IDs or job titles.
+    
+    Dictionary words are case-insensitive and all characters other than
+    letters and digits in the unicode `Basic Multilingual
+    Plane <https://en.wikipedia.org/wiki/Plane_%28Unicode%29#Basic_Multilingual_Plane>`__
+    will be replaced with whitespace when scanning for matches, so the
+    dictionary phrase "Sam Johnson" will match all three phrases "sam
+    johnson", "Sam, Johnson", and "Sam (Johnson)". Additionally, the
+    characters surrounding any match must be of a different type than the
+    adjacent characters within the word, so letters must be next to
+    non-letters and digits next to non-digits. For example, the dictionary
+    word "jen" will match the first three letters of the text "jen123" but
+    will return no matches for "jennifer".
+    
+    Dictionary words containing a large number of characters that are not
+    letters or digits may result in unexpected findings because such
+    characters are treated as whitespace. The
+    `limits <https://cloud.google.com/dlp/limits>`__ page contains details
+    about the size limits of dictionaries. For dictionaries that do not fit
+    within these constraints, consider using ``LargeCustomDictionaryConfig``
+    in the ``StoredInfoType`` API.
+    
+    
+    Attributes:
+        word_list:
+            List of words or phrases to search for.
+        cloud_storage_path:
+            Newline-delimited file of words in Cloud Storage. Only a
+            single file is accepted.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.Dictionary)
+            ),
+        ),
+        Regex=_reflection.GeneratedProtocolMessageType(
+            "Regex",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CUSTOMINFOTYPE_REGEX,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""Message defining a custom regular expression.
+    
+    
+    Attributes:
+        pattern:
+            Pattern defining the regular expression. Its syntax
+            (https://github.com/google/re2/wiki/Syntax) can be found under
+            the google/re2 repository on GitHub.
+        group_indexes:
+            The index of the submatch to extract as findings. When not
+            specified, the entire match is returned. No more than 3 may be
+            included.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.Regex)
+            ),
+        ),
+        SurrogateType=_reflection.GeneratedProtocolMessageType(
+            "SurrogateType",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CUSTOMINFOTYPE_SURROGATETYPE,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""Message for detecting output from deidentification transformations such
+    as
+    ```CryptoReplaceFfxFpeConfig`` </dlp/docs/reference/rest/v2/organizations.deidentifyTemplates#cryptoreplaceffxfpeconfig>`__.
+    These types of transformations are those that perform pseudonymization,
+    thereby producing a "surrogate" as output. This should be used in
+    conjunction with a field on the transformation such as
+    ``surrogate_info_type``. This CustomInfoType does not support the use of
+    ``detection_rules``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.SurrogateType)
+            ),
+        ),
+        DetectionRule=_reflection.GeneratedProtocolMessageType(
+            "DetectionRule",
+            (_message.Message,),
+            dict(
+                Proximity=_reflection.GeneratedProtocolMessageType(
+                    "Proximity",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_CUSTOMINFOTYPE_DETECTIONRULE_PROXIMITY,
+                        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                        __doc__="""Message for specifying a window around a finding to apply a detection
+      rule.
+      
+      
+      Attributes:
+          window_before:
+              Number of characters before the finding to consider.
+          window_after:
+              Number of characters after the finding to consider.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.DetectionRule.Proximity)
+                    ),
+                ),
+                LikelihoodAdjustment=_reflection.GeneratedProtocolMessageType(
+                    "LikelihoodAdjustment",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_CUSTOMINFOTYPE_DETECTIONRULE_LIKELIHOODADJUSTMENT,
+                        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                        __doc__="""Message for specifying an adjustment to the likelihood of a finding as
+      part of a detection rule.
+      
+      
+      Attributes:
+          fixed_likelihood:
+              Set the likelihood of a finding to a fixed value.
+          relative_likelihood:
+              Increase or decrease the likelihood by the specified number of
+              levels. For example, if a finding would be ``POSSIBLE``
+              without the detection rule and ``relative_likelihood`` is 1,
+              then it is upgraded to ``LIKELY``, while a value of -1 would
+              downgrade it to ``UNLIKELY``. Likelihood may never drop below
+              ``VERY_UNLIKELY`` or exceed ``VERY_LIKELY``, so applying an
+              adjustment of 1 followed by an adjustment of -1 when base
+              likelihood is ``VERY_LIKELY`` will result in a final
+              likelihood of ``LIKELY``.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.DetectionRule.LikelihoodAdjustment)
+                    ),
+                ),
+                HotwordRule=_reflection.GeneratedProtocolMessageType(
+                    "HotwordRule",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_CUSTOMINFOTYPE_DETECTIONRULE_HOTWORDRULE,
+                        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                        __doc__="""The rule that adjusts the likelihood of findings within a certain
+      proximity of hotwords.
+      
+      
+      Attributes:
+          hotword_regex: \
+              Regular expression pattern defining what qualifies as a \
+              hotword.
+          proximity:
+              Proximity of the finding within which the entire hotword must
+              reside. The total length of the window cannot exceed 1000
+              characters. Note that the finding itself will be included in
+              the window, so that hotwords may be used to match substrings
+              of the finding itself. For example, the certainty of a phone
+              number regex "(\d\{3\}) \d\{3\}-\d\{4\} "\
+              could be adjusted upwards if the area code is \
+              known to be the local area code of a company office using the
+              hotword regex "(xxx)", where "xxx" is the area code in
+              question.
+          likelihood_adjustment: \
+              Likelihood adjustment to apply to all matching findings.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.DetectionRule.HotwordRule)
+                    ),
+                ),
+                DESCRIPTOR=_CUSTOMINFOTYPE_DETECTIONRULE,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""Deprecated; use ``InspectionRuleSet`` instead. Rule for modifying a
+    ``CustomInfoType`` to alter behavior under certain circumstances,
+    depending on the specific details of the rule. Not supported for the
+    ``surrogate_type`` custom infoType.
+    
+    
+    Attributes:
+        hotword_rule:
+            Hotword-based detection rule.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType.DetectionRule)
+            ),
+        ),
+        DESCRIPTOR=_CUSTOMINFOTYPE,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Custom information type provided by the user. Used to find
+  domain-specific sensitive information configurable to the data in
+  question.
+  
+  
+  Attributes:
+      info_type:
+          CustomInfoType can either be a new infoType, or an extension
+          of built-in infoType, when the name matches one of existing
+          infoTypes and that infoType is specified in
+          ``InspectContent.info_types`` field. Specifying the latter
+          adds findings to the one detected by the system. If built-in
+          info type is not specified in ``InspectContent.info_types``
+          list then the name is treated as a custom info type.
+      likelihood:
+          Likelihood to return for this CustomInfoType. This base value
+          can be altered by a detection rule if the finding meets the
+          criteria specified by the rule. Defaults to ``VERY_LIKELY`` if
+          not specified.
+      dictionary:
+          A list of phrases to detect as a CustomInfoType.
+      regex:
+          Regular expression based CustomInfoType.
+      surrogate_type:
+          Message for detecting output from deidentification
+          transformations that support reversing.
+      stored_type:
+          Load an existing ``StoredInfoType`` resource for use in
+          ``InspectDataSource``. Not currently supported in
+          ``InspectContent``.
+      detection_rules:
+          Set of detection rules to apply to all findings of this
+          CustomInfoType. Rules are applied in order that they are
+          specified. Not supported for the ``surrogate_type``
+          CustomInfoType.
+      exclusion_type:
+          If set to EXCLUSION\_TYPE\_EXCLUDE this infoType will not
+          cause a finding to be returned. It still can be used for rules
+          matching.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CustomInfoType)
+    ),
+)
+_sym_db.RegisterMessage(CustomInfoType)
+_sym_db.RegisterMessage(CustomInfoType.Dictionary)
+_sym_db.RegisterMessage(CustomInfoType.Dictionary.WordList)
+_sym_db.RegisterMessage(CustomInfoType.Regex)
+_sym_db.RegisterMessage(CustomInfoType.SurrogateType)
+_sym_db.RegisterMessage(CustomInfoType.DetectionRule)
+_sym_db.RegisterMessage(CustomInfoType.DetectionRule.Proximity)
+_sym_db.RegisterMessage(CustomInfoType.DetectionRule.LikelihoodAdjustment)
+_sym_db.RegisterMessage(CustomInfoType.DetectionRule.HotwordRule)
+
+FieldId = _reflection.GeneratedProtocolMessageType(
+    "FieldId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FIELDID,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""General identifier of a data field in a storage service.
+  
+  
+  Attributes:
+      name:
+          Name describing the field.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.FieldId)
+    ),
+)
+_sym_db.RegisterMessage(FieldId)
+
+PartitionId = _reflection.GeneratedProtocolMessageType(
+    "PartitionId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTITIONID,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Datastore partition ID. A partition ID identifies a grouping of
+  entities. The grouping is always by project and namespace, however the
+  namespace ID may be empty.
+  
+  A partition ID contains several dimensions: project ID and namespace ID.
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project to which the entities belong.
+      namespace_id:
+          If not empty, the ID of the namespace to which the entities
+          belong.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.PartitionId)
+    ),
+)
+_sym_db.RegisterMessage(PartitionId)
+
+KindExpression = _reflection.GeneratedProtocolMessageType(
+    "KindExpression",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KINDEXPRESSION,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""A representation of a Datastore kind.
+  
+  
+  Attributes:
+      name:
+          The name of the kind.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.KindExpression)
+    ),
+)
+_sym_db.RegisterMessage(KindExpression)
+
+DatastoreOptions = _reflection.GeneratedProtocolMessageType(
+    "DatastoreOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASTOREOPTIONS,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Options defining a data set within Google Cloud Datastore.
+  
+  
+  Attributes:
+      partition_id:
+          A partition ID identifies a grouping of entities. The grouping
+          is always by project and namespace, however the namespace ID
+          may be empty.
+      kind:
+          The kind to process.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DatastoreOptions)
+    ),
+)
+_sym_db.RegisterMessage(DatastoreOptions)
+
+CloudStorageRegexFileSet = _reflection.GeneratedProtocolMessageType(
+    "CloudStorageRegexFileSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLOUDSTORAGEREGEXFILESET,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Message representing a set of files in a Cloud Storage bucket. Regular
+  expressions are used to allow fine-grained control over which files in
+  the bucket to include.
+  
+  Included files are those that match at least one item in
+  ``include_regex`` and do not match any items in ``exclude_regex``. Note
+  that a file that matches items from both lists will *not* be included.
+  For a match to occur, the entire file path (i.e., everything in the url
+  after the bucket name) must match the regular expression.
+  
+  For example, given the input
+  ``{bucket_name: "mybucket", include_regex: ["directory1/.*"], exclude_regex: ["directory1/excluded.*"]}``:
+  
+  -  ``gs://mybucket/directory1/myfile`` will be included
+  -  ``gs://mybucket/directory1/directory2/myfile`` will be included
+     (``.*`` matches across ``/``)
+  -  ``gs://mybucket/directory0/directory1/myfile`` will *not* be included
+     (the full path doesn't match any items in ``include_regex``)
+  -  ``gs://mybucket/directory1/excludedfile`` will *not* be included (the
+     path matches an item in ``exclude_regex``)
+  
+  If ``include_regex`` is left empty, it will match all files by default
+  (this is equivalent to setting ``include_regex: [".*"]``).
+  
+  Some other common use cases:
+  
+  -  ``{bucket_name: "mybucket", exclude_regex: [".*\.pdf"]}`` will
+     include all files in ``mybucket`` except for .pdf files
+  -  ``{bucket_name: "mybucket", include_regex: ["directory/[^/]+"]}``
+     will include all files directly under ``gs://mybucket/directory/``,
+     without matching across ``/``
+  
+  
+  Attributes:
+      bucket_name:
+          The name of a Cloud Storage bucket. Required.
+      include_regex:
+          A list of regular expressions matching file paths to include.
+          All files in the bucket that match at least one of these
+          regular expressions will be included in the set of files,
+          except for those that also match an item in ``exclude_regex``.
+          Leaving this field empty will match all files by default (this
+          is equivalent to including ``.*`` in the list).  Regular
+          expressions use RE2 `syntax
+          <https://github.com/google/re2/wiki/Syntax>`__; a guide can be
+          found under the google/re2 repository on GitHub.
+      exclude_regex:
+          A list of regular expressions matching file paths to exclude.
+          All files in the bucket that match at least one of these
+          regular expressions will be excluded from the scan.  Regular
+          expressions use RE2 `syntax
+          <https://github.com/google/re2/wiki/Syntax>`__; a guide can be
+          found under the google/re2 repository on GitHub.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CloudStorageRegexFileSet)
+    ),
+)
+_sym_db.RegisterMessage(CloudStorageRegexFileSet)
+
+CloudStorageOptions = _reflection.GeneratedProtocolMessageType(
+    "CloudStorageOptions",
+    (_message.Message,),
+    dict(
+        FileSet=_reflection.GeneratedProtocolMessageType(
+            "FileSet",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CLOUDSTORAGEOPTIONS_FILESET,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""Set of files to scan.
+    
+    
+    Attributes:
+        url:
+            The Cloud Storage url of the file(s) to scan, in the format
+            ``gs://<bucket>/<path>``. Trailing wildcard in the path is
+            allowed.  If the url ends in a trailing slash, the bucket or
+            directory represented by the url will be scanned non-
+            recursively (content in sub-directories will not be scanned).
+            This means that ``gs://mybucket/`` is equivalent to
+            ``gs://mybucket/*``, and ``gs://mybucket/directory/`` is
+            equivalent to ``gs://mybucket/directory/*``.  Exactly one of
+            ``url`` or ``regex_file_set`` must be set.
+        regex_file_set:
+            The regex-filtered set of files to scan. Exactly one of
+            ``url`` or ``regex_file_set`` must be set.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CloudStorageOptions.FileSet)
+            ),
+        ),
+        DESCRIPTOR=_CLOUDSTORAGEOPTIONS,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Options defining a file or a set of files within a Google Cloud Storage
+  bucket.
+  
+  
+  Attributes:
+      file_set:
+          The set of one or more files to scan.
+      bytes_limit_per_file:
+          Max number of bytes to scan from a file. If a scanned file's
+          size is bigger than this value then the rest of the bytes are
+          omitted. Only one of bytes\_limit\_per\_file and
+          bytes\_limit\_per\_file\_percent can be specified.
+      bytes_limit_per_file_percent:
+          Max percentage of bytes to scan from a file. The rest are
+          omitted. The number of bytes scanned is rounded down. Must be
+          between 0 and 100, inclusively. Both 0 and 100 means no limit.
+          Defaults to 0. Only one of bytes\_limit\_per\_file and
+          bytes\_limit\_per\_file\_percent can be specified.
+      file_types:
+          List of file type groups to include in the scan. 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.
+      files_limit_percent:
+          Limits the number of files to scan to this percentage of the
+          input FileSet. Number of files scanned is rounded down. Must
+          be between 0 and 100, inclusively. Both 0 and 100 means no
+          limit. Defaults to 0.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CloudStorageOptions)
+    ),
+)
+_sym_db.RegisterMessage(CloudStorageOptions)
+_sym_db.RegisterMessage(CloudStorageOptions.FileSet)
+
+CloudStorageFileSet = _reflection.GeneratedProtocolMessageType(
+    "CloudStorageFileSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLOUDSTORAGEFILESET,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Message representing a set of files in Cloud Storage.
+  
+  
+  Attributes:
+      url:
+          The url, in the format ``gs://<bucket>/<path>``. Trailing
+          wildcard in the path is allowed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CloudStorageFileSet)
+    ),
+)
+_sym_db.RegisterMessage(CloudStorageFileSet)
+
+CloudStoragePath = _reflection.GeneratedProtocolMessageType(
+    "CloudStoragePath",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLOUDSTORAGEPATH,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Message representing a single file or path in Cloud Storage.
+  
+  
+  Attributes:
+      path:
+          A url representing a file or path (no wildcards) in Cloud
+          Storage. Example: gs://[BUCKET\_NAME]/dictionary.txt
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.CloudStoragePath)
+    ),
+)
+_sym_db.RegisterMessage(CloudStoragePath)
+
+BigQueryOptions = _reflection.GeneratedProtocolMessageType(
+    "BigQueryOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYOPTIONS,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Options defining BigQuery table and row identifiers.
+  
+  
+  Attributes:
+      table_reference:
+          Complete BigQuery table reference.
+      identifying_fields:
+          References to fields uniquely identifying rows within the
+          table. Nested fields in the format, like
+          ``person.birthdate.year``, are allowed.
+      rows_limit:
+          Max number of rows to scan. If the table has more rows than
+          this value, the rest of the rows are omitted. If not set, or
+          if set to 0, all rows will be scanned. Only one of rows\_limit
+          and rows\_limit\_percent can be specified. Cannot be used in
+          conjunction with TimespanConfig.
+      rows_limit_percent:
+          Max percentage of rows to scan. The rest are omitted. The
+          number of rows scanned is rounded down. Must be between 0 and
+          100, inclusively. Both 0 and 100 means no limit. Defaults to
+          0. Only one of rows\_limit and rows\_limit\_percent can be
+          specified. Cannot be used in conjunction with TimespanConfig.
+      excluded_fields:
+          References to fields excluded from scanning. This allows you
+          to skip inspection of entire columns which you know have no
+          findings.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BigQueryOptions)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryOptions)
+
+StorageConfig = _reflection.GeneratedProtocolMessageType(
+    "StorageConfig",
+    (_message.Message,),
+    dict(
+        TimespanConfig=_reflection.GeneratedProtocolMessageType(
+            "TimespanConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STORAGECONFIG_TIMESPANCONFIG,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""Configuration of the timespan of the items to include in scanning.
+    Currently only supported when inspecting Google Cloud Storage and
+    BigQuery.
+    
+    
+    Attributes:
+        start_time:
+            Exclude files or rows older than this value.
+        end_time:
+            Exclude files or rows newer than this value. If set to zero,
+            no upper time limit is applied.
+        timestamp_field:
+            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.
+        enable_auto_population_of_timespan_config:
+            When the job is started by a JobTrigger we will automatically
+            figure out a valid start\_time to avoid scanning files that
+            have not been modified since the last time the JobTrigger
+            executed. This will be based on the time of the execution of
+            the last run of the JobTrigger.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StorageConfig.TimespanConfig)
+            ),
+        ),
+        DESCRIPTOR=_STORAGECONFIG,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Shared message indicating Cloud storage type.
+  
+  
+  Attributes:
+      datastore_options:
+          Google Cloud Datastore options specification.
+      cloud_storage_options:
+          Google Cloud Storage options specification.
+      big_query_options:
+          BigQuery options specification.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.StorageConfig)
+    ),
+)
+_sym_db.RegisterMessage(StorageConfig)
+_sym_db.RegisterMessage(StorageConfig.TimespanConfig)
+
+BigQueryKey = _reflection.GeneratedProtocolMessageType(
+    "BigQueryKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYKEY,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Row key for identifying a record in BigQuery table.
+  
+  
+  Attributes:
+      table_reference:
+          Complete BigQuery table reference.
+      row_number:
+          Absolute number of the row from the beginning of the table at
+          the time of scanning.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BigQueryKey)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryKey)
+
+DatastoreKey = _reflection.GeneratedProtocolMessageType(
+    "DatastoreKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATASTOREKEY,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Record key for a finding in Cloud Datastore.
+  
+  
+  Attributes:
+      entity_key:
+          Datastore entity key.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.DatastoreKey)
+    ),
+)
+_sym_db.RegisterMessage(DatastoreKey)
+
+Key = _reflection.GeneratedProtocolMessageType(
+    "Key",
+    (_message.Message,),
+    dict(
+        PathElement=_reflection.GeneratedProtocolMessageType(
+            "PathElement",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_KEY_PATHELEMENT,
+                __module__="google.cloud.dlp_v2.proto.storage_pb2",
+                __doc__="""A (kind, ID/name) pair used to construct a key path.
+    
+    If either name or ID is set, the element is complete. If neither is set,
+    the element is incomplete.
+    
+    
+    Attributes:
+        kind:
+            The kind of the entity. A kind matching regex ``__.*__`` is
+            reserved/read-only. A kind must not contain more than 1500
+            bytes when UTF-8 encoded. Cannot be ``""``.
+        id_type:
+            The type of ID.
+        id:
+            The auto-allocated ID of the entity. Never equal to zero.
+            Values less than zero are discouraged and may not be supported
+            in the future.
+        name:
+            The name of the entity. A name matching regex ``__.*__`` is
+            reserved/read-only. A name must not be more than 1500 bytes
+            when UTF-8 encoded. Cannot be ``""``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Key.PathElement)
+            ),
+        ),
+        DESCRIPTOR=_KEY,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""A unique identifier for a Datastore entity. If a key's partition ID or
+  any of its path kinds or names are reserved/read-only, the key is
+  reserved/read-only. A reserved/read-only key is forbidden in certain
+  documented contexts.
+  
+  
+  Attributes:
+      partition_id:
+          Entities are partitioned into subsets, currently identified by
+          a project ID and namespace ID. Queries are scoped to a single
+          partition.
+      path:
+          The entity path. An entity path consists of one or more
+          elements composed of a kind and a string or numerical
+          identifier, which identify entities. The first element
+          identifies a *root entity*, the second element identifies a
+          *child* of the root entity, the third element identifies a
+          child of the second entity, and so forth. The entities
+          identified by all prefixes of the path are called the
+          element's *ancestors*.  A path can never be empty, and a path
+          can have at most 100 elements.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.Key)
+    ),
+)
+_sym_db.RegisterMessage(Key)
+_sym_db.RegisterMessage(Key.PathElement)
+
+RecordKey = _reflection.GeneratedProtocolMessageType(
+    "RecordKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECORDKEY,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Message for a unique key indicating a record that contains a finding.
+  
+  
+  Attributes:
+      id_values:
+          Values of identifying columns in the given row. Order of
+          values matches the order of field identifiers specified in the
+          scanning request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.RecordKey)
+    ),
+)
+_sym_db.RegisterMessage(RecordKey)
+
+BigQueryTable = _reflection.GeneratedProtocolMessageType(
+    "BigQueryTable",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYTABLE,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Message defining the location of a BigQuery table. A table is uniquely
+  identified by its project\_id, dataset\_id, and table\_name. Within a
+  query a table is often referenced with a string in the format of:
+  ``<project_id>:<dataset_id>.<table_id>`` or
+  ``<project_id>.<dataset_id>.<table_id>``.
+  
+  
+  Attributes:
+      project_id:
+          The Google Cloud Platform project ID of the project containing
+          the table. If omitted, project ID is inferred from the API
+          call.
+      dataset_id:
+          Dataset ID of the table.
+      table_id:
+          Name of the table.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BigQueryTable)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryTable)
+
+BigQueryField = _reflection.GeneratedProtocolMessageType(
+    "BigQueryField",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BIGQUERYFIELD,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""Message defining a field of a BigQuery table.
+  
+  
+  Attributes:
+      table:
+          Source table of the field.
+      field:
+          Designated field in the BigQuery table.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.BigQueryField)
+    ),
+)
+_sym_db.RegisterMessage(BigQueryField)
+
+EntityId = _reflection.GeneratedProtocolMessageType(
+    "EntityId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYID,
+        __module__="google.cloud.dlp_v2.proto.storage_pb2",
+        __doc__="""An entity in a dataset is a field or set of fields that correspond to a
+  single person. For example, in medical records the ``EntityId`` might be
+  a patient identifier, or for financial records it might be an account
+  identifier. This message is used when generalizations or analysis must
+  take into account that multiple rows correspond to the same entity.
+  
+  
+  Attributes:
+      field:
+          Composite key indicating which field contains the entity
+          identifier.
+  """,
+        # @@protoc_insertion_point(class_scope:google.privacy.dlp.v2.EntityId)
+    ),
+)
+_sym_db.RegisterMessage(EntityId)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/dlp/google/cloud/dlp_v2/proto/storage_pb2_grpc.py b/dlp/google/cloud/dlp_v2/proto/storage_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/proto/storage_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/dlp/google/cloud/dlp_v2/types.py b/dlp/google/cloud/dlp_v2/types.py
new file mode 100644
index 000000000000..2ec96b82c091
--- /dev/null
+++ b/dlp/google/cloud/dlp_v2/types.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.dlp_v2.proto import dlp_pb2
+from google.cloud.dlp_v2.proto import storage_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import date_pb2
+from google.type import timeofday_pb2
+
+
+_shared_modules = [
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+    date_pb2,
+    timeofday_pb2,
+]
+
+_local_modules = [dlp_pb2, storage_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.dlp_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/dlp/noxfile.py b/dlp/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/dlp/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/dlp/setup.cfg b/dlp/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/dlp/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/dlp/setup.py b/dlp/setup.py
new file mode 100644
index 000000000000..521572559a33
--- /dev/null
+++ b/dlp/setup.py
@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-dlp"
+description = "Cloud Data Loss Prevention (DLP) API API client library"
+version = "0.12.1"
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/dlp/synth.metadata b/dlp/synth.metadata
new file mode 100644
index 000000000000..6ed9ce34fb47
--- /dev/null
+++ b/dlp/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:23:29.991839Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "dlp",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/privacy/dlp/artman_dlp_v2.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/dlp/synth.py b/dlp/synth.py
new file mode 100644
index 000000000000..9a50da31e917
--- /dev/null
+++ b/dlp/synth.py
@@ -0,0 +1,258 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate dlp GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "dlp",
+    "v2",
+    config_path="/google/privacy/dlp/artman_dlp_v2.yaml",
+    include_protos=True,
+)
+
+excludes = ["README.rst", "nox.py", "setup.py", "docs/index.rst"]
+s.move(library, excludes=excludes)
+
+# Fix namespace
+s.replace("google/**/*.py", "google\.cloud\.privacy\.dlp_v2", "google.cloud.dlp_v2")
+
+# Add missing utf-8 marker
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "# Generated by the protocol buffer compiler.  DO NOT EDIT!",
+    "# -*- coding: utf-8 -*-\n\g<0>",
+)
+
+# Fix raw-latex bits in storage_pb2.py
+s.replace(
+    "google/cloud/dlp_v2/proto/storage_pb2.py",
+    "number regex.*\n(\s+)latex:.*\n",
+    'number regex "(\\d\{3\}) \\d\{3\}-\\d\{4\} "\\\n'
+    "\g<1>could be adjusted upwards if the area code is \\\n",
+)
+
+# Fix Docstrings in google/cloud/dlp_v2/proto/storage_pb2.py
+s.replace(
+    "google/cloud/dlp_v2/proto/storage_pb2.py",
+    "(hotword_regex:)\n(\s+Regular expression.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/storage_pb2.py",
+    "(likelihood_adjustment:)\n",
+    "\g<1> \\\n",
+)
+
+# Fix Docstrings in google/cloud/dlp_v2/proto/dlp_pb2.py
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(max_findings_per_item:)\n(\s+Max number.*)\n(\s+scanned. When.*)\n"
+    "(\s+maximum returned is 1000.*)\n(\s+When set within.*)\n",
+    "\g<1> \\\n\g<2> \\\n\g<3> \\\n\g<4> \\\n\g<5> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(max_findings_per_request:)\n(\s+Max number of.*)\n(\s+When set .*)\n",
+    "\g<1> \\\n\g<2> \\\n\g<3> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(max_findings_per_info_type:)\n",
+    "\g<1> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(snapshot_inspect_template:)\n(\s+If run with an .*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+to_replace = [
+    "processed_bytes:",
+    "total_estimated_bytes:",
+    "info_type_stats:",
+    "Statistics of how many instances of each info type were found",
+    "requested_options:",
+]
+
+for replace in to_replace:
+    s.replace("google/cloud/dlp_v2/proto/dlp_pb2.py", f"({replace})\n", "\g<1> \\\n")
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(sensitive_value_frequency_lower_bound:)\n(\s+Lower bound.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(sensitive_value_frequency_upper_bound:)\n(\s+Upper bound.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(bucket_size:)\n(\s+Total number of equivalence.*)\n",
+    "\g<1> \\\n\g<2>\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(bucket_values:)\n(\s+Sample of equivalence.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(offset_minutes:)\n(\s+Set only.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(result:)\n(\s+A summary of the outcome of this inspect job.)",
+    "\g<1> \\\n\g<2>",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(storage_config:)\n(\s+The data to scan.\n)",
+    "\g<1> \\\n\g<2>",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(inspect_config:)\n(\s+How and what to scan for.\n)",
+    "\g<1> \\\n\g<2>",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(inspect_template_name:)\n(\s+If provided, will be.*)\n"
+    "(\s+InspectConfig.*)\n(\s+values persisted.*)\n(\s+actions:)\n"
+    "(\s+Actions to.*)\n",
+    "\g<1> \\\n\g<2> \\\n\g<3> \\\n\g<4> \\\n\g<5> \\\n\g<6> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "    (\s+Set of values defining the equivalence class.*)\n"
+    "    (\s+quasi-identifier.*)\n"
+    "    (\s+message. The order.*)\n",
+    "\g<1> \\\n\g<2> \\\n\g<3>\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "    (\s+Size of the equivalence class, for example number of rows with)\n"
+    "    (\s+the above set of values.)\n",
+    "\g<1> \\\n\g<2>\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(equivalence_class_size_lower_bound:)\n(\s+Lower bound.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(equivalence_class_size_upper_bound:)\n(\s+Upper bound.*)\n",
+    "\g<1> \\\n\g<2> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(bucket_value_count:)\n(\s+Total number of distinct equivalence.*)\n",
+    "\g<1> \\\n\g<2>\n",
+)
+
+# Docstrings from categorical histogram bucket
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(value_frequency_lower_bound:)\n\s+(Lower bound.*)\n\s+(bucket.\n)"
+    "(\s+value_frequency_upper.*)\n\s+(Upper.*)\n\s+(bucket.\n)"
+    "(\s+bucket_size:)\n\s+(Total.*\n)"
+    "(\s+bucket_values:)\n\s+(Sample of value.*)\n\s+(of values.*\n)"
+    "(\s+bucket_value_count:)\n\s+(Total number.*\n)",
+    "\g<1> \g<2> \g<3>\g<4> \g<5> \g<6>\g<7> \g<8>" "\g<9> \g<10> \g<11>\g<12> \g<13>",
+)
+
+# Fix docstrings tagged field indentation issues in dlp_pb2.py
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(DESCRIPTOR .*_TAGGEDFIELD,\n\s+__module__.*\n\s+,\n\s+__doc__.*\n)"
+    "(\s+field:)\n(\s+Identifies .*)\n(\s+tag:)\n(\s+Semantic.*)\n"
+    "(\s+determine.*)\n(\s+reidentifiability.*)\n(\s+info_type:)\n"
+    "(\s+A column.*)\n(\s+public dataset.*)\n(\s+available.*)\n(\s+ages.*)\n"
+    "(\s+supported Info.*)\n(\s+supported.*)\n(\s+custom_tag:)\n(\s+A col.*)\n"
+    "(\s+user must.*)\n(\s+statist.*)\n(\s+\(below.*)\n(\s+inferred:)\n"
+    "(\s+If no semantic.*)\n",
+    "\g<1>\g<2> \\\n\g<3>\n\g<4> \\\n\g<5> \\\n\g<6> \\\n"
+    "\g<7> \\\n\g<8> \\\n\g<9> \\\n\g<10> \\\n\g<11> \\\n\g<12> \\\n"
+    "\g<13> \\\n\g<14>\n\g<15> \\\n\g<16> \\\n\g<17> \\\n\g<18> \\\n"
+    "\g<19>\n\g<20> \\\n\g<21> \\\n",
+)
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    r'''(\s+)__doc__ = """Attributes:''',
+    r'\g<1>__doc="""\n    Attributes:'
+)
+
+
+s.replace(
+    "google/cloud/dlp_v2/proto/dlp_pb2.py",
+    "(////////.*)\n\s+(///////////////\n)",
+    "\g<1> \g<2>",
+)
+
+# Fix Docstrings in google/cloud/dlp_v2/gapic/dlp_service_client.py
+s.replace(
+    "google/cloud/dlp_v2/gapic/dlp_service_client.py",
+    "^\s+resource was created.",
+    "  \g<0>",
+)
+
+# Fix Docstrings in google/cloud/dlp_v2/gapic/enums.py
+s.replace(
+    "google/cloud/dlp_v2/gapic/enums.py",
+    "(\s+)WHITESPACE \(int\).*\n",
+    "\g<1>WHITESPACE (int): Whitespace character\n",
+)
+
+s.replace("google/cloud/dlp_v2/gapic/enums.py", ".*:raw-latex:.*\n", "")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/dlp/tests/system/gapic/v2/test_system_dlp_service_v2.py b/dlp/tests/system/gapic/v2/test_system_dlp_service_v2.py
new file mode 100644
index 000000000000..e24f6a22bf1b
--- /dev/null
+++ b/dlp/tests/system/gapic/v2/test_system_dlp_service_v2.py
@@ -0,0 +1,41 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import os
+
+from google.cloud import dlp_v2
+from google.cloud.dlp_v2 import enums
+from google.cloud.dlp_v2.proto import dlp_pb2
+
+
+class TestSystemDlpService(object):
+    def _get_project_id(self):
+        env_var_name = "GOOGLE_APPLICATION_CREDENTIALS"
+        path = os.environ[env_var_name]
+        json_data = open(path).read()
+        data = json.loads(json_data)
+        return data["project_id"]
+
+    def test_inspect_content(self):
+        # get project id from json file
+        project_id = self._get_project_id()
+
+        client = dlp_v2.DlpServiceClient()
+        min_likelihood = enums.Likelihood.POSSIBLE
+        info_types = [{"name": "FIRST_NAME"}, {"name": "LAST_NAME"}]
+        inspect_config = {"info_types": info_types, "min_likelihood": min_likelihood}
+        item = {"value": "Robert Frost"}
+        parent = client.project_path(project_id)
+        response = client.inspect_content(parent, inspect_config, item)
diff --git a/dlp/tests/unit/gapic/v2/test_dlp_service_client_v2.py b/dlp/tests/unit/gapic/v2/test_dlp_service_client_v2.py
new file mode 100644
index 000000000000..4f7fd086f119
--- /dev/null
+++ b/dlp/tests/unit/gapic/v2/test_dlp_service_client_v2.py
@@ -0,0 +1,1273 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import dlp_v2
+from google.cloud.dlp_v2.proto import dlp_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDlpServiceClient(object):
+    def test_inspect_content(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = dlp_pb2.InspectContentResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.inspect_content(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.InspectContentRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_inspect_content_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.inspect_content(parent)
+
+    def test_redact_image(self):
+        # Setup Expected Response
+        redacted_image = b"28"
+        extracted_text = "extractedText998260012"
+        expected_response = {
+            "redacted_image": redacted_image,
+            "extracted_text": extracted_text,
+        }
+        expected_response = dlp_pb2.RedactImageResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.redact_image(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.RedactImageRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_redact_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.redact_image(parent)
+
+    def test_deidentify_content(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = dlp_pb2.DeidentifyContentResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.deidentify_content(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.DeidentifyContentRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_deidentify_content_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.deidentify_content(parent)
+
+    def test_reidentify_content(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = dlp_pb2.ReidentifyContentResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.reidentify_content(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ReidentifyContentRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_reidentify_content_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.reidentify_content(parent)
+
+    def test_list_info_types(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = dlp_pb2.ListInfoTypesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        response = client.list_info_types()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ListInfoTypesRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_info_types_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        with pytest.raises(CustomException):
+            client.list_info_types()
+
+    def test_create_inspect_template(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.InspectTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.create_inspect_template(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.CreateInspectTemplateRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_inspect_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        with pytest.raises(CustomException):
+            client.create_inspect_template(parent)
+
+    def test_update_inspect_template(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.InspectTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_inspect_template_path(
+            "[ORGANIZATION]", "[INSPECT_TEMPLATE]"
+        )
+
+        response = client.update_inspect_template(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.UpdateInspectTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_inspect_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_inspect_template_path(
+            "[ORGANIZATION]", "[INSPECT_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.update_inspect_template(name)
+
+    def test_get_inspect_template(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.InspectTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        response = client.get_inspect_template()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.GetInspectTemplateRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_inspect_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        with pytest.raises(CustomException):
+            client.get_inspect_template()
+
+    def test_list_inspect_templates(self):
+        # Setup Expected Response
+        next_page_token = ""
+        inspect_templates_element = {}
+        inspect_templates = [inspect_templates_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "inspect_templates": inspect_templates,
+        }
+        expected_response = dlp_pb2.ListInspectTemplatesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_inspect_templates(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.inspect_templates[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ListInspectTemplatesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_inspect_templates_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_inspect_templates(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_inspect_template(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_inspect_template_path(
+            "[ORGANIZATION]", "[INSPECT_TEMPLATE]"
+        )
+
+        client.delete_inspect_template(name)
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.DeleteInspectTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_inspect_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_inspect_template_path(
+            "[ORGANIZATION]", "[INSPECT_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_inspect_template(name)
+
+    def test_create_deidentify_template(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.DeidentifyTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.create_deidentify_template(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.CreateDeidentifyTemplateRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_deidentify_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        with pytest.raises(CustomException):
+            client.create_deidentify_template(parent)
+
+    def test_update_deidentify_template(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.DeidentifyTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_deidentify_template_path(
+            "[ORGANIZATION]", "[DEIDENTIFY_TEMPLATE]"
+        )
+
+        response = client.update_deidentify_template(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.UpdateDeidentifyTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_deidentify_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_deidentify_template_path(
+            "[ORGANIZATION]", "[DEIDENTIFY_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.update_deidentify_template(name)
+
+    def test_get_deidentify_template(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.DeidentifyTemplate(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_deidentify_template_path(
+            "[ORGANIZATION]", "[DEIDENTIFY_TEMPLATE]"
+        )
+
+        response = client.get_deidentify_template(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.GetDeidentifyTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_deidentify_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_deidentify_template_path(
+            "[ORGANIZATION]", "[DEIDENTIFY_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_deidentify_template(name)
+
+    def test_list_deidentify_templates(self):
+        # Setup Expected Response
+        next_page_token = ""
+        deidentify_templates_element = {}
+        deidentify_templates = [deidentify_templates_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "deidentify_templates": deidentify_templates,
+        }
+        expected_response = dlp_pb2.ListDeidentifyTemplatesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_deidentify_templates(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.deidentify_templates[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ListDeidentifyTemplatesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_deidentify_templates_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_deidentify_templates(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_deidentify_template(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_deidentify_template_path(
+            "[ORGANIZATION]", "[DEIDENTIFY_TEMPLATE]"
+        )
+
+        client.delete_deidentify_template(name)
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.DeleteDeidentifyTemplateRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_deidentify_template_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_deidentify_template_path(
+            "[ORGANIZATION]", "[DEIDENTIFY_TEMPLATE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_deidentify_template(name)
+
+    def test_create_dlp_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        job_trigger_name = "jobTriggerName1819490804"
+        expected_response = {"name": name, "job_trigger_name": job_trigger_name}
+        expected_response = dlp_pb2.DlpJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.create_dlp_job(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.CreateDlpJobRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_dlp_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.create_dlp_job(parent)
+
+    def test_list_dlp_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        jobs_element = {}
+        jobs = [jobs_element]
+        expected_response = {"next_page_token": next_page_token, "jobs": jobs}
+        expected_response = dlp_pb2.ListDlpJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_dlp_jobs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ListDlpJobsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_dlp_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_dlp_jobs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_dlp_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        job_trigger_name = "jobTriggerName1819490804"
+        expected_response = {"name": name_2, "job_trigger_name": job_trigger_name}
+        expected_response = dlp_pb2.DlpJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.dlp_job_path("[PROJECT]", "[DLP_JOB]")
+
+        response = client.get_dlp_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.GetDlpJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_dlp_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.dlp_job_path("[PROJECT]", "[DLP_JOB]")
+
+        with pytest.raises(CustomException):
+            client.get_dlp_job(name)
+
+    def test_delete_dlp_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.dlp_job_path("[PROJECT]", "[DLP_JOB]")
+
+        client.delete_dlp_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.DeleteDlpJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_dlp_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.dlp_job_path("[PROJECT]", "[DLP_JOB]")
+
+        with pytest.raises(CustomException):
+            client.delete_dlp_job(name)
+
+    def test_cancel_dlp_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.dlp_job_path("[PROJECT]", "[DLP_JOB]")
+
+        client.cancel_dlp_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.CancelDlpJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_dlp_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.dlp_job_path("[PROJECT]", "[DLP_JOB]")
+
+        with pytest.raises(CustomException):
+            client.cancel_dlp_job(name)
+
+    def test_list_job_triggers(self):
+        # Setup Expected Response
+        next_page_token = ""
+        job_triggers_element = {}
+        job_triggers = [job_triggers_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "job_triggers": job_triggers,
+        }
+        expected_response = dlp_pb2.ListJobTriggersResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_job_triggers(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.job_triggers[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ListJobTriggersRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_job_triggers_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_job_triggers(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_job_trigger(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.JobTrigger(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.project_job_trigger_path("[PROJECT]", "[JOB_TRIGGER]")
+
+        response = client.get_job_trigger(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.GetJobTriggerRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_job_trigger_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.project_job_trigger_path("[PROJECT]", "[JOB_TRIGGER]")
+
+        with pytest.raises(CustomException):
+            client.get_job_trigger(name)
+
+    def test_delete_job_trigger(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = "name3373707"
+
+        client.delete_job_trigger(name)
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.DeleteJobTriggerRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_job_trigger_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = "name3373707"
+
+        with pytest.raises(CustomException):
+            client.delete_job_trigger(name)
+
+    def test_update_job_trigger(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.JobTrigger(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.project_job_trigger_path("[PROJECT]", "[JOB_TRIGGER]")
+
+        response = client.update_job_trigger(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.UpdateJobTriggerRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_job_trigger_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.project_job_trigger_path("[PROJECT]", "[JOB_TRIGGER]")
+
+        with pytest.raises(CustomException):
+            client.update_job_trigger(name)
+
+    def test_create_job_trigger(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = dlp_pb2.JobTrigger(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        response = client.create_job_trigger(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.CreateJobTriggerRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_job_trigger_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.create_job_trigger(parent)
+
+    def test_create_stored_info_type(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = dlp_pb2.StoredInfoType(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.create_stored_info_type(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.CreateStoredInfoTypeRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_stored_info_type_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        with pytest.raises(CustomException):
+            client.create_stored_info_type(parent)
+
+    def test_update_stored_info_type(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = dlp_pb2.StoredInfoType(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_stored_info_type_path(
+            "[ORGANIZATION]", "[STORED_INFO_TYPE]"
+        )
+
+        response = client.update_stored_info_type(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.UpdateStoredInfoTypeRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_stored_info_type_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_stored_info_type_path(
+            "[ORGANIZATION]", "[STORED_INFO_TYPE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.update_stored_info_type(name)
+
+    def test_get_stored_info_type(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = dlp_pb2.StoredInfoType(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_stored_info_type_path(
+            "[ORGANIZATION]", "[STORED_INFO_TYPE]"
+        )
+
+        response = client.get_stored_info_type(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.GetStoredInfoTypeRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_stored_info_type_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_stored_info_type_path(
+            "[ORGANIZATION]", "[STORED_INFO_TYPE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_stored_info_type(name)
+
+    def test_list_stored_info_types(self):
+        # Setup Expected Response
+        next_page_token = ""
+        stored_info_types_element = {}
+        stored_info_types = [stored_info_types_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "stored_info_types": stored_info_types,
+        }
+        expected_response = dlp_pb2.ListStoredInfoTypesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_stored_info_types(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.stored_info_types[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.ListStoredInfoTypesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_stored_info_types_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_stored_info_types(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_stored_info_type(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup Request
+        name = client.organization_stored_info_type_path(
+            "[ORGANIZATION]", "[STORED_INFO_TYPE]"
+        )
+
+        client.delete_stored_info_type(name)
+
+        assert len(channel.requests) == 1
+        expected_request = dlp_pb2.DeleteStoredInfoTypeRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_stored_info_type_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = dlp_v2.DlpServiceClient()
+
+        # Setup request
+        name = client.organization_stored_info_type_path(
+            "[ORGANIZATION]", "[STORED_INFO_TYPE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_stored_info_type(name)
diff --git a/dns/.coveragerc b/dns/.coveragerc
new file mode 100644
index 000000000000..098720f672e1
--- /dev/null
+++ b/dns/.coveragerc
@@ -0,0 +1,16 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
diff --git a/dns/.flake8 b/dns/.flake8
new file mode 100644
index 000000000000..61766fa84d02
--- /dev/null
+++ b/dns/.flake8
@@ -0,0 +1,13 @@
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/dns/.repo-metadata.json b/dns/.repo-metadata.json
new file mode 100644
index 000000000000..835bbd8ffb2b
--- /dev/null
+++ b/dns/.repo-metadata.json
@@ -0,0 +1,12 @@
+{
+  "name": "dns",
+  "name_pretty": "Cloud DNS",
+  "product_documentation": "https://cloud.google.com/dns",
+  "client_documentation": "https://googleapis.dev/python/dns/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559772",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-dns",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/dns/CHANGELOG.md b/dns/CHANGELOG.md
new file mode 100644
index 000000000000..19e7b74c322a
--- /dev/null
+++ b/dns/CHANGELOG.md
@@ -0,0 +1,114 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-dns/#history
+
+## 0.30.2
+
+07-11-2019 10:09 PDT
+
+### Implementation Changes
+- Change base url to dns.googleapis.com ([#8641](https://github.com/googleapis/google-cloud-python/pull/8641))
+
+### Internal / Testing Changes
+- Add nox session 'docs' to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.30.1
+
+06-04-2019 11:13 PDT
+
+
+### Dependencies
+- Don't pin 'google-api-core' in libs using 'google-cloud-core'. ([#8213](https://github.com/googleapis/google-cloud-python/pull/8213))
+
+## 0.30.0
+
+05-16-2019 12:23 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to client / connection. ([#7869](https://github.com/googleapis/google-cloud-python/pull/7869))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+## 0.29.2
+
+12-17-2018 16:47 PST
+
+
+### Implementation Changes
+- Ensure that `ManagedZone:exists()` does not misreport `True` result. ([#6884](https://github.com/googleapis/google-cloud-python/pull/6884))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Docs/fixit: normalize docs for `page_size` / `max_results` / `page_token` ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+## 0.29.1
+
+12-10-2018 12:50 PST
+
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Fix 'Datastore' in text as well as examples / links
+
+### Internal / Testing Changes
+- Add blacken to noxfile ([#6795](https://github.com/googleapis/google-cloud-python/pull/6795))
+- Blackening Continued... ([#6667](https://github.com/googleapis/google-cloud-python/pull/6667))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Fix copy-pasta from datastore README. ([#6208](https://github.com/googleapis/google-cloud-python/pull/6208))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Prep dns docs for repo split. ([#6020](https://github.com/googleapis/google-cloud-python/pull/6020))
+- Nox: use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Fix bad trove classifier
+
+## 0.29.0
+
+### Implementation changes
+
+- Renaming `makeResource` -> `make_resource`. (#4355)
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-dns/0.28.0/
diff --git a/dns/LICENSE b/dns/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/dns/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/dns/MANIFEST.in b/dns/MANIFEST.in
new file mode 100644
index 000000000000..fc77f8c82ff0
--- /dev/null
+++ b/dns/MANIFEST.in
@@ -0,0 +1,4 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.pyc __pycache__
diff --git a/dns/README.rst b/dns/README.rst
new file mode 100644
index 000000000000..10b2f4240dc8
--- /dev/null
+++ b/dns/README.rst
@@ -0,0 +1,88 @@
+Python Client for Google Cloud DNS
+==================================
+
+|alpha| |pypi| |versions| 
+
+The `Google Cloud DNS`_ API provides methods that you can use to
+manage DNS for your applications.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-dns.svg
+   :target: https://pypi.org/project/google-cloud-dns/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-dns.svg
+.. _Google Cloud DNS: https://cloud.google.com/dns/
+   :target: https://pypi.org/project/google-cloud-dns/
+.. _Client Library Documentation: https://googleapis.dev/python/dns/latest
+.. _Product Documentation: https://cloud.google.com/dns/docs/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud DNS API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud DNS API.:  https://cloud.google.com/dns
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-dns
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-dns
+
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud DNS
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/dns/docs/README.rst b/dns/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/dns/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/dns/docs/changelog.md b/dns/docs/changelog.md
new file mode 120000
index 000000000000..174ea63d7208
--- /dev/null
+++ b/dns/docs/changelog.md
@@ -0,0 +1 @@
+../../dns/CHANGELOG.md
\ No newline at end of file
diff --git a/docs/dns-changes.rst b/dns/docs/changes.rst
similarity index 100%
rename from docs/dns-changes.rst
rename to dns/docs/changes.rst
diff --git a/dns/docs/client.rst b/dns/docs/client.rst
new file mode 100644
index 000000000000..76cbb66f5649
--- /dev/null
+++ b/dns/docs/client.rst
@@ -0,0 +1,6 @@
+DNS Client
+==========
+
+.. automodule:: google.cloud.dns.client
+  :members:
+  :show-inheritance:
diff --git a/dns/docs/conf.py b/dns/docs/conf.py
new file mode 100644
index 000000000000..00a467bd4ccf
--- /dev/null
+++ b/dns/docs/conf.py
@@ -0,0 +1,353 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-dns documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-dns"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-dns-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-dns.tex",
+        u"google-cloud-dns Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-dns", u"google-cloud-dns Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-dns",
+        u"google-cloud-dns Documentation",
+        author,
+        "google-cloud-dns",
+        "GAPIC library for the DNS API",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/dns/docs/index.rst b/dns/docs/index.rst
new file mode 100644
index 000000000000..71e0f49f5b18
--- /dev/null
+++ b/dns/docs/index.rst
@@ -0,0 +1,201 @@
+.. include:: README.rst
+
+Using the Library
+-----------------
+
+Client
+~~~~~~
+
+:class:`Client <google.cloud.dns.client.Client>` objects provide a means to
+configure your DNS applications.  Each instance holds both a ``project``
+and an authenticated connection to the DNS service.
+
+For an overview of authentication in ``google-cloud-python``, see `Authentication <https://googleapis.dev/python/google-api-core/latest/auth.html#authentication>`_..
+
+Assuming your environment is set up as described in that document,
+create an instance of :class:`Client <google.cloud.dns.client.Client>`.
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client()
+
+Projects
+~~~~~~~~
+
+A project is the top-level container in the ``DNS`` API:  it is tied
+closely to billing, and can provide default access control across all its
+datasets.  If no ``project`` is passed to the client container, the library
+attempts to infer a project using the environment (including explicit
+environment variables, GAE, or GCE).
+
+To override the project inferred from the environment, pass an explicit
+``project`` to the constructor, or to either of the alternative
+``classmethod`` factories:
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+
+Project Quotas
+~~~~~~~~~~~~~~
+
+Query the quotas for a given project:
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+     >>> quotas = client.quotas()  # API request
+     >>> for key, value in sorted(quotas.items()):
+     ...     print('%s: %s' % (key, value))
+     managedZones: 10000
+     resourceRecordsPerRrset: 100
+     rrsetsPerManagedZone: 10000
+     rrsetAdditionsPerChange: 100
+     rrsetDeletionsPerChange: 100
+     totalRrdataSizePerChange: 10000
+
+
+Project ACLs
+^^^^^^^^^^^^
+
+Each project has an access control list granting reader / writer / owner
+permission to one or more entities.  This list cannot be queried or set
+via the API:  it must be managed using the Google Developer Console.
+
+
+Managed Zones
+~~~~~~~~~~~~~
+
+A "managed zone" is the container for DNS records for the same DNS name
+suffix and has a set of name servers that accept and responds to queries:
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+     >>> zone = client.zone('acme-co', 'example.com',
+     ...                    description='Acme Company zone')
+
+     >>> zone.exists()  # API request
+     False
+     >>> zone.create()  # API request
+     >>> zone.exists()  # API request
+     True
+
+List the zones for a given project:
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+     >>> zones = client.list_zones()  # API request
+     >>> [zone.name for zone in zones]
+     ['acme-co']
+
+
+Resource Record Sets
+~~~~~~~~~~~~~~~~~~~~
+
+Each managed zone exposes a read-only set of resource records:
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+     >>> zone = client.zone('acme-co', 'example.com')
+     >>> records, page_token = zone.list_resource_record_sets()  # API request
+     >>> [(record.name, record.record_type, record.ttl, record.rrdatas)
+     ...  for record in records]
+     [('example.com.', 'SOA', 21600, ['ns-cloud1.googlecomains.com dns-admin.google.com 1 21600 3600 1209600 300'])]
+
+.. note::
+
+   The ``page_token`` returned from ``zone.list_resource_record_sets()`` will
+   be an opaque string if there are more resources than can be returned in a
+   single request.  To enumerate them all, repeat calling
+   ``zone.list_resource_record_sets()``, passing the ``page_token``, until
+   the token is ``None``.  E.g.
+
+   .. code-block:: python
+
+      >>> records, page_token = zone.list_resource_record_sets()  # API request
+      >>> while page_token is not None:
+      ...     next_batch, page_token = zone.list_resource_record_sets(
+      ...         page_token=page_token)  # API request
+      ...     records.extend(next_batch)
+
+
+Change requests
+~~~~~~~~~~~~~~~
+
+Update the resource record set for a zone by creating a change request
+bundling additions to or deletions from the set.
+
+  .. code-block:: python
+
+     >>> import time
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+     >>> zone = client.zone('acme-co', 'example.com')
+     >>> TWO_HOURS = 2 * 60 * 60  # seconds
+     >>> record_set = zone.resource_record_set(
+     ...    'www.example.com.', 'CNAME', TWO_HOURS, ['www1.example.com.',])
+     >>> changes = zone.changes()
+     >>> changes.add_record_set(record_set)
+     >>> changes.create()  # API request
+     >>> while changes.status != 'done':
+     ...     print('Waiting for changes to complete')
+     ...     time.sleep(60)     # or whatever interval is appropriate
+     ...     changes.reload()   # API request
+
+
+List changes made to the resource record set for a given zone:
+
+  .. code-block:: python
+
+     >>> from google.cloud import dns
+     >>> client = dns.Client(project='PROJECT_ID')
+     >>> zone = client.zone('acme-co', 'example.com')
+     >>> changes = []
+     >>> changes, page_token = zone.list_changes()  # API request
+
+.. note::
+
+   The ``page_token`` returned from ``zone.list_changes()`` will be
+   an opaque string if there are more changes than can be returned in a
+   single request.  To enumerate them all, repeat calling
+   ``zone.list_changes()``, passing the ``page_token``, until the token
+   is ``None``.  E.g.:
+
+   .. code-block:: python
+
+      >>> changes, page_token = zone.list_changes()  # API request
+      >>> while page_token is not None:
+      ...     next_batch, page_token = zone.list_changes(
+      ...         page_token=page_token)  # API request
+      ...     changes.extend(next_batch)
+
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   client
+   zone
+   resource-record-set
+   changes
+
+Changelog
+---------
+
+For a list of all ``google-cloud-dns`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
+
diff --git a/docs/dns-resource-record-set.rst b/dns/docs/resource-record-set.rst
similarity index 100%
rename from docs/dns-resource-record-set.rst
rename to dns/docs/resource-record-set.rst
diff --git a/dns/docs/usage.html b/dns/docs/usage.html
new file mode 100644
index 000000000000..9b81d6976cda
--- /dev/null
+++ b/dns/docs/usage.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <script>
+   window.location.href = "./index.html"
+ </script>
+</head>
+</html>
diff --git a/docs/dns-zone.rst b/dns/docs/zone.rst
similarity index 100%
rename from docs/dns-zone.rst
rename to dns/docs/zone.rst
diff --git a/dns/google/__init__.py b/dns/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/dns/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/dns/google/cloud/__init__.py b/dns/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/dns/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/dns/google/cloud/dns/__init__.py b/dns/google/cloud/dns/__init__.py
new file mode 100644
index 000000000000..dc3754ec4c22
--- /dev/null
+++ b/dns/google/cloud/dns/__init__.py
@@ -0,0 +1,48 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud DNS API wrapper.
+
+The main concepts with this API are:
+
+- :class:`~google.cloud.DNS.zone.ManagedZone` represents an collection of
+  tables.
+- :class:`~google.cloud.DNS.resource_record_set.ResourceRecordSet` represents
+  a single resource definition within a zone.
+- :class:`~google.cloud.DNS.changes.Changes` represents a set of changes
+  (adding/deleting resource record sets) to a zone.
+"""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-dns").version
+
+from google.cloud.dns.zone import Changes
+from google.cloud.dns.client import Client
+from google.cloud.dns.zone import ManagedZone
+from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+
+SCOPE = Client.SCOPE
+
+
+__all__ = [
+    "__version__",
+    "Changes",
+    "Client",
+    "ManagedZone",
+    "ResourceRecordSet",
+    "SCOPE",
+]
diff --git a/dns/google/cloud/dns/_http.py b/dns/google/cloud/dns/_http.py
new file mode 100644
index 000000000000..510681261bee
--- /dev/null
+++ b/dns/google/cloud/dns/_http.py
@@ -0,0 +1,45 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud DNS connections."""
+
+from google.cloud import _http
+
+from google.cloud.dns import __version__
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google Cloud DNS via the JSON REST API.
+
+    :type client: :class:`~google.cloud.dns.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+    """
+
+    def __init__(self, client, client_info=None):
+        super(Connection, self).__init__(client, client_info)
+
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_BASE_URL = "https://dns.googleapis.com"
+    """The base of the API call URL."""
+
+    API_VERSION = "v1"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/dns/{api_version}{path}"
+    """A template for the URL of a particular API call."""
diff --git a/dns/google/cloud/dns/changes.py b/dns/google/cloud/dns/changes.py
new file mode 100644
index 000000000000..759997cbe4f1
--- /dev/null
+++ b/dns/google/cloud/dns/changes.py
@@ -0,0 +1,278 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define API ResourceRecordSets."""
+
+import six
+
+from google.cloud._helpers import _rfc3339_to_datetime
+from google.cloud.exceptions import NotFound
+from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+
+class Changes(object):
+    """Changes are bundled additions / deletions of DNS resource records.
+
+    Changes are owned by a :class:`google.cloud.dns.zone.ManagedZone` instance.
+
+    See
+    https://cloud.google.com/dns/api/v1/changes
+
+    :type zone: :class:`google.cloud.dns.zone.ManagedZone`
+    :param zone: A zone which holds one or more record sets.
+    """
+
+    def __init__(self, zone):
+        self.zone = zone
+        self._properties = {}
+        self._additions = self._deletions = ()
+
+    @classmethod
+    def from_api_repr(cls, resource, zone):
+        """Factory:  construct a change set given its API representation
+
+        :type resource: dict
+        :param resource: change set representation returned from the API.
+
+        :type zone: :class:`google.cloud.dns.zone.ManagedZone`
+        :param zone: A zone which holds zero or more change sets.
+
+        :rtype: :class:`google.cloud.dns.changes.Changes`
+        :returns: RRS parsed from ``resource``.
+        """
+        changes = cls(zone=zone)
+        changes._set_properties(resource)
+        return changes
+
+    def _set_properties(self, resource):
+        """Helper method for :meth:`from_api_repr`, :meth:`create`, etc.
+
+        :type resource: dict
+        :param resource: change set representation returned from the API.
+        """
+        resource = resource.copy()
+        self._additions = tuple(
+            [
+                ResourceRecordSet.from_api_repr(added_res, self.zone)
+                for added_res in resource.pop("additions", ())
+            ]
+        )
+        self._deletions = tuple(
+            [
+                ResourceRecordSet.from_api_repr(added_res, self.zone)
+                for added_res in resource.pop("deletions", ())
+            ]
+        )
+        self._properties = resource
+
+    @property
+    def path(self):
+        """URL path for change set APIs.
+
+        :rtype: str
+        :returns: the path based on project, zone, and change set names.
+        """
+        return "/projects/%s/managedZones/%s/changes/%s" % (
+            self.zone.project,
+            self.zone.name,
+            self.name,
+        )
+
+    @property
+    def name(self):
+        """Name of the change set.
+
+        :rtype: str or ``NoneType``
+        :returns: Name, as set by the back-end, or None.
+        """
+        return self._properties.get("id")
+
+    @name.setter
+    def name(self, value):
+        """Update name of the change set.
+
+        :type value: str
+        :param value: New name for the changeset.
+        """
+        if not isinstance(value, six.string_types):
+            raise ValueError("Pass a string")
+        self._properties["id"] = value
+
+    @property
+    def status(self):
+        """Status of the change set.
+
+        :rtype: str or ``NoneType``
+        :returns: Status, as set by the back-end, or None.
+        """
+        return self._properties.get("status")
+
+    @property
+    def started(self):
+        """Time when the change set was started.
+
+        :rtype: ``datetime.datetime`` or ``NoneType``
+        :returns: Time, as set by the back-end, or None.
+        """
+        stamp = self._properties.get("startTime")
+        if stamp is not None:
+            return _rfc3339_to_datetime(stamp)
+
+    @property
+    def additions(self):
+        """Resource record sets to be added to the zone.
+
+        :rtype: sequence of
+                :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`.
+        :returns: record sets appended via :meth:`add_record_set`.
+        """
+        return self._additions
+
+    @property
+    def deletions(self):
+        """Resource record sets to be deleted from the zone.
+
+        :rtype: sequence of
+                :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`.
+        :returns: record sets appended via :meth:`delete_record_set`.
+        """
+        return self._deletions
+
+    def add_record_set(self, record_set):
+        """Append a record set to the 'additions' for the change set.
+
+        :type record_set:
+            :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`
+        :param record_set: the record set to append.
+
+        :raises: ``ValueError`` if ``record_set`` is not of the required type.
+        """
+        if not isinstance(record_set, ResourceRecordSet):
+            raise ValueError("Pass a ResourceRecordSet")
+        self._additions += (record_set,)
+
+    def delete_record_set(self, record_set):
+        """Append a record set to the 'deletions' for the change set.
+
+        :type record_set:
+            :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`
+        :param record_set: the record set to append.
+
+        :raises: ``ValueError`` if ``record_set`` is not of the required type.
+        """
+        if not isinstance(record_set, ResourceRecordSet):
+            raise ValueError("Pass a ResourceRecordSet")
+        self._deletions += (record_set,)
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: :class:`google.cloud.dns.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self.zone._client
+        return client
+
+    def _build_resource(self):
+        """Generate a resource for ``create``."""
+        additions = [
+            {
+                "name": added.name,
+                "type": added.record_type,
+                "ttl": str(added.ttl),
+                "rrdatas": added.rrdatas,
+            }
+            for added in self.additions
+        ]
+
+        deletions = [
+            {
+                "name": deleted.name,
+                "type": deleted.record_type,
+                "ttl": str(deleted.ttl),
+                "rrdatas": deleted.rrdatas,
+            }
+            for deleted in self.deletions
+        ]
+
+        return {"additions": additions, "deletions": deletions}
+
+    def create(self, client=None):
+        """API call:  create the change set via a POST request.
+
+        See
+        https://cloud.google.com/dns/api/v1/changes/create
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+        """
+        if len(self.additions) == 0 and len(self.deletions) == 0:
+            raise ValueError("No record sets added or deleted")
+        client = self._require_client(client)
+        path = "/projects/%s/managedZones/%s/changes" % (
+            self.zone.project,
+            self.zone.name,
+        )
+        api_response = client._connection.api_request(
+            method="POST", path=path, data=self._build_resource()
+        )
+        self._set_properties(api_response)
+
+    def exists(self, client=None):
+        """API call: test for the existence of the change set via a GET request.
+
+        See
+        https://cloud.google.com/dns/api/v1/changes/get
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: bool
+        :returns: Boolean indicating existence of the changes.
+        """
+        client = self._require_client(client)
+        try:
+            client._connection.api_request(
+                method="GET", path=self.path, query_params={"fields": "id"}
+            )
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self, client=None):
+        """API call:  refresh zone properties via a GET request.
+
+        See
+        https://cloud.google.com/dns/api/v1/changes/get
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+        """
+        client = self._require_client(client)
+
+        api_response = client._connection.api_request(method="GET", path=self.path)
+        self._set_properties(api_response)
diff --git a/dns/google/cloud/dns/client.py b/dns/google/cloud/dns/client.py
new file mode 100644
index 000000000000..4bfa112d5226
--- /dev/null
+++ b/dns/google/cloud/dns/client.py
@@ -0,0 +1,147 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Google Cloud DNS API."""
+
+from google.api_core import page_iterator
+from google.cloud.client import ClientWithProject
+
+from google.cloud.dns._http import Connection
+from google.cloud.dns.zone import ManagedZone
+
+
+class Client(ClientWithProject):
+    """Client to bundle configuration needed for API requests.
+
+    :type project: str
+    :param project: the project which the client acts on behalf of. Will be
+                    passed when creating a zone.  If not passed,
+                    falls back to the default inferred from the environment.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    """
+
+    SCOPE = ("https://www.googleapis.com/auth/ndev.clouddns.readwrite",)
+    """The scopes required for authenticating as a Cloud DNS consumer."""
+
+    def __init__(self, project=None, credentials=None, _http=None, client_info=None):
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+        self._connection = Connection(self, client_info=client_info)
+
+    def quotas(self):
+        """Return DNS quotas for the project associated with this client.
+
+        See
+        https://cloud.google.com/dns/api/v1/projects/get
+
+        :rtype: mapping
+        :returns: keys for the mapping correspond to those of the ``quota``
+                  sub-mapping of the project resource.
+        """
+        path = "/projects/%s" % (self.project,)
+        resp = self._connection.api_request(method="GET", path=path)
+
+        return {
+            key: int(value) for key, value in resp["quota"].items() if key != "kind"
+        }
+
+    def list_zones(self, max_results=None, page_token=None):
+        """List zones for the project associated with this client.
+
+        See
+        https://cloud.google.com/dns/api/v1/managedZones/list
+
+        :type max_results: int
+        :param max_results: maximum number of zones to return, If not
+                            passed, defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: Optional. If present, return the next batch of
+            zones, using the value, which must correspond to the
+            ``nextPageToken`` value returned in the previous response.
+            Deprecated: use the ``pages`` property of the returned iterator
+            instead of manually passing the token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~google.cloud.dns.zone.ManagedZone`
+                  belonging to this project.
+        """
+        path = "/projects/%s/managedZones" % (self.project,)
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=self._connection.api_request,
+            path=path,
+            item_to_value=_item_to_zone,
+            items_key="managedZones",
+            page_token=page_token,
+            max_results=max_results,
+        )
+
+    def zone(self, name, dns_name=None, description=None):
+        """Construct a zone bound to this client.
+
+        :type name: str
+        :param name: Name of the zone.
+
+        :type dns_name: str
+        :param dns_name:
+            (Optional) DNS name of the zone.  If not passed, then calls to
+            :meth:`zone.create` will fail.
+
+        :type description: str
+        :param description:
+            (Optional) the description for the zone.  If not passed, defaults
+            to the value of 'dns_name'.
+
+        :rtype: :class:`google.cloud.dns.zone.ManagedZone`
+        :returns: a new ``ManagedZone`` instance.
+        """
+        return ManagedZone(name, dns_name, client=self, description=description)
+
+
+def _item_to_zone(iterator, resource):
+    """Convert a JSON managed zone to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type resource: dict
+    :param resource: An item to be converted to a managed zone.
+
+    :rtype: :class:`.ManagedZone`
+    :returns: The next managed zone in the page.
+    """
+    return ManagedZone.from_api_repr(resource, iterator.client)
diff --git a/google/cloud/dns/resource_record_set.py b/dns/google/cloud/dns/resource_record_set.py
similarity index 87%
rename from google/cloud/dns/resource_record_set.py
rename to dns/google/cloud/dns/resource_record_set.py
index c3b0974b4e0e..ebb9310faa83 100644
--- a/google/cloud/dns/resource_record_set.py
+++ b/dns/google/cloud/dns/resource_record_set.py
@@ -1,4 +1,4 @@
-# Copyright 2015 Google Inc. All rights reserved.
+# Copyright 2015 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,16 +20,16 @@ class ResourceRecordSet(object):
 
     RRS are owned by a :class:`google.cloud.dns.zone.ManagedZone` instance.
 
-    See:
+    See
     https://cloud.google.com/dns/api/v1/resourceRecordSets
 
-    :type name: string
+    :type name: str
     :param name: the name of the record set.
 
-    :type record_type: string
+    :type record_type: str
     :param record_type: the RR type of the zone.
 
-    :type ttl: integer
+    :type ttl: int
     :param ttl: TTL (in seconds) for caching the record sets.
 
     :type rrdatas: list of string
@@ -59,8 +59,8 @@ def from_api_repr(cls, resource, zone):
         :rtype: :class:`google.cloud.dns.zone.ResourceRecordSet`
         :returns: RRS parsed from ``resource``.
         """
-        name = resource['name']
-        record_type = resource['type']
-        ttl = int(resource['ttl'])
-        rrdatas = resource['rrdatas']
+        name = resource["name"]
+        record_type = resource["type"]
+        ttl = int(resource["ttl"])
+        rrdatas = resource["rrdatas"]
         return cls(name, record_type, ttl, rrdatas, zone=zone)
diff --git a/dns/google/cloud/dns/zone.py b/dns/google/cloud/dns/zone.py
new file mode 100644
index 000000000000..fb37f6bdbf6a
--- /dev/null
+++ b/dns/google/cloud/dns/zone.py
@@ -0,0 +1,428 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define API ManagedZones."""
+
+import six
+
+from google.api_core import page_iterator
+from google.cloud._helpers import _rfc3339_to_datetime
+from google.cloud.exceptions import NotFound
+from google.cloud.dns.changes import Changes
+from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+
+class ManagedZone(object):
+    """ManagedZones are containers for DNS resource records.
+
+    See
+    https://cloud.google.com/dns/api/v1/managedZones
+
+    :type name: str
+    :param name: the name of the zone
+
+    :type dns_name: str
+    :param dns_name:
+        (Optional) the DNS name of the zone.  If not passed, then calls to
+        :meth:`create` will fail.
+
+    :type client: :class:`google.cloud.dns.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the zone (which requires a project).
+
+    :type description: str
+    :param description:
+        (Optional) the description for the zone.  If not passed, defaults to
+        the value of 'dns_name'.
+    """
+
+    def __init__(self, name, dns_name=None, client=None, description=None):
+        self.name = name
+        self.dns_name = dns_name
+        self._client = client
+        self._properties = {}
+        if description is None:
+            description = dns_name
+        self.description = description
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a zone given its API representation
+
+        :type resource: dict
+        :param resource: zone resource representation returned from the API
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the zone.
+
+        :rtype: :class:`google.cloud.dns.zone.ManagedZone`
+        :returns: Zone parsed from ``resource``.
+        """
+        name = resource.get("name")
+        dns_name = resource.get("dnsName")
+        if name is None or dns_name is None:
+            raise KeyError(
+                "Resource lacks required identity information:" '["name"]["dnsName"]'
+            )
+        zone = cls(name, dns_name, client=client)
+        zone._set_properties(resource)
+        return zone
+
+    @property
+    def project(self):
+        """Project bound to the zone.
+
+        :rtype: str
+        :returns: the project (derived from the client).
+        """
+        return self._client.project
+
+    @property
+    def path(self):
+        """URL path for the zone's APIs.
+
+        :rtype: str
+        :returns: the path based on project and dataste name.
+        """
+        return "/projects/%s/managedZones/%s" % (self.project, self.name)
+
+    @property
+    def created(self):
+        """Datetime at which the zone was created.
+
+        :rtype: ``datetime.datetime``, or ``NoneType``
+        :returns: the creation time (None until set from the server).
+        """
+        return self._properties.get("creationTime")
+
+    @property
+    def name_servers(self):
+        """Datetime at which the zone was created.
+
+        :rtype: list of strings, or ``NoneType``.
+        :returns: the assigned name servers (None until set from the server).
+        """
+        return self._properties.get("nameServers")
+
+    @property
+    def zone_id(self):
+        """ID for the zone resource.
+
+        :rtype: str, or ``NoneType``
+        :returns: the ID (None until set from the server).
+        """
+        return self._properties.get("id")
+
+    @property
+    def description(self):
+        """Description of the zone.
+
+        :rtype: str, or ``NoneType``
+        :returns: The description as set by the user, or None (the default).
+        """
+        return self._properties.get("description")
+
+    @description.setter
+    def description(self, value):
+        """Update description of the zone.
+
+        :type value: str
+        :param value: (Optional) new description
+
+        :raises: ValueError for invalid value types.
+        """
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["description"] = value
+
+    @property
+    def name_server_set(self):
+        """Named set of DNS name servers that all host the same ManagedZones.
+
+        Most users will leave this blank.
+
+        See
+        https://cloud.google.com/dns/api/v1/managedZones#nameServerSet
+
+        :rtype: str, or ``NoneType``
+        :returns: The name as set by the user, or None (the default).
+        """
+        return self._properties.get("nameServerSet")
+
+    @name_server_set.setter
+    def name_server_set(self, value):
+        """Update named set of DNS name servers.
+
+        :type value: str
+        :param value: (Optional) new title
+
+        :raises: ValueError for invalid value types.
+        """
+        if not isinstance(value, six.string_types) and value is not None:
+            raise ValueError("Pass a string, or None")
+        self._properties["nameServerSet"] = value
+
+    def resource_record_set(self, name, record_type, ttl, rrdatas):
+        """Construct a resource record set bound to this zone.
+
+        :type name: str
+        :param name: Name of the record set.
+
+        :type record_type: str
+        :param record_type: RR type
+
+        :type ttl: int
+        :param ttl: TTL for the RR, in seconds
+
+        :type rrdatas: list of string
+        :param rrdatas: resource data for the RR
+
+        :rtype: :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`
+        :returns: a new ``ResourceRecordSet`` instance
+        """
+        return ResourceRecordSet(name, record_type, ttl, rrdatas, zone=self)
+
+    def changes(self):
+        """Construct a change set bound to this zone.
+
+        :rtype: :class:`google.cloud.dns.changes.Changes`
+        :returns: a new ``Changes`` instance
+        """
+        return Changes(zone=self)
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: :class:`google.cloud.dns.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self._client
+        return client
+
+    def _set_properties(self, api_response):
+        """Update properties from resource in body of ``api_response``
+
+        :type api_response: dict
+        :param api_response: response returned from an API call
+        """
+        self._properties.clear()
+        cleaned = api_response.copy()
+        self.dns_name = cleaned.pop("dnsName", None)
+        if "creationTime" in cleaned:
+            cleaned["creationTime"] = _rfc3339_to_datetime(cleaned["creationTime"])
+        self._properties.update(cleaned)
+
+    def _build_resource(self):
+        """Generate a resource for ``create`` or ``update``."""
+        resource = {"name": self.name}
+
+        if self.dns_name is not None:
+            resource["dnsName"] = self.dns_name
+
+        if self.description is not None:
+            resource["description"] = self.description
+
+        if self.name_server_set is not None:
+            resource["nameServerSet"] = self.name_server_set
+
+        return resource
+
+    def create(self, client=None):
+        """API call:  create the zone via a PUT request
+
+        See
+        https://cloud.google.com/dns/api/v1/managedZones/create
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+        """
+        client = self._require_client(client)
+        path = "/projects/%s/managedZones" % (self.project,)
+        api_response = client._connection.api_request(
+            method="POST", path=path, data=self._build_resource()
+        )
+        self._set_properties(api_response)
+
+    def exists(self, client=None):
+        """API call:  test for the existence of the zone via a GET request
+
+        See
+        https://cloud.google.com/dns/api/v1/managedZones/get
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: bool
+        :returns: Boolean indicating existence of the managed zone.
+        """
+        client = self._require_client(client)
+
+        try:
+            client._connection.api_request(method="GET", path=self.path)
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self, client=None):
+        """API call:  refresh zone properties via a GET request
+
+        See
+        https://cloud.google.com/dns/api/v1/managedZones/get
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+        """
+        client = self._require_client(client)
+
+        api_response = client._connection.api_request(method="GET", path=self.path)
+        self._set_properties(api_response)
+
+    def delete(self, client=None):
+        """API call:  delete the zone via a DELETE request
+
+        See
+        https://cloud.google.com/dns/api/v1/managedZones/delete
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+        """
+        client = self._require_client(client)
+        client._connection.api_request(method="DELETE", path=self.path)
+
+    def list_resource_record_sets(self, max_results=None, page_token=None, client=None):
+        """List resource record sets for this zone.
+
+        See
+        https://cloud.google.com/dns/api/v1/resourceRecordSets/list
+
+        :type max_results: int
+        :param max_results: Optional. The maximum number of resource record
+                            sets to return. Defaults to a sensible value
+                            set by the API.
+
+        :type page_token: str
+        :param page_token: Optional. If present, return the next batch of
+            resource record sets, using the value, which must correspond to
+            the ``nextPageToken`` value returned in the previous response.
+            Deprecated: use the ``pages`` property of the returned iterator
+            instead of manually passing the token.
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~.resource_record_set.ResourceRecordSet`
+                  belonging to this zone.
+        """
+        client = self._require_client(client)
+        path = "/projects/%s/managedZones/%s/rrsets" % (self.project, self.name)
+        iterator = page_iterator.HTTPIterator(
+            client=client,
+            api_request=client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_resource_record_set,
+            items_key="rrsets",
+            page_token=page_token,
+            max_results=max_results,
+        )
+        iterator.zone = self
+        return iterator
+
+    def list_changes(self, max_results=None, page_token=None, client=None):
+        """List change sets for this zone.
+
+        See
+        https://cloud.google.com/dns/api/v1/resourceRecordSets/list
+
+        :type max_results: int
+        :param max_results: Optional. The maximum number of change sets
+            to return. Defaults to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token: Optional. If present, return the next batch of
+            change sets, using the value, which must correspond to the
+            ``nextPageToken`` value returned in the previous response.
+            Deprecated: use the ``pages`` property of the returned iterator
+            instead of manually passing the token.
+
+        :type client: :class:`google.cloud.dns.client.Client`
+        :param client:
+            (Optional) the client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~.changes.Changes`
+                  belonging to this zone.
+        """
+        client = self._require_client(client)
+        path = "/projects/%s/managedZones/%s/changes" % (self.project, self.name)
+        iterator = page_iterator.HTTPIterator(
+            client=client,
+            api_request=client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_changes,
+            items_key="changes",
+            page_token=page_token,
+            max_results=max_results,
+        )
+        iterator.zone = self
+        return iterator
+
+
+def _item_to_resource_record_set(iterator, resource):
+    """Convert a JSON resource record set value to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type resource: dict
+    :param resource: An item to be converted to a resource record set.
+
+    :rtype: :class:`~.resource_record_set.ResourceRecordSet`
+    :returns: The next resource record set in the page.
+    """
+    return ResourceRecordSet.from_api_repr(resource, iterator.zone)
+
+
+def _item_to_changes(iterator, resource):
+    """Convert a JSON "changes" value to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type resource: dict
+    :param resource: An item to be converted to a "changes".
+
+    :rtype: :class:`.Changes`
+    :returns: The next "changes" in the page.
+    """
+    return Changes.from_api_repr(resource, iterator.zone)
diff --git a/dns/noxfile.py b/dns/noxfile.py
new file mode 100644
index 000000000000..3d065844f151
--- /dev/null
+++ b/dns/noxfile.py
@@ -0,0 +1,134 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (
+    os.path.join('..', 'api_core'),
+    os.path.join('..', 'core'),
+)
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python='3.6')
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install('docutils', 'Pygments')
+    session.run(
+        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+
+
+def default(session):
+    """Default unit test session.
+
+    This is intended to be run **without** an interpreter set, so
+    that the current ``python`` (on the ``PATH``) or the version of
+    Python corresponding to the ``nox`` binary the ``PATH`` can
+    run the tests.
+    """
+    # Install all test dependencies, then install local packages in-place.
+    session.install('mock', 'pytest', 'pytest-cov')
+    for local_dep in LOCAL_DEPS:
+        session.install('-e', local_dep)
+    session.install('-e', '.')
+
+    # Run py.test against the unit tests.
+    session.run(
+        'py.test',
+        '--quiet',
+        '--cov=google.cloud.dns',
+        '--cov=tests.unit',
+        '--cov-append',
+        '--cov-config=.coveragerc',
+        '--cov-report=',
+        '--cov-fail-under=97',
+        'tests/unit',
+    )
+
+
+@nox.session(python=['2.7', '3.5', '3.6', '3.7'])
+def unit(session):
+    """Run the unit test suite."""
+
+    default(session)
+
+
+@nox.session(python='3.6')
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install('coverage', 'pytest-cov')
+    session.run('coverage', 'report', '--show-missing', '--fail-under=100')
+    session.run('coverage', 'erase')
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/dns/pylint.config.py b/dns/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/dns/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/dns/setup.cfg b/dns/setup.cfg
new file mode 100644
index 000000000000..2a9acf13daa9
--- /dev/null
+++ b/dns/setup.cfg
@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1
diff --git a/dns/setup.py b/dns/setup.py
new file mode 100644
index 000000000000..3e9da9607d04
--- /dev/null
+++ b/dns/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-dns'
+description = 'Google Cloud DNS API client library'
+version = '0.30.2'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/dns/tests/__init__.py b/dns/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/dns/tests/unit/__init__.py b/dns/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/dns/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/dns/tests/unit/test__http.py b/dns/tests/unit/test__http.py
new file mode 100644
index 000000000000..9c5198f0a7d2
--- /dev/null
+++ b/dns/tests/unit/test__http.py
@@ -0,0 +1,72 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.dns._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_build_api_url_no_extra_query_params(self):
+        conn = self._make_one(object())
+        URI = "/".join([conn.API_BASE_URL, "dns", conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_extra_query_params(self):
+        from six.moves.urllib.parse import parse_qsl
+        from six.moves.urllib.parse import urlsplit
+
+        conn = self._make_one(object())
+        uri = conn.build_api_url("/foo", {"bar": "baz"})
+        scheme, netloc, path, qs, _ = urlsplit(uri)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        self.assertEqual(path, "/".join(["", "dns", conn.API_VERSION, "foo"]))
+        parms = dict(parse_qsl(qs))
+        self.assertEqual(parms["bar"], "baz")
+
+    def test_extra_headers(self):
+        import requests
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        response_data = b"brent-spiner"
+        response._content = response_data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, response_data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
diff --git a/dns/tests/unit/test_changes.py b/dns/tests/unit/test_changes.py
new file mode 100644
index 000000000000..617110889b4f
--- /dev/null
+++ b/dns/tests/unit/test_changes.py
@@ -0,0 +1,373 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestChanges(unittest.TestCase):
+    PROJECT = "project"
+    ZONE_NAME = "example.com"
+    CHANGES_NAME = "changeset_id"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.dns.changes import Changes
+
+        return Changes
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _setUpConstants(self):
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _NOW
+
+        self.WHEN = _NOW().replace(tzinfo=UTC)
+
+    def _make_resource(self):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        when_str = _datetime_to_rfc3339(self.WHEN)
+        return {
+            "kind": "dns#change",
+            "id": self.CHANGES_NAME,
+            "startTime": when_str,
+            "status": "done",
+            "additions": [
+                {
+                    "name": "test.example.com",
+                    "type": "CNAME",
+                    "ttl": "3600",
+                    "rrdatas": ["www.example.com"],
+                }
+            ],
+            "deletions": [
+                {
+                    "name": "test.example.com",
+                    "type": "CNAME",
+                    "ttl": "86400",
+                    "rrdatas": ["other.example.com"],
+                }
+            ],
+        }
+
+    def _verifyResourceProperties(self, changes, resource, zone):
+        from google.cloud._helpers import _rfc3339_to_datetime
+
+        self.assertEqual(changes.name, resource["id"])
+        started = _rfc3339_to_datetime(resource["startTime"])
+        self.assertEqual(changes.started, started)
+        self.assertEqual(changes.status, resource["status"])
+
+        r_additions = resource.get("additions", ())
+        self.assertEqual(len(changes.additions), len(r_additions))
+        for found, expected in zip(changes.additions, r_additions):
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.record_type, expected["type"])
+            self.assertEqual(found.ttl, int(expected["ttl"]))
+            self.assertEqual(found.rrdatas, expected["rrdatas"])
+            self.assertIs(found.zone, zone)
+
+        r_deletions = resource.get("deletions", ())
+        self.assertEqual(len(changes.deletions), len(r_deletions))
+        for found, expected in zip(changes.deletions, r_deletions):
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.record_type, expected["type"])
+            self.assertEqual(found.ttl, int(expected["ttl"]))
+            self.assertEqual(found.rrdatas, expected["rrdatas"])
+            self.assertIs(found.zone, zone)
+
+    def test_ctor(self):
+        zone = _Zone()
+
+        changes = self._make_one(zone)
+
+        self.assertIs(changes.zone, zone)
+        self.assertIsNone(changes.name)
+        self.assertIsNone(changes.status)
+        self.assertIsNone(changes.started)
+        self.assertEqual(list(changes.additions), [])
+        self.assertEqual(list(changes.deletions), [])
+
+    def test_from_api_repr_missing_additions_deletions(self):
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        del RESOURCE["additions"]
+        del RESOURCE["deletions"]
+        zone = _Zone()
+        klass = self._get_target_class()
+
+        changes = klass.from_api_repr(RESOURCE, zone=zone)
+
+        self._verifyResourceProperties(changes, RESOURCE, zone)
+
+    def test_from_api_repr(self):
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        zone = _Zone()
+        klass = self._get_target_class()
+
+        changes = klass.from_api_repr(RESOURCE, zone=zone)
+
+        self._verifyResourceProperties(changes, RESOURCE, zone)
+
+    def test_name_setter_bad_value(self):
+        zone = _Zone()
+        changes = self._make_one(zone)
+        with self.assertRaises(ValueError):
+            changes.name = 12345
+
+    def test_name_setter(self):
+        zone = _Zone()
+        changes = self._make_one(zone)
+        changes.name = "NAME"
+        self.assertEqual(changes.name, "NAME")
+
+    def test_add_record_set_invalid_value(self):
+        zone = _Zone()
+        changes = self._make_one(zone)
+
+        with self.assertRaises(ValueError):
+            changes.add_record_set(object())
+
+    def test_add_record_set(self):
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        zone = _Zone()
+        changes = self._make_one(zone)
+        rrs = ResourceRecordSet(
+            "test.example.com", "CNAME", 3600, ["www.example.com"], zone
+        )
+        changes.add_record_set(rrs)
+        self.assertEqual(list(changes.additions), [rrs])
+
+    def test_delete_record_set_invalid_value(self):
+        zone = _Zone()
+        changes = self._make_one(zone)
+
+        with self.assertRaises(ValueError):
+            changes.delete_record_set(object())
+
+    def test_delete_record_set(self):
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        zone = _Zone()
+        changes = self._make_one(zone)
+        rrs = ResourceRecordSet(
+            "test.example.com", "CNAME", 3600, ["www.example.com"], zone
+        )
+        changes.delete_record_set(rrs)
+        self.assertEqual(list(changes.deletions), [rrs])
+
+    def test_create_wo_additions_or_deletions(self):
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = _Zone(client)
+        changes = self._make_one(zone)
+
+        with self.assertRaises(ValueError):
+            changes.create()
+
+        self.assertEqual(len(conn._requested), 0)
+
+    def test_create_w_bound_client(self):
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        PATH = "projects/%s/managedZones/%s/changes" % (self.PROJECT, self.ZONE_NAME)
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = _Zone(client)
+        changes = self._make_one(zone)
+        changes.add_record_set(
+            ResourceRecordSet(
+                "test.example.com", "CNAME", 3600, ["www.example.com"], zone
+            )
+        )
+        changes.delete_record_set(
+            ResourceRecordSet(
+                "test.example.com", "CNAME", 86400, ["other.example.com"], zone
+            )
+        )
+
+        changes.create()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        SENT = {"additions": RESOURCE["additions"], "deletions": RESOURCE["deletions"]}
+        self.assertEqual(req["data"], SENT)
+        self._verifyResourceProperties(changes, RESOURCE, zone)
+
+    def test_create_w_alternate_client(self):
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        PATH = "projects/%s/managedZones/%s/changes" % (self.PROJECT, self.ZONE_NAME)
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(RESOURCE)
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = _Zone(client1)
+        changes = self._make_one(zone)
+        changes.add_record_set(
+            ResourceRecordSet(
+                "test.example.com", "CNAME", 3600, ["www.example.com"], zone
+            )
+        )
+        changes.delete_record_set(
+            ResourceRecordSet(
+                "test.example.com", "CNAME", 86400, ["other.example.com"], zone
+            )
+        )
+
+        changes.create(client=client2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        SENT = {"additions": RESOURCE["additions"], "deletions": RESOURCE["deletions"]}
+        self.assertEqual(req["data"], SENT)
+        self._verifyResourceProperties(changes, RESOURCE, zone)
+
+    def test_exists_miss_w_bound_client(self):
+        PATH = "projects/%s/managedZones/%s/changes/%s" % (
+            self.PROJECT,
+            self.ZONE_NAME,
+            self.CHANGES_NAME,
+        )
+        self._setUpConstants()
+        conn = _Connection()
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = _Zone(client)
+        changes = self._make_one(zone)
+        changes.name = self.CHANGES_NAME
+
+        self.assertFalse(changes.exists())
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self.assertEqual(req["query_params"], {"fields": "id"})
+
+    def test_exists_hit_w_alternate_client(self):
+        PATH = "projects/%s/managedZones/%s/changes/%s" % (
+            self.PROJECT,
+            self.ZONE_NAME,
+            self.CHANGES_NAME,
+        )
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection({})
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = _Zone(client1)
+        changes = self._make_one(zone)
+        changes.name = self.CHANGES_NAME
+
+        self.assertTrue(changes.exists(client=client2))
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self.assertEqual(req["query_params"], {"fields": "id"})
+
+    def test_reload_w_bound_client(self):
+        PATH = "projects/%s/managedZones/%s/changes/%s" % (
+            self.PROJECT,
+            self.ZONE_NAME,
+            self.CHANGES_NAME,
+        )
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = _Zone(client)
+        changes = self._make_one(zone)
+        changes.name = self.CHANGES_NAME
+
+        changes.reload()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self._verifyResourceProperties(changes, RESOURCE, zone)
+
+    def test_reload_w_alternate_client(self):
+        PATH = "projects/%s/managedZones/%s/changes/%s" % (
+            self.PROJECT,
+            self.ZONE_NAME,
+            self.CHANGES_NAME,
+        )
+        self._setUpConstants()
+        RESOURCE = self._make_resource()
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(RESOURCE)
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = _Zone(client1)
+        changes = self._make_one(zone)
+        changes.name = self.CHANGES_NAME
+
+        changes.reload(client=client2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self._verifyResourceProperties(changes, RESOURCE, zone)
+
+
+class _Zone(object):
+    def __init__(
+        self, client=None, project=TestChanges.PROJECT, name=TestChanges.ZONE_NAME
+    ):
+        self._client = client
+        self.project = project
+        self.name = name
+
+
+class _Client(object):
+    def __init__(self, project="project", connection=None):
+        self.project = project
+        self._connection = connection
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        self._requested.append(kw)
+
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        else:
+            return response
diff --git a/dns/tests/unit/test_client.py b/dns/tests/unit/test_client.py
new file mode 100644
index 000000000000..5ca6eec98a1f
--- /dev/null
+++ b/dns/tests/unit/test_client.py
@@ -0,0 +1,284 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    ZONE_NAME = "zone-name"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.dns.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        from google.api_core.client_info import ClientInfo
+        from google.cloud.dns._http import Connection
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _http=http)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, creds)
+        self.assertIs(client._connection.http, http)
+        self.assertIsInstance(client._connection._client_info, ClientInfo)
+
+    def test_ctor_w_client_info(self):
+        from google.api_core.client_info import ClientInfo
+        from google.cloud.dns._http import Connection
+
+        client_info = ClientInfo()
+
+        creds = _make_credentials()
+        http = object()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _http=http, client_info=client_info
+        )
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, creds)
+        self.assertIs(client._connection.http, http)
+        self.assertIs(client._connection._client_info, client_info)
+
+    def test_quotas_defaults(self):
+        PATH = "projects/%s" % (self.PROJECT,)
+        MANAGED_ZONES = 1234
+        RRS_PER_RRSET = 23
+        RRSETS_PER_ZONE = 345
+        RRSET_ADDITIONS = 456
+        RRSET_DELETIONS = 567
+        TOTAL_SIZE = 67890
+        DATA = {
+            "quota": {
+                "managedZones": str(MANAGED_ZONES),
+                "resourceRecordsPerRrset": str(RRS_PER_RRSET),
+                "rrsetsPerManagedZone": str(RRSETS_PER_ZONE),
+                "rrsetAdditionsPerChange": str(RRSET_ADDITIONS),
+                "rrsetDeletionsPerChange": str(RRSET_DELETIONS),
+                "totalRrdataSizePerChange": str(TOTAL_SIZE),
+            }
+        }
+        CONVERTED = {key: int(value) for key, value in DATA["quota"].items()}
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = _Connection(DATA)
+
+        quotas = client.quotas()
+
+        self.assertEqual(quotas, CONVERTED)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_quotas_w_kind_key(self):
+        PATH = "projects/%s" % (self.PROJECT,)
+        MANAGED_ZONES = 1234
+        RRS_PER_RRSET = 23
+        RRSETS_PER_ZONE = 345
+        RRSET_ADDITIONS = 456
+        RRSET_DELETIONS = 567
+        TOTAL_SIZE = 67890
+        DATA = {
+            "quota": {
+                "managedZones": str(MANAGED_ZONES),
+                "resourceRecordsPerRrset": str(RRS_PER_RRSET),
+                "rrsetsPerManagedZone": str(RRSETS_PER_ZONE),
+                "rrsetAdditionsPerChange": str(RRSET_ADDITIONS),
+                "rrsetDeletionsPerChange": str(RRSET_DELETIONS),
+                "totalRrdataSizePerChange": str(TOTAL_SIZE),
+            }
+        }
+        CONVERTED = {key: int(value) for key, value in DATA["quota"].items()}
+        WITH_KIND = {"quota": DATA["quota"].copy()}
+        WITH_KIND["quota"]["kind"] = "dns#quota"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = _Connection(WITH_KIND)
+
+        quotas = client.quotas()
+
+        self.assertEqual(quotas, CONVERTED)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_list_zones_defaults(self):
+        import six
+        from google.cloud.dns.zone import ManagedZone
+
+        ID_1 = "123"
+        ZONE_1 = "zone_one"
+        DNS_1 = "one.example.com"
+        ID_2 = "234"
+        ZONE_2 = "zone_two"
+        DNS_2 = "two.example.com"
+        PATH = "projects/%s/managedZones" % (self.PROJECT,)
+        TOKEN = "TOKEN"
+        DATA = {
+            "nextPageToken": TOKEN,
+            "managedZones": [
+                {
+                    "kind": "dns#managedZone",
+                    "id": ID_1,
+                    "name": ZONE_1,
+                    "dnsName": DNS_1,
+                },
+                {
+                    "kind": "dns#managedZone",
+                    "id": ID_2,
+                    "name": ZONE_2,
+                    "dnsName": DNS_2,
+                },
+            ],
+        }
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = _Connection(DATA)
+
+        iterator = client.list_zones()
+        page = six.next(iterator.pages)
+        zones = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(zones), len(DATA["managedZones"]))
+        for found, expected in zip(zones, DATA["managedZones"]):
+            self.assertIsInstance(found, ManagedZone)
+            self.assertEqual(found.zone_id, expected["id"])
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.dns_name, expected["dnsName"])
+        self.assertEqual(token, TOKEN)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_list_zones_explicit(self):
+        import six
+        from google.cloud.dns.zone import ManagedZone
+
+        ID_1 = "123"
+        ZONE_1 = "zone_one"
+        DNS_1 = "one.example.com"
+        ID_2 = "234"
+        ZONE_2 = "zone_two"
+        DNS_2 = "two.example.com"
+        PATH = "projects/%s/managedZones" % (self.PROJECT,)
+        TOKEN = "TOKEN"
+        DATA = {
+            "managedZones": [
+                {
+                    "kind": "dns#managedZone",
+                    "id": ID_1,
+                    "name": ZONE_1,
+                    "dnsName": DNS_1,
+                },
+                {
+                    "kind": "dns#managedZone",
+                    "id": ID_2,
+                    "name": ZONE_2,
+                    "dnsName": DNS_2,
+                },
+            ]
+        }
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        conn = client._connection = _Connection(DATA)
+
+        iterator = client.list_zones(max_results=3, page_token=TOKEN)
+        page = six.next(iterator.pages)
+        zones = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(zones), len(DATA["managedZones"]))
+        for found, expected in zip(zones, DATA["managedZones"]):
+            self.assertIsInstance(found, ManagedZone)
+            self.assertEqual(found.zone_id, expected["id"])
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.dns_name, expected["dnsName"])
+        self.assertIsNone(token)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self.assertEqual(req["query_params"], {"maxResults": 3, "pageToken": TOKEN})
+
+    def test_zone_explicit(self):
+        from google.cloud.dns.zone import ManagedZone
+
+        DESCRIPTION = "DESCRIPTION"
+        DNS_NAME = "test.example.com"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        zone = client.zone(self.ZONE_NAME, DNS_NAME, DESCRIPTION)
+        self.assertIsInstance(zone, ManagedZone)
+        self.assertEqual(zone.name, self.ZONE_NAME)
+        self.assertEqual(zone.dns_name, DNS_NAME)
+        self.assertEqual(zone.description, DESCRIPTION)
+        self.assertIs(zone._client, client)
+
+    def test_zone_w_dns_name_wo_description(self):
+        from google.cloud.dns.zone import ManagedZone
+
+        DNS_NAME = "test.example.com"
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        zone = client.zone(self.ZONE_NAME, DNS_NAME)
+        self.assertIsInstance(zone, ManagedZone)
+        self.assertEqual(zone.name, self.ZONE_NAME)
+        self.assertEqual(zone.dns_name, DNS_NAME)
+        self.assertEqual(zone.description, DNS_NAME)
+        self.assertIs(zone._client, client)
+
+    def test_zone_wo_dns_name(self):
+        from google.cloud.dns.zone import ManagedZone
+
+        creds = _make_credentials()
+        client = self._make_one(self.PROJECT, creds)
+        zone = client.zone(self.ZONE_NAME)
+        self.assertIsInstance(zone, ManagedZone)
+        self.assertEqual(zone.name, self.ZONE_NAME)
+        self.assertIsNone(zone.dns_name)
+        self.assertIsNone(zone.description)
+        self.assertIs(zone._client, client)
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
diff --git a/dns/tests/unit/test_resource_record_set.py b/dns/tests/unit/test_resource_record_set.py
new file mode 100644
index 000000000000..d0869d27bdb6
--- /dev/null
+++ b/dns/tests/unit/test_resource_record_set.py
@@ -0,0 +1,107 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestResourceRecordSet(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        return ResourceRecordSet
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        zone = _Zone()
+
+        rrs = self._make_one(
+            "test.example.com", "CNAME", 3600, ["www.example.com"], zone
+        )
+
+        self.assertEqual(rrs.name, "test.example.com")
+        self.assertEqual(rrs.record_type, "CNAME")
+        self.assertEqual(rrs.ttl, 3600)
+        self.assertEqual(rrs.rrdatas, ["www.example.com"])
+        self.assertIs(rrs.zone, zone)
+
+    def test_from_api_repr_missing_rrdatas(self):
+        zone = _Zone()
+        klass = self._get_target_class()
+
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(
+                {"name": "test.example.com", "type": "CNAME", "ttl": 3600}, zone=zone
+            )
+
+    def test_from_api_repr_missing_ttl(self):
+        zone = _Zone()
+        klass = self._get_target_class()
+
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(
+                {
+                    "name": "test.example.com",
+                    "type": "CNAME",
+                    "rrdatas": ["www.example.com"],
+                },
+                zone=zone,
+            )
+
+    def test_from_api_repr_missing_type(self):
+        zone = _Zone()
+        klass = self._get_target_class()
+
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(
+                {
+                    "name": "test.example.com",
+                    "ttl": 3600,
+                    "rrdatas": ["www.example.com"],
+                },
+                zone=zone,
+            )
+
+    def test_from_api_repr_missing_name(self):
+        zone = _Zone()
+        klass = self._get_target_class()
+
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(
+                {"type": "CNAME", "ttl": 3600, "rrdatas": ["www.example.com"]},
+                zone=zone,
+            )
+
+    def test_from_api_repr_bare(self):
+        zone = _Zone()
+        RESOURCE = {
+            "kind": "dns#resourceRecordSet",
+            "name": "test.example.com",
+            "type": "CNAME",
+            "ttl": "3600",
+            "rrdatas": ["www.example.com"],
+        }
+        klass = self._get_target_class()
+        rrs = klass.from_api_repr(RESOURCE, zone=zone)
+        self.assertEqual(rrs.name, "test.example.com")
+        self.assertEqual(rrs.record_type, "CNAME")
+        self.assertEqual(rrs.ttl, 3600)
+        self.assertEqual(rrs.rrdatas, ["www.example.com"])
+        self.assertIs(rrs.zone, zone)
+
+
+class _Zone(object):
+    pass
diff --git a/dns/tests/unit/test_zone.py b/dns/tests/unit/test_zone.py
new file mode 100644
index 000000000000..21d55bcc1b65
--- /dev/null
+++ b/dns/tests/unit/test_zone.py
@@ -0,0 +1,707 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestManagedZone(unittest.TestCase):
+    PROJECT = "project"
+    ZONE_NAME = "zone-name"
+    DESCRIPTION = "ZONE DESCRIPTION"
+    DNS_NAME = "test.example.com"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.dns.zone import ManagedZone
+
+        return ManagedZone
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _setUpConstants(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        year = 2015
+        month = 7
+        day = 24
+        hour = 19
+        minute = 53
+        seconds = 19
+        micros = 6000
+
+        self.WHEN_STR = "%d-%02d-%02dT%02d:%02d:%02d.%06dZ" % (
+            year,
+            month,
+            day,
+            hour,
+            minute,
+            seconds,
+            micros,
+        )
+        self.WHEN = datetime.datetime(
+            year, month, day, hour, minute, seconds, micros, tzinfo=UTC
+        )
+        self.ZONE_ID = 12345
+
+    def _make_resource(self):
+        self._setUpConstants()
+        return {
+            "name": self.ZONE_NAME,
+            "dnsName": self.DNS_NAME,
+            "description": self.DESCRIPTION,
+            "id": self.ZONE_ID,
+            "creationTime": self.WHEN_STR,
+            "nameServers": [
+                "ns-cloud1.googledomains.com",
+                "ns-cloud2.googledomains.com",
+            ],
+        }
+
+    def _verifyReadonlyResourceProperties(self, zone, resource):
+        self.assertEqual(zone.zone_id, resource.get("id"))
+
+        if "creationTime" in resource:
+            self.assertEqual(zone.created, self.WHEN)
+        else:
+            self.assertIsNone(zone.created)
+
+        if "nameServers" in resource:
+            self.assertEqual(zone.name_servers, resource["nameServers"])
+        else:
+            self.assertIsNone(zone.name_servers)
+
+    def _verifyResourceProperties(self, zone, resource):
+        self._verifyReadonlyResourceProperties(zone, resource)
+
+        self.assertEqual(zone.name, resource.get("name"))
+        self.assertEqual(zone.dns_name, resource.get("dnsName"))
+        self.assertEqual(zone.description, resource.get("description"))
+        self.assertEqual(zone.zone_id, resource.get("id"))
+        self.assertEqual(zone.name_server_set, resource.get("nameServerSet"))
+
+    def test_ctor_defaults(self):
+        zone = self._make_one(self.ZONE_NAME)
+        self.assertEqual(zone.name, self.ZONE_NAME)
+        self.assertIsNone(zone.dns_name)
+        self.assertIsNone(zone._client)
+
+        with self.assertRaises(AttributeError):
+            (zone.project)
+
+        with self.assertRaises(AttributeError):
+            (zone.path)
+
+        self.assertIsNone(zone.zone_id)
+        self.assertIsNone(zone.created)
+        self.assertIsNone(zone.description)
+
+    def test_ctor_wo_description(self):
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        self.assertEqual(zone.name, self.ZONE_NAME)
+        self.assertEqual(zone.dns_name, self.DNS_NAME)
+        self.assertIs(zone._client, client)
+        self.assertEqual(zone.project, client.project)
+        self.assertEqual(
+            zone.path, "/projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        )
+        self.assertIsNone(zone.zone_id)
+        self.assertIsNone(zone.created)
+        self.assertEqual(zone.description, self.DNS_NAME)
+
+    def test_ctor_explicit(self):
+        DESCRIPTION = "DESCRIPTION"
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client, DESCRIPTION)
+        self.assertEqual(zone.name, self.ZONE_NAME)
+        self.assertEqual(zone.dns_name, self.DNS_NAME)
+        self.assertIs(zone._client, client)
+        self.assertEqual(zone.project, client.project)
+        self.assertEqual(
+            zone.path, "/projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        )
+        self.assertIsNone(zone.zone_id)
+        self.assertIsNone(zone.created)
+        self.assertEqual(zone.description, DESCRIPTION)
+
+    def test_from_api_repr_missing_identity(self):
+        self._setUpConstants()
+        client = _Client(self.PROJECT)
+        RESOURCE = {}
+        klass = self._get_target_class()
+        with self.assertRaises(KeyError):
+            klass.from_api_repr(RESOURCE, client=client)
+
+    def test_from_api_repr_bare(self):
+        self._setUpConstants()
+        client = _Client(self.PROJECT)
+        RESOURCE = {"name": self.ZONE_NAME, "dnsName": self.DNS_NAME}
+        klass = self._get_target_class()
+        zone = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(zone._client, client)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_from_api_repr_w_properties(self):
+        self._setUpConstants()
+        client = _Client(self.PROJECT)
+        RESOURCE = self._make_resource()
+        klass = self._get_target_class()
+        zone = klass.from_api_repr(RESOURCE, client=client)
+        self.assertIs(zone._client, client)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_description_setter_bad_value(self):
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        with self.assertRaises(ValueError):
+            zone.description = 12345
+
+    def test_description_setter(self):
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        zone.description = "DESCRIPTION"
+        self.assertEqual(zone.description, "DESCRIPTION")
+
+    def test_name_server_set_setter_bad_value(self):
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        with self.assertRaises(ValueError):
+            zone.name_server_set = 12345
+
+    def test_name_server_set_setter(self):
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        zone.name_server_set = "NAME_SERVER_SET"
+        self.assertEqual(zone.name_server_set, "NAME_SERVER_SET")
+
+    def test_resource_record_set(self):
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        RRS_NAME = "other.example.com"
+        RRS_TYPE = "CNAME"
+        TTL = 3600
+        RRDATAS = ["www.example.com"]
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        rrs = zone.resource_record_set(RRS_NAME, RRS_TYPE, TTL, RRDATAS)
+        self.assertIsInstance(rrs, ResourceRecordSet)
+        self.assertEqual(rrs.name, RRS_NAME)
+        self.assertEqual(rrs.record_type, RRS_TYPE)
+        self.assertEqual(rrs.ttl, TTL)
+        self.assertEqual(rrs.rrdatas, RRDATAS)
+        self.assertIs(rrs.zone, zone)
+
+    def test_changes(self):
+        from google.cloud.dns.changes import Changes
+
+        client = _Client(self.PROJECT)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+        changes = zone.changes()
+        self.assertIsInstance(changes, Changes)
+        self.assertIs(changes.zone, zone)
+
+    def test_create_w_bound_client(self):
+        PATH = "projects/%s/managedZones" % self.PROJECT
+        RESOURCE = self._make_resource()
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+
+        zone.create()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        SENT = {
+            "name": self.ZONE_NAME,
+            "dnsName": self.DNS_NAME,
+            "description": self.DNS_NAME,
+        }
+        self.assertEqual(req["data"], SENT)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_create_w_alternate_client(self):
+        PATH = "projects/%s/managedZones" % self.PROJECT
+        DESCRIPTION = "DESCRIPTION"
+        NAME_SERVER_SET = "NAME_SERVER_SET"
+        RESOURCE = self._make_resource()
+        RESOURCE["nameServerSet"] = NAME_SERVER_SET
+        RESOURCE["description"] = DESCRIPTION
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(RESOURCE)
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client1)
+        zone.name_server_set = NAME_SERVER_SET
+        zone.description = DESCRIPTION
+
+        zone.create(client=client2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        SENT = {
+            "name": self.ZONE_NAME,
+            "dnsName": self.DNS_NAME,
+            "nameServerSet": NAME_SERVER_SET,
+            "description": DESCRIPTION,
+        }
+        self.assertEqual(req["data"], SENT)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_create_wo_dns_name_or_description(self):
+        from google.cloud.exceptions import BadRequest
+
+        PATH = "projects/%s/managedZones" % self.PROJECT
+
+        _requested = []
+
+        def _api_request(**kw):
+            _requested.append(kw)
+            raise BadRequest("missing dns_name / description")
+
+        conn = _Connection()
+        conn.api_request = _api_request
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, client=client)
+
+        with self.assertRaises(BadRequest):
+            zone.create()
+
+        self.assertEqual(len(_requested), 1)
+        req = _requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        SENT = {"name": self.ZONE_NAME}
+        self.assertEqual(req["data"], SENT)
+
+    def test_create_w_missing_output_properties(self):
+        # In the wild, the resource returned from 'zone.create' sometimes
+        # lacks 'creationTime' / 'lastModifiedTime'
+        PATH = "projects/%s/managedZones" % (self.PROJECT,)
+        RESOURCE = self._make_resource()
+        del RESOURCE["creationTime"]
+        del RESOURCE["id"]
+        del RESOURCE["nameServers"]
+        self.WHEN = None
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+
+        zone.create()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        SENT = {
+            "name": self.ZONE_NAME,
+            "dnsName": self.DNS_NAME,
+            "description": self.DNS_NAME,
+        }
+        self.assertEqual(req["data"], SENT)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_exists_miss_w_bound_client(self):
+        PATH = "projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        conn = _Connection()
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+
+        self.assertFalse(zone.exists())
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_exists_hit_w_alternate_client(self):
+        PATH = "projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection({})
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client1)
+
+        self.assertTrue(zone.exists(client=client2))
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_reload_w_bound_client(self):
+        PATH = "projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        RESOURCE = self._make_resource()
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, client=client)
+
+        zone.reload()
+
+        self.assertEqual(zone.dns_name, self.DNS_NAME)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        PATH = "projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        RESOURCE = self._make_resource()
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(RESOURCE)
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client1)
+
+        zone.reload(client=client2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self._verifyResourceProperties(zone, RESOURCE)
+
+    def test_delete_w_bound_client(self):
+        PATH = "projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        conn = _Connection({})
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+
+        zone.delete()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "DELETE")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_delete_w_alternate_client(self):
+        PATH = "projects/%s/managedZones/%s" % (self.PROJECT, self.ZONE_NAME)
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection({})
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client1)
+
+        zone.delete(client=client2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "DELETE")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_list_resource_record_sets_defaults(self):
+        import six
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        PATH = "projects/%s/managedZones/%s/rrsets" % (self.PROJECT, self.ZONE_NAME)
+        TOKEN = "TOKEN"
+        NAME_1 = "www.example.com"
+        TYPE_1 = "A"
+        TTL_1 = "86400"
+        RRDATAS_1 = ["123.45.67.89"]
+        NAME_2 = "alias.example.com"
+        TYPE_2 = "CNAME"
+        TTL_2 = "3600"
+        RRDATAS_2 = ["www.example.com"]
+        DATA = {
+            "nextPageToken": TOKEN,
+            "rrsets": [
+                {
+                    "kind": "dns#resourceRecordSet",
+                    "name": NAME_1,
+                    "type": TYPE_1,
+                    "ttl": TTL_1,
+                    "rrdatas": RRDATAS_1,
+                },
+                {
+                    "kind": "dns#resourceRecordSet",
+                    "name": NAME_2,
+                    "type": TYPE_2,
+                    "ttl": TTL_2,
+                    "rrdatas": RRDATAS_2,
+                },
+            ],
+        }
+        conn = _Connection(DATA)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+
+        iterator = zone.list_resource_record_sets()
+        self.assertIs(zone, iterator.zone)
+        page = six.next(iterator.pages)
+        rrsets = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(rrsets), len(DATA["rrsets"]))
+        for found, expected in zip(rrsets, DATA["rrsets"]):
+            self.assertIsInstance(found, ResourceRecordSet)
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.record_type, expected["type"])
+            self.assertEqual(found.ttl, int(expected["ttl"]))
+            self.assertEqual(found.rrdatas, expected["rrdatas"])
+        self.assertEqual(token, TOKEN)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+
+    def test_list_resource_record_sets_explicit(self):
+        import six
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        PATH = "projects/%s/managedZones/%s/rrsets" % (self.PROJECT, self.ZONE_NAME)
+        TOKEN = "TOKEN"
+        NAME_1 = "www.example.com"
+        TYPE_1 = "A"
+        TTL_1 = "86400"
+        RRDATAS_1 = ["123.45.67.89"]
+        NAME_2 = "alias.example.com"
+        TYPE_2 = "CNAME"
+        TTL_2 = "3600"
+        RRDATAS_2 = ["www.example.com"]
+        DATA = {
+            "rrsets": [
+                {
+                    "kind": "dns#resourceRecordSet",
+                    "name": NAME_1,
+                    "type": TYPE_1,
+                    "ttl": TTL_1,
+                    "rrdatas": RRDATAS_1,
+                },
+                {
+                    "kind": "dns#resourceRecordSet",
+                    "name": NAME_2,
+                    "type": TYPE_2,
+                    "ttl": TTL_2,
+                    "rrdatas": RRDATAS_2,
+                },
+            ]
+        }
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(DATA)
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client1)
+
+        iterator = zone.list_resource_record_sets(
+            max_results=3, page_token=TOKEN, client=client2
+        )
+        self.assertIs(zone, iterator.zone)
+        page = six.next(iterator.pages)
+        rrsets = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(rrsets), len(DATA["rrsets"]))
+        for found, expected in zip(rrsets, DATA["rrsets"]):
+            self.assertIsInstance(found, ResourceRecordSet)
+            self.assertEqual(found.name, expected["name"])
+            self.assertEqual(found.record_type, expected["type"])
+            self.assertEqual(found.ttl, int(expected["ttl"]))
+            self.assertEqual(found.rrdatas, expected["rrdatas"])
+        self.assertIsNone(token)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % PATH)
+        self.assertEqual(req["query_params"], {"maxResults": 3, "pageToken": TOKEN})
+
+    def _get_changes(self, token, changes_name):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        name_1 = "www.example.com"
+        type_1 = "A"
+        ttl_1 = "86400"
+        rrdatas_1 = ["123.45.67.89"]
+        name_2 = "alias.example.com"
+        type_2 = "CNAME"
+        ttl_2 = "3600"
+        rrdatas_2 = ["www.example.com"]
+        result = {
+            "changes": [
+                {
+                    "kind": "dns#change",
+                    "id": changes_name,
+                    "status": "pending",
+                    "startTime": _datetime_to_rfc3339(self.WHEN),
+                    "additions": [
+                        {
+                            "kind": "dns#resourceRecordSet",
+                            "name": name_1,
+                            "type": type_1,
+                            "ttl": ttl_1,
+                            "rrdatas": rrdatas_1,
+                        }
+                    ],
+                    "deletions": [
+                        {
+                            "kind": "dns#change",
+                            "name": name_2,
+                            "type": type_2,
+                            "ttl": ttl_2,
+                            "rrdatas": rrdatas_2,
+                        }
+                    ],
+                }
+            ]
+        }
+        if token is not None:
+            result["nextPageToken"] = token
+        return result
+
+    def test_list_changes_defaults(self):
+        import six
+        from google.cloud.dns.changes import Changes
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        self._setUpConstants()
+        path = "projects/%s/managedZones/%s/changes" % (self.PROJECT, self.ZONE_NAME)
+        token = "TOKEN"
+        changes_name = "changeset_id"
+        data = self._get_changes(token, changes_name)
+
+        conn = _Connection(data)
+        client = _Client(project=self.PROJECT, connection=conn)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client)
+
+        iterator = zone.list_changes()
+        self.assertIs(zone, iterator.zone)
+        page = six.next(iterator.pages)
+        changes = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(changes), len(data["changes"]))
+        for found, expected in zip(changes, data["changes"]):
+            self.assertIsInstance(found, Changes)
+            self.assertEqual(found.name, changes_name)
+            self.assertEqual(found.status, "pending")
+            self.assertEqual(found.started, self.WHEN)
+
+            self.assertEqual(len(found.additions), len(expected["additions"]))
+            for found_rr, expected_rr in zip(found.additions, expected["additions"]):
+                self.assertIsInstance(found_rr, ResourceRecordSet)
+                self.assertEqual(found_rr.name, expected_rr["name"])
+                self.assertEqual(found_rr.record_type, expected_rr["type"])
+                self.assertEqual(found_rr.ttl, int(expected_rr["ttl"]))
+                self.assertEqual(found_rr.rrdatas, expected_rr["rrdatas"])
+
+            self.assertEqual(len(found.deletions), len(expected["deletions"]))
+            for found_rr, expected_rr in zip(found.deletions, expected["deletions"]):
+                self.assertIsInstance(found_rr, ResourceRecordSet)
+                self.assertEqual(found_rr.name, expected_rr["name"])
+                self.assertEqual(found_rr.record_type, expected_rr["type"])
+                self.assertEqual(found_rr.ttl, int(expected_rr["ttl"]))
+                self.assertEqual(found_rr.rrdatas, expected_rr["rrdatas"])
+
+        self.assertEqual(token, token)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (path,))
+
+    def test_list_changes_explicit(self):
+        import six
+        from google.cloud.dns.changes import Changes
+        from google.cloud.dns.resource_record_set import ResourceRecordSet
+
+        self._setUpConstants()
+        path = "projects/%s/managedZones/%s/changes" % (self.PROJECT, self.ZONE_NAME)
+        changes_name = "changeset_id"
+        data = self._get_changes(None, changes_name)
+        conn1 = _Connection()
+        client1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(data)
+        client2 = _Client(project=self.PROJECT, connection=conn2)
+        zone = self._make_one(self.ZONE_NAME, self.DNS_NAME, client1)
+
+        page_token = "TOKEN"
+        iterator = zone.list_changes(
+            max_results=3, page_token=page_token, client=client2
+        )
+        self.assertIs(zone, iterator.zone)
+        page = six.next(iterator.pages)
+        changes = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(changes), len(data["changes"]))
+        for found, expected in zip(changes, data["changes"]):
+            self.assertIsInstance(found, Changes)
+            self.assertEqual(found.name, changes_name)
+            self.assertEqual(found.status, "pending")
+            self.assertEqual(found.started, self.WHEN)
+
+            self.assertEqual(len(found.additions), len(expected["additions"]))
+            for found_rr, expected_rr in zip(found.additions, expected["additions"]):
+                self.assertIsInstance(found_rr, ResourceRecordSet)
+                self.assertEqual(found_rr.name, expected_rr["name"])
+                self.assertEqual(found_rr.record_type, expected_rr["type"])
+                self.assertEqual(found_rr.ttl, int(expected_rr["ttl"]))
+                self.assertEqual(found_rr.rrdatas, expected_rr["rrdatas"])
+
+            self.assertEqual(len(found.deletions), len(expected["deletions"]))
+            for found_rr, expected_rr in zip(found.deletions, expected["deletions"]):
+                self.assertIsInstance(found_rr, ResourceRecordSet)
+                self.assertEqual(found_rr.name, expected_rr["name"])
+                self.assertEqual(found_rr.record_type, expected_rr["type"])
+                self.assertEqual(found_rr.ttl, int(expected_rr["ttl"]))
+                self.assertEqual(found_rr.rrdatas, expected_rr["rrdatas"])
+
+        self.assertIsNone(token)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (path,))
+        self.assertEqual(
+            req["query_params"], {"maxResults": 3, "pageToken": page_token}
+        )
+
+
+class _Client(object):
+    def __init__(self, project="project", connection=None):
+        self.project = project
+        self._connection = connection
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        self._requested.append(kw)
+
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        else:
+            return response
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
new file mode 100644
index 000000000000..3d0319dd337c
--- /dev/null
+++ b/docs/_static/custom.css
@@ -0,0 +1,16 @@
+@import url('https://fonts.googleapis.com/css?family=Roboto|Roboto+Mono');
+
+@media screen and (min-width: 1080px) {
+    div.document {
+        width: 1040px;
+    }
+}
+
+code.descname {
+    color: #4885ed;
+}
+
+th.field-name {
+    min-width: 100px;
+    color: #3cba54;
+}
diff --git a/docs/_templates/autosummary/class.rst b/docs/_templates/autosummary/class.rst
new file mode 120000
index 000000000000..bd3c7e22590e
--- /dev/null
+++ b/docs/_templates/autosummary/class.rst
@@ -0,0 +1 @@
+../../../third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/class.rst
\ No newline at end of file
diff --git a/docs/_templates/autosummary/module.rst b/docs/_templates/autosummary/module.rst
new file mode 120000
index 000000000000..afd9c7b5e867
--- /dev/null
+++ b/docs/_templates/autosummary/module.rst
@@ -0,0 +1 @@
+../../../third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/module.rst
\ No newline at end of file
diff --git a/docs/asset b/docs/asset
new file mode 120000
index 000000000000..86aa41c40852
--- /dev/null
+++ b/docs/asset
@@ -0,0 +1 @@
+../asset/docs
\ No newline at end of file
diff --git a/docs/automl b/docs/automl
new file mode 120000
index 000000000000..9e2b42485592
--- /dev/null
+++ b/docs/automl
@@ -0,0 +1 @@
+../automl/docs
\ No newline at end of file
diff --git a/docs/bigquery b/docs/bigquery
new file mode 120000
index 000000000000..eb7d0e491992
--- /dev/null
+++ b/docs/bigquery
@@ -0,0 +1 @@
+../bigquery/docs/
\ No newline at end of file
diff --git a/docs/bigquery-client.rst b/docs/bigquery-client.rst
deleted file mode 100644
index a1c41f689ce4..000000000000
--- a/docs/bigquery-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-BigQuery Client
-===============
-
-.. automodule:: google.cloud.bigquery.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.bigquery.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/bigquery-dataset.rst b/docs/bigquery-dataset.rst
deleted file mode 100644
index dd1d05352918..000000000000
--- a/docs/bigquery-dataset.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Datasets
-~~~~~~~~
-
-.. automodule:: google.cloud.bigquery.dataset
-  :members:
-  :show-inheritance:
diff --git a/docs/bigquery-job.rst b/docs/bigquery-job.rst
deleted file mode 100644
index 7745a1ceb13a..000000000000
--- a/docs/bigquery-job.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Jobs
-~~~~
-
-.. automodule:: google.cloud.bigquery.job
-  :members:
-  :show-inheritance:
diff --git a/docs/bigquery-query.rst b/docs/bigquery-query.rst
deleted file mode 100644
index d8b9da09cde0..000000000000
--- a/docs/bigquery-query.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Query
-~~~~~
-
-.. automodule:: google.cloud.bigquery.query
-  :members:
-  :show-inheritance:
diff --git a/docs/bigquery-schema.rst b/docs/bigquery-schema.rst
deleted file mode 100644
index c8bf3edc18c3..000000000000
--- a/docs/bigquery-schema.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Schemas
-~~~~~~~
-
-.. automodule:: google.cloud.bigquery.schema
-  :members:
-  :show-inheritance:
-
diff --git a/docs/bigquery-table.rst b/docs/bigquery-table.rst
deleted file mode 100644
index 713f6116c932..000000000000
--- a/docs/bigquery-table.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Tables
-~~~~~~
-
-.. automodule:: google.cloud.bigquery.table
-  :members:
-  :show-inheritance:
diff --git a/docs/bigquery-usage.rst b/docs/bigquery-usage.rst
deleted file mode 100644
index 91e59003dc94..000000000000
--- a/docs/bigquery-usage.rst
+++ /dev/null
@@ -1,472 +0,0 @@
-Using the API
-=============
-
-Authentication / Configuration
-------------------------------
-
-- Use :class:`Client <google.cloud.bigquery.client.Client>` objects to configure
-  your applications.
-
-- :class:`Client <google.cloud.bigquery.client.Client>` objects hold both a ``project``
-  and an authenticated connection to the BigQuery service.
-
-- The authentication credentials can be implicitly determined from the
-  environment or directly via
-  :meth:`from_service_account_json <google.cloud.bigquery.client.Client.from_service_account_json>`
-  and
-  :meth:`from_service_account_p12 <google.cloud.bigquery.client.Client.from_service_account_p12>`.
-
-- After setting :envvar:`GOOGLE_APPLICATION_CREDENTIALS` and
-  :envvar:`GOOGLE_CLOUD_PROJECT` environment variables, create an instance of
-  :class:`Client <google.cloud.bigquery.client.Client>`.
-
-  .. doctest::
-
-     >>> from google.cloud import bigquery
-     >>> client = bigquery.Client()
-
-
-Projects
---------
-
-A project is the top-level container in the ``BigQuery`` API:  it is tied
-closely to billing, and can provide default access control across all its
-datasets.  If no ``project`` is passed to the client container, the library
-attempts to infer a project using the environment (including explicit
-environment variables, GAE, and GCE).
-
-To override the project inferred from the environment, pass an explicit
-``project`` to the constructor, or to either of the alternative
-``classmethod`` factories:
-
-  .. doctest::
-
-     >>> from google.cloud import bigquery
-     >>> client = bigquery.Client(project='PROJECT_ID')
-
-
-Project ACLs
-~~~~~~~~~~~~
-
-Each project has an access control list granting reader / writer / owner
-permission to one or more entities.  This list cannot be queried or set
-via the API:  it must be managed using the Google Developer Console.
-
-
-Datasets
---------
-
-A dataset represents a collection of tables, and applies several default
-policies to tables as they are created:
-
-- An access control list (ACL).  When created, a dataset has an ACL
-  which maps to the ACL inherited from its project.
-
-- A default table expiration period.  If set, tables created within the
-  dataset will have the value as their expiration period.
-
-
-Dataset operations
-~~~~~~~~~~~~~~~~~~
-
-List datasets for the client's project:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START client_list_datasets]
-   :end-before: [END client_list_datasets]
-
-Create a new dataset for the client's project:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START dataset_create]
-   :end-before: [END dataset_create]
-
-Check for the existence of a dataset:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START dataset_exists]
-   :end-before: [END dataset_exists]
-
-Refresh metadata for a dataset (to pick up changes made by another client):
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START dataset_reload]
-   :end-before: [END dataset_reload]
-
-Patch metadata for a dataset:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START dataset_patch]
-   :end-before: [END dataset_patch]
-
-Replace the ACL for a dataset, and update all writeable fields:
-
-.. doctest::
-
-   >>> from google.cloud import bigquery
-   >>> client = bigquery.Client()
-   >>> dataset = client.dataset('dataset_name')
-   >>> dataset.get()  # API request
-   >>> acl = list(dataset.acl)
-   >>> acl.append(bigquery.Access(role='READER', entity_type='domain', entity='example.com'))
-   >>> dataset.acl = acl
-   >>> dataset.update()  # API request
-
-Delete a dataset:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START dataset_delete]
-   :end-before: [END dataset_delete]
-
-
-Tables
-------
-
-Tables exist within datasets.  List tables for the dataset:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START dataset_list_tables]
-   :end-before: [END dataset_list_tables]
-
-Create a table:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_create]
-   :end-before: [END table_create]
-
-Check for the existence of a table:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_exists]
-   :end-before: [END table_exists]
-
-Refresh metadata for a table (to pick up changes made by another client):
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_reload]
-   :end-before: [END table_reload]
-
-Patch specific properties for a table:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_patch]
-   :end-before: [END table_patch]
-
-Update all writable metadata for a table
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_update]
-   :end-before: [END table_update]
-
-Get rows from a table's data:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_fetch_data]
-   :end-before: [END table_fetch_data]
-
-Insert rows into a table's data:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_insert_data]
-   :end-before: [END table_insert_data]
-
-Upload table data from a file:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_upload_from_file]
-   :end-before: [END table_upload_from_file]
-
-Delete a table:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START table_delete]
-   :end-before: [END table_delete]
-
-
-Jobs
-----
-
-Jobs describe actions peformed on data in BigQuery tables:
-
-- Load data into a table
-- Run a query against data in one or more tables
-- Extract data from a table
-- Copy a table
-
-List jobs for a project:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START client_list_jobs]
-   :end-before: [END client_list_jobs]
-
-
-Querying data (synchronous)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Run a query which can be expected to complete within bounded time:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START client_run_sync_query]
-   :end-before: [END client_run_sync_query]
-
-If the rows returned by the query do not fit into the inital response,
-then we need to fetch the remaining rows via ``fetch_data``:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START client_run_sync_query_paged]
-   :end-before: [END client_run_sync_query_paged]
-
-If the query takes longer than the timeout allowed, ``query.complete``
-will be ``False``.  In that case, we need to poll the associated job until
-it is done, and then fetch the reuslts:
-
-.. literalinclude:: bigquery_snippets.py
-   :start-after: [START client_run_sync_query_timeout]
-   :end-before: [END client_run_sync_query_timeout]
-
-
-Querying data (asynchronous)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Background a query, loading the results into a table:
-
-.. doctest::
-
-   >>> from google.cloud import bigquery
-   >>> client = bigquery.Client()
-   >>> query = """\
-   SELECT firstname + ' ' + last_name AS full_name,
-          FLOOR(DATEDIFF(CURRENT_DATE(), birth_date) / 365) AS age
-    FROM dataset_name.persons
-   """
-   >>> dataset = client.dataset('dataset_name')
-   >>> table = dataset.table(name='person_ages')
-   >>> job = client.run_async_query('fullname-age-query-job', query)
-   >>> job.destination = table
-   >>> job.write_disposition= 'truncate'
-   >>> job.name
-   'fullname-age-query-job'
-   >>> job.job_type
-   'query'
-   >>> job.created
-   None
-   >>> job.state
-   None
-
-.. note::
-
-   - ``google.cloud.bigquery`` generates a UUID for each job.
-   - The ``created`` and ``state`` fields are not set until the job
-     is submitted to the BigQuery back-end.
-
-Then, begin executing the job on the server:
-
-.. doctest::
-
-   >>> job.begin()  # API call
-   >>> job.created
-   datetime.datetime(2015, 7, 23, 9, 30, 20, 268260, tzinfo=<UTC>)
-   >>> job.state
-   'RUNNING'
-
-Poll until the job is complete:
-
-.. doctest::
-
-   >>> import time
-   >>> retry_count = 100
-   >>> while retry_count > 0 and job.state != 'DONE':
-   ...     retry_count -= 1
-   ...     time.sleep(10)
-   ...     job.reload()  # API call
-   >>> job.state
-   'done'
-   >>> job.ended
-   datetime.datetime(2015, 7, 23, 9, 30, 21, 334792, tzinfo=<UTC>)
-
-Retrieve the results:
-
-.. doctest::
-
-   >>> results = job.results()
-   >>> rows, total_count, token = query.fetch_data()  # API requet
-   >>> while True:
-   ...     do_something_with(rows)
-   ...     if token is None:
-   ...         break
-   ...     rows, total_count, token = query.fetch_data(
-   ...         page_token=token)       # API request
-
-
-Inserting data (asynchronous)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Start a job loading data asynchronously from a set of CSV files, located on
-Google Cloud Storage, appending rows into an existing table.  First, create
-the job locally:
-
-.. doctest::
-
-   >>> from google.cloud import bigquery
-   >>> from google.cloud.bigquery import SchemaField
-   >>> client = bigquery.Client()
-   >>> table = dataset.table(name='person_ages')
-   >>> table.schema = [
-   ...     SchemaField('full_name', 'STRING', mode='required'),
-   ...     SchemaField('age', 'INTEGER', mode='required)]
-   >>> job = client.load_table_from_storage(
-   ...     'load-from-storage-job', table, 'gs://bucket-name/object-prefix*')
-   >>> job.source_format = 'CSV'
-   >>> job.skip_leading_rows = 1  # count of skipped header rows
-   >>> job.write_disposition = 'truncate'
-   >>> job.name
-   'load-from-storage-job'
-   >>> job.job_type
-   'load'
-   >>> job.created
-   None
-   >>> job.state
-   None
-
-.. note::
-
-   - ``google.cloud.bigquery`` generates a UUID for each job.
-   - The ``created`` and ``state`` fields are not set until the job
-     is submitted to the BigQuery back-end.
-
-Then, begin executing the job on the server:
-
-.. doctest::
-
-   >>> job.begin()  # API call
-   >>> job.created
-   datetime.datetime(2015, 7, 23, 9, 30, 20, 268260, tzinfo=<UTC>)
-   >>> job.state
-   'RUNNING'
-
-Poll until the job is complete:
-
-.. doctest::
-
-   >>> import time
-   >>> retry_count = 100
-   >>> while retry_count > 0 and job.state != 'DONE':
-   ...     retry_count -= 1
-   ...     time.sleep(10)
-   ...     job.reload()  # API call
-   >>> job.state
-   'done'
-   >>> job.ended
-   datetime.datetime(2015, 7, 23, 9, 30, 21, 334792, tzinfo=<UTC>)
-
-
-Exporting data (async)
-~~~~~~~~~~~~~~~~~~~~~~
-
-Start a job exporting a table's data asynchronously to a set of CSV files,
-located on Google Cloud Storage.  First, create the job locally:
-
-.. doctest::
-
-   >>> from google.cloud import bigquery
-   >>> client = bigquery.Client()
-   >>> table = dataset.table(name='person_ages')
-   >>> job = client.extract_table_to_storage(
-   ...     'extract-person-ages-job', table,
-   ...     'gs://bucket-name/export-prefix*.csv')
-   ... job.destination_format = 'CSV'
-   ... job.print_header = True
-   ... job.write_disposition = 'truncate'
-   >>> job.name
-   'extract-person-ages-job'
-   >>> job.job_type
-   'extract'
-   >>> job.created
-   None
-   >>> job.state
-   None
-
-.. note::
-
-   - ``google.cloud.bigquery`` generates a UUID for each job.
-   - The ``created`` and ``state`` fields are not set until the job
-     is submitted to the BigQuery back-end.
-
-Then, begin executing the job on the server:
-
-.. doctest::
-
-   >>> job.begin()  # API call
-   >>> job.created
-   datetime.datetime(2015, 7, 23, 9, 30, 20, 268260, tzinfo=<UTC>)
-   >>> job.state
-   'RUNNING'
-
-Poll until the job is complete:
-
-.. doctest::
-
-   >>> import time
-   >>> retry_count = 100
-   >>> while retry_count > 0 and job.state != 'DONE':
-   ...     retry_count -= 1
-   ...     time.sleep(10)
-   ...     job.reload()  # API call
-   >>> job.state
-   'done'
-   >>> job.ended
-   datetime.datetime(2015, 7, 23, 9, 30, 21, 334792, tzinfo=<UTC>)
-
-
-Copy tables (async)
-~~~~~~~~~~~~~~~~~~~
-
-First, create the job locally:
-
-.. doctest::
-
-   >>> from google.cloud import bigquery
-   >>> client = bigquery.Client()
-   >>> source_table = dataset.table(name='person_ages')
-   >>> destination_table = dataset.table(name='person_ages_copy')
-   >>> job = client.copy_table(
-   ...     'copy-table-job', destination_table, source_table)
-   >>> job.name
-   'copy-table-job'
-   >>> job.job_type
-   'copy'
-   >>> job.created
-   None
-   >>> job.state
-   None
-
-.. note::
-
-   - ``google.cloud.bigquery`` generates a UUID for each job.
-   - The ``created`` and ``state`` fields are not set until the job
-     is submitted to the BigQuery back-end.
-
-Then, begin executing the job on the server:
-
-.. doctest::
-
-   >>> job.begin()  # API call
-   >>> job.created
-   datetime.datetime(2015, 7, 23, 9, 30, 20, 268260, tzinfo=<UTC>)
-   >>> job.state
-   'RUNNING'
-
-Poll until the job is complete:
-
-.. doctest::
-
-   >>> import time
-   >>> retry_count = 100
-   >>> while retry_count > 0 and job.state != 'DONE':
-   ...     retry_count -= 1
-   ...     time.sleep(10)
-   ...     job.reload()  # API call
-   >>> job.state
-   'done'
-   >>> job.ended
-   datetime.datetime(2015, 7, 23, 9, 30, 21, 334792, tzinfo=<UTC>)
diff --git a/docs/bigquery_datatransfer b/docs/bigquery_datatransfer
new file mode 120000
index 000000000000..7e49b4933c3f
--- /dev/null
+++ b/docs/bigquery_datatransfer
@@ -0,0 +1 @@
+../bigquery_datatransfer/docs/
\ No newline at end of file
diff --git a/docs/bigquery_snippets.py b/docs/bigquery_snippets.py
deleted file mode 100644
index cb772b01763e..000000000000
--- a/docs/bigquery_snippets.py
+++ /dev/null
@@ -1,598 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Testable usage examples for Google Cloud BigQuery API wrapper
-
-Each example function takes a ``client`` argument (which must be an instance
-of :class:`google.cloud.bigquery.client.Client`) and uses it to perform a task
-with the API.
-
-To facilitate running the examples as system tests, each example is also passed
-a ``to_delete`` list;  the function adds to the list any objects created which
-need to be deleted during teardown.
-"""
-
-import operator
-import time
-
-from google.cloud.bigquery import SchemaField
-from google.cloud.bigquery.client import Client
-
-ORIGINAL_FRIENDLY_NAME = 'Original friendly name'
-ORIGINAL_DESCRIPTION = 'Original description'
-LOCALLY_CHANGED_FRIENDLY_NAME = 'Locally-changed friendly name'
-LOCALLY_CHANGED_DESCRIPTION = 'Locally-changed description'
-PATCHED_FRIENDLY_NAME = 'Patched friendly name'
-PATCHED_DESCRIPTION = 'Patched description'
-UPDATED_FRIENDLY_NAME = 'Updated friendly name'
-UPDATED_DESCRIPTION = 'Updated description'
-
-SCHEMA = [
-    SchemaField('full_name', 'STRING', mode='required'),
-    SchemaField('age', 'INTEGER', mode='required'),
-]
-
-QUERY = (
-    'SELECT name FROM [bigquery-public-data:usa_names.usa_1910_2013] '
-    'WHERE state = "TX"')
-
-
-def snippet(func):
-    """Mark ``func`` as a snippet example function."""
-    func._snippet = True
-    return func
-
-
-def _millis():
-    return time.time() * 1000
-
-
-class _CloseOnDelete(object):
-
-    def __init__(self, wrapped):
-        self._wrapped = wrapped
-
-    def delete(self):
-        self._wrapped.close()
-
-
-@snippet
-def client_list_datasets(client, _):
-    """List datasets for a project."""
-
-    def do_something_with(_):
-        pass
-
-    # [START client_list_datasets]
-    datasets, token = client.list_datasets()   # API request
-    while True:
-        for dataset in datasets:
-            do_something_with(dataset)
-        if token is None:
-            break
-        datasets, token = client.list_datasets(page_token=token)  # API request
-    # [END client_list_datasets]
-
-
-@snippet
-def dataset_create(client, to_delete):
-    """Create a dataset."""
-    DATASET_NAME = 'dataset_create_%d' % (_millis(),)
-
-    # [START dataset_create]
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()              # API request
-    # [END dataset_create]
-
-    to_delete.append(dataset)
-
-
-@snippet
-def dataset_exists(client, to_delete):
-    """Test existence of a dataset."""
-    DATASET_NAME = 'dataset_exists_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    to_delete.append(dataset)
-
-    # [START dataset_exists]
-    assert not dataset.exists()   # API request
-    dataset.create()              # API request
-    assert dataset.exists()       # API request
-    # [END dataset_exists]
-
-
-@snippet
-def dataset_reload(client, to_delete):
-    """Reload a dataset's metadata."""
-    DATASET_NAME = 'dataset_reload_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.description = ORIGINAL_DESCRIPTION
-    dataset.create()
-    to_delete.append(dataset)
-
-    # [START dataset_reload]
-    assert dataset.description == ORIGINAL_DESCRIPTION
-    dataset.description = LOCALLY_CHANGED_DESCRIPTION
-    assert dataset.description == LOCALLY_CHANGED_DESCRIPTION
-    dataset.reload()              # API request
-    assert dataset.description == ORIGINAL_DESCRIPTION
-    # [END dataset_reload]
-
-
-@snippet
-def dataset_patch(client, to_delete):
-    """Patch a dataset's metadata."""
-    DATASET_NAME = 'dataset_patch_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.description = ORIGINAL_DESCRIPTION
-    dataset.create()
-    to_delete.append(dataset)
-
-    # [START dataset_patch]
-    ONE_DAY_MS = 24 * 60 * 60 * 1000
-    assert dataset.description == ORIGINAL_DESCRIPTION
-    dataset.patch(
-        description=PATCHED_DESCRIPTION,
-        default_table_expiration_ms=ONE_DAY_MS
-    )      # API request
-    assert dataset.description == PATCHED_DESCRIPTION
-    assert dataset.default_table_expiration_ms == ONE_DAY_MS
-    # [END dataset_patch]
-
-
-@snippet
-def dataset_update(client, to_delete):
-    """Update a dataset's metadata."""
-    DATASET_NAME = 'dataset_update_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.description = ORIGINAL_DESCRIPTION
-    dataset.create()
-    to_delete.append(dataset)
-    dataset.reload()
-
-    # [START dataset_update]
-    from google.cloud.bigquery import AccessGrant
-    assert dataset.description == ORIGINAL_DESCRIPTION
-    assert dataset.default_table_expiration_ms is None
-    grant = AccessGrant(
-        role='READER', entity_type='domain', entity_id='example.com')
-    assert grant not in dataset.access_grants
-    ONE_DAY_MS = 24 * 60 * 60 * 1000
-    dataset.description = UPDATED_DESCRIPTION
-    dataset.default_table_expiration_ms = ONE_DAY_MS
-    grants = list(dataset.access_grants)
-    grants.append(grant)
-    dataset.access_grants = grants
-    dataset.update()              # API request
-    assert dataset.description == UPDATED_DESCRIPTION
-    assert dataset.default_table_expiration_ms == ONE_DAY_MS
-    assert grant in dataset.access_grants
-    # [END dataset_update]
-
-
-@snippet
-def dataset_delete(client, _):
-    """Delete a dataset."""
-    DATASET_NAME = 'dataset_delete_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-
-    # [START dataset_delete]
-    assert dataset.exists()       # API request
-    dataset.delete()
-    assert not dataset.exists()   # API request
-    # [END dataset_delete]
-
-
-@snippet
-def dataset_list_tables(client, to_delete):
-    """List tables within a dataset."""
-    DATASET_NAME = 'dataset_list_tables_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'dataset_list_tables_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-    to_delete.append(dataset)
-
-    # [START dataset_list_tables]
-    tables, token = dataset.list_tables()   # API request
-    assert len(tables) == 0
-    assert token is None
-    table = dataset.table(TABLE_NAME)
-    table.view_query = QUERY
-    table.create()                          # API request
-    tables, token = dataset.list_tables()   # API request
-    assert len(tables) == 1
-    assert tables[0].name == TABLE_NAME
-    # [END dataset_list_tables]
-    to_delete.insert(0, table)
-
-
-@snippet
-def table_create(client, to_delete):
-    """Create a table."""
-    DATASET_NAME = 'table_create_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_create_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-    to_delete.append(dataset)
-
-    # [START table_create]
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.create()                          # API request
-    # [END table_create]
-
-    to_delete.insert(0, table)
-
-
-@snippet
-def table_exists(client, to_delete):
-    """Test existence of a table."""
-    DATASET_NAME = 'table_exists_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_exists_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-    to_delete.append(dataset)
-
-    # [START table_exists]
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    assert not table.exists()               # API request
-    table.create()                          # API request
-    assert table.exists()                   # API request
-    # [END table_exists]
-
-    to_delete.insert(0, table)
-
-
-@snippet
-def table_reload(client, to_delete):
-    """Reload a table's metadata."""
-    DATASET_NAME = 'table_reload_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_reload_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-    to_delete.append(dataset)
-
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.friendly_name = ORIGINAL_FRIENDLY_NAME
-    table.description = ORIGINAL_DESCRIPTION
-    table.create()
-    to_delete.insert(0, table)
-
-    # [START table_reload]
-    assert table.friendly_name == ORIGINAL_FRIENDLY_NAME
-    assert table.description == ORIGINAL_DESCRIPTION
-    table.friendly_name = LOCALLY_CHANGED_FRIENDLY_NAME
-    table.description = LOCALLY_CHANGED_DESCRIPTION
-    table.reload()                  # API request
-    assert table.friendly_name == ORIGINAL_FRIENDLY_NAME
-    assert table.description == ORIGINAL_DESCRIPTION
-    # [END table_reload]
-
-
-@snippet
-def table_patch(client, to_delete):
-    """Patch a table's metadata."""
-    DATASET_NAME = 'table_patch_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_patch_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.description = ORIGINAL_DESCRIPTION
-    dataset.create()
-    to_delete.append(dataset)
-
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.friendly_name = ORIGINAL_FRIENDLY_NAME
-    table.description = ORIGINAL_DESCRIPTION
-    table.create()
-    to_delete.insert(0, table)
-
-    # [START table_patch]
-    assert table.friendly_name == ORIGINAL_FRIENDLY_NAME
-    assert table.description == ORIGINAL_DESCRIPTION
-    table.patch(
-        friendly_name=PATCHED_FRIENDLY_NAME,
-        description=PATCHED_DESCRIPTION,
-    )      # API request
-    assert table.friendly_name == PATCHED_FRIENDLY_NAME
-    assert table.description == PATCHED_DESCRIPTION
-    # [END table_patch]
-
-
-@snippet
-def table_update(client, to_delete):
-    """Update a table's metadata."""
-    DATASET_NAME = 'table_update_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_update_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.description = ORIGINAL_DESCRIPTION
-    dataset.create()
-    to_delete.append(dataset)
-
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.friendly_name = ORIGINAL_FRIENDLY_NAME
-    table.description = ORIGINAL_DESCRIPTION
-    table.create()
-    to_delete.insert(0, table)
-
-    # [START table_update]
-    assert table.friendly_name == ORIGINAL_FRIENDLY_NAME
-    assert table.description == ORIGINAL_DESCRIPTION
-    NEW_SCHEMA = table.schema[:]
-    NEW_SCHEMA.append(SchemaField('phone', 'string'))
-    table.friendly_name = UPDATED_FRIENDLY_NAME
-    table.description = UPDATED_DESCRIPTION
-    table.schema = NEW_SCHEMA
-    table.update()              # API request
-    assert table.friendly_name == UPDATED_FRIENDLY_NAME
-    assert table.description == UPDATED_DESCRIPTION
-    assert table.schema == NEW_SCHEMA
-    # [END table_update]
-
-
-def _warm_up_inserted_table_data(table):
-    # Allow for 90 seconds of "warm up" before rows visible.  See:
-    # https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataavailability
-    rows = ()
-    counter = 18
-
-    while len(rows) == 0 and counter > 0:
-        counter -= 1
-        rows, _, _ = table.fetch_data()
-        if len(rows) == 0:
-            time.sleep(5)
-
-
-@snippet
-def table_insert_fetch_data(client, to_delete):
-    """Insert / fetch table data."""
-    DATASET_NAME = 'table_insert_fetch_data_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_insert_fetch_data_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-    to_delete.append(dataset)
-
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.create()
-    to_delete.insert(0, table)
-
-    # [START table_insert_data]
-    ROWS_TO_INSERT = [
-        (u'Phred Phlyntstone', 32),
-        (u'Wylma Phlyntstone', 29),
-    ]
-
-    table.insert_data(ROWS_TO_INSERT)
-    # [END table_insert_data]
-
-    _warm_up_inserted_table_data(table)
-
-    found_rows = []
-
-    def do_something(row):
-        found_rows.append(row)
-
-    # [START table_fetch_data]
-    rows, _, token = table.fetch_data()
-    while True:
-        for row in rows:
-            do_something(row)
-        if token is None:
-            break
-        rows, _, token = table.fetch_data(page_token=token)
-    # [END table_fetch_data]
-
-    assert len(found_rows) == len(ROWS_TO_INSERT)
-    by_age = operator.itemgetter(1)
-    found_rows = reversed(sorted(found_rows, key=by_age))
-    for found, to_insert in zip(found_rows, ROWS_TO_INSERT):
-        assert found == to_insert
-
-
-@snippet
-def table_upload_from_file(client, to_delete):
-    """Upload table data from a CSV file."""
-    import csv
-    import tempfile
-    DATASET_NAME = 'table_upload_from_file_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_upload_from_file_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-    to_delete.append(dataset)
-
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.create()
-    to_delete.insert(0, table)
-
-    csv_file = tempfile.NamedTemporaryFile(suffix='.csv')
-    to_delete.append(_CloseOnDelete(csv_file))
-
-    # [START table_upload_from_file]
-    writer = csv.writer(csv_file)
-    writer.writerow((b'full_name', b'age'))
-    writer.writerow((b'Phred Phlyntstone', b'32'))
-    writer.writerow((b'Wylma Phlyntstone', b'29'))
-    csv_file.flush()
-
-    with open(csv_file.name, 'rb') as readable:
-        table.upload_from_file(
-            readable, source_format='CSV', skip_leading_rows=1)
-    # [END table_upload_from_file]
-
-    _warm_up_inserted_table_data(table)
-
-    rows, total, token = table.fetch_data()
-
-    assert len(rows) == total == 2
-    assert token is None
-    assert rows[0] == (u'Phred Phlyntstone', 32)
-    assert rows[1] == (u'Wylma Phlyntstone', 29)
-
-
-@snippet
-def table_delete(client, _):
-    """Delete a table."""
-    DATASET_NAME = 'table_delete_dataset_%d' % (_millis(),)
-    TABLE_NAME = 'table_create_table_%d' % (_millis(),)
-    dataset = client.dataset(DATASET_NAME)
-    dataset.create()
-
-    table = dataset.table(TABLE_NAME, SCHEMA)
-    table.create()
-
-    # [START table_delete]
-    assert table.exists()       # API request
-    table.delete()              # API request
-    assert not table.exists()   # API request
-    # [END table_delete]
-
-
-@snippet
-def client_list_jobs(client, _):
-    """List jobs for a project."""
-
-    def do_something_with(_):
-        pass
-
-    # [START client_list_jobs]
-    jobs, token = client.list_jobs()   # API request
-    while True:
-        for job in jobs:
-            do_something_with(job)
-        if token is None:
-            break
-        jobs, token = client.list_jobs(page_token=token)  # API request
-    # [END client_list_jobs]
-
-
-@snippet
-def client_run_sync_query(client, _):
-    """Run a synchronous query."""
-    LIMIT = 100
-    LIMITED = '%s LIMIT %d' % (QUERY, LIMIT)
-    TIMEOUT_MS = 1000
-
-    # [START client_run_sync_query]
-    query = client.run_sync_query(LIMITED)
-    query.timeout_ms = TIMEOUT_MS
-    query.run()             # API request
-
-    assert query.complete
-    assert len(query.rows) == LIMIT
-    assert [field.name for field in query.schema] == ['name']
-    # [END client_run_sync_query]
-
-
-@snippet
-def client_run_sync_query_paged(client, _):
-    """Run a synchronous query with paged results."""
-    TIMEOUT_MS = 1000
-    PAGE_SIZE = 100
-    LIMIT = 1000
-    LIMITED = '%s LIMIT %d' % (QUERY, LIMIT)
-
-    all_rows = []
-
-    def do_something_with(rows):
-        all_rows.extend(rows)
-
-    # [START client_run_sync_query_paged]
-    query = client.run_sync_query(LIMITED)
-    query.timeout_ms = TIMEOUT_MS
-    query.max_results = PAGE_SIZE
-    query.run()                     # API request
-
-    assert query.complete
-    assert query.page_token is not None
-    assert len(query.rows) == PAGE_SIZE
-    assert [field.name for field in query.schema] == ['name']
-
-    rows = query.rows
-    token = query.page_token
-
-    while True:
-        do_something_with(rows)
-        if token is None:
-            break
-        rows, total_count, token = query.fetch_data(
-            page_token=token)       # API request
-    # [END client_run_sync_query_paged]
-
-    assert total_count == LIMIT
-    assert len(all_rows) == LIMIT
-
-
-@snippet
-def client_run_sync_query_timeout(client, _):
-    """Run a synchronous query w/ timeout"""
-    TIMEOUT_MS = 10
-
-    all_rows = []
-
-    def do_something_with(rows):
-        all_rows.extend(rows)
-
-    # [START client_run_sync_query_timeout]
-    query = client.run_sync_query(QUERY)
-    query.timeout_ms = TIMEOUT_MS
-    query.use_query_cache = False
-    query.run()                           # API request
-
-    assert not query.complete
-
-    job = query.job
-    job.reload()                          # API rquest
-    retry_count = 0
-
-    while retry_count < 10 and job.state != u'DONE':
-        time.sleep(1.5**retry_count)      # exponential backoff
-        retry_count += 1
-        job.reload()                      # API request
-
-    assert job.state == u'DONE'
-
-    rows, total_count, token = query.fetch_data()  # API request
-    while True:
-        do_something_with(rows)
-        if token is None:
-            break
-        rows, total_count, token = query.fetch_data(
-            page_token=token)  # API request
-    # [END client_run_sync_query_timeout]
-
-    assert len(all_rows) == total_count
-
-
-def _find_examples():
-    funcs = [obj for obj in globals().values()
-             if getattr(obj, '_snippet', False)]
-    for func in sorted(funcs, key=lambda f: f.func_code.co_firstlineno):
-        yield func
-
-
-def main():
-    client = Client()
-    for example in _find_examples():
-        to_delete = []
-        print('%-30s: %s' % (
-            example.func_name, example.func_doc))
-        try:
-            example(client, to_delete)
-        except AssertionError as e:
-            print('   FAIL: %s' % (e,))
-        except Exception as e:  # pylint: disable=broad-except
-            print('  ERROR: %r' % (e,))
-        for item in to_delete:
-            item.delete()
-
-if __name__ == '__main__':
-    main()
diff --git a/docs/bigquery_storage b/docs/bigquery_storage
new file mode 120000
index 000000000000..6c07150ad7db
--- /dev/null
+++ b/docs/bigquery_storage
@@ -0,0 +1 @@
+../bigquery_storage/docs/
\ No newline at end of file
diff --git a/docs/bigtable b/docs/bigtable
new file mode 120000
index 000000000000..27a5bfe5866c
--- /dev/null
+++ b/docs/bigtable
@@ -0,0 +1 @@
+../bigtable/docs/
\ No newline at end of file
diff --git a/docs/bigtable-client-intro.rst b/docs/bigtable-client-intro.rst
deleted file mode 100644
index 2ec2fd1039e3..000000000000
--- a/docs/bigtable-client-intro.rst
+++ /dev/null
@@ -1,90 +0,0 @@
-Base for Everything
-===================
-
-To use the API, the :class:`Client <google.cloud.bigtable.client.Client>`
-class defines a high-level interface which handles authorization
-and creating other objects:
-
-.. code:: python
-
-    from google.cloud.bigtable.client import Client
-    client = Client()
-
-Long-lived Defaults
--------------------
-
-When creating a :class:`Client <google.cloud.bigtable.client.Client>`, the
-``user_agent`` argument has sensible a default
-(:data:`DEFAULT_USER_AGENT <google.cloud.bigtable.client.DEFAULT_USER_AGENT>`).
-However, you may over-ride it and the value will be used throughout all API
-requests made with the ``client`` you create.
-
-Configuration
--------------
-
-- For an overview of authentication in ``google-cloud-python``,
-  see :doc:`google-cloud-auth`.
-
-- In addition to any authentication configuration, you can also set the
-  :envvar:`GOOGLE_CLOUD_PROJECT` environment variable for the Google Cloud Console
-  project you'd like to interact with. If your code is running in Google App
-  Engine or Google Compute Engine the project will be detected automatically.
-  (Setting this environment variable is not required, you may instead pass the
-  ``project`` explicitly when constructing a
-  :class:`Client <google.cloud.storage.client.Client>`).
-
-- After configuring your environment, create a
-  :class:`Client <google.cloud.storage.client.Client>`
-
-  .. code::
-
-     >>> from google.cloud import bigtable
-     >>> client = bigtable.Client()
-
-  or pass in ``credentials`` and ``project`` explicitly
-
-  .. code::
-
-     >>> from google.cloud import bigtable
-     >>> client = bigtable.Client(project='my-project', credentials=creds)
-
-.. tip::
-
-    Be sure to use the **Project ID**, not the **Project Number**.
-
-Admin API Access
-----------------
-
-If you'll be using your client to make `Instance Admin`_ and `Table Admin`_
-API requests, you'll need to pass the ``admin`` argument:
-
-.. code:: python
-
-    client = bigtable.Client(admin=True)
-
-Read-Only Mode
---------------
-
-If on the other hand, you only have (or want) read access to the data,
-you can pass the ``read_only`` argument:
-
-.. code:: python
-
-    client = bigtable.Client(read_only=True)
-
-This will ensure that the
-:data:`READ_ONLY_SCOPE <google.cloud.bigtable.client.READ_ONLY_SCOPE>` is used
-for API requests (so any accidental requests that would modify data will
-fail).
-
-Next Step
----------
-
-After a :class:`Client <google.cloud.bigtable.client.Client>`, the next highest-level
-object is a :class:`Instance <google.cloud.bigtable.instance.Instance>`. You'll need
-one before you can interact with tables or data.
-
-Head next to learn about the :doc:`bigtable-instance-api`.
-
-.. _Instance Admin: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/tree/master/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1
-.. _Table Admin: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/tree/master/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1
diff --git a/docs/bigtable-data-api.rst b/docs/bigtable-data-api.rst
deleted file mode 100644
index 78cc10b0f485..000000000000
--- a/docs/bigtable-data-api.rst
+++ /dev/null
@@ -1,344 +0,0 @@
-Data API
-========
-
-After creating a :class:`Table <google.cloud.bigtable.table.Table>` and some
-column families, you are ready to store and retrieve data.
-
-Cells vs. Columns vs. Column Families
-+++++++++++++++++++++++++++++++++++++
-
-* As explained in the :doc:`table overview <bigtable-table-api>`, tables can
-  have many column families.
-* As described below, a table can also have many rows which are
-  specified by row keys.
-* Within a row, data is stored in a cell. A cell simply has a value (as
-  bytes) and a timestamp. The number of cells in each row can be
-  different, depending on what was stored in each row.
-* Each cell lies in a column (**not** a column family). A column is really
-  just a more **specific** modifier within a column family. A column
-  can be present in every column family, in only one or anywhere in between.
-* Within a column family there can be many columns. For example within
-  the column family ``foo`` we could have columns ``bar`` and ``baz``.
-  These would typically be represented as ``foo:bar`` and ``foo:baz``.
-
-Modifying Data
-++++++++++++++
-
-Since data is stored in cells, which are stored in rows, we
-use the metaphor of a **row** in classes that are used to modify
-(write, update, delete) data in a
-:class:`Table <google.cloud.bigtable.table.Table>`.
-
-Direct vs. Conditional vs. Append
----------------------------------
-
-There are three ways to modify data in a table, described by the
-`MutateRow`_, `CheckAndMutateRow`_ and `ReadModifyWriteRow`_ API
-methods.
-
-* The **direct** way is via `MutateRow`_ which involves simply
-  adding, overwriting or deleting cells. The
-  :class:`DirectRow <google.cloud.bigtable.row.DirectRow>` class
-  handles direct mutations.
-* The **conditional** way is via `CheckAndMutateRow`_. This method
-  first checks if some filter is matched in a a given row, then
-  applies one of two sets of mutations, depending on if a match
-  occurred or not. (These mutation sets are called the "true
-  mutations" and "false mutations".) The
-  :class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>` class
-  handles conditional mutations.
-* The **append** way is via `ReadModifyWriteRow`_. This simply
-  appends (as bytes) or increments (as an integer) data in a presumed
-  existing cell in a row. The
-  :class:`AppendRow <google.cloud.bigtable.row.AppendRow>` class
-  handles append mutations.
-
-Row Factory
------------
-
-A single factory can be used to create any of the three row types.
-To create a :class:`DirectRow <google.cloud.bigtable.row.DirectRow>`:
-
-.. code:: python
-
-    row = table.row(row_key)
-
-Unlike the previous string values we've used before, the row key must
-be ``bytes``.
-
-To create a :class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>`,
-first create a :class:`RowFilter <google.cloud.bigtable.row.RowFilter>` and
-then
-
-.. code:: python
-
-    cond_row = table.row(row_key, filter_=filter_)
-
-To create an :class:`AppendRow <google.cloud.bigtable.row.AppendRow>`
-
-.. code:: python
-
-    append_row = table.row(row_key, append=True)
-
-Building Up Mutations
----------------------
-
-In all three cases, a set of mutations (or two sets) are built up
-on a row before they are sent of in a batch via
-
-.. code:: python
-
-    row.commit()
-
-Direct Mutations
-----------------
-
-Direct mutations can be added via one of four methods
-
-* :meth:`set_cell() <google.cloud.bigtable.row.DirectRow.set_cell>` allows a
-  single value to be written to a column
-
-  .. code:: python
-
-      row.set_cell(column_family_id, column, value,
-                   timestamp=timestamp)
-
-  If the ``timestamp`` is omitted, the current time on the Google Cloud
-  Bigtable server will be used when the cell is stored.
-
-  The value can either by bytes or an integer (which will be converted to
-  bytes as a signed 64-bit integer).
-
-* :meth:`delete_cell() <google.cloud.bigtable.row.DirectRow.delete_cell>` deletes
-  all cells (i.e. for all timestamps) in a given column
-
-  .. code:: python
-
-      row.delete_cell(column_family_id, column)
-
-  Remember, this only happens in the ``row`` we are using.
-
-  If we only want to delete cells from a limited range of time, a
-  :class:`TimestampRange <google.cloud.bigtable.row.TimestampRange>` can
-  be used
-
-  .. code:: python
-
-      row.delete_cell(column_family_id, column,
-                      time_range=time_range)
-
-* :meth:`delete_cells() <google.cloud.bigtable.row.DirectRow.delete_cells>` does
-  the same thing as
-  :meth:`delete_cell() <google.cloud.bigtable.row.DirectRow.delete_cell>`
-  but accepts a list of columns in a column family rather than a single one.
-
-  .. code:: python
-
-      row.delete_cells(column_family_id, [column1, column2],
-                       time_range=time_range)
-
-  In addition, if we want to delete cells from every column in a column family,
-  the special :attr:`ALL_COLUMNS <google.cloud.bigtable.row.DirectRow.ALL_COLUMNS>`
-  value can be used
-
-  .. code:: python
-
-      row.delete_cells(column_family_id, row.ALL_COLUMNS,
-                       time_range=time_range)
-
-* :meth:`delete() <google.cloud.bigtable.row.DirectRow.delete>` will delete the
-  entire row
-
-  .. code:: python
-
-      row.delete()
-
-Conditional Mutations
----------------------
-
-Making **conditional** modifications is essentially identical
-to **direct** modifications: it uses the exact same methods
-to accumulate mutations.
-
-However, each mutation added must specify a ``state``: will the mutation be
-applied if the filter matches or if it fails to match.
-
-For example:
-
-.. code:: python
-
-    cond_row.set_cell(column_family_id, column, value,
-                      timestamp=timestamp, state=True)
-
-will add to the set of true mutations.
-
-Append Mutations
-----------------
-
-Append mutations can be added via one of two methods
-
-* :meth:`append_cell_value() <google.cloud.bigtable.row.AppendRow.append_cell_value>`
-  appends a bytes value to an existing cell:
-
-  .. code:: python
-
-      append_row.append_cell_value(column_family_id, column, bytes_value)
-
-* :meth:`increment_cell_value() <google.cloud.bigtable.row.AppendRow.increment_cell_value>`
-  increments an integer value in an existing cell:
-
-  .. code:: python
-
-      append_row.increment_cell_value(column_family_id, column, int_value)
-
-  Since only bytes are stored in a cell, the cell value is decoded as
-  a signed 64-bit integer before being incremented. (This happens on
-  the Google Cloud Bigtable server, not in the library.)
-
-Notice that no timestamp was specified. This is because **append** mutations
-operate on the latest value of the specified column.
-
-If there are no cells in the specified column, then the empty string (bytes
-case) or zero (integer case) are the assumed values.
-
-Starting Fresh
---------------
-
-If accumulated mutations need to be dropped, use
-
-.. code:: python
-
-    row.clear()
-
-Reading Data
-++++++++++++
-
-Read Single Row from a Table
-----------------------------
-
-To make a `ReadRows`_ API request for a single row key, use
-:meth:`Table.read_row() <google.cloud.bigtable.table.Table.read_row>`:
-
-.. code:: python
-
-    >>> row_data = table.read_row(row_key)
-    >>> row_data.cells
-    {
-        u'fam1': {
-            b'col1': [
-                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
-                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
-            ],
-            b'col2': [
-                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
-            ],
-        },
-        u'fam2': {
-            b'col3': [
-                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
-                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
-                <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>,
-            ],
-        },
-    }
-    >>> cell = row_data.cells[u'fam1'][b'col1'][0]
-    >>> cell
-    <google.cloud.bigtable.row_data.Cell at 0x7f80d150ef10>
-    >>> cell.value
-    b'val1'
-    >>> cell.timestamp
-    datetime.datetime(2016, 2, 27, 3, 41, 18, 122823, tzinfo=<UTC>)
-
-Rather than returning a :class:`DirectRow <google.cloud.bigtable.row.DirectRow>`
-or similar class, this method returns a
-:class:`PartialRowData <google.cloud.bigtable.row_data.PartialRowData>`
-instance. This class is used for reading and parsing data rather than for
-modifying data (as :class:`DirectRow <google.cloud.bigtable.row.DirectRow>` is).
-
-A filter can also be applied to the results:
-
-.. code:: python
-
-    row_data = table.read_row(row_key, filter_=filter_val)
-
-The allowable ``filter_`` values are the same as those used for a
-:class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>`. For
-more information, see the
-:meth:`Table.read_row() <google.cloud.bigtable.table.Table.read_row>` documentation.
-
-Stream Many Rows from a Table
------------------------------
-
-To make a `ReadRows`_ API request for a stream of rows, use
-:meth:`Table.read_rows() <google.cloud.bigtable.table.Table.read_rows>`:
-
-.. code:: python
-
-    row_data = table.read_rows()
-
-Using gRPC over HTTP/2, a continual stream of responses will be delivered.
-In particular
-
-* :meth:`consume_next() <google.cloud.bigtable.row_data.PartialRowsData.consume_next>`
-  pulls the next result from the stream, parses it and stores it on the
-  :class:`PartialRowsData <google.cloud.bigtable.row_data.PartialRowsData>` instance
-* :meth:`consume_all() <google.cloud.bigtable.row_data.PartialRowsData.consume_all>`
-  pulls results from the stream until there are no more
-* :meth:`cancel() <google.cloud.bigtable.row_data.PartialRowsData.cancel>` closes
-  the stream
-
-See the :class:`PartialRowsData <google.cloud.bigtable.row_data.PartialRowsData>`
-documentation for more information.
-
-As with
-:meth:`Table.read_row() <google.cloud.bigtable.table.Table.read_row>`, an optional
-``filter_`` can be applied. In addition a ``start_key`` and / or ``end_key``
-can be supplied for the stream, a ``limit`` can be set and a boolean
-``allow_row_interleaving`` can be specified to allow faster streamed results
-at the potential cost of non-sequential reads.
-
-See the :meth:`Table.read_rows() <google.cloud.bigtable.table.Table.read_rows>`
-documentation for more information on the optional arguments.
-
-Sample Keys in a Table
-----------------------
-
-Make a `SampleRowKeys`_ API request with
-:meth:`Table.sample_row_keys() <google.cloud.bigtable.table.Table.sample_row_keys>`:
-
-.. code:: python
-
-    keys_iterator = table.sample_row_keys()
-
-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.
-
-As with
-:meth:`Table.read_rows() <google.cloud.bigtable.table.Table.read_rows>`, the
-returned ``keys_iterator`` is connected to a cancellable HTTP/2 stream.
-
-The next key in the result can be accessed via
-
-.. code:: python
-
-    next_key = keys_iterator.next()
-
-or all keys can be iterated over via
-
-.. code:: python
-
-    for curr_key in keys_iterator:
-        do_something(curr_key)
-
-Just as with reading, the stream can be canceled:
-
-.. code:: python
-
-    keys_iterator.cancel()
-
-.. _ReadRows: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L36-L38
-.. _SampleRowKeys: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L44-L46
-.. _MutateRow: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L50-L52
-.. _CheckAndMutateRow: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L62-L64
-.. _ReadModifyWriteRow: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_service.proto#L70-L72
diff --git a/docs/bigtable-instance-api.rst b/docs/bigtable-instance-api.rst
deleted file mode 100644
index 18a772a59b09..000000000000
--- a/docs/bigtable-instance-api.rst
+++ /dev/null
@@ -1,135 +0,0 @@
-Instance Admin API
-==================
-
-After creating a :class:`Client <google.cloud.bigtable.client.Client>`, you can
-interact with individual instances for a project.
-
-List Instances
---------------
-
-If you want a comprehensive list of all existing instances, make a
-`ListInstances`_ API request with
-:meth:`Client.list_instances() <google.cloud.bigtable.client.Client.list_instances>`:
-
-.. code:: python
-
-    instances = client.list_instances()
-
-Instance Factory
-----------------
-
-To create a :class:`Instance <google.cloud.bigtable.instance.Instance>` object:
-
-.. code:: python
-
-    instance = client.instance(instance_id, location_id,
-                               display_name=display_name)
-
-- ``location_id`` is the ID of the location in which the instance's cluster
-  will be hosted, e.g.  ``'us-central1-c'``.  ``location_id`` is required for
-  instances which do not already exist.
-
-- ``display_name`` is optional. When not provided, ``display_name`` defaults
-  to the ``instance_id`` value.
-
-You can also use :meth:`Client.instance` to create a local wrapper for
-instances that have already been created with the API, or through the web
-conole:
-
-.. code:: python
-
-    instance = client.instance(existing_instance_id)
-    instance.reload()
-
-Create a new Instance
----------------------
-
-After creating the instance object, make a `CreateInstance`_ API request
-with :meth:`create() <google.cloud.bigtable.instance.Instance.create>`:
-
-.. code:: python
-
-    instance.display_name = 'My very own instance'
-    instance.create()
-
-Check on Current Operation
---------------------------
-
-.. note::
-
-    When modifying a instance (via a `CreateInstance`_ request), the Bigtable
-    API will return a `long-running operation`_ and a corresponding
-    :class:`Operation <google.cloud.bigtable.instance.Operation>` object
-    will be returned by
-    :meth:`create() <google.cloud.bigtable.instance.Instance.create>`.
-
-You can check if a long-running operation (for a
-:meth:`create() <google.cloud.bigtable.instance.Instance.create>` has finished
-by making a `GetOperation`_ request with
-:meth:`Operation.finished() <google.cloud.bigtable.instance.Operation.finished>`:
-
-.. code:: python
-
-    >>> operation = instance.create()
-    >>> operation.finished()
-    True
-
-.. note::
-
-    Once an :class:`Operation <google.cloud.bigtable.instance.Operation>` object
-    has returned :data:`True` from
-    :meth:`finished() <google.cloud.bigtable.instance.Operation.finished>`, the
-    object should not be re-used. Subsequent calls to
-    :meth:`finished() <google.cloud.bigtable.instance.Operation.finished>`
-    will result in a :class:`ValueError <exceptions.ValueError>`.
-
-Get metadata for an existing Instance
--------------------------------------
-
-After creating the instance object, make a `GetInstance`_ API request
-with :meth:`reload() <google.cloud.bigtable.instance.Instance.reload>`:
-
-.. code:: python
-
-    instance.reload()
-
-This will load ``display_name`` for the existing ``instance`` object.
-
-Update an existing Instance
----------------------------
-
-After creating the instance object, make an `UpdateInstance`_ API request
-with :meth:`update() <google.cloud.bigtable.instance.Instance.update>`:
-
-.. code:: python
-
-    client.display_name = 'New display_name'
-    instance.update()
-
-Delete an existing Instance
----------------------------
-
-Make a `DeleteInstance`_ API request with
-:meth:`delete() <google.cloud.bigtable.instance.Instance.delete>`:
-
-.. code:: python
-
-    instance.delete()
-
-Next Step
----------
-
-Now we go down the hierarchy from
-:class:`Instance <google.cloud.bigtable.instance.Instance>` to a
-:class:`Table <google.cloud.bigtable.table.Table>`.
-
-Head next to learn about the :doc:`bigtable-table-api`.
-
-.. _Instance Admin API: https://cloud.google.com/bigtable/docs/creating-instance
-.. _CreateInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L66-L68
-.. _GetInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L38-L40
-.. _UpdateInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L93-L95
-.. _DeleteInstance: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L109-L111
-.. _ListInstances: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/instance/v1/bigtable_instance_service.proto#L44-L46
-.. _GetOperation: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/longrunning/operations.proto#L43-L45
-.. _long-running operation: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/longrunning/operations.proto#L73-L102
diff --git a/docs/bigtable-row-filters.rst b/docs/bigtable-row-filters.rst
deleted file mode 100644
index 4a0112f2f519..000000000000
--- a/docs/bigtable-row-filters.rst
+++ /dev/null
@@ -1,67 +0,0 @@
-Bigtable Row Filters
-====================
-
-It is possible to use a
-:class:`RowFilter <google.cloud.bigtable.row_filters.RowFilter>`
-when adding mutations to a
-:class:`ConditionalRow <google.cloud.bigtable.row.ConditionalRow>` and when
-reading row data with :meth:`read_row() <google.cloud.bigtable.table.Table.read_row>`
-:meth:`read_rows() <google.cloud.bigtable.table.Table.read_rows>`.
-
-As laid out in the `RowFilter definition`_, the following basic filters
-are provided:
-
-* :class:`SinkFilter <.row_filters.SinkFilter>`
-* :class:`PassAllFilter <.row_filters.PassAllFilter>`
-* :class:`BlockAllFilter <.row_filters.BlockAllFilter>`
-* :class:`RowKeyRegexFilter <.row_filters.RowKeyRegexFilter>`
-* :class:`RowSampleFilter <.row_filters.RowSampleFilter>`
-* :class:`FamilyNameRegexFilter <.row_filters.FamilyNameRegexFilter>`
-* :class:`ColumnQualifierRegexFilter <.row_filters.ColumnQualifierRegexFilter>`
-* :class:`TimestampRangeFilter <.row_filters.TimestampRangeFilter>`
-* :class:`ColumnRangeFilter <.row_filters.ColumnRangeFilter>`
-* :class:`ValueRegexFilter <.row_filters.ValueRegexFilter>`
-* :class:`ValueRangeFilter <.row_filters.ValueRangeFilter>`
-* :class:`CellsRowOffsetFilter <.row_filters.CellsRowOffsetFilter>`
-* :class:`CellsRowLimitFilter <.row_filters.CellsRowLimitFilter>`
-* :class:`CellsColumnLimitFilter <.row_filters.CellsColumnLimitFilter>`
-* :class:`StripValueTransformerFilter <.row_filters.StripValueTransformerFilter>`
-* :class:`ApplyLabelFilter <.row_filters.ApplyLabelFilter>`
-
-In addition, these filters can be combined into composite filters with
-
-* :class:`RowFilterChain <.row_filters.RowFilterChain>`
-* :class:`RowFilterUnion <.row_filters.RowFilterUnion>`
-* :class:`ConditionalRowFilter <.row_filters.ConditionalRowFilter>`
-
-These rules can be nested arbitrarily, with a basic filter at the lowest
-level. For example:
-
-.. code:: python
-
-    # Filter in a specified column (matching any column family).
-    col1_filter = ColumnQualifierRegexFilter(b'columnbia')
-
-    # Create a filter to label results.
-    label1 = u'label-red'
-    label1_filter = ApplyLabelFilter(label1)
-
-    # Combine the filters to label all the cells in columnbia.
-    chain1 = RowFilterChain(filters=[col1_filter, label1_filter])
-
-    # Create a similar filter to label cells blue.
-    col2_filter = ColumnQualifierRegexFilter(b'columnseeya')
-    label2 = u'label-blue'
-    label2_filter = ApplyLabelFilter(label2)
-    chain2 = RowFilterChain(filters=[col2_filter, label2_filter])
-
-    # Bring our two labeled columns together.
-    row_filter = RowFilterUnion(filters=[chain1, chain2])
-
-----
-
-.. automodule:: google.cloud.bigtable.row_filters
-  :members:
-  :show-inheritance:
-
-.. _RowFilter definition: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/1ff247c2e3b7cd0a2dd49071b2d95beaf6563092/bigtable-protos/src/main/proto/google/bigtable/v1/bigtable_data.proto#L195
diff --git a/docs/bigtable-table-api.rst b/docs/bigtable-table-api.rst
deleted file mode 100644
index 0d5edcd64bf2..000000000000
--- a/docs/bigtable-table-api.rst
+++ /dev/null
@@ -1,154 +0,0 @@
-Table Admin API
-===============
-
-After creating a :class:`Instance <google.cloud.bigtable.instance.Instance>`, you can
-interact with individual tables, groups of tables or column families within
-a table.
-
-List Tables
------------
-
-If you want a comprehensive list of all existing tables in a instance, make a
-`ListTables`_ API request with
-:meth:`Instance.list_tables() <google.cloud.bigtable.instance.Instance.list_tables>`:
-
-.. code:: python
-
-    >>> instance.list_tables()
-    [<google.cloud.bigtable.table.Table at 0x7ff6a1de8f50>,
-     <google.cloud.bigtable.table.Table at 0x7ff6a1de8350>]
-
-Table Factory
--------------
-
-To create a :class:`Table <google.cloud.bigtable.table.Table>` object:
-
-.. code:: python
-
-    table = instance.table(table_id)
-
-Even if this :class:`Table <google.cloud.bigtable.table.Table>` already
-has been created with the API, you'll want this object to use as a
-parent of a :class:`ColumnFamily <google.cloud.bigtable.column_family.ColumnFamily>`
-or :class:`Row <google.cloud.bigtable.row.Row>`.
-
-Create a new Table
-------------------
-
-After creating the table object, make a `CreateTable`_ API request
-with :meth:`create() <google.cloud.bigtable.table.Table.create>`:
-
-.. code:: python
-
-    table.create()
-
-If you would to initially split the table into several tablets (Tablets are
-similar to HBase regions):
-
-.. code:: python
-
-    table.create(initial_split_keys=['s1', 's2'])
-
-Delete an existing Table
-------------------------
-
-Make a `DeleteTable`_ API request with
-:meth:`delete() <google.cloud.bigtable.table.Table.delete>`:
-
-.. code:: python
-
-    table.delete()
-
-List Column Families in a Table
--------------------------------
-
-Though there is no **official** method for retrieving `column families`_
-associated with a table, the `GetTable`_ API method returns a
-table object with the names of the column families.
-
-To retrieve the list of column families use
-:meth:`list_column_families() <google.cloud.bigtable.table.Table.list_column_families>`:
-
-.. code:: python
-
-    column_families = table.list_column_families()
-
-Column Family Factory
----------------------
-
-To create a
-:class:`ColumnFamily <google.cloud.bigtable.column_family.ColumnFamily>` object:
-
-.. code:: python
-
-    column_family = table.column_family(column_family_id)
-
-There is no real reason to use this factory unless you intend to
-create or delete a column family.
-
-In addition, you can specify an optional ``gc_rule`` (a
-:class:`GarbageCollectionRule <google.cloud.bigtable.column_family.GarbageCollectionRule>`
-or similar):
-
-.. code:: python
-
-    column_family = table.column_family(column_family_id,
-                                        gc_rule=gc_rule)
-
-This rule helps the backend determine when and how to clean up old cells
-in the column family.
-
-See :doc:`bigtable-column-family` for more information about
-:class:`GarbageCollectionRule <google.cloud.bigtable.column_family.GarbageCollectionRule>`
-and related classes.
-
-Create a new Column Family
---------------------------
-
-After creating the column family object, make a `CreateColumnFamily`_ API
-request with
-:meth:`ColumnFamily.create() <google.cloud.bigtable.column_family.ColumnFamily.create>`
-
-.. code:: python
-
-    column_family.create()
-
-Delete an existing Column Family
---------------------------------
-
-Make a `DeleteColumnFamily`_ API request with
-:meth:`ColumnFamily.delete() <google.cloud.bigtable.column_family.ColumnFamily.delete>`
-
-.. code:: python
-
-    column_family.delete()
-
-Update an existing Column Family
---------------------------------
-
-Make an `UpdateColumnFamily`_ API request with
-:meth:`ColumnFamily.delete() <google.cloud.bigtable.column_family.ColumnFamily.update>`
-
-.. code:: python
-
-    column_family.update()
-
-Next Step
----------
-
-Now we go down the final step of the hierarchy from
-:class:`Table <google.cloud.bigtable.table.Table>` to
-:class:`Row <google.cloud.bigtable.row.Row>` as well as streaming
-data directly via a :class:`Table <google.cloud.bigtable.table.Table>`.
-
-Head next to learn about the :doc:`bigtable-data-api`.
-
-.. _ListTables: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L40-L42
-.. _CreateTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L35-L37
-.. _DeleteTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L50-L52
-.. _RenameTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L56-L58
-.. _GetTable: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L45-L47
-.. _CreateColumnFamily: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L61-L63
-.. _UpdateColumnFamily: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L66-L68
-.. _DeleteColumnFamily: https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/2aae624081f652427052fb652d3ae43d8ac5bf5a/bigtable-protos/src/main/proto/google/bigtable/admin/table/v1/bigtable_table_service.proto#L71-L73
-.. _column families: https://cloud.google.com/bigtable/docs/schema-design#column_families_and_column_qualifiers
diff --git a/docs/bigtable-usage.rst b/docs/bigtable-usage.rst
deleted file mode 100644
index 157c339d166b..000000000000
--- a/docs/bigtable-usage.rst
+++ /dev/null
@@ -1,26 +0,0 @@
-Using the API
-=============
-
-API requests are sent to the `Google Cloud Bigtable`_ API via RPC over HTTP/2.
-In order to support this, we'll rely on `gRPC`_. We are working with the gRPC
-team to rapidly make the install story more user-friendly.
-
-Get started by learning about the
-:class:`Client <google.cloud.bigtable.client.Client>` on the
-:doc:`bigtable-client-intro` page.
-
-In the hierarchy of API concepts
-
-* a :class:`Client <google.cloud.bigtable.client.Client>` owns a
-  :class:`Cluster <google.cloud.bigtable.instance.Instance`
-* a :class:`Cluster <google.cloud.bigtable.instance.Instance` owns a
-  :class:`Table <google.cloud.bigtable.table.Table>`
-* a :class:`Table <google.cloud.bigtable.table.Table>` owns a
-  :class:`ColumnFamily <google.cloud.bigtable.column_family.ColumnFamily>`
-* a :class:`Table <google.cloud.bigtable.table.Table>` owns a
-  :class:`Row <google.cloud.bigtable.row.Row>`
-  (and all the cells in the row)
-
-.. _Google Cloud Bigtable: https://cloud.google.com/bigtable/docs/
-.. _gRPC: http://www.grpc.io/
-.. _grpcio: https://pypi.python.org/pypi/grpcio
diff --git a/docs/conf.py b/docs/conf.py
index d27668cea964..9d1e92760a54 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,4 +1,16 @@
-# -*- coding: utf-8 -*-
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 #
 # google-cloud documentation build configuration file, created by
 # sphinx-quickstart on Tue Jan 21 22:24:47 2014.
@@ -11,26 +23,24 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-from email import message_from_string
+import email
 import os
-from pkg_resources import get_distribution
-import sys
-import urllib
+import pkg_resources
+import shutil
 
-import sphinx_rtd_theme
+from sphinx.util import logging
 
-
-ON_READ_THE_DOCS = os.environ.get('READTHEDOCS', None) == 'True'
+logger = logging.getLogger(__name__)
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('..'))
+# sys.path.insert(0, os.path.abspath('..'))
 
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+needs_sphinx = '1.6.3'
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
@@ -39,15 +49,22 @@
     'sphinx.ext.autosummary',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.napoleon',
     'sphinx.ext.todo',
     'sphinx.ext.viewcode',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = []
+templates_path = ['_templates']
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {
+   '.md': 'recommonmark.parser.CommonMarkParser',
+}
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
@@ -57,14 +74,14 @@
 
 # General information about the project.
 project = u'google-cloud'
-copyright = u'2014, Google'
+copyright = u'2014-2017, Google'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-distro = get_distribution('google-cloud')
+distro = pkg_resources.get_distribution('google-cloud-core')
 release = os.getenv('SPHINX_RELEASE', distro.version)
 
 # The language for content autogenerated by Sphinx. Refer to documentation
@@ -106,15 +123,20 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-
-if not ON_READ_THE_DOCS:
-    html_theme = 'sphinx_rtd_theme'
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+html_theme = 'alabaster'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+html_theme_options = {
+    'description': 'Google Cloud Client Libraries for Python',
+    'github_user': 'GoogleCloudPlatform',
+    'github_repo': 'google-cloud-python',
+    'github_banner': True,
+    'font_family': "'Roboto', Georgia, sans",
+    'head_font_family': "'Roboto', Georgia, serif",
+    'code_font_family': "'Roboto Mono', 'Consolas', monospace",
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
@@ -151,7 +173,14 @@
 #html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
+html_sidebars = {
+    '**': [
+        'about.html',
+        'navigation.html',
+        'relations.html',
+        'searchbox.html',
+    ]
+}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
@@ -203,7 +232,7 @@
 }
 
 metadata = distro.get_metadata(distro.PKG_INFO)
-author = message_from_string(metadata).get('Author')
+author = email.message_from_string(metadata).get('Author')
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
@@ -232,6 +261,19 @@
 #latex_domain_indices = True
 
 
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress ths to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    'ref.python'
+]
+
+
 # -- Options for manual page output --------------------------------------------
 
 # One entry per manual page. List of tuples
@@ -269,23 +311,43 @@
 # and parameter definitions from the __init__ docstring.
 autoclass_content = 'both'
 
-issue_uri = ('https://github.com/GoogleCloudPlatform/google-cloud-python/issues/'
-             'new?' + urllib.urlencode({'title': '[Documentation Issue] '}))
-issue_uri_template = (
-    issue_uri + '&' + urllib.urlencode({'body': 'Page Name: '}) + '{0}' +
-    urllib.quote('\nRelease: ') + '{1}')
-
-html_context.update(
-    issue_uri=issue_uri,
-    issue_uri_template=issue_uri_template,
-)
+# Automatically generate API reference stubs from autosummary.
+# http://www.sphinx-doc.org/en/master/ext/autosummary.html#generating-stub-pages-automatically
+autosummary_generate = True
 
 # Configuration for intersphinx:
-# Refer to the Python standard library and the oauth2client and
-# httplib2 libraries.
 intersphinx_mapping = {
-    'httplib2': ('http://httplib2.readthedocs.io/en/latest/', None),
-    'oauth2client': ('http://oauth2client.readthedocs.io/en/latest', None),
-    'pandas': ('http://pandas.pydata.org/pandas-docs/stable/', None),
-    'python': ('https://docs.python.org/2', None),
+    'fastavro': ('https://fastavro.readthedocs.io/en/stable/', None),
+    'google-auth': ('https://google-auth.readthedocs.io/en/stable', None),
+    'google-gax': ('https://gax-python.readthedocs.io/en/latest/', None),
+    'grpc': ('https://grpc.io/grpc/python/', None),
+    'pandas': ('https://pandas.pydata.org/pandas-docs/stable/', None),
+    'python': ('https://docs.python.org/3', None),
+    'requests': ('https://2.python-requests.org/en/master/', None),
 }
+
+# Static HTML pages, e.g. to support redirects
+# See: https://tech.signavio.com/2017/managing-sphinx-redirects
+# HTML pages to be copied from source to target
+static_html_pages = [
+    'datastore/usage.html',
+    'dns/usage.html',
+    'bigquery/usage.html',
+    'bigquery/generated/google.cloud.bigquery.magics.html',
+    'runtimeconfig/usage.html',
+    'spanner/usage.html',
+    'trace/starting.html',
+]
+
+def copy_static_html_pages(app, exception):
+    if exception is None and app.builder.name == 'html':
+        for static_html_page in static_html_pages:
+            target_path = app.outdir + '/' + static_html_page
+            src_path = app.srcdir + '/' + static_html_page
+            if os.path.isfile(src_path):
+                logger.info(
+                    'Copying static html: %s -> %s', src_path, target_path)
+                shutil.copyfile(src_path, target_path)
+
+def setup(app):
+    app.connect('build-finished', copy_static_html_pages)
diff --git a/docs/container b/docs/container
new file mode 120000
index 000000000000..348f01928ec5
--- /dev/null
+++ b/docs/container
@@ -0,0 +1 @@
+../container/docs/
\ No newline at end of file
diff --git a/docs/containeranalysis b/docs/containeranalysis
new file mode 120000
index 000000000000..5c1813ec7a94
--- /dev/null
+++ b/docs/containeranalysis
@@ -0,0 +1 @@
+../containeranalysis/docs
\ No newline at end of file
diff --git a/docs/core/api_core_changelog.md b/docs/core/api_core_changelog.md
new file mode 120000
index 000000000000..0d7caa4a3e6d
--- /dev/null
+++ b/docs/core/api_core_changelog.md
@@ -0,0 +1 @@
+../../api_core/CHANGELOG.md
\ No newline at end of file
diff --git a/docs/core/auth.rst b/docs/core/auth.rst
new file mode 120000
index 000000000000..db1985a01d79
--- /dev/null
+++ b/docs/core/auth.rst
@@ -0,0 +1 @@
+../../api_core/docs/auth.rst
\ No newline at end of file
diff --git a/docs/core/client.rst b/docs/core/client.rst
new file mode 120000
index 000000000000..0259d77ab42d
--- /dev/null
+++ b/docs/core/client.rst
@@ -0,0 +1 @@
+../../core/docs/client.rst
\ No newline at end of file
diff --git a/docs/core/client_info.rst b/docs/core/client_info.rst
new file mode 120000
index 000000000000..011b596537b1
--- /dev/null
+++ b/docs/core/client_info.rst
@@ -0,0 +1 @@
+../../api_core/docs/client_info.rst
\ No newline at end of file
diff --git a/docs/core/config.rst b/docs/core/config.rst
new file mode 100644
index 000000000000..139af98a42c5
--- /dev/null
+++ b/docs/core/config.rst
@@ -0,0 +1,68 @@
+Configuration
+*************
+
+Overview
+========
+
+Use service client objects to configure your applications.
+
+For example:
+
+.. code-block:: python
+
+    >>> from google.cloud import bigquery
+    >>> client = bigquery.Client()
+
+When creating a client in this way, the project ID will be determined by
+searching these locations in the following order.
+
+* GOOGLE_CLOUD_PROJECT environment variable
+* GOOGLE_APPLICATION_CREDENTIALS JSON file
+* Default service configuration path from
+  ``$ gcloud beta auth application-default login``.
+* Google App Engine application ID
+* Google Compute Engine project ID (from metadata server)
+
+You can override the detection of your default project by setting the
+ ``project`` parameter when creating client objects.
+
+.. code-block:: python
+
+    >>> from google.cloud import bigquery
+    >>> client = bigquery.Client(project='my-project')
+
+You can see what project ID a client is referencing by accessing the ``project``
+property on the client object.
+
+.. code-block:: python
+
+    >>> client.project
+    u'my-project'
+
+Authentication
+==============
+
+The authentication credentials can be implicitly determined from the
+environment or directly. See :doc:`/core/auth`.
+
+Logging in via ``gcloud beta auth application-default login`` will
+automatically configure a JSON key file with your default project ID and
+credentials.
+
+Setting the ``GOOGLE_APPLICATION_CREDENTIALS`` and ``GOOGLE_CLOUD_PROJECT``
+environment variables will override the automatically configured credentials.
+
+You can change your default project ID to ``my-new-default-project`` by
+using the ``gcloud`` CLI tool to change the configuration.
+
+.. code-block:: bash
+
+    $ gcloud config set project my-new-default-project
+
+
+Environment Variables
+=====================
+
+.. automodule:: google.cloud.environment_vars
+  :members:
+  :show-inheritance:
diff --git a/docs/core/core_changelog.md b/docs/core/core_changelog.md
new file mode 120000
index 000000000000..3a3a672fc25e
--- /dev/null
+++ b/docs/core/core_changelog.md
@@ -0,0 +1 @@
+../../core/CHANGELOG.md
\ No newline at end of file
diff --git a/docs/core/exceptions.rst b/docs/core/exceptions.rst
new file mode 120000
index 000000000000..47bcc6694524
--- /dev/null
+++ b/docs/core/exceptions.rst
@@ -0,0 +1 @@
+../../api_core/docs/exceptions.rst
\ No newline at end of file
diff --git a/docs/core/helpers.rst b/docs/core/helpers.rst
new file mode 120000
index 000000000000..30f4943f9ff1
--- /dev/null
+++ b/docs/core/helpers.rst
@@ -0,0 +1 @@
+../../api_core/docs/helpers.rst
\ No newline at end of file
diff --git a/docs/core/iam.rst b/docs/core/iam.rst
new file mode 120000
index 000000000000..349903e0f5a1
--- /dev/null
+++ b/docs/core/iam.rst
@@ -0,0 +1 @@
+../../api_core/docs/iam.rst
\ No newline at end of file
diff --git a/docs/core/index.rst b/docs/core/index.rst
new file mode 100644
index 000000000000..45c68ad08ee2
--- /dev/null
+++ b/docs/core/index.rst
@@ -0,0 +1,31 @@
+Core
+====
+
+.. toctree::
+    config
+    auth
+    client
+    client_info
+    exceptions
+    helpers
+    iam
+    operation
+    operations_client
+    page_iterator
+    path_template
+    retry
+    timeout
+
+Changelog
+~~~~~~~~~
+
+The ``google-cloud-core`` package contains helpers common to all
+``google-cloud-*`` packages. In an attempt to reach a stable API,
+much of the functionality has been split out into a new package
+``google-api-core``.
+
+.. toctree::
+    :maxdepth: 2
+
+    ``google-api-core`` Changelog <api_core_changelog>
+    ``google-cloud-core`` Changelog <core_changelog>
diff --git a/docs/core/operation.rst b/docs/core/operation.rst
new file mode 120000
index 000000000000..9a038fb6b79f
--- /dev/null
+++ b/docs/core/operation.rst
@@ -0,0 +1 @@
+../../api_core/docs/operation.rst
\ No newline at end of file
diff --git a/docs/core/operations_client.rst b/docs/core/operations_client.rst
new file mode 120000
index 000000000000..17ab60406ba7
--- /dev/null
+++ b/docs/core/operations_client.rst
@@ -0,0 +1 @@
+../../api_core/docs/operations_client.rst
\ No newline at end of file
diff --git a/docs/core/page_iterator.rst b/docs/core/page_iterator.rst
new file mode 120000
index 000000000000..c815056363ab
--- /dev/null
+++ b/docs/core/page_iterator.rst
@@ -0,0 +1 @@
+../../api_core/docs/page_iterator.rst
\ No newline at end of file
diff --git a/docs/core/path_template.rst b/docs/core/path_template.rst
new file mode 120000
index 000000000000..52a1bc7574b8
--- /dev/null
+++ b/docs/core/path_template.rst
@@ -0,0 +1 @@
+../../api_core/docs/path_template.rst
\ No newline at end of file
diff --git a/docs/core/retry.rst b/docs/core/retry.rst
new file mode 120000
index 000000000000..0800fecb5177
--- /dev/null
+++ b/docs/core/retry.rst
@@ -0,0 +1 @@
+../../api_core/docs/retry.rst
\ No newline at end of file
diff --git a/docs/core/timeout.rst b/docs/core/timeout.rst
new file mode 120000
index 000000000000..1ec11737305c
--- /dev/null
+++ b/docs/core/timeout.rst
@@ -0,0 +1 @@
+../../api_core/docs/timeout.rst
\ No newline at end of file
diff --git a/docs/datacatalog b/docs/datacatalog
new file mode 120000
index 000000000000..41b79354a771
--- /dev/null
+++ b/docs/datacatalog
@@ -0,0 +1 @@
+../datacatalog/docs
\ No newline at end of file
diff --git a/docs/datalabeling b/docs/datalabeling
new file mode 120000
index 000000000000..87c131ea5578
--- /dev/null
+++ b/docs/datalabeling
@@ -0,0 +1 @@
+../datalabeling/docs
\ No newline at end of file
diff --git a/docs/dataproc b/docs/dataproc
new file mode 120000
index 000000000000..5547c1a0d489
--- /dev/null
+++ b/docs/dataproc
@@ -0,0 +1 @@
+../dataproc/docs/
\ No newline at end of file
diff --git a/docs/datastore b/docs/datastore
new file mode 120000
index 000000000000..8ce744facb5d
--- /dev/null
+++ b/docs/datastore
@@ -0,0 +1 @@
+../datastore/docs/
\ No newline at end of file
diff --git a/docs/datastore-client.rst b/docs/datastore-client.rst
deleted file mode 100644
index 924fa5d789a5..000000000000
--- a/docs/datastore-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Datastore Client
-================
-
-.. automodule:: google.cloud.datastore.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.datastore.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/dlp b/docs/dlp
new file mode 120000
index 000000000000..b512b460a89c
--- /dev/null
+++ b/docs/dlp
@@ -0,0 +1 @@
+../dlp/docs/
\ No newline at end of file
diff --git a/docs/dns b/docs/dns
new file mode 120000
index 000000000000..9eea51dc71fe
--- /dev/null
+++ b/docs/dns
@@ -0,0 +1 @@
+../dns/docs
\ No newline at end of file
diff --git a/docs/dns-client.rst b/docs/dns-client.rst
deleted file mode 100644
index 337ac6558859..000000000000
--- a/docs/dns-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-DNS Client
-==========
-
-.. automodule:: google.cloud.dns.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.dns.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/dns-usage.rst b/docs/dns-usage.rst
deleted file mode 100644
index ce5dd24f0273..000000000000
--- a/docs/dns-usage.rst
+++ /dev/null
@@ -1,177 +0,0 @@
-Using the API
-=============
-
-Client
-------
-
-:class:`Client <google.cloud.dns.client.Client>` objects provide a means to
-configure your DNS applications.  Each instance holds both a ``project``
-and an authenticated connection to the DNS service.
-
-For an overview of authentication in ``google-cloud-python``, see :doc:`google-cloud-auth`.
-
-Assuming your environment is set up as described in that document,
-create an instance of :class:`Client <google.cloud.dns.client.Client>`.
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client()
-
-Projects
---------
-
-A project is the top-level container in the ``DNS`` API:  it is tied
-closely to billing, and can provide default access control across all its
-datasets.  If no ``project`` is passed to the client container, the library
-attempts to infer a project using the environment (including explicit
-environment variables, GAE, or GCE).
-
-To override the project inferred from the environment, pass an explicit
-``project`` to the constructor, or to either of the alternative
-``classmethod`` factories:
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-
-Project Quotas
---------------
-
-Query the quotas for a given project:
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-     >>> quotas = client.quotas()  # API request
-     >>> for key, value in sorted(quotas.items()):
-     ...     print('%s: %s' % (key, value))
-     managedZones: 10000
-     resourceRecordsPerRrset: 100
-     rrsetsPerManagedZone: 10000
-     rrsetAdditionsPerChange: 100
-     rrsetDeletionsPerChange: 100
-     totalRrdataSizePerChange: 10000
-
-
-Project ACLs
-~~~~~~~~~~~~
-
-Each project has an access control list granting reader / writer / owner
-permission to one or more entities.  This list cannot be queried or set
-via the API:  it must be managed using the Google Developer Console.
-
-
-Managed Zones
--------------
-
-A "managed zone" is the container for DNS records for the same DNS name
-suffix and has a set of name servers that accept and responds to queries:
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-     >>> zone = client.zone('acme-co', 'example.com',
-     ...                    description='Acme Company zone')
-
-     >>> zone.exists()  # API request
-     False
-     >>> zone.create()  # API request
-     >>> zone.exists()  # API request
-     True
-
-List the zones for a given project:
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-     >>> zones = client.list_zones()  # API request
-     >>> [zone.name for zone in zones]
-     ['acme-co']
-
-
-Resource Record Sets
---------------------
-
-Each managed zone exposes a read-only set of resource records:
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-     >>> zone = client.zone('acme-co', 'example.com')
-     >>> records, page_token = zone.list_resource_record_sets()  # API request
-     >>> [(record.name, record.record_type, record.ttl, record.rrdatas)
-     ...  for record in records]
-     [('example.com.', 'SOA', 21600, ['ns-cloud1.googlecomains.com dns-admin.google.com 1 21600 3600 1209600 300'])]
-
-.. note::
-
-   The ``page_token`` returned from ``zone.list_resource_record_sets()`` will
-   be an opaque string if there are more resources than can be returned in a
-   single request.  To enumerate them all, repeat calling
-   ``zone.list_resource_record_sets()``, passing the ``page_token``, until
-   the token is ``None``.  E.g.
-
-   .. doctest::
-
-      >>> records, page_token = zone.list_resource_record_sets()  # API request
-      >>> while page_token is not None:
-      ...     next_batch, page_token = zone.list_resource_record_sets(
-      ...         page_token=page_token)  # API request
-      ...     records.extend(next_batch)
-
-
-Change requests
----------------
-
-Update the resource record set for a zone by creating a change request
-bundling additions to or deletions from the set.
-
-  .. doctest::
-
-     >>> import time
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-     >>> zone = client.zone('acme-co', 'example.com')
-     >>> TWO_HOURS = 2 * 60 * 60  # seconds
-     >>> record_set = zone.resource_record_set(
-     ...    'www.example.com.', 'CNAME', TWO_HOURS, ['www1.example.com.',])
-     >>> changes = zone.changes()
-     >>> changes.add_record_set(record_set)
-     >>> changes.create()  # API request
-     >>> while changes.status != 'done':
-     ...     print('Waiting for changes to complete')
-     ...     time.sleep(60)     # or whatever interval is appropriate
-     ...     changes.reload()   # API request
-
-
-List changes made to the resource record set for a given zone:
-
-  .. doctest::
-
-     >>> from google.cloud import dns
-     >>> client = dns.Client(project='PROJECT_ID')
-     >>> zone = client.zone('acme-co', 'example.com')
-     >>> changes = []
-     >>> changes, page_token = zone.list_changes()  # API request
-
-.. note::
-
-   The ``page_token`` returned from ``zone.list_changes()`` will be
-   an opaque string if there are more changes than can be returned in a
-   single request.  To enumerate them all, repeat calling
-   ``zone.list_changes()``, passing the ``page_token``, until the token
-   is ``None``.  E.g.:
-
-   .. doctest::
-
-      >>> changes, page_token = zone.list_changes()  # API request
-      >>> while page_token is not None:
-      ...     next_batch, page_token = zone.list_changes(
-      ...         page_token=page_token)  # API request
-      ...     changes.extend(next_batch)
diff --git a/docs/error-reporting b/docs/error-reporting
new file mode 120000
index 000000000000..bb46a9501069
--- /dev/null
+++ b/docs/error-reporting
@@ -0,0 +1 @@
+../error_reporting/docs/
\ No newline at end of file
diff --git a/docs/error-reporting-client.rst b/docs/error-reporting-client.rst
deleted file mode 100644
index 4f4d08a16872..000000000000
--- a/docs/error-reporting-client.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Error Reporting Client
-=======================
-
-.. automodule:: google.cloud.error_reporting.client
-  :members:
-  :show-inheritance:
-
diff --git a/docs/error-reporting-usage.rst b/docs/error-reporting-usage.rst
deleted file mode 100644
index c746301fda30..000000000000
--- a/docs/error-reporting-usage.rst
+++ /dev/null
@@ -1,102 +0,0 @@
-Using the API
-=============
-
-
-Authentication and Configuration
---------------------------------
-
-- For an overview of authentication in ``google-cloud-python``,
-  see :doc:`google-cloud-auth`.
-
-- In addition to any authentication configuration, you should also set the
-  :envvar:`GOOGLE_CLOUD_PROJECT` environment variable for the project you'd like
-  to interact with. If you are Google App Engine or Google Compute Engine
-  this will be detected automatically.
-
-- After configuring your environment, create a
-  :class:`Client <google.cloud.error_reporting.client.Client>`
-
-  .. doctest::
-
-     >>> from google.cloud import error_reporting
-     >>> client = error_reporting.Client()
-
-  or pass in ``credentials`` and ``project`` explicitly
-
-  .. doctest::
-
-     >>> from google.cloud import error_reporting
-     >>> client = error_reporting.Client(project='my-project', credentials=creds)
-
-  Error Reporting associates errors with a service, which is an identifier for an executable,
-  App Engine service, or job. The default service is "python", but a default can be specified
-  for the client on construction time. You can also optionally specify a version for that service,
-  which defaults to "default."
-
-
-    .. doctest::
-
-       >>> from google.cloud import error_reporting
-       >>> client = error_reporting.Client(project='my-project',
-       ...                                 service="login_service",
-       ...                                 version="0.1.0")
-
-Reporting an exception
------------------------
-
-Report a stacktrace to Stackdriver Error Reporting after an exception
-
-.. doctest::
-
-   >>> from google.cloud import error_reporting
-   >>> client = error_reporting.Client()
-   >>> try:
-   >>>     raise NameError
-   >>> except Exception:
-   >>>     client.report_exception()
-
-
-By default, the client will report the error using the service specified in the client's
-constructor, or the default service of "python".
-
-The user and HTTP context can also be included in the exception. The HTTP context
-can be constructed using :class:`google.cloud.error_reporting.HTTPContext`. This will
-be used by Stackdriver Error Reporting to help group exceptions.
-
-.. doctest::
-
-   >>> from google.cloud import error_reporting
-   >>> client = error_reporting.Client()
-   >>> user = 'example@gmail.com'
-   >>> http_context = HTTPContext(method='GET', url='/', userAgent='test agent',
-   ...                            referrer='example.com', responseStatusCode=500,
-   ...                            remote_ip='1.2.3.4')
-   >>> try:
-   >>>     raise NameError
-   >>> except Exception:
-   >>>     client.report_exception(http_context=http_context, user=user))
-
-Reporting an error without an exception
------------------------------------------
-
-Errors can also be reported to Stackdriver Error Reporting outside the context of an exception.
-The library will include the file path, function name, and line number of the location where the
-error was reported.
-
-.. doctest::
-
-   >>> from google.cloud import error_reporting
-   >>> client = error_reporting.Client()
-   >>> error_reporting.report("Found an error!")
-
-Similarly to reporting an exception, the user and HTTP context can be provided:
-
-.. doctest::
-
-   >>> from google.cloud import error_reporting
-   >>> client = error_reporting.Client()
-   >>> user = 'example@gmail.com'
-   >>> http_context = HTTPContext(method='GET', url='/', userAgent='test agent',
-   ...                            referrer='example.com', responseStatusCode=500,
-   ...                            remote_ip='1.2.3.4')
-   >>> error_reporting.report("Found an error!", http_context=http_context, user=user))
diff --git a/docs/firestore b/docs/firestore
new file mode 120000
index 000000000000..3c1d977bafcf
--- /dev/null
+++ b/docs/firestore
@@ -0,0 +1 @@
+../firestore/docs/
\ No newline at end of file
diff --git a/docs/google-cloud-api.rst b/docs/google-cloud-api.rst
deleted file mode 100644
index 0fb79d966cfb..000000000000
--- a/docs/google-cloud-api.rst
+++ /dev/null
@@ -1,38 +0,0 @@
-Shared Core Modules
--------------------
-
-Base Client
-~~~~~~~~~~~
-
-.. automodule:: google.cloud.client
-  :members:
-  :show-inheritance:
-  :inherited-members:
-
-Credentials Helpers
-~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.credentials
-  :members:
-  :show-inheritance:
-
-Base Connections
-~~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.connection
-  :members:
-  :show-inheritance:
-
-Exceptions
-~~~~~~~~~~
-
-.. automodule:: google.cloud.exceptions
-  :members:
-  :show-inheritance:
-
-Environment Variables
-~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.environment_vars
-  :members:
-  :show-inheritance:
diff --git a/docs/google-cloud-auth.rst b/docs/google-cloud-auth.rst
deleted file mode 100644
index 809bdea54b8a..000000000000
--- a/docs/google-cloud-auth.rst
+++ /dev/null
@@ -1,346 +0,0 @@
-Authentication
-**************
-
-.. _Overview:
-
-Overview
-========
-
-*   **If you're running in Compute Engine or App Engine**,
-    authentication should "just work".
-
-*   **If you're developing locally**,
-    the easiest way to authenticate is using the `Google Cloud SDK`_:
-
-    .. code-block:: bash
-
-        $ gcloud beta auth application-default login
-
-    Note that this command generates credentials for client libraries. To authenticate the CLI itself, use:
-
-    .. code-block:: bash
-
-        $ gcloud auth login
-
-    Previously, ``gcloud auth login`` was used for both use cases. If
-    your ``gcloud`` installation does not support the new command,
-    please update it:
-
-    .. code-block:: bash
-
-        $ gcloud components update
-
-.. _Google Cloud SDK: http://cloud.google.com/sdk
-
-
-*   **If you're running your application elsewhere**,
-    you should download a `service account`_ JSON keyfile
-    and point to it using an environment variable:
-
-    .. code-block:: bash
-
-        $ export GOOGLE_APPLICATION_CREDENTIALS="/path/to/keyfile.json"
-
-.. _service account: https://cloud.google.com/storage/docs/authentication#generating-a-private-key
-
-Client-Provided Authentication
-==============================
-
-Every package uses a :class:`Client <google.cloud.client.Client>`
-as a base for interacting with an API.
-For example:
-
-.. code-block:: python
-
-    from google.cloud import datastore
-    client = datastore.Client()
-
-Passing no arguments at all will "just work" if you've followed the
-instructions in the :ref:`Overview`.
-The credentials are inferred from your local environment by using
-Google `Application Default Credentials`_.
-
-.. _Application Default Credentials: https://developers.google.com/identity/protocols/application-default-credentials
-
-.. _Precedence:
-
-Credential Discovery Precedence
--------------------------------
-
-When loading the `Application Default Credentials`_,
-the library will check properties of your local environment
-in the following order:
-
-#. Application running in Google App Engine
-#. JSON or PKCS12/P12 keyfile pointed to by
-   ``GOOGLE_APPLICATION_CREDENTIALS`` environment variable
-#. Credentials provided by the Google Cloud SDK (via ``gcloud auth login``)
-#. Application running in Google Compute Engine
-
-Explicit Credentials
-====================
-
-The Application Default Credentials discussed above can be useful
-if your code needs to run in many different environments or
-if you just don't want authentication to be a focus in your code.
-
-However, you may want to be explicit because
-
-* your code will only run in one place
-* you may have code which needs to be run as a specific service account
-  every time (rather than with the locally inferred credentials)
-* you may want to use two separate accounts to simultaneously access data
-  from different projects
-
-In these situations, you can create an explicit
-:class:`Credentials <oauth2client.client.Credentials>` object suited to your
-environment.
-After creation,
-you can pass it directly to a :class:`Client <google.cloud.client.Client>`:
-
-.. code:: python
-
-    client = Client(credentials=credentials)
-
-Google App Engine Environment
------------------------------
-
-To create
-:class:`credentials <oauth2client.contrib.appengine.AppAssertionCredentials>`
-just for Google App Engine:
-
-.. code:: python
-
-    from oauth2client.contrib.appengine import AppAssertionCredentials
-    credentials = AppAssertionCredentials([])
-
-Google Compute Engine Environment
----------------------------------
-
-To create
-:class:`credentials <oauth2client.contrib.gce.AppAssertionCredentials>`
-just for Google Compute Engine:
-
-.. code:: python
-
-    from oauth2client.contrib.gce import AppAssertionCredentials
-    credentials = AppAssertionCredentials([])
-
-Service Accounts
-----------------
-
-A `service account`_ can be used with both a JSON keyfile and
-a PKCS12/P12 keyfile.
-
-Directly creating ``credentials`` in `oauth2client`_ for a service
-account is a rather complex process,
-so as a convenience, the
-:meth:`from_service_account_json() <google.cloud.client.Client.from_service_account_json>`
-and
-:meth:`from_service_account_p12() <google.cloud.client.Client.from_service_account_p12>`
-factories are provided to create a :class:`Client <google.cloud.client.Client>` with
-service account credentials.
-
-.. _oauth2client: http://oauth2client.readthedocs.io/en/latest/
-
-For example, with a JSON keyfile:
-
-.. code:: python
-
-    client = Client.from_service_account_json('/path/to/keyfile.json')
-
-.. tip::
-
-    Unless you have a specific reason to use a PKCS12/P12 key for your
-    service account,
-    we recommend using a JSON key.
-
-User Accounts (3-legged OAuth 2.0) with a refresh token
--------------------------------------------------------
-
-The majority of cases are intended to authenticate machines or
-workers rather than actual user accounts. However, it's also
-possible to call Google Cloud APIs with a user account via
-`OAuth 2.0`_.
-
-.. _OAuth 2.0: https://developers.google.com/identity/protocols/OAuth2
-
-.. tip::
-
-    A production application should **use a service account**,
-    but you may wish to use your own personal user account when first
-    getting started with the ``google-cloud-python`` library.
-
-The simplest way to use credentials from a user account is via
-Application Default Credentials using ``gcloud auth login``
-(as mentioned above):
-
-.. code:: python
-
-    from oauth2client.client import GoogleCredentials
-    credentials = GoogleCredentials.get_application_default()
-
-This will still follow the :ref:`precedence <Precedence>`
-described above,
-so be sure none of the other possible environments conflict
-with your user provided credentials.
-
-Advanced users of `oauth2client`_ can also use custom flows to
-create credentials using `client secrets`_ or using a
-`webserver flow`_.
-After creation, :class:`Credentials <oauth2client.client.Credentials>`
-can be serialized with
-:meth:`to_json() <oauth2client.client.Credentials.to_json>`
-and stored in a file and then and deserialized with
-:meth:`from_json() <oauth2client.client.Credentials.from_json>`.
-
-.. _client secrets: https://developers.google.com/api-client-library/python/guide/aaa_oauth#flow_from_clientsecrets
-.. _webserver flow: https://developers.google.com/api-client-library/python/guide/aaa_oauth#OAuth2WebServerFlow
-
-Troubleshooting
-===============
-
-Setting up a Service Account
-----------------------------
-
-If your application is not running on Google Compute Engine,
-you need a `Google Developers Service Account`_.
-
-#. Visit the `Google Developers Console`_.
-
-#. Create a new project or click on an existing project.
-
-#. Navigate to **APIs & auth** > **APIs** and enable the APIs
-   that your application requires.
-
-   .. raw:: html
-
-     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png"/>
-
-  .. note::
-
-      You may need to enable billing in order to use these services.
-
-      * **BigQuery**
-
-        * BigQuery API
-
-      * **Datastore**
-
-        * Google Cloud Datastore API
-
-      * **Pub/Sub**
-
-        * Google Cloud Pub/Sub
-
-      * **Storage**
-
-        * Google Cloud Storage
-        * Google Cloud Storage JSON API
-
-#. Navigate to **APIs & auth** > **Credentials**.
-
-   You should see a screen like one of the following:
-
-   .. raw:: html
-
-     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png">
-
-   .. raw:: html
-
-     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png">
-
-  Find the "Add credentials" drop down and select "Service account" to be
-  guided through downloading a new JSON keyfile.
-
-  If you want to re-use an existing service account,
-  you can easily generate a new keyfile.
-  Just select the account you wish to re-use,
-  and click **Generate new JSON key**:
-
-   .. raw:: html
-
-     <img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png">
-
-.. _Google Developers Console: https://console.developers.google.com/project
-.. _Google Developers Service Account: https://developers.google.com/accounts/docs/OAuth2ServiceAccount
-
-Using Google Compute Engine
----------------------------
-
-If your code is running on Google Compute Engine,
-using the inferred Google `Application Default Credentials`_
-will be sufficient for retrieving credentials.
-
-However, by default your credentials may not grant you
-access to the services you intend to use.
-Be sure when you `set up the GCE instance`_,
-you add the correct scopes for the APIs you want to access:
-
-* **All APIs**
-
-    * ``https://www.googleapis.com/auth/cloud-platform``
-    * ``https://www.googleapis.com/auth/cloud-platform.read-only``
-
-* **BigQuery**
-
-    * ``https://www.googleapis.com/auth/bigquery``
-    * ``https://www.googleapis.com/auth/bigquery.insertdata``
-
-* **Datastore**
-
-    * ``https://www.googleapis.com/auth/datastore``
-    * ``https://www.googleapis.com/auth/userinfo.email``
-
-* **Pub/Sub**
-
-    * ``https://www.googleapis.com/auth/pubsub``
-
-* **Storage**
-
-    * ``https://www.googleapis.com/auth/devstorage.full_control``
-    * ``https://www.googleapis.com/auth/devstorage.read_only``
-    * ``https://www.googleapis.com/auth/devstorage.read_write``
-
-.. _set up the GCE instance: https://cloud.google.com/compute/docs/authentication#using
-
-Advanced Customization
-======================
-
-Though the ``google-cloud-python`` library defaults to using `oauth2client`_
-to sign requests and ``httplib2`` for sending requests,
-it is not a strict requirement.
-
-The :class:`Client <google.cloud.client.Client>` constructor accepts an optional
-``http`` argument in place of a ``credentials`` object.
-If passed, all HTTP requests made by the client will use your
-custom HTTP object.
-
-In order for this to be possible,
-the ``http`` object must do two things:
-
-* Handle authentication on its own
-* Define a method ``request()`` that can subsitute for
-  :meth:`httplib2.Http.request`.
-
-The entire signature from ``httplib2`` need not be implemented,
-we only use it as
-
-.. code-block:: python
-
-    http.request(uri, method=method_name, body=body, headers=headers)
-
-For an example of such an implementation,
-a ``google-cloud-python`` user created a `custom HTTP class`_
-using the `requests`_ library.
-
-.. _custom HTTP class: https://github.com/GoogleCloudPlatform/google-cloud-python/issues/908#issuecomment-110811556
-.. _requests: http://www.python-requests.org/en/latest/
-
-As for handling authentication on your own,
-it may be easiest just to re-use bits from ``oauth2client``.
-Unfortunately, these parts have a hard dependency on ``httplib2``.
-We hope to enable using `custom HTTP libraries`_ with ``oauth2client`` at
-some point.
-
-.. _custom HTTP libraries: https://github.com/google/oauth2client/issues/128
diff --git a/docs/google-cloud-config.rst b/docs/google-cloud-config.rst
deleted file mode 100644
index b30822522f76..000000000000
--- a/docs/google-cloud-config.rst
+++ /dev/null
@@ -1,60 +0,0 @@
-Configuration
-*************
-
-Overview
-========
-
-Use service client objects to configure your applications.
-
-For example:
-
-.. code-block:: python
-
-    >>> from google.cloud import bigquery
-    >>> client = bigquery.Client()
-
-When creating a client in this way, the project ID will be determined by
-searching these locations in the following order.
-
-* GOOGLE_CLOUD_PROJECT environment variable
-* GOOGLE_APPLICATION_CREDENTIALS JSON file
-* Default service configuration path from
-  ``$ gcloud beta auth application-default login``.
-* Google App Engine application ID
-* Google Compute Engine project ID (from metadata server)
-
-You can override the detection of your default project by setting the
- ``project`` parameter when creating client objects.
-
-.. code-block:: python
-
-    >>> from google.cloud import bigquery
-    >>> client = bigquery.Client(project='my-project')
-
-You can see what project ID a client is referencing by accessing the ``project``
-property on the client object.
-
-.. code-block:: python
-
-    >>> client.project
-    u'my-project'
-
-Authentication
-==============
-
-The authentication credentials can be implicitly determined from the
-environment or directly. See :doc:`google-cloud-auth`.
-
-Logging in via ``gcloud beta auth application-default login`` will
-automatically configure a JSON key file with your default project ID and
-credentials.
-
-Setting the ``GOOGLE_APPLICATION_CREDENTIALS`` and ``GOOGLE_CLOUD_PROJECT``
-environment variables will override the automatically configured credentials.
-
-You can change your default project ID to ``my-new-default-project`` by
-using the ``gcloud`` CLI tool to change the configuration.
-
-.. code-block:: bash
-
-    $ gcloud config set project my-new-default-project
diff --git a/docs/grafeas b/docs/grafeas
new file mode 120000
index 000000000000..5e8270b35fb2
--- /dev/null
+++ b/docs/grafeas
@@ -0,0 +1 @@
+../grafeas/docs
\ No newline at end of file
diff --git a/docs/iam b/docs/iam
new file mode 120000
index 000000000000..783f393b393c
--- /dev/null
+++ b/docs/iam
@@ -0,0 +1 @@
+../iam/docs
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index f258ba89c2d2..09d44e06ccda 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,215 +1,81 @@
 .. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: google-cloud
-
-  google-cloud-api
-  google-cloud-config
-  google-cloud-auth
-  operation-api
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Datastore
-
-  Client <datastore-client>
-  datastore-entities
-  datastore-keys
-  datastore-queries
-  datastore-transactions
-  datastore-batches
-  datastore-helpers
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Storage
-
-  Client <storage-client>
-  storage-blobs
-  storage-buckets
-  storage-acl
-  storage-batch
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Pub/Sub
-
-  pubsub-usage
-  Client <pubsub-client>
-  pubsub-topic
-  pubsub-subscription
-  pubsub-message
-  pubsub-iam
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: BigQuery
-
-  bigquery-usage
-  Client <bigquery-client>
-  bigquery-dataset
-  bigquery-job
-  bigquery-table
-  bigquery-query
-  bigquery-schema
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Cloud Bigtable
-
-  bigtable-usage
-  bigtable-client-intro
-  bigtable-instance-api
-  bigtable-table-api
-  bigtable-data-api
-  Client <bigtable-client>
-  bigtable-instance
-  bigtable-cluster
-  bigtable-table
-  bigtable-column-family
-  bigtable-row
-  bigtable-row-filters
-  bigtable-row-data
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Resource Manager
-
-  Overview <resource-manager-api>
-  resource-manager-client
-  resource-manager-project
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: DNS
-
-  dns-usage
-  Client <dns-client>
-  dns-zone
-  dns-resource-record-set
-  dns-changes
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Stackdriver Logging
-
-  logging-usage
-  Client <logging-client>
-  logging-logger
-  logging-entries
-  logging-metric
-  logging-sink
-  logging-handlers
-  logging-transports-sync
-  logging-transports-thread
-  logging-transports-base
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Stackdriver Error Reporting
-
-  error-reporting-usage
-  Client <error-reporting-client>
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Stackdriver Monitoring
-
-  monitoring-usage
-  Client <monitoring-client>
-  monitoring-metric
-  monitoring-resource
-  monitoring-group
-  monitoring-query
-  monitoring-timeseries
-  monitoring-label
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Translate
-
-  translate-usage
-  Client <translate-client>
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Vision
-
-  vision-usage
-  vision-client
-  vision-color
-  vision-entity
-  vision-feature
-  vision-face
-  vision-image
-  vision-safe-search
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Natural Language
-
-  language-usage
-  Client <language-client>
-  language-document
-  language-responses
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: Speech
-
-  speech-usage
-  Client <speech-client>
-
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-  :caption: External Links
-
-  GitHub <https://github.com/GoogleCloudPlatform/google-cloud-python/>
-  Issues <https://github.com/GoogleCloudPlatform/google-cloud-python/issues>
-  Stack Overflow <http://stackoverflow.com/questions/tagged/google-cloud-python>
-  PyPI <https://pypi.python.org/pypi/google-cloud>
+  :maxdepth: 1
+  :hidden:
+
+  Core Libraries <core/index>
+  Asset Management <asset/index>
+  AutoML <automl/index>
+  BigQuery <bigquery/index>
+  BigQuery Data-Transfer <bigquery_datatransfer/index>
+  BigQuery Storage <bigquery_storage/index>
+  Bigtable <bigtable/index>
+  Container <container/index>
+  Container Analysis <containeranalysis/index>
+  Data Catalog <datacatalog/index>
+  Data Labeling <datalabeling/index>
+  Data Loss Prevention <dlp/index>
+  Dataproc <dataproc/index>
+  Datastore <datastore/index>
+  DNS <dns/index>
+  Firestore <firestore/index>
+  Grafeas <grafeas/index>
+  IAM <iam/index>
+  IoT <iot/index>
+  Key Management <kms/index>
+  Natural Language <language/index>
+  OSLogin <oslogin/index>
+  PubSub <pubsub/index>
+  Memorystore <redis/index>
+  Resource Manager <resource-manager/index>
+  Runtime Configuration <runtimeconfig/index>
+  Scheduler <scheduler/index>
+  Security Center <securitycenter/index>
+  Security Scanner <websecurityscanner/index>
+  Spanner <spanner/index>
+  Speech <speech/index>
+  Stackdriver Error Reporting <error-reporting/index>
+  Stackdriver Incident Response & Management <irm/index>
+  Stackdriver Logging <logging/index>
+  Stackdriver Monitoring <monitoring/index>
+  Stackdriver Trace <trace/index>
+  Storage <storage/index>
+  Talent <talent/index>
+  Tasks <tasks/index>
+  Text-to-Speech <texttospeech/index>
+  Translate <translate/index>
+  Video Intelligence <videointelligence/index>
+  Vision <vision/index>
+  Web Risk <webrisk/index>
+  Release History <releases>
+
+Google Cloud Client Library for Python
+======================================
 
 Getting started
 ---------------
 
-The ``google-cloud`` library is ``pip`` install-able:
-
-.. code-block:: console
+For more information on setting up your Python development environment,
+such as installing ``pip`` and ``virtualenv`` on your system, please refer
+to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
 
-    $ pip install google-cloud
+.. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup
 
-If you want to install ``google-cloud-python`` from source,
-you can clone the repository from GitHub:
+Cloud Datastore
+~~~~~~~~~~~~~~~
 
-.. code-block:: console
+`Google Cloud Datastore`_ is a fully managed, schemaless database for storing
+non-relational data.
 
-    $ git clone git://github.com/GoogleCloudPlatform/google-cloud-python.git
-    $ cd google-cloud-python
-    $ python setup.py install
+.. _Google Cloud Datastore: https://cloud.google.com/datastore/
 
-----
+Install the ``google-cloud-datastore`` library using ``pip``:
 
-Cloud Datastore
-~~~~~~~~~~~~~~~
+.. code-block:: console
 
-`Google Cloud Datastore`_ is a fully managed, schemaless database for storing non-relational data.
+    $ pip install google-cloud-datastore
 
-.. _Google Cloud Datastore: https://developers.google.com/datastore/
+Example
+^^^^^^^
 
 .. code-block:: python
 
@@ -228,7 +94,16 @@ Cloud Storage
 
 `Google Cloud Storage`_ allows you to store data on Google infrastructure.
 
-.. _Google Cloud Storage: https://developers.google.com/storage/
+.. _Google Cloud Storage: https://cloud.google.com/storage/
+
+Install the ``google-cloud-storage`` library using ``pip``:
+
+.. code-block:: console
+
+    $ pip install google-cloud-storage
+
+Example
+^^^^^^^
 
 .. code-block:: python
 
@@ -238,3 +113,11 @@ Cloud Storage
   bucket = client.get_bucket('<your-bucket-name>')
   blob = bucket.blob('my-test-file.txt')
   blob.upload_from_string('this is test content!')
+
+Resources
+~~~~~~~~~
+
+* `GitHub <https://github.com/GoogleCloudPlatform/google-cloud-python/>`__
+* `Issues <https://github.com/GoogleCloudPlatform/google-cloud-python/issues>`__
+* `Stack Overflow <http://stackoverflow.com/questions/tagged/google-cloud-python>`__
+* `PyPI <https://pypi.org/project/google-cloud/>`__
diff --git a/docs/iot b/docs/iot
new file mode 120000
index 000000000000..e7b6a0ab0473
--- /dev/null
+++ b/docs/iot
@@ -0,0 +1 @@
+../iot/docs
\ No newline at end of file
diff --git a/docs/irm b/docs/irm
new file mode 120000
index 000000000000..02724766d326
--- /dev/null
+++ b/docs/irm
@@ -0,0 +1 @@
+../irm/docs
\ No newline at end of file
diff --git a/docs/json/json/home.html b/docs/json/json/home.html
deleted file mode 100644
index 762625468340..000000000000
--- a/docs/json/json/home.html
+++ /dev/null
@@ -1,127 +0,0 @@
-<section class="hero-banner">
-  <div class="container clearfix">
-    <div class="quote-box">
-      <h1>google-cloud-python</h1>
-      <p>Google Cloud Client Library for Python
-      - an idiomatic, intuitive, and natural way for Python developers to
-      integrate with Google Cloud Platform services, like Cloud Datastore
-      and Cloud Storage.</p>
-    </div>
-
-    <div class="quote-box--supplementary">
-      <pre class="skip-highlight"><code class="subtle--blue">$</code> pip install <code class="subtle--blue">--upgrade</code> <strong>google-cloud</strong></pre>
-      <h4 class="latest-release subtle" ng-if="home.latestRelease">
-        Latest Release <a ng-href="{{home.latestRelease.link}}" class="latest-release--link white">{{home.latestRelease.name}}</a>
-        {{home.latestRelease.date|date}}
-      </h4>
-    </div>
-  </div><!-- end of .container -->
-</section><!-- end of .hero-banner -->
-
-<section class="block featuring">
-  <div class="container">
-    <ul class="featuring-links">
-      <li>
-        <a href="#/docs/{{home.latestRelease.name}}/google-cloud" title="google-cloud-python docs" class="btn btn-docs">
-          <img src="src/images/icon-lang-python-gray.svg" alt="Python icon" />
-          Read the Docs
-        </a>
-      </li>
-      <li>
-        <a href="https://github.com/GoogleCloudPlatform/google-cloud-python" title="google-cloud-python on GitHub" class="ext-link">
-          <img src="src/images/icon-link-github.svg" alt="GitHub icon" />
-          GitHub
-        </a>
-      </li>
-      <li>
-        <a href="https://github.com/GoogleCloudPlatform/google-cloud-python/issues" title="google-cloud-python issues on Github" class="ext-link">
-          <img src="src/images/icon-link-github.svg" alt="GitHub icon" />
-          Issues
-        </a>
-      </li>
-      <li>
-        <a href="http://stackoverflow.com/questions/tagged/google-cloud-python" title="google-cloud-python on StackOverflow" class="ext-link">
-          <img src="src/images/icon-link-stackoverflow.svg" alt="StackOverflow icon" />
-          StackOverflow
-        </a>
-      </li>
-      <li>
-        <a href="https://pypi.python.org/pypi/google-cloud" title="google-cloud-python on pypi" class="ext-link">
-          <img src="src/images/icon-link-package-manager.svg" alt="pypi icon" />
-          PyPI
-        </a>
-      </li>
-    </ul>
-  </div><!-- end of .container -->
-</section><!-- end of .featuring -->
-
-<section class="block about">
-  <div class="container clearfix">
-    <div class="quote-box">
-      <h3 class="block-title">What is it?</h3>
-
-      <p><code>google-cloud-python</code> is a client library for accessing Google
-      Cloud Platform services that significantly reduces the boilerplate
-      code you have to write. The library provides high-level API
-      abstractions so they're easier to understand. It embraces
-      idioms of Python, works well with the standard library, and
-      integrates better with your codebase.
-      All this means you spend more time creating code that matters
-      to you.</p>
-
-      <p><code>google-cloud-python</code> is configured to access Google Cloud Platform
-      services and authorize (OAuth 2.0) automatically on your behalf.
-      With a one-line install and a private key, you are up and ready
-      to go. Better yet, if you are running on a Google Compute Engine
-      instance, the one-line install is enough!</p>
-
-    </div>
-
-    <div class="quote-box--supplementary">
-      <h4>Retrieve Datastore Entities</h4>
-      <pre><code class="hljs python">from google.cloud import datastore
-
-client = datastore.Client()
-product_key = client.key('Product', 123)
-print(client.get(product_key))</code></pre>
-    </div>
-  </div><!-- end of .container -->
-</section><!-- end of .featuring -->
-
-<section class="block examples">
-  <div class="container clearfix">
-    <h3 class="block-title">Examples</h3>
-
-    <ul>
-      <li>
-        <a href="https://github.com/GoogleCloudPlatform/google-cloud-python-expenses-demo"><code>google-cloud-python-expenses-demo</code></a> - Use google-cloud-python with the Datastore and Cloud Storage to manage expenses
-      </li>
-    </ul>
-  </div>
-</section>
-
- <section class="block">
-    <div class="container clearfix">
-    <h3 class="block-title">FAQ</h3>
-
-    <h4>What is the relationship between the <code>google-cloud-python</code> package
-    and the <code>google-cloud</code> command-line tool?</h4>
-    <p>Both the <code>google-cloud</code> command-line tool and
-    <code>google-cloud-python</code> package are a part of the Google Cloud SDK: a collection
-    of tools and libraries that enable you to easily create and manage
-    resources on the Google Cloud Platform. The <code>google-cloud</code> command-line
-    tool can be used to manage both your development workflow and your
-    Google Cloud Platform resources while the <code>google-cloud-python</code> package is the
-    Google Cloud Client Library for Python.</p>
-
-    <h4>What is the relationship between <code>google-cloud-python</code>
-    and the Google APIs Python Client?</h4>
-    <p>The <a href="https://github.com/google/google-api-python-client">
-    Google APIs Python Client</a> is a client library for
-    using the broad set of Google APIs.
-    <code>google-cloud-python</code> is built specifically for the Google Cloud Platform
-    and is the recommended way to integrate Google Cloud APIs into your
-    Python applications. If your application requires both Google Cloud Platform and
-    other Google APIs, the 2 libraries may be used by your application.</p>
-    </div>
-</section> <!-- end of FAQ -->
diff --git a/docs/json/json/master/index.json b/docs/json/json/master/index.json
deleted file mode 100644
index 1526595856f1..000000000000
--- a/docs/json/json/master/index.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-  "description": "<div class=\"section\"><h2><code>google-cloud-python</code></h2><p>Google Cloud API access in idiomatic Python.</p></div>",
-  "examples": [
-    "import google.cloud"
-  ],
-  "id": "google.cloud.__init__",
-  "methods": [],
-  "name": "__Init__",
-  "source": "/google/cloud/__init__.py"
-}
diff --git a/docs/json/json/master/overview.html b/docs/json/json/master/overview.html
deleted file mode 100644
index 21cc46ad4f73..000000000000
--- a/docs/json/json/master/overview.html
+++ /dev/null
@@ -1,57 +0,0 @@
-<h2>Getting started</h2>
-
-<p>
-The <code>google-cloud</code> library is <code>pip</code> install-able:
-</p>
-
-<div hljs>
-    $ pip install google-cloud
-</div>
-
-<p>
-If you want to install <code>google-cloud-python</code> from source,
-you can clone the repository from GitHub:
-</p>
-
-<div hljs>
-    $ git clone git://github.com/GoogleCloudPlatform/google-cloud-python.git
-    $ cd google-cloud-python
-    $ python setup.py install
-</div>
-
-<hr>
-
-<h3>Cloud Datastore</h3>
-
-<p>
-<a href="https://developers.google.com/datastore/">Google Cloud Datastore</a> is a fully managed,
- schemaless database for storing non-relational data.
-</p>
-
-<div hljs>
-
-  from google.cloud import datastore
-
-  client = datastore.Client()
-  key = client.key('Person')
-
-  entity = datastore.Entity(key=key)
-  entity['name'] = 'Your name'
-  entity['age'] = 25
-  client.put(entity)
-</div>
-
-<h3>Cloud Storage</h3>
-
-<p>
-<a href="https://developers.google.com/storage/">Google Cloud Storage</a> allows you to store data on Google infrastructure.
-</p>
-
-<div hljs>
-  from google.cloud import storage
-
-  client = storage.Client()
-  bucket = client.get_bucket('<your-bucket-name>')
-  blob = bucket.blob('my-test-file.txt')
-  blob.upload_from_string('this is test content!')
-</div>
diff --git a/docs/json/json/master/toc.json b/docs/json/json/master/toc.json
deleted file mode 100644
index 2292459a133d..000000000000
--- a/docs/json/json/master/toc.json
+++ /dev/null
@@ -1,451 +0,0 @@
-{
-  "guides": [
-    {
-      "contents": [
-        "https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/readme.md",
-        "authentication.md"
-      ],
-      "edit": "https://github.com/GoogleCloudPlatform/gcloud-common/edit/master/authentication/readme.md",
-      "id": "authentication",
-      "title": "Authentication"
-    },
-    {
-      "contents": "https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/faq/readme.md",
-      "edit": "https://github.com/GoogleCloudPlatform/gcloud-common/edit/master/faq/readme.md",
-      "id": "faq",
-      "title": "FAQ"
-    },
-    {
-      "contents": "https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/troubleshooting/readme.md",
-      "edit": "https://github.com/GoogleCloudPlatform/gcloud-common/edit/master/troubleshooting/readme.md",
-      "id": "troubleshooting",
-      "title": "Troubleshooting"
-    },
-    {
-      "contents": "https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/contributing/readme.md",
-      "edit": "https://github.com/GoogleCloudPlatform/gcloud-common/edit/master/contributing/readme.md",
-      "id": "contributing",
-      "title": "Contributing"
-    }
-  ],
-  "overview": "overview.html",
-  "services": [
-    {
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/client/client"
-        },
-        {
-          "title": "Connection",
-          "type": "google/cloud/connection/connection"
-        },
-        {
-          "title": "Credentials",
-          "type": "google/cloud/credentials"
-        },
-        {
-          "title": "Environment Variables",
-          "type": "google/cloud/environment_vars"
-        },
-        {
-          "title": "Iterator",
-          "type": "google/cloud/iterator"
-        }
-      ],
-      "title": "gcloud",
-      "type": "google/cloud/gcloud"
-    },
-    {
-      "implemented": ">=0.7.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/bigquery/client/client"
-        },
-        {
-          "title": "Dataset",
-          "type": "google/cloud/bigquery/dataset/dataset"
-        },
-        {
-          "title": "Jobs",
-          "type": "google/cloud/bigquery/job"
-        },
-        {
-          "title": "Table",
-          "type": "google/cloud/bigquery/table/table"
-        },
-        {
-          "title": "Query",
-          "type": "google/cloud/bigquery/query/query"
-        }
-      ],
-      "title": "BigQuery",
-      "type": "google/cloud/bigquery"
-    },
-    {
-      "implemented": ">=0.12.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/bigtable/client/client"
-        },
-        {
-          "title": "Cluster",
-          "type": "google/cloud/bigtable/cluster/cluster"
-        },
-        {
-          "title": "Column Families",
-          "type": "google/cloud/bigtable/column_family/columnfamily"
-        },
-        {
-          "title": "Bigtable Row",
-          "type": "google/cloud/bigtable/row/row"
-        },
-        {
-          "title": "Bigtable Row Filter",
-          "type": "google/cloud/bigtable/row_filters/rowfilter"
-        },
-        {
-          "title": "Table",
-          "type": "google/cloud/bigtable/table/table"
-        }
-      ],
-      "title": "BigTable",
-      "type": "google/cloud/bigtable"
-    },
-    {
-      "implemented": ">=0.3.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/datastore/client/client"
-        },
-        {
-          "title": "Entity",
-          "type": "google/cloud/datastore/entity/entity"
-        },
-        {
-          "title": "Key",
-          "type": "google/cloud/datastore/key/key"
-        },
-        {
-          "title": "Query",
-          "type": "google/cloud/datastore/query/query"
-        },
-        {
-          "title": "Transaction",
-          "type": "google/cloud/datastore/transaction/transaction"
-        },
-        {
-          "title": "Batch",
-          "type": "google/cloud/datastore/batch/batch"
-        },
-        {
-          "title": "Helpers",
-          "type": "datastore/helpers"
-        }
-      ],
-      "title": "Datastore",
-      "type": "google/cloud/datastore"
-    },
-    {
-      "implemented": ">=0.8.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/dns/client/client"
-        },
-        {
-          "title": "Managed Zones",
-          "type": "google/cloud/dns/zone/managedzone"
-        },
-        {
-          "title": "Resource Record Set",
-          "type": "google/cloud/dns/resource_record_set/resourcerecordset"
-        },
-        {
-          "title": "Change Sets",
-          "type": "google/cloud/dns/changes/changes"
-        }
-      ],
-      "title": "DNS",
-      "type": "google/cloud/dns"
-    },
-    {
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/error_reporting/client/client"
-        }
-      ],
-      "title": "Error Reporting",
-      "type": "google/cloud/error_reporting"
-    },
-    {
-      "nav": [
-        {
-          "title": "BadRequest",
-          "type": "google/cloud/exceptions/badrequest"
-        },
-        {
-          "title": "ClientError",
-          "type": "google/cloud/exceptions/clienterror"
-        },
-        {
-          "title": "Conflict",
-          "type": "google/cloud/exceptions/conflict"
-        },
-        {
-          "title": "Forbidden",
-          "type": "google/cloud/exceptions/forbidden"
-        },
-        {
-          "title": "GoogleCloudError",
-          "type": "google/cloud/exceptions/gclouderror"
-        },
-        {
-          "title": "InternalServerError",
-          "type": "google/cloud/exceptions/internalservererror"
-        },
-        {
-          "title": "LengthRequired",
-          "type": "google/cloud/exceptions/lengthrequired"
-        },
-        {
-          "title": "MethodNotAllowed",
-          "type": "google/cloud/exceptions/methodnotallowed"
-        },
-        {
-          "title": "MethodNotImplemented",
-          "type": "google/cloud/exceptions/methodnotimplemented"
-        },
-        {
-          "title": "MovedPermanently",
-          "type": "google/cloud/exceptions/movedpermanently"
-        },
-        {
-          "title": "NotFound",
-          "type": "google/cloud/exceptions/notfound"
-        },
-        {
-          "title": "NotModified",
-          "type": "google/cloud/exceptions/notmodified"
-        },
-        {
-          "title": "PreconditionFailed",
-          "type": "google/cloud/exceptions/preconditionfailed"
-        },
-        {
-          "title": "Redirection",
-          "type": "google/cloud/exceptions/redirection"
-        },
-        {
-          "title": "RequestRangeNotSatisfiable",
-          "type": "google/cloud/exceptions/requestrangenotsatisfiable"
-        },
-        {
-          "title": "ResumeIncomplete",
-          "type": "google/cloud/exceptions/resumeincomplete"
-        },
-        {
-          "title": "ServerError",
-          "type": "google/cloud/exceptions/servererror"
-        },
-        {
-          "title": "ServiceUnavailable",
-          "type": "google/cloud/exceptions/serviceunavailable"
-        },
-        {
-          "title": "TemporaryRedirect",
-          "type": "google/cloud/exceptions/temporaryredirect"
-        },
-        {
-          "title": "TooManyRequests",
-          "type": "google/cloud/exceptions/toomanyrequests"
-        },
-        {
-          "title": "Unauthorized",
-          "type": "google/cloud/exceptions/unauthorized"
-        },
-        {
-          "title": "Exceptions",
-          "type": "google/cloud/exceptions"
-        }
-      ],
-      "title": "Exceptions",
-      "type": "google/cloud/exceptions"
-    },
-    {
-      "implemented": ">=0.12.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/logging/client/client"
-        },
-        {
-          "title": "Logger",
-          "type": "google/cloud/logging/logger/logger"
-        },
-        {
-          "title": "Entries",
-          "type": "google/cloud/logging/entries"
-        },
-        {
-          "title": "Metric",
-          "type": "google/cloud/logging/metric/metric"
-        },
-        {
-          "title": "Sink",
-          "type": "google/cloud/logging/sink/sink"
-        }
-      ],
-      "title": "Cloud Logging",
-      "type": "google/cloud/logging"
-    },
-    {
-      "implemented": ">=0.12.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/monitoring/client/client"
-        },
-        {
-          "title": "Metric Descriptors",
-          "type": "google/cloud/monitoring/metric/metricdescriptor"
-        },
-        {
-          "title": "Label Descriptors",
-          "type": "google/cloud/monitoring/label/labeldescriptor"
-        },
-        {
-          "title": "Monitored Resource Descriptors",
-          "type": "google/cloud/monitoring/resource/resourcedescriptor"
-        },
-        {
-          "title": "Time Series Query",
-          "type": "google/cloud/monitoring/query/query"
-        },
-        {
-          "title": "Time Series",
-          "type": "googe/cloud/monitoring/timeseries/timeseries"
-        }
-      ],
-      "title": "Cloud Monitoring",
-      "type": "google/cloud/monitoring"
-    },
-    {
-      "implemented": ">=0.5.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/pubsub/client/client"
-        },
-        {
-          "title": "Topic",
-          "type": "google/cloud/pubsub/topic/topic"
-        },
-        {
-          "title": "Subscription",
-          "type": "google/cloud/pubsub/subscription/subscription"
-        },
-        {
-          "title": "Message",
-          "type": "google/cloud/pubsub/message/message"
-        },
-        {
-          "title": "Policy",
-          "type": "google/cloud/pubsub/iam/policy"
-        }
-      ],
-      "title": "Pub/Sub",
-      "type": "google/cloud/pubsub"
-    },
-    {
-      "implemented": ">=0.8.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/resource_manager/client/client"
-        },
-        {
-          "title": "Project",
-          "type": "google/cloud/resource_manager/project/project"
-        }
-      ],
-      "title": "Resource Manager",
-      "type": "google/cloud/resource_manager"
-    },
-    {
-      "implemented": ">=0.3.0",
-      "nav": [
-        {
-          "title": "Client",
-          "type": "google/cloud/storage/client/client"
-        },
-        {
-          "title": "Blob",
-          "type": "google/cloud/storage/blob/blob"
-        },
-        {
-          "title": "Bucket",
-          "type": "google/cloud/storage/bucket/bucket"
-        },
-        {
-          "title": "ACL",
-          "type": "google/cloud/storage/acl/acl"
-        },
-        {
-          "title": "Batch",
-          "type": "google/cloud/storage/batch/batch"
-        }
-      ],
-      "title": "Storage",
-      "type": "google/cloud/storage"
-    },
-    {
-      "nav": [
-        {
-          "title": "Buffered Stream",
-          "type": "google/cloud/streaming/buffered_stream/bufferedstream"
-        },
-        {
-          "title": "Request",
-          "type": "google/cloud/streaming/http_wrapper/request"
-        },
-        {
-          "title": "Response",
-          "type": "google/cloud/streaming/http_wrapper/response"
-        },
-        {
-          "title": "Stream Slice",
-          "type": "google/cloud/streaming/stream_slice/streamslice"
-        },
-        {
-          "title": "Download",
-          "type": "google/cloud/streaming/transfer/download"
-        },
-        {
-          "title": "Upload",
-          "type": "google/cloud/streaming/transfer/upload"
-        },
-        {
-          "title": "Util",
-          "type": "google/cloud/streaming/util"
-        }
-      ],
-      "title": "Streaming",
-      "type": "google/cloud/streaming"
-    },
-    {
-      "nav": [
-        {
-          "title": "Connection",
-          "type": "google/cloud/vision/connection/connection"
-        }
-      ],
-      "title": "Vision",
-      "type": "google/cloud/vision"
-    }
-  ]
-}
diff --git a/docs/json/manifest.json b/docs/json/manifest.json
deleted file mode 100644
index fa41098a95a2..000000000000
--- a/docs/json/manifest.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
-  "content": "json",
-  "friendlyLang": "Python",
-  "home": "home.html",
-  "lang": "python",
-  "latestRelease": {
-    "date": 1455306471454,
-    "link": "https://github.com/GoogleCloudPlatform/google-cloud-python/tree/master",
-    "name": "master"
-  },
-  "markdown": "python",
-  "package": {
-    "href": "https://pypi.python.org/pypi/google-cloud",
-    "title": "PyPI"
-  },
-  "titleDelimiter": ".",
-  "versions": [
-    "master"
-  ]
-}
diff --git a/docs/kms b/docs/kms
new file mode 120000
index 000000000000..503e417ec91c
--- /dev/null
+++ b/docs/kms
@@ -0,0 +1 @@
+../kms/docs/
\ No newline at end of file
diff --git a/docs/language b/docs/language
new file mode 120000
index 000000000000..ab6f1cc1e084
--- /dev/null
+++ b/docs/language
@@ -0,0 +1 @@
+../language/docs/
\ No newline at end of file
diff --git a/docs/language-client.rst b/docs/language-client.rst
deleted file mode 100644
index c0bc0b329ee0..000000000000
--- a/docs/language-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Natural Language Client
-=======================
-
-.. automodule:: google.cloud.language.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.language.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/language-document.rst b/docs/language-document.rst
deleted file mode 100644
index e879b11e590a..000000000000
--- a/docs/language-document.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Document
-~~~~~~~~
-
-.. automodule:: google.cloud.language.document
-  :members:
-  :show-inheritance:
diff --git a/docs/language-responses.rst b/docs/language-responses.rst
deleted file mode 100644
index 0ad22fa9bb4f..000000000000
--- a/docs/language-responses.rst
+++ /dev/null
@@ -1,23 +0,0 @@
-Natural Language Response Classes
-=================================
-
-Entity
-~~~~~~
-
-.. automodule:: google.cloud.language.entity
-  :members:
-  :show-inheritance:
-
-Sentiment
-~~~~~~~~~
-
-.. automodule:: google.cloud.language.sentiment
-  :members:
-  :show-inheritance:
-
-Syntax
-~~~~~~
-
-.. automodule:: google.cloud.language.syntax
-  :members:
-  :show-inheritance:
diff --git a/docs/language-usage.rst b/docs/language-usage.rst
deleted file mode 100644
index 91292b24e0b0..000000000000
--- a/docs/language-usage.rst
+++ /dev/null
@@ -1,278 +0,0 @@
-Using the API
-=============
-
-The `Google Natural Language`_ API can be used to reveal the
-structure and meaning of text via powerful machine
-learning models. You can use it to extract information about
-people, places, events and much more, mentioned in text documents,
-news articles or blog posts. You can use it to understand
-sentiment about your product on social media or parse intent from
-customer conversations happening in a call center or a messaging
-app. You can analyze text uploaded in your request or integrate
-with your document storage on Google Cloud Storage.
-
-.. warning::
-
-   This is a Beta release of Google Cloud Natural Language API. This
-   API is not intended for real-time usage in critical applications.
-
-.. _Google Natural Language: https://cloud.google.com/natural-language/docs/getting-started
-
-Client
-------
-
-:class:`~google.cloud.language.client.Client` objects provide a
-means to configure your application. Each instance holds
-an authenticated connection to the Natural Language service.
-
-For an overview of authentication in ``google-cloud-python``, see
-:doc:`google-cloud-auth`.
-
-Assuming your environment is set up as described in that document,
-create an instance of :class:`~google.cloud.language.client.Client`.
-
-  .. code-block:: python
-
-     >>> from google.cloud import language
-     >>> client = language.Client()
-
-By default the ``language`` is ``'en-US'`` and the ``encoding`` is
-UTF-8. To over-ride these values:
-
-  .. code-block:: python
-
-     >>> client = language.Client(language='es',
-     ...                          encoding=language.Encoding.UTF16)
-
-The encoding can be one of
-:attr:`Encoding.UTF8 <google.cloud.language.document.Encoding.UTF8>`,
-:attr:`Encoding.UTF16 <google.cloud.language.document.Encoding.UTF16>`, or
-:attr:`Encoding.UTF32 <google.cloud.language.document.Encoding.UTF32>`.
-
-Methods
--------
-
-The Google Natural Language API has three supported methods
-
-- `analyzeEntities`_
-- `analyzeSentiment`_
-- `annotateText`_
-
-and each method uses a `Document`_ for representing text. To
-create a :class:`~google.cloud.language.document.Document`,
-
-  .. code-block:: python
-
-     >>> text_content = (
-     ...     'Google, headquartered in Mountain View, unveiled the '
-     ...     'new Android phone at the Consumer Electronic Show.  '
-     ...     'Sundar Pichai said in his keynote that users love '
-     ...     'their new Android phones.')
-     >>> document = client.document_from_text(text_content)
-
-By using :meth:`~google.cloud.language.client.Client.document_from_text`,
-the document's type is plain text:
-
-  .. code-block:: python
-
-     >>> document.doc_type == language.Document.PLAIN_TEXT
-     True
-
-In addition, the document's language defaults to the language on
-the client
-
-  .. code-block:: python
-
-     >>> document.language
-     'en-US'
-     >>> document.language == client.language
-     True
-
-In addition, the
-:meth:`~google.cloud.language.client.Client.document_from_html`,
-factory can be used to created an HTML document. In this
-method and the from text method, the language can be
-over-ridden:
-
-  .. code-block:: python
-
-     >>> html_content = """\
-     ... <html>
-     ...   <head>
-     ...     <title>El Tiempo de las Historias</time>
-     ...   </head>
-     ...   <body>
-     ...     <p>La vaca salt&oacute; sobre la luna.</p>
-     ...   </body>
-     ... </html>
-     ... """
-     >>> document = client.document_from_html(html_content,
-     ...                                      language='es')
-
-The ``language`` argument can be either ISO-639-1 or BCP-47 language
-codes; at the time, only English, Spanish, and Japanese `are supported`_.
-However, the ``analyzeSentiment`` method `only supports`_ English text.
-
-.. _are supported: https://cloud.google.com/natural-language/docs/
-.. _only supports: https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/analyzeSentiment#body.request_body.FIELDS.document
-
-The document type (``doc_type``) value can be one of
-:attr:`Document.PLAIN_TEXT <google.cloud.language.document.Document.PLAIN_TEXT>` or
-:attr:`Document.HTML <google.cloud.language.document.Document.HTML>`.
-
-In addition to supplying the text / HTML content, a document can refer
-to content stored in `Google Cloud Storage`_. We can use the
-:meth:`~google.cloud.language.client.Client.document_from_url` method:
-
-  .. code-block:: python
-
-     >>> gcs_url = 'gs://my-text-bucket/sentiment-me.txt'
-     >>> document = client.document_from_url(
-     ...     gcs_url, doc_type=language.Document.HTML)
-     >>> document.gcs_url == gcs_url
-     True
-     >>> document.doc_type == language.Document.PLAIN_TEXT
-     True
-
-The document type can be specified with the ``doc_type`` argument:
-
-  .. code-block:: python
-
-     >>> document = client.document_from_url(
-     ...     gcs_url, doc_type=language.Document.HTML)
-
-.. _analyzeEntities: https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/analyzeEntities
-.. _analyzeSentiment: https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/analyzeSentiment
-.. _annotateText: https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/annotateText
-.. _Document: https://cloud.google.com/natural-language/reference/rest/v1beta1/Document
-.. _Google Cloud Storage: https://cloud.google.com/storage/
-
-Analyze Entities
-----------------
-
-The :meth:`~google.cloud.language.document.Document.analyze_entities` method
-finds named entities (i.e. proper names) in the text and returns them
-as a :class:`list` of :class:`~google.cloud.language.entity.Entity` objects.
-Each entity has a corresponding type, salience (prominence), associated
-metadata and other properties.
-
-  .. code-block:: python
-
-     >>> text_content = ("Michelangelo Caravaggio, Italian painter, is "
-     ...                 "known for 'The Calling of Saint Matthew'.")
-     >>> document = client.document(text_content)
-     >>> entities = document.analyze_entities()
-     >>> for entity in entities:
-     ...     print('=' * 20)
-     ...     print('         name: %s' % (entity.name,))
-     ...     print('         type: %s' % (entity.entity_type,))
-     ...     print('wikipedia_url: %s' % (entity.wikipedia_url,))
-     ...     print('     metadata: %s' % (entity.metadata,))
-     ...     print('     salience: %s' % (entity.salience,))
-     ====================
-              name: Michelangelo Caravaggio
-              type: PERSON
-     wikipedia_url: http://en.wikipedia.org/wiki/Caravaggio
-          metadata: {}
-          salience: 0.7615959
-     ====================
-              name: Italian
-              type: LOCATION
-     wikipedia_url: http://en.wikipedia.org/wiki/Italy
-          metadata: {}
-          salience: 0.19960518
-     ====================
-              name: The Calling of Saint Matthew
-              type: EVENT
-     wikipedia_url: http://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)
-          metadata: {}
-          salience: 0.038798928
-
-Analyze Sentiment
------------------
-
-The :meth:`~google.cloud.language.document.Document.analyze_sentiment` method
-analyzes the sentiment of the provided text and returns a
-:class:`~google.cloud.language.sentiment.Sentiment`. Currently, this method
-only supports English text.
-
-  .. code-block:: python
-
-     >>> text_content = "Jogging isn't very fun."
-     >>> document = client.document(text_content)
-     >>> sentiment = document.analyze_sentiment()
-     >>> print(sentiment.polarity)
-     -1
-     >>> print(sentiment.magnitude)
-     0.8
-
-Annotate Text
--------------
-
-The :meth:`~google.cloud.language.document.Document.annotate_text` method
-analyzes a document and is intended for users who are familiar with
-machine learning and need in-depth text features to build upon.
-
-The method returns a named tuple with four entries:
-
-* ``sentences``: A :class:`list` of sentences in the text
-* ``tokens``: A :class:`list` of :class:`~google.cloud.language.syntax.Token`
-  object (e.g. words, punctuation)
-* ``sentiment``: The :class:`~google.cloud.language.sentiment.Sentiment` of
-  the text (as returned by
-  :meth:`~google.cloud.language.document.Document.analyze_sentiment`)
-* ``entities``: :class:`list` of :class:`~google.cloud.language.entity.Entity`
-  objects extracted from the text (as returned by
-  :meth:`~google.cloud.language.document.Document.analyze_entities`)
-
-By default :meth:`~google.cloud.language.document.Document.annotate_text` has
-three arguments ``include_syntax``, ``include_entities`` and
-``include_sentiment`` which are all :data:`True`. However, each of these
-`Features`_ can be selectively turned off by setting the corresponding
-arguments to :data:`False`.
-
-When ``include_syntax=False``, ``sentences`` and ``tokens`` in the
-response is :data:`None`. When ``include_sentiment``, ``sentiment`` in
-the response is :data:`None`. When ``include_entities``, ``entities`` in
-the response is :data:`None`.
-
-  .. code-block:: python
-
-     >>> text_content = 'The cow jumped over the Moon.'
-     >>> document = client.document(text_content)
-     >>> annotations = document.annotate_text()
-     >>> # Sentences present if include_syntax=True
-     >>> print(annotations.sentences)
-     ['The cow jumped over the Moon.']
-     >>> # Tokens present if include_syntax=True
-     >>> for token in annotations.tokens:
-     ...     msg = '%11s: %s' % (token.part_of_speech, token.text_content)
-     ...     print(msg)
-      DETERMINER: The
-            NOUN: cow
-            VERB: jumped
-      ADPOSITION: over
-      DETERMINER: the
-            NOUN: Moon
-     PUNCTUATION: .
-     >>> # Sentiment present if include_sentiment=True
-     >>> print(annotations.sentiment.polarity)
-     1
-     >>> print(annotations.sentiment.magnitude)
-     0.1
-     >>> # Entities present if include_entities=True
-     >>> for entity in annotations.entities:
-     ...     print('=' * 20)
-     ...     print('         name: %s' % (entity.name,))
-     ...     print('         type: %s' % (entity.entity_type,))
-     ...     print('wikipedia_url: %s' % (entity.wikipedia_url,))
-     ...     print('     metadata: %s' % (entity.metadata,))
-     ...     print('     salience: %s' % (entity.salience,))
-     ====================
-              name: Moon
-              type: LOCATION
-     wikipedia_url: http://en.wikipedia.org/wiki/Natural_satellite
-          metadata: {}
-          salience: 0.11793101
-
-.. _Features: https://cloud.google.com/natural-language/reference/rest/v1beta1/documents/annotateText#Features
diff --git a/docs/logging b/docs/logging
new file mode 120000
index 000000000000..072fd0d1a72f
--- /dev/null
+++ b/docs/logging
@@ -0,0 +1 @@
+../logging/docs/
\ No newline at end of file
diff --git a/docs/logging-client.rst b/docs/logging-client.rst
deleted file mode 100644
index cc834d1c21af..000000000000
--- a/docs/logging-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Stackdriver Logging Client
-==========================
-
-.. automodule:: google.cloud.logging.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.logging.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/logging-entries.rst b/docs/logging-entries.rst
deleted file mode 100644
index 762b7776ee2c..000000000000
--- a/docs/logging-entries.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Entries
-=======
-
-.. automodule:: google.cloud.logging.entries
-  :members:
-  :show-inheritance:
-
diff --git a/docs/logging-logger.rst b/docs/logging-logger.rst
deleted file mode 100644
index 5e167671b7bd..000000000000
--- a/docs/logging-logger.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Logger
-======
-
-.. automodule:: google.cloud.logging.logger
-  :members:
-  :show-inheritance:
-
diff --git a/docs/logging-usage.rst b/docs/logging-usage.rst
deleted file mode 100644
index d6c2f8f29cf2..000000000000
--- a/docs/logging-usage.rst
+++ /dev/null
@@ -1,456 +0,0 @@
-Using the API
-=============
-
-
-Authentication and Configuration
---------------------------------
-
-- For an overview of authentication in ``google-cloud-python``,
-  see :doc:`google-cloud-auth`.
-
-- In addition to any authentication configuration, you should also set the
-  :envvar:`GOOGLE_CLOUD_PROJECT` environment variable for the project you'd like
-  to interact with. If you are Google App Engine or Google Compute Engine
-  this will be detected automatically.
-
-- The library now enables the ``gRPC`` transport for the logging API by
-  default, assuming that the required dependencies are installed and
-  importable.  To *disable* this transport, set the
-  :envvar:`GOOGLE_CLOUD_DISABLE_GRPC` environment variable to a
-  non-empty string, e.g.:  ``$ export GOOGLE_CLOUD_DISABLE_GRPC=true``.
-
-- After configuring your environment, create a
-  :class:`Client <google.cloud.logging.client.Client>`
-
-  .. doctest::
-
-     >>> from google.cloud import logging
-     >>> client = logging.Client()
-
-  or pass in ``credentials`` and ``project`` explicitly
-
-  .. doctest::
-
-     >>> from google.cloud import logging
-     >>> client = logging.Client(project='my-project', credentials=creds)
-
-
-Writing log entries
--------------------
-
-Write a simple text entry to a logger.
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> logger = client.logger('log_name')
-   >>> logger.log_text("A simple entry")  # API call
-
-Write a dictionary entry to a logger.
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> logger = client.logger('log_name')
-   >>> logger.log_struct(
-   ...     message="My second entry",
-   ...     weather="partly cloudy")  # API call
-
-
-Retrieving log entries
-----------------------
-
-Fetch entries for the default project.
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> entries, token = client.list_entries()  # API call
-   >>> for entry in entries:
-   ...    timestamp = entry.timestamp.isoformat()
-   ...    print('%sZ: %s' %
-   ...          (timestamp, entry.payload))
-   2016-02-17T20:35:49.031864072Z: A simple entry | None
-   2016-02-17T20:38:15.944418531Z: None | {'message': 'My second entry', 'weather': 'partly cloudy'}
-
-Fetch entries across multiple projects.
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> entries, token = client.list_entries(
-   ...     project_ids=['one-project', 'another-project'])  # API call
-
-Filter entries retrieved using the `Advanced Logs Filters`_ syntax
-
-.. _Advanced Logs Filters: https://cloud.google.com/logging/docs/view/advanced_filters
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> FILTER = "log:log_name AND textPayload:simple"
-   >>> entries, token = client.list_entries(filter=FILTER)  # API call
-
-Sort entries in descending timestamp order.
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> entries, token = client.list_entries(order_by=logging.DESCENDING)  # API call
-
-Retrieve entries in batches of 10, iterating until done.
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> retrieved = []
-   >>> token = None
-   >>> while True:
-   ...     entries, token = client.list_entries(page_size=10, page_token=token)  # API call
-   ...     retrieved.extend(entries)
-   ...     if token is None:
-   ...         break
-
-Retrieve entries for a single logger, sorting in descending timestamp order:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> logger = client.logger('log_name')
-   >>> entries, token = logger.list_entries(order_by=logging.DESCENDING)  # API call
-
-Delete all entries for a logger
--------------------------------
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> logger = client.logger('log_name')
-   >>> logger.delete()  # API call
-
-
-Manage log metrics
-------------------
-
-Metrics are counters of entries which match a given filter.  They can be
-used within Stackdriver Monitoring to create charts and alerts.
-
-Create a metric:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> metric = client.metric(
-   ...     "robots", "Robots all up in your server",
-   ...     filter='log:apache-access AND textPayload:robot')
-   >>> metric.exists()  # API call
-   False
-   >>> metric.create()  # API call
-   >>> metric.exists()  # API call
-   True
-
-List all metrics for a project:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> metrics, token = client.list_metrics()
-   >>> len(metrics)
-   1
-   >>> metric = metrics[0]
-   >>> metric.name
-   "robots"
-
-Refresh local information about a metric:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> metric = client.metric("robots")
-   >>> metric.reload()  # API call
-   >>> metric.description
-   "Robots all up in your server"
-   >>> metric.filter_
-   "log:apache-access AND textPayload:robot"
-
-Update a metric:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> metric = client.metric("robots")
-   >>> metric.exists()  # API call
-   True
-   >>> metric.reload()  # API call
-   >>> metric.description = "Danger, Will Robinson!"
-   >>> metric.update()  # API call
-
-Delete a metric:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> metric = client.metric("robots")
-   >>> metric.exists()  # API call
-   True
-   >>> metric.delete()  # API call
-   >>> metric.exists()  # API call
-   False
-
-Export log entries using sinks
-------------------------------
-
-Sinks allow exporting entries which match a given filter to Cloud Storage
-buckets, BigQuery datasets, or Cloud Pub/Sub topics.
-
-Export to Cloud Storage
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Make sure that the storage bucket you want to export logs too has
-``cloud-logs@google.com`` as the owner. See `Set permission for writing exported logs`_.
-
-Add ``cloud-logs@google.com`` as the owner of ``my-bucket-name``:
-
-.. doctest::
-
-    >>> from google.cloud import storage
-    >>> client = storage.Client()
-    >>> bucket = client.get_bucket('my-bucket-name')
-    >>> bucket.acl.reload()
-    >>> logs_group = bucket.acl.group('cloud-logs@google.com')
-    >>> logs_group.grant_owner()
-    >>> bucket.acl.add_entity(logs_group)
-    >>> bucket.acl.save()
-
-.. _Set permission for writing exported logs: https://cloud.google.com/logging/docs/export/configure_export#setting_product_name_short_permissions_for_writing_exported_logs
-
-Export to BigQuery
-~~~~~~~~~~~~~~~~~~
-
-To export logs to BigQuery you must log into the Cloud Platform Console
-and add ``cloud-logs@google.com`` to a dataset.
-
-See: `Setting permissions for BigQuery`_
-
-.. doctest::
-
-    >>> from google.cloud import bigquery
-    >>> from google.cloud.bigquery.dataset import AccessGrant
-    >>> bigquery_client = bigquery.Client()
-    >>> dataset = bigquery_client.dataset('my-dataset-name')
-    >>> dataset.create()
-    >>> dataset.reload()
-    >>> grants = dataset.access_grants
-    >>> grants.append(AccessGrant(
-    ...     'WRITER', 'groupByEmail', 'cloud-logs@google.com')))
-    >>> dataset.access_grants = grants
-    >>> dataset.update()
-
-.. _Setting permissions for BigQuery: https://cloud.google.com/logging/docs/export/configure_export#manual-access-bq
-
-Export to Pub/Sub
-~~~~~~~~~~~~~~~~~
-
-To export logs to BigQuery you must log into the Cloud Platform Console
-and add ``cloud-logs@google.com`` to a topic.
-
-See: `Setting permissions for Pub/Sub`_
-
-.. doctest::
-
-    >>> from google.cloud import pubsub
-    >>> client = pubsub.Client()
-    >>> topic = client.topic('your-topic-name')
-    >>> policy = top.get_iam_policy()
-    >>> policy.owners.add(policy.group('cloud-logs@google.com'))
-    >>> topic.set_iam_policy(policy)
-
-.. _Setting permissions for Pub/Sub: https://cloud.google.com/logging/docs/export/configure_export#manual-access-pubsub
-
-Create a Cloud Storage sink:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> sink = client.sink(
-   ...     "robots-storage",
-   ...     'log:apache-access AND textPayload:robot',
-   ...     'storage.googleapis.com/my-bucket-name')
-   >>> sink.exists()  # API call
-   False
-   >>> sink.create()  # API call
-   >>> sink.exists()  # API call
-   True
-
-Create a BigQuery sink:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> sink = client.sink(
-   ...     "robots-bq",
-   ...     'log:apache-access AND textPayload:robot',
-   ...     'bigquery.googleapis.com/projects/projects/my-project/datasets/my-dataset')
-   >>> sink.exists()  # API call
-   False
-   >>> sink.create()  # API call
-   >>> sink.exists()  # API call
-   True
-
-Create a Cloud Pub/Sub sink:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-
-   >>> sink = client.sink(
-   ...     "robots-pubsub",
-   ...      'log:apache-access AND textPayload:robot',
-   ...      'pubsub.googleapis.com/projects/my-project/topics/my-topic')
-   >>> sink.exists()  # API call
-   False
-   >>> sink.create()  # API call
-   >>> sink.exists()  # API call
-   True
-
-List all sinks for a project:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> sinks, token = client.list_sinks()
-   >>> for sink in sinks:
-   ...     print('%s: %s' % (sink.name, sink.destination))
-   robots-storage: storage.googleapis.com/my-bucket-name
-   robots-bq: bigquery.googleapis.com/projects/my-project/datasets/my-dataset
-   robots-pubsub: pubsub.googleapis.com/projects/my-project/topics/my-topic
-
-Refresh local information about a sink:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> sink = client.sink('robots-storage')
-   >>> sink.filter_ is None
-   True
-   >>> sink.reload()  # API call
-   >>> sink.filter_
-   'log:apache-access AND textPayload:robot'
-   >>> sink.destination
-   'storage.googleapis.com/my-bucket-name'
-
-Update a sink:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> sink = client.sink("robots")
-   >>> sink.reload()  # API call
-   >>> sink.filter_ = "log:apache-access"
-   >>> sink.update()  # API call
-
-Delete a sink:
-
-.. doctest::
-
-   >>> from google.cloud import logging
-   >>> client = logging.Client()
-   >>> sink = client.sink(
-   ...     "robots",
-   ...     filter='log:apache-access AND textPayload:robot')
-   >>> sink.exists()  # API call
-   True
-   >>> sink.delete()  # API call
-   >>> sink.exists()  # API call
-   False
-
-Integration with Python logging module
----------------------------------------------
-
-
-It's possible to tie the Python :mod:`logging` module directly into Google Cloud Logging. To use it,
-create a :class:`CloudLoggingHandler <google.cloud.logging.CloudLoggingHandler>` instance from your
-Logging client.
-
-.. doctest::
-
-    >>> import logging
-    >>> import google.cloud.logging # Don't conflict with standard logging
-    >>> from google.cloud.logging.handlers import CloudLoggingHandler
-    >>> client = google.cloud.logging.Client()
-    >>> handler = CloudLoggingHandler(client)
-    >>> cloud_logger = logging.getLogger('cloudLogger')
-    >>> cloud_logger.setLevel(logging.INFO) # defaults to WARN
-    >>> cloud_logger.addHandler(handler)
-    >>> cloud_logger.error('bad news')
-
-.. note::
-
-    This handler by default uses an asynchronous transport that sends log entries on a background
-     thread. However, the API call will still be made in the same process. For other transport
-     options, see the transports section.
-
-All logs will go to a single custom log, which defaults to "python". The name of the Python
-logger will be included in the structured log entry under the "python_logger" field. You can
-change it by providing a name to the handler:
-
-.. doctest::
-
-    >>> handler = CloudLoggingHandler(client, name="mycustomlog")
-
-It is also possible to attach the handler to the root Python logger, so that for example a plain
-`logging.warn` call would be sent to Cloud Logging, as well as any other loggers created. However,
-you must avoid infinite recursion from the logging calls the client itself makes. A helper
-method :meth:`setup_logging <google.cloud.logging.handlers.setup_logging>` is provided to configure
-this automatically:
-
-.. doctest::
-
-    >>> import logging
-    >>> import google.cloud.logging # Don't conflict with standard logging
-    >>> from google.cloud.logging.handlers import CloudLoggingHandler, setup_logging
-    >>> client = google.cloud.logging.Client()
-    >>> handler = CloudLoggingHandler(client)
-    >>> logging.getLogger().setLevel(logging.INFO) # defaults to WARN
-    >>> setup_logging(handler)
-    >>> logging.error('bad news')
-
-You can also exclude certain loggers:
-
-.. doctest::
-
-   >>> setup_logging(handler, excluded_loggers=('werkzeug',)))
-
-
-
-Python logging handler transports
-==================================
-
-The Python logging handler can use different transports. The default is
-:class:`google.cloud.logging.handlers.BackgroundThreadTransport`.
-
- 1. :class:`google.cloud.logging.handlers.BackgroundThreadTransport` this is the default. It writes
- entries on a background :class:`python.threading.Thread`.
-
- 1. :class:`google.cloud.logging.handlers.SyncTransport` this handler does a direct API call on each
- logging statement to write the entry.
diff --git a/docs/monitoring b/docs/monitoring
new file mode 120000
index 000000000000..d7a58517323e
--- /dev/null
+++ b/docs/monitoring
@@ -0,0 +1 @@
+../monitoring/docs
\ No newline at end of file
diff --git a/docs/monitoring-client.rst b/docs/monitoring-client.rst
deleted file mode 100644
index 1aec72367379..000000000000
--- a/docs/monitoring-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Stackdriver Monitoring Client
-=============================
-
-.. automodule:: google.cloud.monitoring.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.monitoring.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/monitoring-group.rst b/docs/monitoring-group.rst
deleted file mode 100644
index db7d3acb02ed..000000000000
--- a/docs/monitoring-group.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Groups
-======
-
-.. automodule:: google.cloud.monitoring.group
-  :members:
-  :show-inheritance:
-
diff --git a/docs/monitoring-label.rst b/docs/monitoring-label.rst
deleted file mode 100644
index 67b7c16b7689..000000000000
--- a/docs/monitoring-label.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Label Descriptors
-=================
-
-.. automodule:: google.cloud.monitoring.label
-  :members:
-  :show-inheritance:
diff --git a/docs/monitoring-metric.rst b/docs/monitoring-metric.rst
deleted file mode 100644
index abb6395f864c..000000000000
--- a/docs/monitoring-metric.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Metric Descriptors
-==================
-
-.. automodule:: google.cloud.monitoring.metric
-  :members:
-  :show-inheritance:
diff --git a/docs/monitoring-query.rst b/docs/monitoring-query.rst
deleted file mode 100644
index 28cc2def2522..000000000000
--- a/docs/monitoring-query.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Time Series Query
-=================
-
-.. automodule:: google.cloud.monitoring.query
-  :members:
-  :show-inheritance:
diff --git a/docs/monitoring-resource.rst b/docs/monitoring-resource.rst
deleted file mode 100644
index b7faf93e68df..000000000000
--- a/docs/monitoring-resource.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Monitored Resource Descriptors
-==============================
-
-.. automodule:: google.cloud.monitoring.resource
-  :members:
-  :show-inheritance:
diff --git a/docs/monitoring-timeseries.rst b/docs/monitoring-timeseries.rst
deleted file mode 100644
index e580f8067d69..000000000000
--- a/docs/monitoring-timeseries.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Time Series
-===========
-
-.. automodule:: google.cloud.monitoring.timeseries
-  :members:
-  :show-inheritance:
diff --git a/docs/monitoring-usage.rst b/docs/monitoring-usage.rst
deleted file mode 100644
index 7c887b114f2f..000000000000
--- a/docs/monitoring-usage.rst
+++ /dev/null
@@ -1,365 +0,0 @@
-Using the API
-=============
-
-
-Introduction
-------------
-
-With the Stackdriver Monitoring API, you can work with Stackdriver metric data
-pertaining to monitored resources in Google Cloud Platform (GCP)
-or elsewhere.
-
-Essential concepts:
-
-- Metric data is associated with a **monitored resource**. A monitored
-  resource has a *resource type* and a set of *resource labels* —
-  key-value pairs — that identify the particular resource.
-- A **metric** further identifies the particular kind of data that
-  is being collected. It has a *metric type* and a set of *metric
-  labels* that, when combined with the resource labels, identify
-  a particular time series.
-- A **time series** is a collection of data points associated with
-  points or intervals in time.
-
-Please refer to the documentation for the `Stackdriver Monitoring API`_ for
-more information.
-
-At present, this client library supports the following features
-of the API:
-
-- Querying of time series.
-- Querying of metric descriptors and monitored resource descriptors.
-- Creation and deletion of metric descriptors for custom metrics.
-- Writing of custom metric data.
-
-.. _Stackdriver Monitoring API: https://cloud.google.com/monitoring/api/v3/
-
-
-The Stackdriver Monitoring Client Object
-----------------------------------------
-
-The Stackdriver Monitoring client library generally makes its
-functionality available as methods of the monitoring
-:class:`~google.cloud.monitoring.client.Client` class.
-A :class:`~google.cloud.monitoring.client.Client` instance holds
-authentication credentials and the ID of the target project with
-which the metric data of interest is associated. This project ID
-will often refer to a `Stackdriver account`_ binding multiple
-GCP projects and AWS accounts. It can also simply be the ID of
-a monitored project.
-
-Most often the authentication credentials will be determined
-implicitly from your environment. See :doc:`google-cloud-auth` for
-more information.
-
-It is thus typical to create a client object as follows::
-
-    >>> from google.cloud import monitoring
-    >>> client = monitoring.Client(project='target-project')
-
-If you are running in Google Compute Engine or Google App Engine,
-the current project is the default target project. This default
-can be further overridden with the :envvar:`GOOGLE_CLOUD_PROJECT`
-environment variable. Using the default target project is
-even easier::
-
-    >>> client = monitoring.Client()
-
-If necessary, you can pass in ``credentials`` and ``project`` explicitly::
-
-    >>> client = monitoring.Client(project='target-project', credentials=...)
-
-.. _Stackdriver account: https://cloud.google.com/monitoring/accounts/
-
-
-Monitored Resource Descriptors
-------------------------------
-
-The available monitored resource types are defined by *monitored resource
-descriptors*. You can fetch a list of these with the
-:meth:`~google.cloud.monitoring.client.Client.list_resource_descriptors` method::
-
-    >>> for descriptor in client.list_resource_descriptors():
-    ...     print(descriptor.type)
-
-Each :class:`~google.cloud.monitoring.resource.ResourceDescriptor`
-has a type, a display name, a description, and a list of
-:class:`~google.cloud.monitoring.label.LabelDescriptor` instances.
-See the documentation about `Monitored Resources`_
-for more information.
-
-.. _Monitored Resources:
-    https://cloud.google.com/monitoring/api/v3/monitored-resources
-
-
-Metric Descriptors
-------------------
-
-The available metric types are defined by *metric descriptors*.
-They include `platform metrics`_, `agent metrics`_, and `custom metrics`_.
-You can list all of these with the
-:meth:`~google.cloud.monitoring.client.Client.list_metric_descriptors` method::
-
-    >>> for descriptor in client.list_metric_descriptors():
-    ...     print(descriptor.type)
-
-See :class:`~google.cloud.monitoring.metric.MetricDescriptor` and the
-`Metric Descriptors`_ API documentation for more information.
-
-You can create new metric descriptors to define custom metrics in
-the ``custom.googleapis.com`` namespace. You do this by creating a
-:class:`~google.cloud.monitoring.metric.MetricDescriptor` object using the
-client's :meth:`~google.cloud.monitoring.client.Client.metric_descriptor`
-factory and then calling the object's
-:meth:`~google.cloud.monitoring.metric.MetricDescriptor.create` method::
-
-    >>> from google.cloud.monitoring import MetricKind, ValueType
-    >>> descriptor = client.metric_descriptor(
-    ...     'custom.googleapis.com/my_metric',
-    ...     metric_kind=MetricKind.GAUGE,
-    ...     value_type=ValueType.DOUBLE,
-    ...     description='This is a simple example of a custom metric.')
-    >>> descriptor.create()
-
-You can delete such a metric descriptor as follows::
-
-    >>> descriptor = client.metric_descriptor(
-    ...     'custom.googleapis.com/my_metric')
-    >>> descriptor.delete()
-
-To define a custom metric parameterized by one or more labels,
-you must build the appropriate
-:class:`~google.cloud.monitoring.label.LabelDescriptor` objects
-and include them in the
-:class:`~google.cloud.monitoring.metric.MetricDescriptor` object
-before you call
-:meth:`~google.cloud.monitoring.metric.MetricDescriptor.create`::
-
-    >>> from google.cloud.monitoring import LabelDescriptor, LabelValueType
-    >>> label = LabelDescriptor('response_code', LabelValueType.INT64,
-    ...                         description='HTTP status code')
-    >>> descriptor = client.metric_descriptor(
-    ...     'custom.googleapis.com/my_app/response_count',
-    ...     metric_kind=MetricKind.CUMULATIVE,
-    ...     value_type=ValueType.INT64,
-    ...     labels=[label],
-    ...     description='Cumulative count of HTTP responses.')
-    >>> descriptor.create()
-
-.. _platform metrics: https://cloud.google.com/monitoring/api/metrics
-.. _agent metrics: https://cloud.google.com/monitoring/agent/
-.. _custom metrics: https://cloud.google.com/monitoring/custom-metrics/
-.. _Metric Descriptors:
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.metricDescriptors
-
-
-Groups
-------
-
-A group is a dynamic collection of *monitored resources* whose membership is
-defined by a `filter`_.  These groups are usually created via the
-`Stackdriver dashboard`_. You can list all the groups in a project with the
-:meth:`~google.cloud.monitoring.client.Client.list_groups` method::
-
-    >>> for group in client.list_groups():
-    ...     print(group.id, group.display_name, group.parent_id)
-    ('a001', 'Production', None)
-    ('a002', 'Front-end', 'a001')
-    ('1003', 'Back-end', 'a001')
-
-See :class:`~google.cloud.monitoring.group.Group` and the API documentation for
-`Groups`_ and `Group members`_ for more information.
-
-You can get a specific group based on it's ID as follows::
-
-    >>> group = client.fetch_group('a001')
-
-You can get the current members of this group using the
-:meth:`~google.cloud.monitoring.group.Group.list_members` method::
-
-    >>> for member in group.list_members():
-    ...     print(member)
-
-Passing in ``end_time`` and ``start_time`` to the above method will return
-historical members based on the current filter of the group. The group
-membership changes over time, as *monitored resources* come and go, and as they
-change properties.
-
-You can create new groups to define new collections of *monitored resources*.
-You do this by creating a :class:`~google.cloud.monitoring.group.Group` object using
-the client's :meth:`~google.cloud.monitoring.client.Client.group` factory and then
-calling the object's :meth:`~google.cloud.monitoring.group.Group.create` method::
-
-    >>> filter_string = 'resource.zone = "us-central1-a"'
-    >>> group = client.group(
-    ...     display_name='My group',
-    ...     filter_string=filter_string,
-    ...     parent_id='a001',
-    ...     is_cluster=True)
-    >>> group.create()
-    >>> group.id
-    '1234'
-
-You can further manipulate an existing group by first initializing a Group
-object with it's ID or name, and then calling various methods on it.
-
-Delete a group::
-
-    >>> group = client.group('1234')
-    >>> group.exists()
-    True
-    >>> group.delete()
-
-
-Update a group::
-
-    >>> group = client.group('1234')
-    >>> group.exists()
-    True
-    >>> group.reload()
-    >>> group.display_name = 'New Display Name'
-    >>> group.update()
-
-.. _Stackdriver dashboard:
-    https://support.stackdriver.com/customer/portal/articles/\
-    1535145-creating-groups
-.. _filter:
-    https://cloud.google.com/monitoring/api/v3/filters#group-filter
-.. _Groups:
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.groups
-.. _Group members:
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.groups.members
-
-
-Time Series Queries
--------------------
-
-A time series includes a collection of data points and a set of
-resource and metric label values.
-See :class:`~google.cloud.monitoring.timeseries.TimeSeries` and the
-`Time Series`_ API documentation for more information.
-
-While you can obtain time series objects by iterating over a
-:class:`~google.cloud.monitoring.query.Query` object, usually it is
-more useful to retrieve time series data in the form of a
-:class:`pandas.DataFrame`, where each column corresponds to a
-single time series. For this, you must have :mod:`pandas` installed;
-it is not a required dependency of ``google-cloud-python``.
-
-You can display CPU utilization across your GCE instances during
-the last five minutes as follows::
-
-    >>> METRIC = 'compute.googleapis.com/instance/cpu/utilization'
-    >>> query = client.query(METRIC, minutes=5)
-    >>> print(query.as_dataframe())
-
-:class:`~google.cloud.monitoring.query.Query` objects provide a variety of
-methods for refining the query. You can request temporal alignment
-and cross-series reduction, and you can filter by label values.
-See the client :meth:`~google.cloud.monitoring.client.Client.query` method
-and the :class:`~google.cloud.monitoring.query.Query` class for more
-information.
-
-For example, you can display CPU utilization during the last hour
-across GCE instances with names beginning with ``"mycluster-"``,
-averaged over five-minute intervals and aggregated per zone, as
-follows::
-
-    >>> from google.cloud.monitoring import Aligner, Reducer
-    >>> METRIC = 'compute.googleapis.com/instance/cpu/utilization'
-    >>> query = (client.query(METRIC, hours=1)
-    ...          .select_metrics(instance_name_prefix='mycluster-')
-    ...          .align(Aligner.ALIGN_MEAN, minutes=5)
-    ...          .reduce(Reducer.REDUCE_MEAN, 'resource.zone'))
-    >>> print(query.as_dataframe())
-
-.. _Time Series:
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/TimeSeries
-
-
-Writing Custom Metrics
----------------------------
-
-The Stackdriver Monitoring API can be used to write data points to custom metrics. Please refer to
-the documentation on `Custom Metrics`_ for more information.
-
-To write a data point to a custom metric, you must provide an instance of
-:class:`~google.cloud.monitoring.metric.Metric` specifying the metric type as well as the values for
-the metric labels. You will need to have either created the metric descriptor earlier (see the
-`Metric Descriptors`_ section) or rely on metric type auto-creation (see `Auto-creation of
-custom metrics`_).
-
-You will also need to provide a :class:`~google.cloud.monitoring.resource.Resource` instance
-specifying a monitored resource type as well as values for all of the monitored resource labels,
-except for ``project_id``, which is ignored when it's included in writes to the API. A good
-choice is to use the underlying physical resource where your application code runs – e.g., a
-monitored resource type of ``gce_instance`` or ``aws_ec2_instance``. In some limited
-circumstances, such as when only a single process writes to the custom metric, you may choose to
-use the ``global`` monitored resource type.
-
-See `Monitored resource types`_ for more information about particular monitored resource types.
-
->>> from google.cloud import monitoring
->>> # Create a Resource object for the desired monitored resource type.
->>> resource = client.resource('gce_instance', labels={
-...     'instance_id': '1234567890123456789',
-...     'zone': 'us-central1-f'
-... })
->>> # Create a Metric object, specifying the metric type as well as values for any metric labels.
->>> metric = client.metric(type='custom.googleapis.com/my_metric', labels={
-...      'status': 'successful'
-... })
-
-With a ``Metric`` and ``Resource`` in hand, the :class:`~google.cloud.monitoring.client.Client`
-can be used to write :class:`~google.cloud.monitoring.timeseries.Point` values.
-
-When writing points, the Python type of the value must match the *value type* of the metric
-descriptor associated with the metric. For example, a Python float will map to ``ValueType.DOUBLE``.
-
-Stackdriver Monitoring supports several *metric kinds*: ``GAUGE``, ``CUMULATIVE``, and ``DELTA``.
-However, ``DELTA`` is not supported for custom metrics.
-
-``GAUGE`` metrics represent only a single point in time, so only the ``end_time`` should be
-specified::
-
-    >>> client.write_point(metric=metric, resource=resource,
-    ...                    value=3.14, end_time=end_time)  # API call
-
-By default, ``end_time`` defaults to :meth:`~datetime.datetime.utcnow()`, so metrics can be written
-to the current time as follows::
-
-   >>> client.write_point(metric, resource, 3.14)  # API call
-
-``CUMULATIVE`` metrics enable the monitoring system to compute rates of increase on metrics that
-sometimes reset, such as after a process restart. Without cumulative metrics, this
-reset would otherwise show up as a huge negative spike. For cumulative metrics, the same start
-time should be re-used repeatedly as more points are written to the time series.
-
-In the examples below, the ``end_time`` again defaults to the current time::
-
-    >>> RESET = datetime.utcnow()
-    >>> client.write_point(metric, resource, 3, start_time=RESET)  # API call
-    >>> client.write_point(metric, resource, 6, start_time=RESET)  # API call
-
-To write multiple ``TimeSeries`` in a single batch, you can use
-:meth:`~google.cloud.monitoring.client.write_time_series`::
-
-    >>> ts1 = client.time_series(metric1, resource, 3.14, end_time=end_time)
-    >>> ts2 = client.time_series(metric2, resource, 42, end_time=end_time)
-    >>> client.write_time_series([ts1, ts2])  # API call
-
-While multiple time series can be written in a single batch, each ``TimeSeries`` object sent to
-the API must only include a single point.
-
-All timezone-naive Python ``datetime`` objects are assumed to be UTC.
-
-.. _TimeSeries: https://cloud.google.com/monitoring/api/ref_v3/rest/v3/TimeSeries
-.. _Custom Metrics: https://cloud.google.com/monitoring/custom-metrics/
-.. _Auto-creation of custom metrics:
-    https://cloud.google.com/monitoring/custom-metrics/creating-metrics#auto-creation
-.. _Metrics: https://cloud.google.com/monitoring/api/v3/metrics
-.. _Monitored resource types:
-    https://cloud.google.com/monitoring/api/resources
diff --git a/docs/operation-api.rst b/docs/operation-api.rst
deleted file mode 100644
index 489a2683920c..000000000000
--- a/docs/operation-api.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Long-Running Operations
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.operation
-  :members:
-  :show-inheritance:
-
diff --git a/docs/oslogin b/docs/oslogin
new file mode 120000
index 000000000000..d26f32b7b0da
--- /dev/null
+++ b/docs/oslogin
@@ -0,0 +1 @@
+../oslogin/docs/
\ No newline at end of file
diff --git a/docs/pubsub b/docs/pubsub
new file mode 120000
index 000000000000..75a8b87c5ae0
--- /dev/null
+++ b/docs/pubsub
@@ -0,0 +1 @@
+../pubsub/docs/
\ No newline at end of file
diff --git a/docs/pubsub-client.rst b/docs/pubsub-client.rst
deleted file mode 100644
index c5e70e6ae683..000000000000
--- a/docs/pubsub-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Pub/Sub Client
-==============
-
-.. automodule:: google.cloud.pubsub.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.pubsub.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/pubsub-iam.rst b/docs/pubsub-iam.rst
deleted file mode 100644
index a939f4d3a8c8..000000000000
--- a/docs/pubsub-iam.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-IAM Policy
-~~~~~~~~~~
-
-.. automodule:: google.cloud.pubsub.iam
-  :members:
-  :member-order: bysource
-  :show-inheritance:
-
diff --git a/docs/pubsub-message.rst b/docs/pubsub-message.rst
deleted file mode 100644
index 654c607d46b3..000000000000
--- a/docs/pubsub-message.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Message
-~~~~~~~
-
-.. automodule:: google.cloud.pubsub.message
-  :members:
-  :show-inheritance:
diff --git a/docs/pubsub-subscription.rst b/docs/pubsub-subscription.rst
deleted file mode 100644
index f242cb644e83..000000000000
--- a/docs/pubsub-subscription.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Subscriptions
-~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.pubsub.subscription
-  :members:
-  :member-order: bysource
-  :show-inheritance:
diff --git a/docs/pubsub-topic.rst b/docs/pubsub-topic.rst
deleted file mode 100644
index 323d467a08ce..000000000000
--- a/docs/pubsub-topic.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Topics
-~~~~~~
-
-.. automodule:: google.cloud.pubsub.topic
-  :members:
-  :member-order: bysource
-  :show-inheritance:
diff --git a/docs/pubsub-usage.rst b/docs/pubsub-usage.rst
deleted file mode 100644
index 431f2784d050..000000000000
--- a/docs/pubsub-usage.rst
+++ /dev/null
@@ -1,234 +0,0 @@
-Using the API
-=============
-
-Authentication / Configuration
-------------------------------
-
-- Use :class:`Client <google.cloud.pubsub.client.Client>` objects to configure
-  your applications.
-
-- In addition to any authentication configuration, you should also set the
-  :envvar:`GOOGLE_CLOUD_PROJECT` environment variable for the project you'd like
-  to interact with. If you are Google App Engine or Google Compute Engine
-  this will be detected automatically.
-
-- The library now enables the ``gRPC`` transport for the pubsub API by
-  default, assuming that the required dependencies are installed and
-  importable.  To *disable* this transport, set the
-  :envvar:`GOOGLE_CLOUD_DISABLE_GRPC` environment variable to a
-  non-empty string, e.g.:  ``$ export GOOGLE_CLOUD_DISABLE_GRPC=true``.
-
-- :class:`Client <google.cloud.pubsub.client.Client>` objects hold both a ``project``
-  and an authenticated connection to the PubSub service.
-
-- The authentication credentials can be implicitly determined from the
-  environment or directly via
-  :meth:`from_service_account_json <google.cloud.pubsub.client.Client.from_service_account_json>`
-  and
-  :meth:`from_service_account_p12 <google.cloud.pubsub.client.Client.from_service_account_p12>`.
-
-- After setting ``GOOGLE_APPLICATION_CREDENTIALS`` and ``GOOGLE_CLOUD_PROJECT``
-  environment variables, create a :class:`Client <google.cloud.pubsub.client.Client>`
-
-  .. doctest::
-
-     >>> from google.cloud import pubsub
-     >>> client = pubsub.Client()
-
-
-Manage topics for a project
----------------------------
-
-List topics for the default project:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START client_list_topics]
-   :end-before: [END client_list_topics]
-
-Create a new topic for the default project:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_create]
-   :end-before: [END topic_create]
-
-Check for the existence of a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_exists]
-   :end-before: [END topic_exists]
-
-Delete a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_delete]
-   :end-before: [END topic_delete]
-
-Fetch the IAM policy for a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_get_iam_policy]
-   :end-before: [END topic_get_iam_policy]
-
-Update the IAM policy for a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_set_iam_policy]
-   :end-before: [END topic_set_iam_policy]
-
-Test permissions allowed by the current IAM policy on a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_check_iam_permissions]
-   :end-before: [END topic_check_iam_permissions]
-
-
-Publish messages to a topic
----------------------------
-
-Publish a single message to a topic, without attributes:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_publish_simple_message]
-   :end-before: [END topic_publish_simple_message]
-
-Publish a single message to a topic, with attributes:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_publish_message_with_attrs]
-   :end-before: [END topic_publish_message_with_attrs]
-
-Publish a set of messages to a topic (as a single request):
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_batch]
-   :end-before: [END topic_batch]
-
-.. note::
-
-   The only API request happens during the ``__exit__()`` of the topic
-   used as a context manager, and only if the block exits without raising
-   an exception.
-
-
-Manage subscriptions to topics
-------------------------------
-
-List all subscriptions for the default project:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START client_list_subscriptions]
-   :end-before: [END client_list_subscriptions]
-
-List subscriptions for a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_list_subscriptions]
-   :end-before: [END topic_list_subscriptions]
-
-Create a new pull subscription for a topic, with defaults:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_subscription_defaults]
-   :end-before: [END topic_subscription_defaults]
-
-Create a new pull subscription for a topic with a non-default ACK deadline:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_subscription_ack90]
-   :end-before: [END topic_subscription_ack90]
-
-Create a new push subscription for a topic:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START topic_subscription_push]
-   :end-before: [END topic_subscription_push]
-
-Check for the existence of a subscription:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_exists]
-   :end-before: [END subscription_exists]
-
-Convert a pull subscription to push:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_pull_push]
-   :end-before: [END subscription_pull_push]
-
-Convert a push subscription to pull:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_push_pull]
-   :end-before: [END subscription_push_pull]
-
-Re-synchronize a subscription with the back-end:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_reload]
-   :end-before: [END subscription_reload]
-
-Fetch the IAM policy for a subscription
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_get_iam_policy]
-   :end-before: [END subscription_get_iam_policy]
-
-Update the IAM policy for a subscription:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_set_iam_policy]
-   :end-before: [END subscription_set_iam_policy]
-
-Test permissions allowed by the current IAM policy on a subscription:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_check_iam_permissions]
-   :end-before: [END subscription_check_iam_permissions]
-
-Delete a subscription:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_delete]
-   :end-before: [END subscription_delete]
-
-
-Pull messages from a subscription
----------------------------------
-
-Fetch pending messages for a pull subscription:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_pull]
-   :end-before: [END subscription_pull]
-
-Note that received messages must be acknowledged, or else the back-end
-will re-send them later:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_acknowledge]
-   :end-before: [END subscription_acknowledge]
-
-Fetch messages for a pull subscription without blocking (none pending):
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_pull_return_immediately]
-   :end-before: [END subscription_pull_return_immediately]
-
-Update the acknowlegement deadline for pulled messages:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_modify_ack_deadline]
-   :end-before: [END subscription_modify_ack_deadline]
-
-Fetch pending messages, acknowledging those whose processing doesn't raise an
-error:
-
-.. literalinclude:: pubsub_snippets.py
-   :start-after: [START subscription_pull_autoack]
-   :end-before: [END subscription_pull_autoack]
-
-.. note::
-
-   The ``pull`` API request occurs at entry to the ``with`` block, and the
-   ``acknowlege`` API request occurs at the end, passing only the ``ack_ids``
-   which haven't been deleted from ``ack``
diff --git a/docs/pubsub_snippets.py b/docs/pubsub_snippets.py
deleted file mode 100644
index 82559ff9c2a1..000000000000
--- a/docs/pubsub_snippets.py
+++ /dev/null
@@ -1,477 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Testable usage examples for Google Cloud Pubsub API wrapper
-
-Each example function takes a ``client`` argument (which must be an instance
-of :class:`google.cloud.pubsub.client.Client`) and uses it to perform a task
-with the API.
-
-To facilitate running the examples as system tests, each example is also passed
-a ``to_delete`` list;  the function adds to the list any objects created which
-need to be deleted during teardown.
-"""
-
-import time
-
-from google.cloud.pubsub.client import Client
-
-
-def snippet(func):
-    """Mark ``func`` as a snippet example function."""
-    func._snippet = True
-    return func
-
-
-def _millis():
-    return time.time() * 1000
-
-
-@snippet
-def client_list_topics(client, to_delete):  # pylint: disable=unused-argument
-    """List topics for a project."""
-
-    def do_something_with(sub):  # pylint: disable=unused-argument
-        pass
-
-    # [START client_list_topics]
-    topics, token = client.list_topics()   # API request
-    while True:
-        for topic in topics:
-            do_something_with(topic)
-        if token is None:
-            break
-        topics, token = client.list_topics(page_token=token)  # API request
-    # [END client_list_topics]
-
-
-@snippet
-def client_list_subscriptions(client,
-                              to_delete):  # pylint: disable=unused-argument
-    """List all subscriptions for a project."""
-
-    def do_something_with(sub):  # pylint: disable=unused-argument
-        pass
-
-    # [START client_list_subscriptions]
-    subscriptions, token = client.list_subscriptions()   # API request
-    while True:
-        for subscription in subscriptions:
-            do_something_with(subscription)
-        if token is None:
-            break
-        subscriptions, token = client.list_subscriptions(
-            page_token=token)                           # API request
-    # [END client_list_subscriptions]
-
-
-@snippet
-def topic_create(client, to_delete):
-    """Create a topic."""
-    TOPIC_NAME = 'topic_create-%d' % (_millis(),)
-
-    # [START topic_create]
-    topic = client.topic(TOPIC_NAME)
-    topic.create()              # API request
-    # [END topic_create]
-
-    to_delete.append(topic)
-
-
-@snippet
-def topic_exists(client, to_delete):
-    """Test existence of a topic."""
-    TOPIC_NAME = 'topic_exists-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    to_delete.append(topic)
-
-    # [START topic_exists]
-    assert not topic.exists()   # API request
-    topic.create()              # API request
-    assert topic.exists()       # API request
-    # [END topic_exists]
-
-
-@snippet
-def topic_delete(client, to_delete):  # pylint: disable=unused-argument
-    """Delete a topic."""
-    TOPIC_NAME = 'topic_delete-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()              # API request
-
-    # [START topic_delete]
-    assert topic.exists()       # API request
-    topic.delete()
-    assert not topic.exists()   # API request
-    # [END topic_delete]
-
-
-@snippet
-def topic_iam_policy(client, to_delete):
-    """Fetch / set a topic's IAM policy."""
-    TOPIC_NAME = 'topic_iam_policy-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    # [START topic_get_iam_policy]
-    policy = topic.get_iam_policy()             # API request
-    # [END topic_get_iam_policy]
-
-    assert len(policy.viewers) == 0
-    assert len(policy.editors) == 0
-    assert len(policy.owners) == 0
-
-    # [START topic_set_iam_policy]
-    ALL_USERS = policy.all_users()
-    policy.viewers.add(ALL_USERS)
-    LOGS_GROUP = policy.group('cloud-logs@google.com')
-    policy.editors.add(LOGS_GROUP)
-    new_policy = topic.set_iam_policy(policy)   # API request
-    # [END topic_set_iam_policy]
-
-    assert ALL_USERS in new_policy.viewers
-    assert LOGS_GROUP in new_policy.editors
-
-
-# @snippet   # Disabled due to #1687
-def topic_check_iam_permissions(client, to_delete):
-    """Check topic IAM permissions."""
-    TOPIC_NAME = 'topic_check_iam_permissions-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    # [START topic_check_iam_permissions]
-    from google.cloud.pubsub.iam import OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE
-    TO_CHECK = [OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE]
-    ALLOWED = topic.check_iam_permissions(TO_CHECK)
-    assert set(ALLOWED) == set(TO_CHECK)
-    # [END topic_check_iam_permissions]
-
-
-@snippet
-def topic_publish_messages(client, to_delete):
-    """Publish messages to a topic."""
-    TOPIC_NAME = 'topic_publish_messages-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    # [START topic_publish_simple_message]
-    topic.publish(b'This is the message payload')               # API request
-    # [END topic_publish_simple_message]
-
-    # [START topic_publish_message_with_attrs]
-    topic.publish(b'Another message payload', extra='EXTRA')    # API request
-    # [END topic_publish_message_with_attrs]
-
-
-@snippet
-def topic_subscription(client, to_delete):
-    """Create subscriptions to a topic."""
-    TOPIC_NAME = 'topic_subscription-%d' % (_millis(),)
-    SUB_DEFAULTS = 'topic_subscription-defaults-%d' % (_millis(),)
-    SUB_ACK90 = 'topic_subscription-ack90-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    # [START topic_subscription_defaults]
-    sub_defaults = topic.subscription(SUB_DEFAULTS)
-    # [END topic_subscription_defaults]
-
-    sub_defaults.create()                               # API request
-    to_delete.append(sub_defaults)
-    expected_names = set()
-    expected_names.add(sub_defaults.full_name)
-
-    # [START topic_subscription_ack90]
-    sub_ack90 = topic.subscription(SUB_ACK90, ack_deadline=90)
-    # [END topic_subscription_ack90]
-
-    sub_ack90.create()                                  # API request
-    to_delete.append(sub_ack90)
-    expected_names.add(sub_ack90.full_name)
-
-    sub_names = set()
-
-    def do_something_with(sub):
-        sub_names.add(sub.full_name)
-
-    # [START topic_list_subscriptions]
-    subscriptions, token = topic.list_subscriptions()   # API request
-    while True:
-        for subscription in subscriptions:
-            do_something_with(subscription)
-        if token is None:
-            break
-        subscriptions, token = topic.list_subscriptions(
-            page_token=token)                           # API request
-    # [END topic_list_subscriptions]
-
-    assert sub_names.issuperset(expected_names)
-
-
-# @snippet:  disabled, because push-mode requires a validated endpoint URL
-def topic_subscription_push(client, to_delete):
-    """Create subscriptions to a topic."""
-    TOPIC_NAME = 'topic_subscription_push-%d' % (_millis(),)
-    SUB_PUSH = 'topic_subscription_push-sub-%d' % (_millis(),)
-    PUSH_URL = 'https://api.example.com/push-endpoint'
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    # [START topic_subscription_push]
-    subscription = topic.subscription(SUB_PUSH, push_endpoint=PUSH_URL)
-    subscription.create()               # API request
-    # [END topic_subscription_push]
-
-    # [START subscription_push_pull]
-    subscription.modify_push_configuration(push_endpoint=None)  # API request
-    # [END subscription_push_pull]
-
-    # [START subscription_pull_push]
-    subscription.modify_push_configuration(
-        push_endpoint=PUSH_URL)                                 # API request
-    # [END subscription_pull_push]
-
-
-@snippet
-def subscription_lifecycle(client, to_delete):
-    """Test lifecycle of a subscription."""
-    TOPIC_NAME = 'subscription_lifecycle-%d' % (_millis(),)
-    SUB_NAME = 'subscription_lifecycle-defaults-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    # [START subscription_create]
-    subscription = topic.subscription(SUB_NAME)
-    subscription.create()                               # API request
-    # [END subscription_create]
-
-    # [START subscription_exists]
-    assert subscription.exists()                        # API request
-    # [END subscription_exists]
-
-    # [START subscription_reload]
-    subscription.reload()                               # API request
-    # [END subscription_reload]
-
-    # [START subscription_delete]
-    subscription.delete()                               # API request
-    # [END subscription_delete]
-
-
-@snippet
-def subscription_pull(client, to_delete):
-    """Pull messges from a subscribed topic."""
-    TOPIC_NAME = 'subscription_pull-%d' % (_millis(),)
-    SUB_NAME = 'subscription_pull-defaults-%d' % (_millis(),)
-    PAYLOAD1 = b'PAYLOAD1'
-    PAYLOAD2 = b'PAYLOAD2'
-    EXTRA = 'EXTRA'
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    subscription = topic.subscription(SUB_NAME)
-    subscription.create()
-    to_delete.append(subscription)
-
-    # [START subscription_pull_return_immediately]
-    pulled = subscription.pull(return_immediately=True)
-    # [END subscription_pull_return_immediately]
-    assert len(pulled) == 0, "unexpected message"
-
-    topic.publish(PAYLOAD1)
-    topic.publish(PAYLOAD2, extra=EXTRA)
-
-    time.sleep(1)  # eventually-consistent
-
-    # [START subscription_pull]
-    pulled = subscription.pull(max_messages=2)
-    # [END subscription_pull]
-
-    assert len(pulled) == 2, "eventual consistency"
-
-    # [START subscription_modify_ack_deadline]
-    for ack_id, _ in pulled:
-        subscription.modify_ack_deadline(ack_id, 90)    # API request
-    # [END subscription_modify_ack_deadline]
-
-    payloads = []
-    extras = []
-
-    def do_something_with(message):  # pylint: disable=unused-argument
-        payloads.append(message.data)
-        if message.attributes:
-            extras.append(message.attributes)
-
-    class ApplicationException(Exception):
-        pass
-
-    def log_exception(_):
-        pass
-
-    # [START subscription_acknowledge]
-    for ack_id, message in pulled:
-        try:
-            do_something_with(message)
-        except ApplicationException as e:
-            log_exception(e)
-        else:
-            subscription.acknowledge([ack_id])
-    # [END subscription_acknowledge]
-
-    assert set(payloads) == set([PAYLOAD1, PAYLOAD2]), 'payloads: %s' % (
-        (payloads,))
-    assert extras == [{'extra': EXTRA}], 'extras: %s' % (
-        (extras,))
-
-
-@snippet
-def subscription_pull_w_autoack(client, to_delete):
-    """Pull messges from a topic, auto-acknowldging them"""
-    TOPIC_NAME = 'subscription_pull_autoack-%d' % (_millis(),)
-    SUB_NAME = 'subscription_pull_autoack-defaults-%d' % (_millis(),)
-    PAYLOAD1 = b'PAYLOAD1'
-    PAYLOAD2 = b'PAYLOAD2'
-    EXTRA = 'EXTRA'
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    subscription = topic.subscription(SUB_NAME)
-    subscription.create()
-    to_delete.append(subscription)
-
-    # [START topic_batch]
-    with topic.batch() as batch:
-        batch.publish(PAYLOAD1)
-        batch.publish(PAYLOAD2, extra=EXTRA)
-    # [END topic_batch]
-
-    time.sleep(1)  # eventually-consistent
-
-    payloads = []
-    extras = []
-
-    def do_something_with(message):  # pylint: disable=unused-argument
-        payloads.append(message.data)
-        if message.attributes:
-            extras.append(message.attributes)
-
-    # [START subscription_pull_autoack]
-    from google.cloud.pubsub.subscription import AutoAck
-    with AutoAck(subscription, max_messages=10) as ack:
-        for ack_id, message in list(ack.items()):
-            try:
-                do_something_with(message)
-            except Exception:  # pylint: disable=broad-except
-                del ack[ack_id]
-    # [END subscription_pull_autoack]
-
-    assert set(payloads) == set(PAYLOAD1, PAYLOAD1), "eventual consistency"
-    assert extras == [{'extra': EXTRA}], "eventual consistency"
-
-
-@snippet
-def subscription_iam_policy(client, to_delete):
-    """Fetch / set a subscription's IAM policy."""
-    TOPIC_NAME = 'subscription_iam_policy-%d' % (_millis(),)
-    SUB_NAME = 'subscription_iam_policy-defaults-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    subscription = topic.subscription(SUB_NAME)
-    subscription.create()
-    to_delete.append(subscription)
-
-    # [START subscription_get_iam_policy]
-    policy = subscription.get_iam_policy()             # API request
-    # [END subscription_get_iam_policy]
-
-    assert len(policy.viewers) == 0
-    assert len(policy.editors) == 0
-    assert len(policy.owners) == 0
-
-    # [START subscription_set_iam_policy]
-    ALL_USERS = policy.all_users()
-    policy.viewers.add(ALL_USERS)
-    LOGS_GROUP = policy.group('cloud-logs@google.com')
-    policy.editors.add(LOGS_GROUP)
-    new_policy = subscription.set_iam_policy(policy)   # API request
-    # [END subscription_set_iam_policy]
-
-    assert ALL_USERS in new_policy.viewers
-    assert LOGS_GROUP in new_policy.editors
-
-
-# @snippet   # Disabled due to #1687
-def subscription_check_iam_permissions(client, to_delete):
-    """Check subscription IAM permissions."""
-    TOPIC_NAME = 'subscription_check_iam_permissions-%d' % (_millis(),)
-    SUB_NAME = 'subscription_check_iam_permissions-defaults-%d' % (_millis(),)
-    topic = client.topic(TOPIC_NAME)
-    topic.create()
-    to_delete.append(topic)
-
-    subscription = topic.subscription(SUB_NAME)
-    subscription.create()
-    to_delete.append(subscription)
-
-    # [START subscription_check_iam_permissions]
-    from google.cloud.pubsub.iam import OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE
-    TO_CHECK = [OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE]
-    ALLOWED = subscription.check_iam_permissions(TO_CHECK)
-    assert set(ALLOWED) == set(TO_CHECK)
-    # [END subscription_check_iam_permissions]
-
-
-def _line_no(func):
-    code = getattr(func, '__code__', None) or getattr(func, 'func_code')
-    return code.co_firstlineno
-
-
-def _find_examples():
-    funcs = [obj for obj in globals().values()
-             if getattr(obj, '_snippet', False)]
-    for func in sorted(funcs, key=_line_no):
-        yield func
-
-
-def _name_and_doc(func):
-    return func.__name__, func.__doc__
-
-
-def main():
-    client = Client()
-    for example in _find_examples():
-        to_delete = []
-        print('%-25s: %s' % _name_and_doc(example))
-        try:
-            example(client, to_delete)
-        except AssertionError as e:
-            print('   FAIL: %s' % (e,))
-        except Exception as e:  # pylint: disable=broad-except
-            print('  ERROR: %r' % (e,))
-        for item in to_delete:
-            item.delete()
-
-if __name__ == '__main__':
-    main()
diff --git a/docs/redis b/docs/redis
new file mode 120000
index 000000000000..351c953543ba
--- /dev/null
+++ b/docs/redis
@@ -0,0 +1 @@
+../redis/docs
\ No newline at end of file
diff --git a/docs/releases.rst b/docs/releases.rst
new file mode 100644
index 000000000000..cdabdf539783
--- /dev/null
+++ b/docs/releases.rst
@@ -0,0 +1,60 @@
+#########################
+``google-cloud`` Releases
+#########################
+
+.. attention:: The ``google-cloud`` package is deprecated
+
+    The ``google-cloud`` package is no longer maintained or updated. Instead,
+    install the ``google-cloud-*`` subpackages directly.
+
+
+The ``google-cloud`` package (formerly ``gcloud``) contains
+**all** ``google-cloud-*`` subpackages.
+
+* ``gcloud==0.01`` (`PyPI <https://pypi.org/project/gcloud/0.01/>`__)
+* ``gcloud==0.02`` (`PyPI <https://pypi.org/project/gcloud/0.02/>`__)
+* ``gcloud==0.02.1`` (`PyPI <https://pypi.org/project/gcloud/0.02.1/>`__)
+* ``gcloud==0.02.2`` (`PyPI <https://pypi.org/project/gcloud/0.02.2/>`__)
+* ``gcloud==0.3.0`` (`PyPI <https://pypi.org/project/gcloud/0.3.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.3.0>`__)
+* ``gcloud==0.4.0`` (`PyPI <https://pypi.org/project/gcloud/0.4.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/v0.4.0>`__)
+* ``gcloud==0.4.1`` (`PyPI <https://pypi.org/project/gcloud/0.4.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.4.1>`__)
+* ``gcloud==0.4.2`` (`PyPI <https://pypi.org/project/gcloud/0.4.2/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.4.2>`__)
+* ``gcloud==0.4.3`` (`PyPI <https://pypi.org/project/gcloud/0.4.3/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.4.3>`__)
+* ``gcloud==0.5.0`` (`PyPI <https://pypi.org/project/gcloud/0.5.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.5.0>`__)
+* ``gcloud==0.6.0`` (`PyPI <https://pypi.org/project/gcloud/0.6.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.6.0>`__)
+* ``gcloud==0.7.0`` (`PyPI <https://pypi.org/project/gcloud/0.7.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.7.0>`__)
+* ``gcloud==0.7.1`` (`PyPI <https://pypi.org/project/gcloud/0.7.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.7.1>`__)
+* ``gcloud==0.8.0`` (`PyPI <https://pypi.org/project/gcloud/0.8.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.8.0>`__)
+* ``gcloud==0.9.0`` (`PyPI <https://pypi.org/project/gcloud/0.9.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.9.0>`__)
+* ``gcloud==0.10.0`` (`PyPI <https://pypi.org/project/gcloud/0.10.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.10.0>`__)
+* ``gcloud==0.10.1`` (`PyPI <https://pypi.org/project/gcloud/0.10.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.10.1>`__)
+* ``gcloud==0.11.0`` (`PyPI <https://pypi.org/project/gcloud/0.11.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.11.0>`__)
+* ``gcloud==0.12.0`` (`PyPI <https://pypi.org/project/gcloud/0.12.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.12.0>`__)
+* ``gcloud==0.12.1`` (`PyPI <https://pypi.org/project/gcloud/0.12.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.12.1>`__)
+* ``gcloud==0.13.0`` (`PyPI <https://pypi.org/project/gcloud/0.13.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.13.0>`__)
+* ``gcloud==0.14.0`` (`PyPI <https://pypi.org/project/gcloud/0.14.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.14.0>`__)
+* ``gcloud==0.15.0`` (`PyPI <https://pypi.org/project/gcloud/0.15.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.15.0>`__)
+* ``gcloud==0.16.0`` (`PyPI <https://pypi.org/project/gcloud/0.16.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.16.0>`__)
+* ``gcloud==0.16.1`` (`PyPI <https://pypi.org/project/gcloud/0.16.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.16.1>`__)
+* ``gcloud==0.17.0`` (`PyPI <https://pypi.org/project/gcloud/0.17.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.17.0>`__)
+* ``gcloud==0.18.0`` (`PyPI <https://pypi.org/project/gcloud/0.18.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.18.0>`__)
+* ``gcloud==0.18.1`` (`PyPI <https://pypi.org/project/gcloud/0.18.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.18.1>`__)
+* ``gcloud==0.18.2`` (`PyPI <https://pypi.org/project/gcloud/0.18.2/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.18.2>`__)
+* ``gcloud==0.18.3`` (`PyPI <https://pypi.org/project/gcloud/0.18.3/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.18.3>`__)
+* ``0.19.0`` (`PyPI <https://pypi.org/project/google-cloud/0.19.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.19.0>`__)
+* ``0.20.0`` (`PyPI <https://pypi.org/project/google-cloud/0.20.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/umbrella-0.20.0>`__)
+* ``0.21.0`` (`PyPI <https://pypi.org/project/google-cloud/0.21.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.21.0>`__)
+* ``0.21.1`` (`PyPI <https://pypi.org/project/google-cloud/0.21.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.21.1>`__)
+* ``0.22.0`` (`PyPI <https://pypi.org/project/google-cloud/0.22.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.22.0>`__)
+* ``0.23.0`` (`PyPI <https://pypi.org/project/google-cloud/0.23.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.23.0>`__)
+* ``0.24.0`` (`PyPI <https://pypi.org/project/google-cloud/0.24.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.24.0>`__)
+* ``0.25.0`` (`PyPI <https://pypi.org/project/google-cloud/0.25.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.25.0>`__)
+* ``0.25.1`` (`PyPI <https://pypi.org/project/google-cloud/0.25.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.25.1>`__)
+* ``0.26.0`` (`PyPI <https://pypi.org/project/google-cloud/0.26.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.26.0>`__)
+* ``0.26.1`` (`PyPI <https://pypi.org/project/google-cloud/0.26.1/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.26.1>`__)
+* ``0.27.0`` (`PyPI <https://pypi.org/project/google-cloud/0.27.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.27.0>`__)
+* ``0.28.0`` (`PyPI <https://pypi.org/project/google-cloud/0.28.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.28.0>`__)
+* ``0.29.0`` (`PyPI <https://pypi.org/project/google-cloud/0.29.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.29.0>`__)
+* ``0.30.0`` (`PyPI <https://pypi.org/project/google-cloud/0.30.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.30.0>`__)
+* ``0.31.0`` (`PyPI <https://pypi.org/project/google-cloud/0.31.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.31.0>`__)
+* ``0.32.0`` (`PyPI <https://pypi.org/project/google-cloud/0.32.0/>`__, `Release Notes <https://github.com/GoogleCloudPlatform/google-cloud-python/releases/tag/0.32.0>`__)
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 000000000000..c5e6e1519dce
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,51 @@
+setuptools >= 36.4.0
+sphinx>=1.6.3, <2.2
+ipython >= 4
+recommonmark >= 0.4.0
+grpcio-gcp >= 0.2.2
+
+-e api_core/
+-e core/
+-e storage/
+-e asset/
+-e automl/
+-e bigquery/
+-e bigquery_datatransfer/
+-e bigquery_storage/
+-e bigtable/
+-e container/
+-e containeranalysis/
+-e datacatalog/
+-e datalabeling/
+-e dataproc/
+-e datastore/
+-e dlp/
+-e dns/
+-e firestore/
+-e grafeas/
+-e iam/
+-e iot/
+-e irm/
+-e kms/
+-e language/
+-e logging/
+-e error_reporting/
+-e monitoring/
+-e pubsub/
+-e oslogin/
+-e redis/
+-e resource_manager/
+-e runtimeconfig/
+-e scheduler/
+-e securitycenter/
+-e spanner/
+-e speech/
+-e talent/
+-e tasks/
+-e texttospeech/
+-e trace/
+-e translate/
+-e videointelligence/
+-e vision/
+-e webrisk/
+-e websecurityscanner/
diff --git a/docs/resource-manager b/docs/resource-manager
new file mode 120000
index 000000000000..2bd0e30aaf64
--- /dev/null
+++ b/docs/resource-manager
@@ -0,0 +1 @@
+../resource_manager/docs/
\ No newline at end of file
diff --git a/docs/resource-manager-api.rst b/docs/resource-manager-api.rst
deleted file mode 100644
index f74439763a10..000000000000
--- a/docs/resource-manager-api.rst
+++ /dev/null
@@ -1,98 +0,0 @@
-Resource Manager Overview
--------------------------
-
-The Cloud Resource Manager API provides methods that you can use
-to programmatically manage your projects in the Google Cloud Platform.
-With this API, you can do the following:
-
-- Get a list of all projects associated with an account
-- Create new projects
-- Update existing projects
-- Delete projects
-- Undelete, or recover, projects that you don't want to delete
-
-.. note::
-
-    Don't forget to look at the :ref:`Authentication` section below.
-    It's slightly different from the rest of this library.
-
-.. warning::
-
-    Alpha
-
-    The `projects.create() API method`_ is in the Alpha stage. It might be changed in
-    backward-incompatible ways and is not recommended for production use. It is
-    not subject to any SLA or deprecation policy. Access to this feature is
-    currently invite-only. For an invitation, contact our sales team at
-    https://cloud.google.com/contact.
-
-.. _projects.create() API method: https://cloud.google.com/resource-manager/docs/creating-project
-
-Here's a quick example of the full life-cycle:
-
-.. code-block:: python
-
-    >>> from google.cloud import resource_manager
-    >>> client = resource_manager.Client()
-
-    >>> # List all projects you have access to
-    >>> for project in client.list_projects():
-    ...     print(project)
-
-    >>> # Create a new project
-    >>> new_project = client.new_project('your-project-id-here',
-    ...                                  name='My new project')
-    >>> new_project.create()
-
-    >>> # Update an existing project
-    >>> project = client.fetch_project('my-existing-project')
-    >>> print(project)
-    <Project: Existing Project (my-existing-project)>
-    >>> project.name = 'Modified name'
-    >>> project.update()
-    >>> print(project)
-    <Project: Modified name (my-existing-project)>
-
-    >>> # Delete a project
-    >>> project = client.new_project('my-existing-project')
-    >>> project.delete()
-
-    >>> # Undelete a project
-    >>> project = client.new_project('my-existing-project')
-    >>> project.undelete()
-
-.. _Authentication:
-
-Authentication
-~~~~~~~~~~~~~~
-
-Unlike the other APIs, the Resource Manager API is focused on managing your
-various projects inside Google Cloud Platform. What this means (currently, as
-of August 2015) is that you can't use a Service Account to work with some
-parts of this API (for example, creating projects).
-
-The reason is actually pretty simple: if your API call is trying to do
-something like create a project, what project's Service Account can you use?
-Currently none.
-
-This means that for this API you should always use the credentials
-provided by the `Google Cloud SDK`_, which you can get by running
-``gcloud auth login``.
-
-.. _Google Cloud SDK: http://cloud.google.com/sdk
-
-Once you run that command, ``google-cloud-python`` will automatically pick up the
-credentials, and you can use the "automatic discovery" feature of the library.
-
-Start by authenticating:
-
-.. code-block:: bash
-
-    $ gcloud auth login
-
-And then simply create a client:
-
-.. code-block:: python
-
-    >>> from google.cloud import resource_manager
-    >>> client = resource_manager.Client()
diff --git a/docs/resource-manager-client.rst b/docs/resource-manager-client.rst
deleted file mode 100644
index 0eb5837f2623..000000000000
--- a/docs/resource-manager-client.rst
+++ /dev/null
@@ -1,17 +0,0 @@
-.. toctree::
-  :maxdepth: 0
-  :hidden:
-
-Client
-------
-
-.. automodule:: google.cloud.resource_manager.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.resource_manager.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/runtimeconfig b/docs/runtimeconfig
new file mode 120000
index 000000000000..4a0a8ad2ddea
--- /dev/null
+++ b/docs/runtimeconfig
@@ -0,0 +1 @@
+../runtimeconfig/docs
\ No newline at end of file
diff --git a/docs/scheduler b/docs/scheduler
new file mode 120000
index 000000000000..767cd9a38af9
--- /dev/null
+++ b/docs/scheduler
@@ -0,0 +1 @@
+../scheduler/docs
\ No newline at end of file
diff --git a/docs/securitycenter b/docs/securitycenter
new file mode 120000
index 000000000000..c17cf5ceaec8
--- /dev/null
+++ b/docs/securitycenter
@@ -0,0 +1 @@
+../securitycenter/docs
\ No newline at end of file
diff --git a/docs/spanner b/docs/spanner
new file mode 120000
index 000000000000..e934485326b2
--- /dev/null
+++ b/docs/spanner
@@ -0,0 +1 @@
+../spanner/docs/
\ No newline at end of file
diff --git a/docs/speech b/docs/speech
new file mode 120000
index 000000000000..828be4c44930
--- /dev/null
+++ b/docs/speech
@@ -0,0 +1 @@
+../speech/docs/
\ No newline at end of file
diff --git a/docs/speech-client.rst b/docs/speech-client.rst
deleted file mode 100644
index 1162e5454a97..000000000000
--- a/docs/speech-client.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-Speech Client
-================
-
-.. automodule:: google.cloud.speech.client
-  :members:
-  :undoc-members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.speech.connection
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/speech-usage.rst b/docs/speech-usage.rst
deleted file mode 100644
index 57e274608b40..000000000000
--- a/docs/speech-usage.rst
+++ /dev/null
@@ -1,55 +0,0 @@
-Using the API
-=============
-
-The `Google Speech`_ API enables developers to convert audio to text.
-The API recognizes over 80 languages and variants, to support your global user base.
-
-.. warning::
-
-   This is a Beta release of Google Speech API. This
-   API is not intended for real-time usage in critical applications.
-
-.. _Google Speech: https://cloud.google.com/speech/docs/getting-started
-
-Client
-------
-
-:class:`~google.cloud.speech.client.Client` objects provide a
-means to configure your application. Each instance holds
-an authenticated connection to the Natural Language service.
-
-For an overview of authentication in ``google-cloud-python``, see
-:doc:`google-cloud-auth`.
-
-Assuming your environment is set up as described in that document,
-create an instance of :class:`~google.cloud.speech.client.Client`.
-
-  .. code-block:: python
-
-     >>> from google.cloud import speech
-     >>> client = speech.Client()
-
-
-Synchronous Recognition
------------------------
-
-The :meth:`~google.cloud.speech.Client.sync_recognize` method converts speech data to text
-and returns alternative text transcriptons.
-
-  .. code-block:: python
-
-     >>> alternatives = client.sync_recognize(
-     ...     None, 'gs://my-bucket/recording.flac',
-     ...     'FLAC', 16000, max_alternatives=2)
-     >>> for alternative in alternatives:
-     ...     print('=' * 20)
-     ...     print('transcript: ' + alternative['transcript'])
-     ...     print('confidence: ' + alternative['confidence'])
-     ====================
-     transcript: Hello, this is a test
-     confidence: 0.81
-     ====================
-     transcript: Hello, this is one test
-     confidence: 0
-
-.. _sync_recognize: https://cloud.google.com/speech/reference/rest/v1beta1/speech/syncrecognize
diff --git a/docs/storage b/docs/storage
new file mode 120000
index 000000000000..de74c3c4f7cf
--- /dev/null
+++ b/docs/storage
@@ -0,0 +1 @@
+../storage/docs/
\ No newline at end of file
diff --git a/docs/storage-blobs.rst b/docs/storage-blobs.rst
deleted file mode 100644
index 18fb773629d6..000000000000
--- a/docs/storage-blobs.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Blobs / Objects
-~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.storage.blob
-  :members:
-  :show-inheritance:
diff --git a/docs/storage-buckets.rst b/docs/storage-buckets.rst
deleted file mode 100644
index e03b1f8b9b56..000000000000
--- a/docs/storage-buckets.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Buckets
-~~~~~~~
-
-.. automodule:: google.cloud.storage.bucket
-  :members:
-  :show-inheritance:
diff --git a/docs/storage-client.rst b/docs/storage-client.rst
deleted file mode 100644
index 9c73e60c0e3e..000000000000
--- a/docs/storage-client.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Storage Client
-==============
-
-.. automodule:: google.cloud.storage.client
-  :members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.storage.connection
-  :members:
-  :show-inheritance:
diff --git a/docs/talent b/docs/talent
new file mode 120000
index 000000000000..90b2d20990c2
--- /dev/null
+++ b/docs/talent
@@ -0,0 +1 @@
+../talent/docs
\ No newline at end of file
diff --git a/docs/tasks b/docs/tasks
new file mode 120000
index 000000000000..5974558b192a
--- /dev/null
+++ b/docs/tasks
@@ -0,0 +1 @@
+../tasks/docs
\ No newline at end of file
diff --git a/docs/texttospeech b/docs/texttospeech
new file mode 120000
index 000000000000..fcb796b9487d
--- /dev/null
+++ b/docs/texttospeech
@@ -0,0 +1 @@
+../texttospeech/docs/
\ No newline at end of file
diff --git a/docs/trace b/docs/trace
new file mode 120000
index 000000000000..a2361d0f9a55
--- /dev/null
+++ b/docs/trace
@@ -0,0 +1 @@
+../trace/docs
\ No newline at end of file
diff --git a/docs/translate b/docs/translate
new file mode 120000
index 000000000000..8ce8fe7bf496
--- /dev/null
+++ b/docs/translate
@@ -0,0 +1 @@
+../translate/docs
\ No newline at end of file
diff --git a/docs/translate-client.rst b/docs/translate-client.rst
deleted file mode 100644
index c724c9f2fe03..000000000000
--- a/docs/translate-client.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-Translate Client
-================
-
-.. automodule:: google.cloud.translate.client
-  :members:
-  :undoc-members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.translate.connection
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/translate-usage.rst b/docs/translate-usage.rst
deleted file mode 100644
index 501a402f9cef..000000000000
--- a/docs/translate-usage.rst
+++ /dev/null
@@ -1,123 +0,0 @@
-Using the API
-=============
-
-With `Google Translate`_, you can dynamically translate text
-between thousands of language pairs. The Google Translate API
-lets websites and programs integrate with Google Translate
-programmatically. Google Translate API is available as a
-paid service. See the `Pricing`_ and `FAQ`_ pages for details.
-
-Authentication / Configuration
-------------------------------
-
-- Use :class:`~google.cloud.translate.client.Client` objects to configure
-  your applications.
-
-- :class:`~google.cloud.translate.client.Client` objects hold both a ``key``
-  and a connection to the Translate service.
-
-- **An API key is required for Translate.** See
-  `Identifying your application to Google`_ for details. This is
-  significantly different than the other clients in ``google-cloud-python``.
-
-Methods
--------
-
-To create a client:
-
-  .. code::
-
-     >>> from google.cloud import translate
-     >>> client = translate.Client('my-api-key')
-
-By default, the client targets English when doing detections
-and translations, but a non-default value can be used as
-well:
-
-  .. code::
-
-     >>> from google.cloud import translate
-     >>> client = translate.Client('my-api-key', target_language='es')
-
-The Google Translate API has three supported methods, and they
-map to three methods on a client:
-:meth:`~google.cloud.translate.client.Client.get_languages`,
-:meth:`~google.cloud.translate.client.Client.detect_language` and
-:meth:`~google.cloud.translate.client.Client.translate`.
-
-To get a list of languages supported by Google Translate
-
-  .. code::
-
-     >>> from google.cloud import translate
-     >>> client = translate.Client('my-api-key')
-     >>> client.get_languages()
-     [
-         {
-             'language': 'af',
-             'name': 'Afrikaans',
-         },
-          ...
-     ]
-
-To detect the language that some given text is written in:
-
-  .. code::
-
-     >>> from google.cloud import translate
-     >>> client = translate.Client('my-api-key')
-     >>> client.detect_language(['Me llamo', 'I am'])
-     [
-         {
-             'confidence': 0.25830904,
-             'input': 'Me llamo',
-             'language': 'es',
-         }, {
-             'confidence': 0.17112699,
-             'input': 'I am',
-             'language': 'en',
-         },
-     ]
-
-The `confidence`_ value is an optional floating point value between 0 and 1.
-The closer this value is to 1, the higher the confidence level for the
-language detection. This member is not always available.
-
-To translate text:
-
-  .. code::
-
-     >>> from google.cloud import translate
-     >>> client = translate.Client('my-api-key')
-     >>> client.translate('koszula')
-     {
-         'translatedText': 'shirt',
-         'detectedSourceLanguage': 'pl',
-         'input': 'koszula',
-     }
-
-or to use a non-default target language:
-
-  .. code::
-
-     >>> from google.cloud import translate
-     >>> client = translate.Client('my-api-key')
-     >>> client.translate(['Me llamo Jeff', 'My name is Jeff'],
-     ...                  target_language='de')
-     [
-         {
-             'translatedText': 'Mein Name ist Jeff',
-             'detectedSourceLanguage': 'es',
-             'input': 'Me llamo Jeff',
-         }, {
-             'translatedText': 'Mein Name ist Jeff',
-             'detectedSourceLanguage': 'en',
-             'input': 'My name is Jeff',
-         },
-     ]
-
-.. _Google Translate: https://cloud.google.com/translate
-.. _Pricing: https://cloud.google.com/translate/v2/pricing.html
-.. _FAQ: https://cloud.google.com/translate/v2/faq.html
-.. _Identifying your application to Google: https://cloud.google.com/translate/v2/using_rest#auth
-.. _confidence: https://cloud.google.com/translate/v2/detecting-language-with-rest
diff --git a/docs/videointelligence b/docs/videointelligence
new file mode 120000
index 000000000000..7f22ebf79f2b
--- /dev/null
+++ b/docs/videointelligence
@@ -0,0 +1 @@
+../videointelligence/docs/
\ No newline at end of file
diff --git a/docs/vision b/docs/vision
new file mode 120000
index 000000000000..bd63572ac784
--- /dev/null
+++ b/docs/vision
@@ -0,0 +1 @@
+../vision/docs
\ No newline at end of file
diff --git a/docs/vision-client.rst b/docs/vision-client.rst
deleted file mode 100644
index f7f9fd259ce4..000000000000
--- a/docs/vision-client.rst
+++ /dev/null
@@ -1,18 +0,0 @@
-Vision Client
-=============
-
-Client
-~~~~~~
-
-.. automodule:: google.cloud.vision.client
-  :members:
-  :undoc-members:
-  :show-inheritance:
-
-Connection
-~~~~~~~~~~
-
-.. automodule:: google.cloud.vision.connection
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-color.rst b/docs/vision-color.rst
deleted file mode 100644
index f2a9a53f1d8a..000000000000
--- a/docs/vision-color.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Vision Image Properties
-=======================
-
-Image Properties Annotation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.vision.color
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-entity.rst b/docs/vision-entity.rst
deleted file mode 100644
index 7c5145f54d7d..000000000000
--- a/docs/vision-entity.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Vision Entity
-=============
-
-Entity
-~~~~~~
-
-.. automodule:: google.cloud.vision.entity
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-face.rst b/docs/vision-face.rst
deleted file mode 100644
index 56f541399132..000000000000
--- a/docs/vision-face.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Vision Face
-===========
-
-Face
-~~~~
-
-.. automodule:: google.cloud.vision.face
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-feature.rst b/docs/vision-feature.rst
deleted file mode 100644
index 325b0caad717..000000000000
--- a/docs/vision-feature.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Vision Feature
-==============
-
-Feature
-~~~~~~~
-
-.. automodule:: google.cloud.vision.feature
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-image.rst b/docs/vision-image.rst
deleted file mode 100644
index 491097c3ff31..000000000000
--- a/docs/vision-image.rst
+++ /dev/null
@@ -1,26 +0,0 @@
-Vision Image
-============
-
-Image
-~~~~~
-
-.. automodule:: google.cloud.vision.image
-  :members:
-  :undoc-members:
-  :show-inheritance:
-
-Geometry
-~~~~~~~~
-
-.. automodule:: google.cloud.vision.geometry
-  :members:
-  :undoc-members:
-  :show-inheritance:
-
-Likelihood
-~~~~~~~~~~
-
-.. automodule:: google.cloud.vision.likelihood
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-safe-search.rst b/docs/vision-safe-search.rst
deleted file mode 100644
index f86f675c21ba..000000000000
--- a/docs/vision-safe-search.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-Vision Safe Search
-==================
-
-Safe Search Annotation
-~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: google.cloud.vision.safe
-  :members:
-  :undoc-members:
-  :show-inheritance:
diff --git a/docs/vision-usage.rst b/docs/vision-usage.rst
deleted file mode 100644
index 1c0b5dc01f29..000000000000
--- a/docs/vision-usage.rst
+++ /dev/null
@@ -1,238 +0,0 @@
-Using the Vision API
-====================
-
-Authentication and Configuration
---------------------------------
-
-- For an overview of authentication in ``google-cloud-python``,
-  see :doc:`google-cloud-auth`.
-
-- In addition to any authentication configuration, you should also set the
-  :envvar:`GOOGLE_CLOUD_PROJECT` environment variable for the project you'd like
-  to interact with. If the GOOGLE_CLOUD_PROJECT environment variable is not present,
-  the project ID from JSON file credentials is used.
-
-  If you are using Google App Engine or Google Compute Engine
-  this will be detected automatically.
-
-- After configuring your environment, create a
-  :class:`Client <google.cloud.vision.client.Client>`
-
-.. code-block:: python
-
-     >>> from google.cloud import vision
-     >>> client = vision.Client()
-
-or pass in ``credentials`` and ``project`` explicitly
-
-.. code-block:: python
-
-     >>> from google.cloud import vision
-     >>> client = vision.Client(project='my-project', credentials=creds)
-
-Annotating an Image
--------------------
-
-Annotate a single image
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    >>> import io
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> with io.open('./image.png', 'rb') as image_file:
-    ...     image = client.image(content=image_file.read())
-    >>> faces = image.detect_faces(limit=10)
-    >>> faces[0].landmarks.left_eye.position.x_coordinate
-    ... 1004.8003
-
-Annotate multiple images
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    >>> import io
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> with io.open('./image.png', 'rb') as image_file:
-    ...     image_one = client.image(content=image_file.read())
-    >>> image_two = client.image(source_uri='gs://my-storage-bucket/image.jpg')
-    >>> with client.batch():
-    ...     labels = image_one.detect_labels()
-    ...     faces = image_two.detect_faces(limit=10)
-
-No results returned
-~~~~~~~~~~~~~~~~~~~
-
-Failing annotations return no results for the feature type requested.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image(source_uri='gs://my-storage-bucket/image.jpg')
-    >>> logos = image.detect_logos(limit=10)
-    >>> logos
-    []
-
-
-Manual Detection
-~~~~~~~~~~~~~~~~
-
-You can call the detection method manually.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> from google.cloud.vision.image import Feature
-    >>> from google.cloud.vision.image import FeatureTypes
-    >>> client = vision.Client()
-    >>> image = client.image(source_uri='gs://my-test-bucket/image.jpg')
-    >>> features = [Feature(FeatureTypes.FACE_DETECTION, 5),
-    ...             Feature(FeatureTypes.LOGO_DETECTION, 3)]
-    >>> annotations = image.detect(features)
-
-Face Detection
-~~~~~~~~~~~~~~
-
-Detecting a face or faces in an image.
-For a list of the possible facial landmarks
-see: https://cloud.google.com/vision/reference/rest/v1/images/annotate#type_1
-
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image(source_uri='gs://my-test-bucket/image.jpg')
-    >>> faces = image.detect_faces(limit=10)
-    >>> faces[0].landmarks.left_eye.landmark_type
-    'LEFT_EYE'
-    >>> faces[0].landmarks.left_eye.position.x_coordinate
-    1301.2404
-    >>> faces[0].detection_confidence
-    0.9863683
-    >>> faces[0].joy_likelihood
-    0.54453093
-    >>> faces[0].anger_likelihood
-    0.02545464
-
-
-
-Label Detection
-~~~~~~~~~~~~~~~
-
-Image labels are a way to help categorize the contents of an image.
-If you have an image with a car, person and a dog it, label detection will
-attempt to identify those objects.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image(source_uri='gs://my-storage-bucket/image.jpg')
-    >>> labels = image.detect_labels(limit=3)
-    >>> labels[0].description
-    'automobile'
-    >>> labels[0].score
-    0.9863683
-
-
-Landmark Detection
-~~~~~~~~~~~~~~~~~~
-
-The API will attemtp to detect landmarks such as Mount Rushmore and
-the Sydney Opera House. The API will also provide their known geographical
-locations if available.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image('./image.jpg')
-    >>> landmarks = image.detect_landmarks()
-    >>> landmarks[0].description
-    'Sydney Opera House'
-    >>> landmarks[0].locations[0].latitude
-    -33.857123
-    >>> landmarks[0].locations[0].longitude
-    151.213921
-    >>> landmarks[0].bounding_poly.vertices[0].x_coordinate
-    78
-    >>> landmarks[0].bounding_poly.vertices[0].y_coordinate
-    162
-
-Logo Detection
-~~~~~~~~~~~~~~
-
-Google Vision can also attempt to detect company and brand logos in images.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image('./image.jpg')
-    >>> logos = image.detect_logos(limit=1)
-    >>> results.logos[0].description
-    'Google'
-    >>> logos[0].score
-    0.9795432
-    >>> logos[0].bounding_poly.vertices[0].x_coordinate
-    78
-    >>> logos[0].bounding_poly.vertices[0].y_coordinate
-    62
-
-Safe Search Detection
-~~~~~~~~~~~~~~~~~~~~~
-
-Detecting safe search properties of an image.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image('./image.jpg')
-    >>> safe_search = image.detect_safe_search()
-    >>> safe_search.adult
-    'VERY_UNLIKELY'
-    >>> safe_search.medical
-    'UNLIKELY'
-
-Text Detection
-~~~~~~~~~~~~~~
-
-Detecting text with ORC from an image.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image('./image.jpg')
-    >>> texts = image.detect_text()
-    >>> texts[0].locale
-    'en'
-    >>> texts[0].description
-    'some text in the image'
-    >>> texts[1].description
-    'some other text in the image'
-
-Image Properties
-~~~~~~~~~~~~~~~~
-
-Detecting image color properties.
-
-.. code-block:: python
-
-    >>> from google.cloud import vision
-    >>> client = vision.Client()
-    >>> image = client.image('./image.jpg')
-    >>> colors = image.detect_properties()
-    >>> colors[0].red
-    244
-    >>> colors[0].blue
-    134
-    >>> colors[0].score
-    0.65519291
-    >>> colors[0].pixel_fraction
-    0.758658
diff --git a/docs/webrisk b/docs/webrisk
new file mode 120000
index 000000000000..6b09785486bf
--- /dev/null
+++ b/docs/webrisk
@@ -0,0 +1 @@
+../webrisk/docs
\ No newline at end of file
diff --git a/docs/websecurityscanner b/docs/websecurityscanner
new file mode 120000
index 000000000000..a0bc42093b44
--- /dev/null
+++ b/docs/websecurityscanner
@@ -0,0 +1 @@
+../websecurityscanner/docs/
\ No newline at end of file
diff --git a/error_reporting/.coveragerc b/error_reporting/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/error_reporting/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/error_reporting/.flake8 b/error_reporting/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/error_reporting/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/error_reporting/.repo-metadata.json b/error_reporting/.repo-metadata.json
new file mode 100644
index 000000000000..291301df028c
--- /dev/null
+++ b/error_reporting/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "clouderrorreporting",
+  "name_pretty": "Stackdriver Error Reporting",
+  "product_documentation": "https://cloud.google.com/error-reporting",
+  "client_documentation": "https://googleapis.dev/python/clouderrorreporting/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559780",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-error-reporting",
+  "api_id": "clouderrorreporting.googleapis.com",
+  "requires_billing": false
+}
\ No newline at end of file
diff --git a/error_reporting/CHANGELOG.md b/error_reporting/CHANGELOG.md
new file mode 100644
index 000000000000..81c20812af9f
--- /dev/null
+++ b/error_reporting/CHANGELOG.md
@@ -0,0 +1,145 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-error-reporting/#history
+
+## 0.32.1
+
+08-23-2019 10:12 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8954](https://github.com/googleapis/google-cloud-python/pull/8954))
+
+### Documentation
+- Fix documentation links for iam and error-reporting. ([#9073](https://github.com/googleapis/google-cloud-python/pull/9073))
+- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.32.0
+
+07-24-2019 16:17 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8389](https://github.com/googleapis/google-cloud-python/pull/8389))
+- Fix typo in non-gRPC import. ([#8028](https://github.com/googleapis/google-cloud-python/pull/8028))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8508](https://github.com/googleapis/google-cloud-python/pull/8508))
+
+### Documentation
+- Fix docs navigation issues. ([#8723](https://github.com/googleapis/google-cloud-python/pull/8723))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fix mistake in documentation ([#8271](https://github.com/googleapis/google-cloud-python/pull/8271))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8582](https://github.com/googleapis/google-cloud-python/pull/8582))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8351](https://github.com/googleapis/google-cloud-python/pull/8351))
+- Add disclaimer to auto-generated template files (via synth). ([#8313](https://github.com/googleapis/google-cloud-python/pull/8313))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8240](https://github.com/googleapis/google-cloud-python/pull/8240))
+- Blacken noxfile.py, setup.py (via synth). ([#8122](https://github.com/googleapis/google-cloud-python/pull/8122))
+- Add empty lines (via synth). ([#8057](https://github.com/googleapis/google-cloud-python/pull/8057))
+
+## 0.31.0
+
+05-17-2019 08:23 PDT
+
+### Implementation Changes
+- Add routing header to method metadata (via synth). ([#7594](https://github.com/googleapis/google-cloud-python/pull/7594))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to Client. ([#7903](https://github.com/googleapis/google-cloud-python/pull/7903))
+
+### Dependencies
+- Pin `google-cloud-logging >= 1.11.0`. ([#8015](https://github.com/googleapis/google-cloud-python/pull/8015))
+
+### Documentation
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+- Add nox session `docs` (via synth). ([#7770](https://github.com/googleapis/google-cloud-python/pull/7770))
+- Fix docstring replace in synth ([#7458](https://github.com/googleapis/google-cloud-python/pull/7458))
+- Copy lintified proto files (via synth). ([#7447](https://github.com/googleapis/google-cloud-python/pull/7447))
+- Add clarifying comment to blacken nox target (via synth). ([#7391](https://github.com/googleapis/google-cloud-python/pull/7391))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers. ([#7144](https://github.com/googleapis/google-cloud-python/pull/7144))
+- Protoc-generated serialization update. ([#7082](https://github.com/googleapis/google-cloud-python/pull/7082))
+- Pick up stub docstring fix in GAPIC generator. ([#6970](https://github.com/googleapis/google-cloud-python/pull/6970))
+- Fix formatting ([#7002](https://github.com/googleapis/google-cloud-python/pull/7002))
+
+## 0.30.1
+
+12-17-2018 18:17 PST
+
+
+### Implementation Changes
+- Pick up fixes to GAPIC generator. ([#6522](https://github.com/googleapis/google-cloud-python/pull/6522))
+- Fix `client_info` bug, update docstrings via synth. ([#6442](https://github.com/googleapis/google-cloud-python/pull/6442))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Fix [#6321](https://github.com/googleapis/google-cloud-python/pull/6321) Update README service links in quickstart guides. ([#6322](https://github.com/googleapis/google-cloud-python/pull/6322))
+- Prep docs for repo split. ([#6155](https://github.com/googleapis/google-cloud-python/pull/6155))
+- Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6566](https://github.com/googleapis/google-cloud-python/pull/6566))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add 'synth.py'. ([#6082](https://github.com/googleapis/google-cloud-python/pull/6082))
+- Use Nox inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+
+## 0.30.0
+
+### Implementation Changes
+- Make dependency on logging less restrictive in error_reporting (#5345)
+
+### Internal / Testing Changes
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Fix bad trove classifier
+
+## 0.29.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+- Fix missing extra in api-core dependency (#4764)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+
+## 0.29.0
+
+### Breaking changes
+
+- The underlying autogenerated client library was re-generated to pick up new 
+  features and resolve bugs, this may change the exceptions raised from various
+  methods. (#4695)
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Upgrading to `google-cloud-logging >= 1.4.0` (#4296)
+
+PyPI: https://pypi.org/project/google-cloud-error-reporting/0.28.0/
diff --git a/error_reporting/LICENSE b/error_reporting/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/error_reporting/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/error_reporting/MANIFEST.in b/error_reporting/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/error_reporting/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/error_reporting/README.rst b/error_reporting/README.rst
new file mode 100644
index 000000000000..39561dd92cb3
--- /dev/null
+++ b/error_reporting/README.rst
@@ -0,0 +1,91 @@
+Python Client for Stackdriver Error Reporting
+=============================================
+
+|pypi| |versions| 
+
+The Stackdriver `Error Reporting`_ API counts, analyzes and aggregates the
+crashes in your running cloud services.  A centralized error management
+interface displays the results with sorting and filtering capabilities. A
+dedicated view shows the error details: time chart, occurrences, affected user
+count, first and last seen dates and a cleaned exception stack trace. Opt-in
+to receive email and mobile alerts on new errors.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Error Reporting: https://cloud.google.com/error-reporting/
+.. _Client Library Documentation: https://googleapis.dev/python/clouderrorreporting/latest
+.. _Product Documentation: https://cloud.google.com/error-reporting/reference/
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-error-reporting.svg
+   :target: https://pypi.org/project/google-cloud-error-reporting/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-error-reporting.svg
+   :target: https://pypi.org/project/google-cloud-error-reporting/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Error Reporting API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Error Reporting API.:  https://cloud.google.com/error-reporting
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-error-reporting
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-error-reporting
+
+
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Datastore API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/error_reporting/docs/README.rst b/error_reporting/docs/README.rst
new file mode 120000
index 000000000000..38473f99d57f
--- /dev/null
+++ b/error_reporting/docs/README.rst
@@ -0,0 +1 @@
+../../error_reporting/README.rst
\ No newline at end of file
diff --git a/error_reporting/docs/changelog.md b/error_reporting/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/error_reporting/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/error_reporting/docs/client.rst b/error_reporting/docs/client.rst
new file mode 100644
index 000000000000..93fcff3bf071
--- /dev/null
+++ b/error_reporting/docs/client.rst
@@ -0,0 +1,6 @@
+Error Reporting Client
+=======================
+
+.. automodule:: google.cloud.error_reporting.client
+  :members:
+  :show-inheritance:
diff --git a/error_reporting/docs/conf.py b/error_reporting/docs/conf.py
new file mode 100644
index 000000000000..97c5250b84c8
--- /dev/null
+++ b/error_reporting/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-error-reporting documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-error-reporting"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-error-reporting-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-error-reporting.tex",
+        u"google-cloud-error-reporting Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-error-reporting",
+        u"google-cloud-error-reporting Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-error-reporting",
+        u"google-cloud-error-reporting Documentation",
+        author,
+        "google-cloud-error-reporting",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/error_reporting/docs/gapic/v1beta1/api.rst b/error_reporting/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..37ead7d3d055
--- /dev/null
+++ b/error_reporting/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Stackdriver Error Reporting API
+==========================================
+
+.. automodule:: google.cloud.errorreporting_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/error_reporting/docs/gapic/v1beta1/types.rst b/error_reporting/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..989f48a7d15e
--- /dev/null
+++ b/error_reporting/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Stackdriver Error Reporting API Client
+================================================
+
+.. automodule:: google.cloud.errorreporting_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/error_reporting/docs/index.rst b/error_reporting/docs/index.rst
new file mode 100644
index 000000000000..3fd35c32a475
--- /dev/null
+++ b/error_reporting/docs/index.rst
@@ -0,0 +1,32 @@
+.. include:: README.rst
+
+Usage Documentation
+-------------------
+
+.. toctree::
+   :maxdepth: 2
+
+   usage
+   
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+
+   client
+   util
+   gapic/v1beta1/api
+   gapic/v1beta1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-error-reporting`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/error_reporting/docs/usage.rst b/error_reporting/docs/usage.rst
new file mode 100644
index 000000000000..4e971d368f52
--- /dev/null
+++ b/error_reporting/docs/usage.rst
@@ -0,0 +1,115 @@
+Using Stackdriver Error Reporting
+=================================
+
+After configuring your environment, create a
+:class:`Client <google.cloud.error_reporting.client.Client>`
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client()
+
+or pass in ``credentials`` and ``project`` explicitly
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client(project='my-project', credentials=creds)
+
+Error Reporting associates errors with a service, which is an identifier for
+an executable, App Engine service, or job. The default service is "python",
+but a default can be specified for the client on construction time. You can
+also optionally specify a version for that service, which defaults to
+"default."
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client(
+    project='my-project', service="login_service", version="0.1.0")
+
+
+Reporting an exception
+-----------------------
+
+Report a stacktrace to Stackdriver Error Reporting after an exception:
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client()
+   try:
+       raise NameError
+   except Exception:
+       client.report_exception()
+
+
+By default, the client will report the error using the service specified in
+the client's constructor, or the default service of "python".
+
+The user and HTTP context can also be included in the exception. The HTTP
+context can be constructed using
+:class:`google.cloud.error_reporting.HTTPContext`. This will be used by
+Stackdriver Error Reporting to help group exceptions.
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client()
+   user = 'example@gmail.com'
+   http_context = error_reporting.HTTPContext(
+       method='GET', url='/', user_agent='test agent',
+       referrer='example.com', response_status_code=500,
+       remote_ip='1.2.3.4')
+   try:
+       raise NameError
+   except Exception:
+       client.report_exception(http_context=http_context, user=user))
+
+An automatic helper to build the HTTP Context from a Flask (Werkzeug) request
+object is provided.
+
+.. code-block:: python
+
+   from google.cloud.error_reporting import build_flask_context
+
+   @app.errorhandler(HTTPException)
+   def handle_error(exc):
+       client.report_exception(
+           http_context=build_flask_context(request))
+       # rest of error response code here
+
+
+Reporting an error without an exception
+-----------------------------------------
+
+Errors can also be reported to Stackdriver Error Reporting outside the context
+of an exception.  The library will include the file path, function name, and
+line number of the location where the error was reported.
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client()
+   client.report("Found an error!")
+
+As with reporting an exception, the user and HTTP context can be provided:
+
+.. code-block:: python
+
+   from google.cloud import error_reporting
+
+   client = error_reporting.Client()
+   user = 'example@gmail.com'
+   http_context = error_reporting.HTTPContext(
+       method='GET', url='/', user_agent='test agent',
+       referrer='example.com', response_status_code=500,
+       remote_ip='1.2.3.4')
+   client.report(
+       "Found an error!", http_context=http_context, user=user))
diff --git a/error_reporting/docs/util.rst b/error_reporting/docs/util.rst
new file mode 100644
index 000000000000..9bc8aad51367
--- /dev/null
+++ b/error_reporting/docs/util.rst
@@ -0,0 +1,6 @@
+Error Reporting Utilities
+=========================
+
+.. automodule:: google.cloud.error_reporting.util
+  :members:
+  :show-inheritance:
diff --git a/error_reporting/google/__init__.py b/error_reporting/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/error_reporting/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/error_reporting/google/cloud/__init__.py b/error_reporting/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/error_reporting/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/error_reporting/google/cloud/error_reporting/__init__.py b/error_reporting/google/cloud/error_reporting/__init__.py
new file mode 100644
index 000000000000..9443b99e3d24
--- /dev/null
+++ b/error_reporting/google/cloud/error_reporting/__init__.py
@@ -0,0 +1,26 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client library for Stackdriver Error Reporting"""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-error-reporting").version
+
+from google.cloud.error_reporting.client import Client
+from google.cloud.error_reporting.client import HTTPContext
+from google.cloud.error_reporting.util import build_flask_context
+
+__all__ = ["__version__", "Client", "HTTPContext", "build_flask_context"]
diff --git a/error_reporting/google/cloud/error_reporting/_gapic.py b/error_reporting/google/cloud/error_reporting/_gapic.py
new file mode 100644
index 000000000000..b1925ff6a491
--- /dev/null
+++ b/error_reporting/google/cloud/error_reporting/_gapic.py
@@ -0,0 +1,66 @@
+# Copyright 2016 Google LLC 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.
+
+"""GAX wrapper for Error Reporting API requests."""
+
+from google.cloud.errorreporting_v1beta1.gapic import report_errors_service_client
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2
+from google.protobuf.json_format import ParseDict
+
+
+def make_report_error_api(client):
+    """Create an instance of the gapic Logging API.
+
+    :type client::class:`google.cloud.error_reporting.Client`
+    :param client: Error Reporting client.
+
+    :rtype: :class:_ErrorReportingGapicApi
+    :returns: An Error Reporting API instance.
+    """
+    gapic_api = report_errors_service_client.ReportErrorsServiceClient(
+        credentials=client._credentials, client_info=client._client_info
+    )
+    return _ErrorReportingGapicApi(gapic_api, client.project)
+
+
+class _ErrorReportingGapicApi(object):
+    """Helper mapping Error Reporting-related APIs
+
+    :type gapic:
+        :class:`report_errors_service_client.ReportErrorsServiceClient`
+    :param gapic: API object used to make RPCs.
+
+    :type project: str
+    :param project: Google Cloud Project ID
+    """
+
+    def __init__(self, gapic_api, project):
+        self._gapic_api = gapic_api
+        self._project = project
+
+    def report_error_event(self, error_report):
+        """Uses the gapic client to report the error.
+
+        :type error_report: dict
+        :param error_report:
+            payload of the error report formatted according to
+            https://cloud.google.com/error-reporting/docs/formatting-error-messages
+            This object should be built using
+            Use
+            :meth:~`google.cloud.error_reporting.client._build_error_report`
+        """
+        project_name = self._gapic_api.project_path(self._project)
+        error_report_payload = report_errors_service_pb2.ReportedErrorEvent()
+        ParseDict(error_report, error_report_payload)
+        self._gapic_api.report_error_event(project_name, error_report_payload)
diff --git a/error_reporting/google/cloud/error_reporting/_logging.py b/error_reporting/google/cloud/error_reporting/_logging.py
new file mode 100644
index 000000000000..5eaa4693c96f
--- /dev/null
+++ b/error_reporting/google/cloud/error_reporting/_logging.py
@@ -0,0 +1,75 @@
+# Copyright 2016 Google LLC 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.
+
+"""Interact with Stackdriver Error Reporting via Logging API.
+
+It's possible to report Stackdriver Error Reporting errors by formatting
+structured log messages in Stackdriver Logging in a given format. This
+client provides a mechanism to report errors using that technique.
+"""
+
+import google.cloud.logging.client
+
+
+class _ErrorReportingLoggingAPI(object):
+    """Report to Stackdriver Error Reporting via Logging API
+
+    :type project: str
+    :param project: the project which the client acts on behalf of. If not
+                    passed falls back to the default inferred from the
+                    environment.
+
+    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
+                       :class:`NoneType`
+    :param credentials: The OAuth2 Credentials to use for the connection
+                        owned by this client. If not passed (and if no
+                        ``_http`` object is passed), falls back to the default
+                        inferred from the environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type client_info:
+        :class:`google.api_core.client_info.ClientInfo` or
+        :class:`google.api_core.gapic_v1.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    """
+
+    def __init__(self, project, credentials=None, _http=None, client_info=None):
+        self.logging_client = google.cloud.logging.client.Client(
+            project, credentials, _http=_http, client_info=client_info
+        )
+
+    def report_error_event(self, error_report):
+        """Report error payload.
+
+        :type error_report: dict
+        :param: error_report:
+            dict payload of the error report formatted according to
+            https://cloud.google.com/error-reporting/docs/formatting-error-messages
+            This object should be built using
+            :meth:~`google.cloud.error_reporting.client._build_error_report`
+        """
+        logger = self.logging_client.logger("errors")
+        logger.log_struct(error_report)
diff --git a/error_reporting/google/cloud/error_reporting/client.py b/error_reporting/google/cloud/error_reporting/client.py
new file mode 100644
index 000000000000..4fdae4c69e25
--- /dev/null
+++ b/error_reporting/google/cloud/error_reporting/client.py
@@ -0,0 +1,379 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Stackdriver Error Reporting API"""
+
+import os
+import traceback
+
+import six
+
+try:
+    from google.cloud.error_reporting._gapic import make_report_error_api
+except ImportError:  # pragma: NO COVER
+    from google.api_core import client_info  # noqa
+
+    _HAVE_GRPC = False
+else:
+    from google.api_core.gapic_v1 import client_info
+
+    _HAVE_GRPC = True
+
+from google.cloud.client import ClientWithProject
+from google.cloud.error_reporting import __version__
+from google.cloud.error_reporting._logging import _ErrorReportingLoggingAPI
+from google.cloud.environment_vars import DISABLE_GRPC
+
+_DISABLE_GRPC = os.getenv(DISABLE_GRPC, False)
+_USE_GRPC = _HAVE_GRPC and not _DISABLE_GRPC
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+
+
+class HTTPContext(object):
+    """HTTPContext defines an object that captures the parameter for the
+    httpRequest part of Error Reporting API
+
+    :type method: str
+    :param method: The type of HTTP request, such as GET, POST, etc.
+
+    :type url: str
+    :param url: The URL of the request
+
+    :type user_agent: str
+    :param user_agent: The user agent information that is provided with the
+                       request.
+
+    :type referrer: str
+    :param referrer: The referrer information that is provided with the
+                     request.
+
+    :type response_status_code: int
+    :param response_status_code: The HTTP response status code for the request.
+
+    :type remote_ip: str
+    :param remote_ip: The IP address from which the request originated. This
+                      can be IPv4, IPv6, or a token which is derived from
+                      the IP address, depending on the data that has been
+                      provided in the error report.
+    """
+
+    def __init__(
+        self,
+        method=None,
+        url=None,
+        user_agent=None,
+        referrer=None,
+        response_status_code=None,
+        remote_ip=None,
+    ):
+        self.method = method
+        self.url = url
+        # intentionally camel case for mapping to JSON API expects
+        # pylint: disable=invalid-name
+        self.userAgent = user_agent
+        self.referrer = referrer
+        self.responseStatusCode = response_status_code
+        self.remoteIp = remote_ip
+
+
+class Client(ClientWithProject):
+    """Error Reporting client. Currently Error Reporting is done by creating
+    a Logging client.
+
+    :type project: str
+    :param project: the project which the client acts on behalf of. If not
+                    passed falls back to the default inferred from the
+                    environment.
+
+    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
+                       :class:`NoneType`
+    :param credentials: The OAuth2 Credentials to use for the connection
+                        owned by this client. If not passed (and if no
+                        ``_http`` object is passed), falls back to the default
+                        inferred from the environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type service: str
+    :param service: An identifier of the service, such as the name of the
+                    executable, job, or Google App Engine service name. This
+                    field is expected to have a low number of values that are
+                    relatively stable over time, as opposed to version,
+                    which can be changed whenever new code is deployed.
+
+
+    :type version: str
+    :param version: Represents the source code version that the developer
+                    provided, which could represent a version label or a Git
+                    SHA-1 hash, for example. If the developer did not provide
+                    a version, the value is set to default.
+
+    :type _use_grpc: bool
+    :param _use_grpc: (Optional) Explicitly specifies whether
+                      to use the gRPC transport or HTTP. If unset,
+                      falls back to the ``GOOGLE_CLOUD_DISABLE_GRPC``
+                      environment variable.
+                      This parameter should be considered private, and could
+                      change in the future.
+
+    :type client_info:
+        :class:`google.api_core.client_info.ClientInfo` or
+        :class:`google.api_core.gapic_v1.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+
+    :raises: :class:`ValueError` if the project is neither passed in nor
+             set in the environment.
+    """
+
+    SCOPE = ("https://www.googleapis.com/auth/cloud-platform",)
+    """The scopes required for authenticating as an API consumer."""
+
+    def __init__(
+        self,
+        project=None,
+        credentials=None,
+        _http=None,
+        service=None,
+        version=None,
+        client_info=_CLIENT_INFO,
+        _use_grpc=None,
+    ):
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+        self._report_errors_api = None
+
+        self.service = service if service else self.DEFAULT_SERVICE
+        self.version = version
+        self._client_info = client_info
+
+        if _use_grpc is None:
+            self._use_grpc = _USE_GRPC
+        else:
+            self._use_grpc = _use_grpc
+
+    DEFAULT_SERVICE = "python"
+
+    @property
+    def report_errors_api(self):
+        """Helper for logging-related API calls.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs
+
+        :rtype:
+            :class:`_gapic._ErrorReportingGapicApi`
+            or
+            :class:`._logging._ErrorReportingLoggingAPI`
+        :returns: A class that implements the report errors API.
+        """
+        if self._report_errors_api is None:
+            if self._use_grpc:
+                self._report_errors_api = make_report_error_api(self)
+            else:
+                self._report_errors_api = _ErrorReportingLoggingAPI(
+                    self.project, self._credentials, self._http, self._client_info
+                )
+        return self._report_errors_api
+
+    def _build_error_report(
+        self, message, report_location=None, http_context=None, user=None
+    ):
+        """Builds the Error Reporting object to report.
+
+        This builds the object according to
+
+        https://cloud.google.com/error-reporting/docs/formatting-error-messages
+
+        :type message: str
+        :param message: The stack trace that was reported or logged by the
+                   service.
+
+        :type report_location: dict
+        :param report_location:  The location in the source code where the
+               decision was made to 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 should be a Python dict that contains the keys 'filePath',
+               'lineNumber', and 'functionName'
+
+        :type http_context: :class`google.cloud.error_reporting.HTTPContext`
+        :param http_context: The HTTP request which was processed when the
+                             error was triggered.
+
+        :type user: str
+        :param user: The user who caused or was affected by the crash. This can
+                     be a user ID, an email address, or an arbitrary token that
+                     uniquely identifies the user. When sending an error
+                     report, leave this field empty if the user was not
+                     logged in. In this  case the Error Reporting system will
+                     use other data, such as remote IP address,
+                     to distinguish affected users.
+        :rtype: dict
+        :returns: A dict payload ready to be serialized to JSON and sent to
+                  the API.
+         """
+        payload = {
+            "serviceContext": {"service": self.service},
+            "message": "{0}".format(message),
+        }
+
+        if self.version:
+            payload["serviceContext"]["version"] = self.version
+
+        if report_location or http_context or user:
+            payload["context"] = {}
+
+        if report_location:
+            payload["context"]["reportLocation"] = report_location
+
+        if http_context:
+            http_context_dict = http_context.__dict__
+            # strip out None values
+            payload["context"]["httpRequest"] = {
+                key: value
+                for key, value in six.iteritems(http_context_dict)
+                if value is not None
+            }
+        if user:
+            payload["context"]["user"] = user
+        return payload
+
+    def _send_error_report(
+        self, message, report_location=None, http_context=None, user=None
+    ):
+        """Makes the call to the Error Reporting API.
+
+        This is the lower-level interface to build and send the payload,
+        generally users will use either report() or report_exception() to
+        automatically gather the parameters for this method.
+
+        :type message: str
+        :param message: The stack trace that was reported or logged by the
+                   service.
+
+        :type report_location: dict
+        :param report_location:  The location in the source code where the
+               decision was made to 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 should be a Python dict that contains the keys 'filePath',
+               'lineNumber', and 'functionName'
+
+        :type http_context: :class`google.cloud.error_reporting.HTTPContext`
+        :param http_context: The HTTP request which was processed when the
+                             error was triggered.
+
+        :type user: str
+        :param user: The user who caused or was affected by the crash. This can
+                     be a user ID, an email address, or an arbitrary token that
+                     uniquely identifies the user. When sending an error
+                     report, leave this field empty if the user was not
+                     logged in. In this  case the Error Reporting system will
+                     use other data, such as remote IP address,
+                     to distinguish affected users.
+        """
+        error_report = self._build_error_report(
+            message, report_location, http_context, user
+        )
+        self.report_errors_api.report_error_event(error_report)
+
+    def report(self, message, http_context=None, user=None):
+        """ Reports a message to Stackdriver Error Reporting
+
+        https://cloud.google.com/error-reporting/docs/formatting-error-messages
+
+        :type message: str
+        :param message: A user-supplied message to report
+
+        :type http_context: :class`google.cloud.error_reporting.HTTPContext`
+        :param http_context: The HTTP request which was processed when the
+                             error was triggered.
+
+        :type user: str
+        :param user: The user who caused or was affected by the crash. This
+                     can be a user ID, an email address, or an arbitrary
+                     token that uniquely identifies the user. When sending
+                     an error report, leave this field empty if the user
+                     was not logged in. In this case the Error Reporting
+                     system will use other data, such as remote IP address,
+                     to distinguish affected users.
+
+        Example:
+
+        .. code-block:: python
+
+          >>>  client.report("Something went wrong!")
+        """
+        stack = traceback.extract_stack()
+        last_call = stack[-2]
+        file_path = last_call[0]
+        line_number = last_call[1]
+        function_name = last_call[2]
+        report_location = {
+            "filePath": file_path,
+            "lineNumber": line_number,
+            "functionName": function_name,
+        }
+
+        self._send_error_report(
+            message,
+            http_context=http_context,
+            user=user,
+            report_location=report_location,
+        )
+
+    def report_exception(self, http_context=None, user=None):
+        """ Reports the details of the latest exceptions to Stackdriver Error
+            Reporting.
+
+          :type http_context: :class`google.cloud.error_reporting.HTTPContext`
+          :param http_context: The HTTP request which was processed when the
+                               error was triggered.
+
+          :type user: str
+          :param user: The user who caused or was affected by the crash. This
+                       can be a user ID, an email address, or an arbitrary
+                       token that uniquely identifies the user. When sending an
+                       error report, leave this field empty if the user was
+                       not logged in. In this case the Error Reporting system
+                       will use other data, such as remote IP address,
+                       to distinguish affected users.
+
+           Example::
+
+                >>>     try:
+                >>>         raise NameError
+                >>>     except Exception:
+                >>>         client.report_exception()
+        """
+        self._send_error_report(
+            traceback.format_exc(), http_context=http_context, user=user
+        )
diff --git a/error_reporting/google/cloud/error_reporting/util.py b/error_reporting/google/cloud/error_reporting/util.py
new file mode 100644
index 000000000000..151540cdb855
--- /dev/null
+++ b/error_reporting/google/cloud/error_reporting/util.py
@@ -0,0 +1,47 @@
+# Copyright 2016 Google LLC 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.
+
+"""Utility functions for Stackdriver Error Reporting."""
+
+from google.cloud.error_reporting.client import HTTPContext
+
+
+def build_flask_context(request):
+    """Builds an HTTP context object from a Flask (Werkzeug) request object.
+
+     This helper method extracts the relevant HTTP context from a Flask request
+     object into an object ready to be sent to Error Reporting.
+
+    .. code-block:: python
+
+        >>> @app.errorhandler(HTTPException)
+        ... def handle_error(exc):
+        ...     client.report_exception(
+        ...         http_context=build_flask_context(request))
+        ...     # rest of error response code here
+
+    :type request: :class:`werkzeug.wrappers.request`
+    :param request: The Flask request object to convert.
+
+    :rtype: :class:`~google.cloud.error_reporting.client.HTTPContext`
+    :returns: An HTTPContext object ready to be sent to the Stackdriver Error
+              Reporting API.
+    """
+    return HTTPContext(
+        url=request.url,
+        method=request.method,
+        user_agent=request.user_agent.string,
+        referrer=request.referrer,
+        remote_ip=request.remote_addr,
+    )
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/__init__.py b/error_reporting/google/cloud/errorreporting_v1beta1/__init__.py
new file mode 100644
index 000000000000..9553e4a4738c
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/__init__.py
@@ -0,0 +1,45 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.errorreporting_v1beta1 import types
+from google.cloud.errorreporting_v1beta1.gapic import enums
+from google.cloud.errorreporting_v1beta1.gapic import error_group_service_client
+from google.cloud.errorreporting_v1beta1.gapic import error_stats_service_client
+from google.cloud.errorreporting_v1beta1.gapic import report_errors_service_client
+
+
+class ErrorGroupServiceClient(error_group_service_client.ErrorGroupServiceClient):
+    __doc__ = error_group_service_client.ErrorGroupServiceClient.__doc__
+    enums = enums
+
+
+class ErrorStatsServiceClient(error_stats_service_client.ErrorStatsServiceClient):
+    __doc__ = error_stats_service_client.ErrorStatsServiceClient.__doc__
+    enums = enums
+
+
+class ReportErrorsServiceClient(report_errors_service_client.ReportErrorsServiceClient):
+    __doc__ = report_errors_service_client.ReportErrorsServiceClient.__doc__
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "ErrorGroupServiceClient",
+    "ErrorStatsServiceClient",
+    "ReportErrorsServiceClient",
+)
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/__init__.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/enums.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..890ea7e7e4c2
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/enums.py
@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ErrorGroupOrder(enum.IntEnum):
+    """
+    A sorting order of error groups.
+
+    Attributes:
+      GROUP_ORDER_UNSPECIFIED (int): No group order specified.
+      COUNT_DESC (int): Total count of errors in the given time window in descending order.
+      LAST_SEEN_DESC (int): Timestamp when the group was last seen in the given time window
+      in descending order.
+      CREATED_DESC (int): Timestamp when the group was created in descending order.
+      AFFECTED_USERS_DESC (int): Number of affected users in the given time window in descending order.
+    """
+
+    GROUP_ORDER_UNSPECIFIED = 0
+    COUNT_DESC = 1
+    LAST_SEEN_DESC = 2
+    CREATED_DESC = 3
+    AFFECTED_USERS_DESC = 4
+
+
+class TimedCountAlignment(enum.IntEnum):
+    """
+    Specifies how the time periods of error group counts are aligned.
+
+    Attributes:
+      ERROR_COUNT_ALIGNMENT_UNSPECIFIED (int): No alignment specified.
+      ALIGNMENT_EQUAL_ROUNDED (int): 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_AT_END (int): 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.
+    """
+
+    ERROR_COUNT_ALIGNMENT_UNSPECIFIED = 0
+    ALIGNMENT_EQUAL_ROUNDED = 1
+    ALIGNMENT_EQUAL_AT_END = 2
+
+
+class QueryTimeRange(object):
+    class Period(enum.IntEnum):
+        """
+        The supported time ranges.
+
+        Attributes:
+          PERIOD_UNSPECIFIED (int): Do not use.
+          PERIOD_1_HOUR (int): Retrieve data for the last hour.
+          Recommended minimum timed count duration: 1 min.
+          PERIOD_6_HOURS (int): Retrieve data for the last 6 hours.
+          Recommended minimum timed count duration: 10 min.
+          PERIOD_1_DAY (int): Retrieve data for the last day.
+          Recommended minimum timed count duration: 1 hour.
+          PERIOD_1_WEEK (int): Retrieve data for the last week.
+          Recommended minimum timed count duration: 6 hours.
+          PERIOD_30_DAYS (int): Retrieve data for the last 30 days.
+          Recommended minimum timed count duration: 1 day.
+        """
+
+        PERIOD_UNSPECIFIED = 0
+        PERIOD_1_HOUR = 1
+        PERIOD_6_HOURS = 2
+        PERIOD_1_DAY = 3
+        PERIOD_1_WEEK = 4
+        PERIOD_30_DAYS = 5
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_group_service_client.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_group_service_client.py
new file mode 100644
index 000000000000..af60931f74e9
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_group_service_client.py
@@ -0,0 +1,342 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.devtools.clouderrorreporting.v1beta1 ErrorGroupService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.errorreporting_v1beta1.gapic import enums
+from google.cloud.errorreporting_v1beta1.gapic import error_group_service_client_config
+from google.cloud.errorreporting_v1beta1.gapic.transports import (
+    error_group_service_grpc_transport,
+)
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-error-reporting"
+).version
+
+
+class ErrorGroupServiceClient(object):
+    """Service for retrieving and updating individual error groups."""
+
+    SERVICE_ADDRESS = "clouderrorreporting.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.devtools.clouderrorreporting.v1beta1.ErrorGroupService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ErrorGroupServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def group_path(cls, project, group):
+        """Return a fully-qualified group string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/groups/{group}", project=project, group=group
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ErrorGroupServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ErrorGroupServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = error_group_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=error_group_service_grpc_transport.ErrorGroupServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = error_group_service_grpc_transport.ErrorGroupServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def get_group(
+        self,
+        group_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Get the specified group.
+
+        Example:
+            >>> from google.cloud import errorreporting_v1beta1
+            >>>
+            >>> client = errorreporting_v1beta1.ErrorGroupServiceClient()
+            >>>
+            >>> group_name = client.group_path('[PROJECT]', '[GROUP]')
+            >>>
+            >>> response = client.get_group(group_name)
+
+        Args:
+            group_name (str): [Required] The group resource name. Written as
+                projects/projectID/groups/group\_name. Call groupStats.list to return a
+                list of groups belonging to this project.
+
+                Example: projects/my-project-123/groups/my-group
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.errorreporting_v1beta1.types.ErrorGroup` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_group" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_group"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_group,
+                default_retry=self._method_configs["GetGroup"].retry,
+                default_timeout=self._method_configs["GetGroup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = error_group_service_pb2.GetGroupRequest(group_name=group_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("group_name", group_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_group"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_group(
+        self,
+        group,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Replace the data for the specified group.
+        Fails if the group does not exist.
+
+        Example:
+            >>> from google.cloud import errorreporting_v1beta1
+            >>>
+            >>> client = errorreporting_v1beta1.ErrorGroupServiceClient()
+            >>>
+            >>> # TODO: Initialize `group`:
+            >>> group = {}
+            >>>
+            >>> response = client.update_group(group)
+
+        Args:
+            group (Union[dict, ~google.cloud.errorreporting_v1beta1.types.ErrorGroup]): [Required] The group which replaces the resource on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.ErrorGroup`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.errorreporting_v1beta1.types.ErrorGroup` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_group" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_group"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_group,
+                default_retry=self._method_configs["UpdateGroup"].retry,
+                default_timeout=self._method_configs["UpdateGroup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = error_group_service_pb2.UpdateGroupRequest(group=group)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("group.name", group.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_group"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_group_service_client_config.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_group_service_client_config.py
new file mode 100644
index 000000000000..e70ec324be62
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_group_service_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.devtools.clouderrorreporting.v1beta1.ErrorGroupService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "GetGroup": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateGroup": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_stats_service_client.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_stats_service_client.py
new file mode 100644
index 000000000000..692f0329e8de
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_stats_service_client.py
@@ -0,0 +1,559 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.devtools.clouderrorreporting.v1beta1 ErrorStatsService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.errorreporting_v1beta1.gapic import enums
+from google.cloud.errorreporting_v1beta1.gapic import error_stats_service_client_config
+from google.cloud.errorreporting_v1beta1.gapic.transports import (
+    error_stats_service_grpc_transport,
+)
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2_grpc
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2_grpc
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-error-reporting"
+).version
+
+
+class ErrorStatsServiceClient(object):
+    """
+    An API for retrieving and managing error statistics as well as data for
+    individual events.
+    """
+
+    SERVICE_ADDRESS = "clouderrorreporting.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.devtools.clouderrorreporting.v1beta1.ErrorStatsService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ErrorStatsServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ErrorStatsServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ErrorStatsServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = error_stats_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=error_stats_service_grpc_transport.ErrorStatsServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = error_stats_service_grpc_transport.ErrorStatsServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_group_stats(
+        self,
+        project_name,
+        time_range,
+        group_id=None,
+        service_filter=None,
+        timed_count_duration=None,
+        alignment=None,
+        alignment_time=None,
+        order=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the specified groups.
+
+        Example:
+            >>> from google.cloud import errorreporting_v1beta1
+            >>>
+            >>> client = errorreporting_v1beta1.ErrorStatsServiceClient()
+            >>>
+            >>> project_name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `time_range`:
+            >>> time_range = {}
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_group_stats(project_name, time_range):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_group_stats(project_name, time_range).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_name (str): [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.
+            time_range (Union[dict, ~google.cloud.errorreporting_v1beta1.types.QueryTimeRange]): [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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.QueryTimeRange`
+            group_id (list[str]): [Optional] List all ErrorGroupStats with these IDs.
+            service_filter (Union[dict, ~google.cloud.errorreporting_v1beta1.types.ServiceContextFilter]): [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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.ServiceContextFilter`
+            timed_count_duration (Union[dict, ~google.cloud.errorreporting_v1beta1.types.Duration]): [Optional] The preferred duration for a single returned ``TimedCount``.
+                If not set, no timed counts are returned.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.Duration`
+            alignment (~google.cloud.errorreporting_v1beta1.types.TimedCountAlignment): [Optional] The alignment of the timed counts to be returned. Default is
+                ``ALIGNMENT_EQUAL_AT_END``.
+            alignment_time (Union[dict, ~google.cloud.errorreporting_v1beta1.types.Timestamp]): [Optional] Time where the timed counts shall be aligned if rounded
+                alignment is chosen. Default is 00:00 UTC.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.Timestamp`
+            order (~google.cloud.errorreporting_v1beta1.types.ErrorGroupOrder): [Optional] The sort order in which the results are returned. Default is
+                ``COUNT_DESC``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.errorreporting_v1beta1.types.ErrorGroupStats` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_group_stats" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_group_stats"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_group_stats,
+                default_retry=self._method_configs["ListGroupStats"].retry,
+                default_timeout=self._method_configs["ListGroupStats"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = error_stats_service_pb2.ListGroupStatsRequest(
+            project_name=project_name,
+            time_range=time_range,
+            group_id=group_id,
+            service_filter=service_filter,
+            timed_count_duration=timed_count_duration,
+            alignment=alignment,
+            alignment_time=alignment_time,
+            order=order,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_name", project_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_group_stats"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="error_group_stats",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_events(
+        self,
+        project_name,
+        group_id,
+        service_filter=None,
+        time_range=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the specified events.
+
+        Example:
+            >>> from google.cloud import errorreporting_v1beta1
+            >>>
+            >>> client = errorreporting_v1beta1.ErrorStatsServiceClient()
+            >>>
+            >>> project_name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `group_id`:
+            >>> group_id = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_events(project_name, group_id):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_events(project_name, group_id).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_name (str): [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``.
+            group_id (str): [Required] The group for which events shall be returned.
+            service_filter (Union[dict, ~google.cloud.errorreporting_v1beta1.types.ServiceContextFilter]): [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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.ServiceContextFilter`
+            time_range (Union[dict, ~google.cloud.errorreporting_v1beta1.types.QueryTimeRange]): [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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.QueryTimeRange`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.errorreporting_v1beta1.types.ErrorEvent` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_events" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_events"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_events,
+                default_retry=self._method_configs["ListEvents"].retry,
+                default_timeout=self._method_configs["ListEvents"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = error_stats_service_pb2.ListEventsRequest(
+            project_name=project_name,
+            group_id=group_id,
+            service_filter=service_filter,
+            time_range=time_range,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_name", project_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_events"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="error_events",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_events(
+        self,
+        project_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes all error events of a given project.
+
+        Example:
+            >>> from google.cloud import errorreporting_v1beta1
+            >>>
+            >>> client = errorreporting_v1beta1.ErrorStatsServiceClient()
+            >>>
+            >>> project_name = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.delete_events(project_name)
+
+        Args:
+            project_name (str): [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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.errorreporting_v1beta1.types.DeleteEventsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_events" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_events"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_events,
+                default_retry=self._method_configs["DeleteEvents"].retry,
+                default_timeout=self._method_configs["DeleteEvents"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = error_stats_service_pb2.DeleteEventsRequest(project_name=project_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_name", project_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["delete_events"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_stats_service_client_config.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_stats_service_client_config.py
new file mode 100644
index 000000000000..fead94c5b733
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/error_stats_service_client_config.py
@@ -0,0 +1,38 @@
+config = {
+    "interfaces": {
+        "google.devtools.clouderrorreporting.v1beta1.ErrorStatsService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListGroupStats": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListEvents": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteEvents": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/report_errors_service_client.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/report_errors_service_client.py
new file mode 100644
index 000000000000..7ad37cc1cd36
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/report_errors_service_client.py
@@ -0,0 +1,285 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.devtools.clouderrorreporting.v1beta1 ReportErrorsService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.errorreporting_v1beta1.gapic import enums
+from google.cloud.errorreporting_v1beta1.gapic import (
+    report_errors_service_client_config,
+)
+from google.cloud.errorreporting_v1beta1.gapic.transports import (
+    report_errors_service_grpc_transport,
+)
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2_grpc
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2_grpc
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2_grpc
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-error-reporting"
+).version
+
+
+class ReportErrorsServiceClient(object):
+    """An API for reporting error events."""
+
+    SERVICE_ADDRESS = "clouderrorreporting.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.devtools.clouderrorreporting.v1beta1.ReportErrorsService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ReportErrorsServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ReportErrorsServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ReportErrorsServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = report_errors_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=report_errors_service_grpc_transport.ReportErrorsServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = report_errors_service_grpc_transport.ReportErrorsServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def report_error_event(
+        self,
+        project_name,
+        event,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Report an individual error event.
+
+        Example:
+            >>> from google.cloud import errorreporting_v1beta1
+            >>>
+            >>> client = errorreporting_v1beta1.ReportErrorsServiceClient()
+            >>>
+            >>> project_name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `event`:
+            >>> event = {}
+            >>>
+            >>> response = client.report_error_event(project_name, event)
+
+        Args:
+            project_name (str): [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``.
+            event (Union[dict, ~google.cloud.errorreporting_v1beta1.types.ReportedErrorEvent]): [Required] The error event to be reported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.errorreporting_v1beta1.types.ReportedErrorEvent`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.errorreporting_v1beta1.types.ReportErrorEventResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "report_error_event" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "report_error_event"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.report_error_event,
+                default_retry=self._method_configs["ReportErrorEvent"].retry,
+                default_timeout=self._method_configs["ReportErrorEvent"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = report_errors_service_pb2.ReportErrorEventRequest(
+            project_name=project_name, event=event
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_name", project_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["report_error_event"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/report_errors_service_client_config.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/report_errors_service_client_config.py
new file mode 100644
index 000000000000..cfefc7eb95f2
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/report_errors_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.devtools.clouderrorreporting.v1beta1.ReportErrorsService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ReportErrorEvent": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/__init__.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/error_group_service_grpc_transport.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/error_group_service_grpc_transport.py
new file mode 100644
index 000000000000..cde299b8edb0
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/error_group_service_grpc_transport.py
@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2_grpc
+
+
+class ErrorGroupServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.devtools.clouderrorreporting.v1beta1 ErrorGroupService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="clouderrorreporting.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "error_group_service_stub": error_group_service_pb2_grpc.ErrorGroupServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls,
+        address="clouderrorreporting.googleapis.com:443",
+        credentials=None,
+        **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def get_group(self):
+        """Return the gRPC stub for :meth:`ErrorGroupServiceClient.get_group`.
+
+        Get the specified group.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["error_group_service_stub"].GetGroup
+
+    @property
+    def update_group(self):
+        """Return the gRPC stub for :meth:`ErrorGroupServiceClient.update_group`.
+
+        Replace the data for the specified group.
+        Fails if the group does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["error_group_service_stub"].UpdateGroup
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/error_stats_service_grpc_transport.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/error_stats_service_grpc_transport.py
new file mode 100644
index 000000000000..2ef5f2126019
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/error_stats_service_grpc_transport.py
@@ -0,0 +1,155 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2_grpc
+
+
+class ErrorStatsServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.devtools.clouderrorreporting.v1beta1 ErrorStatsService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="clouderrorreporting.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "error_stats_service_stub": error_stats_service_pb2_grpc.ErrorStatsServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls,
+        address="clouderrorreporting.googleapis.com:443",
+        credentials=None,
+        **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_group_stats(self):
+        """Return the gRPC stub for :meth:`ErrorStatsServiceClient.list_group_stats`.
+
+        Lists the specified groups.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["error_stats_service_stub"].ListGroupStats
+
+    @property
+    def list_events(self):
+        """Return the gRPC stub for :meth:`ErrorStatsServiceClient.list_events`.
+
+        Lists the specified events.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["error_stats_service_stub"].ListEvents
+
+    @property
+    def delete_events(self):
+        """Return the gRPC stub for :meth:`ErrorStatsServiceClient.delete_events`.
+
+        Deletes all error events of a given project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["error_stats_service_stub"].DeleteEvents
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/report_errors_service_grpc_transport.py b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/report_errors_service_grpc_transport.py
new file mode 100644
index 000000000000..e367e49c4c39
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/gapic/transports/report_errors_service_grpc_transport.py
@@ -0,0 +1,129 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2_grpc
+
+
+class ReportErrorsServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.devtools.clouderrorreporting.v1beta1 ReportErrorsService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="clouderrorreporting.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "report_errors_service_stub": report_errors_service_pb2_grpc.ReportErrorsServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls,
+        address="clouderrorreporting.googleapis.com:443",
+        credentials=None,
+        **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def report_error_event(self):
+        """Return the gRPC stub for :meth:`ReportErrorsServiceClient.report_error_event`.
+
+        Report an individual error event.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["report_errors_service_stub"].ReportErrorEvent
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/__init__.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/common.proto b/error_reporting/google/cloud/errorreporting_v1beta1/proto/common.proto
new file mode 100644
index 000000000000..132f1a646f87
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/common.proto
@@ -0,0 +1,164 @@
+// Copyright 2016 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.clouderrorreporting.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/monitored_resource.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+option java_package = "com.google.devtools.clouderrorreporting.v1beta1";
+option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
+
+// Description of a group of similar error events.
+message ErrorGroup {
+  // The group resource name.
+  // Example: <code>projects/my-project-123/groups/my-groupid</code>
+  string name = 1;
+
+  // Group IDs are unique for a given project. If the same kind of error
+  // occurs in different service contexts, it will receive the same group ID.
+  string group_id = 2;
+
+  // Associated tracking issues.
+  repeated TrackingIssue tracking_issues = 3;
+}
+
+// Information related to tracking the progress on resolving the error.
+message TrackingIssue {
+  // A URL pointing to a related entry in an issue tracking system.
+  // Example: https://github.com/user/project/issues/4
+  string url = 1;
+}
+
+// An error event which is returned by the Error Reporting system.
+message ErrorEvent {
+  // Time when the event occurred as provided in the error report.
+  // If the report did not contain a timestamp, the time the error was received
+  // by the Error Reporting system is used.
+  google.protobuf.Timestamp event_time = 1;
+
+  // The `ServiceContext` for which this error was reported.
+  ServiceContext service_context = 2;
+
+  // The stack trace that was reported or logged by the service.
+  string message = 3;
+
+  // Data about the context in which the error occurred.
+  ErrorContext context = 5;
+}
+
+// Describes a running service that sends errors.
+// Its version changes over time and multiple versions can run in parallel.
+message ServiceContext {
+  // An identifier of the service, such as the name of the
+  // executable, job, or Google App Engine service name. This field is expected
+  // to have a low number of values that are relatively stable over time, as
+  // opposed to `version`, which can be changed whenever new code is deployed.
+  //
+  // Contains the service name for error reports extracted from Google
+  // App Engine logs or `default` if the App Engine default service is used.
+  string service = 2;
+
+  // Represents the source code version that the developer provided,
+  // which could represent a version label or a Git SHA-1 hash, for example.
+  string version = 3;
+
+  // Type of the MonitoredResource. List of possible values:
+  // https://cloud.google.com/monitoring/api/resources
+  //
+  // Value is set automatically for incoming errors and must not be set when
+  // reporting errors.
+  string resource_type = 4;
+}
+
+// A description of the context in which an error occurred.
+// 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.
+message ErrorContext {
+  // The HTTP request which was processed when the error was
+  // triggered.
+  HttpRequestContext http_request = 1;
+
+  // The user who caused or was affected by the crash.
+  // This can be a user ID, an email address, or an arbitrary token that
+  // uniquely identifies the user.
+  // When sending an error report, leave this field empty if the user was not
+  // logged in. In this case the
+  // Error Reporting system will use other data, such as remote IP address, to
+  // distinguish affected users. See `affected_users_count` in
+  // `ErrorGroupStats`.
+  string user = 2;
+
+  // The location in the source code where the decision was made to
+  // 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.
+  SourceLocation report_location = 3;
+}
+
+// HTTP request data that is related to a reported error.
+// 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.
+message HttpRequestContext {
+  // The type of HTTP request, such as `GET`, `POST`, etc.
+  string method = 1;
+
+  // The URL of the request.
+  string url = 2;
+
+  // The user agent information that is provided with the request.
+  string user_agent = 3;
+
+  // The referrer information that is provided with the request.
+  string referrer = 4;
+
+  // The HTTP response status code for the request.
+  int32 response_status_code = 5;
+
+  // The IP address from which the request originated.
+  // This can be IPv4, IPv6, or a token which is derived from the
+  // IP address, depending on the data that has been provided
+  // in the error report.
+  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.
+message SourceLocation {
+  // The source code filename, which can include a truncated relative
+  // path, or a full path from a production machine.
+  string file_path = 1;
+
+  // 1-based. 0 indicates that the line number is unknown.
+  int32 line_number = 2;
+
+  // Human-readable name of a function or method.
+  // The value can include optional context like the class or package name.
+  // For example, `my.package.MyClass.method` in case of Java.
+  string function_name = 4;
+}
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/common_pb2.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/common_pb2.py
new file mode 100644
index 000000000000..c9ebc4c6d279
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/common_pb2.py
@@ -0,0 +1,825 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/clouderrorreporting_v1beta1/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/clouderrorreporting_v1beta1/proto/common.proto",
+    package="google.devtools.clouderrorreporting.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n/com.google.devtools.clouderrorreporting.v1beta1B\013CommonProtoP\001Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\252\002#Google.Cloud.ErrorReporting.V1Beta1\312\002#Google\\Cloud\\ErrorReporting\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n>google/devtools/clouderrorreporting_v1beta1/proto/common.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/api/monitored_resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x81\x01\n\nErrorGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08group_id\x18\x02 \x01(\t\x12S\n\x0ftracking_issues\x18\x03 \x03(\x0b\x32:.google.devtools.clouderrorreporting.v1beta1.TrackingIssue"\x1c\n\rTrackingIssue\x12\x0b\n\x03url\x18\x01 \x01(\t"\xef\x01\n\nErrorEvent\x12.\n\nevent_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12T\n\x0fservice_context\x18\x02 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContext\x12\x0f\n\x07message\x18\x03 \x01(\t\x12J\n\x07\x63ontext\x18\x05 \x01(\x0b\x32\x39.google.devtools.clouderrorreporting.v1beta1.ErrorContext"I\n\x0eServiceContext\x12\x0f\n\x07service\x18\x02 \x01(\t\x12\x0f\n\x07version\x18\x03 \x01(\t\x12\x15\n\rresource_type\x18\x04 \x01(\t"\xc9\x01\n\x0c\x45rrorContext\x12U\n\x0chttp_request\x18\x01 \x01(\x0b\x32?.google.devtools.clouderrorreporting.v1beta1.HttpRequestContext\x12\x0c\n\x04user\x18\x02 \x01(\t\x12T\n\x0freport_location\x18\x03 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.SourceLocation"\x88\x01\n\x12HttpRequestContext\x12\x0e\n\x06method\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x12\n\nuser_agent\x18\x03 \x01(\t\x12\x10\n\x08referrer\x18\x04 \x01(\t\x12\x1c\n\x14response_status_code\x18\x05 \x01(\x05\x12\x11\n\tremote_ip\x18\x06 \x01(\t"O\n\x0eSourceLocation\x12\x11\n\tfile_path\x18\x01 \x01(\t\x12\x13\n\x0bline_number\x18\x02 \x01(\x05\x12\x15\n\rfunction_name\x18\x04 \x01(\tB\xec\x01\n/com.google.devtools.clouderrorreporting.v1beta1B\x0b\x43ommonProtoP\x01Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_ERRORGROUP = _descriptor.Descriptor(
+    name="ErrorGroup",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroup",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroup.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_id",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroup.group_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tracking_issues",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroup.tracking_issues",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=212,
+    serialized_end=341,
+)
+
+
+_TRACKINGISSUE = _descriptor.Descriptor(
+    name="TrackingIssue",
+    full_name="google.devtools.clouderrorreporting.v1beta1.TrackingIssue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.devtools.clouderrorreporting.v1beta1.TrackingIssue.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=343,
+    serialized_end=371,
+)
+
+
+_ERROREVENT = _descriptor.Descriptor(
+    name="ErrorEvent",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="event_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorEvent.event_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_context",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorEvent.service_context",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorEvent.message",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorEvent.context",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=374,
+    serialized_end=613,
+)
+
+
+_SERVICECONTEXT = _descriptor.Descriptor(
+    name="ServiceContext",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContext.service",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContext.version",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_type",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContext.resource_type",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=615,
+    serialized_end=688,
+)
+
+
+_ERRORCONTEXT = _descriptor.Descriptor(
+    name="ErrorContext",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_request",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorContext.http_request",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorContext.user",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="report_location",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorContext.report_location",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=691,
+    serialized_end=892,
+)
+
+
+_HTTPREQUESTCONTEXT = _descriptor.Descriptor(
+    name="HttpRequestContext",
+    full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="method",
+            full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext.method",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext.url",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_agent",
+            full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext.user_agent",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="referrer",
+            full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext.referrer",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_status_code",
+            full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext.response_status_code",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remote_ip",
+            full_name="google.devtools.clouderrorreporting.v1beta1.HttpRequestContext.remote_ip",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=895,
+    serialized_end=1031,
+)
+
+
+_SOURCELOCATION = _descriptor.Descriptor(
+    name="SourceLocation",
+    full_name="google.devtools.clouderrorreporting.v1beta1.SourceLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="file_path",
+            full_name="google.devtools.clouderrorreporting.v1beta1.SourceLocation.file_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="line_number",
+            full_name="google.devtools.clouderrorreporting.v1beta1.SourceLocation.line_number",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="function_name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.SourceLocation.function_name",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1033,
+    serialized_end=1112,
+)
+
+_ERRORGROUP.fields_by_name["tracking_issues"].message_type = _TRACKINGISSUE
+_ERROREVENT.fields_by_name[
+    "event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ERROREVENT.fields_by_name["service_context"].message_type = _SERVICECONTEXT
+_ERROREVENT.fields_by_name["context"].message_type = _ERRORCONTEXT
+_ERRORCONTEXT.fields_by_name["http_request"].message_type = _HTTPREQUESTCONTEXT
+_ERRORCONTEXT.fields_by_name["report_location"].message_type = _SOURCELOCATION
+DESCRIPTOR.message_types_by_name["ErrorGroup"] = _ERRORGROUP
+DESCRIPTOR.message_types_by_name["TrackingIssue"] = _TRACKINGISSUE
+DESCRIPTOR.message_types_by_name["ErrorEvent"] = _ERROREVENT
+DESCRIPTOR.message_types_by_name["ServiceContext"] = _SERVICECONTEXT
+DESCRIPTOR.message_types_by_name["ErrorContext"] = _ERRORCONTEXT
+DESCRIPTOR.message_types_by_name["HttpRequestContext"] = _HTTPREQUESTCONTEXT
+DESCRIPTOR.message_types_by_name["SourceLocation"] = _SOURCELOCATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ErrorGroup = _reflection.GeneratedProtocolMessageType(
+    "ErrorGroup",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ERRORGROUP,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""Description of a group of similar error events.
+  
+  
+  Attributes:
+      name:
+          The group resource name. Example: projects/my-
+          project-123/groups/my-groupid
+      group_id:
+          Group IDs are unique for a given project. If the same kind of
+          error occurs in different service contexts, it will receive
+          the same group ID.
+      tracking_issues:
+          Associated tracking issues.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ErrorGroup)
+    ),
+)
+_sym_db.RegisterMessage(ErrorGroup)
+
+TrackingIssue = _reflection.GeneratedProtocolMessageType(
+    "TrackingIssue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRACKINGISSUE,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""Information related to tracking the progress on resolving the error.
+  
+  
+  Attributes:
+      url:
+          A URL pointing to a related entry in an issue tracking system.
+          Example: https://github.com/user/project/issues/4
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.TrackingIssue)
+    ),
+)
+_sym_db.RegisterMessage(TrackingIssue)
+
+ErrorEvent = _reflection.GeneratedProtocolMessageType(
+    "ErrorEvent",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ERROREVENT,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""An error event which is returned by the Error Reporting system.
+  
+  
+  Attributes:
+      event_time:
+          Time when the event occurred as provided in the error report.
+          If the report did not contain a timestamp, the time the error
+          was received by the Error Reporting system is used.
+      service_context:
+          The ``ServiceContext`` for which this error was reported.
+      message:
+          The stack trace that was reported or logged by the service.
+      context:
+          Data about the context in which the error occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ErrorEvent)
+    ),
+)
+_sym_db.RegisterMessage(ErrorEvent)
+
+ServiceContext = _reflection.GeneratedProtocolMessageType(
+    "ServiceContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SERVICECONTEXT,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""Describes a running service that sends errors. Its version changes over
+  time and multiple versions can run in parallel.
+  
+  
+  Attributes:
+      service:
+          An identifier of the service, such as the name of the
+          executable, job, or Google App Engine service name. This field
+          is expected to have a low number of values that are relatively
+          stable over time, as opposed to ``version``, which can be
+          changed whenever new code is deployed.  Contains the service
+          name for error reports extracted from Google App Engine logs
+          or ``default`` if the App Engine default service is used.
+      version:
+          Represents the source code version that the developer
+          provided, which could represent a version label or a Git SHA-1
+          hash, for example.
+      resource_type:
+          Type of the MonitoredResource. List of possible values:
+          https://cloud.google.com/monitoring/api/resources  Value is
+          set automatically for incoming errors and must not be set when
+          reporting errors.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ServiceContext)
+    ),
+)
+_sym_db.RegisterMessage(ServiceContext)
+
+ErrorContext = _reflection.GeneratedProtocolMessageType(
+    "ErrorContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ERRORCONTEXT,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""A description of the context in which an error occurred. 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.
+  
+  
+  Attributes:
+      http_request:
+          The HTTP request which was processed when the error was
+          triggered.
+      user:
+          The user who caused or was affected by the crash. This can be
+          a user ID, an email address, or an arbitrary token that
+          uniquely identifies the user. When sending an error report,
+          leave this field empty if the user was not logged in. In this
+          case the Error Reporting system will use other data, such as
+          remote IP address, to distinguish affected users. See
+          ``affected_users_count`` in ``ErrorGroupStats``.
+      report_location:
+          The location in the source code where the decision was made to
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ErrorContext)
+    ),
+)
+_sym_db.RegisterMessage(ErrorContext)
+
+HttpRequestContext = _reflection.GeneratedProtocolMessageType(
+    "HttpRequestContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HTTPREQUESTCONTEXT,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""HTTP request data that is related to a reported error. 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.
+  
+  
+  Attributes:
+      method:
+          The type of HTTP request, such as ``GET``, ``POST``, etc.
+      url:
+          The URL of the request.
+      user_agent:
+          The user agent information that is provided with the request.
+      referrer:
+          The referrer information that is provided with the request.
+      response_status_code:
+          The HTTP response status code for the request.
+      remote_ip:
+          The IP address from which the request originated. This can be
+          IPv4, IPv6, or a token which is derived from the IP address,
+          depending on the data that has been provided in the error
+          report.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.HttpRequestContext)
+    ),
+)
+_sym_db.RegisterMessage(HttpRequestContext)
+
+SourceLocation = _reflection.GeneratedProtocolMessageType(
+    "SourceLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SOURCELOCATION,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.common_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      file_path:
+          The source code filename, which can include a truncated
+          relative path, or a full path from a production machine.
+      line_number:
+          1-based. 0 indicates that the line number is unknown.
+      function_name:
+          Human-readable name of a function or method. The value can
+          include optional context like the class or package name. For
+          example, ``my.package.MyClass.method`` in case of Java.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.SourceLocation)
+    ),
+)
+_sym_db.RegisterMessage(SourceLocation)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/common_pb2_grpc.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service.proto b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service.proto
new file mode 100644
index 000000000000..15086a9eaa47
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service.proto
@@ -0,0 +1,65 @@
+// Copyright 2016 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.clouderrorreporting.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/devtools/clouderrorreporting/v1beta1/common.proto";
+
+option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
+option java_multiple_files = true;
+option java_outer_classname = "ErrorGroupServiceProto";
+option java_package = "com.google.devtools.clouderrorreporting.v1beta1";
+option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
+
+// Service for retrieving and updating individual error groups.
+service ErrorGroupService {
+  // Get the specified group.
+  rpc GetGroup(GetGroupRequest) returns (ErrorGroup) {
+    option (google.api.http) = {
+      get: "/v1beta1/{group_name=projects/*/groups/*}"
+    };
+  }
+
+  // Replace the data for the specified group.
+  // Fails if the group does not exist.
+  rpc UpdateGroup(UpdateGroupRequest) returns (ErrorGroup) {
+    option (google.api.http) = {
+      put: "/v1beta1/{group.name=projects/*/groups/*}"
+      body: "group"
+    };
+  }
+}
+
+// A request to return an individual group.
+message GetGroupRequest {
+  // [Required] The group resource name. Written as
+  // <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
+  // Call
+  // <a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
+  // <code>groupStats.list</code></a> to return a list of groups belonging to
+  // this project.
+  //
+  // Example: <code>projects/my-project-123/groups/my-group</code>
+  string group_name = 1;
+}
+
+// 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;
+}
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service_pb2.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service_pb2.py
new file mode 100644
index 000000000000..a6406ab03623
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service_pb2.py
@@ -0,0 +1,207 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/clouderrorreporting_v1beta1/proto/error_group_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.errorreporting_v1beta1.proto import (
+    common_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/clouderrorreporting_v1beta1/proto/error_group_service.proto",
+    package="google.devtools.clouderrorreporting.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n/com.google.devtools.clouderrorreporting.v1beta1B\026ErrorGroupServiceProtoP\001Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\252\002#Google.Cloud.ErrorReporting.V1Beta1\312\002#Google\\Cloud\\ErrorReporting\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\nKgoogle/devtools/clouderrorreporting_v1beta1/proto/error_group_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a>google/devtools/clouderrorreporting_v1beta1/proto/common.proto"%\n\x0fGetGroupRequest\x12\x12\n\ngroup_name\x18\x01 \x01(\t"\\\n\x12UpdateGroupRequest\x12\x46\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup2\x8e\x03\n\x11\x45rrorGroupService\x12\xb4\x01\n\x08GetGroup\x12<.google.devtools.clouderrorreporting.v1beta1.GetGroupRequest\x1a\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup"1\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{group_name=projects/*/groups/*}\x12\xc1\x01\n\x0bUpdateGroup\x12?.google.devtools.clouderrorreporting.v1beta1.UpdateGroupRequest\x1a\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup"8\x82\xd3\xe4\x93\x02\x32\x1a)/v1beta1/{group.name=projects/*/groups/*}:\x05groupB\xf7\x01\n/com.google.devtools.clouderrorreporting.v1beta1B\x16\x45rrorGroupServiceProtoP\x01Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_GETGROUPREQUEST = _descriptor.Descriptor(
+    name="GetGroupRequest",
+    full_name="google.devtools.clouderrorreporting.v1beta1.GetGroupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group_name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.GetGroupRequest.group_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=218,
+    serialized_end=255,
+)
+
+
+_UPDATEGROUPREQUEST = _descriptor.Descriptor(
+    name="UpdateGroupRequest",
+    full_name="google.devtools.clouderrorreporting.v1beta1.UpdateGroupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group",
+            full_name="google.devtools.clouderrorreporting.v1beta1.UpdateGroupRequest.group",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=257,
+    serialized_end=349,
+)
+
+_UPDATEGROUPREQUEST.fields_by_name[
+    "group"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERRORGROUP
+)
+DESCRIPTOR.message_types_by_name["GetGroupRequest"] = _GETGROUPREQUEST
+DESCRIPTOR.message_types_by_name["UpdateGroupRequest"] = _UPDATEGROUPREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+GetGroupRequest = _reflection.GeneratedProtocolMessageType(
+    "GetGroupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETGROUPREQUEST,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_group_service_pb2",
+        __doc__="""A request to return an individual group.
+  
+  
+  Attributes:
+      group_name:
+          [Required] The group resource name. Written as
+          projects/projectID/groups/group\_name. Call groupStats.list to
+          return a list of groups belonging to this project.  Example:
+          projects/my-project-123/groups/my-group
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.GetGroupRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetGroupRequest)
+
+UpdateGroupRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateGroupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEGROUPREQUEST,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_group_service_pb2",
+        __doc__="""A request to replace the existing data for the given group.
+  
+  
+  Attributes:
+      group:
+          [Required] The group which replaces the resource on the
+          server.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.UpdateGroupRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateGroupRequest)
+
+
+DESCRIPTOR._options = None
+
+_ERRORGROUPSERVICE = _descriptor.ServiceDescriptor(
+    name="ErrorGroupService",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=352,
+    serialized_end=750,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GetGroup",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupService.GetGroup",
+            index=0,
+            containing_service=None,
+            input_type=_GETGROUPREQUEST,
+            output_type=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERRORGROUP,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1beta1/{group_name=projects/*/groups/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateGroup",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupService.UpdateGroup",
+            index=1,
+            containing_service=None,
+            input_type=_UPDATEGROUPREQUEST,
+            output_type=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERRORGROUP,
+            serialized_options=_b(
+                "\202\323\344\223\0022\032)/v1beta1/{group.name=projects/*/groups/*}:\005group"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_ERRORGROUPSERVICE)
+
+DESCRIPTOR.services_by_name["ErrorGroupService"] = _ERRORGROUPSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service_pb2_grpc.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service_pb2_grpc.py
new file mode 100644
index 000000000000..3849772ff67d
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_group_service_pb2_grpc.py
@@ -0,0 +1,71 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.errorreporting_v1beta1.proto import (
+    common_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.errorreporting_v1beta1.proto import (
+    error_group_service_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__group__service__pb2,
+)
+
+
+class ErrorGroupServiceStub(object):
+    """Service for retrieving and updating individual error groups.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GetGroup = channel.unary_unary(
+            "/google.devtools.clouderrorreporting.v1beta1.ErrorGroupService/GetGroup",
+            request_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__group__service__pb2.GetGroupRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.ErrorGroup.FromString,
+        )
+        self.UpdateGroup = channel.unary_unary(
+            "/google.devtools.clouderrorreporting.v1beta1.ErrorGroupService/UpdateGroup",
+            request_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__group__service__pb2.UpdateGroupRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.ErrorGroup.FromString,
+        )
+
+
+class ErrorGroupServiceServicer(object):
+    """Service for retrieving and updating individual error groups.
+  """
+
+    def GetGroup(self, request, context):
+        """Get the specified group.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateGroup(self, request, context):
+        """Replace the data for the specified group.
+    Fails if the group does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ErrorGroupServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GetGroup": grpc.unary_unary_rpc_method_handler(
+            servicer.GetGroup,
+            request_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__group__service__pb2.GetGroupRequest.FromString,
+            response_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.ErrorGroup.SerializeToString,
+        ),
+        "UpdateGroup": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateGroup,
+            request_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__group__service__pb2.UpdateGroupRequest.FromString,
+            response_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.ErrorGroup.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.devtools.clouderrorreporting.v1beta1.ErrorGroupService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service.proto b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service.proto
new file mode 100644
index 000000000000..ffb25b2b8ac2
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service.proto
@@ -0,0 +1,345 @@
+// Copyright 2016 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.clouderrorreporting.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/devtools/clouderrorreporting/v1beta1/common.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
+option java_multiple_files = true;
+option java_outer_classname = "ErrorStatsServiceProto";
+option java_package = "com.google.devtools.clouderrorreporting.v1beta1";
+option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
+
+// An API for retrieving and managing error statistics as well as data for
+// individual events.
+service ErrorStatsService {
+  // Lists the specified groups.
+  rpc ListGroupStats(ListGroupStatsRequest) returns (ListGroupStatsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{project_name=projects/*}/groupStats"
+    };
+  }
+
+  // Lists the specified events.
+  rpc ListEvents(ListEventsRequest) returns (ListEventsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{project_name=projects/*}/events"
+    };
+  }
+
+  // Deletes all error events of a given project.
+  rpc DeleteEvents(DeleteEventsRequest) returns (DeleteEventsResponse) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{project_name=projects/*}/events"
+    };
+  }
+}
+
+// Specifies a set of `ErrorGroupStats` to return.
+message ListGroupStatsRequest {
+  // [Required] The resource name of the Google Cloud Platform project. Written
+  // as <code>projects/</code> plus the
+  // <a href="https://support.google.com/cloud/answer/6158840">Google Cloud
+  // Platform project ID</a>.
+  //
+  // Example: <code>projects/my-project-123</code>.
+  string project_name = 1;
+
+  // [Optional] List all <code>ErrorGroupStats</code> with these IDs.
+  repeated string group_id = 2;
+
+  // [Optional] List only <code>ErrorGroupStats</code> 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;
+
+  // [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 <code>ErrorGroupStats</code> 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 <code>ErrorGroupStats</code> with zero
+  // occurrences are returned.
+  QueryTimeRange time_range = 5;
+
+  // [Optional] The preferred duration for a single returned `TimedCount`.
+  // If not set, no timed counts are returned.
+  google.protobuf.Duration timed_count_duration = 6;
+
+  // [Optional] The alignment of the timed counts to be returned.
+  // Default is `ALIGNMENT_EQUAL_AT_END`.
+  TimedCountAlignment alignment = 7;
+
+  // [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;
+
+  // [Optional] The sort order in which the results are returned.
+  // Default is `COUNT_DESC`.
+  ErrorGroupOrder order = 9;
+
+  // [Optional] The maximum number of results to return per response.
+  // Default is 20.
+  int32 page_size = 11;
+
+  // [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;
+}
+
+// Contains a set of requested error group stats.
+message ListGroupStatsResponse {
+  // The error group stats which match the given request.
+  repeated ErrorGroupStats error_group_stats = 1;
+
+  // If non-empty, more results are available.
+  // Pass this token, along with the same query parameters as the first
+  // request, to view the next page of results.
+  string next_page_token = 2;
+
+  // The timestamp specifies the start time to which the request was restricted.
+  // The start time is set based on the requested time range. It may be adjusted
+  // to a later time if a project has exceeded the storage quota and older data
+  // has been deleted.
+  google.protobuf.Timestamp time_range_begin = 4;
+}
+
+// Data extracted for a specific group based on certain filter criteria,
+// such as a given time period and/or service filter.
+message ErrorGroupStats {
+  // Group data that is independent of the filter criteria.
+  ErrorGroup group = 1;
+
+  // Approximate total number of events in the given group that match
+  // the filter criteria.
+  int64 count = 2;
+
+  // Approximate number of affected users in the given group that
+  // match the filter criteria.
+  // Users are distinguished by data in the `ErrorContext` of the
+  // individual error events, such as their login name or their remote
+  // IP address in case of HTTP requests.
+  // The number of affected users can be zero even if the number of
+  // errors is non-zero if no data was provided from which the
+  // affected user could be deduced.
+  // Users are counted based on data in the request
+  // context that was provided in the error report. If more users are
+  // implicitly affected, such as due to a crash of the whole service,
+  // this is not reflected here.
+  int64 affected_users_count = 3;
+
+  // Approximate number of occurrences over time.
+  // Timed counts returned by ListGroups are guaranteed to be:
+  //
+  // - Inside the requested time interval
+  // - Non-overlapping, and
+  // - Ordered by ascending time.
+  repeated TimedCount timed_counts = 4;
+
+  // Approximate first occurrence that was ever seen for this group
+  // and which matches the given filter criteria, ignoring the
+  // time_range that was specified in the request.
+  google.protobuf.Timestamp first_seen_time = 5;
+
+  // Approximate last occurrence that was ever seen for this group and
+  // which matches the given filter criteria, ignoring the time_range
+  // that was specified in the request.
+  google.protobuf.Timestamp last_seen_time = 6;
+
+  // Service contexts with a non-zero error count for the given filter
+  // criteria. This list can be truncated if multiple services are affected.
+  // Refer to `num_affected_services` for the total count.
+  repeated ServiceContext affected_services = 7;
+
+  // The total number of services with a non-zero error count for the given
+  // filter criteria.
+  int32 num_affected_services = 8;
+
+  // An arbitrary event that is chosen as representative for the whole group.
+  // The representative event is intended to be used as a quick preview for
+  // the whole group. Events in the group are usually sufficiently similar
+  // to each other such that showing an arbitrary representative provides
+  // insight into the characteristics of the group as a whole.
+  ErrorEvent representative = 9;
+}
+
+// The number of errors in a given time period.
+// All numbers are approximate since the error events are sampled
+// before counting them.
+message TimedCount {
+  // Approximate number of occurrences in the given time period.
+  int64 count = 1;
+
+  // Start of the time period to which `count` refers (included).
+  google.protobuf.Timestamp start_time = 2;
+
+  // End of the time period to which `count` refers (excluded).
+  google.protobuf.Timestamp end_time = 3;
+}
+
+// Specifies a set of error events to return.
+message ListEventsRequest {
+  // [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;
+
+  // [Required] The group for which events shall be returned.
+  string group_id = 2;
+
+  // [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;
+
+  // [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;
+
+  // [Optional] The maximum number of results to return per response.
+  int32 page_size = 6;
+
+  // [Optional] A `next_page_token` provided by a previous response.
+  string page_token = 7;
+}
+
+// Contains a set of requested error events.
+message ListEventsResponse {
+  // The error events which match the given request.
+  repeated ErrorEvent error_events = 1;
+
+  // If non-empty, more results are available.
+  // Pass this token, along with the same query parameters as the first
+  // request, to view the next page of results.
+  string next_page_token = 2;
+
+  // The timestamp specifies the start time to which the request was restricted.
+  google.protobuf.Timestamp time_range_begin = 4;
+}
+
+// Requests might be rejected or the resulting timed count durations might be
+// adjusted for lower durations.
+message QueryTimeRange {
+  // The supported time ranges.
+  enum Period {
+    // Do not use.
+    PERIOD_UNSPECIFIED = 0;
+
+    // Retrieve data for the last hour.
+    // Recommended minimum timed count duration: 1 min.
+    PERIOD_1_HOUR = 1;
+
+    // Retrieve data for the last 6 hours.
+    // Recommended minimum timed count duration: 10 min.
+    PERIOD_6_HOURS = 2;
+
+    // Retrieve data for the last day.
+    // Recommended minimum timed count duration: 1 hour.
+    PERIOD_1_DAY = 3;
+
+    // Retrieve data for the last week.
+    // Recommended minimum timed count duration: 6 hours.
+    PERIOD_1_WEEK = 4;
+
+    // Retrieve data for the last 30 days.
+    // Recommended minimum timed count duration: 1 day.
+    PERIOD_30_DAYS = 5;
+  }
+
+  // Restricts the query to the specified time range.
+  Period period = 1;
+}
+
+// Specifies criteria for filtering a subset of service contexts.
+// The fields in the filter correspond to the fields in `ServiceContext`.
+// 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
+  // [`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service).
+  string service = 2;
+
+  // [Optional] The exact value to match against
+  // [`ServiceContext.version`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version).
+  string version = 3;
+
+  // [Optional] The exact value to match against
+  // [`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
+  string resource_type = 4;
+}
+
+// Deletes all events in the project.
+message DeleteEventsRequest {
+  // [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;
+}
+
+// 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;
+}
+
+// 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/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service_pb2.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service_pb2.py
new file mode 100644
index 000000000000..a8fe60bd67f7
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service_pb2.py
@@ -0,0 +1,1513 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/clouderrorreporting_v1beta1/proto/error_stats_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.errorreporting_v1beta1.proto import (
+    common_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/clouderrorreporting_v1beta1/proto/error_stats_service.proto",
+    package="google.devtools.clouderrorreporting.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n/com.google.devtools.clouderrorreporting.v1beta1B\026ErrorStatsServiceProtoP\001Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\252\002#Google.Cloud.ErrorReporting.V1Beta1\312\002#Google\\Cloud\\ErrorReporting\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\nKgoogle/devtools/clouderrorreporting_v1beta1/proto/error_stats_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a>google/devtools/clouderrorreporting_v1beta1/proto/common.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xa1\x04\n\x15ListGroupStatsRequest\x12\x14\n\x0cproject_name\x18\x01 \x01(\t\x12\x10\n\x08group_id\x18\x02 \x03(\t\x12Y\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter\x12O\n\ntime_range\x18\x05 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRange\x12\x37\n\x14timed_count_duration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12S\n\talignment\x18\x07 \x01(\x0e\x32@.google.devtools.clouderrorreporting.v1beta1.TimedCountAlignment\x12\x32\n\x0e\x61lignment_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12K\n\x05order\x18\t \x01(\x0e\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupOrder\x12\x11\n\tpage_size\x18\x0b \x01(\x05\x12\x12\n\npage_token\x18\x0c \x01(\t"\xc0\x01\n\x16ListGroupStatsResponse\x12W\n\x11\x65rror_group_stats\x18\x01 \x03(\x0b\x32<.google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x34\n\x10time_range_begin\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x86\x04\n\x0f\x45rrorGroupStats\x12\x46\n\x05group\x18\x01 \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorGroup\x12\r\n\x05\x63ount\x18\x02 \x01(\x03\x12\x1c\n\x14\x61\x66\x66\x65\x63ted_users_count\x18\x03 \x01(\x03\x12M\n\x0ctimed_counts\x18\x04 \x03(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.TimedCount\x12\x33\n\x0f\x66irst_seen_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x32\n\x0elast_seen_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12V\n\x11\x61\x66\x66\x65\x63ted_services\x18\x07 \x03(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContext\x12\x1d\n\x15num_affected_services\x18\x08 \x01(\x05\x12O\n\x0erepresentative\x18\t \x01(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorEvent"y\n\nTimedCount\x12\r\n\x05\x63ount\x18\x01 \x01(\x03\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8e\x02\n\x11ListEventsRequest\x12\x14\n\x0cproject_name\x18\x01 \x01(\t\x12\x10\n\x08group_id\x18\x02 \x01(\t\x12Y\n\x0eservice_filter\x18\x03 \x01(\x0b\x32\x41.google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter\x12O\n\ntime_range\x18\x04 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.QueryTimeRange\x12\x11\n\tpage_size\x18\x06 \x01(\x05\x12\x12\n\npage_token\x18\x07 \x01(\t"\xb2\x01\n\x12ListEventsResponse\x12M\n\x0c\x65rror_events\x18\x01 \x03(\x0b\x32\x37.google.devtools.clouderrorreporting.v1beta1.ErrorEvent\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x34\n\x10time_range_begin\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xe7\x01\n\x0eQueryTimeRange\x12R\n\x06period\x18\x01 \x01(\x0e\x32\x42.google.devtools.clouderrorreporting.v1beta1.QueryTimeRange.Period"\x80\x01\n\x06Period\x12\x16\n\x12PERIOD_UNSPECIFIED\x10\x00\x12\x11\n\rPERIOD_1_HOUR\x10\x01\x12\x12\n\x0ePERIOD_6_HOURS\x10\x02\x12\x10\n\x0cPERIOD_1_DAY\x10\x03\x12\x11\n\rPERIOD_1_WEEK\x10\x04\x12\x12\n\x0ePERIOD_30_DAYS\x10\x05"O\n\x14ServiceContextFilter\x12\x0f\n\x07service\x18\x02 \x01(\t\x12\x0f\n\x07version\x18\x03 \x01(\t\x12\x15\n\rresource_type\x18\x04 \x01(\t"+\n\x13\x44\x65leteEventsRequest\x12\x14\n\x0cproject_name\x18\x01 \x01(\t"\x16\n\x14\x44\x65leteEventsResponse*u\n\x13TimedCountAlignment\x12%\n!ERROR_COUNT_ALIGNMENT_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x41LIGNMENT_EQUAL_ROUNDED\x10\x01\x12\x1a\n\x16\x41LIGNMENT_EQUAL_AT_END\x10\x02*}\n\x0f\x45rrorGroupOrder\x12\x1b\n\x17GROUP_ORDER_UNSPECIFIED\x10\x00\x12\x0e\n\nCOUNT_DESC\x10\x01\x12\x12\n\x0eLAST_SEEN_DESC\x10\x02\x12\x10\n\x0c\x43REATED_DESC\x10\x03\x12\x17\n\x13\x41\x46\x46\x45\x43TED_USERS_DESC\x10\x04\x32\xf2\x04\n\x11\x45rrorStatsService\x12\xd0\x01\n\x0eListGroupStats\x12\x42.google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest\x1a\x43.google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse"5\x82\xd3\xe4\x93\x02/\x12-/v1beta1/{project_name=projects/*}/groupStats\x12\xc0\x01\n\nListEvents\x12>.google.devtools.clouderrorreporting.v1beta1.ListEventsRequest\x1a?.google.devtools.clouderrorreporting.v1beta1.ListEventsResponse"1\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{project_name=projects/*}/events\x12\xc6\x01\n\x0c\x44\x65leteEvents\x12@.google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest\x1a\x41.google.devtools.clouderrorreporting.v1beta1.DeleteEventsResponse"1\x82\xd3\xe4\x93\x02+*)/v1beta1/{project_name=projects/*}/eventsB\xf7\x01\n/com.google.devtools.clouderrorreporting.v1beta1B\x16\x45rrorStatsServiceProtoP\x01Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_TIMEDCOUNTALIGNMENT = _descriptor.EnumDescriptor(
+    name="TimedCountAlignment",
+    full_name="google.devtools.clouderrorreporting.v1beta1.TimedCountAlignment",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ERROR_COUNT_ALIGNMENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGNMENT_EQUAL_ROUNDED",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGNMENT_EQUAL_AT_END",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2508,
+    serialized_end=2625,
+)
+_sym_db.RegisterEnumDescriptor(_TIMEDCOUNTALIGNMENT)
+
+TimedCountAlignment = enum_type_wrapper.EnumTypeWrapper(_TIMEDCOUNTALIGNMENT)
+_ERRORGROUPORDER = _descriptor.EnumDescriptor(
+    name="ErrorGroupOrder",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupOrder",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="GROUP_ORDER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COUNT_DESC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LAST_SEEN_DESC", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATED_DESC", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AFFECTED_USERS_DESC",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2627,
+    serialized_end=2752,
+)
+_sym_db.RegisterEnumDescriptor(_ERRORGROUPORDER)
+
+ErrorGroupOrder = enum_type_wrapper.EnumTypeWrapper(_ERRORGROUPORDER)
+ERROR_COUNT_ALIGNMENT_UNSPECIFIED = 0
+ALIGNMENT_EQUAL_ROUNDED = 1
+ALIGNMENT_EQUAL_AT_END = 2
+GROUP_ORDER_UNSPECIFIED = 0
+COUNT_DESC = 1
+LAST_SEEN_DESC = 2
+CREATED_DESC = 3
+AFFECTED_USERS_DESC = 4
+
+
+_QUERYTIMERANGE_PERIOD = _descriptor.EnumDescriptor(
+    name="Period",
+    full_name="google.devtools.clouderrorreporting.v1beta1.QueryTimeRange.Period",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PERIOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERIOD_1_HOUR", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERIOD_6_HOURS", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERIOD_1_DAY", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERIOD_1_WEEK", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERIOD_30_DAYS", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2228,
+    serialized_end=2356,
+)
+_sym_db.RegisterEnumDescriptor(_QUERYTIMERANGE_PERIOD)
+
+
+_LISTGROUPSTATSREQUEST = _descriptor.Descriptor(
+    name="ListGroupStatsRequest",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.project_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_id",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.group_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_filter",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.service_filter",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_range",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.time_range",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timed_count_duration",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.timed_count_duration",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alignment",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.alignment",
+            index=5,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alignment_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.alignment_time",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.order",
+            index=7,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.page_size",
+            index=8,
+            number=11,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest.page_token",
+            index=9,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=284,
+    serialized_end=829,
+)
+
+
+_LISTGROUPSTATSRESPONSE = _descriptor.Descriptor(
+    name="ListGroupStatsResponse",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="error_group_stats",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.error_group_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_range_begin",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse.time_range_begin",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=832,
+    serialized_end=1024,
+)
+
+
+_ERRORGROUPSTATS = _descriptor.Descriptor(
+    name="ErrorGroupStats",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.group",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_users_count",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.affected_users_count",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timed_counts",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.timed_counts",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="first_seen_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.first_seen_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_seen_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.last_seen_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_services",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.affected_services",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_affected_services",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.num_affected_services",
+            index=7,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="representative",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats.representative",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1027,
+    serialized_end=1545,
+)
+
+
+_TIMEDCOUNT = _descriptor.Descriptor(
+    name="TimedCount",
+    full_name="google.devtools.clouderrorreporting.v1beta1.TimedCount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.devtools.clouderrorreporting.v1beta1.TimedCount.count",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.TimedCount.start_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.TimedCount.end_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1547,
+    serialized_end=1668,
+)
+
+
+_LISTEVENTSREQUEST = _descriptor.Descriptor(
+    name="ListEventsRequest",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest.project_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_id",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest.group_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_filter",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest.service_filter",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_range",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest.time_range",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest.page_size",
+            index=4,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsRequest.page_token",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1671,
+    serialized_end=1941,
+)
+
+
+_LISTEVENTSRESPONSE = _descriptor.Descriptor(
+    name="ListEventsResponse",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="error_events",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsResponse.error_events",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_range_begin",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ListEventsResponse.time_range_begin",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1944,
+    serialized_end=2122,
+)
+
+
+_QUERYTIMERANGE = _descriptor.Descriptor(
+    name="QueryTimeRange",
+    full_name="google.devtools.clouderrorreporting.v1beta1.QueryTimeRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="period",
+            full_name="google.devtools.clouderrorreporting.v1beta1.QueryTimeRange.period",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_QUERYTIMERANGE_PERIOD],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2125,
+    serialized_end=2356,
+)
+
+
+_SERVICECONTEXTFILTER = _descriptor.Descriptor(
+    name="ServiceContextFilter",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter.service",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter.version",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_type",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter.resource_type",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2358,
+    serialized_end=2437,
+)
+
+
+_DELETEEVENTSREQUEST = _descriptor.Descriptor(
+    name="DeleteEventsRequest",
+    full_name="google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest.project_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2439,
+    serialized_end=2482,
+)
+
+
+_DELETEEVENTSRESPONSE = _descriptor.Descriptor(
+    name="DeleteEventsResponse",
+    full_name="google.devtools.clouderrorreporting.v1beta1.DeleteEventsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2484,
+    serialized_end=2506,
+)
+
+_LISTGROUPSTATSREQUEST.fields_by_name[
+    "service_filter"
+].message_type = _SERVICECONTEXTFILTER
+_LISTGROUPSTATSREQUEST.fields_by_name["time_range"].message_type = _QUERYTIMERANGE
+_LISTGROUPSTATSREQUEST.fields_by_name[
+    "timed_count_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LISTGROUPSTATSREQUEST.fields_by_name["alignment"].enum_type = _TIMEDCOUNTALIGNMENT
+_LISTGROUPSTATSREQUEST.fields_by_name[
+    "alignment_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTGROUPSTATSREQUEST.fields_by_name["order"].enum_type = _ERRORGROUPORDER
+_LISTGROUPSTATSRESPONSE.fields_by_name[
+    "error_group_stats"
+].message_type = _ERRORGROUPSTATS
+_LISTGROUPSTATSRESPONSE.fields_by_name[
+    "time_range_begin"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ERRORGROUPSTATS.fields_by_name[
+    "group"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERRORGROUP
+)
+_ERRORGROUPSTATS.fields_by_name["timed_counts"].message_type = _TIMEDCOUNT
+_ERRORGROUPSTATS.fields_by_name[
+    "first_seen_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ERRORGROUPSTATS.fields_by_name[
+    "last_seen_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ERRORGROUPSTATS.fields_by_name[
+    "affected_services"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._SERVICECONTEXT
+)
+_ERRORGROUPSTATS.fields_by_name[
+    "representative"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERROREVENT
+)
+_TIMEDCOUNT.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEDCOUNT.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTEVENTSREQUEST.fields_by_name["service_filter"].message_type = _SERVICECONTEXTFILTER
+_LISTEVENTSREQUEST.fields_by_name["time_range"].message_type = _QUERYTIMERANGE
+_LISTEVENTSRESPONSE.fields_by_name[
+    "error_events"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERROREVENT
+)
+_LISTEVENTSRESPONSE.fields_by_name[
+    "time_range_begin"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_QUERYTIMERANGE.fields_by_name["period"].enum_type = _QUERYTIMERANGE_PERIOD
+_QUERYTIMERANGE_PERIOD.containing_type = _QUERYTIMERANGE
+DESCRIPTOR.message_types_by_name["ListGroupStatsRequest"] = _LISTGROUPSTATSREQUEST
+DESCRIPTOR.message_types_by_name["ListGroupStatsResponse"] = _LISTGROUPSTATSRESPONSE
+DESCRIPTOR.message_types_by_name["ErrorGroupStats"] = _ERRORGROUPSTATS
+DESCRIPTOR.message_types_by_name["TimedCount"] = _TIMEDCOUNT
+DESCRIPTOR.message_types_by_name["ListEventsRequest"] = _LISTEVENTSREQUEST
+DESCRIPTOR.message_types_by_name["ListEventsResponse"] = _LISTEVENTSRESPONSE
+DESCRIPTOR.message_types_by_name["QueryTimeRange"] = _QUERYTIMERANGE
+DESCRIPTOR.message_types_by_name["ServiceContextFilter"] = _SERVICECONTEXTFILTER
+DESCRIPTOR.message_types_by_name["DeleteEventsRequest"] = _DELETEEVENTSREQUEST
+DESCRIPTOR.message_types_by_name["DeleteEventsResponse"] = _DELETEEVENTSRESPONSE
+DESCRIPTOR.enum_types_by_name["TimedCountAlignment"] = _TIMEDCOUNTALIGNMENT
+DESCRIPTOR.enum_types_by_name["ErrorGroupOrder"] = _ERRORGROUPORDER
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListGroupStatsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListGroupStatsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGROUPSTATSREQUEST,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Specifies a set of ``ErrorGroupStats`` to return.
+  
+  
+  Attributes:
+      project_name:
+          [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.
+      group_id:
+          [Optional] List all ErrorGroupStats with these IDs.
+      service_filter:
+          [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.
+      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.
+      timed_count_duration:
+          [Optional] The preferred duration for a single returned
+          ``TimedCount``. If not set, no timed counts are returned.
+      alignment:
+          [Optional] The alignment of the timed counts to be returned.
+          Default is ``ALIGNMENT_EQUAL_AT_END``.
+      alignment_time:
+          [Optional] Time where the timed counts shall be aligned if
+          rounded alignment is chosen. Default is 00:00 UTC.
+      order:
+          [Optional] The sort order in which the results are returned.
+          Default is ``COUNT_DESC``.
+      page_size:
+          [Optional] The maximum number of results to return per
+          response. Default is 20.
+      page_token:
+          [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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ListGroupStatsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListGroupStatsRequest)
+
+ListGroupStatsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListGroupStatsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGROUPSTATSRESPONSE,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Contains a set of requested error group stats.
+  
+  
+  Attributes:
+      error_group_stats:
+          The error group stats which match the given request.
+      next_page_token:
+          If non-empty, more results are available. Pass this token,
+          along with the same query parameters as the first request, to
+          view the next page of results.
+      time_range_begin:
+          The timestamp specifies the start time to which the request
+          was restricted. The start time is set based on the requested
+          time range. It may be adjusted to a later time if a project
+          has exceeded the storage quota and older data has been
+          deleted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ListGroupStatsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListGroupStatsResponse)
+
+ErrorGroupStats = _reflection.GeneratedProtocolMessageType(
+    "ErrorGroupStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ERRORGROUPSTATS,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Data extracted for a specific group based on certain filter criteria,
+  such as a given time period and/or service filter.
+  
+  
+  Attributes:
+      group:
+          Group data that is independent of the filter criteria.
+      count:
+          Approximate total number of events in the given group that
+          match the filter criteria.
+      affected_users_count:
+          Approximate number of affected users in the given group that
+          match the filter criteria. Users are distinguished by data in
+          the ``ErrorContext`` of the individual error events, such as
+          their login name or their remote IP address in case of HTTP
+          requests. The number of affected users can be zero even if the
+          number of errors is non-zero if no data was provided from
+          which the affected user could be deduced. Users are counted
+          based on data in the request context that was provided in the
+          error report. If more users are implicitly affected, such as
+          due to a crash of the whole service, this is not reflected
+          here.
+      timed_counts:
+          Approximate number of occurrences over time. Timed counts
+          returned by ListGroups are guaranteed to be:  -  Inside the
+          requested time interval -  Non-overlapping, and -  Ordered by
+          ascending time.
+      first_seen_time:
+          Approximate first occurrence that was ever seen for this group
+          and which matches the given filter criteria, ignoring the
+          time\_range that was specified in the request.
+      last_seen_time:
+          Approximate last occurrence that was ever seen for this group
+          and which matches the given filter criteria, ignoring the
+          time\_range that was specified in the request.
+      affected_services:
+          Service contexts with a non-zero error count for the given
+          filter criteria. This list can be truncated if multiple
+          services are affected. Refer to ``num_affected_services`` for
+          the total count.
+      num_affected_services:
+          The total number of services with a non-zero error count for
+          the given filter criteria.
+      representative:
+          An arbitrary event that is chosen as representative for the
+          whole group. The representative event is intended to be used
+          as a quick preview for the whole group. Events in the group
+          are usually sufficiently similar to each other such that
+          showing an arbitrary representative provides insight into the
+          characteristics of the group as a whole.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ErrorGroupStats)
+    ),
+)
+_sym_db.RegisterMessage(ErrorGroupStats)
+
+TimedCount = _reflection.GeneratedProtocolMessageType(
+    "TimedCount",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEDCOUNT,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""The number of errors in a given time period. All numbers are approximate
+  since the error events are sampled before counting them.
+  
+  
+  Attributes:
+      count:
+          Approximate number of occurrences in the given time period.
+      start_time:
+          Start of the time period to which ``count`` refers (included).
+      end_time:
+          End of the time period to which ``count`` refers (excluded).
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.TimedCount)
+    ),
+)
+_sym_db.RegisterMessage(TimedCount)
+
+ListEventsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListEventsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEVENTSREQUEST,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Specifies a set of error events to return.
+  
+  
+  Attributes:
+      project_name:
+          [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``.
+      group_id:
+          [Required] The group for which events shall be returned.
+      service_filter:
+          [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.
+      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.
+      page_size:
+          [Optional] The maximum number of results to return per
+          response.
+      page_token:
+          [Optional] A ``next_page_token`` provided by a previous
+          response.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ListEventsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListEventsRequest)
+
+ListEventsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListEventsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEVENTSRESPONSE,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Contains a set of requested error events.
+  
+  
+  Attributes:
+      error_events:
+          The error events which match the given request.
+      next_page_token:
+          If non-empty, more results are available. Pass this token,
+          along with the same query parameters as the first request, to
+          view the next page of results.
+      time_range_begin:
+          The timestamp specifies the start time to which the request
+          was restricted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ListEventsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListEventsResponse)
+
+QueryTimeRange = _reflection.GeneratedProtocolMessageType(
+    "QueryTimeRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYTIMERANGE,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Requests might be rejected or the resulting timed count durations might
+  be adjusted for lower durations.
+  
+  
+  Attributes:
+      period:
+          Restricts the query to the specified time range.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.QueryTimeRange)
+    ),
+)
+_sym_db.RegisterMessage(QueryTimeRange)
+
+ServiceContextFilter = _reflection.GeneratedProtocolMessageType(
+    "ServiceContextFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SERVICECONTEXTFILTER,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Specifies criteria for filtering a subset of service contexts. The
+  fields in the filter correspond to the fields in ``ServiceContext``.
+  Only exact, case-sensitive matches are supported. If a field is unset or
+  empty, it matches arbitrary values.
+  
+  
+  Attributes:
+      service:
+          [Optional] The exact value to match against
+          ```ServiceContext.service`` </error-reporting/reference/rest/v
+          1beta1/ServiceContext#FIELDS.service>`__.
+      version:
+          [Optional] The exact value to match against
+          ```ServiceContext.version`` </error-reporting/reference/rest/v
+          1beta1/ServiceContext#FIELDS.version>`__.
+      resource_type:
+          [Optional] The exact value to match against
+          ```ServiceContext.resource_type`` </error-reporting/reference/
+          rest/v1beta1/ServiceContext#FIELDS.resource_type>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ServiceContextFilter)
+    ),
+)
+_sym_db.RegisterMessage(ServiceContextFilter)
+
+DeleteEventsRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteEventsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEEVENTSREQUEST,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Deletes all events in the project.
+  
+  
+  Attributes:
+      project_name:
+          [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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.DeleteEventsRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteEventsRequest)
+
+DeleteEventsResponse = _reflection.GeneratedProtocolMessageType(
+    "DeleteEventsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEEVENTSRESPONSE,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.error_stats_service_pb2",
+        __doc__="""Response message for deleting error events.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.DeleteEventsResponse)
+    ),
+)
+_sym_db.RegisterMessage(DeleteEventsResponse)
+
+
+DESCRIPTOR._options = None
+
+_ERRORSTATSSERVICE = _descriptor.ServiceDescriptor(
+    name="ErrorStatsService",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ErrorStatsService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2755,
+    serialized_end=3381,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListGroupStats",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListGroupStats",
+            index=0,
+            containing_service=None,
+            input_type=_LISTGROUPSTATSREQUEST,
+            output_type=_LISTGROUPSTATSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1beta1/{project_name=projects/*}/groupStats"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListEvents",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.ListEvents",
+            index=1,
+            containing_service=None,
+            input_type=_LISTEVENTSREQUEST,
+            output_type=_LISTEVENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1beta1/{project_name=projects/*}/events"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteEvents",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.DeleteEvents",
+            index=2,
+            containing_service=None,
+            input_type=_DELETEEVENTSREQUEST,
+            output_type=_DELETEEVENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002+*)/v1beta1/{project_name=projects/*}/events"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_ERRORSTATSSERVICE)
+
+DESCRIPTOR.services_by_name["ErrorStatsService"] = _ERRORSTATSSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service_pb2_grpc.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service_pb2_grpc.py
new file mode 100644
index 000000000000..06944055deb1
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/error_stats_service_pb2_grpc.py
@@ -0,0 +1,86 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.errorreporting_v1beta1.proto import (
+    error_stats_service_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2,
+)
+
+
+class ErrorStatsServiceStub(object):
+    """An API for retrieving and managing error statistics as well as data for
+  individual events.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListGroupStats = channel.unary_unary(
+            "/google.devtools.clouderrorreporting.v1beta1.ErrorStatsService/ListGroupStats",
+            request_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListGroupStatsRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListGroupStatsResponse.FromString,
+        )
+        self.ListEvents = channel.unary_unary(
+            "/google.devtools.clouderrorreporting.v1beta1.ErrorStatsService/ListEvents",
+            request_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListEventsRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListEventsResponse.FromString,
+        )
+        self.DeleteEvents = channel.unary_unary(
+            "/google.devtools.clouderrorreporting.v1beta1.ErrorStatsService/DeleteEvents",
+            request_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.DeleteEventsRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.DeleteEventsResponse.FromString,
+        )
+
+
+class ErrorStatsServiceServicer(object):
+    """An API for retrieving and managing error statistics as well as data for
+  individual events.
+  """
+
+    def ListGroupStats(self, request, context):
+        """Lists the specified groups.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListEvents(self, request, context):
+        """Lists the specified events.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteEvents(self, request, context):
+        """Deletes all error events of a given project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ErrorStatsServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListGroupStats": grpc.unary_unary_rpc_method_handler(
+            servicer.ListGroupStats,
+            request_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListGroupStatsRequest.FromString,
+            response_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListGroupStatsResponse.SerializeToString,
+        ),
+        "ListEvents": grpc.unary_unary_rpc_method_handler(
+            servicer.ListEvents,
+            request_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListEventsRequest.FromString,
+            response_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.ListEventsResponse.SerializeToString,
+        ),
+        "DeleteEvents": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteEvents,
+            request_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.DeleteEventsRequest.FromString,
+            response_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_error__stats__service__pb2.DeleteEventsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.devtools.clouderrorreporting.v1beta1.ErrorStatsService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service.proto b/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service.proto
new file mode 100644
index 000000000000..d77f646ce464
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service.proto
@@ -0,0 +1,85 @@
+// Copyright 2016 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.clouderrorreporting.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/devtools/clouderrorreporting/v1beta1/common.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
+option java_multiple_files = true;
+option java_outer_classname = "ReportErrorsServiceProto";
+option java_package = "com.google.devtools.clouderrorreporting.v1beta1";
+option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
+
+// An API for reporting error events.
+service ReportErrorsService {
+  // Report an individual error event.
+  //
+  // This endpoint accepts <strong>either</strong> an OAuth token,
+  // <strong>or</strong> an
+  // <a href="https://support.google.com/cloud/answer/6158862">API key</a>
+  // for authentication. To use an API key, append it to the URL as the value of
+  // a `key` parameter. For example:
+  // <pre>POST
+  // https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/events:report?key=123ABC456</pre>
+  rpc ReportErrorEvent(ReportErrorEventRequest)
+      returns (ReportErrorEventResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{project_name=projects/*}/events:report"
+      body: "event"
+    };
+  }
+}
+
+// A request for reporting an individual error event.
+message ReportErrorEventRequest {
+  // [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;
+
+  // [Required] The error event to be reported.
+  ReportedErrorEvent event = 2;
+}
+
+// Response for reporting an individual error event.
+// Data may be added to this message in the future.
+message ReportErrorEventResponse {}
+
+// An error event which is reported to the Error Reporting system.
+message ReportedErrorEvent {
+  // [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;
+
+  // [Required] The service context in which this error has occurred.
+  ServiceContext service_context = 2;
+
+  // [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;
+
+  // [Optional] A description of the context in which the error occurred.
+  ErrorContext context = 4;
+}
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service_pb2.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service_pb2.py
new file mode 100644
index 000000000000..9562dd34b90b
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service_pb2.py
@@ -0,0 +1,330 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/clouderrorreporting_v1beta1/proto/report_errors_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.errorreporting_v1beta1.proto import (
+    common_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/clouderrorreporting_v1beta1/proto/report_errors_service.proto",
+    package="google.devtools.clouderrorreporting.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n/com.google.devtools.clouderrorreporting.v1beta1B\030ReportErrorsServiceProtoP\001Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\252\002#Google.Cloud.ErrorReporting.V1Beta1\312\002#Google\\Cloud\\ErrorReporting\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\nMgoogle/devtools/clouderrorreporting_v1beta1/proto/report_errors_service.proto\x12+google.devtools.clouderrorreporting.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a>google/devtools/clouderrorreporting_v1beta1/proto/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x7f\n\x17ReportErrorEventRequest\x12\x14\n\x0cproject_name\x18\x01 \x01(\t\x12N\n\x05\x65vent\x18\x02 \x01(\x0b\x32?.google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent"\x1a\n\x18ReportErrorEventResponse"\xf7\x01\n\x12ReportedErrorEvent\x12.\n\nevent_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12T\n\x0fservice_context\x18\x02 \x01(\x0b\x32;.google.devtools.clouderrorreporting.v1beta1.ServiceContext\x12\x0f\n\x07message\x18\x03 \x01(\t\x12J\n\x07\x63ontext\x18\x04 \x01(\x0b\x32\x39.google.devtools.clouderrorreporting.v1beta1.ErrorContext2\xf8\x01\n\x13ReportErrorsService\x12\xe0\x01\n\x10ReportErrorEvent\x12\x44.google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest\x1a\x45.google.devtools.clouderrorreporting.v1beta1.ReportErrorEventResponse"?\x82\xd3\xe4\x93\x02\x39"0/v1beta1/{project_name=projects/*}/events:report:\x05\x65ventB\xf9\x01\n/com.google.devtools.clouderrorreporting.v1beta1B\x18ReportErrorsServiceProtoP\x01Z^google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting\xaa\x02#Google.Cloud.ErrorReporting.V1Beta1\xca\x02#Google\\Cloud\\ErrorReporting\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_REPORTERROREVENTREQUEST = _descriptor.Descriptor(
+    name="ReportErrorEventRequest",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_name",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest.project_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest.event",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=253,
+    serialized_end=380,
+)
+
+
+_REPORTERROREVENTRESPONSE = _descriptor.Descriptor(
+    name="ReportErrorEventResponse",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ReportErrorEventResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=382,
+    serialized_end=408,
+)
+
+
+_REPORTEDERROREVENT = _descriptor.Descriptor(
+    name="ReportedErrorEvent",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="event_time",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent.event_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="service_context",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent.service_context",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent.message",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent.context",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=411,
+    serialized_end=658,
+)
+
+_REPORTERROREVENTREQUEST.fields_by_name["event"].message_type = _REPORTEDERROREVENT
+_REPORTEDERROREVENT.fields_by_name[
+    "event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_REPORTEDERROREVENT.fields_by_name[
+    "service_context"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._SERVICECONTEXT
+)
+_REPORTEDERROREVENT.fields_by_name[
+    "context"
+].message_type = (
+    google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_common__pb2._ERRORCONTEXT
+)
+DESCRIPTOR.message_types_by_name["ReportErrorEventRequest"] = _REPORTERROREVENTREQUEST
+DESCRIPTOR.message_types_by_name["ReportErrorEventResponse"] = _REPORTERROREVENTRESPONSE
+DESCRIPTOR.message_types_by_name["ReportedErrorEvent"] = _REPORTEDERROREVENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ReportErrorEventRequest = _reflection.GeneratedProtocolMessageType(
+    "ReportErrorEventRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPORTERROREVENTREQUEST,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.report_errors_service_pb2",
+        __doc__="""A request for reporting an individual error event.
+  
+  
+  Attributes:
+      project_name:
+          [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``.
+      event:
+          [Required] The error event to be reported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ReportErrorEventRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReportErrorEventRequest)
+
+ReportErrorEventResponse = _reflection.GeneratedProtocolMessageType(
+    "ReportErrorEventResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPORTERROREVENTRESPONSE,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.report_errors_service_pb2",
+        __doc__="""Response for reporting an individual error event. Data may be added to
+  this message in the future.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ReportErrorEventResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReportErrorEventResponse)
+
+ReportedErrorEvent = _reflection.GeneratedProtocolMessageType(
+    "ReportedErrorEvent",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPORTEDERROREVENT,
+        __module__="google.devtools.clouderrorreporting_v1beta1.proto.report_errors_service_pb2",
+        __doc__="""An error event which is reported to the Error Reporting system.
+  
+  
+  Attributes:
+      event_time:
+          [Optional] Time when the event occurred. If not provided, the
+          time when the event was received by the Error Reporting system
+          will be used.
+      service_context:
+          [Required] The service context in which this error has
+          occurred.
+      message:
+          [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.
+      context:
+          [Optional] A description of the context in which the error
+          occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent)
+    ),
+)
+_sym_db.RegisterMessage(ReportedErrorEvent)
+
+
+DESCRIPTOR._options = None
+
+_REPORTERRORSSERVICE = _descriptor.ServiceDescriptor(
+    name="ReportErrorsService",
+    full_name="google.devtools.clouderrorreporting.v1beta1.ReportErrorsService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=661,
+    serialized_end=909,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ReportErrorEvent",
+            full_name="google.devtools.clouderrorreporting.v1beta1.ReportErrorsService.ReportErrorEvent",
+            index=0,
+            containing_service=None,
+            input_type=_REPORTERROREVENTREQUEST,
+            output_type=_REPORTERROREVENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0029"0/v1beta1/{project_name=projects/*}/events:report:\005event'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_REPORTERRORSSERVICE)
+
+DESCRIPTOR.services_by_name["ReportErrorsService"] = _REPORTERRORSSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service_pb2_grpc.py b/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service_pb2_grpc.py
new file mode 100644
index 000000000000..12f6e08e7b57
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/report_errors_service_pb2_grpc.py
@@ -0,0 +1,58 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.errorreporting_v1beta1.proto import (
+    report_errors_service_pb2 as google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_report__errors__service__pb2,
+)
+
+
+class ReportErrorsServiceStub(object):
+    """An API for reporting error events.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ReportErrorEvent = channel.unary_unary(
+            "/google.devtools.clouderrorreporting.v1beta1.ReportErrorsService/ReportErrorEvent",
+            request_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_report__errors__service__pb2.ReportErrorEventRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_report__errors__service__pb2.ReportErrorEventResponse.FromString,
+        )
+
+
+class ReportErrorsServiceServicer(object):
+    """An API for reporting error events.
+  """
+
+    def ReportErrorEvent(self, request, context):
+        """Report an individual error event.
+
+    This endpoint accepts <strong>either</strong> an OAuth token,
+    <strong>or</strong> an
+    <a href="https://support.google.com/cloud/answer/6158862">API key</a>
+    for authentication. To use an API key, append it to the URL as the value of
+    a `key` parameter. For example:
+    <pre>POST
+    https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/events:report?key=123ABC456</pre>
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ReportErrorsServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ReportErrorEvent": grpc.unary_unary_rpc_method_handler(
+            servicer.ReportErrorEvent,
+            request_deserializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_report__errors__service__pb2.ReportErrorEventRequest.FromString,
+            response_serializer=google_dot_devtools_dot_clouderrorreporting__v1beta1_dot_proto_dot_report__errors__service__pb2.ReportErrorEventResponse.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.devtools.clouderrorreporting.v1beta1.ReportErrorsService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/proto/synth.metadata b/error_reporting/google/cloud/errorreporting_v1beta1/proto/synth.metadata
new file mode 100644
index 000000000000..aa85442f198e
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/proto/synth.metadata
@@ -0,0 +1,3 @@
+{
+  "updateTime": "2019-01-23T23:03:31.526988Z"
+}
\ No newline at end of file
diff --git a/error_reporting/google/cloud/errorreporting_v1beta1/types.py b/error_reporting/google/cloud/errorreporting_v1beta1/types.py
new file mode 100644
index 000000000000..388e69bbad78
--- /dev/null
+++ b/error_reporting/google/cloud/errorreporting_v1beta1/types.py
@@ -0,0 +1,57 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.api import label_pb2
+from google.api import monitored_resource_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    label_pb2,
+    monitored_resource_pb2,
+    report_errors_service_pb2,
+    descriptor_pb2,
+    duration_pb2,
+    timestamp_pb2,
+]
+
+_local_modules = [common_pb2, error_group_service_pb2, error_stats_service_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.errorreporting_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/error_reporting/noxfile.py b/error_reporting/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/error_reporting/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/error_reporting/pylint.config.py b/error_reporting/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/error_reporting/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/error_reporting/setup.cfg b/error_reporting/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/error_reporting/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/error_reporting/setup.py b/error_reporting/setup.py
new file mode 100644
index 000000000000..da91c2707903
--- /dev/null
+++ b/error_reporting/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-error-reporting"
+description = "Stackdriver Error Reporting API client library"
+version = "0.32.1"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-cloud-logging>=1.11.0, <2.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/error_reporting/synth.metadata b/error_reporting/synth.metadata
new file mode 100644
index 000000000000..ab416d10e320
--- /dev/null
+++ b/error_reporting/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:24:11.470016Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "errorreporting",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/devtools/clouderrorreporting/artman_errorreporting.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/error_reporting/synth.py b/error_reporting/synth.py
new file mode 100644
index 000000000000..6c34630d506e
--- /dev/null
+++ b/error_reporting/synth.py
@@ -0,0 +1,69 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate error_reporting GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "errorreporting",
+    "v1beta1",
+    config_path="/google/devtools/clouderrorreporting" "/artman_errorreporting.yaml",
+    artman_output_name="error-reporting-v1beta1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/errorreporting_v1beta1/proto")
+s.move(library / "google/cloud/errorreporting_v1beta1/gapic")
+s.move(library / "tests/unit/gapic/v1beta1")
+s.move(library / "tests/system/gapic/v1beta1")
+
+# Fix up imports
+s.replace(
+    "google/**/*.py",
+    r"from google.devtools.clouderrorreporting_v1beta1.proto import ",
+    r"from google.cloud.errorreporting_v1beta1.proto import ",
+)
+
+# Fix up docstrings in GAPIC clients
+DISCARD_AUTH_BOILERPLATE = r"""
+        This endpoint accepts either an OAuth token, or an API key for
+        authentication. To use an API key, append it to the URL as the value of
+        a ``key`` parameter. For example:
+
+        \.\. raw:: html
+        <pre>POST
+            .*</pre>
+"""
+
+targets = [
+    "google/cloud/errorreporting_v1beta1/gapic/*_client.py",
+    "google/cloud/errorreporting_v1beta1/gapic/transports/*_transport.py",
+]
+
+s.replace(targets, DISCARD_AUTH_BOILERPLATE, r"")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/error_reporting/tests/__init__.py b/error_reporting/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/error_reporting/tests/system/gapic/v1beta1/test_system_report_errors_service_v1beta1.py b/error_reporting/tests/system/gapic/v1beta1/test_system_report_errors_service_v1beta1.py
new file mode 100644
index 000000000000..bb4239282d68
--- /dev/null
+++ b/error_reporting/tests/system/gapic/v1beta1/test_system_report_errors_service_v1beta1.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import errorreporting_v1beta1
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2
+
+
+class TestSystemReportErrorsService(object):
+    def test_report_error_event(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = errorreporting_v1beta1.ReportErrorsServiceClient()
+        project_name = client.project_path(project_id)
+        message = "[MESSAGE]"
+        service = "[SERVICE]"
+        service_context = {"service": service}
+        file_path = "path/to/file.lang"
+        line_number = 42
+        function_name = "meaningOfLife"
+        report_location = {
+            "file_path": file_path,
+            "line_number": line_number,
+            "function_name": function_name,
+        }
+        context = {"report_location": report_location}
+        event = {
+            "message": message,
+            "service_context": service_context,
+            "context": context,
+        }
+        response = client.report_error_event(project_name, event)
diff --git a/error_reporting/tests/system/test_system.py b/error_reporting/tests/system/test_system.py
new file mode 100644
index 000000000000..b72223e2ae0a
--- /dev/null
+++ b/error_reporting/tests/system/test_system.py
@@ -0,0 +1,124 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+import operator
+import unittest
+
+from google.cloud import error_reporting
+from google.cloud.errorreporting_v1beta1.gapic import error_stats_service_client
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2
+from google.protobuf.duration_pb2 import Duration
+
+from test_utils.retry import RetryResult
+from test_utils.system import unique_resource_id
+
+
+ERROR_MSG = "Stackdriver Error Reporting System Test"
+
+
+def setUpModule():
+    Config.CLIENT = error_reporting.Client()
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+
+
+def _list_groups(client):
+    """List Error Groups from the last 60 seconds.
+
+    This class provides a wrapper around making calls to the GAX
+    API. It's used by the system tests to find the appropriate error group
+    to verify the error was successfully reported.
+
+    :type client: :class:`~google.cloud.error_reporting.client.Client`
+    :param client: The client containing a project and credentials.
+
+    :rtype: :class:`~google.gax.ResourceIterator`
+    :returns: Iterable of :class:`~.error_stats_service_pb2.ErrorGroupStats`.
+    """
+    gax_api = error_stats_service_client.ErrorStatsServiceClient(
+        credentials=client._credentials
+    )
+    project_name = gax_api.project_path(client.project)
+
+    time_range = error_stats_service_pb2.QueryTimeRange()
+    time_range.period = error_stats_service_pb2.QueryTimeRange.PERIOD_1_HOUR
+
+    duration = Duration(seconds=60 * 60)
+
+    return gax_api.list_group_stats(
+        project_name, time_range, timed_count_duration=duration
+    )
+
+
+def _simulate_exception(class_name, client):
+    """Simulates an exception to verify it was reported.
+
+    :type class_name: str
+    :param class_name: The name of a custom error class to
+                       create (and raise).
+
+    :type client: :class:`~google.cloud.error_reporting.client.Client`
+    :param client: The client that will report the exception.
+    """
+    custom_exc = type(class_name, (RuntimeError,), {})
+    try:
+        raise custom_exc(ERROR_MSG)
+    except RuntimeError:
+        client.report_exception()
+
+
+def _get_error_count(class_name, client):
+    """Counts the number of errors in the group of the test exception.
+
+    :type class_name: str
+    :param class_name: The name of a custom error class used.
+
+    :type client: :class:`~google.cloud.error_reporting.client.Client`
+    :param client: The client containing a project and credentials.
+
+    :rtype: int
+    :returns: Group count for errors that match ``class_name``. If no
+              match is found, returns :data:`None`.
+    """
+    groups = _list_groups(client)
+    for group in groups:
+        if class_name in group.representative.message:
+            return group.count
+
+
+class TestErrorReporting(unittest.TestCase):
+    def test_report_exception(self):
+        # Get a class name unique to this test case.
+        class_name = "RuntimeError" + unique_resource_id("_")
+
+        # Simulate an error: group won't exist until we report
+        # first exception.
+        _simulate_exception(class_name, Config.CLIENT)
+
+        is_one = functools.partial(operator.eq, 1)
+        is_one.__name__ = "is_one"  # partial() has no name.
+        retry = RetryResult(is_one, max_tries=6)
+        wrapped_get_count = retry(_get_error_count)
+
+        error_count = wrapped_get_count(class_name, Config.CLIENT)
+        self.assertEqual(error_count, 1)
diff --git a/error_reporting/tests/unit/__init__.py b/error_reporting/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/error_reporting/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/error_reporting/tests/unit/gapic/v1beta1/test_error_group_service_client_v1beta1.py b/error_reporting/tests/unit/gapic/v1beta1/test_error_group_service_client_v1beta1.py
new file mode 100644
index 000000000000..d65f3f1f7527
--- /dev/null
+++ b/error_reporting/tests/unit/gapic/v1beta1/test_error_group_service_client_v1beta1.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import errorreporting_v1beta1
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_group_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestErrorGroupServiceClient(object):
+    def test_get_group(self):
+        # Setup Expected Response
+        name = "name3373707"
+        group_id = "groupId506361563"
+        expected_response = {"name": name, "group_id": group_id}
+        expected_response = common_pb2.ErrorGroup(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorGroupServiceClient()
+
+        # Setup Request
+        group_name = client.group_path("[PROJECT]", "[GROUP]")
+
+        response = client.get_group(group_name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = error_group_service_pb2.GetGroupRequest(
+            group_name=group_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_group_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorGroupServiceClient()
+
+        # Setup request
+        group_name = client.group_path("[PROJECT]", "[GROUP]")
+
+        with pytest.raises(CustomException):
+            client.get_group(group_name)
+
+    def test_update_group(self):
+        # Setup Expected Response
+        name = "name3373707"
+        group_id = "groupId506361563"
+        expected_response = {"name": name, "group_id": group_id}
+        expected_response = common_pb2.ErrorGroup(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorGroupServiceClient()
+
+        # Setup Request
+        group = {}
+
+        response = client.update_group(group)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = error_group_service_pb2.UpdateGroupRequest(group=group)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_group_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorGroupServiceClient()
+
+        # Setup request
+        group = {}
+
+        with pytest.raises(CustomException):
+            client.update_group(group)
diff --git a/error_reporting/tests/unit/gapic/v1beta1/test_error_stats_service_client_v1beta1.py b/error_reporting/tests/unit/gapic/v1beta1/test_error_stats_service_client_v1beta1.py
new file mode 100644
index 000000000000..dc09b13fc1b1
--- /dev/null
+++ b/error_reporting/tests/unit/gapic/v1beta1/test_error_stats_service_client_v1beta1.py
@@ -0,0 +1,207 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import errorreporting_v1beta1
+from google.cloud.errorreporting_v1beta1.proto import common_pb2
+from google.cloud.errorreporting_v1beta1.proto import error_stats_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestErrorStatsServiceClient(object):
+    def test_list_group_stats(self):
+        # Setup Expected Response
+        next_page_token = ""
+        error_group_stats_element = {}
+        error_group_stats = [error_group_stats_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "error_group_stats": error_group_stats,
+        }
+        expected_response = error_stats_service_pb2.ListGroupStatsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorStatsServiceClient()
+
+        # Setup Request
+        project_name = client.project_path("[PROJECT]")
+        time_range = {}
+
+        paged_list_response = client.list_group_stats(project_name, time_range)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.error_group_stats[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = error_stats_service_pb2.ListGroupStatsRequest(
+            project_name=project_name, time_range=time_range
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_group_stats_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorStatsServiceClient()
+
+        # Setup request
+        project_name = client.project_path("[PROJECT]")
+        time_range = {}
+
+        paged_list_response = client.list_group_stats(project_name, time_range)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_events(self):
+        # Setup Expected Response
+        next_page_token = ""
+        error_events_element = {}
+        error_events = [error_events_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "error_events": error_events,
+        }
+        expected_response = error_stats_service_pb2.ListEventsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorStatsServiceClient()
+
+        # Setup Request
+        project_name = client.project_path("[PROJECT]")
+        group_id = "groupId506361563"
+
+        paged_list_response = client.list_events(project_name, group_id)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.error_events[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = error_stats_service_pb2.ListEventsRequest(
+            project_name=project_name, group_id=group_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_events_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorStatsServiceClient()
+
+        # Setup request
+        project_name = client.project_path("[PROJECT]")
+        group_id = "groupId506361563"
+
+        paged_list_response = client.list_events(project_name, group_id)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_events(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = error_stats_service_pb2.DeleteEventsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorStatsServiceClient()
+
+        # Setup Request
+        project_name = client.project_path("[PROJECT]")
+
+        response = client.delete_events(project_name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = error_stats_service_pb2.DeleteEventsRequest(
+            project_name=project_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_events_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ErrorStatsServiceClient()
+
+        # Setup request
+        project_name = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.delete_events(project_name)
diff --git a/error_reporting/tests/unit/gapic/v1beta1/test_report_errors_service_client_v1beta1.py b/error_reporting/tests/unit/gapic/v1beta1/test_report_errors_service_client_v1beta1.py
new file mode 100644
index 000000000000..ef85fa15051a
--- /dev/null
+++ b/error_reporting/tests/unit/gapic/v1beta1/test_report_errors_service_client_v1beta1.py
@@ -0,0 +1,104 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import errorreporting_v1beta1
+from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestReportErrorsServiceClient(object):
+    def test_report_error_event(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = report_errors_service_pb2.ReportErrorEventResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ReportErrorsServiceClient()
+
+        # Setup Request
+        project_name = client.project_path("[PROJECT]")
+        event = {}
+
+        response = client.report_error_event(project_name, event)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = report_errors_service_pb2.ReportErrorEventRequest(
+            project_name=project_name, event=event
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_report_error_event_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = errorreporting_v1beta1.ReportErrorsServiceClient()
+
+        # Setup request
+        project_name = client.project_path("[PROJECT]")
+        event = {}
+
+        with pytest.raises(CustomException):
+            client.report_error_event(project_name, event)
diff --git a/error_reporting/tests/unit/test__gapic.py b/error_reporting/tests/unit/test__gapic.py
new file mode 100644
index 000000000000..836f46b82495
--- /dev/null
+++ b/error_reporting/tests/unit/test__gapic.py
@@ -0,0 +1,78 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class Test_make_report_error_api(unittest.TestCase):
+    @staticmethod
+    def _call_fut(client):
+        from google.cloud.error_reporting._gapic import make_report_error_api
+
+        return make_report_error_api(client)
+
+    def test_make_report_error_api(self):
+        client = mock.Mock(spec=["project", "_credentials", "_client_info"])
+
+        # Call the function being tested.
+        patch = mock.patch(
+            "google.cloud.errorreporting_v1beta1."
+            "gapic.report_errors_service_client.ReportErrorsServiceClient"
+        )
+
+        with patch as patched:
+            report_error_client = self._call_fut(client)
+
+        # Assert that the final error client has the project in
+        # the expected location.
+        self.assertIs(report_error_client._project, client.project)
+        self.assertIs(report_error_client._gapic_api, patched.return_value)
+        patched.assert_called_once_with(
+            credentials=client._credentials, client_info=client._client_info
+        )
+
+
+class Test_ErrorReportingGapicApi(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+
+    def _make_one(self, gapic_api, project):
+        from google.cloud.error_reporting._gapic import _ErrorReportingGapicApi
+
+        return _ErrorReportingGapicApi(gapic_api, project)
+
+    def test_constructor(self):
+        gapic_api = mock.Mock(spec=[])
+        gapic_client_wrapper = self._make_one(gapic_api, self.PROJECT)
+
+        self.assertEqual(gapic_client_wrapper._project, self.PROJECT)
+        self.assertEqual(gapic_client_wrapper._gapic_api, gapic_api)
+
+    def test_report_error_event(self):
+        from google.cloud.errorreporting_v1beta1.proto import report_errors_service_pb2
+
+        gapic_api = mock.Mock(spec=["project_path", "report_error_event"])
+        gapic_client_wrapper = self._make_one(gapic_api, self.PROJECT)
+
+        error_report = {"message": "The cabs are here."}
+        gapic_client_wrapper.report_error_event(error_report)
+
+        gapic_api.project_path.assert_called_once_with(self.PROJECT)
+        project_name = gapic_api.project_path.return_value
+        error_pb = report_errors_service_pb2.ReportedErrorEvent(
+            message=error_report["message"]
+        )
+        gapic_api.report_error_event.assert_called_once_with(project_name, error_pb)
diff --git a/error_reporting/tests/unit/test__logging.py b/error_reporting/tests/unit/test__logging.py
new file mode 100644
index 000000000000..e2b0638b986e
--- /dev/null
+++ b/error_reporting/tests/unit/test__logging.py
@@ -0,0 +1,74 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class Test_ErrorReportingLoggingAPI(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+
+    def _make_one(self, project, credentials, **kw):
+        from google.cloud.error_reporting._logging import _ErrorReportingLoggingAPI
+
+        return _ErrorReportingLoggingAPI(project, credentials, **kw)
+
+    @mock.patch("google.cloud.logging.client.Client")
+    def test_ctor_defaults(self, mocked_cls):
+        credentials = _make_credentials()
+
+        logging_api = self._make_one(self.PROJECT, credentials)
+
+        self.assertIs(logging_api.logging_client, mocked_cls.return_value)
+        mocked_cls.assert_called_once_with(
+            self.PROJECT, credentials, _http=None, client_info=None
+        )
+
+    @mock.patch("google.cloud.logging.client.Client")
+    def test_ctor_explicit(self, mocked_cls):
+        credentials = _make_credentials()
+        http = mock.Mock()
+        client_info = mock.Mock()
+
+        logging_api = self._make_one(
+            self.PROJECT, credentials, _http=http, client_info=client_info
+        )
+
+        self.assertIs(logging_api.logging_client, mocked_cls.return_value)
+        mocked_cls.assert_called_once_with(
+            self.PROJECT, credentials, _http=http, client_info=client_info
+        )
+
+    @mock.patch("google.cloud.logging.client.Client")
+    def test_report_error_event(self, mocked_cls):
+        credentials = _make_credentials()
+        logging_api = self._make_one(self.PROJECT, credentials)
+
+        logger = mock.Mock(spec=["log_struct"])
+        logging_api.logging_client.logger.return_value = logger
+
+        # Actually make the API call.
+        error_report = {"message": "The cabs are here."}
+        logging_api.report_error_event(error_report)
+
+        # Check the mocks.
+        logger.log_struct.assert_called_once_with(error_report)
diff --git a/error_reporting/tests/unit/test_client.py b/error_reporting/tests/unit/test_client.py
new file mode 100644
index 000000000000..5e4dc925a65f
--- /dev/null
+++ b/error_reporting/tests/unit/test_client.py
@@ -0,0 +1,215 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    SERVICE = "SERVICE"
+    VERSION = "myversion"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.error_reporting.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _make_http(self, *args, **kw):
+        from google.cloud.error_reporting.client import HTTPContext
+
+        return HTTPContext(*args, **kw)
+
+    def _get_report_payload(self, error_api):
+        self.assertEqual(error_api.report_error_event.call_count, 1)
+        call = error_api.report_error_event.mock_calls[0]
+        _, positional, kwargs = call
+        self.assertEqual(kwargs, {})
+        self.assertEqual(len(positional), 1)
+        return positional[0]
+
+    @mock.patch("google.cloud.client._determine_default_project")
+    def test_ctor_defaults(self, default_mock):
+        from google.api_core.client_info import ClientInfo
+
+        credentials = _make_credentials()
+        default_mock.return_value = "foo"
+        client = self._make_one(credentials=credentials)
+        self.assertEqual(client.service, client.DEFAULT_SERVICE)
+        self.assertEqual(client.version, None)
+        self.assertIsInstance(client._client_info, ClientInfo)
+        default_mock.assert_called_once_with(None)
+
+    def test_ctor_explicit(self):
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            service=self.SERVICE,
+            version=self.VERSION,
+            client_info=client_info,
+        )
+        self.assertEqual(client.service, self.SERVICE)
+        self.assertEqual(client.version, self.VERSION)
+        self.assertIs(client._client_info, client_info)
+
+    def test_report_errors_api_already(self):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        client._report_errors_api = already = mock.Mock()
+        self.assertIs(client.report_errors_api, already)
+
+    def test_report_errors_api_wo_grpc(self):
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        http = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            client_info=client_info,
+            _http=http,
+            _use_grpc=False,
+        )
+        patch = mock.patch(
+            "google.cloud.error_reporting.client._ErrorReportingLoggingAPI"
+        )
+
+        with patch as patched:
+            api = client.report_errors_api
+
+        self.assertIs(api, patched.return_value)
+        patched.assert_called_once_with(self.PROJECT, credentials, http, client_info)
+
+    def test_report_errors_api_w_grpc(self):
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=True
+        )
+        patch = mock.patch("google.cloud.error_reporting.client.make_report_error_api")
+
+        with patch as patched:
+            api = client.report_errors_api
+
+        self.assertIs(api, patched.return_value)
+        patched.assert_called_once_with(client)
+
+    def test_report_exception_with_grpc(self):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        patch = mock.patch("google.cloud.error_reporting.client.make_report_error_api")
+        with patch as make_api:
+            try:
+                raise NameError
+            except NameError:
+                client.report_exception()
+            payload = make_api.return_value.report_error_event.call_args[0][0]
+            make_api.assert_called_once_with(client)
+
+        self.assertEqual(payload["serviceContext"], {"service": client.DEFAULT_SERVICE})
+        self.assertIn("test_report", payload["message"])
+        self.assertIn("test_client.py", payload["message"])
+
+    def test_report_exception_wo_grpc(self):
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=False
+        )
+        patch = mock.patch(
+            "google.cloud.error_reporting.client._ErrorReportingLoggingAPI"
+        )
+        with patch as _error_api:
+            try:
+                raise NameError
+            except NameError:
+                client.report_exception()
+            mock_report = _error_api.return_value.report_error_event
+            payload = mock_report.call_args[0][0]
+
+        self.assertEqual(payload["serviceContext"], {"service": client.DEFAULT_SERVICE})
+        self.assertIn("test_report", payload["message"])
+        self.assertIn("test_client.py", payload["message"])
+        self.assertIsNotNone(client.report_errors_api)
+
+    @mock.patch("google.cloud.error_reporting.client.make_report_error_api")
+    def test_report_exception_with_service_version_in_constructor(self, make_api):
+        credentials = _make_credentials()
+        service = "notdefault"
+        version = "notdefaultversion"
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            service=service,
+            version=version,
+        )
+
+        http_context = self._make_http(method="GET", response_status_code=500)
+        user = "user@gmail.com"
+
+        error_api = mock.Mock(spec=["report_error_event"])
+        make_api.return_value = error_api
+
+        try:
+            raise NameError
+        except NameError:
+            client.report_exception(http_context=http_context, user=user)
+
+        make_api.assert_called_once_with(client)
+
+        payload = self._get_report_payload(error_api)
+        self.assertEqual(
+            payload["serviceContext"], {"service": service, "version": version}
+        )
+        self.assertIn(
+            "test_report_exception_with_service_version_in_constructor",
+            payload["message"],
+        )
+        self.assertIn("test_client.py", payload["message"])
+        self.assertEqual(payload["context"]["httpRequest"]["responseStatusCode"], 500)
+        self.assertEqual(payload["context"]["httpRequest"]["method"], "GET")
+        self.assertEqual(payload["context"]["user"], user)
+
+    @mock.patch("google.cloud.error_reporting.client.make_report_error_api")
+    def test_report(self, make_api):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        error_api = mock.Mock(spec=["report_error_event"])
+        make_api.return_value = error_api
+
+        message = "this is an error"
+        client.report(message)
+
+        payload = self._get_report_payload(error_api)
+
+        self.assertEqual(payload["message"], message)
+        report_location = payload["context"]["reportLocation"]
+        self.assertIn("test_client.py", report_location["filePath"])
+        self.assertEqual(report_location["functionName"], "test_report")
+        self.assertGreater(report_location["lineNumber"], 100)
+        self.assertLess(report_location["lineNumber"], 250)
diff --git a/error_reporting/tests/unit/test_util.py b/error_reporting/tests/unit/test_util.py
new file mode 100644
index 000000000000..cd48f3f8d3ad
--- /dev/null
+++ b/error_reporting/tests/unit/test_util.py
@@ -0,0 +1,46 @@
+# Copyright 2016 Google LLC 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.
+
+import unittest
+
+
+class Test_build_flask_context(unittest.TestCase):
+    def _call_fut(self, request):
+        from google.cloud.error_reporting.util import build_flask_context
+
+        return build_flask_context(request)
+
+    def test_flask_helper(self):
+        import mock
+
+        user_agent = mock.Mock(string="Google Cloud Unit Tests Agent")
+        request = _Request(
+            "http://google.com", "GET", user_agent, "http://gmail.com", "127.0.0.1"
+        )
+
+        context = self._call_fut(request)
+        self.assertEqual(request.url, context.url)
+        self.assertEqual(request.method, context.method)
+        self.assertEqual(request.user_agent.string, context.userAgent)
+        self.assertEqual(request.referrer, context.referrer)
+        self.assertEqual(request.remote_addr, context.remoteIp)
+
+
+class _Request(object):
+    def __init__(self, url, method, user_agent, referrer, remote_addr):
+        self.url = url
+        self.method = method
+        self.user_agent = user_agent
+        self.referrer = referrer
+        self.remote_addr = remote_addr
diff --git a/firestore/.coveragerc b/firestore/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/firestore/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/firestore/.flake8 b/firestore/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/firestore/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/firestore/.repo-metadata.json b/firestore/.repo-metadata.json
new file mode 100644
index 000000000000..6a3e669fce83
--- /dev/null
+++ b/firestore/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "firestore",
+  "name_pretty": "Cloud Firestore",
+  "product_documentation": "https://cloud.google.com/firestore",
+  "client_documentation": "https://googleapis.dev/python/firestore/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5337669",
+  "release_level": "beta",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-firestore",
+  "api_id": "firestore.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/firestore/CHANGELOG.md b/firestore/CHANGELOG.md
new file mode 100644
index 000000000000..918252cd8628
--- /dev/null
+++ b/firestore/CHANGELOG.md
@@ -0,0 +1,288 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-firestore/#history
+
+
+## 1.4.0
+
+08-06-2019 11:43 PDT
+
+### New Features
+- Support emulator in client. ([#8721](https://github.com/googleapis/google-cloud-python/pull/8721))
+- Add GAPIC client for Admin V1. ([#8667](https://github.com/googleapis/google-cloud-python/pull/8667))
+- Add `Transaction.get` / `Transaction.get_all`. ([#8628](https://github.com/googleapis/google-cloud-python/pull/8628))
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8955](https://github.com/googleapis/google-cloud-python/pull/8955))
+- Deprecate `v1beta1` API / client. ([#8886](https://github.com/googleapis/google-cloud-python/pull/8886))
+- Allow snapshot cursors from other collections for collection group queries. ([#8882](https://github.com/googleapis/google-cloud-python/pull/8882))
+- Fix sorting `delete_changes` in `Watch._compute_snapshot`. ([#8809](https://github.com/googleapis/google-cloud-python/pull/8809))
+- Treat `None` as EOF in `Watch.on_snapshot`. ([#8687](https://github.com/googleapis/google-cloud-python/pull/8687))
+- Fix V1 `Client.collections` method. ([#8718](https://github.com/googleapis/google-cloud-python/pull/8718))
+- Avoid adding `prefix` to update mask for transforms used in `update`. ([#8701](https://github.com/googleapis/google-cloud-python/pull/8701))
+- Add `should_terminate` predicate for clean BiDi shutdown. ([#8650](https://github.com/googleapis/google-cloud-python/pull/8650))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Preserve manual change in noxfile (run systests verbosely). ([#8744](https://github.com/googleapis/google-cloud-python/pull/8744))
+- Update V1 conformance tests to match new repo / format. ([#8689](https://github.com/googleapis/google-cloud-python/pull/8689))
+- Improve cleanups for `watch` system tests. ([#8638](https://github.com/googleapis/google-cloud-python/pull/8638))
+- Avoid sharing top-level collection across test cases / CI runs. ([#8637](https://github.com/googleapis/google-cloud-python/pull/8637))
+
+## 1.3.0
+
+07-09-2019 13:19 PDT
+
+
+### Implementation Changes
+- Add missing transforms to 'google.cloud.firestore' shim. ([#8481](https://github.com/googleapis/google-cloud-python/pull/8481))
+- Preserve reference to missing documents in 'Client.get_all'. ([#8472](https://github.com/googleapis/google-cloud-python/pull/8472))
+- Add gRPC keepalive to gapic client initialization. ([#8264](https://github.com/googleapis/google-cloud-python/pull/8264))
+- Add disclaimer to auto-generated template files. ([#8314](https://github.com/googleapis/google-cloud-python/pull/8314))
+- Use correct environment variable to guard the 'system' part. ([#7912](https://github.com/googleapis/google-cloud-python/pull/7912))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8509](https://github.com/googleapis/google-cloud-python/pull/8509))
+- Allow kwargs to be passed to create_channel (via synth). ([#8390](https://github.com/googleapis/google-cloud-python/pull/8390))
+- Add 'FieldPath.documentId()'. ([#8543](https://github.com/googleapis/google-cloud-python/pull/8543))
+
+### Documentation
+- Fix docstring example for 'Client.collection_group'. ([#8438](https://github.com/googleapis/google-cloud-python/pull/8438))
+- Normalize docstring class refs. ([#8102](https://github.com/googleapis/google-cloud-python/pull/8102))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8583](https://github.com/googleapis/google-cloud-python/pull/8583))
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8352](https://github.com/googleapis/google-cloud-python/pull/8352))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8241](https://github.com/googleapis/google-cloud-python/pull/8241))
+- Blacken noxfile.py, setup.py (via synth). ([#8123](https://github.com/googleapis/google-cloud-python/pull/8123))
+- Add empty lines (via synth). ([#8058](https://github.com/googleapis/google-cloud-python/pull/8058))
+
+## 1.2.0
+
+05-16-2019 12:25 PDT
+
+
+### New Features
+- Add support for numeric transforms: `increment` / `maximum` / `minimum`. ([#7989](https://github.com/googleapis/google-cloud-python/pull/7989))
+- Add `client_info` support to V1 client. ([#7877](https://github.com/googleapis/google-cloud-python/pull/7877)) and ([#7898](https://github.com/googleapis/google-cloud-python/pull/7898))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Internal / Testing Changes
+- Add nox session `docs`,  add routing header to method metadata, reorder methods (via synth).. ([#7771](https://github.com/googleapis/google-cloud-python/pull/7771))
+
+## 1.1.0
+
+04-30-2019 12:29 PDT
+
+
+### New Features
+- Add support for CollectionGroup queries. ([#7758](https://github.com/googleapis/google-cloud-python/pull/7758))
+
+## 1.0.0
+
+04-30-2019 10:00 PDT
+
+### Implementation Changes
+- Use parent path for watch on queries. ([#7752](https://github.com/googleapis/google-cloud-python/pull/7752))
+- Add routing header to method metadata (via synth). ([#7749](https://github.com/googleapis/google-cloud-python/pull/7749))
+
+## 0.32.1
+
+04-05-2019 10:51 PDT
+
+
+### Dependencies
+- Update google-api-core dependency
+
+## 0.32.0
+
+04-01-2019 11:44 PDT
+
+
+### Implementation Changes
+- Allow passing metadata as part of creating a bidi ([#7514](https://github.com/googleapis/google-cloud-python/pull/7514))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Rename 'Query.get' -> 'stream'. ([#7284](https://github.com/googleapis/google-cloud-python/pull/7284))
+- Remove bogus error checking of query response stream. ([#7206](https://github.com/googleapis/google-cloud-python/pull/7206))
+-'increment' / 'minimum' / 'maximum' field transform attributes. ([#7129](https://github.com/googleapis/google-cloud-python/pull/7129))
+- Respect transform values passed into collection.add ([#7072](https://github.com/googleapis/google-cloud-python/pull/7072))
+- Protoc-generated serialization update. ([#7083](https://github.com/googleapis/google-cloud-python/pull/7083))
+
+### New Features
+- Firestore: Add v1 API version. ([#7494](https://github.com/googleapis/google-cloud-python/pull/7494))
+- Add 'Collection.list_documents' method. ([#7221](https://github.com/googleapis/google-cloud-python/pull/7221))
+- Add 'DocumentReference.path' property. ([#7219](https://github.com/googleapis/google-cloud-python/pull/7219))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Fix the docstring example for 'Query.on_snapshot'.  ([#7281](https://github.com/googleapis/google-cloud-python/pull/7281))
+- Update copyright headers
+
+### Internal / Testing Changes
+- Fix typo in proto comments (via synth).
+- Prep firestore unit tests for generation from 'v1' protos. ([#7437](https://github.com/googleapis/google-cloud-python/pull/7437))
+- Copy lintified proto files (via synth). ([#7466](https://github.com/googleapis/google-cloud-python/pull/7466))
+- Add clarifying comment to blacken nox target. ([#7392](https://github.com/googleapis/google-cloud-python/pull/7392))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.31.0
+
+12-18-2018 11:20 PST
+
+
+### Implementation Changes
+- Implement equality semantics for public types ([#6916](https://github.com/googleapis/google-cloud-python/pull/6916))
+- Pick up stub docstring fix in GAPIC generator. ([#6988](https://github.com/googleapis/google-cloud-python/pull/6988))
+- Use 'DatetimeWithNanos' for converting timestamp messages. ([#6920](https://github.com/googleapis/google-cloud-python/pull/6920))
+- Enable use of 'WriteBatch' as a context manager. ([#6912](https://github.com/googleapis/google-cloud-python/pull/6912))
+- Document timeouts for 'Query.get' / 'Collection.get'. ([#6853](https://github.com/googleapis/google-cloud-python/pull/6853))
+- Normalize FieldPath parsing / escaping ([#6904](https://github.com/googleapis/google-cloud-python/pull/6904))
+- For queries ordered on `__name__`, expand field values to full paths. ([#6829](https://github.com/googleapis/google-cloud-python/pull/6829))
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Prevent use of transforms as values passed to 'Query.where'. ([#6703](https://github.com/googleapis/google-cloud-python/pull/6703))
+- 'Query.select([])' implies `__name__`. ([#6735](https://github.com/googleapis/google-cloud-python/pull/6735))
+- Reject invalid paths passed to 'Query.{select,where,order_by}' ([#6770](https://github.com/googleapis/google-cloud-python/pull/6770))
+- Prevent use of transforms as cursor values. ([#6706](https://github.com/googleapis/google-cloud-python/pull/6706))
+- Refactor 'Document.get' to use the 'GetDocument' API. ([#6534](https://github.com/googleapis/google-cloud-python/pull/6534))
+- Pick up enum fixes in the GAPIC generator. ([#6612](https://github.com/googleapis/google-cloud-python/pull/6612))
+- Pick up changes to GAPIC client config. ([#6589](https://github.com/googleapis/google-cloud-python/pull/6589))
+- Suppress deprecation warnings for 'assertRaisesRegexp'. ([#6543](https://github.com/googleapis/google-cloud-python/pull/6543))
+- Firestore: pick up fixes to GAPIC generator. ([#6523](https://github.com/googleapis/google-cloud-python/pull/6523))
+- Fix `client_info` bug, update docstrings. ([#6412](https://github.com/googleapis/google-cloud-python/pull/6412))
+- Block calling 'DocumentRef.get()' with a single string. ([#6270](https://github.com/googleapis/google-cloud-python/pull/6270))
+
+### New Features
+- Impose required semantics for snapshots as cursors: ([#6837](https://github.com/googleapis/google-cloud-python/pull/6837))
+- Make cursor-related 'Query' methods accept lists ([#6697](https://github.com/googleapis/google-cloud-python/pull/6697))
+- Add 'Client.collections' method. ([#6650](https://github.com/googleapis/google-cloud-python/pull/6650))
+- Add support for 'ArrayRemove' / 'ArrayUnion' transforms ([#6651](https://github.com/googleapis/google-cloud-python/pull/6651))
+- Add support for `array_contains` query operator. ([#6481](https://github.com/googleapis/google-cloud-python/pull/6481))
+- Add Watch Support ([#6191](https://github.com/googleapis/google-cloud-python/pull/6191))
+- Remove use of deprecated 'channel' argument. ([#6271](https://github.com/googleapis/google-cloud-python/pull/6271))
+
+### Dependencies
+- Pin 'google-api_core >= 1.7.0'. ([#6937](https://github.com/googleapis/google-cloud-python/pull/6937))
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Nnormalize docs for `page_size` / `max_results` / `page_token`. ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+- Port changelog from 30.1 branch to master ([#6903](https://github.com/googleapis/google-cloud-python/pull/6903))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Add driver for listen conformance tests. ([#6935](https://github.com/googleapis/google-cloud-python/pull/6935))
+- Add driver for query conformance tests. ([#6839](https://github.com/googleapis/google-cloud-python/pull/6839))
+- Update noxfile.
+- Blacken libraries ([#6794](https://github.com/googleapis/google-cloud-python/pull/6794))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Fix delete conformance ([#6559](https://github.com/googleapis/google-cloud-python/pull/6559))
+- Add synth metadata. ([#6567](https://github.com/googleapis/google-cloud-python/pull/6567))
+- Refactor conformance tests. ([#6291](https://github.com/googleapis/google-cloud-python/pull/6291))
+- Import stdlib ABCs from 'collections.abc' rather than 'collections'. ([#6451](https://github.com/googleapis/google-cloud-python/pull/6451))
+- Fix path of tests-to-include in MANIFEST.in ([#6381](https://github.com/googleapis/google-cloud-python/pull/6381))
+- Fix error from new flake8 version. ([#6320](https://github.com/googleapis/google-cloud-python/pull/6320))
+
+## 0.30.1
+
+12-11-2018 10:49 PDT
+ 
+
+### Dependencies
+- Update `core` and `api_core` dependencies to latest versions.
+
+## 0.30.0
+
+10-15-2018 09:04 PDT
+
+
+### New Features
+- Add `Document.collections` method. ([#5613](https://github.com/googleapis/google-cloud-python/pull/5613))
+- Add `merge` as an option to `DocumentReference.set()` ([#4851](https://github.com/googleapis/google-cloud-python/pull/4851))
+- Return emtpy snapshot instead of raising NotFound exception ([#5007](https://github.com/googleapis/google-cloud-python/pull/5007))
+- Add Field path class ([#4392](https://github.com/googleapis/google-cloud-python/pull/4392))
+
+### Implementation Changes
+- Avoid overwriting `__module__` of messages from shared modules. ([#5364](https://github.com/googleapis/google-cloud-python/pull/5364))
+- Don't omit originally-empty map values when processing timestamps. ([#6050](https://github.com/googleapis/google-cloud-python/pull/6050))
+
+### Documentation
+- Prep docs for repo split. ([#6000](https://github.com/googleapis/google-cloud-python/pull/6000))
+- Docs: Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+- Document `FieldPath.from_string` ([#5121](https://github.com/googleapis/google-cloud-python/pull/5121))
+
+### Internal / Testing Changes
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add new conformance tests. ([#6124](https://github.com/googleapis/google-cloud-python/pull/6124))
+- Add `synth.py`. ([#6079](https://github.com/googleapis/google-cloud-python/pull/6079))
+- Test document update w/ integer ids ([#5895](https://github.com/googleapis/google-cloud-python/pull/5895))
+- Nox: use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Re-sync with .proto / .textproto files from google-cloud-common. ([#5351](https://github.com/googleapis/google-cloud-python/pull/5351))
+- Modify system tests to use prerelease versions of grpcio ([#5304](https://github.com/googleapis/google-cloud-python/pull/5304))
+- Add test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Fix over-long line. ([#5129](https://github.com/googleapis/google-cloud-python/pull/5129))
+- Distinguish `FieldPath` classes from field path strings ([#4466](https://github.com/googleapis/google-cloud-python/pull/4466))
+- Fix bad trove classifier
+- Cleanup `FieldPath` ([#4996](https://github.com/googleapis/google-cloud-python/pull/4996))
+- Fix typo in `Document.collections` docstring. ([#5669](https://github.com/googleapis/google-cloud-python/pull/5669))
+- Implement `FieldPath.__add__` ([#5149](https://github.com/googleapis/google-cloud-python/pull/5149))
+
+## 0.29.0
+
+### New features
+
+- All non-simple field names are converted into unicode (#4859)
+
+### Implementation changes
+
+- The underlying generated code has been re-generated to pick up new features and bugfixes. (#4916)
+- The `Admin` API interface has been temporarily removed.
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+- The minimum version for `google-api-core` has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)
+
+### Documentation
+
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- System test fix, changed ALREADY_EXISTS and MISSING_ENTITY to DOCUMENT_EXISTS and MISSING_DOCUMENT and updated wording (#4803)
+- Cross-language tests (#4359)
+- Fix import column lengths pass 79 (#4464)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-firestore/0.28.0/
diff --git a/firestore/LICENSE b/firestore/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/firestore/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/firestore/MANIFEST.in b/firestore/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/firestore/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/firestore/Makefile_v1 b/firestore/Makefile_v1
new file mode 100644
index 000000000000..af193e3e819b
--- /dev/null
+++ b/firestore/Makefile_v1
@@ -0,0 +1,40 @@
+# This makefile builds the protos needed for cross-language Firestore tests.
+
+# Assume protoc is on the path. The proto compiler must be one that
+# supports proto3 syntax.
+PROTOC = protoc
+
+# Dependent repos.
+REPO_DIR=$(HOME)/git-repos
+PROTOBUF_REPO = $(REPO_DIR)/protobuf
+GOOGLEAPIS_REPO = $(REPO_DIR)/googleapis
+TESTS_REPO = $(REPO_DIR)/conformance-tests
+TEST_PROTO_DIR = $(TESTS_REPO)/firestore/v1
+TEST_PROTO_SRC = $(TEST_PROTO_DIR)/proto/google/cloud/conformance/firestore/v1/tests.proto
+
+TMPDIR = /tmp/python-fs-proto
+TMPDIR_FS = $(TMPDIR)/google/cloud/firestore_v1/proto
+TEST_PROTO_COPY = $(TMPDIR_FS)/tests.proto
+
+.PHONY: sync-protos gen-protos
+
+gen-protos: sync-protos tweak-protos
+	# TODO(jba): Put the generated proto somewhere more suitable.
+	$(PROTOC) --python_out=. \
+		-I $(TMPDIR) \
+		-I $(PROTOBUF_REPO)/src \
+		-I $(GOOGLEAPIS_REPO) \
+		$(TEST_PROTO_COPY)
+
+tweak-protos:
+	mkdir -p $(TMPDIR_FS)
+	cp $(GOOGLEAPIS_REPO)/google/firestore/v1/*.proto $(TMPDIR_FS)
+	sed -i -e 's@google/firestore/v1@google/cloud/firestore_v1/proto@' $(TMPDIR_FS)/*.proto
+	cp $(TEST_PROTO_SRC) $(TEST_PROTO_COPY)
+	sed -i -e 's@package google.cloud.conformance.firestore.v1@package google.cloud.firestore_v1.proto@' $(TEST_PROTO_COPY)
+	sed -i -e 's@google/firestore/v1@google/cloud/firestore_v1/proto@' $(TEST_PROTO_COPY)
+
+sync-protos:
+	cd $(PROTOBUF_REPO); git pull
+	cd $(GOOGLEAPIS_REPO); git pull
+	cd $(TESTS_REPO); git pull
diff --git a/firestore/Makefile_v1beta1 b/firestore/Makefile_v1beta1
new file mode 100644
index 000000000000..69cf87f41a36
--- /dev/null
+++ b/firestore/Makefile_v1beta1
@@ -0,0 +1,37 @@
+# This makefile builds the protos needed for cross-language Firestore tests.
+
+# Assume protoc is on the path. The proto compiler must be one that
+# supports proto3 syntax.
+PROTOC = protoc
+
+# Dependent repos.
+REPO_DIR = $(HOME)/git-repos
+PROTOBUF_REPO = $(REPO_DIR)/protobuf
+GOOGLEAPIS_REPO = $(REPO_DIR)/googleapis
+TESTS_REPO = $(REPO_DIR)/gcp/google-cloud-common
+
+TMPDIR = /tmp/python-fs-proto
+TMPDIR_FS = $(TMPDIR)/google/cloud/firestore_v1beta1/proto
+
+.PHONY: sync-protos gen-protos
+
+gen-protos: sync-protos tweak-protos
+	# TODO(jba): Put the generated proto somewhere more suitable.
+	$(PROTOC) --python_out=google/cloud/firestore_v1beta1/proto \
+		-I $(TMPDIR) \
+		-I $(PROTOBUF_REPO)/src \
+		-I $(GOOGLEAPIS_REPO) \
+		$(TMPDIR)/test_v1beta1.proto
+
+tweak-protos:
+	mkdir -p $(TMPDIR_FS)
+	cp $(GOOGLEAPIS_REPO)/google/firestore/v1beta1/*.proto $(TMPDIR_FS)
+	sed -i -e 's@google/firestore/v1beta1@google/cloud/firestore_v1beta1/proto@' $(TMPDIR_FS)/*.proto
+	cp $(TESTS_REPO)/testing/firestore/proto/test_v1beta1.proto $(TMPDIR)
+	sed -i -e 's@package tests@package tests.v1beta1@' $(TMPDIR)/test_v1beta1.proto
+	sed -i -e 's@google/firestore/v1beta1@google/cloud/firestore_v1beta1/proto@' $(TMPDIR)/test_v1beta1.proto
+
+sync-protos:
+	cd $(PROTOBUF_REPO); git pull
+	cd $(GOOGLEAPIS_REPO); git pull
+	#cd $(TESTS_REPO); git pull
diff --git a/firestore/README.rst b/firestore/README.rst
new file mode 100644
index 000000000000..de8e38b91048
--- /dev/null
+++ b/firestore/README.rst
@@ -0,0 +1,116 @@
+Python Client for Google Cloud Firestore
+========================================
+
+|beta| |pypi| |versions| 
+
+The `Google Cloud Firestore`_ API is a flexible, scalable
+database for mobile, web, and server development from Firebase and Google
+Cloud Platform. Like Firebase Realtime Database, it keeps your data in
+sync across client apps through realtime listeners and offers offline support
+for mobile and web so you can build responsive apps that work regardless of
+network latency or Internet connectivity. Cloud Firestore also offers seamless
+integration with other Firebase and Google Cloud Platform products,
+including Cloud Functions.
+
+-  `Product Documentation`_
+-  `Client Library Documentation`_
+
+.. |beta| image:: https://img.shields.io/badge/support-beta-silver.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-firestore.svg
+   :target: https://pypi.org/project/google-cloud-firestore/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-firestore.svg
+.. _Google Cloud Firestore: https://cloud.google.com/firestore/
+.. _Product Documentation: https://cloud.google.com/firestore/docs/
+.. _Client Library Documentation: https://googleapis.dev/python/firestore/latest
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Firestore API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Firestore API.:  https://cloud.google.com/firestore
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-firestore
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-firestore
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code:: python
+
+    from google.cloud import firestore
+
+    # Add a new document
+    db = firestore.Client()
+    doc_ref = db.collection(u'users').document(u'alovelace')
+    doc_ref.set({
+        u'first': u'Ada',
+        u'last': u'Lovelace',
+        u'born': 1815
+    })
+
+    # Then query for documents
+    users_ref = db.collection(u'users')
+    docs = users_ref.get()
+
+    for doc in docs:
+        print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Firestore API
+   API to see other available methods on the client.
+-  Read the `Product Documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/firestore/docs/README.rst b/firestore/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/firestore/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/firestore/docs/batch.rst b/firestore/docs/batch.rst
new file mode 100644
index 000000000000..d130d0379170
--- /dev/null
+++ b/firestore/docs/batch.rst
@@ -0,0 +1,6 @@
+Batches
+~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.batch
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/changelog.md b/firestore/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/firestore/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/firestore/docs/client.rst b/firestore/docs/client.rst
new file mode 100644
index 000000000000..c42eb434706c
--- /dev/null
+++ b/firestore/docs/client.rst
@@ -0,0 +1,6 @@
+Client
+~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.client
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/collection.rst b/firestore/docs/collection.rst
new file mode 100644
index 000000000000..22d4d8243e69
--- /dev/null
+++ b/firestore/docs/collection.rst
@@ -0,0 +1,6 @@
+Collections
+~~~~~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.collection
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/conf.py b/firestore/docs/conf.py
new file mode 100644
index 000000000000..15df1fa1182f
--- /dev/null
+++ b/firestore/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-firestore documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-firestore"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-firestore-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-firestore.tex",
+        u"google-cloud-firestore Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-firestore",
+        u"google-cloud-firestore Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-firestore",
+        u"google-cloud-firestore Documentation",
+        author,
+        "google-cloud-firestore",
+        "GAPIC library for the {metadata.shortName}",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/firestore/docs/document.rst b/firestore/docs/document.rst
new file mode 100644
index 000000000000..bc04dd4443b5
--- /dev/null
+++ b/firestore/docs/document.rst
@@ -0,0 +1,6 @@
+Documents
+~~~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.document
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/field_path.rst b/firestore/docs/field_path.rst
new file mode 100644
index 000000000000..006aacf193b7
--- /dev/null
+++ b/firestore/docs/field_path.rst
@@ -0,0 +1,7 @@
+Field Paths
+~~~~~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.field_path
+  :members:
+  :show-inheritance:
+
diff --git a/firestore/docs/index.rst b/firestore/docs/index.rst
new file mode 100644
index 000000000000..d355d8aec4c8
--- /dev/null
+++ b/firestore/docs/index.rst
@@ -0,0 +1,29 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+
+.. toctree::
+  :maxdepth: 2
+
+  client
+  collection
+  document
+  field_path
+  query
+  batch
+  transaction
+  transforms
+  types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-firestore`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/firestore/docs/query.rst b/firestore/docs/query.rst
new file mode 100644
index 000000000000..8f4117671ced
--- /dev/null
+++ b/firestore/docs/query.rst
@@ -0,0 +1,6 @@
+Queries
+~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.query
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/transaction.rst b/firestore/docs/transaction.rst
new file mode 100644
index 000000000000..97e670a3493e
--- /dev/null
+++ b/firestore/docs/transaction.rst
@@ -0,0 +1,7 @@
+Transactions
+~~~~~~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.transaction
+  :inherited-members:
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/transforms.rst b/firestore/docs/transforms.rst
new file mode 100644
index 000000000000..b3051ca151c3
--- /dev/null
+++ b/firestore/docs/transforms.rst
@@ -0,0 +1,6 @@
+Transforms
+~~~~~~~~~~
+
+.. automodule:: google.cloud.firestore_v1.transforms
+  :members:
+  :show-inheritance:
diff --git a/firestore/docs/types.rst b/firestore/docs/types.rst
new file mode 100644
index 000000000000..ce74845203ac
--- /dev/null
+++ b/firestore/docs/types.rst
@@ -0,0 +1,6 @@
+Types
+~~~~~
+
+.. automodule:: google.cloud.firestore_v1.types
+  :members:
+  :show-inheritance:
diff --git a/firestore/google/__init__.py b/firestore/google/__init__.py
new file mode 100644
index 000000000000..aa5aeae602bc
--- /dev/null
+++ b/firestore/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/firestore/google/cloud/__init__.py b/firestore/google/cloud/__init__.py
new file mode 100644
index 000000000000..aa5aeae602bc
--- /dev/null
+++ b/firestore/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/firestore/google/cloud/firestore.py b/firestore/google/cloud/firestore.py
new file mode 100644
index 000000000000..3bdb9af565b3
--- /dev/null
+++ b/firestore/google/cloud/firestore.py
@@ -0,0 +1,69 @@
+# Copyright 2017 Google LLC 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.
+
+"""Python idiomatic client for Google Cloud Firestore."""
+
+
+from google.cloud.firestore_v1 import __version__
+from google.cloud.firestore_v1 import ArrayRemove
+from google.cloud.firestore_v1 import ArrayUnion
+from google.cloud.firestore_v1 import Client
+from google.cloud.firestore_v1 import CollectionReference
+from google.cloud.firestore_v1 import DELETE_FIELD
+from google.cloud.firestore_v1 import DocumentReference
+from google.cloud.firestore_v1 import DocumentSnapshot
+from google.cloud.firestore_v1 import enums
+from google.cloud.firestore_v1 import ExistsOption
+from google.cloud.firestore_v1 import GeoPoint
+from google.cloud.firestore_v1 import Increment
+from google.cloud.firestore_v1 import LastUpdateOption
+from google.cloud.firestore_v1 import Maximum
+from google.cloud.firestore_v1 import Minimum
+from google.cloud.firestore_v1 import Query
+from google.cloud.firestore_v1 import ReadAfterWriteError
+from google.cloud.firestore_v1 import SERVER_TIMESTAMP
+from google.cloud.firestore_v1 import Transaction
+from google.cloud.firestore_v1 import transactional
+from google.cloud.firestore_v1 import types
+from google.cloud.firestore_v1 import Watch
+from google.cloud.firestore_v1 import WriteBatch
+from google.cloud.firestore_v1 import WriteOption
+
+
+__all__ = [
+    "__version__",
+    "ArrayRemove",
+    "ArrayUnion",
+    "Client",
+    "CollectionReference",
+    "DELETE_FIELD",
+    "DocumentReference",
+    "DocumentSnapshot",
+    "enums",
+    "ExistsOption",
+    "GeoPoint",
+    "Increment",
+    "LastUpdateOption",
+    "Maximum",
+    "Minimum",
+    "Query",
+    "ReadAfterWriteError",
+    "SERVER_TIMESTAMP",
+    "Transaction",
+    "transactional",
+    "types",
+    "Watch",
+    "WriteBatch",
+    "WriteOption",
+]
diff --git a/firestore/google/cloud/firestore_admin_v1/__init__.py b/firestore/google/cloud/firestore_admin_v1/__init__.py
new file mode 100644
index 000000000000..20eef5af0f8c
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.firestore_admin_v1 import types
+from google.cloud.firestore_admin_v1.gapic import enums
+from google.cloud.firestore_admin_v1.gapic import firestore_admin_client
+
+
+class FirestoreAdminClient(firestore_admin_client.FirestoreAdminClient):
+    __doc__ = firestore_admin_client.FirestoreAdminClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "FirestoreAdminClient")
diff --git a/firestore/google/cloud/firestore_admin_v1/gapic/__init__.py b/firestore/google/cloud/firestore_admin_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_admin_v1/gapic/enums.py b/firestore/google/cloud/firestore_admin_v1/gapic/enums.py
new file mode 100644
index 000000000000..c8b31fc6255b
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/gapic/enums.py
@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class OperationState(enum.IntEnum):
+    """
+    Describes the state of the operation.
+
+    Attributes:
+      OPERATION_STATE_UNSPECIFIED (int): Unspecified.
+      INITIALIZING (int): Request is being prepared for processing.
+      PROCESSING (int): Request is actively being processed.
+      CANCELLING (int): Request is in the process of being cancelled after user called
+      google.longrunning.Operations.CancelOperation on the operation.
+      FINALIZING (int): Request has been processed and is in its finalization stage.
+      SUCCESSFUL (int): Request has completed successfully.
+      FAILED (int): Request has finished being processed, but encountered an error.
+      CANCELLED (int): Request has finished being cancelled after user called
+      google.longrunning.Operations.CancelOperation.
+    """
+
+    OPERATION_STATE_UNSPECIFIED = 0
+    INITIALIZING = 1
+    PROCESSING = 2
+    CANCELLING = 3
+    FINALIZING = 4
+    SUCCESSFUL = 5
+    FAILED = 6
+    CANCELLED = 7
+
+
+class FieldOperationMetadata(object):
+    class IndexConfigDelta(object):
+        class ChangeType(enum.IntEnum):
+            """
+            Specifies how the index is changing.
+
+            Attributes:
+              CHANGE_TYPE_UNSPECIFIED (int): The type of change is not specified or known.
+              ADD (int): The single field index is being added.
+              REMOVE (int): The single field index is being removed.
+            """
+
+            CHANGE_TYPE_UNSPECIFIED = 0
+            ADD = 1
+            REMOVE = 2
+
+
+class Index(object):
+    class QueryScope(enum.IntEnum):
+        """
+        Query Scope defines the scope at which a query is run. This is specified
+        on a StructuredQuery's ``from`` field.
+
+        Attributes:
+          QUERY_SCOPE_UNSPECIFIED (int): The query scope is unspecified. Not a valid option.
+          COLLECTION (int): Indexes with a collection query scope specified allow queries
+          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.
+        """
+
+        QUERY_SCOPE_UNSPECIFIED = 0
+        COLLECTION = 1
+
+    class State(enum.IntEnum):
+        """
+        The state of an index. During index creation, an index will be in the
+        ``CREATING`` state. If the index is created successfully, it will
+        transition to the ``READY`` state. If the index creation encounters a
+        problem, the index will transition to the ``NEEDS_REPAIR`` state.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): The state is unspecified.
+          CREATING (int): The index is being created.
+          There is an active long-running operation for the index.
+          The index is updated when writing a document.
+          Some index data may exist.
+          READY (int): The index is ready to be used.
+          The index is updated when writing a document.
+          The index is fully populated from all stored documents it applies to.
+          NEEDS_REPAIR (int): The index was being created, but something went wrong.
+          There is no active long-running operation for the index,
+          and the most recently finished long-running operation failed.
+          The index is not updated when writing a document.
+          Some index data may exist.
+          Use the google.longrunning.Operations API to determine why the operation
+          that last attempted to create this index failed, then re-create the
+          index.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATING = 1
+        READY = 2
+        NEEDS_REPAIR = 3
+
+    class IndexField(object):
+        class ArrayConfig(enum.IntEnum):
+            """
+            The supported array value configurations.
+
+            Attributes:
+              ARRAY_CONFIG_UNSPECIFIED (int): The index does not support additional array queries.
+              CONTAINS (int): The index supports array containment queries.
+            """
+
+            ARRAY_CONFIG_UNSPECIFIED = 0
+            CONTAINS = 1
+
+        class Order(enum.IntEnum):
+            """
+            The supported orderings.
+
+            Attributes:
+              ORDER_UNSPECIFIED (int): The ordering is unspecified. Not a valid option.
+              ASCENDING (int): The field is ordered by ascending field value.
+              DESCENDING (int): The field is ordered by descending field value.
+            """
+
+            ORDER_UNSPECIFIED = 0
+            ASCENDING = 1
+            DESCENDING = 2
diff --git a/firestore/google/cloud/firestore_admin_v1/gapic/firestore_admin_client.py b/firestore/google/cloud/firestore_admin_v1/gapic/firestore_admin_client.py
new file mode 100644
index 000000000000..4d51a4bc170a
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/gapic/firestore_admin_client.py
@@ -0,0 +1,1016 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.firestore.admin.v1 FirestoreAdmin API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.firestore_admin_v1.gapic import enums
+from google.cloud.firestore_admin_v1.gapic import firestore_admin_client_config
+from google.cloud.firestore_admin_v1.gapic.transports import (
+    firestore_admin_grpc_transport,
+)
+from google.cloud.firestore_admin_v1.proto import field_pb2
+from google.cloud.firestore_admin_v1.proto import firestore_admin_pb2
+from google.cloud.firestore_admin_v1.proto import firestore_admin_pb2_grpc
+from google.cloud.firestore_admin_v1.proto import index_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-firestore"
+).version
+
+
+class FirestoreAdminClient(object):
+    """
+    Operations are created by service ``FirestoreAdmin``, but are accessed
+    via service ``google.longrunning.Operations``.
+    """
+
+    SERVICE_ADDRESS = "firestore.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.firestore.admin.v1.FirestoreAdmin"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            FirestoreAdminClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def database_path(cls, project, database):
+        """Return a fully-qualified database string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}",
+            project=project,
+            database=database,
+        )
+
+    @classmethod
+    def field_path(cls, project, database, collection_id, field_id):
+        """Return a fully-qualified field string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/collectionGroups/{collection_id}/fields/{field_id}",
+            project=project,
+            database=database,
+            collection_id=collection_id,
+            field_id=field_id,
+        )
+
+    @classmethod
+    def index_path(cls, project, database, collection_id, index_id):
+        """Return a fully-qualified index string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/collectionGroups/{collection_id}/indexes/{index_id}",
+            project=project,
+            database=database,
+            collection_id=collection_id,
+            index_id=index_id,
+        )
+
+    @classmethod
+    def parent_path(cls, project, database, collection_id):
+        """Return a fully-qualified parent string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/collectionGroups/{collection_id}",
+            project=project,
+            database=database,
+            collection_id=collection_id,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.FirestoreAdminGrpcTransport,
+                    Callable[[~.Credentials, type], ~.FirestoreAdminGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = firestore_admin_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=firestore_admin_grpc_transport.FirestoreAdminGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = firestore_admin_grpc_transport.FirestoreAdminGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_index(
+        self,
+        parent,
+        index,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a composite index. This returns a
+        ``google.longrunning.Operation`` which may be used to track the status
+        of the creation. The metadata for the operation will be the type
+        ``IndexOperationMetadata``.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> parent = client.parent_path('[PROJECT]', '[DATABASE]', '[COLLECTION_ID]')
+            >>>
+            >>> # TODO: Initialize `index`:
+            >>> index = {}
+            >>>
+            >>> response = client.create_index(parent, index)
+
+        Args:
+            parent (str): A parent name of the form
+                ``projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}``
+            index (Union[dict, ~google.cloud.firestore_admin_v1.types.Index]): The composite index to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_admin_v1.types.Index`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_admin_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_index" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_index"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_index,
+                default_retry=self._method_configs["CreateIndex"].retry,
+                default_timeout=self._method_configs["CreateIndex"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.CreateIndexRequest(parent=parent, index=index)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_index"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_indexes(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists composite indexes.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> parent = client.parent_path('[PROJECT]', '[DATABASE]', '[COLLECTION_ID]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_indexes(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_indexes(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): A parent name of the form
+                ``projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}``
+            filter_ (str): The filter to apply to list results.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.firestore_admin_v1.types.Index` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_indexes" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_indexes"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_indexes,
+                default_retry=self._method_configs["ListIndexes"].retry,
+                default_timeout=self._method_configs["ListIndexes"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.ListIndexesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_indexes"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="indexes",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_index(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a composite index.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> name = client.index_path('[PROJECT]', '[DATABASE]', '[COLLECTION_ID]', '[INDEX_ID]')
+            >>>
+            >>> response = client.get_index(name)
+
+        Args:
+            name (str): A name of the form
+                ``projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_admin_v1.types.Index` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_index" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_index"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_index,
+                default_retry=self._method_configs["GetIndex"].retry,
+                default_timeout=self._method_configs["GetIndex"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.GetIndexRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_index"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_index(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a composite index.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> name = client.index_path('[PROJECT]', '[DATABASE]', '[COLLECTION_ID]', '[INDEX_ID]')
+            >>>
+            >>> client.delete_index(name)
+
+        Args:
+            name (str): A name of the form
+                ``projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_index" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_index"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_index,
+                default_retry=self._method_configs["DeleteIndex"].retry,
+                default_timeout=self._method_configs["DeleteIndex"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.DeleteIndexRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_index"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def import_documents(
+        self,
+        name,
+        collection_ids=None,
+        input_uri_prefix=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Imports documents into Google Cloud Firestore. Existing documents with the
+        same name are overwritten. The import occurs in the background and its
+        progress can be monitored and managed via the Operation resource that is
+        created. If an ImportDocuments operation is cancelled, it is possible
+        that a subset of the data has already been imported to Cloud Firestore.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> name = client.database_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> response = client.import_documents(name)
+
+        Args:
+            name (str): Database to import into. Should be of the form:
+                ``projects/{project_id}/databases/{database_id}``.
+            collection_ids (list[str]): Which collection ids to import. Unspecified means all collections included
+                in the import.
+            input_uri_prefix (str): Location of the exported files. This must match the output\_uri\_prefix
+                of an ExportDocumentsResponse from an export that has completed
+                successfully. See:
+                ``google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_admin_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_documents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_documents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_documents,
+                default_retry=self._method_configs["ImportDocuments"].retry,
+                default_timeout=self._method_configs["ImportDocuments"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.ImportDocumentsRequest(
+            name=name, collection_ids=collection_ids, input_uri_prefix=input_uri_prefix
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["import_documents"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def export_documents(
+        self,
+        name,
+        collection_ids=None,
+        output_uri_prefix=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Exports a copy of all or a subset of documents from Google Cloud Firestore
+        to another storage system, such as Google Cloud Storage. Recent updates to
+        documents may not be reflected in the export. The export occurs in the
+        background and its progress can be monitored and managed via the
+        Operation resource that is created. The output of an export may only be
+        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.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> name = client.database_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> response = client.export_documents(name)
+
+        Args:
+            name (str): Database to export. Should be of the form:
+                ``projects/{project_id}/databases/{database_id}``.
+            collection_ids (list[str]): Which collection ids to export. Unspecified means all collections.
+            output_uri_prefix (str): The output URI. Currently only supports Google Cloud Storage URIs of the
+                form: ``gs://BUCKET_NAME[/NAMESPACE_PATH]``, where ``BUCKET_NAME`` is
+                the name of the Google Cloud Storage bucket and ``NAMESPACE_PATH`` is an
+                optional Google Cloud Storage namespace path. When choosing a name, be
+                sure to consider Google Cloud Storage naming guidelines:
+                https://cloud.google.com/storage/docs/naming. If the URI is a bucket
+                (without a namespace path), a prefix will be generated based on the
+                start time.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_admin_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_documents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_documents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_documents,
+                default_retry=self._method_configs["ExportDocuments"].retry,
+                default_timeout=self._method_configs["ExportDocuments"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.ExportDocumentsRequest(
+            name=name,
+            collection_ids=collection_ids,
+            output_uri_prefix=output_uri_prefix,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["export_documents"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_field(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the metadata and configuration for a Field.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> name = client.field_path('[PROJECT]', '[DATABASE]', '[COLLECTION_ID]', '[FIELD_ID]')
+            >>>
+            >>> response = client.get_field(name)
+
+        Args:
+            name (str): A name of the form
+                ``projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_admin_v1.types.Field` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_field" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_field"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_field,
+                default_retry=self._method_configs["GetField"].retry,
+                default_timeout=self._method_configs["GetField"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.GetFieldRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_field"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_fields(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the field configuration and metadata for this database.
+
+        Currently, ``FirestoreAdmin.ListFields`` only supports listing fields
+        that have been explicitly overridden. To issue this query, call
+        ``FirestoreAdmin.ListFields`` with the filter set to
+        ``indexConfig.usesAncestorConfig:false``.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> parent = client.parent_path('[PROJECT]', '[DATABASE]', '[COLLECTION_ID]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_fields(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_fields(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): A parent name of the form
+                ``projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}``
+            filter_ (str): The filter to apply to list results. Currently,
+                ``FirestoreAdmin.ListFields`` only supports listing fields that have
+                been explicitly overridden. To issue this query, call
+                ``FirestoreAdmin.ListFields`` with the filter set to
+                ``indexConfig.usesAncestorConfig:false``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.firestore_admin_v1.types.Field` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_fields" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_fields"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_fields,
+                default_retry=self._method_configs["ListFields"].retry,
+                default_timeout=self._method_configs["ListFields"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.ListFieldsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_fields"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="fields",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_field(
+        self,
+        field,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a field configuration. Currently, field updates apply only to
+        single field index configuration. However, calls to
+        ``FirestoreAdmin.UpdateField`` should provide a field mask to avoid
+        changing any configuration that the caller isn't aware of. The field
+        mask should be specified as: ``{ paths: "index_config" }``.
+
+        This call returns a ``google.longrunning.Operation`` which may be used
+        to track the status of the field update. The metadata for the operation
+        will be the type ``FieldOperationMetadata``.
+
+        To configure the default field settings for the database, use the
+        special ``Field`` with resource name:
+        ``projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*``.
+
+        Example:
+            >>> from google.cloud import firestore_admin_v1
+            >>>
+            >>> client = firestore_admin_v1.FirestoreAdminClient()
+            >>>
+            >>> # TODO: Initialize `field`:
+            >>> field = {}
+            >>>
+            >>> response = client.update_field(field)
+
+        Args:
+            field (Union[dict, ~google.cloud.firestore_admin_v1.types.Field]): The field to be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_admin_v1.types.Field`
+            update_mask (Union[dict, ~google.cloud.firestore_admin_v1.types.FieldMask]): A mask, relative to the field. If specified, only configuration
+                specified by this field\_mask will be updated in the field.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_admin_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_admin_v1.types.Operation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_field" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_field"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_field,
+                default_retry=self._method_configs["UpdateField"].retry,
+                default_timeout=self._method_configs["UpdateField"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_admin_pb2.UpdateFieldRequest(
+            field=field, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("field.name", field.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_field"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/firestore/google/cloud/firestore_admin_v1/gapic/firestore_admin_client_config.py b/firestore/google/cloud/firestore_admin_v1/gapic/firestore_admin_client_config.py
new file mode 100644
index 000000000000..fa18df651135
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/gapic/firestore_admin_client_config.py
@@ -0,0 +1,68 @@
+config = {
+    "interfaces": {
+        "google.firestore.admin.v1.FirestoreAdmin": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateIndex": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListIndexes": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIndex": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteIndex": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportDocuments": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportDocuments": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetField": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFields": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateField": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/firestore/google/cloud/firestore_admin_v1/gapic/transports/__init__.py b/firestore/google/cloud/firestore_admin_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_admin_v1/gapic/transports/firestore_admin_grpc_transport.py b/firestore/google/cloud/firestore_admin_v1/gapic/transports/firestore_admin_grpc_transport.py
new file mode 100644
index 000000000000..34f36d3c88ea
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/gapic/transports/firestore_admin_grpc_transport.py
@@ -0,0 +1,259 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.firestore_admin_v1.proto import firestore_admin_pb2_grpc
+
+
+class FirestoreAdminGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.firestore.admin.v1 FirestoreAdmin API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/datastore",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="firestore.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "firestore_admin_stub": firestore_admin_pb2_grpc.FirestoreAdminStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="firestore.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_index(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.create_index`.
+
+        Creates a composite index. This returns a
+        ``google.longrunning.Operation`` which may be used to track the status
+        of the creation. The metadata for the operation will be the type
+        ``IndexOperationMetadata``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].CreateIndex
+
+    @property
+    def list_indexes(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.list_indexes`.
+
+        Lists composite indexes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].ListIndexes
+
+    @property
+    def get_index(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.get_index`.
+
+        Gets a composite index.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].GetIndex
+
+    @property
+    def delete_index(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.delete_index`.
+
+        Deletes a composite index.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].DeleteIndex
+
+    @property
+    def import_documents(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.import_documents`.
+
+        Imports documents into Google Cloud Firestore. Existing documents with the
+        same name are overwritten. The import occurs in the background and its
+        progress can be monitored and managed via the Operation resource that is
+        created. If an ImportDocuments operation is cancelled, it is possible
+        that a subset of the data has already been imported to Cloud Firestore.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].ImportDocuments
+
+    @property
+    def export_documents(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.export_documents`.
+
+        Exports a copy of all or a subset of documents from Google Cloud Firestore
+        to another storage system, such as Google Cloud Storage. Recent updates to
+        documents may not be reflected in the export. The export occurs in the
+        background and its progress can be monitored and managed via the
+        Operation resource that is created. The output of an export may only be
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].ExportDocuments
+
+    @property
+    def get_field(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.get_field`.
+
+        Gets the metadata and configuration for a Field.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].GetField
+
+    @property
+    def list_fields(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.list_fields`.
+
+        Lists the field configuration and metadata for this database.
+
+        Currently, ``FirestoreAdmin.ListFields`` only supports listing fields
+        that have been explicitly overridden. To issue this query, call
+        ``FirestoreAdmin.ListFields`` with the filter set to
+        ``indexConfig.usesAncestorConfig:false``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].ListFields
+
+    @property
+    def update_field(self):
+        """Return the gRPC stub for :meth:`FirestoreAdminClient.update_field`.
+
+        Updates a field configuration. Currently, field updates apply only to
+        single field index configuration. However, calls to
+        ``FirestoreAdmin.UpdateField`` should provide a field mask to avoid
+        changing any configuration that the caller isn't aware of. The field
+        mask should be specified as: ``{ paths: "index_config" }``.
+
+        This call returns a ``google.longrunning.Operation`` which may be used
+        to track the status of the field update. The metadata for the operation
+        will be the type ``FieldOperationMetadata``.
+
+        To configure the default field settings for the database, use the
+        special ``Field`` with resource name:
+        ``projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_admin_stub"].UpdateField
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/__init__.py b/firestore/google/cloud/firestore_admin_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/field.proto b/firestore/google/cloud/firestore_admin_v1/proto/field.proto
new file mode 100644
index 000000000000..a24e1aaf1dc4
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/field.proto
@@ -0,0 +1,96 @@
+// 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.firestore.admin.v1;
+
+import "google/firestore/admin/v1/index.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1;admin";
+option java_multiple_files = true;
+option java_outer_classname = "FieldProto";
+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 {
+  // 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
+    // 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
+    // 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).
+    string ancestor_field = 3;
+
+    // Output only
+    // When true, the `Field`'s index configuration is in the process of being
+    // reverted. Once complete, the index config will transition to the same
+    // state as the field specified by `ancestor_field`, at which point
+    // `uses_ancestor_config` will be `true` and `reverting` will be `false`.
+    bool reverting = 4;
+  }
+
+  // A field name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}`
+  //
+  // A field path may be a simple field name, e.g. `address` or a path to fields
+  // within map_value , e.g. `address.city`,
+  // or a special field path. The only valid special field is `*`, which
+  // represents any field.
+  //
+  // Field paths may be quoted using ` (backtick). The only character that needs
+  // to be escaped within a quoted field path is the backtick character itself,
+  // escaped using a backslash. Special characters in field paths that
+  // must be quoted include: `*`, `.`,
+  // ``` (backtick), `[`, `]`, as well as any ascii symbolic characters.
+  //
+  // Examples:
+  // (Note: Comments here are written in markdown syntax, so there is an
+  //  additional layer of backticks to represent a code block)
+  // `\`address.city\`` represents a field named `address.city`, not the map key
+  // `city` in the field `address`.
+  // `\`*\`` represents a field named `*`, not any field.
+  //
+  // A special `Field` contains the default indexing settings for all fields.
+  // This field's resource name is:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`
+  // Indexes defined on this `Field` will be applied to all fields which do not
+  // have their own `Field` index configuration.
+  string name = 1;
+
+  // The index configuration for this field. If unset, field indexing will
+  // revert to the configuration defined by the `ancestor_field`. To
+  // explicitly remove all indexes for this field, specify an index config
+  // with an empty list of indexes.
+  IndexConfig index_config = 2;
+}
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/field_pb2.py b/firestore/google/cloud/firestore_admin_v1/proto/field_pb2.py
new file mode 100644
index 000000000000..6e07a77f567d
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/field_pb2.py
@@ -0,0 +1,283 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore/admin_v1/proto/field.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_admin_v1.proto import (
+    index_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2,
+)
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore/admin_v1/proto/field.proto",
+    package="google.firestore.admin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.firestore.admin.v1B\nFieldProtoP\001Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\242\002\004GCFS\252\002\037Google.Cloud.Firestore.Admin.V1\312\002\037Google\\Cloud\\Firestore\\Admin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/firestore/admin_v1/proto/field.proto\x12\x19google.firestore.admin.v1\x1a\x31google/cloud/firestore/admin_v1/proto/index.proto\x1a\x1cgoogle/api/annotations.proto"\xe5\x01\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x42\n\x0cindex_config\x18\x02 \x01(\x0b\x32,.google.firestore.admin.v1.Field.IndexConfig\x1a\x89\x01\n\x0bIndexConfig\x12\x31\n\x07indexes\x18\x01 \x03(\x0b\x32 .google.firestore.admin.v1.Index\x12\x1c\n\x14uses_ancestor_config\x18\x02 \x01(\x08\x12\x16\n\x0e\x61ncestor_field\x18\x03 \x01(\t\x12\x11\n\treverting\x18\x04 \x01(\x08\x42\xb8\x01\n\x1d\x63om.google.firestore.admin.v1B\nFieldProtoP\x01Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\xa2\x02\x04GCFS\xaa\x02\x1fGoogle.Cloud.Firestore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Firestore\\Admin\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_FIELD_INDEXCONFIG = _descriptor.Descriptor(
+    name="IndexConfig",
+    full_name="google.firestore.admin.v1.Field.IndexConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="indexes",
+            full_name="google.firestore.admin.v1.Field.IndexConfig.indexes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uses_ancestor_config",
+            full_name="google.firestore.admin.v1.Field.IndexConfig.uses_ancestor_config",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ancestor_field",
+            full_name="google.firestore.admin.v1.Field.IndexConfig.ancestor_field",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reverting",
+            full_name="google.firestore.admin.v1.Field.IndexConfig.reverting",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=254,
+    serialized_end=391,
+)
+
+_FIELD = _descriptor.Descriptor(
+    name="Field",
+    full_name="google.firestore.admin.v1.Field",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.Field.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_config",
+            full_name="google.firestore.admin.v1.Field.index_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FIELD_INDEXCONFIG],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=162,
+    serialized_end=391,
+)
+
+_FIELD_INDEXCONFIG.fields_by_name[
+    "indexes"
+].message_type = (
+    google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2._INDEX
+)
+_FIELD_INDEXCONFIG.containing_type = _FIELD
+_FIELD.fields_by_name["index_config"].message_type = _FIELD_INDEXCONFIG
+DESCRIPTOR.message_types_by_name["Field"] = _FIELD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Field = _reflection.GeneratedProtocolMessageType(
+    "Field",
+    (_message.Message,),
+    dict(
+        IndexConfig=_reflection.GeneratedProtocolMessageType(
+            "IndexConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FIELD_INDEXCONFIG,
+                __module__="google.cloud.firestore.admin_v1.proto.field_pb2",
+                __doc__="""The index configuration for this field.
+    
+    
+    Attributes:
+        indexes:
+            The indexes supported for this field.
+        uses_ancestor_config:
+            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.
+        ancestor_field:
+            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).
+        reverting:
+            Output only When true, the ``Field``'s index configuration is
+            in the process of being reverted. Once complete, the index
+            config will transition to the same state as the field
+            specified by ``ancestor_field``, at which point
+            ``uses_ancestor_config`` will be ``true`` and ``reverting``
+            will be ``false``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.Field.IndexConfig)
+            ),
+        ),
+        DESCRIPTOR=_FIELD,
+        __module__="google.cloud.firestore.admin_v1.proto.field_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          A field name of the form ``projects/{project_id}/databases/{da
+          tabase_id}/collectionGroups/{collection_id}/fields/{field_path
+          }``  A field path may be a simple field name, e.g. ``address``
+          or a path to fields within map\_value , e.g. ``address.city``,
+          or a special field path. The only valid special field is
+          ``*``, which represents any field.  Field paths may be quoted
+          using ``(backtick). The only character that needs to be
+          escaped within a quoted field path is the backtick character
+          itself, escaped using a backslash. Special characters in field
+          paths that must be quoted include:``\ \*\ ``,``.\ ``, ```
+          (backtick),``\ [``,``]\`, as well as any ascii symbolic
+          characters.  Examples: (Note: Comments here are written in
+          markdown syntax, so there is an additional layer of backticks
+          to represent a code block) ``\``\ address.city\`\ ``represents
+          a field named``\ address.city\ ``, not the map key``\ city\
+          ``in the field``\ address\ ``.``\ \`\ *\`\ ``represents a
+          field named``*\ \`, not any field.  A special ``Field``
+          contains the default indexing settings for all fields. This
+          field's resource name is: ``projects/{project_id}/databases/{d
+          atabase_id}/collectionGroups/__default__/fields/*`` Indexes
+          defined on this ``Field`` will be applied to all fields which
+          do not have their own ``Field`` index configuration.
+      index_config:
+          The index configuration for this field. If unset, field
+          indexing will revert to the configuration defined by the
+          ``ancestor_field``. To explicitly remove all indexes for this
+          field, specify an index config with an empty list of indexes.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.Field)
+    ),
+)
+_sym_db.RegisterMessage(Field)
+_sym_db.RegisterMessage(Field.IndexConfig)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/field_pb2_grpc.py b/firestore/google/cloud/firestore_admin_v1/proto/field_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/field_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin.proto b/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin.proto
new file mode 100644
index 000000000000..e753686b200e
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin.proto
@@ -0,0 +1,274 @@
+// 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.firestore.admin.v1;
+
+import "google/api/annotations.proto";
+import "google/firestore/admin/v1/field.proto";
+import "google/firestore/admin/v1/index.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1;admin";
+option java_multiple_files = true;
+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";
+
+
+// Operations are created by service `FirestoreAdmin`, but are accessed via
+// service `google.longrunning.Operations`.
+service FirestoreAdmin {
+  // 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].
+  rpc CreateIndex(CreateIndexRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes"
+      body: "index"
+    };
+  }
+
+  // Lists composite indexes.
+  rpc ListIndexes(ListIndexesRequest) returns (ListIndexesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes"
+    };
+  }
+
+  // Gets a composite index.
+  rpc GetIndex(GetIndexRequest) returns (Index) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}"
+    };
+  }
+
+  // Deletes a composite index.
+  rpc DeleteIndex(DeleteIndexRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}"
+    };
+  }
+
+  // Gets the metadata and configuration for a Field.
+  rpc GetField(GetFieldRequest) returns (Field) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/databases/*/collectionGroups/*/fields/*}"
+    };
+  }
+
+  // Updates a field configuration. Currently, field updates apply only to
+  // single field index configuration. However, calls to
+  // [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField] should provide a field mask to avoid
+  // changing any configuration that the caller isn't aware of. The field mask
+  // should be specified as: `{ paths: "index_config" }`.
+  //
+  // This call returns a [google.longrunning.Operation][google.longrunning.Operation] which may be used to
+  // track the status of the field update. The metadata for
+  // the operation will be the type [FieldOperationMetadata][google.firestore.admin.v1.FieldOperationMetadata].
+  //
+  // To configure the default field settings for the database, use
+  // the special `Field` with resource name:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`.
+  rpc UpdateField(UpdateFieldRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/{field.name=projects/*/databases/*/collectionGroups/*/fields/*}"
+      body: "field"
+    };
+  }
+
+  // Lists the field configuration and metadata for this database.
+  //
+  // Currently, [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] only supports listing fields
+  // that have been explicitly overridden. To issue this query, call
+  // [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] with the filter set to
+  // `indexConfig.usesAncestorConfig:false`.
+  rpc ListFields(ListFieldsRequest) returns (ListFieldsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/databases/*/collectionGroups/*}/fields"
+    };
+  }
+
+  // Exports a copy of all or a subset of documents from Google Cloud Firestore
+  // to another storage system, such as Google Cloud Storage. Recent updates to
+  // documents may not be reflected in the export. The export occurs in the
+  // background and its progress can be monitored and managed via the
+  // Operation resource that is created. The output of an export may only be
+  // 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 ExportDocuments(ExportDocumentsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/databases/*}:exportDocuments"
+      body: "*"
+    };
+  }
+
+  // Imports documents into Google Cloud Firestore. Existing documents with the
+  // same name are overwritten. The import occurs in the background and its
+  // progress can be monitored and managed via the Operation resource that is
+  // created. If an ImportDocuments operation is cancelled, it is possible
+  // that a subset of the data has already been imported to Cloud Firestore.
+  rpc ImportDocuments(ImportDocumentsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/databases/*}:importDocuments"
+      body: "*"
+    };
+  }
+}
+
+// The request for [FirestoreAdmin.CreateIndex][google.firestore.admin.v1.FirestoreAdmin.CreateIndex].
+message CreateIndexRequest {
+  // 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;
+}
+
+// The request for [FirestoreAdmin.ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListIndexes].
+message ListIndexesRequest {
+  // A parent name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
+  string parent = 1;
+
+  // The filter to apply to list results.
+  string filter = 2;
+
+  // The number of results to return.
+  int32 page_size = 3;
+
+  // A page token, returned from a previous call to
+  // [FirestoreAdmin.ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListIndexes], that may be used to get the next
+  // page of results.
+  string page_token = 4;
+}
+
+// The response for [FirestoreAdmin.ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListIndexes].
+message ListIndexesResponse {
+  // The requested indexes.
+  repeated Index indexes = 1;
+
+  // A page token that may be used to request another page of results. If blank,
+  // this is the last page.
+  string next_page_token = 2;
+}
+
+// The request for [FirestoreAdmin.GetIndex][google.firestore.admin.v1.FirestoreAdmin.GetIndex].
+message GetIndexRequest {
+  // A name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
+  string name = 1;
+}
+
+// The request for [FirestoreAdmin.DeleteIndex][google.firestore.admin.v1.FirestoreAdmin.DeleteIndex].
+message DeleteIndexRequest {
+  // A name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
+  string name = 1;
+}
+
+// The request for [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField].
+message UpdateFieldRequest {
+  // The field to be updated.
+  Field field = 1;
+
+  // A mask, relative to the field. If specified, only configuration specified
+  // by this field_mask will be updated in the field.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// The request for [FirestoreAdmin.GetField][google.firestore.admin.v1.FirestoreAdmin.GetField].
+message GetFieldRequest {
+  // A name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}`
+  string name = 1;
+}
+
+// The request for [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields].
+message ListFieldsRequest {
+  // A parent name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
+  string parent = 1;
+
+  // The filter to apply to list results. Currently,
+  // [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] only supports listing fields
+  // that have been explicitly overridden. To issue this query, call
+  // [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] with the filter set to
+  // `indexConfig.usesAncestorConfig:false`.
+  string filter = 2;
+
+  // The number of results to return.
+  int32 page_size = 3;
+
+  // A page token, returned from a previous call to
+  // [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields], that may be used to get the next
+  // page of results.
+  string page_token = 4;
+}
+
+// The response for [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields].
+message ListFieldsResponse {
+  // The requested fields.
+  repeated Field fields = 1;
+
+  // A page token that may be used to request another page of results. If blank,
+  // this is the last page.
+  string next_page_token = 2;
+}
+
+// The request for [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1.FirestoreAdmin.ExportDocuments].
+message ExportDocumentsRequest {
+  // Database to export. Should be of the form:
+  // `projects/{project_id}/databases/{database_id}`.
+  string name = 1;
+
+  // Which collection ids to export. Unspecified means all collections.
+  repeated string collection_ids = 2;
+
+  // The output URI. Currently only supports Google Cloud Storage URIs of the
+  // form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name
+  // of the Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional
+  // Google Cloud Storage namespace path. When
+  // choosing a name, be sure to consider Google Cloud Storage naming
+  // guidelines: https://cloud.google.com/storage/docs/naming.
+  // If the URI is a bucket (without a namespace path), a prefix will be
+  // generated based on the start time.
+  string output_uri_prefix = 3;
+}
+
+// The request for [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1.FirestoreAdmin.ImportDocuments].
+message ImportDocumentsRequest {
+  // Database to import into. Should be of the form:
+  // `projects/{project_id}/databases/{database_id}`.
+  string name = 1;
+
+  // Which collection ids to import. Unspecified means all collections included
+  // in the import.
+  repeated string collection_ids = 2;
+
+  // Location of the exported files.
+  // This must match the output_uri_prefix of an ExportDocumentsResponse from
+  // an export that has completed successfully.
+  // See:
+  // [google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix][google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix].
+  string input_uri_prefix = 3;
+}
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin_pb2.py b/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin_pb2.py
new file mode 100644
index 000000000000..7346c4b4e789
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin_pb2.py
@@ -0,0 +1,1159 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore/admin_v1/proto/firestore_admin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.firestore_admin_v1.proto import (
+    field_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2,
+)
+from google.cloud.firestore_admin_v1.proto import (
+    index_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore/admin_v1/proto/firestore_admin.proto",
+    package="google.firestore.admin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.firestore.admin.v1B\023FirestoreAdminProtoP\001Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\242\002\004GCFS\252\002\037Google.Cloud.Firestore.Admin.V1\312\002\037Google\\Cloud\\Firestore\\Admin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n;google/cloud/firestore/admin_v1/proto/firestore_admin.proto\x12\x19google.firestore.admin.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x31google/cloud/firestore/admin_v1/proto/field.proto\x1a\x31google/cloud/firestore/admin_v1/proto/index.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"U\n\x12\x43reateIndexRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12/\n\x05index\x18\x02 \x01(\x0b\x32 .google.firestore.admin.v1.Index"[\n\x12ListIndexesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"a\n\x13ListIndexesResponse\x12\x31\n\x07indexes\x18\x01 \x03(\x0b\x32 .google.firestore.admin.v1.Index\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1f\n\x0fGetIndexRequest\x12\x0c\n\x04name\x18\x01 \x01(\t""\n\x12\x44\x65leteIndexRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"v\n\x12UpdateFieldRequest\x12/\n\x05\x66ield\x18\x01 \x01(\x0b\x32 .google.firestore.admin.v1.Field\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x1f\n\x0fGetFieldRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"Z\n\x11ListFieldsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"_\n\x12ListFieldsResponse\x12\x30\n\x06\x66ields\x18\x01 \x03(\x0b\x32 .google.firestore.admin.v1.Field\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"Y\n\x16\x45xportDocumentsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x16\n\x0e\x63ollection_ids\x18\x02 \x03(\t\x12\x19\n\x11output_uri_prefix\x18\x03 \x01(\t"X\n\x16ImportDocumentsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x16\n\x0e\x63ollection_ids\x18\x02 \x03(\t\x12\x18\n\x10input_uri_prefix\x18\x03 \x01(\t2\x85\x0c\n\x0e\x46irestoreAdmin\x12\xaa\x01\n\x0b\x43reateIndex\x12-.google.firestore.admin.v1.CreateIndexRequest\x1a\x1d.google.longrunning.Operation"M\x82\xd3\xe4\x93\x02G">/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes:\x05index\x12\xb4\x01\n\x0bListIndexes\x12-.google.firestore.admin.v1.ListIndexesRequest\x1a..google.firestore.admin.v1.ListIndexesResponse"F\x82\xd3\xe4\x93\x02@\x12>/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes\x12\xa0\x01\n\x08GetIndex\x12*.google.firestore.admin.v1.GetIndexRequest\x1a .google.firestore.admin.v1.Index"F\x82\xd3\xe4\x93\x02@\x12>/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}\x12\x9c\x01\n\x0b\x44\x65leteIndex\x12-.google.firestore.admin.v1.DeleteIndexRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02@*>/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}\x12\x9f\x01\n\x08GetField\x12*.google.firestore.admin.v1.GetFieldRequest\x1a .google.firestore.admin.v1.Field"E\x82\xd3\xe4\x93\x02?\x12=/v1/{name=projects/*/databases/*/collectionGroups/*/fields/*}\x12\xaf\x01\n\x0bUpdateField\x12-.google.firestore.admin.v1.UpdateFieldRequest\x1a\x1d.google.longrunning.Operation"R\x82\xd3\xe4\x93\x02L2C/v1/{field.name=projects/*/databases/*/collectionGroups/*/fields/*}:\x05\x66ield\x12\xb0\x01\n\nListFields\x12,.google.firestore.admin.v1.ListFieldsRequest\x1a-.google.firestore.admin.v1.ListFieldsResponse"E\x82\xd3\xe4\x93\x02?\x12=/v1/{parent=projects/*/databases/*/collectionGroups/*}/fields\x12\xa1\x01\n\x0f\x45xportDocuments\x12\x31.google.firestore.admin.v1.ExportDocumentsRequest\x1a\x1d.google.longrunning.Operation"<\x82\xd3\xe4\x93\x02\x36"1/v1/{name=projects/*/databases/*}:exportDocuments:\x01*\x12\xa1\x01\n\x0fImportDocuments\x12\x31.google.firestore.admin.v1.ImportDocumentsRequest\x1a\x1d.google.longrunning.Operation"<\x82\xd3\xe4\x93\x02\x36"1/v1/{name=projects/*/databases/*}:importDocuments:\x01*B\xc1\x01\n\x1d\x63om.google.firestore.admin.v1B\x13\x46irestoreAdminProtoP\x01Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\xa2\x02\x04GCFS\xaa\x02\x1fGoogle.Cloud.Firestore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Firestore\\Admin\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEINDEXREQUEST = _descriptor.Descriptor(
+    name="CreateIndexRequest",
+    full_name="google.firestore.admin.v1.CreateIndexRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.admin.v1.CreateIndexRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.firestore.admin.v1.CreateIndexRequest.index",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=322,
+    serialized_end=407,
+)
+
+
+_LISTINDEXESREQUEST = _descriptor.Descriptor(
+    name="ListIndexesRequest",
+    full_name="google.firestore.admin.v1.ListIndexesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.admin.v1.ListIndexesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.firestore.admin.v1.ListIndexesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.admin.v1.ListIndexesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.admin.v1.ListIndexesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=409,
+    serialized_end=500,
+)
+
+
+_LISTINDEXESRESPONSE = _descriptor.Descriptor(
+    name="ListIndexesResponse",
+    full_name="google.firestore.admin.v1.ListIndexesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="indexes",
+            full_name="google.firestore.admin.v1.ListIndexesResponse.indexes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.admin.v1.ListIndexesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=502,
+    serialized_end=599,
+)
+
+
+_GETINDEXREQUEST = _descriptor.Descriptor(
+    name="GetIndexRequest",
+    full_name="google.firestore.admin.v1.GetIndexRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.GetIndexRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=601,
+    serialized_end=632,
+)
+
+
+_DELETEINDEXREQUEST = _descriptor.Descriptor(
+    name="DeleteIndexRequest",
+    full_name="google.firestore.admin.v1.DeleteIndexRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.DeleteIndexRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=634,
+    serialized_end=668,
+)
+
+
+_UPDATEFIELDREQUEST = _descriptor.Descriptor(
+    name="UpdateFieldRequest",
+    full_name="google.firestore.admin.v1.UpdateFieldRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.admin.v1.UpdateFieldRequest.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.firestore.admin.v1.UpdateFieldRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=670,
+    serialized_end=788,
+)
+
+
+_GETFIELDREQUEST = _descriptor.Descriptor(
+    name="GetFieldRequest",
+    full_name="google.firestore.admin.v1.GetFieldRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.GetFieldRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=790,
+    serialized_end=821,
+)
+
+
+_LISTFIELDSREQUEST = _descriptor.Descriptor(
+    name="ListFieldsRequest",
+    full_name="google.firestore.admin.v1.ListFieldsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.admin.v1.ListFieldsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.firestore.admin.v1.ListFieldsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.admin.v1.ListFieldsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.admin.v1.ListFieldsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=823,
+    serialized_end=913,
+)
+
+
+_LISTFIELDSRESPONSE = _descriptor.Descriptor(
+    name="ListFieldsResponse",
+    full_name="google.firestore.admin.v1.ListFieldsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.admin.v1.ListFieldsResponse.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.admin.v1.ListFieldsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=915,
+    serialized_end=1010,
+)
+
+
+_EXPORTDOCUMENTSREQUEST = _descriptor.Descriptor(
+    name="ExportDocumentsRequest",
+    full_name="google.firestore.admin.v1.ExportDocumentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.ExportDocumentsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_ids",
+            full_name="google.firestore.admin.v1.ExportDocumentsRequest.collection_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri_prefix",
+            full_name="google.firestore.admin.v1.ExportDocumentsRequest.output_uri_prefix",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1012,
+    serialized_end=1101,
+)
+
+
+_IMPORTDOCUMENTSREQUEST = _descriptor.Descriptor(
+    name="ImportDocumentsRequest",
+    full_name="google.firestore.admin.v1.ImportDocumentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.ImportDocumentsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_ids",
+            full_name="google.firestore.admin.v1.ImportDocumentsRequest.collection_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_uri_prefix",
+            full_name="google.firestore.admin.v1.ImportDocumentsRequest.input_uri_prefix",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1103,
+    serialized_end=1191,
+)
+
+_CREATEINDEXREQUEST.fields_by_name[
+    "index"
+].message_type = (
+    google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2._INDEX
+)
+_LISTINDEXESRESPONSE.fields_by_name[
+    "indexes"
+].message_type = (
+    google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2._INDEX
+)
+_UPDATEFIELDREQUEST.fields_by_name[
+    "field"
+].message_type = (
+    google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2._FIELD
+)
+_UPDATEFIELDREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTFIELDSRESPONSE.fields_by_name[
+    "fields"
+].message_type = (
+    google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2._FIELD
+)
+DESCRIPTOR.message_types_by_name["CreateIndexRequest"] = _CREATEINDEXREQUEST
+DESCRIPTOR.message_types_by_name["ListIndexesRequest"] = _LISTINDEXESREQUEST
+DESCRIPTOR.message_types_by_name["ListIndexesResponse"] = _LISTINDEXESRESPONSE
+DESCRIPTOR.message_types_by_name["GetIndexRequest"] = _GETINDEXREQUEST
+DESCRIPTOR.message_types_by_name["DeleteIndexRequest"] = _DELETEINDEXREQUEST
+DESCRIPTOR.message_types_by_name["UpdateFieldRequest"] = _UPDATEFIELDREQUEST
+DESCRIPTOR.message_types_by_name["GetFieldRequest"] = _GETFIELDREQUEST
+DESCRIPTOR.message_types_by_name["ListFieldsRequest"] = _LISTFIELDSREQUEST
+DESCRIPTOR.message_types_by_name["ListFieldsResponse"] = _LISTFIELDSRESPONSE
+DESCRIPTOR.message_types_by_name["ExportDocumentsRequest"] = _EXPORTDOCUMENTSREQUEST
+DESCRIPTOR.message_types_by_name["ImportDocumentsRequest"] = _IMPORTDOCUMENTSREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateIndexRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateIndexRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINDEXREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.CreateIndex][google.firestore.admin.v1.FirestoreAdmin.CreateIndex].
+  
+  
+  Attributes:
+      parent:
+          A parent name of the form ``projects/{project_id}/databases/{d
+          atabase_id}/collectionGroups/{collection_id}``
+      index:
+          The composite index to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.CreateIndexRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateIndexRequest)
+
+ListIndexesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListIndexesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINDEXESREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListIndexes].
+  
+  
+  Attributes:
+      parent:
+          A parent name of the form ``projects/{project_id}/databases/{d
+          atabase_id}/collectionGroups/{collection_id}``
+      filter:
+          The filter to apply to list results.
+      page_size:
+          The number of results to return.
+      page_token:
+          A page token, returned from a previous call to [FirestoreAdmin
+          .ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListInd
+          exes], that may be used to get the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ListIndexesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListIndexesRequest)
+
+ListIndexesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListIndexesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINDEXESRESPONSE,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The response for
+  [FirestoreAdmin.ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListIndexes].
+  
+  
+  Attributes:
+      indexes:
+          The requested indexes.
+      next_page_token:
+          A page token that may be used to request another page of
+          results. If blank, this is the last page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ListIndexesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListIndexesResponse)
+
+GetIndexRequest = _reflection.GeneratedProtocolMessageType(
+    "GetIndexRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINDEXREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.GetIndex][google.firestore.admin.v1.FirestoreAdmin.GetIndex].
+  
+  
+  Attributes:
+      name:
+          A name of the form ``projects/{project_id}/databases/{database
+          _id}/collectionGroups/{collection_id}/indexes/{index_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.GetIndexRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetIndexRequest)
+
+DeleteIndexRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteIndexRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINDEXREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.DeleteIndex][google.firestore.admin.v1.FirestoreAdmin.DeleteIndex].
+  
+  
+  Attributes:
+      name:
+          A name of the form ``projects/{project_id}/databases/{database
+          _id}/collectionGroups/{collection_id}/indexes/{index_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.DeleteIndexRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteIndexRequest)
+
+UpdateFieldRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateFieldRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEFIELDREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField].
+  
+  
+  Attributes:
+      field:
+          The field to be updated.
+      update_mask:
+          A mask, relative to the field. If specified, only
+          configuration specified by this field\_mask will be updated in
+          the field.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.UpdateFieldRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateFieldRequest)
+
+GetFieldRequest = _reflection.GeneratedProtocolMessageType(
+    "GetFieldRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETFIELDREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.GetField][google.firestore.admin.v1.FirestoreAdmin.GetField].
+  
+  
+  Attributes:
+      name:
+          A name of the form ``projects/{project_id}/databases/{database
+          _id}/collectionGroups/{collection_id}/fields/{field_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.GetFieldRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetFieldRequest)
+
+ListFieldsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFieldsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFIELDSREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields].
+  
+  
+  Attributes:
+      parent:
+          A parent name of the form ``projects/{project_id}/databases/{d
+          atabase_id}/collectionGroups/{collection_id}``
+      filter:
+          The filter to apply to list results. Currently, [FirestoreAdmi
+          n.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFie
+          lds] only supports listing fields that have been explicitly
+          overridden. To issue this query, call [FirestoreAdmin.ListFiel
+          ds][google.firestore.admin.v1.FirestoreAdmin.ListFields] with
+          the filter set to ``indexConfig.usesAncestorConfig:false``.
+      page_size:
+          The number of results to return.
+      page_token:
+          A page token, returned from a previous call to [FirestoreAdmin
+          .ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFiel
+          ds], that may be used to get the next page of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ListFieldsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFieldsRequest)
+
+ListFieldsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFieldsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFIELDSRESPONSE,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The response for
+  [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields].
+  
+  
+  Attributes:
+      fields:
+          The requested fields.
+      next_page_token:
+          A page token that may be used to request another page of
+          results. If blank, this is the last page.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ListFieldsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFieldsResponse)
+
+ExportDocumentsRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportDocumentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDOCUMENTSREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1.FirestoreAdmin.ExportDocuments].
+  
+  
+  Attributes:
+      name:
+          Database to export. Should be of the form:
+          ``projects/{project_id}/databases/{database_id}``.
+      collection_ids:
+          Which collection ids to export. Unspecified means all
+          collections.
+      output_uri_prefix:
+          The output URI. Currently only supports Google Cloud Storage
+          URIs of the form: ``gs://BUCKET_NAME[/NAMESPACE_PATH]``, where
+          ``BUCKET_NAME`` is the name of the Google Cloud Storage bucket
+          and ``NAMESPACE_PATH`` is an optional Google Cloud Storage
+          namespace path. When choosing a name, be sure to consider
+          Google Cloud Storage naming guidelines:
+          https://cloud.google.com/storage/docs/naming. If the URI is a
+          bucket (without a namespace path), a prefix will be generated
+          based on the start time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ExportDocumentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportDocumentsRequest)
+
+ImportDocumentsRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportDocumentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDOCUMENTSREQUEST,
+        __module__="google.cloud.firestore.admin_v1.proto.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1.FirestoreAdmin.ImportDocuments].
+  
+  
+  Attributes:
+      name:
+          Database to import into. Should be of the form:
+          ``projects/{project_id}/databases/{database_id}``.
+      collection_ids:
+          Which collection ids to import. Unspecified means all
+          collections included in the import.
+      input_uri_prefix:
+          Location of the exported files. This must match the
+          output\_uri\_prefix of an ExportDocumentsResponse from an
+          export that has completed successfully. See: [google.firestore
+          .admin.v1.ExportDocumentsResponse.output\_uri\_prefix][google.
+          firestore.admin.v1.ExportDocumentsResponse.output\_uri\_prefix
+          ].
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ImportDocumentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportDocumentsRequest)
+
+
+DESCRIPTOR._options = None
+
+_FIRESTOREADMIN = _descriptor.ServiceDescriptor(
+    name="FirestoreAdmin",
+    full_name="google.firestore.admin.v1.FirestoreAdmin",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1194,
+    serialized_end=2735,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateIndex",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.CreateIndex",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEINDEXREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002G">/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes:\005index'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListIndexes",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.ListIndexes",
+            index=1,
+            containing_service=None,
+            input_type=_LISTINDEXESREQUEST,
+            output_type=_LISTINDEXESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIndex",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.GetIndex",
+            index=2,
+            containing_service=None,
+            input_type=_GETINDEXREQUEST,
+            output_type=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2._INDEX,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteIndex",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.DeleteIndex",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEINDEXREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002@*>/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetField",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.GetField",
+            index=4,
+            containing_service=None,
+            input_type=_GETFIELDREQUEST,
+            output_type=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2._FIELD,
+            serialized_options=_b(
+                "\202\323\344\223\002?\022=/v1/{name=projects/*/databases/*/collectionGroups/*/fields/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateField",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.UpdateField",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATEFIELDREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002L2C/v1/{field.name=projects/*/databases/*/collectionGroups/*/fields/*}:\005field"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFields",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.ListFields",
+            index=6,
+            containing_service=None,
+            input_type=_LISTFIELDSREQUEST,
+            output_type=_LISTFIELDSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002?\022=/v1/{parent=projects/*/databases/*/collectionGroups/*}/fields"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportDocuments",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.ExportDocuments",
+            index=7,
+            containing_service=None,
+            input_type=_EXPORTDOCUMENTSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0026"1/v1/{name=projects/*/databases/*}:exportDocuments:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportDocuments",
+            full_name="google.firestore.admin.v1.FirestoreAdmin.ImportDocuments",
+            index=8,
+            containing_service=None,
+            input_type=_IMPORTDOCUMENTSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0026"1/v1/{name=projects/*/databases/*}:importDocuments:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_FIRESTOREADMIN)
+
+DESCRIPTOR.services_by_name["FirestoreAdmin"] = _FIRESTOREADMIN
+
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin_pb2_grpc.py b/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin_pb2_grpc.py
new file mode 100644
index 000000000000..269e920b3ac2
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/firestore_admin_pb2_grpc.py
@@ -0,0 +1,227 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.firestore_admin_v1.proto import (
+    field_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2,
+)
+from google.cloud.firestore_admin_v1.proto import (
+    firestore_admin_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2,
+)
+from google.cloud.firestore_admin_v1.proto import (
+    index_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class FirestoreAdminStub(object):
+    """Operations are created by service `FirestoreAdmin`, but are accessed via
+  service `google.longrunning.Operations`.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateIndex = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/CreateIndex",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.CreateIndexRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ListIndexes = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/ListIndexes",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListIndexesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListIndexesResponse.FromString,
+        )
+        self.GetIndex = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/GetIndex",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.GetIndexRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2.Index.FromString,
+        )
+        self.DeleteIndex = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/DeleteIndex",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.DeleteIndexRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetField = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/GetField",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.GetFieldRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2.Field.FromString,
+        )
+        self.UpdateField = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/UpdateField",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.UpdateFieldRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ListFields = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/ListFields",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListFieldsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListFieldsResponse.FromString,
+        )
+        self.ExportDocuments = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/ExportDocuments",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ExportDocumentsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ImportDocuments = channel.unary_unary(
+            "/google.firestore.admin.v1.FirestoreAdmin/ImportDocuments",
+            request_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ImportDocumentsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class FirestoreAdminServicer(object):
+    """Operations are created by service `FirestoreAdmin`, but are accessed via
+  service `google.longrunning.Operations`.
+  """
+
+    def CreateIndex(self, request, context):
+        """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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListIndexes(self, request, context):
+        """Lists composite indexes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIndex(self, request, context):
+        """Gets a composite index.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteIndex(self, request, context):
+        """Deletes a composite index.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetField(self, request, context):
+        """Gets the metadata and configuration for a Field.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateField(self, request, context):
+        """Updates a field configuration. Currently, field updates apply only to
+    single field index configuration. However, calls to
+    [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField] should provide a field mask to avoid
+    changing any configuration that the caller isn't aware of. The field mask
+    should be specified as: `{ paths: "index_config" }`.
+
+    This call returns a [google.longrunning.Operation][google.longrunning.Operation] which may be used to
+    track the status of the field update. The metadata for
+    the operation will be the type [FieldOperationMetadata][google.firestore.admin.v1.FieldOperationMetadata].
+
+    To configure the default field settings for the database, use
+    the special `Field` with resource name:
+    `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFields(self, request, context):
+        """Lists the field configuration and metadata for this database.
+
+    Currently, [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] only supports listing fields
+    that have been explicitly overridden. To issue this query, call
+    [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] with the filter set to
+    `indexConfig.usesAncestorConfig:false`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportDocuments(self, request, context):
+        """Exports a copy of all or a subset of documents from Google Cloud Firestore
+    to another storage system, such as Google Cloud Storage. Recent updates to
+    documents may not be reflected in the export. The export occurs in the
+    background and its progress can be monitored and managed via the
+    Operation resource that is created. The output of an export may only be
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportDocuments(self, request, context):
+        """Imports documents into Google Cloud Firestore. Existing documents with the
+    same name are overwritten. The import occurs in the background and its
+    progress can be monitored and managed via the Operation resource that is
+    created. If an ImportDocuments operation is cancelled, it is possible
+    that a subset of the data has already been imported to Cloud Firestore.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_FirestoreAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateIndex": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateIndex,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.CreateIndexRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ListIndexes": grpc.unary_unary_rpc_method_handler(
+            servicer.ListIndexes,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListIndexesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListIndexesResponse.SerializeToString,
+        ),
+        "GetIndex": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIndex,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.GetIndexRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2.Index.SerializeToString,
+        ),
+        "DeleteIndex": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteIndex,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.DeleteIndexRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetField": grpc.unary_unary_rpc_method_handler(
+            servicer.GetField,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.GetFieldRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_field__pb2.Field.SerializeToString,
+        ),
+        "UpdateField": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateField,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.UpdateFieldRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ListFields": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFields,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListFieldsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ListFieldsResponse.SerializeToString,
+        ),
+        "ExportDocuments": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportDocuments,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ExportDocumentsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ImportDocuments": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportDocuments,
+            request_deserializer=google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_firestore__admin__pb2.ImportDocumentsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.firestore.admin.v1.FirestoreAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/index.proto b/firestore/google/cloud/firestore_admin_v1/proto/index.proto
new file mode 100644
index 000000000000..94941d3a0707
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/index.proto
@@ -0,0 +1,149 @@
+// 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.firestore.admin.v1;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1;admin";
+option java_multiple_files = true;
+option java_outer_classname = "IndexProto";
+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 {
+  // A field in an index.
+  // The field_path describes which field is indexed, the value_mode describes
+  // how the field value is indexed.
+  message IndexField {
+    // The supported orderings.
+    enum Order {
+      // The ordering is unspecified. Not a valid option.
+      ORDER_UNSPECIFIED = 0;
+
+      // The field is ordered by ascending field value.
+      ASCENDING = 1;
+
+      // The field is ordered by descending field value.
+      DESCENDING = 2;
+    }
+
+    // The supported array value configurations.
+    enum ArrayConfig {
+      // The index does not support additional array queries.
+      ARRAY_CONFIG_UNSPECIFIED = 0;
+
+      // The index supports array containment queries.
+      CONTAINS = 1;
+    }
+
+    // Can be __name__.
+    // For single field indexes, this must match the name of the field or may
+    // be omitted.
+    string field_path = 1;
+
+    // How the field value is indexed.
+    oneof value_mode {
+      // Indicates that this field supports ordering by the specified order or
+      // comparing using =, <, <=, >, >=.
+      Order order = 2;
+
+      // Indicates that this field supports operations on `array_value`s.
+      ArrayConfig array_config = 3;
+    }
+  }
+
+  // Query Scope defines the scope at which a query is run. This is specified on
+  // a StructuredQuery's `from` field.
+  enum QueryScope {
+    // The query scope is unspecified. Not a valid option.
+    QUERY_SCOPE_UNSPECIFIED = 0;
+
+    // Indexes with a collection query scope specified allow queries
+    // 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;
+  }
+
+  // The state of an index. During index creation, an index will be in the
+  // `CREATING` state. If the index is created successfully, it will transition
+  // to the `READY` state. If the index creation encounters a problem, the index
+  // will transition to the `NEEDS_REPAIR` state.
+  enum State {
+    // The state is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // The index is being created.
+    // There is an active long-running operation for the index.
+    // The index is updated when writing a document.
+    // Some index data may exist.
+    CREATING = 1;
+
+    // The index is ready to be used.
+    // The index is updated when writing a document.
+    // The index is fully populated from all stored documents it applies to.
+    READY = 2;
+
+    // The index was being created, but something went wrong.
+    // There is no active long-running operation for the index,
+    // and the most recently finished long-running operation failed.
+    // The index is not updated when writing a document.
+    // Some index data may exist.
+    // Use the google.longrunning.Operations API to determine why the operation
+    // that last attempted to create this index failed, then re-create the
+    // index.
+    NEEDS_REPAIR = 3;
+  }
+
+  // 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.
+  string name = 1;
+
+  // Indexes with a collection query scope specified allow queries
+  // against a collection that is the child of a specific document, specified at
+  // query time, and that has the same collection id.
+  //
+  // Indexes with a collection group query scope specified allow queries against
+  // all collections descended from a specific document, specified at query
+  // time, and that have the same collection id as this index.
+  QueryScope query_scope = 2;
+
+  // The fields supported by this index.
+  //
+  // For composite indexes, this is always 2 or more fields.
+  // The last field entry is always for the field path `__name__`. If, on
+  // creation, `__name__` was not specified as the last field, it will be added
+  // automatically with the same direction as that of the last field defined. If
+  // the final field in a composite index is not directional, the `__name__`
+  // will be ordered ASCENDING (unless explicitly specified).
+  //
+  // For single field indexes, this will always be exactly one entry with a
+  // field path equal to the field path of the associated field.
+  repeated IndexField fields = 3;
+
+  // Output only.
+  // The serving state of the index.
+  State state = 4;
+}
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/index_pb2.py b/firestore/google/cloud/firestore_admin_v1/proto/index_pb2.py
new file mode 100644
index 000000000000..cb089c09a31b
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/index_pb2.py
@@ -0,0 +1,415 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore/admin_v1/proto/index.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore/admin_v1/proto/index.proto",
+    package="google.firestore.admin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.firestore.admin.v1B\nIndexProtoP\001Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\242\002\004GCFS\252\002\037Google.Cloud.Firestore.Admin.V1\312\002\037Google\\Cloud\\Firestore\\Admin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/firestore/admin_v1/proto/index.proto\x12\x19google.firestore.admin.v1\x1a\x1cgoogle/api/annotations.proto"\x91\x05\n\x05Index\x12\x0c\n\x04name\x18\x01 \x01(\t\x12@\n\x0bquery_scope\x18\x02 \x01(\x0e\x32+.google.firestore.admin.v1.Index.QueryScope\x12;\n\x06\x66ields\x18\x03 \x03(\x0b\x32+.google.firestore.admin.v1.Index.IndexField\x12\x35\n\x05state\x18\x04 \x01(\x0e\x32&.google.firestore.admin.v1.Index.State\x1a\xbd\x02\n\nIndexField\x12\x12\n\nfield_path\x18\x01 \x01(\t\x12\x42\n\x05order\x18\x02 \x01(\x0e\x32\x31.google.firestore.admin.v1.Index.IndexField.OrderH\x00\x12O\n\x0c\x61rray_config\x18\x03 \x01(\x0e\x32\x37.google.firestore.admin.v1.Index.IndexField.ArrayConfigH\x00"=\n\x05Order\x12\x15\n\x11ORDER_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x01\x12\x0e\n\nDESCENDING\x10\x02"9\n\x0b\x41rrayConfig\x12\x1c\n\x18\x41RRAY_CONFIG_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43ONTAINS\x10\x01\x42\x0c\n\nvalue_mode"9\n\nQueryScope\x12\x1b\n\x17QUERY_SCOPE_UNSPECIFIED\x10\x00\x12\x0e\n\nCOLLECTION\x10\x01"I\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x10\n\x0cNEEDS_REPAIR\x10\x03\x42\xb8\x01\n\x1d\x63om.google.firestore.admin.v1B\nIndexProtoP\x01Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\xa2\x02\x04GCFS\xaa\x02\x1fGoogle.Cloud.Firestore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Firestore\\Admin\\V1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_INDEX_INDEXFIELD_ORDER = _descriptor.EnumDescriptor(
+    name="Order",
+    full_name="google.firestore.admin.v1.Index.IndexField.Order",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ORDER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASCENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESCENDING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=500,
+    serialized_end=561,
+)
+_sym_db.RegisterEnumDescriptor(_INDEX_INDEXFIELD_ORDER)
+
+_INDEX_INDEXFIELD_ARRAYCONFIG = _descriptor.EnumDescriptor(
+    name="ArrayConfig",
+    full_name="google.firestore.admin.v1.Index.IndexField.ArrayConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ARRAY_CONFIG_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONTAINS", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=563,
+    serialized_end=620,
+)
+_sym_db.RegisterEnumDescriptor(_INDEX_INDEXFIELD_ARRAYCONFIG)
+
+_INDEX_QUERYSCOPE = _descriptor.EnumDescriptor(
+    name="QueryScope",
+    full_name="google.firestore.admin.v1.Index.QueryScope",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="QUERY_SCOPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COLLECTION", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=636,
+    serialized_end=693,
+)
+_sym_db.RegisterEnumDescriptor(_INDEX_QUERYSCOPE)
+
+_INDEX_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.firestore.admin.v1.Index.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEEDS_REPAIR", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=695,
+    serialized_end=768,
+)
+_sym_db.RegisterEnumDescriptor(_INDEX_STATE)
+
+
+_INDEX_INDEXFIELD = _descriptor.Descriptor(
+    name="IndexField",
+    full_name="google.firestore.admin.v1.Index.IndexField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_path",
+            full_name="google.firestore.admin.v1.Index.IndexField.field_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order",
+            full_name="google.firestore.admin.v1.Index.IndexField.order",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_config",
+            full_name="google.firestore.admin.v1.Index.IndexField.array_config",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_INDEX_INDEXFIELD_ORDER, _INDEX_INDEXFIELD_ARRAYCONFIG],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value_mode",
+            full_name="google.firestore.admin.v1.Index.IndexField.value_mode",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=317,
+    serialized_end=634,
+)
+
+_INDEX = _descriptor.Descriptor(
+    name="Index",
+    full_name="google.firestore.admin.v1.Index",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1.Index.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_scope",
+            full_name="google.firestore.admin.v1.Index.query_scope",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.admin.v1.Index.fields",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.firestore.admin.v1.Index.state",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INDEX_INDEXFIELD],
+    enum_types=[_INDEX_QUERYSCOPE, _INDEX_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=111,
+    serialized_end=768,
+)
+
+_INDEX_INDEXFIELD.fields_by_name["order"].enum_type = _INDEX_INDEXFIELD_ORDER
+_INDEX_INDEXFIELD.fields_by_name[
+    "array_config"
+].enum_type = _INDEX_INDEXFIELD_ARRAYCONFIG
+_INDEX_INDEXFIELD.containing_type = _INDEX
+_INDEX_INDEXFIELD_ORDER.containing_type = _INDEX_INDEXFIELD
+_INDEX_INDEXFIELD_ARRAYCONFIG.containing_type = _INDEX_INDEXFIELD
+_INDEX_INDEXFIELD.oneofs_by_name["value_mode"].fields.append(
+    _INDEX_INDEXFIELD.fields_by_name["order"]
+)
+_INDEX_INDEXFIELD.fields_by_name[
+    "order"
+].containing_oneof = _INDEX_INDEXFIELD.oneofs_by_name["value_mode"]
+_INDEX_INDEXFIELD.oneofs_by_name["value_mode"].fields.append(
+    _INDEX_INDEXFIELD.fields_by_name["array_config"]
+)
+_INDEX_INDEXFIELD.fields_by_name[
+    "array_config"
+].containing_oneof = _INDEX_INDEXFIELD.oneofs_by_name["value_mode"]
+_INDEX.fields_by_name["query_scope"].enum_type = _INDEX_QUERYSCOPE
+_INDEX.fields_by_name["fields"].message_type = _INDEX_INDEXFIELD
+_INDEX.fields_by_name["state"].enum_type = _INDEX_STATE
+_INDEX_QUERYSCOPE.containing_type = _INDEX
+_INDEX_STATE.containing_type = _INDEX
+DESCRIPTOR.message_types_by_name["Index"] = _INDEX
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Index = _reflection.GeneratedProtocolMessageType(
+    "Index",
+    (_message.Message,),
+    dict(
+        IndexField=_reflection.GeneratedProtocolMessageType(
+            "IndexField",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INDEX_INDEXFIELD,
+                __module__="google.cloud.firestore.admin_v1.proto.index_pb2",
+                __doc__="""A field in an index. The field\_path describes which field is indexed,
+    the value\_mode describes how the field value is indexed.
+    
+    
+    Attributes:
+        field_path:
+            Can be **name**. For single field indexes, this must match the
+            name of the field or may be omitted.
+        value_mode:
+            How the field value is indexed.
+        order:
+            Indicates that this field supports ordering by the specified
+            order or comparing using =, <, <=, >, >=.
+        array_config:
+            Indicates that this field supports operations on
+            ``array_value``\ s.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.Index.IndexField)
+            ),
+        ),
+        DESCRIPTOR=_INDEX,
+        __module__="google.cloud.firestore.admin_v1.proto.index_pb2",
+        __doc__="""Cloud Firestore indexes enable simple and complex queries against
+  documents in a database.
+  
+  
+  Attributes:
+      name:
+          Output only. A server defined name for this index. The form of
+          this name for composite indexes will be: ``projects/{project_i
+          d}/databases/{database_id}/collectionGroups/{collection_id}/in
+          dexes/{composite_index_id}`` For single field indexes, this
+          field will be empty.
+      query_scope:
+          Indexes with a collection query scope specified allow queries
+          against a collection that is the child of a specific document,
+          specified at query time, and that has the same collection id.
+          Indexes with a collection group query scope specified allow
+          queries against all collections descended from a specific
+          document, specified at query time, and that have the same
+          collection id as this index.
+      fields:
+          The fields supported by this index.  For composite indexes,
+          this is always 2 or more fields. The last field entry is
+          always for the field path ``__name__``. If, on creation,
+          ``__name__`` was not specified as the last field, it will be
+          added automatically with the same direction as that of the
+          last field defined. If the final field in a composite index is
+          not directional, the ``__name__`` will be ordered ASCENDING
+          (unless explicitly specified).  For single field indexes, this
+          will always be exactly one entry with a field path equal to
+          the field path of the associated field.
+      state:
+          Output only. The serving state of the index.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.Index)
+    ),
+)
+_sym_db.RegisterMessage(Index)
+_sym_db.RegisterMessage(Index.IndexField)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/index_pb2_grpc.py b/firestore/google/cloud/firestore_admin_v1/proto/index_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/index_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/location.proto b/firestore/google/cloud/firestore_admin_v1/proto/location.proto
new file mode 100644
index 000000000000..7b56051a5c36
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/location.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.firestore.admin.v1;
+
+import "google/type/latlng.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1;admin";
+option java_multiple_files = true;
+option java_outer_classname = "LocationProto";
+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/firestore/google/cloud/firestore_admin_v1/proto/location_pb2.py b/firestore/google/cloud/firestore_admin_v1/proto/location_pb2.py
new file mode 100644
index 000000000000..0c9643a3ab6b
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/location_pb2.py
@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore/admin_v1/proto/location.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore/admin_v1/proto/location.proto",
+    package="google.firestore.admin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.firestore.admin.v1B\rLocationProtoP\001Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\242\002\004GCFS\252\002\037Google.Cloud.Firestore.Admin.V1\312\002\037Google\\Cloud\\Firestore\\Admin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/firestore/admin_v1/proto/location.proto\x12\x19google.firestore.admin.v1\x1a\x18google/type/latlng.proto\x1a\x1cgoogle/api/annotations.proto"\x12\n\x10LocationMetadataB\xbb\x01\n\x1d\x63om.google.firestore.admin.v1B\rLocationProtoP\x01Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\xa2\x02\x04GCFS\xaa\x02\x1fGoogle.Cloud.Firestore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Firestore\\Admin\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOCATIONMETADATA = _descriptor.Descriptor(
+    name="LocationMetadata",
+    full_name="google.firestore.admin.v1.LocationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=139,
+    serialized_end=157,
+)
+
+DESCRIPTOR.message_types_by_name["LocationMetadata"] = _LOCATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LocationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LocationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONMETADATA,
+        __module__="google.cloud.firestore.admin_v1.proto.location_pb2",
+        __doc__="""The metadata message for
+  [google.cloud.location.Location.metadata][google.cloud.location.Location.metadata].
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.LocationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LocationMetadata)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/location_pb2_grpc.py b/firestore/google/cloud/firestore_admin_v1/proto/location_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/location_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/operation.proto b/firestore/google/cloud/firestore_admin_v1/proto/operation.proto
new file mode 100644
index 000000000000..d333d9b7de25
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/operation.proto
@@ -0,0 +1,204 @@
+// 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.firestore.admin.v1;
+
+import "google/firestore/admin/v1/index.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1;admin";
+option java_multiple_files = true;
+option java_outer_classname = "OperationProto";
+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 {
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The index resource that this operation is acting on. For example:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
+  string index = 3;
+
+  // The state of the operation.
+  OperationState state = 4;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 5;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 6;
+}
+
+// Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
+// [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField].
+message FieldOperationMetadata {
+  // Information about an index configuration change.
+  message IndexConfigDelta {
+    // Specifies how the index is changing.
+    enum ChangeType {
+      // The type of change is not specified or known.
+      CHANGE_TYPE_UNSPECIFIED = 0;
+
+      // The single field index is being added.
+      ADD = 1;
+
+      // The single field index is being removed.
+      REMOVE = 2;
+    }
+
+    // Specifies how the index is changing.
+    ChangeType change_type = 1;
+
+    // The index being changed.
+    Index index = 2;
+  }
+
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The field resource that this operation is acting on. For example:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}`
+  string field = 3;
+
+  // A list of [IndexConfigDelta][google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta], which describe the intent of this
+  // operation.
+  repeated IndexConfigDelta index_config_deltas = 4;
+
+  // The state of the operation.
+  OperationState state = 5;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 6;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 7;
+}
+
+// Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
+// [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1.FirestoreAdmin.ExportDocuments].
+message ExportDocumentsMetadata {
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The state of the export operation.
+  OperationState operation_state = 3;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 4;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 5;
+
+  // Which collection ids are being exported.
+  repeated string collection_ids = 6;
+
+  // Where the entities are being exported to.
+  string output_uri_prefix = 7;
+}
+
+// Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
+// [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1.FirestoreAdmin.ImportDocuments].
+message ImportDocumentsMetadata {
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The state of the import operation.
+  OperationState operation_state = 3;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 4;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 5;
+
+  // Which collection ids are being imported.
+  repeated string collection_ids = 6;
+
+  // The location of the documents being imported.
+  string input_uri_prefix = 7;
+}
+
+// Returned in the [google.longrunning.Operation][google.longrunning.Operation] response field.
+message ExportDocumentsResponse {
+  // Location of the output files. This can be used to begin an import
+  // into Cloud Firestore (this project or another project) after the operation
+  // completes successfully.
+  string output_uri_prefix = 1;
+}
+
+// Describes the state of the operation.
+enum OperationState {
+  // Unspecified.
+  OPERATION_STATE_UNSPECIFIED = 0;
+
+  // Request is being prepared for processing.
+  INITIALIZING = 1;
+
+  // Request is actively being processed.
+  PROCESSING = 2;
+
+  // Request is in the process of being cancelled after user called
+  // google.longrunning.Operations.CancelOperation on the operation.
+  CANCELLING = 3;
+
+  // Request has been processed and is in its finalization stage.
+  FINALIZING = 4;
+
+  // Request has completed successfully.
+  SUCCESSFUL = 5;
+
+  // Request has finished being processed, but encountered an error.
+  FAILED = 6;
+
+  // Request has finished being cancelled after user called
+  // 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/firestore/google/cloud/firestore_admin_v1/proto/operation_pb2.py b/firestore/google/cloud/firestore_admin_v1/proto/operation_pb2.py
new file mode 100644
index 000000000000..7993aa91dc73
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/operation_pb2.py
@@ -0,0 +1,1110 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore/admin_v1/proto/operation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_admin_v1.proto import (
+    index_pb2 as google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore/admin_v1/proto/operation.proto",
+    package="google.firestore.admin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.firestore.admin.v1B\016OperationProtoP\001Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\242\002\004GCFS\252\002\037Google.Cloud.Firestore.Admin.V1\312\002\037Google\\Cloud\\Firestore\\Admin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/firestore/admin_v1/proto/operation.proto\x12\x19google.firestore.admin.v1\x1a\x31google/cloud/firestore/admin_v1/proto/index.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xbd\x02\n\x16IndexOperationMetadata\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05index\x18\x03 \x01(\t\x12\x38\n\x05state\x18\x04 \x01(\x0e\x32).google.firestore.admin.v1.OperationState\x12?\n\x12progress_documents\x18\x05 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x12;\n\x0eprogress_bytes\x18\x06 \x01(\x0b\x32#.google.firestore.admin.v1.Progress"\x88\x05\n\x16\x46ieldOperationMetadata\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05\x66ield\x18\x03 \x01(\t\x12_\n\x13index_config_deltas\x18\x04 \x03(\x0b\x32\x42.google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta\x12\x38\n\x05state\x18\x05 \x01(\x0e\x32).google.firestore.admin.v1.OperationState\x12?\n\x12progress_documents\x18\x06 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x12;\n\x0eprogress_bytes\x18\x07 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x1a\xe7\x01\n\x10IndexConfigDelta\x12\x62\n\x0b\x63hange_type\x18\x01 \x01(\x0e\x32M.google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta.ChangeType\x12/\n\x05index\x18\x02 \x01(\x0b\x32 .google.firestore.admin.v1.Index">\n\nChangeType\x12\x1b\n\x17\x43HANGE_TYPE_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41\x44\x44\x10\x01\x12\n\n\x06REMOVE\x10\x02"\xec\x02\n\x17\x45xportDocumentsMetadata\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x42\n\x0foperation_state\x18\x03 \x01(\x0e\x32).google.firestore.admin.v1.OperationState\x12?\n\x12progress_documents\x18\x04 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x12;\n\x0eprogress_bytes\x18\x05 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x12\x16\n\x0e\x63ollection_ids\x18\x06 \x03(\t\x12\x19\n\x11output_uri_prefix\x18\x07 \x01(\t"\xeb\x02\n\x17ImportDocumentsMetadata\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x42\n\x0foperation_state\x18\x03 \x01(\x0e\x32).google.firestore.admin.v1.OperationState\x12?\n\x12progress_documents\x18\x04 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x12;\n\x0eprogress_bytes\x18\x05 \x01(\x0b\x32#.google.firestore.admin.v1.Progress\x12\x16\n\x0e\x63ollection_ids\x18\x06 \x03(\t\x12\x18\n\x10input_uri_prefix\x18\x07 \x01(\t"4\n\x17\x45xportDocumentsResponse\x12\x19\n\x11output_uri_prefix\x18\x01 \x01(\t":\n\x08Progress\x12\x16\n\x0e\x65stimated_work\x18\x01 \x01(\x03\x12\x16\n\x0e\x63ompleted_work\x18\x02 \x01(\x03*\x9e\x01\n\x0eOperationState\x12\x1f\n\x1bOPERATION_STATE_UNSPECIFIED\x10\x00\x12\x10\n\x0cINITIALIZING\x10\x01\x12\x0e\n\nPROCESSING\x10\x02\x12\x0e\n\nCANCELLING\x10\x03\x12\x0e\n\nFINALIZING\x10\x04\x12\x0e\n\nSUCCESSFUL\x10\x05\x12\n\n\x06\x46\x41ILED\x10\x06\x12\r\n\tCANCELLED\x10\x07\x42\xbc\x01\n\x1d\x63om.google.firestore.admin.v1B\x0eOperationProtoP\x01Z>google.golang.org/genproto/googleapis/firestore/admin/v1;admin\xa2\x02\x04GCFS\xaa\x02\x1fGoogle.Cloud.Firestore.Admin.V1\xca\x02\x1fGoogle\\Cloud\\Firestore\\Admin\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+_OPERATIONSTATE = _descriptor.EnumDescriptor(
+    name="OperationState",
+    full_name="google.firestore.admin.v1.OperationState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATION_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INITIALIZING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROCESSING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINALIZING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESSFUL", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2017,
+    serialized_end=2175,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATIONSTATE)
+
+OperationState = enum_type_wrapper.EnumTypeWrapper(_OPERATIONSTATE)
+OPERATION_STATE_UNSPECIFIED = 0
+INITIALIZING = 1
+PROCESSING = 2
+CANCELLING = 3
+FINALIZING = 4
+SUCCESSFUL = 5
+FAILED = 6
+CANCELLED = 7
+
+
+_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA_CHANGETYPE = _descriptor.EnumDescriptor(
+    name="ChangeType",
+    full_name="google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta.ChangeType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CHANGE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1105,
+    serialized_end=1167,
+)
+_sym_db.RegisterEnumDescriptor(_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA_CHANGETYPE)
+
+
+_INDEXOPERATIONMETADATA = _descriptor.Descriptor(
+    name="IndexOperationMetadata",
+    full_name="google.firestore.admin.v1.IndexOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.firestore.admin.v1.IndexOperationMetadata.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.firestore.admin.v1.IndexOperationMetadata.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.firestore.admin.v1.IndexOperationMetadata.index",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.firestore.admin.v1.IndexOperationMetadata.state",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_documents",
+            full_name="google.firestore.admin.v1.IndexOperationMetadata.progress_documents",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_bytes",
+            full_name="google.firestore.admin.v1.IndexOperationMetadata.progress_bytes",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=199,
+    serialized_end=516,
+)
+
+
+_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA = _descriptor.Descriptor(
+    name="IndexConfigDelta",
+    full_name="google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="change_type",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta.change_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta.index",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA_CHANGETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=936,
+    serialized_end=1167,
+)
+
+_FIELDOPERATIONMETADATA = _descriptor.Descriptor(
+    name="FieldOperationMetadata",
+    full_name="google.firestore.admin.v1.FieldOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.field",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_config_deltas",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.index_config_deltas",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.state",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_documents",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.progress_documents",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_bytes",
+            full_name="google.firestore.admin.v1.FieldOperationMetadata.progress_bytes",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=519,
+    serialized_end=1167,
+)
+
+
+_EXPORTDOCUMENTSMETADATA = _descriptor.Descriptor(
+    name="ExportDocumentsMetadata",
+    full_name="google.firestore.admin.v1.ExportDocumentsMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_state",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.operation_state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_documents",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.progress_documents",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_bytes",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.progress_bytes",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_ids",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.collection_ids",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri_prefix",
+            full_name="google.firestore.admin.v1.ExportDocumentsMetadata.output_uri_prefix",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1170,
+    serialized_end=1534,
+)
+
+
+_IMPORTDOCUMENTSMETADATA = _descriptor.Descriptor(
+    name="ImportDocumentsMetadata",
+    full_name="google.firestore.admin.v1.ImportDocumentsMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_state",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.operation_state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_documents",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.progress_documents",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_bytes",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.progress_bytes",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_ids",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.collection_ids",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_uri_prefix",
+            full_name="google.firestore.admin.v1.ImportDocumentsMetadata.input_uri_prefix",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1537,
+    serialized_end=1900,
+)
+
+
+_EXPORTDOCUMENTSRESPONSE = _descriptor.Descriptor(
+    name="ExportDocumentsResponse",
+    full_name="google.firestore.admin.v1.ExportDocumentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri_prefix",
+            full_name="google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1902,
+    serialized_end=1954,
+)
+
+
+_PROGRESS = _descriptor.Descriptor(
+    name="Progress",
+    full_name="google.firestore.admin.v1.Progress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="estimated_work",
+            full_name="google.firestore.admin.v1.Progress.estimated_work",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="completed_work",
+            full_name="google.firestore.admin.v1.Progress.completed_work",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1956,
+    serialized_end=2014,
+)
+
+_INDEXOPERATIONMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INDEXOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INDEXOPERATIONMETADATA.fields_by_name["state"].enum_type = _OPERATIONSTATE
+_INDEXOPERATIONMETADATA.fields_by_name["progress_documents"].message_type = _PROGRESS
+_INDEXOPERATIONMETADATA.fields_by_name["progress_bytes"].message_type = _PROGRESS
+_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA.fields_by_name[
+    "change_type"
+].enum_type = _FIELDOPERATIONMETADATA_INDEXCONFIGDELTA_CHANGETYPE
+_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA.fields_by_name[
+    "index"
+].message_type = (
+    google_dot_cloud_dot_firestore_dot_admin__v1_dot_proto_dot_index__pb2._INDEX
+)
+_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA.containing_type = _FIELDOPERATIONMETADATA
+_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA_CHANGETYPE.containing_type = (
+    _FIELDOPERATIONMETADATA_INDEXCONFIGDELTA
+)
+_FIELDOPERATIONMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FIELDOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FIELDOPERATIONMETADATA.fields_by_name[
+    "index_config_deltas"
+].message_type = _FIELDOPERATIONMETADATA_INDEXCONFIGDELTA
+_FIELDOPERATIONMETADATA.fields_by_name["state"].enum_type = _OPERATIONSTATE
+_FIELDOPERATIONMETADATA.fields_by_name["progress_documents"].message_type = _PROGRESS
+_FIELDOPERATIONMETADATA.fields_by_name["progress_bytes"].message_type = _PROGRESS
+_EXPORTDOCUMENTSMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTDOCUMENTSMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_EXPORTDOCUMENTSMETADATA.fields_by_name["operation_state"].enum_type = _OPERATIONSTATE
+_EXPORTDOCUMENTSMETADATA.fields_by_name["progress_documents"].message_type = _PROGRESS
+_EXPORTDOCUMENTSMETADATA.fields_by_name["progress_bytes"].message_type = _PROGRESS
+_IMPORTDOCUMENTSMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_IMPORTDOCUMENTSMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_IMPORTDOCUMENTSMETADATA.fields_by_name["operation_state"].enum_type = _OPERATIONSTATE
+_IMPORTDOCUMENTSMETADATA.fields_by_name["progress_documents"].message_type = _PROGRESS
+_IMPORTDOCUMENTSMETADATA.fields_by_name["progress_bytes"].message_type = _PROGRESS
+DESCRIPTOR.message_types_by_name["IndexOperationMetadata"] = _INDEXOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["FieldOperationMetadata"] = _FIELDOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["ExportDocumentsMetadata"] = _EXPORTDOCUMENTSMETADATA
+DESCRIPTOR.message_types_by_name["ImportDocumentsMetadata"] = _IMPORTDOCUMENTSMETADATA
+DESCRIPTOR.message_types_by_name["ExportDocumentsResponse"] = _EXPORTDOCUMENTSRESPONSE
+DESCRIPTOR.message_types_by_name["Progress"] = _PROGRESS
+DESCRIPTOR.enum_types_by_name["OperationState"] = _OPERATIONSTATE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+IndexOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "IndexOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INDEXOPERATIONMETADATA,
+        __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+        __doc__="""Metadata for
+  [google.longrunning.Operation][google.longrunning.Operation] results
+  from
+  [FirestoreAdmin.CreateIndex][google.firestore.admin.v1.FirestoreAdmin.CreateIndex].
+  
+  
+  Attributes:
+      start_time:
+          The time this operation started.
+      end_time:
+          The time this operation completed. Will be unset if operation
+          still in progress.
+      index:
+          The index resource that this operation is acting on. For
+          example: ``projects/{project_id}/databases/{database_id}/colle
+          ctionGroups/{collection_id}/indexes/{index_id}``
+      state:
+          The state of the operation.
+      progress_documents:
+          The progress, in documents, of this operation.
+      progress_bytes:
+          The progress, in bytes, of this operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.IndexOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(IndexOperationMetadata)
+
+FieldOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "FieldOperationMetadata",
+    (_message.Message,),
+    dict(
+        IndexConfigDelta=_reflection.GeneratedProtocolMessageType(
+            "IndexConfigDelta",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FIELDOPERATIONMETADATA_INDEXCONFIGDELTA,
+                __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+                __doc__="""Information about an index configuration change.
+    
+    
+    Attributes:
+        change_type:
+            Specifies how the index is changing.
+        index:
+            The index being changed.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.FieldOperationMetadata.IndexConfigDelta)
+            ),
+        ),
+        DESCRIPTOR=_FIELDOPERATIONMETADATA,
+        __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+        __doc__="""Metadata for
+  [google.longrunning.Operation][google.longrunning.Operation] results
+  from
+  [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField].
+  
+  
+  Attributes:
+      start_time:
+          The time this operation started.
+      end_time:
+          The time this operation completed. Will be unset if operation
+          still in progress.
+      field:
+          The field resource that this operation is acting on. For
+          example: ``projects/{project_id}/databases/{database_id}/colle
+          ctionGroups/{collection_id}/fields/{field_path}``
+      index_config_deltas:
+          A list of [IndexConfigDelta][google.firestore.admin.v1.FieldOp
+          erationMetadata.IndexConfigDelta], which describe the intent
+          of this operation.
+      state:
+          The state of the operation.
+      progress_documents:
+          The progress, in documents, of this operation.
+      progress_bytes:
+          The progress, in bytes, of this operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.FieldOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(FieldOperationMetadata)
+_sym_db.RegisterMessage(FieldOperationMetadata.IndexConfigDelta)
+
+ExportDocumentsMetadata = _reflection.GeneratedProtocolMessageType(
+    "ExportDocumentsMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDOCUMENTSMETADATA,
+        __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+        __doc__="""Metadata for
+  [google.longrunning.Operation][google.longrunning.Operation] results
+  from
+  [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1.FirestoreAdmin.ExportDocuments].
+  
+  
+  Attributes:
+      start_time:
+          The time this operation started.
+      end_time:
+          The time this operation completed. Will be unset if operation
+          still in progress.
+      operation_state:
+          The state of the export operation.
+      progress_documents:
+          The progress, in documents, of this operation.
+      progress_bytes:
+          The progress, in bytes, of this operation.
+      collection_ids:
+          Which collection ids are being exported.
+      output_uri_prefix:
+          Where the entities are being exported to.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ExportDocumentsMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ExportDocumentsMetadata)
+
+ImportDocumentsMetadata = _reflection.GeneratedProtocolMessageType(
+    "ImportDocumentsMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTDOCUMENTSMETADATA,
+        __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+        __doc__="""Metadata for
+  [google.longrunning.Operation][google.longrunning.Operation] results
+  from
+  [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1.FirestoreAdmin.ImportDocuments].
+  
+  
+  Attributes:
+      start_time:
+          The time this operation started.
+      end_time:
+          The time this operation completed. Will be unset if operation
+          still in progress.
+      operation_state:
+          The state of the import operation.
+      progress_documents:
+          The progress, in documents, of this operation.
+      progress_bytes:
+          The progress, in bytes, of this operation.
+      collection_ids:
+          Which collection ids are being imported.
+      input_uri_prefix:
+          The location of the documents being imported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ImportDocumentsMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ImportDocumentsMetadata)
+
+ExportDocumentsResponse = _reflection.GeneratedProtocolMessageType(
+    "ExportDocumentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTDOCUMENTSRESPONSE,
+        __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+        __doc__="""Returned in the
+  [google.longrunning.Operation][google.longrunning.Operation] response
+  field.
+  
+  
+  Attributes:
+      output_uri_prefix:
+          Location of the output files. This can be used to begin an
+          import into Cloud Firestore (this project or another project)
+          after the operation completes successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.ExportDocumentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ExportDocumentsResponse)
+
+Progress = _reflection.GeneratedProtocolMessageType(
+    "Progress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROGRESS,
+        __module__="google.cloud.firestore.admin_v1.proto.operation_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      estimated_work:
+          The amount of work estimated.
+      completed_work:
+          The amount of work completed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1.Progress)
+    ),
+)
+_sym_db.RegisterMessage(Progress)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_admin_v1/proto/operation_pb2_grpc.py b/firestore/google/cloud/firestore_admin_v1/proto/operation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/proto/operation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_admin_v1/types.py b/firestore/google/cloud/firestore_admin_v1/types.py
new file mode 100644
index 000000000000..53fdbebc6aa4
--- /dev/null
+++ b/firestore/google/cloud/firestore_admin_v1/types.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.firestore_admin_v1.proto import field_pb2
+from google.cloud.firestore_admin_v1.proto import firestore_admin_pb2
+from google.cloud.firestore_admin_v1.proto import index_pb2
+from google.cloud.firestore_admin_v1.proto import location_pb2
+from google.cloud.firestore_admin_v1.proto import operation_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    operations_pb2,
+    any_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [
+    field_pb2,
+    firestore_admin_pb2,
+    index_pb2,
+    location_pb2,
+    operation_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.firestore_admin_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/firestore/google/cloud/firestore_v1/__init__.py b/firestore/google/cloud/firestore_v1/__init__.py
new file mode 100644
index 000000000000..e4af45218ecc
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/__init__.py
@@ -0,0 +1,71 @@
+# Copyright 2019 Google LLC 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.
+
+"""Python idiomatic client for Google Cloud Firestore."""
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-firestore").version
+
+from google.cloud.firestore_v1 import types
+from google.cloud.firestore_v1._helpers import GeoPoint
+from google.cloud.firestore_v1._helpers import ExistsOption
+from google.cloud.firestore_v1._helpers import LastUpdateOption
+from google.cloud.firestore_v1._helpers import ReadAfterWriteError
+from google.cloud.firestore_v1._helpers import WriteOption
+from google.cloud.firestore_v1.batch import WriteBatch
+from google.cloud.firestore_v1.client import Client
+from google.cloud.firestore_v1.collection import CollectionReference
+from google.cloud.firestore_v1.transforms import ArrayRemove
+from google.cloud.firestore_v1.transforms import ArrayUnion
+from google.cloud.firestore_v1.transforms import DELETE_FIELD
+from google.cloud.firestore_v1.transforms import Increment
+from google.cloud.firestore_v1.transforms import Maximum
+from google.cloud.firestore_v1.transforms import Minimum
+from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+from google.cloud.firestore_v1.document import DocumentReference
+from google.cloud.firestore_v1.document import DocumentSnapshot
+from google.cloud.firestore_v1.gapic import enums
+from google.cloud.firestore_v1.query import Query
+from google.cloud.firestore_v1.transaction import Transaction
+from google.cloud.firestore_v1.transaction import transactional
+from google.cloud.firestore_v1.watch import Watch
+
+
+__all__ = [
+    "__version__",
+    "ArrayRemove",
+    "ArrayUnion",
+    "Client",
+    "CollectionReference",
+    "DELETE_FIELD",
+    "DocumentReference",
+    "DocumentSnapshot",
+    "enums",
+    "ExistsOption",
+    "GeoPoint",
+    "Increment",
+    "LastUpdateOption",
+    "Maximum",
+    "Minimum",
+    "Query",
+    "ReadAfterWriteError",
+    "SERVER_TIMESTAMP",
+    "Transaction",
+    "transactional",
+    "types",
+    "Watch",
+    "WriteBatch",
+    "WriteOption",
+]
diff --git a/firestore/google/cloud/firestore_v1/_helpers.py b/firestore/google/cloud/firestore_v1/_helpers.py
new file mode 100644
index 000000000000..09f5d7f41c0e
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/_helpers.py
@@ -0,0 +1,1049 @@
+# Copyright 2017 Google LLC 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.
+
+"""Common helpers shared across Google Cloud Firestore modules."""
+
+import datetime
+
+from google.protobuf import struct_pb2
+from google.type import latlng_pb2
+import grpc
+import six
+
+from google.cloud import exceptions
+from google.cloud._helpers import _datetime_to_pb_timestamp
+from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+from google.cloud.firestore_v1 import transforms
+from google.cloud.firestore_v1 import types
+from google.cloud.firestore_v1.field_path import FieldPath
+from google.cloud.firestore_v1.field_path import parse_field_path
+from google.cloud.firestore_v1.gapic import enums
+from google.cloud.firestore_v1.proto import common_pb2
+from google.cloud.firestore_v1.proto import document_pb2
+from google.cloud.firestore_v1.proto import write_pb2
+
+
+BAD_PATH_TEMPLATE = "A path element must be a string. Received {}, which is a {}."
+DOCUMENT_PATH_DELIMITER = "/"
+INACTIVE_TXN = "Transaction not in progress, cannot be used in API requests."
+READ_AFTER_WRITE_ERROR = "Attempted read after write in a transaction."
+BAD_REFERENCE_ERROR = (
+    "Reference value {!r} in unexpected format, expected to be of the form "
+    "``projects/{{project}}/databases/{{database}}/"
+    "documents/{{document_path}}``."
+)
+WRONG_APP_REFERENCE = (
+    "Document {!r} does not correspond to the same database " "({!r}) as the client."
+)
+REQUEST_TIME_ENUM = enums.DocumentTransform.FieldTransform.ServerValue.REQUEST_TIME
+_GRPC_ERROR_MAPPING = {
+    grpc.StatusCode.ALREADY_EXISTS: exceptions.Conflict,
+    grpc.StatusCode.NOT_FOUND: exceptions.NotFound,
+}
+
+
+class GeoPoint(object):
+    """Simple container for a geo point value.
+
+    Args:
+        latitude (float): Latitude of a point.
+        longitude (float): Longitude of a point.
+    """
+
+    def __init__(self, latitude, longitude):
+        self.latitude = latitude
+        self.longitude = longitude
+
+    def to_protobuf(self):
+        """Convert the current object to protobuf.
+
+        Returns:
+            google.type.latlng_pb2.LatLng: The current point as a protobuf.
+        """
+        return latlng_pb2.LatLng(latitude=self.latitude, longitude=self.longitude)
+
+    def __eq__(self, other):
+        """Compare two geo points for equality.
+
+        Returns:
+            Union[bool, NotImplemented]: :data:`True` if the points compare
+            equal, else :data:`False`. (Or :data:`NotImplemented` if
+            ``other`` is not a geo point.)
+        """
+        if not isinstance(other, GeoPoint):
+            return NotImplemented
+
+        return self.latitude == other.latitude and self.longitude == other.longitude
+
+    def __ne__(self, other):
+        """Compare two geo points for inequality.
+
+        Returns:
+            Union[bool, NotImplemented]: :data:`False` if the points compare
+            equal, else :data:`True`. (Or :data:`NotImplemented` if
+            ``other`` is not a geo point.)
+        """
+        equality_val = self.__eq__(other)
+        if equality_val is NotImplemented:
+            return NotImplemented
+        else:
+            return not equality_val
+
+
+def verify_path(path, is_collection):
+    """Verifies that a ``path`` has the correct form.
+
+    Checks that all of the elements in ``path`` are strings.
+
+    Args:
+        path (Tuple[str, ...]): The components in a collection or
+            document path.
+        is_collection (bool): Indicates if the ``path`` represents
+            a document or a collection.
+
+    Raises:
+        ValueError: if
+
+            * the ``path`` is empty
+            * ``is_collection=True`` and there are an even number of elements
+            * ``is_collection=False`` and there are an odd number of elements
+            * an element is not a string
+    """
+    num_elements = len(path)
+    if num_elements == 0:
+        raise ValueError("Document or collection path cannot be empty")
+
+    if is_collection:
+        if num_elements % 2 == 0:
+            raise ValueError("A collection must have an odd number of path elements")
+    else:
+        if num_elements % 2 == 1:
+            raise ValueError("A document must have an even number of path elements")
+
+    for element in path:
+        if not isinstance(element, six.string_types):
+            msg = BAD_PATH_TEMPLATE.format(element, type(element))
+            raise ValueError(msg)
+
+
+def encode_value(value):
+    """Converts a native Python value into a Firestore protobuf ``Value``.
+
+    Args:
+        value (Union[NoneType, bool, int, float, datetime.datetime, \
+            str, bytes, dict, ~google.cloud.Firestore.GeoPoint]): A native
+            Python value to convert to a protobuf field.
+
+    Returns:
+        ~google.cloud.firestore_v1.types.Value: A
+        value encoded as a Firestore protobuf.
+
+    Raises:
+        TypeError: If the ``value`` is not one of the accepted types.
+    """
+    if value is None:
+        return document_pb2.Value(null_value=struct_pb2.NULL_VALUE)
+
+    # Must come before six.integer_types since ``bool`` is an integer subtype.
+    if isinstance(value, bool):
+        return document_pb2.Value(boolean_value=value)
+
+    if isinstance(value, six.integer_types):
+        return document_pb2.Value(integer_value=value)
+
+    if isinstance(value, float):
+        return document_pb2.Value(double_value=value)
+
+    if isinstance(value, DatetimeWithNanoseconds):
+        return document_pb2.Value(timestamp_value=value.timestamp_pb())
+
+    if isinstance(value, datetime.datetime):
+        return document_pb2.Value(timestamp_value=_datetime_to_pb_timestamp(value))
+
+    if isinstance(value, six.text_type):
+        return document_pb2.Value(string_value=value)
+
+    if isinstance(value, six.binary_type):
+        return document_pb2.Value(bytes_value=value)
+
+    # NOTE: We avoid doing an isinstance() check for a Document
+    #       here to avoid import cycles.
+    document_path = getattr(value, "_document_path", None)
+    if document_path is not None:
+        return document_pb2.Value(reference_value=document_path)
+
+    if isinstance(value, GeoPoint):
+        return document_pb2.Value(geo_point_value=value.to_protobuf())
+
+    if isinstance(value, list):
+        value_list = [encode_value(element) for element in value]
+        value_pb = document_pb2.ArrayValue(values=value_list)
+        return document_pb2.Value(array_value=value_pb)
+
+    if isinstance(value, dict):
+        value_dict = encode_dict(value)
+        value_pb = document_pb2.MapValue(fields=value_dict)
+        return document_pb2.Value(map_value=value_pb)
+
+    raise TypeError(
+        "Cannot convert to a Firestore Value", value, "Invalid type", type(value)
+    )
+
+
+def encode_dict(values_dict):
+    """Encode a dictionary into protobuf ``Value``-s.
+
+    Args:
+        values_dict (dict): The dictionary to encode as protobuf fields.
+
+    Returns:
+        Dict[str, ~google.cloud.firestore_v1.types.Value]: A
+        dictionary of string keys and ``Value`` protobufs as dictionary
+        values.
+    """
+    return {key: encode_value(value) for key, value in six.iteritems(values_dict)}
+
+
+def reference_value_to_document(reference_value, client):
+    """Convert a reference value string to a document.
+
+    Args:
+        reference_value (str): A document reference value.
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            A client that has a document factory.
+
+    Returns:
+        :class:`~google.cloud.firestore_v1.document.DocumentReference`:
+            The document corresponding to ``reference_value``.
+
+    Raises:
+        ValueError: If the ``reference_value`` is not of the expected
+            format: ``projects/{project}/databases/{database}/documents/...``.
+        ValueError: If the ``reference_value`` does not come from the same
+            project / database combination as the ``client``.
+    """
+    # The first 5 parts are
+    # projects, {project}, databases, {database}, documents
+    parts = reference_value.split(DOCUMENT_PATH_DELIMITER, 5)
+    if len(parts) != 6:
+        msg = BAD_REFERENCE_ERROR.format(reference_value)
+        raise ValueError(msg)
+
+    # The sixth part is `a/b/c/d` (i.e. the document path)
+    document = client.document(parts[-1])
+    if document._document_path != reference_value:
+        msg = WRONG_APP_REFERENCE.format(reference_value, client._database_string)
+        raise ValueError(msg)
+
+    return document
+
+
+def decode_value(value, client):
+    """Converts a Firestore protobuf ``Value`` to a native Python value.
+
+    Args:
+        value (google.cloud.firestore_v1.types.Value): A
+            Firestore protobuf to be decoded / parsed / converted.
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            A client that has a document factory.
+
+    Returns:
+        Union[NoneType, bool, int, float, datetime.datetime, \
+            str, bytes, dict, ~google.cloud.Firestore.GeoPoint]: A native
+        Python value converted from the ``value``.
+
+    Raises:
+        NotImplementedError: If the ``value_type`` is ``reference_value``.
+        ValueError: If the ``value_type`` is unknown.
+    """
+    value_type = value.WhichOneof("value_type")
+
+    if value_type == "null_value":
+        return None
+    elif value_type == "boolean_value":
+        return value.boolean_value
+    elif value_type == "integer_value":
+        return value.integer_value
+    elif value_type == "double_value":
+        return value.double_value
+    elif value_type == "timestamp_value":
+        return DatetimeWithNanoseconds.from_timestamp_pb(value.timestamp_value)
+    elif value_type == "string_value":
+        return value.string_value
+    elif value_type == "bytes_value":
+        return value.bytes_value
+    elif value_type == "reference_value":
+        return reference_value_to_document(value.reference_value, client)
+    elif value_type == "geo_point_value":
+        return GeoPoint(value.geo_point_value.latitude, value.geo_point_value.longitude)
+    elif value_type == "array_value":
+        return [decode_value(element, client) for element in value.array_value.values]
+    elif value_type == "map_value":
+        return decode_dict(value.map_value.fields, client)
+    else:
+        raise ValueError("Unknown ``value_type``", value_type)
+
+
+def decode_dict(value_fields, client):
+    """Converts a protobuf map of Firestore ``Value``-s.
+
+    Args:
+        value_fields (google.protobuf.pyext._message.MessageMapContainer): A
+            protobuf map of Firestore ``Value``-s.
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            A client that has a document factory.
+
+    Returns:
+        Dict[str, Union[NoneType, bool, int, float, datetime.datetime, \
+            str, bytes, dict, ~google.cloud.Firestore.GeoPoint]]: A dictionary
+        of native Python values converted from the ``value_fields``.
+    """
+    return {
+        key: decode_value(value, client) for key, value in six.iteritems(value_fields)
+    }
+
+
+def get_doc_id(document_pb, expected_prefix):
+    """Parse a document ID from a document protobuf.
+
+    Args:
+        document_pb (google.cloud.proto.firestore.v1.\
+            document_pb2.Document): A protobuf for a document that
+            was created in a ``CreateDocument`` RPC.
+        expected_prefix (str): The expected collection prefix for the
+            fully-qualified document name.
+
+    Returns:
+        str: The document ID from the protobuf.
+
+    Raises:
+        ValueError: If the name does not begin with the prefix.
+    """
+    prefix, document_id = document_pb.name.rsplit(DOCUMENT_PATH_DELIMITER, 1)
+    if prefix != expected_prefix:
+        raise ValueError(
+            "Unexpected document name",
+            document_pb.name,
+            "Expected to begin with",
+            expected_prefix,
+        )
+
+    return document_id
+
+
+_EmptyDict = transforms.Sentinel("Marker for an empty dict value")
+
+
+def extract_fields(document_data, prefix_path, expand_dots=False):
+    """Do depth-first walk of tree, yielding field_path, value"""
+    if not document_data:
+        yield prefix_path, _EmptyDict
+    else:
+        for key, value in sorted(six.iteritems(document_data)):
+
+            if expand_dots:
+                sub_key = FieldPath.from_string(key)
+            else:
+                sub_key = FieldPath(key)
+
+            field_path = FieldPath(*(prefix_path.parts + sub_key.parts))
+
+            if isinstance(value, dict):
+                for s_path, s_value in extract_fields(value, field_path):
+                    yield s_path, s_value
+            else:
+                yield field_path, value
+
+
+def set_field_value(document_data, field_path, value):
+    """Set a value into a document for a field_path"""
+    current = document_data
+    for element in field_path.parts[:-1]:
+        current = current.setdefault(element, {})
+    if value is _EmptyDict:
+        value = {}
+    current[field_path.parts[-1]] = value
+
+
+def get_field_value(document_data, field_path):
+    if not field_path.parts:
+        raise ValueError("Empty path")
+
+    current = document_data
+    for element in field_path.parts[:-1]:
+        current = current[element]
+    return current[field_path.parts[-1]]
+
+
+class DocumentExtractor(object):
+    """ Break document data up into actual data and transforms.
+
+    Handle special values such as ``DELETE_FIELD``, ``SERVER_TIMESTAMP``.
+
+    Args:
+        document_data (dict):
+            Property names and values to use for sending a change to
+            a document.
+    """
+
+    def __init__(self, document_data):
+        self.document_data = document_data
+        self.field_paths = []
+        self.deleted_fields = []
+        self.server_timestamps = []
+        self.array_removes = {}
+        self.array_unions = {}
+        self.increments = {}
+        self.minimums = {}
+        self.maximums = {}
+        self.set_fields = {}
+        self.empty_document = False
+
+        prefix_path = FieldPath()
+        iterator = self._get_document_iterator(prefix_path)
+
+        for field_path, value in iterator:
+
+            if field_path == prefix_path and value is _EmptyDict:
+                self.empty_document = True
+
+            elif value is transforms.DELETE_FIELD:
+                self.deleted_fields.append(field_path)
+
+            elif value is transforms.SERVER_TIMESTAMP:
+                self.server_timestamps.append(field_path)
+
+            elif isinstance(value, transforms.ArrayRemove):
+                self.array_removes[field_path] = value.values
+
+            elif isinstance(value, transforms.ArrayUnion):
+                self.array_unions[field_path] = value.values
+
+            elif isinstance(value, transforms.Increment):
+                self.increments[field_path] = value.value
+
+            elif isinstance(value, transforms.Maximum):
+                self.maximums[field_path] = value.value
+
+            elif isinstance(value, transforms.Minimum):
+                self.minimums[field_path] = value.value
+
+            else:
+                self.field_paths.append(field_path)
+                set_field_value(self.set_fields, field_path, value)
+
+    def _get_document_iterator(self, prefix_path):
+        return extract_fields(self.document_data, prefix_path)
+
+    @property
+    def has_transforms(self):
+        return bool(
+            self.server_timestamps
+            or self.array_removes
+            or self.array_unions
+            or self.increments
+            or self.maximums
+            or self.minimums
+        )
+
+    @property
+    def transform_paths(self):
+        return sorted(
+            self.server_timestamps
+            + list(self.array_removes)
+            + list(self.array_unions)
+            + list(self.increments)
+            + list(self.maximums)
+            + list(self.minimums)
+        )
+
+    def _get_update_mask(self, allow_empty_mask=False):
+        return None
+
+    def get_update_pb(self, document_path, exists=None, allow_empty_mask=False):
+
+        if exists is not None:
+            current_document = common_pb2.Precondition(exists=exists)
+        else:
+            current_document = None
+
+        update_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=encode_dict(self.set_fields)
+            ),
+            update_mask=self._get_update_mask(allow_empty_mask),
+            current_document=current_document,
+        )
+
+        return update_pb
+
+    def get_transform_pb(self, document_path, exists=None):
+        def make_array_value(values):
+            value_list = [encode_value(element) for element in values]
+            return document_pb2.ArrayValue(values=value_list)
+
+        path_field_transforms = (
+            [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(),
+                        set_to_server_value=REQUEST_TIME_ENUM,
+                    ),
+                )
+                for path in self.server_timestamps
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(),
+                        remove_all_from_array=make_array_value(values),
+                    ),
+                )
+                for path, values in self.array_removes.items()
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(),
+                        append_missing_elements=make_array_value(values),
+                    ),
+                )
+                for path, values in self.array_unions.items()
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(), increment=encode_value(value)
+                    ),
+                )
+                for path, value in self.increments.items()
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(), maximum=encode_value(value)
+                    ),
+                )
+                for path, value in self.maximums.items()
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(), minimum=encode_value(value)
+                    ),
+                )
+                for path, value in self.minimums.items()
+            ]
+        )
+        field_transforms = [
+            transform for path, transform in sorted(path_field_transforms)
+        ]
+        transform_pb = write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=field_transforms
+            )
+        )
+        if exists is not None:
+            transform_pb.current_document.CopyFrom(
+                common_pb2.Precondition(exists=exists)
+            )
+
+        return transform_pb
+
+
+def pbs_for_create(document_path, document_data):
+    """Make ``Write`` protobufs for ``create()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        document_data (dict): Property names and values to use for
+            creating a document.
+
+    Returns:
+        List[google.cloud.firestore_v1.types.Write]: One or two
+        ``Write`` protobuf instances for ``create()``.
+    """
+    extractor = DocumentExtractor(document_data)
+
+    if extractor.deleted_fields:
+        raise ValueError("Cannot apply DELETE_FIELD in a create request.")
+
+    write_pbs = []
+
+    # Conformance tests require skipping the 'update_pb' if the document
+    # contains only transforms.
+    if extractor.empty_document or extractor.set_fields:
+        write_pbs.append(extractor.get_update_pb(document_path, exists=False))
+
+    if extractor.has_transforms:
+        exists = None if write_pbs else False
+        transform_pb = extractor.get_transform_pb(document_path, exists)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+def pbs_for_set_no_merge(document_path, document_data):
+    """Make ``Write`` protobufs for ``set()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        document_data (dict): Property names and values to use for
+            replacing a document.
+
+    Returns:
+        List[google.cloud.firestore_v1.types.Write]: One
+        or two ``Write`` protobuf instances for ``set()``.
+    """
+    extractor = DocumentExtractor(document_data)
+
+    if extractor.deleted_fields:
+        raise ValueError(
+            "Cannot apply DELETE_FIELD in a set request without "
+            "specifying 'merge=True' or 'merge=[field_paths]'."
+        )
+
+    # Conformance tests require send the 'update_pb' even if the document
+    # contains only transforms.
+    write_pbs = [extractor.get_update_pb(document_path)]
+
+    if extractor.has_transforms:
+        transform_pb = extractor.get_transform_pb(document_path)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+class DocumentExtractorForMerge(DocumentExtractor):
+    """ Break document data up into actual data and transforms.
+    """
+
+    def __init__(self, document_data):
+        super(DocumentExtractorForMerge, self).__init__(document_data)
+        self.data_merge = []
+        self.transform_merge = []
+        self.merge = []
+
+    @property
+    def has_updates(self):
+        # for whatever reason, the conformance tests want to see the parent
+        # of nested transform paths in the update mask
+        # (see set-st-merge-nonleaf-alone.textproto)
+        update_paths = set(self.data_merge)
+
+        for transform_path in self.transform_paths:
+            if len(transform_path.parts) > 1:
+                parent_fp = FieldPath(*transform_path.parts[:-1])
+                update_paths.add(parent_fp)
+
+        return bool(update_paths)
+
+    def _apply_merge_all(self):
+        self.data_merge = sorted(self.field_paths + self.deleted_fields)
+        # TODO: other transforms
+        self.transform_merge = self.transform_paths
+        self.merge = sorted(self.data_merge + self.transform_paths)
+
+    def _construct_merge_paths(self, merge):
+        for merge_field in merge:
+            if isinstance(merge_field, FieldPath):
+                yield merge_field
+            else:
+                yield FieldPath(*parse_field_path(merge_field))
+
+    def _normalize_merge_paths(self, merge):
+        merge_paths = sorted(self._construct_merge_paths(merge))
+
+        # Raise if any merge path is a parent of another.  Leverage sorting
+        # to avoid quadratic behavior.
+        for index in range(len(merge_paths) - 1):
+            lhs, rhs = merge_paths[index], merge_paths[index + 1]
+            if lhs.eq_or_parent(rhs):
+                raise ValueError("Merge paths overlap: {}, {}".format(lhs, rhs))
+
+        for merge_path in merge_paths:
+            if merge_path in self.deleted_fields:
+                continue
+            try:
+                get_field_value(self.document_data, merge_path)
+            except KeyError:
+                raise ValueError("Invalid merge path: {}".format(merge_path))
+
+        return merge_paths
+
+    def _apply_merge_paths(self, merge):
+
+        if self.empty_document:
+            raise ValueError("Cannot merge specific fields with empty document.")
+
+        merge_paths = self._normalize_merge_paths(merge)
+
+        del self.data_merge[:]
+        del self.transform_merge[:]
+        self.merge = merge_paths
+
+        for merge_path in merge_paths:
+
+            if merge_path in self.transform_paths:
+                self.transform_merge.append(merge_path)
+
+            for field_path in self.field_paths:
+                if merge_path.eq_or_parent(field_path):
+                    self.data_merge.append(field_path)
+
+        # Clear out data for fields not merged.
+        merged_set_fields = {}
+        for field_path in self.data_merge:
+            value = get_field_value(self.document_data, field_path)
+            set_field_value(merged_set_fields, field_path, value)
+        self.set_fields = merged_set_fields
+
+        unmerged_deleted_fields = [
+            field_path
+            for field_path in self.deleted_fields
+            if field_path not in self.merge
+        ]
+        if unmerged_deleted_fields:
+            raise ValueError(
+                "Cannot delete unmerged fields: {}".format(unmerged_deleted_fields)
+            )
+        self.data_merge = sorted(self.data_merge + self.deleted_fields)
+
+        # Keep only transforms which are within merge.
+        merged_transform_paths = set()
+        for merge_path in self.merge:
+            tranform_merge_paths = [
+                transform_path
+                for transform_path in self.transform_paths
+                if merge_path.eq_or_parent(transform_path)
+            ]
+            merged_transform_paths.update(tranform_merge_paths)
+
+        self.server_timestamps = [
+            path for path in self.server_timestamps if path in merged_transform_paths
+        ]
+
+        self.array_removes = {
+            path: values
+            for path, values in self.array_removes.items()
+            if path in merged_transform_paths
+        }
+
+        self.array_unions = {
+            path: values
+            for path, values in self.array_unions.items()
+            if path in merged_transform_paths
+        }
+
+    def apply_merge(self, merge):
+        if merge is True:  # merge all fields
+            self._apply_merge_all()
+        else:
+            self._apply_merge_paths(merge)
+
+    def _get_update_mask(self, allow_empty_mask=False):
+        # Mask uses dotted / quoted paths.
+        mask_paths = [
+            field_path.to_api_repr()
+            for field_path in self.merge
+            if field_path not in self.transform_merge
+        ]
+
+        if mask_paths or allow_empty_mask:
+            return common_pb2.DocumentMask(field_paths=mask_paths)
+
+
+def pbs_for_set_with_merge(document_path, document_data, merge):
+    """Make ``Write`` protobufs for ``set()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        document_data (dict): Property names and values to use for
+            replacing a document.
+        merge (Optional[bool] or Optional[List<apispec>]):
+            If True, merge all fields; else, merge only the named fields.
+
+    Returns:
+        List[google.cloud.firestore_v1.types.Write]: One
+        or two ``Write`` protobuf instances for ``set()``.
+    """
+    extractor = DocumentExtractorForMerge(document_data)
+    extractor.apply_merge(merge)
+
+    merge_empty = not document_data
+
+    write_pbs = []
+
+    if extractor.has_updates or merge_empty:
+        write_pbs.append(
+            extractor.get_update_pb(document_path, allow_empty_mask=merge_empty)
+        )
+
+    if extractor.transform_paths:
+        transform_pb = extractor.get_transform_pb(document_path)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+class DocumentExtractorForUpdate(DocumentExtractor):
+    """ Break document data up into actual data and transforms.
+    """
+
+    def __init__(self, document_data):
+        super(DocumentExtractorForUpdate, self).__init__(document_data)
+        self.top_level_paths = sorted(
+            [FieldPath.from_string(key) for key in document_data]
+        )
+        tops = set(self.top_level_paths)
+        for top_level_path in self.top_level_paths:
+            for ancestor in top_level_path.lineage():
+                if ancestor in tops:
+                    raise ValueError(
+                        "Conflicting field path: {}, {}".format(
+                            top_level_path, ancestor
+                        )
+                    )
+
+        for field_path in self.deleted_fields:
+            if field_path not in tops:
+                raise ValueError(
+                    "Cannot update with nest delete: {}".format(field_path)
+                )
+
+    def _get_document_iterator(self, prefix_path):
+        return extract_fields(self.document_data, prefix_path, expand_dots=True)
+
+    def _get_update_mask(self, allow_empty_mask=False):
+        mask_paths = []
+        for field_path in self.top_level_paths:
+            if field_path not in self.transform_paths:
+                mask_paths.append(field_path.to_api_repr())
+
+        return common_pb2.DocumentMask(field_paths=mask_paths)
+
+
+def pbs_for_update(document_path, field_updates, option):
+    """Make ``Write`` protobufs for ``update()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        field_updates (dict): Field names or paths to update and values
+            to update with.
+        option (optional[:class:`~google.cloud.firestore_v1.client.WriteOption`]):
+            A write option to make assertions / preconditions on the server
+            state of the document before applying changes.
+
+    Returns:
+        List[google.cloud.firestore_v1.types.Write]: One
+        or two ``Write`` protobuf instances for ``update()``.
+    """
+    extractor = DocumentExtractorForUpdate(field_updates)
+
+    if extractor.empty_document:
+        raise ValueError("Cannot update with an empty document.")
+
+    if option is None:  # Default is to use ``exists=True``.
+        option = ExistsOption(exists=True)
+
+    write_pbs = []
+
+    if extractor.field_paths or extractor.deleted_fields:
+        update_pb = extractor.get_update_pb(document_path)
+        option.modify_write(update_pb)
+        write_pbs.append(update_pb)
+
+    if extractor.has_transforms:
+        transform_pb = extractor.get_transform_pb(document_path)
+        if not write_pbs:
+            # NOTE: set the write option on the ``transform_pb`` only if there
+            #       is no ``update_pb``
+            option.modify_write(transform_pb)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+def pb_for_delete(document_path, option):
+    """Make a ``Write`` protobuf for ``delete()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        option (optional[:class:`~google.cloud.firestore_v1.client.WriteOption`]):
+            A write option to make assertions / preconditions on the server
+            state of the document before applying changes.
+
+    Returns:
+        google.cloud.firestore_v1.types.Write: A
+        ``Write`` protobuf instance for the ``delete()``.
+    """
+    write_pb = write_pb2.Write(delete=document_path)
+    if option is not None:
+        option.modify_write(write_pb)
+
+    return write_pb
+
+
+class ReadAfterWriteError(Exception):
+    """Raised when a read is attempted after a write.
+
+    Raised by "read" methods that use transactions.
+    """
+
+
+def get_transaction_id(transaction, read_operation=True):
+    """Get the transaction ID from a ``Transaction`` object.
+
+    Args:
+        transaction (Optional[:class:`~google.cloud.firestore_v1.transaction.\
+            Transaction`]):
+            An existing transaction that this query will run in.
+        read_operation (Optional[bool]): Indicates if the transaction ID
+            will be used in a read operation. Defaults to :data:`True`.
+
+    Returns:
+        Optional[bytes]: The ID of the transaction, or :data:`None` if the
+        ``transaction`` is :data:`None`.
+
+    Raises:
+        ValueError: If the ``transaction`` is not in progress (only if
+            ``transaction`` is not :data:`None`).
+        ReadAfterWriteError: If the ``transaction`` has writes stored on
+            it and ``read_operation`` is :data:`True`.
+    """
+    if transaction is None:
+        return None
+    else:
+        if not transaction.in_progress:
+            raise ValueError(INACTIVE_TXN)
+        if read_operation and len(transaction._write_pbs) > 0:
+            raise ReadAfterWriteError(READ_AFTER_WRITE_ERROR)
+        return transaction.id
+
+
+def metadata_with_prefix(prefix, **kw):
+    """Create RPC metadata containing a prefix.
+
+    Args:
+        prefix (str): appropriate resource path.
+
+    Returns:
+        List[Tuple[str, str]]: RPC metadata with supplied prefix
+    """
+    return [("google-cloud-resource-prefix", prefix)]
+
+
+class WriteOption(object):
+    """Option used to assert a condition on a write operation."""
+
+    def modify_write(self, write_pb, no_create_msg=None):
+        """Modify a ``Write`` protobuf based on the state of this write option.
+
+        This is a virtual method intended to be implemented by subclasses.
+
+        Args:
+            write_pb (google.cloud.firestore_v1.types.Write): A
+                ``Write`` protobuf instance to be modified with a precondition
+                determined by the state of this option.
+            no_create_msg (Optional[str]): A message to use to indicate that
+                a create operation is not allowed.
+
+        Raises:
+            NotImplementedError: Always, this method is virtual.
+        """
+        raise NotImplementedError
+
+
+class LastUpdateOption(WriteOption):
+    """Option used to assert a "last update" condition on a write operation.
+
+    This will typically be created by
+    :meth:`~google.cloud.firestore_v1.client.Client.write_option`.
+
+    Args:
+        last_update_time (google.protobuf.timestamp_pb2.Timestamp): A
+            timestamp. When set, the target document must exist and have
+            been last updated at that time. Protobuf ``update_time`` timestamps
+            are typically returned from methods that perform write operations
+            as part of a "write result" protobuf or directly.
+    """
+
+    def __init__(self, last_update_time):
+        self._last_update_time = last_update_time
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._last_update_time == other._last_update_time
+
+    def modify_write(self, write_pb, **unused_kwargs):
+        """Modify a ``Write`` protobuf based on the state of this write option.
+
+        The ``last_update_time`` is added to ``write_pb`` as an "update time"
+        precondition. When set, the target document must exist and have been
+        last updated at that time.
+
+        Args:
+            write_pb (google.cloud.firestore_v1.types.Write): A
+                ``Write`` protobuf instance to be modified with a precondition
+                determined by the state of this option.
+            unused_kwargs (Dict[str, Any]): Keyword arguments accepted by
+                other subclasses that are unused here.
+        """
+        current_doc = types.Precondition(update_time=self._last_update_time)
+        write_pb.current_document.CopyFrom(current_doc)
+
+
+class ExistsOption(WriteOption):
+    """Option used to assert existence on a write operation.
+
+    This will typically be created by
+    :meth:`~google.cloud.firestore_v1.client.Client.write_option`.
+
+    Args:
+        exists (bool): Indicates if the document being modified
+            should already exist.
+    """
+
+    def __init__(self, exists):
+        self._exists = exists
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._exists == other._exists
+
+    def modify_write(self, write_pb, **unused_kwargs):
+        """Modify a ``Write`` protobuf based on the state of this write option.
+
+        If:
+
+        * ``exists=True``, adds a precondition that requires existence
+        * ``exists=False``, adds a precondition that requires non-existence
+
+        Args:
+            write_pb (google.cloud.firestore_v1.types.Write): A
+                ``Write`` protobuf instance to be modified with a precondition
+                determined by the state of this option.
+            unused_kwargs (Dict[str, Any]): Keyword arguments accepted by
+                other subclasses that are unused here.
+        """
+        current_doc = types.Precondition(exists=self._exists)
+        write_pb.current_document.CopyFrom(current_doc)
diff --git a/firestore/google/cloud/firestore_v1/batch.py b/firestore/google/cloud/firestore_v1/batch.py
new file mode 100644
index 000000000000..56483af10c72
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/batch.py
@@ -0,0 +1,160 @@
+# Copyright 2017 Google LLC 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.
+
+"""Helpers for batch requests to the Google Cloud Firestore API."""
+
+
+from google.cloud.firestore_v1 import _helpers
+
+
+class WriteBatch(object):
+    """Accumulate write operations to be sent in a batch.
+
+    This has the same set of methods for write operations that
+    :class:`~google.cloud.firestore_v1.document.DocumentReference` does,
+    e.g. :meth:`~google.cloud.firestore_v1.document.DocumentReference.create`.
+
+    Args:
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            The client that created this batch.
+    """
+
+    def __init__(self, client):
+        self._client = client
+        self._write_pbs = []
+        self.write_results = None
+        self.commit_time = None
+
+    def _add_write_pbs(self, write_pbs):
+        """Add `Write`` protobufs to this transaction.
+
+        This method intended to be over-ridden by subclasses.
+
+        Args:
+            write_pbs (List[google.cloud.proto.firestore.v1.\
+                write_pb2.Write]): A list of write protobufs to be added.
+        """
+        self._write_pbs.extend(write_pbs)
+
+    def create(self, reference, document_data):
+        """Add a "change" to this batch to create a document.
+
+        If the document given by ``reference`` already exists, then this
+        batch will fail when :meth:`commit`-ed.
+
+        Args:
+            reference (:class:`~google.cloud.firestore_v1.document.DocumentReference`):
+                A document reference to be created in this batch.
+            document_data (dict): Property names and values to use for
+                creating a document.
+        """
+        write_pbs = _helpers.pbs_for_create(reference._document_path, document_data)
+        self._add_write_pbs(write_pbs)
+
+    def set(self, reference, document_data, merge=False):
+        """Add a "change" to replace a document.
+
+        See
+        :meth:`google.cloud.firestore_v1.document.DocumentReference.set` for
+        more information on how ``option`` determines how the change is
+        applied.
+
+        Args:
+            reference (:class:`~google.cloud.firestore_v1.document.DocumentReference`):
+                A document reference that will have values set in this batch.
+            document_data (dict):
+                Property names and values to use for replacing a document.
+            merge (Optional[bool] or Optional[List<apispec>]):
+                If True, apply merging instead of overwriting the state
+                of the document.
+        """
+        if merge is not False:
+            write_pbs = _helpers.pbs_for_set_with_merge(
+                reference._document_path, document_data, merge
+            )
+        else:
+            write_pbs = _helpers.pbs_for_set_no_merge(
+                reference._document_path, document_data
+            )
+
+        self._add_write_pbs(write_pbs)
+
+    def update(self, reference, field_updates, option=None):
+        """Add a "change" to update a document.
+
+        See
+        :meth:`google.cloud.firestore_v1.document.DocumentReference.update`
+        for more information on ``field_updates`` and ``option``.
+
+        Args:
+            reference (:class:`~google.cloud.firestore_v1.document.DocumentReference`):
+                A document reference that will be updated in this batch.
+            field_updates (dict):
+                Field names or paths to update and values to update with.
+            option (Optional[:class:`~google.cloud.firestore_v1.client.WriteOption`]):
+                A write option to make assertions / preconditions on the server
+                state of the document before applying changes.
+        """
+        if option.__class__.__name__ == "ExistsOption":
+            raise ValueError("you must not pass an explicit write option to " "update.")
+        write_pbs = _helpers.pbs_for_update(
+            reference._document_path, field_updates, option
+        )
+        self._add_write_pbs(write_pbs)
+
+    def delete(self, reference, option=None):
+        """Add a "change" to delete a document.
+
+        See
+        :meth:`google.cloud.firestore_v1.document.DocumentReference.delete`
+        for more information on how ``option`` determines how the change is
+        applied.
+
+        Args:
+            reference (:class:`~google.cloud.firestore_v1.document.DocumentReference`):
+                A document reference that will be deleted in this batch.
+            option (Optional[:class:`~google.cloud.firestore_v1.client.WriteOption`]):
+                A write option to make assertions / preconditions on the server
+                state of the document before applying changes.
+        """
+        write_pb = _helpers.pb_for_delete(reference._document_path, option)
+        self._add_write_pbs([write_pb])
+
+    def commit(self):
+        """Commit the changes accumulated in this batch.
+
+        Returns:
+            List[:class:`google.cloud.proto.firestore.v1.write_pb2.WriteResult`, ...]:
+            The write results corresponding to the changes committed, returned
+            in the same order as the changes were applied to this batch. A
+            write result contains an ``update_time`` field.
+        """
+        commit_response = self._client._firestore_api.commit(
+            self._client._database_string,
+            self._write_pbs,
+            transaction=None,
+            metadata=self._client._rpc_metadata,
+        )
+
+        self._write_pbs = []
+        self.write_results = results = list(commit_response.write_results)
+        self.commit_time = commit_response.commit_time
+        return results
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        if exc_type is None:
+            self.commit()
diff --git a/firestore/google/cloud/firestore_v1/client.py b/firestore/google/cloud/firestore_v1/client.py
new file mode 100644
index 000000000000..da09b9ff4415
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/client.py
@@ -0,0 +1,619 @@
+# Copyright 2017 Google LLC 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.
+
+"""Client for interacting with the Google Cloud Firestore API.
+
+This is the base from which all interactions with the API occur.
+
+In the hierarchy of API concepts
+
+* a :class:`~google.cloud.firestore_v1.client.Client` owns a
+  :class:`~google.cloud.firestore_v1.collection.CollectionReference`
+* a :class:`~google.cloud.firestore_v1.client.Client` owns a
+  :class:`~google.cloud.firestore_v1.document.DocumentReference`
+"""
+import os
+
+import google.api_core.client_options
+from google.api_core.gapic_v1 import client_info
+from google.cloud.client import ClientWithProject
+
+from google.cloud.firestore_v1 import _helpers
+from google.cloud.firestore_v1 import __version__
+from google.cloud.firestore_v1 import query
+from google.cloud.firestore_v1 import types
+from google.cloud.firestore_v1.batch import WriteBatch
+from google.cloud.firestore_v1.collection import CollectionReference
+from google.cloud.firestore_v1.document import DocumentReference
+from google.cloud.firestore_v1.document import DocumentSnapshot
+from google.cloud.firestore_v1.field_path import render_field_path
+from google.cloud.firestore_v1.gapic import firestore_client
+from google.cloud.firestore_v1.gapic.transports import firestore_grpc_transport
+from google.cloud.firestore_v1.transaction import Transaction
+
+
+DEFAULT_DATABASE = "(default)"
+"""str: The default database used in a :class:`~google.cloud.firestore_v1.client.Client`."""
+_BAD_OPTION_ERR = (
+    "Exactly one of ``last_update_time`` or ``exists`` " "must be provided."
+)
+_BAD_DOC_TEMPLATE = (
+    "Document {!r} appeared in response but was not present among references"
+)
+_ACTIVE_TXN = "There is already an active transaction."
+_INACTIVE_TXN = "There is no active transaction."
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+_FIRESTORE_EMULATOR_HOST = "FIRESTORE_EMULATOR_HOST"
+
+
+class Client(ClientWithProject):
+    """Client for interacting with Google Cloud Firestore API.
+
+    .. note::
+
+        Since the Cloud Firestore API requires the gRPC transport, no
+        ``_http`` argument is accepted by this class.
+
+    Args:
+        project (Optional[str]): The project which the client acts on behalf
+            of. If not passed, falls back to the default inferred
+            from the environment.
+        credentials (Optional[~google.auth.credentials.Credentials]): The
+            OAuth2 Credentials to use for this client. If not passed, falls
+            back to the default inferred from the environment.
+        database (Optional[str]): The database name that the client targets.
+            For now, :attr:`DEFAULT_DATABASE` (the default value) is the
+            only valid database.
+        client_info (Optional[google.api_core.gapic_v1.client_info.ClientInfo]):
+            The client info used to send a user-agent string along with API
+            requests. If ``None``, then default info will be used. Generally,
+            you only need to set this if you're developing your own library
+            or partner tool.
+        client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+            Client options used to set user options on the client. API Endpoint
+            should be set through client_options.
+    """
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/datastore",
+    )
+    """The scopes required for authenticating with the Firestore service."""
+
+    _firestore_api_internal = None
+    _database_string_internal = None
+    _rpc_metadata_internal = None
+
+    def __init__(
+        self,
+        project=None,
+        credentials=None,
+        database=DEFAULT_DATABASE,
+        client_info=_CLIENT_INFO,
+        client_options=None,
+    ):
+        # NOTE: This API has no use for the _http argument, but sending it
+        #       will have no impact since the _http() @property only lazily
+        #       creates a working HTTP object.
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=None
+        )
+        self._client_info = client_info
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+        self._client_options = client_options
+
+        self._database = database
+        self._emulator_host = os.getenv(_FIRESTORE_EMULATOR_HOST)
+
+    @property
+    def _firestore_api(self):
+        """Lazy-loading getter GAPIC Firestore API.
+
+        Returns:
+            :class:`~google.cloud.gapic.firestore.v1`.firestore_client.FirestoreClient:
+            <The GAPIC client with the credentials of the current client.
+        """
+        if self._firestore_api_internal is None:
+            # Use a custom channel.
+            # We need this in order to set appropriate keepalive options.
+
+            if self._emulator_host is not None:
+                channel = firestore_grpc_transport.firestore_pb2_grpc.grpc.insecure_channel(
+                    self._emulator_host
+                )
+            else:
+                channel = firestore_grpc_transport.FirestoreGrpcTransport.create_channel(
+                    self._target,
+                    credentials=self._credentials,
+                    options={"grpc.keepalive_time_ms": 30000}.items(),
+                )
+
+            self._transport = firestore_grpc_transport.FirestoreGrpcTransport(
+                address=self._target, channel=channel
+            )
+
+            self._firestore_api_internal = firestore_client.FirestoreClient(
+                transport=self._transport, client_info=self._client_info
+            )
+
+        return self._firestore_api_internal
+
+    @property
+    def _target(self):
+        """Return the target (where the API is).
+
+        Returns:
+            str: The location of the API.
+        """
+        if self._emulator_host is not None:
+            return self._emulator_host
+        elif self._client_options and self._client_options.api_endpoint:
+            return self._client_options.api_endpoint
+        else:
+            return firestore_client.FirestoreClient.SERVICE_ADDRESS
+
+    @property
+    def _database_string(self):
+        """The database string corresponding to this client's project.
+
+        This value is lazy-loaded and cached.
+
+        Will be of the form
+
+            ``projects/{project_id}/databases/{database_id}``
+
+        but ``database_id == '(default)'`` for the time being.
+
+        Returns:
+            str: The fully-qualified database string for the current
+            project. (The default database is also in this string.)
+        """
+        if self._database_string_internal is None:
+            # NOTE: database_root_path() is a classmethod, so we don't use
+            #       self._firestore_api (it isn't necessary).
+            db_str = firestore_client.FirestoreClient.database_root_path(
+                self.project, self._database
+            )
+            self._database_string_internal = db_str
+
+        return self._database_string_internal
+
+    @property
+    def _rpc_metadata(self):
+        """The RPC metadata for this client's associated database.
+
+        Returns:
+            Sequence[Tuple(str, str)]: RPC metadata with resource prefix
+            for the database associated with this client.
+        """
+        if self._rpc_metadata_internal is None:
+            self._rpc_metadata_internal = _helpers.metadata_with_prefix(
+                self._database_string
+            )
+
+            if self._emulator_host is not None:
+                # The emulator requires additional metadata to be set.
+                self._rpc_metadata_internal.append(("authorization", "Bearer owner"))
+
+        return self._rpc_metadata_internal
+
+    def collection(self, *collection_path):
+        """Get a reference to a collection.
+
+        For a top-level collection:
+
+        .. code-block:: python
+
+            >>> client.collection('top')
+
+        For a sub-collection:
+
+        .. code-block:: python
+
+            >>> client.collection('mydocs/doc/subcol')
+            >>> # is the same as
+            >>> client.collection('mydocs', 'doc', 'subcol')
+
+        Sub-collections can be nested deeper in a similar fashion.
+
+        Args:
+            collection_path (Tuple[str, ...]): Can either be
+
+                * A single ``/``-delimited path to a collection
+                * A tuple of collection path segments
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.collection.CollectionReference`:
+            A reference to a collection in the Firestore database.
+        """
+        if len(collection_path) == 1:
+            path = collection_path[0].split(_helpers.DOCUMENT_PATH_DELIMITER)
+        else:
+            path = collection_path
+
+        return CollectionReference(*path, client=self)
+
+    def collection_group(self, collection_id):
+        """
+        Creates and returns a new Query that includes all documents in the
+        database that are contained in a collection or subcollection with the
+        given collection_id.
+
+        .. code-block:: python
+
+            >>> query = client.collection_group('mygroup')
+
+        @param {string} collectionId Identifies the collections to query over.
+        Every collection or subcollection with this ID as the last segment of its
+        path will be included. Cannot contain a slash.
+        @returns {Query} The created Query.
+        """
+        if "/" in collection_id:
+            raise ValueError(
+                "Invalid collection_id "
+                + collection_id
+                + ". Collection IDs must not contain '/'."
+            )
+
+        collection = self.collection(collection_id)
+        return query.Query(collection, all_descendants=True)
+
+    def document(self, *document_path):
+        """Get a reference to a document in a collection.
+
+        For a top-level document:
+
+        .. code-block:: python
+
+            >>> client.document('collek/shun')
+            >>> # is the same as
+            >>> client.document('collek', 'shun')
+
+        For a document in a sub-collection:
+
+        .. code-block:: python
+
+            >>> client.document('mydocs/doc/subcol/child')
+            >>> # is the same as
+            >>> client.document('mydocs', 'doc', 'subcol', 'child')
+
+        Documents in sub-collections can be nested deeper in a similar fashion.
+
+        Args:
+            document_path (Tuple[str, ...]): Can either be
+
+                * A single ``/``-delimited path to a document
+                * A tuple of document path segments
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.document.DocumentReference`:
+            A reference to a document in a collection.
+        """
+        if len(document_path) == 1:
+            path = document_path[0].split(_helpers.DOCUMENT_PATH_DELIMITER)
+        else:
+            path = document_path
+
+        # DocumentReference takes a relative path. Strip the database string if present.
+        base_path = self._database_string + "/documents/"
+        joined_path = _helpers.DOCUMENT_PATH_DELIMITER.join(path)
+        if joined_path.startswith(base_path):
+            joined_path = joined_path[len(base_path) :]
+        path = joined_path.split(_helpers.DOCUMENT_PATH_DELIMITER)
+
+        return DocumentReference(*path, client=self)
+
+    @staticmethod
+    def field_path(*field_names):
+        """Create a **field path** from a list of nested field names.
+
+        A **field path** is a ``.``-delimited concatenation of the field
+        names. It is used to represent a nested field. For example,
+        in the data
+
+        .. code-block:: python
+
+           data = {
+              'aa': {
+                  'bb': {
+                      'cc': 10,
+                  },
+              },
+           }
+
+        the field path ``'aa.bb.cc'`` represents the data stored in
+        ``data['aa']['bb']['cc']``.
+
+        Args:
+            field_names (Tuple[str, ...]): The list of field names.
+
+        Returns:
+            str: The ``.``-delimited field path.
+        """
+        return render_field_path(field_names)
+
+    @staticmethod
+    def write_option(**kwargs):
+        """Create a write option for write operations.
+
+        Write operations include :meth:`~google.cloud.DocumentReference.set`,
+        :meth:`~google.cloud.DocumentReference.update` and
+        :meth:`~google.cloud.DocumentReference.delete`.
+
+        One of the following keyword arguments must be provided:
+
+        * ``last_update_time`` (:class:`google.protobuf.timestamp_pb2.\
+               Timestamp`): A timestamp. When set, the target document must
+               exist and have been last updated at that time. Protobuf
+               ``update_time`` timestamps are typically returned from methods
+               that perform write operations as part of a "write result"
+               protobuf or directly.
+        * ``exists`` (:class:`bool`): Indicates if the document being modified
+              should already exist.
+
+        Providing no argument would make the option have no effect (so
+        it is not allowed). Providing multiple would be an apparent
+        contradiction, since ``last_update_time`` assumes that the
+        document **was** updated (it can't have been updated if it
+        doesn't exist) and ``exists`` indicate that it is unknown if the
+        document exists or not.
+
+        Args:
+            kwargs (Dict[str, Any]): The keyword arguments described above.
+
+        Raises:
+            TypeError: If anything other than exactly one argument is
+                provided by the caller.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.client.WriteOption`:
+            The option to be used to configure a write message.
+        """
+        if len(kwargs) != 1:
+            raise TypeError(_BAD_OPTION_ERR)
+
+        name, value = kwargs.popitem()
+        if name == "last_update_time":
+            return _helpers.LastUpdateOption(value)
+        elif name == "exists":
+            return _helpers.ExistsOption(value)
+        else:
+            extra = "{!r} was provided".format(name)
+            raise TypeError(_BAD_OPTION_ERR, extra)
+
+    def get_all(self, references, field_paths=None, transaction=None):
+        """Retrieve a batch of documents.
+
+        .. note::
+
+           Documents returned by this method are not guaranteed to be
+           returned in the same order that they are given in ``references``.
+
+        .. note::
+
+           If multiple ``references`` refer to the same document, the server
+           will only return one result.
+
+        See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+        more information on **field paths**.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            references (List[.DocumentReference, ...]): Iterable of document
+                references to be retrieved.
+            field_paths (Optional[Iterable[str, ...]]): An iterable of field
+                paths (``.``-delimited list of field names) to use as a
+                projection of document fields in the returned results. If
+                no value is provided, all fields will be returned.
+            transaction (Optional[:class:`~google.cloud.firestore_v1.transaction.Transaction`]):
+                An existing transaction that these ``references`` will be
+                retrieved in.
+
+        Yields:
+            .DocumentSnapshot: The next document snapshot that fulfills the
+            query, or :data:`None` if the document does not exist.
+        """
+        document_paths, reference_map = _reference_info(references)
+        mask = _get_doc_mask(field_paths)
+        response_iterator = self._firestore_api.batch_get_documents(
+            self._database_string,
+            document_paths,
+            mask,
+            transaction=_helpers.get_transaction_id(transaction),
+            metadata=self._rpc_metadata,
+        )
+
+        for get_doc_response in response_iterator:
+            yield _parse_batch_get(get_doc_response, reference_map, self)
+
+    def collections(self):
+        """List top-level collections of the client's database.
+
+        Returns:
+            Sequence[:class:`~google.cloud.firestore_v1.collection.CollectionReference`]:
+                iterator of subcollections of the current document.
+        """
+        iterator = self._firestore_api.list_collection_ids(
+            "{}/documents".format(self._database_string), metadata=self._rpc_metadata
+        )
+        iterator.client = self
+        iterator.item_to_value = _item_to_collection_ref
+        return iterator
+
+    def batch(self):
+        """Get a batch instance from this client.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.batch.WriteBatch`:
+            A "write" batch to be used for accumulating document changes and
+            sending the changes all at once.
+        """
+        return WriteBatch(self)
+
+    def transaction(self, **kwargs):
+        """Get a transaction that uses this client.
+
+        See :class:`~google.cloud.firestore_v1.transaction.Transaction` for
+        more information on transactions and the constructor arguments.
+
+        Args:
+            kwargs (Dict[str, Any]): The keyword arguments (other than
+                ``client``) to pass along to the
+                :class:`~google.cloud.firestore_v1.transaction.Transaction`
+                constructor.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.transaction.Transaction`:
+            A transaction attached to this client.
+        """
+        return Transaction(self, **kwargs)
+
+
+def _reference_info(references):
+    """Get information about document references.
+
+    Helper for :meth:`~google.cloud.firestore_v1.client.Client.get_all`.
+
+    Args:
+        references (List[.DocumentReference, ...]): Iterable of document
+            references.
+
+    Returns:
+        Tuple[List[str, ...], Dict[str, .DocumentReference]]: A two-tuple of
+
+        * fully-qualified documents paths for each reference in ``references``
+        * a mapping from the paths to the original reference. (If multiple
+          ``references`` contains multiple references to the same document,
+          that key will be overwritten in the result.)
+    """
+    document_paths = []
+    reference_map = {}
+    for reference in references:
+        doc_path = reference._document_path
+        document_paths.append(doc_path)
+        reference_map[doc_path] = reference
+
+    return document_paths, reference_map
+
+
+def _get_reference(document_path, reference_map):
+    """Get a document reference from a dictionary.
+
+    This just wraps a simple dictionary look-up with a helpful error that is
+    specific to :meth:`~google.cloud.firestore.client.Client.get_all`, the
+    **public** caller of this function.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        reference_map (Dict[str, .DocumentReference]): A mapping (produced
+            by :func:`_reference_info`) of fully-qualified document paths to
+            document references.
+
+    Returns:
+        .DocumentReference: The matching reference.
+
+    Raises:
+        ValueError: If ``document_path`` has not been encountered.
+    """
+    try:
+        return reference_map[document_path]
+    except KeyError:
+        msg = _BAD_DOC_TEMPLATE.format(document_path)
+        raise ValueError(msg)
+
+
+def _parse_batch_get(get_doc_response, reference_map, client):
+    """Parse a `BatchGetDocumentsResponse` protobuf.
+
+    Args:
+        get_doc_response (~google.cloud.proto.firestore.v1.\
+            firestore_pb2.BatchGetDocumentsResponse): A single response (from
+            a stream) containing the "get" response for a document.
+        reference_map (Dict[str, .DocumentReference]): A mapping (produced
+            by :func:`_reference_info`) of fully-qualified document paths to
+            document references.
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            A client that has a document factory.
+
+    Returns:
+       [.DocumentSnapshot]: The retrieved snapshot.
+
+    Raises:
+        ValueError: If the response has a ``result`` field (a oneof) other
+            than ``found`` or ``missing``.
+    """
+    result_type = get_doc_response.WhichOneof("result")
+    if result_type == "found":
+        reference = _get_reference(get_doc_response.found.name, reference_map)
+        data = _helpers.decode_dict(get_doc_response.found.fields, client)
+        snapshot = DocumentSnapshot(
+            reference,
+            data,
+            exists=True,
+            read_time=get_doc_response.read_time,
+            create_time=get_doc_response.found.create_time,
+            update_time=get_doc_response.found.update_time,
+        )
+    elif result_type == "missing":
+        reference = _get_reference(get_doc_response.missing, reference_map)
+        snapshot = DocumentSnapshot(
+            reference,
+            None,
+            exists=False,
+            read_time=get_doc_response.read_time,
+            create_time=None,
+            update_time=None,
+        )
+    else:
+        raise ValueError(
+            "`BatchGetDocumentsResponse.result` (a oneof) had a field other "
+            "than `found` or `missing` set, or was unset"
+        )
+    return snapshot
+
+
+def _get_doc_mask(field_paths):
+    """Get a document mask if field paths are provided.
+
+    Args:
+        field_paths (Optional[Iterable[str, ...]]): An iterable of field
+            paths (``.``-delimited list of field names) to use as a
+            projection of document fields in the returned results.
+
+    Returns:
+        Optional[google.cloud.firestore_v1.types.DocumentMask]: A mask
+            to project documents to a restricted set of field paths.
+    """
+    if field_paths is None:
+        return None
+    else:
+        return types.DocumentMask(field_paths=field_paths)
+
+
+def _item_to_collection_ref(iterator, item):
+    """Convert collection ID to collection ref.
+
+    Args:
+        iterator (google.api_core.page_iterator.GRPCIterator):
+            iterator response
+        item (str): ID of the collection
+    """
+    return iterator.client.collection(item)
diff --git a/firestore/google/cloud/firestore_v1/collection.py b/firestore/google/cloud/firestore_v1/collection.py
new file mode 100644
index 000000000000..165e0dfb3afa
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/collection.py
@@ -0,0 +1,486 @@
+# Copyright 2017 Google LLC 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.
+
+"""Classes for representing collections for the Google Cloud Firestore API."""
+import random
+import warnings
+
+import six
+
+from google.cloud.firestore_v1 import _helpers
+from google.cloud.firestore_v1 import query as query_mod
+from google.cloud.firestore_v1.proto import document_pb2
+from google.cloud.firestore_v1.watch import Watch
+from google.cloud.firestore_v1 import document
+
+_AUTO_ID_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+
+
+class CollectionReference(object):
+    """A reference to a collection in a Firestore database.
+
+    The collection may already exist or this class can facilitate creation
+    of documents within the collection.
+
+    Args:
+        path (Tuple[str, ...]): The components in the collection path.
+            This is a series of strings representing each collection and
+            sub-collection ID, as well as the document IDs for any documents
+            that contain a sub-collection.
+        kwargs (dict): The keyword arguments for the constructor. The only
+            supported keyword is ``client`` and it must be a
+            :class:`~google.cloud.firestore_v1.client.Client` if provided. It
+            represents the client that created this collection reference.
+
+    Raises:
+        ValueError: if
+
+            * the ``path`` is empty
+            * there are an even number of elements
+            * a collection ID in ``path`` is not a string
+            * a document ID in ``path`` is not a string
+        TypeError: If a keyword other than ``client`` is used.
+    """
+
+    def __init__(self, *path, **kwargs):
+        _helpers.verify_path(path, is_collection=True)
+        self._path = path
+        self._client = kwargs.pop("client", None)
+        if kwargs:
+            raise TypeError(
+                "Received unexpected arguments", kwargs, "Only `client` is supported"
+            )
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._path == other._path and self._client == other._client
+
+    @property
+    def id(self):
+        """The collection identifier.
+
+        Returns:
+            str: The last component of the path.
+        """
+        return self._path[-1]
+
+    @property
+    def parent(self):
+        """Document that owns the current collection.
+
+        Returns:
+            Optional[:class:`~google.cloud.firestore_v1.document.DocumentReference`]:
+            The parent document, if the current collection is not a
+            top-level collection.
+        """
+        if len(self._path) == 1:
+            return None
+        else:
+            parent_path = self._path[:-1]
+        return self._client.document(*parent_path)
+
+    def document(self, document_id=None):
+        """Create a sub-document underneath the current collection.
+
+        Args:
+            document_id (Optional[str]): The document identifier
+                within the current collection. If not provided, will default
+                to a random 20 character string composed of digits,
+                uppercase and lowercase and letters.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.document.DocumentReference`:
+            The child document.
+        """
+        if document_id is None:
+            document_id = _auto_id()
+
+        child_path = self._path + (document_id,)
+        return self._client.document(*child_path)
+
+    def _parent_info(self):
+        """Get fully-qualified parent path and prefix for this collection.
+
+        Returns:
+            Tuple[str, str]: Pair of
+
+            * the fully-qualified (with database and project) path to the
+              parent of this collection (will either be the database path
+              or a document path).
+            * the prefix to a document in this collection.
+        """
+        parent_doc = self.parent
+        if parent_doc is None:
+            parent_path = _helpers.DOCUMENT_PATH_DELIMITER.join(
+                (self._client._database_string, "documents")
+            )
+        else:
+            parent_path = parent_doc._document_path
+
+        expected_prefix = _helpers.DOCUMENT_PATH_DELIMITER.join((parent_path, self.id))
+        return parent_path, expected_prefix
+
+    def add(self, document_data, document_id=None):
+        """Create a document in the Firestore database with the provided data.
+
+        Args:
+            document_data (dict): Property names and values to use for
+                creating the document.
+            document_id (Optional[str]): The document identifier within the
+                current collection. If not provided, an ID will be
+                automatically assigned by the server (the assigned ID will be
+                a random 20 character string composed of digits,
+                uppercase and lowercase letters).
+
+        Returns:
+            Tuple[:class:`google.protobuf.timestamp_pb2.Timestamp`, \
+                :class:`~google.cloud.firestore_v1.document.DocumentReference`]:
+                Pair of
+
+                * The ``update_time`` when the document was created/overwritten.
+                * A document reference for the created document.
+
+        Raises:
+            ~google.cloud.exceptions.Conflict: If ``document_id`` is provided
+                and the document already exists.
+        """
+        if document_id is None:
+            parent_path, expected_prefix = self._parent_info()
+
+            document_pb = document_pb2.Document()
+
+            created_document_pb = self._client._firestore_api.create_document(
+                parent_path,
+                collection_id=self.id,
+                document_id=None,
+                document=document_pb,
+                mask=None,
+                metadata=self._client._rpc_metadata,
+            )
+
+            new_document_id = _helpers.get_doc_id(created_document_pb, expected_prefix)
+            document_ref = self.document(new_document_id)
+            set_result = document_ref.set(document_data)
+            return set_result.update_time, document_ref
+        else:
+            document_ref = self.document(document_id)
+            write_result = document_ref.create(document_data)
+            return write_result.update_time, document_ref
+
+    def list_documents(self, page_size=None):
+        """List all subdocuments of the current collection.
+
+        Args:
+            page_size (Optional[int]]): The maximum number of documents
+            in each page of results from this request. Non-positive values
+            are ignored. Defaults to a sensible value set by the API.
+
+        Returns:
+            Sequence[:class:`~google.cloud.firestore_v1.collection.DocumentReference`]:
+                iterator of subdocuments of the current collection. If the
+                collection does not exist at the time of `snapshot`, the
+                iterator will be empty
+        """
+        parent, _ = self._parent_info()
+
+        iterator = self._client._firestore_api.list_documents(
+            parent,
+            self.id,
+            page_size=page_size,
+            show_missing=True,
+            metadata=self._client._rpc_metadata,
+        )
+        iterator.collection = self
+        iterator.item_to_value = _item_to_document_ref
+        return iterator
+
+    def select(self, field_paths):
+        """Create a "select" query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.select` for
+        more information on this method.
+
+        Args:
+            field_paths (Iterable[str, ...]): An iterable of field paths
+                (``.``-delimited list of field names) to use as a projection
+                of document fields in the query results.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A "projected" query.
+        """
+        query = query_mod.Query(self)
+        return query.select(field_paths)
+
+    def where(self, field_path, op_string, value):
+        """Create a "where" query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.where` for
+        more information on this method.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) for the field to filter on.
+            op_string (str): A comparison operation in the form of a string.
+                Acceptable values are ``<``, ``<=``, ``==``, ``>=``
+                and ``>``.
+            value (Any): The value to compare the field against in the filter.
+                If ``value`` is :data:`None` or a NaN, then ``==`` is the only
+                allowed operation.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A filtered query.
+        """
+        query = query_mod.Query(self)
+        return query.where(field_path, op_string, value)
+
+    def order_by(self, field_path, **kwargs):
+        """Create an "order by" query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.order_by` for
+        more information on this method.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) on which to order the query results.
+            kwargs (Dict[str, Any]): The keyword arguments to pass along
+                to the query. The only supported keyword is ``direction``,
+                see :meth:`~google.cloud.firestore_v1.query.Query.order_by`
+                for more information.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            An "order by" query.
+        """
+        query = query_mod.Query(self)
+        return query.order_by(field_path, **kwargs)
+
+    def limit(self, count):
+        """Create a limited query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.limit` for
+        more information on this method.
+
+        Args:
+            count (int): Maximum number of documents to return that match
+                the query.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A limited query.
+        """
+        query = query_mod.Query(self)
+        return query.limit(count)
+
+    def offset(self, num_to_skip):
+        """Skip to an offset in a query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.offset` for
+        more information on this method.
+
+        Args:
+            num_to_skip (int): The number of results to skip at the beginning
+                of query results. (Must be non-negative.)
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            An offset query.
+        """
+        query = query_mod.Query(self)
+        return query.offset(num_to_skip)
+
+    def start_at(self, document_fields):
+        """Start query at a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.start_at` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[:class:`~google.cloud.firestore_v1.\
+                document.DocumentSnapshot`, dict, list, tuple]):
+                A document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.start_at(document_fields)
+
+    def start_after(self, document_fields):
+        """Start query after a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.start_after` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[:class:`~google.cloud.firestore_v1.\
+                document.DocumentSnapshot`, dict, list, tuple]):
+                A document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.start_after(document_fields)
+
+    def end_before(self, document_fields):
+        """End query before a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.end_before` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[:class:`~google.cloud.firestore_v1.\
+                document.DocumentSnapshot`, dict, list, tuple]):
+                A document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.end_before(document_fields)
+
+    def end_at(self, document_fields):
+        """End query at a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1.query.Query.end_at` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[:class:`~google.cloud.firestore_v1.\
+                document.DocumentSnapshot`, dict, list, tuple]):
+                A document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.end_at(document_fields)
+
+    def get(self, transaction=None):
+        """Deprecated alias for :meth:`stream`."""
+        warnings.warn(
+            "'Collection.get' is deprecated:  please use 'Collection.stream' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.stream(transaction=transaction)
+
+    def stream(self, transaction=None):
+        """Read the documents in this collection.
+
+        This sends a ``RunQuery`` RPC and then returns an iterator which
+        consumes each document returned in the stream of ``RunQueryResponse``
+        messages.
+
+        .. note::
+
+           The underlying stream of responses will time out after
+           the ``max_rpc_timeout_millis`` value set in the GAPIC
+           client configuration for the ``RunQuery`` API.  Snapshots
+           not consumed from the iterator before that point will be lost.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            transaction (Optional[:class:`~google.cloud.firestore_v1.transaction.\
+                Transaction`]):
+                An existing transaction that the query will run in.
+
+        Yields:
+            :class:`~google.cloud.firestore_v1.document.DocumentSnapshot`:
+            The next document that fulfills the query.
+        """
+        query = query_mod.Query(self)
+        return query.stream(transaction=transaction)
+
+    def on_snapshot(self, callback):
+        """Monitor the documents in this collection.
+
+        This starts a watch on this collection using a background thread. The
+        provided callback is run on the snapshot of the documents.
+
+        Args:
+            callback (Callable[[:class:`~google.cloud.firestore.collection.CollectionSnapshot`], NoneType]):
+                a callback to run when a change occurs.
+
+        Example:
+            from google.cloud import firestore_v1
+
+            db = firestore_v1.Client()
+            collection_ref = db.collection(u'users')
+
+            def on_snapshot(collection_snapshot):
+                for doc in collection_snapshot.documents:
+                    print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+            # Watch this collection
+            collection_watch = collection_ref.on_snapshot(on_snapshot)
+
+            # Terminate this watch
+            collection_watch.unsubscribe()
+        """
+        return Watch.for_query(
+            query_mod.Query(self),
+            callback,
+            document.DocumentSnapshot,
+            document.DocumentReference,
+        )
+
+
+def _auto_id():
+    """Generate a "random" automatically generated ID.
+
+    Returns:
+        str: A 20 character string composed of digits, uppercase and
+        lowercase and letters.
+    """
+    return "".join(random.choice(_AUTO_ID_CHARS) for _ in six.moves.xrange(20))
+
+
+def _item_to_document_ref(iterator, item):
+    """Convert Document resource to document ref.
+
+    Args:
+        iterator (google.api_core.page_iterator.GRPCIterator):
+            iterator response
+        item (dict): document resource
+    """
+    document_id = item.name.split(_helpers.DOCUMENT_PATH_DELIMITER)[-1]
+    return iterator.collection.document(document_id)
diff --git a/firestore/google/cloud/firestore_v1/document.py b/firestore/google/cloud/firestore_v1/document.py
new file mode 100644
index 000000000000..df2861c1579d
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/document.py
@@ -0,0 +1,786 @@
+# Copyright 2017 Google LLC 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.
+
+"""Classes for representing documents for the Google Cloud Firestore API."""
+
+import copy
+
+import six
+
+from google.api_core import exceptions
+from google.cloud.firestore_v1 import _helpers
+from google.cloud.firestore_v1 import field_path as field_path_module
+from google.cloud.firestore_v1.proto import common_pb2
+from google.cloud.firestore_v1.watch import Watch
+
+
+class DocumentReference(object):
+    """A reference to a document in a Firestore database.
+
+    The document may already exist or can be created by this class.
+
+    Args:
+        path (Tuple[str, ...]): The components in the document path.
+            This is a series of strings representing each collection and
+            sub-collection ID, as well as the document IDs for any documents
+            that contain a sub-collection (as well as the base document).
+        kwargs (dict): The keyword arguments for the constructor. The only
+            supported keyword is ``client`` and it must be a
+            :class:`~google.cloud.firestore_v1.client.Client`. It represents
+            the client that created this document reference.
+
+    Raises:
+        ValueError: if
+
+            * the ``path`` is empty
+            * there are an even number of elements
+            * a collection ID in ``path`` is not a string
+            * a document ID in ``path`` is not a string
+        TypeError: If a keyword other than ``client`` is used.
+    """
+
+    _document_path_internal = None
+
+    def __init__(self, *path, **kwargs):
+        _helpers.verify_path(path, is_collection=False)
+        self._path = path
+        self._client = kwargs.pop("client", None)
+        if kwargs:
+            raise TypeError(
+                "Received unexpected arguments", kwargs, "Only `client` is supported"
+            )
+
+    def __copy__(self):
+        """Shallow copy the instance.
+
+        We leave the client "as-is" but tuple-unpack the path.
+
+        Returns:
+            .DocumentReference: A copy of the current document.
+        """
+        result = self.__class__(*self._path, client=self._client)
+        result._document_path_internal = self._document_path_internal
+        return result
+
+    def __deepcopy__(self, unused_memo):
+        """Deep copy the instance.
+
+        This isn't a true deep copy, wee leave the client "as-is" but
+        tuple-unpack the path.
+
+        Returns:
+            .DocumentReference: A copy of the current document.
+        """
+        return self.__copy__()
+
+    def __eq__(self, other):
+        """Equality check against another instance.
+
+        Args:
+            other (Any): A value to compare against.
+
+        Returns:
+            Union[bool, NotImplementedType]: Indicating if the values are
+            equal.
+        """
+        if isinstance(other, DocumentReference):
+            return self._client == other._client and self._path == other._path
+        else:
+            return NotImplemented
+
+    def __hash__(self):
+        return hash(self._path) + hash(self._client)
+
+    def __ne__(self, other):
+        """Inequality check against another instance.
+
+        Args:
+            other (Any): A value to compare against.
+
+        Returns:
+            Union[bool, NotImplementedType]: Indicating if the values are
+            not equal.
+        """
+        if isinstance(other, DocumentReference):
+            return self._client != other._client or self._path != other._path
+        else:
+            return NotImplemented
+
+    @property
+    def path(self):
+        """Database-relative for this document.
+
+        Returns:
+            str: The document's relative path.
+        """
+        return "/".join(self._path)
+
+    @property
+    def _document_path(self):
+        """Create and cache the full path for this document.
+
+        Of the form:
+
+            ``projects/{project_id}/databases/{database_id}/...
+                  documents/{document_path}``
+
+        Returns:
+            str: The full document path.
+
+        Raises:
+            ValueError: If the current document reference has no ``client``.
+        """
+        if self._document_path_internal is None:
+            if self._client is None:
+                raise ValueError("A document reference requires a `client`.")
+            self._document_path_internal = _get_document_path(self._client, self._path)
+
+        return self._document_path_internal
+
+    @property
+    def id(self):
+        """The document identifier (within its collection).
+
+        Returns:
+            str: The last component of the path.
+        """
+        return self._path[-1]
+
+    @property
+    def parent(self):
+        """Collection that owns the current document.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.collection.CollectionReference`:
+            The parent collection.
+        """
+        parent_path = self._path[:-1]
+        return self._client.collection(*parent_path)
+
+    def collection(self, collection_id):
+        """Create a sub-collection underneath the current document.
+
+        Args:
+            collection_id (str): The sub-collection identifier (sometimes
+                referred to as the "kind").
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.collection.CollectionReference`:
+            The child collection.
+        """
+        child_path = self._path + (collection_id,)
+        return self._client.collection(*child_path)
+
+    def create(self, document_data):
+        """Create the current document in the Firestore database.
+
+        Args:
+            document_data (dict): Property names and values to use for
+                creating a document.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.types.WriteResult`:
+                The write result corresponding to the committed document.
+                A write result contains an ``update_time`` field.
+
+        Raises:
+            :class:`~google.cloud.exceptions.Conflict`:
+                If the document already exists.
+        """
+        batch = self._client.batch()
+        batch.create(self, document_data)
+        write_results = batch.commit()
+        return _first_write_result(write_results)
+
+    def set(self, document_data, merge=False):
+        """Replace the current document in the Firestore database.
+
+        A write ``option`` can be specified to indicate preconditions of
+        the "set" operation. If no ``option`` is specified and this document
+        doesn't exist yet, this method will create it.
+
+        Overwrites all content for the document with the fields in
+        ``document_data``. This method performs almost the same functionality
+        as :meth:`create`. The only difference is that this method doesn't
+        make any requirements on the existence of the document (unless
+        ``option`` is used), whereas as :meth:`create` will fail if the
+        document already exists.
+
+        Args:
+            document_data (dict): Property names and values to use for
+                replacing a document.
+            merge (Optional[bool] or Optional[List<apispec>]):
+                If True, apply merging instead of overwriting the state
+                of the document.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.types.WriteResult`:
+            The write result corresponding to the committed document. A write
+            result contains an ``update_time`` field.
+        """
+        batch = self._client.batch()
+        batch.set(self, document_data, merge=merge)
+        write_results = batch.commit()
+        return _first_write_result(write_results)
+
+    def update(self, field_updates, option=None):
+        """Update an existing document in the Firestore database.
+
+        By default, this method verifies that the document exists on the
+        server before making updates. A write ``option`` can be specified to
+        override these preconditions.
+
+        Each key in ``field_updates`` can either be a field name or a
+        **field path** (For more information on **field paths**, see
+        :meth:`~google.cloud.firestore_v1.client.Client.field_path`.) To
+        illustrate this, consider a document with
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+               },
+               'other': True,
+           }
+
+        stored on the server. If the field name is used in the update:
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'foo': {
+           ...         'quux': 800,
+           ...     },
+           ... }
+           >>> document.update(field_updates)
+
+        then all of ``foo`` will be overwritten on the server and the new
+        value will be
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'quux': 800,
+               },
+               'other': True,
+           }
+
+        On the other hand, if a ``.``-delimited **field path** is used in the
+        update:
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'foo.quux': 800,
+           ... }
+           >>> document.update(field_updates)
+
+        then only ``foo.quux`` will be updated on the server and the
+        field ``foo.bar`` will remain intact:
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+                   'quux': 800,
+               },
+               'other': True,
+           }
+
+        .. warning::
+
+           A **field path** can only be used as a top-level key in
+           ``field_updates``.
+
+        To delete / remove a field from an existing document, use the
+        :attr:`~google.cloud.firestore_v1.transforms.DELETE_FIELD` sentinel.
+        So with the example above, sending
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'other': firestore.DELETE_FIELD,
+           ... }
+           >>> document.update(field_updates)
+
+        would update the value on the server to:
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+               },
+           }
+
+        To set a field to the current time on the server when the
+        update is received, use the
+        :attr:`~google.cloud.firestore_v1.transforms.SERVER_TIMESTAMP`
+        sentinel.
+        Sending
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'foo.now': firestore.SERVER_TIMESTAMP,
+           ... }
+           >>> document.update(field_updates)
+
+        would update the value on the server to:
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+                   'now': datetime.datetime(2012, ...),
+               },
+               'other': True,
+           }
+
+        Args:
+            field_updates (dict): Field names or paths to update and values
+                to update with.
+            option (Optional[:class:`~google.cloud.firestore_v1.client.WriteOption`]):
+                A write option to make assertions / preconditions on the server
+                state of the document before applying changes.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.types.WriteResult`:
+            The write result corresponding to the updated document. A write
+            result contains an ``update_time`` field.
+
+        Raises:
+            ~google.cloud.exceptions.NotFound: If the document does not exist.
+        """
+        batch = self._client.batch()
+        batch.update(self, field_updates, option=option)
+        write_results = batch.commit()
+        return _first_write_result(write_results)
+
+    def delete(self, option=None):
+        """Delete the current document in the Firestore database.
+
+        Args:
+            option (Optional[:class:`~google.cloud.firestore_v1.client.WriteOption`]):
+                A write option to make assertions / preconditions on the server
+                state of the document before applying changes.
+
+        Returns:
+            :class:`google.protobuf.timestamp_pb2.Timestamp`:
+            The time that the delete request was received by the server.
+            If the document did not exist when the delete was sent (i.e.
+            nothing was deleted), this method will still succeed and will
+            still return the time that the request was received by the server.
+        """
+        write_pb = _helpers.pb_for_delete(self._document_path, option)
+        commit_response = self._client._firestore_api.commit(
+            self._client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=self._client._rpc_metadata,
+        )
+
+        return commit_response.commit_time
+
+    def get(self, field_paths=None, transaction=None):
+        """Retrieve a snapshot of the current document.
+
+        See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+        more information on **field paths**.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            field_paths (Optional[Iterable[str, ...]]): An iterable of field
+                paths (``.``-delimited list of field names) to use as a
+                projection of document fields in the returned results. If
+                no value is provided, all fields will be returned.
+            transaction (Optional[:class:`~google.cloud.firestore_v1.transaction.Transaction`]):
+                An existing transaction that this reference
+                will be retrieved in.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.document.DocumentSnapshot`:
+                A snapshot of the current document. If the document does not
+                exist at the time of the snapshot is taken, the snapshot's
+                :attr:`reference`, :attr:`data`, :attr:`update_time`, and
+                :attr:`create_time` attributes will all be ``None`` and
+                its :attr:`exists` attribute will be ``False``.
+        """
+        if isinstance(field_paths, six.string_types):
+            raise ValueError("'field_paths' must be a sequence of paths, not a string.")
+
+        if field_paths is not None:
+            mask = common_pb2.DocumentMask(field_paths=sorted(field_paths))
+        else:
+            mask = None
+
+        firestore_api = self._client._firestore_api
+        try:
+            document_pb = firestore_api.get_document(
+                self._document_path,
+                mask=mask,
+                transaction=_helpers.get_transaction_id(transaction),
+                metadata=self._client._rpc_metadata,
+            )
+        except exceptions.NotFound:
+            data = None
+            exists = False
+            create_time = None
+            update_time = None
+        else:
+            data = _helpers.decode_dict(document_pb.fields, self._client)
+            exists = True
+            create_time = document_pb.create_time
+            update_time = document_pb.update_time
+
+        return DocumentSnapshot(
+            reference=self,
+            data=data,
+            exists=exists,
+            read_time=None,  # No server read_time available
+            create_time=create_time,
+            update_time=update_time,
+        )
+
+    def collections(self, page_size=None):
+        """List subcollections of the current document.
+
+        Args:
+            page_size (Optional[int]]): The maximum number of collections
+            in each page of results from this request. Non-positive values
+            are ignored. Defaults to a sensible value set by the API.
+
+        Returns:
+            Sequence[:class:`~google.cloud.firestore_v1.collection.CollectionReference`]:
+                iterator of subcollections of the current document. If the
+                document does not exist at the time of `snapshot`, the
+                iterator will be empty
+        """
+        iterator = self._client._firestore_api.list_collection_ids(
+            self._document_path,
+            page_size=page_size,
+            metadata=self._client._rpc_metadata,
+        )
+        iterator.document = self
+        iterator.item_to_value = _item_to_collection_ref
+        return iterator
+
+    def on_snapshot(self, callback):
+        """Watch this document.
+
+        This starts a watch on this document using a background thread. The
+        provided callback is run on the snapshot.
+
+        Args:
+            callback(Callable[[:class:`~google.cloud.firestore.document.DocumentSnapshot`], NoneType]):
+                a callback to run when a change occurs
+
+        Example:
+
+        .. code-block:: python
+
+            from google.cloud import firestore_v1
+
+            db = firestore_v1.Client()
+            collection_ref = db.collection(u'users')
+
+            def on_snapshot(document_snapshot):
+                doc = document_snapshot
+                print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+            doc_ref = db.collection(u'users').document(
+                u'alovelace' + unique_resource_id())
+
+            # Watch this document
+            doc_watch = doc_ref.on_snapshot(on_snapshot)
+
+            # Terminate this watch
+            doc_watch.unsubscribe()
+        """
+        return Watch.for_document(self, callback, DocumentSnapshot, DocumentReference)
+
+
+class DocumentSnapshot(object):
+    """A snapshot of document data in a Firestore database.
+
+    This represents data retrieved at a specific time and may not contain
+    all fields stored for the document (i.e. a hand-picked selection of
+    fields may have been retrieved).
+
+    Instances of this class are not intended to be constructed by hand,
+    rather they'll be returned as responses to various methods, such as
+    :meth:`~google.cloud.DocumentReference.get`.
+
+    Args:
+        reference (:class:`~google.cloud.firestore_v1.document.DocumentReference`):
+            A document reference corresponding to the document that contains
+            the data in this snapshot.
+        data (Dict[str, Any]):
+            The data retrieved in the snapshot.
+        exists (bool):
+            Indicates if the document existed at the time the snapshot was
+            retrieved.
+        read_time (:class:`google.protobuf.timestamp_pb2.Timestamp`):
+            The time that this snapshot was read from the server.
+        create_time (:class:`google.protobuf.timestamp_pb2.Timestamp`):
+            The time that this document was created.
+        update_time (:class:`google.protobuf.timestamp_pb2.Timestamp`):
+            The time that this document was last updated.
+    """
+
+    def __init__(self, reference, data, exists, read_time, create_time, update_time):
+        self._reference = reference
+        # We want immutable data, so callers can't modify this value
+        # out from under us.
+        self._data = copy.deepcopy(data)
+        self._exists = exists
+        self.read_time = read_time
+        self.create_time = create_time
+        self.update_time = update_time
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._reference == other._reference and self._data == other._data
+
+    def __hash__(self):
+        seconds = self.update_time.seconds
+        nanos = self.update_time.nanos
+        return hash(self._reference) + hash(seconds) + hash(nanos)
+
+    @property
+    def _client(self):
+        """The client that owns the document reference for this snapshot.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.client.Client`:
+            The client that owns this document.
+        """
+        return self._reference._client
+
+    @property
+    def exists(self):
+        """Existence flag.
+
+        Indicates if the document existed at the time this snapshot
+        was retrieved.
+
+        Returns:
+            bool: The existence flag.
+        """
+        return self._exists
+
+    @property
+    def id(self):
+        """The document identifier (within its collection).
+
+        Returns:
+            str: The last component of the path of the document.
+        """
+        return self._reference.id
+
+    @property
+    def reference(self):
+        """Document reference corresponding to document that owns this data.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.document.DocumentReference`:
+            A document reference corresponding to this document.
+        """
+        return self._reference
+
+    def get(self, field_path):
+        """Get a value from the snapshot data.
+
+        If the data is nested, for example:
+
+        .. code-block:: python
+
+           >>> snapshot.to_dict()
+           {
+               'top1': {
+                   'middle2': {
+                       'bottom3': 20,
+                       'bottom4': 22,
+                   },
+                   'middle5': True,
+               },
+               'top6': b'\x00\x01 foo',
+           }
+
+        a **field path** can be used to access the nested data. For
+        example:
+
+        .. code-block:: python
+
+           >>> snapshot.get('top1')
+           {
+               'middle2': {
+                   'bottom3': 20,
+                   'bottom4': 22,
+               },
+               'middle5': True,
+           }
+           >>> snapshot.get('top1.middle2')
+           {
+               'bottom3': 20,
+               'bottom4': 22,
+           }
+           >>> snapshot.get('top1.middle2.bottom3')
+           20
+
+        See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+        more information on **field paths**.
+
+        A copy is returned since the data may contain mutable values,
+        but the data stored in the snapshot must remain immutable.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names).
+
+        Returns:
+            Any or None:
+                (A copy of) the value stored for the ``field_path`` or
+                None if snapshot document does not exist.
+
+        Raises:
+            KeyError: If the ``field_path`` does not match nested data
+                in the snapshot.
+        """
+        if not self._exists:
+            return None
+        nested_data = field_path_module.get_nested_value(field_path, self._data)
+        return copy.deepcopy(nested_data)
+
+    def to_dict(self):
+        """Retrieve the data contained in this snapshot.
+
+        A copy is returned since the data may contain mutable values,
+        but the data stored in the snapshot must remain immutable.
+
+        Returns:
+            Dict[str, Any] or None:
+                The data in the snapshot.  Returns None if reference
+                does not exist.
+        """
+        if not self._exists:
+            return None
+        return copy.deepcopy(self._data)
+
+
+def _get_document_path(client, path):
+    """Convert a path tuple into a full path string.
+
+    Of the form:
+
+        ``projects/{project_id}/databases/{database_id}/...
+              documents/{document_path}``
+
+    Args:
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            The client that holds configuration details and a GAPIC client
+            object.
+        path (Tuple[str, ...]): The components in a document path.
+
+    Returns:
+        str: The fully-qualified document path.
+    """
+    parts = (client._database_string, "documents") + path
+    return _helpers.DOCUMENT_PATH_DELIMITER.join(parts)
+
+
+def _consume_single_get(response_iterator):
+    """Consume a gRPC stream that should contain a single response.
+
+    The stream will correspond to a ``BatchGetDocuments`` request made
+    for a single document.
+
+    Args:
+        response_iterator (~google.cloud.exceptions.GrpcRendezvous): A
+            streaming iterator returned from a ``BatchGetDocuments``
+            request.
+
+    Returns:
+        ~google.cloud.proto.firestore.v1.\
+            firestore_pb2.BatchGetDocumentsResponse: The single "get"
+        response in the batch.
+
+    Raises:
+        ValueError: If anything other than exactly one response is returned.
+    """
+    # Calling ``list()`` consumes the entire iterator.
+    all_responses = list(response_iterator)
+    if len(all_responses) != 1:
+        raise ValueError(
+            "Unexpected response from `BatchGetDocumentsResponse`",
+            all_responses,
+            "Expected only one result",
+        )
+
+    return all_responses[0]
+
+
+def _first_write_result(write_results):
+    """Get first write result from list.
+
+    For cases where ``len(write_results) > 1``, this assumes the writes
+    occurred at the same time (e.g. if an update and transform are sent
+    at the same time).
+
+    Args:
+        write_results (List[google.cloud.proto.firestore.v1.\
+            write_pb2.WriteResult, ...]: The write results from a
+            ``CommitResponse``.
+
+    Returns:
+        google.cloud.firestore_v1.types.WriteResult: The
+        lone write result from ``write_results``.
+
+    Raises:
+        ValueError: If there are zero write results. This is likely to
+            **never** occur, since the backend should be stable.
+    """
+    if not write_results:
+        raise ValueError("Expected at least one write result")
+
+    return write_results[0]
+
+
+def _item_to_collection_ref(iterator, item):
+    """Convert collection ID to collection ref.
+
+    Args:
+        iterator (google.api_core.page_iterator.GRPCIterator):
+            iterator response
+        item (str): ID of the collection
+    """
+    return iterator.document.collection(item)
diff --git a/firestore/google/cloud/firestore_v1/field_path.py b/firestore/google/cloud/firestore_v1/field_path.py
new file mode 100644
index 000000000000..58b4f3b9acd3
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/field_path.py
@@ -0,0 +1,395 @@
+# 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.
+
+"""Utilities for managing / converting field paths to / from strings."""
+
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+
+import re
+
+import six
+
+
+_FIELD_PATH_MISSING_TOP = "{!r} is not contained in the data"
+_FIELD_PATH_MISSING_KEY = "{!r} is not contained in the data for the key {!r}"
+_FIELD_PATH_WRONG_TYPE = (
+    "The data at {!r} is not a dictionary, so it cannot contain the key {!r}"
+)
+
+_FIELD_PATH_DELIMITER = "."
+_BACKSLASH = "\\"
+_ESCAPED_BACKSLASH = _BACKSLASH * 2
+_BACKTICK = "`"
+_ESCAPED_BACKTICK = _BACKSLASH + _BACKTICK
+
+_SIMPLE_FIELD_NAME = re.compile("^[_a-zA-Z][_a-zA-Z0-9]*$")
+_LEADING_ALPHA_INVALID = re.compile("^[_a-zA-Z][_a-zA-Z0-9]*[^_a-zA-Z0-9]")
+PATH_ELEMENT_TOKENS = [
+    ("SIMPLE", r"[_a-zA-Z][_a-zA-Z0-9]*"),  # unquoted elements
+    ("QUOTED", r"`(?:\\`|[^`])*?`"),  # quoted elements, unquoted
+    ("DOT", r"\."),  # separator
+]
+TOKENS_PATTERN = "|".join("(?P<{}>{})".format(*pair) for pair in PATH_ELEMENT_TOKENS)
+TOKENS_REGEX = re.compile(TOKENS_PATTERN)
+
+
+def _tokenize_field_path(path):
+    """Lex a field path into tokens (including dots).
+
+    Args:
+        path (str): field path to be lexed.
+    Returns:
+        List(str): tokens
+    """
+    pos = 0
+    get_token = TOKENS_REGEX.match
+    match = get_token(path)
+    while match is not None:
+        type_ = match.lastgroup
+        value = match.group(type_)
+        yield value
+        pos = match.end()
+        match = get_token(path, pos)
+    if pos != len(path):
+        raise ValueError("Path {} not consumed, residue: {}".format(path, path[pos:]))
+
+
+def split_field_path(path):
+    """Split a field path into valid elements (without dots).
+
+    Args:
+        path (str): field path to be lexed.
+    Returns:
+        List(str): tokens
+    Raises:
+        ValueError: if the path does not match the elements-interspersed-
+                    with-dots pattern.
+    """
+    if not path:
+        return []
+
+    elements = []
+    want_dot = False
+
+    for element in _tokenize_field_path(path):
+        if want_dot:
+            if element != ".":
+                raise ValueError("Invalid path: {}".format(path))
+            else:
+                want_dot = False
+        else:
+            if element == ".":
+                raise ValueError("Invalid path: {}".format(path))
+            elements.append(element)
+            want_dot = True
+
+    if not want_dot or not elements:
+        raise ValueError("Invalid path: {}".format(path))
+
+    return elements
+
+
+def parse_field_path(api_repr):
+    """Parse a **field path** from into a list of nested field names.
+
+    See :func:`field_path` for more on **field paths**.
+
+    Args:
+        api_repr (str):
+            The unique Firestore api representation which consists of
+            either simple or UTF-8 field names. It cannot exceed
+            1500 bytes, and cannot be empty. Simple field names match
+            ``'^[_a-zA-Z][_a-zA-Z0-9]*$'``. All other field names are
+            escaped by surrounding them with backticks.
+
+    Returns:
+        List[str, ...]: The list of field names in the field path.
+    """
+    # code dredged back up from
+    # https://github.com/googleapis/google-cloud-python/pull/5109/files
+    field_names = []
+    for field_name in split_field_path(api_repr):
+        # non-simple field name
+        if field_name[0] == "`" and field_name[-1] == "`":
+            field_name = field_name[1:-1]
+            field_name = field_name.replace(_ESCAPED_BACKTICK, _BACKTICK)
+            field_name = field_name.replace(_ESCAPED_BACKSLASH, _BACKSLASH)
+        field_names.append(field_name)
+    return field_names
+
+
+def render_field_path(field_names):
+    """Create a **field path** from a list of nested field names.
+
+    A **field path** is a ``.``-delimited concatenation of the field
+    names. It is used to represent a nested field. For example,
+    in the data
+
+    .. code-block: python
+
+       data = {
+          'aa': {
+              'bb': {
+                  'cc': 10,
+              },
+          },
+       }
+
+    the field path ``'aa.bb.cc'`` represents that data stored in
+    ``data['aa']['bb']['cc']``.
+
+    Args:
+        field_names (Iterable[str, ...]): The list of field names.
+
+    Returns:
+        str: The ``.``-delimited field path.
+    """
+    result = []
+
+    for field_name in field_names:
+        match = _SIMPLE_FIELD_NAME.match(field_name)
+        if match and match.group(0) == field_name:
+            result.append(field_name)
+        else:
+            replaced = field_name.replace(_BACKSLASH, _ESCAPED_BACKSLASH).replace(
+                _BACKTICK, _ESCAPED_BACKTICK
+            )
+            result.append(_BACKTICK + replaced + _BACKTICK)
+
+    return _FIELD_PATH_DELIMITER.join(result)
+
+
+get_field_path = render_field_path  # backward-compatibility
+
+
+def get_nested_value(field_path, data):
+    """Get a (potentially nested) value from a dictionary.
+
+    If the data is nested, for example:
+
+    .. code-block:: python
+
+       >>> data
+       {
+           'top1': {
+               'middle2': {
+                   'bottom3': 20,
+                   'bottom4': 22,
+               },
+               'middle5': True,
+           },
+           'top6': b'\x00\x01 foo',
+       }
+
+    a **field path** can be used to access the nested data. For
+    example:
+
+    .. code-block:: python
+
+       >>> get_nested_value('top1', data)
+       {
+           'middle2': {
+               'bottom3': 20,
+               'bottom4': 22,
+           },
+           'middle5': True,
+       }
+       >>> get_nested_value('top1.middle2', data)
+       {
+           'bottom3': 20,
+           'bottom4': 22,
+       }
+       >>> get_nested_value('top1.middle2.bottom3', data)
+       20
+
+    See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+    more information on **field paths**.
+
+    Args:
+        field_path (str): A field path (``.``-delimited list of
+            field names).
+        data (Dict[str, Any]): The (possibly nested) data.
+
+    Returns:
+        Any: (A copy of) the value stored for the ``field_path``.
+
+    Raises:
+        KeyError: If the ``field_path`` does not match nested data.
+    """
+    field_names = parse_field_path(field_path)
+
+    nested_data = data
+    for index, field_name in enumerate(field_names):
+        if isinstance(nested_data, collections_abc.Mapping):
+            if field_name in nested_data:
+                nested_data = nested_data[field_name]
+            else:
+                if index == 0:
+                    msg = _FIELD_PATH_MISSING_TOP.format(field_name)
+                    raise KeyError(msg)
+                else:
+                    partial = render_field_path(field_names[:index])
+                    msg = _FIELD_PATH_MISSING_KEY.format(field_name, partial)
+                    raise KeyError(msg)
+        else:
+            partial = render_field_path(field_names[:index])
+            msg = _FIELD_PATH_WRONG_TYPE.format(partial, field_name)
+            raise KeyError(msg)
+
+    return nested_data
+
+
+class FieldPath(object):
+    """Field Path object for client use.
+
+    A field path is a sequence of element keys, separated by periods.
+    Each element key can be either a simple identifier, or a full unicode
+    string.
+
+    In the string representation of a field path, non-identifier elements
+    must be quoted using backticks, with internal backticks and backslashes
+    escaped with a backslash.
+
+    Args:
+        parts: (one or more strings)
+            Indicating path of the key to be used.
+    """
+
+    def __init__(self, *parts):
+        for part in parts:
+            if not isinstance(part, six.string_types) or not part:
+                error = "One or more components is not a string or is empty."
+                raise ValueError(error)
+        self.parts = tuple(parts)
+
+    @classmethod
+    def from_api_repr(cls, api_repr):
+        """Factory: create a FieldPath from the string formatted per the API.
+
+        Args:
+            api_repr (str): a string path, with non-identifier elements quoted
+            It cannot exceed 1500 characters, and cannot be empty.
+        Returns:
+            (:class:`FieldPath`) An instance parsed from ``api_repr``.
+        Raises:
+            ValueError if the parsing fails
+        """
+        api_repr = api_repr.strip()
+        if not api_repr:
+            raise ValueError("Field path API representation cannot be empty.")
+        return cls(*parse_field_path(api_repr))
+
+    @classmethod
+    def from_string(cls, path_string):
+        """Factory: create a FieldPath from a unicode string representation.
+
+        This method splits on the character `.` and disallows the
+        characters `~*/[]`. To create a FieldPath whose components have
+        those characters, call the constructor.
+
+        Args:
+            path_string (str): A unicode string which cannot contain
+            `~*/[]` characters, cannot exceed 1500 bytes, and cannot be empty.
+
+        Returns:
+            (:class:`FieldPath`) An instance parsed from ``path_string``.
+        """
+        try:
+            return cls.from_api_repr(path_string)
+        except ValueError:
+            elements = path_string.split(".")
+            for element in elements:
+                if not element:
+                    raise ValueError("Empty element")
+                if _LEADING_ALPHA_INVALID.match(element):
+                    raise ValueError(
+                        "Non-alphanum char in element with leading alpha: {}".format(
+                            element
+                        )
+                    )
+            return FieldPath(*elements)
+
+    def __repr__(self):
+        paths = ""
+        for part in self.parts:
+            paths += "'" + part + "',"
+        paths = paths[:-1]
+        return "FieldPath({})".format(paths)
+
+    def __hash__(self):
+        return hash(self.to_api_repr())
+
+    def __eq__(self, other):
+        if isinstance(other, FieldPath):
+            return self.parts == other.parts
+        return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, FieldPath):
+            return self.parts < other.parts
+        return NotImplemented
+
+    def __add__(self, other):
+        """Adds `other` field path to end of this field path.
+
+        Args:
+            other (~google.cloud.firestore_v1._helpers.FieldPath, str):
+                The field path to add to the end of this `FieldPath`.
+        """
+        if isinstance(other, FieldPath):
+            parts = self.parts + other.parts
+            return FieldPath(*parts)
+        elif isinstance(other, six.string_types):
+            parts = self.parts + FieldPath.from_string(other).parts
+            return FieldPath(*parts)
+        else:
+            return NotImplemented
+
+    def to_api_repr(self):
+        """Render a quoted string representation of the FieldPath
+
+        Returns:
+            (str) Quoted string representation of the path stored
+            within this FieldPath.
+        """
+        return render_field_path(self.parts)
+
+    def eq_or_parent(self, other):
+        """Check whether ``other`` is an ancestor.
+
+        Returns:
+            (bool) True IFF ``other`` is an ancestor or equal to ``self``,
+            else False.
+        """
+        return self.parts[: len(other.parts)] == other.parts[: len(self.parts)]
+
+    def lineage(self):
+        """Return field paths for all parents.
+
+        Returns: Set[:class:`FieldPath`]
+        """
+        indexes = six.moves.range(1, len(self.parts))
+        return {FieldPath(*self.parts[:index]) for index in indexes}
+
+    @staticmethod
+    def document_id():
+        """A special FieldPath value to refer to the ID of a document. It can be used
+           in queries to sort or filter by the document ID.
+
+        Returns: A special sentinel value to refer to the ID of a document.
+        """
+        return "__name__"
diff --git a/firestore/google/cloud/firestore_v1/gapic/__init__.py b/firestore/google/cloud/firestore_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1/gapic/enums.py b/firestore/google/cloud/firestore_v1/gapic/enums.py
new file mode 100644
index 000000000000..833761db83ba
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/gapic/enums.py
@@ -0,0 +1,148 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class DocumentTransform(object):
+    class FieldTransform(object):
+        class ServerValue(enum.IntEnum):
+            """
+            A value that is calculated by the server.
+
+            Attributes:
+              SERVER_VALUE_UNSPECIFIED (int): Unspecified. This value must not be used.
+              REQUEST_TIME (int): The time at which the server processed the request, with millisecond
+              precision.
+            """
+
+            SERVER_VALUE_UNSPECIFIED = 0
+            REQUEST_TIME = 1
+
+
+class StructuredQuery(object):
+    class Direction(enum.IntEnum):
+        """
+        A sort direction.
+
+        Attributes:
+          DIRECTION_UNSPECIFIED (int): Unspecified.
+          ASCENDING (int): Ascending.
+          DESCENDING (int): Descending.
+        """
+
+        DIRECTION_UNSPECIFIED = 0
+        ASCENDING = 1
+        DESCENDING = 2
+
+    class CompositeFilter(object):
+        class Operator(enum.IntEnum):
+            """
+            A composite filter operator.
+
+            Attributes:
+              OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+              AND (int): The results are required to satisfy each of the combined filters.
+            """
+
+            OPERATOR_UNSPECIFIED = 0
+            AND = 1
+
+    class FieldFilter(object):
+        class Operator(enum.IntEnum):
+            """
+            A field filter operator.
+
+            Attributes:
+              OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+              LESS_THAN (int): Less than. Requires that the field come first in ``order_by``.
+              LESS_THAN_OR_EQUAL (int): Less than or equal. Requires that the field come first in ``order_by``.
+              GREATER_THAN (int): Greater than. Requires that the field come first in ``order_by``.
+              GREATER_THAN_OR_EQUAL (int): Greater than or equal. Requires that the field come first in
+              ``order_by``.
+              EQUAL (int): Equal.
+              ARRAY_CONTAINS (int): Contains. Requires that the field is an array.
+            """
+
+            OPERATOR_UNSPECIFIED = 0
+            LESS_THAN = 1
+            LESS_THAN_OR_EQUAL = 2
+            GREATER_THAN = 3
+            GREATER_THAN_OR_EQUAL = 4
+            EQUAL = 5
+            ARRAY_CONTAINS = 7
+
+    class UnaryFilter(object):
+        class Operator(enum.IntEnum):
+            """
+            A unary operator.
+
+            Attributes:
+              OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+              IS_NAN (int): Test if a field is equal to NaN.
+              IS_NULL (int): Test if an exprestion evaluates to Null.
+            """
+
+            OPERATOR_UNSPECIFIED = 0
+            IS_NAN = 2
+            IS_NULL = 3
+
+
+class TargetChange(object):
+    class TargetChangeType(enum.IntEnum):
+        """
+        The type of change.
+
+        Attributes:
+          NO_CHANGE (int): No change has occurred. Used only to send an updated ``resume_token``.
+          ADD (int): The targets have been added.
+          REMOVE (int): The targets have been removed.
+          CURRENT (int): The targets reflect all changes committed before the targets were added
+          to the stream.
+
+          This will be sent after or with a ``read_time`` that is greater than or
+          equal to the time at which the targets were added.
+
+          Listeners can wait for this change if read-after-write semantics are
+          desired.
+          RESET (int): The targets have been reset, and a new initial state for the targets
+          will be returned in subsequent changes.
+
+          After the initial state is complete, ``CURRENT`` will be returned even
+          if the target was previously indicated to be ``CURRENT``.
+        """
+
+        NO_CHANGE = 0
+        ADD = 1
+        REMOVE = 2
+        CURRENT = 3
+        RESET = 4
diff --git a/firestore/google/cloud/firestore_v1/gapic/firestore_client.py b/firestore/google/cloud/firestore_v1/gapic/firestore_client.py
new file mode 100644
index 000000000000..af4d31a5be2e
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/gapic/firestore_client.py
@@ -0,0 +1,1461 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.firestore.v1 Firestore API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.firestore_v1.gapic import enums
+from google.cloud.firestore_v1.gapic import firestore_client_config
+from google.cloud.firestore_v1.gapic.transports import firestore_grpc_transport
+from google.cloud.firestore_v1.proto import common_pb2
+from google.cloud.firestore_v1.proto import document_pb2
+from google.cloud.firestore_v1.proto import firestore_pb2
+from google.cloud.firestore_v1.proto import firestore_pb2_grpc
+from google.cloud.firestore_v1.proto import query_pb2
+from google.cloud.firestore_v1.proto import write_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-firestore"
+).version
+
+
+class FirestoreClient(object):
+    """
+    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.
+    """
+
+    SERVICE_ADDRESS = "firestore.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.firestore.v1.Firestore"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            FirestoreClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def any_path_path(cls, project, database, document, any_path):
+        """Return a fully-qualified any_path string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/documents/{document}/{any_path=**}",
+            project=project,
+            database=database,
+            document=document,
+            any_path=any_path,
+        )
+
+    @classmethod
+    def database_root_path(cls, project, database):
+        """Return a fully-qualified database_root string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}",
+            project=project,
+            database=database,
+        )
+
+    @classmethod
+    def document_path_path(cls, project, database, document_path):
+        """Return a fully-qualified document_path string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/documents/{document_path=**}",
+            project=project,
+            database=database,
+            document_path=document_path,
+        )
+
+    @classmethod
+    def document_root_path(cls, project, database):
+        """Return a fully-qualified document_root string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/documents",
+            project=project,
+            database=database,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.FirestoreGrpcTransport,
+                    Callable[[~.Credentials, type], ~.FirestoreGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = firestore_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=firestore_grpc_transport.FirestoreGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = firestore_grpc_transport.FirestoreGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def get_document(
+        self,
+        name,
+        mask=None,
+        transaction=None,
+        read_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single document.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> name = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> response = client.get_document(name)
+
+        Args:
+            name (str): The resource name of the Document to get. In the format:
+                ``projects/{project_id}/databases/{database_id}/documents/{document_path}``.
+            mask (Union[dict, ~google.cloud.firestore_v1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If the document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.DocumentMask`
+            transaction (bytes): Reads the document in a transaction.
+            read_time (Union[dict, ~google.cloud.firestore_v1.types.Timestamp]): Reads the version of the document at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1.types.Document` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_document,
+                default_retry=self._method_configs["GetDocument"].retry,
+                default_timeout=self._method_configs["GetDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction, read_time=read_time
+        )
+
+        request = firestore_pb2.GetDocumentRequest(
+            name=name, mask=mask, transaction=transaction, read_time=read_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_documents(
+        self,
+        parent,
+        collection_id,
+        page_size=None,
+        order_by=None,
+        mask=None,
+        transaction=None,
+        read_time=None,
+        show_missing=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists documents.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> # TODO: Initialize `collection_id`:
+            >>> collection_id = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_documents(parent, collection_id):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_documents(parent, collection_id).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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``
+            collection_id (str): The collection ID, relative to ``parent``, to list. For example:
+                ``chatrooms`` or ``messages``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): The order to sort results by. For example: ``priority desc, name``.
+            mask (Union[dict, ~google.cloud.firestore_v1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If a document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.DocumentMask`
+            transaction (bytes): Reads documents in a transaction.
+            read_time (Union[dict, ~google.cloud.firestore_v1.types.Timestamp]): Reads documents as they were at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Timestamp`
+            show_missing (bool): If the list should show missing documents. A missing document is a
+                document that does not exist but has sub-documents. These documents will
+                be returned with a key but will not have fields,
+                ``Document.create_time``, or ``Document.update_time`` set.
+
+                Requests with ``show_missing`` may not specify ``where`` or
+                ``order_by``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.firestore_v1.types.Document` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_documents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_documents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_documents,
+                default_retry=self._method_configs["ListDocuments"].retry,
+                default_timeout=self._method_configs["ListDocuments"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction, read_time=read_time
+        )
+
+        request = firestore_pb2.ListDocumentsRequest(
+            parent=parent,
+            collection_id=collection_id,
+            page_size=page_size,
+            order_by=order_by,
+            mask=mask,
+            transaction=transaction,
+            read_time=read_time,
+            show_missing=show_missing,
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_documents"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="documents",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_document(
+        self,
+        parent,
+        collection_id,
+        document_id,
+        document,
+        mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new document.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> # TODO: Initialize `collection_id`:
+            >>> collection_id = ''
+            >>>
+            >>> # TODO: Initialize `document_id`:
+            >>> document_id = ''
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.create_document(parent, collection_id, document_id, document)
+
+        Args:
+            parent (str): The parent resource. For example:
+                ``projects/{project_id}/databases/{database_id}/documents`` or
+                ``projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}``
+            collection_id (str): The collection ID, relative to ``parent``, to list. For example:
+                ``chatrooms``.
+            document_id (str): The client-assigned document ID to use for this document.
+
+                Optional. If not specified, an ID will be assigned by the service.
+            document (Union[dict, ~google.cloud.firestore_v1.types.Document]): The document to create. ``name`` must not be set.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Document`
+            mask (Union[dict, ~google.cloud.firestore_v1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If the document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.DocumentMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1.types.Document` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_document,
+                default_retry=self._method_configs["CreateDocument"].retry,
+                default_timeout=self._method_configs["CreateDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.CreateDocumentRequest(
+            parent=parent,
+            collection_id=collection_id,
+            document_id=document_id,
+            document=document,
+            mask=mask,
+        )
+        return self._inner_api_calls["create_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_document(
+        self,
+        document,
+        update_mask,
+        mask=None,
+        current_document=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates or inserts a document.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_document(document, update_mask)
+
+        Args:
+            document (Union[dict, ~google.cloud.firestore_v1.types.Document]): The updated document.
+                Creates the document if it does not already exist.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Document`
+            update_mask (Union[dict, ~google.cloud.firestore_v1.types.DocumentMask]): The fields to update.
+                None of the field paths in the mask may contain a reserved name.
+
+                If the document exists on the server and has fields not referenced in the
+                mask, they are left unchanged.
+                Fields referenced in the mask, but not present in the input document, are
+                deleted from the document on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.DocumentMask`
+            mask (Union[dict, ~google.cloud.firestore_v1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If the document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.DocumentMask`
+            current_document (Union[dict, ~google.cloud.firestore_v1.types.Precondition]): An optional precondition on the document.
+                The request will fail if this is set and not met by the target document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Precondition`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1.types.Document` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_document,
+                default_retry=self._method_configs["UpdateDocument"].retry,
+                default_timeout=self._method_configs["UpdateDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.UpdateDocumentRequest(
+            document=document,
+            update_mask=update_mask,
+            mask=mask,
+            current_document=current_document,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("document.name", document.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_document(
+        self,
+        name,
+        current_document=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a document.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> name = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> client.delete_document(name)
+
+        Args:
+            name (str): The resource name of the Document to delete. In the format:
+                ``projects/{project_id}/databases/{database_id}/documents/{document_path}``.
+            current_document (Union[dict, ~google.cloud.firestore_v1.types.Precondition]): An optional precondition on the document.
+                The request will fail if this is set and not met by the target document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Precondition`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_document,
+                default_retry=self._method_configs["DeleteDocument"].retry,
+                default_timeout=self._method_configs["DeleteDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.DeleteDocumentRequest(
+            name=name, current_document=current_document
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_get_documents(
+        self,
+        database,
+        documents,
+        mask=None,
+        transaction=None,
+        new_transaction=None,
+        read_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets multiple documents.
+
+        Documents returned by this method are not guaranteed to be returned in the
+        same order that they were requested.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `documents`:
+            >>> documents = []
+            >>>
+            >>> for element in client.batch_get_documents(database, documents):
+            ...     # process element
+            ...     pass
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            documents (list[str]): The names of the documents to retrieve. In the format:
+                ``projects/{project_id}/databases/{database_id}/documents/{document_path}``.
+                The request will fail if any of the document is not a child resource of
+                the given ``database``. Duplicate names will be elided.
+            mask (Union[dict, ~google.cloud.firestore_v1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If a document has a field that is not present in this mask, that field will
+                not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.DocumentMask`
+            transaction (bytes): Reads documents in a transaction.
+            new_transaction (Union[dict, ~google.cloud.firestore_v1.types.TransactionOptions]): Starts a new transaction and reads the documents.
+                Defaults to a read-only transaction.
+                The new transaction ID will be returned as the first response in the
+                stream.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.TransactionOptions`
+            read_time (Union[dict, ~google.cloud.firestore_v1.types.Timestamp]): Reads documents as they were at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1.types.BatchGetDocumentsResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_get_documents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_get_documents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_get_documents,
+                default_retry=self._method_configs["BatchGetDocuments"].retry,
+                default_timeout=self._method_configs["BatchGetDocuments"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+
+        request = firestore_pb2.BatchGetDocumentsRequest(
+            database=database,
+            documents=documents,
+            mask=mask,
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_get_documents"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def begin_transaction(
+        self,
+        database,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a new transaction.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> response = client.begin_transaction(database)
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            options_ (Union[dict, ~google.cloud.firestore_v1.types.TransactionOptions]): The options for the transaction.
+                Defaults to a read-write transaction.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.TransactionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1.types.BeginTransactionResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "begin_transaction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "begin_transaction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.begin_transaction,
+                default_retry=self._method_configs["BeginTransaction"].retry,
+                default_timeout=self._method_configs["BeginTransaction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.BeginTransactionRequest(
+            database=database, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["begin_transaction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def commit(
+        self,
+        database,
+        writes,
+        transaction=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Commits a transaction, while optionally updating documents.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `writes`:
+            >>> writes = []
+            >>>
+            >>> response = client.commit(database, writes)
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            writes (list[Union[dict, ~google.cloud.firestore_v1.types.Write]]): The writes to apply.
+
+                Always executed atomically and in order.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Write`
+            transaction (bytes): If set, applies all writes in this transaction, and commits it.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1.types.CommitResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "commit" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "commit"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.commit,
+                default_retry=self._method_configs["Commit"].retry,
+                default_timeout=self._method_configs["Commit"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.CommitRequest(
+            database=database, writes=writes, transaction=transaction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["commit"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rollback(
+        self,
+        database,
+        transaction,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Rolls back a transaction.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `transaction`:
+            >>> transaction = b''
+            >>>
+            >>> client.rollback(database, transaction)
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            transaction (bytes): The transaction to roll back.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rollback" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rollback"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rollback,
+                default_retry=self._method_configs["Rollback"].retry,
+                default_timeout=self._method_configs["Rollback"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.RollbackRequest(
+            database=database, transaction=transaction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["rollback"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_query(
+        self,
+        parent,
+        structured_query=None,
+        transaction=None,
+        new_transaction=None,
+        read_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Runs a query.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> for element in client.run_query(parent):
+            ...     # process element
+            ...     pass
+
+        Args:
+            parent (str): 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``
+            structured_query (Union[dict, ~google.cloud.firestore_v1.types.StructuredQuery]): A structured query.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.StructuredQuery`
+            transaction (bytes): Reads documents in a transaction.
+            new_transaction (Union[dict, ~google.cloud.firestore_v1.types.TransactionOptions]): Starts a new transaction and reads the documents.
+                Defaults to a read-only transaction.
+                The new transaction ID will be returned as the first response in the
+                stream.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.TransactionOptions`
+            read_time (Union[dict, ~google.cloud.firestore_v1.types.Timestamp]): Reads documents as they were at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1.types.RunQueryResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_query" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_query"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_query,
+                default_retry=self._method_configs["RunQuery"].retry,
+                default_timeout=self._method_configs["RunQuery"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(structured_query=structured_query)
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+
+        request = firestore_pb2.RunQueryRequest(
+            parent=parent,
+            structured_query=structured_query,
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_query"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def write(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Streams batches of document updates and deletes, in order.
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>> request = {'database': database}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.write(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.firestore_v1.proto.firestore_pb2.WriteRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.firestore_v1.types.WriteRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1.types.WriteResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "write" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "write"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.write,
+                default_retry=self._method_configs["Write"].retry,
+                default_timeout=self._method_configs["Write"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["write"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def listen(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Listens to changes.
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>> request = {'database': database}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.listen(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.firestore_v1.proto.firestore_pb2.ListenRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.firestore_v1.types.ListenRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1.types.ListenResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "listen" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "listen"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.listen,
+                default_retry=self._method_configs["Listen"].retry,
+                default_timeout=self._method_configs["Listen"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["listen"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_collection_ids(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all the collection IDs underneath a document.
+
+        Example:
+            >>> from google.cloud import firestore_v1
+            >>>
+            >>> client = firestore_v1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_collection_ids(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_collection_ids(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`str` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_collection_ids" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_collection_ids"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_collection_ids,
+                default_retry=self._method_configs["ListCollectionIds"].retry,
+                default_timeout=self._method_configs["ListCollectionIds"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.ListCollectionIdsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_collection_ids"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="collection_ids",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/firestore/google/cloud/firestore_v1/gapic/firestore_client_config.py b/firestore/google/cloud/firestore_v1/gapic/firestore_client_config.py
new file mode 100644
index 000000000000..126dfb22d2ab
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/gapic/firestore_client_config.py
@@ -0,0 +1,97 @@
+config = {
+    "interfaces": {
+        "google.firestore.v1.Firestore": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+                "streaming": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 300000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 300000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "GetDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDocuments": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchGetDocuments": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "BeginTransaction": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "Commit": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Rollback": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunQuery": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "Write": {
+                    "timeout_millis": 86400000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "Listen": {
+                    "timeout_millis": 86400000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "ListCollectionIds": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/firestore/google/cloud/firestore_v1/gapic/transports/__init__.py b/firestore/google/cloud/firestore_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1/gapic/transports/firestore_grpc_transport.py b/firestore/google/cloud/firestore_v1/gapic/transports/firestore_grpc_transport.py
new file mode 100644
index 000000000000..9875a48c4d8a
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/gapic/transports/firestore_grpc_transport.py
@@ -0,0 +1,281 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.firestore_v1.proto import firestore_pb2_grpc
+
+
+class FirestoreGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.firestore.v1 Firestore API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/datastore",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="firestore.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"firestore_stub": firestore_pb2_grpc.FirestoreStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="firestore.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def get_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.get_document`.
+
+        Gets a single document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].GetDocument
+
+    @property
+    def list_documents(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.list_documents`.
+
+        Lists documents.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].ListDocuments
+
+    @property
+    def create_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.create_document`.
+
+        Creates a new document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].CreateDocument
+
+    @property
+    def update_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.update_document`.
+
+        Updates or inserts a document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].UpdateDocument
+
+    @property
+    def delete_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.delete_document`.
+
+        Deletes a document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].DeleteDocument
+
+    @property
+    def batch_get_documents(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.batch_get_documents`.
+
+        Gets multiple documents.
+
+        Documents returned by this method are not guaranteed to be returned in the
+        same order that they were requested.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].BatchGetDocuments
+
+    @property
+    def begin_transaction(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.begin_transaction`.
+
+        Starts a new transaction.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].BeginTransaction
+
+    @property
+    def commit(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.commit`.
+
+        Commits a transaction, while optionally updating documents.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Commit
+
+    @property
+    def rollback(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.rollback`.
+
+        Rolls back a transaction.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Rollback
+
+    @property
+    def run_query(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.run_query`.
+
+        Runs a query.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].RunQuery
+
+    @property
+    def write(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.write`.
+
+        Streams batches of document updates and deletes, in order.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Write
+
+    @property
+    def listen(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.listen`.
+
+        Listens to changes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Listen
+
+    @property
+    def list_collection_ids(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.list_collection_ids`.
+
+        Lists all the collection IDs underneath a document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].ListCollectionIds
diff --git a/firestore/google/cloud/firestore_v1/order.py b/firestore/google/cloud/firestore_v1/order.py
new file mode 100644
index 000000000000..d70293a36a5d
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/order.py
@@ -0,0 +1,207 @@
+# Copyright 2017 Google LLC 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.
+
+from enum import Enum
+from google.cloud.firestore_v1._helpers import decode_value
+import math
+
+
+class TypeOrder(Enum):
+    # NOTE: This order is defined by the backend and cannot be changed.
+    NULL = 0
+    BOOLEAN = 1
+    NUMBER = 2
+    TIMESTAMP = 3
+    STRING = 4
+    BLOB = 5
+    REF = 6
+    GEO_POINT = 7
+    ARRAY = 8
+    OBJECT = 9
+
+    @staticmethod
+    def from_value(value):
+        v = value.WhichOneof("value_type")
+
+        lut = {
+            "null_value": TypeOrder.NULL,
+            "boolean_value": TypeOrder.BOOLEAN,
+            "integer_value": TypeOrder.NUMBER,
+            "double_value": TypeOrder.NUMBER,
+            "timestamp_value": TypeOrder.TIMESTAMP,
+            "string_value": TypeOrder.STRING,
+            "bytes_value": TypeOrder.BLOB,
+            "reference_value": TypeOrder.REF,
+            "geo_point_value": TypeOrder.GEO_POINT,
+            "array_value": TypeOrder.ARRAY,
+            "map_value": TypeOrder.OBJECT,
+        }
+
+        if v not in lut:
+            raise ValueError("Could not detect value type for " + v)
+        return lut[v]
+
+
+class Order(object):
+    """
+    Order implements the ordering semantics of the backend.
+    """
+
+    @classmethod
+    def compare(cls, left, right):
+        """
+        Main comparison function for all Firestore types.
+        @return -1 is left < right, 0 if left == right, otherwise 1
+        """
+        # First compare the types.
+        leftType = TypeOrder.from_value(left).value
+        rightType = TypeOrder.from_value(right).value
+
+        if leftType != rightType:
+            if leftType < rightType:
+                return -1
+            return 1
+
+        value_type = left.WhichOneof("value_type")
+
+        if value_type == "null_value":
+            return 0  # nulls are all equal
+        elif value_type == "boolean_value":
+            return cls._compare_to(left.boolean_value, right.boolean_value)
+        elif value_type == "integer_value":
+            return cls.compare_numbers(left, right)
+        elif value_type == "double_value":
+            return cls.compare_numbers(left, right)
+        elif value_type == "timestamp_value":
+            return cls.compare_timestamps(left, right)
+        elif value_type == "string_value":
+            return cls._compare_to(left.string_value, right.string_value)
+        elif value_type == "bytes_value":
+            return cls.compare_blobs(left, right)
+        elif value_type == "reference_value":
+            return cls.compare_resource_paths(left, right)
+        elif value_type == "geo_point_value":
+            return cls.compare_geo_points(left, right)
+        elif value_type == "array_value":
+            return cls.compare_arrays(left, right)
+        elif value_type == "map_value":
+            return cls.compare_objects(left, right)
+        else:
+            raise ValueError("Unknown ``value_type``", str(value_type))
+
+    @staticmethod
+    def compare_blobs(left, right):
+        left_bytes = left.bytes_value
+        right_bytes = right.bytes_value
+
+        return Order._compare_to(left_bytes, right_bytes)
+
+    @staticmethod
+    def compare_timestamps(left, right):
+        left = left.timestamp_value
+        right = right.timestamp_value
+
+        seconds = Order._compare_to(left.seconds or 0, right.seconds or 0)
+        if seconds != 0:
+            return seconds
+
+        return Order._compare_to(left.nanos or 0, right.nanos or 0)
+
+    @staticmethod
+    def compare_geo_points(left, right):
+        left_value = decode_value(left, None)
+        right_value = decode_value(right, None)
+        cmp = (left_value.latitude > right_value.latitude) - (
+            left_value.latitude < right_value.latitude
+        )
+
+        if cmp != 0:
+            return cmp
+        return (left_value.longitude > right_value.longitude) - (
+            left_value.longitude < right_value.longitude
+        )
+
+    @staticmethod
+    def compare_resource_paths(left, right):
+        left = left.reference_value
+        right = right.reference_value
+
+        left_segments = left.split("/")
+        right_segments = right.split("/")
+        shorter = min(len(left_segments), len(right_segments))
+        # compare segments
+        for i in range(shorter):
+            if left_segments[i] < right_segments[i]:
+                return -1
+            if left_segments[i] > right_segments[i]:
+                return 1
+
+        left_length = len(left)
+        right_length = len(right)
+        return (left_length > right_length) - (left_length < right_length)
+
+    @staticmethod
+    def compare_arrays(left, right):
+        l_values = left.array_value.values
+        r_values = right.array_value.values
+
+        length = min(len(l_values), len(r_values))
+        for i in range(length):
+            cmp = Order.compare(l_values[i], r_values[i])
+            if cmp != 0:
+                return cmp
+
+        return Order._compare_to(len(l_values), len(r_values))
+
+    @staticmethod
+    def compare_objects(left, right):
+        left_fields = left.map_value.fields
+        right_fields = right.map_value.fields
+
+        for left_key, right_key in zip(sorted(left_fields), sorted(right_fields)):
+            keyCompare = Order._compare_to(left_key, right_key)
+            if keyCompare != 0:
+                return keyCompare
+
+            value_compare = Order.compare(
+                left_fields[left_key], right_fields[right_key]
+            )
+            if value_compare != 0:
+                return value_compare
+
+        return Order._compare_to(len(left_fields), len(right_fields))
+
+    @staticmethod
+    def compare_numbers(left, right):
+        left_value = decode_value(left, None)
+        right_value = decode_value(right, None)
+        return Order.compare_doubles(left_value, right_value)
+
+    @staticmethod
+    def compare_doubles(left, right):
+        if math.isnan(left):
+            if math.isnan(right):
+                return 0
+            return -1
+        if math.isnan(right):
+            return 1
+
+        return Order._compare_to(left, right)
+
+    @staticmethod
+    def _compare_to(left, right):
+        # We can't just use cmp(left, right) because cmp doesn't exist
+        # in Python 3, so this is an equivalent suggested by
+        # https://docs.python.org/3.0/whatsnew/3.0.html#ordering-comparisons
+        return (left > right) - (left < right)
diff --git a/firestore/google/cloud/firestore_v1/proto/__init__.py b/firestore/google/cloud/firestore_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1/proto/common.proto b/firestore/google/cloud/firestore_v1/proto/common.proto
new file mode 100644
index 000000000000..59c62997ad0d
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/common.proto
@@ -0,0 +1,84 @@
+// 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.firestore.v1;
+
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+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.
+// This is different from standard field masks, as this is always scoped to a
+// [Document][google.firestore.v1.Document], and takes in account the dynamic nature of [Value][google.firestore.v1.Value].
+message DocumentMask {
+  // The list of field paths in the mask. See [Document.fields][google.firestore.v1.Document.fields] for a field
+  // path syntax reference.
+  repeated string field_paths = 1;
+}
+
+// A precondition on a document, used for conditional operations.
+message Precondition {
+  // The type of precondition.
+  oneof condition_type {
+    // When set to `true`, the target document must exist.
+    // When set to `false`, the target document must not exist.
+    bool exists = 1;
+
+    // When set, the target document must exist and have been last updated at
+    // that time.
+    google.protobuf.Timestamp update_time = 2;
+  }
+}
+
+// Options for creating a new transaction.
+message TransactionOptions {
+  // Options for a transaction that can be used to read and write documents.
+  message ReadWrite {
+    // An optional transaction to retry.
+    bytes retry_transaction = 1;
+  }
+
+  // Options for a transaction that can only be used to read documents.
+  message ReadOnly {
+    // The consistency mode for this transaction. If not set, defaults to strong
+    // consistency.
+    oneof consistency_selector {
+      // Reads documents at the given time.
+      // This may not be older than 60 seconds.
+      google.protobuf.Timestamp read_time = 2;
+    }
+  }
+
+  // The mode of the transaction.
+  oneof mode {
+    // The transaction can only be used for read operations.
+    ReadOnly read_only = 2;
+
+    // The transaction can be used for both read and write operations.
+    ReadWrite read_write = 3;
+  }
+}
diff --git a/firestore/google/cloud/firestore_v1/proto/common_pb2.py b/firestore/google/cloud/firestore_v1/proto/common_pb2.py
new file mode 100644
index 000000000000..df3dbb355784
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/common_pb2.py
@@ -0,0 +1,451 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1/proto/common.proto",
+    package="google.firestore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.firestore.v1B\013CommonProtoP\001Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\242\002\004GCFS\252\002\031Google.Cloud.Firestore.V1\312\002\031Google\\Cloud\\Firestore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/firestore_v1/proto/common.proto\x12\x13google.firestore.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"#\n\x0c\x44ocumentMask\x12\x13\n\x0b\x66ield_paths\x18\x01 \x03(\t"e\n\x0cPrecondition\x12\x10\n\x06\x65xists\x18\x01 \x01(\x08H\x00\x12\x31\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x10\n\x0e\x63ondition_type"\xa9\x02\n\x12TransactionOptions\x12\x45\n\tread_only\x18\x02 \x01(\x0b\x32\x30.google.firestore.v1.TransactionOptions.ReadOnlyH\x00\x12G\n\nread_write\x18\x03 \x01(\x0b\x32\x31.google.firestore.v1.TransactionOptions.ReadWriteH\x00\x1a&\n\tReadWrite\x12\x19\n\x11retry_transaction\x18\x01 \x01(\x0c\x1aS\n\x08ReadOnly\x12/\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x16\n\x14\x63onsistency_selectorB\x06\n\x04modeB\xa5\x01\n\x17\x63om.google.firestore.v1B\x0b\x43ommonProtoP\x01Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\xa2\x02\x04GCFS\xaa\x02\x19Google.Cloud.Firestore.V1\xca\x02\x19Google\\Cloud\\Firestore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENTMASK = _descriptor.Descriptor(
+    name="DocumentMask",
+    full_name="google.firestore.v1.DocumentMask",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_paths",
+            full_name="google.firestore.v1.DocumentMask.field_paths",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=132,
+    serialized_end=167,
+)
+
+
+_PRECONDITION = _descriptor.Descriptor(
+    name="Precondition",
+    full_name="google.firestore.v1.Precondition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="exists",
+            full_name="google.firestore.v1.Precondition.exists",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.firestore.v1.Precondition.update_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="condition_type",
+            full_name="google.firestore.v1.Precondition.condition_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=169,
+    serialized_end=270,
+)
+
+
+_TRANSACTIONOPTIONS_READWRITE = _descriptor.Descriptor(
+    name="ReadWrite",
+    full_name="google.firestore.v1.TransactionOptions.ReadWrite",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="retry_transaction",
+            full_name="google.firestore.v1.TransactionOptions.ReadWrite.retry_transaction",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=439,
+    serialized_end=477,
+)
+
+_TRANSACTIONOPTIONS_READONLY = _descriptor.Descriptor(
+    name="ReadOnly",
+    full_name="google.firestore.v1.TransactionOptions.ReadOnly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.TransactionOptions.ReadOnly.read_time",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1.TransactionOptions.ReadOnly.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=479,
+    serialized_end=562,
+)
+
+_TRANSACTIONOPTIONS = _descriptor.Descriptor(
+    name="TransactionOptions",
+    full_name="google.firestore.v1.TransactionOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_only",
+            full_name="google.firestore.v1.TransactionOptions.read_only",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_write",
+            full_name="google.firestore.v1.TransactionOptions.read_write",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TRANSACTIONOPTIONS_READWRITE, _TRANSACTIONOPTIONS_READONLY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="mode",
+            full_name="google.firestore.v1.TransactionOptions.mode",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=273,
+    serialized_end=570,
+)
+
+_PRECONDITION.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRECONDITION.oneofs_by_name["condition_type"].fields.append(
+    _PRECONDITION.fields_by_name["exists"]
+)
+_PRECONDITION.fields_by_name["exists"].containing_oneof = _PRECONDITION.oneofs_by_name[
+    "condition_type"
+]
+_PRECONDITION.oneofs_by_name["condition_type"].fields.append(
+    _PRECONDITION.fields_by_name["update_time"]
+)
+_PRECONDITION.fields_by_name[
+    "update_time"
+].containing_oneof = _PRECONDITION.oneofs_by_name["condition_type"]
+_TRANSACTIONOPTIONS_READWRITE.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSACTIONOPTIONS_READONLY.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["consistency_selector"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["read_time"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "read_time"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["consistency_selector"]
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].message_type = _TRANSACTIONOPTIONS_READONLY
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].message_type = _TRANSACTIONOPTIONS_READWRITE
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_only"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_write"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+DESCRIPTOR.message_types_by_name["DocumentMask"] = _DOCUMENTMASK
+DESCRIPTOR.message_types_by_name["Precondition"] = _PRECONDITION
+DESCRIPTOR.message_types_by_name["TransactionOptions"] = _TRANSACTIONOPTIONS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DocumentMask = _reflection.GeneratedProtocolMessageType(
+    "DocumentMask",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTMASK,
+        __module__="google.cloud.firestore_v1.proto.common_pb2",
+        __doc__="""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. This is different
+  from standard field masks, as this is always scoped to a
+  [Document][google.firestore.v1.Document], and takes in account the
+  dynamic nature of [Value][google.firestore.v1.Value].
+  
+  
+  Attributes:
+      field_paths:
+          The list of field paths in the mask. See
+          [Document.fields][google.firestore.v1.Document.fields] for a
+          field path syntax reference.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.DocumentMask)
+    ),
+)
+_sym_db.RegisterMessage(DocumentMask)
+
+Precondition = _reflection.GeneratedProtocolMessageType(
+    "Precondition",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRECONDITION,
+        __module__="google.cloud.firestore_v1.proto.common_pb2",
+        __doc__="""A precondition on a document, used for conditional operations.
+  
+  
+  Attributes:
+      condition_type:
+          The type of precondition.
+      exists:
+          When set to ``true``, the target document must exist. When set
+          to ``false``, the target document must not exist.
+      update_time:
+          When set, the target document must exist and have been last
+          updated at that time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.Precondition)
+    ),
+)
+_sym_db.RegisterMessage(Precondition)
+
+TransactionOptions = _reflection.GeneratedProtocolMessageType(
+    "TransactionOptions",
+    (_message.Message,),
+    dict(
+        ReadWrite=_reflection.GeneratedProtocolMessageType(
+            "ReadWrite",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READWRITE,
+                __module__="google.cloud.firestore_v1.proto.common_pb2",
+                __doc__="""Options for a transaction that can be used to read and write documents.
+    
+    
+    Attributes:
+        retry_transaction:
+            An optional transaction to retry.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.TransactionOptions.ReadWrite)
+            ),
+        ),
+        ReadOnly=_reflection.GeneratedProtocolMessageType(
+            "ReadOnly",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READONLY,
+                __module__="google.cloud.firestore_v1.proto.common_pb2",
+                __doc__="""Options for a transaction that can only be used to read documents.
+    
+    
+    Attributes:
+        consistency_selector:
+            The consistency mode for this transaction. If not set,
+            defaults to strong consistency.
+        read_time:
+            Reads documents at the given time. This may not be older than
+            60 seconds.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.TransactionOptions.ReadOnly)
+            ),
+        ),
+        DESCRIPTOR=_TRANSACTIONOPTIONS,
+        __module__="google.cloud.firestore_v1.proto.common_pb2",
+        __doc__="""Options for creating a new transaction.
+  
+  
+  Attributes:
+      mode:
+          The mode of the transaction.
+      read_only:
+          The transaction can only be used for read operations.
+      read_write:
+          The transaction can be used for both read and write
+          operations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.TransactionOptions)
+    ),
+)
+_sym_db.RegisterMessage(TransactionOptions)
+_sym_db.RegisterMessage(TransactionOptions.ReadWrite)
+_sym_db.RegisterMessage(TransactionOptions.ReadOnly)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/common_pb2_grpc.py b/firestore/google/cloud/firestore_v1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1/proto/document.proto b/firestore/google/cloud/firestore_v1/proto/document.proto
new file mode 100644
index 000000000000..d3d9c11c79cf
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/document.proto
@@ -0,0 +1,151 @@
+// 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.firestore.v1;
+
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/latlng.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "DocumentProto";
+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.
+message Document {
+  // The resource name of the document, for example
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  string name = 1;
+
+  // The document's fields.
+  //
+  // The map keys represent field names.
+  //
+  // A simple field name contains only characters `a` to `z`, `A` to `Z`,
+  // `0` to `9`, or `_`, and must not start with `0` to `9`. For example,
+  // `foo_bar_17`.
+  //
+  // Field names matching the regular expression `__.*__` are reserved. Reserved
+  // field names are forbidden except in certain documented contexts. The map
+  // keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be
+  // empty.
+  //
+  // Field paths may be used in other contexts to refer to structured fields
+  // defined here. For `map_value`, the field path is represented by the simple
+  // or quoted field names of the containing fields, delimited by `.`. For
+  // example, the structured field
+  // `"foo" : { map_value: { "x&y" : { string_value: "hello" }}}` would be
+  // represented by the field path `foo.x&y`.
+  //
+  // Within a field path, a quoted field name starts and ends with `` ` `` and
+  // may contain any character. Some characters, including `` ` ``, must be
+  // escaped using a `\`. For example, `` `x&y` `` represents `x&y` and
+  // `` `bak\`tik` `` represents `` bak`tik ``.
+  map<string, Value> fields = 2;
+
+  // Output only. The time at which the document was created.
+  //
+  // This value increases monotonically when a document is deleted then
+  // recreated. It can also be compared to values from other documents and
+  // the `read_time` of a query.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Output only. The time at which the document was last changed.
+  //
+  // This value is initially set to the `create_time` then increases
+  // monotonically with each change to the document. It can also be
+  // compared to values from other documents and the `read_time` of a query.
+  google.protobuf.Timestamp update_time = 4;
+}
+
+// A message that can hold any of the supported value types.
+message Value {
+  // Must have a value set.
+  oneof value_type {
+    // A null value.
+    google.protobuf.NullValue null_value = 11;
+
+    // A boolean value.
+    bool boolean_value = 1;
+
+    // An integer value.
+    int64 integer_value = 2;
+
+    // A double value.
+    double double_value = 3;
+
+    // A timestamp value.
+    //
+    // Precise only to microseconds. When stored, any additional precision is
+    // rounded down.
+    google.protobuf.Timestamp timestamp_value = 10;
+
+    // A string value.
+    //
+    // The string, represented as UTF-8, must not exceed 1 MiB - 89 bytes.
+    // Only the first 1,500 bytes of the UTF-8 representation are considered by
+    // queries.
+    string string_value = 17;
+
+    // A bytes value.
+    //
+    // Must not exceed 1 MiB - 89 bytes.
+    // Only the first 1,500 bytes are considered by queries.
+    bytes bytes_value = 18;
+
+    // A reference to a document. For example:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    string reference_value = 5;
+
+    // A geo point value representing a point on the surface of Earth.
+    google.type.LatLng geo_point_value = 8;
+
+    // An array value.
+    //
+    // Cannot directly contain another array value, though can contain an
+    // map which contains another array.
+    ArrayValue array_value = 9;
+
+    // A map value.
+    MapValue map_value = 6;
+  }
+}
+
+// An array value.
+message ArrayValue {
+  // Values in the array.
+  repeated Value values = 1;
+}
+
+// A map value.
+message MapValue {
+  // The map's fields.
+  //
+  // The map keys represent field names. Field names matching the regular
+  // expression `__.*__` are reserved. Reserved field names are forbidden except
+  // in certain documented contexts. The map keys, represented as UTF-8, must
+  // not exceed 1,500 bytes and cannot be empty.
+  map<string, Value> fields = 1;
+}
diff --git a/firestore/google/cloud/firestore_v1/proto/document_pb2.py b/firestore/google/cloud/firestore_v1/proto/document_pb2.py
new file mode 100644
index 000000000000..82111a82299e
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/document_pb2.py
@@ -0,0 +1,798 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1/proto/document.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1/proto/document.proto",
+    package="google.firestore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.firestore.v1B\rDocumentProtoP\001Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\242\002\004GCFS\252\002\031Google.Cloud.Firestore.V1\312\002\031Google\\Cloud\\Firestore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/firestore_v1/proto/document.proto\x12\x13google.firestore.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x18google/type/latlng.proto\x1a\x1cgoogle/api/annotations.proto"\x80\x02\n\x08\x44ocument\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x39\n\x06\x66ields\x18\x02 \x03(\x0b\x32).google.firestore.v1.Document.FieldsEntry\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1aI\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12)\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.firestore.v1.Value:\x02\x38\x01"\xae\x03\n\x05Value\x12\x30\n\nnull_value\x18\x0b \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00\x12\x17\n\rboolean_value\x18\x01 \x01(\x08H\x00\x12\x17\n\rinteger_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x35\n\x0ftimestamp_value\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x16\n\x0cstring_value\x18\x11 \x01(\tH\x00\x12\x15\n\x0b\x62ytes_value\x18\x12 \x01(\x0cH\x00\x12\x19\n\x0freference_value\x18\x05 \x01(\tH\x00\x12.\n\x0fgeo_point_value\x18\x08 \x01(\x0b\x32\x13.google.type.LatLngH\x00\x12\x36\n\x0b\x61rray_value\x18\t \x01(\x0b\x32\x1f.google.firestore.v1.ArrayValueH\x00\x12\x32\n\tmap_value\x18\x06 \x01(\x0b\x32\x1d.google.firestore.v1.MapValueH\x00\x42\x0c\n\nvalue_type"8\n\nArrayValue\x12*\n\x06values\x18\x01 \x03(\x0b\x32\x1a.google.firestore.v1.Value"\x90\x01\n\x08MapValue\x12\x39\n\x06\x66ields\x18\x01 \x03(\x0b\x32).google.firestore.v1.MapValue.FieldsEntry\x1aI\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12)\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.firestore.v1.Value:\x02\x38\x01\x42\xa7\x01\n\x17\x63om.google.firestore.v1B\rDocumentProtoP\x01Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\xa2\x02\x04GCFS\xaa\x02\x19Google.Cloud.Firestore.V1\xca\x02\x19Google\\Cloud\\Firestore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENT_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.firestore.v1.Document.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1.Document.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1.Document.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=374,
+    serialized_end=447,
+)
+
+_DOCUMENT = _descriptor.Descriptor(
+    name="Document",
+    full_name="google.firestore.v1.Document",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.v1.Document.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.v1.Document.fields",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.firestore.v1.Document.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.firestore.v1.Document.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DOCUMENT_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=191,
+    serialized_end=447,
+)
+
+
+_VALUE = _descriptor.Descriptor(
+    name="Value",
+    full_name="google.firestore.v1.Value",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="null_value",
+            full_name="google.firestore.v1.Value.null_value",
+            index=0,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boolean_value",
+            full_name="google.firestore.v1.Value.boolean_value",
+            index=1,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="integer_value",
+            full_name="google.firestore.v1.Value.integer_value",
+            index=2,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="double_value",
+            full_name="google.firestore.v1.Value.double_value",
+            index=3,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_value",
+            full_name="google.firestore.v1.Value.timestamp_value",
+            index=4,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.firestore.v1.Value.string_value",
+            index=5,
+            number=17,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bytes_value",
+            full_name="google.firestore.v1.Value.bytes_value",
+            index=6,
+            number=18,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_value",
+            full_name="google.firestore.v1.Value.reference_value",
+            index=7,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="geo_point_value",
+            full_name="google.firestore.v1.Value.geo_point_value",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_value",
+            full_name="google.firestore.v1.Value.array_value",
+            index=9,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="map_value",
+            full_name="google.firestore.v1.Value.map_value",
+            index=10,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value_type",
+            full_name="google.firestore.v1.Value.value_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=450,
+    serialized_end=880,
+)
+
+
+_ARRAYVALUE = _descriptor.Descriptor(
+    name="ArrayValue",
+    full_name="google.firestore.v1.ArrayValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.firestore.v1.ArrayValue.values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=882,
+    serialized_end=938,
+)
+
+
+_MAPVALUE_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.firestore.v1.MapValue.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1.MapValue.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1.MapValue.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=374,
+    serialized_end=447,
+)
+
+_MAPVALUE = _descriptor.Descriptor(
+    name="MapValue",
+    full_name="google.firestore.v1.MapValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.v1.MapValue.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_MAPVALUE_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=941,
+    serialized_end=1085,
+)
+
+_DOCUMENT_FIELDSENTRY.fields_by_name["value"].message_type = _VALUE
+_DOCUMENT_FIELDSENTRY.containing_type = _DOCUMENT
+_DOCUMENT.fields_by_name["fields"].message_type = _DOCUMENT_FIELDSENTRY
+_DOCUMENT.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCUMENT.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VALUE.fields_by_name[
+    "null_value"
+].enum_type = google_dot_protobuf_dot_struct__pb2._NULLVALUE
+_VALUE.fields_by_name[
+    "timestamp_value"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VALUE.fields_by_name[
+    "geo_point_value"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_VALUE.fields_by_name["array_value"].message_type = _ARRAYVALUE
+_VALUE.fields_by_name["map_value"].message_type = _MAPVALUE
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["null_value"])
+_VALUE.fields_by_name["null_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["boolean_value"]
+)
+_VALUE.fields_by_name["boolean_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["integer_value"]
+)
+_VALUE.fields_by_name["integer_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["double_value"])
+_VALUE.fields_by_name["double_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["timestamp_value"]
+)
+_VALUE.fields_by_name["timestamp_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["string_value"])
+_VALUE.fields_by_name["string_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["bytes_value"])
+_VALUE.fields_by_name["bytes_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["reference_value"]
+)
+_VALUE.fields_by_name["reference_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["geo_point_value"]
+)
+_VALUE.fields_by_name["geo_point_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["array_value"])
+_VALUE.fields_by_name["array_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["map_value"])
+_VALUE.fields_by_name["map_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_ARRAYVALUE.fields_by_name["values"].message_type = _VALUE
+_MAPVALUE_FIELDSENTRY.fields_by_name["value"].message_type = _VALUE
+_MAPVALUE_FIELDSENTRY.containing_type = _MAPVALUE
+_MAPVALUE.fields_by_name["fields"].message_type = _MAPVALUE_FIELDSENTRY
+DESCRIPTOR.message_types_by_name["Document"] = _DOCUMENT
+DESCRIPTOR.message_types_by_name["Value"] = _VALUE
+DESCRIPTOR.message_types_by_name["ArrayValue"] = _ARRAYVALUE
+DESCRIPTOR.message_types_by_name["MapValue"] = _MAPVALUE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Document = _reflection.GeneratedProtocolMessageType(
+    "Document",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DOCUMENT_FIELDSENTRY,
+                __module__="google.cloud.firestore_v1.proto.document_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.Document.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_DOCUMENT,
+        __module__="google.cloud.firestore_v1.proto.document_pb2",
+        __doc__="""A Firestore document.
+  
+  Must not exceed 1 MiB - 4 bytes.
+  
+  
+  Attributes:
+      name:
+          The resource name of the document, for example ``projects/{pro
+          ject_id}/databases/{database_id}/documents/{document_path}``.
+      fields:
+          The document's fields.  The map keys represent field names.  A
+          simple field name contains only characters ``a`` to ``z``,
+          ``A`` to ``Z``, ``0`` to ``9``, or ``_``, and must not start
+          with ``0`` to ``9``. For example, ``foo_bar_17``.  Field names
+          matching the regular expression ``__.*__`` are reserved.
+          Reserved field names are forbidden except in certain
+          documented contexts. The map keys, represented as UTF-8, must
+          not exceed 1,500 bytes and cannot be empty.  Field paths may
+          be used in other contexts to refer to structured fields
+          defined here. For ``map_value``, the field path is represented
+          by the simple or quoted field names of the containing fields,
+          delimited by ``.``. For example, the structured field ``"foo"
+          : { map_value: { "x&y" : { string_value: "hello" }}}`` would
+          be represented by the field path ``foo.x&y``.  Within a field
+          path, a quoted field name starts and ends with ````` and may
+          contain any character. Some characters, including `````, must
+          be escaped using a ``\``. For example, ```x&y``` represents
+          ``x&y`` and ```bak\`tik``` represents ``bak`tik``.
+      create_time:
+          Output only. The time at which the document was created.  This
+          value increases monotonically when a document is deleted then
+          recreated. It can also be compared to values from other
+          documents and the ``read_time`` of a query.
+      update_time:
+          Output only. The time at which the document was last changed.
+          This value is initially set to the ``create_time`` then
+          increases monotonically with each change to the document. It
+          can also be compared to values from other documents and the
+          ``read_time`` of a query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.Document)
+    ),
+)
+_sym_db.RegisterMessage(Document)
+_sym_db.RegisterMessage(Document.FieldsEntry)
+
+Value = _reflection.GeneratedProtocolMessageType(
+    "Value",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUE,
+        __module__="google.cloud.firestore_v1.proto.document_pb2",
+        __doc__="""A message that can hold any of the supported value types.
+  
+  
+  Attributes:
+      value_type:
+          Must have a value set.
+      null_value:
+          A null value.
+      boolean_value:
+          A boolean value.
+      integer_value:
+          An integer value.
+      double_value:
+          A double value.
+      timestamp_value:
+          A timestamp value.  Precise only to microseconds. When stored,
+          any additional precision is rounded down.
+      string_value:
+          A string value.  The string, represented as UTF-8, must not
+          exceed 1 MiB - 89 bytes. Only the first 1,500 bytes of the
+          UTF-8 representation are considered by queries.
+      bytes_value:
+          A bytes value.  Must not exceed 1 MiB - 89 bytes. Only the
+          first 1,500 bytes are considered by queries.
+      reference_value:
+          A reference to a document. For example: ``projects/{project_id
+          }/databases/{database_id}/documents/{document_path}``.
+      geo_point_value:
+          A geo point value representing a point on the surface of
+          Earth.
+      array_value:
+          An array value.  Cannot directly contain another array value,
+          though can contain an map which contains another array.
+      map_value:
+          A map value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.Value)
+    ),
+)
+_sym_db.RegisterMessage(Value)
+
+ArrayValue = _reflection.GeneratedProtocolMessageType(
+    "ArrayValue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARRAYVALUE,
+        __module__="google.cloud.firestore_v1.proto.document_pb2",
+        __doc__="""An array value.
+  
+  
+  Attributes:
+      values:
+          Values in the array.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ArrayValue)
+    ),
+)
+_sym_db.RegisterMessage(ArrayValue)
+
+MapValue = _reflection.GeneratedProtocolMessageType(
+    "MapValue",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MAPVALUE_FIELDSENTRY,
+                __module__="google.cloud.firestore_v1.proto.document_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.MapValue.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_MAPVALUE,
+        __module__="google.cloud.firestore_v1.proto.document_pb2",
+        __doc__="""A map value.
+  
+  
+  Attributes:
+      fields:
+          The map's fields.  The map keys represent field names. Field
+          names matching the regular expression ``__.*__`` are reserved.
+          Reserved field names are forbidden except in certain
+          documented contexts. The map keys, represented as UTF-8, must
+          not exceed 1,500 bytes and cannot be empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.MapValue)
+    ),
+)
+_sym_db.RegisterMessage(MapValue)
+_sym_db.RegisterMessage(MapValue.FieldsEntry)
+
+
+DESCRIPTOR._options = None
+_DOCUMENT_FIELDSENTRY._options = None
+_MAPVALUE_FIELDSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/document_pb2_grpc.py b/firestore/google/cloud/firestore_v1/proto/document_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/document_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1/proto/firestore.proto b/firestore/google/cloud/firestore_v1/proto/firestore.proto
new file mode 100644
index 000000000000..5dc9667e2ca2
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/firestore.proto
@@ -0,0 +1,761 @@
+// 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.firestore.v1;
+
+import "google/api/annotations.proto";
+import "google/firestore/v1/common.proto";
+import "google/firestore/v1/document.proto";
+import "google/firestore/v1/query.proto";
+import "google/firestore/v1/write.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1;firestore";
+option java_multiple_files = true;
+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.
+service Firestore {
+  // Gets a single document.
+  rpc GetDocument(GetDocumentRequest) returns (Document) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/databases/*/documents/*/**}"
+    };
+  }
+
+  // Lists documents.
+  rpc ListDocuments(ListDocumentsRequest) returns (ListDocumentsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/databases/*/documents/*/**}/{collection_id}"
+    };
+  }
+
+  // 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"
+    };
+  }
+
+  // Deletes a document.
+  rpc DeleteDocument(DeleteDocumentRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/databases/*/documents/*/**}"
+    };
+  }
+
+  // Gets multiple documents.
+  //
+  // Documents returned by this method are not guaranteed to be returned in the
+  // same order that they were requested.
+  rpc BatchGetDocuments(BatchGetDocumentsRequest) returns (stream BatchGetDocumentsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/databases/*}/documents:batchGet"
+      body: "*"
+    };
+  }
+
+  // Starts a new transaction.
+  rpc BeginTransaction(BeginTransactionRequest) returns (BeginTransactionResponse) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/databases/*}/documents:beginTransaction"
+      body: "*"
+    };
+  }
+
+  // Commits a transaction, while optionally updating documents.
+  rpc Commit(CommitRequest) returns (CommitResponse) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/databases/*}/documents:commit"
+      body: "*"
+    };
+  }
+
+  // Rolls back a transaction.
+  rpc Rollback(RollbackRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/databases/*}/documents:rollback"
+      body: "*"
+    };
+  }
+
+  // Runs a query.
+  rpc RunQuery(RunQueryRequest) returns (stream RunQueryResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/databases/*/documents}:runQuery"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/databases/*/documents/*/**}:runQuery"
+        body: "*"
+      }
+    };
+  }
+
+  // Streams batches of document updates and deletes, in order.
+  rpc Write(stream WriteRequest) returns (stream WriteResponse) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/databases/*}/documents:write"
+      body: "*"
+    };
+  }
+
+  // Listens to changes.
+  rpc Listen(stream ListenRequest) returns (stream ListenResponse) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/databases/*}/documents:listen"
+      body: "*"
+    };
+  }
+
+  // Lists all the collection IDs underneath a document.
+  rpc ListCollectionIds(ListCollectionIdsRequest) returns (ListCollectionIdsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/databases/*/documents}:listCollectionIds"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/databases/*/documents/*/**}:listCollectionIds"
+        body: "*"
+      }
+    };
+  }
+}
+
+// The request for [Firestore.GetDocument][google.firestore.v1.Firestore.GetDocument].
+message GetDocumentRequest {
+  // The resource name of the Document to get. In the format:
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  string name = 1;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If the document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 2;
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads the document in a transaction.
+    bytes transaction = 3;
+
+    // Reads the version of the document at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 5;
+  }
+}
+
+// The request for [Firestore.ListDocuments][google.firestore.v1.Firestore.ListDocuments].
+message ListDocumentsRequest {
+  // 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;
+
+  // The collection ID, relative to `parent`, to list. For example: `chatrooms`
+  // or `messages`.
+  string collection_id = 2;
+
+  // The maximum number of documents to return.
+  int32 page_size = 3;
+
+  // The `next_page_token` value returned from a previous List request, if any.
+  string page_token = 4;
+
+  // The order to sort results by. For example: `priority desc, name`.
+  string order_by = 6;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If a document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 7;
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads documents in a transaction.
+    bytes transaction = 8;
+
+    // Reads documents as they were at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 10;
+  }
+
+  // If the list should show missing documents. A missing document is a
+  // document that does not exist but has sub-documents. These documents will
+  // be returned with a key but will not have fields, [Document.create_time][google.firestore.v1.Document.create_time],
+  // or [Document.update_time][google.firestore.v1.Document.update_time] set.
+  //
+  // Requests with `show_missing` may not specify `where` or
+  // `order_by`.
+  bool show_missing = 12;
+}
+
+// The response for [Firestore.ListDocuments][google.firestore.v1.Firestore.ListDocuments].
+message ListDocumentsResponse {
+  // The Documents found.
+  repeated Document documents = 1;
+
+  // The next page token.
+  string next_page_token = 2;
+}
+
+// The request for [Firestore.CreateDocument][google.firestore.v1.Firestore.CreateDocument].
+message CreateDocumentRequest {
+  // 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;
+
+  // The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+  string collection_id = 2;
+
+  // 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;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If the document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 5;
+}
+
+// The request for [Firestore.UpdateDocument][google.firestore.v1.Firestore.UpdateDocument].
+message UpdateDocumentRequest {
+  // The updated document.
+  // Creates the document if it does not already exist.
+  Document document = 1;
+
+  // The fields to update.
+  // None of the field paths in the mask may contain a reserved name.
+  //
+  // If the document exists on the server and has fields not referenced in the
+  // mask, they are left unchanged.
+  // Fields referenced in the mask, but not present in the input document, are
+  // deleted from the document on the server.
+  DocumentMask update_mask = 2;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If the document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 3;
+
+  // An optional precondition on the document.
+  // The request will fail if this is set and not met by the target document.
+  Precondition current_document = 4;
+}
+
+// The request for [Firestore.DeleteDocument][google.firestore.v1.Firestore.DeleteDocument].
+message DeleteDocumentRequest {
+  // The resource name of the Document to delete. In the format:
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  string name = 1;
+
+  // An optional precondition on the document.
+  // The request will fail if this is set and not met by the target document.
+  Precondition current_document = 2;
+}
+
+// The request for [Firestore.BatchGetDocuments][google.firestore.v1.Firestore.BatchGetDocuments].
+message BatchGetDocumentsRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The names of the documents to retrieve. In the format:
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  // The request will fail if any of the document is not a child resource of the
+  // given `database`. Duplicate names will be elided.
+  repeated string documents = 2;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If a document has a field that is not present in this mask, that field will
+  // not be returned in the response.
+  DocumentMask mask = 3;
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads documents in a transaction.
+    bytes transaction = 4;
+
+    // Starts a new transaction and reads the documents.
+    // Defaults to a read-only transaction.
+    // The new transaction ID will be returned as the first response in the
+    // stream.
+    TransactionOptions new_transaction = 5;
+
+    // Reads documents as they were at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 7;
+  }
+}
+
+// The streamed response for [Firestore.BatchGetDocuments][google.firestore.v1.Firestore.BatchGetDocuments].
+message BatchGetDocumentsResponse {
+  // A single result.
+  // This can be empty if the server is just returning a transaction.
+  oneof result {
+    // A document that was requested.
+    Document found = 1;
+
+    // A document name that was requested but does not exist. In the format:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    string missing = 2;
+  }
+
+  // The transaction that was started as part of this request.
+  // Will only be set in the first response, and only if
+  // [BatchGetDocumentsRequest.new_transaction][google.firestore.v1.BatchGetDocumentsRequest.new_transaction] was set in the request.
+  bytes transaction = 3;
+
+  // The time at which the document was read.
+  // This may be monotically increasing, in this case the previous documents in
+  // the result stream are guaranteed not to have changed between their
+  // read_time and this one.
+  google.protobuf.Timestamp read_time = 4;
+}
+
+// The request for [Firestore.BeginTransaction][google.firestore.v1.Firestore.BeginTransaction].
+message BeginTransactionRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The options for the transaction.
+  // Defaults to a read-write transaction.
+  TransactionOptions options = 2;
+}
+
+// The response for [Firestore.BeginTransaction][google.firestore.v1.Firestore.BeginTransaction].
+message BeginTransactionResponse {
+  // The transaction that was started.
+  bytes transaction = 1;
+}
+
+// The request for [Firestore.Commit][google.firestore.v1.Firestore.Commit].
+message CommitRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The writes to apply.
+  //
+  // Always executed atomically and in order.
+  repeated Write writes = 2;
+
+  // If set, applies all writes in this transaction, and commits it.
+  bytes transaction = 3;
+}
+
+// The response for [Firestore.Commit][google.firestore.v1.Firestore.Commit].
+message CommitResponse {
+  // The result of applying the writes.
+  //
+  // This i-th write result corresponds to the i-th write in the
+  // request.
+  repeated WriteResult write_results = 1;
+
+  // The time at which the commit occurred.
+  google.protobuf.Timestamp commit_time = 2;
+}
+
+// The request for [Firestore.Rollback][google.firestore.v1.Firestore.Rollback].
+message RollbackRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The transaction to roll back.
+  bytes transaction = 2;
+}
+
+// The request for [Firestore.RunQuery][google.firestore.v1.Firestore.RunQuery].
+message RunQueryRequest {
+  // 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;
+
+  // The query to run.
+  oneof query_type {
+    // A structured query.
+    StructuredQuery structured_query = 2;
+  }
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads documents in a transaction.
+    bytes transaction = 5;
+
+    // Starts a new transaction and reads the documents.
+    // Defaults to a read-only transaction.
+    // The new transaction ID will be returned as the first response in the
+    // stream.
+    TransactionOptions new_transaction = 6;
+
+    // Reads documents as they were at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 7;
+  }
+}
+
+// The response for [Firestore.RunQuery][google.firestore.v1.Firestore.RunQuery].
+message RunQueryResponse {
+  // The transaction that was started as part of this request.
+  // Can only be set in the first response, and only if
+  // [RunQueryRequest.new_transaction][google.firestore.v1.RunQueryRequest.new_transaction] was set in the request.
+  // If set, no other fields will be set in this response.
+  bytes transaction = 2;
+
+  // A query result.
+  // Not set when reporting partial progress.
+  Document document = 1;
+
+  // The time at which the document was read. This may be monotonically
+  // increasing; in this case, the previous documents in the result stream are
+  // guaranteed not to have changed between their `read_time` and this one.
+  //
+  // If the query returns no results, a response with `read_time` and no
+  // `document` will be sent, and this represents the time at which the query
+  // was run.
+  google.protobuf.Timestamp read_time = 3;
+
+  // The number of results that have been skipped due to an offset between
+  // the last response and the current response.
+  int32 skipped_results = 4;
+}
+
+// The request for [Firestore.Write][google.firestore.v1.Firestore.Write].
+//
+// The first request creates a stream, or resumes an existing one from a token.
+//
+// When creating a new stream, the server replies with a response containing
+// only an ID and a token, to use in the next request.
+//
+// When resuming a stream, the server first streams any responses later than the
+// 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:
+  // `projects/{project_id}/databases/{database_id}`.
+  // This is only required in the first message.
+  string database = 1;
+
+  // The ID of the write stream to resume.
+  // This may only be set in the first message. When left empty, a new write
+  // stream will be created.
+  string stream_id = 2;
+
+  // The writes to apply.
+  //
+  // Always executed atomically and in order.
+  // This must be empty on the first request.
+  // This may be empty on the last request.
+  // This must not be empty on all other requests.
+  repeated Write writes = 3;
+
+  // A stream token that was previously sent by the server.
+  //
+  // The client should set this field to the token from the most recent
+  // [WriteResponse][google.firestore.v1.WriteResponse] it has received. This acknowledges that the client has
+  // received responses up to this token. After sending this token, earlier
+  // tokens may not be used anymore.
+  //
+  // The server may close the stream if there are too many unacknowledged
+  // responses.
+  //
+  // Leave this field unset when creating a new stream. To resume a stream at
+  // a specific point, set this field and the `stream_id` field.
+  //
+  // Leave this field unset when creating a new stream.
+  bytes stream_token = 4;
+
+  // Labels associated with this write request.
+  map<string, string> labels = 5;
+}
+
+// The response for [Firestore.Write][google.firestore.v1.Firestore.Write].
+message WriteResponse {
+  // The ID of the stream.
+  // Only set on the first message, when a new stream was created.
+  string stream_id = 1;
+
+  // A token that represents the position of this response in the stream.
+  // This can be used by a client to resume the stream at this point.
+  //
+  // This field is always set.
+  bytes stream_token = 2;
+
+  // The result of applying the writes.
+  //
+  // This i-th write result corresponds to the i-th write in the
+  // request.
+  repeated WriteResult write_results = 3;
+
+  // The time at which the commit occurred.
+  google.protobuf.Timestamp commit_time = 4;
+}
+
+// A request for [Firestore.Listen][google.firestore.v1.Firestore.Listen]
+message ListenRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The supported target changes.
+  oneof target_change {
+    // A target to add to this stream.
+    Target add_target = 2;
+
+    // The ID of a target to remove from this stream.
+    int32 remove_target = 3;
+  }
+
+  // Labels associated with this target change.
+  map<string, string> labels = 4;
+}
+
+// The response for [Firestore.Listen][google.firestore.v1.Firestore.Listen].
+message ListenResponse {
+  // The supported responses.
+  oneof response_type {
+    // Targets have changed.
+    TargetChange target_change = 2;
+
+    // A [Document][google.firestore.v1.Document] has changed.
+    DocumentChange document_change = 3;
+
+    // A [Document][google.firestore.v1.Document] has been deleted.
+    DocumentDelete document_delete = 4;
+
+    // A [Document][google.firestore.v1.Document] has been removed from a target (because it is no longer
+    // relevant to that target).
+    DocumentRemove document_remove = 6;
+
+    // A filter to apply to the set of documents previously returned for the
+    // given target.
+    //
+    // Returned when documents may have been removed from the given target, but
+    // the exact documents are unknown.
+    ExistenceFilter filter = 5;
+  }
+}
+
+// A specification of a set of documents to listen to.
+message Target {
+  // A target specified by a set of documents names.
+  message DocumentsTarget {
+    // The names of the documents to retrieve. In the format:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    // The request will fail if any of the document is not a child resource of
+    // the given `database`. Duplicate names will be elided.
+    repeated string documents = 2;
+  }
+
+  // A target specified by a query.
+  message QueryTarget {
+    // 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;
+
+    // The query to run.
+    oneof query_type {
+      // A structured query.
+      StructuredQuery structured_query = 2;
+    }
+  }
+
+  // The type of target to listen to.
+  oneof target_type {
+    // A target specified by a query.
+    QueryTarget query = 2;
+
+    // A target specified by a set of document names.
+    DocumentsTarget documents = 3;
+  }
+
+  // When to start listening.
+  //
+  // If not specified, all matching Documents are returned before any
+  // subsequent changes.
+  oneof resume_type {
+    // A resume token from a prior [TargetChange][google.firestore.v1.TargetChange] for an identical target.
+    //
+    // Using a resume token with a different target is unsupported and may fail.
+    bytes resume_token = 4;
+
+    // Start listening after a specific `read_time`.
+    //
+    // The client must know the state of matching documents at this time.
+    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.
+  int32 target_id = 5;
+
+  // If the target should be removed once it is current and consistent.
+  bool once = 6;
+}
+
+// Targets being watched have changed.
+message TargetChange {
+  // The type of change.
+  enum TargetChangeType {
+    // No change has occurred. Used only to send an updated `resume_token`.
+    NO_CHANGE = 0;
+
+    // The targets have been added.
+    ADD = 1;
+
+    // The targets have been removed.
+    REMOVE = 2;
+
+    // The targets reflect all changes committed before the targets were added
+    // to the stream.
+    //
+    // This will be sent after or with a `read_time` that is greater than or
+    // equal to the time at which the targets were added.
+    //
+    // Listeners can wait for this change if read-after-write semantics
+    // are desired.
+    CURRENT = 3;
+
+    // The targets have been reset, and a new initial state for the targets
+    // will be returned in subsequent changes.
+    //
+    // After the initial state is complete, `CURRENT` will be returned even
+    // if the target was previously indicated to be `CURRENT`.
+    RESET = 4;
+  }
+
+  // The type of change that occurred.
+  TargetChangeType target_change_type = 1;
+
+  // The target IDs of targets that have changed.
+  //
+  // 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.
+  repeated int32 target_ids = 2;
+
+  // The error that resulted in this change, if applicable.
+  google.rpc.Status cause = 3;
+
+  // A token that can be used to resume the stream for the given `target_ids`,
+  // or all targets if `target_ids` is empty.
+  //
+  // Not set on every target change.
+  bytes resume_token = 4;
+
+  // The consistent `read_time` for the given `target_ids` (omitted when the
+  // target_ids are not at a consistent snapshot).
+  //
+  // The stream is guaranteed to send a `read_time` with `target_ids` empty
+  // whenever the entire stream reaches a new consistent snapshot. ADD,
+  // CURRENT, and RESET messages are guaranteed to (eventually) result in a
+  // new consistent snapshot (while NO_CHANGE and REMOVE messages are not).
+  //
+  // For a given stream, `read_time` is guaranteed to be monotonically
+  // increasing.
+  google.protobuf.Timestamp read_time = 6;
+}
+
+// The request for [Firestore.ListCollectionIds][google.firestore.v1.Firestore.ListCollectionIds].
+message ListCollectionIdsRequest {
+  // 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;
+
+  // The maximum number of results to return.
+  int32 page_size = 2;
+
+  // A page token. Must be a value from
+  // [ListCollectionIdsResponse][google.firestore.v1.ListCollectionIdsResponse].
+  string page_token = 3;
+}
+
+// The response from [Firestore.ListCollectionIds][google.firestore.v1.Firestore.ListCollectionIds].
+message ListCollectionIdsResponse {
+  // The collection ids.
+  repeated string collection_ids = 1;
+
+  // A page token that may be used to continue the list.
+  string next_page_token = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1/proto/firestore_pb2.py b/firestore/google/cloud/firestore_v1/proto/firestore_pb2.py
new file mode 100644
index 000000000000..5932d5023ace
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/firestore_pb2.py
@@ -0,0 +1,3784 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1/proto/firestore.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.firestore_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    query_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    write_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1/proto/firestore.proto",
+    package="google.firestore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.firestore.v1B\016FirestoreProtoP\001Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\242\002\004GCFS\252\002\031Google.Cloud.Firestore.V1\312\002\031Google\\Cloud\\Firestore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/firestore_v1/proto/firestore.proto\x12\x13google.firestore.v1\x1a\x1cgoogle/api/annotations.proto\x1a,google/cloud/firestore_v1/proto/common.proto\x1a.google/cloud/firestore_v1/proto/document.proto\x1a+google/cloud/firestore_v1/proto/query.proto\x1a+google/cloud/firestore_v1/proto/write.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xb3\x01\n\x12GetDocumentRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x04mask\x18\x02 \x01(\x0b\x32!.google.firestore.v1.DocumentMask\x12\x15\n\x0btransaction\x18\x03 \x01(\x0cH\x00\x12/\n\tread_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x16\n\x14\x63onsistency_selector"\x9d\x02\n\x14ListDocumentsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12/\n\x04mask\x18\x07 \x01(\x0b\x32!.google.firestore.v1.DocumentMask\x12\x15\n\x0btransaction\x18\x08 \x01(\x0cH\x00\x12/\n\tread_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x14\n\x0cshow_missing\x18\x0c \x01(\x08\x42\x16\n\x14\x63onsistency_selector"b\n\x15ListDocumentsResponse\x12\x30\n\tdocuments\x18\x01 \x03(\x0b\x32\x1d.google.firestore.v1.Document\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xb5\x01\n\x15\x43reateDocumentRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12\x13\n\x0b\x64ocument_id\x18\x03 \x01(\t\x12/\n\x08\x64ocument\x18\x04 \x01(\x0b\x32\x1d.google.firestore.v1.Document\x12/\n\x04mask\x18\x05 \x01(\x0b\x32!.google.firestore.v1.DocumentMask"\xee\x01\n\x15UpdateDocumentRequest\x12/\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\x1d.google.firestore.v1.Document\x12\x36\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32!.google.firestore.v1.DocumentMask\x12/\n\x04mask\x18\x03 \x01(\x0b\x32!.google.firestore.v1.DocumentMask\x12;\n\x10\x63urrent_document\x18\x04 \x01(\x0b\x32!.google.firestore.v1.Precondition"b\n\x15\x44\x65leteDocumentRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12;\n\x10\x63urrent_document\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition"\x94\x02\n\x18\x42\x61tchGetDocumentsRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x11\n\tdocuments\x18\x02 \x03(\t\x12/\n\x04mask\x18\x03 \x01(\x0b\x32!.google.firestore.v1.DocumentMask\x12\x15\n\x0btransaction\x18\x04 \x01(\x0cH\x00\x12\x42\n\x0fnew_transaction\x18\x05 \x01(\x0b\x32\'.google.firestore.v1.TransactionOptionsH\x00\x12/\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x16\n\x14\x63onsistency_selector"\xac\x01\n\x19\x42\x61tchGetDocumentsResponse\x12.\n\x05\x66ound\x18\x01 \x01(\x0b\x32\x1d.google.firestore.v1.DocumentH\x00\x12\x11\n\x07missing\x18\x02 \x01(\tH\x00\x12\x13\n\x0btransaction\x18\x03 \x01(\x0c\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x08\n\x06result"e\n\x17\x42\x65ginTransactionRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x38\n\x07options\x18\x02 \x01(\x0b\x32\'.google.firestore.v1.TransactionOptions"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c"b\n\rCommitRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12*\n\x06writes\x18\x02 \x03(\x0b\x32\x1a.google.firestore.v1.Write\x12\x13\n\x0btransaction\x18\x03 \x01(\x0c"z\n\x0e\x43ommitResponse\x12\x37\n\rwrite_results\x18\x01 \x03(\x0b\x32 .google.firestore.v1.WriteResult\x12/\n\x0b\x63ommit_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"8\n\x0fRollbackRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x13\n\x0btransaction\x18\x02 \x01(\x0c"\x95\x02\n\x0fRunQueryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12@\n\x10structured_query\x18\x02 \x01(\x0b\x32$.google.firestore.v1.StructuredQueryH\x00\x12\x15\n\x0btransaction\x18\x05 \x01(\x0cH\x01\x12\x42\n\x0fnew_transaction\x18\x06 \x01(\x0b\x32\'.google.firestore.v1.TransactionOptionsH\x01\x12/\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x42\x0c\n\nquery_typeB\x16\n\x14\x63onsistency_selector"\xa0\x01\n\x10RunQueryResponse\x12\x13\n\x0btransaction\x18\x02 \x01(\x0c\x12/\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\x1d.google.firestore.v1.Document\x12-\n\tread_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fskipped_results\x18\x04 \x01(\x05"\xe3\x01\n\x0cWriteRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x11\n\tstream_id\x18\x02 \x01(\t\x12*\n\x06writes\x18\x03 \x03(\x0b\x32\x1a.google.firestore.v1.Write\x12\x14\n\x0cstream_token\x18\x04 \x01(\x0c\x12=\n\x06labels\x18\x05 \x03(\x0b\x32-.google.firestore.v1.WriteRequest.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xa2\x01\n\rWriteResponse\x12\x11\n\tstream_id\x18\x01 \x01(\t\x12\x14\n\x0cstream_token\x18\x02 \x01(\x0c\x12\x37\n\rwrite_results\x18\x03 \x03(\x0b\x32 .google.firestore.v1.WriteResult\x12/\n\x0b\x63ommit_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xed\x01\n\rListenRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x31\n\nadd_target\x18\x02 \x01(\x0b\x32\x1b.google.firestore.v1.TargetH\x00\x12\x17\n\rremove_target\x18\x03 \x01(\x05H\x00\x12>\n\x06labels\x18\x04 \x03(\x0b\x32..google.firestore.v1.ListenRequest.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0f\n\rtarget_change"\xd5\x02\n\x0eListenResponse\x12:\n\rtarget_change\x18\x02 \x01(\x0b\x32!.google.firestore.v1.TargetChangeH\x00\x12>\n\x0f\x64ocument_change\x18\x03 \x01(\x0b\x32#.google.firestore.v1.DocumentChangeH\x00\x12>\n\x0f\x64ocument_delete\x18\x04 \x01(\x0b\x32#.google.firestore.v1.DocumentDeleteH\x00\x12>\n\x0f\x64ocument_remove\x18\x06 \x01(\x0b\x32#.google.firestore.v1.DocumentRemoveH\x00\x12\x36\n\x06\x66ilter\x18\x05 \x01(\x0b\x32$.google.firestore.v1.ExistenceFilterH\x00\x42\x0f\n\rresponse_type"\xa1\x03\n\x06Target\x12\x38\n\x05query\x18\x02 \x01(\x0b\x32\'.google.firestore.v1.Target.QueryTargetH\x00\x12@\n\tdocuments\x18\x03 \x01(\x0b\x32+.google.firestore.v1.Target.DocumentsTargetH\x00\x12\x16\n\x0cresume_token\x18\x04 \x01(\x0cH\x01\x12/\n\tread_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x12\x11\n\ttarget_id\x18\x05 \x01(\x05\x12\x0c\n\x04once\x18\x06 \x01(\x08\x1a$\n\x0f\x44ocumentsTarget\x12\x11\n\tdocuments\x18\x02 \x03(\t\x1am\n\x0bQueryTarget\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12@\n\x10structured_query\x18\x02 \x01(\x0b\x32$.google.firestore.v1.StructuredQueryH\x00\x42\x0c\n\nquery_typeB\r\n\x0btarget_typeB\r\n\x0bresume_type"\xaa\x02\n\x0cTargetChange\x12N\n\x12target_change_type\x18\x01 \x01(\x0e\x32\x32.google.firestore.v1.TargetChange.TargetChangeType\x12\x12\n\ntarget_ids\x18\x02 \x03(\x05\x12!\n\x05\x63\x61use\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12-\n\tread_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"N\n\x10TargetChangeType\x12\r\n\tNO_CHANGE\x10\x00\x12\x07\n\x03\x41\x44\x44\x10\x01\x12\n\n\x06REMOVE\x10\x02\x12\x0b\n\x07\x43URRENT\x10\x03\x12\t\n\x05RESET\x10\x04"Q\n\x18ListCollectionIdsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"L\n\x19ListCollectionIdsResponse\x12\x16\n\x0e\x63ollection_ids\x18\x01 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\x84\x12\n\tFirestore\x12\x8f\x01\n\x0bGetDocument\x12\'.google.firestore.v1.GetDocumentRequest\x1a\x1d.google.firestore.v1.Document"8\x82\xd3\xe4\x93\x02\x32\x12\x30/v1/{name=projects/*/databases/*/documents/*/**}\x12\xb2\x01\n\rListDocuments\x12).google.firestore.v1.ListDocumentsRequest\x1a*.google.firestore.v1.ListDocumentsResponse"J\x82\xd3\xe4\x93\x02\x44\x12\x42/v1/{parent=projects/*/databases/*/documents/*/**}/{collection_id}\x12\xaf\x01\n\x0e\x43reateDocument\x12*.google.firestore.v1.CreateDocumentRequest\x1a\x1d.google.firestore.v1.Document"R\x82\xd3\xe4\x93\x02L"@/v1/{parent=projects/*/databases/*/documents/**}/{collection_id}:\x08\x64ocument\x12\xa8\x01\n\x0eUpdateDocument\x12*.google.firestore.v1.UpdateDocumentRequest\x1a\x1d.google.firestore.v1.Document"K\x82\xd3\xe4\x93\x02\x45\x32\x39/v1/{document.name=projects/*/databases/*/documents/*/**}:\x08\x64ocument\x12\x8e\x01\n\x0e\x44\x65leteDocument\x12*.google.firestore.v1.DeleteDocumentRequest\x1a\x16.google.protobuf.Empty"8\x82\xd3\xe4\x93\x02\x32*0/v1/{name=projects/*/databases/*/documents/*/**}\x12\xb9\x01\n\x11\x42\x61tchGetDocuments\x12-.google.firestore.v1.BatchGetDocumentsRequest\x1a..google.firestore.v1.BatchGetDocumentsResponse"C\x82\xd3\xe4\x93\x02="8/v1/{database=projects/*/databases/*}/documents:batchGet:\x01*0\x01\x12\xbc\x01\n\x10\x42\x65ginTransaction\x12,.google.firestore.v1.BeginTransactionRequest\x1a-.google.firestore.v1.BeginTransactionResponse"K\x82\xd3\xe4\x93\x02\x45"@/v1/{database=projects/*/databases/*}/documents:beginTransaction:\x01*\x12\x94\x01\n\x06\x43ommit\x12".google.firestore.v1.CommitRequest\x1a#.google.firestore.v1.CommitResponse"A\x82\xd3\xe4\x93\x02;"6/v1/{database=projects/*/databases/*}/documents:commit:\x01*\x12\x8d\x01\n\x08Rollback\x12$.google.firestore.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"C\x82\xd3\xe4\x93\x02="8/v1/{database=projects/*/databases/*}/documents:rollback:\x01*\x12\xdf\x01\n\x08RunQuery\x12$.google.firestore.v1.RunQueryRequest\x1a%.google.firestore.v1.RunQueryResponse"\x83\x01\x82\xd3\xe4\x93\x02}"6/v1/{parent=projects/*/databases/*/documents}:runQuery:\x01*Z@";/v1/{parent=projects/*/databases/*/documents/*/**}:runQuery:\x01*0\x01\x12\x94\x01\n\x05Write\x12!.google.firestore.v1.WriteRequest\x1a".google.firestore.v1.WriteResponse"@\x82\xd3\xe4\x93\x02:"5/v1/{database=projects/*/databases/*}/documents:write:\x01*(\x01\x30\x01\x12\x98\x01\n\x06Listen\x12".google.firestore.v1.ListenRequest\x1a#.google.firestore.v1.ListenResponse"A\x82\xd3\xe4\x93\x02;"6/v1/{database=projects/*/databases/*}/documents:listen:\x01*(\x01\x30\x01\x12\x8b\x02\n\x11ListCollectionIds\x12-.google.firestore.v1.ListCollectionIdsRequest\x1a..google.firestore.v1.ListCollectionIdsResponse"\x96\x01\x82\xd3\xe4\x93\x02\x8f\x01"?/v1/{parent=projects/*/databases/*/documents}:listCollectionIds:\x01*ZI"D/v1/{parent=projects/*/databases/*/documents/*/**}:listCollectionIds:\x01*B\xa8\x01\n\x17\x63om.google.firestore.v1B\x0e\x46irestoreProtoP\x01Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\xa2\x02\x04GCFS\xaa\x02\x19Google.Cloud.Firestore.V1\xca\x02\x19Google\\Cloud\\Firestore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TARGETCHANGE_TARGETCHANGETYPE = _descriptor.EnumDescriptor(
+    name="TargetChangeType",
+    full_name="google.firestore.v1.TargetChange.TargetChangeType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NO_CHANGE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CURRENT", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESET", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4419,
+    serialized_end=4497,
+)
+_sym_db.RegisterEnumDescriptor(_TARGETCHANGE_TARGETCHANGETYPE)
+
+
+_GETDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="GetDocumentRequest",
+    full_name="google.firestore.v1.GetDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.v1.GetDocumentRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1.GetDocumentRequest.mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.GetDocumentRequest.transaction",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.GetDocumentRequest.read_time",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1.GetDocumentRequest.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=374,
+    serialized_end=553,
+)
+
+
+_LISTDOCUMENTSREQUEST = _descriptor.Descriptor(
+    name="ListDocumentsRequest",
+    full_name="google.firestore.v1.ListDocumentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1.ListDocumentsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.v1.ListDocumentsRequest.collection_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.v1.ListDocumentsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.v1.ListDocumentsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.firestore.v1.ListDocumentsRequest.order_by",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1.ListDocumentsRequest.mask",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.ListDocumentsRequest.transaction",
+            index=6,
+            number=8,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.ListDocumentsRequest.read_time",
+            index=7,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="show_missing",
+            full_name="google.firestore.v1.ListDocumentsRequest.show_missing",
+            index=8,
+            number=12,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1.ListDocumentsRequest.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=556,
+    serialized_end=841,
+)
+
+
+_LISTDOCUMENTSRESPONSE = _descriptor.Descriptor(
+    name="ListDocumentsResponse",
+    full_name="google.firestore.v1.ListDocumentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1.ListDocumentsResponse.documents",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.v1.ListDocumentsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=843,
+    serialized_end=941,
+)
+
+
+_CREATEDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="CreateDocumentRequest",
+    full_name="google.firestore.v1.CreateDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1.CreateDocumentRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.v1.CreateDocumentRequest.collection_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_id",
+            full_name="google.firestore.v1.CreateDocumentRequest.document_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.CreateDocumentRequest.document",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1.CreateDocumentRequest.mask",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=944,
+    serialized_end=1125,
+)
+
+
+_UPDATEDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="UpdateDocumentRequest",
+    full_name="google.firestore.v1.UpdateDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.UpdateDocumentRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.firestore.v1.UpdateDocumentRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1.UpdateDocumentRequest.mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_document",
+            full_name="google.firestore.v1.UpdateDocumentRequest.current_document",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1128,
+    serialized_end=1366,
+)
+
+
+_DELETEDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="DeleteDocumentRequest",
+    full_name="google.firestore.v1.DeleteDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.v1.DeleteDocumentRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_document",
+            full_name="google.firestore.v1.DeleteDocumentRequest.current_document",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1368,
+    serialized_end=1466,
+)
+
+
+_BATCHGETDOCUMENTSREQUEST = _descriptor.Descriptor(
+    name="BatchGetDocumentsRequest",
+    full_name="google.firestore.v1.BatchGetDocumentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.documents",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.transaction",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_transaction",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.new_transaction",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.read_time",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1.BatchGetDocumentsRequest.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1469,
+    serialized_end=1745,
+)
+
+
+_BATCHGETDOCUMENTSRESPONSE = _descriptor.Descriptor(
+    name="BatchGetDocumentsResponse",
+    full_name="google.firestore.v1.BatchGetDocumentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="found",
+            full_name="google.firestore.v1.BatchGetDocumentsResponse.found",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing",
+            full_name="google.firestore.v1.BatchGetDocumentsResponse.missing",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.BatchGetDocumentsResponse.transaction",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.BatchGetDocumentsResponse.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="result",
+            full_name="google.firestore.v1.BatchGetDocumentsResponse.result",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1748,
+    serialized_end=1920,
+)
+
+
+_BEGINTRANSACTIONREQUEST = _descriptor.Descriptor(
+    name="BeginTransactionRequest",
+    full_name="google.firestore.v1.BeginTransactionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1.BeginTransactionRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="options",
+            full_name="google.firestore.v1.BeginTransactionRequest.options",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1922,
+    serialized_end=2023,
+)
+
+
+_BEGINTRANSACTIONRESPONSE = _descriptor.Descriptor(
+    name="BeginTransactionResponse",
+    full_name="google.firestore.v1.BeginTransactionResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.BeginTransactionResponse.transaction",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2025,
+    serialized_end=2072,
+)
+
+
+_COMMITREQUEST = _descriptor.Descriptor(
+    name="CommitRequest",
+    full_name="google.firestore.v1.CommitRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1.CommitRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="writes",
+            full_name="google.firestore.v1.CommitRequest.writes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.CommitRequest.transaction",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2074,
+    serialized_end=2172,
+)
+
+
+_COMMITRESPONSE = _descriptor.Descriptor(
+    name="CommitResponse",
+    full_name="google.firestore.v1.CommitResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="write_results",
+            full_name="google.firestore.v1.CommitResponse.write_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commit_time",
+            full_name="google.firestore.v1.CommitResponse.commit_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2174,
+    serialized_end=2296,
+)
+
+
+_ROLLBACKREQUEST = _descriptor.Descriptor(
+    name="RollbackRequest",
+    full_name="google.firestore.v1.RollbackRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1.RollbackRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.RollbackRequest.transaction",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2298,
+    serialized_end=2354,
+)
+
+
+_RUNQUERYREQUEST = _descriptor.Descriptor(
+    name="RunQueryRequest",
+    full_name="google.firestore.v1.RunQueryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1.RunQueryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_query",
+            full_name="google.firestore.v1.RunQueryRequest.structured_query",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.RunQueryRequest.transaction",
+            index=2,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_transaction",
+            full_name="google.firestore.v1.RunQueryRequest.new_transaction",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.RunQueryRequest.read_time",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="query_type",
+            full_name="google.firestore.v1.RunQueryRequest.query_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1.RunQueryRequest.consistency_selector",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=2357,
+    serialized_end=2634,
+)
+
+
+_RUNQUERYRESPONSE = _descriptor.Descriptor(
+    name="RunQueryResponse",
+    full_name="google.firestore.v1.RunQueryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1.RunQueryResponse.transaction",
+            index=0,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.RunQueryResponse.document",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.RunQueryResponse.read_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skipped_results",
+            full_name="google.firestore.v1.RunQueryResponse.skipped_results",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2637,
+    serialized_end=2797,
+)
+
+
+_WRITEREQUEST_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.firestore.v1.WriteRequest.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1.WriteRequest.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1.WriteRequest.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2982,
+    serialized_end=3027,
+)
+
+_WRITEREQUEST = _descriptor.Descriptor(
+    name="WriteRequest",
+    full_name="google.firestore.v1.WriteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1.WriteRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_id",
+            full_name="google.firestore.v1.WriteRequest.stream_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="writes",
+            full_name="google.firestore.v1.WriteRequest.writes",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_token",
+            full_name="google.firestore.v1.WriteRequest.stream_token",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.firestore.v1.WriteRequest.labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WRITEREQUEST_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2800,
+    serialized_end=3027,
+)
+
+
+_WRITERESPONSE = _descriptor.Descriptor(
+    name="WriteResponse",
+    full_name="google.firestore.v1.WriteResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stream_id",
+            full_name="google.firestore.v1.WriteResponse.stream_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_token",
+            full_name="google.firestore.v1.WriteResponse.stream_token",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="write_results",
+            full_name="google.firestore.v1.WriteResponse.write_results",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commit_time",
+            full_name="google.firestore.v1.WriteResponse.commit_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3030,
+    serialized_end=3192,
+)
+
+
+_LISTENREQUEST_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.firestore.v1.ListenRequest.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1.ListenRequest.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1.ListenRequest.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2982,
+    serialized_end=3027,
+)
+
+_LISTENREQUEST = _descriptor.Descriptor(
+    name="ListenRequest",
+    full_name="google.firestore.v1.ListenRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1.ListenRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="add_target",
+            full_name="google.firestore.v1.ListenRequest.add_target",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remove_target",
+            full_name="google.firestore.v1.ListenRequest.remove_target",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.firestore.v1.ListenRequest.labels",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LISTENREQUEST_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target_change",
+            full_name="google.firestore.v1.ListenRequest.target_change",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3195,
+    serialized_end=3432,
+)
+
+
+_LISTENRESPONSE = _descriptor.Descriptor(
+    name="ListenResponse",
+    full_name="google.firestore.v1.ListenResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_change",
+            full_name="google.firestore.v1.ListenResponse.target_change",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_change",
+            full_name="google.firestore.v1.ListenResponse.document_change",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_delete",
+            full_name="google.firestore.v1.ListenResponse.document_delete",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_remove",
+            full_name="google.firestore.v1.ListenResponse.document_remove",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.firestore.v1.ListenResponse.filter",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="response_type",
+            full_name="google.firestore.v1.ListenResponse.response_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3435,
+    serialized_end=3776,
+)
+
+
+_TARGET_DOCUMENTSTARGET = _descriptor.Descriptor(
+    name="DocumentsTarget",
+    full_name="google.firestore.v1.Target.DocumentsTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1.Target.DocumentsTarget.documents",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4019,
+    serialized_end=4055,
+)
+
+_TARGET_QUERYTARGET = _descriptor.Descriptor(
+    name="QueryTarget",
+    full_name="google.firestore.v1.Target.QueryTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1.Target.QueryTarget.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_query",
+            full_name="google.firestore.v1.Target.QueryTarget.structured_query",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="query_type",
+            full_name="google.firestore.v1.Target.QueryTarget.query_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=4057,
+    serialized_end=4166,
+)
+
+_TARGET = _descriptor.Descriptor(
+    name="Target",
+    full_name="google.firestore.v1.Target",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.firestore.v1.Target.query",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1.Target.documents",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.firestore.v1.Target.resume_token",
+            index=2,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.Target.read_time",
+            index=3,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_id",
+            full_name="google.firestore.v1.Target.target_id",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="once",
+            full_name="google.firestore.v1.Target.once",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TARGET_DOCUMENTSTARGET, _TARGET_QUERYTARGET],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target_type",
+            full_name="google.firestore.v1.Target.target_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="resume_type",
+            full_name="google.firestore.v1.Target.resume_type",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=3779,
+    serialized_end=4196,
+)
+
+
+_TARGETCHANGE = _descriptor.Descriptor(
+    name="TargetChange",
+    full_name="google.firestore.v1.TargetChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_change_type",
+            full_name="google.firestore.v1.TargetChange.target_change_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_ids",
+            full_name="google.firestore.v1.TargetChange.target_ids",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cause",
+            full_name="google.firestore.v1.TargetChange.cause",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.firestore.v1.TargetChange.resume_token",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.TargetChange.read_time",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TARGETCHANGE_TARGETCHANGETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4199,
+    serialized_end=4497,
+)
+
+
+_LISTCOLLECTIONIDSREQUEST = _descriptor.Descriptor(
+    name="ListCollectionIdsRequest",
+    full_name="google.firestore.v1.ListCollectionIdsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1.ListCollectionIdsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.v1.ListCollectionIdsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.v1.ListCollectionIdsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4499,
+    serialized_end=4580,
+)
+
+
+_LISTCOLLECTIONIDSRESPONSE = _descriptor.Descriptor(
+    name="ListCollectionIdsResponse",
+    full_name="google.firestore.v1.ListCollectionIdsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="collection_ids",
+            full_name="google.firestore.v1.ListCollectionIdsResponse.collection_ids",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.v1.ListCollectionIdsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4582,
+    serialized_end=4658,
+)
+
+_GETDOCUMENTREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_GETDOCUMENTREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _GETDOCUMENTREQUEST.fields_by_name["transaction"]
+)
+_GETDOCUMENTREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"]
+_GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _GETDOCUMENTREQUEST.fields_by_name["read_time"]
+)
+_GETDOCUMENTREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"]
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _LISTDOCUMENTSREQUEST.fields_by_name["transaction"]
+)
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _LISTDOCUMENTSREQUEST.fields_by_name["read_time"]
+)
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_LISTDOCUMENTSRESPONSE.fields_by_name[
+    "documents"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_CREATEDOCUMENTREQUEST.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_CREATEDOCUMENTREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "current_document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_DELETEDOCUMENTREQUEST.fields_by_name[
+    "current_document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "new_transaction"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._TRANSACTIONOPTIONS
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _BATCHGETDOCUMENTSREQUEST.fields_by_name["transaction"]
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _BATCHGETDOCUMENTSREQUEST.fields_by_name["new_transaction"]
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "new_transaction"
+].containing_oneof = _BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _BATCHGETDOCUMENTSREQUEST.fields_by_name["read_time"]
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "found"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"].fields.append(
+    _BATCHGETDOCUMENTSRESPONSE.fields_by_name["found"]
+)
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "found"
+].containing_oneof = _BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"]
+_BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"].fields.append(
+    _BATCHGETDOCUMENTSRESPONSE.fields_by_name["missing"]
+)
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "missing"
+].containing_oneof = _BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"]
+_BEGINTRANSACTIONREQUEST.fields_by_name[
+    "options"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._TRANSACTIONOPTIONS
+)
+_COMMITREQUEST.fields_by_name[
+    "writes"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._WRITE
+_COMMITRESPONSE.fields_by_name[
+    "write_results"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._WRITERESULT
+)
+_COMMITRESPONSE.fields_by_name[
+    "commit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_RUNQUERYREQUEST.fields_by_name[
+    "structured_query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "new_transaction"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._TRANSACTIONOPTIONS
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_RUNQUERYREQUEST.oneofs_by_name["query_type"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["structured_query"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "structured_query"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["query_type"]
+_RUNQUERYREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["transaction"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["consistency_selector"]
+_RUNQUERYREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["new_transaction"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "new_transaction"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["consistency_selector"]
+_RUNQUERYREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["read_time"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["consistency_selector"]
+_RUNQUERYRESPONSE.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_RUNQUERYRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WRITEREQUEST_LABELSENTRY.containing_type = _WRITEREQUEST
+_WRITEREQUEST.fields_by_name[
+    "writes"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._WRITE
+_WRITEREQUEST.fields_by_name["labels"].message_type = _WRITEREQUEST_LABELSENTRY
+_WRITERESPONSE.fields_by_name[
+    "write_results"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._WRITERESULT
+)
+_WRITERESPONSE.fields_by_name[
+    "commit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTENREQUEST_LABELSENTRY.containing_type = _LISTENREQUEST
+_LISTENREQUEST.fields_by_name["add_target"].message_type = _TARGET
+_LISTENREQUEST.fields_by_name["labels"].message_type = _LISTENREQUEST_LABELSENTRY
+_LISTENREQUEST.oneofs_by_name["target_change"].fields.append(
+    _LISTENREQUEST.fields_by_name["add_target"]
+)
+_LISTENREQUEST.fields_by_name[
+    "add_target"
+].containing_oneof = _LISTENREQUEST.oneofs_by_name["target_change"]
+_LISTENREQUEST.oneofs_by_name["target_change"].fields.append(
+    _LISTENREQUEST.fields_by_name["remove_target"]
+)
+_LISTENREQUEST.fields_by_name[
+    "remove_target"
+].containing_oneof = _LISTENREQUEST.oneofs_by_name["target_change"]
+_LISTENRESPONSE.fields_by_name["target_change"].message_type = _TARGETCHANGE
+_LISTENRESPONSE.fields_by_name[
+    "document_change"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._DOCUMENTCHANGE
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_delete"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._DOCUMENTDELETE
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_remove"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._DOCUMENTREMOVE
+)
+_LISTENRESPONSE.fields_by_name[
+    "filter"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_write__pb2._EXISTENCEFILTER
+)
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["target_change"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "target_change"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["document_change"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_change"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["document_delete"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_delete"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["document_remove"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_remove"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["filter"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "filter"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_TARGET_DOCUMENTSTARGET.containing_type = _TARGET
+_TARGET_QUERYTARGET.fields_by_name[
+    "structured_query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_TARGET_QUERYTARGET.containing_type = _TARGET
+_TARGET_QUERYTARGET.oneofs_by_name["query_type"].fields.append(
+    _TARGET_QUERYTARGET.fields_by_name["structured_query"]
+)
+_TARGET_QUERYTARGET.fields_by_name[
+    "structured_query"
+].containing_oneof = _TARGET_QUERYTARGET.oneofs_by_name["query_type"]
+_TARGET.fields_by_name["query"].message_type = _TARGET_QUERYTARGET
+_TARGET.fields_by_name["documents"].message_type = _TARGET_DOCUMENTSTARGET
+_TARGET.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TARGET.oneofs_by_name["target_type"].fields.append(_TARGET.fields_by_name["query"])
+_TARGET.fields_by_name["query"].containing_oneof = _TARGET.oneofs_by_name["target_type"]
+_TARGET.oneofs_by_name["target_type"].fields.append(_TARGET.fields_by_name["documents"])
+_TARGET.fields_by_name["documents"].containing_oneof = _TARGET.oneofs_by_name[
+    "target_type"
+]
+_TARGET.oneofs_by_name["resume_type"].fields.append(
+    _TARGET.fields_by_name["resume_token"]
+)
+_TARGET.fields_by_name["resume_token"].containing_oneof = _TARGET.oneofs_by_name[
+    "resume_type"
+]
+_TARGET.oneofs_by_name["resume_type"].fields.append(_TARGET.fields_by_name["read_time"])
+_TARGET.fields_by_name["read_time"].containing_oneof = _TARGET.oneofs_by_name[
+    "resume_type"
+]
+_TARGETCHANGE.fields_by_name[
+    "target_change_type"
+].enum_type = _TARGETCHANGE_TARGETCHANGETYPE
+_TARGETCHANGE.fields_by_name[
+    "cause"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_TARGETCHANGE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TARGETCHANGE_TARGETCHANGETYPE.containing_type = _TARGETCHANGE
+DESCRIPTOR.message_types_by_name["GetDocumentRequest"] = _GETDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["ListDocumentsRequest"] = _LISTDOCUMENTSREQUEST
+DESCRIPTOR.message_types_by_name["ListDocumentsResponse"] = _LISTDOCUMENTSRESPONSE
+DESCRIPTOR.message_types_by_name["CreateDocumentRequest"] = _CREATEDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateDocumentRequest"] = _UPDATEDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteDocumentRequest"] = _DELETEDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["BatchGetDocumentsRequest"] = _BATCHGETDOCUMENTSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchGetDocumentsResponse"
+] = _BATCHGETDOCUMENTSRESPONSE
+DESCRIPTOR.message_types_by_name["BeginTransactionRequest"] = _BEGINTRANSACTIONREQUEST
+DESCRIPTOR.message_types_by_name["BeginTransactionResponse"] = _BEGINTRANSACTIONRESPONSE
+DESCRIPTOR.message_types_by_name["CommitRequest"] = _COMMITREQUEST
+DESCRIPTOR.message_types_by_name["CommitResponse"] = _COMMITRESPONSE
+DESCRIPTOR.message_types_by_name["RollbackRequest"] = _ROLLBACKREQUEST
+DESCRIPTOR.message_types_by_name["RunQueryRequest"] = _RUNQUERYREQUEST
+DESCRIPTOR.message_types_by_name["RunQueryResponse"] = _RUNQUERYRESPONSE
+DESCRIPTOR.message_types_by_name["WriteRequest"] = _WRITEREQUEST
+DESCRIPTOR.message_types_by_name["WriteResponse"] = _WRITERESPONSE
+DESCRIPTOR.message_types_by_name["ListenRequest"] = _LISTENREQUEST
+DESCRIPTOR.message_types_by_name["ListenResponse"] = _LISTENRESPONSE
+DESCRIPTOR.message_types_by_name["Target"] = _TARGET
+DESCRIPTOR.message_types_by_name["TargetChange"] = _TARGETCHANGE
+DESCRIPTOR.message_types_by_name["ListCollectionIdsRequest"] = _LISTCOLLECTIONIDSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListCollectionIdsResponse"
+] = _LISTCOLLECTIONIDSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+GetDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.GetDocument][google.firestore.v1.Firestore.GetDocument].
+  
+  
+  Attributes:
+      name:
+          The resource name of the Document to get. In the format: ``pro
+          jects/{project_id}/databases/{database_id}/documents/{document
+          _path}``.
+      mask:
+          The fields to return. If not set, returns all fields.  If the
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads the document in a transaction.
+      read_time:
+          Reads the version of the document at the given time. This may
+          not be older than 60 seconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.GetDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDocumentRequest)
+
+ListDocumentsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDocumentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDOCUMENTSREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.ListDocuments][google.firestore.v1.Firestore.ListDocuments].
+  
+  
+  Attributes:
+      parent:
+          The parent resource name. In the format:
+          ``projects/{project_id}/databases/{database_id}/documents`` or
+          ``projects/{project_id}/databases/{database_id}/documents/{doc
+          ument_path}``. For example: ``projects/my-
+          project/databases/my-database/documents`` or ``projects/my-
+          project/databases/my-database/documents/chatrooms/my-
+          chatroom``
+      collection_id:
+          The collection ID, relative to ``parent``, to list. For
+          example: ``chatrooms`` or ``messages``.
+      page_size:
+          The maximum number of documents to return.
+      page_token:
+          The ``next_page_token`` value returned from a previous List
+          request, if any.
+      order_by:
+          The order to sort results by. For example: ``priority desc,
+          name``.
+      mask:
+          The fields to return. If not set, returns all fields.  If a
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads documents in a transaction.
+      read_time:
+          Reads documents as they were at the given time. This may not
+          be older than 60 seconds.
+      show_missing:
+          If the list should show missing documents. A missing document
+          is a document that does not exist but has sub-documents. These
+          documents will be returned with a key but will not have
+          fields, [Document.create\_time][google.firestore.v1.Document.c
+          reate\_time], or [Document.update\_time][google.firestore.v1.D
+          ocument.update\_time] set.  Requests with ``show_missing`` may
+          not specify ``where`` or ``order_by``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ListDocumentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDocumentsRequest)
+
+ListDocumentsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDocumentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDOCUMENTSRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.ListDocuments][google.firestore.v1.Firestore.ListDocuments].
+  
+  
+  Attributes:
+      documents:
+          The Documents found.
+      next_page_token:
+          The next page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ListDocumentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDocumentsResponse)
+
+CreateDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.CreateDocument][google.firestore.v1.Firestore.CreateDocument].
+  
+  
+  Attributes:
+      parent:
+          The parent resource. For example:
+          ``projects/{project_id}/databases/{database_id}/documents`` or
+          ``projects/{project_id}/databases/{database_id}/documents/chat
+          rooms/{chatroom_id}``
+      collection_id:
+          The collection ID, relative to ``parent``, to list. For
+          example: ``chatrooms``.
+      document_id:
+          The client-assigned document ID to use for this document.
+          Optional. If not specified, an ID will be assigned by the
+          service.
+      document:
+          The document to create. ``name`` must not be set.
+      mask:
+          The fields to return. If not set, returns all fields.  If the
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.CreateDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDocumentRequest)
+
+UpdateDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.UpdateDocument][google.firestore.v1.Firestore.UpdateDocument].
+  
+  
+  Attributes:
+      document:
+          The updated document. Creates the document if it does not
+          already exist.
+      update_mask:
+          The fields to update. None of the field paths in the mask may
+          contain a reserved name.  If the document exists on the server
+          and has fields not referenced in the mask, they are left
+          unchanged. Fields referenced in the mask, but not present in
+          the input document, are deleted from the document on the
+          server.
+      mask:
+          The fields to return. If not set, returns all fields.  If the
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      current_document:
+          An optional precondition on the document. The request will
+          fail if this is set and not met by the target document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.UpdateDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDocumentRequest)
+
+DeleteDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.DeleteDocument][google.firestore.v1.Firestore.DeleteDocument].
+  
+  
+  Attributes:
+      name:
+          The resource name of the Document to delete. In the format: ``
+          projects/{project_id}/databases/{database_id}/documents/{docum
+          ent_path}``.
+      current_document:
+          An optional precondition on the document. The request will
+          fail if this is set and not met by the target document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.DeleteDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDocumentRequest)
+
+BatchGetDocumentsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchGetDocumentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETDOCUMENTSREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.BatchGetDocuments][google.firestore.v1.Firestore.BatchGetDocuments].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      documents:
+          The names of the documents to retrieve. In the format: ``proje
+          cts/{project_id}/databases/{database_id}/documents/{document_p
+          ath}``. The request will fail if any of the document is not a
+          child resource of the given ``database``. Duplicate names will
+          be elided.
+      mask:
+          The fields to return. If not set, returns all fields.  If a
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads documents in a transaction.
+      new_transaction:
+          Starts a new transaction and reads the documents. Defaults to
+          a read-only transaction. The new transaction ID will be
+          returned as the first response in the stream.
+      read_time:
+          Reads documents as they were at the given time. This may not
+          be older than 60 seconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.BatchGetDocumentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetDocumentsRequest)
+
+BatchGetDocumentsResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchGetDocumentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETDOCUMENTSRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The streamed response for
+  [Firestore.BatchGetDocuments][google.firestore.v1.Firestore.BatchGetDocuments].
+  
+  
+  Attributes:
+      result:
+          A single result. This can be empty if the server is just
+          returning a transaction.
+      found:
+          A document that was requested.
+      missing:
+          A document name that was requested but does not exist. In the
+          format: ``projects/{project_id}/databases/{database_id}/docume
+          nts/{document_path}``.
+      transaction:
+          The transaction that was started as part of this request. Will
+          only be set in the first response, and only if [BatchGetDocume
+          ntsRequest.new\_transaction][google.firestore.v1.BatchGetDocum
+          entsRequest.new\_transaction] was set in the request.
+      read_time:
+          The time at which the document was read. This may be
+          monotically increasing, in this case the previous documents in
+          the result stream are guaranteed not to have changed between
+          their read\_time and this one.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.BatchGetDocumentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetDocumentsResponse)
+
+BeginTransactionRequest = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.BeginTransaction][google.firestore.v1.Firestore.BeginTransaction].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      options:
+          The options for the transaction. Defaults to a read-write
+          transaction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.BeginTransactionRequest)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionRequest)
+
+BeginTransactionResponse = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.BeginTransaction][google.firestore.v1.Firestore.BeginTransaction].
+  
+  
+  Attributes:
+      transaction:
+          The transaction that was started.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.BeginTransactionResponse)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionResponse)
+
+CommitRequest = _reflection.GeneratedProtocolMessageType(
+    "CommitRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.Commit][google.firestore.v1.Firestore.Commit].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      writes:
+          The writes to apply.  Always executed atomically and in order.
+      transaction:
+          If set, applies all writes in this transaction, and commits
+          it.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.CommitRequest)
+    ),
+)
+_sym_db.RegisterMessage(CommitRequest)
+
+CommitResponse = _reflection.GeneratedProtocolMessageType(
+    "CommitResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.Commit][google.firestore.v1.Firestore.Commit].
+  
+  
+  Attributes:
+      write_results:
+          The result of applying the writes.  This i-th write result
+          corresponds to the i-th write in the request.
+      commit_time:
+          The time at which the commit occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.CommitResponse)
+    ),
+)
+_sym_db.RegisterMessage(CommitResponse)
+
+RollbackRequest = _reflection.GeneratedProtocolMessageType(
+    "RollbackRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.Rollback][google.firestore.v1.Firestore.Rollback].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      transaction:
+          The transaction to roll back.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.RollbackRequest)
+    ),
+)
+_sym_db.RegisterMessage(RollbackRequest)
+
+RunQueryRequest = _reflection.GeneratedProtocolMessageType(
+    "RunQueryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNQUERYREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.RunQuery][google.firestore.v1.Firestore.RunQuery].
+  
+  
+  Attributes:
+      parent:
+          The parent resource name. In the format:
+          ``projects/{project_id}/databases/{database_id}/documents`` or
+          ``projects/{project_id}/databases/{database_id}/documents/{doc
+          ument_path}``. For example: ``projects/my-
+          project/databases/my-database/documents`` or ``projects/my-
+          project/databases/my-database/documents/chatrooms/my-
+          chatroom``
+      query_type:
+          The query to run.
+      structured_query:
+          A structured query.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads documents in a transaction.
+      new_transaction:
+          Starts a new transaction and reads the documents. Defaults to
+          a read-only transaction. The new transaction ID will be
+          returned as the first response in the stream.
+      read_time:
+          Reads documents as they were at the given time. This may not
+          be older than 60 seconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.RunQueryRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunQueryRequest)
+
+RunQueryResponse = _reflection.GeneratedProtocolMessageType(
+    "RunQueryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNQUERYRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.RunQuery][google.firestore.v1.Firestore.RunQuery].
+  
+  
+  Attributes:
+      transaction:
+          The transaction that was started as part of this request. Can
+          only be set in the first response, and only if [RunQueryReques
+          t.new\_transaction][google.firestore.v1.RunQueryRequest.new\_t
+          ransaction] was set in the request. If set, no other fields
+          will be set in this response.
+      document:
+          A query result. Not set when reporting partial progress.
+      read_time:
+          The time at which the document was read. This may be
+          monotonically increasing; in this case, the previous documents
+          in the result stream are guaranteed not to have changed
+          between their ``read_time`` and this one.  If the query
+          returns no results, a response with ``read_time`` and no
+          ``document`` will be sent, and this represents the time at
+          which the query was run.
+      skipped_results:
+          The number of results that have been skipped due to an offset
+          between the last response and the current response.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.RunQueryResponse)
+    ),
+)
+_sym_db.RegisterMessage(RunQueryResponse)
+
+WriteRequest = _reflection.GeneratedProtocolMessageType(
+    "WriteRequest",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WRITEREQUEST_LABELSENTRY,
+                __module__="google.cloud.firestore_v1.proto.firestore_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.WriteRequest.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_WRITEREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for [Firestore.Write][google.firestore.v1.Firestore.Write].
+  
+  The first request creates a stream, or resumes an existing one from a
+  token.
+  
+  When creating a new stream, the server replies with a response
+  containing only an ID and a token, to use in the next request.
+  
+  When resuming a stream, the server first streams any responses later
+  than the given token, then a response containing only an up-to-date
+  token, to use in the next request.
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``. This is
+          only required in the first message.
+      stream_id:
+          The ID of the write stream to resume. This may only be set in
+          the first message. When left empty, a new write stream will be
+          created.
+      writes:
+          The writes to apply.  Always executed atomically and in order.
+          This must be empty on the first request. This may be empty on
+          the last request. This must not be empty on all other
+          requests.
+      stream_token:
+          A stream token that was previously sent by the server.  The
+          client should set this field to the token from the most recent
+          [WriteResponse][google.firestore.v1.WriteResponse] it has
+          received. This acknowledges that the client has received
+          responses up to this token. After sending this token, earlier
+          tokens may not be used anymore.  The server may close the
+          stream if there are too many unacknowledged responses.  Leave
+          this field unset when creating a new stream. To resume a
+          stream at a specific point, set this field and the
+          ``stream_id`` field.  Leave this field unset when creating a
+          new stream.
+      labels:
+          Labels associated with this write request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.WriteRequest)
+    ),
+)
+_sym_db.RegisterMessage(WriteRequest)
+_sym_db.RegisterMessage(WriteRequest.LabelsEntry)
+
+WriteResponse = _reflection.GeneratedProtocolMessageType(
+    "WriteResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITERESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response for [Firestore.Write][google.firestore.v1.Firestore.Write].
+  
+  
+  Attributes:
+      stream_id:
+          The ID of the stream. Only set on the first message, when a
+          new stream was created.
+      stream_token:
+          A token that represents the position of this response in the
+          stream. This can be used by a client to resume the stream at
+          this point.  This field is always set.
+      write_results:
+          The result of applying the writes.  This i-th write result
+          corresponds to the i-th write in the request.
+      commit_time:
+          The time at which the commit occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.WriteResponse)
+    ),
+)
+_sym_db.RegisterMessage(WriteResponse)
+
+ListenRequest = _reflection.GeneratedProtocolMessageType(
+    "ListenRequest",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LISTENREQUEST_LABELSENTRY,
+                __module__="google.cloud.firestore_v1.proto.firestore_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.ListenRequest.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_LISTENREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""A request for [Firestore.Listen][google.firestore.v1.Firestore.Listen]
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      target_change:
+          The supported target changes.
+      add_target:
+          A target to add to this stream.
+      remove_target:
+          The ID of a target to remove from this stream.
+      labels:
+          Labels associated with this target change.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ListenRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListenRequest)
+_sym_db.RegisterMessage(ListenRequest.LabelsEntry)
+
+ListenResponse = _reflection.GeneratedProtocolMessageType(
+    "ListenResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTENRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.Listen][google.firestore.v1.Firestore.Listen].
+  
+  
+  Attributes:
+      response_type:
+          The supported responses.
+      target_change:
+          Targets have changed.
+      document_change:
+          A [Document][google.firestore.v1.Document] has changed.
+      document_delete:
+          A [Document][google.firestore.v1.Document] has been deleted.
+      document_remove:
+          A [Document][google.firestore.v1.Document] has been removed
+          from a target (because it is no longer relevant to that
+          target).
+      filter:
+          A filter to apply to the set of documents previously returned
+          for the given target.  Returned when documents may have been
+          removed from the given target, but the exact documents are
+          unknown.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ListenResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListenResponse)
+
+Target = _reflection.GeneratedProtocolMessageType(
+    "Target",
+    (_message.Message,),
+    dict(
+        DocumentsTarget=_reflection.GeneratedProtocolMessageType(
+            "DocumentsTarget",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TARGET_DOCUMENTSTARGET,
+                __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+                __doc__="""A target specified by a set of documents names.
+    
+    
+    Attributes:
+        documents:
+            The names of the documents to retrieve. In the format: ``proje
+            cts/{project_id}/databases/{database_id}/documents/{document_p
+            ath}``. The request will fail if any of the document is not a
+            child resource of the given ``database``. Duplicate names will
+            be elided.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.Target.DocumentsTarget)
+            ),
+        ),
+        QueryTarget=_reflection.GeneratedProtocolMessageType(
+            "QueryTarget",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TARGET_QUERYTARGET,
+                __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+                __doc__="""A target specified by a query.
+    
+    
+    Attributes:
+        parent:
+            The parent resource name. In the format:
+            ``projects/{project_id}/databases/{database_id}/documents`` or
+            ``projects/{project_id}/databases/{database_id}/documents/{doc
+            ument_path}``. For example: ``projects/my-
+            project/databases/my-database/documents`` or ``projects/my-
+            project/databases/my-database/documents/chatrooms/my-
+            chatroom``
+        query_type:
+            The query to run.
+        structured_query:
+            A structured query.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.Target.QueryTarget)
+            ),
+        ),
+        DESCRIPTOR=_TARGET,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""A specification of a set of documents to listen to.
+  
+  
+  Attributes:
+      target_type:
+          The type of target to listen to.
+      query:
+          A target specified by a query.
+      documents:
+          A target specified by a set of document names.
+      resume_type:
+          When to start listening.  If not specified, all matching
+          Documents are returned before any subsequent changes.
+      resume_token:
+          A resume token from a prior
+          [TargetChange][google.firestore.v1.TargetChange] for an
+          identical target.  Using a resume token with a different
+          target is unsupported and may fail.
+      read_time:
+          Start listening after a specific ``read_time``.  The client
+          must know the state of matching documents at this time.
+      target_id:
+          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.
+      once:
+          If the target should be removed once it is current and
+          consistent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.Target)
+    ),
+)
+_sym_db.RegisterMessage(Target)
+_sym_db.RegisterMessage(Target.DocumentsTarget)
+_sym_db.RegisterMessage(Target.QueryTarget)
+
+TargetChange = _reflection.GeneratedProtocolMessageType(
+    "TargetChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TARGETCHANGE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""Targets being watched have changed.
+  
+  
+  Attributes:
+      target_change_type:
+          The type of change that occurred.
+      target_ids:
+          The target IDs of targets that have changed.  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.
+      cause:
+          The error that resulted in this change, if applicable.
+      resume_token:
+          A token that can be used to resume the stream for the given
+          ``target_ids``, or all targets if ``target_ids`` is empty.
+          Not set on every target change.
+      read_time:
+          The consistent ``read_time`` for the given ``target_ids``
+          (omitted when the target\_ids are not at a consistent
+          snapshot).  The stream is guaranteed to send a ``read_time``
+          with ``target_ids`` empty whenever the entire stream reaches a
+          new consistent snapshot. ADD, CURRENT, and RESET messages are
+          guaranteed to (eventually) result in a new consistent snapshot
+          (while NO\_CHANGE and REMOVE messages are not).  For a given
+          stream, ``read_time`` is guaranteed to be monotonically
+          increasing.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.TargetChange)
+    ),
+)
+_sym_db.RegisterMessage(TargetChange)
+
+ListCollectionIdsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCollectionIdsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOLLECTIONIDSREQUEST,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.ListCollectionIds][google.firestore.v1.Firestore.ListCollectionIds].
+  
+  
+  Attributes:
+      parent:
+          The parent document. In the format: ``projects/{project_id}/da
+          tabases/{database_id}/documents/{document_path}``. For
+          example: ``projects/my-project/databases/my-
+          database/documents/chatrooms/my-chatroom``
+      page_size:
+          The maximum number of results to return.
+      page_token:
+          A page token. Must be a value from [ListCollectionIdsResponse]
+          [google.firestore.v1.ListCollectionIdsResponse].
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ListCollectionIdsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCollectionIdsRequest)
+
+ListCollectionIdsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCollectionIdsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOLLECTIONIDSRESPONSE,
+        __module__="google.cloud.firestore_v1.proto.firestore_pb2",
+        __doc__="""The response from
+  [Firestore.ListCollectionIds][google.firestore.v1.Firestore.ListCollectionIds].
+  
+  
+  Attributes:
+      collection_ids:
+          The collection ids.
+      next_page_token:
+          A page token that may be used to continue the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ListCollectionIdsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCollectionIdsResponse)
+
+
+DESCRIPTOR._options = None
+_WRITEREQUEST_LABELSENTRY._options = None
+_LISTENREQUEST_LABELSENTRY._options = None
+
+_FIRESTORE = _descriptor.ServiceDescriptor(
+    name="Firestore",
+    full_name="google.firestore.v1.Firestore",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4661,
+    serialized_end=6969,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GetDocument",
+            full_name="google.firestore.v1.Firestore.GetDocument",
+            index=0,
+            containing_service=None,
+            input_type=_GETDOCUMENTREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT,
+            serialized_options=_b(
+                "\202\323\344\223\0022\0220/v1/{name=projects/*/databases/*/documents/*/**}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDocuments",
+            full_name="google.firestore.v1.Firestore.ListDocuments",
+            index=1,
+            containing_service=None,
+            input_type=_LISTDOCUMENTSREQUEST,
+            output_type=_LISTDOCUMENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002D\022B/v1/{parent=projects/*/databases/*/documents/*/**}/{collection_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDocument",
+            full_name="google.firestore.v1.Firestore.CreateDocument",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEDOCUMENTREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002L"@/v1/{parent=projects/*/databases/*/documents/**}/{collection_id}:\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDocument",
+            full_name="google.firestore.v1.Firestore.UpdateDocument",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEDOCUMENTREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT,
+            serialized_options=_b(
+                "\202\323\344\223\002E29/v1/{document.name=projects/*/databases/*/documents/*/**}:\010document"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDocument",
+            full_name="google.firestore.v1.Firestore.DeleteDocument",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEDOCUMENTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0022*0/v1/{name=projects/*/databases/*/documents/*/**}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchGetDocuments",
+            full_name="google.firestore.v1.Firestore.BatchGetDocuments",
+            index=5,
+            containing_service=None,
+            input_type=_BATCHGETDOCUMENTSREQUEST,
+            output_type=_BATCHGETDOCUMENTSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v1/{database=projects/*/databases/*}/documents:batchGet:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BeginTransaction",
+            full_name="google.firestore.v1.Firestore.BeginTransaction",
+            index=6,
+            containing_service=None,
+            input_type=_BEGINTRANSACTIONREQUEST,
+            output_type=_BEGINTRANSACTIONRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v1/{database=projects/*/databases/*}/documents:beginTransaction:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Commit",
+            full_name="google.firestore.v1.Firestore.Commit",
+            index=7,
+            containing_service=None,
+            input_type=_COMMITREQUEST,
+            output_type=_COMMITRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1/{database=projects/*/databases/*}/documents:commit:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Rollback",
+            full_name="google.firestore.v1.Firestore.Rollback",
+            index=8,
+            containing_service=None,
+            input_type=_ROLLBACKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v1/{database=projects/*/databases/*}/documents:rollback:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunQuery",
+            full_name="google.firestore.v1.Firestore.RunQuery",
+            index=9,
+            containing_service=None,
+            input_type=_RUNQUERYREQUEST,
+            output_type=_RUNQUERYRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002}"6/v1/{parent=projects/*/databases/*/documents}:runQuery:\001*Z@";/v1/{parent=projects/*/databases/*/documents/*/**}:runQuery:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Write",
+            full_name="google.firestore.v1.Firestore.Write",
+            index=10,
+            containing_service=None,
+            input_type=_WRITEREQUEST,
+            output_type=_WRITERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v1/{database=projects/*/databases/*}/documents:write:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Listen",
+            full_name="google.firestore.v1.Firestore.Listen",
+            index=11,
+            containing_service=None,
+            input_type=_LISTENREQUEST,
+            output_type=_LISTENRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1/{database=projects/*/databases/*}/documents:listen:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCollectionIds",
+            full_name="google.firestore.v1.Firestore.ListCollectionIds",
+            index=12,
+            containing_service=None,
+            input_type=_LISTCOLLECTIONIDSREQUEST,
+            output_type=_LISTCOLLECTIONIDSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\217\001"?/v1/{parent=projects/*/databases/*/documents}:listCollectionIds:\001*ZI"D/v1/{parent=projects/*/databases/*/documents/*/**}:listCollectionIds:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_FIRESTORE)
+
+DESCRIPTOR.services_by_name["Firestore"] = _FIRESTORE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/firestore_pb2_grpc.py b/firestore/google/cloud/firestore_v1/proto/firestore_pb2_grpc.py
new file mode 100644
index 000000000000..7b568318cc58
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/firestore_pb2_grpc.py
@@ -0,0 +1,290 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.firestore_v1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    firestore_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class FirestoreStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GetDocument = channel.unary_unary(
+            "/google.firestore.v1.Firestore/GetDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.GetDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.Document.FromString,
+        )
+        self.ListDocuments = channel.unary_unary(
+            "/google.firestore.v1.Firestore/ListDocuments",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListDocumentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListDocumentsResponse.FromString,
+        )
+        self.CreateDocument = channel.unary_unary(
+            "/google.firestore.v1.Firestore/CreateDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.CreateDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.Document.FromString,
+        )
+        self.UpdateDocument = channel.unary_unary(
+            "/google.firestore.v1.Firestore/UpdateDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.UpdateDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.Document.FromString,
+        )
+        self.DeleteDocument = channel.unary_unary(
+            "/google.firestore.v1.Firestore/DeleteDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.DeleteDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.BatchGetDocuments = channel.unary_stream(
+            "/google.firestore.v1.Firestore/BatchGetDocuments",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BatchGetDocumentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BatchGetDocumentsResponse.FromString,
+        )
+        self.BeginTransaction = channel.unary_unary(
+            "/google.firestore.v1.Firestore/BeginTransaction",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BeginTransactionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BeginTransactionResponse.FromString,
+        )
+        self.Commit = channel.unary_unary(
+            "/google.firestore.v1.Firestore/Commit",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.CommitRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.CommitResponse.FromString,
+        )
+        self.Rollback = channel.unary_unary(
+            "/google.firestore.v1.Firestore/Rollback",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.RollbackRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RunQuery = channel.unary_stream(
+            "/google.firestore.v1.Firestore/RunQuery",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.RunQueryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.RunQueryResponse.FromString,
+        )
+        self.Write = channel.stream_stream(
+            "/google.firestore.v1.Firestore/Write",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.WriteRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.WriteResponse.FromString,
+        )
+        self.Listen = channel.stream_stream(
+            "/google.firestore.v1.Firestore/Listen",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListenRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListenResponse.FromString,
+        )
+        self.ListCollectionIds = channel.unary_unary(
+            "/google.firestore.v1.Firestore/ListCollectionIds",
+            request_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListCollectionIdsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListCollectionIdsResponse.FromString,
+        )
+
+
+class FirestoreServicer(object):
+    """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.
+  """
+
+    def GetDocument(self, request, context):
+        """Gets a single document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDocuments(self, request, context):
+        """Lists documents.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDocument(self, request, context):
+        """Creates a new document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDocument(self, request, context):
+        """Updates or inserts a document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDocument(self, request, context):
+        """Deletes a document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchGetDocuments(self, request, context):
+        """Gets multiple documents.
+
+    Documents returned by this method are not guaranteed to be returned in the
+    same order that they were requested.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BeginTransaction(self, request, context):
+        """Starts a new transaction.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Commit(self, request, context):
+        """Commits a transaction, while optionally updating documents.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Rollback(self, request, context):
+        """Rolls back a transaction.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunQuery(self, request, context):
+        """Runs a query.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Write(self, request_iterator, context):
+        """Streams batches of document updates and deletes, in order.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Listen(self, request_iterator, context):
+        """Listens to changes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCollectionIds(self, request, context):
+        """Lists all the collection IDs underneath a document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_FirestoreServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GetDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.GetDocumentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.Document.SerializeToString,
+        ),
+        "ListDocuments": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDocuments,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListDocumentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListDocumentsResponse.SerializeToString,
+        ),
+        "CreateDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.CreateDocumentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.Document.SerializeToString,
+        ),
+        "UpdateDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.UpdateDocumentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.Document.SerializeToString,
+        ),
+        "DeleteDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.DeleteDocumentRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "BatchGetDocuments": grpc.unary_stream_rpc_method_handler(
+            servicer.BatchGetDocuments,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BatchGetDocumentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BatchGetDocumentsResponse.SerializeToString,
+        ),
+        "BeginTransaction": grpc.unary_unary_rpc_method_handler(
+            servicer.BeginTransaction,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BeginTransactionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.BeginTransactionResponse.SerializeToString,
+        ),
+        "Commit": grpc.unary_unary_rpc_method_handler(
+            servicer.Commit,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.CommitRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.CommitResponse.SerializeToString,
+        ),
+        "Rollback": grpc.unary_unary_rpc_method_handler(
+            servicer.Rollback,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.RollbackRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RunQuery": grpc.unary_stream_rpc_method_handler(
+            servicer.RunQuery,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.RunQueryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.RunQueryResponse.SerializeToString,
+        ),
+        "Write": grpc.stream_stream_rpc_method_handler(
+            servicer.Write,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.WriteRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.WriteResponse.SerializeToString,
+        ),
+        "Listen": grpc.stream_stream_rpc_method_handler(
+            servicer.Listen,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListenRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListenResponse.SerializeToString,
+        ),
+        "ListCollectionIds": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCollectionIds,
+            request_deserializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListCollectionIdsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.ListCollectionIdsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.firestore.v1.Firestore", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/firestore/google/cloud/firestore_v1/proto/query.proto b/firestore/google/cloud/firestore_v1/proto/query.proto
new file mode 100644
index 000000000000..48684c06079d
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/query.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.firestore.v1;
+
+import "google/firestore/v1/document.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "QueryProto";
+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`.
+  message CollectionSelector {
+    // The collection ID.
+    // When set, selects only collections with this ID.
+    string collection_id = 2;
+
+    // When false, selects only collections that are immediate children of
+    // the `parent` specified in the containing `RunQueryRequest`.
+    // When true, selects all descendant collections.
+    bool all_descendants = 3;
+  }
+
+  // A filter.
+  message Filter {
+    // The type of filter.
+    oneof filter_type {
+      // A composite filter.
+      CompositeFilter composite_filter = 1;
+
+      // A filter on a document field.
+      FieldFilter field_filter = 2;
+
+      // A filter that takes exactly one argument.
+      UnaryFilter unary_filter = 3;
+    }
+  }
+
+  // A filter that merges multiple other filters using the given operator.
+  message CompositeFilter {
+    // A composite filter operator.
+    enum Operator {
+      // Unspecified. This value must not be used.
+      OPERATOR_UNSPECIFIED = 0;
+
+      // The results are required to satisfy each of the combined filters.
+      AND = 1;
+    }
+
+    // The operator for combining multiple filters.
+    Operator op = 1;
+
+    // The list of filters to combine.
+    // Must contain at least one filter.
+    repeated Filter filters = 2;
+  }
+
+  // A filter on a specific field.
+  message FieldFilter {
+    // A field filter operator.
+    enum Operator {
+      // Unspecified. This value must not be used.
+      OPERATOR_UNSPECIFIED = 0;
+
+      // Less than. Requires that the field come first in `order_by`.
+      LESS_THAN = 1;
+
+      // Less than or equal. Requires that the field come first in `order_by`.
+      LESS_THAN_OR_EQUAL = 2;
+
+      // Greater than. Requires that the field come first in `order_by`.
+      GREATER_THAN = 3;
+
+      // Greater than or equal. Requires that the field come first in
+      // `order_by`.
+      GREATER_THAN_OR_EQUAL = 4;
+
+      // Equal.
+      EQUAL = 5;
+
+      // Contains. Requires that the field is an array.
+      ARRAY_CONTAINS = 7;
+    }
+
+    // The field to filter by.
+    FieldReference field = 1;
+
+    // The operator to filter by.
+    Operator op = 2;
+
+    // The value to compare to.
+    Value value = 3;
+  }
+
+  // A filter with a single operand.
+  message UnaryFilter {
+    // A unary operator.
+    enum Operator {
+      // Unspecified. This value must not be used.
+      OPERATOR_UNSPECIFIED = 0;
+
+      // Test if a field is equal to NaN.
+      IS_NAN = 2;
+
+      // Test if an exprestion evaluates to Null.
+      IS_NULL = 3;
+    }
+
+    // The unary operator to apply.
+    Operator op = 1;
+
+    // The argument to the filter.
+    oneof operand_type {
+      // The field to which to apply the operator.
+      FieldReference field = 2;
+    }
+  }
+
+  // A reference to a field, such as `max(messages.time) as max_time`.
+  message FieldReference {
+    string field_path = 2;
+  }
+
+  // An order on a field.
+  message Order {
+    // The field to order by.
+    FieldReference field = 1;
+
+    // The direction to order by. Defaults to `ASCENDING`.
+    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.
+    DIRECTION_UNSPECIFIED = 0;
+
+    // Ascending.
+    ASCENDING = 1;
+
+    // Descending.
+    DESCENDING = 2;
+  }
+
+  // The projection to return.
+  Projection select = 1;
+
+  // The collections to query.
+  repeated CollectionSelector from = 2;
+
+  // The filter to apply.
+  Filter where = 3;
+
+  // The order to apply to the query results.
+  //
+  // Firestore guarantees a stable ordering through the following rules:
+  //
+  //  * Any field required to appear in `order_by`, that is not already
+  //    specified in `order_by`, is appended to the order in field name order
+  //    by default.
+  //  * If an order on `__name__` is not specified, it is appended by default.
+  //
+  // Fields are appended with the same sort direction as the last order
+  // specified, or 'ASCENDING' if no order was specified. For example:
+  //
+  //  * `SELECT * FROM Foo ORDER BY A` becomes
+  //    `SELECT * FROM Foo ORDER BY A, __name__`
+  //  * `SELECT * FROM Foo ORDER BY A DESC` becomes
+  //    `SELECT * FROM Foo ORDER BY A DESC, __name__ DESC`
+  //  * `SELECT * FROM Foo WHERE A > 1` becomes
+  //    `SELECT * FROM Foo WHERE A > 1 ORDER BY A, __name__`
+  repeated Order order_by = 4;
+
+  // A starting point for the query results.
+  Cursor start_at = 7;
+
+  // A end point for the query results.
+  Cursor end_at = 8;
+
+  // The number of results to skip.
+  //
+  // Applies before limit, but after all other constraints. Must be >= 0 if
+  // specified.
+  int32 offset = 6;
+
+  // The maximum number of results to return.
+  //
+  // Applies after all other constraints.
+  // Must be >= 0 if specified.
+  google.protobuf.Int32Value limit = 5;
+}
+
+// A position in a query result set.
+message Cursor {
+  // The values that represent a position, in the order they appear in
+  // the order by clause of a query.
+  //
+  // Can contain fewer values than specified in the order by clause.
+  repeated Value values = 1;
+
+  // If the position is just before or just after the given values, relative
+  // to the sort order defined by the query.
+  bool before = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1/proto/query_pb2.py b/firestore/google/cloud/firestore_v1/proto/query_pb2.py
new file mode 100644
index 000000000000..394c4753663b
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/query_pb2.py
@@ -0,0 +1,1187 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1/proto/query.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2,
+)
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1/proto/query.proto",
+    package="google.firestore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.firestore.v1B\nQueryProtoP\001Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\242\002\004GCFS\252\002\031Google.Cloud.Firestore.V1\312\002\031Google\\Cloud\\Firestore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/firestore_v1/proto/query.proto\x12\x13google.firestore.v1\x1a.google/cloud/firestore_v1/proto/document.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x1cgoogle/api/annotations.proto"\xda\x0e\n\x0fStructuredQuery\x12?\n\x06select\x18\x01 \x01(\x0b\x32/.google.firestore.v1.StructuredQuery.Projection\x12\x45\n\x04\x66rom\x18\x02 \x03(\x0b\x32\x37.google.firestore.v1.StructuredQuery.CollectionSelector\x12:\n\x05where\x18\x03 \x01(\x0b\x32+.google.firestore.v1.StructuredQuery.Filter\x12<\n\x08order_by\x18\x04 \x03(\x0b\x32*.google.firestore.v1.StructuredQuery.Order\x12-\n\x08start_at\x18\x07 \x01(\x0b\x32\x1b.google.firestore.v1.Cursor\x12+\n\x06\x65nd_at\x18\x08 \x01(\x0b\x32\x1b.google.firestore.v1.Cursor\x12\x0e\n\x06offset\x18\x06 \x01(\x05\x12*\n\x05limit\x18\x05 \x01(\x0b\x32\x1b.google.protobuf.Int32Value\x1a\x44\n\x12\x43ollectionSelector\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12\x17\n\x0f\x61ll_descendants\x18\x03 \x01(\x08\x1a\xfd\x01\n\x06\x46ilter\x12P\n\x10\x63omposite_filter\x18\x01 \x01(\x0b\x32\x34.google.firestore.v1.StructuredQuery.CompositeFilterH\x00\x12H\n\x0c\x66ield_filter\x18\x02 \x01(\x0b\x32\x30.google.firestore.v1.StructuredQuery.FieldFilterH\x00\x12H\n\x0cunary_filter\x18\x03 \x01(\x0b\x32\x30.google.firestore.v1.StructuredQuery.UnaryFilterH\x00\x42\r\n\x0b\x66ilter_type\x1a\xc9\x01\n\x0f\x43ompositeFilter\x12I\n\x02op\x18\x01 \x01(\x0e\x32=.google.firestore.v1.StructuredQuery.CompositeFilter.Operator\x12<\n\x07\x66ilters\x18\x02 \x03(\x0b\x32+.google.firestore.v1.StructuredQuery.Filter"-\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x1a\xdd\x02\n\x0b\x46ieldFilter\x12\x42\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x33.google.firestore.v1.StructuredQuery.FieldReference\x12\x45\n\x02op\x18\x02 \x01(\x0e\x32\x39.google.firestore.v1.StructuredQuery.FieldFilter.Operator\x12)\n\x05value\x18\x03 \x01(\x0b\x32\x1a.google.firestore.v1.Value"\x97\x01\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\r\n\tLESS_THAN\x10\x01\x12\x16\n\x12LESS_THAN_OR_EQUAL\x10\x02\x12\x10\n\x0cGREATER_THAN\x10\x03\x12\x19\n\x15GREATER_THAN_OR_EQUAL\x10\x04\x12\t\n\x05\x45QUAL\x10\x05\x12\x12\n\x0e\x41RRAY_CONTAINS\x10\x07\x1a\xe9\x01\n\x0bUnaryFilter\x12\x45\n\x02op\x18\x01 \x01(\x0e\x32\x39.google.firestore.v1.StructuredQuery.UnaryFilter.Operator\x12\x44\n\x05\x66ield\x18\x02 \x01(\x0b\x32\x33.google.firestore.v1.StructuredQuery.FieldReferenceH\x00"=\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\n\n\x06IS_NAN\x10\x02\x12\x0b\n\x07IS_NULL\x10\x03\x42\x0e\n\x0coperand_type\x1a$\n\x0e\x46ieldReference\x12\x12\n\nfield_path\x18\x02 \x01(\t\x1a\x8e\x01\n\x05Order\x12\x42\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x33.google.firestore.v1.StructuredQuery.FieldReference\x12\x41\n\tdirection\x18\x02 \x01(\x0e\x32..google.firestore.v1.StructuredQuery.Direction\x1aQ\n\nProjection\x12\x43\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x33.google.firestore.v1.StructuredQuery.FieldReference"E\n\tDirection\x12\x19\n\x15\x44IRECTION_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x01\x12\x0e\n\nDESCENDING\x10\x02"D\n\x06\x43ursor\x12*\n\x06values\x18\x01 \x03(\x0b\x32\x1a.google.firestore.v1.Value\x12\x0e\n\x06\x62\x65\x66ore\x18\x02 \x01(\x08\x42\xa4\x01\n\x17\x63om.google.firestore.v1B\nQueryProtoP\x01Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\xa2\x02\x04GCFS\xaa\x02\x19Google.Cloud.Firestore.V1\xca\x02\x19Google\\Cloud\\Firestore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.firestore.v1.StructuredQuery.CompositeFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AND", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1091,
+    serialized_end=1136,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR)
+
+_STRUCTUREDQUERY_FIELDFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.firestore.v1.StructuredQuery.FieldFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN_OR_EQUAL",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN_OR_EQUAL",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EQUAL", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ARRAY_CONTAINS", index=6, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1337,
+    serialized_end=1488,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_FIELDFILTER_OPERATOR)
+
+_STRUCTUREDQUERY_UNARYFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.firestore.v1.StructuredQuery.UnaryFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IS_NAN", index=1, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IS_NULL", index=2, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1647,
+    serialized_end=1708,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_UNARYFILTER_OPERATOR)
+
+_STRUCTUREDQUERY_DIRECTION = _descriptor.EnumDescriptor(
+    name="Direction",
+    full_name="google.firestore.v1.StructuredQuery.Direction",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DIRECTION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASCENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESCENDING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1992,
+    serialized_end=2061,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_DIRECTION)
+
+
+_STRUCTUREDQUERY_COLLECTIONSELECTOR = _descriptor.Descriptor(
+    name="CollectionSelector",
+    full_name="google.firestore.v1.StructuredQuery.CollectionSelector",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.v1.StructuredQuery.CollectionSelector.collection_id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="all_descendants",
+            full_name="google.firestore.v1.StructuredQuery.CollectionSelector.all_descendants",
+            index=1,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=608,
+    serialized_end=676,
+)
+
+_STRUCTUREDQUERY_FILTER = _descriptor.Descriptor(
+    name="Filter",
+    full_name="google.firestore.v1.StructuredQuery.Filter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="composite_filter",
+            full_name="google.firestore.v1.StructuredQuery.Filter.composite_filter",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_filter",
+            full_name="google.firestore.v1.StructuredQuery.Filter.field_filter",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unary_filter",
+            full_name="google.firestore.v1.StructuredQuery.Filter.unary_filter",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="filter_type",
+            full_name="google.firestore.v1.StructuredQuery.Filter.filter_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=679,
+    serialized_end=932,
+)
+
+_STRUCTUREDQUERY_COMPOSITEFILTER = _descriptor.Descriptor(
+    name="CompositeFilter",
+    full_name="google.firestore.v1.StructuredQuery.CompositeFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.firestore.v1.StructuredQuery.CompositeFilter.op",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filters",
+            full_name="google.firestore.v1.StructuredQuery.CompositeFilter.filters",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=935,
+    serialized_end=1136,
+)
+
+_STRUCTUREDQUERY_FIELDFILTER = _descriptor.Descriptor(
+    name="FieldFilter",
+    full_name="google.firestore.v1.StructuredQuery.FieldFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.v1.StructuredQuery.FieldFilter.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.firestore.v1.StructuredQuery.FieldFilter.op",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1.StructuredQuery.FieldFilter.value",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STRUCTUREDQUERY_FIELDFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1139,
+    serialized_end=1488,
+)
+
+_STRUCTUREDQUERY_UNARYFILTER = _descriptor.Descriptor(
+    name="UnaryFilter",
+    full_name="google.firestore.v1.StructuredQuery.UnaryFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.firestore.v1.StructuredQuery.UnaryFilter.op",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.v1.StructuredQuery.UnaryFilter.field",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STRUCTUREDQUERY_UNARYFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="operand_type",
+            full_name="google.firestore.v1.StructuredQuery.UnaryFilter.operand_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1491,
+    serialized_end=1724,
+)
+
+_STRUCTUREDQUERY_FIELDREFERENCE = _descriptor.Descriptor(
+    name="FieldReference",
+    full_name="google.firestore.v1.StructuredQuery.FieldReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_path",
+            full_name="google.firestore.v1.StructuredQuery.FieldReference.field_path",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1726,
+    serialized_end=1762,
+)
+
+_STRUCTUREDQUERY_ORDER = _descriptor.Descriptor(
+    name="Order",
+    full_name="google.firestore.v1.StructuredQuery.Order",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.v1.StructuredQuery.Order.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="direction",
+            full_name="google.firestore.v1.StructuredQuery.Order.direction",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1765,
+    serialized_end=1907,
+)
+
+_STRUCTUREDQUERY_PROJECTION = _descriptor.Descriptor(
+    name="Projection",
+    full_name="google.firestore.v1.StructuredQuery.Projection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.v1.StructuredQuery.Projection.fields",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1909,
+    serialized_end=1990,
+)
+
+_STRUCTUREDQUERY = _descriptor.Descriptor(
+    name="StructuredQuery",
+    full_name="google.firestore.v1.StructuredQuery",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="select",
+            full_name="google.firestore.v1.StructuredQuery.select",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="from",
+            full_name="google.firestore.v1.StructuredQuery.from",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="where",
+            full_name="google.firestore.v1.StructuredQuery.where",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.firestore.v1.StructuredQuery.order_by",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_at",
+            full_name="google.firestore.v1.StructuredQuery.start_at",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_at",
+            full_name="google.firestore.v1.StructuredQuery.end_at",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.firestore.v1.StructuredQuery.offset",
+            index=6,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="google.firestore.v1.StructuredQuery.limit",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _STRUCTUREDQUERY_COLLECTIONSELECTOR,
+        _STRUCTUREDQUERY_FILTER,
+        _STRUCTUREDQUERY_COMPOSITEFILTER,
+        _STRUCTUREDQUERY_FIELDFILTER,
+        _STRUCTUREDQUERY_UNARYFILTER,
+        _STRUCTUREDQUERY_FIELDREFERENCE,
+        _STRUCTUREDQUERY_ORDER,
+        _STRUCTUREDQUERY_PROJECTION,
+    ],
+    enum_types=[_STRUCTUREDQUERY_DIRECTION],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=179,
+    serialized_end=2061,
+)
+
+
+_CURSOR = _descriptor.Descriptor(
+    name="Cursor",
+    full_name="google.firestore.v1.Cursor",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.firestore.v1.Cursor.values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="before",
+            full_name="google.firestore.v1.Cursor.before",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2063,
+    serialized_end=2131,
+)
+
+_STRUCTUREDQUERY_COLLECTIONSELECTOR.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "composite_filter"
+].message_type = _STRUCTUREDQUERY_COMPOSITEFILTER
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "field_filter"
+].message_type = _STRUCTUREDQUERY_FIELDFILTER
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "unary_filter"
+].message_type = _STRUCTUREDQUERY_UNARYFILTER
+_STRUCTUREDQUERY_FILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _STRUCTUREDQUERY_FILTER.fields_by_name["composite_filter"]
+)
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "composite_filter"
+].containing_oneof = _STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"]
+_STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _STRUCTUREDQUERY_FILTER.fields_by_name["field_filter"]
+)
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "field_filter"
+].containing_oneof = _STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"]
+_STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _STRUCTUREDQUERY_FILTER.fields_by_name["unary_filter"]
+)
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "unary_filter"
+].containing_oneof = _STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"]
+_STRUCTUREDQUERY_COMPOSITEFILTER.fields_by_name[
+    "op"
+].enum_type = _STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR
+_STRUCTUREDQUERY_COMPOSITEFILTER.fields_by_name[
+    "filters"
+].message_type = _STRUCTUREDQUERY_FILTER
+_STRUCTUREDQUERY_COMPOSITEFILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR.containing_type = (
+    _STRUCTUREDQUERY_COMPOSITEFILTER
+)
+_STRUCTUREDQUERY_FIELDFILTER.fields_by_name[
+    "field"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_FIELDFILTER.fields_by_name[
+    "op"
+].enum_type = _STRUCTUREDQUERY_FIELDFILTER_OPERATOR
+_STRUCTUREDQUERY_FIELDFILTER.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._VALUE
+_STRUCTUREDQUERY_FIELDFILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FIELDFILTER_OPERATOR.containing_type = _STRUCTUREDQUERY_FIELDFILTER
+_STRUCTUREDQUERY_UNARYFILTER.fields_by_name[
+    "op"
+].enum_type = _STRUCTUREDQUERY_UNARYFILTER_OPERATOR
+_STRUCTUREDQUERY_UNARYFILTER.fields_by_name[
+    "field"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_UNARYFILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_UNARYFILTER_OPERATOR.containing_type = _STRUCTUREDQUERY_UNARYFILTER
+_STRUCTUREDQUERY_UNARYFILTER.oneofs_by_name["operand_type"].fields.append(
+    _STRUCTUREDQUERY_UNARYFILTER.fields_by_name["field"]
+)
+_STRUCTUREDQUERY_UNARYFILTER.fields_by_name[
+    "field"
+].containing_oneof = _STRUCTUREDQUERY_UNARYFILTER.oneofs_by_name["operand_type"]
+_STRUCTUREDQUERY_FIELDREFERENCE.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_ORDER.fields_by_name[
+    "field"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_ORDER.fields_by_name[
+    "direction"
+].enum_type = _STRUCTUREDQUERY_DIRECTION
+_STRUCTUREDQUERY_ORDER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_PROJECTION.fields_by_name[
+    "fields"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_PROJECTION.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY.fields_by_name["select"].message_type = _STRUCTUREDQUERY_PROJECTION
+_STRUCTUREDQUERY.fields_by_name[
+    "from"
+].message_type = _STRUCTUREDQUERY_COLLECTIONSELECTOR
+_STRUCTUREDQUERY.fields_by_name["where"].message_type = _STRUCTUREDQUERY_FILTER
+_STRUCTUREDQUERY.fields_by_name["order_by"].message_type = _STRUCTUREDQUERY_ORDER
+_STRUCTUREDQUERY.fields_by_name["start_at"].message_type = _CURSOR
+_STRUCTUREDQUERY.fields_by_name["end_at"].message_type = _CURSOR
+_STRUCTUREDQUERY.fields_by_name[
+    "limit"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_STRUCTUREDQUERY_DIRECTION.containing_type = _STRUCTUREDQUERY
+_CURSOR.fields_by_name[
+    "values"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._VALUE
+DESCRIPTOR.message_types_by_name["StructuredQuery"] = _STRUCTUREDQUERY
+DESCRIPTOR.message_types_by_name["Cursor"] = _CURSOR
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+StructuredQuery = _reflection.GeneratedProtocolMessageType(
+    "StructuredQuery",
+    (_message.Message,),
+    dict(
+        CollectionSelector=_reflection.GeneratedProtocolMessageType(
+            "CollectionSelector",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_COLLECTIONSELECTOR,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""A selection of a collection, such as ``messages as m1``.
+    
+    
+    Attributes:
+        collection_id:
+            The collection ID. When set, selects only collections with
+            this ID.
+        all_descendants:
+            When false, selects only collections that are immediate
+            children of the ``parent`` specified in the containing
+            ``RunQueryRequest``. When true, selects all descendant
+            collections.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.CollectionSelector)
+            ),
+        ),
+        Filter=_reflection.GeneratedProtocolMessageType(
+            "Filter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_FILTER,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""A filter.
+    
+    
+    Attributes:
+        filter_type:
+            The type of filter.
+        composite_filter:
+            A composite filter.
+        field_filter:
+            A filter on a document field.
+        unary_filter:
+            A filter that takes exactly one argument.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.Filter)
+            ),
+        ),
+        CompositeFilter=_reflection.GeneratedProtocolMessageType(
+            "CompositeFilter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_COMPOSITEFILTER,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""A filter that merges multiple other filters using the given operator.
+    
+    
+    Attributes:
+        op:
+            The operator for combining multiple filters.
+        filters:
+            The list of filters to combine. Must contain at least one
+            filter.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.CompositeFilter)
+            ),
+        ),
+        FieldFilter=_reflection.GeneratedProtocolMessageType(
+            "FieldFilter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_FIELDFILTER,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""A filter on a specific field.
+    
+    
+    Attributes:
+        field:
+            The field to filter by.
+        op:
+            The operator to filter by.
+        value:
+            The value to compare to.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.FieldFilter)
+            ),
+        ),
+        UnaryFilter=_reflection.GeneratedProtocolMessageType(
+            "UnaryFilter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_UNARYFILTER,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""A filter with a single operand.
+    
+    
+    Attributes:
+        op:
+            The unary operator to apply.
+        operand_type:
+            The argument to the filter.
+        field:
+            The field to which to apply the operator.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.UnaryFilter)
+            ),
+        ),
+        FieldReference=_reflection.GeneratedProtocolMessageType(
+            "FieldReference",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_FIELDREFERENCE,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""A reference to a field, such as ``max(messages.time) as max_time``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.FieldReference)
+            ),
+        ),
+        Order=_reflection.GeneratedProtocolMessageType(
+            "Order",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_ORDER,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""An order on a field.
+    
+    
+    Attributes:
+        field:
+            The field to order by.
+        direction:
+            The direction to order by. Defaults to ``ASCENDING``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.Order)
+            ),
+        ),
+        Projection=_reflection.GeneratedProtocolMessageType(
+            "Projection",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_PROJECTION,
+                __module__="google.cloud.firestore_v1.proto.query_pb2",
+                __doc__="""The projection of document's fields to return.
+    
+    
+    Attributes:
+        fields:
+            The fields to return.  If empty, all fields are returned. To
+            only return the name of the document, use ``['__name__']``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery.Projection)
+            ),
+        ),
+        DESCRIPTOR=_STRUCTUREDQUERY,
+        __module__="google.cloud.firestore_v1.proto.query_pb2",
+        __doc__="""A Firestore query.
+  
+  
+  Attributes:
+      select:
+          The projection to return.
+      from:
+          The collections to query.
+      where:
+          The filter to apply.
+      order_by:
+          The order to apply to the query results.  Firestore guarantees
+          a stable ordering through the following rules:  -  Any field
+          required to appear in ``order_by``, that is not already
+          specified in ``order_by``, is appended to the order in field
+          name    order by default. -  If an order on ``__name__`` is
+          not specified, it is appended by    default.  Fields are
+          appended with the same sort direction as the last order
+          specified, or 'ASCENDING' if no order was specified. For
+          example:  -  ``SELECT * FROM Foo ORDER BY A`` becomes
+          ``SELECT * FROM Foo ORDER BY A, __name__`` -  ``SELECT * FROM
+          Foo ORDER BY A DESC`` becomes    ``SELECT * FROM Foo ORDER BY
+          A DESC, __name__ DESC`` -  ``SELECT * FROM Foo WHERE A > 1``
+          becomes    ``SELECT * FROM Foo WHERE A > 1 ORDER BY A,
+          __name__``
+      start_at:
+          A starting point for the query results.
+      end_at:
+          A end point for the query results.
+      offset:
+          The number of results to skip.  Applies before limit, but
+          after all other constraints. Must be >= 0 if specified.
+      limit:
+          The maximum number of results to return.  Applies after all
+          other constraints. Must be >= 0 if specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.StructuredQuery)
+    ),
+)
+_sym_db.RegisterMessage(StructuredQuery)
+_sym_db.RegisterMessage(StructuredQuery.CollectionSelector)
+_sym_db.RegisterMessage(StructuredQuery.Filter)
+_sym_db.RegisterMessage(StructuredQuery.CompositeFilter)
+_sym_db.RegisterMessage(StructuredQuery.FieldFilter)
+_sym_db.RegisterMessage(StructuredQuery.UnaryFilter)
+_sym_db.RegisterMessage(StructuredQuery.FieldReference)
+_sym_db.RegisterMessage(StructuredQuery.Order)
+_sym_db.RegisterMessage(StructuredQuery.Projection)
+
+Cursor = _reflection.GeneratedProtocolMessageType(
+    "Cursor",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CURSOR,
+        __module__="google.cloud.firestore_v1.proto.query_pb2",
+        __doc__="""A position in a query result set.
+  
+  
+  Attributes:
+      values:
+          The values that represent a position, in the order they appear
+          in the order by clause of a query.  Can contain fewer values
+          than specified in the order by clause.
+      before:
+          If the position is just before or just after the given values,
+          relative to the sort order defined by the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.Cursor)
+    ),
+)
+_sym_db.RegisterMessage(Cursor)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/query_pb2_grpc.py b/firestore/google/cloud/firestore_v1/proto/query_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/query_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1/proto/test_v1_pb2.py b/firestore/google/cloud/firestore_v1/proto/test_v1_pb2.py
new file mode 100644
index 000000000000..336bab948414
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/test_v1_pb2.py
@@ -0,0 +1,2190 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: test_v1.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    firestore_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    query_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="test_v1.proto",
+    package="tests.v1",
+    syntax="proto3",
+    serialized_pb=_b(
+        '\n\rtest_v1.proto\x12\x08tests.v1\x1a,google/cloud/firestore_v1/proto/common.proto\x1a.google/cloud/firestore_v1/proto/document.proto\x1a/google/cloud/firestore_v1/proto/firestore.proto\x1a+google/cloud/firestore_v1/proto/query.proto\x1a\x1fgoogle/protobuf/timestamp.proto"*\n\tTestSuite\x12\x1d\n\x05tests\x18\x01 \x03(\x0b\x32\x0e.tests.v1.Test"\xe0\x02\n\x04Test\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12 \n\x03get\x18\x02 \x01(\x0b\x32\x11.tests.v1.GetTestH\x00\x12&\n\x06\x63reate\x18\x03 \x01(\x0b\x32\x14.tests.v1.CreateTestH\x00\x12 \n\x03set\x18\x04 \x01(\x0b\x32\x11.tests.v1.SetTestH\x00\x12&\n\x06update\x18\x05 \x01(\x0b\x32\x14.tests.v1.UpdateTestH\x00\x12\x31\n\x0cupdate_paths\x18\x06 \x01(\x0b\x32\x19.tests.v1.UpdatePathsTestH\x00\x12&\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x14.tests.v1.DeleteTestH\x00\x12$\n\x05query\x18\x08 \x01(\x0b\x32\x13.tests.v1.QueryTestH\x00\x12&\n\x06listen\x18\t \x01(\x0b\x32\x14.tests.v1.ListenTestH\x00\x42\x06\n\x04test"Y\n\x07GetTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x38\n\x07request\x18\x02 \x01(\x0b\x32\'.google.firestore.v1.GetDocumentRequest"|\n\nCreateTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x11\n\tjson_data\x18\x02 \x01(\t\x12\x33\n\x07request\x18\x03 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x04 \x01(\x08"\x9e\x01\n\x07SetTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12#\n\x06option\x18\x02 \x01(\x0b\x32\x13.tests.v1.SetOption\x12\x11\n\tjson_data\x18\x03 \x01(\t\x12\x33\n\x07request\x18\x04 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x05 \x01(\x08"\xb5\x01\n\nUpdateTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x37\n\x0cprecondition\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition\x12\x11\n\tjson_data\x18\x03 \x01(\t\x12\x33\n\x07request\x18\x04 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x05 \x01(\x08"\xe6\x01\n\x0fUpdatePathsTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x37\n\x0cprecondition\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition\x12(\n\x0b\x66ield_paths\x18\x03 \x03(\x0b\x32\x13.tests.v1.FieldPath\x12\x13\n\x0bjson_values\x18\x04 \x03(\t\x12\x33\n\x07request\x18\x05 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x06 \x01(\x08"\xa2\x01\n\nDeleteTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x37\n\x0cprecondition\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition\x12\x33\n\x07request\x18\x03 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x04 \x01(\x08"=\n\tSetOption\x12\x0b\n\x03\x61ll\x18\x01 \x01(\x08\x12#\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x13.tests.v1.FieldPath"\x88\x01\n\tQueryTest\x12\x11\n\tcoll_path\x18\x01 \x01(\t\x12!\n\x07\x63lauses\x18\x02 \x03(\x0b\x32\x10.tests.v1.Clause\x12\x33\n\x05query\x18\x03 \x01(\x0b\x32$.google.firestore.v1.StructuredQuery\x12\x10\n\x08is_error\x18\x04 \x01(\x08"\xbd\x02\n\x06\x43lause\x12"\n\x06select\x18\x01 \x01(\x0b\x32\x10.tests.v1.SelectH\x00\x12 \n\x05where\x18\x02 \x01(\x0b\x32\x0f.tests.v1.WhereH\x00\x12%\n\x08order_by\x18\x03 \x01(\x0b\x32\x11.tests.v1.OrderByH\x00\x12\x10\n\x06offset\x18\x04 \x01(\x05H\x00\x12\x0f\n\x05limit\x18\x05 \x01(\x05H\x00\x12$\n\x08start_at\x18\x06 \x01(\x0b\x32\x10.tests.v1.CursorH\x00\x12\'\n\x0bstart_after\x18\x07 \x01(\x0b\x32\x10.tests.v1.CursorH\x00\x12"\n\x06\x65nd_at\x18\x08 \x01(\x0b\x32\x10.tests.v1.CursorH\x00\x12&\n\nend_before\x18\t \x01(\x0b\x32\x10.tests.v1.CursorH\x00\x42\x08\n\x06\x63lause"-\n\x06Select\x12#\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x13.tests.v1.FieldPath"J\n\x05Where\x12!\n\x04path\x18\x01 \x01(\x0b\x32\x13.tests.v1.FieldPath\x12\n\n\x02op\x18\x02 \x01(\t\x12\x12\n\njson_value\x18\x03 \x01(\t"?\n\x07OrderBy\x12!\n\x04path\x18\x01 \x01(\x0b\x32\x13.tests.v1.FieldPath\x12\x11\n\tdirection\x18\x02 \x01(\t"J\n\x06\x43ursor\x12+\n\x0c\x64oc_snapshot\x18\x01 \x01(\x0b\x32\x15.tests.v1.DocSnapshot\x12\x13\n\x0bjson_values\x18\x02 \x03(\t".\n\x0b\x44ocSnapshot\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x11\n\tjson_data\x18\x02 \x01(\t"\x1a\n\tFieldPath\x12\r\n\x05\x66ield\x18\x01 \x03(\t"}\n\nListenTest\x12\x36\n\tresponses\x18\x01 \x03(\x0b\x32#.google.firestore.v1.ListenResponse\x12%\n\tsnapshots\x18\x02 \x03(\x0b\x32\x12.tests.v1.Snapshot\x12\x10\n\x08is_error\x18\x03 \x01(\x08"\x8c\x01\n\x08Snapshot\x12+\n\x04\x64ocs\x18\x01 \x03(\x0b\x32\x1d.google.firestore.v1.Document\x12$\n\x07\x63hanges\x18\x02 \x03(\x0b\x32\x13.tests.v1.DocChange\x12-\n\tread_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xc9\x01\n\tDocChange\x12&\n\x04kind\x18\x01 \x01(\x0e\x32\x18.tests.v1.DocChange.Kind\x12*\n\x03\x64oc\x18\x02 \x01(\x0b\x32\x1d.google.firestore.v1.Document\x12\x11\n\told_index\x18\x03 \x01(\x05\x12\x11\n\tnew_index\x18\x04 \x01(\x05"B\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\t\n\x05\x41\x44\x44\x45\x44\x10\x01\x12\x0b\n\x07REMOVED\x10\x02\x12\x0c\n\x08MODIFIED\x10\x03\x42x\n&com.google.cloud.firestore.conformance\xaa\x02"Google.Cloud.Firestore.Tests.Proto\xca\x02(Google\\Cloud\\Firestore\\Tests\\Conformanceb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCCHANGE_KIND = _descriptor.EnumDescriptor(
+    name="Kind",
+    full_name="tests.v1.DocChange.Kind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="KIND_UNSPECIFIED", index=0, number=0, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDED", index=1, number=1, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVED", index=2, number=2, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MODIFIED", index=3, number=3, options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    options=None,
+    serialized_start=2875,
+    serialized_end=2941,
+)
+_sym_db.RegisterEnumDescriptor(_DOCCHANGE_KIND)
+
+
+_TESTSUITE = _descriptor.Descriptor(
+    name="TestSuite",
+    full_name="tests.v1.TestSuite",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tests",
+            full_name="tests.v1.TestSuite.tests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=248,
+    serialized_end=290,
+)
+
+
+_TEST = _descriptor.Descriptor(
+    name="Test",
+    full_name="tests.v1.Test",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="tests.v1.Test.description",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="get",
+            full_name="tests.v1.Test.get",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create",
+            full_name="tests.v1.Test.create",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="set",
+            full_name="tests.v1.Test.set",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="tests.v1.Test.update",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_paths",
+            full_name="tests.v1.Test.update_paths",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="tests.v1.Test.delete",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="tests.v1.Test.query",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="listen",
+            full_name="tests.v1.Test.listen",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="test",
+            full_name="tests.v1.Test.test",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=293,
+    serialized_end=645,
+)
+
+
+_GETTEST = _descriptor.Descriptor(
+    name="GetTest",
+    full_name="tests.v1.GetTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1.GetTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1.GetTest.request",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=647,
+    serialized_end=736,
+)
+
+
+_CREATETEST = _descriptor.Descriptor(
+    name="CreateTest",
+    full_name="tests.v1.CreateTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1.CreateTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1.CreateTest.json_data",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1.CreateTest.request",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.CreateTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=738,
+    serialized_end=862,
+)
+
+
+_SETTEST = _descriptor.Descriptor(
+    name="SetTest",
+    full_name="tests.v1.SetTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1.SetTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="option",
+            full_name="tests.v1.SetTest.option",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1.SetTest.json_data",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1.SetTest.request",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.SetTest.is_error",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=865,
+    serialized_end=1023,
+)
+
+
+_UPDATETEST = _descriptor.Descriptor(
+    name="UpdateTest",
+    full_name="tests.v1.UpdateTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1.UpdateTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="tests.v1.UpdateTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1.UpdateTest.json_data",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1.UpdateTest.request",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.UpdateTest.is_error",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1026,
+    serialized_end=1207,
+)
+
+
+_UPDATEPATHSTEST = _descriptor.Descriptor(
+    name="UpdatePathsTest",
+    full_name="tests.v1.UpdatePathsTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1.UpdatePathsTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="tests.v1.UpdatePathsTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_paths",
+            full_name="tests.v1.UpdatePathsTest.field_paths",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_values",
+            full_name="tests.v1.UpdatePathsTest.json_values",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1.UpdatePathsTest.request",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.UpdatePathsTest.is_error",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1210,
+    serialized_end=1440,
+)
+
+
+_DELETETEST = _descriptor.Descriptor(
+    name="DeleteTest",
+    full_name="tests.v1.DeleteTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1.DeleteTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="tests.v1.DeleteTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1.DeleteTest.request",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.DeleteTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1443,
+    serialized_end=1605,
+)
+
+
+_SETOPTION = _descriptor.Descriptor(
+    name="SetOption",
+    full_name="tests.v1.SetOption",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="all",
+            full_name="tests.v1.SetOption.all",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="tests.v1.SetOption.fields",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1607,
+    serialized_end=1668,
+)
+
+
+_QUERYTEST = _descriptor.Descriptor(
+    name="QueryTest",
+    full_name="tests.v1.QueryTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="coll_path",
+            full_name="tests.v1.QueryTest.coll_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="clauses",
+            full_name="tests.v1.QueryTest.clauses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="tests.v1.QueryTest.query",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.QueryTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1671,
+    serialized_end=1807,
+)
+
+
+_CLAUSE = _descriptor.Descriptor(
+    name="Clause",
+    full_name="tests.v1.Clause",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="select",
+            full_name="tests.v1.Clause.select",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="where",
+            full_name="tests.v1.Clause.where",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="tests.v1.Clause.order_by",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="tests.v1.Clause.offset",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="tests.v1.Clause.limit",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_at",
+            full_name="tests.v1.Clause.start_at",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_after",
+            full_name="tests.v1.Clause.start_after",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_at",
+            full_name="tests.v1.Clause.end_at",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_before",
+            full_name="tests.v1.Clause.end_before",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="clause",
+            full_name="tests.v1.Clause.clause",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1810,
+    serialized_end=2127,
+)
+
+
+_SELECT = _descriptor.Descriptor(
+    name="Select",
+    full_name="tests.v1.Select",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="tests.v1.Select.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2129,
+    serialized_end=2174,
+)
+
+
+_WHERE = _descriptor.Descriptor(
+    name="Where",
+    full_name="tests.v1.Where",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="tests.v1.Where.path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="tests.v1.Where.op",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_value",
+            full_name="tests.v1.Where.json_value",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2176,
+    serialized_end=2250,
+)
+
+
+_ORDERBY = _descriptor.Descriptor(
+    name="OrderBy",
+    full_name="tests.v1.OrderBy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="tests.v1.OrderBy.path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="direction",
+            full_name="tests.v1.OrderBy.direction",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2252,
+    serialized_end=2315,
+)
+
+
+_CURSOR = _descriptor.Descriptor(
+    name="Cursor",
+    full_name="tests.v1.Cursor",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_snapshot",
+            full_name="tests.v1.Cursor.doc_snapshot",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_values",
+            full_name="tests.v1.Cursor.json_values",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2317,
+    serialized_end=2391,
+)
+
+
+_DOCSNAPSHOT = _descriptor.Descriptor(
+    name="DocSnapshot",
+    full_name="tests.v1.DocSnapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="tests.v1.DocSnapshot.path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1.DocSnapshot.json_data",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2393,
+    serialized_end=2439,
+)
+
+
+_FIELDPATH = _descriptor.Descriptor(
+    name="FieldPath",
+    full_name="tests.v1.FieldPath",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="tests.v1.FieldPath.field",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2441,
+    serialized_end=2467,
+)
+
+
+_LISTENTEST = _descriptor.Descriptor(
+    name="ListenTest",
+    full_name="tests.v1.ListenTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="tests.v1.ListenTest.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="snapshots",
+            full_name="tests.v1.ListenTest.snapshots",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1.ListenTest.is_error",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2469,
+    serialized_end=2594,
+)
+
+
+_SNAPSHOT = _descriptor.Descriptor(
+    name="Snapshot",
+    full_name="tests.v1.Snapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="docs",
+            full_name="tests.v1.Snapshot.docs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="changes",
+            full_name="tests.v1.Snapshot.changes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="tests.v1.Snapshot.read_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2597,
+    serialized_end=2737,
+)
+
+
+_DOCCHANGE = _descriptor.Descriptor(
+    name="DocChange",
+    full_name="tests.v1.DocChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="tests.v1.DocChange.kind",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="doc",
+            full_name="tests.v1.DocChange.doc",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="old_index",
+            full_name="tests.v1.DocChange.old_index",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_index",
+            full_name="tests.v1.DocChange.new_index",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCCHANGE_KIND],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2740,
+    serialized_end=2941,
+)
+
+_TESTSUITE.fields_by_name["tests"].message_type = _TEST
+_TEST.fields_by_name["get"].message_type = _GETTEST
+_TEST.fields_by_name["create"].message_type = _CREATETEST
+_TEST.fields_by_name["set"].message_type = _SETTEST
+_TEST.fields_by_name["update"].message_type = _UPDATETEST
+_TEST.fields_by_name["update_paths"].message_type = _UPDATEPATHSTEST
+_TEST.fields_by_name["delete"].message_type = _DELETETEST
+_TEST.fields_by_name["query"].message_type = _QUERYTEST
+_TEST.fields_by_name["listen"].message_type = _LISTENTEST
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["get"])
+_TEST.fields_by_name["get"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["create"])
+_TEST.fields_by_name["create"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["set"])
+_TEST.fields_by_name["set"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["update"])
+_TEST.fields_by_name["update"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["update_paths"])
+_TEST.fields_by_name["update_paths"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["delete"])
+_TEST.fields_by_name["delete"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["query"])
+_TEST.fields_by_name["query"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["listen"])
+_TEST.fields_by_name["listen"].containing_oneof = _TEST.oneofs_by_name["test"]
+_GETTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._GETDOCUMENTREQUEST
+)
+_CREATETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_SETTEST.fields_by_name["option"].message_type = _SETOPTION
+_SETTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_UPDATETEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_UPDATETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_UPDATEPATHSTEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_UPDATEPATHSTEST.fields_by_name["field_paths"].message_type = _FIELDPATH
+_UPDATEPATHSTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_DELETETEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_DELETETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_SETOPTION.fields_by_name["fields"].message_type = _FIELDPATH
+_QUERYTEST.fields_by_name["clauses"].message_type = _CLAUSE
+_QUERYTEST.fields_by_name[
+    "query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_CLAUSE.fields_by_name["select"].message_type = _SELECT
+_CLAUSE.fields_by_name["where"].message_type = _WHERE
+_CLAUSE.fields_by_name["order_by"].message_type = _ORDERBY
+_CLAUSE.fields_by_name["start_at"].message_type = _CURSOR
+_CLAUSE.fields_by_name["start_after"].message_type = _CURSOR
+_CLAUSE.fields_by_name["end_at"].message_type = _CURSOR
+_CLAUSE.fields_by_name["end_before"].message_type = _CURSOR
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["select"])
+_CLAUSE.fields_by_name["select"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["where"])
+_CLAUSE.fields_by_name["where"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["order_by"])
+_CLAUSE.fields_by_name["order_by"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["offset"])
+_CLAUSE.fields_by_name["offset"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["limit"])
+_CLAUSE.fields_by_name["limit"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["start_at"])
+_CLAUSE.fields_by_name["start_at"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["start_after"])
+_CLAUSE.fields_by_name["start_after"].containing_oneof = _CLAUSE.oneofs_by_name[
+    "clause"
+]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["end_at"])
+_CLAUSE.fields_by_name["end_at"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["end_before"])
+_CLAUSE.fields_by_name["end_before"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_SELECT.fields_by_name["fields"].message_type = _FIELDPATH
+_WHERE.fields_by_name["path"].message_type = _FIELDPATH
+_ORDERBY.fields_by_name["path"].message_type = _FIELDPATH
+_CURSOR.fields_by_name["doc_snapshot"].message_type = _DOCSNAPSHOT
+_LISTENTEST.fields_by_name[
+    "responses"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._LISTENRESPONSE
+)
+_LISTENTEST.fields_by_name["snapshots"].message_type = _SNAPSHOT
+_SNAPSHOT.fields_by_name[
+    "docs"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_SNAPSHOT.fields_by_name["changes"].message_type = _DOCCHANGE
+_SNAPSHOT.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCCHANGE.fields_by_name["kind"].enum_type = _DOCCHANGE_KIND
+_DOCCHANGE.fields_by_name[
+    "doc"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_DOCCHANGE_KIND.containing_type = _DOCCHANGE
+DESCRIPTOR.message_types_by_name["TestSuite"] = _TESTSUITE
+DESCRIPTOR.message_types_by_name["Test"] = _TEST
+DESCRIPTOR.message_types_by_name["GetTest"] = _GETTEST
+DESCRIPTOR.message_types_by_name["CreateTest"] = _CREATETEST
+DESCRIPTOR.message_types_by_name["SetTest"] = _SETTEST
+DESCRIPTOR.message_types_by_name["UpdateTest"] = _UPDATETEST
+DESCRIPTOR.message_types_by_name["UpdatePathsTest"] = _UPDATEPATHSTEST
+DESCRIPTOR.message_types_by_name["DeleteTest"] = _DELETETEST
+DESCRIPTOR.message_types_by_name["SetOption"] = _SETOPTION
+DESCRIPTOR.message_types_by_name["QueryTest"] = _QUERYTEST
+DESCRIPTOR.message_types_by_name["Clause"] = _CLAUSE
+DESCRIPTOR.message_types_by_name["Select"] = _SELECT
+DESCRIPTOR.message_types_by_name["Where"] = _WHERE
+DESCRIPTOR.message_types_by_name["OrderBy"] = _ORDERBY
+DESCRIPTOR.message_types_by_name["Cursor"] = _CURSOR
+DESCRIPTOR.message_types_by_name["DocSnapshot"] = _DOCSNAPSHOT
+DESCRIPTOR.message_types_by_name["FieldPath"] = _FIELDPATH
+DESCRIPTOR.message_types_by_name["ListenTest"] = _LISTENTEST
+DESCRIPTOR.message_types_by_name["Snapshot"] = _SNAPSHOT
+DESCRIPTOR.message_types_by_name["DocChange"] = _DOCCHANGE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TestSuite = _reflection.GeneratedProtocolMessageType(
+    "TestSuite",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TESTSUITE,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.TestSuite)
+    ),
+)
+_sym_db.RegisterMessage(TestSuite)
+
+Test = _reflection.GeneratedProtocolMessageType(
+    "Test",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.Test)
+    ),
+)
+_sym_db.RegisterMessage(Test)
+
+GetTest = _reflection.GeneratedProtocolMessageType(
+    "GetTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.GetTest)
+    ),
+)
+_sym_db.RegisterMessage(GetTest)
+
+CreateTest = _reflection.GeneratedProtocolMessageType(
+    "CreateTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.CreateTest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTest)
+
+SetTest = _reflection.GeneratedProtocolMessageType(
+    "SetTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETTEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.SetTest)
+    ),
+)
+_sym_db.RegisterMessage(SetTest)
+
+UpdateTest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.UpdateTest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTest)
+
+UpdatePathsTest = _reflection.GeneratedProtocolMessageType(
+    "UpdatePathsTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPATHSTEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.UpdatePathsTest)
+    ),
+)
+_sym_db.RegisterMessage(UpdatePathsTest)
+
+DeleteTest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.DeleteTest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTest)
+
+SetOption = _reflection.GeneratedProtocolMessageType(
+    "SetOption",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETOPTION,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.SetOption)
+    ),
+)
+_sym_db.RegisterMessage(SetOption)
+
+QueryTest = _reflection.GeneratedProtocolMessageType(
+    "QueryTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYTEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.QueryTest)
+    ),
+)
+_sym_db.RegisterMessage(QueryTest)
+
+Clause = _reflection.GeneratedProtocolMessageType(
+    "Clause",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLAUSE,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.Clause)
+    ),
+)
+_sym_db.RegisterMessage(Clause)
+
+Select = _reflection.GeneratedProtocolMessageType(
+    "Select",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SELECT,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.Select)
+    ),
+)
+_sym_db.RegisterMessage(Select)
+
+Where = _reflection.GeneratedProtocolMessageType(
+    "Where",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WHERE,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.Where)
+    ),
+)
+_sym_db.RegisterMessage(Where)
+
+OrderBy = _reflection.GeneratedProtocolMessageType(
+    "OrderBy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ORDERBY,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.OrderBy)
+    ),
+)
+_sym_db.RegisterMessage(OrderBy)
+
+Cursor = _reflection.GeneratedProtocolMessageType(
+    "Cursor",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CURSOR,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.Cursor)
+    ),
+)
+_sym_db.RegisterMessage(Cursor)
+
+DocSnapshot = _reflection.GeneratedProtocolMessageType(
+    "DocSnapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCSNAPSHOT,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.DocSnapshot)
+    ),
+)
+_sym_db.RegisterMessage(DocSnapshot)
+
+FieldPath = _reflection.GeneratedProtocolMessageType(
+    "FieldPath",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FIELDPATH,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.FieldPath)
+    ),
+)
+_sym_db.RegisterMessage(FieldPath)
+
+ListenTest = _reflection.GeneratedProtocolMessageType(
+    "ListenTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTENTEST,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.ListenTest)
+    ),
+)
+_sym_db.RegisterMessage(ListenTest)
+
+Snapshot = _reflection.GeneratedProtocolMessageType(
+    "Snapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SNAPSHOT,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.Snapshot)
+    ),
+)
+_sym_db.RegisterMessage(Snapshot)
+
+DocChange = _reflection.GeneratedProtocolMessageType(
+    "DocChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCCHANGE,
+        __module__="test_v1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1.DocChange)
+    ),
+)
+_sym_db.RegisterMessage(DocChange)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        '\n&com.google.cloud.firestore.conformance\252\002"Google.Cloud.Firestore.Tests.Proto\312\002(Google\\Cloud\\Firestore\\Tests\\Conformance'
+    ),
+)
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/tests_pb2.py b/firestore/google/cloud/firestore_v1/proto/tests_pb2.py
new file mode 100644
index 000000000000..126887881e53
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/tests_pb2.py
@@ -0,0 +1,2208 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1/proto/tests.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    firestore_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    query_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1/proto/tests.proto",
+    package="google.cloud.firestore_v1.proto",
+    syntax="proto3",
+    serialized_pb=_b(
+        '\n+google/cloud/firestore_v1/proto/tests.proto\x12\x1fgoogle.cloud.firestore_v1.proto\x1a,google/cloud/firestore_v1/proto/common.proto\x1a.google/cloud/firestore_v1/proto/document.proto\x1a/google/cloud/firestore_v1/proto/firestore.proto\x1a+google/cloud/firestore_v1/proto/query.proto\x1a\x1fgoogle/protobuf/timestamp.proto"@\n\x08TestFile\x12\x34\n\x05tests\x18\x01 \x03(\x0b\x32%.google.cloud.firestore_v1.proto.Test"\xa9\x04\n\x04Test\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12\x0f\n\x07\x63omment\x18\n \x01(\t\x12\x37\n\x03get\x18\x02 \x01(\x0b\x32(.google.cloud.firestore_v1.proto.GetTestH\x00\x12=\n\x06\x63reate\x18\x03 \x01(\x0b\x32+.google.cloud.firestore_v1.proto.CreateTestH\x00\x12\x37\n\x03set\x18\x04 \x01(\x0b\x32(.google.cloud.firestore_v1.proto.SetTestH\x00\x12=\n\x06update\x18\x05 \x01(\x0b\x32+.google.cloud.firestore_v1.proto.UpdateTestH\x00\x12H\n\x0cupdate_paths\x18\x06 \x01(\x0b\x32\x30.google.cloud.firestore_v1.proto.UpdatePathsTestH\x00\x12=\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32+.google.cloud.firestore_v1.proto.DeleteTestH\x00\x12;\n\x05query\x18\x08 \x01(\x0b\x32*.google.cloud.firestore_v1.proto.QueryTestH\x00\x12=\n\x06listen\x18\t \x01(\x0b\x32+.google.cloud.firestore_v1.proto.ListenTestH\x00\x42\x06\n\x04test"Y\n\x07GetTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x38\n\x07request\x18\x02 \x01(\x0b\x32\'.google.firestore.v1.GetDocumentRequest"|\n\nCreateTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x11\n\tjson_data\x18\x02 \x01(\t\x12\x33\n\x07request\x18\x03 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x04 \x01(\x08"\xb5\x01\n\x07SetTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12:\n\x06option\x18\x02 \x01(\x0b\x32*.google.cloud.firestore_v1.proto.SetOption\x12\x11\n\tjson_data\x18\x03 \x01(\t\x12\x33\n\x07request\x18\x04 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x05 \x01(\x08"\xb5\x01\n\nUpdateTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x37\n\x0cprecondition\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition\x12\x11\n\tjson_data\x18\x03 \x01(\t\x12\x33\n\x07request\x18\x04 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x05 \x01(\x08"\xfd\x01\n\x0fUpdatePathsTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x37\n\x0cprecondition\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition\x12?\n\x0b\x66ield_paths\x18\x03 \x03(\x0b\x32*.google.cloud.firestore_v1.proto.FieldPath\x12\x13\n\x0bjson_values\x18\x04 \x03(\t\x12\x33\n\x07request\x18\x05 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x06 \x01(\x08"\xa2\x01\n\nDeleteTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x37\n\x0cprecondition\x18\x02 \x01(\x0b\x32!.google.firestore.v1.Precondition\x12\x33\n\x07request\x18\x03 \x01(\x0b\x32".google.firestore.v1.CommitRequest\x12\x10\n\x08is_error\x18\x04 \x01(\x08"T\n\tSetOption\x12\x0b\n\x03\x61ll\x18\x01 \x01(\x08\x12:\n\x06\x66ields\x18\x02 \x03(\x0b\x32*.google.cloud.firestore_v1.proto.FieldPath"\x9f\x01\n\tQueryTest\x12\x11\n\tcoll_path\x18\x01 \x01(\t\x12\x38\n\x07\x63lauses\x18\x02 \x03(\x0b\x32\'.google.cloud.firestore_v1.proto.Clause\x12\x33\n\x05query\x18\x03 \x01(\x0b\x32$.google.firestore.v1.StructuredQuery\x12\x10\n\x08is_error\x18\x04 \x01(\x08"\xde\x03\n\x06\x43lause\x12\x39\n\x06select\x18\x01 \x01(\x0b\x32\'.google.cloud.firestore_v1.proto.SelectH\x00\x12\x37\n\x05where\x18\x02 \x01(\x0b\x32&.google.cloud.firestore_v1.proto.WhereH\x00\x12<\n\x08order_by\x18\x03 \x01(\x0b\x32(.google.cloud.firestore_v1.proto.OrderByH\x00\x12\x10\n\x06offset\x18\x04 \x01(\x05H\x00\x12\x0f\n\x05limit\x18\x05 \x01(\x05H\x00\x12;\n\x08start_at\x18\x06 \x01(\x0b\x32\'.google.cloud.firestore_v1.proto.CursorH\x00\x12>\n\x0bstart_after\x18\x07 \x01(\x0b\x32\'.google.cloud.firestore_v1.proto.CursorH\x00\x12\x39\n\x06\x65nd_at\x18\x08 \x01(\x0b\x32\'.google.cloud.firestore_v1.proto.CursorH\x00\x12=\n\nend_before\x18\t \x01(\x0b\x32\'.google.cloud.firestore_v1.proto.CursorH\x00\x42\x08\n\x06\x63lause"D\n\x06Select\x12:\n\x06\x66ields\x18\x01 \x03(\x0b\x32*.google.cloud.firestore_v1.proto.FieldPath"a\n\x05Where\x12\x38\n\x04path\x18\x01 \x01(\x0b\x32*.google.cloud.firestore_v1.proto.FieldPath\x12\n\n\x02op\x18\x02 \x01(\t\x12\x12\n\njson_value\x18\x03 \x01(\t"V\n\x07OrderBy\x12\x38\n\x04path\x18\x01 \x01(\x0b\x32*.google.cloud.firestore_v1.proto.FieldPath\x12\x11\n\tdirection\x18\x02 \x01(\t"a\n\x06\x43ursor\x12\x42\n\x0c\x64oc_snapshot\x18\x01 \x01(\x0b\x32,.google.cloud.firestore_v1.proto.DocSnapshot\x12\x13\n\x0bjson_values\x18\x02 \x03(\t".\n\x0b\x44ocSnapshot\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x11\n\tjson_data\x18\x02 \x01(\t"\x1a\n\tFieldPath\x12\r\n\x05\x66ield\x18\x01 \x03(\t"\x94\x01\n\nListenTest\x12\x36\n\tresponses\x18\x01 \x03(\x0b\x32#.google.firestore.v1.ListenResponse\x12<\n\tsnapshots\x18\x02 \x03(\x0b\x32).google.cloud.firestore_v1.proto.Snapshot\x12\x10\n\x08is_error\x18\x03 \x01(\x08"\xa3\x01\n\x08Snapshot\x12+\n\x04\x64ocs\x18\x01 \x03(\x0b\x32\x1d.google.firestore.v1.Document\x12;\n\x07\x63hanges\x18\x02 \x03(\x0b\x32*.google.cloud.firestore_v1.proto.DocChange\x12-\n\tread_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xe0\x01\n\tDocChange\x12=\n\x04kind\x18\x01 \x01(\x0e\x32/.google.cloud.firestore_v1.proto.DocChange.Kind\x12*\n\x03\x64oc\x18\x02 \x01(\x0b\x32\x1d.google.firestore.v1.Document\x12\x11\n\told_index\x18\x03 \x01(\x05\x12\x11\n\tnew_index\x18\x04 \x01(\x05"B\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\t\n\x05\x41\x44\x44\x45\x44\x10\x01\x12\x0b\n\x07REMOVED\x10\x02\x12\x0c\n\x08MODIFIED\x10\x03\x42\x8b\x01\n)com.google.cloud.conformance.firestore.v1B\x0eTestDefinition\xaa\x02"Google.Cloud.Firestore.Tests.Proto\xca\x02(Google\\Cloud\\Firestore\\Tests\\Conformanceb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCCHANGE_KIND = _descriptor.EnumDescriptor(
+    name="Kind",
+    full_name="google.cloud.firestore_v1.proto.DocChange.Kind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="KIND_UNSPECIFIED", index=0, number=0, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDED", index=1, number=1, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVED", index=2, number=2, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MODIFIED", index=3, number=3, options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    options=None,
+    serialized_start=3566,
+    serialized_end=3632,
+)
+_sym_db.RegisterEnumDescriptor(_DOCCHANGE_KIND)
+
+
+_TESTFILE = _descriptor.Descriptor(
+    name="TestFile",
+    full_name="google.cloud.firestore_v1.proto.TestFile",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tests",
+            full_name="google.cloud.firestore_v1.proto.TestFile.tests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=301,
+    serialized_end=365,
+)
+
+
+_TEST = _descriptor.Descriptor(
+    name="Test",
+    full_name="google.cloud.firestore_v1.proto.Test",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.firestore_v1.proto.Test.description",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="comment",
+            full_name="google.cloud.firestore_v1.proto.Test.comment",
+            index=1,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="get",
+            full_name="google.cloud.firestore_v1.proto.Test.get",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create",
+            full_name="google.cloud.firestore_v1.proto.Test.create",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="set",
+            full_name="google.cloud.firestore_v1.proto.Test.set",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.cloud.firestore_v1.proto.Test.update",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_paths",
+            full_name="google.cloud.firestore_v1.proto.Test.update_paths",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="google.cloud.firestore_v1.proto.Test.delete",
+            index=7,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.firestore_v1.proto.Test.query",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="listen",
+            full_name="google.cloud.firestore_v1.proto.Test.listen",
+            index=9,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="test",
+            full_name="google.cloud.firestore_v1.proto.Test.test",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=368,
+    serialized_end=921,
+)
+
+
+_GETTEST = _descriptor.Descriptor(
+    name="GetTest",
+    full_name="google.cloud.firestore_v1.proto.GetTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="google.cloud.firestore_v1.proto.GetTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="google.cloud.firestore_v1.proto.GetTest.request",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=923,
+    serialized_end=1012,
+)
+
+
+_CREATETEST = _descriptor.Descriptor(
+    name="CreateTest",
+    full_name="google.cloud.firestore_v1.proto.CreateTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="google.cloud.firestore_v1.proto.CreateTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="google.cloud.firestore_v1.proto.CreateTest.json_data",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="google.cloud.firestore_v1.proto.CreateTest.request",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.CreateTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1014,
+    serialized_end=1138,
+)
+
+
+_SETTEST = _descriptor.Descriptor(
+    name="SetTest",
+    full_name="google.cloud.firestore_v1.proto.SetTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="google.cloud.firestore_v1.proto.SetTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="option",
+            full_name="google.cloud.firestore_v1.proto.SetTest.option",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="google.cloud.firestore_v1.proto.SetTest.json_data",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="google.cloud.firestore_v1.proto.SetTest.request",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.SetTest.is_error",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1141,
+    serialized_end=1322,
+)
+
+
+_UPDATETEST = _descriptor.Descriptor(
+    name="UpdateTest",
+    full_name="google.cloud.firestore_v1.proto.UpdateTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="google.cloud.firestore_v1.proto.UpdateTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="google.cloud.firestore_v1.proto.UpdateTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="google.cloud.firestore_v1.proto.UpdateTest.json_data",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="google.cloud.firestore_v1.proto.UpdateTest.request",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.UpdateTest.is_error",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1325,
+    serialized_end=1506,
+)
+
+
+_UPDATEPATHSTEST = _descriptor.Descriptor(
+    name="UpdatePathsTest",
+    full_name="google.cloud.firestore_v1.proto.UpdatePathsTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="google.cloud.firestore_v1.proto.UpdatePathsTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="google.cloud.firestore_v1.proto.UpdatePathsTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_paths",
+            full_name="google.cloud.firestore_v1.proto.UpdatePathsTest.field_paths",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_values",
+            full_name="google.cloud.firestore_v1.proto.UpdatePathsTest.json_values",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="google.cloud.firestore_v1.proto.UpdatePathsTest.request",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.UpdatePathsTest.is_error",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1509,
+    serialized_end=1762,
+)
+
+
+_DELETETEST = _descriptor.Descriptor(
+    name="DeleteTest",
+    full_name="google.cloud.firestore_v1.proto.DeleteTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="google.cloud.firestore_v1.proto.DeleteTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="google.cloud.firestore_v1.proto.DeleteTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="google.cloud.firestore_v1.proto.DeleteTest.request",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.DeleteTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1765,
+    serialized_end=1927,
+)
+
+
+_SETOPTION = _descriptor.Descriptor(
+    name="SetOption",
+    full_name="google.cloud.firestore_v1.proto.SetOption",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="all",
+            full_name="google.cloud.firestore_v1.proto.SetOption.all",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.firestore_v1.proto.SetOption.fields",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1929,
+    serialized_end=2013,
+)
+
+
+_QUERYTEST = _descriptor.Descriptor(
+    name="QueryTest",
+    full_name="google.cloud.firestore_v1.proto.QueryTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="coll_path",
+            full_name="google.cloud.firestore_v1.proto.QueryTest.coll_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="clauses",
+            full_name="google.cloud.firestore_v1.proto.QueryTest.clauses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.firestore_v1.proto.QueryTest.query",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.QueryTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2016,
+    serialized_end=2175,
+)
+
+
+_CLAUSE = _descriptor.Descriptor(
+    name="Clause",
+    full_name="google.cloud.firestore_v1.proto.Clause",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="select",
+            full_name="google.cloud.firestore_v1.proto.Clause.select",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="where",
+            full_name="google.cloud.firestore_v1.proto.Clause.where",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.firestore_v1.proto.Clause.order_by",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.cloud.firestore_v1.proto.Clause.offset",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="google.cloud.firestore_v1.proto.Clause.limit",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_at",
+            full_name="google.cloud.firestore_v1.proto.Clause.start_at",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_after",
+            full_name="google.cloud.firestore_v1.proto.Clause.start_after",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_at",
+            full_name="google.cloud.firestore_v1.proto.Clause.end_at",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_before",
+            full_name="google.cloud.firestore_v1.proto.Clause.end_before",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="clause",
+            full_name="google.cloud.firestore_v1.proto.Clause.clause",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2178,
+    serialized_end=2656,
+)
+
+
+_SELECT = _descriptor.Descriptor(
+    name="Select",
+    full_name="google.cloud.firestore_v1.proto.Select",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.firestore_v1.proto.Select.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2658,
+    serialized_end=2726,
+)
+
+
+_WHERE = _descriptor.Descriptor(
+    name="Where",
+    full_name="google.cloud.firestore_v1.proto.Where",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.cloud.firestore_v1.proto.Where.path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.cloud.firestore_v1.proto.Where.op",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_value",
+            full_name="google.cloud.firestore_v1.proto.Where.json_value",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2728,
+    serialized_end=2825,
+)
+
+
+_ORDERBY = _descriptor.Descriptor(
+    name="OrderBy",
+    full_name="google.cloud.firestore_v1.proto.OrderBy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.cloud.firestore_v1.proto.OrderBy.path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="direction",
+            full_name="google.cloud.firestore_v1.proto.OrderBy.direction",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2827,
+    serialized_end=2913,
+)
+
+
+_CURSOR = _descriptor.Descriptor(
+    name="Cursor",
+    full_name="google.cloud.firestore_v1.proto.Cursor",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_snapshot",
+            full_name="google.cloud.firestore_v1.proto.Cursor.doc_snapshot",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_values",
+            full_name="google.cloud.firestore_v1.proto.Cursor.json_values",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2915,
+    serialized_end=3012,
+)
+
+
+_DOCSNAPSHOT = _descriptor.Descriptor(
+    name="DocSnapshot",
+    full_name="google.cloud.firestore_v1.proto.DocSnapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.cloud.firestore_v1.proto.DocSnapshot.path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="google.cloud.firestore_v1.proto.DocSnapshot.json_data",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3014,
+    serialized_end=3060,
+)
+
+
+_FIELDPATH = _descriptor.Descriptor(
+    name="FieldPath",
+    full_name="google.cloud.firestore_v1.proto.FieldPath",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.cloud.firestore_v1.proto.FieldPath.field",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3062,
+    serialized_end=3088,
+)
+
+
+_LISTENTEST = _descriptor.Descriptor(
+    name="ListenTest",
+    full_name="google.cloud.firestore_v1.proto.ListenTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.firestore_v1.proto.ListenTest.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="snapshots",
+            full_name="google.cloud.firestore_v1.proto.ListenTest.snapshots",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="google.cloud.firestore_v1.proto.ListenTest.is_error",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3091,
+    serialized_end=3239,
+)
+
+
+_SNAPSHOT = _descriptor.Descriptor(
+    name="Snapshot",
+    full_name="google.cloud.firestore_v1.proto.Snapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="docs",
+            full_name="google.cloud.firestore_v1.proto.Snapshot.docs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="changes",
+            full_name="google.cloud.firestore_v1.proto.Snapshot.changes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.firestore_v1.proto.Snapshot.read_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3242,
+    serialized_end=3405,
+)
+
+
+_DOCCHANGE = _descriptor.Descriptor(
+    name="DocChange",
+    full_name="google.cloud.firestore_v1.proto.DocChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.cloud.firestore_v1.proto.DocChange.kind",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="doc",
+            full_name="google.cloud.firestore_v1.proto.DocChange.doc",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="old_index",
+            full_name="google.cloud.firestore_v1.proto.DocChange.old_index",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_index",
+            full_name="google.cloud.firestore_v1.proto.DocChange.new_index",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCCHANGE_KIND],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3408,
+    serialized_end=3632,
+)
+
+_TESTFILE.fields_by_name["tests"].message_type = _TEST
+_TEST.fields_by_name["get"].message_type = _GETTEST
+_TEST.fields_by_name["create"].message_type = _CREATETEST
+_TEST.fields_by_name["set"].message_type = _SETTEST
+_TEST.fields_by_name["update"].message_type = _UPDATETEST
+_TEST.fields_by_name["update_paths"].message_type = _UPDATEPATHSTEST
+_TEST.fields_by_name["delete"].message_type = _DELETETEST
+_TEST.fields_by_name["query"].message_type = _QUERYTEST
+_TEST.fields_by_name["listen"].message_type = _LISTENTEST
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["get"])
+_TEST.fields_by_name["get"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["create"])
+_TEST.fields_by_name["create"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["set"])
+_TEST.fields_by_name["set"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["update"])
+_TEST.fields_by_name["update"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["update_paths"])
+_TEST.fields_by_name["update_paths"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["delete"])
+_TEST.fields_by_name["delete"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["query"])
+_TEST.fields_by_name["query"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["listen"])
+_TEST.fields_by_name["listen"].containing_oneof = _TEST.oneofs_by_name["test"]
+_GETTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._GETDOCUMENTREQUEST
+)
+_CREATETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_SETTEST.fields_by_name["option"].message_type = _SETOPTION
+_SETTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_UPDATETEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_UPDATETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_UPDATEPATHSTEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_UPDATEPATHSTEST.fields_by_name["field_paths"].message_type = _FIELDPATH
+_UPDATEPATHSTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_DELETETEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_DELETETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_SETOPTION.fields_by_name["fields"].message_type = _FIELDPATH
+_QUERYTEST.fields_by_name["clauses"].message_type = _CLAUSE
+_QUERYTEST.fields_by_name[
+    "query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_CLAUSE.fields_by_name["select"].message_type = _SELECT
+_CLAUSE.fields_by_name["where"].message_type = _WHERE
+_CLAUSE.fields_by_name["order_by"].message_type = _ORDERBY
+_CLAUSE.fields_by_name["start_at"].message_type = _CURSOR
+_CLAUSE.fields_by_name["start_after"].message_type = _CURSOR
+_CLAUSE.fields_by_name["end_at"].message_type = _CURSOR
+_CLAUSE.fields_by_name["end_before"].message_type = _CURSOR
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["select"])
+_CLAUSE.fields_by_name["select"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["where"])
+_CLAUSE.fields_by_name["where"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["order_by"])
+_CLAUSE.fields_by_name["order_by"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["offset"])
+_CLAUSE.fields_by_name["offset"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["limit"])
+_CLAUSE.fields_by_name["limit"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["start_at"])
+_CLAUSE.fields_by_name["start_at"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["start_after"])
+_CLAUSE.fields_by_name["start_after"].containing_oneof = _CLAUSE.oneofs_by_name[
+    "clause"
+]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["end_at"])
+_CLAUSE.fields_by_name["end_at"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["end_before"])
+_CLAUSE.fields_by_name["end_before"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_SELECT.fields_by_name["fields"].message_type = _FIELDPATH
+_WHERE.fields_by_name["path"].message_type = _FIELDPATH
+_ORDERBY.fields_by_name["path"].message_type = _FIELDPATH
+_CURSOR.fields_by_name["doc_snapshot"].message_type = _DOCSNAPSHOT
+_LISTENTEST.fields_by_name[
+    "responses"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_firestore__pb2._LISTENRESPONSE
+)
+_LISTENTEST.fields_by_name["snapshots"].message_type = _SNAPSHOT
+_SNAPSHOT.fields_by_name[
+    "docs"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_SNAPSHOT.fields_by_name["changes"].message_type = _DOCCHANGE
+_SNAPSHOT.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCCHANGE.fields_by_name["kind"].enum_type = _DOCCHANGE_KIND
+_DOCCHANGE.fields_by_name[
+    "doc"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_DOCCHANGE_KIND.containing_type = _DOCCHANGE
+DESCRIPTOR.message_types_by_name["TestFile"] = _TESTFILE
+DESCRIPTOR.message_types_by_name["Test"] = _TEST
+DESCRIPTOR.message_types_by_name["GetTest"] = _GETTEST
+DESCRIPTOR.message_types_by_name["CreateTest"] = _CREATETEST
+DESCRIPTOR.message_types_by_name["SetTest"] = _SETTEST
+DESCRIPTOR.message_types_by_name["UpdateTest"] = _UPDATETEST
+DESCRIPTOR.message_types_by_name["UpdatePathsTest"] = _UPDATEPATHSTEST
+DESCRIPTOR.message_types_by_name["DeleteTest"] = _DELETETEST
+DESCRIPTOR.message_types_by_name["SetOption"] = _SETOPTION
+DESCRIPTOR.message_types_by_name["QueryTest"] = _QUERYTEST
+DESCRIPTOR.message_types_by_name["Clause"] = _CLAUSE
+DESCRIPTOR.message_types_by_name["Select"] = _SELECT
+DESCRIPTOR.message_types_by_name["Where"] = _WHERE
+DESCRIPTOR.message_types_by_name["OrderBy"] = _ORDERBY
+DESCRIPTOR.message_types_by_name["Cursor"] = _CURSOR
+DESCRIPTOR.message_types_by_name["DocSnapshot"] = _DOCSNAPSHOT
+DESCRIPTOR.message_types_by_name["FieldPath"] = _FIELDPATH
+DESCRIPTOR.message_types_by_name["ListenTest"] = _LISTENTEST
+DESCRIPTOR.message_types_by_name["Snapshot"] = _SNAPSHOT
+DESCRIPTOR.message_types_by_name["DocChange"] = _DOCCHANGE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TestFile = _reflection.GeneratedProtocolMessageType(
+    "TestFile",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TESTFILE,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.TestFile)
+    ),
+)
+_sym_db.RegisterMessage(TestFile)
+
+Test = _reflection.GeneratedProtocolMessageType(
+    "Test",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.Test)
+    ),
+)
+_sym_db.RegisterMessage(Test)
+
+GetTest = _reflection.GeneratedProtocolMessageType(
+    "GetTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.GetTest)
+    ),
+)
+_sym_db.RegisterMessage(GetTest)
+
+CreateTest = _reflection.GeneratedProtocolMessageType(
+    "CreateTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.CreateTest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTest)
+
+SetTest = _reflection.GeneratedProtocolMessageType(
+    "SetTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETTEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.SetTest)
+    ),
+)
+_sym_db.RegisterMessage(SetTest)
+
+UpdateTest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.UpdateTest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTest)
+
+UpdatePathsTest = _reflection.GeneratedProtocolMessageType(
+    "UpdatePathsTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPATHSTEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.UpdatePathsTest)
+    ),
+)
+_sym_db.RegisterMessage(UpdatePathsTest)
+
+DeleteTest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.DeleteTest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTest)
+
+SetOption = _reflection.GeneratedProtocolMessageType(
+    "SetOption",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETOPTION,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.SetOption)
+    ),
+)
+_sym_db.RegisterMessage(SetOption)
+
+QueryTest = _reflection.GeneratedProtocolMessageType(
+    "QueryTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYTEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.QueryTest)
+    ),
+)
+_sym_db.RegisterMessage(QueryTest)
+
+Clause = _reflection.GeneratedProtocolMessageType(
+    "Clause",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLAUSE,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.Clause)
+    ),
+)
+_sym_db.RegisterMessage(Clause)
+
+Select = _reflection.GeneratedProtocolMessageType(
+    "Select",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SELECT,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.Select)
+    ),
+)
+_sym_db.RegisterMessage(Select)
+
+Where = _reflection.GeneratedProtocolMessageType(
+    "Where",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WHERE,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.Where)
+    ),
+)
+_sym_db.RegisterMessage(Where)
+
+OrderBy = _reflection.GeneratedProtocolMessageType(
+    "OrderBy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ORDERBY,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.OrderBy)
+    ),
+)
+_sym_db.RegisterMessage(OrderBy)
+
+Cursor = _reflection.GeneratedProtocolMessageType(
+    "Cursor",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CURSOR,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.Cursor)
+    ),
+)
+_sym_db.RegisterMessage(Cursor)
+
+DocSnapshot = _reflection.GeneratedProtocolMessageType(
+    "DocSnapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCSNAPSHOT,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.DocSnapshot)
+    ),
+)
+_sym_db.RegisterMessage(DocSnapshot)
+
+FieldPath = _reflection.GeneratedProtocolMessageType(
+    "FieldPath",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FIELDPATH,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.FieldPath)
+    ),
+)
+_sym_db.RegisterMessage(FieldPath)
+
+ListenTest = _reflection.GeneratedProtocolMessageType(
+    "ListenTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTENTEST,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.ListenTest)
+    ),
+)
+_sym_db.RegisterMessage(ListenTest)
+
+Snapshot = _reflection.GeneratedProtocolMessageType(
+    "Snapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SNAPSHOT,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.Snapshot)
+    ),
+)
+_sym_db.RegisterMessage(Snapshot)
+
+DocChange = _reflection.GeneratedProtocolMessageType(
+    "DocChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCCHANGE,
+        __module__="google.cloud.firestore_v1.proto.tests_pb2"
+        # @@protoc_insertion_point(class_scope:google.cloud.firestore_v1.proto.DocChange)
+    ),
+)
+_sym_db.RegisterMessage(DocChange)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        '\n)com.google.cloud.conformance.firestore.v1B\016TestDefinition\252\002"Google.Cloud.Firestore.Tests.Proto\312\002(Google\\Cloud\\Firestore\\Tests\\Conformance'
+    ),
+)
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/write.proto b/firestore/google/cloud/firestore_v1/proto/write.proto
new file mode 100644
index 000000000000..4ab5d833e3b9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/write.proto
@@ -0,0 +1,255 @@
+// 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.firestore.v1;
+
+import "google/firestore/v1/common.proto";
+import "google/firestore/v1/document.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "WriteProto";
+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.
+  oneof operation {
+    // A document to write.
+    Document update = 1;
+
+    // A document name to delete. In the format:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    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;
+  }
+
+  // The fields to update in this write.
+  //
+  // This field can be set only when the operation is `update`.
+  // If the mask is not set for an `update` and the document exists, any
+  // existing data will be overwritten.
+  // If the mask is set and the document on the server has fields not covered by
+  // the mask, they are left unchanged.
+  // Fields referenced in the mask, but not present in the input document, are
+  // deleted from the document on the server.
+  // The field paths in this mask must not contain a reserved field name.
+  DocumentMask update_mask = 3;
+
+  // An optional precondition on the document.
+  //
+  // The write will fail if this is set and not met by the target document.
+  Precondition current_document = 4;
+}
+
+// A transformation of a document.
+message DocumentTransform {
+  // A transformation of a field of the document.
+  message FieldTransform {
+    // A value that is calculated by the server.
+    enum ServerValue {
+      // Unspecified. This value must not be used.
+      SERVER_VALUE_UNSPECIFIED = 0;
+
+      // The time at which the server processed the request, with millisecond
+      // precision.
+      REQUEST_TIME = 1;
+    }
+
+    // The path of the field. See [Document.fields][google.firestore.v1.Document.fields] for the field path syntax
+    // reference.
+    string field_path = 1;
+
+    // The transformation to apply on the field.
+    oneof transform_type {
+      // Sets the field to the given server value.
+      ServerValue set_to_server_value = 2;
+
+      // Adds the given value to the field's current value.
+      //
+      // This must be an integer or a double value.
+      // If the field is not an integer or double, or if the field does not yet
+      // exist, the transformation will set the field to the given value.
+      // If either of the given value or the current field value are doubles,
+      // both values will be interpreted as doubles. Double arithmetic and
+      // representation of double values follow IEEE 754 semantics.
+      // If there is positive/negative integer overflow, the field is resolved
+      // to the largest magnitude positive/negative integer.
+      Value increment = 3;
+
+      // Sets the field to the maximum of its current value and the given value.
+      //
+      // This must be an integer or a double value.
+      // If the field is not an integer or double, or if the field does not yet
+      // exist, the transformation will set the field to the given value.
+      // If a maximum operation is applied where the field and the input value
+      // are of mixed types (that is - one is an integer and one is a double)
+      // the field takes on the type of the larger operand. If the operands are
+      // equivalent (e.g. 3 and 3.0), the field does not change.
+      // 0, 0.0, and -0.0 are all zero. The maximum of a zero stored value and
+      // zero input value is always the stored value.
+      // The maximum of any numeric value x and NaN is NaN.
+      Value maximum = 4;
+
+      // Sets the field to the minimum of its current value and the given value.
+      //
+      // This must be an integer or a double value.
+      // If the field is not an integer or double, or if the field does not yet
+      // exist, the transformation will set the field to the input value.
+      // If a minimum operation is applied where the field and the input value
+      // are of mixed types (that is - one is an integer and one is a double)
+      // the field takes on the type of the smaller operand. If the operands are
+      // equivalent (e.g. 3 and 3.0), the field does not change.
+      // 0, 0.0, and -0.0 are all zero. The minimum of a zero stored value and
+      // zero input value is always the stored value.
+      // The minimum of any numeric value x and NaN is NaN.
+      Value minimum = 5;
+
+      // Append the given elements in order if they are not already present in
+      // the current field value.
+      // If the field is not an array, or if the field does not yet exist, it is
+      // first set to the empty array.
+      //
+      // Equivalent numbers of different types (e.g. 3L and 3.0) are
+      // considered equal when checking if a value is missing.
+      // NaN is equal to NaN, and Null is equal to Null.
+      // If the input contains multiple equivalent values, only the first will
+      // be considered.
+      //
+      // The corresponding transform_result will be the null value.
+      ArrayValue append_missing_elements = 6;
+
+      // Remove all of the given elements from the array in the field.
+      // If the field is not an array, or if the field does not yet exist, it is
+      // set to the empty array.
+      //
+      // Equivalent numbers of the different types (e.g. 3L and 3.0) are
+      // considered equal when deciding whether an element should be removed.
+      // NaN is equal to NaN, and Null is equal to Null.
+      // This will remove all equivalent values if there are duplicates.
+      //
+      // The corresponding transform_result will be the null value.
+      ArrayValue remove_all_from_array = 7;
+    }
+  }
+
+  // The name of the document to transform.
+  string document = 1;
+
+  // The list of transformations to apply to the fields of the document, in
+  // order.
+  // This must not be empty.
+  repeated FieldTransform field_transforms = 2;
+}
+
+// The result of applying a write.
+message WriteResult {
+  // The last update time of the document after applying the write. Not set
+  // after a `delete`.
+  //
+  // If the write did not actually change the document, this will be the
+  // previous update_time.
+  google.protobuf.Timestamp update_time = 1;
+
+  // The results of applying each [DocumentTransform.FieldTransform][google.firestore.v1.DocumentTransform.FieldTransform], in the
+  // same order.
+  repeated Value transform_results = 2;
+}
+
+// A [Document][google.firestore.v1.Document] has changed.
+//
+// May be the result of multiple [writes][google.firestore.v1.Write], including deletes, that
+// ultimately resulted in a new value for the [Document][google.firestore.v1.Document].
+//
+// Multiple [DocumentChange][google.firestore.v1.DocumentChange] messages may be returned for the same logical
+// change, if multiple targets are affected.
+message DocumentChange {
+  // The new state of the [Document][google.firestore.v1.Document].
+  //
+  // If `mask` is set, contains only fields that were updated or added.
+  Document document = 1;
+
+  // A set of target IDs of targets that match this document.
+  repeated int32 target_ids = 5;
+
+  // A set of target IDs for targets that no longer match this document.
+  repeated int32 removed_target_ids = 6;
+}
+
+// A [Document][google.firestore.v1.Document] has been deleted.
+//
+// May be the result of multiple [writes][google.firestore.v1.Write], including updates, the
+// last of which deleted the [Document][google.firestore.v1.Document].
+//
+// Multiple [DocumentDelete][google.firestore.v1.DocumentDelete] messages may be returned for the same logical
+// delete, if multiple targets are affected.
+message DocumentDelete {
+  // The resource name of the [Document][google.firestore.v1.Document] that was deleted.
+  string document = 1;
+
+  // A set of target IDs for targets that previously matched this entity.
+  repeated int32 removed_target_ids = 6;
+
+  // The read timestamp at which the delete was observed.
+  //
+  // Greater or equal to the `commit_time` of the delete.
+  google.protobuf.Timestamp read_time = 4;
+}
+
+// A [Document][google.firestore.v1.Document] has been removed from the view of the targets.
+//
+// Sent if the document is no longer relevant to a target and is out of view.
+// Can be sent instead of a DocumentDelete or a DocumentChange if the server
+// can not send the new value of the document.
+//
+// Multiple [DocumentRemove][google.firestore.v1.DocumentRemove] messages may be returned for the same logical
+// write or delete, if multiple targets are affected.
+message DocumentRemove {
+  // The resource name of the [Document][google.firestore.v1.Document] that has gone out of view.
+  string document = 1;
+
+  // A set of target IDs for targets that previously matched this document.
+  repeated int32 removed_target_ids = 2;
+
+  // The read timestamp at which the remove was observed.
+  //
+  // Greater or equal to the `commit_time` of the change/delete/remove.
+  google.protobuf.Timestamp read_time = 4;
+}
+
+// A digest of all the documents that match a given target.
+message ExistenceFilter {
+  // The target ID to which this filter applies.
+  int32 target_id = 1;
+
+  // The total count of documents that match [target_id][google.firestore.v1.ExistenceFilter.target_id].
+  //
+  // If different from the count of documents in the client that match, the
+  // client must manually determine which documents no longer match the target.
+  int32 count = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1/proto/write_pb2.py b/firestore/google/cloud/firestore_v1/proto/write_pb2.py
new file mode 100644
index 000000000000..00ebb1c25139
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/write_pb2.py
@@ -0,0 +1,1145 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1/proto/write.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1/proto/write.proto",
+    package="google.firestore.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.firestore.v1B\nWriteProtoP\001Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\242\002\004GCFS\252\002\031Google.Cloud.Firestore.V1\312\002\031Google\\Cloud\\Firestore\\V1"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/firestore_v1/proto/write.proto\x12\x13google.firestore.v1\x1a,google/cloud/firestore_v1/proto/common.proto\x1a.google/cloud/firestore_v1/proto/document.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\x89\x02\n\x05Write\x12/\n\x06update\x18\x01 \x01(\x0b\x32\x1d.google.firestore.v1.DocumentH\x00\x12\x10\n\x06\x64\x65lete\x18\x02 \x01(\tH\x00\x12;\n\ttransform\x18\x06 \x01(\x0b\x32&.google.firestore.v1.DocumentTransformH\x00\x12\x36\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32!.google.firestore.v1.DocumentMask\x12;\n\x10\x63urrent_document\x18\x04 \x01(\x0b\x32!.google.firestore.v1.PreconditionB\x0b\n\toperation"\xe5\x04\n\x11\x44ocumentTransform\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12O\n\x10\x66ield_transforms\x18\x02 \x03(\x0b\x32\x35.google.firestore.v1.DocumentTransform.FieldTransform\x1a\xec\x03\n\x0e\x46ieldTransform\x12\x12\n\nfield_path\x18\x01 \x01(\t\x12`\n\x13set_to_server_value\x18\x02 \x01(\x0e\x32\x41.google.firestore.v1.DocumentTransform.FieldTransform.ServerValueH\x00\x12/\n\tincrement\x18\x03 \x01(\x0b\x32\x1a.google.firestore.v1.ValueH\x00\x12-\n\x07maximum\x18\x04 \x01(\x0b\x32\x1a.google.firestore.v1.ValueH\x00\x12-\n\x07minimum\x18\x05 \x01(\x0b\x32\x1a.google.firestore.v1.ValueH\x00\x12\x42\n\x17\x61ppend_missing_elements\x18\x06 \x01(\x0b\x32\x1f.google.firestore.v1.ArrayValueH\x00\x12@\n\x15remove_all_from_array\x18\x07 \x01(\x0b\x32\x1f.google.firestore.v1.ArrayValueH\x00"=\n\x0bServerValue\x12\x1c\n\x18SERVER_VALUE_UNSPECIFIED\x10\x00\x12\x10\n\x0cREQUEST_TIME\x10\x01\x42\x10\n\x0etransform_type"u\n\x0bWriteResult\x12/\n\x0bupdate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11transform_results\x18\x02 \x03(\x0b\x32\x1a.google.firestore.v1.Value"q\n\x0e\x44ocumentChange\x12/\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\x1d.google.firestore.v1.Document\x12\x12\n\ntarget_ids\x18\x05 \x03(\x05\x12\x1a\n\x12removed_target_ids\x18\x06 \x03(\x05"m\n\x0e\x44ocumentDelete\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12\x1a\n\x12removed_target_ids\x18\x06 \x03(\x05\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"m\n\x0e\x44ocumentRemove\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12\x1a\n\x12removed_target_ids\x18\x02 \x03(\x05\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"3\n\x0f\x45xistenceFilter\x12\x11\n\ttarget_id\x18\x01 \x01(\x05\x12\r\n\x05\x63ount\x18\x02 \x01(\x05\x42\xa4\x01\n\x17\x63om.google.firestore.v1B\nWriteProtoP\x01Z<google.golang.org/genproto/googleapis/firestore/v1;firestore\xa2\x02\x04GCFS\xaa\x02\x19Google.Cloud.Firestore.V1\xca\x02\x19Google\\Cloud\\Firestore\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE = _descriptor.EnumDescriptor(
+    name="ServerValue",
+    full_name="google.firestore.v1.DocumentTransform.FieldTransform.ServerValue",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SERVER_VALUE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REQUEST_TIME", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1028,
+    serialized_end=1089,
+)
+_sym_db.RegisterEnumDescriptor(_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE)
+
+
+_WRITE = _descriptor.Descriptor(
+    name="Write",
+    full_name="google.firestore.v1.Write",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.firestore.v1.Write.update",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="google.firestore.v1.Write.delete",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transform",
+            full_name="google.firestore.v1.Write.transform",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.firestore.v1.Write.update_mask",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_document",
+            full_name="google.firestore.v1.Write.current_document",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="operation",
+            full_name="google.firestore.v1.Write.operation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=226,
+    serialized_end=491,
+)
+
+
+_DOCUMENTTRANSFORM_FIELDTRANSFORM = _descriptor.Descriptor(
+    name="FieldTransform",
+    full_name="google.firestore.v1.DocumentTransform.FieldTransform",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_path",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.field_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="set_to_server_value",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.set_to_server_value",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="increment",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.increment",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maximum",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.maximum",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="minimum",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.minimum",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="append_missing_elements",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.append_missing_elements",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remove_all_from_array",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.remove_all_from_array",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transform_type",
+            full_name="google.firestore.v1.DocumentTransform.FieldTransform.transform_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=615,
+    serialized_end=1107,
+)
+
+_DOCUMENTTRANSFORM = _descriptor.Descriptor(
+    name="DocumentTransform",
+    full_name="google.firestore.v1.DocumentTransform",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.DocumentTransform.document",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_transforms",
+            full_name="google.firestore.v1.DocumentTransform.field_transforms",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DOCUMENTTRANSFORM_FIELDTRANSFORM],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=494,
+    serialized_end=1107,
+)
+
+
+_WRITERESULT = _descriptor.Descriptor(
+    name="WriteResult",
+    full_name="google.firestore.v1.WriteResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.firestore.v1.WriteResult.update_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transform_results",
+            full_name="google.firestore.v1.WriteResult.transform_results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1109,
+    serialized_end=1226,
+)
+
+
+_DOCUMENTCHANGE = _descriptor.Descriptor(
+    name="DocumentChange",
+    full_name="google.firestore.v1.DocumentChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.DocumentChange.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_ids",
+            full_name="google.firestore.v1.DocumentChange.target_ids",
+            index=1,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removed_target_ids",
+            full_name="google.firestore.v1.DocumentChange.removed_target_ids",
+            index=2,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1228,
+    serialized_end=1341,
+)
+
+
+_DOCUMENTDELETE = _descriptor.Descriptor(
+    name="DocumentDelete",
+    full_name="google.firestore.v1.DocumentDelete",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.DocumentDelete.document",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removed_target_ids",
+            full_name="google.firestore.v1.DocumentDelete.removed_target_ids",
+            index=1,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.DocumentDelete.read_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1343,
+    serialized_end=1452,
+)
+
+
+_DOCUMENTREMOVE = _descriptor.Descriptor(
+    name="DocumentRemove",
+    full_name="google.firestore.v1.DocumentRemove",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1.DocumentRemove.document",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removed_target_ids",
+            full_name="google.firestore.v1.DocumentRemove.removed_target_ids",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1.DocumentRemove.read_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1454,
+    serialized_end=1563,
+)
+
+
+_EXISTENCEFILTER = _descriptor.Descriptor(
+    name="ExistenceFilter",
+    full_name="google.firestore.v1.ExistenceFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_id",
+            full_name="google.firestore.v1.ExistenceFilter.target_id",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.firestore.v1.ExistenceFilter.count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1565,
+    serialized_end=1616,
+)
+
+_WRITE.fields_by_name[
+    "update"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_WRITE.fields_by_name["transform"].message_type = _DOCUMENTTRANSFORM
+_WRITE.fields_by_name[
+    "update_mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_WRITE.fields_by_name[
+    "current_document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_WRITE.oneofs_by_name["operation"].fields.append(_WRITE.fields_by_name["update"])
+_WRITE.fields_by_name["update"].containing_oneof = _WRITE.oneofs_by_name["operation"]
+_WRITE.oneofs_by_name["operation"].fields.append(_WRITE.fields_by_name["delete"])
+_WRITE.fields_by_name["delete"].containing_oneof = _WRITE.oneofs_by_name["operation"]
+_WRITE.oneofs_by_name["operation"].fields.append(_WRITE.fields_by_name["transform"])
+_WRITE.fields_by_name["transform"].containing_oneof = _WRITE.oneofs_by_name["operation"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "set_to_server_value"
+].enum_type = _DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "increment"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._VALUE
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "maximum"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._VALUE
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "minimum"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._VALUE
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "append_missing_elements"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._ARRAYVALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "remove_all_from_array"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._ARRAYVALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.containing_type = _DOCUMENTTRANSFORM
+_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE.containing_type = (
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["set_to_server_value"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "set_to_server_value"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["increment"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "increment"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["maximum"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "maximum"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["minimum"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "minimum"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["append_missing_elements"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "append_missing_elements"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["remove_all_from_array"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "remove_all_from_array"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM.fields_by_name[
+    "field_transforms"
+].message_type = _DOCUMENTTRANSFORM_FIELDTRANSFORM
+_WRITERESULT.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WRITERESULT.fields_by_name[
+    "transform_results"
+].message_type = google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._VALUE
+_DOCUMENTCHANGE.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_DOCUMENTDELETE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCUMENTREMOVE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["Write"] = _WRITE
+DESCRIPTOR.message_types_by_name["DocumentTransform"] = _DOCUMENTTRANSFORM
+DESCRIPTOR.message_types_by_name["WriteResult"] = _WRITERESULT
+DESCRIPTOR.message_types_by_name["DocumentChange"] = _DOCUMENTCHANGE
+DESCRIPTOR.message_types_by_name["DocumentDelete"] = _DOCUMENTDELETE
+DESCRIPTOR.message_types_by_name["DocumentRemove"] = _DOCUMENTREMOVE
+DESCRIPTOR.message_types_by_name["ExistenceFilter"] = _EXISTENCEFILTER
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Write = _reflection.GeneratedProtocolMessageType(
+    "Write",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITE,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""A write on a document.
+  
+  
+  Attributes:
+      operation:
+          The operation to execute.
+      update:
+          A document to write.
+      delete:
+          A document name to delete. In the format: ``projects/{project_
+          id}/databases/{database_id}/documents/{document_path}``.
+      transform:
+          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.
+      update_mask:
+          The fields to update in this write.  This field can be set
+          only when the operation is ``update``. If the mask is not set
+          for an ``update`` and the document exists, any existing data
+          will be overwritten. If the mask is set and the document on
+          the server has fields not covered by the mask, they are left
+          unchanged. Fields referenced in the mask, but not present in
+          the input document, are deleted from the document on the
+          server. The field paths in this mask must not contain a
+          reserved field name.
+      current_document:
+          An optional precondition on the document.  The write will fail
+          if this is set and not met by the target document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.Write)
+    ),
+)
+_sym_db.RegisterMessage(Write)
+
+DocumentTransform = _reflection.GeneratedProtocolMessageType(
+    "DocumentTransform",
+    (_message.Message,),
+    dict(
+        FieldTransform=_reflection.GeneratedProtocolMessageType(
+            "FieldTransform",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DOCUMENTTRANSFORM_FIELDTRANSFORM,
+                __module__="google.cloud.firestore_v1.proto.write_pb2",
+                __doc__="""A transformation of a field of the document.
+    
+    
+    Attributes:
+        field_path:
+            The path of the field. See
+            [Document.fields][google.firestore.v1.Document.fields] for the
+            field path syntax reference.
+        transform_type:
+            The transformation to apply on the field.
+        set_to_server_value:
+            Sets the field to the given server value.
+        increment:
+            Adds the given value to the field's current value.  This must
+            be an integer or a double value. If the field is not an
+            integer or double, or if the field does not yet exist, the
+            transformation will set the field to the given value. If
+            either of the given value or the current field value are
+            doubles, both values will be interpreted as doubles. Double
+            arithmetic and representation of double values follow IEEE 754
+            semantics. If there is positive/negative integer overflow, the
+            field is resolved to the largest magnitude positive/negative
+            integer.
+        maximum:
+            Sets the field to the maximum of its current value and the
+            given value.  This must be an integer or a double value. If
+            the field is not an integer or double, or if the field does
+            not yet exist, the transformation will set the field to the
+            given value. If a maximum operation is applied where the field
+            and the input value are of mixed types (that is - one is an
+            integer and one is a double) the field takes on the type of
+            the larger operand. If the operands are equivalent (e.g. 3 and
+            3.0), the field does not change. 0, 0.0, and -0.0 are all
+            zero. The maximum of a zero stored value and zero input value
+            is always the stored value. The maximum of any numeric value x
+            and NaN is NaN.
+        minimum:
+            Sets the field to the minimum of its current value and the
+            given value.  This must be an integer or a double value. If
+            the field is not an integer or double, or if the field does
+            not yet exist, the transformation will set the field to the
+            input value. If a minimum operation is applied where the field
+            and the input value are of mixed types (that is - one is an
+            integer and one is a double) the field takes on the type of
+            the smaller operand. If the operands are equivalent (e.g. 3
+            and 3.0), the field does not change. 0, 0.0, and -0.0 are all
+            zero. The minimum of a zero stored value and zero input value
+            is always the stored value. The minimum of any numeric value x
+            and NaN is NaN.
+        append_missing_elements:
+            Append the given elements in order if they are not already
+            present in the current field value. If the field is not an
+            array, or if the field does not yet exist, it is first set to
+            the empty array.  Equivalent numbers of different types (e.g.
+            3L and 3.0) are considered equal when checking if a value is
+            missing. NaN is equal to NaN, and Null is equal to Null. If
+            the input contains multiple equivalent values, only the first
+            will be considered.  The corresponding transform\_result will
+            be the null value.
+        remove_all_from_array:
+            Remove all of the given elements from the array in the field.
+            If the field is not an array, or if the field does not yet
+            exist, it is set to the empty array.  Equivalent numbers of
+            the different types (e.g. 3L and 3.0) are considered equal
+            when deciding whether an element should be removed. NaN is
+            equal to NaN, and Null is equal to Null. This will remove all
+            equivalent values if there are duplicates.  The corresponding
+            transform\_result will be the null value.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1.DocumentTransform.FieldTransform)
+            ),
+        ),
+        DESCRIPTOR=_DOCUMENTTRANSFORM,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""A transformation of a document.
+  
+  
+  Attributes:
+      document:
+          The name of the document to transform.
+      field_transforms:
+          The list of transformations to apply to the fields of the
+          document, in order. This must not be empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.DocumentTransform)
+    ),
+)
+_sym_db.RegisterMessage(DocumentTransform)
+_sym_db.RegisterMessage(DocumentTransform.FieldTransform)
+
+WriteResult = _reflection.GeneratedProtocolMessageType(
+    "WriteResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITERESULT,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""The result of applying a write.
+  
+  
+  Attributes:
+      update_time:
+          The last update time of the document after applying the write.
+          Not set after a ``delete``.  If the write did not actually
+          change the document, this will be the previous update\_time.
+      transform_results:
+          The results of applying each [DocumentTransform.FieldTransform
+          ][google.firestore.v1.DocumentTransform.FieldTransform], in
+          the same order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.WriteResult)
+    ),
+)
+_sym_db.RegisterMessage(WriteResult)
+
+DocumentChange = _reflection.GeneratedProtocolMessageType(
+    "DocumentChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTCHANGE,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""A [Document][google.firestore.v1.Document] has changed.
+  
+  May be the result of multiple [writes][google.firestore.v1.Write],
+  including deletes, that ultimately resulted in a new value for the
+  [Document][google.firestore.v1.Document].
+  
+  Multiple [DocumentChange][google.firestore.v1.DocumentChange] messages
+  may be returned for the same logical change, if multiple targets are
+  affected.
+  
+  
+  Attributes:
+      document:
+          The new state of the [Document][google.firestore.v1.Document].
+          If ``mask`` is set, contains only fields that were updated or
+          added.
+      target_ids:
+          A set of target IDs of targets that match this document.
+      removed_target_ids:
+          A set of target IDs for targets that no longer match this
+          document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.DocumentChange)
+    ),
+)
+_sym_db.RegisterMessage(DocumentChange)
+
+DocumentDelete = _reflection.GeneratedProtocolMessageType(
+    "DocumentDelete",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTDELETE,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""A [Document][google.firestore.v1.Document] has been deleted.
+  
+  May be the result of multiple [writes][google.firestore.v1.Write],
+  including updates, the last of which deleted the
+  [Document][google.firestore.v1.Document].
+  
+  Multiple [DocumentDelete][google.firestore.v1.DocumentDelete] messages
+  may be returned for the same logical delete, if multiple targets are
+  affected.
+  
+  
+  Attributes:
+      document:
+          The resource name of the
+          [Document][google.firestore.v1.Document] that was deleted.
+      removed_target_ids:
+          A set of target IDs for targets that previously matched this
+          entity.
+      read_time:
+          The read timestamp at which the delete was observed.  Greater
+          or equal to the ``commit_time`` of the delete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.DocumentDelete)
+    ),
+)
+_sym_db.RegisterMessage(DocumentDelete)
+
+DocumentRemove = _reflection.GeneratedProtocolMessageType(
+    "DocumentRemove",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTREMOVE,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""A [Document][google.firestore.v1.Document] has been removed from the
+  view of the targets.
+  
+  Sent if the document is no longer relevant to a target and is out of
+  view. Can be sent instead of a DocumentDelete or a DocumentChange if the
+  server can not send the new value of the document.
+  
+  Multiple [DocumentRemove][google.firestore.v1.DocumentRemove] messages
+  may be returned for the same logical write or delete, if multiple
+  targets are affected.
+  
+  
+  Attributes:
+      document:
+          The resource name of the
+          [Document][google.firestore.v1.Document] that has gone out of
+          view.
+      removed_target_ids:
+          A set of target IDs for targets that previously matched this
+          document.
+      read_time:
+          The read timestamp at which the remove was observed.  Greater
+          or equal to the ``commit_time`` of the change/delete/remove.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.DocumentRemove)
+    ),
+)
+_sym_db.RegisterMessage(DocumentRemove)
+
+ExistenceFilter = _reflection.GeneratedProtocolMessageType(
+    "ExistenceFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXISTENCEFILTER,
+        __module__="google.cloud.firestore_v1.proto.write_pb2",
+        __doc__="""A digest of all the documents that match a given target.
+  
+  
+  Attributes:
+      target_id:
+          The target ID to which this filter applies.
+      count:
+          The total count of documents that match
+          [target\_id][google.firestore.v1.ExistenceFilter.target\_id].
+          If different from the count of documents in the client that
+          match, the client must manually determine which documents no
+          longer match the target.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1.ExistenceFilter)
+    ),
+)
+_sym_db.RegisterMessage(ExistenceFilter)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1/proto/write_pb2_grpc.py b/firestore/google/cloud/firestore_v1/proto/write_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/proto/write_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1/query.py b/firestore/google/cloud/firestore_v1/query.py
new file mode 100644
index 000000000000..6f4c498c0725
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/query.py
@@ -0,0 +1,1039 @@
+# Copyright 2017 Google LLC 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.
+
+"""Classes for representing queries for the Google Cloud Firestore API.
+
+A :class:`~google.cloud.firestore_v1.query.Query` can be created directly from
+a :class:`~google.cloud.firestore_v1.collection.Collection` and that can be
+a more common way to create a query than direct usage of the constructor.
+"""
+import copy
+import math
+import warnings
+
+from google.protobuf import wrappers_pb2
+import six
+
+from google.cloud.firestore_v1 import _helpers
+from google.cloud.firestore_v1 import document
+from google.cloud.firestore_v1 import field_path as field_path_module
+from google.cloud.firestore_v1 import transforms
+from google.cloud.firestore_v1.gapic import enums
+from google.cloud.firestore_v1.proto import query_pb2
+from google.cloud.firestore_v1.order import Order
+from google.cloud.firestore_v1.watch import Watch
+
+_EQ_OP = "=="
+_operator_enum = enums.StructuredQuery.FieldFilter.Operator
+_COMPARISON_OPERATORS = {
+    "<": _operator_enum.LESS_THAN,
+    "<=": _operator_enum.LESS_THAN_OR_EQUAL,
+    _EQ_OP: _operator_enum.EQUAL,
+    ">=": _operator_enum.GREATER_THAN_OR_EQUAL,
+    ">": _operator_enum.GREATER_THAN,
+    "array_contains": _operator_enum.ARRAY_CONTAINS,
+}
+_BAD_OP_STRING = "Operator string {!r} is invalid. Valid choices are: {}."
+_BAD_OP_NAN_NULL = 'Only an equality filter ("==") can be used with None or NaN values'
+_INVALID_WHERE_TRANSFORM = "Transforms cannot be used as where values."
+_BAD_DIR_STRING = "Invalid direction {!r}. Must be one of {!r} or {!r}."
+_INVALID_CURSOR_TRANSFORM = "Transforms cannot be used as cursor values."
+_MISSING_ORDER_BY = (
+    'The "order by" field path {!r} is not present in the cursor data {!r}. '
+    "All fields sent to ``order_by()`` must be present in the fields "
+    "if passed to one of ``start_at()`` / ``start_after()`` / "
+    "``end_before()`` / ``end_at()`` to define a cursor."
+)
+_NO_ORDERS_FOR_CURSOR = (
+    "Attempting to create a cursor with no fields to order on. "
+    "When defining a cursor with one of ``start_at()`` / ``start_after()`` / "
+    "``end_before()`` / ``end_at()``, all fields in the cursor must "
+    "come from fields set in ``order_by()``."
+)
+_MISMATCH_CURSOR_W_ORDER_BY = "The cursor {!r} does not match the order fields {!r}."
+
+
+class Query(object):
+    """Represents a query to the Firestore API.
+
+    Instances of this class are considered immutable: all methods that
+    would modify an instance instead return a new instance.
+
+    Args:
+        parent (:class:`~google.cloud.firestore_v1.collection.CollectionReference`):
+            The collection that this query applies to.
+        projection (Optional[:class:`google.cloud.proto.firestore.v1.\
+            query_pb2.StructuredQuery.Projection`]):
+            A projection of document fields to limit the query results to.
+        field_filters (Optional[Tuple[:class:`google.cloud.proto.firestore.v1.\
+            query_pb2.StructuredQuery.FieldFilter`, ...]]):
+            The filters to be applied in the query.
+        orders (Optional[Tuple[:class:`google.cloud.proto.firestore.v1.\
+            query_pb2.StructuredQuery.Order`, ...]]):
+            The "order by" entries to use in the query.
+        limit (Optional[int]):
+            The maximum number of documents the query is allowed to return.
+        offset (Optional[int]):
+            The number of results to skip.
+        start_at (Optional[Tuple[dict, bool]]):
+            Two-tuple of :
+
+            * a mapping of fields. Any field that is present in this mapping
+              must also be present in ``orders``
+            * an ``after`` flag
+
+            The fields and the flag combine to form a cursor used as
+            a starting point in a query result set. If the ``after``
+            flag is :data:`True`, the results will start just after any
+            documents which have fields matching the cursor, otherwise
+            any matching documents will be included in the result set.
+            When the query is formed, the document values
+            will be used in the order given by ``orders``.
+        end_at (Optional[Tuple[dict, bool]]):
+            Two-tuple of:
+
+            * a mapping of fields. Any field that is present in this mapping
+              must also be present in ``orders``
+            * a ``before`` flag
+
+            The fields and the flag combine to form a cursor used as
+            an ending point in a query result set. If the ``before``
+            flag is :data:`True`, the results will end just before any
+            documents which have fields matching the cursor, otherwise
+            any matching documents will be included in the result set.
+            When the query is formed, the document values
+            will be used in the order given by ``orders``.
+        all_descendants (Optional[bool]):
+            When false, selects only collections that are immediate children
+            of the `parent` specified in the containing `RunQueryRequest`.
+            When true, selects all descendant collections.
+    """
+
+    ASCENDING = "ASCENDING"
+    """str: Sort query results in ascending order on a field."""
+    DESCENDING = "DESCENDING"
+    """str: Sort query results in descending order on a field."""
+
+    def __init__(
+        self,
+        parent,
+        projection=None,
+        field_filters=(),
+        orders=(),
+        limit=None,
+        offset=None,
+        start_at=None,
+        end_at=None,
+        all_descendants=False,
+    ):
+        self._parent = parent
+        self._projection = projection
+        self._field_filters = field_filters
+        self._orders = orders
+        self._limit = limit
+        self._offset = offset
+        self._start_at = start_at
+        self._end_at = end_at
+        self._all_descendants = all_descendants
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (
+            self._parent == other._parent
+            and self._projection == other._projection
+            and self._field_filters == other._field_filters
+            and self._orders == other._orders
+            and self._limit == other._limit
+            and self._offset == other._offset
+            and self._start_at == other._start_at
+            and self._end_at == other._end_at
+            and self._all_descendants == other._all_descendants
+        )
+
+    @property
+    def _client(self):
+        """The client of the parent collection.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.client.Client`:
+            The client that owns this query.
+        """
+        return self._parent._client
+
+    def select(self, field_paths):
+        """Project documents matching query to a limited set of fields.
+
+        See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+        more information on **field paths**.
+
+        If the current query already has a projection set (i.e. has already
+        called :meth:`~google.cloud.firestore_v1.query.Query.select`), this
+        will overwrite it.
+
+        Args:
+            field_paths (Iterable[str, ...]): An iterable of field paths
+                (``.``-delimited list of field names) to use as a projection
+                of document fields in the query results.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A "projected" query. Acts as a copy of the current query,
+            modified with the newly added projection.
+        Raises:
+            ValueError: If any ``field_path`` is invalid.
+        """
+        field_paths = list(field_paths)
+        for field_path in field_paths:
+            field_path_module.split_field_path(field_path)  # raises
+
+        new_projection = query_pb2.StructuredQuery.Projection(
+            fields=[
+                query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                for field_path in field_paths
+            ]
+        )
+        return self.__class__(
+            self._parent,
+            projection=new_projection,
+            field_filters=self._field_filters,
+            orders=self._orders,
+            limit=self._limit,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+            all_descendants=self._all_descendants,
+        )
+
+    def where(self, field_path, op_string, value):
+        """Filter the query on a field.
+
+        See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+        more information on **field paths**.
+
+        Returns a new :class:`~google.cloud.firestore_v1.query.Query` that
+        filters on a specific field path, according to an operation (e.g.
+        ``==`` or "equals") and a particular value to be paired with that
+        operation.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) for the field to filter on.
+            op_string (str): A comparison operation in the form of a string.
+                Acceptable values are ``<``, ``<=``, ``==``, ``>=``
+                and ``>``.
+            value (Any): The value to compare the field against in the filter.
+                If ``value`` is :data:`None` or a NaN, then ``==`` is the only
+                allowed operation.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A filtered query. Acts as a copy of the current query,
+            modified with the newly added filter.
+
+        Raises:
+            ValueError: If ``field_path`` is invalid.
+            ValueError: If ``value`` is a NaN or :data:`None` and
+                ``op_string`` is not ``==``.
+        """
+        field_path_module.split_field_path(field_path)  # raises
+
+        if value is None:
+            if op_string != _EQ_OP:
+                raise ValueError(_BAD_OP_NAN_NULL)
+            filter_pb = query_pb2.StructuredQuery.UnaryFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+                op=enums.StructuredQuery.UnaryFilter.Operator.IS_NULL,
+            )
+        elif _isnan(value):
+            if op_string != _EQ_OP:
+                raise ValueError(_BAD_OP_NAN_NULL)
+            filter_pb = query_pb2.StructuredQuery.UnaryFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+                op=enums.StructuredQuery.UnaryFilter.Operator.IS_NAN,
+            )
+        elif isinstance(value, (transforms.Sentinel, transforms._ValueList)):
+            raise ValueError(_INVALID_WHERE_TRANSFORM)
+        else:
+            filter_pb = query_pb2.StructuredQuery.FieldFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+                op=_enum_from_op_string(op_string),
+                value=_helpers.encode_value(value),
+            )
+
+        new_filters = self._field_filters + (filter_pb,)
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=new_filters,
+            orders=self._orders,
+            limit=self._limit,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+            all_descendants=self._all_descendants,
+        )
+
+    @staticmethod
+    def _make_order(field_path, direction):
+        """Helper for :meth:`order_by`."""
+        return query_pb2.StructuredQuery.Order(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            direction=_enum_from_direction(direction),
+        )
+
+    def order_by(self, field_path, direction=ASCENDING):
+        """Modify the query to add an order clause on a specific field.
+
+        See :meth:`~google.cloud.firestore_v1.client.Client.field_path` for
+        more information on **field paths**.
+
+        Successive :meth:`~google.cloud.firestore_v1.query.Query.order_by`
+        calls will further refine the ordering of results returned by the query
+        (i.e. the new "order by" fields will be added to existing ones).
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) on which to order the query results.
+            direction (Optional[str]): The direction to order by. Must be one
+                of :attr:`ASCENDING` or :attr:`DESCENDING`, defaults to
+                :attr:`ASCENDING`.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            An ordered query. Acts as a copy of the current query, modified
+            with the newly added "order by" constraint.
+
+        Raises:
+            ValueError: If ``field_path`` is invalid.
+            ValueError: If ``direction`` is not one of :attr:`ASCENDING` or
+                :attr:`DESCENDING`.
+        """
+        field_path_module.split_field_path(field_path)  # raises
+
+        order_pb = self._make_order(field_path, direction)
+
+        new_orders = self._orders + (order_pb,)
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=self._field_filters,
+            orders=new_orders,
+            limit=self._limit,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+            all_descendants=self._all_descendants,
+        )
+
+    def limit(self, count):
+        """Limit a query to return a fixed number of results.
+
+        If the current query already has a limit set, this will overwrite it.
+
+        Args:
+            count (int): Maximum number of documents to return that match
+                the query.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A limited query. Acts as a copy of the current query, modified
+            with the newly added "limit" filter.
+        """
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=self._field_filters,
+            orders=self._orders,
+            limit=count,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+            all_descendants=self._all_descendants,
+        )
+
+    def offset(self, num_to_skip):
+        """Skip to an offset in a query.
+
+        If the current query already has specified an offset, this will
+        overwrite it.
+
+        Args:
+            num_to_skip (int): The number of results to skip at the beginning
+                of query results. (Must be non-negative.)
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            An offset query. Acts as a copy of the current query, modified
+            with the newly added "offset" field.
+        """
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=self._field_filters,
+            orders=self._orders,
+            limit=self._limit,
+            offset=num_to_skip,
+            start_at=self._start_at,
+            end_at=self._end_at,
+            all_descendants=self._all_descendants,
+        )
+
+    def _check_snapshot(self, document_fields):
+        """Validate local snapshots for non-collection-group queries.
+
+        Raises:
+            ValueError: for non-collection-group queries, if the snapshot
+                is from a different collection.
+        """
+        if self._all_descendants:
+            return
+
+        if document_fields.reference._path[:-1] != self._parent._path:
+            raise ValueError("Cannot use snapshot from another collection as a cursor.")
+
+    def _cursor_helper(self, document_fields, before, start):
+        """Set values to be used for a ``start_at`` or ``end_at`` cursor.
+
+        The values will later be used in a query protobuf.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1.query.Query.order_by`.
+
+        Args:
+            document_fields
+                (Union[:class:`~google.cloud.firestore_v1.document.DocumentSnapshot`, dict, list, tuple]):
+                a document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+            before (bool): Flag indicating if the document in
+                ``document_fields`` should (:data:`False`) or
+                shouldn't (:data:`True`) be included in the result set.
+            start (Optional[bool]): determines if the cursor is a ``start_at``
+                cursor (:data:`True`) or an ``end_at`` cursor (:data:`False`).
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor. Acts as a copy of the current query, modified
+            with the newly added "start at" cursor.
+        """
+        if isinstance(document_fields, tuple):
+            document_fields = list(document_fields)
+        elif isinstance(document_fields, document.DocumentSnapshot):
+            self._check_snapshot(document_fields)
+        else:
+            # NOTE: We copy so that the caller can't modify after calling.
+            document_fields = copy.deepcopy(document_fields)
+
+        cursor_pair = document_fields, before
+        query_kwargs = {
+            "projection": self._projection,
+            "field_filters": self._field_filters,
+            "orders": self._orders,
+            "limit": self._limit,
+            "offset": self._offset,
+            "all_descendants": self._all_descendants,
+        }
+        if start:
+            query_kwargs["start_at"] = cursor_pair
+            query_kwargs["end_at"] = self._end_at
+        else:
+            query_kwargs["start_at"] = self._start_at
+            query_kwargs["end_at"] = cursor_pair
+
+        return self.__class__(self._parent, **query_kwargs)
+
+    def start_at(self, document_fields):
+        """Start query results at a particular document value.
+
+        The result set will **include** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified a start cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1.query.Query.start_after` -- this
+        will overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1.query.Query.order_by`.
+
+        Args:
+            document_fields
+                (Union[:class:`~google.cloud.firestore_v1.document.DocumentSnapshot`, dict, list, tuple]):
+                a document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor. Acts as
+            a copy of the current query, modified with the newly added
+            "start at" cursor.
+        """
+        return self._cursor_helper(document_fields, before=True, start=True)
+
+    def start_after(self, document_fields):
+        """Start query results after a particular document value.
+
+        The result set will **exclude** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified a start cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1.query.Query.start_at` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1.query.Query.order_by`.
+
+        Args:
+            document_fields
+                (Union[:class:`~google.cloud.firestore_v1.document.DocumentSnapshot`, dict, list, tuple]):
+                a document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor. Acts as a copy of the current query, modified
+            with the newly added "start after" cursor.
+        """
+        return self._cursor_helper(document_fields, before=False, start=True)
+
+    def end_before(self, document_fields):
+        """End query results before a particular document value.
+
+        The result set will **exclude** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified an end cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1.query.Query.end_at` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1.query.Query.order_by`.
+
+        Args:
+            document_fields
+                (Union[:class:`~google.cloud.firestore_v1.document.DocumentSnapshot`, dict, list, tuple]):
+                a document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor. Acts as a copy of the current query, modified
+            with the newly added "end before" cursor.
+        """
+        return self._cursor_helper(document_fields, before=True, start=False)
+
+    def end_at(self, document_fields):
+        """End query results at a particular document value.
+
+        The result set will **include** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified an end cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1.query.Query.end_before` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1.query.Query.order_by`.
+
+        Args:
+            document_fields
+                (Union[:class:`~google.cloud.firestore_v1.document.DocumentSnapshot`, dict, list, tuple]):
+                a document snapshot or a dictionary/list/tuple of fields
+                representing a query results cursor. A cursor is a collection
+                of values that represent a position in a query result set.
+
+        Returns:
+            :class:`~google.cloud.firestore_v1.query.Query`:
+            A query with cursor. Acts as a copy of the current query, modified
+            with the newly added "end at" cursor.
+        """
+        return self._cursor_helper(document_fields, before=False, start=False)
+
+    def _filters_pb(self):
+        """Convert all the filters into a single generic Filter protobuf.
+
+        This may be a lone field filter or unary filter, may be a composite
+        filter or may be :data:`None`.
+
+        Returns:
+            :class:`google.cloud.firestore_v1.types.StructuredQuery.Filter`:
+            A "generic" filter representing the current query's filters.
+        """
+        num_filters = len(self._field_filters)
+        if num_filters == 0:
+            return None
+        elif num_filters == 1:
+            return _filter_pb(self._field_filters[0])
+        else:
+            composite_filter = query_pb2.StructuredQuery.CompositeFilter(
+                op=enums.StructuredQuery.CompositeFilter.Operator.AND,
+                filters=[_filter_pb(filter_) for filter_ in self._field_filters],
+            )
+            return query_pb2.StructuredQuery.Filter(composite_filter=composite_filter)
+
+    @staticmethod
+    def _normalize_projection(projection):
+        """Helper:  convert field paths to message."""
+        if projection is not None:
+
+            fields = list(projection.fields)
+
+            if not fields:
+                field_ref = query_pb2.StructuredQuery.FieldReference(
+                    field_path="__name__"
+                )
+                return query_pb2.StructuredQuery.Projection(fields=[field_ref])
+
+        return projection
+
+    def _normalize_orders(self):
+        """Helper:  adjust orders based on cursors, where clauses."""
+        orders = list(self._orders)
+        _has_snapshot_cursor = False
+
+        if self._start_at:
+            if isinstance(self._start_at[0], document.DocumentSnapshot):
+                _has_snapshot_cursor = True
+
+        if self._end_at:
+            if isinstance(self._end_at[0], document.DocumentSnapshot):
+                _has_snapshot_cursor = True
+
+        if _has_snapshot_cursor:
+            should_order = [
+                _enum_from_op_string(key)
+                for key in _COMPARISON_OPERATORS
+                if key not in (_EQ_OP, "array_contains")
+            ]
+            order_keys = [order.field.field_path for order in orders]
+            for filter_ in self._field_filters:
+                field = filter_.field.field_path
+                if filter_.op in should_order and field not in order_keys:
+                    orders.append(self._make_order(field, "ASCENDING"))
+            if not orders:
+                orders.append(self._make_order("__name__", "ASCENDING"))
+            else:
+                order_keys = [order.field.field_path for order in orders]
+                if "__name__" not in order_keys:
+                    direction = orders[-1].direction  # enum?
+                    orders.append(self._make_order("__name__", direction))
+
+        return orders
+
+    def _normalize_cursor(self, cursor, orders):
+        """Helper: convert cursor to a list of values based on orders."""
+        if cursor is None:
+            return
+
+        if not orders:
+            raise ValueError(_NO_ORDERS_FOR_CURSOR)
+
+        document_fields, before = cursor
+
+        order_keys = [order.field.field_path for order in orders]
+
+        if isinstance(document_fields, document.DocumentSnapshot):
+            snapshot = document_fields
+            document_fields = snapshot.to_dict()
+            document_fields["__name__"] = snapshot.reference
+
+        if isinstance(document_fields, dict):
+            # Transform to list using orders
+            values = []
+            data = document_fields
+            for order_key in order_keys:
+                try:
+                    if order_key in data:
+                        values.append(data[order_key])
+                    else:
+                        values.append(
+                            field_path_module.get_nested_value(order_key, data)
+                        )
+                except KeyError:
+                    msg = _MISSING_ORDER_BY.format(order_key, data)
+                    raise ValueError(msg)
+            document_fields = values
+
+        if len(document_fields) != len(orders):
+            msg = _MISMATCH_CURSOR_W_ORDER_BY.format(document_fields, order_keys)
+            raise ValueError(msg)
+
+        _transform_bases = (transforms.Sentinel, transforms._ValueList)
+
+        for index, key_field in enumerate(zip(order_keys, document_fields)):
+            key, field = key_field
+
+            if isinstance(field, _transform_bases):
+                msg = _INVALID_CURSOR_TRANSFORM
+                raise ValueError(msg)
+
+            if key == "__name__" and isinstance(field, six.string_types):
+                document_fields[index] = self._parent.document(field)
+
+        return document_fields, before
+
+    def _to_protobuf(self):
+        """Convert the current query into the equivalent protobuf.
+
+        Returns:
+            :class:`google.cloud.firestore_v1.types.StructuredQuery`:
+            The query protobuf.
+        """
+        projection = self._normalize_projection(self._projection)
+        orders = self._normalize_orders()
+        start_at = self._normalize_cursor(self._start_at, orders)
+        end_at = self._normalize_cursor(self._end_at, orders)
+
+        query_kwargs = {
+            "select": projection,
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(
+                    collection_id=self._parent.id, all_descendants=self._all_descendants
+                )
+            ],
+            "where": self._filters_pb(),
+            "order_by": orders,
+            "start_at": _cursor_pb(start_at),
+            "end_at": _cursor_pb(end_at),
+        }
+        if self._offset is not None:
+            query_kwargs["offset"] = self._offset
+        if self._limit is not None:
+            query_kwargs["limit"] = wrappers_pb2.Int32Value(value=self._limit)
+
+        return query_pb2.StructuredQuery(**query_kwargs)
+
+    def get(self, transaction=None):
+        """Deprecated alias for :meth:`stream`."""
+        warnings.warn(
+            "'Query.get' is deprecated:  please use 'Query.stream' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.stream(transaction=transaction)
+
+    def stream(self, transaction=None):
+        """Read the documents in the collection that match this query.
+
+        This sends a ``RunQuery`` RPC and then returns an iterator which
+        consumes each document returned in the stream of ``RunQueryResponse``
+        messages.
+
+        .. note::
+
+           The underlying stream of responses will time out after
+           the ``max_rpc_timeout_millis`` value set in the GAPIC
+           client configuration for the ``RunQuery`` API.  Snapshots
+           not consumed from the iterator before that point will be lost.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            transaction
+                (Optional[:class:`~google.cloud.firestore_v1.transaction.Transaction`]):
+                An existing transaction that this query will run in.
+
+        Yields:
+            :class:`~google.cloud.firestore_v1.document.DocumentSnapshot`:
+            The next document that fulfills the query.
+        """
+        parent_path, expected_prefix = self._parent._parent_info()
+        response_iterator = self._client._firestore_api.run_query(
+            parent_path,
+            self._to_protobuf(),
+            transaction=_helpers.get_transaction_id(transaction),
+            metadata=self._client._rpc_metadata,
+        )
+
+        for response in response_iterator:
+            if self._all_descendants:
+                snapshot = _collection_group_query_response_to_snapshot(
+                    response, self._parent
+                )
+            else:
+                snapshot = _query_response_to_snapshot(
+                    response, self._parent, expected_prefix
+                )
+            if snapshot is not None:
+                yield snapshot
+
+    def on_snapshot(self, callback):
+        """Monitor the documents in this collection that match this query.
+
+        This starts a watch on this query using a background thread. The
+        provided callback is run on the snapshot of the documents.
+
+        Args:
+            callback(Callable[[:class:`~google.cloud.firestore.query.QuerySnapshot`], NoneType]):
+                a callback to run when a change occurs.
+
+        Example:
+
+        .. code-block:: python
+
+            from google.cloud import firestore_v1
+
+            db = firestore_v1.Client()
+            query_ref = db.collection(u'users').where("user", "==", u'Ada')
+
+            def on_snapshot(docs, changes, read_time):
+                for doc in docs:
+                    print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+            # Watch this query
+            query_watch = query_ref.on_snapshot(on_snapshot)
+
+            # Terminate this watch
+            query_watch.unsubscribe()
+        """
+        return Watch.for_query(
+            self, callback, document.DocumentSnapshot, document.DocumentReference
+        )
+
+    def _comparator(self, doc1, doc2):
+        _orders = self._orders
+
+        # Add implicit sorting by name, using the last specified direction.
+        if len(_orders) == 0:
+            lastDirection = Query.ASCENDING
+        else:
+            if _orders[-1].direction == 1:
+                lastDirection = Query.ASCENDING
+            else:
+                lastDirection = Query.DESCENDING
+
+        orderBys = list(_orders)
+
+        order_pb = query_pb2.StructuredQuery.Order(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="id"),
+            direction=_enum_from_direction(lastDirection),
+        )
+        orderBys.append(order_pb)
+
+        for orderBy in orderBys:
+            if orderBy.field.field_path == "id":
+                # If ordering by docuent id, compare resource paths.
+                comp = Order()._compare_to(doc1.reference._path, doc2.reference._path)
+            else:
+                if (
+                    orderBy.field.field_path not in doc1._data
+                    or orderBy.field.field_path not in doc2._data
+                ):
+                    raise ValueError(
+                        "Can only compare fields that exist in the "
+                        "DocumentSnapshot. Please include the fields you are "
+                        "ordering on in your select() call."
+                    )
+                v1 = doc1._data[orderBy.field.field_path]
+                v2 = doc2._data[orderBy.field.field_path]
+                encoded_v1 = _helpers.encode_value(v1)
+                encoded_v2 = _helpers.encode_value(v2)
+                comp = Order().compare(encoded_v1, encoded_v2)
+
+            if comp != 0:
+                # 1 == Ascending, -1 == Descending
+                return orderBy.direction * comp
+
+        return 0
+
+
+def _enum_from_op_string(op_string):
+    """Convert a string representation of a binary operator to an enum.
+
+    These enums come from the protobuf message definition
+    ``StructuredQuery.FieldFilter.Operator``.
+
+    Args:
+        op_string (str): A comparison operation in the form of a string.
+            Acceptable values are ``<``, ``<=``, ``==``, ``>=``
+            and ``>``.
+
+    Returns:
+        int: The enum corresponding to ``op_string``.
+
+    Raises:
+        ValueError: If ``op_string`` is not a valid operator.
+    """
+    try:
+        return _COMPARISON_OPERATORS[op_string]
+    except KeyError:
+        choices = ", ".join(sorted(_COMPARISON_OPERATORS.keys()))
+        msg = _BAD_OP_STRING.format(op_string, choices)
+        raise ValueError(msg)
+
+
+def _isnan(value):
+    """Check if a value is NaN.
+
+    This differs from ``math.isnan`` in that **any** input type is
+    allowed.
+
+    Args:
+        value (Any): A value to check for NaN-ness.
+
+    Returns:
+        bool: Indicates if the value is the NaN float.
+    """
+    if isinstance(value, float):
+        return math.isnan(value)
+    else:
+        return False
+
+
+def _enum_from_direction(direction):
+    """Convert a string representation of a direction to an enum.
+
+    Args:
+        direction (str): A direction to order by. Must be one of
+            :attr:`~google.cloud.firestore.Query.ASCENDING` or
+            :attr:`~google.cloud.firestore.Query.DESCENDING`.
+
+    Returns:
+        int: The enum corresponding to ``direction``.
+
+    Raises:
+        ValueError: If ``direction`` is not a valid direction.
+    """
+    if isinstance(direction, int):
+        return direction
+
+    if direction == Query.ASCENDING:
+        return enums.StructuredQuery.Direction.ASCENDING
+    elif direction == Query.DESCENDING:
+        return enums.StructuredQuery.Direction.DESCENDING
+    else:
+        msg = _BAD_DIR_STRING.format(direction, Query.ASCENDING, Query.DESCENDING)
+        raise ValueError(msg)
+
+
+def _filter_pb(field_or_unary):
+    """Convert a specific protobuf filter to the generic filter type.
+
+    Args:
+        field_or_unary (Union[google.cloud.proto.firestore.v1.\
+            query_pb2.StructuredQuery.FieldFilter, google.cloud.proto.\
+            firestore.v1.query_pb2.StructuredQuery.FieldFilter]): A
+            field or unary filter to convert to a generic filter.
+
+    Returns:
+        google.cloud.firestore_v1.types.\
+        StructuredQuery.Filter: A "generic" filter.
+
+    Raises:
+        ValueError: If ``field_or_unary`` is not a field or unary filter.
+    """
+    if isinstance(field_or_unary, query_pb2.StructuredQuery.FieldFilter):
+        return query_pb2.StructuredQuery.Filter(field_filter=field_or_unary)
+    elif isinstance(field_or_unary, query_pb2.StructuredQuery.UnaryFilter):
+        return query_pb2.StructuredQuery.Filter(unary_filter=field_or_unary)
+    else:
+        raise ValueError("Unexpected filter type", type(field_or_unary), field_or_unary)
+
+
+def _cursor_pb(cursor_pair):
+    """Convert a cursor pair to a protobuf.
+
+    If ``cursor_pair`` is :data:`None`, just returns :data:`None`.
+
+    Args:
+        cursor_pair (Optional[Tuple[list, bool]]): Two-tuple of
+
+            * a list of field values.
+            * a ``before`` flag
+
+    Returns:
+        Optional[google.cloud.firestore_v1.types.Cursor]: A
+        protobuf cursor corresponding to the values.
+    """
+    if cursor_pair is not None:
+        data, before = cursor_pair
+        value_pbs = [_helpers.encode_value(value) for value in data]
+        return query_pb2.Cursor(values=value_pbs, before=before)
+
+
+def _query_response_to_snapshot(response_pb, collection, expected_prefix):
+    """Parse a query response protobuf to a document snapshot.
+
+    Args:
+        response_pb (google.cloud.proto.firestore.v1.\
+            firestore_pb2.RunQueryResponse): A
+        collection (:class:`~google.cloud.firestore_v1.collection.CollectionReference`):
+            A reference to the collection that initiated the query.
+        expected_prefix (str): The expected prefix for fully-qualified
+            document names returned in the query results. This can be computed
+            directly from ``collection`` via :meth:`_parent_info`.
+
+    Returns:
+        Optional[:class:`~google.cloud.firestore.document.DocumentSnapshot`]:
+        A snapshot of the data returned in the query. If
+        ``response_pb.document`` is not set, the snapshot will be :data:`None`.
+    """
+    if not response_pb.HasField("document"):
+        return None
+
+    document_id = _helpers.get_doc_id(response_pb.document, expected_prefix)
+    reference = collection.document(document_id)
+    data = _helpers.decode_dict(response_pb.document.fields, collection._client)
+    snapshot = document.DocumentSnapshot(
+        reference,
+        data,
+        exists=True,
+        read_time=response_pb.read_time,
+        create_time=response_pb.document.create_time,
+        update_time=response_pb.document.update_time,
+    )
+    return snapshot
+
+
+def _collection_group_query_response_to_snapshot(response_pb, collection):
+    """Parse a query response protobuf to a document snapshot.
+
+    Args:
+        response_pb (google.cloud.proto.firestore.v1.\
+            firestore_pb2.RunQueryResponse): A
+        collection (:class:`~google.cloud.firestore_v1.collection.CollectionReference`):
+            A reference to the collection that initiated the query.
+
+    Returns:
+        Optional[:class:`~google.cloud.firestore.document.DocumentSnapshot`]:
+        A snapshot of the data returned in the query. If
+        ``response_pb.document`` is not set, the snapshot will be :data:`None`.
+    """
+    if not response_pb.HasField("document"):
+        return None
+    reference = collection._client.document(response_pb.document.name)
+    data = _helpers.decode_dict(response_pb.document.fields, collection._client)
+    snapshot = document.DocumentSnapshot(
+        reference,
+        data,
+        exists=True,
+        read_time=response_pb.read_time,
+        create_time=response_pb.document.create_time,
+        update_time=response_pb.document.update_time,
+    )
+    return snapshot
diff --git a/firestore/google/cloud/firestore_v1/transaction.py b/firestore/google/cloud/firestore_v1/transaction.py
new file mode 100644
index 000000000000..9d4068c75a88
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/transaction.py
@@ -0,0 +1,442 @@
+# Copyright 2017 Google LLC 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.
+
+"""Helpers for applying Google Cloud Firestore changes in a transaction."""
+
+
+import random
+import time
+
+import six
+
+from google.api_core import exceptions
+from google.cloud.firestore_v1 import batch
+from google.cloud.firestore_v1 import types
+from google.cloud.firestore_v1.document import DocumentReference
+from google.cloud.firestore_v1.query import Query
+
+
+MAX_ATTEMPTS = 5
+"""int: Default number of transaction attempts (with retries)."""
+_CANT_BEGIN = "The transaction has already begun. Current transaction ID: {!r}."
+_MISSING_ID_TEMPLATE = "The transaction has no transaction ID, so it cannot be {}."
+_CANT_ROLLBACK = _MISSING_ID_TEMPLATE.format("rolled back")
+_CANT_COMMIT = _MISSING_ID_TEMPLATE.format("committed")
+_WRITE_READ_ONLY = "Cannot perform write operation in read-only transaction."
+_INITIAL_SLEEP = 1.0
+"""float: Initial "max" for sleep interval. To be used in :func:`_sleep`."""
+_MAX_SLEEP = 30.0
+"""float: Eventual "max" sleep time. To be used in :func:`_sleep`."""
+_MULTIPLIER = 2.0
+"""float: Multiplier for exponential backoff. To be used in :func:`_sleep`."""
+_EXCEED_ATTEMPTS_TEMPLATE = "Failed to commit transaction in {:d} attempts."
+_CANT_RETRY_READ_ONLY = "Only read-write transactions can be retried."
+
+
+class Transaction(batch.WriteBatch):
+    """Accumulate read-and-write operations to be sent in a transaction.
+
+    Args:
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            The client that created this transaction.
+        max_attempts (Optional[int]): The maximum number of attempts for
+            the transaction (i.e. allowing retries). Defaults to
+            :attr:`~google.cloud.firestore_v1.transaction.MAX_ATTEMPTS`.
+        read_only (Optional[bool]): Flag indicating if the transaction
+            should be read-only or should allow writes. Defaults to
+            :data:`False`.
+    """
+
+    def __init__(self, client, max_attempts=MAX_ATTEMPTS, read_only=False):
+        super(Transaction, self).__init__(client)
+        self._max_attempts = max_attempts
+        self._read_only = read_only
+        self._id = None
+
+    def _add_write_pbs(self, write_pbs):
+        """Add `Write`` protobufs to this transaction.
+
+        Args:
+            write_pbs (List[google.cloud.proto.firestore.v1.\
+                write_pb2.Write]): A list of write protobufs to be added.
+
+        Raises:
+            ValueError: If this transaction is read-only.
+        """
+        if self._read_only:
+            raise ValueError(_WRITE_READ_ONLY)
+
+        super(Transaction, self)._add_write_pbs(write_pbs)
+
+    def _options_protobuf(self, retry_id):
+        """Convert the current object to protobuf.
+
+        The ``retry_id`` value is used when retrying a transaction that
+        failed (e.g. due to contention). It is intended to be the "first"
+        transaction that failed (i.e. if multiple retries are needed).
+
+        Args:
+            retry_id (Union[bytes, NoneType]): Transaction ID of a transaction
+                to be retried.
+
+        Returns:
+            Optional[google.cloud.firestore_v1.types.TransactionOptions]:
+            The protobuf ``TransactionOptions`` if ``read_only==True`` or if
+            there is a transaction ID to be retried, else :data:`None`.
+
+        Raises:
+            ValueError: If ``retry_id`` is not :data:`None` but the
+                transaction is read-only.
+        """
+        if retry_id is not None:
+            if self._read_only:
+                raise ValueError(_CANT_RETRY_READ_ONLY)
+
+            return types.TransactionOptions(
+                read_write=types.TransactionOptions.ReadWrite(
+                    retry_transaction=retry_id
+                )
+            )
+        elif self._read_only:
+            return types.TransactionOptions(
+                read_only=types.TransactionOptions.ReadOnly()
+            )
+        else:
+            return None
+
+    @property
+    def in_progress(self):
+        """Determine if this transaction has already begun.
+
+        Returns:
+            bool: Indicates if the transaction has started.
+        """
+        return self._id is not None
+
+    @property
+    def id(self):
+        """Get the current transaction ID.
+
+        Returns:
+            Optional[bytes]: The transaction ID (or :data:`None` if the
+            current transaction is not in progress).
+        """
+        return self._id
+
+    def _begin(self, retry_id=None):
+        """Begin the transaction.
+
+        Args:
+            retry_id (Optional[bytes]): Transaction ID of a transaction to be
+                retried.
+
+        Raises:
+            ValueError: If the current transaction has already begun.
+        """
+        if self.in_progress:
+            msg = _CANT_BEGIN.format(self._id)
+            raise ValueError(msg)
+
+        transaction_response = self._client._firestore_api.begin_transaction(
+            self._client._database_string,
+            options_=self._options_protobuf(retry_id),
+            metadata=self._client._rpc_metadata,
+        )
+        self._id = transaction_response.transaction
+
+    def _clean_up(self):
+        """Clean up the instance after :meth:`_rollback`` or :meth:`_commit``.
+
+        This intended to occur on success or failure of the associated RPCs.
+        """
+        self._write_pbs = []
+        self._id = None
+
+    def _rollback(self):
+        """Roll back the transaction.
+
+        Raises:
+            ValueError: If no transaction is in progress.
+        """
+        if not self.in_progress:
+            raise ValueError(_CANT_ROLLBACK)
+
+        try:
+            # NOTE: The response is just ``google.protobuf.Empty``.
+            self._client._firestore_api.rollback(
+                self._client._database_string,
+                self._id,
+                metadata=self._client._rpc_metadata,
+            )
+        finally:
+            self._clean_up()
+
+    def _commit(self):
+        """Transactionally commit the changes accumulated.
+
+        Returns:
+            List[:class:`google.cloud.proto.firestore.v1.write_pb2.WriteResult`, ...]:
+            The write results corresponding to the changes committed, returned
+            in the same order as the changes were applied to this transaction.
+            A write result contains an ``update_time`` field.
+
+        Raises:
+            ValueError: If no transaction is in progress.
+        """
+        if not self.in_progress:
+            raise ValueError(_CANT_COMMIT)
+
+        commit_response = _commit_with_retry(self._client, self._write_pbs, self._id)
+
+        self._clean_up()
+        return list(commit_response.write_results)
+
+    def get_all(self, references):
+        """Retrieves multiple documents from Firestore.
+
+        Args:
+            references (List[.DocumentReference, ...]): Iterable of document
+                references to be retrieved.
+
+        Yields:
+            .DocumentSnapshot: The next document snapshot that fulfills the
+            query, or :data:`None` if the document does not exist.
+        """
+        return self._client.get_all(references, transaction=self._id)
+
+    def get(self, ref_or_query):
+        """
+        Retrieve a document or a query result from the database.
+        Args:
+            ref_or_query The document references or query object to return.
+        Yields:
+            .DocumentSnapshot: The next document snapshot that fulfills the
+            query, or :data:`None` if the document does not exist.
+        """
+        if isinstance(ref_or_query, DocumentReference):
+            return self._client.get_all([ref_or_query], transaction=self._id)
+        elif isinstance(ref_or_query, Query):
+            return ref_or_query.stream(transaction=self._id)
+        else:
+            raise ValueError(
+                'Value for argument "ref_or_query" must be a DocumentReference or a Query.'
+            )
+
+
+class _Transactional(object):
+    """Provide a callable object to use as a transactional decorater.
+
+    This is surfaced via
+    :func:`~google.cloud.firestore_v1.transaction.transactional`.
+
+    Args:
+        to_wrap (Callable[[:class:`~google.cloud.firestore_v1.transaction.Transaction`, ...], Any]):
+            A callable that should be run (and retried) in a transaction.
+    """
+
+    def __init__(self, to_wrap):
+        self.to_wrap = to_wrap
+        self.current_id = None
+        """Optional[bytes]: The current transaction ID."""
+        self.retry_id = None
+        """Optional[bytes]: The ID of the first attempted transaction."""
+
+    def _reset(self):
+        """Unset the transaction IDs."""
+        self.current_id = None
+        self.retry_id = None
+
+    def _pre_commit(self, transaction, *args, **kwargs):
+        """Begin transaction and call the wrapped callable.
+
+        If the callable raises an exception, the transaction will be rolled
+        back. If not, the transaction will be "ready" for ``Commit`` (i.e.
+        it will have staged writes).
+
+        Args:
+            transaction
+                (:class:`~google.cloud.firestore_v1.transaction.Transaction`):
+                A transaction to execute the callable within.
+            args (Tuple[Any, ...]): The extra positional arguments to pass
+                along to the wrapped callable.
+            kwargs (Dict[str, Any]): The extra keyword arguments to pass
+                along to the wrapped callable.
+
+        Returns:
+            Any: result of the wrapped callable.
+
+        Raises:
+            Exception: Any failure caused by ``to_wrap``.
+        """
+        # Force the ``transaction`` to be not "in progress".
+        transaction._clean_up()
+        transaction._begin(retry_id=self.retry_id)
+
+        # Update the stored transaction IDs.
+        self.current_id = transaction._id
+        if self.retry_id is None:
+            self.retry_id = self.current_id
+        try:
+            return self.to_wrap(transaction, *args, **kwargs)
+        except:  # noqa
+            # NOTE: If ``rollback`` fails this will lose the information
+            #       from the original failure.
+            transaction._rollback()
+            raise
+
+    def _maybe_commit(self, transaction):
+        """Try to commit the transaction.
+
+        If the transaction is read-write and the ``Commit`` fails with the
+        ``ABORTED`` status code, it will be retried. Any other failure will
+        not be caught.
+
+        Args:
+            transaction
+                (:class:`~google.cloud.firestore_v1.transaction.Transaction`):
+                The transaction to be ``Commit``-ed.
+
+        Returns:
+            bool: Indicating if the commit succeeded.
+        """
+        try:
+            transaction._commit()
+            return True
+        except exceptions.GoogleAPICallError as exc:
+            if transaction._read_only:
+                raise
+
+            if isinstance(exc, exceptions.Aborted):
+                # If a read-write transaction returns ABORTED, retry.
+                return False
+            else:
+                raise
+
+    def __call__(self, transaction, *args, **kwargs):
+        """Execute the wrapped callable within a transaction.
+
+        Args:
+            transaction
+                (:class:`~google.cloud.firestore_v1.transaction.Transaction`):
+                A transaction to execute the callable within.
+            args (Tuple[Any, ...]): The extra positional arguments to pass
+                along to the wrapped callable.
+            kwargs (Dict[str, Any]): The extra keyword arguments to pass
+                along to the wrapped callable.
+
+        Returns:
+            Any: The result of the wrapped callable.
+
+        Raises:
+            ValueError: If the transaction does not succeed in
+                ``max_attempts``.
+        """
+        self._reset()
+
+        for attempt in six.moves.xrange(transaction._max_attempts):
+            result = self._pre_commit(transaction, *args, **kwargs)
+            succeeded = self._maybe_commit(transaction)
+            if succeeded:
+                return result
+
+            # Subsequent requests will use the failed transaction ID as part of
+            # the ``BeginTransactionRequest`` when restarting this transaction
+            # (via ``options.retry_transaction``). This preserves the "spot in
+            # line" of the transaction, so exponential backoff is not required
+            # in this case.
+
+        transaction._rollback()
+        msg = _EXCEED_ATTEMPTS_TEMPLATE.format(transaction._max_attempts)
+        raise ValueError(msg)
+
+
+def transactional(to_wrap):
+    """Decorate a callable so that it runs in a transaction.
+
+    Args:
+        to_wrap
+            (Callable[[:class:`~google.cloud.firestore_v1.transaction.Transaction`, ...], Any]):
+            A callable that should be run (and retried) in a transaction.
+
+    Returns:
+        Callable[[:class:`~google.cloud.firestore_v1.transaction.Transaction`, ...], Any]:
+        the wrapped callable.
+    """
+    return _Transactional(to_wrap)
+
+
+def _commit_with_retry(client, write_pbs, transaction_id):
+    """Call ``Commit`` on the GAPIC client with retry / sleep.
+
+    Retries the ``Commit`` RPC on Unavailable. Usually this RPC-level
+    retry is handled by the underlying GAPICd client, but in this case it
+    doesn't because ``Commit`` is not always idempotent. But here we know it
+    is "idempotent"-like because it has a transaction ID. We also need to do
+    our own retry to special-case the ``INVALID_ARGUMENT`` error.
+
+    Args:
+        client (:class:`~google.cloud.firestore_v1.client.Client`):
+            A client with GAPIC client and configuration details.
+        write_pbs (List[:class:`google.cloud.proto.firestore.v1.write_pb2.Write`, ...]):
+            A ``Write`` protobuf instance to be committed.
+        transaction_id (bytes):
+            ID of an existing transaction that this commit will run in.
+
+    Returns:
+        :class:`google.cloud.firestore_v1.types.CommitResponse`:
+        The protobuf response from ``Commit``.
+
+    Raises:
+        ~google.api_core.exceptions.GoogleAPICallError: If a non-retryable
+            exception is encountered.
+    """
+    current_sleep = _INITIAL_SLEEP
+    while True:
+        try:
+            return client._firestore_api.commit(
+                client._database_string,
+                write_pbs,
+                transaction=transaction_id,
+                metadata=client._rpc_metadata,
+            )
+        except exceptions.ServiceUnavailable:
+            # Retry
+            pass
+
+        current_sleep = _sleep(current_sleep)
+
+
+def _sleep(current_sleep, max_sleep=_MAX_SLEEP, multiplier=_MULTIPLIER):
+    """Sleep and produce a new sleep time.
+
+    .. _Exponential Backoff And Jitter: https://www.awsarchitectureblog.com/\
+                                        2015/03/backoff.html
+
+    Select a duration between zero and ``current_sleep``. It might seem
+    counterintuitive to have so much jitter, but
+    `Exponential Backoff And Jitter`_ argues that "full jitter" is
+    the best strategy.
+
+    Args:
+        current_sleep (float): The current "max" for sleep interval.
+        max_sleep (Optional[float]): Eventual "max" sleep time
+        multiplier (Optional[float]): Multiplier for exponential backoff.
+
+    Returns:
+        float: Newly doubled ``current_sleep`` or ``max_sleep`` (whichever
+        is smaller)
+    """
+    actual_sleep = random.uniform(0.0, current_sleep)
+    time.sleep(actual_sleep)
+    return min(multiplier * current_sleep, max_sleep)
diff --git a/firestore/google/cloud/firestore_v1/transforms.py b/firestore/google/cloud/firestore_v1/transforms.py
new file mode 100644
index 000000000000..83b644608d01
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/transforms.py
@@ -0,0 +1,151 @@
+# Copyright 2017 Google LLC 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.
+
+"""Helpful constants to use for Google Cloud Firestore."""
+
+
+class Sentinel(object):
+    """Sentinel objects used to signal special handling."""
+
+    __slots__ = ("description",)
+
+    def __init__(self, description):
+        self.description = description
+
+    def __repr__(self):
+        return "Sentinel: {}".format(self.description)
+
+
+DELETE_FIELD = Sentinel("Value used to delete a field in a document.")
+
+
+SERVER_TIMESTAMP = Sentinel(
+    "Value used to set a document field to the server timestamp."
+)
+
+
+class _ValueList(object):
+    """Read-only list of values.
+
+    Args:
+        values (List | Tuple): values held in the helper.
+    """
+
+    slots = ("_values",)
+
+    def __init__(self, values):
+        if not isinstance(values, (list, tuple)):
+            raise ValueError("'values' must be a list or tuple.")
+
+        if len(values) == 0:
+            raise ValueError("'values' must be non-empty.")
+
+        self._values = list(values)
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._values == other._values
+
+    @property
+    def values(self):
+        """Values to append.
+
+        Returns (List):
+            values to be appended by the transform.
+        """
+        return self._values
+
+
+class ArrayUnion(_ValueList):
+    """Field transform: appends missing values to an array field.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1#google.firestore.v1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1.ArrayValue.google.firestore.v1.DocumentTransform.FieldTransform.append_missing_elements
+
+    Args:
+        values (List | Tuple): values to append.
+    """
+
+
+class ArrayRemove(_ValueList):
+    """Field transform: remove values from an array field.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1#google.firestore.v1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1.ArrayValue.google.firestore.v1.DocumentTransform.FieldTransform.remove_all_from_array
+
+    Args:
+        values (List | Tuple): values to remove.
+    """
+
+
+class _NumericValue(object):
+    """Hold a single integer / float value.
+
+    Args:
+        value (int | float): value held in the helper.
+    """
+
+    def __init__(self, value):
+        if not isinstance(value, (int, float)):
+            raise ValueError("Pass an integer / float value.")
+
+        self._value = value
+
+    @property
+    def value(self):
+        """Value used by the transform.
+
+        Returns:
+            (Integer | Float) value passed in the constructor.
+        """
+        return self._value
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._value == other._value
+
+
+class Increment(_NumericValue):
+    """Field transform: increment a numeric field with specified value.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1#google.firestore.v1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1.ArrayValue.google.firestore.v1.DocumentTransform.FieldTransform.increment
+
+    Args:
+        value (int | float): value used to increment the field.
+    """
+
+
+class Maximum(_NumericValue):
+    """Field transform: bound numeric field with specified value.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1#google.firestore.v1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1.ArrayValue.google.firestore.v1.DocumentTransform.FieldTransform.maximum
+
+    Args:
+        value (int | float): value used to bound the field.
+    """
+
+
+class Minimum(_NumericValue):
+    """Field transform: bound numeric field with specified value.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1#google.firestore.v1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1.ArrayValue.google.firestore.v1.DocumentTransform.FieldTransform.minimum
+
+    Args:
+        value (int | float): value used to bound the field.
+    """
diff --git a/firestore/google/cloud/firestore_v1/types.py b/firestore/google/cloud/firestore_v1/types.py
new file mode 100644
index 000000000000..c4e7c350783d
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/types.py
@@ -0,0 +1,63 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.protobuf import any_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import latlng_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.firestore_v1.proto import common_pb2
+from google.cloud.firestore_v1.proto import document_pb2
+from google.cloud.firestore_v1.proto import firestore_pb2
+from google.cloud.firestore_v1.proto import query_pb2
+from google.cloud.firestore_v1.proto import write_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    any_pb2,
+    descriptor_pb2,
+    empty_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [common_pb2, document_pb2, firestore_pb2, query_pb2, write_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.firestore_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/firestore/google/cloud/firestore_v1/watch.py b/firestore/google/cloud/firestore_v1/watch.py
new file mode 100644
index 000000000000..458a3a94780f
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1/watch.py
@@ -0,0 +1,728 @@
+# Copyright 2017 Google LLC 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.
+
+import logging
+import collections
+import threading
+import datetime
+from enum import Enum
+import functools
+
+import pytz
+
+from google.api_core.bidi import ResumableBidiRpc
+from google.api_core.bidi import BackgroundConsumer
+from google.cloud.firestore_v1.proto import firestore_pb2
+from google.cloud.firestore_v1 import _helpers
+
+from google.api_core import exceptions
+
+import grpc
+
+"""Python client for Google Cloud Firestore Watch."""
+
+_LOGGER = logging.getLogger(__name__)
+
+WATCH_TARGET_ID = 0x5079  # "Py"
+
+GRPC_STATUS_CODE = {
+    "OK": 0,
+    "CANCELLED": 1,
+    "UNKNOWN": 2,
+    "INVALID_ARGUMENT": 3,
+    "DEADLINE_EXCEEDED": 4,
+    "NOT_FOUND": 5,
+    "ALREADY_EXISTS": 6,
+    "PERMISSION_DENIED": 7,
+    "UNAUTHENTICATED": 16,
+    "RESOURCE_EXHAUSTED": 8,
+    "FAILED_PRECONDITION": 9,
+    "ABORTED": 10,
+    "OUT_OF_RANGE": 11,
+    "UNIMPLEMENTED": 12,
+    "INTERNAL": 13,
+    "UNAVAILABLE": 14,
+    "DATA_LOSS": 15,
+    "DO_NOT_USE": -1,
+}
+_RPC_ERROR_THREAD_NAME = "Thread-OnRpcTerminated"
+_RECOVERABLE_STREAM_EXCEPTIONS = (exceptions.ServiceUnavailable,)
+_TERMINATING_STREAM_EXCEPTIONS = (exceptions.Cancelled,)
+
+DocTreeEntry = collections.namedtuple("DocTreeEntry", ["value", "index"])
+
+
+class WatchDocTree(object):
+    # TODO: Currently this uses a dict. Other implementations us an rbtree.
+    # The performance of this implementation should be investigated and may
+    # require modifying the underlying datastructure to a rbtree.
+    def __init__(self):
+        self._dict = {}
+        self._index = 0
+
+    def keys(self):
+        return list(self._dict.keys())
+
+    def _copy(self):
+        wdt = WatchDocTree()
+        wdt._dict = self._dict.copy()
+        wdt._index = self._index
+        self = wdt
+        return self
+
+    def insert(self, key, value):
+        self = self._copy()
+        self._dict[key] = DocTreeEntry(value, self._index)
+        self._index += 1
+        return self
+
+    def find(self, key):
+        return self._dict[key]
+
+    def remove(self, key):
+        self = self._copy()
+        del self._dict[key]
+        return self
+
+    def __iter__(self):
+        for k in self._dict:
+            yield k
+
+    def __len__(self):
+        return len(self._dict)
+
+    def __contains__(self, k):
+        return k in self._dict
+
+
+class ChangeType(Enum):
+    ADDED = 1
+    REMOVED = 2
+    MODIFIED = 3
+
+
+class DocumentChange(object):
+    def __init__(self, type, document, old_index, new_index):
+        """DocumentChange
+
+        Args:
+            type (ChangeType):
+            document (document.DocumentSnapshot):
+            old_index (int):
+            new_index (int):
+        """
+        # TODO: spec indicated an isEqual param also
+        self.type = type
+        self.document = document
+        self.old_index = old_index
+        self.new_index = new_index
+
+
+class WatchResult(object):
+    def __init__(self, snapshot, name, change_type):
+        self.snapshot = snapshot
+        self.name = name
+        self.change_type = change_type
+
+
+def _maybe_wrap_exception(exception):
+    """Wraps a gRPC exception class, if needed."""
+    if isinstance(exception, grpc.RpcError):
+        return exceptions.from_grpc_error(exception)
+    return exception
+
+
+def document_watch_comparator(doc1, doc2):
+    assert doc1 == doc2, "Document watches only support one document."
+    return 0
+
+
+def _should_recover(exception):
+    wrapped = _maybe_wrap_exception(exception)
+    return isinstance(wrapped, _RECOVERABLE_STREAM_EXCEPTIONS)
+
+
+def _should_terminate(exception):
+    wrapped = _maybe_wrap_exception(exception)
+    return isinstance(wrapped, _TERMINATING_STREAM_EXCEPTIONS)
+
+
+class Watch(object):
+
+    BackgroundConsumer = BackgroundConsumer  # FBO unit tests
+    ResumableBidiRpc = ResumableBidiRpc  # FBO unit tests
+
+    def __init__(
+        self,
+        document_reference,
+        firestore,
+        target,
+        comparator,
+        snapshot_callback,
+        document_snapshot_cls,
+        document_reference_cls,
+        BackgroundConsumer=None,  # FBO unit testing
+        ResumableBidiRpc=None,  # FBO unit testing
+    ):
+        """
+        Args:
+            firestore:
+            target:
+            comparator:
+            snapshot_callback: Callback method to process snapshots.
+                Args:
+                    docs (List(DocumentSnapshot)): A callback that returns the
+                        ordered list of documents stored in this snapshot.
+                    changes (List(str)): A callback that returns the list of
+                        changed documents since the last snapshot delivered for
+                        this watch.
+                    read_time (string): The ISO 8601 time at which this
+                        snapshot was obtained.
+
+            document_snapshot_cls: instance of DocumentSnapshot
+            document_reference_cls: instance of DocumentReference
+        """
+        self._document_reference = document_reference
+        self._firestore = firestore
+        self._api = firestore._firestore_api
+        self._targets = target
+        self._comparator = comparator
+        self.DocumentSnapshot = document_snapshot_cls
+        self.DocumentReference = document_reference_cls
+        self._snapshot_callback = snapshot_callback
+        self._closing = threading.Lock()
+        self._closed = False
+
+        initial_request = firestore_pb2.ListenRequest(
+            database=self._firestore._database_string, add_target=self._targets
+        )
+
+        if ResumableBidiRpc is None:
+            ResumableBidiRpc = self.ResumableBidiRpc  # FBO unit tests
+
+        self._rpc = ResumableBidiRpc(
+            self._api.transport.listen,
+            should_recover=_should_recover,
+            should_terminate=_should_terminate,
+            initial_request=initial_request,
+            metadata=self._firestore._rpc_metadata,
+        )
+
+        self._rpc.add_done_callback(self._on_rpc_done)
+
+        # Initialize state for on_snapshot
+        # The sorted tree of QueryDocumentSnapshots as sent in the last
+        # snapshot. We only look at the keys.
+        self.doc_tree = WatchDocTree()
+
+        # A map of document names to QueryDocumentSnapshots for the last sent
+        # snapshot.
+        self.doc_map = {}
+
+        # The accumulates map of document changes (keyed by document name) for
+        # the current snapshot.
+        self.change_map = {}
+
+        # The current state of the query results.
+        self.current = False
+
+        # We need this to track whether we've pushed an initial set of changes,
+        # since we should push those even when there are no changes, if there
+        # aren't docs.
+        self.has_pushed = False
+
+        # The server assigns and updates the resume token.
+        self.resume_token = None
+        if BackgroundConsumer is None:  # FBO unit tests
+            BackgroundConsumer = self.BackgroundConsumer
+
+        self._consumer = BackgroundConsumer(self._rpc, self.on_snapshot)
+        self._consumer.start()
+
+    @property
+    def is_active(self):
+        """bool: True if this manager is actively streaming.
+
+        Note that ``False`` does not indicate this is complete shut down,
+        just that it stopped getting new messages.
+        """
+        return self._consumer is not None and self._consumer.is_active
+
+    def close(self, reason=None):
+        """Stop consuming messages and shutdown all helper threads.
+
+        This method is idempotent. Additional calls will have no effect.
+
+        Args:
+            reason (Any): The reason to close this. If None, this is considered
+                an "intentional" shutdown.
+        """
+        with self._closing:
+            if self._closed:
+                return
+
+            # Stop consuming messages.
+            if self.is_active:
+                _LOGGER.debug("Stopping consumer.")
+                self._consumer.stop()
+            self._consumer = None
+
+            self._rpc.close()
+            self._rpc = None
+            self._closed = True
+            _LOGGER.debug("Finished stopping manager.")
+
+        if reason:
+            # Raise an exception if a reason is provided
+            _LOGGER.debug("reason for closing: %s" % reason)
+            if isinstance(reason, Exception):
+                raise reason
+            raise RuntimeError(reason)
+
+    def _on_rpc_done(self, future):
+        """Triggered whenever the underlying RPC terminates without recovery.
+
+        This is typically triggered from one of two threads: the background
+        consumer thread (when calling ``recv()`` produces a non-recoverable
+        error) or the grpc management thread (when cancelling the RPC).
+
+        This method is *non-blocking*. It will start another thread to deal
+        with shutting everything down. This is to prevent blocking in the
+        background consumer and preventing it from being ``joined()``.
+        """
+        _LOGGER.info("RPC termination has signaled manager shutdown.")
+        future = _maybe_wrap_exception(future)
+        thread = threading.Thread(
+            name=_RPC_ERROR_THREAD_NAME, target=self.close, kwargs={"reason": future}
+        )
+        thread.daemon = True
+        thread.start()
+
+    def unsubscribe(self):
+        self.close()
+
+    @classmethod
+    def for_document(
+        cls,
+        document_ref,
+        snapshot_callback,
+        snapshot_class_instance,
+        reference_class_instance,
+    ):
+        """
+        Creates a watch snapshot listener for a document. snapshot_callback
+        receives a DocumentChange object, but may also start to get
+        targetChange and such soon
+
+        Args:
+            document_ref: Reference to Document
+            snapshot_callback: callback to be called on snapshot
+            snapshot_class_instance: instance of DocumentSnapshot to make
+                snapshots with to pass to snapshot_callback
+            reference_class_instance: instance of DocumentReference to make
+                references
+
+        """
+        return cls(
+            document_ref,
+            document_ref._client,
+            {
+                "documents": {"documents": [document_ref._document_path]},
+                "target_id": WATCH_TARGET_ID,
+            },
+            document_watch_comparator,
+            snapshot_callback,
+            snapshot_class_instance,
+            reference_class_instance,
+        )
+
+    @classmethod
+    def for_query(
+        cls, query, snapshot_callback, snapshot_class_instance, reference_class_instance
+    ):
+        parent_path, _ = query._parent._parent_info()
+        query_target = firestore_pb2.Target.QueryTarget(
+            parent=parent_path, structured_query=query._to_protobuf()
+        )
+
+        return cls(
+            query,
+            query._client,
+            {"query": query_target, "target_id": WATCH_TARGET_ID},
+            query._comparator,
+            snapshot_callback,
+            snapshot_class_instance,
+            reference_class_instance,
+        )
+
+    def _on_snapshot_target_change_no_change(self, proto):
+        _LOGGER.debug("on_snapshot: target change: NO_CHANGE")
+        change = proto.target_change
+
+        no_target_ids = change.target_ids is None or len(change.target_ids) == 0
+        if no_target_ids and change.read_time and self.current:
+            # TargetChange.CURRENT followed by TargetChange.NO_CHANGE
+            # signals a consistent state. Invoke the onSnapshot
+            # callback as specified by the user.
+            self.push(change.read_time, change.resume_token)
+
+    def _on_snapshot_target_change_add(self, proto):
+        _LOGGER.debug("on_snapshot: target change: ADD")
+        target_id = proto.target_change.target_ids[0]
+        if target_id != WATCH_TARGET_ID:
+            raise RuntimeError("Unexpected target ID %s sent by server" % target_id)
+
+    def _on_snapshot_target_change_remove(self, proto):
+        _LOGGER.debug("on_snapshot: target change: REMOVE")
+        change = proto.target_change
+
+        code = 13
+        message = "internal error"
+        if change.cause:
+            code = change.cause.code
+            message = change.cause.message
+
+        message = "Error %s:  %s" % (code, message)
+
+        raise RuntimeError(message)
+
+    def _on_snapshot_target_change_reset(self, proto):
+        # Whatever changes have happened so far no longer matter.
+        _LOGGER.debug("on_snapshot: target change: RESET")
+        self._reset_docs()
+
+    def _on_snapshot_target_change_current(self, proto):
+        _LOGGER.debug("on_snapshot: target change: CURRENT")
+        self.current = True
+
+    def on_snapshot(self, proto):
+        """
+        Called everytime there is a response from listen. Collect changes
+        and 'push' the changes in a batch to the customer when we receive
+        'current' from the listen response.
+
+        Args:
+            listen_response(`google.cloud.firestore_v1.types.ListenResponse`):
+                Callback method that receives a object to
+        """
+        TargetChange = firestore_pb2.TargetChange
+
+        target_changetype_dispatch = {
+            TargetChange.NO_CHANGE: self._on_snapshot_target_change_no_change,
+            TargetChange.ADD: self._on_snapshot_target_change_add,
+            TargetChange.REMOVE: self._on_snapshot_target_change_remove,
+            TargetChange.RESET: self._on_snapshot_target_change_reset,
+            TargetChange.CURRENT: self._on_snapshot_target_change_current,
+        }
+
+        target_change = getattr(proto, "target_change", "")
+        document_change = getattr(proto, "document_change", "")
+        document_delete = getattr(proto, "document_delete", "")
+        document_remove = getattr(proto, "document_remove", "")
+        filter_ = getattr(proto, "filter", "")
+
+        if str(target_change):
+            target_change_type = target_change.target_change_type
+            _LOGGER.debug("on_snapshot: target change: " + str(target_change_type))
+            meth = target_changetype_dispatch.get(target_change_type)
+            if meth is None:
+                _LOGGER.info(
+                    "on_snapshot: Unknown target change " + str(target_change_type)
+                )
+                self.close(
+                    reason="Unknown target change type: %s " % str(target_change_type)
+                )
+            else:
+                try:
+                    meth(proto)
+                except Exception as exc2:
+                    _LOGGER.debug("meth(proto) exc: " + str(exc2))
+                    raise
+
+            # NOTE:
+            # in other implementations, such as node, the backoff is reset here
+            # in this version bidi rpc is just used and will control this.
+
+        elif str(document_change):
+            _LOGGER.debug("on_snapshot: document change")
+
+            # No other target_ids can show up here, but we still need to see
+            # if the targetId was in the added list or removed list.
+            target_ids = document_change.target_ids or []
+            removed_target_ids = document_change.removed_target_ids or []
+            changed = False
+            removed = False
+
+            if WATCH_TARGET_ID in target_ids:
+                changed = True
+
+            if WATCH_TARGET_ID in removed_target_ids:
+                removed = True
+
+            if changed:
+                _LOGGER.debug("on_snapshot: document change: CHANGED")
+
+                # google.cloud.firestore_v1.types.Document
+                document = document_change.document
+
+                data = _helpers.decode_dict(document.fields, self._firestore)
+
+                # Create a snapshot. As Document and Query objects can be
+                # passed we need to get a Document Reference in a more manual
+                # fashion than self._document_reference
+                document_name = document.name
+                db_str = self._firestore._database_string
+                db_str_documents = db_str + "/documents/"
+                if document_name.startswith(db_str_documents):
+                    document_name = document_name[len(db_str_documents) :]
+
+                document_ref = self._firestore.document(document_name)
+
+                snapshot = self.DocumentSnapshot(
+                    reference=document_ref,
+                    data=data,
+                    exists=True,
+                    read_time=None,
+                    create_time=document.create_time,
+                    update_time=document.update_time,
+                )
+                self.change_map[document.name] = snapshot
+
+            elif removed:
+                _LOGGER.debug("on_snapshot: document change: REMOVED")
+                document = document_change.document
+                self.change_map[document.name] = ChangeType.REMOVED
+
+        # NB: document_delete and document_remove (as far as we, the client,
+        # are concerned) are functionally equivalent
+
+        elif str(document_delete):
+            _LOGGER.debug("on_snapshot: document change: DELETE")
+            name = document_delete.document
+            self.change_map[name] = ChangeType.REMOVED
+
+        elif str(document_remove):
+            _LOGGER.debug("on_snapshot: document change: REMOVE")
+            name = document_remove.document
+            self.change_map[name] = ChangeType.REMOVED
+
+        elif filter_:
+            _LOGGER.debug("on_snapshot: filter update")
+            if filter_.count != self._current_size():
+                # We need to remove all the current results.
+                self._reset_docs()
+                # The filter didn't match, so re-issue the query.
+                # TODO: reset stream method?
+                # self._reset_stream();
+
+        elif proto is None:
+            self.close()
+        else:
+            _LOGGER.debug("UNKNOWN TYPE. UHOH")
+            self.close(reason=ValueError("Unknown listen response type: %s" % proto))
+
+    def push(self, read_time, next_resume_token):
+        """
+        Assembles a new snapshot from the current set of changes and invokes
+        the user's callback. Clears the current changes on completion.
+        """
+        deletes, adds, updates = Watch._extract_changes(
+            self.doc_map, self.change_map, read_time
+        )
+
+        updated_tree, updated_map, appliedChanges = self._compute_snapshot(
+            self.doc_tree, self.doc_map, deletes, adds, updates
+        )
+
+        if not self.has_pushed or len(appliedChanges):
+            # TODO: It is possible in the future we will have the tree order
+            # on insert. For now, we sort here.
+            key = functools.cmp_to_key(self._comparator)
+            keys = sorted(updated_tree.keys(), key=key)
+
+            self._snapshot_callback(
+                keys,
+                appliedChanges,
+                datetime.datetime.fromtimestamp(read_time.seconds, pytz.utc),
+            )
+            self.has_pushed = True
+
+        self.doc_tree = updated_tree
+        self.doc_map = updated_map
+        self.change_map.clear()
+        self.resume_token = next_resume_token
+
+    @staticmethod
+    def _extract_changes(doc_map, changes, read_time):
+        deletes = []
+        adds = []
+        updates = []
+
+        for name, value in changes.items():
+            if value == ChangeType.REMOVED:
+                if name in doc_map:
+                    deletes.append(name)
+            elif name in doc_map:
+                if read_time is not None:
+                    value.read_time = read_time
+                updates.append(value)
+            else:
+                if read_time is not None:
+                    value.read_time = read_time
+                adds.append(value)
+
+        return (deletes, adds, updates)
+
+    def _compute_snapshot(
+        self, doc_tree, doc_map, delete_changes, add_changes, update_changes
+    ):
+        updated_tree = doc_tree
+        updated_map = doc_map
+
+        assert len(doc_tree) == len(doc_map), (
+            "The document tree and document map should have the same "
+            + "number of entries."
+        )
+
+        def delete_doc(name, updated_tree, updated_map):
+            """
+            Applies a document delete to the document tree and document map.
+            Returns the corresponding DocumentChange event.
+            """
+            assert name in updated_map, "Document to delete does not exist"
+            old_document = updated_map.get(name)
+            # TODO: If a document doesn't exist this raises IndexError. Handle?
+            existing = updated_tree.find(old_document)
+            old_index = existing.index
+            updated_tree = updated_tree.remove(old_document)
+            del updated_map[name]
+            return (
+                DocumentChange(ChangeType.REMOVED, old_document, old_index, -1),
+                updated_tree,
+                updated_map,
+            )
+
+        def add_doc(new_document, updated_tree, updated_map):
+            """
+            Applies a document add to the document tree and the document map.
+            Returns the corresponding DocumentChange event.
+            """
+            name = new_document.reference._document_path
+            assert name not in updated_map, "Document to add already exists"
+            updated_tree = updated_tree.insert(new_document, None)
+            new_index = updated_tree.find(new_document).index
+            updated_map[name] = new_document
+            return (
+                DocumentChange(ChangeType.ADDED, new_document, -1, new_index),
+                updated_tree,
+                updated_map,
+            )
+
+        def modify_doc(new_document, updated_tree, updated_map):
+            """
+            Applies a document modification to the document tree and the
+            document map.
+            Returns the DocumentChange event for successful modifications.
+            """
+            name = new_document.reference._document_path
+            assert name in updated_map, "Document to modify does not exist"
+            old_document = updated_map.get(name)
+            if old_document.update_time != new_document.update_time:
+                remove_change, updated_tree, updated_map = delete_doc(
+                    name, updated_tree, updated_map
+                )
+                add_change, updated_tree, updated_map = add_doc(
+                    new_document, updated_tree, updated_map
+                )
+                return (
+                    DocumentChange(
+                        ChangeType.MODIFIED,
+                        new_document,
+                        remove_change.old_index,
+                        add_change.new_index,
+                    ),
+                    updated_tree,
+                    updated_map,
+                )
+
+            return None, updated_tree, updated_map
+
+        # Process the sorted changes in the order that is expected by our
+        # clients (removals, additions, and then modifications). We also need
+        # to sort the individual changes to assure that old_index/new_index
+        # keep incrementing.
+        appliedChanges = []
+
+        key = functools.cmp_to_key(self._comparator)
+
+        # Deletes are sorted based on the order of the existing document.
+        delete_changes = sorted(delete_changes)
+        for name in delete_changes:
+            change, updated_tree, updated_map = delete_doc(
+                name, updated_tree, updated_map
+            )
+            appliedChanges.append(change)
+
+        add_changes = sorted(add_changes, key=key)
+        _LOGGER.debug("walk over add_changes")
+        for snapshot in add_changes:
+            _LOGGER.debug("in add_changes")
+            change, updated_tree, updated_map = add_doc(
+                snapshot, updated_tree, updated_map
+            )
+            appliedChanges.append(change)
+
+        update_changes = sorted(update_changes, key=key)
+        for snapshot in update_changes:
+            change, updated_tree, updated_map = modify_doc(
+                snapshot, updated_tree, updated_map
+            )
+            if change is not None:
+                appliedChanges.append(change)
+
+        assert len(updated_tree) == len(updated_map), (
+            "The update document "
+            + "tree and document map should have the same number of entries."
+        )
+        return (updated_tree, updated_map, appliedChanges)
+
+    def _affects_target(self, target_ids, current_id):
+        if target_ids is None:
+            return True
+
+        return current_id in target_ids
+
+    def _current_size(self):
+        """
+        Returns the current count of all documents, including the changes from
+        the current changeMap.
+        """
+        deletes, adds, _ = Watch._extract_changes(self.doc_map, self.change_map, None)
+        return len(self.doc_map) + len(adds) - len(deletes)
+
+    def _reset_docs(self):
+        """
+        Helper to clear the docs on RESET or filter mismatch.
+        """
+        _LOGGER.debug("resetting documents")
+        self.change_map.clear()
+        self.resume_token = None
+
+        # Mark each document as deleted. If documents are not deleted
+        # they will be sent again by the server.
+        for snapshot in self.doc_tree.keys():
+            name = snapshot.reference._document_path
+            self.change_map[name] = ChangeType.REMOVED
+
+        self.current = False
diff --git a/firestore/google/cloud/firestore_v1beta1/__init__.py b/firestore/google/cloud/firestore_v1beta1/__init__.py
new file mode 100644
index 000000000000..f681d84e6a37
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/__init__.py
@@ -0,0 +1,65 @@
+# Copyright 2017 Google LLC 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.
+
+"""Python idiomatic client for Google Cloud Firestore."""
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-firestore").version
+
+from google.cloud.firestore_v1beta1 import types
+from google.cloud.firestore_v1beta1._helpers import GeoPoint
+from google.cloud.firestore_v1beta1._helpers import ExistsOption
+from google.cloud.firestore_v1beta1._helpers import LastUpdateOption
+from google.cloud.firestore_v1beta1._helpers import ReadAfterWriteError
+from google.cloud.firestore_v1beta1._helpers import WriteOption
+from google.cloud.firestore_v1beta1.batch import WriteBatch
+from google.cloud.firestore_v1beta1.client import Client
+from google.cloud.firestore_v1beta1.collection import CollectionReference
+from google.cloud.firestore_v1beta1.transforms import ArrayRemove
+from google.cloud.firestore_v1beta1.transforms import ArrayUnion
+from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+from google.cloud.firestore_v1beta1.document import DocumentReference
+from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+from google.cloud.firestore_v1beta1.gapic import enums
+from google.cloud.firestore_v1beta1.query import Query
+from google.cloud.firestore_v1beta1.transaction import Transaction
+from google.cloud.firestore_v1beta1.transaction import transactional
+from google.cloud.firestore_v1beta1.watch import Watch
+
+
+__all__ = [
+    "__version__",
+    "ArrayRemove",
+    "ArrayUnion",
+    "Client",
+    "CollectionReference",
+    "DELETE_FIELD",
+    "DocumentReference",
+    "DocumentSnapshot",
+    "enums",
+    "ExistsOption",
+    "GeoPoint",
+    "LastUpdateOption",
+    "Query",
+    "ReadAfterWriteError",
+    "SERVER_TIMESTAMP",
+    "Transaction",
+    "transactional",
+    "types",
+    "Watch",
+    "WriteBatch",
+    "WriteOption",
+]
diff --git a/firestore/google/cloud/firestore_v1beta1/_helpers.py b/firestore/google/cloud/firestore_v1beta1/_helpers.py
new file mode 100644
index 000000000000..11dcefc98fad
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/_helpers.py
@@ -0,0 +1,998 @@
+# Copyright 2017 Google LLC 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.
+
+"""Common helpers shared across Google Cloud Firestore modules."""
+
+import datetime
+
+from google.protobuf import struct_pb2
+from google.type import latlng_pb2
+import grpc
+import six
+
+from google.cloud import exceptions
+from google.cloud._helpers import _datetime_to_pb_timestamp
+from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+from google.cloud.firestore_v1beta1 import transforms
+from google.cloud.firestore_v1beta1 import types
+from google.cloud.firestore_v1beta1.field_path import FieldPath
+from google.cloud.firestore_v1beta1.field_path import parse_field_path
+from google.cloud.firestore_v1beta1.gapic import enums
+from google.cloud.firestore_v1beta1.proto import common_pb2
+from google.cloud.firestore_v1beta1.proto import document_pb2
+from google.cloud.firestore_v1beta1.proto import write_pb2
+
+
+BAD_PATH_TEMPLATE = "A path element must be a string. Received {}, which is a {}."
+DOCUMENT_PATH_DELIMITER = "/"
+INACTIVE_TXN = "Transaction not in progress, cannot be used in API requests."
+READ_AFTER_WRITE_ERROR = "Attempted read after write in a transaction."
+BAD_REFERENCE_ERROR = (
+    "Reference value {!r} in unexpected format, expected to be of the form "
+    "``projects/{{project}}/databases/{{database}}/"
+    "documents/{{document_path}}``."
+)
+WRONG_APP_REFERENCE = (
+    "Document {!r} does not correspond to the same database " "({!r}) as the client."
+)
+REQUEST_TIME_ENUM = enums.DocumentTransform.FieldTransform.ServerValue.REQUEST_TIME
+_GRPC_ERROR_MAPPING = {
+    grpc.StatusCode.ALREADY_EXISTS: exceptions.Conflict,
+    grpc.StatusCode.NOT_FOUND: exceptions.NotFound,
+}
+
+
+class GeoPoint(object):
+    """Simple container for a geo point value.
+
+    Args:
+        latitude (float): Latitude of a point.
+        longitude (float): Longitude of a point.
+    """
+
+    def __init__(self, latitude, longitude):
+        self.latitude = latitude
+        self.longitude = longitude
+
+    def to_protobuf(self):
+        """Convert the current object to protobuf.
+
+        Returns:
+            google.type.latlng_pb2.LatLng: The current point as a protobuf.
+        """
+        return latlng_pb2.LatLng(latitude=self.latitude, longitude=self.longitude)
+
+    def __eq__(self, other):
+        """Compare two geo points for equality.
+
+        Returns:
+            Union[bool, NotImplemented]: :data:`True` if the points compare
+            equal, else :data:`False`. (Or :data:`NotImplemented` if
+            ``other`` is not a geo point.)
+        """
+        if not isinstance(other, GeoPoint):
+            return NotImplemented
+
+        return self.latitude == other.latitude and self.longitude == other.longitude
+
+    def __ne__(self, other):
+        """Compare two geo points for inequality.
+
+        Returns:
+            Union[bool, NotImplemented]: :data:`False` if the points compare
+            equal, else :data:`True`. (Or :data:`NotImplemented` if
+            ``other`` is not a geo point.)
+        """
+        equality_val = self.__eq__(other)
+        if equality_val is NotImplemented:
+            return NotImplemented
+        else:
+            return not equality_val
+
+
+def verify_path(path, is_collection):
+    """Verifies that a ``path`` has the correct form.
+
+    Checks that all of the elements in ``path`` are strings.
+
+    Args:
+        path (Tuple[str, ...]): The components in a collection or
+            document path.
+        is_collection (bool): Indicates if the ``path`` represents
+            a document or a collection.
+
+    Raises:
+        ValueError: if
+
+            * the ``path`` is empty
+            * ``is_collection=True`` and there are an even number of elements
+            * ``is_collection=False`` and there are an odd number of elements
+            * an element is not a string
+    """
+    num_elements = len(path)
+    if num_elements == 0:
+        raise ValueError("Document or collection path cannot be empty")
+
+    if is_collection:
+        if num_elements % 2 == 0:
+            raise ValueError("A collection must have an odd number of path elements")
+    else:
+        if num_elements % 2 == 1:
+            raise ValueError("A document must have an even number of path elements")
+
+    for element in path:
+        if not isinstance(element, six.string_types):
+            msg = BAD_PATH_TEMPLATE.format(element, type(element))
+            raise ValueError(msg)
+
+
+def encode_value(value):
+    """Converts a native Python value into a Firestore protobuf ``Value``.
+
+    Args:
+        value (Union[NoneType, bool, int, float, datetime.datetime, \
+            str, bytes, dict, ~google.cloud.Firestore.GeoPoint]): A native
+            Python value to convert to a protobuf field.
+
+    Returns:
+        ~google.cloud.firestore_v1beta1.types.Value: A
+        value encoded as a Firestore protobuf.
+
+    Raises:
+        TypeError: If the ``value`` is not one of the accepted types.
+    """
+    if value is None:
+        return document_pb2.Value(null_value=struct_pb2.NULL_VALUE)
+
+    # Must come before six.integer_types since ``bool`` is an integer subtype.
+    if isinstance(value, bool):
+        return document_pb2.Value(boolean_value=value)
+
+    if isinstance(value, six.integer_types):
+        return document_pb2.Value(integer_value=value)
+
+    if isinstance(value, float):
+        return document_pb2.Value(double_value=value)
+
+    if isinstance(value, DatetimeWithNanoseconds):
+        return document_pb2.Value(timestamp_value=value.timestamp_pb())
+
+    if isinstance(value, datetime.datetime):
+        return document_pb2.Value(timestamp_value=_datetime_to_pb_timestamp(value))
+
+    if isinstance(value, six.text_type):
+        return document_pb2.Value(string_value=value)
+
+    if isinstance(value, six.binary_type):
+        return document_pb2.Value(bytes_value=value)
+
+    # NOTE: We avoid doing an isinstance() check for a Document
+    #       here to avoid import cycles.
+    document_path = getattr(value, "_document_path", None)
+    if document_path is not None:
+        return document_pb2.Value(reference_value=document_path)
+
+    if isinstance(value, GeoPoint):
+        return document_pb2.Value(geo_point_value=value.to_protobuf())
+
+    if isinstance(value, list):
+        value_list = [encode_value(element) for element in value]
+        value_pb = document_pb2.ArrayValue(values=value_list)
+        return document_pb2.Value(array_value=value_pb)
+
+    if isinstance(value, dict):
+        value_dict = encode_dict(value)
+        value_pb = document_pb2.MapValue(fields=value_dict)
+        return document_pb2.Value(map_value=value_pb)
+
+    raise TypeError(
+        "Cannot convert to a Firestore Value", value, "Invalid type", type(value)
+    )
+
+
+def encode_dict(values_dict):
+    """Encode a dictionary into protobuf ``Value``-s.
+
+    Args:
+        values_dict (dict): The dictionary to encode as protobuf fields.
+
+    Returns:
+        Dict[str, ~google.cloud.firestore_v1beta1.types.Value]: A
+        dictionary of string keys and ``Value`` protobufs as dictionary
+        values.
+    """
+    return {key: encode_value(value) for key, value in six.iteritems(values_dict)}
+
+
+def reference_value_to_document(reference_value, client):
+    """Convert a reference value string to a document.
+
+    Args:
+        reference_value (str): A document reference value.
+        client (~.firestore_v1beta1.client.Client): A client that has
+            a document factory.
+
+    Returns:
+        ~.firestore_v1beta1.document.DocumentReference: The document
+        corresponding to ``reference_value``.
+
+    Raises:
+        ValueError: If the ``reference_value`` is not of the expected
+            format: ``projects/{project}/databases/{database}/documents/...``.
+        ValueError: If the ``reference_value`` does not come from the same
+            project / database combination as the ``client``.
+    """
+    # The first 5 parts are
+    # projects, {project}, databases, {database}, documents
+    parts = reference_value.split(DOCUMENT_PATH_DELIMITER, 5)
+    if len(parts) != 6:
+        msg = BAD_REFERENCE_ERROR.format(reference_value)
+        raise ValueError(msg)
+
+    # The sixth part is `a/b/c/d` (i.e. the document path)
+    document = client.document(parts[-1])
+    if document._document_path != reference_value:
+        msg = WRONG_APP_REFERENCE.format(reference_value, client._database_string)
+        raise ValueError(msg)
+
+    return document
+
+
+def decode_value(value, client):
+    """Converts a Firestore protobuf ``Value`` to a native Python value.
+
+    Args:
+        value (google.cloud.firestore_v1beta1.types.Value): A
+            Firestore protobuf to be decoded / parsed / converted.
+        client (~.firestore_v1beta1.client.Client): A client that has
+            a document factory.
+
+    Returns:
+        Union[NoneType, bool, int, float, datetime.datetime, \
+            str, bytes, dict, ~google.cloud.Firestore.GeoPoint]: A native
+        Python value converted from the ``value``.
+
+    Raises:
+        NotImplementedError: If the ``value_type`` is ``reference_value``.
+        ValueError: If the ``value_type`` is unknown.
+    """
+    value_type = value.WhichOneof("value_type")
+
+    if value_type == "null_value":
+        return None
+    elif value_type == "boolean_value":
+        return value.boolean_value
+    elif value_type == "integer_value":
+        return value.integer_value
+    elif value_type == "double_value":
+        return value.double_value
+    elif value_type == "timestamp_value":
+        return DatetimeWithNanoseconds.from_timestamp_pb(value.timestamp_value)
+    elif value_type == "string_value":
+        return value.string_value
+    elif value_type == "bytes_value":
+        return value.bytes_value
+    elif value_type == "reference_value":
+        return reference_value_to_document(value.reference_value, client)
+    elif value_type == "geo_point_value":
+        return GeoPoint(value.geo_point_value.latitude, value.geo_point_value.longitude)
+    elif value_type == "array_value":
+        return [decode_value(element, client) for element in value.array_value.values]
+    elif value_type == "map_value":
+        return decode_dict(value.map_value.fields, client)
+    else:
+        raise ValueError("Unknown ``value_type``", value_type)
+
+
+def decode_dict(value_fields, client):
+    """Converts a protobuf map of Firestore ``Value``-s.
+
+    Args:
+        value_fields (google.protobuf.pyext._message.MessageMapContainer): A
+            protobuf map of Firestore ``Value``-s.
+        client (~.firestore_v1beta1.client.Client): A client that has
+            a document factory.
+
+    Returns:
+        Dict[str, Union[NoneType, bool, int, float, datetime.datetime, \
+            str, bytes, dict, ~google.cloud.Firestore.GeoPoint]]: A dictionary
+        of native Python values converted from the ``value_fields``.
+    """
+    return {
+        key: decode_value(value, client) for key, value in six.iteritems(value_fields)
+    }
+
+
+def get_doc_id(document_pb, expected_prefix):
+    """Parse a document ID from a document protobuf.
+
+    Args:
+        document_pb (google.cloud.proto.firestore.v1beta1.\
+            document_pb2.Document): A protobuf for a document that
+            was created in a ``CreateDocument`` RPC.
+        expected_prefix (str): The expected collection prefix for the
+            fully-qualified document name.
+
+    Returns:
+        str: The document ID from the protobuf.
+
+    Raises:
+        ValueError: If the name does not begin with the prefix.
+    """
+    prefix, document_id = document_pb.name.rsplit(DOCUMENT_PATH_DELIMITER, 1)
+    if prefix != expected_prefix:
+        raise ValueError(
+            "Unexpected document name",
+            document_pb.name,
+            "Expected to begin with",
+            expected_prefix,
+        )
+
+    return document_id
+
+
+_EmptyDict = transforms.Sentinel("Marker for an empty dict value")
+
+
+def extract_fields(document_data, prefix_path, expand_dots=False):
+    """Do depth-first walk of tree, yielding field_path, value"""
+    if not document_data:
+        yield prefix_path, _EmptyDict
+    else:
+        for key, value in sorted(six.iteritems(document_data)):
+
+            if expand_dots:
+                sub_key = FieldPath.from_string(key)
+            else:
+                sub_key = FieldPath(key)
+
+            field_path = FieldPath(*(prefix_path.parts + sub_key.parts))
+
+            if isinstance(value, dict):
+                for s_path, s_value in extract_fields(value, field_path):
+                    yield s_path, s_value
+            else:
+                yield field_path, value
+
+
+def set_field_value(document_data, field_path, value):
+    """Set a value into a document for a field_path"""
+    current = document_data
+    for element in field_path.parts[:-1]:
+        current = current.setdefault(element, {})
+    if value is _EmptyDict:
+        value = {}
+    current[field_path.parts[-1]] = value
+
+
+def get_field_value(document_data, field_path):
+    if not field_path.parts:
+        raise ValueError("Empty path")
+
+    current = document_data
+    for element in field_path.parts[:-1]:
+        current = current[element]
+    return current[field_path.parts[-1]]
+
+
+class DocumentExtractor(object):
+    """ Break document data up into actual data and transforms.
+
+    Handle special values such as ``DELETE_FIELD``, ``SERVER_TIMESTAMP``.
+
+    Args:
+        document_data (dict):
+            Property names and values to use for sending a change to
+            a document.
+    """
+
+    def __init__(self, document_data):
+        self.document_data = document_data
+        self.field_paths = []
+        self.deleted_fields = []
+        self.server_timestamps = []
+        self.array_removes = {}
+        self.array_unions = {}
+        self.set_fields = {}
+        self.empty_document = False
+
+        prefix_path = FieldPath()
+        iterator = self._get_document_iterator(prefix_path)
+
+        for field_path, value in iterator:
+
+            if field_path == prefix_path and value is _EmptyDict:
+                self.empty_document = True
+
+            elif value is transforms.DELETE_FIELD:
+                self.deleted_fields.append(field_path)
+
+            elif value is transforms.SERVER_TIMESTAMP:
+                self.server_timestamps.append(field_path)
+
+            elif isinstance(value, transforms.ArrayRemove):
+                self.array_removes[field_path] = value.values
+
+            elif isinstance(value, transforms.ArrayUnion):
+                self.array_unions[field_path] = value.values
+
+            else:
+                self.field_paths.append(field_path)
+                set_field_value(self.set_fields, field_path, value)
+
+    def _get_document_iterator(self, prefix_path):
+        return extract_fields(self.document_data, prefix_path)
+
+    @property
+    def has_transforms(self):
+        return bool(self.server_timestamps or self.array_removes or self.array_unions)
+
+    @property
+    def transform_paths(self):
+        return sorted(
+            self.server_timestamps + list(self.array_removes) + list(self.array_unions)
+        )
+
+    def _get_update_mask(self, allow_empty_mask=False):
+        return None
+
+    def get_update_pb(self, document_path, exists=None, allow_empty_mask=False):
+
+        if exists is not None:
+            current_document = common_pb2.Precondition(exists=exists)
+        else:
+            current_document = None
+
+        update_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=encode_dict(self.set_fields)
+            ),
+            update_mask=self._get_update_mask(allow_empty_mask),
+            current_document=current_document,
+        )
+
+        return update_pb
+
+    def get_transform_pb(self, document_path, exists=None):
+        def make_array_value(values):
+            value_list = [encode_value(element) for element in values]
+            return document_pb2.ArrayValue(values=value_list)
+
+        path_field_transforms = (
+            [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(),
+                        set_to_server_value=REQUEST_TIME_ENUM,
+                    ),
+                )
+                for path in self.server_timestamps
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(),
+                        remove_all_from_array=make_array_value(values),
+                    ),
+                )
+                for path, values in self.array_removes.items()
+            ]
+            + [
+                (
+                    path,
+                    write_pb2.DocumentTransform.FieldTransform(
+                        field_path=path.to_api_repr(),
+                        append_missing_elements=make_array_value(values),
+                    ),
+                )
+                for path, values in self.array_unions.items()
+            ]
+        )
+        field_transforms = [
+            transform for path, transform in sorted(path_field_transforms)
+        ]
+        transform_pb = write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=field_transforms
+            )
+        )
+        if exists is not None:
+            transform_pb.current_document.CopyFrom(
+                common_pb2.Precondition(exists=exists)
+            )
+
+        return transform_pb
+
+
+def pbs_for_create(document_path, document_data):
+    """Make ``Write`` protobufs for ``create()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        document_data (dict): Property names and values to use for
+            creating a document.
+
+    Returns:
+        List[google.cloud.firestore_v1beta1.types.Write]: One or two
+        ``Write`` protobuf instances for ``create()``.
+    """
+    extractor = DocumentExtractor(document_data)
+
+    if extractor.deleted_fields:
+        raise ValueError("Cannot apply DELETE_FIELD in a create request.")
+
+    write_pbs = []
+
+    # Conformance tests require skipping the 'update_pb' if the document
+    # contains only transforms.
+    if extractor.empty_document or extractor.set_fields:
+        write_pbs.append(extractor.get_update_pb(document_path, exists=False))
+
+    if extractor.has_transforms:
+        exists = None if write_pbs else False
+        transform_pb = extractor.get_transform_pb(document_path, exists)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+def pbs_for_set_no_merge(document_path, document_data):
+    """Make ``Write`` protobufs for ``set()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        document_data (dict): Property names and values to use for
+            replacing a document.
+
+    Returns:
+        List[google.cloud.firestore_v1beta1.types.Write]: One
+        or two ``Write`` protobuf instances for ``set()``.
+    """
+    extractor = DocumentExtractor(document_data)
+
+    if extractor.deleted_fields:
+        raise ValueError(
+            "Cannot apply DELETE_FIELD in a set request without "
+            "specifying 'merge=True' or 'merge=[field_paths]'."
+        )
+
+    # Conformance tests require send the 'update_pb' even if the document
+    # contains only transforms.
+    write_pbs = [extractor.get_update_pb(document_path)]
+
+    if extractor.has_transforms:
+        transform_pb = extractor.get_transform_pb(document_path)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+class DocumentExtractorForMerge(DocumentExtractor):
+    """ Break document data up into actual data and transforms.
+    """
+
+    def __init__(self, document_data):
+        super(DocumentExtractorForMerge, self).__init__(document_data)
+        self.data_merge = []
+        self.transform_merge = []
+        self.merge = []
+
+    @property
+    def has_updates(self):
+        # for whatever reason, the conformance tests want to see the parent
+        # of nested transform paths in the update mask
+        # (see set-st-merge-nonleaf-alone.textproto)
+        update_paths = set(self.data_merge)
+
+        for transform_path in self.transform_paths:
+            if len(transform_path.parts) > 1:
+                parent_fp = FieldPath(*transform_path.parts[:-1])
+                update_paths.add(parent_fp)
+
+        return bool(update_paths)
+
+    def _apply_merge_all(self):
+        self.data_merge = sorted(self.field_paths + self.deleted_fields)
+        # TODO: other transforms
+        self.transform_merge = self.transform_paths
+        self.merge = sorted(self.data_merge + self.transform_paths)
+
+    def _construct_merge_paths(self, merge):
+        for merge_field in merge:
+            if isinstance(merge_field, FieldPath):
+                yield merge_field
+            else:
+                yield FieldPath(*parse_field_path(merge_field))
+
+    def _normalize_merge_paths(self, merge):
+        merge_paths = sorted(self._construct_merge_paths(merge))
+
+        # Raise if any merge path is a parent of another.  Leverage sorting
+        # to avoid quadratic behavior.
+        for index in range(len(merge_paths) - 1):
+            lhs, rhs = merge_paths[index], merge_paths[index + 1]
+            if lhs.eq_or_parent(rhs):
+                raise ValueError("Merge paths overlap: {}, {}".format(lhs, rhs))
+
+        for merge_path in merge_paths:
+            if merge_path in self.deleted_fields:
+                continue
+            try:
+                get_field_value(self.document_data, merge_path)
+            except KeyError:
+                raise ValueError("Invalid merge path: {}".format(merge_path))
+
+        return merge_paths
+
+    def _apply_merge_paths(self, merge):
+
+        if self.empty_document:
+            raise ValueError("Cannot merge specific fields with empty document.")
+
+        merge_paths = self._normalize_merge_paths(merge)
+
+        del self.data_merge[:]
+        del self.transform_merge[:]
+        self.merge = merge_paths
+
+        for merge_path in merge_paths:
+
+            if merge_path in self.transform_paths:
+                self.transform_merge.append(merge_path)
+
+            for field_path in self.field_paths:
+                if merge_path.eq_or_parent(field_path):
+                    self.data_merge.append(field_path)
+
+        # Clear out data for fields not merged.
+        merged_set_fields = {}
+        for field_path in self.data_merge:
+            value = get_field_value(self.document_data, field_path)
+            set_field_value(merged_set_fields, field_path, value)
+        self.set_fields = merged_set_fields
+
+        unmerged_deleted_fields = [
+            field_path
+            for field_path in self.deleted_fields
+            if field_path not in self.merge
+        ]
+        if unmerged_deleted_fields:
+            raise ValueError(
+                "Cannot delete unmerged fields: {}".format(unmerged_deleted_fields)
+            )
+        self.data_merge = sorted(self.data_merge + self.deleted_fields)
+
+        # Keep only transforms which are within merge.
+        merged_transform_paths = set()
+        for merge_path in self.merge:
+            tranform_merge_paths = [
+                transform_path
+                for transform_path in self.transform_paths
+                if merge_path.eq_or_parent(transform_path)
+            ]
+            merged_transform_paths.update(tranform_merge_paths)
+
+        self.server_timestamps = [
+            path for path in self.server_timestamps if path in merged_transform_paths
+        ]
+
+        self.array_removes = {
+            path: values
+            for path, values in self.array_removes.items()
+            if path in merged_transform_paths
+        }
+
+        self.array_unions = {
+            path: values
+            for path, values in self.array_unions.items()
+            if path in merged_transform_paths
+        }
+
+    def apply_merge(self, merge):
+        if merge is True:  # merge all fields
+            self._apply_merge_all()
+        else:
+            self._apply_merge_paths(merge)
+
+    def _get_update_mask(self, allow_empty_mask=False):
+        # Mask uses dotted / quoted paths.
+        mask_paths = [
+            field_path.to_api_repr()
+            for field_path in self.merge
+            if field_path not in self.transform_merge
+        ]
+
+        if mask_paths or allow_empty_mask:
+            return common_pb2.DocumentMask(field_paths=mask_paths)
+
+
+def pbs_for_set_with_merge(document_path, document_data, merge):
+    """Make ``Write`` protobufs for ``set()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        document_data (dict): Property names and values to use for
+            replacing a document.
+        merge (Optional[bool] or Optional[List<apispec>]):
+            If True, merge all fields; else, merge only the named fields.
+
+    Returns:
+        List[google.cloud.firestore_v1beta1.types.Write]: One
+        or two ``Write`` protobuf instances for ``set()``.
+    """
+    extractor = DocumentExtractorForMerge(document_data)
+    extractor.apply_merge(merge)
+
+    merge_empty = not document_data
+
+    write_pbs = []
+
+    if extractor.has_updates or merge_empty:
+        write_pbs.append(
+            extractor.get_update_pb(document_path, allow_empty_mask=merge_empty)
+        )
+
+    if extractor.transform_paths:
+        transform_pb = extractor.get_transform_pb(document_path)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+class DocumentExtractorForUpdate(DocumentExtractor):
+    """ Break document data up into actual data and transforms.
+    """
+
+    def __init__(self, document_data):
+        super(DocumentExtractorForUpdate, self).__init__(document_data)
+        self.top_level_paths = sorted(
+            [FieldPath.from_string(key) for key in document_data]
+        )
+        tops = set(self.top_level_paths)
+        for top_level_path in self.top_level_paths:
+            for ancestor in top_level_path.lineage():
+                if ancestor in tops:
+                    raise ValueError(
+                        "Conflicting field path: {}, {}".format(
+                            top_level_path, ancestor
+                        )
+                    )
+
+        for field_path in self.deleted_fields:
+            if field_path not in tops:
+                raise ValueError(
+                    "Cannot update with nest delete: {}".format(field_path)
+                )
+
+    def _get_document_iterator(self, prefix_path):
+        return extract_fields(self.document_data, prefix_path, expand_dots=True)
+
+    def _get_update_mask(self, allow_empty_mask=False):
+        mask_paths = []
+        for field_path in self.top_level_paths:
+            if field_path not in self.transform_paths:
+                mask_paths.append(field_path.to_api_repr())
+
+        return common_pb2.DocumentMask(field_paths=mask_paths)
+
+
+def pbs_for_update(document_path, field_updates, option):
+    """Make ``Write`` protobufs for ``update()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        field_updates (dict): Field names or paths to update and values
+            to update with.
+        option (optional[~.firestore_v1beta1.client.WriteOption]): A
+           write option to make assertions / preconditions on the server
+           state of the document before applying changes.
+
+    Returns:
+        List[google.cloud.firestore_v1beta1.types.Write]: One
+        or two ``Write`` protobuf instances for ``update()``.
+    """
+    extractor = DocumentExtractorForUpdate(field_updates)
+
+    if extractor.empty_document:
+        raise ValueError("Cannot update with an empty document.")
+
+    if option is None:  # Default is to use ``exists=True``.
+        option = ExistsOption(exists=True)
+
+    write_pbs = []
+
+    if extractor.field_paths or extractor.deleted_fields:
+        update_pb = extractor.get_update_pb(document_path)
+        option.modify_write(update_pb)
+        write_pbs.append(update_pb)
+
+    if extractor.has_transforms:
+        transform_pb = extractor.get_transform_pb(document_path)
+        if not write_pbs:
+            # NOTE: set the write option on the ``transform_pb`` only if there
+            #       is no ``update_pb``
+            option.modify_write(transform_pb)
+        write_pbs.append(transform_pb)
+
+    return write_pbs
+
+
+def pb_for_delete(document_path, option):
+    """Make a ``Write`` protobuf for ``delete()`` methods.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        option (optional[~.firestore_v1beta1.client.WriteOption]): A
+           write option to make assertions / preconditions on the server
+           state of the document before applying changes.
+
+    Returns:
+        google.cloud.firestore_v1beta1.types.Write: A
+        ``Write`` protobuf instance for the ``delete()``.
+    """
+    write_pb = write_pb2.Write(delete=document_path)
+    if option is not None:
+        option.modify_write(write_pb)
+
+    return write_pb
+
+
+class ReadAfterWriteError(Exception):
+    """Raised when a read is attempted after a write.
+
+    Raised by "read" methods that use transactions.
+    """
+
+
+def get_transaction_id(transaction, read_operation=True):
+    """Get the transaction ID from a ``Transaction`` object.
+
+    Args:
+        transaction (Optional[~.firestore_v1beta1.transaction.\
+            Transaction]): An existing transaction that this query will
+            run in.
+        read_operation (Optional[bool]): Indicates if the transaction ID
+            will be used in a read operation. Defaults to :data:`True`.
+
+    Returns:
+        Optional[bytes]: The ID of the transaction, or :data:`None` if the
+        ``transaction`` is :data:`None`.
+
+    Raises:
+        ValueError: If the ``transaction`` is not in progress (only if
+            ``transaction`` is not :data:`None`).
+        ReadAfterWriteError: If the ``transaction`` has writes stored on
+            it and ``read_operation`` is :data:`True`.
+    """
+    if transaction is None:
+        return None
+    else:
+        if not transaction.in_progress:
+            raise ValueError(INACTIVE_TXN)
+        if read_operation and len(transaction._write_pbs) > 0:
+            raise ReadAfterWriteError(READ_AFTER_WRITE_ERROR)
+        return transaction.id
+
+
+def metadata_with_prefix(prefix, **kw):
+    """Create RPC metadata containing a prefix.
+
+    Args:
+        prefix (str): appropriate resource path.
+
+    Returns:
+        List[Tuple[str, str]]: RPC metadata with supplied prefix
+    """
+    return [("google-cloud-resource-prefix", prefix)]
+
+
+class WriteOption(object):
+    """Option used to assert a condition on a write operation."""
+
+    def modify_write(self, write_pb, no_create_msg=None):
+        """Modify a ``Write`` protobuf based on the state of this write option.
+
+        This is a virtual method intended to be implemented by subclasses.
+
+        Args:
+            write_pb (google.cloud.firestore_v1beta1.types.Write): A
+                ``Write`` protobuf instance to be modified with a precondition
+                determined by the state of this option.
+            no_create_msg (Optional[str]): A message to use to indicate that
+                a create operation is not allowed.
+
+        Raises:
+            NotImplementedError: Always, this method is virtual.
+        """
+        raise NotImplementedError
+
+
+class LastUpdateOption(WriteOption):
+    """Option used to assert a "last update" condition on a write operation.
+
+    This will typically be created by
+    :meth:`~google.cloud.firestore_v1beta1.client.Client.write_option`.
+
+    Args:
+        last_update_time (google.protobuf.timestamp_pb2.Timestamp): A
+            timestamp. When set, the target document must exist and have
+            been last updated at that time. Protobuf ``update_time`` timestamps
+            are typically returned from methods that perform write operations
+            as part of a "write result" protobuf or directly.
+    """
+
+    def __init__(self, last_update_time):
+        self._last_update_time = last_update_time
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._last_update_time == other._last_update_time
+
+    def modify_write(self, write_pb, **unused_kwargs):
+        """Modify a ``Write`` protobuf based on the state of this write option.
+
+        The ``last_update_time`` is added to ``write_pb`` as an "update time"
+        precondition. When set, the target document must exist and have been
+        last updated at that time.
+
+        Args:
+            write_pb (google.cloud.firestore_v1beta1.types.Write): A
+                ``Write`` protobuf instance to be modified with a precondition
+                determined by the state of this option.
+            unused_kwargs (Dict[str, Any]): Keyword arguments accepted by
+                other subclasses that are unused here.
+        """
+        current_doc = types.Precondition(update_time=self._last_update_time)
+        write_pb.current_document.CopyFrom(current_doc)
+
+
+class ExistsOption(WriteOption):
+    """Option used to assert existence on a write operation.
+
+    This will typically be created by
+    :meth:`~google.cloud.firestore_v1beta1.client.Client.write_option`.
+
+    Args:
+        exists (bool): Indicates if the document being modified
+            should already exist.
+    """
+
+    def __init__(self, exists):
+        self._exists = exists
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._exists == other._exists
+
+    def modify_write(self, write_pb, **unused_kwargs):
+        """Modify a ``Write`` protobuf based on the state of this write option.
+
+        If:
+
+        * ``exists=True``, adds a precondition that requires existence
+        * ``exists=False``, adds a precondition that requires non-existence
+
+        Args:
+            write_pb (google.cloud.firestore_v1beta1.types.Write): A
+                ``Write`` protobuf instance to be modified with a precondition
+                determined by the state of this option.
+            unused_kwargs (Dict[str, Any]): Keyword arguments accepted by
+                other subclasses that are unused here.
+        """
+        current_doc = types.Precondition(exists=self._exists)
+        write_pb.current_document.CopyFrom(current_doc)
diff --git a/firestore/google/cloud/firestore_v1beta1/batch.py b/firestore/google/cloud/firestore_v1beta1/batch.py
new file mode 100644
index 000000000000..f3e1018abc96
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/batch.py
@@ -0,0 +1,162 @@
+# Copyright 2017 Google LLC 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.
+
+"""Helpers for batch requests to the Google Cloud Firestore API."""
+
+
+from google.cloud.firestore_v1beta1 import _helpers
+
+
+class WriteBatch(object):
+    """Accumulate write operations to be sent in a batch.
+
+    This has the same set of methods for write operations that
+    :class:`~google.cloud.firestore_v1beta1.document.DocumentReference`
+    does, e.g.
+    :meth:`~google.cloud.firestore_v1beta1.document.DocumentReference.create`.
+
+    Args:
+        client (~.firestore_v1beta1.client.Client): The client that
+            created this batch.
+    """
+
+    def __init__(self, client):
+        self._client = client
+        self._write_pbs = []
+        self.write_results = None
+        self.commit_time = None
+
+    def _add_write_pbs(self, write_pbs):
+        """Add `Write`` protobufs to this transaction.
+
+        This method intended to be over-ridden by subclasses.
+
+        Args:
+            write_pbs (List[google.cloud.proto.firestore.v1beta1.\
+                write_pb2.Write]): A list of write protobufs to be added.
+        """
+        self._write_pbs.extend(write_pbs)
+
+    def create(self, reference, document_data):
+        """Add a "change" to this batch to create a document.
+
+        If the document given by ``reference`` already exists, then this
+        batch will fail when :meth:`commit`-ed.
+
+        Args:
+            reference (~.firestore_v1beta1.document.DocumentReference): A
+                document reference to be created in this batch.
+            document_data (dict): Property names and values to use for
+                creating a document.
+        """
+        write_pbs = _helpers.pbs_for_create(reference._document_path, document_data)
+        self._add_write_pbs(write_pbs)
+
+    def set(self, reference, document_data, merge=False):
+        """Add a "change" to replace a document.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.document.DocumentReference.set`
+        for more information on how ``option`` determines how the change is
+        applied.
+
+        Args:
+            reference (~.firestore_v1beta1.document.DocumentReference):
+                A document reference that will have values set in this batch.
+            document_data (dict):
+                Property names and values to use for replacing a document.
+            merge (Optional[bool] or Optional[List<apispec>]):
+                If True, apply merging instead of overwriting the state
+                of the document.
+        """
+        if merge is not False:
+            write_pbs = _helpers.pbs_for_set_with_merge(
+                reference._document_path, document_data, merge
+            )
+        else:
+            write_pbs = _helpers.pbs_for_set_no_merge(
+                reference._document_path, document_data
+            )
+
+        self._add_write_pbs(write_pbs)
+
+    def update(self, reference, field_updates, option=None):
+        """Add a "change" to update a document.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.document.DocumentReference.update`
+        for more information on ``field_updates`` and ``option``.
+
+        Args:
+            reference (~.firestore_v1beta1.document.DocumentReference): A
+               document reference that will be deleted in this batch.
+            field_updates (dict): Field names or paths to update and values
+                to update with.
+            option (Optional[~.firestore_v1beta1.client.WriteOption]): A
+               write option to make assertions / preconditions on the server
+               state of the document before applying changes.
+        """
+        if option.__class__.__name__ == "ExistsOption":
+            raise ValueError("you must not pass an explicit write option to " "update.")
+        write_pbs = _helpers.pbs_for_update(
+            reference._document_path, field_updates, option
+        )
+        self._add_write_pbs(write_pbs)
+
+    def delete(self, reference, option=None):
+        """Add a "change" to delete a document.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.document.DocumentReference.delete`
+        for more information on how ``option`` determines how the change is
+        applied.
+
+        Args:
+            reference (~.firestore_v1beta1.document.DocumentReference): A
+               document reference that will be deleted in this batch.
+            option (Optional[~.firestore_v1beta1.client.WriteOption]): A
+               write option to make assertions / preconditions on the server
+               state of the document before applying changes.
+        """
+        write_pb = _helpers.pb_for_delete(reference._document_path, option)
+        self._add_write_pbs([write_pb])
+
+    def commit(self):
+        """Commit the changes accumulated in this batch.
+
+        Returns:
+            List[google.cloud.proto.firestore.v1beta1.\
+                write_pb2.WriteResult, ...]: The write results corresponding
+            to the changes committed, returned in the same order as the
+            changes were applied to this batch. A write result contains an
+            ``update_time`` field.
+        """
+        commit_response = self._client._firestore_api.commit(
+            self._client._database_string,
+            self._write_pbs,
+            transaction=None,
+            metadata=self._client._rpc_metadata,
+        )
+
+        self._write_pbs = []
+        self.write_results = results = list(commit_response.write_results)
+        self.commit_time = commit_response.commit_time
+        return results
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        if exc_type is None:
+            self.commit()
diff --git a/firestore/google/cloud/firestore_v1beta1/client.py b/firestore/google/cloud/firestore_v1beta1/client.py
new file mode 100644
index 000000000000..50036f0adb30
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/client.py
@@ -0,0 +1,542 @@
+# Copyright 2017 Google LLC 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.
+
+"""Client for interacting with the Google Cloud Firestore API.
+
+This is the base from which all interactions with the API occur.
+
+In the hierarchy of API concepts
+
+* a :class:`~google.cloud.firestore_v1beta1.client.Client` owns a
+  :class:`~google.cloud.firestore_v1beta1.collection.CollectionReference`
+* a :class:`~google.cloud.firestore_v1beta1.client.Client` owns a
+  :class:`~google.cloud.firestore_v1beta1.document.DocumentReference`
+"""
+import warnings
+
+from google.cloud.client import ClientWithProject
+
+from google.cloud.firestore_v1beta1 import _helpers
+from google.cloud.firestore_v1beta1 import types
+from google.cloud.firestore_v1beta1.batch import WriteBatch
+from google.cloud.firestore_v1beta1.collection import CollectionReference
+from google.cloud.firestore_v1beta1.document import DocumentReference
+from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+from google.cloud.firestore_v1beta1.field_path import render_field_path
+from google.cloud.firestore_v1beta1.gapic import firestore_client
+from google.cloud.firestore_v1beta1.gapic.transports import firestore_grpc_transport
+from google.cloud.firestore_v1beta1.transaction import Transaction
+
+
+DEFAULT_DATABASE = "(default)"
+"""str: The default database used in a :class:`~google.cloud.firestore.client.Client`."""
+_BAD_OPTION_ERR = (
+    "Exactly one of ``last_update_time`` or ``exists`` " "must be provided."
+)
+_BAD_DOC_TEMPLATE = (
+    "Document {!r} appeared in response but was not present among references"
+)
+_ACTIVE_TXN = "There is already an active transaction."
+_INACTIVE_TXN = "There is no active transaction."
+_V1BETA1_DEPRECATED_MESSAGE = (
+    "The 'v1beta1' API endpoint is deprecated. "
+    "The client/library which supports it will be removed in a future release."
+)
+
+
+class Client(ClientWithProject):
+    """Client for interacting with Google Cloud Firestore API.
+
+    .. note::
+
+        Since the Cloud Firestore API requires the gRPC transport, no
+        ``_http`` argument is accepted by this class.
+
+    Args:
+        project (Optional[str]): The project which the client acts on behalf
+            of. If not passed, falls back to the default inferred
+            from the environment.
+        credentials (Optional[~google.auth.credentials.Credentials]): The
+            OAuth2 Credentials to use for this client. If not passed, falls
+            back to the default inferred from the environment.
+        database (Optional[str]): The database name that the client targets.
+            For now, :attr:`DEFAULT_DATABASE` (the default value) is the
+            only valid database.
+    """
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/datastore",
+    )
+    """The scopes required for authenticating with the Firestore service."""
+
+    _firestore_api_internal = None
+    _database_string_internal = None
+    _rpc_metadata_internal = None
+
+    def __init__(self, project=None, credentials=None, database=DEFAULT_DATABASE):
+        warnings.warn(_V1BETA1_DEPRECATED_MESSAGE, DeprecationWarning, stacklevel=2)
+        # NOTE: This API has no use for the _http argument, but sending it
+        #       will have no impact since the _http() @property only lazily
+        #       creates a working HTTP object.
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=None
+        )
+        self._database = database
+
+    @property
+    def _firestore_api(self):
+        """Lazy-loading getter GAPIC Firestore API.
+
+        Returns:
+            ~.gapic.firestore.v1beta1.firestore_client.FirestoreClient: The
+            GAPIC client with the credentials of the current client.
+        """
+        if self._firestore_api_internal is None:
+            # Use a custom channel.
+            # We need this in order to set appropriate keepalive options.
+            channel = firestore_grpc_transport.FirestoreGrpcTransport.create_channel(
+                self._target,
+                credentials=self._credentials,
+                options={"grpc.keepalive_time_ms": 30000}.items(),
+            )
+
+            self._transport = firestore_grpc_transport.FirestoreGrpcTransport(
+                address=self._target, channel=channel
+            )
+
+            self._firestore_api_internal = firestore_client.FirestoreClient(
+                transport=self._transport
+            )
+
+        return self._firestore_api_internal
+
+    @property
+    def _target(self):
+        """Return the target (where the API is).
+
+        Returns:
+            str: The location of the API.
+        """
+        return firestore_client.FirestoreClient.SERVICE_ADDRESS
+
+    @property
+    def _database_string(self):
+        """The database string corresponding to this client's project.
+
+        This value is lazy-loaded and cached.
+
+        Will be of the form
+
+            ``projects/{project_id}/databases/{database_id}``
+
+        but ``database_id == '(default)'`` for the time being.
+
+        Returns:
+            str: The fully-qualified database string for the current
+            project. (The default database is also in this string.)
+        """
+        if self._database_string_internal is None:
+            # NOTE: database_root_path() is a classmethod, so we don't use
+            #       self._firestore_api (it isn't necessary).
+            db_str = firestore_client.FirestoreClient.database_root_path(
+                self.project, self._database
+            )
+            self._database_string_internal = db_str
+
+        return self._database_string_internal
+
+    @property
+    def _rpc_metadata(self):
+        """The RPC metadata for this client's associated database.
+
+        Returns:
+            Sequence[Tuple(str, str)]: RPC metadata with resource prefix
+            for the database associated with this client.
+        """
+        if self._rpc_metadata_internal is None:
+            self._rpc_metadata_internal = _helpers.metadata_with_prefix(
+                self._database_string
+            )
+
+        return self._rpc_metadata_internal
+
+    def collection(self, *collection_path):
+        """Get a reference to a collection.
+
+        For a top-level collection:
+
+        .. code-block:: python
+
+            >>> client.collection('top')
+
+        For a sub-collection:
+
+        .. code-block:: python
+
+            >>> client.collection('mydocs/doc/subcol')
+            >>> # is the same as
+            >>> client.collection('mydocs', 'doc', 'subcol')
+
+        Sub-collections can be nested deeper in a similar fashion.
+
+        Args:
+            collection_path (Tuple[str, ...]): Can either be
+
+                * A single ``/``-delimited path to a collection
+                * A tuple of collection path segments
+
+        Returns:
+            ~.firestore_v1beta1.collection.CollectionReference: A reference
+            to a collection in the Firestore database.
+        """
+        if len(collection_path) == 1:
+            path = collection_path[0].split(_helpers.DOCUMENT_PATH_DELIMITER)
+        else:
+            path = collection_path
+
+        return CollectionReference(*path, client=self)
+
+    def document(self, *document_path):
+        """Get a reference to a document in a collection.
+
+        For a top-level document:
+
+        .. code-block:: python
+
+            >>> client.document('collek/shun')
+            >>> # is the same as
+            >>> client.document('collek', 'shun')
+
+        For a document in a sub-collection:
+
+        .. code-block:: python
+
+            >>> client.document('mydocs/doc/subcol/child')
+            >>> # is the same as
+            >>> client.document('mydocs', 'doc', 'subcol', 'child')
+
+        Documents in sub-collections can be nested deeper in a similar fashion.
+
+        Args:
+            document_path (Tuple[str, ...]): Can either be
+
+                * A single ``/``-delimited path to a document
+                * A tuple of document path segments
+
+        Returns:
+            ~.firestore_v1beta1.document.DocumentReference: A reference
+            to a document in a collection.
+        """
+        if len(document_path) == 1:
+            path = document_path[0].split(_helpers.DOCUMENT_PATH_DELIMITER)
+        else:
+            path = document_path
+
+        return DocumentReference(*path, client=self)
+
+    @staticmethod
+    def field_path(*field_names):
+        """Create a **field path** from a list of nested field names.
+
+        A **field path** is a ``.``-delimited concatenation of the field
+        names. It is used to represent a nested field. For example,
+        in the data
+
+        .. code-block:: python
+
+           data = {
+              'aa': {
+                  'bb': {
+                      'cc': 10,
+                  },
+              },
+           }
+
+        the field path ``'aa.bb.cc'`` represents the data stored in
+        ``data['aa']['bb']['cc']``.
+
+        Args:
+            field_names (Tuple[str, ...]): The list of field names.
+
+        Returns:
+            str: The ``.``-delimited field path.
+        """
+        return render_field_path(field_names)
+
+    @staticmethod
+    def write_option(**kwargs):
+        """Create a write option for write operations.
+
+        Write operations include :meth:`~google.cloud.DocumentReference.set`,
+        :meth:`~google.cloud.DocumentReference.update` and
+        :meth:`~google.cloud.DocumentReference.delete`.
+
+        One of the following keyword arguments must be provided:
+
+        * ``last_update_time`` (:class:`google.protobuf.timestamp_pb2.\
+               Timestamp`): A timestamp. When set, the target document must
+               exist and have been last updated at that time. Protobuf
+               ``update_time`` timestamps are typically returned from methods
+               that perform write operations as part of a "write result"
+               protobuf or directly.
+        * ``exists`` (:class:`bool`): Indicates if the document being modified
+              should already exist.
+
+        Providing no argument would make the option have no effect (so
+        it is not allowed). Providing multiple would be an apparent
+        contradiction, since ``last_update_time`` assumes that the
+        document **was** updated (it can't have been updated if it
+        doesn't exist) and ``exists`` indicate that it is unknown if the
+        document exists or not.
+
+        Args:
+            kwargs (Dict[str, Any]): The keyword arguments described above.
+
+        Raises:
+            TypeError: If anything other than exactly one argument is
+                provided by the caller.
+        """
+        if len(kwargs) != 1:
+            raise TypeError(_BAD_OPTION_ERR)
+
+        name, value = kwargs.popitem()
+        if name == "last_update_time":
+            return _helpers.LastUpdateOption(value)
+        elif name == "exists":
+            return _helpers.ExistsOption(value)
+        else:
+            extra = "{!r} was provided".format(name)
+            raise TypeError(_BAD_OPTION_ERR, extra)
+
+    def get_all(self, references, field_paths=None, transaction=None):
+        """Retrieve a batch of documents.
+
+        .. note::
+
+           Documents returned by this method are not guaranteed to be
+           returned in the same order that they are given in ``references``.
+
+        .. note::
+
+           If multiple ``references`` refer to the same document, the server
+           will only return one result.
+
+        See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`
+        for more information on **field paths**.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            references (List[.DocumentReference, ...]): Iterable of document
+                references to be retrieved.
+            field_paths (Optional[Iterable[str, ...]]): An iterable of field
+                paths (``.``-delimited list of field names) to use as a
+                projection of document fields in the returned results. If
+                no value is provided, all fields will be returned.
+            transaction (Optional[~.firestore_v1beta1.transaction.\
+                Transaction]): An existing transaction that these
+                ``references`` will be retrieved in.
+
+        Yields:
+            .DocumentSnapshot: The next document snapshot that fulfills the
+            query, or :data:`None` if the document does not exist.
+        """
+        document_paths, reference_map = _reference_info(references)
+        mask = _get_doc_mask(field_paths)
+        response_iterator = self._firestore_api.batch_get_documents(
+            self._database_string,
+            document_paths,
+            mask,
+            transaction=_helpers.get_transaction_id(transaction),
+            metadata=self._rpc_metadata,
+        )
+
+        for get_doc_response in response_iterator:
+            yield _parse_batch_get(get_doc_response, reference_map, self)
+
+    def collections(self):
+        """List top-level collections of the client's database.
+
+        Returns:
+            Sequence[~.firestore_v1beta1.collection.CollectionReference]:
+                iterator of subcollections of the current document.
+        """
+        iterator = self._firestore_api.list_collection_ids(
+            self._database_string, metadata=self._rpc_metadata
+        )
+        iterator.client = self
+        iterator.item_to_value = _item_to_collection_ref
+        return iterator
+
+    def batch(self):
+        """Get a batch instance from this client.
+
+        Returns:
+            ~.firestore_v1beta1.batch.WriteBatch: A "write" batch to be
+            used for accumulating document changes and sending the changes
+            all at once.
+        """
+        return WriteBatch(self)
+
+    def transaction(self, **kwargs):
+        """Get a transaction that uses this client.
+
+        See :class:`~google.cloud.firestore_v1beta1.transaction.Transaction`
+        for more information on transactions and the constructor arguments.
+
+        Args:
+            kwargs (Dict[str, Any]): The keyword arguments (other than
+                ``client``) to pass along to the
+                :class:`~google.cloud.firestore_v1beta1.transaction.Transaction`
+                constructor.
+
+        Returns:
+            ~.firestore_v1beta1.transaction.Transaction: A transaction
+            attached to this client.
+        """
+        return Transaction(self, **kwargs)
+
+
+def _reference_info(references):
+    """Get information about document references.
+
+    Helper for :meth:`~google.cloud.firestore_v1beta1.client.Client.get_all`.
+
+    Args:
+        references (List[.DocumentReference, ...]): Iterable of document
+            references.
+
+    Returns:
+        Tuple[List[str, ...], Dict[str, .DocumentReference]]: A two-tuple of
+
+        * fully-qualified documents paths for each reference in ``references``
+        * a mapping from the paths to the original reference. (If multiple
+          ``references`` contains multiple references to the same document,
+          that key will be overwritten in the result.)
+    """
+    document_paths = []
+    reference_map = {}
+    for reference in references:
+        doc_path = reference._document_path
+        document_paths.append(doc_path)
+        reference_map[doc_path] = reference
+
+    return document_paths, reference_map
+
+
+def _get_reference(document_path, reference_map):
+    """Get a document reference from a dictionary.
+
+    This just wraps a simple dictionary look-up with a helpful error that is
+    specific to :meth:`~google.cloud.firestore.client.Client.get_all`, the
+    **public** caller of this function.
+
+    Args:
+        document_path (str): A fully-qualified document path.
+        reference_map (Dict[str, .DocumentReference]): A mapping (produced
+            by :func:`_reference_info`) of fully-qualified document paths to
+            document references.
+
+    Returns:
+        .DocumentReference: The matching reference.
+
+    Raises:
+        ValueError: If ``document_path`` has not been encountered.
+    """
+    try:
+        return reference_map[document_path]
+    except KeyError:
+        msg = _BAD_DOC_TEMPLATE.format(document_path)
+        raise ValueError(msg)
+
+
+def _parse_batch_get(get_doc_response, reference_map, client):
+    """Parse a `BatchGetDocumentsResponse` protobuf.
+
+    Args:
+        get_doc_response (~google.cloud.proto.firestore.v1beta1.\
+            firestore_pb2.BatchGetDocumentsResponse): A single response (from
+            a stream) containing the "get" response for a document.
+        reference_map (Dict[str, .DocumentReference]): A mapping (produced
+            by :func:`_reference_info`) of fully-qualified document paths to
+            document references.
+        client (~.firestore_v1beta1.client.Client): A client that has
+            a document factory.
+
+    Returns:
+       [.DocumentSnapshot]: The retrieved snapshot.
+
+    Raises:
+        ValueError: If the response has a ``result`` field (a oneof) other
+            than ``found`` or ``missing``.
+    """
+    result_type = get_doc_response.WhichOneof("result")
+    if result_type == "found":
+        reference = _get_reference(get_doc_response.found.name, reference_map)
+        data = _helpers.decode_dict(get_doc_response.found.fields, client)
+        snapshot = DocumentSnapshot(
+            reference,
+            data,
+            exists=True,
+            read_time=get_doc_response.read_time,
+            create_time=get_doc_response.found.create_time,
+            update_time=get_doc_response.found.update_time,
+        )
+    elif result_type == "missing":
+        snapshot = DocumentSnapshot(
+            None,
+            None,
+            exists=False,
+            read_time=get_doc_response.read_time,
+            create_time=None,
+            update_time=None,
+        )
+    else:
+        raise ValueError(
+            "`BatchGetDocumentsResponse.result` (a oneof) had a field other "
+            "than `found` or `missing` set, or was unset"
+        )
+    return snapshot
+
+
+def _get_doc_mask(field_paths):
+    """Get a document mask if field paths are provided.
+
+    Args:
+        field_paths (Optional[Iterable[str, ...]]): An iterable of field
+            paths (``.``-delimited list of field names) to use as a
+            projection of document fields in the returned results.
+
+    Returns:
+        Optional[google.cloud.firestore_v1beta1.types.DocumentMask]: A mask
+            to project documents to a restricted set of field paths.
+    """
+    if field_paths is None:
+        return None
+    else:
+        return types.DocumentMask(field_paths=field_paths)
+
+
+def _item_to_collection_ref(iterator, item):
+    """Convert collection ID to collection ref.
+
+    Args:
+        iterator (google.api_core.page_iterator.GRPCIterator):
+            iterator response
+        item (str): ID of the collection
+    """
+    return iterator.client.collection(item)
diff --git a/firestore/google/cloud/firestore_v1beta1/collection.py b/firestore/google/cloud/firestore_v1beta1/collection.py
new file mode 100644
index 000000000000..45b1ddae03b3
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/collection.py
@@ -0,0 +1,478 @@
+# Copyright 2017 Google LLC 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.
+
+"""Classes for representing collections for the Google Cloud Firestore API."""
+import random
+import warnings
+
+import six
+
+from google.cloud.firestore_v1beta1 import _helpers
+from google.cloud.firestore_v1beta1 import query as query_mod
+from google.cloud.firestore_v1beta1.proto import document_pb2
+from google.cloud.firestore_v1beta1.watch import Watch
+from google.cloud.firestore_v1beta1 import document
+
+_AUTO_ID_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"
+
+
+class CollectionReference(object):
+    """A reference to a collection in a Firestore database.
+
+    The collection may already exist or this class can facilitate creation
+    of documents within the collection.
+
+    Args:
+        path (Tuple[str, ...]): The components in the collection path.
+            This is a series of strings representing each collection and
+            sub-collection ID, as well as the document IDs for any documents
+            that contain a sub-collection.
+        kwargs (dict): The keyword arguments for the constructor. The only
+            supported keyword is ``client`` and it must be a
+            :class:`~google.cloud.firestore_v1beta1.client.Client` if
+            provided. It represents the client that created this collection
+            reference.
+
+    Raises:
+        ValueError: if
+
+            * the ``path`` is empty
+            * there are an even number of elements
+            * a collection ID in ``path`` is not a string
+            * a document ID in ``path`` is not a string
+        TypeError: If a keyword other than ``client`` is used.
+    """
+
+    def __init__(self, *path, **kwargs):
+        _helpers.verify_path(path, is_collection=True)
+        self._path = path
+        self._client = kwargs.pop("client", None)
+        if kwargs:
+            raise TypeError(
+                "Received unexpected arguments", kwargs, "Only `client` is supported"
+            )
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._path == other._path and self._client == other._client
+
+    @property
+    def id(self):
+        """The collection identifier.
+
+        Returns:
+            str: The last component of the path.
+        """
+        return self._path[-1]
+
+    @property
+    def parent(self):
+        """Document that owns the current collection.
+
+        Returns:
+            Optional[~.firestore_v1beta1.document.DocumentReference]: The
+            parent document, if the current collection is not a
+            top-level collection.
+        """
+        if len(self._path) == 1:
+            return None
+        else:
+            parent_path = self._path[:-1]
+        return self._client.document(*parent_path)
+
+    def document(self, document_id=None):
+        """Create a sub-document underneath the current collection.
+
+        Args:
+            document_id (Optional[str]): The document identifier
+                within the current collection. If not provided, will default
+                to a random 20 character string composed of digits,
+                uppercase and lowercase and letters.
+
+        Returns:
+            ~.firestore_v1beta1.document.DocumentReference: The child
+            document.
+        """
+        if document_id is None:
+            document_id = _auto_id()
+
+        child_path = self._path + (document_id,)
+        return self._client.document(*child_path)
+
+    def _parent_info(self):
+        """Get fully-qualified parent path and prefix for this collection.
+
+        Returns:
+            Tuple[str, str]: Pair of
+
+            * the fully-qualified (with database and project) path to the
+              parent of this collection (will either be the database path
+              or a document path).
+            * the prefix to a document in this collection.
+        """
+        parent_doc = self.parent
+        if parent_doc is None:
+            parent_path = _helpers.DOCUMENT_PATH_DELIMITER.join(
+                (self._client._database_string, "documents")
+            )
+        else:
+            parent_path = parent_doc._document_path
+
+        expected_prefix = _helpers.DOCUMENT_PATH_DELIMITER.join((parent_path, self.id))
+        return parent_path, expected_prefix
+
+    def add(self, document_data, document_id=None):
+        """Create a document in the Firestore database with the provided data.
+
+        Args:
+            document_data (dict): Property names and values to use for
+                creating the document.
+            document_id (Optional[str]): The document identifier within the
+                current collection. If not provided, an ID will be
+                automatically assigned by the server (the assigned ID will be
+                a random 20 character string composed of digits,
+                uppercase and lowercase letters).
+
+        Returns:
+            Tuple[google.protobuf.timestamp_pb2.Timestamp, \
+                ~.firestore_v1beta1.document.DocumentReference]: Pair of
+
+            * The ``update_time`` when the document was created (or
+              overwritten).
+            * A document reference for the created document.
+
+        Raises:
+            ~google.cloud.exceptions.Conflict: If ``document_id`` is provided
+                and the document already exists.
+        """
+        if document_id is None:
+            parent_path, expected_prefix = self._parent_info()
+
+            document_pb = document_pb2.Document()
+
+            created_document_pb = self._client._firestore_api.create_document(
+                parent_path,
+                collection_id=self.id,
+                document_id=None,
+                document=document_pb,
+                mask=None,
+                metadata=self._client._rpc_metadata,
+            )
+
+            new_document_id = _helpers.get_doc_id(created_document_pb, expected_prefix)
+            document_ref = self.document(new_document_id)
+            set_result = document_ref.set(document_data)
+            return set_result.update_time, document_ref
+        else:
+            document_ref = self.document(document_id)
+            write_result = document_ref.create(document_data)
+            return write_result.update_time, document_ref
+
+    def list_documents(self, page_size=None):
+        """List all subdocuments of the current collection.
+
+        Args:
+            page_size (Optional[int]]): The maximum number of documents
+            in each page of results from this request. Non-positive values
+            are ignored. Defaults to a sensible value set by the API.
+
+        Returns:
+            Sequence[~.firestore_v1beta1.collection.DocumentReference]:
+                iterator of subdocuments of the current collection. If the
+                collection does not exist at the time of `snapshot`, the
+                iterator will be empty
+        """
+        parent, _ = self._parent_info()
+
+        iterator = self._client._firestore_api.list_documents(
+            parent,
+            self.id,
+            page_size=page_size,
+            show_missing=True,
+            metadata=self._client._rpc_metadata,
+        )
+        iterator.collection = self
+        iterator.item_to_value = _item_to_document_ref
+        return iterator
+
+    def select(self, field_paths):
+        """Create a "select" query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.select` for
+        more information on this method.
+
+        Args:
+            field_paths (Iterable[str, ...]): An iterable of field paths
+                (``.``-delimited list of field names) to use as a projection
+                of document fields in the query results.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A "projected" query.
+        """
+        query = query_mod.Query(self)
+        return query.select(field_paths)
+
+    def where(self, field_path, op_string, value):
+        """Create a "where" query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.where` for
+        more information on this method.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) for the field to filter on.
+            op_string (str): A comparison operation in the form of a string.
+                Acceptable values are ``<``, ``<=``, ``==``, ``>=``
+                and ``>``.
+            value (Any): The value to compare the field against in the filter.
+                If ``value`` is :data:`None` or a NaN, then ``==`` is the only
+                allowed operation.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A filtered query.
+        """
+        query = query_mod.Query(self)
+        return query.where(field_path, op_string, value)
+
+    def order_by(self, field_path, **kwargs):
+        """Create an "order by" query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by` for
+        more information on this method.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) on which to order the query results.
+            kwargs (Dict[str, Any]): The keyword arguments to pass along
+                to the query. The only supported keyword is ``direction``, see
+                :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by`
+                for more information.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: An "order by" query.
+        """
+        query = query_mod.Query(self)
+        return query.order_by(field_path, **kwargs)
+
+    def limit(self, count):
+        """Create a limited query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.limit` for
+        more information on this method.
+
+        Args:
+            count (int): Maximum number of documents to return that match
+                the query.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A limited query.
+        """
+        query = query_mod.Query(self)
+        return query.limit(count)
+
+    def offset(self, num_to_skip):
+        """Skip to an offset in a query with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.offset` for
+        more information on this method.
+
+        Args:
+            num_to_skip (int): The number of results to skip at the beginning
+                of query results. (Must be non-negative.)
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: An offset query.
+        """
+        query = query_mod.Query(self)
+        return query.offset(num_to_skip)
+
+    def start_at(self, document_fields):
+        """Start query at a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.start_at` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.start_at(document_fields)
+
+    def start_after(self, document_fields):
+        """Start query after a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.start_after` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.start_after(document_fields)
+
+    def end_before(self, document_fields):
+        """End query before a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.end_before` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.end_before(document_fields)
+
+    def end_at(self, document_fields):
+        """End query at a cursor with this collection as parent.
+
+        See
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.end_at` for
+        more information on this method.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor.
+        """
+        query = query_mod.Query(self)
+        return query.end_at(document_fields)
+
+    def get(self, transaction=None):
+        """Deprecated alias for :meth:`stream`."""
+        warnings.warn(
+            "'Collection.get' is deprecated:  please use 'Collection.stream' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.stream(transaction=transaction)
+
+    def stream(self, transaction=None):
+        """Read the documents in this collection.
+
+        This sends a ``RunQuery`` RPC and then returns an iterator which
+        consumes each document returned in the stream of ``RunQueryResponse``
+        messages.
+
+        .. note::
+
+           The underlying stream of responses will time out after
+           the ``max_rpc_timeout_millis`` value set in the GAPIC
+           client configuration for the ``RunQuery`` API.  Snapshots
+           not consumed from the iterator before that point will be lost.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            transaction (Optional[~.firestore_v1beta1.transaction.\
+                Transaction]): An existing transaction that the query will
+                run in.
+
+        Yields:
+            ~.firestore_v1beta1.document.DocumentSnapshot: The next
+            document that fulfills the query.
+        """
+        query = query_mod.Query(self)
+        return query.stream(transaction=transaction)
+
+    def on_snapshot(self, callback):
+        """Monitor the documents in this collection.
+
+        This starts a watch on this collection using a background thread. The
+        provided callback is run on the snapshot of the documents.
+
+        Args:
+            callback(~.firestore.collection.CollectionSnapshot): a callback
+                to run when a change occurs.
+
+        Example:
+            from google.cloud import firestore_v1beta1
+
+            db = firestore_v1beta1.Client()
+            collection_ref = db.collection(u'users')
+
+            def on_snapshot(collection_snapshot):
+                for doc in collection_snapshot.documents:
+                    print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+            # Watch this collection
+            collection_watch = collection_ref.on_snapshot(on_snapshot)
+
+            # Terminate this watch
+            collection_watch.unsubscribe()
+        """
+        return Watch.for_query(
+            query_mod.Query(self),
+            callback,
+            document.DocumentSnapshot,
+            document.DocumentReference,
+        )
+
+
+def _auto_id():
+    """Generate a "random" automatically generated ID.
+
+    Returns:
+        str: A 20 character string composed of digits, uppercase and
+        lowercase and letters.
+    """
+    return "".join(random.choice(_AUTO_ID_CHARS) for _ in six.moves.xrange(20))
+
+
+def _item_to_document_ref(iterator, item):
+    """Convert Document resource to document ref.
+
+    Args:
+        iterator (google.api_core.page_iterator.GRPCIterator):
+            iterator response
+        item (dict): document resource
+    """
+    document_id = item.name.split(_helpers.DOCUMENT_PATH_DELIMITER)[-1]
+    return iterator.collection.document(document_id)
diff --git a/firestore/google/cloud/firestore_v1beta1/document.py b/firestore/google/cloud/firestore_v1beta1/document.py
new file mode 100644
index 000000000000..8efd452556b6
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/document.py
@@ -0,0 +1,780 @@
+# Copyright 2017 Google LLC 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.
+
+"""Classes for representing documents for the Google Cloud Firestore API."""
+
+import copy
+
+import six
+
+from google.api_core import exceptions
+from google.cloud.firestore_v1beta1 import _helpers
+from google.cloud.firestore_v1beta1 import field_path as field_path_module
+from google.cloud.firestore_v1beta1.proto import common_pb2
+from google.cloud.firestore_v1beta1.watch import Watch
+
+
+class DocumentReference(object):
+    """A reference to a document in a Firestore database.
+
+    The document may already exist or can be created by this class.
+
+    Args:
+        path (Tuple[str, ...]): The components in the document path.
+            This is a series of strings representing each collection and
+            sub-collection ID, as well as the document IDs for any documents
+            that contain a sub-collection (as well as the base document).
+        kwargs (dict): The keyword arguments for the constructor. The only
+            supported keyword is ``client`` and it must be a
+            :class:`~google.cloud.firestore_v1beta1.client.Client`.
+            It represents the client that created this document reference.
+
+    Raises:
+        ValueError: if
+
+            * the ``path`` is empty
+            * there are an even number of elements
+            * a collection ID in ``path`` is not a string
+            * a document ID in ``path`` is not a string
+        TypeError: If a keyword other than ``client`` is used.
+    """
+
+    _document_path_internal = None
+
+    def __init__(self, *path, **kwargs):
+        _helpers.verify_path(path, is_collection=False)
+        self._path = path
+        self._client = kwargs.pop("client", None)
+        if kwargs:
+            raise TypeError(
+                "Received unexpected arguments", kwargs, "Only `client` is supported"
+            )
+
+    def __copy__(self):
+        """Shallow copy the instance.
+
+        We leave the client "as-is" but tuple-unpack the path.
+
+        Returns:
+            .DocumentReference: A copy of the current document.
+        """
+        result = self.__class__(*self._path, client=self._client)
+        result._document_path_internal = self._document_path_internal
+        return result
+
+    def __deepcopy__(self, unused_memo):
+        """Deep copy the instance.
+
+        This isn't a true deep copy, wee leave the client "as-is" but
+        tuple-unpack the path.
+
+        Returns:
+            .DocumentReference: A copy of the current document.
+        """
+        return self.__copy__()
+
+    def __eq__(self, other):
+        """Equality check against another instance.
+
+        Args:
+            other (Any): A value to compare against.
+
+        Returns:
+            Union[bool, NotImplementedType]: Indicating if the values are
+            equal.
+        """
+        if isinstance(other, DocumentReference):
+            return self._client == other._client and self._path == other._path
+        else:
+            return NotImplemented
+
+    def __hash__(self):
+        return hash(self._path) + hash(self._client)
+
+    def __ne__(self, other):
+        """Inequality check against another instance.
+
+        Args:
+            other (Any): A value to compare against.
+
+        Returns:
+            Union[bool, NotImplementedType]: Indicating if the values are
+            not equal.
+        """
+        if isinstance(other, DocumentReference):
+            return self._client != other._client or self._path != other._path
+        else:
+            return NotImplemented
+
+    @property
+    def path(self):
+        """Database-relative for this document.
+
+        Returns:
+            str: The document's relative path.
+        """
+        return "/".join(self._path)
+
+    @property
+    def _document_path(self):
+        """Create and cache the full path for this document.
+
+        Of the form:
+
+            ``projects/{project_id}/databases/{database_id}/...
+                  documents/{document_path}``
+
+        Returns:
+            str: The full document path.
+
+        Raises:
+            ValueError: If the current document reference has no ``client``.
+        """
+        if self._document_path_internal is None:
+            if self._client is None:
+                raise ValueError("A document reference requires a `client`.")
+            self._document_path_internal = _get_document_path(self._client, self._path)
+
+        return self._document_path_internal
+
+    @property
+    def id(self):
+        """The document identifier (within its collection).
+
+        Returns:
+            str: The last component of the path.
+        """
+        return self._path[-1]
+
+    @property
+    def parent(self):
+        """Collection that owns the current document.
+
+        Returns:
+            ~.firestore_v1beta1.collection.CollectionReference: The
+            parent collection.
+        """
+        parent_path = self._path[:-1]
+        return self._client.collection(*parent_path)
+
+    def collection(self, collection_id):
+        """Create a sub-collection underneath the current document.
+
+        Args:
+            collection_id (str): The sub-collection identifier (sometimes
+                referred to as the "kind").
+
+        Returns:
+            ~.firestore_v1beta1.collection.CollectionReference: The
+            child collection.
+        """
+        child_path = self._path + (collection_id,)
+        return self._client.collection(*child_path)
+
+    def create(self, document_data):
+        """Create the current document in the Firestore database.
+
+        Args:
+            document_data (dict): Property names and values to use for
+                creating a document.
+
+        Returns:
+            google.cloud.firestore_v1beta1.types.WriteResult: The
+            write result corresponding to the committed document. A write
+            result contains an ``update_time`` field.
+
+        Raises:
+            ~google.cloud.exceptions.Conflict: If the document already exists.
+        """
+        batch = self._client.batch()
+        batch.create(self, document_data)
+        write_results = batch.commit()
+        return _first_write_result(write_results)
+
+    def set(self, document_data, merge=False):
+        """Replace the current document in the Firestore database.
+
+        A write ``option`` can be specified to indicate preconditions of
+        the "set" operation. If no ``option`` is specified and this document
+        doesn't exist yet, this method will create it.
+
+        Overwrites all content for the document with the fields in
+        ``document_data``. This method performs almost the same functionality
+        as :meth:`create`. The only difference is that this method doesn't
+        make any requirements on the existence of the document (unless
+        ``option`` is used), whereas as :meth:`create` will fail if the
+        document already exists.
+
+        Args:
+            document_data (dict): Property names and values to use for
+                replacing a document.
+            merge (Optional[bool] or Optional[List<apispec>]):
+                If True, apply merging instead of overwriting the state
+                of the document.
+
+        Returns:
+            google.cloud.firestore_v1beta1.types.WriteResult: The
+            write result corresponding to the committed document. A write
+            result contains an ``update_time`` field.
+        """
+        batch = self._client.batch()
+        batch.set(self, document_data, merge=merge)
+        write_results = batch.commit()
+        return _first_write_result(write_results)
+
+    def update(self, field_updates, option=None):
+        """Update an existing document in the Firestore database.
+
+        By default, this method verifies that the document exists on the
+        server before making updates. A write ``option`` can be specified to
+        override these preconditions.
+
+        Each key in ``field_updates`` can either be a field name or a
+        **field path** (For more information on **field paths**, see
+        :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`.) To
+        illustrate this, consider a document with
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+               },
+               'other': True,
+           }
+
+        stored on the server. If the field name is used in the update:
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'foo': {
+           ...         'quux': 800,
+           ...     },
+           ... }
+           >>> document.update(field_updates)
+
+        then all of ``foo`` will be overwritten on the server and the new
+        value will be
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'quux': 800,
+               },
+               'other': True,
+           }
+
+        On the other hand, if a ``.``-delimited **field path** is used in the
+        update:
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'foo.quux': 800,
+           ... }
+           >>> document.update(field_updates)
+
+        then only ``foo.quux`` will be updated on the server and the
+        field ``foo.bar`` will remain intact:
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+                   'quux': 800,
+               },
+               'other': True,
+           }
+
+        .. warning::
+
+           A **field path** can only be used as a top-level key in
+           ``field_updates``.
+
+        To delete / remove a field from an existing document, use the
+        :attr:`~google.cloud.firestore_v1beta1.transforms.DELETE_FIELD`
+        sentinel. So with the example above, sending
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'other': firestore.DELETE_FIELD,
+           ... }
+           >>> document.update(field_updates)
+
+        would update the value on the server to:
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+               },
+           }
+
+        To set a field to the current time on the server when the
+        update is received, use the
+        :attr:`~google.cloud.firestore_v1beta1.transforms.SERVER_TIMESTAMP`
+        sentinel.  Sending
+
+        .. code-block:: python
+
+           >>> field_updates = {
+           ...     'foo.now': firestore.SERVER_TIMESTAMP,
+           ... }
+           >>> document.update(field_updates)
+
+        would update the value on the server to:
+
+        .. code-block:: python
+
+           >>> snapshot = document.get()
+           >>> snapshot.to_dict()
+           {
+               'foo': {
+                   'bar': 'baz',
+                   'now': datetime.datetime(2012, ...),
+               },
+               'other': True,
+           }
+
+        Args:
+            field_updates (dict): Field names or paths to update and values
+                to update with.
+            option (Optional[~.firestore_v1beta1.client.WriteOption]): A
+               write option to make assertions / preconditions on the server
+               state of the document before applying changes.
+
+        Returns:
+            google.cloud.firestore_v1beta1.types.WriteResult: The
+            write result corresponding to the updated document. A write
+            result contains an ``update_time`` field.
+
+        Raises:
+            ~google.cloud.exceptions.NotFound: If the document does not exist.
+        """
+        batch = self._client.batch()
+        batch.update(self, field_updates, option=option)
+        write_results = batch.commit()
+        return _first_write_result(write_results)
+
+    def delete(self, option=None):
+        """Delete the current document in the Firestore database.
+
+        Args:
+            option (Optional[~.firestore_v1beta1.client.WriteOption]): A
+               write option to make assertions / preconditions on the server
+               state of the document before applying changes.
+
+        Returns:
+            google.protobuf.timestamp_pb2.Timestamp: The time that the delete
+            request was received by the server. If the document did not exist
+            when the delete was sent (i.e. nothing was deleted), this method
+            will still succeed and will still return the time that the
+            request was received by the server.
+        """
+        write_pb = _helpers.pb_for_delete(self._document_path, option)
+        commit_response = self._client._firestore_api.commit(
+            self._client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=self._client._rpc_metadata,
+        )
+
+        return commit_response.commit_time
+
+    def get(self, field_paths=None, transaction=None):
+        """Retrieve a snapshot of the current document.
+
+        See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`
+        for more information on **field paths**.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            field_paths (Optional[Iterable[str, ...]]): An iterable of field
+                paths (``.``-delimited list of field names) to use as a
+                projection of document fields in the returned results. If
+                no value is provided, all fields will be returned.
+            transaction (Optional[~.firestore_v1beta1.transaction.\
+                Transaction]): An existing transaction that this reference
+                will be retrieved in.
+
+        Returns:
+            ~.firestore_v1beta1.document.DocumentSnapshot: A snapshot of
+                the current document. If the document does not exist at
+                the time of `snapshot`, the snapshot `reference`, `data`,
+                `update_time`, and `create_time` attributes will all be
+                `None` and `exists` will be `False`.
+        """
+        if isinstance(field_paths, six.string_types):
+            raise ValueError("'field_paths' must be a sequence of paths, not a string.")
+
+        if field_paths is not None:
+            mask = common_pb2.DocumentMask(field_paths=sorted(field_paths))
+        else:
+            mask = None
+
+        firestore_api = self._client._firestore_api
+        try:
+            document_pb = firestore_api.get_document(
+                self._document_path,
+                mask=mask,
+                transaction=_helpers.get_transaction_id(transaction),
+                metadata=self._client._rpc_metadata,
+            )
+        except exceptions.NotFound:
+            data = None
+            exists = False
+            create_time = None
+            update_time = None
+        else:
+            data = _helpers.decode_dict(document_pb.fields, self._client)
+            exists = True
+            create_time = document_pb.create_time
+            update_time = document_pb.update_time
+
+        return DocumentSnapshot(
+            reference=self,
+            data=data,
+            exists=exists,
+            read_time=None,  # No server read_time available
+            create_time=create_time,
+            update_time=update_time,
+        )
+
+    def collections(self, page_size=None):
+        """List subcollections of the current document.
+
+        Args:
+            page_size (Optional[int]]): The maximum number of collections
+            in each page of results from this request. Non-positive values
+            are ignored. Defaults to a sensible value set by the API.
+
+        Returns:
+            Sequence[~.firestore_v1beta1.collection.CollectionReference]:
+                iterator of subcollections of the current document. If the
+                document does not exist at the time of `snapshot`, the
+                iterator will be empty
+        """
+        iterator = self._client._firestore_api.list_collection_ids(
+            self._document_path,
+            page_size=page_size,
+            metadata=self._client._rpc_metadata,
+        )
+        iterator.document = self
+        iterator.item_to_value = _item_to_collection_ref
+        return iterator
+
+    def on_snapshot(self, callback):
+        """Watch this document.
+
+        This starts a watch on this document using a background thread. The
+        provided callback is run on the snapshot.
+
+        Args:
+            callback(~.firestore.document.DocumentSnapshot):a callback to run
+                when a change occurs
+
+        Example:
+            from google.cloud import firestore_v1beta1
+
+            db = firestore_v1beta1.Client()
+            collection_ref = db.collection(u'users')
+
+            def on_snapshot(document_snapshot):
+                doc = document_snapshot
+                print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+            doc_ref = db.collection(u'users').document(
+                u'alovelace' + unique_resource_id())
+
+            # Watch this document
+            doc_watch = doc_ref.on_snapshot(on_snapshot)
+
+            # Terminate this watch
+            doc_watch.unsubscribe()
+        """
+        return Watch.for_document(self, callback, DocumentSnapshot, DocumentReference)
+
+
+class DocumentSnapshot(object):
+    """A snapshot of document data in a Firestore database.
+
+    This represents data retrieved at a specific time and may not contain
+    all fields stored for the document (i.e. a hand-picked selection of
+    fields may have been retrieved).
+
+    Instances of this class are not intended to be constructed by hand,
+    rather they'll be returned as responses to various methods, such as
+    :meth:`~google.cloud.DocumentReference.get`.
+
+    Args:
+        reference (~.firestore_v1beta1.document.DocumentReference): A
+            document reference corresponding to the document that contains
+            the data in this snapshot.
+        data (Dict[str, Any]): The data retrieved in the snapshot.
+        exists (bool): Indicates if the document existed at the time the
+            snapshot was retrieved.
+        read_time (google.protobuf.timestamp_pb2.Timestamp): The time that
+            this snapshot was read from the server.
+        create_time (google.protobuf.timestamp_pb2.Timestamp): The time that
+            this document was created.
+        update_time (google.protobuf.timestamp_pb2.Timestamp): The time that
+            this document was last updated.
+    """
+
+    def __init__(self, reference, data, exists, read_time, create_time, update_time):
+        self._reference = reference
+        # We want immutable data, so callers can't modify this value
+        # out from under us.
+        self._data = copy.deepcopy(data)
+        self._exists = exists
+        self.read_time = read_time
+        """google.protobuf.timestamp_pb2.Timestamp: Time snapshot was read."""
+        self.create_time = create_time
+        """google.protobuf.timestamp_pb2.Timestamp: Document's creation."""
+        self.update_time = update_time
+        """google.protobuf.timestamp_pb2.Timestamp: Document's last update."""
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._reference == other._reference and self._data == other._data
+
+    def __hash__(self):
+        seconds = self.update_time.seconds
+        nanos = self.update_time.nanos
+        return hash(self._reference) + hash(seconds) + hash(nanos)
+
+    @property
+    def _client(self):
+        """The client that owns the document reference for this snapshot.
+
+        Returns:
+            ~.firestore_v1beta1.client.Client: The client that owns this
+            document.
+        """
+        return self._reference._client
+
+    @property
+    def exists(self):
+        """Existence flag.
+
+        Indicates if the document existed at the time this snapshot
+        was retrieved.
+
+        Returns:
+            bool: The existence flag.
+        """
+        return self._exists
+
+    @property
+    def id(self):
+        """The document identifier (within its collection).
+
+        Returns:
+            str: The last component of the path of the document.
+        """
+        return self._reference.id
+
+    @property
+    def reference(self):
+        """Document reference corresponding to document that owns this data.
+
+        Returns:
+            ~.firestore_v1beta1.document.DocumentReference: A document
+            reference corresponding to this document.
+        """
+        return self._reference
+
+    def get(self, field_path):
+        """Get a value from the snapshot data.
+
+        If the data is nested, for example:
+
+        .. code-block:: python
+
+           >>> snapshot.to_dict()
+           {
+               'top1': {
+                   'middle2': {
+                       'bottom3': 20,
+                       'bottom4': 22,
+                   },
+                   'middle5': True,
+               },
+               'top6': b'\x00\x01 foo',
+           }
+
+        a **field path** can be used to access the nested data. For
+        example:
+
+        .. code-block:: python
+
+           >>> snapshot.get('top1')
+           {
+               'middle2': {
+                   'bottom3': 20,
+                   'bottom4': 22,
+               },
+               'middle5': True,
+           }
+           >>> snapshot.get('top1.middle2')
+           {
+               'bottom3': 20,
+               'bottom4': 22,
+           }
+           >>> snapshot.get('top1.middle2.bottom3')
+           20
+
+        See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`
+        for more information on **field paths**.
+
+        A copy is returned since the data may contain mutable values,
+        but the data stored in the snapshot must remain immutable.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names).
+
+        Returns:
+            Any or None:
+                (A copy of) the value stored for the ``field_path`` or
+                None if snapshot document does not exist.
+
+        Raises:
+            KeyError: If the ``field_path`` does not match nested data
+                in the snapshot.
+        """
+        if not self._exists:
+            return None
+        nested_data = field_path_module.get_nested_value(field_path, self._data)
+        return copy.deepcopy(nested_data)
+
+    def to_dict(self):
+        """Retrieve the data contained in this snapshot.
+
+        A copy is returned since the data may contain mutable values,
+        but the data stored in the snapshot must remain immutable.
+
+        Returns:
+            Dict[str, Any] or None:
+                The data in the snapshot.  Returns None if reference
+                does not exist.
+        """
+        if not self._exists:
+            return None
+        return copy.deepcopy(self._data)
+
+
+def _get_document_path(client, path):
+    """Convert a path tuple into a full path string.
+
+    Of the form:
+
+        ``projects/{project_id}/databases/{database_id}/...
+              documents/{document_path}``
+
+    Args:
+        client (~.firestore_v1beta1.client.Client): The client that holds
+            configuration details and a GAPIC client object.
+        path (Tuple[str, ...]): The components in a document path.
+
+    Returns:
+        str: The fully-qualified document path.
+    """
+    parts = (client._database_string, "documents") + path
+    return _helpers.DOCUMENT_PATH_DELIMITER.join(parts)
+
+
+def _consume_single_get(response_iterator):
+    """Consume a gRPC stream that should contain a single response.
+
+    The stream will correspond to a ``BatchGetDocuments`` request made
+    for a single document.
+
+    Args:
+        response_iterator (~google.cloud.exceptions.GrpcRendezvous): A
+            streaming iterator returned from a ``BatchGetDocuments``
+            request.
+
+    Returns:
+        ~google.cloud.proto.firestore.v1beta1.\
+            firestore_pb2.BatchGetDocumentsResponse: The single "get"
+        response in the batch.
+
+    Raises:
+        ValueError: If anything other than exactly one response is returned.
+    """
+    # Calling ``list()`` consumes the entire iterator.
+    all_responses = list(response_iterator)
+    if len(all_responses) != 1:
+        raise ValueError(
+            "Unexpected response from `BatchGetDocumentsResponse`",
+            all_responses,
+            "Expected only one result",
+        )
+
+    return all_responses[0]
+
+
+def _first_write_result(write_results):
+    """Get first write result from list.
+
+    For cases where ``len(write_results) > 1``, this assumes the writes
+    occurred at the same time (e.g. if an update and transform are sent
+    at the same time).
+
+    Args:
+        write_results (List[google.cloud.proto.firestore.v1beta1.\
+            write_pb2.WriteResult, ...]: The write results from a
+            ``CommitResponse``.
+
+    Returns:
+        google.cloud.firestore_v1beta1.types.WriteResult: The
+        lone write result from ``write_results``.
+
+    Raises:
+        ValueError: If there are zero write results. This is likely to
+            **never** occur, since the backend should be stable.
+    """
+    if not write_results:
+        raise ValueError("Expected at least one write result")
+
+    return write_results[0]
+
+
+def _item_to_collection_ref(iterator, item):
+    """Convert collection ID to collection ref.
+
+    Args:
+        iterator (google.api_core.page_iterator.GRPCIterator):
+            iterator response
+        item (str): ID of the collection
+    """
+    return iterator.document.collection(item)
diff --git a/firestore/google/cloud/firestore_v1beta1/field_path.py b/firestore/google/cloud/firestore_v1beta1/field_path.py
new file mode 100644
index 000000000000..1570aefb57a7
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/field_path.py
@@ -0,0 +1,386 @@
+# 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.
+
+"""Utilities for managing / converting field paths to / from strings."""
+
+try:
+    from collections import abc as collections_abc
+except ImportError:  # Python 2.7
+    import collections as collections_abc
+
+import re
+
+import six
+
+
+_FIELD_PATH_MISSING_TOP = "{!r} is not contained in the data"
+_FIELD_PATH_MISSING_KEY = "{!r} is not contained in the data for the key {!r}"
+_FIELD_PATH_WRONG_TYPE = (
+    "The data at {!r} is not a dictionary, so it cannot contain the key {!r}"
+)
+
+_FIELD_PATH_DELIMITER = "."
+_BACKSLASH = "\\"
+_ESCAPED_BACKSLASH = _BACKSLASH * 2
+_BACKTICK = "`"
+_ESCAPED_BACKTICK = _BACKSLASH + _BACKTICK
+
+_SIMPLE_FIELD_NAME = re.compile("^[_a-zA-Z][_a-zA-Z0-9]*$")
+_LEADING_ALPHA_INVALID = re.compile("^[_a-zA-Z][_a-zA-Z0-9]*[^_a-zA-Z0-9]")
+PATH_ELEMENT_TOKENS = [
+    ("SIMPLE", r"[_a-zA-Z][_a-zA-Z0-9]*"),  # unquoted elements
+    ("QUOTED", r"`(?:\\`|[^`])*?`"),  # quoted elements, unquoted
+    ("DOT", r"\."),  # separator
+]
+TOKENS_PATTERN = "|".join("(?P<{}>{})".format(*pair) for pair in PATH_ELEMENT_TOKENS)
+TOKENS_REGEX = re.compile(TOKENS_PATTERN)
+
+
+def _tokenize_field_path(path):
+    """Lex a field path into tokens (including dots).
+
+    Args:
+        path (str): field path to be lexed.
+    Returns:
+        List(str): tokens
+    """
+    pos = 0
+    get_token = TOKENS_REGEX.match
+    match = get_token(path)
+    while match is not None:
+        type_ = match.lastgroup
+        value = match.group(type_)
+        yield value
+        pos = match.end()
+        match = get_token(path, pos)
+    if pos != len(path):
+        raise ValueError("Path {} not consumed, residue: {}".format(path, path[pos:]))
+
+
+def split_field_path(path):
+    """Split a field path into valid elements (without dots).
+
+    Args:
+        path (str): field path to be lexed.
+    Returns:
+        List(str): tokens
+    Raises:
+        ValueError: if the path does not match the elements-interspersed-
+                    with-dots pattern.
+    """
+    if not path:
+        return []
+
+    elements = []
+    want_dot = False
+
+    for element in _tokenize_field_path(path):
+        if want_dot:
+            if element != ".":
+                raise ValueError("Invalid path: {}".format(path))
+            else:
+                want_dot = False
+        else:
+            if element == ".":
+                raise ValueError("Invalid path: {}".format(path))
+            elements.append(element)
+            want_dot = True
+
+    if not want_dot or not elements:
+        raise ValueError("Invalid path: {}".format(path))
+
+    return elements
+
+
+def parse_field_path(api_repr):
+    """Parse a **field path** from into a list of nested field names.
+
+    See :func:`field_path` for more on **field paths**.
+
+    Args:
+        api_repr (str):
+            The unique Firestore api representation which consists of
+            either simple or UTF-8 field names. It cannot exceed
+            1500 bytes, and cannot be empty. Simple field names match
+            ``'^[_a-zA-Z][_a-zA-Z0-9]*$'``. All other field names are
+            escaped by surrounding them with backticks.
+
+    Returns:
+        List[str, ...]: The list of field names in the field path.
+    """
+    # code dredged back up from
+    # https://github.com/googleapis/google-cloud-python/pull/5109/files
+    field_names = []
+    for field_name in split_field_path(api_repr):
+        # non-simple field name
+        if field_name[0] == "`" and field_name[-1] == "`":
+            field_name = field_name[1:-1]
+            field_name = field_name.replace(_ESCAPED_BACKTICK, _BACKTICK)
+            field_name = field_name.replace(_ESCAPED_BACKSLASH, _BACKSLASH)
+        field_names.append(field_name)
+    return field_names
+
+
+def render_field_path(field_names):
+    """Create a **field path** from a list of nested field names.
+
+    A **field path** is a ``.``-delimited concatenation of the field
+    names. It is used to represent a nested field. For example,
+    in the data
+
+    .. code-block: python
+
+       data = {
+          'aa': {
+              'bb': {
+                  'cc': 10,
+              },
+          },
+       }
+
+    the field path ``'aa.bb.cc'`` represents that data stored in
+    ``data['aa']['bb']['cc']``.
+
+    Args:
+        field_names (Iterable[str, ...]): The list of field names.
+
+    Returns:
+        str: The ``.``-delimited field path.
+    """
+    result = []
+
+    for field_name in field_names:
+        match = _SIMPLE_FIELD_NAME.match(field_name)
+        if match and match.group(0) == field_name:
+            result.append(field_name)
+        else:
+            replaced = field_name.replace(_BACKSLASH, _ESCAPED_BACKSLASH).replace(
+                _BACKTICK, _ESCAPED_BACKTICK
+            )
+            result.append(_BACKTICK + replaced + _BACKTICK)
+
+    return _FIELD_PATH_DELIMITER.join(result)
+
+
+get_field_path = render_field_path  # backward-compatibility
+
+
+def get_nested_value(field_path, data):
+    """Get a (potentially nested) value from a dictionary.
+
+    If the data is nested, for example:
+
+    .. code-block:: python
+
+       >>> data
+       {
+           'top1': {
+               'middle2': {
+                   'bottom3': 20,
+                   'bottom4': 22,
+               },
+               'middle5': True,
+           },
+           'top6': b'\x00\x01 foo',
+       }
+
+    a **field path** can be used to access the nested data. For
+    example:
+
+    .. code-block:: python
+
+       >>> get_nested_value('top1', data)
+       {
+           'middle2': {
+               'bottom3': 20,
+               'bottom4': 22,
+           },
+           'middle5': True,
+       }
+       >>> get_nested_value('top1.middle2', data)
+       {
+           'bottom3': 20,
+           'bottom4': 22,
+       }
+       >>> get_nested_value('top1.middle2.bottom3', data)
+       20
+
+    See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path` for
+    more information on **field paths**.
+
+    Args:
+        field_path (str): A field path (``.``-delimited list of
+            field names).
+        data (Dict[str, Any]): The (possibly nested) data.
+
+    Returns:
+        Any: (A copy of) the value stored for the ``field_path``.
+
+    Raises:
+        KeyError: If the ``field_path`` does not match nested data.
+    """
+    field_names = parse_field_path(field_path)
+
+    nested_data = data
+    for index, field_name in enumerate(field_names):
+        if isinstance(nested_data, collections_abc.Mapping):
+            if field_name in nested_data:
+                nested_data = nested_data[field_name]
+            else:
+                if index == 0:
+                    msg = _FIELD_PATH_MISSING_TOP.format(field_name)
+                    raise KeyError(msg)
+                else:
+                    partial = render_field_path(field_names[:index])
+                    msg = _FIELD_PATH_MISSING_KEY.format(field_name, partial)
+                    raise KeyError(msg)
+        else:
+            partial = render_field_path(field_names[:index])
+            msg = _FIELD_PATH_WRONG_TYPE.format(partial, field_name)
+            raise KeyError(msg)
+
+    return nested_data
+
+
+class FieldPath(object):
+    """Field Path object for client use.
+
+    A field path is a sequence of element keys, separated by periods.
+    Each element key can be either a simple identifier, or a full unicode
+    string.
+
+    In the string representation of a field path, non-identifier elements
+    must be quoted using backticks, with internal backticks and backslashes
+    escaped with a backslash.
+
+    Args:
+        parts: (one or more strings)
+            Indicating path of the key to be used.
+    """
+
+    def __init__(self, *parts):
+        for part in parts:
+            if not isinstance(part, six.string_types) or not part:
+                error = "One or more components is not a string or is empty."
+                raise ValueError(error)
+        self.parts = tuple(parts)
+
+    @classmethod
+    def from_api_repr(cls, api_repr):
+        """Factory: create a FieldPath from the string formatted per the API.
+
+        Args:
+            api_repr (str): a string path, with non-identifier elements quoted
+            It cannot exceed 1500 characters, and cannot be empty.
+        Returns:
+            (:class:`FieldPath`) An instance parsed from ``api_repr``.
+        Raises:
+            ValueError if the parsing fails
+        """
+        api_repr = api_repr.strip()
+        if not api_repr:
+            raise ValueError("Field path API representation cannot be empty.")
+        return cls(*parse_field_path(api_repr))
+
+    @classmethod
+    def from_string(cls, path_string):
+        """Factory: create a FieldPath from a unicode string representation.
+
+        This method splits on the character `.` and disallows the
+        characters `~*/[]`. To create a FieldPath whose components have
+        those characters, call the constructor.
+
+        Args:
+            path_string (str): A unicode string which cannot contain
+            `~*/[]` characters, cannot exceed 1500 bytes, and cannot be empty.
+
+        Returns:
+            (:class:`FieldPath`) An instance parsed from ``path_string``.
+        """
+        try:
+            return cls.from_api_repr(path_string)
+        except ValueError:
+            elements = path_string.split(".")
+            for element in elements:
+                if not element:
+                    raise ValueError("Empty element")
+                if _LEADING_ALPHA_INVALID.match(element):
+                    raise ValueError(
+                        "Non-alphanum char in element with leading alpha: {}".format(
+                            element
+                        )
+                    )
+            return FieldPath(*elements)
+
+    def __repr__(self):
+        paths = ""
+        for part in self.parts:
+            paths += "'" + part + "',"
+        paths = paths[:-1]
+        return "FieldPath({})".format(paths)
+
+    def __hash__(self):
+        return hash(self.to_api_repr())
+
+    def __eq__(self, other):
+        if isinstance(other, FieldPath):
+            return self.parts == other.parts
+        return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, FieldPath):
+            return self.parts < other.parts
+        return NotImplemented
+
+    def __add__(self, other):
+        """Adds `other` field path to end of this field path.
+
+        Args:
+            other (~google.cloud.firestore_v1beta1._helpers.FieldPath, str):
+                The field path to add to the end of this `FieldPath`.
+        """
+        if isinstance(other, FieldPath):
+            parts = self.parts + other.parts
+            return FieldPath(*parts)
+        elif isinstance(other, six.string_types):
+            parts = self.parts + FieldPath.from_string(other).parts
+            return FieldPath(*parts)
+        else:
+            return NotImplemented
+
+    def to_api_repr(self):
+        """Render a quoted string representation of the FieldPath
+
+        Returns:
+            (str) Quoted string representation of the path stored
+            within this FieldPath.
+        """
+        return render_field_path(self.parts)
+
+    def eq_or_parent(self, other):
+        """Check whether ``other`` is an ancestor.
+
+        Returns:
+            (bool) True IFF ``other`` is an ancestor or equal to ``self``,
+            else False.
+        """
+        return self.parts[: len(other.parts)] == other.parts[: len(self.parts)]
+
+    def lineage(self):
+        """Return field paths for all parents.
+
+        Returns: Set[:class:`FieldPath`]
+        """
+        indexes = six.moves.range(1, len(self.parts))
+        return {FieldPath(*self.parts[:index]) for index in indexes}
diff --git a/firestore/google/cloud/firestore_v1beta1/gapic/__init__.py b/firestore/google/cloud/firestore_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1beta1/gapic/enums.py b/firestore/google/cloud/firestore_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..833761db83ba
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/gapic/enums.py
@@ -0,0 +1,148 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class DocumentTransform(object):
+    class FieldTransform(object):
+        class ServerValue(enum.IntEnum):
+            """
+            A value that is calculated by the server.
+
+            Attributes:
+              SERVER_VALUE_UNSPECIFIED (int): Unspecified. This value must not be used.
+              REQUEST_TIME (int): The time at which the server processed the request, with millisecond
+              precision.
+            """
+
+            SERVER_VALUE_UNSPECIFIED = 0
+            REQUEST_TIME = 1
+
+
+class StructuredQuery(object):
+    class Direction(enum.IntEnum):
+        """
+        A sort direction.
+
+        Attributes:
+          DIRECTION_UNSPECIFIED (int): Unspecified.
+          ASCENDING (int): Ascending.
+          DESCENDING (int): Descending.
+        """
+
+        DIRECTION_UNSPECIFIED = 0
+        ASCENDING = 1
+        DESCENDING = 2
+
+    class CompositeFilter(object):
+        class Operator(enum.IntEnum):
+            """
+            A composite filter operator.
+
+            Attributes:
+              OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+              AND (int): The results are required to satisfy each of the combined filters.
+            """
+
+            OPERATOR_UNSPECIFIED = 0
+            AND = 1
+
+    class FieldFilter(object):
+        class Operator(enum.IntEnum):
+            """
+            A field filter operator.
+
+            Attributes:
+              OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+              LESS_THAN (int): Less than. Requires that the field come first in ``order_by``.
+              LESS_THAN_OR_EQUAL (int): Less than or equal. Requires that the field come first in ``order_by``.
+              GREATER_THAN (int): Greater than. Requires that the field come first in ``order_by``.
+              GREATER_THAN_OR_EQUAL (int): Greater than or equal. Requires that the field come first in
+              ``order_by``.
+              EQUAL (int): Equal.
+              ARRAY_CONTAINS (int): Contains. Requires that the field is an array.
+            """
+
+            OPERATOR_UNSPECIFIED = 0
+            LESS_THAN = 1
+            LESS_THAN_OR_EQUAL = 2
+            GREATER_THAN = 3
+            GREATER_THAN_OR_EQUAL = 4
+            EQUAL = 5
+            ARRAY_CONTAINS = 7
+
+    class UnaryFilter(object):
+        class Operator(enum.IntEnum):
+            """
+            A unary operator.
+
+            Attributes:
+              OPERATOR_UNSPECIFIED (int): Unspecified. This value must not be used.
+              IS_NAN (int): Test if a field is equal to NaN.
+              IS_NULL (int): Test if an exprestion evaluates to Null.
+            """
+
+            OPERATOR_UNSPECIFIED = 0
+            IS_NAN = 2
+            IS_NULL = 3
+
+
+class TargetChange(object):
+    class TargetChangeType(enum.IntEnum):
+        """
+        The type of change.
+
+        Attributes:
+          NO_CHANGE (int): No change has occurred. Used only to send an updated ``resume_token``.
+          ADD (int): The targets have been added.
+          REMOVE (int): The targets have been removed.
+          CURRENT (int): The targets reflect all changes committed before the targets were added
+          to the stream.
+
+          This will be sent after or with a ``read_time`` that is greater than or
+          equal to the time at which the targets were added.
+
+          Listeners can wait for this change if read-after-write semantics are
+          desired.
+          RESET (int): The targets have been reset, and a new initial state for the targets
+          will be returned in subsequent changes.
+
+          After the initial state is complete, ``CURRENT`` will be returned even
+          if the target was previously indicated to be ``CURRENT``.
+        """
+
+        NO_CHANGE = 0
+        ADD = 1
+        REMOVE = 2
+        CURRENT = 3
+        RESET = 4
diff --git a/firestore/google/cloud/firestore_v1beta1/gapic/firestore_client.py b/firestore/google/cloud/firestore_v1beta1/gapic/firestore_client.py
new file mode 100644
index 000000000000..b6fb69e31001
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/gapic/firestore_client.py
@@ -0,0 +1,1461 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.firestore.v1beta1 Firestore API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.firestore_v1beta1.gapic import enums
+from google.cloud.firestore_v1beta1.gapic import firestore_client_config
+from google.cloud.firestore_v1beta1.gapic.transports import firestore_grpc_transport
+from google.cloud.firestore_v1beta1.proto import common_pb2
+from google.cloud.firestore_v1beta1.proto import document_pb2
+from google.cloud.firestore_v1beta1.proto import firestore_pb2
+from google.cloud.firestore_v1beta1.proto import firestore_pb2_grpc
+from google.cloud.firestore_v1beta1.proto import query_pb2
+from google.cloud.firestore_v1beta1.proto import write_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-firestore"
+).version
+
+
+class FirestoreClient(object):
+    """
+    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.
+    """
+
+    SERVICE_ADDRESS = "firestore.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.firestore.v1beta1.Firestore"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            FirestoreClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def any_path_path(cls, project, database, document, any_path):
+        """Return a fully-qualified any_path string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/documents/{document}/{any_path=**}",
+            project=project,
+            database=database,
+            document=document,
+            any_path=any_path,
+        )
+
+    @classmethod
+    def database_root_path(cls, project, database):
+        """Return a fully-qualified database_root string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}",
+            project=project,
+            database=database,
+        )
+
+    @classmethod
+    def document_path_path(cls, project, database, document_path):
+        """Return a fully-qualified document_path string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/documents/{document_path=**}",
+            project=project,
+            database=database,
+            document_path=document_path,
+        )
+
+    @classmethod
+    def document_root_path(cls, project, database):
+        """Return a fully-qualified document_root string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/databases/{database}/documents",
+            project=project,
+            database=database,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.FirestoreGrpcTransport,
+                    Callable[[~.Credentials, type], ~.FirestoreGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = firestore_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=firestore_grpc_transport.FirestoreGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = firestore_grpc_transport.FirestoreGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def get_document(
+        self,
+        name,
+        mask=None,
+        transaction=None,
+        read_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single document.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> name = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> response = client.get_document(name)
+
+        Args:
+            name (str): The resource name of the Document to get. In the format:
+                ``projects/{project_id}/databases/{database_id}/documents/{document_path}``.
+            mask (Union[dict, ~google.cloud.firestore_v1beta1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If the document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.DocumentMask`
+            transaction (bytes): Reads the document in a transaction.
+            read_time (Union[dict, ~google.cloud.firestore_v1beta1.types.Timestamp]): Reads the version of the document at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1beta1.types.Document` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_document,
+                default_retry=self._method_configs["GetDocument"].retry,
+                default_timeout=self._method_configs["GetDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction, read_time=read_time
+        )
+
+        request = firestore_pb2.GetDocumentRequest(
+            name=name, mask=mask, transaction=transaction, read_time=read_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_documents(
+        self,
+        parent,
+        collection_id,
+        page_size=None,
+        order_by=None,
+        mask=None,
+        transaction=None,
+        read_time=None,
+        show_missing=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists documents.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> # TODO: Initialize `collection_id`:
+            >>> collection_id = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_documents(parent, collection_id):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_documents(parent, collection_id).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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``
+            collection_id (str): The collection ID, relative to ``parent``, to list. For example:
+                ``chatrooms`` or ``messages``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): The order to sort results by. For example: ``priority desc, name``.
+            mask (Union[dict, ~google.cloud.firestore_v1beta1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If a document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.DocumentMask`
+            transaction (bytes): Reads documents in a transaction.
+            read_time (Union[dict, ~google.cloud.firestore_v1beta1.types.Timestamp]): Reads documents as they were at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Timestamp`
+            show_missing (bool): If the list should show missing documents. A missing document is a
+                document that does not exist but has sub-documents. These documents will
+                be returned with a key but will not have fields,
+                ``Document.create_time``, or ``Document.update_time`` set.
+
+                Requests with ``show_missing`` may not specify ``where`` or
+                ``order_by``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.firestore_v1beta1.types.Document` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_documents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_documents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_documents,
+                default_retry=self._method_configs["ListDocuments"].retry,
+                default_timeout=self._method_configs["ListDocuments"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction, read_time=read_time
+        )
+
+        request = firestore_pb2.ListDocumentsRequest(
+            parent=parent,
+            collection_id=collection_id,
+            page_size=page_size,
+            order_by=order_by,
+            mask=mask,
+            transaction=transaction,
+            read_time=read_time,
+            show_missing=show_missing,
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_documents"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="documents",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_document(
+        self,
+        parent,
+        collection_id,
+        document_id,
+        document,
+        mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new document.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> # TODO: Initialize `collection_id`:
+            >>> collection_id = ''
+            >>>
+            >>> # TODO: Initialize `document_id`:
+            >>> document_id = ''
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.create_document(parent, collection_id, document_id, document)
+
+        Args:
+            parent (str): The parent resource. For example:
+                ``projects/{project_id}/databases/{database_id}/documents`` or
+                ``projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}``
+            collection_id (str): The collection ID, relative to ``parent``, to list. For example:
+                ``chatrooms``.
+            document_id (str): The client-assigned document ID to use for this document.
+
+                Optional. If not specified, an ID will be assigned by the service.
+            document (Union[dict, ~google.cloud.firestore_v1beta1.types.Document]): The document to create. ``name`` must not be set.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Document`
+            mask (Union[dict, ~google.cloud.firestore_v1beta1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If the document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.DocumentMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1beta1.types.Document` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_document,
+                default_retry=self._method_configs["CreateDocument"].retry,
+                default_timeout=self._method_configs["CreateDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.CreateDocumentRequest(
+            parent=parent,
+            collection_id=collection_id,
+            document_id=document_id,
+            document=document,
+            mask=mask,
+        )
+        return self._inner_api_calls["create_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_document(
+        self,
+        document,
+        update_mask,
+        mask=None,
+        current_document=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates or inserts a document.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_document(document, update_mask)
+
+        Args:
+            document (Union[dict, ~google.cloud.firestore_v1beta1.types.Document]): The updated document.
+                Creates the document if it does not already exist.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Document`
+            update_mask (Union[dict, ~google.cloud.firestore_v1beta1.types.DocumentMask]): The fields to update.
+                None of the field paths in the mask may contain a reserved name.
+
+                If the document exists on the server and has fields not referenced in the
+                mask, they are left unchanged.
+                Fields referenced in the mask, but not present in the input document, are
+                deleted from the document on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.DocumentMask`
+            mask (Union[dict, ~google.cloud.firestore_v1beta1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If the document has a field that is not present in this mask, that field
+                will not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.DocumentMask`
+            current_document (Union[dict, ~google.cloud.firestore_v1beta1.types.Precondition]): An optional precondition on the document.
+                The request will fail if this is set and not met by the target document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Precondition`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1beta1.types.Document` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_document,
+                default_retry=self._method_configs["UpdateDocument"].retry,
+                default_timeout=self._method_configs["UpdateDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.UpdateDocumentRequest(
+            document=document,
+            update_mask=update_mask,
+            mask=mask,
+            current_document=current_document,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("document.name", document.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_document(
+        self,
+        name,
+        current_document=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a document.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> name = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> client.delete_document(name)
+
+        Args:
+            name (str): The resource name of the Document to delete. In the format:
+                ``projects/{project_id}/databases/{database_id}/documents/{document_path}``.
+            current_document (Union[dict, ~google.cloud.firestore_v1beta1.types.Precondition]): An optional precondition on the document.
+                The request will fail if this is set and not met by the target document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Precondition`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_document" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_document"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_document,
+                default_retry=self._method_configs["DeleteDocument"].retry,
+                default_timeout=self._method_configs["DeleteDocument"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.DeleteDocumentRequest(
+            name=name, current_document=current_document
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_document"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_get_documents(
+        self,
+        database,
+        documents,
+        mask=None,
+        transaction=None,
+        new_transaction=None,
+        read_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets multiple documents.
+
+        Documents returned by this method are not guaranteed to be returned in the
+        same order that they were requested.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `documents`:
+            >>> documents = []
+            >>>
+            >>> for element in client.batch_get_documents(database, documents):
+            ...     # process element
+            ...     pass
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            documents (list[str]): The names of the documents to retrieve. In the format:
+                ``projects/{project_id}/databases/{database_id}/documents/{document_path}``.
+                The request will fail if any of the document is not a child resource of
+                the given ``database``. Duplicate names will be elided.
+            mask (Union[dict, ~google.cloud.firestore_v1beta1.types.DocumentMask]): The fields to return. If not set, returns all fields.
+
+                If a document has a field that is not present in this mask, that field will
+                not be returned in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.DocumentMask`
+            transaction (bytes): Reads documents in a transaction.
+            new_transaction (Union[dict, ~google.cloud.firestore_v1beta1.types.TransactionOptions]): Starts a new transaction and reads the documents.
+                Defaults to a read-only transaction.
+                The new transaction ID will be returned as the first response in the
+                stream.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.TransactionOptions`
+            read_time (Union[dict, ~google.cloud.firestore_v1beta1.types.Timestamp]): Reads documents as they were at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1beta1.types.BatchGetDocumentsResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_get_documents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_get_documents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_get_documents,
+                default_retry=self._method_configs["BatchGetDocuments"].retry,
+                default_timeout=self._method_configs["BatchGetDocuments"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+
+        request = firestore_pb2.BatchGetDocumentsRequest(
+            database=database,
+            documents=documents,
+            mask=mask,
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_get_documents"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def begin_transaction(
+        self,
+        database,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Starts a new transaction.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> response = client.begin_transaction(database)
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            options_ (Union[dict, ~google.cloud.firestore_v1beta1.types.TransactionOptions]): The options for the transaction.
+                Defaults to a read-write transaction.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.TransactionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1beta1.types.BeginTransactionResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "begin_transaction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "begin_transaction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.begin_transaction,
+                default_retry=self._method_configs["BeginTransaction"].retry,
+                default_timeout=self._method_configs["BeginTransaction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.BeginTransactionRequest(
+            database=database, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["begin_transaction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def commit(
+        self,
+        database,
+        writes,
+        transaction=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Commits a transaction, while optionally updating documents.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `writes`:
+            >>> writes = []
+            >>>
+            >>> response = client.commit(database, writes)
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            writes (list[Union[dict, ~google.cloud.firestore_v1beta1.types.Write]]): The writes to apply.
+
+                Always executed atomically and in order.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Write`
+            transaction (bytes): If set, applies all writes in this transaction, and commits it.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.firestore_v1beta1.types.CommitResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "commit" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "commit"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.commit,
+                default_retry=self._method_configs["Commit"].retry,
+                default_timeout=self._method_configs["Commit"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.CommitRequest(
+            database=database, writes=writes, transaction=transaction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["commit"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rollback(
+        self,
+        database,
+        transaction,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Rolls back a transaction.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `transaction`:
+            >>> transaction = b''
+            >>>
+            >>> client.rollback(database, transaction)
+
+        Args:
+            database (str): The database name. In the format:
+                ``projects/{project_id}/databases/{database_id}``.
+            transaction (bytes): The transaction to roll back.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rollback" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rollback"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rollback,
+                default_retry=self._method_configs["Rollback"].retry,
+                default_timeout=self._method_configs["Rollback"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.RollbackRequest(
+            database=database, transaction=transaction
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["rollback"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_query(
+        self,
+        parent,
+        structured_query=None,
+        transaction=None,
+        new_transaction=None,
+        read_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Runs a query.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> for element in client.run_query(parent):
+            ...     # process element
+            ...     pass
+
+        Args:
+            parent (str): 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``
+            structured_query (Union[dict, ~google.cloud.firestore_v1beta1.types.StructuredQuery]): A structured query.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.StructuredQuery`
+            transaction (bytes): Reads documents in a transaction.
+            new_transaction (Union[dict, ~google.cloud.firestore_v1beta1.types.TransactionOptions]): Starts a new transaction and reads the documents.
+                Defaults to a read-only transaction.
+                The new transaction ID will be returned as the first response in the
+                stream.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.TransactionOptions`
+            read_time (Union[dict, ~google.cloud.firestore_v1beta1.types.Timestamp]): Reads documents as they were at the given time.
+                This may not be older than 60 seconds.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.firestore_v1beta1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1beta1.types.RunQueryResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_query" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_query"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_query,
+                default_retry=self._method_configs["RunQuery"].retry,
+                default_timeout=self._method_configs["RunQuery"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(structured_query=structured_query)
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+
+        request = firestore_pb2.RunQueryRequest(
+            parent=parent,
+            structured_query=structured_query,
+            transaction=transaction,
+            new_transaction=new_transaction,
+            read_time=read_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_query"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def write(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Streams batches of document updates and deletes, in order.
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>> request = {'database': database}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.write(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.firestore_v1beta1.proto.firestore_pb2.WriteRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.firestore_v1beta1.types.WriteRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1beta1.types.WriteResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "write" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "write"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.write,
+                default_retry=self._method_configs["Write"].retry,
+                default_timeout=self._method_configs["Write"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["write"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def listen(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Listens to changes.
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> database = client.database_root_path('[PROJECT]', '[DATABASE]')
+            >>> request = {'database': database}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.listen(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.firestore_v1beta1.proto.firestore_pb2.ListenRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.firestore_v1beta1.types.ListenRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.firestore_v1beta1.types.ListenResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "listen" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "listen"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.listen,
+                default_retry=self._method_configs["Listen"].retry,
+                default_timeout=self._method_configs["Listen"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["listen"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_collection_ids(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all the collection IDs underneath a document.
+
+        Example:
+            >>> from google.cloud import firestore_v1beta1
+            >>>
+            >>> client = firestore_v1beta1.FirestoreClient()
+            >>>
+            >>> parent = client.any_path_path('[PROJECT]', '[DATABASE]', '[DOCUMENT]', '[ANY_PATH]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_collection_ids(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_collection_ids(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`str` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_collection_ids" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_collection_ids"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_collection_ids,
+                default_retry=self._method_configs["ListCollectionIds"].retry,
+                default_timeout=self._method_configs["ListCollectionIds"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = firestore_pb2.ListCollectionIdsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_collection_ids"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="collection_ids",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/firestore/google/cloud/firestore_v1beta1/gapic/firestore_client_config.py b/firestore/google/cloud/firestore_v1beta1/gapic/firestore_client_config.py
new file mode 100644
index 000000000000..dd458fe97643
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/gapic/firestore_client_config.py
@@ -0,0 +1,97 @@
+config = {
+    "interfaces": {
+        "google.firestore.v1beta1.Firestore": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+                "streaming": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 300000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 300000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "GetDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDocuments": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDocument": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchGetDocuments": {
+                    "timeout_millis": 300000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "BeginTransaction": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "Commit": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Rollback": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunQuery": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "Write": {
+                    "timeout_millis": 86400000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "Listen": {
+                    "timeout_millis": 86400000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "ListCollectionIds": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/gapic/transports/__init__.py b/firestore/google/cloud/firestore_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1beta1/gapic/transports/firestore_grpc_transport.py b/firestore/google/cloud/firestore_v1beta1/gapic/transports/firestore_grpc_transport.py
new file mode 100644
index 000000000000..33b41f1726a0
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/gapic/transports/firestore_grpc_transport.py
@@ -0,0 +1,281 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.firestore_v1beta1.proto import firestore_pb2_grpc
+
+
+class FirestoreGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.firestore.v1beta1 Firestore API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/datastore",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="firestore.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"firestore_stub": firestore_pb2_grpc.FirestoreStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="firestore.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def get_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.get_document`.
+
+        Gets a single document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].GetDocument
+
+    @property
+    def list_documents(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.list_documents`.
+
+        Lists documents.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].ListDocuments
+
+    @property
+    def create_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.create_document`.
+
+        Creates a new document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].CreateDocument
+
+    @property
+    def update_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.update_document`.
+
+        Updates or inserts a document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].UpdateDocument
+
+    @property
+    def delete_document(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.delete_document`.
+
+        Deletes a document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].DeleteDocument
+
+    @property
+    def batch_get_documents(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.batch_get_documents`.
+
+        Gets multiple documents.
+
+        Documents returned by this method are not guaranteed to be returned in the
+        same order that they were requested.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].BatchGetDocuments
+
+    @property
+    def begin_transaction(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.begin_transaction`.
+
+        Starts a new transaction.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].BeginTransaction
+
+    @property
+    def commit(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.commit`.
+
+        Commits a transaction, while optionally updating documents.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Commit
+
+    @property
+    def rollback(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.rollback`.
+
+        Rolls back a transaction.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Rollback
+
+    @property
+    def run_query(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.run_query`.
+
+        Runs a query.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].RunQuery
+
+    @property
+    def write(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.write`.
+
+        Streams batches of document updates and deletes, in order.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Write
+
+    @property
+    def listen(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.listen`.
+
+        Listens to changes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].Listen
+
+    @property
+    def list_collection_ids(self):
+        """Return the gRPC stub for :meth:`FirestoreClient.list_collection_ids`.
+
+        Lists all the collection IDs underneath a document.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["firestore_stub"].ListCollectionIds
diff --git a/firestore/google/cloud/firestore_v1beta1/order.py b/firestore/google/cloud/firestore_v1beta1/order.py
new file mode 100644
index 000000000000..79207f530c42
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/order.py
@@ -0,0 +1,207 @@
+# Copyright 2017 Google LLC 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.
+
+from enum import Enum
+from google.cloud.firestore_v1beta1._helpers import decode_value
+import math
+
+
+class TypeOrder(Enum):
+    # NOTE: This order is defined by the backend and cannot be changed.
+    NULL = 0
+    BOOLEAN = 1
+    NUMBER = 2
+    TIMESTAMP = 3
+    STRING = 4
+    BLOB = 5
+    REF = 6
+    GEO_POINT = 7
+    ARRAY = 8
+    OBJECT = 9
+
+    @staticmethod
+    def from_value(value):
+        v = value.WhichOneof("value_type")
+
+        lut = {
+            "null_value": TypeOrder.NULL,
+            "boolean_value": TypeOrder.BOOLEAN,
+            "integer_value": TypeOrder.NUMBER,
+            "double_value": TypeOrder.NUMBER,
+            "timestamp_value": TypeOrder.TIMESTAMP,
+            "string_value": TypeOrder.STRING,
+            "bytes_value": TypeOrder.BLOB,
+            "reference_value": TypeOrder.REF,
+            "geo_point_value": TypeOrder.GEO_POINT,
+            "array_value": TypeOrder.ARRAY,
+            "map_value": TypeOrder.OBJECT,
+        }
+
+        if v not in lut:
+            raise ValueError("Could not detect value type for " + v)
+        return lut[v]
+
+
+class Order(object):
+    """
+    Order implements the ordering semantics of the backend.
+    """
+
+    @classmethod
+    def compare(cls, left, right):
+        """
+        Main comparison function for all Firestore types.
+        @return -1 is left < right, 0 if left == right, otherwise 1
+        """
+        # First compare the types.
+        leftType = TypeOrder.from_value(left).value
+        rightType = TypeOrder.from_value(right).value
+
+        if leftType != rightType:
+            if leftType < rightType:
+                return -1
+            return 1
+
+        value_type = left.WhichOneof("value_type")
+
+        if value_type == "null_value":
+            return 0  # nulls are all equal
+        elif value_type == "boolean_value":
+            return cls._compare_to(left.boolean_value, right.boolean_value)
+        elif value_type == "integer_value":
+            return cls.compare_numbers(left, right)
+        elif value_type == "double_value":
+            return cls.compare_numbers(left, right)
+        elif value_type == "timestamp_value":
+            return cls.compare_timestamps(left, right)
+        elif value_type == "string_value":
+            return cls._compare_to(left.string_value, right.string_value)
+        elif value_type == "bytes_value":
+            return cls.compare_blobs(left, right)
+        elif value_type == "reference_value":
+            return cls.compare_resource_paths(left, right)
+        elif value_type == "geo_point_value":
+            return cls.compare_geo_points(left, right)
+        elif value_type == "array_value":
+            return cls.compare_arrays(left, right)
+        elif value_type == "map_value":
+            return cls.compare_objects(left, right)
+        else:
+            raise ValueError("Unknown ``value_type``", str(value_type))
+
+    @staticmethod
+    def compare_blobs(left, right):
+        left_bytes = left.bytes_value
+        right_bytes = right.bytes_value
+
+        return Order._compare_to(left_bytes, right_bytes)
+
+    @staticmethod
+    def compare_timestamps(left, right):
+        left = left.timestamp_value
+        right = right.timestamp_value
+
+        seconds = Order._compare_to(left.seconds or 0, right.seconds or 0)
+        if seconds != 0:
+            return seconds
+
+        return Order._compare_to(left.nanos or 0, right.nanos or 0)
+
+    @staticmethod
+    def compare_geo_points(left, right):
+        left_value = decode_value(left, None)
+        right_value = decode_value(right, None)
+        cmp = (left_value.latitude > right_value.latitude) - (
+            left_value.latitude < right_value.latitude
+        )
+
+        if cmp != 0:
+            return cmp
+        return (left_value.longitude > right_value.longitude) - (
+            left_value.longitude < right_value.longitude
+        )
+
+    @staticmethod
+    def compare_resource_paths(left, right):
+        left = left.reference_value
+        right = right.reference_value
+
+        left_segments = left.split("/")
+        right_segments = right.split("/")
+        shorter = min(len(left_segments), len(right_segments))
+        # compare segments
+        for i in range(shorter):
+            if left_segments[i] < right_segments[i]:
+                return -1
+            if left_segments[i] > right_segments[i]:
+                return 1
+
+        left_length = len(left)
+        right_length = len(right)
+        return (left_length > right_length) - (left_length < right_length)
+
+    @staticmethod
+    def compare_arrays(left, right):
+        l_values = left.array_value.values
+        r_values = right.array_value.values
+
+        length = min(len(l_values), len(r_values))
+        for i in range(length):
+            cmp = Order.compare(l_values[i], r_values[i])
+            if cmp != 0:
+                return cmp
+
+        return Order._compare_to(len(l_values), len(r_values))
+
+    @staticmethod
+    def compare_objects(left, right):
+        left_fields = left.map_value.fields
+        right_fields = right.map_value.fields
+
+        for left_key, right_key in zip(sorted(left_fields), sorted(right_fields)):
+            keyCompare = Order._compare_to(left_key, right_key)
+            if keyCompare != 0:
+                return keyCompare
+
+            value_compare = Order.compare(
+                left_fields[left_key], right_fields[right_key]
+            )
+            if value_compare != 0:
+                return value_compare
+
+        return Order._compare_to(len(left_fields), len(right_fields))
+
+    @staticmethod
+    def compare_numbers(left, right):
+        left_value = decode_value(left, None)
+        right_value = decode_value(right, None)
+        return Order.compare_doubles(left_value, right_value)
+
+    @staticmethod
+    def compare_doubles(left, right):
+        if math.isnan(left):
+            if math.isnan(right):
+                return 0
+            return -1
+        if math.isnan(right):
+            return 1
+
+        return Order._compare_to(left, right)
+
+    @staticmethod
+    def _compare_to(left, right):
+        # We can't just use cmp(left, right) because cmp doesn't exist
+        # in Python 3, so this is an equivalent suggested by
+        # https://docs.python.org/3.0/whatsnew/3.0.html#ordering-comparisons
+        return (left > right) - (left < right)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/__init__.py b/firestore/google/cloud/firestore_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/admin/__init__.py b/firestore/google/cloud/firestore_v1beta1/proto/admin/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/admin/firestore_admin_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/admin/firestore_admin_pb2.py
new file mode 100644
index 000000000000..9bb7f6553b04
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/admin/firestore_admin_pb2.py
@@ -0,0 +1,1343 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/admin/firestore_admin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.firestore_v1beta1.proto.admin import (
+    index_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/admin/firestore_admin.proto",
+    package="google.firestore.admin.v1beta1",
+    syntax="proto3",
+    serialized_pb=_b(
+        '\n@google/cloud/firestore_v1beta1/proto/admin/firestore_admin.proto\x12\x1egoogle.firestore.admin.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x36google/cloud/firestore_v1beta1/proto/admin/index.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x80\x03\n\x16IndexOperationMetadata\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\r\n\x05index\x18\x03 \x01(\t\x12\\\n\x0eoperation_type\x18\x04 \x01(\x0e\x32\x44.google.firestore.admin.v1beta1.IndexOperationMetadata.OperationType\x12\x11\n\tcancelled\x18\x05 \x01(\x08\x12\x43\n\x11\x64ocument_progress\x18\x06 \x01(\x0b\x32(.google.firestore.admin.v1beta1.Progress"C\n\rOperationType\x12\x1e\n\x1aOPERATION_TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x43REATING_INDEX\x10\x01":\n\x08Progress\x12\x16\n\x0ework_completed\x18\x01 \x01(\x03\x12\x16\n\x0ework_estimated\x18\x02 \x01(\x03"Z\n\x12\x43reateIndexRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x34\n\x05index\x18\x02 \x01(\x0b\x32%.google.firestore.admin.v1beta1.Index"\x1f\n\x0fGetIndexRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"[\n\x12ListIndexesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t""\n\x12\x44\x65leteIndexRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"f\n\x13ListIndexesResponse\x12\x36\n\x07indexes\x18\x01 \x03(\x0b\x32%.google.firestore.admin.v1beta1.Index\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\x9c\x05\n\x0e\x46irestoreAdmin\x12\xa1\x01\n\x0b\x43reateIndex\x12\x32.google.firestore.admin.v1beta1.CreateIndexRequest\x1a\x1d.google.longrunning.Operation"?\x82\xd3\xe4\x93\x02\x39"0/v1beta1/{parent=projects/*/databases/*}/indexes:\x05index\x12\xb0\x01\n\x0bListIndexes\x12\x32.google.firestore.admin.v1beta1.ListIndexesRequest\x1a\x33.google.firestore.admin.v1beta1.ListIndexesResponse"8\x82\xd3\xe4\x93\x02\x32\x12\x30/v1beta1/{parent=projects/*/databases/*}/indexes\x12\x9c\x01\n\x08GetIndex\x12/.google.firestore.admin.v1beta1.GetIndexRequest\x1a%.google.firestore.admin.v1beta1.Index"8\x82\xd3\xe4\x93\x02\x32\x12\x30/v1beta1/{name=projects/*/databases/*/indexes/*}\x12\x93\x01\n\x0b\x44\x65leteIndex\x12\x32.google.firestore.admin.v1beta1.DeleteIndexRequest\x1a\x16.google.protobuf.Empty"8\x82\xd3\xe4\x93\x02\x32*0/v1beta1/{name=projects/*/databases/*/indexes/*}B\xae\x01\n"com.google.firestore.admin.v1beta1B\x13\x46irestoreAdminProtoP\x01ZCgoogle.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin\xa2\x02\x04GCFS\xaa\x02$Google.Cloud.Firestore.Admin.V1Beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_INDEXOPERATIONMETADATA_OPERATIONTYPE = _descriptor.EnumDescriptor(
+    name="OperationType",
+    full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.OperationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING_INDEX", index=1, number=1, options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    options=None,
+    serialized_start=603,
+    serialized_end=670,
+)
+_sym_db.RegisterEnumDescriptor(_INDEXOPERATIONMETADATA_OPERATIONTYPE)
+
+
+_INDEXOPERATIONMETADATA = _descriptor.Descriptor(
+    name="IndexOperationMetadata",
+    full_name="google.firestore.admin.v1beta1.IndexOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.index",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_type",
+            full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.operation_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cancelled",
+            full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.cancelled",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_progress",
+            full_name="google.firestore.admin.v1beta1.IndexOperationMetadata.document_progress",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_INDEXOPERATIONMETADATA_OPERATIONTYPE],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=286,
+    serialized_end=670,
+)
+
+
+_PROGRESS = _descriptor.Descriptor(
+    name="Progress",
+    full_name="google.firestore.admin.v1beta1.Progress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="work_completed",
+            full_name="google.firestore.admin.v1beta1.Progress.work_completed",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="work_estimated",
+            full_name="google.firestore.admin.v1beta1.Progress.work_estimated",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=672,
+    serialized_end=730,
+)
+
+
+_CREATEINDEXREQUEST = _descriptor.Descriptor(
+    name="CreateIndexRequest",
+    full_name="google.firestore.admin.v1beta1.CreateIndexRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.admin.v1beta1.CreateIndexRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.firestore.admin.v1beta1.CreateIndexRequest.index",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=732,
+    serialized_end=822,
+)
+
+
+_GETINDEXREQUEST = _descriptor.Descriptor(
+    name="GetIndexRequest",
+    full_name="google.firestore.admin.v1beta1.GetIndexRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1beta1.GetIndexRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=824,
+    serialized_end=855,
+)
+
+
+_LISTINDEXESREQUEST = _descriptor.Descriptor(
+    name="ListIndexesRequest",
+    full_name="google.firestore.admin.v1beta1.ListIndexesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.admin.v1beta1.ListIndexesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.firestore.admin.v1beta1.ListIndexesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.admin.v1beta1.ListIndexesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.admin.v1beta1.ListIndexesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=857,
+    serialized_end=948,
+)
+
+
+_DELETEINDEXREQUEST = _descriptor.Descriptor(
+    name="DeleteIndexRequest",
+    full_name="google.firestore.admin.v1beta1.DeleteIndexRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1beta1.DeleteIndexRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=950,
+    serialized_end=984,
+)
+
+
+_LISTINDEXESRESPONSE = _descriptor.Descriptor(
+    name="ListIndexesResponse",
+    full_name="google.firestore.admin.v1beta1.ListIndexesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="indexes",
+            full_name="google.firestore.admin.v1beta1.ListIndexesResponse.indexes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.admin.v1beta1.ListIndexesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=986,
+    serialized_end=1088,
+)
+
+_INDEXOPERATIONMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INDEXOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INDEXOPERATIONMETADATA.fields_by_name[
+    "operation_type"
+].enum_type = _INDEXOPERATIONMETADATA_OPERATIONTYPE
+_INDEXOPERATIONMETADATA.fields_by_name["document_progress"].message_type = _PROGRESS
+_INDEXOPERATIONMETADATA_OPERATIONTYPE.containing_type = _INDEXOPERATIONMETADATA
+_CREATEINDEXREQUEST.fields_by_name[
+    "index"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2._INDEX
+)
+_LISTINDEXESRESPONSE.fields_by_name[
+    "indexes"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2._INDEX
+)
+DESCRIPTOR.message_types_by_name["IndexOperationMetadata"] = _INDEXOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Progress"] = _PROGRESS
+DESCRIPTOR.message_types_by_name["CreateIndexRequest"] = _CREATEINDEXREQUEST
+DESCRIPTOR.message_types_by_name["GetIndexRequest"] = _GETINDEXREQUEST
+DESCRIPTOR.message_types_by_name["ListIndexesRequest"] = _LISTINDEXESREQUEST
+DESCRIPTOR.message_types_by_name["DeleteIndexRequest"] = _DELETEINDEXREQUEST
+DESCRIPTOR.message_types_by_name["ListIndexesResponse"] = _LISTINDEXESRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+IndexOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "IndexOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INDEXOPERATIONMETADATA,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""Metadata for index operations. This metadata populates the metadata
+  field of [google.longrunning.Operation][google.longrunning.Operation].
+  
+  
+  Attributes:
+      start_time:
+          The time that work began on the operation.
+      end_time:
+          The time the operation ended, either successfully or
+          otherwise. Unset if the operation is still active.
+      index:
+          The index resource that this operation is acting on. For
+          example: ``projects/{project_id}/databases/{database_id}/index
+          es/{index_id}``
+      operation_type:
+          The type of index operation.
+      cancelled:
+          True if the [google.longrunning.Operation] was cancelled. If
+          the cancellation is in progress, cancelled will be true but [g
+          oogle.longrunning.Operation.done][google.longrunning.Operation
+          .done] will be false.
+      document_progress:
+          Progress of the existing operation, measured in number of
+          documents.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.IndexOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(IndexOperationMetadata)
+
+Progress = _reflection.GeneratedProtocolMessageType(
+    "Progress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROGRESS,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""Measures the progress of a particular metric.
+  
+  
+  Attributes:
+      work_completed:
+          An estimate of how much work has been completed. Note that
+          this may be greater than ``work_estimated``.
+      work_estimated:
+          An estimate of how much work needs to be performed. Zero if
+          the work estimate is unavailable. May change as work
+          progresses.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.Progress)
+    ),
+)
+_sym_db.RegisterMessage(Progress)
+
+CreateIndexRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateIndexRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINDEXREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.CreateIndex][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+  
+  
+  Attributes:
+      parent:
+          The name of the database this index will apply to. For
+          example: ``projects/{project_id}/databases/{database_id}``
+      index:
+          The index to create. The name and state should not be
+          specified. Certain single field indexes cannot be created or
+          deleted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.CreateIndexRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateIndexRequest)
+
+GetIndexRequest = _reflection.GeneratedProtocolMessageType(
+    "GetIndexRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINDEXREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.GetIndex][google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex].
+  
+  
+  Attributes:
+      name:
+          The name of the index. For example: ``projects/{project_id}/da
+          tabases/{database_id}/indexes/{index_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.GetIndexRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetIndexRequest)
+
+ListIndexesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListIndexesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINDEXESREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.ListIndexes][google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes].
+  
+  
+  Attributes:
+      parent:
+          The database name. For example:
+          ``projects/{project_id}/databases/{database_id}``
+      page_size:
+          The standard List page size.
+      page_token:
+          The standard List page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.ListIndexesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListIndexesRequest)
+
+DeleteIndexRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteIndexRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINDEXREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""The request for
+  [FirestoreAdmin.DeleteIndex][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex].
+  
+  
+  Attributes:
+      name:
+          The index name. For example: ``projects/{project_id}/databases
+          /{database_id}/indexes/{index_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.DeleteIndexRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteIndexRequest)
+
+ListIndexesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListIndexesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINDEXESRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.firestore_admin_pb2",
+        __doc__="""The response for
+  [FirestoreAdmin.ListIndexes][google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes].
+  
+  
+  Attributes:
+      indexes:
+          The indexes.
+      next_page_token:
+          The standard List next-page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.ListIndexesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListIndexesResponse)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        '\n"com.google.firestore.admin.v1beta1B\023FirestoreAdminProtoP\001ZCgoogle.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin\242\002\004GCFS\252\002$Google.Cloud.Firestore.Admin.V1Beta1'
+    ),
+)
+
+_FIRESTOREADMIN = _descriptor.ServiceDescriptor(
+    name="FirestoreAdmin",
+    full_name="google.firestore.admin.v1beta1.FirestoreAdmin",
+    file=DESCRIPTOR,
+    index=0,
+    options=None,
+    serialized_start=1091,
+    serialized_end=1759,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateIndex",
+            full_name="google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEINDEXREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            options=_descriptor._ParseOptions(
+                descriptor_pb2.MethodOptions(),
+                _b(
+                    '\202\323\344\223\0029"0/v1beta1/{parent=projects/*/databases/*}/indexes:\005index'
+                ),
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListIndexes",
+            full_name="google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes",
+            index=1,
+            containing_service=None,
+            input_type=_LISTINDEXESREQUEST,
+            output_type=_LISTINDEXESRESPONSE,
+            options=_descriptor._ParseOptions(
+                descriptor_pb2.MethodOptions(),
+                _b(
+                    "\202\323\344\223\0022\0220/v1beta1/{parent=projects/*/databases/*}/indexes"
+                ),
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIndex",
+            full_name="google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex",
+            index=2,
+            containing_service=None,
+            input_type=_GETINDEXREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2._INDEX,
+            options=_descriptor._ParseOptions(
+                descriptor_pb2.MethodOptions(),
+                _b(
+                    "\202\323\344\223\0022\0220/v1beta1/{name=projects/*/databases/*/indexes/*}"
+                ),
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteIndex",
+            full_name="google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEINDEXREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            options=_descriptor._ParseOptions(
+                descriptor_pb2.MethodOptions(),
+                _b(
+                    "\202\323\344\223\0022*0/v1beta1/{name=projects/*/databases/*/indexes/*}"
+                ),
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_FIRESTOREADMIN)
+
+DESCRIPTOR.services_by_name["FirestoreAdmin"] = _FIRESTOREADMIN
+
+try:
+    # THESE ELEMENTS WILL BE DEPRECATED.
+    # Please use the generated *_pb2_grpc.py files instead.
+    import grpc
+    from grpc.beta import implementations as beta_implementations
+    from grpc.beta import interfaces as beta_interfaces
+    from grpc.framework.common import cardinality
+    from grpc.framework.interfaces.face import utilities as face_utilities
+
+    class FirestoreAdminStub(object):
+        """The Cloud Firestore Admin API.
+
+    This API provides several administrative services for Cloud Firestore.
+
+    # Concepts
+
+    Project, Database, Namespace, Collection, and Document are used as defined in
+    the Google Cloud Firestore API.
+
+    Operation: An Operation represents work being performed in the background.
+
+
+    # Services
+
+    ## Index
+
+    The index service manages Cloud Firestore indexes.
+
+    Index creation is performed asynchronously.
+    An Operation resource is created for each such asynchronous operation.
+    The state of the operation (including any errors encountered)
+    may be queried via the Operation resource.
+
+    ## Metadata
+
+    Provides metadata and statistical information about data in Cloud Firestore.
+    The data provided as part of this API may be stale.
+
+    ## Operation
+
+    The Operations collection provides a record of actions performed for the
+    specified Project (including any Operations in progress). Operations are not
+    created directly but through calls on other collections or resources.
+
+    An Operation that is not yet done may be cancelled. The request to cancel is
+    asynchronous and the Operation may continue to run for some time after the
+    request to cancel is made.
+
+    An Operation that is done may be deleted so that it is no longer listed as
+    part of the Operation collection.
+
+    Operations are created by service `FirestoreAdmin`, but are accessed via
+    service `google.longrunning.Operations`.
+    """
+
+        def __init__(self, channel):
+            """Constructor.
+
+      Args:
+        channel: A grpc.Channel.
+      """
+            self.CreateIndex = channel.unary_unary(
+                "/google.firestore.admin.v1beta1.FirestoreAdmin/CreateIndex",
+                request_serializer=CreateIndexRequest.SerializeToString,
+                response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            )
+            self.ListIndexes = channel.unary_unary(
+                "/google.firestore.admin.v1beta1.FirestoreAdmin/ListIndexes",
+                request_serializer=ListIndexesRequest.SerializeToString,
+                response_deserializer=ListIndexesResponse.FromString,
+            )
+            self.GetIndex = channel.unary_unary(
+                "/google.firestore.admin.v1beta1.FirestoreAdmin/GetIndex",
+                request_serializer=GetIndexRequest.SerializeToString,
+                response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.Index.FromString,
+            )
+            self.DeleteIndex = channel.unary_unary(
+                "/google.firestore.admin.v1beta1.FirestoreAdmin/DeleteIndex",
+                request_serializer=DeleteIndexRequest.SerializeToString,
+                response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+            )
+
+    class FirestoreAdminServicer(object):
+        """The Cloud Firestore Admin API.
+
+    This API provides several administrative services for Cloud Firestore.
+
+    # Concepts
+
+    Project, Database, Namespace, Collection, and Document are used as defined in
+    the Google Cloud Firestore API.
+
+    Operation: An Operation represents work being performed in the background.
+
+
+    # Services
+
+    ## Index
+
+    The index service manages Cloud Firestore indexes.
+
+    Index creation is performed asynchronously.
+    An Operation resource is created for each such asynchronous operation.
+    The state of the operation (including any errors encountered)
+    may be queried via the Operation resource.
+
+    ## Metadata
+
+    Provides metadata and statistical information about data in Cloud Firestore.
+    The data provided as part of this API may be stale.
+
+    ## Operation
+
+    The Operations collection provides a record of actions performed for the
+    specified Project (including any Operations in progress). Operations are not
+    created directly but through calls on other collections or resources.
+
+    An Operation that is not yet done may be cancelled. The request to cancel is
+    asynchronous and the Operation may continue to run for some time after the
+    request to cancel is made.
+
+    An Operation that is done may be deleted so that it is no longer listed as
+    part of the Operation collection.
+
+    Operations are created by service `FirestoreAdmin`, but are accessed via
+    service `google.longrunning.Operations`.
+    """
+
+        def CreateIndex(self, request, context):
+            """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`.
+      If the index already exists, the call will return an `ALREADY_EXISTS`
+      status.
+
+      During creation, the process could result in an error, in which case the
+      index will move to the `ERROR` state. The process can be recovered by
+      fixing the data that caused the error, removing the index with
+      [delete][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex], then re-creating the index with
+      [create][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+
+      Indexes with a single field cannot be created.
+      """
+            context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+            context.set_details("Method not implemented!")
+            raise NotImplementedError("Method not implemented!")
+
+        def ListIndexes(self, request, context):
+            """Lists the indexes that match the specified filters.
+      """
+            context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+            context.set_details("Method not implemented!")
+            raise NotImplementedError("Method not implemented!")
+
+        def GetIndex(self, request, context):
+            """Gets an index.
+      """
+            context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+            context.set_details("Method not implemented!")
+            raise NotImplementedError("Method not implemented!")
+
+        def DeleteIndex(self, request, context):
+            """Deletes an index.
+      """
+            context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+            context.set_details("Method not implemented!")
+            raise NotImplementedError("Method not implemented!")
+
+    def add_FirestoreAdminServicer_to_server(servicer, server):
+        rpc_method_handlers = {
+            "CreateIndex": grpc.unary_unary_rpc_method_handler(
+                servicer.CreateIndex,
+                request_deserializer=CreateIndexRequest.FromString,
+                response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+            ),
+            "ListIndexes": grpc.unary_unary_rpc_method_handler(
+                servicer.ListIndexes,
+                request_deserializer=ListIndexesRequest.FromString,
+                response_serializer=ListIndexesResponse.SerializeToString,
+            ),
+            "GetIndex": grpc.unary_unary_rpc_method_handler(
+                servicer.GetIndex,
+                request_deserializer=GetIndexRequest.FromString,
+                response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.Index.SerializeToString,
+            ),
+            "DeleteIndex": grpc.unary_unary_rpc_method_handler(
+                servicer.DeleteIndex,
+                request_deserializer=DeleteIndexRequest.FromString,
+                response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+            ),
+        }
+        generic_handler = grpc.method_handlers_generic_handler(
+            "google.firestore.admin.v1beta1.FirestoreAdmin", rpc_method_handlers
+        )
+        server.add_generic_rpc_handlers((generic_handler,))
+
+    class BetaFirestoreAdminServicer(object):
+        """The Beta API is deprecated for 0.15.0 and later.
+
+    It is recommended to use the GA API (classes and functions in this
+    file not marked beta) for all further purposes. This class was generated
+    only to ease transition from grpcio<0.15.0 to grpcio>=0.15.0."""
+
+        """The Cloud Firestore Admin API.
+
+    This API provides several administrative services for Cloud Firestore.
+
+    # Concepts
+
+    Project, Database, Namespace, Collection, and Document are used as defined in
+    the Google Cloud Firestore API.
+
+    Operation: An Operation represents work being performed in the background.
+
+
+    # Services
+
+    ## Index
+
+    The index service manages Cloud Firestore indexes.
+
+    Index creation is performed asynchronously.
+    An Operation resource is created for each such asynchronous operation.
+    The state of the operation (including any errors encountered)
+    may be queried via the Operation resource.
+
+    ## Metadata
+
+    Provides metadata and statistical information about data in Cloud Firestore.
+    The data provided as part of this API may be stale.
+
+    ## Operation
+
+    The Operations collection provides a record of actions performed for the
+    specified Project (including any Operations in progress). Operations are not
+    created directly but through calls on other collections or resources.
+
+    An Operation that is not yet done may be cancelled. The request to cancel is
+    asynchronous and the Operation may continue to run for some time after the
+    request to cancel is made.
+
+    An Operation that is done may be deleted so that it is no longer listed as
+    part of the Operation collection.
+
+    Operations are created by service `FirestoreAdmin`, but are accessed via
+    service `google.longrunning.Operations`.
+    """
+
+        def CreateIndex(self, request, context):
+            """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`.
+      If the index already exists, the call will return an `ALREADY_EXISTS`
+      status.
+
+      During creation, the process could result in an error, in which case the
+      index will move to the `ERROR` state. The process can be recovered by
+      fixing the data that caused the error, removing the index with
+      [delete][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex], then re-creating the index with
+      [create][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+
+      Indexes with a single field cannot be created.
+      """
+            context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
+
+        def ListIndexes(self, request, context):
+            """Lists the indexes that match the specified filters.
+      """
+            context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
+
+        def GetIndex(self, request, context):
+            """Gets an index.
+      """
+            context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
+
+        def DeleteIndex(self, request, context):
+            """Deletes an index.
+      """
+            context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
+
+    class BetaFirestoreAdminStub(object):
+        """The Beta API is deprecated for 0.15.0 and later.
+
+    It is recommended to use the GA API (classes and functions in this
+    file not marked beta) for all further purposes. This class was generated
+    only to ease transition from grpcio<0.15.0 to grpcio>=0.15.0."""
+
+        """The Cloud Firestore Admin API.
+
+    This API provides several administrative services for Cloud Firestore.
+
+    # Concepts
+
+    Project, Database, Namespace, Collection, and Document are used as defined in
+    the Google Cloud Firestore API.
+
+    Operation: An Operation represents work being performed in the background.
+
+
+    # Services
+
+    ## Index
+
+    The index service manages Cloud Firestore indexes.
+
+    Index creation is performed asynchronously.
+    An Operation resource is created for each such asynchronous operation.
+    The state of the operation (including any errors encountered)
+    may be queried via the Operation resource.
+
+    ## Metadata
+
+    Provides metadata and statistical information about data in Cloud Firestore.
+    The data provided as part of this API may be stale.
+
+    ## Operation
+
+    The Operations collection provides a record of actions performed for the
+    specified Project (including any Operations in progress). Operations are not
+    created directly but through calls on other collections or resources.
+
+    An Operation that is not yet done may be cancelled. The request to cancel is
+    asynchronous and the Operation may continue to run for some time after the
+    request to cancel is made.
+
+    An Operation that is done may be deleted so that it is no longer listed as
+    part of the Operation collection.
+
+    Operations are created by service `FirestoreAdmin`, but are accessed via
+    service `google.longrunning.Operations`.
+    """
+
+        def CreateIndex(
+            self,
+            request,
+            timeout,
+            metadata=None,
+            with_call=False,
+            protocol_options=None,
+        ):
+            """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`.
+      If the index already exists, the call will return an `ALREADY_EXISTS`
+      status.
+
+      During creation, the process could result in an error, in which case the
+      index will move to the `ERROR` state. The process can be recovered by
+      fixing the data that caused the error, removing the index with
+      [delete][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex], then re-creating the index with
+      [create][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+
+      Indexes with a single field cannot be created.
+      """
+            raise NotImplementedError()
+
+        CreateIndex.future = None
+
+        def ListIndexes(
+            self,
+            request,
+            timeout,
+            metadata=None,
+            with_call=False,
+            protocol_options=None,
+        ):
+            """Lists the indexes that match the specified filters.
+      """
+            raise NotImplementedError()
+
+        ListIndexes.future = None
+
+        def GetIndex(
+            self,
+            request,
+            timeout,
+            metadata=None,
+            with_call=False,
+            protocol_options=None,
+        ):
+            """Gets an index.
+      """
+            raise NotImplementedError()
+
+        GetIndex.future = None
+
+        def DeleteIndex(
+            self,
+            request,
+            timeout,
+            metadata=None,
+            with_call=False,
+            protocol_options=None,
+        ):
+            """Deletes an index.
+      """
+            raise NotImplementedError()
+
+        DeleteIndex.future = None
+
+    def beta_create_FirestoreAdmin_server(
+        servicer, pool=None, pool_size=None, default_timeout=None, maximum_timeout=None
+    ):
+        """The Beta API is deprecated for 0.15.0 and later.
+
+    It is recommended to use the GA API (classes and functions in this
+    file not marked beta) for all further purposes. This function was
+    generated only to ease transition from grpcio<0.15.0 to grpcio>=0.15.0"""
+        request_deserializers = {
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "CreateIndex",
+            ): CreateIndexRequest.FromString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "DeleteIndex",
+            ): DeleteIndexRequest.FromString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "GetIndex",
+            ): GetIndexRequest.FromString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "ListIndexes",
+            ): ListIndexesRequest.FromString,
+        }
+        response_serializers = {
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "CreateIndex",
+            ): google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "DeleteIndex",
+            ): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "GetIndex",
+            ): google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.Index.SerializeToString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "ListIndexes",
+            ): ListIndexesResponse.SerializeToString,
+        }
+        method_implementations = {
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "CreateIndex",
+            ): face_utilities.unary_unary_inline(servicer.CreateIndex),
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "DeleteIndex",
+            ): face_utilities.unary_unary_inline(servicer.DeleteIndex),
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "GetIndex",
+            ): face_utilities.unary_unary_inline(servicer.GetIndex),
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "ListIndexes",
+            ): face_utilities.unary_unary_inline(servicer.ListIndexes),
+        }
+        server_options = beta_implementations.server_options(
+            request_deserializers=request_deserializers,
+            response_serializers=response_serializers,
+            thread_pool=pool,
+            thread_pool_size=pool_size,
+            default_timeout=default_timeout,
+            maximum_timeout=maximum_timeout,
+        )
+        return beta_implementations.server(
+            method_implementations, options=server_options
+        )
+
+    def beta_create_FirestoreAdmin_stub(
+        channel, host=None, metadata_transformer=None, pool=None, pool_size=None
+    ):
+        """The Beta API is deprecated for 0.15.0 and later.
+
+    It is recommended to use the GA API (classes and functions in this
+    file not marked beta) for all further purposes. This function was
+    generated only to ease transition from grpcio<0.15.0 to grpcio>=0.15.0"""
+        request_serializers = {
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "CreateIndex",
+            ): CreateIndexRequest.SerializeToString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "DeleteIndex",
+            ): DeleteIndexRequest.SerializeToString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "GetIndex",
+            ): GetIndexRequest.SerializeToString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "ListIndexes",
+            ): ListIndexesRequest.SerializeToString,
+        }
+        response_deserializers = {
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "CreateIndex",
+            ): google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "DeleteIndex",
+            ): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "GetIndex",
+            ): google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.Index.FromString,
+            (
+                "google.firestore.admin.v1beta1.FirestoreAdmin",
+                "ListIndexes",
+            ): ListIndexesResponse.FromString,
+        }
+        cardinalities = {
+            "CreateIndex": cardinality.Cardinality.UNARY_UNARY,
+            "DeleteIndex": cardinality.Cardinality.UNARY_UNARY,
+            "GetIndex": cardinality.Cardinality.UNARY_UNARY,
+            "ListIndexes": cardinality.Cardinality.UNARY_UNARY,
+        }
+        stub_options = beta_implementations.stub_options(
+            host=host,
+            metadata_transformer=metadata_transformer,
+            request_serializers=request_serializers,
+            response_deserializers=response_deserializers,
+            thread_pool=pool,
+            thread_pool_size=pool_size,
+        )
+        return beta_implementations.dynamic_stub(
+            channel,
+            "google.firestore.admin.v1beta1.FirestoreAdmin",
+            cardinalities,
+            options=stub_options,
+        )
+
+
+except ImportError:
+    pass
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/admin/firestore_admin_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/admin/firestore_admin_pb2_grpc.py
new file mode 100644
index 000000000000..81eaad7ad17e
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/admin/firestore_admin_pb2_grpc.py
@@ -0,0 +1,203 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.firestore_v1beta1.proto.admin import (
+    firestore_admin_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2,
+)
+from google.cloud.firestore_v1beta1.proto.admin import (
+    index_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class FirestoreAdminStub(object):
+    """The Cloud Firestore Admin API.
+
+  This API provides several administrative services for Cloud Firestore.
+
+  # Concepts
+
+  Project, Database, Namespace, Collection, and Document are used as defined in
+  the Google Cloud Firestore API.
+
+  Operation: An Operation represents work being performed in the background.
+
+
+  # Services
+
+  ## Index
+
+  The index service manages Cloud Firestore indexes.
+
+  Index creation is performed asynchronously.
+  An Operation resource is created for each such asynchronous operation.
+  The state of the operation (including any errors encountered)
+  may be queried via the Operation resource.
+
+  ## Metadata
+
+  Provides metadata and statistical information about data in Cloud Firestore.
+  The data provided as part of this API may be stale.
+
+  ## Operation
+
+  The Operations collection provides a record of actions performed for the
+  specified Project (including any Operations in progress). Operations are not
+  created directly but through calls on other collections or resources.
+
+  An Operation that is not yet done may be cancelled. The request to cancel is
+  asynchronous and the Operation may continue to run for some time after the
+  request to cancel is made.
+
+  An Operation that is done may be deleted so that it is no longer listed as
+  part of the Operation collection.
+
+  Operations are created by service `FirestoreAdmin`, but are accessed via
+  service `google.longrunning.Operations`.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateIndex = channel.unary_unary(
+            "/google.firestore.admin.v1beta1.FirestoreAdmin/CreateIndex",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.CreateIndexRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ListIndexes = channel.unary_unary(
+            "/google.firestore.admin.v1beta1.FirestoreAdmin/ListIndexes",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.ListIndexesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.ListIndexesResponse.FromString,
+        )
+        self.GetIndex = channel.unary_unary(
+            "/google.firestore.admin.v1beta1.FirestoreAdmin/GetIndex",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.GetIndexRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.Index.FromString,
+        )
+        self.DeleteIndex = channel.unary_unary(
+            "/google.firestore.admin.v1beta1.FirestoreAdmin/DeleteIndex",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.DeleteIndexRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class FirestoreAdminServicer(object):
+    """The Cloud Firestore Admin API.
+
+  This API provides several administrative services for Cloud Firestore.
+
+  # Concepts
+
+  Project, Database, Namespace, Collection, and Document are used as defined in
+  the Google Cloud Firestore API.
+
+  Operation: An Operation represents work being performed in the background.
+
+
+  # Services
+
+  ## Index
+
+  The index service manages Cloud Firestore indexes.
+
+  Index creation is performed asynchronously.
+  An Operation resource is created for each such asynchronous operation.
+  The state of the operation (including any errors encountered)
+  may be queried via the Operation resource.
+
+  ## Metadata
+
+  Provides metadata and statistical information about data in Cloud Firestore.
+  The data provided as part of this API may be stale.
+
+  ## Operation
+
+  The Operations collection provides a record of actions performed for the
+  specified Project (including any Operations in progress). Operations are not
+  created directly but through calls on other collections or resources.
+
+  An Operation that is not yet done may be cancelled. The request to cancel is
+  asynchronous and the Operation may continue to run for some time after the
+  request to cancel is made.
+
+  An Operation that is done may be deleted so that it is no longer listed as
+  part of the Operation collection.
+
+  Operations are created by service `FirestoreAdmin`, but are accessed via
+  service `google.longrunning.Operations`.
+  """
+
+    def CreateIndex(self, request, context):
+        """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`.
+    If the index already exists, the call will return an `ALREADY_EXISTS`
+    status.
+
+    During creation, the process could result in an error, in which case the
+    index will move to the `ERROR` state. The process can be recovered by
+    fixing the data that caused the error, removing the index with
+    [delete][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex], then re-creating the index with
+    [create][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+
+    Indexes with a single field cannot be created.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListIndexes(self, request, context):
+        """Lists the indexes that match the specified filters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIndex(self, request, context):
+        """Gets an index.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteIndex(self, request, context):
+        """Deletes an index.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_FirestoreAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateIndex": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateIndex,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.CreateIndexRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ListIndexes": grpc.unary_unary_rpc_method_handler(
+            servicer.ListIndexes,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.ListIndexesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.ListIndexesResponse.SerializeToString,
+        ),
+        "GetIndex": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIndex,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.GetIndexRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_index__pb2.Index.SerializeToString,
+        ),
+        "DeleteIndex": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteIndex,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_admin_dot_firestore__admin__pb2.DeleteIndexRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.firestore.admin.v1beta1.FirestoreAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/admin/index_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/admin/index_pb2.py
new file mode 100644
index 000000000000..de43ee88e44c
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/admin/index_pb2.py
@@ -0,0 +1,300 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/admin/index.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/admin/index.proto",
+    package="google.firestore.admin.v1beta1",
+    syntax="proto3",
+    serialized_pb=_b(
+        '\n6google/cloud/firestore_v1beta1/proto/admin/index.proto\x12\x1egoogle.firestore.admin.v1beta1\x1a\x1cgoogle/api/annotations.proto"\x9c\x01\n\nIndexField\x12\x12\n\nfield_path\x18\x01 \x01(\t\x12=\n\x04mode\x18\x02 \x01(\x0e\x32/.google.firestore.admin.v1beta1.IndexField.Mode";\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x02\x12\x0e\n\nDESCENDING\x10\x03"\xe8\x01\n\x05Index\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12:\n\x06\x66ields\x18\x03 \x03(\x0b\x32*.google.firestore.admin.v1beta1.IndexField\x12:\n\x05state\x18\x06 \x01(\x0e\x32+.google.firestore.admin.v1beta1.Index.State"B\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x03\x12\t\n\x05READY\x10\x02\x12\t\n\x05\x45RROR\x10\x05\x42\xa5\x01\n"com.google.firestore.admin.v1beta1B\nIndexProtoP\x01ZCgoogle.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin\xa2\x02\x04GCFS\xaa\x02$Google.Cloud.Firestore.Admin.V1Beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_INDEXFIELD_MODE = _descriptor.EnumDescriptor(
+    name="Mode",
+    full_name="google.firestore.admin.v1beta1.IndexField.Mode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MODE_UNSPECIFIED", index=0, number=0, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASCENDING", index=1, number=2, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESCENDING", index=2, number=3, options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    options=None,
+    serialized_start=218,
+    serialized_end=277,
+)
+_sym_db.RegisterEnumDescriptor(_INDEXFIELD_MODE)
+
+_INDEX_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.firestore.admin.v1beta1.Index.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED", index=0, number=0, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=3, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=3, number=5, options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    options=None,
+    serialized_start=446,
+    serialized_end=512,
+)
+_sym_db.RegisterEnumDescriptor(_INDEX_STATE)
+
+
+_INDEXFIELD = _descriptor.Descriptor(
+    name="IndexField",
+    full_name="google.firestore.admin.v1beta1.IndexField",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_path",
+            full_name="google.firestore.admin.v1beta1.IndexField.field_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mode",
+            full_name="google.firestore.admin.v1beta1.IndexField.mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_INDEXFIELD_MODE],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=121,
+    serialized_end=277,
+)
+
+
+_INDEX = _descriptor.Descriptor(
+    name="Index",
+    full_name="google.firestore.admin.v1beta1.Index",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.admin.v1beta1.Index.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.admin.v1beta1.Index.collection_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.admin.v1beta1.Index.fields",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.firestore.admin.v1beta1.Index.state",
+            index=3,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_INDEX_STATE],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=280,
+    serialized_end=512,
+)
+
+_INDEXFIELD.fields_by_name["mode"].enum_type = _INDEXFIELD_MODE
+_INDEXFIELD_MODE.containing_type = _INDEXFIELD
+_INDEX.fields_by_name["fields"].message_type = _INDEXFIELD
+_INDEX.fields_by_name["state"].enum_type = _INDEX_STATE
+_INDEX_STATE.containing_type = _INDEX
+DESCRIPTOR.message_types_by_name["IndexField"] = _INDEXFIELD
+DESCRIPTOR.message_types_by_name["Index"] = _INDEX
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+IndexField = _reflection.GeneratedProtocolMessageType(
+    "IndexField",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INDEXFIELD,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.index_pb2",
+        __doc__="""A field of an index.
+  
+  
+  Attributes:
+      field_path:
+          The path of the field. Must match the field path specification
+          described by
+          [google.firestore.v1beta1.Document.fields][fields]. Special
+          field path ``__name__`` may be used by itself or at the end of
+          a path. ``__type__`` may be used only at the end of path.
+      mode:
+          The field's mode.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.IndexField)
+    ),
+)
+_sym_db.RegisterMessage(IndexField)
+
+Index = _reflection.GeneratedProtocolMessageType(
+    "Index",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INDEX,
+        __module__="google.cloud.firestore_v1beta1.proto.admin.index_pb2",
+        __doc__="""An index definition.
+  
+  
+  Attributes:
+      name:
+          The resource name of the index.
+      collection_id:
+          The collection ID to which this index applies. Required.
+      fields:
+          The fields to index.
+      state:
+          The state of the index. The state is read-only. @OutputOnly
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.admin.v1beta1.Index)
+    ),
+)
+_sym_db.RegisterMessage(Index)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        '\n"com.google.firestore.admin.v1beta1B\nIndexProtoP\001ZCgoogle.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin\242\002\004GCFS\252\002$Google.Cloud.Firestore.Admin.V1Beta1'
+    ),
+)
+try:
+    # THESE ELEMENTS WILL BE DEPRECATED.
+    # Please use the generated *_pb2_grpc.py files instead.
+    import grpc
+    from grpc.beta import implementations as beta_implementations
+    from grpc.beta import interfaces as beta_interfaces
+    from grpc.framework.common import cardinality
+    from grpc.framework.interfaces.face import utilities as face_utilities
+except ImportError:
+    pass
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/admin/index_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/admin/index_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/admin/index_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/common.proto b/firestore/google/cloud/firestore_v1beta1/proto/common.proto
new file mode 100644
index 000000000000..87c88a3be630
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/common.proto
@@ -0,0 +1,84 @@
+// 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.firestore.v1beta1;
+
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1beta1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+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.
+// This is different from standard field masks, as this is always scoped to a
+// [Document][google.firestore.v1beta1.Document], and takes in account the dynamic nature of [Value][google.firestore.v1beta1.Value].
+message DocumentMask {
+  // The list of field paths in the mask. See [Document.fields][google.firestore.v1beta1.Document.fields] for a field
+  // path syntax reference.
+  repeated string field_paths = 1;
+}
+
+// A precondition on a document, used for conditional operations.
+message Precondition {
+  // The type of precondition.
+  oneof condition_type {
+    // When set to `true`, the target document must exist.
+    // When set to `false`, the target document must not exist.
+    bool exists = 1;
+
+    // When set, the target document must exist and have been last updated at
+    // that time.
+    google.protobuf.Timestamp update_time = 2;
+  }
+}
+
+// Options for creating a new transaction.
+message TransactionOptions {
+  // Options for a transaction that can be used to read and write documents.
+  message ReadWrite {
+    // An optional transaction to retry.
+    bytes retry_transaction = 1;
+  }
+
+  // Options for a transaction that can only be used to read documents.
+  message ReadOnly {
+    // The consistency mode for this transaction. If not set, defaults to strong
+    // consistency.
+    oneof consistency_selector {
+      // Reads documents at the given time.
+      // This may not be older than 60 seconds.
+      google.protobuf.Timestamp read_time = 2;
+    }
+  }
+
+  // The mode of the transaction.
+  oneof mode {
+    // The transaction can only be used for read operations.
+    ReadOnly read_only = 2;
+
+    // The transaction can be used for both read and write operations.
+    ReadWrite read_write = 3;
+  }
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/common_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/common_pb2.py
new file mode 100644
index 000000000000..8475b2a2764f
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/common_pb2.py
@@ -0,0 +1,451 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/common.proto",
+    package="google.firestore.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.firestore.v1beta1B\013CommonProtoP\001ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\242\002\004GCFS\252\002\036Google.Cloud.Firestore.V1Beta1\312\002\036Google\\Cloud\\Firestore\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/firestore_v1beta1/proto/common.proto\x12\x18google.firestore.v1beta1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"#\n\x0c\x44ocumentMask\x12\x13\n\x0b\x66ield_paths\x18\x01 \x03(\t"e\n\x0cPrecondition\x12\x10\n\x06\x65xists\x18\x01 \x01(\x08H\x00\x12\x31\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x10\n\x0e\x63ondition_type"\xb3\x02\n\x12TransactionOptions\x12J\n\tread_only\x18\x02 \x01(\x0b\x32\x35.google.firestore.v1beta1.TransactionOptions.ReadOnlyH\x00\x12L\n\nread_write\x18\x03 \x01(\x0b\x32\x36.google.firestore.v1beta1.TransactionOptions.ReadWriteH\x00\x1a&\n\tReadWrite\x12\x19\n\x11retry_transaction\x18\x01 \x01(\x0c\x1aS\n\x08ReadOnly\x12/\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x16\n\x14\x63onsistency_selectorB\x06\n\x04modeB\xb9\x01\n\x1c\x63om.google.firestore.v1beta1B\x0b\x43ommonProtoP\x01ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\xa2\x02\x04GCFS\xaa\x02\x1eGoogle.Cloud.Firestore.V1Beta1\xca\x02\x1eGoogle\\Cloud\\Firestore\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENTMASK = _descriptor.Descriptor(
+    name="DocumentMask",
+    full_name="google.firestore.v1beta1.DocumentMask",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_paths",
+            full_name="google.firestore.v1beta1.DocumentMask.field_paths",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=142,
+    serialized_end=177,
+)
+
+
+_PRECONDITION = _descriptor.Descriptor(
+    name="Precondition",
+    full_name="google.firestore.v1beta1.Precondition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="exists",
+            full_name="google.firestore.v1beta1.Precondition.exists",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.firestore.v1beta1.Precondition.update_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="condition_type",
+            full_name="google.firestore.v1beta1.Precondition.condition_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=179,
+    serialized_end=280,
+)
+
+
+_TRANSACTIONOPTIONS_READWRITE = _descriptor.Descriptor(
+    name="ReadWrite",
+    full_name="google.firestore.v1beta1.TransactionOptions.ReadWrite",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="retry_transaction",
+            full_name="google.firestore.v1beta1.TransactionOptions.ReadWrite.retry_transaction",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=459,
+    serialized_end=497,
+)
+
+_TRANSACTIONOPTIONS_READONLY = _descriptor.Descriptor(
+    name="ReadOnly",
+    full_name="google.firestore.v1beta1.TransactionOptions.ReadOnly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.TransactionOptions.ReadOnly.read_time",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1beta1.TransactionOptions.ReadOnly.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=499,
+    serialized_end=582,
+)
+
+_TRANSACTIONOPTIONS = _descriptor.Descriptor(
+    name="TransactionOptions",
+    full_name="google.firestore.v1beta1.TransactionOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_only",
+            full_name="google.firestore.v1beta1.TransactionOptions.read_only",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_write",
+            full_name="google.firestore.v1beta1.TransactionOptions.read_write",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TRANSACTIONOPTIONS_READWRITE, _TRANSACTIONOPTIONS_READONLY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="mode",
+            full_name="google.firestore.v1beta1.TransactionOptions.mode",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=283,
+    serialized_end=590,
+)
+
+_PRECONDITION.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRECONDITION.oneofs_by_name["condition_type"].fields.append(
+    _PRECONDITION.fields_by_name["exists"]
+)
+_PRECONDITION.fields_by_name["exists"].containing_oneof = _PRECONDITION.oneofs_by_name[
+    "condition_type"
+]
+_PRECONDITION.oneofs_by_name["condition_type"].fields.append(
+    _PRECONDITION.fields_by_name["update_time"]
+)
+_PRECONDITION.fields_by_name[
+    "update_time"
+].containing_oneof = _PRECONDITION.oneofs_by_name["condition_type"]
+_TRANSACTIONOPTIONS_READWRITE.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSACTIONOPTIONS_READONLY.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["consistency_selector"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["read_time"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "read_time"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["consistency_selector"]
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].message_type = _TRANSACTIONOPTIONS_READONLY
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].message_type = _TRANSACTIONOPTIONS_READWRITE
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_only"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_write"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+DESCRIPTOR.message_types_by_name["DocumentMask"] = _DOCUMENTMASK
+DESCRIPTOR.message_types_by_name["Precondition"] = _PRECONDITION
+DESCRIPTOR.message_types_by_name["TransactionOptions"] = _TRANSACTIONOPTIONS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DocumentMask = _reflection.GeneratedProtocolMessageType(
+    "DocumentMask",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTMASK,
+        __module__="google.cloud.firestore_v1beta1.proto.common_pb2",
+        __doc__="""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. This is different
+  from standard field masks, as this is always scoped to a
+  [Document][google.firestore.v1beta1.Document], and takes in account the
+  dynamic nature of [Value][google.firestore.v1beta1.Value].
+  
+  
+  Attributes:
+      field_paths:
+          The list of field paths in the mask. See
+          [Document.fields][google.firestore.v1beta1.Document.fields]
+          for a field path syntax reference.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DocumentMask)
+    ),
+)
+_sym_db.RegisterMessage(DocumentMask)
+
+Precondition = _reflection.GeneratedProtocolMessageType(
+    "Precondition",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRECONDITION,
+        __module__="google.cloud.firestore_v1beta1.proto.common_pb2",
+        __doc__="""A precondition on a document, used for conditional operations.
+  
+  
+  Attributes:
+      condition_type:
+          The type of precondition.
+      exists:
+          When set to ``true``, the target document must exist. When set
+          to ``false``, the target document must not exist.
+      update_time:
+          When set, the target document must exist and have been last
+          updated at that time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Precondition)
+    ),
+)
+_sym_db.RegisterMessage(Precondition)
+
+TransactionOptions = _reflection.GeneratedProtocolMessageType(
+    "TransactionOptions",
+    (_message.Message,),
+    dict(
+        ReadWrite=_reflection.GeneratedProtocolMessageType(
+            "ReadWrite",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READWRITE,
+                __module__="google.cloud.firestore_v1beta1.proto.common_pb2",
+                __doc__="""Options for a transaction that can be used to read and write documents.
+    
+    
+    Attributes:
+        retry_transaction:
+            An optional transaction to retry.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.TransactionOptions.ReadWrite)
+            ),
+        ),
+        ReadOnly=_reflection.GeneratedProtocolMessageType(
+            "ReadOnly",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READONLY,
+                __module__="google.cloud.firestore_v1beta1.proto.common_pb2",
+                __doc__="""Options for a transaction that can only be used to read documents.
+    
+    
+    Attributes:
+        consistency_selector:
+            The consistency mode for this transaction. If not set,
+            defaults to strong consistency.
+        read_time:
+            Reads documents at the given time. This may not be older than
+            60 seconds.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.TransactionOptions.ReadOnly)
+            ),
+        ),
+        DESCRIPTOR=_TRANSACTIONOPTIONS,
+        __module__="google.cloud.firestore_v1beta1.proto.common_pb2",
+        __doc__="""Options for creating a new transaction.
+  
+  
+  Attributes:
+      mode:
+          The mode of the transaction.
+      read_only:
+          The transaction can only be used for read operations.
+      read_write:
+          The transaction can be used for both read and write
+          operations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.TransactionOptions)
+    ),
+)
+_sym_db.RegisterMessage(TransactionOptions)
+_sym_db.RegisterMessage(TransactionOptions.ReadWrite)
+_sym_db.RegisterMessage(TransactionOptions.ReadOnly)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/common_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/document.proto b/firestore/google/cloud/firestore_v1beta1/proto/document.proto
new file mode 100644
index 000000000000..8a043df59980
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/document.proto
@@ -0,0 +1,151 @@
+// 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.firestore.v1beta1;
+
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/latlng.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1beta1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "DocumentProto";
+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.
+message Document {
+  // The resource name of the document, for example
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  string name = 1;
+
+  // The document's fields.
+  //
+  // The map keys represent field names.
+  //
+  // A simple field name contains only characters `a` to `z`, `A` to `Z`,
+  // `0` to `9`, or `_`, and must not start with `0` to `9`. For example,
+  // `foo_bar_17`.
+  //
+  // Field names matching the regular expression `__.*__` are reserved. Reserved
+  // field names are forbidden except in certain documented contexts. The map
+  // keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be
+  // empty.
+  //
+  // Field paths may be used in other contexts to refer to structured fields
+  // defined here. For `map_value`, the field path is represented by the simple
+  // or quoted field names of the containing fields, delimited by `.`. For
+  // example, the structured field
+  // `"foo" : { map_value: { "x&y" : { string_value: "hello" }}}` would be
+  // represented by the field path `foo.x&y`.
+  //
+  // Within a field path, a quoted field name starts and ends with `` ` `` and
+  // may contain any character. Some characters, including `` ` ``, must be
+  // escaped using a `\`. For example, `` `x&y` `` represents `x&y` and
+  // `` `bak\`tik` `` represents `` bak`tik ``.
+  map<string, Value> fields = 2;
+
+  // Output only. The time at which the document was created.
+  //
+  // This value increases monotonically when a document is deleted then
+  // recreated. It can also be compared to values from other documents and
+  // the `read_time` of a query.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Output only. The time at which the document was last changed.
+  //
+  // This value is initially set to the `create_time` then increases
+  // monotonically with each change to the document. It can also be
+  // compared to values from other documents and the `read_time` of a query.
+  google.protobuf.Timestamp update_time = 4;
+}
+
+// A message that can hold any of the supported value types.
+message Value {
+  // Must have a value set.
+  oneof value_type {
+    // A null value.
+    google.protobuf.NullValue null_value = 11;
+
+    // A boolean value.
+    bool boolean_value = 1;
+
+    // An integer value.
+    int64 integer_value = 2;
+
+    // A double value.
+    double double_value = 3;
+
+    // A timestamp value.
+    //
+    // Precise only to microseconds. When stored, any additional precision is
+    // rounded down.
+    google.protobuf.Timestamp timestamp_value = 10;
+
+    // A string value.
+    //
+    // The string, represented as UTF-8, must not exceed 1 MiB - 89 bytes.
+    // Only the first 1,500 bytes of the UTF-8 representation are considered by
+    // queries.
+    string string_value = 17;
+
+    // A bytes value.
+    //
+    // Must not exceed 1 MiB - 89 bytes.
+    // Only the first 1,500 bytes are considered by queries.
+    bytes bytes_value = 18;
+
+    // A reference to a document. For example:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    string reference_value = 5;
+
+    // A geo point value representing a point on the surface of Earth.
+    google.type.LatLng geo_point_value = 8;
+
+    // An array value.
+    //
+    // Cannot directly contain another array value, though can contain an
+    // map which contains another array.
+    ArrayValue array_value = 9;
+
+    // A map value.
+    MapValue map_value = 6;
+  }
+}
+
+// An array value.
+message ArrayValue {
+  // Values in the array.
+  repeated Value values = 1;
+}
+
+// A map value.
+message MapValue {
+  // The map's fields.
+  //
+  // The map keys represent field names. Field names matching the regular
+  // expression `__.*__` are reserved. Reserved field names are forbidden except
+  // in certain documented contexts. The map keys, represented as UTF-8, must
+  // not exceed 1,500 bytes and cannot be empty.
+  map<string, Value> fields = 1;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/document_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/document_pb2.py
new file mode 100644
index 000000000000..4ca1f65ed709
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/document_pb2.py
@@ -0,0 +1,798 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/document.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/document.proto",
+    package="google.firestore.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.firestore.v1beta1B\rDocumentProtoP\001ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\242\002\004GCFS\252\002\036Google.Cloud.Firestore.V1Beta1\312\002\036Google\\Cloud\\Firestore\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/firestore_v1beta1/proto/document.proto\x12\x18google.firestore.v1beta1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x18google/type/latlng.proto\x1a\x1cgoogle/api/annotations.proto"\x8a\x02\n\x08\x44ocument\x12\x0c\n\x04name\x18\x01 \x01(\t\x12>\n\x06\x66ields\x18\x02 \x03(\x0b\x32..google.firestore.v1beta1.Document.FieldsEntry\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1aN\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.google.firestore.v1beta1.Value:\x02\x38\x01"\xb8\x03\n\x05Value\x12\x30\n\nnull_value\x18\x0b \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00\x12\x17\n\rboolean_value\x18\x01 \x01(\x08H\x00\x12\x17\n\rinteger_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x35\n\x0ftimestamp_value\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x16\n\x0cstring_value\x18\x11 \x01(\tH\x00\x12\x15\n\x0b\x62ytes_value\x18\x12 \x01(\x0cH\x00\x12\x19\n\x0freference_value\x18\x05 \x01(\tH\x00\x12.\n\x0fgeo_point_value\x18\x08 \x01(\x0b\x32\x13.google.type.LatLngH\x00\x12;\n\x0b\x61rray_value\x18\t \x01(\x0b\x32$.google.firestore.v1beta1.ArrayValueH\x00\x12\x37\n\tmap_value\x18\x06 \x01(\x0b\x32".google.firestore.v1beta1.MapValueH\x00\x42\x0c\n\nvalue_type"=\n\nArrayValue\x12/\n\x06values\x18\x01 \x03(\x0b\x32\x1f.google.firestore.v1beta1.Value"\x9a\x01\n\x08MapValue\x12>\n\x06\x66ields\x18\x01 \x03(\x0b\x32..google.firestore.v1beta1.MapValue.FieldsEntry\x1aN\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.google.firestore.v1beta1.Value:\x02\x38\x01\x42\xbb\x01\n\x1c\x63om.google.firestore.v1beta1B\rDocumentProtoP\x01ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\xa2\x02\x04GCFS\xaa\x02\x1eGoogle.Cloud.Firestore.V1Beta1\xca\x02\x1eGoogle\\Cloud\\Firestore\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENT_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.firestore.v1beta1.Document.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1beta1.Document.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1beta1.Document.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=389,
+    serialized_end=467,
+)
+
+_DOCUMENT = _descriptor.Descriptor(
+    name="Document",
+    full_name="google.firestore.v1beta1.Document",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.v1beta1.Document.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.v1beta1.Document.fields",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.firestore.v1beta1.Document.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.firestore.v1beta1.Document.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DOCUMENT_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=201,
+    serialized_end=467,
+)
+
+
+_VALUE = _descriptor.Descriptor(
+    name="Value",
+    full_name="google.firestore.v1beta1.Value",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="null_value",
+            full_name="google.firestore.v1beta1.Value.null_value",
+            index=0,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boolean_value",
+            full_name="google.firestore.v1beta1.Value.boolean_value",
+            index=1,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="integer_value",
+            full_name="google.firestore.v1beta1.Value.integer_value",
+            index=2,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="double_value",
+            full_name="google.firestore.v1beta1.Value.double_value",
+            index=3,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp_value",
+            full_name="google.firestore.v1beta1.Value.timestamp_value",
+            index=4,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.firestore.v1beta1.Value.string_value",
+            index=5,
+            number=17,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bytes_value",
+            full_name="google.firestore.v1beta1.Value.bytes_value",
+            index=6,
+            number=18,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_value",
+            full_name="google.firestore.v1beta1.Value.reference_value",
+            index=7,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="geo_point_value",
+            full_name="google.firestore.v1beta1.Value.geo_point_value",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_value",
+            full_name="google.firestore.v1beta1.Value.array_value",
+            index=9,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="map_value",
+            full_name="google.firestore.v1beta1.Value.map_value",
+            index=10,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value_type",
+            full_name="google.firestore.v1beta1.Value.value_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=470,
+    serialized_end=910,
+)
+
+
+_ARRAYVALUE = _descriptor.Descriptor(
+    name="ArrayValue",
+    full_name="google.firestore.v1beta1.ArrayValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.firestore.v1beta1.ArrayValue.values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=912,
+    serialized_end=973,
+)
+
+
+_MAPVALUE_FIELDSENTRY = _descriptor.Descriptor(
+    name="FieldsEntry",
+    full_name="google.firestore.v1beta1.MapValue.FieldsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1beta1.MapValue.FieldsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1beta1.MapValue.FieldsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=389,
+    serialized_end=467,
+)
+
+_MAPVALUE = _descriptor.Descriptor(
+    name="MapValue",
+    full_name="google.firestore.v1beta1.MapValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.v1beta1.MapValue.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_MAPVALUE_FIELDSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=976,
+    serialized_end=1130,
+)
+
+_DOCUMENT_FIELDSENTRY.fields_by_name["value"].message_type = _VALUE
+_DOCUMENT_FIELDSENTRY.containing_type = _DOCUMENT
+_DOCUMENT.fields_by_name["fields"].message_type = _DOCUMENT_FIELDSENTRY
+_DOCUMENT.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCUMENT.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VALUE.fields_by_name[
+    "null_value"
+].enum_type = google_dot_protobuf_dot_struct__pb2._NULLVALUE
+_VALUE.fields_by_name[
+    "timestamp_value"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VALUE.fields_by_name[
+    "geo_point_value"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_VALUE.fields_by_name["array_value"].message_type = _ARRAYVALUE
+_VALUE.fields_by_name["map_value"].message_type = _MAPVALUE
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["null_value"])
+_VALUE.fields_by_name["null_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["boolean_value"]
+)
+_VALUE.fields_by_name["boolean_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["integer_value"]
+)
+_VALUE.fields_by_name["integer_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["double_value"])
+_VALUE.fields_by_name["double_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["timestamp_value"]
+)
+_VALUE.fields_by_name["timestamp_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["string_value"])
+_VALUE.fields_by_name["string_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["bytes_value"])
+_VALUE.fields_by_name["bytes_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["reference_value"]
+)
+_VALUE.fields_by_name["reference_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(
+    _VALUE.fields_by_name["geo_point_value"]
+)
+_VALUE.fields_by_name["geo_point_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["array_value"])
+_VALUE.fields_by_name["array_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_VALUE.oneofs_by_name["value_type"].fields.append(_VALUE.fields_by_name["map_value"])
+_VALUE.fields_by_name["map_value"].containing_oneof = _VALUE.oneofs_by_name[
+    "value_type"
+]
+_ARRAYVALUE.fields_by_name["values"].message_type = _VALUE
+_MAPVALUE_FIELDSENTRY.fields_by_name["value"].message_type = _VALUE
+_MAPVALUE_FIELDSENTRY.containing_type = _MAPVALUE
+_MAPVALUE.fields_by_name["fields"].message_type = _MAPVALUE_FIELDSENTRY
+DESCRIPTOR.message_types_by_name["Document"] = _DOCUMENT
+DESCRIPTOR.message_types_by_name["Value"] = _VALUE
+DESCRIPTOR.message_types_by_name["ArrayValue"] = _ARRAYVALUE
+DESCRIPTOR.message_types_by_name["MapValue"] = _MAPVALUE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Document = _reflection.GeneratedProtocolMessageType(
+    "Document",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DOCUMENT_FIELDSENTRY,
+                __module__="google.cloud.firestore_v1beta1.proto.document_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Document.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_DOCUMENT,
+        __module__="google.cloud.firestore_v1beta1.proto.document_pb2",
+        __doc__="""A Firestore document.
+  
+  Must not exceed 1 MiB - 4 bytes.
+  
+  
+  Attributes:
+      name:
+          The resource name of the document, for example ``projects/{pro
+          ject_id}/databases/{database_id}/documents/{document_path}``.
+      fields:
+          The document's fields.  The map keys represent field names.  A
+          simple field name contains only characters ``a`` to ``z``,
+          ``A`` to ``Z``, ``0`` to ``9``, or ``_``, and must not start
+          with ``0`` to ``9``. For example, ``foo_bar_17``.  Field names
+          matching the regular expression ``__.*__`` are reserved.
+          Reserved field names are forbidden except in certain
+          documented contexts. The map keys, represented as UTF-8, must
+          not exceed 1,500 bytes and cannot be empty.  Field paths may
+          be used in other contexts to refer to structured fields
+          defined here. For ``map_value``, the field path is represented
+          by the simple or quoted field names of the containing fields,
+          delimited by ``.``. For example, the structured field ``"foo"
+          : { map_value: { "x&y" : { string_value: "hello" }}}`` would
+          be represented by the field path ``foo.x&y``.  Within a field
+          path, a quoted field name starts and ends with ````` and may
+          contain any character. Some characters, including `````, must
+          be escaped using a ``\``. For example, ```x&y``` represents
+          ``x&y`` and ```bak\`tik``` represents ``bak`tik``.
+      create_time:
+          Output only. The time at which the document was created.  This
+          value increases monotonically when a document is deleted then
+          recreated. It can also be compared to values from other
+          documents and the ``read_time`` of a query.
+      update_time:
+          Output only. The time at which the document was last changed.
+          This value is initially set to the ``create_time`` then
+          increases monotonically with each change to the document. It
+          can also be compared to values from other documents and the
+          ``read_time`` of a query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Document)
+    ),
+)
+_sym_db.RegisterMessage(Document)
+_sym_db.RegisterMessage(Document.FieldsEntry)
+
+Value = _reflection.GeneratedProtocolMessageType(
+    "Value",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VALUE,
+        __module__="google.cloud.firestore_v1beta1.proto.document_pb2",
+        __doc__="""A message that can hold any of the supported value types.
+  
+  
+  Attributes:
+      value_type:
+          Must have a value set.
+      null_value:
+          A null value.
+      boolean_value:
+          A boolean value.
+      integer_value:
+          An integer value.
+      double_value:
+          A double value.
+      timestamp_value:
+          A timestamp value.  Precise only to microseconds. When stored,
+          any additional precision is rounded down.
+      string_value:
+          A string value.  The string, represented as UTF-8, must not
+          exceed 1 MiB - 89 bytes. Only the first 1,500 bytes of the
+          UTF-8 representation are considered by queries.
+      bytes_value:
+          A bytes value.  Must not exceed 1 MiB - 89 bytes. Only the
+          first 1,500 bytes are considered by queries.
+      reference_value:
+          A reference to a document. For example: ``projects/{project_id
+          }/databases/{database_id}/documents/{document_path}``.
+      geo_point_value:
+          A geo point value representing a point on the surface of
+          Earth.
+      array_value:
+          An array value.  Cannot directly contain another array value,
+          though can contain an map which contains another array.
+      map_value:
+          A map value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Value)
+    ),
+)
+_sym_db.RegisterMessage(Value)
+
+ArrayValue = _reflection.GeneratedProtocolMessageType(
+    "ArrayValue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARRAYVALUE,
+        __module__="google.cloud.firestore_v1beta1.proto.document_pb2",
+        __doc__="""An array value.
+  
+  
+  Attributes:
+      values:
+          Values in the array.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ArrayValue)
+    ),
+)
+_sym_db.RegisterMessage(ArrayValue)
+
+MapValue = _reflection.GeneratedProtocolMessageType(
+    "MapValue",
+    (_message.Message,),
+    dict(
+        FieldsEntry=_reflection.GeneratedProtocolMessageType(
+            "FieldsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MAPVALUE_FIELDSENTRY,
+                __module__="google.cloud.firestore_v1beta1.proto.document_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.MapValue.FieldsEntry)
+            ),
+        ),
+        DESCRIPTOR=_MAPVALUE,
+        __module__="google.cloud.firestore_v1beta1.proto.document_pb2",
+        __doc__="""A map value.
+  
+  
+  Attributes:
+      fields:
+          The map's fields.  The map keys represent field names. Field
+          names matching the regular expression ``__.*__`` are reserved.
+          Reserved field names are forbidden except in certain
+          documented contexts. The map keys, represented as UTF-8, must
+          not exceed 1,500 bytes and cannot be empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.MapValue)
+    ),
+)
+_sym_db.RegisterMessage(MapValue)
+_sym_db.RegisterMessage(MapValue.FieldsEntry)
+
+
+DESCRIPTOR._options = None
+_DOCUMENT_FIELDSENTRY._options = None
+_MAPVALUE_FIELDSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/document_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/document_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/document_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/event_flow_document_change_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/event_flow_document_change_pb2.py
new file mode 100644
index 000000000000..957acef2695c
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/event_flow_document_change_pb2.py
@@ -0,0 +1,62 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/event_flow_document_change.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.firestore_v1beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/event_flow_document_change.proto",
+    package="google.firestore.v1beta1",
+    syntax="proto3",
+    serialized_pb=_b(
+        "\nEgoogle/cloud/firestore_v1beta1/proto/event_flow_document_change.proto\x12\x18google.firestore.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x31google/cloud/firestore_v1beta1/proto/common.proto\x1a\x33google/cloud/firestore_v1beta1/proto/document.protoB\xa2\x01\n\x1c\x63om.google.firestore.v1beta1B\x1c\x45ventFlowDocumentChangeProtoP\x01ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\xaa\x02\x1eGoogle.Cloud.Firestore.V1Beta1b\x06proto3"
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        "\n\034com.google.firestore.v1beta1B\034EventFlowDocumentChangeProtoP\001ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\252\002\036Google.Cloud.Firestore.V1Beta1"
+    ),
+)
+try:
+    # THESE ELEMENTS WILL BE DEPRECATED.
+    # Please use the generated *_pb2_grpc.py files instead.
+    import grpc
+    from grpc.beta import implementations as beta_implementations
+    from grpc.beta import interfaces as beta_interfaces
+    from grpc.framework.common import cardinality
+    from grpc.framework.interfaces.face import utilities as face_utilities
+except ImportError:
+    pass
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/event_flow_document_change_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/event_flow_document_change_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/event_flow_document_change_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/field.proto b/firestore/google/cloud/firestore_v1beta1/proto/field.proto
new file mode 100644
index 000000000000..9d1534eb1f63
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/field.proto
@@ -0,0 +1,95 @@
+// 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.firestore.admin.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/firestore/admin/v1beta2/index.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta2";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta2;admin";
+option java_multiple_files = true;
+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
+// collections in the database with the same id.
+message 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
+    // 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
+    // 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).
+    string ancestor_field = 3;
+
+    // Output only
+    // When true, the `Field`'s index configuration is in the process of being
+    // reverted. Once complete, the index config will transition to the same
+    // state as the field specified by `ancestor_field`, at which point
+    // `uses_ancestor_config` will be `true` and `reverting` will be `false`.
+    bool reverting = 4;
+  }
+
+  // A field name of the form
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}`
+  //
+  // A field path may be a simple field name, e.g. `address` or a path to fields
+  // within map_value , e.g. `address.city`,
+  // or a special field path. The only valid special field is `*`, which
+  // represents any field.
+  //
+  // Field paths may be quoted using ` (backtick). The only character that needs
+  // to be escaped within a quoted field path is the backtick character itself,
+  // escaped using a backslash. Special characters in field paths that
+  // must be quoted include: `*`, `.`,
+  // ``` (backtick), `[`, `]`, as well as any ascii symbolic characters.
+  //
+  // Examples:
+  // (Note: Comments here are written in markdown syntax, so there is an
+  //  additional layer of backticks to represent a code block)
+  // `\`address.city\`` represents a field named `address.city`, not the map key
+  // `city` in the field `address`.
+  // `\`*\`` represents a field named `*`, not any field.
+  //
+  // A special `Field` contains the default indexing settings for all fields.
+  // This field's resource name is:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`
+  // Indexes defined on this `Field` will be applied to all fields which do not
+  // have their own `Field` index configuration.
+  string name = 1;
+
+  // The index configuration for this field. If unset, field indexing will
+  // revert to the configuration defined by the `ancestor_field`. To
+  // explicitly remove all indexes for this field, specify an index config
+  // with an empty list of indexes.
+  IndexConfig index_config = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/firestore.proto b/firestore/google/cloud/firestore_v1beta1/proto/firestore.proto
new file mode 100644
index 000000000000..b7ba79075a40
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/firestore.proto
@@ -0,0 +1,761 @@
+// 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.firestore.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/firestore/v1beta1/common.proto";
+import "google/firestore/v1beta1/document.proto";
+import "google/firestore/v1beta1/query.proto";
+import "google/firestore/v1beta1/write.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1beta1;firestore";
+option java_multiple_files = true;
+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.
+//
+// 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.
+service Firestore {
+  // Gets a single document.
+  rpc GetDocument(GetDocumentRequest) returns (Document) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/databases/*/documents/*/**}"
+    };
+  }
+
+  // Lists documents.
+  rpc ListDocuments(ListDocumentsRequest) returns (ListDocumentsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/databases/*/documents/*/**}/{collection_id}"
+    };
+  }
+
+  // Creates a new document.
+  rpc CreateDocument(CreateDocumentRequest) returns (Document) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/databases/*/documents/**}/{collection_id}"
+      body: "document"
+    };
+  }
+
+  // Updates or inserts a document.
+  rpc UpdateDocument(UpdateDocumentRequest) returns (Document) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{document.name=projects/*/databases/*/documents/*/**}"
+      body: "document"
+    };
+  }
+
+  // Deletes a document.
+  rpc DeleteDocument(DeleteDocumentRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/databases/*/documents/*/**}"
+    };
+  }
+
+  // Gets multiple documents.
+  //
+  // Documents returned by this method are not guaranteed to be returned in the
+  // same order that they were requested.
+  rpc BatchGetDocuments(BatchGetDocumentsRequest) returns (stream BatchGetDocumentsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{database=projects/*/databases/*}/documents:batchGet"
+      body: "*"
+    };
+  }
+
+  // Starts a new transaction.
+  rpc BeginTransaction(BeginTransactionRequest) returns (BeginTransactionResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{database=projects/*/databases/*}/documents:beginTransaction"
+      body: "*"
+    };
+  }
+
+  // Commits a transaction, while optionally updating documents.
+  rpc Commit(CommitRequest) returns (CommitResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{database=projects/*/databases/*}/documents:commit"
+      body: "*"
+    };
+  }
+
+  // Rolls back a transaction.
+  rpc Rollback(RollbackRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1beta1/{database=projects/*/databases/*}/documents:rollback"
+      body: "*"
+    };
+  }
+
+  // Runs a query.
+  rpc RunQuery(RunQueryRequest) returns (stream RunQueryResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/databases/*/documents}:runQuery"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{parent=projects/*/databases/*/documents/*/**}:runQuery"
+        body: "*"
+      }
+    };
+  }
+
+  // Streams batches of document updates and deletes, in order.
+  rpc Write(stream WriteRequest) returns (stream WriteResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{database=projects/*/databases/*}/documents:write"
+      body: "*"
+    };
+  }
+
+  // Listens to changes.
+  rpc Listen(stream ListenRequest) returns (stream ListenResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{database=projects/*/databases/*}/documents:listen"
+      body: "*"
+    };
+  }
+
+  // Lists all the collection IDs underneath a document.
+  rpc ListCollectionIds(ListCollectionIdsRequest) returns (ListCollectionIdsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/databases/*/documents}:listCollectionIds"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{parent=projects/*/databases/*/documents/*/**}:listCollectionIds"
+        body: "*"
+      }
+    };
+  }
+}
+
+// The request for [Firestore.GetDocument][google.firestore.v1beta1.Firestore.GetDocument].
+message GetDocumentRequest {
+  // The resource name of the Document to get. In the format:
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  string name = 1;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If the document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 2;
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads the document in a transaction.
+    bytes transaction = 3;
+
+    // Reads the version of the document at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 5;
+  }
+}
+
+// The request for [Firestore.ListDocuments][google.firestore.v1beta1.Firestore.ListDocuments].
+message ListDocumentsRequest {
+  // 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;
+
+  // The collection ID, relative to `parent`, to list. For example: `chatrooms`
+  // or `messages`.
+  string collection_id = 2;
+
+  // The maximum number of documents to return.
+  int32 page_size = 3;
+
+  // The `next_page_token` value returned from a previous List request, if any.
+  string page_token = 4;
+
+  // The order to sort results by. For example: `priority desc, name`.
+  string order_by = 6;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If a document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 7;
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads documents in a transaction.
+    bytes transaction = 8;
+
+    // Reads documents as they were at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 10;
+  }
+
+  // If the list should show missing documents. A missing document is a
+  // document that does not exist but has sub-documents. These documents will
+  // be returned with a key but will not have fields, [Document.create_time][google.firestore.v1beta1.Document.create_time],
+  // or [Document.update_time][google.firestore.v1beta1.Document.update_time] set.
+  //
+  // Requests with `show_missing` may not specify `where` or
+  // `order_by`.
+  bool show_missing = 12;
+}
+
+// The response for [Firestore.ListDocuments][google.firestore.v1beta1.Firestore.ListDocuments].
+message ListDocumentsResponse {
+  // The Documents found.
+  repeated Document documents = 1;
+
+  // The next page token.
+  string next_page_token = 2;
+}
+
+// The request for [Firestore.CreateDocument][google.firestore.v1beta1.Firestore.CreateDocument].
+message CreateDocumentRequest {
+  // 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;
+
+  // The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+  string collection_id = 2;
+
+  // 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;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If the document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 5;
+}
+
+// The request for [Firestore.UpdateDocument][google.firestore.v1beta1.Firestore.UpdateDocument].
+message UpdateDocumentRequest {
+  // The updated document.
+  // Creates the document if it does not already exist.
+  Document document = 1;
+
+  // The fields to update.
+  // None of the field paths in the mask may contain a reserved name.
+  //
+  // If the document exists on the server and has fields not referenced in the
+  // mask, they are left unchanged.
+  // Fields referenced in the mask, but not present in the input document, are
+  // deleted from the document on the server.
+  DocumentMask update_mask = 2;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If the document has a field that is not present in this mask, that field
+  // will not be returned in the response.
+  DocumentMask mask = 3;
+
+  // An optional precondition on the document.
+  // The request will fail if this is set and not met by the target document.
+  Precondition current_document = 4;
+}
+
+// The request for [Firestore.DeleteDocument][google.firestore.v1beta1.Firestore.DeleteDocument].
+message DeleteDocumentRequest {
+  // The resource name of the Document to delete. In the format:
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  string name = 1;
+
+  // An optional precondition on the document.
+  // The request will fail if this is set and not met by the target document.
+  Precondition current_document = 2;
+}
+
+// The request for [Firestore.BatchGetDocuments][google.firestore.v1beta1.Firestore.BatchGetDocuments].
+message BatchGetDocumentsRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The names of the documents to retrieve. In the format:
+  // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+  // The request will fail if any of the document is not a child resource of the
+  // given `database`. Duplicate names will be elided.
+  repeated string documents = 2;
+
+  // The fields to return. If not set, returns all fields.
+  //
+  // If a document has a field that is not present in this mask, that field will
+  // not be returned in the response.
+  DocumentMask mask = 3;
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads documents in a transaction.
+    bytes transaction = 4;
+
+    // Starts a new transaction and reads the documents.
+    // Defaults to a read-only transaction.
+    // The new transaction ID will be returned as the first response in the
+    // stream.
+    TransactionOptions new_transaction = 5;
+
+    // Reads documents as they were at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 7;
+  }
+}
+
+// The streamed response for [Firestore.BatchGetDocuments][google.firestore.v1beta1.Firestore.BatchGetDocuments].
+message BatchGetDocumentsResponse {
+  // A single result.
+  // This can be empty if the server is just returning a transaction.
+  oneof result {
+    // A document that was requested.
+    Document found = 1;
+
+    // A document name that was requested but does not exist. In the format:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    string missing = 2;
+  }
+
+  // The transaction that was started as part of this request.
+  // Will only be set in the first response, and only if
+  // [BatchGetDocumentsRequest.new_transaction][google.firestore.v1beta1.BatchGetDocumentsRequest.new_transaction] was set in the request.
+  bytes transaction = 3;
+
+  // The time at which the document was read.
+  // This may be monotically increasing, in this case the previous documents in
+  // the result stream are guaranteed not to have changed between their
+  // read_time and this one.
+  google.protobuf.Timestamp read_time = 4;
+}
+
+// The request for [Firestore.BeginTransaction][google.firestore.v1beta1.Firestore.BeginTransaction].
+message BeginTransactionRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The options for the transaction.
+  // Defaults to a read-write transaction.
+  TransactionOptions options = 2;
+}
+
+// The response for [Firestore.BeginTransaction][google.firestore.v1beta1.Firestore.BeginTransaction].
+message BeginTransactionResponse {
+  // The transaction that was started.
+  bytes transaction = 1;
+}
+
+// The request for [Firestore.Commit][google.firestore.v1beta1.Firestore.Commit].
+message CommitRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The writes to apply.
+  //
+  // Always executed atomically and in order.
+  repeated Write writes = 2;
+
+  // If set, applies all writes in this transaction, and commits it.
+  bytes transaction = 3;
+}
+
+// The response for [Firestore.Commit][google.firestore.v1beta1.Firestore.Commit].
+message CommitResponse {
+  // The result of applying the writes.
+  //
+  // This i-th write result corresponds to the i-th write in the
+  // request.
+  repeated WriteResult write_results = 1;
+
+  // The time at which the commit occurred.
+  google.protobuf.Timestamp commit_time = 2;
+}
+
+// The request for [Firestore.Rollback][google.firestore.v1beta1.Firestore.Rollback].
+message RollbackRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The transaction to roll back.
+  bytes transaction = 2;
+}
+
+// The request for [Firestore.RunQuery][google.firestore.v1beta1.Firestore.RunQuery].
+message RunQueryRequest {
+  // 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;
+
+  // The query to run.
+  oneof query_type {
+    // A structured query.
+    StructuredQuery structured_query = 2;
+  }
+
+  // The consistency mode for this transaction.
+  // If not set, defaults to strong consistency.
+  oneof consistency_selector {
+    // Reads documents in a transaction.
+    bytes transaction = 5;
+
+    // Starts a new transaction and reads the documents.
+    // Defaults to a read-only transaction.
+    // The new transaction ID will be returned as the first response in the
+    // stream.
+    TransactionOptions new_transaction = 6;
+
+    // Reads documents as they were at the given time.
+    // This may not be older than 60 seconds.
+    google.protobuf.Timestamp read_time = 7;
+  }
+}
+
+// The response for [Firestore.RunQuery][google.firestore.v1beta1.Firestore.RunQuery].
+message RunQueryResponse {
+  // The transaction that was started as part of this request.
+  // Can only be set in the first response, and only if
+  // [RunQueryRequest.new_transaction][google.firestore.v1beta1.RunQueryRequest.new_transaction] was set in the request.
+  // If set, no other fields will be set in this response.
+  bytes transaction = 2;
+
+  // A query result.
+  // Not set when reporting partial progress.
+  Document document = 1;
+
+  // The time at which the document was read. This may be monotonically
+  // increasing; in this case, the previous documents in the result stream are
+  // guaranteed not to have changed between their `read_time` and this one.
+  //
+  // If the query returns no results, a response with `read_time` and no
+  // `document` will be sent, and this represents the time at which the query
+  // was run.
+  google.protobuf.Timestamp read_time = 3;
+
+  // The number of results that have been skipped due to an offset between
+  // the last response and the current response.
+  int32 skipped_results = 4;
+}
+
+// The request for [Firestore.Write][google.firestore.v1beta1.Firestore.Write].
+//
+// The first request creates a stream, or resumes an existing one from a token.
+//
+// When creating a new stream, the server replies with a response containing
+// only an ID and a token, to use in the next request.
+//
+// When resuming a stream, the server first streams any responses later than the
+// 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:
+  // `projects/{project_id}/databases/{database_id}`.
+  // This is only required in the first message.
+  string database = 1;
+
+  // The ID of the write stream to resume.
+  // This may only be set in the first message. When left empty, a new write
+  // stream will be created.
+  string stream_id = 2;
+
+  // The writes to apply.
+  //
+  // Always executed atomically and in order.
+  // This must be empty on the first request.
+  // This may be empty on the last request.
+  // This must not be empty on all other requests.
+  repeated Write writes = 3;
+
+  // A stream token that was previously sent by the server.
+  //
+  // The client should set this field to the token from the most recent
+  // [WriteResponse][google.firestore.v1beta1.WriteResponse] it has received. This acknowledges that the client has
+  // received responses up to this token. After sending this token, earlier
+  // tokens may not be used anymore.
+  //
+  // The server may close the stream if there are too many unacknowledged
+  // responses.
+  //
+  // Leave this field unset when creating a new stream. To resume a stream at
+  // a specific point, set this field and the `stream_id` field.
+  //
+  // Leave this field unset when creating a new stream.
+  bytes stream_token = 4;
+
+  // Labels associated with this write request.
+  map<string, string> labels = 5;
+}
+
+// The response for [Firestore.Write][google.firestore.v1beta1.Firestore.Write].
+message WriteResponse {
+  // The ID of the stream.
+  // Only set on the first message, when a new stream was created.
+  string stream_id = 1;
+
+  // A token that represents the position of this response in the stream.
+  // This can be used by a client to resume the stream at this point.
+  //
+  // This field is always set.
+  bytes stream_token = 2;
+
+  // The result of applying the writes.
+  //
+  // This i-th write result corresponds to the i-th write in the
+  // request.
+  repeated WriteResult write_results = 3;
+
+  // The time at which the commit occurred.
+  google.protobuf.Timestamp commit_time = 4;
+}
+
+// A request for [Firestore.Listen][google.firestore.v1beta1.Firestore.Listen]
+message ListenRequest {
+  // The database name. In the format:
+  // `projects/{project_id}/databases/{database_id}`.
+  string database = 1;
+
+  // The supported target changes.
+  oneof target_change {
+    // A target to add to this stream.
+    Target add_target = 2;
+
+    // The ID of a target to remove from this stream.
+    int32 remove_target = 3;
+  }
+
+  // Labels associated with this target change.
+  map<string, string> labels = 4;
+}
+
+// The response for [Firestore.Listen][google.firestore.v1beta1.Firestore.Listen].
+message ListenResponse {
+  // The supported responses.
+  oneof response_type {
+    // Targets have changed.
+    TargetChange target_change = 2;
+
+    // A [Document][google.firestore.v1beta1.Document] has changed.
+    DocumentChange document_change = 3;
+
+    // A [Document][google.firestore.v1beta1.Document] has been deleted.
+    DocumentDelete document_delete = 4;
+
+    // A [Document][google.firestore.v1beta1.Document] has been removed from a target (because it is no longer
+    // relevant to that target).
+    DocumentRemove document_remove = 6;
+
+    // A filter to apply to the set of documents previously returned for the
+    // given target.
+    //
+    // Returned when documents may have been removed from the given target, but
+    // the exact documents are unknown.
+    ExistenceFilter filter = 5;
+  }
+}
+
+// A specification of a set of documents to listen to.
+message Target {
+  // A target specified by a set of documents names.
+  message DocumentsTarget {
+    // The names of the documents to retrieve. In the format:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    // The request will fail if any of the document is not a child resource of
+    // the given `database`. Duplicate names will be elided.
+    repeated string documents = 2;
+  }
+
+  // A target specified by a query.
+  message QueryTarget {
+    // 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;
+
+    // The query to run.
+    oneof query_type {
+      // A structured query.
+      StructuredQuery structured_query = 2;
+    }
+  }
+
+  // The type of target to listen to.
+  oneof target_type {
+    // A target specified by a query.
+    QueryTarget query = 2;
+
+    // A target specified by a set of document names.
+    DocumentsTarget documents = 3;
+  }
+
+  // When to start listening.
+  //
+  // If not specified, all matching Documents are returned before any
+  // subsequent changes.
+  oneof resume_type {
+    // A resume token from a prior [TargetChange][google.firestore.v1beta1.TargetChange] for an identical target.
+    //
+    // Using a resume token with a different target is unsupported and may fail.
+    bytes resume_token = 4;
+
+    // Start listening after a specific `read_time`.
+    //
+    // The client must know the state of matching documents at this time.
+    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.
+  int32 target_id = 5;
+
+  // If the target should be removed once it is current and consistent.
+  bool once = 6;
+}
+
+// Targets being watched have changed.
+message TargetChange {
+  // The type of change.
+  enum TargetChangeType {
+    // No change has occurred. Used only to send an updated `resume_token`.
+    NO_CHANGE = 0;
+
+    // The targets have been added.
+    ADD = 1;
+
+    // The targets have been removed.
+    REMOVE = 2;
+
+    // The targets reflect all changes committed before the targets were added
+    // to the stream.
+    //
+    // This will be sent after or with a `read_time` that is greater than or
+    // equal to the time at which the targets were added.
+    //
+    // Listeners can wait for this change if read-after-write semantics
+    // are desired.
+    CURRENT = 3;
+
+    // The targets have been reset, and a new initial state for the targets
+    // will be returned in subsequent changes.
+    //
+    // After the initial state is complete, `CURRENT` will be returned even
+    // if the target was previously indicated to be `CURRENT`.
+    RESET = 4;
+  }
+
+  // The type of change that occurred.
+  TargetChangeType target_change_type = 1;
+
+  // The target IDs of targets that have changed.
+  //
+  // 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.
+  repeated int32 target_ids = 2;
+
+  // The error that resulted in this change, if applicable.
+  google.rpc.Status cause = 3;
+
+  // A token that can be used to resume the stream for the given `target_ids`,
+  // or all targets if `target_ids` is empty.
+  //
+  // Not set on every target change.
+  bytes resume_token = 4;
+
+  // The consistent `read_time` for the given `target_ids` (omitted when the
+  // target_ids are not at a consistent snapshot).
+  //
+  // The stream is guaranteed to send a `read_time` with `target_ids` empty
+  // whenever the entire stream reaches a new consistent snapshot. ADD,
+  // CURRENT, and RESET messages are guaranteed to (eventually) result in a
+  // new consistent snapshot (while NO_CHANGE and REMOVE messages are not).
+  //
+  // For a given stream, `read_time` is guaranteed to be monotonically
+  // increasing.
+  google.protobuf.Timestamp read_time = 6;
+}
+
+// The request for [Firestore.ListCollectionIds][google.firestore.v1beta1.Firestore.ListCollectionIds].
+message ListCollectionIdsRequest {
+  // 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;
+
+  // The maximum number of results to return.
+  int32 page_size = 2;
+
+  // A page token. Must be a value from
+  // [ListCollectionIdsResponse][google.firestore.v1beta1.ListCollectionIdsResponse].
+  string page_token = 3;
+}
+
+// The response from [Firestore.ListCollectionIds][google.firestore.v1beta1.Firestore.ListCollectionIds].
+message ListCollectionIdsResponse {
+  // The collection ids.
+  repeated string collection_ids = 1;
+
+  // A page token that may be used to continue the list.
+  string next_page_token = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/firestore_admin.proto b/firestore/google/cloud/firestore_v1beta1/proto/firestore_admin.proto
new file mode 100644
index 000000000000..15ce94da6b68
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/firestore_admin.proto
@@ -0,0 +1,365 @@
+// 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.firestore.admin.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/firestore/admin/v1beta1/index.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin";
+option java_multiple_files = true;
+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.
+//
+// # Concepts
+//
+// Project, Database, Namespace, Collection, and Document are used as defined in
+// the Google Cloud Firestore API.
+//
+// Operation: An Operation represents work being performed in the background.
+//
+//
+// # Services
+//
+// ## Index
+//
+// The index service manages Cloud Firestore indexes.
+//
+// Index creation is performed asynchronously.
+// An Operation resource is created for each such asynchronous operation.
+// The state of the operation (including any errors encountered)
+// may be queried via the Operation resource.
+//
+// ## Metadata
+//
+// Provides metadata and statistical information about data in Cloud Firestore.
+// The data provided as part of this API may be stale.
+//
+// ## Operation
+//
+// The Operations collection provides a record of actions performed for the
+// specified Project (including any Operations in progress). Operations are not
+// created directly but through calls on other collections or resources.
+//
+// An Operation that is not yet done may be cancelled. The request to cancel is
+// asynchronous and the Operation may continue to run for some time after the
+// request to cancel is made.
+//
+// An Operation that is done may be deleted so that it is no longer listed as
+// part of the Operation collection.
+//
+// Operations are created by service `FirestoreAdmin`, but are accessed via
+// service `google.longrunning.Operations`.
+service FirestoreAdmin {
+  // 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`.
+  // If the index already exists, the call will return an `ALREADY_EXISTS`
+  // status.
+  //
+  // During creation, the process could result in an error, in which case the
+  // index will move to the `ERROR` state. The process can be recovered by
+  // fixing the data that caused the error, removing the index with
+  // [delete][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex], then re-creating the index with
+  // [create][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+  //
+  // Indexes with a single field cannot be created.
+  rpc CreateIndex(CreateIndexRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/databases/*}/indexes"
+      body: "index"
+    };
+  }
+
+  // Lists the indexes that match the specified filters.
+  rpc ListIndexes(ListIndexesRequest) returns (ListIndexesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/databases/*}/indexes"
+    };
+  }
+
+  // Gets an index.
+  rpc GetIndex(GetIndexRequest) returns (Index) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/databases/*/indexes/*}"
+    };
+  }
+
+  // Deletes an index.
+  rpc DeleteIndex(DeleteIndexRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/databases/*/indexes/*}"
+    };
+  }
+
+  // Exports a copy of all or a subset of documents from Google Cloud Firestore
+  // to another storage system, such as Google Cloud Storage. Recent updates to
+  // documents may not be reflected in the export. The export occurs in the
+  // background and its progress can be monitored and managed via the
+  // Operation resource that is created. The output of an export may only be
+  // 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 ExportDocuments(ExportDocumentsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/databases/*}:exportDocuments"
+      body: "*"
+    };
+  }
+
+  // Imports documents into Google Cloud Firestore. Existing documents with the
+  // same name are overwritten. The import occurs in the background and its
+  // progress can be monitored and managed via the Operation resource that is
+  // created. If an ImportDocuments operation is cancelled, it is possible
+  // that a subset of the data has already been imported to Cloud Firestore.
+  rpc ImportDocuments(ImportDocumentsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/databases/*}:importDocuments"
+      body: "*"
+    };
+  }
+}
+
+// Metadata for index operations. This metadata populates
+// the metadata field of [google.longrunning.Operation][google.longrunning.Operation].
+message IndexOperationMetadata {
+  // The type of index operation.
+  enum OperationType {
+    // Unspecified. Never set by server.
+    OPERATION_TYPE_UNSPECIFIED = 0;
+
+    // The operation is creating the index. Initiated by a `CreateIndex` call.
+    CREATING_INDEX = 1;
+  }
+
+  // The time that work began on the operation.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time the operation ended, either successfully or otherwise. Unset if
+  // the operation is still active.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The index resource that this operation is acting on. For example:
+  // `projects/{project_id}/databases/{database_id}/indexes/{index_id}`
+  string index = 3;
+
+  // The type of index operation.
+  OperationType operation_type = 4;
+
+  // True if the [google.longrunning.Operation] was cancelled. If the
+  // cancellation is in progress, cancelled will be true but
+  // [google.longrunning.Operation.done][google.longrunning.Operation.done] will be false.
+  bool cancelled = 5;
+
+  // Progress of the existing operation, measured in number of documents.
+  Progress document_progress = 6;
+}
+
+// Measures the progress of a particular metric.
+message Progress {
+  // An estimate of how much work has been completed. Note that this may be
+  // greater than `work_estimated`.
+  int64 work_completed = 1;
+
+  // An estimate of how much work needs to be performed. Zero if the
+  // work estimate is unavailable. May change as work progresses.
+  int64 work_estimated = 2;
+}
+
+// The request for [FirestoreAdmin.CreateIndex][google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex].
+message CreateIndexRequest {
+  // The name of the database this index will apply to. For example:
+  // `projects/{project_id}/databases/{database_id}`
+  string parent = 1;
+
+  // The index to create. The name and state fields are output only and will be
+  // ignored. Certain single field indexes cannot be created or deleted.
+  Index index = 2;
+}
+
+// The request for [FirestoreAdmin.GetIndex][google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex].
+message GetIndexRequest {
+  // The name of the index. For example:
+  // `projects/{project_id}/databases/{database_id}/indexes/{index_id}`
+  string name = 1;
+}
+
+// The request for [FirestoreAdmin.ListIndexes][google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes].
+message ListIndexesRequest {
+  // The database name. For example:
+  // `projects/{project_id}/databases/{database_id}`
+  string parent = 1;
+
+  string filter = 2;
+
+  // The standard List page size.
+  int32 page_size = 3;
+
+  // The standard List page token.
+  string page_token = 4;
+}
+
+// The request for [FirestoreAdmin.DeleteIndex][google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex].
+message DeleteIndexRequest {
+  // The index name. For example:
+  // `projects/{project_id}/databases/{database_id}/indexes/{index_id}`
+  string name = 1;
+}
+
+// The response for [FirestoreAdmin.ListIndexes][google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes].
+message ListIndexesResponse {
+  // The indexes.
+  repeated Index indexes = 1;
+
+  // The standard List next-page token.
+  string next_page_token = 2;
+}
+
+// The request for [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1beta1.FirestoreAdmin.ExportDocuments].
+message ExportDocumentsRequest {
+  // Database to export. Should be of the form:
+  // `projects/{project_id}/databases/{database_id}`.
+  string name = 1;
+
+  // Which collection ids to export. Unspecified means all collections.
+  repeated string collection_ids = 3;
+
+  // The output URI. Currently only supports Google Cloud Storage URIs of the
+  // form: `gs://BUCKET_NAME[/NAMESPACE_PATH]`, where `BUCKET_NAME` is the name
+  // of the Google Cloud Storage bucket and `NAMESPACE_PATH` is an optional
+  // Google Cloud Storage namespace path. When
+  // choosing a name, be sure to consider Google Cloud Storage naming
+  // guidelines: https://cloud.google.com/storage/docs/naming.
+  // If the URI is a bucket (without a namespace path), a prefix will be
+  // generated based on the start time.
+  string output_uri_prefix = 4;
+}
+
+// The request for [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1beta1.FirestoreAdmin.ImportDocuments].
+message ImportDocumentsRequest {
+  // Database to import into. Should be of the form:
+  // `projects/{project_id}/databases/{database_id}`.
+  string name = 1;
+
+  // Which collection ids to import. Unspecified means all collections included
+  // in the import.
+  repeated string collection_ids = 3;
+
+  // Location of the exported files.
+  // This must match the output_uri_prefix of an ExportDocumentsResponse from
+  // an export that has completed successfully.
+  // See:
+  // [google.firestore.admin.v1beta1.ExportDocumentsResponse.output_uri_prefix][google.firestore.admin.v1beta1.ExportDocumentsResponse.output_uri_prefix].
+  string input_uri_prefix = 4;
+}
+
+// Returned in the [google.longrunning.Operation][google.longrunning.Operation] response field.
+message ExportDocumentsResponse {
+  // Location of the output files. This can be used to begin an import
+  // into Cloud Firestore (this project or another project) after the operation
+  // completes successfully.
+  string output_uri_prefix = 1;
+}
+
+// Metadata for ExportDocuments operations.
+message ExportDocumentsMetadata {
+  // The time that work began on the operation.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time the operation ended, either successfully or otherwise. Unset if
+  // the operation is still active.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The state of the export operation.
+  OperationState operation_state = 3;
+
+  // An estimate of the number of documents processed.
+  Progress progress_documents = 4;
+
+  // An estimate of the number of bytes processed.
+  Progress progress_bytes = 5;
+
+  // Which collection ids are being exported.
+  repeated string collection_ids = 6;
+
+  // Where the entities are being exported to.
+  string output_uri_prefix = 7;
+}
+
+// Metadata for ImportDocuments operations.
+message ImportDocumentsMetadata {
+  // The time that work began on the operation.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time the operation ended, either successfully or otherwise. Unset if
+  // the operation is still active.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The state of the import operation.
+  OperationState operation_state = 3;
+
+  // An estimate of the number of documents processed.
+  Progress progress_documents = 4;
+
+  // An estimate of the number of bytes processed.
+  Progress progress_bytes = 5;
+
+  // Which collection ids are being imported.
+  repeated string collection_ids = 6;
+
+  // The location of the documents being imported.
+  string input_uri_prefix = 7;
+}
+
+// The various possible states for an ongoing Operation.
+enum OperationState {
+  // Unspecified.
+  STATE_UNSPECIFIED = 0;
+
+  // Request is being prepared for processing.
+  INITIALIZING = 1;
+
+  // Request is actively being processed.
+  PROCESSING = 2;
+
+  // Request is in the process of being cancelled after user called
+  // google.longrunning.Operations.CancelOperation on the operation.
+  CANCELLING = 3;
+
+  // Request has been processed and is in its finalization stage.
+  FINALIZING = 4;
+
+  // Request has completed successfully.
+  SUCCESSFUL = 5;
+
+  // Request has finished being processed, but encountered an error.
+  FAILED = 6;
+
+  // Request has finished being cancelled after user called
+  // google.longrunning.Operations.CancelOperation.
+  CANCELLED = 7;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/firestore_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/firestore_pb2.py
new file mode 100644
index 000000000000..301347f11d08
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/firestore_pb2.py
@@ -0,0 +1,3788 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/firestore.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.firestore_v1beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    query_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    write_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/firestore.proto",
+    package="google.firestore.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.firestore.v1beta1B\016FirestoreProtoP\001ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\242\002\004GCFS\252\002\036Google.Cloud.Firestore.V1Beta1\312\002\036Google\\Cloud\\Firestore\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/firestore_v1beta1/proto/firestore.proto\x12\x18google.firestore.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x31google/cloud/firestore_v1beta1/proto/common.proto\x1a\x33google/cloud/firestore_v1beta1/proto/document.proto\x1a\x30google/cloud/firestore_v1beta1/proto/query.proto\x1a\x30google/cloud/firestore_v1beta1/proto/write.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xb8\x01\n\x12GetDocumentRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x04mask\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask\x12\x15\n\x0btransaction\x18\x03 \x01(\x0cH\x00\x12/\n\tread_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x16\n\x14\x63onsistency_selector"\xa2\x02\n\x14ListDocumentsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12\x34\n\x04mask\x18\x07 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask\x12\x15\n\x0btransaction\x18\x08 \x01(\x0cH\x00\x12/\n\tread_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x14\n\x0cshow_missing\x18\x0c \x01(\x08\x42\x16\n\x14\x63onsistency_selector"g\n\x15ListDocumentsResponse\x12\x35\n\tdocuments\x18\x01 \x03(\x0b\x32".google.firestore.v1beta1.Document\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xbf\x01\n\x15\x43reateDocumentRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12\x13\n\x0b\x64ocument_id\x18\x03 \x01(\t\x12\x34\n\x08\x64ocument\x18\x04 \x01(\x0b\x32".google.firestore.v1beta1.Document\x12\x34\n\x04mask\x18\x05 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask"\x82\x02\n\x15UpdateDocumentRequest\x12\x34\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.firestore.v1beta1.Document\x12;\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask\x12\x34\n\x04mask\x18\x03 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask\x12@\n\x10\x63urrent_document\x18\x04 \x01(\x0b\x32&.google.firestore.v1beta1.Precondition"g\n\x15\x44\x65leteDocumentRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12@\n\x10\x63urrent_document\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.Precondition"\x9e\x02\n\x18\x42\x61tchGetDocumentsRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x11\n\tdocuments\x18\x02 \x03(\t\x12\x34\n\x04mask\x18\x03 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask\x12\x15\n\x0btransaction\x18\x04 \x01(\x0cH\x00\x12G\n\x0fnew_transaction\x18\x05 \x01(\x0b\x32,.google.firestore.v1beta1.TransactionOptionsH\x00\x12/\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x42\x16\n\x14\x63onsistency_selector"\xb1\x01\n\x19\x42\x61tchGetDocumentsResponse\x12\x33\n\x05\x66ound\x18\x01 \x01(\x0b\x32".google.firestore.v1beta1.DocumentH\x00\x12\x11\n\x07missing\x18\x02 \x01(\tH\x00\x12\x13\n\x0btransaction\x18\x03 \x01(\x0c\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x08\n\x06result"j\n\x17\x42\x65ginTransactionRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12=\n\x07options\x18\x02 \x01(\x0b\x32,.google.firestore.v1beta1.TransactionOptions"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c"g\n\rCommitRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12/\n\x06writes\x18\x02 \x03(\x0b\x32\x1f.google.firestore.v1beta1.Write\x12\x13\n\x0btransaction\x18\x03 \x01(\x0c"\x7f\n\x0e\x43ommitResponse\x12<\n\rwrite_results\x18\x01 \x03(\x0b\x32%.google.firestore.v1beta1.WriteResult\x12/\n\x0b\x63ommit_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"8\n\x0fRollbackRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x13\n\x0btransaction\x18\x02 \x01(\x0c"\x9f\x02\n\x0fRunQueryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x45\n\x10structured_query\x18\x02 \x01(\x0b\x32).google.firestore.v1beta1.StructuredQueryH\x00\x12\x15\n\x0btransaction\x18\x05 \x01(\x0cH\x01\x12G\n\x0fnew_transaction\x18\x06 \x01(\x0b\x32,.google.firestore.v1beta1.TransactionOptionsH\x01\x12/\n\tread_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x42\x0c\n\nquery_typeB\x16\n\x14\x63onsistency_selector"\xa5\x01\n\x10RunQueryResponse\x12\x13\n\x0btransaction\x18\x02 \x01(\x0c\x12\x34\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.firestore.v1beta1.Document\x12-\n\tread_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fskipped_results\x18\x04 \x01(\x05"\xed\x01\n\x0cWriteRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x11\n\tstream_id\x18\x02 \x01(\t\x12/\n\x06writes\x18\x03 \x03(\x0b\x32\x1f.google.firestore.v1beta1.Write\x12\x14\n\x0cstream_token\x18\x04 \x01(\x0c\x12\x42\n\x06labels\x18\x05 \x03(\x0b\x32\x32.google.firestore.v1beta1.WriteRequest.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xa7\x01\n\rWriteResponse\x12\x11\n\tstream_id\x18\x01 \x01(\t\x12\x14\n\x0cstream_token\x18\x02 \x01(\x0c\x12<\n\rwrite_results\x18\x03 \x03(\x0b\x32%.google.firestore.v1beta1.WriteResult\x12/\n\x0b\x63ommit_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xf7\x01\n\rListenRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x36\n\nadd_target\x18\x02 \x01(\x0b\x32 .google.firestore.v1beta1.TargetH\x00\x12\x17\n\rremove_target\x18\x03 \x01(\x05H\x00\x12\x43\n\x06labels\x18\x04 \x03(\x0b\x32\x33.google.firestore.v1beta1.ListenRequest.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0f\n\rtarget_change"\xee\x02\n\x0eListenResponse\x12?\n\rtarget_change\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.TargetChangeH\x00\x12\x43\n\x0f\x64ocument_change\x18\x03 \x01(\x0b\x32(.google.firestore.v1beta1.DocumentChangeH\x00\x12\x43\n\x0f\x64ocument_delete\x18\x04 \x01(\x0b\x32(.google.firestore.v1beta1.DocumentDeleteH\x00\x12\x43\n\x0f\x64ocument_remove\x18\x06 \x01(\x0b\x32(.google.firestore.v1beta1.DocumentRemoveH\x00\x12;\n\x06\x66ilter\x18\x05 \x01(\x0b\x32).google.firestore.v1beta1.ExistenceFilterH\x00\x42\x0f\n\rresponse_type"\xb0\x03\n\x06Target\x12=\n\x05query\x18\x02 \x01(\x0b\x32,.google.firestore.v1beta1.Target.QueryTargetH\x00\x12\x45\n\tdocuments\x18\x03 \x01(\x0b\x32\x30.google.firestore.v1beta1.Target.DocumentsTargetH\x00\x12\x16\n\x0cresume_token\x18\x04 \x01(\x0cH\x01\x12/\n\tread_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x01\x12\x11\n\ttarget_id\x18\x05 \x01(\x05\x12\x0c\n\x04once\x18\x06 \x01(\x08\x1a$\n\x0f\x44ocumentsTarget\x12\x11\n\tdocuments\x18\x02 \x03(\t\x1ar\n\x0bQueryTarget\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x45\n\x10structured_query\x18\x02 \x01(\x0b\x32).google.firestore.v1beta1.StructuredQueryH\x00\x42\x0c\n\nquery_typeB\r\n\x0btarget_typeB\r\n\x0bresume_type"\xaf\x02\n\x0cTargetChange\x12S\n\x12target_change_type\x18\x01 \x01(\x0e\x32\x37.google.firestore.v1beta1.TargetChange.TargetChangeType\x12\x12\n\ntarget_ids\x18\x02 \x03(\x05\x12!\n\x05\x63\x61use\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12-\n\tread_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"N\n\x10TargetChangeType\x12\r\n\tNO_CHANGE\x10\x00\x12\x07\n\x03\x41\x44\x44\x10\x01\x12\n\n\x06REMOVE\x10\x02\x12\x0b\n\x07\x43URRENT\x10\x03\x12\t\n\x05RESET\x10\x04"Q\n\x18ListCollectionIdsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"L\n\x19ListCollectionIdsResponse\x12\x16\n\x0e\x63ollection_ids\x18\x01 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xc8\x13\n\tFirestore\x12\x9e\x01\n\x0bGetDocument\x12,.google.firestore.v1beta1.GetDocumentRequest\x1a".google.firestore.v1beta1.Document"=\x82\xd3\xe4\x93\x02\x37\x12\x35/v1beta1/{name=projects/*/databases/*/documents/*/**}\x12\xc1\x01\n\rListDocuments\x12..google.firestore.v1beta1.ListDocumentsRequest\x1a/.google.firestore.v1beta1.ListDocumentsResponse"O\x82\xd3\xe4\x93\x02I\x12G/v1beta1/{parent=projects/*/databases/*/documents/*/**}/{collection_id}\x12\xbe\x01\n\x0e\x43reateDocument\x12/.google.firestore.v1beta1.CreateDocumentRequest\x1a".google.firestore.v1beta1.Document"W\x82\xd3\xe4\x93\x02Q"E/v1beta1/{parent=projects/*/databases/*/documents/**}/{collection_id}:\x08\x64ocument\x12\xb7\x01\n\x0eUpdateDocument\x12/.google.firestore.v1beta1.UpdateDocumentRequest\x1a".google.firestore.v1beta1.Document"P\x82\xd3\xe4\x93\x02J2>/v1beta1/{document.name=projects/*/databases/*/documents/*/**}:\x08\x64ocument\x12\x98\x01\n\x0e\x44\x65leteDocument\x12/.google.firestore.v1beta1.DeleteDocumentRequest\x1a\x16.google.protobuf.Empty"=\x82\xd3\xe4\x93\x02\x37*5/v1beta1/{name=projects/*/databases/*/documents/*/**}\x12\xc8\x01\n\x11\x42\x61tchGetDocuments\x12\x32.google.firestore.v1beta1.BatchGetDocumentsRequest\x1a\x33.google.firestore.v1beta1.BatchGetDocumentsResponse"H\x82\xd3\xe4\x93\x02\x42"=/v1beta1/{database=projects/*/databases/*}/documents:batchGet:\x01*0\x01\x12\xcb\x01\n\x10\x42\x65ginTransaction\x12\x31.google.firestore.v1beta1.BeginTransactionRequest\x1a\x32.google.firestore.v1beta1.BeginTransactionResponse"P\x82\xd3\xe4\x93\x02J"E/v1beta1/{database=projects/*/databases/*}/documents:beginTransaction:\x01*\x12\xa3\x01\n\x06\x43ommit\x12\'.google.firestore.v1beta1.CommitRequest\x1a(.google.firestore.v1beta1.CommitResponse"F\x82\xd3\xe4\x93\x02@";/v1beta1/{database=projects/*/databases/*}/documents:commit:\x01*\x12\x97\x01\n\x08Rollback\x12).google.firestore.v1beta1.RollbackRequest\x1a\x16.google.protobuf.Empty"H\x82\xd3\xe4\x93\x02\x42"=/v1beta1/{database=projects/*/databases/*}/documents:rollback:\x01*\x12\xf4\x01\n\x08RunQuery\x12).google.firestore.v1beta1.RunQueryRequest\x1a*.google.firestore.v1beta1.RunQueryResponse"\x8e\x01\x82\xd3\xe4\x93\x02\x87\x01";/v1beta1/{parent=projects/*/databases/*/documents}:runQuery:\x01*ZE"@/v1beta1/{parent=projects/*/databases/*/documents/*/**}:runQuery:\x01*0\x01\x12\xa3\x01\n\x05Write\x12&.google.firestore.v1beta1.WriteRequest\x1a\'.google.firestore.v1beta1.WriteResponse"E\x82\xd3\xe4\x93\x02?":/v1beta1/{database=projects/*/databases/*}/documents:write:\x01*(\x01\x30\x01\x12\xa7\x01\n\x06Listen\x12\'.google.firestore.v1beta1.ListenRequest\x1a(.google.firestore.v1beta1.ListenResponse"F\x82\xd3\xe4\x93\x02@";/v1beta1/{database=projects/*/databases/*}/documents:listen:\x01*(\x01\x30\x01\x12\x9f\x02\n\x11ListCollectionIds\x12\x32.google.firestore.v1beta1.ListCollectionIdsRequest\x1a\x33.google.firestore.v1beta1.ListCollectionIdsResponse"\xa0\x01\x82\xd3\xe4\x93\x02\x99\x01"D/v1beta1/{parent=projects/*/databases/*/documents}:listCollectionIds:\x01*ZN"I/v1beta1/{parent=projects/*/databases/*/documents/*/**}:listCollectionIds:\x01*B\xbc\x01\n\x1c\x63om.google.firestore.v1beta1B\x0e\x46irestoreProtoP\x01ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\xa2\x02\x04GCFS\xaa\x02\x1eGoogle.Cloud.Firestore.V1Beta1\xca\x02\x1eGoogle\\Cloud\\Firestore\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TARGETCHANGE_TARGETCHANGETYPE = _descriptor.EnumDescriptor(
+    name="TargetChangeType",
+    full_name="google.firestore.v1beta1.TargetChange.TargetChangeType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NO_CHANGE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CURRENT", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESET", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4614,
+    serialized_end=4692,
+)
+_sym_db.RegisterEnumDescriptor(_TARGETCHANGE_TARGETCHANGETYPE)
+
+
+_GETDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="GetDocumentRequest",
+    full_name="google.firestore.v1beta1.GetDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.v1beta1.GetDocumentRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1beta1.GetDocumentRequest.mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.GetDocumentRequest.transaction",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.GetDocumentRequest.read_time",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1beta1.GetDocumentRequest.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=404,
+    serialized_end=588,
+)
+
+
+_LISTDOCUMENTSREQUEST = _descriptor.Descriptor(
+    name="ListDocumentsRequest",
+    full_name="google.firestore.v1beta1.ListDocumentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.collection_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.order_by",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.mask",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.transaction",
+            index=6,
+            number=8,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.read_time",
+            index=7,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="show_missing",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.show_missing",
+            index=8,
+            number=12,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1beta1.ListDocumentsRequest.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=591,
+    serialized_end=881,
+)
+
+
+_LISTDOCUMENTSRESPONSE = _descriptor.Descriptor(
+    name="ListDocumentsResponse",
+    full_name="google.firestore.v1beta1.ListDocumentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1beta1.ListDocumentsResponse.documents",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.v1beta1.ListDocumentsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=883,
+    serialized_end=986,
+)
+
+
+_CREATEDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="CreateDocumentRequest",
+    full_name="google.firestore.v1beta1.CreateDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1beta1.CreateDocumentRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.v1beta1.CreateDocumentRequest.collection_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_id",
+            full_name="google.firestore.v1beta1.CreateDocumentRequest.document_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.CreateDocumentRequest.document",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1beta1.CreateDocumentRequest.mask",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=989,
+    serialized_end=1180,
+)
+
+
+_UPDATEDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="UpdateDocumentRequest",
+    full_name="google.firestore.v1beta1.UpdateDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.UpdateDocumentRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.firestore.v1beta1.UpdateDocumentRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1beta1.UpdateDocumentRequest.mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_document",
+            full_name="google.firestore.v1beta1.UpdateDocumentRequest.current_document",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1183,
+    serialized_end=1441,
+)
+
+
+_DELETEDOCUMENTREQUEST = _descriptor.Descriptor(
+    name="DeleteDocumentRequest",
+    full_name="google.firestore.v1beta1.DeleteDocumentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.firestore.v1beta1.DeleteDocumentRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_document",
+            full_name="google.firestore.v1beta1.DeleteDocumentRequest.current_document",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1443,
+    serialized_end=1546,
+)
+
+
+_BATCHGETDOCUMENTSREQUEST = _descriptor.Descriptor(
+    name="BatchGetDocumentsRequest",
+    full_name="google.firestore.v1beta1.BatchGetDocumentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.documents",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.transaction",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_transaction",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.new_transaction",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.read_time",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsRequest.consistency_selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1549,
+    serialized_end=1835,
+)
+
+
+_BATCHGETDOCUMENTSRESPONSE = _descriptor.Descriptor(
+    name="BatchGetDocumentsResponse",
+    full_name="google.firestore.v1beta1.BatchGetDocumentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="found",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsResponse.found",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsResponse.missing",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsResponse.transaction",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsResponse.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="result",
+            full_name="google.firestore.v1beta1.BatchGetDocumentsResponse.result",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1838,
+    serialized_end=2015,
+)
+
+
+_BEGINTRANSACTIONREQUEST = _descriptor.Descriptor(
+    name="BeginTransactionRequest",
+    full_name="google.firestore.v1beta1.BeginTransactionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1beta1.BeginTransactionRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="options",
+            full_name="google.firestore.v1beta1.BeginTransactionRequest.options",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2017,
+    serialized_end=2123,
+)
+
+
+_BEGINTRANSACTIONRESPONSE = _descriptor.Descriptor(
+    name="BeginTransactionResponse",
+    full_name="google.firestore.v1beta1.BeginTransactionResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.BeginTransactionResponse.transaction",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2125,
+    serialized_end=2172,
+)
+
+
+_COMMITREQUEST = _descriptor.Descriptor(
+    name="CommitRequest",
+    full_name="google.firestore.v1beta1.CommitRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1beta1.CommitRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="writes",
+            full_name="google.firestore.v1beta1.CommitRequest.writes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.CommitRequest.transaction",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2174,
+    serialized_end=2277,
+)
+
+
+_COMMITRESPONSE = _descriptor.Descriptor(
+    name="CommitResponse",
+    full_name="google.firestore.v1beta1.CommitResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="write_results",
+            full_name="google.firestore.v1beta1.CommitResponse.write_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commit_time",
+            full_name="google.firestore.v1beta1.CommitResponse.commit_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2279,
+    serialized_end=2406,
+)
+
+
+_ROLLBACKREQUEST = _descriptor.Descriptor(
+    name="RollbackRequest",
+    full_name="google.firestore.v1beta1.RollbackRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1beta1.RollbackRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.RollbackRequest.transaction",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2408,
+    serialized_end=2464,
+)
+
+
+_RUNQUERYREQUEST = _descriptor.Descriptor(
+    name="RunQueryRequest",
+    full_name="google.firestore.v1beta1.RunQueryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1beta1.RunQueryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_query",
+            full_name="google.firestore.v1beta1.RunQueryRequest.structured_query",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.RunQueryRequest.transaction",
+            index=2,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_transaction",
+            full_name="google.firestore.v1beta1.RunQueryRequest.new_transaction",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.RunQueryRequest.read_time",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="query_type",
+            full_name="google.firestore.v1beta1.RunQueryRequest.query_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="consistency_selector",
+            full_name="google.firestore.v1beta1.RunQueryRequest.consistency_selector",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=2467,
+    serialized_end=2754,
+)
+
+
+_RUNQUERYRESPONSE = _descriptor.Descriptor(
+    name="RunQueryResponse",
+    full_name="google.firestore.v1beta1.RunQueryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.firestore.v1beta1.RunQueryResponse.transaction",
+            index=0,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.RunQueryResponse.document",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.RunQueryResponse.read_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skipped_results",
+            full_name="google.firestore.v1beta1.RunQueryResponse.skipped_results",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2757,
+    serialized_end=2922,
+)
+
+
+_WRITEREQUEST_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.firestore.v1beta1.WriteRequest.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1beta1.WriteRequest.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1beta1.WriteRequest.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3117,
+    serialized_end=3162,
+)
+
+_WRITEREQUEST = _descriptor.Descriptor(
+    name="WriteRequest",
+    full_name="google.firestore.v1beta1.WriteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1beta1.WriteRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_id",
+            full_name="google.firestore.v1beta1.WriteRequest.stream_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="writes",
+            full_name="google.firestore.v1beta1.WriteRequest.writes",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_token",
+            full_name="google.firestore.v1beta1.WriteRequest.stream_token",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.firestore.v1beta1.WriteRequest.labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WRITEREQUEST_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2925,
+    serialized_end=3162,
+)
+
+
+_WRITERESPONSE = _descriptor.Descriptor(
+    name="WriteResponse",
+    full_name="google.firestore.v1beta1.WriteResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stream_id",
+            full_name="google.firestore.v1beta1.WriteResponse.stream_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_token",
+            full_name="google.firestore.v1beta1.WriteResponse.stream_token",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="write_results",
+            full_name="google.firestore.v1beta1.WriteResponse.write_results",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commit_time",
+            full_name="google.firestore.v1beta1.WriteResponse.commit_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3165,
+    serialized_end=3332,
+)
+
+
+_LISTENREQUEST_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.firestore.v1beta1.ListenRequest.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.firestore.v1beta1.ListenRequest.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1beta1.ListenRequest.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3117,
+    serialized_end=3162,
+)
+
+_LISTENREQUEST = _descriptor.Descriptor(
+    name="ListenRequest",
+    full_name="google.firestore.v1beta1.ListenRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.firestore.v1beta1.ListenRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="add_target",
+            full_name="google.firestore.v1beta1.ListenRequest.add_target",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remove_target",
+            full_name="google.firestore.v1beta1.ListenRequest.remove_target",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.firestore.v1beta1.ListenRequest.labels",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LISTENREQUEST_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target_change",
+            full_name="google.firestore.v1beta1.ListenRequest.target_change",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3335,
+    serialized_end=3582,
+)
+
+
+_LISTENRESPONSE = _descriptor.Descriptor(
+    name="ListenResponse",
+    full_name="google.firestore.v1beta1.ListenResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_change",
+            full_name="google.firestore.v1beta1.ListenResponse.target_change",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_change",
+            full_name="google.firestore.v1beta1.ListenResponse.document_change",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_delete",
+            full_name="google.firestore.v1beta1.ListenResponse.document_delete",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_remove",
+            full_name="google.firestore.v1beta1.ListenResponse.document_remove",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.firestore.v1beta1.ListenResponse.filter",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="response_type",
+            full_name="google.firestore.v1beta1.ListenResponse.response_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3585,
+    serialized_end=3951,
+)
+
+
+_TARGET_DOCUMENTSTARGET = _descriptor.Descriptor(
+    name="DocumentsTarget",
+    full_name="google.firestore.v1beta1.Target.DocumentsTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1beta1.Target.DocumentsTarget.documents",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4204,
+    serialized_end=4240,
+)
+
+_TARGET_QUERYTARGET = _descriptor.Descriptor(
+    name="QueryTarget",
+    full_name="google.firestore.v1beta1.Target.QueryTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1beta1.Target.QueryTarget.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_query",
+            full_name="google.firestore.v1beta1.Target.QueryTarget.structured_query",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="query_type",
+            full_name="google.firestore.v1beta1.Target.QueryTarget.query_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=4242,
+    serialized_end=4356,
+)
+
+_TARGET = _descriptor.Descriptor(
+    name="Target",
+    full_name="google.firestore.v1beta1.Target",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.firestore.v1beta1.Target.query",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="documents",
+            full_name="google.firestore.v1beta1.Target.documents",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.firestore.v1beta1.Target.resume_token",
+            index=2,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.Target.read_time",
+            index=3,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_id",
+            full_name="google.firestore.v1beta1.Target.target_id",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="once",
+            full_name="google.firestore.v1beta1.Target.once",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TARGET_DOCUMENTSTARGET, _TARGET_QUERYTARGET],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target_type",
+            full_name="google.firestore.v1beta1.Target.target_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="resume_type",
+            full_name="google.firestore.v1beta1.Target.resume_type",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=3954,
+    serialized_end=4386,
+)
+
+
+_TARGETCHANGE = _descriptor.Descriptor(
+    name="TargetChange",
+    full_name="google.firestore.v1beta1.TargetChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_change_type",
+            full_name="google.firestore.v1beta1.TargetChange.target_change_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_ids",
+            full_name="google.firestore.v1beta1.TargetChange.target_ids",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cause",
+            full_name="google.firestore.v1beta1.TargetChange.cause",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.firestore.v1beta1.TargetChange.resume_token",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.TargetChange.read_time",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TARGETCHANGE_TARGETCHANGETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4389,
+    serialized_end=4692,
+)
+
+
+_LISTCOLLECTIONIDSREQUEST = _descriptor.Descriptor(
+    name="ListCollectionIdsRequest",
+    full_name="google.firestore.v1beta1.ListCollectionIdsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.firestore.v1beta1.ListCollectionIdsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.firestore.v1beta1.ListCollectionIdsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.firestore.v1beta1.ListCollectionIdsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4694,
+    serialized_end=4775,
+)
+
+
+_LISTCOLLECTIONIDSRESPONSE = _descriptor.Descriptor(
+    name="ListCollectionIdsResponse",
+    full_name="google.firestore.v1beta1.ListCollectionIdsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="collection_ids",
+            full_name="google.firestore.v1beta1.ListCollectionIdsResponse.collection_ids",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.firestore.v1beta1.ListCollectionIdsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4777,
+    serialized_end=4853,
+)
+
+_GETDOCUMENTREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_GETDOCUMENTREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _GETDOCUMENTREQUEST.fields_by_name["transaction"]
+)
+_GETDOCUMENTREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"]
+_GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _GETDOCUMENTREQUEST.fields_by_name["read_time"]
+)
+_GETDOCUMENTREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _GETDOCUMENTREQUEST.oneofs_by_name["consistency_selector"]
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _LISTDOCUMENTSREQUEST.fields_by_name["transaction"]
+)
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _LISTDOCUMENTSREQUEST.fields_by_name["read_time"]
+)
+_LISTDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _LISTDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_LISTDOCUMENTSRESPONSE.fields_by_name[
+    "documents"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_CREATEDOCUMENTREQUEST.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_CREATEDOCUMENTREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_UPDATEDOCUMENTREQUEST.fields_by_name[
+    "current_document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_DELETEDOCUMENTREQUEST.fields_by_name[
+    "current_document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "new_transaction"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._TRANSACTIONOPTIONS
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _BATCHGETDOCUMENTSREQUEST.fields_by_name["transaction"]
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _BATCHGETDOCUMENTSREQUEST.fields_by_name["new_transaction"]
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "new_transaction"
+].containing_oneof = _BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _BATCHGETDOCUMENTSREQUEST.fields_by_name["read_time"]
+)
+_BATCHGETDOCUMENTSREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _BATCHGETDOCUMENTSREQUEST.oneofs_by_name["consistency_selector"]
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "found"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"].fields.append(
+    _BATCHGETDOCUMENTSRESPONSE.fields_by_name["found"]
+)
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "found"
+].containing_oneof = _BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"]
+_BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"].fields.append(
+    _BATCHGETDOCUMENTSRESPONSE.fields_by_name["missing"]
+)
+_BATCHGETDOCUMENTSRESPONSE.fields_by_name[
+    "missing"
+].containing_oneof = _BATCHGETDOCUMENTSRESPONSE.oneofs_by_name["result"]
+_BEGINTRANSACTIONREQUEST.fields_by_name[
+    "options"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._TRANSACTIONOPTIONS
+)
+_COMMITREQUEST.fields_by_name[
+    "writes"
+].message_type = google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._WRITE
+_COMMITRESPONSE.fields_by_name[
+    "write_results"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._WRITERESULT
+)
+_COMMITRESPONSE.fields_by_name[
+    "commit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_RUNQUERYREQUEST.fields_by_name[
+    "structured_query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "new_transaction"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._TRANSACTIONOPTIONS
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_RUNQUERYREQUEST.oneofs_by_name["query_type"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["structured_query"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "structured_query"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["query_type"]
+_RUNQUERYREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["transaction"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "transaction"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["consistency_selector"]
+_RUNQUERYREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["new_transaction"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "new_transaction"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["consistency_selector"]
+_RUNQUERYREQUEST.oneofs_by_name["consistency_selector"].fields.append(
+    _RUNQUERYREQUEST.fields_by_name["read_time"]
+)
+_RUNQUERYREQUEST.fields_by_name[
+    "read_time"
+].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name["consistency_selector"]
+_RUNQUERYRESPONSE.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_RUNQUERYRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WRITEREQUEST_LABELSENTRY.containing_type = _WRITEREQUEST
+_WRITEREQUEST.fields_by_name[
+    "writes"
+].message_type = google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._WRITE
+_WRITEREQUEST.fields_by_name["labels"].message_type = _WRITEREQUEST_LABELSENTRY
+_WRITERESPONSE.fields_by_name[
+    "write_results"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._WRITERESULT
+)
+_WRITERESPONSE.fields_by_name[
+    "commit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTENREQUEST_LABELSENTRY.containing_type = _LISTENREQUEST
+_LISTENREQUEST.fields_by_name["add_target"].message_type = _TARGET
+_LISTENREQUEST.fields_by_name["labels"].message_type = _LISTENREQUEST_LABELSENTRY
+_LISTENREQUEST.oneofs_by_name["target_change"].fields.append(
+    _LISTENREQUEST.fields_by_name["add_target"]
+)
+_LISTENREQUEST.fields_by_name[
+    "add_target"
+].containing_oneof = _LISTENREQUEST.oneofs_by_name["target_change"]
+_LISTENREQUEST.oneofs_by_name["target_change"].fields.append(
+    _LISTENREQUEST.fields_by_name["remove_target"]
+)
+_LISTENREQUEST.fields_by_name[
+    "remove_target"
+].containing_oneof = _LISTENREQUEST.oneofs_by_name["target_change"]
+_LISTENRESPONSE.fields_by_name["target_change"].message_type = _TARGETCHANGE
+_LISTENRESPONSE.fields_by_name[
+    "document_change"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._DOCUMENTCHANGE
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_delete"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._DOCUMENTDELETE
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_remove"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._DOCUMENTREMOVE
+)
+_LISTENRESPONSE.fields_by_name[
+    "filter"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_write__pb2._EXISTENCEFILTER
+)
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["target_change"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "target_change"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["document_change"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_change"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["document_delete"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_delete"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["document_remove"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "document_remove"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_LISTENRESPONSE.oneofs_by_name["response_type"].fields.append(
+    _LISTENRESPONSE.fields_by_name["filter"]
+)
+_LISTENRESPONSE.fields_by_name[
+    "filter"
+].containing_oneof = _LISTENRESPONSE.oneofs_by_name["response_type"]
+_TARGET_DOCUMENTSTARGET.containing_type = _TARGET
+_TARGET_QUERYTARGET.fields_by_name[
+    "structured_query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_TARGET_QUERYTARGET.containing_type = _TARGET
+_TARGET_QUERYTARGET.oneofs_by_name["query_type"].fields.append(
+    _TARGET_QUERYTARGET.fields_by_name["structured_query"]
+)
+_TARGET_QUERYTARGET.fields_by_name[
+    "structured_query"
+].containing_oneof = _TARGET_QUERYTARGET.oneofs_by_name["query_type"]
+_TARGET.fields_by_name["query"].message_type = _TARGET_QUERYTARGET
+_TARGET.fields_by_name["documents"].message_type = _TARGET_DOCUMENTSTARGET
+_TARGET.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TARGET.oneofs_by_name["target_type"].fields.append(_TARGET.fields_by_name["query"])
+_TARGET.fields_by_name["query"].containing_oneof = _TARGET.oneofs_by_name["target_type"]
+_TARGET.oneofs_by_name["target_type"].fields.append(_TARGET.fields_by_name["documents"])
+_TARGET.fields_by_name["documents"].containing_oneof = _TARGET.oneofs_by_name[
+    "target_type"
+]
+_TARGET.oneofs_by_name["resume_type"].fields.append(
+    _TARGET.fields_by_name["resume_token"]
+)
+_TARGET.fields_by_name["resume_token"].containing_oneof = _TARGET.oneofs_by_name[
+    "resume_type"
+]
+_TARGET.oneofs_by_name["resume_type"].fields.append(_TARGET.fields_by_name["read_time"])
+_TARGET.fields_by_name["read_time"].containing_oneof = _TARGET.oneofs_by_name[
+    "resume_type"
+]
+_TARGETCHANGE.fields_by_name[
+    "target_change_type"
+].enum_type = _TARGETCHANGE_TARGETCHANGETYPE
+_TARGETCHANGE.fields_by_name[
+    "cause"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_TARGETCHANGE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TARGETCHANGE_TARGETCHANGETYPE.containing_type = _TARGETCHANGE
+DESCRIPTOR.message_types_by_name["GetDocumentRequest"] = _GETDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["ListDocumentsRequest"] = _LISTDOCUMENTSREQUEST
+DESCRIPTOR.message_types_by_name["ListDocumentsResponse"] = _LISTDOCUMENTSRESPONSE
+DESCRIPTOR.message_types_by_name["CreateDocumentRequest"] = _CREATEDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateDocumentRequest"] = _UPDATEDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteDocumentRequest"] = _DELETEDOCUMENTREQUEST
+DESCRIPTOR.message_types_by_name["BatchGetDocumentsRequest"] = _BATCHGETDOCUMENTSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchGetDocumentsResponse"
+] = _BATCHGETDOCUMENTSRESPONSE
+DESCRIPTOR.message_types_by_name["BeginTransactionRequest"] = _BEGINTRANSACTIONREQUEST
+DESCRIPTOR.message_types_by_name["BeginTransactionResponse"] = _BEGINTRANSACTIONRESPONSE
+DESCRIPTOR.message_types_by_name["CommitRequest"] = _COMMITREQUEST
+DESCRIPTOR.message_types_by_name["CommitResponse"] = _COMMITRESPONSE
+DESCRIPTOR.message_types_by_name["RollbackRequest"] = _ROLLBACKREQUEST
+DESCRIPTOR.message_types_by_name["RunQueryRequest"] = _RUNQUERYREQUEST
+DESCRIPTOR.message_types_by_name["RunQueryResponse"] = _RUNQUERYRESPONSE
+DESCRIPTOR.message_types_by_name["WriteRequest"] = _WRITEREQUEST
+DESCRIPTOR.message_types_by_name["WriteResponse"] = _WRITERESPONSE
+DESCRIPTOR.message_types_by_name["ListenRequest"] = _LISTENREQUEST
+DESCRIPTOR.message_types_by_name["ListenResponse"] = _LISTENRESPONSE
+DESCRIPTOR.message_types_by_name["Target"] = _TARGET
+DESCRIPTOR.message_types_by_name["TargetChange"] = _TARGETCHANGE
+DESCRIPTOR.message_types_by_name["ListCollectionIdsRequest"] = _LISTCOLLECTIONIDSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListCollectionIdsResponse"
+] = _LISTCOLLECTIONIDSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+GetDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.GetDocument][google.firestore.v1beta1.Firestore.GetDocument].
+  
+  
+  Attributes:
+      name:
+          The resource name of the Document to get. In the format: ``pro
+          jects/{project_id}/databases/{database_id}/documents/{document
+          _path}``.
+      mask:
+          The fields to return. If not set, returns all fields.  If the
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads the document in a transaction.
+      read_time:
+          Reads the version of the document at the given time. This may
+          not be older than 60 seconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.GetDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDocumentRequest)
+
+ListDocumentsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDocumentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDOCUMENTSREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.ListDocuments][google.firestore.v1beta1.Firestore.ListDocuments].
+  
+  
+  Attributes:
+      parent:
+          The parent resource name. In the format:
+          ``projects/{project_id}/databases/{database_id}/documents`` or
+          ``projects/{project_id}/databases/{database_id}/documents/{doc
+          ument_path}``. For example: ``projects/my-
+          project/databases/my-database/documents`` or ``projects/my-
+          project/databases/my-database/documents/chatrooms/my-
+          chatroom``
+      collection_id:
+          The collection ID, relative to ``parent``, to list. For
+          example: ``chatrooms`` or ``messages``.
+      page_size:
+          The maximum number of documents to return.
+      page_token:
+          The ``next_page_token`` value returned from a previous List
+          request, if any.
+      order_by:
+          The order to sort results by. For example: ``priority desc,
+          name``.
+      mask:
+          The fields to return. If not set, returns all fields.  If a
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads documents in a transaction.
+      read_time:
+          Reads documents as they were at the given time. This may not
+          be older than 60 seconds.
+      show_missing:
+          If the list should show missing documents. A missing document
+          is a document that does not exist but has sub-documents. These
+          documents will be returned with a key but will not have
+          fields, [Document.create\_time][google.firestore.v1beta1.Docum
+          ent.create\_time], or [Document.update\_time][google.firestore
+          .v1beta1.Document.update\_time] set.  Requests with
+          ``show_missing`` may not specify ``where`` or ``order_by``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListDocumentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDocumentsRequest)
+
+ListDocumentsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDocumentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDOCUMENTSRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.ListDocuments][google.firestore.v1beta1.Firestore.ListDocuments].
+  
+  
+  Attributes:
+      documents:
+          The Documents found.
+      next_page_token:
+          The next page token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListDocumentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDocumentsResponse)
+
+CreateDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.CreateDocument][google.firestore.v1beta1.Firestore.CreateDocument].
+  
+  
+  Attributes:
+      parent:
+          The parent resource. For example:
+          ``projects/{project_id}/databases/{database_id}/documents`` or
+          ``projects/{project_id}/databases/{database_id}/documents/chat
+          rooms/{chatroom_id}``
+      collection_id:
+          The collection ID, relative to ``parent``, to list. For
+          example: ``chatrooms``.
+      document_id:
+          The client-assigned document ID to use for this document.
+          Optional. If not specified, an ID will be assigned by the
+          service.
+      document:
+          The document to create. ``name`` must not be set.
+      mask:
+          The fields to return. If not set, returns all fields.  If the
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.CreateDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDocumentRequest)
+
+UpdateDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.UpdateDocument][google.firestore.v1beta1.Firestore.UpdateDocument].
+  
+  
+  Attributes:
+      document:
+          The updated document. Creates the document if it does not
+          already exist.
+      update_mask:
+          The fields to update. None of the field paths in the mask may
+          contain a reserved name.  If the document exists on the server
+          and has fields not referenced in the mask, they are left
+          unchanged. Fields referenced in the mask, but not present in
+          the input document, are deleted from the document on the
+          server.
+      mask:
+          The fields to return. If not set, returns all fields.  If the
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      current_document:
+          An optional precondition on the document. The request will
+          fail if this is set and not met by the target document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.UpdateDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDocumentRequest)
+
+DeleteDocumentRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDocumentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDOCUMENTREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.DeleteDocument][google.firestore.v1beta1.Firestore.DeleteDocument].
+  
+  
+  Attributes:
+      name:
+          The resource name of the Document to delete. In the format: ``
+          projects/{project_id}/databases/{database_id}/documents/{docum
+          ent_path}``.
+      current_document:
+          An optional precondition on the document. The request will
+          fail if this is set and not met by the target document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DeleteDocumentRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDocumentRequest)
+
+BatchGetDocumentsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchGetDocumentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETDOCUMENTSREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.BatchGetDocuments][google.firestore.v1beta1.Firestore.BatchGetDocuments].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      documents:
+          The names of the documents to retrieve. In the format: ``proje
+          cts/{project_id}/databases/{database_id}/documents/{document_p
+          ath}``. The request will fail if any of the document is not a
+          child resource of the given ``database``. Duplicate names will
+          be elided.
+      mask:
+          The fields to return. If not set, returns all fields.  If a
+          document has a field that is not present in this mask, that
+          field will not be returned in the response.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads documents in a transaction.
+      new_transaction:
+          Starts a new transaction and reads the documents. Defaults to
+          a read-only transaction. The new transaction ID will be
+          returned as the first response in the stream.
+      read_time:
+          Reads documents as they were at the given time. This may not
+          be older than 60 seconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.BatchGetDocumentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetDocumentsRequest)
+
+BatchGetDocumentsResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchGetDocumentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHGETDOCUMENTSRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The streamed response for
+  [Firestore.BatchGetDocuments][google.firestore.v1beta1.Firestore.BatchGetDocuments].
+  
+  
+  Attributes:
+      result:
+          A single result. This can be empty if the server is just
+          returning a transaction.
+      found:
+          A document that was requested.
+      missing:
+          A document name that was requested but does not exist. In the
+          format: ``projects/{project_id}/databases/{database_id}/docume
+          nts/{document_path}``.
+      transaction:
+          The transaction that was started as part of this request. Will
+          only be set in the first response, and only if [BatchGetDocume
+          ntsRequest.new\_transaction][google.firestore.v1beta1.BatchGet
+          DocumentsRequest.new\_transaction] was set in the request.
+      read_time:
+          The time at which the document was read. This may be
+          monotically increasing, in this case the previous documents in
+          the result stream are guaranteed not to have changed between
+          their read\_time and this one.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.BatchGetDocumentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchGetDocumentsResponse)
+
+BeginTransactionRequest = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.BeginTransaction][google.firestore.v1beta1.Firestore.BeginTransaction].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      options:
+          The options for the transaction. Defaults to a read-write
+          transaction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.BeginTransactionRequest)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionRequest)
+
+BeginTransactionResponse = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.BeginTransaction][google.firestore.v1beta1.Firestore.BeginTransaction].
+  
+  
+  Attributes:
+      transaction:
+          The transaction that was started.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.BeginTransactionResponse)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionResponse)
+
+CommitRequest = _reflection.GeneratedProtocolMessageType(
+    "CommitRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.Commit][google.firestore.v1beta1.Firestore.Commit].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      writes:
+          The writes to apply.  Always executed atomically and in order.
+      transaction:
+          If set, applies all writes in this transaction, and commits
+          it.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.CommitRequest)
+    ),
+)
+_sym_db.RegisterMessage(CommitRequest)
+
+CommitResponse = _reflection.GeneratedProtocolMessageType(
+    "CommitResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.Commit][google.firestore.v1beta1.Firestore.Commit].
+  
+  
+  Attributes:
+      write_results:
+          The result of applying the writes.  This i-th write result
+          corresponds to the i-th write in the request.
+      commit_time:
+          The time at which the commit occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.CommitResponse)
+    ),
+)
+_sym_db.RegisterMessage(CommitResponse)
+
+RollbackRequest = _reflection.GeneratedProtocolMessageType(
+    "RollbackRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.Rollback][google.firestore.v1beta1.Firestore.Rollback].
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      transaction:
+          The transaction to roll back.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.RollbackRequest)
+    ),
+)
+_sym_db.RegisterMessage(RollbackRequest)
+
+RunQueryRequest = _reflection.GeneratedProtocolMessageType(
+    "RunQueryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNQUERYREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.RunQuery][google.firestore.v1beta1.Firestore.RunQuery].
+  
+  
+  Attributes:
+      parent:
+          The parent resource name. In the format:
+          ``projects/{project_id}/databases/{database_id}/documents`` or
+          ``projects/{project_id}/databases/{database_id}/documents/{doc
+          ument_path}``. For example: ``projects/my-
+          project/databases/my-database/documents`` or ``projects/my-
+          project/databases/my-database/documents/chatrooms/my-
+          chatroom``
+      query_type:
+          The query to run.
+      structured_query:
+          A structured query.
+      consistency_selector:
+          The consistency mode for this transaction. If not set,
+          defaults to strong consistency.
+      transaction:
+          Reads documents in a transaction.
+      new_transaction:
+          Starts a new transaction and reads the documents. Defaults to
+          a read-only transaction. The new transaction ID will be
+          returned as the first response in the stream.
+      read_time:
+          Reads documents as they were at the given time. This may not
+          be older than 60 seconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.RunQueryRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunQueryRequest)
+
+RunQueryResponse = _reflection.GeneratedProtocolMessageType(
+    "RunQueryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNQUERYRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.RunQuery][google.firestore.v1beta1.Firestore.RunQuery].
+  
+  
+  Attributes:
+      transaction:
+          The transaction that was started as part of this request. Can
+          only be set in the first response, and only if [RunQueryReques
+          t.new\_transaction][google.firestore.v1beta1.RunQueryRequest.n
+          ew\_transaction] was set in the request. If set, no other
+          fields will be set in this response.
+      document:
+          A query result. Not set when reporting partial progress.
+      read_time:
+          The time at which the document was read. This may be
+          monotonically increasing; in this case, the previous documents
+          in the result stream are guaranteed not to have changed
+          between their ``read_time`` and this one.  If the query
+          returns no results, a response with ``read_time`` and no
+          ``document`` will be sent, and this represents the time at
+          which the query was run.
+      skipped_results:
+          The number of results that have been skipped due to an offset
+          between the last response and the current response.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.RunQueryResponse)
+    ),
+)
+_sym_db.RegisterMessage(RunQueryResponse)
+
+WriteRequest = _reflection.GeneratedProtocolMessageType(
+    "WriteRequest",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WRITEREQUEST_LABELSENTRY,
+                __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.WriteRequest.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_WRITEREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.Write][google.firestore.v1beta1.Firestore.Write].
+  
+  The first request creates a stream, or resumes an existing one from a
+  token.
+  
+  When creating a new stream, the server replies with a response
+  containing only an ID and a token, to use in the next request.
+  
+  When resuming a stream, the server first streams any responses later
+  than the given token, then a response containing only an up-to-date
+  token, to use in the next request.
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``. This is
+          only required in the first message.
+      stream_id:
+          The ID of the write stream to resume. This may only be set in
+          the first message. When left empty, a new write stream will be
+          created.
+      writes:
+          The writes to apply.  Always executed atomically and in order.
+          This must be empty on the first request. This may be empty on
+          the last request. This must not be empty on all other
+          requests.
+      stream_token:
+          A stream token that was previously sent by the server.  The
+          client should set this field to the token from the most recent
+          [WriteResponse][google.firestore.v1beta1.WriteResponse] it has
+          received. This acknowledges that the client has received
+          responses up to this token. After sending this token, earlier
+          tokens may not be used anymore.  The server may close the
+          stream if there are too many unacknowledged responses.  Leave
+          this field unset when creating a new stream. To resume a
+          stream at a specific point, set this field and the
+          ``stream_id`` field.  Leave this field unset when creating a
+          new stream.
+      labels:
+          Labels associated with this write request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.WriteRequest)
+    ),
+)
+_sym_db.RegisterMessage(WriteRequest)
+_sym_db.RegisterMessage(WriteRequest.LabelsEntry)
+
+WriteResponse = _reflection.GeneratedProtocolMessageType(
+    "WriteResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITERESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.Write][google.firestore.v1beta1.Firestore.Write].
+  
+  
+  Attributes:
+      stream_id:
+          The ID of the stream. Only set on the first message, when a
+          new stream was created.
+      stream_token:
+          A token that represents the position of this response in the
+          stream. This can be used by a client to resume the stream at
+          this point.  This field is always set.
+      write_results:
+          The result of applying the writes.  This i-th write result
+          corresponds to the i-th write in the request.
+      commit_time:
+          The time at which the commit occurred.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.WriteResponse)
+    ),
+)
+_sym_db.RegisterMessage(WriteResponse)
+
+ListenRequest = _reflection.GeneratedProtocolMessageType(
+    "ListenRequest",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LISTENREQUEST_LABELSENTRY,
+                __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2"
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListenRequest.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_LISTENREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""A request for
+  [Firestore.Listen][google.firestore.v1beta1.Firestore.Listen]
+  
+  
+  Attributes:
+      database:
+          The database name. In the format:
+          ``projects/{project_id}/databases/{database_id}``.
+      target_change:
+          The supported target changes.
+      add_target:
+          A target to add to this stream.
+      remove_target:
+          The ID of a target to remove from this stream.
+      labels:
+          Labels associated with this target change.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListenRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListenRequest)
+_sym_db.RegisterMessage(ListenRequest.LabelsEntry)
+
+ListenResponse = _reflection.GeneratedProtocolMessageType(
+    "ListenResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTENRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response for
+  [Firestore.Listen][google.firestore.v1beta1.Firestore.Listen].
+  
+  
+  Attributes:
+      response_type:
+          The supported responses.
+      target_change:
+          Targets have changed.
+      document_change:
+          A [Document][google.firestore.v1beta1.Document] has changed.
+      document_delete:
+          A [Document][google.firestore.v1beta1.Document] has been
+          deleted.
+      document_remove:
+          A [Document][google.firestore.v1beta1.Document] has been
+          removed from a target (because it is no longer relevant to
+          that target).
+      filter:
+          A filter to apply to the set of documents previously returned
+          for the given target.  Returned when documents may have been
+          removed from the given target, but the exact documents are
+          unknown.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListenResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListenResponse)
+
+Target = _reflection.GeneratedProtocolMessageType(
+    "Target",
+    (_message.Message,),
+    dict(
+        DocumentsTarget=_reflection.GeneratedProtocolMessageType(
+            "DocumentsTarget",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TARGET_DOCUMENTSTARGET,
+                __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+                __doc__="""A target specified by a set of documents names.
+    
+    
+    Attributes:
+        documents:
+            The names of the documents to retrieve. In the format: ``proje
+            cts/{project_id}/databases/{database_id}/documents/{document_p
+            ath}``. The request will fail if any of the document is not a
+            child resource of the given ``database``. Duplicate names will
+            be elided.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Target.DocumentsTarget)
+            ),
+        ),
+        QueryTarget=_reflection.GeneratedProtocolMessageType(
+            "QueryTarget",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TARGET_QUERYTARGET,
+                __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+                __doc__="""A target specified by a query.
+    
+    
+    Attributes:
+        parent:
+            The parent resource name. In the format:
+            ``projects/{project_id}/databases/{database_id}/documents`` or
+            ``projects/{project_id}/databases/{database_id}/documents/{doc
+            ument_path}``. For example: ``projects/my-
+            project/databases/my-database/documents`` or ``projects/my-
+            project/databases/my-database/documents/chatrooms/my-
+            chatroom``
+        query_type:
+            The query to run.
+        structured_query:
+            A structured query.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Target.QueryTarget)
+            ),
+        ),
+        DESCRIPTOR=_TARGET,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""A specification of a set of documents to listen to.
+  
+  
+  Attributes:
+      target_type:
+          The type of target to listen to.
+      query:
+          A target specified by a query.
+      documents:
+          A target specified by a set of document names.
+      resume_type:
+          When to start listening.  If not specified, all matching
+          Documents are returned before any subsequent changes.
+      resume_token:
+          A resume token from a prior
+          [TargetChange][google.firestore.v1beta1.TargetChange] for an
+          identical target.  Using a resume token with a different
+          target is unsupported and may fail.
+      read_time:
+          Start listening after a specific ``read_time``.  The client
+          must know the state of matching documents at this time.
+      target_id:
+          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.
+      once:
+          If the target should be removed once it is current and
+          consistent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Target)
+    ),
+)
+_sym_db.RegisterMessage(Target)
+_sym_db.RegisterMessage(Target.DocumentsTarget)
+_sym_db.RegisterMessage(Target.QueryTarget)
+
+TargetChange = _reflection.GeneratedProtocolMessageType(
+    "TargetChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TARGETCHANGE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""Targets being watched have changed.
+  
+  
+  Attributes:
+      target_change_type:
+          The type of change that occurred.
+      target_ids:
+          The target IDs of targets that have changed.  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.
+      cause:
+          The error that resulted in this change, if applicable.
+      resume_token:
+          A token that can be used to resume the stream for the given
+          ``target_ids``, or all targets if ``target_ids`` is empty.
+          Not set on every target change.
+      read_time:
+          The consistent ``read_time`` for the given ``target_ids``
+          (omitted when the target\_ids are not at a consistent
+          snapshot).  The stream is guaranteed to send a ``read_time``
+          with ``target_ids`` empty whenever the entire stream reaches a
+          new consistent snapshot. ADD, CURRENT, and RESET messages are
+          guaranteed to (eventually) result in a new consistent snapshot
+          (while NO\_CHANGE and REMOVE messages are not).  For a given
+          stream, ``read_time`` is guaranteed to be monotonically
+          increasing.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.TargetChange)
+    ),
+)
+_sym_db.RegisterMessage(TargetChange)
+
+ListCollectionIdsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCollectionIdsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOLLECTIONIDSREQUEST,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The request for
+  [Firestore.ListCollectionIds][google.firestore.v1beta1.Firestore.ListCollectionIds].
+  
+  
+  Attributes:
+      parent:
+          The parent document. In the format: ``projects/{project_id}/da
+          tabases/{database_id}/documents/{document_path}``. For
+          example: ``projects/my-project/databases/my-
+          database/documents/chatrooms/my-chatroom``
+      page_size:
+          The maximum number of results to return.
+      page_token:
+          A page token. Must be a value from [ListCollectionIdsResponse]
+          [google.firestore.v1beta1.ListCollectionIdsResponse].
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListCollectionIdsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCollectionIdsRequest)
+
+ListCollectionIdsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCollectionIdsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOLLECTIONIDSRESPONSE,
+        __module__="google.cloud.firestore_v1beta1.proto.firestore_pb2",
+        __doc__="""The response from
+  [Firestore.ListCollectionIds][google.firestore.v1beta1.Firestore.ListCollectionIds].
+  
+  
+  Attributes:
+      collection_ids:
+          The collection ids.
+      next_page_token:
+          A page token that may be used to continue the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ListCollectionIdsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCollectionIdsResponse)
+
+
+DESCRIPTOR._options = None
+_WRITEREQUEST_LABELSENTRY._options = None
+_LISTENREQUEST_LABELSENTRY._options = None
+
+_FIRESTORE = _descriptor.ServiceDescriptor(
+    name="Firestore",
+    full_name="google.firestore.v1beta1.Firestore",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4856,
+    serialized_end=7360,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GetDocument",
+            full_name="google.firestore.v1beta1.Firestore.GetDocument",
+            index=0,
+            containing_service=None,
+            input_type=_GETDOCUMENTREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT,
+            serialized_options=_b(
+                "\202\323\344\223\0027\0225/v1beta1/{name=projects/*/databases/*/documents/*/**}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDocuments",
+            full_name="google.firestore.v1beta1.Firestore.ListDocuments",
+            index=1,
+            containing_service=None,
+            input_type=_LISTDOCUMENTSREQUEST,
+            output_type=_LISTDOCUMENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002I\022G/v1beta1/{parent=projects/*/databases/*/documents/*/**}/{collection_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDocument",
+            full_name="google.firestore.v1beta1.Firestore.CreateDocument",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEDOCUMENTREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002Q"E/v1beta1/{parent=projects/*/databases/*/documents/**}/{collection_id}:\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDocument",
+            full_name="google.firestore.v1beta1.Firestore.UpdateDocument",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEDOCUMENTREQUEST,
+            output_type=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT,
+            serialized_options=_b(
+                "\202\323\344\223\002J2>/v1beta1/{document.name=projects/*/databases/*/documents/*/**}:\010document"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDocument",
+            full_name="google.firestore.v1beta1.Firestore.DeleteDocument",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEDOCUMENTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0027*5/v1beta1/{name=projects/*/databases/*/documents/*/**}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchGetDocuments",
+            full_name="google.firestore.v1beta1.Firestore.BatchGetDocuments",
+            index=5,
+            containing_service=None,
+            input_type=_BATCHGETDOCUMENTSREQUEST,
+            output_type=_BATCHGETDOCUMENTSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v1beta1/{database=projects/*/databases/*}/documents:batchGet:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BeginTransaction",
+            full_name="google.firestore.v1beta1.Firestore.BeginTransaction",
+            index=6,
+            containing_service=None,
+            input_type=_BEGINTRANSACTIONREQUEST,
+            output_type=_BEGINTRANSACTIONRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002J"E/v1beta1/{database=projects/*/databases/*}/documents:beginTransaction:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Commit",
+            full_name="google.firestore.v1beta1.Firestore.Commit",
+            index=7,
+            containing_service=None,
+            input_type=_COMMITREQUEST,
+            output_type=_COMMITRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v1beta1/{database=projects/*/databases/*}/documents:commit:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Rollback",
+            full_name="google.firestore.v1beta1.Firestore.Rollback",
+            index=8,
+            containing_service=None,
+            input_type=_ROLLBACKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v1beta1/{database=projects/*/databases/*}/documents:rollback:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunQuery",
+            full_name="google.firestore.v1beta1.Firestore.RunQuery",
+            index=9,
+            containing_service=None,
+            input_type=_RUNQUERYREQUEST,
+            output_type=_RUNQUERYRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\207\001";/v1beta1/{parent=projects/*/databases/*/documents}:runQuery:\001*ZE"@/v1beta1/{parent=projects/*/databases/*/documents/*/**}:runQuery:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Write",
+            full_name="google.firestore.v1beta1.Firestore.Write",
+            index=10,
+            containing_service=None,
+            input_type=_WRITEREQUEST,
+            output_type=_WRITERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v1beta1/{database=projects/*/databases/*}/documents:write:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Listen",
+            full_name="google.firestore.v1beta1.Firestore.Listen",
+            index=11,
+            containing_service=None,
+            input_type=_LISTENREQUEST,
+            output_type=_LISTENRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v1beta1/{database=projects/*/databases/*}/documents:listen:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCollectionIds",
+            full_name="google.firestore.v1beta1.Firestore.ListCollectionIds",
+            index=12,
+            containing_service=None,
+            input_type=_LISTCOLLECTIONIDSREQUEST,
+            output_type=_LISTCOLLECTIONIDSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\231\001"D/v1beta1/{parent=projects/*/databases/*/documents}:listCollectionIds:\001*ZN"I/v1beta1/{parent=projects/*/databases/*/documents/*/**}:listCollectionIds:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_FIRESTORE)
+
+DESCRIPTOR.services_by_name["Firestore"] = _FIRESTORE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/firestore_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/firestore_pb2_grpc.py
new file mode 100644
index 000000000000..e3bd63b73f35
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/firestore_pb2_grpc.py
@@ -0,0 +1,290 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.firestore_v1beta1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    firestore_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class FirestoreStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GetDocument = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/GetDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.GetDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.Document.FromString,
+        )
+        self.ListDocuments = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/ListDocuments",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListDocumentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListDocumentsResponse.FromString,
+        )
+        self.CreateDocument = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/CreateDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.CreateDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.Document.FromString,
+        )
+        self.UpdateDocument = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/UpdateDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.UpdateDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.Document.FromString,
+        )
+        self.DeleteDocument = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/DeleteDocument",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.DeleteDocumentRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.BatchGetDocuments = channel.unary_stream(
+            "/google.firestore.v1beta1.Firestore/BatchGetDocuments",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BatchGetDocumentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BatchGetDocumentsResponse.FromString,
+        )
+        self.BeginTransaction = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/BeginTransaction",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BeginTransactionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BeginTransactionResponse.FromString,
+        )
+        self.Commit = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/Commit",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.CommitRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.CommitResponse.FromString,
+        )
+        self.Rollback = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/Rollback",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.RollbackRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RunQuery = channel.unary_stream(
+            "/google.firestore.v1beta1.Firestore/RunQuery",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.RunQueryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.RunQueryResponse.FromString,
+        )
+        self.Write = channel.stream_stream(
+            "/google.firestore.v1beta1.Firestore/Write",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.WriteRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.WriteResponse.FromString,
+        )
+        self.Listen = channel.stream_stream(
+            "/google.firestore.v1beta1.Firestore/Listen",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListenRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListenResponse.FromString,
+        )
+        self.ListCollectionIds = channel.unary_unary(
+            "/google.firestore.v1beta1.Firestore/ListCollectionIds",
+            request_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListCollectionIdsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListCollectionIdsResponse.FromString,
+        )
+
+
+class FirestoreServicer(object):
+    """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.
+  """
+
+    def GetDocument(self, request, context):
+        """Gets a single document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDocuments(self, request, context):
+        """Lists documents.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDocument(self, request, context):
+        """Creates a new document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDocument(self, request, context):
+        """Updates or inserts a document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDocument(self, request, context):
+        """Deletes a document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchGetDocuments(self, request, context):
+        """Gets multiple documents.
+
+    Documents returned by this method are not guaranteed to be returned in the
+    same order that they were requested.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BeginTransaction(self, request, context):
+        """Starts a new transaction.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Commit(self, request, context):
+        """Commits a transaction, while optionally updating documents.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Rollback(self, request, context):
+        """Rolls back a transaction.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunQuery(self, request, context):
+        """Runs a query.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Write(self, request_iterator, context):
+        """Streams batches of document updates and deletes, in order.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Listen(self, request_iterator, context):
+        """Listens to changes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCollectionIds(self, request, context):
+        """Lists all the collection IDs underneath a document.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_FirestoreServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GetDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.GetDocumentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.Document.SerializeToString,
+        ),
+        "ListDocuments": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDocuments,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListDocumentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListDocumentsResponse.SerializeToString,
+        ),
+        "CreateDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.CreateDocumentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.Document.SerializeToString,
+        ),
+        "UpdateDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.UpdateDocumentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.Document.SerializeToString,
+        ),
+        "DeleteDocument": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDocument,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.DeleteDocumentRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "BatchGetDocuments": grpc.unary_stream_rpc_method_handler(
+            servicer.BatchGetDocuments,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BatchGetDocumentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BatchGetDocumentsResponse.SerializeToString,
+        ),
+        "BeginTransaction": grpc.unary_unary_rpc_method_handler(
+            servicer.BeginTransaction,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BeginTransactionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.BeginTransactionResponse.SerializeToString,
+        ),
+        "Commit": grpc.unary_unary_rpc_method_handler(
+            servicer.Commit,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.CommitRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.CommitResponse.SerializeToString,
+        ),
+        "Rollback": grpc.unary_unary_rpc_method_handler(
+            servicer.Rollback,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.RollbackRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RunQuery": grpc.unary_stream_rpc_method_handler(
+            servicer.RunQuery,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.RunQueryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.RunQueryResponse.SerializeToString,
+        ),
+        "Write": grpc.stream_stream_rpc_method_handler(
+            servicer.Write,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.WriteRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.WriteResponse.SerializeToString,
+        ),
+        "Listen": grpc.stream_stream_rpc_method_handler(
+            servicer.Listen,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListenRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListenResponse.SerializeToString,
+        ),
+        "ListCollectionIds": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCollectionIds,
+            request_deserializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListCollectionIdsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.ListCollectionIdsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.firestore.v1beta1.Firestore", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/index.proto b/firestore/google/cloud/firestore_v1beta1/proto/index.proto
new file mode 100644
index 000000000000..c5784e0eaab7
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/index.proto
@@ -0,0 +1,102 @@
+// 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.firestore.admin.v1beta1;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin";
+option java_multiple_files = true;
+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.
+  enum Mode {
+    // The mode is unspecified.
+    MODE_UNSPECIFIED = 0;
+
+    // The field's values are indexed so as to support sequencing in
+    // ascending order and also query by <, >, <=, >=, and =.
+    ASCENDING = 2;
+
+    // The field's values are indexed so as to support sequencing in
+    // descending order and also query by <, >, <=, >=, and =.
+    DESCENDING = 3;
+
+    // The field's array values are indexed so as to support membership using
+    // ARRAY_CONTAINS queries.
+    ARRAY_CONTAINS = 4;
+  }
+
+  // The path of the field. Must match the field path specification described
+  // by [google.firestore.v1beta1.Document.fields][fields].
+  // Special field path `__name__` may be used by itself or at the end of a
+  // path. `__type__` may be used only at the end of path.
+  string field_path = 1;
+
+  // The field's mode.
+  Mode mode = 2;
+}
+
+// An index definition.
+message Index {
+  // The state of an index. During index creation, an index will be in the
+  // `CREATING` state. If the index is created successfully, it will transition
+  // to the `READY` state. If the index is not able to be created, it will
+  // transition to the `ERROR` state.
+  enum State {
+    // The state is unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // The index is being created.
+    // There is an active long-running operation for the index.
+    // The index is updated when writing a document.
+    // Some index data may exist.
+    CREATING = 3;
+
+    // The index is ready to be used.
+    // The index is updated when writing a document.
+    // The index is fully populated from all stored documents it applies to.
+    READY = 2;
+
+    // The index was being created, but something went wrong.
+    // There is no active long-running operation for the index,
+    // and the most recently finished long-running operation failed.
+    // The index is not updated when writing a document.
+    // Some index data may exist.
+    ERROR = 5;
+  }
+
+  // The resource name of the index.
+  // Output only.
+  string name = 1;
+
+  // The collection ID to which this index applies. Required.
+  string collection_id = 2;
+
+  // The fields to index.
+  repeated IndexField fields = 3;
+
+  // The state of the index.
+  // Output only.
+  State state = 6;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/location.proto b/firestore/google/cloud/firestore_v1beta1/proto/location.proto
new file mode 100644
index 000000000000..db7e8544b709
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/location.proto
@@ -0,0 +1,34 @@
+// 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.firestore.admin.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/type/latlng.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin";
+option java_multiple_files = true;
+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/firestore/google/cloud/firestore_v1beta1/proto/operation.proto b/firestore/google/cloud/firestore_v1beta1/proto/operation.proto
new file mode 100644
index 000000000000..c2a1b001e6a8
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/operation.proto
@@ -0,0 +1,203 @@
+// 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.firestore.admin.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/firestore/admin/v1beta2/index.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta2";
+option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta2;admin";
+option java_multiple_files = true;
+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 {
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The index resource that this operation is acting on. For example:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
+  string index = 3;
+
+  // The state of the operation.
+  OperationState state = 4;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 5;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 6;
+}
+
+// Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
+// [FirestoreAdmin.UpdateField][google.firestore.admin.v1beta2.FirestoreAdmin.UpdateField].
+message FieldOperationMetadata {
+  // Information about an index configuration change.
+  message IndexConfigDelta {
+    // Specifies how the index is changing.
+    enum ChangeType {
+      // The type of change is not specified or known.
+      CHANGE_TYPE_UNSPECIFIED = 0;
+
+      // The single field index is being added.
+      ADD = 1;
+
+      // The single field index is being removed.
+      REMOVE = 2;
+    }
+
+    // Specifies how the index is changing.
+    ChangeType change_type = 1;
+
+    // The index being changed.
+    Index index = 2;
+  }
+
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The field resource that this operation is acting on. For example:
+  // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}`
+  string field = 3;
+
+  // A list of [IndexConfigDelta][google.firestore.admin.v1beta2.FieldOperationMetadata.IndexConfigDelta], which describe the intent of this
+  // operation.
+  repeated IndexConfigDelta index_config_deltas = 4;
+
+  // The state of the operation.
+  OperationState state = 5;
+
+  // The progress, in documents, of this operation.
+  Progress document_progress = 6;
+
+  // The progress, in bytes, of this operation.
+  Progress bytes_progress = 7;
+}
+
+// Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
+// [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1beta2.FirestoreAdmin.ExportDocuments].
+message ExportDocumentsMetadata {
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The state of the export operation.
+  OperationState operation_state = 3;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 4;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 5;
+
+  // Which collection ids are being exported.
+  repeated string collection_ids = 6;
+
+  // Where the entities are being exported to.
+  string output_uri_prefix = 7;
+}
+
+// Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
+// [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1beta2.FirestoreAdmin.ImportDocuments].
+message ImportDocumentsMetadata {
+  // The time this operation started.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time this operation completed. Will be unset if operation still in
+  // progress.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The state of the import operation.
+  OperationState operation_state = 3;
+
+  // The progress, in documents, of this operation.
+  Progress progress_documents = 4;
+
+  // The progress, in bytes, of this operation.
+  Progress progress_bytes = 5;
+
+  // Which collection ids are being imported.
+  repeated string collection_ids = 6;
+
+  // The location of the documents being imported.
+  string input_uri_prefix = 7;
+}
+
+// Returned in the [google.longrunning.Operation][google.longrunning.Operation] response field.
+message ExportDocumentsResponse {
+  // Location of the output files. This can be used to begin an import
+  // into Cloud Firestore (this project or another project) after the operation
+  // completes successfully.
+  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.v1beta2.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.
+  OPERATION_STATE_UNSPECIFIED = 0;
+
+  // Request is being prepared for processing.
+  INITIALIZING = 1;
+
+  // Request is actively being processed.
+  PROCESSING = 2;
+
+  // Request is in the process of being cancelled after user called
+  // google.longrunning.Operations.CancelOperation on the operation.
+  CANCELLING = 3;
+
+  // Request has been processed and is in its finalization stage.
+  FINALIZING = 4;
+
+  // Request has completed successfully.
+  SUCCESSFUL = 5;
+
+  // Request has finished being processed, but encountered an error.
+  FAILED = 6;
+
+  // Request has finished being cancelled after user called
+  // google.longrunning.Operations.CancelOperation.
+  CANCELLED = 7;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/query.proto b/firestore/google/cloud/firestore_v1beta1/proto/query.proto
new file mode 100644
index 000000000000..94eec9cbbf3f
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/query.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.firestore.v1beta1;
+
+import "google/firestore/v1beta1/document.proto";
+import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1beta1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "QueryProto";
+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`.
+  message CollectionSelector {
+    // The collection ID.
+    // When set, selects only collections with this ID.
+    string collection_id = 2;
+
+    // When false, selects only collections that are immediate children of
+    // the `parent` specified in the containing `RunQueryRequest`.
+    // When true, selects all descendant collections.
+    bool all_descendants = 3;
+  }
+
+  // A filter.
+  message Filter {
+    // The type of filter.
+    oneof filter_type {
+      // A composite filter.
+      CompositeFilter composite_filter = 1;
+
+      // A filter on a document field.
+      FieldFilter field_filter = 2;
+
+      // A filter that takes exactly one argument.
+      UnaryFilter unary_filter = 3;
+    }
+  }
+
+  // A filter that merges multiple other filters using the given operator.
+  message CompositeFilter {
+    // A composite filter operator.
+    enum Operator {
+      // Unspecified. This value must not be used.
+      OPERATOR_UNSPECIFIED = 0;
+
+      // The results are required to satisfy each of the combined filters.
+      AND = 1;
+    }
+
+    // The operator for combining multiple filters.
+    Operator op = 1;
+
+    // The list of filters to combine.
+    // Must contain at least one filter.
+    repeated Filter filters = 2;
+  }
+
+  // A filter on a specific field.
+  message FieldFilter {
+    // A field filter operator.
+    enum Operator {
+      // Unspecified. This value must not be used.
+      OPERATOR_UNSPECIFIED = 0;
+
+      // Less than. Requires that the field come first in `order_by`.
+      LESS_THAN = 1;
+
+      // Less than or equal. Requires that the field come first in `order_by`.
+      LESS_THAN_OR_EQUAL = 2;
+
+      // Greater than. Requires that the field come first in `order_by`.
+      GREATER_THAN = 3;
+
+      // Greater than or equal. Requires that the field come first in
+      // `order_by`.
+      GREATER_THAN_OR_EQUAL = 4;
+
+      // Equal.
+      EQUAL = 5;
+
+      // Contains. Requires that the field is an array.
+      ARRAY_CONTAINS = 7;
+    }
+
+    // The field to filter by.
+    FieldReference field = 1;
+
+    // The operator to filter by.
+    Operator op = 2;
+
+    // The value to compare to.
+    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.
+    enum Operator {
+      // Unspecified. This value must not be used.
+      OPERATOR_UNSPECIFIED = 0;
+
+      // Test if a field is equal to NaN.
+      IS_NAN = 2;
+
+      // Test if an exprestion evaluates to Null.
+      IS_NULL = 3;
+    }
+
+    // The unary operator to apply.
+    Operator op = 1;
+
+    // The argument to the filter.
+    oneof operand_type {
+      // The field to which to apply the operator.
+      FieldReference field = 2;
+    }
+  }
+
+  // An order on a field.
+  message Order {
+    // The field to order by.
+    FieldReference field = 1;
+
+    // The direction to order by. Defaults to `ASCENDING`.
+    Direction direction = 2;
+  }
+
+  // A sort direction.
+  enum Direction {
+    // Unspecified.
+    DIRECTION_UNSPECIFIED = 0;
+
+    // Ascending.
+    ASCENDING = 1;
+
+    // Descending.
+    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;
+
+  // The collections to query.
+  repeated CollectionSelector from = 2;
+
+  // The filter to apply.
+  Filter where = 3;
+
+  // The order to apply to the query results.
+  //
+  // Firestore guarantees a stable ordering through the following rules:
+  //
+  //  * Any field required to appear in `order_by`, that is not already
+  //    specified in `order_by`, is appended to the order in field name order
+  //    by default.
+  //  * If an order on `__name__` is not specified, it is appended by default.
+  //
+  // Fields are appended with the same sort direction as the last order
+  // specified, or 'ASCENDING' if no order was specified. For example:
+  //
+  //  * `SELECT * FROM Foo ORDER BY A` becomes
+  //    `SELECT * FROM Foo ORDER BY A, __name__`
+  //  * `SELECT * FROM Foo ORDER BY A DESC` becomes
+  //    `SELECT * FROM Foo ORDER BY A DESC, __name__ DESC`
+  //  * `SELECT * FROM Foo WHERE A > 1` becomes
+  //    `SELECT * FROM Foo WHERE A > 1 ORDER BY A, __name__`
+  repeated Order order_by = 4;
+
+  // A starting point for the query results.
+  Cursor start_at = 7;
+
+  // A end point for the query results.
+  Cursor end_at = 8;
+
+  // The number of results to skip.
+  //
+  // Applies before limit, but after all other constraints. Must be >= 0 if
+  // specified.
+  int32 offset = 6;
+
+  // The maximum number of results to return.
+  //
+  // Applies after all other constraints.
+  // Must be >= 0 if specified.
+  google.protobuf.Int32Value limit = 5;
+}
+
+// A position in a query result set.
+message Cursor {
+  // The values that represent a position, in the order they appear in
+  // the order by clause of a query.
+  //
+  // Can contain fewer values than specified in the order by clause.
+  repeated Value values = 1;
+
+  // If the position is just before or just after the given values, relative
+  // to the sort order defined by the query.
+  bool before = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/query_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/query_pb2.py
new file mode 100644
index 000000000000..81bc4b3361b6
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/query_pb2.py
@@ -0,0 +1,1191 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/query.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1beta1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2,
+)
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/query.proto",
+    package="google.firestore.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.firestore.v1beta1B\nQueryProtoP\001ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\242\002\004GCFS\252\002\036Google.Cloud.Firestore.V1Beta1\312\002\036Google\\Cloud\\Firestore\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/firestore_v1beta1/proto/query.proto\x12\x18google.firestore.v1beta1\x1a\x33google/cloud/firestore_v1beta1/proto/document.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x1cgoogle/api/annotations.proto"\xb9\x0f\n\x0fStructuredQuery\x12\x44\n\x06select\x18\x01 \x01(\x0b\x32\x34.google.firestore.v1beta1.StructuredQuery.Projection\x12J\n\x04\x66rom\x18\x02 \x03(\x0b\x32<.google.firestore.v1beta1.StructuredQuery.CollectionSelector\x12?\n\x05where\x18\x03 \x01(\x0b\x32\x30.google.firestore.v1beta1.StructuredQuery.Filter\x12\x41\n\x08order_by\x18\x04 \x03(\x0b\x32/.google.firestore.v1beta1.StructuredQuery.Order\x12\x32\n\x08start_at\x18\x07 \x01(\x0b\x32 .google.firestore.v1beta1.Cursor\x12\x30\n\x06\x65nd_at\x18\x08 \x01(\x0b\x32 .google.firestore.v1beta1.Cursor\x12\x0e\n\x06offset\x18\x06 \x01(\x05\x12*\n\x05limit\x18\x05 \x01(\x0b\x32\x1b.google.protobuf.Int32Value\x1a\x44\n\x12\x43ollectionSelector\x12\x15\n\rcollection_id\x18\x02 \x01(\t\x12\x17\n\x0f\x61ll_descendants\x18\x03 \x01(\x08\x1a\x8c\x02\n\x06\x46ilter\x12U\n\x10\x63omposite_filter\x18\x01 \x01(\x0b\x32\x39.google.firestore.v1beta1.StructuredQuery.CompositeFilterH\x00\x12M\n\x0c\x66ield_filter\x18\x02 \x01(\x0b\x32\x35.google.firestore.v1beta1.StructuredQuery.FieldFilterH\x00\x12M\n\x0cunary_filter\x18\x03 \x01(\x0b\x32\x35.google.firestore.v1beta1.StructuredQuery.UnaryFilterH\x00\x42\r\n\x0b\x66ilter_type\x1a\xd3\x01\n\x0f\x43ompositeFilter\x12N\n\x02op\x18\x01 \x01(\x0e\x32\x42.google.firestore.v1beta1.StructuredQuery.CompositeFilter.Operator\x12\x41\n\x07\x66ilters\x18\x02 \x03(\x0b\x32\x30.google.firestore.v1beta1.StructuredQuery.Filter"-\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x1a\xec\x02\n\x0b\x46ieldFilter\x12G\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x38.google.firestore.v1beta1.StructuredQuery.FieldReference\x12J\n\x02op\x18\x02 \x01(\x0e\x32>.google.firestore.v1beta1.StructuredQuery.FieldFilter.Operator\x12.\n\x05value\x18\x03 \x01(\x0b\x32\x1f.google.firestore.v1beta1.Value"\x97\x01\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\r\n\tLESS_THAN\x10\x01\x12\x16\n\x12LESS_THAN_OR_EQUAL\x10\x02\x12\x10\n\x0cGREATER_THAN\x10\x03\x12\x19\n\x15GREATER_THAN_OR_EQUAL\x10\x04\x12\t\n\x05\x45QUAL\x10\x05\x12\x12\n\x0e\x41RRAY_CONTAINS\x10\x07\x1aV\n\nProjection\x12H\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x38.google.firestore.v1beta1.StructuredQuery.FieldReference\x1a\xf3\x01\n\x0bUnaryFilter\x12J\n\x02op\x18\x01 \x01(\x0e\x32>.google.firestore.v1beta1.StructuredQuery.UnaryFilter.Operator\x12I\n\x05\x66ield\x18\x02 \x01(\x0b\x32\x38.google.firestore.v1beta1.StructuredQuery.FieldReferenceH\x00"=\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\n\n\x06IS_NAN\x10\x02\x12\x0b\n\x07IS_NULL\x10\x03\x42\x0e\n\x0coperand_type\x1a\x98\x01\n\x05Order\x12G\n\x05\x66ield\x18\x01 \x01(\x0b\x32\x38.google.firestore.v1beta1.StructuredQuery.FieldReference\x12\x46\n\tdirection\x18\x02 \x01(\x0e\x32\x33.google.firestore.v1beta1.StructuredQuery.Direction\x1a$\n\x0e\x46ieldReference\x12\x12\n\nfield_path\x18\x02 \x01(\t"E\n\tDirection\x12\x19\n\x15\x44IRECTION_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x01\x12\x0e\n\nDESCENDING\x10\x02"I\n\x06\x43ursor\x12/\n\x06values\x18\x01 \x03(\x0b\x32\x1f.google.firestore.v1beta1.Value\x12\x0e\n\x06\x62\x65\x66ore\x18\x02 \x01(\x08\x42\xb8\x01\n\x1c\x63om.google.firestore.v1beta1B\nQueryProtoP\x01ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\xa2\x02\x04GCFS\xaa\x02\x1eGoogle.Cloud.Firestore.V1Beta1\xca\x02\x1eGoogle\\Cloud\\Firestore\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.firestore.v1beta1.StructuredQuery.CompositeFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AND", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1161,
+    serialized_end=1206,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR)
+
+_STRUCTUREDQUERY_FIELDFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.firestore.v1beta1.StructuredQuery.FieldFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LESS_THAN_OR_EQUAL",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GREATER_THAN_OR_EQUAL",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EQUAL", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ARRAY_CONTAINS", index=6, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1422,
+    serialized_end=1573,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_FIELDFILTER_OPERATOR)
+
+_STRUCTUREDQUERY_UNARYFILTER_OPERATOR = _descriptor.EnumDescriptor(
+    name="Operator",
+    full_name="google.firestore.v1beta1.StructuredQuery.UnaryFilter.Operator",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OPERATOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IS_NAN", index=1, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IS_NULL", index=2, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1830,
+    serialized_end=1891,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_UNARYFILTER_OPERATOR)
+
+_STRUCTUREDQUERY_DIRECTION = _descriptor.EnumDescriptor(
+    name="Direction",
+    full_name="google.firestore.v1beta1.StructuredQuery.Direction",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DIRECTION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASCENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESCENDING", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2102,
+    serialized_end=2171,
+)
+_sym_db.RegisterEnumDescriptor(_STRUCTUREDQUERY_DIRECTION)
+
+
+_STRUCTUREDQUERY_COLLECTIONSELECTOR = _descriptor.Descriptor(
+    name="CollectionSelector",
+    full_name="google.firestore.v1beta1.StructuredQuery.CollectionSelector",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="collection_id",
+            full_name="google.firestore.v1beta1.StructuredQuery.CollectionSelector.collection_id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="all_descendants",
+            full_name="google.firestore.v1beta1.StructuredQuery.CollectionSelector.all_descendants",
+            index=1,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=653,
+    serialized_end=721,
+)
+
+_STRUCTUREDQUERY_FILTER = _descriptor.Descriptor(
+    name="Filter",
+    full_name="google.firestore.v1beta1.StructuredQuery.Filter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="composite_filter",
+            full_name="google.firestore.v1beta1.StructuredQuery.Filter.composite_filter",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_filter",
+            full_name="google.firestore.v1beta1.StructuredQuery.Filter.field_filter",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unary_filter",
+            full_name="google.firestore.v1beta1.StructuredQuery.Filter.unary_filter",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="filter_type",
+            full_name="google.firestore.v1beta1.StructuredQuery.Filter.filter_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=724,
+    serialized_end=992,
+)
+
+_STRUCTUREDQUERY_COMPOSITEFILTER = _descriptor.Descriptor(
+    name="CompositeFilter",
+    full_name="google.firestore.v1beta1.StructuredQuery.CompositeFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.firestore.v1beta1.StructuredQuery.CompositeFilter.op",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filters",
+            full_name="google.firestore.v1beta1.StructuredQuery.CompositeFilter.filters",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=995,
+    serialized_end=1206,
+)
+
+_STRUCTUREDQUERY_FIELDFILTER = _descriptor.Descriptor(
+    name="FieldFilter",
+    full_name="google.firestore.v1beta1.StructuredQuery.FieldFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.v1beta1.StructuredQuery.FieldFilter.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.firestore.v1beta1.StructuredQuery.FieldFilter.op",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.firestore.v1beta1.StructuredQuery.FieldFilter.value",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STRUCTUREDQUERY_FIELDFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1209,
+    serialized_end=1573,
+)
+
+_STRUCTUREDQUERY_PROJECTION = _descriptor.Descriptor(
+    name="Projection",
+    full_name="google.firestore.v1beta1.StructuredQuery.Projection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.firestore.v1beta1.StructuredQuery.Projection.fields",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1575,
+    serialized_end=1661,
+)
+
+_STRUCTUREDQUERY_UNARYFILTER = _descriptor.Descriptor(
+    name="UnaryFilter",
+    full_name="google.firestore.v1beta1.StructuredQuery.UnaryFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="google.firestore.v1beta1.StructuredQuery.UnaryFilter.op",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.v1beta1.StructuredQuery.UnaryFilter.field",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STRUCTUREDQUERY_UNARYFILTER_OPERATOR],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="operand_type",
+            full_name="google.firestore.v1beta1.StructuredQuery.UnaryFilter.operand_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1664,
+    serialized_end=1907,
+)
+
+_STRUCTUREDQUERY_ORDER = _descriptor.Descriptor(
+    name="Order",
+    full_name="google.firestore.v1beta1.StructuredQuery.Order",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="google.firestore.v1beta1.StructuredQuery.Order.field",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="direction",
+            full_name="google.firestore.v1beta1.StructuredQuery.Order.direction",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1910,
+    serialized_end=2062,
+)
+
+_STRUCTUREDQUERY_FIELDREFERENCE = _descriptor.Descriptor(
+    name="FieldReference",
+    full_name="google.firestore.v1beta1.StructuredQuery.FieldReference",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_path",
+            full_name="google.firestore.v1beta1.StructuredQuery.FieldReference.field_path",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2064,
+    serialized_end=2100,
+)
+
+_STRUCTUREDQUERY = _descriptor.Descriptor(
+    name="StructuredQuery",
+    full_name="google.firestore.v1beta1.StructuredQuery",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="select",
+            full_name="google.firestore.v1beta1.StructuredQuery.select",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="from",
+            full_name="google.firestore.v1beta1.StructuredQuery.from",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="where",
+            full_name="google.firestore.v1beta1.StructuredQuery.where",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.firestore.v1beta1.StructuredQuery.order_by",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_at",
+            full_name="google.firestore.v1beta1.StructuredQuery.start_at",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_at",
+            full_name="google.firestore.v1beta1.StructuredQuery.end_at",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.firestore.v1beta1.StructuredQuery.offset",
+            index=6,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="google.firestore.v1beta1.StructuredQuery.limit",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _STRUCTUREDQUERY_COLLECTIONSELECTOR,
+        _STRUCTUREDQUERY_FILTER,
+        _STRUCTUREDQUERY_COMPOSITEFILTER,
+        _STRUCTUREDQUERY_FIELDFILTER,
+        _STRUCTUREDQUERY_PROJECTION,
+        _STRUCTUREDQUERY_UNARYFILTER,
+        _STRUCTUREDQUERY_ORDER,
+        _STRUCTUREDQUERY_FIELDREFERENCE,
+    ],
+    enum_types=[_STRUCTUREDQUERY_DIRECTION],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=194,
+    serialized_end=2171,
+)
+
+
+_CURSOR = _descriptor.Descriptor(
+    name="Cursor",
+    full_name="google.firestore.v1beta1.Cursor",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.firestore.v1beta1.Cursor.values",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="before",
+            full_name="google.firestore.v1beta1.Cursor.before",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2173,
+    serialized_end=2246,
+)
+
+_STRUCTUREDQUERY_COLLECTIONSELECTOR.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "composite_filter"
+].message_type = _STRUCTUREDQUERY_COMPOSITEFILTER
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "field_filter"
+].message_type = _STRUCTUREDQUERY_FIELDFILTER
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "unary_filter"
+].message_type = _STRUCTUREDQUERY_UNARYFILTER
+_STRUCTUREDQUERY_FILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _STRUCTUREDQUERY_FILTER.fields_by_name["composite_filter"]
+)
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "composite_filter"
+].containing_oneof = _STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"]
+_STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _STRUCTUREDQUERY_FILTER.fields_by_name["field_filter"]
+)
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "field_filter"
+].containing_oneof = _STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"]
+_STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"].fields.append(
+    _STRUCTUREDQUERY_FILTER.fields_by_name["unary_filter"]
+)
+_STRUCTUREDQUERY_FILTER.fields_by_name[
+    "unary_filter"
+].containing_oneof = _STRUCTUREDQUERY_FILTER.oneofs_by_name["filter_type"]
+_STRUCTUREDQUERY_COMPOSITEFILTER.fields_by_name[
+    "op"
+].enum_type = _STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR
+_STRUCTUREDQUERY_COMPOSITEFILTER.fields_by_name[
+    "filters"
+].message_type = _STRUCTUREDQUERY_FILTER
+_STRUCTUREDQUERY_COMPOSITEFILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_COMPOSITEFILTER_OPERATOR.containing_type = (
+    _STRUCTUREDQUERY_COMPOSITEFILTER
+)
+_STRUCTUREDQUERY_FIELDFILTER.fields_by_name[
+    "field"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_FIELDFILTER.fields_by_name[
+    "op"
+].enum_type = _STRUCTUREDQUERY_FIELDFILTER_OPERATOR
+_STRUCTUREDQUERY_FIELDFILTER.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._VALUE
+)
+_STRUCTUREDQUERY_FIELDFILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FIELDFILTER_OPERATOR.containing_type = _STRUCTUREDQUERY_FIELDFILTER
+_STRUCTUREDQUERY_PROJECTION.fields_by_name[
+    "fields"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_PROJECTION.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_UNARYFILTER.fields_by_name[
+    "op"
+].enum_type = _STRUCTUREDQUERY_UNARYFILTER_OPERATOR
+_STRUCTUREDQUERY_UNARYFILTER.fields_by_name[
+    "field"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_UNARYFILTER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_UNARYFILTER_OPERATOR.containing_type = _STRUCTUREDQUERY_UNARYFILTER
+_STRUCTUREDQUERY_UNARYFILTER.oneofs_by_name["operand_type"].fields.append(
+    _STRUCTUREDQUERY_UNARYFILTER.fields_by_name["field"]
+)
+_STRUCTUREDQUERY_UNARYFILTER.fields_by_name[
+    "field"
+].containing_oneof = _STRUCTUREDQUERY_UNARYFILTER.oneofs_by_name["operand_type"]
+_STRUCTUREDQUERY_ORDER.fields_by_name[
+    "field"
+].message_type = _STRUCTUREDQUERY_FIELDREFERENCE
+_STRUCTUREDQUERY_ORDER.fields_by_name[
+    "direction"
+].enum_type = _STRUCTUREDQUERY_DIRECTION
+_STRUCTUREDQUERY_ORDER.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY_FIELDREFERENCE.containing_type = _STRUCTUREDQUERY
+_STRUCTUREDQUERY.fields_by_name["select"].message_type = _STRUCTUREDQUERY_PROJECTION
+_STRUCTUREDQUERY.fields_by_name[
+    "from"
+].message_type = _STRUCTUREDQUERY_COLLECTIONSELECTOR
+_STRUCTUREDQUERY.fields_by_name["where"].message_type = _STRUCTUREDQUERY_FILTER
+_STRUCTUREDQUERY.fields_by_name["order_by"].message_type = _STRUCTUREDQUERY_ORDER
+_STRUCTUREDQUERY.fields_by_name["start_at"].message_type = _CURSOR
+_STRUCTUREDQUERY.fields_by_name["end_at"].message_type = _CURSOR
+_STRUCTUREDQUERY.fields_by_name[
+    "limit"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_STRUCTUREDQUERY_DIRECTION.containing_type = _STRUCTUREDQUERY
+_CURSOR.fields_by_name[
+    "values"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._VALUE
+)
+DESCRIPTOR.message_types_by_name["StructuredQuery"] = _STRUCTUREDQUERY
+DESCRIPTOR.message_types_by_name["Cursor"] = _CURSOR
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+StructuredQuery = _reflection.GeneratedProtocolMessageType(
+    "StructuredQuery",
+    (_message.Message,),
+    dict(
+        CollectionSelector=_reflection.GeneratedProtocolMessageType(
+            "CollectionSelector",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_COLLECTIONSELECTOR,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""A selection of a collection, such as ``messages as m1``.
+    
+    
+    Attributes:
+        collection_id:
+            The collection ID. When set, selects only collections with
+            this ID.
+        all_descendants:
+            When false, selects only collections that are immediate
+            children of the ``parent`` specified in the containing
+            ``RunQueryRequest``. When true, selects all descendant
+            collections.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.CollectionSelector)
+            ),
+        ),
+        Filter=_reflection.GeneratedProtocolMessageType(
+            "Filter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_FILTER,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""A filter.
+    
+    
+    Attributes:
+        filter_type:
+            The type of filter.
+        composite_filter:
+            A composite filter.
+        field_filter:
+            A filter on a document field.
+        unary_filter:
+            A filter that takes exactly one argument.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.Filter)
+            ),
+        ),
+        CompositeFilter=_reflection.GeneratedProtocolMessageType(
+            "CompositeFilter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_COMPOSITEFILTER,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""A filter that merges multiple other filters using the given operator.
+    
+    
+    Attributes:
+        op:
+            The operator for combining multiple filters.
+        filters:
+            The list of filters to combine. Must contain at least one
+            filter.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.CompositeFilter)
+            ),
+        ),
+        FieldFilter=_reflection.GeneratedProtocolMessageType(
+            "FieldFilter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_FIELDFILTER,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""A filter on a specific field.
+    
+    
+    Attributes:
+        field:
+            The field to filter by.
+        op:
+            The operator to filter by.
+        value:
+            The value to compare to.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.FieldFilter)
+            ),
+        ),
+        Projection=_reflection.GeneratedProtocolMessageType(
+            "Projection",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_PROJECTION,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""The projection of document's fields to return.
+    
+    
+    Attributes:
+        fields:
+            The fields to return.  If empty, all fields are returned. To
+            only return the name of the document, use ``['__name__']``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.Projection)
+            ),
+        ),
+        UnaryFilter=_reflection.GeneratedProtocolMessageType(
+            "UnaryFilter",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_UNARYFILTER,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""A filter with a single operand.
+    
+    
+    Attributes:
+        op:
+            The unary operator to apply.
+        operand_type:
+            The argument to the filter.
+        field:
+            The field to which to apply the operator.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.UnaryFilter)
+            ),
+        ),
+        Order=_reflection.GeneratedProtocolMessageType(
+            "Order",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_ORDER,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""An order on a field.
+    
+    
+    Attributes:
+        field:
+            The field to order by.
+        direction:
+            The direction to order by. Defaults to ``ASCENDING``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.Order)
+            ),
+        ),
+        FieldReference=_reflection.GeneratedProtocolMessageType(
+            "FieldReference",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTUREDQUERY_FIELDREFERENCE,
+                __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+                __doc__="""A reference to a field, such as ``max(messages.time) as max_time``.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery.FieldReference)
+            ),
+        ),
+        DESCRIPTOR=_STRUCTUREDQUERY,
+        __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+        __doc__="""A Firestore query.
+  
+  
+  Attributes:
+      select:
+          The projection to return.
+      from:
+          The collections to query.
+      where:
+          The filter to apply.
+      order_by:
+          The order to apply to the query results.  Firestore guarantees
+          a stable ordering through the following rules:  -  Any field
+          required to appear in ``order_by``, that is not already
+          specified in ``order_by``, is appended to the order in field
+          name    order by default. -  If an order on ``__name__`` is
+          not specified, it is appended by    default.  Fields are
+          appended with the same sort direction as the last order
+          specified, or 'ASCENDING' if no order was specified. For
+          example:  -  ``SELECT * FROM Foo ORDER BY A`` becomes
+          ``SELECT * FROM Foo ORDER BY A, __name__`` -  ``SELECT * FROM
+          Foo ORDER BY A DESC`` becomes    ``SELECT * FROM Foo ORDER BY
+          A DESC, __name__ DESC`` -  ``SELECT * FROM Foo WHERE A > 1``
+          becomes    ``SELECT * FROM Foo WHERE A > 1 ORDER BY A,
+          __name__``
+      start_at:
+          A starting point for the query results.
+      end_at:
+          A end point for the query results.
+      offset:
+          The number of results to skip.  Applies before limit, but
+          after all other constraints. Must be >= 0 if specified.
+      limit:
+          The maximum number of results to return.  Applies after all
+          other constraints. Must be >= 0 if specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.StructuredQuery)
+    ),
+)
+_sym_db.RegisterMessage(StructuredQuery)
+_sym_db.RegisterMessage(StructuredQuery.CollectionSelector)
+_sym_db.RegisterMessage(StructuredQuery.Filter)
+_sym_db.RegisterMessage(StructuredQuery.CompositeFilter)
+_sym_db.RegisterMessage(StructuredQuery.FieldFilter)
+_sym_db.RegisterMessage(StructuredQuery.Projection)
+_sym_db.RegisterMessage(StructuredQuery.UnaryFilter)
+_sym_db.RegisterMessage(StructuredQuery.Order)
+_sym_db.RegisterMessage(StructuredQuery.FieldReference)
+
+Cursor = _reflection.GeneratedProtocolMessageType(
+    "Cursor",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CURSOR,
+        __module__="google.cloud.firestore_v1beta1.proto.query_pb2",
+        __doc__="""A position in a query result set.
+  
+  
+  Attributes:
+      values:
+          The values that represent a position, in the order they appear
+          in the order by clause of a query.  Can contain fewer values
+          than specified in the order by clause.
+      before:
+          If the position is just before or just after the given values,
+          relative to the sort order defined by the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Cursor)
+    ),
+)
+_sym_db.RegisterMessage(Cursor)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/query_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/query_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/query_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/test_v1beta1_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/test_v1beta1_pb2.py
new file mode 100644
index 000000000000..18dc58706837
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/test_v1beta1_pb2.py
@@ -0,0 +1,2190 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: test_v1beta1.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    firestore_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    query_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="test_v1beta1.proto",
+    package="tests.v1beta1",
+    syntax="proto3",
+    serialized_pb=_b(
+        '\n\x12test_v1beta1.proto\x12\rtests.v1beta1\x1a\x31google/cloud/firestore_v1beta1/proto/common.proto\x1a\x33google/cloud/firestore_v1beta1/proto/document.proto\x1a\x34google/cloud/firestore_v1beta1/proto/firestore.proto\x1a\x30google/cloud/firestore_v1beta1/proto/query.proto\x1a\x1fgoogle/protobuf/timestamp.proto"/\n\tTestSuite\x12"\n\x05tests\x18\x01 \x03(\x0b\x32\x13.tests.v1beta1.Test"\x88\x03\n\x04Test\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12%\n\x03get\x18\x02 \x01(\x0b\x32\x16.tests.v1beta1.GetTestH\x00\x12+\n\x06\x63reate\x18\x03 \x01(\x0b\x32\x19.tests.v1beta1.CreateTestH\x00\x12%\n\x03set\x18\x04 \x01(\x0b\x32\x16.tests.v1beta1.SetTestH\x00\x12+\n\x06update\x18\x05 \x01(\x0b\x32\x19.tests.v1beta1.UpdateTestH\x00\x12\x36\n\x0cupdate_paths\x18\x06 \x01(\x0b\x32\x1e.tests.v1beta1.UpdatePathsTestH\x00\x12+\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x19.tests.v1beta1.DeleteTestH\x00\x12)\n\x05query\x18\x08 \x01(\x0b\x32\x18.tests.v1beta1.QueryTestH\x00\x12+\n\x06listen\x18\t \x01(\x0b\x32\x19.tests.v1beta1.ListenTestH\x00\x42\x06\n\x04test"^\n\x07GetTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12=\n\x07request\x18\x02 \x01(\x0b\x32,.google.firestore.v1beta1.GetDocumentRequest"\x81\x01\n\nCreateTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12\x11\n\tjson_data\x18\x02 \x01(\t\x12\x38\n\x07request\x18\x03 \x01(\x0b\x32\'.google.firestore.v1beta1.CommitRequest\x12\x10\n\x08is_error\x18\x04 \x01(\x08"\xa8\x01\n\x07SetTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12(\n\x06option\x18\x02 \x01(\x0b\x32\x18.tests.v1beta1.SetOption\x12\x11\n\tjson_data\x18\x03 \x01(\t\x12\x38\n\x07request\x18\x04 \x01(\x0b\x32\'.google.firestore.v1beta1.CommitRequest\x12\x10\n\x08is_error\x18\x05 \x01(\x08"\xbf\x01\n\nUpdateTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12<\n\x0cprecondition\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.Precondition\x12\x11\n\tjson_data\x18\x03 \x01(\t\x12\x38\n\x07request\x18\x04 \x01(\x0b\x32\'.google.firestore.v1beta1.CommitRequest\x12\x10\n\x08is_error\x18\x05 \x01(\x08"\xf5\x01\n\x0fUpdatePathsTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12<\n\x0cprecondition\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.Precondition\x12-\n\x0b\x66ield_paths\x18\x03 \x03(\x0b\x32\x18.tests.v1beta1.FieldPath\x12\x13\n\x0bjson_values\x18\x04 \x03(\t\x12\x38\n\x07request\x18\x05 \x01(\x0b\x32\'.google.firestore.v1beta1.CommitRequest\x12\x10\n\x08is_error\x18\x06 \x01(\x08"\xac\x01\n\nDeleteTest\x12\x14\n\x0c\x64oc_ref_path\x18\x01 \x01(\t\x12<\n\x0cprecondition\x18\x02 \x01(\x0b\x32&.google.firestore.v1beta1.Precondition\x12\x38\n\x07request\x18\x03 \x01(\x0b\x32\'.google.firestore.v1beta1.CommitRequest\x12\x10\n\x08is_error\x18\x04 \x01(\x08"B\n\tSetOption\x12\x0b\n\x03\x61ll\x18\x01 \x01(\x08\x12(\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x18.tests.v1beta1.FieldPath"\x92\x01\n\tQueryTest\x12\x11\n\tcoll_path\x18\x01 \x01(\t\x12&\n\x07\x63lauses\x18\x02 \x03(\x0b\x32\x15.tests.v1beta1.Clause\x12\x38\n\x05query\x18\x03 \x01(\x0b\x32).google.firestore.v1beta1.StructuredQuery\x12\x10\n\x08is_error\x18\x04 \x01(\x08"\xe0\x02\n\x06\x43lause\x12\'\n\x06select\x18\x01 \x01(\x0b\x32\x15.tests.v1beta1.SelectH\x00\x12%\n\x05where\x18\x02 \x01(\x0b\x32\x14.tests.v1beta1.WhereH\x00\x12*\n\x08order_by\x18\x03 \x01(\x0b\x32\x16.tests.v1beta1.OrderByH\x00\x12\x10\n\x06offset\x18\x04 \x01(\x05H\x00\x12\x0f\n\x05limit\x18\x05 \x01(\x05H\x00\x12)\n\x08start_at\x18\x06 \x01(\x0b\x32\x15.tests.v1beta1.CursorH\x00\x12,\n\x0bstart_after\x18\x07 \x01(\x0b\x32\x15.tests.v1beta1.CursorH\x00\x12\'\n\x06\x65nd_at\x18\x08 \x01(\x0b\x32\x15.tests.v1beta1.CursorH\x00\x12+\n\nend_before\x18\t \x01(\x0b\x32\x15.tests.v1beta1.CursorH\x00\x42\x08\n\x06\x63lause"2\n\x06Select\x12(\n\x06\x66ields\x18\x01 \x03(\x0b\x32\x18.tests.v1beta1.FieldPath"O\n\x05Where\x12&\n\x04path\x18\x01 \x01(\x0b\x32\x18.tests.v1beta1.FieldPath\x12\n\n\x02op\x18\x02 \x01(\t\x12\x12\n\njson_value\x18\x03 \x01(\t"D\n\x07OrderBy\x12&\n\x04path\x18\x01 \x01(\x0b\x32\x18.tests.v1beta1.FieldPath\x12\x11\n\tdirection\x18\x02 \x01(\t"O\n\x06\x43ursor\x12\x30\n\x0c\x64oc_snapshot\x18\x01 \x01(\x0b\x32\x1a.tests.v1beta1.DocSnapshot\x12\x13\n\x0bjson_values\x18\x02 \x03(\t".\n\x0b\x44ocSnapshot\x12\x0c\n\x04path\x18\x01 \x01(\t\x12\x11\n\tjson_data\x18\x02 \x01(\t"\x1a\n\tFieldPath\x12\r\n\x05\x66ield\x18\x01 \x03(\t"\x87\x01\n\nListenTest\x12;\n\tresponses\x18\x01 \x03(\x0b\x32(.google.firestore.v1beta1.ListenResponse\x12*\n\tsnapshots\x18\x02 \x03(\x0b\x32\x17.tests.v1beta1.Snapshot\x12\x10\n\x08is_error\x18\x03 \x01(\x08"\x96\x01\n\x08Snapshot\x12\x30\n\x04\x64ocs\x18\x01 \x03(\x0b\x32".google.firestore.v1beta1.Document\x12)\n\x07\x63hanges\x18\x02 \x03(\x0b\x32\x18.tests.v1beta1.DocChange\x12-\n\tread_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xd3\x01\n\tDocChange\x12+\n\x04kind\x18\x01 \x01(\x0e\x32\x1d.tests.v1beta1.DocChange.Kind\x12/\n\x03\x64oc\x18\x02 \x01(\x0b\x32".google.firestore.v1beta1.Document\x12\x11\n\told_index\x18\x03 \x01(\x05\x12\x11\n\tnew_index\x18\x04 \x01(\x05"B\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\t\n\x05\x41\x44\x44\x45\x44\x10\x01\x12\x0b\n\x07REMOVED\x10\x02\x12\x0c\n\x08MODIFIED\x10\x03\x42x\n&com.google.cloud.firestore.conformance\xaa\x02"Google.Cloud.Firestore.Tests.Proto\xca\x02(Google\\Cloud\\Firestore\\Tests\\Conformanceb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCCHANGE_KIND = _descriptor.EnumDescriptor(
+    name="Kind",
+    full_name="tests.v1beta1.DocChange.Kind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="KIND_UNSPECIFIED", index=0, number=0, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDED", index=1, number=1, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVED", index=2, number=2, options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MODIFIED", index=3, number=3, options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    options=None,
+    serialized_start=3107,
+    serialized_end=3173,
+)
+_sym_db.RegisterEnumDescriptor(_DOCCHANGE_KIND)
+
+
+_TESTSUITE = _descriptor.Descriptor(
+    name="TestSuite",
+    full_name="tests.v1beta1.TestSuite",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tests",
+            full_name="tests.v1beta1.TestSuite.tests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=278,
+    serialized_end=325,
+)
+
+
+_TEST = _descriptor.Descriptor(
+    name="Test",
+    full_name="tests.v1beta1.Test",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="tests.v1beta1.Test.description",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="get",
+            full_name="tests.v1beta1.Test.get",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create",
+            full_name="tests.v1beta1.Test.create",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="set",
+            full_name="tests.v1beta1.Test.set",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="tests.v1beta1.Test.update",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_paths",
+            full_name="tests.v1beta1.Test.update_paths",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="tests.v1beta1.Test.delete",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="tests.v1beta1.Test.query",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="listen",
+            full_name="tests.v1beta1.Test.listen",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="test",
+            full_name="tests.v1beta1.Test.test",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=328,
+    serialized_end=720,
+)
+
+
+_GETTEST = _descriptor.Descriptor(
+    name="GetTest",
+    full_name="tests.v1beta1.GetTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1beta1.GetTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1beta1.GetTest.request",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=722,
+    serialized_end=816,
+)
+
+
+_CREATETEST = _descriptor.Descriptor(
+    name="CreateTest",
+    full_name="tests.v1beta1.CreateTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1beta1.CreateTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1beta1.CreateTest.json_data",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1beta1.CreateTest.request",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.CreateTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=819,
+    serialized_end=948,
+)
+
+
+_SETTEST = _descriptor.Descriptor(
+    name="SetTest",
+    full_name="tests.v1beta1.SetTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1beta1.SetTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="option",
+            full_name="tests.v1beta1.SetTest.option",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1beta1.SetTest.json_data",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1beta1.SetTest.request",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.SetTest.is_error",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=951,
+    serialized_end=1119,
+)
+
+
+_UPDATETEST = _descriptor.Descriptor(
+    name="UpdateTest",
+    full_name="tests.v1beta1.UpdateTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1beta1.UpdateTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="tests.v1beta1.UpdateTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1beta1.UpdateTest.json_data",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1beta1.UpdateTest.request",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.UpdateTest.is_error",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1122,
+    serialized_end=1313,
+)
+
+
+_UPDATEPATHSTEST = _descriptor.Descriptor(
+    name="UpdatePathsTest",
+    full_name="tests.v1beta1.UpdatePathsTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1beta1.UpdatePathsTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="tests.v1beta1.UpdatePathsTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_paths",
+            full_name="tests.v1beta1.UpdatePathsTest.field_paths",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_values",
+            full_name="tests.v1beta1.UpdatePathsTest.json_values",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1beta1.UpdatePathsTest.request",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.UpdatePathsTest.is_error",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1316,
+    serialized_end=1561,
+)
+
+
+_DELETETEST = _descriptor.Descriptor(
+    name="DeleteTest",
+    full_name="tests.v1beta1.DeleteTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_ref_path",
+            full_name="tests.v1beta1.DeleteTest.doc_ref_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="precondition",
+            full_name="tests.v1beta1.DeleteTest.precondition",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request",
+            full_name="tests.v1beta1.DeleteTest.request",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.DeleteTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1564,
+    serialized_end=1736,
+)
+
+
+_SETOPTION = _descriptor.Descriptor(
+    name="SetOption",
+    full_name="tests.v1beta1.SetOption",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="all",
+            full_name="tests.v1beta1.SetOption.all",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="tests.v1beta1.SetOption.fields",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1738,
+    serialized_end=1804,
+)
+
+
+_QUERYTEST = _descriptor.Descriptor(
+    name="QueryTest",
+    full_name="tests.v1beta1.QueryTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="coll_path",
+            full_name="tests.v1beta1.QueryTest.coll_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="clauses",
+            full_name="tests.v1beta1.QueryTest.clauses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="tests.v1beta1.QueryTest.query",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.QueryTest.is_error",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1807,
+    serialized_end=1953,
+)
+
+
+_CLAUSE = _descriptor.Descriptor(
+    name="Clause",
+    full_name="tests.v1beta1.Clause",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="select",
+            full_name="tests.v1beta1.Clause.select",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="where",
+            full_name="tests.v1beta1.Clause.where",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="tests.v1beta1.Clause.order_by",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="tests.v1beta1.Clause.offset",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="tests.v1beta1.Clause.limit",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_at",
+            full_name="tests.v1beta1.Clause.start_at",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_after",
+            full_name="tests.v1beta1.Clause.start_after",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_at",
+            full_name="tests.v1beta1.Clause.end_at",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_before",
+            full_name="tests.v1beta1.Clause.end_before",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="clause",
+            full_name="tests.v1beta1.Clause.clause",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1956,
+    serialized_end=2308,
+)
+
+
+_SELECT = _descriptor.Descriptor(
+    name="Select",
+    full_name="tests.v1beta1.Select",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="tests.v1beta1.Select.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2310,
+    serialized_end=2360,
+)
+
+
+_WHERE = _descriptor.Descriptor(
+    name="Where",
+    full_name="tests.v1beta1.Where",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="tests.v1beta1.Where.path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="op",
+            full_name="tests.v1beta1.Where.op",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_value",
+            full_name="tests.v1beta1.Where.json_value",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2362,
+    serialized_end=2441,
+)
+
+
+_ORDERBY = _descriptor.Descriptor(
+    name="OrderBy",
+    full_name="tests.v1beta1.OrderBy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="tests.v1beta1.OrderBy.path",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="direction",
+            full_name="tests.v1beta1.OrderBy.direction",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2443,
+    serialized_end=2511,
+)
+
+
+_CURSOR = _descriptor.Descriptor(
+    name="Cursor",
+    full_name="tests.v1beta1.Cursor",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="doc_snapshot",
+            full_name="tests.v1beta1.Cursor.doc_snapshot",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_values",
+            full_name="tests.v1beta1.Cursor.json_values",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2513,
+    serialized_end=2592,
+)
+
+
+_DOCSNAPSHOT = _descriptor.Descriptor(
+    name="DocSnapshot",
+    full_name="tests.v1beta1.DocSnapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="tests.v1beta1.DocSnapshot.path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_data",
+            full_name="tests.v1beta1.DocSnapshot.json_data",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2594,
+    serialized_end=2640,
+)
+
+
+_FIELDPATH = _descriptor.Descriptor(
+    name="FieldPath",
+    full_name="tests.v1beta1.FieldPath",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field",
+            full_name="tests.v1beta1.FieldPath.field",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2642,
+    serialized_end=2668,
+)
+
+
+_LISTENTEST = _descriptor.Descriptor(
+    name="ListenTest",
+    full_name="tests.v1beta1.ListenTest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="tests.v1beta1.ListenTest.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="snapshots",
+            full_name="tests.v1beta1.ListenTest.snapshots",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_error",
+            full_name="tests.v1beta1.ListenTest.is_error",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2671,
+    serialized_end=2806,
+)
+
+
+_SNAPSHOT = _descriptor.Descriptor(
+    name="Snapshot",
+    full_name="tests.v1beta1.Snapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="docs",
+            full_name="tests.v1beta1.Snapshot.docs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="changes",
+            full_name="tests.v1beta1.Snapshot.changes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="tests.v1beta1.Snapshot.read_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2809,
+    serialized_end=2959,
+)
+
+
+_DOCCHANGE = _descriptor.Descriptor(
+    name="DocChange",
+    full_name="tests.v1beta1.DocChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="tests.v1beta1.DocChange.kind",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="doc",
+            full_name="tests.v1beta1.DocChange.doc",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="old_index",
+            full_name="tests.v1beta1.DocChange.old_index",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_index",
+            full_name="tests.v1beta1.DocChange.new_index",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCCHANGE_KIND],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2962,
+    serialized_end=3173,
+)
+
+_TESTSUITE.fields_by_name["tests"].message_type = _TEST
+_TEST.fields_by_name["get"].message_type = _GETTEST
+_TEST.fields_by_name["create"].message_type = _CREATETEST
+_TEST.fields_by_name["set"].message_type = _SETTEST
+_TEST.fields_by_name["update"].message_type = _UPDATETEST
+_TEST.fields_by_name["update_paths"].message_type = _UPDATEPATHSTEST
+_TEST.fields_by_name["delete"].message_type = _DELETETEST
+_TEST.fields_by_name["query"].message_type = _QUERYTEST
+_TEST.fields_by_name["listen"].message_type = _LISTENTEST
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["get"])
+_TEST.fields_by_name["get"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["create"])
+_TEST.fields_by_name["create"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["set"])
+_TEST.fields_by_name["set"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["update"])
+_TEST.fields_by_name["update"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["update_paths"])
+_TEST.fields_by_name["update_paths"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["delete"])
+_TEST.fields_by_name["delete"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["query"])
+_TEST.fields_by_name["query"].containing_oneof = _TEST.oneofs_by_name["test"]
+_TEST.oneofs_by_name["test"].fields.append(_TEST.fields_by_name["listen"])
+_TEST.fields_by_name["listen"].containing_oneof = _TEST.oneofs_by_name["test"]
+_GETTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._GETDOCUMENTREQUEST
+)
+_CREATETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_SETTEST.fields_by_name["option"].message_type = _SETOPTION
+_SETTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_UPDATETEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_UPDATETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_UPDATEPATHSTEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_UPDATEPATHSTEST.fields_by_name["field_paths"].message_type = _FIELDPATH
+_UPDATEPATHSTEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_DELETETEST.fields_by_name[
+    "precondition"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_DELETETEST.fields_by_name[
+    "request"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._COMMITREQUEST
+)
+_SETOPTION.fields_by_name["fields"].message_type = _FIELDPATH
+_QUERYTEST.fields_by_name["clauses"].message_type = _CLAUSE
+_QUERYTEST.fields_by_name[
+    "query"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_query__pb2._STRUCTUREDQUERY
+)
+_CLAUSE.fields_by_name["select"].message_type = _SELECT
+_CLAUSE.fields_by_name["where"].message_type = _WHERE
+_CLAUSE.fields_by_name["order_by"].message_type = _ORDERBY
+_CLAUSE.fields_by_name["start_at"].message_type = _CURSOR
+_CLAUSE.fields_by_name["start_after"].message_type = _CURSOR
+_CLAUSE.fields_by_name["end_at"].message_type = _CURSOR
+_CLAUSE.fields_by_name["end_before"].message_type = _CURSOR
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["select"])
+_CLAUSE.fields_by_name["select"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["where"])
+_CLAUSE.fields_by_name["where"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["order_by"])
+_CLAUSE.fields_by_name["order_by"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["offset"])
+_CLAUSE.fields_by_name["offset"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["limit"])
+_CLAUSE.fields_by_name["limit"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["start_at"])
+_CLAUSE.fields_by_name["start_at"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["start_after"])
+_CLAUSE.fields_by_name["start_after"].containing_oneof = _CLAUSE.oneofs_by_name[
+    "clause"
+]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["end_at"])
+_CLAUSE.fields_by_name["end_at"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_CLAUSE.oneofs_by_name["clause"].fields.append(_CLAUSE.fields_by_name["end_before"])
+_CLAUSE.fields_by_name["end_before"].containing_oneof = _CLAUSE.oneofs_by_name["clause"]
+_SELECT.fields_by_name["fields"].message_type = _FIELDPATH
+_WHERE.fields_by_name["path"].message_type = _FIELDPATH
+_ORDERBY.fields_by_name["path"].message_type = _FIELDPATH
+_CURSOR.fields_by_name["doc_snapshot"].message_type = _DOCSNAPSHOT
+_LISTENTEST.fields_by_name[
+    "responses"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_firestore__pb2._LISTENRESPONSE
+)
+_LISTENTEST.fields_by_name["snapshots"].message_type = _SNAPSHOT
+_SNAPSHOT.fields_by_name[
+    "docs"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_SNAPSHOT.fields_by_name["changes"].message_type = _DOCCHANGE
+_SNAPSHOT.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCCHANGE.fields_by_name["kind"].enum_type = _DOCCHANGE_KIND
+_DOCCHANGE.fields_by_name[
+    "doc"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_DOCCHANGE_KIND.containing_type = _DOCCHANGE
+DESCRIPTOR.message_types_by_name["TestSuite"] = _TESTSUITE
+DESCRIPTOR.message_types_by_name["Test"] = _TEST
+DESCRIPTOR.message_types_by_name["GetTest"] = _GETTEST
+DESCRIPTOR.message_types_by_name["CreateTest"] = _CREATETEST
+DESCRIPTOR.message_types_by_name["SetTest"] = _SETTEST
+DESCRIPTOR.message_types_by_name["UpdateTest"] = _UPDATETEST
+DESCRIPTOR.message_types_by_name["UpdatePathsTest"] = _UPDATEPATHSTEST
+DESCRIPTOR.message_types_by_name["DeleteTest"] = _DELETETEST
+DESCRIPTOR.message_types_by_name["SetOption"] = _SETOPTION
+DESCRIPTOR.message_types_by_name["QueryTest"] = _QUERYTEST
+DESCRIPTOR.message_types_by_name["Clause"] = _CLAUSE
+DESCRIPTOR.message_types_by_name["Select"] = _SELECT
+DESCRIPTOR.message_types_by_name["Where"] = _WHERE
+DESCRIPTOR.message_types_by_name["OrderBy"] = _ORDERBY
+DESCRIPTOR.message_types_by_name["Cursor"] = _CURSOR
+DESCRIPTOR.message_types_by_name["DocSnapshot"] = _DOCSNAPSHOT
+DESCRIPTOR.message_types_by_name["FieldPath"] = _FIELDPATH
+DESCRIPTOR.message_types_by_name["ListenTest"] = _LISTENTEST
+DESCRIPTOR.message_types_by_name["Snapshot"] = _SNAPSHOT
+DESCRIPTOR.message_types_by_name["DocChange"] = _DOCCHANGE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TestSuite = _reflection.GeneratedProtocolMessageType(
+    "TestSuite",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TESTSUITE,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.TestSuite)
+    ),
+)
+_sym_db.RegisterMessage(TestSuite)
+
+Test = _reflection.GeneratedProtocolMessageType(
+    "Test",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.Test)
+    ),
+)
+_sym_db.RegisterMessage(Test)
+
+GetTest = _reflection.GeneratedProtocolMessageType(
+    "GetTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.GetTest)
+    ),
+)
+_sym_db.RegisterMessage(GetTest)
+
+CreateTest = _reflection.GeneratedProtocolMessageType(
+    "CreateTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.CreateTest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTest)
+
+SetTest = _reflection.GeneratedProtocolMessageType(
+    "SetTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETTEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.SetTest)
+    ),
+)
+_sym_db.RegisterMessage(SetTest)
+
+UpdateTest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.UpdateTest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTest)
+
+UpdatePathsTest = _reflection.GeneratedProtocolMessageType(
+    "UpdatePathsTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPATHSTEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.UpdatePathsTest)
+    ),
+)
+_sym_db.RegisterMessage(UpdatePathsTest)
+
+DeleteTest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.DeleteTest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTest)
+
+SetOption = _reflection.GeneratedProtocolMessageType(
+    "SetOption",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETOPTION,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.SetOption)
+    ),
+)
+_sym_db.RegisterMessage(SetOption)
+
+QueryTest = _reflection.GeneratedProtocolMessageType(
+    "QueryTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYTEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.QueryTest)
+    ),
+)
+_sym_db.RegisterMessage(QueryTest)
+
+Clause = _reflection.GeneratedProtocolMessageType(
+    "Clause",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLAUSE,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.Clause)
+    ),
+)
+_sym_db.RegisterMessage(Clause)
+
+Select = _reflection.GeneratedProtocolMessageType(
+    "Select",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SELECT,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.Select)
+    ),
+)
+_sym_db.RegisterMessage(Select)
+
+Where = _reflection.GeneratedProtocolMessageType(
+    "Where",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WHERE,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.Where)
+    ),
+)
+_sym_db.RegisterMessage(Where)
+
+OrderBy = _reflection.GeneratedProtocolMessageType(
+    "OrderBy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ORDERBY,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.OrderBy)
+    ),
+)
+_sym_db.RegisterMessage(OrderBy)
+
+Cursor = _reflection.GeneratedProtocolMessageType(
+    "Cursor",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CURSOR,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.Cursor)
+    ),
+)
+_sym_db.RegisterMessage(Cursor)
+
+DocSnapshot = _reflection.GeneratedProtocolMessageType(
+    "DocSnapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCSNAPSHOT,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.DocSnapshot)
+    ),
+)
+_sym_db.RegisterMessage(DocSnapshot)
+
+FieldPath = _reflection.GeneratedProtocolMessageType(
+    "FieldPath",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FIELDPATH,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.FieldPath)
+    ),
+)
+_sym_db.RegisterMessage(FieldPath)
+
+ListenTest = _reflection.GeneratedProtocolMessageType(
+    "ListenTest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTENTEST,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.ListenTest)
+    ),
+)
+_sym_db.RegisterMessage(ListenTest)
+
+Snapshot = _reflection.GeneratedProtocolMessageType(
+    "Snapshot",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SNAPSHOT,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.Snapshot)
+    ),
+)
+_sym_db.RegisterMessage(Snapshot)
+
+DocChange = _reflection.GeneratedProtocolMessageType(
+    "DocChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCCHANGE,
+        __module__="test_v1beta1_pb2"
+        # @@protoc_insertion_point(class_scope:tests.v1beta1.DocChange)
+    ),
+)
+_sym_db.RegisterMessage(DocChange)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        '\n&com.google.cloud.firestore.conformance\252\002"Google.Cloud.Firestore.Tests.Proto\312\002(Google\\Cloud\\Firestore\\Tests\\Conformance'
+    ),
+)
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/write.proto b/firestore/google/cloud/firestore_v1beta1/proto/write.proto
new file mode 100644
index 000000000000..4e58cc1216e1
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/write.proto
@@ -0,0 +1,255 @@
+// 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.firestore.v1beta1;
+
+import "google/firestore/v1beta1/common.proto";
+import "google/firestore/v1beta1/document.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Firestore.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/firestore/v1beta1;firestore";
+option java_multiple_files = true;
+option java_outer_classname = "WriteProto";
+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.
+  oneof operation {
+    // A document to write.
+    Document update = 1;
+
+    // A document name to delete. In the format:
+    // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
+    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;
+  }
+
+  // The fields to update in this write.
+  //
+  // This field can be set only when the operation is `update`.
+  // If the mask is not set for an `update` and the document exists, any
+  // existing data will be overwritten.
+  // If the mask is set and the document on the server has fields not covered by
+  // the mask, they are left unchanged.
+  // Fields referenced in the mask, but not present in the input document, are
+  // deleted from the document on the server.
+  // The field paths in this mask must not contain a reserved field name.
+  DocumentMask update_mask = 3;
+
+  // An optional precondition on the document.
+  //
+  // The write will fail if this is set and not met by the target document.
+  Precondition current_document = 4;
+}
+
+// A transformation of a document.
+message DocumentTransform {
+  // A transformation of a field of the document.
+  message FieldTransform {
+    // A value that is calculated by the server.
+    enum ServerValue {
+      // Unspecified. This value must not be used.
+      SERVER_VALUE_UNSPECIFIED = 0;
+
+      // The time at which the server processed the request, with millisecond
+      // precision.
+      REQUEST_TIME = 1;
+    }
+
+    // The path of the field. See [Document.fields][google.firestore.v1beta1.Document.fields] for the field path syntax
+    // reference.
+    string field_path = 1;
+
+    // The transformation to apply on the field.
+    oneof transform_type {
+      // Sets the field to the given server value.
+      ServerValue set_to_server_value = 2;
+
+      // Adds the given value to the field's current value.
+      //
+      // This must be an integer or a double value.
+      // If the field is not an integer or double, or if the field does not yet
+      // exist, the transformation will set the field to the given value.
+      // If either of the given value or the current field value are doubles,
+      // both values will be interpreted as doubles. Double arithmetic and
+      // representation of double values follow IEEE 754 semantics.
+      // If there is positive/negative integer overflow, the field is resolved
+      // to the largest magnitude positive/negative integer.
+      Value increment = 3;
+
+      // Sets the field to the maximum of its current value and the given value.
+      //
+      // This must be an integer or a double value.
+      // If the field is not an integer or double, or if the field does not yet
+      // exist, the transformation will set the field to the given value.
+      // If a maximum operation is applied where the field and the input value
+      // are of mixed types (that is - one is an integer and one is a double)
+      // the field takes on the type of the larger operand. If the operands are
+      // equivalent (e.g. 3 and 3.0), the field does not change.
+      // 0, 0.0, and -0.0 are all zero. The maximum of a zero stored value and
+      // zero input value is always the stored value.
+      // The maximum of any numeric value x and NaN is NaN.
+      Value maximum = 4;
+
+      // Sets the field to the minimum of its current value and the given value.
+      //
+      // This must be an integer or a double value.
+      // If the field is not an integer or double, or if the field does not yet
+      // exist, the transformation will set the field to the input value.
+      // If a minimum operation is applied where the field and the input value
+      // are of mixed types (that is - one is an integer and one is a double)
+      // the field takes on the type of the smaller operand. If the operands are
+      // equivalent (e.g. 3 and 3.0), the field does not change.
+      // 0, 0.0, and -0.0 are all zero. The minimum of a zero stored value and
+      // zero input value is always the stored value.
+      // The minimum of any numeric value x and NaN is NaN.
+      Value minimum = 5;
+
+      // Append the given elements in order if they are not already present in
+      // the current field value.
+      // If the field is not an array, or if the field does not yet exist, it is
+      // first set to the empty array.
+      //
+      // Equivalent numbers of different types (e.g. 3L and 3.0) are
+      // considered equal when checking if a value is missing.
+      // NaN is equal to NaN, and Null is equal to Null.
+      // If the input contains multiple equivalent values, only the first will
+      // be considered.
+      //
+      // The corresponding transform_result will be the null value.
+      ArrayValue append_missing_elements = 6;
+
+      // Remove all of the given elements from the array in the field.
+      // If the field is not an array, or if the field does not yet exist, it is
+      // set to the empty array.
+      //
+      // Equivalent numbers of the different types (e.g. 3L and 3.0) are
+      // considered equal when deciding whether an element should be removed.
+      // NaN is equal to NaN, and Null is equal to Null.
+      // This will remove all equivalent values if there are duplicates.
+      //
+      // The corresponding transform_result will be the null value.
+      ArrayValue remove_all_from_array = 7;
+    }
+  }
+
+  // The name of the document to transform.
+  string document = 1;
+
+  // The list of transformations to apply to the fields of the document, in
+  // order.
+  // This must not be empty.
+  repeated FieldTransform field_transforms = 2;
+}
+
+// The result of applying a write.
+message WriteResult {
+  // The last update time of the document after applying the write. Not set
+  // after a `delete`.
+  //
+  // If the write did not actually change the document, this will be the
+  // previous update_time.
+  google.protobuf.Timestamp update_time = 1;
+
+  // The results of applying each [DocumentTransform.FieldTransform][google.firestore.v1beta1.DocumentTransform.FieldTransform], in the
+  // same order.
+  repeated Value transform_results = 2;
+}
+
+// A [Document][google.firestore.v1beta1.Document] has changed.
+//
+// May be the result of multiple [writes][google.firestore.v1beta1.Write], including deletes, that
+// ultimately resulted in a new value for the [Document][google.firestore.v1beta1.Document].
+//
+// Multiple [DocumentChange][google.firestore.v1beta1.DocumentChange] messages may be returned for the same logical
+// change, if multiple targets are affected.
+message DocumentChange {
+  // The new state of the [Document][google.firestore.v1beta1.Document].
+  //
+  // If `mask` is set, contains only fields that were updated or added.
+  Document document = 1;
+
+  // A set of target IDs of targets that match this document.
+  repeated int32 target_ids = 5;
+
+  // A set of target IDs for targets that no longer match this document.
+  repeated int32 removed_target_ids = 6;
+}
+
+// A [Document][google.firestore.v1beta1.Document] has been deleted.
+//
+// May be the result of multiple [writes][google.firestore.v1beta1.Write], including updates, the
+// last of which deleted the [Document][google.firestore.v1beta1.Document].
+//
+// Multiple [DocumentDelete][google.firestore.v1beta1.DocumentDelete] messages may be returned for the same logical
+// delete, if multiple targets are affected.
+message DocumentDelete {
+  // The resource name of the [Document][google.firestore.v1beta1.Document] that was deleted.
+  string document = 1;
+
+  // A set of target IDs for targets that previously matched this entity.
+  repeated int32 removed_target_ids = 6;
+
+  // The read timestamp at which the delete was observed.
+  //
+  // Greater or equal to the `commit_time` of the delete.
+  google.protobuf.Timestamp read_time = 4;
+}
+
+// A [Document][google.firestore.v1beta1.Document] has been removed from the view of the targets.
+//
+// Sent if the document is no longer relevant to a target and is out of view.
+// Can be sent instead of a DocumentDelete or a DocumentChange if the server
+// can not send the new value of the document.
+//
+// Multiple [DocumentRemove][google.firestore.v1beta1.DocumentRemove] messages may be returned for the same logical
+// write or delete, if multiple targets are affected.
+message DocumentRemove {
+  // The resource name of the [Document][google.firestore.v1beta1.Document] that has gone out of view.
+  string document = 1;
+
+  // A set of target IDs for targets that previously matched this document.
+  repeated int32 removed_target_ids = 2;
+
+  // The read timestamp at which the remove was observed.
+  //
+  // Greater or equal to the `commit_time` of the change/delete/remove.
+  google.protobuf.Timestamp read_time = 4;
+}
+
+// A digest of all the documents that match a given target.
+message ExistenceFilter {
+  // The target ID to which this filter applies.
+  int32 target_id = 1;
+
+  // The total count of documents that match [target_id][google.firestore.v1beta1.ExistenceFilter.target_id].
+  //
+  // If different from the count of documents in the client that match, the
+  // client must manually determine which documents no longer match the target.
+  int32 count = 2;
+}
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/write_pb2.py b/firestore/google/cloud/firestore_v1beta1/proto/write_pb2.py
new file mode 100644
index 000000000000..2153e4c21207
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/write_pb2.py
@@ -0,0 +1,1154 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/firestore_v1beta1/proto/write.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.firestore_v1beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.firestore_v1beta1.proto import (
+    document_pb2 as google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/firestore_v1beta1/proto/write.proto",
+    package="google.firestore.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.firestore.v1beta1B\nWriteProtoP\001ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\242\002\004GCFS\252\002\036Google.Cloud.Firestore.V1Beta1\312\002\036Google\\Cloud\\Firestore\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/firestore_v1beta1/proto/write.proto\x12\x18google.firestore.v1beta1\x1a\x31google/cloud/firestore_v1beta1/proto/common.proto\x1a\x33google/cloud/firestore_v1beta1/proto/document.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\x9d\x02\n\x05Write\x12\x34\n\x06update\x18\x01 \x01(\x0b\x32".google.firestore.v1beta1.DocumentH\x00\x12\x10\n\x06\x64\x65lete\x18\x02 \x01(\tH\x00\x12@\n\ttransform\x18\x06 \x01(\x0b\x32+.google.firestore.v1beta1.DocumentTransformH\x00\x12;\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32&.google.firestore.v1beta1.DocumentMask\x12@\n\x10\x63urrent_document\x18\x04 \x01(\x0b\x32&.google.firestore.v1beta1.PreconditionB\x0b\n\toperation"\x88\x05\n\x11\x44ocumentTransform\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12T\n\x10\x66ield_transforms\x18\x02 \x03(\x0b\x32:.google.firestore.v1beta1.DocumentTransform.FieldTransform\x1a\x8a\x04\n\x0e\x46ieldTransform\x12\x12\n\nfield_path\x18\x01 \x01(\t\x12\x65\n\x13set_to_server_value\x18\x02 \x01(\x0e\x32\x46.google.firestore.v1beta1.DocumentTransform.FieldTransform.ServerValueH\x00\x12\x34\n\tincrement\x18\x03 \x01(\x0b\x32\x1f.google.firestore.v1beta1.ValueH\x00\x12\x32\n\x07maximum\x18\x04 \x01(\x0b\x32\x1f.google.firestore.v1beta1.ValueH\x00\x12\x32\n\x07minimum\x18\x05 \x01(\x0b\x32\x1f.google.firestore.v1beta1.ValueH\x00\x12G\n\x17\x61ppend_missing_elements\x18\x06 \x01(\x0b\x32$.google.firestore.v1beta1.ArrayValueH\x00\x12\x45\n\x15remove_all_from_array\x18\x07 \x01(\x0b\x32$.google.firestore.v1beta1.ArrayValueH\x00"=\n\x0bServerValue\x12\x1c\n\x18SERVER_VALUE_UNSPECIFIED\x10\x00\x12\x10\n\x0cREQUEST_TIME\x10\x01\x42\x10\n\x0etransform_type"z\n\x0bWriteResult\x12/\n\x0bupdate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12:\n\x11transform_results\x18\x02 \x03(\x0b\x32\x1f.google.firestore.v1beta1.Value"v\n\x0e\x44ocumentChange\x12\x34\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.firestore.v1beta1.Document\x12\x12\n\ntarget_ids\x18\x05 \x03(\x05\x12\x1a\n\x12removed_target_ids\x18\x06 \x03(\x05"m\n\x0e\x44ocumentDelete\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12\x1a\n\x12removed_target_ids\x18\x06 \x03(\x05\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"m\n\x0e\x44ocumentRemove\x12\x10\n\x08\x64ocument\x18\x01 \x01(\t\x12\x1a\n\x12removed_target_ids\x18\x02 \x03(\x05\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"3\n\x0f\x45xistenceFilter\x12\x11\n\ttarget_id\x18\x01 \x01(\x05\x12\r\n\x05\x63ount\x18\x02 \x01(\x05\x42\xb8\x01\n\x1c\x63om.google.firestore.v1beta1B\nWriteProtoP\x01ZAgoogle.golang.org/genproto/googleapis/firestore/v1beta1;firestore\xa2\x02\x04GCFS\xaa\x02\x1eGoogle.Cloud.Firestore.V1Beta1\xca\x02\x1eGoogle\\Cloud\\Firestore\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE = _descriptor.EnumDescriptor(
+    name="ServerValue",
+    full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.ServerValue",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SERVER_VALUE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REQUEST_TIME", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1103,
+    serialized_end=1164,
+)
+_sym_db.RegisterEnumDescriptor(_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE)
+
+
+_WRITE = _descriptor.Descriptor(
+    name="Write",
+    full_name="google.firestore.v1beta1.Write",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.firestore.v1beta1.Write.update",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="google.firestore.v1beta1.Write.delete",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transform",
+            full_name="google.firestore.v1beta1.Write.transform",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.firestore.v1beta1.Write.update_mask",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_document",
+            full_name="google.firestore.v1beta1.Write.current_document",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="operation",
+            full_name="google.firestore.v1beta1.Write.operation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=246,
+    serialized_end=531,
+)
+
+
+_DOCUMENTTRANSFORM_FIELDTRANSFORM = _descriptor.Descriptor(
+    name="FieldTransform",
+    full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="field_path",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.field_path",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="set_to_server_value",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.set_to_server_value",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="increment",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.increment",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maximum",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.maximum",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="minimum",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.minimum",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="append_missing_elements",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.append_missing_elements",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remove_all_from_array",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.remove_all_from_array",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transform_type",
+            full_name="google.firestore.v1beta1.DocumentTransform.FieldTransform.transform_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=660,
+    serialized_end=1182,
+)
+
+_DOCUMENTTRANSFORM = _descriptor.Descriptor(
+    name="DocumentTransform",
+    full_name="google.firestore.v1beta1.DocumentTransform",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.DocumentTransform.document",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_transforms",
+            full_name="google.firestore.v1beta1.DocumentTransform.field_transforms",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DOCUMENTTRANSFORM_FIELDTRANSFORM],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=534,
+    serialized_end=1182,
+)
+
+
+_WRITERESULT = _descriptor.Descriptor(
+    name="WriteResult",
+    full_name="google.firestore.v1beta1.WriteResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.firestore.v1beta1.WriteResult.update_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transform_results",
+            full_name="google.firestore.v1beta1.WriteResult.transform_results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1184,
+    serialized_end=1306,
+)
+
+
+_DOCUMENTCHANGE = _descriptor.Descriptor(
+    name="DocumentChange",
+    full_name="google.firestore.v1beta1.DocumentChange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.DocumentChange.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_ids",
+            full_name="google.firestore.v1beta1.DocumentChange.target_ids",
+            index=1,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removed_target_ids",
+            full_name="google.firestore.v1beta1.DocumentChange.removed_target_ids",
+            index=2,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1308,
+    serialized_end=1426,
+)
+
+
+_DOCUMENTDELETE = _descriptor.Descriptor(
+    name="DocumentDelete",
+    full_name="google.firestore.v1beta1.DocumentDelete",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.DocumentDelete.document",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removed_target_ids",
+            full_name="google.firestore.v1beta1.DocumentDelete.removed_target_ids",
+            index=1,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.DocumentDelete.read_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1428,
+    serialized_end=1537,
+)
+
+
+_DOCUMENTREMOVE = _descriptor.Descriptor(
+    name="DocumentRemove",
+    full_name="google.firestore.v1beta1.DocumentRemove",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.firestore.v1beta1.DocumentRemove.document",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removed_target_ids",
+            full_name="google.firestore.v1beta1.DocumentRemove.removed_target_ids",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.firestore.v1beta1.DocumentRemove.read_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1539,
+    serialized_end=1648,
+)
+
+
+_EXISTENCEFILTER = _descriptor.Descriptor(
+    name="ExistenceFilter",
+    full_name="google.firestore.v1beta1.ExistenceFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="target_id",
+            full_name="google.firestore.v1beta1.ExistenceFilter.target_id",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.firestore.v1beta1.ExistenceFilter.count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1650,
+    serialized_end=1701,
+)
+
+_WRITE.fields_by_name[
+    "update"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_WRITE.fields_by_name["transform"].message_type = _DOCUMENTTRANSFORM
+_WRITE.fields_by_name[
+    "update_mask"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._DOCUMENTMASK
+)
+_WRITE.fields_by_name[
+    "current_document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_common__pb2._PRECONDITION
+)
+_WRITE.oneofs_by_name["operation"].fields.append(_WRITE.fields_by_name["update"])
+_WRITE.fields_by_name["update"].containing_oneof = _WRITE.oneofs_by_name["operation"]
+_WRITE.oneofs_by_name["operation"].fields.append(_WRITE.fields_by_name["delete"])
+_WRITE.fields_by_name["delete"].containing_oneof = _WRITE.oneofs_by_name["operation"]
+_WRITE.oneofs_by_name["operation"].fields.append(_WRITE.fields_by_name["transform"])
+_WRITE.fields_by_name["transform"].containing_oneof = _WRITE.oneofs_by_name["operation"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "set_to_server_value"
+].enum_type = _DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "increment"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._VALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "maximum"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._VALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "minimum"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._VALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "append_missing_elements"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._ARRAYVALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "remove_all_from_array"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._ARRAYVALUE
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.containing_type = _DOCUMENTTRANSFORM
+_DOCUMENTTRANSFORM_FIELDTRANSFORM_SERVERVALUE.containing_type = (
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["set_to_server_value"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "set_to_server_value"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["increment"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "increment"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["maximum"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "maximum"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["minimum"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "minimum"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["append_missing_elements"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "append_missing_elements"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"].fields.append(
+    _DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name["remove_all_from_array"]
+)
+_DOCUMENTTRANSFORM_FIELDTRANSFORM.fields_by_name[
+    "remove_all_from_array"
+].containing_oneof = _DOCUMENTTRANSFORM_FIELDTRANSFORM.oneofs_by_name["transform_type"]
+_DOCUMENTTRANSFORM.fields_by_name[
+    "field_transforms"
+].message_type = _DOCUMENTTRANSFORM_FIELDTRANSFORM
+_WRITERESULT.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_WRITERESULT.fields_by_name[
+    "transform_results"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._VALUE
+)
+_DOCUMENTCHANGE.fields_by_name[
+    "document"
+].message_type = (
+    google_dot_cloud_dot_firestore__v1beta1_dot_proto_dot_document__pb2._DOCUMENT
+)
+_DOCUMENTDELETE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DOCUMENTREMOVE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["Write"] = _WRITE
+DESCRIPTOR.message_types_by_name["DocumentTransform"] = _DOCUMENTTRANSFORM
+DESCRIPTOR.message_types_by_name["WriteResult"] = _WRITERESULT
+DESCRIPTOR.message_types_by_name["DocumentChange"] = _DOCUMENTCHANGE
+DESCRIPTOR.message_types_by_name["DocumentDelete"] = _DOCUMENTDELETE
+DESCRIPTOR.message_types_by_name["DocumentRemove"] = _DOCUMENTREMOVE
+DESCRIPTOR.message_types_by_name["ExistenceFilter"] = _EXISTENCEFILTER
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Write = _reflection.GeneratedProtocolMessageType(
+    "Write",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITE,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""A write on a document.
+  
+  
+  Attributes:
+      operation:
+          The operation to execute.
+      update:
+          A document to write.
+      delete:
+          A document name to delete. In the format: ``projects/{project_
+          id}/databases/{database_id}/documents/{document_path}``.
+      transform:
+          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.
+      update_mask:
+          The fields to update in this write.  This field can be set
+          only when the operation is ``update``. If the mask is not set
+          for an ``update`` and the document exists, any existing data
+          will be overwritten. If the mask is set and the document on
+          the server has fields not covered by the mask, they are left
+          unchanged. Fields referenced in the mask, but not present in
+          the input document, are deleted from the document on the
+          server. The field paths in this mask must not contain a
+          reserved field name.
+      current_document:
+          An optional precondition on the document.  The write will fail
+          if this is set and not met by the target document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.Write)
+    ),
+)
+_sym_db.RegisterMessage(Write)
+
+DocumentTransform = _reflection.GeneratedProtocolMessageType(
+    "DocumentTransform",
+    (_message.Message,),
+    dict(
+        FieldTransform=_reflection.GeneratedProtocolMessageType(
+            "FieldTransform",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DOCUMENTTRANSFORM_FIELDTRANSFORM,
+                __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+                __doc__="""A transformation of a field of the document.
+    
+    
+    Attributes:
+        field_path:
+            The path of the field. See
+            [Document.fields][google.firestore.v1beta1.Document.fields]
+            for the field path syntax reference.
+        transform_type:
+            The transformation to apply on the field.
+        set_to_server_value:
+            Sets the field to the given server value.
+        increment:
+            Adds the given value to the field's current value.  This must
+            be an integer or a double value. If the field is not an
+            integer or double, or if the field does not yet exist, the
+            transformation will set the field to the given value. If
+            either of the given value or the current field value are
+            doubles, both values will be interpreted as doubles. Double
+            arithmetic and representation of double values follow IEEE 754
+            semantics. If there is positive/negative integer overflow, the
+            field is resolved to the largest magnitude positive/negative
+            integer.
+        maximum:
+            Sets the field to the maximum of its current value and the
+            given value.  This must be an integer or a double value. If
+            the field is not an integer or double, or if the field does
+            not yet exist, the transformation will set the field to the
+            given value. If a maximum operation is applied where the field
+            and the input value are of mixed types (that is - one is an
+            integer and one is a double) the field takes on the type of
+            the larger operand. If the operands are equivalent (e.g. 3 and
+            3.0), the field does not change. 0, 0.0, and -0.0 are all
+            zero. The maximum of a zero stored value and zero input value
+            is always the stored value. The maximum of any numeric value x
+            and NaN is NaN.
+        minimum:
+            Sets the field to the minimum of its current value and the
+            given value.  This must be an integer or a double value. If
+            the field is not an integer or double, or if the field does
+            not yet exist, the transformation will set the field to the
+            input value. If a minimum operation is applied where the field
+            and the input value are of mixed types (that is - one is an
+            integer and one is a double) the field takes on the type of
+            the smaller operand. If the operands are equivalent (e.g. 3
+            and 3.0), the field does not change. 0, 0.0, and -0.0 are all
+            zero. The minimum of a zero stored value and zero input value
+            is always the stored value. The minimum of any numeric value x
+            and NaN is NaN.
+        append_missing_elements:
+            Append the given elements in order if they are not already
+            present in the current field value. If the field is not an
+            array, or if the field does not yet exist, it is first set to
+            the empty array.  Equivalent numbers of different types (e.g.
+            3L and 3.0) are considered equal when checking if a value is
+            missing. NaN is equal to NaN, and Null is equal to Null. If
+            the input contains multiple equivalent values, only the first
+            will be considered.  The corresponding transform\_result will
+            be the null value.
+        remove_all_from_array:
+            Remove all of the given elements from the array in the field.
+            If the field is not an array, or if the field does not yet
+            exist, it is set to the empty array.  Equivalent numbers of
+            the different types (e.g. 3L and 3.0) are considered equal
+            when deciding whether an element should be removed. NaN is
+            equal to NaN, and Null is equal to Null. This will remove all
+            equivalent values if there are duplicates.  The corresponding
+            transform\_result will be the null value.
+    """,
+                # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DocumentTransform.FieldTransform)
+            ),
+        ),
+        DESCRIPTOR=_DOCUMENTTRANSFORM,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""A transformation of a document.
+  
+  
+  Attributes:
+      document:
+          The name of the document to transform.
+      field_transforms:
+          The list of transformations to apply to the fields of the
+          document, in order. This must not be empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DocumentTransform)
+    ),
+)
+_sym_db.RegisterMessage(DocumentTransform)
+_sym_db.RegisterMessage(DocumentTransform.FieldTransform)
+
+WriteResult = _reflection.GeneratedProtocolMessageType(
+    "WriteResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITERESULT,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""The result of applying a write.
+  
+  
+  Attributes:
+      update_time:
+          The last update time of the document after applying the write.
+          Not set after a ``delete``.  If the write did not actually
+          change the document, this will be the previous update\_time.
+      transform_results:
+          The results of applying each [DocumentTransform.FieldTransform
+          ][google.firestore.v1beta1.DocumentTransform.FieldTransform],
+          in the same order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.WriteResult)
+    ),
+)
+_sym_db.RegisterMessage(WriteResult)
+
+DocumentChange = _reflection.GeneratedProtocolMessageType(
+    "DocumentChange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTCHANGE,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""A [Document][google.firestore.v1beta1.Document] has changed.
+  
+  May be the result of multiple [writes][google.firestore.v1beta1.Write],
+  including deletes, that ultimately resulted in a new value for the
+  [Document][google.firestore.v1beta1.Document].
+  
+  Multiple [DocumentChange][google.firestore.v1beta1.DocumentChange]
+  messages may be returned for the same logical change, if multiple
+  targets are affected.
+  
+  
+  Attributes:
+      document:
+          The new state of the
+          [Document][google.firestore.v1beta1.Document].  If ``mask`` is
+          set, contains only fields that were updated or added.
+      target_ids:
+          A set of target IDs of targets that match this document.
+      removed_target_ids:
+          A set of target IDs for targets that no longer match this
+          document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DocumentChange)
+    ),
+)
+_sym_db.RegisterMessage(DocumentChange)
+
+DocumentDelete = _reflection.GeneratedProtocolMessageType(
+    "DocumentDelete",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTDELETE,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""A [Document][google.firestore.v1beta1.Document] has been deleted.
+  
+  May be the result of multiple [writes][google.firestore.v1beta1.Write],
+  including updates, the last of which deleted the
+  [Document][google.firestore.v1beta1.Document].
+  
+  Multiple [DocumentDelete][google.firestore.v1beta1.DocumentDelete]
+  messages may be returned for the same logical delete, if multiple
+  targets are affected.
+  
+  
+  Attributes:
+      document:
+          The resource name of the
+          [Document][google.firestore.v1beta1.Document] that was
+          deleted.
+      removed_target_ids:
+          A set of target IDs for targets that previously matched this
+          entity.
+      read_time:
+          The read timestamp at which the delete was observed.  Greater
+          or equal to the ``commit_time`` of the delete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DocumentDelete)
+    ),
+)
+_sym_db.RegisterMessage(DocumentDelete)
+
+DocumentRemove = _reflection.GeneratedProtocolMessageType(
+    "DocumentRemove",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENTREMOVE,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""A [Document][google.firestore.v1beta1.Document] has been removed from
+  the view of the targets.
+  
+  Sent if the document is no longer relevant to a target and is out of
+  view. Can be sent instead of a DocumentDelete or a DocumentChange if the
+  server can not send the new value of the document.
+  
+  Multiple [DocumentRemove][google.firestore.v1beta1.DocumentRemove]
+  messages may be returned for the same logical write or delete, if
+  multiple targets are affected.
+  
+  
+  Attributes:
+      document:
+          The resource name of the
+          [Document][google.firestore.v1beta1.Document] that has gone
+          out of view.
+      removed_target_ids:
+          A set of target IDs for targets that previously matched this
+          document.
+      read_time:
+          The read timestamp at which the remove was observed.  Greater
+          or equal to the ``commit_time`` of the change/delete/remove.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.DocumentRemove)
+    ),
+)
+_sym_db.RegisterMessage(DocumentRemove)
+
+ExistenceFilter = _reflection.GeneratedProtocolMessageType(
+    "ExistenceFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXISTENCEFILTER,
+        __module__="google.cloud.firestore_v1beta1.proto.write_pb2",
+        __doc__="""A digest of all the documents that match a given target.
+  
+  
+  Attributes:
+      target_id:
+          The target ID to which this filter applies.
+      count:
+          The total count of documents that match [target\_id][google.fi
+          restore.v1beta1.ExistenceFilter.target\_id].  If different
+          from the count of documents in the client that match, the
+          client must manually determine which documents no longer match
+          the target.
+  """,
+        # @@protoc_insertion_point(class_scope:google.firestore.v1beta1.ExistenceFilter)
+    ),
+)
+_sym_db.RegisterMessage(ExistenceFilter)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/firestore/google/cloud/firestore_v1beta1/proto/write_pb2_grpc.py b/firestore/google/cloud/firestore_v1beta1/proto/write_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/proto/write_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/firestore/google/cloud/firestore_v1beta1/query.py b/firestore/google/cloud/firestore_v1beta1/query.py
new file mode 100644
index 000000000000..70dafb055760
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/query.py
@@ -0,0 +1,971 @@
+# Copyright 2017 Google LLC 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.
+
+"""Classes for representing queries for the Google Cloud Firestore API.
+
+A :class:`~google.cloud.firestore_v1beta1.query.Query` can be created directly
+from a :class:`~google.cloud.firestore_v1beta1.collection.Collection`,
+and that can be a more common way to create a query than direct usage of the
+constructor.
+"""
+import copy
+import math
+import warnings
+
+from google.protobuf import wrappers_pb2
+import six
+
+from google.cloud.firestore_v1beta1 import _helpers
+from google.cloud.firestore_v1beta1 import document
+from google.cloud.firestore_v1beta1 import field_path as field_path_module
+from google.cloud.firestore_v1beta1 import transforms
+from google.cloud.firestore_v1beta1.gapic import enums
+from google.cloud.firestore_v1beta1.proto import query_pb2
+from google.cloud.firestore_v1beta1.order import Order
+from google.cloud.firestore_v1beta1.watch import Watch
+
+_EQ_OP = "=="
+_operator_enum = enums.StructuredQuery.FieldFilter.Operator
+_COMPARISON_OPERATORS = {
+    "<": _operator_enum.LESS_THAN,
+    "<=": _operator_enum.LESS_THAN_OR_EQUAL,
+    _EQ_OP: _operator_enum.EQUAL,
+    ">=": _operator_enum.GREATER_THAN_OR_EQUAL,
+    ">": _operator_enum.GREATER_THAN,
+    "array_contains": _operator_enum.ARRAY_CONTAINS,
+}
+_BAD_OP_STRING = "Operator string {!r} is invalid. Valid choices are: {}."
+_BAD_OP_NAN_NULL = 'Only an equality filter ("==") can be used with None or NaN values'
+_INVALID_WHERE_TRANSFORM = "Transforms cannot be used as where values."
+_BAD_DIR_STRING = "Invalid direction {!r}. Must be one of {!r} or {!r}."
+_INVALID_CURSOR_TRANSFORM = "Transforms cannot be used as cursor values."
+_MISSING_ORDER_BY = (
+    'The "order by" field path {!r} is not present in the cursor data {!r}. '
+    "All fields sent to ``order_by()`` must be present in the fields "
+    "if passed to one of ``start_at()`` / ``start_after()`` / "
+    "``end_before()`` / ``end_at()`` to define a cursor."
+)
+_NO_ORDERS_FOR_CURSOR = (
+    "Attempting to create a cursor with no fields to order on. "
+    "When defining a cursor with one of ``start_at()`` / ``start_after()`` / "
+    "``end_before()`` / ``end_at()``, all fields in the cursor must "
+    "come from fields set in ``order_by()``."
+)
+_MISMATCH_CURSOR_W_ORDER_BY = "The cursor {!r} does not match the order fields {!r}."
+
+
+class Query(object):
+    """Represents a query to the Firestore API.
+
+    Instances of this class are considered immutable: all methods that
+    would modify an instance instead return a new instance.
+
+    Args:
+        parent (~.firestore_v1beta1.collection.Collection): The collection
+            that this query applies to.
+        projection (Optional[google.cloud.proto.firestore.v1beta1.\
+            query_pb2.StructuredQuery.Projection]): A projection of document
+            fields to limit the query results to.
+        field_filters (Optional[Tuple[google.cloud.proto.firestore.v1beta1.\
+            query_pb2.StructuredQuery.FieldFilter, ...]]): The filters to be
+            applied in the query.
+        orders (Optional[Tuple[google.cloud.proto.firestore.v1beta1.\
+            query_pb2.StructuredQuery.Order, ...]]): The "order by" entries
+            to use in the query.
+        limit (Optional[int]): The maximum number of documents the
+            query is allowed to return.
+        offset (Optional[int]): The number of results to skip.
+        start_at (Optional[Tuple[dict, bool]]): Two-tuple of
+
+            * a mapping of fields. Any field that is present in this mapping
+              must also be present in ``orders``
+            * an ``after`` flag
+
+            The fields and the flag combine to form a cursor used as
+            a starting point in a query result set. If the ``after``
+            flag is :data:`True`, the results will start just after any
+            documents which have fields matching the cursor, otherwise
+            any matching documents will be included in the result set.
+            When the query is formed, the document values
+            will be used in the order given by ``orders``.
+        end_at (Optional[Tuple[dict, bool]]): Two-tuple of
+
+            * a mapping of fields. Any field that is present in this mapping
+              must also be present in ``orders``
+            * a ``before`` flag
+
+            The fields and the flag combine to form a cursor used as
+            an ending point in a query result set. If the ``before``
+            flag is :data:`True`, the results will end just before any
+            documents which have fields matching the cursor, otherwise
+            any matching documents will be included in the result set.
+            When the query is formed, the document values
+            will be used in the order given by ``orders``.
+    """
+
+    ASCENDING = "ASCENDING"
+    """str: Sort query results in ascending order on a field."""
+    DESCENDING = "DESCENDING"
+    """str: Sort query results in descending order on a field."""
+
+    def __init__(
+        self,
+        parent,
+        projection=None,
+        field_filters=(),
+        orders=(),
+        limit=None,
+        offset=None,
+        start_at=None,
+        end_at=None,
+    ):
+        self._parent = parent
+        self._projection = projection
+        self._field_filters = field_filters
+        self._orders = orders
+        self._limit = limit
+        self._offset = offset
+        self._start_at = start_at
+        self._end_at = end_at
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (
+            self._parent == other._parent
+            and self._projection == other._projection
+            and self._field_filters == other._field_filters
+            and self._orders == other._orders
+            and self._limit == other._limit
+            and self._offset == other._offset
+            and self._start_at == other._start_at
+            and self._end_at == other._end_at
+        )
+
+    @property
+    def _client(self):
+        """The client of the parent collection.
+
+        Returns:
+            ~.firestore_v1beta1.client.Client: The client that owns
+            this query.
+        """
+        return self._parent._client
+
+    def select(self, field_paths):
+        """Project documents matching query to a limited set of fields.
+
+        See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`
+        for more information on **field paths**.
+
+        If the current query already has a projection set (i.e. has already
+        called :meth:`~google.cloud.firestore_v1beta1.query.Query.select`),
+        this will overwrite it.
+
+        Args:
+            field_paths (Iterable[str, ...]): An iterable of field paths
+                (``.``-delimited list of field names) to use as a projection
+                of document fields in the query results.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A "projected" query. Acts as
+            a copy of the current query, modified with the newly added
+            projection.
+        Raises:
+            ValueError: If any ``field_path`` is invalid.
+        """
+        field_paths = list(field_paths)
+        for field_path in field_paths:
+            field_path_module.split_field_path(field_path)  # raises
+
+        new_projection = query_pb2.StructuredQuery.Projection(
+            fields=[
+                query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                for field_path in field_paths
+            ]
+        )
+        return self.__class__(
+            self._parent,
+            projection=new_projection,
+            field_filters=self._field_filters,
+            orders=self._orders,
+            limit=self._limit,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+        )
+
+    def where(self, field_path, op_string, value):
+        """Filter the query on a field.
+
+        See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`
+        for more information on **field paths**.
+
+        Returns a new :class:`~google.cloud.firestore_v1beta1.query.Query`
+        that filters on a specific field path, according to an operation
+        (e.g.  ``==`` or "equals") and a particular value to be paired with
+        that operation.
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) for the field to filter on.
+            op_string (str): A comparison operation in the form of a string.
+                Acceptable values are ``<``, ``<=``, ``==``, ``>=``
+                and ``>``.
+            value (Any): The value to compare the field against in the filter.
+                If ``value`` is :data:`None` or a NaN, then ``==`` is the only
+                allowed operation.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A filtered query. Acts as a
+            copy of the current query, modified with the newly added filter.
+
+        Raises:
+            ValueError: If ``field_path`` is invalid.
+            ValueError: If ``value`` is a NaN or :data:`None` and
+                ``op_string`` is not ``==``.
+        """
+        field_path_module.split_field_path(field_path)  # raises
+
+        if value is None:
+            if op_string != _EQ_OP:
+                raise ValueError(_BAD_OP_NAN_NULL)
+            filter_pb = query_pb2.StructuredQuery.UnaryFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+                op=enums.StructuredQuery.UnaryFilter.Operator.IS_NULL,
+            )
+        elif _isnan(value):
+            if op_string != _EQ_OP:
+                raise ValueError(_BAD_OP_NAN_NULL)
+            filter_pb = query_pb2.StructuredQuery.UnaryFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+                op=enums.StructuredQuery.UnaryFilter.Operator.IS_NAN,
+            )
+        elif isinstance(value, (transforms.Sentinel, transforms._ValueList)):
+            raise ValueError(_INVALID_WHERE_TRANSFORM)
+        else:
+            filter_pb = query_pb2.StructuredQuery.FieldFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+                op=_enum_from_op_string(op_string),
+                value=_helpers.encode_value(value),
+            )
+
+        new_filters = self._field_filters + (filter_pb,)
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=new_filters,
+            orders=self._orders,
+            limit=self._limit,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+        )
+
+    @staticmethod
+    def _make_order(field_path, direction):
+        """Helper for :meth:`order_by`."""
+        return query_pb2.StructuredQuery.Order(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            direction=_enum_from_direction(direction),
+        )
+
+    def order_by(self, field_path, direction=ASCENDING):
+        """Modify the query to add an order clause on a specific field.
+
+        See :meth:`~google.cloud.firestore_v1beta1.client.Client.field_path`
+        for more information on **field paths**.
+
+        Successive :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by` calls
+        will further refine the ordering of results returned by the query
+        (i.e. the new "order by" fields will be added to existing ones).
+
+        Args:
+            field_path (str): A field path (``.``-delimited list of
+                field names) on which to order the query results.
+            direction (Optional[str]): The direction to order by. Must be one
+                of :attr:`ASCENDING` or :attr:`DESCENDING`, defaults to
+                :attr:`ASCENDING`.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: An ordered query. Acts as a
+            copy of the current query, modified with the newly added
+            "order by" constraint.
+
+        Raises:
+            ValueError: If ``field_path`` is invalid.
+            ValueError: If ``direction`` is not one of :attr:`ASCENDING` or
+                :attr:`DESCENDING`.
+        """
+        field_path_module.split_field_path(field_path)  # raises
+
+        order_pb = self._make_order(field_path, direction)
+
+        new_orders = self._orders + (order_pb,)
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=self._field_filters,
+            orders=new_orders,
+            limit=self._limit,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+        )
+
+    def limit(self, count):
+        """Limit a query to return a fixed number of results.
+
+        If the current query already has a limit set, this will overwrite it.
+
+        Args:
+            count (int): Maximum number of documents to return that match
+                the query.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A limited query. Acts as a
+            copy of the current query, modified with the newly added
+            "limit" filter.
+        """
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=self._field_filters,
+            orders=self._orders,
+            limit=count,
+            offset=self._offset,
+            start_at=self._start_at,
+            end_at=self._end_at,
+        )
+
+    def offset(self, num_to_skip):
+        """Skip to an offset in a query.
+
+        If the current query already has specified an offset, this will
+        overwrite it.
+
+        Args:
+            num_to_skip (int): The number of results to skip at the beginning
+                of query results. (Must be non-negative.)
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: An offset query. Acts as a
+            copy of the current query, modified with the newly added
+            "offset" field.
+        """
+        return self.__class__(
+            self._parent,
+            projection=self._projection,
+            field_filters=self._field_filters,
+            orders=self._orders,
+            limit=self._limit,
+            offset=num_to_skip,
+            start_at=self._start_at,
+            end_at=self._end_at,
+        )
+
+    def _cursor_helper(self, document_fields, before, start):
+        """Set values to be used for a ``start_at`` or ``end_at`` cursor.
+
+        The values will later be used in a query protobuf.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by`.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+            before (bool): Flag indicating if the document in
+                ``document_fields`` should (:data:`False`) or
+                shouldn't (:data:`True`) be included in the result set.
+            start (Optional[bool]): determines if the cursor is a ``start_at``
+                cursor (:data:`True`) or an ``end_at`` cursor (:data:`False`).
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor. Acts as
+            a copy of the current query, modified with the newly added
+            "start at" cursor.
+        """
+        if isinstance(document_fields, tuple):
+            document_fields = list(document_fields)
+        elif isinstance(document_fields, document.DocumentSnapshot):
+            if document_fields.reference._path[:-1] != self._parent._path:
+                raise ValueError(
+                    "Cannot use snapshot from another collection as a cursor."
+                )
+        else:
+            # NOTE: We copy so that the caller can't modify after calling.
+            document_fields = copy.deepcopy(document_fields)
+
+        cursor_pair = document_fields, before
+        query_kwargs = {
+            "projection": self._projection,
+            "field_filters": self._field_filters,
+            "orders": self._orders,
+            "limit": self._limit,
+            "offset": self._offset,
+        }
+        if start:
+            query_kwargs["start_at"] = cursor_pair
+            query_kwargs["end_at"] = self._end_at
+        else:
+            query_kwargs["start_at"] = self._start_at
+            query_kwargs["end_at"] = cursor_pair
+
+        return self.__class__(self._parent, **query_kwargs)
+
+    def start_at(self, document_fields):
+        """Start query results at a particular document value.
+
+        The result set will **include** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified a start cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.start_after` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by`.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor. Acts as
+            a copy of the current query, modified with the newly added
+            "start at" cursor.
+        """
+        return self._cursor_helper(document_fields, before=True, start=True)
+
+    def start_after(self, document_fields):
+        """Start query results after a particular document value.
+
+        The result set will **exclude** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified a start cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.start_at` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by`.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor. Acts as
+            a copy of the current query, modified with the newly added
+            "start after" cursor.
+        """
+        return self._cursor_helper(document_fields, before=False, start=True)
+
+    def end_before(self, document_fields):
+        """End query results before a particular document value.
+
+        The result set will **exclude** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified an end cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.end_at` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by`.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor. Acts as
+            a copy of the current query, modified with the newly added
+            "end before" cursor.
+        """
+        return self._cursor_helper(document_fields, before=True, start=False)
+
+    def end_at(self, document_fields):
+        """End query results at a particular document value.
+
+        The result set will **include** the document specified by
+        ``document_fields``.
+
+        If the current query already has specified an end cursor -- either
+        via this method or
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.end_before` -- this will
+        overwrite it.
+
+        When the query is sent to the server, the ``document_fields`` will
+        be used in the order given by fields set by
+        :meth:`~google.cloud.firestore_v1beta1.query.Query.order_by`.
+
+        Args:
+            document_fields (Union[~.firestore_v1beta1.\
+                document.DocumentSnapshot, dict, list, tuple]): a document
+                snapshot or a dictionary/list/tuple of fields representing a
+                query results cursor. A cursor is a collection of values that
+                represent a position in a query result set.
+
+        Returns:
+            ~.firestore_v1beta1.query.Query: A query with cursor. Acts as
+            a copy of the current query, modified with the newly added
+            "end at" cursor.
+        """
+        return self._cursor_helper(document_fields, before=False, start=False)
+
+    def _filters_pb(self):
+        """Convert all the filters into a single generic Filter protobuf.
+
+        This may be a lone field filter or unary filter, may be a composite
+        filter or may be :data:`None`.
+
+        Returns:
+            google.cloud.firestore_v1beta1.types.\
+            StructuredQuery.Filter: A "generic" filter representing the
+            current query's filters.
+        """
+        num_filters = len(self._field_filters)
+        if num_filters == 0:
+            return None
+        elif num_filters == 1:
+            return _filter_pb(self._field_filters[0])
+        else:
+            composite_filter = query_pb2.StructuredQuery.CompositeFilter(
+                op=enums.StructuredQuery.CompositeFilter.Operator.AND,
+                filters=[_filter_pb(filter_) for filter_ in self._field_filters],
+            )
+            return query_pb2.StructuredQuery.Filter(composite_filter=composite_filter)
+
+    @staticmethod
+    def _normalize_projection(projection):
+        """Helper:  convert field paths to message."""
+        if projection is not None:
+
+            fields = list(projection.fields)
+
+            if not fields:
+                field_ref = query_pb2.StructuredQuery.FieldReference(
+                    field_path="__name__"
+                )
+                return query_pb2.StructuredQuery.Projection(fields=[field_ref])
+
+        return projection
+
+    def _normalize_orders(self):
+        """Helper:  adjust orders based on cursors, where clauses."""
+        orders = list(self._orders)
+        _has_snapshot_cursor = False
+
+        if self._start_at:
+            if isinstance(self._start_at[0], document.DocumentSnapshot):
+                _has_snapshot_cursor = True
+
+        if self._end_at:
+            if isinstance(self._end_at[0], document.DocumentSnapshot):
+                _has_snapshot_cursor = True
+
+        if _has_snapshot_cursor:
+            should_order = [
+                _enum_from_op_string(key)
+                for key in _COMPARISON_OPERATORS
+                if key not in (_EQ_OP, "array_contains")
+            ]
+            order_keys = [order.field.field_path for order in orders]
+            for filter_ in self._field_filters:
+                field = filter_.field.field_path
+                if filter_.op in should_order and field not in order_keys:
+                    orders.append(self._make_order(field, "ASCENDING"))
+            if not orders:
+                orders.append(self._make_order("__name__", "ASCENDING"))
+            else:
+                order_keys = [order.field.field_path for order in orders]
+                if "__name__" not in order_keys:
+                    direction = orders[-1].direction  # enum?
+                    orders.append(self._make_order("__name__", direction))
+
+        return orders
+
+    def _normalize_cursor(self, cursor, orders):
+        """Helper: convert cursor to a list of values based on orders."""
+        if cursor is None:
+            return
+
+        if not orders:
+            raise ValueError(_NO_ORDERS_FOR_CURSOR)
+
+        document_fields, before = cursor
+
+        order_keys = [order.field.field_path for order in orders]
+
+        if isinstance(document_fields, document.DocumentSnapshot):
+            snapshot = document_fields
+            document_fields = snapshot.to_dict()
+            document_fields["__name__"] = snapshot.reference
+
+        if isinstance(document_fields, dict):
+            # Transform to list using orders
+            values = []
+            data = document_fields
+            for order_key in order_keys:
+                try:
+                    values.append(field_path_module.get_nested_value(order_key, data))
+                except KeyError:
+                    msg = _MISSING_ORDER_BY.format(order_key, data)
+                    raise ValueError(msg)
+            document_fields = values
+
+        if len(document_fields) != len(orders):
+            msg = _MISMATCH_CURSOR_W_ORDER_BY.format(document_fields, order_keys)
+            raise ValueError(msg)
+
+        _transform_bases = (transforms.Sentinel, transforms._ValueList)
+
+        for index, key_field in enumerate(zip(order_keys, document_fields)):
+            key, field = key_field
+
+            if isinstance(field, _transform_bases):
+                msg = _INVALID_CURSOR_TRANSFORM
+                raise ValueError(msg)
+
+            if key == "__name__" and isinstance(field, six.string_types):
+                document_fields[index] = self._parent.document(field)
+
+        return document_fields, before
+
+    def _to_protobuf(self):
+        """Convert the current query into the equivalent protobuf.
+
+        Returns:
+            google.cloud.firestore_v1beta1.types.StructuredQuery: The
+            query protobuf.
+        """
+        projection = self._normalize_projection(self._projection)
+        orders = self._normalize_orders()
+        start_at = self._normalize_cursor(self._start_at, orders)
+        end_at = self._normalize_cursor(self._end_at, orders)
+
+        query_kwargs = {
+            "select": projection,
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(
+                    collection_id=self._parent.id
+                )
+            ],
+            "where": self._filters_pb(),
+            "order_by": orders,
+            "start_at": _cursor_pb(start_at),
+            "end_at": _cursor_pb(end_at),
+        }
+        if self._offset is not None:
+            query_kwargs["offset"] = self._offset
+        if self._limit is not None:
+            query_kwargs["limit"] = wrappers_pb2.Int32Value(value=self._limit)
+
+        return query_pb2.StructuredQuery(**query_kwargs)
+
+    def get(self, transaction=None):
+        """Deprecated alias for :meth:`stream`."""
+        warnings.warn(
+            "'Query.get' is deprecated:  please use 'Query.stream' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.stream(transaction=transaction)
+
+    def stream(self, transaction=None):
+        """Read the documents in the collection that match this query.
+
+        This sends a ``RunQuery`` RPC and then returns an iterator which
+        consumes each document returned in the stream of ``RunQueryResponse``
+        messages.
+
+        .. note::
+
+           The underlying stream of responses will time out after
+           the ``max_rpc_timeout_millis`` value set in the GAPIC
+           client configuration for the ``RunQuery`` API.  Snapshots
+           not consumed from the iterator before that point will be lost.
+
+        If a ``transaction`` is used and it already has write operations
+        added, this method cannot be used (i.e. read-after-write is not
+        allowed).
+
+        Args:
+            transaction (Optional[~.firestore_v1beta1.transaction.\
+                Transaction]): An existing transaction that this query will
+                run in.
+
+        Yields:
+            ~.firestore_v1beta1.document.DocumentSnapshot: The next
+            document that fulfills the query.
+        """
+        parent_path, expected_prefix = self._parent._parent_info()
+        response_iterator = self._client._firestore_api.run_query(
+            parent_path,
+            self._to_protobuf(),
+            transaction=_helpers.get_transaction_id(transaction),
+            metadata=self._client._rpc_metadata,
+        )
+
+        for response in response_iterator:
+            snapshot = _query_response_to_snapshot(
+                response, self._parent, expected_prefix
+            )
+            if snapshot is not None:
+                yield snapshot
+
+    def on_snapshot(self, callback):
+        """Monitor the documents in this collection that match this query.
+
+        This starts a watch on this query using a background thread. The
+        provided callback is run on the snapshot of the documents.
+
+        Args:
+            callback(~.firestore.query.QuerySnapshot): a callback to run when
+                a change occurs.
+
+        Example:
+            from google.cloud import firestore_v1beta1
+
+            db = firestore_v1beta1.Client()
+            query_ref = db.collection(u'users').where("user", "==", u'Ada')
+
+            def on_snapshot(docs, changes, read_time):
+                for doc in docs:
+                    print(u'{} => {}'.format(doc.id, doc.to_dict()))
+
+            # Watch this query
+            query_watch = query_ref.on_snapshot(on_snapshot)
+
+            # Terminate this watch
+            query_watch.unsubscribe()
+        """
+        return Watch.for_query(
+            self, callback, document.DocumentSnapshot, document.DocumentReference
+        )
+
+    def _comparator(self, doc1, doc2):
+        _orders = self._orders
+
+        # Add implicit sorting by name, using the last specified direction.
+        if len(_orders) == 0:
+            lastDirection = Query.ASCENDING
+        else:
+            if _orders[-1].direction == 1:
+                lastDirection = Query.ASCENDING
+            else:
+                lastDirection = Query.DESCENDING
+
+        orderBys = list(_orders)
+
+        order_pb = query_pb2.StructuredQuery.Order(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="id"),
+            direction=_enum_from_direction(lastDirection),
+        )
+        orderBys.append(order_pb)
+
+        for orderBy in orderBys:
+            if orderBy.field.field_path == "id":
+                # If ordering by docuent id, compare resource paths.
+                comp = Order()._compare_to(doc1.reference._path, doc2.reference._path)
+            else:
+                if (
+                    orderBy.field.field_path not in doc1._data
+                    or orderBy.field.field_path not in doc2._data
+                ):
+                    raise ValueError(
+                        "Can only compare fields that exist in the "
+                        "DocumentSnapshot. Please include the fields you are "
+                        "ordering on in your select() call."
+                    )
+                v1 = doc1._data[orderBy.field.field_path]
+                v2 = doc2._data[orderBy.field.field_path]
+                encoded_v1 = _helpers.encode_value(v1)
+                encoded_v2 = _helpers.encode_value(v2)
+                comp = Order().compare(encoded_v1, encoded_v2)
+
+            if comp != 0:
+                # 1 == Ascending, -1 == Descending
+                return orderBy.direction * comp
+
+        return 0
+
+
+def _enum_from_op_string(op_string):
+    """Convert a string representation of a binary operator to an enum.
+
+    These enums come from the protobuf message definition
+    ``StructuredQuery.FieldFilter.Operator``.
+
+    Args:
+        op_string (str): A comparison operation in the form of a string.
+            Acceptable values are ``<``, ``<=``, ``==``, ``>=``
+            and ``>``.
+
+    Returns:
+        int: The enum corresponding to ``op_string``.
+
+    Raises:
+        ValueError: If ``op_string`` is not a valid operator.
+    """
+    try:
+        return _COMPARISON_OPERATORS[op_string]
+    except KeyError:
+        choices = ", ".join(sorted(_COMPARISON_OPERATORS.keys()))
+        msg = _BAD_OP_STRING.format(op_string, choices)
+        raise ValueError(msg)
+
+
+def _isnan(value):
+    """Check if a value is NaN.
+
+    This differs from ``math.isnan`` in that **any** input type is
+    allowed.
+
+    Args:
+        value (Any): A value to check for NaN-ness.
+
+    Returns:
+        bool: Indicates if the value is the NaN float.
+    """
+    if isinstance(value, float):
+        return math.isnan(value)
+    else:
+        return False
+
+
+def _enum_from_direction(direction):
+    """Convert a string representation of a direction to an enum.
+
+    Args:
+        direction (str): A direction to order by. Must be one of
+            :attr:`~google.cloud.firestore.Query.ASCENDING` or
+            :attr:`~google.cloud.firestore.Query.DESCENDING`.
+
+    Returns:
+        int: The enum corresponding to ``direction``.
+
+    Raises:
+        ValueError: If ``direction`` is not a valid direction.
+    """
+    if isinstance(direction, int):
+        return direction
+
+    if direction == Query.ASCENDING:
+        return enums.StructuredQuery.Direction.ASCENDING
+    elif direction == Query.DESCENDING:
+        return enums.StructuredQuery.Direction.DESCENDING
+    else:
+        msg = _BAD_DIR_STRING.format(direction, Query.ASCENDING, Query.DESCENDING)
+        raise ValueError(msg)
+
+
+def _filter_pb(field_or_unary):
+    """Convert a specific protobuf filter to the generic filter type.
+
+    Args:
+        field_or_unary (Union[google.cloud.proto.firestore.v1beta1.\
+            query_pb2.StructuredQuery.FieldFilter, google.cloud.proto.\
+            firestore.v1beta1.query_pb2.StructuredQuery.FieldFilter]): A
+            field or unary filter to convert to a generic filter.
+
+    Returns:
+        google.cloud.firestore_v1beta1.types.\
+        StructuredQuery.Filter: A "generic" filter.
+
+    Raises:
+        ValueError: If ``field_or_unary`` is not a field or unary filter.
+    """
+    if isinstance(field_or_unary, query_pb2.StructuredQuery.FieldFilter):
+        return query_pb2.StructuredQuery.Filter(field_filter=field_or_unary)
+    elif isinstance(field_or_unary, query_pb2.StructuredQuery.UnaryFilter):
+        return query_pb2.StructuredQuery.Filter(unary_filter=field_or_unary)
+    else:
+        raise ValueError("Unexpected filter type", type(field_or_unary), field_or_unary)
+
+
+def _cursor_pb(cursor_pair):
+    """Convert a cursor pair to a protobuf.
+
+    If ``cursor_pair`` is :data:`None`, just returns :data:`None`.
+
+    Args:
+        cursor_pair (Optional[Tuple[list, bool]]): Two-tuple of
+
+            * a list of field values.
+            * a ``before`` flag
+
+    Returns:
+        Optional[google.cloud.firestore_v1beta1.types.Cursor]: A
+        protobuf cursor corresponding to the values.
+    """
+    if cursor_pair is not None:
+        data, before = cursor_pair
+        value_pbs = [_helpers.encode_value(value) for value in data]
+        return query_pb2.Cursor(values=value_pbs, before=before)
+
+
+def _query_response_to_snapshot(response_pb, collection, expected_prefix):
+    """Parse a query response protobuf to a document snapshot.
+
+    Args:
+        response_pb (google.cloud.proto.firestore.v1beta1.\
+            firestore_pb2.RunQueryResponse): A
+        collection (~.firestore_v1beta1.collection.CollectionReference): A
+            reference to the collection that initiated the query.
+        expected_prefix (str): The expected prefix for fully-qualified
+            document names returned in the query results. This can be computed
+            directly from ``collection`` via :meth:`_parent_info`.
+
+    Returns:
+        Optional[~.firestore.document.DocumentSnapshot]: A
+        snapshot of the data returned in the query. If ``response_pb.document``
+        is not set, the snapshot will be :data:`None`.
+    """
+    if not response_pb.HasField("document"):
+        return None
+
+    document_id = _helpers.get_doc_id(response_pb.document, expected_prefix)
+    reference = collection.document(document_id)
+    data = _helpers.decode_dict(response_pb.document.fields, collection._client)
+    snapshot = document.DocumentSnapshot(
+        reference,
+        data,
+        exists=True,
+        read_time=response_pb.read_time,
+        create_time=response_pb.document.create_time,
+        update_time=response_pb.document.update_time,
+    )
+    return snapshot
diff --git a/firestore/google/cloud/firestore_v1beta1/transaction.py b/firestore/google/cloud/firestore_v1beta1/transaction.py
new file mode 100644
index 000000000000..9a37f18d8061
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/transaction.py
@@ -0,0 +1,409 @@
+# Copyright 2017 Google LLC 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.
+
+"""Helpers for applying Google Cloud Firestore changes in a transaction."""
+
+
+import random
+import time
+
+import six
+
+from google.api_core import exceptions
+from google.cloud.firestore_v1beta1 import batch
+from google.cloud.firestore_v1beta1 import types
+
+
+MAX_ATTEMPTS = 5
+"""int: Default number of transaction attempts (with retries)."""
+_CANT_BEGIN = "The transaction has already begun. Current transaction ID: {!r}."
+_MISSING_ID_TEMPLATE = "The transaction has no transaction ID, so it cannot be {}."
+_CANT_ROLLBACK = _MISSING_ID_TEMPLATE.format("rolled back")
+_CANT_COMMIT = _MISSING_ID_TEMPLATE.format("committed")
+_WRITE_READ_ONLY = "Cannot perform write operation in read-only transaction."
+_INITIAL_SLEEP = 1.0
+"""float: Initial "max" for sleep interval. To be used in :func:`_sleep`."""
+_MAX_SLEEP = 30.0
+"""float: Eventual "max" sleep time. To be used in :func:`_sleep`."""
+_MULTIPLIER = 2.0
+"""float: Multiplier for exponential backoff. To be used in :func:`_sleep`."""
+_EXCEED_ATTEMPTS_TEMPLATE = "Failed to commit transaction in {:d} attempts."
+_CANT_RETRY_READ_ONLY = "Only read-write transactions can be retried."
+
+
+class Transaction(batch.WriteBatch):
+    """Accumulate read-and-write operations to be sent in a transaction.
+
+    Args:
+        client (~.firestore_v1beta1.client.Client): The client that
+            created this transaction.
+        max_attempts (Optional[int]): The maximum number of attempts for
+            the transaction (i.e. allowing retries). Defaults to
+            :attr:`~google.cloud.firestore_v1beta1.transaction.MAX_ATTEMPTS`.
+        read_only (Optional[bool]): Flag indicating if the transaction
+            should be read-only or should allow writes. Defaults to
+            :data:`False`.
+    """
+
+    def __init__(self, client, max_attempts=MAX_ATTEMPTS, read_only=False):
+        super(Transaction, self).__init__(client)
+        self._max_attempts = max_attempts
+        self._read_only = read_only
+        self._id = None
+
+    def _add_write_pbs(self, write_pbs):
+        """Add `Write`` protobufs to this transaction.
+
+        Args:
+            write_pbs (List[google.cloud.proto.firestore.v1beta1.\
+                write_pb2.Write]): A list of write protobufs to be added.
+
+        Raises:
+            ValueError: If this transaction is read-only.
+        """
+        if self._read_only:
+            raise ValueError(_WRITE_READ_ONLY)
+
+        super(Transaction, self)._add_write_pbs(write_pbs)
+
+    def _options_protobuf(self, retry_id):
+        """Convert the current object to protobuf.
+
+        The ``retry_id`` value is used when retrying a transaction that
+        failed (e.g. due to contention). It is intended to be the "first"
+        transaction that failed (i.e. if multiple retries are needed).
+
+        Args:
+            retry_id (Union[bytes, NoneType]): Transaction ID of a transaction
+                to be retried.
+
+        Returns:
+            Optional[google.cloud.firestore_v1beta1.types.TransactionOptions]:
+            The protobuf ``TransactionOptions`` if ``read_only==True`` or if
+            there is a transaction ID to be retried, else :data:`None`.
+
+        Raises:
+            ValueError: If ``retry_id`` is not :data:`None` but the
+                transaction is read-only.
+        """
+        if retry_id is not None:
+            if self._read_only:
+                raise ValueError(_CANT_RETRY_READ_ONLY)
+
+            return types.TransactionOptions(
+                read_write=types.TransactionOptions.ReadWrite(
+                    retry_transaction=retry_id
+                )
+            )
+        elif self._read_only:
+            return types.TransactionOptions(
+                read_only=types.TransactionOptions.ReadOnly()
+            )
+        else:
+            return None
+
+    @property
+    def in_progress(self):
+        """Determine if this transaction has already begun.
+
+        Returns:
+            bool: Indicates if the transaction has started.
+        """
+        return self._id is not None
+
+    @property
+    def id(self):
+        """Get the current transaction ID.
+
+        Returns:
+            Optional[bytes]: The transaction ID (or :data:`None` if the
+            current transaction is not in progress).
+        """
+        return self._id
+
+    def _begin(self, retry_id=None):
+        """Begin the transaction.
+
+        Args:
+            retry_id (Optional[bytes]): Transaction ID of a transaction to be
+                retried.
+
+        Raises:
+            ValueError: If the current transaction has already begun.
+        """
+        if self.in_progress:
+            msg = _CANT_BEGIN.format(self._id)
+            raise ValueError(msg)
+
+        transaction_response = self._client._firestore_api.begin_transaction(
+            self._client._database_string,
+            options_=self._options_protobuf(retry_id),
+            metadata=self._client._rpc_metadata,
+        )
+        self._id = transaction_response.transaction
+
+    def _clean_up(self):
+        """Clean up the instance after :meth:`_rollback`` or :meth:`_commit``.
+
+        This intended to occur on success or failure of the associated RPCs.
+        """
+        self._write_pbs = []
+        self._id = None
+
+    def _rollback(self):
+        """Roll back the transaction.
+
+        Raises:
+            ValueError: If no transaction is in progress.
+        """
+        if not self.in_progress:
+            raise ValueError(_CANT_ROLLBACK)
+
+        try:
+            # NOTE: The response is just ``google.protobuf.Empty``.
+            self._client._firestore_api.rollback(
+                self._client._database_string,
+                self._id,
+                metadata=self._client._rpc_metadata,
+            )
+        finally:
+            self._clean_up()
+
+    def _commit(self):
+        """Transactionally commit the changes accumulated.
+
+        Returns:
+            List[google.cloud.proto.firestore.v1beta1.\
+                write_pb2.WriteResult, ...]: The write results corresponding
+            to the changes committed, returned in the same order as the
+            changes were applied to this transaction. A write result contains
+            an ``update_time`` field.
+
+        Raises:
+            ValueError: If no transaction is in progress.
+        """
+        if not self.in_progress:
+            raise ValueError(_CANT_COMMIT)
+
+        commit_response = _commit_with_retry(self._client, self._write_pbs, self._id)
+
+        self._clean_up()
+        return list(commit_response.write_results)
+
+
+class _Transactional(object):
+    """Provide a callable object to use as a transactional decorater.
+
+    This is surfaced via
+    :func:`~google.cloud.firestore_v1beta1.transaction.transactional`.
+
+    Args:
+        to_wrap (Callable[~.firestore_v1beta1.transaction.Transaction, \
+            Any]): A callable that should be run (and retried) in a
+            transaction.
+    """
+
+    def __init__(self, to_wrap):
+        self.to_wrap = to_wrap
+        self.current_id = None
+        """Optional[bytes]: The current transaction ID."""
+        self.retry_id = None
+        """Optional[bytes]: The ID of the first attempted transaction."""
+
+    def _reset(self):
+        """Unset the transaction IDs."""
+        self.current_id = None
+        self.retry_id = None
+
+    def _pre_commit(self, transaction, *args, **kwargs):
+        """Begin transaction and call the wrapped callable.
+
+        If the callable raises an exception, the transaction will be rolled
+        back. If not, the transaction will be "ready" for ``Commit`` (i.e.
+        it will have staged writes).
+
+        Args:
+            transaction (~.firestore_v1beta1.transaction.Transaction): A
+                transaction to execute the callable within.
+            args (Tuple[Any, ...]): The extra positional arguments to pass
+                along to the wrapped callable.
+            kwargs (Dict[str, Any]): The extra keyword arguments to pass
+                along to the wrapped callable.
+
+        Returns:
+            Any: result of the wrapped callable.
+
+        Raises:
+            Exception: Any failure caused by ``to_wrap``.
+        """
+        # Force the ``transaction`` to be not "in progress".
+        transaction._clean_up()
+        transaction._begin(retry_id=self.retry_id)
+
+        # Update the stored transaction IDs.
+        self.current_id = transaction._id
+        if self.retry_id is None:
+            self.retry_id = self.current_id
+        try:
+            return self.to_wrap(transaction, *args, **kwargs)
+        except:  # noqa
+            # NOTE: If ``rollback`` fails this will lose the information
+            #       from the original failure.
+            transaction._rollback()
+            raise
+
+    def _maybe_commit(self, transaction):
+        """Try to commit the transaction.
+
+        If the transaction is read-write and the ``Commit`` fails with the
+        ``ABORTED`` status code, it will be retried. Any other failure will
+        not be caught.
+
+        Args:
+            transaction (~.firestore_v1beta1.transaction.Transaction): The
+                transaction to be ``Commit``-ed.
+
+        Returns:
+            bool: Indicating if the commit succeeded.
+        """
+        try:
+            transaction._commit()
+            return True
+        except exceptions.GoogleAPICallError as exc:
+            if transaction._read_only:
+                raise
+
+            if isinstance(exc, exceptions.Aborted):
+                # If a read-write transaction returns ABORTED, retry.
+                return False
+            else:
+                raise
+
+    def __call__(self, transaction, *args, **kwargs):
+        """Execute the wrapped callable within a transaction.
+
+        Args:
+            transaction (~.firestore_v1beta1.transaction.Transaction): A
+                transaction to execute the callable within.
+            args (Tuple[Any, ...]): The extra positional arguments to pass
+                along to the wrapped callable.
+            kwargs (Dict[str, Any]): The extra keyword arguments to pass
+                along to the wrapped callable.
+
+        Returns:
+            Any: The result of the wrapped callable.
+
+        Raises:
+            ValueError: If the transaction does not succeed in
+                ``max_attempts``.
+        """
+        self._reset()
+
+        for attempt in six.moves.xrange(transaction._max_attempts):
+            result = self._pre_commit(transaction, *args, **kwargs)
+            succeeded = self._maybe_commit(transaction)
+            if succeeded:
+                return result
+
+            # Subsequent requests will use the failed transaction ID as part of
+            # the ``BeginTransactionRequest`` when restarting this transaction
+            # (via ``options.retry_transaction``). This preserves the "spot in
+            # line" of the transaction, so exponential backoff is not required
+            # in this case.
+
+        transaction._rollback()
+        msg = _EXCEED_ATTEMPTS_TEMPLATE.format(transaction._max_attempts)
+        raise ValueError(msg)
+
+
+def transactional(to_wrap):
+    """Decorate a callable so that it runs in a transaction.
+
+    Args:
+        to_wrap (Callable[~.firestore_v1beta1.transaction.Transaction, \
+            Any]): A callable that should be run (and retried) in a
+            transaction.
+
+    Returns:
+        Callable[~.firestore_v1beta1.transaction.Transaction, Any]: the
+        wrapped callable.
+    """
+    return _Transactional(to_wrap)
+
+
+def _commit_with_retry(client, write_pbs, transaction_id):
+    """Call ``Commit`` on the GAPIC client with retry / sleep.
+
+    Retries the ``Commit`` RPC on Unavailable. Usually this RPC-level
+    retry is handled by the underlying GAPICd client, but in this case it
+    doesn't because ``Commit`` is not always idempotent. But here we know it
+    is "idempotent"-like because it has a transaction ID. We also need to do
+    our own retry to special-case the ``INVALID_ARGUMENT`` error.
+
+    Args:
+        client (~.firestore_v1beta1.client.Client): A client with
+            GAPIC client and configuration details.
+        write_pbs (List[google.cloud.proto.firestore.v1beta1.\
+            write_pb2.Write, ...]): A ``Write`` protobuf instance to
+            be committed.
+        transaction_id (bytes): ID of an existing transaction that
+            this commit will run in.
+
+    Returns:
+        google.cloud.firestore_v1beta1.types.CommitResponse:
+        The protobuf response from ``Commit``.
+
+    Raises:
+        ~google.api_core.exceptions.GoogleAPICallError: If a non-retryable
+            exception is encountered.
+    """
+    current_sleep = _INITIAL_SLEEP
+    while True:
+        try:
+            return client._firestore_api.commit(
+                client._database_string,
+                write_pbs,
+                transaction=transaction_id,
+                metadata=client._rpc_metadata,
+            )
+        except exceptions.ServiceUnavailable:
+            # Retry
+            pass
+
+        current_sleep = _sleep(current_sleep)
+
+
+def _sleep(current_sleep, max_sleep=_MAX_SLEEP, multiplier=_MULTIPLIER):
+    """Sleep and produce a new sleep time.
+
+    .. _Exponential Backoff And Jitter: https://www.awsarchitectureblog.com/\
+                                        2015/03/backoff.html
+
+    Select a duration between zero and ``current_sleep``. It might seem
+    counterintuitive to have so much jitter, but
+    `Exponential Backoff And Jitter`_ argues that "full jitter" is
+    the best strategy.
+
+    Args:
+        current_sleep (float): The current "max" for sleep interval.
+        max_sleep (Optional[float]): Eventual "max" sleep time
+        multiplier (Optional[float]): Multiplier for exponential backoff.
+
+    Returns:
+        float: Newly doubled ``current_sleep`` or ``max_sleep`` (whichever
+        is smaller)
+    """
+    actual_sleep = random.uniform(0.0, current_sleep)
+    time.sleep(actual_sleep)
+    return min(multiplier * current_sleep, max_sleep)
diff --git a/firestore/google/cloud/firestore_v1beta1/transforms.py b/firestore/google/cloud/firestore_v1beta1/transforms.py
new file mode 100644
index 000000000000..4a64cf9ec3e3
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/transforms.py
@@ -0,0 +1,90 @@
+# Copyright 2017 Google LLC 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.
+
+"""Helpful constants to use for Google Cloud Firestore."""
+
+
+class Sentinel(object):
+    """Sentinel objects used to signal special handling."""
+
+    __slots__ = ("description",)
+
+    def __init__(self, description):
+        self.description = description
+
+    def __repr__(self):
+        return "Sentinel: {}".format(self.description)
+
+
+DELETE_FIELD = Sentinel("Value used to delete a field in a document.")
+
+
+SERVER_TIMESTAMP = Sentinel(
+    "Value used to set a document field to the server timestamp."
+)
+
+
+class _ValueList(object):
+    """Read-only list of values.
+
+    Args:
+        values (List | Tuple): values held in the helper.
+    """
+
+    slots = ("_values",)
+
+    def __init__(self, values):
+        if not isinstance(values, (list, tuple)):
+            raise ValueError("'values' must be a list or tuple.")
+
+        if len(values) == 0:
+            raise ValueError("'values' must be non-empty.")
+
+        self._values = list(values)
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._values == other._values
+
+    @property
+    def values(self):
+        """Values to append.
+
+        Returns (List):
+            values to be appended by the transform.
+        """
+        return self._values
+
+
+class ArrayUnion(_ValueList):
+    """Field transform: appends missing values to an array field.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1beta1#google.firestore.v1beta1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1beta1.ArrayValue.google.firestore.v1beta1.DocumentTransform.FieldTransform.append_missing_elements
+
+    Args:
+        values (List | Tuple): values to append.
+    """
+
+
+class ArrayRemove(_ValueList):
+    """Field transform: remove values from an array field.
+
+    See:
+    https://cloud.google.com/firestore/docs/reference/rpc/google.firestore.v1beta1#google.firestore.v1beta1.DocumentTransform.FieldTransform.FIELDS.google.firestore.v1beta1.ArrayValue.google.firestore.v1beta1.DocumentTransform.FieldTransform.remove_all_from_array
+
+    Args:
+        values (List | Tuple): values to remove.
+    """
diff --git a/firestore/google/cloud/firestore_v1beta1/types.py b/firestore/google/cloud/firestore_v1beta1/types.py
new file mode 100644
index 000000000000..90c03b8aba2e
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/types.py
@@ -0,0 +1,63 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.protobuf import any_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import latlng_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.firestore_v1beta1.proto import common_pb2
+from google.cloud.firestore_v1beta1.proto import document_pb2
+from google.cloud.firestore_v1beta1.proto import firestore_pb2
+from google.cloud.firestore_v1beta1.proto import query_pb2
+from google.cloud.firestore_v1beta1.proto import write_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    any_pb2,
+    descriptor_pb2,
+    empty_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [common_pb2, document_pb2, firestore_pb2, query_pb2, write_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.firestore_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/firestore/google/cloud/firestore_v1beta1/watch.py b/firestore/google/cloud/firestore_v1beta1/watch.py
new file mode 100644
index 000000000000..63ded0d2d25b
--- /dev/null
+++ b/firestore/google/cloud/firestore_v1beta1/watch.py
@@ -0,0 +1,722 @@
+# Copyright 2017 Google LLC 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.
+
+import logging
+import collections
+import threading
+import datetime
+from enum import Enum
+import functools
+
+import pytz
+
+from google.api_core.bidi import ResumableBidiRpc
+from google.api_core.bidi import BackgroundConsumer
+from google.cloud.firestore_v1beta1.proto import firestore_pb2
+from google.cloud.firestore_v1beta1 import _helpers
+
+from google.api_core import exceptions
+
+import grpc
+
+"""Python client for Google Cloud Firestore Watch."""
+
+_LOGGER = logging.getLogger(__name__)
+
+WATCH_TARGET_ID = 0x5079  # "Py"
+
+GRPC_STATUS_CODE = {
+    "OK": 0,
+    "CANCELLED": 1,
+    "UNKNOWN": 2,
+    "INVALID_ARGUMENT": 3,
+    "DEADLINE_EXCEEDED": 4,
+    "NOT_FOUND": 5,
+    "ALREADY_EXISTS": 6,
+    "PERMISSION_DENIED": 7,
+    "UNAUTHENTICATED": 16,
+    "RESOURCE_EXHAUSTED": 8,
+    "FAILED_PRECONDITION": 9,
+    "ABORTED": 10,
+    "OUT_OF_RANGE": 11,
+    "UNIMPLEMENTED": 12,
+    "INTERNAL": 13,
+    "UNAVAILABLE": 14,
+    "DATA_LOSS": 15,
+    "DO_NOT_USE": -1,
+}
+_RPC_ERROR_THREAD_NAME = "Thread-OnRpcTerminated"
+_RETRYABLE_STREAM_ERRORS = (
+    exceptions.DeadlineExceeded,
+    exceptions.ServiceUnavailable,
+    exceptions.InternalServerError,
+    exceptions.Unknown,
+    exceptions.GatewayTimeout,
+)
+
+DocTreeEntry = collections.namedtuple("DocTreeEntry", ["value", "index"])
+
+
+class WatchDocTree(object):
+    # TODO: Currently this uses a dict. Other implementations us an rbtree.
+    # The performance of this implementation should be investigated and may
+    # require modifying the underlying datastructure to a rbtree.
+    def __init__(self):
+        self._dict = {}
+        self._index = 0
+
+    def keys(self):
+        return list(self._dict.keys())
+
+    def _copy(self):
+        wdt = WatchDocTree()
+        wdt._dict = self._dict.copy()
+        wdt._index = self._index
+        self = wdt
+        return self
+
+    def insert(self, key, value):
+        self = self._copy()
+        self._dict[key] = DocTreeEntry(value, self._index)
+        self._index += 1
+        return self
+
+    def find(self, key):
+        return self._dict[key]
+
+    def remove(self, key):
+        self = self._copy()
+        del self._dict[key]
+        return self
+
+    def __iter__(self):
+        for k in self._dict:
+            yield k
+
+    def __len__(self):
+        return len(self._dict)
+
+    def __contains__(self, k):
+        return k in self._dict
+
+
+class ChangeType(Enum):
+    ADDED = 1
+    REMOVED = 2
+    MODIFIED = 3
+
+
+class DocumentChange(object):
+    def __init__(self, type, document, old_index, new_index):
+        """DocumentChange
+
+        Args:
+            type (ChangeType):
+            document (document.DocumentSnapshot):
+            old_index (int):
+            new_index (int):
+        """
+        # TODO: spec indicated an isEqual param also
+        self.type = type
+        self.document = document
+        self.old_index = old_index
+        self.new_index = new_index
+
+
+class WatchResult(object):
+    def __init__(self, snapshot, name, change_type):
+        self.snapshot = snapshot
+        self.name = name
+        self.change_type = change_type
+
+
+def _maybe_wrap_exception(exception):
+    """Wraps a gRPC exception class, if needed."""
+    if isinstance(exception, grpc.RpcError):
+        return exceptions.from_grpc_error(exception)
+    return exception
+
+
+def document_watch_comparator(doc1, doc2):
+    assert doc1 == doc2, "Document watches only support one document."
+    return 0
+
+
+class Watch(object):
+
+    BackgroundConsumer = BackgroundConsumer  # FBO unit tests
+    ResumableBidiRpc = ResumableBidiRpc  # FBO unit tests
+
+    def __init__(
+        self,
+        document_reference,
+        firestore,
+        target,
+        comparator,
+        snapshot_callback,
+        document_snapshot_cls,
+        document_reference_cls,
+        BackgroundConsumer=None,  # FBO unit testing
+        ResumableBidiRpc=None,  # FBO unit testing
+    ):
+        """
+        Args:
+            firestore:
+            target:
+            comparator:
+            snapshot_callback: Callback method to process snapshots.
+                Args:
+                    docs (List(DocumentSnapshot)): A callback that returns the
+                        ordered list of documents stored in this snapshot.
+                    changes (List(str)): A callback that returns the list of
+                        changed documents since the last snapshot delivered for
+                        this watch.
+                    read_time (string): The ISO 8601 time at which this
+                        snapshot was obtained.
+
+            document_snapshot_cls: instance of DocumentSnapshot
+            document_reference_cls: instance of DocumentReference
+        """
+        self._document_reference = document_reference
+        self._firestore = firestore
+        self._api = firestore._firestore_api
+        self._targets = target
+        self._comparator = comparator
+        self.DocumentSnapshot = document_snapshot_cls
+        self.DocumentReference = document_reference_cls
+        self._snapshot_callback = snapshot_callback
+        self._closing = threading.Lock()
+        self._closed = False
+
+        def should_recover(exc):  # pragma: NO COVER
+            return (
+                isinstance(exc, grpc.RpcError)
+                and exc.code() == grpc.StatusCode.UNAVAILABLE
+            )
+
+        initial_request = firestore_pb2.ListenRequest(
+            database=self._firestore._database_string, add_target=self._targets
+        )
+
+        if ResumableBidiRpc is None:
+            ResumableBidiRpc = self.ResumableBidiRpc  # FBO unit tests
+
+        self._rpc = ResumableBidiRpc(
+            self._api.transport.listen,
+            initial_request=initial_request,
+            should_recover=should_recover,
+            metadata=self._firestore._rpc_metadata,
+        )
+
+        self._rpc.add_done_callback(self._on_rpc_done)
+
+        # Initialize state for on_snapshot
+        # The sorted tree of QueryDocumentSnapshots as sent in the last
+        # snapshot. We only look at the keys.
+        self.doc_tree = WatchDocTree()
+
+        # A map of document names to QueryDocumentSnapshots for the last sent
+        # snapshot.
+        self.doc_map = {}
+
+        # The accumulates map of document changes (keyed by document name) for
+        # the current snapshot.
+        self.change_map = {}
+
+        # The current state of the query results.
+        self.current = False
+
+        # We need this to track whether we've pushed an initial set of changes,
+        # since we should push those even when there are no changes, if there
+        # aren't docs.
+        self.has_pushed = False
+
+        # The server assigns and updates the resume token.
+        self.resume_token = None
+        if BackgroundConsumer is None:  # FBO unit tests
+            BackgroundConsumer = self.BackgroundConsumer
+
+        self._consumer = BackgroundConsumer(self._rpc, self.on_snapshot)
+        self._consumer.start()
+
+    @property
+    def is_active(self):
+        """bool: True if this manager is actively streaming.
+
+        Note that ``False`` does not indicate this is complete shut down,
+        just that it stopped getting new messages.
+        """
+        return self._consumer is not None and self._consumer.is_active
+
+    def close(self, reason=None):
+        """Stop consuming messages and shutdown all helper threads.
+
+        This method is idempotent. Additional calls will have no effect.
+
+        Args:
+            reason (Any): The reason to close this. If None, this is considered
+                an "intentional" shutdown.
+        """
+        with self._closing:
+            if self._closed:
+                return
+
+            # Stop consuming messages.
+            if self.is_active:
+                _LOGGER.debug("Stopping consumer.")
+                self._consumer.stop()
+            self._consumer = None
+
+            self._rpc.close()
+            self._rpc = None
+            self._closed = True
+            _LOGGER.debug("Finished stopping manager.")
+
+        if reason:
+            # Raise an exception if a reason is provided
+            _LOGGER.debug("reason for closing: %s" % reason)
+            if isinstance(reason, Exception):
+                raise reason
+            raise RuntimeError(reason)
+
+    def _on_rpc_done(self, future):
+        """Triggered whenever the underlying RPC terminates without recovery.
+
+        This is typically triggered from one of two threads: the background
+        consumer thread (when calling ``recv()`` produces a non-recoverable
+        error) or the grpc management thread (when cancelling the RPC).
+
+        This method is *non-blocking*. It will start another thread to deal
+        with shutting everything down. This is to prevent blocking in the
+        background consumer and preventing it from being ``joined()``.
+        """
+        _LOGGER.info("RPC termination has signaled manager shutdown.")
+        future = _maybe_wrap_exception(future)
+        thread = threading.Thread(
+            name=_RPC_ERROR_THREAD_NAME, target=self.close, kwargs={"reason": future}
+        )
+        thread.daemon = True
+        thread.start()
+
+    def unsubscribe(self):
+        self.close()
+
+    @classmethod
+    def for_document(
+        cls,
+        document_ref,
+        snapshot_callback,
+        snapshot_class_instance,
+        reference_class_instance,
+    ):
+        """
+        Creates a watch snapshot listener for a document. snapshot_callback
+        receives a DocumentChange object, but may also start to get
+        targetChange and such soon
+
+        Args:
+            document_ref: Reference to Document
+            snapshot_callback: callback to be called on snapshot
+            snapshot_class_instance: instance of DocumentSnapshot to make
+                snapshots with to pass to snapshot_callback
+            reference_class_instance: instance of DocumentReference to make
+                references
+
+        """
+        return cls(
+            document_ref,
+            document_ref._client,
+            {
+                "documents": {"documents": [document_ref._document_path]},
+                "target_id": WATCH_TARGET_ID,
+            },
+            document_watch_comparator,
+            snapshot_callback,
+            snapshot_class_instance,
+            reference_class_instance,
+        )
+
+    @classmethod
+    def for_query(
+        cls, query, snapshot_callback, snapshot_class_instance, reference_class_instance
+    ):
+        query_target = firestore_pb2.Target.QueryTarget(
+            parent=query._client._database_string, structured_query=query._to_protobuf()
+        )
+
+        return cls(
+            query,
+            query._client,
+            {"query": query_target, "target_id": WATCH_TARGET_ID},
+            query._comparator,
+            snapshot_callback,
+            snapshot_class_instance,
+            reference_class_instance,
+        )
+
+    def _on_snapshot_target_change_no_change(self, proto):
+        _LOGGER.debug("on_snapshot: target change: NO_CHANGE")
+        change = proto.target_change
+
+        no_target_ids = change.target_ids is None or len(change.target_ids) == 0
+        if no_target_ids and change.read_time and self.current:
+            # TargetChange.CURRENT followed by TargetChange.NO_CHANGE
+            # signals a consistent state. Invoke the onSnapshot
+            # callback as specified by the user.
+            self.push(change.read_time, change.resume_token)
+
+    def _on_snapshot_target_change_add(self, proto):
+        _LOGGER.debug("on_snapshot: target change: ADD")
+        target_id = proto.target_change.target_ids[0]
+        if target_id != WATCH_TARGET_ID:
+            raise RuntimeError("Unexpected target ID %s sent by server" % target_id)
+
+    def _on_snapshot_target_change_remove(self, proto):
+        _LOGGER.debug("on_snapshot: target change: REMOVE")
+        change = proto.target_change
+
+        code = 13
+        message = "internal error"
+        if change.cause:
+            code = change.cause.code
+            message = change.cause.message
+
+        message = "Error %s:  %s" % (code, message)
+
+        raise RuntimeError(message)
+
+    def _on_snapshot_target_change_reset(self, proto):
+        # Whatever changes have happened so far no longer matter.
+        _LOGGER.debug("on_snapshot: target change: RESET")
+        self._reset_docs()
+
+    def _on_snapshot_target_change_current(self, proto):
+        _LOGGER.debug("on_snapshot: target change: CURRENT")
+        self.current = True
+
+    def on_snapshot(self, proto):
+        """
+        Called everytime there is a response from listen. Collect changes
+        and 'push' the changes in a batch to the customer when we receive
+        'current' from the listen response.
+
+        Args:
+            listen_response(`google.cloud.firestore_v1beta1.types.ListenResponse`):
+                Callback method that receives a object to
+        """
+        TargetChange = firestore_pb2.TargetChange
+
+        target_changetype_dispatch = {
+            TargetChange.NO_CHANGE: self._on_snapshot_target_change_no_change,
+            TargetChange.ADD: self._on_snapshot_target_change_add,
+            TargetChange.REMOVE: self._on_snapshot_target_change_remove,
+            TargetChange.RESET: self._on_snapshot_target_change_reset,
+            TargetChange.CURRENT: self._on_snapshot_target_change_current,
+        }
+
+        target_change = proto.target_change
+        if str(target_change):
+            target_change_type = target_change.target_change_type
+            _LOGGER.debug("on_snapshot: target change: " + str(target_change_type))
+            meth = target_changetype_dispatch.get(target_change_type)
+            if meth is None:
+                _LOGGER.info(
+                    "on_snapshot: Unknown target change " + str(target_change_type)
+                )
+                self.close(
+                    reason="Unknown target change type: %s " % str(target_change_type)
+                )
+            else:
+                try:
+                    meth(proto)
+                except Exception as exc2:
+                    _LOGGER.debug("meth(proto) exc: " + str(exc2))
+                    raise
+
+            # NOTE:
+            # in other implementations, such as node, the backoff is reset here
+            # in this version bidi rpc is just used and will control this.
+
+        elif str(proto.document_change):
+            _LOGGER.debug("on_snapshot: document change")
+
+            # No other target_ids can show up here, but we still need to see
+            # if the targetId was in the added list or removed list.
+            target_ids = proto.document_change.target_ids or []
+            removed_target_ids = proto.document_change.removed_target_ids or []
+            changed = False
+            removed = False
+
+            if WATCH_TARGET_ID in target_ids:
+                changed = True
+
+            if WATCH_TARGET_ID in removed_target_ids:
+                removed = True
+
+            if changed:
+                _LOGGER.debug("on_snapshot: document change: CHANGED")
+
+                # google.cloud.firestore_v1beta1.types.DocumentChange
+                document_change = proto.document_change
+                # google.cloud.firestore_v1beta1.types.Document
+                document = document_change.document
+
+                data = _helpers.decode_dict(document.fields, self._firestore)
+
+                # Create a snapshot. As Document and Query objects can be
+                # passed we need to get a Document Reference in a more manual
+                # fashion than self._document_reference
+                document_name = document.name
+                db_str = self._firestore._database_string
+                db_str_documents = db_str + "/documents/"
+                if document_name.startswith(db_str_documents):
+                    document_name = document_name[len(db_str_documents) :]
+
+                document_ref = self._firestore.document(document_name)
+
+                snapshot = self.DocumentSnapshot(
+                    reference=document_ref,
+                    data=data,
+                    exists=True,
+                    read_time=None,
+                    create_time=document.create_time,
+                    update_time=document.update_time,
+                )
+                self.change_map[document.name] = snapshot
+
+            elif removed:
+                _LOGGER.debug("on_snapshot: document change: REMOVED")
+                document = proto.document_change.document
+                self.change_map[document.name] = ChangeType.REMOVED
+
+        # NB: document_delete and document_remove (as far as we, the client,
+        # are concerned) are functionally equivalent
+
+        elif str(proto.document_delete):
+            _LOGGER.debug("on_snapshot: document change: DELETE")
+            name = proto.document_delete.document
+            self.change_map[name] = ChangeType.REMOVED
+
+        elif str(proto.document_remove):
+            _LOGGER.debug("on_snapshot: document change: REMOVE")
+            name = proto.document_remove.document
+            self.change_map[name] = ChangeType.REMOVED
+
+        elif proto.filter:
+            _LOGGER.debug("on_snapshot: filter update")
+            if proto.filter.count != self._current_size():
+                # We need to remove all the current results.
+                self._reset_docs()
+                # The filter didn't match, so re-issue the query.
+                # TODO: reset stream method?
+                # self._reset_stream();
+
+        else:
+            _LOGGER.debug("UNKNOWN TYPE. UHOH")
+            self.close(reason=ValueError("Unknown listen response type: %s" % proto))
+
+    def push(self, read_time, next_resume_token):
+        """
+        Assembles a new snapshot from the current set of changes and invokes
+        the user's callback. Clears the current changes on completion.
+        """
+        deletes, adds, updates = Watch._extract_changes(
+            self.doc_map, self.change_map, read_time
+        )
+
+        updated_tree, updated_map, appliedChanges = self._compute_snapshot(
+            self.doc_tree, self.doc_map, deletes, adds, updates
+        )
+
+        if not self.has_pushed or len(appliedChanges):
+            # TODO: It is possible in the future we will have the tree order
+            # on insert. For now, we sort here.
+            key = functools.cmp_to_key(self._comparator)
+            keys = sorted(updated_tree.keys(), key=key)
+
+            self._snapshot_callback(
+                keys,
+                appliedChanges,
+                datetime.datetime.fromtimestamp(read_time.seconds, pytz.utc),
+            )
+            self.has_pushed = True
+
+        self.doc_tree = updated_tree
+        self.doc_map = updated_map
+        self.change_map.clear()
+        self.resume_token = next_resume_token
+
+    @staticmethod
+    def _extract_changes(doc_map, changes, read_time):
+        deletes = []
+        adds = []
+        updates = []
+
+        for name, value in changes.items():
+            if value == ChangeType.REMOVED:
+                if name in doc_map:
+                    deletes.append(name)
+            elif name in doc_map:
+                if read_time is not None:
+                    value.read_time = read_time
+                updates.append(value)
+            else:
+                if read_time is not None:
+                    value.read_time = read_time
+                adds.append(value)
+
+        return (deletes, adds, updates)
+
+    def _compute_snapshot(
+        self, doc_tree, doc_map, delete_changes, add_changes, update_changes
+    ):
+        updated_tree = doc_tree
+        updated_map = doc_map
+
+        assert len(doc_tree) == len(doc_map), (
+            "The document tree and document map should have the same "
+            + "number of entries."
+        )
+
+        def delete_doc(name, updated_tree, updated_map):
+            """
+            Applies a document delete to the document tree and document map.
+            Returns the corresponding DocumentChange event.
+            """
+            assert name in updated_map, "Document to delete does not exist"
+            old_document = updated_map.get(name)
+            # TODO: If a document doesn't exist this raises IndexError. Handle?
+            existing = updated_tree.find(old_document)
+            old_index = existing.index
+            updated_tree = updated_tree.remove(old_document)
+            del updated_map[name]
+            return (
+                DocumentChange(ChangeType.REMOVED, old_document, old_index, -1),
+                updated_tree,
+                updated_map,
+            )
+
+        def add_doc(new_document, updated_tree, updated_map):
+            """
+            Applies a document add to the document tree and the document map.
+            Returns the corresponding DocumentChange event.
+            """
+            name = new_document.reference._document_path
+            assert name not in updated_map, "Document to add already exists"
+            updated_tree = updated_tree.insert(new_document, None)
+            new_index = updated_tree.find(new_document).index
+            updated_map[name] = new_document
+            return (
+                DocumentChange(ChangeType.ADDED, new_document, -1, new_index),
+                updated_tree,
+                updated_map,
+            )
+
+        def modify_doc(new_document, updated_tree, updated_map):
+            """
+            Applies a document modification to the document tree and the
+            document map.
+            Returns the DocumentChange event for successful modifications.
+            """
+            name = new_document.reference._document_path
+            assert name in updated_map, "Document to modify does not exist"
+            old_document = updated_map.get(name)
+            if old_document.update_time != new_document.update_time:
+                remove_change, updated_tree, updated_map = delete_doc(
+                    name, updated_tree, updated_map
+                )
+                add_change, updated_tree, updated_map = add_doc(
+                    new_document, updated_tree, updated_map
+                )
+                return (
+                    DocumentChange(
+                        ChangeType.MODIFIED,
+                        new_document,
+                        remove_change.old_index,
+                        add_change.new_index,
+                    ),
+                    updated_tree,
+                    updated_map,
+                )
+
+            return None, updated_tree, updated_map
+
+        # Process the sorted changes in the order that is expected by our
+        # clients (removals, additions, and then modifications). We also need
+        # to sort the individual changes to assure that old_index/new_index
+        # keep incrementing.
+        appliedChanges = []
+
+        key = functools.cmp_to_key(self._comparator)
+
+        # Deletes are sorted based on the order of the existing document.
+        delete_changes = sorted(delete_changes, key=key)
+        for name in delete_changes:
+            change, updated_tree, updated_map = delete_doc(
+                name, updated_tree, updated_map
+            )
+            appliedChanges.append(change)
+
+        add_changes = sorted(add_changes, key=key)
+        _LOGGER.debug("walk over add_changes")
+        for snapshot in add_changes:
+            _LOGGER.debug("in add_changes")
+            change, updated_tree, updated_map = add_doc(
+                snapshot, updated_tree, updated_map
+            )
+            appliedChanges.append(change)
+
+        update_changes = sorted(update_changes, key=key)
+        for snapshot in update_changes:
+            change, updated_tree, updated_map = modify_doc(
+                snapshot, updated_tree, updated_map
+            )
+            if change is not None:
+                appliedChanges.append(change)
+
+        assert len(updated_tree) == len(updated_map), (
+            "The update document "
+            + "tree and document map should have the same number of entries."
+        )
+        return (updated_tree, updated_map, appliedChanges)
+
+    def _affects_target(self, target_ids, current_id):
+        if target_ids is None:
+            return True
+
+        return current_id in target_ids
+
+    def _current_size(self):
+        """
+        Returns the current count of all documents, including the changes from
+        the current changeMap.
+        """
+        deletes, adds, _ = Watch._extract_changes(self.doc_map, self.change_map, None)
+        return len(self.doc_map) + len(adds) - len(deletes)
+
+    def _reset_docs(self):
+        """
+        Helper to clear the docs on RESET or filter mismatch.
+        """
+        _LOGGER.debug("resetting documents")
+        self.change_map.clear()
+        self.resume_token = None
+
+        # Mark each document as deleted. If documents are not deleted
+        # they will be sent again by the server.
+        for snapshot in self.doc_tree.keys():
+            name = snapshot.reference._document_path
+            self.change_map[name] = ChangeType.REMOVED
+
+        self.current = False
diff --git a/firestore/noxfile.py b/firestore/noxfile.py
new file mode 100644
index 000000000000..23026ec11524
--- /dev/null
+++ b/firestore/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("FIRESTORE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--verbose", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--verbose", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/firestore/pylint.config.py b/firestore/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/firestore/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/firestore/setup.cfg b/firestore/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/firestore/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/firestore/setup.py b/firestore/setup.py
new file mode 100644
index 000000000000..0c736ab3c028
--- /dev/null
+++ b/firestore/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-firestore"
+description = "Google Cloud Firestore API client library"
+version = "1.4.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 4 - Beta"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+    "pytz",
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/firestore/synth.metadata b/firestore/synth.metadata
new file mode 100644
index 000000000000..4c0091990642
--- /dev/null
+++ b/firestore/synth.metadata
@@ -0,0 +1,59 @@
+{
+  "updateTime": "2019-08-06T12:25:58.083737Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "firestore",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/firestore/artman_firestore.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "firestore",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/firestore/artman_firestore_v1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "firestore_admin",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/firestore/admin/artman_firestore_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/firestore/synth.py b/firestore/synth.py
new file mode 100644
index 000000000000..3f9adae43767
--- /dev/null
+++ b/firestore/synth.py
@@ -0,0 +1,104 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = [
+    ("v1beta1", "artman_firestore.yaml"),
+    ("v1", "artman_firestore_v1.yaml"),
+]
+admin_versions = [
+    ("v1", "artman_firestore_v1.yaml"),
+]
+
+
+# ----------------------------------------------------------------------------
+# Generate firestore GAPIC layer
+# ----------------------------------------------------------------------------
+for version, artman_config in versions:
+    library = gapic.py_library(
+        "firestore",
+        version,
+        config_path=f"/google/firestore/{artman_config}",
+        artman_output_name=f"firestore-{version}",
+        include_protos=True,
+    )
+
+    s.move(library / f"google/cloud/firestore_{version}/proto")
+    s.move(library / f"google/cloud/firestore_{version}/gapic")
+    s.move(library / f"tests/unit/gapic/{version}")
+
+    s.replace(
+        f"tests/unit/gapic/{version}/test_firestore_client_{version}.py",
+        f"from google.cloud import firestore_{version}",
+        f"from google.cloud.firestore_{version}.gapic import firestore_client",
+    )
+
+    s.replace(
+        f"tests/unit/gapic/{version}/test_firestore_client_{version}.py",
+        f"client = firestore_{version}.FirestoreClient",
+        "client = firestore_client.FirestoreClient",
+    )
+
+
+# ----------------------------------------------------------------------------
+# Generate firestore admin GAPIC layer
+# ----------------------------------------------------------------------------
+for version, artman_config in admin_versions:
+    library = gapic.py_library(
+        "firestore_admin",
+        f"{version}",
+        config_path=f"/google/firestore/admin/{artman_config}",
+        artman_output_name=f"firestore-admin-{version}",
+        include_protos=True,
+    )
+    s.move(library / f"google/cloud/firestore_admin_{version}")
+    s.move(library / "tests")
+
+    s.replace(
+        f"google/cloud/firestore_admin_{version}/gapic/firestore_admin_client.py",
+        "'google-cloud-firestore-admin'",
+        "'google-cloud-firestore'",
+    )
+
+    s.replace(
+        "google/**/*.py",
+        f"from google\.cloud\.firestore\.admin_{version}.proto",
+        f"from google.cloud.firestore_admin_{version}.proto",
+    )
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.replace(
+    "noxfile.py",
+    "GOOGLE_APPLICATION_CREDENTIALS",
+    "FIRESTORE_APPLICATION_CREDENTIALS",
+)
+
+s.replace(
+    "noxfile.py",
+    '"--quiet", system_test',
+    '"--verbose", system_test',
+)
+
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/firestore/tests/__init__.py b/firestore/tests/__init__.py
new file mode 100644
index 000000000000..ab6729095248
--- /dev/null
+++ b/firestore/tests/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/firestore/tests/credentials.json.enc b/firestore/tests/credentials.json.enc
new file mode 100644
index 000000000000..116006733a7c
--- /dev/null
+++ b/firestore/tests/credentials.json.enc
@@ -0,0 +1,49 @@
+U2FsdGVkX181Zp8xOq7t5YHHn2l4tdYVICGvNLvusMtFxrKj1zKI2NP8nKstyA8O
+xDlBMBMoVNV1GgPPDQ7Hihb6vYwWlSVcvisCqpgz7P4bTFeyheJso1MVO1maS0Ha
+ESj8HXrCkMhVv62LogkMXyJF+bsZy9BwaAg9502IVpmYKEwt8CoA+qZwSngpj0Eh
+eFwiulHcu6JPVjMFVKhq/PW3YtJa876VKVDB0dEGWMoA9bFVqcIi4js8sRCbsSj+
+IYnOkZyQ4E/3t7u/dIyELVsapefmH+GOfg56cD7ZtSkDyBKQp0YylqvRCXytsfpG
+WV8qgOLdALPWoI7kjUV6dcwK9jf1HpEAf+LK0gm483qq17UM4gZQSD/dmFnEZrHT
+PUZNxhW9iV/UVOvhNjrvzRxADT+tuW8DoPEVH0ZJm05ui21cwLfieqIvN6SbZDvO
+aDS9OUZSFfkReGc5F9UHHBw6T1uG/fEGnu2oFl98TWw6JgZfhsNnqlDQyjcI/aKV
+8/oP35x40Ky3V5yBNQGnbsV8N5Btbs5oDI8SGrzEamwwZP0AsdB7nApxjcmDsCgH
+nAWR9Kvpu4OY1X+27xjALWoIxcPAhs5RSXyY7oC33JdhcwqKMIsls+K63P1wZ2kd
+pb5Cen0dAAXf2tc5GsPAsBJNfU0X8NJ+24nXfBvbkxo8paeoGaP3WQQpkhy/Dd/i
+EMNkH++uQAYecFEOvFnjmwo9xzuGiaP60ZQDyGONiaHftHeLts6/aVkhzFFLcigE
+lUepi3cEX143+ciC3+C/4kuiuwxHIrQjfI7izxh6+KquKgKGwgcrjqu7Pz3BgsGw
+fqH8lXjQK+oB0tmc52kSjopa40JT8pVgMOzhu1rbgQBkt4ByzFL4nC291PtMB27C
+mCBZ/RL+xObGuRL1t/jcK9lIbA+8CTrDMwpqCzU1IZgdD2mBXg8KK+iPV8vOjorN
+G+kEAeuyGJY6wsvAILK58JoppZrBU1IAqTdypoNkg5tUs08z2d0H4YOjRq8+2F13
+fCW0+vv5OaEnPniS2edPcGwIWIiLbTFqlkx+PFpvuB0riS+j5vaZlaSIoy8EnVjp
+QOBriBjX9cXHw6nzWFJDJwsLlddVGyqCIKtr1mHtvjYZQ9w75IjHip1fimHI2Dhn
+05kAfC5c2b1R0Y0NrUaSx/x2Q6RZ8R1NoI25rfvKhZmtrF8MNWBklKcAImWhipFy
+I2mYX9jj4dvlXaXt5oYKvMfR4EZMgjTtbg0oGafmnJQEYWFahtSEotT/ZHYHfFNr
+HXXinXhVi5VPTyoxj9jxNbt9v0y5PXcyI2ize4pr5cwcef6LMr8og9JAABFi1nbm
+AAQacoRcDdY0m8RAj0a1sGcjoCMOdn0yYMeyScz35gnYQQaIdw/SLQ/q40KOK9+J
+kqQJmTAn8m4M4qYV12i3m1+5JRQuJ4nfA5a2mi63eNJlar/EuM9B5FFxdEdvzYBr
+7g77rQppV0d/Ufw8lCFbU1fuVxUz79FfFF78a+lhqxzmww08SyoFHZO0k5rFDZdW
+C7CYv0va5Yoi2gPfjngutrsfExenFbFxP2GbndHe8GOT31rBHAvKLiokjkgNlWyw
+Ew8JngWjufu2BWspQfDpFYX8DGmxfT0E22QWoiPrn96Hfbb8xuDw/rVUDzBMOak4
+ry/6f8zpNjAPgjfBGKHnARGOKPUV3Qd3JKJ4uCSvyvfKkXg3HOl/H1WGRu38uZFs
+JDIK4SyLL8oYQwQyqpH7MmW3WQBBBkK/HoalezhL4/1F0AAGyZPIhWKlTFCsOMiY
+9qAkOSeDFjhkAuUXHWvXc3Lu9Yl3aKGovZXmHiTUqAXKCeoM97u4a4/E3ByV/aF0
+NEL4X6QWOWMPFWrumeanz4hOk1XxwLzV0HEDR+FNXrNoIdvX52T5Qz46RgicWhAV
+o0xW/xtnlWsw9fkzWcUeAcxFUsMVpmz9OC83jpF9MD2kBSDq5WYIKsqtcuEiBC3i
+8kAylDQBYrDE9H21AXecUkWL+xBfs8S4rx6mscxyq80glq/QrU3mj55B5bIW0dUL
+d/DhqqCtL+JRKCSQ75OKJoVRKGSQ6MqTZ6vpE26rU4jH9PQf9mcsCYll3OKdYWR+
+JiATGEqihDxyVLzZucUqemOQc3HZ9B4AVCvsD3heRvxMWQw6ylQCBhe5oYeSVKPv
+/FEsUT+NyxtrZgui4/V9lYOcblgoxvPzcaUhlzEIOl5foxmOGtd4g0DCK9yrpUo5
+djeMks5wVgqgVsDsCLimd42WivCOGswzzxyGwX1A5JvBrktPZcEGYCBXOwenEM4n
+aNR6W6b/0B/i30pEL2TO1TTRc8XU7pgOsKgCr5pDwuAhO1Me2aWL6cfF9MU0+pIJ
+OVysd9GSty0Uv/oijI4W/ID6ar5/r9T+yJYc77qU5cxmqNwjm2RuY8KJidGsIvXw
+nrjpiTVzKMHlTQlINCUf7dKxRQxvuWjH4zyu/ZtlpfaSY+2QfSjv0yxf9uTyGC2S
+KIK06MiRr6fOhcSdNJUFF0i9y30+1ocFyCnigoydG3Zz9sJGSX1+VPpnx4d4cHWa
+44h0XQZWY5KHsFJUuwnMI3bsn+GU0rGY5QzjGJZWwYsMU3GmVOUmPeTj060/1b1d
+IRs03RF2oYOWXLYTBfkXgmkOPACFZa7nZf58c7B8iccvpPu6LhAT9KTCTG8QhKsC
+Pi3W0v33OJUBURGEDBMg9h0D1U2xBrAAxxYSRD5hEOFJGaJdee6kYCnQ5DMBEa4h
+arH23X4a7az/9ENLmrTok7g+LNTqahhsWLbBVPTmNRhbZAXfHbB58lsTG8/bckxP
+9+JpIDfOCh3gA32dXsDauZ3SbNMwv+bLUUU6CpnzWXhMRzNXPT6euEG6HNyjpG5/
+WrS0/pli83i/82/8gal7aVWA9EabFnAyHXMINzf0mi/zxdxlyvmryb+RWiF19c6R
+cN2P5fZnDE8BcWRQ0gPDQPCRd8b7BIywAmHHkwUJkbObaJWfNrT2ns1zC5nF67Rs
+eUnfI1BbImEbE6r7f21cOQHFocW4oTBIRRYMFGgZKjHjbAcYFkewFUw24DaxbZS5
+NWqeTf5FMT/UOcDod/Sz7DWoXvYsLGYruAwi9TBAMIM=
diff --git a/firestore/tests/system/test_system.py b/firestore/tests/system/test_system.py
new file mode 100644
index 000000000000..f2d30c94a171
--- /dev/null
+++ b/firestore/tests/system/test_system.py
@@ -0,0 +1,1083 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import math
+import operator
+import os
+import re
+
+from google.oauth2 import service_account
+from google.protobuf import timestamp_pb2
+import pytest
+import six
+
+from google.api_core.exceptions import AlreadyExists
+from google.api_core.exceptions import FailedPrecondition
+from google.api_core.exceptions import InvalidArgument
+from google.api_core.exceptions import NotFound
+from google.cloud._helpers import _pb_timestamp_to_datetime
+from google.cloud._helpers import UTC
+from google.cloud import firestore_v1 as firestore
+from test_utils.system import unique_resource_id
+
+from time import sleep
+
+FIRESTORE_CREDS = os.environ.get("FIRESTORE_APPLICATION_CREDENTIALS")
+FIRESTORE_PROJECT = os.environ.get("GCLOUD_PROJECT")
+RANDOM_ID_REGEX = re.compile("^[a-zA-Z0-9]{20}$")
+MISSING_DOCUMENT = "No document to update: "
+DOCUMENT_EXISTS = "Document already exists: "
+UNIQUE_RESOURCE_ID = unique_resource_id("-")
+
+
+@pytest.fixture(scope=u"module")
+def client():
+    credentials = service_account.Credentials.from_service_account_file(FIRESTORE_CREDS)
+    project = FIRESTORE_PROJECT or credentials.project_id
+    yield firestore.Client(project=project, credentials=credentials)
+
+
+@pytest.fixture
+def cleanup():
+    operations = []
+    yield operations.append
+
+    for operation in operations:
+        operation()
+
+
+def test_collections(client):
+    collections = list(client.collections())
+    assert isinstance(collections, list)
+
+
+def test_create_document(client, cleanup):
+    now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+    collection_id = "doc-create" + UNIQUE_RESOURCE_ID
+    document_id = "doc" + UNIQUE_RESOURCE_ID
+    document = client.document(collection_id, document_id)
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document.delete)
+
+    data = {
+        "now": firestore.SERVER_TIMESTAMP,
+        "eenta-ger": 11,
+        "bites": b"\xe2\x98\x83 \xe2\x9b\xb5",
+        "also": {"nestednow": firestore.SERVER_TIMESTAMP, "quarter": 0.25},
+    }
+    write_result = document.create(data)
+    updated = _pb_timestamp_to_datetime(write_result.update_time)
+    delta = updated - now
+    # Allow a bit of clock skew, but make sure timestamps are close.
+    assert -300.0 < delta.total_seconds() < 300.0
+
+    with pytest.raises(AlreadyExists):
+        document.create(data)
+
+    # Verify the server times.
+    snapshot = document.get()
+    stored_data = snapshot.to_dict()
+    server_now = stored_data["now"]
+
+    delta = updated - server_now
+    # NOTE: We could check the ``transform_results`` from the write result
+    #       for the document transform, but this value gets dropped. Instead
+    #       we make sure the timestamps are close.
+    assert 0.0 <= delta.total_seconds() < 5.0
+    expected_data = {
+        "now": server_now,
+        "eenta-ger": data["eenta-ger"],
+        "bites": data["bites"],
+        "also": {"nestednow": server_now, "quarter": data["also"]["quarter"]},
+    }
+    assert stored_data == expected_data
+
+
+def test_create_document_w_subcollection(client, cleanup):
+    collection_id = "doc-create-sub" + UNIQUE_RESOURCE_ID
+    document_id = "doc" + UNIQUE_RESOURCE_ID
+    document = client.document(collection_id, document_id)
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document.delete)
+
+    data = {"now": firestore.SERVER_TIMESTAMP}
+    document.create(data)
+
+    child_ids = ["child1", "child2"]
+
+    for child_id in child_ids:
+        subcollection = document.collection(child_id)
+        _, subdoc = subcollection.add({"foo": "bar"})
+        cleanup(subdoc.delete)
+
+    children = document.collections()
+    assert sorted(child.id for child in children) == sorted(child_ids)
+
+
+def test_cannot_use_foreign_key(client, cleanup):
+    document_id = "cannot" + UNIQUE_RESOURCE_ID
+    document = client.document("foreign-key", document_id)
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document.delete)
+
+    other_client = firestore.Client(
+        project="other-prahj", credentials=client._credentials, database="dee-bee"
+    )
+    assert other_client._database_string != client._database_string
+    fake_doc = other_client.document("foo", "bar")
+    with pytest.raises(InvalidArgument):
+        document.create({"ref": fake_doc})
+
+
+def assert_timestamp_less(timestamp_pb1, timestamp_pb2):
+    dt_val1 = _pb_timestamp_to_datetime(timestamp_pb1)
+    dt_val2 = _pb_timestamp_to_datetime(timestamp_pb2)
+    assert dt_val1 < dt_val2
+
+
+def test_no_document(client):
+    document_id = "no_document" + UNIQUE_RESOURCE_ID
+    document = client.document("abcde", document_id)
+    snapshot = document.get()
+    assert snapshot.to_dict() is None
+
+
+def test_document_set(client, cleanup):
+    document_id = "for-set" + UNIQUE_RESOURCE_ID
+    document = client.document("i-did-it", document_id)
+    # Add to clean-up before API request (in case ``set()`` fails).
+    cleanup(document.delete)
+
+    # 0. Make sure the document doesn't exist yet
+    snapshot = document.get()
+    assert snapshot.to_dict() is None
+
+    # 1. Use ``create()`` to create the document.
+    data1 = {"foo": 88}
+    write_result1 = document.create(data1)
+    snapshot1 = document.get()
+    assert snapshot1.to_dict() == data1
+    # Make sure the update is what created the document.
+    assert snapshot1.create_time == snapshot1.update_time
+    assert snapshot1.update_time == write_result1.update_time
+
+    # 2. Call ``set()`` again to overwrite.
+    data2 = {"bar": None}
+    write_result2 = document.set(data2)
+    snapshot2 = document.get()
+    assert snapshot2.to_dict() == data2
+    # Make sure the create time hasn't changed.
+    assert snapshot2.create_time == snapshot1.create_time
+    assert snapshot2.update_time == write_result2.update_time
+
+
+def test_document_integer_field(client, cleanup):
+    document_id = "for-set" + UNIQUE_RESOURCE_ID
+    document = client.document("i-did-it", document_id)
+    # Add to clean-up before API request (in case ``set()`` fails).
+    cleanup(document.delete)
+
+    data1 = {"1a": {"2b": "3c", "ab": "5e"}, "6f": {"7g": "8h", "cd": "0j"}}
+    document.create(data1)
+
+    data2 = {"1a.ab": "4d", "6f.7g": "9h"}
+    document.update(data2)
+    snapshot = document.get()
+    expected = {"1a": {"2b": "3c", "ab": "4d"}, "6f": {"7g": "9h", "cd": "0j"}}
+    assert snapshot.to_dict() == expected
+
+
+def test_document_set_merge(client, cleanup):
+    document_id = "for-set" + UNIQUE_RESOURCE_ID
+    document = client.document("i-did-it", document_id)
+    # Add to clean-up before API request (in case ``set()`` fails).
+    cleanup(document.delete)
+
+    # 0. Make sure the document doesn't exist yet
+    snapshot = document.get()
+    assert not snapshot.exists
+
+    # 1. Use ``create()`` to create the document.
+    data1 = {"name": "Sam", "address": {"city": "SF", "state": "CA"}}
+    write_result1 = document.create(data1)
+    snapshot1 = document.get()
+    assert snapshot1.to_dict() == data1
+    # Make sure the update is what created the document.
+    assert snapshot1.create_time == snapshot1.update_time
+    assert snapshot1.update_time == write_result1.update_time
+
+    # 2. Call ``set()`` to merge
+    data2 = {"address": {"city": "LA"}}
+    write_result2 = document.set(data2, merge=True)
+    snapshot2 = document.get()
+    assert snapshot2.to_dict() == {
+        "name": "Sam",
+        "address": {"city": "LA", "state": "CA"},
+    }
+    # Make sure the create time hasn't changed.
+    assert snapshot2.create_time == snapshot1.create_time
+    assert snapshot2.update_time == write_result2.update_time
+
+
+def test_document_set_w_int_field(client, cleanup):
+    document_id = "set-int-key" + UNIQUE_RESOURCE_ID
+    document = client.document("i-did-it", document_id)
+    # Add to clean-up before API request (in case ``set()`` fails).
+    cleanup(document.delete)
+
+    # 0. Make sure the document doesn't exist yet
+    snapshot = document.get()
+    assert not snapshot.exists
+
+    # 1. Use ``create()`` to create the document.
+    before = {"testing": "1"}
+    document.create(before)
+
+    # 2. Replace using ``set()``.
+    data = {"14": {"status": "active"}}
+    document.set(data)
+
+    # 3. Verify replaced data.
+    snapshot1 = document.get()
+    assert snapshot1.to_dict() == data
+
+
+def test_document_update_w_int_field(client, cleanup):
+    # Attempt to reproduce #5489.
+    document_id = "update-int-key" + UNIQUE_RESOURCE_ID
+    document = client.document("i-did-it", document_id)
+    # Add to clean-up before API request (in case ``set()`` fails).
+    cleanup(document.delete)
+
+    # 0. Make sure the document doesn't exist yet
+    snapshot = document.get()
+    assert not snapshot.exists
+
+    # 1. Use ``create()`` to create the document.
+    before = {"testing": "1"}
+    document.create(before)
+
+    # 2. Add values using ``update()``.
+    data = {"14": {"status": "active"}}
+    document.update(data)
+
+    # 3. Verify updated data.
+    expected = before.copy()
+    expected.update(data)
+    snapshot1 = document.get()
+    assert snapshot1.to_dict() == expected
+
+
+def test_update_document(client, cleanup):
+    document_id = "for-update" + UNIQUE_RESOURCE_ID
+    document = client.document("made", document_id)
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document.delete)
+
+    # 0. Try to update before the document exists.
+    with pytest.raises(NotFound) as exc_info:
+        document.update({"not": "there"})
+    assert exc_info.value.message.startswith(MISSING_DOCUMENT)
+    assert document_id in exc_info.value.message
+
+    # 1. Try to update before the document exists (now with an option).
+    with pytest.raises(NotFound) as exc_info:
+        document.update({"still": "not-there"})
+    assert exc_info.value.message.startswith(MISSING_DOCUMENT)
+    assert document_id in exc_info.value.message
+
+    # 2. Update and create the document (with an option).
+    data = {"foo": {"bar": "baz"}, "scoop": {"barn": 981}, "other": True}
+    write_result2 = document.create(data)
+
+    # 3. Send an update without a field path (no option).
+    field_updates3 = {"foo": {"quux": 800}}
+    write_result3 = document.update(field_updates3)
+    assert_timestamp_less(write_result2.update_time, write_result3.update_time)
+    snapshot3 = document.get()
+    expected3 = {
+        "foo": field_updates3["foo"],
+        "scoop": data["scoop"],
+        "other": data["other"],
+    }
+    assert snapshot3.to_dict() == expected3
+
+    # 4. Send an update **with** a field path and a delete and a valid
+    #    "last timestamp" option.
+    field_updates4 = {"scoop.silo": None, "other": firestore.DELETE_FIELD}
+    option4 = client.write_option(last_update_time=snapshot3.update_time)
+    write_result4 = document.update(field_updates4, option=option4)
+    assert_timestamp_less(write_result3.update_time, write_result4.update_time)
+    snapshot4 = document.get()
+    expected4 = {
+        "foo": field_updates3["foo"],
+        "scoop": {"barn": data["scoop"]["barn"], "silo": field_updates4["scoop.silo"]},
+    }
+    assert snapshot4.to_dict() == expected4
+
+    # 5. Call ``update()`` with invalid (in the past) "last timestamp" option.
+    assert_timestamp_less(option4._last_update_time, snapshot4.update_time)
+    with pytest.raises(FailedPrecondition) as exc_info:
+        document.update({"bad": "time-past"}, option=option4)
+
+    # 6. Call ``update()`` with invalid (in future) "last timestamp" option.
+    timestamp_pb = timestamp_pb2.Timestamp(
+        seconds=snapshot4.update_time.nanos + 3600, nanos=snapshot4.update_time.nanos
+    )
+    option6 = client.write_option(last_update_time=timestamp_pb)
+    with pytest.raises(FailedPrecondition) as exc_info:
+        document.update({"bad": "time-future"}, option=option6)
+
+
+def check_snapshot(snapshot, document, data, write_result):
+    assert snapshot.reference is document
+    assert snapshot.to_dict() == data
+    assert snapshot.exists
+    assert snapshot.create_time == write_result.update_time
+    assert snapshot.update_time == write_result.update_time
+
+
+def test_document_get(client, cleanup):
+    now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+    document_id = "for-get" + UNIQUE_RESOURCE_ID
+    document = client.document("created", document_id)
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document.delete)
+
+    # First make sure it doesn't exist.
+    assert not document.get().exists
+
+    ref_doc = client.document("top", "middle1", "middle2", "bottom")
+    data = {
+        "turtle": "power",
+        "cheese": 19.5,
+        "fire": 199099299,
+        "referee": ref_doc,
+        "gio": firestore.GeoPoint(45.5, 90.0),
+        "deep": [u"some", b"\xde\xad\xbe\xef"],
+        "map": {"ice": True, "water": None, "vapor": {"deeper": now}},
+    }
+    write_result = document.create(data)
+    snapshot = document.get()
+    check_snapshot(snapshot, document, data, write_result)
+
+
+def test_document_delete(client, cleanup):
+    document_id = "deleted" + UNIQUE_RESOURCE_ID
+    document = client.document("here-to-be", document_id)
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document.delete)
+    document.create({"not": "much"})
+
+    # 1. Call ``delete()`` with invalid (in the past) "last timestamp" option.
+    snapshot1 = document.get()
+    timestamp_pb = timestamp_pb2.Timestamp(
+        seconds=snapshot1.update_time.nanos - 3600, nanos=snapshot1.update_time.nanos
+    )
+    option1 = client.write_option(last_update_time=timestamp_pb)
+    with pytest.raises(FailedPrecondition):
+        document.delete(option=option1)
+
+    # 2. Call ``delete()`` with invalid (in future) "last timestamp" option.
+    timestamp_pb = timestamp_pb2.Timestamp(
+        seconds=snapshot1.update_time.nanos + 3600, nanos=snapshot1.update_time.nanos
+    )
+    option2 = client.write_option(last_update_time=timestamp_pb)
+    with pytest.raises(FailedPrecondition):
+        document.delete(option=option2)
+
+    # 3. Actually ``delete()`` the document.
+    delete_time3 = document.delete()
+
+    # 4. ``delete()`` again, even though we know the document is gone.
+    delete_time4 = document.delete()
+    assert_timestamp_less(delete_time3, delete_time4)
+
+
+def test_collection_add(client, cleanup):
+    collection_id = "coll-add" + UNIQUE_RESOURCE_ID
+    collection1 = client.collection(collection_id)
+    collection2 = client.collection(collection_id, "doc", "child")
+    collection3 = client.collection(collection_id, "table", "child")
+    explicit_doc_id = "hula" + UNIQUE_RESOURCE_ID
+
+    assert set(collection1.list_documents()) == set()
+    assert set(collection2.list_documents()) == set()
+    assert set(collection3.list_documents()) == set()
+
+    # Auto-ID at top-level.
+    data1 = {"foo": "bar"}
+    update_time1, document_ref1 = collection1.add(data1)
+    cleanup(document_ref1.delete)
+    assert set(collection1.list_documents()) == {document_ref1}
+    assert set(collection2.list_documents()) == set()
+    assert set(collection3.list_documents()) == set()
+    snapshot1 = document_ref1.get()
+    assert snapshot1.to_dict() == data1
+    assert snapshot1.update_time == update_time1
+    assert RANDOM_ID_REGEX.match(document_ref1.id)
+
+    # Explicit ID at top-level.
+    data2 = {"baz": 999}
+    update_time2, document_ref2 = collection1.add(data2, document_id=explicit_doc_id)
+    cleanup(document_ref2.delete)
+    assert set(collection1.list_documents()) == {document_ref1, document_ref2}
+    assert set(collection2.list_documents()) == set()
+    assert set(collection3.list_documents()) == set()
+    snapshot2 = document_ref2.get()
+    assert snapshot2.to_dict() == data2
+    assert snapshot2.create_time == update_time2
+    assert snapshot2.update_time == update_time2
+    assert document_ref2.id == explicit_doc_id
+
+    nested_ref = collection1.document("doc")
+
+    # Auto-ID for nested collection.
+    data3 = {"quux": b"\x00\x01\x02\x03"}
+    update_time3, document_ref3 = collection2.add(data3)
+    cleanup(document_ref3.delete)
+    assert set(collection1.list_documents()) == {
+        document_ref1,
+        document_ref2,
+        nested_ref,
+    }
+    assert set(collection2.list_documents()) == {document_ref3}
+    assert set(collection3.list_documents()) == set()
+    snapshot3 = document_ref3.get()
+    assert snapshot3.to_dict() == data3
+    assert snapshot3.update_time == update_time3
+    assert RANDOM_ID_REGEX.match(document_ref3.id)
+
+    # Explicit for nested collection.
+    data4 = {"kazaam": None, "bad": False}
+    update_time4, document_ref4 = collection2.add(data4, document_id=explicit_doc_id)
+    cleanup(document_ref4.delete)
+    assert set(collection1.list_documents()) == {
+        document_ref1,
+        document_ref2,
+        nested_ref,
+    }
+    assert set(collection2.list_documents()) == {document_ref3, document_ref4}
+    assert set(collection3.list_documents()) == set()
+    snapshot4 = document_ref4.get()
+    assert snapshot4.to_dict() == data4
+    assert snapshot4.create_time == update_time4
+    assert snapshot4.update_time == update_time4
+    assert document_ref4.id == explicit_doc_id
+
+    # Exercise "missing" document (no doc, but subcollection).
+    data5 = {"bam": 123, "folyk": False}
+    update_time5, document_ref5 = collection3.add(data5)
+    cleanup(document_ref5.delete)
+    missing_ref = collection1.document("table")
+    assert set(collection1.list_documents()) == {
+        document_ref1,
+        document_ref2,
+        nested_ref,
+        missing_ref,
+    }
+    assert set(collection2.list_documents()) == {document_ref3, document_ref4}
+    assert set(collection3.list_documents()) == {document_ref5}
+
+
+def test_query_stream(client, cleanup):
+    collection_id = "qs" + UNIQUE_RESOURCE_ID
+    sub_collection = "child" + UNIQUE_RESOURCE_ID
+    collection = client.collection(collection_id, "doc", sub_collection)
+
+    stored = {}
+    num_vals = 5
+    allowed_vals = six.moves.xrange(num_vals)
+    for a_val in allowed_vals:
+        for b_val in allowed_vals:
+            document_data = {
+                "a": a_val,
+                "b": b_val,
+                "stats": {"sum": a_val + b_val, "product": a_val * b_val},
+            }
+            _, doc_ref = collection.add(document_data)
+            # Add to clean-up.
+            cleanup(doc_ref.delete)
+            stored[doc_ref.id] = document_data
+
+    # 0. Limit to snapshots where ``a==1``.
+    query0 = collection.where("a", "==", 1)
+    values0 = {snapshot.id: snapshot.to_dict() for snapshot in query0.stream()}
+    assert len(values0) == num_vals
+    for key, value in six.iteritems(values0):
+        assert stored[key] == value
+        assert value["a"] == 1
+
+    # 1. Order by ``b``.
+    query1 = collection.order_by("b", direction=query0.DESCENDING)
+    values1 = [(snapshot.id, snapshot.to_dict()) for snapshot in query1.stream()]
+    assert len(values1) == len(stored)
+    b_vals1 = []
+    for key, value in values1:
+        assert stored[key] == value
+        b_vals1.append(value["b"])
+    # Make sure the ``b``-values are in DESCENDING order.
+    assert sorted(b_vals1, reverse=True) == b_vals1
+
+    # 2. Limit to snapshots where ``stats.sum > 1`` (a field path).
+    query2 = collection.where("stats.sum", ">", 4)
+    values2 = {snapshot.id: snapshot.to_dict() for snapshot in query2.stream()}
+    assert len(values2) == 10
+    ab_pairs2 = set()
+    for key, value in six.iteritems(values2):
+        assert stored[key] == value
+        ab_pairs2.add((value["a"], value["b"]))
+
+    expected_ab_pairs = set(
+        [
+            (a_val, b_val)
+            for a_val in allowed_vals
+            for b_val in allowed_vals
+            if a_val + b_val > 4
+        ]
+    )
+    assert expected_ab_pairs == ab_pairs2
+
+    # 3. Use a start and end cursor.
+    query3 = (
+        collection.order_by("a")
+        .start_at({"a": num_vals - 2})
+        .end_before({"a": num_vals - 1})
+    )
+    values3 = [(snapshot.id, snapshot.to_dict()) for snapshot in query3.stream()]
+    assert len(values3) == num_vals
+    for key, value in values3:
+        assert stored[key] == value
+        assert value["a"] == num_vals - 2
+        b_vals1.append(value["b"])
+
+    # 4. Send a query with no results.
+    query4 = collection.where("b", "==", num_vals + 100)
+    values4 = list(query4.stream())
+    assert len(values4) == 0
+
+    # 5. Select a subset of fields.
+    query5 = collection.where("b", "<=", 1)
+    query5 = query5.select(["a", "stats.product"])
+    values5 = {snapshot.id: snapshot.to_dict() for snapshot in query5.stream()}
+    assert len(values5) == num_vals * 2  # a ANY, b in (0, 1)
+    for key, value in six.iteritems(values5):
+        expected = {
+            "a": stored[key]["a"],
+            "stats": {"product": stored[key]["stats"]["product"]},
+        }
+        assert expected == value
+
+    # 6. Add multiple filters via ``where()``.
+    query6 = collection.where("stats.product", ">", 5)
+    query6 = query6.where("stats.product", "<", 10)
+    values6 = {snapshot.id: snapshot.to_dict() for snapshot in query6.stream()}
+
+    matching_pairs = [
+        (a_val, b_val)
+        for a_val in allowed_vals
+        for b_val in allowed_vals
+        if 5 < a_val * b_val < 10
+    ]
+    assert len(values6) == len(matching_pairs)
+    for key, value in six.iteritems(values6):
+        assert stored[key] == value
+        pair = (value["a"], value["b"])
+        assert pair in matching_pairs
+
+    # 7. Skip the first three results, when ``b==2``
+    query7 = collection.where("b", "==", 2)
+    offset = 3
+    query7 = query7.offset(offset)
+    values7 = {snapshot.id: snapshot.to_dict() for snapshot in query7.stream()}
+    # NOTE: We don't check the ``a``-values, since that would require
+    #       an ``order_by('a')``, which combined with the ``b == 2``
+    #       filter would necessitate an index.
+    assert len(values7) == num_vals - offset
+    for key, value in six.iteritems(values7):
+        assert stored[key] == value
+        assert value["b"] == 2
+
+
+def test_query_with_order_dot_key(client, cleanup):
+    db = client
+    collection_id = "collek" + unique_resource_id("-")
+    collection = db.collection(collection_id)
+    for index in range(100, -1, -1):
+        doc = collection.document("test_{:09d}".format(index))
+        data = {"count": 10 * index, "wordcount": {"page1": index * 10 + 100}}
+        doc.set(data)
+        cleanup(doc.delete)
+    query = collection.order_by("wordcount.page1").limit(3)
+    data = [doc.to_dict()["wordcount"]["page1"] for doc in query.stream()]
+    assert [100, 110, 120] == data
+    for snapshot in collection.order_by("wordcount.page1").limit(3).stream():
+        last_value = snapshot.get("wordcount.page1")
+    cursor_with_nested_keys = {"wordcount": {"page1": last_value}}
+    found = list(
+        collection.order_by("wordcount.page1")
+        .start_after(cursor_with_nested_keys)
+        .limit(3)
+        .stream()
+    )
+    found_data = [
+        {u"count": 30, u"wordcount": {u"page1": 130}},
+        {u"count": 40, u"wordcount": {u"page1": 140}},
+        {u"count": 50, u"wordcount": {u"page1": 150}},
+    ]
+    assert found_data == [snap.to_dict() for snap in found]
+    cursor_with_dotted_paths = {"wordcount.page1": last_value}
+    cursor_with_key_data = list(
+        collection.order_by("wordcount.page1")
+        .start_after(cursor_with_dotted_paths)
+        .limit(3)
+        .stream()
+    )
+    assert found_data == [snap.to_dict() for snap in cursor_with_key_data]
+
+
+def test_query_unary(client, cleanup):
+    collection_name = "unary" + UNIQUE_RESOURCE_ID
+    collection = client.collection(collection_name)
+    field_name = "foo"
+
+    _, document0 = collection.add({field_name: None})
+    # Add to clean-up.
+    cleanup(document0.delete)
+
+    nan_val = float("nan")
+    _, document1 = collection.add({field_name: nan_val})
+    # Add to clean-up.
+    cleanup(document1.delete)
+
+    # 0. Query for null.
+    query0 = collection.where(field_name, "==", None)
+    values0 = list(query0.stream())
+    assert len(values0) == 1
+    snapshot0 = values0[0]
+    assert snapshot0.reference._path == document0._path
+    assert snapshot0.to_dict() == {field_name: None}
+
+    # 1. Query for a NAN.
+    query1 = collection.where(field_name, "==", nan_val)
+    values1 = list(query1.stream())
+    assert len(values1) == 1
+    snapshot1 = values1[0]
+    assert snapshot1.reference._path == document1._path
+    data1 = snapshot1.to_dict()
+    assert len(data1) == 1
+    assert math.isnan(data1[field_name])
+
+
+def test_collection_group_queries(client, cleanup):
+    collection_group = "b" + UNIQUE_RESOURCE_ID
+
+    doc_paths = [
+        "abc/123/" + collection_group + "/cg-doc1",
+        "abc/123/" + collection_group + "/cg-doc2",
+        collection_group + "/cg-doc3",
+        collection_group + "/cg-doc4",
+        "def/456/" + collection_group + "/cg-doc5",
+        collection_group + "/virtual-doc/nested-coll/not-cg-doc",
+        "x" + collection_group + "/not-cg-doc",
+        collection_group + "x/not-cg-doc",
+        "abc/123/" + collection_group + "x/not-cg-doc",
+        "abc/123/x" + collection_group + "/not-cg-doc",
+        "abc/" + collection_group,
+    ]
+
+    batch = client.batch()
+    for doc_path in doc_paths:
+        doc_ref = client.document(doc_path)
+        batch.set(doc_ref, {"x": 1})
+        cleanup(doc_ref.delete)
+
+    batch.commit()
+
+    query = client.collection_group(collection_group)
+    snapshots = list(query.stream())
+    found = [snapshot.id for snapshot in snapshots]
+    expected = ["cg-doc1", "cg-doc2", "cg-doc3", "cg-doc4", "cg-doc5"]
+    assert found == expected
+
+
+def test_collection_group_queries_startat_endat(client, cleanup):
+    collection_group = "b" + UNIQUE_RESOURCE_ID
+
+    doc_paths = [
+        "a/a/" + collection_group + "/cg-doc1",
+        "a/b/a/b/" + collection_group + "/cg-doc2",
+        "a/b/" + collection_group + "/cg-doc3",
+        "a/b/c/d/" + collection_group + "/cg-doc4",
+        "a/c/" + collection_group + "/cg-doc5",
+        collection_group + "/cg-doc6",
+        "a/b/nope/nope",
+    ]
+
+    batch = client.batch()
+    for doc_path in doc_paths:
+        doc_ref = client.document(doc_path)
+        batch.set(doc_ref, {"x": doc_path})
+        cleanup(doc_ref.delete)
+
+    batch.commit()
+
+    query = (
+        client.collection_group(collection_group)
+        .order_by("__name__")
+        .start_at([client.document("a/b")])
+        .end_at([client.document("a/b0")])
+    )
+    snapshots = list(query.stream())
+    found = set(snapshot.id for snapshot in snapshots)
+    assert found == set(["cg-doc2", "cg-doc3", "cg-doc4"])
+
+    query = (
+        client.collection_group(collection_group)
+        .order_by("__name__")
+        .start_after([client.document("a/b")])
+        .end_before([client.document("a/b/" + collection_group + "/cg-doc3")])
+    )
+    snapshots = list(query.stream())
+    found = set(snapshot.id for snapshot in snapshots)
+    assert found == set(["cg-doc2"])
+
+
+def test_collection_group_queries_filters(client, cleanup):
+    collection_group = "b" + UNIQUE_RESOURCE_ID
+
+    doc_paths = [
+        "a/a/" + collection_group + "/cg-doc1",
+        "a/b/a/b/" + collection_group + "/cg-doc2",
+        "a/b/" + collection_group + "/cg-doc3",
+        "a/b/c/d/" + collection_group + "/cg-doc4",
+        "a/c/" + collection_group + "/cg-doc5",
+        collection_group + "/cg-doc6",
+        "a/b/nope/nope",
+    ]
+
+    batch = client.batch()
+
+    for index, doc_path in enumerate(doc_paths):
+        doc_ref = client.document(doc_path)
+        batch.set(doc_ref, {"x": index})
+        cleanup(doc_ref.delete)
+
+    batch.commit()
+
+    query = (
+        client.collection_group(collection_group)
+        .where(
+            firestore.field_path.FieldPath.document_id(), ">=", client.document("a/b")
+        )
+        .where(
+            firestore.field_path.FieldPath.document_id(), "<=", client.document("a/b0")
+        )
+    )
+    snapshots = list(query.stream())
+    found = set(snapshot.id for snapshot in snapshots)
+    assert found == set(["cg-doc2", "cg-doc3", "cg-doc4"])
+
+    query = (
+        client.collection_group(collection_group)
+        .where(
+            firestore.field_path.FieldPath.document_id(), ">", client.document("a/b")
+        )
+        .where(
+            firestore.field_path.FieldPath.document_id(),
+            "<",
+            client.document("a/b/{}/cg-doc3".format(collection_group)),
+        )
+    )
+    snapshots = list(query.stream())
+    found = set(snapshot.id for snapshot in snapshots)
+    assert found == set(["cg-doc2"])
+
+
+def test_get_all(client, cleanup):
+    collection_name = "get-all" + UNIQUE_RESOURCE_ID
+
+    document1 = client.document(collection_name, "a")
+    document2 = client.document(collection_name, "b")
+    document3 = client.document(collection_name, "c")
+    # Add to clean-up before API requests (in case ``create()`` fails).
+    cleanup(document1.delete)
+    cleanup(document3.delete)
+
+    data1 = {"a": {"b": 2, "c": 3}, "d": 4, "e": 0}
+    write_result1 = document1.create(data1)
+    data3 = {"a": {"b": 5, "c": 6}, "d": 7, "e": 100}
+    write_result3 = document3.create(data3)
+
+    # 0. Get 3 unique documents, one of which is missing.
+    snapshots = list(client.get_all([document1, document2, document3]))
+
+    assert snapshots[0].exists
+    assert snapshots[1].exists
+    assert not snapshots[2].exists
+
+    snapshots = [snapshot for snapshot in snapshots if snapshot.exists]
+    id_attr = operator.attrgetter("id")
+    snapshots.sort(key=id_attr)
+
+    snapshot1, snapshot3 = snapshots
+    check_snapshot(snapshot1, document1, data1, write_result1)
+    check_snapshot(snapshot3, document3, data3, write_result3)
+
+    # 1. Get 2 colliding documents.
+    document1_also = client.document(collection_name, "a")
+    snapshots = list(client.get_all([document1, document1_also]))
+
+    assert len(snapshots) == 1
+    assert document1 is not document1_also
+    check_snapshot(snapshots[0], document1_also, data1, write_result1)
+
+    # 2. Use ``field_paths`` / projection in ``get_all()``.
+    snapshots = list(client.get_all([document1, document3], field_paths=["a.b", "d"]))
+
+    assert len(snapshots) == 2
+    snapshots.sort(key=id_attr)
+
+    snapshot1, snapshot3 = snapshots
+    restricted1 = {"a": {"b": data1["a"]["b"]}, "d": data1["d"]}
+    check_snapshot(snapshot1, document1, restricted1, write_result1)
+    restricted3 = {"a": {"b": data3["a"]["b"]}, "d": data3["d"]}
+    check_snapshot(snapshot3, document3, restricted3, write_result3)
+
+
+def test_batch(client, cleanup):
+    collection_name = "batch" + UNIQUE_RESOURCE_ID
+
+    document1 = client.document(collection_name, "abc")
+    document2 = client.document(collection_name, "mno")
+    document3 = client.document(collection_name, "xyz")
+    # Add to clean-up before API request (in case ``create()`` fails).
+    cleanup(document1.delete)
+    cleanup(document2.delete)
+    cleanup(document3.delete)
+
+    data2 = {"some": {"deep": "stuff", "and": "here"}, "water": 100.0}
+    document2.create(data2)
+    document3.create({"other": 19})
+
+    batch = client.batch()
+    data1 = {"all": True}
+    batch.create(document1, data1)
+    new_value = "there"
+    batch.update(document2, {"some.and": new_value})
+    batch.delete(document3)
+    write_results = batch.commit()
+
+    assert len(write_results) == 3
+
+    write_result1 = write_results[0]
+    write_result2 = write_results[1]
+    write_result3 = write_results[2]
+    assert not write_result3.HasField("update_time")
+
+    snapshot1 = document1.get()
+    assert snapshot1.to_dict() == data1
+    assert snapshot1.create_time == write_result1.update_time
+    assert snapshot1.update_time == write_result1.update_time
+
+    snapshot2 = document2.get()
+    assert snapshot2.to_dict() != data2
+    data2["some"]["and"] = new_value
+    assert snapshot2.to_dict() == data2
+    assert_timestamp_less(snapshot2.create_time, write_result2.update_time)
+    assert snapshot2.update_time == write_result2.update_time
+
+    assert not document3.get().exists
+
+
+def test_watch_document(client, cleanup):
+    db = client
+    collection_ref = db.collection(u"wd-users" + UNIQUE_RESOURCE_ID)
+    doc_ref = collection_ref.document(u"alovelace")
+
+    # Initial setting
+    doc_ref.set({u"first": u"Jane", u"last": u"Doe", u"born": 1900})
+    cleanup(doc_ref.delete)
+
+    sleep(1)
+
+    # Setup listener
+    def on_snapshot(docs, changes, read_time):
+        on_snapshot.called_count += 1
+
+    on_snapshot.called_count = 0
+
+    doc_ref.on_snapshot(on_snapshot)
+
+    # Alter document
+    doc_ref.set({u"first": u"Ada", u"last": u"Lovelace", u"born": 1815})
+
+    sleep(1)
+
+    for _ in range(10):
+        if on_snapshot.called_count > 0:
+            break
+        sleep(1)
+
+    if on_snapshot.called_count not in (1, 2):
+        raise AssertionError(
+            "Failed to get one or two document changes: count: "
+            + str(on_snapshot.called_count)
+        )
+
+
+def test_watch_collection(client, cleanup):
+    db = client
+    collection_ref = db.collection(u"wc-users" + UNIQUE_RESOURCE_ID)
+    doc_ref = collection_ref.document(u"alovelace")
+
+    # Initial setting
+    doc_ref.set({u"first": u"Jane", u"last": u"Doe", u"born": 1900})
+    cleanup(doc_ref.delete)
+
+    # Setup listener
+    def on_snapshot(docs, changes, read_time):
+        on_snapshot.called_count += 1
+        for doc in [doc for doc in docs if doc.id == doc_ref.id]:
+            on_snapshot.born = doc.get("born")
+
+    on_snapshot.called_count = 0
+    on_snapshot.born = 0
+
+    collection_ref.on_snapshot(on_snapshot)
+
+    # delay here so initial on_snapshot occurs and isn't combined with set
+    sleep(1)
+
+    doc_ref.set({u"first": u"Ada", u"last": u"Lovelace", u"born": 1815})
+
+    for _ in range(10):
+        if on_snapshot.born == 1815:
+            break
+        sleep(1)
+
+    if on_snapshot.born != 1815:
+        raise AssertionError(
+            "Expected the last document update to update born: " + str(on_snapshot.born)
+        )
+
+
+def test_watch_query(client, cleanup):
+    db = client
+    collection_ref = db.collection(u"wq-users" + UNIQUE_RESOURCE_ID)
+    doc_ref = collection_ref.document(u"alovelace")
+    query_ref = collection_ref.where("first", "==", u"Ada")
+
+    # Initial setting
+    doc_ref.set({u"first": u"Jane", u"last": u"Doe", u"born": 1900})
+    cleanup(doc_ref.delete)
+
+    sleep(1)
+
+    # Setup listener
+    def on_snapshot(docs, changes, read_time):
+        on_snapshot.called_count += 1
+
+        # A snapshot should return the same thing as if a query ran now.
+        query_ran = collection_ref.where("first", "==", u"Ada").stream()
+        assert len(docs) == len([i for i in query_ran])
+
+    on_snapshot.called_count = 0
+
+    query_ref.on_snapshot(on_snapshot)
+
+    # Alter document
+    doc_ref.set({u"first": u"Ada", u"last": u"Lovelace", u"born": 1815})
+
+    for _ in range(10):
+        if on_snapshot.called_count == 1:
+            return
+        sleep(1)
+
+    if on_snapshot.called_count != 1:
+        raise AssertionError(
+            "Failed to get exactly one document change: count: "
+            + str(on_snapshot.called_count)
+        )
+
+
+def test_watch_query_order(client, cleanup):
+    db = client
+    collection_ref = db.collection(u"users")
+    doc_ref1 = collection_ref.document(u"alovelace" + UNIQUE_RESOURCE_ID)
+    doc_ref2 = collection_ref.document(u"asecondlovelace" + UNIQUE_RESOURCE_ID)
+    doc_ref3 = collection_ref.document(u"athirdlovelace" + UNIQUE_RESOURCE_ID)
+    doc_ref4 = collection_ref.document(u"afourthlovelace" + UNIQUE_RESOURCE_ID)
+    doc_ref5 = collection_ref.document(u"afifthlovelace" + UNIQUE_RESOURCE_ID)
+
+    query_ref = collection_ref.where("first", "==", u"Ada").order_by("last")
+
+    # Setup listener
+    def on_snapshot(docs, changes, read_time):
+        try:
+            if len(docs) != 5:
+                return
+            # A snapshot should return the same thing as if a query ran now.
+            query_ran = query_ref.stream()
+            query_ran_results = [i for i in query_ran]
+            assert len(docs) == len(query_ran_results)
+
+            # compare the order things are returned
+            for snapshot, query in zip(docs, query_ran_results):
+                assert snapshot.get("last") == query.get(
+                    "last"
+                ), "expect the sort order to match, last"
+                assert snapshot.get("born") == query.get(
+                    "born"
+                ), "expect the sort order to match, born"
+            on_snapshot.called_count += 1
+            on_snapshot.last_doc_count = len(docs)
+        except Exception as e:
+            on_snapshot.failed = e
+
+    on_snapshot.called_count = 0
+    on_snapshot.last_doc_count = 0
+    on_snapshot.failed = None
+    query_ref.on_snapshot(on_snapshot)
+
+    sleep(1)
+
+    doc_ref1.set({u"first": u"Ada", u"last": u"Lovelace", u"born": 1815})
+    cleanup(doc_ref1.delete)
+
+    doc_ref2.set({u"first": u"Ada", u"last": u"SecondLovelace", u"born": 1815})
+    cleanup(doc_ref2.delete)
+
+    doc_ref3.set({u"first": u"Ada", u"last": u"ThirdLovelace", u"born": 1815})
+    cleanup(doc_ref3.delete)
+
+    doc_ref4.set({u"first": u"Ada", u"last": u"FourthLovelace", u"born": 1815})
+    cleanup(doc_ref4.delete)
+
+    doc_ref5.set({u"first": u"Ada", u"last": u"lovelace", u"born": 1815})
+    cleanup(doc_ref5.delete)
+
+    for _ in range(10):
+        if on_snapshot.last_doc_count == 5:
+            break
+        sleep(1)
+
+    if on_snapshot.failed:
+        raise on_snapshot.failed
+
+    if on_snapshot.last_doc_count != 5:
+        raise AssertionError(
+            "5 docs expected in snapshot method " + str(on_snapshot.last_doc_count)
+        )
diff --git a/firestore/tests/system/util/cleanup_firestore_documents.py b/firestore/tests/system/util/cleanup_firestore_documents.py
new file mode 100644
index 000000000000..a944f44899f3
--- /dev/null
+++ b/firestore/tests/system/util/cleanup_firestore_documents.py
@@ -0,0 +1,38 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Clean up documents leaked by system tests."""
+from google.cloud.firestore import Client
+
+
+def zap_document(document):
+    print("Zapping document: {}".format(document.path))
+    for collection in document.collections():
+        zap_collection(collection)
+    document.delete()
+
+
+def zap_collection(collection):
+    for document in collection.list_documents():
+        zap_document(document)
+
+
+def main():
+    client = Client()
+
+    for collection in client.collections():
+        zap_collection(collection)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/firestore/tests/unit/__init__.py b/firestore/tests/unit/__init__.py
new file mode 100644
index 000000000000..ab6729095248
--- /dev/null
+++ b/firestore/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/firestore/tests/unit/gapic/v1/test_firestore_admin_client_v1.py b/firestore/tests/unit/gapic/v1/test_firestore_admin_client_v1.py
new file mode 100644
index 000000000000..325557582924
--- /dev/null
+++ b/firestore/tests/unit/gapic/v1/test_firestore_admin_client_v1.py
@@ -0,0 +1,430 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import firestore_admin_v1
+from google.cloud.firestore_admin_v1.proto import field_pb2
+from google.cloud.firestore_admin_v1.proto import firestore_admin_pb2
+from google.cloud.firestore_admin_v1.proto import index_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestFirestoreAdminClient(object):
+    def test_create_index(self):
+        # Setup Expected Response
+        name = "name3373707"
+        done = True
+        expected_response = {"name": name, "done": done}
+        expected_response = operations_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        parent = client.parent_path("[PROJECT]", "[DATABASE]", "[COLLECTION_ID]")
+        index = {}
+
+        response = client.create_index(parent, index)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.CreateIndexRequest(
+            parent=parent, index=index
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_index_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        parent = client.parent_path("[PROJECT]", "[DATABASE]", "[COLLECTION_ID]")
+        index = {}
+
+        with pytest.raises(CustomException):
+            client.create_index(parent, index)
+
+    def test_list_indexes(self):
+        # Setup Expected Response
+        next_page_token = ""
+        indexes_element = {}
+        indexes = [indexes_element]
+        expected_response = {"next_page_token": next_page_token, "indexes": indexes}
+        expected_response = firestore_admin_pb2.ListIndexesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        parent = client.parent_path("[PROJECT]", "[DATABASE]", "[COLLECTION_ID]")
+
+        paged_list_response = client.list_indexes(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.indexes[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.ListIndexesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_indexes_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        parent = client.parent_path("[PROJECT]", "[DATABASE]", "[COLLECTION_ID]")
+
+        paged_list_response = client.list_indexes(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_index(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = index_pb2.Index(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        name = client.index_path(
+            "[PROJECT]", "[DATABASE]", "[COLLECTION_ID]", "[INDEX_ID]"
+        )
+
+        response = client.get_index(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.GetIndexRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_index_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        name = client.index_path(
+            "[PROJECT]", "[DATABASE]", "[COLLECTION_ID]", "[INDEX_ID]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_index(name)
+
+    def test_delete_index(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        name = client.index_path(
+            "[PROJECT]", "[DATABASE]", "[COLLECTION_ID]", "[INDEX_ID]"
+        )
+
+        client.delete_index(name)
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.DeleteIndexRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_index_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        name = client.index_path(
+            "[PROJECT]", "[DATABASE]", "[COLLECTION_ID]", "[INDEX_ID]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_index(name)
+
+    def test_import_documents(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        done = True
+        expected_response = {"name": name_2, "done": done}
+        expected_response = operations_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        name = client.database_path("[PROJECT]", "[DATABASE]")
+
+        response = client.import_documents(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.ImportDocumentsRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_documents_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        name = client.database_path("[PROJECT]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.import_documents(name)
+
+    def test_export_documents(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        done = True
+        expected_response = {"name": name_2, "done": done}
+        expected_response = operations_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        name = client.database_path("[PROJECT]", "[DATABASE]")
+
+        response = client.export_documents(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.ExportDocumentsRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_documents_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        name = client.database_path("[PROJECT]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.export_documents(name)
+
+    def test_get_field(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = field_pb2.Field(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        name = client.field_path(
+            "[PROJECT]", "[DATABASE]", "[COLLECTION_ID]", "[FIELD_ID]"
+        )
+
+        response = client.get_field(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.GetFieldRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_field_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        name = client.field_path(
+            "[PROJECT]", "[DATABASE]", "[COLLECTION_ID]", "[FIELD_ID]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_field(name)
+
+    def test_list_fields(self):
+        # Setup Expected Response
+        next_page_token = ""
+        fields_element = {}
+        fields = [fields_element]
+        expected_response = {"next_page_token": next_page_token, "fields": fields}
+        expected_response = firestore_admin_pb2.ListFieldsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        parent = client.parent_path("[PROJECT]", "[DATABASE]", "[COLLECTION_ID]")
+
+        paged_list_response = client.list_fields(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.fields[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.ListFieldsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_fields_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        parent = client.parent_path("[PROJECT]", "[DATABASE]", "[COLLECTION_ID]")
+
+        paged_list_response = client.list_fields(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_field(self):
+        # Setup Expected Response
+        name = "name3373707"
+        done = True
+        expected_response = {"name": name, "done": done}
+        expected_response = operations_pb2.Operation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup Request
+        field = {}
+
+        response = client.update_field(field)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_admin_pb2.UpdateFieldRequest(field=field)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_field_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_admin_v1.FirestoreAdminClient()
+
+        # Setup request
+        field = {}
+
+        with pytest.raises(CustomException):
+            client.update_field(field)
diff --git a/firestore/tests/unit/gapic/v1/test_firestore_client_v1.py b/firestore/tests/unit/gapic/v1/test_firestore_client_v1.py
new file mode 100644
index 000000000000..f7afa1381840
--- /dev/null
+++ b/firestore/tests/unit/gapic/v1/test_firestore_client_v1.py
@@ -0,0 +1,646 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.firestore_v1.gapic import firestore_client
+from google.cloud.firestore_v1.proto import common_pb2
+from google.cloud.firestore_v1.proto import document_pb2
+from google.cloud.firestore_v1.proto import firestore_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestFirestoreClient(object):
+    def test_get_document(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = document_pb2.Document(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        response = client.get_document(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.GetDocumentRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_document(name)
+
+    def test_list_documents(self):
+        # Setup Expected Response
+        next_page_token = ""
+        documents_element = {}
+        documents = [documents_element]
+        expected_response = {"next_page_token": next_page_token, "documents": documents}
+        expected_response = firestore_pb2.ListDocumentsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+
+        paged_list_response = client.list_documents(parent, collection_id)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.documents[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.ListDocumentsRequest(
+            parent=parent, collection_id=collection_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_documents_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+
+        paged_list_response = client.list_documents(parent, collection_id)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_document(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = document_pb2.Document(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+        document_id = "documentId506676927"
+        document = {}
+
+        response = client.create_document(parent, collection_id, document_id, document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.CreateDocumentRequest(
+            parent=parent,
+            collection_id=collection_id,
+            document_id=document_id,
+            document=document,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+        document_id = "documentId506676927"
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.create_document(parent, collection_id, document_id, document)
+
+    def test_update_document(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = document_pb2.Document(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        document = {}
+        update_mask = {}
+
+        response = client.update_document(document, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.UpdateDocumentRequest(
+            document=document, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        document = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_document(document, update_mask)
+
+    def test_delete_document(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        client.delete_document(name)
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.DeleteDocumentRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_document(name)
+
+    def test_batch_get_documents(self):
+        # Setup Expected Response
+        missing = "missing1069449574"
+        transaction = b"-34"
+        expected_response = {"missing": missing, "transaction": transaction}
+        expected_response = firestore_pb2.BatchGetDocumentsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        documents = []
+
+        response = client.batch_get_documents(database, documents)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.BatchGetDocumentsRequest(
+            database=database, documents=documents
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_get_documents_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        documents = []
+
+        with pytest.raises(CustomException):
+            client.batch_get_documents(database, documents)
+
+    def test_begin_transaction(self):
+        # Setup Expected Response
+        transaction = b"-34"
+        expected_response = {"transaction": transaction}
+        expected_response = firestore_pb2.BeginTransactionResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+
+        response = client.begin_transaction(database)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.BeginTransactionRequest(database=database)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_begin_transaction_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.begin_transaction(database)
+
+    def test_commit(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = firestore_pb2.CommitResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        writes = []
+
+        response = client.commit(database, writes)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.CommitRequest(database=database, writes=writes)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_commit_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        writes = []
+
+        with pytest.raises(CustomException):
+            client.commit(database, writes)
+
+    def test_rollback(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        transaction = b"-34"
+
+        client.rollback(database, transaction)
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.RollbackRequest(
+            database=database, transaction=transaction
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rollback_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        transaction = b"-34"
+
+        with pytest.raises(CustomException):
+            client.rollback(database, transaction)
+
+    def test_run_query(self):
+        # Setup Expected Response
+        transaction = b"-34"
+        skipped_results = 880286183
+        expected_response = {
+            "transaction": transaction,
+            "skipped_results": skipped_results,
+        }
+        expected_response = firestore_pb2.RunQueryResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        response = client.run_query(parent)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.RunQueryRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_query_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        with pytest.raises(CustomException):
+            client.run_query(parent)
+
+    def test_write(self):
+        # Setup Expected Response
+        stream_id = "streamId-315624902"
+        stream_token = b"122"
+        expected_response = {"stream_id": stream_id, "stream_token": stream_token}
+        expected_response = firestore_pb2.WriteResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+        request = firestore_pb2.WriteRequest(**request)
+        requests = [request]
+
+        response = client.write(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_write_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+
+        request = firestore_pb2.WriteRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.write(requests)
+
+    def test_listen(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = firestore_pb2.ListenResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+        request = firestore_pb2.ListenRequest(**request)
+        requests = [request]
+
+        response = client.listen(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_listen_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+
+        request = firestore_pb2.ListenRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.listen(requests)
+
+    def test_list_collection_ids(self):
+        # Setup Expected Response
+        next_page_token = ""
+        collection_ids_element = "collectionIdsElement1368994900"
+        collection_ids = [collection_ids_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "collection_ids": collection_ids,
+        }
+        expected_response = firestore_pb2.ListCollectionIdsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        paged_list_response = client.list_collection_ids(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.collection_ids[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.ListCollectionIdsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_collection_ids_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        paged_list_response = client.list_collection_ids(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/firestore/tests/unit/gapic/v1beta1/test_firestore_client_v1beta1.py b/firestore/tests/unit/gapic/v1beta1/test_firestore_client_v1beta1.py
new file mode 100644
index 000000000000..d7b42b911ef9
--- /dev/null
+++ b/firestore/tests/unit/gapic/v1beta1/test_firestore_client_v1beta1.py
@@ -0,0 +1,646 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.firestore_v1beta1.gapic import firestore_client
+from google.cloud.firestore_v1beta1.proto import common_pb2
+from google.cloud.firestore_v1beta1.proto import document_pb2
+from google.cloud.firestore_v1beta1.proto import firestore_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestFirestoreClient(object):
+    def test_get_document(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = document_pb2.Document(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        response = client.get_document(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.GetDocumentRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_document(name)
+
+    def test_list_documents(self):
+        # Setup Expected Response
+        next_page_token = ""
+        documents_element = {}
+        documents = [documents_element]
+        expected_response = {"next_page_token": next_page_token, "documents": documents}
+        expected_response = firestore_pb2.ListDocumentsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+
+        paged_list_response = client.list_documents(parent, collection_id)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.documents[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.ListDocumentsRequest(
+            parent=parent, collection_id=collection_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_documents_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+
+        paged_list_response = client.list_documents(parent, collection_id)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_document(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = document_pb2.Document(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+        document_id = "documentId506676927"
+        document = {}
+
+        response = client.create_document(parent, collection_id, document_id, document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.CreateDocumentRequest(
+            parent=parent,
+            collection_id=collection_id,
+            document_id=document_id,
+            document=document,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+        collection_id = "collectionId-821242276"
+        document_id = "documentId506676927"
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.create_document(parent, collection_id, document_id, document)
+
+    def test_update_document(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = document_pb2.Document(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        document = {}
+        update_mask = {}
+
+        response = client.update_document(document, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.UpdateDocumentRequest(
+            document=document, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        document = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_document(document, update_mask)
+
+    def test_delete_document(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        client.delete_document(name)
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.DeleteDocumentRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_document_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        name = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_document(name)
+
+    def test_batch_get_documents(self):
+        # Setup Expected Response
+        missing = "missing1069449574"
+        transaction = b"-34"
+        expected_response = {"missing": missing, "transaction": transaction}
+        expected_response = firestore_pb2.BatchGetDocumentsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        documents = []
+
+        response = client.batch_get_documents(database, documents)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.BatchGetDocumentsRequest(
+            database=database, documents=documents
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_get_documents_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        documents = []
+
+        with pytest.raises(CustomException):
+            client.batch_get_documents(database, documents)
+
+    def test_begin_transaction(self):
+        # Setup Expected Response
+        transaction = b"-34"
+        expected_response = {"transaction": transaction}
+        expected_response = firestore_pb2.BeginTransactionResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+
+        response = client.begin_transaction(database)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.BeginTransactionRequest(database=database)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_begin_transaction_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.begin_transaction(database)
+
+    def test_commit(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = firestore_pb2.CommitResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        writes = []
+
+        response = client.commit(database, writes)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.CommitRequest(database=database, writes=writes)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_commit_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        writes = []
+
+        with pytest.raises(CustomException):
+            client.commit(database, writes)
+
+    def test_rollback(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        transaction = b"-34"
+
+        client.rollback(database, transaction)
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.RollbackRequest(
+            database=database, transaction=transaction
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rollback_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        transaction = b"-34"
+
+        with pytest.raises(CustomException):
+            client.rollback(database, transaction)
+
+    def test_run_query(self):
+        # Setup Expected Response
+        transaction = b"-34"
+        skipped_results = 880286183
+        expected_response = {
+            "transaction": transaction,
+            "skipped_results": skipped_results,
+        }
+        expected_response = firestore_pb2.RunQueryResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        response = client.run_query(parent)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.RunQueryRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_query_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        with pytest.raises(CustomException):
+            client.run_query(parent)
+
+    def test_write(self):
+        # Setup Expected Response
+        stream_id = "streamId-315624902"
+        stream_token = b"122"
+        expected_response = {"stream_id": stream_id, "stream_token": stream_token}
+        expected_response = firestore_pb2.WriteResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+        request = firestore_pb2.WriteRequest(**request)
+        requests = [request]
+
+        response = client.write(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_write_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+
+        request = firestore_pb2.WriteRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.write(requests)
+
+    def test_listen(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = firestore_pb2.ListenResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+        request = firestore_pb2.ListenRequest(**request)
+        requests = [request]
+
+        response = client.listen(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_listen_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        database = client.database_root_path("[PROJECT]", "[DATABASE]")
+        request = {"database": database}
+
+        request = firestore_pb2.ListenRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.listen(requests)
+
+    def test_list_collection_ids(self):
+        # Setup Expected Response
+        next_page_token = ""
+        collection_ids_element = "collectionIdsElement1368994900"
+        collection_ids = [collection_ids_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "collection_ids": collection_ids,
+        }
+        expected_response = firestore_pb2.ListCollectionIdsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup Request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        paged_list_response = client.list_collection_ids(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.collection_ids[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = firestore_pb2.ListCollectionIdsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_collection_ids_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = firestore_client.FirestoreClient()
+
+        # Setup request
+        parent = client.any_path_path(
+            "[PROJECT]", "[DATABASE]", "[DOCUMENT]", "[ANY_PATH]"
+        )
+
+        paged_list_response = client.list_collection_ids(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/firestore/tests/unit/test_firestore_shim.py b/firestore/tests/unit/test_firestore_shim.py
new file mode 100644
index 000000000000..001e45354916
--- /dev/null
+++ b/firestore/tests/unit/test_firestore_shim.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+
+class TestFirestoreShim(unittest.TestCase):
+    def test_shim_matches_firestore_v1(self):
+        from google.cloud import firestore
+        from google.cloud import firestore_v1
+
+        self.assertEqual(firestore.__all__, firestore_v1.__all__)
+
+        for name in firestore.__all__:
+            found = getattr(firestore, name)
+            expected = getattr(firestore_v1, name)
+            self.assertIs(found, expected)
diff --git a/firestore/tests/unit/v1/__init__.py b/firestore/tests/unit/v1/__init__.py
new file mode 100644
index 000000000000..ab6729095248
--- /dev/null
+++ b/firestore/tests/unit/v1/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/firestore/tests/unit/v1/test__helpers.py b/firestore/tests/unit/v1/test__helpers.py
new file mode 100644
index 000000000000..e804d9bfcb6f
--- /dev/null
+++ b/firestore/tests/unit/v1/test__helpers.py
@@ -0,0 +1,2395 @@
+# -*- coding: utf-8 -*-
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import sys
+import unittest
+
+import mock
+
+
+class TestGeoPoint(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1._helpers import GeoPoint
+
+        return GeoPoint
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        lat = 81.25
+        lng = 359.984375
+        geo_pt = self._make_one(lat, lng)
+        self.assertEqual(geo_pt.latitude, lat)
+        self.assertEqual(geo_pt.longitude, lng)
+
+    def test_to_protobuf(self):
+        from google.type import latlng_pb2
+
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt = self._make_one(lat, lng)
+        result = geo_pt.to_protobuf()
+        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
+        self.assertEqual(result, geo_pt_pb)
+
+    def test___eq__(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = self._make_one(lat, lng)
+        self.assertEqual(geo_pt1, geo_pt2)
+
+    def test___eq__type_differ(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = object()
+        self.assertNotEqual(geo_pt1, geo_pt2)
+        self.assertIs(geo_pt1.__eq__(geo_pt2), NotImplemented)
+
+    def test___ne__same_value(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = self._make_one(lat, lng)
+        comparison_val = geo_pt1 != geo_pt2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        geo_pt1 = self._make_one(0.0, 1.0)
+        geo_pt2 = self._make_one(2.0, 3.0)
+        self.assertNotEqual(geo_pt1, geo_pt2)
+
+    def test___ne__type_differ(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = object()
+        self.assertNotEqual(geo_pt1, geo_pt2)
+        self.assertIs(geo_pt1.__ne__(geo_pt2), NotImplemented)
+
+
+class Test_verify_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path, is_collection):
+        from google.cloud.firestore_v1._helpers import verify_path
+
+        return verify_path(path, is_collection)
+
+    def test_empty(self):
+        path = ()
+        with self.assertRaises(ValueError):
+            self._call_fut(path, True)
+        with self.assertRaises(ValueError):
+            self._call_fut(path, False)
+
+    def test_wrong_length_collection(self):
+        path = ("foo", "bar")
+        with self.assertRaises(ValueError):
+            self._call_fut(path, True)
+
+    def test_wrong_length_document(self):
+        path = ("Kind",)
+        with self.assertRaises(ValueError):
+            self._call_fut(path, False)
+
+    def test_wrong_type_collection(self):
+        path = (99, "ninety-nine", "zap")
+        with self.assertRaises(ValueError):
+            self._call_fut(path, True)
+
+    def test_wrong_type_document(self):
+        path = ("Users", "Ada", "Candy", {})
+        with self.assertRaises(ValueError):
+            self._call_fut(path, False)
+
+    def test_success_collection(self):
+        path = ("Computer", "Magic", "Win")
+        ret_val = self._call_fut(path, True)
+        # NOTE: We are just checking that it didn't fail.
+        self.assertIsNone(ret_val)
+
+    def test_success_document(self):
+        path = ("Tokenizer", "Seventeen", "Cheese", "Burger")
+        ret_val = self._call_fut(path, False)
+        # NOTE: We are just checking that it didn't fail.
+        self.assertIsNone(ret_val)
+
+
+class Test_encode_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value):
+        from google.cloud.firestore_v1._helpers import encode_value
+
+        return encode_value(value)
+
+    def test_none(self):
+        from google.protobuf import struct_pb2
+
+        result = self._call_fut(None)
+        expected = _value_pb(null_value=struct_pb2.NULL_VALUE)
+        self.assertEqual(result, expected)
+
+    def test_boolean(self):
+        result = self._call_fut(True)
+        expected = _value_pb(boolean_value=True)
+        self.assertEqual(result, expected)
+
+    def test_integer(self):
+        value = 425178
+        result = self._call_fut(value)
+        expected = _value_pb(integer_value=value)
+        self.assertEqual(result, expected)
+
+    def test_float(self):
+        value = 123.4453125
+        result = self._call_fut(value)
+        expected = _value_pb(double_value=value)
+        self.assertEqual(result, expected)
+
+    def test_datetime_with_nanos(self):
+        from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+        from google.protobuf import timestamp_pb2
+
+        dt_seconds = 1488768504
+        dt_nanos = 458816991
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=dt_seconds, nanos=dt_nanos)
+        dt_val = DatetimeWithNanoseconds.from_timestamp_pb(timestamp_pb)
+
+        result = self._call_fut(dt_val)
+        expected = _value_pb(timestamp_value=timestamp_pb)
+        self.assertEqual(result, expected)
+
+    def test_datetime_wo_nanos(self):
+        from google.protobuf import timestamp_pb2
+
+        dt_seconds = 1488768504
+        dt_nanos = 458816000
+        # Make sure precision is valid in microseconds too.
+        self.assertEqual(dt_nanos % 1000, 0)
+        dt_val = datetime.datetime.utcfromtimestamp(dt_seconds + 1e-9 * dt_nanos)
+
+        result = self._call_fut(dt_val)
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=dt_seconds, nanos=dt_nanos)
+        expected = _value_pb(timestamp_value=timestamp_pb)
+        self.assertEqual(result, expected)
+
+    def test_string(self):
+        value = u"\u2018left quote, right quote\u2019"
+        result = self._call_fut(value)
+        expected = _value_pb(string_value=value)
+        self.assertEqual(result, expected)
+
+    def test_bytes(self):
+        value = b"\xe3\xf2\xff\x00"
+        result = self._call_fut(value)
+        expected = _value_pb(bytes_value=value)
+        self.assertEqual(result, expected)
+
+    def test_reference_value(self):
+        client = _make_client()
+
+        value = client.document("my", "friend")
+        result = self._call_fut(value)
+        expected = _value_pb(reference_value=value._document_path)
+        self.assertEqual(result, expected)
+
+    def test_geo_point(self):
+        from google.cloud.firestore_v1._helpers import GeoPoint
+
+        value = GeoPoint(50.5, 88.75)
+        result = self._call_fut(value)
+        expected = _value_pb(geo_point_value=value.to_protobuf())
+        self.assertEqual(result, expected)
+
+    def test_array(self):
+        from google.cloud.firestore_v1.proto.document_pb2 import ArrayValue
+
+        result = self._call_fut([99, True, 118.5])
+
+        array_pb = ArrayValue(
+            values=[
+                _value_pb(integer_value=99),
+                _value_pb(boolean_value=True),
+                _value_pb(double_value=118.5),
+            ]
+        )
+        expected = _value_pb(array_value=array_pb)
+        self.assertEqual(result, expected)
+
+    def test_map(self):
+        from google.cloud.firestore_v1.proto.document_pb2 import MapValue
+
+        result = self._call_fut({"abc": 285, "def": b"piglatin"})
+
+        map_pb = MapValue(
+            fields={
+                "abc": _value_pb(integer_value=285),
+                "def": _value_pb(bytes_value=b"piglatin"),
+            }
+        )
+        expected = _value_pb(map_value=map_pb)
+        self.assertEqual(result, expected)
+
+    def test_bad_type(self):
+        value = object()
+        with self.assertRaises(TypeError):
+            self._call_fut(value)
+
+
+class Test_encode_dict(unittest.TestCase):
+    @staticmethod
+    def _call_fut(values_dict):
+        from google.cloud.firestore_v1._helpers import encode_dict
+
+        return encode_dict(values_dict)
+
+    def test_many_types(self):
+        from google.protobuf import struct_pb2
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto.document_pb2 import ArrayValue
+        from google.cloud.firestore_v1.proto.document_pb2 import MapValue
+
+        dt_seconds = 1497397225
+        dt_nanos = 465964000
+        # Make sure precision is valid in microseconds too.
+        self.assertEqual(dt_nanos % 1000, 0)
+        dt_val = datetime.datetime.utcfromtimestamp(dt_seconds + 1e-9 * dt_nanos)
+
+        client = _make_client()
+        document = client.document("most", "adjective", "thing", "here")
+
+        values_dict = {
+            "foo": None,
+            "bar": True,
+            "baz": 981,
+            "quux": 2.875,
+            "quuz": dt_val,
+            "corge": u"\N{snowman}",
+            "grault": b"\xe2\x98\x83",
+            "wibble": document,
+            "garply": [u"fork", 4.0],
+            "waldo": {"fred": u"zap", "thud": False},
+        }
+        encoded_dict = self._call_fut(values_dict)
+        expected_dict = {
+            "foo": _value_pb(null_value=struct_pb2.NULL_VALUE),
+            "bar": _value_pb(boolean_value=True),
+            "baz": _value_pb(integer_value=981),
+            "quux": _value_pb(double_value=2.875),
+            "quuz": _value_pb(
+                timestamp_value=timestamp_pb2.Timestamp(
+                    seconds=dt_seconds, nanos=dt_nanos
+                )
+            ),
+            "corge": _value_pb(string_value=u"\N{snowman}"),
+            "grault": _value_pb(bytes_value=b"\xe2\x98\x83"),
+            "wibble": _value_pb(reference_value=document._document_path),
+            "garply": _value_pb(
+                array_value=ArrayValue(
+                    values=[
+                        _value_pb(string_value=u"fork"),
+                        _value_pb(double_value=4.0),
+                    ]
+                )
+            ),
+            "waldo": _value_pb(
+                map_value=MapValue(
+                    fields={
+                        "fred": _value_pb(string_value=u"zap"),
+                        "thud": _value_pb(boolean_value=False),
+                    }
+                )
+            ),
+        }
+        self.assertEqual(encoded_dict, expected_dict)
+
+
+class Test_reference_value_to_document(unittest.TestCase):
+    @staticmethod
+    def _call_fut(reference_value, client):
+        from google.cloud.firestore_v1._helpers import reference_value_to_document
+
+        return reference_value_to_document(reference_value, client)
+
+    def test_bad_format(self):
+        from google.cloud.firestore_v1._helpers import BAD_REFERENCE_ERROR
+
+        reference_value = "not/the/right/format"
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(reference_value, None)
+
+        err_msg = BAD_REFERENCE_ERROR.format(reference_value)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test_same_client(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        client = _make_client()
+        document = client.document("that", "this")
+        reference_value = document._document_path
+
+        new_document = self._call_fut(reference_value, client)
+        self.assertIsNot(new_document, document)
+
+        self.assertIsInstance(new_document, DocumentReference)
+        self.assertIs(new_document._client, client)
+        self.assertEqual(new_document._path, document._path)
+
+    def test_different_client(self):
+        from google.cloud.firestore_v1._helpers import WRONG_APP_REFERENCE
+
+        client1 = _make_client(project="kirk")
+        document = client1.document("tin", "foil")
+        reference_value = document._document_path
+
+        client2 = _make_client(project="spock")
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(reference_value, client2)
+
+        err_msg = WRONG_APP_REFERENCE.format(reference_value, client2._database_string)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+
+class Test_decode_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value, client=mock.sentinel.client):
+        from google.cloud.firestore_v1._helpers import decode_value
+
+        return decode_value(value, client)
+
+    def test_none(self):
+        from google.protobuf import struct_pb2
+
+        value = _value_pb(null_value=struct_pb2.NULL_VALUE)
+        self.assertIsNone(self._call_fut(value))
+
+    def test_bool(self):
+        value1 = _value_pb(boolean_value=True)
+        self.assertTrue(self._call_fut(value1))
+        value2 = _value_pb(boolean_value=False)
+        self.assertFalse(self._call_fut(value2))
+
+    def test_int(self):
+        int_val = 29871
+        value = _value_pb(integer_value=int_val)
+        self.assertEqual(self._call_fut(value), int_val)
+
+    def test_float(self):
+        float_val = 85.9296875
+        value = _value_pb(double_value=float_val)
+        self.assertEqual(self._call_fut(value), float_val)
+
+    @unittest.skipIf(
+        (3,) <= sys.version_info < (3, 4, 4), "known datetime bug (bpo-23517) in Python"
+    )
+    def test_datetime(self):
+        from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+        from google.protobuf import timestamp_pb2
+
+        dt_seconds = 552855006
+        dt_nanos = 766961828
+
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=dt_seconds, nanos=dt_nanos)
+        value = _value_pb(timestamp_value=timestamp_pb)
+
+        expected_dt_val = DatetimeWithNanoseconds.from_timestamp_pb(timestamp_pb)
+        self.assertEqual(self._call_fut(value), expected_dt_val)
+
+    def test_unicode(self):
+        unicode_val = u"zorgon"
+        value = _value_pb(string_value=unicode_val)
+        self.assertEqual(self._call_fut(value), unicode_val)
+
+    def test_bytes(self):
+        bytes_val = b"abc\x80"
+        value = _value_pb(bytes_value=bytes_val)
+        self.assertEqual(self._call_fut(value), bytes_val)
+
+    def test_reference(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        client = _make_client()
+        path = (u"then", u"there-was-one")
+        document = client.document(*path)
+        ref_string = document._document_path
+        value = _value_pb(reference_value=ref_string)
+
+        result = self._call_fut(value, client)
+        self.assertIsInstance(result, DocumentReference)
+        self.assertIs(result._client, client)
+        self.assertEqual(result._path, path)
+
+    def test_geo_point(self):
+        from google.cloud.firestore_v1._helpers import GeoPoint
+
+        geo_pt = GeoPoint(latitude=42.5, longitude=99.0625)
+        value = _value_pb(geo_point_value=geo_pt.to_protobuf())
+        self.assertEqual(self._call_fut(value), geo_pt)
+
+    def test_array(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+
+        sub_value1 = _value_pb(boolean_value=True)
+        sub_value2 = _value_pb(double_value=14.1396484375)
+        sub_value3 = _value_pb(bytes_value=b"\xde\xad\xbe\xef")
+        array_pb = document_pb2.ArrayValue(values=[sub_value1, sub_value2, sub_value3])
+        value = _value_pb(array_value=array_pb)
+
+        expected = [
+            sub_value1.boolean_value,
+            sub_value2.double_value,
+            sub_value3.bytes_value,
+        ]
+        self.assertEqual(self._call_fut(value), expected)
+
+    def test_map(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+
+        sub_value1 = _value_pb(integer_value=187680)
+        sub_value2 = _value_pb(string_value=u"how low can you go?")
+        map_pb = document_pb2.MapValue(
+            fields={"first": sub_value1, "second": sub_value2}
+        )
+        value = _value_pb(map_value=map_pb)
+
+        expected = {
+            "first": sub_value1.integer_value,
+            "second": sub_value2.string_value,
+        }
+        self.assertEqual(self._call_fut(value), expected)
+
+    def test_nested_map(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+
+        actual_value1 = 1009876
+        actual_value2 = u"hey you guys"
+        actual_value3 = 90.875
+        map_pb1 = document_pb2.MapValue(
+            fields={
+                "lowest": _value_pb(integer_value=actual_value1),
+                "aside": _value_pb(string_value=actual_value2),
+            }
+        )
+        map_pb2 = document_pb2.MapValue(
+            fields={
+                "middle": _value_pb(map_value=map_pb1),
+                "aside": _value_pb(boolean_value=True),
+            }
+        )
+        map_pb3 = document_pb2.MapValue(
+            fields={
+                "highest": _value_pb(map_value=map_pb2),
+                "aside": _value_pb(double_value=actual_value3),
+            }
+        )
+        value = _value_pb(map_value=map_pb3)
+
+        expected = {
+            "highest": {
+                "middle": {"lowest": actual_value1, "aside": actual_value2},
+                "aside": True,
+            },
+            "aside": actual_value3,
+        }
+        self.assertEqual(self._call_fut(value), expected)
+
+    def test_unset_value_type(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(_value_pb())
+
+    def test_unknown_value_type(self):
+        value_pb = mock.Mock(spec=["WhichOneof"])
+        value_pb.WhichOneof.return_value = "zoob_value"
+
+        with self.assertRaises(ValueError):
+            self._call_fut(value_pb)
+
+        value_pb.WhichOneof.assert_called_once_with("value_type")
+
+
+class Test_decode_dict(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value_fields, client=mock.sentinel.client):
+        from google.cloud.firestore_v1._helpers import decode_dict
+
+        return decode_dict(value_fields, client)
+
+    @unittest.skipIf(
+        (3,) <= sys.version_info < (3, 4, 4), "known datetime bug (bpo-23517) in Python"
+    )
+    def test_many_types(self):
+        from google.protobuf import struct_pb2
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto.document_pb2 import ArrayValue
+        from google.cloud.firestore_v1.proto.document_pb2 import MapValue
+        from google.cloud._helpers import UTC
+        from google.cloud.firestore_v1.field_path import FieldPath
+
+        dt_seconds = 1394037350
+        dt_nanos = 667285000
+        # Make sure precision is valid in microseconds too.
+        self.assertEqual(dt_nanos % 1000, 0)
+        dt_val = datetime.datetime.utcfromtimestamp(
+            dt_seconds + 1e-9 * dt_nanos
+        ).replace(tzinfo=UTC)
+
+        value_fields = {
+            "foo": _value_pb(null_value=struct_pb2.NULL_VALUE),
+            "bar": _value_pb(boolean_value=True),
+            "baz": _value_pb(integer_value=981),
+            "quux": _value_pb(double_value=2.875),
+            "quuz": _value_pb(
+                timestamp_value=timestamp_pb2.Timestamp(
+                    seconds=dt_seconds, nanos=dt_nanos
+                )
+            ),
+            "corge": _value_pb(string_value=u"\N{snowman}"),
+            "grault": _value_pb(bytes_value=b"\xe2\x98\x83"),
+            "garply": _value_pb(
+                array_value=ArrayValue(
+                    values=[
+                        _value_pb(string_value=u"fork"),
+                        _value_pb(double_value=4.0),
+                    ]
+                )
+            ),
+            "waldo": _value_pb(
+                map_value=MapValue(
+                    fields={
+                        "fred": _value_pb(string_value=u"zap"),
+                        "thud": _value_pb(boolean_value=False),
+                    }
+                )
+            ),
+            FieldPath("a", "b", "c").to_api_repr(): _value_pb(boolean_value=False),
+        }
+        expected = {
+            "foo": None,
+            "bar": True,
+            "baz": 981,
+            "quux": 2.875,
+            "quuz": dt_val,
+            "corge": u"\N{snowman}",
+            "grault": b"\xe2\x98\x83",
+            "garply": [u"fork", 4.0],
+            "waldo": {"fred": u"zap", "thud": False},
+            "a.b.c": False,
+        }
+        self.assertEqual(self._call_fut(value_fields), expected)
+
+
+class Test_get_doc_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_pb, expected_prefix):
+        from google.cloud.firestore_v1._helpers import get_doc_id
+
+        return get_doc_id(document_pb, expected_prefix)
+
+    @staticmethod
+    def _dummy_ref_string(collection_id):
+        from google.cloud.firestore_v1.client import DEFAULT_DATABASE
+
+        project = u"bazzzz"
+        return u"projects/{}/databases/{}/documents/{}".format(
+            project, DEFAULT_DATABASE, collection_id
+        )
+
+    def test_success(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+
+        prefix = self._dummy_ref_string("sub-collection")
+        actual_id = "this-is-the-one"
+        name = "{}/{}".format(prefix, actual_id)
+
+        document_pb = document_pb2.Document(name=name)
+        document_id = self._call_fut(document_pb, prefix)
+        self.assertEqual(document_id, actual_id)
+
+    def test_failure(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+
+        actual_prefix = self._dummy_ref_string("the-right-one")
+        wrong_prefix = self._dummy_ref_string("the-wrong-one")
+        name = "{}/{}".format(actual_prefix, "sorry-wont-works")
+
+        document_pb = document_pb2.Document(name=name)
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(document_pb, wrong_prefix)
+
+        exc_args = exc_info.exception.args
+        self.assertEqual(len(exc_args), 4)
+        self.assertEqual(exc_args[1], name)
+        self.assertEqual(exc_args[3], wrong_prefix)
+
+
+class Test_extract_fields(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_data, prefix_path, expand_dots=False):
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.extract_fields(
+            document_data, prefix_path, expand_dots=expand_dots
+        )
+
+    def test_w_empty_document(self):
+        from google.cloud.firestore_v1._helpers import _EmptyDict
+
+        document_data = {}
+        prefix_path = _make_field_path()
+        expected = [(_make_field_path(), _EmptyDict)]
+
+        iterator = self._call_fut(document_data, prefix_path)
+        self.assertEqual(list(iterator), expected)
+
+    def test_w_invalid_key_and_expand_dots(self):
+        document_data = {"b": 1, "a~d": 2, "c": 3}
+        prefix_path = _make_field_path()
+
+        with self.assertRaises(ValueError):
+            list(self._call_fut(document_data, prefix_path, expand_dots=True))
+
+    def test_w_shallow_keys(self):
+        document_data = {"b": 1, "a": 2, "c": 3}
+        prefix_path = _make_field_path()
+        expected = [
+            (_make_field_path("a"), 2),
+            (_make_field_path("b"), 1),
+            (_make_field_path("c"), 3),
+        ]
+
+        iterator = self._call_fut(document_data, prefix_path)
+        self.assertEqual(list(iterator), expected)
+
+    def test_w_nested(self):
+        from google.cloud.firestore_v1._helpers import _EmptyDict
+
+        document_data = {"b": {"a": {"d": 4, "c": 3, "g": {}}, "e": 7}, "f": 5}
+        prefix_path = _make_field_path()
+        expected = [
+            (_make_field_path("b", "a", "c"), 3),
+            (_make_field_path("b", "a", "d"), 4),
+            (_make_field_path("b", "a", "g"), _EmptyDict),
+            (_make_field_path("b", "e"), 7),
+            (_make_field_path("f"), 5),
+        ]
+
+        iterator = self._call_fut(document_data, prefix_path)
+        self.assertEqual(list(iterator), expected)
+
+    def test_w_expand_dotted(self):
+        from google.cloud.firestore_v1._helpers import _EmptyDict
+
+        document_data = {
+            "b": {"a": {"d": 4, "c": 3, "g": {}, "k.l.m": 17}, "e": 7},
+            "f": 5,
+            "h.i.j": 9,
+        }
+        prefix_path = _make_field_path()
+        expected = [
+            (_make_field_path("b", "a", "c"), 3),
+            (_make_field_path("b", "a", "d"), 4),
+            (_make_field_path("b", "a", "g"), _EmptyDict),
+            (_make_field_path("b", "a", "k.l.m"), 17),
+            (_make_field_path("b", "e"), 7),
+            (_make_field_path("f"), 5),
+            (_make_field_path("h", "i", "j"), 9),
+        ]
+
+        iterator = self._call_fut(document_data, prefix_path, expand_dots=True)
+        self.assertEqual(list(iterator), expected)
+
+
+class Test_set_field_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_data, field_path, value):
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.set_field_value(document_data, field_path, value)
+
+    def test_normal_value_w_shallow(self):
+        document = {}
+        field_path = _make_field_path("a")
+        value = 3
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": 3})
+
+    def test_normal_value_w_nested(self):
+        document = {}
+        field_path = _make_field_path("a", "b", "c")
+        value = 3
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": {"b": {"c": 3}}})
+
+    def test_empty_dict_w_shallow(self):
+        from google.cloud.firestore_v1._helpers import _EmptyDict
+
+        document = {}
+        field_path = _make_field_path("a")
+        value = _EmptyDict
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": {}})
+
+    def test_empty_dict_w_nested(self):
+        from google.cloud.firestore_v1._helpers import _EmptyDict
+
+        document = {}
+        field_path = _make_field_path("a", "b", "c")
+        value = _EmptyDict
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": {"b": {"c": {}}}})
+
+
+class Test_get_field_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_data, field_path):
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.get_field_value(document_data, field_path)
+
+    def test_w_empty_path(self):
+        document = {}
+
+        with self.assertRaises(ValueError):
+            self._call_fut(document, _make_field_path())
+
+    def test_miss_shallow(self):
+        document = {}
+
+        with self.assertRaises(KeyError):
+            self._call_fut(document, _make_field_path("nonesuch"))
+
+    def test_miss_nested(self):
+        document = {"a": {"b": {}}}
+
+        with self.assertRaises(KeyError):
+            self._call_fut(document, _make_field_path("a", "b", "c"))
+
+    def test_hit_shallow(self):
+        document = {"a": 1}
+
+        self.assertEqual(self._call_fut(document, _make_field_path("a")), 1)
+
+    def test_hit_nested(self):
+        document = {"a": {"b": {"c": 1}}}
+
+        self.assertEqual(self._call_fut(document, _make_field_path("a", "b", "c")), 1)
+
+
+class TestDocumentExtractor(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.DocumentExtractor
+
+    def _make_one(self, document_data):
+        return self._get_target_class()(document_data)
+
+    def test_ctor_w_empty_document(self):
+        document_data = {}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertTrue(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_delete_field_shallow(self):
+        from google.cloud.firestore_v1.transforms import DELETE_FIELD
+
+        document_data = {"a": DELETE_FIELD}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [_make_field_path("a")])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_delete_field_nested(self):
+        from google.cloud.firestore_v1.transforms import DELETE_FIELD
+
+        document_data = {"a": {"b": {"c": DELETE_FIELD}}}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [_make_field_path("a", "b", "c")])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_server_timestamp_shallow(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_data = {"a": SERVER_TIMESTAMP}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [_make_field_path("a")])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_server_timestamp_nested(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_data = {"a": {"b": {"c": SERVER_TIMESTAMP}}}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [_make_field_path("a", "b", "c")])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_array_remove_shallow(self):
+        from google.cloud.firestore_v1.transforms import ArrayRemove
+
+        values = [1, 3, 5]
+        document_data = {"a": ArrayRemove(values)}
+
+        inst = self._make_one(document_data)
+
+        expected_array_removes = {_make_field_path("a"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, expected_array_removes)
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_array_remove_nested(self):
+        from google.cloud.firestore_v1.transforms import ArrayRemove
+
+        values = [2, 4, 8]
+        document_data = {"a": {"b": {"c": ArrayRemove(values)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_array_removes = {_make_field_path("a", "b", "c"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, expected_array_removes)
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_array_union_shallow(self):
+        from google.cloud.firestore_v1.transforms import ArrayUnion
+
+        values = [1, 3, 5]
+        document_data = {"a": ArrayUnion(values)}
+
+        inst = self._make_one(document_data)
+
+        expected_array_unions = {_make_field_path("a"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, expected_array_unions)
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_array_union_nested(self):
+        from google.cloud.firestore_v1.transforms import ArrayUnion
+
+        values = [2, 4, 8]
+        document_data = {"a": {"b": {"c": ArrayUnion(values)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_array_unions = {_make_field_path("a", "b", "c"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, expected_array_unions)
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_increment_shallow(self):
+        from google.cloud.firestore_v1.transforms import Increment
+
+        value = 1
+        document_data = {"a": Increment(value)}
+
+        inst = self._make_one(document_data)
+
+        expected_increments = {_make_field_path("a"): value}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, expected_increments)
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_increment_nested(self):
+        from google.cloud.firestore_v1.transforms import Increment
+
+        value = 2
+        document_data = {"a": {"b": {"c": Increment(value)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_increments = {_make_field_path("a", "b", "c"): value}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, expected_increments)
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_maximum_shallow(self):
+        from google.cloud.firestore_v1.transforms import Maximum
+
+        value = 1
+        document_data = {"a": Maximum(value)}
+
+        inst = self._make_one(document_data)
+
+        expected_maximums = {_make_field_path("a"): value}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, expected_maximums)
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_maximum_nested(self):
+        from google.cloud.firestore_v1.transforms import Maximum
+
+        value = 2
+        document_data = {"a": {"b": {"c": Maximum(value)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_maximums = {_make_field_path("a", "b", "c"): value}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, expected_maximums)
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_minimum_shallow(self):
+        from google.cloud.firestore_v1.transforms import Minimum
+
+        value = 1
+        document_data = {"a": Minimum(value)}
+
+        inst = self._make_one(document_data)
+
+        expected_minimums = {_make_field_path("a"): value}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, expected_minimums)
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_minimum_nested(self):
+        from google.cloud.firestore_v1.transforms import Minimum
+
+        value = 2
+        document_data = {"a": {"b": {"c": Minimum(value)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_minimums = {_make_field_path("a", "b", "c"): value}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, expected_minimums)
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_empty_dict_shallow(self):
+        document_data = {"a": {}}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [_make_field_path("a")]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_empty_dict_nested(self):
+        document_data = {"a": {"b": {"c": {}}}}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [_make_field_path("a", "b", "c")]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_normal_value_shallow(self):
+        document_data = {"b": 1, "a": 2, "c": 3}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [
+            _make_field_path("a"),
+            _make_field_path("b"),
+            _make_field_path("c"),
+        ]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+
+    def test_ctor_w_normal_value_nested(self):
+        document_data = {"b": {"a": {"d": 4, "c": 3}, "e": 7}, "f": 5}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [
+            _make_field_path("b", "a", "c"),
+            _make_field_path("b", "a", "d"),
+            _make_field_path("b", "e"),
+            _make_field_path("f"),
+        ]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.increments, {})
+        self.assertEqual(inst.maximums, {})
+        self.assertEqual(inst.minimums, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+
+    def test_get_update_pb_w_exists_precondition(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        document_data = {}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        update_pb = inst.get_update_pb(document_path, exists=False)
+
+        self.assertIsInstance(update_pb, write_pb2.Write)
+        self.assertEqual(update_pb.update.name, document_path)
+        self.assertEqual(update_pb.update.fields, document_data)
+        self.assertTrue(update_pb.HasField("current_document"))
+        self.assertFalse(update_pb.current_document.exists)
+
+    def test_get_update_pb_wo_exists_precondition(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1._helpers import encode_dict
+
+        document_data = {"a": 1}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        update_pb = inst.get_update_pb(document_path)
+
+        self.assertIsInstance(update_pb, write_pb2.Write)
+        self.assertEqual(update_pb.update.name, document_path)
+        self.assertEqual(update_pb.update.fields, encode_dict(document_data))
+        self.assertFalse(update_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_server_timestamp_w_exists_precondition(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1._helpers import REQUEST_TIME_ENUM
+
+        document_data = {"a": SERVER_TIMESTAMP}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path, exists=False)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a")
+        self.assertEqual(transform.set_to_server_value, REQUEST_TIME_ENUM)
+        self.assertTrue(transform_pb.HasField("current_document"))
+        self.assertFalse(transform_pb.current_document.exists)
+
+    def test_get_transform_pb_w_server_timestamp_wo_exists_precondition(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1._helpers import REQUEST_TIME_ENUM
+
+        document_data = {"a": {"b": {"c": SERVER_TIMESTAMP}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        self.assertEqual(transform.set_to_server_value, REQUEST_TIME_ENUM)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    @staticmethod
+    def _array_value_to_list(array_value):
+        from google.cloud.firestore_v1._helpers import decode_value
+
+        return [decode_value(element, client=None) for element in array_value.values]
+
+    def test_get_transform_pb_w_array_remove(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import ArrayRemove
+
+        values = [2, 4, 8]
+        document_data = {"a": {"b": {"c": ArrayRemove(values)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        removed = self._array_value_to_list(transform.remove_all_from_array)
+        self.assertEqual(removed, values)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_array_union(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import ArrayUnion
+
+        values = [1, 3, 5]
+        document_data = {"a": {"b": {"c": ArrayUnion(values)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = self._array_value_to_list(transform.append_missing_elements)
+        self.assertEqual(added, values)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_increment_int(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import Increment
+
+        value = 1
+        document_data = {"a": {"b": {"c": Increment(value)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = transform.increment.integer_value
+        self.assertEqual(added, value)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_increment_float(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import Increment
+
+        value = 3.1415926
+        document_data = {"a": {"b": {"c": Increment(value)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = transform.increment.double_value
+        self.assertEqual(added, value)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_maximum_int(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import Maximum
+
+        value = 1
+        document_data = {"a": {"b": {"c": Maximum(value)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = transform.maximum.integer_value
+        self.assertEqual(added, value)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_maximum_float(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import Maximum
+
+        value = 3.1415926
+        document_data = {"a": {"b": {"c": Maximum(value)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = transform.maximum.double_value
+        self.assertEqual(added, value)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_minimum_int(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import Minimum
+
+        value = 1
+        document_data = {"a": {"b": {"c": Minimum(value)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = transform.minimum.integer_value
+        self.assertEqual(added, value)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_minimum_float(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.transforms import Minimum
+
+        value = 3.1415926
+        document_data = {"a": {"b": {"c": Minimum(value)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = transform.minimum.double_value
+        self.assertEqual(added, value)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+
+class Test_pbs_for_create(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, document_data):
+        from google.cloud.firestore_v1._helpers import pbs_for_create
+
+        return pbs_for_create(document_path, document_data)
+
+    @staticmethod
+    def _make_write_w_document(document_path, **data):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1._helpers import encode_dict
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        return write_pb2.Write(
+            update=document_pb2.Document(name=document_path, fields=encode_dict(data)),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+
+    @staticmethod
+    def _make_write_w_transform(document_path, fields):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.gapic import enums
+
+        server_val = enums.DocumentTransform.FieldTransform.ServerValue
+        transforms = [
+            write_pb2.DocumentTransform.FieldTransform(
+                field_path=field, set_to_server_value=server_val.REQUEST_TIME
+            )
+            for field in fields
+        ]
+
+        return write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=transforms
+            )
+        )
+
+    def _helper(self, do_transform=False, empty_val=False):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        if do_transform:
+            document_data["butter"] = SERVER_TIMESTAMP
+
+        if empty_val:
+            document_data["mustard"] = {}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        if empty_val:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True, mustard={}
+            )
+        else:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True
+            )
+        expected_pbs = [update_pb]
+
+        if do_transform:
+            expected_pbs.append(
+                self._make_write_w_transform(document_path, fields=["butter"])
+            )
+
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_without_transform(self):
+        self._helper()
+
+    def test_w_transform(self):
+        self._helper(do_transform=True)
+
+    def test_w_transform_and_empty_value(self):
+        self._helper(do_transform=True, empty_val=True)
+
+
+class Test_pbs_for_set_no_merge(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, document_data):
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.pbs_for_set_no_merge(document_path, document_data)
+
+    @staticmethod
+    def _make_write_w_document(document_path, **data):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1._helpers import encode_dict
+
+        return write_pb2.Write(
+            update=document_pb2.Document(name=document_path, fields=encode_dict(data))
+        )
+
+    @staticmethod
+    def _make_write_w_transform(document_path, fields):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.gapic import enums
+
+        server_val = enums.DocumentTransform.FieldTransform.ServerValue
+        transforms = [
+            write_pb2.DocumentTransform.FieldTransform(
+                field_path=field, set_to_server_value=server_val.REQUEST_TIME
+            )
+            for field in fields
+        ]
+
+        return write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=transforms
+            )
+        )
+
+    def test_w_empty_document(self):
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        update_pb = self._make_write_w_document(document_path)
+        expected_pbs = [update_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_w_only_server_timestamp(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"butter": SERVER_TIMESTAMP}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        update_pb = self._make_write_w_document(document_path)
+        transform_pb = self._make_write_w_transform(document_path, ["butter"])
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def _helper(self, do_transform=False, empty_val=False):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        if do_transform:
+            document_data["butter"] = SERVER_TIMESTAMP
+
+        if empty_val:
+            document_data["mustard"] = {}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        if empty_val:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True, mustard={}
+            )
+        else:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True
+            )
+        expected_pbs = [update_pb]
+
+        if do_transform:
+            expected_pbs.append(
+                self._make_write_w_transform(document_path, fields=["butter"])
+            )
+
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_defaults(self):
+        self._helper()
+
+    def test_w_transform(self):
+        self._helper(do_transform=True)
+
+    def test_w_transform_and_empty_value(self):
+        # Exercise #5944
+        self._helper(do_transform=True, empty_val=True)
+
+
+class TestDocumentExtractorForMerge(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.DocumentExtractorForMerge
+
+    def _make_one(self, document_data):
+        return self._get_target_class()(document_data)
+
+    def test_ctor_w_empty_document(self):
+        document_data = {}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.data_merge, [])
+        self.assertEqual(inst.transform_merge, [])
+        self.assertEqual(inst.merge, [])
+
+    def test_apply_merge_all_w_empty_document(self):
+        document_data = {}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(True)
+
+        self.assertEqual(inst.data_merge, [])
+        self.assertEqual(inst.transform_merge, [])
+        self.assertEqual(inst.merge, [])
+        self.assertFalse(inst.has_updates)
+
+    def test_apply_merge_all_w_delete(self):
+        from google.cloud.firestore_v1.transforms import DELETE_FIELD
+
+        document_data = {"write_me": "value", "delete_me": DELETE_FIELD}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(True)
+
+        expected_data_merge = [
+            _make_field_path("delete_me"),
+            _make_field_path("write_me"),
+        ]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, [])
+        self.assertEqual(inst.merge, expected_data_merge)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_all_w_server_timestamp(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_data = {"write_me": "value", "timestamp": SERVER_TIMESTAMP}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(True)
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("timestamp")]
+        expected_merge = [_make_field_path("timestamp"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_empty_document(self):
+        document_data = {}
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["nonesuch", "or.this"])
+
+    def test_apply_merge_list_fields_w_unmerged_delete(self):
+        from google.cloud.firestore_v1.transforms import DELETE_FIELD
+
+        document_data = {
+            "write_me": "value",
+            "delete_me": DELETE_FIELD,
+            "ignore_me": 123,
+            "unmerged_delete": DELETE_FIELD,
+        }
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["write_me", "delete_me"])
+
+    def test_apply_merge_list_fields_w_delete(self):
+        from google.cloud.firestore_v1.transforms import DELETE_FIELD
+
+        document_data = {
+            "write_me": "value",
+            "delete_me": DELETE_FIELD,
+            "ignore_me": 123,
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(["write_me", "delete_me"])
+
+        expected_set_fields = {"write_me": "value"}
+        expected_deleted_fields = [_make_field_path("delete_me")]
+        self.assertEqual(inst.set_fields, expected_set_fields)
+        self.assertEqual(inst.deleted_fields, expected_deleted_fields)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_prefixes(self):
+
+        document_data = {"a": {"b": {"c": 123}}}
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["a", "a.b"])
+
+    def test_apply_merge_list_fields_w_missing_data_string_paths(self):
+
+        document_data = {"write_me": "value", "ignore_me": 123}
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["write_me", "nonesuch"])
+
+    def test_apply_merge_list_fields_w_non_merge_field(self):
+
+        document_data = {"write_me": "value", "ignore_me": 123}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me")])
+
+        expected_set_fields = {"write_me": "value"}
+        self.assertEqual(inst.set_fields, expected_set_fields)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_server_timestamp(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_data = {
+            "write_me": "value",
+            "timestamp": SERVER_TIMESTAMP,
+            "ignored_stamp": SERVER_TIMESTAMP,
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me"), _make_field_path("timestamp")])
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("timestamp")]
+        expected_merge = [_make_field_path("timestamp"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        expected_server_timestamps = [_make_field_path("timestamp")]
+        self.assertEqual(inst.server_timestamps, expected_server_timestamps)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_array_remove(self):
+        from google.cloud.firestore_v1.transforms import ArrayRemove
+
+        values = [2, 4, 8]
+        document_data = {
+            "write_me": "value",
+            "remove_me": ArrayRemove(values),
+            "ignored_remove_me": ArrayRemove((1, 3, 5)),
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me"), _make_field_path("remove_me")])
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("remove_me")]
+        expected_merge = [_make_field_path("remove_me"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        expected_array_removes = {_make_field_path("remove_me"): values}
+        self.assertEqual(inst.array_removes, expected_array_removes)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_array_union(self):
+        from google.cloud.firestore_v1.transforms import ArrayUnion
+
+        values = [1, 3, 5]
+        document_data = {
+            "write_me": "value",
+            "union_me": ArrayUnion(values),
+            "ignored_union_me": ArrayUnion((2, 4, 8)),
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me"), _make_field_path("union_me")])
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("union_me")]
+        expected_merge = [_make_field_path("union_me"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        expected_array_unions = {_make_field_path("union_me"): values}
+        self.assertEqual(inst.array_unions, expected_array_unions)
+        self.assertTrue(inst.has_updates)
+
+
+class Test_pbs_for_set_with_merge(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, document_data, merge):
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.pbs_for_set_with_merge(
+            document_path, document_data, merge=merge
+        )
+
+    @staticmethod
+    def _make_write_w_document(document_path, **data):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1._helpers import encode_dict
+
+        return write_pb2.Write(
+            update=document_pb2.Document(name=document_path, fields=encode_dict(data))
+        )
+
+    @staticmethod
+    def _make_write_w_transform(document_path, fields):
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1.gapic import enums
+
+        server_val = enums.DocumentTransform.FieldTransform.ServerValue
+        transforms = [
+            write_pb2.DocumentTransform.FieldTransform(
+                field_path=field, set_to_server_value=server_val.REQUEST_TIME
+            )
+            for field in fields
+        ]
+
+        return write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=transforms
+            )
+        )
+
+    @staticmethod
+    def _update_document_mask(update_pb, field_paths):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        update_pb.update_mask.CopyFrom(
+            common_pb2.DocumentMask(field_paths=sorted(field_paths))
+        )
+
+    def test_with_merge_true_wo_transform(self):
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        write_pbs = self._call_fut(document_path, document_data, merge=True)
+
+        update_pb = self._make_write_w_document(document_path, **document_data)
+        self._update_document_mask(update_pb, field_paths=sorted(document_data))
+        expected_pbs = [update_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_wo_transform(self):
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        write_pbs = self._call_fut(document_path, document_data, merge=["cheese"])
+
+        update_pb = self._make_write_w_document(
+            document_path, cheese=document_data["cheese"]
+        )
+        self._update_document_mask(update_pb, field_paths=["cheese"])
+        expected_pbs = [update_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_true_w_transform(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = SERVER_TIMESTAMP
+
+        write_pbs = self._call_fut(document_path, document_data, merge=True)
+
+        update_pb = self._make_write_w_document(document_path, **update_data)
+        self._update_document_mask(update_pb, field_paths=sorted(update_data))
+        transform_pb = self._make_write_w_transform(document_path, fields=["butter"])
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_w_transform(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = SERVER_TIMESTAMP
+
+        write_pbs = self._call_fut(
+            document_path, document_data, merge=["cheese", "butter"]
+        )
+
+        update_pb = self._make_write_w_document(
+            document_path, cheese=document_data["cheese"]
+        )
+        self._update_document_mask(update_pb, ["cheese"])
+        transform_pb = self._make_write_w_transform(document_path, fields=["butter"])
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_w_transform_masking_simple(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = {"pecan": SERVER_TIMESTAMP}
+
+        write_pbs = self._call_fut(document_path, document_data, merge=["butter.pecan"])
+
+        update_pb = self._make_write_w_document(document_path)
+        transform_pb = self._make_write_w_transform(
+            document_path, fields=["butter.pecan"]
+        )
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_w_transform_parent(self):
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = {"popcorn": "yum", "pecan": SERVER_TIMESTAMP}
+
+        write_pbs = self._call_fut(
+            document_path, document_data, merge=["cheese", "butter"]
+        )
+
+        update_pb = self._make_write_w_document(
+            document_path, cheese=update_data["cheese"], butter={"popcorn": "yum"}
+        )
+        self._update_document_mask(update_pb, ["cheese", "butter"])
+        transform_pb = self._make_write_w_transform(
+            document_path, fields=["butter.pecan"]
+        )
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+
+class TestDocumentExtractorForUpdate(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1 import _helpers
+
+        return _helpers.DocumentExtractorForUpdate
+
+    def _make_one(self, document_data):
+        return self._get_target_class()(document_data)
+
+    def test_ctor_w_empty_document(self):
+        document_data = {}
+
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, [])
+
+    def test_ctor_w_simple_keys(self):
+        document_data = {"a": 1, "b": 2, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a"),
+            _make_field_path("b"),
+            _make_field_path("c"),
+        ]
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+
+    def test_ctor_w_nested_keys(self):
+        document_data = {"a": {"d": {"e": 1}}, "b": {"f": 7}, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a"),
+            _make_field_path("b"),
+            _make_field_path("c"),
+        ]
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+
+    def test_ctor_w_dotted_keys(self):
+        document_data = {"a.d.e": 1, "b.f": 7, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a", "d", "e"),
+            _make_field_path("b", "f"),
+            _make_field_path("c"),
+        ]
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+
+    def test_ctor_w_nested_dotted_keys(self):
+        document_data = {"a.d.e": 1, "b.f": {"h.i": 9}, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a", "d", "e"),
+            _make_field_path("b", "f"),
+            _make_field_path("c"),
+        ]
+        expected_set_fields = {"a": {"d": {"e": 1}}, "b": {"f": {"h.i": 9}}, "c": 3}
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+        self.assertEqual(inst.set_fields, expected_set_fields)
+
+
+class Test_pbs_for_update(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, field_updates, option):
+        from google.cloud.firestore_v1._helpers import pbs_for_update
+
+        return pbs_for_update(document_path, field_updates, option)
+
+    def _helper(self, option=None, do_transform=False, **write_kwargs):
+        from google.cloud.firestore_v1 import _helpers
+        from google.cloud.firestore_v1.field_path import FieldPath
+        from google.cloud.firestore_v1.transforms import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        document_path = _make_ref_string(u"toy", u"car", u"onion", u"garlic")
+        field_path1 = "bitez.yum"
+        value = b"\x00\x01"
+        field_path2 = "blog.internet"
+
+        field_updates = {field_path1: value}
+        if do_transform:
+            field_updates[field_path2] = SERVER_TIMESTAMP
+
+        write_pbs = self._call_fut(document_path, field_updates, option)
+
+        map_pb = document_pb2.MapValue(fields={"yum": _value_pb(bytes_value=value)})
+
+        field_paths = [field_path1]
+
+        expected_update_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields={"bitez": _value_pb(map_value=map_pb)}
+            ),
+            update_mask=common_pb2.DocumentMask(field_paths=field_paths),
+            **write_kwargs
+        )
+        if isinstance(option, _helpers.ExistsOption):
+            precondition = common_pb2.Precondition(exists=False)
+            expected_update_pb.current_document.CopyFrom(precondition)
+        expected_pbs = [expected_update_pb]
+        if do_transform:
+            transform_paths = FieldPath.from_string(field_path2)
+            server_val = enums.DocumentTransform.FieldTransform.ServerValue
+            expected_transform_pb = write_pb2.Write(
+                transform=write_pb2.DocumentTransform(
+                    document=document_path,
+                    field_transforms=[
+                        write_pb2.DocumentTransform.FieldTransform(
+                            field_path=transform_paths.to_api_repr(),
+                            set_to_server_value=server_val.REQUEST_TIME,
+                        )
+                    ],
+                )
+            )
+            expected_pbs.append(expected_transform_pb)
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_without_option(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        precondition = common_pb2.Precondition(exists=True)
+        self._helper(current_document=precondition)
+
+    def test_with_exists_option(self):
+        from google.cloud.firestore_v1.client import _helpers
+
+        option = _helpers.ExistsOption(False)
+        self._helper(option=option)
+
+    def test_update_and_transform(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        precondition = common_pb2.Precondition(exists=True)
+        self._helper(current_document=precondition, do_transform=True)
+
+
+class Test_pb_for_delete(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, option):
+        from google.cloud.firestore_v1._helpers import pb_for_delete
+
+        return pb_for_delete(document_path, option)
+
+    def _helper(self, option=None, **write_kwargs):
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        document_path = _make_ref_string(u"chicken", u"philly", u"one", u"two")
+        write_pb = self._call_fut(document_path, option)
+
+        expected_pb = write_pb2.Write(delete=document_path, **write_kwargs)
+        self.assertEqual(write_pb, expected_pb)
+
+    def test_without_option(self):
+        self._helper()
+
+    def test_with_option(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1 import _helpers
+
+        update_time = timestamp_pb2.Timestamp(seconds=1309700594, nanos=822211297)
+        option = _helpers.LastUpdateOption(update_time)
+        precondition = common_pb2.Precondition(update_time=update_time)
+        self._helper(option=option, current_document=precondition)
+
+
+class Test_get_transaction_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut(transaction, **kwargs):
+        from google.cloud.firestore_v1._helpers import get_transaction_id
+
+        return get_transaction_id(transaction, **kwargs)
+
+    def test_no_transaction(self):
+        ret_val = self._call_fut(None)
+        self.assertIsNone(ret_val)
+
+    def test_invalid_transaction(self):
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        self.assertFalse(transaction.in_progress)
+        with self.assertRaises(ValueError):
+            self._call_fut(transaction)
+
+    def test_after_writes_not_allowed(self):
+        from google.cloud.firestore_v1._helpers import ReadAfterWriteError
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        transaction._id = b"under-hook"
+        transaction._write_pbs.append(mock.sentinel.write)
+
+        with self.assertRaises(ReadAfterWriteError):
+            self._call_fut(transaction)
+
+    def test_after_writes_allowed(self):
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        txn_id = b"we-are-0fine"
+        transaction._id = txn_id
+        transaction._write_pbs.append(mock.sentinel.write)
+
+        ret_val = self._call_fut(transaction, read_operation=False)
+        self.assertEqual(ret_val, txn_id)
+
+    def test_good_transaction(self):
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        txn_id = b"doubt-it"
+        transaction._id = txn_id
+        self.assertTrue(transaction.in_progress)
+
+        self.assertEqual(self._call_fut(transaction), txn_id)
+
+
+class Test_metadata_with_prefix(unittest.TestCase):
+    @staticmethod
+    def _call_fut(database_string):
+        from google.cloud.firestore_v1._helpers import metadata_with_prefix
+
+        return metadata_with_prefix(database_string)
+
+    def test_it(self):
+        database_string = u"projects/prahj/databases/dee-bee"
+        metadata = self._call_fut(database_string)
+
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database_string)])
+
+
+class TestWriteOption(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1._helpers import WriteOption
+
+        return WriteOption
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_modify_write(self):
+        option = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            option.modify_write(None)
+
+
+class TestLastUpdateOption(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1._helpers import LastUpdateOption
+
+        return LastUpdateOption
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        self.assertIs(option._last_update_time, mock.sentinel.timestamp)
+
+    def test___eq___different_type(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = object()
+        self.assertFalse(option == other)
+
+    def test___eq___different_timestamp(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = self._make_one(mock.sentinel.other_timestamp)
+        self.assertFalse(option == other)
+
+    def test___eq___same_timestamp(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = self._make_one(mock.sentinel.timestamp)
+        self.assertTrue(option == other)
+
+    def test_modify_write_update_time(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=683893592, nanos=229362000)
+        option = self._make_one(timestamp_pb)
+        write_pb = write_pb2.Write()
+        ret_val = option.modify_write(write_pb)
+
+        self.assertIsNone(ret_val)
+        expected_doc = common_pb2.Precondition(update_time=timestamp_pb)
+        self.assertEqual(write_pb.current_document, expected_doc)
+
+
+class TestExistsOption(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1._helpers import ExistsOption
+
+        return ExistsOption
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        option = self._make_one(mock.sentinel.totes_bool)
+        self.assertIs(option._exists, mock.sentinel.totes_bool)
+
+    def test___eq___different_type(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = object()
+        self.assertFalse(option == other)
+
+    def test___eq___different_exists(self):
+        option = self._make_one(True)
+        other = self._make_one(False)
+        self.assertFalse(option == other)
+
+    def test___eq___same_exists(self):
+        option = self._make_one(True)
+        other = self._make_one(True)
+        self.assertTrue(option == other)
+
+    def test_modify_write(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        for exists in (True, False):
+            option = self._make_one(exists)
+            write_pb = write_pb2.Write()
+            ret_val = option.modify_write(write_pb)
+
+            self.assertIsNone(ret_val)
+            expected_doc = common_pb2.Precondition(exists=exists)
+            self.assertEqual(write_pb.current_document, expected_doc)
+
+
+def _value_pb(**kwargs):
+    from google.cloud.firestore_v1.proto.document_pb2 import Value
+
+    return Value(**kwargs)
+
+
+def _make_ref_string(project, database, *path):
+    from google.cloud.firestore_v1 import _helpers
+
+    doc_rel_path = _helpers.DOCUMENT_PATH_DELIMITER.join(path)
+    return u"projects/{}/databases/{}/documents/{}".format(
+        project, database, doc_rel_path
+    )
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="quark"):
+    from google.cloud.firestore_v1.client import Client
+
+    credentials = _make_credentials()
+    return Client(project=project, credentials=credentials)
+
+
+def _make_field_path(*fields):
+    from google.cloud.firestore_v1 import field_path
+
+    return field_path.FieldPath(*fields)
diff --git a/firestore/tests/unit/v1/test_batch.py b/firestore/tests/unit/v1/test_batch.py
new file mode 100644
index 000000000000..08421d6039dd
--- /dev/null
+++ b/firestore/tests/unit/v1/test_batch.py
@@ -0,0 +1,271 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+import mock
+
+
+class TestWriteBatch(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.batch import WriteBatch
+
+        return WriteBatch
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        batch = self._make_one(mock.sentinel.client)
+        self.assertIs(batch._client, mock.sentinel.client)
+        self.assertEqual(batch._write_pbs, [])
+        self.assertIsNone(batch.write_results)
+        self.assertIsNone(batch.commit_time)
+
+    def test__add_write_pbs(self):
+        batch = self._make_one(mock.sentinel.client)
+        self.assertEqual(batch._write_pbs, [])
+        batch._add_write_pbs([mock.sentinel.write1, mock.sentinel.write2])
+        self.assertEqual(batch._write_pbs, [mock.sentinel.write1, mock.sentinel.write2])
+
+    def test_create(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("this", "one")
+        document_data = {"a": 10, "b": 2.5}
+        ret_val = batch.create(reference, document_data)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={
+                    "a": _value_pb(integer_value=document_data["a"]),
+                    "b": _value_pb(double_value=document_data["b"]),
+                },
+            ),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_set(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("another", "one")
+        field = "zapzap"
+        value = u"meadows and flowers"
+        document_data = {field: value}
+        ret_val = batch.set(reference, document_data)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={field: _value_pb(string_value=value)},
+            )
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_set_merge(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("another", "one")
+        field = "zapzap"
+        value = u"meadows and flowers"
+        document_data = {field: value}
+        ret_val = batch.set(reference, document_data, merge=True)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={field: _value_pb(string_value=value)},
+            ),
+            update_mask={"field_paths": [field]},
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_update(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("cats", "cradle")
+        field_path = "head.foot"
+        value = u"knees toes shoulders"
+        field_updates = {field_path: value}
+
+        ret_val = batch.update(reference, field_updates)
+        self.assertIsNone(ret_val)
+
+        map_pb = document_pb2.MapValue(fields={"foot": _value_pb(string_value=value)})
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={"head": _value_pb(map_value=map_pb)},
+            ),
+            update_mask=common_pb2.DocumentMask(field_paths=[field_path]),
+            current_document=common_pb2.Precondition(exists=True),
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_delete(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("early", "mornin", "dawn", "now")
+        ret_val = batch.delete(reference)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(delete=reference._document_path)
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_commit(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto import firestore_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.Mock(spec=["commit"])
+        timestamp = timestamp_pb2.Timestamp(seconds=1234567, nanos=123456798)
+        commit_response = firestore_pb2.CommitResponse(
+            write_results=[write_pb2.WriteResult(), write_pb2.WriteResult()],
+            commit_time=timestamp,
+        )
+        firestore_api.commit.return_value = commit_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("grand")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a batch with some mutations and call commit().
+        batch = self._make_one(client)
+        document1 = client.document("a", "b")
+        batch.create(document1, {"ten": 10, "buck": u"ets"})
+        document2 = client.document("c", "d", "e", "f")
+        batch.delete(document2)
+        write_pbs = batch._write_pbs[::]
+
+        write_results = batch.commit()
+        self.assertEqual(write_results, list(commit_response.write_results))
+        self.assertEqual(batch.write_results, write_results)
+        self.assertEqual(batch.commit_time, timestamp)
+        # Make sure batch has no more "changes".
+        self.assertEqual(batch._write_pbs, [])
+
+        # Verify the mocks.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_as_context_mgr_wo_error(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto import firestore_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        firestore_api = mock.Mock(spec=["commit"])
+        timestamp = timestamp_pb2.Timestamp(seconds=1234567, nanos=123456798)
+        commit_response = firestore_pb2.CommitResponse(
+            write_results=[write_pb2.WriteResult(), write_pb2.WriteResult()],
+            commit_time=timestamp,
+        )
+        firestore_api.commit.return_value = commit_response
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+        batch = self._make_one(client)
+        document1 = client.document("a", "b")
+        document2 = client.document("c", "d", "e", "f")
+
+        with batch as ctx_mgr:
+            self.assertIs(ctx_mgr, batch)
+            ctx_mgr.create(document1, {"ten": 10, "buck": u"ets"})
+            ctx_mgr.delete(document2)
+            write_pbs = batch._write_pbs[::]
+
+        self.assertEqual(batch.write_results, list(commit_response.write_results))
+        self.assertEqual(batch.commit_time, timestamp)
+        # Make sure batch has no more "changes".
+        self.assertEqual(batch._write_pbs, [])
+
+        # Verify the mocks.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_as_context_mgr_w_error(self):
+        firestore_api = mock.Mock(spec=["commit"])
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+        batch = self._make_one(client)
+        document1 = client.document("a", "b")
+        document2 = client.document("c", "d", "e", "f")
+
+        with self.assertRaises(RuntimeError):
+            with batch as ctx_mgr:
+                ctx_mgr.create(document1, {"ten": 10, "buck": u"ets"})
+                ctx_mgr.delete(document2)
+                raise RuntimeError("testing")
+
+        self.assertIsNone(batch.write_results)
+        self.assertIsNone(batch.commit_time)
+        # batch still has its changes
+        self.assertEqual(len(batch._write_pbs), 2)
+
+        firestore_api.commit.assert_not_called()
+
+
+def _value_pb(**kwargs):
+    from google.cloud.firestore_v1.proto.document_pb2 import Value
+
+    return Value(**kwargs)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="seventy-nine"):
+    from google.cloud.firestore_v1.client import Client
+
+    credentials = _make_credentials()
+    return Client(project=project, credentials=credentials)
diff --git a/firestore/tests/unit/v1/test_client.py b/firestore/tests/unit/v1/test_client.py
new file mode 100644
index 000000000000..7ec062422a6c
--- /dev/null
+++ b/firestore/tests/unit/v1/test_client.py
@@ -0,0 +1,745 @@
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import types
+import unittest
+
+import mock
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "my-prahjekt"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def _make_default_one(self):
+        credentials = _make_credentials()
+        return self._make_one(project=self.PROJECT, credentials=credentials)
+
+    def test_constructor(self):
+        from google.cloud.firestore_v1.client import _CLIENT_INFO
+        from google.cloud.firestore_v1.client import DEFAULT_DATABASE
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertEqual(client._credentials, credentials)
+        self.assertEqual(client._database, DEFAULT_DATABASE)
+        self.assertIs(client._client_info, _CLIENT_INFO)
+        self.assertIsNone(client._emulator_host)
+
+    def test_constructor_with_emulator_host(self):
+        from google.cloud.firestore_v1.client import _FIRESTORE_EMULATOR_HOST
+
+        credentials = _make_credentials()
+        emulator_host = "localhost:8081"
+        with mock.patch("os.getenv") as getenv:
+            getenv.return_value = emulator_host
+            client = self._make_one(project=self.PROJECT, credentials=credentials)
+            self.assertEqual(client._emulator_host, emulator_host)
+            getenv.assert_called_once_with(_FIRESTORE_EMULATOR_HOST)
+
+    def test_constructor_explicit(self):
+        credentials = _make_credentials()
+        database = "now-db"
+        client_info = mock.Mock()
+        client_options = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            database=database,
+            client_info=client_info,
+            client_options=client_options,
+        )
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertEqual(client._credentials, credentials)
+        self.assertEqual(client._database, database)
+        self.assertIs(client._client_info, client_info)
+        self.assertIs(client._client_options, client_options)
+
+    def test_constructor_w_client_options(self):
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT,
+            credentials=credentials,
+            client_options={"api_endpoint": "foo-firestore.googleapis.com"},
+        )
+        self.assertEqual(client._target, "foo-firestore.googleapis.com")
+
+    @mock.patch(
+        "google.cloud.firestore_v1.gapic.firestore_client.FirestoreClient",
+        autospec=True,
+        return_value=mock.sentinel.firestore_api,
+    )
+    def test__firestore_api_property(self, mock_client):
+        mock_client.SERVICE_ADDRESS = "endpoint"
+        client = self._make_default_one()
+        client_info = client._client_info = mock.Mock()
+        self.assertIsNone(client._firestore_api_internal)
+        firestore_api = client._firestore_api
+        self.assertIs(firestore_api, mock_client.return_value)
+        self.assertIs(firestore_api, client._firestore_api_internal)
+        mock_client.assert_called_once_with(
+            transport=client._transport, client_info=client_info
+        )
+
+        # Call again to show that it is cached, but call count is still 1.
+        self.assertIs(client._firestore_api, mock_client.return_value)
+        self.assertEqual(mock_client.call_count, 1)
+
+    @mock.patch(
+        "google.cloud.firestore_v1.gapic.firestore_client.FirestoreClient",
+        autospec=True,
+        return_value=mock.sentinel.firestore_api,
+    )
+    @mock.patch(
+        "google.cloud.firestore_v1.gapic.transports.firestore_grpc_transport.firestore_pb2_grpc.grpc.insecure_channel",
+        autospec=True,
+    )
+    def test__firestore_api_property_with_emulator(
+        self, mock_insecure_channel, mock_client
+    ):
+        emulator_host = "localhost:8081"
+        with mock.patch("os.getenv") as getenv:
+            getenv.return_value = emulator_host
+            client = self._make_default_one()
+
+        self.assertIsNone(client._firestore_api_internal)
+        firestore_api = client._firestore_api
+        self.assertIs(firestore_api, mock_client.return_value)
+        self.assertIs(firestore_api, client._firestore_api_internal)
+
+        mock_insecure_channel.assert_called_once_with(emulator_host)
+
+        # Call again to show that it is cached, but call count is still 1.
+        self.assertIs(client._firestore_api, mock_client.return_value)
+        self.assertEqual(mock_client.call_count, 1)
+
+    def test___database_string_property(self):
+        credentials = _make_credentials()
+        database = "cheeeeez"
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, database=database
+        )
+        self.assertIsNone(client._database_string_internal)
+        database_string = client._database_string
+        expected = "projects/{}/databases/{}".format(client.project, client._database)
+        self.assertEqual(database_string, expected)
+        self.assertIs(database_string, client._database_string_internal)
+
+        # Swap it out with a unique value to verify it is cached.
+        client._database_string_internal = mock.sentinel.cached
+        self.assertIs(client._database_string, mock.sentinel.cached)
+
+    def test___rpc_metadata_property(self):
+        credentials = _make_credentials()
+        database = "quanta"
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, database=database
+        )
+
+        self.assertEqual(
+            client._rpc_metadata,
+            [("google-cloud-resource-prefix", client._database_string)],
+        )
+
+    def test__rpc_metadata_property_with_emulator(self):
+        emulator_host = "localhost:8081"
+        with mock.patch("os.getenv") as getenv:
+            getenv.return_value = emulator_host
+
+            credentials = _make_credentials()
+            database = "quanta"
+            client = self._make_one(
+                project=self.PROJECT, credentials=credentials, database=database
+            )
+
+        self.assertEqual(
+            client._rpc_metadata,
+            [
+                ("google-cloud-resource-prefix", client._database_string),
+                ("authorization", "Bearer owner"),
+            ],
+        )
+
+    def test_collection_factory(self):
+        from google.cloud.firestore_v1.collection import CollectionReference
+
+        collection_id = "users"
+        client = self._make_default_one()
+        collection = client.collection(collection_id)
+
+        self.assertEqual(collection._path, (collection_id,))
+        self.assertIs(collection._client, client)
+        self.assertIsInstance(collection, CollectionReference)
+
+    def test_collection_factory_nested(self):
+        from google.cloud.firestore_v1.collection import CollectionReference
+
+        client = self._make_default_one()
+        parts = ("users", "alovelace", "beep")
+        collection_path = "/".join(parts)
+        collection1 = client.collection(collection_path)
+
+        self.assertEqual(collection1._path, parts)
+        self.assertIs(collection1._client, client)
+        self.assertIsInstance(collection1, CollectionReference)
+
+        # Make sure using segments gives the same result.
+        collection2 = client.collection(*parts)
+        self.assertEqual(collection2._path, parts)
+        self.assertIs(collection2._client, client)
+        self.assertIsInstance(collection2, CollectionReference)
+
+    def test_collection_group(self):
+        client = self._make_default_one()
+        query = client.collection_group("collectionId").where("foo", "==", u"bar")
+
+        assert query._all_descendants
+        assert query._field_filters[0].field.field_path == "foo"
+        assert query._field_filters[0].value.string_value == u"bar"
+        assert query._field_filters[0].op == query._field_filters[0].EQUAL
+        assert query._parent.id == "collectionId"
+
+    def test_collection_group_no_slashes(self):
+        client = self._make_default_one()
+        with self.assertRaises(ValueError):
+            client.collection_group("foo/bar")
+
+    def test_document_factory(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        parts = ("rooms", "roomA")
+        client = self._make_default_one()
+        doc_path = "/".join(parts)
+        document1 = client.document(doc_path)
+
+        self.assertEqual(document1._path, parts)
+        self.assertIs(document1._client, client)
+        self.assertIsInstance(document1, DocumentReference)
+
+        # Make sure using segments gives the same result.
+        document2 = client.document(*parts)
+        self.assertEqual(document2._path, parts)
+        self.assertIs(document2._client, client)
+        self.assertIsInstance(document2, DocumentReference)
+
+    def test_document_factory_w_absolute_path(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        parts = ("rooms", "roomA")
+        client = self._make_default_one()
+        doc_path = "/".join(parts)
+        to_match = client.document(doc_path)
+        document1 = client.document(to_match._document_path)
+
+        self.assertEqual(document1._path, parts)
+        self.assertIs(document1._client, client)
+        self.assertIsInstance(document1, DocumentReference)
+
+    def test_document_factory_w_nested_path(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        client = self._make_default_one()
+        parts = ("rooms", "roomA", "shoes", "dressy")
+        doc_path = "/".join(parts)
+        document1 = client.document(doc_path)
+
+        self.assertEqual(document1._path, parts)
+        self.assertIs(document1._client, client)
+        self.assertIsInstance(document1, DocumentReference)
+
+        # Make sure using segments gives the same result.
+        document2 = client.document(*parts)
+        self.assertEqual(document2._path, parts)
+        self.assertIs(document2._client, client)
+        self.assertIsInstance(document2, DocumentReference)
+
+    def test_field_path(self):
+        klass = self._get_target_class()
+        self.assertEqual(klass.field_path("a", "b", "c"), "a.b.c")
+
+    def test_write_option_last_update(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1._helpers import LastUpdateOption
+
+        timestamp = timestamp_pb2.Timestamp(seconds=1299767599, nanos=811111097)
+
+        klass = self._get_target_class()
+        option = klass.write_option(last_update_time=timestamp)
+        self.assertIsInstance(option, LastUpdateOption)
+        self.assertEqual(option._last_update_time, timestamp)
+
+    def test_write_option_exists(self):
+        from google.cloud.firestore_v1._helpers import ExistsOption
+
+        klass = self._get_target_class()
+
+        option1 = klass.write_option(exists=False)
+        self.assertIsInstance(option1, ExistsOption)
+        self.assertFalse(option1._exists)
+
+        option2 = klass.write_option(exists=True)
+        self.assertIsInstance(option2, ExistsOption)
+        self.assertTrue(option2._exists)
+
+    def test_write_open_neither_arg(self):
+        from google.cloud.firestore_v1.client import _BAD_OPTION_ERR
+
+        klass = self._get_target_class()
+        with self.assertRaises(TypeError) as exc_info:
+            klass.write_option()
+
+        self.assertEqual(exc_info.exception.args, (_BAD_OPTION_ERR,))
+
+    def test_write_multiple_args(self):
+        from google.cloud.firestore_v1.client import _BAD_OPTION_ERR
+
+        klass = self._get_target_class()
+        with self.assertRaises(TypeError) as exc_info:
+            klass.write_option(exists=False, last_update_time=mock.sentinel.timestamp)
+
+        self.assertEqual(exc_info.exception.args, (_BAD_OPTION_ERR,))
+
+    def test_write_bad_arg(self):
+        from google.cloud.firestore_v1.client import _BAD_OPTION_ERR
+
+        klass = self._get_target_class()
+        with self.assertRaises(TypeError) as exc_info:
+            klass.write_option(spinach="popeye")
+
+        extra = "{!r} was provided".format("spinach")
+        self.assertEqual(exc_info.exception.args, (_BAD_OPTION_ERR, extra))
+
+    def test_collections(self):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.firestore_v1.collection import CollectionReference
+
+        collection_ids = ["users", "projects"]
+        client = self._make_default_one()
+        firestore_api = mock.Mock(spec=["list_collection_ids"])
+        client._firestore_api_internal = firestore_api
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        iterator = _Iterator(pages=[collection_ids])
+        firestore_api.list_collection_ids.return_value = iterator
+
+        collections = list(client.collections())
+
+        self.assertEqual(len(collections), len(collection_ids))
+        for collection, collection_id in zip(collections, collection_ids):
+            self.assertIsInstance(collection, CollectionReference)
+            self.assertEqual(collection.parent, None)
+            self.assertEqual(collection.id, collection_id)
+
+        base_path = client._database_string + "/documents"
+        firestore_api.list_collection_ids.assert_called_once_with(
+            base_path, metadata=client._rpc_metadata
+        )
+
+    def _get_all_helper(self, client, references, document_pbs, **kwargs):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["batch_get_documents"])
+        response_iterator = iter(document_pbs)
+        firestore_api.batch_get_documents.return_value = response_iterator
+
+        # Attach the fake GAPIC to a real client.
+        client._firestore_api_internal = firestore_api
+
+        # Actually call get_all().
+        snapshots = client.get_all(references, **kwargs)
+        self.assertIsInstance(snapshots, types.GeneratorType)
+
+        return list(snapshots)
+
+    def _info_for_get_all(self, data1, data2):
+        client = self._make_default_one()
+        document1 = client.document("pineapple", "lamp1")
+        document2 = client.document("pineapple", "lamp2")
+
+        # Make response protobufs.
+        document_pb1, read_time = _doc_get_info(document1._document_path, data1)
+        response1 = _make_batch_response(found=document_pb1, read_time=read_time)
+
+        document_pb2, read_time = _doc_get_info(document2._document_path, data2)
+        response2 = _make_batch_response(found=document_pb2, read_time=read_time)
+
+        return client, document1, document2, response1, response2
+
+    def test_get_all(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        data1 = {"a": u"cheese"}
+        data2 = {"b": True, "c": 18}
+        info = self._info_for_get_all(data1, data2)
+        client, document1, document2, response1, response2 = info
+
+        # Exercise the mocked ``batch_get_documents``.
+        field_paths = ["a", "b"]
+        snapshots = self._get_all_helper(
+            client,
+            [document1, document2],
+            [response1, response2],
+            field_paths=field_paths,
+        )
+        self.assertEqual(len(snapshots), 2)
+
+        snapshot1 = snapshots[0]
+        self.assertIsInstance(snapshot1, DocumentSnapshot)
+        self.assertIs(snapshot1._reference, document1)
+        self.assertEqual(snapshot1._data, data1)
+
+        snapshot2 = snapshots[1]
+        self.assertIsInstance(snapshot2, DocumentSnapshot)
+        self.assertIs(snapshot2._reference, document2)
+        self.assertEqual(snapshot2._data, data2)
+
+        # Verify the call to the mock.
+        doc_paths = [document1._document_path, document2._document_path]
+        mask = common_pb2.DocumentMask(field_paths=field_paths)
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            mask,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all_with_transaction(self):
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        data = {"so-much": 484}
+        info = self._info_for_get_all(data, {})
+        client, document, _, response, _ = info
+        transaction = client.transaction()
+        txn_id = b"the-man-is-non-stop"
+        transaction._id = txn_id
+
+        # Exercise the mocked ``batch_get_documents``.
+        snapshots = self._get_all_helper(
+            client, [document], [response], transaction=transaction
+        )
+        self.assertEqual(len(snapshots), 1)
+
+        snapshot = snapshots[0]
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        self.assertIs(snapshot._reference, document)
+        self.assertEqual(snapshot._data, data)
+
+        # Verify the call to the mock.
+        doc_paths = [document._document_path]
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            None,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all_unknown_result(self):
+        from google.cloud.firestore_v1.client import _BAD_DOC_TEMPLATE
+
+        info = self._info_for_get_all({"z": 28.5}, {})
+        client, document, _, _, response = info
+
+        # Exercise the mocked ``batch_get_documents``.
+        with self.assertRaises(ValueError) as exc_info:
+            self._get_all_helper(client, [document], [response])
+
+        err_msg = _BAD_DOC_TEMPLATE.format(response.found.name)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+        # Verify the call to the mock.
+        doc_paths = [document._document_path]
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            None,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all_wrong_order(self):
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        data1 = {"up": 10}
+        data2 = {"down": -10}
+        info = self._info_for_get_all(data1, data2)
+        client, document1, document2, response1, response2 = info
+        document3 = client.document("pineapple", "lamp3")
+        response3 = _make_batch_response(missing=document3._document_path)
+
+        # Exercise the mocked ``batch_get_documents``.
+        snapshots = self._get_all_helper(
+            client, [document1, document2, document3], [response2, response1, response3]
+        )
+
+        self.assertEqual(len(snapshots), 3)
+
+        snapshot1 = snapshots[0]
+        self.assertIsInstance(snapshot1, DocumentSnapshot)
+        self.assertIs(snapshot1._reference, document2)
+        self.assertEqual(snapshot1._data, data2)
+
+        snapshot2 = snapshots[1]
+        self.assertIsInstance(snapshot2, DocumentSnapshot)
+        self.assertIs(snapshot2._reference, document1)
+        self.assertEqual(snapshot2._data, data1)
+
+        self.assertFalse(snapshots[2].exists)
+
+        # Verify the call to the mock.
+        doc_paths = [
+            document1._document_path,
+            document2._document_path,
+            document3._document_path,
+        ]
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            None,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_batch(self):
+        from google.cloud.firestore_v1.batch import WriteBatch
+
+        client = self._make_default_one()
+        batch = client.batch()
+        self.assertIsInstance(batch, WriteBatch)
+        self.assertIs(batch._client, client)
+        self.assertEqual(batch._write_pbs, [])
+
+    def test_transaction(self):
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        client = self._make_default_one()
+        transaction = client.transaction(max_attempts=3, read_only=True)
+        self.assertIsInstance(transaction, Transaction)
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertEqual(transaction._max_attempts, 3)
+        self.assertTrue(transaction._read_only)
+        self.assertIsNone(transaction._id)
+
+
+class Test__reference_info(unittest.TestCase):
+    @staticmethod
+    def _call_fut(references):
+        from google.cloud.firestore_v1.client import _reference_info
+
+        return _reference_info(references)
+
+    def test_it(self):
+        from google.cloud.firestore_v1.client import Client
+
+        credentials = _make_credentials()
+        client = Client(project="hi-projject", credentials=credentials)
+
+        reference1 = client.document("a", "b")
+        reference2 = client.document("a", "b", "c", "d")
+        reference3 = client.document("a", "b")
+        reference4 = client.document("f", "g")
+
+        doc_path1 = reference1._document_path
+        doc_path2 = reference2._document_path
+        doc_path3 = reference3._document_path
+        doc_path4 = reference4._document_path
+        self.assertEqual(doc_path1, doc_path3)
+
+        document_paths, reference_map = self._call_fut(
+            [reference1, reference2, reference3, reference4]
+        )
+        self.assertEqual(document_paths, [doc_path1, doc_path2, doc_path3, doc_path4])
+        # reference3 over-rides reference1.
+        expected_map = {
+            doc_path2: reference2,
+            doc_path3: reference3,
+            doc_path4: reference4,
+        }
+        self.assertEqual(reference_map, expected_map)
+
+
+class Test__get_reference(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, reference_map):
+        from google.cloud.firestore_v1.client import _get_reference
+
+        return _get_reference(document_path, reference_map)
+
+    def test_success(self):
+        doc_path = "a/b/c"
+        reference_map = {doc_path: mock.sentinel.reference}
+        self.assertIs(self._call_fut(doc_path, reference_map), mock.sentinel.reference)
+
+    def test_failure(self):
+        from google.cloud.firestore_v1.client import _BAD_DOC_TEMPLATE
+
+        doc_path = "1/888/call-now"
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(doc_path, {})
+
+        err_msg = _BAD_DOC_TEMPLATE.format(doc_path)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+
+class Test__parse_batch_get(unittest.TestCase):
+    @staticmethod
+    def _call_fut(get_doc_response, reference_map, client=mock.sentinel.client):
+        from google.cloud.firestore_v1.client import _parse_batch_get
+
+        return _parse_batch_get(get_doc_response, reference_map, client)
+
+    @staticmethod
+    def _dummy_ref_string():
+        from google.cloud.firestore_v1.client import DEFAULT_DATABASE
+
+        project = u"bazzzz"
+        collection_id = u"fizz"
+        document_id = u"buzz"
+        return u"projects/{}/databases/{}/documents/{}/{}".format(
+            project, DEFAULT_DATABASE, collection_id, document_id
+        )
+
+    def test_found(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        now = datetime.datetime.utcnow()
+        read_time = _datetime_to_pb_timestamp(now)
+        delta = datetime.timedelta(seconds=100)
+        update_time = _datetime_to_pb_timestamp(now - delta)
+        create_time = _datetime_to_pb_timestamp(now - 2 * delta)
+
+        ref_string = self._dummy_ref_string()
+        document_pb = document_pb2.Document(
+            name=ref_string,
+            fields={
+                "foo": document_pb2.Value(double_value=1.5),
+                "bar": document_pb2.Value(string_value=u"skillz"),
+            },
+            create_time=create_time,
+            update_time=update_time,
+        )
+        response_pb = _make_batch_response(found=document_pb, read_time=read_time)
+
+        reference_map = {ref_string: mock.sentinel.reference}
+        snapshot = self._call_fut(response_pb, reference_map)
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        self.assertIs(snapshot._reference, mock.sentinel.reference)
+        self.assertEqual(snapshot._data, {"foo": 1.5, "bar": u"skillz"})
+        self.assertTrue(snapshot._exists)
+        self.assertEqual(snapshot.read_time, read_time)
+        self.assertEqual(snapshot.create_time, create_time)
+        self.assertEqual(snapshot.update_time, update_time)
+
+    def test_missing(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        ref_string = self._dummy_ref_string()
+        response_pb = _make_batch_response(missing=ref_string)
+        document = DocumentReference("fizz", "bazz", client=mock.sentinel.client)
+        reference_map = {ref_string: document}
+        snapshot = self._call_fut(response_pb, reference_map)
+        self.assertFalse(snapshot.exists)
+        self.assertEqual(snapshot.id, "bazz")
+        self.assertIsNone(snapshot._data)
+
+    def test_unset_result_type(self):
+        response_pb = _make_batch_response()
+        with self.assertRaises(ValueError):
+            self._call_fut(response_pb, {})
+
+    def test_unknown_result_type(self):
+        response_pb = mock.Mock(spec=["WhichOneof"])
+        response_pb.WhichOneof.return_value = "zoob_value"
+
+        with self.assertRaises(ValueError):
+            self._call_fut(response_pb, {})
+
+        response_pb.WhichOneof.assert_called_once_with("result")
+
+
+class Test__get_doc_mask(unittest.TestCase):
+    @staticmethod
+    def _call_fut(field_paths):
+        from google.cloud.firestore_v1.client import _get_doc_mask
+
+        return _get_doc_mask(field_paths)
+
+    def test_none(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_paths(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        field_paths = ["a.b", "c"]
+        result = self._call_fut(field_paths)
+        expected = common_pb2.DocumentMask(field_paths=field_paths)
+        self.assertEqual(result, expected)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_batch_response(**kwargs):
+    from google.cloud.firestore_v1.proto import firestore_pb2
+
+    return firestore_pb2.BatchGetDocumentsResponse(**kwargs)
+
+
+def _doc_get_info(ref_string, values):
+    from google.cloud.firestore_v1.proto import document_pb2
+    from google.cloud._helpers import _datetime_to_pb_timestamp
+    from google.cloud.firestore_v1 import _helpers
+
+    now = datetime.datetime.utcnow()
+    read_time = _datetime_to_pb_timestamp(now)
+    delta = datetime.timedelta(seconds=100)
+    update_time = _datetime_to_pb_timestamp(now - delta)
+    create_time = _datetime_to_pb_timestamp(now - 2 * delta)
+
+    document_pb = document_pb2.Document(
+        name=ref_string,
+        fields=_helpers.encode_dict(values),
+        create_time=create_time,
+        update_time=update_time,
+    )
+
+    return document_pb, read_time
diff --git a/firestore/tests/unit/v1/test_collection.py b/firestore/tests/unit/v1/test_collection.py
new file mode 100644
index 000000000000..213b32e13a85
--- /dev/null
+++ b/firestore/tests/unit/v1/test_collection.py
@@ -0,0 +1,589 @@
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import types
+import unittest
+
+import mock
+import six
+
+
+class TestCollectionReference(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.collection import CollectionReference
+
+        return CollectionReference
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    @staticmethod
+    def _get_public_methods(klass):
+        return set(
+            name
+            for name, value in six.iteritems(klass.__dict__)
+            if (not name.startswith("_") and isinstance(value, types.FunctionType))
+        )
+
+    def test_query_method_matching(self):
+        from google.cloud.firestore_v1.query import Query
+
+        query_methods = self._get_public_methods(Query)
+        klass = self._get_target_class()
+        collection_methods = self._get_public_methods(klass)
+        # Make sure every query method is present on
+        # ``CollectionReference``.
+        self.assertLessEqual(query_methods, collection_methods)
+
+    def test_constructor(self):
+        collection_id1 = "rooms"
+        document_id = "roomA"
+        collection_id2 = "messages"
+        client = mock.sentinel.client
+
+        collection = self._make_one(
+            collection_id1, document_id, collection_id2, client=client
+        )
+        self.assertIs(collection._client, client)
+        expected_path = (collection_id1, document_id, collection_id2)
+        self.assertEqual(collection._path, expected_path)
+
+    def test_constructor_invalid_path(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+        with self.assertRaises(ValueError):
+            self._make_one(99, "doc", "bad-collection-id")
+        with self.assertRaises(ValueError):
+            self._make_one("bad-document-ID", None, "sub-collection")
+        with self.assertRaises(ValueError):
+            self._make_one("Just", "A-Document")
+
+    def test_constructor_invalid_kwarg(self):
+        with self.assertRaises(TypeError):
+            self._make_one("Coh-lek-shun", donut=True)
+
+    def test___eq___other_type(self):
+        client = mock.sentinel.client
+        collection = self._make_one("name", client=client)
+        other = object()
+        self.assertFalse(collection == other)
+
+    def test___eq___different_path_same_client(self):
+        client = mock.sentinel.client
+        collection = self._make_one("name", client=client)
+        other = self._make_one("other", client=client)
+        self.assertFalse(collection == other)
+
+    def test___eq___same_path_different_client(self):
+        client = mock.sentinel.client
+        other_client = mock.sentinel.other_client
+        collection = self._make_one("name", client=client)
+        other = self._make_one("name", client=other_client)
+        self.assertFalse(collection == other)
+
+    def test___eq___same_path_same_client(self):
+        client = mock.sentinel.client
+        collection = self._make_one("name", client=client)
+        other = self._make_one("name", client=client)
+        self.assertTrue(collection == other)
+
+    def test_id_property(self):
+        collection_id = "hi-bob"
+        collection = self._make_one(collection_id)
+        self.assertEqual(collection.id, collection_id)
+
+    def test_parent_property(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        collection_id1 = "grocery-store"
+        document_id = "market"
+        collection_id2 = "darth"
+        client = _make_client()
+        collection = self._make_one(
+            collection_id1, document_id, collection_id2, client=client
+        )
+
+        parent = collection.parent
+        self.assertIsInstance(parent, DocumentReference)
+        self.assertIs(parent._client, client)
+        self.assertEqual(parent._path, (collection_id1, document_id))
+
+    def test_parent_property_top_level(self):
+        collection = self._make_one("tahp-leh-vull")
+        self.assertIsNone(collection.parent)
+
+    def test_document_factory_explicit_id(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        collection_id = "grocery-store"
+        document_id = "market"
+        client = _make_client()
+        collection = self._make_one(collection_id, client=client)
+
+        child = collection.document(document_id)
+        self.assertIsInstance(child, DocumentReference)
+        self.assertIs(child._client, client)
+        self.assertEqual(child._path, (collection_id, document_id))
+
+    @mock.patch(
+        "google.cloud.firestore_v1.collection._auto_id",
+        return_value="zorpzorpthreezorp012",
+    )
+    def test_document_factory_auto_id(self, mock_auto_id):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        collection_name = "space-town"
+        client = _make_client()
+        collection = self._make_one(collection_name, client=client)
+
+        child = collection.document()
+        self.assertIsInstance(child, DocumentReference)
+        self.assertIs(child._client, client)
+        self.assertEqual(child._path, (collection_name, mock_auto_id.return_value))
+
+        mock_auto_id.assert_called_once_with()
+
+    def test__parent_info_top_level(self):
+        client = _make_client()
+        collection_id = "soap"
+        collection = self._make_one(collection_id, client=client)
+
+        parent_path, expected_prefix = collection._parent_info()
+
+        expected_path = "projects/{}/databases/{}/documents".format(
+            client.project, client._database
+        )
+        self.assertEqual(parent_path, expected_path)
+        prefix = "{}/{}".format(expected_path, collection_id)
+        self.assertEqual(expected_prefix, prefix)
+
+    def test__parent_info_nested(self):
+        collection_id1 = "bar"
+        document_id = "baz"
+        collection_id2 = "chunk"
+        client = _make_client()
+        collection = self._make_one(
+            collection_id1, document_id, collection_id2, client=client
+        )
+
+        parent_path, expected_prefix = collection._parent_info()
+
+        expected_path = "projects/{}/databases/{}/documents/{}/{}".format(
+            client.project, client._database, collection_id1, document_id
+        )
+        self.assertEqual(parent_path, expected_path)
+        prefix = "{}/{}".format(expected_path, collection_id2)
+        self.assertEqual(expected_prefix, prefix)
+
+    def test_add_auto_assigned(self):
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.document import DocumentReference
+        from google.cloud.firestore_v1 import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1._helpers import pbs_for_set_no_merge
+
+        # Create a minimal fake GAPIC add attach it to a real client.
+        firestore_api = mock.Mock(spec=["create_document", "commit"])
+        write_result = mock.Mock(
+            update_time=mock.sentinel.update_time, spec=["update_time"]
+        )
+        commit_response = mock.Mock(
+            write_results=[write_result],
+            spec=["write_results", "commit_time"],
+            commit_time=mock.sentinel.commit_time,
+        )
+        firestore_api.commit.return_value = commit_response
+        create_doc_response = document_pb2.Document()
+        firestore_api.create_document.return_value = create_doc_response
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a collection.
+        collection = self._make_one("grand-parent", "parent", "child", client=client)
+
+        # Add a dummy response for the fake GAPIC.
+        parent_path = collection.parent._document_path
+        auto_assigned_id = "cheezburger"
+        name = "{}/{}/{}".format(parent_path, collection.id, auto_assigned_id)
+        create_doc_response = document_pb2.Document(name=name)
+        create_doc_response.update_time.FromDatetime(datetime.datetime.utcnow())
+        firestore_api.create_document.return_value = create_doc_response
+
+        # Actually call add() on our collection; include a transform to make
+        # sure transforms during adds work.
+        document_data = {"been": "here", "now": SERVER_TIMESTAMP}
+        update_time, document_ref = collection.add(document_data)
+
+        # Verify the response and the mocks.
+        self.assertIs(update_time, mock.sentinel.update_time)
+        self.assertIsInstance(document_ref, DocumentReference)
+        self.assertIs(document_ref._client, client)
+        expected_path = collection._path + (auto_assigned_id,)
+        self.assertEqual(document_ref._path, expected_path)
+
+        expected_document_pb = document_pb2.Document()
+        firestore_api.create_document.assert_called_once_with(
+            parent_path,
+            collection_id=collection.id,
+            document_id=None,
+            document=expected_document_pb,
+            mask=None,
+            metadata=client._rpc_metadata,
+        )
+        write_pbs = pbs_for_set_no_merge(document_ref._document_path, document_data)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    @staticmethod
+    def _write_pb_for_create(document_path, document_data):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1 import _helpers
+
+        return write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(document_data)
+            ),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+
+    def test_add_explicit_id(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        write_result = mock.Mock(
+            update_time=mock.sentinel.update_time, spec=["update_time"]
+        )
+        commit_response = mock.Mock(
+            write_results=[write_result],
+            spec=["write_results", "commit_time"],
+            commit_time=mock.sentinel.commit_time,
+        )
+        firestore_api.commit.return_value = commit_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a collection and call add().
+        collection = self._make_one("parent", client=client)
+        document_data = {"zorp": 208.75, "i-did-not": b"know that"}
+        doc_id = "child"
+        update_time, document_ref = collection.add(document_data, document_id=doc_id)
+
+        # Verify the response and the mocks.
+        self.assertIs(update_time, mock.sentinel.update_time)
+        self.assertIsInstance(document_ref, DocumentReference)
+        self.assertIs(document_ref._client, client)
+        self.assertEqual(document_ref._path, (collection.id, doc_id))
+
+        write_pb = self._write_pb_for_create(document_ref._document_path, document_data)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_select(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        field_paths = ["a", "b"]
+        query = collection.select(field_paths)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        projection_paths = [
+            field_ref.field_path for field_ref in query._projection.fields
+        ]
+        self.assertEqual(projection_paths, field_paths)
+
+    @staticmethod
+    def _make_field_filter_pb(field_path, op_string, value):
+        from google.cloud.firestore_v1.proto import query_pb2
+        from google.cloud.firestore_v1 import _helpers
+        from google.cloud.firestore_v1.query import _enum_from_op_string
+
+        return query_pb2.StructuredQuery.FieldFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            op=_enum_from_op_string(op_string),
+            value=_helpers.encode_value(value),
+        )
+
+    def test_where(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        field_path = "foo"
+        op_string = "=="
+        value = 45
+        query = collection.where(field_path, op_string, value)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(len(query._field_filters), 1)
+        field_filter_pb = query._field_filters[0]
+        self.assertEqual(
+            field_filter_pb, self._make_field_filter_pb(field_path, op_string, value)
+        )
+
+    @staticmethod
+    def _make_order_pb(field_path, direction):
+        from google.cloud.firestore_v1.proto import query_pb2
+        from google.cloud.firestore_v1.query import _enum_from_direction
+
+        return query_pb2.StructuredQuery.Order(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            direction=_enum_from_direction(direction),
+        )
+
+    def test_order_by(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        field_path = "foo"
+        direction = Query.DESCENDING
+        query = collection.order_by(field_path, direction=direction)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(len(query._orders), 1)
+        order_pb = query._orders[0]
+        self.assertEqual(order_pb, self._make_order_pb(field_path, direction))
+
+    def test_limit(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        limit = 15
+        query = collection.limit(limit)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._limit, limit)
+
+    def test_offset(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        offset = 113
+        query = collection.offset(offset)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._offset, offset)
+
+    def test_start_at(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"a": "b"}
+        query = collection.start_at(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._start_at, (doc_fields, True))
+
+    def test_start_after(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"d": "foo", "e": 10}
+        query = collection.start_after(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._start_at, (doc_fields, False))
+
+    def test_end_before(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"bar": 10.5}
+        query = collection.end_before(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._end_at, (doc_fields, True))
+
+    def test_end_at(self):
+        from google.cloud.firestore_v1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"opportunity": True, "reason": 9}
+        query = collection.end_at(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._end_at, (doc_fields, False))
+
+    def _list_documents_helper(self, page_size=None):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.firestore_v1.document import DocumentReference
+        from google.cloud.firestore_v1.gapic.firestore_client import FirestoreClient
+        from google.cloud.firestore_v1.proto.document_pb2 import Document
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        client = _make_client()
+        template = client._database_string + "/documents/{}"
+        document_ids = ["doc-1", "doc-2"]
+        documents = [
+            Document(name=template.format(document_id)) for document_id in document_ids
+        ]
+        iterator = _Iterator(pages=[documents])
+        api_client = mock.create_autospec(FirestoreClient)
+        api_client.list_documents.return_value = iterator
+        client._firestore_api_internal = api_client
+        collection = self._make_one("collection", client=client)
+
+        if page_size is not None:
+            documents = list(collection.list_documents(page_size=page_size))
+        else:
+            documents = list(collection.list_documents())
+
+        # Verify the response and the mocks.
+        self.assertEqual(len(documents), len(document_ids))
+        for document, document_id in zip(documents, document_ids):
+            self.assertIsInstance(document, DocumentReference)
+            self.assertEqual(document.parent, collection)
+            self.assertEqual(document.id, document_id)
+
+        parent, _ = collection._parent_info()
+        api_client.list_documents.assert_called_once_with(
+            parent,
+            collection.id,
+            page_size=page_size,
+            show_missing=True,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_list_documents_wo_page_size(self):
+        self._list_documents_helper()
+
+    def test_list_documents_w_page_size(self):
+        self._list_documents_helper(page_size=25)
+
+    @mock.patch("google.cloud.firestore_v1.query.Query", autospec=True)
+    def test_get(self, query_class):
+        import warnings
+
+        collection = self._make_one("collection")
+        with warnings.catch_warnings(record=True) as warned:
+            get_response = collection.get()
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(get_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=None)
+
+        # Verify the deprecation
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+    @mock.patch("google.cloud.firestore_v1.query.Query", autospec=True)
+    def test_get_with_transaction(self, query_class):
+        import warnings
+
+        collection = self._make_one("collection")
+        transaction = mock.sentinel.txn
+        with warnings.catch_warnings(record=True) as warned:
+            get_response = collection.get(transaction=transaction)
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(get_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=transaction)
+
+        # Verify the deprecation
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+    @mock.patch("google.cloud.firestore_v1.query.Query", autospec=True)
+    def test_stream(self, query_class):
+        collection = self._make_one("collection")
+        stream_response = collection.stream()
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(stream_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=None)
+
+    @mock.patch("google.cloud.firestore_v1.query.Query", autospec=True)
+    def test_stream_with_transaction(self, query_class):
+        collection = self._make_one("collection")
+        transaction = mock.sentinel.txn
+        stream_response = collection.stream(transaction=transaction)
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(stream_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=transaction)
+
+    @mock.patch("google.cloud.firestore_v1.collection.Watch", autospec=True)
+    def test_on_snapshot(self, watch):
+        collection = self._make_one("collection")
+        collection.on_snapshot(None)
+        watch.for_query.assert_called_once()
+
+
+class Test__auto_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut():
+        from google.cloud.firestore_v1.collection import _auto_id
+
+        return _auto_id()
+
+    @mock.patch("random.choice")
+    def test_it(self, mock_rand_choice):
+        from google.cloud.firestore_v1.collection import _AUTO_ID_CHARS
+
+        mock_result = "0123456789abcdefghij"
+        mock_rand_choice.side_effect = list(mock_result)
+        result = self._call_fut()
+        self.assertEqual(result, mock_result)
+
+        mock_calls = [mock.call(_AUTO_ID_CHARS)] * 20
+        self.assertEqual(mock_rand_choice.mock_calls, mock_calls)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client():
+    from google.cloud.firestore_v1.client import Client
+
+    credentials = _make_credentials()
+    return Client(project="project-project", credentials=credentials)
diff --git a/firestore/tests/unit/v1/test_cross_language.py b/firestore/tests/unit/v1/test_cross_language.py
new file mode 100644
index 000000000000..3e0983cd411d
--- /dev/null
+++ b/firestore/tests/unit/v1/test_cross_language.py
@@ -0,0 +1,521 @@
+# Copyright 2017 Google LLC 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.
+
+import functools
+import glob
+import json
+import os
+
+import mock
+import pytest
+
+from google.protobuf import json_format
+from google.cloud.firestore_v1.proto import document_pb2
+from google.cloud.firestore_v1.proto import firestore_pb2
+from google.cloud.firestore_v1.proto import tests_pb2
+from google.cloud.firestore_v1.proto import write_pb2
+
+
+def _load_test_json(filename):
+    with open(filename, "r") as tp_file:
+        tp_json = json.load(tp_file)
+    test_file = tests_pb2.TestFile()
+    json_format.ParseDict(tp_json, test_file)
+    shortname = os.path.split(filename)[-1]
+    for test_proto in test_file.tests:
+        test_proto.description = test_proto.description + " (%s)" % shortname
+        yield test_proto
+
+
+_here = os.path.dirname(__file__)
+_glob_expr = "{}/testdata/*.json".format(_here)
+_globs = glob.glob(_glob_expr)
+ALL_TESTPROTOS = []
+for filename in sorted(_globs):
+    ALL_TESTPROTOS.extend(_load_test_json(filename))
+
+_CREATE_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "create"
+]
+
+_GET_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "get"
+]
+
+_SET_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "set"
+]
+
+_UPDATE_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "update"
+]
+
+_UPDATE_PATHS_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "update_paths"
+]
+
+_DELETE_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "delete"
+]
+
+_LISTEN_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "listen"
+]
+
+_QUERY_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "query"
+]
+
+
+def _mock_firestore_api():
+    firestore_api = mock.Mock(spec=["commit"])
+    commit_response = firestore_pb2.CommitResponse(
+        write_results=[write_pb2.WriteResult()]
+    )
+    firestore_api.commit.return_value = commit_response
+    return firestore_api
+
+
+def _make_client_document(firestore_api, testcase):
+    from google.cloud.firestore_v1 import Client
+    from google.cloud.firestore_v1.client import DEFAULT_DATABASE
+    import google.auth.credentials
+
+    _, project, _, database, _, doc_path = testcase.doc_ref_path.split("/", 5)
+    assert database == DEFAULT_DATABASE
+
+    # Attach the fake GAPIC to a real client.
+    credentials = mock.Mock(spec=google.auth.credentials.Credentials)
+    client = Client(project=project, credentials=credentials)
+    client._firestore_api_internal = firestore_api
+    return client, client.document(doc_path)
+
+
+def _run_testcase(testcase, call, firestore_api, client):
+    if getattr(testcase, "is_error", False):
+        # TODO: is there a subclass of Exception we can check for?
+        with pytest.raises(Exception):
+            call()
+    else:
+        call()
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            list(testcase.request.writes),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+
+@pytest.mark.parametrize("test_proto", _CREATE_TESTPROTOS)
+def test_create_testprotos(test_proto):
+    testcase = test_proto.create
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    data = convert_data(json.loads(testcase.json_data))
+    call = functools.partial(document.create, data)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.parametrize("test_proto", _GET_TESTPROTOS)
+def test_get_testprotos(test_proto):
+    testcase = test_proto.get
+    firestore_api = mock.Mock(spec=["get_document"])
+    response = document_pb2.Document()
+    firestore_api.get_document.return_value = response
+    client, document = _make_client_document(firestore_api, testcase)
+
+    document.get()  # No '.textprotos' for errors, field_paths.
+
+    firestore_api.get_document.assert_called_once_with(
+        document._document_path,
+        mask=None,
+        transaction=None,
+        metadata=client._rpc_metadata,
+    )
+
+
+@pytest.mark.parametrize("test_proto", _SET_TESTPROTOS)
+def test_set_testprotos(test_proto):
+    testcase = test_proto.set
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    data = convert_data(json.loads(testcase.json_data))
+    if testcase.HasField("option"):
+        merge = convert_set_option(testcase.option)
+    else:
+        merge = False
+    call = functools.partial(document.set, data, merge=merge)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.parametrize("test_proto", _UPDATE_TESTPROTOS)
+def test_update_testprotos(test_proto):
+    testcase = test_proto.update
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    data = convert_data(json.loads(testcase.json_data))
+    if testcase.HasField("precondition"):
+        option = convert_precondition(testcase.precondition)
+    else:
+        option = None
+    call = functools.partial(document.update, data, option)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.skip(reason="Python has no way to call update with a list of field paths.")
+@pytest.mark.parametrize("test_proto", _UPDATE_PATHS_TESTPROTOS)
+def test_update_paths_testprotos(test_proto):  # pragma: NO COVER
+    pass
+
+
+@pytest.mark.parametrize("test_proto", _DELETE_TESTPROTOS)
+def test_delete_testprotos(test_proto):
+    testcase = test_proto.delete
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    if testcase.HasField("precondition"):
+        option = convert_precondition(testcase.precondition)
+    else:
+        option = None
+    call = functools.partial(document.delete, option)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.parametrize("test_proto", _LISTEN_TESTPROTOS)
+def test_listen_testprotos(test_proto):  # pragma: NO COVER
+    # test_proto.listen has 'reponses' messages,
+    # 'google.firestore_v1.ListenResponse'
+    # and then an expected list of 'snapshots' (local 'Snapshot'), containing
+    # 'docs' (list of 'google.firestore_v1.Document'),
+    # 'changes' (list lof local 'DocChange', and 'read_time' timestamp.
+    from google.cloud.firestore_v1 import Client
+    from google.cloud.firestore_v1 import DocumentReference
+    from google.cloud.firestore_v1 import DocumentSnapshot
+    from google.cloud.firestore_v1 import Watch
+    import google.auth.credentials
+
+    testcase = test_proto.listen
+    testname = test_proto.description
+
+    credentials = mock.Mock(spec=google.auth.credentials.Credentials)
+    client = Client(project="project", credentials=credentials)
+    modulename = "google.cloud.firestore_v1.watch"
+    with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+        with mock.patch(
+            "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+        ):
+            with mock.patch(  # conformance data sets WATCH_TARGET_ID to 1
+                "%s.WATCH_TARGET_ID" % modulename, 1
+            ):
+                snapshots = []
+
+                def callback(keys, applied_changes, read_time):
+                    snapshots.append((keys, applied_changes, read_time))
+
+                collection = DummyCollection(client=client)
+                query = DummyQuery(parent=collection)
+                watch = Watch.for_query(
+                    query, callback, DocumentSnapshot, DocumentReference
+                )
+                # conformance data has db string as this
+                db_str = "projects/projectID/databases/(default)"
+                watch._firestore._database_string_internal = db_str
+
+                if testcase.is_error:
+                    try:
+                        for proto in testcase.responses:
+                            watch.on_snapshot(proto)
+                    except RuntimeError:
+                        # listen-target-add-wrong-id.textpro
+                        # listen-target-remove.textpro
+                        pass
+
+                else:
+                    for proto in testcase.responses:
+                        watch.on_snapshot(proto)
+
+                    assert len(snapshots) == len(testcase.snapshots)
+                    for i, (expected_snapshot, actual_snapshot) in enumerate(
+                        zip(testcase.snapshots, snapshots)
+                    ):
+                        expected_changes = expected_snapshot.changes
+                        actual_changes = actual_snapshot[1]
+                        if len(expected_changes) != len(actual_changes):
+                            raise AssertionError(
+                                "change length mismatch in %s (snapshot #%s)"
+                                % (testname, i)
+                            )
+                        for y, (expected_change, actual_change) in enumerate(
+                            zip(expected_changes, actual_changes)
+                        ):
+                            expected_change_kind = expected_change.kind
+                            actual_change_kind = actual_change.type.value
+                            if expected_change_kind != actual_change_kind:
+                                raise AssertionError(
+                                    "change type mismatch in %s (snapshot #%s, change #%s')"
+                                    % (testname, i, y)
+                                )
+
+
+@pytest.mark.parametrize("test_proto", _QUERY_TESTPROTOS)
+def test_query_testprotos(test_proto):  # pragma: NO COVER
+    testcase = test_proto.query
+    if testcase.is_error:
+        with pytest.raises(Exception):
+            query = parse_query(testcase)
+            query._to_protobuf()
+    else:
+        query = parse_query(testcase)
+        found = query._to_protobuf()
+        assert found == testcase.query
+
+
+def convert_data(v):
+    # Replace the strings 'ServerTimestamp' and 'Delete' with the corresponding
+    # sentinels.
+    from google.cloud.firestore_v1 import ArrayRemove
+    from google.cloud.firestore_v1 import ArrayUnion
+    from google.cloud.firestore_v1 import DELETE_FIELD
+    from google.cloud.firestore_v1 import SERVER_TIMESTAMP
+
+    if v == "ServerTimestamp":
+        return SERVER_TIMESTAMP
+    elif v == "Delete":
+        return DELETE_FIELD
+    elif isinstance(v, list):
+        if v[0] == "ArrayRemove":
+            return ArrayRemove([convert_data(e) for e in v[1:]])
+        if v[0] == "ArrayUnion":
+            return ArrayUnion([convert_data(e) for e in v[1:]])
+        return [convert_data(e) for e in v]
+    elif isinstance(v, dict):
+        return {k: convert_data(v2) for k, v2 in v.items()}
+    elif v == "NaN":
+        return float(v)
+    else:
+        return v
+
+
+def convert_set_option(option):
+    from google.cloud.firestore_v1 import _helpers
+
+    if option.fields:
+        return [
+            _helpers.FieldPath(*field.field).to_api_repr() for field in option.fields
+        ]
+
+    assert option.all
+    return True
+
+
+def convert_precondition(precond):
+    from google.cloud.firestore_v1 import Client
+
+    if precond.HasField("exists"):
+        return Client.write_option(exists=precond.exists)
+
+    assert precond.HasField("update_time")
+    return Client.write_option(last_update_time=precond.update_time)
+
+
+class DummyRpc(object):  # pragma: NO COVER
+    def __init__(
+        self,
+        listen,
+        should_recover,
+        should_terminate=None,
+        initial_request=None,
+        metadata=None,
+    ):
+        self.listen = listen
+        self.initial_request = initial_request
+        self.should_recover = should_recover
+        self.should_terminate = should_terminate
+        self.closed = False
+        self.callbacks = []
+        self._metadata = metadata
+
+    def add_done_callback(self, callback):
+        self.callbacks.append(callback)
+
+    def close(self):
+        self.closed = True
+
+
+class DummyBackgroundConsumer(object):  # pragma: NO COVER
+    started = False
+    stopped = False
+    is_active = True
+
+    def __init__(self, rpc, on_snapshot):
+        self._rpc = rpc
+        self.on_snapshot = on_snapshot
+
+    def start(self):
+        self.started = True
+
+    def stop(self):
+        self.stopped = True
+        self.is_active = False
+
+
+class DummyCollection(object):
+    def __init__(self, client, parent=None):
+        self._client = client
+        self._parent = parent
+
+    def _parent_info(self):
+        return "{}/documents".format(self._client._database_string), None
+
+
+class DummyQuery(object):  # pragma: NO COVER
+    def __init__(self, parent):
+        self._parent = parent
+        self._comparator = lambda x, y: 1
+
+    @property
+    def _client(self):
+        return self._parent._client
+
+    def _to_protobuf(self):
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        query_kwargs = {
+            "select": None,
+            "from": None,
+            "where": None,
+            "order_by": None,
+            "start_at": None,
+            "end_at": None,
+        }
+        return query_pb2.StructuredQuery(**query_kwargs)
+
+
+def parse_query(testcase):
+    # 'query' testcase contains:
+    # - 'coll_path':  collection ref path.
+    # - 'clauses':  array of one or more 'Clause' elements
+    # - 'query': the actual google.firestore_v1.StructuredQuery message
+    #            to be constructed.
+    # - 'is_error' (as other testcases).
+    #
+    # 'Clause' elements are unions of:
+    # - 'select':  [field paths]
+    # - 'where': (field_path, op, json_value)
+    # - 'order_by': (field_path, direction)
+    # - 'offset': int
+    # - 'limit': int
+    # - 'start_at': 'Cursor'
+    # - 'start_after': 'Cursor'
+    # - 'end_at': 'Cursor'
+    # - 'end_before': 'Cursor'
+    #
+    # 'Cursor' contains either:
+    # - 'doc_snapshot': 'DocSnapshot'
+    # - 'json_values': [string]
+    #
+    # 'DocSnapshot' contains:
+    # 'path': str
+    # 'json_data': str
+    from google.auth.credentials import Credentials
+    from google.cloud.firestore_v1 import Client
+    from google.cloud.firestore_v1 import Query
+
+    _directions = {"asc": Query.ASCENDING, "desc": Query.DESCENDING}
+
+    credentials = mock.create_autospec(Credentials)
+    client = Client("projectID", credentials)
+    path = parse_path(testcase.coll_path)
+    collection = client.collection(*path)
+    query = collection
+
+    for clause in testcase.clauses:
+        kind = clause.WhichOneof("clause")
+
+        if kind == "select":
+            field_paths = [
+                ".".join(field_path.field) for field_path in clause.select.fields
+            ]
+            query = query.select(field_paths)
+        elif kind == "where":
+            path = ".".join(clause.where.path.field)
+            value = convert_data(json.loads(clause.where.json_value))
+            query = query.where(path, clause.where.op, value)
+        elif kind == "order_by":
+            path = ".".join(clause.order_by.path.field)
+            direction = clause.order_by.direction
+            direction = _directions.get(direction, direction)
+            query = query.order_by(path, direction=direction)
+        elif kind == "offset":
+            query = query.offset(clause.offset)
+        elif kind == "limit":
+            query = query.limit(clause.limit)
+        elif kind == "start_at":
+            cursor = parse_cursor(clause.start_at, client)
+            query = query.start_at(cursor)
+        elif kind == "start_after":
+            cursor = parse_cursor(clause.start_after, client)
+            query = query.start_after(cursor)
+        elif kind == "end_at":
+            cursor = parse_cursor(clause.end_at, client)
+            query = query.end_at(cursor)
+        elif kind == "end_before":
+            cursor = parse_cursor(clause.end_before, client)
+            query = query.end_before(cursor)
+        else:  # pragma: NO COVER
+            raise ValueError("Unknown query clause: {}".format(kind))
+
+    return query
+
+
+def parse_path(path):
+    _, relative = path.split("documents/")
+    return relative.split("/")
+
+
+def parse_cursor(cursor, client):
+    from google.cloud.firestore_v1 import DocumentReference
+    from google.cloud.firestore_v1 import DocumentSnapshot
+
+    if cursor.HasField("doc_snapshot"):
+        path = parse_path(cursor.doc_snapshot.path)
+        doc_ref = DocumentReference(*path, client=client)
+
+        return DocumentSnapshot(
+            reference=doc_ref,
+            data=json.loads(cursor.doc_snapshot.json_data),
+            exists=True,
+            read_time=None,
+            create_time=None,
+            update_time=None,
+        )
+
+    values = [json.loads(value) for value in cursor.json_values]
+    return convert_data(values)
diff --git a/firestore/tests/unit/v1/test_document.py b/firestore/tests/unit/v1/test_document.py
new file mode 100644
index 000000000000..89a19df674dd
--- /dev/null
+++ b/firestore/tests/unit/v1/test_document.py
@@ -0,0 +1,825 @@
+# Copyright 2017 Google LLC 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.
+
+import collections
+import unittest
+
+import mock
+
+
+class TestDocumentReference(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        return DocumentReference
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        collection_id1 = "users"
+        document_id1 = "alovelace"
+        collection_id2 = "platform"
+        document_id2 = "*nix"
+        client = mock.MagicMock()
+        client.__hash__.return_value = 1234
+
+        document = self._make_one(
+            collection_id1, document_id1, collection_id2, document_id2, client=client
+        )
+        self.assertIs(document._client, client)
+        expected_path = "/".join(
+            (collection_id1, document_id1, collection_id2, document_id2)
+        )
+        self.assertEqual(document.path, expected_path)
+
+    def test_constructor_invalid_path(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+        with self.assertRaises(ValueError):
+            self._make_one(None, "before", "bad-collection-id", "fifteen")
+        with self.assertRaises(ValueError):
+            self._make_one("bad-document-ID", None)
+        with self.assertRaises(ValueError):
+            self._make_one("Just", "A-Collection", "Sub")
+
+    def test_constructor_invalid_kwarg(self):
+        with self.assertRaises(TypeError):
+            self._make_one("Coh-lek-shun", "Dahk-yu-mehnt", burger=18.75)
+
+    def test___copy__(self):
+        client = _make_client("rain")
+        document = self._make_one("a", "b", client=client)
+        # Access the document path so it is copied.
+        doc_path = document._document_path
+        self.assertEqual(doc_path, document._document_path_internal)
+
+        new_document = document.__copy__()
+        self.assertIsNot(new_document, document)
+        self.assertIs(new_document._client, document._client)
+        self.assertEqual(new_document._path, document._path)
+        self.assertEqual(
+            new_document._document_path_internal, document._document_path_internal
+        )
+
+    def test___deepcopy__calls_copy(self):
+        client = mock.sentinel.client
+        document = self._make_one("a", "b", client=client)
+        document.__copy__ = mock.Mock(return_value=mock.sentinel.new_doc, spec=[])
+
+        unused_memo = {}
+        new_document = document.__deepcopy__(unused_memo)
+        self.assertIs(new_document, mock.sentinel.new_doc)
+        document.__copy__.assert_called_once_with()
+
+    def test__eq__same_type(self):
+        document1 = self._make_one("X", "YY", client=mock.sentinel.client)
+        document2 = self._make_one("X", "ZZ", client=mock.sentinel.client)
+        document3 = self._make_one("X", "YY", client=mock.sentinel.client2)
+        document4 = self._make_one("X", "YY", client=mock.sentinel.client)
+
+        pairs = ((document1, document2), (document1, document3), (document2, document3))
+        for candidate1, candidate2 in pairs:
+            # We use == explicitly since assertNotEqual would use !=.
+            equality_val = candidate1 == candidate2
+            self.assertFalse(equality_val)
+
+        # Check the only equal one.
+        self.assertEqual(document1, document4)
+        self.assertIsNot(document1, document4)
+
+    def test__eq__other_type(self):
+        document = self._make_one("X", "YY", client=mock.sentinel.client)
+        other = object()
+        equality_val = document == other
+        self.assertFalse(equality_val)
+        self.assertIs(document.__eq__(other), NotImplemented)
+
+    def test___hash__(self):
+        client = mock.MagicMock()
+        client.__hash__.return_value = 234566789
+        document = self._make_one("X", "YY", client=client)
+        self.assertEqual(hash(document), hash(("X", "YY")) + hash(client))
+
+    def test__ne__same_type(self):
+        document1 = self._make_one("X", "YY", client=mock.sentinel.client)
+        document2 = self._make_one("X", "ZZ", client=mock.sentinel.client)
+        document3 = self._make_one("X", "YY", client=mock.sentinel.client2)
+        document4 = self._make_one("X", "YY", client=mock.sentinel.client)
+
+        self.assertNotEqual(document1, document2)
+        self.assertNotEqual(document1, document3)
+        self.assertNotEqual(document2, document3)
+
+        # We use != explicitly since assertEqual would use ==.
+        inequality_val = document1 != document4
+        self.assertFalse(inequality_val)
+        self.assertIsNot(document1, document4)
+
+    def test__ne__other_type(self):
+        document = self._make_one("X", "YY", client=mock.sentinel.client)
+        other = object()
+        self.assertNotEqual(document, other)
+        self.assertIs(document.__ne__(other), NotImplemented)
+
+    def test__document_path_property(self):
+        project = "hi-its-me-ok-bye"
+        client = _make_client(project=project)
+
+        collection_id = "then"
+        document_id = "090909iii"
+        document = self._make_one(collection_id, document_id, client=client)
+        doc_path = document._document_path
+        expected = "projects/{}/databases/{}/documents/{}/{}".format(
+            project, client._database, collection_id, document_id
+        )
+        self.assertEqual(doc_path, expected)
+        self.assertIs(document._document_path_internal, doc_path)
+
+        # Make sure value is cached.
+        document._document_path_internal = mock.sentinel.cached
+        self.assertIs(document._document_path, mock.sentinel.cached)
+
+    def test__document_path_property_no_client(self):
+        document = self._make_one("hi", "bye")
+        self.assertIsNone(document._client)
+        with self.assertRaises(ValueError):
+            getattr(document, "_document_path")
+
+        self.assertIsNone(document._document_path_internal)
+
+    def test_id_property(self):
+        document_id = "867-5309"
+        document = self._make_one("Co-lek-shun", document_id)
+        self.assertEqual(document.id, document_id)
+
+    def test_parent_property(self):
+        from google.cloud.firestore_v1.collection import CollectionReference
+
+        collection_id = "grocery-store"
+        document_id = "market"
+        client = _make_client()
+        document = self._make_one(collection_id, document_id, client=client)
+
+        parent = document.parent
+        self.assertIsInstance(parent, CollectionReference)
+        self.assertIs(parent._client, client)
+        self.assertEqual(parent._path, (collection_id,))
+
+    def test_collection_factory(self):
+        from google.cloud.firestore_v1.collection import CollectionReference
+
+        collection_id = "grocery-store"
+        document_id = "market"
+        new_collection = "fruits"
+        client = _make_client()
+        document = self._make_one(collection_id, document_id, client=client)
+
+        child = document.collection(new_collection)
+        self.assertIsInstance(child, CollectionReference)
+        self.assertIs(child._client, client)
+        self.assertEqual(child._path, (collection_id, document_id, new_collection))
+
+    @staticmethod
+    def _write_pb_for_create(document_path, document_data):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1 import _helpers
+
+        return write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(document_data)
+            ),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+
+    @staticmethod
+    def _make_commit_repsonse(write_results=None):
+        from google.cloud.firestore_v1.proto import firestore_pb2
+
+        response = mock.create_autospec(firestore_pb2.CommitResponse)
+        response.write_results = write_results or [mock.sentinel.write_result]
+        response.commit_time = mock.sentinel.commit_time
+        return response
+
+    def test_create(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("dignity")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("foo", "twelve", client=client)
+        document_data = {"hello": "goodbye", "count": 99}
+        write_result = document.create(document_data)
+
+        # Verify the response and the mocks.
+        self.assertIs(write_result, mock.sentinel.write_result)
+        write_pb = self._write_pb_for_create(document._document_path, document_data)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_create_empty(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        from google.cloud.firestore_v1.document import DocumentReference
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        firestore_api = mock.Mock(spec=["commit"])
+        document_reference = mock.create_autospec(DocumentReference)
+        snapshot = mock.create_autospec(DocumentSnapshot)
+        snapshot.exists = True
+        document_reference.get.return_value = snapshot
+        firestore_api.commit.return_value = self._make_commit_repsonse(
+            write_results=[document_reference]
+        )
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("dignity")
+        client._firestore_api_internal = firestore_api
+        client.get_all = mock.MagicMock()
+        client.get_all.exists.return_value = True
+
+        # Actually make a document and call create().
+        document = self._make_one("foo", "twelve", client=client)
+        document_data = {}
+        write_result = document.create(document_data)
+        self.assertTrue(write_result.get().exists)
+
+    @staticmethod
+    def _write_pb_for_set(document_path, document_data, merge):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1 import _helpers
+
+        write_pbs = write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(document_data)
+            )
+        )
+        if merge:
+            field_paths = [
+                field_path
+                for field_path, value in _helpers.extract_fields(
+                    document_data, _helpers.FieldPath()
+                )
+            ]
+            field_paths = [
+                field_path.to_api_repr() for field_path in sorted(field_paths)
+            ]
+            mask = common_pb2.DocumentMask(field_paths=sorted(field_paths))
+            write_pbs.update_mask.CopyFrom(mask)
+        return write_pbs
+
+    def _set_helper(self, merge=False, **option_kwargs):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("db-dee-bee")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("User", "Interface", client=client)
+        document_data = {"And": 500, "Now": b"\xba\xaa\xaa \xba\xaa\xaa"}
+        write_result = document.set(document_data, merge)
+
+        # Verify the response and the mocks.
+        self.assertIs(write_result, mock.sentinel.write_result)
+        write_pb = self._write_pb_for_set(document._document_path, document_data, merge)
+
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_set(self):
+        self._set_helper()
+
+    def test_set_merge(self):
+        self._set_helper(merge=True)
+
+    @staticmethod
+    def _write_pb_for_update(document_path, update_values, field_paths):
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+        from google.cloud.firestore_v1 import _helpers
+
+        return write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(update_values)
+            ),
+            update_mask=common_pb2.DocumentMask(field_paths=field_paths),
+            current_document=common_pb2.Precondition(exists=True),
+        )
+
+    def _update_helper(self, **option_kwargs):
+        from google.cloud.firestore_v1.transforms import DELETE_FIELD
+
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("potato-chip")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("baked", "Alaska", client=client)
+        # "Cheat" and use OrderedDict-s so that iteritems() is deterministic.
+        field_updates = collections.OrderedDict(
+            (("hello", 1), ("then.do", False), ("goodbye", DELETE_FIELD))
+        )
+        if option_kwargs:
+            option = client.write_option(**option_kwargs)
+            write_result = document.update(field_updates, option=option)
+        else:
+            option = None
+            write_result = document.update(field_updates)
+
+        # Verify the response and the mocks.
+        self.assertIs(write_result, mock.sentinel.write_result)
+        update_values = {
+            "hello": field_updates["hello"],
+            "then": {"do": field_updates["then.do"]},
+        }
+        field_paths = list(field_updates.keys())
+        write_pb = self._write_pb_for_update(
+            document._document_path, update_values, sorted(field_paths)
+        )
+        if option is not None:
+            option.modify_write(write_pb)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_update_with_exists(self):
+        with self.assertRaises(ValueError):
+            self._update_helper(exists=True)
+
+    def test_update(self):
+        self._update_helper()
+
+    def test_update_with_precondition(self):
+        from google.protobuf import timestamp_pb2
+
+        timestamp = timestamp_pb2.Timestamp(seconds=1058655101, nanos=100022244)
+        self._update_helper(last_update_time=timestamp)
+
+    def test_empty_update(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("potato-chip")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("baked", "Alaska", client=client)
+        # "Cheat" and use OrderedDict-s so that iteritems() is deterministic.
+        field_updates = {}
+        with self.assertRaises(ValueError):
+            document.update(field_updates)
+
+    def _delete_helper(self, **option_kwargs):
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("donut-base")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call delete().
+        document = self._make_one("where", "we-are", client=client)
+        if option_kwargs:
+            option = client.write_option(**option_kwargs)
+            delete_time = document.delete(option=option)
+        else:
+            option = None
+            delete_time = document.delete()
+
+        # Verify the response and the mocks.
+        self.assertIs(delete_time, mock.sentinel.commit_time)
+        write_pb = write_pb2.Write(delete=document._document_path)
+        if option is not None:
+            option.modify_write(write_pb)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_delete(self):
+        self._delete_helper()
+
+    def test_delete_with_option(self):
+        from google.protobuf import timestamp_pb2
+
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=1058655101, nanos=100022244)
+        self._delete_helper(last_update_time=timestamp_pb)
+
+    def _get_helper(self, field_paths=None, use_transaction=False, not_found=False):
+        from google.api_core.exceptions import NotFound
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        # Create a minimal fake GAPIC with a dummy response.
+        create_time = 123
+        update_time = 234
+        firestore_api = mock.Mock(spec=["get_document"])
+        response = mock.create_autospec(document_pb2.Document)
+        response.fields = {}
+        response.create_time = create_time
+        response.update_time = update_time
+
+        if not_found:
+            firestore_api.get_document.side_effect = NotFound("testing")
+        else:
+            firestore_api.get_document.return_value = response
+
+        client = _make_client("donut-base")
+        client._firestore_api_internal = firestore_api
+
+        document = self._make_one("where", "we-are", client=client)
+
+        if use_transaction:
+            transaction = Transaction(client)
+            transaction_id = transaction._id = b"asking-me-2"
+        else:
+            transaction = None
+
+        snapshot = document.get(field_paths=field_paths, transaction=transaction)
+
+        self.assertIs(snapshot.reference, document)
+        if not_found:
+            self.assertIsNone(snapshot._data)
+            self.assertFalse(snapshot.exists)
+            self.assertIsNone(snapshot.read_time)
+            self.assertIsNone(snapshot.create_time)
+            self.assertIsNone(snapshot.update_time)
+        else:
+            self.assertEqual(snapshot.to_dict(), {})
+            self.assertTrue(snapshot.exists)
+            self.assertIsNone(snapshot.read_time)
+            self.assertIs(snapshot.create_time, create_time)
+            self.assertIs(snapshot.update_time, update_time)
+
+        # Verify the request made to the API
+        if field_paths is not None:
+            mask = common_pb2.DocumentMask(field_paths=sorted(field_paths))
+        else:
+            mask = None
+
+        if use_transaction:
+            expected_transaction_id = transaction_id
+        else:
+            expected_transaction_id = None
+
+        firestore_api.get_document.assert_called_once_with(
+            document._document_path,
+            mask=mask,
+            transaction=expected_transaction_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_not_found(self):
+        self._get_helper(not_found=True)
+
+    def test_get_default(self):
+        self._get_helper()
+
+    def test_get_w_string_field_path(self):
+        with self.assertRaises(ValueError):
+            self._get_helper(field_paths="foo")
+
+    def test_get_with_field_path(self):
+        self._get_helper(field_paths=["foo"])
+
+    def test_get_with_multiple_field_paths(self):
+        self._get_helper(field_paths=["foo", "bar.baz"])
+
+    def test_get_with_transaction(self):
+        self._get_helper(use_transaction=True)
+
+    def _collections_helper(self, page_size=None):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.firestore_v1.collection import CollectionReference
+        from google.cloud.firestore_v1.gapic.firestore_client import FirestoreClient
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        collection_ids = ["coll-1", "coll-2"]
+        iterator = _Iterator(pages=[collection_ids])
+        api_client = mock.create_autospec(FirestoreClient)
+        api_client.list_collection_ids.return_value = iterator
+
+        client = _make_client()
+        client._firestore_api_internal = api_client
+
+        # Actually make a document and call delete().
+        document = self._make_one("where", "we-are", client=client)
+        if page_size is not None:
+            collections = list(document.collections(page_size=page_size))
+        else:
+            collections = list(document.collections())
+
+        # Verify the response and the mocks.
+        self.assertEqual(len(collections), len(collection_ids))
+        for collection, collection_id in zip(collections, collection_ids):
+            self.assertIsInstance(collection, CollectionReference)
+            self.assertEqual(collection.parent, document)
+            self.assertEqual(collection.id, collection_id)
+
+        api_client.list_collection_ids.assert_called_once_with(
+            document._document_path, page_size=page_size, metadata=client._rpc_metadata
+        )
+
+    def test_collections_wo_page_size(self):
+        self._collections_helper()
+
+    def test_collections_w_page_size(self):
+        self._collections_helper(page_size=10)
+
+    @mock.patch("google.cloud.firestore_v1.document.Watch", autospec=True)
+    def test_on_snapshot(self, watch):
+        client = mock.Mock(_database_string="sprinklez", spec=["_database_string"])
+        document = self._make_one("yellow", "mellow", client=client)
+        document.on_snapshot(None)
+        watch.for_document.assert_called_once()
+
+
+class TestDocumentSnapshot(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        return DocumentSnapshot
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def _make_reference(self, *args, **kwargs):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        return DocumentReference(*args, **kwargs)
+
+    def _make_w_ref(self, ref_path=("a", "b"), data={}, exists=True):
+        client = mock.sentinel.client
+        reference = self._make_reference(*ref_path, client=client)
+        return self._make_one(
+            reference,
+            data,
+            exists,
+            mock.sentinel.read_time,
+            mock.sentinel.create_time,
+            mock.sentinel.update_time,
+        )
+
+    def test_constructor(self):
+        client = mock.sentinel.client
+        reference = self._make_reference("hi", "bye", client=client)
+        data = {"zoop": 83}
+        snapshot = self._make_one(
+            reference,
+            data,
+            True,
+            mock.sentinel.read_time,
+            mock.sentinel.create_time,
+            mock.sentinel.update_time,
+        )
+        self.assertIs(snapshot._reference, reference)
+        self.assertEqual(snapshot._data, data)
+        self.assertIsNot(snapshot._data, data)  # Make sure copied.
+        self.assertTrue(snapshot._exists)
+        self.assertIs(snapshot.read_time, mock.sentinel.read_time)
+        self.assertIs(snapshot.create_time, mock.sentinel.create_time)
+        self.assertIs(snapshot.update_time, mock.sentinel.update_time)
+
+    def test___eq___other_type(self):
+        snapshot = self._make_w_ref()
+        other = object()
+        self.assertFalse(snapshot == other)
+
+    def test___eq___different_reference_same_data(self):
+        snapshot = self._make_w_ref(("a", "b"))
+        other = self._make_w_ref(("c", "d"))
+        self.assertFalse(snapshot == other)
+
+    def test___eq___same_reference_different_data(self):
+        snapshot = self._make_w_ref(("a", "b"))
+        other = self._make_w_ref(("a", "b"), {"foo": "bar"})
+        self.assertFalse(snapshot == other)
+
+    def test___eq___same_reference_same_data(self):
+        snapshot = self._make_w_ref(("a", "b"), {"foo": "bar"})
+        other = self._make_w_ref(("a", "b"), {"foo": "bar"})
+        self.assertTrue(snapshot == other)
+
+    def test___hash__(self):
+        from google.protobuf import timestamp_pb2
+
+        client = mock.MagicMock()
+        client.__hash__.return_value = 234566789
+        reference = self._make_reference("hi", "bye", client=client)
+        data = {"zoop": 83}
+        update_time = timestamp_pb2.Timestamp(seconds=123456, nanos=123456789)
+        snapshot = self._make_one(
+            reference, data, True, None, mock.sentinel.create_time, update_time
+        )
+        self.assertEqual(
+            hash(snapshot), hash(reference) + hash(123456) + hash(123456789)
+        )
+
+    def test__client_property(self):
+        reference = self._make_reference(
+            "ok", "fine", "now", "fore", client=mock.sentinel.client
+        )
+        snapshot = self._make_one(reference, {}, False, None, None, None)
+        self.assertIs(snapshot._client, mock.sentinel.client)
+
+    def test_exists_property(self):
+        reference = mock.sentinel.reference
+
+        snapshot1 = self._make_one(reference, {}, False, None, None, None)
+        self.assertFalse(snapshot1.exists)
+        snapshot2 = self._make_one(reference, {}, True, None, None, None)
+        self.assertTrue(snapshot2.exists)
+
+    def test_id_property(self):
+        document_id = "around"
+        reference = self._make_reference(
+            "look", document_id, client=mock.sentinel.client
+        )
+        snapshot = self._make_one(reference, {}, True, None, None, None)
+        self.assertEqual(snapshot.id, document_id)
+        self.assertEqual(reference.id, document_id)
+
+    def test_reference_property(self):
+        snapshot = self._make_one(mock.sentinel.reference, {}, True, None, None, None)
+        self.assertIs(snapshot.reference, mock.sentinel.reference)
+
+    def test_get(self):
+        data = {"one": {"bold": "move"}}
+        snapshot = self._make_one(None, data, True, None, None, None)
+
+        first_read = snapshot.get("one")
+        second_read = snapshot.get("one")
+        self.assertEqual(first_read, data.get("one"))
+        self.assertIsNot(first_read, data.get("one"))
+        self.assertEqual(first_read, second_read)
+        self.assertIsNot(first_read, second_read)
+
+        with self.assertRaises(KeyError):
+            snapshot.get("two")
+
+    def test_nonexistent_snapshot(self):
+        snapshot = self._make_one(None, None, False, None, None, None)
+        self.assertIsNone(snapshot.get("one"))
+
+    def test_to_dict(self):
+        data = {"a": 10, "b": ["definitely", "mutable"], "c": {"45": 50}}
+        snapshot = self._make_one(None, data, True, None, None, None)
+        as_dict = snapshot.to_dict()
+        self.assertEqual(as_dict, data)
+        self.assertIsNot(as_dict, data)
+        # Check that the data remains unchanged.
+        as_dict["b"].append("hi")
+        self.assertEqual(data, snapshot.to_dict())
+        self.assertNotEqual(data, as_dict)
+
+    def test_non_existent(self):
+        snapshot = self._make_one(None, None, False, None, None, None)
+        as_dict = snapshot.to_dict()
+        self.assertIsNone(as_dict)
+
+
+class Test__get_document_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(client, path):
+        from google.cloud.firestore_v1.document import _get_document_path
+
+        return _get_document_path(client, path)
+
+    def test_it(self):
+        project = "prah-jekt"
+        client = _make_client(project=project)
+        path = ("Some", "Document", "Child", "Shockument")
+        document_path = self._call_fut(client, path)
+
+        expected = "projects/{}/databases/{}/documents/{}".format(
+            project, client._database, "/".join(path)
+        )
+        self.assertEqual(document_path, expected)
+
+
+class Test__consume_single_get(unittest.TestCase):
+    @staticmethod
+    def _call_fut(response_iterator):
+        from google.cloud.firestore_v1.document import _consume_single_get
+
+        return _consume_single_get(response_iterator)
+
+    def test_success(self):
+        response_iterator = iter([mock.sentinel.result])
+        result = self._call_fut(response_iterator)
+        self.assertIs(result, mock.sentinel.result)
+
+    def test_failure_not_enough(self):
+        response_iterator = iter([])
+        with self.assertRaises(ValueError):
+            self._call_fut(response_iterator)
+
+    def test_failure_too_many(self):
+        response_iterator = iter([None, None])
+        with self.assertRaises(ValueError):
+            self._call_fut(response_iterator)
+
+
+class Test__first_write_result(unittest.TestCase):
+    @staticmethod
+    def _call_fut(write_results):
+        from google.cloud.firestore_v1.document import _first_write_result
+
+        return _first_write_result(write_results)
+
+    def test_success(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        single_result = write_pb2.WriteResult(
+            update_time=timestamp_pb2.Timestamp(seconds=1368767504, nanos=458000123)
+        )
+        write_results = [single_result]
+        result = self._call_fut(write_results)
+        self.assertIs(result, single_result)
+
+    def test_failure_not_enough(self):
+        write_results = []
+        with self.assertRaises(ValueError):
+            self._call_fut(write_results)
+
+    def test_more_than_one(self):
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        result1 = write_pb2.WriteResult()
+        result2 = write_pb2.WriteResult()
+        write_results = [result1, result2]
+        result = self._call_fut(write_results)
+        self.assertIs(result, result1)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="project-project"):
+    from google.cloud.firestore_v1.client import Client
+
+    credentials = _make_credentials()
+    return Client(project=project, credentials=credentials)
diff --git a/firestore/tests/unit/v1/test_field_path.py b/firestore/tests/unit/v1/test_field_path.py
new file mode 100644
index 000000000000..55aefab4c152
--- /dev/null
+++ b/firestore/tests/unit/v1/test_field_path.py
@@ -0,0 +1,500 @@
+# -*- coding: utf-8 -*-
+# 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.
+
+import unittest
+
+import mock
+
+
+class Test__tokenize_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path):
+        from google.cloud.firestore_v1 import field_path
+
+        return field_path._tokenize_field_path(path)
+
+    def _expect(self, path, split_path):
+        self.assertEqual(list(self._call_fut(path)), split_path)
+
+    def test_w_empty(self):
+        self._expect("", [])
+
+    def test_w_single_dot(self):
+        self._expect(".", ["."])
+
+    def test_w_single_simple(self):
+        self._expect("abc", ["abc"])
+
+    def test_w_single_quoted(self):
+        self._expect("`c*de`", ["`c*de`"])
+
+    def test_w_quoted_embedded_dot(self):
+        self._expect("`c*.de`", ["`c*.de`"])
+
+    def test_w_quoted_escaped_backtick(self):
+        self._expect(r"`c*\`de`", [r"`c*\`de`"])
+
+    def test_w_dotted_quoted(self):
+        self._expect("`*`.`~`", ["`*`", ".", "`~`"])
+
+    def test_w_dotted(self):
+        self._expect("a.b.`c*de`", ["a", ".", "b", ".", "`c*de`"])
+
+    def test_w_dotted_escaped(self):
+        self._expect("_0.`1`.`+2`", ["_0", ".", "`1`", ".", "`+2`"])
+
+    def test_w_unconsumed_characters(self):
+        path = "a~b"
+        with self.assertRaises(ValueError):
+            list(self._call_fut(path))
+
+
+class Test_split_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path):
+        from google.cloud.firestore_v1 import field_path
+
+        return field_path.split_field_path(path)
+
+    def test_w_single_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(".")
+
+    def test_w_leading_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(".a.b.c")
+
+    def test_w_trailing_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("a.b.")
+
+    def test_w_missing_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("a`c*de`f")
+
+    def test_w_half_quoted_field(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("`c*de")
+
+    def test_w_empty(self):
+        self.assertEqual(self._call_fut(""), [])
+
+    def test_w_simple_field(self):
+        self.assertEqual(self._call_fut("a"), ["a"])
+
+    def test_w_dotted_field(self):
+        self.assertEqual(self._call_fut("a.b.cde"), ["a", "b", "cde"])
+
+    def test_w_quoted_field(self):
+        self.assertEqual(self._call_fut("a.b.`c*de`"), ["a", "b", "`c*de`"])
+
+    def test_w_quoted_field_escaped_backtick(self):
+        self.assertEqual(self._call_fut(r"`c*\`de`"), [r"`c*\`de`"])
+
+
+class Test_parse_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path):
+        from google.cloud.firestore_v1 import field_path
+
+        return field_path.parse_field_path(path)
+
+    def test_wo_escaped_names(self):
+        self.assertEqual(self._call_fut("a.b.c"), ["a", "b", "c"])
+
+    def test_w_escaped_backtick(self):
+        self.assertEqual(self._call_fut("`a\\`b`.c.d"), ["a`b", "c", "d"])
+
+    def test_w_escaped_backslash(self):
+        self.assertEqual(self._call_fut("`a\\\\b`.c.d"), ["a\\b", "c", "d"])
+
+    def test_w_first_name_escaped_wo_closing_backtick(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("`a\\`b.c.d")
+
+
+class Test_render_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(field_names):
+        from google.cloud.firestore_v1 import field_path
+
+        return field_path.render_field_path(field_names)
+
+    def test_w_empty(self):
+        self.assertEqual(self._call_fut([]), "")
+
+    def test_w_one_simple(self):
+        self.assertEqual(self._call_fut(["a"]), "a")
+
+    def test_w_one_starts_w_digit(self):
+        self.assertEqual(self._call_fut(["0abc"]), "`0abc`")
+
+    def test_w_one_w_non_alphanum(self):
+        self.assertEqual(self._call_fut(["a b c"]), "`a b c`")
+
+    def test_w_one_w_backtick(self):
+        self.assertEqual(self._call_fut(["a`b"]), "`a\\`b`")
+
+    def test_w_one_w_backslash(self):
+        self.assertEqual(self._call_fut(["a\\b"]), "`a\\\\b`")
+
+    def test_multiple(self):
+        self.assertEqual(self._call_fut(["a", "b", "c"]), "a.b.c")
+
+
+class Test_get_nested_value(unittest.TestCase):
+
+    DATA = {
+        "top1": {"middle2": {"bottom3": 20, "bottom4": 22}, "middle5": True},
+        "top6": b"\x00\x01 foo",
+    }
+
+    @staticmethod
+    def _call_fut(path, data):
+        from google.cloud.firestore_v1 import field_path
+
+        return field_path.get_nested_value(path, data)
+
+    def test_simple(self):
+        self.assertIs(self._call_fut("top1", self.DATA), self.DATA["top1"])
+
+    def test_nested(self):
+        self.assertIs(
+            self._call_fut("top1.middle2", self.DATA), self.DATA["top1"]["middle2"]
+        )
+        self.assertIs(
+            self._call_fut("top1.middle2.bottom3", self.DATA),
+            self.DATA["top1"]["middle2"]["bottom3"],
+        )
+
+    def test_missing_top_level(self):
+        from google.cloud.firestore_v1.field_path import _FIELD_PATH_MISSING_TOP
+
+        field_path = "top8"
+        with self.assertRaises(KeyError) as exc_info:
+            self._call_fut(field_path, self.DATA)
+
+        err_msg = _FIELD_PATH_MISSING_TOP.format(field_path)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test_missing_key(self):
+        from google.cloud.firestore_v1.field_path import _FIELD_PATH_MISSING_KEY
+
+        with self.assertRaises(KeyError) as exc_info:
+            self._call_fut("top1.middle2.nope", self.DATA)
+
+        err_msg = _FIELD_PATH_MISSING_KEY.format("nope", "top1.middle2")
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test_bad_type(self):
+        from google.cloud.firestore_v1.field_path import _FIELD_PATH_WRONG_TYPE
+
+        with self.assertRaises(KeyError) as exc_info:
+            self._call_fut("top6.middle7", self.DATA)
+
+        err_msg = _FIELD_PATH_WRONG_TYPE.format("top6", "middle7")
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+
+class TestFieldPath(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1 import field_path
+
+        return field_path.FieldPath
+
+    def _make_one(self, *args):
+        klass = self._get_target_class()
+        return klass(*args)
+
+    def test_ctor_w_none_in_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", None, "b")
+
+    def test_ctor_w_empty_string_in_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", "", "b")
+
+    def test_ctor_w_integer_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", 3, "b")
+
+    def test_ctor_w_list(self):
+        parts = ["a", "b", "c"]
+        with self.assertRaises(ValueError):
+            self._make_one(parts)
+
+    def test_ctor_w_tuple(self):
+        parts = ("a", "b", "c")
+        with self.assertRaises(ValueError):
+            self._make_one(parts)
+
+    def test_ctor_w_iterable_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", ["a"], "b")
+
+    def test_constructor_w_single_part(self):
+        field_path = self._make_one("a")
+        self.assertEqual(field_path.parts, ("a",))
+
+    def test_constructor_w_multiple_parts(self):
+        field_path = self._make_one("a", "b", "c")
+        self.assertEqual(field_path.parts, ("a", "b", "c"))
+
+    def test_ctor_w_invalid_chars_in_part(self):
+        invalid_parts = ("~", "*", "/", "[", "]", ".")
+        for invalid_part in invalid_parts:
+            field_path = self._make_one(invalid_part)
+            self.assertEqual(field_path.parts, (invalid_part,))
+
+    def test_ctor_w_double_dots(self):
+        field_path = self._make_one("a..b")
+        self.assertEqual(field_path.parts, ("a..b",))
+
+    def test_ctor_w_unicode(self):
+        field_path = self._make_one("一", "二", "三")
+        self.assertEqual(field_path.parts, ("一", "二", "三"))
+
+    def test_from_api_repr_w_empty_string(self):
+        api_repr = ""
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(api_repr)
+
+    def test_from_api_repr_w_empty_field_name(self):
+        api_repr = "a..b"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(api_repr)
+
+    def test_from_api_repr_w_invalid_chars(self):
+        invalid_parts = ("~", "*", "/", "[", "]", ".")
+        for invalid_part in invalid_parts:
+            with self.assertRaises(ValueError):
+                self._get_target_class().from_api_repr(invalid_part)
+
+    def test_from_api_repr_w_ascii_single(self):
+        api_repr = "a"
+        field_path = self._get_target_class().from_api_repr(api_repr)
+        self.assertEqual(field_path.parts, ("a",))
+
+    def test_from_api_repr_w_ascii_dotted(self):
+        api_repr = "a.b.c"
+        field_path = self._get_target_class().from_api_repr(api_repr)
+        self.assertEqual(field_path.parts, ("a", "b", "c"))
+
+    def test_from_api_repr_w_non_ascii_dotted_non_quoted(self):
+        api_repr = "a.一"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(api_repr)
+
+    def test_from_api_repr_w_non_ascii_dotted_quoted(self):
+        api_repr = "a.`一`"
+        field_path = self._get_target_class().from_api_repr(api_repr)
+        self.assertEqual(field_path.parts, ("a", "一"))
+
+    def test_from_string_w_empty_string(self):
+        path_string = ""
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_empty_field_name(self):
+        path_string = "a..b"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_leading_dot(self):
+        path_string = ".b.c"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_trailing_dot(self):
+        path_string = "a.b."
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_leading_invalid_chars(self):
+        invalid_paths = ("~", "*", "/", "[", "]")
+        for invalid_path in invalid_paths:
+            field_path = self._get_target_class().from_string(invalid_path)
+            self.assertEqual(field_path.parts, (invalid_path,))
+
+    def test_from_string_w_embedded_invalid_chars(self):
+        invalid_paths = ("a~b", "x*y", "f/g", "h[j", "k]l")
+        for invalid_path in invalid_paths:
+            with self.assertRaises(ValueError):
+                self._get_target_class().from_string(invalid_path)
+
+    def test_from_string_w_ascii_single(self):
+        path_string = "a"
+        field_path = self._get_target_class().from_string(path_string)
+        self.assertEqual(field_path.parts, ("a",))
+
+    def test_from_string_w_ascii_dotted(self):
+        path_string = "a.b.c"
+        field_path = self._get_target_class().from_string(path_string)
+        self.assertEqual(field_path.parts, ("a", "b", "c"))
+
+    def test_from_string_w_non_ascii_dotted(self):
+        path_string = "a.一"
+        field_path = self._get_target_class().from_string(path_string)
+        self.assertEqual(field_path.parts, ("a", "一"))
+
+    def test___hash___w_single_part(self):
+        field_path = self._make_one("a")
+        self.assertEqual(hash(field_path), hash("a"))
+
+    def test___hash___w_multiple_parts(self):
+        field_path = self._make_one("a", "b")
+        self.assertEqual(hash(field_path), hash("a.b"))
+
+    def test___hash___w_escaped_parts(self):
+        field_path = self._make_one("a", "3")
+        self.assertEqual(hash(field_path), hash("a.`3`"))
+
+    def test___eq___w_matching_type(self):
+        field_path = self._make_one("a", "b")
+        string_path = self._get_target_class().from_string("a.b")
+        self.assertEqual(field_path, string_path)
+
+    def test___eq___w_non_matching_type(self):
+        field_path = self._make_one("a", "c")
+        other = mock.Mock()
+        other.parts = "a", "b"
+        self.assertNotEqual(field_path, other)
+
+    def test___lt___w_matching_type(self):
+        field_path = self._make_one("a", "b")
+        string_path = self._get_target_class().from_string("a.c")
+        self.assertTrue(field_path < string_path)
+
+    def test___lt___w_non_matching_type(self):
+        field_path = self._make_one("a", "b")
+        other = object()
+        # Python 2 doesn't raise TypeError here, but Python3 does.
+        self.assertIs(field_path.__lt__(other), NotImplemented)
+
+    def test___add__(self):
+        path1 = "a123", "b456"
+        path2 = "c789", "d012"
+        path3 = "c789.d012"
+        field_path1 = self._make_one(*path1)
+        field_path1_string = self._make_one(*path1)
+        field_path2 = self._make_one(*path2)
+        field_path1 += field_path2
+        field_path1_string += path3
+        field_path2 = field_path2 + self._make_one(*path1)
+        self.assertEqual(field_path1, self._make_one(*(path1 + path2)))
+        self.assertEqual(field_path2, self._make_one(*(path2 + path1)))
+        self.assertEqual(field_path1_string, field_path1)
+        self.assertNotEqual(field_path1, field_path2)
+        with self.assertRaises(TypeError):
+            field_path1 + 305
+
+    def test_to_api_repr_a(self):
+        parts = "a"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "a")
+
+    def test_to_api_repr_backtick(self):
+        parts = "`"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), r"`\``")
+
+    def test_to_api_repr_dot(self):
+        parts = "."
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`.`")
+
+    def test_to_api_repr_slash(self):
+        parts = "\\"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), r"`\\`")
+
+    def test_to_api_repr_double_slash(self):
+        parts = r"\\"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), r"`\\\\`")
+
+    def test_to_api_repr_underscore(self):
+        parts = "_33132"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "_33132")
+
+    def test_to_api_repr_unicode_non_simple(self):
+        parts = "一"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`一`")
+
+    def test_to_api_repr_number_non_simple(self):
+        parts = "03"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`03`")
+
+    def test_to_api_repr_simple_with_dot(self):
+        field_path = self._make_one("a.b")
+        self.assertEqual(field_path.to_api_repr(), "`a.b`")
+
+    def test_to_api_repr_non_simple_with_dot(self):
+        parts = "a.一"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`a.一`")
+
+    def test_to_api_repr_simple(self):
+        parts = "a0332432"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "a0332432")
+
+    def test_to_api_repr_chain(self):
+        parts = "a", "`", "\\", "_3", "03", "a03", "\\\\", "a0332432", "一"
+        field_path = self._make_one(*parts)
+        self.assertEqual(
+            field_path.to_api_repr(), r"a.`\``.`\\`._3.`03`.a03.`\\\\`.a0332432.`一`"
+        )
+
+    def test_eq_or_parent_same(self):
+        field_path = self._make_one("a", "b")
+        other = self._make_one("a", "b")
+        self.assertTrue(field_path.eq_or_parent(other))
+
+    def test_eq_or_parent_prefix(self):
+        field_path = self._make_one("a", "b")
+        other = self._make_one("a", "b", "c")
+        self.assertTrue(field_path.eq_or_parent(other))
+        self.assertTrue(other.eq_or_parent(field_path))
+
+    def test_eq_or_parent_no_prefix(self):
+        field_path = self._make_one("a", "b")
+        other = self._make_one("d", "e", "f")
+        self.assertFalse(field_path.eq_or_parent(other))
+        self.assertFalse(other.eq_or_parent(field_path))
+
+    def test_lineage_empty(self):
+        field_path = self._make_one()
+        expected = set()
+        self.assertEqual(field_path.lineage(), expected)
+
+    def test_lineage_single(self):
+        field_path = self._make_one("a")
+        expected = set()
+        self.assertEqual(field_path.lineage(), expected)
+
+    def test_lineage_nested(self):
+        field_path = self._make_one("a", "b", "c")
+        expected = set([self._make_one("a"), self._make_one("a", "b")])
+        self.assertEqual(field_path.lineage(), expected)
+
+    def test_document_id(self):
+        parts = "__name__"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.document_id(), parts)
diff --git a/firestore/tests/unit/v1/test_order.py b/firestore/tests/unit/v1/test_order.py
new file mode 100644
index 000000000000..c37e2470a3ec
--- /dev/null
+++ b/firestore/tests/unit/v1/test_order.py
@@ -0,0 +1,247 @@
+# -*- coding: utf-8 -*-
+# Copyright 2017 Google LLC 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.
+
+import mock
+import six
+import unittest
+
+from google.cloud.firestore_v1._helpers import encode_value, GeoPoint
+from google.cloud.firestore_v1.order import Order
+from google.cloud.firestore_v1.order import TypeOrder
+
+from google.cloud.firestore_v1.proto import document_pb2
+
+from google.protobuf import timestamp_pb2
+
+
+class TestOrder(unittest.TestCase):
+
+    if six.PY2:
+        assertRaisesRegex = unittest.TestCase.assertRaisesRegexp
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.order import Order
+
+        return Order
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_order(self):
+        # Constants used to represent min/max values of storage types.
+        int_max_value = 2 ** 31 - 1
+        int_min_value = -(2 ** 31)
+        float_min_value = 1.175494351 ** -38
+        float_nan = float("nan")
+        inf = float("inf")
+
+        groups = [None] * 65
+
+        groups[0] = [nullValue()]
+
+        groups[1] = [_boolean_value(False)]
+        groups[2] = [_boolean_value(True)]
+
+        # numbers
+        groups[3] = [_double_value(float_nan), _double_value(float_nan)]
+        groups[4] = [_double_value(-inf)]
+        groups[5] = [_int_value(int_min_value - 1)]
+        groups[6] = [_int_value(int_min_value)]
+        groups[7] = [_double_value(-1.1)]
+        # Integers and Doubles order the same.
+        groups[8] = [_int_value(-1), _double_value(-1.0)]
+        groups[9] = [_double_value(-float_min_value)]
+        # zeros all compare the same.
+        groups[10] = [
+            _int_value(0),
+            _double_value(-0.0),
+            _double_value(0.0),
+            _double_value(+0.0),
+        ]
+        groups[11] = [_double_value(float_min_value)]
+        groups[12] = [_int_value(1), _double_value(1.0)]
+        groups[13] = [_double_value(1.1)]
+        groups[14] = [_int_value(int_max_value)]
+        groups[15] = [_int_value(int_max_value + 1)]
+        groups[16] = [_double_value(inf)]
+
+        groups[17] = [_timestamp_value(123, 0)]
+        groups[18] = [_timestamp_value(123, 123)]
+        groups[19] = [_timestamp_value(345, 0)]
+
+        # strings
+        groups[20] = [_string_value("")]
+        groups[21] = [_string_value("\u0000\ud7ff\ue000\uffff")]
+        groups[22] = [_string_value("(╯°□°）╯︵ ┻━┻")]
+        groups[23] = [_string_value("a")]
+        groups[24] = [_string_value("abc def")]
+        # latin small letter e + combining acute accent + latin small letter b
+        groups[25] = [_string_value("e\u0301b")]
+        groups[26] = [_string_value("æ")]
+        # latin small letter e with acute accent + latin small letter a
+        groups[27] = [_string_value("\u00e9a")]
+
+        # blobs
+        groups[28] = [_blob_value(b"")]
+        groups[29] = [_blob_value(b"\x00")]
+        groups[30] = [_blob_value(b"\x00\x01\x02\x03\x04")]
+        groups[31] = [_blob_value(b"\x00\x01\x02\x04\x03")]
+        groups[32] = [_blob_value(b"\x7f")]
+
+        # resource names
+        groups[33] = [_reference_value("projects/p1/databases/d1/documents/c1/doc1")]
+        groups[34] = [_reference_value("projects/p1/databases/d1/documents/c1/doc2")]
+        groups[35] = [
+            _reference_value("projects/p1/databases/d1/documents/c1/doc2/c2/doc1")
+        ]
+        groups[36] = [
+            _reference_value("projects/p1/databases/d1/documents/c1/doc2/c2/doc2")
+        ]
+        groups[37] = [_reference_value("projects/p1/databases/d1/documents/c10/doc1")]
+        groups[38] = [_reference_value("projects/p1/databases/d1/documents/c2/doc1")]
+        groups[39] = [_reference_value("projects/p2/databases/d2/documents/c1/doc1")]
+        groups[40] = [_reference_value("projects/p2/databases/d2/documents/c1-/doc1")]
+        groups[41] = [_reference_value("projects/p2/databases/d3/documents/c1-/doc1")]
+
+        # geo points
+        groups[42] = [_geoPoint_value(-90, -180)]
+        groups[43] = [_geoPoint_value(-90, 0)]
+        groups[44] = [_geoPoint_value(-90, 180)]
+        groups[45] = [_geoPoint_value(0, -180)]
+        groups[46] = [_geoPoint_value(0, 0)]
+        groups[47] = [_geoPoint_value(0, 180)]
+        groups[48] = [_geoPoint_value(1, -180)]
+        groups[49] = [_geoPoint_value(1, 0)]
+        groups[50] = [_geoPoint_value(1, 180)]
+        groups[51] = [_geoPoint_value(90, -180)]
+        groups[52] = [_geoPoint_value(90, 0)]
+        groups[53] = [_geoPoint_value(90, 180)]
+
+        # arrays
+        groups[54] = [_array_value()]
+        groups[55] = [_array_value(["bar"])]
+        groups[56] = [_array_value(["foo"])]
+        groups[57] = [_array_value(["foo", 0])]
+        groups[58] = [_array_value(["foo", 1])]
+        groups[59] = [_array_value(["foo", "0"])]
+
+        # objects
+        groups[60] = [_object_value({"bar": 0})]
+        groups[61] = [_object_value({"bar": 0, "foo": 1})]
+        groups[62] = [_object_value({"bar": 1})]
+        groups[63] = [_object_value({"bar": 2})]
+        groups[64] = [_object_value({"bar": "0"})]
+
+        target = self._make_one()
+
+        for i in range(len(groups)):
+            for left in groups[i]:
+                for j in range(len(groups)):
+                    for right in groups[j]:
+                        expected = Order._compare_to(i, j)
+
+                        self.assertEqual(
+                            target.compare(left, right),
+                            expected,
+                            "comparing L->R {} ({}) to {} ({})".format(
+                                i, left, j, right
+                            ),
+                        )
+
+                        expected = Order._compare_to(j, i)
+                        self.assertEqual(
+                            target.compare(right, left),
+                            expected,
+                            "comparing R->L {} ({}) to {} ({})".format(
+                                j, right, i, left
+                            ),
+                        )
+
+    def test_typeorder_type_failure(self):
+        target = self._make_one()
+        left = mock.Mock()
+        left.WhichOneof.return_value = "imaginary-type"
+
+        with self.assertRaisesRegex(ValueError, "Could not detect value"):
+            target.compare(left, mock.Mock())
+
+    def test_failure_to_find_type(self):
+        target = self._make_one()
+        left = mock.Mock()
+        left.WhichOneof.return_value = "imaginary-type"
+        right = mock.Mock()
+        # Patch from value to get to the deep compare. Since left is a bad type
+        # expect this to fail with value error.
+        with mock.patch.object(TypeOrder, "from_value") as to:
+            to.value = None
+            with self.assertRaisesRegex(ValueError, "'Unknown ``value_type``"):
+                target.compare(left, right)
+
+    def test_compare_objects_different_keys(self):
+        left = _object_value({"foo": 0})
+        right = _object_value({"bar": 0})
+
+        target = self._make_one()
+        target.compare(left, right)
+
+
+def _boolean_value(b):
+    return encode_value(b)
+
+
+def _double_value(d):
+    return encode_value(d)
+
+
+def _int_value(l):
+    return encode_value(l)
+
+
+def _string_value(s):
+    if not isinstance(s, six.text_type):
+        s = six.u(s)
+    return encode_value(s)
+
+
+def _reference_value(r):
+    return document_pb2.Value(reference_value=r)
+
+
+def _blob_value(b):
+    return encode_value(b)
+
+
+def nullValue():
+    return encode_value(None)
+
+
+def _timestamp_value(seconds, nanos):
+    return document_pb2.Value(
+        timestamp_value=timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
+    )
+
+
+def _geoPoint_value(latitude, longitude):
+    return encode_value(GeoPoint(latitude, longitude))
+
+
+def _array_value(values=[]):
+    return encode_value(values)
+
+
+def _object_value(keysAndValues):
+    return encode_value(keysAndValues)
diff --git a/firestore/tests/unit/v1/test_query.py b/firestore/tests/unit/v1/test_query.py
new file mode 100644
index 000000000000..a4911fecb44f
--- /dev/null
+++ b/firestore/tests/unit/v1/test_query.py
@@ -0,0 +1,1717 @@
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import types
+import unittest
+
+import mock
+import six
+
+
+class TestQuery(unittest.TestCase):
+
+    if six.PY2:
+        assertRaisesRegex = unittest.TestCase.assertRaisesRegexp
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.query import Query
+
+        return Query
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIs(query._parent, mock.sentinel.parent)
+        self.assertIsNone(query._projection)
+        self.assertEqual(query._field_filters, ())
+        self.assertEqual(query._orders, ())
+        self.assertIsNone(query._limit)
+        self.assertIsNone(query._offset)
+        self.assertIsNone(query._start_at)
+        self.assertIsNone(query._end_at)
+        self.assertFalse(query._all_descendants)
+
+    def _make_one_all_fields(
+        self, limit=9876, offset=12, skip_fields=(), parent=None, all_descendants=True
+    ):
+        kwargs = {
+            "projection": mock.sentinel.projection,
+            "field_filters": mock.sentinel.filters,
+            "orders": mock.sentinel.orders,
+            "limit": limit,
+            "offset": offset,
+            "start_at": mock.sentinel.start_at,
+            "end_at": mock.sentinel.end_at,
+            "all_descendants": all_descendants,
+        }
+        for field in skip_fields:
+            kwargs.pop(field)
+        if parent is None:
+            parent = mock.sentinel.parent
+        return self._make_one(parent, **kwargs)
+
+    def test_constructor_explicit(self):
+        limit = 234
+        offset = 56
+        query = self._make_one_all_fields(limit=limit, offset=offset)
+        self.assertIs(query._parent, mock.sentinel.parent)
+        self.assertIs(query._projection, mock.sentinel.projection)
+        self.assertIs(query._field_filters, mock.sentinel.filters)
+        self.assertEqual(query._orders, mock.sentinel.orders)
+        self.assertEqual(query._limit, limit)
+        self.assertEqual(query._offset, offset)
+        self.assertIs(query._start_at, mock.sentinel.start_at)
+        self.assertIs(query._end_at, mock.sentinel.end_at)
+        self.assertTrue(query._all_descendants)
+
+    def test__client_property(self):
+        parent = mock.Mock(_client=mock.sentinel.client, spec=["_client"])
+        query = self._make_one(parent)
+        self.assertIs(query._client, mock.sentinel.client)
+
+    def test___eq___other_type(self):
+        query = self._make_one_all_fields()
+        other = object()
+        self.assertFalse(query == other)
+
+    def test___eq___different_parent(self):
+        parent = mock.sentinel.parent
+        other_parent = mock.sentinel.other_parent
+        query = self._make_one_all_fields(parent=parent)
+        other = self._make_one_all_fields(parent=other_parent)
+        self.assertFalse(query == other)
+
+    def test___eq___different_projection(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, skip_fields=("projection",))
+        query._projection = mock.sentinel.projection
+        other = self._make_one_all_fields(parent=parent, skip_fields=("projection",))
+        other._projection = mock.sentinel.other_projection
+        self.assertFalse(query == other)
+
+    def test___eq___different_field_filters(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, skip_fields=("field_filters",))
+        query._field_filters = mock.sentinel.field_filters
+        other = self._make_one_all_fields(parent=parent, skip_fields=("field_filters",))
+        other._field_filters = mock.sentinel.other_field_filters
+        self.assertFalse(query == other)
+
+    def test___eq___different_orders(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, skip_fields=("orders",))
+        query._orders = mock.sentinel.orders
+        other = self._make_one_all_fields(parent=parent, skip_fields=("orders",))
+        other._orders = mock.sentinel.other_orders
+        self.assertFalse(query == other)
+
+    def test___eq___different_limit(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, limit=10)
+        other = self._make_one_all_fields(parent=parent, limit=20)
+        self.assertFalse(query == other)
+
+    def test___eq___different_offset(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, offset=10)
+        other = self._make_one_all_fields(parent=parent, offset=20)
+        self.assertFalse(query == other)
+
+    def test___eq___different_start_at(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, skip_fields=("start_at",))
+        query._start_at = mock.sentinel.start_at
+        other = self._make_one_all_fields(parent=parent, skip_fields=("start_at",))
+        other._start_at = mock.sentinel.other_start_at
+        self.assertFalse(query == other)
+
+    def test___eq___different_end_at(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, skip_fields=("end_at",))
+        query._end_at = mock.sentinel.end_at
+        other = self._make_one_all_fields(parent=parent, skip_fields=("end_at",))
+        other._end_at = mock.sentinel.other_end_at
+        self.assertFalse(query == other)
+
+    def test___eq___different_all_descendants(self):
+        parent = mock.sentinel.parent
+        query = self._make_one_all_fields(parent=parent, all_descendants=True)
+        other = self._make_one_all_fields(parent=parent, all_descendants=False)
+        self.assertFalse(query == other)
+
+    def test___eq___hit(self):
+        query = self._make_one_all_fields()
+        other = self._make_one_all_fields()
+        self.assertTrue(query == other)
+
+    def _compare_queries(self, query1, query2, attr_name):
+        attrs1 = query1.__dict__.copy()
+        attrs2 = query2.__dict__.copy()
+
+        attrs1.pop(attr_name)
+        attrs2.pop(attr_name)
+
+        # The only different should be in ``attr_name``.
+        self.assertEqual(len(attrs1), len(attrs2))
+        for key, value in attrs1.items():
+            self.assertIs(value, attrs2[key])
+
+    @staticmethod
+    def _make_projection_for_select(field_paths):
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        return query_pb2.StructuredQuery.Projection(
+            fields=[
+                query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                for field_path in field_paths
+            ]
+        )
+
+    def test_select_invalid_path(self):
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query.select(["*"])
+
+    def test_select(self):
+        query1 = self._make_one_all_fields(all_descendants=True)
+
+        field_paths2 = ["foo", "bar"]
+        query2 = query1.select(field_paths2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, self._get_target_class())
+        self.assertEqual(
+            query2._projection, self._make_projection_for_select(field_paths2)
+        )
+        self._compare_queries(query1, query2, "_projection")
+
+        # Make sure it overrides.
+        field_paths3 = ["foo.baz"]
+        query3 = query2.select(field_paths3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(
+            query3._projection, self._make_projection_for_select(field_paths3)
+        )
+        self._compare_queries(query2, query3, "_projection")
+
+    def test_where_invalid_path(self):
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query.where("*", "==", 1)
+
+    def test_where(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        query = self._make_one_all_fields(
+            skip_fields=("field_filters",), all_descendants=True
+        )
+        new_query = query.where("power.level", ">", 9000)
+
+        self.assertIsNot(query, new_query)
+        self.assertIsInstance(new_query, self._get_target_class())
+        self.assertEqual(len(new_query._field_filters), 1)
+
+        field_pb = new_query._field_filters[0]
+        expected_pb = query_pb2.StructuredQuery.FieldFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="power.level"),
+            op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+            value=document_pb2.Value(integer_value=9000),
+        )
+        self.assertEqual(field_pb, expected_pb)
+        self._compare_queries(query, new_query, "_field_filters")
+
+    def _where_unary_helper(self, value, op_enum, op_string="=="):
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        query = self._make_one_all_fields(skip_fields=("field_filters",))
+        field_path = "feeeld"
+        new_query = query.where(field_path, op_string, value)
+
+        self.assertIsNot(query, new_query)
+        self.assertIsInstance(new_query, self._get_target_class())
+        self.assertEqual(len(new_query._field_filters), 1)
+
+        field_pb = new_query._field_filters[0]
+        expected_pb = query_pb2.StructuredQuery.UnaryFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            op=op_enum,
+        )
+        self.assertEqual(field_pb, expected_pb)
+        self._compare_queries(query, new_query, "_field_filters")
+
+    def test_where_eq_null(self):
+        from google.cloud.firestore_v1.gapic import enums
+
+        op_enum = enums.StructuredQuery.UnaryFilter.Operator.IS_NULL
+        self._where_unary_helper(None, op_enum)
+
+    def test_where_gt_null(self):
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(None, 0, op_string=">")
+
+    def test_where_eq_nan(self):
+        from google.cloud.firestore_v1.gapic import enums
+
+        op_enum = enums.StructuredQuery.UnaryFilter.Operator.IS_NAN
+        self._where_unary_helper(float("nan"), op_enum)
+
+    def test_where_le_nan(self):
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(float("nan"), 0, op_string="<=")
+
+    def test_where_w_delete(self):
+        from google.cloud.firestore_v1 import DELETE_FIELD
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(DELETE_FIELD, 0)
+
+    def test_where_w_server_timestamp(self):
+        from google.cloud.firestore_v1 import SERVER_TIMESTAMP
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(SERVER_TIMESTAMP, 0)
+
+    def test_where_w_array_remove(self):
+        from google.cloud.firestore_v1 import ArrayRemove
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(ArrayRemove([1, 3, 5]), 0)
+
+    def test_where_w_array_union(self):
+        from google.cloud.firestore_v1 import ArrayUnion
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(ArrayUnion([2, 4, 8]), 0)
+
+    def test_order_by_invalid_path(self):
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query.order_by("*")
+
+    def test_order_by(self):
+        from google.cloud.firestore_v1.gapic import enums
+
+        klass = self._get_target_class()
+        query1 = self._make_one_all_fields(
+            skip_fields=("orders",), all_descendants=True
+        )
+
+        field_path2 = "a"
+        query2 = query1.order_by(field_path2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, klass)
+        order_pb2 = _make_order_pb(
+            field_path2, enums.StructuredQuery.Direction.ASCENDING
+        )
+        self.assertEqual(query2._orders, (order_pb2,))
+        self._compare_queries(query1, query2, "_orders")
+
+        # Make sure it appends to the orders.
+        field_path3 = "b"
+        query3 = query2.order_by(field_path3, direction=klass.DESCENDING)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, klass)
+        order_pb3 = _make_order_pb(
+            field_path3, enums.StructuredQuery.Direction.DESCENDING
+        )
+        self.assertEqual(query3._orders, (order_pb2, order_pb3))
+        self._compare_queries(query2, query3, "_orders")
+
+    def test_limit(self):
+        query1 = self._make_one_all_fields(all_descendants=True)
+
+        limit2 = 100
+        query2 = query1.limit(limit2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, self._get_target_class())
+        self.assertEqual(query2._limit, limit2)
+        self._compare_queries(query1, query2, "_limit")
+
+        # Make sure it overrides.
+        limit3 = 10
+        query3 = query2.limit(limit3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._limit, limit3)
+        self._compare_queries(query2, query3, "_limit")
+
+    def test_offset(self):
+        query1 = self._make_one_all_fields(all_descendants=True)
+
+        offset2 = 23
+        query2 = query1.offset(offset2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, self._get_target_class())
+        self.assertEqual(query2._offset, offset2)
+        self._compare_queries(query1, query2, "_offset")
+
+        # Make sure it overrides.
+        offset3 = 35
+        query3 = query2.offset(offset3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._offset, offset3)
+        self._compare_queries(query2, query3, "_offset")
+
+    @staticmethod
+    def _make_collection(*path, **kw):
+        from google.cloud.firestore_v1 import collection
+
+        return collection.CollectionReference(*path, **kw)
+
+    @staticmethod
+    def _make_docref(*path, **kw):
+        from google.cloud.firestore_v1 import document
+
+        return document.DocumentReference(*path, **kw)
+
+    @staticmethod
+    def _make_snapshot(docref, values):
+        from google.cloud.firestore_v1 import document
+
+        return document.DocumentSnapshot(docref, values, True, None, None, None)
+
+    def test__cursor_helper_w_dict(self):
+        values = {"a": 7, "b": "foo"}
+        query1 = self._make_one(mock.sentinel.parent)
+        query1._all_descendants = True
+        query2 = query1._cursor_helper(values, True, True)
+
+        self.assertIs(query2._parent, mock.sentinel.parent)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, query1._orders)
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._end_at)
+        self.assertTrue(query2._all_descendants)
+
+        cursor, before = query2._start_at
+
+        self.assertEqual(cursor, values)
+        self.assertTrue(before)
+
+    def test__cursor_helper_w_tuple(self):
+        values = (7, "foo")
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1._cursor_helper(values, False, True)
+
+        self.assertIs(query2._parent, mock.sentinel.parent)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, query1._orders)
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._end_at)
+
+        cursor, before = query2._start_at
+
+        self.assertEqual(cursor, list(values))
+        self.assertFalse(before)
+
+    def test__cursor_helper_w_list(self):
+        values = [7, "foo"]
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1._cursor_helper(values, True, False)
+
+        self.assertIs(query2._parent, mock.sentinel.parent)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, query1._orders)
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._start_at)
+
+        cursor, before = query2._end_at
+
+        self.assertEqual(cursor, values)
+        self.assertIsNot(cursor, values)
+        self.assertTrue(before)
+
+    def test__cursor_helper_w_snapshot_wrong_collection(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("there", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = self._make_one(collection)
+
+        with self.assertRaises(ValueError):
+            query._cursor_helper(snapshot, False, False)
+
+    def test__cursor_helper_w_snapshot_other_collection_all_descendants(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("there", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query1 = self._make_one(collection, all_descendants=True)
+
+        query2 = query1._cursor_helper(snapshot, False, False)
+
+        self.assertIs(query2._parent, collection)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, ())
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._start_at)
+
+        cursor, before = query2._end_at
+
+        self.assertIs(cursor, snapshot)
+        self.assertFalse(before)
+
+    def test__cursor_helper_w_snapshot(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query1 = self._make_one(collection)
+
+        query2 = query1._cursor_helper(snapshot, False, False)
+
+        self.assertIs(query2._parent, collection)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, ())
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._start_at)
+
+        cursor, before = query2._end_at
+
+        self.assertIs(cursor, snapshot)
+        self.assertFalse(before)
+
+    def test_start_at(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(
+            parent=collection, skip_fields=("orders",), all_descendants=True
+        )
+        query2 = query1.order_by("hi")
+
+        document_fields3 = {"hi": "mom"}
+        query3 = query2.start_at(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._start_at, (document_fields3, True))
+        self._compare_queries(query2, query3, "_start_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("bye")
+        values5 = {"hi": "zap", "bye": 88}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.start_at(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._start_at, (document_fields5, True))
+        self._compare_queries(query4, query5, "_start_at")
+
+    def test_start_after(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("down")
+
+        document_fields3 = {"down": 99.75}
+        query3 = query2.start_after(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._start_at, (document_fields3, False))
+        self._compare_queries(query2, query3, "_start_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("out")
+        values5 = {"down": 100.25, "out": b"\x00\x01"}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.start_after(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._start_at, (document_fields5, False))
+        self._compare_queries(query4, query5, "_start_at")
+
+    def test_end_before(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("down")
+
+        document_fields3 = {"down": 99.75}
+        query3 = query2.end_before(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._end_at, (document_fields3, True))
+        self._compare_queries(query2, query3, "_end_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("out")
+        values5 = {"down": 100.25, "out": b"\x00\x01"}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.end_before(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._end_at, (document_fields5, True))
+        self._compare_queries(query4, query5, "_end_at")
+        self._compare_queries(query4, query5, "_end_at")
+
+    def test_end_at(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("hi")
+
+        document_fields3 = {"hi": "mom"}
+        query3 = query2.end_at(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._end_at, (document_fields3, False))
+        self._compare_queries(query2, query3, "_end_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("bye")
+        values5 = {"hi": "zap", "bye": 88}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.end_at(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._end_at, (document_fields5, False))
+        self._compare_queries(query4, query5, "_end_at")
+
+    def test__filters_pb_empty(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertEqual(len(query._field_filters), 0)
+        self.assertIsNone(query._filters_pb())
+
+    def test__filters_pb_single(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1.where("x.y", ">", 50.5)
+        filter_pb = query2._filters_pb()
+        expected_pb = query_pb2.StructuredQuery.Filter(
+            field_filter=query_pb2.StructuredQuery.FieldFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path="x.y"),
+                op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+                value=document_pb2.Value(double_value=50.5),
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test__filters_pb_multi(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1.where("x.y", ">", 50.5)
+        query3 = query2.where("ABC", "==", 123)
+
+        filter_pb = query3._filters_pb()
+        op_class = enums.StructuredQuery.FieldFilter.Operator
+        expected_pb = query_pb2.StructuredQuery.Filter(
+            composite_filter=query_pb2.StructuredQuery.CompositeFilter(
+                op=enums.StructuredQuery.CompositeFilter.Operator.AND,
+                filters=[
+                    query_pb2.StructuredQuery.Filter(
+                        field_filter=query_pb2.StructuredQuery.FieldFilter(
+                            field=query_pb2.StructuredQuery.FieldReference(
+                                field_path="x.y"
+                            ),
+                            op=op_class.GREATER_THAN,
+                            value=document_pb2.Value(double_value=50.5),
+                        )
+                    ),
+                    query_pb2.StructuredQuery.Filter(
+                        field_filter=query_pb2.StructuredQuery.FieldFilter(
+                            field=query_pb2.StructuredQuery.FieldReference(
+                                field_path="ABC"
+                            ),
+                            op=op_class.EQUAL,
+                            value=document_pb2.Value(integer_value=123),
+                        )
+                    ),
+                ],
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test__normalize_projection_none(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIsNone(query._normalize_projection(None))
+
+    def test__normalize_projection_empty(self):
+        projection = self._make_projection_for_select([])
+        query = self._make_one(mock.sentinel.parent)
+        normalized = query._normalize_projection(projection)
+        field_paths = [field_ref.field_path for field_ref in normalized.fields]
+        self.assertEqual(field_paths, ["__name__"])
+
+    def test__normalize_projection_non_empty(self):
+        projection = self._make_projection_for_select(["a", "b"])
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIs(query._normalize_projection(projection), projection)
+
+    def test__normalize_orders_wo_orders_wo_cursors(self):
+        query = self._make_one(mock.sentinel.parent)
+        expected = []
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_w_orders_wo_cursors(self):
+        query = self._make_one(mock.sentinel.parent).order_by("a")
+        expected = [query._make_order("a", "ASCENDING")]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_wo_orders_w_snapshot_cursor(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = self._make_one(collection).start_at(snapshot)
+        expected = [query._make_order("__name__", "ASCENDING")]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_w_name_orders_w_snapshot_cursor(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = (
+            self._make_one(collection)
+            .order_by("__name__", "DESCENDING")
+            .start_at(snapshot)
+        )
+        expected = [query._make_order("__name__", "DESCENDING")]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_wo_orders_w_snapshot_cursor_w_neq_exists(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = (
+            self._make_one(collection)
+            .where("c", "<=", 20)
+            .order_by("c", "DESCENDING")
+            .start_at(snapshot)
+        )
+        expected = [
+            query._make_order("c", "DESCENDING"),
+            query._make_order("__name__", "DESCENDING"),
+        ]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_wo_orders_w_snapshot_cursor_w_neq_where(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = self._make_one(collection).where("c", "<=", 20).end_at(snapshot)
+        expected = [
+            query._make_order("c", "ASCENDING"),
+            query._make_order("__name__", "ASCENDING"),
+        ]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_cursor_none(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIsNone(query._normalize_cursor(None, query._orders))
+
+    def test__normalize_cursor_no_order(self):
+        cursor = ([1], True)
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_as_list_mismatched_order(self):
+        cursor = ([1, 2], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_as_dict_mismatched_order(self):
+        cursor = ({"a": 1}, True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_delete(self):
+        from google.cloud.firestore_v1 import DELETE_FIELD
+
+        cursor = ([DELETE_FIELD], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_server_timestamp(self):
+        from google.cloud.firestore_v1 import SERVER_TIMESTAMP
+
+        cursor = ([SERVER_TIMESTAMP], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_array_remove(self):
+        from google.cloud.firestore_v1 import ArrayRemove
+
+        cursor = ([ArrayRemove([1, 3, 5])], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_array_union(self):
+        from google.cloud.firestore_v1 import ArrayUnion
+
+        cursor = ([ArrayUnion([2, 4, 8])], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_as_list_hit(self):
+        cursor = ([1], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_as_dict_hit(self):
+        cursor = ({"b": 1}, True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_as_dict_with_dot_key_hit(self):
+        cursor = ({"b.a": 1}, True)
+        query = self._make_one(mock.sentinel.parent).order_by("b.a", "ASCENDING")
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_as_dict_with_inner_data_hit(self):
+        cursor = ({"b": {"a": 1}}, True)
+        query = self._make_one(mock.sentinel.parent).order_by("b.a", "ASCENDING")
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_as_snapshot_hit(self):
+        values = {"b": 1}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        cursor = (snapshot, True)
+        collection = self._make_collection("here")
+        query = self._make_one(collection).order_by("b", "ASCENDING")
+
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_w___name___w_reference(self):
+        db_string = "projects/my-project/database/(default)"
+        client = mock.Mock(spec=["_database_string"])
+        client._database_string = db_string
+        parent = mock.Mock(spec=["_path", "_client"])
+        parent._client = client
+        parent._path = ["C"]
+        query = self._make_one(parent).order_by("__name__", "ASCENDING")
+        docref = self._make_docref("here", "doc_id")
+        values = {"a": 7}
+        snapshot = self._make_snapshot(docref, values)
+        expected = docref
+        cursor = (snapshot, True)
+
+        self.assertEqual(
+            query._normalize_cursor(cursor, query._orders), ([expected], True)
+        )
+
+    def test__normalize_cursor_w___name___wo_slash(self):
+        db_string = "projects/my-project/database/(default)"
+        client = mock.Mock(spec=["_database_string"])
+        client._database_string = db_string
+        parent = mock.Mock(spec=["_path", "_client", "document"])
+        parent._client = client
+        parent._path = ["C"]
+        document = parent.document.return_value = mock.Mock(spec=[])
+        query = self._make_one(parent).order_by("__name__", "ASCENDING")
+        cursor = (["b"], True)
+        expected = document
+
+        self.assertEqual(
+            query._normalize_cursor(cursor, query._orders), ([expected], True)
+        )
+        parent.document.assert_called_once_with("b")
+
+    def test__to_protobuf_all_fields(self):
+        from google.protobuf import wrappers_pb2
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="cat", spec=["id"])
+        query1 = self._make_one(parent)
+        query2 = query1.select(["X", "Y", "Z"])
+        query3 = query2.where("Y", ">", 2.5)
+        query4 = query3.order_by("X")
+        query5 = query4.limit(17)
+        query6 = query5.offset(3)
+        query7 = query6.start_at({"X": 10})
+        query8 = query7.end_at({"X": 25})
+
+        structured_query_pb = query8._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "select": query_pb2.StructuredQuery.Projection(
+                fields=[
+                    query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                    for field_path in ["X", "Y", "Z"]
+                ]
+            ),
+            "where": query_pb2.StructuredQuery.Filter(
+                field_filter=query_pb2.StructuredQuery.FieldFilter(
+                    field=query_pb2.StructuredQuery.FieldReference(field_path="Y"),
+                    op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+                    value=document_pb2.Value(double_value=2.5),
+                )
+            ),
+            "order_by": [
+                _make_order_pb("X", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+            "start_at": query_pb2.Cursor(
+                values=[document_pb2.Value(integer_value=10)], before=True
+            ),
+            "end_at": query_pb2.Cursor(values=[document_pb2.Value(integer_value=25)]),
+            "offset": 3,
+            "limit": wrappers_pb2.Int32Value(value=17),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_select_only(self):
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="cat", spec=["id"])
+        query1 = self._make_one(parent)
+        field_paths = ["a.b", "a.c", "d"]
+        query2 = query1.select(field_paths)
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "select": query_pb2.StructuredQuery.Projection(
+                fields=[
+                    query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                    for field_path in field_paths
+                ]
+            ),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_where_only(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="dog", spec=["id"])
+        query1 = self._make_one(parent)
+        query2 = query1.where("a", "==", u"b")
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "where": query_pb2.StructuredQuery.Filter(
+                field_filter=query_pb2.StructuredQuery.FieldFilter(
+                    field=query_pb2.StructuredQuery.FieldReference(field_path="a"),
+                    op=enums.StructuredQuery.FieldFilter.Operator.EQUAL,
+                    value=document_pb2.Value(string_value=u"b"),
+                )
+            ),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_order_by_only(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="fish", spec=["id"])
+        query1 = self._make_one(parent)
+        query2 = query1.order_by("abc")
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "order_by": [
+                _make_order_pb("abc", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_start_at_only(self):
+        # NOTE: "only" is wrong since we must have ``order_by`` as well.
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="phish", spec=["id"])
+        query = self._make_one(parent).order_by("X.Y").start_after({"X": {"Y": u"Z"}})
+
+        structured_query_pb = query._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "order_by": [
+                _make_order_pb("X.Y", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+            "start_at": query_pb2.Cursor(
+                values=[document_pb2.Value(string_value=u"Z")]
+            ),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_end_at_only(self):
+        # NOTE: "only" is wrong since we must have ``order_by`` as well.
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="ghoti", spec=["id"])
+        query = self._make_one(parent).order_by("a").end_at({"a": 88})
+
+        structured_query_pb = query._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "order_by": [
+                _make_order_pb("a", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+            "end_at": query_pb2.Cursor(values=[document_pb2.Value(integer_value=88)]),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_offset_only(self):
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="cartt", spec=["id"])
+        query1 = self._make_one(parent)
+        offset = 14
+        query2 = query1.offset(offset)
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "offset": offset,
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_limit_only(self):
+        from google.protobuf import wrappers_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        parent = mock.Mock(id="donut", spec=["id"])
+        query1 = self._make_one(parent)
+        limit = 31
+        query2 = query1.limit(limit)
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "limit": wrappers_pb2.Int32Value(value=limit),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test_get_simple(self):
+        import warnings
+
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dee")
+
+        # Add a dummy response to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        name = "{}/sleep".format(expected_prefix)
+        data = {"snooze": 10}
+        response_pb = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+
+        with warnings.catch_warnings(record=True) as warned:
+            get_response = query.get()
+
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("dee", "sleep"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+        # Verify the deprecation
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+    def test_stream_simple(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dee")
+
+        # Add a dummy response to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        name = "{}/sleep".format(expected_prefix)
+        data = {"snooze": 10}
+        response_pb = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("dee", "sleep"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_with_transaction(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Create a real-ish transaction for this client.
+        transaction = client.transaction()
+        txn_id = b"\x00\x00\x01-work-\xf2"
+        transaction._id = txn_id
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("declaration")
+
+        # Add a dummy response to the minimal fake GAPIC.
+        parent_path, expected_prefix = parent._parent_info()
+        name = "{}/burger".format(expected_prefix)
+        data = {"lettuce": b"\xee\x87"}
+        response_pb = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream(transaction=transaction)
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("declaration", "burger"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_no_results(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["run_query"])
+        empty_response = _make_query_response()
+        run_query_response = iter([empty_response])
+        firestore_api.run_query.return_value = run_query_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dah", "dah", "dum")
+        query = self._make_one(parent)
+
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        self.assertEqual(list(get_response), [])
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_second_response_in_empty_stream(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["run_query"])
+        empty_response1 = _make_query_response()
+        empty_response2 = _make_query_response()
+        run_query_response = iter([empty_response1, empty_response2])
+        firestore_api.run_query.return_value = run_query_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dah", "dah", "dum")
+        query = self._make_one(parent)
+
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        self.assertEqual(list(get_response), [])
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_with_skipped_results(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("talk", "and", "chew-gum")
+
+        # Add two dummy responses to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        response_pb1 = _make_query_response(skipped_results=1)
+        name = "{}/clock".format(expected_prefix)
+        data = {"noon": 12, "nested": {"bird": 10.5}}
+        response_pb2 = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb1, response_pb2])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("talk", "and", "chew-gum", "clock"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_empty_after_first_response(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("charles")
+
+        # Add two dummy responses to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        name = "{}/bark".format(expected_prefix)
+        data = {"lee": "hoop"}
+        response_pb1 = _make_query_response(name=name, data=data)
+        response_pb2 = _make_query_response()
+        firestore_api.run_query.return_value = iter([response_pb1, response_pb2])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("charles", "bark"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_w_collection_group(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("charles")
+        other = client.collection("dora")
+
+        # Add two dummy responses to the minimal fake GAPIC.
+        _, other_prefix = other._parent_info()
+        name = "{}/bark".format(other_prefix)
+        data = {"lee": "hoop"}
+        response_pb1 = _make_query_response(name=name, data=data)
+        response_pb2 = _make_query_response()
+        firestore_api.run_query.return_value = iter([response_pb1, response_pb2])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        query._all_descendants = True
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        to_match = other.document("bark")
+        self.assertEqual(snapshot.reference._document_path, to_match._document_path)
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    @mock.patch("google.cloud.firestore_v1.query.Watch", autospec=True)
+    def test_on_snapshot(self, watch):
+        query = self._make_one(mock.sentinel.parent)
+        query.on_snapshot(None)
+        watch.for_query.assert_called_once()
+
+    def test_comparator_no_ordering(self):
+        query = self._make_one(mock.sentinel.parent)
+        query._orders = []
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, -1)
+
+    def test_comparator_no_ordering_same_id(self):
+        query = self._make_one(mock.sentinel.parent)
+        query._orders = []
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument1")
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, 0)
+
+    def test_comparator_ordering(self):
+        query = self._make_one(mock.sentinel.parent)
+        orderByMock = mock.Mock()
+        orderByMock.field.field_path = "last"
+        orderByMock.direction = 1  # ascending
+        query._orders = [orderByMock]
+
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+        doc1._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "secondlovelace"},
+        }
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+        doc2._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "lovelace"},
+        }
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, 1)
+
+    def test_comparator_ordering_descending(self):
+        query = self._make_one(mock.sentinel.parent)
+        orderByMock = mock.Mock()
+        orderByMock.field.field_path = "last"
+        orderByMock.direction = -1  # descending
+        query._orders = [orderByMock]
+
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+        doc1._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "secondlovelace"},
+        }
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+        doc2._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "lovelace"},
+        }
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, -1)
+
+    def test_comparator_missing_order_by_field_in_data_raises(self):
+        query = self._make_one(mock.sentinel.parent)
+        orderByMock = mock.Mock()
+        orderByMock.field.field_path = "last"
+        orderByMock.direction = 1  # ascending
+        query._orders = [orderByMock]
+
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+        doc1._data = {}
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+        doc2._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "lovelace"},
+        }
+
+        with self.assertRaisesRegex(ValueError, "Can only compare fields "):
+            query._comparator(doc1, doc2)
+
+
+class Test__enum_from_op_string(unittest.TestCase):
+    @staticmethod
+    def _call_fut(op_string):
+        from google.cloud.firestore_v1.query import _enum_from_op_string
+
+        return _enum_from_op_string(op_string)
+
+    def test_success(self):
+        from google.cloud.firestore_v1.gapic import enums
+
+        op_class = enums.StructuredQuery.FieldFilter.Operator
+        self.assertEqual(self._call_fut("<"), op_class.LESS_THAN)
+        self.assertEqual(self._call_fut("<="), op_class.LESS_THAN_OR_EQUAL)
+        self.assertEqual(self._call_fut("=="), op_class.EQUAL)
+        self.assertEqual(self._call_fut(">="), op_class.GREATER_THAN_OR_EQUAL)
+        self.assertEqual(self._call_fut(">"), op_class.GREATER_THAN)
+        self.assertEqual(self._call_fut("array_contains"), op_class.ARRAY_CONTAINS)
+
+    def test_failure(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("?")
+
+
+class Test__isnan(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value):
+        from google.cloud.firestore_v1.query import _isnan
+
+        return _isnan(value)
+
+    def test_valid(self):
+        self.assertTrue(self._call_fut(float("nan")))
+
+    def test_invalid(self):
+        self.assertFalse(self._call_fut(51.5))
+        self.assertFalse(self._call_fut(None))
+        self.assertFalse(self._call_fut("str"))
+        self.assertFalse(self._call_fut(int))
+        self.assertFalse(self._call_fut(1.0 + 1.0j))
+
+
+class Test__enum_from_direction(unittest.TestCase):
+    @staticmethod
+    def _call_fut(direction):
+        from google.cloud.firestore_v1.query import _enum_from_direction
+
+        return _enum_from_direction(direction)
+
+    def test_success(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.query import Query
+
+        dir_class = enums.StructuredQuery.Direction
+        self.assertEqual(self._call_fut(Query.ASCENDING), dir_class.ASCENDING)
+        self.assertEqual(self._call_fut(Query.DESCENDING), dir_class.DESCENDING)
+
+        # Ints pass through
+        self.assertEqual(self._call_fut(dir_class.ASCENDING), dir_class.ASCENDING)
+        self.assertEqual(self._call_fut(dir_class.DESCENDING), dir_class.DESCENDING)
+
+    def test_failure(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("neither-ASCENDING-nor-DESCENDING")
+
+
+class Test__filter_pb(unittest.TestCase):
+    @staticmethod
+    def _call_fut(field_or_unary):
+        from google.cloud.firestore_v1.query import _filter_pb
+
+        return _filter_pb(field_or_unary)
+
+    def test_unary(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        unary_pb = query_pb2.StructuredQuery.UnaryFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="a.b.c"),
+            op=enums.StructuredQuery.UnaryFilter.Operator.IS_NULL,
+        )
+        filter_pb = self._call_fut(unary_pb)
+        expected_pb = query_pb2.StructuredQuery.Filter(unary_filter=unary_pb)
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_field(self):
+        from google.cloud.firestore_v1.gapic import enums
+        from google.cloud.firestore_v1.proto import document_pb2
+        from google.cloud.firestore_v1.proto import query_pb2
+
+        field_filter_pb = query_pb2.StructuredQuery.FieldFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="XYZ"),
+            op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+            value=document_pb2.Value(double_value=90.75),
+        )
+        filter_pb = self._call_fut(field_filter_pb)
+        expected_pb = query_pb2.StructuredQuery.Filter(field_filter=field_filter_pb)
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_bad_type(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(None)
+
+
+class Test__cursor_pb(unittest.TestCase):
+    @staticmethod
+    def _call_fut(cursor_pair):
+        from google.cloud.firestore_v1.query import _cursor_pb
+
+        return _cursor_pb(cursor_pair)
+
+    def test_no_pair(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_success(self):
+        from google.cloud.firestore_v1.proto import query_pb2
+        from google.cloud.firestore_v1 import _helpers
+
+        data = [1.5, 10, True]
+        cursor_pair = data, True
+
+        cursor_pb = self._call_fut(cursor_pair)
+
+        expected_pb = query_pb2.Cursor(
+            values=[_helpers.encode_value(value) for value in data], before=True
+        )
+        self.assertEqual(cursor_pb, expected_pb)
+
+
+class Test__query_response_to_snapshot(unittest.TestCase):
+    @staticmethod
+    def _call_fut(response_pb, collection, expected_prefix):
+        from google.cloud.firestore_v1.query import _query_response_to_snapshot
+
+        return _query_response_to_snapshot(response_pb, collection, expected_prefix)
+
+    def test_empty(self):
+        response_pb = _make_query_response()
+        snapshot = self._call_fut(response_pb, None, None)
+        self.assertIsNone(snapshot)
+
+    def test_after_offset(self):
+        skipped_results = 410
+        response_pb = _make_query_response(skipped_results=skipped_results)
+        snapshot = self._call_fut(response_pb, None, None)
+        self.assertIsNone(snapshot)
+
+    def test_response(self):
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        client = _make_client()
+        collection = client.collection("a", "b", "c")
+        _, expected_prefix = collection._parent_info()
+
+        # Create name for the protobuf.
+        doc_id = "gigantic"
+        name = "{}/{}".format(expected_prefix, doc_id)
+        data = {"a": 901, "b": True}
+        response_pb = _make_query_response(name=name, data=data)
+
+        snapshot = self._call_fut(response_pb, collection, expected_prefix)
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        expected_path = collection._path + (doc_id,)
+        self.assertEqual(snapshot.reference._path, expected_path)
+        self.assertEqual(snapshot.to_dict(), data)
+        self.assertTrue(snapshot.exists)
+        self.assertEqual(snapshot.read_time, response_pb.read_time)
+        self.assertEqual(snapshot.create_time, response_pb.document.create_time)
+        self.assertEqual(snapshot.update_time, response_pb.document.update_time)
+
+
+class Test__collection_group_query_response_to_snapshot(unittest.TestCase):
+    @staticmethod
+    def _call_fut(response_pb, collection):
+        from google.cloud.firestore_v1.query import (
+            _collection_group_query_response_to_snapshot,
+        )
+
+        return _collection_group_query_response_to_snapshot(response_pb, collection)
+
+    def test_empty(self):
+        response_pb = _make_query_response()
+        snapshot = self._call_fut(response_pb, None)
+        self.assertIsNone(snapshot)
+
+    def test_after_offset(self):
+        skipped_results = 410
+        response_pb = _make_query_response(skipped_results=skipped_results)
+        snapshot = self._call_fut(response_pb, None)
+        self.assertIsNone(snapshot)
+
+    def test_response(self):
+        from google.cloud.firestore_v1.document import DocumentSnapshot
+
+        client = _make_client()
+        collection = client.collection("a", "b", "c")
+        other_collection = client.collection("a", "b", "d")
+        to_match = other_collection.document("gigantic")
+        data = {"a": 901, "b": True}
+        response_pb = _make_query_response(name=to_match._document_path, data=data)
+
+        snapshot = self._call_fut(response_pb, collection)
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        self.assertEqual(snapshot.reference._document_path, to_match._document_path)
+        self.assertEqual(snapshot.to_dict(), data)
+        self.assertTrue(snapshot.exists)
+        self.assertEqual(snapshot.read_time, response_pb.read_time)
+        self.assertEqual(snapshot.create_time, response_pb.document.create_time)
+        self.assertEqual(snapshot.update_time, response_pb.document.update_time)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="project-project"):
+    from google.cloud.firestore_v1.client import Client
+
+    credentials = _make_credentials()
+    return Client(project=project, credentials=credentials)
+
+
+def _make_order_pb(field_path, direction):
+    from google.cloud.firestore_v1.proto import query_pb2
+
+    return query_pb2.StructuredQuery.Order(
+        field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+        direction=direction,
+    )
+
+
+def _make_query_response(**kwargs):
+    # kwargs supported are ``skipped_results``, ``name`` and ``data``
+    from google.cloud.firestore_v1.proto import document_pb2
+    from google.cloud.firestore_v1.proto import firestore_pb2
+    from google.cloud._helpers import _datetime_to_pb_timestamp
+    from google.cloud.firestore_v1 import _helpers
+
+    now = datetime.datetime.utcnow()
+    read_time = _datetime_to_pb_timestamp(now)
+    kwargs["read_time"] = read_time
+
+    name = kwargs.pop("name", None)
+    data = kwargs.pop("data", None)
+    if name is not None and data is not None:
+        document_pb = document_pb2.Document(
+            name=name, fields=_helpers.encode_dict(data)
+        )
+        delta = datetime.timedelta(seconds=100)
+        update_time = _datetime_to_pb_timestamp(now - delta)
+        create_time = _datetime_to_pb_timestamp(now - 2 * delta)
+        document_pb.update_time.CopyFrom(update_time)
+        document_pb.create_time.CopyFrom(create_time)
+
+        kwargs["document"] = document_pb
+
+    return firestore_pb2.RunQueryResponse(**kwargs)
diff --git a/firestore/tests/unit/v1/test_transaction.py b/firestore/tests/unit/v1/test_transaction.py
new file mode 100644
index 000000000000..8cae24a23831
--- /dev/null
+++ b/firestore/tests/unit/v1/test_transaction.py
@@ -0,0 +1,1020 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+import mock
+
+
+class TestTransaction(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.transaction import Transaction
+
+        return Transaction
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        from google.cloud.firestore_v1.transaction import MAX_ATTEMPTS
+
+        transaction = self._make_one(mock.sentinel.client)
+        self.assertIs(transaction._client, mock.sentinel.client)
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertEqual(transaction._max_attempts, MAX_ATTEMPTS)
+        self.assertFalse(transaction._read_only)
+        self.assertIsNone(transaction._id)
+
+    def test_constructor_explicit(self):
+        transaction = self._make_one(
+            mock.sentinel.client, max_attempts=10, read_only=True
+        )
+        self.assertIs(transaction._client, mock.sentinel.client)
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertEqual(transaction._max_attempts, 10)
+        self.assertTrue(transaction._read_only)
+        self.assertIsNone(transaction._id)
+
+    def test__add_write_pbs_failure(self):
+        from google.cloud.firestore_v1.transaction import _WRITE_READ_ONLY
+
+        batch = self._make_one(mock.sentinel.client, read_only=True)
+        self.assertEqual(batch._write_pbs, [])
+        with self.assertRaises(ValueError) as exc_info:
+            batch._add_write_pbs([mock.sentinel.write])
+
+        self.assertEqual(exc_info.exception.args, (_WRITE_READ_ONLY,))
+        self.assertEqual(batch._write_pbs, [])
+
+    def test__add_write_pbs(self):
+        batch = self._make_one(mock.sentinel.client)
+        self.assertEqual(batch._write_pbs, [])
+        batch._add_write_pbs([mock.sentinel.write])
+        self.assertEqual(batch._write_pbs, [mock.sentinel.write])
+
+    def test__options_protobuf_read_only(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        transaction = self._make_one(mock.sentinel.client, read_only=True)
+        options_pb = transaction._options_protobuf(None)
+        expected_pb = common_pb2.TransactionOptions(
+            read_only=common_pb2.TransactionOptions.ReadOnly()
+        )
+        self.assertEqual(options_pb, expected_pb)
+
+    def test__options_protobuf_read_only_retry(self):
+        from google.cloud.firestore_v1.transaction import _CANT_RETRY_READ_ONLY
+
+        transaction = self._make_one(mock.sentinel.client, read_only=True)
+        retry_id = b"illuminate"
+
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._options_protobuf(retry_id)
+
+        self.assertEqual(exc_info.exception.args, (_CANT_RETRY_READ_ONLY,))
+
+    def test__options_protobuf_read_write(self):
+        transaction = self._make_one(mock.sentinel.client)
+        options_pb = transaction._options_protobuf(None)
+        self.assertIsNone(options_pb)
+
+    def test__options_protobuf_on_retry(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        transaction = self._make_one(mock.sentinel.client)
+        retry_id = b"hocus-pocus"
+        options_pb = transaction._options_protobuf(retry_id)
+        expected_pb = common_pb2.TransactionOptions(
+            read_write=common_pb2.TransactionOptions.ReadWrite(
+                retry_transaction=retry_id
+            )
+        )
+        self.assertEqual(options_pb, expected_pb)
+
+    def test_in_progress_property(self):
+        transaction = self._make_one(mock.sentinel.client)
+        self.assertFalse(transaction.in_progress)
+        transaction._id = b"not-none-bites"
+        self.assertTrue(transaction.in_progress)
+
+    def test_id_property(self):
+        transaction = self._make_one(mock.sentinel.client)
+        transaction._id = mock.sentinel.eye_dee
+        self.assertIs(transaction.id, mock.sentinel.eye_dee)
+
+    def test__begin(self):
+        from google.cloud.firestore_v1.gapic import firestore_client
+        from google.cloud.firestore_v1.proto import firestore_pb2
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        txn_id = b"to-begin"
+        response = firestore_pb2.BeginTransactionResponse(transaction=txn_id)
+        firestore_api.begin_transaction.return_value = response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction and ``begin()`` it.
+        transaction = self._make_one(client)
+        self.assertIsNone(transaction._id)
+
+        ret_val = transaction._begin()
+        self.assertIsNone(ret_val)
+        self.assertEqual(transaction._id, txn_id)
+
+        # Verify the called mock.
+        firestore_api.begin_transaction.assert_called_once_with(
+            client._database_string, options_=None, metadata=client._rpc_metadata
+        )
+
+    def test__begin_failure(self):
+        from google.cloud.firestore_v1.transaction import _CANT_BEGIN
+
+        client = _make_client()
+        transaction = self._make_one(client)
+        transaction._id = b"not-none"
+
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._begin()
+
+        err_msg = _CANT_BEGIN.format(transaction._id)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test__clean_up(self):
+        transaction = self._make_one(mock.sentinel.client)
+        transaction._write_pbs.extend(
+            [mock.sentinel.write_pb1, mock.sentinel.write_pb2]
+        )
+        transaction._id = b"not-this-time-my-friend"
+
+        ret_val = transaction._clean_up()
+        self.assertIsNone(ret_val)
+
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertIsNone(transaction._id)
+
+    def test__rollback(self):
+        from google.protobuf import empty_pb2
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        firestore_api.rollback.return_value = empty_pb2.Empty()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction and roll it back.
+        transaction = self._make_one(client)
+        txn_id = b"to-be-r\x00lled"
+        transaction._id = txn_id
+        ret_val = transaction._rollback()
+        self.assertIsNone(ret_val)
+        self.assertIsNone(transaction._id)
+
+        # Verify the called mock.
+        firestore_api.rollback.assert_called_once_with(
+            client._database_string, txn_id, metadata=client._rpc_metadata
+        )
+
+    def test__rollback_not_allowed(self):
+        from google.cloud.firestore_v1.transaction import _CANT_ROLLBACK
+
+        client = _make_client()
+        transaction = self._make_one(client)
+        self.assertIsNone(transaction._id)
+
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._rollback()
+
+        self.assertEqual(exc_info.exception.args, (_CANT_ROLLBACK,))
+
+    def test__rollback_failure(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy failure.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        exc = exceptions.InternalServerError("Fire during rollback.")
+        firestore_api.rollback.side_effect = exc
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction and roll it back.
+        transaction = self._make_one(client)
+        txn_id = b"roll-bad-server"
+        transaction._id = txn_id
+
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            transaction._rollback()
+
+        self.assertIs(exc_info.exception, exc)
+        self.assertIsNone(transaction._id)
+        self.assertEqual(transaction._write_pbs, [])
+
+        # Verify the called mock.
+        firestore_api.rollback.assert_called_once_with(
+            client._database_string, txn_id, metadata=client._rpc_metadata
+        )
+
+    def test__commit(self):
+        from google.cloud.firestore_v1.gapic import firestore_client
+        from google.cloud.firestore_v1.proto import firestore_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        commit_response = firestore_pb2.CommitResponse(
+            write_results=[write_pb2.WriteResult()]
+        )
+        firestore_api.commit.return_value = commit_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("phone-joe")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction with some mutations and call _commit().
+        transaction = self._make_one(client)
+        txn_id = b"under-over-thru-woods"
+        transaction._id = txn_id
+        document = client.document("zap", "galaxy", "ship", "space")
+        transaction.set(document, {"apple": 4.5})
+        write_pbs = transaction._write_pbs[::]
+
+        write_results = transaction._commit()
+        self.assertEqual(write_results, list(commit_response.write_results))
+        # Make sure transaction has no more "changes".
+        self.assertIsNone(transaction._id)
+        self.assertEqual(transaction._write_pbs, [])
+
+        # Verify the mocks.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test__commit_not_allowed(self):
+        from google.cloud.firestore_v1.transaction import _CANT_COMMIT
+
+        transaction = self._make_one(mock.sentinel.client)
+        self.assertIsNone(transaction._id)
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._commit()
+
+        self.assertEqual(exc_info.exception.args, (_CANT_COMMIT,))
+
+    def test__commit_failure(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy failure.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        exc = exceptions.InternalServerError("Fire during commit.")
+        firestore_api.commit.side_effect = exc
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction with some mutations and call _commit().
+        transaction = self._make_one(client)
+        txn_id = b"beep-fail-commit"
+        transaction._id = txn_id
+        transaction.create(client.document("up", "down"), {"water": 1.0})
+        transaction.delete(client.document("up", "left"))
+        write_pbs = transaction._write_pbs[::]
+
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            transaction._commit()
+
+        self.assertIs(exc_info.exception, exc)
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(transaction._write_pbs, write_pbs)
+
+        # Verify the called mock.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all(self):
+        client = mock.Mock(spec=["get_all"])
+        transaction = self._make_one(client)
+        ref1, ref2 = mock.Mock(), mock.Mock()
+        result = transaction.get_all([ref1, ref2])
+        client.get_all.assert_called_once_with([ref1, ref2], transaction=transaction.id)
+        self.assertIs(result, client.get_all.return_value)
+
+    def test_get_document_ref(self):
+        from google.cloud.firestore_v1.document import DocumentReference
+
+        client = mock.Mock(spec=["get_all"])
+        transaction = self._make_one(client)
+        ref = DocumentReference("documents", "doc-id")
+        result = transaction.get(ref)
+        client.get_all.assert_called_once_with([ref], transaction=transaction.id)
+        self.assertIs(result, client.get_all.return_value)
+
+    def test_get_w_query(self):
+        from google.cloud.firestore_v1.query import Query
+
+        client = mock.Mock(spec=[])
+        transaction = self._make_one(client)
+        query = Query(parent=mock.Mock(spec=[]))
+        query.stream = mock.MagicMock()
+        result = transaction.get(query)
+        query.stream.assert_called_once_with(transaction=transaction.id)
+        self.assertIs(result, query.stream.return_value)
+
+    def test_get_failure(self):
+        client = _make_client()
+        transaction = self._make_one(client)
+        ref_or_query = object()
+        with self.assertRaises(ValueError):
+            transaction.get(ref_or_query)
+
+
+class Test_Transactional(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.transaction import _Transactional
+
+        return _Transactional
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        wrapped = self._make_one(mock.sentinel.callable_)
+        self.assertIs(wrapped.to_wrap, mock.sentinel.callable_)
+        self.assertIsNone(wrapped.current_id)
+        self.assertIsNone(wrapped.retry_id)
+
+    def test__reset(self):
+        wrapped = self._make_one(mock.sentinel.callable_)
+        wrapped.current_id = b"not-none"
+        wrapped.retry_id = b"also-not"
+
+        ret_val = wrapped._reset()
+        self.assertIsNone(ret_val)
+
+        self.assertIsNone(wrapped.current_id)
+        self.assertIsNone(wrapped.retry_id)
+
+    def test__pre_commit_success(self):
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"totes-began"
+        transaction = _make_transaction(txn_id)
+        result = wrapped._pre_commit(transaction, "pos", key="word")
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, "pos", key="word")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_not_called()
+
+    def test__pre_commit_retry_id_already_set_success(self):
+        from google.cloud.firestore_v1.proto import common_pb2
+
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+        txn_id1 = b"already-set"
+        wrapped.retry_id = txn_id1
+
+        txn_id2 = b"ok-here-too"
+        transaction = _make_transaction(txn_id2)
+        result = wrapped._pre_commit(transaction)
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertEqual(transaction._id, txn_id2)
+        self.assertEqual(wrapped.current_id, txn_id2)
+        self.assertEqual(wrapped.retry_id, txn_id1)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction)
+        firestore_api = transaction._client._firestore_api
+        options_ = common_pb2.TransactionOptions(
+            read_write=common_pb2.TransactionOptions.ReadWrite(
+                retry_transaction=txn_id1
+            )
+        )
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=options_,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_not_called()
+
+    def test__pre_commit_failure(self):
+        exc = RuntimeError("Nope not today.")
+        to_wrap = mock.Mock(side_effect=exc, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"gotta-fail"
+        transaction = _make_transaction(txn_id)
+        with self.assertRaises(RuntimeError) as exc_info:
+            wrapped._pre_commit(transaction, 10, 20)
+        self.assertIs(exc_info.exception, exc)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, 10, 20)
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_called_once_with(
+            transaction._client._database_string,
+            txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.commit.assert_not_called()
+
+    def test__pre_commit_failure_with_rollback_failure(self):
+        from google.api_core import exceptions
+
+        exc1 = ValueError("I will not be only failure.")
+        to_wrap = mock.Mock(side_effect=exc1, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"both-will-fail"
+        transaction = _make_transaction(txn_id)
+        # Actually force the ``rollback`` to fail as well.
+        exc2 = exceptions.InternalServerError("Rollback blues.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.rollback.side_effect = exc2
+
+        # Try to ``_pre_commit``
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            wrapped._pre_commit(transaction, a="b", c="zebra")
+        self.assertIs(exc_info.exception, exc2)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, a="b", c="zebra")
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_called_once_with(
+            transaction._client._database_string,
+            txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.commit.assert_not_called()
+
+    def test__maybe_commit_success(self):
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"nyet"
+        transaction = _make_transaction(txn_id)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        succeeded = wrapped._maybe_commit(transaction)
+        self.assertTrue(succeeded)
+
+        # On success, _id is reset.
+        self.assertIsNone(transaction._id)
+
+        # Verify mocks.
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test__maybe_commit_failure_read_only(self):
+        from google.api_core import exceptions
+
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"failed"
+        transaction = _make_transaction(txn_id, read_only=True)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        wrapped.current_id = txn_id  # We won't call ``_pre_commit()``.
+        wrapped.retry_id = txn_id  # We won't call ``_pre_commit()``.
+
+        # Actually force the ``commit`` to fail (use ABORTED, but cannot
+        # retry since read-only).
+        exc = exceptions.Aborted("Read-only did a bad.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        with self.assertRaises(exceptions.Aborted) as exc_info:
+            wrapped._maybe_commit(transaction)
+        self.assertIs(exc_info.exception, exc)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test__maybe_commit_failure_can_retry(self):
+        from google.api_core import exceptions
+
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"failed-but-retry"
+        transaction = _make_transaction(txn_id)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        wrapped.current_id = txn_id  # We won't call ``_pre_commit()``.
+        wrapped.retry_id = txn_id  # We won't call ``_pre_commit()``.
+
+        # Actually force the ``commit`` to fail.
+        exc = exceptions.Aborted("Read-write did a bad.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        succeeded = wrapped._maybe_commit(transaction)
+        self.assertFalse(succeeded)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test__maybe_commit_failure_cannot_retry(self):
+        from google.api_core import exceptions
+
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"failed-but-not-retryable"
+        transaction = _make_transaction(txn_id)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        wrapped.current_id = txn_id  # We won't call ``_pre_commit()``.
+        wrapped.retry_id = txn_id  # We won't call ``_pre_commit()``.
+
+        # Actually force the ``commit`` to fail.
+        exc = exceptions.InternalServerError("Real bad thing")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            wrapped._maybe_commit(transaction)
+        self.assertIs(exc_info.exception, exc)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test___call__success_first_attempt(self):
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"whole-enchilada"
+        transaction = _make_transaction(txn_id)
+        result = wrapped(transaction, "a", b="c")
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, "a", b="c")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test___call__success_second_attempt(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.proto import common_pb2
+        from google.cloud.firestore_v1.proto import firestore_pb2
+        from google.cloud.firestore_v1.proto import write_pb2
+
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"whole-enchilada"
+        transaction = _make_transaction(txn_id)
+
+        # Actually force the ``commit`` to fail on first / succeed on second.
+        exc = exceptions.Aborted("Contention junction.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = [
+            exc,
+            firestore_pb2.CommitResponse(write_results=[write_pb2.WriteResult()]),
+        ]
+
+        # Call the __call__-able ``wrapped``.
+        result = wrapped(transaction, "a", b="c")
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        wrapped_call = mock.call(transaction, "a", b="c")
+        self.assertEqual(to_wrap.mock_calls, [wrapped_call, wrapped_call])
+        firestore_api = transaction._client._firestore_api
+        db_str = transaction._client._database_string
+        options_ = common_pb2.TransactionOptions(
+            read_write=common_pb2.TransactionOptions.ReadWrite(retry_transaction=txn_id)
+        )
+        self.assertEqual(
+            firestore_api.begin_transaction.mock_calls,
+            [
+                mock.call(
+                    db_str, options_=None, metadata=transaction._client._rpc_metadata
+                ),
+                mock.call(
+                    db_str,
+                    options_=options_,
+                    metadata=transaction._client._rpc_metadata,
+                ),
+            ],
+        )
+        firestore_api.rollback.assert_not_called()
+        commit_call = mock.call(
+            db_str, [], transaction=txn_id, metadata=transaction._client._rpc_metadata
+        )
+        self.assertEqual(firestore_api.commit.mock_calls, [commit_call, commit_call])
+
+    def test___call__failure(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.transaction import _EXCEED_ATTEMPTS_TEMPLATE
+
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"only-one-shot"
+        transaction = _make_transaction(txn_id, max_attempts=1)
+
+        # Actually force the ``commit`` to fail.
+        exc = exceptions.Aborted("Contention just once.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        # Call the __call__-able ``wrapped``.
+        with self.assertRaises(ValueError) as exc_info:
+            wrapped(transaction, "here", there=1.5)
+
+        err_msg = _EXCEED_ATTEMPTS_TEMPLATE.format(transaction._max_attempts)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, "here", there=1.5)
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_called_once_with(
+            transaction._client._database_string,
+            txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+
+class Test_transactional(unittest.TestCase):
+    @staticmethod
+    def _call_fut(to_wrap):
+        from google.cloud.firestore_v1.transaction import transactional
+
+        return transactional(to_wrap)
+
+    def test_it(self):
+        from google.cloud.firestore_v1.transaction import _Transactional
+
+        wrapped = self._call_fut(mock.sentinel.callable_)
+        self.assertIsInstance(wrapped, _Transactional)
+        self.assertIs(wrapped.to_wrap, mock.sentinel.callable_)
+
+
+class Test__commit_with_retry(unittest.TestCase):
+    @staticmethod
+    def _call_fut(client, write_pbs, transaction_id):
+        from google.cloud.firestore_v1.transaction import _commit_with_retry
+
+        return _commit_with_retry(client, write_pbs, transaction_id)
+
+    @mock.patch("google.cloud.firestore_v1.transaction._sleep")
+    def test_success_first_attempt(self, _sleep):
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("summer")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"cheeeeeez"
+        commit_response = self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+        self.assertIs(commit_response, firestore_api.commit.return_value)
+
+        # Verify mocks used.
+        _sleep.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    @mock.patch("google.cloud.firestore_v1.transaction._sleep", side_effect=[2.0, 4.0])
+    def test_success_third_attempt(self, _sleep):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        # Make sure the first two requests fail and the third succeeds.
+        firestore_api.commit.side_effect = [
+            exceptions.ServiceUnavailable("Server sleepy."),
+            exceptions.ServiceUnavailable("Server groggy."),
+            mock.sentinel.commit_response,
+        ]
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("outside")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"the-world\x00"
+        commit_response = self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+        self.assertIs(commit_response, mock.sentinel.commit_response)
+
+        # Verify mocks used.
+        self.assertEqual(_sleep.call_count, 2)
+        _sleep.assert_any_call(1.0)
+        _sleep.assert_any_call(2.0)
+        # commit() called same way 3 times.
+        commit_call = mock.call(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+        self.assertEqual(
+            firestore_api.commit.mock_calls, [commit_call, commit_call, commit_call]
+        )
+
+    @mock.patch("google.cloud.firestore_v1.transaction._sleep")
+    def test_failure_first_attempt(self, _sleep):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        # Make sure the first request fails with an un-retryable error.
+        exc = exceptions.ResourceExhausted("We ran out of fries.")
+        firestore_api.commit.side_effect = exc
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("peanut-butter")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"\x08\x06\x07\x05\x03\x00\x09-jenny"
+        with self.assertRaises(exceptions.ResourceExhausted) as exc_info:
+            self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+
+        self.assertIs(exc_info.exception, exc)
+
+        # Verify mocks used.
+        _sleep.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    @mock.patch("google.cloud.firestore_v1.transaction._sleep", return_value=2.0)
+    def test_failure_second_attempt(self, _sleep):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        # Make sure the first request fails retry-able and second
+        # fails non-retryable.
+        exc1 = exceptions.ServiceUnavailable("Come back next time.")
+        exc2 = exceptions.InternalServerError("Server on fritz.")
+        firestore_api.commit.side_effect = [exc1, exc2]
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("peanut-butter")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"the-journey-when-and-where-well-go"
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+
+        self.assertIs(exc_info.exception, exc2)
+
+        # Verify mocks used.
+        _sleep.assert_called_once_with(1.0)
+        # commit() called same way 2 times.
+        commit_call = mock.call(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+        self.assertEqual(firestore_api.commit.mock_calls, [commit_call, commit_call])
+
+
+class Test__sleep(unittest.TestCase):
+    @staticmethod
+    def _call_fut(current_sleep, **kwargs):
+        from google.cloud.firestore_v1.transaction import _sleep
+
+        return _sleep(current_sleep, **kwargs)
+
+    @mock.patch("random.uniform", return_value=5.5)
+    @mock.patch("time.sleep", return_value=None)
+    def test_defaults(self, sleep, uniform):
+        curr_sleep = 10.0
+        self.assertLessEqual(uniform.return_value, curr_sleep)
+
+        new_sleep = self._call_fut(curr_sleep)
+        self.assertEqual(new_sleep, 2.0 * curr_sleep)
+
+        uniform.assert_called_once_with(0.0, curr_sleep)
+        sleep.assert_called_once_with(uniform.return_value)
+
+    @mock.patch("random.uniform", return_value=10.5)
+    @mock.patch("time.sleep", return_value=None)
+    def test_explicit(self, sleep, uniform):
+        curr_sleep = 12.25
+        self.assertLessEqual(uniform.return_value, curr_sleep)
+
+        multiplier = 1.5
+        new_sleep = self._call_fut(curr_sleep, max_sleep=100.0, multiplier=multiplier)
+        self.assertEqual(new_sleep, multiplier * curr_sleep)
+
+        uniform.assert_called_once_with(0.0, curr_sleep)
+        sleep.assert_called_once_with(uniform.return_value)
+
+    @mock.patch("random.uniform", return_value=6.75)
+    @mock.patch("time.sleep", return_value=None)
+    def test_exceeds_max(self, sleep, uniform):
+        curr_sleep = 20.0
+        self.assertLessEqual(uniform.return_value, curr_sleep)
+
+        max_sleep = 38.5
+        new_sleep = self._call_fut(curr_sleep, max_sleep=max_sleep, multiplier=2.0)
+        self.assertEqual(new_sleep, max_sleep)
+
+        uniform.assert_called_once_with(0.0, curr_sleep)
+        sleep.assert_called_once_with(uniform.return_value)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="feral-tom-cat"):
+    from google.cloud.firestore_v1.client import Client
+
+    credentials = _make_credentials()
+    return Client(project=project, credentials=credentials)
+
+
+def _make_transaction(txn_id, **txn_kwargs):
+    from google.protobuf import empty_pb2
+    from google.cloud.firestore_v1.gapic import firestore_client
+    from google.cloud.firestore_v1.proto import firestore_pb2
+    from google.cloud.firestore_v1.proto import write_pb2
+    from google.cloud.firestore_v1.transaction import Transaction
+
+    # Create a fake GAPIC ...
+    firestore_api = mock.create_autospec(
+        firestore_client.FirestoreClient, instance=True
+    )
+    # ... with a dummy ``BeginTransactionResponse`` result ...
+    begin_response = firestore_pb2.BeginTransactionResponse(transaction=txn_id)
+    firestore_api.begin_transaction.return_value = begin_response
+    # ... and a dummy ``Rollback`` result ...
+    firestore_api.rollback.return_value = empty_pb2.Empty()
+    # ... and a dummy ``Commit`` result.
+    commit_response = firestore_pb2.CommitResponse(
+        write_results=[write_pb2.WriteResult()]
+    )
+    firestore_api.commit.return_value = commit_response
+
+    # Attach the fake GAPIC to a real client.
+    client = _make_client()
+    client._firestore_api_internal = firestore_api
+
+    return Transaction(client, **txn_kwargs)
diff --git a/firestore/tests/unit/v1/test_transforms.py b/firestore/tests/unit/v1/test_transforms.py
new file mode 100644
index 000000000000..04a6dcdc0899
--- /dev/null
+++ b/firestore/tests/unit/v1/test_transforms.py
@@ -0,0 +1,113 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+
+class Test_ValueList(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.transforms import _ValueList
+
+        return _ValueList
+
+    def _make_one(self, values):
+        return self._get_target_class()(values)
+
+    def test_ctor_w_non_list_non_tuple(self):
+        invalid_values = (None, u"phred", b"DEADBEEF", 123, {}, object())
+        for invalid_value in invalid_values:
+            with self.assertRaises(ValueError):
+                self._make_one(invalid_value)
+
+    def test_ctor_w_empty(self):
+        with self.assertRaises(ValueError):
+            self._make_one([])
+
+    def test_ctor_w_non_empty_list(self):
+        values = ["phred", "bharney"]
+        inst = self._make_one(values)
+        self.assertEqual(inst.values, values)
+
+    def test_ctor_w_non_empty_tuple(self):
+        values = ("phred", "bharney")
+        inst = self._make_one(values)
+        self.assertEqual(inst.values, list(values))
+
+    def test___eq___other_type(self):
+        values = ("phred", "bharney")
+        inst = self._make_one(values)
+        other = object()
+        self.assertFalse(inst == other)
+
+    def test___eq___different_values(self):
+        values = ("phred", "bharney")
+        other_values = ("wylma", "bhetty")
+        inst = self._make_one(values)
+        other = self._make_one(other_values)
+        self.assertFalse(inst == other)
+
+    def test___eq___same_values(self):
+        values = ("phred", "bharney")
+        inst = self._make_one(values)
+        other = self._make_one(values)
+        self.assertTrue(inst == other)
+
+
+class Test_NumericValue(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1.transforms import _NumericValue
+
+        return _NumericValue
+
+    def _make_one(self, values):
+        return self._get_target_class()(values)
+
+    def test_ctor_w_invalid_types(self):
+        invalid_values = (None, u"phred", b"DEADBEEF", [], {}, object())
+        for invalid_value in invalid_values:
+            with self.assertRaises(ValueError):
+                self._make_one(invalid_value)
+
+    def test_ctor_w_int(self):
+        values = (-10, -1, 0, 1, 10)
+        for value in values:
+            inst = self._make_one(value)
+            self.assertEqual(inst.value, value)
+
+    def test_ctor_w_float(self):
+        values = (-10.0, -1.0, 0.0, 1.0, 10.0)
+        for value in values:
+            inst = self._make_one(value)
+            self.assertEqual(inst.value, value)
+
+    def test___eq___other_type(self):
+        value = 3.1415926
+        inst = self._make_one(value)
+        other = object()
+        self.assertFalse(inst == other)
+
+    def test___eq___different_value(self):
+        value = 3.1415926
+        other_value = 2.71828
+        inst = self._make_one(value)
+        other = self._make_one(other_value)
+        self.assertFalse(inst == other)
+
+    def test___eq___same_value(self):
+        value = 3.1415926
+        inst = self._make_one(value)
+        other = self._make_one(value)
+        self.assertTrue(inst == other)
diff --git a/firestore/tests/unit/v1/test_watch.py b/firestore/tests/unit/v1/test_watch.py
new file mode 100644
index 000000000000..afd88b813081
--- /dev/null
+++ b/firestore/tests/unit/v1/test_watch.py
@@ -0,0 +1,969 @@
+import datetime
+import unittest
+import mock
+from google.cloud.firestore_v1.proto import firestore_pb2
+
+
+class TestWatchDocTree(unittest.TestCase):
+    def _makeOne(self):
+        from google.cloud.firestore_v1.watch import WatchDocTree
+
+        return WatchDocTree()
+
+    def test_insert_and_keys(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        self.assertEqual(sorted(inst.keys()), ["a", "b"])
+
+    def test_remove_and_keys(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        inst = inst.remove("a")
+        self.assertEqual(sorted(inst.keys()), ["b"])
+
+    def test_insert_and_find(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        val = inst.find("a")
+        self.assertEqual(val.value, 2)
+
+    def test___len__(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        self.assertEqual(len(inst), 2)
+
+    def test___iter__(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        self.assertEqual(sorted(list(inst)), ["a", "b"])
+
+    def test___contains__(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        self.assertTrue("b" in inst)
+        self.assertFalse("a" in inst)
+
+
+class TestDocumentChange(unittest.TestCase):
+    def _makeOne(self, type, document, old_index, new_index):
+        from google.cloud.firestore_v1.watch import DocumentChange
+
+        return DocumentChange(type, document, old_index, new_index)
+
+    def test_ctor(self):
+        inst = self._makeOne("type", "document", "old_index", "new_index")
+        self.assertEqual(inst.type, "type")
+        self.assertEqual(inst.document, "document")
+        self.assertEqual(inst.old_index, "old_index")
+        self.assertEqual(inst.new_index, "new_index")
+
+
+class TestWatchResult(unittest.TestCase):
+    def _makeOne(self, snapshot, name, change_type):
+        from google.cloud.firestore_v1.watch import WatchResult
+
+        return WatchResult(snapshot, name, change_type)
+
+    def test_ctor(self):
+        inst = self._makeOne("snapshot", "name", "change_type")
+        self.assertEqual(inst.snapshot, "snapshot")
+        self.assertEqual(inst.name, "name")
+        self.assertEqual(inst.change_type, "change_type")
+
+
+class Test_maybe_wrap_exception(unittest.TestCase):
+    def _callFUT(self, exc):
+        from google.cloud.firestore_v1.watch import _maybe_wrap_exception
+
+        return _maybe_wrap_exception(exc)
+
+    def test_is_grpc_error(self):
+        import grpc
+        from google.api_core.exceptions import GoogleAPICallError
+
+        exc = grpc.RpcError()
+        result = self._callFUT(exc)
+        self.assertEqual(result.__class__, GoogleAPICallError)
+
+    def test_is_not_grpc_error(self):
+        exc = ValueError()
+        result = self._callFUT(exc)
+        self.assertEqual(result.__class__, ValueError)
+
+
+class Test_document_watch_comparator(unittest.TestCase):
+    def _callFUT(self, doc1, doc2):
+        from google.cloud.firestore_v1.watch import document_watch_comparator
+
+        return document_watch_comparator(doc1, doc2)
+
+    def test_same_doc(self):
+        result = self._callFUT(1, 1)
+        self.assertEqual(result, 0)
+
+    def test_diff_doc(self):
+        self.assertRaises(AssertionError, self._callFUT, 1, 2)
+
+
+class Test_should_recover(unittest.TestCase):
+    def _callFUT(self, exception):
+        from google.cloud.firestore_v1.watch import _should_recover
+
+        return _should_recover(exception)
+
+    def test_w_unavailable(self):
+        from google.api_core.exceptions import ServiceUnavailable
+
+        exception = ServiceUnavailable("testing")
+
+        self.assertTrue(self._callFUT(exception))
+
+    def test_w_non_recoverable(self):
+        exception = ValueError("testing")
+
+        self.assertFalse(self._callFUT(exception))
+
+
+class Test_should_terminate(unittest.TestCase):
+    def _callFUT(self, exception):
+        from google.cloud.firestore_v1.watch import _should_terminate
+
+        return _should_terminate(exception)
+
+    def test_w_unavailable(self):
+        from google.api_core.exceptions import Cancelled
+
+        exception = Cancelled("testing")
+
+        self.assertTrue(self._callFUT(exception))
+
+    def test_w_non_recoverable(self):
+        exception = ValueError("testing")
+
+        self.assertFalse(self._callFUT(exception))
+
+
+class TestWatch(unittest.TestCase):
+    def _makeOne(
+        self,
+        document_reference=None,
+        firestore=None,
+        target=None,
+        comparator=None,
+        snapshot_callback=None,
+        snapshot_class=None,
+        reference_class=None,
+    ):  # pragma: NO COVER
+        from google.cloud.firestore_v1.watch import Watch
+
+        if document_reference is None:
+            document_reference = DummyDocumentReference()
+        if firestore is None:
+            firestore = DummyFirestore()
+        if target is None:
+            WATCH_TARGET_ID = 0x5079  # "Py"
+            target = {"documents": {"documents": ["/"]}, "target_id": WATCH_TARGET_ID}
+        if comparator is None:
+            comparator = self._document_watch_comparator
+        if snapshot_callback is None:
+            snapshot_callback = self._snapshot_callback
+        if snapshot_class is None:
+            snapshot_class = DummyDocumentSnapshot
+        if reference_class is None:
+            reference_class = DummyDocumentReference
+        inst = Watch(
+            document_reference,
+            firestore,
+            target,
+            comparator,
+            snapshot_callback,
+            snapshot_class,
+            reference_class,
+            BackgroundConsumer=DummyBackgroundConsumer,
+            ResumableBidiRpc=DummyRpc,
+        )
+        return inst
+
+    def setUp(self):
+        self.snapshotted = None
+
+    def _document_watch_comparator(self, doc1, doc2):  # pragma: NO COVER
+        return 0
+
+    def _snapshot_callback(self, docs, changes, read_time):
+        self.snapshotted = (docs, changes, read_time)
+
+    def test_ctor(self):
+        from google.cloud.firestore_v1.proto import firestore_pb2
+        from google.cloud.firestore_v1.watch import _should_recover
+        from google.cloud.firestore_v1.watch import _should_terminate
+
+        inst = self._makeOne()
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+        self.assertIs(inst._rpc.start_rpc, inst._api.transport.listen)
+        self.assertIs(inst._rpc.should_recover, _should_recover)
+        self.assertIs(inst._rpc.should_terminate, _should_terminate)
+        self.assertIsInstance(inst._rpc.initial_request, firestore_pb2.ListenRequest)
+        self.assertEqual(inst._rpc.metadata, DummyFirestore._rpc_metadata)
+
+    def test__on_rpc_done(self):
+        from google.cloud.firestore_v1.watch import _RPC_ERROR_THREAD_NAME
+
+        inst = self._makeOne()
+        threading = DummyThreading()
+        with mock.patch("google.cloud.firestore_v1.watch.threading", threading):
+            inst._on_rpc_done(True)
+        self.assertTrue(threading.threads[_RPC_ERROR_THREAD_NAME].started)
+
+    def test_close(self):
+        inst = self._makeOne()
+        inst.close()
+        self.assertEqual(inst._consumer, None)
+        self.assertEqual(inst._rpc, None)
+        self.assertTrue(inst._closed)
+
+    def test_close_already_closed(self):
+        inst = self._makeOne()
+        inst._closed = True
+        old_consumer = inst._consumer
+        inst.close()
+        self.assertEqual(inst._consumer, old_consumer)
+
+    def test_close_inactive(self):
+        inst = self._makeOne()
+        old_consumer = inst._consumer
+        old_consumer.is_active = False
+        inst.close()
+        self.assertEqual(old_consumer.stopped, False)
+
+    def test_unsubscribe(self):
+        inst = self._makeOne()
+        inst.unsubscribe()
+        self.assertTrue(inst._rpc is None)
+
+    def test_for_document(self):
+        from google.cloud.firestore_v1.watch import Watch
+
+        docref = DummyDocumentReference()
+        snapshot_callback = self._snapshot_callback
+        snapshot_class_instance = DummyDocumentSnapshot
+        document_reference_class_instance = DummyDocumentReference
+        modulename = "google.cloud.firestore_v1.watch"
+        with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+            with mock.patch(
+                "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+            ):
+                inst = Watch.for_document(
+                    docref,
+                    snapshot_callback,
+                    snapshot_class_instance,
+                    document_reference_class_instance,
+                )
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+
+    def test_for_query(self):
+        from google.cloud.firestore_v1.watch import Watch
+
+        snapshot_callback = self._snapshot_callback
+        snapshot_class_instance = DummyDocumentSnapshot
+        document_reference_class_instance = DummyDocumentReference
+        client = DummyFirestore()
+        parent = DummyCollection(client)
+        modulename = "google.cloud.firestore_v1.watch"
+        pb2 = DummyPb2()
+        with mock.patch("%s.firestore_pb2" % modulename, pb2):
+            with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+                with mock.patch(
+                    "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+                ):
+                    query = DummyQuery(parent=parent)
+                    inst = Watch.for_query(
+                        query,
+                        snapshot_callback,
+                        snapshot_class_instance,
+                        document_reference_class_instance,
+                    )
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+        self.assertEqual(inst._targets["query"], "dummy query target")
+
+    def test_for_query_nested(self):
+        from google.cloud.firestore_v1.watch import Watch
+
+        snapshot_callback = self._snapshot_callback
+        snapshot_class_instance = DummyDocumentSnapshot
+        document_reference_class_instance = DummyDocumentReference
+        client = DummyFirestore()
+        root = DummyCollection(client)
+        grandparent = DummyDocument("document", parent=root)
+        parent = DummyCollection(client, parent=grandparent)
+        modulename = "google.cloud.firestore_v1.watch"
+        pb2 = DummyPb2()
+        with mock.patch("%s.firestore_pb2" % modulename, pb2):
+            with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+                with mock.patch(
+                    "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+                ):
+                    query = DummyQuery(parent=parent)
+                    inst = Watch.for_query(
+                        query,
+                        snapshot_callback,
+                        snapshot_class_instance,
+                        document_reference_class_instance,
+                    )
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+        self.assertEqual(inst._targets["query"], "dummy query target")
+
+    def test_on_snapshot_target_w_none(self):
+        inst = self._makeOne()
+        proto = None
+        inst.on_snapshot(proto)  # nothing to assert, no mutations, no rtnval
+        self.assertTrue(inst._consumer is None)
+        self.assertTrue(inst._rpc is None)
+
+    def test_on_snapshot_target_no_change_no_target_ids_not_current(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        inst.on_snapshot(proto)  # nothing to assert, no mutations, no rtnval
+
+    def test_on_snapshot_target_no_change_no_target_ids_current(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change.read_time = 1
+        inst.current = True
+
+        def push(read_time, next_resume_token):
+            inst._read_time = read_time
+            inst._next_resume_token = next_resume_token
+
+        inst.push = push
+        inst.on_snapshot(proto)
+        self.assertEqual(inst._read_time, 1)
+        self.assertEqual(inst._next_resume_token, None)
+
+    def test_on_snapshot_target_add(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change.target_change_type = firestore_pb2.TargetChange.ADD
+        proto.target_change.target_ids = [1]  # not "Py"
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertEqual(str(exc.exception), "Unexpected target ID 1 sent by server")
+
+    def test_on_snapshot_target_remove(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.target_change_type = firestore_pb2.TargetChange.REMOVE
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertEqual(str(exc.exception), "Error 1:  hi")
+
+    def test_on_snapshot_target_remove_nocause(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.cause = None
+        target_change.target_change_type = firestore_pb2.TargetChange.REMOVE
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertEqual(str(exc.exception), "Error 13:  internal error")
+
+    def test_on_snapshot_target_reset(self):
+        inst = self._makeOne()
+
+        def reset():
+            inst._docs_reset = True
+
+        inst._reset_docs = reset
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.target_change_type = firestore_pb2.TargetChange.RESET
+        inst.on_snapshot(proto)
+        self.assertTrue(inst._docs_reset)
+
+    def test_on_snapshot_target_current(self):
+        inst = self._makeOne()
+        inst.current = False
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.target_change_type = firestore_pb2.TargetChange.CURRENT
+        inst.on_snapshot(proto)
+        self.assertTrue(inst.current)
+
+    def test_on_snapshot_target_unknown(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change.target_change_type = "unknown"
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertTrue(inst._consumer is None)
+        self.assertTrue(inst._rpc is None)
+        self.assertEqual(str(exc.exception), "Unknown target change type: unknown ")
+
+    def test_on_snapshot_document_change_removed(self):
+        from google.cloud.firestore_v1.watch import WATCH_TARGET_ID, ChangeType
+
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.removed_target_ids = [WATCH_TARGET_ID]
+
+        class DummyDocument:
+            name = "fred"
+
+        proto.document_change.document = DummyDocument()
+        inst.on_snapshot(proto)
+        self.assertTrue(inst.change_map["fred"] is ChangeType.REMOVED)
+
+    def test_on_snapshot_document_change_changed(self):
+        from google.cloud.firestore_v1.watch import WATCH_TARGET_ID
+
+        inst = self._makeOne()
+
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.target_ids = [WATCH_TARGET_ID]
+
+        class DummyDocument:
+            name = "fred"
+            fields = {}
+            create_time = None
+            update_time = None
+
+        proto.document_change.document = DummyDocument()
+        inst.on_snapshot(proto)
+        self.assertEqual(inst.change_map["fred"].data, {})
+
+    def test_on_snapshot_document_change_changed_docname_db_prefix(self):
+        # TODO: Verify the current behavior. The change map currently contains
+        # the db-prefixed document name and not the bare document name.
+        from google.cloud.firestore_v1.watch import WATCH_TARGET_ID
+
+        inst = self._makeOne()
+
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.target_ids = [WATCH_TARGET_ID]
+
+        class DummyDocument:
+            name = "abc://foo/documents/fred"
+            fields = {}
+            create_time = None
+            update_time = None
+
+        proto.document_change.document = DummyDocument()
+        inst._firestore._database_string = "abc://foo"
+        inst.on_snapshot(proto)
+        self.assertEqual(inst.change_map["abc://foo/documents/fred"].data, {})
+
+    def test_on_snapshot_document_change_neither_changed_nor_removed(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.target_ids = []
+
+        inst.on_snapshot(proto)
+        self.assertTrue(not inst.change_map)
+
+    def test_on_snapshot_document_removed(self):
+        from google.cloud.firestore_v1.watch import ChangeType
+
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+
+        class DummyRemove(object):
+            document = "fred"
+
+        remove = DummyRemove()
+        proto.document_remove = remove
+        proto.document_delete = ""
+        inst.on_snapshot(proto)
+        self.assertTrue(inst.change_map["fred"] is ChangeType.REMOVED)
+
+    def test_on_snapshot_filter_update(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+        proto.document_remove = ""
+        proto.document_delete = ""
+
+        class DummyFilter(object):
+            count = 999
+
+        proto.filter = DummyFilter()
+
+        def reset():
+            inst._docs_reset = True
+
+        inst._reset_docs = reset
+        inst.on_snapshot(proto)
+        self.assertTrue(inst._docs_reset)
+
+    def test_on_snapshot_filter_update_no_size_change(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+        proto.document_remove = ""
+        proto.document_delete = ""
+
+        class DummyFilter(object):
+            count = 0
+
+        proto.filter = DummyFilter()
+        inst._docs_reset = False
+
+        inst.on_snapshot(proto)
+        self.assertFalse(inst._docs_reset)
+
+    def test_on_snapshot_unknown_listen_type(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+        proto.document_remove = ""
+        proto.document_delete = ""
+        proto.filter = ""
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertTrue(
+            str(exc.exception).startswith("Unknown listen response type"),
+            str(exc.exception),
+        )
+
+    def test_push_callback_called_no_changes(self):
+        import pytz
+
+        class DummyReadTime(object):
+            seconds = 1534858278
+
+        inst = self._makeOne()
+        inst.push(DummyReadTime, "token")
+        self.assertEqual(
+            self.snapshotted,
+            ([], [], datetime.datetime.fromtimestamp(DummyReadTime.seconds, pytz.utc)),
+        )
+        self.assertTrue(inst.has_pushed)
+        self.assertEqual(inst.resume_token, "token")
+
+    def test_push_already_pushed(self):
+        class DummyReadTime(object):
+            seconds = 1534858278
+
+        inst = self._makeOne()
+        inst.has_pushed = True
+        inst.push(DummyReadTime, "token")
+        self.assertEqual(self.snapshotted, None)
+        self.assertTrue(inst.has_pushed)
+        self.assertEqual(inst.resume_token, "token")
+
+    def test__current_size_empty(self):
+        inst = self._makeOne()
+        result = inst._current_size()
+        self.assertEqual(result, 0)
+
+    def test__current_size_docmap_has_one(self):
+        inst = self._makeOne()
+        inst.doc_map["a"] = 1
+        result = inst._current_size()
+        self.assertEqual(result, 1)
+
+    def test__affects_target_target_id_None(self):
+        inst = self._makeOne()
+        self.assertTrue(inst._affects_target(None, []))
+
+    def test__affects_target_current_id_in_target_ids(self):
+        inst = self._makeOne()
+        self.assertTrue(inst._affects_target([1], 1))
+
+    def test__affects_target_current_id_not_in_target_ids(self):
+        inst = self._makeOne()
+        self.assertFalse(inst._affects_target([1], 2))
+
+    def test__extract_changes_doc_removed(self):
+        from google.cloud.firestore_v1.watch import ChangeType
+
+        inst = self._makeOne()
+        changes = {"name": ChangeType.REMOVED}
+        doc_map = {"name": True}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, (["name"], [], []))
+
+    def test__extract_changes_doc_removed_docname_not_in_docmap(self):
+        from google.cloud.firestore_v1.watch import ChangeType
+
+        inst = self._makeOne()
+        changes = {"name": ChangeType.REMOVED}
+        doc_map = {}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, ([], [], []))
+
+    def test__extract_changes_doc_updated(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        doc = Dummy()
+        snapshot = Dummy()
+        changes = {"name": snapshot}
+        doc_map = {"name": doc}
+        results = inst._extract_changes(doc_map, changes, 1)
+        self.assertEqual(results, ([], [], [snapshot]))
+        self.assertEqual(snapshot.read_time, 1)
+
+    def test__extract_changes_doc_updated_read_time_is_None(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        doc = Dummy()
+        snapshot = Dummy()
+        snapshot.read_time = None
+        changes = {"name": snapshot}
+        doc_map = {"name": doc}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, ([], [], [snapshot]))
+        self.assertEqual(snapshot.read_time, None)
+
+    def test__extract_changes_doc_added(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        snapshot = Dummy()
+        changes = {"name": snapshot}
+        doc_map = {}
+        results = inst._extract_changes(doc_map, changes, 1)
+        self.assertEqual(results, ([], [snapshot], []))
+        self.assertEqual(snapshot.read_time, 1)
+
+    def test__extract_changes_doc_added_read_time_is_None(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        snapshot = Dummy()
+        snapshot.read_time = None
+        changes = {"name": snapshot}
+        doc_map = {}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, ([], [snapshot], []))
+        self.assertEqual(snapshot.read_time, None)
+
+    def test__compute_snapshot_doctree_and_docmap_disagree_about_length(self):
+        inst = self._makeOne()
+        doc_tree = {}
+        doc_map = {None: None}
+        self.assertRaises(
+            AssertionError, inst._compute_snapshot, doc_tree, doc_map, None, None, None
+        )
+
+    def test__compute_snapshot_operation_relative_ordering(self):
+        from google.cloud.firestore_v1.watch import WatchDocTree
+
+        doc_tree = WatchDocTree()
+
+        class DummyDoc(object):
+            update_time = mock.sentinel
+
+        deleted_doc = DummyDoc()
+        added_doc = DummyDoc()
+        added_doc._document_path = "/added"
+        updated_doc = DummyDoc()
+        updated_doc._document_path = "/updated"
+        doc_tree = doc_tree.insert(deleted_doc, None)
+        doc_tree = doc_tree.insert(updated_doc, None)
+        doc_map = {"/deleted": deleted_doc, "/updated": updated_doc}
+        added_snapshot = DummyDocumentSnapshot(added_doc, None, True, None, None, None)
+        added_snapshot.reference = added_doc
+        updated_snapshot = DummyDocumentSnapshot(
+            updated_doc, None, True, None, None, None
+        )
+        updated_snapshot.reference = updated_doc
+        delete_changes = ["/deleted"]
+        add_changes = [added_snapshot]
+        update_changes = [updated_snapshot]
+        inst = self._makeOne()
+        updated_tree, updated_map, applied_changes = inst._compute_snapshot(
+            doc_tree, doc_map, delete_changes, add_changes, update_changes
+        )
+        # TODO: Verify that the assertion here is correct.
+        self.assertEqual(
+            updated_map, {"/updated": updated_snapshot, "/added": added_snapshot}
+        )
+
+    def test__compute_snapshot_modify_docs_updated_doc_no_timechange(self):
+        from google.cloud.firestore_v1.watch import WatchDocTree
+
+        doc_tree = WatchDocTree()
+
+        class DummyDoc(object):
+            pass
+
+        updated_doc_v1 = DummyDoc()
+        updated_doc_v1.update_time = 1
+        updated_doc_v1._document_path = "/updated"
+        updated_doc_v2 = DummyDoc()
+        updated_doc_v2.update_time = 1
+        updated_doc_v2._document_path = "/updated"
+        doc_tree = doc_tree.insert("/updated", updated_doc_v1)
+        doc_map = {"/updated": updated_doc_v1}
+        updated_snapshot = DummyDocumentSnapshot(
+            updated_doc_v2, None, True, None, None, 1
+        )
+        delete_changes = []
+        add_changes = []
+        update_changes = [updated_snapshot]
+        inst = self._makeOne()
+        updated_tree, updated_map, applied_changes = inst._compute_snapshot(
+            doc_tree, doc_map, delete_changes, add_changes, update_changes
+        )
+        self.assertEqual(updated_map, doc_map)  # no change
+
+    def test__compute_snapshot_deletes_w_real_comparator(self):
+        from google.cloud.firestore_v1.watch import WatchDocTree
+
+        doc_tree = WatchDocTree()
+
+        class DummyDoc(object):
+            update_time = mock.sentinel
+
+        deleted_doc_1 = DummyDoc()
+        deleted_doc_2 = DummyDoc()
+        doc_tree = doc_tree.insert(deleted_doc_1, None)
+        doc_tree = doc_tree.insert(deleted_doc_2, None)
+        doc_map = {"/deleted_1": deleted_doc_1, "/deleted_2": deleted_doc_2}
+        delete_changes = ["/deleted_1", "/deleted_2"]
+        add_changes = []
+        update_changes = []
+        inst = self._makeOne(comparator=object())
+        updated_tree, updated_map, applied_changes = inst._compute_snapshot(
+            doc_tree, doc_map, delete_changes, add_changes, update_changes
+        )
+        self.assertEqual(updated_map, {})
+
+    def test__reset_docs(self):
+        from google.cloud.firestore_v1.watch import ChangeType
+
+        inst = self._makeOne()
+        inst.change_map = {None: None}
+        from google.cloud.firestore_v1.watch import WatchDocTree
+
+        doc = DummyDocumentReference("doc")
+        doc_tree = WatchDocTree()
+        snapshot = DummyDocumentSnapshot(doc, None, True, None, None, None)
+        snapshot.reference = doc
+        doc_tree = doc_tree.insert(snapshot, None)
+        inst.doc_tree = doc_tree
+        inst._reset_docs()
+        self.assertEqual(inst.change_map, {"/doc": ChangeType.REMOVED})
+        self.assertEqual(inst.resume_token, None)
+        self.assertFalse(inst.current)
+
+
+class DummyFirestoreStub(object):
+    def Listen(self):  # pragma: NO COVER
+        pass
+
+
+class DummyFirestoreClient(object):
+    def __init__(self):
+        self.transport = mock.Mock(_stubs={"firestore_stub": DummyFirestoreStub()})
+
+
+class DummyDocumentReference(object):
+    def __init__(self, *document_path, **kw):
+        if "client" not in kw:
+            self._client = DummyFirestore()
+        else:
+            self._client = kw["client"]
+
+        self._path = document_path
+        self._document_path = "/" + "/".join(document_path)
+        self.__dict__.update(kw)
+
+
+class DummyDocument(object):
+    def __init__(self, name, parent):
+        self._name = name
+        self._parent = parent
+
+    @property
+    def _document_path(self):
+        return "{}/documents/{}".format(
+            self._parent._client._database_string, self._name
+        )
+
+
+class DummyCollection(object):
+    def __init__(self, client, parent=None):
+        self._client = client
+        self._parent = parent
+
+    def _parent_info(self):
+        if self._parent is None:
+            return "{}/documents".format(self._client._database_string), None
+        return self._parent._document_path, None
+
+
+def _compare(x, y):  # pragma: NO COVER
+    return 1
+
+
+class DummyQuery(object):
+    def __init__(self, parent):
+        self._comparator = _compare
+        self._parent = parent
+
+    @property
+    def _client(self):
+        return self._parent._client
+
+    def _to_protobuf(self):
+        return ""
+
+
+class DummyFirestore(object):
+    _firestore_api = DummyFirestoreClient()
+    _database_string = "abc://bar/"
+    _rpc_metadata = None
+
+    def document(self, *document_path):  # pragma: NO COVER
+        if len(document_path) == 1:
+            path = document_path[0].split("/")
+        else:
+            path = document_path
+
+        return DummyDocumentReference(*path, client=self)
+
+
+class DummyDocumentSnapshot(object):
+    # def __init__(self, **kw):
+    #     self.__dict__.update(kw)
+    def __init__(self, reference, data, exists, read_time, create_time, update_time):
+        self.reference = reference
+        self.data = data
+        self.exists = exists
+        self.read_time = read_time
+        self.create_time = create_time
+        self.update_time = update_time
+
+    def __str__(self):
+        return "%s-%s" % (self.reference._document_path, self.read_time)
+
+    def __hash__(self):
+        return hash(str(self))
+
+
+class DummyBackgroundConsumer(object):
+    started = False
+    stopped = False
+    is_active = True
+
+    def __init__(self, rpc, on_snapshot):
+        self._rpc = rpc
+        self.on_snapshot = on_snapshot
+
+    def start(self):
+        self.started = True
+
+    def stop(self):
+        self.stopped = True
+        self.is_active = False
+
+
+class DummyThread(object):
+    started = False
+
+    def __init__(self, name, target, kwargs):
+        self.name = name
+        self.target = target
+        self.kwargs = kwargs
+
+    def start(self):
+        self.started = True
+
+
+class DummyThreading(object):
+    def __init__(self):
+        self.threads = {}
+
+    def Thread(self, name, target, kwargs):
+        thread = DummyThread(name, target, kwargs)
+        self.threads[name] = thread
+        return thread
+
+
+class DummyRpc(object):
+    def __init__(
+        self,
+        start_rpc,
+        should_recover,
+        should_terminate=None,
+        initial_request=None,
+        metadata=None,
+    ):
+        self.start_rpc = start_rpc
+        self.should_recover = should_recover
+        self.should_terminate = should_terminate
+        self.initial_request = initial_request
+        self.metadata = metadata
+        self.closed = False
+        self.callbacks = []
+
+    def add_done_callback(self, callback):
+        self.callbacks.append(callback)
+
+    def close(self):
+        self.closed = True
+
+
+class DummyCause(object):
+    code = 1
+    message = "hi"
+
+
+class DummyChange(object):
+    def __init__(self):
+        self.target_ids = []
+        self.removed_target_ids = []
+        self.read_time = 0
+        self.target_change_type = firestore_pb2.TargetChange.NO_CHANGE
+        self.resume_token = None
+        self.cause = DummyCause()
+
+
+class DummyProto(object):
+    def __init__(self):
+        self.target_change = DummyChange()
+        self.document_change = DummyChange()
+
+
+class DummyTarget(object):
+    def QueryTarget(self, **kw):
+        self.kw = kw
+        return "dummy query target"
+
+
+class DummyPb2(object):
+
+    Target = DummyTarget()
+
+    def ListenRequest(self, **kw):
+        pass
diff --git a/firestore/tests/unit/v1/testdata/create-all-transforms.json b/firestore/tests/unit/v1/testdata/create-all-transforms.json
new file mode 100644
index 000000000000..82831624bb1f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-all-transforms.json
@@ -0,0 +1,73 @@
+{
+  "tests": [
+    {
+      "description": "create: all transforms in a single call",
+      "comment": "A document can be created with any amount of transforms.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": [\"ArrayUnion\", 1, 2, 3], \"d\": [\"ArrayRemove\", 4, 5, 6]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayremove-multi.json b/firestore/tests/unit/v1/testdata/create-arrayremove-multi.json
new file mode 100644
index 000000000000..548a9838089e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayremove-multi.json
@@ -0,0 +1,69 @@
+{
+  "tests": [
+    {
+      "description": "create: multiple ArrayRemove fields",
+      "comment": "A document can have more than one ArrayRemove field.\nSince all the ArrayRemove fields are removed, the only field in the update is \"a\".",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3], \"c\": {\"d\": [\"ArrayRemove\", 4, 5, 6]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayremove-nested.json b/firestore/tests/unit/v1/testdata/create-arrayremove-nested.json
new file mode 100644
index 000000000000..fa01bd7e0071
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayremove-nested.json
@@ -0,0 +1,53 @@
+{
+  "tests": [
+    {
+      "description": "create: nested ArrayRemove field",
+      "comment": "An ArrayRemove value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": [\"ArrayRemove\", 1, 2, 3]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayremove-noarray-nested.json b/firestore/tests/unit/v1/testdata/create-arrayremove-noarray-nested.json
new file mode 100644
index 000000000000..7d530084d448
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayremove-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: ArrayRemove cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayRemove. Firestore transforms don't support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayremove-noarray.json b/firestore/tests/unit/v1/testdata/create-arrayremove-noarray.json
new file mode 100644
index 000000000000..99aea7e35cdf
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayremove-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: ArrayRemove cannot be in an array value",
+      "comment": "ArrayRemove must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayremove-with-st.json b/firestore/tests/unit/v1/testdata/create-arrayremove-with-st.json
new file mode 100644
index 000000000000..56bdc435daff
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayremove-with-st.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayRemove\", 1, \"ServerTimestamp\", 3]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayremove.json b/firestore/tests/unit/v1/testdata/create-arrayremove.json
new file mode 100644
index 000000000000..a69be14b7b12
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayremove.json
@@ -0,0 +1,53 @@
+{
+  "tests": [
+    {
+      "description": "create: ArrayRemove with data",
+      "comment": "A key with ArrayRemove is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayunion-multi.json b/firestore/tests/unit/v1/testdata/create-arrayunion-multi.json
new file mode 100644
index 000000000000..7ca9852f48d9
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayunion-multi.json
@@ -0,0 +1,69 @@
+{
+  "tests": [
+    {
+      "description": "create: multiple ArrayUnion fields",
+      "comment": "A document can have more than one ArrayUnion field.\nSince all the ArrayUnion fields are removed, the only field in the update is \"a\".",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3], \"c\": {\"d\": [\"ArrayUnion\", 4, 5, 6]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayunion-nested.json b/firestore/tests/unit/v1/testdata/create-arrayunion-nested.json
new file mode 100644
index 000000000000..a2f20299d3be
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayunion-nested.json
@@ -0,0 +1,53 @@
+{
+  "tests": [
+    {
+      "description": "create: nested ArrayUnion field",
+      "comment": "An ArrayUnion value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": [\"ArrayUnion\", 1, 2, 3]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayunion-noarray-nested.json b/firestore/tests/unit/v1/testdata/create-arrayunion-noarray-nested.json
new file mode 100644
index 000000000000..b9ec5c01cbf1
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayunion-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: ArrayUnion cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayUnion. Firestore transforms don't support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayunion-noarray.json b/firestore/tests/unit/v1/testdata/create-arrayunion-noarray.json
new file mode 100644
index 000000000000..1b85a93c45e9
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayunion-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: ArrayUnion cannot be in an array value",
+      "comment": "ArrayUnion must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayunion-with-st.json b/firestore/tests/unit/v1/testdata/create-arrayunion-with-st.json
new file mode 100644
index 000000000000..2847f57490b8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayunion-with-st.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayUnion\", 1, \"ServerTimestamp\", 3]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-arrayunion.json b/firestore/tests/unit/v1/testdata/create-arrayunion.json
new file mode 100644
index 000000000000..26d079946645
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-arrayunion.json
@@ -0,0 +1,53 @@
+{
+  "tests": [
+    {
+      "description": "create: ArrayUnion with data",
+      "comment": "A key with ArrayUnion is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-basic.json b/firestore/tests/unit/v1/testdata/create-basic.json
new file mode 100644
index 000000000000..d67558ca13dd
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-basic.json
@@ -0,0 +1,30 @@
+{
+  "tests": [
+    {
+      "description": "create: basic",
+      "comment": "A simple call, resulting in a single update operation.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-complex.json b/firestore/tests/unit/v1/testdata/create-complex.json
new file mode 100644
index 000000000000..a01b307f672d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-complex.json
@@ -0,0 +1,63 @@
+{
+  "tests": [
+    {
+      "description": "create: complex",
+      "comment": "A call to a write method with complicated input data.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2.5], \"b\": {\"c\": [\"three\", {\"d\": true}]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "arrayValue": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "doubleValue": 2.5
+                        }
+                      ]
+                    }
+                  },
+                  "b": {
+                    "mapValue": {
+                      "fields": {
+                        "c": {
+                          "arrayValue": {
+                            "values": [
+                              {
+                                "stringValue": "three"
+                              },
+                              {
+                                "mapValue": {
+                                  "fields": {
+                                    "d": {
+                                      "booleanValue": true
+                                    }
+                                  }
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-del-noarray-nested.json b/firestore/tests/unit/v1/testdata/create-del-noarray-nested.json
new file mode 100644
index 000000000000..34d8258e1b21
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-del-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: Delete cannot be anywhere inside an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are implemented\nby turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not support\narray indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": \"Delete\"}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-del-noarray.json b/firestore/tests/unit/v1/testdata/create-del-noarray.json
new file mode 100644
index 000000000000..dde6b334b461
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-del-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: Delete cannot be in an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are\nimplemented by turning the path to the Delete sentinel into a FieldPath, and FieldPaths\ndo not support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, \"Delete\"]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-empty.json b/firestore/tests/unit/v1/testdata/create-empty.json
new file mode 100644
index 000000000000..7d9f7f009872
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-empty.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "create: creating or setting an empty map",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {}
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-nodel.json b/firestore/tests/unit/v1/testdata/create-nodel.json
new file mode 100644
index 000000000000..dd8baaf227aa
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-nodel.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: Delete cannot appear in data",
+      "comment": "The Delete sentinel cannot be used in Create, or in Set without a Merge option.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"Delete\"}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-nosplit.json b/firestore/tests/unit/v1/testdata/create-nosplit.json
new file mode 100644
index 000000000000..8807af362e70
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-nosplit.json
@@ -0,0 +1,39 @@
+{
+  "tests": [
+    {
+      "description": "create: don’t split on dots",
+      "comment": "Create and Set treat their map keys literally. They do not split on dots.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{ \"a.b\": { \"c.d\": 1 }, \"e\": 2 }",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a.b": {
+                    "mapValue": {
+                      "fields": {
+                        "c.d": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  },
+                  "e": {
+                    "integerValue": "2"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-special-chars.json b/firestore/tests/unit/v1/testdata/create-special-chars.json
new file mode 100644
index 000000000000..4080042000d5
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-special-chars.json
@@ -0,0 +1,39 @@
+{
+  "tests": [
+    {
+      "description": "create: non-alpha characters in map keys",
+      "comment": "Create and Set treat their map keys literally. They do not escape special characters.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{ \"*\": { \".\": 1 }, \"~\": 2 }",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "*": {
+                    "mapValue": {
+                      "fields": {
+                        ".": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  },
+                  "~": {
+                    "integerValue": "2"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st-alone.json b/firestore/tests/unit/v1/testdata/create-st-alone.json
new file mode 100644
index 000000000000..20c5e8ec32a3
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st-alone.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "create: ServerTimestamp alone",
+      "comment": "If the only values in the input are ServerTimestamps, then no\nupdate operation should be produced.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st-multi.json b/firestore/tests/unit/v1/testdata/create-st-multi.json
new file mode 100644
index 000000000000..89430e2b64d6
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st-multi.json
@@ -0,0 +1,45 @@
+{
+  "tests": [
+    {
+      "description": "create: multiple ServerTimestamp fields",
+      "comment": "A document can have more than one ServerTimestamp field.\nSince all the ServerTimestamp fields are removed, the only field in the update is \"a\".",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": {\"d\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st-nested.json b/firestore/tests/unit/v1/testdata/create-st-nested.json
new file mode 100644
index 000000000000..f2a3a8d1f624
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st-nested.json
@@ -0,0 +1,41 @@
+{
+  "tests": [
+    {
+      "description": "create: nested ServerTimestamp field",
+      "comment": "A ServerTimestamp value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st-noarray-nested.json b/firestore/tests/unit/v1/testdata/create-st-noarray-nested.json
new file mode 100644
index 000000000000..8660531dcc9a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: ServerTimestamp cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ServerTimestamp sentinel. Firestore transforms don't support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": \"ServerTimestamp\"}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st-noarray.json b/firestore/tests/unit/v1/testdata/create-st-noarray.json
new file mode 100644
index 000000000000..31104f25613c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "create: ServerTimestamp cannot be in an array value",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, \"ServerTimestamp\"]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st-with-empty-map.json b/firestore/tests/unit/v1/testdata/create-st-with-empty-map.json
new file mode 100644
index 000000000000..730afd154fd8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st-with-empty-map.json
@@ -0,0 +1,49 @@
+{
+  "tests": [
+    {
+      "description": "create: ServerTimestamp beside an empty map",
+      "comment": "When a ServerTimestamp and a map both reside inside a map, the\nServerTimestamp should be stripped out but the empty map should remain.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": {\"b\": {}, \"c\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "mapValue": {
+                            "fields": {}
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/create-st.json b/firestore/tests/unit/v1/testdata/create-st.json
new file mode 100644
index 000000000000..705f76ed16ac
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/create-st.json
@@ -0,0 +1,41 @@
+{
+  "tests": [
+    {
+      "description": "create: ServerTimestamp with data",
+      "comment": "A key with the special ServerTimestamp sentinel is removed from\nthe data in the update operation. Instead it appears in a separate Transform operation.\nNote that in these tests, the string \"ServerTimestamp\" should be replaced with the\nspecial ServerTimestamp value.",
+      "create": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "currentDocument": {
+                "exists": false
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/delete-exists-precond.json b/firestore/tests/unit/v1/testdata/delete-exists-precond.json
new file mode 100644
index 000000000000..174be0eccb06
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/delete-exists-precond.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "delete: delete with exists precondition",
+      "comment": "Delete supports an exists precondition.",
+      "delete": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "precondition": {
+          "exists": true
+        },
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "delete": "projects/projectID/databases/(default)/documents/C/d",
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/delete-no-precond.json b/firestore/tests/unit/v1/testdata/delete-no-precond.json
new file mode 100644
index 000000000000..96fcb39a5988
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/delete-no-precond.json
@@ -0,0 +1,19 @@
+{
+  "tests": [
+    {
+      "description": "delete: delete without precondition",
+      "comment": "An ordinary Delete call.",
+      "delete": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "delete": "projects/projectID/databases/(default)/documents/C/d"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/delete-time-precond.json b/firestore/tests/unit/v1/testdata/delete-time-precond.json
new file mode 100644
index 000000000000..160defb3fedb
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/delete-time-precond.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "delete: delete with last-update-time precondition",
+      "comment": "Delete supports a last-update-time precondition.",
+      "delete": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "precondition": {
+          "updateTime": "1970-01-01T00:00:42Z"
+        },
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "delete": "projects/projectID/databases/(default)/documents/C/d",
+              "currentDocument": {
+                "updateTime": "1970-01-01T00:00:42Z"
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/get-basic.json b/firestore/tests/unit/v1/testdata/get-basic.json
new file mode 100644
index 000000000000..0a2cd2d4a1b7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/get-basic.json
@@ -0,0 +1,14 @@
+{
+  "tests": [
+    {
+      "description": "get: get a document",
+      "comment": "A call to DocumentRef.Get",
+      "get": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "request": {
+          "name": "projects/projectID/databases/(default)/documents/C/d"
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-add-mod-del-add.json b/firestore/tests/unit/v1/testdata/listen-add-mod-del-add.json
new file mode 100644
index 000000000000..d05997332df0
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-add-mod-del-add.json
@@ -0,0 +1,206 @@
+{
+  "tests": [
+    {
+      "description": "listen: add a doc, modify it, delete it, then add it again",
+      "comment": "Various changes to a single document.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          },
+          {
+            "documentDelete": {
+              "document": "projects/projectID/databases/(default)/documents/C/d1"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:03Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:04Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          },
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "MODIFIED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:02Z"
+                }
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          },
+          {
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:02Z"
+                },
+                "newIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:03Z"
+          },
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:03Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:04Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-add-one.json b/firestore/tests/unit/v1/testdata/listen-add-one.json
new file mode 100644
index 000000000000..8223180a8765
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-add-one.json
@@ -0,0 +1,72 @@
+{
+  "tests": [
+    {
+      "description": "listen: add a doc",
+      "comment": "Snapshot with a single document.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-add-three.json b/firestore/tests/unit/v1/testdata/listen-add-three.json
new file mode 100644
index 000000000000..6ea117a7cc38
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-add-three.json
@@ -0,0 +1,156 @@
+{
+  "tests": [
+    {
+      "description": "listen: add three documents",
+      "comment": "A snapshot with three documents. The documents are sorted\nfirst by the \"a\" field, then by their path. The changes are ordered the same way.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d3",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 2
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-doc-remove.json b/firestore/tests/unit/v1/testdata/listen-doc-remove.json
new file mode 100644
index 000000000000..59af7d11a6e8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-doc-remove.json
@@ -0,0 +1,101 @@
+{
+  "tests": [
+    {
+      "description": "listen: DocumentRemove behaves like DocumentDelete",
+      "comment": "The DocumentRemove response behaves exactly like DocumentDelete.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentRemove": {
+              "document": "projects/projectID/databases/(default)/documents/C/d1"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          },
+          {
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "newIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-empty.json b/firestore/tests/unit/v1/testdata/listen-empty.json
new file mode 100644
index 000000000000..734aa41f9ee7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-empty.json
@@ -0,0 +1,27 @@
+{
+  "tests": [
+    {
+      "description": "listen: no changes; empty snapshot",
+      "comment": "There are no changes, so the snapshot should be empty.",
+      "listen": {
+        "responses": [
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "readTime": "1970-01-01T00:00:01Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-filter-nop.json b/firestore/tests/unit/v1/testdata/listen-filter-nop.json
new file mode 100644
index 000000000000..a7c09e97d99a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-filter-nop.json
@@ -0,0 +1,203 @@
+{
+  "tests": [
+    {
+      "description": "listen: Filter response with same size is a no-op",
+      "comment": "A Filter response whose count matches the size of the current\nstate (docs in last snapshot + docs added - docs deleted) is a no-op.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentDelete": {
+              "document": "projects/projectID/databases/(default)/documents/C/d1"
+            }
+          },
+          {
+            "filter": {
+              "count": 2
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          },
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": 1,
+                "newIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d3",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-multi-docs.json b/firestore/tests/unit/v1/testdata/listen-multi-docs.json
new file mode 100644
index 000000000000..fe5b0f0bbf9b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-multi-docs.json
@@ -0,0 +1,414 @@
+{
+  "tests": [
+    {
+      "description": "listen: multiple documents, added, deleted and updated",
+      "comment": "Changes should be ordered with deletes first, then additions, then mods,\neach in query order.\nOld indices refer to the immediately previous state, not the previous snapshot",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d4",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d5",
+                "fields": {
+                  "a": {
+                    "integerValue": "4"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentDelete": {
+              "document": "projects/projectID/databases/(default)/documents/C/d3"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "-1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d6",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentDelete": {
+              "document": "projects/projectID/databases/(default)/documents/C/d2"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d4",
+                "fields": {
+                  "a": {
+                    "integerValue": "-2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:04Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d4",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d3",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d4",
+                  "fields": {
+                    "a": {
+                      "integerValue": "2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 2
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 3
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          },
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d4",
+                "fields": {
+                  "a": {
+                    "integerValue": "-2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "-1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d6",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d5",
+                "fields": {
+                  "a": {
+                    "integerValue": "4"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "newIndex": -1
+              },
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d3",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "newIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d6",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 2
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d5",
+                  "fields": {
+                    "a": {
+                      "integerValue": "4"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 3
+              },
+              {
+                "kind": "MODIFIED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d4",
+                  "fields": {
+                    "a": {
+                      "integerValue": "-2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:03Z"
+                }
+              },
+              {
+                "kind": "MODIFIED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "-1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:03Z"
+                },
+                "oldIndex": 1,
+                "newIndex": 1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:04Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-nocurrent.json b/firestore/tests/unit/v1/testdata/listen-nocurrent.json
new file mode 100644
index 000000000000..158595e963df
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-nocurrent.json
@@ -0,0 +1,119 @@
+{
+  "tests": [
+    {
+      "description": "listen: no snapshot if we don't see CURRENT",
+      "comment": "If the watch state is not marked CURRENT, no snapshot is issued.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:02Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-nomod.json b/firestore/tests/unit/v1/testdata/listen-nomod.json
new file mode 100644
index 000000000000..0e454d51286a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-nomod.json
@@ -0,0 +1,123 @@
+{
+  "tests": [
+    {
+      "description": "listen: add a doc, then change it but without changing its update time",
+      "comment": "Document updates are recognized by a change in the update time, not the data.\nThis shouldn't actually happen. It is just a test of the update logic.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          },
+          {
+            "documentDelete": {
+              "document": "projects/projectID/databases/(default)/documents/C/d1"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:03Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          },
+          {
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "newIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:03Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-removed-target-ids.json b/firestore/tests/unit/v1/testdata/listen-removed-target-ids.json
new file mode 100644
index 000000000000..57c91b7bd7f5
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-removed-target-ids.json
@@ -0,0 +1,113 @@
+{
+  "tests": [
+    {
+      "description": "listen: DocumentChange with removed_target_id is like a delete.",
+      "comment": "A DocumentChange with the watch target ID in the removed_target_ids field is the\nsame as deleting a document.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "removedTargetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          },
+          {
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "newIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:02Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-reset.json b/firestore/tests/unit/v1/testdata/listen-reset.json
new file mode 100644
index 000000000000..d988a1ba9bf0
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-reset.json
@@ -0,0 +1,309 @@
+{
+  "tests": [
+    {
+      "description": "listen: RESET turns off CURRENT",
+      "comment": "A RESET message turns off the CURRENT state, and marks all documents as deleted.\n\nIf a document appeared on the stream but was never part of a snapshot (\"d3\" in this test), a reset\nwill make it disappear completely.\n\nFor a snapshot to happen at a NO_CHANGE reponse, we need to have both seen a CURRENT response, and\nhave a change from the previous snapshot. Here, after the reset, we see the same version of d2\nagain. That doesn't result in a snapshot.\n",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "RESET"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:03Z"
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "RESET"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:04Z"
+            }
+          },
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:05Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "2"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "1"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:02Z"
+                },
+                "oldIndex": -1
+              },
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          },
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "REMOVED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "2"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": 1,
+                "newIndex": -1
+              },
+              {
+                "kind": "MODIFIED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d2",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:03Z"
+                }
+              }
+            ],
+            "readTime": "1970-01-01T00:00:03Z"
+          },
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d2",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:03Z"
+              },
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d3",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:02Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d3",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:02Z"
+                },
+                "oldIndex": -1,
+                "newIndex": 1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:05Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-target-add-nop.json b/firestore/tests/unit/v1/testdata/listen-target-add-nop.json
new file mode 100644
index 000000000000..e864ea58221a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-target-add-nop.json
@@ -0,0 +1,81 @@
+{
+  "tests": [
+    {
+      "description": "listen: TargetChange_ADD is a no-op if it has the same target ID",
+      "comment": "A TargetChange_ADD response must have the same watch target ID.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "ADD",
+              "targetIds": [
+                1
+              ],
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          }
+        ],
+        "snapshots": [
+          {
+            "docs": [
+              {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              }
+            ],
+            "changes": [
+              {
+                "kind": "ADDED",
+                "doc": {
+                  "name": "projects/projectID/databases/(default)/documents/C/d1",
+                  "fields": {
+                    "a": {
+                      "integerValue": "3"
+                    }
+                  },
+                  "createTime": "1970-01-01T00:00:01Z",
+                  "updateTime": "1970-01-01T00:00:01Z"
+                },
+                "oldIndex": -1
+              }
+            ],
+            "readTime": "1970-01-01T00:00:01Z"
+          }
+        ]
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-target-add-wrong-id.json b/firestore/tests/unit/v1/testdata/listen-target-add-wrong-id.json
new file mode 100644
index 000000000000..5bd295d50572
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-target-add-wrong-id.json
@@ -0,0 +1,49 @@
+{
+  "tests": [
+    {
+      "description": "listen: TargetChange_ADD is an error if it has a different target ID",
+      "comment": "A TargetChange_ADD response must have the same watch target ID.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "ADD",
+              "targetIds": [
+                2
+              ],
+              "readTime": "1970-01-01T00:00:02Z"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/listen-target-remove.json b/firestore/tests/unit/v1/testdata/listen-target-remove.json
new file mode 100644
index 000000000000..2b11e280eb19
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/listen-target-remove.json
@@ -0,0 +1,45 @@
+{
+  "tests": [
+    {
+      "description": "listen: TargetChange_REMOVE should not appear",
+      "comment": "A TargetChange_REMOVE response should never be sent.",
+      "listen": {
+        "responses": [
+          {
+            "documentChange": {
+              "document": {
+                "name": "projects/projectID/databases/(default)/documents/C/d1",
+                "fields": {
+                  "a": {
+                    "integerValue": "3"
+                  }
+                },
+                "createTime": "1970-01-01T00:00:01Z",
+                "updateTime": "1970-01-01T00:00:01Z"
+              },
+              "targetIds": [
+                1
+              ]
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "CURRENT"
+            }
+          },
+          {
+            "targetChange": {
+              "targetChangeType": "REMOVE"
+            }
+          },
+          {
+            "targetChange": {
+              "readTime": "1970-01-01T00:00:01Z"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-arrayremove-cursor.json b/firestore/tests/unit/v1/testdata/query-arrayremove-cursor.json
new file mode 100644
index 000000000000..9e396b358cd6
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-arrayremove-cursor.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "query: ArrayRemove in cursor method",
+      "comment": "ArrayRemove is not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "[\"ArrayRemove\", 1, 2, 3]"
+              ]
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-arrayremove-where.json b/firestore/tests/unit/v1/testdata/query-arrayremove-where.json
new file mode 100644
index 000000000000..c488bba85afc
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-arrayremove-where.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: ArrayRemove in Where",
+      "comment": "ArrayRemove is not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "[\"ArrayRemove\", 1, 2, 3]"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-arrayunion-cursor.json b/firestore/tests/unit/v1/testdata/query-arrayunion-cursor.json
new file mode 100644
index 000000000000..8259d31cc75e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-arrayunion-cursor.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "query: ArrayUnion in cursor method",
+      "comment": "ArrayUnion is not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "[\"ArrayUnion\", 1, 2, 3]"
+              ]
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-arrayunion-where.json b/firestore/tests/unit/v1/testdata/query-arrayunion-where.json
new file mode 100644
index 000000000000..9f298d84e02c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-arrayunion-where.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: ArrayUnion in Where",
+      "comment": "ArrayUnion is not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "[\"ArrayUnion\", 1, 2, 3]"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-bad-NaN.json b/firestore/tests/unit/v1/testdata/query-bad-NaN.json
new file mode 100644
index 000000000000..47344309fe6b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-bad-NaN.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: where clause with non-== comparison with NaN",
+      "comment": "You can only compare NaN for equality.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "\u003c",
+              "jsonValue": "\"NaN\""
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-bad-null.json b/firestore/tests/unit/v1/testdata/query-bad-null.json
new file mode 100644
index 000000000000..340afb9332db
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-bad-null.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: where clause with non-== comparison with Null",
+      "comment": "You can only compare Null for equality.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "\u003e",
+              "jsonValue": "null"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-docsnap-order.json b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-order.json
new file mode 100644
index 000000000000..89d2696dd493
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-order.json
@@ -0,0 +1,81 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor methods with a document snapshot, existing orderBy",
+      "comment": "When a document snapshot is used, the client appends a __name__ order-by clause\nwith the direction of the last order-by clause.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "b"
+                ]
+              },
+              "direction": "desc"
+            }
+          },
+          {
+            "startAfter": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "b"
+              },
+              "direction": "DESCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "DESCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              },
+              {
+                "integerValue": "8"
+              },
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-docsnap-orderby-name.json b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-orderby-name.json
new file mode 100644
index 000000000000..189b302a0b73
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-orderby-name.json
@@ -0,0 +1,91 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor method, doc snapshot, existing orderBy __name__",
+      "comment": "If there is an existing orderBy clause on __name__,\nno changes are made to the list of orderBy clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "desc"
+            }
+          },
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "__name__"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAt": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          },
+          {
+            "endAt": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "DESCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              },
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ],
+            "before": true
+          },
+          "endAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              },
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-eq.json b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-eq.json
new file mode 100644
index 000000000000..41bc9bf1c07c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-eq.json
@@ -0,0 +1,65 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor methods with a document snapshot and an equality where clause",
+      "comment": "A Where clause using equality doesn't change the implicit orderBy clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "3"
+            }
+          },
+          {
+            "endAt": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "fieldFilter": {
+              "field": {
+                "fieldPath": "a"
+              },
+              "op": "EQUAL",
+              "value": {
+                "integerValue": "3"
+              }
+            }
+          },
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "endAt": {
+            "values": [
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-neq-orderby.json b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-neq-orderby.json
new file mode 100644
index 000000000000..ce99f786d39f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-neq-orderby.json
@@ -0,0 +1,85 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor method, doc snapshot, inequality where clause, and existing orderBy clause",
+      "comment": "If there is an OrderBy clause, the inequality Where clause does\nnot result in a new OrderBy clause. We still add a __name__ OrderBy clause",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "desc"
+            }
+          },
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "\u003c",
+              "jsonValue": "4"
+            }
+          },
+          {
+            "startAt": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "fieldFilter": {
+              "field": {
+                "fieldPath": "a"
+              },
+              "op": "LESS_THAN",
+              "value": {
+                "integerValue": "4"
+              }
+            }
+          },
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "DESCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "DESCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              },
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-neq.json b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-neq.json
new file mode 100644
index 000000000000..384bb7c2042a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-docsnap-where-neq.json
@@ -0,0 +1,75 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor method with a document snapshot and an inequality where clause",
+      "comment": "A Where clause with an inequality results in an OrderBy clause\non that clause's path, if there are no other OrderBy clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "\u003c=",
+              "jsonValue": "3"
+            }
+          },
+          {
+            "endBefore": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "fieldFilter": {
+              "field": {
+                "fieldPath": "a"
+              },
+              "op": "LESS_THAN_OR_EQUAL",
+              "value": {
+                "integerValue": "3"
+              }
+            }
+          },
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "endAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              },
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-docsnap.json b/firestore/tests/unit/v1/testdata/query-cursor-docsnap.json
new file mode 100644
index 000000000000..ea84c01729e6
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-docsnap.json
@@ -0,0 +1,44 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor methods with a document snapshot",
+      "comment": "When a document snapshot is used, the client appends a __name__ order-by clause.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "startAt": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D"
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-endbefore-empty-map.json b/firestore/tests/unit/v1/testdata/query-cursor-endbefore-empty-map.json
new file mode 100644
index 000000000000..3d02cbca2127
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-endbefore-empty-map.json
@@ -0,0 +1,55 @@
+{
+  "tests": [
+    {
+      "description": "query: EndBefore with explicit empty map",
+      "comment": "Cursor methods are allowed to use empty maps with EndBefore. It should result in an empty map in the query.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "{}"
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "endAt": {
+            "values": [
+              {
+                "mapValue": {
+                  "fields": {}
+                }
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-endbefore-empty.json b/firestore/tests/unit/v1/testdata/query-cursor-endbefore-empty.json
new file mode 100644
index 000000000000..c491dcd79882
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-endbefore-empty.json
@@ -0,0 +1,27 @@
+{
+  "tests": [
+    {
+      "description": "query: EndBefore with empty values",
+      "comment": "Cursor methods are not allowed to use empty values with EndBefore. It should result in an error.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "endBefore": {}
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-no-order.json b/firestore/tests/unit/v1/testdata/query-cursor-no-order.json
new file mode 100644
index 000000000000..45823b228483
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-no-order.json
@@ -0,0 +1,21 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor method without orderBy",
+      "comment": "If a cursor method with a list of values is provided, there must be at least as many\nexplicit orderBy clauses as values.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "startAt": {
+              "jsonValues": [
+                "2"
+              ]
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-startat-empty-map.json b/firestore/tests/unit/v1/testdata/query-cursor-startat-empty-map.json
new file mode 100644
index 000000000000..788588f76424
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-startat-empty-map.json
@@ -0,0 +1,55 @@
+{
+  "tests": [
+    {
+      "description": "query: StartAt with explicit empty map",
+      "comment": "Cursor methods are allowed to use empty maps with StartAt. It should result in an empty map in the query.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAt": {
+              "jsonValues": [
+                "{}"
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "mapValue": {
+                  "fields": {}
+                }
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-startat-empty.json b/firestore/tests/unit/v1/testdata/query-cursor-startat-empty.json
new file mode 100644
index 000000000000..c0c5a09801d4
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-startat-empty.json
@@ -0,0 +1,27 @@
+{
+  "tests": [
+    {
+      "description": "query: StartAt with empty values",
+      "comment": "Cursor methods are not allowed to use empty values with StartAt. It should result in an error.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAt": {}
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-vals-1a.json b/firestore/tests/unit/v1/testdata/query-cursor-vals-1a.json
new file mode 100644
index 000000000000..038d177f1535
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-vals-1a.json
@@ -0,0 +1,68 @@
+{
+  "tests": [
+    {
+      "description": "query: StartAt/EndBefore with values",
+      "comment": "Cursor methods take the same number of values as there are OrderBy clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAt": {
+              "jsonValues": [
+                "7"
+              ]
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "9"
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              }
+            ],
+            "before": true
+          },
+          "endAt": {
+            "values": [
+              {
+                "integerValue": "9"
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-vals-1b.json b/firestore/tests/unit/v1/testdata/query-cursor-vals-1b.json
new file mode 100644
index 000000000000..089cff93bdef
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-vals-1b.json
@@ -0,0 +1,66 @@
+{
+  "tests": [
+    {
+      "description": "query: StartAfter/EndAt with values",
+      "comment": "Cursor methods take the same number of values as there are OrderBy clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAfter": {
+              "jsonValues": [
+                "7"
+              ]
+            }
+          },
+          {
+            "endAt": {
+              "jsonValues": [
+                "9"
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              }
+            ]
+          },
+          "endAt": {
+            "values": [
+              {
+                "integerValue": "9"
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-vals-2.json b/firestore/tests/unit/v1/testdata/query-cursor-vals-2.json
new file mode 100644
index 000000000000..8554b436039a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-vals-2.json
@@ -0,0 +1,91 @@
+{
+  "tests": [
+    {
+      "description": "query: Start/End with two values",
+      "comment": "Cursor methods take the same number of values as there are OrderBy clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "b"
+                ]
+              },
+              "direction": "desc"
+            }
+          },
+          {
+            "startAt": {
+              "jsonValues": [
+                "7",
+                "8"
+              ]
+            }
+          },
+          {
+            "endAt": {
+              "jsonValues": [
+                "9",
+                "10"
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "b"
+              },
+              "direction": "DESCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "7"
+              },
+              {
+                "integerValue": "8"
+              }
+            ],
+            "before": true
+          },
+          "endAt": {
+            "values": [
+              {
+                "integerValue": "9"
+              },
+              {
+                "integerValue": "10"
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-vals-docid.json b/firestore/tests/unit/v1/testdata/query-cursor-vals-docid.json
new file mode 100644
index 000000000000..6492b3f19527
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-vals-docid.json
@@ -0,0 +1,67 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor methods with __name__",
+      "comment": "Cursor values corresponding to a __name__ field take the document path relative to the\nquery's collection.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "__name__"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAfter": {
+              "jsonValues": [
+                "\"D1\""
+              ]
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "\"D2\""
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "__name__"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D1"
+              }
+            ]
+          },
+          "endAt": {
+            "values": [
+              {
+                "referenceValue": "projects/projectID/databases/(default)/documents/C/D2"
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-cursor-vals-last-wins.json b/firestore/tests/unit/v1/testdata/query-cursor-vals-last-wins.json
new file mode 100644
index 000000000000..4a46b2f789d5
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-cursor-vals-last-wins.json
@@ -0,0 +1,82 @@
+{
+  "tests": [
+    {
+      "description": "query: cursor methods, last one wins",
+      "comment": "When multiple Start* or End* calls occur, the values of the last one are used.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "startAfter": {
+              "jsonValues": [
+                "1"
+              ]
+            }
+          },
+          {
+            "startAt": {
+              "jsonValues": [
+                "2"
+              ]
+            }
+          },
+          {
+            "endAt": {
+              "jsonValues": [
+                "3"
+              ]
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "4"
+              ]
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "ASCENDING"
+            }
+          ],
+          "startAt": {
+            "values": [
+              {
+                "integerValue": "2"
+              }
+            ],
+            "before": true
+          },
+          "endAt": {
+            "values": [
+              {
+                "integerValue": "4"
+              }
+            ],
+            "before": true
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-del-cursor.json b/firestore/tests/unit/v1/testdata/query-del-cursor.json
new file mode 100644
index 000000000000..921ace131d28
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-del-cursor.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "query: Delete in cursor method",
+      "comment": "Sentinel values are not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "\"Delete\""
+              ]
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-del-where.json b/firestore/tests/unit/v1/testdata/query-del-where.json
new file mode 100644
index 000000000000..2075e3578078
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-del-where.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: Delete in Where",
+      "comment": "Sentinel values are not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "\"Delete\""
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-invalid-operator.json b/firestore/tests/unit/v1/testdata/query-invalid-operator.json
new file mode 100644
index 000000000000..064164dc0d89
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-invalid-operator.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: invalid operator in Where clause",
+      "comment": "The !=  operator is not supported.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "!=",
+              "jsonValue": "4"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-invalid-path-order.json b/firestore/tests/unit/v1/testdata/query-invalid-path-order.json
new file mode 100644
index 000000000000..d0c5ba654f61
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-invalid-path-order.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: invalid path in OrderBy clause",
+      "comment": "The path has an empty component.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "*",
+                  ""
+                ]
+              },
+              "direction": "asc"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-invalid-path-select.json b/firestore/tests/unit/v1/testdata/query-invalid-path-select.json
new file mode 100644
index 000000000000..fa18f72817a4
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-invalid-path-select.json
@@ -0,0 +1,26 @@
+{
+  "tests": [
+    {
+      "description": "query: invalid path in Where clause",
+      "comment": "The path has an empty component.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "select": {
+              "fields": [
+                {
+                  "field": [
+                    "*",
+                    ""
+                  ]
+                }
+              ]
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-invalid-path-where.json b/firestore/tests/unit/v1/testdata/query-invalid-path-where.json
new file mode 100644
index 000000000000..a5b2add33360
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-invalid-path-where.json
@@ -0,0 +1,26 @@
+{
+  "tests": [
+    {
+      "description": "query: invalid path in Where clause",
+      "comment": "The path has an empty component.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "*",
+                  ""
+                ]
+              },
+              "op": "==",
+              "jsonValue": "4"
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-offset-limit-last-wins.json b/firestore/tests/unit/v1/testdata/query-offset-limit-last-wins.json
new file mode 100644
index 000000000000..8788826081ef
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-offset-limit-last-wins.json
@@ -0,0 +1,34 @@
+{
+  "tests": [
+    {
+      "description": "query: multiple Offset and Limit clauses",
+      "comment": "With multiple Offset or Limit clauses, the last one wins.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "offset": 2
+          },
+          {
+            "limit": 3
+          },
+          {
+            "limit": 4
+          },
+          {
+            "offset": 5
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "offset": 5,
+          "limit": 4
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-offset-limit.json b/firestore/tests/unit/v1/testdata/query-offset-limit.json
new file mode 100644
index 000000000000..3429dce0e89d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-offset-limit.json
@@ -0,0 +1,28 @@
+{
+  "tests": [
+    {
+      "description": "query: Offset and Limit clauses",
+      "comment": "Offset and Limit clauses.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "offset": 2
+          },
+          {
+            "limit": 3
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "offset": 2,
+          "limit": 3
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-order.json b/firestore/tests/unit/v1/testdata/query-order.json
new file mode 100644
index 000000000000..f6670f060db9
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-order.json
@@ -0,0 +1,54 @@
+{
+  "tests": [
+    {
+      "description": "query: basic OrderBy clauses",
+      "comment": "Multiple OrderBy clauses combine.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "b"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "desc"
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "orderBy": [
+            {
+              "field": {
+                "fieldPath": "b"
+              },
+              "direction": "ASCENDING"
+            },
+            {
+              "field": {
+                "fieldPath": "a"
+              },
+              "direction": "DESCENDING"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-select-empty.json b/firestore/tests/unit/v1/testdata/query-select-empty.json
new file mode 100644
index 000000000000..8dda741a63e8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-select-empty.json
@@ -0,0 +1,32 @@
+{
+  "tests": [
+    {
+      "description": "query: empty Select clause",
+      "comment": "An empty Select clause selects just the document ID.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "select": {
+              "fields": []
+            }
+          }
+        ],
+        "query": {
+          "select": {
+            "fields": [
+              {
+                "fieldPath": "__name__"
+              }
+            ]
+          },
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-select-last-wins.json b/firestore/tests/unit/v1/testdata/query-select-last-wins.json
new file mode 100644
index 000000000000..9df4d13d054c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-select-last-wins.json
@@ -0,0 +1,54 @@
+{
+  "tests": [
+    {
+      "description": "query: two Select clauses",
+      "comment": "The last Select clause is the only one used.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "select": {
+              "fields": [
+                {
+                  "field": [
+                    "a"
+                  ]
+                },
+                {
+                  "field": [
+                    "b"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "select": {
+              "fields": [
+                {
+                  "field": [
+                    "c"
+                  ]
+                }
+              ]
+            }
+          }
+        ],
+        "query": {
+          "select": {
+            "fields": [
+              {
+                "fieldPath": "c"
+              }
+            ]
+          },
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-select.json b/firestore/tests/unit/v1/testdata/query-select.json
new file mode 100644
index 000000000000..cfaab8f1f55a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-select.json
@@ -0,0 +1,46 @@
+{
+  "tests": [
+    {
+      "description": "query: Select clause with some fields",
+      "comment": "An ordinary Select clause.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "select": {
+              "fields": [
+                {
+                  "field": [
+                    "a"
+                  ]
+                },
+                {
+                  "field": [
+                    "b"
+                  ]
+                }
+              ]
+            }
+          }
+        ],
+        "query": {
+          "select": {
+            "fields": [
+              {
+                "fieldPath": "a"
+              },
+              {
+                "fieldPath": "b"
+              }
+            ]
+          },
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-st-cursor.json b/firestore/tests/unit/v1/testdata/query-st-cursor.json
new file mode 100644
index 000000000000..d42416ee1dd8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-st-cursor.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "query: ServerTimestamp in cursor method",
+      "comment": "Sentinel values are not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "orderBy": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "direction": "asc"
+            }
+          },
+          {
+            "endBefore": {
+              "jsonValues": [
+                "\"ServerTimestamp\""
+              ]
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-st-where.json b/firestore/tests/unit/v1/testdata/query-st-where.json
new file mode 100644
index 000000000000..1584bb9b47b5
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-st-where.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "query: ServerTimestamp in Where",
+      "comment": "Sentinel values are not permitted in queries.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "\"ServerTimestamp\""
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-where-2.json b/firestore/tests/unit/v1/testdata/query-where-2.json
new file mode 100644
index 000000000000..a78beb264642
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-where-2.json
@@ -0,0 +1,71 @@
+{
+  "tests": [
+    {
+      "description": "query: two Where clauses",
+      "comment": "Multiple Where clauses are combined into a composite filter.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "\u003e=",
+              "jsonValue": "5"
+            }
+          },
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "b"
+                ]
+              },
+              "op": "\u003c",
+              "jsonValue": "\"foo\""
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "compositeFilter": {
+              "op": "AND",
+              "filters": [
+                {
+                  "fieldFilter": {
+                    "field": {
+                      "fieldPath": "a"
+                    },
+                    "op": "GREATER_THAN_OR_EQUAL",
+                    "value": {
+                      "integerValue": "5"
+                    }
+                  }
+                },
+                {
+                  "fieldFilter": {
+                    "field": {
+                      "fieldPath": "b"
+                    },
+                    "op": "LESS_THAN",
+                    "value": {
+                      "stringValue": "foo"
+                    }
+                  }
+                }
+              ]
+            }
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-where-NaN.json b/firestore/tests/unit/v1/testdata/query-where-NaN.json
new file mode 100644
index 000000000000..c091fe5c091c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-where-NaN.json
@@ -0,0 +1,39 @@
+{
+  "tests": [
+    {
+      "description": "query: a Where clause comparing to NaN",
+      "comment": "A Where clause that tests for equality with NaN results in a unary filter.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "\"NaN\""
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "unaryFilter": {
+              "op": "IS_NAN",
+              "field": {
+                "fieldPath": "a"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-where-null.json b/firestore/tests/unit/v1/testdata/query-where-null.json
new file mode 100644
index 000000000000..6862dd97f6cf
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-where-null.json
@@ -0,0 +1,39 @@
+{
+  "tests": [
+    {
+      "description": "query: a Where clause comparing to null",
+      "comment": "A Where clause that tests for equality with null results in a unary filter.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "==",
+              "jsonValue": "null"
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "unaryFilter": {
+              "op": "IS_NULL",
+              "field": {
+                "fieldPath": "a"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-where.json b/firestore/tests/unit/v1/testdata/query-where.json
new file mode 100644
index 000000000000..b132c3030f02
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-where.json
@@ -0,0 +1,42 @@
+{
+  "tests": [
+    {
+      "description": "query: Where clause",
+      "comment": "A simple Where clause.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "where": {
+              "path": {
+                "field": [
+                  "a"
+                ]
+              },
+              "op": "\u003e",
+              "jsonValue": "5"
+            }
+          }
+        ],
+        "query": {
+          "from": [
+            {
+              "collectionId": "C"
+            }
+          ],
+          "where": {
+            "fieldFilter": {
+              "field": {
+                "fieldPath": "a"
+              },
+              "op": "GREATER_THAN",
+              "value": {
+                "integerValue": "5"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/query-wrong-collection.json b/firestore/tests/unit/v1/testdata/query-wrong-collection.json
new file mode 100644
index 000000000000..6a677f53decf
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/query-wrong-collection.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "query: doc snapshot with wrong collection in cursor method",
+      "comment": "If a document snapshot is passed to a Start*/End* method, it must be in the\nsame collection as the query.",
+      "query": {
+        "collPath": "projects/projectID/databases/(default)/documents/C",
+        "clauses": [
+          {
+            "endBefore": {
+              "docSnapshot": {
+                "path": "projects/projectID/databases/(default)/documents/C2/D",
+                "jsonData": "{\"a\": 7, \"b\": 8}"
+              }
+            }
+          }
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-all-transforms.json b/firestore/tests/unit/v1/testdata/set-all-transforms.json
new file mode 100644
index 000000000000..5c8b1373d4c0
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-all-transforms.json
@@ -0,0 +1,70 @@
+{
+  "tests": [
+    {
+      "description": "set: all transforms in a single call",
+      "comment": "A document can be created with any amount of transforms.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": [\"ArrayUnion\", 1, 2, 3], \"d\": [\"ArrayRemove\", 4, 5, 6]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayremove-multi.json b/firestore/tests/unit/v1/testdata/set-arrayremove-multi.json
new file mode 100644
index 000000000000..3ea9b0dbd8a8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayremove-multi.json
@@ -0,0 +1,66 @@
+{
+  "tests": [
+    {
+      "description": "set: multiple ArrayRemove fields",
+      "comment": "A document can have more than one ArrayRemove field.\nSince all the ArrayRemove fields are removed, the only field in the update is \"a\".",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3], \"c\": {\"d\": [\"ArrayRemove\", 4, 5, 6]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayremove-nested.json b/firestore/tests/unit/v1/testdata/set-arrayremove-nested.json
new file mode 100644
index 000000000000..4db133f2c54c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayremove-nested.json
@@ -0,0 +1,50 @@
+{
+  "tests": [
+    {
+      "description": "set: nested ArrayRemove field",
+      "comment": "An ArrayRemove value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": [\"ArrayRemove\", 1, 2, 3]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayremove-noarray-nested.json b/firestore/tests/unit/v1/testdata/set-arrayremove-noarray-nested.json
new file mode 100644
index 000000000000..96965faa660d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayremove-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: ArrayRemove cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayRemove. Firestore transforms don't support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayremove-noarray.json b/firestore/tests/unit/v1/testdata/set-arrayremove-noarray.json
new file mode 100644
index 000000000000..cd0e04468bdf
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayremove-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: ArrayRemove cannot be in an array value",
+      "comment": "ArrayRemove must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayremove-with-st.json b/firestore/tests/unit/v1/testdata/set-arrayremove-with-st.json
new file mode 100644
index 000000000000..146e41fdf439
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayremove-with-st.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayRemove\", 1, \"ServerTimestamp\", 3]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayremove.json b/firestore/tests/unit/v1/testdata/set-arrayremove.json
new file mode 100644
index 000000000000..18969ef80a5f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayremove.json
@@ -0,0 +1,50 @@
+{
+  "tests": [
+    {
+      "description": "set: ArrayRemove with data",
+      "comment": "A key with ArrayRemove is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayunion-multi.json b/firestore/tests/unit/v1/testdata/set-arrayunion-multi.json
new file mode 100644
index 000000000000..3d076397c5ff
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayunion-multi.json
@@ -0,0 +1,66 @@
+{
+  "tests": [
+    {
+      "description": "set: multiple ArrayUnion fields",
+      "comment": "A document can have more than one ArrayUnion field.\nSince all the ArrayUnion fields are removed, the only field in the update is \"a\".",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3], \"c\": {\"d\": [\"ArrayUnion\", 4, 5, 6]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayunion-nested.json b/firestore/tests/unit/v1/testdata/set-arrayunion-nested.json
new file mode 100644
index 000000000000..e265f6c61375
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayunion-nested.json
@@ -0,0 +1,50 @@
+{
+  "tests": [
+    {
+      "description": "set: nested ArrayUnion field",
+      "comment": "An ArrayUnion value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": [\"ArrayUnion\", 1, 2, 3]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayunion-noarray-nested.json b/firestore/tests/unit/v1/testdata/set-arrayunion-noarray-nested.json
new file mode 100644
index 000000000000..c9b1385e03ad
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayunion-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: ArrayUnion cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayUnion. Firestore transforms don't support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayunion-noarray.json b/firestore/tests/unit/v1/testdata/set-arrayunion-noarray.json
new file mode 100644
index 000000000000..4379578bd838
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayunion-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: ArrayUnion cannot be in an array value",
+      "comment": "ArrayUnion must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayunion-with-st.json b/firestore/tests/unit/v1/testdata/set-arrayunion-with-st.json
new file mode 100644
index 000000000000..d65436af2055
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayunion-with-st.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayUnion\", 1, \"ServerTimestamp\", 3]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-arrayunion.json b/firestore/tests/unit/v1/testdata/set-arrayunion.json
new file mode 100644
index 000000000000..856e07517327
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-arrayunion.json
@@ -0,0 +1,50 @@
+{
+  "tests": [
+    {
+      "description": "set: ArrayUnion with data",
+      "comment": "A key with ArrayUnion is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-basic.json b/firestore/tests/unit/v1/testdata/set-basic.json
new file mode 100644
index 000000000000..f322509126d3
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-basic.json
@@ -0,0 +1,27 @@
+{
+  "tests": [
+    {
+      "description": "set: basic",
+      "comment": "A simple call, resulting in a single update operation.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-complex.json b/firestore/tests/unit/v1/testdata/set-complex.json
new file mode 100644
index 000000000000..aa871ddae6c7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-complex.json
@@ -0,0 +1,60 @@
+{
+  "tests": [
+    {
+      "description": "set: complex",
+      "comment": "A call to a write method with complicated input data.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2.5], \"b\": {\"c\": [\"three\", {\"d\": true}]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "arrayValue": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "doubleValue": 2.5
+                        }
+                      ]
+                    }
+                  },
+                  "b": {
+                    "mapValue": {
+                      "fields": {
+                        "c": {
+                          "arrayValue": {
+                            "values": [
+                              {
+                                "stringValue": "three"
+                              },
+                              {
+                                "mapValue": {
+                                  "fields": {
+                                    "d": {
+                                      "booleanValue": true
+                                    }
+                                  }
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-merge-alone.json b/firestore/tests/unit/v1/testdata/set-del-merge-alone.json
new file mode 100644
index 000000000000..7a8ba5d5458c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-merge-alone.json
@@ -0,0 +1,37 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Delete with merge",
+      "comment": "A Delete sentinel can appear with a merge option. If the delete\npaths are the only ones to be merged, then no document is sent, just an update mask.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "b",
+                "c"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": \"Delete\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d"
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "b.c"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-merge.json b/firestore/tests/unit/v1/testdata/set-del-merge.json
new file mode 100644
index 000000000000..6a5759c12555
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-merge.json
@@ -0,0 +1,48 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Delete with merge",
+      "comment": "A Delete sentinel can appear with a merge option.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "a"
+              ]
+            },
+            {
+              "field": [
+                "b",
+                "c"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": \"Delete\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b.c"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-mergeall.json b/firestore/tests/unit/v1/testdata/set-del-mergeall.json
new file mode 100644
index 000000000000..6106a3e4f229
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-mergeall.json
@@ -0,0 +1,36 @@
+{
+  "tests": [
+    {
+      "description": "set: Delete with MergeAll",
+      "comment": "A Delete sentinel can appear with a mergeAll option.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "all": true
+        },
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": \"Delete\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b.c"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-noarray-nested.json b/firestore/tests/unit/v1/testdata/set-del-noarray-nested.json
new file mode 100644
index 000000000000..5a2303284e48
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: Delete cannot be anywhere inside an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are implemented\nby turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not support\narray indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": \"Delete\"}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-noarray.json b/firestore/tests/unit/v1/testdata/set-del-noarray.json
new file mode 100644
index 000000000000..dee9c75f6972
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: Delete cannot be in an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are\nimplemented by turning the path to the Delete sentinel into a FieldPath, and FieldPaths\ndo not support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, \"Delete\"]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-nomerge.json b/firestore/tests/unit/v1/testdata/set-del-nomerge.json
new file mode 100644
index 000000000000..67e3b74b8607
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-nomerge.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Delete cannot appear in an unmerged field",
+      "comment": "The client signals an error if the Delete sentinel is in the\ninput data, but not selected by a merge option, because this is most likely a programming\nbug.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "a"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": \"Delete\"}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-nonleaf.json b/firestore/tests/unit/v1/testdata/set-del-nonleaf.json
new file mode 100644
index 000000000000..67c864957ca8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-nonleaf.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Delete cannot appear as part of a merge path",
+      "comment": "If a Delete is part of the value at a merge path, then the user is\nconfused: their merge path says \"replace this entire value\" but their Delete says\n\"delete this part of the value\". This should be an error, just as if they specified Delete\nin a Set with no merge.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "h"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"h\": {\"g\": \"Delete\"}}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-del-wo-merge.json b/firestore/tests/unit/v1/testdata/set-del-wo-merge.json
new file mode 100644
index 000000000000..32d860a626df
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-del-wo-merge.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: Delete cannot appear unless a merge option is specified",
+      "comment": "Without a merge option, Set replaces the document with the input\ndata. A Delete sentinel in the data makes no sense in this case.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"Delete\"}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-empty.json b/firestore/tests/unit/v1/testdata/set-empty.json
new file mode 100644
index 000000000000..924992caf308
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-empty.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "set: creating or setting an empty map",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {}
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-merge-fp.json b/firestore/tests/unit/v1/testdata/set-merge-fp.json
new file mode 100644
index 000000000000..8a5b0faa6e2a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-merge-fp.json
@@ -0,0 +1,48 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Merge with FieldPaths",
+      "comment": "A merge with fields that use special characters.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "*",
+                "~"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"*\": {\"~\": true}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "*": {
+                    "mapValue": {
+                      "fields": {
+                        "~": {
+                          "booleanValue": true
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "`*`.`~`"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-merge-nested.json b/firestore/tests/unit/v1/testdata/set-merge-nested.json
new file mode 100644
index 000000000000..8ebec8fda277
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-merge-nested.json
@@ -0,0 +1,48 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Merge with a nested field",
+      "comment": "A merge option where the field is not at top level.\nOnly fields mentioned in the option are present in the update operation.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "h",
+                "g"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"h\": {\"g\": 4, \"f\": 5}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "h": {
+                    "mapValue": {
+                      "fields": {
+                        "g": {
+                          "integerValue": "4"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "h.g"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-merge-nonleaf.json b/firestore/tests/unit/v1/testdata/set-merge-nonleaf.json
new file mode 100644
index 000000000000..d115e12c2abd
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-merge-nonleaf.json
@@ -0,0 +1,50 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Merge field is not a leaf",
+      "comment": "If a field path is in a merge option, the value at that path\nreplaces the stored value. That is true even if the value is complex.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "h"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"h\": {\"f\": 5, \"g\": 6}, \"e\": 7}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "h": {
+                    "mapValue": {
+                      "fields": {
+                        "f": {
+                          "integerValue": "5"
+                        },
+                        "g": {
+                          "integerValue": "6"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "h"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-merge-prefix.json b/firestore/tests/unit/v1/testdata/set-merge-prefix.json
new file mode 100644
index 000000000000..a09e4db50985
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-merge-prefix.json
@@ -0,0 +1,28 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: One merge path cannot be the prefix of another",
+      "comment": "The prefix would make the other path meaningless, so this is\nprobably a programming error.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "a"
+              ]
+            },
+            {
+              "field": [
+                "a",
+                "b"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": {\"b\": 1}}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-merge-present.json b/firestore/tests/unit/v1/testdata/set-merge-present.json
new file mode 100644
index 000000000000..b501b23d03f5
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-merge-present.json
@@ -0,0 +1,27 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Merge fields must all be present in data",
+      "comment": "The client signals an error if a merge option mentions a path\nthat is not in the input data.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "b"
+              ]
+            },
+            {
+              "field": [
+                "a"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-merge.json b/firestore/tests/unit/v1/testdata/set-merge.json
new file mode 100644
index 000000000000..8ce730e840ad
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-merge.json
@@ -0,0 +1,41 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: Merge with a field",
+      "comment": "Fields in the input data but not in a merge option are pruned.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "a"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": 2}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-mergeall-empty.json b/firestore/tests/unit/v1/testdata/set-mergeall-empty.json
new file mode 100644
index 000000000000..e541ad8c9a7d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-mergeall-empty.json
@@ -0,0 +1,29 @@
+{
+  "tests": [
+    {
+      "description": "set: MergeAll can be specified with empty data.",
+      "comment": "This is a valid call that can be used to ensure a document exists.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "all": true
+        },
+        "jsonData": "{}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {}
+              },
+              "updateMask": {
+                "fieldPaths": []
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-mergeall-nested.json b/firestore/tests/unit/v1/testdata/set-mergeall-nested.json
new file mode 100644
index 000000000000..c70ec691e29a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-mergeall-nested.json
@@ -0,0 +1,45 @@
+{
+  "tests": [
+    {
+      "description": "set: MergeAll with nested fields",
+      "comment": "MergeAll with nested fields results in an update mask that\nincludes entries for all the leaf fields.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "all": true
+        },
+        "jsonData": "{\"h\": { \"g\": 3, \"f\": 4 }}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "h": {
+                    "mapValue": {
+                      "fields": {
+                        "f": {
+                          "integerValue": "4"
+                        },
+                        "g": {
+                          "integerValue": "3"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "h.f",
+                  "h.g"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-mergeall.json b/firestore/tests/unit/v1/testdata/set-mergeall.json
new file mode 100644
index 000000000000..55a2377cb51d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-mergeall.json
@@ -0,0 +1,39 @@
+{
+  "tests": [
+    {
+      "description": "set: MergeAll",
+      "comment": "The MergeAll option with a simple piece of data.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "all": true
+        },
+        "jsonData": "{\"a\": 1, \"b\": 2}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  },
+                  "b": {
+                    "integerValue": "2"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-nodel.json b/firestore/tests/unit/v1/testdata/set-nodel.json
new file mode 100644
index 000000000000..5580bc04f64c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-nodel.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: Delete cannot appear in data",
+      "comment": "The Delete sentinel cannot be used in Create, or in Set without a Merge option.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"Delete\"}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-nosplit.json b/firestore/tests/unit/v1/testdata/set-nosplit.json
new file mode 100644
index 000000000000..3866027b9b58
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-nosplit.json
@@ -0,0 +1,36 @@
+{
+  "tests": [
+    {
+      "description": "set: don’t split on dots",
+      "comment": "Create and Set treat their map keys literally. They do not split on dots.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{ \"a.b\": { \"c.d\": 1 }, \"e\": 2 }",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a.b": {
+                    "mapValue": {
+                      "fields": {
+                        "c.d": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  },
+                  "e": {
+                    "integerValue": "2"
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-special-chars.json b/firestore/tests/unit/v1/testdata/set-special-chars.json
new file mode 100644
index 000000000000..865ffcd9dc76
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-special-chars.json
@@ -0,0 +1,36 @@
+{
+  "tests": [
+    {
+      "description": "set: non-alpha characters in map keys",
+      "comment": "Create and Set treat their map keys literally. They do not escape special characters.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{ \"*\": { \".\": 1 }, \"~\": 2 }",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "*": {
+                    "mapValue": {
+                      "fields": {
+                        ".": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  },
+                  "~": {
+                    "integerValue": "2"
+                  }
+                }
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-alone-mergeall.json b/firestore/tests/unit/v1/testdata/set-st-alone-mergeall.json
new file mode 100644
index 000000000000..d95bf0973b79
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-alone-mergeall.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp alone with MergeAll",
+      "comment": "If the only values in the input are ServerTimestamps, then no\nupdate operation should be produced.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "all": true
+        },
+        "jsonData": "{\"a\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-alone.json b/firestore/tests/unit/v1/testdata/set-st-alone.json
new file mode 100644
index 000000000000..3fe931394b0e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-alone.json
@@ -0,0 +1,34 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp alone",
+      "comment": "If the only values in the input are ServerTimestamps, then\nan update operation with an empty map should be produced.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {}
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-merge-both.json b/firestore/tests/unit/v1/testdata/set-st-merge-both.json
new file mode 100644
index 000000000000..a39ada55f738
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-merge-both.json
@@ -0,0 +1,57 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: ServerTimestamp with Merge of both fields",
+      "comment": "Just as when no merge option is specified, ServerTimestamp\nsentinel values are removed from the data in the update operation and become\ntransforms.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "a"
+              ]
+            },
+            {
+              "field": [
+                "b"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-merge-nonleaf-alone.json b/firestore/tests/unit/v1/testdata/set-st-merge-nonleaf-alone.json
new file mode 100644
index 000000000000..4193b00ea683
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-merge-nonleaf-alone.json
@@ -0,0 +1,47 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: non-leaf merge field with ServerTimestamp alone",
+      "comment": "If a field path is in a merge option, the value at that path\nreplaces the stored value. If the value has only ServerTimestamps, they become transforms\nand we clear the value by including the field path in the update mask.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "h"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"h\": {\"g\": \"ServerTimestamp\"}, \"e\": 7}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d"
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "h"
+                ]
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "h.g",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-merge-nonleaf.json b/firestore/tests/unit/v1/testdata/set-st-merge-nonleaf.json
new file mode 100644
index 000000000000..5e91d663b8c6
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-merge-nonleaf.json
@@ -0,0 +1,58 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: non-leaf merge field with ServerTimestamp",
+      "comment": "If a field path is in a merge option, the value at that path\nreplaces the stored value, and ServerTimestamps inside that value become transforms\nas usual.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "h"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"h\": {\"f\": 5, \"g\": \"ServerTimestamp\"}, \"e\": 7}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "h": {
+                    "mapValue": {
+                      "fields": {
+                        "f": {
+                          "integerValue": "5"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "h"
+                ]
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "h.g",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-merge-nowrite.json b/firestore/tests/unit/v1/testdata/set-st-merge-nowrite.json
new file mode 100644
index 000000000000..08fa8b52f54b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-merge-nowrite.json
@@ -0,0 +1,37 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: If no ordinary values in Merge, no write",
+      "comment": "If all the fields in the merge option have ServerTimestamp\nvalues, then no update operation is produced, only a transform.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "b"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-mergeall.json b/firestore/tests/unit/v1/testdata/set-st-mergeall.json
new file mode 100644
index 000000000000..26883c03820d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-mergeall.json
@@ -0,0 +1,46 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp with MergeAll",
+      "comment": "Just as when no merge option is specified, ServerTimestamp\nsentinel values are removed from the data in the update operation and become\ntransforms.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "all": true
+        },
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-multi.json b/firestore/tests/unit/v1/testdata/set-st-multi.json
new file mode 100644
index 000000000000..23c06f4976f7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-multi.json
@@ -0,0 +1,42 @@
+{
+  "tests": [
+    {
+      "description": "set: multiple ServerTimestamp fields",
+      "comment": "A document can have more than one ServerTimestamp field.\nSince all the ServerTimestamp fields are removed, the only field in the update is \"a\".",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": {\"d\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-nested.json b/firestore/tests/unit/v1/testdata/set-st-nested.json
new file mode 100644
index 000000000000..5c94c33f943d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-nested.json
@@ -0,0 +1,38 @@
+{
+  "tests": [
+    {
+      "description": "set: nested ServerTimestamp field",
+      "comment": "A ServerTimestamp value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-noarray-nested.json b/firestore/tests/unit/v1/testdata/set-st-noarray-nested.json
new file mode 100644
index 000000000000..5ad6a50897ba
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ServerTimestamp sentinel. Firestore transforms don't support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": \"ServerTimestamp\"}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-noarray.json b/firestore/tests/unit/v1/testdata/set-st-noarray.json
new file mode 100644
index 000000000000..76a2881cb61b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp cannot be in an array value",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, \"ServerTimestamp\"]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-nomerge.json b/firestore/tests/unit/v1/testdata/set-st-nomerge.json
new file mode 100644
index 000000000000..0523ed74fb44
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-nomerge.json
@@ -0,0 +1,41 @@
+{
+  "tests": [
+    {
+      "description": "set-merge: If is ServerTimestamp not in Merge, no transform",
+      "comment": "If the ServerTimestamp value is not mentioned in a merge option,\nthen it is pruned from the data but does not result in a transform.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "option": {
+          "fields": [
+            {
+              "field": [
+                "a"
+              ]
+            }
+          ]
+        },
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st-with-empty-map.json b/firestore/tests/unit/v1/testdata/set-st-with-empty-map.json
new file mode 100644
index 000000000000..063c94a0e6cd
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st-with-empty-map.json
@@ -0,0 +1,46 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp beside an empty map",
+      "comment": "When a ServerTimestamp and a map both reside inside a map, the\nServerTimestamp should be stripped out but the empty map should remain.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": {\"b\": {}, \"c\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "mapValue": {
+                            "fields": {}
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/set-st.json b/firestore/tests/unit/v1/testdata/set-st.json
new file mode 100644
index 000000000000..42f2b14f1c7f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/set-st.json
@@ -0,0 +1,38 @@
+{
+  "tests": [
+    {
+      "description": "set: ServerTimestamp with data",
+      "comment": "A key with the special ServerTimestamp sentinel is removed from\nthe data in the update operation. Instead it appears in a separate Transform operation.\nNote that in these tests, the string \"ServerTimestamp\" should be replaced with the\nspecial ServerTimestamp value.",
+      "set": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-all-transforms.json b/firestore/tests/unit/v1/testdata/update-all-transforms.json
new file mode 100644
index 000000000000..6f6a725df0fc
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-all-transforms.json
@@ -0,0 +1,78 @@
+{
+  "tests": [
+    {
+      "description": "update: all transforms in a single call",
+      "comment": "A document can be created with any amount of transforms.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": [\"ArrayUnion\", 1, 2, 3], \"d\": [\"ArrayRemove\", 4, 5, 6]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove-alone.json b/firestore/tests/unit/v1/testdata/update-arrayremove-alone.json
new file mode 100644
index 000000000000..86fc8802e52e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove-alone.json
@@ -0,0 +1,43 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayRemove alone",
+      "comment": "If the only values in the input are ArrayRemove, then no\nupdate operation should be produced.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayRemove\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove-multi.json b/firestore/tests/unit/v1/testdata/update-arrayremove-multi.json
new file mode 100644
index 000000000000..df880f6792b9
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove-multi.json
@@ -0,0 +1,75 @@
+{
+  "tests": [
+    {
+      "description": "update: multiple ArrayRemove fields",
+      "comment": "A document can have more than one ArrayRemove field.\nSince all the ArrayRemove fields are removed, the only field in the update is \"a\".",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3], \"c\": {\"d\": [\"ArrayRemove\", 4, 5, 6]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove-nested.json b/firestore/tests/unit/v1/testdata/update-arrayremove-nested.json
new file mode 100644
index 000000000000..28d59aff661f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove-nested.json
@@ -0,0 +1,59 @@
+{
+  "tests": [
+    {
+      "description": "update: nested ArrayRemove field",
+      "comment": "An ArrayRemove value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": [\"ArrayRemove\", 1, 2, 3]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-arrayremove-noarray-nested.json
new file mode 100644
index 000000000000..842c5fe3240c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayRemove cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayRemove. Firestore transforms don't support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove-noarray.json b/firestore/tests/unit/v1/testdata/update-arrayremove-noarray.json
new file mode 100644
index 000000000000..0a371f055488
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayRemove cannot be in an array value",
+      "comment": "ArrayRemove must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove-with-st.json b/firestore/tests/unit/v1/testdata/update-arrayremove-with-st.json
new file mode 100644
index 000000000000..9d110de9caea
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove-with-st.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayRemove\", 1, \"ServerTimestamp\", 3]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayremove.json b/firestore/tests/unit/v1/testdata/update-arrayremove.json
new file mode 100644
index 000000000000..d925704db63b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayremove.json
@@ -0,0 +1,58 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayRemove with data",
+      "comment": "A key with ArrayRemove is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion-alone.json b/firestore/tests/unit/v1/testdata/update-arrayunion-alone.json
new file mode 100644
index 000000000000..757ea48c3b7f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion-alone.json
@@ -0,0 +1,43 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayUnion alone",
+      "comment": "If the only values in the input are ArrayUnion, then no\nupdate operation should be produced.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayUnion\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion-multi.json b/firestore/tests/unit/v1/testdata/update-arrayunion-multi.json
new file mode 100644
index 000000000000..3aafcd0f3545
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion-multi.json
@@ -0,0 +1,75 @@
+{
+  "tests": [
+    {
+      "description": "update: multiple ArrayUnion fields",
+      "comment": "A document can have more than one ArrayUnion field.\nSince all the ArrayUnion fields are removed, the only field in the update is \"a\".",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3], \"c\": {\"d\": [\"ArrayUnion\", 4, 5, 6]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion-nested.json b/firestore/tests/unit/v1/testdata/update-arrayunion-nested.json
new file mode 100644
index 000000000000..f2bf3770dc77
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion-nested.json
@@ -0,0 +1,59 @@
+{
+  "tests": [
+    {
+      "description": "update: nested ArrayUnion field",
+      "comment": "An ArrayUnion value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": [\"ArrayUnion\", 1, 2, 3]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-arrayunion-noarray-nested.json
new file mode 100644
index 000000000000..08745a08b07b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayUnion cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayUnion. Firestore transforms don't support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion-noarray.json b/firestore/tests/unit/v1/testdata/update-arrayunion-noarray.json
new file mode 100644
index 000000000000..284f42800eba
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayUnion cannot be in an array value",
+      "comment": "ArrayUnion must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion-with-st.json b/firestore/tests/unit/v1/testdata/update-arrayunion-with-st.json
new file mode 100644
index 000000000000..1c47591e29bc
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion-with-st.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [\"ArrayUnion\", 1, \"ServerTimestamp\", 3]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-arrayunion.json b/firestore/tests/unit/v1/testdata/update-arrayunion.json
new file mode 100644
index 000000000000..60192c9f8c0b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-arrayunion.json
@@ -0,0 +1,58 @@
+{
+  "tests": [
+    {
+      "description": "update: ArrayUnion with data",
+      "comment": "A key with ArrayUnion is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3]}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-badchar.json b/firestore/tests/unit/v1/testdata/update-badchar.json
new file mode 100644
index 000000000000..7d5e6e4f07bc
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-badchar.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: invalid character",
+      "comment": "The keys of the data given to Update are interpreted, unlike those of Create and Set. They cannot contain special characters.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a~b\": 1}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-basic.json b/firestore/tests/unit/v1/testdata/update-basic.json
new file mode 100644
index 000000000000..f864247427e8
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-basic.json
@@ -0,0 +1,35 @@
+{
+  "tests": [
+    {
+      "description": "update: basic",
+      "comment": "A simple call, resulting in a single update operation.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-complex.json b/firestore/tests/unit/v1/testdata/update-complex.json
new file mode 100644
index 000000000000..ddf8373367c4
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-complex.json
@@ -0,0 +1,69 @@
+{
+  "tests": [
+    {
+      "description": "update: complex",
+      "comment": "A call to a write method with complicated input data.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2.5], \"b\": {\"c\": [\"three\", {\"d\": true}]}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "arrayValue": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "doubleValue": 2.5
+                        }
+                      ]
+                    }
+                  },
+                  "b": {
+                    "mapValue": {
+                      "fields": {
+                        "c": {
+                          "arrayValue": {
+                            "values": [
+                              {
+                                "stringValue": "three"
+                              },
+                              {
+                                "mapValue": {
+                                  "fields": {
+                                    "d": {
+                                      "booleanValue": true
+                                    }
+                                  }
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-del-alone.json b/firestore/tests/unit/v1/testdata/update-del-alone.json
new file mode 100644
index 000000000000..45598ab40220
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-del-alone.json
@@ -0,0 +1,30 @@
+{
+  "tests": [
+    {
+      "description": "update: Delete alone",
+      "comment": "If the input data consists solely of Deletes, then the update\noperation has no map, just an update mask.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": \"Delete\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d"
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-del-dot.json b/firestore/tests/unit/v1/testdata/update-del-dot.json
new file mode 100644
index 000000000000..44f36b0c3e85
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-del-dot.json
@@ -0,0 +1,46 @@
+{
+  "tests": [
+    {
+      "description": "update: Delete with a dotted field",
+      "comment": "After expanding top-level dotted fields, fields with Delete\nvalues are pruned from the output data, but appear in the update mask.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b.c\": \"Delete\", \"b.d\": 2}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  },
+                  "b": {
+                    "mapValue": {
+                      "fields": {
+                        "d": {
+                          "integerValue": "2"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b.c",
+                  "b.d"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-del-nested.json b/firestore/tests/unit/v1/testdata/update-del-nested.json
new file mode 100644
index 000000000000..18d08f3f004e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-del-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: Delete cannot be nested",
+      "comment": "The Delete sentinel must be the value of a top-level key.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": {\"b\": \"Delete\"}}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-del-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-del-noarray-nested.json
new file mode 100644
index 000000000000..025cbed0dfb3
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-del-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: Delete cannot be anywhere inside an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are implemented\nby turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not support\narray indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": \"Delete\"}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-del-noarray.json b/firestore/tests/unit/v1/testdata/update-del-noarray.json
new file mode 100644
index 000000000000..dce3806f2c35
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-del-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: Delete cannot be in an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are\nimplemented by turning the path to the Delete sentinel into a FieldPath, and FieldPaths\ndo not support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, \"Delete\"]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-del.json b/firestore/tests/unit/v1/testdata/update-del.json
new file mode 100644
index 000000000000..26a6a1bc7e43
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-del.json
@@ -0,0 +1,36 @@
+{
+  "tests": [
+    {
+      "description": "update: Delete",
+      "comment": "If a field's value is the Delete sentinel, then it doesn't appear\nin the update data, but does in the mask.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"Delete\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-exists-precond.json b/firestore/tests/unit/v1/testdata/update-exists-precond.json
new file mode 100644
index 000000000000..bdbe274b4c23
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-exists-precond.json
@@ -0,0 +1,16 @@
+{
+  "tests": [
+    {
+      "description": "update: Exists precondition is invalid",
+      "comment": "The Update method does not support an explicit exists precondition.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "precondition": {
+          "exists": true
+        },
+        "jsonData": "{\"a\": 1}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-fp-empty-component.json b/firestore/tests/unit/v1/testdata/update-fp-empty-component.json
new file mode 100644
index 000000000000..50274e49ffe2
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-fp-empty-component.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: empty field path component",
+      "comment": "Empty fields are not allowed.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a..b\": 1}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-nested-transform-and-nested-value.json b/firestore/tests/unit/v1/testdata/update-nested-transform-and-nested-value.json
new file mode 100644
index 000000000000..ff7bfc6ee944
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-nested-transform-and-nested-value.json
@@ -0,0 +1,52 @@
+{
+  "tests": [
+    {
+      "description": "update: Nested transforms should not affect the field mask, even\nwhen there are other values that do. Transforms should only affect the\nDocumentTransform_FieldTransform list.",
+      "comment": "For updates, top-level paths in json-like map inputs\nare split on the dot. That is, an input {\"a.b.c\": 7} results in an update to\nfield c of object b of object a with value 7. In order to specify this behavior,\nthe update must use a fieldmask \"a.b.c\". However, fieldmasks are only used for\nconcrete values - transforms are separately encoded in a\nDocumentTransform_FieldTransform array.\n\nThis test exercises a bug found in python (https://github.com/googleapis/google-cloud-python/issues/7215)\nin which nested transforms ({\"a.c\": \"ServerTimestamp\"}) next to nested values\n({\"a.b\": 7}) incorrectly caused the fieldmask \"a\" to be set, which has the\neffect of wiping out all data in \"a\" other than what was specified in the\njson-like input.\n\nInstead, as this test specifies, transforms should not affect the fieldmask.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a.b\": 7, \"a.c\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "integerValue": "7"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a.b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-no-paths.json b/firestore/tests/unit/v1/testdata/update-no-paths.json
new file mode 100644
index 000000000000..6cfbc01dce20
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-no-paths.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: no paths",
+      "comment": "It is a client-side error to call Update with empty data.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-all-transforms.json b/firestore/tests/unit/v1/testdata/update-paths-all-transforms.json
new file mode 100644
index 000000000000..01a4c1143dc1
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-all-transforms.json
@@ -0,0 +1,105 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: all transforms in a single call",
+      "comment": "A document can be created with any amount of transforms.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "c"
+            ]
+          },
+          {
+            "field": [
+              "d"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "\"ServerTimestamp\"",
+          "[\"ArrayUnion\", 1, 2, 3]",
+          "[\"ArrayRemove\", 4, 5, 6]"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove-alone.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-alone.json
new file mode 100644
index 000000000000..9bc8a1440137
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-alone.json
@@ -0,0 +1,52 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayRemove alone",
+      "comment": "If the only values in the input are ArrayRemove, then no\nupdate operation should be produced.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[\"ArrayRemove\", 1, 2, 3]"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove-multi.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-multi.json
new file mode 100644
index 000000000000..9a8547120e3a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-multi.json
@@ -0,0 +1,96 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: multiple ArrayRemove fields",
+      "comment": "A document can have more than one ArrayRemove field.\nSince all the ArrayRemove fields are removed, the only field in the update is \"a\".",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "c"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "[\"ArrayRemove\", 1, 2, 3]",
+          "{\"d\": [\"ArrayRemove\", 4, 5, 6]}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove-nested.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-nested.json
new file mode 100644
index 000000000000..e7f952ec3423
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-nested.json
@@ -0,0 +1,74 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: nested ArrayRemove field",
+      "comment": "An ArrayRemove value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "{\"c\": [\"ArrayRemove\", 1, 2, 3]}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-noarray-nested.json
new file mode 100644
index 000000000000..b669e870cd31
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-noarray-nested.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayRemove cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayRemove. Firestore transforms don't support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove-noarray.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-noarray.json
new file mode 100644
index 000000000000..ff50e11e4fb2
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-noarray.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayRemove cannot be in an array value",
+      "comment": "ArrayRemove must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, 2, [\"ArrayRemove\", 1, 2, 3]]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove-with-st.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-with-st.json
new file mode 100644
index 000000000000..d27d26e44664
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove-with-st.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[\"ArrayRemove\", 1, \"ServerTimestamp\", 3]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayremove.json b/firestore/tests/unit/v1/testdata/update-paths-arrayremove.json
new file mode 100644
index 000000000000..673a2ca2c1af
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayremove.json
@@ -0,0 +1,73 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayRemove with data",
+      "comment": "A key with ArrayRemove is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "[\"ArrayRemove\", 1, 2, 3]"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "removeAllFromArray": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion-alone.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-alone.json
new file mode 100644
index 000000000000..81e1e9771ab7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-alone.json
@@ -0,0 +1,52 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayUnion alone",
+      "comment": "If the only values in the input are ArrayUnion, then no\nupdate operation should be produced.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[\"ArrayUnion\", 1, 2, 3]"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion-multi.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-multi.json
new file mode 100644
index 000000000000..ef421bdad180
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-multi.json
@@ -0,0 +1,96 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: multiple ArrayUnion fields",
+      "comment": "A document can have more than one ArrayUnion field.\nSince all the ArrayUnion fields are removed, the only field in the update is \"a\".",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "c"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "[\"ArrayUnion\", 1, 2, 3]",
+          "{\"d\": [\"ArrayUnion\", 4, 5, 6]}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "4"
+                        },
+                        {
+                          "integerValue": "5"
+                        },
+                        {
+                          "integerValue": "6"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion-nested.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-nested.json
new file mode 100644
index 000000000000..2d73527a4048
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-nested.json
@@ -0,0 +1,74 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: nested ArrayUnion field",
+      "comment": "An ArrayUnion value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "{\"c\": [\"ArrayUnion\", 1, 2, 3]}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-noarray-nested.json
new file mode 100644
index 000000000000..0e8a634a4417
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-noarray-nested.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayUnion cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ArrayUnion. Firestore transforms don't support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion-noarray.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-noarray.json
new file mode 100644
index 000000000000..ce45841888fa
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-noarray.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayUnion cannot be in an array value",
+      "comment": "ArrayUnion must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, 2, [\"ArrayRemove\", 1, 2, 3]]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion-with-st.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-with-st.json
new file mode 100644
index 000000000000..c0a4204182cd
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion-with-st.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: The ServerTimestamp sentinel cannot be in an ArrayUnion",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. It may\nnot appear in an ArrayUnion.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[\"ArrayUnion\", 1, \"ServerTimestamp\", 3]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-arrayunion.json b/firestore/tests/unit/v1/testdata/update-paths-arrayunion.json
new file mode 100644
index 000000000000..1401993d059d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-arrayunion.json
@@ -0,0 +1,73 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ArrayUnion with data",
+      "comment": "A key with ArrayUnion is removed from the data in the update \noperation. Instead it appears in a separate Transform operation.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "[\"ArrayUnion\", 1, 2, 3]"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "appendMissingElements": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "integerValue": "2"
+                        },
+                        {
+                          "integerValue": "3"
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-basic.json b/firestore/tests/unit/v1/testdata/update-paths-basic.json
new file mode 100644
index 000000000000..bf1164ac410d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-basic.json
@@ -0,0 +1,44 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: basic",
+      "comment": "A simple call, resulting in a single update operation.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-complex.json b/firestore/tests/unit/v1/testdata/update-paths-complex.json
new file mode 100644
index 000000000000..2f3faa7846c6
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-complex.json
@@ -0,0 +1,84 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: complex",
+      "comment": "A call to a write method with complicated input data.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, 2.5]",
+          "{\"c\": [\"three\", {\"d\": true}]}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "arrayValue": {
+                      "values": [
+                        {
+                          "integerValue": "1"
+                        },
+                        {
+                          "doubleValue": 2.5
+                        }
+                      ]
+                    }
+                  },
+                  "b": {
+                    "mapValue": {
+                      "fields": {
+                        "c": {
+                          "arrayValue": {
+                            "values": [
+                              {
+                                "stringValue": "three"
+                              },
+                              {
+                                "mapValue": {
+                                  "fields": {
+                                    "d": {
+                                      "booleanValue": true
+                                    }
+                                  }
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-del-alone.json b/firestore/tests/unit/v1/testdata/update-paths-del-alone.json
new file mode 100644
index 000000000000..e3368c86c376
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-del-alone.json
@@ -0,0 +1,39 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Delete alone",
+      "comment": "If the input data consists solely of Deletes, then the update\noperation has no map, just an update mask.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "\"Delete\""
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d"
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-del-nested.json b/firestore/tests/unit/v1/testdata/update-paths-del-nested.json
new file mode 100644
index 000000000000..07f9f405ea40
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-del-nested.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Delete cannot be nested",
+      "comment": "The Delete sentinel must be the value of a top-level key.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "{\"b\": \"Delete\"}"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-del-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-paths-del-noarray-nested.json
new file mode 100644
index 000000000000..a74c0aeb570c
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-del-noarray-nested.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Delete cannot be anywhere inside an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are implemented\nby turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not support\narray indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, {\"b\": \"Delete\"}]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-del-noarray.json b/firestore/tests/unit/v1/testdata/update-paths-del-noarray.json
new file mode 100644
index 000000000000..fb6d00b72400
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-del-noarray.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Delete cannot be in an array value",
+      "comment": "The Delete sentinel must be the value of a field. Deletes are\nimplemented by turning the path to the Delete sentinel into a FieldPath, and FieldPaths\ndo not support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, 2, \"Delete\"]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-del.json b/firestore/tests/unit/v1/testdata/update-paths-del.json
new file mode 100644
index 000000000000..cb5f6bedf41e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-del.json
@@ -0,0 +1,51 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Delete",
+      "comment": "If a field's value is the Delete sentinel, then it doesn't appear\nin the update data, but does in the mask.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "\"Delete\""
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-exists-precond.json b/firestore/tests/unit/v1/testdata/update-paths-exists-precond.json
new file mode 100644
index 000000000000..d495db033010
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-exists-precond.json
@@ -0,0 +1,25 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Exists precondition is invalid",
+      "comment": "The Update method does not support an explicit exists precondition.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "precondition": {
+          "exists": true
+        },
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-del.json b/firestore/tests/unit/v1/testdata/update-paths-fp-del.json
new file mode 100644
index 000000000000..95b787a91363
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-del.json
@@ -0,0 +1,59 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: field paths with delete",
+      "comment": "If one nested field is deleted, and another isn't, preserve the second.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "foo",
+              "bar"
+            ]
+          },
+          {
+            "field": [
+              "foo",
+              "delete"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "\"Delete\""
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "foo": {
+                    "mapValue": {
+                      "fields": {
+                        "bar": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "foo.bar",
+                  "foo.delete"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-dup-transforms.json b/firestore/tests/unit/v1/testdata/update-paths-fp-dup-transforms.json
new file mode 100644
index 000000000000..aff02a8d2036
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-dup-transforms.json
@@ -0,0 +1,34 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: duplicate field path with only transforms",
+      "comment": "The same field cannot occur more than once, even if all the operations are transforms.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[\"ArrayUnion\", 1, 2, 3]",
+          "\"ServerTimestamp\"",
+          "[\"ArrayUnion\", 4, 5, 6]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-dup.json b/firestore/tests/unit/v1/testdata/update-paths-fp-dup.json
new file mode 100644
index 000000000000..71bf4d54a2a4
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-dup.json
@@ -0,0 +1,34 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: duplicate field path",
+      "comment": "The same field cannot occur more than once.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "2",
+          "3"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-empty-component.json b/firestore/tests/unit/v1/testdata/update-paths-fp-empty-component.json
new file mode 100644
index 000000000000..161e9f6eff9e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-empty-component.json
@@ -0,0 +1,23 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: empty field path component",
+      "comment": "Empty fields are not allowed.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "*",
+              ""
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-empty.json b/firestore/tests/unit/v1/testdata/update-paths-fp-empty.json
new file mode 100644
index 000000000000..9424da130565
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-empty.json
@@ -0,0 +1,20 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: empty field path",
+      "comment": "A FieldPath of length zero is invalid.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": []
+          }
+        ],
+        "jsonValues": [
+          "1"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-multi.json b/firestore/tests/unit/v1/testdata/update-paths-fp-multi.json
new file mode 100644
index 000000000000..a0afd38b8f26
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-multi.json
@@ -0,0 +1,51 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: multiple-element field path",
+      "comment": "The UpdatePaths or equivalent method takes a list of FieldPaths.\nEach FieldPath is a sequence of uninterpreted path components.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a",
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a.b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-fp-nosplit.json b/firestore/tests/unit/v1/testdata/update-paths-fp-nosplit.json
new file mode 100644
index 000000000000..23e9ddc9d3ad
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-fp-nosplit.json
@@ -0,0 +1,57 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: FieldPath elements are not split on dots",
+      "comment": "FieldPath components are not split on dots.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a.b",
+              "f.g"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "{\"n.o\": 7}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a.b": {
+                    "mapValue": {
+                      "fields": {
+                        "f.g": {
+                          "mapValue": {
+                            "fields": {
+                              "n.o": {
+                                "integerValue": "7"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "`a.b`.`f.g`"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-nested-transform-and-nested-value.json b/firestore/tests/unit/v1/testdata/update-paths-nested-transform-and-nested-value.json
new file mode 100644
index 000000000000..927d783aee46
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-nested-transform-and-nested-value.json
@@ -0,0 +1,69 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: Nested transforms should not affect the field mask, even\nwhen there are other values that do. Transforms should only affect the\nDocumentTransform_FieldTransform list.",
+      "comment": "For updates, top-level paths in json-like map inputs\nare split on the dot. That is, an input {\"a.b.c\": 7} results in an update to\nfield c of object b of object a with value 7. In order to specify this behavior,\nthe update must use a fieldmask \"a.b.c\". However, fieldmasks are only used for\nconcrete values - transforms are separately encoded in a\nDocumentTransform_FieldTransform array.\n\nThis test exercises a bug found in python (https://github.com/googleapis/google-cloud-python/issues/7215)\nin which nested transforms ({\"a.c\": \"ServerTimestamp\"}) next to nested values\n({\"a.b\": 7}) incorrectly caused the fieldmask \"a\" to be set, which has the\neffect of wiping out all data in \"a\" other than what was specified in the\njson-like input.\n\nInstead, as this test specifies, transforms should not affect the fieldmask.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a",
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "a",
+              "c"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "7",
+          "\"ServerTimestamp\""
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "integerValue": "7"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a.b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-no-paths.json b/firestore/tests/unit/v1/testdata/update-paths-no-paths.json
new file mode 100644
index 000000000000..e8ad035eaf13
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-no-paths.json
@@ -0,0 +1,12 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: no paths",
+      "comment": "It is a client-side error to call Update with empty data.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-prefix-1.json b/firestore/tests/unit/v1/testdata/update-paths-prefix-1.json
new file mode 100644
index 000000000000..0bc1c0e812de
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-prefix-1.json
@@ -0,0 +1,29 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: prefix #1",
+      "comment": "In the input data, one field cannot be a prefix of another.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a",
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "2"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-prefix-2.json b/firestore/tests/unit/v1/testdata/update-paths-prefix-2.json
new file mode 100644
index 000000000000..6f1d152a7077
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-prefix-2.json
@@ -0,0 +1,29 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: prefix #2",
+      "comment": "In the input data, one field cannot be a prefix of another.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "a",
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "2"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-prefix-3.json b/firestore/tests/unit/v1/testdata/update-paths-prefix-3.json
new file mode 100644
index 000000000000..4fe17b292f6a
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-prefix-3.json
@@ -0,0 +1,29 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: prefix #3",
+      "comment": "In the input data, one field cannot be a prefix of another, even if the values could in principle be combined.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "a",
+              "d"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "{\"b\": 1}",
+          "2"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-special-chars.json b/firestore/tests/unit/v1/testdata/update-paths-special-chars.json
new file mode 100644
index 000000000000..83b27d8dbfde
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-special-chars.json
@@ -0,0 +1,62 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: special characters",
+      "comment": "FieldPaths can contain special characters.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "*",
+              "~"
+            ]
+          },
+          {
+            "field": [
+              "*",
+              "`"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "2"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "*": {
+                    "mapValue": {
+                      "fields": {
+                        "`": {
+                          "integerValue": "2"
+                        },
+                        "~": {
+                          "integerValue": "1"
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "`*`.`\\``",
+                  "`*`.`~`"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st-alone.json b/firestore/tests/unit/v1/testdata/update-paths-st-alone.json
new file mode 100644
index 000000000000..085d04987713
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st-alone.json
@@ -0,0 +1,40 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ServerTimestamp alone",
+      "comment": "If the only values in the input are ServerTimestamps, then no\nupdate operation should be produced.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "\"ServerTimestamp\""
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st-multi.json b/firestore/tests/unit/v1/testdata/update-paths-st-multi.json
new file mode 100644
index 000000000000..2d813801ac33
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st-multi.json
@@ -0,0 +1,72 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: multiple ServerTimestamp fields",
+      "comment": "A document can have more than one ServerTimestamp field.\nSince all the ServerTimestamp fields are removed, the only field in the update is \"a\".",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          },
+          {
+            "field": [
+              "c"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "\"ServerTimestamp\"",
+          "{\"d\": \"ServerTimestamp\"}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st-nested.json b/firestore/tests/unit/v1/testdata/update-paths-st-nested.json
new file mode 100644
index 000000000000..8bd35c9111b1
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st-nested.json
@@ -0,0 +1,62 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: nested ServerTimestamp field",
+      "comment": "A ServerTimestamp value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "{\"c\": \"ServerTimestamp\"}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-paths-st-noarray-nested.json
new file mode 100644
index 000000000000..2dd1bcacc775
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st-noarray-nested.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ServerTimestamp cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ServerTimestamp sentinel. Firestore transforms don't support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, {\"b\": \"ServerTimestamp\"}]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st-noarray.json b/firestore/tests/unit/v1/testdata/update-paths-st-noarray.json
new file mode 100644
index 000000000000..5da60306bc25
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st-noarray.json
@@ -0,0 +1,22 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ServerTimestamp cannot be in an array value",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "[1, 2, \"ServerTimestamp\"]"
+        ],
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st-with-empty-map.json b/firestore/tests/unit/v1/testdata/update-paths-st-with-empty-map.json
new file mode 100644
index 000000000000..ac60b2771d37
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st-with-empty-map.json
@@ -0,0 +1,63 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ServerTimestamp beside an empty map",
+      "comment": "When a ServerTimestamp and a map both reside inside a map, the\nServerTimestamp should be stripped out but the empty map should remain.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "{\"b\": {}, \"c\": \"ServerTimestamp\"}"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "mapValue": {
+                            "fields": {}
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-st.json b/firestore/tests/unit/v1/testdata/update-paths-st.json
new file mode 100644
index 000000000000..011405b9bf7b
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-st.json
@@ -0,0 +1,61 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: ServerTimestamp with data",
+      "comment": "A key with the special ServerTimestamp sentinel is removed from\nthe data in the update operation. Instead it appears in a separate Transform operation.\nNote that in these tests, the string \"ServerTimestamp\" should be replaced with the\nspecial ServerTimestamp value.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          },
+          {
+            "field": [
+              "b"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1",
+          "\"ServerTimestamp\""
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-paths-uptime.json b/firestore/tests/unit/v1/testdata/update-paths-uptime.json
new file mode 100644
index 000000000000..96801a0cd8e7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-paths-uptime.json
@@ -0,0 +1,47 @@
+{
+  "tests": [
+    {
+      "description": "update-paths: last-update-time precondition",
+      "comment": "The Update call supports a last-update-time precondition.",
+      "updatePaths": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "precondition": {
+          "updateTime": "1970-01-01T00:00:42Z"
+        },
+        "fieldPaths": [
+          {
+            "field": [
+              "a"
+            ]
+          }
+        ],
+        "jsonValues": [
+          "1"
+        ],
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "updateTime": "1970-01-01T00:00:42Z"
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-prefix-1.json b/firestore/tests/unit/v1/testdata/update-prefix-1.json
new file mode 100644
index 000000000000..faad69d140bc
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-prefix-1.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: prefix #1",
+      "comment": "In the input data, one field cannot be a prefix of another.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a.b\": 1, \"a\": 2}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-prefix-2.json b/firestore/tests/unit/v1/testdata/update-prefix-2.json
new file mode 100644
index 000000000000..96545c134867
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-prefix-2.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: prefix #2",
+      "comment": "In the input data, one field cannot be a prefix of another.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"a.b\": 2}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-prefix-3.json b/firestore/tests/unit/v1/testdata/update-prefix-3.json
new file mode 100644
index 000000000000..95f7024966c7
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-prefix-3.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: prefix #3",
+      "comment": "In the input data, one field cannot be a prefix of another, even if the values could in principle be combined.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": {\"b\": 1}, \"a.d\": 2}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-quoting.json b/firestore/tests/unit/v1/testdata/update-quoting.json
new file mode 100644
index 000000000000..10e3c35c22ca
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-quoting.json
@@ -0,0 +1,47 @@
+{
+  "tests": [
+    {
+      "description": "update: non-letter starting chars are quoted, except underscore",
+      "comment": "In a field path, any component beginning with a non-letter or underscore is quoted.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"_0.1.+2\": 1}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "_0": {
+                    "mapValue": {
+                      "fields": {
+                        "1": {
+                          "mapValue": {
+                            "fields": {
+                              "+2": {
+                                "integerValue": "1"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "_0.`1`.`+2`"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-split-top-level.json b/firestore/tests/unit/v1/testdata/update-split-top-level.json
new file mode 100644
index 000000000000..eddf360d3731
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-split-top-level.json
@@ -0,0 +1,47 @@
+{
+  "tests": [
+    {
+      "description": "update: Split on dots for top-level keys only",
+      "comment": "The Update method splits only top-level keys at dots. Keys at\nother levels are taken literally.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"h.g\": {\"j.k\": 6}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "h": {
+                    "mapValue": {
+                      "fields": {
+                        "g": {
+                          "mapValue": {
+                            "fields": {
+                              "j.k": {
+                                "integerValue": "6"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "h.g"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-split.json b/firestore/tests/unit/v1/testdata/update-split.json
new file mode 100644
index 000000000000..e18c78bf6e61
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-split.json
@@ -0,0 +1,47 @@
+{
+  "tests": [
+    {
+      "description": "update: split on dots",
+      "comment": "The Update method splits top-level keys at dots.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a.b.c\": 1}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "mapValue": {
+                            "fields": {
+                              "c": {
+                                "integerValue": "1"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a.b.c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-alone.json b/firestore/tests/unit/v1/testdata/update-st-alone.json
new file mode 100644
index 000000000000..1a333f30cbb6
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-alone.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "update: ServerTimestamp alone",
+      "comment": "If the only values in the input are ServerTimestamps, then no\nupdate operation should be produced.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-dot.json b/firestore/tests/unit/v1/testdata/update-st-dot.json
new file mode 100644
index 000000000000..83422ca5271f
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-dot.json
@@ -0,0 +1,31 @@
+{
+  "tests": [
+    {
+      "description": "update: ServerTimestamp with dotted field",
+      "comment": "Like other uses of ServerTimestamp, the data is pruned and the\nfield does not appear in the update mask, because it is in the transform. In this case\nAn update operation is produced just to hold the precondition.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a.b.c\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.b.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-multi.json b/firestore/tests/unit/v1/testdata/update-st-multi.json
new file mode 100644
index 000000000000..8105ec27f543
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-multi.json
@@ -0,0 +1,51 @@
+{
+  "tests": [
+    {
+      "description": "update: multiple ServerTimestamp fields",
+      "comment": "A document can have more than one ServerTimestamp field.\nSince all the ServerTimestamp fields are removed, the only field in the update is \"a\".",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": {\"d\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "c"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  },
+                  {
+                    "fieldPath": "c.d",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-nested.json b/firestore/tests/unit/v1/testdata/update-st-nested.json
new file mode 100644
index 000000000000..5a8e73237c34
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-nested.json
@@ -0,0 +1,47 @@
+{
+  "tests": [
+    {
+      "description": "update: nested ServerTimestamp field",
+      "comment": "A ServerTimestamp value can occur at any depth. In this case,\nthe transform applies to the field path \"b.c\". Since \"c\" is removed from the update,\n\"b\" becomes empty, so it is also removed from the update.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": {\"c\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a",
+                  "b"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-noarray-nested.json b/firestore/tests/unit/v1/testdata/update-st-noarray-nested.json
new file mode 100644
index 000000000000..9f94501aa7fb
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-noarray-nested.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: ServerTimestamp cannot be anywhere inside an array value",
+      "comment": "There cannot be an array value anywhere on the path from the document\nroot to the ServerTimestamp sentinel. Firestore transforms don't support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, {\"b\": \"ServerTimestamp\"}]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-noarray.json b/firestore/tests/unit/v1/testdata/update-st-noarray.json
new file mode 100644
index 000000000000..02615bd3ceb2
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-noarray.json
@@ -0,0 +1,13 @@
+{
+  "tests": [
+    {
+      "description": "update: ServerTimestamp cannot be in an array value",
+      "comment": "The ServerTimestamp sentinel must be the value of a field. Firestore\ntransforms don't support array indexing.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": [1, 2, \"ServerTimestamp\"]}",
+        "isError": true
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st-with-empty-map.json b/firestore/tests/unit/v1/testdata/update-st-with-empty-map.json
new file mode 100644
index 000000000000..abeceb03ea8e
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st-with-empty-map.json
@@ -0,0 +1,54 @@
+{
+  "tests": [
+    {
+      "description": "update: ServerTimestamp beside an empty map",
+      "comment": "When a ServerTimestamp and a map both reside inside a map, the\nServerTimestamp should be stripped out but the empty map should remain.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": {\"b\": {}, \"c\": \"ServerTimestamp\"}}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "mapValue": {
+                      "fields": {
+                        "b": {
+                          "mapValue": {
+                            "fields": {}
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "a.c",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-st.json b/firestore/tests/unit/v1/testdata/update-st.json
new file mode 100644
index 000000000000..6249d8bda90d
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-st.json
@@ -0,0 +1,46 @@
+{
+  "tests": [
+    {
+      "description": "update: ServerTimestamp with data",
+      "comment": "A key with the special ServerTimestamp sentinel is removed from\nthe data in the update operation. Instead it appears in a separate Transform operation.\nNote that in these tests, the string \"ServerTimestamp\" should be replaced with the\nspecial ServerTimestamp value.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "jsonData": "{\"a\": 1, \"b\": \"ServerTimestamp\"}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "exists": true
+              }
+            },
+            {
+              "transform": {
+                "document": "projects/projectID/databases/(default)/documents/C/d",
+                "fieldTransforms": [
+                  {
+                    "fieldPath": "b",
+                    "setToServerValue": "REQUEST_TIME"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1/testdata/update-uptime.json b/firestore/tests/unit/v1/testdata/update-uptime.json
new file mode 100644
index 000000000000..9210a2cf0328
--- /dev/null
+++ b/firestore/tests/unit/v1/testdata/update-uptime.json
@@ -0,0 +1,38 @@
+{
+  "tests": [
+    {
+      "description": "update: last-update-time precondition",
+      "comment": "The Update call supports a last-update-time precondition.",
+      "update": {
+        "docRefPath": "projects/projectID/databases/(default)/documents/C/d",
+        "precondition": {
+          "updateTime": "1970-01-01T00:00:42Z"
+        },
+        "jsonData": "{\"a\": 1}",
+        "request": {
+          "database": "projects/projectID/databases/(default)",
+          "writes": [
+            {
+              "update": {
+                "name": "projects/projectID/databases/(default)/documents/C/d",
+                "fields": {
+                  "a": {
+                    "integerValue": "1"
+                  }
+                }
+              },
+              "updateMask": {
+                "fieldPaths": [
+                  "a"
+                ]
+              },
+              "currentDocument": {
+                "updateTime": "1970-01-01T00:00:42Z"
+              }
+            }
+          ]
+        }
+      }
+    }
+  ]
+}
diff --git a/firestore/tests/unit/v1beta1/__init__.py b/firestore/tests/unit/v1beta1/__init__.py
new file mode 100644
index 000000000000..ab6729095248
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/firestore/tests/unit/v1beta1/test__helpers.py b/firestore/tests/unit/v1beta1/test__helpers.py
new file mode 100644
index 000000000000..3059482cd07a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test__helpers.py
@@ -0,0 +1,2089 @@
+# -*- coding: utf-8 -*-
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import sys
+import unittest
+
+import mock
+import pytest
+
+
+class TestGeoPoint(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1._helpers import GeoPoint
+
+        return GeoPoint
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        lat = 81.25
+        lng = 359.984375
+        geo_pt = self._make_one(lat, lng)
+        self.assertEqual(geo_pt.latitude, lat)
+        self.assertEqual(geo_pt.longitude, lng)
+
+    def test_to_protobuf(self):
+        from google.type import latlng_pb2
+
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt = self._make_one(lat, lng)
+        result = geo_pt.to_protobuf()
+        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
+        self.assertEqual(result, geo_pt_pb)
+
+    def test___eq__(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = self._make_one(lat, lng)
+        self.assertEqual(geo_pt1, geo_pt2)
+
+    def test___eq__type_differ(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = object()
+        self.assertNotEqual(geo_pt1, geo_pt2)
+        self.assertIs(geo_pt1.__eq__(geo_pt2), NotImplemented)
+
+    def test___ne__same_value(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = self._make_one(lat, lng)
+        comparison_val = geo_pt1 != geo_pt2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        geo_pt1 = self._make_one(0.0, 1.0)
+        geo_pt2 = self._make_one(2.0, 3.0)
+        self.assertNotEqual(geo_pt1, geo_pt2)
+
+    def test___ne__type_differ(self):
+        lat = 0.015625
+        lng = 20.03125
+        geo_pt1 = self._make_one(lat, lng)
+        geo_pt2 = object()
+        self.assertNotEqual(geo_pt1, geo_pt2)
+        self.assertIs(geo_pt1.__ne__(geo_pt2), NotImplemented)
+
+
+class Test_verify_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path, is_collection):
+        from google.cloud.firestore_v1beta1._helpers import verify_path
+
+        return verify_path(path, is_collection)
+
+    def test_empty(self):
+        path = ()
+        with self.assertRaises(ValueError):
+            self._call_fut(path, True)
+        with self.assertRaises(ValueError):
+            self._call_fut(path, False)
+
+    def test_wrong_length_collection(self):
+        path = ("foo", "bar")
+        with self.assertRaises(ValueError):
+            self._call_fut(path, True)
+
+    def test_wrong_length_document(self):
+        path = ("Kind",)
+        with self.assertRaises(ValueError):
+            self._call_fut(path, False)
+
+    def test_wrong_type_collection(self):
+        path = (99, "ninety-nine", "zap")
+        with self.assertRaises(ValueError):
+            self._call_fut(path, True)
+
+    def test_wrong_type_document(self):
+        path = ("Users", "Ada", "Candy", {})
+        with self.assertRaises(ValueError):
+            self._call_fut(path, False)
+
+    def test_success_collection(self):
+        path = ("Computer", "Magic", "Win")
+        ret_val = self._call_fut(path, True)
+        # NOTE: We are just checking that it didn't fail.
+        self.assertIsNone(ret_val)
+
+    def test_success_document(self):
+        path = ("Tokenizer", "Seventeen", "Cheese", "Burger")
+        ret_val = self._call_fut(path, False)
+        # NOTE: We are just checking that it didn't fail.
+        self.assertIsNone(ret_val)
+
+
+class Test_encode_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value):
+        from google.cloud.firestore_v1beta1._helpers import encode_value
+
+        return encode_value(value)
+
+    def test_none(self):
+        from google.protobuf import struct_pb2
+
+        result = self._call_fut(None)
+        expected = _value_pb(null_value=struct_pb2.NULL_VALUE)
+        self.assertEqual(result, expected)
+
+    def test_boolean(self):
+        result = self._call_fut(True)
+        expected = _value_pb(boolean_value=True)
+        self.assertEqual(result, expected)
+
+    def test_integer(self):
+        value = 425178
+        result = self._call_fut(value)
+        expected = _value_pb(integer_value=value)
+        self.assertEqual(result, expected)
+
+    def test_float(self):
+        value = 123.4453125
+        result = self._call_fut(value)
+        expected = _value_pb(double_value=value)
+        self.assertEqual(result, expected)
+
+    def test_datetime_with_nanos(self):
+        from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+        from google.protobuf import timestamp_pb2
+
+        dt_seconds = 1488768504
+        dt_nanos = 458816991
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=dt_seconds, nanos=dt_nanos)
+        dt_val = DatetimeWithNanoseconds.from_timestamp_pb(timestamp_pb)
+
+        result = self._call_fut(dt_val)
+        expected = _value_pb(timestamp_value=timestamp_pb)
+        self.assertEqual(result, expected)
+
+    def test_datetime_wo_nanos(self):
+        from google.protobuf import timestamp_pb2
+
+        dt_seconds = 1488768504
+        dt_nanos = 458816000
+        # Make sure precision is valid in microseconds too.
+        self.assertEqual(dt_nanos % 1000, 0)
+        dt_val = datetime.datetime.utcfromtimestamp(dt_seconds + 1e-9 * dt_nanos)
+
+        result = self._call_fut(dt_val)
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=dt_seconds, nanos=dt_nanos)
+        expected = _value_pb(timestamp_value=timestamp_pb)
+        self.assertEqual(result, expected)
+
+    def test_string(self):
+        value = u"\u2018left quote, right quote\u2019"
+        result = self._call_fut(value)
+        expected = _value_pb(string_value=value)
+        self.assertEqual(result, expected)
+
+    def test_bytes(self):
+        value = b"\xe3\xf2\xff\x00"
+        result = self._call_fut(value)
+        expected = _value_pb(bytes_value=value)
+        self.assertEqual(result, expected)
+
+    def test_reference_value(self):
+        client = _make_client()
+
+        value = client.document("my", "friend")
+        result = self._call_fut(value)
+        expected = _value_pb(reference_value=value._document_path)
+        self.assertEqual(result, expected)
+
+    def test_geo_point(self):
+        from google.cloud.firestore_v1beta1._helpers import GeoPoint
+
+        value = GeoPoint(50.5, 88.75)
+        result = self._call_fut(value)
+        expected = _value_pb(geo_point_value=value.to_protobuf())
+        self.assertEqual(result, expected)
+
+    def test_array(self):
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import ArrayValue
+
+        result = self._call_fut([99, True, 118.5])
+
+        array_pb = ArrayValue(
+            values=[
+                _value_pb(integer_value=99),
+                _value_pb(boolean_value=True),
+                _value_pb(double_value=118.5),
+            ]
+        )
+        expected = _value_pb(array_value=array_pb)
+        self.assertEqual(result, expected)
+
+    def test_map(self):
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import MapValue
+
+        result = self._call_fut({"abc": 285, "def": b"piglatin"})
+
+        map_pb = MapValue(
+            fields={
+                "abc": _value_pb(integer_value=285),
+                "def": _value_pb(bytes_value=b"piglatin"),
+            }
+        )
+        expected = _value_pb(map_value=map_pb)
+        self.assertEqual(result, expected)
+
+    def test_bad_type(self):
+        value = object()
+        with self.assertRaises(TypeError):
+            self._call_fut(value)
+
+
+class Test_encode_dict(unittest.TestCase):
+    @staticmethod
+    def _call_fut(values_dict):
+        from google.cloud.firestore_v1beta1._helpers import encode_dict
+
+        return encode_dict(values_dict)
+
+    def test_many_types(self):
+        from google.protobuf import struct_pb2
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import ArrayValue
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import MapValue
+
+        dt_seconds = 1497397225
+        dt_nanos = 465964000
+        # Make sure precision is valid in microseconds too.
+        self.assertEqual(dt_nanos % 1000, 0)
+        dt_val = datetime.datetime.utcfromtimestamp(dt_seconds + 1e-9 * dt_nanos)
+
+        client = _make_client()
+        document = client.document("most", "adjective", "thing", "here")
+
+        values_dict = {
+            "foo": None,
+            "bar": True,
+            "baz": 981,
+            "quux": 2.875,
+            "quuz": dt_val,
+            "corge": u"\N{snowman}",
+            "grault": b"\xe2\x98\x83",
+            "wibble": document,
+            "garply": [u"fork", 4.0],
+            "waldo": {"fred": u"zap", "thud": False},
+        }
+        encoded_dict = self._call_fut(values_dict)
+        expected_dict = {
+            "foo": _value_pb(null_value=struct_pb2.NULL_VALUE),
+            "bar": _value_pb(boolean_value=True),
+            "baz": _value_pb(integer_value=981),
+            "quux": _value_pb(double_value=2.875),
+            "quuz": _value_pb(
+                timestamp_value=timestamp_pb2.Timestamp(
+                    seconds=dt_seconds, nanos=dt_nanos
+                )
+            ),
+            "corge": _value_pb(string_value=u"\N{snowman}"),
+            "grault": _value_pb(bytes_value=b"\xe2\x98\x83"),
+            "wibble": _value_pb(reference_value=document._document_path),
+            "garply": _value_pb(
+                array_value=ArrayValue(
+                    values=[
+                        _value_pb(string_value=u"fork"),
+                        _value_pb(double_value=4.0),
+                    ]
+                )
+            ),
+            "waldo": _value_pb(
+                map_value=MapValue(
+                    fields={
+                        "fred": _value_pb(string_value=u"zap"),
+                        "thud": _value_pb(boolean_value=False),
+                    }
+                )
+            ),
+        }
+        self.assertEqual(encoded_dict, expected_dict)
+
+
+class Test_reference_value_to_document(unittest.TestCase):
+    @staticmethod
+    def _call_fut(reference_value, client):
+        from google.cloud.firestore_v1beta1._helpers import reference_value_to_document
+
+        return reference_value_to_document(reference_value, client)
+
+    def test_bad_format(self):
+        from google.cloud.firestore_v1beta1._helpers import BAD_REFERENCE_ERROR
+
+        reference_value = "not/the/right/format"
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(reference_value, None)
+
+        err_msg = BAD_REFERENCE_ERROR.format(reference_value)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test_same_client(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        client = _make_client()
+        document = client.document("that", "this")
+        reference_value = document._document_path
+
+        new_document = self._call_fut(reference_value, client)
+        self.assertIsNot(new_document, document)
+
+        self.assertIsInstance(new_document, DocumentReference)
+        self.assertIs(new_document._client, client)
+        self.assertEqual(new_document._path, document._path)
+
+    def test_different_client(self):
+        from google.cloud.firestore_v1beta1._helpers import WRONG_APP_REFERENCE
+
+        client1 = _make_client(project="kirk")
+        document = client1.document("tin", "foil")
+        reference_value = document._document_path
+
+        client2 = _make_client(project="spock")
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(reference_value, client2)
+
+        err_msg = WRONG_APP_REFERENCE.format(reference_value, client2._database_string)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+
+class Test_decode_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value, client=mock.sentinel.client):
+        from google.cloud.firestore_v1beta1._helpers import decode_value
+
+        return decode_value(value, client)
+
+    def test_none(self):
+        from google.protobuf import struct_pb2
+
+        value = _value_pb(null_value=struct_pb2.NULL_VALUE)
+        self.assertIsNone(self._call_fut(value))
+
+    def test_bool(self):
+        value1 = _value_pb(boolean_value=True)
+        self.assertTrue(self._call_fut(value1))
+        value2 = _value_pb(boolean_value=False)
+        self.assertFalse(self._call_fut(value2))
+
+    def test_int(self):
+        int_val = 29871
+        value = _value_pb(integer_value=int_val)
+        self.assertEqual(self._call_fut(value), int_val)
+
+    def test_float(self):
+        float_val = 85.9296875
+        value = _value_pb(double_value=float_val)
+        self.assertEqual(self._call_fut(value), float_val)
+
+    @unittest.skipIf(
+        (3,) <= sys.version_info < (3, 4, 4), "known datetime bug (bpo-23517) in Python"
+    )
+    def test_datetime(self):
+        from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+        from google.protobuf import timestamp_pb2
+
+        dt_seconds = 552855006
+        dt_nanos = 766961828
+
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=dt_seconds, nanos=dt_nanos)
+        value = _value_pb(timestamp_value=timestamp_pb)
+
+        expected_dt_val = DatetimeWithNanoseconds.from_timestamp_pb(timestamp_pb)
+        self.assertEqual(self._call_fut(value), expected_dt_val)
+
+    def test_unicode(self):
+        unicode_val = u"zorgon"
+        value = _value_pb(string_value=unicode_val)
+        self.assertEqual(self._call_fut(value), unicode_val)
+
+    def test_bytes(self):
+        bytes_val = b"abc\x80"
+        value = _value_pb(bytes_value=bytes_val)
+        self.assertEqual(self._call_fut(value), bytes_val)
+
+    def test_reference(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        client = _make_client()
+        path = (u"then", u"there-was-one")
+        document = client.document(*path)
+        ref_string = document._document_path
+        value = _value_pb(reference_value=ref_string)
+
+        result = self._call_fut(value, client)
+        self.assertIsInstance(result, DocumentReference)
+        self.assertIs(result._client, client)
+        self.assertEqual(result._path, path)
+
+    def test_geo_point(self):
+        from google.cloud.firestore_v1beta1._helpers import GeoPoint
+
+        geo_pt = GeoPoint(latitude=42.5, longitude=99.0625)
+        value = _value_pb(geo_point_value=geo_pt.to_protobuf())
+        self.assertEqual(self._call_fut(value), geo_pt)
+
+    def test_array(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+
+        sub_value1 = _value_pb(boolean_value=True)
+        sub_value2 = _value_pb(double_value=14.1396484375)
+        sub_value3 = _value_pb(bytes_value=b"\xde\xad\xbe\xef")
+        array_pb = document_pb2.ArrayValue(values=[sub_value1, sub_value2, sub_value3])
+        value = _value_pb(array_value=array_pb)
+
+        expected = [
+            sub_value1.boolean_value,
+            sub_value2.double_value,
+            sub_value3.bytes_value,
+        ]
+        self.assertEqual(self._call_fut(value), expected)
+
+    def test_map(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+
+        sub_value1 = _value_pb(integer_value=187680)
+        sub_value2 = _value_pb(string_value=u"how low can you go?")
+        map_pb = document_pb2.MapValue(
+            fields={"first": sub_value1, "second": sub_value2}
+        )
+        value = _value_pb(map_value=map_pb)
+
+        expected = {
+            "first": sub_value1.integer_value,
+            "second": sub_value2.string_value,
+        }
+        self.assertEqual(self._call_fut(value), expected)
+
+    def test_nested_map(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+
+        actual_value1 = 1009876
+        actual_value2 = u"hey you guys"
+        actual_value3 = 90.875
+        map_pb1 = document_pb2.MapValue(
+            fields={
+                "lowest": _value_pb(integer_value=actual_value1),
+                "aside": _value_pb(string_value=actual_value2),
+            }
+        )
+        map_pb2 = document_pb2.MapValue(
+            fields={
+                "middle": _value_pb(map_value=map_pb1),
+                "aside": _value_pb(boolean_value=True),
+            }
+        )
+        map_pb3 = document_pb2.MapValue(
+            fields={
+                "highest": _value_pb(map_value=map_pb2),
+                "aside": _value_pb(double_value=actual_value3),
+            }
+        )
+        value = _value_pb(map_value=map_pb3)
+
+        expected = {
+            "highest": {
+                "middle": {"lowest": actual_value1, "aside": actual_value2},
+                "aside": True,
+            },
+            "aside": actual_value3,
+        }
+        self.assertEqual(self._call_fut(value), expected)
+
+    def test_unset_value_type(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(_value_pb())
+
+    def test_unknown_value_type(self):
+        value_pb = mock.Mock(spec=["WhichOneof"])
+        value_pb.WhichOneof.return_value = "zoob_value"
+
+        with self.assertRaises(ValueError):
+            self._call_fut(value_pb)
+
+        value_pb.WhichOneof.assert_called_once_with("value_type")
+
+
+class Test_decode_dict(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value_fields, client=mock.sentinel.client):
+        from google.cloud.firestore_v1beta1._helpers import decode_dict
+
+        return decode_dict(value_fields, client)
+
+    @unittest.skipIf(
+        (3,) <= sys.version_info < (3, 4, 4), "known datetime bug (bpo-23517) in Python"
+    )
+    def test_many_types(self):
+        from google.protobuf import struct_pb2
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import ArrayValue
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import MapValue
+        from google.cloud._helpers import UTC
+        from google.cloud.firestore_v1beta1.field_path import FieldPath
+
+        dt_seconds = 1394037350
+        dt_nanos = 667285000
+        # Make sure precision is valid in microseconds too.
+        self.assertEqual(dt_nanos % 1000, 0)
+        dt_val = datetime.datetime.utcfromtimestamp(
+            dt_seconds + 1e-9 * dt_nanos
+        ).replace(tzinfo=UTC)
+
+        value_fields = {
+            "foo": _value_pb(null_value=struct_pb2.NULL_VALUE),
+            "bar": _value_pb(boolean_value=True),
+            "baz": _value_pb(integer_value=981),
+            "quux": _value_pb(double_value=2.875),
+            "quuz": _value_pb(
+                timestamp_value=timestamp_pb2.Timestamp(
+                    seconds=dt_seconds, nanos=dt_nanos
+                )
+            ),
+            "corge": _value_pb(string_value=u"\N{snowman}"),
+            "grault": _value_pb(bytes_value=b"\xe2\x98\x83"),
+            "garply": _value_pb(
+                array_value=ArrayValue(
+                    values=[
+                        _value_pb(string_value=u"fork"),
+                        _value_pb(double_value=4.0),
+                    ]
+                )
+            ),
+            "waldo": _value_pb(
+                map_value=MapValue(
+                    fields={
+                        "fred": _value_pb(string_value=u"zap"),
+                        "thud": _value_pb(boolean_value=False),
+                    }
+                )
+            ),
+            FieldPath("a", "b", "c").to_api_repr(): _value_pb(boolean_value=False),
+        }
+        expected = {
+            "foo": None,
+            "bar": True,
+            "baz": 981,
+            "quux": 2.875,
+            "quuz": dt_val,
+            "corge": u"\N{snowman}",
+            "grault": b"\xe2\x98\x83",
+            "garply": [u"fork", 4.0],
+            "waldo": {"fred": u"zap", "thud": False},
+            "a.b.c": False,
+        }
+        self.assertEqual(self._call_fut(value_fields), expected)
+
+
+class Test_get_doc_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_pb, expected_prefix):
+        from google.cloud.firestore_v1beta1._helpers import get_doc_id
+
+        return get_doc_id(document_pb, expected_prefix)
+
+    @staticmethod
+    def _dummy_ref_string(collection_id):
+        from google.cloud.firestore_v1beta1.client import DEFAULT_DATABASE
+
+        project = u"bazzzz"
+        return u"projects/{}/databases/{}/documents/{}".format(
+            project, DEFAULT_DATABASE, collection_id
+        )
+
+    def test_success(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+
+        prefix = self._dummy_ref_string("sub-collection")
+        actual_id = "this-is-the-one"
+        name = "{}/{}".format(prefix, actual_id)
+
+        document_pb = document_pb2.Document(name=name)
+        document_id = self._call_fut(document_pb, prefix)
+        self.assertEqual(document_id, actual_id)
+
+    def test_failure(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+
+        actual_prefix = self._dummy_ref_string("the-right-one")
+        wrong_prefix = self._dummy_ref_string("the-wrong-one")
+        name = "{}/{}".format(actual_prefix, "sorry-wont-works")
+
+        document_pb = document_pb2.Document(name=name)
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(document_pb, wrong_prefix)
+
+        exc_args = exc_info.exception.args
+        self.assertEqual(len(exc_args), 4)
+        self.assertEqual(exc_args[1], name)
+        self.assertEqual(exc_args[3], wrong_prefix)
+
+
+class Test_extract_fields(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_data, prefix_path, expand_dots=False):
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.extract_fields(
+            document_data, prefix_path, expand_dots=expand_dots
+        )
+
+    def test_w_empty_document(self):
+        from google.cloud.firestore_v1beta1._helpers import _EmptyDict
+
+        document_data = {}
+        prefix_path = _make_field_path()
+        expected = [(_make_field_path(), _EmptyDict)]
+
+        iterator = self._call_fut(document_data, prefix_path)
+        self.assertEqual(list(iterator), expected)
+
+    def test_w_invalid_key_and_expand_dots(self):
+        document_data = {"b": 1, "a~d": 2, "c": 3}
+        prefix_path = _make_field_path()
+
+        with self.assertRaises(ValueError):
+            list(self._call_fut(document_data, prefix_path, expand_dots=True))
+
+    def test_w_shallow_keys(self):
+        document_data = {"b": 1, "a": 2, "c": 3}
+        prefix_path = _make_field_path()
+        expected = [
+            (_make_field_path("a"), 2),
+            (_make_field_path("b"), 1),
+            (_make_field_path("c"), 3),
+        ]
+
+        iterator = self._call_fut(document_data, prefix_path)
+        self.assertEqual(list(iterator), expected)
+
+    def test_w_nested(self):
+        from google.cloud.firestore_v1beta1._helpers import _EmptyDict
+
+        document_data = {"b": {"a": {"d": 4, "c": 3, "g": {}}, "e": 7}, "f": 5}
+        prefix_path = _make_field_path()
+        expected = [
+            (_make_field_path("b", "a", "c"), 3),
+            (_make_field_path("b", "a", "d"), 4),
+            (_make_field_path("b", "a", "g"), _EmptyDict),
+            (_make_field_path("b", "e"), 7),
+            (_make_field_path("f"), 5),
+        ]
+
+        iterator = self._call_fut(document_data, prefix_path)
+        self.assertEqual(list(iterator), expected)
+
+    def test_w_expand_dotted(self):
+        from google.cloud.firestore_v1beta1._helpers import _EmptyDict
+
+        document_data = {
+            "b": {"a": {"d": 4, "c": 3, "g": {}, "k.l.m": 17}, "e": 7},
+            "f": 5,
+            "h.i.j": 9,
+        }
+        prefix_path = _make_field_path()
+        expected = [
+            (_make_field_path("b", "a", "c"), 3),
+            (_make_field_path("b", "a", "d"), 4),
+            (_make_field_path("b", "a", "g"), _EmptyDict),
+            (_make_field_path("b", "a", "k.l.m"), 17),
+            (_make_field_path("b", "e"), 7),
+            (_make_field_path("f"), 5),
+            (_make_field_path("h", "i", "j"), 9),
+        ]
+
+        iterator = self._call_fut(document_data, prefix_path, expand_dots=True)
+        self.assertEqual(list(iterator), expected)
+
+
+class Test_set_field_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_data, field_path, value):
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.set_field_value(document_data, field_path, value)
+
+    def test_normal_value_w_shallow(self):
+        document = {}
+        field_path = _make_field_path("a")
+        value = 3
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": 3})
+
+    def test_normal_value_w_nested(self):
+        document = {}
+        field_path = _make_field_path("a", "b", "c")
+        value = 3
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": {"b": {"c": 3}}})
+
+    def test_empty_dict_w_shallow(self):
+        from google.cloud.firestore_v1beta1._helpers import _EmptyDict
+
+        document = {}
+        field_path = _make_field_path("a")
+        value = _EmptyDict
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": {}})
+
+    def test_empty_dict_w_nested(self):
+        from google.cloud.firestore_v1beta1._helpers import _EmptyDict
+
+        document = {}
+        field_path = _make_field_path("a", "b", "c")
+        value = _EmptyDict
+
+        self._call_fut(document, field_path, value)
+
+        self.assertEqual(document, {"a": {"b": {"c": {}}}})
+
+
+class Test_get_field_value(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_data, field_path):
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.get_field_value(document_data, field_path)
+
+    def test_w_empty_path(self):
+        document = {}
+
+        with self.assertRaises(ValueError):
+            self._call_fut(document, _make_field_path())
+
+    def test_miss_shallow(self):
+        document = {}
+
+        with self.assertRaises(KeyError):
+            self._call_fut(document, _make_field_path("nonesuch"))
+
+    def test_miss_nested(self):
+        document = {"a": {"b": {}}}
+
+        with self.assertRaises(KeyError):
+            self._call_fut(document, _make_field_path("a", "b", "c"))
+
+    def test_hit_shallow(self):
+        document = {"a": 1}
+
+        self.assertEqual(self._call_fut(document, _make_field_path("a")), 1)
+
+    def test_hit_nested(self):
+        document = {"a": {"b": {"c": 1}}}
+
+        self.assertEqual(self._call_fut(document, _make_field_path("a", "b", "c")), 1)
+
+
+class TestDocumentExtractor(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.DocumentExtractor
+
+    def _make_one(self, document_data):
+        return self._get_target_class()(document_data)
+
+    def test_ctor_w_empty_document(self):
+        document_data = {}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertTrue(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_delete_field_shallow(self):
+        from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+
+        document_data = {"a": DELETE_FIELD}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [_make_field_path("a")])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_delete_field_nested(self):
+        from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+
+        document_data = {"a": {"b": {"c": DELETE_FIELD}}}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [_make_field_path("a", "b", "c")])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_server_timestamp_shallow(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_data = {"a": SERVER_TIMESTAMP}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [_make_field_path("a")])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_server_timestamp_nested(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_data = {"a": {"b": {"c": SERVER_TIMESTAMP}}}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [_make_field_path("a", "b", "c")])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_array_remove_shallow(self):
+        from google.cloud.firestore_v1beta1.transforms import ArrayRemove
+
+        values = [1, 3, 5]
+        document_data = {"a": ArrayRemove(values)}
+
+        inst = self._make_one(document_data)
+
+        expected_array_removes = {_make_field_path("a"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, expected_array_removes)
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_array_remove_nested(self):
+        from google.cloud.firestore_v1beta1.transforms import ArrayRemove
+
+        values = [2, 4, 8]
+        document_data = {"a": {"b": {"c": ArrayRemove(values)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_array_removes = {_make_field_path("a", "b", "c"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, expected_array_removes)
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_array_union_shallow(self):
+        from google.cloud.firestore_v1beta1.transforms import ArrayUnion
+
+        values = [1, 3, 5]
+        document_data = {"a": ArrayUnion(values)}
+
+        inst = self._make_one(document_data)
+
+        expected_array_unions = {_make_field_path("a"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, expected_array_unions)
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a")])
+
+    def test_ctor_w_array_union_nested(self):
+        from google.cloud.firestore_v1beta1.transforms import ArrayUnion
+
+        values = [2, 4, 8]
+        document_data = {"a": {"b": {"c": ArrayUnion(values)}}}
+
+        inst = self._make_one(document_data)
+
+        expected_array_unions = {_make_field_path("a", "b", "c"): values}
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, [])
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, expected_array_unions)
+        self.assertEqual(inst.set_fields, {})
+        self.assertFalse(inst.empty_document)
+        self.assertTrue(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [_make_field_path("a", "b", "c")])
+
+    def test_ctor_w_empty_dict_shallow(self):
+        document_data = {"a": {}}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [_make_field_path("a")]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_empty_dict_nested(self):
+        document_data = {"a": {"b": {"c": {}}}}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [_make_field_path("a", "b", "c")]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+        self.assertEqual(inst.transform_paths, [])
+
+    def test_ctor_w_normal_value_shallow(self):
+        document_data = {"b": 1, "a": 2, "c": 3}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [
+            _make_field_path("a"),
+            _make_field_path("b"),
+            _make_field_path("c"),
+        ]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+
+    def test_ctor_w_normal_value_nested(self):
+        document_data = {"b": {"a": {"d": 4, "c": 3}, "e": 7}, "f": 5}
+
+        inst = self._make_one(document_data)
+
+        expected_field_paths = [
+            _make_field_path("b", "a", "c"),
+            _make_field_path("b", "a", "d"),
+            _make_field_path("b", "e"),
+            _make_field_path("f"),
+        ]
+        self.assertEqual(inst.document_data, document_data)
+        self.assertEqual(inst.field_paths, expected_field_paths)
+        self.assertEqual(inst.deleted_fields, [])
+        self.assertEqual(inst.server_timestamps, [])
+        self.assertEqual(inst.array_removes, {})
+        self.assertEqual(inst.array_unions, {})
+        self.assertEqual(inst.set_fields, document_data)
+        self.assertFalse(inst.empty_document)
+        self.assertFalse(inst.has_transforms)
+
+    def test_get_update_pb_w_exists_precondition(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        document_data = {}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        update_pb = inst.get_update_pb(document_path, exists=False)
+
+        self.assertIsInstance(update_pb, write_pb2.Write)
+        self.assertEqual(update_pb.update.name, document_path)
+        self.assertEqual(update_pb.update.fields, document_data)
+        self.assertTrue(update_pb.HasField("current_document"))
+        self.assertFalse(update_pb.current_document.exists)
+
+    def test_get_update_pb_wo_exists_precondition(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1._helpers import encode_dict
+
+        document_data = {"a": 1}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        update_pb = inst.get_update_pb(document_path)
+
+        self.assertIsInstance(update_pb, write_pb2.Write)
+        self.assertEqual(update_pb.update.name, document_path)
+        self.assertEqual(update_pb.update.fields, encode_dict(document_data))
+        self.assertFalse(update_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_server_timestamp_w_exists_precondition(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1beta1._helpers import REQUEST_TIME_ENUM
+
+        document_data = {"a": SERVER_TIMESTAMP}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path, exists=False)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a")
+        self.assertEqual(transform.set_to_server_value, REQUEST_TIME_ENUM)
+        self.assertTrue(transform_pb.HasField("current_document"))
+        self.assertFalse(transform_pb.current_document.exists)
+
+    def test_get_transform_pb_w_server_timestamp_wo_exists_precondition(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1beta1._helpers import REQUEST_TIME_ENUM
+
+        document_data = {"a": {"b": {"c": SERVER_TIMESTAMP}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        self.assertEqual(transform.set_to_server_value, REQUEST_TIME_ENUM)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    @staticmethod
+    def _array_value_to_list(array_value):
+        from google.cloud.firestore_v1beta1._helpers import decode_value
+
+        return [decode_value(element, client=None) for element in array_value.values]
+
+    def test_get_transform_pb_w_array_remove(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.transforms import ArrayRemove
+
+        values = [2, 4, 8]
+        document_data = {"a": {"b": {"c": ArrayRemove(values)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        removed = self._array_value_to_list(transform.remove_all_from_array)
+        self.assertEqual(removed, values)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+    def test_get_transform_pb_w_array_union(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.transforms import ArrayUnion
+
+        values = [1, 3, 5]
+        document_data = {"a": {"b": {"c": ArrayUnion(values)}}}
+        inst = self._make_one(document_data)
+        document_path = (
+            "projects/project-id/databases/(default)/" "documents/document-id"
+        )
+
+        transform_pb = inst.get_transform_pb(document_path)
+
+        self.assertIsInstance(transform_pb, write_pb2.Write)
+        self.assertEqual(transform_pb.transform.document, document_path)
+        transforms = transform_pb.transform.field_transforms
+        self.assertEqual(len(transforms), 1)
+        transform = transforms[0]
+        self.assertEqual(transform.field_path, "a.b.c")
+        added = self._array_value_to_list(transform.append_missing_elements)
+        self.assertEqual(added, values)
+        self.assertFalse(transform_pb.HasField("current_document"))
+
+
+class Test_pbs_for_create(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, document_data):
+        from google.cloud.firestore_v1beta1._helpers import pbs_for_create
+
+        return pbs_for_create(document_path, document_data)
+
+    @staticmethod
+    def _make_write_w_document(document_path, **data):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1._helpers import encode_dict
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        return write_pb2.Write(
+            update=document_pb2.Document(name=document_path, fields=encode_dict(data)),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+
+    @staticmethod
+    def _make_write_w_transform(document_path, fields):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        server_val = enums.DocumentTransform.FieldTransform.ServerValue
+        transforms = [
+            write_pb2.DocumentTransform.FieldTransform(
+                field_path=field, set_to_server_value=server_val.REQUEST_TIME
+            )
+            for field in fields
+        ]
+
+        return write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=transforms
+            )
+        )
+
+    def _helper(self, do_transform=False, empty_val=False):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        if do_transform:
+            document_data["butter"] = SERVER_TIMESTAMP
+
+        if empty_val:
+            document_data["mustard"] = {}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        if empty_val:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True, mustard={}
+            )
+        else:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True
+            )
+        expected_pbs = [update_pb]
+
+        if do_transform:
+            expected_pbs.append(
+                self._make_write_w_transform(document_path, fields=["butter"])
+            )
+
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_without_transform(self):
+        self._helper()
+
+    def test_w_transform(self):
+        self._helper(do_transform=True)
+
+    def test_w_transform_and_empty_value(self):
+        self._helper(do_transform=True, empty_val=True)
+
+
+class Test_pbs_for_set_no_merge(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, document_data):
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.pbs_for_set_no_merge(document_path, document_data)
+
+    @staticmethod
+    def _make_write_w_document(document_path, **data):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1._helpers import encode_dict
+
+        return write_pb2.Write(
+            update=document_pb2.Document(name=document_path, fields=encode_dict(data))
+        )
+
+    @staticmethod
+    def _make_write_w_transform(document_path, fields):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        server_val = enums.DocumentTransform.FieldTransform.ServerValue
+        transforms = [
+            write_pb2.DocumentTransform.FieldTransform(
+                field_path=field, set_to_server_value=server_val.REQUEST_TIME
+            )
+            for field in fields
+        ]
+
+        return write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=transforms
+            )
+        )
+
+    def test_w_empty_document(self):
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        update_pb = self._make_write_w_document(document_path)
+        expected_pbs = [update_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_w_only_server_timestamp(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"butter": SERVER_TIMESTAMP}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        update_pb = self._make_write_w_document(document_path)
+        transform_pb = self._make_write_w_transform(document_path, ["butter"])
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def _helper(self, do_transform=False, empty_val=False):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        if do_transform:
+            document_data["butter"] = SERVER_TIMESTAMP
+
+        if empty_val:
+            document_data["mustard"] = {}
+
+        write_pbs = self._call_fut(document_path, document_data)
+
+        if empty_val:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True, mustard={}
+            )
+        else:
+            update_pb = self._make_write_w_document(
+                document_path, cheese=1.5, crackers=True
+            )
+        expected_pbs = [update_pb]
+
+        if do_transform:
+            expected_pbs.append(
+                self._make_write_w_transform(document_path, fields=["butter"])
+            )
+
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_defaults(self):
+        self._helper()
+
+    def test_w_transform(self):
+        self._helper(do_transform=True)
+
+    def test_w_transform_and_empty_value(self):
+        # Exercise #5944
+        self._helper(do_transform=True, empty_val=True)
+
+
+class TestDocumentExtractorForMerge(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.DocumentExtractorForMerge
+
+    def _make_one(self, document_data):
+        return self._get_target_class()(document_data)
+
+    def test_ctor_w_empty_document(self):
+        document_data = {}
+
+        inst = self._make_one(document_data)
+
+        self.assertEqual(inst.data_merge, [])
+        self.assertEqual(inst.transform_merge, [])
+        self.assertEqual(inst.merge, [])
+
+    def test_apply_merge_all_w_empty_document(self):
+        document_data = {}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(True)
+
+        self.assertEqual(inst.data_merge, [])
+        self.assertEqual(inst.transform_merge, [])
+        self.assertEqual(inst.merge, [])
+        self.assertFalse(inst.has_updates)
+
+    def test_apply_merge_all_w_delete(self):
+        from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+
+        document_data = {"write_me": "value", "delete_me": DELETE_FIELD}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(True)
+
+        expected_data_merge = [
+            _make_field_path("delete_me"),
+            _make_field_path("write_me"),
+        ]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, [])
+        self.assertEqual(inst.merge, expected_data_merge)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_all_w_server_timestamp(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_data = {"write_me": "value", "timestamp": SERVER_TIMESTAMP}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(True)
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("timestamp")]
+        expected_merge = [_make_field_path("timestamp"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_empty_document(self):
+        document_data = {}
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["nonesuch", "or.this"])
+
+    def test_apply_merge_list_fields_w_unmerged_delete(self):
+        from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+
+        document_data = {
+            "write_me": "value",
+            "delete_me": DELETE_FIELD,
+            "ignore_me": 123,
+            "unmerged_delete": DELETE_FIELD,
+        }
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["write_me", "delete_me"])
+
+    def test_apply_merge_list_fields_w_delete(self):
+        from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+
+        document_data = {
+            "write_me": "value",
+            "delete_me": DELETE_FIELD,
+            "ignore_me": 123,
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge(["write_me", "delete_me"])
+
+        expected_set_fields = {"write_me": "value"}
+        expected_deleted_fields = [_make_field_path("delete_me")]
+        self.assertEqual(inst.set_fields, expected_set_fields)
+        self.assertEqual(inst.deleted_fields, expected_deleted_fields)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_prefixes(self):
+
+        document_data = {"a": {"b": {"c": 123}}}
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["a", "a.b"])
+
+    def test_apply_merge_list_fields_w_missing_data_string_paths(self):
+
+        document_data = {"write_me": "value", "ignore_me": 123}
+        inst = self._make_one(document_data)
+
+        with self.assertRaises(ValueError):
+            inst.apply_merge(["write_me", "nonesuch"])
+
+    def test_apply_merge_list_fields_w_non_merge_field(self):
+
+        document_data = {"write_me": "value", "ignore_me": 123}
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me")])
+
+        expected_set_fields = {"write_me": "value"}
+        self.assertEqual(inst.set_fields, expected_set_fields)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_server_timestamp(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_data = {
+            "write_me": "value",
+            "timestamp": SERVER_TIMESTAMP,
+            "ignored_stamp": SERVER_TIMESTAMP,
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me"), _make_field_path("timestamp")])
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("timestamp")]
+        expected_merge = [_make_field_path("timestamp"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        expected_server_timestamps = [_make_field_path("timestamp")]
+        self.assertEqual(inst.server_timestamps, expected_server_timestamps)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_array_remove(self):
+        from google.cloud.firestore_v1beta1.transforms import ArrayRemove
+
+        values = [2, 4, 8]
+        document_data = {
+            "write_me": "value",
+            "remove_me": ArrayRemove(values),
+            "ignored_remove_me": ArrayRemove((1, 3, 5)),
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me"), _make_field_path("remove_me")])
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("remove_me")]
+        expected_merge = [_make_field_path("remove_me"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        expected_array_removes = {_make_field_path("remove_me"): values}
+        self.assertEqual(inst.array_removes, expected_array_removes)
+        self.assertTrue(inst.has_updates)
+
+    def test_apply_merge_list_fields_w_array_union(self):
+        from google.cloud.firestore_v1beta1.transforms import ArrayUnion
+
+        values = [1, 3, 5]
+        document_data = {
+            "write_me": "value",
+            "union_me": ArrayUnion(values),
+            "ignored_union_me": ArrayUnion((2, 4, 8)),
+        }
+        inst = self._make_one(document_data)
+
+        inst.apply_merge([_make_field_path("write_me"), _make_field_path("union_me")])
+
+        expected_data_merge = [_make_field_path("write_me")]
+        expected_transform_merge = [_make_field_path("union_me")]
+        expected_merge = [_make_field_path("union_me"), _make_field_path("write_me")]
+        self.assertEqual(inst.data_merge, expected_data_merge)
+        self.assertEqual(inst.transform_merge, expected_transform_merge)
+        self.assertEqual(inst.merge, expected_merge)
+        expected_array_unions = {_make_field_path("union_me"): values}
+        self.assertEqual(inst.array_unions, expected_array_unions)
+        self.assertTrue(inst.has_updates)
+
+
+class Test_pbs_for_set_with_merge(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, document_data, merge):
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.pbs_for_set_with_merge(
+            document_path, document_data, merge=merge
+        )
+
+    @staticmethod
+    def _make_write_w_document(document_path, **data):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1._helpers import encode_dict
+
+        return write_pb2.Write(
+            update=document_pb2.Document(name=document_path, fields=encode_dict(data))
+        )
+
+    @staticmethod
+    def _make_write_w_transform(document_path, fields):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        server_val = enums.DocumentTransform.FieldTransform.ServerValue
+        transforms = [
+            write_pb2.DocumentTransform.FieldTransform(
+                field_path=field, set_to_server_value=server_val.REQUEST_TIME
+            )
+            for field in fields
+        ]
+
+        return write_pb2.Write(
+            transform=write_pb2.DocumentTransform(
+                document=document_path, field_transforms=transforms
+            )
+        )
+
+    @staticmethod
+    def _update_document_mask(update_pb, field_paths):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        update_pb.update_mask.CopyFrom(
+            common_pb2.DocumentMask(field_paths=sorted(field_paths))
+        )
+
+    def test_with_merge_true_wo_transform(self):
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        write_pbs = self._call_fut(document_path, document_data, merge=True)
+
+        update_pb = self._make_write_w_document(document_path, **document_data)
+        self._update_document_mask(update_pb, field_paths=sorted(document_data))
+        expected_pbs = [update_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_wo_transform(self):
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        document_data = {"cheese": 1.5, "crackers": True}
+
+        write_pbs = self._call_fut(document_path, document_data, merge=["cheese"])
+
+        update_pb = self._make_write_w_document(
+            document_path, cheese=document_data["cheese"]
+        )
+        self._update_document_mask(update_pb, field_paths=["cheese"])
+        expected_pbs = [update_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_true_w_transform(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = SERVER_TIMESTAMP
+
+        write_pbs = self._call_fut(document_path, document_data, merge=True)
+
+        update_pb = self._make_write_w_document(document_path, **update_data)
+        self._update_document_mask(update_pb, field_paths=sorted(update_data))
+        transform_pb = self._make_write_w_transform(document_path, fields=["butter"])
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_w_transform(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = SERVER_TIMESTAMP
+
+        write_pbs = self._call_fut(
+            document_path, document_data, merge=["cheese", "butter"]
+        )
+
+        update_pb = self._make_write_w_document(
+            document_path, cheese=document_data["cheese"]
+        )
+        self._update_document_mask(update_pb, ["cheese"])
+        transform_pb = self._make_write_w_transform(document_path, fields=["butter"])
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_w_transform_masking_simple(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = {"pecan": SERVER_TIMESTAMP}
+
+        write_pbs = self._call_fut(document_path, document_data, merge=["butter.pecan"])
+
+        update_pb = self._make_write_w_document(document_path)
+        transform_pb = self._make_write_w_transform(
+            document_path, fields=["butter.pecan"]
+        )
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_with_merge_field_w_transform_parent(self):
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+
+        document_path = _make_ref_string(u"little", u"town", u"of", u"ham")
+        update_data = {"cheese": 1.5, "crackers": True}
+        document_data = update_data.copy()
+        document_data["butter"] = {"popcorn": "yum", "pecan": SERVER_TIMESTAMP}
+
+        write_pbs = self._call_fut(
+            document_path, document_data, merge=["cheese", "butter"]
+        )
+
+        update_pb = self._make_write_w_document(
+            document_path, cheese=update_data["cheese"], butter={"popcorn": "yum"}
+        )
+        self._update_document_mask(update_pb, ["cheese", "butter"])
+        transform_pb = self._make_write_w_transform(
+            document_path, fields=["butter.pecan"]
+        )
+        expected_pbs = [update_pb, transform_pb]
+        self.assertEqual(write_pbs, expected_pbs)
+
+
+class TestDocumentExtractorForUpdate(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return _helpers.DocumentExtractorForUpdate
+
+    def _make_one(self, document_data):
+        return self._get_target_class()(document_data)
+
+    def test_ctor_w_empty_document(self):
+        document_data = {}
+
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, [])
+
+    def test_ctor_w_simple_keys(self):
+        document_data = {"a": 1, "b": 2, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a"),
+            _make_field_path("b"),
+            _make_field_path("c"),
+        ]
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+
+    def test_ctor_w_nested_keys(self):
+        document_data = {"a": {"d": {"e": 1}}, "b": {"f": 7}, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a"),
+            _make_field_path("b"),
+            _make_field_path("c"),
+        ]
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+
+    def test_ctor_w_dotted_keys(self):
+        document_data = {"a.d.e": 1, "b.f": 7, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a", "d", "e"),
+            _make_field_path("b", "f"),
+            _make_field_path("c"),
+        ]
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+
+    def test_ctor_w_nested_dotted_keys(self):
+        document_data = {"a.d.e": 1, "b.f": {"h.i": 9}, "c": 3}
+
+        expected_paths = [
+            _make_field_path("a", "d", "e"),
+            _make_field_path("b", "f"),
+            _make_field_path("c"),
+        ]
+        expected_set_fields = {"a": {"d": {"e": 1}}, "b": {"f": {"h.i": 9}}, "c": 3}
+        inst = self._make_one(document_data)
+        self.assertEqual(inst.top_level_paths, expected_paths)
+        self.assertEqual(inst.set_fields, expected_set_fields)
+
+
+class Test_pbs_for_update(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, field_updates, option):
+        from google.cloud.firestore_v1beta1._helpers import pbs_for_update
+
+        return pbs_for_update(document_path, field_updates, option)
+
+    def _helper(self, option=None, do_transform=False, **write_kwargs):
+        from google.cloud.firestore_v1beta1 import _helpers
+        from google.cloud.firestore_v1beta1.field_path import FieldPath
+        from google.cloud.firestore_v1beta1.transforms import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        document_path = _make_ref_string(u"toy", u"car", u"onion", u"garlic")
+        field_path1 = "bitez.yum"
+        value = b"\x00\x01"
+        field_path2 = "blog.internet"
+
+        field_updates = {field_path1: value}
+        if do_transform:
+            field_updates[field_path2] = SERVER_TIMESTAMP
+
+        write_pbs = self._call_fut(document_path, field_updates, option)
+
+        map_pb = document_pb2.MapValue(fields={"yum": _value_pb(bytes_value=value)})
+
+        field_paths = [field_path1]
+
+        expected_update_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields={"bitez": _value_pb(map_value=map_pb)}
+            ),
+            update_mask=common_pb2.DocumentMask(field_paths=field_paths),
+            **write_kwargs
+        )
+        if isinstance(option, _helpers.ExistsOption):
+            precondition = common_pb2.Precondition(exists=False)
+            expected_update_pb.current_document.CopyFrom(precondition)
+        expected_pbs = [expected_update_pb]
+        if do_transform:
+            transform_paths = FieldPath.from_string(field_path2)
+            server_val = enums.DocumentTransform.FieldTransform.ServerValue
+            expected_transform_pb = write_pb2.Write(
+                transform=write_pb2.DocumentTransform(
+                    document=document_path,
+                    field_transforms=[
+                        write_pb2.DocumentTransform.FieldTransform(
+                            field_path=transform_paths.to_api_repr(),
+                            set_to_server_value=server_val.REQUEST_TIME,
+                        )
+                    ],
+                )
+            )
+            expected_pbs.append(expected_transform_pb)
+        self.assertEqual(write_pbs, expected_pbs)
+
+    def test_without_option(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        precondition = common_pb2.Precondition(exists=True)
+        self._helper(current_document=precondition)
+
+    def test_with_exists_option(self):
+        from google.cloud.firestore_v1beta1.client import _helpers
+
+        option = _helpers.ExistsOption(False)
+        self._helper(option=option)
+
+    def test_update_and_transform(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        precondition = common_pb2.Precondition(exists=True)
+        self._helper(current_document=precondition, do_transform=True)
+
+
+class Test_pb_for_delete(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, option):
+        from google.cloud.firestore_v1beta1._helpers import pb_for_delete
+
+        return pb_for_delete(document_path, option)
+
+    def _helper(self, option=None, **write_kwargs):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        document_path = _make_ref_string(u"chicken", u"philly", u"one", u"two")
+        write_pb = self._call_fut(document_path, option)
+
+        expected_pb = write_pb2.Write(delete=document_path, **write_kwargs)
+        self.assertEqual(write_pb, expected_pb)
+
+    def test_without_option(self):
+        self._helper()
+
+    def test_with_option(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        update_time = timestamp_pb2.Timestamp(seconds=1309700594, nanos=822211297)
+        option = _helpers.LastUpdateOption(update_time)
+        precondition = common_pb2.Precondition(update_time=update_time)
+        self._helper(option=option, current_document=precondition)
+
+
+class Test_get_transaction_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut(transaction, **kwargs):
+        from google.cloud.firestore_v1beta1._helpers import get_transaction_id
+
+        return get_transaction_id(transaction, **kwargs)
+
+    def test_no_transaction(self):
+        ret_val = self._call_fut(None)
+        self.assertIsNone(ret_val)
+
+    def test_invalid_transaction(self):
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        self.assertFalse(transaction.in_progress)
+        with self.assertRaises(ValueError):
+            self._call_fut(transaction)
+
+    def test_after_writes_not_allowed(self):
+        from google.cloud.firestore_v1beta1._helpers import ReadAfterWriteError
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        transaction._id = b"under-hook"
+        transaction._write_pbs.append(mock.sentinel.write)
+
+        with self.assertRaises(ReadAfterWriteError):
+            self._call_fut(transaction)
+
+    def test_after_writes_allowed(self):
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        txn_id = b"we-are-0fine"
+        transaction._id = txn_id
+        transaction._write_pbs.append(mock.sentinel.write)
+
+        ret_val = self._call_fut(transaction, read_operation=False)
+        self.assertEqual(ret_val, txn_id)
+
+    def test_good_transaction(self):
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        transaction = Transaction(mock.sentinel.client)
+        txn_id = b"doubt-it"
+        transaction._id = txn_id
+        self.assertTrue(transaction.in_progress)
+
+        self.assertEqual(self._call_fut(transaction), txn_id)
+
+
+class Test_metadata_with_prefix(unittest.TestCase):
+    @staticmethod
+    def _call_fut(database_string):
+        from google.cloud.firestore_v1beta1._helpers import metadata_with_prefix
+
+        return metadata_with_prefix(database_string)
+
+    def test_it(self):
+        database_string = u"projects/prahj/databases/dee-bee"
+        metadata = self._call_fut(database_string)
+
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database_string)])
+
+
+class TestWriteOption(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1._helpers import WriteOption
+
+        return WriteOption
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_modify_write(self):
+        option = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            option.modify_write(None)
+
+
+class TestLastUpdateOption(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1._helpers import LastUpdateOption
+
+        return LastUpdateOption
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        self.assertIs(option._last_update_time, mock.sentinel.timestamp)
+
+    def test___eq___different_type(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = object()
+        self.assertFalse(option == other)
+
+    def test___eq___different_timestamp(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = self._make_one(mock.sentinel.other_timestamp)
+        self.assertFalse(option == other)
+
+    def test___eq___same_timestamp(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = self._make_one(mock.sentinel.timestamp)
+        self.assertTrue(option == other)
+
+    def test_modify_write_update_time(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=683893592, nanos=229362000)
+        option = self._make_one(timestamp_pb)
+        write_pb = write_pb2.Write()
+        ret_val = option.modify_write(write_pb)
+
+        self.assertIsNone(ret_val)
+        expected_doc = common_pb2.Precondition(update_time=timestamp_pb)
+        self.assertEqual(write_pb.current_document, expected_doc)
+
+
+class TestExistsOption(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1._helpers import ExistsOption
+
+        return ExistsOption
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        option = self._make_one(mock.sentinel.totes_bool)
+        self.assertIs(option._exists, mock.sentinel.totes_bool)
+
+    def test___eq___different_type(self):
+        option = self._make_one(mock.sentinel.timestamp)
+        other = object()
+        self.assertFalse(option == other)
+
+    def test___eq___different_exists(self):
+        option = self._make_one(True)
+        other = self._make_one(False)
+        self.assertFalse(option == other)
+
+    def test___eq___same_exists(self):
+        option = self._make_one(True)
+        other = self._make_one(True)
+        self.assertTrue(option == other)
+
+    def test_modify_write(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        for exists in (True, False):
+            option = self._make_one(exists)
+            write_pb = write_pb2.Write()
+            ret_val = option.modify_write(write_pb)
+
+            self.assertIsNone(ret_val)
+            expected_doc = common_pb2.Precondition(exists=exists)
+            self.assertEqual(write_pb.current_document, expected_doc)
+
+
+def _value_pb(**kwargs):
+    from google.cloud.firestore_v1beta1.proto.document_pb2 import Value
+
+    return Value(**kwargs)
+
+
+def _make_ref_string(project, database, *path):
+    from google.cloud.firestore_v1beta1 import _helpers
+
+    doc_rel_path = _helpers.DOCUMENT_PATH_DELIMITER.join(path)
+    return u"projects/{}/databases/{}/documents/{}".format(
+        project, database, doc_rel_path
+    )
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="quark"):
+    from google.cloud.firestore_v1beta1.client import Client
+
+    credentials = _make_credentials()
+
+    with pytest.deprecated_call():
+        return Client(project=project, credentials=credentials)
+
+
+def _make_field_path(*fields):
+    from google.cloud.firestore_v1beta1 import field_path
+
+    return field_path.FieldPath(*fields)
diff --git a/firestore/tests/unit/v1beta1/test_batch.py b/firestore/tests/unit/v1beta1/test_batch.py
new file mode 100644
index 000000000000..831424751594
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_batch.py
@@ -0,0 +1,274 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+import mock
+import pytest
+
+
+class TestWriteBatch(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.batch import WriteBatch
+
+        return WriteBatch
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        batch = self._make_one(mock.sentinel.client)
+        self.assertIs(batch._client, mock.sentinel.client)
+        self.assertEqual(batch._write_pbs, [])
+        self.assertIsNone(batch.write_results)
+        self.assertIsNone(batch.commit_time)
+
+    def test__add_write_pbs(self):
+        batch = self._make_one(mock.sentinel.client)
+        self.assertEqual(batch._write_pbs, [])
+        batch._add_write_pbs([mock.sentinel.write1, mock.sentinel.write2])
+        self.assertEqual(batch._write_pbs, [mock.sentinel.write1, mock.sentinel.write2])
+
+    def test_create(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("this", "one")
+        document_data = {"a": 10, "b": 2.5}
+        ret_val = batch.create(reference, document_data)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={
+                    "a": _value_pb(integer_value=document_data["a"]),
+                    "b": _value_pb(double_value=document_data["b"]),
+                },
+            ),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_set(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("another", "one")
+        field = "zapzap"
+        value = u"meadows and flowers"
+        document_data = {field: value}
+        ret_val = batch.set(reference, document_data)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={field: _value_pb(string_value=value)},
+            )
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_set_merge(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("another", "one")
+        field = "zapzap"
+        value = u"meadows and flowers"
+        document_data = {field: value}
+        ret_val = batch.set(reference, document_data, merge=True)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={field: _value_pb(string_value=value)},
+            ),
+            update_mask={"field_paths": [field]},
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_update(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("cats", "cradle")
+        field_path = "head.foot"
+        value = u"knees toes shoulders"
+        field_updates = {field_path: value}
+
+        ret_val = batch.update(reference, field_updates)
+        self.assertIsNone(ret_val)
+
+        map_pb = document_pb2.MapValue(fields={"foot": _value_pb(string_value=value)})
+        new_write_pb = write_pb2.Write(
+            update=document_pb2.Document(
+                name=reference._document_path,
+                fields={"head": _value_pb(map_value=map_pb)},
+            ),
+            update_mask=common_pb2.DocumentMask(field_paths=[field_path]),
+            current_document=common_pb2.Precondition(exists=True),
+        )
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_delete(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        client = _make_client()
+        batch = self._make_one(client)
+        self.assertEqual(batch._write_pbs, [])
+
+        reference = client.document("early", "mornin", "dawn", "now")
+        ret_val = batch.delete(reference)
+        self.assertIsNone(ret_val)
+        new_write_pb = write_pb2.Write(delete=reference._document_path)
+        self.assertEqual(batch._write_pbs, [new_write_pb])
+
+    def test_commit(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto import firestore_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.Mock(spec=["commit"])
+        timestamp = timestamp_pb2.Timestamp(seconds=1234567, nanos=123456798)
+        commit_response = firestore_pb2.CommitResponse(
+            write_results=[write_pb2.WriteResult(), write_pb2.WriteResult()],
+            commit_time=timestamp,
+        )
+        firestore_api.commit.return_value = commit_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("grand")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a batch with some mutations and call commit().
+        batch = self._make_one(client)
+        document1 = client.document("a", "b")
+        batch.create(document1, {"ten": 10, "buck": u"ets"})
+        document2 = client.document("c", "d", "e", "f")
+        batch.delete(document2)
+        write_pbs = batch._write_pbs[::]
+
+        write_results = batch.commit()
+        self.assertEqual(write_results, list(commit_response.write_results))
+        self.assertEqual(batch.write_results, write_results)
+        self.assertEqual(batch.commit_time, timestamp)
+        # Make sure batch has no more "changes".
+        self.assertEqual(batch._write_pbs, [])
+
+        # Verify the mocks.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_as_context_mgr_wo_error(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto import firestore_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        firestore_api = mock.Mock(spec=["commit"])
+        timestamp = timestamp_pb2.Timestamp(seconds=1234567, nanos=123456798)
+        commit_response = firestore_pb2.CommitResponse(
+            write_results=[write_pb2.WriteResult(), write_pb2.WriteResult()],
+            commit_time=timestamp,
+        )
+        firestore_api.commit.return_value = commit_response
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+        batch = self._make_one(client)
+        document1 = client.document("a", "b")
+        document2 = client.document("c", "d", "e", "f")
+
+        with batch as ctx_mgr:
+            self.assertIs(ctx_mgr, batch)
+            ctx_mgr.create(document1, {"ten": 10, "buck": u"ets"})
+            ctx_mgr.delete(document2)
+            write_pbs = batch._write_pbs[::]
+
+        self.assertEqual(batch.write_results, list(commit_response.write_results))
+        self.assertEqual(batch.commit_time, timestamp)
+        # Make sure batch has no more "changes".
+        self.assertEqual(batch._write_pbs, [])
+
+        # Verify the mocks.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_as_context_mgr_w_error(self):
+        firestore_api = mock.Mock(spec=["commit"])
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+        batch = self._make_one(client)
+        document1 = client.document("a", "b")
+        document2 = client.document("c", "d", "e", "f")
+
+        with self.assertRaises(RuntimeError):
+            with batch as ctx_mgr:
+                ctx_mgr.create(document1, {"ten": 10, "buck": u"ets"})
+                ctx_mgr.delete(document2)
+                raise RuntimeError("testing")
+
+        self.assertIsNone(batch.write_results)
+        self.assertIsNone(batch.commit_time)
+        # batch still has its changes
+        self.assertEqual(len(batch._write_pbs), 2)
+
+        firestore_api.commit.assert_not_called()
+
+
+def _value_pb(**kwargs):
+    from google.cloud.firestore_v1beta1.proto.document_pb2 import Value
+
+    return Value(**kwargs)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="seventy-nine"):
+    from google.cloud.firestore_v1beta1.client import Client
+
+    credentials = _make_credentials()
+
+    with pytest.deprecated_call():
+        return Client(project=project, credentials=credentials)
diff --git a/firestore/tests/unit/v1beta1/test_client.py b/firestore/tests/unit/v1beta1/test_client.py
new file mode 100644
index 000000000000..4aa5a36efb71
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_client.py
@@ -0,0 +1,667 @@
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import types
+import unittest
+
+import mock
+import pytest
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "my-prahjekt"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def _make_default_one(self):
+        credentials = _make_credentials()
+        return self._make_one(project=self.PROJECT, credentials=credentials)
+
+    def test_constructor(self):
+        from google.cloud.firestore_v1beta1.client import DEFAULT_DATABASE
+
+        credentials = _make_credentials()
+
+        with pytest.deprecated_call():
+            client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertEqual(client._credentials, credentials)
+        self.assertEqual(client._database, DEFAULT_DATABASE)
+
+    def test_constructor_explicit(self):
+        credentials = _make_credentials()
+        database = "now-db"
+
+        with pytest.deprecated_call():
+            client = self._make_one(
+                project=self.PROJECT, credentials=credentials, database=database
+            )
+
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertEqual(client._credentials, credentials)
+        self.assertEqual(client._database, database)
+
+    @mock.patch(
+        "google.cloud.firestore_v1beta1.gapic.firestore_client." "FirestoreClient",
+        autospec=True,
+        return_value=mock.sentinel.firestore_api,
+    )
+    def test__firestore_api_property(self, mock_client):
+        mock_client.SERVICE_ADDRESS = "endpoint"
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        self.assertIsNone(client._firestore_api_internal)
+        firestore_api = client._firestore_api
+        self.assertIs(firestore_api, mock_client.return_value)
+        self.assertIs(firestore_api, client._firestore_api_internal)
+        mock_client.assert_called_once_with(transport=client._transport)
+
+        # Call again to show that it is cached, but call count is still 1.
+        self.assertIs(client._firestore_api, mock_client.return_value)
+        self.assertEqual(mock_client.call_count, 1)
+
+    def test___database_string_property(self):
+        credentials = _make_credentials()
+        database = "cheeeeez"
+
+        with pytest.deprecated_call():
+            client = self._make_one(
+                project=self.PROJECT, credentials=credentials, database=database
+            )
+
+        self.assertIsNone(client._database_string_internal)
+        database_string = client._database_string
+        expected = "projects/{}/databases/{}".format(client.project, client._database)
+        self.assertEqual(database_string, expected)
+        self.assertIs(database_string, client._database_string_internal)
+
+        # Swap it out with a unique value to verify it is cached.
+        client._database_string_internal = mock.sentinel.cached
+        self.assertIs(client._database_string, mock.sentinel.cached)
+
+    def test___rpc_metadata_property(self):
+        credentials = _make_credentials()
+        database = "quanta"
+
+        with pytest.deprecated_call():
+            client = self._make_one(
+                project=self.PROJECT, credentials=credentials, database=database
+            )
+
+        self.assertEqual(
+            client._rpc_metadata,
+            [("google-cloud-resource-prefix", client._database_string)],
+        )
+
+    def test_collection_factory(self):
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+
+        collection_id = "users"
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        collection = client.collection(collection_id)
+
+        self.assertEqual(collection._path, (collection_id,))
+        self.assertIs(collection._client, client)
+        self.assertIsInstance(collection, CollectionReference)
+
+    def test_collection_factory_nested(self):
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        parts = ("users", "alovelace", "beep")
+        collection_path = "/".join(parts)
+        collection1 = client.collection(collection_path)
+
+        self.assertEqual(collection1._path, parts)
+        self.assertIs(collection1._client, client)
+        self.assertIsInstance(collection1, CollectionReference)
+
+        # Make sure using segments gives the same result.
+        collection2 = client.collection(*parts)
+        self.assertEqual(collection2._path, parts)
+        self.assertIs(collection2._client, client)
+        self.assertIsInstance(collection2, CollectionReference)
+
+    def test_document_factory(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        parts = ("rooms", "roomA")
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        doc_path = "/".join(parts)
+        document1 = client.document(doc_path)
+
+        self.assertEqual(document1._path, parts)
+        self.assertIs(document1._client, client)
+        self.assertIsInstance(document1, DocumentReference)
+
+        # Make sure using segments gives the same result.
+        document2 = client.document(*parts)
+        self.assertEqual(document2._path, parts)
+        self.assertIs(document2._client, client)
+        self.assertIsInstance(document2, DocumentReference)
+
+    def test_document_factory_nested(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        parts = ("rooms", "roomA", "shoes", "dressy")
+        doc_path = "/".join(parts)
+        document1 = client.document(doc_path)
+
+        self.assertEqual(document1._path, parts)
+        self.assertIs(document1._client, client)
+        self.assertIsInstance(document1, DocumentReference)
+
+        # Make sure using segments gives the same result.
+        document2 = client.document(*parts)
+        self.assertEqual(document2._path, parts)
+        self.assertIs(document2._client, client)
+        self.assertIsInstance(document2, DocumentReference)
+
+    def test_field_path(self):
+        klass = self._get_target_class()
+        self.assertEqual(klass.field_path("a", "b", "c"), "a.b.c")
+
+    def test_write_option_last_update(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1._helpers import LastUpdateOption
+
+        timestamp = timestamp_pb2.Timestamp(seconds=1299767599, nanos=811111097)
+
+        klass = self._get_target_class()
+        option = klass.write_option(last_update_time=timestamp)
+        self.assertIsInstance(option, LastUpdateOption)
+        self.assertEqual(option._last_update_time, timestamp)
+
+    def test_write_option_exists(self):
+        from google.cloud.firestore_v1beta1._helpers import ExistsOption
+
+        klass = self._get_target_class()
+
+        option1 = klass.write_option(exists=False)
+        self.assertIsInstance(option1, ExistsOption)
+        self.assertFalse(option1._exists)
+
+        option2 = klass.write_option(exists=True)
+        self.assertIsInstance(option2, ExistsOption)
+        self.assertTrue(option2._exists)
+
+    def test_write_open_neither_arg(self):
+        from google.cloud.firestore_v1beta1.client import _BAD_OPTION_ERR
+
+        klass = self._get_target_class()
+        with self.assertRaises(TypeError) as exc_info:
+            klass.write_option()
+
+        self.assertEqual(exc_info.exception.args, (_BAD_OPTION_ERR,))
+
+    def test_write_multiple_args(self):
+        from google.cloud.firestore_v1beta1.client import _BAD_OPTION_ERR
+
+        klass = self._get_target_class()
+        with self.assertRaises(TypeError) as exc_info:
+            klass.write_option(exists=False, last_update_time=mock.sentinel.timestamp)
+
+        self.assertEqual(exc_info.exception.args, (_BAD_OPTION_ERR,))
+
+    def test_write_bad_arg(self):
+        from google.cloud.firestore_v1beta1.client import _BAD_OPTION_ERR
+
+        klass = self._get_target_class()
+        with self.assertRaises(TypeError) as exc_info:
+            klass.write_option(spinach="popeye")
+
+        extra = "{!r} was provided".format("spinach")
+        self.assertEqual(exc_info.exception.args, (_BAD_OPTION_ERR, extra))
+
+    def test_collections(self):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+
+        collection_ids = ["users", "projects"]
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        firestore_api = mock.Mock(spec=["list_collection_ids"])
+        client._firestore_api_internal = firestore_api
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        iterator = _Iterator(pages=[collection_ids])
+        firestore_api.list_collection_ids.return_value = iterator
+
+        collections = list(client.collections())
+
+        self.assertEqual(len(collections), len(collection_ids))
+        for collection, collection_id in zip(collections, collection_ids):
+            self.assertIsInstance(collection, CollectionReference)
+            self.assertEqual(collection.parent, None)
+            self.assertEqual(collection.id, collection_id)
+
+        firestore_api.list_collection_ids.assert_called_once_with(
+            client._database_string, metadata=client._rpc_metadata
+        )
+
+    def _get_all_helper(self, client, references, document_pbs, **kwargs):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["batch_get_documents"])
+        response_iterator = iter(document_pbs)
+        firestore_api.batch_get_documents.return_value = response_iterator
+
+        # Attach the fake GAPIC to a real client.
+        client._firestore_api_internal = firestore_api
+
+        # Actually call get_all().
+        snapshots = client.get_all(references, **kwargs)
+        self.assertIsInstance(snapshots, types.GeneratorType)
+
+        return list(snapshots)
+
+    def _info_for_get_all(self, data1, data2):
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        document1 = client.document("pineapple", "lamp1")
+        document2 = client.document("pineapple", "lamp2")
+
+        # Make response protobufs.
+        document_pb1, read_time = _doc_get_info(document1._document_path, data1)
+        response1 = _make_batch_response(found=document_pb1, read_time=read_time)
+
+        document_pb2, read_time = _doc_get_info(document2._document_path, data2)
+        response2 = _make_batch_response(found=document_pb2, read_time=read_time)
+
+        return client, document1, document2, response1, response2
+
+    def test_get_all(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        data1 = {"a": u"cheese"}
+        data2 = {"b": True, "c": 18}
+        info = self._info_for_get_all(data1, data2)
+        client, document1, document2, response1, response2 = info
+
+        # Exercise the mocked ``batch_get_documents``.
+        field_paths = ["a", "b"]
+        snapshots = self._get_all_helper(
+            client,
+            [document1, document2],
+            [response1, response2],
+            field_paths=field_paths,
+        )
+        self.assertEqual(len(snapshots), 2)
+
+        snapshot1 = snapshots[0]
+        self.assertIsInstance(snapshot1, DocumentSnapshot)
+        self.assertIs(snapshot1._reference, document1)
+        self.assertEqual(snapshot1._data, data1)
+
+        snapshot2 = snapshots[1]
+        self.assertIsInstance(snapshot2, DocumentSnapshot)
+        self.assertIs(snapshot2._reference, document2)
+        self.assertEqual(snapshot2._data, data2)
+
+        # Verify the call to the mock.
+        doc_paths = [document1._document_path, document2._document_path]
+        mask = common_pb2.DocumentMask(field_paths=field_paths)
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            mask,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all_with_transaction(self):
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        data = {"so-much": 484}
+        info = self._info_for_get_all(data, {})
+        client, document, _, response, _ = info
+        transaction = client.transaction()
+        txn_id = b"the-man-is-non-stop"
+        transaction._id = txn_id
+
+        # Exercise the mocked ``batch_get_documents``.
+        snapshots = self._get_all_helper(
+            client, [document], [response], transaction=transaction
+        )
+        self.assertEqual(len(snapshots), 1)
+
+        snapshot = snapshots[0]
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        self.assertIs(snapshot._reference, document)
+        self.assertEqual(snapshot._data, data)
+
+        # Verify the call to the mock.
+        doc_paths = [document._document_path]
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            None,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all_unknown_result(self):
+        from google.cloud.firestore_v1beta1.client import _BAD_DOC_TEMPLATE
+
+        info = self._info_for_get_all({"z": 28.5}, {})
+        client, document, _, _, response = info
+
+        # Exercise the mocked ``batch_get_documents``.
+        with self.assertRaises(ValueError) as exc_info:
+            self._get_all_helper(client, [document], [response])
+
+        err_msg = _BAD_DOC_TEMPLATE.format(response.found.name)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+        # Verify the call to the mock.
+        doc_paths = [document._document_path]
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            None,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_all_wrong_order(self):
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        data1 = {"up": 10}
+        data2 = {"down": -10}
+        info = self._info_for_get_all(data1, data2)
+        client, document1, document2, response1, response2 = info
+        document3 = client.document("pineapple", "lamp3")
+        response3 = _make_batch_response(missing=document3._document_path)
+
+        # Exercise the mocked ``batch_get_documents``.
+        snapshots = self._get_all_helper(
+            client, [document1, document2, document3], [response2, response1, response3]
+        )
+
+        self.assertEqual(len(snapshots), 3)
+
+        snapshot1 = snapshots[0]
+        self.assertIsInstance(snapshot1, DocumentSnapshot)
+        self.assertIs(snapshot1._reference, document2)
+        self.assertEqual(snapshot1._data, data2)
+
+        snapshot2 = snapshots[1]
+        self.assertIsInstance(snapshot2, DocumentSnapshot)
+        self.assertIs(snapshot2._reference, document1)
+        self.assertEqual(snapshot2._data, data1)
+
+        self.assertFalse(snapshots[2].exists)
+
+        # Verify the call to the mock.
+        doc_paths = [
+            document1._document_path,
+            document2._document_path,
+            document3._document_path,
+        ]
+        client._firestore_api.batch_get_documents.assert_called_once_with(
+            client._database_string,
+            doc_paths,
+            None,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_batch(self):
+        from google.cloud.firestore_v1beta1.batch import WriteBatch
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        batch = client.batch()
+        self.assertIsInstance(batch, WriteBatch)
+        self.assertIs(batch._client, client)
+        self.assertEqual(batch._write_pbs, [])
+
+    def test_transaction(self):
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        with pytest.deprecated_call():
+            client = self._make_default_one()
+
+        transaction = client.transaction(max_attempts=3, read_only=True)
+        self.assertIsInstance(transaction, Transaction)
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertEqual(transaction._max_attempts, 3)
+        self.assertTrue(transaction._read_only)
+        self.assertIsNone(transaction._id)
+
+
+class Test__reference_info(unittest.TestCase):
+    @staticmethod
+    def _call_fut(references):
+        from google.cloud.firestore_v1beta1.client import _reference_info
+
+        return _reference_info(references)
+
+    def test_it(self):
+        from google.cloud.firestore_v1beta1.client import Client
+
+        credentials = _make_credentials()
+
+        with pytest.deprecated_call():
+            client = Client(project="hi-projject", credentials=credentials)
+
+        reference1 = client.document("a", "b")
+        reference2 = client.document("a", "b", "c", "d")
+        reference3 = client.document("a", "b")
+        reference4 = client.document("f", "g")
+
+        doc_path1 = reference1._document_path
+        doc_path2 = reference2._document_path
+        doc_path3 = reference3._document_path
+        doc_path4 = reference4._document_path
+        self.assertEqual(doc_path1, doc_path3)
+
+        document_paths, reference_map = self._call_fut(
+            [reference1, reference2, reference3, reference4]
+        )
+        self.assertEqual(document_paths, [doc_path1, doc_path2, doc_path3, doc_path4])
+        # reference3 over-rides reference1.
+        expected_map = {
+            doc_path2: reference2,
+            doc_path3: reference3,
+            doc_path4: reference4,
+        }
+        self.assertEqual(reference_map, expected_map)
+
+
+class Test__get_reference(unittest.TestCase):
+    @staticmethod
+    def _call_fut(document_path, reference_map):
+        from google.cloud.firestore_v1beta1.client import _get_reference
+
+        return _get_reference(document_path, reference_map)
+
+    def test_success(self):
+        doc_path = "a/b/c"
+        reference_map = {doc_path: mock.sentinel.reference}
+        self.assertIs(self._call_fut(doc_path, reference_map), mock.sentinel.reference)
+
+    def test_failure(self):
+        from google.cloud.firestore_v1beta1.client import _BAD_DOC_TEMPLATE
+
+        doc_path = "1/888/call-now"
+        with self.assertRaises(ValueError) as exc_info:
+            self._call_fut(doc_path, {})
+
+        err_msg = _BAD_DOC_TEMPLATE.format(doc_path)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+
+class Test__parse_batch_get(unittest.TestCase):
+    @staticmethod
+    def _call_fut(get_doc_response, reference_map, client=mock.sentinel.client):
+        from google.cloud.firestore_v1beta1.client import _parse_batch_get
+
+        return _parse_batch_get(get_doc_response, reference_map, client)
+
+    @staticmethod
+    def _dummy_ref_string():
+        from google.cloud.firestore_v1beta1.client import DEFAULT_DATABASE
+
+        project = u"bazzzz"
+        collection_id = u"fizz"
+        document_id = u"buzz"
+        return u"projects/{}/databases/{}/documents/{}/{}".format(
+            project, DEFAULT_DATABASE, collection_id, document_id
+        )
+
+    def test_found(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        now = datetime.datetime.utcnow()
+        read_time = _datetime_to_pb_timestamp(now)
+        delta = datetime.timedelta(seconds=100)
+        update_time = _datetime_to_pb_timestamp(now - delta)
+        create_time = _datetime_to_pb_timestamp(now - 2 * delta)
+
+        ref_string = self._dummy_ref_string()
+        document_pb = document_pb2.Document(
+            name=ref_string,
+            fields={
+                "foo": document_pb2.Value(double_value=1.5),
+                "bar": document_pb2.Value(string_value=u"skillz"),
+            },
+            create_time=create_time,
+            update_time=update_time,
+        )
+        response_pb = _make_batch_response(found=document_pb, read_time=read_time)
+
+        reference_map = {ref_string: mock.sentinel.reference}
+        snapshot = self._call_fut(response_pb, reference_map)
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        self.assertIs(snapshot._reference, mock.sentinel.reference)
+        self.assertEqual(snapshot._data, {"foo": 1.5, "bar": u"skillz"})
+        self.assertTrue(snapshot._exists)
+        self.assertEqual(snapshot.read_time, read_time)
+        self.assertEqual(snapshot.create_time, create_time)
+        self.assertEqual(snapshot.update_time, update_time)
+
+    def test_missing(self):
+        ref_string = self._dummy_ref_string()
+        response_pb = _make_batch_response(missing=ref_string)
+
+        snapshot = self._call_fut(response_pb, {})
+        self.assertFalse(snapshot.exists)
+
+    def test_unset_result_type(self):
+        response_pb = _make_batch_response()
+        with self.assertRaises(ValueError):
+            self._call_fut(response_pb, {})
+
+    def test_unknown_result_type(self):
+        response_pb = mock.Mock(spec=["WhichOneof"])
+        response_pb.WhichOneof.return_value = "zoob_value"
+
+        with self.assertRaises(ValueError):
+            self._call_fut(response_pb, {})
+
+        response_pb.WhichOneof.assert_called_once_with("result")
+
+
+class Test__get_doc_mask(unittest.TestCase):
+    @staticmethod
+    def _call_fut(field_paths):
+        from google.cloud.firestore_v1beta1.client import _get_doc_mask
+
+        return _get_doc_mask(field_paths)
+
+    def test_none(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_paths(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        field_paths = ["a.b", "c"]
+        result = self._call_fut(field_paths)
+        expected = common_pb2.DocumentMask(field_paths=field_paths)
+        self.assertEqual(result, expected)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_batch_response(**kwargs):
+    from google.cloud.firestore_v1beta1.proto import firestore_pb2
+
+    return firestore_pb2.BatchGetDocumentsResponse(**kwargs)
+
+
+def _doc_get_info(ref_string, values):
+    from google.cloud.firestore_v1beta1.proto import document_pb2
+    from google.cloud._helpers import _datetime_to_pb_timestamp
+    from google.cloud.firestore_v1beta1 import _helpers
+
+    now = datetime.datetime.utcnow()
+    read_time = _datetime_to_pb_timestamp(now)
+    delta = datetime.timedelta(seconds=100)
+    update_time = _datetime_to_pb_timestamp(now - delta)
+    create_time = _datetime_to_pb_timestamp(now - 2 * delta)
+
+    document_pb = document_pb2.Document(
+        name=ref_string,
+        fields=_helpers.encode_dict(values),
+        create_time=create_time,
+        update_time=update_time,
+    )
+
+    return document_pb, read_time
diff --git a/firestore/tests/unit/v1beta1/test_collection.py b/firestore/tests/unit/v1beta1/test_collection.py
new file mode 100644
index 000000000000..2bc7695ae940
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_collection.py
@@ -0,0 +1,593 @@
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import types
+import unittest
+
+import mock
+import pytest
+import six
+
+
+class TestCollectionReference(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+
+        return CollectionReference
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    @staticmethod
+    def _get_public_methods(klass):
+        return set(
+            name
+            for name, value in six.iteritems(klass.__dict__)
+            if (not name.startswith("_") and isinstance(value, types.FunctionType))
+        )
+
+    def test_query_method_matching(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        query_methods = self._get_public_methods(Query)
+        klass = self._get_target_class()
+        collection_methods = self._get_public_methods(klass)
+        # Make sure every query method is present on
+        # ``CollectionReference``.
+        self.assertLessEqual(query_methods, collection_methods)
+
+    def test_constructor(self):
+        collection_id1 = "rooms"
+        document_id = "roomA"
+        collection_id2 = "messages"
+        client = mock.sentinel.client
+
+        collection = self._make_one(
+            collection_id1, document_id, collection_id2, client=client
+        )
+        self.assertIs(collection._client, client)
+        expected_path = (collection_id1, document_id, collection_id2)
+        self.assertEqual(collection._path, expected_path)
+
+    def test_constructor_invalid_path(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+        with self.assertRaises(ValueError):
+            self._make_one(99, "doc", "bad-collection-id")
+        with self.assertRaises(ValueError):
+            self._make_one("bad-document-ID", None, "sub-collection")
+        with self.assertRaises(ValueError):
+            self._make_one("Just", "A-Document")
+
+    def test_constructor_invalid_kwarg(self):
+        with self.assertRaises(TypeError):
+            self._make_one("Coh-lek-shun", donut=True)
+
+    def test___eq___other_type(self):
+        client = mock.sentinel.client
+        collection = self._make_one("name", client=client)
+        other = object()
+        self.assertFalse(collection == other)
+
+    def test___eq___different_path_same_client(self):
+        client = mock.sentinel.client
+        collection = self._make_one("name", client=client)
+        other = self._make_one("other", client=client)
+        self.assertFalse(collection == other)
+
+    def test___eq___same_path_different_client(self):
+        client = mock.sentinel.client
+        other_client = mock.sentinel.other_client
+        collection = self._make_one("name", client=client)
+        other = self._make_one("name", client=other_client)
+        self.assertFalse(collection == other)
+
+    def test___eq___same_path_same_client(self):
+        client = mock.sentinel.client
+        collection = self._make_one("name", client=client)
+        other = self._make_one("name", client=client)
+        self.assertTrue(collection == other)
+
+    def test_id_property(self):
+        collection_id = "hi-bob"
+        collection = self._make_one(collection_id)
+        self.assertEqual(collection.id, collection_id)
+
+    def test_parent_property(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        collection_id1 = "grocery-store"
+        document_id = "market"
+        collection_id2 = "darth"
+        client = _make_client()
+        collection = self._make_one(
+            collection_id1, document_id, collection_id2, client=client
+        )
+
+        parent = collection.parent
+        self.assertIsInstance(parent, DocumentReference)
+        self.assertIs(parent._client, client)
+        self.assertEqual(parent._path, (collection_id1, document_id))
+
+    def test_parent_property_top_level(self):
+        collection = self._make_one("tahp-leh-vull")
+        self.assertIsNone(collection.parent)
+
+    def test_document_factory_explicit_id(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        collection_id = "grocery-store"
+        document_id = "market"
+        client = _make_client()
+        collection = self._make_one(collection_id, client=client)
+
+        child = collection.document(document_id)
+        self.assertIsInstance(child, DocumentReference)
+        self.assertIs(child._client, client)
+        self.assertEqual(child._path, (collection_id, document_id))
+
+    @mock.patch(
+        "google.cloud.firestore_v1beta1.collection._auto_id",
+        return_value="zorpzorpthreezorp012",
+    )
+    def test_document_factory_auto_id(self, mock_auto_id):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        collection_name = "space-town"
+        client = _make_client()
+        collection = self._make_one(collection_name, client=client)
+
+        child = collection.document()
+        self.assertIsInstance(child, DocumentReference)
+        self.assertIs(child._client, client)
+        self.assertEqual(child._path, (collection_name, mock_auto_id.return_value))
+
+        mock_auto_id.assert_called_once_with()
+
+    def test__parent_info_top_level(self):
+        client = _make_client()
+        collection_id = "soap"
+        collection = self._make_one(collection_id, client=client)
+
+        parent_path, expected_prefix = collection._parent_info()
+
+        expected_path = "projects/{}/databases/{}/documents".format(
+            client.project, client._database
+        )
+        self.assertEqual(parent_path, expected_path)
+        prefix = "{}/{}".format(expected_path, collection_id)
+        self.assertEqual(expected_prefix, prefix)
+
+    def test__parent_info_nested(self):
+        collection_id1 = "bar"
+        document_id = "baz"
+        collection_id2 = "chunk"
+        client = _make_client()
+        collection = self._make_one(
+            collection_id1, document_id, collection_id2, client=client
+        )
+
+        parent_path, expected_prefix = collection._parent_info()
+
+        expected_path = "projects/{}/databases/{}/documents/{}/{}".format(
+            client.project, client._database, collection_id1, document_id
+        )
+        self.assertEqual(parent_path, expected_path)
+        prefix = "{}/{}".format(expected_path, collection_id2)
+        self.assertEqual(expected_prefix, prefix)
+
+    def test_add_auto_assigned(self):
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+        from google.cloud.firestore_v1beta1 import SERVER_TIMESTAMP
+        from google.cloud.firestore_v1beta1._helpers import pbs_for_set_no_merge
+
+        # Create a minimal fake GAPIC add attach it to a real client.
+        firestore_api = mock.Mock(spec=["create_document", "commit"])
+        write_result = mock.Mock(
+            update_time=mock.sentinel.update_time, spec=["update_time"]
+        )
+        commit_response = mock.Mock(
+            write_results=[write_result],
+            spec=["write_results", "commit_time"],
+            commit_time=mock.sentinel.commit_time,
+        )
+        firestore_api.commit.return_value = commit_response
+        create_doc_response = document_pb2.Document()
+        firestore_api.create_document.return_value = create_doc_response
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a collection.
+        collection = self._make_one("grand-parent", "parent", "child", client=client)
+
+        # Add a dummy response for the fake GAPIC.
+        parent_path = collection.parent._document_path
+        auto_assigned_id = "cheezburger"
+        name = "{}/{}/{}".format(parent_path, collection.id, auto_assigned_id)
+        create_doc_response = document_pb2.Document(name=name)
+        create_doc_response.update_time.FromDatetime(datetime.datetime.utcnow())
+        firestore_api.create_document.return_value = create_doc_response
+
+        # Actually call add() on our collection; include a transform to make
+        # sure transforms during adds work.
+        document_data = {"been": "here", "now": SERVER_TIMESTAMP}
+        update_time, document_ref = collection.add(document_data)
+
+        # Verify the response and the mocks.
+        self.assertIs(update_time, mock.sentinel.update_time)
+        self.assertIsInstance(document_ref, DocumentReference)
+        self.assertIs(document_ref._client, client)
+        expected_path = collection._path + (auto_assigned_id,)
+        self.assertEqual(document_ref._path, expected_path)
+
+        expected_document_pb = document_pb2.Document()
+        firestore_api.create_document.assert_called_once_with(
+            parent_path,
+            collection_id=collection.id,
+            document_id=None,
+            document=expected_document_pb,
+            mask=None,
+            metadata=client._rpc_metadata,
+        )
+        write_pbs = pbs_for_set_no_merge(document_ref._document_path, document_data)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    @staticmethod
+    def _write_pb_for_create(document_path, document_data):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(document_data)
+            ),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+
+    def test_add_explicit_id(self):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        write_result = mock.Mock(
+            update_time=mock.sentinel.update_time, spec=["update_time"]
+        )
+        commit_response = mock.Mock(
+            write_results=[write_result],
+            spec=["write_results", "commit_time"],
+            commit_time=mock.sentinel.commit_time,
+        )
+        firestore_api.commit.return_value = commit_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a collection and call add().
+        collection = self._make_one("parent", client=client)
+        document_data = {"zorp": 208.75, "i-did-not": b"know that"}
+        doc_id = "child"
+        update_time, document_ref = collection.add(document_data, document_id=doc_id)
+
+        # Verify the response and the mocks.
+        self.assertIs(update_time, mock.sentinel.update_time)
+        self.assertIsInstance(document_ref, DocumentReference)
+        self.assertIs(document_ref._client, client)
+        self.assertEqual(document_ref._path, (collection.id, doc_id))
+
+        write_pb = self._write_pb_for_create(document_ref._document_path, document_data)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_select(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        field_paths = ["a", "b"]
+        query = collection.select(field_paths)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        projection_paths = [
+            field_ref.field_path for field_ref in query._projection.fields
+        ]
+        self.assertEqual(projection_paths, field_paths)
+
+    @staticmethod
+    def _make_field_filter_pb(field_path, op_string, value):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+        from google.cloud.firestore_v1beta1.query import _enum_from_op_string
+
+        return query_pb2.StructuredQuery.FieldFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            op=_enum_from_op_string(op_string),
+            value=_helpers.encode_value(value),
+        )
+
+    def test_where(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        field_path = "foo"
+        op_string = "=="
+        value = 45
+        query = collection.where(field_path, op_string, value)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(len(query._field_filters), 1)
+        field_filter_pb = query._field_filters[0]
+        self.assertEqual(
+            field_filter_pb, self._make_field_filter_pb(field_path, op_string, value)
+        )
+
+    @staticmethod
+    def _make_order_pb(field_path, direction):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+        from google.cloud.firestore_v1beta1.query import _enum_from_direction
+
+        return query_pb2.StructuredQuery.Order(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            direction=_enum_from_direction(direction),
+        )
+
+    def test_order_by(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        field_path = "foo"
+        direction = Query.DESCENDING
+        query = collection.order_by(field_path, direction=direction)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(len(query._orders), 1)
+        order_pb = query._orders[0]
+        self.assertEqual(order_pb, self._make_order_pb(field_path, direction))
+
+    def test_limit(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        limit = 15
+        query = collection.limit(limit)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._limit, limit)
+
+    def test_offset(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        offset = 113
+        query = collection.offset(offset)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._offset, offset)
+
+    def test_start_at(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"a": "b"}
+        query = collection.start_at(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._start_at, (doc_fields, True))
+
+    def test_start_after(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"d": "foo", "e": 10}
+        query = collection.start_after(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._start_at, (doc_fields, False))
+
+    def test_end_before(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"bar": 10.5}
+        query = collection.end_before(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._end_at, (doc_fields, True))
+
+    def test_end_at(self):
+        from google.cloud.firestore_v1beta1.query import Query
+
+        collection = self._make_one("collection")
+        doc_fields = {"opportunity": True, "reason": 9}
+        query = collection.end_at(doc_fields)
+
+        self.assertIsInstance(query, Query)
+        self.assertIs(query._parent, collection)
+        self.assertEqual(query._end_at, (doc_fields, False))
+
+    def _list_documents_helper(self, page_size=None):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+        from google.cloud.firestore_v1beta1.gapic.firestore_client import (
+            FirestoreClient,
+        )
+        from google.cloud.firestore_v1beta1.proto.document_pb2 import Document
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        client = _make_client()
+        template = client._database_string + "/documents/{}"
+        document_ids = ["doc-1", "doc-2"]
+        documents = [
+            Document(name=template.format(document_id)) for document_id in document_ids
+        ]
+        iterator = _Iterator(pages=[documents])
+        api_client = mock.create_autospec(FirestoreClient)
+        api_client.list_documents.return_value = iterator
+        client._firestore_api_internal = api_client
+        collection = self._make_one("collection", client=client)
+
+        if page_size is not None:
+            documents = list(collection.list_documents(page_size=page_size))
+        else:
+            documents = list(collection.list_documents())
+
+        # Verify the response and the mocks.
+        self.assertEqual(len(documents), len(document_ids))
+        for document, document_id in zip(documents, document_ids):
+            self.assertIsInstance(document, DocumentReference)
+            self.assertEqual(document.parent, collection)
+            self.assertEqual(document.id, document_id)
+
+        parent, _ = collection._parent_info()
+        api_client.list_documents.assert_called_once_with(
+            parent,
+            collection.id,
+            page_size=page_size,
+            show_missing=True,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_list_documents_wo_page_size(self):
+        self._list_documents_helper()
+
+    def test_list_documents_w_page_size(self):
+        self._list_documents_helper(page_size=25)
+
+    @mock.patch("google.cloud.firestore_v1beta1.query.Query", autospec=True)
+    def test_get(self, query_class):
+        import warnings
+
+        collection = self._make_one("collection")
+        with warnings.catch_warnings(record=True) as warned:
+            get_response = collection.get()
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(get_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=None)
+
+        # Verify the deprecation
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+    @mock.patch("google.cloud.firestore_v1beta1.query.Query", autospec=True)
+    def test_get_with_transaction(self, query_class):
+        import warnings
+
+        collection = self._make_one("collection")
+        transaction = mock.sentinel.txn
+        with warnings.catch_warnings(record=True) as warned:
+            get_response = collection.get(transaction=transaction)
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(get_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=transaction)
+
+        # Verify the deprecation
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+    @mock.patch("google.cloud.firestore_v1beta1.query.Query", autospec=True)
+    def test_stream(self, query_class):
+        collection = self._make_one("collection")
+        stream_response = collection.stream()
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(stream_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=None)
+
+    @mock.patch("google.cloud.firestore_v1beta1.query.Query", autospec=True)
+    def test_stream_with_transaction(self, query_class):
+        collection = self._make_one("collection")
+        transaction = mock.sentinel.txn
+        stream_response = collection.stream(transaction=transaction)
+
+        query_class.assert_called_once_with(collection)
+        query_instance = query_class.return_value
+        self.assertIs(stream_response, query_instance.stream.return_value)
+        query_instance.stream.assert_called_once_with(transaction=transaction)
+
+    @mock.patch("google.cloud.firestore_v1beta1.collection.Watch", autospec=True)
+    def test_on_snapshot(self, watch):
+        collection = self._make_one("collection")
+        collection.on_snapshot(None)
+        watch.for_query.assert_called_once()
+
+
+class Test__auto_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut():
+        from google.cloud.firestore_v1beta1.collection import _auto_id
+
+        return _auto_id()
+
+    @mock.patch("random.choice")
+    def test_it(self, mock_rand_choice):
+        from google.cloud.firestore_v1beta1.collection import _AUTO_ID_CHARS
+
+        mock_result = "0123456789abcdefghij"
+        mock_rand_choice.side_effect = list(mock_result)
+        result = self._call_fut()
+        self.assertEqual(result, mock_result)
+
+        mock_calls = [mock.call(_AUTO_ID_CHARS)] * 20
+        self.assertEqual(mock_rand_choice.mock_calls, mock_calls)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client():
+    from google.cloud.firestore_v1beta1.client import Client
+
+    credentials = _make_credentials()
+    with pytest.deprecated_call():
+        return Client(project="project-project", credentials=credentials)
diff --git a/firestore/tests/unit/v1beta1/test_cross_language.py b/firestore/tests/unit/v1beta1/test_cross_language.py
new file mode 100644
index 000000000000..d04b71436ff6
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_cross_language.py
@@ -0,0 +1,505 @@
+# Copyright 2017 Google LLC 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.
+
+import functools
+import glob
+import json
+import os
+
+import mock
+import pytest
+
+from google.protobuf import text_format
+from google.cloud.firestore_v1beta1.proto import document_pb2
+from google.cloud.firestore_v1beta1.proto import firestore_pb2
+from google.cloud.firestore_v1beta1.proto import test_v1beta1_pb2
+from google.cloud.firestore_v1beta1.proto import write_pb2
+
+
+def _load_testproto(filename):
+    with open(filename, "r") as tp_file:
+        tp_text = tp_file.read()
+    test_proto = test_v1beta1_pb2.Test()
+    text_format.Merge(tp_text, test_proto)
+    shortname = os.path.split(filename)[-1]
+    test_proto.description = test_proto.description + " (%s)" % shortname
+    return test_proto
+
+
+_here = os.path.dirname(__file__)
+_glob_expr = "{}/testdata/*.textproto".format(_here)
+_globs = glob.glob(_glob_expr)
+ALL_TESTPROTOS = [_load_testproto(filename) for filename in sorted(_globs)]
+
+_CREATE_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "create"
+]
+
+_GET_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "get"
+]
+
+_SET_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "set"
+]
+
+_UPDATE_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "update"
+]
+
+_UPDATE_PATHS_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "update_paths"
+]
+
+_DELETE_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "delete"
+]
+
+_LISTEN_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "listen"
+]
+
+_QUERY_TESTPROTOS = [
+    test_proto
+    for test_proto in ALL_TESTPROTOS
+    if test_proto.WhichOneof("test") == "query"
+]
+
+
+def _mock_firestore_api():
+    firestore_api = mock.Mock(spec=["commit"])
+    commit_response = firestore_pb2.CommitResponse(
+        write_results=[write_pb2.WriteResult()]
+    )
+    firestore_api.commit.return_value = commit_response
+    return firestore_api
+
+
+def _make_client_document(firestore_api, testcase):
+    from google.cloud.firestore_v1beta1 import Client
+    from google.cloud.firestore_v1beta1.client import DEFAULT_DATABASE
+    import google.auth.credentials
+
+    _, project, _, database, _, doc_path = testcase.doc_ref_path.split("/", 5)
+    assert database == DEFAULT_DATABASE
+
+    # Attach the fake GAPIC to a real client.
+    credentials = mock.Mock(spec=google.auth.credentials.Credentials)
+
+    with pytest.deprecated_call():
+        client = Client(project=project, credentials=credentials)
+
+    client._firestore_api_internal = firestore_api
+    return client, client.document(doc_path)
+
+
+def _run_testcase(testcase, call, firestore_api, client):
+    if getattr(testcase, "is_error", False):
+        # TODO: is there a subclass of Exception we can check for?
+        with pytest.raises(Exception):
+            call()
+    else:
+        call()
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            list(testcase.request.writes),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+
+@pytest.mark.parametrize("test_proto", _CREATE_TESTPROTOS)
+def test_create_testprotos(test_proto):
+    testcase = test_proto.create
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    data = convert_data(json.loads(testcase.json_data))
+    call = functools.partial(document.create, data)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.parametrize("test_proto", _GET_TESTPROTOS)
+def test_get_testprotos(test_proto):
+    testcase = test_proto.get
+    firestore_api = mock.Mock(spec=["get_document"])
+    response = document_pb2.Document()
+    firestore_api.get_document.return_value = response
+    client, document = _make_client_document(firestore_api, testcase)
+
+    document.get()  # No '.textprotos' for errors, field_paths.
+
+    firestore_api.get_document.assert_called_once_with(
+        document._document_path,
+        mask=None,
+        transaction=None,
+        metadata=client._rpc_metadata,
+    )
+
+
+@pytest.mark.parametrize("test_proto", _SET_TESTPROTOS)
+def test_set_testprotos(test_proto):
+    testcase = test_proto.set
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    data = convert_data(json.loads(testcase.json_data))
+    if testcase.HasField("option"):
+        merge = convert_set_option(testcase.option)
+    else:
+        merge = False
+    call = functools.partial(document.set, data, merge=merge)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.parametrize("test_proto", _UPDATE_TESTPROTOS)
+def test_update_testprotos(test_proto):
+    testcase = test_proto.update
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    data = convert_data(json.loads(testcase.json_data))
+    if testcase.HasField("precondition"):
+        option = convert_precondition(testcase.precondition)
+    else:
+        option = None
+    call = functools.partial(document.update, data, option)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.skip(reason="Python has no way to call update with a list of field paths.")
+@pytest.mark.parametrize("test_proto", _UPDATE_PATHS_TESTPROTOS)
+def test_update_paths_testprotos(test_proto):  # pragma: NO COVER
+    pass
+
+
+@pytest.mark.parametrize("test_proto", _DELETE_TESTPROTOS)
+def test_delete_testprotos(test_proto):
+    testcase = test_proto.delete
+    firestore_api = _mock_firestore_api()
+    client, document = _make_client_document(firestore_api, testcase)
+    if testcase.HasField("precondition"):
+        option = convert_precondition(testcase.precondition)
+    else:
+        option = None
+    call = functools.partial(document.delete, option)
+    _run_testcase(testcase, call, firestore_api, client)
+
+
+@pytest.mark.parametrize("test_proto", _LISTEN_TESTPROTOS)
+def test_listen_testprotos(test_proto):  # pragma: NO COVER
+    # test_proto.listen has 'reponses' messages,
+    # 'google.firestore.v1beta1.ListenResponse'
+    # and then an expected list of 'snapshots' (local 'Snapshot'), containing
+    # 'docs' (list of 'google.firestore.v1beta1.Document'),
+    # 'changes' (list lof local 'DocChange', and 'read_time' timestamp.
+    from google.cloud.firestore_v1beta1 import Client
+    from google.cloud.firestore_v1beta1 import DocumentReference
+    from google.cloud.firestore_v1beta1 import DocumentSnapshot
+    from google.cloud.firestore_v1beta1 import Watch
+    import google.auth.credentials
+
+    testcase = test_proto.listen
+    testname = test_proto.description
+
+    credentials = mock.Mock(spec=google.auth.credentials.Credentials)
+
+    with pytest.deprecated_call():
+        client = Client(project="project", credentials=credentials)
+
+    modulename = "google.cloud.firestore_v1beta1.watch"
+    with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+        with mock.patch(
+            "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+        ):
+            with mock.patch(  # conformance data sets WATCH_TARGET_ID to 1
+                "%s.WATCH_TARGET_ID" % modulename, 1
+            ):
+                snapshots = []
+
+                def callback(keys, applied_changes, read_time):
+                    snapshots.append((keys, applied_changes, read_time))
+
+                query = DummyQuery(client=client)
+                watch = Watch.for_query(
+                    query, callback, DocumentSnapshot, DocumentReference
+                )
+                # conformance data has db string as this
+                db_str = "projects/projectID/databases/(default)"
+                watch._firestore._database_string_internal = db_str
+
+                if testcase.is_error:
+                    try:
+                        for proto in testcase.responses:
+                            watch.on_snapshot(proto)
+                    except RuntimeError:
+                        # listen-target-add-wrong-id.textpro
+                        # listen-target-remove.textpro
+                        pass
+
+                else:
+                    for proto in testcase.responses:
+                        watch.on_snapshot(proto)
+
+                    assert len(snapshots) == len(testcase.snapshots)
+                    for i, (expected_snapshot, actual_snapshot) in enumerate(
+                        zip(testcase.snapshots, snapshots)
+                    ):
+                        expected_changes = expected_snapshot.changes
+                        actual_changes = actual_snapshot[1]
+                        if len(expected_changes) != len(actual_changes):
+                            raise AssertionError(
+                                "change length mismatch in %s (snapshot #%s)"
+                                % (testname, i)
+                            )
+                        for y, (expected_change, actual_change) in enumerate(
+                            zip(expected_changes, actual_changes)
+                        ):
+                            expected_change_kind = expected_change.kind
+                            actual_change_kind = actual_change.type.value
+                            if expected_change_kind != actual_change_kind:
+                                raise AssertionError(
+                                    "change type mismatch in %s (snapshot #%s, change #%s')"
+                                    % (testname, i, y)
+                                )
+
+
+@pytest.mark.parametrize("test_proto", _QUERY_TESTPROTOS)
+def test_query_testprotos(test_proto):  # pragma: NO COVER
+    testcase = test_proto.query
+    if testcase.is_error:
+        with pytest.raises(Exception):
+            query = parse_query(testcase)
+            query._to_protobuf()
+    else:
+        query = parse_query(testcase)
+        found = query._to_protobuf()
+        assert found == testcase.query
+
+
+def convert_data(v):
+    # Replace the strings 'ServerTimestamp' and 'Delete' with the corresponding
+    # sentinels.
+    from google.cloud.firestore_v1beta1 import ArrayRemove
+    from google.cloud.firestore_v1beta1 import ArrayUnion
+    from google.cloud.firestore_v1beta1 import DELETE_FIELD
+    from google.cloud.firestore_v1beta1 import SERVER_TIMESTAMP
+
+    if v == "ServerTimestamp":
+        return SERVER_TIMESTAMP
+    elif v == "Delete":
+        return DELETE_FIELD
+    elif isinstance(v, list):
+        if v[0] == "ArrayRemove":
+            return ArrayRemove([convert_data(e) for e in v[1:]])
+        if v[0] == "ArrayUnion":
+            return ArrayUnion([convert_data(e) for e in v[1:]])
+        return [convert_data(e) for e in v]
+    elif isinstance(v, dict):
+        return {k: convert_data(v2) for k, v2 in v.items()}
+    elif v == "NaN":
+        return float(v)
+    else:
+        return v
+
+
+def convert_set_option(option):
+    from google.cloud.firestore_v1beta1 import _helpers
+
+    if option.fields:
+        return [
+            _helpers.FieldPath(*field.field).to_api_repr() for field in option.fields
+        ]
+
+    assert option.all
+    return True
+
+
+def convert_precondition(precond):
+    from google.cloud.firestore_v1beta1 import Client
+
+    if precond.HasField("exists"):
+        return Client.write_option(exists=precond.exists)
+
+    assert precond.HasField("update_time")
+    return Client.write_option(last_update_time=precond.update_time)
+
+
+class DummyRpc(object):  # pragma: NO COVER
+    def __init__(self, listen, initial_request, should_recover, metadata=None):
+        self.listen = listen
+        self.initial_request = initial_request
+        self.should_recover = should_recover
+        self.closed = False
+        self.callbacks = []
+        self._metadata = metadata
+
+    def add_done_callback(self, callback):
+        self.callbacks.append(callback)
+
+    def close(self):
+        self.closed = True
+
+
+class DummyBackgroundConsumer(object):  # pragma: NO COVER
+    started = False
+    stopped = False
+    is_active = True
+
+    def __init__(self, rpc, on_snapshot):
+        self._rpc = rpc
+        self.on_snapshot = on_snapshot
+
+    def start(self):
+        self.started = True
+
+    def stop(self):
+        self.stopped = True
+        self.is_active = False
+
+
+class DummyQuery(object):  # pragma: NO COVER
+    def __init__(self, **kw):
+        self._client = kw["client"]
+        self._comparator = lambda x, y: 1
+
+    def _to_protobuf(self):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        query_kwargs = {
+            "select": None,
+            "from": None,
+            "where": None,
+            "order_by": None,
+            "start_at": None,
+            "end_at": None,
+        }
+        return query_pb2.StructuredQuery(**query_kwargs)
+
+
+def parse_query(testcase):
+    # 'query' testcase contains:
+    # - 'coll_path':  collection ref path.
+    # - 'clauses':  array of one or more 'Clause' elements
+    # - 'query': the actual google.firestore.v1beta1.StructuredQuery message
+    #            to be constructed.
+    # - 'is_error' (as other testcases).
+    #
+    # 'Clause' elements are unions of:
+    # - 'select':  [field paths]
+    # - 'where': (field_path, op, json_value)
+    # - 'order_by': (field_path, direction)
+    # - 'offset': int
+    # - 'limit': int
+    # - 'start_at': 'Cursor'
+    # - 'start_after': 'Cursor'
+    # - 'end_at': 'Cursor'
+    # - 'end_before': 'Cursor'
+    #
+    # 'Cursor' contains either:
+    # - 'doc_snapshot': 'DocSnapshot'
+    # - 'json_values': [string]
+    #
+    # 'DocSnapshot' contains:
+    # 'path': str
+    # 'json_data': str
+    from google.auth.credentials import Credentials
+    from google.cloud.firestore_v1beta1 import Client
+    from google.cloud.firestore_v1beta1 import Query
+
+    _directions = {"asc": Query.ASCENDING, "desc": Query.DESCENDING}
+
+    credentials = mock.create_autospec(Credentials)
+
+    with pytest.deprecated_call():
+        client = Client("projectID", credentials)
+
+    path = parse_path(testcase.coll_path)
+    collection = client.collection(*path)
+    query = collection
+
+    for clause in testcase.clauses:
+        kind = clause.WhichOneof("clause")
+
+        if kind == "select":
+            field_paths = [
+                ".".join(field_path.field) for field_path in clause.select.fields
+            ]
+            query = query.select(field_paths)
+        elif kind == "where":
+            path = ".".join(clause.where.path.field)
+            value = convert_data(json.loads(clause.where.json_value))
+            query = query.where(path, clause.where.op, value)
+        elif kind == "order_by":
+            path = ".".join(clause.order_by.path.field)
+            direction = clause.order_by.direction
+            direction = _directions.get(direction, direction)
+            query = query.order_by(path, direction=direction)
+        elif kind == "offset":
+            query = query.offset(clause.offset)
+        elif kind == "limit":
+            query = query.limit(clause.limit)
+        elif kind == "start_at":
+            cursor = parse_cursor(clause.start_at, client)
+            query = query.start_at(cursor)
+        elif kind == "start_after":
+            cursor = parse_cursor(clause.start_after, client)
+            query = query.start_after(cursor)
+        elif kind == "end_at":
+            cursor = parse_cursor(clause.end_at, client)
+            query = query.end_at(cursor)
+        elif kind == "end_before":
+            cursor = parse_cursor(clause.end_before, client)
+            query = query.end_before(cursor)
+        else:  # pragma: NO COVER
+            raise ValueError("Unknown query clause: {}".format(kind))
+
+    return query
+
+
+def parse_path(path):
+    _, relative = path.split("documents/")
+    return relative.split("/")
+
+
+def parse_cursor(cursor, client):
+    from google.cloud.firestore_v1beta1 import DocumentReference
+    from google.cloud.firestore_v1beta1 import DocumentSnapshot
+
+    if cursor.HasField("doc_snapshot"):
+        path = parse_path(cursor.doc_snapshot.path)
+        doc_ref = DocumentReference(*path, client=client)
+
+        return DocumentSnapshot(
+            reference=doc_ref,
+            data=json.loads(cursor.doc_snapshot.json_data),
+            exists=True,
+            read_time=None,
+            create_time=None,
+            update_time=None,
+        )
+
+    values = [json.loads(value) for value in cursor.json_values]
+    return convert_data(values)
diff --git a/firestore/tests/unit/v1beta1/test_document.py b/firestore/tests/unit/v1beta1/test_document.py
new file mode 100644
index 000000000000..f9aca713449a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_document.py
@@ -0,0 +1,830 @@
+# Copyright 2017 Google LLC 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.
+
+import collections
+import unittest
+
+import mock
+import pytest
+
+
+class TestDocumentReference(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        return DocumentReference
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        collection_id1 = "users"
+        document_id1 = "alovelace"
+        collection_id2 = "platform"
+        document_id2 = "*nix"
+        client = mock.MagicMock()
+        client.__hash__.return_value = 1234
+
+        document = self._make_one(
+            collection_id1, document_id1, collection_id2, document_id2, client=client
+        )
+        self.assertIs(document._client, client)
+        expected_path = "/".join(
+            (collection_id1, document_id1, collection_id2, document_id2)
+        )
+        self.assertEqual(document.path, expected_path)
+
+    def test_constructor_invalid_path(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+        with self.assertRaises(ValueError):
+            self._make_one(None, "before", "bad-collection-id", "fifteen")
+        with self.assertRaises(ValueError):
+            self._make_one("bad-document-ID", None)
+        with self.assertRaises(ValueError):
+            self._make_one("Just", "A-Collection", "Sub")
+
+    def test_constructor_invalid_kwarg(self):
+        with self.assertRaises(TypeError):
+            self._make_one("Coh-lek-shun", "Dahk-yu-mehnt", burger=18.75)
+
+    def test___copy__(self):
+        client = _make_client("rain")
+        document = self._make_one("a", "b", client=client)
+        # Access the document path so it is copied.
+        doc_path = document._document_path
+        self.assertEqual(doc_path, document._document_path_internal)
+
+        new_document = document.__copy__()
+        self.assertIsNot(new_document, document)
+        self.assertIs(new_document._client, document._client)
+        self.assertEqual(new_document._path, document._path)
+        self.assertEqual(
+            new_document._document_path_internal, document._document_path_internal
+        )
+
+    def test___deepcopy__calls_copy(self):
+        client = mock.sentinel.client
+        document = self._make_one("a", "b", client=client)
+        document.__copy__ = mock.Mock(return_value=mock.sentinel.new_doc, spec=[])
+
+        unused_memo = {}
+        new_document = document.__deepcopy__(unused_memo)
+        self.assertIs(new_document, mock.sentinel.new_doc)
+        document.__copy__.assert_called_once_with()
+
+    def test__eq__same_type(self):
+        document1 = self._make_one("X", "YY", client=mock.sentinel.client)
+        document2 = self._make_one("X", "ZZ", client=mock.sentinel.client)
+        document3 = self._make_one("X", "YY", client=mock.sentinel.client2)
+        document4 = self._make_one("X", "YY", client=mock.sentinel.client)
+
+        pairs = ((document1, document2), (document1, document3), (document2, document3))
+        for candidate1, candidate2 in pairs:
+            # We use == explicitly since assertNotEqual would use !=.
+            equality_val = candidate1 == candidate2
+            self.assertFalse(equality_val)
+
+        # Check the only equal one.
+        self.assertEqual(document1, document4)
+        self.assertIsNot(document1, document4)
+
+    def test__eq__other_type(self):
+        document = self._make_one("X", "YY", client=mock.sentinel.client)
+        other = object()
+        equality_val = document == other
+        self.assertFalse(equality_val)
+        self.assertIs(document.__eq__(other), NotImplemented)
+
+    def test___hash__(self):
+        client = mock.MagicMock()
+        client.__hash__.return_value = 234566789
+        document = self._make_one("X", "YY", client=client)
+        self.assertEqual(hash(document), hash(("X", "YY")) + hash(client))
+
+    def test__ne__same_type(self):
+        document1 = self._make_one("X", "YY", client=mock.sentinel.client)
+        document2 = self._make_one("X", "ZZ", client=mock.sentinel.client)
+        document3 = self._make_one("X", "YY", client=mock.sentinel.client2)
+        document4 = self._make_one("X", "YY", client=mock.sentinel.client)
+
+        self.assertNotEqual(document1, document2)
+        self.assertNotEqual(document1, document3)
+        self.assertNotEqual(document2, document3)
+
+        # We use != explicitly since assertEqual would use ==.
+        inequality_val = document1 != document4
+        self.assertFalse(inequality_val)
+        self.assertIsNot(document1, document4)
+
+    def test__ne__other_type(self):
+        document = self._make_one("X", "YY", client=mock.sentinel.client)
+        other = object()
+        self.assertNotEqual(document, other)
+        self.assertIs(document.__ne__(other), NotImplemented)
+
+    def test__document_path_property(self):
+        project = "hi-its-me-ok-bye"
+        client = _make_client(project=project)
+
+        collection_id = "then"
+        document_id = "090909iii"
+        document = self._make_one(collection_id, document_id, client=client)
+        doc_path = document._document_path
+        expected = "projects/{}/databases/{}/documents/{}/{}".format(
+            project, client._database, collection_id, document_id
+        )
+        self.assertEqual(doc_path, expected)
+        self.assertIs(document._document_path_internal, doc_path)
+
+        # Make sure value is cached.
+        document._document_path_internal = mock.sentinel.cached
+        self.assertIs(document._document_path, mock.sentinel.cached)
+
+    def test__document_path_property_no_client(self):
+        document = self._make_one("hi", "bye")
+        self.assertIsNone(document._client)
+        with self.assertRaises(ValueError):
+            getattr(document, "_document_path")
+
+        self.assertIsNone(document._document_path_internal)
+
+    def test_id_property(self):
+        document_id = "867-5309"
+        document = self._make_one("Co-lek-shun", document_id)
+        self.assertEqual(document.id, document_id)
+
+    def test_parent_property(self):
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+
+        collection_id = "grocery-store"
+        document_id = "market"
+        client = _make_client()
+        document = self._make_one(collection_id, document_id, client=client)
+
+        parent = document.parent
+        self.assertIsInstance(parent, CollectionReference)
+        self.assertIs(parent._client, client)
+        self.assertEqual(parent._path, (collection_id,))
+
+    def test_collection_factory(self):
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+
+        collection_id = "grocery-store"
+        document_id = "market"
+        new_collection = "fruits"
+        client = _make_client()
+        document = self._make_one(collection_id, document_id, client=client)
+
+        child = document.collection(new_collection)
+        self.assertIsInstance(child, CollectionReference)
+        self.assertIs(child._client, client)
+        self.assertEqual(child._path, (collection_id, document_id, new_collection))
+
+    @staticmethod
+    def _write_pb_for_create(document_path, document_data):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(document_data)
+            ),
+            current_document=common_pb2.Precondition(exists=False),
+        )
+
+    @staticmethod
+    def _make_commit_repsonse(write_results=None):
+        from google.cloud.firestore_v1beta1.proto import firestore_pb2
+
+        response = mock.create_autospec(firestore_pb2.CommitResponse)
+        response.write_results = write_results or [mock.sentinel.write_result]
+        response.commit_time = mock.sentinel.commit_time
+        return response
+
+    def test_create(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("dignity")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("foo", "twelve", client=client)
+        document_data = {"hello": "goodbye", "count": 99}
+        write_result = document.create(document_data)
+
+        # Verify the response and the mocks.
+        self.assertIs(write_result, mock.sentinel.write_result)
+        write_pb = self._write_pb_for_create(document._document_path, document_data)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_create_empty(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        firestore_api = mock.Mock(spec=["commit"])
+        document_reference = mock.create_autospec(DocumentReference)
+        snapshot = mock.create_autospec(DocumentSnapshot)
+        snapshot.exists = True
+        document_reference.get.return_value = snapshot
+        firestore_api.commit.return_value = self._make_commit_repsonse(
+            write_results=[document_reference]
+        )
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("dignity")
+        client._firestore_api_internal = firestore_api
+        client.get_all = mock.MagicMock()
+        client.get_all.exists.return_value = True
+
+        # Actually make a document and call create().
+        document = self._make_one("foo", "twelve", client=client)
+        document_data = {}
+        write_result = document.create(document_data)
+        self.assertTrue(write_result.get().exists)
+
+    @staticmethod
+    def _write_pb_for_set(document_path, document_data, merge):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        write_pbs = write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(document_data)
+            )
+        )
+        if merge:
+            field_paths = [
+                field_path
+                for field_path, value in _helpers.extract_fields(
+                    document_data, _helpers.FieldPath()
+                )
+            ]
+            field_paths = [
+                field_path.to_api_repr() for field_path in sorted(field_paths)
+            ]
+            mask = common_pb2.DocumentMask(field_paths=sorted(field_paths))
+            write_pbs.update_mask.CopyFrom(mask)
+        return write_pbs
+
+    def _set_helper(self, merge=False, **option_kwargs):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("db-dee-bee")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("User", "Interface", client=client)
+        document_data = {"And": 500, "Now": b"\xba\xaa\xaa \xba\xaa\xaa"}
+        write_result = document.set(document_data, merge)
+
+        # Verify the response and the mocks.
+        self.assertIs(write_result, mock.sentinel.write_result)
+        write_pb = self._write_pb_for_set(document._document_path, document_data, merge)
+
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_set(self):
+        self._set_helper()
+
+    def test_set_merge(self):
+        self._set_helper(merge=True)
+
+    @staticmethod
+    def _write_pb_for_update(document_path, update_values, field_paths):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        return write_pb2.Write(
+            update=document_pb2.Document(
+                name=document_path, fields=_helpers.encode_dict(update_values)
+            ),
+            update_mask=common_pb2.DocumentMask(field_paths=field_paths),
+            current_document=common_pb2.Precondition(exists=True),
+        )
+
+    def _update_helper(self, **option_kwargs):
+        from google.cloud.firestore_v1beta1.transforms import DELETE_FIELD
+
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("potato-chip")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("baked", "Alaska", client=client)
+        # "Cheat" and use OrderedDict-s so that iteritems() is deterministic.
+        field_updates = collections.OrderedDict(
+            (("hello", 1), ("then.do", False), ("goodbye", DELETE_FIELD))
+        )
+        if option_kwargs:
+            option = client.write_option(**option_kwargs)
+            write_result = document.update(field_updates, option=option)
+        else:
+            option = None
+            write_result = document.update(field_updates)
+
+        # Verify the response and the mocks.
+        self.assertIs(write_result, mock.sentinel.write_result)
+        update_values = {
+            "hello": field_updates["hello"],
+            "then": {"do": field_updates["then.do"]},
+        }
+        field_paths = list(field_updates.keys())
+        write_pb = self._write_pb_for_update(
+            document._document_path, update_values, sorted(field_paths)
+        )
+        if option is not None:
+            option.modify_write(write_pb)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_update_with_exists(self):
+        with self.assertRaises(ValueError):
+            self._update_helper(exists=True)
+
+    def test_update(self):
+        self._update_helper()
+
+    def test_update_with_precondition(self):
+        from google.protobuf import timestamp_pb2
+
+        timestamp = timestamp_pb2.Timestamp(seconds=1058655101, nanos=100022244)
+        self._update_helper(last_update_time=timestamp)
+
+    def test_empty_update(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("potato-chip")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call create().
+        document = self._make_one("baked", "Alaska", client=client)
+        # "Cheat" and use OrderedDict-s so that iteritems() is deterministic.
+        field_updates = {}
+        with self.assertRaises(ValueError):
+            document.update(field_updates)
+
+    def _delete_helper(self, **option_kwargs):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["commit"])
+        firestore_api.commit.return_value = self._make_commit_repsonse()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("donut-base")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a document and call delete().
+        document = self._make_one("where", "we-are", client=client)
+        if option_kwargs:
+            option = client.write_option(**option_kwargs)
+            delete_time = document.delete(option=option)
+        else:
+            option = None
+            delete_time = document.delete()
+
+        # Verify the response and the mocks.
+        self.assertIs(delete_time, mock.sentinel.commit_time)
+        write_pb = write_pb2.Write(delete=document._document_path)
+        if option is not None:
+            option.modify_write(write_pb)
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            [write_pb],
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_delete(self):
+        self._delete_helper()
+
+    def test_delete_with_option(self):
+        from google.protobuf import timestamp_pb2
+
+        timestamp_pb = timestamp_pb2.Timestamp(seconds=1058655101, nanos=100022244)
+        self._delete_helper(last_update_time=timestamp_pb)
+
+    def _get_helper(self, field_paths=None, use_transaction=False, not_found=False):
+        from google.api_core.exceptions import NotFound
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        # Create a minimal fake GAPIC with a dummy response.
+        create_time = 123
+        update_time = 234
+        firestore_api = mock.Mock(spec=["get_document"])
+        response = mock.create_autospec(document_pb2.Document)
+        response.fields = {}
+        response.create_time = create_time
+        response.update_time = update_time
+
+        if not_found:
+            firestore_api.get_document.side_effect = NotFound("testing")
+        else:
+            firestore_api.get_document.return_value = response
+
+        client = _make_client("donut-base")
+        client._firestore_api_internal = firestore_api
+
+        document = self._make_one("where", "we-are", client=client)
+
+        if use_transaction:
+            transaction = Transaction(client)
+            transaction_id = transaction._id = b"asking-me-2"
+        else:
+            transaction = None
+
+        snapshot = document.get(field_paths=field_paths, transaction=transaction)
+
+        self.assertIs(snapshot.reference, document)
+        if not_found:
+            self.assertIsNone(snapshot._data)
+            self.assertFalse(snapshot.exists)
+            self.assertIsNone(snapshot.read_time)
+            self.assertIsNone(snapshot.create_time)
+            self.assertIsNone(snapshot.update_time)
+        else:
+            self.assertEqual(snapshot.to_dict(), {})
+            self.assertTrue(snapshot.exists)
+            self.assertIsNone(snapshot.read_time)
+            self.assertIs(snapshot.create_time, create_time)
+            self.assertIs(snapshot.update_time, update_time)
+
+        # Verify the request made to the API
+        if field_paths is not None:
+            mask = common_pb2.DocumentMask(field_paths=sorted(field_paths))
+        else:
+            mask = None
+
+        if use_transaction:
+            expected_transaction_id = transaction_id
+        else:
+            expected_transaction_id = None
+
+        firestore_api.get_document.assert_called_once_with(
+            document._document_path,
+            mask=mask,
+            transaction=expected_transaction_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_get_not_found(self):
+        self._get_helper(not_found=True)
+
+    def test_get_default(self):
+        self._get_helper()
+
+    def test_get_w_string_field_path(self):
+        with self.assertRaises(ValueError):
+            self._get_helper(field_paths="foo")
+
+    def test_get_with_field_path(self):
+        self._get_helper(field_paths=["foo"])
+
+    def test_get_with_multiple_field_paths(self):
+        self._get_helper(field_paths=["foo", "bar.baz"])
+
+    def test_get_with_transaction(self):
+        self._get_helper(use_transaction=True)
+
+    def _collections_helper(self, page_size=None):
+        from google.api_core.page_iterator import Iterator
+        from google.api_core.page_iterator import Page
+        from google.cloud.firestore_v1beta1.collection import CollectionReference
+        from google.cloud.firestore_v1beta1.gapic.firestore_client import (
+            FirestoreClient,
+        )
+
+        class _Iterator(Iterator):
+            def __init__(self, pages):
+                super(_Iterator, self).__init__(client=None)
+                self._pages = pages
+
+            def _next_page(self):
+                if self._pages:
+                    page, self._pages = self._pages[0], self._pages[1:]
+                    return Page(self, page, self.item_to_value)
+
+        collection_ids = ["coll-1", "coll-2"]
+        iterator = _Iterator(pages=[collection_ids])
+        api_client = mock.create_autospec(FirestoreClient)
+        api_client.list_collection_ids.return_value = iterator
+
+        client = _make_client()
+        client._firestore_api_internal = api_client
+
+        # Actually make a document and call delete().
+        document = self._make_one("where", "we-are", client=client)
+        if page_size is not None:
+            collections = list(document.collections(page_size=page_size))
+        else:
+            collections = list(document.collections())
+
+        # Verify the response and the mocks.
+        self.assertEqual(len(collections), len(collection_ids))
+        for collection, collection_id in zip(collections, collection_ids):
+            self.assertIsInstance(collection, CollectionReference)
+            self.assertEqual(collection.parent, document)
+            self.assertEqual(collection.id, collection_id)
+
+        api_client.list_collection_ids.assert_called_once_with(
+            document._document_path, page_size=page_size, metadata=client._rpc_metadata
+        )
+
+    def test_collections_wo_page_size(self):
+        self._collections_helper()
+
+    def test_collections_w_page_size(self):
+        self._collections_helper(page_size=10)
+
+    @mock.patch("google.cloud.firestore_v1beta1.document.Watch", autospec=True)
+    def test_on_snapshot(self, watch):
+        client = mock.Mock(_database_string="sprinklez", spec=["_database_string"])
+        document = self._make_one("yellow", "mellow", client=client)
+        document.on_snapshot(None)
+        watch.for_document.assert_called_once()
+
+
+class TestDocumentSnapshot(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        return DocumentSnapshot
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def _make_reference(self, *args, **kwargs):
+        from google.cloud.firestore_v1beta1.document import DocumentReference
+
+        return DocumentReference(*args, **kwargs)
+
+    def _make_w_ref(self, ref_path=("a", "b"), data={}, exists=True):
+        client = mock.sentinel.client
+        reference = self._make_reference(*ref_path, client=client)
+        return self._make_one(
+            reference,
+            data,
+            exists,
+            mock.sentinel.read_time,
+            mock.sentinel.create_time,
+            mock.sentinel.update_time,
+        )
+
+    def test_constructor(self):
+        client = mock.sentinel.client
+        reference = self._make_reference("hi", "bye", client=client)
+        data = {"zoop": 83}
+        snapshot = self._make_one(
+            reference,
+            data,
+            True,
+            mock.sentinel.read_time,
+            mock.sentinel.create_time,
+            mock.sentinel.update_time,
+        )
+        self.assertIs(snapshot._reference, reference)
+        self.assertEqual(snapshot._data, data)
+        self.assertIsNot(snapshot._data, data)  # Make sure copied.
+        self.assertTrue(snapshot._exists)
+        self.assertIs(snapshot.read_time, mock.sentinel.read_time)
+        self.assertIs(snapshot.create_time, mock.sentinel.create_time)
+        self.assertIs(snapshot.update_time, mock.sentinel.update_time)
+
+    def test___eq___other_type(self):
+        snapshot = self._make_w_ref()
+        other = object()
+        self.assertFalse(snapshot == other)
+
+    def test___eq___different_reference_same_data(self):
+        snapshot = self._make_w_ref(("a", "b"))
+        other = self._make_w_ref(("c", "d"))
+        self.assertFalse(snapshot == other)
+
+    def test___eq___same_reference_different_data(self):
+        snapshot = self._make_w_ref(("a", "b"))
+        other = self._make_w_ref(("a", "b"), {"foo": "bar"})
+        self.assertFalse(snapshot == other)
+
+    def test___eq___same_reference_same_data(self):
+        snapshot = self._make_w_ref(("a", "b"), {"foo": "bar"})
+        other = self._make_w_ref(("a", "b"), {"foo": "bar"})
+        self.assertTrue(snapshot == other)
+
+    def test___hash__(self):
+        from google.protobuf import timestamp_pb2
+
+        client = mock.MagicMock()
+        client.__hash__.return_value = 234566789
+        reference = self._make_reference("hi", "bye", client=client)
+        data = {"zoop": 83}
+        update_time = timestamp_pb2.Timestamp(seconds=123456, nanos=123456789)
+        snapshot = self._make_one(
+            reference, data, True, None, mock.sentinel.create_time, update_time
+        )
+        self.assertEqual(
+            hash(snapshot), hash(reference) + hash(123456) + hash(123456789)
+        )
+
+    def test__client_property(self):
+        reference = self._make_reference(
+            "ok", "fine", "now", "fore", client=mock.sentinel.client
+        )
+        snapshot = self._make_one(reference, {}, False, None, None, None)
+        self.assertIs(snapshot._client, mock.sentinel.client)
+
+    def test_exists_property(self):
+        reference = mock.sentinel.reference
+
+        snapshot1 = self._make_one(reference, {}, False, None, None, None)
+        self.assertFalse(snapshot1.exists)
+        snapshot2 = self._make_one(reference, {}, True, None, None, None)
+        self.assertTrue(snapshot2.exists)
+
+    def test_id_property(self):
+        document_id = "around"
+        reference = self._make_reference(
+            "look", document_id, client=mock.sentinel.client
+        )
+        snapshot = self._make_one(reference, {}, True, None, None, None)
+        self.assertEqual(snapshot.id, document_id)
+        self.assertEqual(reference.id, document_id)
+
+    def test_reference_property(self):
+        snapshot = self._make_one(mock.sentinel.reference, {}, True, None, None, None)
+        self.assertIs(snapshot.reference, mock.sentinel.reference)
+
+    def test_get(self):
+        data = {"one": {"bold": "move"}}
+        snapshot = self._make_one(None, data, True, None, None, None)
+
+        first_read = snapshot.get("one")
+        second_read = snapshot.get("one")
+        self.assertEqual(first_read, data.get("one"))
+        self.assertIsNot(first_read, data.get("one"))
+        self.assertEqual(first_read, second_read)
+        self.assertIsNot(first_read, second_read)
+
+        with self.assertRaises(KeyError):
+            snapshot.get("two")
+
+    def test_nonexistent_snapshot(self):
+        snapshot = self._make_one(None, None, False, None, None, None)
+        self.assertIsNone(snapshot.get("one"))
+
+    def test_to_dict(self):
+        data = {"a": 10, "b": ["definitely", "mutable"], "c": {"45": 50}}
+        snapshot = self._make_one(None, data, True, None, None, None)
+        as_dict = snapshot.to_dict()
+        self.assertEqual(as_dict, data)
+        self.assertIsNot(as_dict, data)
+        # Check that the data remains unchanged.
+        as_dict["b"].append("hi")
+        self.assertEqual(data, snapshot.to_dict())
+        self.assertNotEqual(data, as_dict)
+
+    def test_non_existent(self):
+        snapshot = self._make_one(None, None, False, None, None, None)
+        as_dict = snapshot.to_dict()
+        self.assertIsNone(as_dict)
+
+
+class Test__get_document_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(client, path):
+        from google.cloud.firestore_v1beta1.document import _get_document_path
+
+        return _get_document_path(client, path)
+
+    def test_it(self):
+        project = "prah-jekt"
+        client = _make_client(project=project)
+        path = ("Some", "Document", "Child", "Shockument")
+        document_path = self._call_fut(client, path)
+
+        expected = "projects/{}/databases/{}/documents/{}".format(
+            project, client._database, "/".join(path)
+        )
+        self.assertEqual(document_path, expected)
+
+
+class Test__consume_single_get(unittest.TestCase):
+    @staticmethod
+    def _call_fut(response_iterator):
+        from google.cloud.firestore_v1beta1.document import _consume_single_get
+
+        return _consume_single_get(response_iterator)
+
+    def test_success(self):
+        response_iterator = iter([mock.sentinel.result])
+        result = self._call_fut(response_iterator)
+        self.assertIs(result, mock.sentinel.result)
+
+    def test_failure_not_enough(self):
+        response_iterator = iter([])
+        with self.assertRaises(ValueError):
+            self._call_fut(response_iterator)
+
+    def test_failure_too_many(self):
+        response_iterator = iter([None, None])
+        with self.assertRaises(ValueError):
+            self._call_fut(response_iterator)
+
+
+class Test__first_write_result(unittest.TestCase):
+    @staticmethod
+    def _call_fut(write_results):
+        from google.cloud.firestore_v1beta1.document import _first_write_result
+
+        return _first_write_result(write_results)
+
+    def test_success(self):
+        from google.protobuf import timestamp_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        single_result = write_pb2.WriteResult(
+            update_time=timestamp_pb2.Timestamp(seconds=1368767504, nanos=458000123)
+        )
+        write_results = [single_result]
+        result = self._call_fut(write_results)
+        self.assertIs(result, single_result)
+
+    def test_failure_not_enough(self):
+        write_results = []
+        with self.assertRaises(ValueError):
+            self._call_fut(write_results)
+
+    def test_more_than_one(self):
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        result1 = write_pb2.WriteResult()
+        result2 = write_pb2.WriteResult()
+        write_results = [result1, result2]
+        result = self._call_fut(write_results)
+        self.assertIs(result, result1)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="project-project"):
+    from google.cloud.firestore_v1beta1.client import Client
+
+    credentials = _make_credentials()
+
+    with pytest.deprecated_call():
+        return Client(project=project, credentials=credentials)
diff --git a/firestore/tests/unit/v1beta1/test_field_path.py b/firestore/tests/unit/v1beta1/test_field_path.py
new file mode 100644
index 000000000000..22f314e612af
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_field_path.py
@@ -0,0 +1,495 @@
+# -*- coding: utf-8 -*-
+# 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.
+
+import unittest
+
+import mock
+
+
+class Test__tokenize_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path):
+        from google.cloud.firestore_v1beta1 import field_path
+
+        return field_path._tokenize_field_path(path)
+
+    def _expect(self, path, split_path):
+        self.assertEqual(list(self._call_fut(path)), split_path)
+
+    def test_w_empty(self):
+        self._expect("", [])
+
+    def test_w_single_dot(self):
+        self._expect(".", ["."])
+
+    def test_w_single_simple(self):
+        self._expect("abc", ["abc"])
+
+    def test_w_single_quoted(self):
+        self._expect("`c*de`", ["`c*de`"])
+
+    def test_w_quoted_embedded_dot(self):
+        self._expect("`c*.de`", ["`c*.de`"])
+
+    def test_w_quoted_escaped_backtick(self):
+        self._expect(r"`c*\`de`", [r"`c*\`de`"])
+
+    def test_w_dotted_quoted(self):
+        self._expect("`*`.`~`", ["`*`", ".", "`~`"])
+
+    def test_w_dotted(self):
+        self._expect("a.b.`c*de`", ["a", ".", "b", ".", "`c*de`"])
+
+    def test_w_dotted_escaped(self):
+        self._expect("_0.`1`.`+2`", ["_0", ".", "`1`", ".", "`+2`"])
+
+    def test_w_unconsumed_characters(self):
+        path = "a~b"
+        with self.assertRaises(ValueError):
+            list(self._call_fut(path))
+
+
+class Test_split_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path):
+        from google.cloud.firestore_v1beta1 import field_path
+
+        return field_path.split_field_path(path)
+
+    def test_w_single_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(".")
+
+    def test_w_leading_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(".a.b.c")
+
+    def test_w_trailing_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("a.b.")
+
+    def test_w_missing_dot(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("a`c*de`f")
+
+    def test_w_half_quoted_field(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("`c*de")
+
+    def test_w_empty(self):
+        self.assertEqual(self._call_fut(""), [])
+
+    def test_w_simple_field(self):
+        self.assertEqual(self._call_fut("a"), ["a"])
+
+    def test_w_dotted_field(self):
+        self.assertEqual(self._call_fut("a.b.cde"), ["a", "b", "cde"])
+
+    def test_w_quoted_field(self):
+        self.assertEqual(self._call_fut("a.b.`c*de`"), ["a", "b", "`c*de`"])
+
+    def test_w_quoted_field_escaped_backtick(self):
+        self.assertEqual(self._call_fut(r"`c*\`de`"), [r"`c*\`de`"])
+
+
+class Test_parse_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(path):
+        from google.cloud.firestore_v1beta1 import field_path
+
+        return field_path.parse_field_path(path)
+
+    def test_wo_escaped_names(self):
+        self.assertEqual(self._call_fut("a.b.c"), ["a", "b", "c"])
+
+    def test_w_escaped_backtick(self):
+        self.assertEqual(self._call_fut("`a\\`b`.c.d"), ["a`b", "c", "d"])
+
+    def test_w_escaped_backslash(self):
+        self.assertEqual(self._call_fut("`a\\\\b`.c.d"), ["a\\b", "c", "d"])
+
+    def test_w_first_name_escaped_wo_closing_backtick(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("`a\\`b.c.d")
+
+
+class Test_render_field_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(field_names):
+        from google.cloud.firestore_v1beta1 import field_path
+
+        return field_path.render_field_path(field_names)
+
+    def test_w_empty(self):
+        self.assertEqual(self._call_fut([]), "")
+
+    def test_w_one_simple(self):
+        self.assertEqual(self._call_fut(["a"]), "a")
+
+    def test_w_one_starts_w_digit(self):
+        self.assertEqual(self._call_fut(["0abc"]), "`0abc`")
+
+    def test_w_one_w_non_alphanum(self):
+        self.assertEqual(self._call_fut(["a b c"]), "`a b c`")
+
+    def test_w_one_w_backtick(self):
+        self.assertEqual(self._call_fut(["a`b"]), "`a\\`b`")
+
+    def test_w_one_w_backslash(self):
+        self.assertEqual(self._call_fut(["a\\b"]), "`a\\\\b`")
+
+    def test_multiple(self):
+        self.assertEqual(self._call_fut(["a", "b", "c"]), "a.b.c")
+
+
+class Test_get_nested_value(unittest.TestCase):
+
+    DATA = {
+        "top1": {"middle2": {"bottom3": 20, "bottom4": 22}, "middle5": True},
+        "top6": b"\x00\x01 foo",
+    }
+
+    @staticmethod
+    def _call_fut(path, data):
+        from google.cloud.firestore_v1beta1 import field_path
+
+        return field_path.get_nested_value(path, data)
+
+    def test_simple(self):
+        self.assertIs(self._call_fut("top1", self.DATA), self.DATA["top1"])
+
+    def test_nested(self):
+        self.assertIs(
+            self._call_fut("top1.middle2", self.DATA), self.DATA["top1"]["middle2"]
+        )
+        self.assertIs(
+            self._call_fut("top1.middle2.bottom3", self.DATA),
+            self.DATA["top1"]["middle2"]["bottom3"],
+        )
+
+    def test_missing_top_level(self):
+        from google.cloud.firestore_v1beta1.field_path import _FIELD_PATH_MISSING_TOP
+
+        field_path = "top8"
+        with self.assertRaises(KeyError) as exc_info:
+            self._call_fut(field_path, self.DATA)
+
+        err_msg = _FIELD_PATH_MISSING_TOP.format(field_path)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test_missing_key(self):
+        from google.cloud.firestore_v1beta1.field_path import _FIELD_PATH_MISSING_KEY
+
+        with self.assertRaises(KeyError) as exc_info:
+            self._call_fut("top1.middle2.nope", self.DATA)
+
+        err_msg = _FIELD_PATH_MISSING_KEY.format("nope", "top1.middle2")
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test_bad_type(self):
+        from google.cloud.firestore_v1beta1.field_path import _FIELD_PATH_WRONG_TYPE
+
+        with self.assertRaises(KeyError) as exc_info:
+            self._call_fut("top6.middle7", self.DATA)
+
+        err_msg = _FIELD_PATH_WRONG_TYPE.format("top6", "middle7")
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+
+class TestFieldPath(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1 import field_path
+
+        return field_path.FieldPath
+
+    def _make_one(self, *args):
+        klass = self._get_target_class()
+        return klass(*args)
+
+    def test_ctor_w_none_in_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", None, "b")
+
+    def test_ctor_w_empty_string_in_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", "", "b")
+
+    def test_ctor_w_integer_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", 3, "b")
+
+    def test_ctor_w_list(self):
+        parts = ["a", "b", "c"]
+        with self.assertRaises(ValueError):
+            self._make_one(parts)
+
+    def test_ctor_w_tuple(self):
+        parts = ("a", "b", "c")
+        with self.assertRaises(ValueError):
+            self._make_one(parts)
+
+    def test_ctor_w_iterable_part(self):
+        with self.assertRaises(ValueError):
+            self._make_one("a", ["a"], "b")
+
+    def test_constructor_w_single_part(self):
+        field_path = self._make_one("a")
+        self.assertEqual(field_path.parts, ("a",))
+
+    def test_constructor_w_multiple_parts(self):
+        field_path = self._make_one("a", "b", "c")
+        self.assertEqual(field_path.parts, ("a", "b", "c"))
+
+    def test_ctor_w_invalid_chars_in_part(self):
+        invalid_parts = ("~", "*", "/", "[", "]", ".")
+        for invalid_part in invalid_parts:
+            field_path = self._make_one(invalid_part)
+            self.assertEqual(field_path.parts, (invalid_part,))
+
+    def test_ctor_w_double_dots(self):
+        field_path = self._make_one("a..b")
+        self.assertEqual(field_path.parts, ("a..b",))
+
+    def test_ctor_w_unicode(self):
+        field_path = self._make_one("一", "二", "三")
+        self.assertEqual(field_path.parts, ("一", "二", "三"))
+
+    def test_from_api_repr_w_empty_string(self):
+        api_repr = ""
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(api_repr)
+
+    def test_from_api_repr_w_empty_field_name(self):
+        api_repr = "a..b"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(api_repr)
+
+    def test_from_api_repr_w_invalid_chars(self):
+        invalid_parts = ("~", "*", "/", "[", "]", ".")
+        for invalid_part in invalid_parts:
+            with self.assertRaises(ValueError):
+                self._get_target_class().from_api_repr(invalid_part)
+
+    def test_from_api_repr_w_ascii_single(self):
+        api_repr = "a"
+        field_path = self._get_target_class().from_api_repr(api_repr)
+        self.assertEqual(field_path.parts, ("a",))
+
+    def test_from_api_repr_w_ascii_dotted(self):
+        api_repr = "a.b.c"
+        field_path = self._get_target_class().from_api_repr(api_repr)
+        self.assertEqual(field_path.parts, ("a", "b", "c"))
+
+    def test_from_api_repr_w_non_ascii_dotted_non_quoted(self):
+        api_repr = "a.一"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_api_repr(api_repr)
+
+    def test_from_api_repr_w_non_ascii_dotted_quoted(self):
+        api_repr = "a.`一`"
+        field_path = self._get_target_class().from_api_repr(api_repr)
+        self.assertEqual(field_path.parts, ("a", "一"))
+
+    def test_from_string_w_empty_string(self):
+        path_string = ""
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_empty_field_name(self):
+        path_string = "a..b"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_leading_dot(self):
+        path_string = ".b.c"
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_trailing_dot(self):
+        path_string = "a.b."
+        with self.assertRaises(ValueError):
+            self._get_target_class().from_string(path_string)
+
+    def test_from_string_w_leading_invalid_chars(self):
+        invalid_paths = ("~", "*", "/", "[", "]")
+        for invalid_path in invalid_paths:
+            field_path = self._get_target_class().from_string(invalid_path)
+            self.assertEqual(field_path.parts, (invalid_path,))
+
+    def test_from_string_w_embedded_invalid_chars(self):
+        invalid_paths = ("a~b", "x*y", "f/g", "h[j", "k]l")
+        for invalid_path in invalid_paths:
+            with self.assertRaises(ValueError):
+                self._get_target_class().from_string(invalid_path)
+
+    def test_from_string_w_ascii_single(self):
+        path_string = "a"
+        field_path = self._get_target_class().from_string(path_string)
+        self.assertEqual(field_path.parts, ("a",))
+
+    def test_from_string_w_ascii_dotted(self):
+        path_string = "a.b.c"
+        field_path = self._get_target_class().from_string(path_string)
+        self.assertEqual(field_path.parts, ("a", "b", "c"))
+
+    def test_from_string_w_non_ascii_dotted(self):
+        path_string = "a.一"
+        field_path = self._get_target_class().from_string(path_string)
+        self.assertEqual(field_path.parts, ("a", "一"))
+
+    def test___hash___w_single_part(self):
+        field_path = self._make_one("a")
+        self.assertEqual(hash(field_path), hash("a"))
+
+    def test___hash___w_multiple_parts(self):
+        field_path = self._make_one("a", "b")
+        self.assertEqual(hash(field_path), hash("a.b"))
+
+    def test___hash___w_escaped_parts(self):
+        field_path = self._make_one("a", "3")
+        self.assertEqual(hash(field_path), hash("a.`3`"))
+
+    def test___eq___w_matching_type(self):
+        field_path = self._make_one("a", "b")
+        string_path = self._get_target_class().from_string("a.b")
+        self.assertEqual(field_path, string_path)
+
+    def test___eq___w_non_matching_type(self):
+        field_path = self._make_one("a", "c")
+        other = mock.Mock()
+        other.parts = "a", "b"
+        self.assertNotEqual(field_path, other)
+
+    def test___lt___w_matching_type(self):
+        field_path = self._make_one("a", "b")
+        string_path = self._get_target_class().from_string("a.c")
+        self.assertTrue(field_path < string_path)
+
+    def test___lt___w_non_matching_type(self):
+        field_path = self._make_one("a", "b")
+        other = object()
+        # Python 2 doesn't raise TypeError here, but Python3 does.
+        self.assertIs(field_path.__lt__(other), NotImplemented)
+
+    def test___add__(self):
+        path1 = "a123", "b456"
+        path2 = "c789", "d012"
+        path3 = "c789.d012"
+        field_path1 = self._make_one(*path1)
+        field_path1_string = self._make_one(*path1)
+        field_path2 = self._make_one(*path2)
+        field_path1 += field_path2
+        field_path1_string += path3
+        field_path2 = field_path2 + self._make_one(*path1)
+        self.assertEqual(field_path1, self._make_one(*(path1 + path2)))
+        self.assertEqual(field_path2, self._make_one(*(path2 + path1)))
+        self.assertEqual(field_path1_string, field_path1)
+        self.assertNotEqual(field_path1, field_path2)
+        with self.assertRaises(TypeError):
+            field_path1 + 305
+
+    def test_to_api_repr_a(self):
+        parts = "a"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "a")
+
+    def test_to_api_repr_backtick(self):
+        parts = "`"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), r"`\``")
+
+    def test_to_api_repr_dot(self):
+        parts = "."
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`.`")
+
+    def test_to_api_repr_slash(self):
+        parts = "\\"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), r"`\\`")
+
+    def test_to_api_repr_double_slash(self):
+        parts = r"\\"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), r"`\\\\`")
+
+    def test_to_api_repr_underscore(self):
+        parts = "_33132"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "_33132")
+
+    def test_to_api_repr_unicode_non_simple(self):
+        parts = "一"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`一`")
+
+    def test_to_api_repr_number_non_simple(self):
+        parts = "03"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`03`")
+
+    def test_to_api_repr_simple_with_dot(self):
+        field_path = self._make_one("a.b")
+        self.assertEqual(field_path.to_api_repr(), "`a.b`")
+
+    def test_to_api_repr_non_simple_with_dot(self):
+        parts = "a.一"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "`a.一`")
+
+    def test_to_api_repr_simple(self):
+        parts = "a0332432"
+        field_path = self._make_one(parts)
+        self.assertEqual(field_path.to_api_repr(), "a0332432")
+
+    def test_to_api_repr_chain(self):
+        parts = "a", "`", "\\", "_3", "03", "a03", "\\\\", "a0332432", "一"
+        field_path = self._make_one(*parts)
+        self.assertEqual(
+            field_path.to_api_repr(), r"a.`\``.`\\`._3.`03`.a03.`\\\\`.a0332432.`一`"
+        )
+
+    def test_eq_or_parent_same(self):
+        field_path = self._make_one("a", "b")
+        other = self._make_one("a", "b")
+        self.assertTrue(field_path.eq_or_parent(other))
+
+    def test_eq_or_parent_prefix(self):
+        field_path = self._make_one("a", "b")
+        other = self._make_one("a", "b", "c")
+        self.assertTrue(field_path.eq_or_parent(other))
+        self.assertTrue(other.eq_or_parent(field_path))
+
+    def test_eq_or_parent_no_prefix(self):
+        field_path = self._make_one("a", "b")
+        other = self._make_one("d", "e", "f")
+        self.assertFalse(field_path.eq_or_parent(other))
+        self.assertFalse(other.eq_or_parent(field_path))
+
+    def test_lineage_empty(self):
+        field_path = self._make_one()
+        expected = set()
+        self.assertEqual(field_path.lineage(), expected)
+
+    def test_lineage_single(self):
+        field_path = self._make_one("a")
+        expected = set()
+        self.assertEqual(field_path.lineage(), expected)
+
+    def test_lineage_nested(self):
+        field_path = self._make_one("a", "b", "c")
+        expected = set([self._make_one("a"), self._make_one("a", "b")])
+        self.assertEqual(field_path.lineage(), expected)
diff --git a/firestore/tests/unit/v1beta1/test_order.py b/firestore/tests/unit/v1beta1/test_order.py
new file mode 100644
index 000000000000..a68f3ae1b250
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_order.py
@@ -0,0 +1,247 @@
+# -*- coding: utf-8 -*-
+# Copyright 2017 Google LLC 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.
+
+import mock
+import six
+import unittest
+
+from google.cloud.firestore_v1beta1._helpers import encode_value, GeoPoint
+from google.cloud.firestore_v1beta1.order import Order
+from google.cloud.firestore_v1beta1.order import TypeOrder
+
+from google.cloud.firestore_v1beta1.proto import document_pb2
+
+from google.protobuf import timestamp_pb2
+
+
+class TestOrder(unittest.TestCase):
+
+    if six.PY2:
+        assertRaisesRegex = unittest.TestCase.assertRaisesRegexp
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.order import Order
+
+        return Order
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_order(self):
+        # Constants used to represent min/max values of storage types.
+        int_max_value = 2 ** 31 - 1
+        int_min_value = -(2 ** 31)
+        float_min_value = 1.175494351 ** -38
+        float_nan = float("nan")
+        inf = float("inf")
+
+        groups = [None] * 65
+
+        groups[0] = [nullValue()]
+
+        groups[1] = [_boolean_value(False)]
+        groups[2] = [_boolean_value(True)]
+
+        # numbers
+        groups[3] = [_double_value(float_nan), _double_value(float_nan)]
+        groups[4] = [_double_value(-inf)]
+        groups[5] = [_int_value(int_min_value - 1)]
+        groups[6] = [_int_value(int_min_value)]
+        groups[7] = [_double_value(-1.1)]
+        # Integers and Doubles order the same.
+        groups[8] = [_int_value(-1), _double_value(-1.0)]
+        groups[9] = [_double_value(-float_min_value)]
+        # zeros all compare the same.
+        groups[10] = [
+            _int_value(0),
+            _double_value(-0.0),
+            _double_value(0.0),
+            _double_value(+0.0),
+        ]
+        groups[11] = [_double_value(float_min_value)]
+        groups[12] = [_int_value(1), _double_value(1.0)]
+        groups[13] = [_double_value(1.1)]
+        groups[14] = [_int_value(int_max_value)]
+        groups[15] = [_int_value(int_max_value + 1)]
+        groups[16] = [_double_value(inf)]
+
+        groups[17] = [_timestamp_value(123, 0)]
+        groups[18] = [_timestamp_value(123, 123)]
+        groups[19] = [_timestamp_value(345, 0)]
+
+        # strings
+        groups[20] = [_string_value("")]
+        groups[21] = [_string_value("\u0000\ud7ff\ue000\uffff")]
+        groups[22] = [_string_value("(╯°□°）╯︵ ┻━┻")]
+        groups[23] = [_string_value("a")]
+        groups[24] = [_string_value("abc def")]
+        # latin small letter e + combining acute accent + latin small letter b
+        groups[25] = [_string_value("e\u0301b")]
+        groups[26] = [_string_value("æ")]
+        # latin small letter e with acute accent + latin small letter a
+        groups[27] = [_string_value("\u00e9a")]
+
+        # blobs
+        groups[28] = [_blob_value(b"")]
+        groups[29] = [_blob_value(b"\x00")]
+        groups[30] = [_blob_value(b"\x00\x01\x02\x03\x04")]
+        groups[31] = [_blob_value(b"\x00\x01\x02\x04\x03")]
+        groups[32] = [_blob_value(b"\x7f")]
+
+        # resource names
+        groups[33] = [_reference_value("projects/p1/databases/d1/documents/c1/doc1")]
+        groups[34] = [_reference_value("projects/p1/databases/d1/documents/c1/doc2")]
+        groups[35] = [
+            _reference_value("projects/p1/databases/d1/documents/c1/doc2/c2/doc1")
+        ]
+        groups[36] = [
+            _reference_value("projects/p1/databases/d1/documents/c1/doc2/c2/doc2")
+        ]
+        groups[37] = [_reference_value("projects/p1/databases/d1/documents/c10/doc1")]
+        groups[38] = [_reference_value("projects/p1/databases/d1/documents/c2/doc1")]
+        groups[39] = [_reference_value("projects/p2/databases/d2/documents/c1/doc1")]
+        groups[40] = [_reference_value("projects/p2/databases/d2/documents/c1-/doc1")]
+        groups[41] = [_reference_value("projects/p2/databases/d3/documents/c1-/doc1")]
+
+        # geo points
+        groups[42] = [_geoPoint_value(-90, -180)]
+        groups[43] = [_geoPoint_value(-90, 0)]
+        groups[44] = [_geoPoint_value(-90, 180)]
+        groups[45] = [_geoPoint_value(0, -180)]
+        groups[46] = [_geoPoint_value(0, 0)]
+        groups[47] = [_geoPoint_value(0, 180)]
+        groups[48] = [_geoPoint_value(1, -180)]
+        groups[49] = [_geoPoint_value(1, 0)]
+        groups[50] = [_geoPoint_value(1, 180)]
+        groups[51] = [_geoPoint_value(90, -180)]
+        groups[52] = [_geoPoint_value(90, 0)]
+        groups[53] = [_geoPoint_value(90, 180)]
+
+        # arrays
+        groups[54] = [_array_value()]
+        groups[55] = [_array_value(["bar"])]
+        groups[56] = [_array_value(["foo"])]
+        groups[57] = [_array_value(["foo", 0])]
+        groups[58] = [_array_value(["foo", 1])]
+        groups[59] = [_array_value(["foo", "0"])]
+
+        # objects
+        groups[60] = [_object_value({"bar": 0})]
+        groups[61] = [_object_value({"bar": 0, "foo": 1})]
+        groups[62] = [_object_value({"bar": 1})]
+        groups[63] = [_object_value({"bar": 2})]
+        groups[64] = [_object_value({"bar": "0"})]
+
+        target = self._make_one()
+
+        for i in range(len(groups)):
+            for left in groups[i]:
+                for j in range(len(groups)):
+                    for right in groups[j]:
+                        expected = Order._compare_to(i, j)
+
+                        self.assertEqual(
+                            target.compare(left, right),
+                            expected,
+                            "comparing L->R {} ({}) to {} ({})".format(
+                                i, left, j, right
+                            ),
+                        )
+
+                        expected = Order._compare_to(j, i)
+                        self.assertEqual(
+                            target.compare(right, left),
+                            expected,
+                            "comparing R->L {} ({}) to {} ({})".format(
+                                j, right, i, left
+                            ),
+                        )
+
+    def test_typeorder_type_failure(self):
+        target = self._make_one()
+        left = mock.Mock()
+        left.WhichOneof.return_value = "imaginary-type"
+
+        with self.assertRaisesRegex(ValueError, "Could not detect value"):
+            target.compare(left, mock.Mock())
+
+    def test_failure_to_find_type(self):
+        target = self._make_one()
+        left = mock.Mock()
+        left.WhichOneof.return_value = "imaginary-type"
+        right = mock.Mock()
+        # Patch from value to get to the deep compare. Since left is a bad type
+        # expect this to fail with value error.
+        with mock.patch.object(TypeOrder, "from_value") as to:
+            to.value = None
+            with self.assertRaisesRegex(ValueError, "'Unknown ``value_type``"):
+                target.compare(left, right)
+
+    def test_compare_objects_different_keys(self):
+        left = _object_value({"foo": 0})
+        right = _object_value({"bar": 0})
+
+        target = self._make_one()
+        target.compare(left, right)
+
+
+def _boolean_value(b):
+    return encode_value(b)
+
+
+def _double_value(d):
+    return encode_value(d)
+
+
+def _int_value(l):
+    return encode_value(l)
+
+
+def _string_value(s):
+    if not isinstance(s, six.text_type):
+        s = six.u(s)
+    return encode_value(s)
+
+
+def _reference_value(r):
+    return document_pb2.Value(reference_value=r)
+
+
+def _blob_value(b):
+    return encode_value(b)
+
+
+def nullValue():
+    return encode_value(None)
+
+
+def _timestamp_value(seconds, nanos):
+    return document_pb2.Value(
+        timestamp_value=timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
+    )
+
+
+def _geoPoint_value(latitude, longitude):
+    return encode_value(GeoPoint(latitude, longitude))
+
+
+def _array_value(values=[]):
+    return encode_value(values)
+
+
+def _object_value(keysAndValues):
+    return encode_value(keysAndValues)
diff --git a/firestore/tests/unit/v1beta1/test_query.py b/firestore/tests/unit/v1beta1/test_query.py
new file mode 100644
index 000000000000..455a56b7f7ec
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_query.py
@@ -0,0 +1,1590 @@
+# Copyright 2017 Google LLC 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.
+
+import datetime
+import types
+import unittest
+
+import mock
+import pytest
+import six
+
+
+class TestQuery(unittest.TestCase):
+
+    if six.PY2:
+        assertRaisesRegex = unittest.TestCase.assertRaisesRegexp
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.query import Query
+
+        return Query
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIs(query._parent, mock.sentinel.parent)
+        self.assertIsNone(query._projection)
+        self.assertEqual(query._field_filters, ())
+        self.assertEqual(query._orders, ())
+        self.assertIsNone(query._limit)
+        self.assertIsNone(query._offset)
+        self.assertIsNone(query._start_at)
+        self.assertIsNone(query._end_at)
+
+    def _make_one_all_fields(self, limit=9876, offset=12, skip_fields=(), parent=None):
+        kwargs = {
+            "projection": mock.sentinel.projection,
+            "field_filters": mock.sentinel.filters,
+            "orders": mock.sentinel.orders,
+            "limit": limit,
+            "offset": offset,
+            "start_at": mock.sentinel.start_at,
+            "end_at": mock.sentinel.end_at,
+        }
+        for field in skip_fields:
+            kwargs.pop(field)
+        if parent is None:
+            parent = mock.sentinel.parent
+        return self._make_one(parent, **kwargs)
+
+    def test_constructor_explicit(self):
+        limit = 234
+        offset = 56
+        query = self._make_one_all_fields(limit=limit, offset=offset)
+        self.assertIs(query._parent, mock.sentinel.parent)
+        self.assertIs(query._projection, mock.sentinel.projection)
+        self.assertIs(query._field_filters, mock.sentinel.filters)
+        self.assertEqual(query._orders, mock.sentinel.orders)
+        self.assertEqual(query._limit, limit)
+        self.assertEqual(query._offset, offset)
+        self.assertIs(query._start_at, mock.sentinel.start_at)
+        self.assertIs(query._end_at, mock.sentinel.end_at)
+
+    def test__client_property(self):
+        parent = mock.Mock(_client=mock.sentinel.client, spec=["_client"])
+        query = self._make_one(parent)
+        self.assertIs(query._client, mock.sentinel.client)
+
+    def test___eq___other_type(self):
+        client = self._make_one_all_fields()
+        other = object()
+        self.assertFalse(client == other)
+
+    def test___eq___different_parent(self):
+        parent = mock.sentinel.parent
+        other_parent = mock.sentinel.other_parent
+        client = self._make_one_all_fields(parent=parent)
+        other = self._make_one_all_fields(parent=other_parent)
+        self.assertFalse(client == other)
+
+    def test___eq___different_projection(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(parent=parent, skip_fields=("projection",))
+        client._projection = mock.sentinel.projection
+        other = self._make_one_all_fields(parent=parent, skip_fields=("projection",))
+        other._projection = mock.sentinel.other_projection
+        self.assertFalse(client == other)
+
+    def test___eq___different_field_filters(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(
+            parent=parent, skip_fields=("field_filters",)
+        )
+        client._field_filters = mock.sentinel.field_filters
+        other = self._make_one_all_fields(parent=parent, skip_fields=("field_filters",))
+        other._field_filters = mock.sentinel.other_field_filters
+        self.assertFalse(client == other)
+
+    def test___eq___different_orders(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(parent=parent, skip_fields=("orders",))
+        client._orders = mock.sentinel.orders
+        other = self._make_one_all_fields(parent=parent, skip_fields=("orders",))
+        other._orders = mock.sentinel.other_orders
+        self.assertFalse(client == other)
+
+    def test___eq___different_limit(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(parent=parent, limit=10)
+        other = self._make_one_all_fields(parent=parent, limit=20)
+        self.assertFalse(client == other)
+
+    def test___eq___different_offset(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(parent=parent, offset=10)
+        other = self._make_one_all_fields(parent=parent, offset=20)
+        self.assertFalse(client == other)
+
+    def test___eq___different_start_at(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(parent=parent, skip_fields=("start_at",))
+        client._start_at = mock.sentinel.start_at
+        other = self._make_one_all_fields(parent=parent, skip_fields=("start_at",))
+        other._start_at = mock.sentinel.other_start_at
+        self.assertFalse(client == other)
+
+    def test___eq___different_end_at(self):
+        parent = mock.sentinel.parent
+        client = self._make_one_all_fields(parent=parent, skip_fields=("end_at",))
+        client._end_at = mock.sentinel.end_at
+        other = self._make_one_all_fields(parent=parent, skip_fields=("end_at",))
+        other._end_at = mock.sentinel.other_end_at
+        self.assertFalse(client == other)
+
+    def test___eq___hit(self):
+        client = self._make_one_all_fields()
+        other = self._make_one_all_fields()
+        self.assertTrue(client == other)
+
+    def _compare_queries(self, query1, query2, attr_name):
+        attrs1 = query1.__dict__.copy()
+        attrs2 = query2.__dict__.copy()
+
+        attrs1.pop(attr_name)
+        attrs2.pop(attr_name)
+
+        # The only different should be in ``attr_name``.
+        self.assertEqual(len(attrs1), len(attrs2))
+        for key, value in attrs1.items():
+            self.assertIs(value, attrs2[key])
+
+    @staticmethod
+    def _make_projection_for_select(field_paths):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        return query_pb2.StructuredQuery.Projection(
+            fields=[
+                query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                for field_path in field_paths
+            ]
+        )
+
+    def test_select_invalid_path(self):
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query.select(["*"])
+
+    def test_select(self):
+        query1 = self._make_one_all_fields()
+
+        field_paths2 = ["foo", "bar"]
+        query2 = query1.select(field_paths2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, self._get_target_class())
+        self.assertEqual(
+            query2._projection, self._make_projection_for_select(field_paths2)
+        )
+        self._compare_queries(query1, query2, "_projection")
+
+        # Make sure it overrides.
+        field_paths3 = ["foo.baz"]
+        query3 = query2.select(field_paths3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(
+            query3._projection, self._make_projection_for_select(field_paths3)
+        )
+        self._compare_queries(query2, query3, "_projection")
+
+    def test_where_invalid_path(self):
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query.where("*", "==", 1)
+
+    def test_where(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        query = self._make_one_all_fields(skip_fields=("field_filters",))
+        new_query = query.where("power.level", ">", 9000)
+
+        self.assertIsNot(query, new_query)
+        self.assertIsInstance(new_query, self._get_target_class())
+        self.assertEqual(len(new_query._field_filters), 1)
+
+        field_pb = new_query._field_filters[0]
+        expected_pb = query_pb2.StructuredQuery.FieldFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="power.level"),
+            op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+            value=document_pb2.Value(integer_value=9000),
+        )
+        self.assertEqual(field_pb, expected_pb)
+        self._compare_queries(query, new_query, "_field_filters")
+
+    def _where_unary_helper(self, value, op_enum, op_string="=="):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        query = self._make_one_all_fields(skip_fields=("field_filters",))
+        field_path = "feeeld"
+        new_query = query.where(field_path, op_string, value)
+
+        self.assertIsNot(query, new_query)
+        self.assertIsInstance(new_query, self._get_target_class())
+        self.assertEqual(len(new_query._field_filters), 1)
+
+        field_pb = new_query._field_filters[0]
+        expected_pb = query_pb2.StructuredQuery.UnaryFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+            op=op_enum,
+        )
+        self.assertEqual(field_pb, expected_pb)
+        self._compare_queries(query, new_query, "_field_filters")
+
+    def test_where_eq_null(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        op_enum = enums.StructuredQuery.UnaryFilter.Operator.IS_NULL
+        self._where_unary_helper(None, op_enum)
+
+    def test_where_gt_null(self):
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(None, 0, op_string=">")
+
+    def test_where_eq_nan(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        op_enum = enums.StructuredQuery.UnaryFilter.Operator.IS_NAN
+        self._where_unary_helper(float("nan"), op_enum)
+
+    def test_where_le_nan(self):
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(float("nan"), 0, op_string="<=")
+
+    def test_where_w_delete(self):
+        from google.cloud.firestore_v1beta1 import DELETE_FIELD
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(DELETE_FIELD, 0)
+
+    def test_where_w_server_timestamp(self):
+        from google.cloud.firestore_v1beta1 import SERVER_TIMESTAMP
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(SERVER_TIMESTAMP, 0)
+
+    def test_where_w_array_remove(self):
+        from google.cloud.firestore_v1beta1 import ArrayRemove
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(ArrayRemove([1, 3, 5]), 0)
+
+    def test_where_w_array_union(self):
+        from google.cloud.firestore_v1beta1 import ArrayUnion
+
+        with self.assertRaises(ValueError):
+            self._where_unary_helper(ArrayUnion([2, 4, 8]), 0)
+
+    def test_order_by_invalid_path(self):
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query.order_by("*")
+
+    def test_order_by(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        klass = self._get_target_class()
+        query1 = self._make_one_all_fields(skip_fields=("orders",))
+
+        field_path2 = "a"
+        query2 = query1.order_by(field_path2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, klass)
+        order_pb2 = _make_order_pb(
+            field_path2, enums.StructuredQuery.Direction.ASCENDING
+        )
+        self.assertEqual(query2._orders, (order_pb2,))
+        self._compare_queries(query1, query2, "_orders")
+
+        # Make sure it appends to the orders.
+        field_path3 = "b"
+        query3 = query2.order_by(field_path3, direction=klass.DESCENDING)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, klass)
+        order_pb3 = _make_order_pb(
+            field_path3, enums.StructuredQuery.Direction.DESCENDING
+        )
+        self.assertEqual(query3._orders, (order_pb2, order_pb3))
+        self._compare_queries(query2, query3, "_orders")
+
+    def test_limit(self):
+        query1 = self._make_one_all_fields()
+
+        limit2 = 100
+        query2 = query1.limit(limit2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, self._get_target_class())
+        self.assertEqual(query2._limit, limit2)
+        self._compare_queries(query1, query2, "_limit")
+
+        # Make sure it overrides.
+        limit3 = 10
+        query3 = query2.limit(limit3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._limit, limit3)
+        self._compare_queries(query2, query3, "_limit")
+
+    def test_offset(self):
+        query1 = self._make_one_all_fields()
+
+        offset2 = 23
+        query2 = query1.offset(offset2)
+        self.assertIsNot(query2, query1)
+        self.assertIsInstance(query2, self._get_target_class())
+        self.assertEqual(query2._offset, offset2)
+        self._compare_queries(query1, query2, "_offset")
+
+        # Make sure it overrides.
+        offset3 = 35
+        query3 = query2.offset(offset3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._offset, offset3)
+        self._compare_queries(query2, query3, "_offset")
+
+    @staticmethod
+    def _make_collection(*path, **kw):
+        from google.cloud.firestore_v1beta1 import collection
+
+        return collection.CollectionReference(*path, **kw)
+
+    @staticmethod
+    def _make_docref(*path, **kw):
+        from google.cloud.firestore_v1beta1 import document
+
+        return document.DocumentReference(*path, **kw)
+
+    @staticmethod
+    def _make_snapshot(docref, values):
+        from google.cloud.firestore_v1beta1 import document
+
+        return document.DocumentSnapshot(docref, values, True, None, None, None)
+
+    def test__cursor_helper_w_dict(self):
+        values = {"a": 7, "b": "foo"}
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1._cursor_helper(values, True, True)
+
+        self.assertIs(query2._parent, mock.sentinel.parent)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, query1._orders)
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._end_at)
+
+        cursor, before = query2._start_at
+
+        self.assertEqual(cursor, values)
+        self.assertTrue(before)
+
+    def test__cursor_helper_w_tuple(self):
+        values = (7, "foo")
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1._cursor_helper(values, False, True)
+
+        self.assertIs(query2._parent, mock.sentinel.parent)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, query1._orders)
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._end_at)
+
+        cursor, before = query2._start_at
+
+        self.assertEqual(cursor, list(values))
+        self.assertFalse(before)
+
+    def test__cursor_helper_w_list(self):
+        values = [7, "foo"]
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1._cursor_helper(values, True, False)
+
+        self.assertIs(query2._parent, mock.sentinel.parent)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, query1._orders)
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._start_at)
+
+        cursor, before = query2._end_at
+
+        self.assertEqual(cursor, values)
+        self.assertIsNot(cursor, values)
+        self.assertTrue(before)
+
+    def test__cursor_helper_w_snapshot_wrong_collection(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("there", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = self._make_one(collection)
+
+        with self.assertRaises(ValueError):
+            query._cursor_helper(snapshot, False, False)
+
+    def test__cursor_helper_w_snapshot(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query1 = self._make_one(collection)
+
+        query2 = query1._cursor_helper(snapshot, False, False)
+
+        self.assertIs(query2._parent, collection)
+        self.assertIsNone(query2._projection)
+        self.assertEqual(query2._field_filters, ())
+        self.assertEqual(query2._orders, ())
+        self.assertIsNone(query2._limit)
+        self.assertIsNone(query2._offset)
+        self.assertIsNone(query2._start_at)
+
+        cursor, before = query2._end_at
+
+        self.assertIs(cursor, snapshot)
+        self.assertFalse(before)
+
+    def test_start_at(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("hi")
+
+        document_fields3 = {"hi": "mom"}
+        query3 = query2.start_at(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._start_at, (document_fields3, True))
+        self._compare_queries(query2, query3, "_start_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("bye")
+        values5 = {"hi": "zap", "bye": 88}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.start_at(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._start_at, (document_fields5, True))
+        self._compare_queries(query4, query5, "_start_at")
+
+    def test_start_after(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("down")
+
+        document_fields3 = {"down": 99.75}
+        query3 = query2.start_after(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._start_at, (document_fields3, False))
+        self._compare_queries(query2, query3, "_start_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("out")
+        values5 = {"down": 100.25, "out": b"\x00\x01"}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.start_after(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._start_at, (document_fields5, False))
+        self._compare_queries(query4, query5, "_start_at")
+
+    def test_end_before(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("down")
+
+        document_fields3 = {"down": 99.75}
+        query3 = query2.end_before(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._end_at, (document_fields3, True))
+        self._compare_queries(query2, query3, "_end_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("out")
+        values5 = {"down": 100.25, "out": b"\x00\x01"}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.end_before(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._end_at, (document_fields5, True))
+        self._compare_queries(query4, query5, "_end_at")
+        self._compare_queries(query4, query5, "_end_at")
+
+    def test_end_at(self):
+        collection = self._make_collection("here")
+        query1 = self._make_one_all_fields(parent=collection, skip_fields=("orders",))
+        query2 = query1.order_by("hi")
+
+        document_fields3 = {"hi": "mom"}
+        query3 = query2.end_at(document_fields3)
+        self.assertIsNot(query3, query2)
+        self.assertIsInstance(query3, self._get_target_class())
+        self.assertEqual(query3._end_at, (document_fields3, False))
+        self._compare_queries(query2, query3, "_end_at")
+
+        # Make sure it overrides.
+        query4 = query3.order_by("bye")
+        values5 = {"hi": "zap", "bye": 88}
+        docref = self._make_docref("here", "doc_id")
+        document_fields5 = self._make_snapshot(docref, values5)
+        query5 = query4.end_at(document_fields5)
+        self.assertIsNot(query5, query4)
+        self.assertIsInstance(query5, self._get_target_class())
+        self.assertEqual(query5._end_at, (document_fields5, False))
+        self._compare_queries(query4, query5, "_end_at")
+
+    def test__filters_pb_empty(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertEqual(len(query._field_filters), 0)
+        self.assertIsNone(query._filters_pb())
+
+    def test__filters_pb_single(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1.where("x.y", ">", 50.5)
+        filter_pb = query2._filters_pb()
+        expected_pb = query_pb2.StructuredQuery.Filter(
+            field_filter=query_pb2.StructuredQuery.FieldFilter(
+                field=query_pb2.StructuredQuery.FieldReference(field_path="x.y"),
+                op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+                value=document_pb2.Value(double_value=50.5),
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test__filters_pb_multi(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        query1 = self._make_one(mock.sentinel.parent)
+        query2 = query1.where("x.y", ">", 50.5)
+        query3 = query2.where("ABC", "==", 123)
+
+        filter_pb = query3._filters_pb()
+        op_class = enums.StructuredQuery.FieldFilter.Operator
+        expected_pb = query_pb2.StructuredQuery.Filter(
+            composite_filter=query_pb2.StructuredQuery.CompositeFilter(
+                op=enums.StructuredQuery.CompositeFilter.Operator.AND,
+                filters=[
+                    query_pb2.StructuredQuery.Filter(
+                        field_filter=query_pb2.StructuredQuery.FieldFilter(
+                            field=query_pb2.StructuredQuery.FieldReference(
+                                field_path="x.y"
+                            ),
+                            op=op_class.GREATER_THAN,
+                            value=document_pb2.Value(double_value=50.5),
+                        )
+                    ),
+                    query_pb2.StructuredQuery.Filter(
+                        field_filter=query_pb2.StructuredQuery.FieldFilter(
+                            field=query_pb2.StructuredQuery.FieldReference(
+                                field_path="ABC"
+                            ),
+                            op=op_class.EQUAL,
+                            value=document_pb2.Value(integer_value=123),
+                        )
+                    ),
+                ],
+            )
+        )
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test__normalize_projection_none(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIsNone(query._normalize_projection(None))
+
+    def test__normalize_projection_empty(self):
+        projection = self._make_projection_for_select([])
+        query = self._make_one(mock.sentinel.parent)
+        normalized = query._normalize_projection(projection)
+        field_paths = [field_ref.field_path for field_ref in normalized.fields]
+        self.assertEqual(field_paths, ["__name__"])
+
+    def test__normalize_projection_non_empty(self):
+        projection = self._make_projection_for_select(["a", "b"])
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIs(query._normalize_projection(projection), projection)
+
+    def test__normalize_orders_wo_orders_wo_cursors(self):
+        query = self._make_one(mock.sentinel.parent)
+        expected = []
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_w_orders_wo_cursors(self):
+        query = self._make_one(mock.sentinel.parent).order_by("a")
+        expected = [query._make_order("a", "ASCENDING")]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_wo_orders_w_snapshot_cursor(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = self._make_one(collection).start_at(snapshot)
+        expected = [query._make_order("__name__", "ASCENDING")]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_w_name_orders_w_snapshot_cursor(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = (
+            self._make_one(collection)
+            .order_by("__name__", "DESCENDING")
+            .start_at(snapshot)
+        )
+        expected = [query._make_order("__name__", "DESCENDING")]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_wo_orders_w_snapshot_cursor_w_neq_exists(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = (
+            self._make_one(collection)
+            .where("c", "<=", 20)
+            .order_by("c", "DESCENDING")
+            .start_at(snapshot)
+        )
+        expected = [
+            query._make_order("c", "DESCENDING"),
+            query._make_order("__name__", "DESCENDING"),
+        ]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_orders_wo_orders_w_snapshot_cursor_w_neq_where(self):
+        values = {"a": 7, "b": "foo"}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        collection = self._make_collection("here")
+        query = self._make_one(collection).where("c", "<=", 20).end_at(snapshot)
+        expected = [
+            query._make_order("c", "ASCENDING"),
+            query._make_order("__name__", "ASCENDING"),
+        ]
+        self.assertEqual(query._normalize_orders(), expected)
+
+    def test__normalize_cursor_none(self):
+        query = self._make_one(mock.sentinel.parent)
+        self.assertIsNone(query._normalize_cursor(None, query._orders))
+
+    def test__normalize_cursor_no_order(self):
+        cursor = ([1], True)
+        query = self._make_one(mock.sentinel.parent)
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_as_list_mismatched_order(self):
+        cursor = ([1, 2], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_as_dict_mismatched_order(self):
+        cursor = ({"a": 1}, True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_delete(self):
+        from google.cloud.firestore_v1beta1 import DELETE_FIELD
+
+        cursor = ([DELETE_FIELD], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_server_timestamp(self):
+        from google.cloud.firestore_v1beta1 import SERVER_TIMESTAMP
+
+        cursor = ([SERVER_TIMESTAMP], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_array_remove(self):
+        from google.cloud.firestore_v1beta1 import ArrayRemove
+
+        cursor = ([ArrayRemove([1, 3, 5])], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_w_array_union(self):
+        from google.cloud.firestore_v1beta1 import ArrayUnion
+
+        cursor = ([ArrayUnion([2, 4, 8])], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        with self.assertRaises(ValueError):
+            query._normalize_cursor(cursor, query._orders)
+
+    def test__normalize_cursor_as_list_hit(self):
+        cursor = ([1], True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_as_dict_hit(self):
+        cursor = ({"b": 1}, True)
+        query = self._make_one(mock.sentinel.parent).order_by("b", "ASCENDING")
+
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_as_snapshot_hit(self):
+        values = {"b": 1}
+        docref = self._make_docref("here", "doc_id")
+        snapshot = self._make_snapshot(docref, values)
+        cursor = (snapshot, True)
+        collection = self._make_collection("here")
+        query = self._make_one(collection).order_by("b", "ASCENDING")
+
+        self.assertEqual(query._normalize_cursor(cursor, query._orders), ([1], True))
+
+    def test__normalize_cursor_w___name___w_reference(self):
+        db_string = "projects/my-project/database/(default)"
+        client = mock.Mock(spec=["_database_string"])
+        client._database_string = db_string
+        parent = mock.Mock(spec=["_path", "_client"])
+        parent._client = client
+        parent._path = ["C"]
+        query = self._make_one(parent).order_by("__name__", "ASCENDING")
+        docref = self._make_docref("here", "doc_id")
+        values = {"a": 7}
+        snapshot = self._make_snapshot(docref, values)
+        expected = docref
+        cursor = (snapshot, True)
+
+        self.assertEqual(
+            query._normalize_cursor(cursor, query._orders), ([expected], True)
+        )
+
+    def test__normalize_cursor_w___name___wo_slash(self):
+        db_string = "projects/my-project/database/(default)"
+        client = mock.Mock(spec=["_database_string"])
+        client._database_string = db_string
+        parent = mock.Mock(spec=["_path", "_client", "document"])
+        parent._client = client
+        parent._path = ["C"]
+        document = parent.document.return_value = mock.Mock(spec=[])
+        query = self._make_one(parent).order_by("__name__", "ASCENDING")
+        cursor = (["b"], True)
+        expected = document
+
+        self.assertEqual(
+            query._normalize_cursor(cursor, query._orders), ([expected], True)
+        )
+        parent.document.assert_called_once_with("b")
+
+    def test__to_protobuf_all_fields(self):
+        from google.protobuf import wrappers_pb2
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="cat", spec=["id"])
+        query1 = self._make_one(parent)
+        query2 = query1.select(["X", "Y", "Z"])
+        query3 = query2.where("Y", ">", 2.5)
+        query4 = query3.order_by("X")
+        query5 = query4.limit(17)
+        query6 = query5.offset(3)
+        query7 = query6.start_at({"X": 10})
+        query8 = query7.end_at({"X": 25})
+
+        structured_query_pb = query8._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "select": query_pb2.StructuredQuery.Projection(
+                fields=[
+                    query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                    for field_path in ["X", "Y", "Z"]
+                ]
+            ),
+            "where": query_pb2.StructuredQuery.Filter(
+                field_filter=query_pb2.StructuredQuery.FieldFilter(
+                    field=query_pb2.StructuredQuery.FieldReference(field_path="Y"),
+                    op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+                    value=document_pb2.Value(double_value=2.5),
+                )
+            ),
+            "order_by": [
+                _make_order_pb("X", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+            "start_at": query_pb2.Cursor(
+                values=[document_pb2.Value(integer_value=10)], before=True
+            ),
+            "end_at": query_pb2.Cursor(values=[document_pb2.Value(integer_value=25)]),
+            "offset": 3,
+            "limit": wrappers_pb2.Int32Value(value=17),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_select_only(self):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="cat", spec=["id"])
+        query1 = self._make_one(parent)
+        field_paths = ["a.b", "a.c", "d"]
+        query2 = query1.select(field_paths)
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "select": query_pb2.StructuredQuery.Projection(
+                fields=[
+                    query_pb2.StructuredQuery.FieldReference(field_path=field_path)
+                    for field_path in field_paths
+                ]
+            ),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_where_only(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="dog", spec=["id"])
+        query1 = self._make_one(parent)
+        query2 = query1.where("a", "==", u"b")
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "where": query_pb2.StructuredQuery.Filter(
+                field_filter=query_pb2.StructuredQuery.FieldFilter(
+                    field=query_pb2.StructuredQuery.FieldReference(field_path="a"),
+                    op=enums.StructuredQuery.FieldFilter.Operator.EQUAL,
+                    value=document_pb2.Value(string_value=u"b"),
+                )
+            ),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_order_by_only(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="fish", spec=["id"])
+        query1 = self._make_one(parent)
+        query2 = query1.order_by("abc")
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "order_by": [
+                _make_order_pb("abc", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_start_at_only(self):
+        # NOTE: "only" is wrong since we must have ``order_by`` as well.
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="phish", spec=["id"])
+        query = self._make_one(parent).order_by("X.Y").start_after({"X": {"Y": u"Z"}})
+
+        structured_query_pb = query._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "order_by": [
+                _make_order_pb("X.Y", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+            "start_at": query_pb2.Cursor(
+                values=[document_pb2.Value(string_value=u"Z")]
+            ),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_end_at_only(self):
+        # NOTE: "only" is wrong since we must have ``order_by`` as well.
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="ghoti", spec=["id"])
+        query = self._make_one(parent).order_by("a").end_at({"a": 88})
+
+        structured_query_pb = query._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "order_by": [
+                _make_order_pb("a", enums.StructuredQuery.Direction.ASCENDING)
+            ],
+            "end_at": query_pb2.Cursor(values=[document_pb2.Value(integer_value=88)]),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_offset_only(self):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="cartt", spec=["id"])
+        query1 = self._make_one(parent)
+        offset = 14
+        query2 = query1.offset(offset)
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "offset": offset,
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test__to_protobuf_limit_only(self):
+        from google.protobuf import wrappers_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        parent = mock.Mock(id="donut", spec=["id"])
+        query1 = self._make_one(parent)
+        limit = 31
+        query2 = query1.limit(limit)
+
+        structured_query_pb = query2._to_protobuf()
+        query_kwargs = {
+            "from": [
+                query_pb2.StructuredQuery.CollectionSelector(collection_id=parent.id)
+            ],
+            "limit": wrappers_pb2.Int32Value(value=limit),
+        }
+        expected_pb = query_pb2.StructuredQuery(**query_kwargs)
+
+        self.assertEqual(structured_query_pb, expected_pb)
+
+    def test_get_simple(self):
+        import warnings
+
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dee")
+
+        # Add a dummy response to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        name = "{}/sleep".format(expected_prefix)
+        data = {"snooze": 10}
+        response_pb = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+
+        with warnings.catch_warnings(record=True) as warned:
+            get_response = query.get()
+
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("dee", "sleep"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+        # Verify the deprecation
+        self.assertEqual(len(warned), 1)
+        self.assertIs(warned[0].category, DeprecationWarning)
+
+    def test_stream_simple(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dee")
+
+        # Add a dummy response to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        name = "{}/sleep".format(expected_prefix)
+        data = {"snooze": 10}
+        response_pb = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("dee", "sleep"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_with_transaction(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Create a real-ish transaction for this client.
+        transaction = client.transaction()
+        txn_id = b"\x00\x00\x01-work-\xf2"
+        transaction._id = txn_id
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("declaration")
+
+        # Add a dummy response to the minimal fake GAPIC.
+        parent_path, expected_prefix = parent._parent_info()
+        name = "{}/burger".format(expected_prefix)
+        data = {"lettuce": b"\xee\x87"}
+        response_pb = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream(transaction=transaction)
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("declaration", "burger"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_no_results(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["run_query"])
+        empty_response = _make_query_response()
+        run_query_response = iter([empty_response])
+        firestore_api.run_query.return_value = run_query_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dah", "dah", "dum")
+        query = self._make_one(parent)
+
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        self.assertEqual(list(get_response), [])
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_second_response_in_empty_stream(self):
+        # Create a minimal fake GAPIC with a dummy response.
+        firestore_api = mock.Mock(spec=["run_query"])
+        empty_response1 = _make_query_response()
+        empty_response2 = _make_query_response()
+        run_query_response = iter([empty_response1, empty_response2])
+        firestore_api.run_query.return_value = run_query_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("dah", "dah", "dum")
+        query = self._make_one(parent)
+
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        self.assertEqual(list(get_response), [])
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_with_skipped_results(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("talk", "and", "chew-gum")
+
+        # Add two dummy responses to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        response_pb1 = _make_query_response(skipped_results=1)
+        name = "{}/clock".format(expected_prefix)
+        data = {"noon": 12, "nested": {"bird": 10.5}}
+        response_pb2 = _make_query_response(name=name, data=data)
+        firestore_api.run_query.return_value = iter([response_pb1, response_pb2])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("talk", "and", "chew-gum", "clock"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    def test_stream_empty_after_first_response(self):
+        # Create a minimal fake GAPIC.
+        firestore_api = mock.Mock(spec=["run_query"])
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Make a **real** collection reference as parent.
+        parent = client.collection("charles")
+
+        # Add two dummy responses to the minimal fake GAPIC.
+        _, expected_prefix = parent._parent_info()
+        name = "{}/bark".format(expected_prefix)
+        data = {"lee": "hoop"}
+        response_pb1 = _make_query_response(name=name, data=data)
+        response_pb2 = _make_query_response()
+        firestore_api.run_query.return_value = iter([response_pb1, response_pb2])
+
+        # Execute the query and check the response.
+        query = self._make_one(parent)
+        get_response = query.stream()
+        self.assertIsInstance(get_response, types.GeneratorType)
+        returned = list(get_response)
+        self.assertEqual(len(returned), 1)
+        snapshot = returned[0]
+        self.assertEqual(snapshot.reference._path, ("charles", "bark"))
+        self.assertEqual(snapshot.to_dict(), data)
+
+        # Verify the mock call.
+        parent_path, _ = parent._parent_info()
+        firestore_api.run_query.assert_called_once_with(
+            parent_path,
+            query._to_protobuf(),
+            transaction=None,
+            metadata=client._rpc_metadata,
+        )
+
+    @mock.patch("google.cloud.firestore_v1beta1.query.Watch", autospec=True)
+    def test_on_snapshot(self, watch):
+        query = self._make_one(mock.sentinel.parent)
+        query.on_snapshot(None)
+        watch.for_query.assert_called_once()
+
+    def test_comparator_no_ordering(self):
+        query = self._make_one(mock.sentinel.parent)
+        query._orders = []
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, -1)
+
+    def test_comparator_no_ordering_same_id(self):
+        query = self._make_one(mock.sentinel.parent)
+        query._orders = []
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument1")
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, 0)
+
+    def test_comparator_ordering(self):
+        query = self._make_one(mock.sentinel.parent)
+        orderByMock = mock.Mock()
+        orderByMock.field.field_path = "last"
+        orderByMock.direction = 1  # ascending
+        query._orders = [orderByMock]
+
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+        doc1._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "secondlovelace"},
+        }
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+        doc2._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "lovelace"},
+        }
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, 1)
+
+    def test_comparator_ordering_descending(self):
+        query = self._make_one(mock.sentinel.parent)
+        orderByMock = mock.Mock()
+        orderByMock.field.field_path = "last"
+        orderByMock.direction = -1  # descending
+        query._orders = [orderByMock]
+
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+        doc1._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "secondlovelace"},
+        }
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+        doc2._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "lovelace"},
+        }
+
+        sort = query._comparator(doc1, doc2)
+        self.assertEqual(sort, -1)
+
+    def test_comparator_missing_order_by_field_in_data_raises(self):
+        query = self._make_one(mock.sentinel.parent)
+        orderByMock = mock.Mock()
+        orderByMock.field.field_path = "last"
+        orderByMock.direction = 1  # ascending
+        query._orders = [orderByMock]
+
+        doc1 = mock.Mock()
+        doc1.reference._path = ("col", "adocument1")
+        doc1._data = {}
+        doc2 = mock.Mock()
+        doc2.reference._path = ("col", "adocument2")
+        doc2._data = {
+            "first": {"stringValue": "Ada"},
+            "last": {"stringValue": "lovelace"},
+        }
+
+        with self.assertRaisesRegex(ValueError, "Can only compare fields "):
+            query._comparator(doc1, doc2)
+
+
+class Test__enum_from_op_string(unittest.TestCase):
+    @staticmethod
+    def _call_fut(op_string):
+        from google.cloud.firestore_v1beta1.query import _enum_from_op_string
+
+        return _enum_from_op_string(op_string)
+
+    def test_success(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+
+        op_class = enums.StructuredQuery.FieldFilter.Operator
+        self.assertEqual(self._call_fut("<"), op_class.LESS_THAN)
+        self.assertEqual(self._call_fut("<="), op_class.LESS_THAN_OR_EQUAL)
+        self.assertEqual(self._call_fut("=="), op_class.EQUAL)
+        self.assertEqual(self._call_fut(">="), op_class.GREATER_THAN_OR_EQUAL)
+        self.assertEqual(self._call_fut(">"), op_class.GREATER_THAN)
+        self.assertEqual(self._call_fut("array_contains"), op_class.ARRAY_CONTAINS)
+
+    def test_failure(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("?")
+
+
+class Test__isnan(unittest.TestCase):
+    @staticmethod
+    def _call_fut(value):
+        from google.cloud.firestore_v1beta1.query import _isnan
+
+        return _isnan(value)
+
+    def test_valid(self):
+        self.assertTrue(self._call_fut(float("nan")))
+
+    def test_invalid(self):
+        self.assertFalse(self._call_fut(51.5))
+        self.assertFalse(self._call_fut(None))
+        self.assertFalse(self._call_fut("str"))
+        self.assertFalse(self._call_fut(int))
+        self.assertFalse(self._call_fut(1.0 + 1.0j))
+
+
+class Test__enum_from_direction(unittest.TestCase):
+    @staticmethod
+    def _call_fut(direction):
+        from google.cloud.firestore_v1beta1.query import _enum_from_direction
+
+        return _enum_from_direction(direction)
+
+    def test_success(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.query import Query
+
+        dir_class = enums.StructuredQuery.Direction
+        self.assertEqual(self._call_fut(Query.ASCENDING), dir_class.ASCENDING)
+        self.assertEqual(self._call_fut(Query.DESCENDING), dir_class.DESCENDING)
+
+        # Ints pass through
+        self.assertEqual(self._call_fut(dir_class.ASCENDING), dir_class.ASCENDING)
+        self.assertEqual(self._call_fut(dir_class.DESCENDING), dir_class.DESCENDING)
+
+    def test_failure(self):
+        with self.assertRaises(ValueError):
+            self._call_fut("neither-ASCENDING-nor-DESCENDING")
+
+
+class Test__filter_pb(unittest.TestCase):
+    @staticmethod
+    def _call_fut(field_or_unary):
+        from google.cloud.firestore_v1beta1.query import _filter_pb
+
+        return _filter_pb(field_or_unary)
+
+    def test_unary(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        unary_pb = query_pb2.StructuredQuery.UnaryFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="a.b.c"),
+            op=enums.StructuredQuery.UnaryFilter.Operator.IS_NULL,
+        )
+        filter_pb = self._call_fut(unary_pb)
+        expected_pb = query_pb2.StructuredQuery.Filter(unary_filter=unary_pb)
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_field(self):
+        from google.cloud.firestore_v1beta1.gapic import enums
+        from google.cloud.firestore_v1beta1.proto import document_pb2
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+
+        field_filter_pb = query_pb2.StructuredQuery.FieldFilter(
+            field=query_pb2.StructuredQuery.FieldReference(field_path="XYZ"),
+            op=enums.StructuredQuery.FieldFilter.Operator.GREATER_THAN,
+            value=document_pb2.Value(double_value=90.75),
+        )
+        filter_pb = self._call_fut(field_filter_pb)
+        expected_pb = query_pb2.StructuredQuery.Filter(field_filter=field_filter_pb)
+        self.assertEqual(filter_pb, expected_pb)
+
+    def test_bad_type(self):
+        with self.assertRaises(ValueError):
+            self._call_fut(None)
+
+
+class Test__cursor_pb(unittest.TestCase):
+    @staticmethod
+    def _call_fut(cursor_pair):
+        from google.cloud.firestore_v1beta1.query import _cursor_pb
+
+        return _cursor_pb(cursor_pair)
+
+    def test_no_pair(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_success(self):
+        from google.cloud.firestore_v1beta1.proto import query_pb2
+        from google.cloud.firestore_v1beta1 import _helpers
+
+        data = [1.5, 10, True]
+        cursor_pair = data, True
+
+        cursor_pb = self._call_fut(cursor_pair)
+
+        expected_pb = query_pb2.Cursor(
+            values=[_helpers.encode_value(value) for value in data], before=True
+        )
+        self.assertEqual(cursor_pb, expected_pb)
+
+
+class Test__query_response_to_snapshot(unittest.TestCase):
+    @staticmethod
+    def _call_fut(response_pb, collection, expected_prefix):
+        from google.cloud.firestore_v1beta1.query import _query_response_to_snapshot
+
+        return _query_response_to_snapshot(response_pb, collection, expected_prefix)
+
+    def test_empty(self):
+        response_pb = _make_query_response()
+        snapshot = self._call_fut(response_pb, None, None)
+        self.assertIsNone(snapshot)
+
+    def test_after_offset(self):
+        skipped_results = 410
+        response_pb = _make_query_response(skipped_results=skipped_results)
+        snapshot = self._call_fut(response_pb, None, None)
+        self.assertIsNone(snapshot)
+
+    def test_response(self):
+        from google.cloud.firestore_v1beta1.document import DocumentSnapshot
+
+        client = _make_client()
+        collection = client.collection("a", "b", "c")
+        _, expected_prefix = collection._parent_info()
+
+        # Create name for the protobuf.
+        doc_id = "gigantic"
+        name = "{}/{}".format(expected_prefix, doc_id)
+        data = {"a": 901, "b": True}
+        response_pb = _make_query_response(name=name, data=data)
+
+        snapshot = self._call_fut(response_pb, collection, expected_prefix)
+        self.assertIsInstance(snapshot, DocumentSnapshot)
+        expected_path = collection._path + (doc_id,)
+        self.assertEqual(snapshot.reference._path, expected_path)
+        self.assertEqual(snapshot.to_dict(), data)
+        self.assertTrue(snapshot.exists)
+        self.assertEqual(snapshot.read_time, response_pb.read_time)
+        self.assertEqual(snapshot.create_time, response_pb.document.create_time)
+        self.assertEqual(snapshot.update_time, response_pb.document.update_time)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="project-project"):
+    from google.cloud.firestore_v1beta1.client import Client
+
+    credentials = _make_credentials()
+
+    with pytest.deprecated_call():
+        return Client(project=project, credentials=credentials)
+
+
+def _make_order_pb(field_path, direction):
+    from google.cloud.firestore_v1beta1.proto import query_pb2
+
+    return query_pb2.StructuredQuery.Order(
+        field=query_pb2.StructuredQuery.FieldReference(field_path=field_path),
+        direction=direction,
+    )
+
+
+def _make_query_response(**kwargs):
+    # kwargs supported are ``skipped_results``, ``name`` and ``data``
+    from google.cloud.firestore_v1beta1.proto import document_pb2
+    from google.cloud.firestore_v1beta1.proto import firestore_pb2
+    from google.cloud._helpers import _datetime_to_pb_timestamp
+    from google.cloud.firestore_v1beta1 import _helpers
+
+    now = datetime.datetime.utcnow()
+    read_time = _datetime_to_pb_timestamp(now)
+    kwargs["read_time"] = read_time
+
+    name = kwargs.pop("name", None)
+    data = kwargs.pop("data", None)
+    if name is not None and data is not None:
+        document_pb = document_pb2.Document(
+            name=name, fields=_helpers.encode_dict(data)
+        )
+        delta = datetime.timedelta(seconds=100)
+        update_time = _datetime_to_pb_timestamp(now - delta)
+        create_time = _datetime_to_pb_timestamp(now - 2 * delta)
+        document_pb.update_time.CopyFrom(update_time)
+        document_pb.create_time.CopyFrom(create_time)
+
+        kwargs["document"] = document_pb
+
+    return firestore_pb2.RunQueryResponse(**kwargs)
diff --git a/firestore/tests/unit/v1beta1/test_transaction.py b/firestore/tests/unit/v1beta1/test_transaction.py
new file mode 100644
index 000000000000..1797007495f5
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_transaction.py
@@ -0,0 +1,990 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+import mock
+import pytest
+
+
+class TestTransaction(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.transaction import Transaction
+
+        return Transaction
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        from google.cloud.firestore_v1beta1.transaction import MAX_ATTEMPTS
+
+        transaction = self._make_one(mock.sentinel.client)
+        self.assertIs(transaction._client, mock.sentinel.client)
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertEqual(transaction._max_attempts, MAX_ATTEMPTS)
+        self.assertFalse(transaction._read_only)
+        self.assertIsNone(transaction._id)
+
+    def test_constructor_explicit(self):
+        transaction = self._make_one(
+            mock.sentinel.client, max_attempts=10, read_only=True
+        )
+        self.assertIs(transaction._client, mock.sentinel.client)
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertEqual(transaction._max_attempts, 10)
+        self.assertTrue(transaction._read_only)
+        self.assertIsNone(transaction._id)
+
+    def test__add_write_pbs_failure(self):
+        from google.cloud.firestore_v1beta1.transaction import _WRITE_READ_ONLY
+
+        batch = self._make_one(mock.sentinel.client, read_only=True)
+        self.assertEqual(batch._write_pbs, [])
+        with self.assertRaises(ValueError) as exc_info:
+            batch._add_write_pbs([mock.sentinel.write])
+
+        self.assertEqual(exc_info.exception.args, (_WRITE_READ_ONLY,))
+        self.assertEqual(batch._write_pbs, [])
+
+    def test__add_write_pbs(self):
+        batch = self._make_one(mock.sentinel.client)
+        self.assertEqual(batch._write_pbs, [])
+        batch._add_write_pbs([mock.sentinel.write])
+        self.assertEqual(batch._write_pbs, [mock.sentinel.write])
+
+    def test__options_protobuf_read_only(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        transaction = self._make_one(mock.sentinel.client, read_only=True)
+        options_pb = transaction._options_protobuf(None)
+        expected_pb = common_pb2.TransactionOptions(
+            read_only=common_pb2.TransactionOptions.ReadOnly()
+        )
+        self.assertEqual(options_pb, expected_pb)
+
+    def test__options_protobuf_read_only_retry(self):
+        from google.cloud.firestore_v1beta1.transaction import _CANT_RETRY_READ_ONLY
+
+        transaction = self._make_one(mock.sentinel.client, read_only=True)
+        retry_id = b"illuminate"
+
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._options_protobuf(retry_id)
+
+        self.assertEqual(exc_info.exception.args, (_CANT_RETRY_READ_ONLY,))
+
+    def test__options_protobuf_read_write(self):
+        transaction = self._make_one(mock.sentinel.client)
+        options_pb = transaction._options_protobuf(None)
+        self.assertIsNone(options_pb)
+
+    def test__options_protobuf_on_retry(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        transaction = self._make_one(mock.sentinel.client)
+        retry_id = b"hocus-pocus"
+        options_pb = transaction._options_protobuf(retry_id)
+        expected_pb = common_pb2.TransactionOptions(
+            read_write=common_pb2.TransactionOptions.ReadWrite(
+                retry_transaction=retry_id
+            )
+        )
+        self.assertEqual(options_pb, expected_pb)
+
+    def test_in_progress_property(self):
+        transaction = self._make_one(mock.sentinel.client)
+        self.assertFalse(transaction.in_progress)
+        transaction._id = b"not-none-bites"
+        self.assertTrue(transaction.in_progress)
+
+    def test_id_property(self):
+        transaction = self._make_one(mock.sentinel.client)
+        transaction._id = mock.sentinel.eye_dee
+        self.assertIs(transaction.id, mock.sentinel.eye_dee)
+
+    def test__begin(self):
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+        from google.cloud.firestore_v1beta1.proto import firestore_pb2
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        txn_id = b"to-begin"
+        response = firestore_pb2.BeginTransactionResponse(transaction=txn_id)
+        firestore_api.begin_transaction.return_value = response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction and ``begin()`` it.
+        transaction = self._make_one(client)
+        self.assertIsNone(transaction._id)
+
+        ret_val = transaction._begin()
+        self.assertIsNone(ret_val)
+        self.assertEqual(transaction._id, txn_id)
+
+        # Verify the called mock.
+        firestore_api.begin_transaction.assert_called_once_with(
+            client._database_string, options_=None, metadata=client._rpc_metadata
+        )
+
+    def test__begin_failure(self):
+        from google.cloud.firestore_v1beta1.transaction import _CANT_BEGIN
+
+        client = _make_client()
+        transaction = self._make_one(client)
+        transaction._id = b"not-none"
+
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._begin()
+
+        err_msg = _CANT_BEGIN.format(transaction._id)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+    def test__clean_up(self):
+        transaction = self._make_one(mock.sentinel.client)
+        transaction._write_pbs.extend(
+            [mock.sentinel.write_pb1, mock.sentinel.write_pb2]
+        )
+        transaction._id = b"not-this-time-my-friend"
+
+        ret_val = transaction._clean_up()
+        self.assertIsNone(ret_val)
+
+        self.assertEqual(transaction._write_pbs, [])
+        self.assertIsNone(transaction._id)
+
+    def test__rollback(self):
+        from google.protobuf import empty_pb2
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        firestore_api.rollback.return_value = empty_pb2.Empty()
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction and roll it back.
+        transaction = self._make_one(client)
+        txn_id = b"to-be-r\x00lled"
+        transaction._id = txn_id
+        ret_val = transaction._rollback()
+        self.assertIsNone(ret_val)
+        self.assertIsNone(transaction._id)
+
+        # Verify the called mock.
+        firestore_api.rollback.assert_called_once_with(
+            client._database_string, txn_id, metadata=client._rpc_metadata
+        )
+
+    def test__rollback_not_allowed(self):
+        from google.cloud.firestore_v1beta1.transaction import _CANT_ROLLBACK
+
+        client = _make_client()
+        transaction = self._make_one(client)
+        self.assertIsNone(transaction._id)
+
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._rollback()
+
+        self.assertEqual(exc_info.exception.args, (_CANT_ROLLBACK,))
+
+    def test__rollback_failure(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy failure.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        exc = exceptions.InternalServerError("Fire during rollback.")
+        firestore_api.rollback.side_effect = exc
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction and roll it back.
+        transaction = self._make_one(client)
+        txn_id = b"roll-bad-server"
+        transaction._id = txn_id
+
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            transaction._rollback()
+
+        self.assertIs(exc_info.exception, exc)
+        self.assertIsNone(transaction._id)
+        self.assertEqual(transaction._write_pbs, [])
+
+        # Verify the called mock.
+        firestore_api.rollback.assert_called_once_with(
+            client._database_string, txn_id, metadata=client._rpc_metadata
+        )
+
+    def test__commit(self):
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+        from google.cloud.firestore_v1beta1.proto import firestore_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        commit_response = firestore_pb2.CommitResponse(
+            write_results=[write_pb2.WriteResult()]
+        )
+        firestore_api.commit.return_value = commit_response
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("phone-joe")
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction with some mutations and call _commit().
+        transaction = self._make_one(client)
+        txn_id = b"under-over-thru-woods"
+        transaction._id = txn_id
+        document = client.document("zap", "galaxy", "ship", "space")
+        transaction.set(document, {"apple": 4.5})
+        write_pbs = transaction._write_pbs[::]
+
+        write_results = transaction._commit()
+        self.assertEqual(write_results, list(commit_response.write_results))
+        # Make sure transaction has no more "changes".
+        self.assertIsNone(transaction._id)
+        self.assertEqual(transaction._write_pbs, [])
+
+        # Verify the mocks.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    def test__commit_not_allowed(self):
+        from google.cloud.firestore_v1beta1.transaction import _CANT_COMMIT
+
+        transaction = self._make_one(mock.sentinel.client)
+        self.assertIsNone(transaction._id)
+        with self.assertRaises(ValueError) as exc_info:
+            transaction._commit()
+
+        self.assertEqual(exc_info.exception.args, (_CANT_COMMIT,))
+
+    def test__commit_failure(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy failure.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        exc = exceptions.InternalServerError("Fire during commit.")
+        firestore_api.commit.side_effect = exc
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client()
+        client._firestore_api_internal = firestore_api
+
+        # Actually make a transaction with some mutations and call _commit().
+        transaction = self._make_one(client)
+        txn_id = b"beep-fail-commit"
+        transaction._id = txn_id
+        transaction.create(client.document("up", "down"), {"water": 1.0})
+        transaction.delete(client.document("up", "left"))
+        write_pbs = transaction._write_pbs[::]
+
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            transaction._commit()
+
+        self.assertIs(exc_info.exception, exc)
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(transaction._write_pbs, write_pbs)
+
+        # Verify the called mock.
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+
+class Test_Transactional(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.transaction import _Transactional
+
+        return _Transactional
+
+    def _make_one(self, *args, **kwargs):
+        klass = self._get_target_class()
+        return klass(*args, **kwargs)
+
+    def test_constructor(self):
+        wrapped = self._make_one(mock.sentinel.callable_)
+        self.assertIs(wrapped.to_wrap, mock.sentinel.callable_)
+        self.assertIsNone(wrapped.current_id)
+        self.assertIsNone(wrapped.retry_id)
+
+    def test__reset(self):
+        wrapped = self._make_one(mock.sentinel.callable_)
+        wrapped.current_id = b"not-none"
+        wrapped.retry_id = b"also-not"
+
+        ret_val = wrapped._reset()
+        self.assertIsNone(ret_val)
+
+        self.assertIsNone(wrapped.current_id)
+        self.assertIsNone(wrapped.retry_id)
+
+    def test__pre_commit_success(self):
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"totes-began"
+        transaction = _make_transaction(txn_id)
+        result = wrapped._pre_commit(transaction, "pos", key="word")
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, "pos", key="word")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_not_called()
+
+    def test__pre_commit_retry_id_already_set_success(self):
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+        txn_id1 = b"already-set"
+        wrapped.retry_id = txn_id1
+
+        txn_id2 = b"ok-here-too"
+        transaction = _make_transaction(txn_id2)
+        result = wrapped._pre_commit(transaction)
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertEqual(transaction._id, txn_id2)
+        self.assertEqual(wrapped.current_id, txn_id2)
+        self.assertEqual(wrapped.retry_id, txn_id1)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction)
+        firestore_api = transaction._client._firestore_api
+        options_ = common_pb2.TransactionOptions(
+            read_write=common_pb2.TransactionOptions.ReadWrite(
+                retry_transaction=txn_id1
+            )
+        )
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=options_,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_not_called()
+
+    def test__pre_commit_failure(self):
+        exc = RuntimeError("Nope not today.")
+        to_wrap = mock.Mock(side_effect=exc, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"gotta-fail"
+        transaction = _make_transaction(txn_id)
+        with self.assertRaises(RuntimeError) as exc_info:
+            wrapped._pre_commit(transaction, 10, 20)
+        self.assertIs(exc_info.exception, exc)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, 10, 20)
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_called_once_with(
+            transaction._client._database_string,
+            txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.commit.assert_not_called()
+
+    def test__pre_commit_failure_with_rollback_failure(self):
+        from google.api_core import exceptions
+
+        exc1 = ValueError("I will not be only failure.")
+        to_wrap = mock.Mock(side_effect=exc1, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"both-will-fail"
+        transaction = _make_transaction(txn_id)
+        # Actually force the ``rollback`` to fail as well.
+        exc2 = exceptions.InternalServerError("Rollback blues.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.rollback.side_effect = exc2
+
+        # Try to ``_pre_commit``
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            wrapped._pre_commit(transaction, a="b", c="zebra")
+        self.assertIs(exc_info.exception, exc2)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, a="b", c="zebra")
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_called_once_with(
+            transaction._client._database_string,
+            txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.commit.assert_not_called()
+
+    def test__maybe_commit_success(self):
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"nyet"
+        transaction = _make_transaction(txn_id)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        succeeded = wrapped._maybe_commit(transaction)
+        self.assertTrue(succeeded)
+
+        # On success, _id is reset.
+        self.assertIsNone(transaction._id)
+
+        # Verify mocks.
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test__maybe_commit_failure_read_only(self):
+        from google.api_core import exceptions
+
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"failed"
+        transaction = _make_transaction(txn_id, read_only=True)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        wrapped.current_id = txn_id  # We won't call ``_pre_commit()``.
+        wrapped.retry_id = txn_id  # We won't call ``_pre_commit()``.
+
+        # Actually force the ``commit`` to fail (use ABORTED, but cannot
+        # retry since read-only).
+        exc = exceptions.Aborted("Read-only did a bad.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        with self.assertRaises(exceptions.Aborted) as exc_info:
+            wrapped._maybe_commit(transaction)
+        self.assertIs(exc_info.exception, exc)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test__maybe_commit_failure_can_retry(self):
+        from google.api_core import exceptions
+
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"failed-but-retry"
+        transaction = _make_transaction(txn_id)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        wrapped.current_id = txn_id  # We won't call ``_pre_commit()``.
+        wrapped.retry_id = txn_id  # We won't call ``_pre_commit()``.
+
+        # Actually force the ``commit`` to fail.
+        exc = exceptions.Aborted("Read-write did a bad.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        succeeded = wrapped._maybe_commit(transaction)
+        self.assertFalse(succeeded)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test__maybe_commit_failure_cannot_retry(self):
+        from google.api_core import exceptions
+
+        wrapped = self._make_one(mock.sentinel.callable_)
+
+        txn_id = b"failed-but-not-retryable"
+        transaction = _make_transaction(txn_id)
+        transaction._id = txn_id  # We won't call ``begin()``.
+        wrapped.current_id = txn_id  # We won't call ``_pre_commit()``.
+        wrapped.retry_id = txn_id  # We won't call ``_pre_commit()``.
+
+        # Actually force the ``commit`` to fail.
+        exc = exceptions.InternalServerError("Real bad thing")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            wrapped._maybe_commit(transaction)
+        self.assertIs(exc_info.exception, exc)
+
+        self.assertEqual(transaction._id, txn_id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        firestore_api.begin_transaction.assert_not_called()
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test___call__success_first_attempt(self):
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"whole-enchilada"
+        transaction = _make_transaction(txn_id)
+        result = wrapped(transaction, "a", b="c")
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, "a", b="c")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+    def test___call__success_second_attempt(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.proto import common_pb2
+        from google.cloud.firestore_v1beta1.proto import firestore_pb2
+        from google.cloud.firestore_v1beta1.proto import write_pb2
+
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"whole-enchilada"
+        transaction = _make_transaction(txn_id)
+
+        # Actually force the ``commit`` to fail on first / succeed on second.
+        exc = exceptions.Aborted("Contention junction.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = [
+            exc,
+            firestore_pb2.CommitResponse(write_results=[write_pb2.WriteResult()]),
+        ]
+
+        # Call the __call__-able ``wrapped``.
+        result = wrapped(transaction, "a", b="c")
+        self.assertIs(result, mock.sentinel.result)
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        wrapped_call = mock.call(transaction, "a", b="c")
+        self.assertEqual(to_wrap.mock_calls, [wrapped_call, wrapped_call])
+        firestore_api = transaction._client._firestore_api
+        db_str = transaction._client._database_string
+        options_ = common_pb2.TransactionOptions(
+            read_write=common_pb2.TransactionOptions.ReadWrite(retry_transaction=txn_id)
+        )
+        self.assertEqual(
+            firestore_api.begin_transaction.mock_calls,
+            [
+                mock.call(
+                    db_str, options_=None, metadata=transaction._client._rpc_metadata
+                ),
+                mock.call(
+                    db_str,
+                    options_=options_,
+                    metadata=transaction._client._rpc_metadata,
+                ),
+            ],
+        )
+        firestore_api.rollback.assert_not_called()
+        commit_call = mock.call(
+            db_str, [], transaction=txn_id, metadata=transaction._client._rpc_metadata
+        )
+        self.assertEqual(firestore_api.commit.mock_calls, [commit_call, commit_call])
+
+    def test___call__failure(self):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.transaction import _EXCEED_ATTEMPTS_TEMPLATE
+
+        to_wrap = mock.Mock(return_value=mock.sentinel.result, spec=[])
+        wrapped = self._make_one(to_wrap)
+
+        txn_id = b"only-one-shot"
+        transaction = _make_transaction(txn_id, max_attempts=1)
+
+        # Actually force the ``commit`` to fail.
+        exc = exceptions.Aborted("Contention just once.")
+        firestore_api = transaction._client._firestore_api
+        firestore_api.commit.side_effect = exc
+
+        # Call the __call__-able ``wrapped``.
+        with self.assertRaises(ValueError) as exc_info:
+            wrapped(transaction, "here", there=1.5)
+
+        err_msg = _EXCEED_ATTEMPTS_TEMPLATE.format(transaction._max_attempts)
+        self.assertEqual(exc_info.exception.args, (err_msg,))
+
+        self.assertIsNone(transaction._id)
+        self.assertEqual(wrapped.current_id, txn_id)
+        self.assertEqual(wrapped.retry_id, txn_id)
+
+        # Verify mocks.
+        to_wrap.assert_called_once_with(transaction, "here", there=1.5)
+        firestore_api.begin_transaction.assert_called_once_with(
+            transaction._client._database_string,
+            options_=None,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.rollback.assert_called_once_with(
+            transaction._client._database_string,
+            txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+        firestore_api.commit.assert_called_once_with(
+            transaction._client._database_string,
+            [],
+            transaction=txn_id,
+            metadata=transaction._client._rpc_metadata,
+        )
+
+
+class Test_transactional(unittest.TestCase):
+    @staticmethod
+    def _call_fut(to_wrap):
+        from google.cloud.firestore_v1beta1.transaction import transactional
+
+        return transactional(to_wrap)
+
+    def test_it(self):
+        from google.cloud.firestore_v1beta1.transaction import _Transactional
+
+        wrapped = self._call_fut(mock.sentinel.callable_)
+        self.assertIsInstance(wrapped, _Transactional)
+        self.assertIs(wrapped.to_wrap, mock.sentinel.callable_)
+
+
+class Test__commit_with_retry(unittest.TestCase):
+    @staticmethod
+    def _call_fut(client, write_pbs, transaction_id):
+        from google.cloud.firestore_v1beta1.transaction import _commit_with_retry
+
+        return _commit_with_retry(client, write_pbs, transaction_id)
+
+    @mock.patch("google.cloud.firestore_v1beta1.transaction._sleep")
+    def test_success_first_attempt(self, _sleep):
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("summer")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"cheeeeeez"
+        commit_response = self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+        self.assertIs(commit_response, firestore_api.commit.return_value)
+
+        # Verify mocks used.
+        _sleep.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    @mock.patch(
+        "google.cloud.firestore_v1beta1.transaction._sleep", side_effect=[2.0, 4.0]
+    )
+    def test_success_third_attempt(self, _sleep):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        # Make sure the first two requests fail and the third succeeds.
+        firestore_api.commit.side_effect = [
+            exceptions.ServiceUnavailable("Server sleepy."),
+            exceptions.ServiceUnavailable("Server groggy."),
+            mock.sentinel.commit_response,
+        ]
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("outside")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"the-world\x00"
+        commit_response = self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+        self.assertIs(commit_response, mock.sentinel.commit_response)
+
+        # Verify mocks used.
+        self.assertEqual(_sleep.call_count, 2)
+        _sleep.assert_any_call(1.0)
+        _sleep.assert_any_call(2.0)
+        # commit() called same way 3 times.
+        commit_call = mock.call(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+        self.assertEqual(
+            firestore_api.commit.mock_calls, [commit_call, commit_call, commit_call]
+        )
+
+    @mock.patch("google.cloud.firestore_v1beta1.transaction._sleep")
+    def test_failure_first_attempt(self, _sleep):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        # Make sure the first request fails with an un-retryable error.
+        exc = exceptions.ResourceExhausted("We ran out of fries.")
+        firestore_api.commit.side_effect = exc
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("peanut-butter")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"\x08\x06\x07\x05\x03\x00\x09-jenny"
+        with self.assertRaises(exceptions.ResourceExhausted) as exc_info:
+            self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+
+        self.assertIs(exc_info.exception, exc)
+
+        # Verify mocks used.
+        _sleep.assert_not_called()
+        firestore_api.commit.assert_called_once_with(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+
+    @mock.patch("google.cloud.firestore_v1beta1.transaction._sleep", return_value=2.0)
+    def test_failure_second_attempt(self, _sleep):
+        from google.api_core import exceptions
+        from google.cloud.firestore_v1beta1.gapic import firestore_client
+
+        # Create a minimal fake GAPIC with a dummy result.
+        firestore_api = mock.create_autospec(
+            firestore_client.FirestoreClient, instance=True
+        )
+        # Make sure the first request fails retry-able and second
+        # fails non-retryable.
+        exc1 = exceptions.ServiceUnavailable("Come back next time.")
+        exc2 = exceptions.InternalServerError("Server on fritz.")
+        firestore_api.commit.side_effect = [exc1, exc2]
+
+        # Attach the fake GAPIC to a real client.
+        client = _make_client("peanut-butter")
+        client._firestore_api_internal = firestore_api
+
+        # Call function and check result.
+        txn_id = b"the-journey-when-and-where-well-go"
+        with self.assertRaises(exceptions.InternalServerError) as exc_info:
+            self._call_fut(client, mock.sentinel.write_pbs, txn_id)
+
+        self.assertIs(exc_info.exception, exc2)
+
+        # Verify mocks used.
+        _sleep.assert_called_once_with(1.0)
+        # commit() called same way 2 times.
+        commit_call = mock.call(
+            client._database_string,
+            mock.sentinel.write_pbs,
+            transaction=txn_id,
+            metadata=client._rpc_metadata,
+        )
+        self.assertEqual(firestore_api.commit.mock_calls, [commit_call, commit_call])
+
+
+class Test__sleep(unittest.TestCase):
+    @staticmethod
+    def _call_fut(current_sleep, **kwargs):
+        from google.cloud.firestore_v1beta1.transaction import _sleep
+
+        return _sleep(current_sleep, **kwargs)
+
+    @mock.patch("random.uniform", return_value=5.5)
+    @mock.patch("time.sleep", return_value=None)
+    def test_defaults(self, sleep, uniform):
+        curr_sleep = 10.0
+        self.assertLessEqual(uniform.return_value, curr_sleep)
+
+        new_sleep = self._call_fut(curr_sleep)
+        self.assertEqual(new_sleep, 2.0 * curr_sleep)
+
+        uniform.assert_called_once_with(0.0, curr_sleep)
+        sleep.assert_called_once_with(uniform.return_value)
+
+    @mock.patch("random.uniform", return_value=10.5)
+    @mock.patch("time.sleep", return_value=None)
+    def test_explicit(self, sleep, uniform):
+        curr_sleep = 12.25
+        self.assertLessEqual(uniform.return_value, curr_sleep)
+
+        multiplier = 1.5
+        new_sleep = self._call_fut(curr_sleep, max_sleep=100.0, multiplier=multiplier)
+        self.assertEqual(new_sleep, multiplier * curr_sleep)
+
+        uniform.assert_called_once_with(0.0, curr_sleep)
+        sleep.assert_called_once_with(uniform.return_value)
+
+    @mock.patch("random.uniform", return_value=6.75)
+    @mock.patch("time.sleep", return_value=None)
+    def test_exceeds_max(self, sleep, uniform):
+        curr_sleep = 20.0
+        self.assertLessEqual(uniform.return_value, curr_sleep)
+
+        max_sleep = 38.5
+        new_sleep = self._call_fut(curr_sleep, max_sleep=max_sleep, multiplier=2.0)
+        self.assertEqual(new_sleep, max_sleep)
+
+        uniform.assert_called_once_with(0.0, curr_sleep)
+        sleep.assert_called_once_with(uniform.return_value)
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_client(project="feral-tom-cat"):
+    from google.cloud.firestore_v1beta1.client import Client
+
+    credentials = _make_credentials()
+
+    with pytest.deprecated_call():
+        return Client(project=project, credentials=credentials)
+
+
+def _make_transaction(txn_id, **txn_kwargs):
+    from google.protobuf import empty_pb2
+    from google.cloud.firestore_v1beta1.gapic import firestore_client
+    from google.cloud.firestore_v1beta1.proto import firestore_pb2
+    from google.cloud.firestore_v1beta1.proto import write_pb2
+    from google.cloud.firestore_v1beta1.transaction import Transaction
+
+    # Create a fake GAPIC ...
+    firestore_api = mock.create_autospec(
+        firestore_client.FirestoreClient, instance=True
+    )
+    # ... with a dummy ``BeginTransactionResponse`` result ...
+    begin_response = firestore_pb2.BeginTransactionResponse(transaction=txn_id)
+    firestore_api.begin_transaction.return_value = begin_response
+    # ... and a dummy ``Rollback`` result ...
+    firestore_api.rollback.return_value = empty_pb2.Empty()
+    # ... and a dummy ``Commit`` result.
+    commit_response = firestore_pb2.CommitResponse(
+        write_results=[write_pb2.WriteResult()]
+    )
+    firestore_api.commit.return_value = commit_response
+
+    # Attach the fake GAPIC to a real client.
+    client = _make_client()
+    client._firestore_api_internal = firestore_api
+
+    return Transaction(client, **txn_kwargs)
diff --git a/firestore/tests/unit/v1beta1/test_transforms.py b/firestore/tests/unit/v1beta1/test_transforms.py
new file mode 100644
index 000000000000..0f549ae07565
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_transforms.py
@@ -0,0 +1,65 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+
+class Test_ValueList(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.firestore_v1beta1.transforms import _ValueList
+
+        return _ValueList
+
+    def _make_one(self, values):
+        return self._get_target_class()(values)
+
+    def test_ctor_w_non_list_non_tuple(self):
+        invalid_values = (None, u"phred", b"DEADBEEF", 123, {}, object())
+        for invalid_value in invalid_values:
+            with self.assertRaises(ValueError):
+                self._make_one(invalid_value)
+
+    def test_ctor_w_empty(self):
+        with self.assertRaises(ValueError):
+            self._make_one([])
+
+    def test_ctor_w_non_empty_list(self):
+        values = ["phred", "bharney"]
+        inst = self._make_one(values)
+        self.assertEqual(inst.values, values)
+
+    def test_ctor_w_non_empty_tuple(self):
+        values = ("phred", "bharney")
+        inst = self._make_one(values)
+        self.assertEqual(inst.values, list(values))
+
+    def test___eq___other_type(self):
+        values = ("phred", "bharney")
+        inst = self._make_one(values)
+        other = object()
+        self.assertFalse(inst == other)
+
+    def test___eq___different_values(self):
+        values = ("phred", "bharney")
+        other_values = ("wylma", "bhetty")
+        inst = self._make_one(values)
+        other = self._make_one(other_values)
+        self.assertFalse(inst == other)
+
+    def test___eq___same_values(self):
+        values = ("phred", "bharney")
+        inst = self._make_one(values)
+        other = self._make_one(values)
+        self.assertTrue(inst == other)
diff --git a/firestore/tests/unit/v1beta1/test_watch.py b/firestore/tests/unit/v1beta1/test_watch.py
new file mode 100644
index 000000000000..6d8ba5a040bf
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/test_watch.py
@@ -0,0 +1,832 @@
+import datetime
+import unittest
+import mock
+from google.cloud.firestore_v1beta1.proto import firestore_pb2
+
+
+class TestWatchDocTree(unittest.TestCase):
+    def _makeOne(self):
+        from google.cloud.firestore_v1beta1.watch import WatchDocTree
+
+        return WatchDocTree()
+
+    def test_insert_and_keys(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        self.assertEqual(sorted(inst.keys()), ["a", "b"])
+
+    def test_remove_and_keys(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        inst = inst.remove("a")
+        self.assertEqual(sorted(inst.keys()), ["b"])
+
+    def test_insert_and_find(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        val = inst.find("a")
+        self.assertEqual(val.value, 2)
+
+    def test___len__(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        self.assertEqual(len(inst), 2)
+
+    def test___iter__(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        inst = inst.insert("a", 2)
+        self.assertEqual(sorted(list(inst)), ["a", "b"])
+
+    def test___contains__(self):
+        inst = self._makeOne()
+        inst = inst.insert("b", 1)
+        self.assertTrue("b" in inst)
+        self.assertFalse("a" in inst)
+
+
+class TestDocumentChange(unittest.TestCase):
+    def _makeOne(self, type, document, old_index, new_index):
+        from google.cloud.firestore_v1beta1.watch import DocumentChange
+
+        return DocumentChange(type, document, old_index, new_index)
+
+    def test_ctor(self):
+        inst = self._makeOne("type", "document", "old_index", "new_index")
+        self.assertEqual(inst.type, "type")
+        self.assertEqual(inst.document, "document")
+        self.assertEqual(inst.old_index, "old_index")
+        self.assertEqual(inst.new_index, "new_index")
+
+
+class TestWatchResult(unittest.TestCase):
+    def _makeOne(self, snapshot, name, change_type):
+        from google.cloud.firestore_v1beta1.watch import WatchResult
+
+        return WatchResult(snapshot, name, change_type)
+
+    def test_ctor(self):
+        inst = self._makeOne("snapshot", "name", "change_type")
+        self.assertEqual(inst.snapshot, "snapshot")
+        self.assertEqual(inst.name, "name")
+        self.assertEqual(inst.change_type, "change_type")
+
+
+class Test_maybe_wrap_exception(unittest.TestCase):
+    def _callFUT(self, exc):
+        from google.cloud.firestore_v1beta1.watch import _maybe_wrap_exception
+
+        return _maybe_wrap_exception(exc)
+
+    def test_is_grpc_error(self):
+        import grpc
+        from google.api_core.exceptions import GoogleAPICallError
+
+        exc = grpc.RpcError()
+        result = self._callFUT(exc)
+        self.assertEqual(result.__class__, GoogleAPICallError)
+
+    def test_is_not_grpc_error(self):
+        exc = ValueError()
+        result = self._callFUT(exc)
+        self.assertEqual(result.__class__, ValueError)
+
+
+class Test_document_watch_comparator(unittest.TestCase):
+    def _callFUT(self, doc1, doc2):
+        from google.cloud.firestore_v1beta1.watch import document_watch_comparator
+
+        return document_watch_comparator(doc1, doc2)
+
+    def test_same_doc(self):
+        result = self._callFUT(1, 1)
+        self.assertEqual(result, 0)
+
+    def test_diff_doc(self):
+        self.assertRaises(AssertionError, self._callFUT, 1, 2)
+
+
+class TestWatch(unittest.TestCase):
+    def _makeOne(
+        self,
+        document_reference=None,
+        firestore=None,
+        target=None,
+        comparator=None,
+        snapshot_callback=None,
+        snapshot_class=None,
+        reference_class=None,
+    ):  # pragma: NO COVER
+        from google.cloud.firestore_v1beta1.watch import Watch
+
+        if document_reference is None:
+            document_reference = DummyDocumentReference()
+        if firestore is None:
+            firestore = DummyFirestore()
+        if target is None:
+            WATCH_TARGET_ID = 0x5079  # "Py"
+            target = {"documents": {"documents": ["/"]}, "target_id": WATCH_TARGET_ID}
+        if comparator is None:
+            comparator = self._document_watch_comparator
+        if snapshot_callback is None:
+            snapshot_callback = self._snapshot_callback
+        if snapshot_class is None:
+            snapshot_class = DummyDocumentSnapshot
+        if reference_class is None:
+            reference_class = DummyDocumentReference
+        inst = Watch(
+            document_reference,
+            firestore,
+            target,
+            comparator,
+            snapshot_callback,
+            snapshot_class,
+            reference_class,
+            BackgroundConsumer=DummyBackgroundConsumer,
+            ResumableBidiRpc=DummyRpc,
+        )
+        return inst
+
+    def setUp(self):
+        self.snapshotted = None
+
+    def _document_watch_comparator(self, doc1, doc2):  # pragma: NO COVER
+        return 0
+
+    def _snapshot_callback(self, docs, changes, read_time):
+        self.snapshotted = (docs, changes, read_time)
+
+    def test_ctor(self):
+        inst = self._makeOne()
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+
+    def test__on_rpc_done(self):
+        inst = self._makeOne()
+        threading = DummyThreading()
+        with mock.patch("google.cloud.firestore_v1beta1.watch.threading", threading):
+            inst._on_rpc_done(True)
+        from google.cloud.firestore_v1beta1.watch import _RPC_ERROR_THREAD_NAME
+
+        self.assertTrue(threading.threads[_RPC_ERROR_THREAD_NAME].started)
+
+    def test_close(self):
+        inst = self._makeOne()
+        inst.close()
+        self.assertEqual(inst._consumer, None)
+        self.assertEqual(inst._rpc, None)
+        self.assertTrue(inst._closed)
+
+    def test_close_already_closed(self):
+        inst = self._makeOne()
+        inst._closed = True
+        old_consumer = inst._consumer
+        inst.close()
+        self.assertEqual(inst._consumer, old_consumer)
+
+    def test_close_inactive(self):
+        inst = self._makeOne()
+        old_consumer = inst._consumer
+        old_consumer.is_active = False
+        inst.close()
+        self.assertEqual(old_consumer.stopped, False)
+
+    def test_unsubscribe(self):
+        inst = self._makeOne()
+        inst.unsubscribe()
+        self.assertTrue(inst._rpc is None)
+
+    def test_for_document(self):
+        from google.cloud.firestore_v1beta1.watch import Watch
+
+        docref = DummyDocumentReference()
+        snapshot_callback = self._snapshot_callback
+        snapshot_class_instance = DummyDocumentSnapshot
+        document_reference_class_instance = DummyDocumentReference
+        modulename = "google.cloud.firestore_v1beta1.watch"
+        with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+            with mock.patch(
+                "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+            ):
+                inst = Watch.for_document(
+                    docref,
+                    snapshot_callback,
+                    snapshot_class_instance,
+                    document_reference_class_instance,
+                )
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+
+    def test_for_query(self):
+        from google.cloud.firestore_v1beta1.watch import Watch
+
+        snapshot_callback = self._snapshot_callback
+        snapshot_class_instance = DummyDocumentSnapshot
+        document_reference_class_instance = DummyDocumentReference
+        modulename = "google.cloud.firestore_v1beta1.watch"
+        pb2 = DummyPb2()
+        with mock.patch("%s.firestore_pb2" % modulename, pb2):
+            with mock.patch("%s.Watch.ResumableBidiRpc" % modulename, DummyRpc):
+                with mock.patch(
+                    "%s.Watch.BackgroundConsumer" % modulename, DummyBackgroundConsumer
+                ):
+                    query = DummyQuery()
+                    inst = Watch.for_query(
+                        query,
+                        snapshot_callback,
+                        snapshot_class_instance,
+                        document_reference_class_instance,
+                    )
+        self.assertTrue(inst._consumer.started)
+        self.assertTrue(inst._rpc.callbacks, [inst._on_rpc_done])
+        self.assertEqual(inst._targets["query"], "dummy query target")
+
+    def test_on_snapshot_target_no_change_no_target_ids_not_current(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        inst.on_snapshot(proto)  # nothing to assert, no mutations, no rtnval
+
+    def test_on_snapshot_target_no_change_no_target_ids_current(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change.read_time = 1
+        inst.current = True
+
+        def push(read_time, next_resume_token):
+            inst._read_time = read_time
+            inst._next_resume_token = next_resume_token
+
+        inst.push = push
+        inst.on_snapshot(proto)
+        self.assertEqual(inst._read_time, 1)
+        self.assertEqual(inst._next_resume_token, None)
+
+    def test_on_snapshot_target_add(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change.target_change_type = firestore_pb2.TargetChange.ADD
+        proto.target_change.target_ids = [1]  # not "Py"
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertEqual(str(exc.exception), "Unexpected target ID 1 sent by server")
+
+    def test_on_snapshot_target_remove(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.target_change_type = firestore_pb2.TargetChange.REMOVE
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertEqual(str(exc.exception), "Error 1:  hi")
+
+    def test_on_snapshot_target_remove_nocause(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.cause = None
+        target_change.target_change_type = firestore_pb2.TargetChange.REMOVE
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertEqual(str(exc.exception), "Error 13:  internal error")
+
+    def test_on_snapshot_target_reset(self):
+        inst = self._makeOne()
+
+        def reset():
+            inst._docs_reset = True
+
+        inst._reset_docs = reset
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.target_change_type = firestore_pb2.TargetChange.RESET
+        inst.on_snapshot(proto)
+        self.assertTrue(inst._docs_reset)
+
+    def test_on_snapshot_target_current(self):
+        inst = self._makeOne()
+        inst.current = False
+        proto = DummyProto()
+        target_change = proto.target_change
+        target_change.target_change_type = firestore_pb2.TargetChange.CURRENT
+        inst.on_snapshot(proto)
+        self.assertTrue(inst.current)
+
+    def test_on_snapshot_target_unknown(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change.target_change_type = "unknown"
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertTrue(inst._consumer is None)
+        self.assertTrue(inst._rpc is None)
+        self.assertEqual(str(exc.exception), "Unknown target change type: unknown ")
+
+    def test_on_snapshot_document_change_removed(self):
+        from google.cloud.firestore_v1beta1.watch import WATCH_TARGET_ID, ChangeType
+
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.removed_target_ids = [WATCH_TARGET_ID]
+
+        class DummyDocument:
+            name = "fred"
+
+        proto.document_change.document = DummyDocument()
+        inst.on_snapshot(proto)
+        self.assertTrue(inst.change_map["fred"] is ChangeType.REMOVED)
+
+    def test_on_snapshot_document_change_changed(self):
+        from google.cloud.firestore_v1beta1.watch import WATCH_TARGET_ID
+
+        inst = self._makeOne()
+
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.target_ids = [WATCH_TARGET_ID]
+
+        class DummyDocument:
+            name = "fred"
+            fields = {}
+            create_time = None
+            update_time = None
+
+        proto.document_change.document = DummyDocument()
+        inst.on_snapshot(proto)
+        self.assertEqual(inst.change_map["fred"].data, {})
+
+    def test_on_snapshot_document_change_changed_docname_db_prefix(self):
+        # TODO: Verify the current behavior. The change map currently contains
+        # the db-prefixed document name and not the bare document name.
+        from google.cloud.firestore_v1beta1.watch import WATCH_TARGET_ID
+
+        inst = self._makeOne()
+
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.target_ids = [WATCH_TARGET_ID]
+
+        class DummyDocument:
+            name = "abc://foo/documents/fred"
+            fields = {}
+            create_time = None
+            update_time = None
+
+        proto.document_change.document = DummyDocument()
+        inst._firestore._database_string = "abc://foo"
+        inst.on_snapshot(proto)
+        self.assertEqual(inst.change_map["abc://foo/documents/fred"].data, {})
+
+    def test_on_snapshot_document_change_neither_changed_nor_removed(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change.target_ids = []
+
+        inst.on_snapshot(proto)
+        self.assertTrue(not inst.change_map)
+
+    def test_on_snapshot_document_removed(self):
+        from google.cloud.firestore_v1beta1.watch import ChangeType
+
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+
+        class DummyRemove(object):
+            document = "fred"
+
+        remove = DummyRemove()
+        proto.document_remove = remove
+        proto.document_delete = ""
+        inst.on_snapshot(proto)
+        self.assertTrue(inst.change_map["fred"] is ChangeType.REMOVED)
+
+    def test_on_snapshot_filter_update(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+        proto.document_remove = ""
+        proto.document_delete = ""
+
+        class DummyFilter(object):
+            count = 999
+
+        proto.filter = DummyFilter()
+
+        def reset():
+            inst._docs_reset = True
+
+        inst._reset_docs = reset
+        inst.on_snapshot(proto)
+        self.assertTrue(inst._docs_reset)
+
+    def test_on_snapshot_filter_update_no_size_change(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+        proto.document_remove = ""
+        proto.document_delete = ""
+
+        class DummyFilter(object):
+            count = 0
+
+        proto.filter = DummyFilter()
+        inst._docs_reset = False
+
+        inst.on_snapshot(proto)
+        self.assertFalse(inst._docs_reset)
+
+    def test_on_snapshot_unknown_listen_type(self):
+        inst = self._makeOne()
+        proto = DummyProto()
+        proto.target_change = ""
+        proto.document_change = ""
+        proto.document_remove = ""
+        proto.document_delete = ""
+        proto.filter = ""
+        with self.assertRaises(Exception) as exc:
+            inst.on_snapshot(proto)
+        self.assertTrue(
+            str(exc.exception).startswith("Unknown listen response type"),
+            str(exc.exception),
+        )
+
+    def test_push_callback_called_no_changes(self):
+        import pytz
+
+        class DummyReadTime(object):
+            seconds = 1534858278
+
+        inst = self._makeOne()
+        inst.push(DummyReadTime, "token")
+        self.assertEqual(
+            self.snapshotted,
+            ([], [], datetime.datetime.fromtimestamp(DummyReadTime.seconds, pytz.utc)),
+        )
+        self.assertTrue(inst.has_pushed)
+        self.assertEqual(inst.resume_token, "token")
+
+    def test_push_already_pushed(self):
+        class DummyReadTime(object):
+            seconds = 1534858278
+
+        inst = self._makeOne()
+        inst.has_pushed = True
+        inst.push(DummyReadTime, "token")
+        self.assertEqual(self.snapshotted, None)
+        self.assertTrue(inst.has_pushed)
+        self.assertEqual(inst.resume_token, "token")
+
+    def test__current_size_empty(self):
+        inst = self._makeOne()
+        result = inst._current_size()
+        self.assertEqual(result, 0)
+
+    def test__current_size_docmap_has_one(self):
+        inst = self._makeOne()
+        inst.doc_map["a"] = 1
+        result = inst._current_size()
+        self.assertEqual(result, 1)
+
+    def test__affects_target_target_id_None(self):
+        inst = self._makeOne()
+        self.assertTrue(inst._affects_target(None, []))
+
+    def test__affects_target_current_id_in_target_ids(self):
+        inst = self._makeOne()
+        self.assertTrue(inst._affects_target([1], 1))
+
+    def test__affects_target_current_id_not_in_target_ids(self):
+        inst = self._makeOne()
+        self.assertFalse(inst._affects_target([1], 2))
+
+    def test__extract_changes_doc_removed(self):
+        from google.cloud.firestore_v1beta1.watch import ChangeType
+
+        inst = self._makeOne()
+        changes = {"name": ChangeType.REMOVED}
+        doc_map = {"name": True}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, (["name"], [], []))
+
+    def test__extract_changes_doc_removed_docname_not_in_docmap(self):
+        from google.cloud.firestore_v1beta1.watch import ChangeType
+
+        inst = self._makeOne()
+        changes = {"name": ChangeType.REMOVED}
+        doc_map = {}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, ([], [], []))
+
+    def test__extract_changes_doc_updated(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        doc = Dummy()
+        snapshot = Dummy()
+        changes = {"name": snapshot}
+        doc_map = {"name": doc}
+        results = inst._extract_changes(doc_map, changes, 1)
+        self.assertEqual(results, ([], [], [snapshot]))
+        self.assertEqual(snapshot.read_time, 1)
+
+    def test__extract_changes_doc_updated_read_time_is_None(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        doc = Dummy()
+        snapshot = Dummy()
+        snapshot.read_time = None
+        changes = {"name": snapshot}
+        doc_map = {"name": doc}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, ([], [], [snapshot]))
+        self.assertEqual(snapshot.read_time, None)
+
+    def test__extract_changes_doc_added(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        snapshot = Dummy()
+        changes = {"name": snapshot}
+        doc_map = {}
+        results = inst._extract_changes(doc_map, changes, 1)
+        self.assertEqual(results, ([], [snapshot], []))
+        self.assertEqual(snapshot.read_time, 1)
+
+    def test__extract_changes_doc_added_read_time_is_None(self):
+        inst = self._makeOne()
+
+        class Dummy(object):
+            pass
+
+        snapshot = Dummy()
+        snapshot.read_time = None
+        changes = {"name": snapshot}
+        doc_map = {}
+        results = inst._extract_changes(doc_map, changes, None)
+        self.assertEqual(results, ([], [snapshot], []))
+        self.assertEqual(snapshot.read_time, None)
+
+    def test__compute_snapshot_doctree_and_docmap_disagree_about_length(self):
+        inst = self._makeOne()
+        doc_tree = {}
+        doc_map = {None: None}
+        self.assertRaises(
+            AssertionError, inst._compute_snapshot, doc_tree, doc_map, None, None, None
+        )
+
+    def test__compute_snapshot_operation_relative_ordering(self):
+        from google.cloud.firestore_v1beta1.watch import WatchDocTree
+
+        doc_tree = WatchDocTree()
+
+        class DummyDoc(object):
+            update_time = mock.sentinel
+
+        deleted_doc = DummyDoc()
+        added_doc = DummyDoc()
+        added_doc._document_path = "/added"
+        updated_doc = DummyDoc()
+        updated_doc._document_path = "/updated"
+        doc_tree = doc_tree.insert(deleted_doc, None)
+        doc_tree = doc_tree.insert(updated_doc, None)
+        doc_map = {"/deleted": deleted_doc, "/updated": updated_doc}
+        added_snapshot = DummyDocumentSnapshot(added_doc, None, True, None, None, None)
+        added_snapshot.reference = added_doc
+        updated_snapshot = DummyDocumentSnapshot(
+            updated_doc, None, True, None, None, None
+        )
+        updated_snapshot.reference = updated_doc
+        delete_changes = ["/deleted"]
+        add_changes = [added_snapshot]
+        update_changes = [updated_snapshot]
+        inst = self._makeOne()
+        updated_tree, updated_map, applied_changes = inst._compute_snapshot(
+            doc_tree, doc_map, delete_changes, add_changes, update_changes
+        )
+        # TODO: Verify that the assertion here is correct.
+        self.assertEqual(
+            updated_map, {"/updated": updated_snapshot, "/added": added_snapshot}
+        )
+
+    def test__compute_snapshot_modify_docs_updated_doc_no_timechange(self):
+        from google.cloud.firestore_v1beta1.watch import WatchDocTree
+
+        doc_tree = WatchDocTree()
+
+        class DummyDoc(object):
+            pass
+
+        updated_doc_v1 = DummyDoc()
+        updated_doc_v1.update_time = 1
+        updated_doc_v1._document_path = "/updated"
+        updated_doc_v2 = DummyDoc()
+        updated_doc_v2.update_time = 1
+        updated_doc_v2._document_path = "/updated"
+        doc_tree = doc_tree.insert("/updated", updated_doc_v1)
+        doc_map = {"/updated": updated_doc_v1}
+        updated_snapshot = DummyDocumentSnapshot(
+            updated_doc_v2, None, True, None, None, 1
+        )
+        delete_changes = []
+        add_changes = []
+        update_changes = [updated_snapshot]
+        inst = self._makeOne()
+        updated_tree, updated_map, applied_changes = inst._compute_snapshot(
+            doc_tree, doc_map, delete_changes, add_changes, update_changes
+        )
+        self.assertEqual(updated_map, doc_map)  # no change
+
+    def test__reset_docs(self):
+        from google.cloud.firestore_v1beta1.watch import ChangeType
+
+        inst = self._makeOne()
+        inst.change_map = {None: None}
+        from google.cloud.firestore_v1beta1.watch import WatchDocTree
+
+        doc = DummyDocumentReference("doc")
+        doc_tree = WatchDocTree()
+        snapshot = DummyDocumentSnapshot(doc, None, True, None, None, None)
+        snapshot.reference = doc
+        doc_tree = doc_tree.insert(snapshot, None)
+        inst.doc_tree = doc_tree
+        inst._reset_docs()
+        self.assertEqual(inst.change_map, {"/doc": ChangeType.REMOVED})
+        self.assertEqual(inst.resume_token, None)
+        self.assertFalse(inst.current)
+
+
+class DummyFirestoreStub(object):
+    def Listen(self):  # pragma: NO COVER
+        pass
+
+
+class DummyFirestoreClient(object):
+    def __init__(self):
+        self.transport = mock.Mock(_stubs={"firestore_stub": DummyFirestoreStub()})
+
+
+class DummyDocumentReference(object):
+    def __init__(self, *document_path, **kw):
+        if "client" not in kw:
+            self._client = DummyFirestore()
+        else:
+            self._client = kw["client"]
+
+        self._path = document_path
+        self._document_path = "/" + "/".join(document_path)
+        self.__dict__.update(kw)
+
+
+class DummyQuery(object):  # pragma: NO COVER
+    def __init__(self, **kw):
+        if "client" not in kw:
+            self._client = DummyFirestore()
+        else:
+            self._client = kw["client"]
+
+        if "comparator" not in kw:
+            # don't really do the comparison, just return 0 (equal) for all
+            self._comparator = lambda x, y: 1
+        else:
+            self._comparator = kw["comparator"]
+
+    def _to_protobuf(self):
+        return ""
+
+
+class DummyFirestore(object):
+    _firestore_api = DummyFirestoreClient()
+    _database_string = "abc://bar/"
+    _rpc_metadata = None
+
+    def document(self, *document_path):  # pragma: NO COVER
+        if len(document_path) == 1:
+            path = document_path[0].split("/")
+        else:
+            path = document_path
+
+        return DummyDocumentReference(*path, client=self)
+
+
+class DummyDocumentSnapshot(object):
+    # def __init__(self, **kw):
+    #     self.__dict__.update(kw)
+    def __init__(self, reference, data, exists, read_time, create_time, update_time):
+        self.reference = reference
+        self.data = data
+        self.exists = exists
+        self.read_time = read_time
+        self.create_time = create_time
+        self.update_time = update_time
+
+    def __str__(self):
+        return "%s-%s" % (self.reference._document_path, self.read_time)
+
+    def __hash__(self):
+        return hash(str(self))
+
+
+class DummyBackgroundConsumer(object):
+    started = False
+    stopped = False
+    is_active = True
+
+    def __init__(self, rpc, on_snapshot):
+        self._rpc = rpc
+        self.on_snapshot = on_snapshot
+
+    def start(self):
+        self.started = True
+
+    def stop(self):
+        self.stopped = True
+        self.is_active = False
+
+
+class DummyThread(object):
+    started = False
+
+    def __init__(self, name, target, kwargs):
+        self.name = name
+        self.target = target
+        self.kwargs = kwargs
+
+    def start(self):
+        self.started = True
+
+
+class DummyThreading(object):
+    def __init__(self):
+        self.threads = {}
+
+    def Thread(self, name, target, kwargs):
+        thread = DummyThread(name, target, kwargs)
+        self.threads[name] = thread
+        return thread
+
+
+class DummyRpc(object):
+    def __init__(self, listen, initial_request, should_recover, metadata=None):
+        self.listen = listen
+        self.initial_request = initial_request
+        self.should_recover = should_recover
+        self.closed = False
+        self.callbacks = []
+        self._metadata = metadata
+
+    def add_done_callback(self, callback):
+        self.callbacks.append(callback)
+
+    def close(self):
+        self.closed = True
+
+
+class DummyCause(object):
+    code = 1
+    message = "hi"
+
+
+class DummyChange(object):
+    def __init__(self):
+        self.target_ids = []
+        self.removed_target_ids = []
+        self.read_time = 0
+        self.target_change_type = firestore_pb2.TargetChange.NO_CHANGE
+        self.resume_token = None
+        self.cause = DummyCause()
+
+
+class DummyProto(object):
+    def __init__(self):
+        self.target_change = DummyChange()
+        self.document_change = DummyChange()
+
+
+class DummyTarget(object):
+    def QueryTarget(self, **kw):
+        self.kw = kw
+        return "dummy query target"
+
+
+class DummyPb2(object):
+
+    Target = DummyTarget()
+
+    def ListenRequest(self, **kw):
+        pass
diff --git a/firestore/tests/unit/v1beta1/testdata/create-all-transforms.textproto b/firestore/tests/unit/v1beta1/testdata/create-all-transforms.textproto
new file mode 100644
index 000000000000..bbdf19e4df4a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-all-transforms.textproto
@@ -0,0 +1,64 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can be created with any amount of transforms.
+
+description: "create: all transforms in a single call"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": [\"ArrayUnion\", 1, 2, 3], \"d\": [\"ArrayRemove\", 4, 5, 6]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayremove-multi.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-multi.textproto
new file mode 100644
index 000000000000..f80d65b2381a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-multi.textproto
@@ -0,0 +1,61 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayRemove field. Since all the ArrayRemove
+# fields are removed, the only field in the update is "a".
+
+description: "create: multiple ArrayRemove fields"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3], \"c\": {\"d\": [\"ArrayRemove\", 4, 5, 6]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayremove-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-nested.textproto
new file mode 100644
index 000000000000..97756c306c18
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-nested.textproto
@@ -0,0 +1,48 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayRemove value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "create: nested ArrayRemove field"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": [\"ArrayRemove\", 1, 2, 3]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayremove-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-noarray-nested.textproto
new file mode 100644
index 000000000000..4ec0cb3b9376
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayRemove. Firestore transforms don't support array indexing.
+
+description: "create: ArrayRemove cannot be anywhere inside an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayremove-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-noarray.textproto
new file mode 100644
index 000000000000..969b8d9dd84e
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayRemove must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "create: ArrayRemove cannot be in an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayremove-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-with-st.textproto
new file mode 100644
index 000000000000..b6ea3224de73
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayremove-with-st.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "create: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayRemove\", 1, \"ServerTimestamp\", 3]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayremove.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayremove.textproto
new file mode 100644
index 000000000000..e8e4bb3980db
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayremove.textproto
@@ -0,0 +1,47 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayRemove is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "create: ArrayRemove with data"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayunion-multi.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-multi.textproto
new file mode 100644
index 000000000000..ec3cb72f5b1b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-multi.textproto
@@ -0,0 +1,61 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayUnion field. Since all the ArrayUnion
+# fields are removed, the only field in the update is "a".
+
+description: "create: multiple ArrayUnion fields"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3], \"c\": {\"d\": [\"ArrayUnion\", 4, 5, 6]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          append_missing_elements: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayunion-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-nested.textproto
new file mode 100644
index 000000000000..e6e81bc1d7a2
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-nested.textproto
@@ -0,0 +1,48 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayUnion value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "create: nested ArrayUnion field"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": [\"ArrayUnion\", 1, 2, 3]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayunion-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-noarray-nested.textproto
new file mode 100644
index 000000000000..4c0afe443048
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayUnion. Firestore transforms don't support array indexing.
+
+description: "create: ArrayUnion cannot be anywhere inside an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayunion-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-noarray.textproto
new file mode 100644
index 000000000000..7b791fa4154d
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayUnion must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "create: ArrayUnion cannot be in an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayunion-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-with-st.textproto
new file mode 100644
index 000000000000..a1bf4a90d1c4
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayunion-with-st.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "create: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayUnion\", 1, \"ServerTimestamp\", 3]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-arrayunion.textproto b/firestore/tests/unit/v1beta1/testdata/create-arrayunion.textproto
new file mode 100644
index 000000000000..98cb6ad8acb1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-arrayunion.textproto
@@ -0,0 +1,47 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayUnion is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "create: ArrayUnion with data"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-basic.textproto b/firestore/tests/unit/v1beta1/testdata/create-basic.textproto
new file mode 100644
index 000000000000..433ffda72704
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-basic.textproto
@@ -0,0 +1,27 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A simple call, resulting in a single update operation.
+
+description: "create: basic"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-complex.textproto b/firestore/tests/unit/v1beta1/testdata/create-complex.textproto
new file mode 100644
index 000000000000..00a994e204a2
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-complex.textproto
@@ -0,0 +1,61 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A call to a write method with complicated input data.
+
+description: "create: complex"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2.5], \"b\": {\"c\": [\"three\", {\"d\": true}]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            array_value: <
+              values: <
+                integer_value: 1
+              >
+              values: <
+                double_value: 2.5
+              >
+            >
+          >
+        >
+        fields: <
+          key: "b"
+          value: <
+            map_value: <
+              fields: <
+                key: "c"
+                value: <
+                  array_value: <
+                    values: <
+                      string_value: "three"
+                    >
+                    values: <
+                      map_value: <
+                        fields: <
+                          key: "d"
+                          value: <
+                            boolean_value: true
+                          >
+                        >
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-del-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-del-noarray-nested.textproto
new file mode 100644
index 000000000000..60694e137163
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-del-noarray-nested.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "create: Delete cannot be anywhere inside an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": \"Delete\"}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-del-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/create-del-noarray.textproto
new file mode 100644
index 000000000000..5731be1c7357
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-del-noarray.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "create: Delete cannot be in an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, \"Delete\"]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-empty.textproto b/firestore/tests/unit/v1beta1/testdata/create-empty.textproto
new file mode 100644
index 000000000000..2b6fec7efafd
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-empty.textproto
@@ -0,0 +1,20 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+
+description: "create: creating or setting an empty map"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+      current_document: <
+        exists: false
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-nodel.textproto b/firestore/tests/unit/v1beta1/testdata/create-nodel.textproto
new file mode 100644
index 000000000000..c878814b1128
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-nodel.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel cannot be used in Create, or in Set without a Merge option.
+
+description: "create: Delete cannot appear in data"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"Delete\"}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-nosplit.textproto b/firestore/tests/unit/v1beta1/testdata/create-nosplit.textproto
new file mode 100644
index 000000000000..e9e1ee2755f5
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-nosplit.textproto
@@ -0,0 +1,40 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Create and Set treat their map keys literally. They do not split on dots.
+
+description: "create: don\342\200\231t split on dots"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{ \"a.b\": { \"c.d\": 1 }, \"e\": 2 }"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a.b"
+          value: <
+            map_value: <
+              fields: <
+                key: "c.d"
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+        fields: <
+          key: "e"
+          value: <
+            integer_value: 2
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-special-chars.textproto b/firestore/tests/unit/v1beta1/testdata/create-special-chars.textproto
new file mode 100644
index 000000000000..3a7acd3075de
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-special-chars.textproto
@@ -0,0 +1,41 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Create and Set treat their map keys literally. They do not escape special
+# characters.
+
+description: "create: non-alpha characters in map keys"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{ \"*\": { \".\": 1 }, \"~\": 2 }"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "*"
+          value: <
+            map_value: <
+              fields: <
+                key: "."
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+        fields: <
+          key: "~"
+          value: <
+            integer_value: 2
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st-alone.textproto b/firestore/tests/unit/v1beta1/testdata/create-st-alone.textproto
new file mode 100644
index 000000000000..9803a676bbe0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st-alone.textproto
@@ -0,0 +1,26 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ServerTimestamps, then no update operation
+# should be produced.
+
+description: "create: ServerTimestamp alone"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st-multi.textproto b/firestore/tests/unit/v1beta1/testdata/create-st-multi.textproto
new file mode 100644
index 000000000000..cb3db480999a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st-multi.textproto
@@ -0,0 +1,41 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ServerTimestamp field. Since all the
+# ServerTimestamp fields are removed, the only field in the update is "a".
+
+description: "create: multiple ServerTimestamp fields"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": {\"d\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c.d"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-st-nested.textproto
new file mode 100644
index 000000000000..6bc03e8e7ca0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st-nested.textproto
@@ -0,0 +1,38 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A ServerTimestamp value can occur at any depth. In this case, the transform
+# applies to the field path "b.c". Since "c" is removed from the update, "b"
+# becomes empty, so it is also removed from the update.
+
+description: "create: nested ServerTimestamp field"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/create-st-noarray-nested.textproto
new file mode 100644
index 000000000000..0cec0aebd4bf
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ServerTimestamp sentinel. Firestore transforms don't support array indexing.
+
+description: "create: ServerTimestamp cannot be anywhere inside an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": \"ServerTimestamp\"}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/create-st-noarray.textproto
new file mode 100644
index 000000000000..56d91c2cfb5a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. Firestore transforms
+# don't support array indexing.
+
+description: "create: ServerTimestamp cannot be in an array value"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, \"ServerTimestamp\"]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st-with-empty-map.textproto b/firestore/tests/unit/v1beta1/testdata/create-st-with-empty-map.textproto
new file mode 100644
index 000000000000..37e7e074abec
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st-with-empty-map.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When a ServerTimestamp and a map both reside inside a map, the ServerTimestamp
+# should be stripped out but the empty map should remain.
+
+description: "create: ServerTimestamp beside an empty map"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": {\"b\": {}, \"c\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  map_value: <
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/create-st.textproto b/firestore/tests/unit/v1beta1/testdata/create-st.textproto
new file mode 100644
index 000000000000..ddfc6a177e16
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/create-st.textproto
@@ -0,0 +1,39 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with the special ServerTimestamp sentinel is removed from the data in the
+# update operation. Instead it appears in a separate Transform operation. Note
+# that in these tests, the string "ServerTimestamp" should be replaced with the
+# special ServerTimestamp value.
+
+description: "create: ServerTimestamp with data"
+create: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      current_document: <
+        exists: false
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/delete-exists-precond.textproto b/firestore/tests/unit/v1beta1/testdata/delete-exists-precond.textproto
new file mode 100644
index 000000000000..c9cf2ddea4e6
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/delete-exists-precond.textproto
@@ -0,0 +1,21 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Delete supports an exists precondition.
+
+description: "delete: delete with exists precondition"
+delete: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  precondition: <
+    exists: true
+  >
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      delete: "projects/projectID/databases/(default)/documents/C/d"
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/delete-no-precond.textproto b/firestore/tests/unit/v1beta1/testdata/delete-no-precond.textproto
new file mode 100644
index 000000000000..a396cdb8c4a1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/delete-no-precond.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ordinary Delete call.
+
+description: "delete: delete without precondition"
+delete: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      delete: "projects/projectID/databases/(default)/documents/C/d"
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/delete-time-precond.textproto b/firestore/tests/unit/v1beta1/testdata/delete-time-precond.textproto
new file mode 100644
index 000000000000..5798f5f3b2fc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/delete-time-precond.textproto
@@ -0,0 +1,25 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Delete supports a last-update-time precondition.
+
+description: "delete: delete with last-update-time precondition"
+delete: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  precondition: <
+    update_time: <
+      seconds: 42
+    >
+  >
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      delete: "projects/projectID/databases/(default)/documents/C/d"
+      current_document: <
+        update_time: <
+          seconds: 42
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/get-basic.textproto b/firestore/tests/unit/v1beta1/testdata/get-basic.textproto
new file mode 100644
index 000000000000..2a448168255b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/get-basic.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A call to DocumentRef.Get.
+
+description: "get: get a document"
+get: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  request: <
+    name: "projects/projectID/databases/(default)/documents/C/d"
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-add-mod-del-add.textproto b/firestore/tests/unit/v1beta1/testdata/listen-add-mod-del-add.textproto
new file mode 100644
index 000000000000..1aa8dcbc3645
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-add-mod-del-add.textproto
@@ -0,0 +1,246 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Various changes to a single document.
+
+description: "listen: add a doc, modify it, delete it, then add it again"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  responses: <
+    document_delete: <
+      document: "projects/projectID/databases/(default)/documents/C/d1"
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 3
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 4
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 2
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 2
+      >
+    >
+    changes: <
+      kind: MODIFIED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+  snapshots: <
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      new_index: -1
+    >
+    read_time: <
+      seconds: 3
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 3
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 4
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-add-one.textproto b/firestore/tests/unit/v1beta1/testdata/listen-add-one.textproto
new file mode 100644
index 000000000000..2ad1d8e976da
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-add-one.textproto
@@ -0,0 +1,79 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Snapshot with a single document.
+
+description: "listen: add a doc"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-add-three.textproto b/firestore/tests/unit/v1beta1/testdata/listen-add-three.textproto
new file mode 100644
index 000000000000..ac846f76260d
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-add-three.textproto
@@ -0,0 +1,190 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A snapshot with three documents. The documents are sorted first by the "a"
+# field, then by their path. The changes are ordered the same way.
+
+description: "listen: add three documents"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d3"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 2
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-doc-remove.textproto b/firestore/tests/unit/v1beta1/testdata/listen-doc-remove.textproto
new file mode 100644
index 000000000000..975200f97363
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-doc-remove.textproto
@@ -0,0 +1,115 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The DocumentRemove response behaves exactly like DocumentDelete.
+
+description: "listen: DocumentRemove behaves like DocumentDelete"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_remove: <
+      document: "projects/projectID/databases/(default)/documents/C/d1"
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+  snapshots: <
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      new_index: -1
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-empty.textproto b/firestore/tests/unit/v1beta1/testdata/listen-empty.textproto
new file mode 100644
index 000000000000..4d04b79096c7
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-empty.textproto
@@ -0,0 +1,25 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There are no changes, so the snapshot should be empty.
+
+description: "listen: no changes; empty snapshot"
+listen: <
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  snapshots: <
+    read_time: <
+      seconds: 1
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-filter-nop.textproto b/firestore/tests/unit/v1beta1/testdata/listen-filter-nop.textproto
new file mode 100644
index 000000000000..48fd72d3ae12
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-filter-nop.textproto
@@ -0,0 +1,247 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Filter response whose count matches the size of the current state (docs in
+# last snapshot + docs added - docs deleted) is a no-op.
+
+description: "listen: Filter response with same size is a no-op"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_delete: <
+      document: "projects/projectID/databases/(default)/documents/C/d1"
+    >
+  >
+  responses: <
+    filter: <
+      count: 2
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d3"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: 1
+      new_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-multi-docs.textproto b/firestore/tests/unit/v1beta1/testdata/listen-multi-docs.textproto
new file mode 100644
index 000000000000..8778acc3d1e9
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-multi-docs.textproto
@@ -0,0 +1,524 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Changes should be ordered with deletes first, then additions, then mods, each in
+# query order. Old indices refer to the immediately previous state, not the
+# previous snapshot
+
+description: "listen: multiple documents, added, deleted and updated"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d4"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d5"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 4
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_delete: <
+      document: "projects/projectID/databases/(default)/documents/C/d3"
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: -1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d6"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_delete: <
+      document: "projects/projectID/databases/(default)/documents/C/d2"
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d4"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: -2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 4
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d3"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d4"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 2
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d4"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 2
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 3
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d4"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: -2
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 3
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: -1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 3
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d6"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d5"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 4
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      new_index: -1
+    >
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      new_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d6"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 2
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d5"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 4
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 3
+    >
+    changes: <
+      kind: MODIFIED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d4"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: -2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+    >
+    changes: <
+      kind: MODIFIED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: -1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      old_index: 1
+      new_index: 1
+    >
+    read_time: <
+      seconds: 4
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-nocurrent.textproto b/firestore/tests/unit/v1beta1/testdata/listen-nocurrent.textproto
new file mode 100644
index 000000000000..24239b6456f9
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-nocurrent.textproto
@@ -0,0 +1,141 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the watch state is not marked CURRENT, no snapshot is issued.
+
+description: "listen: no snapshot if we don't see CURRENT"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 2
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 2
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-nomod.textproto b/firestore/tests/unit/v1beta1/testdata/listen-nomod.textproto
new file mode 100644
index 000000000000..2a99edc350c8
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-nomod.textproto
@@ -0,0 +1,143 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Document updates are recognized by a change in the update time, not the data.
+# This shouldn't actually happen. It is just a test of the update logic.
+
+description: "listen: add a doc, then change it but without changing its update time"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  responses: <
+    document_delete: <
+      document: "projects/projectID/databases/(default)/documents/C/d1"
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 3
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+  snapshots: <
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      new_index: -1
+    >
+    read_time: <
+      seconds: 3
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-removed-target-ids.textproto b/firestore/tests/unit/v1beta1/testdata/listen-removed-target-ids.textproto
new file mode 100644
index 000000000000..1e8ead2d8048
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-removed-target-ids.textproto
@@ -0,0 +1,131 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A DocumentChange with the watch target ID in the removed_target_ids field is the
+# same as deleting a document.
+
+description: "listen: DocumentChange with removed_target_id is like a delete."
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      removed_target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+  snapshots: <
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      new_index: -1
+    >
+    read_time: <
+      seconds: 2
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-reset.textproto b/firestore/tests/unit/v1beta1/testdata/listen-reset.textproto
new file mode 100644
index 000000000000..89a75df2783a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-reset.textproto
@@ -0,0 +1,382 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A RESET message turns off the CURRENT state, and marks all documents as deleted.
+
+# If a document appeared on the stream but was never part of a snapshot ("d3" in
+# this test), a reset will make it disappear completely.
+
+# For a snapshot to happen at a NO_CHANGE reponse, we need to have both seen a
+# CURRENT response, and have a change from the previous snapshot. Here, after the
+# reset, we see the same version of d2 again. That doesn't result in a snapshot.
+
+description: "listen: RESET turns off CURRENT"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: RESET
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 3
+      >
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: RESET
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 4
+      >
+    >
+  >
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 5
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 1
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 2
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 2
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      old_index: -1
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 3
+      >
+    >
+    changes: <
+      kind: REMOVED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 2
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: 1
+      new_index: -1
+    >
+    changes: <
+      kind: MODIFIED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d2"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 3
+        >
+      >
+    >
+    read_time: <
+      seconds: 3
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d2"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 3
+      >
+    >
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d3"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 2
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d3"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 2
+        >
+      >
+      old_index: -1
+      new_index: 1
+    >
+    read_time: <
+      seconds: 5
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-target-add-nop.textproto b/firestore/tests/unit/v1beta1/testdata/listen-target-add-nop.textproto
new file mode 100644
index 000000000000..3fa7cce56e27
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-target-add-nop.textproto
@@ -0,0 +1,88 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A TargetChange_ADD response must have the same watch target ID.
+
+description: "listen: TargetChange_ADD is a no-op if it has the same target ID"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: ADD
+      target_ids: 1
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  snapshots: <
+    docs: <
+      name: "projects/projectID/databases/(default)/documents/C/d1"
+      fields: <
+        key: "a"
+        value: <
+          integer_value: 3
+        >
+      >
+      create_time: <
+        seconds: 1
+      >
+      update_time: <
+        seconds: 1
+      >
+    >
+    changes: <
+      kind: ADDED
+      doc: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      old_index: -1
+    >
+    read_time: <
+      seconds: 1
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-target-add-wrong-id.textproto b/firestore/tests/unit/v1beta1/testdata/listen-target-add-wrong-id.textproto
new file mode 100644
index 000000000000..87544637b50b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-target-add-wrong-id.textproto
@@ -0,0 +1,50 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A TargetChange_ADD response must have the same watch target ID.
+
+description: "listen: TargetChange_ADD is an error if it has a different target ID"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: ADD
+      target_ids: 2
+      read_time: <
+        seconds: 2
+      >
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/listen-target-remove.textproto b/firestore/tests/unit/v1beta1/testdata/listen-target-remove.textproto
new file mode 100644
index 000000000000..f34b0890c3f0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/listen-target-remove.textproto
@@ -0,0 +1,46 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A TargetChange_REMOVE response should never be sent.
+
+description: "listen: TargetChange_REMOVE should not appear"
+listen: <
+  responses: <
+    document_change: <
+      document: <
+        name: "projects/projectID/databases/(default)/documents/C/d1"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 3
+          >
+        >
+        create_time: <
+          seconds: 1
+        >
+        update_time: <
+          seconds: 1
+        >
+      >
+      target_ids: 1
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: CURRENT
+    >
+  >
+  responses: <
+    target_change: <
+      target_change_type: REMOVE
+    >
+  >
+  responses: <
+    target_change: <
+      read_time: <
+        seconds: 1
+      >
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-arrayremove-cursor.textproto b/firestore/tests/unit/v1beta1/testdata/query-arrayremove-cursor.textproto
new file mode 100644
index 000000000000..3c926da963e6
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-arrayremove-cursor.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayRemove is not permitted in queries.
+
+description: "query: ArrayRemove in cursor method"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "[\"ArrayRemove\", 1, 2, 3]"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-arrayremove-where.textproto b/firestore/tests/unit/v1beta1/testdata/query-arrayremove-where.textproto
new file mode 100644
index 000000000000..000b76350e01
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-arrayremove-where.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayRemove is not permitted in queries.
+
+description: "query: ArrayRemove in Where"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "[\"ArrayRemove\", 1, 2, 3]"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-arrayunion-cursor.textproto b/firestore/tests/unit/v1beta1/testdata/query-arrayunion-cursor.textproto
new file mode 100644
index 000000000000..e8a61104d1b3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-arrayunion-cursor.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayUnion is not permitted in queries.
+
+description: "query: ArrayUnion in cursor method"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "[\"ArrayUnion\", 1, 2, 3]"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-arrayunion-where.textproto b/firestore/tests/unit/v1beta1/testdata/query-arrayunion-where.textproto
new file mode 100644
index 000000000000..94923134e2b1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-arrayunion-where.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayUnion is not permitted in queries.
+
+description: "query: ArrayUnion in Where"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "[\"ArrayUnion\", 1, 2, 3]"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-bad-NaN.textproto b/firestore/tests/unit/v1beta1/testdata/query-bad-NaN.textproto
new file mode 100644
index 000000000000..6806dd04ab27
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-bad-NaN.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# You can only compare NaN for equality.
+
+description: "query: where clause with non-== comparison with NaN"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "<"
+      json_value: "\"NaN\""
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-bad-null.textproto b/firestore/tests/unit/v1beta1/testdata/query-bad-null.textproto
new file mode 100644
index 000000000000..7fdfb3f2b5dd
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-bad-null.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# You can only compare Null for equality.
+
+description: "query: where clause with non-== comparison with Null"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: ">"
+      json_value: "null"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-order.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-order.textproto
new file mode 100644
index 000000000000..bab8601e8d6c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-order.textproto
@@ -0,0 +1,68 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When a document snapshot is used, the client appends a __name__ order-by clause
+# with the direction of the last order-by clause.
+
+description: "query: cursor methods with a document snapshot, existing orderBy"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    order_by: <
+      path: <
+        field: "b"
+      >
+      direction: "desc"
+    >
+  >
+  clauses: <
+    start_after: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "b"
+      >
+      direction: DESCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: DESCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 7
+      >
+      values: <
+        integer_value: 8
+      >
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-orderby-name.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-orderby-name.textproto
new file mode 100644
index 000000000000..d0ce3df45a2f
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-orderby-name.textproto
@@ -0,0 +1,76 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If there is an existing orderBy clause on __name__, no changes are made to the
+# list of orderBy clauses.
+
+description: "query: cursor method, doc snapshot, existing orderBy __name__"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "desc"
+    >
+  >
+  clauses: <
+    order_by: <
+      path: <
+        field: "__name__"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_at: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  clauses: <
+    end_at: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: DESCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 7
+      >
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+      before: true
+    >
+    end_at: <
+      values: <
+        integer_value: 7
+      >
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-eq.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-eq.textproto
new file mode 100644
index 000000000000..8b1e217df5f2
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-eq.textproto
@@ -0,0 +1,53 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Where clause using equality doesn't change the implicit orderBy clauses.
+
+description: "query: cursor methods with a document snapshot and an equality where clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "3"
+    >
+  >
+  clauses: <
+    end_at: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      field_filter: <
+        field: <
+          field_path: "a"
+        >
+        op: EQUAL
+        value: <
+          integer_value: 3
+        >
+      >
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: ASCENDING
+    >
+    end_at: <
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-neq-orderby.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-neq-orderby.textproto
new file mode 100644
index 000000000000..a69edfc50d11
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-neq-orderby.textproto
@@ -0,0 +1,72 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If there is an OrderBy clause, the inequality Where clause does not result in a
+# new OrderBy clause. We still add a __name__ OrderBy clause
+
+description: "query: cursor method, doc snapshot, inequality where clause, and existing orderBy clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "desc"
+    >
+  >
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "<"
+      json_value: "4"
+    >
+  >
+  clauses: <
+    start_at: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      field_filter: <
+        field: <
+          field_path: "a"
+        >
+        op: LESS_THAN
+        value: <
+          integer_value: 4
+        >
+      >
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: DESCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: DESCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 7
+      >
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-neq.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-neq.textproto
new file mode 100644
index 000000000000..871dd0ba3392
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap-where-neq.textproto
@@ -0,0 +1,64 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Where clause with an inequality results in an OrderBy clause on that clause's
+# path, if there are no other OrderBy clauses.
+
+description: "query: cursor method with a document snapshot and an inequality where clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "<="
+      json_value: "3"
+    >
+  >
+  clauses: <
+    end_before: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      field_filter: <
+        field: <
+          field_path: "a"
+        >
+        op: LESS_THAN_OR_EQUAL
+        value: <
+          integer_value: 3
+        >
+      >
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: ASCENDING
+    >
+    end_at: <
+      values: <
+        integer_value: 7
+      >
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap.textproto
new file mode 100644
index 000000000000..184bffc2d326
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-docsnap.textproto
@@ -0,0 +1,34 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When a document snapshot is used, the client appends a __name__ order-by clause.
+
+description: "query: cursor methods with a document snapshot"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    start_at: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D"
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-endbefore-empty-map.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-endbefore-empty-map.textproto
new file mode 100644
index 000000000000..c197d23afe16
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-endbefore-empty-map.textproto
@@ -0,0 +1,41 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods are allowed to use empty maps with EndBefore. It should result in
+# an empty map in the query.
+
+description: "query: EndBefore with explicit empty map"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "{}"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    end_at: <
+      values: <
+        map_value: <
+        >
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-endbefore-empty.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-endbefore-empty.textproto
new file mode 100644
index 000000000000..a41775abf074
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-endbefore-empty.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods are not allowed to use empty values with EndBefore. It should
+# result in an error.
+
+description: "query: EndBefore with empty values"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    end_before: <
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-no-order.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-no-order.textproto
new file mode 100644
index 000000000000..fb999ddabb0f
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-no-order.textproto
@@ -0,0 +1,16 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a cursor method with a list of values is provided, there must be at least as
+# many explicit orderBy clauses as values.
+
+description: "query: cursor method without orderBy"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    start_at: <
+      json_values: "2"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-startat-empty-map.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-startat-empty-map.textproto
new file mode 100644
index 000000000000..557aca2c9194
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-startat-empty-map.textproto
@@ -0,0 +1,41 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods are allowed to use empty maps with StartAt. It should result in
+# an empty map in the query.
+
+description: "query: StartAt with explicit empty map"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_at: <
+      json_values: "{}"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        map_value: <
+        >
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-startat-empty.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-startat-empty.textproto
new file mode 100644
index 000000000000..e0c54d98a6cc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-startat-empty.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods are not allowed to use empty values with StartAt. It should
+# result in an error.
+
+description: "query: StartAt with empty values"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_at: <
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-1a.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-1a.textproto
new file mode 100644
index 000000000000..bb08ab7d4d5b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-1a.textproto
@@ -0,0 +1,50 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods take the same number of values as there are OrderBy clauses.
+
+description: "query: StartAt/EndBefore with values"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_at: <
+      json_values: "7"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "9"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 7
+      >
+      before: true
+    >
+    end_at: <
+      values: <
+        integer_value: 9
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-1b.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-1b.textproto
new file mode 100644
index 000000000000..41e69e9e6f14
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-1b.textproto
@@ -0,0 +1,48 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods take the same number of values as there are OrderBy clauses.
+
+description: "query: StartAfter/EndAt with values"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_after: <
+      json_values: "7"
+    >
+  >
+  clauses: <
+    end_at: <
+      json_values: "9"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 7
+      >
+    >
+    end_at: <
+      values: <
+        integer_value: 9
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-2.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-2.textproto
new file mode 100644
index 000000000000..8e37ad0035fa
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-2.textproto
@@ -0,0 +1,71 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor methods take the same number of values as there are OrderBy clauses.
+
+description: "query: Start/End with two values"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    order_by: <
+      path: <
+        field: "b"
+      >
+      direction: "desc"
+    >
+  >
+  clauses: <
+    start_at: <
+      json_values: "7"
+      json_values: "8"
+    >
+  >
+  clauses: <
+    end_at: <
+      json_values: "9"
+      json_values: "10"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "b"
+      >
+      direction: DESCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 7
+      >
+      values: <
+        integer_value: 8
+      >
+      before: true
+    >
+    end_at: <
+      values: <
+        integer_value: 9
+      >
+      values: <
+        integer_value: 10
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-docid.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-docid.textproto
new file mode 100644
index 000000000000..91af3486c998
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-docid.textproto
@@ -0,0 +1,50 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Cursor values corresponding to a __name__ field take the document path relative
+# to the query's collection.
+
+description: "query: cursor methods with __name__"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "__name__"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_after: <
+      json_values: "\"D1\""
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "\"D2\""
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "__name__"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D1"
+      >
+    >
+    end_at: <
+      values: <
+        reference_value: "projects/projectID/databases/(default)/documents/C/D2"
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-last-wins.textproto b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-last-wins.textproto
new file mode 100644
index 000000000000..9e8fbb19f336
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-cursor-vals-last-wins.textproto
@@ -0,0 +1,60 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When multiple Start* or End* calls occur, the values of the last one are used.
+
+description: "query: cursor methods, last one wins"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    start_after: <
+      json_values: "1"
+    >
+  >
+  clauses: <
+    start_at: <
+      json_values: "2"
+    >
+  >
+  clauses: <
+    end_at: <
+      json_values: "3"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "4"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: ASCENDING
+    >
+    start_at: <
+      values: <
+        integer_value: 2
+      >
+      before: true
+    >
+    end_at: <
+      values: <
+        integer_value: 4
+      >
+      before: true
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-del-cursor.textproto b/firestore/tests/unit/v1beta1/testdata/query-del-cursor.textproto
new file mode 100644
index 000000000000..c9d4adb7c5dc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-del-cursor.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Sentinel values are not permitted in queries.
+
+description: "query: Delete in cursor method"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "\"Delete\""
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-del-where.textproto b/firestore/tests/unit/v1beta1/testdata/query-del-where.textproto
new file mode 100644
index 000000000000..8e92529492ea
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-del-where.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Sentinel values are not permitted in queries.
+
+description: "query: Delete in Where"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "\"Delete\""
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-invalid-operator.textproto b/firestore/tests/unit/v1beta1/testdata/query-invalid-operator.textproto
new file mode 100644
index 000000000000..e580c64a759f
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-invalid-operator.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The != operator is not supported.
+
+description: "query: invalid operator in Where clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "!="
+      json_value: "4"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-invalid-path-order.textproto b/firestore/tests/unit/v1beta1/testdata/query-invalid-path-order.textproto
new file mode 100644
index 000000000000..e0a72057620c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-invalid-path-order.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The path has an empty component.
+
+description: "query: invalid path in OrderBy clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "*"
+        field: ""
+      >
+      direction: "asc"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-invalid-path-select.textproto b/firestore/tests/unit/v1beta1/testdata/query-invalid-path-select.textproto
new file mode 100644
index 000000000000..944f984f7fa9
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-invalid-path-select.textproto
@@ -0,0 +1,18 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The path has an empty component.
+
+description: "query: invalid path in Where clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    select: <
+      fields: <
+        field: "*"
+        field: ""
+      >
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-invalid-path-where.textproto b/firestore/tests/unit/v1beta1/testdata/query-invalid-path-where.textproto
new file mode 100644
index 000000000000..527923b09799
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-invalid-path-where.textproto
@@ -0,0 +1,20 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The path has an empty component.
+
+description: "query: invalid path in Where clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "*"
+        field: ""
+      >
+      op: "=="
+      json_value: "4"
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-offset-limit-last-wins.textproto b/firestore/tests/unit/v1beta1/testdata/query-offset-limit-last-wins.textproto
new file mode 100644
index 000000000000..dc301f439e8d
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-offset-limit-last-wins.textproto
@@ -0,0 +1,30 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# With multiple Offset or Limit clauses, the last one wins.
+
+description: "query: multiple Offset and Limit clauses"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    offset: 2
+  >
+  clauses: <
+    limit: 3
+  >
+  clauses: <
+    limit: 4
+  >
+  clauses: <
+    offset: 5
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    offset: 5
+    limit: <
+      value: 4
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-offset-limit.textproto b/firestore/tests/unit/v1beta1/testdata/query-offset-limit.textproto
new file mode 100644
index 000000000000..136d9d46a615
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-offset-limit.textproto
@@ -0,0 +1,24 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Offset and Limit clauses.
+
+description: "query: Offset and Limit clauses"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    offset: 2
+  >
+  clauses: <
+    limit: 3
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    offset: 2
+    limit: <
+      value: 3
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-order.textproto b/firestore/tests/unit/v1beta1/testdata/query-order.textproto
new file mode 100644
index 000000000000..7ed4c4ead840
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-order.textproto
@@ -0,0 +1,42 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Multiple OrderBy clauses combine.
+
+description: "query: basic OrderBy clauses"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "b"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "desc"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    order_by: <
+      field: <
+        field_path: "b"
+      >
+      direction: ASCENDING
+    >
+    order_by: <
+      field: <
+        field_path: "a"
+      >
+      direction: DESCENDING
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-select-empty.textproto b/firestore/tests/unit/v1beta1/testdata/query-select-empty.textproto
new file mode 100644
index 000000000000..def8b55ac515
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-select-empty.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An empty Select clause selects just the document ID.
+
+description: "query: empty Select clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    select: <
+    >
+  >
+  query: <
+    select: <
+      fields: <
+        field_path: "__name__"
+      >
+    >
+    from: <
+      collection_id: "C"
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-select-last-wins.textproto b/firestore/tests/unit/v1beta1/testdata/query-select-last-wins.textproto
new file mode 100644
index 000000000000..bd78d09eb9b8
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-select-last-wins.textproto
@@ -0,0 +1,36 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The last Select clause is the only one used.
+
+description: "query: two Select clauses"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    select: <
+      fields: <
+        field: "a"
+      >
+      fields: <
+        field: "b"
+      >
+    >
+  >
+  clauses: <
+    select: <
+      fields: <
+        field: "c"
+      >
+    >
+  >
+  query: <
+    select: <
+      fields: <
+        field_path: "c"
+      >
+    >
+    from: <
+      collection_id: "C"
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-select.textproto b/firestore/tests/unit/v1beta1/testdata/query-select.textproto
new file mode 100644
index 000000000000..15e11249730c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-select.textproto
@@ -0,0 +1,32 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ordinary Select clause.
+
+description: "query: Select clause with some fields"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    select: <
+      fields: <
+        field: "a"
+      >
+      fields: <
+        field: "b"
+      >
+    >
+  >
+  query: <
+    select: <
+      fields: <
+        field_path: "a"
+      >
+      fields: <
+        field_path: "b"
+      >
+    >
+    from: <
+      collection_id: "C"
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-st-cursor.textproto b/firestore/tests/unit/v1beta1/testdata/query-st-cursor.textproto
new file mode 100644
index 000000000000..66885d0dd5dc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-st-cursor.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Sentinel values are not permitted in queries.
+
+description: "query: ServerTimestamp in cursor method"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    order_by: <
+      path: <
+        field: "a"
+      >
+      direction: "asc"
+    >
+  >
+  clauses: <
+    end_before: <
+      json_values: "\"ServerTimestamp\""
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-st-where.textproto b/firestore/tests/unit/v1beta1/testdata/query-st-where.textproto
new file mode 100644
index 000000000000..05da28d54291
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-st-where.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Sentinel values are not permitted in queries.
+
+description: "query: ServerTimestamp in Where"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "\"ServerTimestamp\""
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-where-2.textproto b/firestore/tests/unit/v1beta1/testdata/query-where-2.textproto
new file mode 100644
index 000000000000..1034463079e1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-where-2.textproto
@@ -0,0 +1,59 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Multiple Where clauses are combined into a composite filter.
+
+description: "query: two Where clauses"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: ">="
+      json_value: "5"
+    >
+  >
+  clauses: <
+    where: <
+      path: <
+        field: "b"
+      >
+      op: "<"
+      json_value: "\"foo\""
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      composite_filter: <
+        op: AND
+        filters: <
+          field_filter: <
+            field: <
+              field_path: "a"
+            >
+            op: GREATER_THAN_OR_EQUAL
+            value: <
+              integer_value: 5
+            >
+          >
+        >
+        filters: <
+          field_filter: <
+            field: <
+              field_path: "b"
+            >
+            op: LESS_THAN
+            value: <
+              string_value: "foo"
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-where-NaN.textproto b/firestore/tests/unit/v1beta1/testdata/query-where-NaN.textproto
new file mode 100644
index 000000000000..4a97ca7dde1f
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-where-NaN.textproto
@@ -0,0 +1,31 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Where clause that tests for equality with NaN results in a unary filter.
+
+description: "query: a Where clause comparing to NaN"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "\"NaN\""
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      unary_filter: <
+        op: IS_NAN
+        field: <
+          field_path: "a"
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-where-null.textproto b/firestore/tests/unit/v1beta1/testdata/query-where-null.textproto
new file mode 100644
index 000000000000..1869c60c72aa
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-where-null.textproto
@@ -0,0 +1,31 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Where clause that tests for equality with null results in a unary filter.
+
+description: "query: a Where clause comparing to null"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: "=="
+      json_value: "null"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      unary_filter: <
+        op: IS_NULL
+        field: <
+          field_path: "a"
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-where.textproto b/firestore/tests/unit/v1beta1/testdata/query-where.textproto
new file mode 100644
index 000000000000..045c2befab88
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-where.textproto
@@ -0,0 +1,34 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A simple Where clause.
+
+description: "query: Where clause"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    where: <
+      path: <
+        field: "a"
+      >
+      op: ">"
+      json_value: "5"
+    >
+  >
+  query: <
+    from: <
+      collection_id: "C"
+    >
+    where: <
+      field_filter: <
+        field: <
+          field_path: "a"
+        >
+        op: GREATER_THAN
+        value: <
+          integer_value: 5
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/query-wrong-collection.textproto b/firestore/tests/unit/v1beta1/testdata/query-wrong-collection.textproto
new file mode 100644
index 000000000000..ad6f353d5fc9
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/query-wrong-collection.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a document snapshot is passed to a Start*/End* method, it must be in the same
+# collection as the query.
+
+description: "query: doc snapshot with wrong collection in cursor method"
+query: <
+  coll_path: "projects/projectID/databases/(default)/documents/C"
+  clauses: <
+    end_before: <
+      doc_snapshot: <
+        path: "projects/projectID/databases/(default)/documents/C2/D"
+        json_data: "{\"a\": 7, \"b\": 8}"
+      >
+    >
+  >
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-all-transforms.textproto b/firestore/tests/unit/v1beta1/testdata/set-all-transforms.textproto
new file mode 100644
index 000000000000..bf18f9a5b12a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-all-transforms.textproto
@@ -0,0 +1,61 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can be created with any amount of transforms.
+
+description: "set: all transforms in a single call"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": [\"ArrayUnion\", 1, 2, 3], \"d\": [\"ArrayRemove\", 4, 5, 6]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayremove-multi.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-multi.textproto
new file mode 100644
index 000000000000..9b62fe191953
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-multi.textproto
@@ -0,0 +1,58 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayRemove field. Since all the ArrayRemove
+# fields are removed, the only field in the update is "a".
+
+description: "set: multiple ArrayRemove fields"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3], \"c\": {\"d\": [\"ArrayRemove\", 4, 5, 6]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayremove-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-nested.textproto
new file mode 100644
index 000000000000..617609c5a39e
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-nested.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayRemove value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "set: nested ArrayRemove field"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": [\"ArrayRemove\", 1, 2, 3]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayremove-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-noarray-nested.textproto
new file mode 100644
index 000000000000..2efa34a59f19
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayRemove. Firestore transforms don't support array indexing.
+
+description: "set: ArrayRemove cannot be anywhere inside an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayremove-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-noarray.textproto
new file mode 100644
index 000000000000..e7aa209ea22b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayRemove must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "set: ArrayRemove cannot be in an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayremove-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-with-st.textproto
new file mode 100644
index 000000000000..353025b59ff5
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayremove-with-st.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "set: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayRemove\", 1, \"ServerTimestamp\", 3]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayremove.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayremove.textproto
new file mode 100644
index 000000000000..8aa6b60d0156
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayremove.textproto
@@ -0,0 +1,44 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayRemove is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "set: ArrayRemove with data"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayunion-multi.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-multi.textproto
new file mode 100644
index 000000000000..e515bfa8d188
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-multi.textproto
@@ -0,0 +1,58 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayUnion field. Since all the ArrayUnion
+# fields are removed, the only field in the update is "a".
+
+description: "set: multiple ArrayUnion fields"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3], \"c\": {\"d\": [\"ArrayUnion\", 4, 5, 6]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          append_missing_elements: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayunion-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-nested.textproto
new file mode 100644
index 000000000000..f8abeb0d0004
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-nested.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayUnion value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "set: nested ArrayUnion field"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": [\"ArrayUnion\", 1, 2, 3]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayunion-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-noarray-nested.textproto
new file mode 100644
index 000000000000..2b4170f431a3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayUnion. Firestore transforms don't support array indexing.
+
+description: "set: ArrayUnion cannot be anywhere inside an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayunion-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-noarray.textproto
new file mode 100644
index 000000000000..e08af3a07f14
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayUnion must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "set: ArrayUnion cannot be in an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayunion-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-with-st.textproto
new file mode 100644
index 000000000000..37a7a132e750
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayunion-with-st.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "set: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayUnion\", 1, \"ServerTimestamp\", 3]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-arrayunion.textproto b/firestore/tests/unit/v1beta1/testdata/set-arrayunion.textproto
new file mode 100644
index 000000000000..4751e0c0e322
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-arrayunion.textproto
@@ -0,0 +1,44 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayUnion is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "set: ArrayUnion with data"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-basic.textproto b/firestore/tests/unit/v1beta1/testdata/set-basic.textproto
new file mode 100644
index 000000000000..e9b292e3cdc3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-basic.textproto
@@ -0,0 +1,24 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A simple call, resulting in a single update operation.
+
+description: "set: basic"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-complex.textproto b/firestore/tests/unit/v1beta1/testdata/set-complex.textproto
new file mode 100644
index 000000000000..6ec19500a2d0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-complex.textproto
@@ -0,0 +1,58 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A call to a write method with complicated input data.
+
+description: "set: complex"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2.5], \"b\": {\"c\": [\"three\", {\"d\": true}]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            array_value: <
+              values: <
+                integer_value: 1
+              >
+              values: <
+                double_value: 2.5
+              >
+            >
+          >
+        >
+        fields: <
+          key: "b"
+          value: <
+            map_value: <
+              fields: <
+                key: "c"
+                value: <
+                  array_value: <
+                    values: <
+                      string_value: "three"
+                    >
+                    values: <
+                      map_value: <
+                        fields: <
+                          key: "d"
+                          value: <
+                            boolean_value: true
+                          >
+                        >
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-merge-alone.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-merge-alone.textproto
new file mode 100644
index 000000000000..811ab8dfe7bb
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-merge-alone.textproto
@@ -0,0 +1,28 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Delete sentinel can appear with a merge option. If the delete paths are the
+# only ones to be merged, then no document is sent, just an update mask.
+
+description: "set-merge: Delete with merge"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "b"
+      field: "c"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": {\"c\": \"Delete\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+      update_mask: <
+        field_paths: "b.c"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-merge.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-merge.textproto
new file mode 100644
index 000000000000..b8d8631051e7
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-merge.textproto
@@ -0,0 +1,37 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Delete sentinel can appear with a merge option.
+
+description: "set-merge: Delete with merge"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "a"
+    >
+    fields: <
+      field: "b"
+      field: "c"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": {\"c\": \"Delete\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b.c"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-mergeall.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-mergeall.textproto
new file mode 100644
index 000000000000..af1e84524bca
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-mergeall.textproto
@@ -0,0 +1,31 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A Delete sentinel can appear with a mergeAll option.
+
+description: "set: Delete with MergeAll"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    all: true
+  >
+  json_data: "{\"a\": 1, \"b\": {\"c\": \"Delete\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b.c"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-noarray-nested.textproto
new file mode 100644
index 000000000000..bbf6a3d00af3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-noarray-nested.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "set: Delete cannot be anywhere inside an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": \"Delete\"}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-noarray.textproto
new file mode 100644
index 000000000000..07fc6497dc35
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-noarray.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "set: Delete cannot be in an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, \"Delete\"]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-nomerge.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-nomerge.textproto
new file mode 100644
index 000000000000..cb6ef4f85870
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-nomerge.textproto
@@ -0,0 +1,17 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The client signals an error if the Delete sentinel is in the input data, but not
+# selected by a merge option, because this is most likely a programming bug.
+
+description: "set-merge: Delete cannot appear in an unmerged field"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "a"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": \"Delete\"}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-nonleaf.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-nonleaf.textproto
new file mode 100644
index 000000000000..54f22d95c521
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-nonleaf.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a Delete is part of the value at a merge path, then the user is confused:
+# their merge path says "replace this entire value" but their Delete says "delete
+# this part of the value". This should be an error, just as if they specified
+# Delete in a Set with no merge.
+
+description: "set-merge: Delete cannot appear as part of a merge path"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "h"
+    >
+  >
+  json_data: "{\"h\": {\"g\": \"Delete\"}}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-del-wo-merge.textproto b/firestore/tests/unit/v1beta1/testdata/set-del-wo-merge.textproto
new file mode 100644
index 000000000000..29196628bfd8
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-del-wo-merge.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Without a merge option, Set replaces the document with the input data. A Delete
+# sentinel in the data makes no sense in this case.
+
+description: "set: Delete cannot appear unless a merge option is specified"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"Delete\"}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-empty.textproto b/firestore/tests/unit/v1beta1/testdata/set-empty.textproto
new file mode 100644
index 000000000000..c2b73d3ff933
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-empty.textproto
@@ -0,0 +1,17 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+
+description: "set: creating or setting an empty map"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-merge-fp.textproto b/firestore/tests/unit/v1beta1/testdata/set-merge-fp.textproto
new file mode 100644
index 000000000000..68690f6f1633
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-merge-fp.textproto
@@ -0,0 +1,40 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A merge with fields that use special characters.
+
+description: "set-merge: Merge with FieldPaths"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "*"
+      field: "~"
+    >
+  >
+  json_data: "{\"*\": {\"~\": true}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "*"
+          value: <
+            map_value: <
+              fields: <
+                key: "~"
+                value: <
+                  boolean_value: true
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "`*`.`~`"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-merge-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-merge-nested.textproto
new file mode 100644
index 000000000000..0d1282818d76
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-merge-nested.textproto
@@ -0,0 +1,41 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A merge option where the field is not at top level. Only fields mentioned in the
+# option are present in the update operation.
+
+description: "set-merge: Merge with a nested field"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "h"
+      field: "g"
+    >
+  >
+  json_data: "{\"h\": {\"g\": 4, \"f\": 5}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "h"
+          value: <
+            map_value: <
+              fields: <
+                key: "g"
+                value: <
+                  integer_value: 4
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "h.g"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-merge-nonleaf.textproto b/firestore/tests/unit/v1beta1/testdata/set-merge-nonleaf.textproto
new file mode 100644
index 000000000000..ca41cb03402d
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-merge-nonleaf.textproto
@@ -0,0 +1,46 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a field path is in a merge option, the value at that path replaces the stored
+# value. That is true even if the value is complex.
+
+description: "set-merge: Merge field is not a leaf"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "h"
+    >
+  >
+  json_data: "{\"h\": {\"f\": 5, \"g\": 6}, \"e\": 7}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "h"
+          value: <
+            map_value: <
+              fields: <
+                key: "f"
+                value: <
+                  integer_value: 5
+                >
+              >
+              fields: <
+                key: "g"
+                value: <
+                  integer_value: 6
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "h"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-merge-prefix.textproto b/firestore/tests/unit/v1beta1/testdata/set-merge-prefix.textproto
new file mode 100644
index 000000000000..1e2c2c50226e
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-merge-prefix.textproto
@@ -0,0 +1,21 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The prefix would make the other path meaningless, so this is probably a
+# programming error.
+
+description: "set-merge: One merge path cannot be the prefix of another"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "a"
+    >
+    fields: <
+      field: "a"
+      field: "b"
+    >
+  >
+  json_data: "{\"a\": {\"b\": 1}}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-merge-present.textproto b/firestore/tests/unit/v1beta1/testdata/set-merge-present.textproto
new file mode 100644
index 000000000000..f6665de5cdc3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-merge-present.textproto
@@ -0,0 +1,20 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The client signals an error if a merge option mentions a path that is not in the
+# input data.
+
+description: "set-merge: Merge fields must all be present in data"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "b"
+    >
+    fields: <
+      field: "a"
+    >
+  >
+  json_data: "{\"a\": 1}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-merge.textproto b/firestore/tests/unit/v1beta1/testdata/set-merge.textproto
new file mode 100644
index 000000000000..279125253cb1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-merge.textproto
@@ -0,0 +1,32 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Fields in the input data but not in a merge option are pruned.
+
+description: "set-merge: Merge with a field"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "a"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": 2}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-mergeall-empty.textproto b/firestore/tests/unit/v1beta1/testdata/set-mergeall-empty.textproto
new file mode 100644
index 000000000000..16df8a22bed3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-mergeall-empty.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# This is a valid call that can be used to ensure a document exists.
+
+description: "set: MergeAll can be specified with empty data."
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    all: true
+  >
+  json_data: "{}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+      update_mask: <
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-mergeall-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-mergeall-nested.textproto
new file mode 100644
index 000000000000..1fbc6973cd28
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-mergeall-nested.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# MergeAll with nested fields results in an update mask that includes entries for
+# all the leaf fields.
+
+description: "set: MergeAll with nested fields"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    all: true
+  >
+  json_data: "{\"h\": { \"g\": 3, \"f\": 4 }}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "h"
+          value: <
+            map_value: <
+              fields: <
+                key: "f"
+                value: <
+                  integer_value: 4
+                >
+              >
+              fields: <
+                key: "g"
+                value: <
+                  integer_value: 3
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "h.f"
+        field_paths: "h.g"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-mergeall.textproto b/firestore/tests/unit/v1beta1/testdata/set-mergeall.textproto
new file mode 100644
index 000000000000..cb2ebc52bc06
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-mergeall.textproto
@@ -0,0 +1,37 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The MergeAll option with a simple piece of data.
+
+description: "set: MergeAll"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    all: true
+  >
+  json_data: "{\"a\": 1, \"b\": 2}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        fields: <
+          key: "b"
+          value: <
+            integer_value: 2
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-nodel.textproto b/firestore/tests/unit/v1beta1/testdata/set-nodel.textproto
new file mode 100644
index 000000000000..0fb887d461be
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-nodel.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel cannot be used in Create, or in Set without a Merge option.
+
+description: "set: Delete cannot appear in data"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"Delete\"}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-nosplit.textproto b/firestore/tests/unit/v1beta1/testdata/set-nosplit.textproto
new file mode 100644
index 000000000000..0ff3fadcf4ba
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-nosplit.textproto
@@ -0,0 +1,37 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Create and Set treat their map keys literally. They do not split on dots.
+
+description: "set: don\342\200\231t split on dots"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{ \"a.b\": { \"c.d\": 1 }, \"e\": 2 }"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a.b"
+          value: <
+            map_value: <
+              fields: <
+                key: "c.d"
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+        fields: <
+          key: "e"
+          value: <
+            integer_value: 2
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-special-chars.textproto b/firestore/tests/unit/v1beta1/testdata/set-special-chars.textproto
new file mode 100644
index 000000000000..f4122c9f004c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-special-chars.textproto
@@ -0,0 +1,38 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Create and Set treat their map keys literally. They do not escape special
+# characters.
+
+description: "set: non-alpha characters in map keys"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{ \"*\": { \".\": 1 }, \"~\": 2 }"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "*"
+          value: <
+            map_value: <
+              fields: <
+                key: "."
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+        fields: <
+          key: "~"
+          value: <
+            integer_value: 2
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-alone-mergeall.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-alone-mergeall.textproto
new file mode 100644
index 000000000000..16ce4cfbd913
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-alone-mergeall.textproto
@@ -0,0 +1,26 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ServerTimestamps, then no update operation
+# should be produced.
+
+description: "set: ServerTimestamp alone with MergeAll"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    all: true
+  >
+  json_data: "{\"a\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-alone.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-alone.textproto
new file mode 100644
index 000000000000..6ce46d7f1ab5
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-alone.textproto
@@ -0,0 +1,28 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ServerTimestamps, then an update operation
+# with an empty map should be produced.
+
+description: "set: ServerTimestamp alone"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-merge-both.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-merge-both.textproto
new file mode 100644
index 000000000000..5cc7bbc9efbf
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-merge-both.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Just as when no merge option is specified, ServerTimestamp sentinel values are
+# removed from the data in the update operation and become transforms.
+
+description: "set-merge: ServerTimestamp with Merge of both fields"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "a"
+    >
+    fields: <
+      field: "b"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-merge-nonleaf-alone.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-merge-nonleaf-alone.textproto
new file mode 100644
index 000000000000..f513b6c804c5
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-merge-nonleaf-alone.textproto
@@ -0,0 +1,37 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a field path is in a merge option, the value at that path replaces the stored
+# value. If the value has only ServerTimestamps, they become transforms and we
+# clear the value by including the field path in the update mask.
+
+description: "set-merge: non-leaf merge field with ServerTimestamp alone"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "h"
+    >
+  >
+  json_data: "{\"h\": {\"g\": \"ServerTimestamp\"}, \"e\": 7}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+      update_mask: <
+        field_paths: "h"
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "h.g"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-merge-nonleaf.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-merge-nonleaf.textproto
new file mode 100644
index 000000000000..e53e7e2682eb
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-merge-nonleaf.textproto
@@ -0,0 +1,49 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a field path is in a merge option, the value at that path replaces the stored
+# value, and ServerTimestamps inside that value become transforms as usual.
+
+description: "set-merge: non-leaf merge field with ServerTimestamp"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "h"
+    >
+  >
+  json_data: "{\"h\": {\"f\": 5, \"g\": \"ServerTimestamp\"}, \"e\": 7}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "h"
+          value: <
+            map_value: <
+              fields: <
+                key: "f"
+                value: <
+                  integer_value: 5
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "h"
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "h.g"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-merge-nowrite.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-merge-nowrite.textproto
new file mode 100644
index 000000000000..3222230dc510
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-merge-nowrite.textproto
@@ -0,0 +1,28 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If all the fields in the merge option have ServerTimestamp values, then no
+# update operation is produced, only a transform.
+
+description: "set-merge: If no ordinary values in Merge, no write"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "b"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-mergeall.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-mergeall.textproto
new file mode 100644
index 000000000000..b8c53a566fdd
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-mergeall.textproto
@@ -0,0 +1,40 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Just as when no merge option is specified, ServerTimestamp sentinel values are
+# removed from the data in the update operation and become transforms.
+
+description: "set: ServerTimestamp with MergeAll"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    all: true
+  >
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-multi.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-multi.textproto
new file mode 100644
index 000000000000..375ec18d68fd
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-multi.textproto
@@ -0,0 +1,38 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ServerTimestamp field. Since all the
+# ServerTimestamp fields are removed, the only field in the update is "a".
+
+description: "set: multiple ServerTimestamp fields"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": {\"d\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c.d"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-nested.textproto
new file mode 100644
index 000000000000..abfd2e8fd874
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-nested.textproto
@@ -0,0 +1,35 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A ServerTimestamp value can occur at any depth. In this case, the transform
+# applies to the field path "b.c". Since "c" is removed from the update, "b"
+# becomes empty, so it is also removed from the update.
+
+description: "set: nested ServerTimestamp field"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-noarray-nested.textproto
new file mode 100644
index 000000000000..241d79151a42
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ServerTimestamp sentinel. Firestore transforms don't support array indexing.
+
+description: "set: ServerTimestamp cannot be anywhere inside an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": \"ServerTimestamp\"}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-noarray.textproto
new file mode 100644
index 000000000000..591fb0343854
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. Firestore transforms
+# don't support array indexing.
+
+description: "set: ServerTimestamp cannot be in an array value"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, \"ServerTimestamp\"]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-nomerge.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-nomerge.textproto
new file mode 100644
index 000000000000..20c0ae1fbb0e
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-nomerge.textproto
@@ -0,0 +1,33 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the ServerTimestamp value is not mentioned in a merge option, then it is
+# pruned from the data but does not result in a transform.
+
+description: "set-merge: If is ServerTimestamp not in Merge, no transform"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  option: <
+    fields: <
+      field: "a"
+    >
+  >
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st-with-empty-map.textproto b/firestore/tests/unit/v1beta1/testdata/set-st-with-empty-map.textproto
new file mode 100644
index 000000000000..5e187983f995
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st-with-empty-map.textproto
@@ -0,0 +1,42 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When a ServerTimestamp and a map both reside inside a map, the ServerTimestamp
+# should be stripped out but the empty map should remain.
+
+description: "set: ServerTimestamp beside an empty map"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": {\"b\": {}, \"c\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  map_value: <
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/set-st.textproto b/firestore/tests/unit/v1beta1/testdata/set-st.textproto
new file mode 100644
index 000000000000..8bceddceeacc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/set-st.textproto
@@ -0,0 +1,36 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with the special ServerTimestamp sentinel is removed from the data in the
+# update operation. Instead it appears in a separate Transform operation. Note
+# that in these tests, the string "ServerTimestamp" should be replaced with the
+# special ServerTimestamp value.
+
+description: "set: ServerTimestamp with data"
+set: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/test-suite.binproto b/firestore/tests/unit/v1beta1/testdata/test-suite.binproto
new file mode 100644
index 000000000000..6e3ce3973752
Binary files /dev/null and b/firestore/tests/unit/v1beta1/testdata/test-suite.binproto differ
diff --git a/firestore/tests/unit/v1beta1/testdata/update-all-transforms.textproto b/firestore/tests/unit/v1beta1/testdata/update-all-transforms.textproto
new file mode 100644
index 000000000000..225cc61e405e
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-all-transforms.textproto
@@ -0,0 +1,67 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can be created with any amount of transforms.
+
+description: "update: all transforms in a single call"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": [\"ArrayUnion\", 1, 2, 3], \"d\": [\"ArrayRemove\", 4, 5, 6]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-alone.textproto
new file mode 100644
index 000000000000..8c79a31d5052
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-alone.textproto
@@ -0,0 +1,36 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ArrayRemove, then no update operation should
+# be produced.
+
+description: "update: ArrayRemove alone"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayRemove\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-multi.textproto
new file mode 100644
index 000000000000..2362b6e09458
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-multi.textproto
@@ -0,0 +1,69 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayRemove field. Since all the ArrayRemove
+# fields are removed, the only field in the update is "a".
+
+# b is not in the mask because it will be set in the transform. c must be in the
+# mask: it should be replaced entirely. The transform will set c.d to the
+# timestamp, but the update will delete the rest of c.
+
+description: "update: multiple ArrayRemove fields"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3], \"c\": {\"d\": [\"ArrayRemove\", 4, 5, 6]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-nested.textproto
new file mode 100644
index 000000000000..143790179eaf
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-nested.textproto
@@ -0,0 +1,52 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayRemove value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "update: nested ArrayRemove field"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": [\"ArrayRemove\", 1, 2, 3]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-noarray-nested.textproto
new file mode 100644
index 000000000000..04eca965c688
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayRemove. Firestore transforms don't support array indexing.
+
+description: "update: ArrayRemove cannot be anywhere inside an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-noarray.textproto
new file mode 100644
index 000000000000..bbd27bf017e1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayRemove must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "update: ArrayRemove cannot be in an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-with-st.textproto
new file mode 100644
index 000000000000..4888b44f1c01
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove-with-st.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "update: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayRemove\", 1, \"ServerTimestamp\", 3]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayremove.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayremove.textproto
new file mode 100644
index 000000000000..3b767cf486c3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayremove.textproto
@@ -0,0 +1,50 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayRemove is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "update: ArrayRemove with data"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayRemove\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-alone.textproto
new file mode 100644
index 000000000000..ec12818da74c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-alone.textproto
@@ -0,0 +1,36 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ArrayUnion, then no update operation should
+# be produced.
+
+description: "update: ArrayUnion alone"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayUnion\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-multi.textproto
new file mode 100644
index 000000000000..8edf6a3af046
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-multi.textproto
@@ -0,0 +1,69 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayUnion field. Since all the ArrayUnion
+# fields are removed, the only field in the update is "a".
+
+# b is not in the mask because it will be set in the transform. c must be in the
+# mask: it should be replaced entirely. The transform will set c.d to the
+# timestamp, but the update will delete the rest of c.
+
+description: "update: multiple ArrayUnion fields"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3], \"c\": {\"d\": [\"ArrayUnion\", 4, 5, 6]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          append_missing_elements: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-nested.textproto
new file mode 100644
index 000000000000..217e2e2ca775
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-nested.textproto
@@ -0,0 +1,52 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayUnion value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "update: nested ArrayUnion field"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": [\"ArrayUnion\", 1, 2, 3]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-noarray-nested.textproto
new file mode 100644
index 000000000000..0326781830ec
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayUnion. Firestore transforms don't support array indexing.
+
+description: "update: ArrayUnion cannot be anywhere inside an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-noarray.textproto
new file mode 100644
index 000000000000..c199f9f73c91
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayUnion must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "update: ArrayUnion cannot be in an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, [\"ArrayRemove\", 1, 2, 3]]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-with-st.textproto
new file mode 100644
index 000000000000..ee022f8492bc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion-with-st.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "update: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [\"ArrayUnion\", 1, \"ServerTimestamp\", 3]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-arrayunion.textproto b/firestore/tests/unit/v1beta1/testdata/update-arrayunion.textproto
new file mode 100644
index 000000000000..81b240b891bb
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-arrayunion.textproto
@@ -0,0 +1,50 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayUnion is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "update: ArrayUnion with data"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": [\"ArrayUnion\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-badchar.textproto b/firestore/tests/unit/v1beta1/testdata/update-badchar.textproto
new file mode 100644
index 000000000000..656ff53b686a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-badchar.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The keys of the data given to Update are interpreted, unlike those of Create and
+# Set. They cannot contain special characters.
+
+description: "update: invalid character"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a~b\": 1}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-basic.textproto b/firestore/tests/unit/v1beta1/testdata/update-basic.textproto
new file mode 100644
index 000000000000..9da316f58ebe
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-basic.textproto
@@ -0,0 +1,30 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A simple call, resulting in a single update operation.
+
+description: "update: basic"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-complex.textproto b/firestore/tests/unit/v1beta1/testdata/update-complex.textproto
new file mode 100644
index 000000000000..1a6d9eff64b9
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-complex.textproto
@@ -0,0 +1,65 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A call to a write method with complicated input data.
+
+description: "update: complex"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2.5], \"b\": {\"c\": [\"three\", {\"d\": true}]}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            array_value: <
+              values: <
+                integer_value: 1
+              >
+              values: <
+                double_value: 2.5
+              >
+            >
+          >
+        >
+        fields: <
+          key: "b"
+          value: <
+            map_value: <
+              fields: <
+                key: "c"
+                value: <
+                  array_value: <
+                    values: <
+                      string_value: "three"
+                    >
+                    values: <
+                      map_value: <
+                        fields: <
+                          key: "d"
+                          value: <
+                            boolean_value: true
+                          >
+                        >
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-del-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-del-alone.textproto
new file mode 100644
index 000000000000..8f558233f037
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-del-alone.textproto
@@ -0,0 +1,25 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the input data consists solely of Deletes, then the update operation has no
+# map, just an update mask.
+
+description: "update: Delete alone"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": \"Delete\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-del-dot.textproto b/firestore/tests/unit/v1beta1/testdata/update-del-dot.textproto
new file mode 100644
index 000000000000..c0ebdf61f787
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-del-dot.textproto
@@ -0,0 +1,46 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# After expanding top-level dotted fields, fields with Delete values are pruned
+# from the output data, but appear in the update mask.
+
+description: "update: Delete with a dotted field"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b.c\": \"Delete\", \"b.d\": 2}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+        fields: <
+          key: "b"
+          value: <
+            map_value: <
+              fields: <
+                key: "d"
+                value: <
+                  integer_value: 2
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b.c"
+        field_paths: "b.d"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-del-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-del-nested.textproto
new file mode 100644
index 000000000000..ed102697e682
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-del-nested.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a top-level key.
+
+description: "update: Delete cannot be nested"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": {\"b\": \"Delete\"}}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-del-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-del-noarray-nested.textproto
new file mode 100644
index 000000000000..a2eec49661c0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-del-noarray-nested.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "update: Delete cannot be anywhere inside an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": \"Delete\"}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-del-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-del-noarray.textproto
new file mode 100644
index 000000000000..a7eea87ef49f
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-del-noarray.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "update: Delete cannot be in an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, \"Delete\"]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-del.textproto b/firestore/tests/unit/v1beta1/testdata/update-del.textproto
new file mode 100644
index 000000000000..ec443e6c7035
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-del.textproto
@@ -0,0 +1,32 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a field's value is the Delete sentinel, then it doesn't appear in the update
+# data, but does in the mask.
+
+description: "update: Delete"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"Delete\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-exists-precond.textproto b/firestore/tests/unit/v1beta1/testdata/update-exists-precond.textproto
new file mode 100644
index 000000000000..3c6fef4e2263
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-exists-precond.textproto
@@ -0,0 +1,14 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Update method does not support an explicit exists precondition.
+
+description: "update: Exists precondition is invalid"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  precondition: <
+    exists: true
+  >
+  json_data: "{\"a\": 1}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-fp-empty-component.textproto b/firestore/tests/unit/v1beta1/testdata/update-fp-empty-component.textproto
new file mode 100644
index 000000000000..c3bceff3e4b8
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-fp-empty-component.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Empty fields are not allowed.
+
+description: "update: empty field path component"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a..b\": 1}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-nested-transform-and-nested-value.textproto b/firestore/tests/unit/v1beta1/testdata/update-nested-transform-and-nested-value.textproto
new file mode 100644
index 000000000000..d2cee270d531
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-nested-transform-and-nested-value.textproto
@@ -0,0 +1,58 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# For updates, top-level paths in json-like map inputs are split on the dot. That
+# is, an input {"a.b.c": 7} results in an update to field c of object b of object
+# a with value 7. In order to specify this behavior, the update must use a
+# fieldmask "a.b.c". However, fieldmasks are only used for concrete values -
+# transforms are separately encoded in a DocumentTransform_FieldTransform array.
+
+# This test exercises a bug found in python
+# (https://github.com/googleapis/google-cloud-python/issues/7215) in which nested
+# transforms ({"a.c": "ServerTimestamp"}) next to nested values ({"a.b": 7})
+# incorrectly caused the fieldmask "a" to be set, which has the effect of wiping
+# out all data in "a" other than what was specified in the json-like input.
+
+# Instead, as this test specifies, transforms should not affect the fieldmask.
+
+description: "update: Nested transforms should not affect the field mask, even\nwhen there are other values that do. Transforms should only affect the\nDocumentTransform_FieldTransform list."
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a.b\": 7, \"a.c\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  integer_value: 7
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a.b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-no-paths.textproto b/firestore/tests/unit/v1beta1/testdata/update-no-paths.textproto
new file mode 100644
index 000000000000..b524b7483f79
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-no-paths.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# It is a client-side error to call Update with empty data.
+
+description: "update: no paths"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-all-transforms.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-all-transforms.textproto
new file mode 100644
index 000000000000..8cfad4732034
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-all-transforms.textproto
@@ -0,0 +1,82 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can be created with any amount of transforms.
+
+description: "update-paths: all transforms in a single call"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  field_paths: <
+    field: "c"
+  >
+  field_paths: <
+    field: "d"
+  >
+  json_values: "1"
+  json_values: "\"ServerTimestamp\""
+  json_values: "[\"ArrayUnion\", 1, 2, 3]"
+  json_values: "[\"ArrayRemove\", 4, 5, 6]"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-alone.textproto
new file mode 100644
index 000000000000..68f0e147b2de
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-alone.textproto
@@ -0,0 +1,39 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ArrayRemove, then no update operation should
+# be produced.
+
+description: "update-paths: ArrayRemove alone"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[\"ArrayRemove\", 1, 2, 3]"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-multi.textproto
new file mode 100644
index 000000000000..b60c3f36a6c0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-multi.textproto
@@ -0,0 +1,76 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayRemove field. Since all the ArrayRemove
+# fields are removed, the only field in the update is "a".
+
+description: "update-paths: multiple ArrayRemove fields"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  field_paths: <
+    field: "c"
+  >
+  json_values: "1"
+  json_values: "[\"ArrayRemove\", 1, 2, 3]"
+  json_values: "{\"d\": [\"ArrayRemove\", 4, 5, 6]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          remove_all_from_array: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-nested.textproto
new file mode 100644
index 000000000000..381be19d553f
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-nested.textproto
@@ -0,0 +1,59 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayRemove value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "update-paths: nested ArrayRemove field"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "{\"c\": [\"ArrayRemove\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-noarray-nested.textproto
new file mode 100644
index 000000000000..35f6c67b2e56
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-noarray-nested.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayRemove. Firestore transforms don't support array indexing.
+
+description: "update-paths: ArrayRemove cannot be anywhere inside an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, {\"b\": [\"ArrayRemove\", 1, 2, 3]}]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-noarray.textproto
new file mode 100644
index 000000000000..45cab48dd9e1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-noarray.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayRemove must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "update-paths: ArrayRemove cannot be in an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, 2, [\"ArrayRemove\", 1, 2, 3]]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-with-st.textproto
new file mode 100644
index 000000000000..67b92a3ef3b9
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove-with-st.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "update-paths: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[\"ArrayRemove\", 1, \"ServerTimestamp\", 3]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove.textproto
new file mode 100644
index 000000000000..d3866676ede0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayremove.textproto
@@ -0,0 +1,57 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayRemove is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "update-paths: ArrayRemove with data"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "[\"ArrayRemove\", 1, 2, 3]"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          remove_all_from_array: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-alone.textproto
new file mode 100644
index 000000000000..48100e0abceb
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-alone.textproto
@@ -0,0 +1,39 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ArrayUnion, then no update operation should
+# be produced.
+
+description: "update-paths: ArrayUnion alone"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[\"ArrayUnion\", 1, 2, 3]"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-multi.textproto
new file mode 100644
index 000000000000..03772e5ddd1a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-multi.textproto
@@ -0,0 +1,76 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ArrayUnion field. Since all the ArrayUnion
+# fields are removed, the only field in the update is "a".
+
+description: "update-paths: multiple ArrayUnion fields"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  field_paths: <
+    field: "c"
+  >
+  json_values: "1"
+  json_values: "[\"ArrayUnion\", 1, 2, 3]"
+  json_values: "{\"d\": [\"ArrayUnion\", 4, 5, 6]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+        field_transforms: <
+          field_path: "c.d"
+          append_missing_elements: <
+            values: <
+              integer_value: 4
+            >
+            values: <
+              integer_value: 5
+            >
+            values: <
+              integer_value: 6
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-nested.textproto
new file mode 100644
index 000000000000..1420e4e2806b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-nested.textproto
@@ -0,0 +1,59 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# An ArrayUnion value can occur at any depth. In this case, the transform applies
+# to the field path "b.c". Since "c" is removed from the update, "b" becomes
+# empty, so it is also removed from the update.
+
+description: "update-paths: nested ArrayUnion field"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "{\"c\": [\"ArrayUnion\", 1, 2, 3]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-noarray-nested.textproto
new file mode 100644
index 000000000000..ab75bf38a3ae
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-noarray-nested.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ArrayUnion. Firestore transforms don't support array indexing.
+
+description: "update-paths: ArrayUnion cannot be anywhere inside an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, {\"b\": [\"ArrayUnion\", 1, 2, 3]}]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-noarray.textproto
new file mode 100644
index 000000000000..fac72644fc38
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-noarray.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# ArrayUnion must be the value of a field. Firestore transforms don't support
+# array indexing.
+
+description: "update-paths: ArrayUnion cannot be in an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, 2, [\"ArrayRemove\", 1, 2, 3]]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-with-st.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-with-st.textproto
new file mode 100644
index 000000000000..d194c09bd775
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion-with-st.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. It may not appear in
+# an ArrayUnion.
+
+description: "update-paths: The ServerTimestamp sentinel cannot be in an ArrayUnion"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[\"ArrayUnion\", 1, \"ServerTimestamp\", 3]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion.textproto
new file mode 100644
index 000000000000..fc56c1e29471
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-arrayunion.textproto
@@ -0,0 +1,57 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with ArrayUnion is removed from the data in the update operation. Instead
+# it appears in a separate Transform operation.
+
+description: "update-paths: ArrayUnion with data"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "[\"ArrayUnion\", 1, 2, 3]"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          append_missing_elements: <
+            values: <
+              integer_value: 1
+            >
+            values: <
+              integer_value: 2
+            >
+            values: <
+              integer_value: 3
+            >
+          >
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-basic.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-basic.textproto
new file mode 100644
index 000000000000..515f29d6af02
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-basic.textproto
@@ -0,0 +1,33 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A simple call, resulting in a single update operation.
+
+description: "update-paths: basic"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "1"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-complex.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-complex.textproto
new file mode 100644
index 000000000000..38a832239f5c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-complex.textproto
@@ -0,0 +1,72 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A call to a write method with complicated input data.
+
+description: "update-paths: complex"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "[1, 2.5]"
+  json_values: "{\"c\": [\"three\", {\"d\": true}]}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            array_value: <
+              values: <
+                integer_value: 1
+              >
+              values: <
+                double_value: 2.5
+              >
+            >
+          >
+        >
+        fields: <
+          key: "b"
+          value: <
+            map_value: <
+              fields: <
+                key: "c"
+                value: <
+                  array_value: <
+                    values: <
+                      string_value: "three"
+                    >
+                    values: <
+                      map_value: <
+                        fields: <
+                          key: "d"
+                          value: <
+                            boolean_value: true
+                          >
+                        >
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-del-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-del-alone.textproto
new file mode 100644
index 000000000000..5dbb787de94b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-del-alone.textproto
@@ -0,0 +1,28 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the input data consists solely of Deletes, then the update operation has no
+# map, just an update mask.
+
+description: "update-paths: Delete alone"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "\"Delete\""
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-del-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-del-nested.textproto
new file mode 100644
index 000000000000..bdf65fb0ad91
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-del-nested.textproto
@@ -0,0 +1,14 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a top-level key.
+
+description: "update-paths: Delete cannot be nested"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "{\"b\": \"Delete\"}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-del-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-del-noarray-nested.textproto
new file mode 100644
index 000000000000..d3da15dda80e
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-del-noarray-nested.textproto
@@ -0,0 +1,16 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "update-paths: Delete cannot be anywhere inside an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, {\"b\": \"Delete\"}]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-del-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-del-noarray.textproto
new file mode 100644
index 000000000000..9ebdd0945198
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-del-noarray.textproto
@@ -0,0 +1,16 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Delete sentinel must be the value of a field. Deletes are implemented by
+# turning the path to the Delete sentinel into a FieldPath, and FieldPaths do not
+# support array indexing.
+
+description: "update-paths: Delete cannot be in an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, 2, \"Delete\"]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-del.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-del.textproto
new file mode 100644
index 000000000000..5197a78488f0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-del.textproto
@@ -0,0 +1,39 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If a field's value is the Delete sentinel, then it doesn't appear in the update
+# data, but does in the mask.
+
+description: "update-paths: Delete"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "\"Delete\""
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-exists-precond.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-exists-precond.textproto
new file mode 100644
index 000000000000..084e07726ee0
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-exists-precond.textproto
@@ -0,0 +1,17 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Update method does not support an explicit exists precondition.
+
+description: "update-paths: Exists precondition is invalid"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  precondition: <
+    exists: true
+  >
+  field_paths: <
+    field: "a"
+  >
+  json_values: "1"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-del.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-del.textproto
new file mode 100644
index 000000000000..5c92aeb8ca8b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-del.textproto
@@ -0,0 +1,47 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If one nested field is deleted, and another isn't, preserve the second.
+
+description: "update-paths: field paths with delete"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "foo"
+    field: "bar"
+  >
+  field_paths: <
+    field: "foo"
+    field: "delete"
+  >
+  json_values: "1"
+  json_values: "\"Delete\""
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "foo"
+          value: <
+            map_value: <
+              fields: <
+                key: "bar"
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "foo.bar"
+        field_paths: "foo.delete"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-dup-transforms.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-dup-transforms.textproto
new file mode 100644
index 000000000000..a84725a8d4d1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-dup-transforms.textproto
@@ -0,0 +1,23 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The same field cannot occur more than once, even if all the operations are
+# transforms.
+
+description: "update-paths: duplicate field path with only transforms"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[\"ArrayUnion\", 1, 2, 3]"
+  json_values: "\"ServerTimestamp\""
+  json_values: "[\"ArrayUnion\", 4, 5, 6]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-dup.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-dup.textproto
new file mode 100644
index 000000000000..fedbd3aab99d
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-dup.textproto
@@ -0,0 +1,22 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The same field cannot occur more than once.
+
+description: "update-paths: duplicate field path"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  field_paths: <
+    field: "a"
+  >
+  json_values: "1"
+  json_values: "2"
+  json_values: "3"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-empty-component.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-empty-component.textproto
new file mode 100644
index 000000000000..7a5df25b7ed2
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-empty-component.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Empty fields are not allowed.
+
+description: "update-paths: empty field path component"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "*"
+    field: ""
+  >
+  json_values: "1"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-empty.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-empty.textproto
new file mode 100644
index 000000000000..311e309326d1
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-empty.textproto
@@ -0,0 +1,13 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A FieldPath of length zero is invalid.
+
+description: "update-paths: empty field path"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+  >
+  json_values: "1"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-multi.textproto
new file mode 100644
index 000000000000..9ba41e39812c
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-multi.textproto
@@ -0,0 +1,42 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The UpdatePaths or equivalent method takes a list of FieldPaths. Each FieldPath
+# is a sequence of uninterpreted path components.
+
+description: "update-paths: multiple-element field path"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+    field: "b"
+  >
+  json_values: "1"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a.b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-fp-nosplit.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-nosplit.textproto
new file mode 100644
index 000000000000..516495266707
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-fp-nosplit.textproto
@@ -0,0 +1,48 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# FieldPath components are not split on dots.
+
+description: "update-paths: FieldPath elements are not split on dots"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a.b"
+    field: "f.g"
+  >
+  json_values: "{\"n.o\": 7}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a.b"
+          value: <
+            map_value: <
+              fields: <
+                key: "f.g"
+                value: <
+                  map_value: <
+                    fields: <
+                      key: "n.o"
+                      value: <
+                        integer_value: 7
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "`a.b`.`f.g`"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-no-paths.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-no-paths.textproto
new file mode 100644
index 000000000000..d9939dc94701
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-no-paths.textproto
@@ -0,0 +1,10 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# It is a client-side error to call Update with empty data.
+
+description: "update-paths: no paths"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-1.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-1.textproto
new file mode 100644
index 000000000000..1710b91097e3
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-1.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In the input data, one field cannot be a prefix of another.
+
+description: "update-paths: prefix #1"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+    field: "b"
+  >
+  field_paths: <
+    field: "a"
+  >
+  json_values: "1"
+  json_values: "2"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-2.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-2.textproto
new file mode 100644
index 000000000000..be78ab58a63b
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-2.textproto
@@ -0,0 +1,19 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In the input data, one field cannot be a prefix of another.
+
+description: "update-paths: prefix #2"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "a"
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "2"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-3.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-3.textproto
new file mode 100644
index 000000000000..b8a84c9d1f80
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-prefix-3.textproto
@@ -0,0 +1,20 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In the input data, one field cannot be a prefix of another, even if the values
+# could in principle be combined.
+
+description: "update-paths: prefix #3"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "a"
+    field: "d"
+  >
+  json_values: "{\"b\": 1}"
+  json_values: "2"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-special-chars.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-special-chars.textproto
new file mode 100644
index 000000000000..51cb33b31268
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-special-chars.textproto
@@ -0,0 +1,53 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# FieldPaths can contain special characters.
+
+description: "update-paths: special characters"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "*"
+    field: "~"
+  >
+  field_paths: <
+    field: "*"
+    field: "`"
+  >
+  json_values: "1"
+  json_values: "2"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "*"
+          value: <
+            map_value: <
+              fields: <
+                key: "`"
+                value: <
+                  integer_value: 2
+                >
+              >
+              fields: <
+                key: "~"
+                value: <
+                  integer_value: 1
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "`*`.`\\``"
+        field_paths: "`*`.`~`"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st-alone.textproto
new file mode 100644
index 000000000000..abc44f55b463
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st-alone.textproto
@@ -0,0 +1,29 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ServerTimestamps, then no update operation
+# should be produced.
+
+description: "update-paths: ServerTimestamp alone"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "\"ServerTimestamp\""
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st-multi.textproto
new file mode 100644
index 000000000000..b0b7df17d836
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st-multi.textproto
@@ -0,0 +1,56 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ServerTimestamp field. Since all the
+# ServerTimestamp fields are removed, the only field in the update is "a".
+
+description: "update-paths: multiple ServerTimestamp fields"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  field_paths: <
+    field: "c"
+  >
+  json_values: "1"
+  json_values: "\"ServerTimestamp\""
+  json_values: "{\"d\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c.d"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st-nested.textproto
new file mode 100644
index 000000000000..3077368318e8
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st-nested.textproto
@@ -0,0 +1,49 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A ServerTimestamp value can occur at any depth. In this case, the transform
+# applies to the field path "b.c". Since "c" is removed from the update, "b"
+# becomes empty, so it is also removed from the update.
+
+description: "update-paths: nested ServerTimestamp field"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "{\"c\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st-noarray-nested.textproto
new file mode 100644
index 000000000000..2c2cb89b62f4
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st-noarray-nested.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ServerTimestamp sentinel. Firestore transforms don't support array indexing.
+
+description: "update-paths: ServerTimestamp cannot be anywhere inside an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, {\"b\": \"ServerTimestamp\"}]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st-noarray.textproto
new file mode 100644
index 000000000000..a2baa66f5762
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st-noarray.textproto
@@ -0,0 +1,15 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. Firestore transforms
+# don't support array indexing.
+
+description: "update-paths: ServerTimestamp cannot be in an array value"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "[1, 2, \"ServerTimestamp\"]"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st-with-empty-map.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st-with-empty-map.textproto
new file mode 100644
index 000000000000..a54a241565de
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st-with-empty-map.textproto
@@ -0,0 +1,51 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When a ServerTimestamp and a map both reside inside a map, the ServerTimestamp
+# should be stripped out but the empty map should remain.
+
+description: "update-paths: ServerTimestamp beside an empty map"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  json_values: "{\"b\": {}, \"c\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  map_value: <
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-st.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-st.textproto
new file mode 100644
index 000000000000..40634c165864
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-st.textproto
@@ -0,0 +1,49 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with the special ServerTimestamp sentinel is removed from the data in the
+# update operation. Instead it appears in a separate Transform operation. Note
+# that in these tests, the string "ServerTimestamp" should be replaced with the
+# special ServerTimestamp value.
+
+description: "update-paths: ServerTimestamp with data"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  field_paths: <
+    field: "a"
+  >
+  field_paths: <
+    field: "b"
+  >
+  json_values: "1"
+  json_values: "\"ServerTimestamp\""
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-paths-uptime.textproto b/firestore/tests/unit/v1beta1/testdata/update-paths-uptime.textproto
new file mode 100644
index 000000000000..7a15874bea64
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-paths-uptime.textproto
@@ -0,0 +1,40 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Update call supports a last-update-time precondition.
+
+description: "update-paths: last-update-time precondition"
+update_paths: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  precondition: <
+    update_time: <
+      seconds: 42
+    >
+  >
+  field_paths: <
+    field: "a"
+  >
+  json_values: "1"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        update_time: <
+          seconds: 42
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-prefix-1.textproto b/firestore/tests/unit/v1beta1/testdata/update-prefix-1.textproto
new file mode 100644
index 000000000000..e5c895e73b49
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-prefix-1.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In the input data, one field cannot be a prefix of another.
+
+description: "update: prefix #1"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a.b\": 1, \"a\": 2}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-prefix-2.textproto b/firestore/tests/unit/v1beta1/testdata/update-prefix-2.textproto
new file mode 100644
index 000000000000..4870176186a7
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-prefix-2.textproto
@@ -0,0 +1,11 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In the input data, one field cannot be a prefix of another.
+
+description: "update: prefix #2"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"a.b\": 2}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-prefix-3.textproto b/firestore/tests/unit/v1beta1/testdata/update-prefix-3.textproto
new file mode 100644
index 000000000000..0c03b0d6b845
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-prefix-3.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In the input data, one field cannot be a prefix of another, even if the values
+# could in principle be combined.
+
+description: "update: prefix #3"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": {\"b\": 1}, \"a.d\": 2}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-quoting.textproto b/firestore/tests/unit/v1beta1/testdata/update-quoting.textproto
new file mode 100644
index 000000000000..20e530a7609a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-quoting.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# In a field path, any component beginning with a non-letter or underscore is
+# quoted.
+
+description: "update: non-letter starting chars are quoted, except underscore"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"_0.1.+2\": 1}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "_0"
+          value: <
+            map_value: <
+              fields: <
+                key: "1"
+                value: <
+                  map_value: <
+                    fields: <
+                      key: "+2"
+                      value: <
+                        integer_value: 1
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "_0.`1`.`+2`"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-split-top-level.textproto b/firestore/tests/unit/v1beta1/testdata/update-split-top-level.textproto
new file mode 100644
index 000000000000..d1b0ca0da163
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-split-top-level.textproto
@@ -0,0 +1,45 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Update method splits only top-level keys at dots. Keys at other levels are
+# taken literally.
+
+description: "update: Split on dots for top-level keys only"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"h.g\": {\"j.k\": 6}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "h"
+          value: <
+            map_value: <
+              fields: <
+                key: "g"
+                value: <
+                  map_value: <
+                    fields: <
+                      key: "j.k"
+                      value: <
+                        integer_value: 6
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "h.g"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-split.textproto b/firestore/tests/unit/v1beta1/testdata/update-split.textproto
new file mode 100644
index 000000000000..b96fd6a4f70a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-split.textproto
@@ -0,0 +1,44 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Update method splits top-level keys at dots.
+
+description: "update: split on dots"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a.b.c\": 1}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  map_value: <
+                    fields: <
+                      key: "c"
+                      value: <
+                        integer_value: 1
+                      >
+                    >
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a.b.c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-alone.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-alone.textproto
new file mode 100644
index 000000000000..0d5ab6e9fbaf
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-alone.textproto
@@ -0,0 +1,26 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# If the only values in the input are ServerTimestamps, then no update operation
+# should be produced.
+
+description: "update: ServerTimestamp alone"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-dot.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-dot.textproto
new file mode 100644
index 000000000000..19d4d18432e7
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-dot.textproto
@@ -0,0 +1,27 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# Like other uses of ServerTimestamp, the data is pruned and the field does not
+# appear in the update mask, because it is in the transform. In this case An
+# update operation is produced just to hold the precondition.
+
+description: "update: ServerTimestamp with dotted field"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a.b.c\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a.b.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+      current_document: <
+        exists: true
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-multi.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-multi.textproto
new file mode 100644
index 000000000000..0434cb59ab5a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-multi.textproto
@@ -0,0 +1,49 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A document can have more than one ServerTimestamp field. Since all the
+# ServerTimestamp fields are removed, the only field in the update is "a".
+
+# b is not in the mask because it will be set in the transform. c must be in the
+# mask: it should be replaced entirely. The transform will set c.d to the
+# timestamp, but the update will delete the rest of c.
+
+description: "update: multiple ServerTimestamp fields"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\", \"c\": {\"d\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "c"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+        field_transforms: <
+          field_path: "c.d"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-nested.textproto
new file mode 100644
index 000000000000..f79d9c6a072a
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-nested.textproto
@@ -0,0 +1,42 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A ServerTimestamp value can occur at any depth. In this case, the transform
+# applies to the field path "b.c". Since "c" is removed from the update, "b"
+# becomes empty, so it is also removed from the update.
+
+description: "update: nested ServerTimestamp field"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": {\"c\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+        field_paths: "b"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-noarray-nested.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-noarray-nested.textproto
new file mode 100644
index 000000000000..2939dd646436
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-noarray-nested.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# There cannot be an array value anywhere on the path from the document root to
+# the ServerTimestamp sentinel. Firestore transforms don't support array indexing.
+
+description: "update: ServerTimestamp cannot be anywhere inside an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, {\"b\": \"ServerTimestamp\"}]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-noarray.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-noarray.textproto
new file mode 100644
index 000000000000..f3879cdf2260
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-noarray.textproto
@@ -0,0 +1,12 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The ServerTimestamp sentinel must be the value of a field. Firestore transforms
+# don't support array indexing.
+
+description: "update: ServerTimestamp cannot be in an array value"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": [1, 2, \"ServerTimestamp\"]}"
+  is_error: true
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st-with-empty-map.textproto b/firestore/tests/unit/v1beta1/testdata/update-st-with-empty-map.textproto
new file mode 100644
index 000000000000..1901de2a15ef
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st-with-empty-map.textproto
@@ -0,0 +1,48 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# When a ServerTimestamp and a map both reside inside a map, the ServerTimestamp
+# should be stripped out but the empty map should remain.
+
+description: "update: ServerTimestamp beside an empty map"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": {\"b\": {}, \"c\": \"ServerTimestamp\"}}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            map_value: <
+              fields: <
+                key: "b"
+                value: <
+                  map_value: <
+                  >
+                >
+              >
+            >
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "a.c"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-st.textproto b/firestore/tests/unit/v1beta1/testdata/update-st.textproto
new file mode 100644
index 000000000000..12045a9220dc
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-st.textproto
@@ -0,0 +1,42 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# A key with the special ServerTimestamp sentinel is removed from the data in the
+# update operation. Instead it appears in a separate Transform operation. Note
+# that in these tests, the string "ServerTimestamp" should be replaced with the
+# special ServerTimestamp value.
+
+description: "update: ServerTimestamp with data"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  json_data: "{\"a\": 1, \"b\": \"ServerTimestamp\"}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        exists: true
+      >
+    >
+    writes: <
+      transform: <
+        document: "projects/projectID/databases/(default)/documents/C/d"
+        field_transforms: <
+          field_path: "b"
+          set_to_server_value: REQUEST_TIME
+        >
+      >
+    >
+  >
+>
diff --git a/firestore/tests/unit/v1beta1/testdata/update-uptime.textproto b/firestore/tests/unit/v1beta1/testdata/update-uptime.textproto
new file mode 100644
index 000000000000..66119ac61c13
--- /dev/null
+++ b/firestore/tests/unit/v1beta1/testdata/update-uptime.textproto
@@ -0,0 +1,37 @@
+# DO NOT MODIFY. This file was generated by
+# github.com/GoogleCloudPlatform/google-cloud-common/testing/firestore/cmd/generate-firestore-tests/generate-firestore-tests.go.
+
+# The Update call supports a last-update-time precondition.
+
+description: "update: last-update-time precondition"
+update: <
+  doc_ref_path: "projects/projectID/databases/(default)/documents/C/d"
+  precondition: <
+    update_time: <
+      seconds: 42
+    >
+  >
+  json_data: "{\"a\": 1}"
+  request: <
+    database: "projects/projectID/databases/(default)"
+    writes: <
+      update: <
+        name: "projects/projectID/databases/(default)/documents/C/d"
+        fields: <
+          key: "a"
+          value: <
+            integer_value: 1
+          >
+        >
+      >
+      update_mask: <
+        field_paths: "a"
+      >
+      current_document: <
+        update_time: <
+          seconds: 42
+        >
+      >
+    >
+  >
+>
diff --git a/google/__init__.py b/google/__init__.py
deleted file mode 100644
index 14aa202c24c1..000000000000
--- a/google/__init__.py
+++ /dev/null
@@ -1,22 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Base ``google`` namespace package."""
-
-try:
-    import pkg_resources
-    pkg_resources.declare_namespace(__name__)
-except ImportError:
-    import pkgutil
-    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/google/cloud/__init__.py b/google/cloud/__init__.py
deleted file mode 100644
index 1768fdd079a2..000000000000
--- a/google/cloud/__init__.py
+++ /dev/null
@@ -1,22 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Google Cloud API access in idiomatic Python."""
-
-try:
-    import pkg_resources
-    pkg_resources.declare_namespace(__name__)
-except ImportError:
-    import pkgutil
-    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/google/cloud/_helpers.py b/google/cloud/_helpers.py
deleted file mode 100644
index 3b214db77b82..000000000000
--- a/google/cloud/_helpers.py
+++ /dev/null
@@ -1,690 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Shared helpers for Google Cloud packages.
-
-This module is not part of the public API surface.
-"""
-
-import calendar
-import datetime
-import json
-import os
-import re
-import socket
-from threading import local as Local
-
-from google.protobuf import timestamp_pb2
-try:
-    from google.appengine.api import app_identity
-except ImportError:
-    app_identity = None
-try:
-    import grpc
-except ImportError:  # pragma: NO COVER
-    grpc = None
-import six
-from six.moves import http_client
-from six.moves import configparser
-
-# pylint: disable=ungrouped-imports
-from google.cloud.environment_vars import PROJECT
-from google.cloud.environment_vars import CREDENTIALS
-# pylint: enable=ungrouped-imports
-
-
-_NOW = datetime.datetime.utcnow  # To be replaced by tests.
-_RFC3339_MICROS = '%Y-%m-%dT%H:%M:%S.%fZ'
-_RFC3339_NO_FRACTION = '%Y-%m-%dT%H:%M:%S'
-# datetime.strptime cannot handle nanosecond precision:  parse w/ regex
-_RFC3339_NANOS = re.compile(r"""
-    (?P<no_fraction>
-        \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}  # YYYY-MM-DDTHH:MM:SS
-    )
-    \.                                       # decimal point
-    (?P<nanos>\d{1,9})                       # nanoseconds, maybe truncated
-    Z                                        # Zulu
-""", re.VERBOSE)
-# NOTE: Catching this ImportError is a workaround for GAE not supporting the
-#       "pwd" module which is imported lazily when "expanduser" is called.
-try:
-    _USER_ROOT = os.path.expanduser('~')
-except ImportError:  # pragma: NO COVER
-    _USER_ROOT = None
-_GCLOUD_CONFIG_FILE = os.path.join(
-    'gcloud', 'configurations', 'config_default')
-_GCLOUD_CONFIG_SECTION = 'core'
-_GCLOUD_CONFIG_KEY = 'project'
-
-
-class _LocalStack(Local):
-    """Manage a thread-local LIFO stack of resources.
-
-    Intended for use in :class:`google.cloud.datastore.batch.Batch.__enter__`,
-    :class:`google.cloud.storage.batch.Batch.__enter__`, etc.
-    """
-    def __init__(self):
-        super(_LocalStack, self).__init__()
-        self._stack = []
-
-    def __iter__(self):
-        """Iterate the stack in LIFO order.
-        """
-        return iter(reversed(self._stack))
-
-    def push(self, resource):
-        """Push a resource onto our stack.
-        """
-        self._stack.append(resource)
-
-    def pop(self):
-        """Pop a resource from our stack.
-
-        :rtype: object
-        :returns: the top-most resource, after removing it.
-        :raises IndexError: if the stack is empty.
-        """
-        return self._stack.pop()
-
-    @property
-    def top(self):
-        """Get the top-most resource
-
-        :rtype: object
-        :returns: the top-most item, or None if the stack is empty.
-        """
-        if len(self._stack) > 0:
-            return self._stack[-1]
-
-
-class _UTC(datetime.tzinfo):
-    """Basic UTC implementation.
-
-    Implementing a small surface area to avoid depending on ``pytz``.
-    """
-
-    _dst = datetime.timedelta(0)
-    _tzname = 'UTC'
-    _utcoffset = _dst
-
-    def dst(self, dt):  # pylint: disable=unused-argument
-        """Daylight savings time offset."""
-        return self._dst
-
-    def fromutc(self, dt):
-        """Convert a timestamp from (naive) UTC to this timezone."""
-        if dt.tzinfo is None:
-            return dt.replace(tzinfo=self)
-        return super(_UTC, self).fromutc(dt)
-
-    def tzname(self, dt):  # pylint: disable=unused-argument
-        """Get the name of this timezone."""
-        return self._tzname
-
-    def utcoffset(self, dt):  # pylint: disable=unused-argument
-        """UTC offset of this timezone."""
-        return self._utcoffset
-
-    def __repr__(self):
-        return '<%s>' % (self._tzname,)
-
-    def __str__(self):
-        return self._tzname
-
-
-def _ensure_tuple_or_list(arg_name, tuple_or_list):
-    """Ensures an input is a tuple or list.
-
-    This effectively reduces the iterable types allowed to a very short
-    whitelist: list and tuple.
-
-    :type arg_name: str
-    :param arg_name: Name of argument to use in error message.
-
-    :type tuple_or_list: sequence of str
-    :param tuple_or_list: Sequence to be verified.
-
-    :rtype: list of str
-    :returns: The ``tuple_or_list`` passed in cast to a ``list``.
-    :raises TypeError: if the ``tuple_or_list`` is not a tuple or list.
-    """
-    if not isinstance(tuple_or_list, (tuple, list)):
-        raise TypeError('Expected %s to be a tuple or list. '
-                        'Received %r' % (arg_name, tuple_or_list))
-    return list(tuple_or_list)
-
-
-def _app_engine_id():
-    """Gets the App Engine application ID if it can be inferred.
-
-    :rtype: str or ``NoneType``
-    :returns: App Engine application ID if running in App Engine,
-              else ``None``.
-    """
-    if app_identity is None:
-        return None
-
-    return app_identity.get_application_id()
-
-
-def _file_project_id():
-    """Gets the project ID from the credentials file if one is available.
-
-    :rtype: str or ``NoneType``
-    :returns: Project ID from JSON credentials file if value exists,
-              else ``None``.
-    """
-    credentials_file_path = os.getenv(CREDENTIALS)
-    if credentials_file_path:
-        with open(credentials_file_path, 'rb') as credentials_file:
-            credentials_json = credentials_file.read()
-            credentials = json.loads(credentials_json.decode('utf-8'))
-            return credentials.get('project_id')
-
-
-def _get_nix_config_path():
-    """Get the ``gcloud`` CLI config path on *nix systems.
-
-    :rtype: str
-    :returns: The filename on a *nix system containing the CLI
-              config file.
-    """
-    return os.path.join(_USER_ROOT, '.config', _GCLOUD_CONFIG_FILE)
-
-
-def _get_windows_config_path():
-    """Get the ``gcloud`` CLI config path on Windows systems.
-
-    :rtype: str
-    :returns: The filename on a Windows system containing the CLI
-              config file.
-    """
-    appdata_dir = os.getenv('APPDATA', '')
-    return os.path.join(appdata_dir, _GCLOUD_CONFIG_FILE)
-
-
-def _default_service_project_id():
-    """Retrieves the project ID from the gcloud command line tool.
-
-    This assumes the ``.config`` directory is stored
-    - in ~/.config on *nix systems
-    - in the %APPDATA% directory on Windows systems
-
-    Additionally, the ${HOME} / "~" directory may not be present on Google
-    App Engine, so this may be conditionally ignored.
-
-    Files that cannot be opened with configparser are silently ignored; this is
-    designed so that you can specify a list of potential configuration file
-    locations.
-
-    :rtype: str or ``NoneType``
-    :returns: Project-ID from default configuration file else ``None``
-    """
-    search_paths = []
-    if _USER_ROOT is not None:
-        search_paths.append(_get_nix_config_path())
-
-    if os.name == 'nt':
-        search_paths.append(_get_windows_config_path())
-
-    config = configparser.RawConfigParser()
-    config.read(search_paths)
-
-    if config.has_section(_GCLOUD_CONFIG_SECTION):
-        return config.get(_GCLOUD_CONFIG_SECTION, _GCLOUD_CONFIG_KEY)
-
-
-def _compute_engine_id():
-    """Gets the Compute Engine project ID if it can be inferred.
-
-    Uses 169.254.169.254 for the metadata server to avoid request
-    latency from DNS lookup.
-
-    See https://cloud.google.com/compute/docs/metadata#metadataserver
-    for information about this IP address. (This IP is also used for
-    Amazon EC2 instances, so the metadata flavor is crucial.)
-
-    See https://github.com/google/oauth2client/issues/93 for context about
-    DNS latency.
-
-    :rtype: str or ``NoneType``
-    :returns: Compute Engine project ID if the metadata service is available,
-              else ``None``.
-    """
-    host = '169.254.169.254'
-    uri_path = '/computeMetadata/v1/project/project-id'
-    headers = {'Metadata-Flavor': 'Google'}
-    connection = http_client.HTTPConnection(host, timeout=0.1)
-
-    try:
-        connection.request('GET', uri_path, headers=headers)
-        response = connection.getresponse()
-        if response.status == 200:
-            return response.read()
-    except socket.error:  # socket.timeout or socket.error(64, 'Host is down')
-        pass
-    finally:
-        connection.close()
-
-
-def _get_production_project():
-    """Gets the production project if it can be inferred."""
-    return os.getenv(PROJECT)
-
-
-def _determine_default_project(project=None):
-    """Determine default project ID explicitly or implicitly as fall-back.
-
-    In implicit case, supports three environments. In order of precedence, the
-    implicit environments are:
-
-    * GOOGLE_CLOUD_PROJECT environment variable
-    * GOOGLE_APPLICATION_CREDENTIALS JSON file
-    * Get default service project from
-      ``$ gcloud beta auth application-default login``
-    * Google App Engine application ID
-    * Google Compute Engine project ID (from metadata server)
-
-    :type project: str
-    :param project: Optional. The project name to use as default.
-
-    :rtype: str or ``NoneType``
-    :returns: Default project if it can be determined.
-    """
-    if project is None:
-        project = _get_production_project()
-
-    if project is None:
-        project = _file_project_id()
-
-    if project is None:
-        project = _default_service_project_id()
-
-    if project is None:
-        project = _app_engine_id()
-
-    if project is None:
-        project = _compute_engine_id()
-
-    return project
-
-
-def _millis(when):
-    """Convert a zone-aware datetime to integer milliseconds.
-
-    :type when: :class:`datetime.datetime`
-    :param when: the datetime to convert
-
-    :rtype: int
-    :returns: milliseconds since epoch for ``when``
-    """
-    micros = _microseconds_from_datetime(when)
-    return micros // 1000
-
-
-def _datetime_from_microseconds(value):
-    """Convert timestamp to datetime, assuming UTC.
-
-    :type value: float
-    :param value: The timestamp to convert
-
-    :rtype: :class:`datetime.datetime`
-    :returns: The datetime object created from the value.
-    """
-    return _EPOCH + datetime.timedelta(microseconds=value)
-
-
-def _microseconds_from_datetime(value):
-    """Convert non-none datetime to microseconds.
-
-    :type value: :class:`datetime.datetime`
-    :param value: The timestamp to convert.
-
-    :rtype: int
-    :returns: The timestamp, in microseconds.
-    """
-    if not value.tzinfo:
-        value = value.replace(tzinfo=UTC)
-    # Regardless of what timezone is on the value, convert it to UTC.
-    value = value.astimezone(UTC)
-    # Convert the datetime to a microsecond timestamp.
-    return int(calendar.timegm(value.timetuple()) * 1e6) + value.microsecond
-
-
-def _millis_from_datetime(value):
-    """Convert non-none datetime to timestamp, assuming UTC.
-
-    :type value: :class:`datetime.datetime`, or None
-    :param value: the timestamp
-
-    :rtype: int, or ``NoneType``
-    :returns: the timestamp, in milliseconds, or None
-    """
-    if value is not None:
-        return _millis(value)
-
-
-def _date_from_iso8601_date(value):
-    """Convert a ISO8601 date string to native datetime date
-
-    :type value: str
-    :param value: The date string to convert
-
-    :rtype: :class:`datetime.date`
-    :returns: A datetime date object created from the string
-
-    """
-    return datetime.datetime.strptime(value, '%Y-%m-%d').date()
-
-
-def _rfc3339_to_datetime(dt_str):
-    """Convert a microsecond-precision timetamp to a native datetime.
-
-    :type dt_str: str
-    :param dt_str: The string to convert.
-
-    :rtype: :class:`datetime.datetime`
-    :returns: The datetime object created from the string.
-    """
-    return datetime.datetime.strptime(
-        dt_str, _RFC3339_MICROS).replace(tzinfo=UTC)
-
-
-def _rfc3339_nanos_to_datetime(dt_str):
-    """Convert a nanosecond-precision timestamp to a native datetime.
-
-    .. note::
-
-       Python datetimes do not support nanosecond precision;  this function
-       therefore truncates such values to microseconds.
-
-    :type dt_str: str
-    :param dt_str: The string to convert.
-
-    :rtype: :class:`datetime.datetime`
-    :returns: The datetime object created from the string.
-    :raises ValueError: If the timestamp does not match the RFC 3339
-                        regular expression.
-    """
-    with_nanos = _RFC3339_NANOS.match(dt_str)
-    if with_nanos is None:
-        raise ValueError(
-            'Timestamp: %r, does not match pattern: %r' % (
-                dt_str, _RFC3339_NANOS.pattern))
-    bare_seconds = datetime.datetime.strptime(
-        with_nanos.group('no_fraction'), _RFC3339_NO_FRACTION)
-    fraction = with_nanos.group('nanos')
-    scale = 9 - len(fraction)
-    nanos = int(fraction) * (10 ** scale)
-    micros = nanos // 1000
-    return bare_seconds.replace(microsecond=micros, tzinfo=UTC)
-
-
-def _datetime_to_rfc3339(value, ignore_zone=True):
-    """Convert a timestamp to a string.
-
-    :type value: :class:`datetime.datetime`
-    :param value: The datetime object to be converted to a string.
-
-    :type ignore_zone: boolean
-    :param ignore_zone: If True, then the timezone (if any) of the datetime
-                        object is ignored.
-
-    :rtype: str
-    :returns: The string representing the datetime stamp.
-    """
-    if not ignore_zone and value.tzinfo is not None:
-        # Convert to UTC and remove the time zone info.
-        value = value.replace(tzinfo=None) - value.utcoffset()
-
-    return value.strftime(_RFC3339_MICROS)
-
-
-def _to_bytes(value, encoding='ascii'):
-    """Converts a string value to bytes, if necessary.
-
-    Unfortunately, ``six.b`` is insufficient for this task since in
-    Python2 it does not modify ``unicode`` objects.
-
-    :type value: str / bytes or unicode
-    :param value: The string/bytes value to be converted.
-
-    :type encoding: str
-    :param encoding: The encoding to use to convert unicode to bytes. Defaults
-                     to "ascii", which will not allow any characters from
-                     ordinals larger than 127. Other useful values are
-                     "latin-1", which which will only allows byte ordinals
-                     (up to 255) and "utf-8", which will encode any unicode
-                     that needs to be.
-
-    :rtype: str / bytes
-    :returns: The original value converted to bytes (if unicode) or as passed
-              in if it started out as bytes.
-    :raises TypeError: if the value could not be converted to bytes.
-    """
-    result = (value.encode(encoding)
-              if isinstance(value, six.text_type) else value)
-    if isinstance(result, six.binary_type):
-        return result
-    else:
-        raise TypeError('%r could not be converted to bytes' % (value,))
-
-
-def _bytes_to_unicode(value):
-    """Converts bytes to a unicode value, if necessary.
-
-    :type value: bytes
-    :param value: bytes value to attempt string conversion on.
-
-    :rtype: str
-    :returns: The original value converted to unicode (if bytes) or as passed
-              in if it started out as unicode.
-
-    :raises ValueError: if the value could not be converted to unicode.
-    """
-    result = (value.decode('utf-8')
-              if isinstance(value, six.binary_type) else value)
-    if isinstance(result, six.text_type):
-        return result
-    else:
-        raise ValueError('%r could not be converted to unicode' % (value,))
-
-
-def _pb_timestamp_to_datetime(timestamp_pb):
-    """Convert a Timestamp protobuf to a datetime object.
-
-    :type timestamp_pb: :class:`google.protobuf.timestamp_pb2.Timestamp`
-    :param timestamp_pb: A Google returned timestamp protobuf.
-
-    :rtype: :class:`datetime.datetime`
-    :returns: A UTC datetime object converted from a protobuf timestamp.
-    """
-    return (
-        _EPOCH +
-        datetime.timedelta(
-            seconds=timestamp_pb.seconds,
-            microseconds=(timestamp_pb.nanos / 1000.0),
-        )
-    )
-
-
-def _pb_timestamp_to_rfc3339(timestamp_pb):
-    """Convert a Timestamp protobuf to an RFC 3339 string.
-
-    :type timestamp_pb: :class:`google.protobuf.timestamp_pb2.Timestamp`
-    :param timestamp_pb: A Google returned timestamp protobuf.
-
-    :rtype: string
-    :returns: An RFC 3339 formatted timestamp string.
-    """
-    timestamp = _pb_timestamp_to_datetime(timestamp_pb)
-    return _datetime_to_rfc3339(timestamp)
-
-
-def _datetime_to_pb_timestamp(when):
-    """Convert a datetime object to a Timestamp protobuf.
-
-    :type when: :class:`datetime.datetime`
-    :param when: the datetime to convert
-
-    :rtype: :class:`google.protobuf.timestamp_pb2.Timestamp`
-    :returns: A timestamp protobuf corresponding to the object.
-    """
-    ms_value = _microseconds_from_datetime(when)
-    seconds, micros = divmod(ms_value, 10**6)
-    nanos = micros * 10**3
-    return timestamp_pb2.Timestamp(seconds=seconds, nanos=nanos)
-
-
-def _name_from_project_path(path, project, template):
-    """Validate a URI path and get the leaf object's name.
-
-    :type path: str
-    :param path: URI path containing the name.
-
-    :type project: str or NoneType
-    :param project: The project associated with the request. It is
-                    included for validation purposes.  If passed as None,
-                    disables validation.
-
-    :type template: str
-    :param template: Template regex describing the expected form of the path.
-                     The regex must have two named groups, 'project' and
-                     'name'.
-
-    :rtype: str
-    :returns: Name parsed from ``path``.
-    :raises ValueError: if the ``path`` is ill-formed or if the project from
-                        the ``path`` does not agree with the ``project``
-                        passed in.
-    """
-    if isinstance(template, str):
-        template = re.compile(template)
-
-    match = template.match(path)
-
-    if not match:
-        raise ValueError('path "%s" did not match expected pattern "%s"' % (
-            path, template.pattern,))
-
-    if project is not None:
-        found_project = match.group('project')
-        if found_project != project:
-            raise ValueError(
-                'Project from client (%s) should agree with '
-                'project from resource(%s).' % (project, found_project))
-
-    return match.group('name')
-
-
-class MetadataPlugin(object):
-    """Callable class to transform metadata for gRPC requests.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: The OAuth2 Credentials to use for creating
-                        access tokens.
-    """
-
-    def __init__(self, credentials):
-        self._credentials = credentials
-
-    def __call__(self, unused_context, callback):
-        """Adds authorization header to request metadata.
-
-        :type unused_context: object
-        :param unused_context: A gRPC context which is not needed
-                               to modify headers.
-
-        :type callback: callable
-        :param callback: A callback which will use the headers.
-        """
-        access_token = self._credentials.get_access_token().access_token
-        headers = [
-            ('authorization', 'Bearer ' + access_token),
-        ]
-        callback(headers, None)
-
-
-def make_secure_stub(credentials, user_agent, stub_class, host):
-    """Makes a secure stub for an RPC service.
-
-    Uses / depends on gRPC.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: The OAuth2 Credentials to use for creating
-                        access tokens.
-
-    :type user_agent: str
-    :param user_agent: (Optional) The user agent to be used with API requests.
-
-    :type stub_class: type
-    :param stub_class: A gRPC stub type for a given service.
-
-    :type host: str
-    :param host: The host for the service.
-
-    :rtype: object, instance of ``stub_class``
-    :returns: The stub object used to make gRPC requests to a given API.
-    """
-    # ssl_channel_credentials() loads root certificates from
-    # `grpc/_adapter/credentials/roots.pem`.
-    transport_creds = grpc.ssl_channel_credentials()
-    custom_metadata_plugin = MetadataPlugin(credentials)
-    auth_creds = grpc.metadata_call_credentials(
-        custom_metadata_plugin, name='google_creds')
-    channel_creds = grpc.composite_channel_credentials(
-        transport_creds, auth_creds)
-    target = '%s:%d' % (host, http_client.HTTPS_PORT)
-    channel_args = (
-        ('grpc.primary_user_agent', user_agent),
-    )
-    channel = grpc.secure_channel(target, channel_creds,
-                                  options=channel_args)
-    return stub_class(channel)
-
-
-def make_insecure_stub(stub_class, host, port=None):
-    """Makes an insecure stub for an RPC service.
-
-    Uses / depends on gRPC.
-
-    :type stub_class: type
-    :param stub_class: A gRPC stub type for a given service.
-
-    :type host: str
-    :param host: The host for the service. May also include the port
-                 if ``port`` is unspecified.
-
-    :type port: int
-    :param port: (Optional) The port for the service.
-
-    :rtype: object, instance of ``stub_class``
-    :returns: The stub object used to make gRPC requests to a given API.
-    """
-    if port is None:
-        target = host
-    else:
-        # NOTE: This assumes port != http_client.HTTPS_PORT:
-        target = '%s:%d' % (host, port)
-    channel = grpc.insecure_channel(target)
-    return stub_class(channel)
-
-
-try:
-    from pytz import UTC  # pylint: disable=unused-import,wrong-import-order
-except ImportError:
-    UTC = _UTC()  # Singleton instance to be used throughout.
-
-# Need to define _EPOCH at the end of module since it relies on UTC.
-_EPOCH = datetime.datetime.utcfromtimestamp(0).replace(tzinfo=UTC)
diff --git a/google/cloud/bigquery/__init__.py b/google/cloud/bigquery/__init__.py
deleted file mode 100644
index fd358aa9f54b..000000000000
--- a/google/cloud/bigquery/__init__.py
+++ /dev/null
@@ -1,34 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Google Cloud BigQuery API wrapper.
-
-The main concepts with this API are:
-
-- :class:`~google.cloud.bigquery.dataset.Dataset` represents a
-  collection of tables.
-
-- :class:`~google.cloud.bigquery.table.Table` represents a single "relation".
-"""
-
-
-from google.cloud.bigquery.client import Client
-from google.cloud.bigquery.connection import Connection
-from google.cloud.bigquery.dataset import AccessGrant
-from google.cloud.bigquery.dataset import Dataset
-from google.cloud.bigquery.schema import SchemaField
-from google.cloud.bigquery.table import Table
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/bigquery/_helpers.py b/google/cloud/bigquery/_helpers.py
deleted file mode 100644
index 181734f5b75e..000000000000
--- a/google/cloud/bigquery/_helpers.py
+++ /dev/null
@@ -1,229 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Shared helper functions for BigQuery API classes."""
-
-from google.cloud._helpers import _datetime_from_microseconds
-from google.cloud._helpers import _date_from_iso8601_date
-
-
-def _not_null(value, field):
-    """Check whether 'value' should be coerced to 'field' type."""
-    return value is not None or field.mode != 'NULLABLE'
-
-
-def _int_from_json(value, field):
-    """Coerce 'value' to an int, if set or not nullable."""
-    if _not_null(value, field):
-        return int(value)
-
-
-def _float_from_json(value, field):
-    """Coerce 'value' to a float, if set or not nullable."""
-    if _not_null(value, field):
-        return float(value)
-
-
-def _bool_from_json(value, field):
-    """Coerce 'value' to a bool, if set or not nullable."""
-    if _not_null(value, field):
-        return value.lower() in ['t', 'true', '1']
-
-
-def _datetime_from_json(value, field):
-    """Coerce 'value' to a datetime, if set or not nullable."""
-    if _not_null(value, field):
-        # value will be a float in seconds, to microsecond precision, in UTC.
-        return _datetime_from_microseconds(1e6 * float(value))
-
-
-def _date_from_json(value, field):
-    """Coerce 'value' to a datetime date, if set or not nullable"""
-    if _not_null(value, field):
-        return _date_from_iso8601_date(value)
-
-
-def _record_from_json(value, field):
-    """Coerce 'value' to a mapping, if set or not nullable."""
-    if _not_null(value, field):
-        record = {}
-        for subfield, cell in zip(field.fields, value['f']):
-            converter = _CELLDATA_FROM_JSON[subfield.field_type]
-            if field.mode == 'REPEATED':
-                value = [converter(item, subfield) for item in cell['v']]
-            else:
-                value = converter(cell['v'], subfield)
-            record[subfield.name] = value
-        return record
-
-
-def _string_from_json(value, _):
-    """NOOP string -> string coercion"""
-    return value
-
-
-_CELLDATA_FROM_JSON = {
-    'INTEGER': _int_from_json,
-    'INT64': _int_from_json,
-    'FLOAT': _float_from_json,
-    'FLOAT64': _float_from_json,
-    'BOOLEAN': _bool_from_json,
-    'TIMESTAMP': _datetime_from_json,
-    'DATE': _date_from_json,
-    'RECORD': _record_from_json,
-    'STRING': _string_from_json,
-}
-
-
-def _rows_from_json(rows, schema):
-    """Convert JSON row data to rows w/ appropriate types."""
-    rows_data = []
-    for row in rows:
-        row_data = []
-        for field, cell in zip(schema, row['f']):
-            converter = _CELLDATA_FROM_JSON[field.field_type]
-            if field.mode == 'REPEATED':
-                row_data.append([converter(item, field)
-                                 for item in cell['v']])
-            else:
-                row_data.append(converter(cell['v'], field))
-        rows_data.append(tuple(row_data))
-    return rows_data
-
-
-class _ConfigurationProperty(object):
-    """Base property implementation.
-
-    Values will be stored on a `_configuration` helper attribute of the
-    property's job instance.
-
-    :type name: string
-    :param name:  name of the property
-    """
-
-    def __init__(self, name):
-        self.name = name
-        self._backing_name = '_%s' % (self.name,)
-
-    def __get__(self, instance, owner):
-        """Descriptor protocal:  accesstor"""
-        if instance is None:
-            return self
-        return getattr(instance._configuration, self._backing_name)
-
-    def _validate(self, value):
-        """Subclasses override to impose validation policy."""
-        pass
-
-    def __set__(self, instance, value):
-        """Descriptor protocal:  mutator"""
-        self._validate(value)
-        setattr(instance._configuration, self._backing_name, value)
-
-    def __delete__(self, instance):
-        """Descriptor protocal:  deleter"""
-        delattr(instance._configuration, self._backing_name)
-
-
-class _TypedProperty(_ConfigurationProperty):
-    """Property implementation:  validates based on value type.
-
-    :type name: string
-    :param name:  name of the property
-
-    :type property_type: type or sequence of types
-    :param property_type: type to be validated
-    """
-    def __init__(self, name, property_type):
-        super(_TypedProperty, self).__init__(name)
-        self.property_type = property_type
-
-    def _validate(self, value):
-        """Ensure that 'value' is of the appropriate type.
-
-        :raises: ValueError on a type mismatch.
-        """
-        if not isinstance(value, self.property_type):
-            raise ValueError('Required type: %s' % (self.property_type,))
-
-
-class _EnumProperty(_ConfigurationProperty):
-    """Pseudo-enumeration class.
-
-    Subclasses must define ``ALLOWED`` as a class-level constant:  it must
-    be a sequence of strings.
-
-    :type name: string
-    :param name:  name of the property.
-    """
-    def _validate(self, value):
-        """Check that ``value`` is one of the allowed values.
-
-        :raises: ValueError if value is not allowed.
-        """
-        if value not in self.ALLOWED:
-            raise ValueError('Pass one of: %s' ', '.join(self.ALLOWED))
-
-
-class UDFResource(object):
-    """Describe a single user-defined function (UDF) resource.
-
-    :type udf_type: str
-    :param udf_type: the type of the resource ('inlineCode' or 'resourceUri')
-
-    :type value: str
-    :param value: the inline code or resource URI.
-
-    See
-    https://cloud.google.com/bigquery/user-defined-functions#api
-    """
-    def __init__(self, udf_type, value):
-        self.udf_type = udf_type
-        self.value = value
-
-    def __eq__(self, other):
-        return(
-            self.udf_type == other.udf_type and
-            self.value == other.value)
-
-
-class UDFResourcesProperty(object):
-    """Custom property type, holding :class:`UDFResource` instances."""
-
-    def __get__(self, instance, owner):
-        """Descriptor protocol:  accessor"""
-        if instance is None:
-            return self
-        return list(instance._udf_resources)
-
-    def __set__(self, instance, value):
-        """Descriptor protocol:  mutator"""
-        if not all(isinstance(u, UDFResource) for u in value):
-            raise ValueError("udf items must be UDFResource")
-        instance._udf_resources = tuple(value)
-
-
-def _build_udf_resources(resources):
-    """
-    :type resources: sequence of :class:`UDFResource`
-    :param resources: fields to be appended.
-
-    :rtype: mapping
-    :returns: a mapping describing userDefinedFunctionResources for the query.
-    """
-    udfs = []
-    for resource in resources:
-        udf = {resource.udf_type: resource.value}
-        udfs.append(udf)
-    return udfs
diff --git a/google/cloud/bigquery/client.py b/google/cloud/bigquery/client.py
deleted file mode 100644
index a9473863d7cd..000000000000
--- a/google/cloud/bigquery/client.py
+++ /dev/null
@@ -1,336 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Client for interacting with the Google BigQuery API."""
-
-
-from google.cloud.client import JSONClient
-from google.cloud.bigquery.connection import Connection
-from google.cloud.bigquery.dataset import Dataset
-from google.cloud.bigquery.job import CopyJob
-from google.cloud.bigquery.job import ExtractTableToStorageJob
-from google.cloud.bigquery.job import LoadTableFromStorageJob
-from google.cloud.bigquery.job import QueryJob
-from google.cloud.bigquery.query import QueryResults
-
-
-class Project(object):
-    """Wrapper for resource describing a BigQuery project.
-
-    :type project_id: str
-    :param project_id: Opaque ID of the project
-
-    :type numeric_id: int
-    :param numeric_id: Numeric ID of the project
-
-    :type friendly_name: str
-    :param friendly_name: Display name of the project
-    """
-    def __init__(self, project_id, numeric_id, friendly_name):
-        self.project_id = project_id
-        self.numeric_id = numeric_id
-        self.friendly_name = friendly_name
-
-    @classmethod
-    def from_api_repr(cls, resource):
-        """Factory: construct an instance from a resource dict."""
-        return cls(
-            resource['id'], resource['numericId'], resource['friendlyName'])
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: str
-    :param project: the project which the client acts on behalf of. Will be
-                    passed when creating a dataset / job.  If not passed,
-                    falls back to the default inferred from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def list_projects(self, max_results=None, page_token=None):
-        """List projects for the project associated with this client.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/projects/list
-
-        :type max_results: int
-        :param max_results: maximum number of projects to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of projects. If
-                           not passed, the API will return the first page of
-                           projects.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`~google.cloud.bigquery.client.Project`,
-                  plus a "next page token" string:  if the token is not None,
-                  indicates that more projects can be retrieved with another
-                  call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects'
-        resp = self.connection.api_request(method='GET', path=path,
-                                           query_params=params)
-        projects = [Project.from_api_repr(resource)
-                    for resource in resp.get('projects', ())]
-        return projects, resp.get('nextPageToken')
-
-    def list_datasets(self, include_all=False, max_results=None,
-                      page_token=None):
-        """List datasets for the project associated with this client.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/datasets/list
-
-        :type include_all: boolean
-        :param include_all: True if results include hidden datasets.
-
-        :type max_results: int
-        :param max_results: maximum number of datasets to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of datasets. If
-                           not passed, the API will return the first page of
-                           datasets.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`~google.cloud.bigquery.dataset.Dataset`,
-                  plus a "next page token" string:  if the token is not None,
-                  indicates that more datasets can be retrieved with another
-                  call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if include_all:
-            params['all'] = True
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/datasets' % (self.project,)
-        resp = self.connection.api_request(method='GET', path=path,
-                                           query_params=params)
-        datasets = [Dataset.from_api_repr(resource, self)
-                    for resource in resp.get('datasets', ())]
-        return datasets, resp.get('nextPageToken')
-
-    def dataset(self, dataset_name):
-        """Construct a dataset bound to this client.
-
-        :type dataset_name: str
-        :param dataset_name: Name of the dataset.
-
-        :rtype: :class:`google.cloud.bigquery.dataset.Dataset`
-        :returns: a new ``Dataset`` instance
-        """
-        return Dataset(dataset_name, client=self)
-
-    def job_from_resource(self, resource):
-        """Detect correct job type from resource and instantiate.
-
-        :type resource: dict
-        :param resource: one job resource from API response
-
-        :rtype: One of:
-                :class:`google.cloud.bigquery.job.LoadTableFromStorageJob`,
-                :class:`google.cloud.bigquery.job.CopyJob`,
-                :class:`google.cloud.bigquery.job.ExtractTableToStorageJob`,
-                :class:`google.cloud.bigquery.job.QueryJob`,
-                :class:`google.cloud.bigquery.job.RunSyncQueryJob`
-        :returns: the job instance, constructed via the resource
-        """
-        config = resource['configuration']
-        if 'load' in config:
-            return LoadTableFromStorageJob.from_api_repr(resource, self)
-        elif 'copy' in config:
-            return CopyJob.from_api_repr(resource, self)
-        elif 'extract' in config:
-            return ExtractTableToStorageJob.from_api_repr(resource, self)
-        elif 'query' in config:
-            return QueryJob.from_api_repr(resource, self)
-        raise ValueError('Cannot parse job resource')
-
-    def list_jobs(self, max_results=None, page_token=None, all_users=None,
-                  state_filter=None):
-        """List jobs for the project associated with this client.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/list
-
-        :type max_results: int
-        :param max_results: maximum number of jobs to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of jobs. If
-                           not passed, the API will return the first page of
-                           jobs.
-
-        :type all_users: boolean
-        :param all_users: if true, include jobs owned by all users in the
-                          project.
-
-        :type state_filter: str
-        :param state_filter: if passed, include only jobs matching the given
-                             state.  One of
-
-                             * ``"done"``
-                             * ``"pending"``
-                             * ``"running"``
-
-        :rtype: tuple, (list, str)
-        :returns: list of job instances, plus a "next page token" string:
-                  if the token is not ``None``, indicates that more jobs can be
-                  retrieved with another call, passing that value as
-                  ``page_token``).
-        """
-        params = {'projection': 'full'}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        if all_users is not None:
-            params['allUsers'] = all_users
-
-        if state_filter is not None:
-            params['stateFilter'] = state_filter
-
-        path = '/projects/%s/jobs' % (self.project,)
-        resp = self.connection.api_request(method='GET', path=path,
-                                           query_params=params)
-        jobs = [self.job_from_resource(resource)
-                for resource in resp.get('jobs', ())]
-        return jobs, resp.get('nextPageToken')
-
-    def load_table_from_storage(self, job_name, destination, *source_uris):
-        """Construct a job for loading data into a table from CloudStorage.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load
-
-        :type job_name: str
-        :param job_name: Name of the job.
-
-        :type destination: :class:`google.cloud.bigquery.table.Table`
-        :param destination: Table into which data is to be loaded.
-
-        :type source_uris: sequence of string
-        :param source_uris: URIs of data files to be loaded; in format
-                            ``gs://<bucket_name>/<object_name_or_glob>``.
-
-        :rtype: :class:`google.cloud.bigquery.job.LoadTableFromStorageJob`
-        :returns: a new ``LoadTableFromStorageJob`` instance
-        """
-        return LoadTableFromStorageJob(job_name, destination, source_uris,
-                                       client=self)
-
-    def copy_table(self, job_name, destination, *sources):
-        """Construct a job for copying one or more tables into another table.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.copy
-
-        :type job_name: str
-        :param job_name: Name of the job.
-
-        :type destination: :class:`google.cloud.bigquery.table.Table`
-        :param destination: Table into which data is to be copied.
-
-        :type sources: sequence of :class:`google.cloud.bigquery.table.Table`
-        :param sources: tables to be copied.
-
-        :rtype: :class:`google.cloud.bigquery.job.CopyJob`
-        :returns: a new ``CopyJob`` instance
-        """
-        return CopyJob(job_name, destination, sources, client=self)
-
-    def extract_table_to_storage(self, job_name, source, *destination_uris):
-        """Construct a job for extracting a table into Cloud Storage files.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.extract
-
-        :type job_name: str
-        :param job_name: Name of the job.
-
-        :type source: :class:`google.cloud.bigquery.table.Table`
-        :param source: table to be extracted.
-
-        :type destination_uris: sequence of string
-        :param destination_uris: URIs of CloudStorage file(s) into which
-                                 table data is to be extracted; in format
-                                 ``gs://<bucket_name>/<object_name_or_glob>``.
-
-        :rtype: :class:`google.cloud.bigquery.job.ExtractTableToStorageJob`
-        :returns: a new ``ExtractTableToStorageJob`` instance
-        """
-        return ExtractTableToStorageJob(job_name, source, destination_uris,
-                                        client=self)
-
-    def run_async_query(self, job_name, query):
-        """Construct a job for running a SQL query asynchronously.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query
-
-        :type job_name: str
-        :param job_name: Name of the job.
-
-        :type query: str
-        :param query: SQL query to be executed
-
-        :rtype: :class:`google.cloud.bigquery.job.QueryJob`
-        :returns: a new ``QueryJob`` instance
-        """
-        return QueryJob(job_name, query, client=self)
-
-    def run_sync_query(self, query):
-        """Run a SQL query synchronously.
-
-        :type query: str
-        :param query: SQL query to be executed
-
-        :rtype: :class:`google.cloud.bigquery.query.QueryResults`
-        :returns: a new ``QueryResults`` instance
-        """
-        return QueryResults(query, client=self)
diff --git a/google/cloud/bigquery/connection.py b/google/cloud/bigquery/connection.py
deleted file mode 100644
index 06e699efa28c..000000000000
--- a/google/cloud/bigquery/connection.py
+++ /dev/null
@@ -1,34 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Create / interact with Google Cloud BigQuery connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud BigQuery via the JSON REST API."""
-
-    API_BASE_URL = 'https://www.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v2'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/bigquery/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/bigquery',
-             'https://www.googleapis.com/auth/cloud-platform')
-    """The scopes required for authenticating as a Cloud BigQuery consumer."""
diff --git a/google/cloud/bigquery/dataset.py b/google/cloud/bigquery/dataset.py
deleted file mode 100644
index f4f1443d1aec..000000000000
--- a/google/cloud/bigquery/dataset.py
+++ /dev/null
@@ -1,587 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Datasets."""
-import six
-
-from google.cloud._helpers import _datetime_from_microseconds
-from google.cloud.exceptions import NotFound
-from google.cloud.bigquery.table import Table
-
-
-class AccessGrant(object):
-    """Represent grant of an access role to an entity.
-
-    Every entry in the access list will have exactly one of
-    ``userByEmail``, ``groupByEmail``, ``domain``, ``specialGroup`` or
-    ``view`` set. And if anything but ``view`` is set, it'll also have a
-    ``role`` specified. ``role`` is omitted for a ``view``, since
-    ``view`` s are always read-only.
-
-    See https://cloud.google.com/bigquery/docs/reference/v2/datasets.
-
-    :type role: string
-    :param role: Role granted to the entity. One of
-
-                 * ``'OWNER'``
-                 * ``'WRITER'``
-                 * ``'READER'``
-
-                 May also be ``None`` if the ``entity_type`` is ``view``.
-
-    :type entity_type: string
-    :param entity_type: Type of entity being granted the role. One of
-                        :attr:`ENTITY_TYPES`.
-
-    :type entity_id: string
-    :param entity_id: ID of entity being granted the role.
-
-    :raises: :class:`ValueError` if the ``entity_type`` is not among
-             :attr:`ENTITY_TYPES`, or if a ``view`` has ``role`` set or
-             a non ``view`` **does not** have a ``role`` set.
-    """
-
-    ENTITY_TYPES = frozenset(['userByEmail', 'groupByEmail', 'domain',
-                              'specialGroup', 'view'])
-    """Allowed entity types."""
-
-    def __init__(self, role, entity_type, entity_id):
-        if entity_type not in self.ENTITY_TYPES:
-            message = 'Entity type %r not among: %s' % (
-                entity_type, ', '.join(self.ENTITY_TYPES))
-            raise ValueError(message)
-        if entity_type == 'view':
-            if role is not None:
-                raise ValueError('Role must be None for a view. Received '
-                                 'role: %r' % (role,))
-        else:
-            if role is None:
-                raise ValueError('Role must be set for entity '
-                                 'type %r' % (entity_type,))
-
-        self.role = role
-        self.entity_type = entity_type
-        self.entity_id = entity_id
-
-    def __eq__(self, other):
-        return (
-            self.role == other.role and
-            self.entity_type == other.entity_type and
-            self.entity_id == other.entity_id)
-
-    def __repr__(self):
-        return '<AccessGrant: role=%s, %s=%s>' % (
-            self.role, self.entity_type, self.entity_id)
-
-
-class Dataset(object):
-    """Datasets are containers for tables.
-
-    See:
-    https://cloud.google.com/bigquery/docs/reference/v2/datasets
-
-    :type name: string
-    :param name: the name of the dataset
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-
-    :type access_grants: list of :class:`AccessGrant`
-    :param access_grants: roles granted to entities for this dataset
-    """
-
-    _access_grants = None
-
-    def __init__(self, name, client, access_grants=()):
-        self.name = name
-        self._client = client
-        self._properties = {}
-        # Let the @property do validation.
-        self.access_grants = access_grants
-
-    @property
-    def project(self):
-        """Project bound to the dataset.
-
-        :rtype: string
-        :returns: the project (derived from the client).
-        """
-        return self._client.project
-
-    @property
-    def path(self):
-        """URL path for the dataset's APIs.
-
-        :rtype: string
-        :returns: the path based on project and dataste name.
-        """
-        return '/projects/%s/datasets/%s' % (self.project, self.name)
-
-    @property
-    def access_grants(self):
-        """Dataset's access grants.
-
-        :rtype: list of :class:`AccessGrant`
-        :returns: roles granted to entities for this dataset
-        """
-        return list(self._access_grants)
-
-    @access_grants.setter
-    def access_grants(self, value):
-        """Update dataset's access grants
-
-        :type value: list of :class:`AccessGrant`
-        :param value: roles granted to entities for this dataset
-
-        :raises: TypeError if 'value' is not a sequence, or ValueError if
-                 any item in the sequence is not an AccessGrant
-        """
-        if not all(isinstance(field, AccessGrant) for field in value):
-            raise ValueError('Values must be AccessGrant instances')
-        self._access_grants = tuple(value)
-
-    @property
-    def created(self):
-        """Datetime at which the dataset was created.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the creation time (None until set from the server).
-        """
-        creation_time = self._properties.get('creationTime')
-        if creation_time is not None:
-            # creation_time will be in milliseconds.
-            return _datetime_from_microseconds(1000.0 * creation_time)
-
-    @property
-    def dataset_id(self):
-        """ID for the dataset resource.
-
-        :rtype: string, or ``NoneType``
-        :returns: the ID (None until set from the server).
-        """
-        return self._properties.get('id')
-
-    @property
-    def etag(self):
-        """ETag for the dataset resource.
-
-        :rtype: string, or ``NoneType``
-        :returns: the ETag (None until set from the server).
-        """
-        return self._properties.get('etag')
-
-    @property
-    def modified(self):
-        """Datetime at which the dataset was last modified.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the modification time (None until set from the server).
-        """
-        modified_time = self._properties.get('lastModifiedTime')
-        if modified_time is not None:
-            # modified_time will be in milliseconds.
-            return _datetime_from_microseconds(1000.0 * modified_time)
-
-    @property
-    def self_link(self):
-        """URL for the dataset resource.
-
-        :rtype: string, or ``NoneType``
-        :returns: the URL (None until set from the server).
-        """
-        return self._properties.get('selfLink')
-
-    @property
-    def default_table_expiration_ms(self):
-        """Default expiration time for tables in the dataset.
-
-        :rtype: integer, or ``NoneType``
-        :returns: The time in milliseconds, or None (the default).
-        """
-        return self._properties.get('defaultTableExpirationMs')
-
-    @default_table_expiration_ms.setter
-    def default_table_expiration_ms(self, value):
-        """Update default expiration time for tables in the dataset.
-
-        :type value: integer, or ``NoneType``
-        :param value: new default time, in milliseconds
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.integer_types) and value is not None:
-            raise ValueError("Pass an integer, or None")
-        self._properties['defaultTableExpirationMs'] = value
-
-    @property
-    def description(self):
-        """Description of the dataset.
-
-        :rtype: string, or ``NoneType``
-        :returns: The description as set by the user, or None (the default).
-        """
-        return self._properties.get('description')
-
-    @description.setter
-    def description(self, value):
-        """Update description of the dataset.
-
-        :type value: string, or ``NoneType``
-        :param value: new description
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['description'] = value
-
-    @property
-    def friendly_name(self):
-        """Title of the dataset.
-
-        :rtype: string, or ``NoneType``
-        :returns: The name as set by the user, or None (the default).
-        """
-        return self._properties.get('friendlyName')
-
-    @friendly_name.setter
-    def friendly_name(self, value):
-        """Update title of the dataset.
-
-        :type value: string, or ``NoneType``
-        :param value: new title
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['friendlyName'] = value
-
-    @property
-    def location(self):
-        """Location in which the dataset is hosted.
-
-        :rtype: string, or ``NoneType``
-        :returns: The location as set by the user, or None (the default).
-        """
-        return self._properties.get('location')
-
-    @location.setter
-    def location(self, value):
-        """Update location in which the dataset is hosted.
-
-        :type value: string, or ``NoneType``
-        :param value: new location
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['location'] = value
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a dataset given its API representation
-
-        :type resource: dict
-        :param resource: dataset resource representation returned from the API
-
-        :type client: :class:`google.cloud.bigquery.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the dataset.
-
-        :rtype: :class:`google.cloud.bigquery.dataset.Dataset`
-        :returns: Dataset parsed from ``resource``.
-        """
-        if ('datasetReference' not in resource or
-                'datasetId' not in resource['datasetReference']):
-            raise KeyError('Resource lacks required identity information:'
-                           '["datasetReference"]["datasetId"]')
-        name = resource['datasetReference']['datasetId']
-        dataset = cls(name, client=client)
-        dataset._set_properties(resource)
-        return dataset
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: :class:`google.cloud.bigquery.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    @staticmethod
-    def _parse_access_grants(access):
-        """Parse a resource fragment into a set of access grants.
-
-        ``role`` augments the entity type and present **unless** the entity
-        type is ``view``.
-
-        :type access: list of mappings
-        :param access: each mapping represents a single access grant.
-
-        :rtype: list of :class:`AccessGrant`
-        :returns: a list of parsed grants.
-        :raises: :class:`ValueError` if a grant in ``access`` has more keys
-                 than ``role`` and one additional key.
-        """
-        result = []
-        for grant in access:
-            grant = grant.copy()
-            role = grant.pop('role', None)
-            entity_type, entity_id = grant.popitem()
-            if len(grant) != 0:
-                raise ValueError('Grant has unexpected keys remaining.', grant)
-            result.append(
-                AccessGrant(role, entity_type, entity_id))
-        return result
-
-    def _set_properties(self, api_response):
-        """Update properties from resource in body of ``api_response``
-
-        :type api_response: httplib2.Response
-        :param api_response: response returned from an API call.
-        """
-        self._properties.clear()
-        cleaned = api_response.copy()
-        access = cleaned.pop('access', ())
-        self.access_grants = self._parse_access_grants(access)
-        if 'creationTime' in cleaned:
-            cleaned['creationTime'] = float(cleaned['creationTime'])
-        if 'lastModifiedTime' in cleaned:
-            cleaned['lastModifiedTime'] = float(cleaned['lastModifiedTime'])
-        if 'defaultTableExpirationMs' in cleaned:
-            cleaned['defaultTableExpirationMs'] = int(
-                cleaned['defaultTableExpirationMs'])
-        self._properties.update(cleaned)
-
-    def _build_access_resource(self):
-        """Generate a resource fragment for dataset's access grants."""
-        result = []
-        for grant in self.access_grants:
-            info = {grant.entity_type: grant.entity_id}
-            if grant.role is not None:
-                info['role'] = grant.role
-            result.append(info)
-        return result
-
-    def _build_resource(self):
-        """Generate a resource for ``create`` or ``update``."""
-        resource = {
-            'datasetReference': {
-                'projectId': self.project, 'datasetId': self.name},
-        }
-        if self.default_table_expiration_ms is not None:
-            value = self.default_table_expiration_ms
-            resource['defaultTableExpirationMs'] = value
-
-        if self.description is not None:
-            resource['description'] = self.description
-
-        if self.friendly_name is not None:
-            resource['friendlyName'] = self.friendly_name
-
-        if self.location is not None:
-            resource['location'] = self.location
-
-        if len(self.access_grants) > 0:
-            resource['access'] = self._build_access_resource()
-
-        return resource
-
-    def create(self, client=None):
-        """API call:  create the dataset via a PUT request.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/insert
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-        path = '/projects/%s/datasets' % (self.project,)
-        api_response = client.connection.api_request(
-            method='POST', path=path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the dataset via a GET request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/datasets/get
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the dataset.
-        """
-        client = self._require_client(client)
-
-        try:
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params={'fields': 'id'})
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  refresh dataset properties via a GET request.
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/datasets/get
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-
-        api_response = client.connection.api_request(
-            method='GET', path=self.path)
-        self._set_properties(api_response)
-
-    def patch(self, client=None, **kw):
-        """API call:  update individual dataset properties via a PATCH request.
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/datasets/patch
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :type kw: ``dict``
-        :param kw: properties to be patched.
-
-        :raises: ValueError for invalid value types.
-        """
-        client = self._require_client(client)
-
-        partial = {}
-
-        if 'default_table_expiration_ms' in kw:
-            value = kw['default_table_expiration_ms']
-            if not isinstance(value, six.integer_types) and value is not None:
-                raise ValueError("Pass an integer, or None")
-            partial['defaultTableExpirationMs'] = value
-
-        if 'description' in kw:
-            partial['description'] = kw['description']
-
-        if 'friendly_name' in kw:
-            partial['friendlyName'] = kw['friendly_name']
-
-        if 'location' in kw:
-            partial['location'] = kw['location']
-
-        api_response = client.connection.api_request(
-            method='PATCH', path=self.path, data=partial)
-        self._set_properties(api_response)
-
-    def update(self, client=None):
-        """API call:  update dataset properties via a PUT request.
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/datasets/update
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-        api_response = client.connection.api_request(
-            method='PUT', path=self.path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def delete(self, client=None):
-        """API call:  delete the dataset via a DELETE request.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/delete
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-        client.connection.api_request(method='DELETE', path=self.path)
-
-    def list_tables(self, max_results=None, page_token=None):
-        """List tables for the project associated with this client.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/list
-
-        :type max_results: int
-        :param max_results: maximum number of tables to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of datasets. If
-                           not passed, the API will return the first page of
-                           datasets.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.bigquery.table.Table`, plus a
-                  "next page token" string:  if not ``None``, indicates that
-                  more tables can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/datasets/%s/tables' % (self.project, self.name)
-        connection = self._client.connection
-        resp = connection.api_request(method='GET', path=path,
-                                      query_params=params)
-        tables = [Table.from_api_repr(resource, self)
-                  for resource in resp.get('tables', ())]
-        return tables, resp.get('nextPageToken')
-
-    def table(self, name, schema=()):
-        """Construct a table bound to this dataset.
-
-        :type name: string
-        :param name: Name of the table.
-
-        :type schema: list of :class:`google.cloud.bigquery.table.SchemaField`
-        :param schema: The table's schema
-
-        :rtype: :class:`google.cloud.bigquery.table.Table`
-        :returns: a new ``Table`` instance
-        """
-        return Table(name, dataset=self, schema=schema)
diff --git a/google/cloud/bigquery/job.py b/google/cloud/bigquery/job.py
deleted file mode 100644
index 85418ad3a3c8..000000000000
--- a/google/cloud/bigquery/job.py
+++ /dev/null
@@ -1,1103 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Jobs."""
-
-import six
-
-from google.cloud.exceptions import NotFound
-from google.cloud._helpers import _datetime_from_microseconds
-from google.cloud.bigquery.dataset import Dataset
-from google.cloud.bigquery.schema import SchemaField
-from google.cloud.bigquery.table import Table
-from google.cloud.bigquery.table import _build_schema_resource
-from google.cloud.bigquery.table import _parse_schema_resource
-from google.cloud.bigquery._helpers import UDFResourcesProperty
-from google.cloud.bigquery._helpers import _EnumProperty
-from google.cloud.bigquery._helpers import _TypedProperty
-from google.cloud.bigquery._helpers import _build_udf_resources
-
-
-class Compression(_EnumProperty):
-    """Pseudo-enum for ``compression`` properties."""
-    GZIP = 'GZIP'
-    NONE = 'NONE'
-    ALLOWED = (GZIP, NONE)
-
-
-class CreateDisposition(_EnumProperty):
-    """Pseudo-enum for ``create_disposition`` properties."""
-    CREATE_IF_NEEDED = 'CREATE_IF_NEEDED'
-    CREATE_NEVER = 'CREATE_NEVER'
-    ALLOWED = (CREATE_IF_NEEDED, CREATE_NEVER)
-
-
-class DestinationFormat(_EnumProperty):
-    """Pseudo-enum for ``destination_format`` properties."""
-    CSV = 'CSV'
-    NEWLINE_DELIMITED_JSON = 'NEWLINE_DELIMITED_JSON'
-    AVRO = 'AVRO'
-    ALLOWED = (CSV, NEWLINE_DELIMITED_JSON, AVRO)
-
-
-class Encoding(_EnumProperty):
-    """Pseudo-enum for ``encoding`` properties."""
-    UTF_8 = 'UTF-8'
-    ISO_8559_1 = 'ISO-8559-1'
-    ALLOWED = (UTF_8, ISO_8559_1)
-
-
-class QueryPriority(_EnumProperty):
-    """Pseudo-enum for ``QueryJob.priority`` property."""
-    INTERACTIVE = 'INTERACTIVE'
-    BATCH = 'BATCH'
-    ALLOWED = (INTERACTIVE, BATCH)
-
-
-class SourceFormat(_EnumProperty):
-    """Pseudo-enum for ``source_format`` properties."""
-    CSV = 'CSV'
-    DATASTORE_BACKUP = 'DATASTORE_BACKUP'
-    NEWLINE_DELIMITED_JSON = 'NEWLINE_DELIMITED_JSON'
-    ALLOWED = (CSV, DATASTORE_BACKUP, NEWLINE_DELIMITED_JSON)
-
-
-class WriteDisposition(_EnumProperty):
-    """Pseudo-enum for ``write_disposition`` properties."""
-    WRITE_APPEND = 'WRITE_APPEND'
-    WRITE_TRUNCATE = 'WRITE_TRUNCATE'
-    WRITE_EMPTY = 'WRITE_EMPTY'
-    ALLOWED = (WRITE_APPEND, WRITE_TRUNCATE, WRITE_EMPTY)
-
-
-class _BaseJob(object):
-    """Base class for jobs.
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-    """
-    def __init__(self, client):
-        self._client = client
-        self._properties = {}
-
-    @property
-    def project(self):
-        """Project bound to the job.
-
-        :rtype: string
-        :returns: the project (derived from the client).
-        """
-        return self._client.project
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: :class:`google.cloud.bigquery.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-
-class _AsyncJob(_BaseJob):
-    """Base class for asynchronous jobs.
-
-    :type name: string
-    :param name: the name of the job
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-    """
-    def __init__(self, name, client):
-        super(_AsyncJob, self).__init__(client)
-        self.name = name
-
-    @property
-    def job_type(self):
-        """Type of job
-
-        :rtype: string
-        :returns: one of 'load', 'copy', 'extract', 'query'
-        """
-        return self._JOB_TYPE
-
-    @property
-    def path(self):
-        """URL path for the job's APIs.
-
-        :rtype: string
-        :returns: the path based on project and job name.
-        """
-        return '/projects/%s/jobs/%s' % (self.project, self.name)
-
-    @property
-    def etag(self):
-        """ETag for the job resource.
-
-        :rtype: string, or ``NoneType``
-        :returns: the ETag (None until set from the server).
-        """
-        return self._properties.get('etag')
-
-    @property
-    def self_link(self):
-        """URL for the job resource.
-
-        :rtype: string, or ``NoneType``
-        :returns: the URL (None until set from the server).
-        """
-        return self._properties.get('selfLink')
-
-    @property
-    def user_email(self):
-        """E-mail address of user who submitted the job.
-
-        :rtype: string, or ``NoneType``
-        :returns: the URL (None until set from the server).
-        """
-        return self._properties.get('user_email')
-
-    @property
-    def created(self):
-        """Datetime at which the job was created.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the creation time (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            millis = statistics.get('creationTime')
-            if millis is not None:
-                return _datetime_from_microseconds(millis * 1000.0)
-
-    @property
-    def started(self):
-        """Datetime at which the job was started.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the start time (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            millis = statistics.get('startTime')
-            if millis is not None:
-                return _datetime_from_microseconds(millis * 1000.0)
-
-    @property
-    def ended(self):
-        """Datetime at which the job finished.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the end time (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            millis = statistics.get('endTime')
-            if millis is not None:
-                return _datetime_from_microseconds(millis * 1000.0)
-
-    @property
-    def error_result(self):
-        """Error information about the job as a whole.
-
-        :rtype: mapping, or ``NoneType``
-        :returns: the error information (None until set from the server).
-        """
-        status = self._properties.get('status')
-        if status is not None:
-            return status.get('errorResult')
-
-    @property
-    def errors(self):
-        """Information about individual errors generated by the job.
-
-        :rtype: list of mappings, or ``NoneType``
-        :returns: the error information (None until set from the server).
-        """
-        status = self._properties.get('status')
-        if status is not None:
-            return status.get('errors')
-
-    @property
-    def state(self):
-        """Status of the job.
-
-        :rtype: string, or ``NoneType``
-        :returns: the state (None until set from the server).
-        """
-        status = self._properties.get('status')
-        if status is not None:
-            return status.get('state')
-
-    def _scrub_local_properties(self, cleaned):
-        """Helper:  handle subclass properties in cleaned."""
-        pass
-
-    def _set_properties(self, api_response):
-        """Update properties from resource in body of ``api_response``
-
-        :type api_response: httplib2.Response
-        :param api_response: response returned from an API call
-        """
-        cleaned = api_response.copy()
-        self._scrub_local_properties(cleaned)
-
-        statistics = cleaned.get('statistics', {})
-        if 'creationTime' in statistics:
-            statistics['creationTime'] = float(statistics['creationTime'])
-        if 'startTime' in statistics:
-            statistics['startTime'] = float(statistics['startTime'])
-        if 'endTime' in statistics:
-            statistics['endTime'] = float(statistics['endTime'])
-
-        self._properties.clear()
-        self._properties.update(cleaned)
-
-    @classmethod
-    def _get_resource_config(cls, resource):
-        """Helper for :meth:`from_api_repr`
-
-        :type resource: dict
-        :param resource: resource for the job
-
-        :rtype: dict
-        :returns: tuple (string, dict), where the first element is the
-                  job name and the second contains job-specific configuration.
-        :raises: :class:`KeyError` if the resource has no identifier, or
-                 is missing the appropriate configuration.
-        """
-        if ('jobReference' not in resource or
-                'jobId' not in resource['jobReference']):
-            raise KeyError('Resource lacks required identity information: '
-                           '["jobReference"]["jobId"]')
-        name = resource['jobReference']['jobId']
-        if ('configuration' not in resource or
-                cls._JOB_TYPE not in resource['configuration']):
-            raise KeyError('Resource lacks required configuration: '
-                           '["configuration"]["%s"]' % cls._JOB_TYPE)
-        config = resource['configuration'][cls._JOB_TYPE]
-        return name, config
-
-    def begin(self, client=None):
-        """API call:  begin the job via a POST request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/insert
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :raises: :exc:`ValueError` if the job has already begin.
-        """
-        if self.state is not None:
-            raise ValueError("Job already begun.")
-
-        client = self._require_client(client)
-        path = '/projects/%s/jobs' % (self.project,)
-        api_response = client.connection.api_request(
-            method='POST', path=path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the job via a GET request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/get
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the job.
-        """
-        client = self._require_client(client)
-
-        try:
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params={'fields': 'id'})
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  refresh job properties via a GET request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/get
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-
-        api_response = client.connection.api_request(
-            method='GET', path=self.path)
-        self._set_properties(api_response)
-
-    def cancel(self, client=None):
-        """API call:  cancel job via a POST request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/cancel
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-
-        api_response = client.connection.api_request(
-            method='POST', path='%s/cancel' % (self.path,))
-        self._set_properties(api_response['job'])
-
-
-class _LoadConfiguration(object):
-    """User-settable configuration options for load jobs.
-
-    Values which are ``None`` -> server defaults.
-    """
-    _allow_jagged_rows = None
-    _allow_quoted_newlines = None
-    _create_disposition = None
-    _encoding = None
-    _field_delimiter = None
-    _ignore_unknown_values = None
-    _max_bad_records = None
-    _quote_character = None
-    _skip_leading_rows = None
-    _source_format = None
-    _write_disposition = None
-
-
-class LoadTableFromStorageJob(_AsyncJob):
-    """Asynchronous job for loading data into a table from CloudStorage.
-
-    :type name: string
-    :param name: the name of the job
-
-    :type destination: :class:`google.cloud.bigquery.table.Table`
-    :param destination: Table into which data is to be loaded.
-
-    :type source_uris: sequence of string
-    :param source_uris: URIs of one or more data files to be loaded, in
-                        format ``gs://<bucket_name>/<object_name_or_glob>``.
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-
-    :type schema: list of :class:`google.cloud.bigquery.table.SchemaField`
-    :param schema: The job's schema
-    """
-
-    _schema = None
-    _JOB_TYPE = 'load'
-
-    def __init__(self, name, destination, source_uris, client, schema=()):
-        super(LoadTableFromStorageJob, self).__init__(name, client)
-        self.destination = destination
-        self.source_uris = source_uris
-        # Let the @property do validation.
-        self.schema = schema
-        self._configuration = _LoadConfiguration()
-
-    @property
-    def schema(self):
-        """Table's schema.
-
-        :rtype: list of :class:`SchemaField`
-        :returns: fields describing the schema
-        """
-        return list(self._schema)
-
-    @schema.setter
-    def schema(self, value):
-        """Update table's schema
-
-        :type value: list of :class:`SchemaField`
-        :param value: fields describing the schema
-
-        :raises: TypeError if 'value' is not a sequence, or ValueError if
-                 any item in the sequence is not a SchemaField
-        """
-        if not all(isinstance(field, SchemaField) for field in value):
-            raise ValueError('Schema items must be fields')
-        self._schema = tuple(value)
-
-    @property
-    def input_file_bytes(self):
-        """Count of bytes loaded from source files.
-
-        :rtype: integer, or ``NoneType``
-        :returns: the count (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            return int(statistics['load']['inputFileBytes'])
-
-    @property
-    def input_files(self):
-        """Count of source files.
-
-        :rtype: integer, or ``NoneType``
-        :returns: the count (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            return int(statistics['load']['inputFiles'])
-
-    @property
-    def output_bytes(self):
-        """Count of bytes saved to destination table.
-
-        :rtype: integer, or ``NoneType``
-        :returns: the count (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            return int(statistics['load']['outputBytes'])
-
-    @property
-    def output_rows(self):
-        """Count of rows saved to destination table.
-
-        :rtype: integer, or ``NoneType``
-        :returns: the count (None until set from the server).
-        """
-        statistics = self._properties.get('statistics')
-        if statistics is not None:
-            return int(statistics['load']['outputRows'])
-
-    allow_jagged_rows = _TypedProperty('allow_jagged_rows', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.allowJaggedRows
-    """
-
-    allow_quoted_newlines = _TypedProperty('allow_quoted_newlines', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.allowQuotedNewlines
-    """
-
-    create_disposition = CreateDisposition('create_disposition')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.createDisposition
-    """
-
-    encoding = Encoding('encoding')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.encoding
-    """
-
-    field_delimiter = _TypedProperty('field_delimiter', six.string_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.fieldDelimiter
-    """
-
-    ignore_unknown_values = _TypedProperty('ignore_unknown_values', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.ignoreUnknownValues
-    """
-
-    max_bad_records = _TypedProperty('max_bad_records', six.integer_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.maxBadRecords
-    """
-
-    quote_character = _TypedProperty('quote_character', six.string_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.quote
-    """
-
-    skip_leading_rows = _TypedProperty('skip_leading_rows', six.integer_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.skipLeadingRows
-    """
-
-    source_format = SourceFormat('source_format')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.sourceFormat
-    """
-
-    write_disposition = WriteDisposition('write_disposition')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load.writeDisposition
-    """
-
-    def _populate_config_resource(self, configuration):
-        """Helper for _build_resource: copy config properties to resource"""
-        if self.allow_jagged_rows is not None:
-            configuration['allowJaggedRows'] = self.allow_jagged_rows
-        if self.allow_quoted_newlines is not None:
-            configuration['allowQuotedNewlines'] = self.allow_quoted_newlines
-        if self.create_disposition is not None:
-            configuration['createDisposition'] = self.create_disposition
-        if self.encoding is not None:
-            configuration['encoding'] = self.encoding
-        if self.field_delimiter is not None:
-            configuration['fieldDelimiter'] = self.field_delimiter
-        if self.ignore_unknown_values is not None:
-            configuration['ignoreUnknownValues'] = self.ignore_unknown_values
-        if self.max_bad_records is not None:
-            configuration['maxBadRecords'] = self.max_bad_records
-        if self.quote_character is not None:
-            configuration['quote'] = self.quote_character
-        if self.skip_leading_rows is not None:
-            configuration['skipLeadingRows'] = self.skip_leading_rows
-        if self.source_format is not None:
-            configuration['sourceFormat'] = self.source_format
-        if self.write_disposition is not None:
-            configuration['writeDisposition'] = self.write_disposition
-
-    def _build_resource(self):
-        """Generate a resource for :meth:`begin`."""
-        resource = {
-            'jobReference': {
-                'projectId': self.project,
-                'jobId': self.name,
-            },
-            'configuration': {
-                self._JOB_TYPE: {
-                    'sourceUris': self.source_uris,
-                    'destinationTable': {
-                        'projectId': self.destination.project,
-                        'datasetId': self.destination.dataset_name,
-                        'tableId': self.destination.name,
-                    },
-                },
-            },
-        }
-        configuration = resource['configuration'][self._JOB_TYPE]
-        self._populate_config_resource(configuration)
-
-        if len(self.schema) > 0:
-            configuration['schema'] = {
-                'fields': _build_schema_resource(self.schema)}
-
-        return resource
-
-    def _scrub_local_properties(self, cleaned):
-        """Helper:  handle subclass properties in cleaned."""
-        schema = cleaned.pop('schema', {'fields': ()})
-        self.schema = _parse_schema_resource(schema)
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a job given its API representation
-
-        .. note:
-
-           This method assumes that the project found in the resource matches
-           the client's project.
-
-        :type resource: dict
-        :param resource: dataset job representation returned from the API
-
-        :type client: :class:`google.cloud.bigquery.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the dataset.
-
-        :rtype: :class:`google.cloud.bigquery.job.LoadTableFromStorageJob`
-        :returns: Job parsed from ``resource``.
-        """
-        name, config = cls._get_resource_config(resource)
-        dest_config = config['destinationTable']
-        dataset = Dataset(dest_config['datasetId'], client)
-        destination = Table(dest_config['tableId'], dataset)
-        source_urls = config.get('sourceUris', ())
-        job = cls(name, destination, source_urls, client=client)
-        job._set_properties(resource)
-        return job
-
-
-class _CopyConfiguration(object):
-    """User-settable configuration options for copy jobs.
-
-    Values which are ``None`` -> server defaults.
-    """
-    _create_disposition = None
-    _write_disposition = None
-
-
-class CopyJob(_AsyncJob):
-    """Asynchronous job: copy data into a table from other tables.
-
-    :type name: string
-    :param name: the name of the job
-
-    :type destination: :class:`google.cloud.bigquery.table.Table`
-    :param destination: Table into which data is to be loaded.
-
-    :type sources: list of :class:`google.cloud.bigquery.table.Table`
-    :param sources: Table into which data is to be loaded.
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-    """
-
-    _JOB_TYPE = 'copy'
-
-    def __init__(self, name, destination, sources, client):
-        super(CopyJob, self).__init__(name, client)
-        self.destination = destination
-        self.sources = sources
-        self._configuration = _CopyConfiguration()
-
-    create_disposition = CreateDisposition('create_disposition')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.copy.createDisposition
-    """
-
-    write_disposition = WriteDisposition('write_disposition')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.copy.writeDisposition
-    """
-
-    def _populate_config_resource(self, configuration):
-        """Helper for _build_resource: copy config properties to resource"""
-        if self.create_disposition is not None:
-            configuration['createDisposition'] = self.create_disposition
-        if self.write_disposition is not None:
-            configuration['writeDisposition'] = self.write_disposition
-
-    def _build_resource(self):
-        """Generate a resource for :meth:`begin`."""
-
-        source_refs = [{
-            'projectId': table.project,
-            'datasetId': table.dataset_name,
-            'tableId': table.name,
-        } for table in self.sources]
-
-        resource = {
-            'jobReference': {
-                'projectId': self.project,
-                'jobId': self.name,
-            },
-            'configuration': {
-                self._JOB_TYPE: {
-                    'sourceTables': source_refs,
-                    'destinationTable': {
-                        'projectId': self.destination.project,
-                        'datasetId': self.destination.dataset_name,
-                        'tableId': self.destination.name,
-                    },
-                },
-            },
-        }
-        configuration = resource['configuration'][self._JOB_TYPE]
-        self._populate_config_resource(configuration)
-
-        return resource
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a job given its API representation
-
-        .. note:
-
-           This method assumes that the project found in the resource matches
-           the client's project.
-
-        :type resource: dict
-        :param resource: dataset job representation returned from the API
-
-        :type client: :class:`google.cloud.bigquery.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the dataset.
-
-        :rtype: :class:`google.cloud.bigquery.job.CopyJob`
-        :returns: Job parsed from ``resource``.
-        """
-        name, config = cls._get_resource_config(resource)
-        dest_config = config['destinationTable']
-        dataset = Dataset(dest_config['datasetId'], client)
-        destination = Table(dest_config['tableId'], dataset)
-        sources = []
-        for source_config in config['sourceTables']:
-            dataset = Dataset(source_config['datasetId'], client)
-            sources.append(Table(source_config['tableId'], dataset))
-        job = cls(name, destination, sources, client=client)
-        job._set_properties(resource)
-        return job
-
-
-class _ExtractConfiguration(object):
-    """User-settable configuration options for extract jobs.
-
-    Values which are ``None`` -> server defaults.
-    """
-    _compression = None
-    _destination_format = None
-    _field_delimiter = None
-    _print_header = None
-
-
-class ExtractTableToStorageJob(_AsyncJob):
-    """Asynchronous job: extract data from a table into Cloud Storage.
-
-    :type name: string
-    :param name: the name of the job
-
-    :type source: :class:`google.cloud.bigquery.table.Table`
-    :param source: Table into which data is to be loaded.
-
-    :type destination_uris: list of string
-    :param destination_uris: URIs describing Cloud Storage blobs into which
-                             extracted data will be written, in format
-                             ``gs://<bucket_name>/<object_name_or_glob>``.
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-    """
-    _JOB_TYPE = 'extract'
-
-    def __init__(self, name, source, destination_uris, client):
-        super(ExtractTableToStorageJob, self).__init__(name, client)
-        self.source = source
-        self.destination_uris = destination_uris
-        self._configuration = _ExtractConfiguration()
-
-    compression = Compression('compression')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.extracted.compression
-    """
-
-    destination_format = DestinationFormat('destination_format')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.extracted.destinationFormat
-    """
-
-    field_delimiter = _TypedProperty('field_delimiter', six.string_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.extracted.fieldDelimiter
-    """
-
-    print_header = _TypedProperty('print_header', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.extracted.printHeader
-    """
-
-    def _populate_config_resource(self, configuration):
-        """Helper for _build_resource: copy config properties to resource"""
-        if self.compression is not None:
-            configuration['compression'] = self.compression
-        if self.destination_format is not None:
-            configuration['destinationFormat'] = self.destination_format
-        if self.field_delimiter is not None:
-            configuration['fieldDelimiter'] = self.field_delimiter
-        if self.print_header is not None:
-            configuration['printHeader'] = self.print_header
-
-    def _build_resource(self):
-        """Generate a resource for :meth:`begin`."""
-
-        source_ref = {
-            'projectId': self.source.project,
-            'datasetId': self.source.dataset_name,
-            'tableId': self.source.name,
-        }
-
-        resource = {
-            'jobReference': {
-                'projectId': self.project,
-                'jobId': self.name,
-            },
-            'configuration': {
-                self._JOB_TYPE: {
-                    'sourceTable': source_ref,
-                    'destinationUris': self.destination_uris,
-                },
-            },
-        }
-        configuration = resource['configuration'][self._JOB_TYPE]
-        self._populate_config_resource(configuration)
-
-        return resource
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a job given its API representation
-
-        .. note:
-
-           This method assumes that the project found in the resource matches
-           the client's project.
-
-        :type resource: dict
-        :param resource: dataset job representation returned from the API
-
-        :type client: :class:`google.cloud.bigquery.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the dataset.
-
-        :rtype: :class:`google.cloud.bigquery.job.ExtractTableToStorageJob`
-        :returns: Job parsed from ``resource``.
-        """
-        name, config = cls._get_resource_config(resource)
-        source_config = config['sourceTable']
-        dataset = Dataset(source_config['datasetId'], client)
-        source = Table(source_config['tableId'], dataset)
-        destination_uris = config['destinationUris']
-        job = cls(name, source, destination_uris, client=client)
-        job._set_properties(resource)
-        return job
-
-
-class _AsyncQueryConfiguration(object):
-    """User-settable configuration options for asynchronous query jobs.
-
-    Values which are ``None`` -> server defaults.
-    """
-    _allow_large_results = None
-    _create_disposition = None
-    _default_dataset = None
-    _destination = None
-    _flatten_results = None
-    _priority = None
-    _use_query_cache = None
-    _use_legacy_sql = None
-    _dry_run = None
-    _write_disposition = None
-    _maximum_billing_tier = None
-    _maximum_bytes_billed = None
-
-
-class QueryJob(_AsyncJob):
-    """Asynchronous job: query tables.
-
-    :type name: string
-    :param name: the name of the job
-
-    :type query: string
-    :param query: SQL query string
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-
-    :type udf_resources: tuple
-    :param udf_resources: An iterable of
-                        :class:`google.cloud.bigquery._helpers.UDFResource`
-                        (empty by default)
-    """
-    _JOB_TYPE = 'query'
-    _UDF_KEY = 'userDefinedFunctionResources'
-
-    def __init__(self, name, query, client, udf_resources=()):
-        super(QueryJob, self).__init__(name, client)
-        self.query = query
-        self.udf_resources = udf_resources
-        self._configuration = _AsyncQueryConfiguration()
-
-    allow_large_results = _TypedProperty('allow_large_results', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.allowLargeResults
-    """
-
-    create_disposition = CreateDisposition('create_disposition')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.createDisposition
-    """
-
-    default_dataset = _TypedProperty('default_dataset', Dataset)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.defaultDataset
-    """
-
-    destination = _TypedProperty('destination', Table)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.destinationTable
-    """
-
-    flatten_results = _TypedProperty('flatten_results', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.flattenResults
-    """
-
-    priority = QueryPriority('priority')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.priority
-    """
-
-    udf_resources = UDFResourcesProperty()
-
-    use_query_cache = _TypedProperty('use_query_cache', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.useQueryCache
-    """
-
-    use_legacy_sql = _TypedProperty('use_legacy_sql', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/\
-    reference/v2/jobs#configuration.query.useLegacySql
-    """
-
-    dry_run = _TypedProperty('dry_run', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/\
-    reference/v2/jobs#configuration.query.dryRun
-    """
-
-    write_disposition = WriteDisposition('write_disposition')
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.writeDisposition
-    """
-
-    maximum_billing_tier = _TypedProperty('maximum_billing_tier', int)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.maximumBillingTier
-    """
-
-    maximum_bytes_billed = _TypedProperty('maximum_bytes_billed', int)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.query.maximumBytesBilled
-    """
-
-    def _destination_table_resource(self):
-        """Create a JSON resource for the destination table.
-
-        Helper for :meth:`_populate_config_resource` and
-        :meth:`_scrub_local_properties`
-        """
-        if self.destination is not None:
-            return {
-                'projectId': self.destination.project,
-                'datasetId': self.destination.dataset_name,
-                'tableId': self.destination.name,
-            }
-
-    def _populate_config_resource_booleans(self, configuration):
-        """Helper for _populate_config_resource."""
-        if self.allow_large_results is not None:
-            configuration['allowLargeResults'] = self.allow_large_results
-        if self.flatten_results is not None:
-            configuration['flattenResults'] = self.flatten_results
-        if self.use_query_cache is not None:
-            configuration['useQueryCache'] = self.use_query_cache
-        if self.use_legacy_sql is not None:
-            configuration['useLegacySql'] = self.use_legacy_sql
-        if self.dry_run is not None:
-            configuration['dryRun'] = self.dry_run
-
-    def _populate_config_resource(self, configuration):
-        """Helper for _build_resource: copy config properties to resource"""
-        self._populate_config_resource_booleans(configuration)
-
-        if self.create_disposition is not None:
-            configuration['createDisposition'] = self.create_disposition
-        if self.default_dataset is not None:
-            configuration['defaultDataset'] = {
-                'projectId': self.default_dataset.project,
-                'datasetId': self.default_dataset.name,
-            }
-        if self.destination is not None:
-            table_res = self._destination_table_resource()
-            configuration['destinationTable'] = table_res
-        if self.priority is not None:
-            configuration['priority'] = self.priority
-        if self.write_disposition is not None:
-            configuration['writeDisposition'] = self.write_disposition
-        if self.maximum_billing_tier is not None:
-            configuration['maximumBillingTier'] = self.maximum_billing_tier
-        if self.maximum_bytes_billed is not None:
-            configuration['maximumBytesBilled'] = self.maximum_bytes_billed
-        if len(self._udf_resources) > 0:
-            configuration[self._UDF_KEY] = _build_udf_resources(
-                self._udf_resources)
-
-    def _build_resource(self):
-        """Generate a resource for :meth:`begin`."""
-
-        resource = {
-            'jobReference': {
-                'projectId': self.project,
-                'jobId': self.name,
-            },
-            'configuration': {
-                self._JOB_TYPE: {
-                    'query': self.query,
-                },
-            },
-        }
-        configuration = resource['configuration'][self._JOB_TYPE]
-        self._populate_config_resource(configuration)
-
-        return resource
-
-    def _scrub_local_properties(self, cleaned):
-        """Helper:  handle subclass properties in cleaned.
-
-        .. note:
-
-           This method assumes that the project found in the resource matches
-           the client's project.
-        """
-        configuration = cleaned['configuration']['query']
-        dest_remote = configuration.get('destinationTable')
-
-        if dest_remote is None:
-            if self.destination is not None:
-                del self.destination
-        else:
-            dest_local = self._destination_table_resource()
-            if dest_remote != dest_local:
-                dataset = self._client.dataset(dest_remote['datasetId'])
-                self.destination = dataset.table(dest_remote['tableId'])
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a job given its API representation
-
-        :type resource: dict
-        :param resource: dataset job representation returned from the API
-
-        :type client: :class:`google.cloud.bigquery.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the dataset.
-
-        :rtype: :class:`google.cloud.bigquery.job.RunAsyncQueryJob`
-        :returns: Job parsed from ``resource``.
-        """
-        name, config = cls._get_resource_config(resource)
-        query = config['query']
-        job = cls(name, query, client=client)
-        job._set_properties(resource)
-        return job
-
-    def results(self):
-        """Construct a QueryResults instance, bound to this job.
-
-        :rtype: :class:`~google.cloud.bigquery.query.QueryResults`
-        :returns: results instance
-        """
-        from google.cloud.bigquery.query import QueryResults
-        return QueryResults.from_query_job(self)
diff --git a/google/cloud/bigquery/query.py b/google/cloud/bigquery/query.py
deleted file mode 100644
index c9cd0df08e23..000000000000
--- a/google/cloud/bigquery/query.py
+++ /dev/null
@@ -1,405 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Queries."""
-
-import six
-
-from google.cloud.bigquery._helpers import _TypedProperty
-from google.cloud.bigquery._helpers import _rows_from_json
-from google.cloud.bigquery.dataset import Dataset
-from google.cloud.bigquery.job import QueryJob
-from google.cloud.bigquery.table import _parse_schema_resource
-from google.cloud.bigquery._helpers import _build_udf_resources
-from google.cloud.bigquery._helpers import UDFResourcesProperty
-
-
-class _SyncQueryConfiguration(object):
-    """User-settable configuration options for synchronous query jobs.
-
-    Values which are ``None`` -> server defaults.
-    """
-    _default_dataset = None
-    _dry_run = None
-    _max_results = None
-    _timeout_ms = None
-    _preserve_nulls = None
-    _use_query_cache = None
-    _use_legacy_sql = None
-
-
-class QueryResults(object):
-    """Synchronous job: query tables.
-
-    :type query: string
-    :param query: SQL query string
-
-    :type client: :class:`google.cloud.bigquery.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the dataset (which requires a project).
-
-    :type udf_resources: tuple
-    :param udf_resources: An iterable of
-                        :class:`google.cloud.bigquery.job.UDFResource`
-                        (empty by default)
-    """
-
-    _UDF_KEY = 'userDefinedFunctionResources'
-
-    def __init__(self, query, client, udf_resources=()):
-        self._client = client
-        self._properties = {}
-        self.query = query
-        self._configuration = _SyncQueryConfiguration()
-        self.udf_resources = udf_resources
-        self._job = None
-
-    @classmethod
-    def from_query_job(cls, job):
-        """Factory: construct from an existing job.
-
-        :type job: :class:`~google.cloud.bigquery.job.QueryJob`
-        :param job: existing job
-
-        :rtype: :class:`QueryResults`
-        :returns: the instance, bound to the job
-        """
-        instance = cls(job.query, job._client, job.udf_resources)
-        instance._job = job
-        job_ref = instance._properties.setdefault('jobReference', {})
-        job_ref['jobId'] = job.name
-        if job.default_dataset is not None:
-            instance.default_dataset = job.default_dataset
-        if job.use_query_cache is not None:
-            instance.use_query_cache = job.use_query_cache
-        if job.use_legacy_sql is not None:
-            instance.use_legacy_sql = job.use_legacy_sql
-        return instance
-
-    @property
-    def project(self):
-        """Project bound to the job.
-
-        :rtype: string
-        :returns: the project (derived from the client).
-        """
-        return self._client.project
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: :class:`google.cloud.bigquery.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    @property
-    def cache_hit(self):
-        """Query results served from cache.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#cacheHit
-
-        :rtype: boolean or ``NoneType``
-        :returns: True if the query results were served from cache (None
-                  until set by the server).
-        """
-        return self._properties.get('cacheHit')
-
-    @property
-    def complete(self):
-        """Server completed query.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#jobComplete
-
-        :rtype: boolean or ``NoneType``
-        :returns: True if the query completed on the server (None
-                  until set by the server).
-        """
-        return self._properties.get('jobComplete')
-
-    @property
-    def errors(self):
-        """Errors generated by the query.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#errors
-
-        :rtype: list of mapping, or ``NoneType``
-        :returns: Mappings describing errors generated on the server (None
-                  until set by the server).
-        """
-        return self._properties.get('errors')
-
-    @property
-    def name(self):
-        """Job name, generated by the back-end.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#jobReference
-
-        :rtype: list of mapping, or ``NoneType``
-        :returns: Mappings describing errors generated on the server (None
-                  until set by the server).
-        """
-        return self._properties.get('jobReference', {}).get('jobId')
-
-    @property
-    def job(self):
-        """Job instance used to run the query.
-
-        :rtype: :class:`google.cloud.bigquery.job.QueryJob`, or ``NoneType``
-        :returns: Job instance used to run the query (None until
-                  ``jobReference`` property is set by the server).
-        """
-        if self._job is None:
-            job_ref = self._properties.get('jobReference')
-            if job_ref is not None:
-                self._job = QueryJob(job_ref['jobId'], self.query,
-                                     self._client)
-        return self._job
-
-    @property
-    def page_token(self):
-        """Token for fetching next bach of results.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#pageToken
-
-        :rtype: string, or ``NoneType``
-        :returns: Token generated on the server (None until set by the server).
-        """
-        return self._properties.get('pageToken')
-
-    @property
-    def total_rows(self):
-        """Total number of rows returned by the query.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#totalRows
-
-        :rtype: integer, or ``NoneType``
-        :returns: Count generated on the server (None until set by the server).
-        """
-        return self._properties.get('totalRows')
-
-    @property
-    def total_bytes_processed(self):
-        """Total number of bytes processed by the query.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#totalBytesProcessed
-
-        :rtype: integer, or ``NoneType``
-        :returns: Count generated on the server (None until set by the server).
-        """
-        return self._properties.get('totalBytesProcessed')
-
-    @property
-    def rows(self):
-        """Query results.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#rows
-
-        :rtype: list of tuples of row values, or ``NoneType``
-        :returns: fields describing the schema (None until set by the server).
-        """
-        return _rows_from_json(self._properties.get('rows', ()), self.schema)
-
-    @property
-    def schema(self):
-        """Schema for query results.
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#schema
-
-        :rtype: list of :class:`SchemaField`, or ``NoneType``
-        :returns: fields describing the schema (None until set by the server).
-        """
-        return _parse_schema_resource(self._properties.get('schema', {}))
-
-    default_dataset = _TypedProperty('default_dataset', Dataset)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#defaultDataset
-    """
-
-    dry_run = _TypedProperty('dry_run', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#dryRun
-    """
-
-    max_results = _TypedProperty('max_results', six.integer_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#maxResults
-    """
-
-    preserve_nulls = _TypedProperty('preserve_nulls', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#preserveNulls
-    """
-
-    timeout_ms = _TypedProperty('timeout_ms', six.integer_types)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#timeoutMs
-    """
-
-    udf_resources = UDFResourcesProperty()
-
-    use_query_cache = _TypedProperty('use_query_cache', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/reference/v2/jobs/query#useQueryCache
-    """
-
-    use_legacy_sql = _TypedProperty('use_legacy_sql', bool)
-    """See:
-    https://cloud.google.com/bigquery/docs/\
-    reference/v2/jobs/query#useLegacySql
-    """
-
-    def _set_properties(self, api_response):
-        """Update properties from resource in body of ``api_response``
-
-        :type api_response: httplib2.Response
-        :param api_response: response returned from an API call
-        """
-        self._properties.clear()
-        self._properties.update(api_response)
-
-    def _build_resource(self):
-        """Generate a resource for :meth:`begin`."""
-        resource = {'query': self.query}
-
-        if self.default_dataset is not None:
-            resource['defaultDataset'] = {
-                'projectId': self.project,
-                'datasetId': self.default_dataset.name,
-            }
-
-        if self.max_results is not None:
-            resource['maxResults'] = self.max_results
-
-        if self.preserve_nulls is not None:
-            resource['preserveNulls'] = self.preserve_nulls
-
-        if self.timeout_ms is not None:
-            resource['timeoutMs'] = self.timeout_ms
-
-        if self.use_query_cache is not None:
-            resource['useQueryCache'] = self.use_query_cache
-
-        if self.use_legacy_sql is not None:
-            resource['useLegacySql'] = self.use_legacy_sql
-
-        if self.dry_run is not None:
-            resource['dryRun'] = self.dry_run
-
-        if len(self._udf_resources) > 0:
-            resource[self._UDF_KEY] = _build_udf_resources(self._udf_resources)
-
-        return resource
-
-    def run(self, client=None):
-        """API call:  run the query via a POST request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/query
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        if self._job is not None:
-            raise ValueError("Query job is already running.")
-
-        client = self._require_client(client)
-        path = '/projects/%s/queries' % (self.project,)
-        api_response = client.connection.api_request(
-            method='POST', path=path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def fetch_data(self, max_results=None, page_token=None, start_index=None,
-                   timeout_ms=None, client=None):
-        """API call:  fetch a page of query result data via a GET request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/jobs/getQueryResults
-
-        :type max_results: integer or ``NoneType``
-        :param max_results: maximum number of rows to return.
-
-        :type page_token: string or ``NoneType``
-        :param page_token: token representing a cursor into the table's rows.
-
-        :type start_index: integer or ``NoneType``
-        :param start_index: zero-based index of starting row
-
-        :type timeout_ms: integer or ``NoneType``
-        :param timeout_ms: timeout, in milliseconds, to wait for query to
-                           complete
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: tuple
-        :returns: ``(row_data, total_rows, page_token)``, where ``row_data``
-                  is a list of tuples, one per result row, containing only
-                  the values;  ``total_rows`` is a count of the total number
-                  of rows in the table;  and ``page_token`` is an opaque
-                  string which can be used to fetch the next batch of rows
-                  (``None`` if no further batches can be fetched).
-        :raises: ValueError if the query has not yet been executed.
-        """
-        if self.name is None:
-            raise ValueError("Query not yet executed:  call 'run()'")
-
-        client = self._require_client(client)
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        if start_index is not None:
-            params['startIndex'] = start_index
-
-        if timeout_ms is not None:
-            params['timeoutMs'] = timeout_ms
-
-        path = '/projects/%s/queries/%s' % (self.project, self.name)
-        response = client.connection.api_request(method='GET',
-                                                 path=path,
-                                                 query_params=params)
-        self._set_properties(response)
-
-        total_rows = response.get('totalRows')
-        if total_rows is not None:
-            total_rows = int(total_rows)
-        page_token = response.get('pageToken')
-        rows_data = _rows_from_json(response.get('rows', ()), self.schema)
-
-        return rows_data, total_rows, page_token
diff --git a/google/cloud/bigquery/schema.py b/google/cloud/bigquery/schema.py
deleted file mode 100644
index 15db5f8bcc1b..000000000000
--- a/google/cloud/bigquery/schema.py
+++ /dev/null
@@ -1,52 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Scheamas for BigQuery tables / queries."""
-
-
-class SchemaField(object):
-    """Describe a single field within a table schema.
-
-    :type name: str
-    :param name: the name of the field.
-
-    :type field_type: str
-    :param field_type: the type of the field (one of 'STRING', 'INTEGER',
-                       'FLOAT', 'BOOLEAN', 'TIMESTAMP' or 'RECORD').
-
-    :type mode: str
-    :param mode: the type of the field (one of 'NULLABLE', 'REQUIRED',
-                 or 'REPEATED').
-
-    :type description: str
-    :param description: optional description for the field.
-
-    :type fields: list of :class:`SchemaField`, or None
-    :param fields: subfields (requires ``field_type`` of 'RECORD').
-    """
-    def __init__(self, name, field_type, mode='NULLABLE', description=None,
-                 fields=None):
-        self.name = name
-        self.field_type = field_type
-        self.mode = mode
-        self.description = description
-        self.fields = fields
-
-    def __eq__(self, other):
-        return (
-            self.name == other.name and
-            self.field_type.lower() == other.field_type.lower() and
-            self.mode == other.mode and
-            self.description == other.description and
-            self.fields == other.fields)
diff --git a/google/cloud/bigquery/table.py b/google/cloud/bigquery/table.py
deleted file mode 100644
index dc04f97620c5..000000000000
--- a/google/cloud/bigquery/table.py
+++ /dev/null
@@ -1,1093 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Datasets."""
-
-import datetime
-import json
-import os
-
-import httplib2
-import six
-
-from google.cloud._helpers import _datetime_from_microseconds
-from google.cloud._helpers import _microseconds_from_datetime
-from google.cloud._helpers import _millis_from_datetime
-from google.cloud.exceptions import NotFound
-from google.cloud.exceptions import make_exception
-from google.cloud.streaming.exceptions import HttpError
-from google.cloud.streaming.http_wrapper import Request
-from google.cloud.streaming.http_wrapper import make_api_request
-from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-from google.cloud.streaming.transfer import Upload
-from google.cloud.bigquery.schema import SchemaField
-from google.cloud.bigquery._helpers import _rows_from_json
-
-
-_MARKER = object()
-
-
-class Table(object):
-    """Tables represent a set of rows whose values correspond to a schema.
-
-    See:
-    https://cloud.google.com/bigquery/docs/reference/v2/tables
-
-    :type name: str
-    :param name: the name of the table
-
-    :type dataset: :class:`google.cloud.bigquery.dataset.Dataset`
-    :param dataset: The dataset which contains the table.
-
-    :type schema: list of :class:`SchemaField`
-    :param schema: The table's schema
-    """
-
-    _schema = None
-
-    def __init__(self, name, dataset, schema=()):
-        self.name = name
-        self._dataset = dataset
-        self._properties = {}
-        # Let the @property do validation.
-        self.schema = schema
-
-    @property
-    def project(self):
-        """Project bound to the table.
-
-        :rtype: str
-        :returns: the project (derived from the dataset).
-        """
-        return self._dataset.project
-
-    @property
-    def dataset_name(self):
-        """Name of dataset containing the table.
-
-        :rtype: str
-        :returns: the ID (derived from the dataset).
-        """
-        return self._dataset.name
-
-    @property
-    def path(self):
-        """URL path for the table's APIs.
-
-        :rtype: str
-        :returns: the path based on project and dataste name.
-        """
-        return '%s/tables/%s' % (self._dataset.path, self.name)
-
-    @property
-    def schema(self):
-        """Table's schema.
-
-        :rtype: list of :class:`SchemaField`
-        :returns: fields describing the schema
-        """
-        return list(self._schema)
-
-    @schema.setter
-    def schema(self, value):
-        """Update table's schema
-
-        :type value: list of :class:`SchemaField`
-        :param value: fields describing the schema
-
-        :raises: TypeError if 'value' is not a sequence, or ValueError if
-                 any item in the sequence is not a SchemaField
-        """
-        if not all(isinstance(field, SchemaField) for field in value):
-            raise ValueError('Schema items must be fields')
-        self._schema = tuple(value)
-
-    @property
-    def created(self):
-        """Datetime at which the table was created.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the creation time (None until set from the server).
-        """
-        creation_time = self._properties.get('creationTime')
-        if creation_time is not None:
-            # creation_time will be in milliseconds.
-            return _datetime_from_microseconds(1000.0 * creation_time)
-
-    @property
-    def etag(self):
-        """ETag for the table resource.
-
-        :rtype: str, or ``NoneType``
-        :returns: the ETag (None until set from the server).
-        """
-        return self._properties.get('etag')
-
-    @property
-    def modified(self):
-        """Datetime at which the table was last modified.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the modification time (None until set from the server).
-        """
-        modified_time = self._properties.get('lastModifiedTime')
-        if modified_time is not None:
-            # modified_time will be in milliseconds.
-            return _datetime_from_microseconds(1000.0 * modified_time)
-
-    @property
-    def num_bytes(self):
-        """The size of the table in bytes.
-
-        :rtype: integer, or ``NoneType``
-        :returns: the byte count (None until set from the server).
-        """
-        num_bytes_as_str = self._properties.get('numBytes')
-        if num_bytes_as_str is not None:
-            return int(num_bytes_as_str)
-
-    @property
-    def num_rows(self):
-        """The number of rows in the table.
-
-        :rtype: integer, or ``NoneType``
-        :returns: the row count (None until set from the server).
-        """
-        num_rows_as_str = self._properties.get('numRows')
-        if num_rows_as_str is not None:
-            return int(num_rows_as_str)
-
-    @property
-    def self_link(self):
-        """URL for the table resource.
-
-        :rtype: str, or ``NoneType``
-        :returns: the URL (None until set from the server).
-        """
-        return self._properties.get('selfLink')
-
-    @property
-    def table_id(self):
-        """ID for the table resource.
-
-        :rtype: str, or ``NoneType``
-        :returns: the ID (None until set from the server).
-        """
-        return self._properties.get('id')
-
-    @property
-    def table_type(self):
-        """The type of the table.
-
-        Possible values are "TABLE" or "VIEW".
-
-        :rtype: str, or ``NoneType``
-        :returns: the URL (None until set from the server).
-        """
-        return self._properties.get('type')
-
-    @property
-    def partitioning_type(self):
-        """Time partitioning of the table.
-        :rtype: str, or ``NoneType``
-        :returns: Returns type if the table is partitioned, None otherwise.
-        """
-        return self._properties.get('timePartitioning', {}).get('type')
-
-    @partitioning_type.setter
-    def partitioning_type(self, value):
-        """Update the partitioning type of the table
-
-        :type value: str
-        :param value: partitioning type only "DAY" is currently supported
-        """
-        if value not in ('DAY', None):
-            raise ValueError("value must be one of ['DAY', None]")
-
-        if value is None:
-            self._properties.pop('timePartitioning', None)
-        else:
-            time_part = self._properties.setdefault('timePartitioning', {})
-            time_part['type'] = value.upper()
-
-    @property
-    def partition_expiration(self):
-        """Expiration time in ms for a partition
-        :rtype: int, or ``NoneType``
-        :returns: Returns the time in ms for partition expiration
-        """
-        return self._properties.get('timePartitioning', {}).get('expirationMs')
-
-    @partition_expiration.setter
-    def partition_expiration(self, value):
-        """Update the experation time in ms for a partition
-
-        :type value: int
-        :param value: partition experiation time in ms
-        """
-        if not isinstance(value, (int, type(None))):
-            raise ValueError(
-                "must be an integer representing millisseconds or None")
-
-        if value is None:
-            if 'timePartitioning' in self._properties:
-                self._properties['timePartitioning'].pop('expirationMs')
-        else:
-            try:
-                self._properties['timePartitioning']['expirationMs'] = value
-            except KeyError:
-                self._properties['timePartitioning'] = {'type': 'DAY'}
-                self._properties['timePartitioning']['expirationMs'] = value
-
-    @property
-    def description(self):
-        """Description of the table.
-
-        :rtype: str, or ``NoneType``
-        :returns: The description as set by the user, or None (the default).
-        """
-        return self._properties.get('description')
-
-    @description.setter
-    def description(self, value):
-        """Update description of the table.
-
-        :type value: str, or ``NoneType``
-        :param value: new description
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['description'] = value
-
-    @property
-    def expires(self):
-        """Datetime at which the table will be removed.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the expiration time, or None
-        """
-        expiration_time = self._properties.get('expirationTime')
-        if expiration_time is not None:
-            # expiration_time will be in milliseconds.
-            return _datetime_from_microseconds(1000.0 * expiration_time)
-
-    @expires.setter
-    def expires(self, value):
-        """Update datetime at which the table will be removed.
-
-        :type value: ``datetime.datetime``, or ``NoneType``
-        :param value: the new expiration time, or None
-        """
-        if not isinstance(value, datetime.datetime) and value is not None:
-            raise ValueError("Pass a datetime, or None")
-        self._properties['expirationTime'] = _millis_from_datetime(value)
-
-    @property
-    def friendly_name(self):
-        """Title of the table.
-
-        :rtype: str, or ``NoneType``
-        :returns: The name as set by the user, or None (the default).
-        """
-        return self._properties.get('friendlyName')
-
-    @friendly_name.setter
-    def friendly_name(self, value):
-        """Update title of the table.
-
-        :type value: str, or ``NoneType``
-        :param value: new title
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['friendlyName'] = value
-
-    @property
-    def location(self):
-        """Location in which the table is hosted.
-
-        :rtype: str, or ``NoneType``
-        :returns: The location as set by the user, or None (the default).
-        """
-        return self._properties.get('location')
-
-    @location.setter
-    def location(self, value):
-        """Update location in which the table is hosted.
-
-        :type value: str, or ``NoneType``
-        :param value: new location
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['location'] = value
-
-    @property
-    def view_query(self):
-        """SQL query defining the table as a view.
-
-        :rtype: str, or ``NoneType``
-        :returns: The query as set by the user, or None (the default).
-        """
-        view = self._properties.get('view')
-        if view is not None:
-            return view.get('query')
-
-    @view_query.setter
-    def view_query(self, value):
-        """Update SQL query defining the table as a view.
-
-        :type value: str
-        :param value: new query
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types):
-            raise ValueError("Pass a string")
-        self._properties['view'] = {'query': value}
-
-    @view_query.deleter
-    def view_query(self):
-        """Delete SQL query defining the table as a view."""
-        self._properties.pop('view', None)
-
-    def list_partitions(self, client=None):
-        """List the partitions in a table.
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: list
-        :returns: a list of time partitions
-        """
-        query = self._require_client(client).run_sync_query(
-            'SELECT partition_id from [%s.%s$__PARTITIONS_SUMMARY__]' %
-            (self.dataset_name, self.name))
-        query.run()
-        return [row[0] for row in query.rows]
-
-    @classmethod
-    def from_api_repr(cls, resource, dataset):
-        """Factory:  construct a table given its API representation
-
-        :type resource: dict
-        :param resource: table resource representation returned from the API
-
-        :type dataset: :class:`google.cloud.bigquery.dataset.Dataset`
-        :param dataset: The dataset containing the table.
-
-        :rtype: :class:`google.cloud.bigquery.table.Table`
-        :returns: Table parsed from ``resource``.
-        """
-        if ('tableReference' not in resource or
-                'tableId' not in resource['tableReference']):
-            raise KeyError('Resource lacks required identity information:'
-                           '["tableReference"]["tableId"]')
-        table_name = resource['tableReference']['tableId']
-        table = cls(table_name, dataset=dataset)
-        table._set_properties(resource)
-        return table
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: :class:`google.cloud.bigquery.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._dataset._client
-        return client
-
-    def _set_properties(self, api_response):
-        """Update properties from resource in body of ``api_response``
-
-        :type api_response: httplib2.Response
-        :param api_response: response returned from an API call
-        """
-        self._properties.clear()
-        cleaned = api_response.copy()
-        schema = cleaned.pop('schema', {'fields': ()})
-        self.schema = _parse_schema_resource(schema)
-        if 'creationTime' in cleaned:
-            cleaned['creationTime'] = float(cleaned['creationTime'])
-        if 'lastModifiedTime' in cleaned:
-            cleaned['lastModifiedTime'] = float(cleaned['lastModifiedTime'])
-        if 'expirationTime' in cleaned:
-            cleaned['expirationTime'] = float(cleaned['expirationTime'])
-        self._properties.update(cleaned)
-
-    def _build_resource(self):
-        """Generate a resource for ``create`` or ``update``."""
-        resource = {
-            'tableReference': {
-                'projectId': self._dataset.project,
-                'datasetId': self._dataset.name,
-                'tableId': self.name},
-        }
-        if self.description is not None:
-            resource['description'] = self.description
-
-        if self.expires is not None:
-            value = _millis_from_datetime(self.expires)
-            resource['expirationTime'] = value
-
-        if self.friendly_name is not None:
-            resource['friendlyName'] = self.friendly_name
-
-        if self.location is not None:
-            resource['location'] = self.location
-
-        if self.partitioning_type is not None:
-            resource['timePartitioning'] = self._properties['timePartitioning']
-
-        if self.view_query is not None:
-            view = resource['view'] = {}
-            view['query'] = self.view_query
-        elif self._schema:
-            resource['schema'] = {
-                'fields': _build_schema_resource(self._schema)
-            }
-        else:
-            raise ValueError("Set either 'view_query' or 'schema'.")
-
-        return resource
-
-    def create(self, client=None):
-        """API call:  create the dataset via a PUT request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/insert
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-        path = '/projects/%s/datasets/%s/tables' % (
-            self._dataset.project, self._dataset.name)
-        api_response = client.connection.api_request(
-            method='POST', path=path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the table via a GET request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/get
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the table.
-        """
-        client = self._require_client(client)
-
-        try:
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params={'fields': 'id'})
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  refresh table properties via a GET request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/get
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-
-        api_response = client.connection.api_request(
-            method='GET', path=self.path)
-        self._set_properties(api_response)
-
-    def patch(self,
-              client=None,
-              friendly_name=_MARKER,
-              description=_MARKER,
-              location=_MARKER,
-              expires=_MARKER,
-              view_query=_MARKER,
-              schema=_MARKER):
-        """API call:  update individual table properties via a PATCH request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/patch
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :type friendly_name: str or ``NoneType``
-        :param friendly_name: point in time at which the table expires.
-
-        :type description: str or ``NoneType``
-        :param description: point in time at which the table expires.
-
-        :type location: str or ``NoneType``
-        :param location: point in time at which the table expires.
-
-        :type expires: :class:`datetime.datetime` or ``NoneType``
-        :param expires: point in time at which the table expires.
-
-        :type view_query: str
-        :param view_query: SQL query defining the table as a view
-
-        :type schema: list of :class:`SchemaField`
-        :param schema: fields describing the schema
-
-        :raises: ValueError for invalid value types.
-        """
-        client = self._require_client(client)
-
-        partial = {}
-
-        if expires is not _MARKER:
-            if (not isinstance(expires, datetime.datetime) and
-                    expires is not None):
-                raise ValueError("Pass a datetime, or None")
-            partial['expirationTime'] = _millis_from_datetime(expires)
-
-        if description is not _MARKER:
-            partial['description'] = description
-
-        if friendly_name is not _MARKER:
-            partial['friendlyName'] = friendly_name
-
-        if location is not _MARKER:
-            partial['location'] = location
-
-        if view_query is not _MARKER:
-            if view_query is None:
-                partial['view'] = None
-            else:
-                partial['view'] = {'query': view_query}
-
-        if schema is not _MARKER:
-            if schema is None:
-                partial['schema'] = None
-            else:
-                partial['schema'] = {
-                    'fields': _build_schema_resource(schema)}
-
-        api_response = client.connection.api_request(
-            method='PATCH', path=self.path, data=partial)
-        self._set_properties(api_response)
-
-    def update(self, client=None):
-        """API call:  update table properties via a PUT request
-
-        See
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/update
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-        api_response = client.connection.api_request(
-            method='PUT', path=self.path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def delete(self, client=None):
-        """API call:  delete the table via a DELETE request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tables/delete
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-        """
-        client = self._require_client(client)
-        client.connection.api_request(method='DELETE', path=self.path)
-
-    def fetch_data(self, max_results=None, page_token=None, client=None):
-        """API call:  fetch the table data via a GET request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tabledata/list
-
-        .. note::
-
-           This method assumes that its instance's ``schema`` attribute is
-           up-to-date with the schema as defined on the back-end:  if the
-           two schemas are not identical, the values returned may be
-           incomplete.  To ensure that the local copy of the schema is
-           up-to-date, call the table's ``reload`` method.
-
-        :type max_results: integer or ``NoneType``
-        :param max_results: maximum number of rows to return.
-
-        :type page_token: str or ``NoneType``
-        :param page_token: token representing a cursor into the table's rows.
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: tuple
-        :returns: ``(row_data, total_rows, page_token)``, where ``row_data``
-                  is a list of tuples, one per result row, containing only
-                  the values;  ``total_rows`` is a count of the total number
-                  of rows in the table;  and ``page_token`` is an opaque
-                  string which can be used to fetch the next batch of rows
-                  (``None`` if no further batches can be fetched).
-        """
-        client = self._require_client(client)
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        response = client.connection.api_request(method='GET',
-                                                 path='%s/data' % self.path,
-                                                 query_params=params)
-        total_rows = response.get('totalRows')
-        if total_rows is not None:
-            total_rows = int(total_rows)
-        page_token = response.get('pageToken')
-        rows_data = _rows_from_json(response.get('rows', ()), self._schema)
-
-        return rows_data, total_rows, page_token
-
-    def insert_data(self,
-                    rows,
-                    row_ids=None,
-                    skip_invalid_rows=None,
-                    ignore_unknown_values=None,
-                    template_suffix=None,
-                    client=None):
-        """API call:  insert table data via a POST request
-
-        See:
-        https://cloud.google.com/bigquery/docs/reference/v2/tabledata/insertAll
-
-        :type rows: list of tuples
-        :param rows: Row data to be inserted. Each tuple should contain data
-                     for each schema field on the current table and in the
-                     same order as the schema fields.
-
-        :type row_ids: list of string
-        :param row_ids: Unique ids, one per row being inserted.  If not
-                        passed, no de-duplication occurs.
-
-        :type skip_invalid_rows: boolean or ``NoneType``
-        :param skip_invalid_rows: skip rows w/ invalid data?
-
-        :type ignore_unknown_values: boolean or ``NoneType``
-        :param ignore_unknown_values: ignore columns beyond schema?
-
-        :type template_suffix: str or ``NoneType``
-        :param template_suffix: treat ``name`` as a template table and provide
-                                a suffix. BigQuery will create the table
-                                ``<name> + <template_suffix>`` based on the
-                                schema of the template table. See:
-                                https://cloud.google.com/bigquery/streaming-data-into-bigquery#template-tables
-
-        :type client: :class:`~google.cloud.bigquery.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current dataset.
-
-        :rtype: list of mappings
-        :returns: One mapping per row with insert errors:  the "index" key
-                  identifies the row, and the "errors" key contains a list
-                  of the mappings describing one or more problems with the
-                  row.
-        """
-        client = self._require_client(client)
-        rows_info = []
-        data = {'rows': rows_info}
-
-        for index, row in enumerate(rows):
-            row_info = {}
-
-            for field, value in zip(self._schema, row):
-                if field.field_type == 'TIMESTAMP' and value is not None:
-                    # BigQuery stores TIMESTAMP data internally as a
-                    # UNIX timestamp with microsecond precision.
-                    # Specifies the number of seconds since the epoch.
-                    value = _microseconds_from_datetime(value) * 1e-6
-                row_info[field.name] = value
-
-            info = {'json': row_info}
-            if row_ids is not None:
-                info['insertId'] = row_ids[index]
-
-            rows_info.append(info)
-
-        if skip_invalid_rows is not None:
-            data['skipInvalidRows'] = skip_invalid_rows
-
-        if ignore_unknown_values is not None:
-            data['ignoreUnknownValues'] = ignore_unknown_values
-
-        if template_suffix is not None:
-            data['templateSuffix'] = template_suffix
-
-        response = client.connection.api_request(
-            method='POST',
-            path='%s/insertAll' % self.path,
-            data=data)
-        errors = []
-
-        for error in response.get('insertErrors', ()):
-            errors.append({'index': int(error['index']),
-                           'errors': error['errors']})
-
-        return errors
-
-    @staticmethod
-    def _check_response_error(request, http_response):
-        """Helper for :meth:`upload_from_file`."""
-        info = http_response.info
-        status = int(info['status'])
-        if not 200 <= status < 300:
-            faux_response = httplib2.Response({'status': status})
-            raise make_exception(faux_response, http_response.content,
-                                 error_info=request.url)
-
-    # pylint: disable=too-many-arguments,too-many-locals
-    def upload_from_file(self,
-                         file_obj,
-                         source_format,
-                         rewind=False,
-                         size=None,
-                         num_retries=6,
-                         allow_jagged_rows=None,
-                         allow_quoted_newlines=None,
-                         create_disposition=None,
-                         encoding=None,
-                         field_delimiter=None,
-                         ignore_unknown_values=None,
-                         max_bad_records=None,
-                         quote_character=None,
-                         skip_leading_rows=None,
-                         write_disposition=None,
-                         client=None):
-        """Upload the contents of this table from a file-like object.
-
-        The content type of the upload will either be
-        - The value passed in to the function (if any)
-        - ``text/csv``.
-
-        :type file_obj: file
-        :param file_obj: A file handle opened in binary mode for reading.
-
-        :type source_format: str
-        :param source_format: one of 'CSV' or 'NEWLINE_DELIMITED_JSON'.
-                              job configuration option; see
-                              :meth:`google.cloud.bigquery.job.LoadJob`
-
-        :type rewind: boolean
-        :param rewind: If True, seek to the beginning of the file handle before
-                       writing the file to Cloud Storage.
-
-        :type size: int
-        :param size: The number of bytes to read from the file handle.
-                     If not provided, we'll try to guess the size using
-                     :func:`os.fstat`. (If the file handle is not from the
-                     filesystem this won't be possible.)
-
-        :type num_retries: integer
-        :param num_retries: Number of upload retries. Defaults to 6.
-
-        :type allow_jagged_rows: boolean
-        :param allow_jagged_rows: job configuration option;  see
-                                  :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type allow_quoted_newlines: boolean
-        :param allow_quoted_newlines: job configuration option; see
-                                      :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type create_disposition: str
-        :param create_disposition: job configuration option; see
-                                   :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type encoding: str
-        :param encoding: job configuration option; see
-                         :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type field_delimiter: str
-        :param field_delimiter: job configuration option; see
-                                :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type ignore_unknown_values: boolean
-        :param ignore_unknown_values: job configuration option; see
-                                      :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type max_bad_records: integer
-        :param max_bad_records: job configuration option; see
-                                :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type quote_character: str
-        :param quote_character: job configuration option; see
-                                :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type skip_leading_rows: integer
-        :param skip_leading_rows: job configuration option; see
-                                  :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type write_disposition: str
-        :param write_disposition: job configuration option; see
-                                  :meth:`google.cloud.bigquery.job.LoadJob`.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current dataset.
-
-        :rtype: :class:`google.cloud.bigquery.jobs.LoadTableFromStorageJob`
-        :returns: the job instance used to load the data (e.g., for
-                  querying status). Note that the job is already started:
-                  do not call ``job.begin()``.
-        :raises: :class:`ValueError` if ``size`` is not passed in and can not
-                 be determined, or if the ``file_obj`` can be detected to be
-                 a file opened in text mode.
-        """
-        client = self._require_client(client)
-        connection = client.connection
-        content_type = 'application/octet-stream'
-
-        # Rewind the file if desired.
-        if rewind:
-            file_obj.seek(0, os.SEEK_SET)
-
-        mode = getattr(file_obj, 'mode', None)
-
-        if mode is not None and mode not in ('rb', 'r+b', 'rb+'):
-            raise ValueError(
-                "Cannot upload files opened in text mode:  use "
-                "open(filename, mode='rb') or open(filename, mode='r+b')")
-
-        # Get the basic stats about the file.
-        total_bytes = size
-        if total_bytes is None:
-            if hasattr(file_obj, 'fileno'):
-                total_bytes = os.fstat(file_obj.fileno()).st_size
-            else:
-                raise ValueError('total bytes could not be determined. Please '
-                                 'pass an explicit size.')
-        headers = {
-            'Accept': 'application/json',
-            'Accept-Encoding': 'gzip, deflate',
-            'User-Agent': connection.USER_AGENT,
-            'content-type': 'application/json',
-        }
-
-        metadata = {
-            'configuration': {
-                'load': {
-                    'sourceFormat': source_format,
-                    'schema': {
-                        'fields': _build_schema_resource(self._schema),
-                    },
-                    'destinationTable': {
-                        'projectId': self._dataset.project,
-                        'datasetId': self._dataset.name,
-                        'tableId': self.name,
-                    }
-                }
-            }
-        }
-
-        _configure_job_metadata(metadata, allow_jagged_rows,
-                                allow_quoted_newlines, create_disposition,
-                                encoding, field_delimiter,
-                                ignore_unknown_values, max_bad_records,
-                                quote_character, skip_leading_rows,
-                                write_disposition)
-
-        upload = Upload(file_obj, content_type, total_bytes,
-                        auto_transfer=False)
-
-        url_builder = _UrlBuilder()
-        upload_config = _UploadConfig()
-
-        # Base URL may change once we know simple vs. resumable.
-        base_url = connection.API_BASE_URL + '/upload'
-        path = '/projects/%s/jobs' % (self._dataset.project,)
-        upload_url = connection.build_api_url(api_base_url=base_url, path=path)
-
-        # Use apitools 'Upload' facility.
-        request = Request(upload_url, 'POST', headers,
-                          body=json.dumps(metadata))
-
-        upload.configure_request(upload_config, request, url_builder)
-        query_params = url_builder.query_params
-        base_url = connection.API_BASE_URL + '/upload'
-        request.url = connection.build_api_url(api_base_url=base_url,
-                                               path=path,
-                                               query_params=query_params)
-        try:
-            upload.initialize_upload(request, connection.http)
-        except HttpError as err_response:
-            faux_response = httplib2.Response(err_response.response)
-            raise make_exception(faux_response, err_response.content,
-                                 error_info=request.url)
-
-        if upload.strategy == RESUMABLE_UPLOAD:
-            http_response = upload.stream_file(use_chunks=True)
-        else:
-            http_response = make_api_request(connection.http, request,
-                                             retries=num_retries)
-
-        self._check_response_error(request, http_response)
-
-        response_content = http_response.content
-        if not isinstance(response_content,
-                          six.string_types):  # pragma: NO COVER  Python3
-            response_content = response_content.decode('utf-8')
-        return client.job_from_resource(json.loads(response_content))
-    # pylint: enable=too-many-arguments,too-many-locals
-
-
-def _configure_job_metadata(metadata,  # pylint: disable=too-many-arguments
-                            allow_jagged_rows,
-                            allow_quoted_newlines,
-                            create_disposition,
-                            encoding,
-                            field_delimiter,
-                            ignore_unknown_values,
-                            max_bad_records,
-                            quote_character,
-                            skip_leading_rows,
-                            write_disposition):
-    """Helper for :meth:`Table.upload_from_file`."""
-    load_config = metadata['configuration']['load']
-
-    if allow_jagged_rows is not None:
-        load_config['allowJaggedRows'] = allow_jagged_rows
-
-    if allow_quoted_newlines is not None:
-        load_config['allowQuotedNewlines'] = allow_quoted_newlines
-
-    if create_disposition is not None:
-        load_config['createDisposition'] = create_disposition
-
-    if encoding is not None:
-        load_config['encoding'] = encoding
-
-    if field_delimiter is not None:
-        load_config['fieldDelimiter'] = field_delimiter
-
-    if ignore_unknown_values is not None:
-        load_config['ignoreUnknownValues'] = ignore_unknown_values
-
-    if max_bad_records is not None:
-        load_config['maxBadRecords'] = max_bad_records
-
-    if quote_character is not None:
-        load_config['quote'] = quote_character
-
-    if skip_leading_rows is not None:
-        load_config['skipLeadingRows'] = skip_leading_rows
-
-    if write_disposition is not None:
-        load_config['writeDisposition'] = write_disposition
-
-
-def _parse_schema_resource(info):
-    """Parse a resource fragment into a schema field.
-
-    :type info: mapping
-    :param info: should contain a "fields" key to be parsed
-
-    :rtype: list of :class:`SchemaField`, or ``NoneType``
-    :returns: a list of parsed fields, or ``None`` if no "fields" key is
-                present in ``info``.
-    """
-    if 'fields' not in info:
-        return None
-
-    schema = []
-    for r_field in info['fields']:
-        name = r_field['name']
-        field_type = r_field['type']
-        mode = r_field.get('mode', 'NULLABLE')
-        description = r_field.get('description')
-        sub_fields = _parse_schema_resource(r_field)
-        schema.append(
-            SchemaField(name, field_type, mode, description, sub_fields))
-    return schema
-
-
-def _build_schema_resource(fields):
-    """Generate a resource fragment for a schema.
-
-    :type fields: sequence of :class:`SchemaField`
-    :param fields: schema to be dumped
-
-    :rtype: mapping
-    :returns: a mapping describing the schema of the supplied fields.
-    """
-    infos = []
-    for field in fields:
-        info = {'name': field.name,
-                'type': field.field_type,
-                'mode': field.mode}
-        if field.description is not None:
-            info['description'] = field.description
-        if field.fields is not None:
-            info['fields'] = _build_schema_resource(field.fields)
-        infos.append(info)
-    return infos
-
-
-class _UploadConfig(object):
-    """Faux message FBO apitools' 'configure_request'."""
-    accept = ['*/*']
-    max_size = None
-    resumable_multipart = True
-    resumable_path = u'/upload/bigquery/v2/projects/{project}/jobs'
-    simple_multipart = True
-    simple_path = u'/upload/bigquery/v2/projects/{project}/jobs'
-
-
-class _UrlBuilder(object):
-    """Faux builder FBO apitools' 'configure_request'"""
-    def __init__(self):
-        self.query_params = {}
-        self._relative_path = ''
diff --git a/google/cloud/bigtable/__init__.py b/google/cloud/bigtable/__init__.py
deleted file mode 100644
index 5a28af759a29..000000000000
--- a/google/cloud/bigtable/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Google Cloud Bigtable API package."""
-
-
-from google.cloud.bigtable.client import Client
diff --git a/google/cloud/bigtable/_generated/__init__.py b/google/cloud/bigtable/_generated/__init__.py
deleted file mode 100644
index ad35adcf05ae..000000000000
--- a/google/cloud/bigtable/_generated/__init__.py
+++ /dev/null
@@ -1,15 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Generated protobuf modules for Google Cloud Bigtable API."""
diff --git a/google/cloud/bigtable/_generated/_bigtable.proto b/google/cloud/bigtable/_generated/_bigtable.proto
deleted file mode 100644
index 49e27ca2ff5f..000000000000
--- a/google/cloud/bigtable/_generated/_bigtable.proto
+++ /dev/null
@@ -1,321 +0,0 @@
-// Copyright 2016 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.bigtable.v2;
-
-import "google/api/annotations.proto";
-import "google/bigtable/v2/data.proto";
-import "google/protobuf/wrappers.proto";
-import "google/rpc/status.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "BigtableProto";
-option java_package = "com.google.bigtable.v2";
-
-
-// Service for reading from and writing to existing Bigtable tables.
-service Bigtable {
-  // Streams back the contents of all requested rows, optionally
-  // applying the same Reader filter to each. Depending on their size,
-  // rows and cells may be broken up across multiple responses, but
-  // atomicity of each row will still be preserved. See the
-  // ReadRowsResponse documentation for details.
-  rpc ReadRows(ReadRowsRequest) returns (stream ReadRowsResponse) {
-    option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:readRows" body: "*" };
-  }
-
-  // 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) {
-    option (google.api.http) = { get: "/v2/{table_name=projects/*/instances/*/tables/*}:sampleRowKeys" };
-  }
-
-  // Mutates a row atomically. Cells already present in the row are left
-  // unchanged unless explicitly changed by `mutation`.
-  rpc MutateRow(MutateRowRequest) returns (MutateRowResponse) {
-    option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:mutateRow" body: "*" };
-  }
-
-  // Mutates multiple rows in a batch. Each individual row is mutated
-  // atomically as in MutateRow, but the entire batch is not executed
-  // atomically.
-  rpc MutateRows(MutateRowsRequest) returns (stream MutateRowsResponse) {
-    option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:mutateRows" body: "*" };
-  }
-
-  // Mutates a row atomically based on the output of a predicate Reader filter.
-  rpc CheckAndMutateRow(CheckAndMutateRowRequest) returns (CheckAndMutateRowResponse) {
-    option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:checkAndMutateRow" body: "*" };
-  }
-
-  // Modifies a row atomically. The method reads the latest existing timestamp
-  // and value from the specified columns and writes a new 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) {
-    option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:readModifyWriteRow" body: "*" };
-  }
-}
-
-// Request message for Bigtable.ReadRows.
-message ReadRowsRequest {
-  // The unique name of the table from which to read.
-  // Values are of the form
-  // projects/&lt;project&gt;/instances/&lt;instance&gt;/tables/&lt;table&gt;
-  string table_name = 1;
-
-  // The row keys and/or ranges to read. If not specified, reads from all rows.
-  RowSet rows = 2;
-
-  // The filter to apply to the contents of the specified row(s). If unset,
-  // reads the entirety of each row.
-  RowFilter filter = 3;
-
-  // The read will terminate after committing to N rows' worth of results. The
-  // default (zero) is to return all results.
-  int64 rows_limit = 4;
-}
-
-// Response message for Bigtable.ReadRows.
-message ReadRowsResponse {
-  // Specifies a piece of a row's contents returned as part of the read
-  // response stream.
-  message CellChunk {
-    // The row key for this chunk of data.  If the row key is empty,
-    // this CellChunk is a continuation of the same row as the previous
-    // CellChunk in the response stream, even if that CellChunk was in a
-    // previous ReadRowsResponse message.
-    bytes row_key = 1;
-
-    // The column family name for this chunk of data.  If this message
-    // is not present this CellChunk is a continuation of the same column
-    // family as the previous CellChunk.  The empty string can occur as a
-    // column family name in a response so clients must check
-    // explicitly for the presence of this message, not just for
-    // `family_name.value` being non-empty.
-    google.protobuf.StringValue family_name = 2;
-
-    // The column qualifier for this chunk of data.  If this message
-    // is not present, this CellChunk is a continuation of the same column
-    // as the previous CellChunk.  Column qualifiers may be empty so
-    // clients must check for the presence of this message, not just
-    // for `qualifier.value` being non-empty.
-    google.protobuf.BytesValue qualifier = 3;
-
-    // The cell's stored timestamp, which also uniquely identifies it
-    // within its column.  Values are always expressed in
-    // microseconds, but individual tables may set a coarser
-    // granularity to further restrict the allowed values. For
-    // example, a table which specifies millisecond granularity will
-    // only allow values of `timestamp_micros` which are multiples of
-    // 1000.  Timestamps are only set in the first CellChunk per cell
-    // (for cells split into multiple chunks).
-    int64 timestamp_micros = 4;
-
-    // Labels applied to the cell by a
-    // [RowFilter][google.bigtable.v2.RowFilter].  Labels are only set
-    // on the first CellChunk per cell.
-    repeated string labels = 5;
-
-    // The value stored in the cell.  Cell values can be split across
-    // multiple CellChunks.  In that case only the value field will be
-    // set in CellChunks after the first: the timestamp and labels
-    // will only be present in the first CellChunk, even if the first
-    // CellChunk came in a previous ReadRowsResponse.
-    bytes value = 6;
-
-    // If this CellChunk is part of a chunked cell value and this is
-    // not the final chunk of that cell, value_size will be set to the
-    // total length of the cell value.  The client can use this size
-    // to pre-allocate memory to hold the full cell value.
-    int32 value_size = 7;
-
-    oneof row_status {
-      // Indicates that the client should drop all previous chunks for
-      // `row_key`, as it will be re-read from the beginning.
-      bool reset_row = 8;
-
-      // Indicates that the client can safely process all previous chunks for
-      // `row_key`, as its data has been fully read.
-      bool commit_row = 9;
-    }
-  }
-
-  repeated CellChunk chunks = 1;
-
-  // Optionally the server might return the row key of the last row it
-  // has scanned.  The client can use this to construct a more
-  // efficient retry request if needed: any row keys or portions of
-  // ranges less than this row key can be dropped from the request.
-  // This is primarily useful for cases where the server has read a
-  // lot of data that was filtered out since the last committed row
-  // key, allowing the client to skip that work on a retry.
-  bytes last_scanned_row_key = 2;
-}
-
-// Request message for Bigtable.SampleRowKeys.
-message SampleRowKeysRequest {
-  // The unique name of the table from which to sample row keys.
-  // Values are of the form
-  // projects/&lt;project&gt;/instances/&lt;instance&gt;/tables/&lt;table&gt;
-  string table_name = 1;
-}
-
-// Response message for Bigtable.SampleRowKeys.
-message SampleRowKeysResponse {
-  // Sorted streamed sequence of sample row keys in the table. The table might
-  // have contents before the first row key in the list and after the last one,
-  // but a key containing the empty string indicates "end of table" and will be
-  // the last response given, if present.
-  // Note that row keys in this list may not have ever been written to or read
-  // from, and users should therefore not make any assumptions about the row key
-  // structure that are specific to their use case.
-  bytes row_key = 1;
-
-  // Approximate total storage space used by all rows in the table which precede
-  // `row_key`. Buffering the contents of all rows between two subsequent
-  // samples would require space roughly equal to the difference in their
-  // `offset_bytes` fields.
-  int64 offset_bytes = 2;
-}
-
-// Request message for Bigtable.MutateRow.
-message MutateRowRequest {
-  // The unique name of the table to which the mutation should be applied.
-  // Values are of the form
-  // projects/&lt;project&gt;/instances/&lt;instance&gt;/tables/&lt;table&gt;
-  string table_name = 1;
-
-  // The key of the row to which the mutation should be applied.
-  bytes row_key = 2;
-
-  // 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;
-}
-
-// Response message for Bigtable.MutateRow.
-message MutateRowResponse {
-
-}
-
-// Request message for BigtableService.MutateRows.
-message MutateRowsRequest {
-  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
-    // applied in order, meaning that earlier mutations can be masked by
-    // later ones.
-    // You must specify at least one mutation.
-    repeated Mutation mutations = 2;
-  }
-
-  // The unique name of the table to which the mutations should be applied.
-  string table_name = 1;
-
-  // 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;
-}
-
-// Response message for BigtableService.MutateRows.
-message MutateRowsResponse {
-  message Entry {
-    // The index into the original request's `entries` list of the Entry
-    // for which a result is being reported.
-    int64 index = 1;
-
-    // The result of the request Entry identified by `index`.
-    // Depending on how requests are batched during execution, it is possible
-    // for one Entry to fail due to an error with another Entry. In the event
-    // that this occurs, the same error will be reported for both entries.
-    google.rpc.Status status = 2;
-  }
-
-  // One or more results for Entries from the batch request.
-  repeated Entry entries = 1;
-}
-
-// Request message for Bigtable.CheckAndMutateRow.
-message CheckAndMutateRowRequest {
-  // The unique name of the table to which the conditional mutation should be
-  // applied.
-  // Values are of the form
-  // projects/&lt;project&gt;/instances/&lt;instance&gt;/tables/&lt;table&gt;
-  string table_name = 1;
-
-  // The key of the row to which the conditional mutation should be applied.
-  bytes row_key = 2;
-
-  // 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
-  // `false_mutations` will be executed. If unset, checks that the row contains
-  // any values at all.
-  RowFilter predicate_filter = 6;
-
-  // Changes to be atomically applied to the specified row if `predicate_filter`
-  // yields at least one cell when applied to `row_key`. Entries are applied in
-  // order, meaning that earlier mutations can be masked by later ones.
-  // Must contain at least one entry if `false_mutations` is empty, and at most
-  // 100000.
-  repeated Mutation true_mutations = 4;
-
-  // Changes to be atomically applied to the specified row if `predicate_filter`
-  // does not yield any cells when applied to `row_key`. Entries are applied in
-  // order, meaning that earlier mutations can be masked by later ones.
-  // Must contain at least one entry if `true_mutations` is empty, and at most
-  // 100000.
-  repeated Mutation false_mutations = 5;
-}
-
-// Response message for Bigtable.CheckAndMutateRow.
-message CheckAndMutateRowResponse {
-  // Whether or not the request's `predicate_filter` yielded any results for
-  // the specified row.
-  bool predicate_matched = 1;
-}
-
-// Request message for Bigtable.ReadModifyWriteRow.
-message ReadModifyWriteRowRequest {
-  // The unique name of the table to which the read/modify/write rules should be
-  // applied.
-  // Values are of the form
-  // projects/&lt;project&gt;/instances/&lt;instance&gt;/tables/&lt;table&gt;
-  string table_name = 1;
-
-  // The key of the row to which the read/modify/write rules should be applied.
-  bytes row_key = 2;
-
-  // 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;
-}
-
-// Response message for Bigtable.ReadModifyWriteRow.
-message ReadModifyWriteRowResponse {
-  // A Row containing the new contents of all cells modified by the request.
-  Row row = 1;
-}
diff --git a/google/cloud/bigtable/_generated/_bigtable_instance_admin.proto b/google/cloud/bigtable/_generated/_bigtable_instance_admin.proto
deleted file mode 100644
index bda5d2163532..000000000000
--- a/google/cloud/bigtable/_generated/_bigtable_instance_admin.proto
+++ /dev/null
@@ -1,232 +0,0 @@
-// Copyright 2016 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.bigtable.admin.v2;
-
-import "google/api/annotations.proto";
-import "google/bigtable/admin/v2/instance.proto";
-import "google/longrunning/operations.proto";
-import "google/protobuf/empty.proto";
-import "google/protobuf/timestamp.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "BigtableInstanceAdminProto";
-option java_package = "com.google.bigtable.admin.v2";
-
-
-// Service for creating, configuring, and deleting Cloud Bigtable Instances and
-// Clusters. Provides access to the Instance and Cluster schemas only, not the
-// tables metadata or data stored in those tables.
-service BigtableInstanceAdmin {
-  // Create an instance within a project.
-  rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) {
-    option (google.api.http) = { post: "/v2/{parent=projects/*}/instances" body: "*" };
-  }
-
-  // Gets information about an instance.
-  rpc GetInstance(GetInstanceRequest) returns (Instance) {
-    option (google.api.http) = { get: "/v2/{name=projects/*/instances/*}" };
-  }
-
-  // Lists information about instances in a project.
-  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
-    option (google.api.http) = { get: "/v2/{parent=projects/*}/instances" };
-  }
-
-  // Updates an instance within a project.
-  rpc UpdateInstance(Instance) returns (Instance) {
-    option (google.api.http) = { put: "/v2/{name=projects/*/instances/*}" body: "*" };
-  }
-
-  // Delete an instance from a project.
-  rpc DeleteInstance(DeleteInstanceRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*}" };
-  }
-
-  // Creates a cluster within an instance.
-  rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) {
-    option (google.api.http) = { post: "/v2/{parent=projects/*/instances/*}/clusters" body: "cluster" };
-  }
-
-  // Gets information about a cluster.
-  rpc GetCluster(GetClusterRequest) returns (Cluster) {
-    option (google.api.http) = { get: "/v2/{name=projects/*/instances/*/clusters/*}" };
-  }
-
-  // Lists information about clusters in an instance.
-  rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
-    option (google.api.http) = { get: "/v2/{parent=projects/*/instances/*}/clusters" };
-  }
-
-  // Updates a cluster within an instance.
-  rpc UpdateCluster(Cluster) returns (google.longrunning.Operation) {
-    option (google.api.http) = { put: "/v2/{name=projects/*/instances/*/clusters/*}" body: "*" };
-  }
-
-  // Deletes a cluster from an instance.
-  rpc DeleteCluster(DeleteClusterRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*/clusters/*}" };
-  }
-}
-
-// 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/<project>
-  string parent = 1;
-
-  // The id to be used when referring to the new instance within its project,
-  // e.g. just the "myinstance" section of the full name
-  // "projects/myproject/instances/myinstance"
-  string instance_id = 2;
-
-  // The instance to create.
-  // Fields marked "@OutputOnly" must be left blank.
-  Instance instance = 3;
-
-  // The clusters to be created within the instance, mapped by desired
-  // cluster ID (e.g. just the "mycluster" part of the full name
-  // "projects/myproject/instances/myinstance/clusters/mycluster").
-  // Fields marked "@OutputOnly" must be left blank.
-  // Currently exactly one cluster must be specified.
-  map<string, Cluster> clusters = 4;
-}
-
-// Request message for BigtableInstanceAdmin.GetInstance.
-message GetInstanceRequest {
-  // The unique name of the requested instance. Values are of the form
-  // projects/<project>/instances/<instance>
-  string name = 1;
-}
-
-// 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/<project>
-  string parent = 1;
-
-  // The value of `next_page_token` returned by a previous call.
-  string page_token = 2;
-}
-
-// Response message for BigtableInstanceAdmin.ListInstances.
-message ListInstancesResponse {
-  // The list of requested instances.
-  repeated Instance instances = 1;
-
-  // Locations from which Instance information could not be retrieved,
-  // due to an outage or some other transient condition.
-  // Instances whose Clusters are all in one of the failed locations
-  // may be missing from 'instances', and Instances with at least one
-  // Cluster in a failed location may only have partial information returned.
-  repeated string failed_locations = 2;
-
-  // Set if not all instances could be returned in a single response.
-  // Pass this value to `page_token` in another request to get the next
-  // page of results.
-  string next_page_token = 3;
-}
-
-// Request message for BigtableInstanceAdmin.DeleteInstance.
-message DeleteInstanceRequest {
-  // The unique name of the instance to be deleted.
-  // Values are of the form projects/<project>/instances/<instance>
-  string name = 1;
-}
-
-// Request message for BigtableInstanceAdmin.CreateCluster.
-message CreateClusterRequest {
-  // The unique name of the instance in which to create the new cluster.
-  // Values are of the form
-  // projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*
-  string parent = 1;
-
-  // The id to be used when referring to the new cluster within its instance,
-  // e.g. just the "mycluster" section of the full name
-  // "projects/myproject/instances/myinstance/clusters/mycluster"
-  string cluster_id = 2;
-
-  // The cluster to be created.
-  // Fields marked "@OutputOnly" must be left blank.
-  Cluster cluster = 3;
-}
-
-// Request message for BigtableInstanceAdmin.GetCluster.
-message GetClusterRequest {
-  // The unique name of the requested cluster. Values are of the form
-  // projects/<project>/instances/<instance>/clusters/<cluster>
-  string name = 1;
-}
-
-// 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/<project>/instances/<instance>
-  // Use <instance> = '-' to list Clusters for all Instances in a project,
-  // for example "projects/myproject/instances/-"
-  string parent = 1;
-
-  // The value of `next_page_token` returned by a previous call.
-  string page_token = 2;
-}
-
-// Response message for BigtableInstanceAdmin.ListClusters.
-message ListClustersResponse {
-  // The list of requested clusters.
-  repeated Cluster clusters = 1;
-
-  // Locations from which Cluster information could not be retrieved,
-  // due to an outage or some other transient condition.
-  // Clusters from these locations may be missing from 'clusters',
-  // or may only have partial information returned.
-  repeated string failed_locations = 2;
-
-  // Set if not all clusters could be returned in a single response.
-  // Pass this value to `page_token` in another request to get the next
-  // page of results.
-  string next_page_token = 3;
-}
-
-// Request message for BigtableInstanceAdmin.DeleteCluster.
-message DeleteClusterRequest {
-  // The unique name of the cluster to be deleted. Values are of the form
-  // projects/<project>/instances/<instance>/clusters/<cluster>
-  string name = 1;
-}
-
-// The metadata for the Operation returned by CreateInstance.
-message CreateInstanceMetadata {
-  // The request that prompted the initiation of this CreateInstance operation.
-  CreateInstanceRequest original_request = 1;
-
-  // The time at which the original request was received.
-  google.protobuf.Timestamp request_time = 2;
-
-  // The time at which the operation failed or was completed successfully.
-  google.protobuf.Timestamp finish_time = 3;
-}
-
-// The metadata for the Operation returned by UpdateCluster.
-message UpdateClusterMetadata {
-  // The request that prompted the initiation of this UpdateCluster operation.
-  Cluster original_request = 1;
-
-  // The time at which the original request was received.
-  google.protobuf.Timestamp request_time = 2;
-
-  // The time at which the operation failed or was completed successfully.
-  google.protobuf.Timestamp finish_time = 3;
-}
diff --git a/google/cloud/bigtable/_generated/_bigtable_table_admin.proto b/google/cloud/bigtable/_generated/_bigtable_table_admin.proto
deleted file mode 100644
index 0a39e298359c..000000000000
--- a/google/cloud/bigtable/_generated/_bigtable_table_admin.proto
+++ /dev/null
@@ -1,195 +0,0 @@
-// Copyright 2016 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.bigtable.admin.v2;
-
-import "google/api/annotations.proto";
-import "google/bigtable/admin/v2/table.proto";
-import "google/protobuf/empty.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "BigtableTableAdminProto";
-option java_package = "com.google.bigtable.admin.v2";
-
-
-// Service for creating, configuring, and deleting Cloud Bigtable tables.
-// Provides access to the table schemas only, not the data stored within
-// the tables.
-service BigtableTableAdmin {
-  // 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.
-  rpc CreateTable(CreateTableRequest) returns (Table) {
-    option (google.api.http) = { post: "/v2/{parent=projects/*/instances/*}/tables" body: "*" };
-  }
-
-  // Lists all tables served from a specified instance.
-  rpc ListTables(ListTablesRequest) returns (ListTablesResponse) {
-    option (google.api.http) = { get: "/v2/{parent=projects/*/instances/*}/tables" };
-  }
-
-  // Gets metadata information about the specified table.
-  rpc GetTable(GetTableRequest) returns (Table) {
-    option (google.api.http) = { get: "/v2/{name=projects/*/instances/*/tables/*}" };
-  }
-
-  // Permanently deletes a specified table and all of its data.
-  rpc DeleteTable(DeleteTableRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*/tables/*}" };
-  }
-
-  // Atomically performs a series of column family modifications
-  // on the specified table.
-  rpc ModifyColumnFamilies(ModifyColumnFamiliesRequest) returns (Table) {
-    option (google.api.http) = { post: "/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies" body: "*" };
-  }
-
-  // Permanently drop/delete a row range from a specified table. The request can
-  // specify whether to delete all rows in a table, or only those that match a
-  // particular prefix.
-  rpc DropRowRange(DropRowRangeRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = { post: "/v2/{name=projects/*/instances/*/tables/*}:dropRowRange" body: "*" };
-  }
-}
-
-// Request message for [google.bigtable.admin.v2.BigtableTableAdmin.CreateTable][google.bigtable.admin.v2.BigtableTableAdmin.CreateTable]
-message CreateTableRequest {
-  // An initial split point for a newly created table.
-  message Split {
-    // Row key to use as an initial tablet boundary.
-    bytes key = 1;
-  }
-
-  // The unique name of the instance in which to create the table.
-  // Values are of the form projects/<project>/instances/<instance>
-  string parent = 1;
-
-  // 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;
-
-  // The Table to create.
-  Table table = 3;
-
-  // The optional list of row keys that will be used to initially split the
-  // table into several tablets (Tablets are similar to HBase regions).
-  // Given two split keys, "s1" and "s2", three tablets will be created,
-  // spanning the key ranges: [, s1), [s1, s2), [s2, ).
-  //
-  // Example:
-  //  * Row keys := ["a", "apple", "custom", "customer_1", "customer_2",
-  //                 "other", "zz"]
-  //  * initial_split_keys := ["apple", "customer_1", "customer_2", "other"]
-  //  * Key assignment:
-  //    - Tablet 1 [, apple)                => {"a"}.
-  //    - Tablet 2 [apple, customer_1)      => {"apple", "custom"}.
-  //    - Tablet 3 [customer_1, customer_2) => {"customer_1"}.
-  //    - Tablet 4 [customer_2, other)      => {"customer_2"}.
-  //    - Tablet 5 [other, )                => {"other", "zz"}.
-  repeated Split initial_splits = 4;
-}
-
-// 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.
-  // Values are of the form projects/<project>/instances/<instance>/tables/<table>
-  string name = 1;
-
-  oneof target {
-    // Delete all rows that start with this row key prefix. Prefix cannot be
-    // zero length.
-    bytes row_key_prefix = 2;
-
-    // Delete all rows in the table. Setting this to false is a no-op.
-    bool delete_all_data_from_table = 3;
-  }
-}
-
-// 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/<project>/instances/<instance>
-  string parent = 1;
-
-  // The view to be applied to the returned tables' fields.
-  // Defaults to NAME_ONLY if unspecified (no others are currently supported).
-  Table.View view = 2;
-
-  // The value of `next_page_token` returned by a previous call.
-  string page_token = 3;
-}
-
-// Response message for [google.bigtable.admin.v2.BigtableTableAdmin.ListTables][google.bigtable.admin.v2.BigtableTableAdmin.ListTables]
-message ListTablesResponse {
-  // The tables present in the requested cluster.
-  repeated Table tables = 1;
-
-  // Set if not all tables could be returned in a single response.
-  // Pass this value to `page_token` in another request to get the next
-  // page of results.
-  string next_page_token = 2;
-}
-
-// Request message for [google.bigtable.admin.v2.BigtableTableAdmin.GetTable][google.bigtable.admin.v2.BigtableTableAdmin.GetTable]
-message GetTableRequest {
-  // The unique name of the requested table.
-  // Values are of the form projects/<project>/instances/<instance>/tables/<table>
-  string name = 1;
-
-  // The view to be applied to the returned table's fields.
-  // Defaults to SCHEMA_ONLY if unspecified.
-  Table.View view = 2;
-}
-
-// 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.
-  // Values are of the form projects/<project>/instances/<instance>/tables/<table>
-  string name = 1;
-}
-
-// Request message for [google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies][google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies]
-message ModifyColumnFamiliesRequest {
-  // A create, update, or delete of a particular column family.
-  message Modification {
-    // The ID of the column family to be modified.
-    string id = 1;
-
-    oneof mod {
-      // Create a new column family with the specified schema, or fail if
-      // one already exists with the given ID.
-      ColumnFamily create = 2;
-
-      // Update an existing column family to the specified schema, or fail
-      // if no column family exists with the given ID.
-      ColumnFamily update = 3;
-
-      // Drop (delete) the column family with the given ID, or fail if no such
-      // family exists.
-      bool drop = 4;
-    }
-  }
-
-  // The unique name of the table whose families should be modified.
-  // Values are of the form projects/<project>/instances/<instance>/tables/<table>
-  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;
-}
diff --git a/google/cloud/bigtable/_generated/_common.proto b/google/cloud/bigtable/_generated/_common.proto
deleted file mode 100644
index 1912e03e0446..000000000000
--- a/google/cloud/bigtable/_generated/_common.proto
+++ /dev/null
@@ -1,37 +0,0 @@
-// Copyright 2016 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.bigtable.admin.v2;
-
-import "google/api/annotations.proto";
-import "google/protobuf/timestamp.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "CommonProto";
-option java_package = "com.google.bigtable.admin.v2";
-
-
-// Storage media types for persisting Bigtable data.
-enum StorageType {
-  // The user did not specify a storage type.
-  STORAGE_TYPE_UNSPECIFIED = 0;
-
-  // Flash (SSD) storage should be used.
-  SSD = 1;
-
-  // Magnetic drive (HDD) storage should be used.
-  HDD = 2;
-}
diff --git a/google/cloud/bigtable/_generated/_data.proto b/google/cloud/bigtable/_generated/_data.proto
deleted file mode 100644
index 720f48279b8f..000000000000
--- a/google/cloud/bigtable/_generated/_data.proto
+++ /dev/null
@@ -1,532 +0,0 @@
-// Copyright 2016 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.bigtable.v2;
-
-option java_multiple_files = true;
-option java_outer_classname = "DataProto";
-option java_package = "com.google.bigtable.v2";
-
-
-// Specifies the complete (requested) contents of a single row of a table.
-// Rows which exceed 256MiB in size cannot be read in full.
-message Row {
-  // The unique key which identifies this row within its table. This is the same
-  // key that's used to identify the row in, for example, a MutateRowRequest.
-  // May contain any non-empty byte string up to 4KiB in length.
-  bytes key = 1;
-
-  // May be empty, but only if the entire row is empty.
-  // The mutual ordering of column families is not specified.
-  repeated Family families = 2;
-}
-
-// Specifies (some of) the contents of a single row/column family intersection
-// of a table.
-message Family {
-  // The unique key which identifies this family within its row. This is the
-  // same key that's used to identify the family in, for example, a RowFilter
-  // which sets its "family_name_regex_filter" field.
-  // Must match `[-_.a-zA-Z0-9]+`, except that AggregatingRowProcessors may
-  // produce cells in a sentinel family with an empty name.
-  // Must be no greater than 64 characters in length.
-  string name = 1;
-
-  // Must not be empty. Sorted in order of increasing "qualifier".
-  repeated Column columns = 2;
-}
-
-// Specifies (some of) the contents of a single row/column intersection of a
-// table.
-message Column {
-  // The unique key which identifies this column within its family. This is the
-  // same key that's used to identify the column in, for example, a RowFilter
-  // which sets its `column_qualifier_regex_filter` field.
-  // May contain any byte string, including the empty string, up to 16kiB in
-  // length.
-  bytes qualifier = 1;
-
-  // Must not be empty. Sorted in order of decreasing "timestamp_micros".
-  repeated Cell cells = 2;
-}
-
-// Specifies (some of) the contents of a single row/column/timestamp of a table.
-message Cell {
-  // The cell's stored timestamp, which also uniquely identifies it within
-  // its column.
-  // Values are always expressed in microseconds, but individual tables may set
-  // a coarser granularity to further restrict the allowed values. For
-  // example, a table which specifies millisecond granularity will only allow
-  // values of `timestamp_micros` which are multiples of 1000.
-  int64 timestamp_micros = 1;
-
-  // The value stored in the cell.
-  // May contain any byte string, including the empty string, up to 100MiB in
-  // length.
-  bytes value = 2;
-
-  // Labels applied to the cell by a [RowFilter][google.bigtable.v2.RowFilter].
-  repeated string labels = 3;
-}
-
-// Specifies a contiguous range of rows.
-message RowRange {
-  // The row key at which to start the range.
-  // If neither field is set, interpreted as the empty string, inclusive.
-  oneof start_key {
-    // Used when giving an inclusive lower bound for the range.
-    bytes start_key_closed = 1;
-
-    // Used when giving an exclusive lower bound for the range.
-    bytes start_key_open = 2;
-  }
-
-  // The row key at which to end the range.
-  // If neither field is set, interpreted as the infinite row key, exclusive.
-  oneof end_key {
-    // Used when giving an inclusive upper bound for the range.
-    bytes end_key_open = 3;
-
-    // Used when giving an exclusive upper bound for the range.
-    bytes end_key_closed = 4;
-  }
-}
-
-// Specifies a non-contiguous set of rows.
-message RowSet {
-  // Single rows included in the set.
-  repeated bytes row_keys = 1;
-
-  // Contiguous row ranges included in the set.
-  repeated RowRange row_ranges = 2;
-}
-
-// Specifies a contiguous range of columns within a single column family.
-// The range spans from &lt;column_family&gt;:&lt;start_qualifier&gt; to
-// &lt;column_family&gt;:&lt;end_qualifier&gt;, where both bounds can be either
-// inclusive or exclusive.
-message ColumnRange {
-  // The name of the column family within which this range falls.
-  string family_name = 1;
-
-  // The column qualifier at which to start the range (within `column_family`).
-  // If neither field is set, interpreted as the empty string, inclusive.
-  oneof start_qualifier {
-    // Used when giving an inclusive lower bound for the range.
-    bytes start_qualifier_closed = 2;
-
-    // Used when giving an exclusive lower bound for the range.
-    bytes start_qualifier_open = 3;
-  }
-
-  // The column qualifier at which to end the range (within `column_family`).
-  // If neither field is set, interpreted as the infinite string, exclusive.
-  oneof end_qualifier {
-    // Used when giving an inclusive upper bound for the range.
-    bytes end_qualifier_closed = 4;
-
-    // Used when giving an exclusive upper bound for the range.
-    bytes end_qualifier_open = 5;
-  }
-}
-
-// Specified a contiguous range of microsecond timestamps.
-message TimestampRange {
-  // Inclusive lower bound. If left empty, interpreted as 0.
-  int64 start_timestamp_micros = 1;
-
-  // Exclusive upper bound. If left empty, interpreted as infinity.
-  int64 end_timestamp_micros = 2;
-}
-
-// Specifies a contiguous range of raw byte values.
-message ValueRange {
-  // The value at which to start the range.
-  // If neither field is set, interpreted as the empty string, inclusive.
-  oneof start_value {
-    // Used when giving an inclusive lower bound for the range.
-    bytes start_value_closed = 1;
-
-    // Used when giving an exclusive lower bound for the range.
-    bytes start_value_open = 2;
-  }
-
-  // The value at which to end the range.
-  // If neither field is set, interpreted as the infinite string, exclusive.
-  oneof end_value {
-    // Used when giving an inclusive upper bound for the range.
-    bytes end_value_closed = 3;
-
-    // Used when giving an exclusive upper bound for the range.
-    bytes end_value_open = 4;
-  }
-}
-
-// Takes a row as input and produces an alternate view of the row based on
-// specified rules. For example, a RowFilter might trim down a row to include
-// just the cells from columns matching a given regular expression, or might
-// return all the cells of a row but not their values. More complicated filters
-// can be composed out of these components to express requests such as, "within
-// every column of a particular family, give just the two most recent cells
-// which are older than timestamp X."
-//
-// There are two broad categories of RowFilters (true filters and transformers),
-// as well as two ways to compose simple filters into more complex ones
-// (chains and interleaves). They work as follows:
-//
-// * True filters alter the input row by excluding some of its cells wholesale
-// from the output row. An example of a true filter is the `value_regex_filter`,
-// which excludes cells whose values don't match the specified pattern. All
-// regex true filters use RE2 syntax (https://github.com/google/re2/wiki/Syntax)
-// in raw byte mode (RE2::Latin1), and are evaluated as full matches. An
-// important point to keep in mind is that `RE2(.)` is equivalent by default to
-// `RE2([^\n])`, meaning that it does not match newlines. When attempting to
-// match an arbitrary byte, you should therefore use the escape sequence `\C`,
-// which may need to be further escaped as `\\C` in your client language.
-//
-// * Transformers alter the input row by changing the values of some of its
-// cells in the output, without excluding them completely. Currently, the only
-// supported transformer is the `strip_value_transformer`, which replaces every
-// cell's value with the empty string.
-//
-// * Chains and interleaves are described in more detail in the
-// RowFilter.Chain and RowFilter.Interleave documentation.
-//
-// The total serialized size of a RowFilter message must not
-// exceed 4096 bytes, and RowFilters may not be nested within each other
-// (in Chains or Interleaves) to a depth of more than 20.
-message RowFilter {
-  // A RowFilter which sends rows through several RowFilters in sequence.
-  message Chain {
-    // The elements of "filters" are chained together to process the input row:
-    // in row -> f(0) -> intermediate row -> f(1) -> ... -> f(N) -> out row
-    // The full chain is executed atomically.
-    repeated RowFilter filters = 1;
-  }
-
-  // A RowFilter which sends each row to each of several component
-  // RowFilters and interleaves the results.
-  message Interleave {
-    // The elements of "filters" all process a copy of the input row, and the
-    // results are pooled, sorted, and combined into a single output row.
-    // If multiple cells are produced with the same column and timestamp,
-    // they will all appear in the output row in an unspecified mutual order.
-    // Consider the following example, with three filters:
-    //
-    //                                  input row
-    //                                      |
-    //            -----------------------------------------------------
-    //            |                         |                         |
-    //           f(0)                      f(1)                      f(2)
-    //            |                         |                         |
-    //     1: foo,bar,10,x             foo,bar,10,z              far,bar,7,a
-    //     2: foo,blah,11,z            far,blah,5,x              far,blah,5,x
-    //            |                         |                         |
-    //            -----------------------------------------------------
-    //                                      |
-    //     1:                      foo,bar,10,z   // could have switched with #2
-    //     2:                      foo,bar,10,x   // could have switched with #1
-    //     3:                      foo,blah,11,z
-    //     4:                      far,bar,7,a
-    //     5:                      far,blah,5,x   // identical to #6
-    //     6:                      far,blah,5,x   // identical to #5
-    //
-    // All interleaved filters are executed atomically.
-    repeated RowFilter filters = 1;
-  }
-
-  // A RowFilter which evaluates one of two possible RowFilters, depending on
-  // whether or not a predicate RowFilter outputs any cells from the input row.
-  //
-  // IMPORTANT NOTE: The predicate filter does not execute atomically with the
-  // true and false filters, which may lead to inconsistent or unexpected
-  // results. Additionally, Condition filters have poor performance, especially
-  // when filters are set for the false condition.
-  message Condition {
-    // If `predicate_filter` outputs any cells, then `true_filter` will be
-    // evaluated on the input row. Otherwise, `false_filter` will be evaluated.
-    RowFilter predicate_filter = 1;
-
-    // The filter to apply to the input row if `predicate_filter` returns any
-    // results. If not provided, no results will be returned in the true case.
-    RowFilter true_filter = 2;
-
-    // The filter to apply to the input row if `predicate_filter` does not
-    // return any results. If not provided, no results will be returned in the
-    // false case.
-    RowFilter false_filter = 3;
-  }
-
-  // Which of the possible RowFilter types to apply. If none are set, this
-  // RowFilter returns all cells in the input row.
-  oneof filter {
-    // Applies several RowFilters to the data in sequence, progressively
-    // narrowing the results.
-    Chain chain = 1;
-
-    // Applies several RowFilters to the data in parallel and combines the
-    // results.
-    Interleave interleave = 2;
-
-    // Applies one of two possible RowFilters to the data based on the output of
-    // a predicate RowFilter.
-    Condition condition = 3;
-
-    // ADVANCED USE ONLY.
-    // Hook for introspection into the RowFilter. Outputs all cells directly to
-    // the output of the read rather than to any parent filter. Consider the
-    // following example:
-    //
-    //     Chain(
-    //       FamilyRegex("A"),
-    //       Interleave(
-    //         All(),
-    //         Chain(Label("foo"), Sink())
-    //       ),
-    //       QualifierRegex("B")
-    //     )
-    //
-    //                         A,A,1,w
-    //                         A,B,2,x
-    //                         B,B,4,z
-    //                            |
-    //                     FamilyRegex("A")
-    //                            |
-    //                         A,A,1,w
-    //                         A,B,2,x
-    //                            |
-    //               +------------+-------------+
-    //               |                          |
-    //             All()                    Label(foo)
-    //               |                          |
-    //            A,A,1,w              A,A,1,w,labels:[foo]
-    //            A,B,2,x              A,B,2,x,labels:[foo]
-    //               |                          |
-    //               |                        Sink() --------------+
-    //               |                          |                  |
-    //               +------------+      x------+          A,A,1,w,labels:[foo]
-    //                            |                        A,B,2,x,labels:[foo]
-    //                         A,A,1,w                             |
-    //                         A,B,2,x                             |
-    //                            |                                |
-    //                    QualifierRegex("B")                      |
-    //                            |                                |
-    //                         A,B,2,x                             |
-    //                            |                                |
-    //                            +--------------------------------+
-    //                            |
-    //                         A,A,1,w,labels:[foo]
-    //                         A,B,2,x,labels:[foo]  // could be switched
-    //                         A,B,2,x               // could be switched
-    //
-    // Despite being excluded by the qualifier filter, a copy of every cell
-    // that reaches the sink is present in the final result.
-    //
-    // As with an [Interleave][google.bigtable.v2.RowFilter.Interleave],
-    // duplicate cells are possible, and appear in an unspecified mutual order.
-    // In this case we have a duplicate with column "A:B" and timestamp 2,
-    // because one copy passed through the all filter while the other was
-    // passed through the label and sink. Note that one copy has label "foo",
-    // while the other does not.
-    //
-    // Cannot be used within the `predicate_filter`, `true_filter`, or
-    // `false_filter` of a [Condition][google.bigtable.v2.RowFilter.Condition].
-    bool sink = 16;
-
-    // Matches all cells, regardless of input. Functionally equivalent to
-    // leaving `filter` unset, but included for completeness.
-    bool pass_all_filter = 17;
-
-    // Does not match any cells, regardless of input. Useful for temporarily
-    // disabling just part of a filter.
-    bool block_all_filter = 18;
-
-    // Matches only cells from rows whose keys satisfy the given RE2 regex. In
-    // other words, passes through the entire row when the key matches, and
-    // otherwise produces an empty row.
-    // Note that, since row keys can contain arbitrary bytes, the `\C` escape
-    // sequence must be used if a true wildcard is desired. The `.` character
-    // will not match the new line character `\n`, which may be present in a
-    // binary key.
-    bytes row_key_regex_filter = 4;
-
-    // Matches all cells from a row with probability p, and matches no cells
-    // from the row with probability 1-p.
-    double row_sample_filter = 14;
-
-    // Matches only cells from columns whose families satisfy the given RE2
-    // regex. For technical reasons, the regex must not contain the `:`
-    // character, even if it is not being used as a literal.
-    // Note that, since column families cannot contain the new line character
-    // `\n`, it is sufficient to use `.` as a full wildcard when matching
-    // column family names.
-    string family_name_regex_filter = 5;
-
-    // Matches only cells from columns whose qualifiers satisfy the given RE2
-    // regex.
-    // Note that, since column qualifiers can contain arbitrary bytes, the `\C`
-    // escape sequence must be used if a true wildcard is desired. The `.`
-    // character will not match the new line character `\n`, which may be
-    // present in a binary qualifier.
-    bytes column_qualifier_regex_filter = 6;
-
-    // Matches only cells from columns within the given range.
-    ColumnRange column_range_filter = 7;
-
-    // Matches only cells with timestamps within the given range.
-    TimestampRange timestamp_range_filter = 8;
-
-    // Matches only cells with values that satisfy the given regular expression.
-    // Note that, since cell values can contain arbitrary bytes, the `\C` escape
-    // sequence must be used if a true wildcard is desired. The `.` character
-    // will not match the new line character `\n`, which may be present in a
-    // binary value.
-    bytes value_regex_filter = 9;
-
-    // Matches only cells with values that fall within the given range.
-    ValueRange value_range_filter = 15;
-
-    // Skips the first N cells of each row, matching all subsequent cells.
-    // If duplicate cells are present, as is possible when using an Interleave,
-    // each copy of the cell is counted separately.
-    int32 cells_per_row_offset_filter = 10;
-
-    // Matches only the first N cells of each row.
-    // If duplicate cells are present, as is possible when using an Interleave,
-    // each copy of the cell is counted separately.
-    int32 cells_per_row_limit_filter = 11;
-
-    // Matches only the most recent N cells within each column. For example,
-    // if N=2, this filter would match column `foo:bar` at timestamps 10 and 9,
-    // skip all earlier cells in `foo:bar`, and then begin matching again in
-    // column `foo:bar2`.
-    // If duplicate cells are present, as is possible when using an Interleave,
-    // each copy of the cell is counted separately.
-    int32 cells_per_column_limit_filter = 12;
-
-    // Replaces each cell's value with the empty string.
-    bool strip_value_transformer = 13;
-
-    // Applies the given label to all cells in the output row. This allows
-    // the client to determine which results were produced from which part of
-    // the filter.
-    //
-    // Values must be at most 15 characters in length, and match the RE2
-    // pattern `[a-z0-9\\-]+`
-    //
-    // Due to a technical limitation, it is not currently possible to apply
-    // multiple labels to a cell. As a result, a Chain may have no more than
-    // one sub-filter which contains a `apply_label_transformer`. It is okay for
-    // an Interleave to contain multiple `apply_label_transformers`, as they
-    // will be applied to separate copies of the input. This may be relaxed in
-    // the future.
-    string apply_label_transformer = 19;
-  }
-}
-
-// Specifies a particular change to be made to the contents of a row.
-message Mutation {
-  // A Mutation which sets the value of the specified cell.
-  message SetCell {
-    // The name of the family into which new data should be written.
-    // Must match `[-_.a-zA-Z0-9]+`
-    string family_name = 1;
-
-    // The qualifier of the column into which new data should be written.
-    // Can be any byte string, including the empty string.
-    bytes column_qualifier = 2;
-
-    // The timestamp of the cell into which new data should be written.
-    // Use -1 for current Bigtable server time.
-    // Otherwise, the client should set this value itself, noting that the
-    // default value is a timestamp of zero if the field is left unspecified.
-    // Values must match the granularity of the table (e.g. micros, millis).
-    int64 timestamp_micros = 3;
-
-    // The value to be written into the specified cell.
-    bytes value = 4;
-  }
-
-  // A Mutation which deletes cells from the specified column, optionally
-  // restricting the deletions to a given timestamp range.
-  message DeleteFromColumn {
-    // The name of the family from which cells should be deleted.
-    // Must match `[-_.a-zA-Z0-9]+`
-    string family_name = 1;
-
-    // The qualifier of the column from which cells should be deleted.
-    // Can be any byte string, including the empty string.
-    bytes column_qualifier = 2;
-
-    // The range of timestamps within which cells should be deleted.
-    TimestampRange time_range = 3;
-  }
-
-  // A Mutation which deletes all cells from the specified column family.
-  message DeleteFromFamily {
-    // The name of the family from which cells should be deleted.
-    // Must match `[-_.a-zA-Z0-9]+`
-    string family_name = 1;
-  }
-
-  // A Mutation which deletes all cells from the containing row.
-  message DeleteFromRow {
-
-  }
-
-  // Which of the possible Mutation types to apply.
-  oneof mutation {
-    // Set a cell's value.
-    SetCell set_cell = 1;
-
-    // Deletes cells from a column.
-    DeleteFromColumn delete_from_column = 2;
-
-    // Deletes cells from a column family.
-    DeleteFromFamily delete_from_family = 3;
-
-    // Deletes cells from the entire row.
-    DeleteFromRow delete_from_row = 4;
-  }
-}
-
-// Specifies an atomic read/modify/write operation on the latest value of the
-// specified column.
-message ReadModifyWriteRule {
-  // The name of the family to which the read/modify/write should be applied.
-  // Must match `[-_.a-zA-Z0-9]+`
-  string family_name = 1;
-
-  // The qualifier of the column to which the read/modify/write should be
-  // applied.
-  // Can be any byte string, including the empty string.
-  bytes column_qualifier = 2;
-
-  // The rule used to determine the column's new latest value from its current
-  // latest value.
-  oneof rule {
-    // Rule specifying that `append_value` be appended to the existing value.
-    // If the targeted cell is unset, it will be treated as containing the
-    // empty string.
-    bytes append_value = 3;
-
-    // Rule specifying that `increment_amount` be added to the existing value.
-    // If the targeted cell is unset, it will be treated as containing a zero.
-    // Otherwise, the targeted cell must contain an 8-byte value (interpreted
-    // as a 64-bit big-endian signed integer), or the entire request will fail.
-    int64 increment_amount = 4;
-  }
-}
diff --git a/google/cloud/bigtable/_generated/_instance.proto b/google/cloud/bigtable/_generated/_instance.proto
deleted file mode 100644
index 4aa3f9d06dd3..000000000000
--- a/google/cloud/bigtable/_generated/_instance.proto
+++ /dev/null
@@ -1,113 +0,0 @@
-// Copyright 2016 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.bigtable.admin.v2;
-
-import "google/api/annotations.proto";
-import "google/bigtable/admin/v2/common.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "InstanceProto";
-option java_package = "com.google.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].
-message Instance {
-  // Possible states of an instance.
-  enum State {
-    // The state of the instance could not be determined.
-    STATE_NOT_KNOWN = 0;
-
-    // The instance has been successfully created and can serve requests
-    // to its tables.
-    READY = 1;
-
-    // The instance is currently being created, and may be destroyed
-    // if the creation process encounters an error.
-    CREATING = 2;
-  }
-
-  // @OutputOnly
-  // The unique name of the instance. Values are of the form
-  // projects/<project>/instances/[a-z][a-z0-9\\-]+[a-z0-9]
-  string name = 1;
-
-  // 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;
-
-  //
-  // The current state of the instance.
-  State state = 3;
-}
-
-// A resizable group of nodes in a particular cloud location, capable
-// of serving all [Tables][google.bigtable.admin.v2.Table] in the parent
-// [Instance][google.bigtable.admin.v2.Instance].
-message Cluster {
-  // Possible states of a cluster.
-  enum State {
-    // The state of the cluster could not be determined.
-    STATE_NOT_KNOWN = 0;
-
-    // The cluster has been successfully created and is ready to serve requests.
-    READY = 1;
-
-    // The cluster is currently being created, and may be destroyed
-    // if the creation process encounters an error.
-    // A cluster may not be able to serve requests while being created.
-    CREATING = 2;
-
-    // The cluster is currently being resized, and may revert to its previous
-    // node count if the process encounters an error.
-    // A cluster is still capable of serving requests while being resized,
-    // but may exhibit performance as if its number of allocated nodes is
-    // between the starting and requested states.
-    RESIZING = 3;
-
-    // The cluster has no backing nodes. The data (tables) still
-    // exist, but no operations can be performed on the cluster.
-    DISABLED = 4;
-  }
-
-  // @OutputOnly
-  // The unique name of the cluster. Values are of the form
-  // projects/<project>/instances/<instance>/clusters/[a-z][-a-z0-9]*
-  string name = 1;
-
-  // @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, e.g. projects/*/locations/us-central1-b
-  string location = 2;
-
-  // @OutputOnly
-  // The current state of the cluster.
-  State state = 3;
-
-  // The number of nodes allocated to this cluster. More nodes enable higher
-  // throughput and more consistent performance.
-  int32 serve_nodes = 4;
-
-  // @CreationOnly
-  // The type of storage used by this cluster to serve its
-  // parent instance's tables, unless explicitly overridden.
-  StorageType default_storage_type = 5;
-}
diff --git a/google/cloud/bigtable/_generated/_operations.proto b/google/cloud/bigtable/_generated/_operations.proto
deleted file mode 100644
index a358d0a38787..000000000000
--- a/google/cloud/bigtable/_generated/_operations.proto
+++ /dev/null
@@ -1,144 +0,0 @@
-// Copyright (c) 2015, 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.longrunning;
-
-import "google/api/annotations.proto";
-import "google/protobuf/any.proto";
-import "google/protobuf/empty.proto";
-import "google/rpc/status.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "OperationsProto";
-option java_package = "com.google.longrunning";
-
-
-// Manages long-running operations with an API service.
-//
-// When an API method normally takes long time to complete, it can be designed
-// to return [Operation][google.longrunning.Operation] to the client, and the client can use this
-// interface to receive the real response asynchronously by polling the
-// operation resource, or using `google.watcher.v1.Watcher` interface to watch
-// the response, or pass the operation resource to another API (such as Google
-// Cloud Pub/Sub API) to receive the response.  Any API service that returns
-// long-running operations should implement the `Operations` interface so
-// developers can have a consistent client experience.
-service Operations {
-  // Gets the latest state of a long-running operation.  Clients may use this
-  // method to poll the operation result at intervals as recommended by the API
-  // service.
-  rpc GetOperation(GetOperationRequest) returns (Operation) {
-    option (google.api.http) = { get: "/v1/{name=operations/**}" };
-  }
-
-  // Lists operations that match the specified filter in the request. If the
-  // server doesn't support this method, it returns
-  // `google.rpc.Code.UNIMPLEMENTED`.
-  rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse) {
-    option (google.api.http) = { get: "/v1/{name=operations}" };
-  }
-
-  // Starts asynchronous cancellation on a long-running operation.  The server
-  // makes a best effort to cancel the operation, but success is not
-  // guaranteed.  If the server doesn't support this method, it returns
-  // `google.rpc.Code.UNIMPLEMENTED`.  Clients may use
-  // [Operations.GetOperation] or other methods to check whether the
-  // cancellation succeeded or the operation completed despite cancellation.
-  rpc CancelOperation(CancelOperationRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = { post: "/v1/{name=operations/**}:cancel" body: "*" };
-  }
-
-  // Deletes a long-running operation.  It indicates the client is no longer
-  // interested in the operation result. It does not cancel the operation.
-  rpc DeleteOperation(DeleteOperationRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = { delete: "/v1/{name=operations/**}" };
-  }
-}
-
-// This resource represents a long-running operation that is the result of a
-// network API call.
-message Operation {
-  // The name of the operation resource, which is only unique within the same
-  // service that originally returns it.
-  string name = 1;
-
-  // Some service-specific metadata associated with the operation.  It typically
-  // contains progress information and common metadata such as create time.
-  // Some services may not provide such metadata.  Any method that returns a
-  // long-running operation should document the metadata type, if any.
-  google.protobuf.Any metadata = 2;
-
-  // If the value is false, it means the operation is still in progress.
-  // If true, the operation is completed and the `result` is available.
-  bool done = 3;
-
-  oneof result {
-    // The error result of the operation in case of failure.
-    google.rpc.Status error = 4;
-
-    // The normal response of the operation in case of success.  If the original
-    // method returns no data on success, such as `Delete`, the response will be
-    // `google.protobuf.Empty`.  If the original method is standard
-    // `Get`/`Create`/`Update`, the response should be the resource.  For other
-    // methods, the response should have the type `XxxResponse`, where `Xxx`
-    // is the original method name.  For example, if the original method name
-    // is `TakeSnapshot()`, the inferred response type will be
-    // `TakeSnapshotResponse`.
-    google.protobuf.Any response = 5;
-  }
-}
-
-// The request message for [Operations.GetOperation][google.longrunning.Operations.GetOperation].
-message GetOperationRequest {
-  // The name of the operation resource.
-  string name = 1;
-}
-
-// The request message for [Operations.ListOperations][google.longrunning.Operations.ListOperations].
-message ListOperationsRequest {
-  // The name of the operation collection.
-  string name = 4;
-
-  // The standard List filter.
-  string filter = 1;
-
-  // The standard List page size.
-  int32 page_size = 2;
-
-  // The standard List page token.
-  string page_token = 3;
-}
-
-// The response message for [Operations.ListOperations][google.longrunning.Operations.ListOperations].
-message ListOperationsResponse {
-  // A list of operations that match the specified filter in the request.
-  repeated Operation operations = 1;
-
-  // The standard List next-page token.
-  string next_page_token = 2;
-}
-
-// The request message for [Operations.CancelOperation][google.longrunning.Operations.CancelOperation].
-message CancelOperationRequest {
-  // The name of the operation resource to be cancelled.
-  string name = 1;
-}
-
-// The request message for [Operations.DeleteOperation][google.longrunning.Operations.DeleteOperation].
-message DeleteOperationRequest {
-  // The name of the operation resource to be deleted.
-  string name = 1;
-}
diff --git a/google/cloud/bigtable/_generated/_table.proto b/google/cloud/bigtable/_generated/_table.proto
deleted file mode 100644
index 63e41103e42f..000000000000
--- a/google/cloud/bigtable/_generated/_table.proto
+++ /dev/null
@@ -1,115 +0,0 @@
-// Copyright 2016 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.bigtable.admin.v2;
-
-import "google/api/annotations.proto";
-import "google/protobuf/duration.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "TableProto";
-option java_package = "com.google.bigtable.admin.v2";
-
-
-// A collection of user data indexed by row, column, and timestamp.
-// Each table is served using the resources of its parent cluster.
-message Table {
-  // Possible timestamp granularities to use when keeping multiple versions
-  // of data in a table.
-  enum TimestampGranularity {
-    // The user did not specify a granularity. Should not be returned.
-    // When specified during table creation, MILLIS will be used.
-    TIMESTAMP_GRANULARITY_UNSPECIFIED = 0;
-
-    // The table keeps data versioned at a granularity of 1ms.
-    MILLIS = 1;
-  }
-
-  // Defines a view over a table's fields.
-  enum View {
-    // Uses the default view for each method as documented in its request.
-    VIEW_UNSPECIFIED = 0;
-
-    // Only populates `name`.
-    NAME_ONLY = 1;
-
-    // Only populates `name` and fields related to the table's schema.
-    SCHEMA_VIEW = 2;
-
-    // Populates all fields.
-    FULL = 4;
-  }
-
-  // The unique name of the table. Values are of the form
-  // projects/<project>/instances/<instance>/tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*
-  // Views: NAME_ONLY, SCHEMA_VIEW, REPLICATION_VIEW, FULL
-  // @OutputOnly
-  string name = 1;
-
-  // The column families configured for this table, mapped by column family ID.
-  // Views: SCHEMA_VIEW, FULL
-  // @CreationOnly
-  map<string, ColumnFamily> column_families = 3;
-
-  // The granularity (e.g. MILLIS, MICROS) 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
-  // @CreationOnly
-  TimestampGranularity granularity = 4;
-}
-
-// A set of columns within a table which share a common configuration.
-message ColumnFamily {
-  // Garbage collection rule specified as a protobuf.
-  // Must serialize to at most 500 bytes.
-  //
-  // NOTE: Garbage collection executes opportunistically in the background, and
-  // so it's possible for reads to return a cell even if it matches the active
-  // GC expression for its family.
-  GcRule gc_rule = 1;
-}
-
-// Rule for determining which cells to delete during garbage collection.
-message GcRule {
-  // A GcRule which deletes cells matching all of the given rules.
-  message Intersection {
-    // Only delete cells which would be deleted by every element of `rules`.
-    repeated GcRule rules = 1;
-  }
-
-  // A GcRule which deletes cells matching any of the given rules.
-  message Union {
-    // Delete cells which would be deleted by any element of `rules`.
-    repeated GcRule rules = 1;
-  }
-
-  oneof rule {
-    // Delete all cells in a column except the most recent N.
-    int32 max_num_versions = 1;
-
-    // Delete cells in a column older than the given age.
-    // Values must be at least one millisecond, and will be truncated to
-    // microsecond granularity.
-    google.protobuf.Duration max_age = 2;
-
-    // Delete cells that would be deleted by every nested rule.
-    Intersection intersection = 3;
-
-    // Delete cells that would be deleted by any nested rule.
-    Union union = 4;
-  }
-}
diff --git a/google/cloud/bigtable/_generated/bigtable_instance_admin_pb2.py b/google/cloud/bigtable/_generated/bigtable_instance_admin_pb2.py
deleted file mode 100644
index e24d4b26ae26..000000000000
--- a/google/cloud/bigtable/_generated/bigtable_instance_admin_pb2.py
+++ /dev/null
@@ -1,1061 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/admin/v2/bigtable_instance_admin.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.cloud.bigtable._generated import instance_pb2 as google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2
-from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2
-from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
-from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/admin/v2/bigtable_instance_admin.proto',
-  package='google.bigtable.admin.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n6google/bigtable/admin/v2/bigtable_instance_admin.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\'google/bigtable/admin/v2/instance.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x97\x02\n\x15\x43reateInstanceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0binstance_id\x18\x02 \x01(\t\x12\x34\n\x08instance\x18\x03 \x01(\x0b\x32\".google.bigtable.admin.v2.Instance\x12O\n\x08\x63lusters\x18\x04 \x03(\x0b\x32=.google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry\x1aR\n\rClustersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x30\n\x05value\x18\x02 \x01(\x0b\x32!.google.bigtable.admin.v2.Cluster:\x02\x38\x01\"\"\n\x12GetInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\":\n\x14ListInstancesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\"\x81\x01\n\x15ListInstancesResponse\x12\x35\n\tinstances\x18\x01 \x03(\x0b\x32\".google.bigtable.admin.v2.Instance\x12\x18\n\x10\x66\x61iled_locations\x18\x02 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\"%\n\x15\x44\x65leteInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\"n\n\x14\x43reateClusterRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\ncluster_id\x18\x02 \x01(\t\x12\x32\n\x07\x63luster\x18\x03 \x01(\x0b\x32!.google.bigtable.admin.v2.Cluster\"!\n\x11GetClusterRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\"9\n\x13ListClustersRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\"~\n\x14ListClustersResponse\x12\x33\n\x08\x63lusters\x18\x01 \x03(\x0b\x32!.google.bigtable.admin.v2.Cluster\x12\x18\n\x10\x66\x61iled_locations\x18\x02 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\"$\n\x14\x44\x65leteClusterRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\"\xc6\x01\n\x16\x43reateInstanceMetadata\x12I\n\x10original_request\x18\x01 \x01(\x0b\x32/.google.bigtable.admin.v2.CreateInstanceRequest\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xb7\x01\n\x15UpdateClusterMetadata\x12;\n\x10original_request\x18\x01 \x01(\x0b\x32!.google.bigtable.admin.v2.Cluster\x12\x30\n\x0crequest_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x66inish_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xdb\x0b\n\x15\x42igtableInstanceAdmin\x12\x8e\x01\n\x0e\x43reateInstance\x12/.google.bigtable.admin.v2.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation\",\x82\xd3\xe4\x93\x02&\"!/v2/{parent=projects/*}/instances:\x01*\x12\x8a\x01\n\x0bGetInstance\x12,.google.bigtable.admin.v2.GetInstanceRequest\x1a\".google.bigtable.admin.v2.Instance\")\x82\xd3\xe4\x93\x02#\x12!/v2/{name=projects/*/instances/*}\x12\x9b\x01\n\rListInstances\x12..google.bigtable.admin.v2.ListInstancesRequest\x1a/.google.bigtable.admin.v2.ListInstancesResponse\")\x82\xd3\xe4\x93\x02#\x12!/v2/{parent=projects/*}/instances\x12\x86\x01\n\x0eUpdateInstance\x12\".google.bigtable.admin.v2.Instance\x1a\".google.bigtable.admin.v2.Instance\",\x82\xd3\xe4\x93\x02&\x1a!/v2/{name=projects/*/instances/*}:\x01*\x12\x84\x01\n\x0e\x44\x65leteInstance\x12/.google.bigtable.admin.v2.DeleteInstanceRequest\x1a\x16.google.protobuf.Empty\")\x82\xd3\xe4\x93\x02#*!/v2/{name=projects/*/instances/*}\x12\x9d\x01\n\rCreateCluster\x12..google.bigtable.admin.v2.CreateClusterRequest\x1a\x1d.google.longrunning.Operation\"=\x82\xd3\xe4\x93\x02\x37\",/v2/{parent=projects/*/instances/*}/clusters:\x07\x63luster\x12\x92\x01\n\nGetCluster\x12+.google.bigtable.admin.v2.GetClusterRequest\x1a!.google.bigtable.admin.v2.Cluster\"4\x82\xd3\xe4\x93\x02.\x12,/v2/{name=projects/*/instances/*/clusters/*}\x12\xa3\x01\n\x0cListClusters\x12-.google.bigtable.admin.v2.ListClustersRequest\x1a..google.bigtable.admin.v2.ListClustersResponse\"4\x82\xd3\xe4\x93\x02.\x12,/v2/{parent=projects/*/instances/*}/clusters\x12\x8a\x01\n\rUpdateCluster\x12!.google.bigtable.admin.v2.Cluster\x1a\x1d.google.longrunning.Operation\"7\x82\xd3\xe4\x93\x02\x31\x1a,/v2/{name=projects/*/instances/*/clusters/*}:\x01*\x12\x8d\x01\n\rDeleteCluster\x12..google.bigtable.admin.v2.DeleteClusterRequest\x1a\x16.google.protobuf.Empty\"4\x82\xd3\xe4\x93\x02.*,/v2/{name=projects/*/instances/*/clusters/*}B<\n\x1c\x63om.google.bigtable.admin.v2B\x1a\x42igtableInstanceAdminProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.DESCRIPTOR,google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-
-_CREATEINSTANCEREQUEST_CLUSTERSENTRY = _descriptor.Descriptor(
-  name='ClustersEntry',
-  full_name='google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry.key', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry.value', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=_descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001')),
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=452,
-  serialized_end=534,
-)
-
-_CREATEINSTANCEREQUEST = _descriptor.Descriptor(
-  name='CreateInstanceRequest',
-  full_name='google.bigtable.admin.v2.CreateInstanceRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='parent', full_name='google.bigtable.admin.v2.CreateInstanceRequest.parent', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='instance_id', full_name='google.bigtable.admin.v2.CreateInstanceRequest.instance_id', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='instance', full_name='google.bigtable.admin.v2.CreateInstanceRequest.instance', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='clusters', full_name='google.bigtable.admin.v2.CreateInstanceRequest.clusters', index=3,
-      number=4, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_CREATEINSTANCEREQUEST_CLUSTERSENTRY, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=255,
-  serialized_end=534,
-)
-
-
-_GETINSTANCEREQUEST = _descriptor.Descriptor(
-  name='GetInstanceRequest',
-  full_name='google.bigtable.admin.v2.GetInstanceRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.GetInstanceRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=536,
-  serialized_end=570,
-)
-
-
-_LISTINSTANCESREQUEST = _descriptor.Descriptor(
-  name='ListInstancesRequest',
-  full_name='google.bigtable.admin.v2.ListInstancesRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='parent', full_name='google.bigtable.admin.v2.ListInstancesRequest.parent', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='page_token', full_name='google.bigtable.admin.v2.ListInstancesRequest.page_token', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=572,
-  serialized_end=630,
-)
-
-
-_LISTINSTANCESRESPONSE = _descriptor.Descriptor(
-  name='ListInstancesResponse',
-  full_name='google.bigtable.admin.v2.ListInstancesResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='instances', full_name='google.bigtable.admin.v2.ListInstancesResponse.instances', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='failed_locations', full_name='google.bigtable.admin.v2.ListInstancesResponse.failed_locations', index=1,
-      number=2, type=9, cpp_type=9, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='next_page_token', full_name='google.bigtable.admin.v2.ListInstancesResponse.next_page_token', index=2,
-      number=3, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=633,
-  serialized_end=762,
-)
-
-
-_DELETEINSTANCEREQUEST = _descriptor.Descriptor(
-  name='DeleteInstanceRequest',
-  full_name='google.bigtable.admin.v2.DeleteInstanceRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.DeleteInstanceRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=764,
-  serialized_end=801,
-)
-
-
-_CREATECLUSTERREQUEST = _descriptor.Descriptor(
-  name='CreateClusterRequest',
-  full_name='google.bigtable.admin.v2.CreateClusterRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='parent', full_name='google.bigtable.admin.v2.CreateClusterRequest.parent', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cluster_id', full_name='google.bigtable.admin.v2.CreateClusterRequest.cluster_id', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cluster', full_name='google.bigtable.admin.v2.CreateClusterRequest.cluster', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=803,
-  serialized_end=913,
-)
-
-
-_GETCLUSTERREQUEST = _descriptor.Descriptor(
-  name='GetClusterRequest',
-  full_name='google.bigtable.admin.v2.GetClusterRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.GetClusterRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=915,
-  serialized_end=948,
-)
-
-
-_LISTCLUSTERSREQUEST = _descriptor.Descriptor(
-  name='ListClustersRequest',
-  full_name='google.bigtable.admin.v2.ListClustersRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='parent', full_name='google.bigtable.admin.v2.ListClustersRequest.parent', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='page_token', full_name='google.bigtable.admin.v2.ListClustersRequest.page_token', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=950,
-  serialized_end=1007,
-)
-
-
-_LISTCLUSTERSRESPONSE = _descriptor.Descriptor(
-  name='ListClustersResponse',
-  full_name='google.bigtable.admin.v2.ListClustersResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='clusters', full_name='google.bigtable.admin.v2.ListClustersResponse.clusters', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='failed_locations', full_name='google.bigtable.admin.v2.ListClustersResponse.failed_locations', index=1,
-      number=2, type=9, cpp_type=9, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='next_page_token', full_name='google.bigtable.admin.v2.ListClustersResponse.next_page_token', index=2,
-      number=3, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1009,
-  serialized_end=1135,
-)
-
-
-_DELETECLUSTERREQUEST = _descriptor.Descriptor(
-  name='DeleteClusterRequest',
-  full_name='google.bigtable.admin.v2.DeleteClusterRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.DeleteClusterRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1137,
-  serialized_end=1173,
-)
-
-
-_CREATEINSTANCEMETADATA = _descriptor.Descriptor(
-  name='CreateInstanceMetadata',
-  full_name='google.bigtable.admin.v2.CreateInstanceMetadata',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='original_request', full_name='google.bigtable.admin.v2.CreateInstanceMetadata.original_request', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='request_time', full_name='google.bigtable.admin.v2.CreateInstanceMetadata.request_time', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='finish_time', full_name='google.bigtable.admin.v2.CreateInstanceMetadata.finish_time', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1176,
-  serialized_end=1374,
-)
-
-
-_UPDATECLUSTERMETADATA = _descriptor.Descriptor(
-  name='UpdateClusterMetadata',
-  full_name='google.bigtable.admin.v2.UpdateClusterMetadata',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='original_request', full_name='google.bigtable.admin.v2.UpdateClusterMetadata.original_request', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='request_time', full_name='google.bigtable.admin.v2.UpdateClusterMetadata.request_time', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='finish_time', full_name='google.bigtable.admin.v2.UpdateClusterMetadata.finish_time', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1377,
-  serialized_end=1560,
-)
-
-_CREATEINSTANCEREQUEST_CLUSTERSENTRY.fields_by_name['value'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2._CLUSTER
-_CREATEINSTANCEREQUEST_CLUSTERSENTRY.containing_type = _CREATEINSTANCEREQUEST
-_CREATEINSTANCEREQUEST.fields_by_name['instance'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2._INSTANCE
-_CREATEINSTANCEREQUEST.fields_by_name['clusters'].message_type = _CREATEINSTANCEREQUEST_CLUSTERSENTRY
-_LISTINSTANCESRESPONSE.fields_by_name['instances'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2._INSTANCE
-_CREATECLUSTERREQUEST.fields_by_name['cluster'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2._CLUSTER
-_LISTCLUSTERSRESPONSE.fields_by_name['clusters'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2._CLUSTER
-_CREATEINSTANCEMETADATA.fields_by_name['original_request'].message_type = _CREATEINSTANCEREQUEST
-_CREATEINSTANCEMETADATA.fields_by_name['request_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
-_CREATEINSTANCEMETADATA.fields_by_name['finish_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
-_UPDATECLUSTERMETADATA.fields_by_name['original_request'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2._CLUSTER
-_UPDATECLUSTERMETADATA.fields_by_name['request_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
-_UPDATECLUSTERMETADATA.fields_by_name['finish_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
-DESCRIPTOR.message_types_by_name['CreateInstanceRequest'] = _CREATEINSTANCEREQUEST
-DESCRIPTOR.message_types_by_name['GetInstanceRequest'] = _GETINSTANCEREQUEST
-DESCRIPTOR.message_types_by_name['ListInstancesRequest'] = _LISTINSTANCESREQUEST
-DESCRIPTOR.message_types_by_name['ListInstancesResponse'] = _LISTINSTANCESRESPONSE
-DESCRIPTOR.message_types_by_name['DeleteInstanceRequest'] = _DELETEINSTANCEREQUEST
-DESCRIPTOR.message_types_by_name['CreateClusterRequest'] = _CREATECLUSTERREQUEST
-DESCRIPTOR.message_types_by_name['GetClusterRequest'] = _GETCLUSTERREQUEST
-DESCRIPTOR.message_types_by_name['ListClustersRequest'] = _LISTCLUSTERSREQUEST
-DESCRIPTOR.message_types_by_name['ListClustersResponse'] = _LISTCLUSTERSRESPONSE
-DESCRIPTOR.message_types_by_name['DeleteClusterRequest'] = _DELETECLUSTERREQUEST
-DESCRIPTOR.message_types_by_name['CreateInstanceMetadata'] = _CREATEINSTANCEMETADATA
-DESCRIPTOR.message_types_by_name['UpdateClusterMetadata'] = _UPDATECLUSTERMETADATA
-
-CreateInstanceRequest = _reflection.GeneratedProtocolMessageType('CreateInstanceRequest', (_message.Message,), dict(
-
-  ClustersEntry = _reflection.GeneratedProtocolMessageType('ClustersEntry', (_message.Message,), dict(
-    DESCRIPTOR = _CREATEINSTANCEREQUEST_CLUSTERSENTRY,
-    __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateInstanceRequest.ClustersEntry)
-    ))
-  ,
-  DESCRIPTOR = _CREATEINSTANCEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateInstanceRequest)
-  ))
-_sym_db.RegisterMessage(CreateInstanceRequest)
-_sym_db.RegisterMessage(CreateInstanceRequest.ClustersEntry)
-
-GetInstanceRequest = _reflection.GeneratedProtocolMessageType('GetInstanceRequest', (_message.Message,), dict(
-  DESCRIPTOR = _GETINSTANCEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetInstanceRequest)
-  ))
-_sym_db.RegisterMessage(GetInstanceRequest)
-
-ListInstancesRequest = _reflection.GeneratedProtocolMessageType('ListInstancesRequest', (_message.Message,), dict(
-  DESCRIPTOR = _LISTINSTANCESREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListInstancesRequest)
-  ))
-_sym_db.RegisterMessage(ListInstancesRequest)
-
-ListInstancesResponse = _reflection.GeneratedProtocolMessageType('ListInstancesResponse', (_message.Message,), dict(
-  DESCRIPTOR = _LISTINSTANCESRESPONSE,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListInstancesResponse)
-  ))
-_sym_db.RegisterMessage(ListInstancesResponse)
-
-DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType('DeleteInstanceRequest', (_message.Message,), dict(
-  DESCRIPTOR = _DELETEINSTANCEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteInstanceRequest)
-  ))
-_sym_db.RegisterMessage(DeleteInstanceRequest)
-
-CreateClusterRequest = _reflection.GeneratedProtocolMessageType('CreateClusterRequest', (_message.Message,), dict(
-  DESCRIPTOR = _CREATECLUSTERREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateClusterRequest)
-  ))
-_sym_db.RegisterMessage(CreateClusterRequest)
-
-GetClusterRequest = _reflection.GeneratedProtocolMessageType('GetClusterRequest', (_message.Message,), dict(
-  DESCRIPTOR = _GETCLUSTERREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetClusterRequest)
-  ))
-_sym_db.RegisterMessage(GetClusterRequest)
-
-ListClustersRequest = _reflection.GeneratedProtocolMessageType('ListClustersRequest', (_message.Message,), dict(
-  DESCRIPTOR = _LISTCLUSTERSREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListClustersRequest)
-  ))
-_sym_db.RegisterMessage(ListClustersRequest)
-
-ListClustersResponse = _reflection.GeneratedProtocolMessageType('ListClustersResponse', (_message.Message,), dict(
-  DESCRIPTOR = _LISTCLUSTERSRESPONSE,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListClustersResponse)
-  ))
-_sym_db.RegisterMessage(ListClustersResponse)
-
-DeleteClusterRequest = _reflection.GeneratedProtocolMessageType('DeleteClusterRequest', (_message.Message,), dict(
-  DESCRIPTOR = _DELETECLUSTERREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteClusterRequest)
-  ))
-_sym_db.RegisterMessage(DeleteClusterRequest)
-
-CreateInstanceMetadata = _reflection.GeneratedProtocolMessageType('CreateInstanceMetadata', (_message.Message,), dict(
-  DESCRIPTOR = _CREATEINSTANCEMETADATA,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateInstanceMetadata)
-  ))
-_sym_db.RegisterMessage(CreateInstanceMetadata)
-
-UpdateClusterMetadata = _reflection.GeneratedProtocolMessageType('UpdateClusterMetadata', (_message.Message,), dict(
-  DESCRIPTOR = _UPDATECLUSTERMETADATA,
-  __module__ = 'google.bigtable.admin.v2.bigtable_instance_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.UpdateClusterMetadata)
-  ))
-_sym_db.RegisterMessage(UpdateClusterMetadata)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\034com.google.bigtable.admin.v2B\032BigtableInstanceAdminProtoP\001'))
-_CREATEINSTANCEREQUEST_CLUSTERSENTRY.has_options = True
-_CREATEINSTANCEREQUEST_CLUSTERSENTRY._options = _descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001'))
-
-from grpc.beta import implementations as beta_implementations
-from grpc.beta import interfaces as beta_interfaces
-from grpc.framework.common import cardinality
-from grpc.framework.interfaces.face import utilities as face_utilities
-
-
-class BigtableInstanceAdminStub(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable Instances and
-  Clusters. Provides access to the Instance and Cluster schemas only, not the
-  tables metadata or data stored in those tables.
-  """
-
-  def __init__(self, channel):
-    """Constructor.
-
-    Args:
-      channel: A grpc.Channel.
-    """
-    self.CreateInstance = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/CreateInstance',
-        request_serializer=CreateInstanceRequest.SerializeToString,
-        response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
-        )
-    self.GetInstance = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/GetInstance',
-        request_serializer=GetInstanceRequest.SerializeToString,
-        response_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.FromString,
-        )
-    self.ListInstances = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/ListInstances',
-        request_serializer=ListInstancesRequest.SerializeToString,
-        response_deserializer=ListInstancesResponse.FromString,
-        )
-    self.UpdateInstance = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/UpdateInstance',
-        request_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.SerializeToString,
-        response_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.FromString,
-        )
-    self.DeleteInstance = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/DeleteInstance',
-        request_serializer=DeleteInstanceRequest.SerializeToString,
-        response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-        )
-    self.CreateCluster = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/CreateCluster',
-        request_serializer=CreateClusterRequest.SerializeToString,
-        response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
-        )
-    self.GetCluster = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/GetCluster',
-        request_serializer=GetClusterRequest.SerializeToString,
-        response_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.FromString,
-        )
-    self.ListClusters = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/ListClusters',
-        request_serializer=ListClustersRequest.SerializeToString,
-        response_deserializer=ListClustersResponse.FromString,
-        )
-    self.UpdateCluster = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/UpdateCluster',
-        request_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.SerializeToString,
-        response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
-        )
-    self.DeleteCluster = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableInstanceAdmin/DeleteCluster',
-        request_serializer=DeleteClusterRequest.SerializeToString,
-        response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-        )
-
-
-class BigtableInstanceAdminServicer(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable Instances and
-  Clusters. Provides access to the Instance and Cluster schemas only, not the
-  tables metadata or data stored in those tables.
-  """
-
-  def CreateInstance(self, request, context):
-    """Create an instance within a project.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def GetInstance(self, request, context):
-    """Gets information about an instance.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def ListInstances(self, request, context):
-    """Lists information about instances in a project.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def UpdateInstance(self, request, context):
-    """Updates an instance within a project.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def DeleteInstance(self, request, context):
-    """Delete an instance from a project.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def CreateCluster(self, request, context):
-    """Creates a cluster within an instance.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def GetCluster(self, request, context):
-    """Gets information about a cluster.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def ListClusters(self, request, context):
-    """Lists information about clusters in an instance.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def UpdateCluster(self, request, context):
-    """Updates a cluster within an instance.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def DeleteCluster(self, request, context):
-    """Deletes a cluster from an instance.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-
-def add_BigtableInstanceAdminServicer_to_server(servicer, server):
-  rpc_method_handlers = {
-      'CreateInstance': grpc.unary_unary_rpc_method_handler(
-          servicer.CreateInstance,
-          request_deserializer=CreateInstanceRequest.FromString,
-          response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
-      ),
-      'GetInstance': grpc.unary_unary_rpc_method_handler(
-          servicer.GetInstance,
-          request_deserializer=GetInstanceRequest.FromString,
-          response_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.SerializeToString,
-      ),
-      'ListInstances': grpc.unary_unary_rpc_method_handler(
-          servicer.ListInstances,
-          request_deserializer=ListInstancesRequest.FromString,
-          response_serializer=ListInstancesResponse.SerializeToString,
-      ),
-      'UpdateInstance': grpc.unary_unary_rpc_method_handler(
-          servicer.UpdateInstance,
-          request_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.FromString,
-          response_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.SerializeToString,
-      ),
-      'DeleteInstance': grpc.unary_unary_rpc_method_handler(
-          servicer.DeleteInstance,
-          request_deserializer=DeleteInstanceRequest.FromString,
-          response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-      ),
-      'CreateCluster': grpc.unary_unary_rpc_method_handler(
-          servicer.CreateCluster,
-          request_deserializer=CreateClusterRequest.FromString,
-          response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
-      ),
-      'GetCluster': grpc.unary_unary_rpc_method_handler(
-          servicer.GetCluster,
-          request_deserializer=GetClusterRequest.FromString,
-          response_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.SerializeToString,
-      ),
-      'ListClusters': grpc.unary_unary_rpc_method_handler(
-          servicer.ListClusters,
-          request_deserializer=ListClustersRequest.FromString,
-          response_serializer=ListClustersResponse.SerializeToString,
-      ),
-      'UpdateCluster': grpc.unary_unary_rpc_method_handler(
-          servicer.UpdateCluster,
-          request_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.FromString,
-          response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
-      ),
-      'DeleteCluster': grpc.unary_unary_rpc_method_handler(
-          servicer.DeleteCluster,
-          request_deserializer=DeleteClusterRequest.FromString,
-          response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-      ),
-  }
-  generic_handler = grpc.method_handlers_generic_handler(
-      'google.bigtable.admin.v2.BigtableInstanceAdmin', rpc_method_handlers)
-  server.add_generic_rpc_handlers((generic_handler,))
-
-
-class BetaBigtableInstanceAdminServicer(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable Instances and
-  Clusters. Provides access to the Instance and Cluster schemas only, not the
-  tables metadata or data stored in those tables.
-  """
-  def CreateInstance(self, request, context):
-    """Create an instance within a project.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def GetInstance(self, request, context):
-    """Gets information about an instance.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def ListInstances(self, request, context):
-    """Lists information about instances in a project.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def UpdateInstance(self, request, context):
-    """Updates an instance within a project.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def DeleteInstance(self, request, context):
-    """Delete an instance from a project.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def CreateCluster(self, request, context):
-    """Creates a cluster within an instance.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def GetCluster(self, request, context):
-    """Gets information about a cluster.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def ListClusters(self, request, context):
-    """Lists information about clusters in an instance.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def UpdateCluster(self, request, context):
-    """Updates a cluster within an instance.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def DeleteCluster(self, request, context):
-    """Deletes a cluster from an instance.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-
-
-class BetaBigtableInstanceAdminStub(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable Instances and
-  Clusters. Provides access to the Instance and Cluster schemas only, not the
-  tables metadata or data stored in those tables.
-  """
-  def CreateInstance(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Create an instance within a project.
-    """
-    raise NotImplementedError()
-  CreateInstance.future = None
-  def GetInstance(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Gets information about an instance.
-    """
-    raise NotImplementedError()
-  GetInstance.future = None
-  def ListInstances(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Lists information about instances in a project.
-    """
-    raise NotImplementedError()
-  ListInstances.future = None
-  def UpdateInstance(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Updates an instance within a project.
-    """
-    raise NotImplementedError()
-  UpdateInstance.future = None
-  def DeleteInstance(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Delete an instance from a project.
-    """
-    raise NotImplementedError()
-  DeleteInstance.future = None
-  def CreateCluster(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Creates a cluster within an instance.
-    """
-    raise NotImplementedError()
-  CreateCluster.future = None
-  def GetCluster(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Gets information about a cluster.
-    """
-    raise NotImplementedError()
-  GetCluster.future = None
-  def ListClusters(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Lists information about clusters in an instance.
-    """
-    raise NotImplementedError()
-  ListClusters.future = None
-  def UpdateCluster(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Updates a cluster within an instance.
-    """
-    raise NotImplementedError()
-  UpdateCluster.future = None
-  def DeleteCluster(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Deletes a cluster from an instance.
-    """
-    raise NotImplementedError()
-  DeleteCluster.future = None
-
-
-def beta_create_BigtableInstanceAdmin_server(servicer, pool=None, pool_size=None, default_timeout=None, maximum_timeout=None):
-  request_deserializers = {
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateCluster'): CreateClusterRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateInstance'): CreateInstanceRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteCluster'): DeleteClusterRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteInstance'): DeleteInstanceRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetCluster'): GetClusterRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetInstance'): GetInstanceRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListClusters'): ListClustersRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListInstances'): ListInstancesRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateCluster'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateInstance'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.FromString,
-  }
-  response_serializers = {
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateCluster'): google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateInstance'): google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteCluster'): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteInstance'): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetCluster'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetInstance'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListClusters'): ListClustersResponse.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListInstances'): ListInstancesResponse.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateCluster'): google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateInstance'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.SerializeToString,
-  }
-  method_implementations = {
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateCluster'): face_utilities.unary_unary_inline(servicer.CreateCluster),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateInstance'): face_utilities.unary_unary_inline(servicer.CreateInstance),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteCluster'): face_utilities.unary_unary_inline(servicer.DeleteCluster),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteInstance'): face_utilities.unary_unary_inline(servicer.DeleteInstance),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetCluster'): face_utilities.unary_unary_inline(servicer.GetCluster),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetInstance'): face_utilities.unary_unary_inline(servicer.GetInstance),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListClusters'): face_utilities.unary_unary_inline(servicer.ListClusters),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListInstances'): face_utilities.unary_unary_inline(servicer.ListInstances),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateCluster'): face_utilities.unary_unary_inline(servicer.UpdateCluster),
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateInstance'): face_utilities.unary_unary_inline(servicer.UpdateInstance),
-  }
-  server_options = beta_implementations.server_options(request_deserializers=request_deserializers, response_serializers=response_serializers, thread_pool=pool, thread_pool_size=pool_size, default_timeout=default_timeout, maximum_timeout=maximum_timeout)
-  return beta_implementations.server(method_implementations, options=server_options)
-
-
-def beta_create_BigtableInstanceAdmin_stub(channel, host=None, metadata_transformer=None, pool=None, pool_size=None):
-  request_serializers = {
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateCluster'): CreateClusterRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateInstance'): CreateInstanceRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteCluster'): DeleteClusterRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteInstance'): DeleteInstanceRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetCluster'): GetClusterRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetInstance'): GetInstanceRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListClusters'): ListClustersRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListInstances'): ListInstancesRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateCluster'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateInstance'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.SerializeToString,
-  }
-  response_deserializers = {
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateCluster'): google_dot_longrunning_dot_operations__pb2.Operation.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'CreateInstance'): google_dot_longrunning_dot_operations__pb2.Operation.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteCluster'): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'DeleteInstance'): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetCluster'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Cluster.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'GetInstance'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListClusters'): ListClustersResponse.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'ListInstances'): ListInstancesResponse.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateCluster'): google_dot_longrunning_dot_operations__pb2.Operation.FromString,
-    ('google.bigtable.admin.v2.BigtableInstanceAdmin', 'UpdateInstance'): google_dot_bigtable_dot_admin_dot_v2_dot_instance__pb2.Instance.FromString,
-  }
-  cardinalities = {
-    'CreateCluster': cardinality.Cardinality.UNARY_UNARY,
-    'CreateInstance': cardinality.Cardinality.UNARY_UNARY,
-    'DeleteCluster': cardinality.Cardinality.UNARY_UNARY,
-    'DeleteInstance': cardinality.Cardinality.UNARY_UNARY,
-    'GetCluster': cardinality.Cardinality.UNARY_UNARY,
-    'GetInstance': cardinality.Cardinality.UNARY_UNARY,
-    'ListClusters': cardinality.Cardinality.UNARY_UNARY,
-    'ListInstances': cardinality.Cardinality.UNARY_UNARY,
-    'UpdateCluster': cardinality.Cardinality.UNARY_UNARY,
-    'UpdateInstance': cardinality.Cardinality.UNARY_UNARY,
-  }
-  stub_options = beta_implementations.stub_options(host=host, metadata_transformer=metadata_transformer, request_serializers=request_serializers, response_deserializers=response_deserializers, thread_pool=pool, thread_pool_size=pool_size)
-  return beta_implementations.dynamic_stub(channel, 'google.bigtable.admin.v2.BigtableInstanceAdmin', cardinalities, options=stub_options)
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/_generated/bigtable_pb2.py b/google/cloud/bigtable/_generated/bigtable_pb2.py
deleted file mode 100644
index 04b269d72bf3..000000000000
--- a/google/cloud/bigtable/_generated/bigtable_pb2.py
+++ /dev/null
@@ -1,1100 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/v2/bigtable.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.cloud.bigtable._generated import data_pb2 as google_dot_bigtable_dot_v2_dot_data__pb2
-from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
-from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/v2/bigtable.proto',
-  package='google.bigtable.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n!google/bigtable/v2/bigtable.proto\x12\x12google.bigtable.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1dgoogle/bigtable/v2/data.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto\"\x92\x01\n\x0fReadRowsRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12(\n\x04rows\x18\x02 \x01(\x0b\x32\x1a.google.bigtable.v2.RowSet\x12-\n\x06\x66ilter\x18\x03 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x12\n\nrows_limit\x18\x04 \x01(\x03\"\xf8\x02\n\x10ReadRowsResponse\x12>\n\x06\x63hunks\x18\x01 \x03(\x0b\x32..google.bigtable.v2.ReadRowsResponse.CellChunk\x12\x1c\n\x14last_scanned_row_key\x18\x02 \x01(\x0c\x1a\x85\x02\n\tCellChunk\x12\x0f\n\x07row_key\x18\x01 \x01(\x0c\x12\x31\n\x0b\x66\x61mily_name\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.StringValue\x12.\n\tqualifier\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.BytesValue\x12\x18\n\x10timestamp_micros\x18\x04 \x01(\x03\x12\x0e\n\x06labels\x18\x05 \x03(\t\x12\r\n\x05value\x18\x06 \x01(\x0c\x12\x12\n\nvalue_size\x18\x07 \x01(\x05\x12\x13\n\treset_row\x18\x08 \x01(\x08H\x00\x12\x14\n\ncommit_row\x18\t \x01(\x08H\x00\x42\x0c\n\nrow_status\"*\n\x14SampleRowKeysRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\">\n\x15SampleRowKeysResponse\x12\x0f\n\x07row_key\x18\x01 \x01(\x0c\x12\x14\n\x0coffset_bytes\x18\x02 \x01(\x03\"h\n\x10MutateRowRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x0f\n\x07row_key\x18\x02 \x01(\x0c\x12/\n\tmutations\x18\x03 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation\"\x13\n\x11MutateRowResponse\"\xb0\x01\n\x11MutateRowsRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12<\n\x07\x65ntries\x18\x02 \x03(\x0b\x32+.google.bigtable.v2.MutateRowsRequest.Entry\x1aI\n\x05\x45ntry\x12\x0f\n\x07row_key\x18\x01 \x01(\x0c\x12/\n\tmutations\x18\x02 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation\"\x8f\x01\n\x12MutateRowsResponse\x12=\n\x07\x65ntries\x18\x01 \x03(\x0b\x32,.google.bigtable.v2.MutateRowsResponse.Entry\x1a:\n\x05\x45ntry\x12\r\n\x05index\x18\x01 \x01(\x03\x12\"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status\"\xe5\x01\n\x18\x43heckAndMutateRowRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x0f\n\x07row_key\x18\x02 \x01(\x0c\x12\x37\n\x10predicate_filter\x18\x06 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x34\n\x0etrue_mutations\x18\x04 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation\x12\x35\n\x0f\x66\x61lse_mutations\x18\x05 \x03(\x0b\x32\x1c.google.bigtable.v2.Mutation\"6\n\x19\x43heckAndMutateRowResponse\x12\x19\n\x11predicate_matched\x18\x01 \x01(\x08\"x\n\x19ReadModifyWriteRowRequest\x12\x12\n\ntable_name\x18\x01 \x01(\t\x12\x0f\n\x07row_key\x18\x02 \x01(\x0c\x12\x36\n\x05rules\x18\x03 \x03(\x0b\x32\'.google.bigtable.v2.ReadModifyWriteRule\"B\n\x1aReadModifyWriteRowResponse\x12$\n\x03row\x18\x01 \x01(\x0b\x32\x17.google.bigtable.v2.Row2\xad\x08\n\x08\x42igtable\x12\x9d\x01\n\x08ReadRows\x12#.google.bigtable.v2.ReadRowsRequest\x1a$.google.bigtable.v2.ReadRowsResponse\"D\x82\xd3\xe4\x93\x02>\"9/v2/{table_name=projects/*/instances/*/tables/*}:readRows:\x01*0\x01\x12\xae\x01\n\rSampleRowKeys\x12(.google.bigtable.v2.SampleRowKeysRequest\x1a).google.bigtable.v2.SampleRowKeysResponse\"F\x82\xd3\xe4\x93\x02@\x12>/v2/{table_name=projects/*/instances/*/tables/*}:sampleRowKeys0\x01\x12\x9f\x01\n\tMutateRow\x12$.google.bigtable.v2.MutateRowRequest\x1a%.google.bigtable.v2.MutateRowResponse\"E\x82\xd3\xe4\x93\x02?\":/v2/{table_name=projects/*/instances/*/tables/*}:mutateRow:\x01*\x12\xa5\x01\n\nMutateRows\x12%.google.bigtable.v2.MutateRowsRequest\x1a&.google.bigtable.v2.MutateRowsResponse\"F\x82\xd3\xe4\x93\x02@\";/v2/{table_name=projects/*/instances/*/tables/*}:mutateRows:\x01*0\x01\x12\xbf\x01\n\x11\x43heckAndMutateRow\x12,.google.bigtable.v2.CheckAndMutateRowRequest\x1a-.google.bigtable.v2.CheckAndMutateRowResponse\"M\x82\xd3\xe4\x93\x02G\"B/v2/{table_name=projects/*/instances/*/tables/*}:checkAndMutateRow:\x01*\x12\xc3\x01\n\x12ReadModifyWriteRow\x12-.google.bigtable.v2.ReadModifyWriteRowRequest\x1a..google.bigtable.v2.ReadModifyWriteRowResponse\"N\x82\xd3\xe4\x93\x02H\"C/v2/{table_name=projects/*/instances/*/tables/*}:readModifyWriteRow:\x01*B)\n\x16\x63om.google.bigtable.v2B\rBigtableProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_bigtable_dot_v2_dot_data__pb2.DESCRIPTOR,google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,google_dot_rpc_dot_status__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-
-_READROWSREQUEST = _descriptor.Descriptor(
-  name='ReadRowsRequest',
-  full_name='google.bigtable.v2.ReadRowsRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='table_name', full_name='google.bigtable.v2.ReadRowsRequest.table_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='rows', full_name='google.bigtable.v2.ReadRowsRequest.rows', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='filter', full_name='google.bigtable.v2.ReadRowsRequest.filter', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='rows_limit', full_name='google.bigtable.v2.ReadRowsRequest.rows_limit', index=3,
-      number=4, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=176,
-  serialized_end=322,
-)
-
-
-_READROWSRESPONSE_CELLCHUNK = _descriptor.Descriptor(
-  name='CellChunk',
-  full_name='google.bigtable.v2.ReadRowsResponse.CellChunk',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='row_key', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.row_key', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='family_name', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.family_name', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='qualifier', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.qualifier', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='timestamp_micros', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.timestamp_micros', index=3,
-      number=4, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='labels', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.labels', index=4,
-      number=5, type=9, cpp_type=9, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.value', index=5,
-      number=6, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value_size', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.value_size', index=6,
-      number=7, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='reset_row', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.reset_row', index=7,
-      number=8, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='commit_row', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.commit_row', index=8,
-      number=9, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='row_status', full_name='google.bigtable.v2.ReadRowsResponse.CellChunk.row_status',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=440,
-  serialized_end=701,
-)
-
-_READROWSRESPONSE = _descriptor.Descriptor(
-  name='ReadRowsResponse',
-  full_name='google.bigtable.v2.ReadRowsResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='chunks', full_name='google.bigtable.v2.ReadRowsResponse.chunks', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='last_scanned_row_key', full_name='google.bigtable.v2.ReadRowsResponse.last_scanned_row_key', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_READROWSRESPONSE_CELLCHUNK, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=325,
-  serialized_end=701,
-)
-
-
-_SAMPLEROWKEYSREQUEST = _descriptor.Descriptor(
-  name='SampleRowKeysRequest',
-  full_name='google.bigtable.v2.SampleRowKeysRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='table_name', full_name='google.bigtable.v2.SampleRowKeysRequest.table_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=703,
-  serialized_end=745,
-)
-
-
-_SAMPLEROWKEYSRESPONSE = _descriptor.Descriptor(
-  name='SampleRowKeysResponse',
-  full_name='google.bigtable.v2.SampleRowKeysResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='row_key', full_name='google.bigtable.v2.SampleRowKeysResponse.row_key', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='offset_bytes', full_name='google.bigtable.v2.SampleRowKeysResponse.offset_bytes', index=1,
-      number=2, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=747,
-  serialized_end=809,
-)
-
-
-_MUTATEROWREQUEST = _descriptor.Descriptor(
-  name='MutateRowRequest',
-  full_name='google.bigtable.v2.MutateRowRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='table_name', full_name='google.bigtable.v2.MutateRowRequest.table_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_key', full_name='google.bigtable.v2.MutateRowRequest.row_key', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='mutations', full_name='google.bigtable.v2.MutateRowRequest.mutations', index=2,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=811,
-  serialized_end=915,
-)
-
-
-_MUTATEROWRESPONSE = _descriptor.Descriptor(
-  name='MutateRowResponse',
-  full_name='google.bigtable.v2.MutateRowResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=917,
-  serialized_end=936,
-)
-
-
-_MUTATEROWSREQUEST_ENTRY = _descriptor.Descriptor(
-  name='Entry',
-  full_name='google.bigtable.v2.MutateRowsRequest.Entry',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='row_key', full_name='google.bigtable.v2.MutateRowsRequest.Entry.row_key', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='mutations', full_name='google.bigtable.v2.MutateRowsRequest.Entry.mutations', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1042,
-  serialized_end=1115,
-)
-
-_MUTATEROWSREQUEST = _descriptor.Descriptor(
-  name='MutateRowsRequest',
-  full_name='google.bigtable.v2.MutateRowsRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='table_name', full_name='google.bigtable.v2.MutateRowsRequest.table_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='entries', full_name='google.bigtable.v2.MutateRowsRequest.entries', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_MUTATEROWSREQUEST_ENTRY, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=939,
-  serialized_end=1115,
-)
-
-
-_MUTATEROWSRESPONSE_ENTRY = _descriptor.Descriptor(
-  name='Entry',
-  full_name='google.bigtable.v2.MutateRowsResponse.Entry',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='index', full_name='google.bigtable.v2.MutateRowsResponse.Entry.index', index=0,
-      number=1, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='status', full_name='google.bigtable.v2.MutateRowsResponse.Entry.status', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1203,
-  serialized_end=1261,
-)
-
-_MUTATEROWSRESPONSE = _descriptor.Descriptor(
-  name='MutateRowsResponse',
-  full_name='google.bigtable.v2.MutateRowsResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='entries', full_name='google.bigtable.v2.MutateRowsResponse.entries', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_MUTATEROWSRESPONSE_ENTRY, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1118,
-  serialized_end=1261,
-)
-
-
-_CHECKANDMUTATEROWREQUEST = _descriptor.Descriptor(
-  name='CheckAndMutateRowRequest',
-  full_name='google.bigtable.v2.CheckAndMutateRowRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='table_name', full_name='google.bigtable.v2.CheckAndMutateRowRequest.table_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_key', full_name='google.bigtable.v2.CheckAndMutateRowRequest.row_key', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='predicate_filter', full_name='google.bigtable.v2.CheckAndMutateRowRequest.predicate_filter', index=2,
-      number=6, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='true_mutations', full_name='google.bigtable.v2.CheckAndMutateRowRequest.true_mutations', index=3,
-      number=4, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='false_mutations', full_name='google.bigtable.v2.CheckAndMutateRowRequest.false_mutations', index=4,
-      number=5, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1264,
-  serialized_end=1493,
-)
-
-
-_CHECKANDMUTATEROWRESPONSE = _descriptor.Descriptor(
-  name='CheckAndMutateRowResponse',
-  full_name='google.bigtable.v2.CheckAndMutateRowResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='predicate_matched', full_name='google.bigtable.v2.CheckAndMutateRowResponse.predicate_matched', index=0,
-      number=1, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1495,
-  serialized_end=1549,
-)
-
-
-_READMODIFYWRITEROWREQUEST = _descriptor.Descriptor(
-  name='ReadModifyWriteRowRequest',
-  full_name='google.bigtable.v2.ReadModifyWriteRowRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='table_name', full_name='google.bigtable.v2.ReadModifyWriteRowRequest.table_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_key', full_name='google.bigtable.v2.ReadModifyWriteRowRequest.row_key', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='rules', full_name='google.bigtable.v2.ReadModifyWriteRowRequest.rules', index=2,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1551,
-  serialized_end=1671,
-)
-
-
-_READMODIFYWRITEROWRESPONSE = _descriptor.Descriptor(
-  name='ReadModifyWriteRowResponse',
-  full_name='google.bigtable.v2.ReadModifyWriteRowResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='row', full_name='google.bigtable.v2.ReadModifyWriteRowResponse.row', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1673,
-  serialized_end=1739,
-)
-
-_READROWSREQUEST.fields_by_name['rows'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._ROWSET
-_READROWSREQUEST.fields_by_name['filter'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._ROWFILTER
-_READROWSRESPONSE_CELLCHUNK.fields_by_name['family_name'].message_type = google_dot_protobuf_dot_wrappers__pb2._STRINGVALUE
-_READROWSRESPONSE_CELLCHUNK.fields_by_name['qualifier'].message_type = google_dot_protobuf_dot_wrappers__pb2._BYTESVALUE
-_READROWSRESPONSE_CELLCHUNK.containing_type = _READROWSRESPONSE
-_READROWSRESPONSE_CELLCHUNK.oneofs_by_name['row_status'].fields.append(
-  _READROWSRESPONSE_CELLCHUNK.fields_by_name['reset_row'])
-_READROWSRESPONSE_CELLCHUNK.fields_by_name['reset_row'].containing_oneof = _READROWSRESPONSE_CELLCHUNK.oneofs_by_name['row_status']
-_READROWSRESPONSE_CELLCHUNK.oneofs_by_name['row_status'].fields.append(
-  _READROWSRESPONSE_CELLCHUNK.fields_by_name['commit_row'])
-_READROWSRESPONSE_CELLCHUNK.fields_by_name['commit_row'].containing_oneof = _READROWSRESPONSE_CELLCHUNK.oneofs_by_name['row_status']
-_READROWSRESPONSE.fields_by_name['chunks'].message_type = _READROWSRESPONSE_CELLCHUNK
-_MUTATEROWREQUEST.fields_by_name['mutations'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._MUTATION
-_MUTATEROWSREQUEST_ENTRY.fields_by_name['mutations'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._MUTATION
-_MUTATEROWSREQUEST_ENTRY.containing_type = _MUTATEROWSREQUEST
-_MUTATEROWSREQUEST.fields_by_name['entries'].message_type = _MUTATEROWSREQUEST_ENTRY
-_MUTATEROWSRESPONSE_ENTRY.fields_by_name['status'].message_type = google_dot_rpc_dot_status__pb2._STATUS
-_MUTATEROWSRESPONSE_ENTRY.containing_type = _MUTATEROWSRESPONSE
-_MUTATEROWSRESPONSE.fields_by_name['entries'].message_type = _MUTATEROWSRESPONSE_ENTRY
-_CHECKANDMUTATEROWREQUEST.fields_by_name['predicate_filter'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._ROWFILTER
-_CHECKANDMUTATEROWREQUEST.fields_by_name['true_mutations'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._MUTATION
-_CHECKANDMUTATEROWREQUEST.fields_by_name['false_mutations'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._MUTATION
-_READMODIFYWRITEROWREQUEST.fields_by_name['rules'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._READMODIFYWRITERULE
-_READMODIFYWRITEROWRESPONSE.fields_by_name['row'].message_type = google_dot_bigtable_dot_v2_dot_data__pb2._ROW
-DESCRIPTOR.message_types_by_name['ReadRowsRequest'] = _READROWSREQUEST
-DESCRIPTOR.message_types_by_name['ReadRowsResponse'] = _READROWSRESPONSE
-DESCRIPTOR.message_types_by_name['SampleRowKeysRequest'] = _SAMPLEROWKEYSREQUEST
-DESCRIPTOR.message_types_by_name['SampleRowKeysResponse'] = _SAMPLEROWKEYSRESPONSE
-DESCRIPTOR.message_types_by_name['MutateRowRequest'] = _MUTATEROWREQUEST
-DESCRIPTOR.message_types_by_name['MutateRowResponse'] = _MUTATEROWRESPONSE
-DESCRIPTOR.message_types_by_name['MutateRowsRequest'] = _MUTATEROWSREQUEST
-DESCRIPTOR.message_types_by_name['MutateRowsResponse'] = _MUTATEROWSRESPONSE
-DESCRIPTOR.message_types_by_name['CheckAndMutateRowRequest'] = _CHECKANDMUTATEROWREQUEST
-DESCRIPTOR.message_types_by_name['CheckAndMutateRowResponse'] = _CHECKANDMUTATEROWRESPONSE
-DESCRIPTOR.message_types_by_name['ReadModifyWriteRowRequest'] = _READMODIFYWRITEROWREQUEST
-DESCRIPTOR.message_types_by_name['ReadModifyWriteRowResponse'] = _READMODIFYWRITEROWRESPONSE
-
-ReadRowsRequest = _reflection.GeneratedProtocolMessageType('ReadRowsRequest', (_message.Message,), dict(
-  DESCRIPTOR = _READROWSREQUEST,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadRowsRequest)
-  ))
-_sym_db.RegisterMessage(ReadRowsRequest)
-
-ReadRowsResponse = _reflection.GeneratedProtocolMessageType('ReadRowsResponse', (_message.Message,), dict(
-
-  CellChunk = _reflection.GeneratedProtocolMessageType('CellChunk', (_message.Message,), dict(
-    DESCRIPTOR = _READROWSRESPONSE_CELLCHUNK,
-    __module__ = 'google.bigtable.v2.bigtable_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadRowsResponse.CellChunk)
-    ))
-  ,
-  DESCRIPTOR = _READROWSRESPONSE,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadRowsResponse)
-  ))
-_sym_db.RegisterMessage(ReadRowsResponse)
-_sym_db.RegisterMessage(ReadRowsResponse.CellChunk)
-
-SampleRowKeysRequest = _reflection.GeneratedProtocolMessageType('SampleRowKeysRequest', (_message.Message,), dict(
-  DESCRIPTOR = _SAMPLEROWKEYSREQUEST,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.SampleRowKeysRequest)
-  ))
-_sym_db.RegisterMessage(SampleRowKeysRequest)
-
-SampleRowKeysResponse = _reflection.GeneratedProtocolMessageType('SampleRowKeysResponse', (_message.Message,), dict(
-  DESCRIPTOR = _SAMPLEROWKEYSRESPONSE,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.SampleRowKeysResponse)
-  ))
-_sym_db.RegisterMessage(SampleRowKeysResponse)
-
-MutateRowRequest = _reflection.GeneratedProtocolMessageType('MutateRowRequest', (_message.Message,), dict(
-  DESCRIPTOR = _MUTATEROWREQUEST,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowRequest)
-  ))
-_sym_db.RegisterMessage(MutateRowRequest)
-
-MutateRowResponse = _reflection.GeneratedProtocolMessageType('MutateRowResponse', (_message.Message,), dict(
-  DESCRIPTOR = _MUTATEROWRESPONSE,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowResponse)
-  ))
-_sym_db.RegisterMessage(MutateRowResponse)
-
-MutateRowsRequest = _reflection.GeneratedProtocolMessageType('MutateRowsRequest', (_message.Message,), dict(
-
-  Entry = _reflection.GeneratedProtocolMessageType('Entry', (_message.Message,), dict(
-    DESCRIPTOR = _MUTATEROWSREQUEST_ENTRY,
-    __module__ = 'google.bigtable.v2.bigtable_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsRequest.Entry)
-    ))
-  ,
-  DESCRIPTOR = _MUTATEROWSREQUEST,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsRequest)
-  ))
-_sym_db.RegisterMessage(MutateRowsRequest)
-_sym_db.RegisterMessage(MutateRowsRequest.Entry)
-
-MutateRowsResponse = _reflection.GeneratedProtocolMessageType('MutateRowsResponse', (_message.Message,), dict(
-
-  Entry = _reflection.GeneratedProtocolMessageType('Entry', (_message.Message,), dict(
-    DESCRIPTOR = _MUTATEROWSRESPONSE_ENTRY,
-    __module__ = 'google.bigtable.v2.bigtable_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsResponse.Entry)
-    ))
-  ,
-  DESCRIPTOR = _MUTATEROWSRESPONSE,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.MutateRowsResponse)
-  ))
-_sym_db.RegisterMessage(MutateRowsResponse)
-_sym_db.RegisterMessage(MutateRowsResponse.Entry)
-
-CheckAndMutateRowRequest = _reflection.GeneratedProtocolMessageType('CheckAndMutateRowRequest', (_message.Message,), dict(
-  DESCRIPTOR = _CHECKANDMUTATEROWREQUEST,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.CheckAndMutateRowRequest)
-  ))
-_sym_db.RegisterMessage(CheckAndMutateRowRequest)
-
-CheckAndMutateRowResponse = _reflection.GeneratedProtocolMessageType('CheckAndMutateRowResponse', (_message.Message,), dict(
-  DESCRIPTOR = _CHECKANDMUTATEROWRESPONSE,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.CheckAndMutateRowResponse)
-  ))
-_sym_db.RegisterMessage(CheckAndMutateRowResponse)
-
-ReadModifyWriteRowRequest = _reflection.GeneratedProtocolMessageType('ReadModifyWriteRowRequest', (_message.Message,), dict(
-  DESCRIPTOR = _READMODIFYWRITEROWREQUEST,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadModifyWriteRowRequest)
-  ))
-_sym_db.RegisterMessage(ReadModifyWriteRowRequest)
-
-ReadModifyWriteRowResponse = _reflection.GeneratedProtocolMessageType('ReadModifyWriteRowResponse', (_message.Message,), dict(
-  DESCRIPTOR = _READMODIFYWRITEROWRESPONSE,
-  __module__ = 'google.bigtable.v2.bigtable_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadModifyWriteRowResponse)
-  ))
-_sym_db.RegisterMessage(ReadModifyWriteRowResponse)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\026com.google.bigtable.v2B\rBigtableProtoP\001'))
-
-from grpc.beta import implementations as beta_implementations
-from grpc.beta import interfaces as beta_interfaces
-from grpc.framework.common import cardinality
-from grpc.framework.interfaces.face import utilities as face_utilities
-
-
-class BigtableStub(object):
-  """Service for reading from and writing to existing Bigtable tables.
-  """
-
-  def __init__(self, channel):
-    """Constructor.
-
-    Args:
-      channel: A grpc.Channel.
-    """
-    self.ReadRows = channel.unary_stream(
-        '/google.bigtable.v2.Bigtable/ReadRows',
-        request_serializer=ReadRowsRequest.SerializeToString,
-        response_deserializer=ReadRowsResponse.FromString,
-        )
-    self.SampleRowKeys = channel.unary_stream(
-        '/google.bigtable.v2.Bigtable/SampleRowKeys',
-        request_serializer=SampleRowKeysRequest.SerializeToString,
-        response_deserializer=SampleRowKeysResponse.FromString,
-        )
-    self.MutateRow = channel.unary_unary(
-        '/google.bigtable.v2.Bigtable/MutateRow',
-        request_serializer=MutateRowRequest.SerializeToString,
-        response_deserializer=MutateRowResponse.FromString,
-        )
-    self.MutateRows = channel.unary_stream(
-        '/google.bigtable.v2.Bigtable/MutateRows',
-        request_serializer=MutateRowsRequest.SerializeToString,
-        response_deserializer=MutateRowsResponse.FromString,
-        )
-    self.CheckAndMutateRow = channel.unary_unary(
-        '/google.bigtable.v2.Bigtable/CheckAndMutateRow',
-        request_serializer=CheckAndMutateRowRequest.SerializeToString,
-        response_deserializer=CheckAndMutateRowResponse.FromString,
-        )
-    self.ReadModifyWriteRow = channel.unary_unary(
-        '/google.bigtable.v2.Bigtable/ReadModifyWriteRow',
-        request_serializer=ReadModifyWriteRowRequest.SerializeToString,
-        response_deserializer=ReadModifyWriteRowResponse.FromString,
-        )
-
-
-class BigtableServicer(object):
-  """Service for reading from and writing to existing Bigtable tables.
-  """
-
-  def ReadRows(self, request, context):
-    """Streams back the contents of all requested rows, optionally
-    applying the same Reader filter to each. Depending on their size,
-    rows and cells may be broken up across multiple responses, but
-    atomicity of each row will still be preserved. See the
-    ReadRowsResponse documentation for details.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def SampleRowKeys(self, request, context):
-    """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.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def MutateRow(self, request, context):
-    """Mutates a row atomically. Cells already present in the row are left
-    unchanged unless explicitly changed by `mutation`.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def MutateRows(self, request, context):
-    """Mutates multiple rows in a batch. Each individual row is mutated
-    atomically as in MutateRow, but the entire batch is not executed
-    atomically.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def CheckAndMutateRow(self, request, context):
-    """Mutates a row atomically based on the output of a predicate Reader filter.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def ReadModifyWriteRow(self, request, context):
-    """Modifies a row atomically. The method reads the latest existing timestamp
-    and value from the specified columns and writes a new 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.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-
-def add_BigtableServicer_to_server(servicer, server):
-  rpc_method_handlers = {
-      'ReadRows': grpc.unary_stream_rpc_method_handler(
-          servicer.ReadRows,
-          request_deserializer=ReadRowsRequest.FromString,
-          response_serializer=ReadRowsResponse.SerializeToString,
-      ),
-      'SampleRowKeys': grpc.unary_stream_rpc_method_handler(
-          servicer.SampleRowKeys,
-          request_deserializer=SampleRowKeysRequest.FromString,
-          response_serializer=SampleRowKeysResponse.SerializeToString,
-      ),
-      'MutateRow': grpc.unary_unary_rpc_method_handler(
-          servicer.MutateRow,
-          request_deserializer=MutateRowRequest.FromString,
-          response_serializer=MutateRowResponse.SerializeToString,
-      ),
-      'MutateRows': grpc.unary_stream_rpc_method_handler(
-          servicer.MutateRows,
-          request_deserializer=MutateRowsRequest.FromString,
-          response_serializer=MutateRowsResponse.SerializeToString,
-      ),
-      'CheckAndMutateRow': grpc.unary_unary_rpc_method_handler(
-          servicer.CheckAndMutateRow,
-          request_deserializer=CheckAndMutateRowRequest.FromString,
-          response_serializer=CheckAndMutateRowResponse.SerializeToString,
-      ),
-      'ReadModifyWriteRow': grpc.unary_unary_rpc_method_handler(
-          servicer.ReadModifyWriteRow,
-          request_deserializer=ReadModifyWriteRowRequest.FromString,
-          response_serializer=ReadModifyWriteRowResponse.SerializeToString,
-      ),
-  }
-  generic_handler = grpc.method_handlers_generic_handler(
-      'google.bigtable.v2.Bigtable', rpc_method_handlers)
-  server.add_generic_rpc_handlers((generic_handler,))
-
-
-class BetaBigtableServicer(object):
-  """Service for reading from and writing to existing Bigtable tables.
-  """
-  def ReadRows(self, request, context):
-    """Streams back the contents of all requested rows, optionally
-    applying the same Reader filter to each. Depending on their size,
-    rows and cells may be broken up across multiple responses, but
-    atomicity of each row will still be preserved. See the
-    ReadRowsResponse documentation for details.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def SampleRowKeys(self, request, context):
-    """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.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def MutateRow(self, request, context):
-    """Mutates a row atomically. Cells already present in the row are left
-    unchanged unless explicitly changed by `mutation`.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def MutateRows(self, request, context):
-    """Mutates multiple rows in a batch. Each individual row is mutated
-    atomically as in MutateRow, but the entire batch is not executed
-    atomically.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def CheckAndMutateRow(self, request, context):
-    """Mutates a row atomically based on the output of a predicate Reader filter.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def ReadModifyWriteRow(self, request, context):
-    """Modifies a row atomically. The method reads the latest existing timestamp
-    and value from the specified columns and writes a new 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.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-
-
-class BetaBigtableStub(object):
-  """Service for reading from and writing to existing Bigtable tables.
-  """
-  def ReadRows(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Streams back the contents of all requested rows, optionally
-    applying the same Reader filter to each. Depending on their size,
-    rows and cells may be broken up across multiple responses, but
-    atomicity of each row will still be preserved. See the
-    ReadRowsResponse documentation for details.
-    """
-    raise NotImplementedError()
-  def SampleRowKeys(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """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.
-    """
-    raise NotImplementedError()
-  def MutateRow(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Mutates a row atomically. Cells already present in the row are left
-    unchanged unless explicitly changed by `mutation`.
-    """
-    raise NotImplementedError()
-  MutateRow.future = None
-  def MutateRows(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Mutates multiple rows in a batch. Each individual row is mutated
-    atomically as in MutateRow, but the entire batch is not executed
-    atomically.
-    """
-    raise NotImplementedError()
-  def CheckAndMutateRow(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Mutates a row atomically based on the output of a predicate Reader filter.
-    """
-    raise NotImplementedError()
-  CheckAndMutateRow.future = None
-  def ReadModifyWriteRow(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Modifies a row atomically. The method reads the latest existing timestamp
-    and value from the specified columns and writes a new 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.
-    """
-    raise NotImplementedError()
-  ReadModifyWriteRow.future = None
-
-
-def beta_create_Bigtable_server(servicer, pool=None, pool_size=None, default_timeout=None, maximum_timeout=None):
-  request_deserializers = {
-    ('google.bigtable.v2.Bigtable', 'CheckAndMutateRow'): CheckAndMutateRowRequest.FromString,
-    ('google.bigtable.v2.Bigtable', 'MutateRow'): MutateRowRequest.FromString,
-    ('google.bigtable.v2.Bigtable', 'MutateRows'): MutateRowsRequest.FromString,
-    ('google.bigtable.v2.Bigtable', 'ReadModifyWriteRow'): ReadModifyWriteRowRequest.FromString,
-    ('google.bigtable.v2.Bigtable', 'ReadRows'): ReadRowsRequest.FromString,
-    ('google.bigtable.v2.Bigtable', 'SampleRowKeys'): SampleRowKeysRequest.FromString,
-  }
-  response_serializers = {
-    ('google.bigtable.v2.Bigtable', 'CheckAndMutateRow'): CheckAndMutateRowResponse.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'MutateRow'): MutateRowResponse.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'MutateRows'): MutateRowsResponse.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'ReadModifyWriteRow'): ReadModifyWriteRowResponse.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'ReadRows'): ReadRowsResponse.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'SampleRowKeys'): SampleRowKeysResponse.SerializeToString,
-  }
-  method_implementations = {
-    ('google.bigtable.v2.Bigtable', 'CheckAndMutateRow'): face_utilities.unary_unary_inline(servicer.CheckAndMutateRow),
-    ('google.bigtable.v2.Bigtable', 'MutateRow'): face_utilities.unary_unary_inline(servicer.MutateRow),
-    ('google.bigtable.v2.Bigtable', 'MutateRows'): face_utilities.unary_stream_inline(servicer.MutateRows),
-    ('google.bigtable.v2.Bigtable', 'ReadModifyWriteRow'): face_utilities.unary_unary_inline(servicer.ReadModifyWriteRow),
-    ('google.bigtable.v2.Bigtable', 'ReadRows'): face_utilities.unary_stream_inline(servicer.ReadRows),
-    ('google.bigtable.v2.Bigtable', 'SampleRowKeys'): face_utilities.unary_stream_inline(servicer.SampleRowKeys),
-  }
-  server_options = beta_implementations.server_options(request_deserializers=request_deserializers, response_serializers=response_serializers, thread_pool=pool, thread_pool_size=pool_size, default_timeout=default_timeout, maximum_timeout=maximum_timeout)
-  return beta_implementations.server(method_implementations, options=server_options)
-
-
-def beta_create_Bigtable_stub(channel, host=None, metadata_transformer=None, pool=None, pool_size=None):
-  request_serializers = {
-    ('google.bigtable.v2.Bigtable', 'CheckAndMutateRow'): CheckAndMutateRowRequest.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'MutateRow'): MutateRowRequest.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'MutateRows'): MutateRowsRequest.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'ReadModifyWriteRow'): ReadModifyWriteRowRequest.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'ReadRows'): ReadRowsRequest.SerializeToString,
-    ('google.bigtable.v2.Bigtable', 'SampleRowKeys'): SampleRowKeysRequest.SerializeToString,
-  }
-  response_deserializers = {
-    ('google.bigtable.v2.Bigtable', 'CheckAndMutateRow'): CheckAndMutateRowResponse.FromString,
-    ('google.bigtable.v2.Bigtable', 'MutateRow'): MutateRowResponse.FromString,
-    ('google.bigtable.v2.Bigtable', 'MutateRows'): MutateRowsResponse.FromString,
-    ('google.bigtable.v2.Bigtable', 'ReadModifyWriteRow'): ReadModifyWriteRowResponse.FromString,
-    ('google.bigtable.v2.Bigtable', 'ReadRows'): ReadRowsResponse.FromString,
-    ('google.bigtable.v2.Bigtable', 'SampleRowKeys'): SampleRowKeysResponse.FromString,
-  }
-  cardinalities = {
-    'CheckAndMutateRow': cardinality.Cardinality.UNARY_UNARY,
-    'MutateRow': cardinality.Cardinality.UNARY_UNARY,
-    'MutateRows': cardinality.Cardinality.UNARY_STREAM,
-    'ReadModifyWriteRow': cardinality.Cardinality.UNARY_UNARY,
-    'ReadRows': cardinality.Cardinality.UNARY_STREAM,
-    'SampleRowKeys': cardinality.Cardinality.UNARY_STREAM,
-  }
-  stub_options = beta_implementations.stub_options(host=host, metadata_transformer=metadata_transformer, request_serializers=request_serializers, response_deserializers=response_deserializers, thread_pool=pool, thread_pool_size=pool_size)
-  return beta_implementations.dynamic_stub(channel, 'google.bigtable.v2.Bigtable', cardinalities, options=stub_options)
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/_generated/bigtable_table_admin_pb2.py b/google/cloud/bigtable/_generated/bigtable_table_admin_pb2.py
deleted file mode 100644
index 7368c0bf4e59..000000000000
--- a/google/cloud/bigtable/_generated/bigtable_table_admin_pb2.py
+++ /dev/null
@@ -1,784 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/admin/v2/bigtable_table_admin.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.cloud.bigtable._generated import table_pb2 as google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2
-from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/admin/v2/bigtable_table_admin.proto',
-  package='google.bigtable.admin.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n3google/bigtable/admin/v2/bigtable_table_admin.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a$google/bigtable/admin/v2/table.proto\x1a\x1bgoogle/protobuf/empty.proto\"\xc8\x01\n\x12\x43reateTableRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x10\n\x08table_id\x18\x02 \x01(\t\x12.\n\x05table\x18\x03 \x01(\x0b\x32\x1f.google.bigtable.admin.v2.Table\x12J\n\x0einitial_splits\x18\x04 \x03(\x0b\x32\x32.google.bigtable.admin.v2.CreateTableRequest.Split\x1a\x14\n\x05Split\x12\x0b\n\x03key\x18\x01 \x01(\x0c\"m\n\x13\x44ropRowRangeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x18\n\x0erow_key_prefix\x18\x02 \x01(\x0cH\x00\x12$\n\x1a\x64\x65lete_all_data_from_table\x18\x03 \x01(\x08H\x00\x42\x08\n\x06target\"k\n\x11ListTablesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x32\n\x04view\x18\x02 \x01(\x0e\x32$.google.bigtable.admin.v2.Table.View\x12\x12\n\npage_token\x18\x03 \x01(\t\"^\n\x12ListTablesResponse\x12/\n\x06tables\x18\x01 \x03(\x0b\x32\x1f.google.bigtable.admin.v2.Table\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\"S\n\x0fGetTableRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x32\n\x04view\x18\x02 \x01(\x0e\x32$.google.bigtable.admin.v2.Table.View\"\"\n\x12\x44\x65leteTableRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\"\xae\x02\n\x1bModifyColumnFamiliesRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Y\n\rmodifications\x18\x02 \x03(\x0b\x32\x42.google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification\x1a\xa5\x01\n\x0cModification\x12\n\n\x02id\x18\x01 \x01(\t\x12\x38\n\x06\x63reate\x18\x02 \x01(\x0b\x32&.google.bigtable.admin.v2.ColumnFamilyH\x00\x12\x38\n\x06update\x18\x03 \x01(\x0b\x32&.google.bigtable.admin.v2.ColumnFamilyH\x00\x12\x0e\n\x04\x64rop\x18\x04 \x01(\x08H\x00\x42\x05\n\x03mod2\xb8\x07\n\x12\x42igtableTableAdmin\x12\x93\x01\n\x0b\x43reateTable\x12,.google.bigtable.admin.v2.CreateTableRequest\x1a\x1f.google.bigtable.admin.v2.Table\"5\x82\xd3\xe4\x93\x02/\"*/v2/{parent=projects/*/instances/*}/tables:\x01*\x12\x9b\x01\n\nListTables\x12+.google.bigtable.admin.v2.ListTablesRequest\x1a,.google.bigtable.admin.v2.ListTablesResponse\"2\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/instances/*}/tables\x12\x8a\x01\n\x08GetTable\x12).google.bigtable.admin.v2.GetTableRequest\x1a\x1f.google.bigtable.admin.v2.Table\"2\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/instances/*/tables/*}\x12\x87\x01\n\x0b\x44\x65leteTable\x12,.google.bigtable.admin.v2.DeleteTableRequest\x1a\x16.google.protobuf.Empty\"2\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/instances/*/tables/*}\x12\xba\x01\n\x14ModifyColumnFamilies\x12\x35.google.bigtable.admin.v2.ModifyColumnFamiliesRequest\x1a\x1f.google.bigtable.admin.v2.Table\"J\x82\xd3\xe4\x93\x02\x44\"?/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies:\x01*\x12\x99\x01\n\x0c\x44ropRowRange\x12-.google.bigtable.admin.v2.DropRowRangeRequest\x1a\x16.google.protobuf.Empty\"B\x82\xd3\xe4\x93\x02<\"7/v2/{name=projects/*/instances/*/tables/*}:dropRowRange:\x01*B9\n\x1c\x63om.google.bigtable.admin.v2B\x17\x42igtableTableAdminProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.DESCRIPTOR,google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-
-_CREATETABLEREQUEST_SPLIT = _descriptor.Descriptor(
-  name='Split',
-  full_name='google.bigtable.admin.v2.CreateTableRequest.Split',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.bigtable.admin.v2.CreateTableRequest.Split.key', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=359,
-  serialized_end=379,
-)
-
-_CREATETABLEREQUEST = _descriptor.Descriptor(
-  name='CreateTableRequest',
-  full_name='google.bigtable.admin.v2.CreateTableRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='parent', full_name='google.bigtable.admin.v2.CreateTableRequest.parent', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='table_id', full_name='google.bigtable.admin.v2.CreateTableRequest.table_id', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='table', full_name='google.bigtable.admin.v2.CreateTableRequest.table', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='initial_splits', full_name='google.bigtable.admin.v2.CreateTableRequest.initial_splits', index=3,
-      number=4, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_CREATETABLEREQUEST_SPLIT, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=179,
-  serialized_end=379,
-)
-
-
-_DROPROWRANGEREQUEST = _descriptor.Descriptor(
-  name='DropRowRangeRequest',
-  full_name='google.bigtable.admin.v2.DropRowRangeRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.DropRowRangeRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_key_prefix', full_name='google.bigtable.admin.v2.DropRowRangeRequest.row_key_prefix', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='delete_all_data_from_table', full_name='google.bigtable.admin.v2.DropRowRangeRequest.delete_all_data_from_table', index=2,
-      number=3, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='target', full_name='google.bigtable.admin.v2.DropRowRangeRequest.target',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=381,
-  serialized_end=490,
-)
-
-
-_LISTTABLESREQUEST = _descriptor.Descriptor(
-  name='ListTablesRequest',
-  full_name='google.bigtable.admin.v2.ListTablesRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='parent', full_name='google.bigtable.admin.v2.ListTablesRequest.parent', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='view', full_name='google.bigtable.admin.v2.ListTablesRequest.view', index=1,
-      number=2, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='page_token', full_name='google.bigtable.admin.v2.ListTablesRequest.page_token', index=2,
-      number=3, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=492,
-  serialized_end=599,
-)
-
-
-_LISTTABLESRESPONSE = _descriptor.Descriptor(
-  name='ListTablesResponse',
-  full_name='google.bigtable.admin.v2.ListTablesResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='tables', full_name='google.bigtable.admin.v2.ListTablesResponse.tables', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='next_page_token', full_name='google.bigtable.admin.v2.ListTablesResponse.next_page_token', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=601,
-  serialized_end=695,
-)
-
-
-_GETTABLEREQUEST = _descriptor.Descriptor(
-  name='GetTableRequest',
-  full_name='google.bigtable.admin.v2.GetTableRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.GetTableRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='view', full_name='google.bigtable.admin.v2.GetTableRequest.view', index=1,
-      number=2, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=697,
-  serialized_end=780,
-)
-
-
-_DELETETABLEREQUEST = _descriptor.Descriptor(
-  name='DeleteTableRequest',
-  full_name='google.bigtable.admin.v2.DeleteTableRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.DeleteTableRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=782,
-  serialized_end=816,
-)
-
-
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION = _descriptor.Descriptor(
-  name='Modification',
-  full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='id', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.id', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='create', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.create', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='update', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.update', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='drop', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.drop', index=3,
-      number=4, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='mod', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification.mod',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=956,
-  serialized_end=1121,
-)
-
-_MODIFYCOLUMNFAMILIESREQUEST = _descriptor.Descriptor(
-  name='ModifyColumnFamiliesRequest',
-  full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='modifications', full_name='google.bigtable.admin.v2.ModifyColumnFamiliesRequest.modifications', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=819,
-  serialized_end=1121,
-)
-
-_CREATETABLEREQUEST_SPLIT.containing_type = _CREATETABLEREQUEST
-_CREATETABLEREQUEST.fields_by_name['table'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2._TABLE
-_CREATETABLEREQUEST.fields_by_name['initial_splits'].message_type = _CREATETABLEREQUEST_SPLIT
-_DROPROWRANGEREQUEST.oneofs_by_name['target'].fields.append(
-  _DROPROWRANGEREQUEST.fields_by_name['row_key_prefix'])
-_DROPROWRANGEREQUEST.fields_by_name['row_key_prefix'].containing_oneof = _DROPROWRANGEREQUEST.oneofs_by_name['target']
-_DROPROWRANGEREQUEST.oneofs_by_name['target'].fields.append(
-  _DROPROWRANGEREQUEST.fields_by_name['delete_all_data_from_table'])
-_DROPROWRANGEREQUEST.fields_by_name['delete_all_data_from_table'].containing_oneof = _DROPROWRANGEREQUEST.oneofs_by_name['target']
-_LISTTABLESREQUEST.fields_by_name['view'].enum_type = google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2._TABLE_VIEW
-_LISTTABLESRESPONSE.fields_by_name['tables'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2._TABLE
-_GETTABLEREQUEST.fields_by_name['view'].enum_type = google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2._TABLE_VIEW
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['create'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2._COLUMNFAMILY
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['update'].message_type = google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2._COLUMNFAMILY
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.containing_type = _MODIFYCOLUMNFAMILIESREQUEST
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name['mod'].fields.append(
-  _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['create'])
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['create'].containing_oneof = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name['mod']
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name['mod'].fields.append(
-  _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['update'])
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['update'].containing_oneof = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name['mod']
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name['mod'].fields.append(
-  _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['drop'])
-_MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.fields_by_name['drop'].containing_oneof = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION.oneofs_by_name['mod']
-_MODIFYCOLUMNFAMILIESREQUEST.fields_by_name['modifications'].message_type = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION
-DESCRIPTOR.message_types_by_name['CreateTableRequest'] = _CREATETABLEREQUEST
-DESCRIPTOR.message_types_by_name['DropRowRangeRequest'] = _DROPROWRANGEREQUEST
-DESCRIPTOR.message_types_by_name['ListTablesRequest'] = _LISTTABLESREQUEST
-DESCRIPTOR.message_types_by_name['ListTablesResponse'] = _LISTTABLESRESPONSE
-DESCRIPTOR.message_types_by_name['GetTableRequest'] = _GETTABLEREQUEST
-DESCRIPTOR.message_types_by_name['DeleteTableRequest'] = _DELETETABLEREQUEST
-DESCRIPTOR.message_types_by_name['ModifyColumnFamiliesRequest'] = _MODIFYCOLUMNFAMILIESREQUEST
-
-CreateTableRequest = _reflection.GeneratedProtocolMessageType('CreateTableRequest', (_message.Message,), dict(
-
-  Split = _reflection.GeneratedProtocolMessageType('Split', (_message.Message,), dict(
-    DESCRIPTOR = _CREATETABLEREQUEST_SPLIT,
-    __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateTableRequest.Split)
-    ))
-  ,
-  DESCRIPTOR = _CREATETABLEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.CreateTableRequest)
-  ))
-_sym_db.RegisterMessage(CreateTableRequest)
-_sym_db.RegisterMessage(CreateTableRequest.Split)
-
-DropRowRangeRequest = _reflection.GeneratedProtocolMessageType('DropRowRangeRequest', (_message.Message,), dict(
-  DESCRIPTOR = _DROPROWRANGEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DropRowRangeRequest)
-  ))
-_sym_db.RegisterMessage(DropRowRangeRequest)
-
-ListTablesRequest = _reflection.GeneratedProtocolMessageType('ListTablesRequest', (_message.Message,), dict(
-  DESCRIPTOR = _LISTTABLESREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListTablesRequest)
-  ))
-_sym_db.RegisterMessage(ListTablesRequest)
-
-ListTablesResponse = _reflection.GeneratedProtocolMessageType('ListTablesResponse', (_message.Message,), dict(
-  DESCRIPTOR = _LISTTABLESRESPONSE,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ListTablesResponse)
-  ))
-_sym_db.RegisterMessage(ListTablesResponse)
-
-GetTableRequest = _reflection.GeneratedProtocolMessageType('GetTableRequest', (_message.Message,), dict(
-  DESCRIPTOR = _GETTABLEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GetTableRequest)
-  ))
-_sym_db.RegisterMessage(GetTableRequest)
-
-DeleteTableRequest = _reflection.GeneratedProtocolMessageType('DeleteTableRequest', (_message.Message,), dict(
-  DESCRIPTOR = _DELETETABLEREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.DeleteTableRequest)
-  ))
-_sym_db.RegisterMessage(DeleteTableRequest)
-
-ModifyColumnFamiliesRequest = _reflection.GeneratedProtocolMessageType('ModifyColumnFamiliesRequest', (_message.Message,), dict(
-
-  Modification = _reflection.GeneratedProtocolMessageType('Modification', (_message.Message,), dict(
-    DESCRIPTOR = _MODIFYCOLUMNFAMILIESREQUEST_MODIFICATION,
-    __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ModifyColumnFamiliesRequest.Modification)
-    ))
-  ,
-  DESCRIPTOR = _MODIFYCOLUMNFAMILIESREQUEST,
-  __module__ = 'google.bigtable.admin.v2.bigtable_table_admin_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ModifyColumnFamiliesRequest)
-  ))
-_sym_db.RegisterMessage(ModifyColumnFamiliesRequest)
-_sym_db.RegisterMessage(ModifyColumnFamiliesRequest.Modification)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\034com.google.bigtable.admin.v2B\027BigtableTableAdminProtoP\001'))
-
-from grpc.beta import implementations as beta_implementations
-from grpc.beta import interfaces as beta_interfaces
-from grpc.framework.common import cardinality
-from grpc.framework.interfaces.face import utilities as face_utilities
-
-
-class BigtableTableAdminStub(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable tables.
-  Provides access to the table schemas only, not the data stored within
-  the tables.
-  """
-
-  def __init__(self, channel):
-    """Constructor.
-
-    Args:
-      channel: A grpc.Channel.
-    """
-    self.CreateTable = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableTableAdmin/CreateTable',
-        request_serializer=CreateTableRequest.SerializeToString,
-        response_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.FromString,
-        )
-    self.ListTables = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableTableAdmin/ListTables',
-        request_serializer=ListTablesRequest.SerializeToString,
-        response_deserializer=ListTablesResponse.FromString,
-        )
-    self.GetTable = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableTableAdmin/GetTable',
-        request_serializer=GetTableRequest.SerializeToString,
-        response_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.FromString,
-        )
-    self.DeleteTable = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableTableAdmin/DeleteTable',
-        request_serializer=DeleteTableRequest.SerializeToString,
-        response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-        )
-    self.ModifyColumnFamilies = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableTableAdmin/ModifyColumnFamilies',
-        request_serializer=ModifyColumnFamiliesRequest.SerializeToString,
-        response_deserializer=google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.FromString,
-        )
-    self.DropRowRange = channel.unary_unary(
-        '/google.bigtable.admin.v2.BigtableTableAdmin/DropRowRange',
-        request_serializer=DropRowRangeRequest.SerializeToString,
-        response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-        )
-
-
-class BigtableTableAdminServicer(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable tables.
-  Provides access to the table schemas only, not the data stored within
-  the tables.
-  """
-
-  def CreateTable(self, request, context):
-    """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.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def ListTables(self, request, context):
-    """Lists all tables served from a specified instance.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def GetTable(self, request, context):
-    """Gets metadata information about the specified table.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def DeleteTable(self, request, context):
-    """Permanently deletes a specified table and all of its data.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def ModifyColumnFamilies(self, request, context):
-    """Atomically performs a series of column family modifications
-    on the specified table.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def DropRowRange(self, request, context):
-    """Permanently drop/delete a row range from a specified table. The request can
-    specify whether to delete all rows in a table, or only those that match a
-    particular prefix.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-
-def add_BigtableTableAdminServicer_to_server(servicer, server):
-  rpc_method_handlers = {
-      'CreateTable': grpc.unary_unary_rpc_method_handler(
-          servicer.CreateTable,
-          request_deserializer=CreateTableRequest.FromString,
-          response_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.SerializeToString,
-      ),
-      'ListTables': grpc.unary_unary_rpc_method_handler(
-          servicer.ListTables,
-          request_deserializer=ListTablesRequest.FromString,
-          response_serializer=ListTablesResponse.SerializeToString,
-      ),
-      'GetTable': grpc.unary_unary_rpc_method_handler(
-          servicer.GetTable,
-          request_deserializer=GetTableRequest.FromString,
-          response_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.SerializeToString,
-      ),
-      'DeleteTable': grpc.unary_unary_rpc_method_handler(
-          servicer.DeleteTable,
-          request_deserializer=DeleteTableRequest.FromString,
-          response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-      ),
-      'ModifyColumnFamilies': grpc.unary_unary_rpc_method_handler(
-          servicer.ModifyColumnFamilies,
-          request_deserializer=ModifyColumnFamiliesRequest.FromString,
-          response_serializer=google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.SerializeToString,
-      ),
-      'DropRowRange': grpc.unary_unary_rpc_method_handler(
-          servicer.DropRowRange,
-          request_deserializer=DropRowRangeRequest.FromString,
-          response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-      ),
-  }
-  generic_handler = grpc.method_handlers_generic_handler(
-      'google.bigtable.admin.v2.BigtableTableAdmin', rpc_method_handlers)
-  server.add_generic_rpc_handlers((generic_handler,))
-
-
-class BetaBigtableTableAdminServicer(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable tables.
-  Provides access to the table schemas only, not the data stored within
-  the tables.
-  """
-  def CreateTable(self, request, context):
-    """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.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def ListTables(self, request, context):
-    """Lists all tables served from a specified instance.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def GetTable(self, request, context):
-    """Gets metadata information about the specified table.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def DeleteTable(self, request, context):
-    """Permanently deletes a specified table and all of its data.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def ModifyColumnFamilies(self, request, context):
-    """Atomically performs a series of column family modifications
-    on the specified table.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def DropRowRange(self, request, context):
-    """Permanently drop/delete a row range from a specified table. The request can
-    specify whether to delete all rows in a table, or only those that match a
-    particular prefix.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-
-
-class BetaBigtableTableAdminStub(object):
-  """Service for creating, configuring, and deleting Cloud Bigtable tables.
-  Provides access to the table schemas only, not the data stored within
-  the tables.
-  """
-  def CreateTable(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """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.
-    """
-    raise NotImplementedError()
-  CreateTable.future = None
-  def ListTables(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Lists all tables served from a specified instance.
-    """
-    raise NotImplementedError()
-  ListTables.future = None
-  def GetTable(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Gets metadata information about the specified table.
-    """
-    raise NotImplementedError()
-  GetTable.future = None
-  def DeleteTable(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Permanently deletes a specified table and all of its data.
-    """
-    raise NotImplementedError()
-  DeleteTable.future = None
-  def ModifyColumnFamilies(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Atomically performs a series of column family modifications
-    on the specified table.
-    """
-    raise NotImplementedError()
-  ModifyColumnFamilies.future = None
-  def DropRowRange(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Permanently drop/delete a row range from a specified table. The request can
-    specify whether to delete all rows in a table, or only those that match a
-    particular prefix.
-    """
-    raise NotImplementedError()
-  DropRowRange.future = None
-
-
-def beta_create_BigtableTableAdmin_server(servicer, pool=None, pool_size=None, default_timeout=None, maximum_timeout=None):
-  request_deserializers = {
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'CreateTable'): CreateTableRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DeleteTable'): DeleteTableRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DropRowRange'): DropRowRangeRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'GetTable'): GetTableRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ListTables'): ListTablesRequest.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ModifyColumnFamilies'): ModifyColumnFamiliesRequest.FromString,
-  }
-  response_serializers = {
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'CreateTable'): google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DeleteTable'): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DropRowRange'): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'GetTable'): google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ListTables'): ListTablesResponse.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ModifyColumnFamilies'): google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.SerializeToString,
-  }
-  method_implementations = {
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'CreateTable'): face_utilities.unary_unary_inline(servicer.CreateTable),
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DeleteTable'): face_utilities.unary_unary_inline(servicer.DeleteTable),
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DropRowRange'): face_utilities.unary_unary_inline(servicer.DropRowRange),
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'GetTable'): face_utilities.unary_unary_inline(servicer.GetTable),
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ListTables'): face_utilities.unary_unary_inline(servicer.ListTables),
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ModifyColumnFamilies'): face_utilities.unary_unary_inline(servicer.ModifyColumnFamilies),
-  }
-  server_options = beta_implementations.server_options(request_deserializers=request_deserializers, response_serializers=response_serializers, thread_pool=pool, thread_pool_size=pool_size, default_timeout=default_timeout, maximum_timeout=maximum_timeout)
-  return beta_implementations.server(method_implementations, options=server_options)
-
-
-def beta_create_BigtableTableAdmin_stub(channel, host=None, metadata_transformer=None, pool=None, pool_size=None):
-  request_serializers = {
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'CreateTable'): CreateTableRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DeleteTable'): DeleteTableRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DropRowRange'): DropRowRangeRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'GetTable'): GetTableRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ListTables'): ListTablesRequest.SerializeToString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ModifyColumnFamilies'): ModifyColumnFamiliesRequest.SerializeToString,
-  }
-  response_deserializers = {
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'CreateTable'): google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DeleteTable'): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'DropRowRange'): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'GetTable'): google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ListTables'): ListTablesResponse.FromString,
-    ('google.bigtable.admin.v2.BigtableTableAdmin', 'ModifyColumnFamilies'): google_dot_bigtable_dot_admin_dot_v2_dot_table__pb2.Table.FromString,
-  }
-  cardinalities = {
-    'CreateTable': cardinality.Cardinality.UNARY_UNARY,
-    'DeleteTable': cardinality.Cardinality.UNARY_UNARY,
-    'DropRowRange': cardinality.Cardinality.UNARY_UNARY,
-    'GetTable': cardinality.Cardinality.UNARY_UNARY,
-    'ListTables': cardinality.Cardinality.UNARY_UNARY,
-    'ModifyColumnFamilies': cardinality.Cardinality.UNARY_UNARY,
-  }
-  stub_options = beta_implementations.stub_options(host=host, metadata_transformer=metadata_transformer, request_serializers=request_serializers, response_deserializers=response_deserializers, thread_pool=pool, thread_pool_size=pool_size)
-  return beta_implementations.dynamic_stub(channel, 'google.bigtable.admin.v2.BigtableTableAdmin', cardinalities, options=stub_options)
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/_generated/common_pb2.py b/google/cloud/bigtable/_generated/common_pb2.py
deleted file mode 100644
index 298130452971..000000000000
--- a/google/cloud/bigtable/_generated/common_pb2.py
+++ /dev/null
@@ -1,67 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/admin/v2/common.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf.internal import enum_type_wrapper
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/admin/v2/common.proto',
-  package='google.bigtable.admin.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n%google/bigtable/admin/v2/common.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto*=\n\x0bStorageType\x12\x1c\n\x18STORAGE_TYPE_UNSPECIFIED\x10\x00\x12\x07\n\x03SSD\x10\x01\x12\x07\n\x03HDD\x10\x02\x42-\n\x1c\x63om.google.bigtable.admin.v2B\x0b\x43ommonProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-_STORAGETYPE = _descriptor.EnumDescriptor(
-  name='StorageType',
-  full_name='google.bigtable.admin.v2.StorageType',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='STORAGE_TYPE_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='SSD', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='HDD', index=2, number=2,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=130,
-  serialized_end=191,
-)
-_sym_db.RegisterEnumDescriptor(_STORAGETYPE)
-
-StorageType = enum_type_wrapper.EnumTypeWrapper(_STORAGETYPE)
-STORAGE_TYPE_UNSPECIFIED = 0
-SSD = 1
-HDD = 2
-
-
-DESCRIPTOR.enum_types_by_name['StorageType'] = _STORAGETYPE
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\034com.google.bigtable.admin.v2B\013CommonProtoP\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/_generated/data_pb2.py b/google/cloud/bigtable/_generated/data_pb2.py
deleted file mode 100644
index 6db08fbd12c3..000000000000
--- a/google/cloud/bigtable/_generated/data_pb2.py
+++ /dev/null
@@ -1,1260 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/v2/data.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/v2/data.proto',
-  package='google.bigtable.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n\x1dgoogle/bigtable/v2/data.proto\x12\x12google.bigtable.v2\"@\n\x03Row\x12\x0b\n\x03key\x18\x01 \x01(\x0c\x12,\n\x08\x66\x61milies\x18\x02 \x03(\x0b\x32\x1a.google.bigtable.v2.Family\"C\n\x06\x46\x61mily\x12\x0c\n\x04name\x18\x01 \x01(\t\x12+\n\x07\x63olumns\x18\x02 \x03(\x0b\x32\x1a.google.bigtable.v2.Column\"D\n\x06\x43olumn\x12\x11\n\tqualifier\x18\x01 \x01(\x0c\x12\'\n\x05\x63\x65lls\x18\x02 \x03(\x0b\x32\x18.google.bigtable.v2.Cell\"?\n\x04\x43\x65ll\x12\x18\n\x10timestamp_micros\x18\x01 \x01(\x03\x12\r\n\x05value\x18\x02 \x01(\x0c\x12\x0e\n\x06labels\x18\x03 \x03(\t\"\x8a\x01\n\x08RowRange\x12\x1a\n\x10start_key_closed\x18\x01 \x01(\x0cH\x00\x12\x18\n\x0estart_key_open\x18\x02 \x01(\x0cH\x00\x12\x16\n\x0c\x65nd_key_open\x18\x03 \x01(\x0cH\x01\x12\x18\n\x0e\x65nd_key_closed\x18\x04 \x01(\x0cH\x01\x42\x0b\n\tstart_keyB\t\n\x07\x65nd_key\"L\n\x06RowSet\x12\x10\n\x08row_keys\x18\x01 \x03(\x0c\x12\x30\n\nrow_ranges\x18\x02 \x03(\x0b\x32\x1c.google.bigtable.v2.RowRange\"\xc6\x01\n\x0b\x43olumnRange\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12 \n\x16start_qualifier_closed\x18\x02 \x01(\x0cH\x00\x12\x1e\n\x14start_qualifier_open\x18\x03 \x01(\x0cH\x00\x12\x1e\n\x14\x65nd_qualifier_closed\x18\x04 \x01(\x0cH\x01\x12\x1c\n\x12\x65nd_qualifier_open\x18\x05 \x01(\x0cH\x01\x42\x11\n\x0fstart_qualifierB\x0f\n\rend_qualifier\"N\n\x0eTimestampRange\x12\x1e\n\x16start_timestamp_micros\x18\x01 \x01(\x03\x12\x1c\n\x14\x65nd_timestamp_micros\x18\x02 \x01(\x03\"\x98\x01\n\nValueRange\x12\x1c\n\x12start_value_closed\x18\x01 \x01(\x0cH\x00\x12\x1a\n\x10start_value_open\x18\x02 \x01(\x0cH\x00\x12\x1a\n\x10\x65nd_value_closed\x18\x03 \x01(\x0cH\x01\x12\x18\n\x0e\x65nd_value_open\x18\x04 \x01(\x0cH\x01\x42\r\n\x0bstart_valueB\x0b\n\tend_value\"\xdf\x08\n\tRowFilter\x12\x34\n\x05\x63hain\x18\x01 \x01(\x0b\x32#.google.bigtable.v2.RowFilter.ChainH\x00\x12>\n\ninterleave\x18\x02 \x01(\x0b\x32(.google.bigtable.v2.RowFilter.InterleaveH\x00\x12<\n\tcondition\x18\x03 \x01(\x0b\x32\'.google.bigtable.v2.RowFilter.ConditionH\x00\x12\x0e\n\x04sink\x18\x10 \x01(\x08H\x00\x12\x19\n\x0fpass_all_filter\x18\x11 \x01(\x08H\x00\x12\x1a\n\x10\x62lock_all_filter\x18\x12 \x01(\x08H\x00\x12\x1e\n\x14row_key_regex_filter\x18\x04 \x01(\x0cH\x00\x12\x1b\n\x11row_sample_filter\x18\x0e \x01(\x01H\x00\x12\"\n\x18\x66\x61mily_name_regex_filter\x18\x05 \x01(\tH\x00\x12\'\n\x1d\x63olumn_qualifier_regex_filter\x18\x06 \x01(\x0cH\x00\x12>\n\x13\x63olumn_range_filter\x18\x07 \x01(\x0b\x32\x1f.google.bigtable.v2.ColumnRangeH\x00\x12\x44\n\x16timestamp_range_filter\x18\x08 \x01(\x0b\x32\".google.bigtable.v2.TimestampRangeH\x00\x12\x1c\n\x12value_regex_filter\x18\t \x01(\x0cH\x00\x12<\n\x12value_range_filter\x18\x0f \x01(\x0b\x32\x1e.google.bigtable.v2.ValueRangeH\x00\x12%\n\x1b\x63\x65lls_per_row_offset_filter\x18\n \x01(\x05H\x00\x12$\n\x1a\x63\x65lls_per_row_limit_filter\x18\x0b \x01(\x05H\x00\x12\'\n\x1d\x63\x65lls_per_column_limit_filter\x18\x0c \x01(\x05H\x00\x12!\n\x17strip_value_transformer\x18\r \x01(\x08H\x00\x12!\n\x17\x61pply_label_transformer\x18\x13 \x01(\tH\x00\x1a\x37\n\x05\x43hain\x12.\n\x07\x66ilters\x18\x01 \x03(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x1a<\n\nInterleave\x12.\n\x07\x66ilters\x18\x01 \x03(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x1a\xad\x01\n\tCondition\x12\x37\n\x10predicate_filter\x18\x01 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x32\n\x0btrue_filter\x18\x02 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilter\x12\x33\n\x0c\x66\x61lse_filter\x18\x03 \x01(\x0b\x32\x1d.google.bigtable.v2.RowFilterB\x08\n\x06\x66ilter\"\xc9\x04\n\x08Mutation\x12\x38\n\x08set_cell\x18\x01 \x01(\x0b\x32$.google.bigtable.v2.Mutation.SetCellH\x00\x12K\n\x12\x64\x65lete_from_column\x18\x02 \x01(\x0b\x32-.google.bigtable.v2.Mutation.DeleteFromColumnH\x00\x12K\n\x12\x64\x65lete_from_family\x18\x03 \x01(\x0b\x32-.google.bigtable.v2.Mutation.DeleteFromFamilyH\x00\x12\x45\n\x0f\x64\x65lete_from_row\x18\x04 \x01(\x0b\x32*.google.bigtable.v2.Mutation.DeleteFromRowH\x00\x1a\x61\n\x07SetCell\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12\x18\n\x10\x63olumn_qualifier\x18\x02 \x01(\x0c\x12\x18\n\x10timestamp_micros\x18\x03 \x01(\x03\x12\r\n\x05value\x18\x04 \x01(\x0c\x1ay\n\x10\x44\x65leteFromColumn\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12\x18\n\x10\x63olumn_qualifier\x18\x02 \x01(\x0c\x12\x36\n\ntime_range\x18\x03 \x01(\x0b\x32\".google.bigtable.v2.TimestampRange\x1a\'\n\x10\x44\x65leteFromFamily\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x1a\x0f\n\rDeleteFromRowB\n\n\x08mutation\"\x80\x01\n\x13ReadModifyWriteRule\x12\x13\n\x0b\x66\x61mily_name\x18\x01 \x01(\t\x12\x18\n\x10\x63olumn_qualifier\x18\x02 \x01(\x0c\x12\x16\n\x0c\x61ppend_value\x18\x03 \x01(\x0cH\x00\x12\x1a\n\x10increment_amount\x18\x04 \x01(\x03H\x00\x42\x06\n\x04ruleB%\n\x16\x63om.google.bigtable.v2B\tDataProtoP\x01\x62\x06proto3')
-)
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-
-_ROW = _descriptor.Descriptor(
-  name='Row',
-  full_name='google.bigtable.v2.Row',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.bigtable.v2.Row.key', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='families', full_name='google.bigtable.v2.Row.families', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=53,
-  serialized_end=117,
-)
-
-
-_FAMILY = _descriptor.Descriptor(
-  name='Family',
-  full_name='google.bigtable.v2.Family',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.v2.Family.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='columns', full_name='google.bigtable.v2.Family.columns', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=119,
-  serialized_end=186,
-)
-
-
-_COLUMN = _descriptor.Descriptor(
-  name='Column',
-  full_name='google.bigtable.v2.Column',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='qualifier', full_name='google.bigtable.v2.Column.qualifier', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cells', full_name='google.bigtable.v2.Column.cells', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=188,
-  serialized_end=256,
-)
-
-
-_CELL = _descriptor.Descriptor(
-  name='Cell',
-  full_name='google.bigtable.v2.Cell',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='timestamp_micros', full_name='google.bigtable.v2.Cell.timestamp_micros', index=0,
-      number=1, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.bigtable.v2.Cell.value', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='labels', full_name='google.bigtable.v2.Cell.labels', index=2,
-      number=3, type=9, cpp_type=9, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=258,
-  serialized_end=321,
-)
-
-
-_ROWRANGE = _descriptor.Descriptor(
-  name='RowRange',
-  full_name='google.bigtable.v2.RowRange',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='start_key_closed', full_name='google.bigtable.v2.RowRange.start_key_closed', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='start_key_open', full_name='google.bigtable.v2.RowRange.start_key_open', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_key_open', full_name='google.bigtable.v2.RowRange.end_key_open', index=2,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_key_closed', full_name='google.bigtable.v2.RowRange.end_key_closed', index=3,
-      number=4, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='start_key', full_name='google.bigtable.v2.RowRange.start_key',
-      index=0, containing_type=None, fields=[]),
-    _descriptor.OneofDescriptor(
-      name='end_key', full_name='google.bigtable.v2.RowRange.end_key',
-      index=1, containing_type=None, fields=[]),
-  ],
-  serialized_start=324,
-  serialized_end=462,
-)
-
-
-_ROWSET = _descriptor.Descriptor(
-  name='RowSet',
-  full_name='google.bigtable.v2.RowSet',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='row_keys', full_name='google.bigtable.v2.RowSet.row_keys', index=0,
-      number=1, type=12, cpp_type=9, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_ranges', full_name='google.bigtable.v2.RowSet.row_ranges', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=464,
-  serialized_end=540,
-)
-
-
-_COLUMNRANGE = _descriptor.Descriptor(
-  name='ColumnRange',
-  full_name='google.bigtable.v2.ColumnRange',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='family_name', full_name='google.bigtable.v2.ColumnRange.family_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='start_qualifier_closed', full_name='google.bigtable.v2.ColumnRange.start_qualifier_closed', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='start_qualifier_open', full_name='google.bigtable.v2.ColumnRange.start_qualifier_open', index=2,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_qualifier_closed', full_name='google.bigtable.v2.ColumnRange.end_qualifier_closed', index=3,
-      number=4, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_qualifier_open', full_name='google.bigtable.v2.ColumnRange.end_qualifier_open', index=4,
-      number=5, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='start_qualifier', full_name='google.bigtable.v2.ColumnRange.start_qualifier',
-      index=0, containing_type=None, fields=[]),
-    _descriptor.OneofDescriptor(
-      name='end_qualifier', full_name='google.bigtable.v2.ColumnRange.end_qualifier',
-      index=1, containing_type=None, fields=[]),
-  ],
-  serialized_start=543,
-  serialized_end=741,
-)
-
-
-_TIMESTAMPRANGE = _descriptor.Descriptor(
-  name='TimestampRange',
-  full_name='google.bigtable.v2.TimestampRange',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='start_timestamp_micros', full_name='google.bigtable.v2.TimestampRange.start_timestamp_micros', index=0,
-      number=1, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_timestamp_micros', full_name='google.bigtable.v2.TimestampRange.end_timestamp_micros', index=1,
-      number=2, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=743,
-  serialized_end=821,
-)
-
-
-_VALUERANGE = _descriptor.Descriptor(
-  name='ValueRange',
-  full_name='google.bigtable.v2.ValueRange',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='start_value_closed', full_name='google.bigtable.v2.ValueRange.start_value_closed', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='start_value_open', full_name='google.bigtable.v2.ValueRange.start_value_open', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_value_closed', full_name='google.bigtable.v2.ValueRange.end_value_closed', index=2,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_value_open', full_name='google.bigtable.v2.ValueRange.end_value_open', index=3,
-      number=4, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='start_value', full_name='google.bigtable.v2.ValueRange.start_value',
-      index=0, containing_type=None, fields=[]),
-    _descriptor.OneofDescriptor(
-      name='end_value', full_name='google.bigtable.v2.ValueRange.end_value',
-      index=1, containing_type=None, fields=[]),
-  ],
-  serialized_start=824,
-  serialized_end=976,
-)
-
-
-_ROWFILTER_CHAIN = _descriptor.Descriptor(
-  name='Chain',
-  full_name='google.bigtable.v2.RowFilter.Chain',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='filters', full_name='google.bigtable.v2.RowFilter.Chain.filters', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1795,
-  serialized_end=1850,
-)
-
-_ROWFILTER_INTERLEAVE = _descriptor.Descriptor(
-  name='Interleave',
-  full_name='google.bigtable.v2.RowFilter.Interleave',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='filters', full_name='google.bigtable.v2.RowFilter.Interleave.filters', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1852,
-  serialized_end=1912,
-)
-
-_ROWFILTER_CONDITION = _descriptor.Descriptor(
-  name='Condition',
-  full_name='google.bigtable.v2.RowFilter.Condition',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='predicate_filter', full_name='google.bigtable.v2.RowFilter.Condition.predicate_filter', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='true_filter', full_name='google.bigtable.v2.RowFilter.Condition.true_filter', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='false_filter', full_name='google.bigtable.v2.RowFilter.Condition.false_filter', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1915,
-  serialized_end=2088,
-)
-
-_ROWFILTER = _descriptor.Descriptor(
-  name='RowFilter',
-  full_name='google.bigtable.v2.RowFilter',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='chain', full_name='google.bigtable.v2.RowFilter.chain', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='interleave', full_name='google.bigtable.v2.RowFilter.interleave', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='condition', full_name='google.bigtable.v2.RowFilter.condition', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='sink', full_name='google.bigtable.v2.RowFilter.sink', index=3,
-      number=16, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='pass_all_filter', full_name='google.bigtable.v2.RowFilter.pass_all_filter', index=4,
-      number=17, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='block_all_filter', full_name='google.bigtable.v2.RowFilter.block_all_filter', index=5,
-      number=18, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_key_regex_filter', full_name='google.bigtable.v2.RowFilter.row_key_regex_filter', index=6,
-      number=4, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='row_sample_filter', full_name='google.bigtable.v2.RowFilter.row_sample_filter', index=7,
-      number=14, type=1, cpp_type=5, label=1,
-      has_default_value=False, default_value=float(0),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='family_name_regex_filter', full_name='google.bigtable.v2.RowFilter.family_name_regex_filter', index=8,
-      number=5, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='column_qualifier_regex_filter', full_name='google.bigtable.v2.RowFilter.column_qualifier_regex_filter', index=9,
-      number=6, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='column_range_filter', full_name='google.bigtable.v2.RowFilter.column_range_filter', index=10,
-      number=7, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='timestamp_range_filter', full_name='google.bigtable.v2.RowFilter.timestamp_range_filter', index=11,
-      number=8, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value_regex_filter', full_name='google.bigtable.v2.RowFilter.value_regex_filter', index=12,
-      number=9, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value_range_filter', full_name='google.bigtable.v2.RowFilter.value_range_filter', index=13,
-      number=15, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cells_per_row_offset_filter', full_name='google.bigtable.v2.RowFilter.cells_per_row_offset_filter', index=14,
-      number=10, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cells_per_row_limit_filter', full_name='google.bigtable.v2.RowFilter.cells_per_row_limit_filter', index=15,
-      number=11, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cells_per_column_limit_filter', full_name='google.bigtable.v2.RowFilter.cells_per_column_limit_filter', index=16,
-      number=12, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='strip_value_transformer', full_name='google.bigtable.v2.RowFilter.strip_value_transformer', index=17,
-      number=13, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='apply_label_transformer', full_name='google.bigtable.v2.RowFilter.apply_label_transformer', index=18,
-      number=19, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_ROWFILTER_CHAIN, _ROWFILTER_INTERLEAVE, _ROWFILTER_CONDITION, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='filter', full_name='google.bigtable.v2.RowFilter.filter',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=979,
-  serialized_end=2098,
-)
-
-
-_MUTATION_SETCELL = _descriptor.Descriptor(
-  name='SetCell',
-  full_name='google.bigtable.v2.Mutation.SetCell',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='family_name', full_name='google.bigtable.v2.Mutation.SetCell.family_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='column_qualifier', full_name='google.bigtable.v2.Mutation.SetCell.column_qualifier', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='timestamp_micros', full_name='google.bigtable.v2.Mutation.SetCell.timestamp_micros', index=2,
-      number=3, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.bigtable.v2.Mutation.SetCell.value', index=3,
-      number=4, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=2396,
-  serialized_end=2493,
-)
-
-_MUTATION_DELETEFROMCOLUMN = _descriptor.Descriptor(
-  name='DeleteFromColumn',
-  full_name='google.bigtable.v2.Mutation.DeleteFromColumn',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='family_name', full_name='google.bigtable.v2.Mutation.DeleteFromColumn.family_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='column_qualifier', full_name='google.bigtable.v2.Mutation.DeleteFromColumn.column_qualifier', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='time_range', full_name='google.bigtable.v2.Mutation.DeleteFromColumn.time_range', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=2495,
-  serialized_end=2616,
-)
-
-_MUTATION_DELETEFROMFAMILY = _descriptor.Descriptor(
-  name='DeleteFromFamily',
-  full_name='google.bigtable.v2.Mutation.DeleteFromFamily',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='family_name', full_name='google.bigtable.v2.Mutation.DeleteFromFamily.family_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=2618,
-  serialized_end=2657,
-)
-
-_MUTATION_DELETEFROMROW = _descriptor.Descriptor(
-  name='DeleteFromRow',
-  full_name='google.bigtable.v2.Mutation.DeleteFromRow',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=2659,
-  serialized_end=2674,
-)
-
-_MUTATION = _descriptor.Descriptor(
-  name='Mutation',
-  full_name='google.bigtable.v2.Mutation',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='set_cell', full_name='google.bigtable.v2.Mutation.set_cell', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='delete_from_column', full_name='google.bigtable.v2.Mutation.delete_from_column', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='delete_from_family', full_name='google.bigtable.v2.Mutation.delete_from_family', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='delete_from_row', full_name='google.bigtable.v2.Mutation.delete_from_row', index=3,
-      number=4, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_MUTATION_SETCELL, _MUTATION_DELETEFROMCOLUMN, _MUTATION_DELETEFROMFAMILY, _MUTATION_DELETEFROMROW, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='mutation', full_name='google.bigtable.v2.Mutation.mutation',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=2101,
-  serialized_end=2686,
-)
-
-
-_READMODIFYWRITERULE = _descriptor.Descriptor(
-  name='ReadModifyWriteRule',
-  full_name='google.bigtable.v2.ReadModifyWriteRule',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='family_name', full_name='google.bigtable.v2.ReadModifyWriteRule.family_name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='column_qualifier', full_name='google.bigtable.v2.ReadModifyWriteRule.column_qualifier', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='append_value', full_name='google.bigtable.v2.ReadModifyWriteRule.append_value', index=2,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='increment_amount', full_name='google.bigtable.v2.ReadModifyWriteRule.increment_amount', index=3,
-      number=4, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='rule', full_name='google.bigtable.v2.ReadModifyWriteRule.rule',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=2689,
-  serialized_end=2817,
-)
-
-_ROW.fields_by_name['families'].message_type = _FAMILY
-_FAMILY.fields_by_name['columns'].message_type = _COLUMN
-_COLUMN.fields_by_name['cells'].message_type = _CELL
-_ROWRANGE.oneofs_by_name['start_key'].fields.append(
-  _ROWRANGE.fields_by_name['start_key_closed'])
-_ROWRANGE.fields_by_name['start_key_closed'].containing_oneof = _ROWRANGE.oneofs_by_name['start_key']
-_ROWRANGE.oneofs_by_name['start_key'].fields.append(
-  _ROWRANGE.fields_by_name['start_key_open'])
-_ROWRANGE.fields_by_name['start_key_open'].containing_oneof = _ROWRANGE.oneofs_by_name['start_key']
-_ROWRANGE.oneofs_by_name['end_key'].fields.append(
-  _ROWRANGE.fields_by_name['end_key_open'])
-_ROWRANGE.fields_by_name['end_key_open'].containing_oneof = _ROWRANGE.oneofs_by_name['end_key']
-_ROWRANGE.oneofs_by_name['end_key'].fields.append(
-  _ROWRANGE.fields_by_name['end_key_closed'])
-_ROWRANGE.fields_by_name['end_key_closed'].containing_oneof = _ROWRANGE.oneofs_by_name['end_key']
-_ROWSET.fields_by_name['row_ranges'].message_type = _ROWRANGE
-_COLUMNRANGE.oneofs_by_name['start_qualifier'].fields.append(
-  _COLUMNRANGE.fields_by_name['start_qualifier_closed'])
-_COLUMNRANGE.fields_by_name['start_qualifier_closed'].containing_oneof = _COLUMNRANGE.oneofs_by_name['start_qualifier']
-_COLUMNRANGE.oneofs_by_name['start_qualifier'].fields.append(
-  _COLUMNRANGE.fields_by_name['start_qualifier_open'])
-_COLUMNRANGE.fields_by_name['start_qualifier_open'].containing_oneof = _COLUMNRANGE.oneofs_by_name['start_qualifier']
-_COLUMNRANGE.oneofs_by_name['end_qualifier'].fields.append(
-  _COLUMNRANGE.fields_by_name['end_qualifier_closed'])
-_COLUMNRANGE.fields_by_name['end_qualifier_closed'].containing_oneof = _COLUMNRANGE.oneofs_by_name['end_qualifier']
-_COLUMNRANGE.oneofs_by_name['end_qualifier'].fields.append(
-  _COLUMNRANGE.fields_by_name['end_qualifier_open'])
-_COLUMNRANGE.fields_by_name['end_qualifier_open'].containing_oneof = _COLUMNRANGE.oneofs_by_name['end_qualifier']
-_VALUERANGE.oneofs_by_name['start_value'].fields.append(
-  _VALUERANGE.fields_by_name['start_value_closed'])
-_VALUERANGE.fields_by_name['start_value_closed'].containing_oneof = _VALUERANGE.oneofs_by_name['start_value']
-_VALUERANGE.oneofs_by_name['start_value'].fields.append(
-  _VALUERANGE.fields_by_name['start_value_open'])
-_VALUERANGE.fields_by_name['start_value_open'].containing_oneof = _VALUERANGE.oneofs_by_name['start_value']
-_VALUERANGE.oneofs_by_name['end_value'].fields.append(
-  _VALUERANGE.fields_by_name['end_value_closed'])
-_VALUERANGE.fields_by_name['end_value_closed'].containing_oneof = _VALUERANGE.oneofs_by_name['end_value']
-_VALUERANGE.oneofs_by_name['end_value'].fields.append(
-  _VALUERANGE.fields_by_name['end_value_open'])
-_VALUERANGE.fields_by_name['end_value_open'].containing_oneof = _VALUERANGE.oneofs_by_name['end_value']
-_ROWFILTER_CHAIN.fields_by_name['filters'].message_type = _ROWFILTER
-_ROWFILTER_CHAIN.containing_type = _ROWFILTER
-_ROWFILTER_INTERLEAVE.fields_by_name['filters'].message_type = _ROWFILTER
-_ROWFILTER_INTERLEAVE.containing_type = _ROWFILTER
-_ROWFILTER_CONDITION.fields_by_name['predicate_filter'].message_type = _ROWFILTER
-_ROWFILTER_CONDITION.fields_by_name['true_filter'].message_type = _ROWFILTER
-_ROWFILTER_CONDITION.fields_by_name['false_filter'].message_type = _ROWFILTER
-_ROWFILTER_CONDITION.containing_type = _ROWFILTER
-_ROWFILTER.fields_by_name['chain'].message_type = _ROWFILTER_CHAIN
-_ROWFILTER.fields_by_name['interleave'].message_type = _ROWFILTER_INTERLEAVE
-_ROWFILTER.fields_by_name['condition'].message_type = _ROWFILTER_CONDITION
-_ROWFILTER.fields_by_name['column_range_filter'].message_type = _COLUMNRANGE
-_ROWFILTER.fields_by_name['timestamp_range_filter'].message_type = _TIMESTAMPRANGE
-_ROWFILTER.fields_by_name['value_range_filter'].message_type = _VALUERANGE
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['chain'])
-_ROWFILTER.fields_by_name['chain'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['interleave'])
-_ROWFILTER.fields_by_name['interleave'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['condition'])
-_ROWFILTER.fields_by_name['condition'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['sink'])
-_ROWFILTER.fields_by_name['sink'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['pass_all_filter'])
-_ROWFILTER.fields_by_name['pass_all_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['block_all_filter'])
-_ROWFILTER.fields_by_name['block_all_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['row_key_regex_filter'])
-_ROWFILTER.fields_by_name['row_key_regex_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['row_sample_filter'])
-_ROWFILTER.fields_by_name['row_sample_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['family_name_regex_filter'])
-_ROWFILTER.fields_by_name['family_name_regex_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['column_qualifier_regex_filter'])
-_ROWFILTER.fields_by_name['column_qualifier_regex_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['column_range_filter'])
-_ROWFILTER.fields_by_name['column_range_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['timestamp_range_filter'])
-_ROWFILTER.fields_by_name['timestamp_range_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['value_regex_filter'])
-_ROWFILTER.fields_by_name['value_regex_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['value_range_filter'])
-_ROWFILTER.fields_by_name['value_range_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['cells_per_row_offset_filter'])
-_ROWFILTER.fields_by_name['cells_per_row_offset_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['cells_per_row_limit_filter'])
-_ROWFILTER.fields_by_name['cells_per_row_limit_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['cells_per_column_limit_filter'])
-_ROWFILTER.fields_by_name['cells_per_column_limit_filter'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['strip_value_transformer'])
-_ROWFILTER.fields_by_name['strip_value_transformer'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_ROWFILTER.oneofs_by_name['filter'].fields.append(
-  _ROWFILTER.fields_by_name['apply_label_transformer'])
-_ROWFILTER.fields_by_name['apply_label_transformer'].containing_oneof = _ROWFILTER.oneofs_by_name['filter']
-_MUTATION_SETCELL.containing_type = _MUTATION
-_MUTATION_DELETEFROMCOLUMN.fields_by_name['time_range'].message_type = _TIMESTAMPRANGE
-_MUTATION_DELETEFROMCOLUMN.containing_type = _MUTATION
-_MUTATION_DELETEFROMFAMILY.containing_type = _MUTATION
-_MUTATION_DELETEFROMROW.containing_type = _MUTATION
-_MUTATION.fields_by_name['set_cell'].message_type = _MUTATION_SETCELL
-_MUTATION.fields_by_name['delete_from_column'].message_type = _MUTATION_DELETEFROMCOLUMN
-_MUTATION.fields_by_name['delete_from_family'].message_type = _MUTATION_DELETEFROMFAMILY
-_MUTATION.fields_by_name['delete_from_row'].message_type = _MUTATION_DELETEFROMROW
-_MUTATION.oneofs_by_name['mutation'].fields.append(
-  _MUTATION.fields_by_name['set_cell'])
-_MUTATION.fields_by_name['set_cell'].containing_oneof = _MUTATION.oneofs_by_name['mutation']
-_MUTATION.oneofs_by_name['mutation'].fields.append(
-  _MUTATION.fields_by_name['delete_from_column'])
-_MUTATION.fields_by_name['delete_from_column'].containing_oneof = _MUTATION.oneofs_by_name['mutation']
-_MUTATION.oneofs_by_name['mutation'].fields.append(
-  _MUTATION.fields_by_name['delete_from_family'])
-_MUTATION.fields_by_name['delete_from_family'].containing_oneof = _MUTATION.oneofs_by_name['mutation']
-_MUTATION.oneofs_by_name['mutation'].fields.append(
-  _MUTATION.fields_by_name['delete_from_row'])
-_MUTATION.fields_by_name['delete_from_row'].containing_oneof = _MUTATION.oneofs_by_name['mutation']
-_READMODIFYWRITERULE.oneofs_by_name['rule'].fields.append(
-  _READMODIFYWRITERULE.fields_by_name['append_value'])
-_READMODIFYWRITERULE.fields_by_name['append_value'].containing_oneof = _READMODIFYWRITERULE.oneofs_by_name['rule']
-_READMODIFYWRITERULE.oneofs_by_name['rule'].fields.append(
-  _READMODIFYWRITERULE.fields_by_name['increment_amount'])
-_READMODIFYWRITERULE.fields_by_name['increment_amount'].containing_oneof = _READMODIFYWRITERULE.oneofs_by_name['rule']
-DESCRIPTOR.message_types_by_name['Row'] = _ROW
-DESCRIPTOR.message_types_by_name['Family'] = _FAMILY
-DESCRIPTOR.message_types_by_name['Column'] = _COLUMN
-DESCRIPTOR.message_types_by_name['Cell'] = _CELL
-DESCRIPTOR.message_types_by_name['RowRange'] = _ROWRANGE
-DESCRIPTOR.message_types_by_name['RowSet'] = _ROWSET
-DESCRIPTOR.message_types_by_name['ColumnRange'] = _COLUMNRANGE
-DESCRIPTOR.message_types_by_name['TimestampRange'] = _TIMESTAMPRANGE
-DESCRIPTOR.message_types_by_name['ValueRange'] = _VALUERANGE
-DESCRIPTOR.message_types_by_name['RowFilter'] = _ROWFILTER
-DESCRIPTOR.message_types_by_name['Mutation'] = _MUTATION
-DESCRIPTOR.message_types_by_name['ReadModifyWriteRule'] = _READMODIFYWRITERULE
-
-Row = _reflection.GeneratedProtocolMessageType('Row', (_message.Message,), dict(
-  DESCRIPTOR = _ROW,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.Row)
-  ))
-_sym_db.RegisterMessage(Row)
-
-Family = _reflection.GeneratedProtocolMessageType('Family', (_message.Message,), dict(
-  DESCRIPTOR = _FAMILY,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.Family)
-  ))
-_sym_db.RegisterMessage(Family)
-
-Column = _reflection.GeneratedProtocolMessageType('Column', (_message.Message,), dict(
-  DESCRIPTOR = _COLUMN,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.Column)
-  ))
-_sym_db.RegisterMessage(Column)
-
-Cell = _reflection.GeneratedProtocolMessageType('Cell', (_message.Message,), dict(
-  DESCRIPTOR = _CELL,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.Cell)
-  ))
-_sym_db.RegisterMessage(Cell)
-
-RowRange = _reflection.GeneratedProtocolMessageType('RowRange', (_message.Message,), dict(
-  DESCRIPTOR = _ROWRANGE,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowRange)
-  ))
-_sym_db.RegisterMessage(RowRange)
-
-RowSet = _reflection.GeneratedProtocolMessageType('RowSet', (_message.Message,), dict(
-  DESCRIPTOR = _ROWSET,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowSet)
-  ))
-_sym_db.RegisterMessage(RowSet)
-
-ColumnRange = _reflection.GeneratedProtocolMessageType('ColumnRange', (_message.Message,), dict(
-  DESCRIPTOR = _COLUMNRANGE,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ColumnRange)
-  ))
-_sym_db.RegisterMessage(ColumnRange)
-
-TimestampRange = _reflection.GeneratedProtocolMessageType('TimestampRange', (_message.Message,), dict(
-  DESCRIPTOR = _TIMESTAMPRANGE,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.TimestampRange)
-  ))
-_sym_db.RegisterMessage(TimestampRange)
-
-ValueRange = _reflection.GeneratedProtocolMessageType('ValueRange', (_message.Message,), dict(
-  DESCRIPTOR = _VALUERANGE,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ValueRange)
-  ))
-_sym_db.RegisterMessage(ValueRange)
-
-RowFilter = _reflection.GeneratedProtocolMessageType('RowFilter', (_message.Message,), dict(
-
-  Chain = _reflection.GeneratedProtocolMessageType('Chain', (_message.Message,), dict(
-    DESCRIPTOR = _ROWFILTER_CHAIN,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter.Chain)
-    ))
-  ,
-
-  Interleave = _reflection.GeneratedProtocolMessageType('Interleave', (_message.Message,), dict(
-    DESCRIPTOR = _ROWFILTER_INTERLEAVE,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter.Interleave)
-    ))
-  ,
-
-  Condition = _reflection.GeneratedProtocolMessageType('Condition', (_message.Message,), dict(
-    DESCRIPTOR = _ROWFILTER_CONDITION,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter.Condition)
-    ))
-  ,
-  DESCRIPTOR = _ROWFILTER,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.RowFilter)
-  ))
-_sym_db.RegisterMessage(RowFilter)
-_sym_db.RegisterMessage(RowFilter.Chain)
-_sym_db.RegisterMessage(RowFilter.Interleave)
-_sym_db.RegisterMessage(RowFilter.Condition)
-
-Mutation = _reflection.GeneratedProtocolMessageType('Mutation', (_message.Message,), dict(
-
-  SetCell = _reflection.GeneratedProtocolMessageType('SetCell', (_message.Message,), dict(
-    DESCRIPTOR = _MUTATION_SETCELL,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.SetCell)
-    ))
-  ,
-
-  DeleteFromColumn = _reflection.GeneratedProtocolMessageType('DeleteFromColumn', (_message.Message,), dict(
-    DESCRIPTOR = _MUTATION_DELETEFROMCOLUMN,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.DeleteFromColumn)
-    ))
-  ,
-
-  DeleteFromFamily = _reflection.GeneratedProtocolMessageType('DeleteFromFamily', (_message.Message,), dict(
-    DESCRIPTOR = _MUTATION_DELETEFROMFAMILY,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.DeleteFromFamily)
-    ))
-  ,
-
-  DeleteFromRow = _reflection.GeneratedProtocolMessageType('DeleteFromRow', (_message.Message,), dict(
-    DESCRIPTOR = _MUTATION_DELETEFROMROW,
-    __module__ = 'google.bigtable.v2.data_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation.DeleteFromRow)
-    ))
-  ,
-  DESCRIPTOR = _MUTATION,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.Mutation)
-  ))
-_sym_db.RegisterMessage(Mutation)
-_sym_db.RegisterMessage(Mutation.SetCell)
-_sym_db.RegisterMessage(Mutation.DeleteFromColumn)
-_sym_db.RegisterMessage(Mutation.DeleteFromFamily)
-_sym_db.RegisterMessage(Mutation.DeleteFromRow)
-
-ReadModifyWriteRule = _reflection.GeneratedProtocolMessageType('ReadModifyWriteRule', (_message.Message,), dict(
-  DESCRIPTOR = _READMODIFYWRITERULE,
-  __module__ = 'google.bigtable.v2.data_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.v2.ReadModifyWriteRule)
-  ))
-_sym_db.RegisterMessage(ReadModifyWriteRule)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\026com.google.bigtable.v2B\tDataProtoP\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/_generated/instance_pb2.py b/google/cloud/bigtable/_generated/instance_pb2.py
deleted file mode 100644
index 8d4383d31e79..000000000000
--- a/google/cloud/bigtable/_generated/instance_pb2.py
+++ /dev/null
@@ -1,222 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/admin/v2/instance.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.cloud.bigtable._generated import common_pb2 as google_dot_bigtable_dot_admin_dot_v2_dot_common__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/admin/v2/instance.proto',
-  package='google.bigtable.admin.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n\'google/bigtable/admin/v2/instance.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a%google/bigtable/admin/v2/common.proto\"\x9e\x01\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x37\n\x05state\x18\x03 \x01(\x0e\x32(.google.bigtable.admin.v2.Instance.State\"5\n\x05State\x12\x13\n\x0fSTATE_NOT_KNOWN\x10\x00\x12\t\n\x05READY\x10\x01\x12\x0c\n\x08\x43REATING\x10\x02\"\x8e\x02\n\x07\x43luster\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08location\x18\x02 \x01(\t\x12\x36\n\x05state\x18\x03 \x01(\x0e\x32\'.google.bigtable.admin.v2.Cluster.State\x12\x13\n\x0bserve_nodes\x18\x04 \x01(\x05\x12\x43\n\x14\x64\x65\x66\x61ult_storage_type\x18\x05 \x01(\x0e\x32%.google.bigtable.admin.v2.StorageType\"Q\n\x05State\x12\x13\n\x0fSTATE_NOT_KNOWN\x10\x00\x12\t\n\x05READY\x10\x01\x12\x0c\n\x08\x43REATING\x10\x02\x12\x0c\n\x08RESIZING\x10\x03\x12\x0c\n\x08\x44ISABLED\x10\x04\x42/\n\x1c\x63om.google.bigtable.admin.v2B\rInstanceProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_bigtable_dot_admin_dot_v2_dot_common__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-_INSTANCE_STATE = _descriptor.EnumDescriptor(
-  name='State',
-  full_name='google.bigtable.admin.v2.Instance.State',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='STATE_NOT_KNOWN', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='READY', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='CREATING', index=2, number=2,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=244,
-  serialized_end=297,
-)
-_sym_db.RegisterEnumDescriptor(_INSTANCE_STATE)
-
-_CLUSTER_STATE = _descriptor.EnumDescriptor(
-  name='State',
-  full_name='google.bigtable.admin.v2.Cluster.State',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='STATE_NOT_KNOWN', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='READY', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='CREATING', index=2, number=2,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='RESIZING', index=3, number=3,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='DISABLED', index=4, number=4,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=489,
-  serialized_end=570,
-)
-_sym_db.RegisterEnumDescriptor(_CLUSTER_STATE)
-
-
-_INSTANCE = _descriptor.Descriptor(
-  name='Instance',
-  full_name='google.bigtable.admin.v2.Instance',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.Instance.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='display_name', full_name='google.bigtable.admin.v2.Instance.display_name', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='state', full_name='google.bigtable.admin.v2.Instance.state', index=2,
-      number=3, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _INSTANCE_STATE,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=139,
-  serialized_end=297,
-)
-
-
-_CLUSTER = _descriptor.Descriptor(
-  name='Cluster',
-  full_name='google.bigtable.admin.v2.Cluster',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.Cluster.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='location', full_name='google.bigtable.admin.v2.Cluster.location', index=1,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='state', full_name='google.bigtable.admin.v2.Cluster.state', index=2,
-      number=3, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='serve_nodes', full_name='google.bigtable.admin.v2.Cluster.serve_nodes', index=3,
-      number=4, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='default_storage_type', full_name='google.bigtable.admin.v2.Cluster.default_storage_type', index=4,
-      number=5, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _CLUSTER_STATE,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=300,
-  serialized_end=570,
-)
-
-_INSTANCE.fields_by_name['state'].enum_type = _INSTANCE_STATE
-_INSTANCE_STATE.containing_type = _INSTANCE
-_CLUSTER.fields_by_name['state'].enum_type = _CLUSTER_STATE
-_CLUSTER.fields_by_name['default_storage_type'].enum_type = google_dot_bigtable_dot_admin_dot_v2_dot_common__pb2._STORAGETYPE
-_CLUSTER_STATE.containing_type = _CLUSTER
-DESCRIPTOR.message_types_by_name['Instance'] = _INSTANCE
-DESCRIPTOR.message_types_by_name['Cluster'] = _CLUSTER
-
-Instance = _reflection.GeneratedProtocolMessageType('Instance', (_message.Message,), dict(
-  DESCRIPTOR = _INSTANCE,
-  __module__ = 'google.bigtable.admin.v2.instance_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Instance)
-  ))
-_sym_db.RegisterMessage(Instance)
-
-Cluster = _reflection.GeneratedProtocolMessageType('Cluster', (_message.Message,), dict(
-  DESCRIPTOR = _CLUSTER,
-  __module__ = 'google.bigtable.admin.v2.instance_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Cluster)
-  ))
-_sym_db.RegisterMessage(Cluster)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\034com.google.bigtable.admin.v2B\rInstanceProtoP\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/_generated/operations_grpc_pb2.py b/google/cloud/bigtable/_generated/operations_grpc_pb2.py
deleted file mode 100644
index 5723e1d99fe0..000000000000
--- a/google/cloud/bigtable/_generated/operations_grpc_pb2.py
+++ /dev/null
@@ -1,264 +0,0 @@
-from google.longrunning.operations_pb2 import (
-    CancelOperationRequest,
-    DeleteOperationRequest,
-    GetOperationRequest,
-    ListOperationsRequest,
-    ListOperationsResponse,
-    Operation,
-    google_dot_protobuf_dot_empty__pb2,
-)
-from grpc.beta import implementations as beta_implementations
-from grpc.beta import interfaces as beta_interfaces
-from grpc.framework.common import cardinality
-from grpc.framework.interfaces.face import utilities as face_utilities
-
-
-class OperationsStub(object):
-  """Manages long-running operations with an API service.
-
-  When an API method normally takes long time to complete, it can be designed
-  to return [Operation][google.longrunning.Operation] to the client, and the client can use this
-  interface to receive the real response asynchronously by polling the
-  operation resource, or using `google.watcher.v1.Watcher` interface to watch
-  the response, or pass the operation resource to another API (such as Google
-  Cloud Pub/Sub API) to receive the response.  Any API service that returns
-  long-running operations should implement the `Operations` interface so
-  developers can have a consistent client experience.
-  """
-
-  def __init__(self, channel):
-    """Constructor.
-
-    Args:
-      channel: A grpc.Channel.
-    """
-    self.GetOperation = channel.unary_unary(
-        '/google.longrunning.Operations/GetOperation',
-        request_serializer=GetOperationRequest.SerializeToString,
-        response_deserializer=Operation.FromString,
-        )
-    self.ListOperations = channel.unary_unary(
-        '/google.longrunning.Operations/ListOperations',
-        request_serializer=ListOperationsRequest.SerializeToString,
-        response_deserializer=ListOperationsResponse.FromString,
-        )
-    self.CancelOperation = channel.unary_unary(
-        '/google.longrunning.Operations/CancelOperation',
-        request_serializer=CancelOperationRequest.SerializeToString,
-        response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-        )
-    self.DeleteOperation = channel.unary_unary(
-        '/google.longrunning.Operations/DeleteOperation',
-        request_serializer=DeleteOperationRequest.SerializeToString,
-        response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-        )
-
-
-class OperationsServicer(object):
-  """Manages long-running operations with an API service.
-
-  When an API method normally takes long time to complete, it can be designed
-  to return [Operation][google.longrunning.Operation] to the client, and the client can use this
-  interface to receive the real response asynchronously by polling the
-  operation resource, or using `google.watcher.v1.Watcher` interface to watch
-  the response, or pass the operation resource to another API (such as Google
-  Cloud Pub/Sub API) to receive the response.  Any API service that returns
-  long-running operations should implement the `Operations` interface so
-  developers can have a consistent client experience.
-  """
-
-  def GetOperation(self, request, context):
-    """Gets the latest state of a long-running operation.  Clients may use this
-    method to poll the operation result at intervals as recommended by the API
-    service.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def ListOperations(self, request, context):
-    """Lists operations that match the specified filter in the request. If the
-    server doesn't support this method, it returns
-    `google.rpc.Code.UNIMPLEMENTED`.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def CancelOperation(self, request, context):
-    """Starts asynchronous cancellation on a long-running operation.  The server
-    makes a best effort to cancel the operation, but success is not
-    guaranteed.  If the server doesn't support this method, it returns
-    `google.rpc.Code.UNIMPLEMENTED`.  Clients may use
-    [Operations.GetOperation] or other methods to check whether the
-    cancellation succeeded or the operation completed despite cancellation.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def DeleteOperation(self, request, context):
-    """Deletes a long-running operation.  It indicates the client is no longer
-    interested in the operation result. It does not cancel the operation.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-
-def add_OperationsServicer_to_server(servicer, server):
-  rpc_method_handlers = {
-      'GetOperation': grpc.unary_unary_rpc_method_handler(
-          servicer.GetOperation,
-          request_deserializer=GetOperationRequest.FromString,
-          response_serializer=Operation.SerializeToString,
-      ),
-      'ListOperations': grpc.unary_unary_rpc_method_handler(
-          servicer.ListOperations,
-          request_deserializer=ListOperationsRequest.FromString,
-          response_serializer=ListOperationsResponse.SerializeToString,
-      ),
-      'CancelOperation': grpc.unary_unary_rpc_method_handler(
-          servicer.CancelOperation,
-          request_deserializer=CancelOperationRequest.FromString,
-          response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-      ),
-      'DeleteOperation': grpc.unary_unary_rpc_method_handler(
-          servicer.DeleteOperation,
-          request_deserializer=DeleteOperationRequest.FromString,
-          response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-      ),
-  }
-  generic_handler = grpc.method_handlers_generic_handler(
-      'google.longrunning.Operations', rpc_method_handlers)
-  server.add_generic_rpc_handlers((generic_handler,))
-
-
-class BetaOperationsServicer(object):
-  """Manages long-running operations with an API service.
-
-  When an API method normally takes long time to complete, it can be designed
-  to return [Operation][google.longrunning.Operation] to the client, and the client can use this
-  interface to receive the real response asynchronously by polling the
-  operation resource, or using `google.watcher.v1.Watcher` interface to watch
-  the response, or pass the operation resource to another API (such as Google
-  Cloud Pub/Sub API) to receive the response.  Any API service that returns
-  long-running operations should implement the `Operations` interface so
-  developers can have a consistent client experience.
-  """
-  def GetOperation(self, request, context):
-    """Gets the latest state of a long-running operation.  Clients may use this
-    method to poll the operation result at intervals as recommended by the API
-    service.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def ListOperations(self, request, context):
-    """Lists operations that match the specified filter in the request. If the
-    server doesn't support this method, it returns
-    `google.rpc.Code.UNIMPLEMENTED`.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def CancelOperation(self, request, context):
-    """Starts asynchronous cancellation on a long-running operation.  The server
-    makes a best effort to cancel the operation, but success is not
-    guaranteed.  If the server doesn't support this method, it returns
-    `google.rpc.Code.UNIMPLEMENTED`.  Clients may use
-    [Operations.GetOperation] or other methods to check whether the
-    cancellation succeeded or the operation completed despite cancellation.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def DeleteOperation(self, request, context):
-    """Deletes a long-running operation.  It indicates the client is no longer
-    interested in the operation result. It does not cancel the operation.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-
-
-class BetaOperationsStub(object):
-  """Manages long-running operations with an API service.
-
-  When an API method normally takes long time to complete, it can be designed
-  to return [Operation][google.longrunning.Operation] to the client, and the client can use this
-  interface to receive the real response asynchronously by polling the
-  operation resource, or using `google.watcher.v1.Watcher` interface to watch
-  the response, or pass the operation resource to another API (such as Google
-  Cloud Pub/Sub API) to receive the response.  Any API service that returns
-  long-running operations should implement the `Operations` interface so
-  developers can have a consistent client experience.
-  """
-  def GetOperation(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Gets the latest state of a long-running operation.  Clients may use this
-    method to poll the operation result at intervals as recommended by the API
-    service.
-    """
-    raise NotImplementedError()
-  GetOperation.future = None
-  def ListOperations(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Lists operations that match the specified filter in the request. If the
-    server doesn't support this method, it returns
-    `google.rpc.Code.UNIMPLEMENTED`.
-    """
-    raise NotImplementedError()
-  ListOperations.future = None
-  def CancelOperation(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Starts asynchronous cancellation on a long-running operation.  The server
-    makes a best effort to cancel the operation, but success is not
-    guaranteed.  If the server doesn't support this method, it returns
-    `google.rpc.Code.UNIMPLEMENTED`.  Clients may use
-    [Operations.GetOperation] or other methods to check whether the
-    cancellation succeeded or the operation completed despite cancellation.
-    """
-    raise NotImplementedError()
-  CancelOperation.future = None
-  def DeleteOperation(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Deletes a long-running operation.  It indicates the client is no longer
-    interested in the operation result. It does not cancel the operation.
-    """
-    raise NotImplementedError()
-  DeleteOperation.future = None
-
-
-def beta_create_Operations_server(servicer, pool=None, pool_size=None, default_timeout=None, maximum_timeout=None):
-  request_deserializers = {
-    ('google.longrunning.Operations', 'CancelOperation'): CancelOperationRequest.FromString,
-    ('google.longrunning.Operations', 'DeleteOperation'): DeleteOperationRequest.FromString,
-    ('google.longrunning.Operations', 'GetOperation'): GetOperationRequest.FromString,
-    ('google.longrunning.Operations', 'ListOperations'): ListOperationsRequest.FromString,
-  }
-  response_serializers = {
-    ('google.longrunning.Operations', 'CancelOperation'): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-    ('google.longrunning.Operations', 'DeleteOperation'): google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
-    ('google.longrunning.Operations', 'GetOperation'): Operation.SerializeToString,
-    ('google.longrunning.Operations', 'ListOperations'): ListOperationsResponse.SerializeToString,
-  }
-  method_implementations = {
-    ('google.longrunning.Operations', 'CancelOperation'): face_utilities.unary_unary_inline(servicer.CancelOperation),
-    ('google.longrunning.Operations', 'DeleteOperation'): face_utilities.unary_unary_inline(servicer.DeleteOperation),
-    ('google.longrunning.Operations', 'GetOperation'): face_utilities.unary_unary_inline(servicer.GetOperation),
-    ('google.longrunning.Operations', 'ListOperations'): face_utilities.unary_unary_inline(servicer.ListOperations),
-  }
-  server_options = beta_implementations.server_options(request_deserializers=request_deserializers, response_serializers=response_serializers, thread_pool=pool, thread_pool_size=pool_size, default_timeout=default_timeout, maximum_timeout=maximum_timeout)
-  return beta_implementations.server(method_implementations, options=server_options)
-
-
-def beta_create_Operations_stub(channel, host=None, metadata_transformer=None, pool=None, pool_size=None):
-  request_serializers = {
-    ('google.longrunning.Operations', 'CancelOperation'): CancelOperationRequest.SerializeToString,
-    ('google.longrunning.Operations', 'DeleteOperation'): DeleteOperationRequest.SerializeToString,
-    ('google.longrunning.Operations', 'GetOperation'): GetOperationRequest.SerializeToString,
-    ('google.longrunning.Operations', 'ListOperations'): ListOperationsRequest.SerializeToString,
-  }
-  response_deserializers = {
-    ('google.longrunning.Operations', 'CancelOperation'): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-    ('google.longrunning.Operations', 'DeleteOperation'): google_dot_protobuf_dot_empty__pb2.Empty.FromString,
-    ('google.longrunning.Operations', 'GetOperation'): Operation.FromString,
-    ('google.longrunning.Operations', 'ListOperations'): ListOperationsResponse.FromString,
-  }
-  cardinalities = {
-    'CancelOperation': cardinality.Cardinality.UNARY_UNARY,
-    'DeleteOperation': cardinality.Cardinality.UNARY_UNARY,
-    'GetOperation': cardinality.Cardinality.UNARY_UNARY,
-    'ListOperations': cardinality.Cardinality.UNARY_UNARY,
-  }
-  stub_options = beta_implementations.stub_options(host=host, metadata_transformer=metadata_transformer, request_serializers=request_serializers, response_deserializers=response_deserializers, thread_pool=pool, thread_pool_size=pool_size)
-  return beta_implementations.dynamic_stub(channel, 'google.longrunning.Operations', cardinalities, options=stub_options)
diff --git a/google/cloud/bigtable/_generated/table_pb2.py b/google/cloud/bigtable/_generated/table_pb2.py
deleted file mode 100644
index 840076514cc7..000000000000
--- a/google/cloud/bigtable/_generated/table_pb2.py
+++ /dev/null
@@ -1,393 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/bigtable/admin/v2/table.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/bigtable/admin/v2/table.proto',
-  package='google.bigtable.admin.v2',
-  syntax='proto3',
-  serialized_pb=_b('\n$google/bigtable/admin/v2/table.proto\x12\x18google.bigtable.admin.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto\"\xa0\x03\n\x05Table\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x0f\x63olumn_families\x18\x03 \x03(\x0b\x32\x33.google.bigtable.admin.v2.Table.ColumnFamiliesEntry\x12I\n\x0bgranularity\x18\x04 \x01(\x0e\x32\x34.google.bigtable.admin.v2.Table.TimestampGranularity\x1a]\n\x13\x43olumnFamiliesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x35\n\x05value\x18\x02 \x01(\x0b\x32&.google.bigtable.admin.v2.ColumnFamily:\x02\x38\x01\"I\n\x14TimestampGranularity\x12%\n!TIMESTAMP_GRANULARITY_UNSPECIFIED\x10\x00\x12\n\n\x06MILLIS\x10\x01\"F\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\r\n\tNAME_ONLY\x10\x01\x12\x0f\n\x0bSCHEMA_VIEW\x10\x02\x12\x08\n\x04\x46ULL\x10\x04\"A\n\x0c\x43olumnFamily\x12\x31\n\x07gc_rule\x18\x01 \x01(\x0b\x32 .google.bigtable.admin.v2.GcRule\"\xd5\x02\n\x06GcRule\x12\x1a\n\x10max_num_versions\x18\x01 \x01(\x05H\x00\x12,\n\x07max_age\x18\x02 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x45\n\x0cintersection\x18\x03 \x01(\x0b\x32-.google.bigtable.admin.v2.GcRule.IntersectionH\x00\x12\x37\n\x05union\x18\x04 \x01(\x0b\x32&.google.bigtable.admin.v2.GcRule.UnionH\x00\x1a?\n\x0cIntersection\x12/\n\x05rules\x18\x01 \x03(\x0b\x32 .google.bigtable.admin.v2.GcRule\x1a\x38\n\x05Union\x12/\n\x05rules\x18\x01 \x03(\x0b\x32 .google.bigtable.admin.v2.GcRuleB\x06\n\x04ruleB,\n\x1c\x63om.google.bigtable.admin.v2B\nTableProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-_TABLE_TIMESTAMPGRANULARITY = _descriptor.EnumDescriptor(
-  name='TimestampGranularity',
-  full_name='google.bigtable.admin.v2.Table.TimestampGranularity',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='TIMESTAMP_GRANULARITY_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='MILLIS', index=1, number=1,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=400,
-  serialized_end=473,
-)
-_sym_db.RegisterEnumDescriptor(_TABLE_TIMESTAMPGRANULARITY)
-
-_TABLE_VIEW = _descriptor.EnumDescriptor(
-  name='View',
-  full_name='google.bigtable.admin.v2.Table.View',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='VIEW_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='NAME_ONLY', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='SCHEMA_VIEW', index=2, number=2,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='FULL', index=3, number=4,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=475,
-  serialized_end=545,
-)
-_sym_db.RegisterEnumDescriptor(_TABLE_VIEW)
-
-
-_TABLE_COLUMNFAMILIESENTRY = _descriptor.Descriptor(
-  name='ColumnFamiliesEntry',
-  full_name='google.bigtable.admin.v2.Table.ColumnFamiliesEntry',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.bigtable.admin.v2.Table.ColumnFamiliesEntry.key', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.bigtable.admin.v2.Table.ColumnFamiliesEntry.value', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=_descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001')),
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=305,
-  serialized_end=398,
-)
-
-_TABLE = _descriptor.Descriptor(
-  name='Table',
-  full_name='google.bigtable.admin.v2.Table',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.bigtable.admin.v2.Table.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='column_families', full_name='google.bigtable.admin.v2.Table.column_families', index=1,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='granularity', full_name='google.bigtable.admin.v2.Table.granularity', index=2,
-      number=4, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_TABLE_COLUMNFAMILIESENTRY, ],
-  enum_types=[
-    _TABLE_TIMESTAMPGRANULARITY,
-    _TABLE_VIEW,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=129,
-  serialized_end=545,
-)
-
-
-_COLUMNFAMILY = _descriptor.Descriptor(
-  name='ColumnFamily',
-  full_name='google.bigtable.admin.v2.ColumnFamily',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='gc_rule', full_name='google.bigtable.admin.v2.ColumnFamily.gc_rule', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=547,
-  serialized_end=612,
-)
-
-
-_GCRULE_INTERSECTION = _descriptor.Descriptor(
-  name='Intersection',
-  full_name='google.bigtable.admin.v2.GcRule.Intersection',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='rules', full_name='google.bigtable.admin.v2.GcRule.Intersection.rules', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=827,
-  serialized_end=890,
-)
-
-_GCRULE_UNION = _descriptor.Descriptor(
-  name='Union',
-  full_name='google.bigtable.admin.v2.GcRule.Union',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='rules', full_name='google.bigtable.admin.v2.GcRule.Union.rules', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=892,
-  serialized_end=948,
-)
-
-_GCRULE = _descriptor.Descriptor(
-  name='GcRule',
-  full_name='google.bigtable.admin.v2.GcRule',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='max_num_versions', full_name='google.bigtable.admin.v2.GcRule.max_num_versions', index=0,
-      number=1, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='max_age', full_name='google.bigtable.admin.v2.GcRule.max_age', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='intersection', full_name='google.bigtable.admin.v2.GcRule.intersection', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='union', full_name='google.bigtable.admin.v2.GcRule.union', index=3,
-      number=4, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_GCRULE_INTERSECTION, _GCRULE_UNION, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='rule', full_name='google.bigtable.admin.v2.GcRule.rule',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=615,
-  serialized_end=956,
-)
-
-_TABLE_COLUMNFAMILIESENTRY.fields_by_name['value'].message_type = _COLUMNFAMILY
-_TABLE_COLUMNFAMILIESENTRY.containing_type = _TABLE
-_TABLE.fields_by_name['column_families'].message_type = _TABLE_COLUMNFAMILIESENTRY
-_TABLE.fields_by_name['granularity'].enum_type = _TABLE_TIMESTAMPGRANULARITY
-_TABLE_TIMESTAMPGRANULARITY.containing_type = _TABLE
-_TABLE_VIEW.containing_type = _TABLE
-_COLUMNFAMILY.fields_by_name['gc_rule'].message_type = _GCRULE
-_GCRULE_INTERSECTION.fields_by_name['rules'].message_type = _GCRULE
-_GCRULE_INTERSECTION.containing_type = _GCRULE
-_GCRULE_UNION.fields_by_name['rules'].message_type = _GCRULE
-_GCRULE_UNION.containing_type = _GCRULE
-_GCRULE.fields_by_name['max_age'].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
-_GCRULE.fields_by_name['intersection'].message_type = _GCRULE_INTERSECTION
-_GCRULE.fields_by_name['union'].message_type = _GCRULE_UNION
-_GCRULE.oneofs_by_name['rule'].fields.append(
-  _GCRULE.fields_by_name['max_num_versions'])
-_GCRULE.fields_by_name['max_num_versions'].containing_oneof = _GCRULE.oneofs_by_name['rule']
-_GCRULE.oneofs_by_name['rule'].fields.append(
-  _GCRULE.fields_by_name['max_age'])
-_GCRULE.fields_by_name['max_age'].containing_oneof = _GCRULE.oneofs_by_name['rule']
-_GCRULE.oneofs_by_name['rule'].fields.append(
-  _GCRULE.fields_by_name['intersection'])
-_GCRULE.fields_by_name['intersection'].containing_oneof = _GCRULE.oneofs_by_name['rule']
-_GCRULE.oneofs_by_name['rule'].fields.append(
-  _GCRULE.fields_by_name['union'])
-_GCRULE.fields_by_name['union'].containing_oneof = _GCRULE.oneofs_by_name['rule']
-DESCRIPTOR.message_types_by_name['Table'] = _TABLE
-DESCRIPTOR.message_types_by_name['ColumnFamily'] = _COLUMNFAMILY
-DESCRIPTOR.message_types_by_name['GcRule'] = _GCRULE
-
-Table = _reflection.GeneratedProtocolMessageType('Table', (_message.Message,), dict(
-
-  ColumnFamiliesEntry = _reflection.GeneratedProtocolMessageType('ColumnFamiliesEntry', (_message.Message,), dict(
-    DESCRIPTOR = _TABLE_COLUMNFAMILIESENTRY,
-    __module__ = 'google.bigtable.admin.v2.table_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Table.ColumnFamiliesEntry)
-    ))
-  ,
-  DESCRIPTOR = _TABLE,
-  __module__ = 'google.bigtable.admin.v2.table_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.Table)
-  ))
-_sym_db.RegisterMessage(Table)
-_sym_db.RegisterMessage(Table.ColumnFamiliesEntry)
-
-ColumnFamily = _reflection.GeneratedProtocolMessageType('ColumnFamily', (_message.Message,), dict(
-  DESCRIPTOR = _COLUMNFAMILY,
-  __module__ = 'google.bigtable.admin.v2.table_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.ColumnFamily)
-  ))
-_sym_db.RegisterMessage(ColumnFamily)
-
-GcRule = _reflection.GeneratedProtocolMessageType('GcRule', (_message.Message,), dict(
-
-  Intersection = _reflection.GeneratedProtocolMessageType('Intersection', (_message.Message,), dict(
-    DESCRIPTOR = _GCRULE_INTERSECTION,
-    __module__ = 'google.bigtable.admin.v2.table_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GcRule.Intersection)
-    ))
-  ,
-
-  Union = _reflection.GeneratedProtocolMessageType('Union', (_message.Message,), dict(
-    DESCRIPTOR = _GCRULE_UNION,
-    __module__ = 'google.bigtable.admin.v2.table_pb2'
-    # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GcRule.Union)
-    ))
-  ,
-  DESCRIPTOR = _GCRULE,
-  __module__ = 'google.bigtable.admin.v2.table_pb2'
-  # @@protoc_insertion_point(class_scope:google.bigtable.admin.v2.GcRule)
-  ))
-_sym_db.RegisterMessage(GcRule)
-_sym_db.RegisterMessage(GcRule.Intersection)
-_sym_db.RegisterMessage(GcRule.Union)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\034com.google.bigtable.admin.v2B\nTableProtoP\001'))
-_TABLE_COLUMNFAMILIESENTRY.has_options = True
-_TABLE_COLUMNFAMILIESENTRY._options = _descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/bigtable/client.py b/google/cloud/bigtable/client.py
deleted file mode 100644
index 418358b0e84e..000000000000
--- a/google/cloud/bigtable/client.py
+++ /dev/null
@@ -1,355 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Parent client for calling the Google Cloud Bigtable API.
-
-This is the base from which all interactions with the API occur.
-
-In the hierarchy of API concepts
-
-* a :class:`Client` owns an :class:`.Instance`
-* a :class:`.Instance` owns a :class:`~google.cloud.bigtable.table.Table`
-* a :class:`~google.cloud.bigtable.table.Table` owns a
-  :class:`~.column_family.ColumnFamily`
-* a :class:`~google.cloud.bigtable.table.Table` owns a :class:`~.row.Row`
-  (and all the cells in the row)
-"""
-
-
-import os
-
-from google.cloud._helpers import make_insecure_stub
-from google.cloud._helpers import make_secure_stub
-from google.cloud.bigtable._generated import bigtable_instance_admin_pb2
-from google.cloud.bigtable._generated import bigtable_pb2
-from google.cloud.bigtable._generated import bigtable_table_admin_pb2
-from google.cloud.bigtable._generated import operations_grpc_pb2
-from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-from google.cloud.bigtable.instance import Instance
-from google.cloud.bigtable.instance import _EXISTING_INSTANCE_LOCATION_ID
-from google.cloud.client import _ClientFactoryMixin
-from google.cloud.client import _ClientProjectMixin
-from google.cloud.connection import DEFAULT_USER_AGENT
-from google.cloud.credentials import get_credentials
-from google.cloud.environment_vars import BIGTABLE_EMULATOR
-
-
-TABLE_ADMIN_HOST = 'bigtableadmin.googleapis.com'
-"""Table Admin API request host."""
-
-INSTANCE_ADMIN_HOST = 'bigtableadmin.googleapis.com'
-"""Cluster Admin API request host."""
-
-DATA_API_HOST = 'bigtable.googleapis.com'
-"""Data API request host."""
-
-OPERATIONS_API_HOST = INSTANCE_ADMIN_HOST
-
-ADMIN_SCOPE = 'https://www.googleapis.com/auth/bigtable.admin'
-"""Scope for interacting with the Cluster Admin and Table Admin APIs."""
-DATA_SCOPE = 'https://www.googleapis.com/auth/bigtable.data'
-"""Scope for reading and writing table data."""
-READ_ONLY_SCOPE = 'https://www.googleapis.com/auth/bigtable.data.readonly'
-"""Scope for reading table data."""
-
-
-def _make_data_stub(client):
-    """Creates gRPC stub to make requests to the Data API.
-
-    :type client: :class:`Client`
-    :param client: The client that will hold the stub.
-
-    :rtype: :class:`._generated.bigtable_pb2.BigtableStub`
-    :returns: A gRPC stub object.
-    """
-    if client.emulator_host is None:
-        return make_secure_stub(client.credentials, client.user_agent,
-                                bigtable_pb2.BigtableStub, DATA_API_HOST)
-    else:
-        return make_insecure_stub(bigtable_pb2.BigtableStub,
-                                  client.emulator_host)
-
-
-def _make_instance_stub(client):
-    """Creates gRPC stub to make requests to the Instance Admin API.
-
-    :type client: :class:`Client`
-    :param client: The client that will hold the stub.
-
-    :rtype: :class:`.bigtable_instance_admin_pb2.BigtableInstanceAdminStub`
-    :returns: A gRPC stub object.
-    """
-    if client.emulator_host is None:
-        return make_secure_stub(
-            client.credentials, client.user_agent,
-            bigtable_instance_admin_pb2.BigtableInstanceAdminStub,
-            INSTANCE_ADMIN_HOST)
-    else:
-        return make_insecure_stub(
-            bigtable_instance_admin_pb2.BigtableInstanceAdminStub,
-            client.emulator_host)
-
-
-def _make_operations_stub(client):
-    """Creates gRPC stub to make requests to the Operations API.
-
-    These are for long-running operations of the Instance Admin API,
-    hence the host and port matching.
-
-    :type client: :class:`Client`
-    :param client: The client that will hold the stub.
-
-    :rtype: :class:`._generated.operations_grpc_pb2.OperationsStub`
-    :returns: A gRPC stub object.
-    """
-    if client.emulator_host is None:
-        return make_secure_stub(client.credentials, client.user_agent,
-                                operations_grpc_pb2.OperationsStub,
-                                OPERATIONS_API_HOST)
-    else:
-        return make_insecure_stub(operations_grpc_pb2.OperationsStub,
-                                  client.emulator_host)
-
-
-def _make_table_stub(client):
-    """Creates gRPC stub to make requests to the Table Admin API.
-
-    :type client: :class:`Client`
-    :param client: The client that will hold the stub.
-
-    :rtype: :class:`.bigtable_instance_admin_pb2.BigtableTableAdminStub`
-    :returns: A gRPC stub object.
-    """
-    if client.emulator_host is None:
-        return make_secure_stub(
-            client.credentials, client.user_agent,
-            bigtable_table_admin_pb2.BigtableTableAdminStub,
-            TABLE_ADMIN_HOST)
-    else:
-        return make_insecure_stub(
-            bigtable_table_admin_pb2.BigtableTableAdminStub,
-            client.emulator_host)
-
-
-class Client(_ClientFactoryMixin, _ClientProjectMixin):
-    """Client for interacting with Google Cloud Bigtable API.
-
-    .. note::
-
-        Since the Cloud Bigtable API requires the gRPC transport, no
-        ``http`` argument is accepted by this class.
-
-    :type project: :class:`str` or :func:`unicode <unicode>`
-    :param project: (Optional) The ID of the project which owns the
-                    instances, tables and data. If not provided, will
-                    attempt to determine from the environment.
-
-    :type credentials:
-        :class:`OAuth2Credentials <oauth2client.client.OAuth2Credentials>` or
-        :data:`NoneType <types.NoneType>`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        client. If not provided, defaults to the Google
-                        Application Default Credentials.
-
-    :type read_only: bool
-    :param read_only: (Optional) Boolean indicating if the data scope should be
-                      for reading only (or for writing as well). Defaults to
-                      :data:`False`.
-
-    :type admin: bool
-    :param admin: (Optional) Boolean indicating if the client will be used to
-                  interact with the Instance Admin or Table Admin APIs. This
-                  requires the :const:`ADMIN_SCOPE`. Defaults to :data:`False`.
-
-    :type user_agent: str
-    :param user_agent: (Optional) The user agent to be used with API request.
-                       Defaults to :const:`DEFAULT_USER_AGENT`.
-
-    :raises: :class:`ValueError <exceptions.ValueError>` if both ``read_only``
-             and ``admin`` are :data:`True`
-    """
-
-    _instance_stub_internal = None
-    _operations_stub_internal = None
-    _table_stub_internal = None
-
-    def __init__(self, project=None, credentials=None,
-                 read_only=False, admin=False, user_agent=DEFAULT_USER_AGENT):
-        _ClientProjectMixin.__init__(self, project=project)
-        if credentials is None:
-            credentials = get_credentials()
-
-        if read_only and admin:
-            raise ValueError('A read-only client cannot also perform'
-                             'administrative actions.')
-
-        scopes = []
-        if read_only:
-            scopes.append(READ_ONLY_SCOPE)
-        else:
-            scopes.append(DATA_SCOPE)
-
-        if admin:
-            scopes.append(ADMIN_SCOPE)
-
-        self._admin = bool(admin)
-        try:
-            credentials = credentials.create_scoped(scopes)
-        except AttributeError:
-            pass
-        self._credentials = credentials
-        self.user_agent = user_agent
-        self.emulator_host = os.getenv(BIGTABLE_EMULATOR)
-
-        # Create gRPC stubs for making requests.
-        self._data_stub = _make_data_stub(self)
-        if self._admin:
-            self._instance_stub_internal = _make_instance_stub(self)
-            self._operations_stub_internal = _make_operations_stub(self)
-            self._table_stub_internal = _make_table_stub(self)
-
-    def copy(self):
-        """Make a copy of this client.
-
-        Copies the local data stored as simple types but does not copy the
-        current state of any open connections with the Cloud Bigtable API.
-
-        :rtype: :class:`.Client`
-        :returns: A copy of the current client.
-        """
-        credentials = self._credentials
-        copied_creds = credentials.create_scoped(credentials.scopes)
-        return self.__class__(
-            self.project,
-            copied_creds,
-            READ_ONLY_SCOPE in copied_creds.scopes,
-            self._admin,
-            self.user_agent,
-        )
-
-    @property
-    def credentials(self):
-        """Getter for client's credentials.
-
-        :rtype:
-            :class:`OAuth2Credentials <oauth2client.client.OAuth2Credentials>`
-        :returns: The credentials stored on the client.
-        """
-        return self._credentials
-
-    @property
-    def project_name(self):
-        """Project name to be used with Instance Admin API.
-
-        .. note::
-
-            This property will not change if ``project`` does not, but the
-            return value is not cached.
-
-        The project name is of the form
-
-            ``"projects/{project}"``
-
-        :rtype: str
-        :returns: The project name to be used with the Cloud Bigtable Admin
-                  API RPC service.
-        """
-        return 'projects/' + self.project
-
-    @property
-    def _instance_stub(self):
-        """Getter for the gRPC stub used for the Instance Admin API.
-
-        :rtype: :class:`.bigtable_instance_admin_pb2.BigtableInstanceAdminStub`
-        :returns: A gRPC stub object.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the current
-                 client is not an admin client or if it has not been
-                 :meth:`start`-ed.
-        """
-        if not self._admin:
-            raise ValueError('Client is not an admin client.')
-        return self._instance_stub_internal
-
-    @property
-    def _operations_stub(self):
-        """Getter for the gRPC stub used for the Operations API.
-
-        :rtype: :class:`._generated.operations_grpc_pb2.OperationsStub`
-        :returns: A gRPC stub object.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the current
-                 client is not an admin client or if it has not been
-                 :meth:`start`-ed.
-        """
-        if not self._admin:
-            raise ValueError('Client is not an admin client.')
-        return self._operations_stub_internal
-
-    @property
-    def _table_stub(self):
-        """Getter for the gRPC stub used for the Table Admin API.
-
-        :rtype: :class:`.bigtable_instance_admin_pb2.BigtableTableAdminStub`
-        :returns: A gRPC stub object.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the current
-                 client is not an admin client or if it has not been
-                 :meth:`start`-ed.
-        """
-        if not self._admin:
-            raise ValueError('Client is not an admin client.')
-        return self._table_stub_internal
-
-    def instance(self, instance_id, location=_EXISTING_INSTANCE_LOCATION_ID,
-                 display_name=None, serve_nodes=DEFAULT_SERVE_NODES):
-        """Factory to create a instance associated with this client.
-
-        :type instance_id: str
-        :param instance_id: The ID of the instance.
-
-        :type location: string
-        :param location: location name, in form
-                         ``projects/<project>/locations/<location>``; used to
-                         set up the instance's cluster.
-
-        :type display_name: str
-        :param display_name: (Optional) The display name for the instance in
-                             the Cloud Console UI. (Must be between 4 and 30
-                             characters.) If this value is not set in the
-                             constructor, will fall back to the instance ID.
-
-        :type serve_nodes: int
-        :param serve_nodes: (Optional) The number of nodes in the instance's
-                            cluster; used to set up the instance's cluster.
-
-        :rtype: :class:`.Instance`
-        :returns: an instance owned by this client.
-        """
-        return Instance(instance_id, self, location,
-                        display_name=display_name, serve_nodes=serve_nodes)
-
-    def list_instances(self):
-        """List instances owned by the project.
-
-        :rtype: tuple
-        :returns: A pair of results, the first is a list of
-                  :class:`.Instance` objects returned and the second is a
-                  list of strings (the failed locations in the request).
-        """
-        request_pb = bigtable_instance_admin_pb2.ListInstancesRequest(
-            parent=self.project_name)
-
-        response = self._instance_stub.ListInstances(request_pb)
-
-        instances = [Instance.from_pb(instance_pb, self)
-                     for instance_pb in response.instances]
-        return instances, response.failed_locations
diff --git a/google/cloud/bigtable/cluster.py b/google/cloud/bigtable/cluster.py
deleted file mode 100644
index f89e80ea6832..000000000000
--- a/google/cloud/bigtable/cluster.py
+++ /dev/null
@@ -1,277 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""User friendly container for Google Cloud Bigtable Cluster."""
-
-
-import re
-
-from google.cloud.bigtable._generated import (
-    instance_pb2 as data_v2_pb2)
-from google.cloud.bigtable._generated import (
-    bigtable_instance_admin_pb2 as messages_v2_pb2)
-from google.cloud.operation import Operation
-from google.cloud.operation import _compute_type_url
-from google.cloud.operation import _register_type_url
-
-
-_CLUSTER_NAME_RE = re.compile(r'^projects/(?P<project>[^/]+)/'
-                              r'instances/(?P<instance>[^/]+)/clusters/'
-                              r'(?P<cluster_id>[a-z][-a-z0-9]*)$')
-
-DEFAULT_SERVE_NODES = 3
-"""Default number of nodes to use when creating a cluster."""
-
-
-_UPDATE_CLUSTER_METADATA_URL = _compute_type_url(
-    messages_v2_pb2.UpdateClusterMetadata)
-_register_type_url(
-    _UPDATE_CLUSTER_METADATA_URL, messages_v2_pb2.UpdateClusterMetadata)
-
-
-def _prepare_create_request(cluster):
-    """Creates a protobuf request for a CreateCluster request.
-
-    :type cluster: :class:`Cluster`
-    :param cluster: The cluster to be created.
-
-    :rtype: :class:`.messages_v2_pb2.CreateClusterRequest`
-    :returns: The CreateCluster request object containing the cluster info.
-    """
-    return messages_v2_pb2.CreateClusterRequest(
-        parent=cluster._instance.name,
-        cluster_id=cluster.cluster_id,
-        cluster=data_v2_pb2.Cluster(
-            serve_nodes=cluster.serve_nodes,
-        ),
-    )
-
-
-class Cluster(object):
-    """Representation of a Google Cloud Bigtable Cluster.
-
-    We can use a :class:`Cluster` to:
-
-    * :meth:`reload` itself
-    * :meth:`create` itself
-    * :meth:`update` itself
-    * :meth:`delete` itself
-
-    .. note::
-
-        For now, we leave out the ``default_storage_type`` (an enum)
-        which if not sent will end up as :data:`.data_v2_pb2.STORAGE_SSD`.
-
-    :type cluster_id: str
-    :param cluster_id: The ID of the cluster.
-
-    :type instance: :class:`.instance.Instance`
-    :param instance: The instance where the cluster resides.
-
-    :type serve_nodes: int
-    :param serve_nodes: (Optional) The number of nodes in the cluster.
-                        Defaults to :data:`DEFAULT_SERVE_NODES`.
-    """
-
-    def __init__(self, cluster_id, instance,
-                 serve_nodes=DEFAULT_SERVE_NODES):
-        self.cluster_id = cluster_id
-        self._instance = instance
-        self.serve_nodes = serve_nodes
-        self.location = None
-
-    def _update_from_pb(self, cluster_pb):
-        """Refresh self from the server-provided protobuf.
-
-        Helper for :meth:`from_pb` and :meth:`reload`.
-        """
-        if not cluster_pb.serve_nodes:  # Simple field (int32)
-            raise ValueError('Cluster protobuf does not contain serve_nodes')
-        self.serve_nodes = cluster_pb.serve_nodes
-        self.location = cluster_pb.location
-
-    @classmethod
-    def from_pb(cls, cluster_pb, instance):
-        """Creates a cluster instance from a protobuf.
-
-        :type cluster_pb: :class:`instance_pb2.Cluster`
-        :param cluster_pb: A cluster protobuf object.
-
-        :type instance: :class:`.instance.Instance>`
-        :param instance: The instance that owns the cluster.
-
-        :rtype: :class:`Cluster`
-        :returns: The cluster parsed from the protobuf response.
-        :raises:
-            :class:`ValueError <exceptions.ValueError>` if the cluster
-            name does not match
-            ``projects/{project}/instances/{instance}/clusters/{cluster_id}``
-            or if the parsed project ID does not match the project ID
-            on the client.
-        """
-        match = _CLUSTER_NAME_RE.match(cluster_pb.name)
-        if match is None:
-            raise ValueError('Cluster protobuf name was not in the '
-                             'expected format.', cluster_pb.name)
-        if match.group('project') != instance._client.project:
-            raise ValueError('Project ID on cluster does not match the '
-                             'project ID on the client')
-        if match.group('instance') != instance.instance_id:
-            raise ValueError('Instance ID on cluster does not match the '
-                             'instance ID on the client')
-
-        result = cls(match.group('cluster_id'), instance)
-        result._update_from_pb(cluster_pb)
-        return result
-
-    def copy(self):
-        """Make a copy of this cluster.
-
-        Copies the local data stored as simple types and copies the client
-        attached to this instance.
-
-        :rtype: :class:`.Cluster`
-        :returns: A copy of the current cluster.
-        """
-        new_instance = self._instance.copy()
-        return self.__class__(self.cluster_id, new_instance,
-                              serve_nodes=self.serve_nodes)
-
-    @property
-    def name(self):
-        """Cluster name used in requests.
-
-        .. note::
-          This property will not change if ``_instance`` and ``cluster_id``
-          do not, but the return value is not cached.
-
-        The cluster name is of the form
-
-            ``"projects/{project}/instances/{instance}/clusters/{cluster_id}"``
-
-        :rtype: str
-        :returns: The cluster name.
-        """
-        return self._instance.name + '/clusters/' + self.cluster_id
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        # NOTE: This does not compare the configuration values, such as
-        #       the serve_nodes. Instead, it only compares
-        #       identifying values instance, cluster ID and client. This is
-        #       intentional, since the same cluster can be in different states
-        #       if not synchronized. Clusters with similar instance/cluster
-        #       settings but different clients can't be used in the same way.
-        return (other.cluster_id == self.cluster_id and
-                other._instance == self._instance)
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-    def reload(self):
-        """Reload the metadata for this cluster."""
-        request_pb = messages_v2_pb2.GetClusterRequest(name=self.name)
-        # We expect a `._generated.instance_pb2.Cluster`.
-        cluster_pb = self._instance._client._instance_stub.GetCluster(
-            request_pb)
-
-        # NOTE: _update_from_pb does not check that the project, instance and
-        #       cluster ID on the response match the request.
-        self._update_from_pb(cluster_pb)
-
-    def create(self):
-        """Create this cluster.
-
-        .. note::
-
-            Uses the ``project``, ``instance`` and ``cluster_id`` on the
-            current :class:`Cluster` in addition to the ``serve_nodes``.
-            To change them before creating, reset the values via
-
-            .. code:: python
-
-                cluster.serve_nodes = 8
-                cluster.cluster_id = 'i-changed-my-mind'
-
-            before calling :meth:`create`.
-
-        :rtype: :class:`Operation`
-        :returns: The long-running operation corresponding to the
-                  create operation.
-        """
-        request_pb = _prepare_create_request(self)
-        # We expect a `google.longrunning.operations_pb2.Operation`.
-        client = self._instance._client
-        operation_pb = client._instance_stub.CreateCluster(request_pb)
-
-        operation = Operation.from_pb(operation_pb, client)
-        operation.target = self
-        operation.metadata['request_type'] = 'CreateCluster'
-        return operation
-
-    def update(self):
-        """Update this cluster.
-
-        .. note::
-
-            Updates the ``serve_nodes``. If you'd like to
-            change them before updating, reset the values via
-
-            .. code:: python
-
-                cluster.serve_nodes = 8
-
-            before calling :meth:`update`.
-
-        :rtype: :class:`Operation`
-        :returns: The long-running operation corresponding to the
-                  update operation.
-        """
-        request_pb = data_v2_pb2.Cluster(
-            name=self.name,
-            serve_nodes=self.serve_nodes,
-        )
-        # We expect a `google.longrunning.operations_pb2.Operation`.
-        client = self._instance._client
-        operation_pb = client._instance_stub.UpdateCluster(request_pb)
-
-        operation = Operation.from_pb(operation_pb, client)
-        operation.target = self
-        operation.metadata['request_type'] = 'UpdateCluster'
-        return operation
-
-    def delete(self):
-        """Delete this cluster.
-
-        Marks a cluster and all of its tables for permanent deletion in 7 days.
-
-        Immediately upon completion of the request:
-
-        * Billing will cease for all of the cluster's reserved resources.
-        * The cluster's ``delete_time`` field will be set 7 days in the future.
-
-        Soon afterward:
-
-        * All tables within the cluster will become unavailable.
-
-        At the cluster's ``delete_time``:
-
-        * The cluster and **all of its tables** will immediately and
-          irrevocably disappear from the API, and their data will be
-          permanently deleted.
-        """
-        request_pb = messages_v2_pb2.DeleteClusterRequest(name=self.name)
-        # We expect a `google.protobuf.empty_pb2.Empty`
-        self._instance._client._instance_stub.DeleteCluster(request_pb)
diff --git a/google/cloud/bigtable/column_family.py b/google/cloud/bigtable/column_family.py
deleted file mode 100644
index edc5499f3f12..000000000000
--- a/google/cloud/bigtable/column_family.py
+++ /dev/null
@@ -1,338 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""User friendly container for Google Cloud Bigtable Column Family."""
-
-
-import datetime
-
-from google.protobuf import duration_pb2
-
-from google.cloud.bigtable._generated import (
-    table_pb2 as table_v2_pb2)
-from google.cloud.bigtable._generated import (
-    bigtable_table_admin_pb2 as table_admin_v2_pb2)
-
-
-def _timedelta_to_duration_pb(timedelta_val):
-    """Convert a Python timedelta object to a duration protobuf.
-
-    .. note::
-
-        The Python timedelta has a granularity of microseconds while
-        the protobuf duration type has a duration of nanoseconds.
-
-    :type timedelta_val: :class:`datetime.timedelta`
-    :param timedelta_val: A timedelta object.
-
-    :rtype: :class:`google.protobuf.duration_pb2.Duration`
-    :returns: A duration object equivalent to the time delta.
-    """
-    seconds_decimal = timedelta_val.total_seconds()
-    # Truncate the parts other than the integer.
-    seconds = int(seconds_decimal)
-    if seconds_decimal < 0:
-        signed_micros = timedelta_val.microseconds - 10**6
-    else:
-        signed_micros = timedelta_val.microseconds
-    # Convert nanoseconds to microseconds.
-    nanos = 1000 * signed_micros
-    return duration_pb2.Duration(seconds=seconds, nanos=nanos)
-
-
-def _duration_pb_to_timedelta(duration_pb):
-    """Convert a duration protobuf to a Python timedelta object.
-
-    .. note::
-
-        The Python timedelta has a granularity of microseconds while
-        the protobuf duration type has a duration of nanoseconds.
-
-    :type duration_pb: :class:`google.protobuf.duration_pb2.Duration`
-    :param duration_pb: A protobuf duration object.
-
-    :rtype: :class:`datetime.timedelta`
-    :returns: The converted timedelta object.
-    """
-    return datetime.timedelta(
-        seconds=duration_pb.seconds,
-        microseconds=(duration_pb.nanos / 1000.0),
-    )
-
-
-class GarbageCollectionRule(object):
-    """Garbage collection rule for column families within a table.
-
-    Cells in the column family (within a table) fitting the rule will be
-    deleted during garbage collection.
-
-    .. note::
-
-        This class is a do-nothing base class for all GC rules.
-
-    .. note::
-
-        A string ``gc_expression`` can also be used with API requests, but
-        that value would be superceded by a ``gc_rule``. As a result, we
-        don't support that feature and instead support via native classes.
-    """
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-
-class MaxVersionsGCRule(GarbageCollectionRule):
-    """Garbage collection limiting the number of versions of a cell.
-
-    :type max_num_versions: int
-    :param max_num_versions: The maximum number of versions
-    """
-
-    def __init__(self, max_num_versions):
-        self.max_num_versions = max_num_versions
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return other.max_num_versions == self.max_num_versions
-
-    def to_pb(self):
-        """Converts the garbage collection rule to a protobuf.
-
-        :rtype: :class:`.table_v2_pb2.GcRule`
-        :returns: The converted current object.
-        """
-        return table_v2_pb2.GcRule(max_num_versions=self.max_num_versions)
-
-
-class MaxAgeGCRule(GarbageCollectionRule):
-    """Garbage collection limiting the age of a cell.
-
-    :type max_age: :class:`datetime.timedelta`
-    :param max_age: The maximum age allowed for a cell in the table.
-    """
-
-    def __init__(self, max_age):
-        self.max_age = max_age
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return other.max_age == self.max_age
-
-    def to_pb(self):
-        """Converts the garbage collection rule to a protobuf.
-
-        :rtype: :class:`.table_v2_pb2.GcRule`
-        :returns: The converted current object.
-        """
-        max_age = _timedelta_to_duration_pb(self.max_age)
-        return table_v2_pb2.GcRule(max_age=max_age)
-
-
-class GCRuleUnion(GarbageCollectionRule):
-    """Union of garbage collection rules.
-
-    :type rules: list
-    :param rules: List of :class:`GarbageCollectionRule`.
-    """
-
-    def __init__(self, rules):
-        self.rules = rules
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return other.rules == self.rules
-
-    def to_pb(self):
-        """Converts the union into a single GC rule as a protobuf.
-
-        :rtype: :class:`.table_v2_pb2.GcRule`
-        :returns: The converted current object.
-        """
-        union = table_v2_pb2.GcRule.Union(
-            rules=[rule.to_pb() for rule in self.rules])
-        return table_v2_pb2.GcRule(union=union)
-
-
-class GCRuleIntersection(GarbageCollectionRule):
-    """Intersection of garbage collection rules.
-
-    :type rules: list
-    :param rules: List of :class:`GarbageCollectionRule`.
-    """
-
-    def __init__(self, rules):
-        self.rules = rules
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return other.rules == self.rules
-
-    def to_pb(self):
-        """Converts the intersection into a single GC rule as a protobuf.
-
-        :rtype: :class:`.table_v2_pb2.GcRule`
-        :returns: The converted current object.
-        """
-        intersection = table_v2_pb2.GcRule.Intersection(
-            rules=[rule.to_pb() for rule in self.rules])
-        return table_v2_pb2.GcRule(intersection=intersection)
-
-
-class ColumnFamily(object):
-    """Representation of a Google Cloud Bigtable Column Family.
-
-    We can use a :class:`ColumnFamily` to:
-
-    * :meth:`create` itself
-    * :meth:`update` itself
-    * :meth:`delete` itself
-
-    :type column_family_id: str
-    :param column_family_id: The ID of the column family. Must be of the
-                             form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
-
-    :type table: :class:`Table <google.cloud.bigtable.table.Table>`
-    :param table: The table that owns the column family.
-
-    :type gc_rule: :class:`GarbageCollectionRule`
-    :param gc_rule: (Optional) The garbage collection settings for this
-                    column family.
-    """
-
-    def __init__(self, column_family_id, table, gc_rule=None):
-        self.column_family_id = column_family_id
-        self._table = table
-        self.gc_rule = gc_rule
-
-    @property
-    def name(self):
-        """Column family name used in requests.
-
-        .. note::
-
-          This property will not change if ``column_family_id`` does not, but
-          the return value is not cached.
-
-        The table name is of the form
-
-            ``"projects/../zones/../clusters/../tables/../columnFamilies/.."``
-
-        :rtype: str
-        :returns: The column family name.
-        """
-        return self._table.name + '/columnFamilies/' + self.column_family_id
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return (other.column_family_id == self.column_family_id and
-                other._table == self._table and
-                other.gc_rule == self.gc_rule)
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-    def to_pb(self):
-        """Converts the column family to a protobuf.
-
-        :rtype: :class:`.table_v2_pb2.ColumnFamily`
-        :returns: The converted current object.
-        """
-        if self.gc_rule is None:
-            return table_v2_pb2.ColumnFamily()
-        else:
-            return table_v2_pb2.ColumnFamily(gc_rule=self.gc_rule.to_pb())
-
-    def create(self):
-        """Create this column family."""
-        column_family = self.to_pb()
-        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(
-            name=self._table.name)
-        request_pb.modifications.add(
-            id=self.column_family_id,
-            create=column_family,
-        )
-        client = self._table._instance._client
-        # We expect a `.table_v2_pb2.ColumnFamily`. We ignore it since the only
-        # data it contains are the GC rule and the column family ID already
-        # stored on this instance.
-        client._table_stub.ModifyColumnFamilies(request_pb)
-
-    def update(self):
-        """Update this column family.
-
-        .. note::
-
-            Only the GC rule can be updated. By changing the column family ID,
-            you will simply be referring to a different column family.
-        """
-        column_family = self.to_pb()
-        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(
-            name=self._table.name)
-        request_pb.modifications.add(
-            id=self.column_family_id,
-            update=column_family)
-        client = self._table._instance._client
-        # We expect a `.table_v2_pb2.ColumnFamily`. We ignore it since the only
-        # data it contains are the GC rule and the column family ID already
-        # stored on this instance.
-        client._table_stub.ModifyColumnFamilies(request_pb)
-
-    def delete(self):
-        """Delete this column family."""
-        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(
-            name=self._table.name)
-        request_pb.modifications.add(
-            id=self.column_family_id,
-            drop=True)
-        client = self._table._instance._client
-        # We expect a `google.protobuf.empty_pb2.Empty`
-        client._table_stub.ModifyColumnFamilies(request_pb)
-
-
-def _gc_rule_from_pb(gc_rule_pb):
-    """Convert a protobuf GC rule to a native object.
-
-    :type gc_rule_pb: :class:`.table_v2_pb2.GcRule`
-    :param gc_rule_pb: The GC rule to convert.
-
-    :rtype: :class:`GarbageCollectionRule` or :data:`NoneType <types.NoneType>`
-    :returns: An instance of one of the native rules defined
-              in :module:`column_family` or :data:`None` if no values were
-              set on the protobuf passed in.
-    :raises: :class:`ValueError <exceptions.ValueError>` if the rule name
-             is unexpected.
-    """
-    rule_name = gc_rule_pb.WhichOneof('rule')
-    if rule_name is None:
-        return None
-
-    if rule_name == 'max_num_versions':
-        return MaxVersionsGCRule(gc_rule_pb.max_num_versions)
-    elif rule_name == 'max_age':
-        max_age = _duration_pb_to_timedelta(gc_rule_pb.max_age)
-        return MaxAgeGCRule(max_age)
-    elif rule_name == 'union':
-        return GCRuleUnion([_gc_rule_from_pb(rule)
-                            for rule in gc_rule_pb.union.rules])
-    elif rule_name == 'intersection':
-        rules = [_gc_rule_from_pb(rule)
-                 for rule in gc_rule_pb.intersection.rules]
-        return GCRuleIntersection(rules)
-    else:
-        raise ValueError('Unexpected rule name', rule_name)
diff --git a/google/cloud/bigtable/instance.py b/google/cloud/bigtable/instance.py
deleted file mode 100644
index ad7e5ef99c23..000000000000
--- a/google/cloud/bigtable/instance.py
+++ /dev/null
@@ -1,356 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""User friendly container for Google Cloud Bigtable Instance."""
-
-
-import re
-
-from google.cloud.bigtable._generated import (
-    instance_pb2 as data_v2_pb2)
-from google.cloud.bigtable._generated import (
-    bigtable_instance_admin_pb2 as messages_v2_pb2)
-from google.cloud.bigtable._generated import (
-    bigtable_table_admin_pb2 as table_messages_v2_pb2)
-from google.cloud.bigtable.cluster import Cluster
-from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-from google.cloud.bigtable.table import Table
-from google.cloud.operation import Operation
-from google.cloud.operation import _compute_type_url
-from google.cloud.operation import _register_type_url
-
-
-_EXISTING_INSTANCE_LOCATION_ID = 'see-existing-cluster'
-_INSTANCE_NAME_RE = re.compile(r'^projects/(?P<project>[^/]+)/'
-                               r'instances/(?P<instance_id>[a-z][-a-z0-9]*)$')
-
-
-_CREATE_INSTANCE_METADATA_URL = _compute_type_url(
-    messages_v2_pb2.CreateInstanceMetadata)
-_register_type_url(
-    _CREATE_INSTANCE_METADATA_URL, messages_v2_pb2.CreateInstanceMetadata)
-
-
-def _prepare_create_request(instance):
-    """Creates a protobuf request for a CreateInstance request.
-
-    :type instance: :class:`Instance`
-    :param instance: The instance to be created.
-
-    :rtype: :class:`.messages_v2_pb2.CreateInstanceRequest`
-    :returns: The CreateInstance request object containing the instance info.
-    """
-    parent_name = ('projects/' + instance._client.project)
-    message = messages_v2_pb2.CreateInstanceRequest(
-        parent=parent_name,
-        instance_id=instance.instance_id,
-        instance=data_v2_pb2.Instance(
-            display_name=instance.display_name,
-        ),
-    )
-    cluster = message.clusters[instance.instance_id]
-    cluster.name = instance.name + '/clusters/' + instance.instance_id
-    cluster.location = (
-        parent_name + '/locations/' + instance._cluster_location_id)
-    cluster.serve_nodes = instance._cluster_serve_nodes
-    return message
-
-
-class Instance(object):
-    """Representation of a Google Cloud Bigtable Instance.
-
-    We can use a :class:`Instance` to:
-
-    * :meth:`reload` itself
-    * :meth:`create` itself
-    * :meth:`update` itself
-    * :meth:`delete` itself
-
-    .. note::
-
-        For now, we leave out the ``default_storage_type`` (an enum)
-        which if not sent will end up as :data:`.data_v2_pb2.STORAGE_SSD`.
-
-    :type instance_id: str
-    :param instance_id: The ID of the instance.
-
-    :type client: :class:`Client <google.cloud.bigtable.client.Client>`
-    :param client: The client that owns the instance. Provides
-                   authorization and a project ID.
-
-    :type location_id: str
-    :param location_id: ID of the location in which the instance will be
-                        created.  Required for instances which do not yet
-                        exist.
-
-    :type display_name: str
-    :param display_name: (Optional) The display name for the instance in the
-                         Cloud Console UI. (Must be between 4 and 30
-                         characters.) If this value is not set in the
-                         constructor, will fall back to the instance ID.
-
-    :type serve_nodes: int
-    :param serve_nodes: (Optional) The number of nodes in the instance's
-                        cluster; used to set up the instance's cluster.
-    """
-
-    def __init__(self, instance_id, client,
-                 location_id=_EXISTING_INSTANCE_LOCATION_ID,
-                 display_name=None,
-                 serve_nodes=DEFAULT_SERVE_NODES):
-        self.instance_id = instance_id
-        self.display_name = display_name or instance_id
-        self._cluster_location_id = location_id
-        self._cluster_serve_nodes = serve_nodes
-        self._client = client
-
-    def _update_from_pb(self, instance_pb):
-        """Refresh self from the server-provided protobuf.
-
-        Helper for :meth:`from_pb` and :meth:`reload`.
-        """
-        if not instance_pb.display_name:  # Simple field (string)
-            raise ValueError('Instance protobuf does not contain display_name')
-        self.display_name = instance_pb.display_name
-
-    @classmethod
-    def from_pb(cls, instance_pb, client):
-        """Creates a instance instance from a protobuf.
-
-        :type instance_pb: :class:`instance_pb2.Instance`
-        :param instance_pb: A instance protobuf object.
-
-        :type client: :class:`Client <google.cloud.bigtable.client.Client>`
-        :param client: The client that owns the instance.
-
-        :rtype: :class:`Instance`
-        :returns: The instance parsed from the protobuf response.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the instance
-                 name does not match
-                 ``projects/{project}/instances/{instance_id}``
-                 or if the parsed project ID does not match the project ID
-                 on the client.
-        """
-        match = _INSTANCE_NAME_RE.match(instance_pb.name)
-        if match is None:
-            raise ValueError('Instance protobuf name was not in the '
-                             'expected format.', instance_pb.name)
-        if match.group('project') != client.project:
-            raise ValueError('Project ID on instance does not match the '
-                             'project ID on the client')
-        instance_id = match.group('instance_id')
-
-        result = cls(instance_id, client, _EXISTING_INSTANCE_LOCATION_ID)
-        result._update_from_pb(instance_pb)
-        return result
-
-    def copy(self):
-        """Make a copy of this instance.
-
-        Copies the local data stored as simple types and copies the client
-        attached to this instance.
-
-        :rtype: :class:`.Instance`
-        :returns: A copy of the current instance.
-        """
-        new_client = self._client.copy()
-        return self.__class__(self.instance_id, new_client,
-                              self._cluster_location_id,
-                              display_name=self.display_name)
-
-    @property
-    def name(self):
-        """Instance name used in requests.
-
-        .. note::
-          This property will not change if ``instance_id`` does not,
-          but the return value is not cached.
-
-        The instance name is of the form
-
-            ``"projects/{project}/instances/{instance_id}"``
-
-        :rtype: str
-        :returns: The instance name.
-        """
-        return self._client.project_name + '/instances/' + self.instance_id
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        # NOTE: This does not compare the configuration values, such as
-        #       the display_name. Instead, it only compares
-        #       identifying values instance ID and client. This is
-        #       intentional, since the same instance can be in different states
-        #       if not synchronized. Instances with similar instance
-        #       settings but different clients can't be used in the same way.
-        return (other.instance_id == self.instance_id and
-                other._client == self._client)
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-    def reload(self):
-        """Reload the metadata for this instance."""
-        request_pb = messages_v2_pb2.GetInstanceRequest(name=self.name)
-        # We expect `data_v2_pb2.Instance`.
-        instance_pb = self._client._instance_stub.GetInstance(request_pb)
-
-        # NOTE: _update_from_pb does not check that the project and
-        #       instance ID on the response match the request.
-        self._update_from_pb(instance_pb)
-
-    def create(self):
-        """Create this instance.
-
-        .. note::
-
-            Uses the ``project`` and ``instance_id`` on the current
-            :class:`Instance` in addition to the ``display_name``.
-            To change them before creating, reset the values via
-
-            .. code:: python
-
-                instance.display_name = 'New display name'
-                instance.instance_id = 'i-changed-my-mind'
-
-            before calling :meth:`create`.
-
-        :rtype: :class:`Operation`
-        :returns: The long-running operation corresponding to the
-                  create operation.
-        """
-        request_pb = _prepare_create_request(self)
-        # We expect a `google.longrunning.operations_pb2.Operation`.
-        operation_pb = self._client._instance_stub.CreateInstance(request_pb)
-
-        operation = Operation.from_pb(operation_pb, self._client)
-        operation.target = self
-        operation.metadata['request_type'] = 'CreateInstance'
-        return operation
-
-    def update(self):
-        """Update this instance.
-
-        .. note::
-
-            Updates the ``display_name``. To change that value before
-            updating, reset its values via
-
-            .. code:: python
-
-                instance.display_name = 'New display name'
-
-            before calling :meth:`update`.
-        """
-        request_pb = data_v2_pb2.Instance(
-            name=self.name,
-            display_name=self.display_name,
-        )
-        # Ignore the expected `data_v2_pb2.Instance`.
-        self._client._instance_stub.UpdateInstance(request_pb)
-
-    def delete(self):
-        """Delete this instance.
-
-        Marks a instance and all of its tables for permanent deletion
-        in 7 days.
-
-        Immediately upon completion of the request:
-
-        * Billing will cease for all of the instance's reserved resources.
-        * The instance's ``delete_time`` field will be set 7 days in
-          the future.
-
-        Soon afterward:
-
-        * All tables within the instance will become unavailable.
-
-        At the instance's ``delete_time``:
-
-        * The instance and **all of its tables** will immediately and
-          irrevocably disappear from the API, and their data will be
-          permanently deleted.
-        """
-        request_pb = messages_v2_pb2.DeleteInstanceRequest(name=self.name)
-        # We expect a `google.protobuf.empty_pb2.Empty`
-        self._client._instance_stub.DeleteInstance(request_pb)
-
-    def cluster(self, cluster_id, serve_nodes=3):
-        """Factory to create a cluster associated with this client.
-
-        :type cluster_id: str
-        :param cluster_id: The ID of the cluster.
-
-        :type serve_nodes: int
-        :param serve_nodes: (Optional) The number of nodes in the cluster.
-                            Defaults to 3.
-
-        :rtype: :class:`.Cluster`
-        :returns: The cluster owned by this client.
-        """
-        return Cluster(cluster_id, self, serve_nodes=serve_nodes)
-
-    def list_clusters(self):
-        """Lists clusters in this instance.
-
-        :rtype: tuple
-        :returns: A pair of results, the first is a list of :class:`.Cluster` s
-                  returned and the second is a list of strings (the failed
-                  locations in the request).
-        """
-        request_pb = messages_v2_pb2.ListClustersRequest(parent=self.name)
-        # We expect a `.cluster_messages_v1_pb2.ListClustersResponse`
-        list_clusters_response = self._client._instance_stub.ListClusters(
-            request_pb)
-
-        failed_locations = [
-            location for location in list_clusters_response.failed_locations]
-        clusters = [Cluster.from_pb(cluster_pb, self)
-                    for cluster_pb in list_clusters_response.clusters]
-        return clusters, failed_locations
-
-    def table(self, table_id):
-        """Factory to create a table associated with this instance.
-
-        :type table_id: str
-        :param table_id: The ID of the table.
-
-        :rtype: :class:`Table <google.cloud.bigtable.table.Table>`
-        :returns: The table owned by this instance.
-        """
-        return Table(table_id, self)
-
-    def list_tables(self):
-        """List the tables in this instance.
-
-        :rtype: list of :class:`Table <google.cloud.bigtable.table.Table>`
-        :returns: The list of tables owned by the instance.
-        :raises: :class:`ValueError <exceptions.ValueError>` if one of the
-                 returned tables has a name that is not of the expected format.
-        """
-        request_pb = table_messages_v2_pb2.ListTablesRequest(parent=self.name)
-        # We expect a `table_messages_v2_pb2.ListTablesResponse`
-        table_list_pb = self._client._table_stub.ListTables(request_pb)
-
-        result = []
-        for table_pb in table_list_pb.tables:
-            table_prefix = self.name + '/tables/'
-            if not table_pb.name.startswith(table_prefix):
-                raise ValueError('Table name %s not of expected format' % (
-                    table_pb.name,))
-            table_id = table_pb.name[len(table_prefix):]
-            result.append(self.table(table_id))
-
-        return result
diff --git a/google/cloud/bigtable/row_data.py b/google/cloud/bigtable/row_data.py
deleted file mode 100644
index 91d457319973..000000000000
--- a/google/cloud/bigtable/row_data.py
+++ /dev/null
@@ -1,441 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Container for Google Cloud Bigtable Cells and Streaming Row Contents."""
-
-
-import copy
-import six
-
-from google.cloud._helpers import _datetime_from_microseconds
-from google.cloud._helpers import _to_bytes
-
-
-class Cell(object):
-    """Representation of a Google Cloud Bigtable Cell.
-
-    :type value: bytes
-    :param value: The value stored in the cell.
-
-    :type timestamp: :class:`datetime.datetime`
-    :param timestamp: The timestamp when the cell was stored.
-
-    :type labels: list
-    :param labels: (Optional) List of strings. Labels applied to the cell.
-    """
-
-    def __init__(self, value, timestamp, labels=()):
-        self.value = value
-        self.timestamp = timestamp
-        self.labels = list(labels)
-
-    @classmethod
-    def from_pb(cls, cell_pb):
-        """Create a new cell from a Cell protobuf.
-
-        :type cell_pb: :class:`._generated.data_pb2.Cell`
-        :param cell_pb: The protobuf to convert.
-
-        :rtype: :class:`Cell`
-        :returns: The cell corresponding to the protobuf.
-        """
-        timestamp = _datetime_from_microseconds(cell_pb.timestamp_micros)
-        if cell_pb.labels:
-            return cls(cell_pb.value, timestamp, labels=cell_pb.labels)
-        else:
-            return cls(cell_pb.value, timestamp)
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return (other.value == self.value and
-                other.timestamp == self.timestamp and
-                other.labels == self.labels)
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-
-class PartialCellData(object):
-    """Representation of partial cell in a Google Cloud Bigtable Table.
-
-    These are expected to be updated directly from a
-    :class:`._generated.bigtable_service_messages_pb2.ReadRowsResponse`
-
-    :type row_key: bytes
-    :param row_key: The key for the row holding the (partial) cell.
-
-    :type family_name: str
-    :param family_name: The family name of the (partial) cell.
-
-    :type qualifier: bytes
-    :param qualifier: The column qualifier of the (partial) cell.
-
-    :type timestamp_micros: int
-    :param timestamp_micros: The timestamp (in microsecods) of the
-                             (partial) cell.
-
-    :type labels: list of str
-    :param labels: labels assigned to the (partial) cell
-
-    :type value: bytes
-    :param value: The (accumulated) value of the (partial) cell.
-    """
-    def __init__(self, row_key, family_name, qualifier, timestamp_micros,
-                 labels=(), value=b''):
-        self.row_key = row_key
-        self.family_name = family_name
-        self.qualifier = qualifier
-        self.timestamp_micros = timestamp_micros
-        self.labels = labels
-        self.value = value
-
-    def append_value(self, value):
-        """Append bytes from a new chunk to value.
-
-        :type value: bytes
-        :param value: bytes to append
-        """
-        self.value += value
-
-
-class PartialRowData(object):
-    """Representation of partial row in a Google Cloud Bigtable Table.
-
-    These are expected to be updated directly from a
-    :class:`._generated.bigtable_service_messages_pb2.ReadRowsResponse`
-
-    :type row_key: bytes
-    :param row_key: The key for the row holding the (partial) data.
-    """
-
-    def __init__(self, row_key):
-        self._row_key = row_key
-        self._cells = {}
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return (other._row_key == self._row_key and
-                other._cells == self._cells)
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-    def to_dict(self):
-        """Convert the cells to a dictionary.
-
-        This is intended to be used with HappyBase, so the column family and
-        column qualiers are combined (with ``:``).
-
-        :rtype: dict
-        :returns: Dictionary containing all the data in the cells of this row.
-        """
-        result = {}
-        for column_family_id, columns in six.iteritems(self._cells):
-            for column_qual, cells in six.iteritems(columns):
-                key = (_to_bytes(column_family_id) + b':' +
-                       _to_bytes(column_qual))
-                result[key] = cells
-        return result
-
-    @property
-    def cells(self):
-        """Property returning all the cells accumulated on this partial row.
-
-        :rtype: dict
-        :returns: Dictionary of the :class:`Cell` objects accumulated. This
-                  dictionary has two-levels of keys (first for column families
-                  and second for column names/qualifiers within a family). For
-                  a given column, a list of :class:`Cell` objects is stored.
-        """
-        return copy.deepcopy(self._cells)
-
-    @property
-    def row_key(self):
-        """Getter for the current (partial) row's key.
-
-        :rtype: bytes
-        :returns: The current (partial) row's key.
-        """
-        return self._row_key
-
-
-class InvalidReadRowsResponse(RuntimeError):
-    """Exception raised to to invalid response data from back-end."""
-
-
-class InvalidChunk(RuntimeError):
-    """Exception raised to to invalid chunk data from back-end."""
-
-
-class PartialRowsData(object):
-    """Convenience wrapper for consuming a ``ReadRows`` streaming response.
-
-    :type response_iterator: :class:`~google.cloud.exceptions.GrpcRendezvous`
-    :param response_iterator: A streaming iterator returned from a
-                              ``ReadRows`` request.
-    """
-    START = "Start"                         # No responses yet processed.
-    NEW_ROW = "New row"                     # No cells yet complete for row
-    ROW_IN_PROGRESS = "Row in progress"     # Some cells complete for row
-    CELL_IN_PROGRESS = "Cell in progress"   # Incomplete cell for row
-
-    def __init__(self, response_iterator):
-        self._response_iterator = response_iterator
-        # Fully-processed rows, keyed by `row_key`
-        self._rows = {}
-        # Counter for responses pulled from iterator
-        self._counter = 0
-        # Maybe cached from previous response
-        self._last_scanned_row_key = None
-        # In-progress row, unset until first response, after commit/reset
-        self._row = None
-        # Last complete row, unset until first commit
-        self._previous_row = None
-        # In-progress cell, unset until first response, after completion
-        self._cell = None
-        # Last complete cell, unset until first completion, after new row
-        self._previous_cell = None
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return other._response_iterator == self._response_iterator
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-    @property
-    def state(self):
-        """State machine state.
-
-        :rtype: str
-        :returns:  name of state corresponding to currrent row / chunk
-                   processing.
-        """
-        if self._last_scanned_row_key is None:
-            return self.START
-        if self._row is None:
-            assert self._cell is None
-            assert self._previous_cell is None
-            return self.NEW_ROW
-        if self._cell is not None:
-            return self.CELL_IN_PROGRESS
-        if self._previous_cell is not None:
-            return self.ROW_IN_PROGRESS
-        return self.NEW_ROW  # row added, no chunk yet processed
-
-    @property
-    def rows(self):
-        """Property returning all rows accumulated from the stream.
-
-        :rtype: dict
-        :returns: row_key -> :class:`PartialRowData`.
-        """
-        # NOTE: To avoid duplicating large objects, this is just the
-        #       mutable private data.
-        return self._rows
-
-    def cancel(self):
-        """Cancels the iterator, closing the stream."""
-        self._response_iterator.cancel()
-
-    def consume_next(self):
-        """Consume the next ``ReadRowsResponse`` from the stream.
-
-        Parse the response and its chunks into a new/existing row in
-        :attr:`_rows`
-        """
-        response = six.next(self._response_iterator)
-        self._counter += 1
-
-        if self._last_scanned_row_key is None:  # first response
-            if response.last_scanned_row_key:
-                raise InvalidReadRowsResponse()
-
-        self._last_scanned_row_key = response.last_scanned_row_key
-
-        row = self._row
-        cell = self._cell
-
-        for chunk in response.chunks:
-
-            self._validate_chunk(chunk)
-
-            if chunk.reset_row:
-                row = self._row = None
-                cell = self._cell = self._previous_cell = None
-                continue
-
-            if row is None:
-                row = self._row = PartialRowData(chunk.row_key)
-
-            if cell is None:
-                cell = self._cell = PartialCellData(
-                    chunk.row_key,
-                    chunk.family_name.value,
-                    chunk.qualifier.value,
-                    chunk.timestamp_micros,
-                    chunk.labels,
-                    chunk.value)
-                self._copy_from_previous(cell)
-            else:
-                cell.append_value(chunk.value)
-
-            if chunk.commit_row:
-                self._save_current_row()
-                row = cell = None
-                continue
-
-            if chunk.value_size == 0:
-                self._save_current_cell()
-                cell = None
-
-    def consume_all(self, max_loops=None):
-        """Consume the streamed responses until there are no more.
-
-        This simply calls :meth:`consume_next` until there are no
-        more to consume.
-
-        :type max_loops: int
-        :param max_loops: (Optional) Maximum number of times to try to consume
-                          an additional ``ReadRowsResponse``. You can use this
-                          to avoid long wait times.
-        """
-        curr_loop = 0
-        if max_loops is None:
-            max_loops = float('inf')
-        while curr_loop < max_loops:
-            curr_loop += 1
-            try:
-                self.consume_next()
-            except StopIteration:
-                break
-
-    @staticmethod
-    def _validate_chunk_status(chunk):
-        """Helper for :meth:`_validate_chunk_row_in_progress`, etc."""
-        # No reseet with other keys
-        if chunk.reset_row:
-            _raise_if(chunk.row_key)
-            _raise_if(chunk.HasField('family_name'))
-            _raise_if(chunk.HasField('qualifier'))
-            _raise_if(chunk.timestamp_micros)
-            _raise_if(chunk.labels)
-            _raise_if(chunk.value_size)
-            _raise_if(chunk.value)
-        # No commit with value size
-        _raise_if(chunk.commit_row and chunk.value_size > 0)
-        # No negative value_size (inferred as a general constraint).
-        _raise_if(chunk.value_size < 0)
-
-    def _validate_chunk_new_row(self, chunk):
-        """Helper for :meth:`_validate_chunk`."""
-        assert self.state == self.NEW_ROW
-        _raise_if(chunk.reset_row)
-        _raise_if(not chunk.row_key)
-        _raise_if(not chunk.family_name)
-        _raise_if(not chunk.qualifier)
-        # This constraint is not enforced in the Go example.
-        _raise_if(chunk.value_size > 0 and chunk.commit_row is not False)
-        # This constraint is from the Go example, not the spec.
-        _raise_if(self._previous_row is not None and
-                  chunk.row_key <= self._previous_row.row_key)
-
-    def _same_as_previous(self, chunk):
-        """Helper for :meth:`_validate_chunk_row_in_progress`"""
-        previous = self._previous_cell
-        return (chunk.row_key == previous.row_key and
-                chunk.family_name == previous.family_name and
-                chunk.qualifier == previous.qualifier and
-                chunk.labels == previous.labels)
-
-    def _validate_chunk_row_in_progress(self, chunk):
-        """Helper for :meth:`_validate_chunk`"""
-        assert self.state == self.ROW_IN_PROGRESS
-        self._validate_chunk_status(chunk)
-        if not chunk.HasField('commit_row') and not chunk.reset_row:
-            _raise_if(not chunk.timestamp_micros or not chunk.value)
-        _raise_if(chunk.row_key and
-                  chunk.row_key != self._row.row_key)
-        _raise_if(chunk.HasField('family_name') and
-                  not chunk.HasField('qualifier'))
-        previous = self._previous_cell
-        _raise_if(self._same_as_previous(chunk) and
-                  chunk.timestamp_micros <= previous.timestamp_micros)
-
-    def _validate_chunk_cell_in_progress(self, chunk):
-        """Helper for :meth:`_validate_chunk`"""
-        assert self.state == self.CELL_IN_PROGRESS
-        self._validate_chunk_status(chunk)
-        self._copy_from_current(chunk)
-
-    def _validate_chunk(self, chunk):
-        """Helper for :meth:`consume_next`."""
-        if self.state == self.NEW_ROW:
-            self._validate_chunk_new_row(chunk)
-        if self.state == self.ROW_IN_PROGRESS:
-            self._validate_chunk_row_in_progress(chunk)
-        if self.state == self.CELL_IN_PROGRESS:
-            self._validate_chunk_cell_in_progress(chunk)
-
-    def _save_current_cell(self):
-        """Helper for :meth:`consume_next`."""
-        row, cell = self._row, self._cell
-        family = row._cells.setdefault(cell.family_name, {})
-        qualified = family.setdefault(cell.qualifier, [])
-        complete = Cell.from_pb(self._cell)
-        qualified.append(complete)
-        self._cell, self._previous_cell = None, cell
-
-    def _copy_from_current(self, chunk):
-        """Helper for :meth:`consume_next`."""
-        current = self._cell
-        if current is not None:
-            if not chunk.row_key:
-                chunk.row_key = current.row_key
-            if not chunk.HasField('family_name'):
-                chunk.family_name.value = current.family_name
-            if not chunk.HasField('qualifier'):
-                chunk.qualifier.value = current.qualifier
-            if not chunk.timestamp_micros:
-                chunk.timestamp_micros = current.timestamp_micros
-            if not chunk.labels:
-                chunk.labels.extend(current.labels)
-
-    def _copy_from_previous(self, cell):
-        """Helper for :meth:`consume_next`."""
-        previous = self._previous_cell
-        if previous is not None:
-            if not cell.row_key:
-                cell.row_key = previous.row_key
-            if not cell.family_name:
-                cell.family_name = previous.family_name
-            if not cell.qualifier:
-                cell.qualifier = previous.qualifier
-
-    def _save_current_row(self):
-        """Helper for :meth:`consume_next`."""
-        if self._cell:
-            self._save_current_cell()
-        self._rows[self._row.row_key] = self._row
-        self._row, self._previous_row = None, self._row
-        self._previous_cell = None
-
-
-def _raise_if(predicate, *args):
-    """Helper for validation methods."""
-    if predicate:
-        raise InvalidChunk(*args)
diff --git a/google/cloud/bigtable/table.py b/google/cloud/bigtable/table.py
deleted file mode 100644
index 6e3ac7eef370..000000000000
--- a/google/cloud/bigtable/table.py
+++ /dev/null
@@ -1,375 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""User friendly container for Google Cloud Bigtable Table."""
-
-from google.cloud._helpers import _to_bytes
-from google.cloud.bigtable._generated import (
-    bigtable_pb2 as data_messages_v2_pb2)
-from google.cloud.bigtable._generated import (
-    bigtable_table_admin_pb2 as table_admin_messages_v2_pb2)
-from google.cloud.bigtable._generated import (
-    table_pb2 as table_v2_pb2)
-from google.cloud.bigtable.column_family import _gc_rule_from_pb
-from google.cloud.bigtable.column_family import ColumnFamily
-from google.cloud.bigtable.row import AppendRow
-from google.cloud.bigtable.row import ConditionalRow
-from google.cloud.bigtable.row import DirectRow
-from google.cloud.bigtable.row_data import PartialRowsData
-
-
-class Table(object):
-    """Representation of a Google Cloud Bigtable Table.
-
-    .. note::
-
-        We don't define any properties on a table other than the name.
-        The only other fields are ``column_families`` and ``granularity``,
-        The ``column_families`` are not stored locally and
-        ``granularity`` is an enum with only one value.
-
-    We can use a :class:`Table` to:
-
-    * :meth:`create` the table
-    * :meth:`rename` the table
-    * :meth:`delete` the table
-    * :meth:`list_column_families` in the table
-
-    :type table_id: str
-    :param table_id: The ID of the table.
-
-    :type instance: :class:`Instance <.instance.Instance>`
-    :param instance: The instance that owns the table.
-    """
-
-    def __init__(self, table_id, instance):
-        self.table_id = table_id
-        self._instance = instance
-
-    @property
-    def name(self):
-        """Table name used in requests.
-
-        .. note::
-
-          This property will not change if ``table_id`` does not, but the
-          return value is not cached.
-
-        The table name is of the form
-
-            ``"projects/../instances/../tables/{table_id}"``
-
-        :rtype: str
-        :returns: The table name.
-        """
-        return self._instance.name + '/tables/' + self.table_id
-
-    def column_family(self, column_family_id, gc_rule=None):
-        """Factory to create a column family associated with this table.
-
-        :type column_family_id: str
-        :param column_family_id: The ID of the column family. Must be of the
-                                 form ``[_a-zA-Z0-9][-_.a-zA-Z0-9]*``.
-
-        :type gc_rule: :class:`.GarbageCollectionRule`
-        :param gc_rule: (Optional) The garbage collection settings for this
-                        column family.
-
-        :rtype: :class:`.ColumnFamily`
-        :returns: A column family owned by this table.
-        """
-        return ColumnFamily(column_family_id, self, gc_rule=gc_rule)
-
-    def row(self, row_key, filter_=None, append=False):
-        """Factory to create a row associated with this table.
-
-        .. warning::
-
-           At most one of ``filter_`` and ``append`` can be used in a
-           :class:`Row`.
-
-        :type row_key: bytes
-        :param row_key: The key for the row being created.
-
-        :type filter_: :class:`.RowFilter`
-        :param filter_: (Optional) Filter to be used for conditional mutations.
-                        See :class:`.DirectRow` for more details.
-
-        :type append: bool
-        :param append: (Optional) Flag to determine if the row should be used
-                       for append mutations.
-
-        :rtype: :class:`.DirectRow`
-        :returns: A row owned by this table.
-        :raises: :class:`ValueError <exceptions.ValueError>` if both
-                 ``filter_`` and ``append`` are used.
-        """
-        if append and filter_ is not None:
-            raise ValueError('At most one of filter_ and append can be set')
-        if append:
-            return AppendRow(row_key, self)
-        elif filter_ is not None:
-            return ConditionalRow(row_key, self, filter_=filter_)
-        else:
-            return DirectRow(row_key, self)
-
-    def __eq__(self, other):
-        if not isinstance(other, self.__class__):
-            return False
-        return (other.table_id == self.table_id and
-                other._instance == self._instance)
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-    def create(self, initial_split_keys=None, column_families=()):
-        """Creates this table.
-
-        .. note::
-
-            A create request returns a
-            :class:`._generated.table_pb2.Table` but we don't use
-            this response.
-
-        :type initial_split_keys: list
-        :param initial_split_keys: (Optional) List of row keys that will be
-                                   used to initially split the table into
-                                   several tablets (Tablets are similar to
-                                   HBase regions). Given two split keys,
-                                   ``"s1"`` and ``"s2"``, three tablets will be
-                                   created, spanning the key ranges:
-                                   ``[, s1)``, ``[s1, s2)``, ``[s2, )``.
-
-        :type column_families: list
-        :param column_families: (Optional) List or other iterable of
-                                :class:`.ColumnFamily` instances.
-        """
-        if initial_split_keys is not None:
-            split_pb = table_admin_messages_v2_pb2.CreateTableRequest.Split
-            initial_split_keys = [
-                split_pb(key=key) for key in initial_split_keys]
-
-        table_pb = None
-        if column_families:
-            table_pb = table_v2_pb2.Table()
-            for col_fam in column_families:
-                curr_id = col_fam.column_family_id
-                table_pb.column_families[curr_id].MergeFrom(col_fam.to_pb())
-
-        request_pb = table_admin_messages_v2_pb2.CreateTableRequest(
-            initial_splits=initial_split_keys or [],
-            parent=self._instance.name,
-            table_id=self.table_id,
-            table=table_pb,
-        )
-        client = self._instance._client
-        # We expect a `._generated.table_pb2.Table`
-        client._table_stub.CreateTable(request_pb)
-
-    def delete(self):
-        """Delete this table."""
-        request_pb = table_admin_messages_v2_pb2.DeleteTableRequest(
-            name=self.name)
-        client = self._instance._client
-        # We expect a `google.protobuf.empty_pb2.Empty`
-        client._table_stub.DeleteTable(request_pb)
-
-    def list_column_families(self):
-        """List the column families owned by this table.
-
-        :rtype: dict
-        :returns: Dictionary of column families attached to this table. Keys
-                  are strings (column family names) and values are
-                  :class:`.ColumnFamily` instances.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the column
-                 family name from the response does not agree with the computed
-                 name from the column family ID.
-        """
-        request_pb = table_admin_messages_v2_pb2.GetTableRequest(
-            name=self.name)
-        client = self._instance._client
-        # We expect a `._generated.table_pb2.Table`
-        table_pb = client._table_stub.GetTable(request_pb)
-
-        result = {}
-        for column_family_id, value_pb in table_pb.column_families.items():
-            gc_rule = _gc_rule_from_pb(value_pb.gc_rule)
-            column_family = self.column_family(column_family_id,
-                                               gc_rule=gc_rule)
-            result[column_family_id] = column_family
-        return result
-
-    def read_row(self, row_key, filter_=None):
-        """Read a single row from this table.
-
-        :type row_key: bytes
-        :param row_key: The key of the row to read from.
-
-        :type filter_: :class:`.RowFilter`
-        :param filter_: (Optional) The filter to apply to the contents of the
-                        row. If unset, returns the entire row.
-
-        :rtype: :class:`.PartialRowData`, :data:`NoneType <types.NoneType>`
-        :returns: The contents of the row if any chunks were returned in
-                  the response, otherwise :data:`None`.
-        :raises: :class:`ValueError <exceptions.ValueError>` if a commit row
-                 chunk is never encountered.
-        """
-        request_pb = _create_row_request(self.name, row_key=row_key,
-                                         filter_=filter_)
-        client = self._instance._client
-        response_iterator = client._data_stub.ReadRows(request_pb)
-        rows_data = PartialRowsData(response_iterator)
-        rows_data.consume_all()
-        if rows_data.state not in (rows_data.NEW_ROW, rows_data.START):
-            raise ValueError('The row remains partial / is not committed.')
-
-        if len(rows_data.rows) == 0:
-            return None
-
-        return rows_data.rows[row_key]
-
-    def read_rows(self, start_key=None, end_key=None, limit=None,
-                  filter_=None):
-        """Read rows from this table.
-
-        :type start_key: bytes
-        :param start_key: (Optional) The beginning of a range of row keys to
-                          read from. The range will include ``start_key``. If
-                          left empty, will be interpreted as the empty string.
-
-        :type end_key: bytes
-        :param end_key: (Optional) The end of a range of row keys to read from.
-                        The range will not include ``end_key``. If left empty,
-                        will be interpreted as an infinite string.
-
-        :type limit: int
-        :param limit: (Optional) The read will terminate after committing to N
-                      rows' worth of results. The default (zero) is to return
-                      all results.
-
-        :type filter_: :class:`.RowFilter`
-        :param filter_: (Optional) The filter to apply to the contents of the
-                        specified row(s). If unset, reads every column in
-                        each row.
-
-        :rtype: :class:`.PartialRowsData`
-        :returns: A :class:`.PartialRowsData` convenience wrapper for consuming
-                  the streamed results.
-        """
-        request_pb = _create_row_request(
-            self.name, start_key=start_key, end_key=end_key, filter_=filter_,
-            limit=limit)
-        client = self._instance._client
-        response_iterator = client._data_stub.ReadRows(request_pb)
-        # We expect an iterator of `data_messages_v2_pb2.ReadRowsResponse`
-        return PartialRowsData(response_iterator)
-
-    def sample_row_keys(self):
-        """Read 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.
-
-        The elements in the iterator are a SampleRowKeys response and they have
-        the properties ``offset_bytes`` and ``row_key``. They occur in sorted
-        order. The table might have contents before the first row key in the
-        list and after the last one, but a key containing the empty string
-        indicates "end of table" and will be the last response given, if
-        present.
-
-        .. note::
-
-            Row keys in this list may not have ever been written to or read
-            from, and users should therefore not make any assumptions about the
-            row key structure that are specific to their use case.
-
-        The ``offset_bytes`` field on a response indicates the approximate
-        total storage space used by all rows in the table which precede
-        ``row_key``. Buffering the contents of all rows between two subsequent
-        samples would require space roughly equal to the difference in their
-        ``offset_bytes`` fields.
-
-        :rtype: :class:`~google.cloud.exceptions.GrpcRendezvous`
-        :returns: A cancel-able iterator. Can be consumed by calling ``next()``
-                  or by casting to a :class:`list` and can be cancelled by
-                  calling ``cancel()``.
-        """
-        request_pb = data_messages_v2_pb2.SampleRowKeysRequest(
-            table_name=self.name)
-        client = self._instance._client
-        response_iterator = client._data_stub.SampleRowKeys(request_pb)
-        return response_iterator
-
-
-def _create_row_request(table_name, row_key=None, start_key=None, end_key=None,
-                        filter_=None, limit=None):
-    """Creates a request to read rows in a table.
-
-    :type table_name: str
-    :param table_name: The name of the table to read from.
-
-    :type row_key: bytes
-    :param row_key: (Optional) The key of a specific row to read from.
-
-    :type start_key: bytes
-    :param start_key: (Optional) The beginning of a range of row keys to
-                      read from. The range will include ``start_key``. If
-                      left empty, will be interpreted as the empty string.
-
-    :type end_key: bytes
-    :param end_key: (Optional) The end of a range of row keys to read from.
-                    The range will not include ``end_key``. If left empty,
-                    will be interpreted as an infinite string.
-
-    :type filter_: :class:`.RowFilter`
-    :param filter_: (Optional) The filter to apply to the contents of the
-                    specified row(s). If unset, reads the entire table.
-
-    :type limit: int
-    :param limit: (Optional) The read will terminate after committing to N
-                  rows' worth of results. The default (zero) is to return
-                  all results.
-
-    :rtype: :class:`data_messages_v2_pb2.ReadRowsRequest`
-    :returns: The ``ReadRowsRequest`` protobuf corresponding to the inputs.
-    :raises: :class:`ValueError <exceptions.ValueError>` if both
-             ``row_key`` and one of ``start_key`` and ``end_key`` are set
-    """
-    request_kwargs = {'table_name': table_name}
-    if (row_key is not None and
-            (start_key is not None or end_key is not None)):
-        raise ValueError('Row key and row range cannot be '
-                         'set simultaneously')
-    range_kwargs = {}
-    if start_key is not None or end_key is not None:
-        if start_key is not None:
-            range_kwargs['start_key_closed'] = _to_bytes(start_key)
-        if end_key is not None:
-            range_kwargs['end_key_open'] = _to_bytes(end_key)
-    if filter_ is not None:
-        request_kwargs['filter'] = filter_.to_pb()
-    if limit is not None:
-        request_kwargs['rows_limit'] = limit
-
-    message = data_messages_v2_pb2.ReadRowsRequest(**request_kwargs)
-
-    if row_key is not None:
-        message.rows.row_keys.append(_to_bytes(row_key))
-
-    if range_kwargs:
-        message.rows.row_ranges.add(**range_kwargs)
-
-    return message
diff --git a/google/cloud/client.py b/google/cloud/client.py
deleted file mode 100644
index fadb00a22e13..000000000000
--- a/google/cloud/client.py
+++ /dev/null
@@ -1,186 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Base classes for client used to interact with Google Cloud APIs."""
-
-from oauth2client.service_account import ServiceAccountCredentials
-import six
-
-from google.cloud._helpers import _determine_default_project
-from google.cloud.connection import Connection
-from google.cloud.credentials import get_credentials
-
-
-class _ClientFactoryMixin(object):
-    """Mixin to allow factories that create credentials.
-
-    .. note::
-
-        This class is virtual.
-    """
-
-    @classmethod
-    def from_service_account_json(cls, json_credentials_path, *args, **kwargs):
-        """Factory to retrieve JSON credentials while creating client.
-
-        :type json_credentials_path: string
-        :param json_credentials_path: The path to a private key file (this file
-                                      was given to you when you created the
-                                      service account). This file must contain
-                                      a JSON object with a private key and
-                                      other credentials information (downloaded
-                                      from the Google APIs console).
-
-        :type args: tuple
-        :param args: Remaining positional arguments to pass to constructor.
-
-        :type kwargs: dict
-        :param kwargs: Remaining keyword arguments to pass to constructor.
-
-        :rtype: :class:`google.cloud.pubsub.client.Client`
-        :returns: The client created with the retrieved JSON credentials.
-        :raises: :class:`TypeError` if there is a conflict with the kwargs
-                 and the credentials created by the factory.
-        """
-        if 'credentials' in kwargs:
-            raise TypeError('credentials must not be in keyword arguments')
-        credentials = ServiceAccountCredentials.from_json_keyfile_name(
-            json_credentials_path)
-        kwargs['credentials'] = credentials
-        return cls(*args, **kwargs)
-
-    @classmethod
-    def from_service_account_p12(cls, client_email, private_key_path,
-                                 *args, **kwargs):
-        """Factory to retrieve P12 credentials while creating client.
-
-        .. note::
-          Unless you have an explicit reason to use a PKCS12 key for your
-          service account, we recommend using a JSON key.
-
-        :type client_email: string
-        :param client_email: The e-mail attached to the service account.
-
-        :type private_key_path: string
-        :param private_key_path: The path to a private key file (this file was
-                                 given to you when you created the service
-                                 account). This file must be in P12 format.
-
-        :type args: tuple
-        :param args: Remaining positional arguments to pass to constructor.
-
-        :type kwargs: dict
-        :param kwargs: Remaining keyword arguments to pass to constructor.
-
-        :rtype: :class:`google.cloud.client.Client`
-        :returns: The client created with the retrieved P12 credentials.
-        :raises: :class:`TypeError` if there is a conflict with the kwargs
-                 and the credentials created by the factory.
-        """
-        if 'credentials' in kwargs:
-            raise TypeError('credentials must not be in keyword arguments')
-        credentials = ServiceAccountCredentials.from_p12_keyfile(
-            client_email, private_key_path)
-        kwargs['credentials'] = credentials
-        return cls(*args, **kwargs)
-
-
-class Client(_ClientFactoryMixin):
-    """Client to bundle configuration needed for API requests.
-
-    Assumes that the associated ``_connection_class`` only accepts
-    ``http`` and ``credentials`` in its constructor.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def __init__(self, credentials=None, http=None):
-        if credentials is None and http is None:
-            credentials = get_credentials()
-        self.connection = self._connection_class(
-            credentials=credentials, http=http)
-
-
-class _ClientProjectMixin(object):
-    """Mixin to allow setting the project on the client.
-
-    :type project: string
-    :param project: the project which the client acts on behalf of. If not
-                    passed falls back to the default inferred from the
-                    environment.
-
-    :raises: :class:`EnvironmentError` if the project is neither passed in nor
-             set in the environment. :class:`ValueError` if the project value
-             is invalid.
-    """
-
-    def __init__(self, project=None):
-        project = self._determine_default(project)
-        if project is None:
-            raise EnvironmentError('Project was not passed and could not be '
-                                   'determined from the environment.')
-        if isinstance(project, six.binary_type):
-            project = project.decode('utf-8')
-        if not isinstance(project, six.string_types):
-            raise ValueError('Project must be a string.')
-        self.project = project
-
-    @staticmethod
-    def _determine_default(project):
-        """Helper:  use default project detection."""
-        return _determine_default_project(project)
-
-
-class JSONClient(Client, _ClientProjectMixin):
-    """Client to for Google JSON-based API.
-
-    Assumes such APIs use the ``project`` and the client needs to store this
-    value.
-
-    :type project: string
-    :param project: the project which the client acts on behalf of. If not
-                    passed falls back to the default inferred from the
-                    environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-
-    :raises: :class:`ValueError` if the project is neither passed in nor
-             set in the environment.
-    """
-
-    def __init__(self, project=None, credentials=None, http=None):
-        _ClientProjectMixin.__init__(self, project=project)
-        Client.__init__(self, credentials=credentials, http=http)
diff --git a/google/cloud/connection.py b/google/cloud/connection.py
deleted file mode 100644
index 2a26335f1bff..000000000000
--- a/google/cloud/connection.py
+++ /dev/null
@@ -1,361 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Shared implementation of connections to API servers."""
-
-import json
-from pkg_resources import get_distribution
-import six
-from six.moves.urllib.parse import urlencode
-
-import httplib2
-
-from google.cloud.exceptions import make_exception
-
-
-API_BASE_URL = 'https://www.googleapis.com'
-"""The base of the API call URL."""
-
-DEFAULT_USER_AGENT = 'gcloud-python/{0}'.format(
-    get_distribution('google-cloud').version)
-"""The user agent for google-cloud-python requests."""
-
-
-class Connection(object):
-    """A generic connection to Google Cloud Platform.
-
-    Subclasses should understand only the basic types in method arguments,
-    however they should be capable of returning advanced types.
-
-    If no value is passed in for ``http``, a :class:`httplib2.Http` object
-    will be created and authorized with the ``credentials``. If not, the
-    ``credentials`` and ``http`` need not be related.
-
-    Subclasses may seek to use the private key from ``credentials`` to sign
-    data.
-
-    A custom (non-``httplib2``) HTTP object must have a ``request`` method
-    which accepts the following arguments:
-
-    * ``uri``
-    * ``method``
-    * ``body``
-    * ``headers``
-
-    In addition, ``redirections`` and ``connection_type`` may be used.
-
-    Without the use of ``credentials.authorize(http)``, a custom ``http``
-    object will also need to be able to add a bearer token to API
-    requests and handle token refresh on 401 errors.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for this connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests.
-    """
-
-    USER_AGENT = DEFAULT_USER_AGENT
-
-    SCOPE = None
-    """The scopes required for authenticating with a service.
-
-    Needs to be set by subclasses.
-    """
-
-    def __init__(self, credentials=None, http=None):
-        self._http = http
-        self._credentials = self._create_scoped_credentials(
-            credentials, self.SCOPE)
-
-    @property
-    def credentials(self):
-        """Getter for current credentials.
-
-        :rtype: :class:`oauth2client.client.OAuth2Credentials` or
-                :class:`NoneType`
-        :returns: The credentials object associated with this connection.
-        """
-        return self._credentials
-
-    @property
-    def http(self):
-        """A getter for the HTTP transport used in talking to the API.
-
-        :rtype: :class:`httplib2.Http`
-        :returns: A Http object used to transport data.
-        """
-        if self._http is None:
-            self._http = httplib2.Http()
-            if self._credentials:
-                self._http = self._credentials.authorize(self._http)
-        return self._http
-
-    @staticmethod
-    def _create_scoped_credentials(credentials, scope):
-        """Create a scoped set of credentials if it is required.
-
-        :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                           :class:`NoneType`
-        :param credentials: The OAuth2 Credentials to add a scope to.
-
-        :type scope: list of URLs
-        :param scope: the effective service auth scopes for the connection.
-
-        :rtype: :class:`oauth2client.client.OAuth2Credentials` or
-                :class:`NoneType`
-        :returns: A new credentials object that has a scope added (if needed).
-        """
-        if credentials:
-            try:
-                if credentials.create_scoped_required():
-                    credentials = credentials.create_scoped(scope)
-            except AttributeError:
-                pass
-        return credentials
-
-
-class JSONConnection(Connection):
-    """A connection to a Google JSON-based API.
-
-    These APIs are discovery based. For reference:
-
-        https://developers.google.com/discovery/
-
-    This defines :meth:`api_request` for making a generic JSON
-    API request and API requests are created elsewhere.
-
-    The class constants
-
-    * :attr:`API_BASE_URL`
-    * :attr:`API_VERSION`
-    * :attr:`API_URL_TEMPLATE`
-
-    must be updated by subclasses.
-    """
-
-    API_BASE_URL = None
-    """The base of the API call URL."""
-
-    API_VERSION = None
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = None
-    """A template for the URL of a particular API call."""
-
-    @classmethod
-    def build_api_url(cls, path, query_params=None,
-                      api_base_url=None, api_version=None):
-        """Construct an API url given a few components, some optional.
-
-        Typically, you shouldn't need to use this method.
-
-        :type path: string
-        :param path: The path to the resource (ie, ``'/b/bucket-name'``).
-
-        :type query_params: dict or list
-        :param query_params: A dictionary of keys and values (or list of
-                             key-value pairs) to insert into the query
-                             string of the URL.
-
-        :type api_base_url: string
-        :param api_base_url: The base URL for the API endpoint.
-                             Typically you won't have to provide this.
-
-        :type api_version: string
-        :param api_version: The version of the API to call.
-                            Typically you shouldn't provide this and instead
-                            use the default for the library.
-
-        :rtype: string
-        :returns: The URL assembled from the pieces provided.
-        """
-        url = cls.API_URL_TEMPLATE.format(
-            api_base_url=(api_base_url or cls.API_BASE_URL),
-            api_version=(api_version or cls.API_VERSION),
-            path=path)
-
-        query_params = query_params or {}
-        if query_params:
-            url += '?' + urlencode(query_params)
-
-        return url
-
-    def _make_request(self, method, url, data=None, content_type=None,
-                      headers=None, target_object=None):
-        """A low level method to send a request to the API.
-
-        Typically, you shouldn't need to use this method.
-
-        :type method: string
-        :param method: The HTTP method to use in the request.
-
-        :type url: string
-        :param url: The URL to send the request to.
-
-        :type data: string
-        :param data: The data to send as the body of the request.
-
-        :type content_type: string
-        :param content_type: The proper MIME type of the data provided.
-
-        :type headers: dict
-        :param headers: A dictionary of HTTP headers to send with the request.
-
-        :type target_object: object or :class:`NoneType`
-        :param target_object: Argument to be used by library callers.
-                              This can allow custom behavior, for example, to
-                              defer an HTTP request and complete initialization
-                              of the object at a later time.
-
-        :rtype: tuple of ``response`` (a dictionary of sorts)
-                and ``content`` (a string).
-        :returns: The HTTP response object and the content of the response,
-                  returned by :meth:`_do_request`.
-        """
-        headers = headers or {}
-        headers['Accept-Encoding'] = 'gzip'
-
-        if data:
-            content_length = len(str(data))
-        else:
-            content_length = 0
-
-        # NOTE: str is intended, bytes are sufficient for headers.
-        headers['Content-Length'] = str(content_length)
-
-        if content_type:
-            headers['Content-Type'] = content_type
-
-        headers['User-Agent'] = self.USER_AGENT
-
-        return self._do_request(method, url, headers, data, target_object)
-
-    def _do_request(self, method, url, headers, data,
-                    target_object):  # pylint: disable=unused-argument
-        """Low-level helper:  perform the actual API request over HTTP.
-
-        Allows batch context managers to override and defer a request.
-
-        :type method: string
-        :param method: The HTTP method to use in the request.
-
-        :type url: string
-        :param url: The URL to send the request to.
-
-        :type headers: dict
-        :param headers: A dictionary of HTTP headers to send with the request.
-
-        :type data: string
-        :param data: The data to send as the body of the request.
-
-        :type target_object: object or :class:`NoneType`
-        :param target_object: Unused ``target_object`` here but may be used
-                              by a superclass.
-
-        :rtype: tuple of ``response`` (a dictionary of sorts)
-                and ``content`` (a string).
-        :returns: The HTTP response object and the content of the response.
-        """
-        return self.http.request(uri=url, method=method, headers=headers,
-                                 body=data)
-
-    def api_request(self, method, path, query_params=None,
-                    data=None, content_type=None,
-                    api_base_url=None, api_version=None,
-                    expect_json=True, _target_object=None):
-        """Make a request over the HTTP transport to the API.
-
-        You shouldn't need to use this method, but if you plan to
-        interact with the API using these primitives, this is the
-        correct one to use.
-
-        :type method: string
-        :param method: The HTTP method name (ie, ``GET``, ``POST``, etc).
-                       Required.
-
-        :type path: string
-        :param path: The path to the resource (ie, ``'/b/bucket-name'``).
-                     Required.
-
-        :type query_params: dict or list
-        :param query_params: A dictionary of keys and values (or list of
-                             key-value pairs) to insert into the query
-                             string of the URL.
-
-        :type data: string
-        :param data: The data to send as the body of the request. Default is
-                     the empty string.
-
-        :type content_type: string
-        :param content_type: The proper MIME type of the data provided. Default
-                             is None.
-
-        :type api_base_url: string
-        :param api_base_url: The base URL for the API endpoint.
-                             Typically you won't have to provide this.
-                             Default is the standard API base URL.
-
-        :type api_version: string
-        :param api_version: The version of the API to call.  Typically
-                            you shouldn't provide this and instead use
-                            the default for the library.  Default is the
-                            latest API version supported by
-                            google-cloud-python.
-
-        :type expect_json: bool
-        :param expect_json: If True, this method will try to parse the
-                            response as JSON and raise an exception if
-                            that cannot be done.  Default is True.
-
-        :type _target_object: :class:`object` or :class:`NoneType`
-        :param _target_object: Protected argument to be used by library
-                               callers. This can allow custom behavior, for
-                               example, to defer an HTTP request and complete
-                               initialization of the object at a later time.
-
-        :raises: Exception if the response code is not 200 OK.
-        :rtype: dict or str
-        :returns: The API response payload, either as a raw string or
-                  a dictionary if the response is valid JSON.
-        """
-        url = self.build_api_url(path=path, query_params=query_params,
-                                 api_base_url=api_base_url,
-                                 api_version=api_version)
-
-        # Making the executive decision that any dictionary
-        # data will be sent properly as JSON.
-        if data and isinstance(data, dict):
-            data = json.dumps(data)
-            content_type = 'application/json'
-
-        response, content = self._make_request(
-            method=method, url=url, data=data, content_type=content_type,
-            target_object=_target_object)
-
-        if not 200 <= response.status < 300:
-            raise make_exception(response, content,
-                                 error_info=method + ' ' + url)
-
-        string_or_bytes = (six.binary_type, six.text_type)
-        if content and expect_json and isinstance(content, string_or_bytes):
-            content_type = response.get('content-type', '')
-            if not content_type.startswith('application/json'):
-                raise TypeError('Expected JSON, got %s' % content_type)
-            if isinstance(content, six.binary_type):
-                content = content.decode('utf-8')
-            return json.loads(content)
-
-        return content
diff --git a/google/cloud/credentials.py b/google/cloud/credentials.py
deleted file mode 100644
index daf0a914d3b0..000000000000
--- a/google/cloud/credentials.py
+++ /dev/null
@@ -1,251 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""A simple wrapper around the OAuth2 credentials library."""
-
-import base64
-import datetime
-import six
-from six.moves.urllib.parse import urlencode
-
-from oauth2client import client
-
-from google.cloud._helpers import UTC
-from google.cloud._helpers import _NOW
-from google.cloud._helpers import _microseconds_from_datetime
-
-
-def get_credentials():
-    """Gets credentials implicitly from the current environment.
-
-    .. note::
-
-        You should not need to use this function directly. Instead, use a
-        helper method which uses this method under the hood.
-
-    Checks environment in order of precedence:
-
-    * Google App Engine (production and testing)
-    * Environment variable :envvar:`GOOGLE_APPLICATION_CREDENTIALS` pointing to
-      a file with stored credentials information.
-    * Stored "well known" file associated with ``gcloud`` command line tool.
-    * Google Compute Engine production environment.
-
-    The file referred to in :envvar:`GOOGLE_APPLICATION_CREDENTIALS` is
-    expected to contain information about credentials that are ready to use.
-    This means either service account information or user account information
-    with a ready-to-use refresh token:
-
-    .. code:: json
-
-      {
-          'type': 'authorized_user',
-          'client_id': '...',
-          'client_secret': '...',
-          'refresh_token': '...'
-      }
-
-    or
-
-    .. code:: json
-
-      {
-          'type': 'service_account',
-          'project_id': '...',
-          'private_key_id': '...',
-          'private_key': '...',
-          'client_email': '...',
-          'client_id': '...',
-          'auth_uri': '...',
-          'token_uri': '...',
-          'auth_provider_x509_cert_url': '...',
-          'client_x509_cert_url': '...'
-      }
-
-    The second of these is simply a JSON key downloaded from the Google APIs
-    console. The first is a close cousin of the "client secrets" JSON file
-    used by :mod:`oauth2client.clientsecrets` but differs in formatting.
-
-    :rtype: :class:`oauth2client.client.GoogleCredentials`,
-            :class:`oauth2client.contrib.appengine.AppAssertionCredentials`,
-            :class:`oauth2client.contrib.gce.AppAssertionCredentials`,
-            :class:`oauth2client.service_account.ServiceAccountCredentials`
-    :returns: A new credentials instance corresponding to the implicit
-              environment.
-    """
-    return client.GoogleCredentials.get_application_default()
-
-
-def _get_signed_query_params(credentials, expiration, string_to_sign):
-    """Gets query parameters for creating a signed URL.
-
-    :type credentials: :class:`oauth2client.client.AssertionCredentials`
-    :param credentials: The credentials used to create a private key
-                        for signing text.
-
-    :type expiration: int or long
-    :param expiration: When the signed URL should expire.
-
-    :type string_to_sign: string
-    :param string_to_sign: The string to be signed by the credentials.
-
-    :raises AttributeError: If :meth: sign_blob is unavailable.
-
-    :rtype: dict
-    :returns: Query parameters matching the signing credentials with a
-              signed payload.
-    """
-    if not hasattr(credentials, 'sign_blob'):
-        auth_uri = ('http://google-cloud-python.readthedocs.io/en/latest/'
-                    'google-cloud-auth.html#setting-up-a-service-account')
-        raise AttributeError('you need a private key to sign credentials.'
-                             'the credentials you are currently using %s '
-                             'just contains a token. see %s for more '
-                             'details.' % (type(credentials), auth_uri))
-
-    _, signature_bytes = credentials.sign_blob(string_to_sign)
-    signature = base64.b64encode(signature_bytes)
-    service_account_name = credentials.service_account_email
-    return {
-        'GoogleAccessId': service_account_name,
-        'Expires': str(expiration),
-        'Signature': signature,
-    }
-
-
-def _get_expiration_seconds(expiration):
-    """Convert 'expiration' to a number of seconds in the future.
-
-    :type expiration: int, long, datetime.datetime, datetime.timedelta
-    :param expiration: When the signed URL should expire.
-
-    :raises TypeError: When expiration is not an integer.
-
-    :rtype: int
-    :returns: a timestamp as an absolute number of seconds.
-    """
-    # If it's a timedelta, add it to `now` in UTC.
-    if isinstance(expiration, datetime.timedelta):
-        now = _NOW().replace(tzinfo=UTC)
-        expiration = now + expiration
-
-    # If it's a datetime, convert to a timestamp.
-    if isinstance(expiration, datetime.datetime):
-        micros = _microseconds_from_datetime(expiration)
-        expiration = micros // 10**6
-
-    if not isinstance(expiration, six.integer_types):
-        raise TypeError('Expected an integer timestamp, datetime, or '
-                        'timedelta. Got %s' % type(expiration))
-    return expiration
-
-
-def generate_signed_url(credentials, resource, expiration,
-                        api_access_endpoint='',
-                        method='GET', content_md5=None,
-                        content_type=None, response_type=None,
-                        response_disposition=None, generation=None):
-    """Generate signed URL to provide query-string auth'n to a resource.
-
-    .. note::
-
-        Assumes ``credentials`` implements a ``sign_blob()`` method that takes
-        bytes to sign and returns a pair of the key ID (unused here) and the
-        signed bytes (this is abstract in the base class
-        :class:`oauth2client.client.AssertionCredentials`). Also assumes
-        ``credentials`` has a ``service_account_email`` property which
-        identifies the credentials.
-
-    .. note::
-
-        If you are on Google Compute Engine, you can't generate a signed URL.
-        Follow `Issue 922`_ for updates on this. If you'd like to be able to
-        generate a signed URL from GCE, you can use a standard service account
-        from a JSON file rather than a GCE service account.
-
-    See headers `reference`_ for more details on optional arguments.
-
-    .. _Issue 922: https://github.com/GoogleCloudPlatform/\
-                   google-cloud-python/issues/922
-    .. _reference: https://cloud.google.com/storage/docs/reference-headers
-
-    :type credentials: :class:`oauth2client.appengine.AppAssertionCredentials`
-    :param credentials: Credentials object with an associated private key to
-                        sign text.
-
-    :type resource: string
-    :param resource: A pointer to a specific resource
-                     (typically, ``/bucket-name/path/to/blob.txt``).
-
-    :type expiration: :class:`int`, :class:`long`, :class:`datetime.datetime`,
-                      :class:`datetime.timedelta`
-    :param expiration: When the signed URL should expire.
-
-    :type api_access_endpoint: str
-    :param api_access_endpoint: Optional URI base. Defaults to empty string.
-
-    :type method: str
-    :param method: The HTTP verb that will be used when requesting the URL.
-                   Defaults to ``'GET'``.
-
-    :type content_md5: str
-    :param content_md5: (Optional) The MD5 hash of the object referenced by
-                        ``resource``.
-
-    :type content_type: str
-    :param content_type: (Optional) The content type of the object referenced
-                         by ``resource``.
-
-    :type response_type: str
-    :param response_type: (Optional) Content type of responses to requests for
-                          the signed URL. Used to over-ride the content type of
-                          the underlying resource.
-
-    :type response_disposition: str
-    :param response_disposition: (Optional) Content disposition of responses to
-                                 requests for the signed URL.
-
-    :type generation: str
-    :param generation: (Optional) A value that indicates which generation of
-                       the resource to fetch.
-
-    :rtype: string
-    :returns: A signed URL you can use to access the resource
-              until expiration.
-    """
-    expiration = _get_expiration_seconds(expiration)
-
-    # Generate the string to sign.
-    string_to_sign = '\n'.join([
-        method,
-        content_md5 or '',
-        content_type or '',
-        str(expiration),
-        resource])
-
-    # Set the right query parameters.
-    query_params = _get_signed_query_params(credentials,
-                                            expiration,
-                                            string_to_sign)
-    if response_type is not None:
-        query_params['response-content-type'] = response_type
-    if response_disposition is not None:
-        query_params['response-content-disposition'] = response_disposition
-    if generation is not None:
-        query_params['generation'] = generation
-
-    # Return the built URL.
-    return '{endpoint}{resource}?{querystring}'.format(
-        endpoint=api_access_endpoint, resource=resource,
-        querystring=urlencode(query_params))
diff --git a/google/cloud/datastore/__init__.py b/google/cloud/datastore/__init__.py
deleted file mode 100644
index 103131d4c899..000000000000
--- a/google/cloud/datastore/__init__.py
+++ /dev/null
@@ -1,63 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Shortcut methods for getting set up with Google Cloud Datastore.
-
-You'll typically use these to get started with the API::
-
-    >>> from google.cloud import datastore
-    >>>
-    >>> client = datastore.Client()
-    >>> key = client.key('EntityKind', 1234)
-    >>> entity = datastore.Entity(key)
-    >>> query = client.query(kind='EntityKind')
-
-The main concepts with this API are:
-
-- :class:`google.cloud.datastore.connection.Connection`
-  which represents a connection between your machine and the Cloud Datastore
-  API.
-
-- :class:`google.cloud.datastore.client.Client`
-  which represents a project (string) and namespace (string) bundled with
-  a connection and has convenience methods for constructing objects with that
-  project / namespace.
-
-- :class:`google.cloud.datastore.entity.Entity`
-  which represents a single entity in the datastore
-  (akin to a row in relational database world).
-
-- :class:`google.cloud.datastore.key.Key`
-  which represents a pointer to a particular entity in the datastore
-  (akin to a unique identifier in relational database world).
-
-- :class:`google.cloud.datastore.query.Query`
-  which represents a lookup or search over the rows in the datastore.
-
-- :class:`google.cloud.datastore.transaction.Transaction`
-  which represents an all-or-none transaction and enables consistency
-  when race conditions may occur.
-"""
-
-
-from google.cloud.datastore.batch import Batch
-from google.cloud.datastore.connection import Connection
-from google.cloud.datastore.client import Client
-from google.cloud.datastore.entity import Entity
-from google.cloud.datastore.key import Key
-from google.cloud.datastore.query import Query
-from google.cloud.datastore.transaction import Transaction
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/datastore/_generated/__init__.py b/google/cloud/datastore/_generated/__init__.py
deleted file mode 100644
index 19a0f26e68de..000000000000
--- a/google/cloud/datastore/_generated/__init__.py
+++ /dev/null
@@ -1,15 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Generated protobuf modules for Google Cloud Datastore API."""
diff --git a/google/cloud/datastore/_generated/_datastore.proto b/google/cloud/datastore/_generated/_datastore.proto
deleted file mode 100644
index 5881e9a14714..000000000000
--- a/google/cloud/datastore/_generated/_datastore.proto
+++ /dev/null
@@ -1,316 +0,0 @@
-// Copyright 2016 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.datastore.v1;
-
-import "google/api/annotations.proto";
-import "google/datastore/v1/entity.proto";
-import "google/datastore/v1/query.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "DatastoreProto";
-option java_package = "com.google.datastore.v1";
-
-
-// Each RPC normalizes the partition IDs of the keys in its input entities,
-// and always returns entities with keys with normalized partition IDs.
-// This applies to all keys and entities, including those in values, except keys
-// with both an empty path and an empty or unset partition ID. Normalization of
-// input keys sets the project ID (if not already set) to the project ID from
-// the request.
-//
-service Datastore {
-  // Looks up entities by key.
-  rpc Lookup(LookupRequest) returns (LookupResponse) {
-    option (google.api.http) = { post: "/v1/projects/{project_id}:lookup" body: "*" };
-  }
-
-  // Queries for entities.
-  rpc RunQuery(RunQueryRequest) returns (RunQueryResponse) {
-    option (google.api.http) = { post: "/v1/projects/{project_id}:runQuery" body: "*" };
-  }
-
-  // Begins a new transaction.
-  rpc BeginTransaction(BeginTransactionRequest) returns (BeginTransactionResponse) {
-    option (google.api.http) = { post: "/v1/projects/{project_id}:beginTransaction" body: "*" };
-  }
-
-  // Commits a transaction, optionally creating, deleting or modifying some
-  // entities.
-  rpc Commit(CommitRequest) returns (CommitResponse) {
-    option (google.api.http) = { post: "/v1/projects/{project_id}:commit" body: "*" };
-  }
-
-  // Rolls back a transaction.
-  rpc Rollback(RollbackRequest) returns (RollbackResponse) {
-    option (google.api.http) = { post: "/v1/projects/{project_id}:rollback" body: "*" };
-  }
-
-  // Allocates IDs for the given keys, which is useful for referencing an entity
-  // before it is inserted.
-  rpc AllocateIds(AllocateIdsRequest) returns (AllocateIdsResponse) {
-    option (google.api.http) = { post: "/v1/projects/{project_id}:allocateIds" body: "*" };
-  }
-}
-
-// 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;
-
-  // The options for this lookup request.
-  ReadOptions read_options = 1;
-
-  // Keys of entities to look up.
-  repeated Key keys = 3;
-}
-
-// The response for [Datastore.Lookup][google.datastore.v1.Datastore.Lookup].
-message LookupResponse {
-  // Entities found as `ResultType.FULL` entities. The order of results in this
-  // field is undefined and has no relation to the order of the keys in the
-  // input.
-  repeated EntityResult found = 1;
-
-  // Entities not found as `ResultType.KEY_ONLY` entities. The order of results
-  // in this field is undefined and has no relation to the order of the keys
-  // in the input.
-  repeated EntityResult missing = 2;
-
-  // A list of keys that were not looked up due to resource constraints. The
-  // order of results in this field is undefined and has no relation to the
-  // order of the keys in the input.
-  repeated Key deferred = 3;
-}
-
-// 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;
-
-  // Entities are partitioned into subsets, identified by a partition ID.
-  // Queries are scoped to a single partition.
-  // This partition ID is normalized with the standard default context
-  // partition ID.
-  PartitionId partition_id = 2;
-
-  // The options for this query.
-  ReadOptions read_options = 1;
-
-  // The type of query.
-  oneof query_type {
-    // The query to run.
-    Query query = 3;
-
-    // The GQL query to run.
-    GqlQuery gql_query = 7;
-  }
-}
-
-// The response for [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
-message RunQueryResponse {
-  // A batch of query results (always present).
-  QueryResultBatch batch = 1;
-
-  // The parsed form of the `GqlQuery` from the request, if it was set.
-  Query query = 2;
-}
-
-// 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;
-}
-
-// The response for [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
-message BeginTransactionResponse {
-  // The transaction identifier (always present).
-  bytes transaction = 1;
-}
-
-// 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;
-
-  // The transaction identifier, returned by a call to
-  // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
-  bytes transaction = 1;
-}
-
-// 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 {
-  // The modes available for commits.
-  enum Mode {
-    // Unspecified. This value must not be used.
-    MODE_UNSPECIFIED = 0;
-
-    // Transactional: The mutations are either all applied, or none are applied.
-    // Learn about transactions [here](https://cloud.google.com/datastore/docs/concepts/transactions).
-    TRANSACTIONAL = 1;
-
-    // Non-transactional: The mutations may not apply as all or none.
-    NON_TRANSACTIONAL = 2;
-  }
-
-  // The ID of the project against which to make the request.
-  string project_id = 8;
-
-  // The type of commit to perform. Defaults to `TRANSACTIONAL`.
-  Mode mode = 5;
-
-  // Must be set when mode is `TRANSACTIONAL`.
-  oneof transaction_selector {
-    // The identifier of the transaction associated with the commit. A
-    // transaction identifier is returned by a call to
-    // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
-    bytes transaction = 1;
-  }
-
-  // The mutations to perform.
-  //
-  // When mode is `TRANSACTIONAL`, mutations affecting a single entity are
-  // applied in order. The following sequences of mutations affecting a single
-  // entity are not permitted in a single `Commit` request:
-  //
-  // - `insert` followed by `insert`
-  // - `update` followed by `insert`
-  // - `upsert` followed by `insert`
-  // - `delete` followed by `update`
-  //
-  // When mode is `NON_TRANSACTIONAL`, no two mutations may affect a single
-  // entity.
-  repeated Mutation mutations = 6;
-}
-
-// The response for [Datastore.Commit][google.datastore.v1.Datastore.Commit].
-message CommitResponse {
-  // The result of performing the mutations.
-  // The i-th mutation result corresponds to the i-th mutation in the request.
-  repeated MutationResult mutation_results = 3;
-
-  // The number of index entries updated during the commit, or zero if none were
-  // updated.
-  int32 index_updates = 4;
-}
-
-// 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;
-
-  // A list of keys with incomplete key paths for which to allocate IDs.
-  // No key may be reserved/read-only.
-  repeated Key keys = 1;
-}
-
-// 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;
-}
-
-// A mutation to apply to an entity.
-message Mutation {
-  // The mutation operation.
-  //
-  // For `insert`, `update`, and `upsert`:
-  // - The entity's key must not be reserved/read-only.
-  // - No property in the entity may have a reserved name,
-  //   not even a property in an entity in a value.
-  // - No value in the entity may have meaning 18,
-  //   not even a value in an entity in another value.
-  oneof operation {
-    // The entity to insert. The entity must not already exist.
-    // The entity key's final path element may be incomplete.
-    Entity insert = 4;
-
-    // The entity to update. The entity must already exist.
-    // Must have a complete key path.
-    Entity update = 5;
-
-    // The entity to upsert. The entity may or may not already exist.
-    // The entity key's final path element may be incomplete.
-    Entity upsert = 6;
-
-    // The key of the entity to delete. The entity may or may not already exist.
-    // Must have a complete key path and must not be reserved/read-only.
-    Key delete = 7;
-  }
-
-  // When set, the server will detect whether or not this mutation conflicts
-  // with the current version of the entity on the server. Conflicting mutations
-  // are not applied, and are marked as such in MutationResult.
-  oneof conflict_detection_strategy {
-    // The version of the entity that this mutation is being applied to. If this
-    // does not match the current version on the server, the mutation conflicts.
-    int64 base_version = 8;
-  }
-}
-
-// The result of applying a mutation.
-message MutationResult {
-  // The automatically allocated key.
-  // Set only when the mutation allocated a key.
-  Key key = 3;
-
-  // The version of the entity on the server after processing the mutation. If
-  // the mutation doesn't change anything on the server, then the version will
-  // be the version of the current entity or, if no entity is present, a version
-  // that is strictly greater than the version of any previous entity and less
-  // than the version of any possible future entity.
-  int64 version = 4;
-
-  // Whether a conflict was detected for this mutation. Always false when a
-  // conflict detection strategy field is not set in the mutation.
-  bool conflict_detected = 5;
-}
-
-// The options shared by read requests.
-message ReadOptions {
-  // The possible values for read consistencies.
-  enum ReadConsistency {
-    // Unspecified. This value must not be used.
-    READ_CONSISTENCY_UNSPECIFIED = 0;
-
-    // Strong consistency.
-    STRONG = 1;
-
-    // Eventual consistency.
-    EVENTUAL = 2;
-  }
-
-  // If not specified, lookups and ancestor queries default to
-  // `read_consistency`=`STRONG`, global queries default to
-  // `read_consistency`=`EVENTUAL`.
-  oneof consistency_type {
-    // The non-transactional read consistency to use.
-    // Cannot be set to `STRONG` for global queries.
-    ReadConsistency read_consistency = 1;
-
-    // The identifier of the transaction in which to read. A
-    // transaction identifier is returned by a call to
-    // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
-    bytes transaction = 2;
-  }
-}
diff --git a/google/cloud/datastore/_generated/_entity.proto b/google/cloud/datastore/_generated/_entity.proto
deleted file mode 100644
index a0e7d39138f2..000000000000
--- a/google/cloud/datastore/_generated/_entity.proto
+++ /dev/null
@@ -1,201 +0,0 @@
-// Copyright 2016 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.datastore.v1;
-
-import "google/api/annotations.proto";
-import "google/protobuf/struct.proto";
-import "google/protobuf/timestamp.proto";
-import "google/type/latlng.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "EntityProto";
-option java_package = "com.google.datastore.v1";
-
-
-// A partition ID identifies a grouping of entities. The grouping is always
-// by project and namespace, however the namespace ID may be empty.
-//
-// A partition ID contains several dimensions:
-// project ID and namespace ID.
-//
-// Partition dimensions:
-//
-// - May be `""`.
-// - Must be valid UTF-8 bytes.
-// - Must have values that match regex `[A-Za-z\d\.\-_]{1,100}`
-// If the value of any dimension matches regex `__.*__`, the partition is
-// reserved/read-only.
-// A reserved/read-only partition ID is forbidden in certain documented
-// contexts.
-//
-// Foreign partition IDs (in which the project ID does
-// not match the context project ID ) are discouraged.
-// Reads and writes of foreign partition IDs may fail if the project is not in an active state.
-message PartitionId {
-  // The ID of the project to which the entities belong.
-  string project_id = 2;
-
-  // If not empty, the ID of the namespace to which the entities belong.
-  string namespace_id = 4;
-}
-
-// A unique identifier for an entity.
-// If a key's partition ID or any of its path kinds or names are
-// reserved/read-only, the key is reserved/read-only.
-// A reserved/read-only key is forbidden in certain documented contexts.
-message Key {
-  // A (kind, ID/name) pair used to construct a key path.
-  //
-  // If either name or ID is set, the element is complete.
-  // If neither is set, the element is incomplete.
-  message PathElement {
-    // The kind of the entity.
-    // A kind matching regex `__.*__` is reserved/read-only.
-    // A kind must not contain more than 1500 bytes when UTF-8 encoded.
-    // Cannot be `""`.
-    string kind = 1;
-
-    // The type of ID.
-    oneof id_type {
-      // The auto-allocated ID of the entity.
-      // Never equal to zero. Values less than zero are discouraged and may not
-      // be supported in the future.
-      int64 id = 2;
-
-      // The name of the entity.
-      // A name matching regex `__.*__` is reserved/read-only.
-      // A name must not be more than 1500 bytes when UTF-8 encoded.
-      // Cannot be `""`.
-      string name = 3;
-    }
-  }
-
-  // Entities are partitioned into subsets, currently identified by a project
-  // ID and namespace ID.
-  // Queries are scoped to a single partition.
-  PartitionId partition_id = 1;
-
-  // The entity path.
-  // An entity path consists of one or more elements composed of a kind and a
-  // string or numerical identifier, which identify entities. The first
-  // element identifies a _root entity_, the second element identifies
-  // a _child_ of the root entity, the third element identifies a child of the
-  // second entity, and so forth. The entities identified by all prefixes of
-  // the path are called the element's _ancestors_.
-  //
-  // An entity path is always fully complete: *all* of the entity's ancestors
-  // are required to be in the path along with the entity identifier itself.
-  // The only exception is that in some documented cases, the identifier in the
-  // last path element (for the entity) itself may be omitted. For example,
-  // the last path element of the key of `Mutation.insert` may have no
-  // identifier.
-  //
-  // A path can never be empty, and a path can have at most 100 elements.
-  repeated PathElement path = 2;
-}
-
-// 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.
-  repeated Value values = 1;
-}
-
-// A message that can hold any of the supported value types and associated
-// metadata.
-message Value {
-  // Must have a value set.
-  oneof value_type {
-    // A null value.
-    google.protobuf.NullValue null_value = 11;
-
-    // A boolean value.
-    bool boolean_value = 1;
-
-    // An integer value.
-    int64 integer_value = 2;
-
-    // A double value.
-    double double_value = 3;
-
-    // A timestamp value.
-    // When stored in the Datastore, precise only to microseconds;
-    // any additional precision is rounded down.
-    google.protobuf.Timestamp timestamp_value = 10;
-
-    // A key 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.
-    string string_value = 17;
-
-    // A blob value.
-    // May have at most 1,000,000 bytes.
-    // When `exclude_from_indexes` is false, may have at most 1500 bytes.
-    // In JSON requests, must be base64-encoded.
-    bytes blob_value = 18;
-
-    // A geo point value representing a point on the surface of Earth.
-    google.type.LatLng geo_point_value = 8;
-
-    // An entity value.
-    //
-    // - May have no key.
-    // - May have a key with an incomplete key path.
-    // - May have a reserved/read-only key.
-    Entity entity_value = 6;
-
-    // An array value.
-    // Cannot contain another array value.
-    // A `Value` instance that sets field `array_value` must not set fields
-    // `meaning` or `exclude_from_indexes`.
-    ArrayValue array_value = 9;
-  }
-
-  // The `meaning` field should only be populated for backwards compatibility.
-  int32 meaning = 14;
-
-  // If the value should be excluded from all indexes including those defined
-  // explicitly.
-  bool exclude_from_indexes = 19;
-}
-
-// A Datastore data object.
-//
-// An entity is limited to 1 megabyte when stored. That _roughly_
-// corresponds to a limit of 1 megabyte for the serialized form of this
-// message.
-message Entity {
-  // The entity's key.
-  //
-  // An entity must have a key, unless otherwise documented (for example,
-  // an entity in `Value.entity_value` may have no key).
-  // An entity's kind is its key path's last element's kind,
-  // or null if it has no key.
-  Key key = 1;
-
-  // The entity's properties.
-  // The map's keys are property names.
-  // A property name matching regex `__.*__` is reserved.
-  // A reserved property name is forbidden in certain documented contexts.
-  // The name must not contain more than 500 characters.
-  // The name cannot be `""`.
-  map<string, Value> properties = 3;
-}
diff --git a/google/cloud/datastore/_generated/_query.proto b/google/cloud/datastore/_generated/_query.proto
deleted file mode 100644
index e6dba2b226f9..000000000000
--- a/google/cloud/datastore/_generated/_query.proto
+++ /dev/null
@@ -1,306 +0,0 @@
-// Copyright 2016 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.datastore.v1;
-
-import "google/api/annotations.proto";
-import "google/datastore/v1/entity.proto";
-import "google/protobuf/wrappers.proto";
-import "google/type/latlng.proto";
-
-option java_multiple_files = true;
-option java_outer_classname = "QueryProto";
-option java_package = "com.google.datastore.v1";
-
-
-// The result of fetching an entity from Datastore.
-message EntityResult {
-  // Specifies what data the 'entity' field contains.
-  // A `ResultType` is either implied (for example, in `LookupResponse.missing`
-  // from `datastore.proto`, it is always `KEY_ONLY`) or specified by context
-  // (for example, in message `QueryResultBatch`, field `entity_result_type`
-  // specifies a `ResultType` for all the values in field `entity_results`).
-  enum ResultType {
-    // Unspecified. This value is never used.
-    RESULT_TYPE_UNSPECIFIED = 0;
-
-    // The key and properties.
-    FULL = 1;
-
-    // A projected subset of properties. The entity may have no key.
-    PROJECTION = 2;
-
-    // Only the key.
-    KEY_ONLY = 3;
-  }
-
-  // The resulting entity.
-  Entity entity = 1;
-
-  // 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.
-  //
-  // 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.
-  // Set only when the `EntityResult` is part of a `QueryResultBatch` message.
-  bytes cursor = 3;
-}
-
-// A query for entities.
-message Query {
-  // The projection to return. Defaults to returning all properties.
-  repeated Projection projection = 2;
-
-  // The kinds to query (if empty, returns entities of all kinds).
-  // Currently at most 1 kind may be specified.
-  repeated KindExpression kind = 3;
-
-  // The filter to apply.
-  Filter filter = 4;
-
-  // The order to apply to the query results (if empty, order is unspecified).
-  repeated PropertyOrder order = 5;
-
-  // The properties to make distinct. The query results will contain the first
-  // result for each distinct combination of values for the given properties
-  // (if empty, all results are returned).
-  repeated PropertyReference distinct_on = 6;
-
-  // A starting point for the query results. Query cursors are
-  // returned in query result batches and
-  // [can only be used to continue the same query](https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets).
-  bytes start_cursor = 7;
-
-  // An ending point for the query results. Query cursors are
-  // returned in query result batches and
-  // [can only be used to limit the same query](https://cloud.google.com/datastore/docs/concepts/queries#cursors_limits_and_offsets).
-  bytes end_cursor = 8;
-
-  // The number of results to skip. Applies before limit, but after all other
-  // constraints. Optional. Must be >= 0 if specified.
-  int32 offset = 10;
-
-  // The maximum number of results to return. Applies after all other
-  // constraints. Optional.
-  // Unspecified is interpreted as no limit.
-  // Must be >= 0 if specified.
-  google.protobuf.Int32Value limit = 12;
-}
-
-// A representation of a kind.
-message KindExpression {
-  // The name of the kind.
-  string name = 1;
-}
-
-// A reference to a property relative to the kind expressions.
-message PropertyReference {
-  // The name of the property.
-  // If name includes "."s, it may be interpreted as a property name path.
-  string name = 2;
-}
-
-// A representation of a property in a projection.
-message Projection {
-  // The property to project.
-  PropertyReference property = 1;
-}
-
-// The desired order for a specific property.
-message PropertyOrder {
-  // The sort direction.
-  enum Direction {
-    // Unspecified. This value must not be used.
-    DIRECTION_UNSPECIFIED = 0;
-
-    // Ascending.
-    ASCENDING = 1;
-
-    // Descending.
-    DESCENDING = 2;
-  }
-
-  // The property to order by.
-  PropertyReference property = 1;
-
-  // The direction to order by. Defaults to `ASCENDING`.
-  Direction direction = 2;
-}
-
-// A holder for any type of filter.
-message Filter {
-  // The type of filter.
-  oneof filter_type {
-    // A composite filter.
-    CompositeFilter composite_filter = 1;
-
-    // A filter on a property.
-    PropertyFilter property_filter = 2;
-  }
-}
-
-// A filter that merges multiple other filters using the given operator.
-message CompositeFilter {
-  // A composite filter operator.
-  enum Operator {
-    // Unspecified. This value must not be used.
-    OPERATOR_UNSPECIFIED = 0;
-
-    // The results are required to satisfy each of the combined filters.
-    AND = 1;
-  }
-
-  // The operator for combining multiple filters.
-  Operator op = 1;
-
-  // The list of filters to combine.
-  // Must contain at least one filter.
-  repeated Filter filters = 2;
-}
-
-// A filter on a specific property.
-message PropertyFilter {
-  // A property filter operator.
-  enum Operator {
-    // Unspecified. This value must not be used.
-    OPERATOR_UNSPECIFIED = 0;
-
-    // Less than.
-    LESS_THAN = 1;
-
-    // Less than or equal.
-    LESS_THAN_OR_EQUAL = 2;
-
-    // Greater than.
-    GREATER_THAN = 3;
-
-    // Greater than or equal.
-    GREATER_THAN_OR_EQUAL = 4;
-
-    // Equal.
-    EQUAL = 5;
-
-    // Has ancestor.
-    HAS_ANCESTOR = 11;
-  }
-
-  // The property to filter by.
-  PropertyReference property = 1;
-
-  // The operator to filter by.
-  Operator op = 2;
-
-  // The value to compare the property to.
-  Value value = 3;
-}
-
-// A [GQL query](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
-message GqlQuery {
-  // A string of the format described
-  // [here](https://cloud.google.com/datastore/docs/apis/gql/gql_reference).
-  string query_string = 1;
-
-  // When false, the query string must not contain any literals and instead must
-  // bind all values. For example,
-  // `SELECT * FROM Kind WHERE a = 'string literal'` is not allowed, while
-  // `SELECT * FROM Kind WHERE a = @value` is.
-  bool allow_literals = 2;
-
-  // For each non-reserved named binding site in the query string, there must be
-  // a named parameter with that name, but not necessarily the inverse.
-  //
-  // Key must match regex `[A-Za-z_$][A-Za-z_$0-9]*`, must not match regex
-  // `__.*__`, and must not be `""`.
-  map<string, GqlQueryParameter> named_bindings = 5;
-
-  // Numbered binding site @1 references the first numbered parameter,
-  // effectively using 1-based indexing, rather than the usual 0.
-  //
-  // For each binding site numbered i in `query_string`, there must be an i-th
-  // numbered parameter. The inverse must also be true.
-  repeated GqlQueryParameter positional_bindings = 4;
-}
-
-// A binding parameter for a GQL query.
-message GqlQueryParameter {
-  // The type of parameter.
-  oneof parameter_type {
-    // A value parameter.
-    Value value = 2;
-
-    // A query cursor. Query cursors are returned in query
-    // result batches.
-    bytes cursor = 3;
-  }
-}
-
-// A batch of results produced by a query.
-message QueryResultBatch {
-  // The possible values for the `more_results` field.
-  enum MoreResultsType {
-    // Unspecified. This value is never used.
-    MORE_RESULTS_TYPE_UNSPECIFIED = 0;
-
-    // There may be additional batches to fetch from this query.
-    NOT_FINISHED = 1;
-
-    // The query is finished, but there may be more results after the limit.
-    MORE_RESULTS_AFTER_LIMIT = 2;
-
-    // The query is finished, but there may be more results after the end
-    // cursor.
-    MORE_RESULTS_AFTER_CURSOR = 4;
-
-    // The query has been exhausted.
-    NO_MORE_RESULTS = 3;
-  }
-
-  // The number of results skipped, typically because of an offset.
-  int32 skipped_results = 6;
-
-  // A cursor that points to the position after the last skipped result.
-  // Will be set when `skipped_results` != 0.
-  bytes skipped_cursor = 3;
-
-  // The result type for every entity in `entity_results`.
-  EntityResult.ResultType entity_result_type = 1;
-
-  // The results for this batch.
-  repeated EntityResult entity_results = 2;
-
-  // A cursor that points to the position after the last result in the batch.
-  bytes end_cursor = 4;
-
-  // The state of the query after the current batch.
-  MoreResultsType more_results = 5;
-
-  // The version number of the snapshot this batch was returned from.
-  // This applies to the range of results from the query's `start_cursor` (or
-  // the beginning of the query if no cursor was given) to this batch's
-  // `end_cursor` (not the query's `end_cursor`).
-  //
-  // In a single transaction, subsequent query result batches for the same query
-  // can have a greater snapshot version number. Each batch's snapshot version
-  // is valid for all preceding batches.
-  int64 snapshot_version = 7;
-}
diff --git a/google/cloud/datastore/_generated/datastore_grpc_pb2.py b/google/cloud/datastore/_generated/datastore_grpc_pb2.py
deleted file mode 100644
index beea35710c6c..000000000000
--- a/google/cloud/datastore/_generated/datastore_grpc_pb2.py
+++ /dev/null
@@ -1,301 +0,0 @@
-# BEGIN: Imports from datastore_pb2
-from google.cloud.datastore._generated.datastore_pb2 import AllocateIdsRequest
-from google.cloud.datastore._generated.datastore_pb2 import AllocateIdsResponse
-from google.cloud.datastore._generated.datastore_pb2 import BeginTransactionRequest
-from google.cloud.datastore._generated.datastore_pb2 import BeginTransactionResponse
-from google.cloud.datastore._generated.datastore_pb2 import CommitRequest
-from google.cloud.datastore._generated.datastore_pb2 import CommitResponse
-from google.cloud.datastore._generated.datastore_pb2 import LookupRequest
-from google.cloud.datastore._generated.datastore_pb2 import LookupResponse
-from google.cloud.datastore._generated.datastore_pb2 import Mutation
-from google.cloud.datastore._generated.datastore_pb2 import MutationResult
-from google.cloud.datastore._generated.datastore_pb2 import ReadOptions
-from google.cloud.datastore._generated.datastore_pb2 import RollbackRequest
-from google.cloud.datastore._generated.datastore_pb2 import RollbackResponse
-from google.cloud.datastore._generated.datastore_pb2 import RunQueryRequest
-from google.cloud.datastore._generated.datastore_pb2 import RunQueryResponse
-#   END: Imports from datastore_pb2
-import grpc
-from grpc.beta import implementations as beta_implementations
-from grpc.beta import interfaces as beta_interfaces
-from grpc.framework.common import cardinality
-from grpc.framework.interfaces.face import utilities as face_utilities
-
-
-class DatastoreStub(object):
-  """Each RPC normalizes the partition IDs of the keys in its input entities,
-  and always returns entities with keys with normalized partition IDs.
-  This applies to all keys and entities, including those in values, except keys
-  with both an empty path and an empty or unset partition ID. Normalization of
-  input keys sets the project ID (if not already set) to the project ID from
-  the request.
-
-  """
-
-  def __init__(self, channel):
-    """Constructor.
-
-    Args:
-      channel: A grpc.Channel.
-    """
-    self.Lookup = channel.unary_unary(
-        '/google.datastore.v1.Datastore/Lookup',
-        request_serializer=LookupRequest.SerializeToString,
-        response_deserializer=LookupResponse.FromString,
-        )
-    self.RunQuery = channel.unary_unary(
-        '/google.datastore.v1.Datastore/RunQuery',
-        request_serializer=RunQueryRequest.SerializeToString,
-        response_deserializer=RunQueryResponse.FromString,
-        )
-    self.BeginTransaction = channel.unary_unary(
-        '/google.datastore.v1.Datastore/BeginTransaction',
-        request_serializer=BeginTransactionRequest.SerializeToString,
-        response_deserializer=BeginTransactionResponse.FromString,
-        )
-    self.Commit = channel.unary_unary(
-        '/google.datastore.v1.Datastore/Commit',
-        request_serializer=CommitRequest.SerializeToString,
-        response_deserializer=CommitResponse.FromString,
-        )
-    self.Rollback = channel.unary_unary(
-        '/google.datastore.v1.Datastore/Rollback',
-        request_serializer=RollbackRequest.SerializeToString,
-        response_deserializer=RollbackResponse.FromString,
-        )
-    self.AllocateIds = channel.unary_unary(
-        '/google.datastore.v1.Datastore/AllocateIds',
-        request_serializer=AllocateIdsRequest.SerializeToString,
-        response_deserializer=AllocateIdsResponse.FromString,
-        )
-
-
-class DatastoreServicer(object):
-  """Each RPC normalizes the partition IDs of the keys in its input entities,
-  and always returns entities with keys with normalized partition IDs.
-  This applies to all keys and entities, including those in values, except keys
-  with both an empty path and an empty or unset partition ID. Normalization of
-  input keys sets the project ID (if not already set) to the project ID from
-  the request.
-
-  """
-
-  def Lookup(self, request, context):
-    """Looks up entities by key.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def RunQuery(self, request, context):
-    """Queries for entities.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def BeginTransaction(self, request, context):
-    """Begins a new transaction.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def Commit(self, request, context):
-    """Commits a transaction, optionally creating, deleting or modifying some
-    entities.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def Rollback(self, request, context):
-    """Rolls back a transaction.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-  def AllocateIds(self, request, context):
-    """Allocates IDs for the given keys, which is useful for referencing an entity
-    before it is inserted.
-    """
-    context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-    context.set_details('Method not implemented!')
-    raise NotImplementedError('Method not implemented!')
-
-
-def add_DatastoreServicer_to_server(servicer, server):
-  rpc_method_handlers = {
-      'Lookup': grpc.unary_unary_rpc_method_handler(
-          servicer.Lookup,
-          request_deserializer=LookupRequest.FromString,
-          response_serializer=LookupResponse.SerializeToString,
-      ),
-      'RunQuery': grpc.unary_unary_rpc_method_handler(
-          servicer.RunQuery,
-          request_deserializer=RunQueryRequest.FromString,
-          response_serializer=RunQueryResponse.SerializeToString,
-      ),
-      'BeginTransaction': grpc.unary_unary_rpc_method_handler(
-          servicer.BeginTransaction,
-          request_deserializer=BeginTransactionRequest.FromString,
-          response_serializer=BeginTransactionResponse.SerializeToString,
-      ),
-      'Commit': grpc.unary_unary_rpc_method_handler(
-          servicer.Commit,
-          request_deserializer=CommitRequest.FromString,
-          response_serializer=CommitResponse.SerializeToString,
-      ),
-      'Rollback': grpc.unary_unary_rpc_method_handler(
-          servicer.Rollback,
-          request_deserializer=RollbackRequest.FromString,
-          response_serializer=RollbackResponse.SerializeToString,
-      ),
-      'AllocateIds': grpc.unary_unary_rpc_method_handler(
-          servicer.AllocateIds,
-          request_deserializer=AllocateIdsRequest.FromString,
-          response_serializer=AllocateIdsResponse.SerializeToString,
-      ),
-  }
-  generic_handler = grpc.method_handlers_generic_handler(
-      'google.datastore.v1.Datastore', rpc_method_handlers)
-  server.add_generic_rpc_handlers((generic_handler,))
-
-
-class BetaDatastoreServicer(object):
-  """Each RPC normalizes the partition IDs of the keys in its input entities,
-  and always returns entities with keys with normalized partition IDs.
-  This applies to all keys and entities, including those in values, except keys
-  with both an empty path and an empty or unset partition ID. Normalization of
-  input keys sets the project ID (if not already set) to the project ID from
-  the request.
-
-  """
-  def Lookup(self, request, context):
-    """Looks up entities by key.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def RunQuery(self, request, context):
-    """Queries for entities.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def BeginTransaction(self, request, context):
-    """Begins a new transaction.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def Commit(self, request, context):
-    """Commits a transaction, optionally creating, deleting or modifying some
-    entities.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def Rollback(self, request, context):
-    """Rolls back a transaction.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-  def AllocateIds(self, request, context):
-    """Allocates IDs for the given keys, which is useful for referencing an entity
-    before it is inserted.
-    """
-    context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)
-
-
-class BetaDatastoreStub(object):
-  """Each RPC normalizes the partition IDs of the keys in its input entities,
-  and always returns entities with keys with normalized partition IDs.
-  This applies to all keys and entities, including those in values, except keys
-  with both an empty path and an empty or unset partition ID. Normalization of
-  input keys sets the project ID (if not already set) to the project ID from
-  the request.
-
-  """
-  def Lookup(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Looks up entities by key.
-    """
-    raise NotImplementedError()
-  Lookup.future = None
-  def RunQuery(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Queries for entities.
-    """
-    raise NotImplementedError()
-  RunQuery.future = None
-  def BeginTransaction(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Begins a new transaction.
-    """
-    raise NotImplementedError()
-  BeginTransaction.future = None
-  def Commit(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Commits a transaction, optionally creating, deleting or modifying some
-    entities.
-    """
-    raise NotImplementedError()
-  Commit.future = None
-  def Rollback(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Rolls back a transaction.
-    """
-    raise NotImplementedError()
-  Rollback.future = None
-  def AllocateIds(self, request, timeout, metadata=None, with_call=False, protocol_options=None):
-    """Allocates IDs for the given keys, which is useful for referencing an entity
-    before it is inserted.
-    """
-    raise NotImplementedError()
-  AllocateIds.future = None
-
-
-def beta_create_Datastore_server(servicer, pool=None, pool_size=None, default_timeout=None, maximum_timeout=None):
-  request_deserializers = {
-    ('google.datastore.v1.Datastore', 'AllocateIds'): AllocateIdsRequest.FromString,
-    ('google.datastore.v1.Datastore', 'BeginTransaction'): BeginTransactionRequest.FromString,
-    ('google.datastore.v1.Datastore', 'Commit'): CommitRequest.FromString,
-    ('google.datastore.v1.Datastore', 'Lookup'): LookupRequest.FromString,
-    ('google.datastore.v1.Datastore', 'Rollback'): RollbackRequest.FromString,
-    ('google.datastore.v1.Datastore', 'RunQuery'): RunQueryRequest.FromString,
-  }
-  response_serializers = {
-    ('google.datastore.v1.Datastore', 'AllocateIds'): AllocateIdsResponse.SerializeToString,
-    ('google.datastore.v1.Datastore', 'BeginTransaction'): BeginTransactionResponse.SerializeToString,
-    ('google.datastore.v1.Datastore', 'Commit'): CommitResponse.SerializeToString,
-    ('google.datastore.v1.Datastore', 'Lookup'): LookupResponse.SerializeToString,
-    ('google.datastore.v1.Datastore', 'Rollback'): RollbackResponse.SerializeToString,
-    ('google.datastore.v1.Datastore', 'RunQuery'): RunQueryResponse.SerializeToString,
-  }
-  method_implementations = {
-    ('google.datastore.v1.Datastore', 'AllocateIds'): face_utilities.unary_unary_inline(servicer.AllocateIds),
-    ('google.datastore.v1.Datastore', 'BeginTransaction'): face_utilities.unary_unary_inline(servicer.BeginTransaction),
-    ('google.datastore.v1.Datastore', 'Commit'): face_utilities.unary_unary_inline(servicer.Commit),
-    ('google.datastore.v1.Datastore', 'Lookup'): face_utilities.unary_unary_inline(servicer.Lookup),
-    ('google.datastore.v1.Datastore', 'Rollback'): face_utilities.unary_unary_inline(servicer.Rollback),
-    ('google.datastore.v1.Datastore', 'RunQuery'): face_utilities.unary_unary_inline(servicer.RunQuery),
-  }
-  server_options = beta_implementations.server_options(request_deserializers=request_deserializers, response_serializers=response_serializers, thread_pool=pool, thread_pool_size=pool_size, default_timeout=default_timeout, maximum_timeout=maximum_timeout)
-  return beta_implementations.server(method_implementations, options=server_options)
-
-
-def beta_create_Datastore_stub(channel, host=None, metadata_transformer=None, pool=None, pool_size=None):
-  request_serializers = {
-    ('google.datastore.v1.Datastore', 'AllocateIds'): AllocateIdsRequest.SerializeToString,
-    ('google.datastore.v1.Datastore', 'BeginTransaction'): BeginTransactionRequest.SerializeToString,
-    ('google.datastore.v1.Datastore', 'Commit'): CommitRequest.SerializeToString,
-    ('google.datastore.v1.Datastore', 'Lookup'): LookupRequest.SerializeToString,
-    ('google.datastore.v1.Datastore', 'Rollback'): RollbackRequest.SerializeToString,
-    ('google.datastore.v1.Datastore', 'RunQuery'): RunQueryRequest.SerializeToString,
-  }
-  response_deserializers = {
-    ('google.datastore.v1.Datastore', 'AllocateIds'): AllocateIdsResponse.FromString,
-    ('google.datastore.v1.Datastore', 'BeginTransaction'): BeginTransactionResponse.FromString,
-    ('google.datastore.v1.Datastore', 'Commit'): CommitResponse.FromString,
-    ('google.datastore.v1.Datastore', 'Lookup'): LookupResponse.FromString,
-    ('google.datastore.v1.Datastore', 'Rollback'): RollbackResponse.FromString,
-    ('google.datastore.v1.Datastore', 'RunQuery'): RunQueryResponse.FromString,
-  }
-  cardinalities = {
-    'AllocateIds': cardinality.Cardinality.UNARY_UNARY,
-    'BeginTransaction': cardinality.Cardinality.UNARY_UNARY,
-    'Commit': cardinality.Cardinality.UNARY_UNARY,
-    'Lookup': cardinality.Cardinality.UNARY_UNARY,
-    'Rollback': cardinality.Cardinality.UNARY_UNARY,
-    'RunQuery': cardinality.Cardinality.UNARY_UNARY,
-  }
-  stub_options = beta_implementations.stub_options(host=host, metadata_transformer=metadata_transformer, request_serializers=request_serializers, response_deserializers=response_deserializers, thread_pool=pool, thread_pool_size=pool_size)
-  return beta_implementations.dynamic_stub(channel, 'google.datastore.v1.Datastore', cardinalities, options=stub_options)
diff --git a/google/cloud/datastore/_generated/datastore_pb2.py b/google/cloud/datastore/_generated/datastore_pb2.py
deleted file mode 100644
index f7a321a5c6b8..000000000000
--- a/google/cloud/datastore/_generated/datastore_pb2.py
+++ /dev/null
@@ -1,891 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/datastore/v1/datastore.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.cloud.datastore._generated import entity_pb2 as google_dot_datastore_dot_v1_dot_entity__pb2
-from google.cloud.datastore._generated import query_pb2 as google_dot_datastore_dot_v1_dot_query__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/datastore/v1/datastore.proto',
-  package='google.datastore.v1',
-  syntax='proto3',
-  serialized_pb=_b('\n#google/datastore/v1/datastore.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a google/datastore/v1/entity.proto\x1a\x1fgoogle/datastore/v1/query.proto\"\x83\x01\n\rLookupRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12&\n\x04keys\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key\"\xa2\x01\n\x0eLookupResponse\x12\x30\n\x05\x66ound\x18\x01 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x32\n\x07missing\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12*\n\x08\x64\x65\x66\x65rred\x18\x03 \x03(\x0b\x32\x18.google.datastore.v1.Key\"\x84\x02\n\x0fRunQueryRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x36\n\x0cpartition_id\x18\x02 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x36\n\x0cread_options\x18\x01 \x01(\x0b\x32 .google.datastore.v1.ReadOptions\x12+\n\x05query\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.QueryH\x00\x12\x32\n\tgql_query\x18\x07 \x01(\x0b\x32\x1d.google.datastore.v1.GqlQueryH\x00\x42\x0c\n\nquery_type\"s\n\x10RunQueryResponse\x12\x34\n\x05\x62\x61tch\x18\x01 \x01(\x0b\x32%.google.datastore.v1.QueryResultBatch\x12)\n\x05query\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Query\"-\n\x17\x42\x65ginTransactionRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\"/\n\x18\x42\x65ginTransactionResponse\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c\":\n\x0fRollbackRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x13\n\x0btransaction\x18\x01 \x01(\x0c\"\x12\n\x10RollbackResponse\"\x83\x02\n\rCommitRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12\x35\n\x04mode\x18\x05 \x01(\x0e\x32\'.google.datastore.v1.CommitRequest.Mode\x12\x15\n\x0btransaction\x18\x01 \x01(\x0cH\x00\x12\x30\n\tmutations\x18\x06 \x03(\x0b\x32\x1d.google.datastore.v1.Mutation\"F\n\x04Mode\x12\x14\n\x10MODE_UNSPECIFIED\x10\x00\x12\x11\n\rTRANSACTIONAL\x10\x01\x12\x15\n\x11NON_TRANSACTIONAL\x10\x02\x42\x16\n\x14transaction_selector\"f\n\x0e\x43ommitResponse\x12=\n\x10mutation_results\x18\x03 \x03(\x0b\x32#.google.datastore.v1.MutationResult\x12\x15\n\rindex_updates\x18\x04 \x01(\x05\"P\n\x12\x41llocateIdsRequest\x12\x12\n\nproject_id\x18\x08 \x01(\t\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key\"=\n\x13\x41llocateIdsResponse\x12&\n\x04keys\x18\x01 \x03(\x0b\x32\x18.google.datastore.v1.Key\"\x87\x02\n\x08Mutation\x12-\n\x06insert\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06update\x18\x05 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12-\n\x06upsert\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12*\n\x06\x64\x65lete\x18\x07 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0c\x62\x61se_version\x18\x08 \x01(\x03H\x01\x42\x0b\n\toperationB\x1d\n\x1b\x63onflict_detection_strategy\"c\n\x0eMutationResult\x12%\n\x03key\x18\x03 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12\x19\n\x11\x63onflict_detected\x18\x05 \x01(\x08\"\xd5\x01\n\x0bReadOptions\x12L\n\x10read_consistency\x18\x01 \x01(\x0e\x32\x30.google.datastore.v1.ReadOptions.ReadConsistencyH\x00\x12\x15\n\x0btransaction\x18\x02 \x01(\x0cH\x00\"M\n\x0fReadConsistency\x12 \n\x1cREAD_CONSISTENCY_UNSPECIFIED\x10\x00\x12\n\n\x06STRONG\x10\x01\x12\x0c\n\x08\x45VENTUAL\x10\x02\x42\x12\n\x10\x63onsistency_type2\xdb\x06\n\tDatastore\x12~\n\x06Lookup\x12\".google.datastore.v1.LookupRequest\x1a#.google.datastore.v1.LookupResponse\"+\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:lookup:\x01*\x12\x86\x01\n\x08RunQuery\x12$.google.datastore.v1.RunQueryRequest\x1a%.google.datastore.v1.RunQueryResponse\"-\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:runQuery:\x01*\x12\xa6\x01\n\x10\x42\x65ginTransaction\x12,.google.datastore.v1.BeginTransactionRequest\x1a-.google.datastore.v1.BeginTransactionResponse\"5\x82\xd3\xe4\x93\x02/\"*/v1/projects/{project_id}:beginTransaction:\x01*\x12~\n\x06\x43ommit\x12\".google.datastore.v1.CommitRequest\x1a#.google.datastore.v1.CommitResponse\"+\x82\xd3\xe4\x93\x02%\" /v1/projects/{project_id}:commit:\x01*\x12\x86\x01\n\x08Rollback\x12$.google.datastore.v1.RollbackRequest\x1a%.google.datastore.v1.RollbackResponse\"-\x82\xd3\xe4\x93\x02\'\"\"/v1/projects/{project_id}:rollback:\x01*\x12\x92\x01\n\x0b\x41llocateIds\x12\'.google.datastore.v1.AllocateIdsRequest\x1a(.google.datastore.v1.AllocateIdsResponse\"0\x82\xd3\xe4\x93\x02*\"%/v1/projects/{project_id}:allocateIds:\x01*B+\n\x17\x63om.google.datastore.v1B\x0e\x44\x61tastoreProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_datastore_dot_v1_dot_entity__pb2.DESCRIPTOR,google_dot_datastore_dot_v1_dot_query__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-_COMMITREQUEST_MODE = _descriptor.EnumDescriptor(
-  name='Mode',
-  full_name='google.datastore.v1.CommitRequest.Mode',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='MODE_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='TRANSACTIONAL', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='NON_TRANSACTIONAL', index=2, number=2,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=1178,
-  serialized_end=1248,
-)
-_sym_db.RegisterEnumDescriptor(_COMMITREQUEST_MODE)
-
-_READOPTIONS_READCONSISTENCY = _descriptor.EnumDescriptor(
-  name='ReadConsistency',
-  full_name='google.datastore.v1.ReadOptions.ReadConsistency',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='READ_CONSISTENCY_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='STRONG', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='EVENTUAL', index=2, number=2,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=2007,
-  serialized_end=2084,
-)
-_sym_db.RegisterEnumDescriptor(_READOPTIONS_READCONSISTENCY)
-
-
-_LOOKUPREQUEST = _descriptor.Descriptor(
-  name='LookupRequest',
-  full_name='google.datastore.v1.LookupRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.LookupRequest.project_id', index=0,
-      number=8, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='read_options', full_name='google.datastore.v1.LookupRequest.read_options', index=1,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='keys', full_name='google.datastore.v1.LookupRequest.keys', index=2,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=158,
-  serialized_end=289,
-)
-
-
-_LOOKUPRESPONSE = _descriptor.Descriptor(
-  name='LookupResponse',
-  full_name='google.datastore.v1.LookupResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='found', full_name='google.datastore.v1.LookupResponse.found', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='missing', full_name='google.datastore.v1.LookupResponse.missing', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='deferred', full_name='google.datastore.v1.LookupResponse.deferred', index=2,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=292,
-  serialized_end=454,
-)
-
-
-_RUNQUERYREQUEST = _descriptor.Descriptor(
-  name='RunQueryRequest',
-  full_name='google.datastore.v1.RunQueryRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.RunQueryRequest.project_id', index=0,
-      number=8, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='partition_id', full_name='google.datastore.v1.RunQueryRequest.partition_id', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='read_options', full_name='google.datastore.v1.RunQueryRequest.read_options', index=2,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='query', full_name='google.datastore.v1.RunQueryRequest.query', index=3,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='gql_query', full_name='google.datastore.v1.RunQueryRequest.gql_query', index=4,
-      number=7, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='query_type', full_name='google.datastore.v1.RunQueryRequest.query_type',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=457,
-  serialized_end=717,
-)
-
-
-_RUNQUERYRESPONSE = _descriptor.Descriptor(
-  name='RunQueryResponse',
-  full_name='google.datastore.v1.RunQueryResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='batch', full_name='google.datastore.v1.RunQueryResponse.batch', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='query', full_name='google.datastore.v1.RunQueryResponse.query', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=719,
-  serialized_end=834,
-)
-
-
-_BEGINTRANSACTIONREQUEST = _descriptor.Descriptor(
-  name='BeginTransactionRequest',
-  full_name='google.datastore.v1.BeginTransactionRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.BeginTransactionRequest.project_id', index=0,
-      number=8, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=836,
-  serialized_end=881,
-)
-
-
-_BEGINTRANSACTIONRESPONSE = _descriptor.Descriptor(
-  name='BeginTransactionResponse',
-  full_name='google.datastore.v1.BeginTransactionResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='transaction', full_name='google.datastore.v1.BeginTransactionResponse.transaction', index=0,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=883,
-  serialized_end=930,
-)
-
-
-_ROLLBACKREQUEST = _descriptor.Descriptor(
-  name='RollbackRequest',
-  full_name='google.datastore.v1.RollbackRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.RollbackRequest.project_id', index=0,
-      number=8, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='transaction', full_name='google.datastore.v1.RollbackRequest.transaction', index=1,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=932,
-  serialized_end=990,
-)
-
-
-_ROLLBACKRESPONSE = _descriptor.Descriptor(
-  name='RollbackResponse',
-  full_name='google.datastore.v1.RollbackResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=992,
-  serialized_end=1010,
-)
-
-
-_COMMITREQUEST = _descriptor.Descriptor(
-  name='CommitRequest',
-  full_name='google.datastore.v1.CommitRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.CommitRequest.project_id', index=0,
-      number=8, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='mode', full_name='google.datastore.v1.CommitRequest.mode', index=1,
-      number=5, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='transaction', full_name='google.datastore.v1.CommitRequest.transaction', index=2,
-      number=1, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='mutations', full_name='google.datastore.v1.CommitRequest.mutations', index=3,
-      number=6, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _COMMITREQUEST_MODE,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='transaction_selector', full_name='google.datastore.v1.CommitRequest.transaction_selector',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=1013,
-  serialized_end=1272,
-)
-
-
-_COMMITRESPONSE = _descriptor.Descriptor(
-  name='CommitResponse',
-  full_name='google.datastore.v1.CommitResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='mutation_results', full_name='google.datastore.v1.CommitResponse.mutation_results', index=0,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='index_updates', full_name='google.datastore.v1.CommitResponse.index_updates', index=1,
-      number=4, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1274,
-  serialized_end=1376,
-)
-
-
-_ALLOCATEIDSREQUEST = _descriptor.Descriptor(
-  name='AllocateIdsRequest',
-  full_name='google.datastore.v1.AllocateIdsRequest',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.AllocateIdsRequest.project_id', index=0,
-      number=8, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='keys', full_name='google.datastore.v1.AllocateIdsRequest.keys', index=1,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1378,
-  serialized_end=1458,
-)
-
-
-_ALLOCATEIDSRESPONSE = _descriptor.Descriptor(
-  name='AllocateIdsResponse',
-  full_name='google.datastore.v1.AllocateIdsResponse',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='keys', full_name='google.datastore.v1.AllocateIdsResponse.keys', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1460,
-  serialized_end=1521,
-)
-
-
-_MUTATION = _descriptor.Descriptor(
-  name='Mutation',
-  full_name='google.datastore.v1.Mutation',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='insert', full_name='google.datastore.v1.Mutation.insert', index=0,
-      number=4, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='update', full_name='google.datastore.v1.Mutation.update', index=1,
-      number=5, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='upsert', full_name='google.datastore.v1.Mutation.upsert', index=2,
-      number=6, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='delete', full_name='google.datastore.v1.Mutation.delete', index=3,
-      number=7, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='base_version', full_name='google.datastore.v1.Mutation.base_version', index=4,
-      number=8, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='operation', full_name='google.datastore.v1.Mutation.operation',
-      index=0, containing_type=None, fields=[]),
-    _descriptor.OneofDescriptor(
-      name='conflict_detection_strategy', full_name='google.datastore.v1.Mutation.conflict_detection_strategy',
-      index=1, containing_type=None, fields=[]),
-  ],
-  serialized_start=1524,
-  serialized_end=1787,
-)
-
-
-_MUTATIONRESULT = _descriptor.Descriptor(
-  name='MutationResult',
-  full_name='google.datastore.v1.MutationResult',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.datastore.v1.MutationResult.key', index=0,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='version', full_name='google.datastore.v1.MutationResult.version', index=1,
-      number=4, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='conflict_detected', full_name='google.datastore.v1.MutationResult.conflict_detected', index=2,
-      number=5, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1789,
-  serialized_end=1888,
-)
-
-
-_READOPTIONS = _descriptor.Descriptor(
-  name='ReadOptions',
-  full_name='google.datastore.v1.ReadOptions',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='read_consistency', full_name='google.datastore.v1.ReadOptions.read_consistency', index=0,
-      number=1, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='transaction', full_name='google.datastore.v1.ReadOptions.transaction', index=1,
-      number=2, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _READOPTIONS_READCONSISTENCY,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='consistency_type', full_name='google.datastore.v1.ReadOptions.consistency_type',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=1891,
-  serialized_end=2104,
-)
-
-_LOOKUPREQUEST.fields_by_name['read_options'].message_type = _READOPTIONS
-_LOOKUPREQUEST.fields_by_name['keys'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._KEY
-_LOOKUPRESPONSE.fields_by_name['found'].message_type = google_dot_datastore_dot_v1_dot_query__pb2._ENTITYRESULT
-_LOOKUPRESPONSE.fields_by_name['missing'].message_type = google_dot_datastore_dot_v1_dot_query__pb2._ENTITYRESULT
-_LOOKUPRESPONSE.fields_by_name['deferred'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._KEY
-_RUNQUERYREQUEST.fields_by_name['partition_id'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._PARTITIONID
-_RUNQUERYREQUEST.fields_by_name['read_options'].message_type = _READOPTIONS
-_RUNQUERYREQUEST.fields_by_name['query'].message_type = google_dot_datastore_dot_v1_dot_query__pb2._QUERY
-_RUNQUERYREQUEST.fields_by_name['gql_query'].message_type = google_dot_datastore_dot_v1_dot_query__pb2._GQLQUERY
-_RUNQUERYREQUEST.oneofs_by_name['query_type'].fields.append(
-  _RUNQUERYREQUEST.fields_by_name['query'])
-_RUNQUERYREQUEST.fields_by_name['query'].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name['query_type']
-_RUNQUERYREQUEST.oneofs_by_name['query_type'].fields.append(
-  _RUNQUERYREQUEST.fields_by_name['gql_query'])
-_RUNQUERYREQUEST.fields_by_name['gql_query'].containing_oneof = _RUNQUERYREQUEST.oneofs_by_name['query_type']
-_RUNQUERYRESPONSE.fields_by_name['batch'].message_type = google_dot_datastore_dot_v1_dot_query__pb2._QUERYRESULTBATCH
-_RUNQUERYRESPONSE.fields_by_name['query'].message_type = google_dot_datastore_dot_v1_dot_query__pb2._QUERY
-_COMMITREQUEST.fields_by_name['mode'].enum_type = _COMMITREQUEST_MODE
-_COMMITREQUEST.fields_by_name['mutations'].message_type = _MUTATION
-_COMMITREQUEST_MODE.containing_type = _COMMITREQUEST
-_COMMITREQUEST.oneofs_by_name['transaction_selector'].fields.append(
-  _COMMITREQUEST.fields_by_name['transaction'])
-_COMMITREQUEST.fields_by_name['transaction'].containing_oneof = _COMMITREQUEST.oneofs_by_name['transaction_selector']
-_COMMITRESPONSE.fields_by_name['mutation_results'].message_type = _MUTATIONRESULT
-_ALLOCATEIDSREQUEST.fields_by_name['keys'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._KEY
-_ALLOCATEIDSRESPONSE.fields_by_name['keys'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._KEY
-_MUTATION.fields_by_name['insert'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._ENTITY
-_MUTATION.fields_by_name['update'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._ENTITY
-_MUTATION.fields_by_name['upsert'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._ENTITY
-_MUTATION.fields_by_name['delete'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._KEY
-_MUTATION.oneofs_by_name['operation'].fields.append(
-  _MUTATION.fields_by_name['insert'])
-_MUTATION.fields_by_name['insert'].containing_oneof = _MUTATION.oneofs_by_name['operation']
-_MUTATION.oneofs_by_name['operation'].fields.append(
-  _MUTATION.fields_by_name['update'])
-_MUTATION.fields_by_name['update'].containing_oneof = _MUTATION.oneofs_by_name['operation']
-_MUTATION.oneofs_by_name['operation'].fields.append(
-  _MUTATION.fields_by_name['upsert'])
-_MUTATION.fields_by_name['upsert'].containing_oneof = _MUTATION.oneofs_by_name['operation']
-_MUTATION.oneofs_by_name['operation'].fields.append(
-  _MUTATION.fields_by_name['delete'])
-_MUTATION.fields_by_name['delete'].containing_oneof = _MUTATION.oneofs_by_name['operation']
-_MUTATION.oneofs_by_name['conflict_detection_strategy'].fields.append(
-  _MUTATION.fields_by_name['base_version'])
-_MUTATION.fields_by_name['base_version'].containing_oneof = _MUTATION.oneofs_by_name['conflict_detection_strategy']
-_MUTATIONRESULT.fields_by_name['key'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._KEY
-_READOPTIONS.fields_by_name['read_consistency'].enum_type = _READOPTIONS_READCONSISTENCY
-_READOPTIONS_READCONSISTENCY.containing_type = _READOPTIONS
-_READOPTIONS.oneofs_by_name['consistency_type'].fields.append(
-  _READOPTIONS.fields_by_name['read_consistency'])
-_READOPTIONS.fields_by_name['read_consistency'].containing_oneof = _READOPTIONS.oneofs_by_name['consistency_type']
-_READOPTIONS.oneofs_by_name['consistency_type'].fields.append(
-  _READOPTIONS.fields_by_name['transaction'])
-_READOPTIONS.fields_by_name['transaction'].containing_oneof = _READOPTIONS.oneofs_by_name['consistency_type']
-DESCRIPTOR.message_types_by_name['LookupRequest'] = _LOOKUPREQUEST
-DESCRIPTOR.message_types_by_name['LookupResponse'] = _LOOKUPRESPONSE
-DESCRIPTOR.message_types_by_name['RunQueryRequest'] = _RUNQUERYREQUEST
-DESCRIPTOR.message_types_by_name['RunQueryResponse'] = _RUNQUERYRESPONSE
-DESCRIPTOR.message_types_by_name['BeginTransactionRequest'] = _BEGINTRANSACTIONREQUEST
-DESCRIPTOR.message_types_by_name['BeginTransactionResponse'] = _BEGINTRANSACTIONRESPONSE
-DESCRIPTOR.message_types_by_name['RollbackRequest'] = _ROLLBACKREQUEST
-DESCRIPTOR.message_types_by_name['RollbackResponse'] = _ROLLBACKRESPONSE
-DESCRIPTOR.message_types_by_name['CommitRequest'] = _COMMITREQUEST
-DESCRIPTOR.message_types_by_name['CommitResponse'] = _COMMITRESPONSE
-DESCRIPTOR.message_types_by_name['AllocateIdsRequest'] = _ALLOCATEIDSREQUEST
-DESCRIPTOR.message_types_by_name['AllocateIdsResponse'] = _ALLOCATEIDSRESPONSE
-DESCRIPTOR.message_types_by_name['Mutation'] = _MUTATION
-DESCRIPTOR.message_types_by_name['MutationResult'] = _MUTATIONRESULT
-DESCRIPTOR.message_types_by_name['ReadOptions'] = _READOPTIONS
-
-LookupRequest = _reflection.GeneratedProtocolMessageType('LookupRequest', (_message.Message,), dict(
-  DESCRIPTOR = _LOOKUPREQUEST,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.LookupRequest)
-  ))
-_sym_db.RegisterMessage(LookupRequest)
-
-LookupResponse = _reflection.GeneratedProtocolMessageType('LookupResponse', (_message.Message,), dict(
-  DESCRIPTOR = _LOOKUPRESPONSE,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.LookupResponse)
-  ))
-_sym_db.RegisterMessage(LookupResponse)
-
-RunQueryRequest = _reflection.GeneratedProtocolMessageType('RunQueryRequest', (_message.Message,), dict(
-  DESCRIPTOR = _RUNQUERYREQUEST,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.RunQueryRequest)
-  ))
-_sym_db.RegisterMessage(RunQueryRequest)
-
-RunQueryResponse = _reflection.GeneratedProtocolMessageType('RunQueryResponse', (_message.Message,), dict(
-  DESCRIPTOR = _RUNQUERYRESPONSE,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.RunQueryResponse)
-  ))
-_sym_db.RegisterMessage(RunQueryResponse)
-
-BeginTransactionRequest = _reflection.GeneratedProtocolMessageType('BeginTransactionRequest', (_message.Message,), dict(
-  DESCRIPTOR = _BEGINTRANSACTIONREQUEST,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.BeginTransactionRequest)
-  ))
-_sym_db.RegisterMessage(BeginTransactionRequest)
-
-BeginTransactionResponse = _reflection.GeneratedProtocolMessageType('BeginTransactionResponse', (_message.Message,), dict(
-  DESCRIPTOR = _BEGINTRANSACTIONRESPONSE,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.BeginTransactionResponse)
-  ))
-_sym_db.RegisterMessage(BeginTransactionResponse)
-
-RollbackRequest = _reflection.GeneratedProtocolMessageType('RollbackRequest', (_message.Message,), dict(
-  DESCRIPTOR = _ROLLBACKREQUEST,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.RollbackRequest)
-  ))
-_sym_db.RegisterMessage(RollbackRequest)
-
-RollbackResponse = _reflection.GeneratedProtocolMessageType('RollbackResponse', (_message.Message,), dict(
-  DESCRIPTOR = _ROLLBACKRESPONSE,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.RollbackResponse)
-  ))
-_sym_db.RegisterMessage(RollbackResponse)
-
-CommitRequest = _reflection.GeneratedProtocolMessageType('CommitRequest', (_message.Message,), dict(
-  DESCRIPTOR = _COMMITREQUEST,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.CommitRequest)
-  ))
-_sym_db.RegisterMessage(CommitRequest)
-
-CommitResponse = _reflection.GeneratedProtocolMessageType('CommitResponse', (_message.Message,), dict(
-  DESCRIPTOR = _COMMITRESPONSE,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.CommitResponse)
-  ))
-_sym_db.RegisterMessage(CommitResponse)
-
-AllocateIdsRequest = _reflection.GeneratedProtocolMessageType('AllocateIdsRequest', (_message.Message,), dict(
-  DESCRIPTOR = _ALLOCATEIDSREQUEST,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.AllocateIdsRequest)
-  ))
-_sym_db.RegisterMessage(AllocateIdsRequest)
-
-AllocateIdsResponse = _reflection.GeneratedProtocolMessageType('AllocateIdsResponse', (_message.Message,), dict(
-  DESCRIPTOR = _ALLOCATEIDSRESPONSE,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.AllocateIdsResponse)
-  ))
-_sym_db.RegisterMessage(AllocateIdsResponse)
-
-Mutation = _reflection.GeneratedProtocolMessageType('Mutation', (_message.Message,), dict(
-  DESCRIPTOR = _MUTATION,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Mutation)
-  ))
-_sym_db.RegisterMessage(Mutation)
-
-MutationResult = _reflection.GeneratedProtocolMessageType('MutationResult', (_message.Message,), dict(
-  DESCRIPTOR = _MUTATIONRESULT,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.MutationResult)
-  ))
-_sym_db.RegisterMessage(MutationResult)
-
-ReadOptions = _reflection.GeneratedProtocolMessageType('ReadOptions', (_message.Message,), dict(
-  DESCRIPTOR = _READOPTIONS,
-  __module__ = 'google.datastore.v1.datastore_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.ReadOptions)
-  ))
-_sym_db.RegisterMessage(ReadOptions)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\027com.google.datastore.v1B\016DatastoreProtoP\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/datastore/_generated/entity_pb2.py b/google/cloud/datastore/_generated/entity_pb2.py
deleted file mode 100644
index 44d530bdb74a..000000000000
--- a/google/cloud/datastore/_generated/entity_pb2.py
+++ /dev/null
@@ -1,495 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/datastore/v1/entity.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
-from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
-from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/datastore/v1/entity.proto',
-  package='google.datastore.v1',
-  syntax='proto3',
-  serialized_pb=_b('\n google/datastore/v1/entity.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x18google/type/latlng.proto\"7\n\x0bPartitionId\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12\x14\n\x0cnamespace_id\x18\x04 \x01(\t\"\xb7\x01\n\x03Key\x12\x36\n\x0cpartition_id\x18\x01 \x01(\x0b\x32 .google.datastore.v1.PartitionId\x12\x32\n\x04path\x18\x02 \x03(\x0b\x32$.google.datastore.v1.Key.PathElement\x1a\x44\n\x0bPathElement\x12\x0c\n\x04kind\x18\x01 \x01(\t\x12\x0c\n\x02id\x18\x02 \x01(\x03H\x00\x12\x0e\n\x04name\x18\x03 \x01(\tH\x00\x42\t\n\x07id_type\"8\n\nArrayValue\x12*\n\x06values\x18\x01 \x03(\x0b\x32\x1a.google.datastore.v1.Value\"\xf1\x03\n\x05Value\x12\x30\n\nnull_value\x18\x0b \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00\x12\x17\n\rboolean_value\x18\x01 \x01(\x08H\x00\x12\x17\n\rinteger_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x35\n\x0ftimestamp_value\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12-\n\tkey_value\x18\x05 \x01(\x0b\x32\x18.google.datastore.v1.KeyH\x00\x12\x16\n\x0cstring_value\x18\x11 \x01(\tH\x00\x12\x14\n\nblob_value\x18\x12 \x01(\x0cH\x00\x12.\n\x0fgeo_point_value\x18\x08 \x01(\x0b\x32\x13.google.type.LatLngH\x00\x12\x33\n\x0c\x65ntity_value\x18\x06 \x01(\x0b\x32\x1b.google.datastore.v1.EntityH\x00\x12\x36\n\x0b\x61rray_value\x18\t \x01(\x0b\x32\x1f.google.datastore.v1.ArrayValueH\x00\x12\x0f\n\x07meaning\x18\x0e \x01(\x05\x12\x1c\n\x14\x65xclude_from_indexes\x18\x13 \x01(\x08\x42\x0c\n\nvalue_type\"\xbf\x01\n\x06\x45ntity\x12%\n\x03key\x18\x01 \x01(\x0b\x32\x18.google.datastore.v1.Key\x12?\n\nproperties\x18\x03 \x03(\x0b\x32+.google.datastore.v1.Entity.PropertiesEntry\x1aM\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12)\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.Value:\x02\x38\x01\x42(\n\x17\x63om.google.datastore.v1B\x0b\x45ntityProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,google_dot_type_dot_latlng__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-
-_PARTITIONID = _descriptor.Descriptor(
-  name='PartitionId',
-  full_name='google.datastore.v1.PartitionId',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='project_id', full_name='google.datastore.v1.PartitionId.project_id', index=0,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='namespace_id', full_name='google.datastore.v1.PartitionId.namespace_id', index=1,
-      number=4, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=176,
-  serialized_end=231,
-)
-
-
-_KEY_PATHELEMENT = _descriptor.Descriptor(
-  name='PathElement',
-  full_name='google.datastore.v1.Key.PathElement',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='kind', full_name='google.datastore.v1.Key.PathElement.kind', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='id', full_name='google.datastore.v1.Key.PathElement.id', index=1,
-      number=2, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.datastore.v1.Key.PathElement.name', index=2,
-      number=3, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='id_type', full_name='google.datastore.v1.Key.PathElement.id_type',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=349,
-  serialized_end=417,
-)
-
-_KEY = _descriptor.Descriptor(
-  name='Key',
-  full_name='google.datastore.v1.Key',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='partition_id', full_name='google.datastore.v1.Key.partition_id', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='path', full_name='google.datastore.v1.Key.path', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_KEY_PATHELEMENT, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=234,
-  serialized_end=417,
-)
-
-
-_ARRAYVALUE = _descriptor.Descriptor(
-  name='ArrayValue',
-  full_name='google.datastore.v1.ArrayValue',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='values', full_name='google.datastore.v1.ArrayValue.values', index=0,
-      number=1, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=419,
-  serialized_end=475,
-)
-
-
-_VALUE = _descriptor.Descriptor(
-  name='Value',
-  full_name='google.datastore.v1.Value',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='null_value', full_name='google.datastore.v1.Value.null_value', index=0,
-      number=11, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='boolean_value', full_name='google.datastore.v1.Value.boolean_value', index=1,
-      number=1, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='integer_value', full_name='google.datastore.v1.Value.integer_value', index=2,
-      number=2, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='double_value', full_name='google.datastore.v1.Value.double_value', index=3,
-      number=3, type=1, cpp_type=5, label=1,
-      has_default_value=False, default_value=float(0),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='timestamp_value', full_name='google.datastore.v1.Value.timestamp_value', index=4,
-      number=10, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='key_value', full_name='google.datastore.v1.Value.key_value', index=5,
-      number=5, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='string_value', full_name='google.datastore.v1.Value.string_value', index=6,
-      number=17, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='blob_value', full_name='google.datastore.v1.Value.blob_value', index=7,
-      number=18, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='geo_point_value', full_name='google.datastore.v1.Value.geo_point_value', index=8,
-      number=8, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='entity_value', full_name='google.datastore.v1.Value.entity_value', index=9,
-      number=6, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='array_value', full_name='google.datastore.v1.Value.array_value', index=10,
-      number=9, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='meaning', full_name='google.datastore.v1.Value.meaning', index=11,
-      number=14, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='exclude_from_indexes', full_name='google.datastore.v1.Value.exclude_from_indexes', index=12,
-      number=19, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='value_type', full_name='google.datastore.v1.Value.value_type',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=478,
-  serialized_end=975,
-)
-
-
-_ENTITY_PROPERTIESENTRY = _descriptor.Descriptor(
-  name='PropertiesEntry',
-  full_name='google.datastore.v1.Entity.PropertiesEntry',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.datastore.v1.Entity.PropertiesEntry.key', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.datastore.v1.Entity.PropertiesEntry.value', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=_descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001')),
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1092,
-  serialized_end=1169,
-)
-
-_ENTITY = _descriptor.Descriptor(
-  name='Entity',
-  full_name='google.datastore.v1.Entity',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.datastore.v1.Entity.key', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='properties', full_name='google.datastore.v1.Entity.properties', index=1,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_ENTITY_PROPERTIESENTRY, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=978,
-  serialized_end=1169,
-)
-
-_KEY_PATHELEMENT.containing_type = _KEY
-_KEY_PATHELEMENT.oneofs_by_name['id_type'].fields.append(
-  _KEY_PATHELEMENT.fields_by_name['id'])
-_KEY_PATHELEMENT.fields_by_name['id'].containing_oneof = _KEY_PATHELEMENT.oneofs_by_name['id_type']
-_KEY_PATHELEMENT.oneofs_by_name['id_type'].fields.append(
-  _KEY_PATHELEMENT.fields_by_name['name'])
-_KEY_PATHELEMENT.fields_by_name['name'].containing_oneof = _KEY_PATHELEMENT.oneofs_by_name['id_type']
-_KEY.fields_by_name['partition_id'].message_type = _PARTITIONID
-_KEY.fields_by_name['path'].message_type = _KEY_PATHELEMENT
-_ARRAYVALUE.fields_by_name['values'].message_type = _VALUE
-_VALUE.fields_by_name['null_value'].enum_type = google_dot_protobuf_dot_struct__pb2._NULLVALUE
-_VALUE.fields_by_name['timestamp_value'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
-_VALUE.fields_by_name['key_value'].message_type = _KEY
-_VALUE.fields_by_name['geo_point_value'].message_type = google_dot_type_dot_latlng__pb2._LATLNG
-_VALUE.fields_by_name['entity_value'].message_type = _ENTITY
-_VALUE.fields_by_name['array_value'].message_type = _ARRAYVALUE
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['null_value'])
-_VALUE.fields_by_name['null_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['boolean_value'])
-_VALUE.fields_by_name['boolean_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['integer_value'])
-_VALUE.fields_by_name['integer_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['double_value'])
-_VALUE.fields_by_name['double_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['timestamp_value'])
-_VALUE.fields_by_name['timestamp_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['key_value'])
-_VALUE.fields_by_name['key_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['string_value'])
-_VALUE.fields_by_name['string_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['blob_value'])
-_VALUE.fields_by_name['blob_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['geo_point_value'])
-_VALUE.fields_by_name['geo_point_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['entity_value'])
-_VALUE.fields_by_name['entity_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_VALUE.oneofs_by_name['value_type'].fields.append(
-  _VALUE.fields_by_name['array_value'])
-_VALUE.fields_by_name['array_value'].containing_oneof = _VALUE.oneofs_by_name['value_type']
-_ENTITY_PROPERTIESENTRY.fields_by_name['value'].message_type = _VALUE
-_ENTITY_PROPERTIESENTRY.containing_type = _ENTITY
-_ENTITY.fields_by_name['key'].message_type = _KEY
-_ENTITY.fields_by_name['properties'].message_type = _ENTITY_PROPERTIESENTRY
-DESCRIPTOR.message_types_by_name['PartitionId'] = _PARTITIONID
-DESCRIPTOR.message_types_by_name['Key'] = _KEY
-DESCRIPTOR.message_types_by_name['ArrayValue'] = _ARRAYVALUE
-DESCRIPTOR.message_types_by_name['Value'] = _VALUE
-DESCRIPTOR.message_types_by_name['Entity'] = _ENTITY
-
-PartitionId = _reflection.GeneratedProtocolMessageType('PartitionId', (_message.Message,), dict(
-  DESCRIPTOR = _PARTITIONID,
-  __module__ = 'google.datastore.v1.entity_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.PartitionId)
-  ))
-_sym_db.RegisterMessage(PartitionId)
-
-Key = _reflection.GeneratedProtocolMessageType('Key', (_message.Message,), dict(
-
-  PathElement = _reflection.GeneratedProtocolMessageType('PathElement', (_message.Message,), dict(
-    DESCRIPTOR = _KEY_PATHELEMENT,
-    __module__ = 'google.datastore.v1.entity_pb2'
-    # @@protoc_insertion_point(class_scope:google.datastore.v1.Key.PathElement)
-    ))
-  ,
-  DESCRIPTOR = _KEY,
-  __module__ = 'google.datastore.v1.entity_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Key)
-  ))
-_sym_db.RegisterMessage(Key)
-_sym_db.RegisterMessage(Key.PathElement)
-
-ArrayValue = _reflection.GeneratedProtocolMessageType('ArrayValue', (_message.Message,), dict(
-  DESCRIPTOR = _ARRAYVALUE,
-  __module__ = 'google.datastore.v1.entity_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.ArrayValue)
-  ))
-_sym_db.RegisterMessage(ArrayValue)
-
-Value = _reflection.GeneratedProtocolMessageType('Value', (_message.Message,), dict(
-  DESCRIPTOR = _VALUE,
-  __module__ = 'google.datastore.v1.entity_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Value)
-  ))
-_sym_db.RegisterMessage(Value)
-
-Entity = _reflection.GeneratedProtocolMessageType('Entity', (_message.Message,), dict(
-
-  PropertiesEntry = _reflection.GeneratedProtocolMessageType('PropertiesEntry', (_message.Message,), dict(
-    DESCRIPTOR = _ENTITY_PROPERTIESENTRY,
-    __module__ = 'google.datastore.v1.entity_pb2'
-    # @@protoc_insertion_point(class_scope:google.datastore.v1.Entity.PropertiesEntry)
-    ))
-  ,
-  DESCRIPTOR = _ENTITY,
-  __module__ = 'google.datastore.v1.entity_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Entity)
-  ))
-_sym_db.RegisterMessage(Entity)
-_sym_db.RegisterMessage(Entity.PropertiesEntry)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\027com.google.datastore.v1B\013EntityProtoP\001'))
-_ENTITY_PROPERTIESENTRY.has_options = True
-_ENTITY_PROPERTIESENTRY._options = _descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/datastore/_generated/query_pb2.py b/google/cloud/datastore/_generated/query_pb2.py
deleted file mode 100644
index 7569f225d53a..000000000000
--- a/google/cloud/datastore/_generated/query_pb2.py
+++ /dev/null
@@ -1,934 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: google/datastore/v1/query.proto
-
-import sys
-_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import message as _message
-from google.protobuf import reflection as _reflection
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf import descriptor_pb2
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
-from google.cloud.datastore._generated import entity_pb2 as google_dot_datastore_dot_v1_dot_entity__pb2
-from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
-from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
-
-
-DESCRIPTOR = _descriptor.FileDescriptor(
-  name='google/datastore/v1/query.proto',
-  package='google.datastore.v1',
-  syntax='proto3',
-  serialized_pb=_b('\n\x1fgoogle/datastore/v1/query.proto\x12\x13google.datastore.v1\x1a\x1cgoogle/api/annotations.proto\x1a google/datastore/v1/entity.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x18google/type/latlng.proto\"\xaf\x01\n\x0c\x45ntityResult\x12+\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x1b.google.datastore.v1.Entity\x12\x0f\n\x07version\x18\x04 \x01(\x03\x12\x0e\n\x06\x63ursor\x18\x03 \x01(\x0c\"Q\n\nResultType\x12\x1b\n\x17RESULT_TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x46ULL\x10\x01\x12\x0e\n\nPROJECTION\x10\x02\x12\x0c\n\x08KEY_ONLY\x10\x03\"\xf2\x02\n\x05Query\x12\x33\n\nprojection\x18\x02 \x03(\x0b\x32\x1f.google.datastore.v1.Projection\x12\x31\n\x04kind\x18\x03 \x03(\x0b\x32#.google.datastore.v1.KindExpression\x12+\n\x06\x66ilter\x18\x04 \x01(\x0b\x32\x1b.google.datastore.v1.Filter\x12\x31\n\x05order\x18\x05 \x03(\x0b\x32\".google.datastore.v1.PropertyOrder\x12;\n\x0b\x64istinct_on\x18\x06 \x03(\x0b\x32&.google.datastore.v1.PropertyReference\x12\x14\n\x0cstart_cursor\x18\x07 \x01(\x0c\x12\x12\n\nend_cursor\x18\x08 \x01(\x0c\x12\x0e\n\x06offset\x18\n \x01(\x05\x12*\n\x05limit\x18\x0c \x01(\x0b\x32\x1b.google.protobuf.Int32Value\"\x1e\n\x0eKindExpression\x12\x0c\n\x04name\x18\x01 \x01(\t\"!\n\x11PropertyReference\x12\x0c\n\x04name\x18\x02 \x01(\t\"F\n\nProjection\x12\x38\n\x08property\x18\x01 \x01(\x0b\x32&.google.datastore.v1.PropertyReference\"\xd1\x01\n\rPropertyOrder\x12\x38\n\x08property\x18\x01 \x01(\x0b\x32&.google.datastore.v1.PropertyReference\x12?\n\tdirection\x18\x02 \x01(\x0e\x32,.google.datastore.v1.PropertyOrder.Direction\"E\n\tDirection\x12\x19\n\x15\x44IRECTION_UNSPECIFIED\x10\x00\x12\r\n\tASCENDING\x10\x01\x12\x0e\n\nDESCENDING\x10\x02\"\x99\x01\n\x06\x46ilter\x12@\n\x10\x63omposite_filter\x18\x01 \x01(\x0b\x32$.google.datastore.v1.CompositeFilterH\x00\x12>\n\x0fproperty_filter\x18\x02 \x01(\x0b\x32#.google.datastore.v1.PropertyFilterH\x00\x42\r\n\x0b\x66ilter_type\"\xa9\x01\n\x0f\x43ompositeFilter\x12\x39\n\x02op\x18\x01 \x01(\x0e\x32-.google.datastore.v1.CompositeFilter.Operator\x12,\n\x07\x66ilters\x18\x02 \x03(\x0b\x32\x1b.google.datastore.v1.Filter\"-\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\"\xc7\x02\n\x0ePropertyFilter\x12\x38\n\x08property\x18\x01 \x01(\x0b\x32&.google.datastore.v1.PropertyReference\x12\x38\n\x02op\x18\x02 \x01(\x0e\x32,.google.datastore.v1.PropertyFilter.Operator\x12)\n\x05value\x18\x03 \x01(\x0b\x32\x1a.google.datastore.v1.Value\"\x95\x01\n\x08Operator\x12\x18\n\x14OPERATOR_UNSPECIFIED\x10\x00\x12\r\n\tLESS_THAN\x10\x01\x12\x16\n\x12LESS_THAN_OR_EQUAL\x10\x02\x12\x10\n\x0cGREATER_THAN\x10\x03\x12\x19\n\x15GREATER_THAN_OR_EQUAL\x10\x04\x12\t\n\x05\x45QUAL\x10\x05\x12\x10\n\x0cHAS_ANCESTOR\x10\x0b\"\xa5\x02\n\x08GqlQuery\x12\x14\n\x0cquery_string\x18\x01 \x01(\t\x12\x16\n\x0e\x61llow_literals\x18\x02 \x01(\x08\x12H\n\x0enamed_bindings\x18\x05 \x03(\x0b\x32\x30.google.datastore.v1.GqlQuery.NamedBindingsEntry\x12\x43\n\x13positional_bindings\x18\x04 \x03(\x0b\x32&.google.datastore.v1.GqlQueryParameter\x1a\\\n\x12NamedBindingsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x35\n\x05value\x18\x02 \x01(\x0b\x32&.google.datastore.v1.GqlQueryParameter:\x02\x38\x01\"d\n\x11GqlQueryParameter\x12+\n\x05value\x18\x02 \x01(\x0b\x32\x1a.google.datastore.v1.ValueH\x00\x12\x10\n\x06\x63ursor\x18\x03 \x01(\x0cH\x00\x42\x10\n\x0eparameter_type\"\xde\x03\n\x10QueryResultBatch\x12\x17\n\x0fskipped_results\x18\x06 \x01(\x05\x12\x16\n\x0eskipped_cursor\x18\x03 \x01(\x0c\x12H\n\x12\x65ntity_result_type\x18\x01 \x01(\x0e\x32,.google.datastore.v1.EntityResult.ResultType\x12\x39\n\x0e\x65ntity_results\x18\x02 \x03(\x0b\x32!.google.datastore.v1.EntityResult\x12\x12\n\nend_cursor\x18\x04 \x01(\x0c\x12K\n\x0cmore_results\x18\x05 \x01(\x0e\x32\x35.google.datastore.v1.QueryResultBatch.MoreResultsType\x12\x18\n\x10snapshot_version\x18\x07 \x01(\x03\"\x98\x01\n\x0fMoreResultsType\x12!\n\x1dMORE_RESULTS_TYPE_UNSPECIFIED\x10\x00\x12\x10\n\x0cNOT_FINISHED\x10\x01\x12\x1c\n\x18MORE_RESULTS_AFTER_LIMIT\x10\x02\x12\x1d\n\x19MORE_RESULTS_AFTER_CURSOR\x10\x04\x12\x13\n\x0fNO_MORE_RESULTS\x10\x03\x42\'\n\x17\x63om.google.datastore.v1B\nQueryProtoP\x01\x62\x06proto3')
-  ,
-  dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,google_dot_datastore_dot_v1_dot_entity__pb2.DESCRIPTOR,google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,google_dot_type_dot_latlng__pb2.DESCRIPTOR,])
-_sym_db.RegisterFileDescriptor(DESCRIPTOR)
-
-
-
-_ENTITYRESULT_RESULTTYPE = _descriptor.EnumDescriptor(
-  name='ResultType',
-  full_name='google.datastore.v1.EntityResult.ResultType',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='RESULT_TYPE_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='FULL', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='PROJECTION', index=2, number=2,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='KEY_ONLY', index=3, number=3,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=273,
-  serialized_end=354,
-)
-_sym_db.RegisterEnumDescriptor(_ENTITYRESULT_RESULTTYPE)
-
-_PROPERTYORDER_DIRECTION = _descriptor.EnumDescriptor(
-  name='Direction',
-  full_name='google.datastore.v1.PropertyOrder.Direction',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='DIRECTION_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='ASCENDING', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='DESCENDING', index=2, number=2,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=1009,
-  serialized_end=1078,
-)
-_sym_db.RegisterEnumDescriptor(_PROPERTYORDER_DIRECTION)
-
-_COMPOSITEFILTER_OPERATOR = _descriptor.EnumDescriptor(
-  name='Operator',
-  full_name='google.datastore.v1.CompositeFilter.Operator',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='OPERATOR_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='AND', index=1, number=1,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=1361,
-  serialized_end=1406,
-)
-_sym_db.RegisterEnumDescriptor(_COMPOSITEFILTER_OPERATOR)
-
-_PROPERTYFILTER_OPERATOR = _descriptor.EnumDescriptor(
-  name='Operator',
-  full_name='google.datastore.v1.PropertyFilter.Operator',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='OPERATOR_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='LESS_THAN', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='LESS_THAN_OR_EQUAL', index=2, number=2,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='GREATER_THAN', index=3, number=3,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='GREATER_THAN_OR_EQUAL', index=4, number=4,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='EQUAL', index=5, number=5,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='HAS_ANCESTOR', index=6, number=11,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=1587,
-  serialized_end=1736,
-)
-_sym_db.RegisterEnumDescriptor(_PROPERTYFILTER_OPERATOR)
-
-_QUERYRESULTBATCH_MORERESULTSTYPE = _descriptor.EnumDescriptor(
-  name='MoreResultsType',
-  full_name='google.datastore.v1.QueryResultBatch.MoreResultsType',
-  filename=None,
-  file=DESCRIPTOR,
-  values=[
-    _descriptor.EnumValueDescriptor(
-      name='MORE_RESULTS_TYPE_UNSPECIFIED', index=0, number=0,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='NOT_FINISHED', index=1, number=1,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='MORE_RESULTS_AFTER_LIMIT', index=2, number=2,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='MORE_RESULTS_AFTER_CURSOR', index=3, number=4,
-      options=None,
-      type=None),
-    _descriptor.EnumValueDescriptor(
-      name='NO_MORE_RESULTS', index=4, number=3,
-      options=None,
-      type=None),
-  ],
-  containing_type=None,
-  options=None,
-  serialized_start=2463,
-  serialized_end=2615,
-)
-_sym_db.RegisterEnumDescriptor(_QUERYRESULTBATCH_MORERESULTSTYPE)
-
-
-_ENTITYRESULT = _descriptor.Descriptor(
-  name='EntityResult',
-  full_name='google.datastore.v1.EntityResult',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='entity', full_name='google.datastore.v1.EntityResult.entity', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='version', full_name='google.datastore.v1.EntityResult.version', index=1,
-      number=4, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cursor', full_name='google.datastore.v1.EntityResult.cursor', index=2,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _ENTITYRESULT_RESULTTYPE,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=179,
-  serialized_end=354,
-)
-
-
-_QUERY = _descriptor.Descriptor(
-  name='Query',
-  full_name='google.datastore.v1.Query',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='projection', full_name='google.datastore.v1.Query.projection', index=0,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='kind', full_name='google.datastore.v1.Query.kind', index=1,
-      number=3, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='filter', full_name='google.datastore.v1.Query.filter', index=2,
-      number=4, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='order', full_name='google.datastore.v1.Query.order', index=3,
-      number=5, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='distinct_on', full_name='google.datastore.v1.Query.distinct_on', index=4,
-      number=6, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='start_cursor', full_name='google.datastore.v1.Query.start_cursor', index=5,
-      number=7, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_cursor', full_name='google.datastore.v1.Query.end_cursor', index=6,
-      number=8, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='offset', full_name='google.datastore.v1.Query.offset', index=7,
-      number=10, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='limit', full_name='google.datastore.v1.Query.limit', index=8,
-      number=12, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=357,
-  serialized_end=727,
-)
-
-
-_KINDEXPRESSION = _descriptor.Descriptor(
-  name='KindExpression',
-  full_name='google.datastore.v1.KindExpression',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.datastore.v1.KindExpression.name', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=729,
-  serialized_end=759,
-)
-
-
-_PROPERTYREFERENCE = _descriptor.Descriptor(
-  name='PropertyReference',
-  full_name='google.datastore.v1.PropertyReference',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='name', full_name='google.datastore.v1.PropertyReference.name', index=0,
-      number=2, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=761,
-  serialized_end=794,
-)
-
-
-_PROJECTION = _descriptor.Descriptor(
-  name='Projection',
-  full_name='google.datastore.v1.Projection',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='property', full_name='google.datastore.v1.Projection.property', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=796,
-  serialized_end=866,
-)
-
-
-_PROPERTYORDER = _descriptor.Descriptor(
-  name='PropertyOrder',
-  full_name='google.datastore.v1.PropertyOrder',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='property', full_name='google.datastore.v1.PropertyOrder.property', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='direction', full_name='google.datastore.v1.PropertyOrder.direction', index=1,
-      number=2, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _PROPERTYORDER_DIRECTION,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=869,
-  serialized_end=1078,
-)
-
-
-_FILTER = _descriptor.Descriptor(
-  name='Filter',
-  full_name='google.datastore.v1.Filter',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='composite_filter', full_name='google.datastore.v1.Filter.composite_filter', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='property_filter', full_name='google.datastore.v1.Filter.property_filter', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='filter_type', full_name='google.datastore.v1.Filter.filter_type',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=1081,
-  serialized_end=1234,
-)
-
-
-_COMPOSITEFILTER = _descriptor.Descriptor(
-  name='CompositeFilter',
-  full_name='google.datastore.v1.CompositeFilter',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='op', full_name='google.datastore.v1.CompositeFilter.op', index=0,
-      number=1, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='filters', full_name='google.datastore.v1.CompositeFilter.filters', index=1,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _COMPOSITEFILTER_OPERATOR,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1237,
-  serialized_end=1406,
-)
-
-
-_PROPERTYFILTER = _descriptor.Descriptor(
-  name='PropertyFilter',
-  full_name='google.datastore.v1.PropertyFilter',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='property', full_name='google.datastore.v1.PropertyFilter.property', index=0,
-      number=1, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='op', full_name='google.datastore.v1.PropertyFilter.op', index=1,
-      number=2, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.datastore.v1.PropertyFilter.value', index=2,
-      number=3, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _PROPERTYFILTER_OPERATOR,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1409,
-  serialized_end=1736,
-)
-
-
-_GQLQUERY_NAMEDBINDINGSENTRY = _descriptor.Descriptor(
-  name='NamedBindingsEntry',
-  full_name='google.datastore.v1.GqlQuery.NamedBindingsEntry',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='key', full_name='google.datastore.v1.GqlQuery.NamedBindingsEntry.key', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.datastore.v1.GqlQuery.NamedBindingsEntry.value', index=1,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=_descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001')),
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1940,
-  serialized_end=2032,
-)
-
-_GQLQUERY = _descriptor.Descriptor(
-  name='GqlQuery',
-  full_name='google.datastore.v1.GqlQuery',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='query_string', full_name='google.datastore.v1.GqlQuery.query_string', index=0,
-      number=1, type=9, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b("").decode('utf-8'),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='allow_literals', full_name='google.datastore.v1.GqlQuery.allow_literals', index=1,
-      number=2, type=8, cpp_type=7, label=1,
-      has_default_value=False, default_value=False,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='named_bindings', full_name='google.datastore.v1.GqlQuery.named_bindings', index=2,
-      number=5, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='positional_bindings', full_name='google.datastore.v1.GqlQuery.positional_bindings', index=3,
-      number=4, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[_GQLQUERY_NAMEDBINDINGSENTRY, ],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=1739,
-  serialized_end=2032,
-)
-
-
-_GQLQUERYPARAMETER = _descriptor.Descriptor(
-  name='GqlQueryParameter',
-  full_name='google.datastore.v1.GqlQueryParameter',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='value', full_name='google.datastore.v1.GqlQueryParameter.value', index=0,
-      number=2, type=11, cpp_type=10, label=1,
-      has_default_value=False, default_value=None,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='cursor', full_name='google.datastore.v1.GqlQueryParameter.cursor', index=1,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-    _descriptor.OneofDescriptor(
-      name='parameter_type', full_name='google.datastore.v1.GqlQueryParameter.parameter_type',
-      index=0, containing_type=None, fields=[]),
-  ],
-  serialized_start=2034,
-  serialized_end=2134,
-)
-
-
-_QUERYRESULTBATCH = _descriptor.Descriptor(
-  name='QueryResultBatch',
-  full_name='google.datastore.v1.QueryResultBatch',
-  filename=None,
-  file=DESCRIPTOR,
-  containing_type=None,
-  fields=[
-    _descriptor.FieldDescriptor(
-      name='skipped_results', full_name='google.datastore.v1.QueryResultBatch.skipped_results', index=0,
-      number=6, type=5, cpp_type=1, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='skipped_cursor', full_name='google.datastore.v1.QueryResultBatch.skipped_cursor', index=1,
-      number=3, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='entity_result_type', full_name='google.datastore.v1.QueryResultBatch.entity_result_type', index=2,
-      number=1, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='entity_results', full_name='google.datastore.v1.QueryResultBatch.entity_results', index=3,
-      number=2, type=11, cpp_type=10, label=3,
-      has_default_value=False, default_value=[],
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='end_cursor', full_name='google.datastore.v1.QueryResultBatch.end_cursor', index=4,
-      number=4, type=12, cpp_type=9, label=1,
-      has_default_value=False, default_value=_b(""),
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='more_results', full_name='google.datastore.v1.QueryResultBatch.more_results', index=5,
-      number=5, type=14, cpp_type=8, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-    _descriptor.FieldDescriptor(
-      name='snapshot_version', full_name='google.datastore.v1.QueryResultBatch.snapshot_version', index=6,
-      number=7, type=3, cpp_type=2, label=1,
-      has_default_value=False, default_value=0,
-      message_type=None, enum_type=None, containing_type=None,
-      is_extension=False, extension_scope=None,
-      options=None),
-  ],
-  extensions=[
-  ],
-  nested_types=[],
-  enum_types=[
-    _QUERYRESULTBATCH_MORERESULTSTYPE,
-  ],
-  options=None,
-  is_extendable=False,
-  syntax='proto3',
-  extension_ranges=[],
-  oneofs=[
-  ],
-  serialized_start=2137,
-  serialized_end=2615,
-)
-
-_ENTITYRESULT.fields_by_name['entity'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._ENTITY
-_ENTITYRESULT_RESULTTYPE.containing_type = _ENTITYRESULT
-_QUERY.fields_by_name['projection'].message_type = _PROJECTION
-_QUERY.fields_by_name['kind'].message_type = _KINDEXPRESSION
-_QUERY.fields_by_name['filter'].message_type = _FILTER
-_QUERY.fields_by_name['order'].message_type = _PROPERTYORDER
-_QUERY.fields_by_name['distinct_on'].message_type = _PROPERTYREFERENCE
-_QUERY.fields_by_name['limit'].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
-_PROJECTION.fields_by_name['property'].message_type = _PROPERTYREFERENCE
-_PROPERTYORDER.fields_by_name['property'].message_type = _PROPERTYREFERENCE
-_PROPERTYORDER.fields_by_name['direction'].enum_type = _PROPERTYORDER_DIRECTION
-_PROPERTYORDER_DIRECTION.containing_type = _PROPERTYORDER
-_FILTER.fields_by_name['composite_filter'].message_type = _COMPOSITEFILTER
-_FILTER.fields_by_name['property_filter'].message_type = _PROPERTYFILTER
-_FILTER.oneofs_by_name['filter_type'].fields.append(
-  _FILTER.fields_by_name['composite_filter'])
-_FILTER.fields_by_name['composite_filter'].containing_oneof = _FILTER.oneofs_by_name['filter_type']
-_FILTER.oneofs_by_name['filter_type'].fields.append(
-  _FILTER.fields_by_name['property_filter'])
-_FILTER.fields_by_name['property_filter'].containing_oneof = _FILTER.oneofs_by_name['filter_type']
-_COMPOSITEFILTER.fields_by_name['op'].enum_type = _COMPOSITEFILTER_OPERATOR
-_COMPOSITEFILTER.fields_by_name['filters'].message_type = _FILTER
-_COMPOSITEFILTER_OPERATOR.containing_type = _COMPOSITEFILTER
-_PROPERTYFILTER.fields_by_name['property'].message_type = _PROPERTYREFERENCE
-_PROPERTYFILTER.fields_by_name['op'].enum_type = _PROPERTYFILTER_OPERATOR
-_PROPERTYFILTER.fields_by_name['value'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._VALUE
-_PROPERTYFILTER_OPERATOR.containing_type = _PROPERTYFILTER
-_GQLQUERY_NAMEDBINDINGSENTRY.fields_by_name['value'].message_type = _GQLQUERYPARAMETER
-_GQLQUERY_NAMEDBINDINGSENTRY.containing_type = _GQLQUERY
-_GQLQUERY.fields_by_name['named_bindings'].message_type = _GQLQUERY_NAMEDBINDINGSENTRY
-_GQLQUERY.fields_by_name['positional_bindings'].message_type = _GQLQUERYPARAMETER
-_GQLQUERYPARAMETER.fields_by_name['value'].message_type = google_dot_datastore_dot_v1_dot_entity__pb2._VALUE
-_GQLQUERYPARAMETER.oneofs_by_name['parameter_type'].fields.append(
-  _GQLQUERYPARAMETER.fields_by_name['value'])
-_GQLQUERYPARAMETER.fields_by_name['value'].containing_oneof = _GQLQUERYPARAMETER.oneofs_by_name['parameter_type']
-_GQLQUERYPARAMETER.oneofs_by_name['parameter_type'].fields.append(
-  _GQLQUERYPARAMETER.fields_by_name['cursor'])
-_GQLQUERYPARAMETER.fields_by_name['cursor'].containing_oneof = _GQLQUERYPARAMETER.oneofs_by_name['parameter_type']
-_QUERYRESULTBATCH.fields_by_name['entity_result_type'].enum_type = _ENTITYRESULT_RESULTTYPE
-_QUERYRESULTBATCH.fields_by_name['entity_results'].message_type = _ENTITYRESULT
-_QUERYRESULTBATCH.fields_by_name['more_results'].enum_type = _QUERYRESULTBATCH_MORERESULTSTYPE
-_QUERYRESULTBATCH_MORERESULTSTYPE.containing_type = _QUERYRESULTBATCH
-DESCRIPTOR.message_types_by_name['EntityResult'] = _ENTITYRESULT
-DESCRIPTOR.message_types_by_name['Query'] = _QUERY
-DESCRIPTOR.message_types_by_name['KindExpression'] = _KINDEXPRESSION
-DESCRIPTOR.message_types_by_name['PropertyReference'] = _PROPERTYREFERENCE
-DESCRIPTOR.message_types_by_name['Projection'] = _PROJECTION
-DESCRIPTOR.message_types_by_name['PropertyOrder'] = _PROPERTYORDER
-DESCRIPTOR.message_types_by_name['Filter'] = _FILTER
-DESCRIPTOR.message_types_by_name['CompositeFilter'] = _COMPOSITEFILTER
-DESCRIPTOR.message_types_by_name['PropertyFilter'] = _PROPERTYFILTER
-DESCRIPTOR.message_types_by_name['GqlQuery'] = _GQLQUERY
-DESCRIPTOR.message_types_by_name['GqlQueryParameter'] = _GQLQUERYPARAMETER
-DESCRIPTOR.message_types_by_name['QueryResultBatch'] = _QUERYRESULTBATCH
-
-EntityResult = _reflection.GeneratedProtocolMessageType('EntityResult', (_message.Message,), dict(
-  DESCRIPTOR = _ENTITYRESULT,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.EntityResult)
-  ))
-_sym_db.RegisterMessage(EntityResult)
-
-Query = _reflection.GeneratedProtocolMessageType('Query', (_message.Message,), dict(
-  DESCRIPTOR = _QUERY,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Query)
-  ))
-_sym_db.RegisterMessage(Query)
-
-KindExpression = _reflection.GeneratedProtocolMessageType('KindExpression', (_message.Message,), dict(
-  DESCRIPTOR = _KINDEXPRESSION,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.KindExpression)
-  ))
-_sym_db.RegisterMessage(KindExpression)
-
-PropertyReference = _reflection.GeneratedProtocolMessageType('PropertyReference', (_message.Message,), dict(
-  DESCRIPTOR = _PROPERTYREFERENCE,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.PropertyReference)
-  ))
-_sym_db.RegisterMessage(PropertyReference)
-
-Projection = _reflection.GeneratedProtocolMessageType('Projection', (_message.Message,), dict(
-  DESCRIPTOR = _PROJECTION,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Projection)
-  ))
-_sym_db.RegisterMessage(Projection)
-
-PropertyOrder = _reflection.GeneratedProtocolMessageType('PropertyOrder', (_message.Message,), dict(
-  DESCRIPTOR = _PROPERTYORDER,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.PropertyOrder)
-  ))
-_sym_db.RegisterMessage(PropertyOrder)
-
-Filter = _reflection.GeneratedProtocolMessageType('Filter', (_message.Message,), dict(
-  DESCRIPTOR = _FILTER,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.Filter)
-  ))
-_sym_db.RegisterMessage(Filter)
-
-CompositeFilter = _reflection.GeneratedProtocolMessageType('CompositeFilter', (_message.Message,), dict(
-  DESCRIPTOR = _COMPOSITEFILTER,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.CompositeFilter)
-  ))
-_sym_db.RegisterMessage(CompositeFilter)
-
-PropertyFilter = _reflection.GeneratedProtocolMessageType('PropertyFilter', (_message.Message,), dict(
-  DESCRIPTOR = _PROPERTYFILTER,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.PropertyFilter)
-  ))
-_sym_db.RegisterMessage(PropertyFilter)
-
-GqlQuery = _reflection.GeneratedProtocolMessageType('GqlQuery', (_message.Message,), dict(
-
-  NamedBindingsEntry = _reflection.GeneratedProtocolMessageType('NamedBindingsEntry', (_message.Message,), dict(
-    DESCRIPTOR = _GQLQUERY_NAMEDBINDINGSENTRY,
-    __module__ = 'google.datastore.v1.query_pb2'
-    # @@protoc_insertion_point(class_scope:google.datastore.v1.GqlQuery.NamedBindingsEntry)
-    ))
-  ,
-  DESCRIPTOR = _GQLQUERY,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.GqlQuery)
-  ))
-_sym_db.RegisterMessage(GqlQuery)
-_sym_db.RegisterMessage(GqlQuery.NamedBindingsEntry)
-
-GqlQueryParameter = _reflection.GeneratedProtocolMessageType('GqlQueryParameter', (_message.Message,), dict(
-  DESCRIPTOR = _GQLQUERYPARAMETER,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.GqlQueryParameter)
-  ))
-_sym_db.RegisterMessage(GqlQueryParameter)
-
-QueryResultBatch = _reflection.GeneratedProtocolMessageType('QueryResultBatch', (_message.Message,), dict(
-  DESCRIPTOR = _QUERYRESULTBATCH,
-  __module__ = 'google.datastore.v1.query_pb2'
-  # @@protoc_insertion_point(class_scope:google.datastore.v1.QueryResultBatch)
-  ))
-_sym_db.RegisterMessage(QueryResultBatch)
-
-
-DESCRIPTOR.has_options = True
-DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('\n\027com.google.datastore.v1B\nQueryProtoP\001'))
-_GQLQUERY_NAMEDBINDINGSENTRY.has_options = True
-_GQLQUERY_NAMEDBINDINGSENTRY._options = _descriptor._ParseOptions(descriptor_pb2.MessageOptions(), _b('8\001'))
-# @@protoc_insertion_point(module_scope)
diff --git a/google/cloud/datastore/batch.py b/google/cloud/datastore/batch.py
deleted file mode 100644
index 05067534d6a0..000000000000
--- a/google/cloud/datastore/batch.py
+++ /dev/null
@@ -1,322 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with a batch of updates / deletes.
-
-Batches provide the ability to execute multiple operations
-in a single request to the Cloud Datastore API.
-
-See
-https://cloud.google.com/datastore/docs/concepts/entities#Datastore_Batch_operations
-"""
-
-from google.cloud.datastore import helpers
-from google.cloud.datastore._generated import datastore_pb2 as _datastore_pb2
-
-
-class Batch(object):
-    """An abstraction representing a collected group of updates / deletes.
-
-    Used to build up a bulk mutation.
-
-    For example, the following snippet of code will put the two ``save``
-    operations and the ``delete`` operation into the same mutation, and send
-    them to the server in a single API request::
-
-      >>> from google.cloud import datastore
-      >>> client = datastore.Client()
-      >>> batch = client.batch()
-      >>> batch.put(entity1)
-      >>> batch.put(entity2)
-      >>> batch.delete(key3)
-      >>> batch.commit()
-
-    You can also use a batch as a context manager, in which case
-    :meth:`commit` will be called automatically if its block exits without
-    raising an exception::
-
-      >>> with batch:
-      ...     batch.put(entity1)
-      ...     batch.put(entity2)
-      ...     batch.delete(key3)
-
-    By default, no updates will be sent if the block exits with an error::
-
-      >>> with batch:
-      ...     do_some_work(batch)
-      ...     raise Exception()  # rolls back
-
-    :type client: :class:`google.cloud.datastore.client.Client`
-    :param client: The client used to connect to datastore.
-    """
-
-    _id = None  # "protected" attribute, always None for non-transactions
-
-    _INITIAL = 0
-    """Enum value for _INITIAL status of batch/transaction."""
-
-    _IN_PROGRESS = 1
-    """Enum value for _IN_PROGRESS status of batch/transaction."""
-
-    _ABORTED = 2
-    """Enum value for _ABORTED status of batch/transaction."""
-
-    _FINISHED = 3
-    """Enum value for _FINISHED status of batch/transaction."""
-
-    def __init__(self, client):
-        self._client = client
-        self._commit_request = _datastore_pb2.CommitRequest()
-        self._partial_key_entities = []
-        self._status = self._INITIAL
-
-    def current(self):
-        """Return the topmost batch / transaction, or None."""
-        return self._client.current_batch
-
-    @property
-    def project(self):
-        """Getter for project in which the batch will run.
-
-        :rtype: :class:`str`
-        :returns: The project in which the batch will run.
-        """
-        return self._client.project
-
-    @property
-    def namespace(self):
-        """Getter for namespace in which the batch will run.
-
-        :rtype: :class:`str`
-        :returns: The namespace in which the batch will run.
-        """
-        return self._client.namespace
-
-    @property
-    def connection(self):
-        """Getter for connection over which the batch will run.
-
-        :rtype: :class:`google.cloud.datastore.connection.Connection`
-        :returns: The connection over which the batch will run.
-        """
-        return self._client.connection
-
-    def _add_partial_key_entity_pb(self):
-        """Adds a new mutation for an entity with a partial key.
-
-        :rtype: :class:`google.cloud.datastore._generated.entity_pb2.Entity`
-        :returns: The newly created entity protobuf that will be
-                  updated and sent with a commit.
-        """
-        new_mutation = self.mutations.add()
-        return new_mutation.insert
-
-    def _add_complete_key_entity_pb(self):
-        """Adds a new mutation for an entity with a completed key.
-
-        :rtype: :class:`google.cloud.datastore._generated.entity_pb2.Entity`
-        :returns: The newly created entity protobuf that will be
-                  updated and sent with a commit.
-        """
-        # We use ``upsert`` for entities with completed keys, rather than
-        # ``insert`` or ``update``, in order not to create race conditions
-        # based on prior existence / removal of the entity.
-        new_mutation = self.mutations.add()
-        return new_mutation.upsert
-
-    def _add_delete_key_pb(self):
-        """Adds a new mutation for a key to be deleted.
-
-        :rtype: :class:`google.cloud.datastore._generated.entity_pb2.Key`
-        :returns: The newly created key protobuf that will be
-                  deleted when sent with a commit.
-        """
-        new_mutation = self.mutations.add()
-        return new_mutation.delete
-
-    @property
-    def mutations(self):
-        """Getter for the changes accumulated by this batch.
-
-        Every batch is committed with a single commit request containing all
-        the work to be done as mutations. Inside a batch, calling :meth:`put`
-        with an entity, or :meth:`delete` with a key, builds up the request by
-        adding a new mutation. This getter returns the protobuf that has been
-        built-up so far.
-
-        :rtype: iterable
-        :returns: The list of :class:`._generated.datastore_pb2.Mutation`
-                  protobufs to be sent in the commit request.
-        """
-        return self._commit_request.mutations
-
-    def put(self, entity):
-        """Remember an entity's state to be saved during :meth:`commit`.
-
-        .. note::
-           Any existing properties for the entity will be replaced by those
-           currently set on this instance.  Already-stored properties which do
-           not correspond to keys set on this instance will be removed from
-           the datastore.
-
-        .. note::
-           Property values which are "text" ('unicode' in Python2, 'str' in
-           Python3) map to 'string_value' in the datastore;  values which are
-           "bytes" ('str' in Python2, 'bytes' in Python3) map to 'blob_value'.
-
-        When an entity has a partial key, calling :meth:`commit` sends it as
-        an ``insert`` mutation and the key is completed. On return,
-        the key for the ``entity`` passed in is updated to match the key ID
-        assigned by the server.
-
-        :type entity: :class:`google.cloud.datastore.entity.Entity`
-        :param entity: the entity to be saved.
-
-        :raises: :class:`~exceptions.ValueError` if the batch is not in
-                 progress, if entity has no key assigned, or if the key's
-                 ``project`` does not match ours.
-        """
-        if self._status != self._IN_PROGRESS:
-            raise ValueError('Batch must be in progress to put()')
-
-        if entity.key is None:
-            raise ValueError("Entity must have a key")
-
-        if self.project != entity.key.project:
-            raise ValueError("Key must be from same project as batch")
-
-        if entity.key.is_partial:
-            entity_pb = self._add_partial_key_entity_pb()
-            self._partial_key_entities.append(entity)
-        else:
-            entity_pb = self._add_complete_key_entity_pb()
-
-        _assign_entity_to_pb(entity_pb, entity)
-
-    def delete(self, key):
-        """Remember a key to be deleted during :meth:`commit`.
-
-        :type key: :class:`google.cloud.datastore.key.Key`
-        :param key: the key to be deleted.
-
-        :raises: :class:`~exceptions.ValueError` if the batch is not in
-                 progress, if key is not complete, or if the key's
-                 ``project`` does not match ours.
-        """
-        if self._status != self._IN_PROGRESS:
-            raise ValueError('Batch must be in progress to delete()')
-
-        if key.is_partial:
-            raise ValueError("Key must be complete")
-
-        if self.project != key.project:
-            raise ValueError("Key must be from same project as batch")
-
-        key_pb = key.to_protobuf()
-        self._add_delete_key_pb().CopyFrom(key_pb)
-
-    def begin(self):
-        """Begins a batch.
-
-        This method is called automatically when entering a with
-        statement, however it can be called explicitly if you don't want
-        to use a context manager.
-
-        Overridden by :class:`google.cloud.datastore.transaction.Transaction`.
-
-        :raises: :class:`ValueError` if the batch has already begun.
-        """
-        if self._status != self._INITIAL:
-            raise ValueError('Batch already started previously.')
-        self._status = self._IN_PROGRESS
-
-    def _commit(self):
-        """Commits the batch.
-
-        This is called by :meth:`commit`.
-        """
-        # NOTE: ``self._commit_request`` will be modified.
-        _, updated_keys = self.connection.commit(
-            self.project, self._commit_request, self._id)
-        # If the back-end returns without error, we are guaranteed that
-        # :meth:`Connection.commit` will return keys that match (length and
-        # order) directly ``_partial_key_entities``.
-        for new_key_pb, entity in zip(updated_keys,
-                                      self._partial_key_entities):
-            new_id = new_key_pb.path[-1].id
-            entity.key = entity.key.completed_key(new_id)
-
-    def commit(self):
-        """Commits the batch.
-
-        This is called automatically upon exiting a with statement,
-        however it can be called explicitly if you don't want to use a
-        context manager.
-
-        :raises: :class:`~exceptions.ValueError` if the batch is not
-                 in progress.
-        """
-        if self._status != self._IN_PROGRESS:
-            raise ValueError('Batch must be in progress to commit()')
-
-        try:
-            self._commit()
-        finally:
-            self._status = self._FINISHED
-
-    def rollback(self):
-        """Rolls back the current batch.
-
-        Marks the batch as aborted (can't be used again).
-
-        Overridden by :class:`google.cloud.datastore.transaction.Transaction`.
-
-        :raises: :class:`~exceptions.ValueError` if the batch is not
-                 in progress.
-        """
-        if self._status != self._IN_PROGRESS:
-            raise ValueError('Batch must be in progress to rollback()')
-
-        self._status = self._ABORTED
-
-    def __enter__(self):
-        self.begin()
-        # NOTE: We make sure begin() succeeds before pushing onto the stack.
-        self._client._push_batch(self)
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        try:
-            if exc_type is None:
-                self.commit()
-            else:
-                self.rollback()
-        finally:
-            self._client._pop_batch()
-
-
-def _assign_entity_to_pb(entity_pb, entity):
-    """Copy ``entity`` into ``entity_pb``.
-
-    Helper method for ``Batch.put``.
-
-    :type entity_pb: :class:`._generated.entity_pb2.Entity`
-    :param entity_pb: The entity owned by a mutation.
-
-    :type entity: :class:`google.cloud.datastore.entity.Entity`
-    :param entity: The entity being updated within the batch / transaction.
-    """
-    bare_entity_pb = helpers.entity_to_protobuf(entity)
-    bare_entity_pb.key.CopyFrom(bare_entity_pb.key)
-    entity_pb.CopyFrom(bare_entity_pb)
diff --git a/google/cloud/datastore/client.py b/google/cloud/datastore/client.py
deleted file mode 100644
index de901d89a450..000000000000
--- a/google/cloud/datastore/client.py
+++ /dev/null
@@ -1,488 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-"""Convenience wrapper for invoking APIs/factories w/ a project."""
-
-import os
-
-from google.cloud._helpers import _LocalStack
-from google.cloud._helpers import (
-    _determine_default_project as _base_default_project)
-from google.cloud.client import _ClientProjectMixin
-from google.cloud.client import Client as _BaseClient
-from google.cloud.datastore import helpers
-from google.cloud.datastore.connection import Connection
-from google.cloud.datastore.batch import Batch
-from google.cloud.datastore.entity import Entity
-from google.cloud.datastore.key import Key
-from google.cloud.datastore.query import Query
-from google.cloud.datastore.transaction import Transaction
-from google.cloud.environment_vars import GCD_DATASET
-
-
-_MAX_LOOPS = 128
-"""Maximum number of iterations to wait for deferred keys."""
-
-
-def _get_gcd_project():
-    """Gets the GCD application ID if it can be inferred."""
-    return os.getenv(GCD_DATASET)
-
-
-def _determine_default_project(project=None):
-    """Determine default project explicitly or implicitly as fall-back.
-
-    In implicit case, supports four environments. In order of precedence, the
-    implicit environments are:
-
-    * DATASTORE_DATASET environment variable (for ``gcd`` / emulator testing)
-    * GOOGLE_CLOUD_PROJECT environment variable
-    * Google App Engine application ID
-    * Google Compute Engine project ID (from metadata server)
-
-    :type project: string
-    :param project: Optional. The project to use as default.
-
-    :rtype: string or ``NoneType``
-    :returns: Default project if it can be determined.
-    """
-    if project is None:
-        project = _get_gcd_project()
-
-    if project is None:
-        project = _base_default_project(project=project)
-
-    return project
-
-
-def _extended_lookup(connection, project, key_pbs,
-                     missing=None, deferred=None,
-                     eventual=False, transaction_id=None):
-    """Repeat lookup until all keys found (unless stop requested).
-
-    Helper function for :meth:`Client.get_multi`.
-
-    :type connection: :class:`google.cloud.datastore.connection.Connection`
-    :param connection: The connection used to connect to datastore.
-
-    :type project: string
-    :param project: The project to make the request for.
-
-    :type key_pbs: list of :class:`._generated.entity_pb2.Key`
-    :param key_pbs: The keys to retrieve from the datastore.
-
-    :type missing: list
-    :param missing: (Optional) If a list is passed, the key-only entity
-                    protobufs returned by the backend as "missing" will be
-                    copied into it.
-
-    :type deferred: list
-    :param deferred: (Optional) If a list is passed, the key protobufs returned
-                     by the backend as "deferred" will be copied into it.
-
-    :type eventual: bool
-    :param eventual: If False (the default), request ``STRONG`` read
-                     consistency.  If True, request ``EVENTUAL`` read
-                     consistency.
-
-    :type transaction_id: string
-    :param transaction_id: If passed, make the request in the scope of
-                           the given transaction.  Incompatible with
-                           ``eventual==True``.
-
-    :rtype: list of :class:`._generated.entity_pb2.Entity`
-    :returns: The requested entities.
-    :raises: :class:`ValueError` if missing / deferred are not null or
-             empty list.
-    """
-    if missing is not None and missing != []:
-        raise ValueError('missing must be None or an empty list')
-
-    if deferred is not None and deferred != []:
-        raise ValueError('deferred must be None or an empty list')
-
-    results = []
-
-    loop_num = 0
-    while loop_num < _MAX_LOOPS:  # loop against possible deferred.
-        loop_num += 1
-
-        results_found, missing_found, deferred_found = connection.lookup(
-            project=project,
-            key_pbs=key_pbs,
-            eventual=eventual,
-            transaction_id=transaction_id,
-        )
-
-        results.extend(results_found)
-
-        if missing is not None:
-            missing.extend(missing_found)
-
-        if deferred is not None:
-            deferred.extend(deferred_found)
-            break
-
-        if len(deferred_found) == 0:
-            break
-
-        # We have deferred keys, and the user didn't ask to know about
-        # them, so retry (but only with the deferred ones).
-        key_pbs = deferred_found
-
-    return results
-
-
-class Client(_BaseClient, _ClientProjectMixin):
-    """Convenience wrapper for invoking APIs/factories w/ a project.
-
-    :type project: string
-    :param project: (optional) The project to pass to proxied API methods.
-
-    :type namespace: string
-    :param namespace: (optional) namespace to pass to proxied API methods.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-    _connection_class = Connection
-
-    def __init__(self, project=None, namespace=None,
-                 credentials=None, http=None):
-        _ClientProjectMixin.__init__(self, project=project)
-        self.namespace = namespace
-        self._batch_stack = _LocalStack()
-        super(Client, self).__init__(credentials, http)
-
-    @staticmethod
-    def _determine_default(project):
-        """Helper:  override default project detection."""
-        return _determine_default_project(project)
-
-    def _push_batch(self, batch):
-        """Push a batch/transaction onto our stack.
-
-        "Protected", intended for use by batch / transaction context mgrs.
-
-        :type batch: :class:`google.cloud.datastore.batch.Batch`, or an object
-                     implementing its API.
-        :param batch: newly-active batch/transaction.
-        """
-        self._batch_stack.push(batch)
-
-    def _pop_batch(self):
-        """Pop a batch/transaction from our stack.
-
-        "Protected", intended for use by batch / transaction context mgrs.
-
-        :raises: IndexError if the stack is empty.
-        :rtype: :class:`google.cloud.datastore.batch.Batch`, or an object
-                 implementing its API.
-        :returns: the top-most batch/transaction, after removing it.
-        """
-        return self._batch_stack.pop()
-
-    @property
-    def current_batch(self):
-        """Currently-active batch.
-
-        :rtype: :class:`google.cloud.datastore.batch.Batch`, or an object
-                implementing its API, or ``NoneType`` (if no batch is active).
-        :returns: The batch/transaction at the top of the batch stack.
-        """
-        return self._batch_stack.top
-
-    @property
-    def current_transaction(self):
-        """Currently-active transaction.
-
-        :rtype: :class:`google.cloud.datastore.transaction.Transaction`, or an
-                object implementing its API, or ``NoneType`` (if no transaction
-                is active).
-        :returns: The transaction at the top of the batch stack.
-        """
-        transaction = self.current_batch
-        if isinstance(transaction, Transaction):
-            return transaction
-
-    def get(self, key, missing=None, deferred=None, transaction=None):
-        """Retrieve an entity from a single key (if it exists).
-
-        .. note::
-
-           This is just a thin wrapper over :meth:`get_multi`.
-           The backend API does not make a distinction between a single key or
-           multiple keys in a lookup request.
-
-        :type key: :class:`google.cloud.datastore.key.Key`
-        :param key: The key to be retrieved from the datastore.
-
-        :type missing: list
-        :param missing: (Optional) If a list is passed, the key-only entities
-                        returned by the backend as "missing" will be copied
-                        into it.
-
-        :type deferred: list
-        :param deferred: (Optional) If a list is passed, the keys returned
-                         by the backend as "deferred" will be copied into it.
-
-        :type transaction: :class:`~.transaction.Transaction`
-        :param transaction: (Optional) Transaction to use for read consistency.
-                            If not passed, uses current transaction, if set.
-
-        :rtype: :class:`google.cloud.datastore.entity.Entity` or ``NoneType``
-        :returns: The requested entity if it exists.
-        """
-        entities = self.get_multi(keys=[key], missing=missing,
-                                  deferred=deferred, transaction=transaction)
-        if entities:
-            return entities[0]
-
-    def get_multi(self, keys, missing=None, deferred=None, transaction=None):
-        """Retrieve entities, along with their attributes.
-
-        :type keys: list of :class:`google.cloud.datastore.key.Key`
-        :param keys: The keys to be retrieved from the datastore.
-
-        :type missing: list
-        :param missing: (Optional) If a list is passed, the key-only entities
-                        returned by the backend as "missing" will be copied
-                        into it. If the list is not empty, an error will occur.
-
-        :type deferred: list
-        :param deferred: (Optional) If a list is passed, the keys returned
-                         by the backend as "deferred" will be copied into it.
-                         If the list is not empty, an error will occur.
-
-        :type transaction: :class:`~.transaction.Transaction`
-        :param transaction: (Optional) Transaction to use for read consistency.
-                            If not passed, uses current transaction, if set.
-
-        :rtype: list of :class:`google.cloud.datastore.entity.Entity`
-        :returns: The requested entities.
-        :raises: :class:`ValueError` if one or more of ``keys`` has a project
-                 which does not match our project.
-        """
-        if not keys:
-            return []
-
-        ids = set(key.project for key in keys)
-        for current_id in ids:
-            if current_id != self.project:
-                raise ValueError('Keys do not match project')
-
-        if transaction is None:
-            transaction = self.current_transaction
-
-        entity_pbs = _extended_lookup(
-            connection=self.connection,
-            project=self.project,
-            key_pbs=[k.to_protobuf() for k in keys],
-            missing=missing,
-            deferred=deferred,
-            transaction_id=transaction and transaction.id,
-        )
-
-        if missing is not None:
-            missing[:] = [
-                helpers.entity_from_protobuf(missed_pb)
-                for missed_pb in missing]
-
-        if deferred is not None:
-            deferred[:] = [
-                helpers.key_from_protobuf(deferred_pb)
-                for deferred_pb in deferred]
-
-        return [helpers.entity_from_protobuf(entity_pb)
-                for entity_pb in entity_pbs]
-
-    def put(self, entity):
-        """Save an entity in the Cloud Datastore.
-
-        .. note::
-
-           This is just a thin wrapper over :meth:`put_multi`.
-           The backend API does not make a distinction between a single
-           entity or multiple entities in a commit request.
-
-        :type entity: :class:`google.cloud.datastore.entity.Entity`
-        :param entity: The entity to be saved to the datastore.
-        """
-        self.put_multi(entities=[entity])
-
-    def put_multi(self, entities):
-        """Save entities in the Cloud Datastore.
-
-        :type entities: list of :class:`google.cloud.datastore.entity.Entity`
-        :param entities: The entities to be saved to the datastore.
-
-        :raises: :class:`ValueError` if ``entities`` is a single entity.
-        """
-        if isinstance(entities, Entity):
-            raise ValueError("Pass a sequence of entities")
-
-        if not entities:
-            return
-
-        current = self.current_batch
-        in_batch = current is not None
-
-        if not in_batch:
-            current = self.batch()
-            current.begin()
-
-        for entity in entities:
-            current.put(entity)
-
-        if not in_batch:
-            current.commit()
-
-    def delete(self, key):
-        """Delete the key in the Cloud Datastore.
-
-        .. note::
-
-           This is just a thin wrapper over :meth:`delete_multi`.
-           The backend API does not make a distinction between a single key or
-           multiple keys in a commit request.
-
-        :type key: :class:`google.cloud.datastore.key.Key`
-        :param key: The key to be deleted from the datastore.
-        """
-        self.delete_multi(keys=[key])
-
-    def delete_multi(self, keys):
-        """Delete keys from the Cloud Datastore.
-
-        :type keys: list of :class:`google.cloud.datastore.key.Key`
-        :param keys: The keys to be deleted from the Datastore.
-        """
-        if not keys:
-            return
-
-        # We allow partial keys to attempt a delete, the backend will fail.
-        current = self.current_batch
-        in_batch = current is not None
-
-        if not in_batch:
-            current = self.batch()
-            current.begin()
-
-        for key in keys:
-            current.delete(key)
-
-        if not in_batch:
-            current.commit()
-
-    def allocate_ids(self, incomplete_key, num_ids):
-        """Allocate a list of IDs from a partial key.
-
-        :type incomplete_key: :class:`google.cloud.datastore.key.Key`
-        :param incomplete_key: Partial key to use as base for allocated IDs.
-
-        :type num_ids: int
-        :param num_ids: The number of IDs to allocate.
-
-        :rtype: list of :class:`google.cloud.datastore.key.Key`
-        :returns: The (complete) keys allocated with ``incomplete_key`` as
-                  root.
-        :raises: :class:`ValueError` if ``incomplete_key`` is not a
-                 partial key.
-        """
-        if not incomplete_key.is_partial:
-            raise ValueError(('Key is not partial.', incomplete_key))
-
-        incomplete_key_pb = incomplete_key.to_protobuf()
-        incomplete_key_pbs = [incomplete_key_pb] * num_ids
-
-        conn = self.connection
-        allocated_key_pbs = conn.allocate_ids(incomplete_key.project,
-                                              incomplete_key_pbs)
-        allocated_ids = [allocated_key_pb.path[-1].id
-                         for allocated_key_pb in allocated_key_pbs]
-        return [incomplete_key.completed_key(allocated_id)
-                for allocated_id in allocated_ids]
-
-    def key(self, *path_args, **kwargs):
-        """Proxy to :class:`google.cloud.datastore.key.Key`.
-
-        Passes our ``project``.
-        """
-        if 'project' in kwargs:
-            raise TypeError('Cannot pass project')
-        kwargs['project'] = self.project
-        if 'namespace' not in kwargs:
-            kwargs['namespace'] = self.namespace
-        return Key(*path_args, **kwargs)
-
-    def batch(self):
-        """Proxy to :class:`google.cloud.datastore.batch.Batch`."""
-        return Batch(self)
-
-    def transaction(self):
-        """Proxy to :class:`google.cloud.datastore.transaction.Transaction`."""
-        return Transaction(self)
-
-    def query(self, **kwargs):
-        """Proxy to :class:`google.cloud.datastore.query.Query`.
-
-        Passes our ``project``.
-
-        Using query to search a datastore::
-
-        >>> from google.cloud import datastore
-        >>> client = datastore.Client()
-        >>> query = client.query(kind='MyKind')
-        >>> query.add_filter('property', '=', 'val')
-
-        Using the query iterator's
-        :meth:`~google.cloud.datastore.query.Iterator.next_page` method:
-
-        >>> query_iter = query.fetch()
-        >>> entities, more_results, cursor = query_iter.next_page()
-        >>> entities
-        [<list of Entity unmarshalled from protobuf>]
-        >>> more_results
-        <boolean of more results>
-        >>> cursor
-        <string containing cursor where fetch stopped>
-
-        Under the hood this is doing:
-
-        >>> connection.run_query('project', query.to_protobuf())
-        [<list of Entity Protobufs>], cursor, more_results, skipped_results
-
-        :type kwargs: dict
-        :param kwargs: Parameters for initializing and instance of
-                       :class:`google.cloud.datastore.query.Query`.
-
-        :rtype: :class:`google.cloud.datastore.query.Query`
-        :returns: An instance of :class:`google.cloud.datastore.query.Query`
-        """
-        if 'client' in kwargs:
-            raise TypeError('Cannot pass client')
-        if 'project' in kwargs:
-            raise TypeError('Cannot pass project')
-        kwargs['project'] = self.project
-        if 'namespace' not in kwargs:
-            kwargs['namespace'] = self.namespace
-        return Query(self, **kwargs)
diff --git a/google/cloud/datastore/connection.py b/google/cloud/datastore/connection.py
deleted file mode 100644
index 9382eb533176..000000000000
--- a/google/cloud/datastore/connection.py
+++ /dev/null
@@ -1,672 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Connections to Google Cloud Datastore API servers."""
-
-import os
-
-from google.rpc import status_pb2
-
-from google.cloud._helpers import make_insecure_stub
-from google.cloud._helpers import make_secure_stub
-from google.cloud import connection as connection_module
-from google.cloud.environment_vars import DISABLE_GRPC
-from google.cloud.environment_vars import GCD_HOST
-from google.cloud.exceptions import Conflict
-from google.cloud.exceptions import GrpcRendezvous
-from google.cloud.exceptions import make_exception
-from google.cloud.datastore._generated import datastore_pb2 as _datastore_pb2
-# pylint: disable=ungrouped-imports
-try:
-    from grpc import StatusCode
-    from google.cloud.datastore._generated import datastore_grpc_pb2
-except ImportError:  # pragma: NO COVER
-    _HAVE_GRPC = False
-    datastore_grpc_pb2 = None
-    StatusCode = None
-else:
-    _HAVE_GRPC = True
-# pylint: enable=ungrouped-imports
-
-
-DATASTORE_API_HOST = 'datastore.googleapis.com'
-"""Datastore API request host."""
-
-_DISABLE_GRPC = os.getenv(DISABLE_GRPC, False)
-_USE_GRPC = _HAVE_GRPC and not _DISABLE_GRPC
-
-
-class _DatastoreAPIOverHttp(object):
-    """Helper mapping datastore API methods.
-
-    Makes requests to send / receive protobuf content over HTTP/1.1.
-
-    Methods make bare API requests without any helpers for constructing
-    the requests or parsing the responses.
-
-    :type connection: :class:`google.cloud.datastore.connection.Connection`
-    :param connection: A connection object that contains helpful
-                       information for making requests.
-    """
-
-    def __init__(self, connection):
-        self.connection = connection
-
-    def _request(self, project, method, data):
-        """Make a request over the Http transport to the Cloud Datastore API.
-
-        :type project: string
-        :param project: The project to make the request for.
-
-        :type method: string
-        :param method: The API call method name (ie, ``runQuery``,
-                       ``lookup``, etc)
-
-        :type data: string
-        :param data: The data to send with the API call.
-                     Typically this is a serialized Protobuf string.
-
-        :rtype: string
-        :returns: The string response content from the API call.
-        :raises: :class:`google.cloud.exceptions.GoogleCloudError` if the
-                 response code is not 200 OK.
-        """
-        headers = {
-            'Content-Type': 'application/x-protobuf',
-            'Content-Length': str(len(data)),
-            'User-Agent': self.connection.USER_AGENT,
-        }
-        headers, content = self.connection.http.request(
-            uri=self.connection.build_api_url(project=project, method=method),
-            method='POST', headers=headers, body=data)
-
-        status = headers['status']
-        if status != '200':
-            error_status = status_pb2.Status.FromString(content)
-            raise make_exception(headers, error_status.message, use_json=False)
-
-        return content
-
-    def _rpc(self, project, method, request_pb, response_pb_cls):
-        """Make a protobuf RPC request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type method: string
-        :param method: The name of the method to invoke.
-
-        :type request_pb: :class:`google.protobuf.message.Message` instance
-        :param request_pb: the protobuf instance representing the request.
-
-        :type response_pb_cls: A :class:`google.protobuf.message.Message`
-                               subclass.
-        :param response_pb_cls: The class used to unmarshall the response
-                                protobuf.
-
-        :rtype: :class:`google.protobuf.message.Message`
-        :returns: The RPC message parsed from the response.
-        """
-        response = self._request(project=project, method=method,
-                                 data=request_pb.SerializeToString())
-        return response_pb_cls.FromString(response)
-
-    def lookup(self, project, request_pb):
-        """Perform a ``lookup`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.LookupRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.LookupResponse`
-        :returns: The returned protobuf response object.
-        """
-        return self._rpc(project, 'lookup', request_pb,
-                         _datastore_pb2.LookupResponse)
-
-    def run_query(self, project, request_pb):
-        """Perform a ``runQuery`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.RunQueryRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.RunQueryResponse`
-        :returns: The returned protobuf response object.
-        """
-        return self._rpc(project, 'runQuery', request_pb,
-                         _datastore_pb2.RunQueryResponse)
-
-    def begin_transaction(self, project, request_pb):
-        """Perform a ``beginTransaction`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb:
-            :class:`._generated.datastore_pb2.BeginTransactionRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.BeginTransactionResponse`
-        :returns: The returned protobuf response object.
-        """
-        return self._rpc(project, 'beginTransaction', request_pb,
-                         _datastore_pb2.BeginTransactionResponse)
-
-    def commit(self, project, request_pb):
-        """Perform a ``commit`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.CommitRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.CommitResponse`
-        :returns: The returned protobuf response object.
-        """
-        return self._rpc(project, 'commit', request_pb,
-                         _datastore_pb2.CommitResponse)
-
-    def rollback(self, project, request_pb):
-        """Perform a ``rollback`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.RollbackRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.RollbackResponse`
-        :returns: The returned protobuf response object.
-        """
-        return self._rpc(project, 'rollback', request_pb,
-                         _datastore_pb2.RollbackResponse)
-
-    def allocate_ids(self, project, request_pb):
-        """Perform an ``allocateIds`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.AllocateIdsRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.AllocateIdsResponse`
-        :returns: The returned protobuf response object.
-        """
-        return self._rpc(project, 'allocateIds', request_pb,
-                         _datastore_pb2.AllocateIdsResponse)
-
-
-class _DatastoreAPIOverGRPC(object):
-    """Helper mapping datastore API methods.
-
-    Makes requests to send / receive protobuf content over gRPC.
-
-    Methods make bare API requests without any helpers for constructing
-    the requests or parsing the responses.
-
-    :type connection: :class:`google.cloud.datastore.connection.Connection`
-    :param connection: A connection object that contains helpful
-                       information for making requests.
-
-    :type secure: bool
-    :param secure: Flag indicating if a secure stub connection is needed.
-    """
-
-    def __init__(self, connection, secure):
-        if secure:
-            self._stub = make_secure_stub(connection.credentials,
-                                          connection.USER_AGENT,
-                                          datastore_grpc_pb2.DatastoreStub,
-                                          connection.host)
-        else:
-            self._stub = make_insecure_stub(datastore_grpc_pb2.DatastoreStub,
-                                            connection.host)
-
-    def lookup(self, project, request_pb):
-        """Perform a ``lookup`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.LookupRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.LookupResponse`
-        :returns: The returned protobuf response object.
-        """
-        request_pb.project_id = project
-        return self._stub.Lookup(request_pb)
-
-    def run_query(self, project, request_pb):
-        """Perform a ``runQuery`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.RunQueryRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.RunQueryResponse`
-        :returns: The returned protobuf response object.
-        """
-        request_pb.project_id = project
-        return self._stub.RunQuery(request_pb)
-
-    def begin_transaction(self, project, request_pb):
-        """Perform a ``beginTransaction`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb:
-            :class:`._generated.datastore_pb2.BeginTransactionRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.BeginTransactionResponse`
-        :returns: The returned protobuf response object.
-        """
-        request_pb.project_id = project
-        return self._stub.BeginTransaction(request_pb)
-
-    def commit(self, project, request_pb):
-        """Perform a ``commit`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.CommitRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.CommitResponse`
-        :returns: The returned protobuf response object.
-        """
-        request_pb.project_id = project
-        try:
-            return self._stub.Commit(request_pb)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.ABORTED:
-                raise Conflict(exc.details())
-            raise
-
-    def rollback(self, project, request_pb):
-        """Perform a ``rollback`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.RollbackRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.RollbackResponse`
-        :returns: The returned protobuf response object.
-        """
-        request_pb.project_id = project
-        return self._stub.Rollback(request_pb)
-
-    def allocate_ids(self, project, request_pb):
-        """Perform an ``allocateIds`` request.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type request_pb: :class:`._generated.datastore_pb2.AllocateIdsRequest`
-        :param request_pb: The request protobuf object.
-
-        :rtype: :class:`._generated.datastore_pb2.AllocateIdsResponse`
-        :returns: The returned protobuf response object.
-        """
-        request_pb.project_id = project
-        return self._stub.AllocateIds(request_pb)
-
-
-class Connection(connection_module.Connection):
-    """A connection to the Google Cloud Datastore via the Protobuf API.
-
-    This class should understand only the basic types (and protobufs)
-    in method arguments, however it should be capable of returning advanced
-    types.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: The OAuth2 Credentials to use for this connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests.
-    """
-
-    API_BASE_URL = 'https://' + DATASTORE_API_HOST
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = ('{api_base}/{api_version}/projects'
-                        '/{project}:{method}')
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/datastore',)
-    """The scopes required for authenticating as a Cloud Datastore consumer."""
-
-    def __init__(self, credentials=None, http=None):
-        super(Connection, self).__init__(credentials=credentials, http=http)
-        try:
-            self.host = os.environ[GCD_HOST]
-            self.api_base_url = 'http://' + self.host
-            secure = False
-        except KeyError:
-            self.host = DATASTORE_API_HOST
-            self.api_base_url = self.__class__.API_BASE_URL
-            secure = True
-        if _USE_GRPC:
-            self._datastore_api = _DatastoreAPIOverGRPC(self, secure=secure)
-        else:
-            self._datastore_api = _DatastoreAPIOverHttp(self)
-
-    def build_api_url(self, project, method, base_url=None,
-                      api_version=None):
-        """Construct the URL for a particular API call.
-
-        This method is used internally to come up with the URL to use when
-        making RPCs to the Cloud Datastore API.
-
-        :type project: string
-        :param project: The project to connect to. This is
-                        usually your project name in the cloud console.
-
-        :type method: string
-        :param method: The API method to call (e.g. 'runQuery', 'lookup').
-
-        :type base_url: string
-        :param base_url: The base URL where the API lives.
-                         You shouldn't have to provide this.
-
-        :type api_version: string
-        :param api_version: The version of the API to connect to.
-                            You shouldn't have to provide this.
-
-        :rtype: str
-        :returns: The API URL created.
-        """
-        return self.API_URL_TEMPLATE.format(
-            api_base=(base_url or self.api_base_url),
-            api_version=(api_version or self.API_VERSION),
-            project=project, method=method)
-
-    def lookup(self, project, key_pbs,
-               eventual=False, transaction_id=None):
-        """Lookup keys from a project in the Cloud Datastore.
-
-        Maps the ``DatastoreService.Lookup`` protobuf RPC.
-
-        This uses mostly protobufs
-        (:class:`google.cloud.datastore._generated.entity_pb2.Key` as input
-        and :class:`google.cloud.datastore._generated.entity_pb2.Entity`
-        as output). It is used under the hood in
-        :meth:`Client.get() <.datastore.client.Client.get>`:
-
-        >>> from google.cloud import datastore
-        >>> client = datastore.Client(project='project')
-        >>> key = client.key('MyKind', 1234)
-        >>> client.get(key)
-        [<Entity object>]
-
-        Using a :class:`Connection` directly:
-
-        >>> connection.lookup('project', [key.to_protobuf()])
-        [<Entity protobuf>]
-
-        :type project: string
-        :param project: The project to look up the keys in.
-
-        :type key_pbs: list of
-                       :class:`google.cloud.datastore._generated.entity_pb2.Key`
-        :param key_pbs: The keys to retrieve from the datastore.
-
-        :type eventual: bool
-        :param eventual: If False (the default), request ``STRONG`` read
-                         consistency.  If True, request ``EVENTUAL`` read
-                         consistency.
-
-        :type transaction_id: string
-        :param transaction_id: If passed, make the request in the scope of
-                               the given transaction.  Incompatible with
-                               ``eventual==True``.
-
-        :rtype: tuple
-        :returns: A triple of (``results``, ``missing``, ``deferred``) where
-                  both ``results`` and ``missing`` are lists of
-                  :class:`google.cloud.datastore._generated.entity_pb2.Entity`
-                  and ``deferred`` is a list of
-                  :class:`google.cloud.datastore._generated.entity_pb2.Key`.
-        """
-        lookup_request = _datastore_pb2.LookupRequest()
-        _set_read_options(lookup_request, eventual, transaction_id)
-        _add_keys_to_request(lookup_request.keys, key_pbs)
-
-        lookup_response = self._datastore_api.lookup(project, lookup_request)
-
-        results = [result.entity for result in lookup_response.found]
-        missing = [result.entity for result in lookup_response.missing]
-
-        return results, missing, list(lookup_response.deferred)
-
-    def run_query(self, project, query_pb, namespace=None,
-                  eventual=False, transaction_id=None):
-        """Run a query on the Cloud Datastore.
-
-        Maps the ``DatastoreService.RunQuery`` protobuf RPC.
-
-        Given a Query protobuf, sends a ``runQuery`` request to the
-        Cloud Datastore API and returns a list of entity protobufs
-        matching the query.
-
-        You typically wouldn't use this method directly, in favor of the
-        :meth:`google.cloud.datastore.query.Query.fetch` method.
-
-        Under the hood, the :class:`google.cloud.datastore.query.Query` class
-        uses this method to fetch data.
-
-        :type project: string
-        :param project: The project over which to run the query.
-
-        :type query_pb: :class:`.datastore._generated.query_pb2.Query`
-        :param query_pb: The Protobuf representing the query to run.
-
-        :type namespace: string
-        :param namespace: The namespace over which to run the query.
-
-        :type eventual: bool
-        :param eventual: If False (the default), request ``STRONG`` read
-                         consistency.  If True, request ``EVENTUAL`` read
-                         consistency.
-
-        :type transaction_id: string
-        :param transaction_id: If passed, make the request in the scope of
-                               the given transaction.  Incompatible with
-                               ``eventual==True``.
-
-        :rtype: tuple
-        :returns: Four-tuple containing the entities returned,
-                  the end cursor of the query, a ``more_results``
-                  enum and a count of the number of skipped results.
-        """
-        request = _datastore_pb2.RunQueryRequest()
-        _set_read_options(request, eventual, transaction_id)
-
-        if namespace:
-            request.partition_id.namespace_id = namespace
-
-        request.query.CopyFrom(query_pb)
-        response = self._datastore_api.run_query(project, request)
-        return (
-            [e.entity for e in response.batch.entity_results],
-            response.batch.end_cursor,  # Assume response always has cursor.
-            response.batch.more_results,
-            response.batch.skipped_results,
-        )
-
-    def begin_transaction(self, project):
-        """Begin a transaction.
-
-        Maps the ``DatastoreService.BeginTransaction`` protobuf RPC.
-
-        :type project: string
-        :param project: The project to which the transaction applies.
-
-        :rtype: bytes
-        :returns: The serialized transaction that was begun.
-        """
-        request = _datastore_pb2.BeginTransactionRequest()
-        response = self._datastore_api.begin_transaction(project, request)
-        return response.transaction
-
-    def commit(self, project, request, transaction_id):
-        """Commit mutations in context of current transaction (if any).
-
-        Maps the ``DatastoreService.Commit`` protobuf RPC.
-
-        :type project: string
-        :param project: The project to which the transaction applies.
-
-        :type request: :class:`._generated.datastore_pb2.CommitRequest`
-        :param request: The protobuf with the mutations being committed.
-
-        :type transaction_id: string or None
-        :param transaction_id: The transaction ID returned from
-                               :meth:`begin_transaction`.  Non-transactional
-                               batches must pass ``None``.
-
-        .. note::
-
-            This method will mutate ``request`` before using it.
-
-        :rtype: tuple
-        :returns: The pair of the number of index updates and a list of
-                  :class:`._generated.entity_pb2.Key` for each incomplete key
-                  that was completed in the commit.
-        """
-        if transaction_id:
-            request.mode = _datastore_pb2.CommitRequest.TRANSACTIONAL
-            request.transaction = transaction_id
-        else:
-            request.mode = _datastore_pb2.CommitRequest.NON_TRANSACTIONAL
-
-        response = self._datastore_api.commit(project, request)
-        return _parse_commit_response(response)
-
-    def rollback(self, project, transaction_id):
-        """Rollback the connection's existing transaction.
-
-        Maps the ``DatastoreService.Rollback`` protobuf RPC.
-
-        :type project: string
-        :param project: The project to which the transaction belongs.
-
-        :type transaction_id: string
-        :param transaction_id: The transaction ID returned from
-                               :meth:`begin_transaction`.
-        """
-        request = _datastore_pb2.RollbackRequest()
-        request.transaction = transaction_id
-        # Nothing to do with this response, so just execute the method.
-        self._datastore_api.rollback(project, request)
-
-    def allocate_ids(self, project, key_pbs):
-        """Obtain backend-generated IDs for a set of keys.
-
-        Maps the ``DatastoreService.AllocateIds`` protobuf RPC.
-
-        :type project: string
-        :param project: The project to which the transaction belongs.
-
-        :type key_pbs: list of
-                       :class:`google.cloud.datastore._generated.entity_pb2.Key`
-        :param key_pbs: The keys for which the backend should allocate IDs.
-
-        :rtype: list of :class:`.datastore._generated.entity_pb2.Key`
-        :returns: An equal number of keys,  with IDs filled in by the backend.
-        """
-        request = _datastore_pb2.AllocateIdsRequest()
-        _add_keys_to_request(request.keys, key_pbs)
-        # Nothing to do with this response, so just execute the method.
-        response = self._datastore_api.allocate_ids(project, request)
-        return list(response.keys)
-
-
-def _set_read_options(request, eventual, transaction_id):
-    """Validate rules for read options, and assign to the request.
-
-    Helper method for ``lookup()`` and ``run_query``.
-
-    :raises: :class:`ValueError` if ``eventual`` is ``True`` and the
-             ``transaction_id`` is not ``None``.
-    """
-    if eventual and (transaction_id is not None):
-        raise ValueError('eventual must be False when in a transaction')
-
-    opts = request.read_options
-    if eventual:
-        opts.read_consistency = _datastore_pb2.ReadOptions.EVENTUAL
-    elif transaction_id:
-        opts.transaction = transaction_id
-
-
-def _add_keys_to_request(request_field_pb, key_pbs):
-    """Add protobuf keys to a request object.
-
-    :type request_field_pb: `RepeatedCompositeFieldContainer`
-    :param request_field_pb: A repeated proto field that contains keys.
-
-    :type key_pbs: list of :class:`.datastore._generated.entity_pb2.Key`
-    :param key_pbs: The keys to add to a request.
-    """
-    for key_pb in key_pbs:
-        request_field_pb.add().CopyFrom(key_pb)
-
-
-def _parse_commit_response(commit_response_pb):
-    """Extract response data from a commit response.
-
-    :type commit_response_pb: :class:`._generated.datastore_pb2.CommitResponse`
-    :param commit_response_pb: The protobuf response from a commit request.
-
-    :rtype: tuple
-    :returns: The pair of the number of index updates and a list of
-              :class:`._generated.entity_pb2.Key` for each incomplete key
-              that was completed in the commit.
-    """
-    mut_results = commit_response_pb.mutation_results
-    index_updates = commit_response_pb.index_updates
-    completed_keys = [mut_result.key for mut_result in mut_results
-                      if mut_result.HasField('key')]  # Message field (Key)
-    return index_updates, completed_keys
diff --git a/google/cloud/datastore/entity.py b/google/cloud/datastore/entity.py
deleted file mode 100644
index d9ad4473f224..000000000000
--- a/google/cloud/datastore/entity.py
+++ /dev/null
@@ -1,143 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Class for representing a single entity in the Cloud Datastore."""
-
-
-from google.cloud._helpers import _ensure_tuple_or_list
-
-
-class Entity(dict):
-    """Entities are akin to rows in a relational database
-
-    An entity storing the actual instance of data.
-
-    Each entity is officially represented with a
-    :class:`google.cloud.datastore.key.Key` class, however it is possible that
-    you might create an Entity with only a partial Key (that is, a Key
-    with a Kind, and possibly a parent, but without an ID).  In such a
-    case, the datastore service will automatically assign an ID to the
-    partial key.
-
-    Entities in this API act like dictionaries with extras built in that
-    allow you to delete or persist the data stored on the entity.
-
-    Entities are mutable and act like a subclass of a dictionary.
-    This means you could take an existing entity and change the key
-    to duplicate the object.
-
-    Use :func:`google.cloud.datastore.get` to retrieve an existing entity.
-
-      >>> from google.cloud import datastore
-      >>> client = datastore.Client()
-      >>> client.get(key)
-      <Entity[{'kind': 'EntityKind', id: 1234}] {'property': 'value'}>
-
-    You can the set values on the entity just like you would on any
-    other dictionary.
-
-    >>> entity['age'] = 20
-    >>> entity['name'] = 'JJ'
-    >>> entity
-    <Entity[{'kind': 'EntityKind', id: 1234}] {'age': 20, 'name': 'JJ'}>
-
-    And you can convert an entity to a regular Python dictionary with the
-    ``dict`` builtin:
-
-    >>> dict(entity)
-    {'age': 20, 'name': 'JJ'}
-
-    .. note::
-
-       When saving an entity to the backend, values which are "text"
-       (``unicode`` in Python2, ``str`` in Python3) will be saved using
-       the 'text_value' field, after being encoded to UTF-8.  When
-       retrieved from the back-end, such values will be decoded to "text"
-       again.  Values which are "bytes" (``str`` in Python2, ``bytes`` in
-       Python3), will be saved using the 'blob_value' field, without
-       any decoding / encoding step.
-
-    :type key: :class:`google.cloud.datastore.key.Key`
-    :param key: Optional key to be set on entity.
-
-    :type exclude_from_indexes: tuple of string
-    :param exclude_from_indexes: Names of fields whose values are not to be
-                                 indexed for this entity.
-    """
-
-    def __init__(self, key=None, exclude_from_indexes=()):
-        super(Entity, self).__init__()
-        self.key = key
-        self._exclude_from_indexes = set(_ensure_tuple_or_list(
-            'exclude_from_indexes', exclude_from_indexes))
-        # NOTE: This will be populated when parsing a protobuf in
-        #       google.cloud.datastore.helpers.entity_from_protobuf.
-        self._meanings = {}
-
-    def __eq__(self, other):
-        """Compare two entities for equality.
-
-        Entities compare equal if their keys compare equal and their
-        properties compare equal.
-
-        :rtype: boolean
-        :returns: True if the entities compare equal, else False.
-        """
-        if not isinstance(other, Entity):
-            return False
-
-        return (self.key == other.key and
-                self._exclude_from_indexes == other._exclude_from_indexes and
-                self._meanings == other._meanings and
-                super(Entity, self).__eq__(other))
-
-    def __ne__(self, other):
-        """Compare two entities for inequality.
-
-        Entities compare equal if their keys compare equal and their
-        properties compare equal.
-
-        :rtype: boolean
-        :returns: False if the entities compare equal, else True.
-        """
-        return not self.__eq__(other)
-
-    @property
-    def kind(self):
-        """Get the kind of the current entity.
-
-        .. note::
-          This relies entirely on the :class:`google.cloud.datastore.key.Key`
-          set on the entity.  That means that we're not storing the kind
-          of the entity at all, just the properties and a pointer to a
-          Key which knows its Kind.
-        """
-        if self.key:
-            return self.key.kind
-
-    @property
-    def exclude_from_indexes(self):
-        """Names of fields which are *not* to be indexed for this entity.
-
-        :rtype: sequence of field names
-        :returns: The set of fields excluded from indexes.
-        """
-        return frozenset(self._exclude_from_indexes)
-
-    def __repr__(self):
-        if self.key:
-            return '<Entity%s %s>' % (self.key.path,
-                                      super(Entity, self).__repr__())
-        else:
-            return '<Entity %s>' % (super(Entity, self).__repr__())
diff --git a/google/cloud/datastore/helpers.py b/google/cloud/datastore/helpers.py
deleted file mode 100644
index 2725308351d6..000000000000
--- a/google/cloud/datastore/helpers.py
+++ /dev/null
@@ -1,472 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Helper functions for dealing with Cloud Datastore's Protobuf API.
-
-The non-private functions are part of the API.
-"""
-
-import datetime
-import itertools
-
-from google.protobuf import struct_pb2
-from google.type import latlng_pb2
-import six
-
-# pylint: disable=ungrouped-imports
-from google.cloud._helpers import _datetime_to_pb_timestamp
-from google.cloud._helpers import _pb_timestamp_to_datetime
-from google.cloud.datastore._generated import entity_pb2 as _entity_pb2
-from google.cloud.datastore.entity import Entity
-from google.cloud.datastore.key import Key
-# pylint: enable=ungrouped-imports
-
-__all__ = ('entity_from_protobuf', 'key_from_protobuf')
-
-
-def _get_meaning(value_pb, is_list=False):
-    """Get the meaning from a protobuf value.
-
-    :type value_pb: :class:`google.cloud.datastore._generated.entity_pb2.Value`
-    :param value_pb: The protobuf value to be checked for an
-                     associated meaning.
-
-    :type is_list: bool
-    :param is_list: Boolean indicating if the ``value_pb`` contains
-                    a list value.
-
-    :rtype: int
-    :returns: The meaning for the ``value_pb`` if one is set, else
-              :data:`None`. For a list value, if there are disagreeing
-              means it just returns a list of meanings. If all the
-              list meanings agree, it just condenses them.
-    """
-    meaning = None
-    if is_list:
-        # An empty list will have no values, hence no shared meaning
-        # set among them.
-        if len(value_pb.array_value.values) == 0:
-            return None
-
-        # We check among all the meanings, some of which may be None,
-        # the rest which may be enum/int values.
-        all_meanings = [_get_meaning(sub_value_pb)
-                        for sub_value_pb in value_pb.array_value.values]
-        unique_meanings = set(all_meanings)
-        if len(unique_meanings) == 1:
-            # If there is a unique meaning, we preserve it.
-            meaning = unique_meanings.pop()
-        else:  # We know len(value_pb.array_value.values) > 0.
-            # If the meaning is not unique, just return all of them.
-            meaning = all_meanings
-    elif value_pb.meaning:  # Simple field (int32).
-        meaning = value_pb.meaning
-
-    return meaning
-
-
-def _new_value_pb(entity_pb, name):
-    """Add (by name) a new ``Value`` protobuf to an entity protobuf.
-
-    :type entity_pb: :class:`.datastore._generated.entity_pb2.Entity`
-    :param entity_pb: An entity protobuf to add a new property to.
-
-    :type name: string
-    :param name: The name of the new property.
-
-    :rtype: :class:`google.cloud.datastore._generated.entity_pb2.Value`
-    :returns: The new ``Value`` protobuf that was added to the entity.
-    """
-    return entity_pb.properties.get_or_create(name)
-
-
-def _property_tuples(entity_pb):
-    """Iterator of name, ``Value`` tuples from entity properties.
-
-    :type entity_pb: :class:`.datastore._generated.entity_pb2.Entity`
-    :param entity_pb: An entity protobuf to add a new property to.
-
-    :rtype: :class:`generator`
-    :returns: An iterator that yields tuples of a name and ``Value``
-              corresponding to properties on the entity.
-    """
-    return six.iteritems(entity_pb.properties)
-
-
-def entity_from_protobuf(pb):
-    """Factory method for creating an entity based on a protobuf.
-
-    The protobuf should be one returned from the Cloud Datastore
-    Protobuf API.
-
-    :type pb: :class:`google.cloud.datastore._generated.entity_pb2.Entity`
-    :param pb: The Protobuf representing the entity.
-
-    :rtype: :class:`google.cloud.datastore.entity.Entity`
-    :returns: The entity derived from the protobuf.
-    """
-    key = None
-    if pb.HasField('key'):  # Message field (Key)
-        key = key_from_protobuf(pb.key)
-
-    entity_props = {}
-    entity_meanings = {}
-    exclude_from_indexes = []
-
-    for prop_name, value_pb in _property_tuples(pb):
-        value = _get_value_from_value_pb(value_pb)
-        entity_props[prop_name] = value
-
-        # Check if the property has an associated meaning.
-        is_list = isinstance(value, list)
-        meaning = _get_meaning(value_pb, is_list=is_list)
-        if meaning is not None:
-            entity_meanings[prop_name] = (meaning, value)
-
-        # Check if ``value_pb`` was excluded from index. Lists need to be
-        # special-cased and we require all ``exclude_from_indexes`` values
-        # in a list agree.
-        if is_list:
-            exclude_values = set(value_pb.exclude_from_indexes
-                                 for value_pb in value_pb.array_value.values)
-            if len(exclude_values) != 1:
-                raise ValueError('For an array_value, subvalues must either '
-                                 'all be indexed or all excluded from '
-                                 'indexes.')
-
-            if exclude_values.pop():
-                exclude_from_indexes.append(prop_name)
-        else:
-            if value_pb.exclude_from_indexes:
-                exclude_from_indexes.append(prop_name)
-
-    entity = Entity(key=key, exclude_from_indexes=exclude_from_indexes)
-    entity.update(entity_props)
-    entity._meanings.update(entity_meanings)
-    return entity
-
-
-def _set_pb_meaning_from_entity(entity, name, value, value_pb,
-                                is_list=False):
-    """Add meaning information (from an entity) to a protobuf.
-
-    :type entity: :class:`google.cloud.datastore.entity.Entity`
-    :param entity: The entity to be turned into a protobuf.
-
-    :type name: string
-    :param name: The name of the property.
-
-    :type value: object
-    :param value: The current value stored as property ``name``.
-
-    :type value_pb: :class:`google.cloud.datastore._generated.entity_pb2.Value`
-    :param value_pb: The protobuf value to add meaning / meanings to.
-
-    :type is_list: bool
-    :param is_list: (Optional) Boolean indicating if the ``value`` is
-                    a list value.
-    """
-    if name not in entity._meanings:
-        return
-
-    meaning, orig_value = entity._meanings[name]
-    # Only add the meaning back to the protobuf if the value is
-    # unchanged from when it was originally read from the API.
-    if orig_value is not value:
-        return
-
-    # For lists, we set meaning on each sub-element.
-    if is_list:
-        if not isinstance(meaning, list):
-            meaning = itertools.repeat(meaning)
-        val_iter = six.moves.zip(value_pb.array_value.values,
-                                 meaning)
-        for sub_value_pb, sub_meaning in val_iter:
-            if sub_meaning is not None:
-                sub_value_pb.meaning = sub_meaning
-    else:
-        value_pb.meaning = meaning
-
-
-def entity_to_protobuf(entity):
-    """Converts an entity into a protobuf.
-
-    :type entity: :class:`google.cloud.datastore.entity.Entity`
-    :param entity: The entity to be turned into a protobuf.
-
-    :rtype: :class:`google.cloud.datastore._generated.entity_pb2.Entity`
-    :returns: The protobuf representing the entity.
-    """
-    entity_pb = _entity_pb2.Entity()
-    if entity.key is not None:
-        key_pb = entity.key.to_protobuf()
-        entity_pb.key.CopyFrom(key_pb)
-
-    for name, value in entity.items():
-        value_is_list = isinstance(value, list)
-        if value_is_list and len(value) == 0:
-            continue
-
-        value_pb = _new_value_pb(entity_pb, name)
-        # Set the appropriate value.
-        _set_protobuf_value(value_pb, value)
-
-        # Add index information to protobuf.
-        if name in entity.exclude_from_indexes:
-            if not value_is_list:
-                value_pb.exclude_from_indexes = True
-
-            for sub_value in value_pb.array_value.values:
-                sub_value.exclude_from_indexes = True
-
-        # Add meaning information to protobuf.
-        _set_pb_meaning_from_entity(entity, name, value, value_pb,
-                                    is_list=value_is_list)
-
-    return entity_pb
-
-
-def key_from_protobuf(pb):
-    """Factory method for creating a key based on a protobuf.
-
-    The protobuf should be one returned from the Cloud Datastore
-    Protobuf API.
-
-    :type pb: :class:`google.cloud.datastore._generated.entity_pb2.Key`
-    :param pb: The Protobuf representing the key.
-
-    :rtype: :class:`google.cloud.datastore.key.Key`
-    :returns: a new `Key` instance
-    """
-    path_args = []
-    for element in pb.path:
-        path_args.append(element.kind)
-        if element.id:  # Simple field (int64)
-            path_args.append(element.id)
-        # This is safe: we expect proto objects returned will only have
-        # one of `name` or `id` set.
-        if element.name:  # Simple field (string)
-            path_args.append(element.name)
-
-    project = None
-    if pb.partition_id.project_id:  # Simple field (string)
-        project = pb.partition_id.project_id
-    namespace = None
-    if pb.partition_id.namespace_id:  # Simple field (string)
-        namespace = pb.partition_id.namespace_id
-
-    return Key(*path_args, namespace=namespace, project=project)
-
-
-def _pb_attr_value(val):
-    """Given a value, return the protobuf attribute name and proper value.
-
-    The Protobuf API uses different attribute names based on value types
-    rather than inferring the type.  This function simply determines the
-    proper attribute name based on the type of the value provided and
-    returns the attribute name as well as a properly formatted value.
-
-    Certain value types need to be coerced into a different type (such
-    as a `datetime.datetime` into an integer timestamp, or a
-    `google.cloud.datastore.key.Key` into a Protobuf representation.  This
-    function handles that for you.
-
-    .. note::
-       Values which are "text" ('unicode' in Python2, 'str' in Python3) map
-       to 'string_value' in the datastore;  values which are "bytes"
-       ('str' in Python2, 'bytes' in Python3) map to 'blob_value'.
-
-    For example:
-
-    >>> _pb_attr_value(1234)
-    ('integer_value', 1234)
-    >>> _pb_attr_value('my_string')
-    ('string_value', 'my_string')
-
-    :type val: `datetime.datetime`, :class:`google.cloud.datastore.key.Key`,
-               bool, float, integer, string
-    :param val: The value to be scrutinized.
-
-    :rtype: tuple
-    :returns: A tuple of the attribute name and proper value type.
-    """
-
-    if isinstance(val, datetime.datetime):
-        name = 'timestamp'
-        value = _datetime_to_pb_timestamp(val)
-    elif isinstance(val, Key):
-        name, value = 'key', val.to_protobuf()
-    elif isinstance(val, bool):
-        name, value = 'boolean', val
-    elif isinstance(val, float):
-        name, value = 'double', val
-    elif isinstance(val, six.integer_types):
-        name, value = 'integer', val
-    elif isinstance(val, six.text_type):
-        name, value = 'string', val
-    elif isinstance(val, (bytes, str)):
-        name, value = 'blob', val
-    elif isinstance(val, Entity):
-        name, value = 'entity', val
-    elif isinstance(val, list):
-        name, value = 'array', val
-    elif isinstance(val, GeoPoint):
-        name, value = 'geo_point', val.to_protobuf()
-    elif val is None:
-        name, value = 'null', struct_pb2.NULL_VALUE
-    else:
-        raise ValueError("Unknown protobuf attr type %s" % type(val))
-
-    return name + '_value', value
-
-
-def _get_value_from_value_pb(value_pb):
-    """Given a protobuf for a Value, get the correct value.
-
-    The Cloud Datastore Protobuf API returns a Property Protobuf which
-    has one value set and the rest blank.  This function retrieves the
-    the one value provided.
-
-    Some work is done to coerce the return value into a more useful type
-    (particularly in the case of a timestamp value, or a key value).
-
-    :type value_pb: :class:`google.cloud.datastore._generated.entity_pb2.Value`
-    :param value_pb: The Value Protobuf.
-
-    :rtype: object
-    :returns: The value provided by the Protobuf.
-    :raises: :class:`ValueError <exceptions.ValueError>` if no value type
-             has been set.
-    """
-    value_type = value_pb.WhichOneof('value_type')
-
-    if value_type == 'timestamp_value':
-        result = _pb_timestamp_to_datetime(value_pb.timestamp_value)
-
-    elif value_type == 'key_value':
-        result = key_from_protobuf(value_pb.key_value)
-
-    elif value_type == 'boolean_value':
-        result = value_pb.boolean_value
-
-    elif value_type == 'double_value':
-        result = value_pb.double_value
-
-    elif value_type == 'integer_value':
-        result = value_pb.integer_value
-
-    elif value_type == 'string_value':
-        result = value_pb.string_value
-
-    elif value_type == 'blob_value':
-        result = value_pb.blob_value
-
-    elif value_type == 'entity_value':
-        result = entity_from_protobuf(value_pb.entity_value)
-
-    elif value_type == 'array_value':
-        result = [_get_value_from_value_pb(value)
-                  for value in value_pb.array_value.values]
-
-    elif value_type == 'geo_point_value':
-        result = GeoPoint(value_pb.geo_point_value.latitude,
-                          value_pb.geo_point_value.longitude)
-
-    elif value_type == 'null_value':
-        result = None
-
-    else:
-        raise ValueError('Value protobuf did not have any value set')
-
-    return result
-
-
-def _set_protobuf_value(value_pb, val):
-    """Assign 'val' to the correct subfield of 'value_pb'.
-
-    The Protobuf API uses different attribute names based on value types
-    rather than inferring the type.
-
-    Some value types (entities, keys, lists) cannot be directly
-    assigned; this function handles them correctly.
-
-    :type value_pb: :class:`google.cloud.datastore._generated.entity_pb2.Value`
-    :param value_pb: The value protobuf to which the value is being assigned.
-
-    :type val: :class:`datetime.datetime`, boolean, float, integer, string,
-               :class:`google.cloud.datastore.key.Key`,
-               :class:`google.cloud.datastore.entity.Entity`
-    :param val: The value to be assigned.
-    """
-    attr, val = _pb_attr_value(val)
-    if attr == 'key_value':
-        value_pb.key_value.CopyFrom(val)
-    elif attr == 'timestamp_value':
-        value_pb.timestamp_value.CopyFrom(val)
-    elif attr == 'entity_value':
-        entity_pb = entity_to_protobuf(val)
-        value_pb.entity_value.CopyFrom(entity_pb)
-    elif attr == 'array_value':
-        l_pb = value_pb.array_value.values
-        for item in val:
-            i_pb = l_pb.add()
-            _set_protobuf_value(i_pb, item)
-    elif attr == 'geo_point_value':
-        value_pb.geo_point_value.CopyFrom(val)
-    else:  # scalar, just assign
-        setattr(value_pb, attr, val)
-
-
-class GeoPoint(object):
-    """Simple container for a geo point value.
-
-    :type latitude: float
-    :param latitude: Latitude of a point.
-
-    :type longitude: float
-    :param longitude: Longitude of a point.
-    """
-
-    def __init__(self, latitude, longitude):
-        self.latitude = latitude
-        self.longitude = longitude
-
-    def to_protobuf(self):
-        """Convert the current object to protobuf.
-
-        :rtype: :class:`google.type.latlng_pb2.LatLng`.
-        :returns: The current point as a protobuf.
-        """
-        return latlng_pb2.LatLng(latitude=self.latitude,
-                                 longitude=self.longitude)
-
-    def __eq__(self, other):
-        """Compare two geo points for equality.
-
-        :rtype: boolean
-        :returns: True if the points compare equal, else False.
-        """
-        if not isinstance(other, GeoPoint):
-            return False
-
-        return (self.latitude == other.latitude and
-                self.longitude == other.longitude)
-
-    def __ne__(self, other):
-        """Compare two geo points for inequality.
-
-        :rtype: boolean
-        :returns: False if the points compare equal, else True.
-        """
-        return not self.__eq__(other)
diff --git a/google/cloud/datastore/key.py b/google/cloud/datastore/key.py
deleted file mode 100644
index c01c6097a04d..000000000000
--- a/google/cloud/datastore/key.py
+++ /dev/null
@@ -1,403 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with Google Cloud Datastore keys."""
-
-import copy
-import six
-
-from google.cloud.datastore._generated import entity_pb2 as _entity_pb2
-
-
-class Key(object):
-    """An immutable representation of a datastore Key.
-
-    To create a basic key:
-
-      >>> Key('EntityKind', 1234)
-      <Key[{'kind': 'EntityKind', 'id': 1234}]>
-      >>> Key('EntityKind', 'foo')
-      <Key[{'kind': 'EntityKind', 'name': 'foo'}]>
-
-    To create a key with a parent:
-
-      >>> Key('Parent', 'foo', 'Child', 1234)
-      <Key[{'kind': 'Parent', 'name': 'foo'}, {'kind': 'Child', 'id': 1234}]>
-      >>> Key('Child', 1234, parent=parent_key)
-      <Key[{'kind': 'Parent', 'name': 'foo'}, {'kind': 'Child', 'id': 1234}]>
-
-    To create a partial key:
-
-      >>> Key('Parent', 'foo', 'Child')
-      <Key[{'kind': 'Parent', 'name': 'foo'}, {'kind': 'Child'}]>
-
-    :type path_args: tuple of string and integer
-    :param path_args: May represent a partial (odd length) or full (even
-                      length) key path.
-
-    :type kwargs: dict
-    :param kwargs: Keyword arguments to be passed in.
-
-    Accepted keyword arguments are
-
-    * namespace (string): A namespace identifier for the key.
-    * project (string): The project associated with the key.
-    * parent (:class:`google.cloud.datastore.key.Key`): The parent of the key.
-
-    The project argument is required unless it has been set implicitly.
-    """
-
-    def __init__(self, *path_args, **kwargs):
-        self._flat_path = path_args
-        parent = self._parent = kwargs.get('parent')
-        self._namespace = kwargs.get('namespace')
-        project = kwargs.get('project')
-        self._project = _validate_project(project, parent)
-        # _flat_path, _parent, _namespace and _project must be set before
-        # _combine_args() is called.
-        self._path = self._combine_args()
-
-    def __eq__(self, other):
-        """Compare two keys for equality.
-
-        Incomplete keys never compare equal to any other key.
-
-        Completed keys compare equal if they have the same path, project,
-        and namespace.
-
-        :rtype: bool
-        :returns: True if the keys compare equal, else False.
-        """
-        if not isinstance(other, Key):
-            return False
-
-        if self.is_partial or other.is_partial:
-            return False
-
-        return (self.flat_path == other.flat_path and
-                self.project == other.project and
-                self.namespace == other.namespace)
-
-    def __ne__(self, other):
-        """Compare two keys for inequality.
-
-        Incomplete keys never compare equal to any other key.
-
-        Completed keys compare equal if they have the same path, project,
-        and namespace.
-
-        :rtype: bool
-        :returns: False if the keys compare equal, else True.
-        """
-        return not self.__eq__(other)
-
-    def __hash__(self):
-        """Hash a keys for use in a dictionary lookp.
-
-        :rtype: integer
-        :returns: a hash of the key's state.
-        """
-        return (hash(self.flat_path) +
-                hash(self.project) +
-                hash(self.namespace))
-
-    @staticmethod
-    def _parse_path(path_args):
-        """Parses positional arguments into key path with kinds and IDs.
-
-        :type path_args: tuple
-        :param path_args: A tuple from positional arguments. Should be
-                          alternating list of kinds (string) and ID/name
-                          parts (int or string).
-
-        :rtype: :class:`list` of :class:`dict`
-        :returns: A list of key parts with kind and ID or name set.
-        :raises: :class:`ValueError` if there are no ``path_args``, if one of
-                 the kinds is not a string or if one of the IDs/names is not
-                 a string or an integer.
-        """
-        if len(path_args) == 0:
-            raise ValueError('Key path must not be empty.')
-
-        kind_list = path_args[::2]
-        id_or_name_list = path_args[1::2]
-        # Dummy sentinel value to pad incomplete key to even length path.
-        partial_ending = object()
-        if len(path_args) % 2 == 1:
-            id_or_name_list += (partial_ending,)
-
-        result = []
-        for kind, id_or_name in zip(kind_list, id_or_name_list):
-            curr_key_part = {}
-            if isinstance(kind, six.string_types):
-                curr_key_part['kind'] = kind
-            else:
-                raise ValueError(kind, 'Kind was not a string.')
-
-            if isinstance(id_or_name, six.string_types):
-                curr_key_part['name'] = id_or_name
-            elif isinstance(id_or_name, six.integer_types):
-                curr_key_part['id'] = id_or_name
-            elif id_or_name is not partial_ending:
-                raise ValueError(id_or_name,
-                                 'ID/name was not a string or integer.')
-
-            result.append(curr_key_part)
-
-        return result
-
-    def _combine_args(self):
-        """Sets protected data by combining raw data set from the constructor.
-
-        If a ``_parent`` is set, updates the ``_flat_path`` and sets the
-        ``_namespace`` and ``_project`` if not already set.
-
-        :rtype: :class:`list` of :class:`dict`
-        :returns: A list of key parts with kind and ID or name set.
-        :raises: :class:`ValueError` if the parent key is not complete.
-        """
-        child_path = self._parse_path(self._flat_path)
-
-        if self._parent is not None:
-            if self._parent.is_partial:
-                raise ValueError('Parent key must be complete.')
-
-            # We know that _parent.path() will return a copy.
-            child_path = self._parent.path + child_path
-            self._flat_path = self._parent.flat_path + self._flat_path
-            if (self._namespace is not None and
-                    self._namespace != self._parent.namespace):
-                raise ValueError('Child namespace must agree with parent\'s.')
-            self._namespace = self._parent.namespace
-            if (self._project is not None and
-                    self._project != self._parent.project):
-                raise ValueError('Child project must agree with parent\'s.')
-            self._project = self._parent.project
-
-        return child_path
-
-    def _clone(self):
-        """Duplicates the Key.
-
-        Most attributes are simple types, so don't require copying. Other
-        attributes like ``parent`` are long-lived and so we re-use them.
-
-        :rtype: :class:`google.cloud.datastore.key.Key`
-        :returns: A new ``Key`` instance with the same data as the current one.
-        """
-        cloned_self = self.__class__(*self.flat_path,
-                                     project=self.project,
-                                     namespace=self.namespace)
-        # If the current parent has already been set, we re-use
-        # the same instance
-        cloned_self._parent = self._parent
-        return cloned_self
-
-    def completed_key(self, id_or_name):
-        """Creates new key from existing partial key by adding final ID/name.
-
-        :type id_or_name: string or integer
-        :param id_or_name: ID or name to be added to the key.
-
-        :rtype: :class:`google.cloud.datastore.key.Key`
-        :returns: A new ``Key`` instance with the same data as the current one
-                  and an extra ID or name added.
-        :raises: :class:`ValueError` if the current key is not partial or if
-                 ``id_or_name`` is not a string or integer.
-        """
-        if not self.is_partial:
-            raise ValueError('Only a partial key can be completed.')
-
-        if isinstance(id_or_name, six.string_types):
-            id_or_name_key = 'name'
-        elif isinstance(id_or_name, six.integer_types):
-            id_or_name_key = 'id'
-        else:
-            raise ValueError(id_or_name,
-                             'ID/name was not a string or integer.')
-
-        new_key = self._clone()
-        new_key._path[-1][id_or_name_key] = id_or_name
-        new_key._flat_path += (id_or_name,)
-        return new_key
-
-    def to_protobuf(self):
-        """Return a protobuf corresponding to the key.
-
-        :rtype: :class:`google.cloud.datastore._generated.entity_pb2.Key`
-        :returns: The protobuf representing the key.
-        """
-        key = _entity_pb2.Key()
-        key.partition_id.project_id = self.project
-
-        if self.namespace:
-            key.partition_id.namespace_id = self.namespace
-
-        for item in self.path:
-            element = key.path.add()
-            if 'kind' in item:
-                element.kind = item['kind']
-            if 'id' in item:
-                element.id = item['id']
-            if 'name' in item:
-                element.name = item['name']
-
-        return key
-
-    @property
-    def is_partial(self):
-        """Boolean indicating if the key has an ID (or name).
-
-        :rtype: bool
-        :returns: ``True`` if the last element of the key's path does not have
-                  an ``id`` or a ``name``.
-        """
-        return self.id_or_name is None
-
-    @property
-    def namespace(self):
-        """Namespace getter.
-
-        :rtype: string
-        :returns: The namespace of the current key.
-        """
-        return self._namespace
-
-    @property
-    def path(self):
-        """Path getter.
-
-        Returns a copy so that the key remains immutable.
-
-        :rtype: :class:`list` of :class:`dict`
-        :returns: The (key) path of the current key.
-        """
-        return copy.deepcopy(self._path)
-
-    @property
-    def flat_path(self):
-        """Getter for the key path as a tuple.
-
-        :rtype: tuple of string and integer
-        :returns: The tuple of elements in the path.
-        """
-        return self._flat_path
-
-    @property
-    def kind(self):
-        """Kind getter. Based on the last element of path.
-
-        :rtype: string
-        :returns: The kind of the current key.
-        """
-        return self.path[-1]['kind']
-
-    @property
-    def id(self):
-        """ID getter. Based on the last element of path.
-
-        :rtype: integer
-        :returns: The (integer) ID of the key.
-        """
-        return self.path[-1].get('id')
-
-    @property
-    def name(self):
-        """Name getter. Based on the last element of path.
-
-        :rtype: string
-        :returns: The (string) name of the key.
-        """
-        return self.path[-1].get('name')
-
-    @property
-    def id_or_name(self):
-        """Getter. Based on the last element of path.
-
-        :rtype: integer (if ``id``) or string (if ``name``)
-        :returns: The last element of the key's path if it is either an ``id``
-                  or a ``name``.
-        """
-        return self.id or self.name
-
-    @property
-    def project(self):
-        """Project getter.
-
-        :rtype: string
-        :returns: The key's project.
-        """
-        return self._project
-
-    def _make_parent(self):
-        """Creates a parent key for the current path.
-
-        Extracts all but the last element in the key path and creates a new
-        key, while still matching the namespace and the project.
-
-        :rtype: :class:`google.cloud.datastore.key.Key` or :class:`NoneType`
-        :returns: A new ``Key`` instance, whose path consists of all but the
-                  last element of current path. If the current key has only
-                  one path element, returns ``None``.
-        """
-        if self.is_partial:
-            parent_args = self.flat_path[:-1]
-        else:
-            parent_args = self.flat_path[:-2]
-        if parent_args:
-            return self.__class__(*parent_args, project=self.project,
-                                  namespace=self.namespace)
-
-    @property
-    def parent(self):
-        """The parent of the current key.
-
-        :rtype: :class:`google.cloud.datastore.key.Key` or :class:`NoneType`
-        :returns: A new ``Key`` instance, whose path consists of all but the
-                  last element of current path. If the current key has only
-                  one path element, returns ``None``.
-        """
-        if self._parent is None:
-            self._parent = self._make_parent()
-
-        return self._parent
-
-    def __repr__(self):
-        return '<Key%s, project=%s>' % (self.path, self.project)
-
-
-def _validate_project(project, parent):
-    """Ensure the project is set appropriately.
-
-    If ``parent`` is passed, skip the test (it will be checked / fixed up
-    later).
-
-    If ``project`` is unset, attempt to infer the project from the environment.
-
-    :type project: string
-    :param project: A project.
-
-    :type parent: :class:`google.cloud.datastore.key.Key` or ``NoneType``
-    :param parent: The parent of the key or ``None``.
-
-    :rtype: string
-    :returns: The ``project`` passed in, or implied from the environment.
-    :raises: :class:`ValueError` if ``project`` is ``None`` and no project
-             can be inferred from the parent.
-    """
-    if parent is None:
-        if project is None:
-            raise ValueError("A Key must have a project set.")
-
-    return project
diff --git a/google/cloud/datastore/query.py b/google/cloud/datastore/query.py
deleted file mode 100644
index e368be8256a3..000000000000
--- a/google/cloud/datastore/query.py
+++ /dev/null
@@ -1,539 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with Google Cloud Datastore queries."""
-
-import base64
-
-from google.cloud._helpers import _ensure_tuple_or_list
-from google.cloud.datastore._generated import query_pb2 as _query_pb2
-from google.cloud.datastore import helpers
-from google.cloud.datastore.key import Key
-
-
-class Query(object):
-    """A Query against the Cloud Datastore.
-
-    This class serves as an abstraction for creating a query over data
-    stored in the Cloud Datastore.
-
-    :type client: :class:`google.cloud.datastore.client.Client`
-    :param client: The client used to connect to Datastore.
-
-    :type kind: string
-    :param kind: The kind to query.
-
-    :type project: string
-    :param project: The project associated with the query.  If not passed,
-                    uses the client's value.
-
-    :type namespace: string or None
-    :param namespace: The namespace to which to restrict results.  If not
-                      passed, uses the client's value.
-
-    :type ancestor: :class:`google.cloud.datastore.key.Key` or None
-    :param ancestor: key of the ancestor to which this query's results are
-                     restricted.
-
-    :type filters: sequence of (property_name, operator, value) tuples
-    :param filters: property filters applied by this query.
-
-    :type projection: sequence of string
-    :param projection:  fields returned as part of query results.
-
-    :type order: sequence of string
-    :param order:  field names used to order query results. Prepend '-'
-                   to a field name to sort it in descending order.
-
-    :type distinct_on: sequence of string
-    :param distinct_on: field names used to group query results.
-
-    :raises: ValueError if ``project`` is not passed and no implicit
-             default is set.
-    """
-
-    OPERATORS = {
-        '<=': _query_pb2.PropertyFilter.LESS_THAN_OR_EQUAL,
-        '>=': _query_pb2.PropertyFilter.GREATER_THAN_OR_EQUAL,
-        '<': _query_pb2.PropertyFilter.LESS_THAN,
-        '>': _query_pb2.PropertyFilter.GREATER_THAN,
-        '=': _query_pb2.PropertyFilter.EQUAL,
-    }
-    """Mapping of operator strings and their protobuf equivalents."""
-
-    def __init__(self,
-                 client,
-                 kind=None,
-                 project=None,
-                 namespace=None,
-                 ancestor=None,
-                 filters=(),
-                 projection=(),
-                 order=(),
-                 distinct_on=()):
-
-        self._client = client
-        self._kind = kind
-        self._project = project or client.project
-        self._namespace = namespace or client.namespace
-        self._ancestor = ancestor
-        self._filters = []
-        # Verify filters passed in.
-        for property_name, operator, value in filters:
-            self.add_filter(property_name, operator, value)
-        self._projection = _ensure_tuple_or_list('projection', projection)
-        self._order = _ensure_tuple_or_list('order', order)
-        self._distinct_on = _ensure_tuple_or_list('distinct_on', distinct_on)
-
-    @property
-    def project(self):
-        """Get the project for this Query.
-
-        :rtype: str
-        :returns: The project for the query.
-        """
-        return self._project or self._client.project
-
-    @property
-    def namespace(self):
-        """This query's namespace
-
-        :rtype: string or None
-        :returns: the namespace assigned to this query
-        """
-        return self._namespace or self._client.namespace
-
-    @namespace.setter
-    def namespace(self, value):
-        """Update the query's namespace.
-
-        :type value: string
-        """
-        if not isinstance(value, str):
-            raise ValueError("Namespace must be a string")
-        self._namespace = value
-
-    @property
-    def kind(self):
-        """Get the Kind of the Query.
-
-        :rtype: string
-        :returns: The kind for the query.
-        """
-        return self._kind
-
-    @kind.setter
-    def kind(self, value):
-        """Update the Kind of the Query.
-
-        :type value: string
-        :param value: updated kind for the query.
-
-        .. note::
-
-           The protobuf specification allows for ``kind`` to be repeated,
-           but the current implementation returns an error if more than
-           one value is passed.  If the back-end changes in the future to
-           allow multiple values, this method will be updated to allow passing
-           either a string or a sequence of strings.
-        """
-        if not isinstance(value, str):
-            raise TypeError("Kind must be a string")
-        self._kind = value
-
-    @property
-    def ancestor(self):
-        """The ancestor key for the query.
-
-        :rtype: Key or None
-        :returns: The ancestor for the query.
-        """
-        return self._ancestor
-
-    @ancestor.setter
-    def ancestor(self, value):
-        """Set the ancestor for the query
-
-        :type value: Key
-        :param value: the new ancestor key
-        """
-        if not isinstance(value, Key):
-            raise TypeError("Ancestor must be a Key")
-        self._ancestor = value
-
-    @ancestor.deleter
-    def ancestor(self):
-        """Remove the ancestor for the query."""
-        self._ancestor = None
-
-    @property
-    def filters(self):
-        """Filters set on the query.
-
-        :rtype: sequence of (property_name, operator, value) tuples.
-        :returns: The filters set on the query.
-        """
-        return self._filters[:]
-
-    def add_filter(self, property_name, operator, value):
-        """Filter the query based on a property name, operator and a value.
-
-        Expressions take the form of::
-
-          .add_filter('<property>', '<operator>', <value>)
-
-        where property is a property stored on the entity in the datastore
-        and operator is one of ``OPERATORS``
-        (ie, ``=``, ``<``, ``<=``, ``>``, ``>=``)::
-
-          >>> from google.cloud import datastore
-          >>> client = datastore.Client()
-          >>> query = client.query(kind='Person')
-          >>> query.add_filter('name', '=', 'James')
-          >>> query.add_filter('age', '>', 50)
-
-        :type property_name: string
-        :param property_name: A property name.
-
-        :type operator: string
-        :param operator: One of ``=``, ``<``, ``<=``, ``>``, ``>=``.
-
-        :type value: :class:`int`, :class:`str`, :class:`bool`,
-                     :class:`float`, :class:`NoneType`,
-                     :class:`datetime.datetime`,
-                     :class:`google.cloud.datastore.key.Key`
-        :param value: The value to filter on.
-
-        :raises: :class:`ValueError` if ``operation`` is not one of the
-                 specified values, or if a filter names ``'__key__'`` but
-                 passes an invalid value (a key is required).
-        """
-        if self.OPERATORS.get(operator) is None:
-            error_message = 'Invalid expression: "%s"' % (operator,)
-            choices_message = 'Please use one of: =, <, <=, >, >=.'
-            raise ValueError(error_message, choices_message)
-
-        if property_name == '__key__' and not isinstance(value, Key):
-            raise ValueError('Invalid key: "%s"' % value)
-
-        self._filters.append((property_name, operator, value))
-
-    @property
-    def projection(self):
-        """Fields names returned by the query.
-
-        :rtype: sequence of string
-        :returns: Names of fields in query results.
-        """
-        return self._projection[:]
-
-    @projection.setter
-    def projection(self, projection):
-        """Set the fields returned the query.
-
-        :type projection: string or sequence of strings
-        :param projection: Each value is a string giving the name of a
-                           property to be included in the projection query.
-        """
-        if isinstance(projection, str):
-            projection = [projection]
-        self._projection[:] = projection
-
-    def keys_only(self):
-        """Set the projection to include only keys."""
-        self._projection[:] = ['__key__']
-
-    def key_filter(self, key, operator='='):
-        """Filter on a key.
-
-        :type key: :class:`google.cloud.datastore.key.Key`
-        :param key: The key to filter on.
-
-        :type operator: string
-        :param operator: (Optional) One of ``=``, ``<``, ``<=``, ``>``, ``>=``.
-                         Defaults to ``=``.
-        """
-        self.add_filter('__key__', operator, key)
-
-    @property
-    def order(self):
-        """Names of fields used to sort query results.
-
-        :rtype: sequence of string
-        :returns: The order(s) set on the query.
-        """
-        return self._order[:]
-
-    @order.setter
-    def order(self, value):
-        """Set the fields used to sort query results.
-
-        Sort fields will be applied in the order specified.
-
-        :type value: string or sequence of strings
-        :param value: Each value is a string giving the name of the
-                      property on which to sort, optionally preceded by a
-                      hyphen (-) to specify descending order.
-                      Omitting the hyphen implies ascending order.
-        """
-        if isinstance(value, str):
-            value = [value]
-        self._order[:] = value
-
-    @property
-    def distinct_on(self):
-        """Names of fields used to group query results.
-
-        :rtype: sequence of string
-        :returns: The "distinct on" fields set on the query.
-        """
-        return self._distinct_on[:]
-
-    @distinct_on.setter
-    def distinct_on(self, value):
-        """Set fields used to group query results.
-
-        :type value: string or sequence of strings
-        :param value: Each value is a string giving the name of a
-                      property to use to group results together.
-        """
-        if isinstance(value, str):
-            value = [value]
-        self._distinct_on[:] = value
-
-    def fetch(self, limit=None, offset=0, start_cursor=None, end_cursor=None,
-              client=None):
-        """Execute the Query; return an iterator for the matching entities.
-
-        For example::
-
-          >>> from google.cloud import datastore
-          >>> client = datastore.Client()
-          >>> query = client.query(kind='Person')
-          >>> query.add_filter('name', '=', 'Sally')
-          >>> list(query.fetch())
-          [<Entity object>, <Entity object>, ...]
-          >>> list(query.fetch(1))
-          [<Entity object>]
-
-        :type limit: integer or None
-        :param limit: An optional limit passed through to the iterator.
-
-        :type offset: integer
-        :param offset: An optional offset passed through to the iterator.
-
-        :type start_cursor: bytes
-        :param start_cursor: An optional cursor passed through to the iterator.
-
-        :type end_cursor: bytes
-        :param end_cursor: An optional cursor passed through to the iterator.
-
-        :type client: :class:`google.cloud.datastore.client.Client`
-        :param client: client used to connect to datastore.
-                       If not supplied, uses the query's value.
-
-        :rtype: :class:`Iterator`
-        :returns: The iterator for the query.
-        :raises: ValueError if ``connection`` is not passed and no implicit
-                 default has been set.
-        """
-        if client is None:
-            client = self._client
-
-        return Iterator(
-            self, client, limit, offset, start_cursor, end_cursor)
-
-
-class Iterator(object):
-    """Represent the state of a given execution of a Query.
-
-    :type query: :class:`google.cloud.datastore.query.Query`
-    :param query: Query object holding permanent configuration (i.e.
-                  things that don't change on with each page in
-                  a results set).
-
-    :type client: :class:`google.cloud.datastore.client.Client`
-    :param client: The client used to make a request.
-
-    :type limit: integer
-    :param limit: (Optional) Limit the number of results returned.
-
-    :type offset: integer
-    :param offset: (Optional) Offset used to begin a query.
-
-    :type start_cursor: bytes
-    :param start_cursor: (Optional) Cursor to begin paging through
-                         query results.
-
-    :type end_cursor: bytes
-    :param end_cursor: (Optional) Cursor to end paging through
-                       query results.
-    """
-
-    _NOT_FINISHED = _query_pb2.QueryResultBatch.NOT_FINISHED
-
-    _FINISHED = (
-        _query_pb2.QueryResultBatch.NO_MORE_RESULTS,
-        _query_pb2.QueryResultBatch.MORE_RESULTS_AFTER_LIMIT,
-        _query_pb2.QueryResultBatch.MORE_RESULTS_AFTER_CURSOR,
-    )
-
-    def __init__(self, query, client, limit=None, offset=None,
-                 start_cursor=None, end_cursor=None):
-        self._query = query
-        self._client = client
-        self._limit = limit
-        self._offset = offset
-        self._start_cursor = start_cursor
-        self._end_cursor = end_cursor
-        self._page = self._more_results = None
-        self._skipped_results = None
-
-    def next_page(self):
-        """Fetch a single "page" of query results.
-
-        Low-level API for fine control:  the more convenient API is
-        to iterate on the current Iterator.
-
-        :rtype: tuple, (entities, more_results, cursor)
-        :returns: The next page of results.
-        """
-        pb = _pb_from_query(self._query)
-
-        start_cursor = self._start_cursor
-        if start_cursor is not None:
-            pb.start_cursor = base64.urlsafe_b64decode(start_cursor)
-
-        end_cursor = self._end_cursor
-        if end_cursor is not None:
-            pb.end_cursor = base64.urlsafe_b64decode(end_cursor)
-
-        if self._limit is not None:
-            pb.limit.value = self._limit
-
-        if self._offset is not None:
-            pb.offset = self._offset
-
-        transaction = self._client.current_transaction
-
-        query_results = self._client.connection.run_query(
-            query_pb=pb,
-            project=self._query.project,
-            namespace=self._query.namespace,
-            transaction_id=transaction and transaction.id,
-            )
-        (entity_pbs, cursor_as_bytes,
-         more_results_enum, self._skipped_results) = query_results
-
-        if cursor_as_bytes == b'':
-            self._start_cursor = None
-        else:
-            self._start_cursor = base64.urlsafe_b64encode(cursor_as_bytes)
-        self._end_cursor = None
-
-        if more_results_enum == self._NOT_FINISHED:
-            self._more_results = True
-        elif more_results_enum in self._FINISHED:
-            self._more_results = False
-        else:
-            raise ValueError('Unexpected value returned for `more_results`.')
-
-        self._page = [
-            helpers.entity_from_protobuf(entity)
-            for entity in entity_pbs]
-        return self._page, self._more_results, self._start_cursor
-
-    def __iter__(self):
-        """Generator yielding all results matching our query.
-
-        :rtype: sequence of :class:`google.cloud.datastore.entity.Entity`
-        """
-        while True:
-            self.next_page()
-            for entity in self._page:
-                yield entity
-            if not self._more_results:
-                break
-            num_results = len(self._page)
-            if self._limit is not None:
-                self._limit -= num_results
-            if self._offset is not None and self._skipped_results is not None:
-                # NOTE: The offset goes down relative to the location
-                #       because we are updating the cursor each time.
-                self._offset -= self._skipped_results
-
-
-def _pb_from_query(query):
-    """Convert a Query instance to the corresponding protobuf.
-
-    :type query: :class:`Query`
-    :param query: The source query.
-
-    :rtype: :class:`google.cloud.datastore._generated.query_pb2.Query`
-    :returns: A protobuf that can be sent to the protobuf API.  N.b. that
-              it does not contain "in-flight" fields for ongoing query
-              executions (cursors, offset, limit).
-    """
-    pb = _query_pb2.Query()
-
-    for projection_name in query.projection:
-        pb.projection.add().property.name = projection_name
-
-    if query.kind:
-        pb.kind.add().name = query.kind
-
-    composite_filter = pb.filter.composite_filter
-    composite_filter.op = _query_pb2.CompositeFilter.AND
-
-    if query.ancestor:
-        ancestor_pb = query.ancestor.to_protobuf()
-
-        # Filter on __key__ HAS_ANCESTOR == ancestor.
-        ancestor_filter = composite_filter.filters.add().property_filter
-        ancestor_filter.property.name = '__key__'
-        ancestor_filter.op = _query_pb2.PropertyFilter.HAS_ANCESTOR
-        ancestor_filter.value.key_value.CopyFrom(ancestor_pb)
-
-    for property_name, operator, value in query.filters:
-        pb_op_enum = query.OPERATORS.get(operator)
-
-        # Add the specific filter
-        property_filter = composite_filter.filters.add().property_filter
-        property_filter.property.name = property_name
-        property_filter.op = pb_op_enum
-
-        # Set the value to filter on based on the type.
-        if property_name == '__key__':
-            key_pb = value.to_protobuf()
-            property_filter.value.key_value.CopyFrom(key_pb)
-        else:
-            helpers._set_protobuf_value(property_filter.value, value)
-
-    if not composite_filter.filters:
-        pb.ClearField('filter')
-
-    for prop in query.order:
-        property_order = pb.order.add()
-
-        if prop.startswith('-'):
-            property_order.property.name = prop[1:]
-            property_order.direction = property_order.DESCENDING
-        else:
-            property_order.property.name = prop
-            property_order.direction = property_order.ASCENDING
-
-    for distinct_on_name in query.distinct_on:
-        pb.distinct_on.add().name = distinct_on_name
-
-    return pb
diff --git a/google/cloud/datastore/transaction.py b/google/cloud/datastore/transaction.py
deleted file mode 100644
index 673a73898a1c..000000000000
--- a/google/cloud/datastore/transaction.py
+++ /dev/null
@@ -1,170 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with Google Cloud Datastore transactions."""
-
-from google.cloud.datastore.batch import Batch
-
-
-class Transaction(Batch):
-    """An abstraction representing datastore Transactions.
-
-    Transactions can be used to build up a bulk mutation and ensure all
-    or none succeed (transactionally).
-
-    For example, the following snippet of code will put the two ``save``
-    operations (either ``insert`` or ``upsert``) into the same
-    mutation, and execute those within a transaction::
-
-      >>> from google.cloud import datastore
-      >>> client = datastore.Client()
-      >>> with client.transaction():
-      ...     client.put_multi([entity1, entity2])
-
-    Because it derives from :class:`Batch <.datastore.batch.Batch>`,
-    :class:`Transaction` also provides :meth:`put` and :meth:`delete` methods::
-
-      >>> with client.transaction() as xact:
-      ...     xact.put(entity1)
-      ...     xact.delete(entity2.key)
-
-    By default, the transaction is rolled back if the transaction block
-    exits with an error::
-
-      >>> with client.transaction():
-      ...     do_some_work()
-      ...     raise SomeException()  # rolls back
-
-    If the transaction block exists without an exception, it will commit
-    by default.
-
-    .. warning:: Inside a transaction, automatically assigned IDs for
-       entities will not be available at save time!  That means, if you
-       try::
-
-         >>> with client.transaction():
-         ...     entity = datastore.Entity(key=client.key('Thing'))
-         ...     client.put(entity)
-
-       ``entity`` won't have a complete key until the transaction is
-       committed.
-
-       Once you exit the transaction (or call :meth:`commit`), the
-       automatically generated ID will be assigned to the entity::
-
-         >>> with client.transaction():
-         ...     entity = datastore.Entity(key=client.key('Thing'))
-         ...     client.put(entity)
-         ...     print(entity.key.is_partial)  # There is no ID on this key.
-         ...
-         True
-         >>> print(entity.key.is_partial)  # There *is* an ID.
-         False
-
-    If you don't want to use the context manager you can initialize a
-    transaction manually::
-
-      >>> transaction = client.transaction()
-      >>> transaction.begin()
-      >>>
-      >>> entity = datastore.Entity(key=client.key('Thing'))
-      >>> transaction.put(entity)
-      >>>
-      >>> if error:
-      ...     transaction.rollback()
-      ... else:
-      ...     transaction.commit()
-
-    :type client: :class:`google.cloud.datastore.client.Client`
-    :param client: the client used to connect to datastore.
-    """
-
-    _status = None
-
-    def __init__(self, client):
-        super(Transaction, self).__init__(client)
-        self._id = None
-
-    @property
-    def id(self):
-        """Getter for the transaction ID.
-
-        :rtype: string
-        :returns: The ID of the current transaction.
-        """
-        return self._id
-
-    def current(self):
-        """Return the topmost transaction.
-
-        .. note::
-
-            If the topmost element on the stack is not a transaction,
-            returns None.
-
-        :rtype: :class:`google.cloud.datastore.transaction.Transaction` or None
-        :returns: The current transaction (if any are active).
-        """
-        top = super(Transaction, self).current()
-        if isinstance(top, Transaction):
-            return top
-
-    def begin(self):
-        """Begins a transaction.
-
-        This method is called automatically when entering a with
-        statement, however it can be called explicitly if you don't want
-        to use a context manager.
-
-        :raises: :class:`~exceptions.ValueError` if the transaction has
-                 already begun.
-        """
-        super(Transaction, self).begin()
-        try:
-            self._id = self.connection.begin_transaction(self.project)
-        except:
-            self._status = self._ABORTED
-            raise
-
-    def rollback(self):
-        """Rolls back the current transaction.
-
-        This method has necessary side-effects:
-
-        - Sets the current connection's transaction reference to None.
-        - Sets the current transaction's ID to None.
-        """
-        try:
-            self.connection.rollback(self.project, self._id)
-        finally:
-            super(Transaction, self).rollback()
-            # Clear our own ID in case this gets accidentally reused.
-            self._id = None
-
-    def commit(self):
-        """Commits the transaction.
-
-        This is called automatically upon exiting a with statement,
-        however it can be called explicitly if you don't want to use a
-        context manager.
-
-        This method has necessary side-effects:
-
-        - Sets the current transaction's ID to None.
-        """
-        try:
-            super(Transaction, self).commit()
-        finally:
-            # Clear our own ID in case this gets accidentally reused.
-            self._id = None
diff --git a/google/cloud/dns/__init__.py b/google/cloud/dns/__init__.py
deleted file mode 100644
index 51a4732a2676..000000000000
--- a/google/cloud/dns/__init__.py
+++ /dev/null
@@ -1,35 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Google Cloud DNS API wrapper.
-
-The main concepts with this API are:
-
-- :class:`~google.cloud.DNS.zone.ManagedZone` represents an collection of
-  tables.
-- :class:`~google.cloud.DNS.resource_record_set.ResourceRecordSet` represents
-  a single resource definition within a zone.
-- :class:`~google.cloud.DNS.changes.Changes` represents a set of changes
-  (adding/deleting resource record sets) to a zone.
-"""
-
-
-from google.cloud.dns.zone import Changes
-from google.cloud.dns.client import Client
-from google.cloud.dns.connection import Connection
-from google.cloud.dns.zone import ManagedZone
-from google.cloud.dns.resource_record_set import ResourceRecordSet
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/dns/changes.py b/google/cloud/dns/changes.py
deleted file mode 100644
index eb68bdc80e46..000000000000
--- a/google/cloud/dns/changes.py
+++ /dev/null
@@ -1,259 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API ResourceRecordSets."""
-
-import six
-
-from google.cloud._helpers import _rfc3339_to_datetime
-from google.cloud.exceptions import NotFound
-from google.cloud.dns.resource_record_set import ResourceRecordSet
-
-
-class Changes(object):
-    """Changes are bundled additions / deletions of DNS resource records.
-
-    Changes are owned by a :class:`google.cloud.dns.zone.ManagedZone` instance.
-
-    See:
-    https://cloud.google.com/dns/api/v1/changes
-
-    :type zone: :class:`google.cloud.dns.zone.ManagedZone`
-    :param zone: A zone which holds one or more record sets.
-    """
-
-    def __init__(self, zone):
-        self.zone = zone
-        self._properties = {}
-        self._additions = self._deletions = ()
-
-    @classmethod
-    def from_api_repr(cls, resource, zone):
-        """Factory:  construct a change set given its API representation
-
-        :type resource: dict
-        :param resource: change set representation returned from the API.
-
-        :type zone: :class:`google.cloud.dns.zone.ManagedZone`
-        :param zone: A zone which holds zero or more change sets.
-
-        :rtype: :class:`google.cloud.dns.changes.Changes`
-        :returns: RRS parsed from ``resource``.
-        """
-        changes = cls(zone=zone)
-        changes._set_properties(resource)
-        return changes
-
-    def _set_properties(self, resource):
-        """Helper method for :meth:`from_api_repr`, :meth:`create`, etc.
-
-        :type resource: dict
-        :param resource: change set representation returned from the API.
-        """
-        resource = resource.copy()
-        self._additions = tuple([
-            ResourceRecordSet.from_api_repr(added_res, self.zone)
-            for added_res in resource.pop('additions', ())])
-        self._deletions = tuple([
-            ResourceRecordSet.from_api_repr(added_res, self.zone)
-            for added_res in resource.pop('deletions', ())])
-        self._properties = resource
-
-    @property
-    def path(self):
-        """URL path for change set APIs.
-
-        :rtype: string
-        :returns: the path based on project, zone, and change set names.
-        """
-        return '/projects/%s/managedZones/%s/changes/%s' % (
-            self.zone.project, self.zone.name, self.name)
-
-    @property
-    def name(self):
-        """Name of the change set.
-
-        :rtype: string or ``NoneType``
-        :returns: Name, as set by the back-end, or None.
-        """
-        return self._properties.get('id')
-
-    @name.setter
-    def name(self, value):
-        """Update name of the change set.
-
-        :type value: string
-        :param value: New name for the changeset.
-        """
-        if not isinstance(value, six.string_types):
-            raise ValueError("Pass a string")
-        self._properties['id'] = value
-
-    @property
-    def status(self):
-        """Status of the change set.
-
-        :rtype: string or ``NoneType``
-        :returns: Status, as set by the back-end, or None.
-        """
-        return self._properties.get('status')
-
-    @property
-    def started(self):
-        """Time when the change set was started.
-
-        :rtype: ``datetime.datetime`` or ``NoneType``
-        :returns: Time, as set by the back-end, or None.
-        """
-        stamp = self._properties.get('startTime')
-        if stamp is not None:
-            return _rfc3339_to_datetime(stamp)
-
-    @property
-    def additions(self):
-        """Resource record sets to be added to the zone.
-
-        :rtype: sequence of
-                :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`.
-        :returns: record sets appended via :meth:`add_record_set`.
-        """
-        return self._additions
-
-    @property
-    def deletions(self):
-        """Resource record sets to be deleted from the zone.
-
-        :rtype: sequence of
-                :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`.
-        :returns: record sets appended via :meth:`delete_record_set`.
-        """
-        return self._deletions
-
-    def add_record_set(self, record_set):
-        """Append a record set to the 'additions' for the change set.
-
-        :type record_set:
-            :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`
-        :param record_set: the record set to append.
-
-        :raises: ``ValueError`` if ``record_set`` is not of the required type.
-        """
-        if not isinstance(record_set, ResourceRecordSet):
-            raise ValueError("Pass a ResourceRecordSet")
-        self._additions += (record_set,)
-
-    def delete_record_set(self, record_set):
-        """Append a record set to the 'deletions' for the change set.
-
-        :type record_set:
-            :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`
-        :param record_set: the record set to append.
-
-        :raises: ``ValueError`` if ``record_set`` is not of the required type.
-        """
-        if not isinstance(record_set, ResourceRecordSet):
-            raise ValueError("Pass a ResourceRecordSet")
-        self._deletions += (record_set,)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-
-        :rtype: :class:`google.cloud.dns.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self.zone._client
-        return client
-
-    def _build_resource(self):
-        """Generate a resource for ``create``."""
-        additions = [{
-            'name': added.name,
-            'type': added.record_type,
-            'ttl': str(added.ttl),
-            'rrdatas': added.rrdatas,
-            } for added in self.additions]
-
-        deletions = [{
-            'name': deleted.name,
-            'type': deleted.record_type,
-            'ttl': str(deleted.ttl),
-            'rrdatas': deleted.rrdatas,
-            } for deleted in self.deletions]
-
-        return {
-            'additions': additions,
-            'deletions': deletions,
-        }
-
-    def create(self, client=None):
-        """API call:  create the change set via a POST request.
-
-        See:
-        https://cloud.google.com/dns/api/v1/changes/create
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-        """
-        if len(self.additions) == 0 and len(self.deletions) == 0:
-            raise ValueError("No record sets added or deleted")
-        client = self._require_client(client)
-        path = '/projects/%s/managedZones/%s/changes' % (
-            self.zone.project, self.zone.name)
-        api_response = client.connection.api_request(
-            method='POST', path=path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def exists(self, client=None):
-        """API call: test for the existence of the change set via a GET request.
-
-        See
-        https://cloud.google.com/dns/api/v1/changes/get
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the changes.
-        """
-        client = self._require_client(client)
-        try:
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params={'fields': 'id'})
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  refresh zone properties via a GET request.
-
-        See
-        https://cloud.google.com/dns/api/v1/changes/get
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-        """
-        client = self._require_client(client)
-
-        api_response = client.connection.api_request(
-            method='GET', path=self.path)
-        self._set_properties(api_response)
diff --git a/google/cloud/dns/client.py b/google/cloud/dns/client.py
deleted file mode 100644
index 05b67a279f4c..000000000000
--- a/google/cloud/dns/client.py
+++ /dev/null
@@ -1,117 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Client for interacting with the Google Cloud DNS API."""
-
-
-from google.cloud.client import JSONClient
-from google.cloud.dns.connection import Connection
-from google.cloud.dns.zone import ManagedZone
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: string
-    :param project: the project which the client acts on behalf of. Will be
-                    passed when creating a zone.  If not passed,
-                    falls back to the default inferred from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def quotas(self):
-        """Return DNS quotas for the project associated with this client.
-
-        See:
-        https://cloud.google.com/dns/api/v1/projects/get
-
-        :rtype: mapping
-        :returns: keys for the mapping correspond to those of the ``quota``
-                  sub-mapping of the project resource.
-        """
-        path = '/projects/%s' % (self.project,)
-        resp = self.connection.api_request(method='GET', path=path)
-
-        return {key: int(value)
-                for key, value in resp['quota'].items()
-                if key != 'kind'}
-
-    def list_zones(self, max_results=None, page_token=None):
-        """List zones for the project associated with this client.
-
-        See:
-        https://cloud.google.com/dns/api/v1/managedZones/list
-
-        :type max_results: int
-        :param max_results: maximum number of zones to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of zones. If
-                           not passed, the API will return the first page of
-                           zones.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.dns.zone.ManagedZone`, plus a
-                  "next page token" string:  if the token is not None,
-                  indicates that more zones can be retrieved with another
-                  call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/managedZones' % (self.project,)
-        resp = self.connection.api_request(method='GET', path=path,
-                                           query_params=params)
-        zones = [ManagedZone.from_api_repr(resource, self)
-                 for resource in resp['managedZones']]
-        return zones, resp.get('nextPageToken')
-
-    def zone(self, name, dns_name=None, description=None):
-        """Construct a zone bound to this client.
-
-        :type name: string
-        :param name: Name of the zone.
-
-        :type dns_name: string or :class:`NoneType`
-        :param dns_name: DNS name of the zone.  If not passed, then calls
-                         to :meth:`zone.create` will fail.
-
-        :type description: string or :class:`NoneType`
-        :param description: the description for the zone.  If not passed,
-                            defaults to the value of 'dns_name'.
-
-        :rtype: :class:`google.cloud.dns.zone.ManagedZone`
-        :returns: a new ``ManagedZone`` instance.
-        """
-        return ManagedZone(name, dns_name, client=self,
-                           description=description)
diff --git a/google/cloud/dns/connection.py b/google/cloud/dns/connection.py
deleted file mode 100644
index 22c4dcc94743..000000000000
--- a/google/cloud/dns/connection.py
+++ /dev/null
@@ -1,33 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Create / interact with Google Cloud DNS connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud DNS via the JSON REST API."""
-
-    API_BASE_URL = 'https://www.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/dns/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/ndev.clouddns.readwrite',)
-    """The scopes required for authenticating as a Cloud DNS consumer."""
diff --git a/google/cloud/dns/zone.py b/google/cloud/dns/zone.py
deleted file mode 100644
index 6613834847d9..000000000000
--- a/google/cloud/dns/zone.py
+++ /dev/null
@@ -1,398 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API ManagedZones."""
-import six
-
-from google.cloud._helpers import _rfc3339_to_datetime
-from google.cloud.exceptions import NotFound
-from google.cloud.dns.changes import Changes
-from google.cloud.dns.resource_record_set import ResourceRecordSet
-
-
-class ManagedZone(object):
-    """ManagedZones are containers for DNS resource records.
-
-    See:
-    https://cloud.google.com/dns/api/v1/managedZones
-
-    :type name: string
-    :param name: the name of the zone
-
-    :type dns_name: string or :class:`NoneType`
-    :param dns_name: the DNS name of the zone.  If not passed, then calls
-                     to :meth:`create` will fail.
-
-    :type client: :class:`google.cloud.dns.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the zone (which requires a project).
-
-    :type description: string or :class:`NoneType`
-    :param description: the description for the zone.  If not passed, defaults
-                        to the value of 'dns_name'.
-    """
-
-    def __init__(self, name, dns_name=None, client=None, description=None):
-        self.name = name
-        self.dns_name = dns_name
-        self._client = client
-        self._properties = {}
-        if description is None:
-            description = dns_name
-        self.description = description
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a zone given its API representation
-
-        :type resource: dict
-        :param resource: zone resource representation returned from the API
-
-        :type client: :class:`google.cloud.dns.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the zone.
-
-        :rtype: :class:`google.cloud.dns.zone.ManagedZone`
-        :returns: Zone parsed from ``resource``.
-        """
-        name = resource.get('name')
-        dns_name = resource.get('dnsName')
-        if name is None or dns_name is None:
-            raise KeyError('Resource lacks required identity information:'
-                           '["name"]["dnsName"]')
-        zone = cls(name, dns_name, client=client)
-        zone._set_properties(resource)
-        return zone
-
-    @property
-    def project(self):
-        """Project bound to the zone.
-
-        :rtype: string
-        :returns: the project (derived from the client).
-        """
-        return self._client.project
-
-    @property
-    def path(self):
-        """URL path for the zone's APIs.
-
-        :rtype: string
-        :returns: the path based on project and dataste name.
-        """
-        return '/projects/%s/managedZones/%s' % (self.project, self.name)
-
-    @property
-    def created(self):
-        """Datetime at which the zone was created.
-
-        :rtype: ``datetime.datetime``, or ``NoneType``
-        :returns: the creation time (None until set from the server).
-        """
-        return self._properties.get('creationTime')
-
-    @property
-    def name_servers(self):
-        """Datetime at which the zone was created.
-
-        :rtype: list of strings, or ``NoneType``.
-        :returns: the assigned name servers (None until set from the server).
-        """
-        return self._properties.get('nameServers')
-
-    @property
-    def zone_id(self):
-        """ID for the zone resource.
-
-        :rtype: string, or ``NoneType``
-        :returns: the ID (None until set from the server).
-        """
-        return self._properties.get('id')
-
-    @property
-    def description(self):
-        """Description of the zone.
-
-        :rtype: string, or ``NoneType``
-        :returns: The description as set by the user, or None (the default).
-        """
-        return self._properties.get('description')
-
-    @description.setter
-    def description(self, value):
-        """Update description of the zone.
-
-        :type value: string, or ``NoneType``
-        :param value: new description
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['description'] = value
-
-    @property
-    def name_server_set(self):
-        """Named set of DNS name servers that all host the same ManagedZones.
-
-        Most users will leave this blank.
-
-        See:
-        https://cloud.google.com/dns/api/v1/managedZones#nameServerSet
-
-        :rtype: string, or ``NoneType``
-        :returns: The name as set by the user, or None (the default).
-        """
-        return self._properties.get('nameServerSet')
-
-    @name_server_set.setter
-    def name_server_set(self, value):
-        """Update named set of DNS name servers.
-
-        :type value: string, or ``NoneType``
-        :param value: new title
-
-        :raises: ValueError for invalid value types.
-        """
-        if not isinstance(value, six.string_types) and value is not None:
-            raise ValueError("Pass a string, or None")
-        self._properties['nameServerSet'] = value
-
-    def resource_record_set(self, name, record_type, ttl, rrdatas):
-        """Construct a resource record set bound to this zone.
-
-        :type name: string
-        :param name: Name of the record set.
-
-        :type record_type: string
-        :param record_type: RR type
-
-        :type ttl: integer
-        :param ttl: TTL for the RR, in seconds
-
-        :type rrdatas: list of string
-        :param rrdatas: resource data for the RR
-
-        :rtype: :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`
-        :returns: a new ``ResourceRecordSet`` instance
-        """
-        return ResourceRecordSet(name, record_type, ttl, rrdatas, zone=self)
-
-    def changes(self):
-        """Construct a change set bound to this zone.
-
-        :rtype: :class:`google.cloud.dns.changes.Changes`
-        :returns: a new ``Changes`` instance
-        """
-        return Changes(zone=self)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-
-        :rtype: :class:`google.cloud.dns.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    def _set_properties(self, api_response):
-        """Update properties from resource in body of ``api_response``
-
-        :type api_response: httplib2.Response
-        :param api_response: response returned from an API call
-        """
-        self._properties.clear()
-        cleaned = api_response.copy()
-        self.dns_name = cleaned.pop('dnsName', None)
-        if 'creationTime' in cleaned:
-            cleaned['creationTime'] = _rfc3339_to_datetime(
-                cleaned['creationTime'])
-        self._properties.update(cleaned)
-
-    def _build_resource(self):
-        """Generate a resource for ``create`` or ``update``."""
-        resource = {
-            'name': self.name,
-        }
-
-        if self.dns_name is not None:
-            resource['dnsName'] = self.dns_name
-
-        if self.description is not None:
-            resource['description'] = self.description
-
-        if self.name_server_set is not None:
-            resource['nameServerSet'] = self.name_server_set
-
-        return resource
-
-    def create(self, client=None):
-        """API call:  create the zone via a PUT request
-
-        See:
-        https://cloud.google.com/dns/api/v1/managedZones/create
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-        """
-        client = self._require_client(client)
-        path = '/projects/%s/managedZones' % (self.project,)
-        api_response = client.connection.api_request(
-            method='POST', path=path, data=self._build_resource())
-        self._set_properties(api_response)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the zone via a GET request
-
-        See
-        https://cloud.google.com/dns/api/v1/managedZones/get
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the managed zone.
-        """
-        client = self._require_client(client)
-
-        try:
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params={'fields': 'id'})
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  refresh zone properties via a GET request
-
-        See
-        https://cloud.google.com/dns/api/v1/managedZones/get
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-        """
-        client = self._require_client(client)
-
-        api_response = client.connection.api_request(
-            method='GET', path=self.path)
-        self._set_properties(api_response)
-
-    def delete(self, client=None):
-        """API call:  delete the zone via a DELETE request
-
-        See:
-        https://cloud.google.com/dns/api/v1/managedZones/delete
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-        """
-        client = self._require_client(client)
-        client.connection.api_request(method='DELETE', path=self.path)
-
-    def list_resource_record_sets(self, max_results=None, page_token=None,
-                                  client=None):
-        """List resource record sets for this zone.
-
-        See:
-        https://cloud.google.com/dns/api/v1/resourceRecordSets/list
-
-        :type max_results: int
-        :param max_results: maximum number of zones to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of zones. If
-                           not passed, the API will return the first page of
-                           zones.
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-
-        :rtype: tuple, (list, str)
-        :returns: list of
-                  :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`,
-                  plus a "next page token" string:  if the token is not None,
-                  indicates that more zones can be retrieved with another
-                  call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/managedZones/%s/rrsets' % (
-            self.project, self.name)
-        client = self._require_client(client)
-        conn = client.connection
-        resp = conn.api_request(method='GET', path=path, query_params=params)
-        zones = [ResourceRecordSet.from_api_repr(resource, self)
-                 for resource in resp['rrsets']]
-        return zones, resp.get('nextPageToken')
-
-    def list_changes(self, max_results=None, page_token=None, client=None):
-        """List change sets for this zone.
-
-        See:
-        https://cloud.google.com/dns/api/v1/resourceRecordSets/list
-
-        :type max_results: int
-        :param max_results: maximum number of zones to return, If not
-                            passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of zones. If
-                           not passed, the API will return the first page of
-                           zones.
-
-        :type client: :class:`google.cloud.dns.client.Client` or ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current zone.
-
-        :rtype: tuple, (list, str)
-        :returns: list of
-                  :class:`google.cloud.dns.resource_record_set.ResourceRecordSet`,
-                  plus a "next page token" string:  if the token is not None,
-                  indicates that more zones can be retrieved with another
-                  call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if max_results is not None:
-            params['maxResults'] = max_results
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/managedZones/%s/changes' % (
-            self.project, self.name)
-        client = self._require_client(client)
-        conn = client.connection
-        resp = conn.api_request(method='GET', path=path, query_params=params)
-        zones = [Changes.from_api_repr(resource, self)
-                 for resource in resp['changes']]
-        return zones, resp.get('nextPageToken')
diff --git a/google/cloud/environment_vars.py b/google/cloud/environment_vars.py
deleted file mode 100644
index b6de3f934010..000000000000
--- a/google/cloud/environment_vars.py
+++ /dev/null
@@ -1,44 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Comprehensive list of environment variables used in google-cloud.
-
-These enable many types of implicit behavior in both production
-and tests.
-"""
-
-PROJECT = 'GOOGLE_CLOUD_PROJECT'
-"""Environment variable defining default project."""
-
-GCD_DATASET = 'DATASTORE_DATASET'
-"""Environment variable defining default dataset ID under GCD."""
-
-GCD_HOST = 'DATASTORE_EMULATOR_HOST'
-"""Environment variable defining host for GCD dataset server."""
-
-PUBSUB_EMULATOR = 'PUBSUB_EMULATOR_HOST'
-"""Environment variable defining host for Pub/Sub emulator."""
-
-BIGTABLE_EMULATOR = 'BIGTABLE_EMULATOR_HOST'
-"""Environment variable defining host for Bigtable emulator."""
-
-CREDENTIALS = 'GOOGLE_APPLICATION_CREDENTIALS'
-"""Environment variable defining location of Google credentials."""
-
-DISABLE_GRPC = 'GOOGLE_CLOUD_DISABLE_GRPC'
-"""Environment variable acting as flag to disable gRPC.
-
-To be used for APIs where both an HTTP and gRPC implementation
-exist.
-"""
diff --git a/google/cloud/error_reporting/__init__.py b/google/cloud/error_reporting/__init__.py
deleted file mode 100644
index cecda4ded718..000000000000
--- a/google/cloud/error_reporting/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client library for Stackdriver Error Reporting"""
-
-
-from google.cloud.error_reporting.client import Client
diff --git a/google/cloud/error_reporting/client.py b/google/cloud/error_reporting/client.py
deleted file mode 100644
index dc84c42016d7..000000000000
--- a/google/cloud/error_reporting/client.py
+++ /dev/null
@@ -1,251 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client for interacting with the Stackdriver Logging API"""
-
-import traceback
-
-import google.cloud.logging.client
-import six
-
-
-class HTTPContext(object):
-    """HTTPContext defines an object that captures the parameter for the
-    httpRequest part of Error Reporting API
-
-    :type method: string
-    :param method: The type of HTTP request, such as GET, POST, etc.
-
-    :type url: string
-    :param url: The URL of the request
-
-    :type user_agent: string
-    :param user_agent: The user agent information that is provided with the
-                       request.
-
-    :type referrer: string
-    :param referrer: The referrer information that is provided with the
-                     request.
-
-    :type response_status_code: int
-    :param response_status_code: The HTTP response status code for the request.
-
-    :type remote_ip: string
-    :param remote_ip: The IP address from which the request originated. This
-                      can be IPv4, IPv6, or a token which is derived from
-                      the IP address, depending on the data that has been
-                      provided in the error report.
-    """
-
-    def __init__(self, method=None, url=None,
-                 user_agent=None, referrer=None,
-                 response_status_code=None, remote_ip=None):
-        self.method = method
-        self.url = url
-        # intentionally camel case for mapping to JSON API expects
-        # pylint: disable=invalid-name
-        self.userAgent = user_agent
-        self.referrer = referrer
-        self.responseStatusCode = response_status_code
-        self.remoteIp = remote_ip
-
-
-class Client(object):
-    """Error Reporting client. Currently Error Reporting is done by creating
-    a Logging client.
-
-    :type project: string
-    :param project: the project which the client acts on behalf of. If not
-                    passed falls back to the default inferred from the
-                    environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-
-    :type service: str
-    :param service: An identifier of the service, such as the name of the
-                    executable, job, or Google App Engine service name. This
-                    field is expected to have a low number of values that are
-                    relatively stable over time, as opposed to version,
-                    which can be changed whenever new code is deployed.
-
-
-    :type version: str
-    :param version: Represents the source code version that the developer
-                    provided, which could represent a version label or a Git
-                    SHA-1 hash, for example. If the developer did not provide
-                    a version, the value is set to default.
-
-    :raises: :class:`ValueError` if the project is neither passed in nor
-             set in the environment.
-    """
-
-    def __init__(self, project=None,
-                 credentials=None,
-                 http=None,
-                 service=None,
-                 version=None):
-        self.logging_client = google.cloud.logging.client.Client(
-            project, credentials, http)
-        self.service = service if service else self.DEFAULT_SERVICE
-        self.version = version
-
-    DEFAULT_SERVICE = 'python'
-
-    def _send_error_report(self, message,
-                           report_location=None, http_context=None, user=None):
-        """Makes the call to the Error Reporting API via the log stream.
-
-        This is the lower-level interface to build the payload, generally
-        users will use either report() or report_exception() to automatically
-        gather the parameters for this method.
-
-        Currently this method sends the Error Report by formatting a structured
-        log message according to
-
-        https://cloud.google.com/error-reporting/docs/formatting-error-messages
-
-        :type message: string
-        :param message: The stack trace that was reported or logged by the
-                   service.
-
-        :type report_location: dict
-        :param report_location:  The location in the source code where the
-               decision was made to 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 should be a Python dict that contains the keys 'filePath',
-               'lineNumber', and 'functionName'
-
-        :type http_context: :class`google.cloud.error_reporting.HTTPContext`
-        :param http_context: The HTTP request which was processed when the
-                             error was triggered.
-
-        :type user: string
-        :param user: The user who caused or was affected by the crash. This can
-                     be a user ID, an email address, or an arbitrary token that
-                     uniquely identifies the user. When sending an error
-                     report, leave this field empty if the user was not
-                     logged in. In this  case the Error Reporting system will
-                     use other data, such as remote IP address,
-                     to distinguish affected users.
-        """
-        payload = {
-            'serviceContext': {
-                'service': self.service,
-            },
-            'message': '{0}'.format(message)
-        }
-
-        if self.version:
-            payload['serviceContext']['version'] = self.version
-
-        if report_location or http_context or user:
-            payload['context'] = {}
-
-        if report_location:
-            payload['context']['reportLocation'] = report_location
-
-        if http_context:
-            http_context_dict = http_context.__dict__
-            # strip out None values
-            payload['context']['httpContext'] = {
-                key: value for key, value in six.iteritems(http_context_dict)
-                if value is not None
-            }
-
-        if user:
-            payload['context']['user'] = user
-
-        logger = self.logging_client.logger('errors')
-        logger.log_struct(payload)
-
-    def report(self, message, http_context=None, user=None):
-        """ Reports a message to Stackdriver Error Reporting
-        https://cloud.google.com/error-reporting/docs/formatting-error-messages
-
-           :type message: str
-           :param message: A user-supplied message to report
-
-
-          :type http_context: :class`google.cloud.error_reporting.HTTPContext`
-          :param http_context: The HTTP request which was processed when the
-                               error was triggered.
-
-          :type user: string
-          :param user: The user who caused or was affected by the crash. This
-                       can be a user ID, an email address, or an arbitrary
-                       token that uniquely identifies the user. When sending
-                       an error report, leave this field empty if the user
-                       was not logged in. In this case the Error Reporting
-                       system will use other data, such as remote IP address,
-                       to distinguish affected users.
-
-           Example::
-                >>>  client.report("Something went wrong!")
-        """
-        stack = traceback.extract_stack()
-        last_call = stack[-2]
-        file_path = last_call[0]
-        line_number = last_call[1]
-        function_name = last_call[2]
-        report_location = {
-            'filePath': file_path,
-            'lineNumber': line_number,
-            'functionName': function_name
-        }
-
-        self._send_error_report(message,
-                                http_context=http_context,
-                                user=user,
-                                report_location=report_location)
-
-    def report_exception(self, http_context=None, user=None):
-        """ Reports the details of the latest exceptions to Stackdriver Error
-            Reporting.
-
-          :type http_context: :class`google.cloud.error_reporting.HTTPContext`
-          :param http_context: The HTTP request which was processed when the
-                               error was triggered.
-
-          :type user: string
-          :param user: The user who caused or was affected by the crash. This
-                       can be a user ID, an email address, or an arbitrary
-                       token that uniquely identifies the user. When sending an
-                       error report, leave this field empty if the user was
-                       not logged in. In this case the Error Reporting system
-                       will use other data, such as remote IP address,
-                       to distinguish affected users.
-
-           Example::
-
-                >>>     try:
-                >>>         raise NameError
-                >>>     except Exception:
-                >>>         client.report_exception()
-        """
-        self._send_error_report(traceback.format_exc(),
-                                http_context=http_context,
-                                user=user)
diff --git a/google/cloud/exceptions.py b/google/cloud/exceptions.py
deleted file mode 100644
index 17b1e0e69860..000000000000
--- a/google/cloud/exceptions.py
+++ /dev/null
@@ -1,239 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Custom exceptions for :mod:`google.cloud` package.
-
-See: https://cloud.google.com/storage/docs/json_api/v1/status-codes
-"""
-
-import copy
-import json
-import six
-
-_HTTP_CODE_TO_EXCEPTION = {}  # populated at end of module
-
-try:
-    from grpc._channel import _Rendezvous
-except ImportError:  # pragma: NO COVER
-    _Rendezvous = None
-
-
-# pylint: disable=invalid-name
-GrpcRendezvous = _Rendezvous
-"""Exception class raised by gRPC stable."""
-# pylint: enable=invalid-name
-
-
-class GoogleCloudError(Exception):
-    """Base error class for Google Cloud errors (abstract).
-
-    Each subclass represents a single type of HTTP error response.
-    """
-    code = None
-    """HTTP status code.  Concrete subclasses *must* define.
-
-    See: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
-    """
-
-    def __init__(self, message, errors=()):
-        super(GoogleCloudError, self).__init__(message)
-        self.message = message
-        self._errors = errors
-
-    def __str__(self):
-        return '%d %s' % (self.code, self.message)
-
-    @property
-    def errors(self):
-        """Detailed error information.
-
-        :rtype: list(dict)
-        :returns: a list of mappings describing each error.
-        """
-        return [copy.deepcopy(error) for error in self._errors]
-
-
-class Redirection(GoogleCloudError):
-    """Base for 3xx responses
-
-    This class is abstract.
-    """
-
-
-class MovedPermanently(Redirection):
-    """Exception mapping a '301 Moved Permanently' response."""
-    code = 301
-
-
-class NotModified(Redirection):
-    """Exception mapping a '304 Not Modified' response."""
-    code = 304
-
-
-class TemporaryRedirect(Redirection):
-    """Exception mapping a '307 Temporary Redirect' response."""
-    code = 307
-
-
-class ResumeIncomplete(Redirection):
-    """Exception mapping a '308 Resume Incomplete' response."""
-    code = 308
-
-
-class ClientError(GoogleCloudError):
-    """Base for 4xx responses
-
-    This class is abstract
-    """
-
-
-class BadRequest(ClientError):
-    """Exception mapping a '400 Bad Request' response."""
-    code = 400
-
-
-class Unauthorized(ClientError):
-    """Exception mapping a '401 Unauthorized' response."""
-    code = 401
-
-
-class Forbidden(ClientError):
-    """Exception mapping a '403 Forbidden' response."""
-    code = 403
-
-
-class NotFound(ClientError):
-    """Exception mapping a '404 Not Found' response."""
-    code = 404
-
-
-class MethodNotAllowed(ClientError):
-    """Exception mapping a '405 Method Not Allowed' response."""
-    code = 405
-
-
-class Conflict(ClientError):
-    """Exception mapping a '409 Conflict' response."""
-    code = 409
-
-
-class LengthRequired(ClientError):
-    """Exception mapping a '411 Length Required' response."""
-    code = 411
-
-
-class PreconditionFailed(ClientError):
-    """Exception mapping a '412 Precondition Failed' response."""
-    code = 412
-
-
-class RequestRangeNotSatisfiable(ClientError):
-    """Exception mapping a '416 Request Range Not Satisfiable' response."""
-    code = 416
-
-
-class TooManyRequests(ClientError):
-    """Exception mapping a '429 Too Many Requests' response."""
-    code = 429
-
-
-class ServerError(GoogleCloudError):
-    """Base for 5xx responses:  (abstract)"""
-
-
-class InternalServerError(ServerError):
-    """Exception mapping a '500 Internal Server Error' response."""
-    code = 500
-
-
-class MethodNotImplemented(ServerError):
-    """Exception mapping a '501 Not Implemented' response."""
-    code = 501
-
-
-class BadGateway(ServerError):
-    """Exception mapping a '502 Bad Gateway' response."""
-    code = 502
-
-
-class ServiceUnavailable(ServerError):
-    """Exception mapping a '503 Service Unavailable' response."""
-    code = 503
-
-
-def make_exception(response, content, error_info=None, use_json=True):
-    """Factory:  create exception based on HTTP response code.
-
-    :type response: :class:`httplib2.Response` or other HTTP response object
-    :param response: A response object that defines a status code as the
-                     status attribute.
-
-    :type content: string or dictionary
-    :param content: The body of the HTTP error response.
-
-    :type error_info: string
-    :param error_info: Optional string giving extra information about the
-                       failed request.
-
-    :type use_json: bool
-    :param use_json: Flag indicating if ``content`` is expected to be JSON.
-
-    :rtype: instance of :class:`GoogleCloudError`, or a concrete subclass.
-    :returns: Exception specific to the error response.
-    """
-    if isinstance(content, six.binary_type):
-        content = content.decode('utf-8')
-
-    if isinstance(content, six.string_types):
-        payload = None
-        if use_json:
-            try:
-                payload = json.loads(content)
-            except ValueError:
-                # Expected JSON but received something else.
-                pass
-        if payload is None:
-            payload = {'error': {'message': content}}
-    else:
-        payload = content
-
-    message = payload.get('error', {}).get('message', '')
-    errors = payload.get('error', {}).get('errors', ())
-
-    if error_info is not None:
-        message += ' (%s)' % (error_info,)
-
-    try:
-        klass = _HTTP_CODE_TO_EXCEPTION[response.status]
-    except KeyError:
-        error = GoogleCloudError(message, errors)
-        error.code = response.status
-    else:
-        error = klass(message, errors)
-    return error
-
-
-def _walk_subclasses(klass):
-    """Recursively walk subclass tree."""
-    for sub in klass.__subclasses__():
-        yield sub
-        for subsub in _walk_subclasses(sub):
-            yield subsub
-
-
-# Build the code->exception class mapping.
-for _eklass in _walk_subclasses(GoogleCloudError):
-    code = getattr(_eklass, 'code', None)
-    if code is not None:
-        _HTTP_CODE_TO_EXCEPTION[code] = _eklass
diff --git a/google/cloud/iterator.py b/google/cloud/iterator.py
deleted file mode 100644
index 0ad5da167249..000000000000
--- a/google/cloud/iterator.py
+++ /dev/null
@@ -1,184 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Iterators for paging through API responses.
-
-These iterators simplify the process of paging through API responses
-where the response is a list of results with a ``nextPageToken``.
-
-To make an iterator work, just override the ``get_items_from_response``
-method so that given a response (containing a page of results) it parses
-those results into an iterable of the actual objects you want::
-
-  class MyIterator(Iterator):
-      def get_items_from_response(self, response):
-          items = response.get('items', [])
-          for item in items:
-              my_item = MyItemClass(other_arg=True)
-              my_item._set_properties(item)
-              yield my_item
-
-You then can use this to get **all** the results from a resource::
-
-    >>> iterator = MyIterator(...)
-    >>> list(iterator)  # Convert to a list (consumes all values).
-
-Or you can walk your way through items and call off the search early if
-you find what you're looking for (resulting in possibly fewer
-requests)::
-
-    >>> for item in MyIterator(...):
-    >>>     print item.name
-    >>>     if not item.is_valid:
-    >>>         break
-"""
-
-
-class Iterator(object):
-    """A generic class for iterating through Cloud JSON APIs list responses.
-
-    :type client: :class:`google.cloud.client.Client`
-    :param client: The client, which owns a connection to make requests.
-
-    :type path: string
-    :param path: The path to query for the list of items.
-
-    :type extra_params: dict or None
-    :param extra_params: Extra query string parameters for the API call.
-    """
-
-    PAGE_TOKEN = 'pageToken'
-    RESERVED_PARAMS = frozenset([PAGE_TOKEN])
-
-    def __init__(self, client, path, extra_params=None):
-        self.client = client
-        self.path = path
-        self.page_number = 0
-        self.next_page_token = None
-        self.extra_params = extra_params or {}
-        reserved_in_use = self.RESERVED_PARAMS.intersection(
-            self.extra_params)
-        if reserved_in_use:
-            raise ValueError(('Using a reserved parameter',
-                              reserved_in_use))
-
-    def __iter__(self):
-        """Iterate through the list of items."""
-        while self.has_next_page():
-            response = self.get_next_page_response()
-            for item in self.get_items_from_response(response):
-                yield item
-
-    def has_next_page(self):
-        """Determines whether or not this iterator has more pages.
-
-        :rtype: boolean
-        :returns: Whether the iterator has more pages or not.
-        """
-        if self.page_number == 0:
-            return True
-
-        return self.next_page_token is not None
-
-    def get_query_params(self):
-        """Getter for query parameters for the next request.
-
-        :rtype: dict
-        :returns: A dictionary of query parameters.
-        """
-        result = ({self.PAGE_TOKEN: self.next_page_token}
-                  if self.next_page_token else {})
-        result.update(self.extra_params)
-        return result
-
-    def get_next_page_response(self):
-        """Requests the next page from the path provided.
-
-        :rtype: dict
-        :returns: The parsed JSON response of the next page's contents.
-        """
-        if not self.has_next_page():
-            raise RuntimeError('No more pages. Try resetting the iterator.')
-
-        response = self.client.connection.api_request(
-            method='GET', path=self.path, query_params=self.get_query_params())
-
-        self.page_number += 1
-        self.next_page_token = response.get('nextPageToken')
-
-        return response
-
-    def reset(self):
-        """Resets the iterator to the beginning."""
-        self.page_number = 0
-        self.next_page_token = None
-
-    def get_items_from_response(self, response):
-        """Factory method called while iterating. This should be overridden.
-
-        This method should be overridden by a subclass.  It should
-        accept the API response of a request for the next page of items,
-        and return a list (or other iterable) of items.
-
-        Typically this method will construct a Bucket or a Blob from the
-        page of results in the response.
-
-        :type response: dict
-        :param response: The response of asking for the next page of items.
-        """
-        raise NotImplementedError
-
-
-class MethodIterator(object):
-    """Method-based iterator iterating through Cloud JSON APIs list responses.
-
-    :type method: instance method
-    :param method: ``list_foo`` method of a domain object, taking as arguments
-                   ``page_token``, ``page_size``, and optional additional
-                   keyword arguments.
-
-    :type page_token: string or ``NoneType``
-    :param page_token: Initial page token to pass.  if ``None``, fetch the
-                       first page from the ``method`` API call.
-
-    :type page_size: integer or ``NoneType``
-    :param page_size: Maximum number of items to return from the ``method``
-                      API call; if ``None``, uses the default for the API.
-
-    :type max_calls: integer or ``NoneType``
-    :param max_calls: Maximum number of times to make the ``method``
-                      API call; if ``None``, applies no limit.
-
-    :type kw: dict
-    :param kw: optional keyword arguments to be passed to ``method``.
-    """
-    def __init__(self, method, page_token=None, page_size=None,
-                 max_calls=None, **kw):
-        self._method = method
-        self._token = page_token
-        self._page_size = page_size
-        self._kw = kw
-        self._max_calls = max_calls
-        self._page_num = 0
-
-    def __iter__(self):
-        while self._max_calls is None or self._page_num < self._max_calls:
-            items, new_token = self._method(
-                page_token=self._token, page_size=self._page_size, **self._kw)
-            for item in items:
-                yield item
-            if new_token is None:
-                return
-            self._page_num += 1
-            self._token = new_token
diff --git a/google/cloud/language/__init__.py b/google/cloud/language/__init__.py
deleted file mode 100644
index 86b3e451ee34..000000000000
--- a/google/cloud/language/__init__.py
+++ /dev/null
@@ -1,20 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client library for Google Cloud Natural Language API."""
-
-
-from google.cloud.language.client import Client
-from google.cloud.language.document import Document
-from google.cloud.language.document import Encoding
diff --git a/google/cloud/language/client.py b/google/cloud/language/client.py
deleted file mode 100644
index 8a278b5e5cde..000000000000
--- a/google/cloud/language/client.py
+++ /dev/null
@@ -1,101 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Basic client for Google Cloud Natural Language API."""
-
-
-from google.cloud import client as client_module
-from google.cloud.language.connection import Connection
-from google.cloud.language.document import Document
-
-
-class Client(client_module.Client):
-    """Client to bundle configuration needed for API requests.
-
-    :type credentials: :class:`~oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for the
-                        connection owned by this client. If not passed (and
-                        if no ``http`` object is passed), falls back to the
-                        default inferred from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def document_from_text(self, content, **kwargs):
-        """Create a plain text document bound to this client.
-
-        :type content: str
-        :param content: The document plain text content.
-
-        :type kwargs: dict
-        :param kwargs: Remaining keyword arguments to be passed along to the
-                       :class:`.Document` constructor.
-
-        :rtype: :class:`.Document`
-        :returns: A plain-text document bound to this client.
-        :raises: :class:`~exceptions.TypeError` if ``doc_type`` is passed as a
-                 keyword argument.
-        """
-        if 'doc_type' in kwargs:
-            raise TypeError('Cannot pass doc_type')
-        return Document(self, content=content,
-                        doc_type=Document.PLAIN_TEXT, **kwargs)
-
-    def document_from_html(self, content, **kwargs):
-        """Create an HTML document bound to this client.
-
-        :type content: str
-        :param content: The document HTML text content.
-
-        :type kwargs: dict
-        :param kwargs: Remaining keyword arguments to be passed along to the
-                       :class:`.Document` constructor.
-
-        :rtype: :class:`.Document`
-        :returns: An HTML document bound to this client.
-        :raises: :class:`~exceptions.TypeError` if ``doc_type`` is passed as a
-                 keyword argument.
-        """
-        if 'doc_type' in kwargs:
-            raise TypeError('Cannot pass doc_type')
-        return Document(self, content=content,
-                        doc_type=Document.HTML, **kwargs)
-
-    def document_from_url(self, gcs_url,
-                          doc_type=Document.PLAIN_TEXT, **kwargs):
-        """Create a Cloud Storage document bound to this client.
-
-        :type gcs_url: str
-        :param gcs_url: The URL of the Google Cloud Storage object
-                        holding the content. Of the form
-                        ``gs://{bucket}/{blob-name}``.
-
-        :type doc_type: str
-        :param doc_type: (Optional) The type of text in the document.
-                         Defaults to plain text. Can also be specified
-                         as HTML via :attr:`~.Document.HTML`.
-
-        :type kwargs: dict
-        :param kwargs: Remaining keyword arguments to be passed along to the
-                       :class:`.Document` constructor.
-
-        :rtype: :class:`.Document`
-        :returns: A document bound to this client.
-        """
-        return Document(self, gcs_url=gcs_url, doc_type=doc_type, **kwargs)
diff --git a/google/cloud/language/connection.py b/google/cloud/language/connection.py
deleted file mode 100644
index 45acf476a57c..000000000000
--- a/google/cloud/language/connection.py
+++ /dev/null
@@ -1,33 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Basic connection for Google Cloud Natural Language API."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Natural Language JSON REST API."""
-
-    API_BASE_URL = 'https://language.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1beta1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}/documents:{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/cloud-platform',)
-    """The scopes required for authenticating as an API consumer."""
diff --git a/google/cloud/language/document.py b/google/cloud/language/document.py
deleted file mode 100644
index 975ea114087e..000000000000
--- a/google/cloud/language/document.py
+++ /dev/null
@@ -1,261 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Definition for Google Cloud Natural Language API documents.
-
-A document is used to hold text to be analyzed and annotated.
-"""
-
-import collections
-
-from google.cloud.language.entity import Entity
-from google.cloud.language.sentiment import Sentiment
-from google.cloud.language.syntax import Sentence
-from google.cloud.language.syntax import Token
-
-
-DEFAULT_LANGUAGE = 'en-US'
-"""Default document language, English."""
-
-
-Annotations = collections.namedtuple(
-    'Annotations',
-    'sentences tokens sentiment entities')
-"""Annotations for a document.
-
-:type sentences: list
-:param sentences: List of :class:`.Sentence` in a document.
-
-:type tokens: list
-:param tokens: List of :class:`.Token` from a document.
-
-:type sentiment: :class:`Sentiment`
-:param sentiment: The sentiment of a document.
-
-:type entities: list
-:param entities: List of :class:`~.language.entity.Entity`
-                 found in a document.
-"""
-
-
-class Encoding(object):
-    """Document text encoding types."""
-
-    NONE = 'NONE'
-    """Unspecified encoding type."""
-
-    UTF8 = 'UTF8'
-    """UTF-8 encoding type."""
-
-    UTF16 = 'UTF16'
-    """UTF-16 encoding type."""
-
-    UTF32 = 'UTF32'
-    """UTF-32 encoding type."""
-
-
-class Document(object):
-    """Document to send to Google Cloud Natural Language API.
-
-    Represents either plain text or HTML, and the content is either
-    stored on the document or referred to in a Google Cloud Storage
-    object.
-
-    :type client: :class:`~google.cloud.language.client.Client`
-    :param client: A client which holds credentials and other
-                   configuration.
-
-    :type content: str
-    :param content: (Optional) The document text content (either plain
-                    text or HTML).
-
-    :type gcs_url: str
-    :param gcs_url: (Optional) The URL of the Google Cloud Storage object
-                    holding the content. Of the form
-                    ``gs://{bucket}/{blob-name}``.
-
-    :type doc_type: str
-    :param doc_type: (Optional) The type of text in the document.
-                     Defaults to plain text. Can be one of
-                     :attr:`~.Document.PLAIN_TEXT` or
-                     or :attr:`~.Document.HTML`.
-
-    :type language: str
-    :param language: (Optional) The language of the document text.
-                     Defaults to :data:`DEFAULT_LANGUAGE`.
-
-    :type encoding: str
-    :param encoding: (Optional) The encoding of the document text.
-                     Defaults to UTF-8. Can be one of
-                     :attr:`~.Encoding.UTF8`, :attr:`~.Encoding.UTF16`
-                     or :attr:`~.Encoding.UTF32`.
-
-    :raises: :class:`~exceptions.ValueError` both ``content`` and ``gcs_url``
-             are specified or if neither are specified.
-    """
-
-    TYPE_UNSPECIFIED = 'TYPE_UNSPECIFIED'
-    """Unspecified document type."""
-
-    PLAIN_TEXT = 'PLAIN_TEXT'
-    """Plain text document type."""
-
-    HTML = 'HTML'
-    """HTML document type."""
-
-    def __init__(self, client, content=None, gcs_url=None, doc_type=PLAIN_TEXT,
-                 language=DEFAULT_LANGUAGE, encoding=Encoding.UTF8):
-        if content is not None and gcs_url is not None:
-            raise ValueError('A Document cannot contain both local text and '
-                             'a link to text in a Google Cloud Storage object')
-        if content is None and gcs_url is None:
-            raise ValueError('A Document must contain either local text or a '
-                             'link to text in a Google Cloud Storage object')
-        self.client = client
-        self.content = content
-        self.gcs_url = gcs_url
-        self.doc_type = doc_type
-        self.language = language
-        self.encoding = encoding
-
-    def _to_dict(self):
-        """Helper to convert the current document into a dictionary.
-
-        To be used when constructing requests.
-
-        :rtype: dict
-        :returns: The Document value as a JSON dictionary.
-        """
-        info = {
-            'type': self.doc_type,
-            'language': self.language,
-        }
-        if self.content is not None:
-            info['content'] = self.content
-        elif self.gcs_url is not None:
-            info['gcsContentUri'] = self.gcs_url
-        return info
-
-    def analyze_entities(self):
-        """Analyze the entities in the current document.
-
-        Finds named entities (currently finds proper names as of August 2016)
-        in the text, entity types, salience, mentions for each entity, and
-        other properties.
-
-        .. _analyzeEntities: https://cloud.google.com/natural-language/\
-                             reference/rest/v1beta1/documents/analyzeEntities
-
-        See `analyzeEntities`_.
-
-        :rtype: list
-        :returns: A list of :class:`~.language.entity.Entity` returned from
-                  the API.
-        """
-        data = {
-            'document': self._to_dict(),
-            'encodingType': self.encoding,
-        }
-        api_response = self.client.connection.api_request(
-            method='POST', path='analyzeEntities', data=data)
-        return [Entity.from_api_repr(entity)
-                for entity in api_response['entities']]
-
-    def analyze_sentiment(self):
-        """Analyze the sentiment in the current document.
-
-        .. _analyzeSentiment: https://cloud.google.com/natural-language/\
-                              reference/rest/v1beta1/documents/analyzeSentiment
-
-        See `analyzeSentiment`_.
-
-        :rtype: :class:`.Sentiment`
-        :returns: The sentiment of the current document.
-        """
-        data = {'document': self._to_dict()}
-        api_response = self.client.connection.api_request(
-            method='POST', path='analyzeSentiment', data=data)
-        return Sentiment.from_api_repr(api_response['documentSentiment'])
-
-    def annotate_text(self, include_syntax=True, include_entities=True,
-                      include_sentiment=True):
-        """Advanced natural language API: document syntax and other features.
-
-        Includes the full functionality of :meth:`analyze_entities` and
-        :meth:`analyze_sentiment`, enabled by the flags
-        ``include_entities`` and ``include_sentiment`` respectively.
-
-        In addition ``include_syntax`` adds a new feature that analyzes
-        the document for semantic and syntacticinformation.
-
-        .. note::
-
-            This API is intended for users who are familiar with machine
-            learning and need in-depth text features to build upon.
-
-        .. _annotateText: https://cloud.google.com/natural-language/\
-                          reference/rest/v1beta1/documents/annotateText
-
-        See `annotateText`_.
-
-        :type include_syntax: bool
-        :param include_syntax: (Optional) Flag to enable syntax analysis
-                               of the current document.
-
-        :type include_entities: bool
-        :param include_entities: (Optional) Flag to enable entity extraction
-                                 from the current document.
-
-        :type include_sentiment: bool
-        :param include_sentiment: (Optional) Flag to enable sentiment
-                                  analysis of the current document.
-
-        :rtype: :class:`Annotations`
-        :returns: A tuple of each of the four values returned from the API:
-                  sentences, tokens, sentiment and entities.
-        """
-        features = {}
-        if include_syntax:
-            features['extractSyntax'] = True
-        if include_entities:
-            features['extractEntities'] = True
-        if include_sentiment:
-            features['extractDocumentSentiment'] = True
-
-        data = {
-            'document': self._to_dict(),
-            'features': features,
-            'encodingType': self.encoding,
-        }
-        api_response = self.client.connection.api_request(
-            method='POST', path='annotateText', data=data)
-
-        sentences = [Sentence.from_api_repr(sentence)
-                     for sentence in api_response['sentences']]
-        tokens = [Token.from_api_repr(token)
-                  for token in api_response['tokens']]
-        sentiment_info = api_response.get('documentSentiment')
-        if sentiment_info is None:
-            sentiment = None
-        else:
-            sentiment = Sentiment.from_api_repr(sentiment_info)
-        entities = [Entity.from_api_repr(entity)
-                    for entity in api_response['entities']]
-        annotations = Annotations(
-            sentences=sentences,
-            tokens=tokens,
-            sentiment=sentiment,
-            entities=entities,
-        )
-        return annotations
diff --git a/google/cloud/language/entity.py b/google/cloud/language/entity.py
deleted file mode 100644
index 4e523d7b5395..000000000000
--- a/google/cloud/language/entity.py
+++ /dev/null
@@ -1,108 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Definition for Google Cloud Natural Language API entities.
-
-An entity is used to describe a proper name extracted from text.
-"""
-
-
-class EntityType(object):
-    """List of possible entity types."""
-
-    UNKNOWN = 'UNKNOWN'
-    """Unknown entity type."""
-
-    PERSON = 'PERSON'
-    """Person entity type."""
-
-    LOCATION = 'LOCATION'
-    """Location entity type."""
-
-    ORGANIZATION = 'ORGANIZATION'
-    """Organization entity type."""
-
-    EVENT = 'EVENT'
-    """Event entity type."""
-
-    WORK_OF_ART = 'WORK_OF_ART'
-    """Work of art entity type."""
-
-    CONSUMER_GOOD = 'CONSUMER_GOOD'
-    """Consumer good entity type."""
-
-    OTHER = 'OTHER'
-    """Other entity type (i.e. known but not classified)."""
-
-
-class Entity(object):
-    """A Google Cloud Natural Language API entity.
-
-    Represents a phrase in text that is a known entity, such as a person,
-    an organization, or location. The API associates information, such as
-    salience and mentions, with entities.
-
-    The only supported metadata (as of August 2016) is ``wikipedia_url``,
-    so this value will be removed from the passed in ``metadata``
-    and put in its own property.
-
-    .. _Entity message: https://cloud.google.com/natural-language/\
-                        reference/rest/v1beta1/Entity
-    .. _EntityType enum: https://cloud.google.com/natural-language/\
-                         reference/rest/v1beta1/Entity#Type
-
-    See `Entity message`_.
-
-    :type name: str
-    :param name: The name / phrase identified as the entity.
-
-    :type entity_type: str
-    :param entity_type: The type of the entity. See `EntityType enum`_.
-
-    :type metadata: dict
-    :param metadata: The metadata associated with the entity.
-
-    :type salience: float
-    :param salience: The prominence of the entity / phrase within the text
-                     containing it.
-
-    :type mentions: list
-    :param mentions: List of strings that mention the entity.
-    """
-
-    def __init__(self, name, entity_type, metadata, salience, mentions):
-        self.name = name
-        self.entity_type = entity_type
-        self.wikipedia_url = metadata.pop('wikipedia_url', None)
-        self.metadata = metadata
-        self.salience = salience
-        self.mentions = mentions
-
-    @classmethod
-    def from_api_repr(cls, payload):
-        """Convert an Entity from the JSON API into an :class:`Entity`.
-
-        :param payload: dict
-        :type payload: The value from the backend.
-
-        :rtype: :class:`Entity`
-        :returns: The entity parsed from the API representation.
-        """
-        name = payload['name']
-        entity_type = payload['type']
-        metadata = payload['metadata']
-        salience = payload['salience']
-        mentions = [value['text']['content']
-                    for value in payload['mentions']]
-        return cls(name, entity_type, metadata, salience, mentions)
diff --git a/google/cloud/language/sentiment.py b/google/cloud/language/sentiment.py
deleted file mode 100644
index 8e0dc1f01162..000000000000
--- a/google/cloud/language/sentiment.py
+++ /dev/null
@@ -1,57 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Definition for Google Cloud Natural Language API sentiment.
-
-Sentiment is the response to an ``analyzeSentiment`` request.
-"""
-
-
-class Sentiment(object):
-    """A Google Cloud Natural Language API sentiment object.
-
-    .. _Sentiment message: https://cloud.google.com/natural-language/\
-                           reference/rest/v1beta1/Sentiment
-    .. _Sentiment basics: https://cloud.google.com/natural-language/\
-                          docs/basics#sentiment-analysis-values
-
-    See `Sentiment message`_ and `Sentiment basics`_.
-
-    :type polarity: float
-    :param polarity: Polarity of the sentiment in the ``[-1.0, 1.0]`` range.
-                     Larger numbers represent more positive sentiments.
-
-    :type magnitude: float
-    :param magnitude: A non-negative number in the ``[0, +inf)`` range, which
-                      represents the absolute magnitude of sentiment
-                      regardless of polarity (positive or negative).
-    """
-
-    def __init__(self, polarity, magnitude):
-        self.polarity = polarity
-        self.magnitude = magnitude
-
-    @classmethod
-    def from_api_repr(cls, payload):
-        """Convert a Sentiment from the JSON API into a :class:`Sentiment`.
-
-        :param payload: dict
-        :type payload: The value from the backend.
-
-        :rtype: :class:`Sentiment`
-        :returns: The sentiment parsed from the API representation.
-        """
-        polarity = payload['polarity']
-        magnitude = payload['magnitude']
-        return cls(polarity, magnitude)
diff --git a/google/cloud/language/syntax.py b/google/cloud/language/syntax.py
deleted file mode 100644
index d1c1178e22bc..000000000000
--- a/google/cloud/language/syntax.py
+++ /dev/null
@@ -1,203 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Google Cloud Natural Language API helpers for tokenized text.
-
-The ``annotateText`` method, when used with the "syntax" feature,
-breaks a document down into tokens and sentences.
-"""
-
-
-class PartOfSpeech(object):
-    """Part of speech of a :class:`Token`."""
-
-    UNKNOWN = 'UNKNOWN'
-    """Unknown part of speech."""
-
-    ADJECTIVE = 'ADJ'
-    """Part of speech: Adjective."""
-
-    ADPOSITION = 'ADP'
-    """Adposition (preposition and postposition)."""
-
-    ADVERB = 'ADV'
-    """Adverb."""
-
-    CONJUNCTION = 'CONJ'
-    """Conjunction."""
-
-    DETERMINER = 'DET'
-    """Determiner."""
-
-    NOUN = 'NOUN'
-    """Noun (common and proper)."""
-
-    CARDINAL_NUMBER = 'NUM'
-    """Cardinal number."""
-
-    PRONOUN = 'PRON'
-    """Pronoun."""
-
-    PARTICIPLE = 'PRT'
-    """Particle or other function word."""
-
-    PUNCTUATION = 'PUNCT'
-    """Punctuation."""
-
-    VERB = 'VERB'
-    """Verb (all tenses and modes)."""
-
-    OTHER = 'X'
-    """Other: foreign words, typos, abbreviations."""
-
-    AFFIX = 'AFFIX'
-    """Affix."""
-
-    _REVERSE_MAP = {
-        'UNKNOWN': 'UNKNOWN',
-        'ADJ': 'ADJECTIVE',
-        'ADP': 'ADPOSITION',
-        'ADV': 'ADVERB',
-        'CONJ': 'CONJUNCTION',
-        'DET': 'DETERMINER',
-        'NOUN': 'NOUN',
-        'NUM': 'CARDINAL_NUMBER',
-        'PRON': 'PRONOUN',
-        'PRT': 'PARTICIPLE',
-        'PUNCT': 'PUNCTUATION',
-        'VERB': 'VERB',
-        'X': 'OTHER',
-        'AFFIX': 'AFFIX',
-    }
-
-    @classmethod
-    def reverse(cls, tag):
-        """Reverses the API's enum name for the one on this class.
-
-        For example::
-
-            >>> PartOfSpeech.OTHER
-            'X'
-            >>> PartOfSpeech.reverse('X')
-            'OTHER'
-
-        :rtype: str
-        :returns: The attribute name corresponding to the API part of
-                  speech enum.
-        """
-        return cls._REVERSE_MAP[tag]
-
-
-class Token(object):
-    """A Google Cloud Natural Language API token object.
-
-    .. _Token message: https://cloud.google.com/natural-language/reference\
-                       /rest/v1beta1/documents/annotateText#Token
-    .. _Lemma: https://en.wikipedia.org/wiki/Lemma_(morphology)
-    .. _Label enum: https://cloud.google.com/natural-language/reference/\
-                    rest/v1beta1/documents/annotateText#Label
-
-    See `Token message`_.
-
-    :type text_content: str
-    :param text_content: The text that the token is composed of.
-
-    :type text_begin: int
-    :param text_begin: The beginning offset of the content in the original
-                       document according to the encoding type specified
-                       in the API request.
-
-    :type part_of_speech: str
-    :param part_of_speech: The part of speech of the token. See
-                           :class:`PartOfSpeech` for possible values.
-
-    :type edge_index: int
-    :param edge_index: The head of this token in the dependency tree. This is
-                       the index of the token which has an arc going to this
-                       token. The index is the position of the token in the
-                       array of tokens returned by the API method. If this
-                       token is a root token, then the ``edge_index`` is
-                       its own index.
-
-    :type edge_label: str
-    :param edge_label: See `Label enum`_.
-
-    :type lemma: str
-    :param lemma: The `Lemma`_ of the token.
-    """
-
-    def __init__(self, text_content, text_begin, part_of_speech,
-                 edge_index, edge_label, lemma):
-        self.text_content = text_content
-        self.text_begin = text_begin
-        self.part_of_speech = part_of_speech
-        self.edge_index = edge_index
-        self.edge_label = edge_label
-        self.lemma = lemma
-
-    @classmethod
-    def from_api_repr(cls, payload):
-        """Convert a token from the JSON API into a :class:`Sentiment`.
-
-        :param payload: dict
-        :type payload: The value from the backend.
-
-        :rtype: :class:`Token`
-        :returns: The token parsed from the API representation.
-        """
-        text_span = payload['text']
-        text_content = text_span['content']
-        text_begin = text_span['beginOffset']
-        part_of_speech = payload['partOfSpeech']['tag']
-        edge = payload['dependencyEdge']
-        edge_index = edge['headTokenIndex']
-        edge_label = edge['label']
-        lemma = payload['lemma']
-        return cls(text_content, text_begin, part_of_speech,
-                   edge_index, edge_label, lemma)
-
-
-class Sentence(object):
-    """A Google Cloud Natural Language API sentence object.
-
-    .. _Sentence message: https://cloud.google.com/natural-language/reference\
-                          /rest/v1beta1/documents/annotateText#Sentence
-
-    See `Sentence message`_.
-
-    :type content: str
-    :param content: The text that the sentence is composed of.
-
-    :type begin: int
-    :param begin: The beginning offset of the sentence in the original
-                  document according to the encoding type specified
-                  in the API request.
-    """
-
-    def __init__(self, content, begin):
-        self.content = content
-        self.begin = begin
-
-    @classmethod
-    def from_api_repr(cls, payload):
-        """Convert a sentence from the JSON API into a :class:`Sentiment`.
-
-        :param payload: dict
-        :type payload: The value from the backend.
-
-        :rtype: :class:`Sentence`
-        :returns: The sentence parsed from the API representation.
-        """
-        text_span = payload['text']
-        return cls(text_span['content'], text_span['beginOffset'])
diff --git a/google/cloud/logging/__init__.py b/google/cloud/logging/__init__.py
deleted file mode 100644
index fd1214fc11e9..000000000000
--- a/google/cloud/logging/__init__.py
+++ /dev/null
@@ -1,26 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Google Stackdriver Logging API wrapper."""
-
-
-from google.cloud.logging.client import Client
-from google.cloud.logging.connection import Connection
-
-
-SCOPE = Connection.SCOPE
-ASCENDING = 'timestamp asc'
-"""Query string to order by ascending timestamps."""
-DESCENDING = 'timestamp desc'
-"""Query string to order by decending timestamps."""
diff --git a/google/cloud/logging/_gax.py b/google/cloud/logging/_gax.py
deleted file mode 100644
index 9edd976dc097..000000000000
--- a/google/cloud/logging/_gax.py
+++ /dev/null
@@ -1,644 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""GAX wrapper for Logging API requests."""
-
-import json
-
-from google.gax import CallOptions
-from google.gax import INITIAL_PAGE
-from google.logging.type.log_severity_pb2 import LogSeverity
-from google.logging.v2.logging_config_pb2 import LogSink
-from google.logging.v2.logging_metrics_pb2 import LogMetric
-from google.logging.v2.log_entry_pb2 import LogEntry
-from google.protobuf.json_format import Parse
-from grpc import StatusCode
-
-# pylint: disable=ungrouped-imports
-from google.cloud._helpers import _datetime_to_pb_timestamp
-from google.cloud._helpers import _pb_timestamp_to_rfc3339
-from google.cloud.exceptions import Conflict
-from google.cloud.exceptions import GrpcRendezvous
-from google.cloud.exceptions import NotFound
-# pylint: enable=ungrouped-imports
-
-
-class _LoggingAPI(object):
-    """Helper mapping logging-related APIs.
-
-    :type gax_api:
-        :class:`google.logging.v2.logging_service_v2_api.LoggingServiceV2Api`
-    :param gax_api: API object used to make GAX requests.
-    """
-    def __init__(self, gax_api):
-        self._gax_api = gax_api
-
-    def list_entries(self, projects, filter_='', order_by='',
-                     page_size=0, page_token=None):
-        """Return a page of log entry resources.
-
-        :type projects: list of strings
-        :param projects: project IDs to include. If not passed,
-                         defaults to the project bound to the API's client.
-
-        :type filter_: str
-        :param filter_: a filter expression. See:
-                        https://cloud.google.com/logging/docs/view/advanced_filters
-
-        :type order_by: str
-        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
-                         or :data:`~google.cloud.logging.DESCENDING`.
-
-        :type page_size: int
-        :param page_size: maximum number of entries to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of entries. If not
-                           passed, the API will return the first page of
-                           entries.
-
-        :rtype: tuple, (list, str)
-        :returns: list of mappings, plus a "next page token" string:
-                  if not None, indicates that more entries can be retrieved
-                  with another call (pass that value as ``page_token``).
-        """
-        if page_token is None:
-            page_token = INITIAL_PAGE
-        options = CallOptions(page_token=page_token)
-        page_iter = self._gax_api.list_log_entries(
-            projects, filter_, order_by, page_size, options)
-        entries = [_log_entry_pb_to_mapping(entry_pb)
-                   for entry_pb in page_iter.next()]
-        token = page_iter.page_token or None
-        return entries, token
-
-    def write_entries(self, entries, logger_name=None, resource=None,
-                      labels=None):
-        """API call:  log an entry resource via a POST request
-
-        :type entries: sequence of mapping
-        :param entries: the log entry resources to log.
-
-        :type logger_name: string
-        :param logger_name: name of default logger to which to log the entries;
-                            individual entries may override.
-
-        :type resource: mapping
-        :param resource: default resource to associate with entries;
-                         individual entries may override.
-
-        :type labels: mapping
-        :param labels: default labels to associate with entries;
-                       individual entries may override.
-        """
-        options = None
-        partial_success = False
-        entry_pbs = [_log_entry_mapping_to_pb(entry) for entry in entries]
-        self._gax_api.write_log_entries(entry_pbs, logger_name, resource,
-                                        labels, partial_success, options)
-
-    def logger_delete(self, project, logger_name):
-        """API call:  delete all entries in a logger via a DELETE request
-
-        :type project: string
-        :param project: ID of project containing the log entries to delete
-
-        :type logger_name: string
-        :param logger_name: name of logger containing the log entries to delete
-        """
-        options = None
-        path = 'projects/%s/logs/%s' % (project, logger_name)
-        try:
-            self._gax_api.delete_log(path, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-
-
-class _SinksAPI(object):
-    """Helper mapping sink-related APIs.
-
-    :type gax_api:
-        :class:`google.logging.v2.config_service_v2_api.ConfigServiceV2Api`
-    :param gax_api: API object used to make GAX requests.
-    """
-    def __init__(self, gax_api):
-        self._gax_api = gax_api
-
-    def list_sinks(self, project, page_size=0, page_token=None):
-        """List sinks for the project associated with this client.
-
-        :type project: string
-        :param project: ID of the project whose sinks are to be listed.
-
-        :type page_size: int
-        :param page_size: maximum number of sinks to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of sinks. If not
-                           passed, the API will return the first page of
-                           sinks.
-
-        :rtype: tuple, (list, str)
-        :returns: list of mappings, plus a "next page token" string:
-                  if not None, indicates that more sinks can be retrieved
-                  with another call (pass that value as ``page_token``).
-        """
-        if page_token is None:
-            page_token = INITIAL_PAGE
-        options = CallOptions(page_token=page_token)
-        path = 'projects/%s' % (project,)
-        page_iter = self._gax_api.list_sinks(path, page_size, options)
-        sinks = [_log_sink_pb_to_mapping(log_sink_pb)
-                 for log_sink_pb in page_iter.next()]
-        token = page_iter.page_token or None
-        return sinks, token
-
-    def sink_create(self, project, sink_name, filter_, destination):
-        """API call:  create a sink resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/create
-
-        :type project: string
-        :param project: ID of the project in which to create the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the sink.
-
-        :type destination: string
-        :param destination: destination URI for the entries exported by
-                            the sink.
-        """
-        options = None
-        parent = 'projects/%s' % (project,)
-        sink_pb = LogSink(name=sink_name, filter=filter_,
-                          destination=destination)
-        try:
-            self._gax_api.create_sink(parent, sink_pb, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.FAILED_PRECONDITION:
-                path = 'projects/%s/sinks/%s' % (project, sink_name)
-                raise Conflict(path)
-            raise
-
-    def sink_get(self, project, sink_name):
-        """API call:  retrieve a sink resource.
-
-        :type project: string
-        :param project: ID of the project containing the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-
-        :rtype: dict
-        :returns: The sink object returned from the API (converted from a
-                  protobuf to a dictionary).
-        """
-        options = None
-        path = 'projects/%s/sinks/%s' % (project, sink_name)
-        try:
-            sink_pb = self._gax_api.get_sink(path, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-        return _log_sink_pb_to_mapping(sink_pb)
-
-    def sink_update(self, project, sink_name, filter_, destination):
-        """API call:  update a sink resource.
-
-        :type project: string
-        :param project: ID of the project containing the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the sink.
-
-        :type destination: string
-        :param destination: destination URI for the entries exported by
-                            the sink.
-
-        :rtype: dict
-        :returns: The sink object returned from the API (converted from a
-                  protobuf to a dictionary).
-        """
-        options = None
-        path = 'projects/%s/sinks/%s' % (project, sink_name)
-        sink_pb = LogSink(name=path, filter=filter_, destination=destination)
-        try:
-            self._gax_api.update_sink(path, sink_pb, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-        return _log_sink_pb_to_mapping(sink_pb)
-
-    def sink_delete(self, project, sink_name):
-        """API call:  delete a sink resource.
-
-        :type project: string
-        :param project: ID of the project containing the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-        """
-        options = None
-        path = 'projects/%s/sinks/%s' % (project, sink_name)
-        try:
-            self._gax_api.delete_sink(path, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-
-
-class _MetricsAPI(object):
-    """Helper mapping sink-related APIs.
-
-    :type gax_api:
-        :class:`google.logging.v2.metrics_service_v2_api.MetricsServiceV2Api`
-    :param gax_api: API object used to make GAX requests.
-    """
-    def __init__(self, gax_api):
-        self._gax_api = gax_api
-
-    def list_metrics(self, project, page_size=0, page_token=None):
-        """List metrics for the project associated with this client.
-
-        :type project: string
-        :param project: ID of the project whose metrics are to be listed.
-
-        :type page_size: int
-        :param page_size: maximum number of metrics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of metrics. If not
-                           passed, the API will return the first page of
-                           metrics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of mappings, plus a "next page token" string:
-                  if not None, indicates that more metrics can be retrieved
-                  with another call (pass that value as ``page_token``).
-        """
-        if page_token is None:
-            page_token = INITIAL_PAGE
-        options = CallOptions(page_token=page_token)
-        path = 'projects/%s' % (project,)
-        page_iter = self._gax_api.list_log_metrics(path, page_size, options)
-        metrics = [_log_metric_pb_to_mapping(log_metric_pb)
-                   for log_metric_pb in page_iter.next()]
-        token = page_iter.page_token or None
-        return metrics, token
-
-    def metric_create(self, project, metric_name, filter_, description):
-        """API call:  create a metric resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create
-
-        :type project: string
-        :param project: ID of the project in which to create the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the metric.
-
-        :type description: string
-        :param description: description of the metric.
-        """
-        options = None
-        parent = 'projects/%s' % (project,)
-        metric_pb = LogMetric(name=metric_name, filter=filter_,
-                              description=description)
-        try:
-            self._gax_api.create_log_metric(parent, metric_pb, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.FAILED_PRECONDITION:
-                path = 'projects/%s/metrics/%s' % (project, metric_name)
-                raise Conflict(path)
-            raise
-
-    def metric_get(self, project, metric_name):
-        """API call:  retrieve a metric resource.
-
-        :type project: string
-        :param project: ID of the project containing the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-
-        :rtype: dict
-        :returns: The metric object returned from the API (converted from a
-                  protobuf to a dictionary).
-        """
-        options = None
-        path = 'projects/%s/metrics/%s' % (project, metric_name)
-        try:
-            metric_pb = self._gax_api.get_log_metric(path, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-        return _log_metric_pb_to_mapping(metric_pb)
-
-    def metric_update(self, project, metric_name, filter_, description):
-        """API call:  update a metric resource.
-
-        :type project: string
-        :param project: ID of the project containing the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the metric.
-
-        :type description: string
-        :param description: description of the metric.
-
-        :rtype: dict
-        :returns: The metric object returned from the API (converted from a
-                  protobuf to a dictionary).
-        """
-        options = None
-        path = 'projects/%s/metrics/%s' % (project, metric_name)
-        metric_pb = LogMetric(name=path, filter=filter_,
-                              description=description)
-        try:
-            self._gax_api.update_log_metric(path, metric_pb, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-        return _log_metric_pb_to_mapping(metric_pb)
-
-    def metric_delete(self, project, metric_name):
-        """API call:  delete a metric resource.
-
-        :type project: string
-        :param project: ID of the project containing the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-        """
-        options = None
-        path = 'projects/%s/metrics/%s' % (project, metric_name)
-        try:
-            self._gax_api.delete_log_metric(path, options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(path)
-            raise
-
-
-def _mon_resource_pb_to_mapping(resource_pb):
-    """Helper for  :func:_log_entry_pb_to_mapping`.
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    mapping = {
-        'type': resource_pb.type,
-    }
-    if resource_pb.labels:
-        mapping['labels'] = resource_pb.labels
-    return mapping
-
-
-def _value_pb_to_value(value_pb):
-    """Helper for :func:`_log_entry_pb_to_mapping`.
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    kind = value_pb.WhichOneof('kind')
-
-    if kind is None:
-        result = None
-
-    elif kind == 'string_value':
-        result = value_pb.string_value
-
-    elif kind == 'bool_value':
-        result = value_pb.bool_value
-
-    elif kind == 'number_value':
-        result = value_pb.number_value
-
-    elif kind == 'list_value':
-        result = [_value_pb_to_value(element)
-                  for element in value_pb.list_value.values]
-
-    elif kind == 'struct_value':
-        result = _struct_pb_to_mapping(value_pb.struct_value)
-
-    else:
-        raise ValueError('Value protobuf had unknown kind: %s' % (kind,))
-
-    return result
-
-
-def _struct_pb_to_mapping(struct_pb):
-    """Helper for :func:`_log_entry_pb_to_mapping`.
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    return {key: _value_pb_to_value(struct_pb.fields[key])
-            for key in struct_pb.fields}
-
-
-def _log_entry_pb_to_mapping(entry_pb):
-    """Helper for :meth:`list_entries`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    mapping = {
-        'logName': entry_pb.log_name,
-        'resource': _mon_resource_pb_to_mapping(entry_pb.resource),
-        'severity': LogSeverity.Name(entry_pb.severity),
-        'insertId': entry_pb.insert_id,
-        'timestamp': _pb_timestamp_to_rfc3339(entry_pb.timestamp),
-        'labels': entry_pb.labels,
-    }
-    if entry_pb.HasField('text_payload'):
-        mapping['textPayload'] = entry_pb.text_payload
-
-    if entry_pb.HasField('json_payload'):
-        mapping['jsonPayload'] = _struct_pb_to_mapping(entry_pb.json_payload)
-
-    if entry_pb.HasField('proto_payload'):
-        mapping['protoPayload'] = entry_pb.proto_payload
-
-    if entry_pb.http_request:
-        request = entry_pb.http_request
-        mapping['httpRequest'] = {
-            'requestMethod': request.request_method,
-            'requestUrl': request.request_url,
-            'status': request.status,
-            'referer': request.referer,
-            'userAgent': request.user_agent,
-            'cacheHit': request.cache_hit,
-            'requestSize': request.request_size,
-            'responseSize': request.response_size,
-            'remoteIp': request.remote_ip,
-        }
-
-    if entry_pb.operation:
-        operation = entry_pb.operation
-        mapping['operation'] = {
-            'producer': operation.producer,
-            'id': operation.id,
-            'first': operation.first,
-            'last': operation.last,
-        }
-
-    return mapping
-
-
-def _http_request_mapping_to_pb(info, request):
-    """Helper for _log_entry_mapping_to_pb
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    optional_request_keys = {
-        'requestMethod': 'request_method',
-        'requestUrl': 'request_url',
-        'status': 'status',
-        'referer': 'referer',
-        'userAgent': 'user_agent',
-        'cacheHit': 'cache_hit',
-        'requestSize': 'request_size',
-        'responseSize': 'response_size',
-        'remoteIp': 'remote_ip',
-    }
-    for key, pb_name in optional_request_keys.items():
-        if key in info:
-            setattr(request, pb_name, info[key])
-
-
-def _log_operation_mapping_to_pb(info, operation):
-    """Helper for _log_entry_mapping_to_pb
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    operation.producer = info['producer']
-    operation.id = info['id']
-
-    if 'first' in info:
-        operation.first = info['first']
-
-    if 'last' in info:
-        operation.last = info['last']
-
-
-def _log_entry_mapping_to_pb(mapping):
-    """Helper for :meth:`write_entries`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    # pylint: disable=too-many-branches
-    entry_pb = LogEntry()
-
-    optional_scalar_keys = {
-        'logName': 'log_name',
-        'insertId': 'insert_id',
-        'textPayload': 'text_payload',
-    }
-
-    for key, pb_name in optional_scalar_keys.items():
-        if key in mapping:
-            setattr(entry_pb, pb_name, mapping[key])
-
-    if 'resource' in mapping:
-        entry_pb.resource.type = mapping['resource']['type']
-
-    if 'severity' in mapping:
-        severity = mapping['severity']
-        if isinstance(severity, str):
-            severity = LogSeverity.Value(severity)
-        entry_pb.severity = severity
-
-    if 'timestamp' in mapping:
-        timestamp = _datetime_to_pb_timestamp(mapping['timestamp'])
-        entry_pb.timestamp.CopyFrom(timestamp)
-
-    if 'labels' in mapping:
-        for key, value in mapping['labels'].items():
-            entry_pb.labels[key] = value
-
-    if 'jsonPayload' in mapping:
-        for key, value in mapping['jsonPayload'].items():
-            entry_pb.json_payload[key] = value
-
-    if 'protoPayload' in mapping:
-        Parse(json.dumps(mapping['protoPayload']), entry_pb.proto_payload)
-
-    if 'httpRequest' in mapping:
-        _http_request_mapping_to_pb(
-            mapping['httpRequest'], entry_pb.http_request)
-
-    if 'operation' in mapping:
-        _log_operation_mapping_to_pb(
-            mapping['operation'], entry_pb.operation)
-
-    return entry_pb
-    # pylint: enable=too-many-branches
-
-
-def _log_sink_pb_to_mapping(sink_pb):
-    """Helper for :meth:`list_sinks`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    return {
-        'name': sink_pb.name,
-        'destination': sink_pb.destination,
-        'filter': sink_pb.filter,
-    }
-
-
-def _log_metric_pb_to_mapping(metric_pb):
-    """Helper for :meth:`list_metrics`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    return {
-        'name': metric_pb.name,
-        'description': metric_pb.description,
-        'filter': metric_pb.filter,
-    }
diff --git a/google/cloud/logging/client.py b/google/cloud/logging/client.py
deleted file mode 100644
index 487b406bf92e..000000000000
--- a/google/cloud/logging/client.py
+++ /dev/null
@@ -1,302 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client for interacting with the Google Stackdriver Logging API."""
-
-import os
-
-try:
-    from google.cloud.gapic.logging.v2.config_service_v2_api import (
-        ConfigServiceV2Api as GeneratedSinksAPI)
-    from google.cloud.gapic.logging.v2.logging_service_v2_api import (
-        LoggingServiceV2Api as GeneratedLoggingAPI)
-    from google.cloud.gapic.logging.v2.metrics_service_v2_api import (
-        MetricsServiceV2Api as GeneratedMetricsAPI)
-    from google.cloud.logging._gax import _LoggingAPI as GAXLoggingAPI
-    from google.cloud.logging._gax import _MetricsAPI as GAXMetricsAPI
-    from google.cloud.logging._gax import _SinksAPI as GAXSinksAPI
-except ImportError:  # pragma: NO COVER
-    _HAVE_GAX = False
-    GeneratedLoggingAPI = GAXLoggingAPI = None
-    GeneratedMetricsAPI = GAXMetricsAPI = None
-    GeneratedSinksAPI = GAXSinksAPI = None
-else:
-    _HAVE_GAX = True
-
-from google.cloud.client import JSONClient
-from google.cloud.environment_vars import DISABLE_GRPC
-from google.cloud.logging.connection import Connection
-from google.cloud.logging.connection import _LoggingAPI as JSONLoggingAPI
-from google.cloud.logging.connection import _MetricsAPI as JSONMetricsAPI
-from google.cloud.logging.connection import _SinksAPI as JSONSinksAPI
-from google.cloud.logging.entries import ProtobufEntry
-from google.cloud.logging.entries import StructEntry
-from google.cloud.logging.entries import TextEntry
-from google.cloud.logging.logger import Logger
-from google.cloud.logging.metric import Metric
-from google.cloud.logging.sink import Sink
-
-
-_DISABLE_GAX = os.getenv(DISABLE_GRPC, False)
-_USE_GAX = _HAVE_GAX and not _DISABLE_GAX
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: str
-    :param project: the project which the client acts on behalf of.
-                    If not passed, falls back to the default inferred
-                    from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-    _logging_api = _sinks_api = _metrics_api = None
-
-    @property
-    def logging_api(self):
-        """Helper for logging-related API calls.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
-        """
-        if self._logging_api is None:
-            if _USE_GAX:
-                generated = GeneratedLoggingAPI()
-                self._logging_api = GAXLoggingAPI(generated)
-            else:
-                self._logging_api = JSONLoggingAPI(self.connection)
-        return self._logging_api
-
-    @property
-    def sinks_api(self):
-        """Helper for log sink-related API calls.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
-        """
-        if self._sinks_api is None:
-            if _USE_GAX:
-                generated = GeneratedSinksAPI()
-                self._sinks_api = GAXSinksAPI(generated)
-            else:
-                self._sinks_api = JSONSinksAPI(self.connection)
-        return self._sinks_api
-
-    @property
-    def metrics_api(self):
-        """Helper for log metric-related API calls.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
-        """
-        if self._metrics_api is None:
-            if _USE_GAX:
-                generated = GeneratedMetricsAPI()
-                self._metrics_api = GAXMetricsAPI(generated)
-            else:
-                self._metrics_api = JSONMetricsAPI(self.connection)
-        return self._metrics_api
-
-    def logger(self, name):
-        """Creates a logger bound to the current client.
-
-        :type name: str
-        :param name: the name of the logger to be constructed.
-
-        :rtype: :class:`google.cloud.logging.logger.Logger`
-        :returns: Logger created with the current client.
-        """
-        return Logger(name, client=self)
-
-    def _entry_from_resource(self, resource, loggers):
-        """Detect correct entry type from resource and instantiate.
-
-        :type resource: dict
-        :param resource: one entry resource from API response
-
-        :type loggers: dict or None
-        :param loggers: A mapping of logger fullnames -> loggers.  If not
-                        passed, the entry will have a newly-created logger.
-
-        :rtype: One of:
-                :class:`google.cloud.logging.entries.TextEntry`,
-                :class:`google.cloud.logging.entries.StructEntry`,
-                :class:`google.cloud.logging.entries.ProtobufEntry`
-        :returns: the entry instance, constructed via the resource
-        """
-        if 'textPayload' in resource:
-            return TextEntry.from_api_repr(resource, self, loggers)
-        elif 'jsonPayload' in resource:
-            return StructEntry.from_api_repr(resource, self, loggers)
-        elif 'protoPayload' in resource:
-            return ProtobufEntry.from_api_repr(resource, self, loggers)
-        raise ValueError('Cannot parse log entry resource')
-
-    def list_entries(self, projects=None, filter_=None, order_by=None,
-                     page_size=None, page_token=None):
-        """Return a page of log entries.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list
-
-        :type projects: list of strings
-        :param projects: project IDs to include. If not passed,
-                            defaults to the project bound to the client.
-
-        :type filter_: str
-        :param filter_: a filter expression. See:
-                        https://cloud.google.com/logging/docs/view/advanced_filters
-
-        :type order_by: str
-        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
-                         or :data:`~google.cloud.logging.DESCENDING`.
-
-        :type page_size: int
-        :param page_size: maximum number of entries to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of entries. If not
-                           passed, the API will return the first page of
-                           entries.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.logging.entry.TextEntry`, plus a
-                  "next page token" string:  if not None, indicates that
-                  more entries can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        if projects is None:
-            projects = [self.project]
-
-        resources, token = self.logging_api.list_entries(
-            projects=projects, filter_=filter_, order_by=order_by,
-            page_size=page_size, page_token=page_token)
-        loggers = {}
-        entries = [self._entry_from_resource(resource, loggers)
-                   for resource in resources]
-        return entries, token
-
-    def sink(self, name, filter_=None, destination=None):
-        """Creates a sink bound to the current client.
-
-        :type name: str
-        :param name: the name of the sink to be constructed.
-
-        :type filter_: str
-        :param filter_: (optional) the advanced logs filter expression
-                        defining the entries exported by the sink.  If not
-                        passed, the instance should already exist, to be
-                        refreshed via :meth:`Sink.reload`.
-
-        :type destination: str
-        :param destination: destination URI for the entries exported by
-                            the sink.  If not passed, the instance should
-                            already exist, to be refreshed via
-                            :meth:`Sink.reload`.
-
-        :rtype: :class:`google.cloud.logging.sink.Sink`
-        :returns: Sink created with the current client.
-        """
-        return Sink(name, filter_, destination, client=self)
-
-    def list_sinks(self, page_size=None, page_token=None):
-        """List sinks for the project associated with this client.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/list
-
-        :type page_size: int
-        :param page_size: maximum number of sinks to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of sinks. If not
-                           passed, the API will return the first page of
-                           sinks.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.logging.sink.Sink`, plus a
-                  "next page token" string:  if not None, indicates that
-                  more sinks can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        resources, token = self.sinks_api.list_sinks(
-            self.project, page_size, page_token)
-        sinks = [Sink.from_api_repr(resource, self)
-                 for resource in resources]
-        return sinks, token
-
-    def metric(self, name, filter_=None, description=''):
-        """Creates a metric bound to the current client.
-
-        :type name: str
-        :param name: the name of the metric to be constructed.
-
-        :type filter_: str
-        :param filter_: the advanced logs filter expression defining the
-                        entries tracked by the metric.  If not
-                        passed, the instance should already exist, to be
-                        refreshed via :meth:`Metric.reload`.
-
-        :type description: str
-        :param description: the description of the metric to be constructed.
-                            If not passed, the instance should already exist,
-                            to be refreshed via :meth:`Metric.reload`.
-
-        :rtype: :class:`google.cloud.logging.metric.Metric`
-        :returns: Metric created with the current client.
-        """
-        return Metric(name, filter_, client=self, description=description)
-
-    def list_metrics(self, page_size=None, page_token=None):
-        """List metrics for the project associated with this client.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/list
-
-        :type page_size: int
-        :param page_size: maximum number of metrics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of metrics. If not
-                           passed, the API will return the first page of
-                           metrics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.logging.metric.Metric`, plus a
-                  "next page token" string:  if not None, indicates that
-                  more metrics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        resources, token = self.metrics_api.list_metrics(
-            self.project, page_size, page_token)
-        metrics = [Metric.from_api_repr(resource, self)
-                   for resource in resources]
-        return metrics, token
diff --git a/google/cloud/logging/connection.py b/google/cloud/logging/connection.py
deleted file mode 100644
index fcfc0d13054c..000000000000
--- a/google/cloud/logging/connection.py
+++ /dev/null
@@ -1,441 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Create / interact with Stackdriver Logging connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Stackdriver Logging via the JSON REST API.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: (Optional) HTTP object to make requests.
-
-    :type api_base_url: string
-    :param api_base_url: The base of the API call URL. Defaults to the value
-                         :attr:`Connection.API_BASE_URL`.
-    """
-
-    API_BASE_URL = 'https://logging.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v2beta1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/logging.read',
-             'https://www.googleapis.com/auth/logging.write',
-             'https://www.googleapis.com/auth/logging.admin',
-             'https://www.googleapis.com/auth/cloud-platform')
-    """The scopes required for authenticating as a Logging consumer."""
-
-
-class _LoggingAPI(object):
-    """Helper mapping logging-related APIs.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
-
-    :type connection: :class:`google.cloud.logging.connection.Connection`
-    :param connection: the connection used to make API requests.
-    """
-    def __init__(self, connection):
-        self._connection = connection
-
-    def list_entries(self, projects, filter_=None, order_by=None,
-                     page_size=None, page_token=None):
-        """Return a page of log entry resources.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list
-
-        :type projects: list of strings
-        :param projects: project IDs to include. If not passed,
-                            defaults to the project bound to the client.
-
-        :type filter_: str
-        :param filter_: a filter expression. See:
-                        https://cloud.google.com/logging/docs/view/advanced_filters
-
-        :type order_by: str
-        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
-                         or :data:`~google.cloud.logging.DESCENDING`.
-
-        :type page_size: int
-        :param page_size: maximum number of entries to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of entries. If not
-                           passed, the API will return the first page of
-                           entries.
-
-        :rtype: tuple, (list, str)
-        :returns: list of mappings, plus a "next page token" string:
-                  if not None, indicates that more entries can be retrieved
-                  with another call (pass that value as ``page_token``).
-        """
-        params = {'projectIds': projects}
-
-        if filter_ is not None:
-            params['filter'] = filter_
-
-        if order_by is not None:
-            params['orderBy'] = order_by
-
-        if page_size is not None:
-            params['pageSize'] = page_size
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        resp = self._connection.api_request(
-            method='POST', path='/entries:list', data=params)
-
-        return resp.get('entries', ()), resp.get('nextPageToken')
-
-    def write_entries(self, entries, logger_name=None, resource=None,
-                      labels=None):
-        """API call:  log an entry resource via a POST request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
-
-        :type entries: sequence of mapping
-        :param entries: the log entry resources to log.
-
-        :type logger_name: string
-        :param logger_name: name of default logger to which to log the entries;
-                            individual entries may override.
-
-        :type resource: mapping
-        :param resource: default resource to associate with entries;
-                         individual entries may override.
-
-        :type labels: mapping
-        :param labels: default labels to associate with entries;
-                       individual entries may override.
-        """
-        data = {'entries': list(entries)}
-
-        if logger_name is not None:
-            data['logName'] = logger_name
-
-        if resource is not None:
-            data['resource'] = resource
-
-        if labels is not None:
-            data['labels'] = labels
-
-        self._connection.api_request(method='POST', path='/entries:write',
-                                     data=data)
-
-    def logger_delete(self, project, logger_name):
-        """API call:  delete all entries in a logger via a DELETE request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs/delete
-
-        :type project: string
-        :param project: ID of project containing the log entries to delete
-
-        :type logger_name: string
-        :param logger_name: name of logger containing the log entries to delete
-        """
-        path = '/projects/%s/logs/%s' % (project, logger_name)
-        self._connection.api_request(method='DELETE', path=path)
-
-
-class _SinksAPI(object):
-    """Helper mapping sink-related APIs.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
-
-    :type connection: :class:`google.cloud.logging.connection.Connection`
-    :param connection: the connection used to make API requests.
-    """
-    def __init__(self, connection):
-        self._connection = connection
-
-    def list_sinks(self, project, page_size=None, page_token=None):
-        """List sinks for the project associated with this client.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/list
-
-        :type project: string
-        :param project: ID of the project whose sinks are to be listed.
-
-        :type page_size: int
-        :param page_size: maximum number of sinks to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of sinks. If not
-                           passed, the API will return the first page of
-                           sinks.
-
-        :rtype: tuple, (list, str)
-        :returns: list of mappings, plus a "next page token" string:
-                  if not None, indicates that more sinks can be retrieved
-                  with another call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if page_size is not None:
-            params['pageSize'] = page_size
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/sinks' % (project,)
-        resp = self._connection.api_request(
-            method='GET', path=path, query_params=params)
-        sinks = resp.get('sinks', ())
-        return sinks, resp.get('nextPageToken')
-
-    def sink_create(self, project, sink_name, filter_, destination):
-        """API call:  create a sink resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/create
-
-        :type project: string
-        :param project: ID of the project in which to create the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the sink.
-
-        :type destination: string
-        :param destination: destination URI for the entries exported by
-                            the sink.
-        """
-        target = '/projects/%s/sinks' % (project,)
-        data = {
-            'name': sink_name,
-            'filter': filter_,
-            'destination': destination,
-        }
-        self._connection.api_request(method='POST', path=target, data=data)
-
-    def sink_get(self, project, sink_name):
-        """API call:  retrieve a sink resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/get
-
-        :type project: string
-        :param project: ID of the project containing the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-
-        :rtype: dict
-        :returns: The JSON sink object returned from the API.
-        """
-        target = '/projects/%s/sinks/%s' % (project, sink_name)
-        return self._connection.api_request(method='GET', path=target)
-
-    def sink_update(self, project, sink_name, filter_, destination):
-        """API call:  update a sink resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/update
-
-        :type project: string
-        :param project: ID of the project containing the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the sink.
-
-        :type destination: string
-        :param destination: destination URI for the entries exported by
-                            the sink.
-        """
-        target = '/projects/%s/sinks/%s' % (project, sink_name)
-        data = {
-            'name': sink_name,
-            'filter': filter_,
-            'destination': destination,
-        }
-        self._connection.api_request(method='PUT', path=target, data=data)
-
-    def sink_delete(self, project, sink_name):
-        """API call:  delete a sink resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/delete
-
-        :type project: string
-        :param project: ID of the project containing the sink.
-
-        :type sink_name: string
-        :param sink_name: the name of the sink
-        """
-        target = '/projects/%s/sinks/%s' % (project, sink_name)
-        self._connection.api_request(method='DELETE', path=target)
-
-
-class _MetricsAPI(object):
-    """Helper mapping sink-related APIs.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
-
-    :type connection: :class:`google.cloud.logging.connection.Connection`
-    :param connection: the connection used to make API requests.
-    """
-    def __init__(self, connection):
-        self._connection = connection
-
-    def list_metrics(self, project, page_size=None, page_token=None):
-        """List metrics for the project associated with this client.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/list
-
-        :type project: string
-        :param project: ID of the project whose metrics are to be listed.
-
-        :type page_size: int
-        :param page_size: maximum number of metrics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: str
-        :param page_token: opaque marker for the next "page" of metrics. If not
-                           passed, the API will return the first page of
-                           metrics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of mappings, plus a "next page token" string:
-                  if not None, indicates that more metrics can be retrieved
-                  with another call (pass that value as ``page_token``).
-        """
-        params = {}
-
-        if page_size is not None:
-            params['pageSize'] = page_size
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/metrics' % (project,)
-        resp = self._connection.api_request(
-            method='GET', path=path, query_params=params)
-        metrics = resp.get('metrics', ())
-        return metrics, resp.get('nextPageToken')
-
-    def metric_create(self, project, metric_name, filter_, description=None):
-        """API call:  create a metric resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create
-
-        :type project: string
-        :param project: ID of the project in which to create the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the metric.
-
-        :type description: string
-        :param description: description of the metric.
-        """
-        target = '/projects/%s/metrics' % (project,)
-        data = {
-            'name': metric_name,
-            'filter': filter_,
-            'description': description,
-        }
-        self._connection.api_request(method='POST', path=target, data=data)
-
-    def metric_get(self, project, metric_name):
-        """API call:  retrieve a metric resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get
-
-        :type project: string
-        :param project: ID of the project containing the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-
-        :rtype: dict
-        :returns: The JSON metric object returned from the API.
-        """
-        target = '/projects/%s/metrics/%s' % (project, metric_name)
-        return self._connection.api_request(method='GET', path=target)
-
-    def metric_update(self, project, metric_name, filter_, description):
-        """API call:  update a metric resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/update
-
-        :type project: string
-        :param project: ID of the project containing the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric
-
-        :type filter_: string
-        :param filter_: the advanced logs filter expression defining the
-                        entries exported by the metric.
-
-        :type description: string
-        :param description: description of the metric.
-        """
-        target = '/projects/%s/metrics/%s' % (project, metric_name)
-        data = {
-            'name': metric_name,
-            'filter': filter_,
-            'description': description,
-        }
-        self._connection.api_request(method='PUT', path=target, data=data)
-
-    def metric_delete(self, project, metric_name):
-        """API call:  delete a metric resource.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/delete
-
-        :type project: string
-        :param project: ID of the project containing the metric.
-
-        :type metric_name: string
-        :param metric_name: the name of the metric.
-        """
-        target = '/projects/%s/metrics/%s' % (project, metric_name)
-        self._connection.api_request(method='DELETE', path=target)
diff --git a/google/cloud/logging/entries.py b/google/cloud/logging/entries.py
deleted file mode 100644
index 3779c5062ce9..000000000000
--- a/google/cloud/logging/entries.py
+++ /dev/null
@@ -1,157 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Log entries within the Google Stackdriver Logging API."""
-
-import json
-import re
-
-from google.protobuf.json_format import Parse
-
-from google.cloud._helpers import _name_from_project_path
-from google.cloud._helpers import _rfc3339_nanos_to_datetime
-
-
-_LOGGER_TEMPLATE = re.compile(r"""
-    projects/            # static prefix
-    (?P<project>[^/]+)   # initial letter, wordchars + hyphen
-    /logs/               # static midfix
-    (?P<name>[^/]+)      # initial letter, wordchars + allowed punc
-""", re.VERBOSE)
-
-
-def logger_name_from_path(path):
-    """Validate a logger URI path and get the logger name.
-
-    :type path: str
-    :param path: URI path for a logger API request.
-
-    :rtype: str
-    :returns: Logger name parsed from ``path``.
-    :raises: :class:`ValueError` if the ``path`` is ill-formed or if
-             the project from the ``path`` does not agree with the
-             ``project`` passed in.
-    """
-    return _name_from_project_path(path, None, _LOGGER_TEMPLATE)
-
-
-class _BaseEntry(object):
-    """Base class for TextEntry, StructEntry.
-
-    :type payload: text or dict
-    :param payload: The payload passed as ``textPayload``, ``jsonPayload``,
-                    or ``protoPayload``.
-
-    :type logger: :class:`google.cloud.logging.logger.Logger`
-    :param logger: the logger used to write the entry.
-
-    :type insert_id: text, or :class:`NoneType`
-    :param insert_id: (optional) the ID used to identify an entry uniquely.
-
-    :type timestamp: :class:`datetime.datetime`, or :class:`NoneType`
-    :param timestamp: (optional) timestamp for the entry
-
-    :type labels: dict or :class:`NoneType`
-    :param labels: (optional) mapping of labels for the entry
-
-    :type severity: string or :class:`NoneType`
-    :param severity: (optional) severity of event being logged.
-
-    :type http_request: dict or :class:`NoneType`
-    :param http_request: (optional) info about HTTP request associated with
-                         the entry
-    """
-    def __init__(self, payload, logger, insert_id=None, timestamp=None,
-                 labels=None, severity=None, http_request=None):
-        self.payload = payload
-        self.logger = logger
-        self.insert_id = insert_id
-        self.timestamp = timestamp
-        self.labels = labels
-        self.severity = severity
-        self.http_request = http_request
-
-    @classmethod
-    def from_api_repr(cls, resource, client, loggers=None):
-        """Factory:  construct an entry given its API representation
-
-        :type resource: dict
-        :param resource: text entry resource representation returned from
-                         the API
-
-        :type client: :class:`google.cloud.logging.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration.
-
-        :type loggers: dict or None
-        :param loggers: A mapping of logger fullnames -> loggers.  If not
-                        passed, the entry will have a newly-created logger.
-
-        :rtype: :class:`google.cloud.logging.entries.TextEntry`
-        :returns: Text entry parsed from ``resource``.
-        """
-        if loggers is None:
-            loggers = {}
-        logger_fullname = resource['logName']
-        logger = loggers.get(logger_fullname)
-        if logger is None:
-            logger_name = logger_name_from_path(logger_fullname)
-            logger = loggers[logger_fullname] = client.logger(logger_name)
-        payload = resource[cls._PAYLOAD_KEY]
-        insert_id = resource.get('insertId')
-        timestamp = resource.get('timestamp')
-        if timestamp is not None:
-            timestamp = _rfc3339_nanos_to_datetime(timestamp)
-        labels = resource.get('labels')
-        severity = resource.get('severity')
-        http_request = resource.get('httpRequest')
-        return cls(payload, logger, insert_id=insert_id, timestamp=timestamp,
-                   labels=labels, severity=severity, http_request=http_request)
-
-
-class TextEntry(_BaseEntry):
-    """Entry created with ``textPayload``.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/LogEntry
-    """
-    _PAYLOAD_KEY = 'textPayload'
-
-
-class StructEntry(_BaseEntry):
-    """Entry created with ``jsonPayload``.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/LogEntry
-    """
-    _PAYLOAD_KEY = 'jsonPayload'
-
-
-class ProtobufEntry(_BaseEntry):
-    """Entry created with ``protoPayload``.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/LogEntry
-    """
-    _PAYLOAD_KEY = 'protoPayload'
-
-    def parse_message(self, message):
-        """Parse payload into a protobuf message.
-
-        Mutates the passed-in ``message`` in place.
-
-        :type message: Protobuf message
-        :param message: the message to be logged
-        """
-        Parse(json.dumps(self.payload), message)
diff --git a/google/cloud/logging/handlers/__init__.py b/google/cloud/logging/handlers/__init__.py
deleted file mode 100644
index 5d49a4eb8738..000000000000
--- a/google/cloud/logging/handlers/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Python :mod:`logging` handlers for Google Cloud Logging."""
-
-from google.cloud.logging.handlers.handlers import CloudLoggingHandler
-from google.cloud.logging.handlers.handlers import setup_logging
diff --git a/google/cloud/logging/handlers/handlers.py b/google/cloud/logging/handlers/handlers.py
deleted file mode 100644
index 547f6b9b8244..000000000000
--- a/google/cloud/logging/handlers/handlers.py
+++ /dev/null
@@ -1,133 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Python :mod:`logging` handlers for Google Cloud Logging."""
-
-import logging
-
-from google.cloud.logging.handlers.transports import BackgroundThreadTransport
-
-
-EXCLUDE_LOGGER_DEFAULTS = (
-    'google.cloud',
-    'oauth2client'
-)
-
-DEFAULT_LOGGER_NAME = 'python'
-
-
-class CloudLoggingHandler(logging.StreamHandler):
-    """Python standard ``logging`` handler.
-
-    This handler can be used to route Python standard logging messages
-    directly to the Stackdriver Logging API.
-
-    Note that this handler currently only supports a synchronous API call,
-    which means each logging statement that uses this handler will require
-    an API call.
-
-    :type client: :class:`google.cloud.logging.client`
-    :param client: the authenticated Google Cloud Logging client for this
-                   handler to use
-
-    :type name: str
-    :param name: the name of the custom log in Stackdriver Logging. Defaults
-                 to 'python'. The name of the Python logger will be represented
-                 in the ``python_logger`` field.
-
-    :type transport: type
-    :param transport: Class for creating new transport objects. It should
-                      extend from the base :class:`.Transport` type and
-                      implement :meth`.Transport.send`. Defaults to
-                      :class:`.BackgroundThreadTransport`. The other
-                      option is :class:`.SyncTransport`.
-
-    Example:
-
-    .. doctest::
-
-        import google.cloud.logging
-        from google.cloud.logging.handlers import CloudLoggingHandler
-
-        client = google.cloud.logging.Client()
-        handler = CloudLoggingHandler(client)
-
-        cloud_logger = logging.getLogger('cloudLogger')
-        cloud_logger.setLevel(logging.INFO)
-        cloud_logger.addHandler(handler)
-
-        cloud.logger.error('bad news')  # API call
-
-    """
-
-    def __init__(self, client,
-                 name=DEFAULT_LOGGER_NAME,
-                 transport=BackgroundThreadTransport):
-        super(CloudLoggingHandler, self).__init__()
-        self.name = name
-        self.client = client
-        self.transport = transport(client, name)
-
-    def emit(self, record):
-        """Actually log the specified logging record.
-
-        Overrides the default emit behavior of ``StreamHandler``.
-
-        See: https://docs.python.org/2/library/logging.html#handler-objects
-
-        :type record: :class:`logging.LogRecord`
-        :param record: The record to be logged.
-        """
-        message = super(CloudLoggingHandler, self).format(record)
-        self.transport.send(record, message)
-
-
-def setup_logging(handler, excluded_loggers=EXCLUDE_LOGGER_DEFAULTS):
-    """Attach the ``CloudLogging`` handler to the Python root logger
-
-    Excludes loggers that this library itself uses to avoid
-    infinite recursion.
-
-    :type handler: :class:`logging.handler`
-    :param handler: the handler to attach to the global handler
-
-    :type excluded_loggers: tuple
-    :param excluded_loggers: The loggers to not attach the handler to. This
-                             will always include the loggers in the path of
-                             the logging client itself.
-
-    Example:
-
-    .. doctest::
-
-        import logging
-        import google.cloud.logging
-        from google.cloud.logging.handlers import CloudLoggingHandler
-
-        client = google.cloud.logging.Client()
-        handler = CloudLoggingHandler(client)
-        google.cloud.logging.setup_logging(handler)
-        logging.getLogger().setLevel(logging.DEBUG)
-
-        logging.error('bad news')  # API call
-
-    """
-    all_excluded_loggers = set(excluded_loggers + EXCLUDE_LOGGER_DEFAULTS)
-    logger = logging.getLogger()
-    logger.addHandler(handler)
-    logger.addHandler(logging.StreamHandler())
-    for logger_name in all_excluded_loggers:
-        logger = logging.getLogger(logger_name)
-        logger.propagate = False
-        logger.addHandler(logging.StreamHandler())
diff --git a/google/cloud/logging/handlers/transports/__init__.py b/google/cloud/logging/handlers/transports/__init__.py
deleted file mode 100644
index b0e9d7c0a43e..000000000000
--- a/google/cloud/logging/handlers/transports/__init__.py
+++ /dev/null
@@ -1,26 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Transport classes for Python logging integration.
-
-Currently two options are provided, a synchronous transport that makes
-an API call for each log statement, and an asynchronous handler that
-sends the API using a :class:`~google.cloud.logging.logger.Batch` object in
-the background.
-"""
-
-from google.cloud.logging.handlers.transports.base import Transport
-from google.cloud.logging.handlers.transports.sync import SyncTransport
-from google.cloud.logging.handlers.transports.background_thread import (
-    BackgroundThreadTransport)
diff --git a/google/cloud/logging/handlers/transports/background_thread.py b/google/cloud/logging/handlers/transports/background_thread.py
deleted file mode 100644
index 0e94fde1e1b7..000000000000
--- a/google/cloud/logging/handlers/transports/background_thread.py
+++ /dev/null
@@ -1,171 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Transport for Python logging handler
-
-Uses a background worker to log to Stackdriver Logging asynchronously.
-"""
-
-import atexit
-import copy
-import threading
-
-from google.cloud.logging.client import Client
-from google.cloud.logging.handlers.transports.base import Transport
-
-
-class _Worker(object):
-    """A threaded worker that writes batches of log entries
-
-    Writes entries to the logger API.
-
-    This class reuses a single :class:`Batch` method to write successive
-    entries.
-
-    Currently, the only public methods are constructing it (which also starts
-    it) and enqueuing :class:`Logger` (record, message) pairs.
-    """
-
-    def __init__(self, logger):
-        self.started = False
-        self.stopping = False
-        self.stopped = False
-
-        # _entries_condition is used to signal from the main thread whether
-        # there are any waiting queued logger entries to be written
-        self._entries_condition = threading.Condition()
-
-        # _stop_condition is used to signal from the worker thread to the
-        # main thread that it's finished its last entries
-        self._stop_condition = threading.Condition()
-
-        # This object continually reuses the same :class:`Batch` object to
-        # write multiple entries at the same time.
-        self.logger = logger
-        self.batch = self.logger.batch()
-
-        self._thread = None
-
-        # Number in seconds of  how long to wait for worker to send remaining
-        self._stop_timeout = 5
-
-        self._start()
-
-    def _run(self):
-        """The entry point for the worker thread.
-
-        Loops until ``stopping`` is set to :data:`True`, and commits batch
-        entries written during :meth:`enqueue`.
-        """
-        try:
-            self._entries_condition.acquire()
-            self.started = True
-            while not self.stopping:
-                if len(self.batch.entries) == 0:
-                    # branch coverage of this code extremely flaky
-                    self._entries_condition.wait()  # pragma: NO COVER
-
-                if len(self.batch.entries) > 0:
-                    self.batch.commit()
-        finally:
-            self._entries_condition.release()
-
-        # main thread may be waiting for worker thread to finish writing its
-        # final entries. here we signal that it's done.
-        self._stop_condition.acquire()
-        self._stop_condition.notify()
-        self._stop_condition.release()
-
-    def _start(self):
-        """Called by this class's constructor
-
-        This method is responsible for starting the thread and registering
-        the exit handlers.
-        """
-        try:
-            self._entries_condition.acquire()
-            self._thread = threading.Thread(
-                target=self._run,
-                name='google.cloud.logging.handlers.transport.Worker')
-            self._thread.setDaemon(True)
-            self._thread.start()
-        finally:
-            self._entries_condition.release()
-            atexit.register(self._stop)
-
-    def _stop(self):
-        """Signals the worker thread to shut down
-
-        Also waits for ``stop_timeout`` seconds for the worker to finish.
-
-        This method is called by the ``atexit`` handler registered by
-         :meth:`start`.
-        """
-        if not self.started or self.stopping:
-            return
-
-        # lock the stop condition first so that the worker
-        # thread can't notify it's finished before we wait
-        self._stop_condition.acquire()
-
-        # now notify the worker thread to shutdown
-        self._entries_condition.acquire()
-        self.stopping = True
-        self._entries_condition.notify()
-        self._entries_condition.release()
-
-        # now wait for it to signal it's finished
-        self._stop_condition.wait(self._stop_timeout)
-        self._stop_condition.release()
-        self.stopped = True
-
-    def enqueue(self, record, message):
-        """Queues up a log entry to be written by the background thread."""
-        try:
-            self._entries_condition.acquire()
-            if self.stopping:
-                return
-            info = {'message': message, 'python_logger': record.name}
-            self.batch.log_struct(info, severity=record.levelname)
-            self._entries_condition.notify()
-        finally:
-            self._entries_condition.release()
-
-
-class BackgroundThreadTransport(Transport):
-    """Aysnchronous transport that uses a background thread.
-
-    Writes logging entries as a batch process.
-    """
-
-    def __init__(self, client, name):
-        http = copy.deepcopy(client.connection.http)
-        http = client.connection.credentials.authorize(http)
-        self.client = Client(client.project,
-                             client.connection.credentials,
-                             http)
-        logger = self.client.logger(name)
-        self.worker = _Worker(logger)
-
-    def send(self, record, message):
-        """Overrides Transport.send().
-
-        :type record: :class:`logging.LogRecord`
-        :param record: Python log record that the handler was called with.
-
-        :type message: str
-        :param message: The message from the ``LogRecord`` after being
-                        formatted by the associated log formatters.
-        """
-        self.worker.enqueue(record, message)
diff --git a/google/cloud/logging/handlers/transports/base.py b/google/cloud/logging/handlers/transports/base.py
deleted file mode 100644
index edc5dff7d0e4..000000000000
--- a/google/cloud/logging/handlers/transports/base.py
+++ /dev/null
@@ -1,35 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Module containing base class for logging transport."""
-
-
-class Transport(object):
-    """Base class for Google Cloud Logging handler transports.
-
-    Subclasses of :class:`Transport` must have constructors that accept a
-    client and name object, and must override :meth:`send`.
-    """
-
-    def send(self, record, message):
-        """Transport send to be implemented by subclasses.
-
-        :type record: :class:`logging.LogRecord`
-        :param record: Python log record that the handler was called with.
-
-        :type message: str
-        :param message: The message from the ``LogRecord`` after being
-                        formatted by the associated log formatters.
-        """
-        raise NotImplementedError
diff --git a/google/cloud/logging/handlers/transports/sync.py b/google/cloud/logging/handlers/transports/sync.py
deleted file mode 100644
index 4255c71b1a30..000000000000
--- a/google/cloud/logging/handlers/transports/sync.py
+++ /dev/null
@@ -1,43 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Transport for Python logging handler.
-
-Logs directly to the the Stackdriver Logging API with a synchronous call.
-"""
-
-from google.cloud.logging.handlers.transports.base import Transport
-
-
-class SyncTransport(Transport):
-    """Basic sychronous transport.
-
-    Uses this library's Logging client to directly make the API call.
-    """
-
-    def __init__(self, client, name):
-        self.logger = client.logger(name)
-
-    def send(self, record, message):
-        """Overrides transport.send().
-
-        :type record: :class:`logging.LogRecord`
-        :param record: Python log record that the handler was called with.
-
-        :type message: str
-        :param message: The message from the ``LogRecord`` after being
-                        formatted by the associated log formatters.
-        """
-        info = {'message': message, 'python_logger': record.name}
-        self.logger.log_struct(info, severity=record.levelname)
diff --git a/google/cloud/logging/logger.py b/google/cloud/logging/logger.py
deleted file mode 100644
index 28c9ae293329..000000000000
--- a/google/cloud/logging/logger.py
+++ /dev/null
@@ -1,453 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Define API Loggers."""
-
-import json
-
-from google.protobuf.json_format import MessageToJson
-
-
-class Logger(object):
-    """Loggers represent named targets for log entries.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs
-
-    :type name: string
-    :param name: the name of the logger
-
-    :type client: :class:`google.cloud.logging.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the logger (which requires a project).
-
-    :type labels: dict or :class:`NoneType`
-    :param labels: (optional) mapping of default labels for entries written
-                   via this logger.
-    """
-    def __init__(self, name, client, labels=None):
-        self.name = name
-        self._client = client
-        self.labels = labels
-
-    @property
-    def client(self):
-        """Clent bound to the logger."""
-        return self._client
-
-    @property
-    def project(self):
-        """Project bound to the logger."""
-        return self._client.project
-
-    @property
-    def full_name(self):
-        """Fully-qualified name used in logging APIs"""
-        return 'projects/%s/logs/%s' % (self.project, self.name)
-
-    @property
-    def path(self):
-        """URI path for use in logging APIs"""
-        return '/%s' % (self.full_name,)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current logger.
-
-        :rtype: :class:`google.cloud.logging.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    def batch(self, client=None):
-        """Return a batch to use as a context manager.
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-
-        :rtype: :class:`Batch`
-        :returns: A batch to use as a context manager.
-        """
-        client = self._require_client(client)
-        return Batch(self, client)
-
-    def _make_entry_resource(self, text=None, info=None, message=None,
-                             labels=None, insert_id=None, severity=None,
-                             http_request=None):
-        """Return a log entry resource of the appropriate type.
-
-        Helper for :meth:`log_text`, :meth:`log_struct`, and :meth:`log_proto`.
-
-        Only one of ``text``, ``info``, or ``message`` should be passed.
-
-        :type text: string or :class:`NoneType`
-        :param text: text payload
-
-        :type info: dict or :class:`NoneType`
-        :param info: struct payload
-
-        :type message: Protobuf message or :class:`NoneType`
-        :param message: protobuf payload
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: labels passed in to calling method.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry
-
-        :rtype: dict
-        :returns: The JSON resource created.
-        """
-        resource = {
-            'logName': self.full_name,
-            'resource': {'type': 'global'},
-        }
-
-        if text is not None:
-            resource['textPayload'] = text
-
-        if info is not None:
-            resource['jsonPayload'] = info
-
-        if message is not None:
-            as_json_str = MessageToJson(message)
-            as_json = json.loads(as_json_str)
-            resource['protoPayload'] = as_json
-
-        if labels is None:
-            labels = self.labels
-
-        if labels is not None:
-            resource['labels'] = labels
-
-        if insert_id is not None:
-            resource['insertId'] = insert_id
-
-        if severity is not None:
-            resource['severity'] = severity
-
-        if http_request is not None:
-            resource['httpRequest'] = http_request
-
-        return resource
-
-    def log_text(self, text, client=None, labels=None, insert_id=None,
-                 severity=None, http_request=None):
-        """API call:  log a text message via a POST request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
-
-        :type text: text
-        :param text: the log message.
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current logger.
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: (optional) mapping of labels for the entry.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry
-        """
-        client = self._require_client(client)
-        entry_resource = self._make_entry_resource(
-            text=text, labels=labels, insert_id=insert_id, severity=severity,
-            http_request=http_request)
-        client.logging_api.write_entries([entry_resource])
-
-    def log_struct(self, info, client=None, labels=None, insert_id=None,
-                   severity=None, http_request=None):
-        """API call:  log a structured message via a POST request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
-
-        :type info: dict
-        :param info: the log entry information
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current logger.
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: (optional) mapping of labels for the entry.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry.
-        """
-        client = self._require_client(client)
-        entry_resource = self._make_entry_resource(
-            info=info, labels=labels, insert_id=insert_id, severity=severity,
-            http_request=http_request)
-        client.logging_api.write_entries([entry_resource])
-
-    def log_proto(self, message, client=None, labels=None, insert_id=None,
-                  severity=None, http_request=None):
-        """API call:  log a protobuf message via a POST request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/write
-
-        :type message: Protobuf message
-        :param message: the message to be logged
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current logger.
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: (optional) mapping of labels for the entry.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry.
-        """
-        client = self._require_client(client)
-        entry_resource = self._make_entry_resource(
-            message=message, labels=labels, insert_id=insert_id,
-            severity=severity, http_request=http_request)
-        client.logging_api.write_entries([entry_resource])
-
-    def delete(self, client=None):
-        """API call:  delete all entries in a logger via a DELETE request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.logs/delete
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current logger.
-        """
-        client = self._require_client(client)
-        client.logging_api.logger_delete(self.project, self.name)
-
-    def list_entries(self, projects=None, filter_=None, order_by=None,
-                     page_size=None, page_token=None):
-        """Return a page of log entries.
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/entries/list
-
-        :type projects: list of strings
-        :param projects: project IDs to include. If not passed,
-                            defaults to the project bound to the client.
-
-        :type filter_: string
-        :param filter_: a filter expression. See:
-                        https://cloud.google.com/logging/docs/view/advanced_filters
-
-        :type order_by: string
-        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
-                         or :data:`~google.cloud.logging.DESCENDING`.
-
-        :type page_size: int
-        :param page_size: maximum number of entries to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of entries. If not
-                           passed, the API will return the first page of
-                           entries.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.logging.entry.TextEntry`, plus a
-                  "next page token" string:  if not None, indicates that
-                  more entries can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        log_filter = 'logName=%s' % (self.full_name,)
-        if filter_ is not None:
-            filter_ = '%s AND %s' % (filter_, log_filter)
-        else:
-            filter_ = log_filter
-        return self.client.list_entries(
-            projects=projects, filter_=filter_, order_by=order_by,
-            page_size=page_size, page_token=page_token)
-
-
-class Batch(object):
-    """Context manager:  collect entries to log via a single API call.
-
-    Helper returned by :meth:`Logger.batch`
-
-    :type logger: :class:`google.cloud.logging.logger.Logger`
-    :param logger: the logger to which entries will be logged.
-
-    :type client: :class:`google.cloud.logging.client.Client`
-    :param client: The client to use.
-    """
-    def __init__(self, logger, client):
-        self.logger = logger
-        self.entries = []
-        self.client = client
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        if exc_type is None:
-            self.commit()
-
-    def log_text(self, text, labels=None, insert_id=None, severity=None,
-                 http_request=None):
-        """Add a text entry to be logged during :meth:`commit`.
-
-        :type text: string
-        :param text: the text entry
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: (optional) mapping of labels for the entry.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry.
-        """
-        self.entries.append(
-            ('text', text, labels, insert_id, severity, http_request))
-
-    def log_struct(self, info, labels=None, insert_id=None, severity=None,
-                   http_request=None):
-        """Add a struct entry to be logged during :meth:`commit`.
-
-        :type info: dict
-        :param info: the struct entry
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: (optional) mapping of labels for the entry.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry.
-        """
-        self.entries.append(
-            ('struct', info, labels, insert_id, severity, http_request))
-
-    def log_proto(self, message, labels=None, insert_id=None, severity=None,
-                  http_request=None):
-        """Add a protobuf entry to be logged during :meth:`commit`.
-
-        :type message: protobuf message
-        :param message: the protobuf entry
-
-        :type labels: dict or :class:`NoneType`
-        :param labels: (optional) mapping of labels for the entry.
-
-        :type insert_id: string or :class:`NoneType`
-        :param insert_id: (optional) unique ID for log entry.
-
-        :type severity: string or :class:`NoneType`
-        :param severity: (optional) severity of event being logged.
-
-        :type http_request: dict or :class:`NoneType`
-        :param http_request: (optional) info about HTTP request associated with
-                             the entry.
-        """
-        self.entries.append(
-            ('proto', message, labels, insert_id, severity, http_request))
-
-    def commit(self, client=None):
-        """Send saved log entries as a single API call.
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current batch.
-        """
-        if client is None:
-            client = self.client
-
-        kwargs = {
-            'logger_name': self.logger.full_name,
-            'resource': {'type': 'global'},
-        }
-        if self.logger.labels is not None:
-            kwargs['labels'] = self.logger.labels
-
-        entries = []
-        for entry_type, entry, labels, iid, severity, http_req in self.entries:
-            if entry_type == 'text':
-                info = {'textPayload': entry}
-            elif entry_type == 'struct':
-                info = {'jsonPayload': entry}
-            elif entry_type == 'proto':
-                as_json_str = MessageToJson(entry)
-                as_json = json.loads(as_json_str)
-                info = {'protoPayload': as_json}
-            else:
-                raise ValueError('Unknown entry type: %s' % (entry_type,))
-            if labels is not None:
-                info['labels'] = labels
-            if iid is not None:
-                info['insertId'] = iid
-            if severity is not None:
-                info['severity'] = severity
-            if http_req is not None:
-                info['httpRequest'] = http_req
-            entries.append(info)
-
-        client.logging_api.write_entries(entries, **kwargs)
-        del self.entries[:]
diff --git a/google/cloud/logging/metric.py b/google/cloud/logging/metric.py
deleted file mode 100644
index 91a2b1c09af9..000000000000
--- a/google/cloud/logging/metric.py
+++ /dev/null
@@ -1,183 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Define Stackdriver Logging API Metrics."""
-
-from google.cloud.exceptions import NotFound
-
-
-class Metric(object):
-    """Metrics represent named filters for log entries.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics
-
-    :type name: string
-    :param name: the name of the metric
-
-    :type filter_: string
-    :param filter_: the advanced logs filter expression defining the entries
-                   tracked by the metric.  If not passed, the instance should
-                   already exist, to be refreshed via :meth:`reload`.
-
-    :type client: :class:`google.cloud.logging.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the metric (which requires a project).
-
-    :type description: string
-    :param description: an optional description of the metric.
-    """
-    def __init__(self, name, filter_=None, client=None, description=''):
-        self.name = name
-        self._client = client
-        self.filter_ = filter_
-        self.description = description
-
-    @property
-    def client(self):
-        """Clent bound to the logger."""
-        return self._client
-
-    @property
-    def project(self):
-        """Project bound to the logger."""
-        return self._client.project
-
-    @property
-    def full_name(self):
-        """Fully-qualified name used in metric APIs"""
-        return 'projects/%s/metrics/%s' % (self.project, self.name)
-
-    @property
-    def path(self):
-        """URL path for the metric's APIs"""
-        return '/%s' % (self.full_name,)
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a metric given its API representation
-
-        :type resource: dict
-        :param resource: metric resource representation returned from the API
-
-        :type client: :class:`google.cloud.logging.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the metric.
-
-        :rtype: :class:`google.cloud.logging.metric.Metric`
-        :returns: Metric parsed from ``resource``.
-        """
-        metric_name = resource['name']
-        filter_ = resource['filter']
-        description = resource.get('description', '')
-        return cls(metric_name, filter_, client=client,
-                   description=description)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current metric.
-
-        :rtype: :class:`google.cloud.logging.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    def create(self, client=None):
-        """API call:  create the metric via a PUT request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/create
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current metric.
-        """
-        client = self._require_client(client)
-        client.metrics_api.metric_create(
-            self.project, self.name, self.filter_, self.description)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the metric via a GET request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current metric.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the metric.
-        """
-        client = self._require_client(client)
-
-        try:
-            client.metrics_api.metric_get(self.project, self.name)
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  sync local metric configuration via a GET request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/get
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current metric.
-        """
-        client = self._require_client(client)
-        data = client.metrics_api.metric_get(self.project, self.name)
-        self.description = data.get('description', '')
-        self.filter_ = data['filter']
-
-    def update(self, client=None):
-        """API call:  update metric configuration via a PUT request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/update
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current metric.
-        """
-        client = self._require_client(client)
-        client.metrics_api.metric_update(
-            self.project, self.name, self.filter_, self.description)
-
-    def delete(self, client=None):
-        """API call:  delete a metric via a DELETE request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.metrics/delete
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current metric.
-        """
-        client = self._require_client(client)
-        client.metrics_api.metric_delete(self.project, self.name)
diff --git a/google/cloud/logging/sink.py b/google/cloud/logging/sink.py
deleted file mode 100644
index 169793bbd455..000000000000
--- a/google/cloud/logging/sink.py
+++ /dev/null
@@ -1,187 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Define Stackdriver Logging API Sinks."""
-
-from google.cloud.exceptions import NotFound
-
-
-class Sink(object):
-    """Sinks represent filtered exports for log entries.
-
-    See:
-    https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks
-
-    :type name: string
-    :param name: the name of the sink
-
-    :type filter_: string
-    :param filter_: the advanced logs filter expression defining the entries
-                    exported by the sink.  If not passed, the instance should
-                    already exist, to be refreshed via :meth:`reload`.
-
-    :type destination: string
-    :param destination: destination URI for the entries exported by the sink.
-                        If not passed, the instance should already exist, to
-                        be refreshed via :meth:`reload`.
-
-    :type client: :class:`google.cloud.logging.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the sink (which requires a project).
-    """
-    def __init__(self, name, filter_=None, destination=None, client=None):
-        self.name = name
-        self.filter_ = filter_
-        self.destination = destination
-        self._client = client
-
-    @property
-    def client(self):
-        """Clent bound to the sink."""
-        return self._client
-
-    @property
-    def project(self):
-        """Project bound to the sink."""
-        return self._client.project
-
-    @property
-    def full_name(self):
-        """Fully-qualified name used in sink APIs"""
-        return 'projects/%s/sinks/%s' % (self.project, self.name)
-
-    @property
-    def path(self):
-        """URL path for the sink's APIs"""
-        return '/%s' % (self.full_name)
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a sink given its API representation
-
-        :type resource: dict
-        :param resource: sink resource representation returned from the API
-
-        :type client: :class:`google.cloud.logging.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the sink.
-
-        :rtype: :class:`google.cloud.logging.sink.Sink`
-        :returns: Sink parsed from ``resource``.
-        :raises: :class:`ValueError` if ``client`` is not ``None`` and the
-                 project from the resource does not agree with the project
-                 from the client.
-        """
-        sink_name = resource['name']
-        filter_ = resource['filter']
-        destination = resource['destination']
-        return cls(sink_name, filter_, destination, client=client)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current sink.
-
-        :rtype: :class:`google.cloud.logging.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    def create(self, client=None):
-        """API call:  create the sink via a PUT request
-
-        See:
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/create
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current sink.
-        """
-        client = self._require_client(client)
-        client.sinks_api.sink_create(
-            self.project, self.name, self.filter_, self.destination)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the sink via a GET request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/get
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current sink.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the sink.
-        """
-        client = self._require_client(client)
-
-        try:
-            client.sinks_api.sink_get(self.project, self.name)
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  sync local sink configuration via a GET request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/get
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current sink.
-        """
-        client = self._require_client(client)
-        data = client.sinks_api.sink_get(self.project, self.name)
-        self.filter_ = data['filter']
-        self.destination = data['destination']
-
-    def update(self, client=None):
-        """API call:  update sink configuration via a PUT request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/update
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current sink.
-        """
-        client = self._require_client(client)
-        client.sinks_api.sink_update(
-            self.project, self.name, self.filter_, self.destination)
-
-    def delete(self, client=None):
-        """API call:  delete a sink via a DELETE request
-
-        See
-        https://cloud.google.com/logging/docs/api/ref_v2beta1/rest/v2beta1/projects.sinks/delete
-
-        :type client: :class:`~google.cloud.logging.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current sink.
-        """
-        client = self._require_client(client)
-        client.sinks_api.sink_delete(self.project, self.name)
diff --git a/google/cloud/monitoring/__init__.py b/google/cloud/monitoring/__init__.py
deleted file mode 100644
index 367cb1d5e87b..000000000000
--- a/google/cloud/monitoring/__init__.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Google Stackdriver Monitoring API wrapper."""
-
-from google.cloud.monitoring.client import Client
-from google.cloud.monitoring.connection import Connection
-from google.cloud.monitoring.group import Group
-from google.cloud.monitoring.label import LabelDescriptor
-from google.cloud.monitoring.label import LabelValueType
-from google.cloud.monitoring.metric import Metric
-from google.cloud.monitoring.metric import MetricDescriptor
-from google.cloud.monitoring.metric import MetricKind
-from google.cloud.monitoring.metric import ValueType
-from google.cloud.monitoring.query import Aligner
-from google.cloud.monitoring.query import Query
-from google.cloud.monitoring.query import Reducer
-from google.cloud.monitoring.resource import Resource
-from google.cloud.monitoring.resource import ResourceDescriptor
-from google.cloud.monitoring.timeseries import Point
-from google.cloud.monitoring.timeseries import TimeSeries
-
-__all__ = (
-    'Client',
-    'Connection',
-    'Group',
-    'LabelDescriptor', 'LabelValueType',
-    'Metric', 'MetricDescriptor', 'MetricKind', 'ValueType',
-    'Aligner', 'Query', 'Reducer',
-    'Resource', 'ResourceDescriptor',
-    'Point', 'TimeSeries',
-    'SCOPE',
-)
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/monitoring/_dataframe.py b/google/cloud/monitoring/_dataframe.py
deleted file mode 100644
index 6a0d933935e5..000000000000
--- a/google/cloud/monitoring/_dataframe.py
+++ /dev/null
@@ -1,116 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Time series as :mod:`pandas` dataframes."""
-
-import itertools
-
-TOP_RESOURCE_LABELS = (
-    'project_id',
-    'aws_account',
-    'location',
-    'region',
-    'zone',
-)
-
-
-def _build_dataframe(time_series_iterable,
-                     label=None, labels=None):  # pragma: NO COVER
-    """Build a :mod:`pandas` dataframe out of time series.
-
-    :type time_series_iterable:
-        iterable over :class:`~google.cloud.monitoring.timeseries.TimeSeries`
-    :param time_series_iterable:
-        An iterable (e.g., a query object) yielding time series.
-
-    :type label: string or None
-    :param label:
-        The label name to use for the dataframe header. This can be the name
-        of a resource label or metric label (e.g., ``"instance_name"``), or
-        the string ``"resource_type"``.
-
-    :type labels: list of strings, or None
-    :param labels:
-        A list or tuple of label names to use for the dataframe header.
-        If more than one label name is provided, the resulting dataframe
-        will have a multi-level column header.
-
-        Specifying neither ``label`` or ``labels`` results in a dataframe
-        with a multi-level column header including the resource type and
-        all available resource and metric labels.
-
-        Specifying both ``label`` and ``labels`` is an error.
-
-    :rtype: :class:`pandas.DataFrame`
-    :returns: A dataframe where each column represents one time series.
-    """
-    import pandas   # pylint: disable=import-error
-
-    if labels is not None:
-        if label is not None:
-            raise ValueError('Cannot specify both "label" and "labels".')
-        elif not labels:
-            raise ValueError('"labels" must be non-empty or None.')
-
-    columns = []
-    headers = []
-    for time_series in time_series_iterable:
-        pandas_series = pandas.Series(
-            data=[point.value for point in time_series.points],
-            index=[point.end_time for point in time_series.points],
-        )
-        columns.append(pandas_series)
-        headers.append(time_series.header())
-
-    # Implement a smart default of using all available labels.
-    if label is None and labels is None:
-        resource_labels = set(itertools.chain.from_iterable(
-            header.resource.labels for header in headers))
-        metric_labels = set(itertools.chain.from_iterable(
-            header.metric.labels for header in headers))
-        labels = (['resource_type'] +
-                  _sorted_resource_labels(resource_labels) +
-                  sorted(metric_labels))
-
-    # Assemble the columns into a DataFrame.
-    dataframe = pandas.DataFrame.from_records(columns).T
-
-    # Convert the timestamp strings into a DatetimeIndex.
-    dataframe.index = pandas.to_datetime(dataframe.index)
-
-    # Build a multi-level stack of column headers. Some labels may
-    # be undefined for some time series.
-    levels = []
-    for key in labels or [label]:
-        level = [header.labels.get(key, '') for header in headers]
-        levels.append(level)
-
-    # Build a column Index or MultiIndex. Do not include level names
-    # in the column header if the user requested a single-level header
-    # by specifying "label".
-    dataframe.columns = pandas.MultiIndex.from_arrays(
-        levels,
-        names=labels or None)
-
-    # Sort the rows just in case (since the API doesn't guarantee the
-    # ordering), and sort the columns lexicographically.
-    return dataframe.sort_index(axis=0).sort_index(axis=1)
-
-
-def _sorted_resource_labels(labels):
-    """Sort label names, putting well-known resource labels first."""
-    head = [label for label in TOP_RESOURCE_LABELS if label in labels]
-    tail = sorted(label for label in labels
-                  if label not in TOP_RESOURCE_LABELS)
-    return head + tail
diff --git a/google/cloud/monitoring/client.py b/google/cloud/monitoring/client.py
deleted file mode 100644
index 4c6d33ad02e0..000000000000
--- a/google/cloud/monitoring/client.py
+++ /dev/null
@@ -1,586 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client for interacting with the `Google Stackdriver Monitoring API (V3)`_.
-
-Example::
-
-    >>> from google.cloud import monitoring
-    >>> client = monitoring.Client()
-    >>> query = client.query(minutes=5)
-    >>> print(query.as_dataframe())  # Requires pandas.
-
-At present, the client supports querying of time series, metric descriptors,
-and monitored resource descriptors.
-
-.. _Google Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/v3/
-"""
-
-import datetime
-
-from google.cloud._helpers import _datetime_to_rfc3339
-from google.cloud.client import JSONClient
-from google.cloud.monitoring.connection import Connection
-from google.cloud.monitoring.group import Group
-from google.cloud.monitoring.metric import Metric
-from google.cloud.monitoring.metric import MetricDescriptor
-from google.cloud.monitoring.metric import MetricKind
-from google.cloud.monitoring.metric import ValueType
-from google.cloud.monitoring.query import Query
-from google.cloud.monitoring.resource import Resource
-from google.cloud.monitoring.resource import ResourceDescriptor
-from google.cloud.monitoring.timeseries import Point
-from google.cloud.monitoring.timeseries import TimeSeries
-
-_UTCNOW = datetime.datetime.utcnow  # To be replaced by tests.
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: string
-    :param project: The target project. If not passed, falls back to the
-                    default inferred from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def query(self,
-              metric_type=Query.DEFAULT_METRIC_TYPE,
-              end_time=None,
-              days=0, hours=0, minutes=0):
-        """Construct a query object for retrieving metric data.
-
-        Example::
-
-            >>> query = client.query(minutes=5)
-            >>> print(query.as_dataframe())  # Requires pandas.
-
-        :type metric_type: string
-        :param metric_type: The metric type name. The default value is
-            :data:`Query.DEFAULT_METRIC_TYPE
-            <google.cloud.monitoring.query.Query.DEFAULT_METRIC_TYPE>`,
-            but please note that this default value is provided only for
-            demonstration purposes and is subject to change. See the
-            `supported metrics`_.
-
-        :type end_time: :class:`datetime.datetime` or None
-        :param end_time: The end time (inclusive) of the time interval
-            for which results should be returned, as a datetime object.
-            The default is the start of the current minute.
-
-            The start time (exclusive) is determined by combining the
-            values of  ``days``, ``hours``, and ``minutes``, and
-            subtracting the resulting duration from the end time.
-
-            It is also allowed to omit the end time and duration here,
-            in which case
-            :meth:`~google.cloud.monitoring.query.Query.select_interval`
-            must be called before the query is executed.
-
-        :type days: integer
-        :param days: The number of days in the time interval.
-
-        :type hours: integer
-        :param hours: The number of hours in the time interval.
-
-        :type minutes: integer
-        :param minutes: The number of minutes in the time interval.
-
-        :rtype: :class:`~google.cloud.monitoring.query.Query`
-        :returns: The query object.
-
-        :raises: :exc:`ValueError` if ``end_time`` is specified but
-            ``days``, ``hours``, and ``minutes`` are all zero.
-            If you really want to specify a point in time, use
-            :meth:`~google.cloud.monitoring.query.Query.select_interval`.
-
-        .. _supported metrics: https://cloud.google.com/monitoring/api/metrics
-        """
-        return Query(self, metric_type,
-                     end_time=end_time,
-                     days=days, hours=hours, minutes=minutes)
-
-    def metric_descriptor(self, type_,
-                          metric_kind=MetricKind.METRIC_KIND_UNSPECIFIED,
-                          value_type=ValueType.VALUE_TYPE_UNSPECIFIED,
-                          labels=(), unit='', description='', display_name=''):
-        """Construct a metric descriptor object.
-
-        Metric descriptors specify the schema for a particular metric type.
-
-        This factory method is used most often in conjunction with the metric
-        descriptor
-        :meth:`~google.cloud.monitoring.metric.MetricDescriptor.create`
-        method to define custom metrics::
-
-            >>> descriptor = client.metric_descriptor(
-            ...     'custom.googleapis.com/my_metric',
-            ...     metric_kind=MetricKind.GAUGE,
-            ...     value_type=ValueType.DOUBLE,
-            ...     description='This is a simple example of a custom metric.')
-            >>> descriptor.create()
-
-        Here is an example where the custom metric is parameterized by a
-        metric label::
-
-            >>> label = LabelDescriptor('response_code', LabelValueType.INT64,
-            ...                         description='HTTP status code')
-            >>> descriptor = client.metric_descriptor(
-            ...     'custom.googleapis.com/my_app/response_count',
-            ...     metric_kind=MetricKind.CUMULATIVE,
-            ...     value_type=ValueType.INT64,
-            ...     labels=[label],
-            ...     description='Cumulative count of HTTP responses.')
-            >>> descriptor.create()
-
-        :type type_: string
-        :param type_:
-            The metric type including a DNS name prefix. For example:
-            ``"custom.googleapis.com/my_metric"``
-
-        :type metric_kind: string
-        :param metric_kind:
-            The kind of measurement. It must be one of
-            :data:`MetricKind.GAUGE`, :data:`MetricKind.DELTA`,
-            or :data:`MetricKind.CUMULATIVE`.
-            See :class:`~google.cloud.monitoring.metric.MetricKind`.
-
-        :type value_type: string
-        :param value_type:
-            The value type of the metric. It must be one of
-            :data:`ValueType.BOOL`, :data:`ValueType.INT64`,
-            :data:`ValueType.DOUBLE`, :data:`ValueType.STRING`,
-            or :data:`ValueType.DISTRIBUTION`.
-            See :class:`ValueType`.
-
-        :type labels:
-            list of :class:`~google.cloud.monitoring.label.LabelDescriptor`
-        :param labels:
-            A sequence of zero or more label descriptors specifying the labels
-            used to identify a specific instance of this metric.
-
-        :type unit: string
-        :param unit: An optional unit in which the metric value is reported.
-
-        :type description: string
-        :param description: An optional detailed description of the metric.
-
-        :type display_name: string
-        :param display_name: An optional concise name for the metric.
-
-        :rtype: :class:`MetricDescriptor`
-        :returns: The metric descriptor created with the passed-in arguments.
-        """
-        return MetricDescriptor(
-            self, type_,
-            metric_kind=metric_kind,
-            value_type=value_type,
-            labels=labels,
-            unit=unit,
-            description=description,
-            display_name=display_name,
-        )
-
-    @staticmethod
-    def metric(type_, labels):
-        """Factory for constructing metric objects.
-
-        :class:`~google.cloud.monitoring.metric.Metric` objects are typically
-        created to write custom metric values. The type should match the
-        metric type specified in the
-        :class:`~google.cloud.monitoring.metric.MetricDescriptor` used to
-        create the custom metric::
-
-             >>> metric = client.metric('custom.googleapis.com/my_metric',
-             ...                        labels={
-             ...                            'status': 'successful',
-             ...                         })
-
-        :type type_: string
-        :param type_: The metric type name.
-
-        :type labels: dict
-        :param labels: A mapping from label names to values for all labels
-                       enumerated in the associated
-                       :class:`~google.cloud.monitoring.metric.MetricDescriptor`.
-
-        :rtype: :class:`~google.cloud.monitoring.metric.Metric`
-        :returns: The metric object.
-        """
-        return Metric(type=type_, labels=labels)
-
-    @staticmethod
-    def resource(type_, labels):
-        """Factory for constructing monitored resource objects.
-
-        A monitored resource object (
-        :class:`~google.cloud.monitoring.resource.Resource`) is
-        typically used to create a
-        :class:`~google.cloud.monitoring.timeseries.TimeSeries` object.
-
-        For a list of possible monitored resource types and their associated
-        labels, see:
-
-        https://cloud.google.com/monitoring/api/resources
-
-        :type type_: string
-        :param type_: The monitored resource type name.
-
-        :type labels: dict
-        :param labels: A mapping from label names to values for all labels
-                       enumerated in the associated
-                       :class:`~google.cloud.monitoring.resource.ResourceDescriptor`,
-                       except that ``project_id`` can and should be omitted
-                       when writing time series data.
-
-        :rtype: :class:`~google.cloud.monitoring.resource.Resource`
-        :returns: A monitored resource object.
-        """
-        return Resource(type_, labels)
-
-    @staticmethod
-    def time_series(metric, resource, value,
-                    end_time=None, start_time=None):
-        """Construct a time series object for a single data point.
-
-        .. note::
-
-           While :class:`~google.cloud.monitoring.timeseries.TimeSeries`
-           objects returned by the API typically have multiple data points,
-           :class:`~google.cloud.monitoring.timeseries.TimeSeries` objects
-           sent to the API must have at most one point.
-
-        For example::
-
-            >>> timeseries = client.time_series(metric, resource, 1.23,
-            ...                                 end_time=end)
-
-        For more information, see:
-
-        https://cloud.google.com/monitoring/api/ref_v3/rest/v3/TimeSeries
-
-        :type metric: :class:`~google.cloud.monitoring.metric.Metric`
-        :param metric: A :class:`~google.cloud.monitoring.metric.Metric`.
-
-        :type resource: :class:`~google.cloud.monitoring.resource.Resource`
-        :param resource: A :class:`~google.cloud.monitoring.resource.Resource`
-                         object.
-
-        :type value: bool, int, string, or float
-        :param value:
-            The value of the data point to create for the
-            :class:`~google.cloud.monitoring.timeseries.TimeSeries`.
-
-            .. note::
-
-               The Python type of the value will determine the
-               :class:`~ValueType` sent to the API, which must match the value
-               type specified in the metric descriptor. For example, a Python
-               float will be sent to the API as a :data:`ValueType.DOUBLE`.
-
-        :type end_time: :class:`~datetime.datetime`
-        :param end_time:
-            The end time for the point to be included in the time series.
-            Assumed to be UTC if no time zone information is present.
-            Defaults to the current time, as obtained by calling
-            :meth:`datetime.datetime.utcnow`.
-
-        :type start_time: :class:`~datetime.datetime`
-        :param start_time:
-            The start time for the point to be included in the time series.
-            Assumed to be UTC if no time zone information is present.
-            Defaults to None. If the start time is unspecified,
-            the API interprets the start time to be the same as the end time.
-
-        :rtype: :class:`~google.cloud.monitoring.timeseries.TimeSeries`
-        :returns: A time series object.
-        """
-        if end_time is None:
-            end_time = _UTCNOW()
-
-        end_time = _datetime_to_rfc3339(end_time, ignore_zone=False)
-        if start_time:
-            start_time = _datetime_to_rfc3339(start_time, ignore_zone=False)
-
-        point = Point(value=value, start_time=start_time, end_time=end_time)
-        return TimeSeries(metric=metric, resource=resource, metric_kind=None,
-                          value_type=None, points=[point])
-
-    def fetch_metric_descriptor(self, metric_type):
-        """Look up a metric descriptor by type.
-
-        Example::
-
-            >>> METRIC = 'compute.googleapis.com/instance/cpu/utilization'
-            >>> print(client.fetch_metric_descriptor(METRIC))
-
-        :type metric_type: string
-        :param metric_type: The metric type name.
-
-        :rtype: :class:`~google.cloud.monitoring.metric.MetricDescriptor`
-        :returns: The metric descriptor instance.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` if the metric
-                 descriptor is not found.
-        """
-        return MetricDescriptor._fetch(self, metric_type)
-
-    def list_metric_descriptors(self, filter_string=None, type_prefix=None):
-        """List all metric descriptors for the project.
-
-        Examples::
-
-            >>> for descriptor in client.list_metric_descriptors():
-            ...     print(descriptor.type)
-
-            >>> for descriptor in client.list_metric_descriptors(
-            ...         type_prefix='custom.'):
-            ...     print(descriptor.type)
-
-        :type filter_string: string or None
-        :param filter_string:
-            An optional filter expression describing the metric descriptors
-            to be returned. See the `filter documentation`_.
-
-        :type type_prefix: string or None
-        :param type_prefix: An optional prefix constraining the selected
-            metric types. This adds ``metric.type = starts_with("<prefix>")``
-            to the filter.
-
-        :rtype:
-            list of :class:`~google.cloud.monitoring.metric.MetricDescriptor`
-        :returns: A list of metric descriptor instances.
-
-        .. _filter documentation:
-            https://cloud.google.com/monitoring/api/v3/filters
-        """
-        return MetricDescriptor._list(self, filter_string,
-                                      type_prefix=type_prefix)
-
-    def fetch_resource_descriptor(self, resource_type):
-        """Look up a monitored resource descriptor by type.
-
-        Example::
-
-            >>> print(client.fetch_resource_descriptor('gce_instance'))
-
-        :type resource_type: string
-        :param resource_type: The resource type name.
-
-        :rtype: :class:`~google.cloud.monitoring.resource.ResourceDescriptor`
-        :returns: The resource descriptor instance.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` if the resource
-                 descriptor is not found.
-        """
-        return ResourceDescriptor._fetch(self, resource_type)
-
-    def list_resource_descriptors(self, filter_string=None):
-        """List all monitored resource descriptors for the project.
-
-        Example::
-
-            >>> for descriptor in client.list_resource_descriptors():
-            ...     print(descriptor.type)
-
-        :type filter_string: string or None
-        :param filter_string:
-            An optional filter expression describing the resource descriptors
-            to be returned. See the `filter documentation`_.
-
-        :rtype: list of
-                :class:`~google.cloud.monitoring.resource.ResourceDescriptor`
-        :returns: A list of resource descriptor instances.
-
-        .. _filter documentation:
-            https://cloud.google.com/monitoring/api/v3/filters
-        """
-        return ResourceDescriptor._list(self, filter_string)
-
-    def group(self, group_id=None, display_name=None, parent_id=None,
-              filter_string=None, is_cluster=False):
-        """Factory constructor for group object.
-
-        .. note::
-          This will not make an HTTP request; it simply instantiates
-          a group object owned by this client.
-
-        :type group_id: string or None
-        :param group_id: The ID of the group.
-
-        :type display_name: string or None
-        :param display_name:
-            A user-assigned name for this group, used only for display
-            purposes.
-
-        :type parent_id: string or None
-        :param parent_id:
-            The ID of the group's parent, if it has one.
-
-        :type filter_string: string or None
-        :param filter_string:
-            The filter string used to determine which monitored resources
-            belong to this group.
-
-        :type is_cluster: boolean
-        :param is_cluster:
-            If true, the members of this group are considered to be a cluster.
-            The system can perform additional analysis on groups that are
-            clusters.
-
-        :rtype: :class:`Group`
-        :returns: The group created with the passed-in arguments.
-
-        :raises:
-            :exc:`ValueError` if both ``group_id`` and ``name`` are specified.
-        """
-        return Group(
-            self,
-            group_id=group_id,
-            display_name=display_name,
-            parent_id=parent_id,
-            filter_string=filter_string,
-            is_cluster=is_cluster,
-        )
-
-    def fetch_group(self, group_id):
-        """Fetch a group from the API based on it's ID.
-
-        Example::
-
-            >>> try:
-            >>>     group = client.fetch_group('1234')
-            >>> except google.cloud.exceptions.NotFound:
-            >>>     print('That group does not exist!')
-
-        :type group_id: string
-        :param group_id: The ID of the group.
-
-        :rtype: :class:`~google.cloud.monitoring.group.Group`
-        :returns: The group instance.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` if the group
-                 is not found.
-        """
-        return Group._fetch(self, group_id)
-
-    def list_groups(self):
-        """List all groups for the project.
-
-        Example::
-
-            >>> for group in client.list_groups():
-            ...     print((group.display_name, group.name))
-
-        :rtype: list of :class:`~google.cloud.monitoring.group.Group`
-        :returns: A list of group instances.
-        """
-        return Group._list(self)
-
-    def write_time_series(self, timeseries_list):
-        """Write a list of time series objects to the API.
-
-        The recommended approach to creating time series objects is using
-        the :meth:`~google.cloud.monitoring.client.Client.time_series` factory
-        method.
-
-        Example::
-
-            >>> client.write_time_series([ts1, ts2])
-
-        If you only need to write a single time series object, consider using
-        the :meth:`~google.cloud.monitoring.client.Client.write_point` method
-        instead.
-
-        :type timeseries_list:
-            list of :class:`~google.cloud.monitoring.timeseries.TimeSeries`
-        :param timeseries_list:
-            A list of time series object to be written
-            to the API. Each time series must contain exactly one point.
-        """
-        path = '/projects/{project}/timeSeries/'.format(
-            project=self.project)
-        timeseries_dict = [timeseries._to_dict()
-                           for timeseries in timeseries_list]
-        self.connection.api_request(method='POST', path=path,
-                                    data={'timeSeries': timeseries_dict})
-
-    def write_point(self, metric, resource, value,
-                    end_time=None,
-                    start_time=None):
-        """Write a single point for a metric to the API.
-
-        This is a convenience method to write a single time series object to
-        the API. To write multiple time series objects to the API as a batch
-        operation, use the
-        :meth:`~google.cloud.monitoring.client.Client.time_series`
-        factory method to create time series objects and the
-        :meth:`~google.cloud.monitoring.client.Client.write_time_series`
-        method to write the objects.
-
-        Example::
-
-            >>> client.write_point(metric, resource, 3.14)
-
-        :type metric: :class:`~google.cloud.monitoring.metric.Metric`
-        :param metric: A :class:`~google.cloud.monitoring.metric.Metric`
-                       object.
-
-        :type resource: :class:`~google.cloud.monitoring.resource.Resource`
-        :param resource: A :class:`~google.cloud.monitoring.resource.Resource`
-                         object.
-
-        :type value: bool, int, string, or float
-        :param value:
-            The value of the data point to create for the
-            :class:`~google.cloud.monitoring.timeseries.TimeSeries`.
-
-            .. note::
-
-               The Python type of the value will determine the
-               :class:`~ValueType` sent to the API, which must match the value
-               type specified in the metric descriptor. For example, a Python
-               float will be sent to the API as a :data:`ValueType.DOUBLE`.
-
-        :type end_time: :class:`~datetime.datetime`
-        :param end_time:
-            The end time for the point to be included in the time series.
-            Assumed to be UTC if no time zone information is present.
-            Defaults to the current time, as obtained by calling
-            :meth:`datetime.datetime.utcnow`.
-
-        :type start_time: :class:`~datetime.datetime`
-        :param start_time:
-            The start time for the point to be included in the time series.
-            Assumed to be UTC if no time zone information is present.
-            Defaults to None. If the start time is unspecified,
-            the API interprets the start time to be the same as the end time.
-        """
-        timeseries = self.time_series(
-            metric, resource, value, end_time, start_time)
-        self.write_time_series([timeseries])
diff --git a/google/cloud/monitoring/connection.py b/google/cloud/monitoring/connection.py
deleted file mode 100644
index 35693f8d5f1e..000000000000
--- a/google/cloud/monitoring/connection.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Create / interact with Stackdriver Monitoring connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Stackdriver Monitoring via the JSON REST API.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``
-    :param http: (Optional) HTTP object to make requests.
-
-    :type api_base_url: string
-    :param api_base_url: The base of the API call URL. Defaults to the value
-                         :attr:`Connection.API_BASE_URL`.
-    """
-
-    API_BASE_URL = 'https://monitoring.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v3'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/monitoring.read',
-             'https://www.googleapis.com/auth/monitoring',
-             'https://www.googleapis.com/auth/cloud-platform')
-    """The scopes required for authenticating as a Monitoring consumer."""
diff --git a/google/cloud/monitoring/group.py b/google/cloud/monitoring/group.py
deleted file mode 100644
index c43f4d761388..000000000000
--- a/google/cloud/monitoring/group.py
+++ /dev/null
@@ -1,496 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Groups for the `Google Stackdriver Monitoring API (V3)`_.
-
-.. _Google Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.groups
-"""
-
-import re
-
-from google.cloud._helpers import _datetime_to_rfc3339
-from google.cloud._helpers import _name_from_project_path
-from google.cloud.exceptions import NotFound
-from google.cloud.monitoring.resource import Resource
-
-
-_GROUP_TEMPLATE = re.compile(r"""
-    projects/            # static prefix
-    (?P<project>[^/]+)   # initial letter, wordchars + hyphen
-    /groups/             # static midfix
-    (?P<name>[^/]+)      # initial letter, wordchars + allowed punc
-""", re.VERBOSE)
-
-
-def _group_id_from_name(path, project=None):
-    """Validate a group URI path and get the group ID.
-
-    :type path: string
-    :param path: URI path for a group API request.
-
-    :type project: string or None
-    :param project: The project associated with the request. It is
-                    included for validation purposes.
-
-    :rtype: string
-    :returns: Group ID parsed from ``path``.
-    :raises: :class:`ValueError` if the ``path`` is ill-formed or if
-             the project from the ``path`` does not agree with the
-             ``project`` passed in.
-    """
-    return _name_from_project_path(path, project, _GROUP_TEMPLATE)
-
-
-def _group_name_from_id(project, group_id):
-    """Build the group name given the project and group ID.
-
-    :type project: string
-    :param project: The project associated with the group.
-
-    :type group_id: string
-    :param group_id: The group ID.
-
-    :rtype: string
-    :returns: The fully qualified name of the group.
-    """
-    return 'projects/{project}/groups/{group_id}'.format(
-        project=project, group_id=group_id)
-
-
-class Group(object):
-    """A dynamic collection of monitored resources.
-
-    :type client: :class:`google.cloud.monitoring.client.Client`
-    :param client: A client for operating on the metric descriptor.
-
-    :type group_id: string or None
-    :param group_id: The ID of the group.
-
-    :type display_name: string or None
-    :param display_name:
-        A user-assigned name for this group, used only for display purposes.
-
-    :type parent_id: string or None
-    :param parent_id:
-        The ID of the group's parent, if it has one.
-
-    :type filter_string: string or None
-    :param filter_string:
-        The filter string used to determine which monitored resources belong to
-        this group.
-
-    :type is_cluster: boolean
-    :param is_cluster:
-        If true, the members of this group are considered to be a cluster. The
-        system can perform additional analysis on groups that are clusters.
-    """
-    def __init__(self, client, group_id=None, display_name=None,
-                 parent_id=None, filter_string=None, is_cluster=False):
-        self.client = client
-        self._id = group_id
-        self.display_name = display_name
-        self.parent_id = parent_id
-        self.filter = filter_string
-        self.is_cluster = is_cluster
-
-        if group_id:
-            self._name = _group_name_from_id(client.project, group_id)
-        else:
-            self._name = None
-
-    @property
-    def id(self):
-        """Returns the group ID.
-
-        :rtype: str or None
-        :returns: the ID of the group based on it's name.
-        """
-        return self._id
-
-    @property
-    def name(self):
-        """Returns the fully qualified name of the group.
-
-        :rtype: str or None
-        :returns:
-            The fully qualified name of the group in the format
-            "projects/<project>/groups/<id>".
-        """
-        return self._name
-
-    @property
-    def parent_name(self):
-        """Returns the fully qualified name of the parent group.
-
-        :rtype: str or None
-        :returns:
-            The fully qualified name of the parent group.
-        """
-        if not self.parent_id:
-            return None
-        return _group_name_from_id(self.client.project, self.parent_id)
-
-    @property
-    def path(self):
-        """URL path to this group.
-
-        :rtype: str
-        :returns: the path based on project and group name.
-
-        :raises: :exc:`ValueError` if :attr:`name` is not specified.
-        """
-        if not self.id:
-            raise ValueError('Cannot determine path without group ID.')
-        return '/' + self.name
-
-    def create(self):
-        """Create a new group based on this object via a ``POST`` request.
-
-        Example::
-
-            >>> filter_string = 'resource.type = "gce_instance"'
-            >>> group = client.group(
-            ...     display_name='My group',
-            ...     filter_string=filter_string,
-            ...     parent_id='5678',
-            ...     is_cluster=True)
-            >>> group.create()
-
-        The ``name`` attribute is ignored in preparing the creation request.
-        All attributes are overwritten by the values received in the response
-        (normally affecting only ``name``).
-        """
-        path = '/projects/%s/groups/' % (self.client.project,)
-        info = self.client.connection.api_request(
-            method='POST', path=path, data=self._to_dict())
-        self._set_properties_from_dict(info)
-
-    def exists(self):
-        """Test for the existence of the group via a ``GET`` request.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the group.
-        """
-        try:
-            self.client.connection.api_request(
-                method='GET', path=self.path, query_params={'fields': 'name'})
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self):
-        """Sync local group information via a ``GET`` request.
-
-        .. warning::
-
-            This will overwrite any local changes you've made and not saved
-            via :meth:`update`.
-        """
-        info = self.client.connection.api_request(method='GET', path=self.path)
-        self._set_properties_from_dict(info)
-
-    def update(self):
-        """Update the group via a ``PUT`` request."""
-        info = self.client.connection.api_request(
-            method='PUT', path=self.path, data=self._to_dict())
-        self._set_properties_from_dict(info)
-
-    def delete(self):
-        """Delete the group via a ``DELETE`` request.
-
-        Example::
-
-            >>> group = client.group('1234')
-            >>> group.delete()
-
-        Only the ``client`` and ``name`` attributes are used.
-
-        .. warning::
-
-            This method will fail for groups that have one or more children
-            groups.
-        """
-        self.client.connection.api_request(method='DELETE', path=self.path)
-
-    def fetch_parent(self):
-        """Returns the parent group of this group via a ``GET`` request.
-
-        :rtype: :class:`Group` or None
-        :returns: The parent of the group.
-        """
-        if not self.parent_id:
-            return None
-        return self._fetch(self.client, self.parent_id)
-
-    def list_children(self):
-        """Lists all children of this group via a ``GET`` request.
-
-        Returns groups whose parent_name field contains the group name. If no
-        groups have this parent, the results are empty.
-
-        :rtype: list of :class:`~google.cloud.monitoring.group.Group`
-        :returns: A list of group instances.
-        """
-        return self._list(self.client, children_of_group=self.name)
-
-    def list_ancestors(self):
-        """Lists all ancestors of this group via a ``GET`` request.
-
-        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.
-
-        :rtype: list of :class:`~google.cloud.monitoring.group.Group`
-        :returns: A list of group instances.
-        """
-        return self._list(self.client, ancestors_of_group=self.name)
-
-    def list_descendants(self):
-        """Lists all descendants of this group via a ``GET`` request.
-
-        This returns a superset of the results returned by the :meth:`children`
-        method, and includes children-of-children, and so forth.
-
-        :rtype: list of :class:`~google.cloud.monitoring.group.Group`
-        :returns: A list of group instances.
-        """
-        return self._list(self.client, descendants_of_group=self.name)
-
-    def list_members(self, filter_string=None, end_time=None, start_time=None):
-        """Lists all members of this group via a ``GET`` request.
-
-        If no ``end_time`` is provided then the group membership over the last
-        minute is returned.
-
-        Example::
-
-            >>> for member in group.list_members():
-            ...     print member
-
-        List members that are Compute Engine VM instances::
-
-            >>> filter_string = 'resource.type = "gce_instance"'
-            >>> for member in group.list_members(filter_string=filter_string):
-            ...     print member
-
-        List historical members that existed between 4 and 5 hours ago::
-
-            >>> import datetime
-            >>> t1 = datetime.datetime.utcnow() - datetime.timedelta(hours=4)
-            >>> t0 = t1 - datetime.timedelta(hours=1)
-            >>> for member in group.list_members(end_time=t1, start_time=t0):
-            ...     print member
-
-
-        :type filter_string: string or None
-        :param filter_string:
-            An optional list filter describing the members to be returned. The
-            filter may reference the type, labels, and metadata of monitored
-            resources that comprise the group. See the `filter documentation`_.
-
-        :type end_time: :class:`datetime.datetime` or None
-        :param end_time:
-            The end time (inclusive) of the time interval for which results
-            should be returned, as a datetime object. If ``start_time`` is
-            specified, then this must also be specified.
-
-        :type start_time: :class:`datetime.datetime` or None
-        :param start_time:
-            The start time (exclusive) of the time interval for which results
-            should be returned, as a datetime object.
-
-        :rtype: list of :class:`~google.cloud.monitoring.resource.Resource`
-        :returns: A list of resource instances.
-
-        :raises:
-            :exc:`ValueError` if the ``start_time`` is specified, but the
-            ``end_time`` is missing.
-
-        .. _filter documentation:
-            https://cloud.google.com/monitoring/api/v3/filters#group-filter
-        """
-        if start_time is not None and end_time is None:
-            raise ValueError('If "start_time" is specified, "end_time" must '
-                             'also be specified')
-
-        path = '%s/members' % (self.path,)
-        resources = []
-        page_token = None
-        params = {}
-
-        if filter_string is not None:
-            params['filter'] = filter_string
-
-        if end_time is not None:
-            params['interval.endTime'] = _datetime_to_rfc3339(
-                end_time, ignore_zone=False)
-
-        if start_time is not None:
-            params['interval.startTime'] = _datetime_to_rfc3339(
-                start_time, ignore_zone=False)
-
-        while True:
-            if page_token is not None:
-                params['pageToken'] = page_token
-
-            response = self.client.connection.api_request(
-                method='GET', path=path, query_params=params.copy())
-            for info in response.get('members', ()):
-                resources.append(Resource._from_dict(info))
-
-            page_token = response.get('nextPageToken')
-            if not page_token:
-                break
-
-        return resources
-
-    @classmethod
-    def _fetch(cls, client, group_id):
-        """Fetch a group from the API based on it's ID.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: The client to use.
-
-        :type group_id: string
-        :param group_id: The group ID.
-
-        :rtype: :class:`Group`
-        :returns: The group instance.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` if the group
-            is not found.
-        """
-        new_group = cls(client, group_id)
-        new_group.reload()
-        return new_group
-
-    @classmethod
-    def _list(cls, client, children_of_group=None, ancestors_of_group=None,
-              descendants_of_group=None):
-        """Lists all groups in the project.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: The client to use.
-
-        :type children_of_group: string or None
-        :param children_of_group:
-            Returns groups whose parent_name field contains the group name. If
-            no groups have this parent, the results are empty.
-
-        :type ancestors_of_group: string or None
-        :param ancestors_of_group:
-            Returns groups that are ancestors of the specified group. If the
-            specified group has no immediate parent, the results are empty.
-
-        :type descendants_of_group: string or None
-        :param descendants_of_group:
-            Returns the descendants of the specified group. This is a superset
-            of the results returned by the children_of_group filter, and
-            includes children-of-children, and so forth.
-
-        :rtype: list of :class:`~google.cloud.monitoring.group.Group`
-        :returns: A list of group instances.
-        """
-        path = '/projects/%s/groups/' % (client.project,)
-        groups = []
-        page_token = None
-        params = {}
-
-        if children_of_group is not None:
-            params['childrenOfGroup'] = children_of_group
-
-        if ancestors_of_group is not None:
-            params['ancestorsOfGroup'] = ancestors_of_group
-
-        if descendants_of_group is not None:
-            params['descendantsOfGroup'] = descendants_of_group
-
-        while True:
-            if page_token is not None:
-                params['pageToken'] = page_token
-
-            response = client.connection.api_request(
-                method='GET', path=path, query_params=params.copy())
-            for info in response.get('group', ()):
-                groups.append(cls._from_dict(client, info))
-
-            page_token = response.get('nextPageToken')
-            if not page_token:
-                break
-
-        return groups
-
-    @classmethod
-    def _from_dict(cls, client, info):
-        """Constructs a Group instance from the parsed JSON representation.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: A client to be included in the returned object.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`Group`
-        :returns: A group.
-        """
-        group = cls(client)
-        group._set_properties_from_dict(info)
-        return group
-
-    def _set_properties_from_dict(self, info):
-        """Update the group properties from its API representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-        """
-        self._name = info['name']
-        self._id = _group_id_from_name(self._name)
-        self.display_name = info['displayName']
-        self.filter = info['filter']
-        self.is_cluster = info.get('isCluster', False)
-
-        parent_name = info.get('parentName')
-        if parent_name is None:
-            self.parent_id = None
-        else:
-            self.parent_id = _group_id_from_name(parent_name)
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON wire format.
-
-        :rtype: dict
-        :returns: A dictionary.
-        """
-        info = {
-            'filter': self.filter,
-            'displayName': self.display_name,
-            'isCluster': self.is_cluster,
-        }
-
-        if self.name is not None:
-            info['name'] = self.name
-
-        parent_name = self.parent_name
-        if parent_name is not None:
-            info['parentName'] = parent_name
-
-        return info
-
-    def __repr__(self):
-        return '<Group: %s>' % (self.name,)
diff --git a/google/cloud/monitoring/label.py b/google/cloud/monitoring/label.py
deleted file mode 100644
index 9579e768ac0e..000000000000
--- a/google/cloud/monitoring/label.py
+++ /dev/null
@@ -1,99 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Label Descriptors for the `Stackdriver Monitoring API (V3)`_.
-
-.. _Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/LabelDescriptor
-"""
-
-
-class LabelValueType(object):
-    """Allowed values for the `type of a label`_.
-
-    .. _type of a label:
-        https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-        LabelDescriptor#ValueType
-    """
-
-    STRING = 'STRING'
-    BOOL = 'BOOL'
-    INT64 = 'INT64'
-
-
-class LabelDescriptor(object):
-    """Schema specification and documentation for a single label.
-
-    :type key: string
-    :param key: The name of the label.
-
-    :type value_type: string
-    :param value_type:
-        The type of the label. It must be one of :data:`LabelValueType.STRING`,
-        :data:`LabelValueType.BOOL`, or :data:`LabelValueType.INT64`.
-        See :class:`LabelValueType`.
-
-    :type description: string
-    :param description: A human-readable description for the label.
-    """
-
-    def __init__(self, key, value_type=LabelValueType.STRING, description=''):
-        self.key = key
-        self.value_type = value_type
-        self.description = description
-
-    @classmethod
-    def _from_dict(cls, info):
-        """Construct a label descriptor from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`LabelDescriptor`
-        :returns: A label descriptor.
-        """
-        return cls(
-            info['key'],
-            info.get('valueType', LabelValueType.STRING),
-            info.get('description', ''),
-        )
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON wire format.
-
-        :rtype: dict
-        :returns: A dictionary.
-        """
-        info = {
-            'key': self.key,
-            'valueType': self.value_type,
-        }
-
-        if self.description:
-            info['description'] = self.description
-
-        return info
-
-    def __eq__(self, other):
-        return self.__dict__ == other.__dict__
-
-    def __ne__(self, other):
-        return self.__dict__ != other.__dict__
-
-    def __repr__(self):
-        return (
-            'LabelDescriptor(key={key!r}, value_type={value_type!r},'
-            ' description={description!r})'
-        ).format(**self.__dict__)
diff --git a/google/cloud/monitoring/metric.py b/google/cloud/monitoring/metric.py
deleted file mode 100644
index 5bec97f7c4eb..000000000000
--- a/google/cloud/monitoring/metric.py
+++ /dev/null
@@ -1,362 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Metric Descriptors for the `Google Stackdriver Monitoring API (V3)`_.
-
-.. _Google Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.metricDescriptors
-"""
-
-import collections
-
-from google.cloud.monitoring.label import LabelDescriptor
-
-
-class MetricKind(object):
-    """Choices for the `kind of measurement`_.
-
-    .. _kind of measurement:
-        https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-        projects.metricDescriptors#MetricKind
-    """
-
-    METRIC_KIND_UNSPECIFIED = 'METRIC_KIND_UNSPECIFIED'
-    """.. note:: An unspecified kind is not allowed in metric descriptors."""
-
-    GAUGE = 'GAUGE'
-    DELTA = 'DELTA'
-    CUMULATIVE = 'CUMULATIVE'
-
-
-class ValueType(object):
-    """Choices for the `metric value type`_.
-
-    .. _metric value type:
-        https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-        projects.metricDescriptors#ValueType
-    """
-
-    VALUE_TYPE_UNSPECIFIED = 'VALUE_TYPE_UNSPECIFIED'
-    """.. note:: An unspecified type is not allowed in metric descriptors."""
-
-    BOOL = 'BOOL'
-    INT64 = 'INT64'
-    DOUBLE = 'DOUBLE'
-    STRING = 'STRING'
-    DISTRIBUTION = 'DISTRIBUTION'
-
-
-class MetricDescriptor(object):
-    """Specification of a metric type and its schema.
-
-    The preferred way to construct a metric descriptor object is using the
-    :meth:`~google.cloud.monitoring.client.Client.metric_descriptor` factory
-    method of the :class:`~google.cloud.monitoring.client.Client` class.
-
-    :type client: :class:`google.cloud.monitoring.client.Client`
-    :param client: A client for operating on the metric descriptor.
-
-    :type type_: string
-    :param type_:
-        The metric type including a DNS name prefix. For example:
-        ``"compute.googleapis.com/instance/cpu/utilization"``
-
-    :type metric_kind: string
-    :param metric_kind:
-        The kind of measurement. It must be one of
-        :data:`MetricKind.GAUGE`, :data:`MetricKind.DELTA`,
-        or :data:`MetricKind.CUMULATIVE`. See :class:`MetricKind`.
-
-    :type value_type: string
-    :param value_type:
-        The value type of the metric. It must be one of
-        :data:`ValueType.BOOL`, :data:`ValueType.INT64`,
-        :data:`ValueType.DOUBLE`, :data:`ValueType.STRING`,
-        or :data:`ValueType.DISTRIBUTION`.
-        See :class:`ValueType`.
-
-    :type labels:
-        list of :class:`~google.cloud.monitoring.label.LabelDescriptor`
-    :param labels:
-        A sequence of zero or more label descriptors specifying the labels
-        used to identify a specific instance of this metric.
-
-    :type unit: string
-    :param unit: An optional unit in which the metric value is reported.
-
-    :type description: string
-    :param description: An optional detailed description of the metric.
-
-    :type display_name: string
-    :param display_name: An optional concise name for the metric.
-
-    :type name: string or None
-    :param name:
-        The "resource name" of the metric descriptor. For example:
-        ``"projects/<project_id>/metricDescriptors/<type>"``. As
-        retrieved from the service, this will always be specified.
-        You can and should omit it when constructing an instance for
-        the purpose of creating a new metric descriptor.
-    """
-
-    def __init__(self, client, type_,
-                 metric_kind=MetricKind.METRIC_KIND_UNSPECIFIED,
-                 value_type=ValueType.VALUE_TYPE_UNSPECIFIED,
-                 labels=(),
-                 unit='', description='', display_name='',
-                 name=None):
-        self.client = client
-        self.name = name
-        self.type = type_
-        self.labels = labels
-        self.metric_kind = metric_kind
-        self.value_type = value_type
-        self.unit = unit
-        self.description = description
-        self.display_name = display_name
-
-    def create(self):
-        """Create a new metric descriptor based on this object.
-
-        Example::
-
-            >>> descriptor = client.metric_descriptor(
-            ...     'custom.googleapis.com/my_metric',
-            ...     metric_kind=MetricKind.GAUGE,
-            ...     value_type=ValueType.DOUBLE,
-            ...     description='This is a simple example of a custom metric.')
-            >>> descriptor.create()
-
-        The metric kind must not be :data:`MetricKind.METRIC_KIND_UNSPECIFIED`,
-        and the value type must not be
-        :data:`ValueType.VALUE_TYPE_UNSPECIFIED`.
-
-        The ``name`` attribute is ignored in preparing the creation request.
-        All attributes are overwritten by the values received in the response
-        (normally affecting only ``name``).
-        """
-        path = '/projects/{project}/metricDescriptors/'.format(
-            project=self.client.project)
-        response = self.client.connection.api_request(method='POST', path=path,
-                                                      data=self._to_dict())
-        self._init_from_dict(response)
-
-    def delete(self):
-        """Delete the metric descriptor identified by this object.
-
-        Example::
-
-            >>> descriptor = client.metric_descriptor(
-            ...     'custom.googleapis.com/my_metric')
-            >>> descriptor.delete()
-
-        Only the ``client`` and ``type`` attributes are used.
-        """
-        path = '/projects/{project}/metricDescriptors/{type}'.format(
-            project=self.client.project,
-            type=self.type)
-        self.client.connection.api_request(method='DELETE', path=path)
-
-    @classmethod
-    def _fetch(cls, client, metric_type):
-        """Look up a metric descriptor by type.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: The client to use.
-
-        :type metric_type: string
-        :param metric_type: The metric type name.
-
-        :rtype: :class:`MetricDescriptor`
-        :returns: The metric descriptor instance.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` if the metric
-                 descriptor is not found.
-        """
-        path = '/projects/{project}/metricDescriptors/{type}'.format(
-            project=client.project,
-            type=metric_type)
-        info = client.connection.api_request(method='GET', path=path)
-        return cls._from_dict(client, info)
-
-    @classmethod
-    def _list(cls, client, filter_string=None, type_prefix=None):
-        """List all metric descriptors for the project.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: The client to use.
-
-        :type filter_string: string or None
-        :param filter_string:
-            An optional filter expression describing the metric descriptors
-            to be returned. See the `filter documentation`_.
-
-        :type type_prefix: string or None
-        :param type_prefix: An optional prefix constraining the selected
-            metric types. This adds ``metric.type = starts_with("<prefix>")``
-            to the filter.
-
-        :rtype: list of :class:`MetricDescriptor`
-        :returns: A list of metric descriptor instances.
-
-        .. _filter documentation:
-            https://cloud.google.com/monitoring/api/v3/filters
-        """
-        path = '/projects/{project}/metricDescriptors/'.format(
-            project=client.project)
-
-        filters = []
-        if filter_string is not None:
-            filters.append(filter_string)
-
-        if type_prefix is not None:
-            filters.append('metric.type = starts_with("{prefix}")'.format(
-                prefix=type_prefix))
-
-        descriptors = []
-        page_token = None
-        while True:
-            params = {}
-
-            if filters:
-                params['filter'] = ' AND '.join(filters)
-
-            if page_token is not None:
-                params['pageToken'] = page_token
-
-            response = client.connection.api_request(
-                method='GET', path=path, query_params=params)
-            for info in response.get('metricDescriptors', ()):
-                descriptors.append(cls._from_dict(client, info))
-
-            page_token = response.get('nextPageToken')
-            if not page_token:
-                break
-
-        return descriptors
-
-    @classmethod
-    def _from_dict(cls, client, info):
-        """Construct a metric descriptor from the parsed JSON representation.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: A client to be included in the returned object.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`MetricDescriptor`
-        :returns: A metric descriptor.
-        """
-        descriptor = cls(client, None)
-        descriptor._init_from_dict(info)
-        return descriptor
-
-    def _init_from_dict(self, info):
-        """Initialize attributes from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-        """
-        self.name = info['name']
-        self.type = info['type']
-        self.labels = tuple(LabelDescriptor._from_dict(label)
-                            for label in info.get('labels', []))
-        self.metric_kind = info['metricKind']
-        self.value_type = info['valueType']
-        self.unit = info.get('unit', '')
-        self.description = info.get('description', '')
-        self.display_name = info.get('displayName', '')
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON wire format.
-
-        :rtype: dict
-        :returns: A dictionary.
-        """
-        info = {
-            'type': self.type,
-            'metricKind': self.metric_kind,
-            'valueType': self.value_type,
-        }
-
-        if self.labels:
-            info['labels'] = [label._to_dict() for label in self.labels]
-        if self.unit:
-            info['unit'] = self.unit
-        if self.description:
-            info['description'] = self.description
-        if self.display_name:
-            info['displayName'] = self.display_name
-
-        return info
-
-    def __repr__(self):
-        return (
-            '<MetricDescriptor:\n'
-            ' name={name!r},\n'
-            ' type={type!r},\n'
-            ' metric_kind={metric_kind!r}, value_type={value_type!r},\n'
-            ' labels={labels!r},\n'
-            ' display_name={display_name!r}, unit={unit!r},\n'
-            ' description={description!r}>'
-        ).format(**self.__dict__)
-
-
-class Metric(collections.namedtuple('Metric', 'type labels')):
-    """A specific metric identified by specifying values for all labels.
-
-    The preferred way to construct a metric object is using the
-    :meth:`~google.cloud.monitoring.client.Client.metric` factory method
-    of the :class:`~google.cloud.monitoring.client.Client` class.
-
-    :type type: string
-    :param type: The metric type name.
-
-    :type labels: dict
-    :param labels: A mapping from label names to values for all labels
-                   enumerated in the associated :class:`MetricDescriptor`.
-    """
-    __slots__ = ()
-
-    @classmethod
-    def _from_dict(cls, info):
-        """Construct a metric object from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`Metric`
-        :returns: A metric object.
-        """
-        return cls(
-            type=info['type'],
-            labels=info.get('labels', {}),
-        )
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON format.
-
-        :rtype: dict
-        :returns: A dict representation of the object that can be written to
-                  the API.
-        """
-        return {
-            'type': self.type,
-            'labels': self.labels,
-        }
diff --git a/google/cloud/monitoring/query.py b/google/cloud/monitoring/query.py
deleted file mode 100644
index d9176b15f562..000000000000
--- a/google/cloud/monitoring/query.py
+++ /dev/null
@@ -1,685 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Time series query for the `Google Stackdriver Monitoring API (V3)`_.
-
-.. _Google Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.timeSeries/list
-"""
-
-import copy
-import datetime
-import itertools
-
-import six
-
-from google.cloud._helpers import _datetime_to_rfc3339
-from google.cloud.monitoring._dataframe import _build_dataframe
-from google.cloud.monitoring.timeseries import TimeSeries
-
-_UTCNOW = datetime.datetime.utcnow  # To be replaced by tests.
-
-
-class Aligner(object):
-    """Allowed values for the `supported aligners`_."""
-
-    ALIGN_NONE = 'ALIGN_NONE'
-    ALIGN_DELTA = 'ALIGN_DELTA'
-    ALIGN_RATE = 'ALIGN_RATE'
-    ALIGN_INTERPOLATE = 'ALIGN_INTERPOLATE'
-    ALIGN_NEXT_OLDER = 'ALIGN_NEXT_OLDER'
-    ALIGN_MIN = 'ALIGN_MIN'
-    ALIGN_MAX = 'ALIGN_MAX'
-    ALIGN_MEAN = 'ALIGN_MEAN'
-    ALIGN_COUNT = 'ALIGN_COUNT'
-    ALIGN_SUM = 'ALIGN_SUM'
-    ALIGN_STDDEV = 'ALIGN_STDDEV'
-    ALIGN_COUNT_TRUE = 'ALIGN_COUNT_TRUE'
-    ALIGN_FRACTION_TRUE = 'ALIGN_FRACTION_TRUE'
-
-
-class Reducer(object):
-    """Allowed values for the `supported reducers`_."""
-
-    REDUCE_NONE = 'REDUCE_NONE'
-    REDUCE_MEAN = 'REDUCE_MEAN'
-    REDUCE_MIN = 'REDUCE_MIN'
-    REDUCE_MAX = 'REDUCE_MAX'
-    REDUCE_SUM = 'REDUCE_SUM'
-    REDUCE_STDDEV = 'REDUCE_STDDEV'
-    REDUCE_COUNT = 'REDUCE_COUNT'
-    REDUCE_COUNT_TRUE = 'REDUCE_COUNT_TRUE'
-    REDUCE_FRACTION_TRUE = 'REDUCE_FRACTION_TRUE'
-    REDUCE_PERCENTILE_99 = 'REDUCE_PERCENTILE_99'
-    REDUCE_PERCENTILE_95 = 'REDUCE_PERCENTILE_95'
-    REDUCE_PERCENTILE_50 = 'REDUCE_PERCENTILE_50'
-    REDUCE_PERCENTILE_05 = 'REDUCE_PERCENTILE_05'
-
-
-class Query(object):
-    """Query object for retrieving metric data.
-
-    The preferred way to construct a query object is using the
-    :meth:`~google.cloud.monitoring.client.Client.query` method
-    of the :class:`~google.cloud.monitoring.client.Client` class.
-
-    :type client: :class:`google.cloud.monitoring.client.Client`
-    :param client: The client to use.
-
-    :type metric_type: string
-    :param metric_type: The metric type name. The default value is
-        :data:`Query.DEFAULT_METRIC_TYPE
-        <google.cloud.monitoring.query.Query.DEFAULT_METRIC_TYPE>`,
-        but please note that this default value is provided only for
-        demonstration purposes and is subject to change. See the
-        `supported metrics`_.
-
-    :type end_time: :class:`datetime.datetime` or None
-    :param end_time: The end time (inclusive) of the time interval
-        for which results should be returned, as a datetime object.
-        The default is the start of the current minute.
-
-        The start time (exclusive) is determined by combining the
-        values of  ``days``, ``hours``, and ``minutes``, and
-        subtracting the resulting duration from the end time.
-
-        It is also allowed to omit the end time and duration here,
-        in which case
-        :meth:`~google.cloud.monitoring.query.Query.select_interval`
-        must be called before the query is executed.
-
-    :type days: integer
-    :param days: The number of days in the time interval.
-
-    :type hours: integer
-    :param hours: The number of hours in the time interval.
-
-    :type minutes: integer
-    :param minutes: The number of minutes in the time interval.
-
-    :raises: :exc:`ValueError` if ``end_time`` is specified but
-        ``days``, ``hours``, and ``minutes`` are all zero.
-        If you really want to specify a point in time, use
-        :meth:`~google.cloud.monitoring.query.Query.select_interval`.
-
-    .. _supported metrics: https://cloud.google.com/monitoring/api/metrics
-    """
-
-    DEFAULT_METRIC_TYPE = 'compute.googleapis.com/instance/cpu/utilization'
-
-    def __init__(self, client,
-                 metric_type=DEFAULT_METRIC_TYPE,
-                 end_time=None, days=0, hours=0, minutes=0):
-        start_time = None
-        if days or hours or minutes:
-            if end_time is None:
-                end_time = _UTCNOW().replace(second=0, microsecond=0)
-            start_time = end_time - datetime.timedelta(days=days,
-                                                       hours=hours,
-                                                       minutes=minutes)
-        elif end_time is not None:
-            raise ValueError('Non-zero duration required for time interval.')
-
-        self._client = client
-        self._end_time = end_time
-        self._start_time = start_time
-        self._filter = _Filter(metric_type)
-
-        self._per_series_aligner = None
-        self._alignment_period_seconds = None
-        self._cross_series_reducer = None
-        self._group_by_fields = ()
-
-    def __iter__(self):
-        return self.iter()
-
-    @property
-    def metric_type(self):
-        """The metric type name."""
-        return self._filter.metric_type
-
-    @property
-    def filter(self):
-        """The filter string.
-
-        This is constructed from the metric type, the resource type, and
-        selectors for the group ID, monitored projects, resource labels,
-        and metric labels.
-        """
-        return str(self._filter)
-
-    def select_interval(self, end_time, start_time=None):
-        """Copy the query and set the query time interval.
-
-        Example::
-
-            import datetime
-
-            now = datetime.datetime.utcnow()
-            query = query.select_interval(
-                end_time=now,
-                start_time=now - datetime.timedelta(minutes=5))
-
-        As a convenience, you can alternatively specify the end time and
-        an interval duration when you create the query initially.
-
-        :type end_time: :class:`datetime.datetime`
-        :param end_time: The end time (inclusive) of the time interval
-            for which results should be returned, as a datetime object.
-
-        :type start_time: :class:`datetime.datetime` or None
-        :param start_time: The start time (exclusive) of the time interval
-            for which results should be returned, as a datetime object.
-            If not specified, the interval is a point in time.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-        """
-        new_query = self.copy()
-        new_query._end_time = end_time
-        new_query._start_time = start_time
-        return new_query
-
-    def select_group(self, group_id):
-        """Copy the query and add filtering by group.
-
-        Example::
-
-            query = query.select_group('1234567')
-
-        :type group_id: string
-        :param group_id: The ID of a group to filter by.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-        """
-        new_query = self.copy()
-        new_query._filter.group_id = group_id
-        return new_query
-
-    def select_projects(self, *args):
-        """Copy the query and add filtering by monitored projects.
-
-        This is only useful if the target project represents a Stackdriver
-        account containing the specified monitored projects.
-
-        Examples::
-
-            query = query.select_projects('project-1')
-            query = query.select_projects('project-1', 'project-2')
-
-        :type args: tuple
-        :param args: Project IDs limiting the resources to be included
-            in the query.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-        """
-        new_query = self.copy()
-        new_query._filter.projects = args
-        return new_query
-
-    def select_resources(self, *args, **kwargs):
-        """Copy the query and add filtering by resource labels.
-
-        Examples::
-
-            query = query.select_resources(zone='us-central1-a')
-            query = query.select_resources(zone_prefix='europe-')
-            query = query.select_resources(resource_type='gce_instance')
-
-        A keyword argument ``<label>=<value>`` ordinarily generates a filter
-        expression of the form::
-
-            resource.label.<label> = "<value>"
-
-        However, by adding ``"_prefix"`` or ``"_suffix"`` to the keyword,
-        you can specify a partial match.
-
-        ``<label>_prefix=<value>`` generates::
-
-            resource.label.<label> = starts_with("<value>")
-
-        ``<label>_suffix=<value>`` generates::
-
-            resource.label.<label> = ends_with("<value>")
-
-        As a special case, ``"resource_type"`` is treated as a special
-        pseudo-label corresponding to the filter object ``resource.type``.
-        For example, ``resource_type=<value>`` generates::
-
-            resource.type = "<value>"
-
-        See the `defined resource types`_.
-
-        .. note::
-
-            The label ``"instance_name"`` is a metric label,
-            not a resource label. You would filter on it using
-            ``select_metrics(instance_name=...)``.
-
-        :type args: tuple
-        :param args: Raw filter expression strings to include in the
-            conjunction. If just one is provided and no keyword arguments
-            are provided, it can be a disjunction.
-
-        :type kwargs: dict
-        :param kwargs: Label filters to include in the conjunction as
-            described above.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-
-        .. _defined resource types:
-            https://cloud.google.com/monitoring/api/v3/monitored-resources
-        """
-        new_query = self.copy()
-        new_query._filter.select_resources(*args, **kwargs)
-        return new_query
-
-    def select_metrics(self, *args, **kwargs):
-        """Copy the query and add filtering by metric labels.
-
-        Examples::
-
-            query = query.select_metrics(instance_name='myinstance')
-            query = query.select_metrics(instance_name_prefix='mycluster-')
-
-        A keyword argument ``<label>=<value>`` ordinarily generates a filter
-        expression of the form::
-
-            metric.label.<label> = "<value>"
-
-        However, by adding ``"_prefix"`` or ``"_suffix"`` to the keyword,
-        you can specify a partial match.
-
-        ``<label>_prefix=<value>`` generates::
-
-            metric.label.<label> = starts_with("<value>")
-
-        ``<label>_suffix=<value>`` generates::
-
-            metric.label.<label> = ends_with("<value>")
-
-        If the label's value type is ``INT64``, a similar notation can be
-        used to express inequalities:
-
-        ``<label>_less=<value>`` generates::
-
-            metric.label.<label> < <value>
-
-        ``<label>_lessequal=<value>`` generates::
-
-            metric.label.<label> <= <value>
-
-        ``<label>_greater=<value>`` generates::
-
-            metric.label.<label> > <value>
-
-        ``<label>_greaterequal=<value>`` generates::
-
-            metric.label.<label> >= <value>
-
-        :type args: tuple
-        :param args: Raw filter expression strings to include in the
-            conjunction. If just one is provided and no keyword arguments
-            are provided, it can be a disjunction.
-
-        :type kwargs: dict
-        :param kwargs: Label filters to include in the conjunction as
-            described above.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-        """
-        new_query = self.copy()
-        new_query._filter.select_metrics(*args, **kwargs)
-        return new_query
-
-    def align(self, per_series_aligner, seconds=0, minutes=0, hours=0):
-        """Copy the query and add temporal alignment.
-
-        If ``per_series_aligner`` is not :data:`Aligner.ALIGN_NONE`, each time
-        series will contain data points only on the period boundaries.
-
-        Example::
-
-            query = query.align(Aligner.ALIGN_MEAN, minutes=5)
-
-        It is also possible to specify the aligner as a literal string::
-
-            query = query.align('ALIGN_MEAN', minutes=5)
-
-        :type per_series_aligner: string
-        :param per_series_aligner: The approach to be used to align
-            individual time series. For example: :data:`Aligner.ALIGN_MEAN`.
-            See :class:`Aligner` and the descriptions of the `supported
-            aligners`_.
-
-        :type seconds: integer
-        :param seconds: The number of seconds in the alignment period.
-
-        :type minutes: integer
-        :param minutes: The number of minutes in the alignment period.
-
-        :type hours: integer
-        :param hours: The number of hours in the alignment period.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-
-        .. _supported aligners:
-            https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-            projects.timeSeries/list#Aligner
-        """
-        new_query = self.copy()
-        new_query._per_series_aligner = per_series_aligner
-        new_query._alignment_period_seconds = seconds + 60 * (minutes +
-                                                              60 * hours)
-        return new_query
-
-    def reduce(self, cross_series_reducer, *group_by_fields):
-        """Copy the query and add cross-series reduction.
-
-        Cross-series reduction combines time series by aggregating their
-        data points.
-
-        For example, you could request an aggregated time series for each
-        combination of project and zone as follows::
-
-            query = query.reduce(Reducer.REDUCE_MEAN,
-                                 'resource.project_id', 'resource.zone')
-
-        :type cross_series_reducer: string
-        :param cross_series_reducer:
-            The approach to be used to combine time series. For example:
-            :data:`Reducer.REDUCE_MEAN`. See :class:`Reducer` and the
-            descriptions of the `supported reducers`_.
-
-        :type group_by_fields: strings
-        :param group_by_fields:
-            Fields to be preserved by the reduction. For example, specifying
-            just ``"resource.zone"`` will result in one time series per zone.
-            The default is to aggregate all of the time series into just one.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-
-        .. _supported reducers:
-            https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-            projects.timeSeries/list#Reducer
-        """
-        new_query = self.copy()
-        new_query._cross_series_reducer = cross_series_reducer
-        new_query._group_by_fields = group_by_fields
-        return new_query
-
-    def iter(self, headers_only=False, page_size=None):
-        """Yield all time series objects selected by the query.
-
-        The generator returned iterates over
-        :class:`~google.cloud.monitoring.timeseries.TimeSeries` objects
-        containing points ordered from oldest to newest.
-
-        Note that the :class:`Query` object itself is an iterable, such that
-        the following are equivalent::
-
-            for timeseries in query:
-                ...
-
-            for timeseries in query.iter():
-                ...
-
-        :type headers_only: boolean
-        :param headers_only:
-             Whether to omit the point data from the time series objects.
-
-        :type page_size: integer or None
-        :param page_size:
-            An optional positive number specifying the maximum number of
-            points to return per page. This can be used to control how far
-            the iterator reads ahead.
-
-        :raises: :exc:`ValueError` if the query time interval has not been
-            specified.
-        """
-        # The following use of groupby() relies on equality comparison
-        # of time series as (named) tuples.
-        for timeseries, fragments in itertools.groupby(
-                self._iter_fragments(headers_only, page_size),
-                lambda fragment: fragment.header()):
-            points = list(itertools.chain.from_iterable(
-                fragment.points for fragment in fragments))
-            points.reverse()  # Order from oldest to newest.
-            yield timeseries.header(points=points)
-
-    def _iter_fragments(self, headers_only=False, page_size=None):
-        """Yield all time series fragments selected by the query.
-
-        There may be multiple fragments per time series. These will be
-        contiguous.
-
-        The parameters and return value are as for :meth:`Query.iter`.
-        """
-        if self._end_time is None:
-            raise ValueError('Query time interval not specified.')
-
-        path = '/projects/{project}/timeSeries/'.format(
-            project=self._client.project)
-
-        page_token = None
-        while True:
-            params = list(self._build_query_params(
-                headers_only=headers_only,
-                page_size=page_size,
-                page_token=page_token,
-            ))
-            response = self._client.connection.api_request(
-                method='GET',
-                path=path,
-                query_params=params,
-            )
-            for info in response.get('timeSeries', ()):
-                yield TimeSeries._from_dict(info)
-
-            page_token = response.get('nextPageToken')
-            if not page_token:
-                break
-
-    def _build_query_params(self, headers_only=False,
-                            page_size=None, page_token=None):
-        """Yield key-value pairs for the URL query string.
-
-        We use a series of key-value pairs (suitable for passing to
-        ``urlencode``) instead of a ``dict`` to allow for repeated fields.
-
-        :type headers_only: boolean
-        :param headers_only:
-             Whether to omit the point data from the
-             :class:`~google.cloud.monitoring.timeseries.TimeSeries` objects.
-
-        :type page_size: integer or None
-        :param page_size: A limit on the number of points to return per page.
-
-        :type page_token: string or None
-        :param page_token: A token to continue the retrieval.
-        """
-        yield 'filter', self.filter
-
-        yield 'interval.endTime', _datetime_to_rfc3339(
-            self._end_time, ignore_zone=False)
-
-        if self._start_time is not None:
-            yield 'interval.startTime', _datetime_to_rfc3339(
-                self._start_time, ignore_zone=False)
-
-        if self._per_series_aligner is not None:
-            yield 'aggregation.perSeriesAligner', self._per_series_aligner
-
-        if self._alignment_period_seconds is not None:
-            alignment_period = '{period}s'.format(
-                period=self._alignment_period_seconds)
-            yield 'aggregation.alignmentPeriod', alignment_period
-
-        if self._cross_series_reducer is not None:
-            yield ('aggregation.crossSeriesReducer',
-                   self._cross_series_reducer)
-
-        for field in self._group_by_fields:
-            yield 'aggregation.groupByFields', field
-
-        if headers_only:
-            yield 'view', 'HEADERS'
-
-        if page_size is not None:
-            yield 'pageSize', page_size
-
-        if page_token is not None:
-            yield 'pageToken', page_token
-
-    def as_dataframe(self, label=None, labels=None):
-        """Return all the selected time series as a :mod:`pandas` dataframe.
-
-        .. note::
-
-            Use of this method requires that you have :mod:`pandas` installed.
-
-        Examples::
-
-            # Generate a dataframe with a multi-level column header including
-            # the resource type and all available resource and metric labels.
-            # This can be useful for seeing what labels are available.
-            dataframe = query.as_dataframe()
-
-            # Generate a dataframe using a particular label for the column
-            # names.
-            dataframe = query.as_dataframe(label='instance_name')
-
-            # Generate a dataframe with a multi-level column header.
-            dataframe = query.as_dataframe(labels=['zone', 'instance_name'])
-
-            # Generate a dataframe with a multi-level column header, assuming
-            # the metric is issued by more than one type of resource.
-            dataframe = query.as_dataframe(
-                labels=['resource_type', 'instance_id'])
-
-        :type label: string or None
-        :param label: The label name to use for the dataframe header.
-            This can be the name of a resource label or metric label
-            (e.g., ``"instance_name"``), or the string ``"resource_type"``.
-
-        :type labels: list of strings, or None
-        :param labels: A list or tuple of label names to use for the dataframe
-            header. If more than one label name is provided, the resulting
-            dataframe will have a multi-level column header. Providing values
-            for both ``label`` and ``labels`` is an error.
-
-        :rtype: :class:`pandas.DataFrame`
-        :returns: A dataframe where each column represents one time series.
-        """
-        return _build_dataframe(self, label, labels)  # pragma: NO COVER
-
-    def copy(self):
-        """Copy the query object.
-
-        :rtype: :class:`Query`
-        :returns: The new query object.
-        """
-        # Using copy.deepcopy() would be appropriate, except that we want
-        # to copy self._client only as a reference.
-        new_query = copy.copy(self)
-        new_query._filter = copy.copy(self._filter)
-        return new_query
-
-
-class _Filter(object):
-    """Helper for assembling a filter string."""
-
-    def __init__(self, metric_type):
-        self.metric_type = metric_type
-        self.group_id = None
-        self.projects = ()
-        self.resource_label_filter = None
-        self.metric_label_filter = None
-
-    def select_resources(self, *args, **kwargs):
-        """Select by resource labels.
-
-        See :meth:`Query.select_resources`.
-        """
-        self.resource_label_filter = _build_label_filter('resource',
-                                                         *args, **kwargs)
-
-    def select_metrics(self, *args, **kwargs):
-        """Select by metric labels.
-
-        See :meth:`Query.select_metrics`.
-        """
-        self.metric_label_filter = _build_label_filter('metric',
-                                                       *args, **kwargs)
-
-    def __str__(self):
-        filters = ['metric.type = "{type}"'.format(type=self.metric_type)]
-        if self.group_id is not None:
-            filters.append('group.id = "{id}"'.format(id=self.group_id))
-        if self.projects:
-            filters.append(
-                ' OR '.join('project = "{project}"'.format(project=project)
-                            for project in self.projects))
-        if self.resource_label_filter:
-            filters.append(self.resource_label_filter)
-        if self.metric_label_filter:
-            filters.append(self.metric_label_filter)
-
-        # Parentheses are never actually required, because OR binds more
-        # tightly than AND in the Monitoring API's filter syntax.
-        return ' AND '.join(filters)
-
-
-def _build_label_filter(category, *args, **kwargs):
-    """Construct a filter string to filter on metric or resource labels."""
-    terms = list(args)
-    for key, value in six.iteritems(kwargs):
-        if value is None:
-            continue
-
-        suffix = None
-        if key.endswith(('_prefix', '_suffix', '_greater', '_greaterequal',
-                         '_less', '_lessequal')):
-            key, suffix = key.rsplit('_', 1)
-
-        if category == 'resource' and key == 'resource_type':
-            key = 'resource.type'
-        else:
-            key = '.'.join((category, 'label', key))
-
-        if suffix == 'prefix':
-            term = '{key} = starts_with("{value}")'
-        elif suffix == 'suffix':
-            term = '{key} = ends_with("{value}")'
-        elif suffix == 'greater':
-            term = '{key} > {value}'
-        elif suffix == 'greaterequal':
-            term = '{key} >= {value}'
-        elif suffix == 'less':
-            term = '{key} < {value}'
-        elif suffix == 'lessequal':
-            term = '{key} <= {value}'
-        else:
-            term = '{key} = "{value}"'
-
-        terms.append(term.format(key=key, value=value))
-
-    return ' AND '.join(sorted(terms))
diff --git a/google/cloud/monitoring/resource.py b/google/cloud/monitoring/resource.py
deleted file mode 100644
index b49ecc864f97..000000000000
--- a/google/cloud/monitoring/resource.py
+++ /dev/null
@@ -1,201 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Monitored Resource Descriptors for the
-`Google Stackdriver Monitoring API (V3)`_.
-
-.. _Google Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
-    projects.monitoredResourceDescriptors
-"""
-
-import collections
-
-from google.cloud.monitoring.label import LabelDescriptor
-
-
-class ResourceDescriptor(object):
-    """Specification of a monitored resource type and its schema.
-
-    :type name: string
-    :param name:
-        The "resource name" of the monitored resource descriptor:
-        ``"projects/<project_id>/monitoredResourceDescriptors/<type>"``
-
-    :type type_: string
-    :param type_:
-        The monitored resource type. For example: ``"gce_instance"``
-
-    :type display_name: string
-    :param display_name:
-        A concise name that might be displayed in user interfaces.
-
-    :type description: string
-    :param description:
-        A detailed description that might be used in documentation.
-
-    :type labels:
-        list of :class:`~google.cloud.monitoring.label.LabelDescriptor`
-    :param labels:
-        A sequence of label descriptors specifying the labels used
-        to identify a specific instance of this monitored resource.
-    """
-
-    def __init__(self, name, type_, display_name, description, labels):
-        self.name = name
-        self.type = type_
-        self.display_name = display_name
-        self.description = description
-        self.labels = labels
-
-    @classmethod
-    def _fetch(cls, client, resource_type):
-        """Look up a monitored resource descriptor by type.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: The client to use.
-
-        :type resource_type: string
-        :param resource_type: The resource type name.
-
-        :rtype: :class:`ResourceDescriptor`
-        :returns: The resource descriptor instance.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` if the resource
-                 descriptor is not found.
-        """
-        path = ('/projects/{project}/monitoredResourceDescriptors/{type}'
-                .format(project=client.project,
-                        type=resource_type))
-        info = client.connection.api_request(method='GET', path=path)
-        return cls._from_dict(info)
-
-    @classmethod
-    def _list(cls, client, filter_string=None):
-        """List all monitored resource descriptors for the project.
-
-        :type client: :class:`google.cloud.monitoring.client.Client`
-        :param client: The client to use.
-
-        :type filter_string: string or None
-        :param filter_string:
-            An optional filter expression describing the resource descriptors
-            to be returned. See the `filter documentation`_.
-
-        :rtype: list of :class:`ResourceDescriptor`
-        :returns: A list of resource descriptor instances.
-
-        .. _filter documentation:
-            https://cloud.google.com/monitoring/api/v3/filters
-        """
-        path = '/projects/{project}/monitoredResourceDescriptors/'.format(
-            project=client.project)
-
-        descriptors = []
-
-        page_token = None
-        while True:
-            params = {}
-
-            if filter_string is not None:
-                params['filter'] = filter_string
-
-            if page_token is not None:
-                params['pageToken'] = page_token
-
-            response = client.connection.api_request(
-                method='GET', path=path, query_params=params)
-            for info in response.get('resourceDescriptors', ()):
-                descriptors.append(cls._from_dict(info))
-
-            page_token = response.get('nextPageToken')
-            if not page_token:
-                break
-
-        return descriptors
-
-    @classmethod
-    def _from_dict(cls, info):
-        """Construct a resource descriptor from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`ResourceDescriptor`
-        :returns: A resource descriptor.
-        """
-        return cls(
-            name=info['name'],
-            type_=info['type'],
-            display_name=info.get('displayName', ''),
-            description=info.get('description', ''),
-            labels=tuple(LabelDescriptor._from_dict(label)
-                         for label in info.get('labels', ())),
-        )
-
-    def __repr__(self):
-        return (
-            '<ResourceDescriptor:\n'
-            ' name={name!r},\n'
-            ' type={type!r},\n'
-            ' labels={labels!r},\n'
-            ' display_name={display_name!r},\n'
-            ' description={description!r}>'
-        ).format(**self.__dict__)
-
-
-class Resource(collections.namedtuple('Resource', 'type labels')):
-    """A monitored resource identified by specifying values for all labels.
-
-    The preferred way to construct a resource object is using the
-    :meth:`~google.cloud.monitoring.client.Client.resource` factory method
-    of the :class:`~google.cloud.monitoring.client.Client` class.
-
-    :type type: string
-    :param type: The resource type name.
-
-    :type labels: dict
-    :param labels: A mapping from label names to values for all labels
-                   enumerated in the associated :class:`ResourceDescriptor`.
-    """
-    __slots__ = ()
-
-    @classmethod
-    def _from_dict(cls, info):
-        """Construct a resource object from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`Resource`
-        :returns: A resource object.
-        """
-        return cls(
-            type=info['type'],
-            labels=info.get('labels', {}),
-        )
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON format.
-
-        :rtype: dict
-        :returns: A dict representation of the object that can be written to
-                  the API.
-        """
-        return {
-            'type': self.type,
-            'labels': self.labels,
-        }
diff --git a/google/cloud/monitoring/timeseries.py b/google/cloud/monitoring/timeseries.py
deleted file mode 100644
index 39d5f8ad873b..000000000000
--- a/google/cloud/monitoring/timeseries.py
+++ /dev/null
@@ -1,228 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Time series for the `Google Stackdriver Monitoring API (V3)`_.
-
-Features intentionally omitted from this first version of the client library:
-  * Writing time series.
-  * Natural representation of distribution values.
-
-.. _Google Stackdriver Monitoring API (V3):
-    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/TimeSeries
-"""
-
-import collections
-
-from google.cloud.monitoring.metric import Metric
-from google.cloud.monitoring.resource import Resource
-
-
-class TimeSeries(collections.namedtuple(
-        'TimeSeries', 'metric resource metric_kind value_type points')):
-    """A single time series of metric values.
-
-    The preferred way to construct a
-    :class:`~google.cloud.monitoring.timeseries.TimeSeries` object is
-    using the :meth:`~google.cloud.monitoring.client.Client.time_series`
-    factory method of the :class:`~google.cloud.monitoring.client.Client`
-    class.
-
-    :type metric: :class:`~google.cloud.monitoring.metric.Metric`
-    :param metric: A metric object.
-
-    :type resource: :class:`~google.cloud.monitoring.resource.Resource`
-    :param resource: A resource object.
-
-    :type metric_kind: string
-    :param metric_kind:
-        The kind of measurement: :data:`MetricKind.GAUGE`,
-        :data:`MetricKind.DELTA`, or :data:`MetricKind.CUMULATIVE`.
-        See :class:`~google.cloud.monitoring.metric.MetricKind`.
-
-    :type value_type: string
-    :param value_type:
-        The value type of the metric: :data:`ValueType.BOOL`,
-        :data:`ValueType.INT64`, :data:`ValueType.DOUBLE`,
-        :data:`ValueType.STRING`, or :data:`ValueType.DISTRIBUTION`.
-        See :class:`~google.cloud.monitoring.metric.ValueType`.
-
-    :type points: list of :class:`Point`
-    :param points: A list of point objects.
-    """
-
-    _labels = None
-
-    @property
-    def labels(self):
-        """A single dictionary with values for all the labels.
-
-        This combines ``resource.labels`` and ``metric.labels`` and also
-        adds ``"resource_type"``.
-        """
-        if self._labels is None:
-            labels = {'resource_type': self.resource.type}
-            labels.update(self.resource.labels)
-            labels.update(self.metric.labels)
-            self._labels = labels
-
-        return self._labels
-
-    def header(self, points=None):
-        """Copy everything but the point data.
-
-        :type points: list of :class:`Point`, or None
-        :param points: An optional point list.
-
-        :rtype: :class:`TimeSeries`
-        :returns: The new time series object.
-        """
-        points = list(points) if points else []
-        return self._replace(points=points)
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON wire format.
-
-        Since this method is used when writing to the API, it excludes
-        output-only fields.
-
-        :rtype: dict
-        :returns: The dictionary representation of the time series object.
-        """
-        info = {
-            'metric': self.metric._to_dict(),
-            'resource': self.resource._to_dict(),
-            'points': [point._to_dict() for point in self.points],
-        }
-
-        return info
-
-    @classmethod
-    def _from_dict(cls, info):
-        """Construct a time series from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`TimeSeries`
-        :returns: A time series object.
-        """
-        metric = Metric._from_dict(info['metric'])
-        resource = Resource._from_dict(info['resource'])
-        metric_kind = info['metricKind']
-        value_type = info['valueType']
-        points = [Point._from_dict(p) for p in info.get('points', ())]
-        return cls(metric, resource, metric_kind, value_type, points)
-
-    def __repr__(self):
-        """Return a representation string with the points elided."""
-        return (
-            '<TimeSeries with {num} points:\n'
-            ' metric={metric!r},\n'
-            ' resource={resource!r},\n'
-            ' metric_kind={kind!r}, value_type={type!r}>'
-        ).format(
-            num=len(self.points),
-            metric=self.metric,
-            resource=self.resource,
-            kind=self.metric_kind,
-            type=self.value_type,
-        )
-
-
-def _make_typed_value(value):
-    """Create a dict representing a TypedValue API object.
-
-    Typed values are objects with the value itself as the value, keyed by the
-    type of the value. They are used when writing points to time series. This
-    method returns the dict representation for the TypedValue.
-
-    This method uses the Python type of the object to infer the correct
-    type to send to the API. For example, a Python float will be sent to the
-    API with "doubleValue" as its key.
-
-    See: https://cloud.google.com/monitoring/api/ref_v3/rest/v3/TypedValue
-
-    :type value: bool, int, float, str, or dict
-    :param value: value to infer the typed value of.
-
-    :rtype: dict
-    :returns: A dict
-    """
-    typed_value_map = {
-        bool: 'boolValue',
-        int: 'int64Value',
-        float: 'doubleValue',
-        str: 'stringValue',
-        dict: 'distributionValue',
-    }
-    type_ = typed_value_map[type(value)]
-    if type_ == 'int64Value':
-        value = str(value)
-    return {type_: value}
-
-
-class Point(collections.namedtuple('Point', 'end_time start_time value')):
-    """A single point in a time series.
-
-    :type end_time: string
-    :param end_time: The end time in RFC3339 UTC "Zulu" format.
-
-    :type start_time: string or None
-    :param start_time: An optional start time in RFC3339 UTC "Zulu" format.
-
-    :type value: object
-    :param value: The metric value. This can be a scalar or a distribution.
-    """
-    __slots__ = ()
-
-    @classmethod
-    def _from_dict(cls, info):
-        """Construct a Point from the parsed JSON representation.
-
-        :type info: dict
-        :param info:
-            A ``dict`` parsed from the JSON wire-format representation.
-
-        :rtype: :class:`Point`
-        :returns: A point object.
-        """
-        end_time = info['interval']['endTime']
-        start_time = info['interval'].get('startTime')
-        (value_type, value), = info['value'].items()
-        if value_type == 'int64Value':
-            value = int(value)  # Convert from string.
-
-        return cls(end_time, start_time, value)
-
-    def _to_dict(self):
-        """Build a dictionary ready to be serialized to the JSON wire format.
-
-        This method serializes a point in JSON format to be written
-        to the API.
-
-        :rtype: dict
-        :returns: The dictionary representation of the point object.
-        """
-        info = {
-            'interval': {
-                'endTime': self.end_time,
-            },
-            'value': _make_typed_value(self.value),
-        }
-
-        if self.start_time is not None:
-            info['interval']['startTime'] = self.start_time
-
-        return info
diff --git a/google/cloud/operation.py b/google/cloud/operation.py
deleted file mode 100644
index 5fbdc9faca3f..000000000000
--- a/google/cloud/operation.py
+++ /dev/null
@@ -1,137 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Wrap long-running operations returned from Google Cloud APIs."""
-
-from google.longrunning import operations_pb2
-
-
-_GOOGLE_APIS_PREFIX = 'types.googleapis.com'
-
-_TYPE_URL_MAP = {
-}
-
-
-def _compute_type_url(klass, prefix=_GOOGLE_APIS_PREFIX):
-    """Compute a type URL for a klass.
-
-    :type klass: type
-    :param klass: class to be used as a factory for the given type
-
-    :type prefix: str
-    :param prefix: URL prefix for the type
-
-    :rtype: str
-    :returns: the URL, prefixed as appropriate
-    """
-    name = klass.DESCRIPTOR.full_name
-    return '%s/%s' % (prefix, name)
-
-
-def _register_type_url(type_url, klass):
-    """Register a klass as the factory for a given type URL.
-
-    :type type_url: str
-    :param type_url: URL naming the type
-
-    :type klass: type
-    :param klass: class to be used as a factory for the given type
-
-    :raises: ValueError if a registration already exists for the URL.
-    """
-    if type_url in _TYPE_URL_MAP:
-        if _TYPE_URL_MAP[type_url] is not klass:
-            raise ValueError("Conflict: %s" % (_TYPE_URL_MAP[type_url],))
-
-    _TYPE_URL_MAP[type_url] = klass
-
-
-class Operation(object):
-    """Representation of a Google API Long-Running Operation.
-
-    :type name: str
-    :param name: The fully-qualified path naming the operation.
-
-    :type client: object: must provide ``_operations_stub`` accessor.
-    :param client: The client used to poll for the status of the operation.
-
-    :type pb_metadata: object
-    :param pb_metadata: Instance of protobuf metadata class
-
-    :type kw: dict
-    :param kw: caller-assigned metadata about the operation
-    """
-
-    target = None
-    """Instance assocated with the operations:  callers may set."""
-
-    def __init__(self, name, client, pb_metadata=None, **kw):
-        self.name = name
-        self.client = client
-        self.pb_metadata = pb_metadata
-        self.metadata = kw.copy()
-        self._complete = False
-
-    @classmethod
-    def from_pb(cls, op_pb, client, **kw):
-        """Factory:  construct an instance from a protobuf.
-
-        :type op_pb: :class:`google.longrunning.operations_pb2.Operation`
-        :param op_pb: Protobuf to be parsed.
-
-        :type client: object: must provide ``_operations_stub`` accessor.
-        :param client: The client used to poll for the status of the operation.
-
-        :type kw: dict
-        :param kw: caller-assigned metadata about the operation
-
-        :rtype: :class:`Operation`
-        :returns: new instance, with attributes based on the protobuf.
-        """
-        pb_metadata = None
-        if op_pb.metadata.type_url:
-            type_url = op_pb.metadata.type_url
-            md_klass = _TYPE_URL_MAP.get(type_url)
-            if md_klass:
-                pb_metadata = md_klass.FromString(op_pb.metadata.value)
-        return cls(op_pb.name, client, pb_metadata, **kw)
-
-    @property
-    def complete(self):
-        """Has the operation already completed?
-
-        :rtype: bool
-        :returns: True if already completed, else false.
-        """
-        return self._complete
-
-    def poll(self):
-        """Check if the operation has finished.
-
-        :rtype: bool
-        :returns: A boolean indicating if the current operation has completed.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the operation
-                 has already completed.
-        """
-        if self.complete:
-            raise ValueError('The operation has completed.')
-
-        request_pb = operations_pb2.GetOperationRequest(name=self.name)
-        # We expect a `google.longrunning.operations_pb2.Operation`.
-        operation_pb = self.client._operations_stub.GetOperation(request_pb)
-
-        if operation_pb.done:
-            self._complete = True
-
-        return self.complete
diff --git a/google/cloud/pubsub/__init__.py b/google/cloud/pubsub/__init__.py
deleted file mode 100644
index 7eebf9a5f882..000000000000
--- a/google/cloud/pubsub/__init__.py
+++ /dev/null
@@ -1,33 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Google Cloud Pubsub API wrapper.
-
-The main concepts with this API are:
-
-- :class:`~google.cloud.pubsub.topic.Topic` represents an endpoint to which
-  messages can be published using the Cloud Storage Pubsub API.
-
-- :class:`~google.cloud.pubsub.subscription.Subscription` represents a named
-  subscription (either pull or push) to a topic.
-"""
-
-
-from google.cloud.pubsub.client import Client
-from google.cloud.pubsub.connection import Connection
-from google.cloud.pubsub.subscription import Subscription
-from google.cloud.pubsub.topic import Topic
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/pubsub/_gax.py b/google/cloud/pubsub/_gax.py
deleted file mode 100644
index c05d1f352518..000000000000
--- a/google/cloud/pubsub/_gax.py
+++ /dev/null
@@ -1,543 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""GAX wrapper for Pubsub API requests."""
-
-from google.cloud.gapic.pubsub.v1.publisher_api import PublisherApi
-from google.cloud.gapic.pubsub.v1.subscriber_api import SubscriberApi
-from google.gax import CallOptions
-from google.gax import INITIAL_PAGE
-from google.pubsub.v1.pubsub_pb2 import PubsubMessage
-from google.pubsub.v1.pubsub_pb2 import PushConfig
-from grpc import insecure_channel
-from grpc import StatusCode
-
-# pylint: disable=ungrouped-imports
-from google.cloud._helpers import _to_bytes
-from google.cloud._helpers import _pb_timestamp_to_rfc3339
-from google.cloud.exceptions import Conflict
-from google.cloud.exceptions import GrpcRendezvous
-from google.cloud.exceptions import NotFound
-# pylint: enable=ungrouped-imports
-
-
-class _PublisherAPI(object):
-    """Helper mapping publisher-related APIs.
-
-    :type gax_api: :class:`google.pubsub.v1.publisher_api.PublisherApi`
-    :param gax_api: API object used to make GAX requests.
-    """
-    def __init__(self, gax_api):
-        self._gax_api = gax_api
-
-    def list_topics(self, project, page_size=0, page_token=None):
-        """List topics for the project associated with this API.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/list
-
-        :type project: string
-        :param project: project ID
-
-        :type page_size: int
-        :param page_size: maximum number of topics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of topics. If not
-                           passed, the API will return the first page of
-                           topics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of ``Topic`` resource dicts, plus a
-                  "next page token" string:  if not None, indicates that
-                  more topics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        if page_token is None:
-            page_token = INITIAL_PAGE
-        options = CallOptions(page_token=page_token)
-        path = 'projects/%s' % (project,)
-        page_iter = self._gax_api.list_topics(
-            path, page_size=page_size, options=options)
-        topics = [{'name': topic_pb.name} for topic_pb in page_iter.next()]
-        token = page_iter.page_token or None
-        return topics, token
-
-    def topic_create(self, topic_path):
-        """API call:  create a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/create
-
-        :type topic_path: string
-        :param topic_path: fully-qualified path of the new topic, in format
-                            ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :rtype: dict
-        :returns: ``Topic`` resource returned from the API.
-        :raises: :exc:`google.cloud.exceptions.Conflict` if the topic already
-                    exists
-        """
-        try:
-            topic_pb = self._gax_api.create_topic(topic_path)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.FAILED_PRECONDITION:
-                raise Conflict(topic_path)
-            raise
-        return {'name': topic_pb.name}
-
-    def topic_get(self, topic_path):
-        """API call:  retrieve a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/get
-
-        :type topic_path: string
-        :param topic_path: fully-qualified path of the topic, in format
-                        ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :rtype: dict
-        :returns: ``Topic`` resource returned from the API.
-        :raises: :exc:`google.cloud.exceptions.NotFound` if the topic does not
-                    exist
-        """
-        try:
-            topic_pb = self._gax_api.get_topic(topic_path)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(topic_path)
-            raise
-        return {'name': topic_pb.name}
-
-    def topic_delete(self, topic_path):
-        """API call:  delete a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/create
-
-        :type topic_path: string
-        :param topic_path: fully-qualified path of the new topic, in format
-                            ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-        """
-        try:
-            self._gax_api.delete_topic(topic_path)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(topic_path)
-            raise
-
-    def topic_publish(self, topic_path, messages):
-        """API call:  publish one or more messages to a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/publish
-
-        :type topic_path: string
-        :param topic_path: fully-qualified path of the topic, in format
-                            ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :type messages: list of dict
-        :param messages: messages to be published.
-
-        :rtype: list of string
-        :returns: list of opaque IDs for published messages.
-        :raises: :exc:`google.cloud.exceptions.NotFound` if the topic does not
-                    exist
-        """
-        options = CallOptions(is_bundling=False)
-        message_pbs = [_message_pb_from_mapping(message)
-                       for message in messages]
-        try:
-            result = self._gax_api.publish(topic_path, message_pbs,
-                                           options=options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(topic_path)
-            raise
-        return result.message_ids
-
-    def topic_list_subscriptions(self, topic_path, page_size=0,
-                                 page_token=None):
-        """API call:  list subscriptions bound to a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics.subscriptions/list
-
-        :type topic_path: string
-        :param topic_path: fully-qualified path of the topic, in format
-                            ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :type page_size: int
-        :param page_size: maximum number of subscriptions to return, If not
-                          passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of subscriptions.
-                           If not passed, the API will return the first page
-                           of subscriptions.
-
-        :rtype: list of strings
-        :returns: fully-qualified names of subscriptions for the supplied
-                topic.
-        :raises: :exc:`google.cloud.exceptions.NotFound` if the topic does not
-                    exist
-        """
-        if page_token is None:
-            page_token = INITIAL_PAGE
-        options = CallOptions(page_token=page_token)
-        try:
-            page_iter = self._gax_api.list_topic_subscriptions(
-                topic_path, page_size=page_size, options=options)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(topic_path)
-            raise
-        subs = page_iter.next()
-        token = page_iter.page_token or None
-        return subs, token
-
-
-class _SubscriberAPI(object):
-    """Helper mapping subscriber-related APIs.
-
-    :type gax_api: :class:`google.pubsub.v1.publisher_api.SubscriberApi`
-    :param gax_api: API object used to make GAX requests.
-    """
-    def __init__(self, gax_api):
-        self._gax_api = gax_api
-
-    def list_subscriptions(self, project, page_size=0, page_token=None):
-        """List subscriptions for the project associated with this API.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/list
-
-        :type project: string
-        :param project: project ID
-
-        :type page_size: int
-        :param page_size: maximum number of subscriptions to return, If not
-                          passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of subscriptions.
-                           If not passed, the API will return the first page
-                           of subscriptions.
-
-        :rtype: tuple, (list, str)
-        :returns: list of ``Subscription`` resource dicts, plus a
-                  "next page token" string:  if not None, indicates that
-                  more topics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        if page_token is None:
-            page_token = INITIAL_PAGE
-        options = CallOptions(page_token=page_token)
-        path = 'projects/%s' % (project,)
-        page_iter = self._gax_api.list_subscriptions(
-            path, page_size=page_size, options=options)
-        subscriptions = [_subscription_pb_to_mapping(sub_pb)
-                         for sub_pb in page_iter.next()]
-        token = page_iter.page_token or None
-        return subscriptions, token
-
-    def subscription_create(self, subscription_path, topic_path,
-                            ack_deadline=None, push_endpoint=None):
-        """API call:  create a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/create
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the topic being
-                           subscribed, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :type ack_deadline: int, or ``NoneType``
-        :param ack_deadline: the deadline (in seconds) by which messages pulled
-                             from the back-end must be acknowledged.
-
-        :type push_endpoint: string, or ``NoneType``
-        :param push_endpoint: URL to which messages will be pushed by the
-                              back-end.  If not set, the application must pull
-                              messages.
-
-        :rtype: dict
-        :returns: ``Subscription`` resource returned from the API.
-        """
-        if push_endpoint is not None:
-            push_config = PushConfig(push_endpoint=push_endpoint)
-        else:
-            push_config = None
-
-        if ack_deadline is None:
-            ack_deadline = 0
-
-        try:
-            sub_pb = self._gax_api.create_subscription(
-                subscription_path, topic_path, push_config, ack_deadline)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.FAILED_PRECONDITION:
-                raise Conflict(topic_path)
-            raise
-        return _subscription_pb_to_mapping(sub_pb)
-
-    def subscription_get(self, subscription_path):
-        """API call:  retrieve a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/get
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the subscription,
-                                  in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :rtype: dict
-        :returns: ``Subscription`` resource returned from the API.
-        """
-        try:
-            sub_pb = self._gax_api.get_subscription(subscription_path)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(subscription_path)
-            raise
-        return _subscription_pb_to_mapping(sub_pb)
-
-    def subscription_delete(self, subscription_path):
-        """API call:  delete a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/delete
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the subscription,
-                                  in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-        """
-        try:
-            self._gax_api.delete_subscription(subscription_path)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(subscription_path)
-            raise
-
-    def subscription_modify_push_config(self, subscription_path,
-                                        push_endpoint):
-        """API call:  update push config of a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type push_endpoint: string, or ``NoneType``
-        :param push_endpoint: URL to which messages will be pushed by the
-                              back-end.  If not set, the application must pull
-                              messages.
-        """
-        push_config = PushConfig(push_endpoint=push_endpoint)
-        try:
-            self._gax_api.modify_push_config(subscription_path, push_config)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(subscription_path)
-            raise
-
-    def subscription_pull(self, subscription_path, return_immediately=False,
-                          max_messages=1):
-        """API call:  retrieve messages for a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type return_immediately: boolean
-        :param return_immediately: if True, the back-end returns even if no
-                                   messages are available;  if False, the API
-                                   call blocks until one or more messages are
-                                   available.
-
-        :type max_messages: int
-        :param max_messages: the maximum number of messages to return.
-
-        :rtype: list of dict
-        :returns:  the ``receivedMessages`` element of the response.
-        """
-        try:
-            response_pb = self._gax_api.pull(
-                subscription_path, max_messages, return_immediately)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(subscription_path)
-            raise
-        return [_received_message_pb_to_mapping(rmpb)
-                for rmpb in response_pb.received_messages]
-
-    def subscription_acknowledge(self, subscription_path, ack_ids):
-        """API call:  acknowledge retrieved messages
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type ack_ids: list of string
-        :param ack_ids: ack IDs of messages being acknowledged
-        """
-        try:
-            self._gax_api.acknowledge(subscription_path, ack_ids)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(subscription_path)
-            raise
-
-    def subscription_modify_ack_deadline(self, subscription_path, ack_ids,
-                                         ack_deadline):
-        """API call:  update ack deadline for retrieved messages
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyAckDeadline
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type ack_ids: list of string
-        :param ack_ids: ack IDs of messages being acknowledged
-
-        :type ack_deadline: int
-        :param ack_deadline: the deadline (in seconds) by which messages pulled
-                            from the back-end must be acknowledged.
-        """
-        try:
-            self._gax_api.modify_ack_deadline(
-                subscription_path, ack_ids, ack_deadline)
-        except GrpcRendezvous as exc:
-            if exc.code() == StatusCode.NOT_FOUND:
-                raise NotFound(subscription_path)
-            raise
-
-
-def _message_pb_from_mapping(message):
-    """Helper for :meth:`_PublisherAPI.topic_publish`.
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    return PubsubMessage(data=_to_bytes(message['data']),
-                         attributes=message['attributes'])
-
-
-def _subscription_pb_to_mapping(sub_pb):
-    """Helper for :meth:`list_subscriptions`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    mapping = {
-        'name': sub_pb.name,
-        'topic': sub_pb.topic,
-        'ackDeadlineSeconds': sub_pb.ack_deadline_seconds,
-    }
-    if sub_pb.push_config.push_endpoint != '':
-        mapping['pushConfig'] = {
-            'pushEndpoint': sub_pb.push_config.push_endpoint,
-        }
-    return mapping
-
-
-def _message_pb_to_mapping(message_pb):
-    """Helper for :meth:`pull`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    return {
-        'messageId': message_pb.message_id,
-        'data': message_pb.data,
-        'attributes': message_pb.attributes,
-        'publishTime': _pb_timestamp_to_rfc3339(message_pb.publish_time),
-    }
-
-
-def _received_message_pb_to_mapping(received_message_pb):
-    """Helper for :meth:`pull`, et aliae
-
-    Performs "impedance matching" between the protobuf attrs and the keys
-    expected in the JSON API.
-    """
-    return {
-        'ackId': received_message_pb.ack_id,
-        'message': _message_pb_to_mapping(
-            received_message_pb.message),
-    }
-
-
-def make_gax_publisher_api(connection):
-    """Create an instance of the GAX Publisher API.
-
-    If the ``connection`` is intended for a local emulator, then
-    an insecure ``channel`` is created pointing at the local
-    Pub / Sub server.
-
-    :type connection: :class:`~google.cloud.pubsub.connection.Connection`
-    :param connection: The connection that holds configuration details.
-
-    :rtype: :class:`~google.cloud.pubsub.v1.publisher_api.PublisherApi`
-    :returns: A publisher API instance with the proper connection
-              configuration.
-    :rtype: :class:`~google.cloud.pubsub.v1.subscriber_api.SubscriberApi`
-    """
-    channel = None
-    if connection.in_emulator:
-        channel = insecure_channel(connection.host)
-    return PublisherApi(channel=channel)
-
-
-def make_gax_subscriber_api(connection):
-    """Create an instance of the GAX Subscriber API.
-
-    If the ``connection`` is intended for a local emulator, then
-    an insecure ``channel`` is created pointing at the local
-    Pub / Sub server.
-
-    :type connection: :class:`~google.cloud.pubsub.connection.Connection`
-    :param connection: The connection that holds configuration details.
-
-    :rtype: :class:`~google.cloud.pubsub.v1.subscriber_api.SubscriberApi`
-    :returns: A subscriber API instance with the proper connection
-              configuration.
-    """
-    channel = None
-    if connection.in_emulator:
-        channel = insecure_channel(connection.host)
-    return SubscriberApi(channel=channel)
diff --git a/google/cloud/pubsub/_helpers.py b/google/cloud/pubsub/_helpers.py
deleted file mode 100644
index 6aff209195c5..000000000000
--- a/google/cloud/pubsub/_helpers.py
+++ /dev/null
@@ -1,73 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Helper functions for shared behavior."""
-
-import re
-
-from google.cloud._helpers import _name_from_project_path
-
-
-_TOPIC_TEMPLATE = re.compile(r"""
-    projects/            # static prefix
-    (?P<project>[^/]+)   # initial letter, wordchars + hyphen
-    /topics/             # static midfix
-    (?P<name>[^/]+)      # initial letter, wordchars + allowed punc
-""", re.VERBOSE)
-
-
-_SUBSCRIPTION_TEMPLATE = re.compile(r"""
-    projects/            # static prefix
-    (?P<project>[^/]+)   # initial letter, wordchars + hyphen
-    /subscriptions/      # static midfix
-    (?P<name>[^/]+)      # initial letter, wordchars + allowed punc
-""", re.VERBOSE)
-
-
-def topic_name_from_path(path, project):
-    """Validate a topic URI path and get the topic name.
-
-    :type path: string
-    :param path: URI path for a topic API request.
-
-    :type project: string
-    :param project: The project associated with the request. It is
-                    included for validation purposes.
-
-    :rtype: string
-    :returns: Topic name parsed from ``path``.
-    :raises: :class:`ValueError` if the ``path`` is ill-formed or if
-             the project from the ``path`` does not agree with the
-             ``project`` passed in.
-    """
-    return _name_from_project_path(path, project, _TOPIC_TEMPLATE)
-
-
-def subscription_name_from_path(path, project):
-    """Validate a subscription URI path and get the subscription name.
-
-    :type path: string
-    :param path: URI path for a subscription API request.
-
-    :type project: string
-    :param project: The project associated with the request. It is
-                    included for validation purposes.
-
-    :rtype: string
-    :returns: subscription name parsed from ``path``.
-    :raises: :class:`ValueError` if the ``path`` is ill-formed or if
-             the project from the ``path`` does not agree with the
-             ``project`` passed in.
-    """
-    return _name_from_project_path(path, project, _SUBSCRIPTION_TEMPLATE)
diff --git a/google/cloud/pubsub/client.py b/google/cloud/pubsub/client.py
deleted file mode 100644
index ae77eb14b389..000000000000
--- a/google/cloud/pubsub/client.py
+++ /dev/null
@@ -1,190 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Client for interacting with the Google Cloud Pub/Sub API."""
-
-import os
-
-from google.cloud.client import JSONClient
-from google.cloud.environment_vars import DISABLE_GRPC
-from google.cloud.pubsub.connection import Connection
-from google.cloud.pubsub.connection import _PublisherAPI as JSONPublisherAPI
-from google.cloud.pubsub.connection import _SubscriberAPI as JSONSubscriberAPI
-from google.cloud.pubsub.connection import _IAMPolicyAPI
-from google.cloud.pubsub.subscription import Subscription
-from google.cloud.pubsub.topic import Topic
-
-# pylint: disable=ungrouped-imports
-try:
-    from google.cloud.pubsub._gax import _PublisherAPI as GAXPublisherAPI
-    from google.cloud.pubsub._gax import _SubscriberAPI as GAXSubscriberAPI
-    from google.cloud.pubsub._gax import make_gax_publisher_api
-    from google.cloud.pubsub._gax import make_gax_subscriber_api
-except ImportError:  # pragma: NO COVER
-    _HAVE_GAX = False
-    GAXPublisherAPI = None
-    GAXSubscriberAPI = None
-    make_gax_publisher_api = None
-    make_gax_subscriber_api = None
-else:
-    _HAVE_GAX = True
-# pylint: enable=ungrouped-imports
-
-
-_DISABLE_GAX = os.getenv(DISABLE_GRPC, False)
-_USE_GAX = _HAVE_GAX and not _DISABLE_GAX
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: string
-    :param project: the project which the client acts on behalf of. Will be
-                    passed when creating a topic.  If not passed,
-                    falls back to the default inferred from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-    _publisher_api = _subscriber_api = _iam_policy_api = None
-
-    @property
-    def publisher_api(self):
-        """Helper for publisher-related API calls."""
-        if self._publisher_api is None:
-            if _USE_GAX:
-                generated = make_gax_publisher_api(self.connection)
-                self._publisher_api = GAXPublisherAPI(generated)
-            else:
-                self._publisher_api = JSONPublisherAPI(self.connection)
-        return self._publisher_api
-
-    @property
-    def subscriber_api(self):
-        """Helper for subscriber-related API calls."""
-        if self._subscriber_api is None:
-            if _USE_GAX:
-                generated = make_gax_subscriber_api(self.connection)
-                self._subscriber_api = GAXSubscriberAPI(generated)
-            else:
-                self._subscriber_api = JSONSubscriberAPI(self.connection)
-        return self._subscriber_api
-
-    @property
-    def iam_policy_api(self):
-        """Helper for IAM policy-related API calls."""
-        if self._iam_policy_api is None:
-            self._iam_policy_api = _IAMPolicyAPI(self.connection)
-        return self._iam_policy_api
-
-    def list_topics(self, page_size=None, page_token=None):
-        """List topics for the project associated with this client.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/list
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START client_list_topics]
-           :end-before: [END client_list_topics]
-
-        :type page_size: int
-        :param page_size: maximum number of topics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of topics. If not
-                           passed, the API will return the first page of
-                           topics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`google.cloud.pubsub.topic.Topic`, plus a
-                  "next page token" string:  if not None, indicates that
-                  more topics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        api = self.publisher_api
-        resources, next_token = api.list_topics(
-            self.project, page_size, page_token)
-        topics = [Topic.from_api_repr(resource, self)
-                  for resource in resources]
-        return topics, next_token
-
-    def list_subscriptions(self, page_size=None, page_token=None):
-        """List subscriptions for the project associated with this client.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/list
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START client_list_subscriptions]
-           :end-before: [END client_list_subscriptions]
-
-        :type page_size: int
-        :param page_size: maximum number of topics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of topics. If not
-                           passed, the API will return the first page of
-                           topics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`~.pubsub.subscription.Subscription`,
-                  plus a "next page token" string:  if not None, indicates that
-                  more topics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        api = self.subscriber_api
-        resources, next_token = api.list_subscriptions(
-            self.project, page_size, page_token)
-        topics = {}
-        subscriptions = [Subscription.from_api_repr(resource, self,
-                                                    topics=topics)
-                         for resource in resources]
-        return subscriptions, next_token
-
-    def topic(self, name, timestamp_messages=False):
-        """Creates a topic bound to the current client.
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START client_topic]
-           :end-before: [END client_topic]
-
-        :type name: string
-        :param name: the name of the topic to be constructed.
-
-        :type timestamp_messages: boolean
-        :param timestamp_messages: To be passed to ``Topic`` constructor.
-
-        :rtype: :class:`google.cloud.pubsub.topic.Topic`
-        :returns: Topic created with the current client.
-        """
-        return Topic(name, client=self, timestamp_messages=timestamp_messages)
diff --git a/google/cloud/pubsub/connection.py b/google/cloud/pubsub/connection.py
deleted file mode 100644
index 41db9ba7f80f..000000000000
--- a/google/cloud/pubsub/connection.py
+++ /dev/null
@@ -1,541 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Create / interact with Google Cloud Pub/Sub connections."""
-
-import os
-
-from google.cloud import connection as base_connection
-from google.cloud.environment_vars import PUBSUB_EMULATOR
-
-
-PUBSUB_API_HOST = 'pubsub.googleapis.com'
-"""Pub / Sub API request host."""
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Pub/Sub via the JSON REST API.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: (Optional) HTTP object to make requests.
-    """
-
-    API_BASE_URL = 'https://' + PUBSUB_API_HOST
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/pubsub',
-             'https://www.googleapis.com/auth/cloud-platform')
-    """The scopes required for authenticating as a Cloud Pub/Sub consumer."""
-
-    def __init__(self, credentials=None, http=None):
-        super(Connection, self).__init__(credentials=credentials, http=http)
-        emulator_host = os.getenv(PUBSUB_EMULATOR)
-        if emulator_host is None:
-            self.host = self.__class__.API_BASE_URL
-            self.api_base_url = self.__class__.API_BASE_URL
-            self.in_emulator = False
-        else:
-            self.host = emulator_host
-            self.api_base_url = 'http://' + emulator_host
-            self.in_emulator = True
-
-    def build_api_url(self, path, query_params=None,
-                      api_base_url=None, api_version=None):
-        """Construct an API url given a few components, some optional.
-
-        Typically, you shouldn't need to use this method.
-
-        :type path: string
-        :param path: The path to the resource.
-
-        :type query_params: dict or list
-        :param query_params: A dictionary of keys and values (or list of
-                             key-value pairs) to insert into the query
-                             string of the URL.
-
-        :type api_base_url: string
-        :param api_base_url: The base URL for the API endpoint.
-                             Typically you won't have to provide this.
-
-        :type api_version: string
-        :param api_version: The version of the API to call.
-                            Typically you shouldn't provide this and instead
-                            use the default for the library.
-
-        :rtype: string
-        :returns: The URL assembled from the pieces provided.
-        """
-        if api_base_url is None:
-            api_base_url = self.api_base_url
-        return super(Connection, self.__class__).build_api_url(
-            path, query_params=query_params,
-            api_base_url=api_base_url, api_version=api_version)
-
-
-class _PublisherAPI(object):
-    """Helper mapping publisher-related APIs.
-
-    :type connection: :class:`Connection`
-    :param connection: the connection used to make API requests.
-    """
-
-    def __init__(self, connection):
-        self._connection = connection
-
-    def list_topics(self, project, page_size=None, page_token=None):
-        """API call:  list topics for a given project
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/list
-
-        :type project: string
-        :param project: project ID
-
-        :type page_size: int
-        :param page_size: maximum number of topics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of topics. If not
-                           passed, the API will return the first page of
-                           topics.
-
-        :rtype: tuple, (list, str)
-        :returns: list of ``Topic`` resource dicts, plus a
-                  "next page token" string:  if not None, indicates that
-                  more topics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        conn = self._connection
-        params = {}
-
-        if page_size is not None:
-            params['pageSize'] = page_size
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/topics' % (project,)
-        resp = conn.api_request(method='GET', path=path, query_params=params)
-        return resp.get('topics', ()), resp.get('nextPageToken')
-
-    def topic_create(self, topic_path):
-        """API call:  create a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/create
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the new topic, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :rtype: dict
-        :returns: ``Topic`` resource returned from the API.
-        """
-        conn = self._connection
-        return conn.api_request(method='PUT', path='/%s' % (topic_path,))
-
-    def topic_get(self, topic_path):
-        """API call:  retrieve a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/get
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the topic, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :rtype: dict
-        :returns: ``Topic`` resource returned from the API.
-        """
-        conn = self._connection
-        return conn.api_request(method='GET', path='/%s' % (topic_path,))
-
-    def topic_delete(self, topic_path):
-        """API call:  delete a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/delete
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the topic, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-        """
-        conn = self._connection
-        conn.api_request(method='DELETE', path='/%s' % (topic_path,))
-
-    def topic_publish(self, topic_path, messages):
-        """API call:  publish one or more messages to a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/publish
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the topic, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :type messages: list of dict
-        :param messages: messages to be published.
-
-        :rtype: list of string
-        :returns: list of opaque IDs for published messages.
-        """
-        conn = self._connection
-        data = {'messages': messages}
-        response = conn.api_request(
-            method='POST', path='/%s:publish' % (topic_path,), data=data)
-        return response['messageIds']
-
-    def topic_list_subscriptions(self, topic_path, page_size=None,
-                                 page_token=None):
-        """API call:  list subscriptions bound to a topic
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics.subscriptions/list
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the topic, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :type page_size: int
-        :param page_size: maximum number of subscriptions to return, If not
-                          passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of topics. If not
-                           passed, the API will return the first page of
-                           topics.
-
-        :rtype: list of strings
-        :returns: fully-qualified names of subscriptions for the supplied
-                  topic.
-        """
-        conn = self._connection
-        params = {}
-
-        if page_size is not None:
-            params['pageSize'] = page_size
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/%s/subscriptions' % (topic_path,)
-        resp = conn.api_request(method='GET', path=path, query_params=params)
-        return resp.get('subscriptions', ()), resp.get('nextPageToken')
-
-
-class _SubscriberAPI(object):
-    """Helper mapping subscriber-related APIs.
-
-    :type connection: :class:`Connection`
-    :param connection: the connection used to make API requests.
-    """
-
-    def __init__(self, connection):
-        self._connection = connection
-
-    def list_subscriptions(self, project, page_size=None, page_token=None):
-        """API call:  list subscriptions for a given project
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/list
-
-        :type project: string
-        :param project: project ID
-
-        :type page_size: int
-        :param page_size: maximum number of subscriptions to return, If not
-                          passed, defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of subscriptions.
-                           If not passed, the API will return the first page
-                           of subscriptions.
-
-        :rtype: tuple, (list, str)
-        :returns: list of ``Subscription`` resource dicts, plus a
-                  "next page token" string:  if not None, indicates that
-                  more subscriptions can be retrieved with another call (pass
-                  that value as ``page_token``).
-        """
-        conn = self._connection
-        params = {}
-
-        if page_size is not None:
-            params['pageSize'] = page_size
-
-        if page_token is not None:
-            params['pageToken'] = page_token
-
-        path = '/projects/%s/subscriptions' % (project,)
-        resp = conn.api_request(method='GET', path=path, query_params=params)
-        return resp.get('subscriptions', ()), resp.get('nextPageToken')
-
-    def subscription_create(self, subscription_path, topic_path,
-                            ack_deadline=None, push_endpoint=None):
-        """API call:  create a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/create
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type topic_path: string
-        :param topic_path: the fully-qualified path of the topic being
-                           subscribed, in format
-                           ``projects/<PROJECT>/topics/<TOPIC_NAME>``.
-
-        :type ack_deadline: int, or ``NoneType``
-        :param ack_deadline: the deadline (in seconds) by which messages pulled
-                            from the back-end must be acknowledged.
-
-        :type push_endpoint: string, or ``NoneType``
-        :param push_endpoint: URL to which messages will be pushed by the
-                              back-end.  If not set, the application must pull
-                              messages.
-
-        :rtype: dict
-        :returns: ``Subscription`` resource returned from the API.
-        """
-        conn = self._connection
-        path = '/%s' % (subscription_path,)
-        resource = {'topic': topic_path}
-
-        if ack_deadline is not None:
-            resource['ackDeadlineSeconds'] = ack_deadline
-
-        if push_endpoint is not None:
-            resource['pushConfig'] = {'pushEndpoint': push_endpoint}
-
-        return conn.api_request(method='PUT', path=path, data=resource)
-
-    def subscription_get(self, subscription_path):
-        """API call:  retrieve a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/get
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the subscription,
-                                  in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :rtype: dict
-        :returns: ``Subscription`` resource returned from the API.
-        """
-        conn = self._connection
-        path = '/%s' % (subscription_path,)
-        return conn.api_request(method='GET', path=path)
-
-    def subscription_delete(self, subscription_path):
-        """API call:  delete a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/delete
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the subscription,
-                                  in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-        """
-        conn = self._connection
-        path = '/%s' % (subscription_path,)
-        conn.api_request(method='DELETE', path=path)
-
-    def subscription_modify_push_config(self, subscription_path,
-                                        push_endpoint):
-        """API call:  update push config of a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type push_endpoint: string, or ``NoneType``
-        :param push_endpoint: URL to which messages will be pushed by the
-                              back-end.  If not set, the application must pull
-                              messages.
-        """
-        conn = self._connection
-        path = '/%s:modifyPushConfig' % (subscription_path,)
-        resource = {'pushConfig': {'pushEndpoint': push_endpoint}}
-        conn.api_request(method='POST', path=path, data=resource)
-
-    def subscription_pull(self, subscription_path, return_immediately=False,
-                          max_messages=1):
-        """API call:  retrieve messages for a subscription
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type return_immediately: boolean
-        :param return_immediately: if True, the back-end returns even if no
-                                   messages are available;  if False, the API
-                                   call blocks until one or more messages are
-                                   available.
-
-        :type max_messages: int
-        :param max_messages: the maximum number of messages to return.
-
-        :rtype: list of dict
-        :returns:  the ``receivedMessages`` element of the response.
-        """
-        conn = self._connection
-        path = '/%s:pull' % (subscription_path,)
-        data = {
-            'returnImmediately': return_immediately,
-            'maxMessages': max_messages,
-        }
-        response = conn.api_request(method='POST', path=path, data=data)
-        return response.get('receivedMessages', ())
-
-    def subscription_acknowledge(self, subscription_path, ack_ids):
-        """API call:  acknowledge retrieved messages
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type ack_ids: list of string
-        :param ack_ids: ack IDs of messages being acknowledged
-        """
-        conn = self._connection
-        path = '/%s:acknowledge' % (subscription_path,)
-        data = {
-            'ackIds': ack_ids,
-        }
-        conn.api_request(method='POST', path=path, data=data)
-
-    def subscription_modify_ack_deadline(self, subscription_path, ack_ids,
-                                         ack_deadline):
-        """API call:  update ack deadline for retrieved messages
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyAckDeadline
-
-        :type subscription_path: string
-        :param subscription_path: the fully-qualified path of the new
-                                  subscription, in format
-                                  ``projects/<PROJECT>/subscriptions/<SUB_NAME>``.
-
-        :type ack_ids: list of string
-        :param ack_ids: ack IDs of messages being acknowledged
-
-        :type ack_deadline: int
-        :param ack_deadline: the deadline (in seconds) by which messages pulled
-                            from the back-end must be acknowledged.
-        """
-        conn = self._connection
-        path = '/%s:modifyAckDeadline' % (subscription_path,)
-        data = {
-            'ackIds': ack_ids,
-            'ackDeadlineSeconds': ack_deadline,
-        }
-        conn.api_request(method='POST', path=path, data=data)
-
-
-class _IAMPolicyAPI(object):
-    """Helper mapping IAM policy-related APIs.
-
-    :type connection: :class:`Connection`
-    :param connection: the connection used to make API requests.
-    """
-
-    def __init__(self, connection):
-        self._connection = connection
-
-    def get_iam_policy(self, target_path):
-        """API call:  fetch the IAM policy for the target
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/getIamPolicy
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/getIamPolicy
-
-        :type target_path: string
-        :param target_path: the path of the target object.
-
-        :rtype: dict
-        :returns: the resource returned by the ``getIamPolicy`` API request.
-        """
-        conn = self._connection
-        path = '/%s:getIamPolicy' % (target_path,)
-        return conn.api_request(method='GET', path=path)
-
-    def set_iam_policy(self, target_path, policy):
-        """API call:  update the IAM policy for the target
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/setIamPolicy
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/setIamPolicy
-
-        :type target_path: string
-        :param target_path: the path of the target object.
-
-        :type policy: dict
-        :param policy: the new policy resource.
-
-        :rtype: dict
-        :returns: the resource returned by the ``setIamPolicy`` API request.
-        """
-        conn = self._connection
-        wrapped = {'policy': policy}
-        path = '/%s:setIamPolicy' % (target_path,)
-        return conn.api_request(method='POST', path=path, data=wrapped)
-
-    def test_iam_permissions(self, target_path, permissions):
-        """API call:  test permissions
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/testIamPermissions
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/testIamPermissions
-
-        :type target_path: string
-        :param target_path: the path of the target object.
-
-        :type permissions: list of string
-        :param permissions: the permissions to check
-
-        :rtype: dict
-        :returns: the resource returned by the ``getIamPolicy`` API request.
-        """
-        conn = self._connection
-        wrapped = {'permissions': permissions}
-        path = '/%s:testIamPermissions' % (target_path,)
-        resp = conn.api_request(method='POST', path=path, data=wrapped)
-        return resp.get('permissions', [])
diff --git a/google/cloud/pubsub/iam.py b/google/cloud/pubsub/iam.py
deleted file mode 100644
index 72fb07957cb8..000000000000
--- a/google/cloud/pubsub/iam.py
+++ /dev/null
@@ -1,259 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-"""PubSub API IAM policy definitions
-
-For allowed roles / permissions, see:
-https://cloud.google.com/pubsub/access_control#permissions
-"""
-
-# Generic IAM roles
-
-OWNER_ROLE = 'roles/owner'
-"""Generic role implying all rights to an object."""
-
-EDITOR_ROLE = 'roles/editor'
-"""Generic role implying rights to modify an object."""
-
-VIEWER_ROLE = 'roles/viewer'
-"""Generic role implying rights to access an object."""
-
-# Pubsub-specific IAM roles
-
-PUBSUB_ADMIN_ROLE = 'roles/pubsub.admin'
-"""Role implying all rights to an object."""
-
-PUBSUB_EDITOR_ROLE = 'roles/pubsub.editor'
-"""Role implying rights to modify an object."""
-
-PUBSUB_VIEWER_ROLE = 'roles/pubsub.viewer'
-"""Role implying rights to access an object."""
-
-PUBSUB_PUBLISHER_ROLE = 'roles/pubsub.publisher'
-"""Role implying rights to publish to a topic."""
-
-PUBSUB_SUBSCRIBER_ROLE = 'roles/pubsub.subscriber'
-"""Role implying rights to subscribe to a topic."""
-
-
-# Pubsub-specific permissions
-
-PUBSUB_TOPICS_CONSUME = 'pubsub.topics.consume'
-"""Permission: consume events from a subscription."""
-
-PUBSUB_TOPICS_CREATE = 'pubsub.topics.create'
-"""Permission: create topics."""
-
-PUBSUB_TOPICS_DELETE = 'pubsub.topics.delete'
-"""Permission: delete topics."""
-
-PUBSUB_TOPICS_GET = 'pubsub.topics.get'
-"""Permission: retrieve topics."""
-
-PUBSUB_TOPICS_GET_IAM_POLICY = 'pubsub.topics.getIamPolicy'
-"""Permission: retrieve subscription IAM policies."""
-
-PUBSUB_TOPICS_LIST = 'pubsub.topics.list'
-"""Permission: list topics."""
-
-PUBSUB_TOPICS_SET_IAM_POLICY = 'pubsub.topics.setIamPolicy'
-"""Permission: update subscription IAM policies."""
-
-PUBSUB_SUBSCRIPTIONS_CONSUME = 'pubsub.subscriptions.consume'
-"""Permission: consume events from a subscription."""
-
-PUBSUB_SUBSCRIPTIONS_CREATE = 'pubsub.subscriptions.create'
-"""Permission: create subscriptions."""
-
-PUBSUB_SUBSCRIPTIONS_DELETE = 'pubsub.subscriptions.delete'
-"""Permission: delete subscriptions."""
-
-PUBSUB_SUBSCRIPTIONS_GET = 'pubsub.subscriptions.get'
-"""Permission: retrieve subscriptions."""
-
-PUBSUB_SUBSCRIPTIONS_GET_IAM_POLICY = 'pubsub.subscriptions.getIamPolicy'
-"""Permission: retrieve subscription IAM policies."""
-
-PUBSUB_SUBSCRIPTIONS_LIST = 'pubsub.subscriptions.list'
-"""Permission: list subscriptions."""
-
-PUBSUB_SUBSCRIPTIONS_SET_IAM_POLICY = 'pubsub.subscriptions.setIamPolicy'
-"""Permission: update subscription IAM policies."""
-
-PUBSUB_SUBSCRIPTIONS_UPDATE = 'pubsub.subscriptions.update'
-"""Permission: update subscriptions."""
-
-
-class Policy(object):
-    """Combined IAM Policy / Bindings.
-
-    See:
-    https://cloud.google.com/pubsub/reference/rest/Shared.Types/Policy
-    https://cloud.google.com/pubsub/reference/rest/Shared.Types/Binding
-
-    :type etag: string
-    :param etag: ETag used to identify a unique of the policy
-
-    :type version: int
-    :param version: unique version of the policy
-    """
-    def __init__(self, etag=None, version=None):
-        self.etag = etag
-        self.version = version
-        self.owners = set()
-        self.editors = set()
-        self.viewers = set()
-        self.publishers = set()
-        self.subscribers = set()
-
-    @staticmethod
-    def user(email):
-        """Factory method for a user member.
-
-        :type email: string
-        :param email: E-mail for this particular user.
-
-        :rtype: string
-        :returns: A member string corresponding to the given user.
-        """
-        return 'user:%s' % (email,)
-
-    @staticmethod
-    def service_account(email):
-        """Factory method for a service account member.
-
-        :type email: string
-        :param email: E-mail for this particular service account.
-
-        :rtype: string
-        :returns: A member string corresponding to the given service account.
-        """
-        return 'serviceAccount:%s' % (email,)
-
-    @staticmethod
-    def group(email):
-        """Factory method for a group member.
-
-        :type email: string
-        :param email: An id or e-mail for this particular group.
-
-        :rtype: string
-        :returns: A member string corresponding to the given group.
-        """
-        return 'group:%s' % (email,)
-
-    @staticmethod
-    def domain(domain):
-        """Factory method for a domain member.
-
-        :type domain: string
-        :param domain: The domain for this member.
-
-        :rtype: string
-        :returns: A member string corresponding to the given domain.
-        """
-        return 'domain:%s' % (domain,)
-
-    @staticmethod
-    def all_users():
-        """Factory method for a member representing all users.
-
-        :rtype: string
-        :returns: A member string representing all users.
-        """
-        return 'allUsers'
-
-    @staticmethod
-    def authenticated_users():
-        """Factory method for a member representing all authenticated users.
-
-        :rtype: string
-        :returns: A member string representing all authenticated users.
-        """
-        return 'allAuthenticatedUsers'
-
-    @classmethod
-    def from_api_repr(cls, resource):
-        """Create a policy from the resource returned from the API.
-
-        :type resource: dict
-        :param resource: resource returned from the ``getIamPolicy`` API.
-
-        :rtype: :class:`Policy`
-        :returns: the parsed policy
-        """
-        version = resource.get('version')
-        etag = resource.get('etag')
-        policy = cls(etag, version)
-        for binding in resource.get('bindings', ()):
-            role = binding['role']
-            members = set(binding['members'])
-            if role in (OWNER_ROLE, PUBSUB_ADMIN_ROLE):
-                policy.owners |= members
-            elif role in (EDITOR_ROLE, PUBSUB_EDITOR_ROLE):
-                policy.editors |= members
-            elif role in (VIEWER_ROLE, PUBSUB_VIEWER_ROLE):
-                policy.viewers |= members
-            elif role == PUBSUB_PUBLISHER_ROLE:
-                policy.publishers |= members
-            elif role == PUBSUB_SUBSCRIBER_ROLE:
-                policy.subscribers |= members
-            else:
-                raise ValueError('Unknown role: %s' % (role,))
-        return policy
-
-    def to_api_repr(self):
-        """Construct a Policy resource.
-
-        :rtype: dict
-        :returns: a resource to be passed to the ``setIamPolicy`` API.
-        """
-        resource = {}
-
-        if self.etag is not None:
-            resource['etag'] = self.etag
-
-        if self.version is not None:
-            resource['version'] = self.version
-
-        bindings = []
-
-        if self.owners:
-            bindings.append(
-                {'role': PUBSUB_ADMIN_ROLE,
-                 'members': sorted(self.owners)})
-
-        if self.editors:
-            bindings.append(
-                {'role': PUBSUB_EDITOR_ROLE,
-                 'members': sorted(self.editors)})
-
-        if self.viewers:
-            bindings.append(
-                {'role': PUBSUB_VIEWER_ROLE,
-                 'members': sorted(self.viewers)})
-
-        if self.publishers:
-            bindings.append(
-                {'role': PUBSUB_PUBLISHER_ROLE,
-                 'members': sorted(self.publishers)})
-
-        if self.subscribers:
-            bindings.append(
-                {'role': PUBSUB_SUBSCRIBER_ROLE,
-                 'members': sorted(self.subscribers)})
-
-        if bindings:
-            resource['bindings'] = bindings
-
-        return resource
diff --git a/google/cloud/pubsub/message.py b/google/cloud/pubsub/message.py
deleted file mode 100644
index d1e3c83b4aaa..000000000000
--- a/google/cloud/pubsub/message.py
+++ /dev/null
@@ -1,93 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Topics."""
-
-import base64
-
-from google.cloud._helpers import _rfc3339_to_datetime
-
-
-class Message(object):
-    """Messages can be published to a topic and received by subscribers.
-
-    See:
-    https://cloud.google.com/pubsub/reference/rest/v1/PubsubMessage
-
-    :type data: bytes
-    :param data: the payload of the message.
-
-    :type message_id: string
-    :param message_id: An ID assigned to the message by the API.
-
-    :type attributes: dict or None
-    :param attributes: Extra metadata associated by the publisher with the
-                       message.
-    """
-    _service_timestamp = None
-
-    def __init__(self, data, message_id, attributes=None):
-        self.data = data
-        self.message_id = message_id
-        self._attributes = attributes
-
-    @property
-    def attributes(self):
-        """Lazily-constructed attribute dictionary."""
-        if self._attributes is None:
-            self._attributes = {}
-        return self._attributes
-
-    @property
-    def timestamp(self):
-        """Return sortable timestamp from attributes, if passed.
-
-        Allows sorting messages in publication order (assuming consistent
-        clocks across all publishers).
-
-        :rtype: :class:`datetime.datetime`
-        :returns: timestamp (in UTC timezone) parsed from RFC 3339 timestamp
-        :raises: ValueError if timestamp not in ``attributes``, or if it does
-                 not match the RFC 3339 format.
-        """
-        stamp = self.attributes.get('timestamp')
-        if stamp is None:
-            raise ValueError('No timestamp')
-        return _rfc3339_to_datetime(stamp)
-
-    @property
-    def service_timestamp(self):
-        """Return server-set timestamp.
-
-        :rtype: string
-        :returns: timestamp (in UTC timezone) in RFC 3339 format
-        """
-        return self._service_timestamp
-
-    @classmethod
-    def from_api_repr(cls, api_repr):
-        """Factory:  construct message from API representation.
-
-        :type api_repr: dict or None
-        :param api_repr: The API representation of the message
-
-        :rtype: :class:`Message`
-        :returns: The message created from the response.
-        """
-        data = base64.b64decode(api_repr.get('data', b''))
-        instance = cls(
-            data=data, message_id=api_repr['messageId'],
-            attributes=api_repr.get('attributes'))
-        instance._service_timestamp = api_repr.get('publishTimestamp')
-        return instance
diff --git a/google/cloud/pubsub/subscription.py b/google/cloud/pubsub/subscription.py
deleted file mode 100644
index 82335d54181d..000000000000
--- a/google/cloud/pubsub/subscription.py
+++ /dev/null
@@ -1,509 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Subscriptions."""
-
-from google.cloud.exceptions import NotFound
-from google.cloud.pubsub._helpers import topic_name_from_path
-from google.cloud.pubsub.iam import Policy
-from google.cloud.pubsub.message import Message
-
-
-class Subscription(object):
-    """Subscriptions receive messages published to their topics.
-
-    See:
-    https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions
-
-    :type name: string
-    :param name: the name of the subscription.
-
-    :type topic: :class:`google.cloud.pubsub.topic.Topic` or ``NoneType``
-    :param topic: the topic to which the subscription belongs;  if ``None``,
-                  the subscription's topic has been deleted.
-
-    :type ack_deadline: int
-    :param ack_deadline: the deadline (in seconds) by which messages pulled
-                         from the back-end must be acknowledged.
-
-    :type push_endpoint: string
-    :param push_endpoint: URL to which messages will be pushed by the back-end.
-                          If not set, the application must pull messages.
-
-    :type client: :class:`~google.cloud.pubsub.client.Client` or
-                  ``NoneType``
-    :param client: the client to use.  If not passed, falls back to the
-                   ``client`` stored on the topic.
-    """
-
-    _DELETED_TOPIC_PATH = '_deleted-topic_'
-    """Value of ``projects.subscriptions.topic`` when topic has been deleted.
-
-    See:
-    https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions#Subscription.FIELDS.topic
-    """
-
-    def __init__(self, name, topic=None, ack_deadline=None, push_endpoint=None,
-                 client=None):
-
-        if client is None and topic is None:
-            raise TypeError("Pass only one of 'topic' or 'client'.")
-
-        if client is not None and topic is not None:
-            raise TypeError("Pass only one of 'topic' or 'client'.")
-
-        self.name = name
-        self.topic = topic
-        self._client = client or topic._client
-        self._project = self._client.project
-        self.ack_deadline = ack_deadline
-        self.push_endpoint = push_endpoint
-
-    @classmethod
-    def from_api_repr(cls, resource, client, topics=None):
-        """Factory:  construct a topic given its API representation
-
-        :type resource: dict
-        :param resource: topic resource representation returned from the API.
-
-        :type client: :class:`google.cloud.pubsub.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for a topic.
-
-        :type topics: dict or None
-        :param topics: A mapping of topic names -> topics.  If not passed,
-                       the subscription will have a newly-created topic.
-
-        :rtype: :class:`google.cloud.pubsub.subscription.Subscription`
-        :returns: Subscription parsed from ``resource``.
-        """
-        if topics is None:
-            topics = {}
-        topic_path = resource['topic']
-        if topic_path == cls._DELETED_TOPIC_PATH:
-            topic = None
-        else:
-            topic = topics.get(topic_path)
-            if topic is None:
-                # NOTE: This duplicates behavior from Topic.from_api_repr to
-                #       avoid an import cycle.
-                topic_name = topic_name_from_path(topic_path, client.project)
-                topic = topics[topic_path] = client.topic(topic_name)
-        _, _, _, name = resource['name'].split('/')
-        ack_deadline = resource.get('ackDeadlineSeconds')
-        push_config = resource.get('pushConfig', {})
-        push_endpoint = push_config.get('pushEndpoint')
-        if topic is None:
-            return cls(name, ack_deadline=ack_deadline,
-                       push_endpoint=push_endpoint, client=client)
-        return cls(name, topic, ack_deadline, push_endpoint)
-
-    @property
-    def project(self):
-        """Project bound to the subscription."""
-        return self._client.project
-
-    @property
-    def full_name(self):
-        """Fully-qualified name used in subscription APIs"""
-        return 'projects/%s/subscriptions/%s' % (self.project, self.name)
-
-    @property
-    def path(self):
-        """URL path for the subscription's APIs"""
-        return '/%s' % (self.full_name,)
-
-    def auto_ack(self, return_immediately=False, max_messages=1, client=None):
-        """:class:`AutoAck` factory
-
-        :type return_immediately: boolean
-        :param return_immediately: passed through to :meth:`Subscription.pull`
-
-        :type max_messages: int
-        :param max_messages: passed through to :meth:`Subscription.pull`
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: passed through to :meth:`Subscription.pull` and
-                      :meth:`Subscription.acknowledge`.
-
-        :rtype: :class:`AutoAck`
-        :returns: the instance created for the given ``ack_id`` and ``message``
-        """
-        return AutoAck(self, return_immediately, max_messages, client)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the topic of the
-                       current subscription.
-
-        :rtype: :class:`google.cloud.pubsub.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    def create(self, client=None):
-        """API call:  create the subscription via a PUT request
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/create
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_create]
-           :end-before: [END subscription_create]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        api.subscription_create(
-            self.full_name, self.topic.full_name, self.ack_deadline,
-            self.push_endpoint)
-
-    def exists(self, client=None):
-        """API call:  test existence of the subscription via a GET request
-
-        See
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/get
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_exists]
-           :end-before: [END subscription_exists]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the subscription.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        try:
-            api.subscription_get(self.full_name)
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def reload(self, client=None):
-        """API call:  sync local subscription configuration via a GET request
-
-        See
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/get
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_reload]
-           :end-before: [END subscription_reload]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        data = api.subscription_get(self.full_name)
-        self.ack_deadline = data.get('ackDeadlineSeconds')
-        push_config = data.get('pushConfig', {})
-        self.push_endpoint = push_config.get('pushEndpoint')
-
-    def delete(self, client=None):
-        """API call:  delete the subscription via a DELETE request.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/delete
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_delete]
-           :end-before: [END subscription_delete]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        api.subscription_delete(self.full_name)
-
-    def modify_push_configuration(self, push_endpoint, client=None):
-        """API call:  update the push endpoint for the subscription.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyPushConfig
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_push_pull]
-           :end-before: [END subscription_push_pull]
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_pull_push]
-           :end-before: [END subscription_pull_push]
-
-        :type push_endpoint: string
-        :param push_endpoint: URL to which messages will be pushed by the
-                              back-end.  If None, the application must pull
-                              messages.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        api.subscription_modify_push_config(self.full_name, push_endpoint)
-        self.push_endpoint = push_endpoint
-
-    def pull(self, return_immediately=False, max_messages=1, client=None):
-        """API call:  retrieve messages for the subscription.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/pull
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_pull]
-           :end-before: [END subscription_pull]
-
-        :type return_immediately: boolean
-        :param return_immediately: if True, the back-end returns even if no
-                                   messages are available;  if False, the API
-                                   call blocks until one or more messages are
-                                   available.
-
-        :type max_messages: int
-        :param max_messages: the maximum number of messages to return.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-
-        :rtype: list of (ack_id, message) tuples
-        :returns: sequence of tuples: ``ack_id`` is the ID to be used in a
-                  subsequent call to :meth:`acknowledge`, and ``message``
-                  is an instance of
-                  :class:`~google.cloud.pubsub.message.Message`.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        response = api.subscription_pull(
-            self.full_name, return_immediately, max_messages)
-        return [(info['ackId'], Message.from_api_repr(info['message']))
-                for info in response]
-
-    def acknowledge(self, ack_ids, client=None):
-        """API call:  acknowledge retrieved messages for the subscription.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/acknowledge
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_acknowledge]
-           :end-before: [END subscription_acknowledge]
-
-        :type ack_ids: list of string
-        :param ack_ids: ack IDs of messages being acknowledged
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        api.subscription_acknowledge(self.full_name, ack_ids)
-
-    def modify_ack_deadline(self, ack_ids, ack_deadline, client=None):
-        """API call:  update acknowledgement deadline for a retrieved message.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/modifyAckDeadline
-
-        :type ack_ids: list of string
-        :param ack_ids: ack IDs of messages being updated
-
-        :type ack_deadline: int
-        :param ack_deadline: new deadline for the message, in seconds
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-        """
-        client = self._require_client(client)
-        api = client.subscriber_api
-        api.subscription_modify_ack_deadline(
-            self.full_name, ack_ids, ack_deadline)
-
-    def get_iam_policy(self, client=None):
-        """Fetch the IAM policy for the subscription.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/getIamPolicy
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_get_iam_policy]
-           :end-before: [END subscription_get_iam_policy]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-
-        :rtype: :class:`google.cloud.pubsub.iam.Policy`
-        :returns: policy created from the resource returned by the
-                  ``getIamPolicy`` API request.
-        """
-        client = self._require_client(client)
-        api = client.iam_policy_api
-        resp = api.get_iam_policy(self.full_name)
-        return Policy.from_api_repr(resp)
-
-    def set_iam_policy(self, policy, client=None):
-        """Update the IAM policy for the subscription.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/setIamPolicy
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_set_iam_policy]
-           :end-before: [END subscription_set_iam_policy]
-
-        :type policy: :class:`google.cloud.pubsub.iam.Policy`
-        :param policy: the new policy, typically fetched via
-                       :meth:`get_iam_policy` and updated in place.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-
-        :rtype: :class:`google.cloud.pubsub.iam.Policy`
-        :returns: updated policy created from the resource returned by the
-                  ``setIamPolicy`` API request.
-        """
-        client = self._require_client(client)
-        api = client.iam_policy_api
-        resource = policy.to_api_repr()
-        resp = api.set_iam_policy(self.full_name, resource)
-        return Policy.from_api_repr(resp)
-
-    def check_iam_permissions(self, permissions, client=None):
-        """Verify permissions allowed for the current user.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.subscriptions/testIamPermissions
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START subscription_check_iam_permissions]
-           :end-before: [END subscription_check_iam_permissions]
-
-        :type permissions: list of string
-        :param permissions: list of permissions to be tested
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current subscription's topic.
-
-        :rtype: sequence of string
-        :returns: subset of ``permissions`` allowed by current IAM policy.
-        """
-        client = self._require_client(client)
-        api = client.iam_policy_api
-        return api.test_iam_permissions(
-            self.full_name, list(permissions))
-
-
-class AutoAck(dict):
-    """Wrapper for :meth:`Subscription.pull` results.
-
-    Mapping, tracks messages still-to-be-acknowledged.
-
-    When used as a context manager, acknowledges all messages still in the
-    mapping on `__exit__`.  When processing the pulled messages, application
-    code MUST delete messages from the :class:`AutoAck` mapping which are not
-    successfully processed, e.g.:
-
-    .. code-block: python
-
-       with AutoAck(subscription) as ack:  # calls ``subscription.pull``
-           for ack_id, message in ack.items():
-               try:
-                   do_something_with(message):
-               except:
-                   del ack[ack_id]
-
-    :type subscription: :class:`Subscription`
-    :param subscription: subscription to be pulled.
-
-    :type return_immediately: boolean
-    :param return_immediately: passed through to :meth:`Subscription.pull`
-
-    :type max_messages: int
-    :param max_messages: passed through to :meth:`Subscription.pull`
-
-    :type client: :class:`~google.cloud.pubsub.client.Client` or
-                  ``NoneType``
-    :param client: passed through to :meth:`Subscription.pull` and
-                   :meth:`Subscription.acknowledge`.
-    """
-    def __init__(self, subscription,
-                 return_immediately=False, max_messages=1, client=None):
-        super(AutoAck, self).__init__()
-        self._subscription = subscription
-        self._return_immediately = return_immediately
-        self._max_messages = max_messages
-        self._client = client
-
-    def __enter__(self):
-        items = self._subscription.pull(
-            self._return_immediately, self._max_messages, self._client)
-        self.update(items)
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        self._subscription.acknowledge(list(self), self._client)
diff --git a/google/cloud/pubsub/topic.py b/google/cloud/pubsub/topic.py
deleted file mode 100644
index 7ed6b485175d..000000000000
--- a/google/cloud/pubsub/topic.py
+++ /dev/null
@@ -1,471 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Define API Topics."""
-
-import base64
-
-from google.cloud._helpers import _datetime_to_rfc3339
-from google.cloud._helpers import _NOW
-from google.cloud.exceptions import NotFound
-from google.cloud.pubsub._helpers import subscription_name_from_path
-from google.cloud.pubsub._helpers import topic_name_from_path
-from google.cloud.pubsub.iam import Policy
-from google.cloud.pubsub.subscription import Subscription
-
-
-class Topic(object):
-    """Topics are targets to which messages can be published.
-
-    Subscribers then receive those messages.
-
-    See:
-    https://cloud.google.com/pubsub/reference/rest/v1/projects.topics
-
-    :type name: string
-    :param name: the name of the topic
-
-    :type client: :class:`google.cloud.pubsub.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the topic (which requires a project).
-
-    :type timestamp_messages: boolean
-    :param timestamp_messages: If true, the topic will add a ``timestamp`` key
-                               to the attributes of each published message:
-                               the value will be an RFC 3339 timestamp.
-    """
-    def __init__(self, name, client, timestamp_messages=False):
-        self.name = name
-        self._client = client
-        self.timestamp_messages = timestamp_messages
-
-    def subscription(self, name, ack_deadline=None, push_endpoint=None):
-        """Creates a subscription bound to the current topic.
-
-        Example:  pull-mode subcription, default paramter values
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_subscription_defaults]
-           :end-before: [END topic_subscription_defaults]
-
-        Example:  pull-mode subcription, override ``ack_deadline`` default
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_subscription_ack90]
-           :end-before: [END topic_subscription_ack90]
-
-        Example:  push-mode subcription
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_subscription_push]
-           :end-before: [END topic_subscription_push]
-
-        :type name: string
-        :param name: the name of the subscription
-
-        :type ack_deadline: int
-        :param ack_deadline: the deadline (in seconds) by which messages pulled
-                             from the back-end must be acknowledged.
-
-        :type push_endpoint: string
-        :param push_endpoint: URL to which messages will be pushed by the
-                              back-end. If not set, the application must pull
-                              messages.
-
-        :rtype: :class:`Subscription`
-        :returns: The subscription created with the passed in arguments.
-        """
-        return Subscription(name, self, ack_deadline=ack_deadline,
-                            push_endpoint=push_endpoint)
-
-    @classmethod
-    def from_api_repr(cls, resource, client):
-        """Factory:  construct a topic given its API representation
-
-        :type resource: dict
-        :param resource: topic resource representation returned from the API
-
-        :type client: :class:`google.cloud.pubsub.client.Client`
-        :param client: Client which holds credentials and project
-                       configuration for the topic.
-
-        :rtype: :class:`google.cloud.pubsub.topic.Topic`
-        :returns: Topic parsed from ``resource``.
-        :raises: :class:`ValueError` if ``client`` is not ``None`` and the
-                 project from the resource does not agree with the project
-                 from the client.
-        """
-        topic_name = topic_name_from_path(resource['name'], client.project)
-        return cls(topic_name, client=client)
-
-    @property
-    def project(self):
-        """Project bound to the topic."""
-        return self._client.project
-
-    @property
-    def full_name(self):
-        """Fully-qualified name used in topic / subscription APIs"""
-        return 'projects/%s/topics/%s' % (self.project, self.name)
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-
-        :rtype: :class:`google.cloud.pubsub.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self._client
-        return client
-
-    def create(self, client=None):
-        """API call:  create the topic via a PUT request
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/create
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_create]
-           :end-before: [END topic_create]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-        """
-        client = self._require_client(client)
-        api = client.publisher_api
-        api.topic_create(topic_path=self.full_name)
-
-    def exists(self, client=None):
-        """API call:  test for the existence of the topic via a GET request
-
-        See
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/get
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_exists]
-           :end-before: [END topic_exists]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-
-        :rtype: bool
-        :returns: Boolean indicating existence of the topic.
-        """
-        client = self._require_client(client)
-        api = client.publisher_api
-
-        try:
-            api.topic_get(topic_path=self.full_name)
-        except NotFound:
-            return False
-        else:
-            return True
-
-    def delete(self, client=None):
-        """API call:  delete the topic via a DELETE request
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/delete
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_delete]
-           :end-before: [END topic_delete]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-        """
-        client = self._require_client(client)
-        api = client.publisher_api
-        api.topic_delete(topic_path=self.full_name)
-
-    def _timestamp_message(self, attrs):
-        """Add a timestamp to ``attrs``, if the topic is so configured.
-
-        If ``attrs`` already has the key, do nothing.
-
-        Helper method for ``publish``/``Batch.publish``.
-        """
-        if self.timestamp_messages and 'timestamp' not in attrs:
-            attrs['timestamp'] = _datetime_to_rfc3339(_NOW())
-
-    def publish(self, message, client=None, **attrs):
-        """API call:  publish a message to a topic via a POST request
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/publish
-
-        Example without message attributes:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_publish_simple_message]
-           :end-before: [END topic_publish_simple_message]
-
-        With message attributes:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_publish_message_with_attrs]
-           :end-before: [END topic_publish_message_with_attrs]
-
-        :type message: bytes
-        :param message: the message payload
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-
-        :type attrs: dict (string -> string)
-        :param attrs: key-value pairs to send as message attributes
-
-        :rtype: str
-        :returns: message ID assigned by the server to the published message
-        """
-        client = self._require_client(client)
-        api = client.publisher_api
-
-        self._timestamp_message(attrs)
-        message_b = base64.b64encode(message).decode('ascii')
-        message_data = {'data': message_b, 'attributes': attrs}
-        message_ids = api.topic_publish(self.full_name, [message_data])
-        return message_ids[0]
-
-    def batch(self, client=None):
-        """Return a batch to use as a context manager.
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_batch]
-           :end-before: [END topic_batch]
-
-        .. note::
-
-           The only API request happens during the ``__exit__()`` of the topic
-           used as a context manager, and only if the block exits without
-           raising an exception.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-
-        :rtype: :class:`Batch`
-        :returns: A batch to use as a context manager.
-        """
-        client = self._require_client(client)
-        return Batch(self, client)
-
-    def list_subscriptions(self, page_size=None, page_token=None, client=None):
-        """List subscriptions for the project associated with this client.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics.subscriptions/list
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_list_subscriptions]
-           :end-before: [END topic_list_subscriptions]
-
-        :type page_size: int
-        :param page_size: maximum number of topics to return, If not passed,
-                          defaults to a value set by the API.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of topics. If not
-                           passed, the API will return the first page of
-                           topics.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current topic.
-
-        :rtype: tuple, (list, str)
-        :returns: list of :class:`~.pubsub.subscription.Subscription`,
-                  plus a "next page token" string:  if not None, indicates that
-                  more topics can be retrieved with another call (pass that
-                  value as ``page_token``).
-        """
-        client = self._require_client(client)
-        api = client.publisher_api
-        sub_paths, next_token = api.topic_list_subscriptions(
-            self.full_name, page_size, page_token)
-        subscriptions = []
-        for sub_path in sub_paths:
-            sub_name = subscription_name_from_path(sub_path, self.project)
-            subscriptions.append(Subscription(sub_name, self))
-        return subscriptions, next_token
-
-    def get_iam_policy(self, client=None):
-        """Fetch the IAM policy for the topic.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/getIamPolicy
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_get_iam_policy]
-           :end-before: [END topic_get_iam_policy]
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current batch.
-
-        :rtype: :class:`google.cloud.pubsub.iam.Policy`
-        :returns: policy created from the resource returned by the
-                  ``getIamPolicy`` API request.
-        """
-        client = self._require_client(client)
-        api = client.iam_policy_api
-        resp = api.get_iam_policy(self.full_name)
-        return Policy.from_api_repr(resp)
-
-    def set_iam_policy(self, policy, client=None):
-        """Update the IAM policy for the topic.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/setIamPolicy
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_set_iam_policy]
-           :end-before: [END topic_set_iam_policy]
-
-        :type policy: :class:`google.cloud.pubsub.iam.Policy`
-        :param policy: the new policy, typically fetched via
-                       :meth:`get_iam_policy` and updated in place.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current batch.
-
-        :rtype: :class:`google.cloud.pubsub.iam.Policy`
-        :returns: updated policy created from the resource returned by the
-                  ``setIamPolicy`` API request.
-        """
-        client = self._require_client(client)
-        api = client.iam_policy_api
-        resource = policy.to_api_repr()
-        resp = api.set_iam_policy(self.full_name, resource)
-        return Policy.from_api_repr(resp)
-
-    def check_iam_permissions(self, permissions, client=None):
-        """Verify permissions allowed for the current user.
-
-        See:
-        https://cloud.google.com/pubsub/reference/rest/v1/projects.topics/testIamPermissions
-
-        Example:
-
-        .. literalinclude:: pubsub_snippets.py
-           :start-after: [START topic_check_iam_permissions]
-           :end-before: [END topic_check_iam_permissions]
-
-        :type permissions: list of string
-        :param permissions: list of permissions to be tested
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current batch.
-
-        :rtype: sequence of string
-        :returns: subset of ``permissions`` allowed by current IAM policy.
-        """
-        client = self._require_client(client)
-        api = client.iam_policy_api
-        return api.test_iam_permissions(
-            self.full_name, list(permissions))
-
-
-class Batch(object):
-    """Context manager:  collect messages to publish via a single API call.
-
-    Helper returned by :meth:Topic.batch
-
-    :type topic: :class:`google.cloud.pubsub.topic.Topic`
-    :param topic: the topic being published
-
-    :type client: :class:`google.cloud.pubsub.client.Client`
-    :param client: The client to use.
-    """
-    def __init__(self, topic, client):
-        self.topic = topic
-        self.messages = []
-        self.message_ids = []
-        self.client = client
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        if exc_type is None:
-            self.commit()
-
-    def __iter__(self):
-        return iter(self.message_ids)
-
-    def publish(self, message, **attrs):
-        """Emulate publishing a message, but save it.
-
-        :type message: bytes
-        :param message: the message payload
-
-        :type attrs: dict (string -> string)
-        :param attrs: key-value pairs to send as message attributes
-        """
-        self.topic._timestamp_message(attrs)
-        self.messages.append(
-            {'data': base64.b64encode(message).decode('ascii'),
-             'attributes': attrs})
-
-    def commit(self, client=None):
-        """Send saved messages as a single API call.
-
-        :type client: :class:`~google.cloud.pubsub.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current batch.
-        """
-        if not self.messages:
-            return
-
-        if client is None:
-            client = self.client
-        api = client.publisher_api
-        message_ids = api.topic_publish(self.topic.full_name, self.messages[:])
-        self.message_ids.extend(message_ids)
-        del self.messages[:]
diff --git a/google/cloud/resource_manager/__init__.py b/google/cloud/resource_manager/__init__.py
deleted file mode 100644
index 4d6a4c6dfe29..000000000000
--- a/google/cloud/resource_manager/__init__.py
+++ /dev/null
@@ -1,23 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Google Cloud Resource Manager API wrapper."""
-
-
-from google.cloud.resource_manager.client import Client
-from google.cloud.resource_manager.connection import Connection
-from google.cloud.resource_manager.project import Project
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/resource_manager/client.py b/google/cloud/resource_manager/client.py
deleted file mode 100644
index b99e601cd6a0..000000000000
--- a/google/cloud/resource_manager/client.py
+++ /dev/null
@@ -1,188 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""A Client for interacting with the Resource Manager API."""
-
-
-from google.cloud.client import Client as BaseClient
-from google.cloud.iterator import Iterator
-from google.cloud.resource_manager.connection import Connection
-from google.cloud.resource_manager.project import Project
-
-
-class Client(BaseClient):
-    """Client to bundle configuration needed for API requests.
-
-    See
-    https://cloud.google.com/resource-manager/reference/rest/
-    for more information on this API.
-
-    Automatically get credentials::
-
-        >>> from google.cloud import resource_manager
-        >>> client = resource_manager.Client()
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def new_project(self, project_id, name=None, labels=None):
-        """Create a project bound to the current client.
-
-        Use :meth:`Project.reload() \
-        <google.cloud.resource_manager.project.Project.reload>` to retrieve
-        project metadata after creating a
-        :class:`~google.cloud.resource_manager.project.Project` instance.
-
-        .. note:
-
-            This does not make an API call.
-
-        :type project_id: str
-        :param project_id: The ID for this project.
-
-        :type name: string
-        :param name: The display name of the project.
-
-        :type labels: dict
-        :param labels: A list of labels associated with the project.
-
-        :rtype: :class:`~google.cloud.resource_manager.project.Project`
-        :returns: A new instance of a
-                  :class:`~google.cloud.resource_manager.project.Project`
-                  **without** any metadata loaded.
-        """
-        return Project(project_id=project_id,
-                       client=self, name=name, labels=labels)
-
-    def fetch_project(self, project_id):
-        """Fetch an existing project and it's relevant metadata by ID.
-
-        .. note::
-
-            If the project does not exist, this will raise a
-            :class:`NotFound <google.cloud.exceptions.NotFound>` error.
-
-        :type project_id: str
-        :param project_id: The ID for this project.
-
-        :rtype: :class:`~google.cloud.resource_manager.project.Project`
-        :returns: A :class:`~google.cloud.resource_manager.project.Project`
-                  with metadata fetched from the API.
-        """
-        project = self.new_project(project_id)
-        project.reload()
-        return project
-
-    def list_projects(self, filter_params=None, page_size=None):
-        """List the projects visible to this client.
-
-        Example::
-
-            >>> from google.cloud import resource_manager
-            >>> client = resource_manager.Client()
-            >>> for project in client.list_projects():
-            ...     print project.project_id
-
-        List all projects with label ``'environment'`` set to ``'prod'``
-        (filtering by labels)::
-
-            >>> from google.cloud import resource_manager
-            >>> client = resource_manager.Client()
-            >>> env_filter = {'labels.environment': 'prod'}
-            >>> for project in client.list_projects(env_filter):
-            ...     print project.project_id
-
-        See:
-        https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/list
-
-        Complete filtering example::
-
-            >>> project_filter = {  # Return projects with...
-            ...     'name': 'My Project',  # name set to 'My Project'.
-            ...     'id': 'my-project-id',  # id set to 'my-project-id'.
-            ...     'labels.stage': 'prod',  # the label 'stage' set to 'prod'
-            ...     'labels.color': '*'  # a label 'color' set to anything.
-            ... }
-            >>> client.list_projects(project_filter)
-
-        :type filter_params: dict
-        :param filter_params: (Optional) A dictionary of filter options where
-                              each key is a property to filter on, and each
-                              value is the (case-insensitive) value to check
-                              (or the glob ``*`` to check for existence of the
-                              property). See the example above for more
-                              details.
-
-        :type page_size: int
-        :param page_size: (Optional) Maximum number of projects to return in a
-                          single page. If not passed, defaults to a value set
-                          by the API.
-
-        :rtype: :class:`_ProjectIterator`
-        :returns: A project iterator. The iterator will make multiple API
-                  requests if you continue iterating and there are more
-                  pages of results. Each item returned will be a.
-                  :class:`~google.cloud.resource_manager.project.Project`.
-        """
-        extra_params = {}
-
-        if page_size is not None:
-            extra_params['pageSize'] = page_size
-
-        if filter_params is not None:
-            extra_params['filter'] = filter_params
-
-        return _ProjectIterator(self, extra_params=extra_params)
-
-
-class _ProjectIterator(Iterator):
-    """An iterator over a list of Project resources.
-
-    You shouldn't have to use this directly, but instead should use the
-    helper methods on :class:`~google.cloud.resource_manager.client.Client`
-    objects.
-
-    :type client: :class:`~google.cloud.resource_manager.client.Client`
-    :param client: The client to use for making connections.
-
-    :type extra_params: dict
-    :param extra_params: (Optional) Extra query string parameters for
-                         the API call.
-    """
-
-    def __init__(self, client, extra_params=None):
-        super(_ProjectIterator, self).__init__(client=client, path='/projects',
-                                               extra_params=extra_params)
-
-    def get_items_from_response(self, response):
-        """Yield projects from response.
-
-        :type response: dict
-        :param response: The JSON API response for a page of projects.
-        """
-        for resource in response.get('projects', []):
-            item = Project.from_api_repr(resource, client=self.client)
-            yield item
diff --git a/google/cloud/resource_manager/connection.py b/google/cloud/resource_manager/connection.py
deleted file mode 100644
index e6c10b335058..000000000000
--- a/google/cloud/resource_manager/connection.py
+++ /dev/null
@@ -1,42 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Create / interact with Google Cloud Resource Manager connections."""
-
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Resource Manager via the JSON REST API.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: (Optional) HTTP object to make requests.
-    """
-
-    API_BASE_URL = 'https://cloudresourcemanager.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1beta1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/cloud-platform',)
-    """The scopes required for authenticating as a Resouce Manager consumer."""
diff --git a/google/cloud/speech/__init__.py b/google/cloud/speech/__init__.py
deleted file mode 100644
index a5c9b218403a..000000000000
--- a/google/cloud/speech/__init__.py
+++ /dev/null
@@ -1,19 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Google Cloud Speech API wrapper."""
-
-from google.cloud.speech.client import Client
-from google.cloud.speech.client import Encoding
-from google.cloud.speech.connection import Connection
diff --git a/google/cloud/speech/client.py b/google/cloud/speech/client.py
deleted file mode 100644
index 20f0697d139f..000000000000
--- a/google/cloud/speech/client.py
+++ /dev/null
@@ -1,182 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Basic client for Google Cloud Speech API."""
-
-from base64 import b64encode
-
-from google.cloud._helpers import _to_bytes
-from google.cloud import client as client_module
-from google.cloud.speech.connection import Connection
-
-
-class Encoding(object):
-    """Audio encoding types.
-
-    See:
-    https://cloud.google.com/speech/reference/rest/v1beta1/\
-    RecognitionConfig#AudioEncoding
-    """
-
-    LINEAR16 = 'LINEAR16'
-    """LINEAR16 encoding type."""
-
-    FLAC = 'FLAC'
-    """FLAC encoding type."""
-
-    MULAW = 'MULAW'
-    """MULAW encoding type."""
-
-    AMR = 'AMR'
-    """AMR encoding type."""
-
-    AMR_WB = 'AMR_WB'
-    """AMR_WB encoding type."""
-
-
-class Client(client_module.Client):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: str
-    :param project: The project which the client acts on behalf of. Will be
-                    passed when creating a dataset / job.  If not passed,
-                    falls back to the default inferred from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def sync_recognize(self, content, source_uri, encoding, sample_rate,
-                       language_code=None, max_alternatives=None,
-                       profanity_filter=None, speech_context=None):
-        """Synchronous Speech Recognition.
-
-        .. _sync_recognize: https://cloud.google.com/speech/reference/\
-                            rest/v1beta1/speech/syncrecognize
-
-        See `sync_recognize`_.
-
-        :type content: bytes
-        :param content: Byte stream of audio.
-
-        :type source_uri: str
-        :param source_uri: URI that points to a file that contains audio
-                           data bytes as specified in RecognitionConfig.
-                           Currently, only Google Cloud Storage URIs are
-                           supported, which must be specified in the following
-                           format: ``gs://bucket_name/object_name``.
-
-        :type encoding: str
-        :param encoding: encoding of audio data sent in all RecognitionAudio
-                         messages, can be one of: :attr:`~.Encoding.LINEAR16`,
-                         :attr:`~.Encoding.FLAC`, :attr:`~.Encoding.MULAW`,
-                         :attr:`~.Encoding.AMR`, :attr:`~.Encoding.AMR_WB`
-
-        :type sample_rate: int
-        :param sample_rate: Sample rate in Hertz of the audio data sent in all
-                            requests. Valid values are: 8000-48000. 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).
-
-        :type language_code: str
-        :param language_code: (Optional) The language of the supplied audio as
-                              BCP-47 language tag. Example: ``'en-GB'``.
-                              If omitted, defaults to ``'en-US'``.
-
-        :type max_alternatives: int
-        :param max_alternatives: (Optional) Maximum number of recognition
-                                 hypotheses to be returned. The server may
-                                 return fewer than maxAlternatives.
-                                 Valid values are 0-30. A value of 0 or 1
-                                 will return a maximum of 1. Defaults to 1
-
-        :type profanity_filter: bool
-        :param profanity_filter: If 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 False or
-                                 omitted, profanities won't be filtered out.
-
-        :type speech_context: list
-        :param speech_context: A list of strings (max 50) 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. This can also be used to add new
-                               words to the vocabulary of the recognizer.
-
-        :rtype: list
-        :returns: A list of dictionaries. One dict for each alternative. Each
-                  dictionary typically contains two keys (though not
-                  all will be present in all cases)
-
-                  * ``transcript``: The detected text from the audio recording.
-                  * ``confidence``: The confidence in language detection, float
-                    between 0 and 1.
-        """
-
-        if content is None and source_uri is None:
-            raise ValueError('content and source_uri cannot be both '
-                             'equal to None')
-
-        if content is not None and source_uri is not None:
-            raise ValueError('content and source_uri cannot be both '
-                             'different from None')
-
-        if encoding is None:
-            raise ValueError('encoding cannot be None')
-        if sample_rate is None:
-            raise ValueError('sample_rate cannot be None')
-
-        if content is not None:
-            audio = {'content': b64encode(_to_bytes(content))}
-        else:
-            audio = {'uri': source_uri}
-
-        config = {'encoding': encoding, 'sampleRate': sample_rate}
-
-        if language_code is not None:
-            config['languageCode'] = language_code
-        if max_alternatives is not None:
-            config['maxAlternatives'] = max_alternatives
-        if profanity_filter is not None:
-            config['profanityFilter'] = profanity_filter
-        if speech_context is not None:
-            config['speechContext'] = {'phrases': speech_context}
-
-        data = {
-            'audio': audio,
-            'config': config,
-        }
-
-        api_response = self.connection.api_request(
-            method='POST', path='syncrecognize', data=data)
-
-        if len(api_response['results']) == 1:
-            return api_response['results'][0]['alternatives']
-        else:
-            raise ValueError('result in api should have length 1')
diff --git a/google/cloud/speech/connection.py b/google/cloud/speech/connection.py
deleted file mode 100644
index 81ed9e4f5e04..000000000000
--- a/google/cloud/speech/connection.py
+++ /dev/null
@@ -1,33 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Create / interact with Google Cloud Speech connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Speech JSON REST API."""
-
-    API_BASE_URL = 'https://speech.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1beta1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}/speech:{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/cloud-platform',)
-    """The scopes required for authenticating as an API consumer."""
diff --git a/google/cloud/storage/__init__.py b/google/cloud/storage/__init__.py
deleted file mode 100644
index 5a1b6b07dca2..000000000000
--- a/google/cloud/storage/__init__.py
+++ /dev/null
@@ -1,49 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Shortcut methods for getting set up with Google Cloud Storage.
-
-You'll typically use these to get started with the API:
-
->>> from google.cloud import storage
->>> client = storage.Client()
->>> bucket = client.get_bucket('bucket-id-here')
->>> # Then do other things...
->>> blob = bucket.get_blob('/remote/path/to/file.txt')
->>> print blob.download_as_string()
->>> blob.upload_from_string('New contents!')
->>> blob2 = bucket.blob('/remote/path/storage.txt')
->>> blob2.upload_from_filename(filename='/local/path.txt')
-
-The main concepts with this API are:
-
-- :class:`google.cloud.storage.connection.Connection` which represents a
-  connection between your machine and the Cloud Storage API.
-
-- :class:`google.cloud.storage.bucket.Bucket` which represents a particular
-  bucket (akin to a mounted disk on a computer).
-
-- :class:`google.cloud.storage.blob.Blob` which represents a pointer to a
-  particular entity in Cloud Storage (akin to a file path on a remote
-  machine).
-"""
-
-from google.cloud.storage.batch import Batch
-from google.cloud.storage.blob import Blob
-from google.cloud.storage.bucket import Bucket
-from google.cloud.storage.client import Client
-from google.cloud.storage.connection import Connection
-
-
-SCOPE = Connection.SCOPE
diff --git a/google/cloud/storage/_helpers.py b/google/cloud/storage/_helpers.py
deleted file mode 100644
index 6988cb02abe8..000000000000
--- a/google/cloud/storage/_helpers.py
+++ /dev/null
@@ -1,179 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Helper functions for Cloud Storage utility classes.
-
-These are *not* part of the API.
-"""
-
-import base64
-from hashlib import md5
-
-
-class _PropertyMixin(object):
-    """Abstract mixin for cloud storage classes with associated propertties.
-
-    Non-abstract subclasses should implement:
-      - client
-      - path
-
-    :type name: string
-    :param name: The name of the object.
-    """
-
-    def __init__(self, name=None):
-        self.name = name
-        self._properties = {}
-        self._changes = set()
-
-    @property
-    def path(self):
-        """Abstract getter for the object path."""
-        raise NotImplementedError
-
-    @property
-    def client(self):
-        """Abstract getter for the object client."""
-        raise NotImplementedError
-
-    def _require_client(self, client):
-        """Check client or verify over-ride.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current object.
-
-        :rtype: :class:`google.cloud.storage.client.Client`
-        :returns: The client passed in or the currently bound client.
-        """
-        if client is None:
-            client = self.client
-        return client
-
-    def reload(self, client=None):
-        """Reload properties from Cloud Storage.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current object.
-        """
-        client = self._require_client(client)
-        # Pass only '?projection=noAcl' here because 'acl' and related
-        # are handled via custom endpoints.
-        query_params = {'projection': 'noAcl'}
-        api_response = client.connection.api_request(
-            method='GET', path=self.path, query_params=query_params,
-            _target_object=self)
-        self._set_properties(api_response)
-
-    def _patch_property(self, name, value):
-        """Update field of this object's properties.
-
-        This method will only update the field provided and will not
-        touch the other fields.
-
-        It **will not** reload the properties from the server. The behavior is
-        local only and syncing occurs via :meth:`patch`.
-
-        :type name: string
-        :param name: The field name to update.
-
-        :type value: object
-        :param value: The value being updated.
-        """
-        self._changes.add(name)
-        self._properties[name] = value
-
-    def _set_properties(self, value):
-        """Set the properties for the current object.
-
-        :type value: dict or :class:`google.cloud.storage.batch._FutureDict`
-        :param value: The properties to be set.
-        """
-        self._properties = value
-        # If the values are reset, the changes must as well.
-        self._changes = set()
-
-    def patch(self, client=None):
-        """Sends all changed properties in a PATCH request.
-
-        Updates the ``_properties`` with the response from the backend.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: the client to use.  If not passed, falls back to the
-                       ``client`` stored on the current object.
-        """
-        client = self._require_client(client)
-        # Pass '?projection=full' here because 'PATCH' documented not
-        # to work properly w/ 'noAcl'.
-        update_properties = {key: self._properties[key]
-                             for key in self._changes}
-        api_response = client.connection.api_request(
-            method='PATCH', path=self.path, data=update_properties,
-            query_params={'projection': 'full'}, _target_object=self)
-        self._set_properties(api_response)
-
-
-def _scalar_property(fieldname):
-    """Create a property descriptor around the :class:`_PropertyMixin` helpers.
-    """
-    def _getter(self):
-        """Scalar property getter."""
-        return self._properties.get(fieldname)
-
-    def _setter(self, value):
-        """Scalar property setter."""
-        self._patch_property(fieldname, value)
-
-    return property(_getter, _setter)
-
-
-def _write_buffer_to_hash(buffer_object, hash_obj, digest_block_size=8192):
-    """Read blocks from a buffer and update a hash with them.
-
-    :type buffer_object: bytes buffer
-    :param buffer_object: Buffer containing bytes used to update a hash object.
-
-    :type hash_obj: object that implements update
-    :param hash_obj: A hash object (MD5 or CRC32-C).
-
-    :type digest_block_size: integer
-    :param digest_block_size: The block size to write to the hash.
-                              Defaults to 8192.
-    """
-    block = buffer_object.read(digest_block_size)
-
-    while len(block) > 0:
-        hash_obj.update(block)
-        # Update the block for the next iteration.
-        block = buffer_object.read(digest_block_size)
-
-
-def _base64_md5hash(buffer_object):
-    """Get MD5 hash of bytes (as base64).
-
-    :type buffer_object: bytes buffer
-    :param buffer_object: Buffer containing bytes used to compute an MD5
-                          hash (as base64).
-
-    :rtype: str
-    :returns: A base64 encoded digest of the MD5 hash.
-    """
-    hash_obj = md5()
-    _write_buffer_to_hash(buffer_object, hash_obj)
-    digest_bytes = hash_obj.digest()
-    return base64.b64encode(digest_bytes)
diff --git a/google/cloud/storage/batch.py b/google/cloud/storage/batch.py
deleted file mode 100644
index b1221647eead..000000000000
--- a/google/cloud/storage/batch.py
+++ /dev/null
@@ -1,324 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-"""Batch updates / deletes of storage buckets / blobs.
-
-See: https://cloud.google.com/storage/docs/json_api/v1/how-tos/batch
-"""
-from email.encoders import encode_noop
-from email.generator import Generator
-from email.mime.application import MIMEApplication
-from email.mime.multipart import MIMEMultipart
-from email.parser import Parser
-import io
-import json
-
-import httplib2
-import six
-
-from google.cloud.exceptions import make_exception
-from google.cloud.storage.connection import Connection
-
-
-class MIMEApplicationHTTP(MIMEApplication):
-    """MIME type for ``application/http``.
-
-    Constructs payload from headers and body
-
-    :type method: str
-    :param method: HTTP method
-
-    :type uri: str
-    :param uri: URI for HTTP request
-
-    :type headers:  dict
-    :param headers: HTTP headers
-
-    :type body: str or None
-    :param body: HTTP payload
-
-    """
-    def __init__(self, method, uri, headers, body):
-        if isinstance(body, dict):
-            body = json.dumps(body)
-            headers['Content-Type'] = 'application/json'
-            headers['Content-Length'] = len(body)
-        if body is None:
-            body = ''
-        lines = ['%s %s HTTP/1.1' % (method, uri)]
-        lines.extend(['%s: %s' % (key, value)
-                      for key, value in sorted(headers.items())])
-        lines.append('')
-        lines.append(body)
-        payload = '\r\n'.join(lines)
-        if six.PY2:
-            # email.message.Message is an old-style class, so we
-            # cannot use 'super()'.
-            MIMEApplication.__init__(self, payload, 'http', encode_noop)
-        else:  # pragma: NO COVER  Python3
-            super_init = super(MIMEApplicationHTTP, self).__init__
-            super_init(payload, 'http', encode_noop)
-
-
-class NoContent(object):
-    """Emulate an HTTP '204 No Content' response."""
-    status = 204
-
-
-class _FutureDict(object):
-    """Class to hold a future value for a deferred request.
-
-    Used by for requests that get sent in a :class:`Batch`.
-    """
-
-    @staticmethod
-    def get(key, default=None):
-        """Stand-in for dict.get.
-
-        :type key: object
-        :param key: Hashable dictionary key.
-
-        :type default: object
-        :param default: Fallback value to dict.get.
-
-        :raises: :class:`KeyError` always since the future is intended to fail
-                 as a dictionary.
-        """
-        raise KeyError('Cannot get(%r, default=%r) on a future' % (
-            key, default))
-
-    def __getitem__(self, key):
-        """Stand-in for dict[key].
-
-        :type key: object
-        :param key: Hashable dictionary key.
-
-        :raises: :class:`KeyError` always since the future is intended to fail
-                 as a dictionary.
-        """
-        raise KeyError('Cannot get item %r from a future' % (key,))
-
-    def __setitem__(self, key, value):
-        """Stand-in for dict[key] = value.
-
-        :type key: object
-        :param key: Hashable dictionary key.
-
-        :type value: object
-        :param value: Dictionary value.
-
-        :raises: :class:`KeyError` always since the future is intended to fail
-                 as a dictionary.
-        """
-        raise KeyError('Cannot set %r -> %r on a future' % (key, value))
-
-
-class Batch(Connection):
-    """Proxy an underlying connection, batching up change operations.
-
-    :type client: :class:`google.cloud.storage.client.Client`
-    :param client: The client to use for making connections.
-    """
-    _MAX_BATCH_SIZE = 1000
-
-    def __init__(self, client):
-        super(Batch, self).__init__()
-        self._client = client
-        self._requests = []
-        self._target_objects = []
-
-    def _do_request(self, method, url, headers, data, target_object):
-        """Override Connection:  defer actual HTTP request.
-
-        Only allow up to ``_MAX_BATCH_SIZE`` requests to be deferred.
-
-        :type method: str
-        :param method: The HTTP method to use in the request.
-
-        :type url: str
-        :param url: The URL to send the request to.
-
-        :type headers: dict
-        :param headers: A dictionary of HTTP headers to send with the request.
-
-        :type data: str
-        :param data: The data to send as the body of the request.
-
-        :type target_object: object or :class:`NoneType`
-        :param target_object: This allows us to enable custom behavior in our
-                              batch connection. Here we defer an HTTP request
-                              and complete initialization of the object at a
-                              later time.
-
-        :rtype: tuple of ``response`` (a dictionary of sorts)
-                and ``content`` (a string).
-        :returns: The HTTP response object and the content of the response.
-        """
-        if len(self._requests) >= self._MAX_BATCH_SIZE:
-            raise ValueError("Too many deferred requests (max %d)" %
-                             self._MAX_BATCH_SIZE)
-        self._requests.append((method, url, headers, data))
-        result = _FutureDict()
-        self._target_objects.append(target_object)
-        if target_object is not None:
-            target_object._properties = result
-        return NoContent(), result
-
-    def _prepare_batch_request(self):
-        """Prepares headers and body for a batch request.
-
-        :rtype: tuple (dict, str)
-        :returns: The pair of headers and body of the batch request to be sent.
-        :raises: :class:`ValueError` if no requests have been deferred.
-        """
-        if len(self._requests) == 0:
-            raise ValueError("No deferred requests")
-
-        multi = MIMEMultipart()
-
-        for method, uri, headers, body in self._requests:
-            subrequest = MIMEApplicationHTTP(method, uri, headers, body)
-            multi.attach(subrequest)
-
-        # The `email` package expects to deal with "native" strings
-        if six.PY3:  # pragma: NO COVER  Python3
-            buf = io.StringIO()
-        else:
-            buf = io.BytesIO()
-        generator = Generator(buf, False, 0)
-        generator.flatten(multi)
-        payload = buf.getvalue()
-
-        # Strip off redundant header text
-        _, body = payload.split('\n\n', 1)
-        return dict(multi._headers), body
-
-    def _finish_futures(self, responses):
-        """Apply all the batch responses to the futures created.
-
-        :type responses: list of (headers, payload) tuples.
-        :param responses: List of headers and payloads from each response in
-                          the batch.
-
-        :raises: :class:`ValueError` if no requests have been deferred.
-        """
-        # If a bad status occurs, we track it, but don't raise an exception
-        # until all futures have been populated.
-        exception_args = None
-
-        if len(self._target_objects) != len(responses):
-            raise ValueError('Expected a response for every request.')
-
-        for target_object, sub_response in zip(self._target_objects,
-                                               responses):
-            resp_headers, sub_payload = sub_response
-            if not 200 <= resp_headers.status < 300:
-                exception_args = exception_args or (resp_headers,
-                                                    sub_payload)
-            elif target_object is not None:
-                target_object._properties = sub_payload
-
-        if exception_args is not None:
-            raise make_exception(*exception_args)
-
-    def finish(self):
-        """Submit a single `multipart/mixed` request with deferred requests.
-
-        :rtype: list of tuples
-        :returns: one ``(headers, payload)`` tuple per deferred request.
-        """
-        headers, body = self._prepare_batch_request()
-
-        url = '%s/batch' % self.API_BASE_URL
-
-        # Use the private ``_connection`` rather than the public
-        # ``.connection``, since the public connection may be this
-        # current batch.
-        response, content = self._client._connection._make_request(
-            'POST', url, data=body, headers=headers)
-        responses = list(_unpack_batch_response(response, content))
-        self._finish_futures(responses)
-        return responses
-
-    def current(self):
-        """Return the topmost batch, or None."""
-        return self._client.current_batch
-
-    def __enter__(self):
-        self._client._push_batch(self)
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        try:
-            if exc_type is None:
-                self.finish()
-        finally:
-            self._client._pop_batch()
-
-
-def _generate_faux_mime_message(parser, response, content):
-    """Convert response, content -> (multipart) email.message.
-
-    Helper for _unpack_batch_response.
-    """
-    # We coerce to bytes to get consistent concat across
-    # Py2 and Py3. Percent formatting is insufficient since
-    # it includes the b in Py3.
-    if not isinstance(content, six.binary_type):
-        content = content.encode('utf-8')
-    content_type = response['content-type']
-    if not isinstance(content_type, six.binary_type):
-        content_type = content_type.encode('utf-8')
-    faux_message = b''.join([
-        b'Content-Type: ',
-        content_type,
-        b'\nMIME-Version: 1.0\n\n',
-        content,
-    ])
-
-    if six.PY2:
-        return parser.parsestr(faux_message)
-    else:  # pragma: NO COVER  Python3
-        return parser.parsestr(faux_message.decode('utf-8'))
-
-
-def _unpack_batch_response(response, content):
-    """Convert response, content -> [(headers, payload)].
-
-    Creates a generator of tuples of emulating the responses to
-    :meth:`httplib2.Http.request` (a pair of headers and payload).
-
-    :type response: :class:`httplib2.Response`
-    :param response: HTTP response / headers from a request.
-
-    :type content: str
-    :param content: Response payload with a batch response.
-    """
-    parser = Parser()
-    message = _generate_faux_mime_message(parser, response, content)
-
-    if not isinstance(message._payload, list):
-        raise ValueError('Bad response:  not multi-part')
-
-    for subrequest in message._payload:
-        status_line, rest = subrequest._payload.split('\n', 1)
-        _, status, _ = status_line.split(' ', 2)
-        sub_message = parser.parsestr(rest)
-        payload = sub_message._payload
-        ctype = sub_message['Content-Type']
-        msg_headers = dict(sub_message._headers)
-        msg_headers['status'] = status
-        headers = httplib2.Response(msg_headers)
-        if ctype and ctype.startswith('application/json'):
-            payload = json.loads(payload)
-        yield headers, payload
diff --git a/google/cloud/storage/blob.py b/google/cloud/storage/blob.py
deleted file mode 100644
index d8c1a17e6920..000000000000
--- a/google/cloud/storage/blob.py
+++ /dev/null
@@ -1,956 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with Google Cloud Storage blobs."""
-
-import base64
-import copy
-import hashlib
-from io import BytesIO
-from io import UnsupportedOperation
-import json
-import mimetypes
-import os
-import time
-
-import httplib2
-import six
-from six.moves.urllib.parse import quote
-
-from google.cloud._helpers import _rfc3339_to_datetime
-from google.cloud._helpers import _to_bytes
-from google.cloud._helpers import _bytes_to_unicode
-from google.cloud.credentials import generate_signed_url
-from google.cloud.exceptions import NotFound
-from google.cloud.exceptions import make_exception
-from google.cloud.storage._helpers import _PropertyMixin
-from google.cloud.storage._helpers import _scalar_property
-from google.cloud.storage.acl import ObjectACL
-from google.cloud.streaming.http_wrapper import Request
-from google.cloud.streaming.http_wrapper import make_api_request
-from google.cloud.streaming.transfer import Download
-from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-from google.cloud.streaming.transfer import Upload
-
-
-_API_ACCESS_ENDPOINT = 'https://storage.googleapis.com'
-
-
-class Blob(_PropertyMixin):
-    """A wrapper around Cloud Storage's concept of an ``Object``.
-
-    :type name: string
-    :param name: The name of the blob.  This corresponds to the
-                 unique path of the object in the bucket.
-
-    :type bucket: :class:`google.cloud.storage.bucket.Bucket`
-    :param bucket: The bucket to which this blob belongs.
-
-    :type chunk_size: integer
-    :param chunk_size: The size of a chunk of data whenever iterating (1 MB).
-                       This must be a multiple of 256 KB per the API
-                       specification.
-    """
-
-    _chunk_size = None  # Default value for each instance.
-
-    _CHUNK_SIZE_MULTIPLE = 256 * 1024
-    """Number (256 KB, in bytes) that must divide the chunk size."""
-
-    def __init__(self, name, bucket, chunk_size=None):
-        super(Blob, self).__init__(name=name)
-
-        self.chunk_size = chunk_size  # Check that setter accepts value.
-        self.bucket = bucket
-        self._acl = ObjectACL(self)
-
-    @property
-    def chunk_size(self):
-        """Get the blob's default chunk size.
-
-        :rtype: integer or ``NoneType``
-        :returns: The current blob's chunk size, if it is set.
-        """
-        return self._chunk_size
-
-    @chunk_size.setter
-    def chunk_size(self, value):
-        """Set the blob's default chunk size.
-
-        :type value: integer or ``NoneType``
-        :param value: The current blob's chunk size, if it is set.
-
-        :raises: :class:`ValueError` if ``value`` is not ``None`` and is not a
-                 multiple of 256 KB.
-        """
-        if value is not None and value % self._CHUNK_SIZE_MULTIPLE != 0:
-            raise ValueError('Chunk size must be a multiple of %d.' % (
-                self._CHUNK_SIZE_MULTIPLE,))
-        self._chunk_size = value
-
-    @staticmethod
-    def path_helper(bucket_path, blob_name):
-        """Relative URL path for a blob.
-
-        :type bucket_path: string
-        :param bucket_path: The URL path for a bucket.
-
-        :type blob_name: string
-        :param blob_name: The name of the blob.
-
-        :rtype: string
-        :returns: The relative URL path for ``blob_name``.
-        """
-        return bucket_path + '/o/' + quote(blob_name, safe='')
-
-    @property
-    def acl(self):
-        """Create our ACL on demand."""
-        return self._acl
-
-    def __repr__(self):
-        if self.bucket:
-            bucket_name = self.bucket.name
-        else:
-            bucket_name = None
-
-        return '<Blob: %s, %s>' % (bucket_name, self.name)
-
-    @property
-    def path(self):
-        """Getter property for the URL path to this Blob.
-
-        :rtype: string
-        :returns: The URL path to this Blob.
-        """
-        if not self.name:
-            raise ValueError('Cannot determine path without a blob name.')
-
-        return self.path_helper(self.bucket.path, self.name)
-
-    @property
-    def client(self):
-        """The client bound to this blob."""
-        return self.bucket.client
-
-    @property
-    def public_url(self):
-        """The public URL for this blob's object.
-
-        :rtype: `string`
-        :returns: The public URL for this blob.
-        """
-        return '{storage_base_url}/{bucket_name}/{quoted_name}'.format(
-            storage_base_url='https://storage.googleapis.com',
-            bucket_name=self.bucket.name,
-            quoted_name=quote(self.name, safe=''))
-
-    def generate_signed_url(self, expiration, method='GET',
-                            content_type=None,
-                            generation=None, response_disposition=None,
-                            response_type=None, client=None, credentials=None):
-        """Generates a signed URL for this blob.
-
-        .. note::
-
-            If you are on Google Compute Engine, you can't generate a signed
-            URL. Follow `Issue 922`_ for updates on this. If you'd like to
-            be able to generate a signed URL from GCE, you can use a standard
-            service account from a JSON file rather than a GCE service account.
-
-        .. _Issue 922: https://github.com/GoogleCloudPlatform/\
-                       google-cloud-python/issues/922
-
-        If you have a blob that you want to allow access to for a set
-        amount of time, you can use this method to generate a URL that
-        is only valid within a certain time period.
-
-        This is particularly useful if you don't want publicly
-        accessible blobs, but don't want to require users to explicitly
-        log in.
-
-        :type expiration: int, long, datetime.datetime, datetime.timedelta
-        :param expiration: When the signed URL should expire.
-
-        :type method: str
-        :param method: The HTTP verb that will be used when requesting the URL.
-
-        :type content_type: str
-        :param content_type: (Optional) The content type of the object
-                             referenced by ``resource``.
-
-        :type generation: str
-        :param generation: (Optional) A value that indicates which generation
-                           of the resource to fetch.
-
-        :type response_disposition: str
-        :param response_disposition: (Optional) Content disposition of
-                                     responses to requests for the signed URL.
-                                     For example, to enable the signed URL
-                                     to initiate a file of ``blog.png``, use
-                                     the value
-                                     ``'attachment; filename=blob.png'``.
-
-        :type response_type: str
-        :param response_type: (Optional) Content type of responses to requests
-                              for the signed URL. Used to over-ride the content
-                              type of the underlying blob/object.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: (Optional) The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-
-        :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                           :class:`NoneType`
-        :param credentials: (Optional) The OAuth2 credentials to use to sign
-                            the URL. Defaults to the credentials stored on the
-                            client used.
-
-        :rtype: str
-        :returns: A signed URL you can use to access the resource
-                  until expiration.
-        """
-        resource = '/{bucket_name}/{quoted_name}'.format(
-            bucket_name=self.bucket.name,
-            quoted_name=quote(self.name, safe=''))
-
-        if credentials is None:
-            client = self._require_client(client)
-            credentials = client._connection.credentials
-
-        return generate_signed_url(
-            credentials, resource=resource,
-            api_access_endpoint=_API_ACCESS_ENDPOINT,
-            expiration=expiration, method=method,
-            content_type=content_type,
-            response_type=response_type,
-            response_disposition=response_disposition,
-            generation=generation)
-
-    def exists(self, client=None):
-        """Determines whether or not this blob exists.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-        :rtype: boolean
-        :returns: True if the blob exists in Cloud Storage.
-        """
-        client = self._require_client(client)
-        try:
-            # We only need the status code (200 or not) so we seek to
-            # minimize the returned payload.
-            query_params = {'fields': 'name'}
-            # We intentionally pass `_target_object=None` since fields=name
-            # would limit the local properties.
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params=query_params,
-                                          _target_object=None)
-            # NOTE: This will not fail immediately in a batch. However, when
-            #       Batch.finish() is called, the resulting `NotFound` will be
-            #       raised.
-            return True
-        except NotFound:
-            return False
-
-    def delete(self, client=None):
-        """Deletes a blob from Cloud Storage.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-        :rtype: :class:`Blob`
-        :returns: The blob that was just deleted.
-        :raises: :class:`google.cloud.exceptions.NotFound`
-                 (propagated from
-                 :meth:`google.cloud.storage.bucket.Bucket.delete_blob`).
-        """
-        return self.bucket.delete_blob(self.name, client=client)
-
-    def download_to_file(self, file_obj, encryption_key=None, client=None):
-        """Download the contents of this blob into a file-like object.
-
-        .. note::
-
-           If the server-set property, :attr:`media_link`, is not yet
-           initialized, makes an additional API request to load it.
-
-         Downloading a file that has been encrypted with a `customer-supplied`_
-         encryption key::
-
-            >>> from google.cloud import storage
-            >>> from google.cloud.storage import Blob
-
-            >>> client = storage.Client(project='my-project')
-            >>> bucket = client.get_bucket('my-bucket')
-            >>> encryption_key = 'aa426195405adee2c8081bb9e7e74b19'
-            >>> blob = Blob('secure-data', bucket)
-            >>> with open('/tmp/my-secure-file', 'wb') as file_obj:
-            >>>     blob.download_to_file(file_obj,
-            ...                           encryption_key=encryption_key)
-
-        The ``encryption_key`` should be a str or bytes with a length of at
-        least 32.
-
-        .. _customer-supplied: https://cloud.google.com/storage/docs/\
-                               encryption#customer-supplied
-
-        :type file_obj: file
-        :param file_obj: A file handle to which to write the blob's data.
-
-        :type encryption_key: str or bytes
-        :param encryption_key: Optional 32 byte encryption key for
-                               customer-supplied encryption.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-        :raises: :class:`google.cloud.exceptions.NotFound`
-        """
-        client = self._require_client(client)
-        if self.media_link is None:  # not yet loaded
-            self.reload()
-
-        download_url = self.media_link
-
-        # Use apitools 'Download' facility.
-        download = Download.from_stream(file_obj)
-
-        if self.chunk_size is not None:
-            download.chunksize = self.chunk_size
-
-        headers = {}
-        if encryption_key:
-            _set_encryption_headers(encryption_key, headers)
-
-        request = Request(download_url, 'GET', headers)
-
-        # Use the private ``_connection`` rather than the public
-        # ``.connection``, since the public connection may be a batch. A
-        # batch wraps a client's connection, but does not store the `http`
-        # object. The rest (API_BASE_URL and build_api_url) are also defined
-        # on the Batch class, but we just use the wrapped connection since
-        # it has all three (http, API_BASE_URL and build_api_url).
-        download.initialize_download(request, client._connection.http)
-
-    def download_to_filename(self, filename, encryption_key=None, client=None):
-        """Download the contents of this blob into a named file.
-
-        :type filename: string
-        :param filename: A filename to be passed to ``open``.
-
-        :type encryption_key: str or bytes
-        :param encryption_key: Optional 32 byte encryption key for
-                               customer-supplied encryption.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-        :raises: :class:`google.cloud.exceptions.NotFound`
-        """
-        with open(filename, 'wb') as file_obj:
-            self.download_to_file(file_obj, encryption_key=encryption_key,
-                                  client=client)
-
-        mtime = time.mktime(self.updated.timetuple())
-        os.utime(file_obj.name, (mtime, mtime))
-
-    def download_as_string(self, encryption_key=None, client=None):
-        """Download the contents of this blob as a string.
-
-        :type encryption_key: str or bytes
-        :param encryption_key: Optional 32 byte encryption key for
-                               customer-supplied encryption.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-        :rtype: bytes
-        :returns: The data stored in this blob.
-        :raises: :class:`google.cloud.exceptions.NotFound`
-        """
-        string_buffer = BytesIO()
-        self.download_to_file(string_buffer, encryption_key=encryption_key,
-                              client=client)
-        return string_buffer.getvalue()
-
-    @staticmethod
-    def _check_response_error(request, http_response):
-        """Helper for :meth:`upload_from_file`."""
-        info = http_response.info
-        status = int(info['status'])
-        if not 200 <= status < 300:
-            faux_response = httplib2.Response({'status': status})
-            raise make_exception(faux_response, http_response.content,
-                                 error_info=request.url)
-
-    # pylint: disable=too-many-locals
-    def upload_from_file(self, file_obj, rewind=False, size=None,
-                         encryption_key=None, content_type=None, num_retries=6,
-                         client=None):
-        """Upload the contents of this blob from a file-like object.
-
-        The content type of the upload will either be
-        - The value passed in to the function (if any)
-        - The value stored on the current blob
-        - The default value of 'application/octet-stream'
-
-        .. note::
-           The effect of uploading to an existing blob depends on the
-           "versioning" and "lifecycle" policies defined on the blob's
-           bucket.  In the absence of those policies, upload will
-           overwrite any existing contents.
-
-           See the `object versioning
-           <https://cloud.google.com/storage/docs/object-versioning>`_ and
-           `lifecycle <https://cloud.google.com/storage/docs/lifecycle>`_
-           API documents for details.
-
-        Uploading a file with a `customer-supplied`_ encryption key::
-
-            >>> from google.cloud import storage
-            >>> from google.cloud.storage import Blob
-
-            >>> client = storage.Client(project='my-project')
-            >>> bucket = client.get_bucket('my-bucket')
-            >>> encryption_key = 'aa426195405adee2c8081bb9e7e74b19'
-            >>> blob = Blob('secure-data', bucket)
-            >>> with open('my-file', 'rb') as my_file:
-            >>>     blob.upload_from_file(my_file,
-            ...                           encryption_key=encryption_key)
-
-        The ``encryption_key`` should be a str or bytes with a length of at
-        least 32.
-
-        .. _customer-supplied: https://cloud.google.com/storage/docs/\
-                               encryption#customer-supplied
-
-        :type file_obj: file
-        :param file_obj: A file handle open for reading.
-
-        :type rewind: boolean
-        :param rewind: If True, seek to the beginning of the file handle before
-                       writing the file to Cloud Storage.
-
-        :type size: int
-        :param size: The number of bytes to read from the file handle.
-                     If not provided, we'll try to guess the size using
-                     :func:`os.fstat`. (If the file handle is not from the
-                     filesystem this won't be possible.)
-
-        :type encryption_key: str or bytes
-        :param encryption_key: Optional 32 byte encryption key for
-                               customer-supplied encryption.
-
-        :type content_type: string or ``NoneType``
-        :param content_type: Optional type of content being uploaded.
-
-        :type num_retries: integer
-        :param num_retries: Number of upload retries. Defaults to 6.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-
-        :raises: :class:`ValueError` if size is not passed in and can not be
-                 determined; :class:`google.cloud.exceptions.GoogleCloudError`
-                 if the upload response returns an error status.
-        """
-        client = self._require_client(client)
-        # Use the private ``_connection`` rather than the public
-        # ``.connection``, since the public connection may be a batch. A
-        # batch wraps a client's connection, but does not store the `http`
-        # object. The rest (API_BASE_URL and build_api_url) are also defined
-        # on the Batch class, but we just use the wrapped connection since
-        # it has all three (http, API_BASE_URL and build_api_url).
-        connection = client._connection
-        content_type = (content_type or self._properties.get('contentType') or
-                        'application/octet-stream')
-
-        # Rewind the file if desired.
-        if rewind:
-            file_obj.seek(0, os.SEEK_SET)
-
-        # Get the basic stats about the file.
-        total_bytes = size
-        if total_bytes is None:
-            if hasattr(file_obj, 'fileno'):
-                try:
-                    total_bytes = os.fstat(file_obj.fileno()).st_size
-                except (OSError, UnsupportedOperation):
-                    pass  # Assuming fd is not an actual file (maybe socket).
-
-        headers = {
-            'Accept': 'application/json',
-            'Accept-Encoding': 'gzip, deflate',
-            'User-Agent': connection.USER_AGENT,
-        }
-
-        if encryption_key:
-            _set_encryption_headers(encryption_key, headers)
-
-        upload = Upload(file_obj, content_type, total_bytes,
-                        auto_transfer=False)
-
-        if self.chunk_size is not None:
-            upload.chunksize = self.chunk_size
-
-            if total_bytes is None:
-                upload.strategy = RESUMABLE_UPLOAD
-        elif total_bytes is None:
-            raise ValueError('total bytes could not be determined. Please '
-                             'pass an explicit size, or supply a chunk size '
-                             'for a streaming transfer.')
-
-        url_builder = _UrlBuilder(bucket_name=self.bucket.name,
-                                  object_name=self.name)
-        upload_config = _UploadConfig()
-
-        # Temporary URL, until we know simple vs. resumable.
-        base_url = connection.API_BASE_URL + '/upload'
-        upload_url = connection.build_api_url(api_base_url=base_url,
-                                              path=self.bucket.path + '/o')
-
-        # Use apitools 'Upload' facility.
-        request = Request(upload_url, 'POST', headers)
-
-        upload.configure_request(upload_config, request, url_builder)
-        query_params = url_builder.query_params
-        base_url = connection.API_BASE_URL + '/upload'
-        request.url = connection.build_api_url(api_base_url=base_url,
-                                               path=self.bucket.path + '/o',
-                                               query_params=query_params)
-        upload.initialize_upload(request, connection.http)
-
-        if upload.strategy == RESUMABLE_UPLOAD:
-            http_response = upload.stream_file(use_chunks=True)
-        else:
-            http_response = make_api_request(connection.http, request,
-                                             retries=num_retries)
-
-        self._check_response_error(request, http_response)
-        response_content = http_response.content
-
-        if not isinstance(response_content,
-                          six.string_types):  # pragma: NO COVER  Python3
-            response_content = response_content.decode('utf-8')
-        self._set_properties(json.loads(response_content))
-    # pylint: enable=too-many-locals
-
-    def upload_from_filename(self, filename, content_type=None,
-                             encryption_key=None, client=None):
-        """Upload this blob's contents from the content of a named file.
-
-        The content type of the upload will either be
-        - The value passed in to the function (if any)
-        - The value stored on the current blob
-        - The value given by mimetypes.guess_type
-
-        .. note::
-           The effect of uploading to an existing blob depends on the
-           "versioning" and "lifecycle" policies defined on the blob's
-           bucket.  In the absence of those policies, upload will
-           overwrite any existing contents.
-
-           See the `object versioning
-           <https://cloud.google.com/storage/docs/object-versioning>`_ and
-           `lifecycle <https://cloud.google.com/storage/docs/lifecycle>`_
-           API documents for details.
-
-        :type filename: string
-        :param filename: The path to the file.
-
-        :type content_type: string or ``NoneType``
-        :param content_type: Optional type of content being uploaded.
-
-        :type encryption_key: str or bytes
-        :param encryption_key: Optional 32 byte encryption key for
-                               customer-supplied encryption.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-        """
-        content_type = content_type or self._properties.get('contentType')
-        if content_type is None:
-            content_type, _ = mimetypes.guess_type(filename)
-
-        with open(filename, 'rb') as file_obj:
-            self.upload_from_file(file_obj, content_type=content_type,
-                                  encryption_key=encryption_key, client=client)
-
-    def upload_from_string(self, data, content_type='text/plain',
-                           encryption_key=None, client=None):
-        """Upload contents of this blob from the provided string.
-
-        .. note::
-           The effect of uploading to an existing blob depends on the
-           "versioning" and "lifecycle" policies defined on the blob's
-           bucket.  In the absence of those policies, upload will
-           overwrite any existing contents.
-
-           See the `object versioning
-           <https://cloud.google.com/storage/docs/object-versioning>`_ and
-           `lifecycle <https://cloud.google.com/storage/docs/lifecycle>`_
-           API documents for details.
-
-        :type data: bytes or text
-        :param data: The data to store in this blob.  If the value is
-                     text, it will be encoded as UTF-8.
-
-        :type content_type: string
-        :param content_type: Optional type of content being uploaded. Defaults
-                             to ``'text/plain'``.
-
-        :type encryption_key: str or bytes
-        :param encryption_key: Optional 32 byte encryption key for
-                               customer-supplied encryption.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-        """
-        if isinstance(data, six.text_type):
-            data = data.encode('utf-8')
-        string_buffer = BytesIO()
-        string_buffer.write(data)
-        self.upload_from_file(file_obj=string_buffer, rewind=True,
-                              size=len(data), content_type=content_type,
-                              encryption_key=encryption_key, client=client)
-
-    def make_public(self, client=None):
-        """Make this blob public giving all users read access.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the blob's bucket.
-        """
-        self.acl.all().grant_read()
-        self.acl.save(client=client)
-
-    cache_control = _scalar_property('cacheControl')
-    """HTTP 'Cache-Control' header for this object.
-
-    See: https://tools.ietf.org/html/rfc7234#section-5.2 and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    content_disposition = _scalar_property('contentDisposition')
-    """HTTP 'Content-Disposition' header for this object.
-
-    See: https://tools.ietf.org/html/rfc6266 and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    content_encoding = _scalar_property('contentEncoding')
-    """HTTP 'Content-Encoding' header for this object.
-
-    See: https://tools.ietf.org/html/rfc7231#section-3.1.2.2 and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    content_language = _scalar_property('contentLanguage')
-    """HTTP 'Content-Language' header for this object.
-
-    See: http://tools.ietf.org/html/bcp47 and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    content_type = _scalar_property('contentType')
-    """HTTP 'Content-Type' header for this object.
-
-    See: https://tools.ietf.org/html/rfc2616#section-14.17 and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    crc32c = _scalar_property('crc32c')
-    """CRC32C checksum for this object.
-
-    See: http://tools.ietf.org/html/rfc4960#appendix-B and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    @property
-    def component_count(self):
-        """Number of underlying components that make up this object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: integer or ``NoneType``
-        :returns: The component count (in case of a composed object) or
-                  ``None`` if the property is not set locally. This property
-                  will not be set on objects not created via ``compose``.
-        """
-        component_count = self._properties.get('componentCount')
-        if component_count is not None:
-            return int(component_count)
-
-    @property
-    def etag(self):
-        """Retrieve the ETag for the object.
-
-        See: http://tools.ietf.org/html/rfc2616#section-3.11 and
-             https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: string or ``NoneType``
-        :returns: The blob etag or ``None`` if the property is not set locally.
-        """
-        return self._properties.get('etag')
-
-    @property
-    def generation(self):
-        """Retrieve the generation for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: integer or ``NoneType``
-        :returns: The generation of the blob or ``None`` if the property
-                  is not set locally.
-        """
-        generation = self._properties.get('generation')
-        if generation is not None:
-            return int(generation)
-
-    @property
-    def id(self):
-        """Retrieve the ID for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: string or ``NoneType``
-        :returns: The ID of the blob or ``None`` if the property is not
-                  set locally.
-        """
-        return self._properties.get('id')
-
-    md5_hash = _scalar_property('md5Hash')
-    """MD5 hash for this object.
-
-    See: http://tools.ietf.org/html/rfc4960#appendix-B and
-         https://cloud.google.com/storage/docs/json_api/v1/objects
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    @property
-    def media_link(self):
-        """Retrieve the media download URI for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: string or ``NoneType``
-        :returns: The media link for the blob or ``None`` if the property is
-                  not set locally.
-        """
-        return self._properties.get('mediaLink')
-
-    @property
-    def metadata(self):
-        """Retrieve arbitrary/application specific metadata for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: dict or ``NoneType``
-        :returns: The metadata associated with the blob or ``None`` if the
-                  property is not set locally.
-        """
-        return copy.deepcopy(self._properties.get('metadata'))
-
-    @metadata.setter
-    def metadata(self, value):
-        """Update arbitrary/application specific metadata for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :type value: dict or ``NoneType``
-        :param value: The blob metadata to set.
-        """
-        self._patch_property('metadata', value)
-
-    @property
-    def metageneration(self):
-        """Retrieve the metageneration for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: integer or ``NoneType``
-        :returns: The metageneration of the blob or ``None`` if the property
-                  is not set locally.
-        """
-        metageneration = self._properties.get('metageneration')
-        if metageneration is not None:
-            return int(metageneration)
-
-    @property
-    def owner(self):
-        """Retrieve info about the owner of the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: dict or ``NoneType``
-        :returns: Mapping of owner's role/ID. If the property is not set
-                  locally, returns ``None``.
-        """
-        return copy.deepcopy(self._properties.get('owner'))
-
-    @property
-    def self_link(self):
-        """Retrieve the URI for the object.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: string or ``NoneType``
-        :returns: The self link for the blob or ``None`` if the property is
-                  not set locally.
-        """
-        return self._properties.get('selfLink')
-
-    @property
-    def size(self):
-        """Size of the object, in bytes.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: integer or ``NoneType``
-        :returns: The size of the blob or ``None`` if the property
-                  is not set locally.
-        """
-        size = self._properties.get('size')
-        if size is not None:
-            return int(size)
-
-    @property
-    def storage_class(self):
-        """Retrieve the storage class for the object.
-
-        See: https://cloud.google.com/storage/docs/storage-classes
-        https://cloud.google.com/storage/docs/nearline-storage
-        https://cloud.google.com/storage/docs/durable-reduced-availability
-
-        :rtype: string or ``NoneType``
-        :returns: If set, one of "STANDARD", "NEARLINE", or
-                  "DURABLE_REDUCED_AVAILABILITY", else ``None``.
-        """
-        return self._properties.get('storageClass')
-
-    @property
-    def time_deleted(self):
-        """Retrieve the timestamp at which the object was deleted.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: :class:`datetime.datetime` or ``NoneType``
-        :returns: Datetime object parsed from RFC3339 valid timestamp, or
-                  ``None`` if the property is not set locally. If the blob has
-                  not been deleted, this will never be set.
-        """
-        value = self._properties.get('timeDeleted')
-        if value is not None:
-            return _rfc3339_to_datetime(value)
-
-    @property
-    def updated(self):
-        """Retrieve the timestamp at which the object was updated.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/objects
-
-        :rtype: :class:`datetime.datetime` or ``NoneType``
-        :returns: Datetime object parsed from RFC3339 valid timestamp, or
-                  ``None`` if the property is not set locally.
-        """
-        value = self._properties.get('updated')
-        if value is not None:
-            return _rfc3339_to_datetime(value)
-
-
-class _UploadConfig(object):
-    """Faux message FBO apitools' 'configure_request'.
-
-    Values extracted from apitools
-    'samples/storage_sample/storage/storage_v1_client.py'
-    """
-    accept = ['*/*']
-    max_size = None
-    resumable_multipart = True
-    resumable_path = u'/resumable/upload/storage/v1/b/{bucket}/o'
-    simple_multipart = True
-    simple_path = u'/upload/storage/v1/b/{bucket}/o'
-
-
-class _UrlBuilder(object):
-    """Faux builder FBO apitools' 'configure_request'"""
-    def __init__(self, bucket_name, object_name):
-        self.query_params = {'name': object_name}
-        self._bucket_name = bucket_name
-        self._relative_path = ''
-
-
-def _set_encryption_headers(key, headers):
-    """Builds customer encryption key headers
-
-    :type key: str or bytes
-    :param key: 32 byte key to build request key and hash.
-
-    :type headers: dict
-    :param headers: dict of HTTP headers being sent in request.
-    """
-    key = _to_bytes(key)
-    sha256_key = hashlib.sha256(key).digest()
-    key_hash = base64.b64encode(sha256_key).rstrip()
-    encoded_key = base64.b64encode(key).rstrip()
-    headers['X-Goog-Encryption-Algorithm'] = 'AES256'
-    headers['X-Goog-Encryption-Key'] = _bytes_to_unicode(encoded_key)
-    headers['X-Goog-Encryption-Key-Sha256'] = _bytes_to_unicode(key_hash)
diff --git a/google/cloud/storage/bucket.py b/google/cloud/storage/bucket.py
deleted file mode 100644
index def628edd485..000000000000
--- a/google/cloud/storage/bucket.py
+++ /dev/null
@@ -1,830 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with Google Cloud Storage buckets."""
-
-import copy
-
-import six
-
-from google.cloud._helpers import _rfc3339_to_datetime
-from google.cloud.exceptions import NotFound
-from google.cloud.iterator import Iterator
-from google.cloud.storage._helpers import _PropertyMixin
-from google.cloud.storage._helpers import _scalar_property
-from google.cloud.storage.acl import BucketACL
-from google.cloud.storage.acl import DefaultObjectACL
-from google.cloud.storage.blob import Blob
-
-
-class _BlobIterator(Iterator):
-    """An iterator listing blobs in a bucket
-
-    You shouldn't have to use this directly, but instead should use the
-    :class:`google.cloud.storage.blob.Bucket.list_blobs` method.
-
-    :type bucket: :class:`google.cloud.storage.bucket.Bucket`
-    :param bucket: The bucket from which to list blobs.
-
-    :type extra_params: dict or None
-    :param extra_params: Extra query string parameters for the API call.
-
-    :type client: :class:`google.cloud.storage.client.Client`
-    :param client: Optional. The client to use for making connections.
-                   Defaults to the bucket's client.
-    """
-    def __init__(self, bucket, extra_params=None, client=None):
-        if client is None:
-            client = bucket.client
-        self.bucket = bucket
-        self.prefixes = set()
-        self._current_prefixes = None
-        super(_BlobIterator, self).__init__(
-            client=client, path=bucket.path + '/o',
-            extra_params=extra_params)
-
-    def get_items_from_response(self, response):
-        """Yield :class:`.storage.blob.Blob` items from response.
-
-        :type response: dict
-        :param response: The JSON API response for a page of blobs.
-        """
-        self._current_prefixes = tuple(response.get('prefixes', ()))
-        self.prefixes.update(self._current_prefixes)
-        for item in response.get('items', []):
-            name = item.get('name')
-            blob = Blob(name, bucket=self.bucket)
-            blob._set_properties(item)
-            yield blob
-
-
-class Bucket(_PropertyMixin):
-    """A class representing a Bucket on Cloud Storage.
-
-    :type client: :class:`google.cloud.storage.client.Client`
-    :param client: A client which holds credentials and project configuration
-                   for the bucket (which requires a project).
-
-    :type name: string
-    :param name: The name of the bucket.
-    """
-    _iterator_class = _BlobIterator
-
-    _MAX_OBJECTS_FOR_ITERATION = 256
-    """Maximum number of existing objects allowed in iteration.
-
-    This is used in Bucket.delete() and Bucket.make_public().
-    """
-
-    _STORAGE_CLASSES = ('STANDARD', 'NEARLINE', 'DURABLE_REDUCED_AVAILABILITY')
-
-    def __init__(self, client, name=None):
-        super(Bucket, self).__init__(name=name)
-        self._client = client
-        self._acl = BucketACL(self)
-        self._default_object_acl = DefaultObjectACL(self)
-
-    def __repr__(self):
-        return '<Bucket: %s>' % self.name
-
-    @property
-    def client(self):
-        """The client bound to this bucket."""
-        return self._client
-
-    def blob(self, blob_name, chunk_size=None):
-        """Factory constructor for blob object.
-
-        .. note::
-          This will not make an HTTP request; it simply instantiates
-          a blob object owned by this bucket.
-
-        :type blob_name: string
-        :param blob_name: The name of the blob to be instantiated.
-
-        :type chunk_size: integer
-        :param chunk_size: The size of a chunk of data whenever iterating
-                           (1 MB). This must be a multiple of 256 KB per the
-                           API specification.
-
-        :rtype: :class:`google.cloud.storage.blob.Blob`
-        :returns: The blob object created.
-        """
-        return Blob(name=blob_name, bucket=self, chunk_size=chunk_size)
-
-    def exists(self, client=None):
-        """Determines whether or not this bucket exists.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :rtype: boolean
-        :returns: True if the bucket exists in Cloud Storage.
-        """
-        client = self._require_client(client)
-        try:
-            # We only need the status code (200 or not) so we seek to
-            # minimize the returned payload.
-            query_params = {'fields': 'name'}
-            # We intentionally pass `_target_object=None` since fields=name
-            # would limit the local properties.
-            client.connection.api_request(method='GET', path=self.path,
-                                          query_params=query_params,
-                                          _target_object=None)
-            # NOTE: This will not fail immediately in a batch. However, when
-            #       Batch.finish() is called, the resulting `NotFound` will be
-            #       raised.
-            return True
-        except NotFound:
-            return False
-
-    def create(self, client=None):
-        """Creates current bucket.
-
-        If the bucket already exists, will raise
-        :class:`google.cloud.exceptions.Conflict`.
-
-        This implements "storage.buckets.insert".
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-        """
-        client = self._require_client(client)
-        query_params = {'project': client.project}
-        properties = {key: self._properties[key] for key in self._changes}
-        properties['name'] = self.name
-        api_response = client.connection.api_request(
-            method='POST', path='/b', query_params=query_params,
-            data=properties, _target_object=self)
-        self._set_properties(api_response)
-
-    @property
-    def acl(self):
-        """Create our ACL on demand."""
-        return self._acl
-
-    @property
-    def default_object_acl(self):
-        """Create our defaultObjectACL on demand."""
-        return self._default_object_acl
-
-    @staticmethod
-    def path_helper(bucket_name):
-        """Relative URL path for a bucket.
-
-        :type bucket_name: string
-        :param bucket_name: The bucket name in the path.
-
-        :rtype: string
-        :returns: The relative URL path for ``bucket_name``.
-        """
-        return '/b/' + bucket_name
-
-    @property
-    def path(self):
-        """The URL path to this bucket."""
-        if not self.name:
-            raise ValueError('Cannot determine path without bucket name.')
-
-        return self.path_helper(self.name)
-
-    def get_blob(self, blob_name, client=None):
-        """Get a blob object by name.
-
-        This will return None if the blob doesn't exist::
-
-          >>> from google.cloud import storage
-          >>> client = storage.Client()
-          >>> bucket = client.get_bucket('my-bucket')
-          >>> print bucket.get_blob('/path/to/blob.txt')
-          <Blob: my-bucket, /path/to/blob.txt>
-          >>> print bucket.get_blob('/does-not-exist.txt')
-          None
-
-        :type blob_name: string
-        :param blob_name: The name of the blob to retrieve.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :rtype: :class:`google.cloud.storage.blob.Blob` or None
-        :returns: The blob object if it exists, otherwise None.
-        """
-        client = self._require_client(client)
-        blob = Blob(bucket=self, name=blob_name)
-        try:
-            response = client.connection.api_request(
-                method='GET', path=blob.path, _target_object=blob)
-            # NOTE: We assume response.get('name') matches `blob_name`.
-            blob._set_properties(response)
-            # NOTE: This will not fail immediately in a batch. However, when
-            #       Batch.finish() is called, the resulting `NotFound` will be
-            #       raised.
-            return blob
-        except NotFound:
-            return None
-
-    def list_blobs(self, max_results=None, page_token=None, prefix=None,
-                   delimiter=None, versions=None,
-                   projection='noAcl', fields=None, client=None):
-        """Return an iterator used to find blobs in the bucket.
-
-        :type max_results: integer or ``NoneType``
-        :param max_results: maximum number of blobs to return.
-
-        :type page_token: string
-        :param page_token: opaque marker for the next "page" of blobs. If not
-                           passed, will return the first page of blobs.
-
-        :type prefix: string or ``NoneType``
-        :param prefix: optional prefix used to filter blobs.
-
-        :type delimiter: string or ``NoneType``
-        :param delimiter: optional delimter, used with ``prefix`` to
-                          emulate hierarchy.
-
-        :type versions: boolean or ``NoneType``
-        :param versions: whether object versions should be returned as
-                         separate blobs.
-
-        :type projection: string or ``NoneType``
-        :param projection: If used, must be 'full' or 'noAcl'. Defaults to
-                           'noAcl'. Specifies the set of properties to return.
-
-        :type fields: string or ``NoneType``
-        :param fields: Selector specifying which fields to include in a
-                       partial response. Must be a list of fields. For example
-                       to get a partial response with just the next page token
-                       and the language of each blob returned:
-                       'items/contentLanguage,nextPageToken'
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :rtype: :class:`_BlobIterator`.
-        :returns: An iterator of blobs.
-        """
-        extra_params = {}
-
-        if max_results is not None:
-            extra_params['maxResults'] = max_results
-
-        if prefix is not None:
-            extra_params['prefix'] = prefix
-
-        if delimiter is not None:
-            extra_params['delimiter'] = delimiter
-
-        if versions is not None:
-            extra_params['versions'] = versions
-
-        extra_params['projection'] = projection
-
-        if fields is not None:
-            extra_params['fields'] = fields
-
-        result = self._iterator_class(
-            self, extra_params=extra_params, client=client)
-        # Page token must be handled specially since the base `Iterator`
-        # class has it as a reserved property.
-        if page_token is not None:
-            # pylint: disable=attribute-defined-outside-init
-            result.next_page_token = page_token
-            # pylint: enable=attribute-defined-outside-init
-        return result
-
-    def delete(self, force=False, client=None):
-        """Delete this bucket.
-
-        The bucket **must** be empty in order to submit a delete request. If
-        ``force=True`` is passed, this will first attempt to delete all the
-        objects / blobs in the bucket (i.e. try to empty the bucket).
-
-        If the bucket doesn't exist, this will raise
-        :class:`google.cloud.exceptions.NotFound`.  If the bucket is not empty
-        (and ``force=False``), will raise
-        :class:`google.cloud.exceptions.Conflict`.
-
-        If ``force=True`` and the bucket contains more than 256 objects / blobs
-        this will cowardly refuse to delete the objects (or the bucket). This
-        is to prevent accidental bucket deletion and to prevent extremely long
-        runtime of this method.
-
-        :type force: boolean
-        :param force: If True, empties the bucket's objects then deletes it.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :raises: :class:`ValueError` if ``force`` is ``True`` and the bucket
-                 contains more than 256 objects / blobs.
-        """
-        client = self._require_client(client)
-        if force:
-            blobs = list(self.list_blobs(
-                max_results=self._MAX_OBJECTS_FOR_ITERATION + 1,
-                client=client))
-            if len(blobs) > self._MAX_OBJECTS_FOR_ITERATION:
-                message = (
-                    'Refusing to delete bucket with more than '
-                    '%d objects. If you actually want to delete '
-                    'this bucket, please delete the objects '
-                    'yourself before calling Bucket.delete().'
-                ) % (self._MAX_OBJECTS_FOR_ITERATION,)
-                raise ValueError(message)
-
-            # Ignore 404 errors on delete.
-            self.delete_blobs(blobs, on_error=lambda blob: None,
-                              client=client)
-
-        # We intentionally pass `_target_object=None` since a DELETE
-        # request has no response value (whether in a standard request or
-        # in a batch request).
-        client.connection.api_request(method='DELETE', path=self.path,
-                                      _target_object=None)
-
-    def delete_blob(self, blob_name, client=None):
-        """Deletes a blob from the current bucket.
-
-        If the blob isn't found (backend 404), raises a
-        :class:`google.cloud.exceptions.NotFound`.
-
-        For example::
-
-          >>> from google.cloud.exceptions import NotFound
-          >>> from google.cloud import storage
-          >>> client = storage.Client()
-          >>> bucket = client.get_bucket('my-bucket')
-          >>> print bucket.list_blobs()
-          [<Blob: my-bucket, my-file.txt>]
-          >>> bucket.delete_blob('my-file.txt')
-          >>> try:
-          ...   bucket.delete_blob('doesnt-exist')
-          ... except NotFound:
-          ...   pass
-
-        :type blob_name: string
-        :param blob_name: A blob name to delete.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` (to suppress
-                 the exception, call ``delete_blobs``, passing a no-op
-                 ``on_error`` callback, e.g.::
-
-                 >>> bucket.delete_blobs([blob], on_error=lambda blob: None)
-        """
-        client = self._require_client(client)
-        blob_path = Blob.path_helper(self.path, blob_name)
-        # We intentionally pass `_target_object=None` since a DELETE
-        # request has no response value (whether in a standard request or
-        # in a batch request).
-        client.connection.api_request(method='DELETE', path=blob_path,
-                                      _target_object=None)
-
-    def delete_blobs(self, blobs, on_error=None, client=None):
-        """Deletes a list of blobs from the current bucket.
-
-        Uses :func:`Bucket.delete_blob` to delete each individual blob.
-
-        :type blobs: list of string or :class:`google.cloud.storage.blob.Blob`
-        :param blobs: A list of blob names or Blob objects to delete.
-
-        :type on_error: a callable taking (blob)
-        :param on_error: If not ``None``, called once for each blob raising
-                         :class:`google.cloud.exceptions.NotFound`;
-                         otherwise, the exception is propagated.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :raises: :class:`google.cloud.exceptions.NotFound` (if
-                 `on_error` is not passed).
-        """
-        for blob in blobs:
-            try:
-                blob_name = blob
-                if not isinstance(blob_name, six.string_types):
-                    blob_name = blob.name
-                self.delete_blob(blob_name, client=client)
-            except NotFound:
-                if on_error is not None:
-                    on_error(blob)
-                else:
-                    raise
-
-    def copy_blob(self, blob, destination_bucket, new_name=None,
-                  client=None):
-        """Copy the given blob to the given bucket, optionally with a new name.
-
-        :type blob: :class:`google.cloud.storage.blob.Blob`
-        :param blob: The blob to be copied.
-
-        :type destination_bucket: :class:`google.cloud.storage.bucket.Bucket`
-        :param destination_bucket: The bucket into which the blob should be
-                                   copied.
-
-        :type new_name: string
-        :param new_name: (optional) the new name for the copied file.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :rtype: :class:`google.cloud.storage.blob.Blob`
-        :returns: The new Blob.
-        """
-        client = self._require_client(client)
-        if new_name is None:
-            new_name = blob.name
-        new_blob = Blob(bucket=destination_bucket, name=new_name)
-        api_path = blob.path + '/copyTo' + new_blob.path
-        copy_result = client.connection.api_request(
-            method='POST', path=api_path, _target_object=new_blob)
-        new_blob._set_properties(copy_result)
-        return new_blob
-
-    def rename_blob(self, blob, new_name, client=None):
-        """Rename the given blob using copy and delete operations.
-
-        Effectively, copies blob to the same bucket with a new name, then
-        deletes the blob.
-
-        .. warning::
-
-          This method will first duplicate the data and then delete the
-          old blob.  This means that with very large objects renaming
-          could be a very (temporarily) costly or a very slow operation.
-
-        :type blob: :class:`google.cloud.storage.blob.Blob`
-        :param blob: The blob to be renamed.
-
-        :type new_name: string
-        :param new_name: The new name for this blob.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-
-        :rtype: :class:`Blob`
-        :returns: The newly-renamed blob.
-        """
-        new_blob = self.copy_blob(blob, self, new_name, client=client)
-        blob.delete(client=client)
-        return new_blob
-
-    @property
-    def cors(self):
-        """Retrieve CORS policies configured for this bucket.
-
-        See: http://www.w3.org/TR/cors/ and
-             https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: list of dictionaries
-        :returns: A sequence of mappings describing each CORS policy.
-        """
-        return [copy.deepcopy(policy)
-                for policy in self._properties.get('cors', ())]
-
-    @cors.setter
-    def cors(self, entries):
-        """Set CORS policies configured for this bucket.
-
-        See: http://www.w3.org/TR/cors/ and
-             https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :type entries: list of dictionaries
-        :param entries: A sequence of mappings describing each CORS policy.
-        """
-        self._patch_property('cors', entries)
-
-    @property
-    def etag(self):
-        """Retrieve the ETag for the bucket.
-
-        See: http://tools.ietf.org/html/rfc2616#section-3.11 and
-             https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: string or ``NoneType``
-        :returns: The bucket etag or ``None`` if the property is not
-                  set locally.
-        """
-        return self._properties.get('etag')
-
-    @property
-    def id(self):
-        """Retrieve the ID for the bucket.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: string or ``NoneType``
-        :returns: The ID of the bucket or ``None`` if the property is not
-                  set locally.
-        """
-        return self._properties.get('id')
-
-    @property
-    def lifecycle_rules(self):
-        """Lifecycle rules configured for this bucket.
-
-        See: https://cloud.google.com/storage/docs/lifecycle and
-             https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: list(dict)
-        :returns: A sequence of mappings describing each lifecycle rule.
-        """
-        info = self._properties.get('lifecycle', {})
-        return [copy.deepcopy(rule) for rule in info.get('rule', ())]
-
-    @lifecycle_rules.setter
-    def lifecycle_rules(self, rules):
-        self._patch_property('lifecycle', {'rule': rules})
-
-    location = _scalar_property('location')
-    """Retrieve location configured for this bucket.
-
-    See: https://cloud.google.com/storage/docs/json_api/v1/buckets and
-    https://cloud.google.com/storage/docs/concepts-techniques#specifyinglocations
-
-    If the property is not set locally, returns ``None``.
-
-    :rtype: string or ``NoneType``
-    """
-
-    def get_logging(self):
-        """Return info about access logging for this bucket.
-
-        See: https://cloud.google.com/storage/docs/accesslogs#status
-
-        :rtype: dict or None
-        :returns: a dict w/ keys, ``logBucket`` and ``logObjectPrefix``
-                  (if logging is enabled), or None (if not).
-        """
-        info = self._properties.get('logging')
-        return copy.deepcopy(info)
-
-    def enable_logging(self, bucket_name, object_prefix=''):
-        """Enable access logging for this bucket.
-
-        See: https://cloud.google.com/storage/docs/accesslogs#delivery
-
-        :type bucket_name: string
-        :param bucket_name: name of bucket in which to store access logs
-
-        :type object_prefix: string
-        :param object_prefix: prefix for access log filenames
-        """
-        info = {'logBucket': bucket_name, 'logObjectPrefix': object_prefix}
-        self._patch_property('logging', info)
-
-    def disable_logging(self):
-        """Disable access logging for this bucket.
-
-        See: https://cloud.google.com/storage/docs/accesslogs#disabling
-        """
-        self._patch_property('logging', None)
-
-    @property
-    def metageneration(self):
-        """Retrieve the metageneration for the bucket.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: integer or ``NoneType``
-        :returns: The metageneration of the bucket or ``None`` if the property
-                  is not set locally.
-        """
-        metageneration = self._properties.get('metageneration')
-        if metageneration is not None:
-            return int(metageneration)
-
-    @property
-    def owner(self):
-        """Retrieve info about the owner of the bucket.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: dict or ``NoneType``
-        :returns: Mapping of owner's role/ID. If the property is not set
-                  locally, returns ``None``.
-        """
-        return copy.deepcopy(self._properties.get('owner'))
-
-    @property
-    def project_number(self):
-        """Retrieve the number of the project to which the bucket is assigned.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: integer or ``NoneType``
-        :returns: The project number that owns the bucket or ``None`` if the
-                  property is not set locally.
-        """
-        project_number = self._properties.get('projectNumber')
-        if project_number is not None:
-            return int(project_number)
-
-    @property
-    def self_link(self):
-        """Retrieve the URI for the bucket.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: string or ``NoneType``
-        :returns: The self link for the bucket or ``None`` if the property is
-                  not set locally.
-        """
-        return self._properties.get('selfLink')
-
-    @property
-    def storage_class(self):
-        """Retrieve the storage class for the bucket.
-
-        See: https://cloud.google.com/storage/docs/storage-classes
-        https://cloud.google.com/storage/docs/nearline-storage
-        https://cloud.google.com/storage/docs/durable-reduced-availability
-
-        :rtype: string or ``NoneType``
-        :returns: If set, one of "STANDARD", "NEARLINE", or
-                  "DURABLE_REDUCED_AVAILABILITY", else ``None``.
-        """
-        return self._properties.get('storageClass')
-
-    @storage_class.setter
-    def storage_class(self, value):
-        """Set the storage class for the bucket.
-
-        See: https://cloud.google.com/storage/docs/storage-classes
-        https://cloud.google.com/storage/docs/nearline-storage
-        https://cloud.google.com/storage/docs/durable-reduced-availability
-
-        :type value: string
-        :param value: one of "STANDARD", "NEARLINE", or
-                      "DURABLE_REDUCED_AVAILABILITY"
-        """
-        if value not in self._STORAGE_CLASSES:
-            raise ValueError('Invalid storage class: %s' % (value,))
-        self._patch_property('storageClass', value)
-
-    @property
-    def time_created(self):
-        """Retrieve the timestamp at which the bucket was created.
-
-        See: https://cloud.google.com/storage/docs/json_api/v1/buckets
-
-        :rtype: :class:`datetime.datetime` or ``NoneType``
-        :returns: Datetime object parsed from RFC3339 valid timestamp, or
-                  ``None`` if the property is not set locally.
-        """
-        value = self._properties.get('timeCreated')
-        if value is not None:
-            return _rfc3339_to_datetime(value)
-
-    @property
-    def versioning_enabled(self):
-        """Is versioning enabled for this bucket?
-
-        See:  https://cloud.google.com/storage/docs/object-versioning for
-        details.
-
-        :rtype: boolean
-        :returns: True if enabled, else False.
-        """
-        versioning = self._properties.get('versioning', {})
-        return versioning.get('enabled', False)
-
-    @versioning_enabled.setter
-    def versioning_enabled(self, value):
-        """Enable versioning for this bucket.
-
-        See:  https://cloud.google.com/storage/docs/object-versioning for
-        details.
-
-        :type value: convertible to boolean
-        :param value: should versioning be anabled for the bucket?
-        """
-        self._patch_property('versioning', {'enabled': bool(value)})
-
-    def configure_website(self, main_page_suffix=None, not_found_page=None):
-        """Configure website-related properties.
-
-        See: https://developers.google.com/storage/docs/website-configuration
-
-        .. note::
-          This (apparently) only works
-          if your bucket name is a domain name
-          (and to do that, you need to get approved somehow...).
-
-        If you want this bucket to host a website, just provide the name
-        of an index page and a page to use when a blob isn't found::
-
-          >>> from google.cloud import storage
-          >>> client = storage.Client()
-          >>> bucket = client.get_bucket(bucket_name)
-          >>> bucket.configure_website('index.html', '404.html')
-
-        You probably should also make the whole bucket public::
-
-          >>> bucket.make_public(recursive=True, future=True)
-
-        This says: "Make the bucket public, and all the stuff already in
-        the bucket, and anything else I add to the bucket.  Just make it
-        all public."
-
-        :type main_page_suffix: string
-        :param main_page_suffix: The page to use as the main page
-                                 of a directory.
-                                 Typically something like index.html.
-
-        :type not_found_page: string
-        :param not_found_page: The file to use when a page isn't found.
-        """
-        data = {
-            'mainPageSuffix': main_page_suffix,
-            'notFoundPage': not_found_page,
-        }
-        self._patch_property('website', data)
-
-    def disable_website(self):
-        """Disable the website configuration for this bucket.
-
-        This is really just a shortcut for setting the website-related
-        attributes to ``None``.
-        """
-        return self.configure_website(None, None)
-
-    def make_public(self, recursive=False, future=False, client=None):
-        """Make a bucket public.
-
-        If ``recursive=True`` and the bucket contains more than 256
-        objects / blobs this will cowardly refuse to make the objects public.
-        This is to prevent extremely long runtime of this method.
-
-        :type recursive: boolean
-        :param recursive: If True, this will make all blobs inside the bucket
-                          public as well.
-
-        :type future: boolean
-        :param future: If True, this will make all objects created in the
-                       future public as well.
-
-        :type client: :class:`~google.cloud.storage.client.Client` or
-                      ``NoneType``
-        :param client: Optional. The client to use.  If not passed, falls back
-                       to the ``client`` stored on the current bucket.
-        """
-        self.acl.all().grant_read()
-        self.acl.save(client=client)
-
-        if future:
-            doa = self.default_object_acl
-            if not doa.loaded:
-                doa.reload(client=client)
-            doa.all().grant_read()
-            doa.save(client=client)
-
-        if recursive:
-            blobs = list(self.list_blobs(
-                projection='full',
-                max_results=self._MAX_OBJECTS_FOR_ITERATION + 1,
-                client=client))
-            if len(blobs) > self._MAX_OBJECTS_FOR_ITERATION:
-                message = (
-                    'Refusing to make public recursively with more than '
-                    '%d objects. If you actually want to make every object '
-                    'in this bucket public, please do it on the objects '
-                    'yourself.'
-                ) % (self._MAX_OBJECTS_FOR_ITERATION,)
-                raise ValueError(message)
-
-            for blob in blobs:
-                blob.acl.all().grant_read()
-                blob.acl.save(client=client)
diff --git a/google/cloud/storage/client.py b/google/cloud/storage/client.py
deleted file mode 100644
index 5a8a5d8f1fbe..000000000000
--- a/google/cloud/storage/client.py
+++ /dev/null
@@ -1,309 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Client for interacting with the Google Cloud Storage API."""
-
-
-from google.cloud._helpers import _LocalStack
-from google.cloud.client import JSONClient
-from google.cloud.exceptions import NotFound
-from google.cloud.iterator import Iterator
-from google.cloud.storage.batch import Batch
-from google.cloud.storage.bucket import Bucket
-from google.cloud.storage.connection import Connection
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: string
-    :param project: the project which the client acts on behalf of. Will be
-                    passed when creating a topic.  If not passed,
-                    falls back to the default inferred from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def __init__(self, project=None, credentials=None, http=None):
-        self._connection = None
-        super(Client, self).__init__(project=project, credentials=credentials,
-                                     http=http)
-        self._batch_stack = _LocalStack()
-
-    @property
-    def connection(self):
-        """Get connection or batch on the client.
-
-        :rtype: :class:`google.cloud.storage.connection.Connection`
-        :returns: The connection set on the client, or the batch
-                  if one is set.
-        """
-        if self.current_batch is not None:
-            return self.current_batch
-        else:
-            return self._connection
-
-    @connection.setter
-    def connection(self, value):
-        """Set connection on the client.
-
-        Intended to be used by constructor (since the base class calls)
-            self.connection = connection
-        Will raise if the connection is set more than once.
-
-        :type value: :class:`google.cloud.storage.connection.Connection`
-        :param value: The connection set on the client.
-
-        :raises: :class:`ValueError` if connection has already been set.
-        """
-        if self._connection is not None:
-            raise ValueError('Connection already set on client')
-        self._connection = value
-
-    def _push_batch(self, batch):
-        """Push a batch onto our stack.
-
-        "Protected", intended for use by batch context mgrs.
-
-        :type batch: :class:`google.cloud.storage.batch.Batch`
-        :param batch: newly-active batch
-        """
-        self._batch_stack.push(batch)
-
-    def _pop_batch(self):
-        """Pop a batch from our stack.
-
-        "Protected", intended for use by batch context mgrs.
-
-        :raises: IndexError if the stack is empty.
-        :rtype: :class:`google.cloud.storage.batch.Batch`
-        :returns: the top-most batch/transaction, after removing it.
-        """
-        return self._batch_stack.pop()
-
-    @property
-    def current_batch(self):
-        """Currently-active batch.
-
-        :rtype: :class:`google.cloud.storage.batch.Batch` or ``NoneType`` (if
-                no batch is active).
-        :returns: The batch at the top of the batch stack.
-        """
-        return self._batch_stack.top
-
-    def bucket(self, bucket_name):
-        """Factory constructor for bucket object.
-
-        .. note::
-          This will not make an HTTP request; it simply instantiates
-          a bucket object owned by this client.
-
-        :type bucket_name: string
-        :param bucket_name: The name of the bucket to be instantiated.
-
-        :rtype: :class:`google.cloud.storage.bucket.Bucket`
-        :returns: The bucket object created.
-        """
-        return Bucket(client=self, name=bucket_name)
-
-    def batch(self):
-        """Factory constructor for batch object.
-
-        .. note::
-          This will not make an HTTP request; it simply instantiates
-          a batch object owned by this client.
-
-        :rtype: :class:`google.cloud.storage.batch.Batch`
-        :returns: The batch object created.
-        """
-        return Batch(client=self)
-
-    def get_bucket(self, bucket_name):
-        """Get a bucket by name.
-
-        If the bucket isn't found, this will raise a
-        :class:`google.cloud.storage.exceptions.NotFound`.
-
-        For example::
-
-          >>> try:
-          >>>   bucket = client.get_bucket('my-bucket')
-          >>> except google.cloud.exceptions.NotFound:
-          >>>   print 'Sorry, that bucket does not exist!'
-
-        This implements "storage.buckets.get".
-
-        :type bucket_name: string
-        :param bucket_name: The name of the bucket to get.
-
-        :rtype: :class:`google.cloud.storage.bucket.Bucket`
-        :returns: The bucket matching the name provided.
-        :raises: :class:`google.cloud.exceptions.NotFound`
-        """
-        bucket = Bucket(self, name=bucket_name)
-        bucket.reload(client=self)
-        return bucket
-
-    def lookup_bucket(self, bucket_name):
-        """Get a bucket by name, returning None if not found.
-
-        You can use this if you would rather check for a None value
-        than catching an exception::
-
-          >>> bucket = client.lookup_bucket('doesnt-exist')
-          >>> print bucket
-          None
-          >>> bucket = client.lookup_bucket('my-bucket')
-          >>> print bucket
-          <Bucket: my-bucket>
-
-        :type bucket_name: string
-        :param bucket_name: The name of the bucket to get.
-
-        :rtype: :class:`google.cloud.storage.bucket.Bucket`
-        :returns: The bucket matching the name provided or None if not found.
-        """
-        try:
-            return self.get_bucket(bucket_name)
-        except NotFound:
-            return None
-
-    def create_bucket(self, bucket_name):
-        """Create a new bucket.
-
-        For example::
-
-          >>> bucket = client.create_bucket('my-bucket')
-          >>> print bucket
-          <Bucket: my-bucket>
-
-        This implements "storage.buckets.insert".
-
-        If the bucket already exists, will raise
-        :class:`google.cloud.exceptions.Conflict`.
-
-        :type bucket_name: string
-        :param bucket_name: The bucket name to create.
-
-        :rtype: :class:`google.cloud.storage.bucket.Bucket`
-        :returns: The newly created bucket.
-        """
-        bucket = Bucket(self, name=bucket_name)
-        bucket.create(client=self)
-        return bucket
-
-    def list_buckets(self, max_results=None, page_token=None, prefix=None,
-                     projection='noAcl', fields=None):
-        """Get all buckets in the project associated to the client.
-
-        This will not populate the list of blobs available in each
-        bucket.
-
-          >>> for bucket in client.list_buckets():
-          >>>   print bucket
-
-        This implements "storage.buckets.list".
-
-        :type max_results: integer or ``NoneType``
-        :param max_results: Optional. Maximum number of buckets to return.
-
-        :type page_token: string or ``NoneType``
-        :param page_token: Optional. Opaque marker for the next "page" of
-                           buckets. If not passed, will return the first page
-                           of buckets.
-
-        :type prefix: string or ``NoneType``
-        :param prefix: Optional. Filter results to buckets whose names begin
-                       with this prefix.
-
-        :type projection: string or ``NoneType``
-        :param projection: If used, must be 'full' or 'noAcl'. Defaults to
-                           'noAcl'. Specifies the set of properties to return.
-
-        :type fields: string or ``NoneType``
-        :param fields: Selector specifying which fields to include in a
-                       partial response. Must be a list of fields. For example
-                       to get a partial response with just the next page token
-                       and the language of each bucket returned:
-                       'items/id,nextPageToken'
-
-        :rtype: iterable of :class:`google.cloud.storage.bucket.Bucket`
-                objects.
-        :returns: All buckets belonging to this project.
-        """
-        extra_params = {'project': self.project}
-
-        if max_results is not None:
-            extra_params['maxResults'] = max_results
-
-        if prefix is not None:
-            extra_params['prefix'] = prefix
-
-        extra_params['projection'] = projection
-
-        if fields is not None:
-            extra_params['fields'] = fields
-
-        result = _BucketIterator(client=self,
-                                 extra_params=extra_params)
-        # Page token must be handled specially since the base `Iterator`
-        # class has it as a reserved property.
-        if page_token is not None:
-            # pylint: disable=attribute-defined-outside-init
-            result.next_page_token = page_token
-            # pylint: enable=attribute-defined-outside-init
-        return result
-
-
-class _BucketIterator(Iterator):
-    """An iterator listing all buckets.
-
-    You shouldn't have to use this directly, but instead should use the
-    helper methods on :class:`google.cloud.storage.connection.Connection`
-    objects.
-
-    :type client: :class:`google.cloud.storage.client.Client`
-    :param client: The client to use for making connections.
-
-    :type extra_params: dict or ``NoneType``
-    :param extra_params: Extra query string parameters for the API call.
-    """
-
-    def __init__(self, client, extra_params=None):
-        super(_BucketIterator, self).__init__(client=client, path='/b',
-                                              extra_params=extra_params)
-
-    def get_items_from_response(self, response):
-        """Factory method which yields :class:`.Bucket` items from a response.
-
-        :type response: dict
-        :param response: The JSON API response for a page of buckets.
-        """
-        for item in response.get('items', []):
-            name = item.get('name')
-            bucket = Bucket(self.client, name)
-            bucket._set_properties(item)
-            yield bucket
diff --git a/google/cloud/storage/connection.py b/google/cloud/storage/connection.py
deleted file mode 100644
index 034767e8ff1f..000000000000
--- a/google/cloud/storage/connection.py
+++ /dev/null
@@ -1,43 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Create / interact with Google Cloud Storage connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Storage via the JSON REST API.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: (Optional) HTTP object to make requests.
-    """
-
-    API_BASE_URL = base_connection.API_BASE_URL
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/storage/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/devstorage.full_control',
-             'https://www.googleapis.com/auth/devstorage.read_only',
-             'https://www.googleapis.com/auth/devstorage.read_write')
-    """The scopes required for authenticating as a Cloud Storage consumer."""
diff --git a/google/cloud/streaming/__init__.py b/google/cloud/streaming/__init__.py
deleted file mode 100644
index 1a7427cf5f3b..000000000000
--- a/google/cloud/streaming/__init__.py
+++ /dev/null
@@ -1,17 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-# Vendored-in from google-apitools 0.4.11
-
-"""Base ``google.cloud.streaming`` package."""
diff --git a/google/cloud/streaming/buffered_stream.py b/google/cloud/streaming/buffered_stream.py
deleted file mode 100644
index e8c7497d317e..000000000000
--- a/google/cloud/streaming/buffered_stream.py
+++ /dev/null
@@ -1,104 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Small helper class to provide a small slice of a stream.
-
-This class reads ahead to detect if we are at the end of the stream.
-"""
-
-
-class BufferedStream(object):
-    """Buffers a stream, reading ahead to determine if we're at the end.
-
-    :type stream:  readable file-like object
-    :param stream:  the stream to be buffered
-
-    :type start: integer
-    :param start: the starting point in the stream
-
-    :type size: integer
-    :param size:  the size of the buffer
-    """
-    def __init__(self, stream, start, size):
-        self._stream = stream
-        self._start_pos = start
-        self._buffer_pos = 0
-
-        if not hasattr(self._stream, 'closed') or not self._stream.closed:
-            self._buffered_data = self._stream.read(size)
-        else:
-            self._buffered_data = b''
-
-        self._stream_at_end = len(self._buffered_data) < size
-        self._end_pos = self._start_pos + len(self._buffered_data)
-
-    def __repr__(self):
-        return ('Buffered stream %s from position %s-%s with %s '
-                'bytes remaining' % (self._stream, self._start_pos,
-                                     self._end_pos, self._bytes_remaining))
-
-    def __len__(self):
-        return len(self._buffered_data)
-
-    @property
-    def stream_exhausted(self):
-        """Does the stream have bytes remaining beyond the buffer
-
-        :rtype: boolean
-        :returns: Boolean indicating if the stream is exhausted.
-        """
-        return self._stream_at_end
-
-    @property
-    def stream_end_position(self):
-        """Point to which stream was read into the buffer
-
-        :rtype: integer
-        :returns: The end-position of the stream.
-        """
-        return self._end_pos
-
-    @property
-    def _bytes_remaining(self):
-        """Bytes remaining to be read from the buffer
-
-        :rtype: integer
-        :returns: The number of bytes remaining.
-        """
-        return len(self._buffered_data) - self._buffer_pos
-
-    def read(self, size=None):
-        """Read bytes from the buffer.
-
-        :type size: integer or None
-        :param size: How many bytes to read (defaults to all remaining bytes).
-
-        :rtype: str
-        :returns: The data read from the stream.
-        """
-        if size is None or size < 0:
-            raise ValueError(
-                'Illegal read of size %s requested on BufferedStream. '
-                'Wrapped stream %s is at position %s-%s, '
-                '%s bytes remaining.' %
-                (size, self._stream, self._start_pos, self._end_pos,
-                 self._bytes_remaining))
-
-        if not self._bytes_remaining:
-            return b''
-
-        size = min(size, self._bytes_remaining)
-        data = self._buffered_data[self._buffer_pos:self._buffer_pos + size]
-        self._buffer_pos += size
-        return data
diff --git a/google/cloud/streaming/exceptions.py b/google/cloud/streaming/exceptions.py
deleted file mode 100644
index 52192e132be4..000000000000
--- a/google/cloud/streaming/exceptions.py
+++ /dev/null
@@ -1,122 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Exceptions for generated client libraries."""
-
-
-class Error(Exception):
-    """Base class for all exceptions."""
-
-
-class CommunicationError(Error):
-    """Any communication error talking to an API server."""
-
-
-class HttpError(CommunicationError):
-    """Error making a request. Soon to be HttpError.
-
-    :type response: dict
-    :param response: headers from the response which returned the error
-
-    :type content: bytes
-    :param content: payload of the response which returned the error
-
-    :type url: string
-    :param url: URL of the response which returned the error
-    """
-    def __init__(self, response, content, url):
-        super(HttpError, self).__init__()
-        self.response = response
-        self.content = content
-        self.url = url
-
-    def __str__(self):
-        content = self.content.decode('ascii', 'replace')
-        return 'HttpError accessing <%s>: response: <%s>, content <%s>' % (
-            self.url, self.response, content)
-
-    @property
-    def status_code(self):
-        """Status code for the response.
-
-        :rtype: integer
-        :returns: the code
-        """
-        return int(self.response['status'])
-
-    @classmethod
-    def from_response(cls, http_response):
-        """Factory:  construct an exception from a response.
-
-        :type http_response: :class:`~.http_wrapper.Response`
-        :param http_response: the response which returned the error
-
-        :rtype: :class:`HttpError`
-        :returns: The error created from the response.
-        """
-        return cls(http_response.info, http_response.content,
-                   http_response.request_url)
-
-
-class TransferError(CommunicationError):
-    """Errors related to transfers."""
-
-
-class TransferRetryError(TransferError):
-    """Retryable errors related to transfers."""
-
-
-class TransferInvalidError(TransferError):
-    """The given transfer is invalid."""
-
-
-class RequestError(CommunicationError):
-    """The request was not successful."""
-
-
-class RetryAfterError(HttpError):
-    """The response contained a retry-after header.
-
-    :type response: dict
-    :param response: headers from the response which returned the error.
-
-    :type content: bytes
-    :param content: payload of the response which returned the error.
-
-    :type url: string
-    :param url: URL of the response which returned the error.
-
-    :type retry_after: integer
-    :param retry_after: seconds to wait before retrying.
-    """
-    def __init__(self, response, content, url, retry_after):
-        super(RetryAfterError, self).__init__(response, content, url)
-        self.retry_after = int(retry_after)
-
-    @classmethod
-    def from_response(cls, http_response):
-        """Factory:  construct an exception from a response.
-
-        :type http_response: :class:`~.http_wrapper.Response`
-        :param http_response: the response which returned the error.
-
-        :rtype: :class:`RetryAfterError`
-        :returns: The error created from the response.
-        """
-        return cls(http_response.info, http_response.content,
-                   http_response.request_url, http_response.retry_after)
-
-
-class BadStatusCodeError(HttpError):
-    """The request completed but returned a bad status code."""
diff --git a/google/cloud/streaming/http_wrapper.py b/google/cloud/streaming/http_wrapper.py
deleted file mode 100644
index 2c3d63d0c3ce..000000000000
--- a/google/cloud/streaming/http_wrapper.py
+++ /dev/null
@@ -1,395 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""HTTP wrapper for apitools.
-
-This library wraps the underlying http library we use, which is
-currently :mod:`httplib2`.
-"""
-
-import collections
-import contextlib
-import logging
-import socket
-import time
-
-import httplib2
-import six
-from six.moves import http_client
-from six.moves.urllib import parse
-
-from google.cloud.streaming.exceptions import BadStatusCodeError
-from google.cloud.streaming.exceptions import RequestError
-from google.cloud.streaming.exceptions import RetryAfterError
-from google.cloud.streaming.util import calculate_wait_for_retry
-
-
-_REDIRECTIONS = 5
-# 308 and 429 don't have names in httplib.
-RESUME_INCOMPLETE = 308
-TOO_MANY_REQUESTS = 429
-
-
-_REDIRECT_STATUS_CODES = (
-    http_client.MOVED_PERMANENTLY,
-    http_client.FOUND,
-    http_client.SEE_OTHER,
-    http_client.TEMPORARY_REDIRECT,
-    RESUME_INCOMPLETE,
-)
-
-
-_RETRYABLE_EXCEPTIONS = (
-    http_client.BadStatusLine,
-    http_client.IncompleteRead,
-    http_client.ResponseNotReady,
-    socket.error,
-    httplib2.ServerNotFoundError,
-    ValueError,
-    RequestError,
-    BadStatusCodeError,
-    RetryAfterError,
-)
-
-
-@contextlib.contextmanager
-def _httplib2_debug_level(http_request, level, http=None):
-    """Temporarily change the value of httplib2.debuglevel, if necessary.
-
-    If http_request has a `loggable_body` distinct from `body`, then we
-    need to prevent httplib2 from logging the full body. This sets
-    httplib2.debuglevel for the duration of the `with` block; however,
-    that alone won't change the value of existing HTTP connections. If
-    an httplib2.Http object is provided, we'll also change the level on
-    any cached connections attached to it.
-
-    :type http_request: :class:`Request`
-    :param http_request: the request to be logged.
-
-    :type level: integer
-    :param level: the debuglevel for logging.
-
-    :type http: :class:`httplib2.Http`, or ``None``
-    :param http: the instance on whose connections to set the debuglevel.
-    """
-    if http_request.loggable_body is None:
-        yield
-        return
-    old_level = httplib2.debuglevel
-    http_levels = {}
-    httplib2.debuglevel = level
-    if http is not None:
-        for connection_key, connection in http.connections.items():
-            # httplib2 stores two kinds of values in this dict, connection
-            # classes and instances. Since the connection types are all
-            # old-style classes, we can't easily distinguish by connection
-            # type -- so instead we use the key pattern.
-            if ':' not in connection_key:
-                continue
-            http_levels[connection_key] = connection.debuglevel
-            connection.set_debuglevel(level)
-    yield
-    httplib2.debuglevel = old_level
-    if http is not None:
-        for connection_key, old_level in http_levels.items():
-            http.connections[connection_key].set_debuglevel(old_level)
-
-
-class Request(object):
-    """Encapsulates the data for an HTTP request.
-
-    :type url: str
-    :param url: the URL for the request
-
-    :type http_method: str
-    :param http_method: the HTTP method to use for the request
-
-    :type headers: mapping or None
-    :param headers: headers to be sent with the request
-
-    :type body: str
-    :param body: body to be sent with the request
-    """
-    def __init__(self, url='', http_method='GET', headers=None, body=''):
-        self.url = url
-        self.http_method = http_method
-        self.headers = headers or {}
-        self._body = None
-        self._loggable_body = None
-        self.body = body
-
-    @property
-    def loggable_body(self):
-        """Request body for logging purposes
-
-        :rtype: str
-        :returns: The body to be logged.
-        """
-        return self._loggable_body
-
-    @loggable_body.setter
-    def loggable_body(self, value):
-        """Update request body for logging purposes
-
-        :type value: str
-        :param value: updated body
-
-        :raises: :exc:`RequestError` if the request does not have a body.
-        """
-        if self.body is None:
-            raise RequestError(
-                'Cannot set loggable body on request with no body')
-        self._loggable_body = value
-
-    @property
-    def body(self):
-        """Request body
-
-        :rtype: str
-        :returns: The body of the request.
-        """
-        return self._body
-
-    @body.setter
-    def body(self, value):
-        """Update the request body
-
-        Handles logging and length measurement.
-
-        :type value: str
-        :param value: updated body
-        """
-        self._body = value
-        if value is not None:
-            # Avoid calling len() which cannot exceed 4GiB in 32-bit python.
-            body_length = getattr(
-                self._body, 'length', None) or len(self._body)
-            self.headers['content-length'] = str(body_length)
-        else:
-            self.headers.pop('content-length', None)
-        # This line ensures we don't try to print large requests.
-        if not isinstance(value, (type(None), six.string_types)):
-            self.loggable_body = '<media body>'
-
-
-def _process_content_range(content_range):
-    """Convert a 'Content-Range' header into a length for the response.
-
-    Helper for :meth:`Response.length`.
-
-    :type content_range: str
-    :param content_range: the header value being parsed.
-
-    :rtype: integer
-    :returns: the length of the response chunk.
-    """
-    _, _, range_spec = content_range.partition(' ')
-    byte_range, _, _ = range_spec.partition('/')
-    start, _, end = byte_range.partition('-')
-    return int(end) - int(start) + 1
-
-
-# Note: currently the order of fields here is important, since we want
-# to be able to pass in the result from httplib2.request.
-_ResponseTuple = collections.namedtuple(
-    'HttpResponse', ['info', 'content', 'request_url'])
-
-
-class Response(_ResponseTuple):
-    """Encapsulates data for an HTTP response.
-    """
-    __slots__ = ()
-
-    def __len__(self):
-        return self.length
-
-    @property
-    def length(self):
-        """Length of this response.
-
-        Exposed as an attribute since using ``len()`` directly can fail
-        for responses larger than ``sys.maxint``.
-
-        :rtype: integer or long
-        :returns: The length of the response.
-        """
-        if 'content-encoding' in self.info and 'content-range' in self.info:
-            # httplib2 rewrites content-length in the case of a compressed
-            # transfer; we can't trust the content-length header in that
-            # case, but we *can* trust content-range, if it's present.
-            return _process_content_range(self.info['content-range'])
-        elif 'content-length' in self.info:
-            return int(self.info.get('content-length'))
-        elif 'content-range' in self.info:
-            return _process_content_range(self.info['content-range'])
-        return len(self.content)
-
-    @property
-    def status_code(self):
-        """HTTP status code
-
-        :rtype: integer
-        :returns: The response status code.
-        """
-        return int(self.info['status'])
-
-    @property
-    def retry_after(self):
-        """Retry interval (if set).
-
-        :rtype: integer
-        :returns: interval in seconds
-        """
-        if 'retry-after' in self.info:
-            return int(self.info['retry-after'])
-
-    @property
-    def is_redirect(self):
-        """Does this response contain a redirect
-
-        :rtype: boolean
-        :returns: True if the status code indicates a redirect and the
-                  'location' header is present.
-        """
-        return (self.status_code in _REDIRECT_STATUS_CODES and
-                'location' in self.info)
-
-
-def _check_response(response):
-    """Validate a response
-
-    :type response: :class:`Response`
-    :param response: the response to validate
-
-    :raises: :exc:`google.cloud.streaming.exceptions.RequestError` if response
-             is None, :exc:`~.exceptions.BadStatusCodeError` if response status
-             code indicates an error, or :exc:`~.exceptions.RetryAfterError`
-             if response indicates a retry interval.
-    """
-    if response is None:
-        # Caller shouldn't call us if the response is None, but handle anyway.
-        raise RequestError(
-            'Request did not return a response.')
-    elif (response.status_code >= 500 or
-          response.status_code == TOO_MANY_REQUESTS):
-        raise BadStatusCodeError.from_response(response)
-    elif response.retry_after:
-        raise RetryAfterError.from_response(response)
-
-
-def _reset_http_connections(http):
-    """Rebuild all http connections in the httplib2.Http instance.
-
-    httplib2 overloads the map in http.connections to contain two different
-    types of values:
-    { scheme string:  connection class } and
-    { scheme + authority string : actual http connection }
-    Here we remove all of the entries for actual connections so that on the
-    next request httplib2 will rebuild them from the connection types.
-
-    :type http: :class:`httplib2.Http`
-    :param http: the instance whose connections are to be rebuilt
-    """
-    if getattr(http, 'connections', None):
-        for conn_key in list(http.connections.keys()):
-            if ':' in conn_key:
-                del http.connections[conn_key]
-
-
-def _make_api_request_no_retry(http, http_request, redirections=_REDIRECTIONS):
-    """Send an HTTP request via the given http instance.
-
-    This wrapper exists to handle translation between the plain httplib2
-    request/response types and the Request and Response types above.
-
-    :type http: :class:`httplib2.Http`
-    :param http: an instance which impelements the `Http` API.
-
-    :type http_request: :class:`Request`
-    :param http_request: the request to send.
-
-    :type redirections: integer
-    :param redirections: Number of redirects to follow.
-
-    :rtype: :class:`Response`
-    :returns: an object representing the server's response
-
-    :raises: :exc:`google.cloud.streaming.exceptions.RequestError` if no
-             response could be parsed.
-    """
-    connection_type = None
-    # Handle overrides for connection types.  This is used if the caller
-    # wants control over the underlying connection for managing callbacks
-    # or hash digestion.
-    if getattr(http, 'connections', None):
-        url_scheme = parse.urlsplit(http_request.url).scheme
-        if url_scheme and url_scheme in http.connections:
-            connection_type = http.connections[url_scheme]
-
-    # Custom printing only at debuglevel 4
-    new_debuglevel = 4 if httplib2.debuglevel == 4 else 0
-    with _httplib2_debug_level(http_request, new_debuglevel, http=http):
-        info, content = http.request(
-            str(http_request.url), method=str(http_request.http_method),
-            body=http_request.body, headers=http_request.headers,
-            redirections=redirections, connection_type=connection_type)
-
-    if info is None:
-        raise RequestError()
-
-    response = Response(info, content, http_request.url)
-    _check_response(response)
-    return response
-
-
-def make_api_request(http, http_request, retries=7,
-                     redirections=_REDIRECTIONS):
-    """Send an HTTP request via the given http, performing error/retry handling.
-
-    :type http: :class:`httplib2.Http`
-    :param http: an instance which implements the `Http` API.
-
-    :type http_request: :class:`Request`
-    :param http_request: the request to send.
-
-    :type retries: integer
-    :param retries: Number of retries to attempt on retryable
-                    responses (such as 429 or 5XX).
-
-    :type redirections: integer
-    :param redirections: Number of redirects to follow.
-
-    :rtype: :class:`Response`
-    :returns: an object representing the server's response.
-
-    :raises: :exc:`google.cloud.streaming.exceptions.RequestError` if no
-             response could be parsed.
-    """
-    retry = 0
-    while True:
-        try:
-            return _make_api_request_no_retry(http, http_request,
-                                              redirections=redirections)
-        except _RETRYABLE_EXCEPTIONS as exc:
-            retry += 1
-            if retry >= retries:
-                raise
-            retry_after = getattr(exc, 'retry_after', None)
-            if retry_after is None:
-                retry_after = calculate_wait_for_retry(retry)
-
-            _reset_http_connections(http)
-            logging.debug('Retrying request to url %s after exception %s',
-                          http_request.url, type(exc).__name__)
-            time.sleep(retry_after)
diff --git a/google/cloud/streaming/stream_slice.py b/google/cloud/streaming/stream_slice.py
deleted file mode 100644
index 67f3cc9b2699..000000000000
--- a/google/cloud/streaming/stream_slice.py
+++ /dev/null
@@ -1,85 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Small helper class to provide a small slice of a stream."""
-
-from six.moves import http_client
-
-
-class StreamSlice(object):
-    """Provides a slice-like object for streams.
-
-    :type stream:  readable file-like object
-    :param stream:  the stream to be buffered.
-
-    :type max_bytes: integer
-    :param max_bytes: maximum number of bytes to return in the slice.
-    """
-    def __init__(self, stream, max_bytes):
-        self._stream = stream
-        self._remaining_bytes = max_bytes
-        self._max_bytes = max_bytes
-
-    def __repr__(self):
-        return 'Slice of stream %s with %s/%s bytes not yet read' % (
-            self._stream, self._remaining_bytes, self._max_bytes)
-
-    def __len__(self):
-        return self._max_bytes
-
-    def __nonzero__(self):
-        # For 32-bit python2.x, len() cannot exceed a 32-bit number; avoid
-        # accidental len() calls from httplib in the form of "if this_object:".
-        return bool(self._max_bytes)
-
-    @property
-    def length(self):
-        """Maximum number of bytes to return in the slice.
-
-        .. note::
-
-           For 32-bit python2.x, len() cannot exceed a 32-bit number.
-
-        :rtype: integer
-        :returns: The max "length" of the stream.
-        """
-        return self._max_bytes
-
-    def read(self, size=None):
-        """Read bytes from the slice.
-
-        Compared to other streams, there is one case where we may
-        unexpectedly raise an exception on read: if the underlying stream
-        is exhausted (i.e. returns no bytes on read), and the size of this
-        slice indicates we should still be able to read more bytes, we
-        raise :exc:`IncompleteRead`.
-
-        :type size: integer or None
-        :param size: If provided, read no more than size bytes from the stream.
-
-        :rtype: bytes
-        :returns: bytes read from this slice.
-
-        :raises: :exc:`IncompleteRead`
-        """
-        if size is not None:
-            read_size = min(size, self._remaining_bytes)
-        else:
-            read_size = self._remaining_bytes
-        data = self._stream.read(read_size)
-        if read_size > 0 and not data:
-            raise http_client.IncompleteRead(
-                self._max_bytes - self._remaining_bytes, self._max_bytes)
-        self._remaining_bytes -= len(data)
-        return data
diff --git a/google/cloud/streaming/transfer.py b/google/cloud/streaming/transfer.py
deleted file mode 100644
index 8738bb349d8b..000000000000
--- a/google/cloud/streaming/transfer.py
+++ /dev/null
@@ -1,1215 +0,0 @@
-# pylint: disable=too-many-lines
-
-# Copyright 2016 Google Inc. 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.
-
-"""Upload and download support for apitools."""
-
-import email.generator as email_generator
-import email.mime.multipart as mime_multipart
-import email.mime.nonmultipart as mime_nonmultipart
-import mimetypes
-import os
-
-import httplib2
-import six
-from six.moves import http_client
-
-from google.cloud._helpers import _to_bytes
-from google.cloud.streaming.buffered_stream import BufferedStream
-from google.cloud.streaming.exceptions import CommunicationError
-from google.cloud.streaming.exceptions import HttpError
-from google.cloud.streaming.exceptions import TransferInvalidError
-from google.cloud.streaming.exceptions import TransferRetryError
-from google.cloud.streaming.http_wrapper import make_api_request
-from google.cloud.streaming.http_wrapper import Request
-from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-from google.cloud.streaming.stream_slice import StreamSlice
-from google.cloud.streaming.util import acceptable_mime_type
-
-
-RESUMABLE_UPLOAD_THRESHOLD = 5 << 20
-SIMPLE_UPLOAD = 'simple'
-RESUMABLE_UPLOAD = 'resumable'
-
-
-_DEFAULT_CHUNKSIZE = 1 << 20
-
-
-class _Transfer(object):
-    """Generic bits common to Uploads and Downloads.
-
-    :type stream: file-like object
-    :param stream: stream to/from which data is downloaded/uploaded.
-
-    :type close_stream: boolean
-    :param close_stream: should this instance close the stream when deleted
-
-    :type chunksize: integer
-    :param chunksize: the size of chunks used to download/upload a file.
-
-    :type auto_transfer: boolean
-    :param auto_transfer: should this instance automatically begin transfering
-                          data when initialized
-
-    :type http: :class:`httplib2.Http` (or workalike)
-    :param http: Http instance used to perform requests.
-
-    :type num_retries: integer
-    :param num_retries: how many retries should the transfer attempt
-    """
-
-    _num_retries = None
-
-    def __init__(self, stream, close_stream=False,
-                 chunksize=_DEFAULT_CHUNKSIZE, auto_transfer=True,
-                 http=None, num_retries=5):
-        self._bytes_http = None
-        self._close_stream = close_stream
-        self._http = http
-        self._stream = stream
-        self._url = None
-
-        # Let the @property do validation.
-        self.num_retries = num_retries
-
-        self.auto_transfer = auto_transfer
-        self.chunksize = chunksize
-
-    def __repr__(self):
-        return str(self)
-
-    @property
-    def close_stream(self):
-        """Should this instance close the stream when deleted.
-
-        :rtype: boolean
-        :returns: Boolean indicated if the stream should be closed.
-        """
-        return self._close_stream
-
-    @property
-    def http(self):
-        """Http instance used to perform requests.
-
-        :rtype: :class:`httplib2.Http` (or workalike)
-        :returns: The HTTP object used for requests.
-        """
-        return self._http
-
-    @property
-    def bytes_http(self):
-        """Http instance used to perform binary requests.
-
-        Defaults to :attr:`http`.
-
-        :rtype: :class:`httplib2.Http` (or workalike)
-        :returns: The HTTP object used for binary requests.
-        """
-        return self._bytes_http or self.http
-
-    @bytes_http.setter
-    def bytes_http(self, value):
-        """Update Http instance used to perform binary requests.
-
-        :type value: :class:`httplib2.Http` (or workalike)
-        :param value: new instance
-        """
-        self._bytes_http = value
-
-    @property
-    def num_retries(self):
-        """How many retries should the transfer attempt
-
-        :rtype: integer
-        :returns: The number of retries allowed.
-        """
-        return self._num_retries
-
-    @num_retries.setter
-    def num_retries(self, value):
-        """Update how many retries should the transfer attempt
-
-        :type value: integer
-        """
-        if not isinstance(value, six.integer_types):
-            raise ValueError("num_retries: pass an integer")
-
-        if value < 0:
-            raise ValueError(
-                'Cannot have negative value for num_retries')
-        self._num_retries = value
-
-    @property
-    def stream(self):
-        """Stream to/from which data is downloaded/uploaded.
-
-        :rtype: file-like object
-        :returns: The stream that sends/receives data.
-        """
-        return self._stream
-
-    @property
-    def url(self):
-        """URL to / from which data is downloaded/uploaded.
-
-        :rtype: string
-        :returns: The URL where data is sent/received.
-        """
-        return self._url
-
-    def _initialize(self, http, url):
-        """Initialize this download by setting :attr:`http` and :attr`url`.
-
-        Allow the user to be able to pre-initialize :attr:`http` by setting
-        the value in the constructor; in that case, we ignore the provided
-        http.
-
-        :type http: :class:`httplib2.Http` (or a worklike) or None.
-        :param http: the Http instance to use to make requests.
-
-        :type url: string
-        :param url: The url for this transfer.
-        """
-        self._ensure_uninitialized()
-        if self.http is None:
-            self._http = http or httplib2.Http()
-        self._url = url
-
-    @property
-    def initialized(self):
-        """Has the instance been initialized
-
-        :rtype: boolean
-        :returns: Boolean indicating if the current transfer
-                  has been initialized.
-        """
-        return self.url is not None and self.http is not None
-
-    def _ensure_initialized(self):
-        """Helper:  assert that the instance is initialized.
-
-        :raises: :exc:`google.cloud.streaming.exceptions.TransferInvalidError`
-                 if the instance is not initialized.
-        """
-        if not self.initialized:
-            raise TransferInvalidError(
-                'Cannot use uninitialized %s', type(self).__name__)
-
-    def _ensure_uninitialized(self):
-        """Helper:  assert that the instance is not initialized.
-
-        :raises: :exc:`google.cloud.streaming.exceptions.TransferInvalidError`
-                 if the instance is already initialized.
-        """
-        if self.initialized:
-            raise TransferInvalidError(
-                'Cannot re-initialize %s', type(self).__name__)
-
-    def __del__(self):
-        if self._close_stream:
-            self._stream.close()
-
-
-class Download(_Transfer):
-    """Represent a single download.
-
-    :type stream: file-like object
-    :param stream: stream to/from which data is downloaded/uploaded.
-
-    :type kwds: dict
-    :param kwds:  keyword arguments:  all except ``total_size`` are passed
-                  through to :meth:`_Transfer.__init__()`.
-    """
-    _ACCEPTABLE_STATUSES = set((
-        http_client.OK,
-        http_client.NO_CONTENT,
-        http_client.PARTIAL_CONTENT,
-        http_client.REQUESTED_RANGE_NOT_SATISFIABLE,
-    ))
-
-    def __init__(self, stream, **kwds):
-        total_size = kwds.pop('total_size', None)
-        super(Download, self).__init__(stream, **kwds)
-        self._initial_response = None
-        self._progress = 0
-        self._total_size = total_size
-        self._encoding = None
-
-    @classmethod
-    def from_file(cls, filename, overwrite=False, auto_transfer=True, **kwds):
-        """Create a new download object from a filename.
-
-        :type filename: string
-        :param filename: path/filename for the target file
-
-        :type overwrite: boolean
-        :param overwrite: should an existing file be overwritten
-
-        :type auto_transfer: boolean
-        :param auto_transfer: should the transfer be started immediately
-
-        :type kwds: dict
-        :param kwds:  keyword arguments:  passed
-                      through to :meth:`_Transfer.__init__()`.
-
-        :rtype: :class:`Download`
-        :returns: The download initiated from the file passed.
-        """
-        path = os.path.expanduser(filename)
-        if os.path.exists(path) and not overwrite:
-            raise ValueError(
-                'File %s exists and overwrite not specified' % path)
-        return cls(open(path, 'wb'), close_stream=True,
-                   auto_transfer=auto_transfer, **kwds)
-
-    @classmethod
-    def from_stream(cls, stream, auto_transfer=True, total_size=None, **kwds):
-        """Create a new Download object from a stream.
-
-        :type stream: writable file-like object
-        :param stream: the target file
-
-        :type total_size: integer or None
-        :param total_size: total size of the file to be downloaded
-
-        :type auto_transfer: boolean
-        :param auto_transfer: should the transfer be started immediately
-
-        :type kwds: dict
-        :param kwds:  keyword arguments:  passed
-                      through to :meth:`_Transfer.__init__()`.
-
-        :rtype: :class:`Download`
-        :returns: The download initiated from the stream passed.
-        """
-        return cls(stream, auto_transfer=auto_transfer, total_size=total_size,
-                   **kwds)
-
-    @property
-    def progress(self):
-        """Number of bytes have been downloaded.
-
-        :rtype: integer >= 0
-        :returns: The number of downloaded bytes.
-        """
-        return self._progress
-
-    @property
-    def total_size(self):
-        """Total number of bytes to be downloaded.
-
-        :rtype: integer or None
-        :returns: The total number of bytes to download.
-        """
-        return self._total_size
-
-    @property
-    def encoding(self):
-        """'Content-Encoding' used to transfer the file
-
-        :rtype: string or None
-        :returns: The encoding of the downloaded content.
-        """
-        return self._encoding
-
-    def __repr__(self):
-        if not self.initialized:
-            return 'Download (uninitialized)'
-        else:
-            return 'Download with %d/%s bytes transferred from url %s' % (
-                self.progress, self.total_size, self.url)
-
-    def configure_request(self, http_request, url_builder):
-        """Update http_request/url_builder with download-appropriate values.
-
-        :type http_request: :class:`~.streaming.http_wrapper.Request`
-        :param http_request: the request to be updated
-
-        :type url_builder: instance with settable 'query_params' attribute.
-        :param url_builder: transfer policy object to be updated
-        """
-        url_builder.query_params['alt'] = 'media'
-        http_request.headers['Range'] = 'bytes=0-%d' % (self.chunksize - 1,)
-
-    def _set_total(self, info):
-        """Update 'total_size' based on data from a response.
-
-        :type info: mapping
-        :param info: response headers
-        """
-        if 'content-range' in info:
-            _, _, total = info['content-range'].rpartition('/')
-            if total != '*':
-                self._total_size = int(total)
-        # Note "total_size is None" means we don't know it; if no size
-        # info was returned on our initial range request, that means we
-        # have a 0-byte file. (That last statement has been verified
-        # empirically, but is not clearly documented anywhere.)
-        if self.total_size is None:
-            self._total_size = 0
-
-    def initialize_download(self, http_request, http):
-        """Initialize this download.
-
-        If the instance has :attr:`auto_transfer` enabled, begins the
-        download immediately.
-
-        :type http_request: :class:`~.streaming.http_wrapper.Request`
-        :param http_request: the request to use to initialize this download.
-
-        :type http: :class:`httplib2.Http` (or workalike)
-        :param http: Http instance for this request.
-        """
-        self._ensure_uninitialized()
-        url = http_request.url
-        if self.auto_transfer:
-            end_byte = self._compute_end_byte(0)
-            self._set_range_header(http_request, 0, end_byte)
-            response = make_api_request(
-                self.bytes_http or http, http_request)
-            if response.status_code not in self._ACCEPTABLE_STATUSES:
-                raise HttpError.from_response(response)
-            self._initial_response = response
-            self._set_total(response.info)
-            url = response.info.get('content-location', response.request_url)
-        self._initialize(http, url)
-        # Unless the user has requested otherwise, we want to just
-        # go ahead and pump the bytes now.
-        if self.auto_transfer:
-            self.stream_file(use_chunks=True)
-
-    def _normalize_start_end(self, start, end=None):
-        """Validate / fix up byte range.
-
-        :type start: integer
-        :param start: start byte of the range:  if negative, used as an
-                      offset from the end.
-
-        :type end: integer
-        :param end: end byte of the range.
-
-        :rtype: tuple, (start, end)
-        :returns:  the normalized start, end pair.
-        :raises: :exc:`google.cloud.streaming.exceptions.TransferInvalidError`
-                 for invalid combinations of start, end.
-        """
-        if end is not None:
-            if start < 0:
-                raise TransferInvalidError(
-                    'Cannot have end index with negative start index')
-            elif start >= self.total_size:
-                raise TransferInvalidError(
-                    'Cannot have start index greater than total size')
-            end = min(end, self.total_size - 1)
-            if end < start:
-                raise TransferInvalidError(
-                    'Range requested with end[%s] < start[%s]' % (end, start))
-            return start, end
-        else:
-            if start < 0:
-                start = max(0, start + self.total_size)
-            return start, self.total_size - 1
-
-    @staticmethod
-    def _set_range_header(request, start, end=None):
-        """Update the 'Range' header in a request to match a byte range.
-
-        :type request: :class:`google.cloud.streaming.http_wrapper.Request`
-        :param request: the request to update
-
-        :type start: integer
-        :param start: start byte of the range:  if negative, used as an
-                      offset from the end.
-
-        :type end: integer
-        :param end: end byte of the range.
-        """
-        if start < 0:
-            request.headers['range'] = 'bytes=%d' % start
-        elif end is None:
-            request.headers['range'] = 'bytes=%d-' % start
-        else:
-            request.headers['range'] = 'bytes=%d-%d' % (start, end)
-
-    def _compute_end_byte(self, start, end=None, use_chunks=True):
-        """Compute the last byte to fetch for this request.
-
-        Based on the HTTP spec for Range and Content-Range.
-
-        .. note::
-           This is potentially confusing in several ways:
-           - the value for the last byte is 0-based, eg "fetch 10 bytes
-             from the beginning" would return 9 here.
-           - if we have no information about size, and don't want to
-             use the chunksize, we'll return None.
-
-        :type start: integer
-        :param start: start byte of the range.
-
-        :type end: integer or None
-        :param end: suggested last byte of the range.
-
-        :type use_chunks: boolean
-        :param use_chunks: If False, ignore :attr:`chunksize`.
-
-        :rtype: str
-        :returns: Last byte to use in a 'Range' header, or None.
-        """
-        end_byte = end
-
-        if start < 0 and not self.total_size:
-            return end_byte
-
-        if use_chunks:
-            alternate = start + self.chunksize - 1
-            if end_byte is not None:
-                end_byte = min(end_byte, alternate)
-            else:
-                end_byte = alternate
-
-        if self.total_size:
-            alternate = self.total_size - 1
-            if end_byte is not None:
-                end_byte = min(end_byte, alternate)
-            else:
-                end_byte = alternate
-
-        return end_byte
-
-    def _get_chunk(self, start, end):
-        """Retrieve a chunk of the file.
-
-        :type start: integer
-        :param start: start byte of the range.
-
-        :type end: integer or None
-        :param end: end byte of the range.
-
-        :rtype: :class:`google.cloud.streaming.http_wrapper.Response`
-        :returns: response from the chunk request.
-        """
-        self._ensure_initialized()
-        request = Request(url=self.url)
-        self._set_range_header(request, start, end=end)
-        return make_api_request(
-            self.bytes_http, request, retries=self.num_retries)
-
-    def _process_response(self, response):
-        """Update attribtes and writing stream, based on response.
-
-        :type response: :class:`google.cloud.streaming.http_wrapper.Response`
-        :param response: response from a download request.
-
-        :rtype: :class:`google.cloud.streaming.http_wrapper.Response`
-        :returns: the response
-        :raises: :exc:`google.cloud.streaming.exceptions.HttpError` for
-                 missing / unauthorized responses;
-                 :exc:`google.cloud.streaming.exceptions.TransferRetryError`
-                 for other error responses.
-        """
-        if response.status_code not in self._ACCEPTABLE_STATUSES:
-            # We distinguish errors that mean we made a mistake in setting
-            # up the transfer versus something we should attempt again.
-            if response.status_code in (http_client.FORBIDDEN,
-                                        http_client.NOT_FOUND):
-                raise HttpError.from_response(response)
-            else:
-                raise TransferRetryError(response.content)
-        if response.status_code in (http_client.OK,
-                                    http_client.PARTIAL_CONTENT):
-            self.stream.write(response.content)
-            self._progress += response.length
-            if response.info and 'content-encoding' in response.info:
-                self._encoding = response.info['content-encoding']
-        elif response.status_code == http_client.NO_CONTENT:
-            # It's important to write something to the stream for the case
-            # of a 0-byte download to a file, as otherwise python won't
-            # create the file.
-            self.stream.write('')
-        return response
-
-    def get_range(self, start, end=None, use_chunks=True):
-        """Retrieve a given byte range from this download, inclusive.
-
-        Writes retrieved bytes into :attr:`stream`.
-
-        Range must be of one of these three forms:
-        * 0 <= start, end = None: Fetch from start to the end of the file.
-        * 0 <= start <= end: Fetch the bytes from start to end.
-        * start < 0, end = None: Fetch the last -start bytes of the file.
-
-        (These variations correspond to those described in the HTTP 1.1
-        protocol for range headers in RFC 2616, sec. 14.35.1.)
-
-        :type start: integer
-        :param start: Where to start fetching bytes. (See above.)
-
-        :type end: integer or ``None``
-        :param end: Where to stop fetching bytes. (See above.)
-
-        :type use_chunks: boolean
-        :param use_chunks: If False, ignore :attr:`chunksize`
-                           and fetch this range in a single request.
-                           If True, streams via chunks.
-
-        :raises: :exc:`google.cloud.streaming.exceptions.TransferRetryError`
-                 if a request returns an empty response.
-        """
-        self._ensure_initialized()
-        progress_end_normalized = False
-        if self.total_size is not None:
-            progress, end_byte = self._normalize_start_end(start, end)
-            progress_end_normalized = True
-        else:
-            progress = start
-            end_byte = end
-        while (not progress_end_normalized or end_byte is None or
-               progress <= end_byte):
-            end_byte = self._compute_end_byte(progress, end=end_byte,
-                                              use_chunks=use_chunks)
-            response = self._get_chunk(progress, end_byte)
-            if not progress_end_normalized:
-                self._set_total(response.info)
-                progress, end_byte = self._normalize_start_end(start, end)
-                progress_end_normalized = True
-            response = self._process_response(response)
-            progress += response.length
-            if response.length == 0:
-                raise TransferRetryError(
-                    'Zero bytes unexpectedly returned in download response')
-
-    def stream_file(self, use_chunks=True):
-        """Stream the entire download.
-
-        Writes retrieved bytes into :attr:`stream`.
-
-        :type use_chunks: boolean
-        :param use_chunks: If False, ignore :attr:`chunksize`
-                           and stream this download in a single request.
-                           If True, streams via chunks.
-        """
-        self._ensure_initialized()
-        while True:
-            if self._initial_response is not None:
-                response = self._initial_response
-                self._initial_response = None
-            else:
-                end_byte = self._compute_end_byte(self.progress,
-                                                  use_chunks=use_chunks)
-                response = self._get_chunk(self.progress, end_byte)
-            if self.total_size is None:
-                self._set_total(response.info)
-            response = self._process_response(response)
-            if (response.status_code == http_client.OK or
-                    self.progress >= self.total_size):
-                break
-
-
-class Upload(_Transfer):
-    """Represent a single Upload.
-
-    :type stream: file-like object
-    :param stream: stream to/from which data is downloaded/uploaded.
-
-    :type mime_type: string:
-    :param mime_type: MIME type of the upload.
-
-    :type total_size: integer or None
-    :param total_size: Total upload size for the stream.
-
-    :type http: :class:`httplib2.Http` (or workalike)
-    :param http: Http instance used to perform requests.
-
-    :type close_stream: boolean
-    :param close_stream: should this instance close the stream when deleted
-
-    :type auto_transfer: boolean
-    :param auto_transfer: should this instance automatically begin transfering
-                          data when initialized
-
-    :type kwds: dict
-    :param kwds:  keyword arguments:  all except ``total_size`` are passed
-                  through to :meth:`_Transfer.__init__()`.
-    """
-    _REQUIRED_SERIALIZATION_KEYS = set((
-        'auto_transfer', 'mime_type', 'total_size', 'url'))
-
-    def __init__(self, stream, mime_type, total_size=None, http=None,
-                 close_stream=False, auto_transfer=True,
-                 **kwds):
-        super(Upload, self).__init__(
-            stream, close_stream=close_stream, auto_transfer=auto_transfer,
-            http=http, **kwds)
-        self._final_response = None
-        self._server_chunk_granularity = None
-        self._complete = False
-        self._mime_type = mime_type
-        self._progress = 0
-        self._strategy = None
-        self._total_size = total_size
-
-    @classmethod
-    def from_file(cls, filename, mime_type=None, auto_transfer=True, **kwds):
-        """Create a new Upload object from a filename.
-
-        :type filename: string
-        :param filename: path/filename to the file being uploaded
-
-        :type mime_type: string
-        :param mime_type:  MIMEtype of the file being uploaded
-
-        :type auto_transfer: boolean or None
-        :param auto_transfer: should the transfer be started immediately
-
-        :type kwds: dict
-        :param kwds:  keyword arguments:  passed
-                      through to :meth:`_Transfer.__init__()`.
-
-        :rtype: :class:`Upload`
-        :returns: The upload initiated from the file passed.
-        """
-        path = os.path.expanduser(filename)
-        if not mime_type:
-            mime_type, _ = mimetypes.guess_type(path)
-            if mime_type is None:
-                raise ValueError(
-                    'Could not guess mime type for %s' % path)
-        size = os.stat(path).st_size
-        return cls(open(path, 'rb'), mime_type, total_size=size,
-                   close_stream=True, auto_transfer=auto_transfer, **kwds)
-
-    @classmethod
-    def from_stream(cls, stream, mime_type,
-                    total_size=None, auto_transfer=True, **kwds):
-        """Create a new Upload object from a stream.
-
-        :type stream: writable file-like object
-        :param stream: the target file
-
-        :type mime_type: string
-        :param mime_type:  MIMEtype of the file being uploaded
-
-        :type total_size: integer or None
-        :param total_size:  Size of the file being uploaded
-
-        :type auto_transfer: boolean or None
-        :param auto_transfer: should the transfer be started immediately
-
-        :type kwds: dict
-        :param kwds:  keyword arguments:  passed
-                      through to :meth:`_Transfer.__init__()`.
-
-        :rtype: :class:`Upload`
-        :returns: The upload initiated from the stream passed.
-        """
-        if mime_type is None:
-            raise ValueError(
-                'No mime_type specified for stream')
-        return cls(stream, mime_type, total_size=total_size,
-                   close_stream=False, auto_transfer=auto_transfer, **kwds)
-
-    @property
-    def complete(self):
-        """Has the entire stream been uploaded.
-
-        :rtype: boolean
-        :returns: Boolean indicated if the upload is complete.
-        """
-        return self._complete
-
-    @property
-    def mime_type(self):
-        """MIMEtype of the file being uploaded.
-
-        :rtype: string
-        :returns: The mime-type of the upload.
-        """
-        return self._mime_type
-
-    @property
-    def progress(self):
-        """Bytes uploaded so far
-
-        :rtype: integer
-        :returns: The amount uploaded so far.
-        """
-        return self._progress
-
-    @property
-    def strategy(self):
-        """Upload strategy to use
-
-        :rtype: string or None
-        :returns: The strategy used to upload the data.
-        """
-        return self._strategy
-
-    @strategy.setter
-    def strategy(self, value):
-        """Update upload strategy to use
-
-        :type value: string (one of :data:`SIMPLE_UPLOAD` or
-                :data:`RESUMABLE_UPLOAD`)
-
-        :raises: :exc:`ValueError` if value is not one of the two allowed
-                 strings.
-        """
-        if value not in (SIMPLE_UPLOAD, RESUMABLE_UPLOAD):
-            raise ValueError((
-                'Invalid value "%s" for upload strategy, must be one of '
-                '"simple" or "resumable".') % value)
-        self._strategy = value
-
-    @property
-    def total_size(self):
-        """Total size of the stream to be uploaded.
-
-        :rtype: integer or None
-        :returns: The total size to be uploaded.
-        """
-        return self._total_size
-
-    @total_size.setter
-    def total_size(self, value):
-        """Update total size of the stream to be uploaded.
-
-        :type value: integer or None
-        :param value: the size
-        """
-        self._ensure_uninitialized()
-        self._total_size = value
-
-    def __repr__(self):
-        if not self.initialized:
-            return 'Upload (uninitialized)'
-        else:
-            return 'Upload with %d/%s bytes transferred for url %s' % (
-                self.progress, self.total_size or '???', self.url)
-
-    def _set_default_strategy(self, upload_config, http_request):
-        """Determine and set the default upload strategy for this upload.
-
-        We generally prefer simple or multipart, unless we're forced to
-        use resumable. This happens when any of (1) the upload is too
-        large, (2) the simple endpoint doesn't support multipart requests
-        and we have metadata, or (3) there is no simple upload endpoint.
-
-        :type upload_config: instance w/ ``max_size`` and ``accept``
-                             attributes
-        :param upload_config: Configuration for the upload endpoint.
-
-        :type http_request: :class:`~.streaming.http_wrapper.Request`
-        :param http_request: The associated http request.
-        """
-        if upload_config.resumable_path is None:
-            self.strategy = SIMPLE_UPLOAD
-        if self.strategy is not None:
-            return
-        strategy = SIMPLE_UPLOAD
-        if (self.total_size is not None and
-                self.total_size > RESUMABLE_UPLOAD_THRESHOLD):
-            strategy = RESUMABLE_UPLOAD
-        if http_request.body and not upload_config.simple_multipart:
-            strategy = RESUMABLE_UPLOAD
-        if not upload_config.simple_path:
-            strategy = RESUMABLE_UPLOAD
-        self.strategy = strategy
-
-    def configure_request(self, upload_config, http_request, url_builder):
-        """Configure the request and url for this upload.
-
-        :type upload_config: instance w/ ``max_size`` and ``accept``
-                             attributes
-        :param upload_config: transfer policy object to be queried
-
-        :type http_request: :class:`~.streaming.http_wrapper.Request`
-        :param http_request: the request to be updated
-
-        :type url_builder: instance with settable 'relative_path' and
-                           'query_params' attributes.
-        :param url_builder: transfer policy object to be updated
-
-        :raises: :exc:`ValueError` if the requested upload is too big,
-                  or does not have an acceptable MIME type.
-        """
-        # Validate total_size vs. max_size
-        if (self.total_size and upload_config.max_size and
-                self.total_size > upload_config.max_size):
-            raise ValueError(
-                'Upload too big: %s larger than max size %s' % (
-                    self.total_size, upload_config.max_size))
-        # Validate mime type
-        if not acceptable_mime_type(upload_config.accept, self.mime_type):
-            raise ValueError(
-                'MIME type %s does not match any accepted MIME ranges %s' % (
-                    self.mime_type, upload_config.accept))
-
-        self._set_default_strategy(upload_config, http_request)
-        if self.strategy == SIMPLE_UPLOAD:
-            url_builder.relative_path = upload_config.simple_path
-            if http_request.body:
-                url_builder.query_params['uploadType'] = 'multipart'
-                self._configure_multipart_request(http_request)
-            else:
-                url_builder.query_params['uploadType'] = 'media'
-                self._configure_media_request(http_request)
-        else:
-            url_builder.relative_path = upload_config.resumable_path
-            url_builder.query_params['uploadType'] = 'resumable'
-            self._configure_resumable_request(http_request)
-
-    def _configure_media_request(self, http_request):
-        """Helper for 'configure_request': set up simple request."""
-        http_request.headers['content-type'] = self.mime_type
-        http_request.body = self.stream.read()
-        http_request.loggable_body = '<media body>'
-
-    def _configure_multipart_request(self, http_request):
-        """Helper for 'configure_request': set up multipart request."""
-        # This is a multipart/related upload.
-        msg_root = mime_multipart.MIMEMultipart('related')
-        # msg_root should not write out its own headers
-        setattr(msg_root, '_write_headers', lambda self: None)
-
-        # attach the body as one part
-        msg = mime_nonmultipart.MIMENonMultipart(
-            *http_request.headers['content-type'].split('/'))
-        msg.set_payload(http_request.body)
-        msg_root.attach(msg)
-
-        # attach the media as the second part
-        msg = mime_nonmultipart.MIMENonMultipart(*self.mime_type.split('/'))
-        msg['Content-Transfer-Encoding'] = 'binary'
-        msg.set_payload(self.stream.read())
-        msg_root.attach(msg)
-
-        # NOTE: generate multipart message as bytes, not text
-        stream = six.BytesIO()
-        if six.PY3:  # pragma: NO COVER  Python3
-            generator_class = email_generator.BytesGenerator
-        else:
-            generator_class = email_generator.Generator
-        generator = generator_class(stream, mangle_from_=False)
-        generator.flatten(msg_root, unixfrom=False)
-        http_request.body = stream.getvalue()
-
-        multipart_boundary = msg_root.get_boundary()
-        http_request.headers['content-type'] = (
-            'multipart/related; boundary="%s"' % multipart_boundary)
-
-        boundary_bytes = _to_bytes(multipart_boundary)
-        body_components = http_request.body.split(boundary_bytes)
-        headers, _, _ = body_components[-2].partition(b'\n\n')
-        body_components[-2] = b'\n\n'.join([headers, b'<media body>\n\n--'])
-        http_request.loggable_body = boundary_bytes.join(body_components)
-
-    def _configure_resumable_request(self, http_request):
-        """Helper for 'configure_request': set up resumable request."""
-        http_request.headers['X-Upload-Content-Type'] = self.mime_type
-        if self.total_size is not None:
-            http_request.headers[
-                'X-Upload-Content-Length'] = str(self.total_size)
-
-    def refresh_upload_state(self):
-        """Refresh the state of a resumable upload via query to the back-end.
-        """
-        if self.strategy != RESUMABLE_UPLOAD:
-            return
-        self._ensure_initialized()
-        # NOTE: Per RFC 2616[1]/7231[2], a 'PUT' request is inappropriate
-        #       here:  it is intended to be used to replace the entire
-        #       resource, not to  query for a status.
-        #
-        #       If the back-end doesn't provide a way to query for this state
-        #       via a 'GET' request, somebody should be spanked.
-        #
-        #       The violation is documented[3].
-        #
-        # [1] http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.6
-        # [2] http://tools.ietf.org/html/rfc7231#section-4.3.4
-        # [3]
-        # https://cloud.google.com/storage/docs/json_api/v1/how-tos/upload#resume-upload
-        refresh_request = Request(
-            url=self.url, http_method='PUT',
-            headers={'Content-Range': 'bytes */*'})
-        refresh_response = make_api_request(
-            self.http, refresh_request, redirections=0,
-            retries=self.num_retries)
-        range_header = self._get_range_header(refresh_response)
-        if refresh_response.status_code in (http_client.OK,
-                                            http_client.CREATED):
-            self._complete = True
-            self._progress = self.total_size
-            self.stream.seek(self.progress)
-            # If we're finished, the refresh response will contain the metadata
-            # originally requested. Cache it so it can be returned in
-            # StreamInChunks.
-            self._final_response = refresh_response
-        elif refresh_response.status_code == RESUME_INCOMPLETE:
-            if range_header is None:
-                self._progress = 0
-            else:
-                self._progress = self._last_byte(range_header) + 1
-            self.stream.seek(self.progress)
-        else:
-            raise HttpError.from_response(refresh_response)
-
-    @staticmethod
-    def _get_range_header(response):
-        """Return a 'Range' header from a response.
-
-        :type response: :class:`google.cloud.streaming.http_wrapper.Response`
-        :param response: response to be queried
-
-        :rtype: string
-        :returns: The header used to determine the bytes range.
-        """
-        # NOTE: Per RFC 2616[1]/7233[2][3], 'Range' is a request header,
-        #       not a response header.  If the back-end is actually setting
-        #       'Range' on responses, somebody should be spanked:  it should
-        #       be sending 'Content-Range' (including the # '/<length>'
-        #       trailer).
-        #
-        #       The violation is documented[4].
-        #
-        # [1] http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html
-        # [2] http://tools.ietf.org/html/rfc7233#section-3.1
-        # [3] http://tools.ietf.org/html/rfc7233#section-4.2
-        # [4]
-        # https://cloud.google.com/storage/docs/json_api/v1/how-tos/upload#chunking
-        return response.info.get('Range', response.info.get('range'))
-
-    def initialize_upload(self, http_request, http):
-        """Initialize this upload from the given http_request.
-
-        :type http_request: :class:`~.streaming.http_wrapper.Request`
-        :param http_request: the request to be used
-
-        :type http: :class:`httplib2.Http` (or workalike)
-        :param http: Http instance for this request.
-
-        :raises: :exc:`ValueError` if the instance has not been configured
-                 with a strategy.
-        :rtype: :class:`~google.cloud.streaming.http_wrapper.Response`
-        :returns: The response if the upload is resumable and auto transfer
-                  is not used.
-        """
-        if self.strategy is None:
-            raise ValueError(
-                'No upload strategy set; did you call configure_request?')
-        if self.strategy != RESUMABLE_UPLOAD:
-            return
-        self._ensure_uninitialized()
-        http_response = make_api_request(http, http_request,
-                                         retries=self.num_retries)
-        if http_response.status_code != http_client.OK:
-            raise HttpError.from_response(http_response)
-
-        granularity = http_response.info.get('X-Goog-Upload-Chunk-Granularity')
-        if granularity is not None:
-            granularity = int(granularity)
-        self._server_chunk_granularity = granularity
-        url = http_response.info['location']
-        self._initialize(http, url)
-
-        # Unless the user has requested otherwise, we want to just
-        # go ahead and pump the bytes now.
-        if self.auto_transfer:
-            return self.stream_file(use_chunks=True)
-        else:
-            return http_response
-
-    @staticmethod
-    def _last_byte(range_header):
-        """Parse the last byte from a 'Range' header.
-
-        :type range_header: string
-        :param range_header: 'Range' header value per RFC 2616/7233
-
-        :rtype: int
-        :returns: The last byte from a range header.
-        """
-        _, _, end = range_header.partition('-')
-        return int(end)
-
-    def _validate_chunksize(self, chunksize=None):
-        """Validate chunksize against server-specified granularity.
-
-        Helper for :meth:`stream_file`.
-
-        :type chunksize: integer or None
-        :param chunksize: the chunk size to be tested.
-
-        :raises: :exc:`ValueError` if ``chunksize`` is not a multiple
-                 of the server-specified granulariy.
-        """
-        if self._server_chunk_granularity is None:
-            return
-        chunksize = chunksize or self.chunksize
-        if chunksize % self._server_chunk_granularity:
-            raise ValueError(
-                'Server requires chunksize to be a multiple of %d',
-                self._server_chunk_granularity)
-
-    def stream_file(self, use_chunks=True):
-        """Upload the stream.
-
-        :type use_chunks: boolean
-        :param use_chunks: If False, send the stream in a single request.
-                           Otherwise, send it in chunks.
-
-        :rtype: :class:`google.cloud.streaming.http_wrapper.Response`
-        :returns: The response for the final request made.
-        """
-        if self.strategy != RESUMABLE_UPLOAD:
-            raise ValueError(
-                'Cannot stream non-resumable upload')
-        # final_response is set if we resumed an already-completed upload.
-        response = self._final_response
-        send_func = self._send_chunk if use_chunks else self._send_media_body
-        if use_chunks:
-            self._validate_chunksize(self.chunksize)
-        self._ensure_initialized()
-        while not self.complete:
-            response = send_func(self.stream.tell())
-            if response.status_code in (http_client.OK, http_client.CREATED):
-                self._complete = True
-                break
-            self._progress = self._last_byte(response.info['range'])
-            if self.progress + 1 != self.stream.tell():
-                raise CommunicationError(
-                    'Failed to transfer all bytes in chunk, upload paused at '
-                    'byte %d' % self.progress)
-        if self.complete and hasattr(self.stream, 'seek'):
-            if not hasattr(self.stream, 'seekable') or self.stream.seekable():
-                current_pos = self.stream.tell()
-                self.stream.seek(0, os.SEEK_END)
-                end_pos = self.stream.tell()
-                self.stream.seek(current_pos)
-                if current_pos != end_pos:
-                    raise TransferInvalidError(
-                        'Upload complete with %s '
-                        'additional bytes left in stream' %
-                        (int(end_pos) - int(current_pos)))
-        return response
-
-    def _send_media_request(self, request, end):
-        """Peform API upload request.
-
-        Helper for _send_media_body & _send_chunk:
-
-        :type request: :class:`google.cloud.streaming.http_wrapper.Request`
-        :param request: the request to upload
-
-        :type end: integer
-        :param end: end byte of the to be uploaded
-
-        :rtype: :class:`google.cloud.streaming.http_wrapper.Response`
-        :returns: the response
-        :raises: :exc:`~.streaming.exceptions.HttpError` if the status
-                 code from the response indicates an error.
-        """
-        response = make_api_request(
-            self.bytes_http, request, retries=self.num_retries)
-        if response.status_code not in (http_client.OK, http_client.CREATED,
-                                        RESUME_INCOMPLETE):
-            # We want to reset our state to wherever the server left us
-            # before this failed request, and then raise.
-            self.refresh_upload_state()
-            raise HttpError.from_response(response)
-        if response.status_code == RESUME_INCOMPLETE:
-            last_byte = self._last_byte(
-                self._get_range_header(response))
-            if last_byte + 1 != end:
-                self.stream.seek(last_byte)
-        return response
-
-    def _send_media_body(self, start):
-        """Send the entire stream in a single request.
-
-        Helper for :meth:`stream_file`:
-
-        :type start: integer
-        :param start: start byte of the range.
-
-        :rtype: :class:`google.cloud.streaming.http_wrapper.Response`
-        :returns: The response from the media upload request.
-        """
-        self._ensure_initialized()
-        if self.total_size is None:
-            raise TransferInvalidError(
-                'Total size must be known for SendMediaBody')
-        body_stream = StreamSlice(self.stream, self.total_size - start)
-
-        request = Request(url=self.url, http_method='PUT', body=body_stream)
-        request.headers['Content-Type'] = self.mime_type
-        if start == self.total_size:
-            # End of an upload with 0 bytes left to send; just finalize.
-            range_string = 'bytes */%s' % self.total_size
-        else:
-            range_string = 'bytes %s-%s/%s' % (start, self.total_size - 1,
-                                               self.total_size)
-
-        request.headers['Content-Range'] = range_string
-
-        return self._send_media_request(request, self.total_size)
-
-    def _send_chunk(self, start):
-        """Send a chunk of the stream.
-
-        Helper for :meth:`stream_file`:
-
-        :type start: integer
-        :param start: start byte of the range.
-
-        :rtype: :class:`google.cloud.streaming.http_wrapper.Response`
-        :returns: The response from the chunked upload request.
-        """
-        self._ensure_initialized()
-        no_log_body = self.total_size is None
-        if self.total_size is None:
-            # For the streaming resumable case, we need to detect when
-            # we're at the end of the stream.
-            body_stream = BufferedStream(
-                self.stream, start, self.chunksize)
-            end = body_stream.stream_end_position
-            if body_stream.stream_exhausted:
-                self._total_size = end
-            # Here, change body_stream from a stream to a string object,
-            # which means reading a chunk into memory.  This works around
-            # https://code.google.com/p/httplib2/issues/detail?id=176 which can
-            # cause httplib2 to skip bytes on 401's for file objects.
-            body_stream = body_stream.read(self.chunksize)
-        else:
-            end = min(start + self.chunksize, self.total_size)
-            body_stream = StreamSlice(self.stream, end - start)
-        request = Request(url=self.url, http_method='PUT', body=body_stream)
-        request.headers['Content-Type'] = self.mime_type
-        if no_log_body:
-            # Disable logging of streaming body.
-            request.loggable_body = '<media body>'
-        if self.total_size is None:
-            # Streaming resumable upload case, unknown total size.
-            range_string = 'bytes %s-%s/*' % (start, end - 1)
-        elif end == start:
-            # End of an upload with 0 bytes left to send; just finalize.
-            range_string = 'bytes */%s' % self.total_size
-        else:
-            # Normal resumable upload case with known sizes.
-            range_string = 'bytes %s-%s/%s' % (start, end - 1, self.total_size)
-
-        request.headers['Content-Range'] = range_string
-
-        return self._send_media_request(request, end)
diff --git a/google/cloud/streaming/util.py b/google/cloud/streaming/util.py
deleted file mode 100644
index 40d2b1749f7f..000000000000
--- a/google/cloud/streaming/util.py
+++ /dev/null
@@ -1,74 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Assorted utilities shared between parts of apitools."""
-
-import random
-
-
-_MAX_RETRY_WAIT = 60
-
-
-def calculate_wait_for_retry(retry_attempt):
-    """Calculate the amount of time to wait before a retry attempt.
-
-    Wait time grows exponentially with the number of attempts. A
-    random amount of jitter is added to spread out retry attempts from
-    different clients.
-
-    :type retry_attempt: integer
-    :param retry_attempt: Retry attempt counter.
-
-    :rtype: integer
-    :returns: Number of seconds to wait before retrying request.
-    """
-    wait_time = 2 ** retry_attempt
-    max_jitter = wait_time / 4.0
-    wait_time += random.uniform(-max_jitter, max_jitter)
-    return max(1, min(wait_time, _MAX_RETRY_WAIT))
-
-
-def acceptable_mime_type(accept_patterns, mime_type):
-    """Check that ``mime_type`` matches one of ``accept_patterns``.
-
-    Note that this function assumes that all patterns in accept_patterns
-    will be simple types of the form "type/subtype", where one or both
-    of these can be "*". We do not support parameters (i.e. "; q=") in
-    patterns.
-
-    :type accept_patterns: list of string
-    :param accept_patterns: acceptable MIME types.
-
-    :type mime_type: string
-    :param mime_type: the MIME being checked
-
-    :rtype: boolean
-    :returns: True if the supplied MIME type matches at least one of the
-              patterns, else False.
-    """
-    if '/' not in mime_type:
-        raise ValueError(
-            'Invalid MIME type: "%s"' % mime_type)
-    unsupported_patterns = [p for p in accept_patterns if ';' in p]
-    if unsupported_patterns:
-        raise ValueError(
-            'MIME patterns with parameter unsupported: "%s"' % ', '.join(
-                unsupported_patterns))
-
-    def _match(pattern, mime_type):
-        """Return True iff mime_type is acceptable for pattern."""
-        return all(accept in ('*', provided) for accept, provided
-                   in zip(pattern.split('/'), mime_type.split('/')))
-
-    return any(_match(pattern, mime_type) for pattern in accept_patterns)
diff --git a/google/cloud/translate/__init__.py b/google/cloud/translate/__init__.py
deleted file mode 100644
index 1b1a15168d15..000000000000
--- a/google/cloud/translate/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Google Cloud Translate API wrapper."""
-
-from google.cloud.translate.client import Client
-from google.cloud.translate.connection import Connection
diff --git a/google/cloud/translate/client.py b/google/cloud/translate/client.py
deleted file mode 100644
index 10d93ac23d6f..000000000000
--- a/google/cloud/translate/client.py
+++ /dev/null
@@ -1,224 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client for interacting with the Google Cloud Translate API."""
-
-
-import httplib2
-import six
-
-from google.cloud._helpers import _to_bytes
-from google.cloud.translate.connection import Connection
-
-
-ENGLISH_ISO_639 = 'en'
-"""ISO 639-1 language code for English."""
-
-
-class Client(object):
-    """Client to bundle configuration needed for API requests.
-
-    :type api_key: str
-    :param api_key: The key used to send with requests as a query
-                    parameter.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: (Optional) HTTP object to make requests. If not
-                 passed, an :class:`httplib.Http` object is created.
-
-    :type target_language: str
-    :param target_language: (Optional) The target language used for
-                            translations and language names. (Defaults to
-                            :data:`ENGLISH_ISO_639`.)
-    """
-
-    def __init__(self, api_key, http=None, target_language=ENGLISH_ISO_639):
-        self.api_key = api_key
-        if http is None:
-            http = httplib2.Http()
-        self.connection = Connection(http=http)
-        self.target_language = target_language
-
-    def get_languages(self, target_language=None):
-        """Get list of supported languages for translation.
-
-        Response
-
-        See: https://cloud.google.com/translate/v2/\
-        discovering-supported-languages-with-rest
-
-        :type target_language: str
-        :param target_language: (Optional) The language used to localize
-                                returned language names. Defaults to the
-                                target language on the current client.
-
-        :rtype: list
-        :returns: List of dictionaries. Each dictionary contains a supported
-                  ISO 639-1 language code (using the dictionary key
-                  ``language``). If ``target_language`` is passed, each
-                  dictionary will also contain the name of each supported
-                  language (localized to the target language).
-        """
-        query_params = {'key': self.api_key}
-        if target_language is None:
-            target_language = self.target_language
-        if target_language is not None:
-            query_params['target'] = target_language
-        response = self.connection.api_request(
-            method='GET', path='/languages', query_params=query_params)
-        return response.get('data', {}).get('languages', ())
-
-    def detect_language(self, values):
-        """Detect the language of a string or list of strings.
-
-        See: https://cloud.google.com/translate/v2/\
-        detecting-language-with-rest
-
-        :type values: str or list
-        :param values: String or list of strings that will have
-                       language detected.
-
-        :rtype: str or list
-        :returns: A list of dictionaries for each queried value. Each
-                  dictionary typically contains three keys
-
-                  * ``confidence``: The confidence in language detection, a
-                    float between 0 and 1.
-                  * ``input``: The corresponding input value.
-                  * ``language``: The detected language (as an ISO 639-1
-                    language code).
-
-                  though the key ``confidence`` may not always be present.
-
-                  If only a single value is passed, then only a single
-                  dictionary will be returned.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the number of
-                 detections is not equal to the number of values.
-                 :class:`ValueError <exceptions.ValueError>` if a value
-                 produces a list of detections with 0 or multiple results
-                 in it.
-        """
-        single_value = False
-        if isinstance(values, six.string_types):
-            single_value = True
-            values = [values]
-
-        query_params = [('key', self.api_key)]
-        query_params.extend(('q', _to_bytes(value, 'utf-8'))
-                            for value in values)
-        response = self.connection.api_request(
-            method='GET', path='/detect', query_params=query_params)
-        detections = response.get('data', {}).get('detections', ())
-
-        if len(values) != len(detections):
-            raise ValueError('Expected same number of values and detections',
-                             values, detections)
-
-        for index, value in enumerate(values):
-            # Empirically, even clearly ambiguous text like "no" only returns
-            # a single detection, so we replace the list of detections with
-            # the single detection contained.
-            if len(detections[index]) == 1:
-                detections[index] = detections[index][0]
-            else:
-                message = ('Expected a single detection per value, API '
-                           'returned %d') % (len(detections[index]),)
-                raise ValueError(message, value, detections[index])
-
-            detections[index]['input'] = value
-            # The ``isReliable`` field is deprecated.
-            detections[index].pop('isReliable', None)
-
-        if single_value:
-            return detections[0]
-        else:
-            return detections
-
-    def translate(self, values, target_language=None, format_=None,
-                  source_language=None, customization_ids=()):
-        """Translate a string or list of strings.
-
-        See: https://cloud.google.com/translate/v2/\
-        translating-text-with-rest
-
-        :type values: str or list
-        :param values: String or list of strings to translate.
-
-        :type target_language: str
-        :param target_language: The language to translate results into. This
-                                is required by the API and defaults to
-                                the target language of the current instance.
-
-        :type format_: str
-        :param format_: (Optional) One of ``text`` or ``html``, to specify
-                        if the input text is plain text or HTML.
-
-        :type source_language: str
-        :param source_language: (Optional) The language of the text to
-                                be translated.
-
-        :type customization_ids: str or list
-        :param customization_ids: (Optional) ID or list of customization IDs
-                                  for translation. Sets the ``cid`` parameter
-                                  in the query.
-
-        :rtype: str or list list
-        :returns: A list of dictionaries for each queried value. Each
-                  dictionary typically contains three keys (though not
-                  all will be present in all cases)
-
-                  * ``detectedSourceLanguage``: The detected language (as an
-                    ISO 639-1 language code) of the text.
-                  * ``translatedText``: The translation of the text into the
-                    target language.
-                  * ``input``: The corresponding input value.
-
-                  If only a single value is passed, then only a single
-                  dictionary will be returned.
-        :raises: :class:`ValueError <exceptions.ValueError>` if the number of
-                 values and translations differ.
-        """
-        single_value = False
-        if isinstance(values, six.string_types):
-            single_value = True
-            values = [values]
-
-        if target_language is None:
-            target_language = self.target_language
-        if isinstance(customization_ids, six.string_types):
-            customization_ids = [customization_ids]
-
-        query_params = [('key', self.api_key), ('target', target_language)]
-        query_params.extend(('q', _to_bytes(value, 'utf-8'))
-                            for value in values)
-        query_params.extend(('cid', cid) for cid in customization_ids)
-        if format_ is not None:
-            query_params.append(('format', format_))
-        if source_language is not None:
-            query_params.append(('source', source_language))
-
-        response = self.connection.api_request(
-            method='GET', path='', query_params=query_params)
-
-        translations = response.get('data', {}).get('translations', ())
-        if len(values) != len(translations):
-            raise ValueError('Expected iterations to have same length',
-                             values, translations)
-        for value, translation in six.moves.zip(values, translations):
-            translation['input'] = value
-
-        if single_value:
-            return translations[0]
-        else:
-            return translations
diff --git a/google/cloud/translate/connection.py b/google/cloud/translate/connection.py
deleted file mode 100644
index 36f6f93b38a7..000000000000
--- a/google/cloud/translate/connection.py
+++ /dev/null
@@ -1,30 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Create / interact with Google Cloud Translate connections."""
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Translate via the JSON REST API."""
-
-    API_BASE_URL = 'https://www.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v2'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/language/translate/{api_version}{path}'
-    """A template for the URL of a particular API call."""
diff --git a/google/cloud/vision/__init__.py b/google/cloud/vision/__init__.py
deleted file mode 100644
index f25370f337b7..000000000000
--- a/google/cloud/vision/__init__.py
+++ /dev/null
@@ -1,16 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Google Cloud Vision API package."""
-from google.cloud.vision.client import Client
diff --git a/google/cloud/vision/client.py b/google/cloud/vision/client.py
deleted file mode 100644
index 2334bd24c447..000000000000
--- a/google/cloud/vision/client.py
+++ /dev/null
@@ -1,122 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Client for interacting with the Google Cloud Vision API."""
-
-
-from google.cloud.client import JSONClient
-from google.cloud.vision.connection import Connection
-from google.cloud.vision.feature import Feature
-from google.cloud.vision.image import Image
-
-
-class VisionRequest(object):
-    """Request container with image and features information to annotate.
-
-    :type features: list of :class:`~gcoud.vision.feature.Feature`.
-    :param features: The features that dictate which annotations to run.
-
-    :type image: bytes
-    :param image: Either Google Cloud Storage URI or raw byte stream of image.
-    """
-    def __init__(self, image, features):
-        self._features = []
-        self._image = image
-
-        if isinstance(features, list):
-            self._features.extend(features)
-        elif isinstance(features, Feature):
-            self._features.append(features)
-        else:
-            raise TypeError('Feature or list of Feature classes are required.')
-
-    def as_dict(self):
-        """Dictionary representation of Image."""
-        return {
-            'image': self.image.as_dict(),
-            'features': [feature.as_dict() for feature in self.features]
-        }
-
-    @property
-    def features(self):
-        """List of Feature objects."""
-        return self._features
-
-    @property
-    def image(self):
-        """Image object containing image content."""
-        return self._image
-
-
-class Client(JSONClient):
-    """Client to bundle configuration needed for API requests.
-
-    :type project: str
-    :param project: the project which the client acts on behalf of.
-                    If not passed, falls back to the default inferred
-                    from the environment.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
-                       :class:`NoneType`
-    :param credentials: The OAuth2 Credentials to use for the connection
-                        owned by this client. If not passed (and if no ``http``
-                        object is passed), falls back to the default inferred
-                        from the environment.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: An optional HTTP object to make requests. If not passed, an
-                 ``http`` object is created that is bound to the
-                 ``credentials`` for the current object.
-    """
-
-    _connection_class = Connection
-
-    def annotate(self, image, features):
-        """Annotate an image to discover it's attributes.
-
-        :type image: str
-        :param image: A string which can be a URL, a Google Cloud Storage path,
-                      or a byte stream of the image.
-
-        :type features:  list of :class:`~google.cloud.vision.feature.Feature`
-        :param features: The type of detection that the Vision API should
-                         use to determine image attributes. Pricing is
-                         based on the number of Feature Types.
-
-                         See: https://cloud.google.com/vision/docs/pricing
-        :rtype: dict
-        :returns: List of annotations.
-        """
-        request = VisionRequest(image, features)
-
-        data = {'requests': [request.as_dict()]}
-        response = self.connection.api_request(method='POST',
-                                               path='/images:annotate',
-                                               data=data)
-
-        return response['responses'][0]
-
-    def image(self, content=None, source_uri=None):
-        """Get instance of Image using current client.
-
-        :type content: bytes
-        :param content: Byte stream of an image.
-
-        :type source_uri: str
-        :param source_uri: Google Cloud Storage URI of image.
-
-        :rtype: :class:`~google.cloud.vision.image.Image`
-        :returns: Image instance with the current client attached.
-        """
-        return Image(client=self, content=content, source_uri=source_uri)
diff --git a/google/cloud/vision/color.py b/google/cloud/vision/color.py
deleted file mode 100644
index 20927f79c6be..000000000000
--- a/google/cloud/vision/color.py
+++ /dev/null
@@ -1,191 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Image properties class representation derived from Vision API response."""
-
-
-class ImagePropertiesAnnotation(object):
-    """Representation of image properties
-
-    :type colors: list
-    :param colors: List of
-                   :class:`~google.cloud.vision.color.ColorInformation`.
-    """
-    def __init__(self, colors):
-        self._colors = colors
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct ``ImagePropertiesAnnotation`` from a response.
-
-        :type response: dict
-        :param response: Dictionary response from Vision API with image
-                         properties data.
-
-        :rtype: :class:`~google.cloud.vision.color.ImagePropertiesAnnotation`.
-        :returns: Populated instance of ``ImagePropertiesAnnotation``.
-        """
-        colors = [ColorInformation.from_api_repr(color) for color in
-                  response['dominantColors']['colors']]
-        return cls(colors)
-
-    @property
-    def colors(self):
-        """Colors in an image.
-
-        :rtype: list of :class:`~google.cloud.vision.color.ColorInformation`
-        :returns: Populated list of ``ColorInformation``.
-        """
-        return self._colors
-
-
-class Color(object):
-    """Representation of RGBA color information.
-
-    :type red: int
-    :param red: The amount of red in the color as a value in the interval
-                [0, 255].
-
-    :type green: int
-    :param green: The amount of green in the color as a value in the interval
-                  [0, 255].
-
-    :type blue: int
-    :param blue: The amount of blue in the color as a value in the interval
-                 [0, 255].
-
-    :type alpha: float
-    :param alpha: The fraction of this color that should be applied to the
-                  pixel.
-    """
-    def __init__(self, red, green, blue, alpha):
-        self._red = red
-        self._green = green
-        self._blue = blue
-        self._alpha = alpha
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct a ``Color`` from a Vision API response.
-
-        :type response: dict
-        :param response: Color from API Response.
-
-        :rtype: :class:`~google.cloud.vision.color.Color`
-        :returns: Instance of :class:`~google.cloud.vision.color.Color`.
-        """
-        red = response['red']
-        green = response['green']
-        blue = response['blue']
-        alpha = response.get('alpha')
-
-        return cls(red, green, blue, alpha)
-
-    @property
-    def red(self):
-        """Red component of the color.
-
-        :rtype: int
-        :returns: Red RGB value.
-        """
-        return self._red
-
-    @property
-    def green(self):
-        """Green component of the color.
-
-        :rtype: int
-        :returns: Green RGB value.
-        """
-        return self._green
-
-    @property
-    def blue(self):
-        """Blue component of the color.
-
-        :rtype: int
-        :returns: Blue RGB value.
-        """
-        return self._blue
-
-    @property
-    def alpha(self):
-        """Alpha transparency level.
-
-        :rtype: float
-        :returns: Alpha transparency level.
-        """
-        return self._alpha
-
-
-class ColorInformation(object):
-    """Representation of color information from API response.
-
-    :type color: :class:`~google.cloud.vision.color.Color`
-    :param color: RGB components of the color.
-
-    :type score: float
-    :param score: Image-specific score for this color. Value in range [0, 1].
-
-    :type pixel_fraction: float
-    :param pixel_fraction: Stores the fraction of pixels the color occupies in
-                           the image. Value in range [0, 1].
-    """
-    def __init__(self, color, score, pixel_fraction):
-        self._color = color
-        self._score = score
-        self._pixel_fraction = pixel_fraction
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct ``ColorInformation`` for a color found.
-
-        :type response: dict
-        :param response: Color data with extra meta information.
-
-        :rtype: :class:`~google.cloud.vision.color.ColorInformation`
-        :returns: Instance of ``ColorInformation``.
-        """
-        color = Color.from_api_repr(response['color'])
-        score = response['score']
-        pixel_fraction = response['pixelFraction']
-
-        return cls(color, score, pixel_fraction)
-
-    @property
-    def color(self):
-        """RGB components of the color.
-
-        :rtype: :class:`~google.vision.color.Color`
-        :returns: Instance of ``Color``.
-        """
-        return self._color
-
-    @property
-    def score(self):
-        """Image-specific score for this color. Value in range [0, 1].
-
-        :rtype: float
-        :returns: Image score for this color.
-        """
-        return self._score
-
-    @property
-    def pixel_fraction(self):
-        """Stores the fraction of pixels the color occupies in the image.
-
-        :rtype: float
-        :returns: Pixel fraction value in range [0, 1].
-        """
-        return self._pixel_fraction
diff --git a/google/cloud/vision/connection.py b/google/cloud/vision/connection.py
deleted file mode 100644
index 560bc2c024d4..000000000000
--- a/google/cloud/vision/connection.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-
-"""Create / interact with Google Cloud Vision connections."""
-
-
-from google.cloud import connection as base_connection
-
-
-class Connection(base_connection.JSONConnection):
-    """A connection to Google Cloud Vision via the JSON REST API.
-
-    :type credentials: :class:`oauth2client.client.OAuth2Credentials`
-    :param credentials: (Optional) The OAuth2 Credentials to use for this
-                        connection.
-
-    :type http: :class:`httplib2.Http` or class that defines ``request()``.
-    :param http: (Optional) HTTP object to make requests.
-
-    :type api_base_url: string
-    :param api_base_url: The base of the API call URL. Defaults to the value
-                         :attr:`Connection.API_BASE_URL`.
-    """
-
-    API_BASE_URL = 'https://vision.googleapis.com'
-    """The base of the API call URL."""
-
-    API_VERSION = 'v1'
-    """The version of the API, used in building the API call's URL."""
-
-    API_URL_TEMPLATE = '{api_base_url}/{api_version}{path}'
-    """A template for the URL of a particular API call."""
-
-    SCOPE = ('https://www.googleapis.com/auth/cloud-platform',)
-    """The scopes required for authenticating as a Cloud Vision consumer."""
diff --git a/google/cloud/vision/entity.py b/google/cloud/vision/entity.py
deleted file mode 100644
index 6d9ec139e0f8..000000000000
--- a/google/cloud/vision/entity.py
+++ /dev/null
@@ -1,126 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Entity class for holding information returned from annotating an image."""
-
-
-from google.cloud.vision.geometry import Bounds
-from google.cloud.vision.geometry import LocationInformation
-
-
-class EntityAnnotation(object):
-    """Representation of an entity returned from the Vision API.
-
-    :type bounds: dict
-    :param bounds: Dictionary of bounary information of detected entity.
-
-    :type description: str
-    :param description: Description of entity detected in an image.
-
-    :type locale: str
-    :param locale: The language code for the locale in which the entity textual
-                   description (next field) is expressed.
-
-    :type locations: list of
-                     :class:`~google.cloud.vision.geometry.LocationInformation`.
-    :param locations: List of ``LocationInformation`` instances.
-
-    :type mid: str
-    :param mid: Opaque entity ID.
-
-    :type score: float
-    :param score: Overall score of the result. Range [0, 1].
-    """
-    def __init__(self, bounds, description, locale, locations, mid, score):
-        self._bounds = bounds
-        self._description = description
-        self._locale = locale
-        self._locations = locations
-        self._mid = mid
-        self._score = score
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct entity from Vision API response.
-
-        :type response: dict
-        :param response: Dictionary response from Vision API with entity data.
-
-        :rtype: :class:`~google.cloud.vision.entity.EntityAnnotation`
-        :returns: Instance of ``EntityAnnotation``.
-        """
-        bounds = Bounds.from_api_repr(response.get('boundingPoly'))
-        description = response['description']
-        locale = response.get('locale', None)
-        locations = [LocationInformation.from_api_repr(location)
-                     for location in response.get('locations', [])]
-        mid = response.get('mid', None)
-        score = response.get('score', None)
-
-        return cls(bounds, description, locale, locations, mid, score)
-
-    @property
-    def bounds(self):
-        """Bounding polygon of detected image feature.
-
-        :rtype: :class:`~google.cloud.vision.geometry.Bounds`
-        :returns: Instance of ``Bounds`` with populated vertices.
-        """
-        return self._bounds
-
-    @property
-    def description(self):
-        """Description of feature detected in image.
-
-        :rtype: str
-        :returns: String description of feature detected in image.
-        """
-        return self._description
-
-    @property
-    def locale(self):
-        """The language code for text discovered in an image.
-
-        :rtype: str
-        :returns: String language code of text found in the image.
-        """
-        return self._locale
-
-    @property
-    def locations(self):
-        """Location coordinates landmarks detected.
-
-        :rtype: :class:`~google.cloud.vision.geometry.LocationInformation`
-        :returns: ``LocationInformation`` populated with latitude and longitude
-                  of object detected in an image.
-        """
-        return self._locations
-
-    @property
-    def mid(self):
-        """MID of feature detected in image.
-
-        :rtype: str
-        :returns: String MID of feature detected in image.
-        """
-        return self._mid
-
-    @property
-    def score(self):
-        """Overall score of the result. Range [0, 1].
-
-        :rtype: float
-        :returns: Overall score of the result. Range [0, 1].
-        """
-        return self._score
diff --git a/google/cloud/vision/face.py b/google/cloud/vision/face.py
deleted file mode 100644
index a071af0a04d4..000000000000
--- a/google/cloud/vision/face.py
+++ /dev/null
@@ -1,403 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Face class representing the Vision API's face detection response."""
-
-
-from google.cloud.vision.geometry import BoundsBase
-from google.cloud.vision.likelihood import Likelihood
-from google.cloud.vision.geometry import Position
-
-
-class Angles(object):
-    """Angles representing the positions of a face."""
-    def __init__(self, roll, pan, tilt):
-        self._roll = roll
-        self._pan = pan
-        self._tilt = tilt
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct the angles from an Vision API response.
-
-        :rtype: :class:`~google.cloud.vision.face.Angles`
-        :returns: An `Angles` instance with data parsed from `response`.
-        """
-        roll = response['rollAngle']
-        pan = response['panAngle']
-        tilt = response['tiltAngle']
-
-        return cls(roll, pan, tilt)
-
-    @property
-    def roll(self):
-        """Roll angle of face.
-
-        :rtype: float
-        :returns: Roll angle of face in degrees.
-        """
-        return self._roll
-
-    @property
-    def pan(self):
-        """Pan angle of face.
-
-        :rtype: float
-        :returns: Pan angle of face in degrees.
-        """
-        return self._pan
-
-    @property
-    def tilt(self):
-        """Tilt angle of face.
-
-        :rtype: float
-        :returns: Tilt angle of face in degrees.
-        """
-        return self._tilt
-
-
-class Bounds(BoundsBase):
-    """The bounding polygon of the entire face."""
-
-
-class Emotions(object):
-    """Emotions displayed by the face detected in an image."""
-    def __init__(self, joy_likelihood, sorrow_likelihood,
-                 surprise_likelihood, anger_likelihood):
-        self._joy_likelihood = joy_likelihood
-        self._sorrow_likelihood = sorrow_likelihood
-        self._surprise_likelihood = surprise_likelihood
-        self._anger_likelihood = anger_likelihood
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct `Emotions` from Vision API response.
-
-        :type response: dict
-        :param response: Response dictionary representing a face.
-
-        :rtype: :class:`~google.cloud.vision.face.Emotions`
-        :returns: Populated instance of `Emotions`.
-        """
-        joy_likelihood = getattr(Likelihood, response['joyLikelihood'])
-        sorrow_likelihood = getattr(Likelihood, response['sorrowLikelihood'])
-        surprise_likelihood = getattr(Likelihood,
-                                      response['surpriseLikelihood'])
-        anger_likelihood = getattr(Likelihood, response['angerLikelihood'])
-
-        return cls(joy_likelihood, sorrow_likelihood, surprise_likelihood,
-                   anger_likelihood)
-
-    @property
-    def joy_likelihood(self):
-        """Likelihood of joy in detected face.
-
-        :rtype: str
-        :returns: String derived from
-                  :class:`~google.cloud.vision.face.Likelihood`.
-        """
-        return self._joy_likelihood
-
-    @property
-    def sorrow_likelihood(self):
-        """Likelihood of sorrow in detected face.
-
-        :rtype: str
-        :returns: String derived from
-                  :class:`~google.cloud.vision.face.Likelihood`.
-        """
-        return self._sorrow_likelihood
-
-    @property
-    def surprise_likelihood(self):
-        """Likelihood of surprise in detected face.
-
-        :rtype: str
-        :returns: String derived from
-                  :class:`~google.cloud.vision.face.Likelihood`.
-        """
-        return self._surprise_likelihood
-
-    @property
-    def anger_likelihood(self):
-        """Likelihood of anger in detected face.
-
-        :rtype: str
-        :returns: String derived from
-                  :class:`~google.cloud.vision.face.Likelihood`.
-        """
-        return self._anger_likelihood
-
-
-class Face(object):
-    """Representation of a face found by the Vision API"""
-
-    def __init__(self, angles, bounds, detection_confidence, emotions,
-                 fd_bounds, headwear_likelihood, image_properties, landmarks,
-                 landmarking_confidence):
-        self._angles = angles
-        self._bounds = bounds
-        self._detection_confidence = detection_confidence
-        self._emotions = emotions
-        self._fd_bounds = fd_bounds
-        self._headwear_likelihood = headwear_likelihood
-        self._landmarks = landmarks
-        self._landmarking_confidence = landmarking_confidence
-        self._image_properties = image_properties
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct an instance of a Face from an API response
-
-        :type response: dict
-        :param response: Face annotation dict returned from the Vision API.
-
-        :rtype: :class:`~google.cloud.vision.face.Face`
-        :returns: A instance of `Face` with data parsed from `response`.
-        """
-        angles = Angles.from_api_repr(response)
-        bounds = Bounds.from_api_repr(response['boundingPoly'])
-        detection_confidence = response['detectionConfidence']
-        emotions = Emotions.from_api_repr(response)
-        fd_bounds = FDBounds.from_api_repr(response['fdBoundingPoly'])
-        headwear_likelihood = getattr(Likelihood,
-                                      response['headwearLikelihood'])
-        image_properties = FaceImageProperties.from_api_repr(response)
-        landmarks = Landmarks(response['landmarks'])
-        landmarking_confidence = response['landmarkingConfidence']
-
-        return cls(angles, bounds, detection_confidence, emotions, fd_bounds,
-                   headwear_likelihood, image_properties, landmarks,
-                   landmarking_confidence)
-
-    @property
-    def angles(self):
-        """Accessor to the pan, tilt and roll angles of a Face.
-
-        :rtype: :class:`~google.cloud.vision.face.Angles`
-        :returns: Pan, tilt and roll angles of the detected face.
-        """
-
-        return self._angles
-
-    @property
-    def bounds(self):
-        """Accessor to the bounding poly information of the detected face.
-
-        :rtype: :class:`~google.cloud.vision.face.Bounds`
-        :returns: An instance of ``Bounds`` which has a list of vertices.
-        """
-        return self._bounds
-
-    @property
-    def detection_confidence(self):
-        """Face detection confidence score determined by the Vision API.
-
-        :rtype: float
-        :returns: Float representation of confidence ranging from 0 to 1.
-        """
-        return self._detection_confidence
-
-    @property
-    def emotions(self):
-        """Accessor to the possible emotions expressed in the detected face.
-
-        :rtype: :class:`~google.cloud.vision.face.Emotions`
-        :returns: An instance of ``Emotions`` with joy, sorrow, anger, surprise
-                  likelihood.
-        """
-        return self._emotions
-
-    @property
-    def fd_bounds(self):
-        """Accessor to the skin area bounding poly of the detected face.
-
-        :rtype: :class:`~google.cloud.vision.image.FDBounds`
-        :returns: An instance of ``FDBounds`` which has a list of vertices.
-        """
-        return self._fd_bounds
-
-    @property
-    def headwear_likelihood(self):
-        """Headwear likelihood.
-
-        :rtype: :class:`~google.cloud.vision.face.Likelihood`
-        :returns: String representing the likelihood based on
-                  :class:`~google.cloud.vision.face.Likelihood`
-        """
-        return self._headwear_likelihood
-
-    @property
-    def image_properties(self):
-        """Image properties from imaged used in face detection.
-
-        :rtype: :class:`~google.cloud.vision.face.FaceImageProperties`
-        :returns: ``FaceImageProperties`` object with image properties.
-        """
-        return self._image_properties
-
-    @property
-    def landmarks(self):
-        """Accessor to the facial landmarks detected in a face.
-
-        :rtype: :class:`~google.cloud.vision.face.Landmarks`
-        :returns: ``Landmarks`` object with facial landmarks as properies.
-        """
-        return self._landmarks
-
-    @property
-    def landmarking_confidence(self):
-        """Landmarking confidence score determinged by the Vision API.
-
-        :rtype: float
-        :returns: Float representing the confidence of the Vision API in
-                  determining the landmarks on a face.
-        """
-        return self._landmarking_confidence
-
-
-class FaceImageProperties(object):
-    """A representation of the image properties from face detection."""
-    def __init__(self, blurred_likelihood, underexposed_likelihood):
-        self._blurred_likelihood = blurred_likelihood
-        self._underexposed_likelihood = underexposed_likelihood
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct image properties from image.
-
-        :rtype: :class:`~google.cloud.vision.face.FaceImageProperties`
-        :returns: Instance populated with image property data.
-        """
-        blurred_likelihood = getattr(Likelihood,
-                                     response['blurredLikelihood'])
-        underexposed_likelihood = getattr(Likelihood,
-                                          response['underExposedLikelihood'])
-
-        return cls(blurred_likelihood, underexposed_likelihood)
-
-    @property
-    def blurred_likelihood(self):
-        """Likelihood of the image being blurred.
-
-        :rtype: str
-        :returns: String representation derived from
-                  :class:`~google.cloud.vision.face.Position`.
-        """
-        return self._blurred_likelihood
-
-    @property
-    def underexposed_likelihood(self):
-        """Likelihood that the image used for detection was underexposed.
-
-        :rtype: str
-        :returns: String representation derived from
-                  :class:`~google.cloud.vision.face.Position`.
-        """
-        return self._underexposed_likelihood
-
-
-class FaceLandmarkTypes(object):
-    """A representation of the face detection landmark types.
-
-    See:
-    https://cloud.google.com/vision/reference/rest/v1/images/annotate#Type_1
-    """
-    UNKNOWN_LANDMARK = 'UNKNOWN_LANDMARK'
-    LEFT_EYE = 'LEFT_EYE'
-    RIGHT_EYE = 'RIGHT_EYE'
-    LEFT_OF_LEFT_EYEBROW = 'LEFT_OF_LEFT_EYEBROW'
-    RIGHT_OF_LEFT_EYEBROW = 'RIGHT_OF_LEFT_EYEBROW'
-    LEFT_OF_RIGHT_EYEBROW = 'LEFT_OF_RIGHT_EYEBROW'
-    RIGHT_OF_RIGHT_EYEBROW = 'RIGHT_OF_RIGHT_EYEBROW'
-    MIDPOINT_BETWEEN_EYES = 'MIDPOINT_BETWEEN_EYES'
-    NOSE_TIP = 'NOSE_TIP'
-    UPPER_LIP = 'UPPER_LIP'
-    LOWER_LIP = 'LOWER_LIP'
-    MOUTH_LEFT = 'MOUTH_LEFT'
-    MOUTH_RIGHT = 'MOUTH_RIGHT'
-    MOUTH_CENTER = 'MOUTH_CENTER'
-    NOSE_BOTTOM_RIGHT = 'NOSE_BOTTOM_RIGHT'
-    NOSE_BOTTOM_LEFT = 'NOSE_BOTTOM_LEFT'
-    NOSE_BOTTOM_CENTER = 'NOSE_BOTTOM_CENTER'
-    LEFT_EYE_TOP_BOUNDARY = 'LEFT_EYE_TOP_BOUNDARY'
-    LEFT_EYE_RIGHT_CORNER = 'LEFT_EYE_RIGHT_CORNER'
-    LEFT_EYE_BOTTOM_BOUNDARY = 'LEFT_EYE_BOTTOM_BOUNDARY'
-    LEFT_EYE_LEFT_CORNER = 'LEFT_EYE_LEFT_CORNER'
-    RIGHT_EYE_TOP_BOUNDARY = 'RIGHT_EYE_TOP_BOUNDARY'
-    RIGHT_EYE_RIGHT_CORNER = 'RIGHT_EYE_RIGHT_CORNER'
-    RIGHT_EYE_BOTTOM_BOUNDARY = 'RIGHT_EYE_BOTTOM_BOUNDARY'
-    RIGHT_EYE_LEFT_CORNER = 'RIGHT_EYE_LEFT_CORNER'
-    LEFT_EYEBROW_UPPER_MIDPOINT = 'LEFT_EYEBROW_UPPER_MIDPOINT'
-    RIGHT_EYEBROW_UPPER_MIDPOINT = 'RIGHT_EYEBROW_UPPER_MIDPOINT'
-    LEFT_EAR_TRAGION = 'LEFT_EAR_TRAGION'
-    RIGHT_EAR_TRAGION = 'RIGHT_EAR_TRAGION'
-    LEFT_EYE_PUPIL = 'LEFT_EYE_PUPIL'
-    RIGHT_EYE_PUPIL = 'RIGHT_EYE_PUPIL'
-    FOREHEAD_GLABELLA = 'FOREHEAD_GLABELLA'
-    CHIN_GNATHION = 'CHIN_GNATHION'
-    CHIN_LEFT_GONION = 'CHIN_LEFT_GONION'
-    CHIN_RIGHT_GONION = 'CHIN_RIGHT_GONION'
-
-
-class FDBounds(BoundsBase):
-    """The bounding polygon of just the skin portion of the face."""
-
-
-class Landmark(object):
-    """A face-specific landmark (for example, a face feature, left eye)."""
-    def __init__(self, position, landmark_type):
-        self._position = position
-        self._landmark_type = landmark_type
-
-    @classmethod
-    def from_api_repr(cls, response_landmark):
-        """Factory: construct an instance of a Landmark from a response.
-
-        :type response_landmark: dict
-        :param response_landmark: Landmark representation from Vision API.
-
-        :rtype: :class:`~google.cloud.vision.face.Landmark`
-        :returns: Populated instance of `Landmark`.
-        """
-        position = Position.from_api_repr(response_landmark['position'])
-        landmark_type = getattr(FaceLandmarkTypes, response_landmark['type'])
-        return cls(position, landmark_type)
-
-    @property
-    def position(self):
-        """Landmark position on face.
-
-        :rtype: :class:`~google.cloud.vision.face.Position`
-        :returns: Instance of `Position` with landmark coordinates.
-        """
-        return self._position
-
-    @property
-    def landmark_type(self):
-        """Landmark type of facial feature.
-
-        :rtype: str
-        :returns: String representation of facial landmark type.
-        """
-        return self._landmark_type
-
-
-class Landmarks(object):
-    """Landmarks detected on a face represented as properties."""
-    def __init__(self, landmarks):
-        for landmark_response in landmarks:
-            landmark = Landmark.from_api_repr(landmark_response)
-            setattr(self, landmark.landmark_type.lower(), landmark)
diff --git a/google/cloud/vision/feature.py b/google/cloud/vision/feature.py
deleted file mode 100644
index a60abea17caa..000000000000
--- a/google/cloud/vision/feature.py
+++ /dev/null
@@ -1,83 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Feature represenging various types of annotating."""
-
-
-class FeatureTypes(object):
-    """Feature Types to indication which annotations to perform.
-
-    See:
-    https://cloud.google.com/vision/reference/rest/v1/images/annotate#Type
-    """
-    FACE_DETECTION = 'FACE_DETECTION'
-    LANDMARK_DETECTION = 'LANDMARK_DETECTION'
-    LOGO_DETECTION = 'LOGO_DETECTION'
-    LABEL_DETECTION = 'LABEL_DETECTION'
-    TEXT_DETECTION = 'TEXT_DETECTION'
-    SAFE_SEARCH_DETECTION = 'SAFE_SEARCH_DETECTION'
-    IMAGE_PROPERTIES = 'IMAGE_PROPERTIES'
-
-
-class Feature(object):
-    """Feature object specifying the annotation type and maximum results.
-
-    :type feature_type: str
-    :param feature_type: String representation of
-                         :class:`~google.cloud.vision.feature.FeatureType`.
-
-    :type max_results: int
-    :param max_results: Number of results to return for the specified
-                        feature type.
-
-    See:
-    https://cloud.google.com/vision/reference/rest/v1/images/annotate#Feature
-    """
-    def __init__(self, feature_type, max_results=1):
-        try:
-            self._feature_type = getattr(FeatureTypes, feature_type)
-        except AttributeError:
-            raise AttributeError('Feature type passed in cannot be found.')
-        self._max_results = int(max_results)
-
-    def as_dict(self):
-        """Generate dictionary for Feature request format.
-
-        :rtype: dict
-        :returns: Dictionary representation of a
-                  :class:`~google.cloud.vision.feature.FeatureType`.
-        """
-        return {
-            'type': self.feature_type,
-            'maxResults': self.max_results
-        }
-
-    @property
-    def feature_type(self):
-        """"Feature type string.
-
-        :rtype: :class:`~google.cloud.vision.feature.FeatureTypes`
-        :returns: Instance of
-                  :class:`~google.cloud.vision.feature.FeatureTypes`
-        """
-        return self._feature_type
-
-    @property
-    def max_results(self):
-        """Maximum number of results for feature type.
-
-        :rtype: int
-        :returns: Maxium results to be returned.
-        """
-        return self._max_results
diff --git a/google/cloud/vision/geometry.py b/google/cloud/vision/geometry.py
deleted file mode 100644
index 4e6af390213d..000000000000
--- a/google/cloud/vision/geometry.py
+++ /dev/null
@@ -1,201 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Geometry and other generic classes used by the Vision API."""
-
-
-class BoundsBase(object):
-    """Base class for handling bounds with vertices.
-
-    :type vertices: list of :class:`~google.cloud.vision.geometry.Vertex`
-    :param vertices: List of vertcies describing points on an image.
-    """
-    def __init__(self, vertices):
-        self._vertices = vertices
-
-    @classmethod
-    def from_api_repr(cls, response_vertices):
-        """Factory: construct BoundsBase instance from Vision API response.
-
-        :type response_vertices: dict
-        :param response_vertices: List of vertices.
-
-        :rtype: :class:`~google.cloud.vision.geometry.BoundsBase` or None
-        :returns: Instance of BoundsBase with populated verticies or None.
-        """
-        if not response_vertices:
-            return None
-
-        vertices = [Vertex(vertex.get('x', None), vertex.get('y', None)) for
-                    vertex in response_vertices.get('vertices', [])]
-        return cls(vertices)
-
-    @property
-    def vertices(self):
-        """List of vertices.
-
-        :rtype: list of :class:`~google.cloud.vision.geometry.Vertex`
-        :returns: List of populated vertices.
-        """
-        return self._vertices
-
-
-class Bounds(BoundsBase):
-    """A polygon boundry of the detected feature."""
-
-
-class FDBounds(BoundsBase):
-    """The bounding polygon of just the skin portion of the face."""
-
-
-class LocationInformation(object):
-    """Representation of location information returned by the Vision API.
-
-    :type latitude: float
-    :param latitude: Latitude coordinate of geographical location.
-
-    :type longitude: float
-    :param longitude: Longitude coordinate of geographical location.
-    """
-    def __init__(self, latitude, longitude):
-        self._latitude = latitude
-        self._longitude = longitude
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct location information from Vision API response.
-
-        :type response: dict
-        :param response: Dictionary response of locations.
-
-        :rtype: :class:`~google.cloud.vision.geometry.LocationInformation`
-        :returns: ``LocationInformation`` with populated latitude and
-                  longitude.
-        """
-        latitude = response['latLng']['latitude']
-        longitude = response['latLng']['longitude']
-        return cls(latitude, longitude)
-
-    @property
-    def latitude(self):
-        """Latitude coordinate.
-
-        :rtype: float
-        :returns: Latitude coordinate of location.
-        """
-        return self._latitude
-
-    @property
-    def longitude(self):
-        """Longitude coordinate.
-
-        :rtype: float
-        :returns: Longitude coordinate of location.
-        """
-        return self._longitude
-
-
-class Position(object):
-    """A 3D position in the image.
-
-    See:
-    https://cloud.google.com/vision/reference/rest/v1/images/annotate#Position
-
-    :type x_coordinate: float
-    :param x_coordinate: X position coordinate.
-
-    :type y_coordinate: float
-    :param y_coordinate: Y position coordinate.
-
-    :type z_coordinate: float
-    :param z_coordinate: Z position coordinate.
-    """
-    def __init__(self, x_coordinate, y_coordinate, z_coordinate):
-        self._x_coordinate = x_coordinate
-        self._y_coordinate = y_coordinate
-        self._z_coordinate = z_coordinate
-
-    @classmethod
-    def from_api_repr(cls, response_position):
-        """Factory: construct 3D position from API response.
-
-        :rtype: :class:`~google.cloud.vision.geometry.Position`
-        :returns: `Position` constructed with 3D points from API response.
-        """
-        x_coordinate = response_position['x']
-        y_coordinate = response_position['y']
-        z_coordinate = response_position['z']
-        return cls(x_coordinate, y_coordinate, z_coordinate)
-
-    @property
-    def x_coordinate(self):
-        """X position coordinate.
-
-        :rtype: float
-        :returns: X position coordinate.
-        """
-        return self._x_coordinate
-
-    @property
-    def y_coordinate(self):
-        """Y position coordinate.
-
-        :rtype: float
-        :returns: Y position coordinate.
-        """
-        return self._y_coordinate
-
-    @property
-    def z_coordinate(self):
-        """Z position coordinate.
-
-        :rtype: float
-        :returns: Z position coordinate.
-        """
-        return self._z_coordinate
-
-
-class Vertex(object):
-    """A vertex represents a 2D point in the image.
-
-    See:
-    https://cloud.google.com/vision/reference/rest/v1/images/annotate#Vertex
-
-    :type x_coordinate: float
-    :param x_coordinate: X position coordinate.
-
-    :type y_coordinate: float
-    :param y_coordinate: Y position coordinate.
-    """
-    def __init__(self, x_coordinate, y_coordinate):
-        self._x_coordinate = x_coordinate
-        self._y_coordinate = y_coordinate
-
-    @property
-    def x_coordinate(self):
-        """X position coordinate.
-
-        :rtype: float
-        :returns: X position coordinate.
-        """
-        return self._x_coordinate
-
-    @property
-    def y_coordinate(self):
-        """Y position coordinate.
-
-        :rtype: float
-        :returns: Y position coordinate.
-        """
-        return self._y_coordinate
diff --git a/google/cloud/vision/image.py b/google/cloud/vision/image.py
deleted file mode 100644
index c8c5a5f4ac66..000000000000
--- a/google/cloud/vision/image.py
+++ /dev/null
@@ -1,209 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Image represented by either a URI or byte stream."""
-
-
-from base64 import b64encode
-
-from google.cloud._helpers import _to_bytes
-from google.cloud.vision.entity import EntityAnnotation
-from google.cloud.vision.face import Face
-from google.cloud.vision.feature import Feature
-from google.cloud.vision.feature import FeatureTypes
-from google.cloud.vision.color import ImagePropertiesAnnotation
-from google.cloud.vision.safe import SafeSearchAnnotation
-
-
-class Image(object):
-    """Image representation containing information to be annotate.
-
-    :type content: bytes
-    :param content: Byte stream of an image.
-
-    :type source_uri: str
-    :param source_uri: Google Cloud Storage URI of image.
-
-    :type client: :class:`~google.cloud.vision.client.Client`
-    :param client: Instance of Vision client.
-    """
-
-    def __init__(self, client, content=None, source_uri=None):
-        self.client = client
-        self._content = None
-        self._source = None
-
-        if source_uri:
-            self._source = source_uri
-        else:
-            self._content = b64encode(_to_bytes(content))
-
-    def as_dict(self):
-        """Generate dictionary structure for request.
-
-        :rtype: dict
-        :returns: Dictionary with source information for image.
-        """
-        if self.content:
-            return {
-                'content': self.content
-            }
-        else:
-            return {
-                'source': {
-                    'gcs_image_uri': self.source
-                }
-            }
-
-    @property
-    def content(self):
-        """Base64 encoded image content.
-
-        :rtype: str
-        :returns: Base64 encoded image bytes.
-        """
-        return self._content
-
-    @property
-    def source(self):
-        """Google Cloud Storage URI.
-
-        :rtype: str
-        :returns: String of Google Cloud Storage URI.
-        """
-        return self._source
-
-    def _detect_annotation(self, feature):
-        """Generic method for detecting a single annotation.
-
-        :type feature: :class:`~google.cloud.vision.feature.Feature`
-        :param feature: The ``Feature`` indication the type of annotation to
-                        perform.
-
-        :rtype: list
-        :returns: List of
-                  :class:`~google.cloud.vision.entity.EntityAnnotation`.
-        """
-        reverse_types = {
-            'LABEL_DETECTION': 'labelAnnotations',
-            'LANDMARK_DETECTION': 'landmarkAnnotations',
-            'LOGO_DETECTION': 'logoAnnotations',
-            'TEXT_DETECTION': 'textAnnotations',
-        }
-        detected_objects = []
-        result = self.client.annotate(self, [feature])
-        for response in result[reverse_types[feature.feature_type]]:
-            detected_object = EntityAnnotation.from_api_repr(response)
-            detected_objects.append(detected_object)
-        return detected_objects
-
-    def detect_faces(self, limit=10):
-        """Detect faces in image.
-
-        :type limit: int
-        :param limit: The number of faces to try and detect.
-
-        :rtype: list
-        :returns: List of :class:`~google.cloud.vision.face.Face`.
-        """
-        faces = []
-        face_detection_feature = Feature(FeatureTypes.FACE_DETECTION, limit)
-        result = self.client.annotate(self, [face_detection_feature])
-        for face_response in result['faceAnnotations']:
-            face = Face.from_api_repr(face_response)
-            faces.append(face)
-
-        return faces
-
-    def detect_labels(self, limit=10):
-        """Detect labels that describe objects in an image.
-
-        :type limit: int
-        :param limit: The maximum number of labels to try and detect.
-
-        :rtype: list
-        :returns: List of :class:`~google.cloud.vision.entity.EntityAnnotation`
-        """
-        feature = Feature(FeatureTypes.LABEL_DETECTION, limit)
-        return self._detect_annotation(feature)
-
-    def detect_landmarks(self, limit=10):
-        """Detect landmarks in an image.
-
-        :type limit: int
-        :param limit: The maximum number of landmarks to find.
-
-        :rtype: list
-        :returns: List of
-                  :class:`~google.cloud.vision.entity.EntityAnnotation`.
-        """
-        feature = Feature(FeatureTypes.LANDMARK_DETECTION, limit)
-        return self._detect_annotation(feature)
-
-    def detect_logos(self, limit=10):
-        """Detect logos in an image.
-
-        :type limit: int
-        :param limit: The maximum number of logos to find.
-
-        :rtype: list
-        :returns: List of
-                  :class:`~google.cloud.vision.entity.EntityAnnotation`.
-        """
-        feature = Feature(FeatureTypes.LOGO_DETECTION, limit)
-        return self._detect_annotation(feature)
-
-    def detect_properties(self, limit=10):
-        """Detect the color properties of an image.
-
-        :type limit: int
-        :param limit: The maximum number of image properties to find.
-
-        :rtype: list
-        :returns: List of
-                  :class:`~google.cloud.vision.color.ImagePropertiesAnnotation`.
-        """
-        feature = Feature(FeatureTypes.IMAGE_PROPERTIES, limit)
-        result = self.client.annotate(self, [feature])
-        response = result['imagePropertiesAnnotation']
-        return ImagePropertiesAnnotation.from_api_repr(response)
-
-    def detect_safe_search(self, limit=10):
-        """Retreive safe search properties from an image.
-
-        :type limit: int
-        :param limit: The number of faces to try and detect.
-
-        :rtype: list
-        :returns: List of
-                  :class:`~google.cloud.vision.sage.SafeSearchAnnotation`.
-        """
-        safe_detection_feature = Feature(FeatureTypes.SAFE_SEARCH_DETECTION,
-                                         limit)
-        result = self.client.annotate(self, [safe_detection_feature])
-        safe_search_response = result['safeSearchAnnotation']
-        return SafeSearchAnnotation.from_api_repr(safe_search_response)
-
-    def detect_text(self, limit=10):
-        """Detect text in an image.
-
-        :type limit: int
-        :param limit: The maximum instances of text to find.
-
-        :rtype: list
-        :returns: List of
-                  :class:`~google.cloud.vision.entity.EntityAnnotation`.
-        """
-        feature = Feature(FeatureTypes.TEXT_DETECTION, limit)
-        return self._detect_annotation(feature)
diff --git a/google/cloud/vision/likelihood.py b/google/cloud/vision/likelihood.py
deleted file mode 100644
index 63c63b955d58..000000000000
--- a/google/cloud/vision/likelihood.py
+++ /dev/null
@@ -1,29 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Likelihood constants returned from Vision API."""
-
-
-class Likelihood(object):
-    """A representation of likelihood to give stable results across upgrades.
-
-    See:
-    https://cloud.google.com/vision/reference/rest/v1/images/annotate#likelihood
-    """
-    UNKNOWN = 'UNKNOWN'
-    VERY_UNLIKELY = 'VERY_UNLIKELY'
-    UNLIKELY = 'UNLIKELY'
-    POSSIBLE = 'POSSIBLE'
-    LIKELY = 'LIKELY'
-    VERY_LIKELY = 'VERY_LIKELY'
diff --git a/google/cloud/vision/safe.py b/google/cloud/vision/safe.py
deleted file mode 100644
index a2b8573f428a..000000000000
--- a/google/cloud/vision/safe.py
+++ /dev/null
@@ -1,101 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Safe search class for information returned from annotating an image."""
-
-
-from google.cloud.vision.likelihood import Likelihood
-
-
-class SafeSearchAnnotation(object):
-    """Representation of a SafeSearchAnnotation.
-
-    :type adult_likelihood: :class:`~google.cloud.vision.likelihood.Likelihood`
-    :param adult_likelihood: Likelihood that image contains adult material.
-
-    :type spoof_likelihood: :class:`~google.cloud.vision.likelihood.Likelihood`
-    :param spoof_likelihood: Likelihood that image is a spoof.
-
-    :type medical_likelihood:
-        :class:`~google.cloud.vision.likelihood.Likelihood`
-    :param medical_likelihood: Likelihood that image contains medical material.
-
-    :type violence_likelihood:
-        :class:`~google.cloud.vision.likelihood.Likelihood`
-    :param violence_likelihood: Likelihood that image contains violence.
-    """
-
-    def __init__(self, adult_likelihood, spoof_likelihood, medical_likelihood,
-                 violence_likelihood):
-        self._adult_likelihood = adult_likelihood
-        self._spoof_likelihood = spoof_likelihood
-        self._medical_likeliehood = medical_likelihood
-        self._violence_likelihood = violence_likelihood
-
-    @classmethod
-    def from_api_repr(cls, response):
-        """Factory: construct SafeSearchAnnotation from Vision API response.
-
-        :type response: dict
-        :param response: Dictionary response from Vision API with safe search
-                         data.
-
-        :rtype: :class:`~google.cloud.vision.safe.SafeSearchAnnotation`
-        :returns: Instance of ``SafeSearchAnnotation``.
-        """
-        adult_likelihood = getattr(Likelihood, response['adult'])
-        spoof_likelihood = getattr(Likelihood, response['spoof'])
-        medical_likelihood = getattr(Likelihood, response['medical'])
-        violence_likelihood = getattr(Likelihood, response['violence'])
-
-        return cls(adult_likelihood, spoof_likelihood, medical_likelihood,
-                   violence_likelihood)
-
-    @property
-    def adult(self):
-        """Represents the adult contents likelihood for the image.
-
-        :rtype: :class:`~google.cloud.vision.likelihood.Likelihood`
-        :returns: ``Likelihood`` of the image containing adult content.
-        """
-        return self._adult_likelihood
-
-    @property
-    def spoof(self):
-        """The likelihood that an obvious modification was made to the image.
-
-        :rtype: :class:`~google.cloud.vision.likelihood.Likelihood`
-        :returns: The ``Likelihood`` that an obvious modification was made to
-                  the image's canonical version to make it appear funny or
-                  offensive.
-        """
-        return self._spoof_likelihood
-
-    @property
-    def medical(self):
-        """Likelihood this is a medical image.
-
-        :rtype: :class:`~google.cloud.vision.likelihood.Likelihood`
-        :returns: The ``Likelihood`` that the image is medical in origin.
-        """
-        return self._medical_likeliehood
-
-    @property
-    def violence(self):
-        """Likeliehood that this image contains violence.
-
-        :rtype: :class:`~google.cloud.vision.likelihood.Likelihood`
-        :returns: The ``Likelihood`` that the image contains violence.
-        """
-        return self._violence_likelihood
diff --git a/grafeas/.coveragerc b/grafeas/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/grafeas/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/grafeas/.flake8 b/grafeas/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/grafeas/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/grafeas/.repo-metadata.json b/grafeas/.repo-metadata.json
new file mode 100644
index 000000000000..3be697127145
--- /dev/null
+++ b/grafeas/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "grafeas",
+  "name_pretty": "Grafeas",
+  "product_documentation": "https://grafeas.io",
+  "client_documentation": "https://googleapis.dev/python/grafeas/latest",
+  "issue_tracker": "",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "grafeas",
+  "api_id": "",
+  "requires_billing": false
+}
\ No newline at end of file
diff --git a/grafeas/CHANGELOG.md b/grafeas/CHANGELOG.md
new file mode 100644
index 000000000000..c9f55c42c36d
--- /dev/null
+++ b/grafeas/CHANGELOG.md
@@ -0,0 +1,30 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/grafeas/#history
+
+## 0.2.0
+
+07-12-2019 17:04 PDT
+
+
+### Implementation Changes
+- replace `min_affected_version` w/ `affected_version_{start,end}` (via synth).  ([#8465](https://github.com/googleapis/google-cloud-python/pull/8465))
+- Allow kwargs to be passed to create_channel, update templates (via synth). ([#8391](https://github.com/googleapis/google-cloud-python/pull/8391))
+
+### New Features
+- Update list method docstrings (via synth). ([#8510](https://github.com/googleapis/google-cloud-python/pull/8510))
+
+### Documentation
+- Update READMEs. ([#8456](https://github.com/googleapis/google-cloud-python/pull/8456))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.1.0
+
+06-17-2019 10:44 PDT
+
+### New Features
+- Initial release of the Grafeas client library. ([#8186](https://github.com/googleapis/google-cloud-python/pull/8186))
diff --git a/grafeas/LICENSE b/grafeas/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/grafeas/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/grafeas/MANIFEST.in b/grafeas/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/grafeas/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/grafeas/README.rst b/grafeas/README.rst
new file mode 100644
index 000000000000..b8997cffaf93
--- /dev/null
+++ b/grafeas/README.rst
@@ -0,0 +1,61 @@
+Python Client for Grafeas API (`Alpha`_)
+===================================================
+
+`Grafeas API`_: An implementation of the Grafeas API, which stores, and enables querying and
+retrieval of critical metadata about all of your software artifacts.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Grafeas API: https://grafeas.io/
+.. _Client Library Documentation: https://googleapis.dev/python/grafeas/latest
+.. _Product Documentation:  https://grafeas.io/
+
+Installation
+--------------
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install grafeas
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install grafeas
+
+Next Steps
+--------------
+
+-  Read the `Client Library Documentation`_ for Grafeas API
+   API to see other available methods on the client.
+-  Read the `Grafeas API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Grafeas API Product documentation:  https://grafeas.io/
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
\ No newline at end of file
diff --git a/grafeas/docs/README.rst b/grafeas/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/grafeas/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/grafeas/docs/changelog.md b/grafeas/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/grafeas/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/grafeas/docs/conf.py b/grafeas/docs/conf.py
new file mode 100644
index 000000000000..463061ed3e4a
--- /dev/null
+++ b/grafeas/docs/conf.py
@@ -0,0 +1,349 @@
+# -*- coding: utf-8 -*-
+#
+# grafeas documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"grafeas"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "grafeas-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, "grafeas.tex", u"grafeas Documentation", author, "manual")
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [(master_doc, "grafeas", u"grafeas Documentation", [author], 1)]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "grafeas",
+        u"grafeas Documentation",
+        author,
+        "grafeas",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/grafeas/docs/gapic/v1/api.rst b/grafeas/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..66589f53952e
--- /dev/null
+++ b/grafeas/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Grafeas API
+=================================
+
+.. automodule:: grafeas.grafeas_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/grafeas/docs/gapic/v1/types.rst b/grafeas/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..ee1343181d2d
--- /dev/null
+++ b/grafeas/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Grafeas API Client
+=======================================
+
+.. automodule:: grafeas.grafeas_v1.types
+    :members:
\ No newline at end of file
diff --git a/grafeas/docs/index.rst b/grafeas/docs/index.rst
new file mode 100644
index 000000000000..221c0e06399d
--- /dev/null
+++ b/grafeas/docs/index.rst
@@ -0,0 +1,19 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+
+Changelog
+---------
+
+For a list of all ``grafeas`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
\ No newline at end of file
diff --git a/grafeas/grafeas.py b/grafeas/grafeas.py
new file mode 100644
index 000000000000..b40dffd3313f
--- /dev/null
+++ b/grafeas/grafeas.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from grafeas_v1 import GrafeasClient
+from grafeas_v1 import enums
+from grafeas_v1 import types
+
+
+__all__ = (
+    'enums',
+    'types',
+    'GrafeasClient',
+)
diff --git a/grafeas/grafeas/__init__.py b/grafeas/grafeas/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/grafeas/grafeas/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/grafeas/grafeas/grafeas.py b/grafeas/grafeas/grafeas.py
new file mode 100644
index 000000000000..768aa8c77f29
--- /dev/null
+++ b/grafeas/grafeas/grafeas.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from grafeas.grafeas_v1 import GrafeasClient
+from grafeas.grafeas_v1 import enums
+from grafeas.grafeas_v1 import types
+
+
+__all__ = ("enums", "types", "GrafeasClient")
diff --git a/grafeas/grafeas/grafeas_v1/__init__.py b/grafeas/grafeas/grafeas_v1/__init__.py
new file mode 100644
index 000000000000..9bbb0db16767
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from grafeas.grafeas_v1 import types
+from grafeas.grafeas_v1.gapic import enums
+from grafeas.grafeas_v1.gapic import grafeas_client
+
+
+class GrafeasClient(grafeas_client.GrafeasClient):
+    __doc__ = grafeas_client.GrafeasClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "GrafeasClient")
diff --git a/grafeas/grafeas/grafeas_v1/gapic/__init__.py b/grafeas/grafeas/grafeas_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/grafeas/grafeas/grafeas_v1/gapic/enums.py b/grafeas/grafeas/grafeas_v1/gapic/enums.py
new file mode 100644
index 000000000000..af9846618abe
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/gapic/enums.py
@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Architecture(enum.IntEnum):
+    """
+    Instruction set architectures supported by various package managers.
+
+    Attributes:
+      ARCHITECTURE_UNSPECIFIED (int): Unknown architecture.
+      X86 (int): X86 architecture.
+      X64 (int): X64 architecture.
+    """
+
+    ARCHITECTURE_UNSPECIFIED = 0
+    X86 = 1
+    X64 = 2
+
+
+class NoteKind(enum.IntEnum):
+    """
+    Kind represents the kinds of notes supported.
+
+    Attributes:
+      NOTE_KIND_UNSPECIFIED (int): Unknown.
+      VULNERABILITY (int): The note and occurrence represent a package vulnerability.
+      BUILD (int): The note and occurrence assert build provenance.
+      IMAGE (int): This represents an image basis relationship.
+      PACKAGE (int): This represents a package installed via a package manager.
+      DEPLOYMENT (int): The note and occurrence track deployment events.
+      DISCOVERY (int): The note and occurrence track the initial discovery status of a resource.
+      ATTESTATION (int): This represents a logical "role" that can attest to artifacts.
+    """
+
+    NOTE_KIND_UNSPECIFIED = 0
+    VULNERABILITY = 1
+    BUILD = 2
+    IMAGE = 3
+    PACKAGE = 4
+    DEPLOYMENT = 5
+    DISCOVERY = 6
+    ATTESTATION = 7
+
+
+class Severity(enum.IntEnum):
+    """
+    Note provider assigned severity/impact ranking.
+
+    Attributes:
+      SEVERITY_UNSPECIFIED (int): Unknown.
+      MINIMAL (int): Minimal severity.
+      LOW (int): Low severity.
+      MEDIUM (int): Medium severity.
+      HIGH (int): High severity.
+      CRITICAL (int): Critical severity.
+    """
+
+    SEVERITY_UNSPECIFIED = 0
+    MINIMAL = 1
+    LOW = 2
+    MEDIUM = 3
+    HIGH = 4
+    CRITICAL = 5
+
+
+class AliasContext(object):
+    class Kind(enum.IntEnum):
+        """
+        The type of an alias.
+
+        Attributes:
+          KIND_UNSPECIFIED (int): Unknown.
+          FIXED (int): Git tag.
+          MOVABLE (int): Git branch.
+          OTHER (int): Used to specify non-standard aliases. For example, if a Git repo has a
+          ref named "refs/foo/bar".
+        """
+
+        KIND_UNSPECIFIED = 0
+        FIXED = 1
+        MOVABLE = 2
+        OTHER = 4
+
+
+class CVSSv3(object):
+    class AttackComplexity(enum.IntEnum):
+        """
+        Attributes:
+          ATTACK_COMPLEXITY_UNSPECIFIED (int)
+          ATTACK_COMPLEXITY_LOW (int)
+          ATTACK_COMPLEXITY_HIGH (int)
+        """
+
+        ATTACK_COMPLEXITY_UNSPECIFIED = 0
+        ATTACK_COMPLEXITY_LOW = 1
+        ATTACK_COMPLEXITY_HIGH = 2
+
+    class AttackVector(enum.IntEnum):
+        """
+        Attributes:
+          ATTACK_VECTOR_UNSPECIFIED (int)
+          ATTACK_VECTOR_NETWORK (int)
+          ATTACK_VECTOR_ADJACENT (int)
+          ATTACK_VECTOR_LOCAL (int)
+          ATTACK_VECTOR_PHYSICAL (int)
+        """
+
+        ATTACK_VECTOR_UNSPECIFIED = 0
+        ATTACK_VECTOR_NETWORK = 1
+        ATTACK_VECTOR_ADJACENT = 2
+        ATTACK_VECTOR_LOCAL = 3
+        ATTACK_VECTOR_PHYSICAL = 4
+
+    class Impact(enum.IntEnum):
+        """
+        Attributes:
+          IMPACT_UNSPECIFIED (int)
+          IMPACT_HIGH (int)
+          IMPACT_LOW (int)
+          IMPACT_NONE (int)
+        """
+
+        IMPACT_UNSPECIFIED = 0
+        IMPACT_HIGH = 1
+        IMPACT_LOW = 2
+        IMPACT_NONE = 3
+
+    class PrivilegesRequired(enum.IntEnum):
+        """
+        Attributes:
+          PRIVILEGES_REQUIRED_UNSPECIFIED (int)
+          PRIVILEGES_REQUIRED_NONE (int)
+          PRIVILEGES_REQUIRED_LOW (int)
+          PRIVILEGES_REQUIRED_HIGH (int)
+        """
+
+        PRIVILEGES_REQUIRED_UNSPECIFIED = 0
+        PRIVILEGES_REQUIRED_NONE = 1
+        PRIVILEGES_REQUIRED_LOW = 2
+        PRIVILEGES_REQUIRED_HIGH = 3
+
+    class Scope(enum.IntEnum):
+        """
+        Attributes:
+          SCOPE_UNSPECIFIED (int)
+          SCOPE_UNCHANGED (int)
+          SCOPE_CHANGED (int)
+        """
+
+        SCOPE_UNSPECIFIED = 0
+        SCOPE_UNCHANGED = 1
+        SCOPE_CHANGED = 2
+
+    class UserInteraction(enum.IntEnum):
+        """
+        Attributes:
+          USER_INTERACTION_UNSPECIFIED (int)
+          USER_INTERACTION_NONE (int)
+          USER_INTERACTION_REQUIRED (int)
+        """
+
+        USER_INTERACTION_UNSPECIFIED = 0
+        USER_INTERACTION_NONE = 1
+        USER_INTERACTION_REQUIRED = 2
+
+
+class DeploymentOccurrence(object):
+    class Platform(enum.IntEnum):
+        """
+        Types of platforms.
+
+        Attributes:
+          PLATFORM_UNSPECIFIED (int): Unknown.
+          GKE (int): Google Container Engine.
+          FLEX (int): Google App Engine: Flexible Environment.
+          CUSTOM (int): Custom user-defined platform.
+        """
+
+        PLATFORM_UNSPECIFIED = 0
+        GKE = 1
+        FLEX = 2
+        CUSTOM = 3
+
+
+class DiscoveryOccurrence(object):
+    class AnalysisStatus(enum.IntEnum):
+        """
+        Analysis status for a resource. Currently for initial analysis only (not
+        updated in continuous analysis).
+
+        Attributes:
+          ANALYSIS_STATUS_UNSPECIFIED (int): Unknown.
+          PENDING (int): Resource is known but no action has been taken yet.
+          SCANNING (int): Resource is being analyzed.
+          FINISHED_SUCCESS (int): Analysis has finished successfully.
+          FINISHED_FAILED (int): Analysis has finished unsuccessfully, the analysis itself is in a bad
+          state.
+          FINISHED_UNSUPPORTED (int): The resource is known not to be supported
+        """
+
+        ANALYSIS_STATUS_UNSPECIFIED = 0
+        PENDING = 1
+        SCANNING = 2
+        FINISHED_SUCCESS = 3
+        FINISHED_FAILED = 4
+        FINISHED_UNSUPPORTED = 5
+
+    class ContinuousAnalysis(enum.IntEnum):
+        """
+        Whether the resource is continuously analyzed.
+
+        Attributes:
+          CONTINUOUS_ANALYSIS_UNSPECIFIED (int): Unknown.
+          ACTIVE (int): The resource is continuously analyzed.
+          INACTIVE (int): The resource is ignored for continuous analysis.
+        """
+
+        CONTINUOUS_ANALYSIS_UNSPECIFIED = 0
+        ACTIVE = 1
+        INACTIVE = 2
+
+
+class Version(object):
+    class VersionKind(enum.IntEnum):
+        """
+        Whether this is an ordinary package version or a sentinel MIN/MAX version.
+
+        Attributes:
+          VERSION_KIND_UNSPECIFIED (int): Unknown.
+          NORMAL (int): A standard package version.
+          MINIMUM (int): A special version representing negative infinity.
+          MAXIMUM (int): A special version representing positive infinity.
+        """
+
+        VERSION_KIND_UNSPECIFIED = 0
+        NORMAL = 1
+        MINIMUM = 2
+        MAXIMUM = 3
diff --git a/grafeas/grafeas/grafeas_v1/gapic/grafeas_client.py b/grafeas/grafeas/grafeas_v1/gapic/grafeas_client.py
new file mode 100644
index 000000000000..a7e3c6d31713
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/gapic/grafeas_client.py
@@ -0,0 +1,1363 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the grafeas.v1 Grafeas API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from grafeas.grafeas_v1.gapic import enums
+from grafeas.grafeas_v1.gapic import grafeas_client_config
+from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+from grafeas.grafeas_v1.proto import grafeas_pb2
+from grafeas.grafeas_v1.proto import grafeas_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("grafeas").version
+
+
+class GrafeasClient(object):
+    """
+    `Grafeas <https://grafeas.io>`__ API.
+
+    Retrieves analysis results of Cloud components such as Docker container
+    images.
+
+    Analysis results are stored as a series of occurrences. An
+    ``Occurrence`` contains information about a specific analysis instance
+    on a resource. An occurrence refers to a ``Note``. A note contains
+    details describing the analysis and is generally stored in a separate
+    project, called a ``Provider``. Multiple occurrences can refer to the
+    same note.
+
+    For example, an SSL vulnerability could affect multiple images. In this
+    case, there would be one note for the vulnerability and an occurrence
+    for each image with the vulnerability referring to that note.
+    """
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "grafeas.v1.Grafeas"
+
+    @classmethod
+    def note_path(cls, project, note):
+        """Return a fully-qualified note string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/notes/{note}", project=project, note=note
+        )
+
+    @classmethod
+    def occurrence_path(cls, project, occurrence):
+        """Return a fully-qualified occurrence string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/occurrences/{occurrence}",
+            project=project,
+            occurrence=occurrence,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(self, transport, client_config=None, client_info=None):
+        """Constructor.
+
+        Args:
+            transport (~.GrafeasGrpcTransport): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = grafeas_client_config.config
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        self.transport = transport
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def get_occurrence(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the specified occurrence.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.occurrence_path('[PROJECT]', '[OCCURRENCE]')
+            >>>
+            >>> response = client.get_occurrence(name)
+
+        Args:
+            name (str): The name of the occurrence in the form of
+                ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Occurrence` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_occurrence" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_occurrence"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_occurrence,
+                default_retry=self._method_configs["GetOccurrence"].retry,
+                default_timeout=self._method_configs["GetOccurrence"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.GetOccurrenceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_occurrence"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_occurrences(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists occurrences for the specified project.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_occurrences(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_occurrences(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The name of the project to list occurrences for in the form of
+                ``projects/[PROJECT_ID]``.
+            filter_ (str): The filter expression.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~grafeas.grafeas_v1.types.Occurrence` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_occurrences" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_occurrences"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_occurrences,
+                default_retry=self._method_configs["ListOccurrences"].retry,
+                default_timeout=self._method_configs["ListOccurrences"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.ListOccurrencesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_occurrences"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="occurrences",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_occurrence(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the specified occurrence. For example, use this method to delete an
+        occurrence when the occurrence is no longer applicable for the given
+        resource.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.occurrence_path('[PROJECT]', '[OCCURRENCE]')
+            >>>
+            >>> client.delete_occurrence(name)
+
+        Args:
+            name (str): The name of the occurrence in the form of
+                ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_occurrence" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_occurrence"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_occurrence,
+                default_retry=self._method_configs["DeleteOccurrence"].retry,
+                default_timeout=self._method_configs["DeleteOccurrence"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.DeleteOccurrenceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_occurrence"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_occurrence(
+        self,
+        parent,
+        occurrence,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new occurrence.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `occurrence`:
+            >>> occurrence = {}
+            >>>
+            >>> response = client.create_occurrence(parent, occurrence)
+
+        Args:
+            parent (str): The name of the project in the form of ``projects/[PROJECT_ID]``, under
+                which the occurrence is to be created.
+            occurrence (Union[dict, ~grafeas.grafeas_v1.types.Occurrence]): The occurrence to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.Occurrence`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Occurrence` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_occurrence" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_occurrence"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_occurrence,
+                default_retry=self._method_configs["CreateOccurrence"].retry,
+                default_timeout=self._method_configs["CreateOccurrence"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.CreateOccurrenceRequest(
+            parent=parent, occurrence=occurrence
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_occurrence"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_create_occurrences(
+        self,
+        parent,
+        occurrences,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates new occurrences in batch.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `occurrences`:
+            >>> occurrences = []
+            >>>
+            >>> response = client.batch_create_occurrences(parent, occurrences)
+
+        Args:
+            parent (str): The name of the project in the form of ``projects/[PROJECT_ID]``, under
+                which the occurrences are to be created.
+            occurrences (list[Union[dict, ~grafeas.grafeas_v1.types.Occurrence]]): The occurrences to create. Max allowed length is 1000.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.Occurrence`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.BatchCreateOccurrencesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_create_occurrences" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_create_occurrences"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_create_occurrences,
+                default_retry=self._method_configs["BatchCreateOccurrences"].retry,
+                default_timeout=self._method_configs["BatchCreateOccurrences"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.BatchCreateOccurrencesRequest(
+            parent=parent, occurrences=occurrences
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_create_occurrences"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_occurrence(
+        self,
+        name,
+        occurrence,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the specified occurrence.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.occurrence_path('[PROJECT]', '[OCCURRENCE]')
+            >>>
+            >>> # TODO: Initialize `occurrence`:
+            >>> occurrence = {}
+            >>>
+            >>> response = client.update_occurrence(name, occurrence)
+
+        Args:
+            name (str): The name of the occurrence in the form of
+                ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+            occurrence (Union[dict, ~grafeas.grafeas_v1.types.Occurrence]): The updated occurrence.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.Occurrence`
+            update_mask (Union[dict, ~grafeas.grafeas_v1.types.FieldMask]): The fields to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Occurrence` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_occurrence" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_occurrence"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_occurrence,
+                default_retry=self._method_configs["UpdateOccurrence"].retry,
+                default_timeout=self._method_configs["UpdateOccurrence"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.UpdateOccurrenceRequest(
+            name=name, occurrence=occurrence, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_occurrence"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_occurrence_note(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the note attached to the specified occurrence. Consumer projects can
+        use this method to get a note that belongs to a provider project.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.occurrence_path('[PROJECT]', '[OCCURRENCE]')
+            >>>
+            >>> response = client.get_occurrence_note(name)
+
+        Args:
+            name (str): The name of the occurrence in the form of
+                ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Note` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_occurrence_note" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_occurrence_note"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_occurrence_note,
+                default_retry=self._method_configs["GetOccurrenceNote"].retry,
+                default_timeout=self._method_configs["GetOccurrenceNote"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.GetOccurrenceNoteRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_occurrence_note"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_note(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the specified note.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> response = client.get_note(name)
+
+        Args:
+            name (str): The name of the note in the form of
+                ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Note` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_note" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_note"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_note,
+                default_retry=self._method_configs["GetNote"].retry,
+                default_timeout=self._method_configs["GetNote"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.GetNoteRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_note"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_notes(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists notes for the specified project.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_notes(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_notes(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The name of the project to list notes for in the form of
+                ``projects/[PROJECT_ID]``.
+            filter_ (str): The filter expression.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~grafeas.grafeas_v1.types.Note` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_notes" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_notes"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_notes,
+                default_retry=self._method_configs["ListNotes"].retry,
+                default_timeout=self._method_configs["ListNotes"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.ListNotesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_notes"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="notes",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_note(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the specified note.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> client.delete_note(name)
+
+        Args:
+            name (str): The name of the note in the form of
+                ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_note" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_note"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_note,
+                default_retry=self._method_configs["DeleteNote"].retry,
+                default_timeout=self._method_configs["DeleteNote"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.DeleteNoteRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_note"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_note(
+        self,
+        parent,
+        note_id,
+        note,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new note.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `note_id`:
+            >>> note_id = ''
+            >>>
+            >>> # TODO: Initialize `note`:
+            >>> note = {}
+            >>>
+            >>> response = client.create_note(parent, note_id, note)
+
+        Args:
+            parent (str): The name of the project in the form of ``projects/[PROJECT_ID]``, under
+                which the note is to be created.
+            note_id (str): The ID to use for this note.
+            note (Union[dict, ~grafeas.grafeas_v1.types.Note]): The note to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.Note`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Note` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_note" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_note"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_note,
+                default_retry=self._method_configs["CreateNote"].retry,
+                default_timeout=self._method_configs["CreateNote"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.CreateNoteRequest(
+            parent=parent, note_id=note_id, note=note
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_note"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_create_notes(
+        self,
+        parent,
+        notes,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates new notes in batch.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `notes`:
+            >>> notes = {}
+            >>>
+            >>> response = client.batch_create_notes(parent, notes)
+
+        Args:
+            parent (str): The name of the project in the form of ``projects/[PROJECT_ID]``, under
+                which the notes are to be created.
+            notes (dict[str -> Union[dict, ~grafeas.grafeas_v1.types.Note]]): The notes to create. Max allowed length is 1000.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.Note`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.BatchCreateNotesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_create_notes" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_create_notes"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_create_notes,
+                default_retry=self._method_configs["BatchCreateNotes"].retry,
+                default_timeout=self._method_configs["BatchCreateNotes"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.BatchCreateNotesRequest(parent=parent, notes=notes)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_create_notes"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_note(
+        self,
+        name,
+        note,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the specified note.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> # TODO: Initialize `note`:
+            >>> note = {}
+            >>>
+            >>> response = client.update_note(name, note)
+
+        Args:
+            name (str): The name of the note in the form of
+                ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+            note (Union[dict, ~grafeas.grafeas_v1.types.Note]): The updated note.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.Note`
+            update_mask (Union[dict, ~grafeas.grafeas_v1.types.FieldMask]): The fields to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~grafeas.grafeas_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~grafeas.grafeas_v1.types.Note` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_note" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_note"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_note,
+                default_retry=self._method_configs["UpdateNote"].retry,
+                default_timeout=self._method_configs["UpdateNote"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.UpdateNoteRequest(
+            name=name, note=note, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_note"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_note_occurrences(
+        self,
+        name,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists occurrences referencing the specified note. Provider projects can use
+        this method to get all occurrences across consumer projects referencing the
+        specified note.
+
+        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)
+            >>>
+            >>> name = client.note_path('[PROJECT]', '[NOTE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_note_occurrences(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_note_occurrences(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The name of the note to list occurrences for in the form of
+                ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+            filter_ (str): The filter expression.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~grafeas.grafeas_v1.types.Occurrence` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_note_occurrences" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_note_occurrences"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_note_occurrences,
+                default_retry=self._method_configs["ListNoteOccurrences"].retry,
+                default_timeout=self._method_configs["ListNoteOccurrences"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = grafeas_pb2.ListNoteOccurrencesRequest(
+            name=name, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_note_occurrences"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="occurrences",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/grafeas/grafeas/grafeas_v1/gapic/grafeas_client_config.py b/grafeas/grafeas/grafeas_v1/gapic/grafeas_client_config.py
new file mode 100644
index 000000000000..f899bf6ddd4b
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/gapic/grafeas_client_config.py
@@ -0,0 +1,93 @@
+config = {
+    "interfaces": {
+        "grafeas.v1.Grafeas": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "GetOccurrence": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListOccurrences": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteOccurrence": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateOccurrence": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchCreateOccurrences": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateOccurrence": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetOccurrenceNote": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetNote": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListNotes": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteNote": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateNote": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchCreateNotes": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateNote": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListNoteOccurrences": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/grafeas/grafeas/grafeas_v1/gapic/transports/__init__.py b/grafeas/grafeas/grafeas_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/grafeas/grafeas/grafeas_v1/gapic/transports/grafeas_grpc_transport.py b/grafeas/grafeas/grafeas_v1/gapic/transports/grafeas_grpc_transport.py
new file mode 100644
index 000000000000..2e438b464d3d
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/gapic/transports/grafeas_grpc_transport.py
@@ -0,0 +1,289 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from grafeas.grafeas_v1.proto import grafeas_pb2_grpc
+
+
+class GrafeasGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    grafeas.v1 Grafeas API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    def __init__(self, address, scopes, channel=None, credentials=None):
+        """Instantiate the transport class.
+
+        Args:
+            address (str): The address where the service is hosted.
+            scopes (Sequence[str]): The scopes needed to make gRPC calls.
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+        
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address,
+                scopes,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"grafeas_stub": grafeas_pb2_grpc.GrafeasStub(channel)}
+
+    @classmethod
+    def create_channel(cls, address, scopes, credentials=None, **kwargs):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            scopes (Sequence[str]): The scopes needed to make gRPC calls.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=scopes, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def get_occurrence(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.get_occurrence`.
+
+        Gets the specified occurrence.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].GetOccurrence
+
+    @property
+    def list_occurrences(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.list_occurrences`.
+
+        Lists occurrences for the specified project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].ListOccurrences
+
+    @property
+    def delete_occurrence(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.delete_occurrence`.
+
+        Deletes the specified occurrence. For example, use this method to delete an
+        occurrence when the occurrence is no longer applicable for the given
+        resource.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].DeleteOccurrence
+
+    @property
+    def create_occurrence(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.create_occurrence`.
+
+        Creates a new occurrence.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].CreateOccurrence
+
+    @property
+    def batch_create_occurrences(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.batch_create_occurrences`.
+
+        Creates new occurrences in batch.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].BatchCreateOccurrences
+
+    @property
+    def update_occurrence(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.update_occurrence`.
+
+        Updates the specified occurrence.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].UpdateOccurrence
+
+    @property
+    def get_occurrence_note(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.get_occurrence_note`.
+
+        Gets the note attached to the specified occurrence. Consumer projects can
+        use this method to get a note that belongs to a provider project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].GetOccurrenceNote
+
+    @property
+    def get_note(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.get_note`.
+
+        Gets the specified note.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].GetNote
+
+    @property
+    def list_notes(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.list_notes`.
+
+        Lists notes for the specified project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].ListNotes
+
+    @property
+    def delete_note(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.delete_note`.
+
+        Deletes the specified note.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].DeleteNote
+
+    @property
+    def create_note(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.create_note`.
+
+        Creates a new note.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].CreateNote
+
+    @property
+    def batch_create_notes(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.batch_create_notes`.
+
+        Creates new notes in batch.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].BatchCreateNotes
+
+    @property
+    def update_note(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.update_note`.
+
+        Updates the specified note.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].UpdateNote
+
+    @property
+    def list_note_occurrences(self):
+        """Return the gRPC stub for :meth:`GrafeasClient.list_note_occurrences`.
+
+        Lists occurrences referencing the specified note. Provider projects can use
+        this method to get all occurrences across consumer projects referencing the
+        specified note.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["grafeas_stub"].ListNoteOccurrences
diff --git a/grafeas/grafeas/grafeas_v1/proto/__init__.py b/grafeas/grafeas/grafeas_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/grafeas/grafeas/grafeas_v1/proto/attestation.proto b/grafeas/grafeas/grafeas_v1/proto/attestation.proto
new file mode 100644
index 000000000000..61423d3eb29e
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/attestation.proto
@@ -0,0 +1,73 @@
+// 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 "grafeas/v1/common.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 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.
+
+// 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
+// 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 AttestationNote {
+  // 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
+  // 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
+  // verify.
+  message Hint {
+    // Required. The human readable name of this attestation authority, for
+    // example "qa".
+    string human_readable_name = 1;
+  }
+
+  // Hint hints at the purpose of the attestation authority.
+  Hint hint = 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 authority to which
+// this attestation is attached is primarily useful for lookup (how to find
+// this attestation if you already know the authority and artifact to be
+// verified) and intent (for which authority this attestation was intended to
+// sign.
+message AttestationOccurrence {
+  // Required. The serialized payload that is verified by one or more
+  // `signatures`.
+  bytes serialized_payload = 1;
+  // 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 = 2;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/attestation_pb2.py b/grafeas/grafeas/grafeas_v1/proto/attestation_pb2.py
new file mode 100644
index 000000000000..356e70bd170a
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/attestation_pb2.py
@@ -0,0 +1,260 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/attestation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from grafeas.grafeas_v1.proto import common_pb2 as grafeas__v1_dot_proto_dot_common__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/attestation.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n"grafeas_v1/proto/attestation.proto\x12\ngrafeas.v1\x1a\x1dgrafeas_v1/proto/common.proto"f\n\x0f\x41ttestationNote\x12.\n\x04hint\x18\x01 \x01(\x0b\x32 .grafeas.v1.AttestationNote.Hint\x1a#\n\x04Hint\x12\x1b\n\x13human_readable_name\x18\x01 \x01(\t"^\n\x15\x41ttestationOccurrence\x12\x1a\n\x12serialized_payload\x18\x01 \x01(\x0c\x12)\n\nsignatures\x18\x02 \x03(\x0b\x32\x15.grafeas.v1.SignatureBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[grafeas__v1_dot_proto_dot_common__pb2.DESCRIPTOR],
+)
+
+
+_ATTESTATIONNOTE_HINT = _descriptor.Descriptor(
+    name="Hint",
+    full_name="grafeas.v1.AttestationNote.Hint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="human_readable_name",
+            full_name="grafeas.v1.AttestationNote.Hint.human_readable_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=148,
+    serialized_end=183,
+)
+
+_ATTESTATIONNOTE = _descriptor.Descriptor(
+    name="AttestationNote",
+    full_name="grafeas.v1.AttestationNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hint",
+            full_name="grafeas.v1.AttestationNote.hint",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_ATTESTATIONNOTE_HINT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=81,
+    serialized_end=183,
+)
+
+
+_ATTESTATIONOCCURRENCE = _descriptor.Descriptor(
+    name="AttestationOccurrence",
+    full_name="grafeas.v1.AttestationOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="serialized_payload",
+            full_name="grafeas.v1.AttestationOccurrence.serialized_payload",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signatures",
+            full_name="grafeas.v1.AttestationOccurrence.signatures",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=185,
+    serialized_end=279,
+)
+
+_ATTESTATIONNOTE_HINT.containing_type = _ATTESTATIONNOTE
+_ATTESTATIONNOTE.fields_by_name["hint"].message_type = _ATTESTATIONNOTE_HINT
+_ATTESTATIONOCCURRENCE.fields_by_name[
+    "signatures"
+].message_type = grafeas__v1_dot_proto_dot_common__pb2._SIGNATURE
+DESCRIPTOR.message_types_by_name["AttestationNote"] = _ATTESTATIONNOTE
+DESCRIPTOR.message_types_by_name["AttestationOccurrence"] = _ATTESTATIONOCCURRENCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AttestationNote = _reflection.GeneratedProtocolMessageType(
+    "AttestationNote",
+    (_message.Message,),
+    dict(
+        Hint=_reflection.GeneratedProtocolMessageType(
+            "Hint",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ATTESTATIONNOTE_HINT,
+                __module__="grafeas_v1.proto.attestation_pb2",
+                __doc__="""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 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 verify.
+    
+    
+    Attributes:
+        human_readable_name:
+            Required. The human readable name of this attestation
+            authority, for example "qa".
+    """,
+                # @@protoc_insertion_point(class_scope:grafeas.v1.AttestationNote.Hint)
+            ),
+        ),
+        DESCRIPTOR=_ATTESTATIONNOTE,
+        __module__="grafeas_v1.proto.attestation_pb2",
+        __doc__="""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 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.
+  
+  
+  Attributes:
+      hint:
+          Hint hints at the purpose of the attestation authority.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.AttestationNote)
+    ),
+)
+_sym_db.RegisterMessage(AttestationNote)
+_sym_db.RegisterMessage(AttestationNote.Hint)
+
+AttestationOccurrence = _reflection.GeneratedProtocolMessageType(
+    "AttestationOccurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ATTESTATIONOCCURRENCE,
+        __module__="grafeas_v1.proto.attestation_pb2",
+        __doc__="""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
+  authority to which this attestation is attached is primarily useful for
+  lookup (how to find this attestation if you already know the authority
+  and artifact to be verified) and intent (for which authority this
+  attestation was intended to sign.
+  
+  
+  Attributes:
+      serialized_payload:
+          Required. The serialized payload that is verified by one or
+          more ``signatures``.
+      signatures:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.AttestationOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(AttestationOccurrence)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/attestation_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/attestation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/attestation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/build.proto b/grafeas/grafeas/grafeas_v1/proto/build.proto
new file mode 100644
index 000000000000..c0e9c7566540
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/build.proto
@@ -0,0 +1,50 @@
+// 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 "grafeas/v1/provenance.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";
+
+// Note holding the version of the provider's builder and the signature of the
+// provenance message in the build details occurrence.
+message BuildNote {
+  // Required. Immutable. Version of the builder which produced this build.
+  string builder_version = 1;
+}
+
+// Details of a build occurrence.
+message BuildOccurrence {
+  // Required. The actual provenance for the build.
+  grafeas.v1.BuildProvenance provenance = 1;
+
+  // Serialized JSON representation of the provenance, used in generating 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
+  // 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;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/build_pb2.py b/grafeas/grafeas/grafeas_v1/proto/build_pb2.py
new file mode 100644
index 000000000000..09be6011a42a
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/build_pb2.py
@@ -0,0 +1,190 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/build.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from grafeas.grafeas_v1.proto import (
+    provenance_pb2 as grafeas__v1_dot_proto_dot_provenance__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/build.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n\x1cgrafeas_v1/proto/build.proto\x12\ngrafeas.v1\x1a!grafeas_v1/proto/provenance.proto"$\n\tBuildNote\x12\x17\n\x0f\x62uilder_version\x18\x01 \x01(\t"\\\n\x0f\x42uildOccurrence\x12/\n\nprovenance\x18\x01 \x01(\x0b\x32\x1b.grafeas.v1.BuildProvenance\x12\x18\n\x10provenance_bytes\x18\x02 \x01(\tBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[grafeas__v1_dot_proto_dot_provenance__pb2.DESCRIPTOR],
+)
+
+
+_BUILDNOTE = _descriptor.Descriptor(
+    name="BuildNote",
+    full_name="grafeas.v1.BuildNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="builder_version",
+            full_name="grafeas.v1.BuildNote.builder_version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=79,
+    serialized_end=115,
+)
+
+
+_BUILDOCCURRENCE = _descriptor.Descriptor(
+    name="BuildOccurrence",
+    full_name="grafeas.v1.BuildOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="provenance",
+            full_name="grafeas.v1.BuildOccurrence.provenance",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="provenance_bytes",
+            full_name="grafeas.v1.BuildOccurrence.provenance_bytes",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=117,
+    serialized_end=209,
+)
+
+_BUILDOCCURRENCE.fields_by_name[
+    "provenance"
+].message_type = grafeas__v1_dot_proto_dot_provenance__pb2._BUILDPROVENANCE
+DESCRIPTOR.message_types_by_name["BuildNote"] = _BUILDNOTE
+DESCRIPTOR.message_types_by_name["BuildOccurrence"] = _BUILDOCCURRENCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+BuildNote = _reflection.GeneratedProtocolMessageType(
+    "BuildNote",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BUILDNOTE,
+        __module__="grafeas_v1.proto.build_pb2",
+        __doc__="""Note holding the version of the provider's builder and the signature of
+  the provenance message in the build details occurrence.
+  
+  
+  Attributes:
+      builder_version:
+          Required. Immutable. Version of the builder which produced
+          this build.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BuildNote)
+    ),
+)
+_sym_db.RegisterMessage(BuildNote)
+
+BuildOccurrence = _reflection.GeneratedProtocolMessageType(
+    "BuildOccurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BUILDOCCURRENCE,
+        __module__="grafeas_v1.proto.build_pb2",
+        __doc__="""Details of a build occurrence.
+  
+  
+  Attributes:
+      provenance:
+          Required. The actual provenance for the build.
+      provenance_bytes:
+          Serialized JSON representation of the provenance, used in
+          generating 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 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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BuildOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(BuildOccurrence)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/build_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/build_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/build_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/common.proto b/grafeas/grafeas/grafeas_v1/proto/common.proto
new file mode 100644
index 000000000000..846948a5286a
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/common.proto
@@ -0,0 +1,101 @@
+// 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;
+
+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";
+
+// Kind represents the kinds of notes supported.
+enum NoteKind {
+  // Unknown.
+  NOTE_KIND_UNSPECIFIED = 0;
+  // The note and occurrence represent a package vulnerability.
+  VULNERABILITY = 1;
+  // The note and occurrence assert build provenance.
+  BUILD = 2;
+  // This represents an image basis relationship.
+  IMAGE = 3;
+  // This represents a package installed via a package manager.
+  PACKAGE = 4;
+  // The note and occurrence track deployment events.
+  DEPLOYMENT = 5;
+  // The note and occurrence track the initial discovery status of a resource.
+  DISCOVERY = 6;
+  // This represents a logical "role" that can attest to artifacts.
+  ATTESTATION = 7;
+}
+
+// Metadata for any related URL information.
+message RelatedUrl {
+  // Specific URL associated with the resource.
+  string url = 1;
+  // 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/grafeas/grafeas/grafeas_v1/proto/common_pb2.py b/grafeas/grafeas/grafeas_v1/proto/common_pb2.py
new file mode 100644
index 000000000000..bce7181dc4b9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/common_pb2.py
@@ -0,0 +1,282 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/common.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n\x1dgrafeas_v1/proto/common.proto\x12\ngrafeas.v1"(\n\nRelatedUrl\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05label\x18\x02 \x01(\t"5\n\tSignature\x12\x11\n\tsignature\x18\x01 \x01(\x0c\x12\x15\n\rpublic_key_id\x18\x02 \x01(\t*\x8b\x01\n\x08NoteKind\x12\x19\n\x15NOTE_KIND_UNSPECIFIED\x10\x00\x12\x11\n\rVULNERABILITY\x10\x01\x12\t\n\x05\x42UILD\x10\x02\x12\t\n\x05IMAGE\x10\x03\x12\x0b\n\x07PACKAGE\x10\x04\x12\x0e\n\nDEPLOYMENT\x10\x05\x12\r\n\tDISCOVERY\x10\x06\x12\x0f\n\x0b\x41TTESTATION\x10\x07\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+)
+
+_NOTEKIND = _descriptor.EnumDescriptor(
+    name="NoteKind",
+    full_name="grafeas.v1.NoteKind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NOTE_KIND_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VULNERABILITY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BUILD", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PACKAGE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEPLOYMENT", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISCOVERY", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTESTATION", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=143,
+    serialized_end=282,
+)
+_sym_db.RegisterEnumDescriptor(_NOTEKIND)
+
+NoteKind = enum_type_wrapper.EnumTypeWrapper(_NOTEKIND)
+NOTE_KIND_UNSPECIFIED = 0
+VULNERABILITY = 1
+BUILD = 2
+IMAGE = 3
+PACKAGE = 4
+DEPLOYMENT = 5
+DISCOVERY = 6
+ATTESTATION = 7
+
+
+_RELATEDURL = _descriptor.Descriptor(
+    name="RelatedUrl",
+    full_name="grafeas.v1.RelatedUrl",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="grafeas.v1.RelatedUrl.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="grafeas.v1.RelatedUrl.label",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=45,
+    serialized_end=85,
+)
+
+
+_SIGNATURE = _descriptor.Descriptor(
+    name="Signature",
+    full_name="grafeas.v1.Signature",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="signature",
+            full_name="grafeas.v1.Signature.signature",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="public_key_id",
+            full_name="grafeas.v1.Signature.public_key_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=87,
+    serialized_end=140,
+)
+
+DESCRIPTOR.message_types_by_name["RelatedUrl"] = _RELATEDURL
+DESCRIPTOR.message_types_by_name["Signature"] = _SIGNATURE
+DESCRIPTOR.enum_types_by_name["NoteKind"] = _NOTEKIND
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+RelatedUrl = _reflection.GeneratedProtocolMessageType(
+    "RelatedUrl",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RELATEDURL,
+        __module__="grafeas_v1.proto.common_pb2",
+        __doc__="""Metadata for any related URL information.
+  
+  
+  Attributes:
+      url:
+          Specific URL associated with the resource.
+      label:
+          Label to describe usage of the URL.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.RelatedUrl)
+    ),
+)
+_sym_db.RegisterMessage(RelatedUrl)
+
+Signature = _reflection.GeneratedProtocolMessageType(
+    "Signature",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SIGNATURE,
+        __module__="grafeas_v1.proto.common_pb2",
+        __doc__="""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).
+  
+  
+  Attributes:
+      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.
+      public_key_id:
+          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;703f68f42aba2c6de30f488a5ea122fef76324679c9
+          bf89791ba95a1271589a5"
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Signature)
+    ),
+)
+_sym_db.RegisterMessage(Signature)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/common_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/cvss.proto b/grafeas/grafeas/grafeas_v1/proto/cvss.proto
new file mode 100644
index 000000000000..b41cd633d2a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/cvss.proto
@@ -0,0 +1,85 @@
+// 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;
+
+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";
+
+// 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/grafeas/grafeas/grafeas_v1/proto/cvss_pb2.py b/grafeas/grafeas/grafeas_v1/proto/cvss_pb2.py
new file mode 100644
index 000000000000..501eb4f7ca14
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/cvss_pb2.py
@@ -0,0 +1,521 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/cvss.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/cvss.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n\x1bgrafeas_v1/proto/cvss.proto\x12\ngrafeas.v1"\xc5\t\n\x06\x43VSSv3\x12\x12\n\nbase_score\x18\x01 \x01(\x02\x12\x1c\n\x14\x65xploitability_score\x18\x02 \x01(\x02\x12\x14\n\x0cimpact_score\x18\x03 \x01(\x02\x12\x36\n\rattack_vector\x18\x05 \x01(\x0e\x32\x1f.grafeas.v1.CVSSv3.AttackVector\x12>\n\x11\x61ttack_complexity\x18\x06 \x01(\x0e\x32#.grafeas.v1.CVSSv3.AttackComplexity\x12\x42\n\x13privileges_required\x18\x07 \x01(\x0e\x32%.grafeas.v1.CVSSv3.PrivilegesRequired\x12<\n\x10user_interaction\x18\x08 \x01(\x0e\x32".grafeas.v1.CVSSv3.UserInteraction\x12\'\n\x05scope\x18\t \x01(\x0e\x32\x18.grafeas.v1.CVSSv3.Scope\x12\x39\n\x16\x63onfidentiality_impact\x18\n \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\x12\x33\n\x10integrity_impact\x18\x0b \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact\x12\x36\n\x13\x61vailability_impact\x18\x0c \x01(\x0e\x32\x19.grafeas.v1.CVSSv3.Impact"\x99\x01\n\x0c\x41ttackVector\x12\x1d\n\x19\x41TTACK_VECTOR_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_VECTOR_NETWORK\x10\x01\x12\x1a\n\x16\x41TTACK_VECTOR_ADJACENT\x10\x02\x12\x17\n\x13\x41TTACK_VECTOR_LOCAL\x10\x03\x12\x1a\n\x16\x41TTACK_VECTOR_PHYSICAL\x10\x04"l\n\x10\x41ttackComplexity\x12!\n\x1d\x41TTACK_COMPLEXITY_UNSPECIFIED\x10\x00\x12\x19\n\x15\x41TTACK_COMPLEXITY_LOW\x10\x01\x12\x1a\n\x16\x41TTACK_COMPLEXITY_HIGH\x10\x02"\x92\x01\n\x12PrivilegesRequired\x12#\n\x1fPRIVILEGES_REQUIRED_UNSPECIFIED\x10\x00\x12\x1c\n\x18PRIVILEGES_REQUIRED_NONE\x10\x01\x12\x1b\n\x17PRIVILEGES_REQUIRED_LOW\x10\x02\x12\x1c\n\x18PRIVILEGES_REQUIRED_HIGH\x10\x03"m\n\x0fUserInteraction\x12 \n\x1cUSER_INTERACTION_UNSPECIFIED\x10\x00\x12\x19\n\x15USER_INTERACTION_NONE\x10\x01\x12\x1d\n\x19USER_INTERACTION_REQUIRED\x10\x02"F\n\x05Scope\x12\x15\n\x11SCOPE_UNSPECIFIED\x10\x00\x12\x13\n\x0fSCOPE_UNCHANGED\x10\x01\x12\x11\n\rSCOPE_CHANGED\x10\x02"R\n\x06Impact\x12\x16\n\x12IMPACT_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIMPACT_HIGH\x10\x01\x12\x0e\n\nIMPACT_LOW\x10\x02\x12\x0f\n\x0bIMPACT_NONE\x10\x03\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+)
+
+
+_CVSSV3_ATTACKVECTOR = _descriptor.EnumDescriptor(
+    name="AttackVector",
+    full_name="grafeas.v1.CVSSv3.AttackVector",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_VECTOR_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_VECTOR_NETWORK",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_VECTOR_ADJACENT",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_VECTOR_LOCAL",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_VECTOR_PHYSICAL",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=586,
+    serialized_end=739,
+)
+_sym_db.RegisterEnumDescriptor(_CVSSV3_ATTACKVECTOR)
+
+_CVSSV3_ATTACKCOMPLEXITY = _descriptor.EnumDescriptor(
+    name="AttackComplexity",
+    full_name="grafeas.v1.CVSSv3.AttackComplexity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_COMPLEXITY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_COMPLEXITY_LOW",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTACK_COMPLEXITY_HIGH",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=741,
+    serialized_end=849,
+)
+_sym_db.RegisterEnumDescriptor(_CVSSV3_ATTACKCOMPLEXITY)
+
+_CVSSV3_PRIVILEGESREQUIRED = _descriptor.EnumDescriptor(
+    name="PrivilegesRequired",
+    full_name="grafeas.v1.CVSSv3.PrivilegesRequired",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PRIVILEGES_REQUIRED_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRIVILEGES_REQUIRED_NONE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRIVILEGES_REQUIRED_LOW",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRIVILEGES_REQUIRED_HIGH",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=852,
+    serialized_end=998,
+)
+_sym_db.RegisterEnumDescriptor(_CVSSV3_PRIVILEGESREQUIRED)
+
+_CVSSV3_USERINTERACTION = _descriptor.EnumDescriptor(
+    name="UserInteraction",
+    full_name="grafeas.v1.CVSSv3.UserInteraction",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="USER_INTERACTION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="USER_INTERACTION_NONE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="USER_INTERACTION_REQUIRED",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1000,
+    serialized_end=1109,
+)
+_sym_db.RegisterEnumDescriptor(_CVSSV3_USERINTERACTION)
+
+_CVSSV3_SCOPE = _descriptor.EnumDescriptor(
+    name="Scope",
+    full_name="grafeas.v1.CVSSv3.Scope",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SCOPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCOPE_UNCHANGED",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCOPE_CHANGED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1111,
+    serialized_end=1181,
+)
+_sym_db.RegisterEnumDescriptor(_CVSSV3_SCOPE)
+
+_CVSSV3_IMPACT = _descriptor.EnumDescriptor(
+    name="Impact",
+    full_name="grafeas.v1.CVSSv3.Impact",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="IMPACT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPACT_HIGH", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPACT_LOW", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPACT_NONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1183,
+    serialized_end=1265,
+)
+_sym_db.RegisterEnumDescriptor(_CVSSV3_IMPACT)
+
+
+_CVSSV3 = _descriptor.Descriptor(
+    name="CVSSv3",
+    full_name="grafeas.v1.CVSSv3",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="base_score",
+            full_name="grafeas.v1.CVSSv3.base_score",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exploitability_score",
+            full_name="grafeas.v1.CVSSv3.exploitability_score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="impact_score",
+            full_name="grafeas.v1.CVSSv3.impact_score",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attack_vector",
+            full_name="grafeas.v1.CVSSv3.attack_vector",
+            index=3,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attack_complexity",
+            full_name="grafeas.v1.CVSSv3.attack_complexity",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="privileges_required",
+            full_name="grafeas.v1.CVSSv3.privileges_required",
+            index=5,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_interaction",
+            full_name="grafeas.v1.CVSSv3.user_interaction",
+            index=6,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="grafeas.v1.CVSSv3.scope",
+            index=7,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidentiality_impact",
+            full_name="grafeas.v1.CVSSv3.confidentiality_impact",
+            index=8,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="integrity_impact",
+            full_name="grafeas.v1.CVSSv3.integrity_impact",
+            index=9,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="availability_impact",
+            full_name="grafeas.v1.CVSSv3.availability_impact",
+            index=10,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _CVSSV3_ATTACKVECTOR,
+        _CVSSV3_ATTACKCOMPLEXITY,
+        _CVSSV3_PRIVILEGESREQUIRED,
+        _CVSSV3_USERINTERACTION,
+        _CVSSV3_SCOPE,
+        _CVSSV3_IMPACT,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=44,
+    serialized_end=1265,
+)
+
+_CVSSV3.fields_by_name["attack_vector"].enum_type = _CVSSV3_ATTACKVECTOR
+_CVSSV3.fields_by_name["attack_complexity"].enum_type = _CVSSV3_ATTACKCOMPLEXITY
+_CVSSV3.fields_by_name["privileges_required"].enum_type = _CVSSV3_PRIVILEGESREQUIRED
+_CVSSV3.fields_by_name["user_interaction"].enum_type = _CVSSV3_USERINTERACTION
+_CVSSV3.fields_by_name["scope"].enum_type = _CVSSV3_SCOPE
+_CVSSV3.fields_by_name["confidentiality_impact"].enum_type = _CVSSV3_IMPACT
+_CVSSV3.fields_by_name["integrity_impact"].enum_type = _CVSSV3_IMPACT
+_CVSSV3.fields_by_name["availability_impact"].enum_type = _CVSSV3_IMPACT
+_CVSSV3_ATTACKVECTOR.containing_type = _CVSSV3
+_CVSSV3_ATTACKCOMPLEXITY.containing_type = _CVSSV3
+_CVSSV3_PRIVILEGESREQUIRED.containing_type = _CVSSV3
+_CVSSV3_USERINTERACTION.containing_type = _CVSSV3
+_CVSSV3_SCOPE.containing_type = _CVSSV3
+_CVSSV3_IMPACT.containing_type = _CVSSV3
+DESCRIPTOR.message_types_by_name["CVSSv3"] = _CVSSV3
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CVSSv3 = _reflection.GeneratedProtocolMessageType(
+    "CVSSv3",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CVSSV3,
+        __module__="grafeas_v1.proto.cvss_pb2",
+        __doc__="""Common Vulnerability Scoring System version 3. For details, see
+  https://www.first.org/cvss/specification-document
+  
+  
+  Attributes:
+      base_score:
+          The base score is a function of the base metric scores.
+      attack_vector:
+          Base Metrics Represents the intrinsic characteristics of a
+          vulnerability that are constant over time and across user
+          environments.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.CVSSv3)
+    ),
+)
+_sym_db.RegisterMessage(CVSSv3)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/cvss_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/cvss_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/cvss_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/deployment.proto b/grafeas/grafeas/grafeas_v1/proto/deployment.proto
new file mode 100644
index 000000000000..5204004fd646
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/deployment.proto
@@ -0,0 +1,66 @@
+// 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";
+
+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 artifact that can be deployed in some runtime.
+message DeploymentNote {
+  // Required. Resource URI for the artifact being deployed.
+  repeated string resource_uri = 1;
+}
+
+// The period during which some deployable was active in a runtime.
+message DeploymentOccurrence {
+  // Identity of the user that triggered this deployment.
+  string user_email = 1;
+
+  // Required. 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 = 4;
+
+  // 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;
+
+  // 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;
+  }
+  // Platform hosting this deployment.
+  Platform platform = 7;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/deployment_pb2.py b/grafeas/grafeas/grafeas_v1/proto/deployment_pb2.py
new file mode 100644
index 000000000000..4f410ee35d56
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/deployment_pb2.py
@@ -0,0 +1,316 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/deployment.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/deployment.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n!grafeas_v1/proto/deployment.proto\x12\ngrafeas.v1\x1a\x1fgoogle/protobuf/timestamp.proto"&\n\x0e\x44\x65ploymentNote\x12\x14\n\x0cresource_uri\x18\x01 \x03(\t"\xc7\x02\n\x14\x44\x65ploymentOccurrence\x12\x12\n\nuser_email\x18\x01 \x01(\t\x12/\n\x0b\x64\x65ploy_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rundeploy_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06\x63onfig\x18\x04 \x01(\t\x12\x0f\n\x07\x61\x64\x64ress\x18\x05 \x01(\t\x12\x14\n\x0cresource_uri\x18\x06 \x03(\t\x12;\n\x08platform\x18\x07 \x01(\x0e\x32).grafeas.v1.DeploymentOccurrence.Platform"C\n\x08Platform\x12\x18\n\x14PLATFORM_UNSPECIFIED\x10\x00\x12\x07\n\x03GKE\x10\x01\x12\x08\n\x04\x46LEX\x10\x02\x12\n\n\x06\x43USTOM\x10\x03\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR],
+)
+
+
+_DEPLOYMENTOCCURRENCE_PLATFORM = _descriptor.EnumDescriptor(
+    name="Platform",
+    full_name="grafeas.v1.DeploymentOccurrence.Platform",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PLATFORM_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GKE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLEX", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=383,
+    serialized_end=450,
+)
+_sym_db.RegisterEnumDescriptor(_DEPLOYMENTOCCURRENCE_PLATFORM)
+
+
+_DEPLOYMENTNOTE = _descriptor.Descriptor(
+    name="DeploymentNote",
+    full_name="grafeas.v1.DeploymentNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_uri",
+            full_name="grafeas.v1.DeploymentNote.resource_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=82,
+    serialized_end=120,
+)
+
+
+_DEPLOYMENTOCCURRENCE = _descriptor.Descriptor(
+    name="DeploymentOccurrence",
+    full_name="grafeas.v1.DeploymentOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="user_email",
+            full_name="grafeas.v1.DeploymentOccurrence.user_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deploy_time",
+            full_name="grafeas.v1.DeploymentOccurrence.deploy_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="undeploy_time",
+            full_name="grafeas.v1.DeploymentOccurrence.undeploy_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="grafeas.v1.DeploymentOccurrence.config",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="address",
+            full_name="grafeas.v1.DeploymentOccurrence.address",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_uri",
+            full_name="grafeas.v1.DeploymentOccurrence.resource_uri",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="platform",
+            full_name="grafeas.v1.DeploymentOccurrence.platform",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DEPLOYMENTOCCURRENCE_PLATFORM],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=123,
+    serialized_end=450,
+)
+
+_DEPLOYMENTOCCURRENCE.fields_by_name[
+    "deploy_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEPLOYMENTOCCURRENCE.fields_by_name[
+    "undeploy_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEPLOYMENTOCCURRENCE.fields_by_name[
+    "platform"
+].enum_type = _DEPLOYMENTOCCURRENCE_PLATFORM
+_DEPLOYMENTOCCURRENCE_PLATFORM.containing_type = _DEPLOYMENTOCCURRENCE
+DESCRIPTOR.message_types_by_name["DeploymentNote"] = _DEPLOYMENTNOTE
+DESCRIPTOR.message_types_by_name["DeploymentOccurrence"] = _DEPLOYMENTOCCURRENCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DeploymentNote = _reflection.GeneratedProtocolMessageType(
+    "DeploymentNote",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEPLOYMENTNOTE,
+        __module__="grafeas_v1.proto.deployment_pb2",
+        __doc__="""An artifact that can be deployed in some runtime.
+  
+  
+  Attributes:
+      resource_uri:
+          Required. Resource URI for the artifact being deployed.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.DeploymentNote)
+    ),
+)
+_sym_db.RegisterMessage(DeploymentNote)
+
+DeploymentOccurrence = _reflection.GeneratedProtocolMessageType(
+    "DeploymentOccurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEPLOYMENTOCCURRENCE,
+        __module__="grafeas_v1.proto.deployment_pb2",
+        __doc__="""The period during which some deployable was active in a runtime.
+  
+  
+  Attributes:
+      user_email:
+          Identity of the user that triggered this deployment.
+      deploy_time:
+          Required. Beginning of the lifetime of this deployment.
+      undeploy_time:
+          End of the lifetime of this deployment.
+      config:
+          Configuration used to create this deployment.
+      address:
+          Address of the runtime element hosting this deployment.
+      resource_uri:
+          Output only. Resource URI for the artifact being deployed
+          taken from the deployable field with the same name.
+      platform:
+          Platform hosting this deployment.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.DeploymentOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(DeploymentOccurrence)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/deployment_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/deployment_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/deployment_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/discovery.proto b/grafeas/grafeas/grafeas_v1/proto/discovery.proto
new file mode 100644
index 000000000000..ba8034d38d9b
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/discovery.proto
@@ -0,0 +1,76 @@
+// 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/rpc/status.proto";
+import "grafeas/v1/common.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";
+
+// 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.
+message DiscoveryNote {
+  // Required. Immutable. The kind of analysis that is handled by this
+  // discovery.
+  grafeas.v1.NoteKind analysis_kind = 1;
+}
+
+// Provides information about the analysis status of a discovered resource.
+message DiscoveryOccurrence {
+  // Whether the resource is continuously analyzed.
+  enum ContinuousAnalysis {
+    // Unknown.
+    CONTINUOUS_ANALYSIS_UNSPECIFIED = 0;
+    // The resource is continuously analyzed.
+    ACTIVE = 1;
+    // The resource is ignored for continuous analysis.
+    INACTIVE = 2;
+  }
+
+  // Whether the resource is continuously analyzed.
+  ContinuousAnalysis continuous_analysis = 1;
+
+  // Analysis status for a resource. Currently for initial analysis only (not
+  // updated in continuous analysis).
+  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;
+    // The resource is known not to be supported
+    FINISHED_UNSUPPORTED = 5;
+  }
+
+  // The status of discovery for the resource.
+  AnalysisStatus analysis_status = 2;
+
+  // When an error is encountered this will contain a LocalizedMessage under
+  // details to show to the user. The LocalizedMessage is output only and
+  // populated by the API.
+  google.rpc.Status analysis_status_error = 3;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/discovery_pb2.py b/grafeas/grafeas/grafeas_v1/proto/discovery_pb2.py
new file mode 100644
index 000000000000..e8776e44b0a7
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/discovery_pb2.py
@@ -0,0 +1,296 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/discovery.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from grafeas.grafeas_v1.proto import common_pb2 as grafeas__v1_dot_proto_dot_common__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/discovery.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n grafeas_v1/proto/discovery.proto\x12\ngrafeas.v1\x1a\x17google/rpc/status.proto\x1a\x1dgrafeas_v1/proto/common.proto"<\n\rDiscoveryNote\x12+\n\ranalysis_kind\x18\x01 \x01(\x0e\x32\x14.grafeas.v1.NoteKind"\xcb\x03\n\x13\x44iscoveryOccurrence\x12O\n\x13\x63ontinuous_analysis\x18\x01 \x01(\x0e\x32\x32.grafeas.v1.DiscoveryOccurrence.ContinuousAnalysis\x12G\n\x0f\x61nalysis_status\x18\x02 \x01(\x0e\x32..grafeas.v1.DiscoveryOccurrence.AnalysisStatus\x12\x31\n\x15\x61nalysis_status_error\x18\x03 \x01(\x0b\x32\x12.google.rpc.Status"S\n\x12\x43ontinuousAnalysis\x12#\n\x1f\x43ONTINUOUS_ANALYSIS_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0c\n\x08INACTIVE\x10\x02"\x91\x01\n\x0e\x41nalysisStatus\x12\x1f\n\x1b\x41NALYSIS_STATUS_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x01\x12\x0c\n\x08SCANNING\x10\x02\x12\x14\n\x10\x46INISHED_SUCCESS\x10\x03\x12\x13\n\x0f\x46INISHED_FAILED\x10\x04\x12\x18\n\x14\x46INISHED_UNSUPPORTED\x10\x05\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DISCOVERYOCCURRENCE_CONTINUOUSANALYSIS = _descriptor.EnumDescriptor(
+    name="ContinuousAnalysis",
+    full_name="grafeas.v1.DiscoveryOccurrence.ContinuousAnalysis",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CONTINUOUS_ANALYSIS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INACTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=395,
+    serialized_end=478,
+)
+_sym_db.RegisterEnumDescriptor(_DISCOVERYOCCURRENCE_CONTINUOUSANALYSIS)
+
+_DISCOVERYOCCURRENCE_ANALYSISSTATUS = _descriptor.EnumDescriptor(
+    name="AnalysisStatus",
+    full_name="grafeas.v1.DiscoveryOccurrence.AnalysisStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ANALYSIS_STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCANNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED_SUCCESS",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED_FAILED",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED_UNSUPPORTED",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=481,
+    serialized_end=626,
+)
+_sym_db.RegisterEnumDescriptor(_DISCOVERYOCCURRENCE_ANALYSISSTATUS)
+
+
+_DISCOVERYNOTE = _descriptor.Descriptor(
+    name="DiscoveryNote",
+    full_name="grafeas.v1.DiscoveryNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="analysis_kind",
+            full_name="grafeas.v1.DiscoveryNote.analysis_kind",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=104,
+    serialized_end=164,
+)
+
+
+_DISCOVERYOCCURRENCE = _descriptor.Descriptor(
+    name="DiscoveryOccurrence",
+    full_name="grafeas.v1.DiscoveryOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="continuous_analysis",
+            full_name="grafeas.v1.DiscoveryOccurrence.continuous_analysis",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="analysis_status",
+            full_name="grafeas.v1.DiscoveryOccurrence.analysis_status",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="analysis_status_error",
+            full_name="grafeas.v1.DiscoveryOccurrence.analysis_status_error",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _DISCOVERYOCCURRENCE_CONTINUOUSANALYSIS,
+        _DISCOVERYOCCURRENCE_ANALYSISSTATUS,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=167,
+    serialized_end=626,
+)
+
+_DISCOVERYNOTE.fields_by_name[
+    "analysis_kind"
+].enum_type = grafeas__v1_dot_proto_dot_common__pb2._NOTEKIND
+_DISCOVERYOCCURRENCE.fields_by_name[
+    "continuous_analysis"
+].enum_type = _DISCOVERYOCCURRENCE_CONTINUOUSANALYSIS
+_DISCOVERYOCCURRENCE.fields_by_name[
+    "analysis_status"
+].enum_type = _DISCOVERYOCCURRENCE_ANALYSISSTATUS
+_DISCOVERYOCCURRENCE.fields_by_name[
+    "analysis_status_error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_DISCOVERYOCCURRENCE_CONTINUOUSANALYSIS.containing_type = _DISCOVERYOCCURRENCE
+_DISCOVERYOCCURRENCE_ANALYSISSTATUS.containing_type = _DISCOVERYOCCURRENCE
+DESCRIPTOR.message_types_by_name["DiscoveryNote"] = _DISCOVERYNOTE
+DESCRIPTOR.message_types_by_name["DiscoveryOccurrence"] = _DISCOVERYOCCURRENCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DiscoveryNote = _reflection.GeneratedProtocolMessageType(
+    "DiscoveryNote",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DISCOVERYNOTE,
+        __module__="grafeas_v1.proto.discovery_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      analysis_kind:
+          Required. Immutable. The kind of analysis that is handled by
+          this discovery.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.DiscoveryNote)
+    ),
+)
+_sym_db.RegisterMessage(DiscoveryNote)
+
+DiscoveryOccurrence = _reflection.GeneratedProtocolMessageType(
+    "DiscoveryOccurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DISCOVERYOCCURRENCE,
+        __module__="grafeas_v1.proto.discovery_pb2",
+        __doc__="""Provides information about the analysis status of a discovered resource.
+  
+  
+  Attributes:
+      continuous_analysis:
+          Whether the resource is continuously analyzed.
+      analysis_status:
+          The status of discovery for the resource.
+      analysis_status_error:
+          When an error is encountered this will contain a
+          LocalizedMessage under details to show to the user. The
+          LocalizedMessage is output only and populated by the API.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.DiscoveryOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(DiscoveryOccurrence)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/discovery_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/discovery_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/discovery_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/grafeas.proto b/grafeas/grafeas/grafeas_v1/proto/grafeas.proto
new file mode 100644
index 000000000000..1364b2aae63d
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/grafeas.proto
@@ -0,0 +1,452 @@
+// 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/api/annotations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "grafeas/v1/attestation.proto";
+import "grafeas/v1/build.proto";
+import "grafeas/v1/common.proto";
+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/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";
+
+// [Grafeas](https://grafeas.io) API.
+//
+// Retrieves analysis results of Cloud components such as Docker container
+// images.
+//
+// Analysis results are stored as a series of occurrences. An `Occurrence`
+// contains information about a specific analysis instance on a resource. An
+// occurrence refers to a `Note`. A note contains details describing the
+// analysis and is generally stored in a separate project, called a `Provider`.
+// Multiple occurrences can refer to the same note.
+//
+// For example, an SSL vulnerability could affect multiple images. In this case,
+// there would be one note for the vulnerability and an occurrence for each
+// image with the vulnerability referring to that note.
+service Grafeas {
+  // Gets the specified occurrence.
+  rpc GetOccurrence(GetOccurrenceRequest) returns (Occurrence) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/occurrences/*}"
+    };
+  }
+
+  // Lists occurrences for the specified project.
+  rpc ListOccurrences(ListOccurrencesRequest)
+      returns (ListOccurrencesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/occurrences"
+    };
+  }
+
+  // Deletes the specified occurrence. For example, use this method to delete an
+  // occurrence when the occurrence is no longer applicable for the given
+  // resource.
+  rpc DeleteOccurrence(DeleteOccurrenceRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/occurrences/*}"
+    };
+  }
+
+  // Creates a new occurrence.
+  rpc CreateOccurrence(CreateOccurrenceRequest) returns (Occurrence) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/occurrences"
+      body: "occurrence"
+    };
+  }
+
+  // Creates new occurrences in batch.
+  rpc BatchCreateOccurrences(BatchCreateOccurrencesRequest)
+      returns (BatchCreateOccurrencesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/occurrences:batchCreate"
+      body: "*"
+    };
+  }
+
+  // Updates the specified occurrence.
+  rpc UpdateOccurrence(UpdateOccurrenceRequest) returns (Occurrence) {
+    option (google.api.http) = {
+      patch: "/v1/{name=projects/*/occurrences/*}"
+      body: "occurrence"
+    };
+  }
+
+  // Gets the note attached to the specified occurrence. Consumer projects can
+  // use this method to get a note that belongs to a provider project.
+  rpc GetOccurrenceNote(GetOccurrenceNoteRequest) returns (Note) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/occurrences/*}/notes"
+    };
+  }
+
+  // Gets the specified note.
+  rpc GetNote(GetNoteRequest) returns (Note) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/notes/*}"
+    };
+  }
+
+  // Lists notes for the specified project.
+  rpc ListNotes(ListNotesRequest) returns (ListNotesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/notes"
+    };
+  }
+
+  // Deletes the specified note.
+  rpc DeleteNote(DeleteNoteRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/notes/*}"
+    };
+  }
+
+  // Creates a new note.
+  rpc CreateNote(CreateNoteRequest) returns (Note) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/notes"
+      body: "note"
+    };
+  }
+
+  // Creates new notes in batch.
+  rpc BatchCreateNotes(BatchCreateNotesRequest)
+      returns (BatchCreateNotesResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/notes:batchCreate"
+      body: "*"
+    };
+  }
+
+  // Updates the specified note.
+  rpc UpdateNote(UpdateNoteRequest) returns (Note) {
+    option (google.api.http) = {
+      patch: "/v1/{name=projects/*/notes/*}"
+      body: "note"
+    };
+  }
+
+  // Lists occurrences referencing the specified note. Provider projects can use
+  // this method to get all occurrences across consumer projects referencing the
+  // specified note.
+  rpc ListNoteOccurrences(ListNoteOccurrencesRequest)
+      returns (ListNoteOccurrencesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/notes/*}/occurrences"
+    };
+  }
+}
+
+// An instance of an analysis type that has been found on a resource.
+message Occurrence {
+  // Output only. The name of the occurrence in the form of
+  // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
+  string name = 1;
+
+  // Required. Immutable. A URI that represents the resource for which the
+  // occurrence applies. For example,
+  // `https://gcr.io/project/image@sha256:123abc` for a Docker image.
+  string resource_uri = 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.
+  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.
+  grafeas.v1.NoteKind kind = 4;
+
+  // 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 = 6;
+
+  // Output only. The time this occurrence was last updated.
+  google.protobuf.Timestamp update_time = 7;
+
+  // Required. Immutable. Describes the details of the note kind found on this
+  // resource.
+  oneof details {
+    // Describes a security vulnerability.
+    grafeas.v1.VulnerabilityOccurrence vulnerability = 8;
+    // Describes a verifiable build.
+    grafeas.v1.BuildOccurrence build = 9;
+    // Describes how this resource derives from the basis in the associated
+    // note.
+    grafeas.v1.ImageOccurrence image = 10;
+    // Describes the installation of a package on the linked resource.
+    grafeas.v1.PackageOccurrence package = 11;
+    // Describes the deployment of an artifact on a runtime.
+    grafeas.v1.DeploymentOccurrence deployment = 12;
+    // Describes when a resource was discovered.
+    grafeas.v1.DiscoveryOccurrence discovery = 13;
+    // Describes an attestation of an artifact.
+    grafeas.v1.AttestationOccurrence attestation = 14;
+  }
+}
+
+// A type of analysis that can be done for a resource.
+message Note {
+  // Output only. The name of the note in the form of
+  // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+  string name = 1;
+
+  // A one sentence description of this note.
+  string short_description = 2;
+
+  // A detailed description of this note.
+  string long_description = 3;
+
+  // Output only. The type of analysis. This field can be used as a filter in
+  // list requests.
+  grafeas.v1.NoteKind kind = 4;
+
+  // URLs associated with this note.
+  repeated grafeas.v1.RelatedUrl related_url = 5;
+
+  // Time of expiration for this note. Empty if note does not expire.
+  google.protobuf.Timestamp expiration_time = 6;
+
+  // Output only. The time this note was created. This field can be used as a
+  // filter in list requests.
+  google.protobuf.Timestamp create_time = 7;
+
+  // 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 = 8;
+
+  // Other notes related to this note.
+  repeated string related_note_names = 9;
+
+  // Required. Immutable. The type of analysis this note represents.
+  oneof type {
+    // A note describing a package vulnerability.
+    grafeas.v1.VulnerabilityNote vulnerability = 10;
+    // A note describing build provenance for a verifiable build.
+    grafeas.v1.BuildNote build = 11;
+    // A note describing a base image.
+    grafeas.v1.ImageNote image = 12;
+    // A note describing a package hosted by various package managers.
+    grafeas.v1.PackageNote package = 13;
+    // A note describing something that can be deployed.
+    grafeas.v1.DeploymentNote deployment = 14;
+    // A note describing the initial analysis of a resource.
+    grafeas.v1.DiscoveryNote discovery = 15;
+    // A note describing an attestation role.
+    grafeas.v1.AttestationNote attestation = 16;
+  }
+}
+
+// Request to get an occurrence.
+message GetOccurrenceRequest {
+  // The name of the occurrence in the form of
+  // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
+  string name = 1;
+}
+
+// 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;
+
+  // The filter expression.
+  string filter = 2;
+
+  // Number of occurrences to return in the list. Must be positive. Max allowed
+  // page size is 1000. If not specified, page size defaults to 20.
+  int32 page_size = 3;
+
+  // Token to provide to skip to a particular spot in the list.
+  string page_token = 4;
+}
+
+// Response for listing 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 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;
+  // The occurrence to create.
+  Occurrence occurrence = 2;
+}
+
+// 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;
+  // 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
+  // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+  string name = 1;
+}
+
+// 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;
+}
+
+// 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;
+
+  // The filter expression.
+  string filter = 2;
+
+  // Number of notes to return in the list. Must be positive. Max allowed page
+  // size is 1000. If not specified, page size defaults to 20.
+  int32 page_size = 3;
+
+  // Token to provide to skip to a particular spot in the list.
+  string page_token = 4;
+}
+
+// Response for listing notes.
+message ListNotesResponse {
+  // The notes 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
+  // results.
+  string next_page_token = 2;
+}
+
+// Request to delete a note.
+message DeleteNoteRequest {
+  // The name of the note in the form of
+  // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+  string name = 1;
+}
+
+// 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;
+  // The ID to use for this note.
+  string note_id = 2;
+  // The note to create.
+  Note note = 3;
+}
+
+// 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;
+  // The updated note.
+  Note note = 2;
+  // The fields to update.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// Request to list occurrences for a note.
+message ListNoteOccurrencesRequest {
+  // The name of the note to list occurrences for in the form of
+  // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+  string name = 1;
+  // 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;
+}
+
+// Response for listing occurrences for a note.
+message ListNoteOccurrencesResponse {
+  // The occurrences attached to the specified note.
+  repeated Occurrence occurrences = 1;
+  // Token to provide to skip to a particular spot in the list.
+  string next_page_token = 2;
+}
+
+// Request to create notes in batch.
+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;
+
+  // The notes to create. Max allowed length is 1000.
+  map<string, Note> notes = 2;
+}
+
+// Response for creating notes in batch.
+message BatchCreateNotesResponse {
+  // The notes that were created.
+  repeated Note notes = 1;
+}
+
+// Request to create occurrences in batch.
+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;
+
+  // The occurrences to create. Max allowed length is 1000.
+  repeated Occurrence occurrences = 2;
+}
+
+// Response for creating occurrences in batch.
+message BatchCreateOccurrencesResponse {
+  // The occurrences that were created.
+  repeated Occurrence occurrences = 1;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/grafeas_pb2.py b/grafeas/grafeas/grafeas_v1/proto/grafeas_pb2.py
new file mode 100644
index 000000000000..89af50706aa9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/grafeas_pb2.py
@@ -0,0 +1,2721 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/grafeas.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from grafeas.grafeas_v1.proto import (
+    attestation_pb2 as grafeas__v1_dot_proto_dot_attestation__pb2,
+)
+from grafeas.grafeas_v1.proto import build_pb2 as grafeas__v1_dot_proto_dot_build__pb2
+from grafeas.grafeas_v1.proto import common_pb2 as grafeas__v1_dot_proto_dot_common__pb2
+from grafeas.grafeas_v1.proto import (
+    deployment_pb2 as grafeas__v1_dot_proto_dot_deployment__pb2,
+)
+from grafeas.grafeas_v1.proto import (
+    discovery_pb2 as grafeas__v1_dot_proto_dot_discovery__pb2,
+)
+from grafeas.grafeas_v1.proto import image_pb2 as grafeas__v1_dot_proto_dot_image__pb2
+from grafeas.grafeas_v1.proto import (
+    package_pb2 as grafeas__v1_dot_proto_dot_package__pb2,
+)
+from grafeas.grafeas_v1.proto import (
+    provenance_pb2 as grafeas__v1_dot_proto_dot_provenance__pb2,
+)
+from grafeas.grafeas_v1.proto import (
+    vulnerability_pb2 as grafeas__v1_dot_proto_dot_vulnerability__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/grafeas.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n\x1egrafeas_v1/proto/grafeas.proto\x12\ngrafeas.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a"grafeas_v1/proto/attestation.proto\x1a\x1cgrafeas_v1/proto/build.proto\x1a\x1dgrafeas_v1/proto/common.proto\x1a!grafeas_v1/proto/deployment.proto\x1a grafeas_v1/proto/discovery.proto\x1a\x1cgrafeas_v1/proto/image.proto\x1a\x1egrafeas_v1/proto/package.proto\x1a!grafeas_v1/proto/provenance.proto\x1a$grafeas_v1/proto/vulnerability.proto"\xdd\x04\n\nOccurrence\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0cresource_uri\x18\x02 \x01(\t\x12\x11\n\tnote_name\x18\x03 \x01(\t\x12"\n\x04kind\x18\x04 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\x12\x13\n\x0bremediation\x18\x05 \x01(\t\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\rvulnerability\x18\x08 \x01(\x0b\x32#.grafeas.v1.VulnerabilityOccurrenceH\x00\x12,\n\x05\x62uild\x18\t \x01(\x0b\x32\x1b.grafeas.v1.BuildOccurrenceH\x00\x12,\n\x05image\x18\n \x01(\x0b\x32\x1b.grafeas.v1.ImageOccurrenceH\x00\x12\x30\n\x07package\x18\x0b \x01(\x0b\x32\x1d.grafeas.v1.PackageOccurrenceH\x00\x12\x36\n\ndeployment\x18\x0c \x01(\x0b\x32 .grafeas.v1.DeploymentOccurrenceH\x00\x12\x34\n\tdiscovery\x18\r \x01(\x0b\x32\x1f.grafeas.v1.DiscoveryOccurrenceH\x00\x12\x38\n\x0b\x61ttestation\x18\x0e \x01(\x0b\x32!.grafeas.v1.AttestationOccurrenceH\x00\x42\t\n\x07\x64\x65tails"\x9f\x05\n\x04Note\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x11short_description\x18\x02 \x01(\t\x12\x18\n\x10long_description\x18\x03 \x01(\t\x12"\n\x04kind\x18\x04 \x01(\x0e\x32\x14.grafeas.v1.NoteKind\x12+\n\x0brelated_url\x18\x05 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x33\n\x0f\x65xpiration_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1a\n\x12related_note_names\x18\t \x03(\t\x12\x36\n\rvulnerability\x18\n \x01(\x0b\x32\x1d.grafeas.v1.VulnerabilityNoteH\x00\x12&\n\x05\x62uild\x18\x0b \x01(\x0b\x32\x15.grafeas.v1.BuildNoteH\x00\x12&\n\x05image\x18\x0c \x01(\x0b\x32\x15.grafeas.v1.ImageNoteH\x00\x12*\n\x07package\x18\r \x01(\x0b\x32\x17.grafeas.v1.PackageNoteH\x00\x12\x30\n\ndeployment\x18\x0e \x01(\x0b\x32\x1a.grafeas.v1.DeploymentNoteH\x00\x12.\n\tdiscovery\x18\x0f \x01(\x0b\x32\x19.grafeas.v1.DiscoveryNoteH\x00\x12\x32\n\x0b\x61ttestation\x18\x10 \x01(\x0b\x32\x1b.grafeas.v1.AttestationNoteH\x00\x42\x06\n\x04type"$\n\x14GetOccurrenceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"_\n\x16ListOccurrencesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"_\n\x17ListOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\'\n\x17\x44\x65leteOccurrenceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"U\n\x17\x43reateOccurrenceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12*\n\noccurrence\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.Occurrence"\x84\x01\n\x17UpdateOccurrenceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12*\n\noccurrence\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.Occurrence\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x1e\n\x0eGetNoteRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"(\n\x18GetOccurrenceNoteRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"Y\n\x10ListNotesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"M\n\x11ListNotesResponse\x12\x1f\n\x05notes\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Note\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"!\n\x11\x44\x65leteNoteRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"T\n\x11\x43reateNoteRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0f\n\x07note_id\x18\x02 \x01(\t\x12\x1e\n\x04note\x18\x03 \x01(\x0b\x32\x10.grafeas.v1.Note"r\n\x11UpdateNoteRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1e\n\x04note\x18\x02 \x01(\x0b\x32\x10.grafeas.v1.Note\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"a\n\x1aListNoteOccurrencesRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"c\n\x1bListNoteOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xa8\x01\n\x17\x42\x61tchCreateNotesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12=\n\x05notes\x18\x02 \x03(\x0b\x32..grafeas.v1.BatchCreateNotesRequest.NotesEntry\x1a>\n\nNotesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1f\n\x05value\x18\x02 \x01(\x0b\x32\x10.grafeas.v1.Note:\x02\x38\x01";\n\x18\x42\x61tchCreateNotesResponse\x12\x1f\n\x05notes\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Note"\\\n\x1d\x42\x61tchCreateOccurrencesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12+\n\x0boccurrences\x18\x02 \x03(\x0b\x32\x16.grafeas.v1.Occurrence"M\n\x1e\x42\x61tchCreateOccurrencesResponse\x12+\n\x0boccurrences\x18\x01 \x03(\x0b\x32\x16.grafeas.v1.Occurrence2\x94\x0e\n\x07Grafeas\x12v\n\rGetOccurrence\x12 .grafeas.v1.GetOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence"+\x82\xd3\xe4\x93\x02%\x12#/v1/{name=projects/*/occurrences/*}\x12\x87\x01\n\x0fListOccurrences\x12".grafeas.v1.ListOccurrencesRequest\x1a#.grafeas.v1.ListOccurrencesResponse"+\x82\xd3\xe4\x93\x02%\x12#/v1/{parent=projects/*}/occurrences\x12|\n\x10\x44\x65leteOccurrence\x12#.grafeas.v1.DeleteOccurrenceRequest\x1a\x16.google.protobuf.Empty"+\x82\xd3\xe4\x93\x02%*#/v1/{name=projects/*/occurrences/*}\x12\x88\x01\n\x10\x43reateOccurrence\x12#.grafeas.v1.CreateOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence"7\x82\xd3\xe4\x93\x02\x31"#/v1/{parent=projects/*}/occurrences:\noccurrence\x12\xab\x01\n\x16\x42\x61tchCreateOccurrences\x12).grafeas.v1.BatchCreateOccurrencesRequest\x1a*.grafeas.v1.BatchCreateOccurrencesResponse":\x82\xd3\xe4\x93\x02\x34"//v1/{parent=projects/*}/occurrences:batchCreate:\x01*\x12\x88\x01\n\x10UpdateOccurrence\x12#.grafeas.v1.UpdateOccurrenceRequest\x1a\x16.grafeas.v1.Occurrence"7\x82\xd3\xe4\x93\x02\x31\x32#/v1/{name=projects/*/occurrences/*}:\noccurrence\x12~\n\x11GetOccurrenceNote\x12$.grafeas.v1.GetOccurrenceNoteRequest\x1a\x10.grafeas.v1.Note"1\x82\xd3\xe4\x93\x02+\x12)/v1/{name=projects/*/occurrences/*}/notes\x12^\n\x07GetNote\x12\x1a.grafeas.v1.GetNoteRequest\x1a\x10.grafeas.v1.Note"%\x82\xd3\xe4\x93\x02\x1f\x12\x1d/v1/{name=projects/*/notes/*}\x12o\n\tListNotes\x12\x1c.grafeas.v1.ListNotesRequest\x1a\x1d.grafeas.v1.ListNotesResponse"%\x82\xd3\xe4\x93\x02\x1f\x12\x1d/v1/{parent=projects/*}/notes\x12j\n\nDeleteNote\x12\x1d.grafeas.v1.DeleteNoteRequest\x1a\x16.google.protobuf.Empty"%\x82\xd3\xe4\x93\x02\x1f*\x1d/v1/{name=projects/*/notes/*}\x12j\n\nCreateNote\x12\x1d.grafeas.v1.CreateNoteRequest\x1a\x10.grafeas.v1.Note"+\x82\xd3\xe4\x93\x02%"\x1d/v1/{parent=projects/*}/notes:\x04note\x12\x93\x01\n\x10\x42\x61tchCreateNotes\x12#.grafeas.v1.BatchCreateNotesRequest\x1a$.grafeas.v1.BatchCreateNotesResponse"4\x82\xd3\xe4\x93\x02.")/v1/{parent=projects/*}/notes:batchCreate:\x01*\x12j\n\nUpdateNote\x12\x1d.grafeas.v1.UpdateNoteRequest\x1a\x10.grafeas.v1.Note"+\x82\xd3\xe4\x93\x02%2\x1d/v1/{name=projects/*/notes/*}:\x04note\x12\x99\x01\n\x13ListNoteOccurrences\x12&.grafeas.v1.ListNoteOccurrencesRequest\x1a\'.grafeas.v1.ListNoteOccurrencesResponse"1\x82\xd3\xe4\x93\x02+\x12)/v1/{name=projects/*/notes/*}/occurrencesBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_attestation__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_build__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_deployment__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_discovery__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_image__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_package__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_provenance__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_vulnerability__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_OCCURRENCE = _descriptor.Descriptor(
+    name="Occurrence",
+    full_name="grafeas.v1.Occurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.Occurrence.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_uri",
+            full_name="grafeas.v1.Occurrence.resource_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="note_name",
+            full_name="grafeas.v1.Occurrence.note_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="grafeas.v1.Occurrence.kind",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="remediation",
+            full_name="grafeas.v1.Occurrence.remediation",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="grafeas.v1.Occurrence.create_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="grafeas.v1.Occurrence.update_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="vulnerability",
+            full_name="grafeas.v1.Occurrence.vulnerability",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="build",
+            full_name="grafeas.v1.Occurrence.build",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="grafeas.v1.Occurrence.image",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="package",
+            full_name="grafeas.v1.Occurrence.package",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deployment",
+            full_name="grafeas.v1.Occurrence.deployment",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery",
+            full_name="grafeas.v1.Occurrence.discovery",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attestation",
+            full_name="grafeas.v1.Occurrence.attestation",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="details",
+            full_name="grafeas.v1.Occurrence.details",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=474,
+    serialized_end=1079,
+)
+
+
+_NOTE = _descriptor.Descriptor(
+    name="Note",
+    full_name="grafeas.v1.Note",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.Note.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="short_description",
+            full_name="grafeas.v1.Note.short_description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="long_description",
+            full_name="grafeas.v1.Note.long_description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="grafeas.v1.Note.kind",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="related_url",
+            full_name="grafeas.v1.Note.related_url",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiration_time",
+            full_name="grafeas.v1.Note.expiration_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="grafeas.v1.Note.create_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="grafeas.v1.Note.update_time",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="related_note_names",
+            full_name="grafeas.v1.Note.related_note_names",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="vulnerability",
+            full_name="grafeas.v1.Note.vulnerability",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="build",
+            full_name="grafeas.v1.Note.build",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="grafeas.v1.Note.image",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="package",
+            full_name="grafeas.v1.Note.package",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="deployment",
+            full_name="grafeas.v1.Note.deployment",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="discovery",
+            full_name="grafeas.v1.Note.discovery",
+            index=14,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attestation",
+            full_name="grafeas.v1.Note.attestation",
+            index=15,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="grafeas.v1.Note.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1082,
+    serialized_end=1753,
+)
+
+
+_GETOCCURRENCEREQUEST = _descriptor.Descriptor(
+    name="GetOccurrenceRequest",
+    full_name="grafeas.v1.GetOccurrenceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.GetOccurrenceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1755,
+    serialized_end=1791,
+)
+
+
+_LISTOCCURRENCESREQUEST = _descriptor.Descriptor(
+    name="ListOccurrencesRequest",
+    full_name="grafeas.v1.ListOccurrencesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="grafeas.v1.ListOccurrencesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="grafeas.v1.ListOccurrencesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="grafeas.v1.ListOccurrencesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="grafeas.v1.ListOccurrencesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1793,
+    serialized_end=1888,
+)
+
+
+_LISTOCCURRENCESRESPONSE = _descriptor.Descriptor(
+    name="ListOccurrencesResponse",
+    full_name="grafeas.v1.ListOccurrencesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="occurrences",
+            full_name="grafeas.v1.ListOccurrencesResponse.occurrences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="grafeas.v1.ListOccurrencesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1890,
+    serialized_end=1985,
+)
+
+
+_DELETEOCCURRENCEREQUEST = _descriptor.Descriptor(
+    name="DeleteOccurrenceRequest",
+    full_name="grafeas.v1.DeleteOccurrenceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.DeleteOccurrenceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1987,
+    serialized_end=2026,
+)
+
+
+_CREATEOCCURRENCEREQUEST = _descriptor.Descriptor(
+    name="CreateOccurrenceRequest",
+    full_name="grafeas.v1.CreateOccurrenceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="grafeas.v1.CreateOccurrenceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="occurrence",
+            full_name="grafeas.v1.CreateOccurrenceRequest.occurrence",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2028,
+    serialized_end=2113,
+)
+
+
+_UPDATEOCCURRENCEREQUEST = _descriptor.Descriptor(
+    name="UpdateOccurrenceRequest",
+    full_name="grafeas.v1.UpdateOccurrenceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.UpdateOccurrenceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="occurrence",
+            full_name="grafeas.v1.UpdateOccurrenceRequest.occurrence",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="grafeas.v1.UpdateOccurrenceRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2116,
+    serialized_end=2248,
+)
+
+
+_GETNOTEREQUEST = _descriptor.Descriptor(
+    name="GetNoteRequest",
+    full_name="grafeas.v1.GetNoteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.GetNoteRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2250,
+    serialized_end=2280,
+)
+
+
+_GETOCCURRENCENOTEREQUEST = _descriptor.Descriptor(
+    name="GetOccurrenceNoteRequest",
+    full_name="grafeas.v1.GetOccurrenceNoteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.GetOccurrenceNoteRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2282,
+    serialized_end=2322,
+)
+
+
+_LISTNOTESREQUEST = _descriptor.Descriptor(
+    name="ListNotesRequest",
+    full_name="grafeas.v1.ListNotesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="grafeas.v1.ListNotesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="grafeas.v1.ListNotesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="grafeas.v1.ListNotesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="grafeas.v1.ListNotesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2324,
+    serialized_end=2413,
+)
+
+
+_LISTNOTESRESPONSE = _descriptor.Descriptor(
+    name="ListNotesResponse",
+    full_name="grafeas.v1.ListNotesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="notes",
+            full_name="grafeas.v1.ListNotesResponse.notes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="grafeas.v1.ListNotesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2415,
+    serialized_end=2492,
+)
+
+
+_DELETENOTEREQUEST = _descriptor.Descriptor(
+    name="DeleteNoteRequest",
+    full_name="grafeas.v1.DeleteNoteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.DeleteNoteRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2494,
+    serialized_end=2527,
+)
+
+
+_CREATENOTEREQUEST = _descriptor.Descriptor(
+    name="CreateNoteRequest",
+    full_name="grafeas.v1.CreateNoteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="grafeas.v1.CreateNoteRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="note_id",
+            full_name="grafeas.v1.CreateNoteRequest.note_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="note",
+            full_name="grafeas.v1.CreateNoteRequest.note",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2529,
+    serialized_end=2613,
+)
+
+
+_UPDATENOTEREQUEST = _descriptor.Descriptor(
+    name="UpdateNoteRequest",
+    full_name="grafeas.v1.UpdateNoteRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.UpdateNoteRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="note",
+            full_name="grafeas.v1.UpdateNoteRequest.note",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="grafeas.v1.UpdateNoteRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2615,
+    serialized_end=2729,
+)
+
+
+_LISTNOTEOCCURRENCESREQUEST = _descriptor.Descriptor(
+    name="ListNoteOccurrencesRequest",
+    full_name="grafeas.v1.ListNoteOccurrencesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.ListNoteOccurrencesRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="grafeas.v1.ListNoteOccurrencesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="grafeas.v1.ListNoteOccurrencesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="grafeas.v1.ListNoteOccurrencesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2731,
+    serialized_end=2828,
+)
+
+
+_LISTNOTEOCCURRENCESRESPONSE = _descriptor.Descriptor(
+    name="ListNoteOccurrencesResponse",
+    full_name="grafeas.v1.ListNoteOccurrencesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="occurrences",
+            full_name="grafeas.v1.ListNoteOccurrencesResponse.occurrences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="grafeas.v1.ListNoteOccurrencesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2830,
+    serialized_end=2929,
+)
+
+
+_BATCHCREATENOTESREQUEST_NOTESENTRY = _descriptor.Descriptor(
+    name="NotesEntry",
+    full_name="grafeas.v1.BatchCreateNotesRequest.NotesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="grafeas.v1.BatchCreateNotesRequest.NotesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="grafeas.v1.BatchCreateNotesRequest.NotesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3038,
+    serialized_end=3100,
+)
+
+_BATCHCREATENOTESREQUEST = _descriptor.Descriptor(
+    name="BatchCreateNotesRequest",
+    full_name="grafeas.v1.BatchCreateNotesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="grafeas.v1.BatchCreateNotesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notes",
+            full_name="grafeas.v1.BatchCreateNotesRequest.notes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_BATCHCREATENOTESREQUEST_NOTESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2932,
+    serialized_end=3100,
+)
+
+
+_BATCHCREATENOTESRESPONSE = _descriptor.Descriptor(
+    name="BatchCreateNotesResponse",
+    full_name="grafeas.v1.BatchCreateNotesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="notes",
+            full_name="grafeas.v1.BatchCreateNotesResponse.notes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3102,
+    serialized_end=3161,
+)
+
+
+_BATCHCREATEOCCURRENCESREQUEST = _descriptor.Descriptor(
+    name="BatchCreateOccurrencesRequest",
+    full_name="grafeas.v1.BatchCreateOccurrencesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="grafeas.v1.BatchCreateOccurrencesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="occurrences",
+            full_name="grafeas.v1.BatchCreateOccurrencesRequest.occurrences",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3163,
+    serialized_end=3255,
+)
+
+
+_BATCHCREATEOCCURRENCESRESPONSE = _descriptor.Descriptor(
+    name="BatchCreateOccurrencesResponse",
+    full_name="grafeas.v1.BatchCreateOccurrencesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="occurrences",
+            full_name="grafeas.v1.BatchCreateOccurrencesResponse.occurrences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3257,
+    serialized_end=3334,
+)
+
+_OCCURRENCE.fields_by_name[
+    "kind"
+].enum_type = grafeas__v1_dot_proto_dot_common__pb2._NOTEKIND
+_OCCURRENCE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OCCURRENCE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OCCURRENCE.fields_by_name[
+    "vulnerability"
+].message_type = grafeas__v1_dot_proto_dot_vulnerability__pb2._VULNERABILITYOCCURRENCE
+_OCCURRENCE.fields_by_name[
+    "build"
+].message_type = grafeas__v1_dot_proto_dot_build__pb2._BUILDOCCURRENCE
+_OCCURRENCE.fields_by_name[
+    "image"
+].message_type = grafeas__v1_dot_proto_dot_image__pb2._IMAGEOCCURRENCE
+_OCCURRENCE.fields_by_name[
+    "package"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._PACKAGEOCCURRENCE
+_OCCURRENCE.fields_by_name[
+    "deployment"
+].message_type = grafeas__v1_dot_proto_dot_deployment__pb2._DEPLOYMENTOCCURRENCE
+_OCCURRENCE.fields_by_name[
+    "discovery"
+].message_type = grafeas__v1_dot_proto_dot_discovery__pb2._DISCOVERYOCCURRENCE
+_OCCURRENCE.fields_by_name[
+    "attestation"
+].message_type = grafeas__v1_dot_proto_dot_attestation__pb2._ATTESTATIONOCCURRENCE
+_OCCURRENCE.oneofs_by_name["details"].fields.append(
+    _OCCURRENCE.fields_by_name["vulnerability"]
+)
+_OCCURRENCE.fields_by_name[
+    "vulnerability"
+].containing_oneof = _OCCURRENCE.oneofs_by_name["details"]
+_OCCURRENCE.oneofs_by_name["details"].fields.append(_OCCURRENCE.fields_by_name["build"])
+_OCCURRENCE.fields_by_name["build"].containing_oneof = _OCCURRENCE.oneofs_by_name[
+    "details"
+]
+_OCCURRENCE.oneofs_by_name["details"].fields.append(_OCCURRENCE.fields_by_name["image"])
+_OCCURRENCE.fields_by_name["image"].containing_oneof = _OCCURRENCE.oneofs_by_name[
+    "details"
+]
+_OCCURRENCE.oneofs_by_name["details"].fields.append(
+    _OCCURRENCE.fields_by_name["package"]
+)
+_OCCURRENCE.fields_by_name["package"].containing_oneof = _OCCURRENCE.oneofs_by_name[
+    "details"
+]
+_OCCURRENCE.oneofs_by_name["details"].fields.append(
+    _OCCURRENCE.fields_by_name["deployment"]
+)
+_OCCURRENCE.fields_by_name["deployment"].containing_oneof = _OCCURRENCE.oneofs_by_name[
+    "details"
+]
+_OCCURRENCE.oneofs_by_name["details"].fields.append(
+    _OCCURRENCE.fields_by_name["discovery"]
+)
+_OCCURRENCE.fields_by_name["discovery"].containing_oneof = _OCCURRENCE.oneofs_by_name[
+    "details"
+]
+_OCCURRENCE.oneofs_by_name["details"].fields.append(
+    _OCCURRENCE.fields_by_name["attestation"]
+)
+_OCCURRENCE.fields_by_name["attestation"].containing_oneof = _OCCURRENCE.oneofs_by_name[
+    "details"
+]
+_NOTE.fields_by_name["kind"].enum_type = grafeas__v1_dot_proto_dot_common__pb2._NOTEKIND
+_NOTE.fields_by_name[
+    "related_url"
+].message_type = grafeas__v1_dot_proto_dot_common__pb2._RELATEDURL
+_NOTE.fields_by_name[
+    "expiration_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_NOTE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_NOTE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_NOTE.fields_by_name[
+    "vulnerability"
+].message_type = grafeas__v1_dot_proto_dot_vulnerability__pb2._VULNERABILITYNOTE
+_NOTE.fields_by_name[
+    "build"
+].message_type = grafeas__v1_dot_proto_dot_build__pb2._BUILDNOTE
+_NOTE.fields_by_name[
+    "image"
+].message_type = grafeas__v1_dot_proto_dot_image__pb2._IMAGENOTE
+_NOTE.fields_by_name[
+    "package"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._PACKAGENOTE
+_NOTE.fields_by_name[
+    "deployment"
+].message_type = grafeas__v1_dot_proto_dot_deployment__pb2._DEPLOYMENTNOTE
+_NOTE.fields_by_name[
+    "discovery"
+].message_type = grafeas__v1_dot_proto_dot_discovery__pb2._DISCOVERYNOTE
+_NOTE.fields_by_name[
+    "attestation"
+].message_type = grafeas__v1_dot_proto_dot_attestation__pb2._ATTESTATIONNOTE
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["vulnerability"])
+_NOTE.fields_by_name["vulnerability"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["build"])
+_NOTE.fields_by_name["build"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["image"])
+_NOTE.fields_by_name["image"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["package"])
+_NOTE.fields_by_name["package"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["deployment"])
+_NOTE.fields_by_name["deployment"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["discovery"])
+_NOTE.fields_by_name["discovery"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_NOTE.oneofs_by_name["type"].fields.append(_NOTE.fields_by_name["attestation"])
+_NOTE.fields_by_name["attestation"].containing_oneof = _NOTE.oneofs_by_name["type"]
+_LISTOCCURRENCESRESPONSE.fields_by_name["occurrences"].message_type = _OCCURRENCE
+_CREATEOCCURRENCEREQUEST.fields_by_name["occurrence"].message_type = _OCCURRENCE
+_UPDATEOCCURRENCEREQUEST.fields_by_name["occurrence"].message_type = _OCCURRENCE
+_UPDATEOCCURRENCEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTNOTESRESPONSE.fields_by_name["notes"].message_type = _NOTE
+_CREATENOTEREQUEST.fields_by_name["note"].message_type = _NOTE
+_UPDATENOTEREQUEST.fields_by_name["note"].message_type = _NOTE
+_UPDATENOTEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTNOTEOCCURRENCESRESPONSE.fields_by_name["occurrences"].message_type = _OCCURRENCE
+_BATCHCREATENOTESREQUEST_NOTESENTRY.fields_by_name["value"].message_type = _NOTE
+_BATCHCREATENOTESREQUEST_NOTESENTRY.containing_type = _BATCHCREATENOTESREQUEST
+_BATCHCREATENOTESREQUEST.fields_by_name[
+    "notes"
+].message_type = _BATCHCREATENOTESREQUEST_NOTESENTRY
+_BATCHCREATENOTESRESPONSE.fields_by_name["notes"].message_type = _NOTE
+_BATCHCREATEOCCURRENCESREQUEST.fields_by_name["occurrences"].message_type = _OCCURRENCE
+_BATCHCREATEOCCURRENCESRESPONSE.fields_by_name["occurrences"].message_type = _OCCURRENCE
+DESCRIPTOR.message_types_by_name["Occurrence"] = _OCCURRENCE
+DESCRIPTOR.message_types_by_name["Note"] = _NOTE
+DESCRIPTOR.message_types_by_name["GetOccurrenceRequest"] = _GETOCCURRENCEREQUEST
+DESCRIPTOR.message_types_by_name["ListOccurrencesRequest"] = _LISTOCCURRENCESREQUEST
+DESCRIPTOR.message_types_by_name["ListOccurrencesResponse"] = _LISTOCCURRENCESRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteOccurrenceRequest"] = _DELETEOCCURRENCEREQUEST
+DESCRIPTOR.message_types_by_name["CreateOccurrenceRequest"] = _CREATEOCCURRENCEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateOccurrenceRequest"] = _UPDATEOCCURRENCEREQUEST
+DESCRIPTOR.message_types_by_name["GetNoteRequest"] = _GETNOTEREQUEST
+DESCRIPTOR.message_types_by_name["GetOccurrenceNoteRequest"] = _GETOCCURRENCENOTEREQUEST
+DESCRIPTOR.message_types_by_name["ListNotesRequest"] = _LISTNOTESREQUEST
+DESCRIPTOR.message_types_by_name["ListNotesResponse"] = _LISTNOTESRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteNoteRequest"] = _DELETENOTEREQUEST
+DESCRIPTOR.message_types_by_name["CreateNoteRequest"] = _CREATENOTEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateNoteRequest"] = _UPDATENOTEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListNoteOccurrencesRequest"
+] = _LISTNOTEOCCURRENCESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListNoteOccurrencesResponse"
+] = _LISTNOTEOCCURRENCESRESPONSE
+DESCRIPTOR.message_types_by_name["BatchCreateNotesRequest"] = _BATCHCREATENOTESREQUEST
+DESCRIPTOR.message_types_by_name["BatchCreateNotesResponse"] = _BATCHCREATENOTESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchCreateOccurrencesRequest"
+] = _BATCHCREATEOCCURRENCESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchCreateOccurrencesResponse"
+] = _BATCHCREATEOCCURRENCESRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Occurrence = _reflection.GeneratedProtocolMessageType(
+    "Occurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OCCURRENCE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""An instance of an analysis type that has been found on a resource.
+  
+  
+  Attributes:
+      name:
+          Output only. The name of the occurrence in the form of
+          ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+      resource_uri:
+          Required. Immutable. A URI that represents the resource for
+          which the occurrence applies. For example,
+          ``https://gcr.io/project/image@sha256:123abc`` for a Docker
+          image.
+      note_name:
+          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.
+      kind:
+          Output only. This explicitly denotes which of the occurrence
+          details are specified. This field can be used as a filter in
+          list requests.
+      remediation:
+          A description of actions that can be taken to remedy the note.
+      create_time:
+          Output only. The time this occurrence was created.
+      update_time:
+          Output only. The time this occurrence was last updated.
+      details:
+          Required. Immutable. Describes the details of the note kind
+          found on this resource.
+      vulnerability:
+          Describes a security vulnerability.
+      build:
+          Describes a verifiable build.
+      image:
+          Describes how this resource derives from the basis in the
+          associated note.
+      package:
+          Describes the installation of a package on the linked
+          resource.
+      deployment:
+          Describes the deployment of an artifact on a runtime.
+      discovery:
+          Describes when a resource was discovered.
+      attestation:
+          Describes an attestation of an artifact.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Occurrence)
+    ),
+)
+_sym_db.RegisterMessage(Occurrence)
+
+Note = _reflection.GeneratedProtocolMessageType(
+    "Note",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NOTE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""A type of analysis that can be done for a resource.
+  
+  
+  Attributes:
+      name:
+          Output only. The name of the note in the form of
+          ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+      short_description:
+          A one sentence description of this note.
+      long_description:
+          A detailed description of this note.
+      kind:
+          Output only. The type of analysis. This field can be used as a
+          filter in list requests.
+      related_url:
+          URLs associated with this note.
+      expiration_time:
+          Time of expiration for this note. Empty if note does not
+          expire.
+      create_time:
+          Output only. The time this note was created. This field can be
+          used as a filter in list requests.
+      update_time:
+          Output only. The time this note was last updated. This field
+          can be used as a filter in list requests.
+      related_note_names:
+          Other notes related to this note.
+      type:
+          Required. Immutable. The type of analysis this note
+          represents.
+      vulnerability:
+          A note describing a package vulnerability.
+      build:
+          A note describing build provenance for a verifiable build.
+      image:
+          A note describing a base image.
+      package:
+          A note describing a package hosted by various package
+          managers.
+      deployment:
+          A note describing something that can be deployed.
+      discovery:
+          A note describing the initial analysis of a resource.
+      attestation:
+          A note describing an attestation role.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Note)
+    ),
+)
+_sym_db.RegisterMessage(Note)
+
+GetOccurrenceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetOccurrenceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETOCCURRENCEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to get an occurrence.
+  
+  
+  Attributes:
+      name:
+          The name of the occurrence in the form of
+          ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.GetOccurrenceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetOccurrenceRequest)
+
+ListOccurrencesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListOccurrencesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTOCCURRENCESREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to list occurrences.
+  
+  
+  Attributes:
+      parent:
+          The name of the project to list occurrences for in the form of
+          ``projects/[PROJECT_ID]``.
+      filter:
+          The filter expression.
+      page_size:
+          Number of occurrences to return in the list. Must be positive.
+          Max allowed page size is 1000. If not specified, page size
+          defaults to 20.
+      page_token:
+          Token to provide to skip to a particular spot in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ListOccurrencesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListOccurrencesRequest)
+
+ListOccurrencesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListOccurrencesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTOCCURRENCESRESPONSE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Response for listing occurrences.
+  
+  
+  Attributes:
+      occurrences:
+          The occurrences requested.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ListOccurrencesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListOccurrencesResponse)
+
+DeleteOccurrenceRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteOccurrenceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEOCCURRENCEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to delete a occurrence.
+  
+  
+  Attributes:
+      name:
+          The name of the occurrence in the form of
+          ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.DeleteOccurrenceRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteOccurrenceRequest)
+
+CreateOccurrenceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateOccurrenceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEOCCURRENCEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to create a new occurrence.
+  
+  
+  Attributes:
+      parent:
+          The name of the project in the form of
+          ``projects/[PROJECT_ID]``, under which the occurrence is to be
+          created.
+      occurrence:
+          The occurrence to create.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.CreateOccurrenceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateOccurrenceRequest)
+
+UpdateOccurrenceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateOccurrenceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEOCCURRENCEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to update an occurrence.
+  
+  
+  Attributes:
+      name:
+          The name of the occurrence in the form of
+          ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+      occurrence:
+          The updated occurrence.
+      update_mask:
+          The fields to update.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.UpdateOccurrenceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateOccurrenceRequest)
+
+GetNoteRequest = _reflection.GeneratedProtocolMessageType(
+    "GetNoteRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNOTEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to get a note.
+  
+  
+  Attributes:
+      name:
+          The name of the note in the form of
+          ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.GetNoteRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetNoteRequest)
+
+GetOccurrenceNoteRequest = _reflection.GeneratedProtocolMessageType(
+    "GetOccurrenceNoteRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETOCCURRENCENOTEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to get the note to which the specified occurrence is attached.
+  
+  
+  Attributes:
+      name:
+          The name of the occurrence in the form of
+          ``projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.GetOccurrenceNoteRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetOccurrenceNoteRequest)
+
+ListNotesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListNotesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTESREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to list notes.
+  
+  
+  Attributes:
+      parent:
+          The name of the project to list notes for in the form of
+          ``projects/[PROJECT_ID]``.
+      filter:
+          The filter expression.
+      page_size:
+          Number of notes to return in the list. Must be positive. Max
+          allowed page size is 1000. If not specified, page size
+          defaults to 20.
+      page_token:
+          Token to provide to skip to a particular spot in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ListNotesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListNotesRequest)
+
+ListNotesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListNotesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTESRESPONSE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Response for listing notes.
+  
+  
+  Attributes:
+      notes:
+          The notes requested.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ListNotesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListNotesResponse)
+
+DeleteNoteRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteNoteRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETENOTEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to delete a note.
+  
+  
+  Attributes:
+      name:
+          The name of the note in the form of
+          ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.DeleteNoteRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteNoteRequest)
+
+CreateNoteRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateNoteRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATENOTEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to create a new note.
+  
+  
+  Attributes:
+      parent:
+          The name of the project in the form of
+          ``projects/[PROJECT_ID]``, under which the note is to be
+          created.
+      note_id:
+          The ID to use for this note.
+      note:
+          The note to create.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.CreateNoteRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateNoteRequest)
+
+UpdateNoteRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateNoteRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATENOTEREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to update a note.
+  
+  
+  Attributes:
+      name:
+          The name of the note in the form of
+          ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+      note:
+          The updated note.
+      update_mask:
+          The fields to update.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.UpdateNoteRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateNoteRequest)
+
+ListNoteOccurrencesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListNoteOccurrencesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTEOCCURRENCESREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to list occurrences for a note.
+  
+  
+  Attributes:
+      name:
+          The name of the note to list occurrences for in the form of
+          ``projects/[PROVIDER_ID]/notes/[NOTE_ID]``.
+      filter:
+          The filter expression.
+      page_size:
+          Number of occurrences to return in the list.
+      page_token:
+          Token to provide to skip to a particular spot in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ListNoteOccurrencesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListNoteOccurrencesRequest)
+
+ListNoteOccurrencesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListNoteOccurrencesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTEOCCURRENCESRESPONSE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Response for listing occurrences for a note.
+  
+  
+  Attributes:
+      occurrences:
+          The occurrences attached to the specified note.
+      next_page_token:
+          Token to provide to skip to a particular spot in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ListNoteOccurrencesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListNoteOccurrencesResponse)
+
+BatchCreateNotesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateNotesRequest",
+    (_message.Message,),
+    dict(
+        NotesEntry=_reflection.GeneratedProtocolMessageType(
+            "NotesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BATCHCREATENOTESREQUEST_NOTESENTRY,
+                __module__="grafeas_v1.proto.grafeas_pb2"
+                # @@protoc_insertion_point(class_scope:grafeas.v1.BatchCreateNotesRequest.NotesEntry)
+            ),
+        ),
+        DESCRIPTOR=_BATCHCREATENOTESREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to create notes in batch.
+  
+  
+  Attributes:
+      parent:
+          The name of the project in the form of
+          ``projects/[PROJECT_ID]``, under which the notes are to be
+          created.
+      notes:
+          The notes to create. Max allowed length is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BatchCreateNotesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateNotesRequest)
+_sym_db.RegisterMessage(BatchCreateNotesRequest.NotesEntry)
+
+BatchCreateNotesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateNotesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATENOTESRESPONSE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Response for creating notes in batch.
+  
+  
+  Attributes:
+      notes:
+          The notes that were created.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BatchCreateNotesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateNotesResponse)
+
+BatchCreateOccurrencesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateOccurrencesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATEOCCURRENCESREQUEST,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Request to create occurrences in batch.
+  
+  
+  Attributes:
+      parent:
+          The name of the project in the form of
+          ``projects/[PROJECT_ID]``, under which the occurrences are to
+          be created.
+      occurrences:
+          The occurrences to create. Max allowed length is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BatchCreateOccurrencesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateOccurrencesRequest)
+
+BatchCreateOccurrencesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateOccurrencesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATEOCCURRENCESRESPONSE,
+        __module__="grafeas_v1.proto.grafeas_pb2",
+        __doc__="""Response for creating occurrences in batch.
+  
+  
+  Attributes:
+      occurrences:
+          The occurrences that were created.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BatchCreateOccurrencesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateOccurrencesResponse)
+
+
+DESCRIPTOR._options = None
+_BATCHCREATENOTESREQUEST_NOTESENTRY._options = None
+
+_GRAFEAS = _descriptor.ServiceDescriptor(
+    name="Grafeas",
+    full_name="grafeas.v1.Grafeas",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=3337,
+    serialized_end=5149,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GetOccurrence",
+            full_name="grafeas.v1.Grafeas.GetOccurrence",
+            index=0,
+            containing_service=None,
+            input_type=_GETOCCURRENCEREQUEST,
+            output_type=_OCCURRENCE,
+            serialized_options=_b(
+                "\202\323\344\223\002%\022#/v1/{name=projects/*/occurrences/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListOccurrences",
+            full_name="grafeas.v1.Grafeas.ListOccurrences",
+            index=1,
+            containing_service=None,
+            input_type=_LISTOCCURRENCESREQUEST,
+            output_type=_LISTOCCURRENCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002%\022#/v1/{parent=projects/*}/occurrences"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteOccurrence",
+            full_name="grafeas.v1.Grafeas.DeleteOccurrence",
+            index=2,
+            containing_service=None,
+            input_type=_DELETEOCCURRENCEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002%*#/v1/{name=projects/*/occurrences/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateOccurrence",
+            full_name="grafeas.v1.Grafeas.CreateOccurrence",
+            index=3,
+            containing_service=None,
+            input_type=_CREATEOCCURRENCEREQUEST,
+            output_type=_OCCURRENCE,
+            serialized_options=_b(
+                '\202\323\344\223\0021"#/v1/{parent=projects/*}/occurrences:\noccurrence'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchCreateOccurrences",
+            full_name="grafeas.v1.Grafeas.BatchCreateOccurrences",
+            index=4,
+            containing_service=None,
+            input_type=_BATCHCREATEOCCURRENCESREQUEST,
+            output_type=_BATCHCREATEOCCURRENCESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0024"//v1/{parent=projects/*}/occurrences:batchCreate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateOccurrence",
+            full_name="grafeas.v1.Grafeas.UpdateOccurrence",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATEOCCURRENCEREQUEST,
+            output_type=_OCCURRENCE,
+            serialized_options=_b(
+                "\202\323\344\223\00212#/v1/{name=projects/*/occurrences/*}:\noccurrence"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetOccurrenceNote",
+            full_name="grafeas.v1.Grafeas.GetOccurrenceNote",
+            index=6,
+            containing_service=None,
+            input_type=_GETOCCURRENCENOTEREQUEST,
+            output_type=_NOTE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1/{name=projects/*/occurrences/*}/notes"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetNote",
+            full_name="grafeas.v1.Grafeas.GetNote",
+            index=7,
+            containing_service=None,
+            input_type=_GETNOTEREQUEST,
+            output_type=_NOTE,
+            serialized_options=_b(
+                "\202\323\344\223\002\037\022\035/v1/{name=projects/*/notes/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListNotes",
+            full_name="grafeas.v1.Grafeas.ListNotes",
+            index=8,
+            containing_service=None,
+            input_type=_LISTNOTESREQUEST,
+            output_type=_LISTNOTESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\037\022\035/v1/{parent=projects/*}/notes"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteNote",
+            full_name="grafeas.v1.Grafeas.DeleteNote",
+            index=9,
+            containing_service=None,
+            input_type=_DELETENOTEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\037*\035/v1/{name=projects/*/notes/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateNote",
+            full_name="grafeas.v1.Grafeas.CreateNote",
+            index=10,
+            containing_service=None,
+            input_type=_CREATENOTEREQUEST,
+            output_type=_NOTE,
+            serialized_options=_b(
+                '\202\323\344\223\002%"\035/v1/{parent=projects/*}/notes:\004note'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchCreateNotes",
+            full_name="grafeas.v1.Grafeas.BatchCreateNotes",
+            index=11,
+            containing_service=None,
+            input_type=_BATCHCREATENOTESREQUEST,
+            output_type=_BATCHCREATENOTESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002.")/v1/{parent=projects/*}/notes:batchCreate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateNote",
+            full_name="grafeas.v1.Grafeas.UpdateNote",
+            index=12,
+            containing_service=None,
+            input_type=_UPDATENOTEREQUEST,
+            output_type=_NOTE,
+            serialized_options=_b(
+                "\202\323\344\223\002%2\035/v1/{name=projects/*/notes/*}:\004note"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListNoteOccurrences",
+            full_name="grafeas.v1.Grafeas.ListNoteOccurrences",
+            index=13,
+            containing_service=None,
+            input_type=_LISTNOTEOCCURRENCESREQUEST,
+            output_type=_LISTNOTEOCCURRENCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1/{name=projects/*/notes/*}/occurrences"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_GRAFEAS)
+
+DESCRIPTOR.services_by_name["Grafeas"] = _GRAFEAS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/grafeas_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/grafeas_pb2_grpc.py
new file mode 100644
index 000000000000..70057e822c51
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/grafeas_pb2_grpc.py
@@ -0,0 +1,302 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from grafeas.grafeas_v1.proto import (
+    grafeas_pb2 as grafeas__v1_dot_proto_dot_grafeas__pb2,
+)
+
+
+class GrafeasStub(object):
+    """[Grafeas](https://grafeas.io) API.
+
+  Retrieves analysis results of Cloud components such as Docker container
+  images.
+
+  Analysis results are stored as a series of occurrences. An `Occurrence`
+  contains information about a specific analysis instance on a resource. An
+  occurrence refers to a `Note`. A note contains details describing the
+  analysis and is generally stored in a separate project, called a `Provider`.
+  Multiple occurrences can refer to the same note.
+
+  For example, an SSL vulnerability could affect multiple images. In this case,
+  there would be one note for the vulnerability and an occurrence for each
+  image with the vulnerability referring to that note.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GetOccurrence = channel.unary_unary(
+            "/grafeas.v1.Grafeas/GetOccurrence",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.GetOccurrenceRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Occurrence.FromString,
+        )
+        self.ListOccurrences = channel.unary_unary(
+            "/grafeas.v1.Grafeas/ListOccurrences",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListOccurrencesRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListOccurrencesResponse.FromString,
+        )
+        self.DeleteOccurrence = channel.unary_unary(
+            "/grafeas.v1.Grafeas/DeleteOccurrence",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.DeleteOccurrenceRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateOccurrence = channel.unary_unary(
+            "/grafeas.v1.Grafeas/CreateOccurrence",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.CreateOccurrenceRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Occurrence.FromString,
+        )
+        self.BatchCreateOccurrences = channel.unary_unary(
+            "/grafeas.v1.Grafeas/BatchCreateOccurrences",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateOccurrencesRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateOccurrencesResponse.FromString,
+        )
+        self.UpdateOccurrence = channel.unary_unary(
+            "/grafeas.v1.Grafeas/UpdateOccurrence",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.UpdateOccurrenceRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Occurrence.FromString,
+        )
+        self.GetOccurrenceNote = channel.unary_unary(
+            "/grafeas.v1.Grafeas/GetOccurrenceNote",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.GetOccurrenceNoteRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.FromString,
+        )
+        self.GetNote = channel.unary_unary(
+            "/grafeas.v1.Grafeas/GetNote",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.GetNoteRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.FromString,
+        )
+        self.ListNotes = channel.unary_unary(
+            "/grafeas.v1.Grafeas/ListNotes",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNotesRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNotesResponse.FromString,
+        )
+        self.DeleteNote = channel.unary_unary(
+            "/grafeas.v1.Grafeas/DeleteNote",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.DeleteNoteRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateNote = channel.unary_unary(
+            "/grafeas.v1.Grafeas/CreateNote",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.CreateNoteRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.FromString,
+        )
+        self.BatchCreateNotes = channel.unary_unary(
+            "/grafeas.v1.Grafeas/BatchCreateNotes",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateNotesRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateNotesResponse.FromString,
+        )
+        self.UpdateNote = channel.unary_unary(
+            "/grafeas.v1.Grafeas/UpdateNote",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.UpdateNoteRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.FromString,
+        )
+        self.ListNoteOccurrences = channel.unary_unary(
+            "/grafeas.v1.Grafeas/ListNoteOccurrences",
+            request_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNoteOccurrencesRequest.SerializeToString,
+            response_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNoteOccurrencesResponse.FromString,
+        )
+
+
+class GrafeasServicer(object):
+    """[Grafeas](https://grafeas.io) API.
+
+  Retrieves analysis results of Cloud components such as Docker container
+  images.
+
+  Analysis results are stored as a series of occurrences. An `Occurrence`
+  contains information about a specific analysis instance on a resource. An
+  occurrence refers to a `Note`. A note contains details describing the
+  analysis and is generally stored in a separate project, called a `Provider`.
+  Multiple occurrences can refer to the same note.
+
+  For example, an SSL vulnerability could affect multiple images. In this case,
+  there would be one note for the vulnerability and an occurrence for each
+  image with the vulnerability referring to that note.
+  """
+
+    def GetOccurrence(self, request, context):
+        """Gets the specified occurrence.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListOccurrences(self, request, context):
+        """Lists occurrences for the specified project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteOccurrence(self, request, context):
+        """Deletes the specified occurrence. For example, use this method to delete an
+    occurrence when the occurrence is no longer applicable for the given
+    resource.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateOccurrence(self, request, context):
+        """Creates a new occurrence.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchCreateOccurrences(self, request, context):
+        """Creates new occurrences in batch.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateOccurrence(self, request, context):
+        """Updates the specified occurrence.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetOccurrenceNote(self, request, context):
+        """Gets the note attached to the specified occurrence. Consumer projects can
+    use this method to get a note that belongs to a provider project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetNote(self, request, context):
+        """Gets the specified note.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListNotes(self, request, context):
+        """Lists notes for the specified project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteNote(self, request, context):
+        """Deletes the specified note.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateNote(self, request, context):
+        """Creates a new note.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchCreateNotes(self, request, context):
+        """Creates new notes in batch.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateNote(self, request, context):
+        """Updates the specified note.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListNoteOccurrences(self, request, context):
+        """Lists occurrences referencing the specified note. Provider projects can use
+    this method to get all occurrences across consumer projects referencing the
+    specified note.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_GrafeasServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GetOccurrence": grpc.unary_unary_rpc_method_handler(
+            servicer.GetOccurrence,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.GetOccurrenceRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Occurrence.SerializeToString,
+        ),
+        "ListOccurrences": grpc.unary_unary_rpc_method_handler(
+            servicer.ListOccurrences,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListOccurrencesRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListOccurrencesResponse.SerializeToString,
+        ),
+        "DeleteOccurrence": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteOccurrence,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.DeleteOccurrenceRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateOccurrence": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateOccurrence,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.CreateOccurrenceRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Occurrence.SerializeToString,
+        ),
+        "BatchCreateOccurrences": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchCreateOccurrences,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateOccurrencesRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateOccurrencesResponse.SerializeToString,
+        ),
+        "UpdateOccurrence": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateOccurrence,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.UpdateOccurrenceRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Occurrence.SerializeToString,
+        ),
+        "GetOccurrenceNote": grpc.unary_unary_rpc_method_handler(
+            servicer.GetOccurrenceNote,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.GetOccurrenceNoteRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.SerializeToString,
+        ),
+        "GetNote": grpc.unary_unary_rpc_method_handler(
+            servicer.GetNote,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.GetNoteRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.SerializeToString,
+        ),
+        "ListNotes": grpc.unary_unary_rpc_method_handler(
+            servicer.ListNotes,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNotesRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNotesResponse.SerializeToString,
+        ),
+        "DeleteNote": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteNote,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.DeleteNoteRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateNote": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateNote,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.CreateNoteRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.SerializeToString,
+        ),
+        "BatchCreateNotes": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchCreateNotes,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateNotesRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.BatchCreateNotesResponse.SerializeToString,
+        ),
+        "UpdateNote": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateNote,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.UpdateNoteRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.Note.SerializeToString,
+        ),
+        "ListNoteOccurrences": grpc.unary_unary_rpc_method_handler(
+            servicer.ListNoteOccurrences,
+            request_deserializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNoteOccurrencesRequest.FromString,
+            response_serializer=grafeas__v1_dot_proto_dot_grafeas__pb2.ListNoteOccurrencesResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "grafeas.v1.Grafeas", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/grafeas/grafeas/grafeas_v1/proto/image.proto b/grafeas/grafeas/grafeas_v1/proto/image.proto
new file mode 100644
index 000000000000..9ac162cec22f
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/image.proto
@@ -0,0 +1,83 @@
+// 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;
+
+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";
+
+// Layer holds metadata specific to a layer of a Docker image.
+message Layer {
+  // Required. The recovered Dockerfile directive used to construct this layer.
+  // See https://docs.docker.com/engine/reference/builder/ for more information.
+  string 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 {
+  // Required. The layer ID of the final layer in the Docker image's v1
+  // representation.
+  string v1_name = 1;
+
+  // 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:
+  //   [bottom] := v2_blob[bottom]
+  //   [N] := sha256(v2_blob[N] + " " + v2_name[N+1])
+  // Only the name of the final blob is kept.
+  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 <Basis.resource_url>
+// Or an equivalent reference, e.g., a tag of the resource_url.
+message ImageNote {
+  // Required. Immutable. The resource_url for the resource representing the
+  // basis of associated occurrence images.
+  string resource_url = 1;
+
+  // Required. Immutable. The fingerprint of the base image.
+  Fingerprint fingerprint = 2;
+}
+
+// Details of the derived image portion of the DockerImage relationship. This
+// image would be produced from a Dockerfile with FROM <DockerImage.Basis in
+// attached Note>.
+message ImageOccurrence {
+  // Required. 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.
+  int32 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/grafeas/grafeas/grafeas_v1/proto/image_pb2.py b/grafeas/grafeas/grafeas_v1/proto/image_pb2.py
new file mode 100644
index 000000000000..75312ffb9931
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/image_pb2.py
@@ -0,0 +1,426 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/image.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/image.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n\x1cgrafeas_v1/proto/image.proto\x12\ngrafeas.v1"-\n\x05Layer\x12\x11\n\tdirective\x18\x01 \x01(\t\x12\x11\n\targuments\x18\x02 \x01(\t"@\n\x0b\x46ingerprint\x12\x0f\n\x07v1_name\x18\x01 \x01(\t\x12\x0f\n\x07v2_blob\x18\x02 \x03(\t\x12\x0f\n\x07v2_name\x18\x03 \x01(\t"O\n\tImageNote\x12\x14\n\x0cresource_url\x18\x01 \x01(\t\x12,\n\x0b\x66ingerprint\x18\x02 \x01(\x0b\x32\x17.grafeas.v1.Fingerprint"\x93\x01\n\x0fImageOccurrence\x12,\n\x0b\x66ingerprint\x18\x01 \x01(\x0b\x32\x17.grafeas.v1.Fingerprint\x12\x10\n\x08\x64istance\x18\x02 \x01(\x05\x12%\n\nlayer_info\x18\x03 \x03(\x0b\x32\x11.grafeas.v1.Layer\x12\x19\n\x11\x62\x61se_resource_url\x18\x04 \x01(\tBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+)
+
+
+_LAYER = _descriptor.Descriptor(
+    name="Layer",
+    full_name="grafeas.v1.Layer",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="directive",
+            full_name="grafeas.v1.Layer.directive",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="arguments",
+            full_name="grafeas.v1.Layer.arguments",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=44,
+    serialized_end=89,
+)
+
+
+_FINGERPRINT = _descriptor.Descriptor(
+    name="Fingerprint",
+    full_name="grafeas.v1.Fingerprint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="v1_name",
+            full_name="grafeas.v1.Fingerprint.v1_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="v2_blob",
+            full_name="grafeas.v1.Fingerprint.v2_blob",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="v2_name",
+            full_name="grafeas.v1.Fingerprint.v2_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=91,
+    serialized_end=155,
+)
+
+
+_IMAGENOTE = _descriptor.Descriptor(
+    name="ImageNote",
+    full_name="grafeas.v1.ImageNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_url",
+            full_name="grafeas.v1.ImageNote.resource_url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fingerprint",
+            full_name="grafeas.v1.ImageNote.fingerprint",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=157,
+    serialized_end=236,
+)
+
+
+_IMAGEOCCURRENCE = _descriptor.Descriptor(
+    name="ImageOccurrence",
+    full_name="grafeas.v1.ImageOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fingerprint",
+            full_name="grafeas.v1.ImageOccurrence.fingerprint",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distance",
+            full_name="grafeas.v1.ImageOccurrence.distance",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="layer_info",
+            full_name="grafeas.v1.ImageOccurrence.layer_info",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="base_resource_url",
+            full_name="grafeas.v1.ImageOccurrence.base_resource_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=239,
+    serialized_end=386,
+)
+
+_IMAGENOTE.fields_by_name["fingerprint"].message_type = _FINGERPRINT
+_IMAGEOCCURRENCE.fields_by_name["fingerprint"].message_type = _FINGERPRINT
+_IMAGEOCCURRENCE.fields_by_name["layer_info"].message_type = _LAYER
+DESCRIPTOR.message_types_by_name["Layer"] = _LAYER
+DESCRIPTOR.message_types_by_name["Fingerprint"] = _FINGERPRINT
+DESCRIPTOR.message_types_by_name["ImageNote"] = _IMAGENOTE
+DESCRIPTOR.message_types_by_name["ImageOccurrence"] = _IMAGEOCCURRENCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Layer = _reflection.GeneratedProtocolMessageType(
+    "Layer",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LAYER,
+        __module__="grafeas_v1.proto.image_pb2",
+        __doc__="""Layer holds metadata specific to a layer of a Docker image.
+  
+  
+  Attributes:
+      directive:
+          Required. The recovered Dockerfile directive used to construct
+          this layer. See
+          https://docs.docker.com/engine/reference/builder/ for more
+          information.
+      arguments:
+          The recovered arguments to the Dockerfile directive.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Layer)
+    ),
+)
+_sym_db.RegisterMessage(Layer)
+
+Fingerprint = _reflection.GeneratedProtocolMessageType(
+    "Fingerprint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINGERPRINT,
+        __module__="grafeas_v1.proto.image_pb2",
+        __doc__="""A set of properties that uniquely identify a given Docker image.
+  
+  
+  Attributes:
+      v1_name:
+          Required. The layer ID of the final layer in the Docker
+          image's v1 representation.
+      v2_blob:
+          Required. The ordered list of v2 blobs that represent a given
+          image.
+      v2_name:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Fingerprint)
+    ),
+)
+_sym_db.RegisterMessage(Fingerprint)
+
+ImageNote = _reflection.GeneratedProtocolMessageType(
+    "ImageNote",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGENOTE,
+        __module__="grafeas_v1.proto.image_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      resource_url:
+          Required. Immutable. The resource\_url for the resource
+          representing the basis of associated occurrence images.
+      fingerprint:
+          Required. Immutable. The fingerprint of the base image.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ImageNote)
+    ),
+)
+_sym_db.RegisterMessage(ImageNote)
+
+ImageOccurrence = _reflection.GeneratedProtocolMessageType(
+    "ImageOccurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEOCCURRENCE,
+        __module__="grafeas_v1.proto.image_pb2",
+        __doc__="""Details of the derived image portion of the DockerImage relationship.
+  This image would be produced from a Dockerfile with FROM .
+  
+  
+  Attributes:
+      fingerprint:
+          Required. The fingerprint of the derived image.
+      distance:
+          Output only. The number of layers by which this image differs
+          from the associated image basis.
+      layer_info:
+          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.
+      base_resource_url:
+          Output only. This contains the base image URL for the derived
+          image occurrence.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ImageOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(ImageOccurrence)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/image_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/image_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/image_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/package.proto b/grafeas/grafeas/grafeas_v1/proto/package.proto
new file mode 100644
index 000000000000..b04686d9fc33
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/package.proto
@@ -0,0 +1,124 @@
+// 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;
+
+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";
+
+// Instruction set architectures supported by various package managers.
+enum Architecture {
+  // Unknown architecture.
+  ARCHITECTURE_UNSPECIFIED = 0;
+  // X86 architecture.
+  X86 = 1;
+  // X64 architecture.
+  X64 = 2;
+}
+
+// This represents a particular channel of distribution for a given package.
+// E.g., Debian's jessie-backports dpkg mirror.
+message Distribution {
+  // Required. 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.
+  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 = 5;
+
+  // The distribution channel-specific description of this package.
+  string description = 6;
+}
+
+// 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 {
+  // Required. 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.
+  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 PackageNote {
+  // Required. Immutable. The name of the package.
+  string name = 1;
+
+  // The various channels by which a package is distributed.
+  repeated Distribution distribution = 10;
+}
+
+// Details on how a particular software package was installed on a system.
+message PackageOccurrence {
+  // Output only. The name of the installed package.
+  string name = 1;
+
+  // Required. All of the places within the filesystem versions of this package
+  // have been found.
+  repeated Location location = 2;
+}
+
+// Version contains structured information about the version of a package.
+message Version {
+  // Used to correct mistakes in the version numbering scheme.
+  int32 epoch = 1;
+
+  // 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;
+
+  // Whether this is an ordinary package version or a sentinel MIN/MAX version.
+  enum VersionKind {
+    // Unknown.
+    VERSION_KIND_UNSPECIFIED = 0;
+    // A standard package version.
+    NORMAL = 1;
+    // A special version representing negative infinity.
+    MINIMUM = 2;
+    // A special version representing positive infinity.
+    MAXIMUM = 3;
+  };
+
+  // Required. Distinguishes between sentinel MIN/MAX versions and normal
+  // versions.
+  VersionKind kind = 4;
+
+  // Human readable version string. This string is of the form
+  // <epoch>:<name>-<revision> and is only set when kind is NORMAL.
+  string full_name = 5;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/package_pb2.py b/grafeas/grafeas/grafeas_v1/proto/package_pb2.py
new file mode 100644
index 000000000000..dbcb619010c9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/package_pb2.py
@@ -0,0 +1,671 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/package.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/package.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n\x1egrafeas_v1/proto/package.proto\x12\ngrafeas.v1"\xb2\x01\n\x0c\x44istribution\x12\x0f\n\x07\x63pe_uri\x18\x01 \x01(\t\x12.\n\x0c\x61rchitecture\x18\x02 \x01(\x0e\x32\x18.grafeas.v1.Architecture\x12+\n\x0elatest_version\x18\x03 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x12\n\nmaintainer\x18\x04 \x01(\t\x12\x0b\n\x03url\x18\x05 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x06 \x01(\t"O\n\x08Location\x12\x0f\n\x07\x63pe_uri\x18\x01 \x01(\t\x12$\n\x07version\x18\x02 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x0c\n\x04path\x18\x03 \x01(\t"K\n\x0bPackageNote\x12\x0c\n\x04name\x18\x01 \x01(\t\x12.\n\x0c\x64istribution\x18\n \x03(\x0b\x32\x18.grafeas.v1.Distribution"I\n\x11PackageOccurrence\x12\x0c\n\x04name\x18\x01 \x01(\t\x12&\n\x08location\x18\x02 \x03(\x0b\x32\x14.grafeas.v1.Location"\xcd\x01\n\x07Version\x12\r\n\x05\x65poch\x18\x01 \x01(\x05\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x10\n\x08revision\x18\x03 \x01(\t\x12-\n\x04kind\x18\x04 \x01(\x0e\x32\x1f.grafeas.v1.Version.VersionKind\x12\x11\n\tfull_name\x18\x05 \x01(\t"Q\n\x0bVersionKind\x12\x1c\n\x18VERSION_KIND_UNSPECIFIED\x10\x00\x12\n\n\x06NORMAL\x10\x01\x12\x0b\n\x07MINIMUM\x10\x02\x12\x0b\n\x07MAXIMUM\x10\x03*>\n\x0c\x41rchitecture\x12\x1c\n\x18\x41RCHITECTURE_UNSPECIFIED\x10\x00\x12\x07\n\x03X86\x10\x01\x12\x07\n\x03X64\x10\x02\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+)
+
+_ARCHITECTURE = _descriptor.EnumDescriptor(
+    name="Architecture",
+    full_name="grafeas.v1.Architecture",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ARCHITECTURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="X86", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="X64", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=668,
+    serialized_end=730,
+)
+_sym_db.RegisterEnumDescriptor(_ARCHITECTURE)
+
+Architecture = enum_type_wrapper.EnumTypeWrapper(_ARCHITECTURE)
+ARCHITECTURE_UNSPECIFIED = 0
+X86 = 1
+X64 = 2
+
+
+_VERSION_VERSIONKIND = _descriptor.EnumDescriptor(
+    name="VersionKind",
+    full_name="grafeas.v1.Version.VersionKind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VERSION_KIND_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NORMAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MINIMUM", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MAXIMUM", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=585,
+    serialized_end=666,
+)
+_sym_db.RegisterEnumDescriptor(_VERSION_VERSIONKIND)
+
+
+_DISTRIBUTION = _descriptor.Descriptor(
+    name="Distribution",
+    full_name="grafeas.v1.Distribution",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cpe_uri",
+            full_name="grafeas.v1.Distribution.cpe_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="architecture",
+            full_name="grafeas.v1.Distribution.architecture",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="latest_version",
+            full_name="grafeas.v1.Distribution.latest_version",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="maintainer",
+            full_name="grafeas.v1.Distribution.maintainer",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="grafeas.v1.Distribution.url",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="grafeas.v1.Distribution.description",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=47,
+    serialized_end=225,
+)
+
+
+_LOCATION = _descriptor.Descriptor(
+    name="Location",
+    full_name="grafeas.v1.Location",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cpe_uri",
+            full_name="grafeas.v1.Location.cpe_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="grafeas.v1.Location.version",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="grafeas.v1.Location.path",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=227,
+    serialized_end=306,
+)
+
+
+_PACKAGENOTE = _descriptor.Descriptor(
+    name="PackageNote",
+    full_name="grafeas.v1.PackageNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.PackageNote.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distribution",
+            full_name="grafeas.v1.PackageNote.distribution",
+            index=1,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=308,
+    serialized_end=383,
+)
+
+
+_PACKAGEOCCURRENCE = _descriptor.Descriptor(
+    name="PackageOccurrence",
+    full_name="grafeas.v1.PackageOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.PackageOccurrence.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="grafeas.v1.PackageOccurrence.location",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=385,
+    serialized_end=458,
+)
+
+
+_VERSION = _descriptor.Descriptor(
+    name="Version",
+    full_name="grafeas.v1.Version",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="epoch",
+            full_name="grafeas.v1.Version.epoch",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.Version.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="revision",
+            full_name="grafeas.v1.Version.revision",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="grafeas.v1.Version.kind",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_name",
+            full_name="grafeas.v1.Version.full_name",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_VERSION_VERSIONKIND],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=461,
+    serialized_end=666,
+)
+
+_DISTRIBUTION.fields_by_name["architecture"].enum_type = _ARCHITECTURE
+_DISTRIBUTION.fields_by_name["latest_version"].message_type = _VERSION
+_LOCATION.fields_by_name["version"].message_type = _VERSION
+_PACKAGENOTE.fields_by_name["distribution"].message_type = _DISTRIBUTION
+_PACKAGEOCCURRENCE.fields_by_name["location"].message_type = _LOCATION
+_VERSION.fields_by_name["kind"].enum_type = _VERSION_VERSIONKIND
+_VERSION_VERSIONKIND.containing_type = _VERSION
+DESCRIPTOR.message_types_by_name["Distribution"] = _DISTRIBUTION
+DESCRIPTOR.message_types_by_name["Location"] = _LOCATION
+DESCRIPTOR.message_types_by_name["PackageNote"] = _PACKAGENOTE
+DESCRIPTOR.message_types_by_name["PackageOccurrence"] = _PACKAGEOCCURRENCE
+DESCRIPTOR.message_types_by_name["Version"] = _VERSION
+DESCRIPTOR.enum_types_by_name["Architecture"] = _ARCHITECTURE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Distribution = _reflection.GeneratedProtocolMessageType(
+    "Distribution",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DISTRIBUTION,
+        __module__="grafeas_v1.proto.package_pb2",
+        __doc__="""This represents a particular channel of distribution for a given
+  package. E.g., Debian's jessie-backports dpkg mirror.
+  
+  
+  Attributes:
+      cpe_uri:
+          Required. The cpe\_uri in `CPE format
+          <https://cpe.mitre.org/specification/>`__ denoting the package
+          manager version distributing a package.
+      architecture:
+          The CPU architecture for which packages in this distribution
+          channel were built.
+      latest_version:
+          The latest available version of this package in this
+          distribution channel.
+      maintainer:
+          A freeform string denoting the maintainer of this package.
+      url:
+          The distribution channel-specific homepage for this package.
+      description:
+          The distribution channel-specific description of this package.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Distribution)
+    ),
+)
+_sym_db.RegisterMessage(Distribution)
+
+Location = _reflection.GeneratedProtocolMessageType(
+    "Location",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATION,
+        __module__="grafeas_v1.proto.package_pb2",
+        __doc__="""An occurrence of a particular package installation found within a
+  system's filesystem. E.g., glibc was found in ``/var/lib/dpkg/status``.
+  
+  
+  Attributes:
+      cpe_uri:
+          Required. The CPE URI in `CPE format
+          <https://cpe.mitre.org/specification/>`__ denoting the package
+          manager version distributing a package.
+      version:
+          The version installed at this location.
+      path:
+          The path from which we gathered that this package/version is
+          installed.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Location)
+    ),
+)
+_sym_db.RegisterMessage(Location)
+
+PackageNote = _reflection.GeneratedProtocolMessageType(
+    "PackageNote",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PACKAGENOTE,
+        __module__="grafeas_v1.proto.package_pb2",
+        __doc__="""This represents a particular package that is distributed over various
+  channels. E.g., glibc (aka libc6) is distributed by many, at various
+  versions.
+  
+  
+  Attributes:
+      name:
+          Required. Immutable. The name of the package.
+      distribution:
+          The various channels by which a package is distributed.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.PackageNote)
+    ),
+)
+_sym_db.RegisterMessage(PackageNote)
+
+PackageOccurrence = _reflection.GeneratedProtocolMessageType(
+    "PackageOccurrence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PACKAGEOCCURRENCE,
+        __module__="grafeas_v1.proto.package_pb2",
+        __doc__="""Details on how a particular software package was installed on a system.
+  
+  
+  Attributes:
+      name:
+          Output only. The name of the installed package.
+      location:
+          Required. All of the places within the filesystem versions of
+          this package have been found.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.PackageOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(PackageOccurrence)
+
+Version = _reflection.GeneratedProtocolMessageType(
+    "Version",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERSION,
+        __module__="grafeas_v1.proto.package_pb2",
+        __doc__="""Version contains structured information about the version of a package.
+  
+  
+  Attributes:
+      epoch:
+          Used to correct mistakes in the version numbering scheme.
+      name:
+          Required only when version kind is NORMAL. The main part of
+          the version name.
+      revision:
+          The iteration of the package build from the above version.
+      kind:
+          Required. Distinguishes between sentinel MIN/MAX versions and
+          normal versions.
+      full_name:
+          Human readable version string. This string is of the form :-
+          and is only set when kind is NORMAL.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Version)
+    ),
+)
+_sym_db.RegisterMessage(Version)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/package_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/package_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/package_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/provenance.proto b/grafeas/grafeas/grafeas_v1/proto/provenance.proto
new file mode 100644
index 000000000000..06b109785f8a
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/provenance.proto
@@ -0,0 +1,265 @@
+// 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";
+
+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";
+
+// Provenance of a build. Contains all information needed to verify the full
+// details about the build from source to completion.
+message BuildProvenance {
+  // Required. Unique identifier of the build.
+  string id = 1;
+
+  // ID of the project.
+  string project_id = 2;
+
+  // Commands requested by the build.
+  repeated Command commands = 3;
+
+  // Output of the build.
+  repeated Artifact built_artifacts = 4;
+
+  // Time at which the build was created.
+  google.protobuf.Timestamp create_time = 5;
+
+  // Time at which execution of the build was started.
+  google.protobuf.Timestamp start_time = 6;
+
+  // Time at which execution of the build was finished.
+  google.protobuf.Timestamp end_time = 7;
+
+  // 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 = 8;
+
+  // URI where any logs for this provenance were written.
+  string logs_uri = 9;
+
+  // Details of the Source input to the build.
+  Source source_provenance = 10;
+
+  // Trigger identifier if the build was triggered automatically; empty if not.
+  string trigger_id = 11;
+
+  // Special options applied to this build. This is a catch-all field where
+  // build providers can enter any desired additional details.
+  map<string, string> build_options = 12;
+
+  // Version string of the builder at the time this build was executed.
+  string builder_version = 13;
+}
+
+// Source describes the location of the source used for the build.
+message Source {
+  // If provided, the input binary artifacts for the build came from this
+  // location.
+  string artifact_storage_source_uri = 1;
+
+  // 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<string, FileHashes> file_hashes = 2;
+
+  // If provided, the source code used for the build came from this location.
+  SourceContext context = 3;
+
+  // 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 = 4;
+}
+
+// Container message for hashes of byte content of files, used in source
+// messages to verify integrity of source input to the build.
+message FileHashes {
+  // Required. Collection of file hashes.
+  repeated Hash file_hash = 1;
+}
+
+// Container message for hash values.
+message Hash {
+  // Required. The type of hash that was performed, e.g. "SHA-256".
+  string type = 1;
+  // Required. The hash value.
+  bytes value = 2;
+}
+
+// Command describes a step performed as part of the build pipeline.
+message Command {
+  // 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.
+  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 {
+  // Hash or checksum value of a binary, or Docker Registry 2.0 digest of a
+  // container.
+  string checksum = 1;
+
+  // Artifact ID, if any; for container images, this will be a URL by digest
+  // like `gcr.io/projectID/imagename@sha256:123456`.
+  string id = 2;
+
+  // 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 = 3;
+}
+
+// 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<string, string> 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;
+
+  // 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/grafeas/grafeas/grafeas_v1/proto/provenance_pb2.py b/grafeas/grafeas/grafeas_v1/proto/provenance_pb2.py
new file mode 100644
index 000000000000..412c42c8db2f
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/provenance_pb2.py
@@ -0,0 +1,1890 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/provenance.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/provenance.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n!grafeas_v1/proto/provenance.proto\x12\ngrafeas.v1\x1a\x1fgoogle/protobuf/timestamp.proto"\x90\x04\n\x0f\x42uildProvenance\x12\n\n\x02id\x18\x01 \x01(\t\x12\x12\n\nproject_id\x18\x02 \x01(\t\x12%\n\x08\x63ommands\x18\x03 \x03(\x0b\x32\x13.grafeas.v1.Command\x12-\n\x0f\x62uilt_artifacts\x18\x04 \x03(\x0b\x32\x14.grafeas.v1.Artifact\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nstart_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07\x63reator\x18\x08 \x01(\t\x12\x10\n\x08logs_uri\x18\t \x01(\t\x12-\n\x11source_provenance\x18\n \x01(\x0b\x32\x12.grafeas.v1.Source\x12\x12\n\ntrigger_id\x18\x0b \x01(\t\x12\x44\n\rbuild_options\x18\x0c \x03(\x0b\x32-.grafeas.v1.BuildProvenance.BuildOptionsEntry\x12\x17\n\x0f\x62uilder_version\x18\r \x01(\t\x1a\x33\n\x11\x42uildOptionsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x95\x02\n\x06Source\x12#\n\x1b\x61rtifact_storage_source_uri\x18\x01 \x01(\t\x12\x37\n\x0b\x66ile_hashes\x18\x02 \x03(\x0b\x32".grafeas.v1.Source.FileHashesEntry\x12*\n\x07\x63ontext\x18\x03 \x01(\x0b\x32\x19.grafeas.v1.SourceContext\x12\x36\n\x13\x61\x64\x64itional_contexts\x18\x04 \x03(\x0b\x32\x19.grafeas.v1.SourceContext\x1aI\n\x0f\x46ileHashesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.grafeas.v1.FileHashes:\x02\x38\x01"1\n\nFileHashes\x12#\n\tfile_hash\x18\x01 \x03(\x0b\x32\x10.grafeas.v1.Hash"#\n\x04Hash\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c"]\n\x07\x43ommand\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03\x65nv\x18\x02 \x03(\t\x12\x0c\n\x04\x61rgs\x18\x03 \x03(\t\x12\x0b\n\x03\x64ir\x18\x04 \x01(\t\x12\n\n\x02id\x18\x05 \x01(\t\x12\x10\n\x08wait_for\x18\x06 \x03(\t"7\n\x08\x41rtifact\x12\x10\n\x08\x63hecksum\x18\x01 \x01(\t\x12\n\n\x02id\x18\x02 \x01(\t\x12\r\n\x05names\x18\x03 \x03(\t"\x9a\x02\n\rSourceContext\x12\x38\n\ncloud_repo\x18\x01 \x01(\x0b\x32".grafeas.v1.CloudRepoSourceContextH\x00\x12\x31\n\x06gerrit\x18\x02 \x01(\x0b\x32\x1f.grafeas.v1.GerritSourceContextH\x00\x12+\n\x03git\x18\x03 \x01(\x0b\x32\x1c.grafeas.v1.GitSourceContextH\x00\x12\x35\n\x06labels\x18\x04 \x03(\x0b\x32%.grafeas.v1.SourceContext.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07\x63ontext"\x8a\x01\n\x0c\x41liasContext\x12+\n\x04kind\x18\x01 \x01(\x0e\x32\x1d.grafeas.v1.AliasContext.Kind\x12\x0c\n\x04name\x18\x02 \x01(\t"?\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\t\n\x05\x46IXED\x10\x01\x12\x0b\n\x07MOVABLE\x10\x02\x12\t\n\x05OTHER\x10\x04"\x93\x01\n\x16\x43loudRepoSourceContext\x12#\n\x07repo_id\x18\x01 \x01(\x0b\x32\x12.grafeas.v1.RepoId\x12\x15\n\x0brevision_id\x18\x02 \x01(\tH\x00\x12\x31\n\ralias_context\x18\x03 \x01(\x0b\x32\x18.grafeas.v1.AliasContextH\x00\x42\n\n\x08revision"\x95\x01\n\x13GerritSourceContext\x12\x10\n\x08host_uri\x18\x01 \x01(\t\x12\x16\n\x0egerrit_project\x18\x02 \x01(\t\x12\x15\n\x0brevision_id\x18\x03 \x01(\tH\x00\x12\x31\n\ralias_context\x18\x04 \x01(\x0b\x32\x18.grafeas.v1.AliasContextH\x00\x42\n\n\x08revision"4\n\x10GitSourceContext\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x13\n\x0brevision_id\x18\x02 \x01(\t"S\n\x06RepoId\x12\x34\n\x0fproject_repo_id\x18\x01 \x01(\x0b\x32\x19.grafeas.v1.ProjectRepoIdH\x00\x12\r\n\x03uid\x18\x02 \x01(\tH\x00\x42\x04\n\x02id"6\n\rProjectRepoId\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x11\n\trepo_name\x18\x02 \x01(\tBQ\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR],
+)
+
+
+_ALIASCONTEXT_KIND = _descriptor.EnumDescriptor(
+    name="Kind",
+    full_name="grafeas.v1.AliasContext.Kind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="KIND_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FIXED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOVABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER", index=3, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1494,
+    serialized_end=1557,
+)
+_sym_db.RegisterEnumDescriptor(_ALIASCONTEXT_KIND)
+
+
+_BUILDPROVENANCE_BUILDOPTIONSENTRY = _descriptor.Descriptor(
+    name="BuildOptionsEntry",
+    full_name="grafeas.v1.BuildProvenance.BuildOptionsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="grafeas.v1.BuildProvenance.BuildOptionsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="grafeas.v1.BuildProvenance.BuildOptionsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=560,
+    serialized_end=611,
+)
+
+_BUILDPROVENANCE = _descriptor.Descriptor(
+    name="BuildProvenance",
+    full_name="grafeas.v1.BuildProvenance",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="grafeas.v1.BuildProvenance.id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="grafeas.v1.BuildProvenance.project_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commands",
+            full_name="grafeas.v1.BuildProvenance.commands",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="built_artifacts",
+            full_name="grafeas.v1.BuildProvenance.built_artifacts",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="grafeas.v1.BuildProvenance.create_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="grafeas.v1.BuildProvenance.start_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="grafeas.v1.BuildProvenance.end_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="creator",
+            full_name="grafeas.v1.BuildProvenance.creator",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logs_uri",
+            full_name="grafeas.v1.BuildProvenance.logs_uri",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_provenance",
+            full_name="grafeas.v1.BuildProvenance.source_provenance",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trigger_id",
+            full_name="grafeas.v1.BuildProvenance.trigger_id",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="build_options",
+            full_name="grafeas.v1.BuildProvenance.build_options",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="builder_version",
+            full_name="grafeas.v1.BuildProvenance.builder_version",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_BUILDPROVENANCE_BUILDOPTIONSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=83,
+    serialized_end=611,
+)
+
+
+_SOURCE_FILEHASHESENTRY = _descriptor.Descriptor(
+    name="FileHashesEntry",
+    full_name="grafeas.v1.Source.FileHashesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="grafeas.v1.Source.FileHashesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="grafeas.v1.Source.FileHashesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=818,
+    serialized_end=891,
+)
+
+_SOURCE = _descriptor.Descriptor(
+    name="Source",
+    full_name="grafeas.v1.Source",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="artifact_storage_source_uri",
+            full_name="grafeas.v1.Source.artifact_storage_source_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_hashes",
+            full_name="grafeas.v1.Source.file_hashes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="grafeas.v1.Source.context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="additional_contexts",
+            full_name="grafeas.v1.Source.additional_contexts",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SOURCE_FILEHASHESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=614,
+    serialized_end=891,
+)
+
+
+_FILEHASHES = _descriptor.Descriptor(
+    name="FileHashes",
+    full_name="grafeas.v1.FileHashes",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="file_hash",
+            full_name="grafeas.v1.FileHashes.file_hash",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=893,
+    serialized_end=942,
+)
+
+
+_HASH = _descriptor.Descriptor(
+    name="Hash",
+    full_name="grafeas.v1.Hash",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="grafeas.v1.Hash.type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="grafeas.v1.Hash.value",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=944,
+    serialized_end=979,
+)
+
+
+_COMMAND = _descriptor.Descriptor(
+    name="Command",
+    full_name="grafeas.v1.Command",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.Command.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="env",
+            full_name="grafeas.v1.Command.env",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="args",
+            full_name="grafeas.v1.Command.args",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dir",
+            full_name="grafeas.v1.Command.dir",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="grafeas.v1.Command.id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="wait_for",
+            full_name="grafeas.v1.Command.wait_for",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=981,
+    serialized_end=1074,
+)
+
+
+_ARTIFACT = _descriptor.Descriptor(
+    name="Artifact",
+    full_name="grafeas.v1.Artifact",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="checksum",
+            full_name="grafeas.v1.Artifact.checksum",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="grafeas.v1.Artifact.id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="names",
+            full_name="grafeas.v1.Artifact.names",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1076,
+    serialized_end=1131,
+)
+
+
+_SOURCECONTEXT_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="grafeas.v1.SourceContext.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="grafeas.v1.SourceContext.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="grafeas.v1.SourceContext.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1360,
+    serialized_end=1405,
+)
+
+_SOURCECONTEXT = _descriptor.Descriptor(
+    name="SourceContext",
+    full_name="grafeas.v1.SourceContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cloud_repo",
+            full_name="grafeas.v1.SourceContext.cloud_repo",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gerrit",
+            full_name="grafeas.v1.SourceContext.gerrit",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="git",
+            full_name="grafeas.v1.SourceContext.git",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="grafeas.v1.SourceContext.labels",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SOURCECONTEXT_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="context",
+            full_name="grafeas.v1.SourceContext.context",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1134,
+    serialized_end=1416,
+)
+
+
+_ALIASCONTEXT = _descriptor.Descriptor(
+    name="AliasContext",
+    full_name="grafeas.v1.AliasContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="grafeas.v1.AliasContext.kind",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.AliasContext.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ALIASCONTEXT_KIND],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1419,
+    serialized_end=1557,
+)
+
+
+_CLOUDREPOSOURCECONTEXT = _descriptor.Descriptor(
+    name="CloudRepoSourceContext",
+    full_name="grafeas.v1.CloudRepoSourceContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="repo_id",
+            full_name="grafeas.v1.CloudRepoSourceContext.repo_id",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="revision_id",
+            full_name="grafeas.v1.CloudRepoSourceContext.revision_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alias_context",
+            full_name="grafeas.v1.CloudRepoSourceContext.alias_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="revision",
+            full_name="grafeas.v1.CloudRepoSourceContext.revision",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1560,
+    serialized_end=1707,
+)
+
+
+_GERRITSOURCECONTEXT = _descriptor.Descriptor(
+    name="GerritSourceContext",
+    full_name="grafeas.v1.GerritSourceContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="host_uri",
+            full_name="grafeas.v1.GerritSourceContext.host_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gerrit_project",
+            full_name="grafeas.v1.GerritSourceContext.gerrit_project",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="revision_id",
+            full_name="grafeas.v1.GerritSourceContext.revision_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alias_context",
+            full_name="grafeas.v1.GerritSourceContext.alias_context",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="revision",
+            full_name="grafeas.v1.GerritSourceContext.revision",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1710,
+    serialized_end=1859,
+)
+
+
+_GITSOURCECONTEXT = _descriptor.Descriptor(
+    name="GitSourceContext",
+    full_name="grafeas.v1.GitSourceContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="grafeas.v1.GitSourceContext.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="revision_id",
+            full_name="grafeas.v1.GitSourceContext.revision_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1861,
+    serialized_end=1913,
+)
+
+
+_REPOID = _descriptor.Descriptor(
+    name="RepoId",
+    full_name="grafeas.v1.RepoId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_repo_id",
+            full_name="grafeas.v1.RepoId.project_repo_id",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uid",
+            full_name="grafeas.v1.RepoId.uid",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="id",
+            full_name="grafeas.v1.RepoId.id",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1915,
+    serialized_end=1998,
+)
+
+
+_PROJECTREPOID = _descriptor.Descriptor(
+    name="ProjectRepoId",
+    full_name="grafeas.v1.ProjectRepoId",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="grafeas.v1.ProjectRepoId.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="repo_name",
+            full_name="grafeas.v1.ProjectRepoId.repo_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2000,
+    serialized_end=2054,
+)
+
+_BUILDPROVENANCE_BUILDOPTIONSENTRY.containing_type = _BUILDPROVENANCE
+_BUILDPROVENANCE.fields_by_name["commands"].message_type = _COMMAND
+_BUILDPROVENANCE.fields_by_name["built_artifacts"].message_type = _ARTIFACT
+_BUILDPROVENANCE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BUILDPROVENANCE.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BUILDPROVENANCE.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BUILDPROVENANCE.fields_by_name["source_provenance"].message_type = _SOURCE
+_BUILDPROVENANCE.fields_by_name[
+    "build_options"
+].message_type = _BUILDPROVENANCE_BUILDOPTIONSENTRY
+_SOURCE_FILEHASHESENTRY.fields_by_name["value"].message_type = _FILEHASHES
+_SOURCE_FILEHASHESENTRY.containing_type = _SOURCE
+_SOURCE.fields_by_name["file_hashes"].message_type = _SOURCE_FILEHASHESENTRY
+_SOURCE.fields_by_name["context"].message_type = _SOURCECONTEXT
+_SOURCE.fields_by_name["additional_contexts"].message_type = _SOURCECONTEXT
+_FILEHASHES.fields_by_name["file_hash"].message_type = _HASH
+_SOURCECONTEXT_LABELSENTRY.containing_type = _SOURCECONTEXT
+_SOURCECONTEXT.fields_by_name["cloud_repo"].message_type = _CLOUDREPOSOURCECONTEXT
+_SOURCECONTEXT.fields_by_name["gerrit"].message_type = _GERRITSOURCECONTEXT
+_SOURCECONTEXT.fields_by_name["git"].message_type = _GITSOURCECONTEXT
+_SOURCECONTEXT.fields_by_name["labels"].message_type = _SOURCECONTEXT_LABELSENTRY
+_SOURCECONTEXT.oneofs_by_name["context"].fields.append(
+    _SOURCECONTEXT.fields_by_name["cloud_repo"]
+)
+_SOURCECONTEXT.fields_by_name[
+    "cloud_repo"
+].containing_oneof = _SOURCECONTEXT.oneofs_by_name["context"]
+_SOURCECONTEXT.oneofs_by_name["context"].fields.append(
+    _SOURCECONTEXT.fields_by_name["gerrit"]
+)
+_SOURCECONTEXT.fields_by_name[
+    "gerrit"
+].containing_oneof = _SOURCECONTEXT.oneofs_by_name["context"]
+_SOURCECONTEXT.oneofs_by_name["context"].fields.append(
+    _SOURCECONTEXT.fields_by_name["git"]
+)
+_SOURCECONTEXT.fields_by_name["git"].containing_oneof = _SOURCECONTEXT.oneofs_by_name[
+    "context"
+]
+_ALIASCONTEXT.fields_by_name["kind"].enum_type = _ALIASCONTEXT_KIND
+_ALIASCONTEXT_KIND.containing_type = _ALIASCONTEXT
+_CLOUDREPOSOURCECONTEXT.fields_by_name["repo_id"].message_type = _REPOID
+_CLOUDREPOSOURCECONTEXT.fields_by_name["alias_context"].message_type = _ALIASCONTEXT
+_CLOUDREPOSOURCECONTEXT.oneofs_by_name["revision"].fields.append(
+    _CLOUDREPOSOURCECONTEXT.fields_by_name["revision_id"]
+)
+_CLOUDREPOSOURCECONTEXT.fields_by_name[
+    "revision_id"
+].containing_oneof = _CLOUDREPOSOURCECONTEXT.oneofs_by_name["revision"]
+_CLOUDREPOSOURCECONTEXT.oneofs_by_name["revision"].fields.append(
+    _CLOUDREPOSOURCECONTEXT.fields_by_name["alias_context"]
+)
+_CLOUDREPOSOURCECONTEXT.fields_by_name[
+    "alias_context"
+].containing_oneof = _CLOUDREPOSOURCECONTEXT.oneofs_by_name["revision"]
+_GERRITSOURCECONTEXT.fields_by_name["alias_context"].message_type = _ALIASCONTEXT
+_GERRITSOURCECONTEXT.oneofs_by_name["revision"].fields.append(
+    _GERRITSOURCECONTEXT.fields_by_name["revision_id"]
+)
+_GERRITSOURCECONTEXT.fields_by_name[
+    "revision_id"
+].containing_oneof = _GERRITSOURCECONTEXT.oneofs_by_name["revision"]
+_GERRITSOURCECONTEXT.oneofs_by_name["revision"].fields.append(
+    _GERRITSOURCECONTEXT.fields_by_name["alias_context"]
+)
+_GERRITSOURCECONTEXT.fields_by_name[
+    "alias_context"
+].containing_oneof = _GERRITSOURCECONTEXT.oneofs_by_name["revision"]
+_REPOID.fields_by_name["project_repo_id"].message_type = _PROJECTREPOID
+_REPOID.oneofs_by_name["id"].fields.append(_REPOID.fields_by_name["project_repo_id"])
+_REPOID.fields_by_name["project_repo_id"].containing_oneof = _REPOID.oneofs_by_name[
+    "id"
+]
+_REPOID.oneofs_by_name["id"].fields.append(_REPOID.fields_by_name["uid"])
+_REPOID.fields_by_name["uid"].containing_oneof = _REPOID.oneofs_by_name["id"]
+DESCRIPTOR.message_types_by_name["BuildProvenance"] = _BUILDPROVENANCE
+DESCRIPTOR.message_types_by_name["Source"] = _SOURCE
+DESCRIPTOR.message_types_by_name["FileHashes"] = _FILEHASHES
+DESCRIPTOR.message_types_by_name["Hash"] = _HASH
+DESCRIPTOR.message_types_by_name["Command"] = _COMMAND
+DESCRIPTOR.message_types_by_name["Artifact"] = _ARTIFACT
+DESCRIPTOR.message_types_by_name["SourceContext"] = _SOURCECONTEXT
+DESCRIPTOR.message_types_by_name["AliasContext"] = _ALIASCONTEXT
+DESCRIPTOR.message_types_by_name["CloudRepoSourceContext"] = _CLOUDREPOSOURCECONTEXT
+DESCRIPTOR.message_types_by_name["GerritSourceContext"] = _GERRITSOURCECONTEXT
+DESCRIPTOR.message_types_by_name["GitSourceContext"] = _GITSOURCECONTEXT
+DESCRIPTOR.message_types_by_name["RepoId"] = _REPOID
+DESCRIPTOR.message_types_by_name["ProjectRepoId"] = _PROJECTREPOID
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+BuildProvenance = _reflection.GeneratedProtocolMessageType(
+    "BuildProvenance",
+    (_message.Message,),
+    dict(
+        BuildOptionsEntry=_reflection.GeneratedProtocolMessageType(
+            "BuildOptionsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BUILDPROVENANCE_BUILDOPTIONSENTRY,
+                __module__="grafeas_v1.proto.provenance_pb2"
+                # @@protoc_insertion_point(class_scope:grafeas.v1.BuildProvenance.BuildOptionsEntry)
+            ),
+        ),
+        DESCRIPTOR=_BUILDPROVENANCE,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Provenance of a build. Contains all information needed to verify the
+  full details about the build from source to completion.
+  
+  
+  Attributes:
+      id:
+          Required. Unique identifier of the build.
+      project_id:
+          ID of the project.
+      commands:
+          Commands requested by the build.
+      built_artifacts:
+          Output of the build.
+      create_time:
+          Time at which the build was created.
+      start_time:
+          Time at which execution of the build was started.
+      end_time:
+          Time at which execution of the build was finished.
+      creator:
+          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.
+      logs_uri:
+          URI where any logs for this provenance were written.
+      source_provenance:
+          Details of the Source input to the build.
+      trigger_id:
+          Trigger identifier if the build was triggered automatically;
+          empty if not.
+      build_options:
+          Special options applied to this build. This is a catch-all
+          field where build providers can enter any desired additional
+          details.
+      builder_version:
+          Version string of the builder at the time this build was
+          executed.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.BuildProvenance)
+    ),
+)
+_sym_db.RegisterMessage(BuildProvenance)
+_sym_db.RegisterMessage(BuildProvenance.BuildOptionsEntry)
+
+Source = _reflection.GeneratedProtocolMessageType(
+    "Source",
+    (_message.Message,),
+    dict(
+        FileHashesEntry=_reflection.GeneratedProtocolMessageType(
+            "FileHashesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SOURCE_FILEHASHESENTRY,
+                __module__="grafeas_v1.proto.provenance_pb2"
+                # @@protoc_insertion_point(class_scope:grafeas.v1.Source.FileHashesEntry)
+            ),
+        ),
+        DESCRIPTOR=_SOURCE,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Source describes the location of the source used for the build.
+  
+  
+  Attributes:
+      artifact_storage_source_uri:
+          If provided, the input binary artifacts for the build came
+          from this location.
+      file_hashes:
+          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.
+      context:
+          If provided, the source code used for the build came from this
+          location.
+      additional_contexts:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Source)
+    ),
+)
+_sym_db.RegisterMessage(Source)
+_sym_db.RegisterMessage(Source.FileHashesEntry)
+
+FileHashes = _reflection.GeneratedProtocolMessageType(
+    "FileHashes",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FILEHASHES,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Container message for hashes of byte content of files, used in source
+  messages to verify integrity of source input to the build.
+  
+  
+  Attributes:
+      file_hash:
+          Required. Collection of file hashes.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.FileHashes)
+    ),
+)
+_sym_db.RegisterMessage(FileHashes)
+
+Hash = _reflection.GeneratedProtocolMessageType(
+    "Hash",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HASH,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Container message for hash values.
+  
+  
+  Attributes:
+      type:
+          Required. The type of hash that was performed, e.g. "SHA-256".
+      value:
+          Required. The hash value.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Hash)
+    ),
+)
+_sym_db.RegisterMessage(Hash)
+
+Command = _reflection.GeneratedProtocolMessageType(
+    "Command",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMAND,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Command describes a step performed as part of the build pipeline.
+  
+  
+  Attributes:
+      name:
+          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``.
+      env:
+          Environment variables set before running this command.
+      args:
+          Command-line arguments used when executing this command.
+      dir:
+          Working directory (relative to project source root) used when
+          running this command.
+      id:
+          Optional unique identifier for this command, used in wait\_for
+          to reference this command as a dependency.
+      wait_for:
+          The ID(s) of the command(s) that this command depends on.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Command)
+    ),
+)
+_sym_db.RegisterMessage(Command)
+
+Artifact = _reflection.GeneratedProtocolMessageType(
+    "Artifact",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARTIFACT,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Artifact describes a build product.
+  
+  
+  Attributes:
+      checksum:
+          Hash or checksum value of a binary, or Docker Registry 2.0
+          digest of a container.
+      id:
+          Artifact ID, if any; for container images, this will be a URL
+          by digest like ``gcr.io/projectID/imagename@sha256:123456``.
+      names:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.Artifact)
+    ),
+)
+_sym_db.RegisterMessage(Artifact)
+
+SourceContext = _reflection.GeneratedProtocolMessageType(
+    "SourceContext",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SOURCECONTEXT_LABELSENTRY,
+                __module__="grafeas_v1.proto.provenance_pb2"
+                # @@protoc_insertion_point(class_scope:grafeas.v1.SourceContext.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_SOURCECONTEXT,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      context:
+          A SourceContext can refer any one of the following types of
+          repositories.
+      cloud_repo:
+          A SourceContext referring to a revision in a Google Cloud
+          Source Repo.
+      gerrit:
+          A SourceContext referring to a Gerrit project.
+      git:
+          A SourceContext referring to any third party Git repo (e.g.,
+          GitHub).
+      labels:
+          Labels with user defined metadata.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.SourceContext)
+    ),
+)
+_sym_db.RegisterMessage(SourceContext)
+_sym_db.RegisterMessage(SourceContext.LabelsEntry)
+
+AliasContext = _reflection.GeneratedProtocolMessageType(
+    "AliasContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ALIASCONTEXT,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""An alias to a repo revision.
+  
+  
+  Attributes:
+      kind:
+          The alias kind.
+      name:
+          The alias name.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.AliasContext)
+    ),
+)
+_sym_db.RegisterMessage(AliasContext)
+
+CloudRepoSourceContext = _reflection.GeneratedProtocolMessageType(
+    "CloudRepoSourceContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLOUDREPOSOURCECONTEXT,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""A CloudRepoSourceContext denotes a particular revision in a Google Cloud
+  Source Repo.
+  
+  
+  Attributes:
+      repo_id:
+          The ID of the repo.
+      revision:
+          A revision in a Cloud Repo can be identified by either its
+          revision ID or its alias.
+      revision_id:
+          A revision ID.
+      alias_context:
+          An alias, which may be a branch or tag.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.CloudRepoSourceContext)
+    ),
+)
+_sym_db.RegisterMessage(CloudRepoSourceContext)
+
+GerritSourceContext = _reflection.GeneratedProtocolMessageType(
+    "GerritSourceContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GERRITSOURCECONTEXT,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""A SourceContext referring to a Gerrit project.
+  
+  
+  Attributes:
+      host_uri:
+          The URI of a running Gerrit instance.
+      gerrit_project:
+          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.
+      revision:
+          A revision in a Gerrit project can be identified by either its
+          revision ID or its alias.
+      revision_id:
+          A revision (commit) ID.
+      alias_context:
+          An alias, which may be a branch or tag.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.GerritSourceContext)
+    ),
+)
+_sym_db.RegisterMessage(GerritSourceContext)
+
+GitSourceContext = _reflection.GeneratedProtocolMessageType(
+    "GitSourceContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GITSOURCECONTEXT,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""A GitSourceContext denotes a particular revision in a third party Git
+  repository (e.g., GitHub).
+  
+  
+  Attributes:
+      url:
+          Git repository URL.
+      revision_id:
+          Git commit hash.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.GitSourceContext)
+    ),
+)
+_sym_db.RegisterMessage(GitSourceContext)
+
+RepoId = _reflection.GeneratedProtocolMessageType(
+    "RepoId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPOID,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""A unique identifier for a Cloud Repo.
+  
+  
+  Attributes:
+      id:
+          A cloud repo can be identified by either its project ID and
+          repository name combination, or its globally unique
+          identifier.
+      project_repo_id:
+          A combination of a project ID and a repo name.
+      uid:
+          A server-assigned, globally unique identifier.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.RepoId)
+    ),
+)
+_sym_db.RegisterMessage(RepoId)
+
+ProjectRepoId = _reflection.GeneratedProtocolMessageType(
+    "ProjectRepoId",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROJECTREPOID,
+        __module__="grafeas_v1.proto.provenance_pb2",
+        __doc__="""Selects a repo using a Google Cloud Platform project ID (e.g.,
+  winged-cargo-31) and a repo name within that project.
+  
+  
+  Attributes:
+      project_id:
+          The ID of the project.
+      repo_name:
+          The name of the repo. Leave empty for the default repo.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.ProjectRepoId)
+    ),
+)
+_sym_db.RegisterMessage(ProjectRepoId)
+
+
+DESCRIPTOR._options = None
+_BUILDPROVENANCE_BUILDOPTIONSENTRY._options = None
+_SOURCE_FILEHASHESENTRY._options = None
+_SOURCECONTEXT_LABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/provenance_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/provenance_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/provenance_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/proto/vulnerability.proto b/grafeas/grafeas/grafeas_v1/proto/vulnerability.proto
new file mode 100644
index 000000000000..27a5d238b9cc
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/vulnerability.proto
@@ -0,0 +1,216 @@
+// 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 "grafeas/v1/common.proto";
+import "grafeas/v1/cvss.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";
+
+// Note provider assigned severity/impact ranking.
+enum Severity {
+  // Unknown.
+  SEVERITY_UNSPECIFIED = 0;
+  // Minimal severity.
+  MINIMAL = 1;
+  // Low severity.
+  LOW = 2;
+  // Medium severity.
+  MEDIUM = 3;
+  // High severity.
+  HIGH = 4;
+  // Critical severity.
+  CRITICAL = 5;
+}
+
+// A security vulnerability that can be found in resources.
+message VulnerabilityNote {
+  // 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 = 1;
+
+  // The note provider assigned severity of this vulnerability.
+  Severity severity = 2;
+
+  // Details of all known distros and packages affected by this vulnerability.
+  repeated Detail details = 3;
+
+  // A detail for a distro and package affected by this vulnerability and its
+  // associated fix (if one is available).
+  message Detail {
+    // The distro assigned severity of this vulnerability.
+    string severity_name = 1;
+
+    // A vendor-specific description of this vulnerability.
+    string description = 2;
+
+    // The type of package; whether native or non native (e.g., ruby gems,
+    // node.js packages, etc.).
+    string package_type = 3;
+
+    // Required. The [CPE URI](https://cpe.mitre.org/specification/) this
+    // vulnerability affects.
+    string affected_cpe_uri = 4;
+
+    // Required. The package this vulnerability affects.
+    string affected_package = 5;
+
+    // The version number at the start of an interval in which this
+    // vulnerability exists. A vulnerability can affect a package between
+    // version numbers that are disjoint sets of intervals (example:
+    // [1.0.0-1.1.0], [2.4.6-2.4.8] and [4.5.6-4.6.8]) each of which will be
+    // represented in its own Detail. If a specific affected version is provided
+    // by a vulnerability database, affected_version_start and
+    // affected_version_end will be the same in that Detail.
+    grafeas.v1.Version affected_version_start = 6;
+
+    // The version number at the end of an interval in which this vulnerability
+    // exists. A vulnerability can affect a package between version numbers
+    // that are disjoint sets of intervals (example: [1.0.0-1.1.0],
+    // [2.4.6-2.4.8] and [4.5.6-4.6.8]) each of which will be represented in its
+    // own Detail. If a specific affected version is provided by a vulnerability
+    // database, affected_version_start and affected_version_end will be the
+    // same in that Detail.
+    grafeas.v1.Version affected_version_end = 7;
+
+    // The distro recommended [CPE URI](https://cpe.mitre.org/specification/)
+    // to update to that contains a fix for this vulnerability. It is possible
+    // for this to be different from the affected_cpe_uri.
+    string fixed_cpe_uri = 8;
+
+    // The distro recommended package to update to that contains a fix for this
+    // vulnerability. It is possible for this to be different from the
+    // affected_package.
+    string fixed_package = 9;
+
+    // The distro recommended version to update to that contains a
+    // fix for this vulnerability. Setting this to VersionKind.MAXIMUM means no
+    // such version is yet available.
+    grafeas.v1.Version fixed_version = 10;
+
+    // Whether this detail is obsolete. Occurrences are expected not to point to
+    // obsolete details.
+    bool is_obsolete = 11;
+  }
+
+  // The full description of the CVSSv3 for this vulnerability.
+  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](https://cpe.mitre.org/specification/) this
+    // vulnerability affects.
+    string cpe_uri = 1;
+
+    // Required. The name of this vulnerability.
+    string name = 2;
+
+    // The description of this 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
+    // KBs presence is considered a fix.
+    repeated KnowledgeBase fixing_kbs = 4;
+
+    message KnowledgeBase {
+      // The KB name (generally of the form KB[0-9]+ (e.g., KB123456)).
+      string name = 1;
+      // A link to the KB in the [Windows update catalog]
+      // (https://www.catalog.update.microsoft.com/).
+      string url = 2;
+    }
+  }
+}
+
+// An occurrence of a severity vulnerability on a resource.
+message VulnerabilityOccurrence {
+  // The type of package; whether native or non native (e.g., ruby gems, node.js
+  // packages, etc.).
+  string type = 1;
+
+  // Output only. The note provider assigned severity of this vulnerability.
+  Severity severity = 2;
+
+  // 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 = 3;
+
+  // Required. The set of affected locations and their fixes (if available)
+  // within the associated resource.
+  repeated PackageIssue package_issue = 4;
+
+  // A detail for a distro and package this vulnerability occurrence was found
+  // in and its associated fix (if one is available).
+  message PackageIssue {
+    // Required. The [CPE URI](https://cpe.mitre.org/specification/) this
+    // vulnerability was found in.
+    string affected_cpe_uri = 1;
+
+    // Required. The package this vulnerability was found in.
+    string affected_package = 2;
+
+    // Required. The version of the package that is installed on the resource
+    // affected by this vulnerability.
+    grafeas.v1.Version affected_version = 3;
+
+    // The [CPE URI](https://cpe.mitre.org/specification/) this vulnerability
+    // was fixed in. It is possible for this to be different from the
+    // affected_cpe_uri.
+    string fixed_cpe_uri = 4;
+
+    // The package this vulnerability was fixed in. It is possible for this to
+    // be different from the affected_package.
+    string fixed_package = 5;
+
+    // Required. The version of the package this vulnerability was fixed in.
+    // Setting this to VersionKind.MAXIMUM means no fix is yet available.
+    grafeas.v1.Version fixed_version = 6;
+
+    // Output only. Whether a fix is available for this package.
+    bool fix_available = 7;
+  }
+
+  // Output only. A one sentence description of this vulnerability.
+  string short_description = 5;
+
+  // Output only. A detailed description of this vulnerability.
+  string long_description = 6;
+
+  // Output only. URLs related to this vulnerability.
+  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.
+  Severity effective_severity = 8;
+
+  // Output only. Whether at least one of the affected packages has a fix
+  // available.
+  bool fix_available = 9;
+}
diff --git a/grafeas/grafeas/grafeas_v1/proto/vulnerability_pb2.py b/grafeas/grafeas/grafeas_v1/proto/vulnerability_pb2.py
new file mode 100644
index 000000000000..612904b4a998
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/vulnerability_pb2.py
@@ -0,0 +1,1160 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grafeas_v1/proto/vulnerability.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from grafeas.grafeas_v1.proto import common_pb2 as grafeas__v1_dot_proto_dot_common__pb2
+from grafeas.grafeas_v1.proto import cvss_pb2 as grafeas__v1_dot_proto_dot_cvss__pb2
+from grafeas.grafeas_v1.proto import (
+    package_pb2 as grafeas__v1_dot_proto_dot_package__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="grafeas_v1/proto/vulnerability.proto",
+    package="grafeas.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\rio.grafeas.v1P\001Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\242\002\003GRA"
+    ),
+    serialized_pb=_b(
+        '\n$grafeas_v1/proto/vulnerability.proto\x12\ngrafeas.v1\x1a\x1dgrafeas_v1/proto/common.proto\x1a\x1bgrafeas_v1/proto/cvss.proto\x1a\x1egrafeas_v1/proto/package.proto"\x8a\x06\n\x11VulnerabilityNote\x12\x12\n\ncvss_score\x18\x01 \x01(\x02\x12&\n\x08severity\x18\x02 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x35\n\x07\x64\x65tails\x18\x03 \x03(\x0b\x32$.grafeas.v1.VulnerabilityNote.Detail\x12#\n\x07\x63vss_v3\x18\x04 \x01(\x0b\x32\x12.grafeas.v1.CVSSv3\x12\x44\n\x0fwindows_details\x18\x05 \x03(\x0b\x32+.grafeas.v1.VulnerabilityNote.WindowsDetail\x1a\xd5\x02\n\x06\x44\x65tail\x12\x15\n\rseverity_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x14\n\x0cpackage_type\x18\x03 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_cpe_uri\x18\x04 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_package\x18\x05 \x01(\t\x12\x33\n\x16\x61\x66\x66\x65\x63ted_version_start\x18\x06 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x31\n\x14\x61\x66\x66\x65\x63ted_version_end\x18\x07 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfixed_cpe_uri\x18\x08 \x01(\t\x12\x15\n\rfixed_package\x18\t \x01(\t\x12*\n\rfixed_version\x18\n \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x13\n\x0bis_obsolete\x18\x0b \x01(\x08\x1a\xbe\x01\n\rWindowsDetail\x12\x0f\n\x07\x63pe_uri\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12M\n\nfixing_kbs\x18\x04 \x03(\x0b\x32\x39.grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase\x1a*\n\rKnowledgeBase\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t"\xbd\x04\n\x17VulnerabilityOccurrence\x12\x0c\n\x04type\x18\x01 \x01(\t\x12&\n\x08severity\x18\x02 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x12\n\ncvss_score\x18\x03 \x01(\x02\x12G\n\rpackage_issue\x18\x04 \x03(\x0b\x32\x30.grafeas.v1.VulnerabilityOccurrence.PackageIssue\x12\x19\n\x11short_description\x18\x05 \x01(\t\x12\x18\n\x10long_description\x18\x06 \x01(\t\x12,\n\x0crelated_urls\x18\x07 \x03(\x0b\x32\x16.grafeas.v1.RelatedUrl\x12\x30\n\x12\x65\x66\x66\x65\x63tive_severity\x18\x08 \x01(\x0e\x32\x14.grafeas.v1.Severity\x12\x15\n\rfix_available\x18\t \x01(\x08\x1a\xe2\x01\n\x0cPackageIssue\x12\x18\n\x10\x61\x66\x66\x65\x63ted_cpe_uri\x18\x01 \x01(\t\x12\x18\n\x10\x61\x66\x66\x65\x63ted_package\x18\x02 \x01(\t\x12-\n\x10\x61\x66\x66\x65\x63ted_version\x18\x03 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfixed_cpe_uri\x18\x04 \x01(\t\x12\x15\n\rfixed_package\x18\x05 \x01(\t\x12*\n\rfixed_version\x18\x06 \x01(\x0b\x32\x13.grafeas.v1.Version\x12\x15\n\rfix_available\x18\x07 \x01(\x08*^\n\x08Severity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x0b\n\x07MINIMAL\x10\x01\x12\x07\n\x03LOW\x10\x02\x12\n\n\x06MEDIUM\x10\x03\x12\x08\n\x04HIGH\x10\x04\x12\x0c\n\x08\x43RITICAL\x10\x05\x42Q\n\rio.grafeas.v1P\x01Z8google.golang.org/genproto/googleapis/grafeas/v1;grafeas\xa2\x02\x03GRAb\x06proto3'
+    ),
+    dependencies=[
+        grafeas__v1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_cvss__pb2.DESCRIPTOR,
+        grafeas__v1_dot_proto_dot_package__pb2.DESCRIPTOR,
+    ],
+)
+
+_SEVERITY = _descriptor.EnumDescriptor(
+    name="Severity",
+    full_name="grafeas.v1.Severity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MINIMAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOW", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEDIUM", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HIGH", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CRITICAL", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1501,
+    serialized_end=1595,
+)
+_sym_db.RegisterEnumDescriptor(_SEVERITY)
+
+Severity = enum_type_wrapper.EnumTypeWrapper(_SEVERITY)
+SEVERITY_UNSPECIFIED = 0
+MINIMAL = 1
+LOW = 2
+MEDIUM = 3
+HIGH = 4
+CRITICAL = 5
+
+
+_VULNERABILITYNOTE_DETAIL = _descriptor.Descriptor(
+    name="Detail",
+    full_name="grafeas.v1.VulnerabilityNote.Detail",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="severity_name",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.severity_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="package_type",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.package_type",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_cpe_uri",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.affected_cpe_uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_package",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.affected_package",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_version_start",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.affected_version_start",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_version_end",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.affected_version_end",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_cpe_uri",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.fixed_cpe_uri",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_package",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.fixed_package",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_version",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.fixed_version",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_obsolete",
+            full_name="grafeas.v1.VulnerabilityNote.Detail.is_obsolete",
+            index=10,
+            number=11,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=389,
+    serialized_end=730,
+)
+
+_VULNERABILITYNOTE_WINDOWSDETAIL_KNOWLEDGEBASE = _descriptor.Descriptor(
+    name="KnowledgeBase",
+    full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase.url",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=881,
+    serialized_end=923,
+)
+
+_VULNERABILITYNOTE_WINDOWSDETAIL = _descriptor.Descriptor(
+    name="WindowsDetail",
+    full_name="grafeas.v1.VulnerabilityNote.WindowsDetail",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cpe_uri",
+            full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.cpe_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixing_kbs",
+            full_name="grafeas.v1.VulnerabilityNote.WindowsDetail.fixing_kbs",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_VULNERABILITYNOTE_WINDOWSDETAIL_KNOWLEDGEBASE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=733,
+    serialized_end=923,
+)
+
+_VULNERABILITYNOTE = _descriptor.Descriptor(
+    name="VulnerabilityNote",
+    full_name="grafeas.v1.VulnerabilityNote",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cvss_score",
+            full_name="grafeas.v1.VulnerabilityNote.cvss_score",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="severity",
+            full_name="grafeas.v1.VulnerabilityNote.severity",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="details",
+            full_name="grafeas.v1.VulnerabilityNote.details",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cvss_v3",
+            full_name="grafeas.v1.VulnerabilityNote.cvss_v3",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="windows_details",
+            full_name="grafeas.v1.VulnerabilityNote.windows_details",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_VULNERABILITYNOTE_DETAIL, _VULNERABILITYNOTE_WINDOWSDETAIL],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=145,
+    serialized_end=923,
+)
+
+
+_VULNERABILITYOCCURRENCE_PACKAGEISSUE = _descriptor.Descriptor(
+    name="PackageIssue",
+    full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="affected_cpe_uri",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.affected_cpe_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_package",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.affected_package",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="affected_version",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.affected_version",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_cpe_uri",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.fixed_cpe_uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_package",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.fixed_package",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fixed_version",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.fixed_version",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fix_available",
+            full_name="grafeas.v1.VulnerabilityOccurrence.PackageIssue.fix_available",
+            index=6,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1273,
+    serialized_end=1499,
+)
+
+_VULNERABILITYOCCURRENCE = _descriptor.Descriptor(
+    name="VulnerabilityOccurrence",
+    full_name="grafeas.v1.VulnerabilityOccurrence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="grafeas.v1.VulnerabilityOccurrence.type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="severity",
+            full_name="grafeas.v1.VulnerabilityOccurrence.severity",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cvss_score",
+            full_name="grafeas.v1.VulnerabilityOccurrence.cvss_score",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="package_issue",
+            full_name="grafeas.v1.VulnerabilityOccurrence.package_issue",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="short_description",
+            full_name="grafeas.v1.VulnerabilityOccurrence.short_description",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="long_description",
+            full_name="grafeas.v1.VulnerabilityOccurrence.long_description",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="related_urls",
+            full_name="grafeas.v1.VulnerabilityOccurrence.related_urls",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="effective_severity",
+            full_name="grafeas.v1.VulnerabilityOccurrence.effective_severity",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fix_available",
+            full_name="grafeas.v1.VulnerabilityOccurrence.fix_available",
+            index=8,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_VULNERABILITYOCCURRENCE_PACKAGEISSUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=926,
+    serialized_end=1499,
+)
+
+_VULNERABILITYNOTE_DETAIL.fields_by_name[
+    "affected_version_start"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._VERSION
+_VULNERABILITYNOTE_DETAIL.fields_by_name[
+    "affected_version_end"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._VERSION
+_VULNERABILITYNOTE_DETAIL.fields_by_name[
+    "fixed_version"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._VERSION
+_VULNERABILITYNOTE_DETAIL.containing_type = _VULNERABILITYNOTE
+_VULNERABILITYNOTE_WINDOWSDETAIL_KNOWLEDGEBASE.containing_type = (
+    _VULNERABILITYNOTE_WINDOWSDETAIL
+)
+_VULNERABILITYNOTE_WINDOWSDETAIL.fields_by_name[
+    "fixing_kbs"
+].message_type = _VULNERABILITYNOTE_WINDOWSDETAIL_KNOWLEDGEBASE
+_VULNERABILITYNOTE_WINDOWSDETAIL.containing_type = _VULNERABILITYNOTE
+_VULNERABILITYNOTE.fields_by_name["severity"].enum_type = _SEVERITY
+_VULNERABILITYNOTE.fields_by_name["details"].message_type = _VULNERABILITYNOTE_DETAIL
+_VULNERABILITYNOTE.fields_by_name[
+    "cvss_v3"
+].message_type = grafeas__v1_dot_proto_dot_cvss__pb2._CVSSV3
+_VULNERABILITYNOTE.fields_by_name[
+    "windows_details"
+].message_type = _VULNERABILITYNOTE_WINDOWSDETAIL
+_VULNERABILITYOCCURRENCE_PACKAGEISSUE.fields_by_name[
+    "affected_version"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._VERSION
+_VULNERABILITYOCCURRENCE_PACKAGEISSUE.fields_by_name[
+    "fixed_version"
+].message_type = grafeas__v1_dot_proto_dot_package__pb2._VERSION
+_VULNERABILITYOCCURRENCE_PACKAGEISSUE.containing_type = _VULNERABILITYOCCURRENCE
+_VULNERABILITYOCCURRENCE.fields_by_name["severity"].enum_type = _SEVERITY
+_VULNERABILITYOCCURRENCE.fields_by_name[
+    "package_issue"
+].message_type = _VULNERABILITYOCCURRENCE_PACKAGEISSUE
+_VULNERABILITYOCCURRENCE.fields_by_name[
+    "related_urls"
+].message_type = grafeas__v1_dot_proto_dot_common__pb2._RELATEDURL
+_VULNERABILITYOCCURRENCE.fields_by_name["effective_severity"].enum_type = _SEVERITY
+DESCRIPTOR.message_types_by_name["VulnerabilityNote"] = _VULNERABILITYNOTE
+DESCRIPTOR.message_types_by_name["VulnerabilityOccurrence"] = _VULNERABILITYOCCURRENCE
+DESCRIPTOR.enum_types_by_name["Severity"] = _SEVERITY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+VulnerabilityNote = _reflection.GeneratedProtocolMessageType(
+    "VulnerabilityNote",
+    (_message.Message,),
+    dict(
+        Detail=_reflection.GeneratedProtocolMessageType(
+            "Detail",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_VULNERABILITYNOTE_DETAIL,
+                __module__="grafeas_v1.proto.vulnerability_pb2",
+                __doc__="""A detail for a distro and package affected by this vulnerability and its
+    associated fix (if one is available).
+    
+    
+    Attributes:
+        severity_name:
+            The distro assigned severity of this vulnerability.
+        description:
+            A vendor-specific description of this vulnerability.
+        package_type:
+            The type of package; whether native or non native (e.g., ruby
+            gems, node.js packages, etc.).
+        affected_cpe_uri:
+            Required. The `CPE URI
+            <https://cpe.mitre.org/specification/>`__ this vulnerability
+            affects.
+        affected_package:
+            Required. The package this vulnerability affects.
+        affected_version_start:
+            The version number at the start of an interval in which this
+            vulnerability exists. A vulnerability can affect a package
+            between version numbers that are disjoint sets of intervals
+            (example: [1.0.0-1.1.0], [2.4.6-2.4.8] and [4.5.6-4.6.8]) each
+            of which will be represented in its own Detail. If a specific
+            affected version is provided by a vulnerability database,
+            affected\_version\_start and affected\_version\_end will be
+            the same in that Detail.
+        affected_version_end:
+            The version number at the end of an interval in which this
+            vulnerability exists. A vulnerability can affect a package
+            between version numbers that are disjoint sets of intervals
+            (example: [1.0.0-1.1.0], [2.4.6-2.4.8] and [4.5.6-4.6.8]) each
+            of which will be represented in its own Detail. If a specific
+            affected version is provided by a vulnerability database,
+            affected\_version\_start and affected\_version\_end will be
+            the same in that Detail.
+        fixed_cpe_uri:
+            The distro recommended `CPE URI
+            <https://cpe.mitre.org/specification/>`__ to update to that
+            contains a fix for this vulnerability. It is possible for this
+            to be different from the affected\_cpe\_uri.
+        fixed_package:
+            The distro recommended package to update to that contains a
+            fix for this vulnerability. It is possible for this to be
+            different from the affected\_package.
+        fixed_version:
+            The distro recommended version to update to that contains a
+            fix for this vulnerability. Setting this to
+            VersionKind.MAXIMUM means no such version is yet available.
+        is_obsolete:
+            Whether this detail is obsolete. Occurrences are expected not
+            to point to obsolete details.
+    """,
+                # @@protoc_insertion_point(class_scope:grafeas.v1.VulnerabilityNote.Detail)
+            ),
+        ),
+        WindowsDetail=_reflection.GeneratedProtocolMessageType(
+            "WindowsDetail",
+            (_message.Message,),
+            dict(
+                KnowledgeBase=_reflection.GeneratedProtocolMessageType(
+                    "KnowledgeBase",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_VULNERABILITYNOTE_WINDOWSDETAIL_KNOWLEDGEBASE,
+                        __module__="grafeas_v1.proto.vulnerability_pb2",
+                        __doc__="""
+    Attributes:
+          name:
+              The KB name (generally of the form KB[0-9]+ (e.g., KB123456)).
+          url:
+              A link to the KB in the [Windows update catalog]
+              (https://www.catalog.update.microsoft.com/).
+      """,
+                        # @@protoc_insertion_point(class_scope:grafeas.v1.VulnerabilityNote.WindowsDetail.KnowledgeBase)
+                    ),
+                ),
+                DESCRIPTOR=_VULNERABILITYNOTE_WINDOWSDETAIL,
+                __module__="grafeas_v1.proto.vulnerability_pb2",
+                __doc__="""
+    Attributes:
+        cpe_uri:
+            Required. The `CPE URI
+            <https://cpe.mitre.org/specification/>`__ this vulnerability
+            affects.
+        name:
+            Required. The name of this vulnerability.
+        description:
+            The description of this vulnerability.
+        fixing_kbs:
+            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 KBs presence is considered a fix.
+    """,
+                # @@protoc_insertion_point(class_scope:grafeas.v1.VulnerabilityNote.WindowsDetail)
+            ),
+        ),
+        DESCRIPTOR=_VULNERABILITYNOTE,
+        __module__="grafeas_v1.proto.vulnerability_pb2",
+        __doc__="""A security vulnerability that can be found in resources.
+  
+  
+  Attributes:
+      cvss_score:
+          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.
+      severity:
+          The note provider assigned severity of this vulnerability.
+      details:
+          Details of all known distros and packages affected by this
+          vulnerability.
+      cvss_v3:
+          The full description of the CVSSv3 for this vulnerability.
+      windows_details:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.VulnerabilityNote)
+    ),
+)
+_sym_db.RegisterMessage(VulnerabilityNote)
+_sym_db.RegisterMessage(VulnerabilityNote.Detail)
+_sym_db.RegisterMessage(VulnerabilityNote.WindowsDetail)
+_sym_db.RegisterMessage(VulnerabilityNote.WindowsDetail.KnowledgeBase)
+
+VulnerabilityOccurrence = _reflection.GeneratedProtocolMessageType(
+    "VulnerabilityOccurrence",
+    (_message.Message,),
+    dict(
+        PackageIssue=_reflection.GeneratedProtocolMessageType(
+            "PackageIssue",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_VULNERABILITYOCCURRENCE_PACKAGEISSUE,
+                __module__="grafeas_v1.proto.vulnerability_pb2",
+                __doc__="""A detail for a distro and package this vulnerability occurrence was
+    found in and its associated fix (if one is available).
+    
+    
+    Attributes:
+        affected_cpe_uri:
+            Required. The `CPE URI
+            <https://cpe.mitre.org/specification/>`__ this vulnerability
+            was found in.
+        affected_package:
+            Required. The package this vulnerability was found in.
+        affected_version:
+            Required. The version of the package that is installed on the
+            resource affected by this vulnerability.
+        fixed_cpe_uri:
+            The `CPE URI <https://cpe.mitre.org/specification/>`__ this
+            vulnerability was fixed in. It is possible for this to be
+            different from the affected\_cpe\_uri.
+        fixed_package:
+            The package this vulnerability was fixed in. It is possible
+            for this to be different from the affected\_package.
+        fixed_version:
+            Required. The version of the package this vulnerability was
+            fixed in. Setting this to VersionKind.MAXIMUM means no fix is
+            yet available.
+        fix_available:
+            Output only. Whether a fix is available for this package.
+    """,
+                # @@protoc_insertion_point(class_scope:grafeas.v1.VulnerabilityOccurrence.PackageIssue)
+            ),
+        ),
+        DESCRIPTOR=_VULNERABILITYOCCURRENCE,
+        __module__="grafeas_v1.proto.vulnerability_pb2",
+        __doc__="""An occurrence of a severity vulnerability on a resource.
+  
+  
+  Attributes:
+      type:
+          The type of package; whether native or non native (e.g., ruby
+          gems, node.js packages, etc.).
+      severity:
+          Output only. The note provider assigned severity of this
+          vulnerability.
+      cvss_score:
+          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.
+      package_issue:
+          Required. The set of affected locations and their fixes (if
+          available) within the associated resource.
+      short_description:
+          Output only. A one sentence description of this vulnerability.
+      long_description:
+          Output only. A detailed description of this vulnerability.
+      related_urls:
+          Output only. URLs related to this vulnerability.
+      effective_severity:
+          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.
+      fix_available:
+          Output only. Whether at least one of the affected packages has
+          a fix available.
+  """,
+        # @@protoc_insertion_point(class_scope:grafeas.v1.VulnerabilityOccurrence)
+    ),
+)
+_sym_db.RegisterMessage(VulnerabilityOccurrence)
+_sym_db.RegisterMessage(VulnerabilityOccurrence.PackageIssue)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/grafeas/grafeas/grafeas_v1/proto/vulnerability_pb2_grpc.py b/grafeas/grafeas/grafeas_v1/proto/vulnerability_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/proto/vulnerability_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/grafeas/grafeas/grafeas_v1/types.py b/grafeas/grafeas/grafeas_v1/types.py
new file mode 100644
index 000000000000..253b6cadc65f
--- /dev/null
+++ b/grafeas/grafeas/grafeas_v1/types.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from grafeas.grafeas_v1.proto import attestation_pb2
+from grafeas.grafeas_v1.proto import build_pb2
+from grafeas.grafeas_v1.proto import common_pb2
+from grafeas.grafeas_v1.proto import cvss_pb2
+from grafeas.grafeas_v1.proto import deployment_pb2
+from grafeas.grafeas_v1.proto import discovery_pb2
+from grafeas.grafeas_v1.proto import grafeas_pb2
+from grafeas.grafeas_v1.proto import image_pb2
+from grafeas.grafeas_v1.proto import package_pb2
+from grafeas.grafeas_v1.proto import provenance_pb2
+from grafeas.grafeas_v1.proto import vulnerability_pb2
+
+
+_shared_modules = [any_pb2, empty_pb2, field_mask_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [
+    attestation_pb2,
+    build_pb2,
+    common_pb2,
+    cvss_pb2,
+    deployment_pb2,
+    discovery_pb2,
+    grafeas_pb2,
+    image_pb2,
+    package_pb2,
+    provenance_pb2,
+    vulnerability_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "grafeas.grafeas_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/grafeas/noxfile.py b/grafeas/noxfile.py
new file mode 100644
index 000000000000..cc5bea5ec83a
--- /dev/null
+++ b/grafeas/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "grafeas",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "grafeas", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "grafeas",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=grafeas",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=78",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=78")
+
+    session.run("coverage", "erase")
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install('-e', '.')
+    session.install('sphinx', 'alabaster', 'recommonmark')
+
+    shutil.rmtree(os.path.join('docs', '_build'), ignore_errors=True)
+    session.run(
+        'sphinx-build',
+        '-W',  # warnings as errors
+        '-T',  # show full traceback on exception
+        '-N',  # no colors
+        '-b', 'html',
+        '-d', os.path.join('docs', '_build', 'doctrees', ''),
+        os.path.join('docs', ''),
+        os.path.join('docs', '_build', 'html', ''),
+    )
diff --git a/grafeas/setup.cfg b/grafeas/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/grafeas/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/grafeas/setup.py b/grafeas/setup.py
new file mode 100644
index 000000000000..62fbae2dc527
--- /dev/null
+++ b/grafeas/setup.py
@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "grafeas"
+description = "Grafeas API client library"
+version = "0.2.0"
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("grafeas")
+]
+
+namespaces = ["grafeas"]
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/grafeas/synth.metadata b/grafeas/synth.metadata
new file mode 100644
index 000000000000..0c0938c03e84
--- /dev/null
+++ b/grafeas/synth.metadata
@@ -0,0 +1,38 @@
+{
+  "updateTime": "2019-08-06T18:36:30.465284Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "53e641721f965a485af64331cfea9e5522294d78"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "grafeas",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "grafeas/artman_grafeas_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/grafeas/synth.py b/grafeas/synth.py
new file mode 100644
index 000000000000..74bfcd9d64d1
--- /dev/null
+++ b/grafeas/synth.py
@@ -0,0 +1,358 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate Grafeas GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "grafeas", "v1", config_path="/grafeas/artman_grafeas_v1.yaml", include_protos=True
+)
+
+excludes = ["README.rst", "nox.py", "setup.py", "docs/index.rst"]
+
+# Make 'grafeas' a namespace
+s.move(library / "grafeas", excludes=["__init__.py"])
+s.move(library / "docs", excludes=["conf.py", "index.rst"])
+s.move(
+    library / "google/cloud/grafeas_v1/proto",
+    "grafeas/grafeas_v1/proto",
+    excludes=excludes,
+)
+s.move(library / "tests")
+
+
+# Fix proto imports
+s.replace(
+    ["grafeas/**/*.py", "tests/**/*.py"],
+    "from grafeas\.v1( import \w*_pb2)",
+    "from grafeas.grafeas_v1.proto\g<1>",
+)
+s.replace(
+    "grafeas/**/*_pb2.py",
+    "from grafeas_v1\.proto( import \w*_pb2)",
+    "from grafeas.grafeas_v1.proto\g<1>",
+)
+s.replace(
+    "grafeas/**/grafeas_pb2_grpc.py",
+    "from grafeas_v1\.proto",
+    "from grafeas.grafeas_v1.proto",
+)
+
+# Make package name 'grafeas'
+s.replace(
+    "grafeas/grafeas_v1/gapic/grafeas_client.py", "google-cloud-grafeas", "grafeas"
+)
+
+# Fix docstrings with no summary lines
+s.replace(
+    "grafeas/grafeas_v1/proto/vulnerability_pb2.py",
+    r"""(\s+)__doc__ = \"\"\"Attributes:""",
+    """\g<1>__doc__=\"\"\"
+    Attributes:""",
+)
+
+# Replace mentions of 'Container Analysis' with 'Grafeas' in the docs
+s.replace("docs/**/v*/*.rst", "Container Analysis", "Grafeas")
+
+
+# ----------------------------------------------------------------------------
+# Remove google-specific portions of library
+# ----------------------------------------------------------------------------
+
+# Please see this PR https://github.com/googleapis/google-cloud-python/pull/8186/
+
+# Remove default service address, default scopes, default credentials
+# Update tests and code in docstrings showing client instantiation.
+
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""    SERVICE_ADDRESS = 'containeranalysis\.googleapis\.com:443'
+    \"\"\"The default address of the service\.\"\"\"""",
+    "",
+)
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""    def __init__\(self, transport=None, channel=None, credentials=None,
+            client_config=None, client_info=None, client_options=None\):""",
+    "    def __init__(self, transport, client_config=None, client_info=None):",
+)
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""Union\[~\.GrafeasGrpcTransport,
+                    Callable\[\[~\.Credentials, type], ~\.GrafeasGrpcTransport\]""",
+    """~.GrafeasGrpcTransport""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""            channel \(grpc\.Channel\): DEPRECATED\. A ``Channel`` instance
+                through which to make calls\. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception\.
+            credentials \(google\.auth\.credentials\.Credentials\): The
+                authorization credentials to attach to requests\. These
+                credentials identify this application to the service\. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment\.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception\.""",
+    "",
+)
+
+# Remove client_options
+# api_endpoint is currently the only option and doesn't make sense for Grafeas.
+s.replace("grafeas/**/grafeas_client.py", "import google.api_core.client_options\n", "")
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""            client_options \(Union\[dict, google\.api_core\.client_options\.ClientOptions\]\):
+                Client options used to set user options on the client\. API Endpoint
+                should be set through client_options\.
+        \"\"\"""",
+    "        \"\"\""
+)
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""if channel:
+            warnings\.warn\('The `channel` argument is deprecated; use '
+                          '`transport` instead\.',
+                          PendingDeprecationWarning, stacklevel=2\)
+
+        api_endpoint = self\.SERVICE_ADDRESS
+        if client_options:
+            if type\(client_options\) == dict:
+                client_options = google\.api_core\.client_options\.from_dict\(client_options\)
+            if client_options\.api_endpoint:
+                api_endpoint = client_options\.api_endpoint
+
+        \# Instantiate the transport\.
+        \# The transport is responsible for handling serialization and
+        \# deserialization and actually sending data to the service\.
+        if transport:
+            if callable\(transport\):
+                self\.transport = transport\(
+                    credentials=credentials,
+                    default_class=grafeas_grpc_transport\.GrafeasGrpcTransport,
+                    address=api_endpoint,
+                \)
+            else:
+                if credentials:
+                    raise ValueError\(
+                        'Received both a transport instance and '
+                        'credentials; these are mutually exclusive\.'
+                    \)
+                self\.transport = transport
+        else:
+            self\.transport = grafeas_grpc_transport\.GrafeasGrpcTransport\(
+                address=api_endpoint,
+                channel=channel,
+                credentials=credentials,
+            \)""",
+    """# Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        self.transport = transport""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r"""        Example:
+            >>> from grafeas import grafeas_v1
+            >>>
+            >>> client = grafeas_v1\.GrafeasClient\(\)""",
+    """        Example:
+            >>> from grafeas import grafeas_v1
+            >>> from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+            >>> 
+            >>> address = "[SERVICE_ADDRESS]"
+            >>> scopes = ("[SCOPE]")
+            >>> transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+            >>> client = grafeas_v1.GrafeasClient(transport)""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_client.py",
+    r'''    @classmethod
+    def from_service_account_file\(cls, filename, \*args, \*\*kwargs\):
+        """Creates an instance of this client using the provided credentials
+        file\.
+
+        Args:
+            filename \(str\): The path to the service account private key json
+                file\.
+            args: Additional arguments to pass to the constructor\.
+            kwargs: Additional arguments to pass to the constructor\.
+
+        Returns:
+            GrafeasClient: The constructed client\.
+        """
+        credentials = service_account\.Credentials\.from_service_account_file\(
+            filename\)
+        kwargs\['credentials'\] = credentials
+        return cls\(\*args, \*\*kwargs\)
+
+    from_service_account_json = from_service_account_file''',
+    "")
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""    \# The scopes needed to make gRPC calls to all of the methods defined
+    \# in this service\.
+    _OAUTH_SCOPES = \(
+        'https://www\.googleapis\.com/auth/cloud-platform',
+    \)""",
+    "",
+)
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""    def __init__\(self, channel=None, credentials=None,
+                 address='containeranalysis\.googleapis\.com:443'\):""",
+    """    def __init__(self, address, scopes, channel=None, credentials=None):""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""        \# Create the channel\.
+        if channel is None:
+            channel = self\.create_channel\(
+                address=address,
+                credentials=credentials,
+""",
+    """        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address,
+                scopes,
+                credentials=credentials,
+""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""    def create_channel\(
+                cls,
+                address='containeranalysis\.googleapis\.com:443',
+                credentials=None,
+                \*\*kwargs\):""",
+    """    def create_channel(
+                cls,
+                address,
+                scopes,
+                credentials=None,
+                **kwargs):""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""        Args:
+            address \(str\): The host for the channel to use\.
+            credentials \(~\.Credentials\): The
+                authorization credentials to attach to requests\. These
+                credentials identify this application to the service\. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment\.""",
+    """        Args:
+            address (str): The host for the channel to use.
+            scopes (Sequence[str]): The scopes needed to make gRPC calls.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""        return google\.api_core\.grpc_helpers\.create_channel\(
+            address,
+            credentials=credentials,
+            scopes=cls\._OAUTH_SCOPES,
+            \*\*kwargs
+        \)""",
+    """        return google.api_core.grpc_helpers.create_channel(
+            address,
+            credentials=credentials,
+            scopes=scopes,
+            **kwargs
+        )""",
+)
+
+s.replace(
+    "grafeas/**/grafeas_grpc_transport.py",
+    r"""        \"\"\"Instantiate the transport class\.
+
+        Args:
+            channel \(grpc\.Channel\): A ``Channel`` instance through
+                which to make calls\. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception\.
+            credentials \(google\.auth\.credentials\.Credentials\): The
+                authorization credentials to attach to requests\. These
+                credentials identify this application to the service\. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment\.
+            address \(str\): The address where the service is hosted\.""",
+    '''        """Instantiate the transport class.
+
+        Args:
+            address (str): The address where the service is hosted.
+            scopes (Sequence[str]): The scopes needed to make gRPC calls.
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+        ''',
+)
+
+s.replace(
+    "tests/**/test_grafeas_client_v1.py",
+    r"""from grafeas\.grafeas_v1\.proto import grafeas_pb2""",
+    r"""from grafeas.grafeas_v1.proto import grafeas_pb2
+from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport""",
+)
+
+s.replace(
+    "tests/**/test_grafeas_client_v1.py",
+    r"(\s+)client = grafeas_v1\.GrafeasClient\(\)",
+    r"""\g<1>address = "[SERVICE_ADDRESS]"
+\g<1>scopes = ("SCOPE")
+\g<1>transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+\g<1>client=grafeas_v1.GrafeasClient(transport)""",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=78, cov_level=78)
+s.move(templated_files, excludes=["noxfile.py"])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/grafeas/tests/unit/gapic/v1/test_grafeas_client_v1.py b/grafeas/tests/unit/gapic/v1/test_grafeas_client_v1.py
new file mode 100644
index 000000000000..74613726dc5b
--- /dev/null
+++ b/grafeas/tests/unit/gapic/v1/test_grafeas_client_v1.py
@@ -0,0 +1,842 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.protobuf import empty_pb2
+from grafeas import grafeas_v1
+from grafeas.grafeas_v1.proto import grafeas_pb2
+from grafeas.grafeas_v1.gapic.transports import grafeas_grpc_transport
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestGrafeasClient(object):
+    def test_get_occurrence(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        resource_uri = "resourceUri-384040517"
+        note_name = "noteName1780787896"
+        remediation = "remediation779381797"
+        expected_response = {
+            "name": name_2,
+            "resource_uri": resource_uri,
+            "note_name": note_name,
+            "remediation": remediation,
+        }
+        expected_response = grafeas_pb2.Occurrence(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+
+        response = client.get_occurrence(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.GetOccurrenceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_occurrence_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+
+        with pytest.raises(CustomException):
+            client.get_occurrence(name)
+
+    def test_list_occurrences(self):
+        # Setup Expected Response
+        next_page_token = ""
+        occurrences_element = {}
+        occurrences = [occurrences_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "occurrences": occurrences,
+        }
+        expected_response = grafeas_pb2.ListOccurrencesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_occurrences(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.occurrences[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.ListOccurrencesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_occurrences_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_occurrences(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_occurrence(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+
+        client.delete_occurrence(name)
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.DeleteOccurrenceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_occurrence_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+
+        with pytest.raises(CustomException):
+            client.delete_occurrence(name)
+
+    def test_create_occurrence(self):
+        # Setup Expected Response
+        name = "name3373707"
+        resource_uri = "resourceUri-384040517"
+        note_name = "noteName1780787896"
+        remediation = "remediation779381797"
+        expected_response = {
+            "name": name,
+            "resource_uri": resource_uri,
+            "note_name": note_name,
+            "remediation": remediation,
+        }
+        expected_response = grafeas_pb2.Occurrence(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        occurrence = {}
+
+        response = client.create_occurrence(parent, occurrence)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.CreateOccurrenceRequest(
+            parent=parent, occurrence=occurrence
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_occurrence_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        occurrence = {}
+
+        with pytest.raises(CustomException):
+            client.create_occurrence(parent, occurrence)
+
+    def test_batch_create_occurrences(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = grafeas_pb2.BatchCreateOccurrencesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        occurrences = []
+
+        response = client.batch_create_occurrences(parent, occurrences)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.BatchCreateOccurrencesRequest(
+            parent=parent, occurrences=occurrences
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_create_occurrences_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        occurrences = []
+
+        with pytest.raises(CustomException):
+            client.batch_create_occurrences(parent, occurrences)
+
+    def test_update_occurrence(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        resource_uri = "resourceUri-384040517"
+        note_name = "noteName1780787896"
+        remediation = "remediation779381797"
+        expected_response = {
+            "name": name_2,
+            "resource_uri": resource_uri,
+            "note_name": note_name,
+            "remediation": remediation,
+        }
+        expected_response = grafeas_pb2.Occurrence(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+        occurrence = {}
+
+        response = client.update_occurrence(name, occurrence)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.UpdateOccurrenceRequest(
+            name=name, occurrence=occurrence
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_occurrence_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+        occurrence = {}
+
+        with pytest.raises(CustomException):
+            client.update_occurrence(name, occurrence)
+
+    def test_get_occurrence_note(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        short_description = "shortDescription-235369287"
+        long_description = "longDescription-1747792199"
+        expected_response = {
+            "name": name_2,
+            "short_description": short_description,
+            "long_description": long_description,
+        }
+        expected_response = grafeas_pb2.Note(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+
+        response = client.get_occurrence_note(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.GetOccurrenceNoteRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_occurrence_note_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.occurrence_path("[PROJECT]", "[OCCURRENCE]")
+
+        with pytest.raises(CustomException):
+            client.get_occurrence_note(name)
+
+    def test_get_note(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        short_description = "shortDescription-235369287"
+        long_description = "longDescription-1747792199"
+        expected_response = {
+            "name": name_2,
+            "short_description": short_description,
+            "long_description": long_description,
+        }
+        expected_response = grafeas_pb2.Note(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+
+        response = client.get_note(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.GetNoteRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_note_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+
+        with pytest.raises(CustomException):
+            client.get_note(name)
+
+    def test_list_notes(self):
+        # Setup Expected Response
+        next_page_token = ""
+        notes_element = {}
+        notes = [notes_element]
+        expected_response = {"next_page_token": next_page_token, "notes": notes}
+        expected_response = grafeas_pb2.ListNotesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_notes(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.notes[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.ListNotesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_notes_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_notes(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_note(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+
+        client.delete_note(name)
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.DeleteNoteRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_note_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+
+        with pytest.raises(CustomException):
+            client.delete_note(name)
+
+    def test_create_note(self):
+        # Setup Expected Response
+        name = "name3373707"
+        short_description = "shortDescription-235369287"
+        long_description = "longDescription-1747792199"
+        expected_response = {
+            "name": name,
+            "short_description": short_description,
+            "long_description": long_description,
+        }
+        expected_response = grafeas_pb2.Note(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        note_id = "noteId2129224840"
+        note = {}
+
+        response = client.create_note(parent, note_id, note)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.CreateNoteRequest(
+            parent=parent, note_id=note_id, note=note
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_note_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        note_id = "noteId2129224840"
+        note = {}
+
+        with pytest.raises(CustomException):
+            client.create_note(parent, note_id, note)
+
+    def test_batch_create_notes(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = grafeas_pb2.BatchCreateNotesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        notes = {}
+
+        response = client.batch_create_notes(parent, notes)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.BatchCreateNotesRequest(
+            parent=parent, notes=notes
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_create_notes_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        notes = {}
+
+        with pytest.raises(CustomException):
+            client.batch_create_notes(parent, notes)
+
+    def test_update_note(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        short_description = "shortDescription-235369287"
+        long_description = "longDescription-1747792199"
+        expected_response = {
+            "name": name_2,
+            "short_description": short_description,
+            "long_description": long_description,
+        }
+        expected_response = grafeas_pb2.Note(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+        note = {}
+
+        response = client.update_note(name, note)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.UpdateNoteRequest(name=name, note=note)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_note_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+        note = {}
+
+        with pytest.raises(CustomException):
+            client.update_note(name, note)
+
+    def test_list_note_occurrences(self):
+        # Setup Expected Response
+        next_page_token = ""
+        occurrences_element = {}
+        occurrences = [occurrences_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "occurrences": occurrences,
+        }
+        expected_response = grafeas_pb2.ListNoteOccurrencesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup Request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+
+        paged_list_response = client.list_note_occurrences(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.occurrences[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = grafeas_pb2.ListNoteOccurrencesRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_note_occurrences_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            address = "[SERVICE_ADDRESS]"
+
+            scopes = "SCOPE"
+
+            transport = grafeas_grpc_transport.GrafeasGrpcTransport(address, scopes)
+
+            client = grafeas_v1.GrafeasClient(transport)
+
+        # Setup request
+        name = client.note_path("[PROJECT]", "[NOTE]")
+
+        paged_list_response = client.list_note_occurrences(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/iam/.coveragerc b/iam/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/iam/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/iam/.flake8 b/iam/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/iam/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/iam/.repo-metadata.json b/iam/.repo-metadata.json
new file mode 100644
index 000000000000..cc00a9a4ae1d
--- /dev/null
+++ b/iam/.repo-metadata.json
@@ -0,0 +1,12 @@
+{
+  "name": "iamcredentials",
+  "name_pretty": "Cloud Identity and Access Management",
+  "product_documentation": "https://cloud.google.com/iam/docs/",
+  "client_documentation": "https://googleapis.dev/python/iamcredentials/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559761",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-iam",
+  "api_id": "iamcredentials.googleapis.com",
+}
\ No newline at end of file
diff --git a/iam/CHANGELOG.md b/iam/CHANGELOG.md
new file mode 100644
index 000000000000..a8ec84203fcc
--- /dev/null
+++ b/iam/CHANGELOG.md
@@ -0,0 +1,73 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-iam/#history
+
+## 0.2.1
+
+08-23-2019 10:10 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8936](https://github.com/googleapis/google-cloud-python/pull/8936))
+
+### Documentation
+- Fix documentation links for iam and error-reporting. ([#9073](https://github.com/googleapis/google-cloud-python/pull/9073))
+- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.2.0
+
+07-24-2019 16:22 PDT
+
+
+### Implementation Changes
+- Remove generate_identity_binding_access_token (via synth). ([#8486](https://github.com/googleapis/google-cloud-python/pull/8486))
+- Allow kwargs to be passed to create_channel (via synth). ([#8392](https://github.com/googleapis/google-cloud-python/pull/8392))
+- Add routing header to method metadata, format docstrings, update docs configuration (via synth). ([#7595](https://github.com/googleapis/google-cloud-python/pull/7595))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Remove unused message exports. ([#7268](https://github.com/googleapis/google-cloud-python/pull/7268))
+- Protoc-generated serialization update. ([#7084](https://github.com/googleapis/google-cloud-python/pull/7084))
+- Protoc-generated serialization update. ([#7052](https://github.com/googleapis/google-cloud-python/pull/7052))
+- Pick up stub docstring fix in GAPIC generator. ([#6972](https://github.com/googleapis/google-cloud-python/pull/6972))
+
+### New Features
+- Add 'client_options' support (via synth).  ([#8511](https://github.com/googleapis/google-cloud-python/pull/8511))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fix client lib docs link in README. ([#7813](https://github.com/googleapis/google-cloud-python/pull/7813))
+- Update copyright: 2018 -> 2019. ([#7146](https://github.com/googleapis/google-cloud-python/pull/7146))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8584](https://github.com/googleapis/google-cloud-python/pull/8584))
+- Add nox session 'docs' to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). [#8353](https://github.com/googleapis/google-cloud-python/pull/8353))
+- Add disclaimer to auto-generated template files (via synth). ([#8315](https://github.com/googleapis/google-cloud-python/pull/8315))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8242](https://github.com/googleapis/google-cloud-python/pull/8242))
+- Fix coverage in 'types.py' (via synth). ([#8154](https://github.com/googleapis/google-cloud-python/pull/8154))
+- Blacken noxfile.py, setup.py (via synth). ([#8124](https://github.com/googleapis/google-cloud-python/pull/8124))
+- Add empty lines (via synth). ([#8059](https://github.com/googleapis/google-cloud-python/pull/8059))
+- Add nox session `docs` (via synth). ([#7772](https://github.com/googleapis/google-cloud-python/pull/7772))
+- Copy lintified proto files (via synth). ([#7467](https://github.com/googleapis/google-cloud-python/pull/7467))
+- Add clarifying comment to blacken nox target. ([#7393](https://github.com/googleapis/google-cloud-python/pull/7393))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.1.0
+
+12-13-2018 10:55 PST
+
+
+### New Features
+- Add Client Library for IAM ([#6905](https://github.com/googleapis/google-cloud-python/pull/6905))
+
+### Documentation
+- Fix docs build ([#6913](https://github.com/googleapis/google-cloud-python/pull/6913))
+
+### Internal / Testing Changes
+- trove classifier fix ([#6922](https://github.com/googleapis/google-cloud-python/pull/6922))
diff --git a/iam/LICENSE b/iam/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/iam/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/iam/MANIFEST.in b/iam/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/iam/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/iam/README.rst b/iam/README.rst
new file mode 100644
index 000000000000..6f439c39a1f2
--- /dev/null
+++ b/iam/README.rst
@@ -0,0 +1,85 @@
+Python Client for IAM API (`Alpha`_)
+================================================================
+
+
+
+`IAM API`_: IAM API
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _IAM API: https://cloud.google.com/iam
+.. _Client Library Documentation: https://googleapis.dev/python/iamcredentials/latest
+.. _Product Documentation:  https://cloud.google.com/iam
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the IAM API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the IAM API.:  https://console.cloud.google.com/flows/enableapi?apiid=iam
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-iam
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-iam
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for IAM API
+   API to see other available methods on the client.
+-  Read the `IAM API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _IAM API Product documentation:  https://cloud.google.com/iam
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/iam/docs/README.rst b/iam/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/iam/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/iam/docs/changelog.md b/iam/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/iam/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/iam/docs/conf.py b/iam/docs/conf.py
new file mode 100644
index 000000000000..475dc68424c1
--- /dev/null
+++ b/iam/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-iam documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-iam"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-iam-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-iam.tex",
+        u"google-cloud-iam Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-iam", u"google-cloud-iam Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-iam",
+        u"google-cloud-iam Documentation",
+        author,
+        "google-cloud-iam",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/iam/docs/gapic/v1/api.rst b/iam/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..898390081ea9
--- /dev/null
+++ b/iam/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for IAM Service Account Credentials API
+==============================================
+
+.. automodule:: google.cloud.iam_credentials_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/iam/docs/gapic/v1/types.rst b/iam/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..a80cc353174d
--- /dev/null
+++ b/iam/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for IAM Service Account Credentials API Client
+====================================================
+
+.. automodule:: google.cloud.iam_credentials_v1.types
+    :members:
\ No newline at end of file
diff --git a/iam/docs/index.rst b/iam/docs/index.rst
new file mode 100644
index 000000000000..882915fa7d73
--- /dev/null
+++ b/iam/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1/api
+   gapic/v1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-iam`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/iam/google/__init__.py b/iam/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/iam/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/iam/google/cloud/__init__.py b/iam/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/iam/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/iam/google/cloud/iam_credentials.py b/iam/google/cloud/iam_credentials.py
new file mode 100644
index 000000000000..db9dc42d2ed9
--- /dev/null
+++ b/iam/google/cloud/iam_credentials.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.iam_credentials_v1 import IAMCredentialsClient
+from google.cloud.iam_credentials_v1 import types
+
+
+__all__ = ("types", "IAMCredentialsClient")
diff --git a/iam/google/cloud/iam_credentials_v1/__init__.py b/iam/google/cloud/iam_credentials_v1/__init__.py
new file mode 100644
index 000000000000..f9937de935f6
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/__init__.py
@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.iam_credentials_v1 import types
+from google.cloud.iam_credentials_v1.gapic import iam_credentials_client
+
+
+class IAMCredentialsClient(iam_credentials_client.IAMCredentialsClient):
+    __doc__ = iam_credentials_client.IAMCredentialsClient.__doc__
+
+
+__all__ = ("types", "IAMCredentialsClient")
diff --git a/iam/google/cloud/iam_credentials_v1/gapic/__init__.py b/iam/google/cloud/iam_credentials_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/iam/google/cloud/iam_credentials_v1/gapic/iam_credentials_client.py b/iam/google/cloud/iam_credentials_v1/gapic/iam_credentials_client.py
new file mode 100644
index 000000000000..f7c0c94c4fc9
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/gapic/iam_credentials_client.py
@@ -0,0 +1,574 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.iam.credentials.v1 IAMCredentials API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.iam_credentials_v1.gapic import iam_credentials_client_config
+from google.cloud.iam_credentials_v1.gapic.transports import (
+    iam_credentials_grpc_transport,
+)
+from google.cloud.iam_credentials_v1.proto import common_pb2
+from google.cloud.iam_credentials_v1.proto import iamcredentials_pb2_grpc
+from google.protobuf import duration_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-iam").version
+
+
+class IAMCredentialsClient(object):
+    """
+    A service account is a special type of Google account that belongs to your
+    application or a virtual machine (VM), instead of to an individual end user.
+    Your application assumes the identity of the service account to call Google
+    APIs, so that the users aren't directly involved.
+
+    Service account credentials are used to temporarily assume the identity
+    of the service account. Supported credential types include OAuth 2.0 access
+    tokens, OpenID Connect ID tokens, self-signed JSON Web Tokens (JWTs), and
+    more.
+    """
+
+    SERVICE_ADDRESS = "iamcredentials.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.iam.credentials.v1.IAMCredentials"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            IAMCredentialsClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def service_account_path(cls, project, service_account):
+        """Return a fully-qualified service_account string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/serviceAccounts/{service_account}",
+            project=project,
+            service_account=service_account,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.IamCredentialsGrpcTransport,
+                    Callable[[~.Credentials, type], ~.IamCredentialsGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = iam_credentials_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=iam_credentials_grpc_transport.IamCredentialsGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = iam_credentials_grpc_transport.IamCredentialsGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def generate_access_token(
+        self,
+        name,
+        scope,
+        delegates=None,
+        lifetime=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Generates an OAuth 2.0 access token for a service account.
+
+        Example:
+            >>> from google.cloud import iam_credentials_v1
+            >>>
+            >>> client = iam_credentials_v1.IAMCredentialsClient()
+            >>>
+            >>> name = client.service_account_path('[PROJECT]', '[SERVICE_ACCOUNT]')
+            >>>
+            >>> # TODO: Initialize `scope`:
+            >>> scope = []
+            >>>
+            >>> response = client.generate_access_token(name, scope)
+
+        Args:
+            name (str): The resource name of the service account for which the credentials are
+                requested, in the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+            scope (list[str]): 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.
+            delegates (list[str]): The sequence of service accounts in a delegation chain. Each service
+                account must be granted the ``roles/iam.serviceAccountTokenCreator``
+                role on its next service account in the chain. The last service account
+                in the chain must be granted the
+                ``roles/iam.serviceAccountTokenCreator`` role on the service account
+                that is specified in the ``name`` field of the request.
+
+                The delegates must have the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+            lifetime (Union[dict, ~google.cloud.iam_credentials_v1.types.Duration]): 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
+                not specified, the token's lifetime will be set to a default value of one
+                hour.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iam_credentials_v1.types.Duration`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iam_credentials_v1.types.GenerateAccessTokenResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "generate_access_token" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "generate_access_token"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.generate_access_token,
+                default_retry=self._method_configs["GenerateAccessToken"].retry,
+                default_timeout=self._method_configs["GenerateAccessToken"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = common_pb2.GenerateAccessTokenRequest(
+            name=name, scope=scope, delegates=delegates, lifetime=lifetime
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["generate_access_token"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def generate_id_token(
+        self,
+        name,
+        audience,
+        delegates=None,
+        include_email=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Generates an OpenID Connect ID token for a service account.
+
+        Example:
+            >>> from google.cloud import iam_credentials_v1
+            >>>
+            >>> client = iam_credentials_v1.IAMCredentialsClient()
+            >>>
+            >>> name = client.service_account_path('[PROJECT]', '[SERVICE_ACCOUNT]')
+            >>>
+            >>> # TODO: Initialize `audience`:
+            >>> audience = ''
+            >>>
+            >>> response = client.generate_id_token(name, audience)
+
+        Args:
+            name (str): The resource name of the service account for which the credentials are
+                requested, in the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+            audience (str): The audience for the token, such as the API or account that this token
+                grants access to.
+            delegates (list[str]): The sequence of service accounts in a delegation chain. Each service
+                account must be granted the ``roles/iam.serviceAccountTokenCreator``
+                role on its next service account in the chain. The last service account
+                in the chain must be granted the
+                ``roles/iam.serviceAccountTokenCreator`` role on the service account
+                that is specified in the ``name`` field of the request.
+
+                The delegates must have the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+            include_email (bool): Include the service account email in the token. If set to ``true``, the
+                token will contain ``email`` and ``email_verified`` claims.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iam_credentials_v1.types.GenerateIdTokenResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "generate_id_token" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "generate_id_token"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.generate_id_token,
+                default_retry=self._method_configs["GenerateIdToken"].retry,
+                default_timeout=self._method_configs["GenerateIdToken"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = common_pb2.GenerateIdTokenRequest(
+            name=name,
+            audience=audience,
+            delegates=delegates,
+            include_email=include_email,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["generate_id_token"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def sign_blob(
+        self,
+        name,
+        payload,
+        delegates=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Signs a blob using a service account's system-managed private key.
+
+        Example:
+            >>> from google.cloud import iam_credentials_v1
+            >>>
+            >>> client = iam_credentials_v1.IAMCredentialsClient()
+            >>>
+            >>> name = client.service_account_path('[PROJECT]', '[SERVICE_ACCOUNT]')
+            >>>
+            >>> # TODO: Initialize `payload`:
+            >>> payload = b''
+            >>>
+            >>> response = client.sign_blob(name, payload)
+
+        Args:
+            name (str): The resource name of the service account for which the credentials are
+                requested, in the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+            payload (bytes): The bytes to sign.
+            delegates (list[str]): The sequence of service accounts in a delegation chain. Each service
+                account must be granted the ``roles/iam.serviceAccountTokenCreator``
+                role on its next service account in the chain. The last service account
+                in the chain must be granted the
+                ``roles/iam.serviceAccountTokenCreator`` role on the service account
+                that is specified in the ``name`` field of the request.
+
+                The delegates must have the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iam_credentials_v1.types.SignBlobResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "sign_blob" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "sign_blob"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.sign_blob,
+                default_retry=self._method_configs["SignBlob"].retry,
+                default_timeout=self._method_configs["SignBlob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = common_pb2.SignBlobRequest(
+            name=name, payload=payload, delegates=delegates
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["sign_blob"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def sign_jwt(
+        self,
+        name,
+        payload,
+        delegates=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Signs a JWT using a service account's system-managed private key.
+
+        Example:
+            >>> from google.cloud import iam_credentials_v1
+            >>>
+            >>> client = iam_credentials_v1.IAMCredentialsClient()
+            >>>
+            >>> name = client.service_account_path('[PROJECT]', '[SERVICE_ACCOUNT]')
+            >>>
+            >>> # TODO: Initialize `payload`:
+            >>> payload = ''
+            >>>
+            >>> response = client.sign_jwt(name, payload)
+
+        Args:
+            name (str): The resource name of the service account for which the credentials are
+                requested, in the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+            payload (str): The JWT payload to sign: a JSON object that contains a JWT Claims Set.
+            delegates (list[str]): The sequence of service accounts in a delegation chain. Each service
+                account must be granted the ``roles/iam.serviceAccountTokenCreator``
+                role on its next service account in the chain. The last service account
+                in the chain must be granted the
+                ``roles/iam.serviceAccountTokenCreator`` role on the service account
+                that is specified in the ``name`` field of the request.
+
+                The delegates must have the following format:
+                ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iam_credentials_v1.types.SignJwtResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "sign_jwt" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "sign_jwt"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.sign_jwt,
+                default_retry=self._method_configs["SignJwt"].retry,
+                default_timeout=self._method_configs["SignJwt"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = common_pb2.SignJwtRequest(
+            name=name, payload=payload, delegates=delegates
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["sign_jwt"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/iam/google/cloud/iam_credentials_v1/gapic/iam_credentials_client_config.py b/iam/google/cloud/iam_credentials_v1/gapic/iam_credentials_client_config.py
new file mode 100644
index 000000000000..35c007ca367f
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/gapic/iam_credentials_client_config.py
@@ -0,0 +1,43 @@
+config = {
+    "interfaces": {
+        "google.iam.credentials.v1.IAMCredentials": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "GenerateAccessToken": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GenerateIdToken": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SignBlob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SignJwt": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/iam/google/cloud/iam_credentials_v1/gapic/transports/__init__.py b/iam/google/cloud/iam_credentials_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/iam/google/cloud/iam_credentials_v1/gapic/transports/iam_credentials_grpc_transport.py b/iam/google/cloud/iam_credentials_v1/gapic/transports/iam_credentials_grpc_transport.py
new file mode 100644
index 000000000000..7152d17f8620
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/gapic/transports/iam_credentials_grpc_transport.py
@@ -0,0 +1,163 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.iam_credentials_v1.proto import iamcredentials_pb2_grpc
+
+
+class IamCredentialsGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.iam.credentials.v1 IAMCredentials API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="iamcredentials.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "iam_credentials_stub": iamcredentials_pb2_grpc.IAMCredentialsStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="iamcredentials.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def generate_access_token(self):
+        """Return the gRPC stub for :meth:`IAMCredentialsClient.generate_access_token`.
+
+        Generates an OAuth 2.0 access token for a service account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_credentials_stub"].GenerateAccessToken
+
+    @property
+    def generate_id_token(self):
+        """Return the gRPC stub for :meth:`IAMCredentialsClient.generate_id_token`.
+
+        Generates an OpenID Connect ID token for a service account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_credentials_stub"].GenerateIdToken
+
+    @property
+    def sign_blob(self):
+        """Return the gRPC stub for :meth:`IAMCredentialsClient.sign_blob`.
+
+        Signs a blob using a service account's system-managed private key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_credentials_stub"].SignBlob
+
+    @property
+    def sign_jwt(self):
+        """Return the gRPC stub for :meth:`IAMCredentialsClient.sign_jwt`.
+
+        Signs a JWT using a service account's system-managed private key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_credentials_stub"].SignJwt
diff --git a/iam/google/cloud/iam_credentials_v1/proto/__init__.py b/iam/google/cloud/iam_credentials_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/iam/google/cloud/iam_credentials_v1/proto/common.proto b/iam/google/cloud/iam_credentials_v1/proto/common.proto
new file mode 100644
index 000000000000..6ba010199476
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/proto/common.proto
@@ -0,0 +1,154 @@
+// 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.iam.credentials.v1;
+
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/iam/credentials/v1;credentials";
+option java_multiple_files = true;
+option java_outer_classname = "IAMCredentialsCommonProto";
+option java_package = "com.google.cloud.iam.credentials.v1";
+
+message GenerateAccessTokenRequest {
+  // 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;
+
+  // The sequence of service accounts in a delegation chain. Each service
+  // account must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on its next service account in the chain. The last service account in the
+  // chain must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on the service account that is specified in the `name` field of the
+  // request.
+  //
+  // The delegates must have the following format:
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  repeated string delegates = 2;
+
+  // 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;
+
+  // 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
+  // not specified, the token's lifetime will be set to a default value of one
+  // hour.
+  google.protobuf.Duration lifetime = 7;
+}
+
+message GenerateAccessTokenResponse {
+  // The OAuth 2.0 access token.
+  string access_token = 1;
+
+  // Token expiration time.
+  // The expiration time is always set.
+  google.protobuf.Timestamp expire_time = 3;
+}
+
+message SignBlobRequest {
+  // 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;
+
+  // The sequence of service accounts in a delegation chain. Each service
+  // account must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on its next service account in the chain. The last service account in the
+  // chain must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on the service account that is specified in the `name` field of the
+  // request.
+  //
+  // The delegates must have the following format:
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  repeated string delegates = 3;
+
+  // The bytes to sign.
+  bytes payload = 5;
+}
+
+message SignBlobResponse {
+  // The ID of the key used to sign the blob.
+  string key_id = 1;
+
+  // The signed blob.
+  bytes signed_blob = 4;
+}
+
+message SignJwtRequest {
+  // 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;
+
+  // The sequence of service accounts in a delegation chain. Each service
+  // account must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on its next service account in the chain. The last service account in the
+  // chain must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on the service account that is specified in the `name` field of the
+  // request.
+  //
+  // The delegates must have the following format:
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  repeated string delegates = 3;
+
+  // The JWT payload to sign: a JSON object that contains a JWT Claims Set.
+  string payload = 5;
+}
+
+message SignJwtResponse {
+  // The ID of the key used to sign the JWT.
+  string key_id = 1;
+
+  // The signed JWT.
+  string signed_jwt = 2;
+}
+
+message GenerateIdTokenRequest {
+  // 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;
+
+  // The sequence of service accounts in a delegation chain. Each service
+  // account must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on its next service account in the chain. The last service account in the
+  // chain must be granted the `roles/iam.serviceAccountTokenCreator` role
+  // on the service account that is specified in the `name` field of the
+  // request.
+  //
+  // The delegates must have the following format:
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  repeated string delegates = 2;
+
+  // The audience for the token, such as the API or account that this token
+  // grants access to.
+  string audience = 3;
+
+  // Include the service account email in the token. If set to `true`, the
+  // token will contain `email` and `email_verified` claims.
+  bool include_email = 4;
+}
+
+message GenerateIdTokenResponse {
+  // The OpenId Connect ID token.
+  string token = 1;
+}
diff --git a/iam/google/cloud/iam_credentials_v1/proto/common_pb2.py b/iam/google/cloud/iam_credentials_v1/proto/common_pb2.py
new file mode 100644
index 000000000000..fd259f872b40
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/proto/common_pb2.py
@@ -0,0 +1,810 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/iam/credentials/v1/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/iam/credentials/v1/common.proto",
+    package="google.iam.credentials.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n#com.google.cloud.iam.credentials.v1B\031IAMCredentialsCommonProtoP\001ZDgoogle.golang.org/genproto/googleapis/iam/credentials/v1;credentials\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n&google/iam/credentials/v1/common.proto\x12\x19google.iam.credentials.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"y\n\x1aGenerateAccessTokenRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tdelegates\x18\x02 \x03(\t\x12\r\n\x05scope\x18\x04 \x03(\t\x12+\n\x08lifetime\x18\x07 \x01(\x0b\x32\x19.google.protobuf.Duration"d\n\x1bGenerateAccessTokenResponse\x12\x14\n\x0c\x61\x63\x63\x65ss_token\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"C\n\x0fSignBlobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tdelegates\x18\x03 \x03(\t\x12\x0f\n\x07payload\x18\x05 \x01(\x0c"7\n\x10SignBlobResponse\x12\x0e\n\x06key_id\x18\x01 \x01(\t\x12\x13\n\x0bsigned_blob\x18\x04 \x01(\x0c"B\n\x0eSignJwtRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tdelegates\x18\x03 \x03(\t\x12\x0f\n\x07payload\x18\x05 \x01(\t"5\n\x0fSignJwtResponse\x12\x0e\n\x06key_id\x18\x01 \x01(\t\x12\x12\n\nsigned_jwt\x18\x02 \x01(\t"b\n\x16GenerateIdTokenRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tdelegates\x18\x02 \x03(\t\x12\x10\n\x08\x61udience\x18\x03 \x01(\t\x12\x15\n\rinclude_email\x18\x04 \x01(\x08"(\n\x17GenerateIdTokenResponse\x12\r\n\x05token\x18\x01 \x01(\tB\x8b\x01\n#com.google.cloud.iam.credentials.v1B\x19IAMCredentialsCommonProtoP\x01ZDgoogle.golang.org/genproto/googleapis/iam/credentials/v1;credentials\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_GENERATEACCESSTOKENREQUEST = _descriptor.Descriptor(
+    name="GenerateAccessTokenRequest",
+    full_name="google.iam.credentials.v1.GenerateAccessTokenRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.iam.credentials.v1.GenerateAccessTokenRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delegates",
+            full_name="google.iam.credentials.v1.GenerateAccessTokenRequest.delegates",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="google.iam.credentials.v1.GenerateAccessTokenRequest.scope",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lifetime",
+            full_name="google.iam.credentials.v1.GenerateAccessTokenRequest.lifetime",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=134,
+    serialized_end=255,
+)
+
+
+_GENERATEACCESSTOKENRESPONSE = _descriptor.Descriptor(
+    name="GenerateAccessTokenResponse",
+    full_name="google.iam.credentials.v1.GenerateAccessTokenResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="access_token",
+            full_name="google.iam.credentials.v1.GenerateAccessTokenResponse.access_token",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.iam.credentials.v1.GenerateAccessTokenResponse.expire_time",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=257,
+    serialized_end=357,
+)
+
+
+_SIGNBLOBREQUEST = _descriptor.Descriptor(
+    name="SignBlobRequest",
+    full_name="google.iam.credentials.v1.SignBlobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.iam.credentials.v1.SignBlobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delegates",
+            full_name="google.iam.credentials.v1.SignBlobRequest.delegates",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="payload",
+            full_name="google.iam.credentials.v1.SignBlobRequest.payload",
+            index=2,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=359,
+    serialized_end=426,
+)
+
+
+_SIGNBLOBRESPONSE = _descriptor.Descriptor(
+    name="SignBlobResponse",
+    full_name="google.iam.credentials.v1.SignBlobResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key_id",
+            full_name="google.iam.credentials.v1.SignBlobResponse.key_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signed_blob",
+            full_name="google.iam.credentials.v1.SignBlobResponse.signed_blob",
+            index=1,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=428,
+    serialized_end=483,
+)
+
+
+_SIGNJWTREQUEST = _descriptor.Descriptor(
+    name="SignJwtRequest",
+    full_name="google.iam.credentials.v1.SignJwtRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.iam.credentials.v1.SignJwtRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delegates",
+            full_name="google.iam.credentials.v1.SignJwtRequest.delegates",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="payload",
+            full_name="google.iam.credentials.v1.SignJwtRequest.payload",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=485,
+    serialized_end=551,
+)
+
+
+_SIGNJWTRESPONSE = _descriptor.Descriptor(
+    name="SignJwtResponse",
+    full_name="google.iam.credentials.v1.SignJwtResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key_id",
+            full_name="google.iam.credentials.v1.SignJwtResponse.key_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signed_jwt",
+            full_name="google.iam.credentials.v1.SignJwtResponse.signed_jwt",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=553,
+    serialized_end=606,
+)
+
+
+_GENERATEIDTOKENREQUEST = _descriptor.Descriptor(
+    name="GenerateIdTokenRequest",
+    full_name="google.iam.credentials.v1.GenerateIdTokenRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.iam.credentials.v1.GenerateIdTokenRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delegates",
+            full_name="google.iam.credentials.v1.GenerateIdTokenRequest.delegates",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audience",
+            full_name="google.iam.credentials.v1.GenerateIdTokenRequest.audience",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_email",
+            full_name="google.iam.credentials.v1.GenerateIdTokenRequest.include_email",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=608,
+    serialized_end=706,
+)
+
+
+_GENERATEIDTOKENRESPONSE = _descriptor.Descriptor(
+    name="GenerateIdTokenResponse",
+    full_name="google.iam.credentials.v1.GenerateIdTokenResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="token",
+            full_name="google.iam.credentials.v1.GenerateIdTokenResponse.token",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=708,
+    serialized_end=748,
+)
+
+_GENERATEACCESSTOKENREQUEST.fields_by_name[
+    "lifetime"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_GENERATEACCESSTOKENRESPONSE.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name[
+    "GenerateAccessTokenRequest"
+] = _GENERATEACCESSTOKENREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GenerateAccessTokenResponse"
+] = _GENERATEACCESSTOKENRESPONSE
+DESCRIPTOR.message_types_by_name["SignBlobRequest"] = _SIGNBLOBREQUEST
+DESCRIPTOR.message_types_by_name["SignBlobResponse"] = _SIGNBLOBRESPONSE
+DESCRIPTOR.message_types_by_name["SignJwtRequest"] = _SIGNJWTREQUEST
+DESCRIPTOR.message_types_by_name["SignJwtResponse"] = _SIGNJWTRESPONSE
+DESCRIPTOR.message_types_by_name["GenerateIdTokenRequest"] = _GENERATEIDTOKENREQUEST
+DESCRIPTOR.message_types_by_name["GenerateIdTokenResponse"] = _GENERATEIDTOKENRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+GenerateAccessTokenRequest = _reflection.GeneratedProtocolMessageType(
+    "GenerateAccessTokenRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GENERATEACCESSTOKENREQUEST,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      name:
+          The resource name of the service account for which the
+          credentials are requested, in the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+      delegates:
+          The sequence of service accounts in a delegation chain. Each
+          service account must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on its next
+          service account in the chain. The last service account in the
+          chain must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on the service
+          account that is specified in the ``name`` field of the
+          request.  The delegates must have the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+      scope:
+          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.
+      lifetime:
+          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 not specified, the token's lifetime will be set to
+          a default value of one hour.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.GenerateAccessTokenRequest)
+    ),
+)
+_sym_db.RegisterMessage(GenerateAccessTokenRequest)
+
+GenerateAccessTokenResponse = _reflection.GeneratedProtocolMessageType(
+    "GenerateAccessTokenResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GENERATEACCESSTOKENRESPONSE,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      access_token:
+          The OAuth 2.0 access token.
+      expire_time:
+          Token expiration time. The expiration time is always set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.GenerateAccessTokenResponse)
+    ),
+)
+_sym_db.RegisterMessage(GenerateAccessTokenResponse)
+
+SignBlobRequest = _reflection.GeneratedProtocolMessageType(
+    "SignBlobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SIGNBLOBREQUEST,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      name:
+          The resource name of the service account for which the
+          credentials are requested, in the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+      delegates:
+          The sequence of service accounts in a delegation chain. Each
+          service account must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on its next
+          service account in the chain. The last service account in the
+          chain must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on the service
+          account that is specified in the ``name`` field of the
+          request.  The delegates must have the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+      payload:
+          The bytes to sign.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.SignBlobRequest)
+    ),
+)
+_sym_db.RegisterMessage(SignBlobRequest)
+
+SignBlobResponse = _reflection.GeneratedProtocolMessageType(
+    "SignBlobResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SIGNBLOBRESPONSE,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      key_id:
+          The ID of the key used to sign the blob.
+      signed_blob:
+          The signed blob.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.SignBlobResponse)
+    ),
+)
+_sym_db.RegisterMessage(SignBlobResponse)
+
+SignJwtRequest = _reflection.GeneratedProtocolMessageType(
+    "SignJwtRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SIGNJWTREQUEST,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      name:
+          The resource name of the service account for which the
+          credentials are requested, in the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+      delegates:
+          The sequence of service accounts in a delegation chain. Each
+          service account must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on its next
+          service account in the chain. The last service account in the
+          chain must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on the service
+          account that is specified in the ``name`` field of the
+          request.  The delegates must have the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+      payload:
+          The JWT payload to sign: a JSON object that contains a JWT
+          Claims Set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.SignJwtRequest)
+    ),
+)
+_sym_db.RegisterMessage(SignJwtRequest)
+
+SignJwtResponse = _reflection.GeneratedProtocolMessageType(
+    "SignJwtResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SIGNJWTRESPONSE,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      key_id:
+          The ID of the key used to sign the JWT.
+      signed_jwt:
+          The signed JWT.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.SignJwtResponse)
+    ),
+)
+_sym_db.RegisterMessage(SignJwtResponse)
+
+GenerateIdTokenRequest = _reflection.GeneratedProtocolMessageType(
+    "GenerateIdTokenRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GENERATEIDTOKENREQUEST,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      name:
+          The resource name of the service account for which the
+          credentials are requested, in the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``.
+      delegates:
+          The sequence of service accounts in a delegation chain. Each
+          service account must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on its next
+          service account in the chain. The last service account in the
+          chain must be granted the
+          ``roles/iam.serviceAccountTokenCreator`` role on the service
+          account that is specified in the ``name`` field of the
+          request.  The delegates must have the following format:
+          ``projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}``
+      audience:
+          The audience for the token, such as the API or account that
+          this token grants access to.
+      include_email:
+          Include the service account email in the token. If set to
+          ``true``, the token will contain ``email`` and
+          ``email_verified`` claims.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.GenerateIdTokenRequest)
+    ),
+)
+_sym_db.RegisterMessage(GenerateIdTokenRequest)
+
+GenerateIdTokenResponse = _reflection.GeneratedProtocolMessageType(
+    "GenerateIdTokenResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GENERATEIDTOKENRESPONSE,
+        __module__="google.iam.credentials.v1.common_pb2",
+        __doc__="""
+Attributes:
+      token:
+          The OpenId Connect ID token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.iam.credentials.v1.GenerateIdTokenResponse)
+    ),
+)
+_sym_db.RegisterMessage(GenerateIdTokenResponse)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/iam/google/cloud/iam_credentials_v1/proto/common_pb2_grpc.py b/iam/google/cloud/iam_credentials_v1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/iam/google/cloud/iam_credentials_v1/proto/iamcredentials.proto b/iam/google/cloud/iam_credentials_v1/proto/iamcredentials.proto
new file mode 100644
index 000000000000..3308d63a4e61
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/proto/iamcredentials.proto
@@ -0,0 +1,71 @@
+// 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.iam.credentials.v1;
+
+import "google/api/annotations.proto";
+import "google/iam/credentials/v1/common.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/iam/credentials/v1;credentials";
+option java_multiple_files = true;
+option java_outer_classname = "IAMCredentialsProto";
+option java_package = "com.google.cloud.iam.credentials.v1";
+
+// A service account is a special type of Google account that belongs to your
+// application or a virtual machine (VM), instead of to an individual end user.
+// Your application assumes the identity of the service account to call Google
+// APIs, so that the users aren't directly involved.
+//
+// Service account credentials are used to temporarily assume the identity
+// of the service account. Supported credential types include OAuth 2.0 access
+// tokens, OpenID Connect ID tokens, self-signed JSON Web Tokens (JWTs), and
+// more.
+service IAMCredentials {
+  // Generates an OAuth 2.0 access token for a service account.
+  rpc GenerateAccessToken(GenerateAccessTokenRequest)
+      returns (GenerateAccessTokenResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/serviceAccounts/*}:generateAccessToken"
+      body: "*"
+    };
+  }
+
+  // Generates an OpenID Connect ID token for a service account.
+  rpc GenerateIdToken(GenerateIdTokenRequest)
+      returns (GenerateIdTokenResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/serviceAccounts/*}:generateIdToken"
+      body: "*"
+    };
+  }
+
+  // Signs a blob using a service account's system-managed private key.
+  rpc SignBlob(SignBlobRequest) returns (SignBlobResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/serviceAccounts/*}:signBlob"
+      body: "*"
+    };
+  }
+
+  // Signs a JWT using a service account's system-managed private key.
+  rpc SignJwt(SignJwtRequest) returns (SignJwtResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/serviceAccounts/*}:signJwt"
+      body: "*"
+    };
+  }
+}
diff --git a/iam/google/cloud/iam_credentials_v1/proto/iamcredentials_pb2.py b/iam/google/cloud/iam_credentials_v1/proto/iamcredentials_pb2.py
new file mode 100644
index 000000000000..c173ab9059c9
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/proto/iamcredentials_pb2.py
@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/iam/credentials/v1/iamcredentials.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.iam_credentials_v1.proto import (
+    common_pb2 as google_dot_iam_dot_credentials_dot_v1_dot_common__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/iam/credentials/v1/iamcredentials.proto",
+    package="google.iam.credentials.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n#com.google.cloud.iam.credentials.v1B\023IAMCredentialsProtoP\001ZDgoogle.golang.org/genproto/googleapis/iam/credentials/v1;credentials\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n.google/iam/credentials/v1/iamcredentials.proto\x12\x19google.iam.credentials.v1\x1a\x1cgoogle/api/annotations.proto\x1a&google/iam/credentials/v1/common.proto2\xe0\x05\n\x0eIAMCredentials\x12\xcc\x01\n\x13GenerateAccessToken\x12\x35.google.iam.credentials.v1.GenerateAccessTokenRequest\x1a\x36.google.iam.credentials.v1.GenerateAccessTokenResponse"F\x82\xd3\xe4\x93\x02@";/v1/{name=projects/*/serviceAccounts/*}:generateAccessToken:\x01*\x12\xbc\x01\n\x0fGenerateIdToken\x12\x31.google.iam.credentials.v1.GenerateIdTokenRequest\x1a\x32.google.iam.credentials.v1.GenerateIdTokenResponse"B\x82\xd3\xe4\x93\x02<"7/v1/{name=projects/*/serviceAccounts/*}:generateIdToken:\x01*\x12\xa0\x01\n\x08SignBlob\x12*.google.iam.credentials.v1.SignBlobRequest\x1a+.google.iam.credentials.v1.SignBlobResponse";\x82\xd3\xe4\x93\x02\x35"0/v1/{name=projects/*/serviceAccounts/*}:signBlob:\x01*\x12\x9c\x01\n\x07SignJwt\x12).google.iam.credentials.v1.SignJwtRequest\x1a*.google.iam.credentials.v1.SignJwtResponse":\x82\xd3\xe4\x93\x02\x34"//v1/{name=projects/*/serviceAccounts/*}:signJwt:\x01*B\x85\x01\n#com.google.cloud.iam.credentials.v1B\x13IAMCredentialsProtoP\x01ZDgoogle.golang.org/genproto/googleapis/iam/credentials/v1;credentials\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR._options = None
+
+_IAMCREDENTIALS = _descriptor.ServiceDescriptor(
+    name="IAMCredentials",
+    full_name="google.iam.credentials.v1.IAMCredentials",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=148,
+    serialized_end=884,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="GenerateAccessToken",
+            full_name="google.iam.credentials.v1.IAMCredentials.GenerateAccessToken",
+            index=0,
+            containing_service=None,
+            input_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._GENERATEACCESSTOKENREQUEST,
+            output_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._GENERATEACCESSTOKENRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v1/{name=projects/*/serviceAccounts/*}:generateAccessToken:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GenerateIdToken",
+            full_name="google.iam.credentials.v1.IAMCredentials.GenerateIdToken",
+            index=1,
+            containing_service=None,
+            input_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._GENERATEIDTOKENREQUEST,
+            output_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._GENERATEIDTOKENRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002<"7/v1/{name=projects/*/serviceAccounts/*}:generateIdToken:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SignBlob",
+            full_name="google.iam.credentials.v1.IAMCredentials.SignBlob",
+            index=2,
+            containing_service=None,
+            input_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._SIGNBLOBREQUEST,
+            output_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._SIGNBLOBRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0025"0/v1/{name=projects/*/serviceAccounts/*}:signBlob:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SignJwt",
+            full_name="google.iam.credentials.v1.IAMCredentials.SignJwt",
+            index=3,
+            containing_service=None,
+            input_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._SIGNJWTREQUEST,
+            output_type=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2._SIGNJWTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0024"//v1/{name=projects/*/serviceAccounts/*}:signJwt:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_IAMCREDENTIALS)
+
+DESCRIPTOR.services_by_name["IAMCredentials"] = _IAMCREDENTIALS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/iam/google/cloud/iam_credentials_v1/proto/iamcredentials_pb2_grpc.py b/iam/google/cloud/iam_credentials_v1/proto/iamcredentials_pb2_grpc.py
new file mode 100644
index 000000000000..277e7249eef8
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/proto/iamcredentials_pb2_grpc.py
@@ -0,0 +1,116 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.iam_credentials_v1.proto import (
+    common_pb2 as google_dot_iam_dot_credentials_dot_v1_dot_common__pb2,
+)
+
+
+class IAMCredentialsStub(object):
+    """A service account is a special type of Google account that belongs to your
+  application or a virtual machine (VM), instead of to an individual end user.
+  Your application assumes the identity of the service account to call Google
+  APIs, so that the users aren't directly involved.
+
+  Service account credentials are used to temporarily assume the identity
+  of the service account. Supported credential types include OAuth 2.0 access
+  tokens, OpenID Connect ID tokens, self-signed JSON Web Tokens (JWTs), and
+  more.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.GenerateAccessToken = channel.unary_unary(
+            "/google.iam.credentials.v1.IAMCredentials/GenerateAccessToken",
+            request_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateAccessTokenRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateAccessTokenResponse.FromString,
+        )
+        self.GenerateIdToken = channel.unary_unary(
+            "/google.iam.credentials.v1.IAMCredentials/GenerateIdToken",
+            request_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateIdTokenRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateIdTokenResponse.FromString,
+        )
+        self.SignBlob = channel.unary_unary(
+            "/google.iam.credentials.v1.IAMCredentials/SignBlob",
+            request_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignBlobRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignBlobResponse.FromString,
+        )
+        self.SignJwt = channel.unary_unary(
+            "/google.iam.credentials.v1.IAMCredentials/SignJwt",
+            request_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignJwtRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignJwtResponse.FromString,
+        )
+
+
+class IAMCredentialsServicer(object):
+    """A service account is a special type of Google account that belongs to your
+  application or a virtual machine (VM), instead of to an individual end user.
+  Your application assumes the identity of the service account to call Google
+  APIs, so that the users aren't directly involved.
+
+  Service account credentials are used to temporarily assume the identity
+  of the service account. Supported credential types include OAuth 2.0 access
+  tokens, OpenID Connect ID tokens, self-signed JSON Web Tokens (JWTs), and
+  more.
+  """
+
+    def GenerateAccessToken(self, request, context):
+        """Generates an OAuth 2.0 access token for a service account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GenerateIdToken(self, request, context):
+        """Generates an OpenID Connect ID token for a service account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SignBlob(self, request, context):
+        """Signs a blob using a service account's system-managed private key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SignJwt(self, request, context):
+        """Signs a JWT using a service account's system-managed private key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_IAMCredentialsServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "GenerateAccessToken": grpc.unary_unary_rpc_method_handler(
+            servicer.GenerateAccessToken,
+            request_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateAccessTokenRequest.FromString,
+            response_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateAccessTokenResponse.SerializeToString,
+        ),
+        "GenerateIdToken": grpc.unary_unary_rpc_method_handler(
+            servicer.GenerateIdToken,
+            request_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateIdTokenRequest.FromString,
+            response_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.GenerateIdTokenResponse.SerializeToString,
+        ),
+        "SignBlob": grpc.unary_unary_rpc_method_handler(
+            servicer.SignBlob,
+            request_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignBlobRequest.FromString,
+            response_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignBlobResponse.SerializeToString,
+        ),
+        "SignJwt": grpc.unary_unary_rpc_method_handler(
+            servicer.SignJwt,
+            request_deserializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignJwtRequest.FromString,
+            response_serializer=google_dot_iam_dot_credentials_dot_v1_dot_common__pb2.SignJwtResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.iam.credentials.v1.IAMCredentials", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/iam/google/cloud/iam_credentials_v1/types.py b/iam/google/cloud/iam_credentials_v1/types.py
new file mode 100644
index 000000000000..10ff66bd92bd
--- /dev/null
+++ b/iam/google/cloud/iam_credentials_v1/types.py
@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.iam_credentials_v1.proto import common_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [duration_pb2, timestamp_pb2]
+
+_local_modules = [common_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.iam_credentials_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/iam/noxfile.py b/iam/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/iam/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/iam/setup.cfg b/iam/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/iam/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/iam/setup.py b/iam/setup.py
new file mode 100644
index 000000000000..a74b425fd7a1
--- /dev/null
+++ b/iam/setup.py
@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-iam"
+description = "IAM Service Account Credentials API client library"
+version = "0.2.1"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/iam/synth.metadata b/iam/synth.metadata
new file mode 100644
index 000000000000..d7a2c8d24679
--- /dev/null
+++ b/iam/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-03T12:12:16.255697Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "7b212a8d2319cd81a7b6942c25dbf4550480a06c",
+        "internalRef": "261339454"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "iam_credentials",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/iam/credentials/artman_iamcredentials_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/iam/synth.py b/iam/synth.py
new file mode 100644
index 000000000000..8c486fa26a0d
--- /dev/null
+++ b/iam/synth.py
@@ -0,0 +1,76 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate automl GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "iam_credentials",
+    "v1",
+    config_path="/google/iam/credentials/artman_iamcredentials_v1.yaml",
+    artman_output_name="iamcredentials-v1",
+    include_protos=True,
+)
+
+excludes = [
+    "README.rst",
+    "setup.py",
+    "docs/index.rst",
+    "nox.py",
+]
+s.copy(library, excludes=excludes)
+
+s.replace(
+    "google/**/*.py",
+    "google-cloud-iamcredentials",
+    "google-cloud-iam"
+)
+s.replace(
+    "docs/**/*.py",
+    "google-cloud-iamcredentials",
+    "google-cloud-iam"
+)
+
+s.replace(
+    "**/*.py",
+    "from google\.iam\.credentials\.v1 import common_pb2",
+    "from google.cloud.iam_credentials_v1.proto import common_pb2"
+)
+s.replace(
+    "**/*.py",
+    "from google\.iam\.credentials\.v1 import iamcredentials_pb2_grpc",
+    "from google.cloud.iam_credentials_v1.proto import iamcredentials_pb2_grpc"
+)
+
+s.replace(
+    "google/cloud/iam_credentials_v1/proto/common_pb2.py",
+    "\"\"\"Attributes:\n",
+    "\"\"\"\nAttributes:\n"
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/iam/tests/unit/gapic/v1/test_iam_credentials_client_v1.py b/iam/tests/unit/gapic/v1/test_iam_credentials_client_v1.py
new file mode 100644
index 000000000000..43ca4d96c1d2
--- /dev/null
+++ b/iam/tests/unit/gapic/v1/test_iam_credentials_client_v1.py
@@ -0,0 +1,225 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import iam_credentials_v1
+from google.cloud.iam_credentials_v1.proto import common_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestIAMCredentialsClient(object):
+    def test_generate_access_token(self):
+        # Setup Expected Response
+        access_token = "accessToken-1938933922"
+        expected_response = {"access_token": access_token}
+        expected_response = common_pb2.GenerateAccessTokenResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup Request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        scope = []
+
+        response = client.generate_access_token(name, scope)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = common_pb2.GenerateAccessTokenRequest(name=name, scope=scope)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_generate_access_token_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        scope = []
+
+        with pytest.raises(CustomException):
+            client.generate_access_token(name, scope)
+
+    def test_generate_id_token(self):
+        # Setup Expected Response
+        token = "token110541305"
+        expected_response = {"token": token}
+        expected_response = common_pb2.GenerateIdTokenResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup Request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        audience = "audience975628804"
+
+        response = client.generate_id_token(name, audience)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = common_pb2.GenerateIdTokenRequest(
+            name=name, audience=audience
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_generate_id_token_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        audience = "audience975628804"
+
+        with pytest.raises(CustomException):
+            client.generate_id_token(name, audience)
+
+    def test_sign_blob(self):
+        # Setup Expected Response
+        key_id = "keyId-1134673157"
+        signed_blob = b"-32"
+        expected_response = {"key_id": key_id, "signed_blob": signed_blob}
+        expected_response = common_pb2.SignBlobResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup Request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        payload = b"-114"
+
+        response = client.sign_blob(name, payload)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = common_pb2.SignBlobRequest(name=name, payload=payload)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_sign_blob_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        payload = b"-114"
+
+        with pytest.raises(CustomException):
+            client.sign_blob(name, payload)
+
+    def test_sign_jwt(self):
+        # Setup Expected Response
+        key_id = "keyId-1134673157"
+        signed_jwt = "signedJwt-979546844"
+        expected_response = {"key_id": key_id, "signed_jwt": signed_jwt}
+        expected_response = common_pb2.SignJwtResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup Request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        payload = "-114"
+
+        response = client.sign_jwt(name, payload)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = common_pb2.SignJwtRequest(name=name, payload=payload)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_sign_jwt_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iam_credentials_v1.IAMCredentialsClient()
+
+        # Setup request
+        name = client.service_account_path("[PROJECT]", "[SERVICE_ACCOUNT]")
+        payload = "-114"
+
+        with pytest.raises(CustomException):
+            client.sign_jwt(name, payload)
diff --git a/iot/.coveragerc b/iot/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/iot/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/iot/.flake8 b/iot/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/iot/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/iot/.repo-metadata.json b/iot/.repo-metadata.json
new file mode 100644
index 000000000000..0fd78d6b99d4
--- /dev/null
+++ b/iot/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudiot",
+  "name_pretty": "Google Cloud Internet of Things (IoT) Core",
+  "product_documentation": "https://cloud.google.com/iot",
+  "client_documentation": "https://googleapis.dev/python/iot/latest",
+  "issue_tracker": "https://issuetracker.google.com/issues?q=status:open%20componentid:310170",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-iot",
+  "api_id": "cloudiot.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/iot/CHANGELOG.md b/iot/CHANGELOG.md
new file mode 100644
index 000000000000..4926fa47c362
--- /dev/null
+++ b/iot/CHANGELOG.md
@@ -0,0 +1,89 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-iot/#history
+
+## 0.3.0
+
+07-24-2019 16:35 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8393](https://github.com/googleapis/google-cloud-python/pull/8393))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Remove unused message exports. ([#7269](https://github.com/googleapis/google-cloud-python/pull/7269))
+- Protoc-generated serialization update. ([#7085](https://github.com/googleapis/google-cloud-python/pull/7085))
+- Pick up stub docstring fix in GAPIC generator. ([#6973](https://github.com/googleapis/google-cloud-python/pull/6973))
+
+### New Features
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8655](https://github.com/googleapis/google-cloud-python/pull/8655))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8512](https://github.com/googleapis/google-cloud-python/pull/8512))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Update docstrings (via synth). ([#7867](https://github.com/googleapis/google-cloud-python/pull/7867))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright: 2018 -> 2019. ([#7147](https://github.com/googleapis/google-cloud-python/pull/7147))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). [#8354](https://github.com/googleapis/google-cloud-python/pull/8354))
+- Add disclaimer to auto-generated template files (via synth). ([#8316](https://github.com/googleapis/google-cloud-python/pull/8316))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8243](https://github.com/googleapis/google-cloud-python/pull/8243))
+- Fix coverage in 'types.py' (via synth). ([#8155](https://github.com/googleapis/google-cloud-python/pull/8155))
+- Blacken noxfile.py, setup.py (via synth). ([#8125](https://github.com/googleapis/google-cloud-python/pull/8125))
+- Add empty lines (via synth). ([#8060](https://github.com/googleapis/google-cloud-python/pull/8060))
+- Exclude docs/index.rst from move in synth. ([#7835](https://github.com/googleapis/google-cloud-python/pull/7835))
+- Reorder methods, add nox session `docs` (via synth). ([#7773](https://github.com/googleapis/google-cloud-python/pull/7773))
+- Copy lintified proto files (via synth). ([#7448](https://github.com/googleapis/google-cloud-python/pull/7448))
+- Add clarifying comment to blacken nox target. ([#7394](https://github.com/googleapis/google-cloud-python/pull/7394))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.2.0
+
+12-18-2018 09:19 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up new methods from protos. ([#6613](https://github.com/googleapis/google-cloud-python/pull/6613))
+- Pick up fixes to GAPIC generator. ([#6513](https://github.com/googleapis/google-cloud-python/pull/6513))
+- Fix `client_info` bug, update docstrings. ([#6413](https://github.com/googleapis/google-cloud-python/pull/6413))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Update IAM version in dependencies ([#6362](https://github.com/googleapis/google-cloud-python/pull/6362))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Fix GAX fossils ([#6264](https://github.com/googleapis/google-cloud-python/pull/6264))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6568](https://github.com/googleapis/google-cloud-python/pull/6568))
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add 'synth.py'. ([#6085](https://github.com/googleapis/google-cloud-python/pull/6085))
+- Include IoT docs in build. ([#5679](https://github.com/googleapis/google-cloud-python/pull/5679))
+- fix trove classifier ([#5386](https://github.com/googleapis/google-cloud-python/pull/5386))
+
+## 0.1.0
+
+### New Features
+- Add v1 Endpoint for IoT (#5355)
+
diff --git a/iot/LICENSE b/iot/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/iot/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/iot/MANIFEST.in b/iot/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/iot/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/iot/README.rst b/iot/README.rst
new file mode 100644
index 000000000000..21f1a7b523fd
--- /dev/null
+++ b/iot/README.rst
@@ -0,0 +1,113 @@
+Python Client for Cloud IoT API
+===============================
+
+|alpha| |pypi| |versions| 
+
+`Cloud IoT API`_: Registers and manages IoT (Internet of Things) devices that
+connect to the Google Cloud Platform.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-iot.svg
+   :target: https://pypi.org/project/google-cloud-iot/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-iot.svg
+   :target: https://pypi.org/project/google-cloud-iot/
+.. _Cloud IoT API: https://cloud.google.com/iot
+.. _Client Library Documentation: https://googleapis.dev/python/iot/latest
+.. _Product Documentation:  https://cloud.google.com/iot
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud IoT API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud IoT API.:  https://cloud.google.com/iot
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-iot
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-iot
+
+Preview
+~~~~~~~
+
+DeviceManagerClient
+^^^^^^^^^^^^^^^^^^^
+
+.. code:: py
+
+    from google.cloud import iot_v1
+
+    client = iot_v1.DeviceManagerClient()
+
+    parent = client.location_path('[PROJECT]', '[LOCATION]')
+
+
+    # Iterate over all results
+    for element in client.list_device_registries(parent):
+        # process element
+        pass
+
+    # Or iterate over results one page at a time
+    for page in client.list_device_registries(parent).pages:
+        for element in page:
+            # process element
+            pass
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud IoT API
+   to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/iot/docs/README.rst b/iot/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/iot/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/iot/docs/changelog.md b/iot/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/iot/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/iot/docs/conf.py b/iot/docs/conf.py
new file mode 100644
index 000000000000..547154d69306
--- /dev/null
+++ b/iot/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-iot documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-iot"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-iot-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-iot.tex",
+        u"google-cloud-iot Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-iot", u"google-cloud-iot Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-iot",
+        u"google-cloud-iot Documentation",
+        author,
+        "google-cloud-iot",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/iot/docs/gapic/v1/api.rst b/iot/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..dc91697f1d89
--- /dev/null
+++ b/iot/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud IoT API
+========================
+
+.. automodule:: google.cloud.iot_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/iot/docs/gapic/v1/types.rst b/iot/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..fa7bab9df0d9
--- /dev/null
+++ b/iot/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud IoT API Client
+==============================
+
+.. automodule:: google.cloud.iot_v1.types
+    :members:
\ No newline at end of file
diff --git a/iot/docs/index.rst b/iot/docs/index.rst
new file mode 100644
index 000000000000..5ddf5ffe2e78
--- /dev/null
+++ b/iot/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-iot`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/iot/google/__init__.py b/iot/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/iot/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/iot/google/cloud/__init__.py b/iot/google/cloud/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/iot/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/iot/google/cloud/iot.py b/iot/google/cloud/iot.py
new file mode 100644
index 000000000000..66493952dfea
--- /dev/null
+++ b/iot/google/cloud/iot.py
@@ -0,0 +1,21 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.iot_v1 import DeviceManagerClient
+from google.cloud.iot_v1 import enums
+from google.cloud.iot_v1 import types
+
+__all__ = ("enums", "types", "DeviceManagerClient")
diff --git a/iot/google/cloud/iot_v1/__init__.py b/iot/google/cloud/iot_v1/__init__.py
new file mode 100644
index 000000000000..257cd53f391f
--- /dev/null
+++ b/iot/google/cloud/iot_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.iot_v1 import types
+from google.cloud.iot_v1.gapic import device_manager_client
+from google.cloud.iot_v1.gapic import enums
+
+
+class DeviceManagerClient(device_manager_client.DeviceManagerClient):
+    __doc__ = device_manager_client.DeviceManagerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DeviceManagerClient")
diff --git a/iot/google/cloud/iot_v1/gapic/__init__.py b/iot/google/cloud/iot_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/iot/google/cloud/iot_v1/gapic/device_manager_client.py b/iot/google/cloud/iot_v1/gapic/device_manager_client.py
new file mode 100644
index 000000000000..872ad4ebb566
--- /dev/null
+++ b/iot/google/cloud/iot_v1/gapic/device_manager_client.py
@@ -0,0 +1,1840 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.iot.v1 DeviceManager API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.iot_v1.gapic import device_manager_client_config
+from google.cloud.iot_v1.gapic import enums
+from google.cloud.iot_v1.gapic.transports import device_manager_grpc_transport
+from google.cloud.iot_v1.proto import device_manager_pb2
+from google.cloud.iot_v1.proto import device_manager_pb2_grpc
+from google.cloud.iot_v1.proto import resources_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-iot").version
+
+
+class DeviceManagerClient(object):
+    """Internet of Things (IoT) service. Securely connect and manage IoT devices."""
+
+    SERVICE_ADDRESS = "cloudiot.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.iot.v1.DeviceManager"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DeviceManagerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def device_path(cls, project, location, registry, device):
+        """Return a fully-qualified device string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/registries/{registry}/devices/{device}",
+            project=project,
+            location=location,
+            registry=registry,
+            device=device,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def registry_path(cls, project, location, registry):
+        """Return a fully-qualified registry string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/registries/{registry}",
+            project=project,
+            location=location,
+            registry=registry,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DeviceManagerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DeviceManagerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = device_manager_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=device_manager_grpc_transport.DeviceManagerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = device_manager_grpc_transport.DeviceManagerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_device_registry(
+        self,
+        parent,
+        device_registry,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a device registry that contains devices.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `device_registry`:
+            >>> device_registry = {}
+            >>>
+            >>> response = client.create_device_registry(parent, device_registry)
+
+        Args:
+            parent (str): The project and cloud region where this device registry must be created.
+                For example, ``projects/example-project/locations/us-central1``.
+            device_registry (Union[dict, ~google.cloud.iot_v1.types.DeviceRegistry]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.DeviceRegistry`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.DeviceRegistry` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_device_registry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_device_registry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_device_registry,
+                default_retry=self._method_configs["CreateDeviceRegistry"].retry,
+                default_timeout=self._method_configs["CreateDeviceRegistry"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.CreateDeviceRegistryRequest(
+            parent=parent, device_registry=device_registry
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_device_registry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_device_registry(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a device registry configuration.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> response = client.get_device_registry(name)
+
+        Args:
+            name (str): The name of the device registry. For example,
+                ``projects/example-project/locations/us-central1/registries/my-registry``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.DeviceRegistry` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_device_registry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_device_registry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_device_registry,
+                default_retry=self._method_configs["GetDeviceRegistry"].retry,
+                default_timeout=self._method_configs["GetDeviceRegistry"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.GetDeviceRegistryRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_device_registry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_device_registry(
+        self,
+        device_registry,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a device registry configuration.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> # TODO: Initialize `device_registry`:
+            >>> device_registry = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_device_registry(device_registry, update_mask)
+
+        Args:
+            device_registry (Union[dict, ~google.cloud.iot_v1.types.DeviceRegistry]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.DeviceRegistry`
+            update_mask (Union[dict, ~google.cloud.iot_v1.types.FieldMask]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.DeviceRegistry` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_device_registry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_device_registry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_device_registry,
+                default_retry=self._method_configs["UpdateDeviceRegistry"].retry,
+                default_timeout=self._method_configs["UpdateDeviceRegistry"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.UpdateDeviceRegistryRequest(
+            device_registry=device_registry, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("device_registry.name", device_registry.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_device_registry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_device_registry(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a device registry configuration.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> client.delete_device_registry(name)
+
+        Args:
+            name (str): The name of the device registry. For example,
+                ``projects/example-project/locations/us-central1/registries/my-registry``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_device_registry" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_device_registry"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_device_registry,
+                default_retry=self._method_configs["DeleteDeviceRegistry"].retry,
+                default_timeout=self._method_configs["DeleteDeviceRegistry"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.DeleteDeviceRegistryRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_device_registry"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_device_registries(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists device registries.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_device_registries(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_device_registries(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project and cloud region path. For example,
+                ``projects/example-project/locations/us-central1``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.iot_v1.types.DeviceRegistry` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_device_registries" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_device_registries"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_device_registries,
+                default_retry=self._method_configs["ListDeviceRegistries"].retry,
+                default_timeout=self._method_configs["ListDeviceRegistries"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.ListDeviceRegistriesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_device_registries"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="device_registries",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_device(
+        self,
+        parent,
+        device,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a device in a device registry.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> parent = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> # TODO: Initialize `device`:
+            >>> device = {}
+            >>>
+            >>> response = client.create_device(parent, device)
+
+        Args:
+            parent (str): The name of the device registry where this device should be created. For
+                example,
+                ``projects/example-project/locations/us-central1/registries/my-registry``.
+            device (Union[dict, ~google.cloud.iot_v1.types.Device]): The device registration details. The field ``name`` must be empty. The
+                server generates ``name`` from the device registry ``id`` and the
+                ``parent`` field.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.Device`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.Device` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_device" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_device"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_device,
+                default_retry=self._method_configs["CreateDevice"].retry,
+                default_timeout=self._method_configs["CreateDevice"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.CreateDeviceRequest(parent=parent, device=device)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_device"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_device(
+        self,
+        name,
+        field_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets details about a device.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.device_path('[PROJECT]', '[LOCATION]', '[REGISTRY]', '[DEVICE]')
+            >>>
+            >>> response = client.get_device(name)
+
+        Args:
+            name (str): 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}``.
+            field_mask (Union[dict, ~google.cloud.iot_v1.types.FieldMask]): The fields of the ``Device`` resource to be returned in the response. If
+                the field mask is unset or empty, all fields are returned.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.Device` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_device" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_device"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_device,
+                default_retry=self._method_configs["GetDevice"].retry,
+                default_timeout=self._method_configs["GetDevice"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.GetDeviceRequest(name=name, field_mask=field_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_device"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_device(
+        self,
+        device,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a device.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> # TODO: Initialize `device`:
+            >>> device = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_device(device, update_mask)
+
+        Args:
+            device (Union[dict, ~google.cloud.iot_v1.types.Device]): 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}``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.Device`
+            update_mask (Union[dict, ~google.cloud.iot_v1.types.FieldMask]): 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``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.Device` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_device" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_device"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_device,
+                default_retry=self._method_configs["UpdateDevice"].retry,
+                default_timeout=self._method_configs["UpdateDevice"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.UpdateDeviceRequest(
+            device=device, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("device.name", device.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_device"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_device(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a device.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.device_path('[PROJECT]', '[LOCATION]', '[REGISTRY]', '[DEVICE]')
+            >>>
+            >>> client.delete_device(name)
+
+        Args:
+            name (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_device" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_device"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_device,
+                default_retry=self._method_configs["DeleteDevice"].retry,
+                default_timeout=self._method_configs["DeleteDevice"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.DeleteDeviceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_device"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_devices(
+        self,
+        parent,
+        device_num_ids=None,
+        device_ids=None,
+        field_mask=None,
+        gateway_list_options=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List devices in a device registry.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> parent = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_devices(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_devices(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The device registry path. Required. For example,
+                ``projects/my-project/locations/us-central1/registries/my-registry``.
+            device_num_ids (list[long]): A list of device numeric IDs. If empty, this field is ignored. Maximum
+                IDs: 10,000.
+            device_ids (list[str]): A list of device string IDs. For example, ``['device0', 'device12']``.
+                If empty, this field is ignored. Maximum IDs: 10,000
+            field_mask (Union[dict, ~google.cloud.iot_v1.types.FieldMask]): The fields of the ``Device`` resource to be returned in the response.
+                The fields ``id`` and ``num_id`` are always returned, along with any
+                other fields specified.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.FieldMask`
+            gateway_list_options (Union[dict, ~google.cloud.iot_v1.types.GatewayListOptions]): Options related to gateways.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.GatewayListOptions`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.iot_v1.types.Device` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_devices" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_devices"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_devices,
+                default_retry=self._method_configs["ListDevices"].retry,
+                default_timeout=self._method_configs["ListDevices"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.ListDevicesRequest(
+            parent=parent,
+            device_num_ids=device_num_ids,
+            device_ids=device_ids,
+            field_mask=field_mask,
+            gateway_list_options=gateway_list_options,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_devices"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="devices",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def modify_cloud_to_device_config(
+        self,
+        name,
+        binary_data,
+        version_to_update=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Modifies the configuration for the device, which is eventually sent from
+        the Cloud IoT Core servers. Returns the modified configuration version and
+        its metadata.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.device_path('[PROJECT]', '[LOCATION]', '[REGISTRY]', '[DEVICE]')
+            >>>
+            >>> # TODO: Initialize `binary_data`:
+            >>> binary_data = b''
+            >>>
+            >>> response = client.modify_cloud_to_device_config(name, binary_data)
+
+        Args:
+            name (str): 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}``.
+            binary_data (bytes): The configuration data for the device.
+            version_to_update (long): 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;
+                otherwise, this update will fail if the version number found on the server
+                does not match this version number. This is used to support multiple
+                simultaneous updates without losing data.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.DeviceConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "modify_cloud_to_device_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "modify_cloud_to_device_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.modify_cloud_to_device_config,
+                default_retry=self._method_configs["ModifyCloudToDeviceConfig"].retry,
+                default_timeout=self._method_configs[
+                    "ModifyCloudToDeviceConfig"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.ModifyCloudToDeviceConfigRequest(
+            name=name, binary_data=binary_data, version_to_update=version_to_update
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["modify_cloud_to_device_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_device_config_versions(
+        self,
+        name,
+        num_versions=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the last few versions of the device configuration in descending
+        order (i.e.: newest first).
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.device_path('[PROJECT]', '[LOCATION]', '[REGISTRY]', '[DEVICE]')
+            >>>
+            >>> response = client.list_device_config_versions(name)
+
+        Args:
+            name (str): 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}``.
+            num_versions (int): 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
+                value is zero, it will return all the versions available.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.ListDeviceConfigVersionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_device_config_versions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_device_config_versions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_device_config_versions,
+                default_retry=self._method_configs["ListDeviceConfigVersions"].retry,
+                default_timeout=self._method_configs[
+                    "ListDeviceConfigVersions"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.ListDeviceConfigVersionsRequest(
+            name=name, num_versions=num_versions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_device_config_versions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_device_states(
+        self,
+        name,
+        num_states=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the last few versions of the device state in descending order (i.e.:
+        newest first).
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.device_path('[PROJECT]', '[LOCATION]', '[REGISTRY]', '[DEVICE]')
+            >>>
+            >>> response = client.list_device_states(name)
+
+        Args:
+            name (str): 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}``.
+            num_states (int): 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
+                value is zero, it will return all the states available.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.ListDeviceStatesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_device_states" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_device_states"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_device_states,
+                default_retry=self._method_configs["ListDeviceStates"].retry,
+                default_timeout=self._method_configs["ListDeviceStates"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.ListDeviceStatesRequest(
+            name=name, num_states=num_states
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_device_states"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on the specified resource. Replaces any
+        existing policy.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> resource = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.iot_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a resource.
+        Returns an empty policy if the resource exists and does not have a policy
+        set.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> resource = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.iot_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.iot_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> resource = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def send_command_to_device(
+        self,
+        name,
+        binary_data,
+        subfolder=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sends a command to the specified device. In order for a device to be
+        able to receive commands, it must:
+
+        1) be connected to Cloud IoT Core using the MQTT protocol, and
+        2) be subscribed to the group of MQTT topics specified by
+           /devices/{device-id}/commands/#. This subscription will receive
+           commands at the top-level topic /devices/{device-id}/commands as well
+           as commands for subfolders, like
+           /devices/{device-id}/commands/subfolder. Note that subscribing to
+           specific subfolders is not supported. If the command could not be
+           delivered to the device, this method will return an error; in
+           particular, if the device is not subscribed, this 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.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> name = client.device_path('[PROJECT]', '[LOCATION]', '[REGISTRY]', '[DEVICE]')
+            >>>
+            >>> # TODO: Initialize `binary_data`:
+            >>> binary_data = b''
+            >>>
+            >>> response = client.send_command_to_device(name, binary_data)
+
+        Args:
+            name (str): 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}``.
+            binary_data (bytes): The command data to send to the device.
+            subfolder (str): Optional subfolder for the command. If empty, the command will be delivered
+                to the /devices/{device-id}/commands topic, otherwise it will be delivered
+                to the /devices/{device-id}/commands/{subfolder} topic. Multi-level
+                subfolders are allowed. This field must not have more than 256 characters,
+                and must not contain any MQTT wildcards ("+" or "#") or null characters.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.SendCommandToDeviceResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "send_command_to_device" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "send_command_to_device"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.send_command_to_device,
+                default_retry=self._method_configs["SendCommandToDevice"].retry,
+                default_timeout=self._method_configs["SendCommandToDevice"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.SendCommandToDeviceRequest(
+            name=name, binary_data=binary_data, subfolder=subfolder
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["send_command_to_device"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def bind_device_to_gateway(
+        self,
+        parent,
+        gateway_id,
+        device_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Associates the device with the gateway.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> parent = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> # TODO: Initialize `gateway_id`:
+            >>> gateway_id = ''
+            >>>
+            >>> # TODO: Initialize `device_id`:
+            >>> device_id = ''
+            >>>
+            >>> response = client.bind_device_to_gateway(parent, gateway_id, device_id)
+
+        Args:
+            parent (str): The name of the registry. For example,
+                ``projects/example-project/locations/us-central1/registries/my-registry``.
+            gateway_id (str): The value of ``gateway_id`` can be either the device numeric ID or the
+                user-defined device identifier.
+            device_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.BindDeviceToGatewayResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "bind_device_to_gateway" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "bind_device_to_gateway"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.bind_device_to_gateway,
+                default_retry=self._method_configs["BindDeviceToGateway"].retry,
+                default_timeout=self._method_configs["BindDeviceToGateway"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.BindDeviceToGatewayRequest(
+            parent=parent, gateway_id=gateway_id, device_id=device_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["bind_device_to_gateway"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def unbind_device_from_gateway(
+        self,
+        parent,
+        gateway_id,
+        device_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the association between the device and the gateway.
+
+        Example:
+            >>> from google.cloud import iot_v1
+            >>>
+            >>> client = iot_v1.DeviceManagerClient()
+            >>>
+            >>> parent = client.registry_path('[PROJECT]', '[LOCATION]', '[REGISTRY]')
+            >>>
+            >>> # TODO: Initialize `gateway_id`:
+            >>> gateway_id = ''
+            >>>
+            >>> # TODO: Initialize `device_id`:
+            >>> device_id = ''
+            >>>
+            >>> response = client.unbind_device_from_gateway(parent, gateway_id, device_id)
+
+        Args:
+            parent (str): The name of the registry. For example,
+                ``projects/example-project/locations/us-central1/registries/my-registry``.
+            gateway_id (str): The value of ``gateway_id`` can be either the device numeric ID or the
+                user-defined device identifier.
+            device_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.iot_v1.types.UnbindDeviceFromGatewayResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "unbind_device_from_gateway" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "unbind_device_from_gateway"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.unbind_device_from_gateway,
+                default_retry=self._method_configs["UnbindDeviceFromGateway"].retry,
+                default_timeout=self._method_configs["UnbindDeviceFromGateway"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = device_manager_pb2.UnbindDeviceFromGatewayRequest(
+            parent=parent, gateway_id=gateway_id, device_id=device_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["unbind_device_from_gateway"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/iot/google/cloud/iot_v1/gapic/device_manager_client_config.py b/iot/google/cloud/iot_v1/gapic/device_manager_client_config.py
new file mode 100644
index 000000000000..67a037f82b81
--- /dev/null
+++ b/iot/google/cloud/iot_v1/gapic/device_manager_client_config.py
@@ -0,0 +1,132 @@
+config = {
+    "interfaces": {
+        "google.cloud.iot.v1.DeviceManager": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+                "rate_limited_aware": [
+                    "DEADLINE_EXCEEDED",
+                    "RESOURCE_EXHAUSTED",
+                    "UNAVAILABLE",
+                ],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 120000,
+                },
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 120000,
+                },
+            },
+            "methods": {
+                "CreateDeviceRegistry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDeviceRegistry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDeviceRegistry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDeviceRegistry": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDeviceRegistries": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateDevice": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDevice": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDevice": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteDevice": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDevices": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ModifyCloudToDeviceConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "rate_limited_aware",
+                    "retry_params_name": "rate_limited_aware",
+                },
+                "ListDeviceConfigVersions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListDeviceStates": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SendCommandToDevice": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "rate_limited_aware",
+                    "retry_params_name": "rate_limited_aware",
+                },
+                "BindDeviceToGateway": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UnbindDeviceFromGateway": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/iot/google/cloud/iot_v1/gapic/enums.py b/iot/google/cloud/iot_v1/gapic/enums.py
new file mode 100644
index 000000000000..7a739e86a18f
--- /dev/null
+++ b/iot/google/cloud/iot_v1/gapic/enums.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class GatewayAuthMethod(enum.IntEnum):
+    """
+    The gateway authorization/authentication method. This setting determines how
+    Cloud IoT Core authorizes/authenticate devices to access the gateway.
+
+    Attributes:
+      GATEWAY_AUTH_METHOD_UNSPECIFIED (int): No authentication/authorization method specified. No devices are allowed to
+      access the gateway.
+      ASSOCIATION_ONLY (int): The device is authenticated through the gateway association only. Device
+      credentials are ignored even if provided.
+      DEVICE_AUTH_TOKEN_ONLY (int): The device is authenticated through its own credentials. Gateway
+      association is not checked.
+      ASSOCIATION_AND_DEVICE_AUTH_TOKEN (int): 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.
+    """
+
+    GATEWAY_AUTH_METHOD_UNSPECIFIED = 0
+    ASSOCIATION_ONLY = 1
+    DEVICE_AUTH_TOKEN_ONLY = 2
+    ASSOCIATION_AND_DEVICE_AUTH_TOKEN = 3
+
+
+class GatewayType(enum.IntEnum):
+    """
+    Gateway type.
+
+    Attributes:
+      GATEWAY_TYPE_UNSPECIFIED (int): If unspecified, the device is considered a non-gateway device.
+      GATEWAY (int): The device is a gateway.
+      NON_GATEWAY (int): The device is not a gateway.
+    """
+
+    GATEWAY_TYPE_UNSPECIFIED = 0
+    GATEWAY = 1
+    NON_GATEWAY = 2
+
+
+class HttpState(enum.IntEnum):
+    """
+    Indicates whether DeviceService (HTTP) is enabled or disabled for the
+    registry. See the field description for details.
+
+    Attributes:
+      HTTP_STATE_UNSPECIFIED (int): No HTTP state specified. If not specified, DeviceService will be
+      enabled by default.
+      HTTP_ENABLED (int): Enables DeviceService (HTTP) service for the registry.
+      HTTP_DISABLED (int): Disables DeviceService (HTTP) service for the registry.
+    """
+
+    HTTP_STATE_UNSPECIFIED = 0
+    HTTP_ENABLED = 1
+    HTTP_DISABLED = 2
+
+
+class LogLevel(enum.IntEnum):
+    """
+    **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.
+
+    Attributes:
+      LOG_LEVEL_UNSPECIFIED (int): No logging specified. If not specified, logging will be disabled.
+      NONE (int): Disables logging.
+      ERROR (int): Error events will be logged.
+      INFO (int): Informational events will be logged, such as connections and
+      disconnections.
+      DEBUG (int): All events will be logged.
+    """
+
+    LOG_LEVEL_UNSPECIFIED = 0
+    NONE = 10
+    ERROR = 20
+    INFO = 30
+    DEBUG = 40
+
+
+class MqttState(enum.IntEnum):
+    """
+    Indicates whether an MQTT connection is enabled or disabled. See the field
+    description for details.
+
+    Attributes:
+      MQTT_STATE_UNSPECIFIED (int): No MQTT state specified. If not specified, MQTT will be enabled by default.
+      MQTT_ENABLED (int): Enables a MQTT connection.
+      MQTT_DISABLED (int): Disables a MQTT connection.
+    """
+
+    MQTT_STATE_UNSPECIFIED = 0
+    MQTT_ENABLED = 1
+    MQTT_DISABLED = 2
+
+
+class PublicKeyCertificateFormat(enum.IntEnum):
+    """
+    The supported formats for the public key.
+
+    Attributes:
+      UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT (int): The format has not been specified. This is an invalid default value and
+      must not be used.
+      X509_CERTIFICATE_PEM (int): An X.509v3 certificate
+      (`RFC5280 <https://www.ietf.org/rfc/rfc5280.txt>`__), encoded in base64,
+      and wrapped by ``-----BEGIN CERTIFICATE-----`` and
+      ``-----END CERTIFICATE-----``.
+    """
+
+    UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT = 0
+    X509_CERTIFICATE_PEM = 1
+
+
+class PublicKeyFormat(enum.IntEnum):
+    """
+    The supported formats for the public key.
+
+    Attributes:
+      UNSPECIFIED_PUBLIC_KEY_FORMAT (int): The format has not been specified. This is an invalid default value and
+      must not be used.
+      RSA_PEM (int): 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_X509_PEM (int): 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-----``.
+      ES256_PEM (int): 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_X509_PEM (int): 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-----``.
+    """
+
+    UNSPECIFIED_PUBLIC_KEY_FORMAT = 0
+    RSA_PEM = 3
+    RSA_X509_PEM = 1
+    ES256_PEM = 2
+    ES256_X509_PEM = 4
diff --git a/iot/google/cloud/iot_v1/gapic/transports/__init__.py b/iot/google/cloud/iot_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/iot/google/cloud/iot_v1/gapic/transports/device_manager_grpc_transport.py b/iot/google/cloud/iot_v1/gapic/transports/device_manager_grpc_transport.py
new file mode 100644
index 000000000000..146f0f9f81a4
--- /dev/null
+++ b/iot/google/cloud/iot_v1/gapic/transports/device_manager_grpc_transport.py
@@ -0,0 +1,381 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.iot_v1.proto import device_manager_pb2_grpc
+
+
+class DeviceManagerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.iot.v1 DeviceManager API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloudiot",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudiot.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "device_manager_stub": device_manager_pb2_grpc.DeviceManagerStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudiot.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_device_registry(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.create_device_registry`.
+
+        Creates a device registry that contains devices.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].CreateDeviceRegistry
+
+    @property
+    def get_device_registry(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.get_device_registry`.
+
+        Gets a device registry configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].GetDeviceRegistry
+
+    @property
+    def update_device_registry(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.update_device_registry`.
+
+        Updates a device registry configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].UpdateDeviceRegistry
+
+    @property
+    def delete_device_registry(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.delete_device_registry`.
+
+        Deletes a device registry configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].DeleteDeviceRegistry
+
+    @property
+    def list_device_registries(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.list_device_registries`.
+
+        Lists device registries.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].ListDeviceRegistries
+
+    @property
+    def create_device(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.create_device`.
+
+        Creates a device in a device registry.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].CreateDevice
+
+    @property
+    def get_device(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.get_device`.
+
+        Gets details about a device.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].GetDevice
+
+    @property
+    def update_device(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.update_device`.
+
+        Updates a device.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].UpdateDevice
+
+    @property
+    def delete_device(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.delete_device`.
+
+        Deletes a device.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].DeleteDevice
+
+    @property
+    def list_devices(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.list_devices`.
+
+        List devices in a device registry.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].ListDevices
+
+    @property
+    def modify_cloud_to_device_config(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.modify_cloud_to_device_config`.
+
+        Modifies the configuration for the device, which is eventually sent from
+        the Cloud IoT Core servers. Returns the modified configuration version and
+        its metadata.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].ModifyCloudToDeviceConfig
+
+    @property
+    def list_device_config_versions(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.list_device_config_versions`.
+
+        Lists the last few versions of the device configuration in descending
+        order (i.e.: newest first).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].ListDeviceConfigVersions
+
+    @property
+    def list_device_states(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.list_device_states`.
+
+        Lists the last few versions of the device state in descending order (i.e.:
+        newest first).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].ListDeviceStates
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.set_iam_policy`.
+
+        Sets the access control policy on the specified resource. Replaces any
+        existing policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.get_iam_policy`.
+
+        Gets the access control policy for a resource.
+        Returns an empty policy if the resource exists and does not have a policy
+        set.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.test_iam_permissions`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].TestIamPermissions
+
+    @property
+    def send_command_to_device(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.send_command_to_device`.
+
+        Sends a command to the specified device. In order for a device to be
+        able to receive commands, it must:
+
+        1) be connected to Cloud IoT Core using the MQTT protocol, and
+        2) be subscribed to the group of MQTT topics specified by
+           /devices/{device-id}/commands/#. This subscription will receive
+           commands at the top-level topic /devices/{device-id}/commands as well
+           as commands for subfolders, like
+           /devices/{device-id}/commands/subfolder. Note that subscribing to
+           specific subfolders is not supported. If the command could not be
+           delivered to the device, this method will return an error; in
+           particular, if the device is not subscribed, this 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].SendCommandToDevice
+
+    @property
+    def bind_device_to_gateway(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.bind_device_to_gateway`.
+
+        Associates the device with the gateway.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].BindDeviceToGateway
+
+    @property
+    def unbind_device_from_gateway(self):
+        """Return the gRPC stub for :meth:`DeviceManagerClient.unbind_device_from_gateway`.
+
+        Deletes the association between the device and the gateway.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["device_manager_stub"].UnbindDeviceFromGateway
diff --git a/iot/google/cloud/iot_v1/proto/__init__.py b/iot/google/cloud/iot_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/iot/google/cloud/iot_v1/proto/device_manager.proto b/iot/google/cloud/iot_v1/proto/device_manager.proto
new file mode 100644
index 000000000000..27ec0f0301d0
--- /dev/null
+++ b/iot/google/cloud/iot_v1/proto/device_manager.proto
@@ -0,0 +1,562 @@
+// 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.cloud.iot.v1;
+
+import "google/api/annotations.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;
+option go_package = "google.golang.org/genproto/googleapis/cloud/iot/v1;iot";
+option java_multiple_files = true;
+option java_outer_classname = "DeviceManagerProto";
+option java_package = "com.google.cloud.iot.v1";
+
+// Internet of Things (IoT) service. Securely connect and manage IoT devices.
+service DeviceManager {
+  // Creates a device registry that contains devices.
+  rpc CreateDeviceRegistry(CreateDeviceRegistryRequest)
+      returns (DeviceRegistry) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/registries"
+      body: "device_registry"
+    };
+  }
+
+  // Gets a device registry configuration.
+  rpc GetDeviceRegistry(GetDeviceRegistryRequest) returns (DeviceRegistry) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/registries/*}"
+    };
+  }
+
+  // Updates a device registry configuration.
+  rpc UpdateDeviceRegistry(UpdateDeviceRegistryRequest)
+      returns (DeviceRegistry) {
+    option (google.api.http) = {
+      patch: "/v1/{device_registry.name=projects/*/locations/*/registries/*}"
+      body: "device_registry"
+    };
+  }
+
+  // Deletes a device registry configuration.
+  rpc DeleteDeviceRegistry(DeleteDeviceRegistryRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/registries/*}"
+    };
+  }
+
+  // Lists device registries.
+  rpc ListDeviceRegistries(ListDeviceRegistriesRequest)
+      returns (ListDeviceRegistriesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/registries"
+    };
+  }
+
+  // Creates a device in a device registry.
+  rpc CreateDevice(CreateDeviceRequest) returns (Device) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/registries/*}/devices"
+      body: "device"
+    };
+  }
+
+  // Gets details about a device.
+  rpc GetDevice(GetDeviceRequest) returns (Device) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/registries/*/devices/*}"
+      additional_bindings {
+        get: "/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}"
+      }
+    };
+  }
+
+  // Updates a device.
+  rpc UpdateDevice(UpdateDeviceRequest) returns (Device) {
+    option (google.api.http) = {
+      patch: "/v1/{device.name=projects/*/locations/*/registries/*/devices/*}"
+      body: "device"
+      additional_bindings {
+        patch: "/v1/{device.name=projects/*/locations/*/registries/*/groups/*/devices/*}"
+        body: "device"
+      }
+    };
+  }
+
+  // Deletes a device.
+  rpc DeleteDevice(DeleteDeviceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/registries/*/devices/*}"
+    };
+  }
+
+  // List devices in a device registry.
+  rpc ListDevices(ListDevicesRequest) returns (ListDevicesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/registries/*}/devices"
+      additional_bindings {
+        get: "/v1/{parent=projects/*/locations/*/registries/*/groups/*}/devices"
+      }
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/registries/*/devices/*}:modifyCloudToDeviceConfig"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}:modifyCloudToDeviceConfig"
+        body: "*"
+      }
+    };
+  }
+
+  // Lists the last few versions of the device configuration in descending
+  // order (i.e.: newest first).
+  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"
+      }
+    };
+  }
+
+  // Lists the last few versions of the device state in descending order (i.e.:
+  // newest first).
+  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"
+      }
+    };
+  }
+
+  // Sets the access control policy on the specified resource. Replaces any
+  // existing policy.
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
+      returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/locations/*/registries/*}:setIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/locations/*/registries/*/groups/*}:setIamPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // 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/*/registries/*}:getIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/locations/*/registries/*/groups/*}:getIamPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/locations/*/registries/*}:testIamPermissions"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/locations/*/registries/*/groups/*}:testIamPermissions"
+        body: "*"
+      }
+    };
+  }
+
+  // Sends a command to the specified device. In order for a device to be able
+  // to receive commands, it must:
+  // 1) be connected to Cloud IoT Core using the MQTT protocol, and
+  // 2) be subscribed to the group of MQTT topics specified by
+  //    /devices/{device-id}/commands/#. This subscription will receive commands
+  //    at the top-level topic /devices/{device-id}/commands as well as commands
+  //    for subfolders, like /devices/{device-id}/commands/subfolder.
+  //    Note that subscribing to specific subfolders is not supported.
+  // If the command could not be delivered to the device, this method will
+  // return an error; in particular, if the device is not subscribed, this
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/registries/*/devices/*}:sendCommandToDevice"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}:sendCommandToDevice"
+        body: "*"
+      }
+    };
+  }
+
+  // Associates the device with the gateway.
+  rpc BindDeviceToGateway(BindDeviceToGatewayRequest)
+      returns (BindDeviceToGatewayResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/registries/*}:bindDeviceToGateway"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*/registries/*/groups/*}:bindDeviceToGateway"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes the association between the device and the gateway.
+  rpc UnbindDeviceFromGateway(UnbindDeviceFromGatewayRequest)
+      returns (UnbindDeviceFromGatewayResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/registries/*}:unbindDeviceFromGateway"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*/registries/*/groups/*}:unbindDeviceFromGateway"
+        body: "*"
+      }
+    };
+  }
+}
+
+// Request for `CreateDeviceRegistry`.
+message CreateDeviceRegistryRequest {
+  // 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
+  // generate that field from the device registry `id` provided and the
+  // `parent` field.
+  DeviceRegistry device_registry = 2;
+}
+
+// Request for `GetDeviceRegistry`.
+message GetDeviceRegistryRequest {
+  // The name of the device registry. For example,
+  // `projects/example-project/locations/us-central1/registries/my-registry`.
+  string name = 1;
+}
+
+// Request for `DeleteDeviceRegistry`.
+message DeleteDeviceRegistryRequest {
+  // The name of the device registry. For example,
+  // `projects/example-project/locations/us-central1/registries/my-registry`.
+  string name = 1;
+}
+
+// Request for `UpdateDeviceRegistry`.
+message UpdateDeviceRegistryRequest {
+  // 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;
+
+  // 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;
+}
+
+// Request for `ListDeviceRegistries`.
+message ListDeviceRegistriesRequest {
+  // The project and cloud region path. For example,
+  // `projects/example-project/locations/us-central1`.
+  string parent = 1;
+
+  // 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
+  // objects than requested. A non-empty `next_page_token` in the response
+  // indicates that more data is available.
+  int32 page_size = 2;
+
+  // The value returned by the last `ListDeviceRegistriesResponse`; indicates
+  // that this is a continuation of a prior `ListDeviceRegistries` call and
+  // the system should return the next page of data.
+  string page_token = 3;
+}
+
+// Response for `ListDeviceRegistries`.
+message ListDeviceRegistriesResponse {
+  // The registries that matched the query.
+  repeated DeviceRegistry device_registries = 1;
+
+  // If not empty, indicates that there may be more registries that match the
+  // request; this value should be passed in a new
+  // `ListDeviceRegistriesRequest`.
+  string next_page_token = 2;
+}
+
+// Request for `CreateDevice`.
+message CreateDeviceRequest {
+  // 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
+  // generates `name` from the device registry `id` and the
+  // `parent` field.
+  Device device = 2;
+}
+
+// Request for `GetDevice`.
+message GetDeviceRequest {
+  // 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;
+
+  // The fields of the `Device` resource to be returned in the response. If the
+  // field mask is unset or empty, all fields are returned.
+  google.protobuf.FieldMask field_mask = 2;
+}
+
+// Request for `UpdateDevice`.
+message UpdateDeviceRequest {
+  // 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;
+
+  // 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;
+}
+
+// Request for `DeleteDevice`.
+message DeleteDeviceRequest {
+  // 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;
+}
+
+// Request for `ListDevices`.
+message ListDevicesRequest {
+  // The device registry path. Required. For example,
+  // `projects/my-project/locations/us-central1/registries/my-registry`.
+  string parent = 1;
+
+  // A list of device numeric IDs. If empty, this field is ignored. Maximum
+  // IDs: 10,000.
+  repeated uint64 device_num_ids = 2;
+
+  // A list of device string IDs. For example, `['device0', 'device12']`.
+  // If empty, this field is ignored. Maximum IDs: 10,000
+  repeated string device_ids = 3;
+
+  // The fields of the `Device` resource to be returned in the response. The
+  // fields `id` and `num_id` are always returned, along with any
+  // other fields specified.
+  google.protobuf.FieldMask field_mask = 4;
+
+  // Options related to gateways.
+  GatewayListOptions gateway_list_options = 6;
+
+  // The maximum number of devices to return in the response. If this value
+  // is zero, the service will select a default size. A call may return fewer
+  // objects than requested. A non-empty `next_page_token` in the response
+  // indicates that more data is available.
+  int32 page_size = 100;
+
+  // The value returned by the last `ListDevicesResponse`; indicates
+  // that this is a continuation of a prior `ListDevices` call and
+  // the system should return the next page of data.
+  string page_token = 101;
+}
+
+// Options for limiting the list based on gateway type and associations.
+message GatewayListOptions {
+  // If not set, all devices and gateways are returned. If set, the list is
+  // filtered based on gateway type and associations.
+  oneof filter {
+    // If `GATEWAY` is specified, only gateways are returned. If `NON_GATEWAY`
+    // is specified, only non-gateway devices are returned. If
+    // `GATEWAY_TYPE_UNSPECIFIED` is specified, all devices are returned.
+    GatewayType gateway_type = 1;
+
+    // If set, only devices associated with the specified gateway are returned.
+    // The gateway ID can be numeric (`num_id`) or the user-defined string
+    // (`id`). For example, if `123` is specified, only devices bound to the
+    // gateway with `num_id` 123 are returned.
+    string associations_gateway_id = 2;
+
+    // If set, returns only the gateways with which the specified device is
+    // associated. The device ID can be numeric (`num_id`) or the user-defined
+    // string (`id`). For example, if `456` is specified, returns only the
+    // gateways to which the device with `num_id` 456 is bound.
+    string associations_device_id = 3;
+  }
+}
+
+// Response for `ListDevices`.
+message ListDevicesResponse {
+  // The devices that match the request.
+  repeated Device devices = 1;
+
+  // If not empty, indicates that there may be more devices that match the
+  // request; this value should be passed in a new `ListDevicesRequest`.
+  string next_page_token = 2;
+}
+
+// Request for `ModifyCloudToDeviceConfig`.
+message ModifyCloudToDeviceConfigRequest {
+  // 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;
+
+  // 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;
+  // otherwise, this update will fail if the version number found on the server
+  // does not match this version number. This is used to support multiple
+  // simultaneous updates without losing data.
+  int64 version_to_update = 2;
+
+  // The configuration data for the device.
+  bytes binary_data = 3;
+}
+
+// Request for `ListDeviceConfigVersions`.
+message ListDeviceConfigVersionsRequest {
+  // 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;
+
+  // 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
+  // value is zero, it will return all the versions available.
+  int32 num_versions = 2;
+}
+
+// Response for `ListDeviceConfigVersions`.
+message ListDeviceConfigVersionsResponse {
+  // The device configuration for the last few versions. Versions are listed
+  // in decreasing order, starting from the most recent one.
+  repeated DeviceConfig device_configs = 1;
+}
+
+// Request for `ListDeviceStates`.
+message ListDeviceStatesRequest {
+  // 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;
+
+  // 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
+  // value is zero, it will return all the states available.
+  int32 num_states = 2;
+}
+
+// Response for `ListDeviceStates`.
+message ListDeviceStatesResponse {
+  // The last few device states. States are listed in descending order of server
+  // update time, starting from the most recent one.
+  repeated DeviceState device_states = 1;
+}
+
+// Request for `SendCommandToDevice`.
+message SendCommandToDeviceRequest {
+  // 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;
+
+  // The command data to send to the device.
+  bytes binary_data = 2;
+
+  // Optional subfolder for the command. If empty, the command will be delivered
+  // to the /devices/{device-id}/commands topic, otherwise it will be delivered
+  // to the /devices/{device-id}/commands/{subfolder} topic. Multi-level
+  // subfolders are allowed. This field must not have more than 256 characters,
+  // and must not contain any MQTT wildcards ("+" or "#") or null characters.
+  string subfolder = 3;
+}
+
+// Response for `SendCommandToDevice`.
+message SendCommandToDeviceResponse {}
+
+// Request for `BindDeviceToGateway`.
+message BindDeviceToGatewayRequest {
+  // 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
+  // user-defined device identifier.
+  string gateway_id = 2;
+
+  // 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;
+}
+
+// Response for `BindDeviceToGateway`.
+message BindDeviceToGatewayResponse {}
+
+// Request for `UnbindDeviceFromGateway`.
+message UnbindDeviceFromGatewayRequest {
+  // 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
+  // user-defined device identifier.
+  string gateway_id = 2;
+
+  // 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;
+}
+
+// Response for `UnbindDeviceFromGateway`.
+message UnbindDeviceFromGatewayResponse {}
diff --git a/iot/google/cloud/iot_v1/proto/device_manager_pb2.py b/iot/google/cloud/iot_v1/proto/device_manager_pb2.py
new file mode 100644
index 000000000000..f4120bfd6d52
--- /dev/null
+++ b/iot/google/cloud/iot_v1/proto/device_manager_pb2.py
@@ -0,0 +1,2368 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/iot_v1/proto/device_manager.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.iot_v1.proto import (
+    resources_pb2 as google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/iot_v1/proto/device_manager.proto",
+    package="google.cloud.iot.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.cloud.iot.v1B\022DeviceManagerProtoP\001Z6google.golang.org/genproto/googleapis/cloud/iot/v1;iot\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/iot_v1/proto/device_manager.proto\x12\x13google.cloud.iot.v1\x1a\x1cgoogle/api/annotations.proto\x1a)google/cloud/iot_v1/proto/resources.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"k\n\x1b\x43reateDeviceRegistryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x0f\x64\x65vice_registry\x18\x02 \x01(\x0b\x32#.google.cloud.iot.v1.DeviceRegistry"(\n\x18GetDeviceRegistryRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"+\n\x1b\x44\x65leteDeviceRegistryRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8c\x01\n\x1bUpdateDeviceRegistryRequest\x12<\n\x0f\x64\x65vice_registry\x18\x01 \x01(\x0b\x32#.google.cloud.iot.v1.DeviceRegistry\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"T\n\x1bListDeviceRegistriesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"w\n\x1cListDeviceRegistriesResponse\x12>\n\x11\x64\x65vice_registries\x18\x01 \x03(\x0b\x32#.google.cloud.iot.v1.DeviceRegistry\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"R\n\x13\x43reateDeviceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12+\n\x06\x64\x65vice\x18\x02 \x01(\x0b\x32\x1b.google.cloud.iot.v1.Device"P\n\x10GetDeviceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"s\n\x13UpdateDeviceRequest\x12+\n\x06\x64\x65vice\x18\x02 \x01(\x0b\x32\x1b.google.cloud.iot.v1.Device\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"#\n\x13\x44\x65leteDeviceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xee\x01\n\x12ListDevicesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x16\n\x0e\x64\x65vice_num_ids\x18\x02 \x03(\x04\x12\x12\n\ndevice_ids\x18\x03 \x03(\t\x12.\n\nfield_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x45\n\x14gateway_list_options\x18\x06 \x01(\x0b\x32\'.google.cloud.iot.v1.GatewayListOptions\x12\x11\n\tpage_size\x18\x64 \x01(\x05\x12\x12\n\npage_token\x18\x65 \x01(\t"\x9d\x01\n\x12GatewayListOptions\x12\x38\n\x0cgateway_type\x18\x01 \x01(\x0e\x32 .google.cloud.iot.v1.GatewayTypeH\x00\x12!\n\x17\x61ssociations_gateway_id\x18\x02 \x01(\tH\x00\x12 \n\x16\x61ssociations_device_id\x18\x03 \x01(\tH\x00\x42\x08\n\x06\x66ilter"\\\n\x13ListDevicesResponse\x12,\n\x07\x64\x65vices\x18\x01 \x03(\x0b\x32\x1b.google.cloud.iot.v1.Device\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"`\n ModifyCloudToDeviceConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x11version_to_update\x18\x02 \x01(\x03\x12\x13\n\x0b\x62inary_data\x18\x03 \x01(\x0c"E\n\x1fListDeviceConfigVersionsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0cnum_versions\x18\x02 \x01(\x05"]\n ListDeviceConfigVersionsResponse\x12\x39\n\x0e\x64\x65vice_configs\x18\x01 \x03(\x0b\x32!.google.cloud.iot.v1.DeviceConfig";\n\x17ListDeviceStatesRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nnum_states\x18\x02 \x01(\x05"S\n\x18ListDeviceStatesResponse\x12\x37\n\rdevice_states\x18\x01 \x03(\x0b\x32 .google.cloud.iot.v1.DeviceState"R\n\x1aSendCommandToDeviceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x62inary_data\x18\x02 \x01(\x0c\x12\x11\n\tsubfolder\x18\x03 \x01(\t"\x1d\n\x1bSendCommandToDeviceResponse"S\n\x1a\x42indDeviceToGatewayRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\ngateway_id\x18\x02 \x01(\t\x12\x11\n\tdevice_id\x18\x03 \x01(\t"\x1d\n\x1b\x42indDeviceToGatewayResponse"W\n\x1eUnbindDeviceFromGatewayRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\ngateway_id\x18\x02 \x01(\t\x12\x11\n\tdevice_id\x18\x03 \x01(\t"!\n\x1fUnbindDeviceFromGatewayResponse2\xe5"\n\rDeviceManager\x12\xb6\x01\n\x14\x43reateDeviceRegistry\x12\x30.google.cloud.iot.v1.CreateDeviceRegistryRequest\x1a#.google.cloud.iot.v1.DeviceRegistry"G\x82\xd3\xe4\x93\x02\x41"./v1/{parent=projects/*/locations/*}/registries:\x0f\x64\x65vice_registry\x12\x9f\x01\n\x11GetDeviceRegistry\x12-.google.cloud.iot.v1.GetDeviceRegistryRequest\x1a#.google.cloud.iot.v1.DeviceRegistry"6\x82\xd3\xe4\x93\x02\x30\x12./v1/{name=projects/*/locations/*/registries/*}\x12\xc6\x01\n\x14UpdateDeviceRegistry\x12\x30.google.cloud.iot.v1.UpdateDeviceRegistryRequest\x1a#.google.cloud.iot.v1.DeviceRegistry"W\x82\xd3\xe4\x93\x02Q2>/v1/{device_registry.name=projects/*/locations/*/registries/*}:\x0f\x64\x65vice_registry\x12\x98\x01\n\x14\x44\x65leteDeviceRegistry\x12\x30.google.cloud.iot.v1.DeleteDeviceRegistryRequest\x1a\x16.google.protobuf.Empty"6\x82\xd3\xe4\x93\x02\x30*./v1/{name=projects/*/locations/*/registries/*}\x12\xb3\x01\n\x14ListDeviceRegistries\x12\x30.google.cloud.iot.v1.ListDeviceRegistriesRequest\x1a\x31.google.cloud.iot.v1.ListDeviceRegistriesResponse"6\x82\xd3\xe4\x93\x02\x30\x12./v1/{parent=projects/*/locations/*}/registries\x12\x9f\x01\n\x0c\x43reateDevice\x12(.google.cloud.iot.v1.CreateDeviceRequest\x1a\x1b.google.cloud.iot.v1.Device"H\x82\xd3\xe4\x93\x02\x42"8/v1/{parent=projects/*/locations/*/registries/*}/devices:\x06\x64\x65vice\x12\xd7\x01\n\tGetDevice\x12%.google.cloud.iot.v1.GetDeviceRequest\x1a\x1b.google.cloud.iot.v1.Device"\x85\x01\x82\xd3\xe4\x93\x02\x7f\x12\x38/v1/{name=projects/*/locations/*/registries/*/devices/*}ZC\x12\x41/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}\x12\xfc\x01\n\x0cUpdateDevice\x12(.google.cloud.iot.v1.UpdateDeviceRequest\x1a\x1b.google.cloud.iot.v1.Device"\xa4\x01\x82\xd3\xe4\x93\x02\x9d\x01\x32?/v1/{device.name=projects/*/locations/*/registries/*/devices/*}:\x06\x64\x65viceZR2H/v1/{device.name=projects/*/locations/*/registries/*/groups/*/devices/*}:\x06\x64\x65vice\x12\x92\x01\n\x0c\x44\x65leteDevice\x12(.google.cloud.iot.v1.DeleteDeviceRequest\x1a\x16.google.protobuf.Empty"@\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/locations/*/registries/*/devices/*}\x12\xe8\x01\n\x0bListDevices\x12\'.google.cloud.iot.v1.ListDevicesRequest\x1a(.google.cloud.iot.v1.ListDevicesResponse"\x85\x01\x82\xd3\xe4\x93\x02\x7f\x12\x38/v1/{parent=projects/*/locations/*/registries/*}/devicesZC\x12\x41/v1/{parent=projects/*/locations/*/registries/*/groups/*}/devices\x12\xb8\x02\n\x19ModifyCloudToDeviceConfig\x12\x35.google.cloud.iot.v1.ModifyCloudToDeviceConfigRequest\x1a!.google.cloud.iot.v1.DeviceConfig"\xc0\x01\x82\xd3\xe4\x93\x02\xb9\x01"R/v1/{name=projects/*/locations/*/registries/*/devices/*}:modifyCloudToDeviceConfig:\x01*Z`"[/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}:modifyCloudToDeviceConfig:\x01*\x12\xae\x02\n\x18ListDeviceConfigVersions\x12\x34.google.cloud.iot.v1.ListDeviceConfigVersionsRequest\x1a\x35.google.cloud.iot.v1.ListDeviceConfigVersionsResponse"\xa4\x01\x82\xd3\xe4\x93\x02\x9d\x01\x12G/v1/{name=projects/*/locations/*/registries/*/devices/*}/configVersionsZR\x12P/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}/configVersions\x12\x86\x02\n\x10ListDeviceStates\x12,.google.cloud.iot.v1.ListDeviceStatesRequest\x1a-.google.cloud.iot.v1.ListDeviceStatesResponse"\x94\x01\x82\xd3\xe4\x93\x02\x8d\x01\x12?/v1/{name=projects/*/locations/*/registries/*/devices/*}/statesZJ\x12H/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}/states\x12\xe6\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9a\x01\x82\xd3\xe4\x93\x02\x93\x01"?/v1/{resource=projects/*/locations/*/registries/*}:setIamPolicy:\x01*ZM"H/v1/{resource=projects/*/locations/*/registries/*/groups/*}:setIamPolicy:\x01*\x12\xe6\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9a\x01\x82\xd3\xe4\x93\x02\x93\x01"?/v1/{resource=projects/*/locations/*/registries/*}:getIamPolicy:\x01*ZM"H/v1/{resource=projects/*/locations/*/registries/*/groups/*}:getIamPolicy:\x01*\x12\x92\x02\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"\xa6\x01\x82\xd3\xe4\x93\x02\x9f\x01"E/v1/{resource=projects/*/locations/*/registries/*}:testIamPermissions:\x01*ZS"N/v1/{resource=projects/*/locations/*/registries/*/groups/*}:testIamPermissions:\x01*\x12\xaf\x02\n\x13SendCommandToDevice\x12/.google.cloud.iot.v1.SendCommandToDeviceRequest\x1a\x30.google.cloud.iot.v1.SendCommandToDeviceResponse"\xb4\x01\x82\xd3\xe4\x93\x02\xad\x01"L/v1/{name=projects/*/locations/*/registries/*/devices/*}:sendCommandToDevice:\x01*ZZ"U/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}:sendCommandToDevice:\x01*\x12\x9f\x02\n\x13\x42indDeviceToGateway\x12/.google.cloud.iot.v1.BindDeviceToGatewayRequest\x1a\x30.google.cloud.iot.v1.BindDeviceToGatewayResponse"\xa4\x01\x82\xd3\xe4\x93\x02\x9d\x01"D/v1/{parent=projects/*/locations/*/registries/*}:bindDeviceToGateway:\x01*ZR"M/v1/{parent=projects/*/locations/*/registries/*/groups/*}:bindDeviceToGateway:\x01*\x12\xb3\x02\n\x17UnbindDeviceFromGateway\x12\x33.google.cloud.iot.v1.UnbindDeviceFromGatewayRequest\x1a\x34.google.cloud.iot.v1.UnbindDeviceFromGatewayResponse"\xac\x01\x82\xd3\xe4\x93\x02\xa5\x01"H/v1/{parent=projects/*/locations/*/registries/*}:unbindDeviceFromGateway:\x01*ZV"Q/v1/{parent=projects/*/locations/*/registries/*/groups/*}:unbindDeviceFromGateway:\x01*Bj\n\x17\x63om.google.cloud.iot.v1B\x12\x44\x65viceManagerProtoP\x01Z6google.golang.org/genproto/googleapis/cloud/iot/v1;iot\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEDEVICEREGISTRYREQUEST = _descriptor.Descriptor(
+    name="CreateDeviceRegistryRequest",
+    full_name="google.cloud.iot.v1.CreateDeviceRegistryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.iot.v1.CreateDeviceRegistryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_registry",
+            full_name="google.cloud.iot.v1.CreateDeviceRegistryRequest.device_registry",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=357,
+    serialized_end=464,
+)
+
+
+_GETDEVICEREGISTRYREQUEST = _descriptor.Descriptor(
+    name="GetDeviceRegistryRequest",
+    full_name="google.cloud.iot.v1.GetDeviceRegistryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.GetDeviceRegistryRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=466,
+    serialized_end=506,
+)
+
+
+_DELETEDEVICEREGISTRYREQUEST = _descriptor.Descriptor(
+    name="DeleteDeviceRegistryRequest",
+    full_name="google.cloud.iot.v1.DeleteDeviceRegistryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.DeleteDeviceRegistryRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=508,
+    serialized_end=551,
+)
+
+
+_UPDATEDEVICEREGISTRYREQUEST = _descriptor.Descriptor(
+    name="UpdateDeviceRegistryRequest",
+    full_name="google.cloud.iot.v1.UpdateDeviceRegistryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="device_registry",
+            full_name="google.cloud.iot.v1.UpdateDeviceRegistryRequest.device_registry",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.iot.v1.UpdateDeviceRegistryRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=554,
+    serialized_end=694,
+)
+
+
+_LISTDEVICEREGISTRIESREQUEST = _descriptor.Descriptor(
+    name="ListDeviceRegistriesRequest",
+    full_name="google.cloud.iot.v1.ListDeviceRegistriesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.iot.v1.ListDeviceRegistriesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.iot.v1.ListDeviceRegistriesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.iot.v1.ListDeviceRegistriesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=696,
+    serialized_end=780,
+)
+
+
+_LISTDEVICEREGISTRIESRESPONSE = _descriptor.Descriptor(
+    name="ListDeviceRegistriesResponse",
+    full_name="google.cloud.iot.v1.ListDeviceRegistriesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="device_registries",
+            full_name="google.cloud.iot.v1.ListDeviceRegistriesResponse.device_registries",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.iot.v1.ListDeviceRegistriesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=782,
+    serialized_end=901,
+)
+
+
+_CREATEDEVICEREQUEST = _descriptor.Descriptor(
+    name="CreateDeviceRequest",
+    full_name="google.cloud.iot.v1.CreateDeviceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.iot.v1.CreateDeviceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device",
+            full_name="google.cloud.iot.v1.CreateDeviceRequest.device",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=903,
+    serialized_end=985,
+)
+
+
+_GETDEVICEREQUEST = _descriptor.Descriptor(
+    name="GetDeviceRequest",
+    full_name="google.cloud.iot.v1.GetDeviceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.GetDeviceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.iot.v1.GetDeviceRequest.field_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=987,
+    serialized_end=1067,
+)
+
+
+_UPDATEDEVICEREQUEST = _descriptor.Descriptor(
+    name="UpdateDeviceRequest",
+    full_name="google.cloud.iot.v1.UpdateDeviceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="device",
+            full_name="google.cloud.iot.v1.UpdateDeviceRequest.device",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.iot.v1.UpdateDeviceRequest.update_mask",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1069,
+    serialized_end=1184,
+)
+
+
+_DELETEDEVICEREQUEST = _descriptor.Descriptor(
+    name="DeleteDeviceRequest",
+    full_name="google.cloud.iot.v1.DeleteDeviceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.DeleteDeviceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1186,
+    serialized_end=1221,
+)
+
+
+_LISTDEVICESREQUEST = _descriptor.Descriptor(
+    name="ListDevicesRequest",
+    full_name="google.cloud.iot.v1.ListDevicesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_num_ids",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.device_num_ids",
+            index=1,
+            number=2,
+            type=4,
+            cpp_type=4,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_ids",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.device_ids",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.field_mask",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gateway_list_options",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.gateway_list_options",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.page_size",
+            index=5,
+            number=100,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.iot.v1.ListDevicesRequest.page_token",
+            index=6,
+            number=101,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1224,
+    serialized_end=1462,
+)
+
+
+_GATEWAYLISTOPTIONS = _descriptor.Descriptor(
+    name="GatewayListOptions",
+    full_name="google.cloud.iot.v1.GatewayListOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gateway_type",
+            full_name="google.cloud.iot.v1.GatewayListOptions.gateway_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="associations_gateway_id",
+            full_name="google.cloud.iot.v1.GatewayListOptions.associations_gateway_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="associations_device_id",
+            full_name="google.cloud.iot.v1.GatewayListOptions.associations_device_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="filter",
+            full_name="google.cloud.iot.v1.GatewayListOptions.filter",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1465,
+    serialized_end=1622,
+)
+
+
+_LISTDEVICESRESPONSE = _descriptor.Descriptor(
+    name="ListDevicesResponse",
+    full_name="google.cloud.iot.v1.ListDevicesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="devices",
+            full_name="google.cloud.iot.v1.ListDevicesResponse.devices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.iot.v1.ListDevicesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1624,
+    serialized_end=1716,
+)
+
+
+_MODIFYCLOUDTODEVICECONFIGREQUEST = _descriptor.Descriptor(
+    name="ModifyCloudToDeviceConfigRequest",
+    full_name="google.cloud.iot.v1.ModifyCloudToDeviceConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.ModifyCloudToDeviceConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version_to_update",
+            full_name="google.cloud.iot.v1.ModifyCloudToDeviceConfigRequest.version_to_update",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_data",
+            full_name="google.cloud.iot.v1.ModifyCloudToDeviceConfigRequest.binary_data",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1718,
+    serialized_end=1814,
+)
+
+
+_LISTDEVICECONFIGVERSIONSREQUEST = _descriptor.Descriptor(
+    name="ListDeviceConfigVersionsRequest",
+    full_name="google.cloud.iot.v1.ListDeviceConfigVersionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.ListDeviceConfigVersionsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_versions",
+            full_name="google.cloud.iot.v1.ListDeviceConfigVersionsRequest.num_versions",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1816,
+    serialized_end=1885,
+)
+
+
+_LISTDEVICECONFIGVERSIONSRESPONSE = _descriptor.Descriptor(
+    name="ListDeviceConfigVersionsResponse",
+    full_name="google.cloud.iot.v1.ListDeviceConfigVersionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="device_configs",
+            full_name="google.cloud.iot.v1.ListDeviceConfigVersionsResponse.device_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1887,
+    serialized_end=1980,
+)
+
+
+_LISTDEVICESTATESREQUEST = _descriptor.Descriptor(
+    name="ListDeviceStatesRequest",
+    full_name="google.cloud.iot.v1.ListDeviceStatesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.ListDeviceStatesRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_states",
+            full_name="google.cloud.iot.v1.ListDeviceStatesRequest.num_states",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1982,
+    serialized_end=2041,
+)
+
+
+_LISTDEVICESTATESRESPONSE = _descriptor.Descriptor(
+    name="ListDeviceStatesResponse",
+    full_name="google.cloud.iot.v1.ListDeviceStatesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="device_states",
+            full_name="google.cloud.iot.v1.ListDeviceStatesResponse.device_states",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2043,
+    serialized_end=2126,
+)
+
+
+_SENDCOMMANDTODEVICEREQUEST = _descriptor.Descriptor(
+    name="SendCommandToDeviceRequest",
+    full_name="google.cloud.iot.v1.SendCommandToDeviceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.SendCommandToDeviceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_data",
+            full_name="google.cloud.iot.v1.SendCommandToDeviceRequest.binary_data",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subfolder",
+            full_name="google.cloud.iot.v1.SendCommandToDeviceRequest.subfolder",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2128,
+    serialized_end=2210,
+)
+
+
+_SENDCOMMANDTODEVICERESPONSE = _descriptor.Descriptor(
+    name="SendCommandToDeviceResponse",
+    full_name="google.cloud.iot.v1.SendCommandToDeviceResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2212,
+    serialized_end=2241,
+)
+
+
+_BINDDEVICETOGATEWAYREQUEST = _descriptor.Descriptor(
+    name="BindDeviceToGatewayRequest",
+    full_name="google.cloud.iot.v1.BindDeviceToGatewayRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.iot.v1.BindDeviceToGatewayRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gateway_id",
+            full_name="google.cloud.iot.v1.BindDeviceToGatewayRequest.gateway_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_id",
+            full_name="google.cloud.iot.v1.BindDeviceToGatewayRequest.device_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2243,
+    serialized_end=2326,
+)
+
+
+_BINDDEVICETOGATEWAYRESPONSE = _descriptor.Descriptor(
+    name="BindDeviceToGatewayResponse",
+    full_name="google.cloud.iot.v1.BindDeviceToGatewayResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2328,
+    serialized_end=2357,
+)
+
+
+_UNBINDDEVICEFROMGATEWAYREQUEST = _descriptor.Descriptor(
+    name="UnbindDeviceFromGatewayRequest",
+    full_name="google.cloud.iot.v1.UnbindDeviceFromGatewayRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.iot.v1.UnbindDeviceFromGatewayRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gateway_id",
+            full_name="google.cloud.iot.v1.UnbindDeviceFromGatewayRequest.gateway_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_id",
+            full_name="google.cloud.iot.v1.UnbindDeviceFromGatewayRequest.device_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2359,
+    serialized_end=2446,
+)
+
+
+_UNBINDDEVICEFROMGATEWAYRESPONSE = _descriptor.Descriptor(
+    name="UnbindDeviceFromGatewayResponse",
+    full_name="google.cloud.iot.v1.UnbindDeviceFromGatewayResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2448,
+    serialized_end=2481,
+)
+
+_CREATEDEVICEREGISTRYREQUEST.fields_by_name[
+    "device_registry"
+].message_type = (
+    google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICEREGISTRY
+)
+_UPDATEDEVICEREGISTRYREQUEST.fields_by_name[
+    "device_registry"
+].message_type = (
+    google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICEREGISTRY
+)
+_UPDATEDEVICEREGISTRYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTDEVICEREGISTRIESRESPONSE.fields_by_name[
+    "device_registries"
+].message_type = (
+    google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICEREGISTRY
+)
+_CREATEDEVICEREQUEST.fields_by_name[
+    "device"
+].message_type = google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICE
+_GETDEVICEREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEDEVICEREQUEST.fields_by_name[
+    "device"
+].message_type = google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICE
+_UPDATEDEVICEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTDEVICESREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTDEVICESREQUEST.fields_by_name[
+    "gateway_list_options"
+].message_type = _GATEWAYLISTOPTIONS
+_GATEWAYLISTOPTIONS.fields_by_name[
+    "gateway_type"
+].enum_type = google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._GATEWAYTYPE
+_GATEWAYLISTOPTIONS.oneofs_by_name["filter"].fields.append(
+    _GATEWAYLISTOPTIONS.fields_by_name["gateway_type"]
+)
+_GATEWAYLISTOPTIONS.fields_by_name[
+    "gateway_type"
+].containing_oneof = _GATEWAYLISTOPTIONS.oneofs_by_name["filter"]
+_GATEWAYLISTOPTIONS.oneofs_by_name["filter"].fields.append(
+    _GATEWAYLISTOPTIONS.fields_by_name["associations_gateway_id"]
+)
+_GATEWAYLISTOPTIONS.fields_by_name[
+    "associations_gateway_id"
+].containing_oneof = _GATEWAYLISTOPTIONS.oneofs_by_name["filter"]
+_GATEWAYLISTOPTIONS.oneofs_by_name["filter"].fields.append(
+    _GATEWAYLISTOPTIONS.fields_by_name["associations_device_id"]
+)
+_GATEWAYLISTOPTIONS.fields_by_name[
+    "associations_device_id"
+].containing_oneof = _GATEWAYLISTOPTIONS.oneofs_by_name["filter"]
+_LISTDEVICESRESPONSE.fields_by_name[
+    "devices"
+].message_type = google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICE
+_LISTDEVICECONFIGVERSIONSRESPONSE.fields_by_name[
+    "device_configs"
+].message_type = google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICECONFIG
+_LISTDEVICESTATESRESPONSE.fields_by_name[
+    "device_states"
+].message_type = google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICESTATE
+DESCRIPTOR.message_types_by_name[
+    "CreateDeviceRegistryRequest"
+] = _CREATEDEVICEREGISTRYREQUEST
+DESCRIPTOR.message_types_by_name["GetDeviceRegistryRequest"] = _GETDEVICEREGISTRYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteDeviceRegistryRequest"
+] = _DELETEDEVICEREGISTRYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateDeviceRegistryRequest"
+] = _UPDATEDEVICEREGISTRYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDeviceRegistriesRequest"
+] = _LISTDEVICEREGISTRIESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDeviceRegistriesResponse"
+] = _LISTDEVICEREGISTRIESRESPONSE
+DESCRIPTOR.message_types_by_name["CreateDeviceRequest"] = _CREATEDEVICEREQUEST
+DESCRIPTOR.message_types_by_name["GetDeviceRequest"] = _GETDEVICEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateDeviceRequest"] = _UPDATEDEVICEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteDeviceRequest"] = _DELETEDEVICEREQUEST
+DESCRIPTOR.message_types_by_name["ListDevicesRequest"] = _LISTDEVICESREQUEST
+DESCRIPTOR.message_types_by_name["GatewayListOptions"] = _GATEWAYLISTOPTIONS
+DESCRIPTOR.message_types_by_name["ListDevicesResponse"] = _LISTDEVICESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ModifyCloudToDeviceConfigRequest"
+] = _MODIFYCLOUDTODEVICECONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDeviceConfigVersionsRequest"
+] = _LISTDEVICECONFIGVERSIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListDeviceConfigVersionsResponse"
+] = _LISTDEVICECONFIGVERSIONSRESPONSE
+DESCRIPTOR.message_types_by_name["ListDeviceStatesRequest"] = _LISTDEVICESTATESREQUEST
+DESCRIPTOR.message_types_by_name["ListDeviceStatesResponse"] = _LISTDEVICESTATESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "SendCommandToDeviceRequest"
+] = _SENDCOMMANDTODEVICEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SendCommandToDeviceResponse"
+] = _SENDCOMMANDTODEVICERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BindDeviceToGatewayRequest"
+] = _BINDDEVICETOGATEWAYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BindDeviceToGatewayResponse"
+] = _BINDDEVICETOGATEWAYRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "UnbindDeviceFromGatewayRequest"
+] = _UNBINDDEVICEFROMGATEWAYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UnbindDeviceFromGatewayResponse"
+] = _UNBINDDEVICEFROMGATEWAYRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateDeviceRegistryRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDeviceRegistryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDEVICEREGISTRYREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``CreateDeviceRegistry``.
+  
+  
+  Attributes:
+      parent:
+          The project and cloud region where this device registry must
+          be created. For example, ``projects/example-
+          project/locations/us-central1``.
+      device_registry:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.CreateDeviceRegistryRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDeviceRegistryRequest)
+
+GetDeviceRegistryRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDeviceRegistryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDEVICEREGISTRYREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``GetDeviceRegistry``.
+  
+  
+  Attributes:
+      name:
+          The name of the device registry. For example,
+          ``projects/example-project/locations/us-
+          central1/registries/my-registry``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.GetDeviceRegistryRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDeviceRegistryRequest)
+
+DeleteDeviceRegistryRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDeviceRegistryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDEVICEREGISTRYREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``DeleteDeviceRegistry``.
+  
+  
+  Attributes:
+      name:
+          The name of the device registry. For example,
+          ``projects/example-project/locations/us-
+          central1/registries/my-registry``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.DeleteDeviceRegistryRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDeviceRegistryRequest)
+
+UpdateDeviceRegistryRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDeviceRegistryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDEVICEREGISTRYREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``UpdateDeviceRegistry``.
+  
+  
+  Attributes:
+      device_registry:
+          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``.
+      update_mask:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.UpdateDeviceRegistryRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDeviceRegistryRequest)
+
+ListDeviceRegistriesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDeviceRegistriesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICEREGISTRIESREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``ListDeviceRegistries``.
+  
+  
+  Attributes:
+      parent:
+          The project and cloud region path. For example,
+          ``projects/example-project/locations/us-central1``.
+      page_size:
+          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 objects than requested. A non-empty
+          ``next_page_token`` in the response indicates that more data
+          is available.
+      page_token:
+          The value returned by the last
+          ``ListDeviceRegistriesResponse``; indicates that this is a
+          continuation of a prior ``ListDeviceRegistries`` call and the
+          system should return the next page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDeviceRegistriesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDeviceRegistriesRequest)
+
+ListDeviceRegistriesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDeviceRegistriesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICEREGISTRIESRESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``ListDeviceRegistries``.
+  
+  
+  Attributes:
+      device_registries:
+          The registries that matched the query.
+      next_page_token:
+          If not empty, indicates that there may be more registries that
+          match the request; this value should be passed in a new
+          ``ListDeviceRegistriesRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDeviceRegistriesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDeviceRegistriesResponse)
+
+CreateDeviceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDeviceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDEVICEREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``CreateDevice``.
+  
+  
+  Attributes:
+      parent:
+          The name of the device registry where this device should be
+          created. For example, ``projects/example-project/locations/us-
+          central1/registries/my-registry``.
+      device:
+          The device registration details. The field ``name`` must be
+          empty. The server generates ``name`` from the device registry
+          ``id`` and the ``parent`` field.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.CreateDeviceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDeviceRequest)
+
+GetDeviceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDeviceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDEVICEREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``GetDevice``.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      field_mask:
+          The fields of the ``Device`` resource to be returned in the
+          response. If the field mask is unset or empty, all fields are
+          returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.GetDeviceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDeviceRequest)
+
+UpdateDeviceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDeviceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDEVICEREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``UpdateDevice``.
+  
+  
+  Attributes:
+      device:
+          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}``.
+      update_mask:
+          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``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.UpdateDeviceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDeviceRequest)
+
+DeleteDeviceRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteDeviceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEDEVICEREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``DeleteDevice``.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.DeleteDeviceRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteDeviceRequest)
+
+ListDevicesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDevicesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICESREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``ListDevices``.
+  
+  
+  Attributes:
+      parent:
+          The device registry path. Required. For example,
+          ``projects/my-project/locations/us-central1/registries/my-
+          registry``.
+      device_num_ids:
+          A list of device numeric IDs. If empty, this field is ignored.
+          Maximum IDs: 10,000.
+      device_ids:
+          A list of device string IDs. For example, ``['device0',
+          'device12']``. If empty, this field is ignored. Maximum IDs:
+          10,000
+      field_mask:
+          The fields of the ``Device`` resource to be returned in the
+          response. The fields ``id`` and ``num_id`` are always
+          returned, along with any other fields specified.
+      gateway_list_options:
+          Options related to gateways.
+      page_size:
+          The maximum number of devices to return in the response. If
+          this value is zero, the service will select a default size. A
+          call may return fewer objects than requested. A non-empty
+          ``next_page_token`` in the response indicates that more data
+          is available.
+      page_token:
+          The value returned by the last ``ListDevicesResponse``;
+          indicates that this is a continuation of a prior
+          ``ListDevices`` call and the system should return the next
+          page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDevicesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDevicesRequest)
+
+GatewayListOptions = _reflection.GeneratedProtocolMessageType(
+    "GatewayListOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GATEWAYLISTOPTIONS,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Options for limiting the list based on gateway type and associations.
+  
+  
+  Attributes:
+      filter:
+          If not set, all devices and gateways are returned. If set, the
+          list is filtered based on gateway type and associations.
+      gateway_type:
+          If ``GATEWAY`` is specified, only gateways are returned. If
+          ``NON_GATEWAY`` is specified, only non-gateway devices are
+          returned. If ``GATEWAY_TYPE_UNSPECIFIED`` is specified, all
+          devices are returned.
+      associations_gateway_id:
+          If set, only devices associated with the specified gateway are
+          returned. The gateway ID can be numeric (``num_id``) or the
+          user-defined string (``id``). For example, if ``123`` is
+          specified, only devices bound to the gateway with ``num_id``
+          123 are returned.
+      associations_device_id:
+          If set, returns only the gateways with which the specified
+          device is associated. The device ID can be numeric
+          (``num_id``) or the user-defined string (``id``). For example,
+          if ``456`` is specified, returns only the gateways to which
+          the device with ``num_id`` 456 is bound.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.GatewayListOptions)
+    ),
+)
+_sym_db.RegisterMessage(GatewayListOptions)
+
+ListDevicesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDevicesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICESRESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``ListDevices``.
+  
+  
+  Attributes:
+      devices:
+          The devices that match the request.
+      next_page_token:
+          If not empty, indicates that there may be more devices that
+          match the request; this value should be passed in a new
+          ``ListDevicesRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDevicesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDevicesResponse)
+
+ModifyCloudToDeviceConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "ModifyCloudToDeviceConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODIFYCLOUDTODEVICECONFIGREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``ModifyCloudToDeviceConfig``.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      version_to_update:
+          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; otherwise, this update will fail
+          if the version number found on the server does not match this
+          version number. This is used to support multiple simultaneous
+          updates without losing data.
+      binary_data:
+          The configuration data for the device.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ModifyCloudToDeviceConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(ModifyCloudToDeviceConfigRequest)
+
+ListDeviceConfigVersionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDeviceConfigVersionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICECONFIGVERSIONSREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``ListDeviceConfigVersions``.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      num_versions:
+          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 value is zero, it will return
+          all the versions available.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDeviceConfigVersionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDeviceConfigVersionsRequest)
+
+ListDeviceConfigVersionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDeviceConfigVersionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICECONFIGVERSIONSRESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``ListDeviceConfigVersions``.
+  
+  
+  Attributes:
+      device_configs:
+          The device configuration for the last few versions. Versions
+          are listed in decreasing order, starting from the most recent
+          one.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDeviceConfigVersionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDeviceConfigVersionsResponse)
+
+ListDeviceStatesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDeviceStatesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICESTATESREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``ListDeviceStates``.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      num_states:
+          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 value is zero, it will return all the states
+          available.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDeviceStatesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDeviceStatesRequest)
+
+ListDeviceStatesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDeviceStatesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDEVICESTATESRESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``ListDeviceStates``.
+  
+  
+  Attributes:
+      device_states:
+          The last few device states. States are listed in descending
+          order of server update time, starting from the most recent
+          one.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.ListDeviceStatesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDeviceStatesResponse)
+
+SendCommandToDeviceRequest = _reflection.GeneratedProtocolMessageType(
+    "SendCommandToDeviceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENDCOMMANDTODEVICEREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``SendCommandToDevice``.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      binary_data:
+          The command data to send to the device.
+      subfolder:
+          Optional subfolder for the command. If empty, the command will
+          be delivered to the /devices/{device-id}/commands topic,
+          otherwise it will be delivered to the /devices/{device-
+          id}/commands/{subfolder} topic. Multi-level subfolders are
+          allowed. This field must not have more than 256 characters,
+          and must not contain any MQTT wildcards ("+" or "#") or null
+          characters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.SendCommandToDeviceRequest)
+    ),
+)
+_sym_db.RegisterMessage(SendCommandToDeviceRequest)
+
+SendCommandToDeviceResponse = _reflection.GeneratedProtocolMessageType(
+    "SendCommandToDeviceResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENDCOMMANDTODEVICERESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``SendCommandToDevice``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.SendCommandToDeviceResponse)
+    ),
+)
+_sym_db.RegisterMessage(SendCommandToDeviceResponse)
+
+BindDeviceToGatewayRequest = _reflection.GeneratedProtocolMessageType(
+    "BindDeviceToGatewayRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BINDDEVICETOGATEWAYREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``BindDeviceToGateway``.
+  
+  
+  Attributes:
+      parent:
+          The name of the registry. For example, ``projects/example-
+          project/locations/us-central1/registries/my-registry``.
+      gateway_id:
+          The value of ``gateway_id`` can be either the device numeric
+          ID or the user-defined device identifier.
+      device_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.BindDeviceToGatewayRequest)
+    ),
+)
+_sym_db.RegisterMessage(BindDeviceToGatewayRequest)
+
+BindDeviceToGatewayResponse = _reflection.GeneratedProtocolMessageType(
+    "BindDeviceToGatewayResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BINDDEVICETOGATEWAYRESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``BindDeviceToGateway``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.BindDeviceToGatewayResponse)
+    ),
+)
+_sym_db.RegisterMessage(BindDeviceToGatewayResponse)
+
+UnbindDeviceFromGatewayRequest = _reflection.GeneratedProtocolMessageType(
+    "UnbindDeviceFromGatewayRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UNBINDDEVICEFROMGATEWAYREQUEST,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Request for ``UnbindDeviceFromGateway``.
+  
+  
+  Attributes:
+      parent:
+          The name of the registry. For example, ``projects/example-
+          project/locations/us-central1/registries/my-registry``.
+      gateway_id:
+          The value of ``gateway_id`` can be either the device numeric
+          ID or the user-defined device identifier.
+      device_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.UnbindDeviceFromGatewayRequest)
+    ),
+)
+_sym_db.RegisterMessage(UnbindDeviceFromGatewayRequest)
+
+UnbindDeviceFromGatewayResponse = _reflection.GeneratedProtocolMessageType(
+    "UnbindDeviceFromGatewayResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UNBINDDEVICEFROMGATEWAYRESPONSE,
+        __module__="google.cloud.iot_v1.proto.device_manager_pb2",
+        __doc__="""Response for ``UnbindDeviceFromGateway``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.UnbindDeviceFromGatewayResponse)
+    ),
+)
+_sym_db.RegisterMessage(UnbindDeviceFromGatewayResponse)
+
+
+DESCRIPTOR._options = None
+
+_DEVICEMANAGER = _descriptor.ServiceDescriptor(
+    name="DeviceManager",
+    full_name="google.cloud.iot.v1.DeviceManager",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2484,
+    serialized_end=6937,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateDeviceRegistry",
+            full_name="google.cloud.iot.v1.DeviceManager.CreateDeviceRegistry",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEDEVICEREGISTRYREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICEREGISTRY,
+            serialized_options=_b(
+                '\202\323\344\223\002A"./v1/{parent=projects/*/locations/*}/registries:\017device_registry'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDeviceRegistry",
+            full_name="google.cloud.iot.v1.DeviceManager.GetDeviceRegistry",
+            index=1,
+            containing_service=None,
+            input_type=_GETDEVICEREGISTRYREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICEREGISTRY,
+            serialized_options=_b(
+                "\202\323\344\223\0020\022./v1/{name=projects/*/locations/*/registries/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDeviceRegistry",
+            full_name="google.cloud.iot.v1.DeviceManager.UpdateDeviceRegistry",
+            index=2,
+            containing_service=None,
+            input_type=_UPDATEDEVICEREGISTRYREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICEREGISTRY,
+            serialized_options=_b(
+                "\202\323\344\223\002Q2>/v1/{device_registry.name=projects/*/locations/*/registries/*}:\017device_registry"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDeviceRegistry",
+            full_name="google.cloud.iot.v1.DeviceManager.DeleteDeviceRegistry",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEDEVICEREGISTRYREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0020*./v1/{name=projects/*/locations/*/registries/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDeviceRegistries",
+            full_name="google.cloud.iot.v1.DeviceManager.ListDeviceRegistries",
+            index=4,
+            containing_service=None,
+            input_type=_LISTDEVICEREGISTRIESREQUEST,
+            output_type=_LISTDEVICEREGISTRIESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0020\022./v1/{parent=projects/*/locations/*}/registries"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDevice",
+            full_name="google.cloud.iot.v1.DeviceManager.CreateDevice",
+            index=5,
+            containing_service=None,
+            input_type=_CREATEDEVICEREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICE,
+            serialized_options=_b(
+                '\202\323\344\223\002B"8/v1/{parent=projects/*/locations/*/registries/*}/devices:\006device'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDevice",
+            full_name="google.cloud.iot.v1.DeviceManager.GetDevice",
+            index=6,
+            containing_service=None,
+            input_type=_GETDEVICEREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICE,
+            serialized_options=_b(
+                "\202\323\344\223\002\177\0228/v1/{name=projects/*/locations/*/registries/*/devices/*}ZC\022A/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDevice",
+            full_name="google.cloud.iot.v1.DeviceManager.UpdateDevice",
+            index=7,
+            containing_service=None,
+            input_type=_UPDATEDEVICEREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICE,
+            serialized_options=_b(
+                "\202\323\344\223\002\235\0012?/v1/{device.name=projects/*/locations/*/registries/*/devices/*}:\006deviceZR2H/v1/{device.name=projects/*/locations/*/registries/*/groups/*/devices/*}:\006device"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteDevice",
+            full_name="google.cloud.iot.v1.DeviceManager.DeleteDevice",
+            index=8,
+            containing_service=None,
+            input_type=_DELETEDEVICEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002:*8/v1/{name=projects/*/locations/*/registries/*/devices/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDevices",
+            full_name="google.cloud.iot.v1.DeviceManager.ListDevices",
+            index=9,
+            containing_service=None,
+            input_type=_LISTDEVICESREQUEST,
+            output_type=_LISTDEVICESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\177\0228/v1/{parent=projects/*/locations/*/registries/*}/devicesZC\022A/v1/{parent=projects/*/locations/*/registries/*/groups/*}/devices"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ModifyCloudToDeviceConfig",
+            full_name="google.cloud.iot.v1.DeviceManager.ModifyCloudToDeviceConfig",
+            index=10,
+            containing_service=None,
+            input_type=_MODIFYCLOUDTODEVICECONFIGREQUEST,
+            output_type=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2._DEVICECONFIG,
+            serialized_options=_b(
+                '\202\323\344\223\002\271\001"R/v1/{name=projects/*/locations/*/registries/*/devices/*}:modifyCloudToDeviceConfig:\001*Z`"[/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}:modifyCloudToDeviceConfig:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDeviceConfigVersions",
+            full_name="google.cloud.iot.v1.DeviceManager.ListDeviceConfigVersions",
+            index=11,
+            containing_service=None,
+            input_type=_LISTDEVICECONFIGVERSIONSREQUEST,
+            output_type=_LISTDEVICECONFIGVERSIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\235\001\022G/v1/{name=projects/*/locations/*/registries/*/devices/*}/configVersionsZR\022P/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}/configVersions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListDeviceStates",
+            full_name="google.cloud.iot.v1.DeviceManager.ListDeviceStates",
+            index=12,
+            containing_service=None,
+            input_type=_LISTDEVICESTATESREQUEST,
+            output_type=_LISTDEVICESTATESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\215\001\022?/v1/{name=projects/*/locations/*/registries/*/devices/*}/statesZJ\022H/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}/states"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.iot.v1.DeviceManager.SetIamPolicy",
+            index=13,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002\223\001"?/v1/{resource=projects/*/locations/*/registries/*}:setIamPolicy:\001*ZM"H/v1/{resource=projects/*/locations/*/registries/*/groups/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.iot.v1.DeviceManager.GetIamPolicy",
+            index=14,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002\223\001"?/v1/{resource=projects/*/locations/*/registries/*}:getIamPolicy:\001*ZM"H/v1/{resource=projects/*/locations/*/registries/*/groups/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.iot.v1.DeviceManager.TestIamPermissions",
+            index=15,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\237\001"E/v1/{resource=projects/*/locations/*/registries/*}:testIamPermissions:\001*ZS"N/v1/{resource=projects/*/locations/*/registries/*/groups/*}:testIamPermissions:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SendCommandToDevice",
+            full_name="google.cloud.iot.v1.DeviceManager.SendCommandToDevice",
+            index=16,
+            containing_service=None,
+            input_type=_SENDCOMMANDTODEVICEREQUEST,
+            output_type=_SENDCOMMANDTODEVICERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\255\001"L/v1/{name=projects/*/locations/*/registries/*/devices/*}:sendCommandToDevice:\001*ZZ"U/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}:sendCommandToDevice:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BindDeviceToGateway",
+            full_name="google.cloud.iot.v1.DeviceManager.BindDeviceToGateway",
+            index=17,
+            containing_service=None,
+            input_type=_BINDDEVICETOGATEWAYREQUEST,
+            output_type=_BINDDEVICETOGATEWAYRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\235\001"D/v1/{parent=projects/*/locations/*/registries/*}:bindDeviceToGateway:\001*ZR"M/v1/{parent=projects/*/locations/*/registries/*/groups/*}:bindDeviceToGateway:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UnbindDeviceFromGateway",
+            full_name="google.cloud.iot.v1.DeviceManager.UnbindDeviceFromGateway",
+            index=18,
+            containing_service=None,
+            input_type=_UNBINDDEVICEFROMGATEWAYREQUEST,
+            output_type=_UNBINDDEVICEFROMGATEWAYRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\245\001"H/v1/{parent=projects/*/locations/*/registries/*}:unbindDeviceFromGateway:\001*ZV"Q/v1/{parent=projects/*/locations/*/registries/*/groups/*}:unbindDeviceFromGateway:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DEVICEMANAGER)
+
+DESCRIPTOR.services_by_name["DeviceManager"] = _DEVICEMANAGER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/iot/google/cloud/iot_v1/proto/device_manager_pb2_grpc.py b/iot/google/cloud/iot_v1/proto/device_manager_pb2_grpc.py
new file mode 100644
index 000000000000..2b16c3039d6e
--- /dev/null
+++ b/iot/google/cloud/iot_v1/proto/device_manager_pb2_grpc.py
@@ -0,0 +1,382 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.iot_v1.proto import (
+    device_manager_pb2 as google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2,
+)
+from google.cloud.iot_v1.proto import (
+    resources_pb2 as google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DeviceManagerStub(object):
+    """Internet of Things (IoT) service. Securely connect and manage IoT devices.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateDeviceRegistry = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/CreateDeviceRegistry",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.CreateDeviceRegistryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceRegistry.FromString,
+        )
+        self.GetDeviceRegistry = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/GetDeviceRegistry",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.GetDeviceRegistryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceRegistry.FromString,
+        )
+        self.UpdateDeviceRegistry = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/UpdateDeviceRegistry",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UpdateDeviceRegistryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceRegistry.FromString,
+        )
+        self.DeleteDeviceRegistry = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/DeleteDeviceRegistry",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.DeleteDeviceRegistryRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListDeviceRegistries = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/ListDeviceRegistries",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceRegistriesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceRegistriesResponse.FromString,
+        )
+        self.CreateDevice = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/CreateDevice",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.CreateDeviceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.Device.FromString,
+        )
+        self.GetDevice = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/GetDevice",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.GetDeviceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.Device.FromString,
+        )
+        self.UpdateDevice = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/UpdateDevice",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UpdateDeviceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.Device.FromString,
+        )
+        self.DeleteDevice = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/DeleteDevice",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.DeleteDeviceRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListDevices = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/ListDevices",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDevicesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDevicesResponse.FromString,
+        )
+        self.ModifyCloudToDeviceConfig = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/ModifyCloudToDeviceConfig",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ModifyCloudToDeviceConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceConfig.FromString,
+        )
+        self.ListDeviceConfigVersions = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/ListDeviceConfigVersions",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceConfigVersionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceConfigVersionsResponse.FromString,
+        )
+        self.ListDeviceStates = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/ListDeviceStates",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceStatesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceStatesResponse.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+        self.SendCommandToDevice = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/SendCommandToDevice",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.SendCommandToDeviceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.SendCommandToDeviceResponse.FromString,
+        )
+        self.BindDeviceToGateway = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/BindDeviceToGateway",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.BindDeviceToGatewayRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.BindDeviceToGatewayResponse.FromString,
+        )
+        self.UnbindDeviceFromGateway = channel.unary_unary(
+            "/google.cloud.iot.v1.DeviceManager/UnbindDeviceFromGateway",
+            request_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UnbindDeviceFromGatewayRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UnbindDeviceFromGatewayResponse.FromString,
+        )
+
+
+class DeviceManagerServicer(object):
+    """Internet of Things (IoT) service. Securely connect and manage IoT devices.
+  """
+
+    def CreateDeviceRegistry(self, request, context):
+        """Creates a device registry that contains devices.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDeviceRegistry(self, request, context):
+        """Gets a device registry configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDeviceRegistry(self, request, context):
+        """Updates a device registry configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDeviceRegistry(self, request, context):
+        """Deletes a device registry configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDeviceRegistries(self, request, context):
+        """Lists device registries.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDevice(self, request, context):
+        """Creates a device in a device registry.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDevice(self, request, context):
+        """Gets details about a device.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDevice(self, request, context):
+        """Updates a device.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteDevice(self, request, context):
+        """Deletes a device.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDevices(self, request, context):
+        """List devices in a device registry.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ModifyCloudToDeviceConfig(self, request, context):
+        """Modifies the configuration for the device, which is eventually sent from
+    the Cloud IoT Core servers. Returns the modified configuration version and
+    its metadata.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDeviceConfigVersions(self, request, context):
+        """Lists the last few versions of the device configuration in descending
+    order (i.e.: newest first).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListDeviceStates(self, request, context):
+        """Lists the last few versions of the device state in descending order (i.e.:
+    newest first).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on the specified resource. Replaces any
+    existing policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for a resource.
+    Returns an empty policy if the resource exists and does not have a policy
+    set.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SendCommandToDevice(self, request, context):
+        """Sends a command to the specified device. In order for a device to be able
+    to receive commands, it must:
+    1) be connected to Cloud IoT Core using the MQTT protocol, and
+    2) be subscribed to the group of MQTT topics specified by
+    /devices/{device-id}/commands/#. This subscription will receive commands
+    at the top-level topic /devices/{device-id}/commands as well as commands
+    for subfolders, like /devices/{device-id}/commands/subfolder.
+    Note that subscribing to specific subfolders is not supported.
+    If the command could not be delivered to the device, this method will
+    return an error; in particular, if the device is not subscribed, this
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BindDeviceToGateway(self, request, context):
+        """Associates the device with the gateway.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UnbindDeviceFromGateway(self, request, context):
+        """Deletes the association between the device and the gateway.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DeviceManagerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateDeviceRegistry": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDeviceRegistry,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.CreateDeviceRegistryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceRegistry.SerializeToString,
+        ),
+        "GetDeviceRegistry": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDeviceRegistry,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.GetDeviceRegistryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceRegistry.SerializeToString,
+        ),
+        "UpdateDeviceRegistry": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDeviceRegistry,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UpdateDeviceRegistryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceRegistry.SerializeToString,
+        ),
+        "DeleteDeviceRegistry": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDeviceRegistry,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.DeleteDeviceRegistryRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListDeviceRegistries": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDeviceRegistries,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceRegistriesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceRegistriesResponse.SerializeToString,
+        ),
+        "CreateDevice": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDevice,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.CreateDeviceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.Device.SerializeToString,
+        ),
+        "GetDevice": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDevice,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.GetDeviceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.Device.SerializeToString,
+        ),
+        "UpdateDevice": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDevice,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UpdateDeviceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.Device.SerializeToString,
+        ),
+        "DeleteDevice": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteDevice,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.DeleteDeviceRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListDevices": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDevices,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDevicesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDevicesResponse.SerializeToString,
+        ),
+        "ModifyCloudToDeviceConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.ModifyCloudToDeviceConfig,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ModifyCloudToDeviceConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_resources__pb2.DeviceConfig.SerializeToString,
+        ),
+        "ListDeviceConfigVersions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDeviceConfigVersions,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceConfigVersionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceConfigVersionsResponse.SerializeToString,
+        ),
+        "ListDeviceStates": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDeviceStates,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceStatesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.ListDeviceStatesResponse.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "SendCommandToDevice": grpc.unary_unary_rpc_method_handler(
+            servicer.SendCommandToDevice,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.SendCommandToDeviceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.SendCommandToDeviceResponse.SerializeToString,
+        ),
+        "BindDeviceToGateway": grpc.unary_unary_rpc_method_handler(
+            servicer.BindDeviceToGateway,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.BindDeviceToGatewayRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.BindDeviceToGatewayResponse.SerializeToString,
+        ),
+        "UnbindDeviceFromGateway": grpc.unary_unary_rpc_method_handler(
+            servicer.UnbindDeviceFromGateway,
+            request_deserializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UnbindDeviceFromGatewayRequest.FromString,
+            response_serializer=google_dot_cloud_dot_iot__v1_dot_proto_dot_device__manager__pb2.UnbindDeviceFromGatewayResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.iot.v1.DeviceManager", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/iot/google/cloud/iot_v1/proto/resources.proto b/iot/google/cloud/iot_v1/proto/resources.proto
new file mode 100644
index 000000000000..2a91e989e984
--- /dev/null
+++ b/iot/google/cloud/iot_v1/proto/resources.proto
@@ -0,0 +1,474 @@
+// 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.cloud.iot.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/iot/v1;iot";
+option java_multiple_files = true;
+option java_outer_classname = "ResourcesProto";
+option java_package = "com.google.cloud.iot.v1";
+
+// The device resource.
+message Device {
+  // The user-defined device identifier. The device ID must be unique
+  // within a device registry.
+  string id = 1;
+
+  // The resource path name. For example,
+  // `projects/p1/locations/us-central1/registries/registry0/devices/dev0` or
+  // `projects/p1/locations/us-central1/registries/registry0/devices/{num_id}`.
+  // When `name` is populated as a response from the service, it always ends
+  // in the device numeric ID.
+  string name = 2;
+
+  // [Output only] A server-defined unique numeric ID for the device. This is a
+  // more compact way to identify devices, and it is globally unique.
+  uint64 num_id = 3;
+
+  // The credentials used to authenticate this device. To allow credential
+  // rotation without interruption, multiple device credentials can be bound to
+  // this device. No more than 3 credentials can be bound to a single device at
+  // a time. When new credentials are added to a device, they are verified
+  // against the registry credentials. For details, see the description of the
+  // `DeviceRegistry.credentials` field.
+  repeated DeviceCredential credentials = 12;
+
+  // [Output only] The last time an MQTT `PINGREQ` was received. This field
+  // applies only to devices connecting through MQTT. MQTT clients usually only
+  // send `PINGREQ` messages if the connection is idle, and no other messages
+  // have been sent. Timestamps are periodically collected and written to
+  // storage; they may be stale by a few minutes.
+  google.protobuf.Timestamp last_heartbeat_time = 7;
+
+  // [Output only] The last time a telemetry event was received. Timestamps are
+  // periodically collected and written to storage; they may be stale by a few
+  // minutes.
+  google.protobuf.Timestamp last_event_time = 8;
+
+  // [Output only] The last time a state event was received. Timestamps are
+  // periodically collected and written to storage; they may be stale by a few
+  // minutes.
+  google.protobuf.Timestamp last_state_time = 20;
+
+  // [Output only] The last time a cloud-to-device config version acknowledgment
+  // was received from the device. This field is only for configurations
+  // sent through MQTT.
+  google.protobuf.Timestamp last_config_ack_time = 14;
+
+  // [Output only] The last time a cloud-to-device config version was sent to
+  // the device.
+  google.protobuf.Timestamp last_config_send_time = 18;
+
+  // If a device is blocked, connections or requests from this device will fail.
+  // Can be used to temporarily prevent the device from connecting if, for
+  // example, the sensor is generating bad data and needs maintenance.
+  bool blocked = 19;
+
+  // [Output only] The time the most recent error occurred, such as a failure to
+  // publish to Cloud Pub/Sub. This field is the timestamp of
+  // 'last_error_status'.
+  google.protobuf.Timestamp last_error_time = 10;
+
+  // [Output only] The error message of the most recent error, such as a failure
+  // to publish to Cloud Pub/Sub. 'last_error_time' is the timestamp of this
+  // field. If no errors have occurred, this field has an empty message
+  // and the status code 0 == OK. Otherwise, this field is expected to have a
+  // status code other than OK.
+  google.rpc.Status last_error_status = 11;
+
+  // The most recent device configuration, which is eventually sent from
+  // Cloud IoT Core to the device. If not present on creation, the
+  // configuration will be initialized with an empty payload and version value
+  // of `1`. To update this field after creation, use the
+  // `DeviceManager.ModifyCloudToDeviceConfig` method.
+  DeviceConfig config = 13;
+
+  // [Output only] The state most recently received from the device. If no state
+  // has been reported, this field is not present.
+  DeviceState state = 16;
+
+  // **Beta Feature**
+  //
+  // The logging verbosity for device activity. If unspecified,
+  // DeviceRegistry.log_level will be used.
+  LogLevel log_level = 21;
+
+  // The metadata key-value pairs assigned to the device. This metadata is not
+  // interpreted or indexed by Cloud IoT Core. It can be used to add contextual
+  // information for the device.
+  //
+  // Keys must conform to the regular expression [a-zA-Z][a-zA-Z0-9-_.+~%]+ and
+  // be less than 128 bytes in length.
+  //
+  // Values are free-form strings. Each value must be less than or equal to 32
+  // KB in size.
+  //
+  // The total size of all keys and values must be less than 256 KB, and the
+  // maximum number of key-value pairs is 500.
+  map<string, string> metadata = 17;
+
+  // Gateway-related configuration and state.
+  GatewayConfig gateway_config = 24;
+}
+
+// Gateway-related configuration and state.
+message GatewayConfig {
+  // Indicates whether the device is a gateway.
+  GatewayType gateway_type = 1;
+
+  // Indicates how to authorize and/or authenticate devices to access the
+  // gateway.
+  GatewayAuthMethod gateway_auth_method = 2;
+
+  // [Output only] The ID of the gateway the device accessed most recently.
+  string last_accessed_gateway_id = 3;
+
+  // [Output only] The most recent time at which the device accessed the gateway
+  // specified in `last_accessed_gateway`.
+  google.protobuf.Timestamp last_accessed_gateway_time = 4;
+}
+
+// A container for a group of devices.
+message DeviceRegistry {
+  // The identifier of this device registry. For example, `myRegistry`.
+  string id = 1;
+
+  // The resource path name. For example,
+  // `projects/example-project/locations/us-central1/registries/my-registry`.
+  string name = 2;
+
+  // The configuration for notification of telemetry events received from the
+  // device. All telemetry events that were successfully published by the
+  // device and acknowledged by Cloud IoT Core are guaranteed to be
+  // delivered to Cloud Pub/Sub. If multiple configurations match a message,
+  // only the first matching configuration is used. If you try to publish a
+  // device telemetry event using MQTT without specifying a Cloud Pub/Sub topic
+  // for the device's registry, the connection closes automatically. If you try
+  // to do so using an HTTP connection, an error is returned. Up to 10
+  // configurations may be provided.
+  repeated EventNotificationConfig event_notification_configs = 10;
+
+  // The configuration for notification of new states received from the device.
+  // State updates are guaranteed to be stored in the state history, but
+  // notifications to Cloud Pub/Sub are not guaranteed. For example, if
+  // permissions are misconfigured or the specified topic doesn't exist, no
+  // notification will be published but the state will still be stored in Cloud
+  // IoT Core.
+  StateNotificationConfig state_notification_config = 7;
+
+  // The MQTT configuration for this device registry.
+  MqttConfig mqtt_config = 4;
+
+  // The DeviceService (HTTP) configuration for this device registry.
+  HttpConfig http_config = 9;
+
+  // **Beta Feature**
+  //
+  // The default logging verbosity for activity from devices in this registry.
+  // The verbosity level can be overridden by Device.log_level.
+  LogLevel log_level = 11;
+
+  // The credentials used to verify the device credentials. No more than 10
+  // credentials can be bound to a single registry at a time. The verification
+  // process occurs at the time of device creation or update. If this field is
+  // empty, no verification is performed. Otherwise, the credentials of a newly
+  // created device or added credentials of an updated device should be signed
+  // with one of these registry credentials.
+  //
+  // Note, however, that existing devices will never be affected by
+  // modifications to this list of credentials: after a device has been
+  // successfully created in a registry, it should be able to connect even if
+  // its registry credentials are revoked, deleted, or modified.
+  repeated RegistryCredential credentials = 8;
+}
+
+// The configuration of MQTT for a device registry.
+message MqttConfig {
+  // If enabled, allows connections using the MQTT protocol. Otherwise, MQTT
+  // connections to this registry will fail.
+  MqttState mqtt_enabled_state = 1;
+}
+
+// The configuration of the HTTP bridge for a device registry.
+message HttpConfig {
+  // If enabled, allows devices to use DeviceService via the HTTP protocol.
+  // Otherwise, any requests to DeviceService will fail for this registry.
+  HttpState http_enabled_state = 1;
+}
+
+// The configuration for forwarding telemetry events.
+message EventNotificationConfig {
+  // If the subfolder name matches this string exactly, this configuration will
+  // be used. The string must not include the leading '/' character. If empty,
+  // all strings are matched. This field is used only for telemetry events;
+  // subfolders are not supported for state changes.
+  string subfolder_matches = 2;
+
+  // A Cloud Pub/Sub topic name. For example,
+  // `projects/myProject/topics/deviceEvents`.
+  string pubsub_topic_name = 1;
+}
+
+// The configuration for notification of new states received from the device.
+message StateNotificationConfig {
+  // A Cloud Pub/Sub topic name. For example,
+  // `projects/myProject/topics/deviceEvents`.
+  string pubsub_topic_name = 1;
+}
+
+// A server-stored registry credential used to validate device credentials.
+message RegistryCredential {
+  // The credential data. Reserved for expansion in the future.
+  oneof credential {
+    // A public key certificate used to verify the device credentials.
+    PublicKeyCertificate public_key_certificate = 1;
+  }
+}
+
+// Details of an X.509 certificate. For informational purposes only.
+message X509CertificateDetails {
+  // The entity that signed the certificate.
+  string issuer = 1;
+
+  // The entity the certificate and public key belong to.
+  string subject = 2;
+
+  // The time the certificate becomes valid.
+  google.protobuf.Timestamp start_time = 3;
+
+  // The time the certificate becomes invalid.
+  google.protobuf.Timestamp expiry_time = 4;
+
+  // The algorithm used to sign the certificate.
+  string signature_algorithm = 5;
+
+  // The type of public key in the certificate.
+  string public_key_type = 6;
+}
+
+// A public key certificate format and data.
+message PublicKeyCertificate {
+  // The certificate format.
+  PublicKeyCertificateFormat format = 1;
+
+  // The certificate data.
+  string certificate = 2;
+
+  // [Output only] The certificate details. Used only for X.509 certificates.
+  X509CertificateDetails x509_details = 3;
+}
+
+// A server-stored device credential used for authentication.
+message DeviceCredential {
+  // The credential data. Reserved for expansion in the future.
+  oneof credential {
+    // A public key used to verify the signature of JSON Web Tokens (JWTs).
+    // When adding a new device credential, either via device creation or via
+    // modifications, this public key credential may be required to be signed by
+    // one of the registry level certificates. More specifically, if the
+    // registry contains at least one certificate, any new device credential
+    // must be signed by one of the registry certificates. As a result,
+    // when the registry contains certificates, only X.509 certificates are
+    // accepted as device credentials. However, if the registry does
+    // not contain a certificate, self-signed certificates and public keys will
+    // be accepted. New device credentials must be different from every
+    // registry-level certificate.
+    PublicKeyCredential public_key = 2;
+  }
+
+  // [Optional] The time at which this credential becomes invalid. This
+  // credential will be ignored for new client authentication requests after
+  // this timestamp; however, it will not be automatically deleted.
+  google.protobuf.Timestamp expiration_time = 6;
+}
+
+// A public key format and data.
+message PublicKeyCredential {
+  // The format of the key.
+  PublicKeyFormat format = 1;
+
+  // The key data.
+  string key = 2;
+}
+
+// The device configuration. Eventually delivered to devices.
+message DeviceConfig {
+  // [Output only] The version of this update. The version number is assigned by
+  // the server, and is always greater than 0 after device creation. The
+  // version must be 0 on the `CreateDevice` request if a `config` is
+  // specified; the response of `CreateDevice` will always have a value of 1.
+  int64 version = 1;
+
+  // [Output only] The time at which this configuration version was updated in
+  // Cloud IoT Core. This timestamp is set by the server.
+  google.protobuf.Timestamp cloud_update_time = 2;
+
+  // [Output only] The time at which Cloud IoT Core received the
+  // acknowledgment from the device, indicating that the device has received
+  // this configuration version. If this field is not present, the device has
+  // not yet acknowledged that it received this version. Note that when
+  // the config was sent to the device, many config versions may have been
+  // available in Cloud IoT Core while the device was disconnected, and on
+  // connection, only the latest version is sent to the device. Some
+  // versions may never be sent to the device, and therefore are never
+  // acknowledged. This timestamp is set by Cloud IoT Core.
+  google.protobuf.Timestamp device_ack_time = 3;
+
+  // The device configuration data.
+  bytes binary_data = 4;
+}
+
+// The device state, as reported by the device.
+message DeviceState {
+  // [Output only] The time at which this state version was updated in Cloud
+  // IoT Core.
+  google.protobuf.Timestamp update_time = 1;
+
+  // 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/iot/google/cloud/iot_v1/proto/resources_pb2.py b/iot/google/cloud/iot_v1/proto/resources_pb2.py
new file mode 100644
index 000000000000..86af058d4b59
--- /dev/null
+++ b/iot/google/cloud/iot_v1/proto/resources_pb2.py
@@ -0,0 +1,2218 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/iot_v1/proto/resources.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/iot_v1/proto/resources.proto",
+    package="google.cloud.iot.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.cloud.iot.v1B\016ResourcesProtoP\001Z6google.golang.org/genproto/googleapis/cloud/iot/v1;iot\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n)google/cloud/iot_v1/proto/resources.proto\x12\x13google.cloud.iot.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xbb\x06\n\x06\x44\x65vice\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x0e\n\x06num_id\x18\x03 \x01(\x04\x12:\n\x0b\x63redentials\x18\x0c \x03(\x0b\x32%.google.cloud.iot.v1.DeviceCredential\x12\x37\n\x13last_heartbeat_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x0flast_event_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x0flast_state_time\x18\x14 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x38\n\x14last_config_ack_time\x18\x0e \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x39\n\x15last_config_send_time\x18\x12 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07\x62locked\x18\x13 \x01(\x08\x12\x33\n\x0flast_error_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12-\n\x11last_error_status\x18\x0b \x01(\x0b\x32\x12.google.rpc.Status\x12\x31\n\x06\x63onfig\x18\r \x01(\x0b\x32!.google.cloud.iot.v1.DeviceConfig\x12/\n\x05state\x18\x10 \x01(\x0b\x32 .google.cloud.iot.v1.DeviceState\x12\x30\n\tlog_level\x18\x15 \x01(\x0e\x32\x1d.google.cloud.iot.v1.LogLevel\x12;\n\x08metadata\x18\x11 \x03(\x0b\x32).google.cloud.iot.v1.Device.MetadataEntry\x12:\n\x0egateway_config\x18\x18 \x01(\x0b\x32".google.cloud.iot.v1.GatewayConfig\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xee\x01\n\rGatewayConfig\x12\x36\n\x0cgateway_type\x18\x01 \x01(\x0e\x32 .google.cloud.iot.v1.GatewayType\x12\x43\n\x13gateway_auth_method\x18\x02 \x01(\x0e\x32&.google.cloud.iot.v1.GatewayAuthMethod\x12 \n\x18last_accessed_gateway_id\x18\x03 \x01(\t\x12>\n\x1alast_accessed_gateway_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xa9\x03\n\x0e\x44\x65viceRegistry\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12P\n\x1a\x65vent_notification_configs\x18\n \x03(\x0b\x32,.google.cloud.iot.v1.EventNotificationConfig\x12O\n\x19state_notification_config\x18\x07 \x01(\x0b\x32,.google.cloud.iot.v1.StateNotificationConfig\x12\x34\n\x0bmqtt_config\x18\x04 \x01(\x0b\x32\x1f.google.cloud.iot.v1.MqttConfig\x12\x34\n\x0bhttp_config\x18\t \x01(\x0b\x32\x1f.google.cloud.iot.v1.HttpConfig\x12\x30\n\tlog_level\x18\x0b \x01(\x0e\x32\x1d.google.cloud.iot.v1.LogLevel\x12<\n\x0b\x63redentials\x18\x08 \x03(\x0b\x32\'.google.cloud.iot.v1.RegistryCredential"H\n\nMqttConfig\x12:\n\x12mqtt_enabled_state\x18\x01 \x01(\x0e\x32\x1e.google.cloud.iot.v1.MqttState"H\n\nHttpConfig\x12:\n\x12http_enabled_state\x18\x01 \x01(\x0e\x32\x1e.google.cloud.iot.v1.HttpState"O\n\x17\x45ventNotificationConfig\x12\x19\n\x11subfolder_matches\x18\x02 \x01(\t\x12\x19\n\x11pubsub_topic_name\x18\x01 \x01(\t"4\n\x17StateNotificationConfig\x12\x19\n\x11pubsub_topic_name\x18\x01 \x01(\t"o\n\x12RegistryCredential\x12K\n\x16public_key_certificate\x18\x01 \x01(\x0b\x32).google.cloud.iot.v1.PublicKeyCertificateH\x00\x42\x0c\n\ncredential"\xd0\x01\n\x16X509CertificateDetails\x12\x0e\n\x06issuer\x18\x01 \x01(\t\x12\x0f\n\x07subject\x18\x02 \x01(\t\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpiry_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1b\n\x13signature_algorithm\x18\x05 \x01(\t\x12\x17\n\x0fpublic_key_type\x18\x06 \x01(\t"\xaf\x01\n\x14PublicKeyCertificate\x12?\n\x06\x66ormat\x18\x01 \x01(\x0e\x32/.google.cloud.iot.v1.PublicKeyCertificateFormat\x12\x13\n\x0b\x63\x65rtificate\x18\x02 \x01(\t\x12\x41\n\x0cx509_details\x18\x03 \x01(\x0b\x32+.google.cloud.iot.v1.X509CertificateDetails"\x95\x01\n\x10\x44\x65viceCredential\x12>\n\npublic_key\x18\x02 \x01(\x0b\x32(.google.cloud.iot.v1.PublicKeyCredentialH\x00\x12\x33\n\x0f\x65xpiration_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x0c\n\ncredential"X\n\x13PublicKeyCredential\x12\x34\n\x06\x66ormat\x18\x01 \x01(\x0e\x32$.google.cloud.iot.v1.PublicKeyFormat\x12\x0b\n\x03key\x18\x02 \x01(\t"\xa0\x01\n\x0c\x44\x65viceConfig\x12\x0f\n\x07version\x18\x01 \x01(\x03\x12\x35\n\x11\x63loud_update_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x0f\x64\x65vice_ack_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0b\x62inary_data\x18\x04 \x01(\x0c"S\n\x0b\x44\x65viceState\x12/\n\x0bupdate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x13\n\x0b\x62inary_data\x18\x02 \x01(\x0c*L\n\tMqttState\x12\x1a\n\x16MQTT_STATE_UNSPECIFIED\x10\x00\x12\x10\n\x0cMQTT_ENABLED\x10\x01\x12\x11\n\rMQTT_DISABLED\x10\x02*L\n\tHttpState\x12\x1a\n\x16HTTP_STATE_UNSPECIFIED\x10\x00\x12\x10\n\x0cHTTP_ENABLED\x10\x01\x12\x11\n\rHTTP_DISABLED\x10\x02*O\n\x08LogLevel\x12\x19\n\x15LOG_LEVEL_UNSPECIFIED\x10\x00\x12\x08\n\x04NONE\x10\n\x12\t\n\x05\x45RROR\x10\x14\x12\x08\n\x04INFO\x10\x1e\x12\t\n\x05\x44\x45\x42UG\x10(*I\n\x0bGatewayType\x12\x1c\n\x18GATEWAY_TYPE_UNSPECIFIED\x10\x00\x12\x0b\n\x07GATEWAY\x10\x01\x12\x0f\n\x0bNON_GATEWAY\x10\x02*\x91\x01\n\x11GatewayAuthMethod\x12#\n\x1fGATEWAY_AUTH_METHOD_UNSPECIFIED\x10\x00\x12\x14\n\x10\x41SSOCIATION_ONLY\x10\x01\x12\x1a\n\x16\x44\x45VICE_AUTH_TOKEN_ONLY\x10\x02\x12%\n!ASSOCIATION_AND_DEVICE_AUTH_TOKEN\x10\x03*e\n\x1aPublicKeyCertificateFormat\x12-\n)UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT\x10\x00\x12\x18\n\x14X509_CERTIFICATE_PEM\x10\x01*v\n\x0fPublicKeyFormat\x12!\n\x1dUNSPECIFIED_PUBLIC_KEY_FORMAT\x10\x00\x12\x0b\n\x07RSA_PEM\x10\x03\x12\x10\n\x0cRSA_X509_PEM\x10\x01\x12\r\n\tES256_PEM\x10\x02\x12\x12\n\x0e\x45S256_X509_PEM\x10\x04\x42\x66\n\x17\x63om.google.cloud.iot.v1B\x0eResourcesProtoP\x01Z6google.golang.org/genproto/googleapis/cloud/iot/v1;iot\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_MQTTSTATE = _descriptor.EnumDescriptor(
+    name="MqttState",
+    full_name="google.cloud.iot.v1.MqttState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MQTT_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MQTT_ENABLED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MQTT_DISABLED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2928,
+    serialized_end=3004,
+)
+_sym_db.RegisterEnumDescriptor(_MQTTSTATE)
+
+MqttState = enum_type_wrapper.EnumTypeWrapper(_MQTTSTATE)
+_HTTPSTATE = _descriptor.EnumDescriptor(
+    name="HttpState",
+    full_name="google.cloud.iot.v1.HttpState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_ENABLED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_DISABLED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3006,
+    serialized_end=3082,
+)
+_sym_db.RegisterEnumDescriptor(_HTTPSTATE)
+
+HttpState = enum_type_wrapper.EnumTypeWrapper(_HTTPSTATE)
+_LOGLEVEL = _descriptor.EnumDescriptor(
+    name="LogLevel",
+    full_name="google.cloud.iot.v1.LogLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LOG_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NONE", index=1, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=2, number=20, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INFO", index=3, number=30, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEBUG", index=4, number=40, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3084,
+    serialized_end=3163,
+)
+_sym_db.RegisterEnumDescriptor(_LOGLEVEL)
+
+LogLevel = enum_type_wrapper.EnumTypeWrapper(_LOGLEVEL)
+_GATEWAYTYPE = _descriptor.EnumDescriptor(
+    name="GatewayType",
+    full_name="google.cloud.iot.v1.GatewayType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="GATEWAY_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GATEWAY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NON_GATEWAY", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3165,
+    serialized_end=3238,
+)
+_sym_db.RegisterEnumDescriptor(_GATEWAYTYPE)
+
+GatewayType = enum_type_wrapper.EnumTypeWrapper(_GATEWAYTYPE)
+_GATEWAYAUTHMETHOD = _descriptor.EnumDescriptor(
+    name="GatewayAuthMethod",
+    full_name="google.cloud.iot.v1.GatewayAuthMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="GATEWAY_AUTH_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASSOCIATION_ONLY",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEVICE_AUTH_TOKEN_ONLY",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASSOCIATION_AND_DEVICE_AUTH_TOKEN",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3241,
+    serialized_end=3386,
+)
+_sym_db.RegisterEnumDescriptor(_GATEWAYAUTHMETHOD)
+
+GatewayAuthMethod = enum_type_wrapper.EnumTypeWrapper(_GATEWAYAUTHMETHOD)
+_PUBLICKEYCERTIFICATEFORMAT = _descriptor.EnumDescriptor(
+    name="PublicKeyCertificateFormat",
+    full_name="google.cloud.iot.v1.PublicKeyCertificateFormat",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="X509_CERTIFICATE_PEM",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3388,
+    serialized_end=3489,
+)
+_sym_db.RegisterEnumDescriptor(_PUBLICKEYCERTIFICATEFORMAT)
+
+PublicKeyCertificateFormat = enum_type_wrapper.EnumTypeWrapper(
+    _PUBLICKEYCERTIFICATEFORMAT
+)
+_PUBLICKEYFORMAT = _descriptor.EnumDescriptor(
+    name="PublicKeyFormat",
+    full_name="google.cloud.iot.v1.PublicKeyFormat",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNSPECIFIED_PUBLIC_KEY_FORMAT",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_PEM", index=1, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_X509_PEM", index=2, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ES256_PEM", index=3, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ES256_X509_PEM", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3491,
+    serialized_end=3609,
+)
+_sym_db.RegisterEnumDescriptor(_PUBLICKEYFORMAT)
+
+PublicKeyFormat = enum_type_wrapper.EnumTypeWrapper(_PUBLICKEYFORMAT)
+MQTT_STATE_UNSPECIFIED = 0
+MQTT_ENABLED = 1
+MQTT_DISABLED = 2
+HTTP_STATE_UNSPECIFIED = 0
+HTTP_ENABLED = 1
+HTTP_DISABLED = 2
+LOG_LEVEL_UNSPECIFIED = 0
+NONE = 10
+ERROR = 20
+INFO = 30
+DEBUG = 40
+GATEWAY_TYPE_UNSPECIFIED = 0
+GATEWAY = 1
+NON_GATEWAY = 2
+GATEWAY_AUTH_METHOD_UNSPECIFIED = 0
+ASSOCIATION_ONLY = 1
+DEVICE_AUTH_TOKEN_ONLY = 2
+ASSOCIATION_AND_DEVICE_AUTH_TOKEN = 3
+UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT = 0
+X509_CERTIFICATE_PEM = 1
+UNSPECIFIED_PUBLIC_KEY_FORMAT = 0
+RSA_PEM = 3
+RSA_X509_PEM = 1
+ES256_PEM = 2
+ES256_X509_PEM = 4
+
+
+_DEVICE_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.iot.v1.Device.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.iot.v1.Device.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.iot.v1.Device.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=935,
+    serialized_end=982,
+)
+
+_DEVICE = _descriptor.Descriptor(
+    name="Device",
+    full_name="google.cloud.iot.v1.Device",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.cloud.iot.v1.Device.id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.Device.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="num_id",
+            full_name="google.cloud.iot.v1.Device.num_id",
+            index=2,
+            number=3,
+            type=4,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="credentials",
+            full_name="google.cloud.iot.v1.Device.credentials",
+            index=3,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_heartbeat_time",
+            full_name="google.cloud.iot.v1.Device.last_heartbeat_time",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_event_time",
+            full_name="google.cloud.iot.v1.Device.last_event_time",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_state_time",
+            full_name="google.cloud.iot.v1.Device.last_state_time",
+            index=6,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_config_ack_time",
+            full_name="google.cloud.iot.v1.Device.last_config_ack_time",
+            index=7,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_config_send_time",
+            full_name="google.cloud.iot.v1.Device.last_config_send_time",
+            index=8,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocked",
+            full_name="google.cloud.iot.v1.Device.blocked",
+            index=9,
+            number=19,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_error_time",
+            full_name="google.cloud.iot.v1.Device.last_error_time",
+            index=10,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_error_status",
+            full_name="google.cloud.iot.v1.Device.last_error_status",
+            index=11,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.iot.v1.Device.config",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.iot.v1.Device.state",
+            index=13,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="log_level",
+            full_name="google.cloud.iot.v1.Device.log_level",
+            index=14,
+            number=21,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.iot.v1.Device.metadata",
+            index=15,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gateway_config",
+            full_name="google.cloud.iot.v1.Device.gateway_config",
+            index=16,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_DEVICE_METADATAENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=155,
+    serialized_end=982,
+)
+
+
+_GATEWAYCONFIG = _descriptor.Descriptor(
+    name="GatewayConfig",
+    full_name="google.cloud.iot.v1.GatewayConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gateway_type",
+            full_name="google.cloud.iot.v1.GatewayConfig.gateway_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gateway_auth_method",
+            full_name="google.cloud.iot.v1.GatewayConfig.gateway_auth_method",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_accessed_gateway_id",
+            full_name="google.cloud.iot.v1.GatewayConfig.last_accessed_gateway_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_accessed_gateway_time",
+            full_name="google.cloud.iot.v1.GatewayConfig.last_accessed_gateway_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=985,
+    serialized_end=1223,
+)
+
+
+_DEVICEREGISTRY = _descriptor.Descriptor(
+    name="DeviceRegistry",
+    full_name="google.cloud.iot.v1.DeviceRegistry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.cloud.iot.v1.DeviceRegistry.id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.iot.v1.DeviceRegistry.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_notification_configs",
+            full_name="google.cloud.iot.v1.DeviceRegistry.event_notification_configs",
+            index=2,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_notification_config",
+            full_name="google.cloud.iot.v1.DeviceRegistry.state_notification_config",
+            index=3,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mqtt_config",
+            full_name="google.cloud.iot.v1.DeviceRegistry.mqtt_config",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_config",
+            full_name="google.cloud.iot.v1.DeviceRegistry.http_config",
+            index=5,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="log_level",
+            full_name="google.cloud.iot.v1.DeviceRegistry.log_level",
+            index=6,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="credentials",
+            full_name="google.cloud.iot.v1.DeviceRegistry.credentials",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1226,
+    serialized_end=1651,
+)
+
+
+_MQTTCONFIG = _descriptor.Descriptor(
+    name="MqttConfig",
+    full_name="google.cloud.iot.v1.MqttConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mqtt_enabled_state",
+            full_name="google.cloud.iot.v1.MqttConfig.mqtt_enabled_state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1653,
+    serialized_end=1725,
+)
+
+
+_HTTPCONFIG = _descriptor.Descriptor(
+    name="HttpConfig",
+    full_name="google.cloud.iot.v1.HttpConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_enabled_state",
+            full_name="google.cloud.iot.v1.HttpConfig.http_enabled_state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1727,
+    serialized_end=1799,
+)
+
+
+_EVENTNOTIFICATIONCONFIG = _descriptor.Descriptor(
+    name="EventNotificationConfig",
+    full_name="google.cloud.iot.v1.EventNotificationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subfolder_matches",
+            full_name="google.cloud.iot.v1.EventNotificationConfig.subfolder_matches",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pubsub_topic_name",
+            full_name="google.cloud.iot.v1.EventNotificationConfig.pubsub_topic_name",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1801,
+    serialized_end=1880,
+)
+
+
+_STATENOTIFICATIONCONFIG = _descriptor.Descriptor(
+    name="StateNotificationConfig",
+    full_name="google.cloud.iot.v1.StateNotificationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pubsub_topic_name",
+            full_name="google.cloud.iot.v1.StateNotificationConfig.pubsub_topic_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1882,
+    serialized_end=1934,
+)
+
+
+_REGISTRYCREDENTIAL = _descriptor.Descriptor(
+    name="RegistryCredential",
+    full_name="google.cloud.iot.v1.RegistryCredential",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="public_key_certificate",
+            full_name="google.cloud.iot.v1.RegistryCredential.public_key_certificate",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="credential",
+            full_name="google.cloud.iot.v1.RegistryCredential.credential",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1936,
+    serialized_end=2047,
+)
+
+
+_X509CERTIFICATEDETAILS = _descriptor.Descriptor(
+    name="X509CertificateDetails",
+    full_name="google.cloud.iot.v1.X509CertificateDetails",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="issuer",
+            full_name="google.cloud.iot.v1.X509CertificateDetails.issuer",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subject",
+            full_name="google.cloud.iot.v1.X509CertificateDetails.subject",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.iot.v1.X509CertificateDetails.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiry_time",
+            full_name="google.cloud.iot.v1.X509CertificateDetails.expiry_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signature_algorithm",
+            full_name="google.cloud.iot.v1.X509CertificateDetails.signature_algorithm",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="public_key_type",
+            full_name="google.cloud.iot.v1.X509CertificateDetails.public_key_type",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2050,
+    serialized_end=2258,
+)
+
+
+_PUBLICKEYCERTIFICATE = _descriptor.Descriptor(
+    name="PublicKeyCertificate",
+    full_name="google.cloud.iot.v1.PublicKeyCertificate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="format",
+            full_name="google.cloud.iot.v1.PublicKeyCertificate.format",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="certificate",
+            full_name="google.cloud.iot.v1.PublicKeyCertificate.certificate",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="x509_details",
+            full_name="google.cloud.iot.v1.PublicKeyCertificate.x509_details",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2261,
+    serialized_end=2436,
+)
+
+
+_DEVICECREDENTIAL = _descriptor.Descriptor(
+    name="DeviceCredential",
+    full_name="google.cloud.iot.v1.DeviceCredential",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="public_key",
+            full_name="google.cloud.iot.v1.DeviceCredential.public_key",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiration_time",
+            full_name="google.cloud.iot.v1.DeviceCredential.expiration_time",
+            index=1,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="credential",
+            full_name="google.cloud.iot.v1.DeviceCredential.credential",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2439,
+    serialized_end=2588,
+)
+
+
+_PUBLICKEYCREDENTIAL = _descriptor.Descriptor(
+    name="PublicKeyCredential",
+    full_name="google.cloud.iot.v1.PublicKeyCredential",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="format",
+            full_name="google.cloud.iot.v1.PublicKeyCredential.format",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.iot.v1.PublicKeyCredential.key",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2590,
+    serialized_end=2678,
+)
+
+
+_DEVICECONFIG = _descriptor.Descriptor(
+    name="DeviceConfig",
+    full_name="google.cloud.iot.v1.DeviceConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.iot.v1.DeviceConfig.version",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cloud_update_time",
+            full_name="google.cloud.iot.v1.DeviceConfig.cloud_update_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_ack_time",
+            full_name="google.cloud.iot.v1.DeviceConfig.device_ack_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_data",
+            full_name="google.cloud.iot.v1.DeviceConfig.binary_data",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2681,
+    serialized_end=2841,
+)
+
+
+_DEVICESTATE = _descriptor.Descriptor(
+    name="DeviceState",
+    full_name="google.cloud.iot.v1.DeviceState",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.iot.v1.DeviceState.update_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="binary_data",
+            full_name="google.cloud.iot.v1.DeviceState.binary_data",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2843,
+    serialized_end=2926,
+)
+
+_DEVICE_METADATAENTRY.containing_type = _DEVICE
+_DEVICE.fields_by_name["credentials"].message_type = _DEVICECREDENTIAL
+_DEVICE.fields_by_name[
+    "last_heartbeat_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICE.fields_by_name[
+    "last_event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICE.fields_by_name[
+    "last_state_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICE.fields_by_name[
+    "last_config_ack_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICE.fields_by_name[
+    "last_config_send_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICE.fields_by_name[
+    "last_error_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICE.fields_by_name[
+    "last_error_status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_DEVICE.fields_by_name["config"].message_type = _DEVICECONFIG
+_DEVICE.fields_by_name["state"].message_type = _DEVICESTATE
+_DEVICE.fields_by_name["log_level"].enum_type = _LOGLEVEL
+_DEVICE.fields_by_name["metadata"].message_type = _DEVICE_METADATAENTRY
+_DEVICE.fields_by_name["gateway_config"].message_type = _GATEWAYCONFIG
+_GATEWAYCONFIG.fields_by_name["gateway_type"].enum_type = _GATEWAYTYPE
+_GATEWAYCONFIG.fields_by_name["gateway_auth_method"].enum_type = _GATEWAYAUTHMETHOD
+_GATEWAYCONFIG.fields_by_name[
+    "last_accessed_gateway_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICEREGISTRY.fields_by_name[
+    "event_notification_configs"
+].message_type = _EVENTNOTIFICATIONCONFIG
+_DEVICEREGISTRY.fields_by_name[
+    "state_notification_config"
+].message_type = _STATENOTIFICATIONCONFIG
+_DEVICEREGISTRY.fields_by_name["mqtt_config"].message_type = _MQTTCONFIG
+_DEVICEREGISTRY.fields_by_name["http_config"].message_type = _HTTPCONFIG
+_DEVICEREGISTRY.fields_by_name["log_level"].enum_type = _LOGLEVEL
+_DEVICEREGISTRY.fields_by_name["credentials"].message_type = _REGISTRYCREDENTIAL
+_MQTTCONFIG.fields_by_name["mqtt_enabled_state"].enum_type = _MQTTSTATE
+_HTTPCONFIG.fields_by_name["http_enabled_state"].enum_type = _HTTPSTATE
+_REGISTRYCREDENTIAL.fields_by_name[
+    "public_key_certificate"
+].message_type = _PUBLICKEYCERTIFICATE
+_REGISTRYCREDENTIAL.oneofs_by_name["credential"].fields.append(
+    _REGISTRYCREDENTIAL.fields_by_name["public_key_certificate"]
+)
+_REGISTRYCREDENTIAL.fields_by_name[
+    "public_key_certificate"
+].containing_oneof = _REGISTRYCREDENTIAL.oneofs_by_name["credential"]
+_X509CERTIFICATEDETAILS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_X509CERTIFICATEDETAILS.fields_by_name[
+    "expiry_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PUBLICKEYCERTIFICATE.fields_by_name["format"].enum_type = _PUBLICKEYCERTIFICATEFORMAT
+_PUBLICKEYCERTIFICATE.fields_by_name[
+    "x509_details"
+].message_type = _X509CERTIFICATEDETAILS
+_DEVICECREDENTIAL.fields_by_name["public_key"].message_type = _PUBLICKEYCREDENTIAL
+_DEVICECREDENTIAL.fields_by_name[
+    "expiration_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICECREDENTIAL.oneofs_by_name["credential"].fields.append(
+    _DEVICECREDENTIAL.fields_by_name["public_key"]
+)
+_DEVICECREDENTIAL.fields_by_name[
+    "public_key"
+].containing_oneof = _DEVICECREDENTIAL.oneofs_by_name["credential"]
+_PUBLICKEYCREDENTIAL.fields_by_name["format"].enum_type = _PUBLICKEYFORMAT
+_DEVICECONFIG.fields_by_name[
+    "cloud_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICECONFIG.fields_by_name[
+    "device_ack_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DEVICESTATE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["Device"] = _DEVICE
+DESCRIPTOR.message_types_by_name["GatewayConfig"] = _GATEWAYCONFIG
+DESCRIPTOR.message_types_by_name["DeviceRegistry"] = _DEVICEREGISTRY
+DESCRIPTOR.message_types_by_name["MqttConfig"] = _MQTTCONFIG
+DESCRIPTOR.message_types_by_name["HttpConfig"] = _HTTPCONFIG
+DESCRIPTOR.message_types_by_name["EventNotificationConfig"] = _EVENTNOTIFICATIONCONFIG
+DESCRIPTOR.message_types_by_name["StateNotificationConfig"] = _STATENOTIFICATIONCONFIG
+DESCRIPTOR.message_types_by_name["RegistryCredential"] = _REGISTRYCREDENTIAL
+DESCRIPTOR.message_types_by_name["X509CertificateDetails"] = _X509CERTIFICATEDETAILS
+DESCRIPTOR.message_types_by_name["PublicKeyCertificate"] = _PUBLICKEYCERTIFICATE
+DESCRIPTOR.message_types_by_name["DeviceCredential"] = _DEVICECREDENTIAL
+DESCRIPTOR.message_types_by_name["PublicKeyCredential"] = _PUBLICKEYCREDENTIAL
+DESCRIPTOR.message_types_by_name["DeviceConfig"] = _DEVICECONFIG
+DESCRIPTOR.message_types_by_name["DeviceState"] = _DEVICESTATE
+DESCRIPTOR.enum_types_by_name["MqttState"] = _MQTTSTATE
+DESCRIPTOR.enum_types_by_name["HttpState"] = _HTTPSTATE
+DESCRIPTOR.enum_types_by_name["LogLevel"] = _LOGLEVEL
+DESCRIPTOR.enum_types_by_name["GatewayType"] = _GATEWAYTYPE
+DESCRIPTOR.enum_types_by_name["GatewayAuthMethod"] = _GATEWAYAUTHMETHOD
+DESCRIPTOR.enum_types_by_name[
+    "PublicKeyCertificateFormat"
+] = _PUBLICKEYCERTIFICATEFORMAT
+DESCRIPTOR.enum_types_by_name["PublicKeyFormat"] = _PUBLICKEYFORMAT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Device = _reflection.GeneratedProtocolMessageType(
+    "Device",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DEVICE_METADATAENTRY,
+                __module__="google.cloud.iot_v1.proto.resources_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.Device.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_DEVICE,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The device resource.
+  
+  
+  Attributes:
+      id:
+          The user-defined device identifier. The device ID must be
+          unique within a device registry.
+      name:
+          The resource path name. For example,
+          ``projects/p1/locations/us-
+          central1/registries/registry0/devices/dev0`` or
+          ``projects/p1/locations/us-
+          central1/registries/registry0/devices/{num_id}``. When
+          ``name`` is populated as a response from the service, it
+          always ends in the device numeric ID.
+      num_id:
+          [Output only] A server-defined unique numeric ID for the
+          device. This is a more compact way to identify devices, and it
+          is globally unique.
+      credentials:
+          The credentials used to authenticate this device. To allow
+          credential rotation without interruption, multiple device
+          credentials can be bound to this device. No more than 3
+          credentials can be bound to a single device at a time. When
+          new credentials are added to a device, they are verified
+          against the registry credentials. For details, see the
+          description of the ``DeviceRegistry.credentials`` field.
+      last_heartbeat_time:
+          [Output only] The last time an MQTT ``PINGREQ`` was received.
+          This field applies only to devices connecting through MQTT.
+          MQTT clients usually only send ``PINGREQ`` messages if the
+          connection is idle, and no other messages have been sent.
+          Timestamps are periodically collected and written to storage;
+          they may be stale by a few minutes.
+      last_event_time:
+          [Output only] The last time a telemetry event was received.
+          Timestamps are periodically collected and written to storage;
+          they may be stale by a few minutes.
+      last_state_time:
+          [Output only] The last time a state event was received.
+          Timestamps are periodically collected and written to storage;
+          they may be stale by a few minutes.
+      last_config_ack_time:
+          [Output only] The last time a cloud-to-device config version
+          acknowledgment was received from the device. This field is
+          only for configurations sent through MQTT.
+      last_config_send_time:
+          [Output only] The last time a cloud-to-device config version
+          was sent to the device.
+      blocked:
+          If a device is blocked, connections or requests from this
+          device will fail. Can be used to temporarily prevent the
+          device from connecting if, for example, the sensor is
+          generating bad data and needs maintenance.
+      last_error_time:
+          [Output only] The time the most recent error occurred, such as
+          a failure to publish to Cloud Pub/Sub. This field is the
+          timestamp of 'last\_error\_status'.
+      last_error_status:
+          [Output only] The error message of the most recent error, such
+          as a failure to publish to Cloud Pub/Sub. 'last\_error\_time'
+          is the timestamp of this field. If no errors have occurred,
+          this field has an empty message and the status code 0 == OK.
+          Otherwise, this field is expected to have a status code other
+          than OK.
+      config:
+          The most recent device configuration, which is eventually sent
+          from Cloud IoT Core to the device. If not present on creation,
+          the configuration will be initialized with an empty payload
+          and version value of ``1``. To update this field after
+          creation, use the ``DeviceManager.ModifyCloudToDeviceConfig``
+          method.
+      state:
+          [Output only] The state most recently received from the
+          device. If no state has been reported, this field is not
+          present.
+      log_level:
+          **Beta Feature**  The logging verbosity for device activity.
+          If unspecified, DeviceRegistry.log\_level will be used.
+      metadata:
+          The metadata key-value pairs assigned to the device. This
+          metadata is not interpreted or indexed by Cloud IoT Core. It
+          can be used to add contextual information for the device.
+          Keys must conform to the regular expression
+          [a-zA-Z][a-zA-Z0-9-\_.+~%]+ and be less than 128 bytes in
+          length.  Values are free-form strings. Each value must be less
+          than or equal to 32 KB in size.  The total size of all keys
+          and values must be less than 256 KB, and the maximum number of
+          key-value pairs is 500.
+      gateway_config:
+          Gateway-related configuration and state.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.Device)
+    ),
+)
+_sym_db.RegisterMessage(Device)
+_sym_db.RegisterMessage(Device.MetadataEntry)
+
+GatewayConfig = _reflection.GeneratedProtocolMessageType(
+    "GatewayConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GATEWAYCONFIG,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""Gateway-related configuration and state.
+  
+  
+  Attributes:
+      gateway_type:
+          Indicates whether the device is a gateway.
+      gateway_auth_method:
+          Indicates how to authorize and/or authenticate devices to
+          access the gateway.
+      last_accessed_gateway_id:
+          [Output only] The ID of the gateway the device accessed most
+          recently.
+      last_accessed_gateway_time:
+          [Output only] The most recent time at which the device
+          accessed the gateway specified in ``last_accessed_gateway``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.GatewayConfig)
+    ),
+)
+_sym_db.RegisterMessage(GatewayConfig)
+
+DeviceRegistry = _reflection.GeneratedProtocolMessageType(
+    "DeviceRegistry",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEVICEREGISTRY,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""A container for a group of devices.
+  
+  
+  Attributes:
+      id:
+          The identifier of this device registry. For example,
+          ``myRegistry``.
+      name:
+          The resource path name. For example, ``projects/example-
+          project/locations/us-central1/registries/my-registry``.
+      event_notification_configs:
+          The configuration for notification of telemetry events
+          received from the device. All telemetry events that were
+          successfully published by the device and acknowledged by Cloud
+          IoT Core are guaranteed to be delivered to Cloud Pub/Sub. If
+          multiple configurations match a message, only the first
+          matching configuration is used. If you try to publish a device
+          telemetry event using MQTT without specifying a Cloud Pub/Sub
+          topic for the device's registry, the connection closes
+          automatically. If you try to do so using an HTTP connection,
+          an error is returned. Up to 10 configurations may be provided.
+      state_notification_config:
+          The configuration for notification of new states received from
+          the device. State updates are guaranteed to be stored in the
+          state history, but notifications to Cloud Pub/Sub are not
+          guaranteed. For example, if permissions are misconfigured or
+          the specified topic doesn't exist, no notification will be
+          published but the state will still be stored in Cloud IoT
+          Core.
+      mqtt_config:
+          The MQTT configuration for this device registry.
+      http_config:
+          The DeviceService (HTTP) configuration for this device
+          registry.
+      log_level:
+          **Beta Feature**  The default logging verbosity for activity
+          from devices in this registry. The verbosity level can be
+          overridden by Device.log\_level.
+      credentials:
+          The credentials used to verify the device credentials. No more
+          than 10 credentials can be bound to a single registry at a
+          time. The verification process occurs at the time of device
+          creation or update. If this field is empty, no verification is
+          performed. Otherwise, the credentials of a newly created
+          device or added credentials of an updated device should be
+          signed with one of these registry credentials.  Note, however,
+          that existing devices will never be affected by modifications
+          to this list of credentials: after a device has been
+          successfully created in a registry, it should be able to
+          connect even if its registry credentials are revoked, deleted,
+          or modified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.DeviceRegistry)
+    ),
+)
+_sym_db.RegisterMessage(DeviceRegistry)
+
+MqttConfig = _reflection.GeneratedProtocolMessageType(
+    "MqttConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MQTTCONFIG,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The configuration of MQTT for a device registry.
+  
+  
+  Attributes:
+      mqtt_enabled_state:
+          If enabled, allows connections using the MQTT protocol.
+          Otherwise, MQTT connections to this registry will fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.MqttConfig)
+    ),
+)
+_sym_db.RegisterMessage(MqttConfig)
+
+HttpConfig = _reflection.GeneratedProtocolMessageType(
+    "HttpConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HTTPCONFIG,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The configuration of the HTTP bridge for a device registry.
+  
+  
+  Attributes:
+      http_enabled_state:
+          If enabled, allows devices to use DeviceService via the HTTP
+          protocol. Otherwise, any requests to DeviceService will fail
+          for this registry.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.HttpConfig)
+    ),
+)
+_sym_db.RegisterMessage(HttpConfig)
+
+EventNotificationConfig = _reflection.GeneratedProtocolMessageType(
+    "EventNotificationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EVENTNOTIFICATIONCONFIG,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The configuration for forwarding telemetry events.
+  
+  
+  Attributes:
+      subfolder_matches:
+          If the subfolder name matches this string exactly, this
+          configuration will be used. The string must not include the
+          leading '/' character. If empty, all strings are matched. This
+          field is used only for telemetry events; subfolders are not
+          supported for state changes.
+      pubsub_topic_name:
+          A Cloud Pub/Sub topic name. For example,
+          ``projects/myProject/topics/deviceEvents``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.EventNotificationConfig)
+    ),
+)
+_sym_db.RegisterMessage(EventNotificationConfig)
+
+StateNotificationConfig = _reflection.GeneratedProtocolMessageType(
+    "StateNotificationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STATENOTIFICATIONCONFIG,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The configuration for notification of new states received from the
+  device.
+  
+  
+  Attributes:
+      pubsub_topic_name:
+          A Cloud Pub/Sub topic name. For example,
+          ``projects/myProject/topics/deviceEvents``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.StateNotificationConfig)
+    ),
+)
+_sym_db.RegisterMessage(StateNotificationConfig)
+
+RegistryCredential = _reflection.GeneratedProtocolMessageType(
+    "RegistryCredential",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REGISTRYCREDENTIAL,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""A server-stored registry credential used to validate device credentials.
+  
+  
+  Attributes:
+      credential:
+          The credential data. Reserved for expansion in the future.
+      public_key_certificate:
+          A public key certificate used to verify the device
+          credentials.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.RegistryCredential)
+    ),
+)
+_sym_db.RegisterMessage(RegistryCredential)
+
+X509CertificateDetails = _reflection.GeneratedProtocolMessageType(
+    "X509CertificateDetails",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_X509CERTIFICATEDETAILS,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""Details of an X.509 certificate. For informational purposes only.
+  
+  
+  Attributes:
+      issuer:
+          The entity that signed the certificate.
+      subject:
+          The entity the certificate and public key belong to.
+      start_time:
+          The time the certificate becomes valid.
+      expiry_time:
+          The time the certificate becomes invalid.
+      signature_algorithm:
+          The algorithm used to sign the certificate.
+      public_key_type:
+          The type of public key in the certificate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.X509CertificateDetails)
+    ),
+)
+_sym_db.RegisterMessage(X509CertificateDetails)
+
+PublicKeyCertificate = _reflection.GeneratedProtocolMessageType(
+    "PublicKeyCertificate",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBLICKEYCERTIFICATE,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""A public key certificate format and data.
+  
+  
+  Attributes:
+      format:
+          The certificate format.
+      certificate:
+          The certificate data.
+      x509_details:
+          [Output only] The certificate details. Used only for X.509
+          certificates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.PublicKeyCertificate)
+    ),
+)
+_sym_db.RegisterMessage(PublicKeyCertificate)
+
+DeviceCredential = _reflection.GeneratedProtocolMessageType(
+    "DeviceCredential",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEVICECREDENTIAL,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""A server-stored device credential used for authentication.
+  
+  
+  Attributes:
+      credential:
+          The credential data. Reserved for expansion in the future.
+      public_key:
+          A public key used to verify the signature of JSON Web Tokens
+          (JWTs). When adding a new device credential, either via device
+          creation or via modifications, this public key credential may
+          be required to be signed by one of the registry level
+          certificates. More specifically, if the registry contains at
+          least one certificate, any new device credential must be
+          signed by one of the registry certificates. As a result, when
+          the registry contains certificates, only X.509 certificates
+          are accepted as device credentials. However, if the registry
+          does not contain a certificate, self-signed certificates and
+          public keys will be accepted. New device credentials must be
+          different from every registry-level certificate.
+      expiration_time:
+          [Optional] The time at which this credential becomes invalid.
+          This credential will be ignored for new client authentication
+          requests after this timestamp; however, it will not be
+          automatically deleted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.DeviceCredential)
+    ),
+)
+_sym_db.RegisterMessage(DeviceCredential)
+
+PublicKeyCredential = _reflection.GeneratedProtocolMessageType(
+    "PublicKeyCredential",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBLICKEYCREDENTIAL,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""A public key format and data.
+  
+  
+  Attributes:
+      format:
+          The format of the key.
+      key:
+          The key data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.PublicKeyCredential)
+    ),
+)
+_sym_db.RegisterMessage(PublicKeyCredential)
+
+DeviceConfig = _reflection.GeneratedProtocolMessageType(
+    "DeviceConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEVICECONFIG,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The device configuration. Eventually delivered to devices.
+  
+  
+  Attributes:
+      version:
+          [Output only] The version of this update. The version number
+          is assigned by the server, and is always greater than 0 after
+          device creation. The version must be 0 on the ``CreateDevice``
+          request if a ``config`` is specified; the response of
+          ``CreateDevice`` will always have a value of 1.
+      cloud_update_time:
+          [Output only] The time at which this configuration version was
+          updated in Cloud IoT Core. This timestamp is set by the
+          server.
+      device_ack_time:
+          [Output only] The time at which Cloud IoT Core received the
+          acknowledgment from the device, indicating that the device has
+          received this configuration version. If this field is not
+          present, the device has not yet acknowledged that it received
+          this version. Note that when the config was sent to the
+          device, many config versions may have been available in Cloud
+          IoT Core while the device was disconnected, and on connection,
+          only the latest version is sent to the device. Some versions
+          may never be sent to the device, and therefore are never
+          acknowledged. This timestamp is set by Cloud IoT Core.
+      binary_data:
+          The device configuration data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.DeviceConfig)
+    ),
+)
+_sym_db.RegisterMessage(DeviceConfig)
+
+DeviceState = _reflection.GeneratedProtocolMessageType(
+    "DeviceState",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEVICESTATE,
+        __module__="google.cloud.iot_v1.proto.resources_pb2",
+        __doc__="""The device state, as reported by the device.
+  
+  
+  Attributes:
+      update_time:
+          [Output only] The time at which this state version was updated
+          in Cloud IoT Core.
+      binary_data:
+          The device state data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.iot.v1.DeviceState)
+    ),
+)
+_sym_db.RegisterMessage(DeviceState)
+
+
+DESCRIPTOR._options = None
+_DEVICE_METADATAENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/iot/google/cloud/iot_v1/proto/resources_pb2_grpc.py b/iot/google/cloud/iot_v1/proto/resources_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/iot/google/cloud/iot_v1/proto/resources_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/iot/google/cloud/iot_v1/types.py b/iot/google/cloud/iot_v1/types.py
new file mode 100644
index 000000000000..1f040e0175df
--- /dev/null
+++ b/iot/google/cloud/iot_v1/types.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.iot_v1.proto import device_manager_pb2
+from google.cloud.iot_v1.proto import resources_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    any_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [device_manager_pb2, resources_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.iot_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/iot/noxfile.py b/iot/noxfile.py
new file mode 100644
index 000000000000..3d92df19084f
--- /dev/null
+++ b/iot/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=80")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/iot/setup.cfg b/iot/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/iot/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/iot/setup.py b/iot/setup.py
new file mode 100644
index 000000000000..435f97311e28
--- /dev/null
+++ b/iot/setup.py
@@ -0,0 +1,74 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-iot"
+description = "Cloud IoT API API client library"
+version = "0.3.0"
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@oogle.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/iot/synth.metadata b/iot/synth.metadata
new file mode 100644
index 000000000000..6306a7aaffc6
--- /dev/null
+++ b/iot/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:28:01.870632Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "iot",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/iot/artman_cloudiot.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/iot/synth.py b/iot/synth.py
new file mode 100644
index 000000000000..25d30833882d
--- /dev/null
+++ b/iot/synth.py
@@ -0,0 +1,44 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate iot GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "iot",
+    "v1",
+    config_path="/google/cloud/iot/artman_cloudiot.yaml",
+    artman_output_name="iot-v1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/iot_v1")
+s.move(library / "tests/unit/gapic")
+s.move(library / "tests/system/gapic")
+s.move(library / "docs", excludes="index.rst")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=80, cov_level=80)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/iot/tests/system/gapic/v1/test_system_device_manager_v1.py b/iot/tests/system/gapic/v1/test_system_device_manager_v1.py
new file mode 100644
index 000000000000..8006f8a7d995
--- /dev/null
+++ b/iot/tests/system/gapic/v1/test_system_device_manager_v1.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import iot_v1
+from google.cloud.iot_v1.proto import device_manager_pb2
+
+
+class TestSystemDeviceManager(object):
+    def test_list_device_registries(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = iot_v1.DeviceManagerClient()
+        parent = client.location_path(project_id, "us-central1")
+        response = client.list_device_registries(parent)
diff --git a/iot/tests/unit/gapic/v1/test_device_manager_client_v1.py b/iot/tests/unit/gapic/v1/test_device_manager_client_v1.py
new file mode 100644
index 000000000000..3bf279f2f5b4
--- /dev/null
+++ b/iot/tests/unit/gapic/v1/test_device_manager_client_v1.py
@@ -0,0 +1,869 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import iot_v1
+from google.cloud.iot_v1.proto import device_manager_pb2
+from google.cloud.iot_v1.proto import resources_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDeviceManagerClient(object):
+    def test_create_device_registry(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        expected_response = {"id": id_, "name": name}
+        expected_response = resources_pb2.DeviceRegistry(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        device_registry = {}
+
+        response = client.create_device_registry(parent, device_registry)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.CreateDeviceRegistryRequest(
+            parent=parent, device_registry=device_registry
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_device_registry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        device_registry = {}
+
+        with pytest.raises(CustomException):
+            client.create_device_registry(parent, device_registry)
+
+    def test_get_device_registry(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name_2 = "name2-1052831874"
+        expected_response = {"id": id_, "name": name_2}
+        expected_response = resources_pb2.DeviceRegistry(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        response = client.get_device_registry(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.GetDeviceRegistryRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_device_registry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        with pytest.raises(CustomException):
+            client.get_device_registry(name)
+
+    def test_update_device_registry(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        expected_response = {"id": id_, "name": name}
+        expected_response = resources_pb2.DeviceRegistry(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        device_registry = {}
+        update_mask = {}
+
+        response = client.update_device_registry(device_registry, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.UpdateDeviceRegistryRequest(
+            device_registry=device_registry, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_device_registry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        device_registry = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_device_registry(device_registry, update_mask)
+
+    def test_delete_device_registry(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        client.delete_device_registry(name)
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.DeleteDeviceRegistryRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_device_registry_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        with pytest.raises(CustomException):
+            client.delete_device_registry(name)
+
+    def test_list_device_registries(self):
+        # Setup Expected Response
+        next_page_token = ""
+        device_registries_element = {}
+        device_registries = [device_registries_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "device_registries": device_registries,
+        }
+        expected_response = device_manager_pb2.ListDeviceRegistriesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_device_registries(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.device_registries[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.ListDeviceRegistriesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_device_registries_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_device_registries(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_device(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        num_id = 1034366860
+        blocked = True
+        expected_response = {
+            "id": id_,
+            "name": name,
+            "num_id": num_id,
+            "blocked": blocked,
+        }
+        expected_response = resources_pb2.Device(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        device = {}
+
+        response = client.create_device(parent, device)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.CreateDeviceRequest(
+            parent=parent, device=device
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_device_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        device = {}
+
+        with pytest.raises(CustomException):
+            client.create_device(parent, device)
+
+    def test_get_device(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name_2 = "name2-1052831874"
+        num_id = 1034366860
+        blocked = True
+        expected_response = {
+            "id": id_,
+            "name": name_2,
+            "num_id": num_id,
+            "blocked": blocked,
+        }
+        expected_response = resources_pb2.Device(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        response = client.get_device(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.GetDeviceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_device_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        with pytest.raises(CustomException):
+            client.get_device(name)
+
+    def test_update_device(self):
+        # Setup Expected Response
+        id_ = "id3355"
+        name = "name3373707"
+        num_id = 1034366860
+        blocked = True
+        expected_response = {
+            "id": id_,
+            "name": name,
+            "num_id": num_id,
+            "blocked": blocked,
+        }
+        expected_response = resources_pb2.Device(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        device = {}
+        update_mask = {}
+
+        response = client.update_device(device, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.UpdateDeviceRequest(
+            device=device, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_device_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        device = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_device(device, update_mask)
+
+    def test_delete_device(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        client.delete_device(name)
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.DeleteDeviceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_device_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        with pytest.raises(CustomException):
+            client.delete_device(name)
+
+    def test_list_devices(self):
+        # Setup Expected Response
+        next_page_token = ""
+        devices_element = {}
+        devices = [devices_element]
+        expected_response = {"next_page_token": next_page_token, "devices": devices}
+        expected_response = device_manager_pb2.ListDevicesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        paged_list_response = client.list_devices(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.devices[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.ListDevicesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_devices_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        paged_list_response = client.list_devices(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_modify_cloud_to_device_config(self):
+        # Setup Expected Response
+        version = 351608024
+        binary_data_2 = b"-37"
+        expected_response = {"version": version, "binary_data": binary_data_2}
+        expected_response = resources_pb2.DeviceConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+        binary_data = b"40"
+
+        response = client.modify_cloud_to_device_config(name, binary_data)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.ModifyCloudToDeviceConfigRequest(
+            name=name, binary_data=binary_data
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_modify_cloud_to_device_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+        binary_data = b"40"
+
+        with pytest.raises(CustomException):
+            client.modify_cloud_to_device_config(name, binary_data)
+
+    def test_list_device_config_versions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = device_manager_pb2.ListDeviceConfigVersionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        response = client.list_device_config_versions(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.ListDeviceConfigVersionsRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_device_config_versions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        with pytest.raises(CustomException):
+            client.list_device_config_versions(name)
+
+    def test_list_device_states(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = device_manager_pb2.ListDeviceStatesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        response = client.list_device_states(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.ListDeviceStatesRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_device_states_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+
+        with pytest.raises(CustomException):
+            client.list_device_states(name)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        resource = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        resource = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        resource = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        resource = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        resource = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        resource = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
+
+    def test_send_command_to_device(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = device_manager_pb2.SendCommandToDeviceResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+        binary_data = b"40"
+
+        response = client.send_command_to_device(name, binary_data)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.SendCommandToDeviceRequest(
+            name=name, binary_data=binary_data
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_send_command_to_device_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        name = client.device_path("[PROJECT]", "[LOCATION]", "[REGISTRY]", "[DEVICE]")
+        binary_data = b"40"
+
+        with pytest.raises(CustomException):
+            client.send_command_to_device(name, binary_data)
+
+    def test_bind_device_to_gateway(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = device_manager_pb2.BindDeviceToGatewayResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        gateway_id = "gatewayId955798774"
+        device_id = "deviceId25209764"
+
+        response = client.bind_device_to_gateway(parent, gateway_id, device_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.BindDeviceToGatewayRequest(
+            parent=parent, gateway_id=gateway_id, device_id=device_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_bind_device_to_gateway_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        gateway_id = "gatewayId955798774"
+        device_id = "deviceId25209764"
+
+        with pytest.raises(CustomException):
+            client.bind_device_to_gateway(parent, gateway_id, device_id)
+
+    def test_unbind_device_from_gateway(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = device_manager_pb2.UnbindDeviceFromGatewayResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup Request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        gateway_id = "gatewayId955798774"
+        device_id = "deviceId25209764"
+
+        response = client.unbind_device_from_gateway(parent, gateway_id, device_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = device_manager_pb2.UnbindDeviceFromGatewayRequest(
+            parent=parent, gateway_id=gateway_id, device_id=device_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_unbind_device_from_gateway_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = iot_v1.DeviceManagerClient()
+
+        # Setup request
+        parent = client.registry_path("[PROJECT]", "[LOCATION]", "[REGISTRY]")
+        gateway_id = "gatewayId955798774"
+        device_id = "deviceId25209764"
+
+        with pytest.raises(CustomException):
+            client.unbind_device_from_gateway(parent, gateway_id, device_id)
diff --git a/irm/.coveragerc b/irm/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/irm/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/irm/.flake8 b/irm/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/irm/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/irm/.repo-metadata.json b/irm/.repo-metadata.json
new file mode 100644
index 000000000000..9432e3b5eb33
--- /dev/null
+++ b/irm/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "irm",
+  "name_pretty": "Stackdriver Incident Response and Management",
+  "product_documentation": "https://cloud.google.com/incident-response",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559785",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-irm",
+  "api_id": "irm.googleapis.com",
+  "requires_billing": true,
+  "client_documentation": "https://googleapis.dev/python/irm/latest"
+}
\ No newline at end of file
diff --git a/irm/CHANGELOG.md b/irm/CHANGELOG.md
new file mode 100644
index 000000000000..5ddad421e08f
--- /dev/null
+++ b/irm/CHANGELOG.md
@@ -0,0 +1 @@
+# Changelog
\ No newline at end of file
diff --git a/irm/LICENSE b/irm/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/irm/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/irm/MANIFEST.in b/irm/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/irm/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/irm/README.rst b/irm/README.rst
new file mode 100644
index 000000000000..e22e671b8130
--- /dev/null
+++ b/irm/README.rst
@@ -0,0 +1,77 @@
+Python Client for Stackdriver Incident Response & Management API (`Alpha`_)
+===========================================================================
+
+
+
+`Stackdriver Incident Response & Management API`_:
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Stackdriver Incident Response & Management API: https://cloud.google.com/incident-response/
+.. _Client Library Documentation: https://googleapis.dev/python/irm/latest
+.. _Product Documentation:  https://cloud.google.com/incident-response/docs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Stackdriver Incident Response & Management API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Stackdriver Incident Response & Management API.:  https://cloud.google.com/irm
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-irm
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-irm
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Stackdriver Incident Response & Management API
+   API to see other available methods on the client.
+-  Read the `Stackdriver Incident Response & Management API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Stackdriver Incident Response & Management API Product documentation:  https://cloud.google.com/irm
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/irm/docs/README.rst b/irm/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/irm/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/irm/docs/changelog.md b/irm/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/irm/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/irm/docs/conf.py b/irm/docs/conf.py
new file mode 100644
index 000000000000..9c014936073a
--- /dev/null
+++ b/irm/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-irm documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-irm"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-irm-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-irm.tex",
+        u"google-cloud-irm Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-irm", u"google-cloud-irm Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-irm",
+        u"google-cloud-irm Documentation",
+        author,
+        "google-cloud-irm",
+        "GAPIC library for the {metadata.shortName} v1alpha2 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/irm/docs/gapic/v1alpha2/api.rst b/irm/docs/gapic/v1alpha2/api.rst
new file mode 100644
index 000000000000..7ce0f5fb0348
--- /dev/null
+++ b/irm/docs/gapic/v1alpha2/api.rst
@@ -0,0 +1,6 @@
+Client for Stackdriver Incident Response & Management API
+=========================================================
+
+.. automodule:: google.cloud.irm_v1alpha2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/irm/docs/gapic/v1alpha2/types.rst b/irm/docs/gapic/v1alpha2/types.rst
new file mode 100644
index 000000000000..e545e1be6786
--- /dev/null
+++ b/irm/docs/gapic/v1alpha2/types.rst
@@ -0,0 +1,5 @@
+Types for Stackdriver Incident Response & Management API Client
+===============================================================
+
+.. automodule:: google.cloud.irm_v1alpha2.types
+    :members:
\ No newline at end of file
diff --git a/irm/docs/index.rst b/irm/docs/index.rst
new file mode 100644
index 000000000000..7ecec7615d49
--- /dev/null
+++ b/irm/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1alpha2/api
+    gapic/v1alpha2/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-irm`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
\ No newline at end of file
diff --git a/irm/google/__init__.py b/irm/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/irm/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/irm/google/cloud/__init__.py b/irm/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/irm/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/irm/google/cloud/irm.py b/irm/google/cloud/irm.py
new file mode 100644
index 000000000000..e1a117af6972
--- /dev/null
+++ b/irm/google/cloud/irm.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.irm_v1alpha2 import IncidentServiceClient
+from google.cloud.irm_v1alpha2 import enums
+from google.cloud.irm_v1alpha2 import types
+
+
+__all__ = ("enums", "types", "IncidentServiceClient")
diff --git a/irm/google/cloud/irm_v1alpha2/__init__.py b/irm/google/cloud/irm_v1alpha2/__init__.py
new file mode 100644
index 000000000000..4d885824ca33
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.irm_v1alpha2 import types
+from google.cloud.irm_v1alpha2.gapic import enums
+from google.cloud.irm_v1alpha2.gapic import incident_service_client
+
+
+class IncidentServiceClient(incident_service_client.IncidentServiceClient):
+    __doc__ = incident_service_client.IncidentServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "IncidentServiceClient")
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/__init__.py b/irm/google/cloud/irm_v1alpha2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/enums.py b/irm/google/cloud/irm_v1alpha2/gapic/enums.py
new file mode 100644
index 000000000000..15e7d5d54b08
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/gapic/enums.py
@@ -0,0 +1,187 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Artifact(object):
+    class Type(enum.IntEnum):
+        """
+        Possible types of an artifact.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): External type is unspecified.
+          TYPE_URL (int): URL.
+          TYPE_JIRA_ISSUE (int): A JIRA issue.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        TYPE_URL = 1
+        TYPE_JIRA_ISSUE = 4
+
+
+class Incident(object):
+    class EscalationLevel(enum.IntEnum):
+        """
+        Specifies the escalation level of this incident, within the IRM protocol
+        for handling incidents.
+
+        Attributes:
+          ESCALATION_LEVEL_UNSPECIFIED (int): The incident has not been escalated. This is the value used by all new
+          and legacy incidents.
+          ESCALATION_LEVEL_ORGANIZATION (int): The incident has been escalated to the organizational level.
+        """
+
+        ESCALATION_LEVEL_UNSPECIFIED = 0
+        ESCALATION_LEVEL_ORGANIZATION = 1
+
+    class Severity(enum.IntEnum):
+        """
+        Severity of an incident.
+
+        Attributes:
+          SEVERITY_UNSPECIFIED (int): Severity is not specified.
+          SEVERITY_HUGE (int): Huge incident.
+          SEVERITY_MAJOR (int): Major incident.
+          SEVERITY_MEDIUM (int): Medium incident.
+          SEVERITY_MINOR (int): Minor incident.
+          SEVERITY_NEGLIGIBLE (int): Negligible incident.
+        """
+
+        SEVERITY_UNSPECIFIED = 0
+        SEVERITY_HUGE = 1
+        SEVERITY_MAJOR = 2
+        SEVERITY_MEDIUM = 3
+        SEVERITY_MINOR = 4
+        SEVERITY_NEGLIGIBLE = 5
+
+    class Stage(enum.IntEnum):
+        """
+        Stage of an incident.
+
+        Attributes:
+          STAGE_UNSPECIFIED (int): This is the default value if no stage has been specified.
+          Note: The caller of the API should set the stage to DETECTED.
+          STAGE_DETECTED (int): The incident has been detected. This is the initial stage of a new
+          incident.
+          Note: The caller still has to set the stage manually.
+          STAGE_TRIAGED (int): This incident has been formally characterized.
+          STAGE_MITIGATED (int): This incident has been mitigated, i.e. does not affect the service level
+          anymore.
+          STAGE_RESOLVED (int): This incident has been fully resolved, i.e. there are no immediate
+          follow-up tasks.
+          STAGE_DOCUMENTED (int): Postmortem for the incident was written.
+          STAGE_DUPLICATE (int): Stage for an incident with ``duplicate_incident``. This incident is not
+          authoritative anymore and the ``duplicate_incident`` should be used to
+          determine the stage.
+        """
+
+        STAGE_UNSPECIFIED = 0
+        STAGE_DETECTED = 4
+        STAGE_TRIAGED = 1
+        STAGE_MITIGATED = 2
+        STAGE_RESOLVED = 3
+        STAGE_DOCUMENTED = 5
+        STAGE_DUPLICATE = 6
+
+    class CommunicationVenue(object):
+        class ChannelType(enum.IntEnum):
+            """
+            The type of channel/venue for incident communications.
+
+            Attributes:
+              CHANNEL_TYPE_UNSPECIFIED (int): An unspecified communication channel.
+              CHANNEL_TYPE_URI (int): A communication channel that is represented by a generic URI.
+              CHANNEL_TYPE_SLACK (int): A communication channel that represents a Slack channel.
+            """
+
+            CHANNEL_TYPE_UNSPECIFIED = 0
+            CHANNEL_TYPE_URI = 1
+            CHANNEL_TYPE_SLACK = 5
+
+
+class IncidentRole(object):
+    class Type(enum.IntEnum):
+        """
+        List of possible roles.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): The role is unspecified.
+          TYPE_INCIDENT_COMMANDER (int): Incident Commander: Manages response plan, near-term and long-term
+          objectives, establishes priorities, and delegates tasks as needed.
+          TYPE_COMMUNICATIONS_LEAD (int): Communications Lead: Keeps everybody outside and within the response team
+          informed.
+          TYPE_OPERATIONS_LEAD (int): Operations Lead: Figures out what to do, and gets it done.
+          TYPE_EXTERNAL_CUSTOMER_COMMUNICATIONS_LEAD (int): External Customer Communications Lead: Responsible for communicating
+          incident details to customers/public.
+          TYPE_PRIMARY_ONCALL (int): Primary Oncall: Responds to the initial page and handles all
+          responsibilities for pre-escalated incidents.
+          TYPE_SECONDARY_ONCALL (int): Secondary Oncall: Helps the primary oncall if necessary; mostly useful
+          for pre-escalated incidents.
+          TYPE_OTHER (int): User-specified roles. One example is a Planning Lead, who keeps track of
+          the incident. Another is an assistant Incident Commander.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        TYPE_INCIDENT_COMMANDER = 1
+        TYPE_COMMUNICATIONS_LEAD = 2
+        TYPE_OPERATIONS_LEAD = 3
+        TYPE_EXTERNAL_CUSTOMER_COMMUNICATIONS_LEAD = 4
+        TYPE_PRIMARY_ONCALL = 5
+        TYPE_SECONDARY_ONCALL = 6
+        TYPE_OTHER = 7
+
+
+class Signal(object):
+    class State(enum.IntEnum):
+        """
+        Describes whether the alerting condition is still firing.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified
+          STATE_OPEN (int): Firing
+          STATE_CLOSED (int): Non-firing
+        """
+
+        STATE_UNSPECIFIED = 0
+        STATE_OPEN = 1
+        STATE_CLOSED = 2
+
+
+class Subscription(object):
+    class EventType(enum.IntEnum):
+        """
+        Types of changes that users can subscribe to in an incident.
+
+        Attributes:
+          EVENT_TYPE_UNSPECIFIED (int): An event_type that's not specified is an error.
+          EVENT_TYPE_TITLE_CHANGE (int): The incident's title has changed.
+          EVENT_TYPE_SYNOPSIS_CHANGE (int): The incident's synopsis has changed.
+          EVENT_TYPE_STAGE_CHANGE (int): The incident's stage has changed.
+          EVENT_TYPE_SEVERITY_CHANGE (int): The incident's severity has changed.
+          EVENT_TYPE_ANNOTATION_ADD (int): A new annotation has been added to the incident.
+          EVENT_TYPE_ANNOTATION_CHANGE (int): An annotation has been modified.
+        """
+
+        EVENT_TYPE_UNSPECIFIED = 0
+        EVENT_TYPE_TITLE_CHANGE = 1
+        EVENT_TYPE_SYNOPSIS_CHANGE = 2
+        EVENT_TYPE_STAGE_CHANGE = 3
+        EVENT_TYPE_SEVERITY_CHANGE = 4
+        EVENT_TYPE_ANNOTATION_ADD = 5
+        EVENT_TYPE_ANNOTATION_CHANGE = 6
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/incident_service_client.py b/irm/google/cloud/irm_v1alpha2/gapic/incident_service_client.py
new file mode 100644
index 000000000000..6906700cbe92
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/gapic/incident_service_client.py
@@ -0,0 +1,3147 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.irm.v1alpha2 IncidentService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.irm_v1alpha2.gapic import enums
+from google.cloud.irm_v1alpha2.gapic import incident_service_client_config
+from google.cloud.irm_v1alpha2.gapic.transports import incident_service_grpc_transport
+from google.cloud.irm_v1alpha2.proto import incidents_pb2
+from google.cloud.irm_v1alpha2.proto import incidents_service_pb2
+from google.cloud.irm_v1alpha2.proto import incidents_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-irm").version
+
+
+class IncidentServiceClient(object):
+    """The Incident API for Incident Response & Management."""
+
+    SERVICE_ADDRESS = "irm.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.irm.v1alpha2.IncidentService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            IncidentServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def annotation_path(cls, project, incident, annotation):
+        """Return a fully-qualified annotation string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/incidents/{incident}/annotations/{annotation}",
+            project=project,
+            incident=incident,
+            annotation=annotation,
+        )
+
+    @classmethod
+    def artifact_path(cls, project, incident, artifact):
+        """Return a fully-qualified artifact string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/incidents/{incident}/artifacts/{artifact}",
+            project=project,
+            incident=incident,
+            artifact=artifact,
+        )
+
+    @classmethod
+    def incident_path(cls, project, incident):
+        """Return a fully-qualified incident string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/incidents/{incident}",
+            project=project,
+            incident=incident,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def role_assignment_path(cls, project, incident, role_assignment):
+        """Return a fully-qualified role_assignment string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/incidents/{incident}/roleAssignments/{role_assignment}",
+            project=project,
+            incident=incident,
+            role_assignment=role_assignment,
+        )
+
+    @classmethod
+    def signal_path(cls, project, signal):
+        """Return a fully-qualified signal string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/signals/{signal}", project=project, signal=signal
+        )
+
+    @classmethod
+    def subscription_path(cls, project, incident, subscription):
+        """Return a fully-qualified subscription string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/incidents/{incident}/subscriptions/{subscription}",
+            project=project,
+            incident=incident,
+            subscription=subscription,
+        )
+
+    @classmethod
+    def tag_path(cls, project, incident, tag):
+        """Return a fully-qualified tag string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/incidents/{incident}/tags/{tag}",
+            project=project,
+            incident=incident,
+            tag=tag,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.IncidentServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.IncidentServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = incident_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=incident_service_grpc_transport.IncidentServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = incident_service_grpc_transport.IncidentServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_incident(
+        self,
+        incident,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> # TODO: Initialize `incident`:
+            >>> incident = {}
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> response = client.create_incident(incident, parent)
+
+        Args:
+            incident (Union[dict, ~google.cloud.irm_v1alpha2.types.Incident]): The incident to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Incident`
+            parent (str): The resource name of the hosting Stackdriver project which the incident
+                belongs to. The name is of the form ``projects/{project_id_or_number}``
+                .
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Incident` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_incident" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_incident"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_incident,
+                default_retry=self._method_configs["CreateIncident"].retry,
+                default_timeout=self._method_configs["CreateIncident"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateIncidentRequest(
+            incident=incident, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_incident"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_incident(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns an incident by name.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> response = client.get_incident(name)
+
+        Args:
+            name (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Incident` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_incident" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_incident"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_incident,
+                default_retry=self._method_configs["GetIncident"].retry,
+                default_timeout=self._method_configs["GetIncident"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.GetIncidentRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_incident"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_incidents(
+        self,
+        parent,
+        query=None,
+        page_size=None,
+        time_zone=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of incidents.
+        Incidents are ordered by start time, with the most recent incidents first.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_incidents(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_incidents(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The resource name of the hosting Stackdriver project which requested
+                incidents belong to.
+            query (str): An expression that defines which incidents to return.
+
+                Search atoms can be used to match certain specific fields. Otherwise,
+                plain text will match text fields in the incident.
+
+                Search atoms:
+
+                -  ``start`` - (timestamp) The time the incident started.
+                -  ``stage`` - The stage of the incident, one of detected, triaged,
+                   mitigated, resolved, documented, or duplicate (which correspond to
+                   values in the Incident.Stage enum). These are ordered, so
+                   ``stage<resolved`` is equivalent to
+                   ``stage:detected OR stage:triaged OR stage:mitigated``.
+                -  ``severity`` - (Incident.Severity) The severity of the incident.
+
+                   -  Supports matching on a specific severity (for example,
+                      ``severity:major``) or on a range (for example,
+                      ``severity>medium``, ``severity<=minor``, etc.).
+
+                Timestamp formats:
+
+                -  yyyy-MM-dd - an absolute date, treated as a calendar-day-wide window.
+                   In other words, the "<" operator will match dates before that date,
+                   the ">" operator will match dates after that date, and the ":" or "="
+                   operators will match the entire day.
+                -  Nd (for example, 7d) - a relative number of days ago, treated as a
+                   moment in time (as opposed to a day-wide span). A multiple of 24
+                   hours ago (as opposed to calendar days). In the case of daylight
+                   savings time, it will apply the current timezone to both ends of the
+                   range. Note that exact matching (for example, ``start:7d``) is
+                   unlikely to be useful because that would only match incidents created
+                   precisely at a particular instant in time.
+
+                Examples:
+
+                -  ``foo`` - matches incidents containing the word "foo"
+                -  ``"foo bar"`` - matches incidents containing the phrase "foo bar"
+                -  ``foo bar`` or ``foo AND bar`` - matches incidents containing the
+                   words "foo" and "bar"
+                -  ``foo -bar`` or ``foo AND NOT bar`` - matches incidents containing
+                   the word "foo" but not the word "bar"
+                -  ``foo OR bar`` - matches incidents containing the word "foo" or the
+                   word "bar"
+                -  ``start>2018-11-28`` - matches incidents which started after November
+                   11,
+
+                   2018.
+
+                -  ``start<=2018-11-28`` - matches incidents which started on or before
+                   November 11, 2018.
+                -  ``start:2018-11-28`` - matches incidents which started on November
+                   11,
+
+                   2018.
+
+                -  ``start>7d`` - matches incidents which started after the point in
+                   time 7*24 hours ago
+                -  ``start>180d`` - similar to 7d, but likely to cross the daylight
+                   savings time boundary, so the end time will be 1 hour different from
+                   "now."
+                -  ``foo AND start>90d AND stage<resolved`` - unresolved incidents from
+                   the past 90 days containing the word "foo"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            time_zone (str): The time zone name. It should be an IANA TZ name, such as
+                "America/Los_Angeles". For more information, see
+                https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If no
+                time zone is specified, the default is UTC.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Incident` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_incidents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_incidents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_incidents,
+                default_retry=self._method_configs["SearchIncidents"].retry,
+                default_timeout=self._method_configs["SearchIncidents"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.SearchIncidentsRequest(
+            parent=parent, query=query, page_size=page_size, time_zone=time_zone
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_incidents"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="incidents",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_incident(
+        self,
+        incident,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> # TODO: Initialize `incident`:
+            >>> incident = {}
+            >>>
+            >>> response = client.update_incident(incident)
+
+        Args:
+            incident (Union[dict, ~google.cloud.irm_v1alpha2.types.Incident]): The incident to update with the new values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Incident`
+            update_mask (Union[dict, ~google.cloud.irm_v1alpha2.types.FieldMask]): List of fields that should be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Incident` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_incident" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_incident"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_incident,
+                default_retry=self._method_configs["UpdateIncident"].retry,
+                default_timeout=self._method_configs["UpdateIncident"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.UpdateIncidentRequest(
+            incident=incident, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("incident.name", incident.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_incident"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_similar_incidents(
+        self,
+        name,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_similar_incidents(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_similar_incidents(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): Resource name of the incident or signal, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Result` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_similar_incidents" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_similar_incidents"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_similar_incidents,
+                default_retry=self._method_configs["SearchSimilarIncidents"].retry,
+                default_timeout=self._method_configs["SearchSimilarIncidents"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.SearchSimilarIncidentsRequest(
+            name=name, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_similar_incidents"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_annotation(
+        self,
+        parent,
+        annotation,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an annotation on an existing incident. Only 'text/plain' and
+        'text/markdown' annotations can be created via this method.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # TODO: Initialize `annotation`:
+            >>> annotation = {}
+            >>>
+            >>> response = client.create_annotation(parent, annotation)
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            annotation (Union[dict, ~google.cloud.irm_v1alpha2.types.Annotation]): Only annotation.content is an input argument.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Annotation`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Annotation` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_annotation" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_annotation"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_annotation,
+                default_retry=self._method_configs["CreateAnnotation"].retry,
+                default_timeout=self._method_configs["CreateAnnotation"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateAnnotationRequest(
+            parent=parent, annotation=annotation
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_annotation"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_annotations(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists annotations that are part of an incident. No assumptions should be
+        made on the content-type of the annotation returned.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_annotations(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_annotations(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Annotation` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_annotations" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_annotations"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_annotations,
+                default_retry=self._method_configs["ListAnnotations"].retry,
+                default_timeout=self._method_configs["ListAnnotations"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ListAnnotationsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_annotations"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="annotations",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_tag(
+        self,
+        parent,
+        tag,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a tag on an existing incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # TODO: Initialize `tag`:
+            >>> tag = {}
+            >>>
+            >>> response = client.create_tag(parent, tag)
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            tag (Union[dict, ~google.cloud.irm_v1alpha2.types.Tag]): Tag to create. Only tag.display_name is an input argument.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Tag`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Tag` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_tag" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_tag"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_tag,
+                default_retry=self._method_configs["CreateTag"].retry,
+                default_timeout=self._method_configs["CreateTag"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateTagRequest(parent=parent, tag=tag)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_tag"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_tag(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing tag.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.tag_path('[PROJECT]', '[INCIDENT]', '[TAG]')
+            >>>
+            >>> client.delete_tag(name)
+
+        Args:
+            name (str): Resource name of the tag.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_tag" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_tag"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_tag,
+                default_retry=self._method_configs["DeleteTag"].retry,
+                default_timeout=self._method_configs["DeleteTag"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.DeleteTagRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_tag"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_tags(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists tags that are part of an incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tags(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tags(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Tag` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tags" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tags"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tags,
+                default_retry=self._method_configs["ListTags"].retry,
+                default_timeout=self._method_configs["ListTags"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ListTagsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tags"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tags",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_signal(
+        self,
+        parent,
+        signal,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new signal.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `signal`:
+            >>> signal = {}
+            >>>
+            >>> response = client.create_signal(parent, signal)
+
+        Args:
+            parent (str): The resource name of the hosting Stackdriver project which requested
+                signal belongs to.
+            signal (Union[dict, ~google.cloud.irm_v1alpha2.types.Signal]): The signal to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Signal`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Signal` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_signal" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_signal"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_signal,
+                default_retry=self._method_configs["CreateSignal"].retry,
+                default_timeout=self._method_configs["CreateSignal"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateSignalRequest(
+            parent=parent, signal=signal
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_signal"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_signals(
+        self,
+        parent,
+        query=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists signals that are part of an incident.
+        Signals are returned in reverse chronological order.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_signals(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_signals(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The resource name of the hosting Stackdriver project which requested
+                incidents belong to.
+            query (str): An expression that defines which signals to return.
+
+                Search atoms can be used to match certain specific fields. Otherwise,
+                plain text will match text fields in the signal.
+
+                Search atoms:
+
+                -  ``start`` - (timestamp) The time the signal was created.
+                -  ``title`` - The title of the signal.
+                -  ``signal_state`` - ``open`` or ``closed``. State of the signal.
+                   (e.g., ``signal_state:open``)
+
+                Timestamp formats:
+
+                -  yyyy-MM-dd - an absolute date, treated as a calendar-day-wide window.
+                   In other words, the "<" operator will match dates before that date,
+                   the ">" operator will match dates after that date, and the ":"
+                   operator will match the entire day.
+                -  yyyy-MM-ddTHH:mm - Same as above, but with minute resolution.
+                -  yyyy-MM-ddTHH:mm:ss - Same as above, but with second resolution.
+                -  Nd (e.g. 7d) - a relative number of days ago, treated as a moment in
+                   time (as opposed to a day-wide span) a multiple of 24 hours ago (as
+                   opposed to calendar days). In the case of daylight savings time, it
+                   will apply the current timezone to both ends of the range. Note that
+                   exact matching (e.g. ``start:7d``) is unlikely to be useful because
+                   that would only match signals created precisely at a particular
+                   instant in time.
+
+                The absolute timestamp formats (everything starting with a year) can
+                optionally be followed with a UTC offset in +/-hh:mm format. Also, the
+                'T' separating dates and times can optionally be replaced with a space.
+                Note that any timestamp containing a space or colon will need to be
+                quoted.
+
+                Examples:
+
+                -  ``foo`` - matches signals containing the word "foo"
+                -  ``"foo bar"`` - matches signals containing the phrase "foo bar"
+                -  ``foo bar`` or ``foo AND bar`` - matches signals containing the words
+                   "foo" and "bar"
+                -  ``foo -bar`` or ``foo AND NOT bar`` - matches signals containing the
+                   word "foo" but not the word "bar"
+                -  ``foo OR bar`` - matches signals containing the word "foo" or the
+                   word "bar"
+                -  ``start>2018-11-28`` - matches signals which started after November
+                   11, 2018.
+                -  ``start<=2018-11-28`` - matches signals which started on or before
+                   November 11, 2018.
+                -  ``start:2018-11-28`` - matches signals which started on November 11,
+
+                   2018.
+
+                -  ``start>"2018-11-28 01:02:03+04:00"`` - matches signals which started
+                   after November 11, 2018 at 1:02:03 AM according to the UTC+04 time
+                   zone.
+                -  ``start>7d`` - matches signals which started after the point in time
+                   7*24 hours ago
+                -  ``start>180d`` - similar to 7d, but likely to cross the daylight
+                   savings time boundary, so the end time will be 1 hour different from
+                   "now."
+                -  ``foo AND start>90d AND stage<resolved`` - unresolved signals from
+                   the past 90 days containing the word "foo"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Signal` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_signals" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_signals"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_signals,
+                default_retry=self._method_configs["SearchSignals"].retry,
+                default_timeout=self._method_configs["SearchSignals"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.SearchSignalsRequest(
+            parent=parent, query=query, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_signals"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="signals",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_signal(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a signal by name.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.signal_path('[PROJECT]', '[SIGNAL]')
+            >>>
+            >>> response = client.get_signal(name)
+
+        Args:
+            name (str): Resource name of the Signal resource, for example,
+                "projects/{project_id}/signals/{signal_id}".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Signal` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_signal" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_signal"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_signal,
+                default_retry=self._method_configs["GetSignal"].retry,
+                default_timeout=self._method_configs["GetSignal"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.GetSignalRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_signal"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def lookup_signal(
+        self,
+        cscc_finding=None,
+        stackdriver_notification_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Finds a signal by other unique IDs.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> response = client.lookup_signal()
+
+        Args:
+            cscc_finding (str): Full resource name of the CSCC finding id this signal refers to (e.g.
+                "organizations/abc/sources/123/findings/xyz")
+            stackdriver_notification_id (str): The ID from the Stackdriver Alerting notification.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Signal` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "lookup_signal" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "lookup_signal"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.lookup_signal,
+                default_retry=self._method_configs["LookupSignal"].retry,
+                default_timeout=self._method_configs["LookupSignal"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            cscc_finding=cscc_finding,
+            stackdriver_notification_id=stackdriver_notification_id,
+        )
+
+        request = incidents_service_pb2.LookupSignalRequest(
+            cscc_finding=cscc_finding,
+            stackdriver_notification_id=stackdriver_notification_id,
+        )
+        return self._inner_api_calls["lookup_signal"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_signal(
+        self,
+        signal,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing signal (for example, to assign/unassign it to an
+        incident).
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> # TODO: Initialize `signal`:
+            >>> signal = {}
+            >>>
+            >>> response = client.update_signal(signal)
+
+        Args:
+            signal (Union[dict, ~google.cloud.irm_v1alpha2.types.Signal]): The signal to update with the new values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Signal`
+            update_mask (Union[dict, ~google.cloud.irm_v1alpha2.types.FieldMask]): List of fields that should be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Signal` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_signal" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_signal"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_signal,
+                default_retry=self._method_configs["UpdateSignal"].retry,
+                default_timeout=self._method_configs["UpdateSignal"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.UpdateSignalRequest(
+            signal=signal, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("signal.name", signal.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_signal"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def escalate_incident(
+        self,
+        incident,
+        update_mask=None,
+        subscriptions=None,
+        tags=None,
+        roles=None,
+        artifacts=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Escalates an incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> # TODO: Initialize `incident`:
+            >>> incident = {}
+            >>>
+            >>> response = client.escalate_incident(incident)
+
+        Args:
+            incident (Union[dict, ~google.cloud.irm_v1alpha2.types.Incident]): The incident to escalate with the new values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Incident`
+            update_mask (Union[dict, ~google.cloud.irm_v1alpha2.types.FieldMask]): List of fields that should be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.FieldMask`
+            subscriptions (list[Union[dict, ~google.cloud.irm_v1alpha2.types.Subscription]]): Subscriptions to add or update. Existing subscriptions with the same
+                channel and address as a subscription in the list will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Subscription`
+            tags (list[Union[dict, ~google.cloud.irm_v1alpha2.types.Tag]]): Tags to add. Tags identical to existing tags will be ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Tag`
+            roles (list[Union[dict, ~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment]]): Roles to add or update. Existing roles with the same type (and title,
+                for TYPE_OTHER roles) will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment`
+            artifacts (list[Union[dict, ~google.cloud.irm_v1alpha2.types.Artifact]]): Artifacts to add. All artifacts are added without checking for duplicates.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Artifact`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.EscalateIncidentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "escalate_incident" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "escalate_incident"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.escalate_incident,
+                default_retry=self._method_configs["EscalateIncident"].retry,
+                default_timeout=self._method_configs["EscalateIncident"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.EscalateIncidentRequest(
+            incident=incident,
+            update_mask=update_mask,
+            subscriptions=subscriptions,
+            tags=tags,
+            roles=roles,
+            artifacts=artifacts,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("incident.name", incident.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["escalate_incident"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_artifact(
+        self,
+        parent,
+        artifact,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new artifact.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # TODO: Initialize `artifact`:
+            >>> artifact = {}
+            >>>
+            >>> response = client.create_artifact(parent, artifact)
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            artifact (Union[dict, ~google.cloud.irm_v1alpha2.types.Artifact]): The artifact to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Artifact`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Artifact` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_artifact" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_artifact"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_artifact,
+                default_retry=self._method_configs["CreateArtifact"].retry,
+                default_timeout=self._method_configs["CreateArtifact"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateArtifactRequest(
+            parent=parent, artifact=artifact
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_artifact"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_artifacts(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of artifacts for an incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_artifacts(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_artifacts(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Artifact` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_artifacts" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_artifacts"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_artifacts,
+                default_retry=self._method_configs["ListArtifacts"].retry,
+                default_timeout=self._method_configs["ListArtifacts"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ListArtifactsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_artifacts"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="artifacts",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_artifact(
+        self,
+        artifact,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing artifact.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> # TODO: Initialize `artifact`:
+            >>> artifact = {}
+            >>>
+            >>> response = client.update_artifact(artifact)
+
+        Args:
+            artifact (Union[dict, ~google.cloud.irm_v1alpha2.types.Artifact]): The artifact to update with the new values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Artifact`
+            update_mask (Union[dict, ~google.cloud.irm_v1alpha2.types.FieldMask]): List of fields that should be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Artifact` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_artifact" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_artifact"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_artifact,
+                default_retry=self._method_configs["UpdateArtifact"].retry,
+                default_timeout=self._method_configs["UpdateArtifact"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.UpdateArtifactRequest(
+            artifact=artifact, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("artifact.name", artifact.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_artifact"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_artifact(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing artifact.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.artifact_path('[PROJECT]', '[INCIDENT]', '[ARTIFACT]')
+            >>>
+            >>> client.delete_artifact(name)
+
+        Args:
+            name (str): Resource name of the artifact.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_artifact" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_artifact"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_artifact,
+                default_retry=self._method_configs["DeleteArtifact"].retry,
+                default_timeout=self._method_configs["DeleteArtifact"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.DeleteArtifactRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_artifact"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def send_shift_handoff(
+        self,
+        parent,
+        recipients,
+        subject,
+        cc=None,
+        notes_content_type=None,
+        notes_content=None,
+        incidents=None,
+        preview_only=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sends a summary of the shift for oncall handoff.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `recipients`:
+            >>> recipients = []
+            >>>
+            >>> # TODO: Initialize `subject`:
+            >>> subject = ''
+            >>>
+            >>> response = client.send_shift_handoff(parent, recipients, subject)
+
+        Args:
+            parent (str): The resource name of the Stackdriver project that the handoff is being
+                sent from. for example, ``projects/{project_id}``
+            recipients (list[str]): Email addresses of the recipients of the handoff, for example,
+                "user@example.com". Must contain at least one entry.
+            subject (str): The subject of the email. Required.
+            cc (list[str]): Email addresses that should be CC'd on the handoff. Optional.
+            notes_content_type (str): Content type string, for example, 'text/plain' or 'text/html'.
+            notes_content (str): Additional notes to be included in the handoff. Optional.
+            incidents (list[Union[dict, ~google.cloud.irm_v1alpha2.types.Incident]]): The set of incidents that should be included in the handoff. Optional.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Incident`
+            preview_only (bool): If set to true a ShiftHandoffResponse will be returned but the handoff
+                will not actually be sent.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.SendShiftHandoffResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "send_shift_handoff" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "send_shift_handoff"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.send_shift_handoff,
+                default_retry=self._method_configs["SendShiftHandoff"].retry,
+                default_timeout=self._method_configs["SendShiftHandoff"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.SendShiftHandoffRequest(
+            parent=parent,
+            recipients=recipients,
+            subject=subject,
+            cc=cc,
+            notes_content_type=notes_content_type,
+            notes_content=notes_content,
+            incidents=incidents,
+            preview_only=preview_only,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["send_shift_handoff"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_subscription(
+        self,
+        parent,
+        subscription,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new subscription.
+        This will fail if:
+        a. there are too many (50) subscriptions in the incident already
+        b. a subscription using the given channel already exists
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # TODO: Initialize `subscription`:
+            >>> subscription = {}
+            >>>
+            >>> response = client.create_subscription(parent, subscription)
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            subscription (Union[dict, ~google.cloud.irm_v1alpha2.types.Subscription]): The subscription to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Subscription`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Subscription` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_subscription,
+                default_retry=self._method_configs["CreateSubscription"].retry,
+                default_timeout=self._method_configs["CreateSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateSubscriptionRequest(
+            parent=parent, subscription=subscription
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_subscription(
+        self,
+        subscription,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a subscription.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> # TODO: Initialize `subscription`:
+            >>> subscription = {}
+            >>>
+            >>> response = client.update_subscription(subscription)
+
+        Args:
+            subscription (Union[dict, ~google.cloud.irm_v1alpha2.types.Subscription]): The subscription to update, with new values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.Subscription`
+            update_mask (Union[dict, ~google.cloud.irm_v1alpha2.types.FieldMask]): List of fields that should be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.Subscription` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_subscription,
+                default_retry=self._method_configs["UpdateSubscription"].retry,
+                default_timeout=self._method_configs["UpdateSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.UpdateSubscriptionRequest(
+            subscription=subscription, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription.name", subscription.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_subscriptions(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of subscriptions for an incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_subscriptions(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_subscriptions(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.Subscription` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_subscriptions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_subscriptions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_subscriptions,
+                default_retry=self._method_configs["ListSubscriptions"].retry,
+                default_timeout=self._method_configs["ListSubscriptions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ListSubscriptionsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_subscriptions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="subscriptions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_subscription(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing subscription.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.subscription_path('[PROJECT]', '[INCIDENT]', '[SUBSCRIPTION]')
+            >>>
+            >>> client.delete_subscription(name)
+
+        Args:
+            name (str): Resource name of the subscription.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_subscription,
+                default_retry=self._method_configs["DeleteSubscription"].retry,
+                default_timeout=self._method_configs["DeleteSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.DeleteSubscriptionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_incident_role_assignment(
+        self,
+        parent,
+        incident_role_assignment,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a role assignment on an existing incident. Normally, the user field
+        will be set when assigning a role to oneself, and the next field will be
+        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.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # TODO: Initialize `incident_role_assignment`:
+            >>> incident_role_assignment = {}
+            >>>
+            >>> response = client.create_incident_role_assignment(parent, incident_role_assignment)
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            incident_role_assignment (Union[dict, ~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment]): Role assignment to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_incident_role_assignment" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_incident_role_assignment"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_incident_role_assignment,
+                default_retry=self._method_configs[
+                    "CreateIncidentRoleAssignment"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "CreateIncidentRoleAssignment"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CreateIncidentRoleAssignmentRequest(
+            parent=parent, incident_role_assignment=incident_role_assignment
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_incident_role_assignment"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_incident_role_assignment(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing role assignment.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.role_assignment_path('[PROJECT]', '[INCIDENT]', '[ROLE_ASSIGNMENT]')
+            >>>
+            >>> client.delete_incident_role_assignment(name)
+
+        Args:
+            name (str): Resource name of the role assignment.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_incident_role_assignment" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_incident_role_assignment"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_incident_role_assignment,
+                default_retry=self._method_configs[
+                    "DeleteIncidentRoleAssignment"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "DeleteIncidentRoleAssignment"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.DeleteIncidentRoleAssignmentRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_incident_role_assignment"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_incident_role_assignments(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists role assignments that are part of an incident.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> parent = client.incident_path('[PROJECT]', '[INCIDENT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_incident_role_assignments(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_incident_role_assignments(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the incident, for example,
+                "projects/{project_id}/incidents/{incident_id}".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_incident_role_assignments" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_incident_role_assignments"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_incident_role_assignments,
+                default_retry=self._method_configs["ListIncidentRoleAssignments"].retry,
+                default_timeout=self._method_configs[
+                    "ListIncidentRoleAssignments"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ListIncidentRoleAssignmentsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_incident_role_assignments"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="incident_role_assignments",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def request_incident_role_handover(
+        self,
+        name,
+        new_assignee,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.role_assignment_path('[PROJECT]', '[INCIDENT]', '[ROLE_ASSIGNMENT]')
+            >>>
+            >>> # TODO: Initialize `new_assignee`:
+            >>> new_assignee = {}
+            >>>
+            >>> response = client.request_incident_role_handover(name, new_assignee)
+
+        Args:
+            name (str): Resource name of the role assignment.
+            new_assignee (Union[dict, ~google.cloud.irm_v1alpha2.types.User]): The proposed assignee.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.User`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "request_incident_role_handover" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "request_incident_role_handover"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.request_incident_role_handover,
+                default_retry=self._method_configs["RequestIncidentRoleHandover"].retry,
+                default_timeout=self._method_configs[
+                    "RequestIncidentRoleHandover"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.RequestIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["request_incident_role_handover"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def confirm_incident_role_handover(
+        self,
+        name,
+        new_assignee,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.role_assignment_path('[PROJECT]', '[INCIDENT]', '[ROLE_ASSIGNMENT]')
+            >>>
+            >>> # TODO: Initialize `new_assignee`:
+            >>> new_assignee = {}
+            >>>
+            >>> response = client.confirm_incident_role_handover(name, new_assignee)
+
+        Args:
+            name (str): Resource name of the role assignment.
+            new_assignee (Union[dict, ~google.cloud.irm_v1alpha2.types.User]): The proposed assignee, who will now be the assignee. This should be the
+                current user; otherwise ForceRoleHandover should be called.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.User`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "confirm_incident_role_handover" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "confirm_incident_role_handover"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.confirm_incident_role_handover,
+                default_retry=self._method_configs["ConfirmIncidentRoleHandover"].retry,
+                default_timeout=self._method_configs[
+                    "ConfirmIncidentRoleHandover"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ConfirmIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["confirm_incident_role_handover"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def force_incident_role_handover(
+        self,
+        name,
+        new_assignee,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.role_assignment_path('[PROJECT]', '[INCIDENT]', '[ROLE_ASSIGNMENT]')
+            >>>
+            >>> # TODO: Initialize `new_assignee`:
+            >>> new_assignee = {}
+            >>>
+            >>> response = client.force_incident_role_handover(name, new_assignee)
+
+        Args:
+            name (str): Resource name of the role assignment.
+            new_assignee (Union[dict, ~google.cloud.irm_v1alpha2.types.User]): The proposed assignee, who will now be the assignee. This should not be
+                the current user; otherwise ConfirmRoleHandover should be called.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.User`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "force_incident_role_handover" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "force_incident_role_handover"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.force_incident_role_handover,
+                default_retry=self._method_configs["ForceIncidentRoleHandover"].retry,
+                default_timeout=self._method_configs[
+                    "ForceIncidentRoleHandover"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.ForceIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["force_incident_role_handover"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_incident_role_handover(
+        self,
+        name,
+        new_assignee,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import irm_v1alpha2
+            >>>
+            >>> client = irm_v1alpha2.IncidentServiceClient()
+            >>>
+            >>> name = client.role_assignment_path('[PROJECT]', '[INCIDENT]', '[ROLE_ASSIGNMENT]')
+            >>>
+            >>> # TODO: Initialize `new_assignee`:
+            >>> new_assignee = {}
+            >>>
+            >>> response = client.cancel_incident_role_handover(name, new_assignee)
+
+        Args:
+            name (str): Resource name of the role assignment.
+            new_assignee (Union[dict, ~google.cloud.irm_v1alpha2.types.User]): Person who was proposed as the next assignee (i.e.
+                IncidentRoleAssignment.proposed_assignee) and whose proposal is being
+                cancelled.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.irm_v1alpha2.types.User`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.irm_v1alpha2.types.IncidentRoleAssignment` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_incident_role_handover" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_incident_role_handover"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_incident_role_handover,
+                default_retry=self._method_configs["CancelIncidentRoleHandover"].retry,
+                default_timeout=self._method_configs[
+                    "CancelIncidentRoleHandover"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = incidents_service_pb2.CancelIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["cancel_incident_role_handover"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/incident_service_client_config.py b/irm/google/cloud/irm_v1alpha2/gapic/incident_service_client_config.py
new file mode 100644
index 000000000000..caca49e66519
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/gapic/incident_service_client_config.py
@@ -0,0 +1,183 @@
+config = {
+    "interfaces": {
+        "google.cloud.irm.v1alpha2.IncidentService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateIncident": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIncident": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchIncidents": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateIncident": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchSimilarIncidents": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateAnnotation": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListAnnotations": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTag": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTag": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTags": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateSignal": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchSignals": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSignal": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "LookupSignal": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSignal": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "EscalateIncident": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateArtifact": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListArtifacts": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateArtifact": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteArtifact": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SendShiftHandoff": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListSubscriptions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateIncidentRoleAssignment": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteIncidentRoleAssignment": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListIncidentRoleAssignments": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RequestIncidentRoleHandover": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ConfirmIncidentRoleHandover": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ForceIncidentRoleHandover": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelIncidentRoleHandover": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/synth.metadata b/irm/google/cloud/irm_v1alpha2/gapic/synth.metadata
new file mode 100644
index 000000000000..03d6ff6ece2d
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/gapic/synth.metadata
@@ -0,0 +1,3 @@
+{
+  "updateTime": "2019-02-04T22:36:50.878197Z"
+}
\ No newline at end of file
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/transports/__init__.py b/irm/google/cloud/irm_v1alpha2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/irm/google/cloud/irm_v1alpha2/gapic/transports/incident_service_grpc_transport.py b/irm/google/cloud/irm_v1alpha2/gapic/transports/incident_service_grpc_transport.py
new file mode 100644
index 000000000000..b2cbbf1869f2
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/gapic/transports/incident_service_grpc_transport.py
@@ -0,0 +1,550 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.irm_v1alpha2.proto import incidents_service_pb2_grpc
+
+
+class IncidentServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.irm.v1alpha2 IncidentService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="irm.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "incident_service_stub": incidents_service_pb2_grpc.IncidentServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="irm.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_incident(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_incident`.
+
+        Creates a new incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateIncident
+
+    @property
+    def get_incident(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.get_incident`.
+
+        Returns an incident by name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].GetIncident
+
+    @property
+    def search_incidents(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.search_incidents`.
+
+        Returns a list of incidents.
+        Incidents are ordered by start time, with the most recent incidents first.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].SearchIncidents
+
+    @property
+    def update_incident(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.update_incident`.
+
+        Updates an existing incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].UpdateIncident
+
+    @property
+    def search_similar_incidents(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.search_similar_incidents`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].SearchSimilarIncidents
+
+    @property
+    def create_annotation(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_annotation`.
+
+        Creates an annotation on an existing incident. Only 'text/plain' and
+        'text/markdown' annotations can be created via this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateAnnotation
+
+    @property
+    def list_annotations(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.list_annotations`.
+
+        Lists annotations that are part of an incident. No assumptions should be
+        made on the content-type of the annotation returned.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ListAnnotations
+
+    @property
+    def create_tag(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_tag`.
+
+        Creates a tag on an existing incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateTag
+
+    @property
+    def delete_tag(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.delete_tag`.
+
+        Deletes an existing tag.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].DeleteTag
+
+    @property
+    def list_tags(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.list_tags`.
+
+        Lists tags that are part of an incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ListTags
+
+    @property
+    def create_signal(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_signal`.
+
+        Creates a new signal.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateSignal
+
+    @property
+    def search_signals(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.search_signals`.
+
+        Lists signals that are part of an incident.
+        Signals are returned in reverse chronological order.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].SearchSignals
+
+    @property
+    def get_signal(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.get_signal`.
+
+        Returns a signal by name.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].GetSignal
+
+    @property
+    def lookup_signal(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.lookup_signal`.
+
+        Finds a signal by other unique IDs.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].LookupSignal
+
+    @property
+    def update_signal(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.update_signal`.
+
+        Updates an existing signal (for example, to assign/unassign it to an
+        incident).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].UpdateSignal
+
+    @property
+    def escalate_incident(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.escalate_incident`.
+
+        Escalates an incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].EscalateIncident
+
+    @property
+    def create_artifact(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_artifact`.
+
+        Creates a new artifact.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateArtifact
+
+    @property
+    def list_artifacts(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.list_artifacts`.
+
+        Returns a list of artifacts for an incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ListArtifacts
+
+    @property
+    def update_artifact(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.update_artifact`.
+
+        Updates an existing artifact.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].UpdateArtifact
+
+    @property
+    def delete_artifact(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.delete_artifact`.
+
+        Deletes an existing artifact.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].DeleteArtifact
+
+    @property
+    def send_shift_handoff(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.send_shift_handoff`.
+
+        Sends a summary of the shift for oncall handoff.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].SendShiftHandoff
+
+    @property
+    def create_subscription(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_subscription`.
+
+        Creates a new subscription.
+        This will fail if:
+           a. there are too many (50) subscriptions in the incident already
+           b. a subscription using the given channel already exists
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateSubscription
+
+    @property
+    def update_subscription(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.update_subscription`.
+
+        Updates a subscription.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].UpdateSubscription
+
+    @property
+    def list_subscriptions(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.list_subscriptions`.
+
+        Returns a list of subscriptions for an incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ListSubscriptions
+
+    @property
+    def delete_subscription(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.delete_subscription`.
+
+        Deletes an existing subscription.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].DeleteSubscription
+
+    @property
+    def create_incident_role_assignment(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.create_incident_role_assignment`.
+
+        Creates a role assignment on an existing incident. Normally, the user field
+        will be set when assigning a role to oneself, and the next field will be
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CreateIncidentRoleAssignment
+
+    @property
+    def delete_incident_role_assignment(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.delete_incident_role_assignment`.
+
+        Deletes an existing role assignment.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].DeleteIncidentRoleAssignment
+
+    @property
+    def list_incident_role_assignments(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.list_incident_role_assignments`.
+
+        Lists role assignments that are part of an incident.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ListIncidentRoleAssignments
+
+    @property
+    def request_incident_role_handover(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.request_incident_role_handover`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].RequestIncidentRoleHandover
+
+    @property
+    def confirm_incident_role_handover(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.confirm_incident_role_handover`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ConfirmIncidentRoleHandover
+
+    @property
+    def force_incident_role_handover(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.force_incident_role_handover`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].ForceIncidentRoleHandover
+
+    @property
+    def cancel_incident_role_handover(self):
+        """Return the gRPC stub for :meth:`IncidentServiceClient.cancel_incident_role_handover`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["incident_service_stub"].CancelIncidentRoleHandover
diff --git a/irm/google/cloud/irm_v1alpha2/proto/__init__.py b/irm/google/cloud/irm_v1alpha2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/irm/google/cloud/irm_v1alpha2/proto/incidents.proto b/irm/google/cloud/irm_v1alpha2/proto/incidents.proto
new file mode 100644
index 000000000000..78972ae0302d
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/proto/incidents.proto
@@ -0,0 +1,491 @@
+// 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.irm.v1alpha2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/irm/v1alpha2;irm";
+option java_multiple_files = true;
+option java_package = "com.google.irm.service.v1alpha2.api";
+
+// A user of the IRM app.
+message User {
+  // One of several ways to uniquely identify a user.
+  oneof user {
+    // Output only. User id that will allow to get additional information from
+    // People API. This field will be populated implicitly if the caller creates
+    // or edits a resource (for example, posts an annotation).
+    string user_id = 1;
+
+    // Email address of the user. This must be associated with a Google account.
+    // This field will be set if the user is explicitly identified (verbatim) by
+    // email address in an API request (potentially sometime in the past). It
+    // will not be populated based on the credentials of a caller of the API.
+    string email = 2;
+  }
+}
+
+// A signal is a message calling attention to a (potential) incident. An example
+// is a page based on a Stackdriver Alerting policy.
+message Signal {
+  // An artifact associated with the Signal.
+  message SignalArtifact {
+    // The type of resource linked to
+    oneof artifact_type {
+      // A custom user type
+      string user_type = 2;
+    }
+
+    // The URI for the artifact.
+    string uri = 3;
+  }
+
+  // Describes whether the alerting condition is still firing.
+  enum State {
+    // Unspecified
+    STATE_UNSPECIFIED = 0;
+
+    // Firing
+    STATE_OPEN = 1;
+
+    // Non-firing
+    STATE_CLOSED = 2;
+  }
+
+  // Resource name of the signal, for example,
+  // "projects/{project_id}/signals/{signal_id}".
+  string name = 1;
+
+  // Etag to validate the object is unchanged for a read-modify-write operation.
+  // An empty etag will overwrite other changes.
+  string etag = 2;
+
+  // Resource name of the incident this signal is currently assigned to.
+  // May be empty if signal is unassigned.
+  string incident = 3;
+
+  // Output only. Time this signal was created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. Time this signal was closed. This field is not populated
+  // while the signal is still firing.
+  google.protobuf.Timestamp close_time = 10;
+
+  // The time this Signal was first detected. This is identical to create_time
+  // for Signals created by Stackdriver Alerting.
+  google.protobuf.Timestamp detect_time = 15;
+
+  // Output only. The user that created this signal for manually created
+  // signals. Empty if this signal was generated by a system (for example,
+  // Stackdriver Alerting).
+  User creator = 5;
+
+  // One-line summary of the signal.
+  // Immutable.
+  string title = 6;
+
+  // Content type string. 'text/plain' is currently the only supported content
+  // type for Signals created via the API. Signals created by Stackdriver
+  // Alerting support 'text/html' as well. Immutable for Signals created by
+  // Stackdriver Alerting.
+  string content_type = 7;
+
+  // Full message of the signal.
+  // Immutable for Signals created by Stackdriver Alerting.
+  string content = 8;
+
+  // The state of this signal.
+  // For Signals created by Stackdriver Alerting this field is output only.
+  State signal_state = 9;
+
+  // A set of artifacts to additional resources for this Signal. For example, a
+  // link to Stackdriver logging for the Signal.
+  // Immutable for Signals created by Stackdriver Alerting.
+  repeated SignalArtifact signal_artifacts = 16;
+}
+
+// A text annotation by a user.
+message Annotation {
+  // Resource name of the annotation, for example,
+  // "projects/{project_id}/incidents/{incident_id}/annotations/{annotation_id}".
+  string name = 1;
+
+  // Output only. Author of the annotation.
+  User author = 2;
+
+  // Output only. Time the annotation was created.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Content of the annotation. Immutable.
+  string content = 4;
+
+  // Content type of the annotation, for example, 'text/plain'
+  // or 'text/markdown'. Immutable.
+  string content_type = 5;
+}
+
+// A tag by a user.
+message Tag {
+  // Resource name of a tag, for example,
+  // "projects/{project_id}/incidents/{incident_id}/tags/{tag_id}"
+  string name = 1;
+
+  // Display name of the resource (for example, "cause:rollout"). Immutable.
+  string display_name = 2;
+}
+
+// Synopsis is a summary of an incident and it contains a textual content,
+// an author and a last updated timestamp.
+message Synopsis {
+  // Content type string, for example, 'text/plain' or 'text/markdown'.
+  string content_type = 1;
+
+  // Textual content of the synopsis. It can be plain text or markdown as
+  // indicated by the content_type.
+  string content = 2;
+
+  // Last updated timestamp.
+  google.protobuf.Timestamp update_time = 3;
+
+  // Author of the synopsis.
+  User author = 4;
+}
+
+// Representation of an incident.
+message Incident {
+  // CommunicationVenue is a record of where conversations about an incident
+  // are happening.
+  message CommunicationVenue {
+    // The type of channel/venue for incident communications.
+    enum ChannelType {
+      // An unspecified communication channel.
+      CHANNEL_TYPE_UNSPECIFIED = 0;
+
+      // A communication channel that is represented by a generic URI.
+      CHANNEL_TYPE_URI = 1;
+
+      // A communication channel that represents a Slack channel.
+      CHANNEL_TYPE_SLACK = 5;
+    }
+
+    // A URI to the web interface of the channel.
+    string uri = 1;
+
+    // A name representing the channel in IRM UI.
+    string display_name = 2;
+
+    // The type of channel/venue for incident communications.
+    ChannelType channel_type = 3;
+  }
+
+  // Specifies the escalation level of this incident, within the IRM protocol
+  // for handling incidents.
+  enum EscalationLevel {
+    // The incident has not been escalated. This is the value used by all new
+    // and legacy incidents.
+    ESCALATION_LEVEL_UNSPECIFIED = 0;
+
+    // The incident has been escalated to the organizational level.
+    ESCALATION_LEVEL_ORGANIZATION = 1;
+  }
+
+  // Severity of an incident.
+  enum Severity {
+    // Severity is not specified.
+    SEVERITY_UNSPECIFIED = 0;
+
+    // Huge incident.
+    SEVERITY_HUGE = 1;
+
+    // Major incident.
+    SEVERITY_MAJOR = 2;
+
+    // Medium incident.
+    SEVERITY_MEDIUM = 3;
+
+    // Minor incident.
+    SEVERITY_MINOR = 4;
+
+    // Negligible incident.
+    SEVERITY_NEGLIGIBLE = 5;
+  }
+
+  // Stage of an incident.
+  enum Stage {
+    // This is the default value if no stage has been specified.
+    // Note: The caller of the API should set the stage to DETECTED.
+    STAGE_UNSPECIFIED = 0;
+
+    // The incident has been detected. This is the initial stage of a new
+    // incident.
+    // Note: The caller still has to set the stage manually.
+    STAGE_DETECTED = 4;
+
+    // This incident has been formally characterized.
+    STAGE_TRIAGED = 1;
+
+    // This incident has been mitigated, i.e. does not affect the service level
+    // anymore.
+    STAGE_MITIGATED = 2;
+
+    // This incident has been fully resolved, i.e. there are no immediate
+    // follow-up tasks.
+    STAGE_RESOLVED = 3;
+
+    // Postmortem for the incident was written.
+    STAGE_DOCUMENTED = 5;
+
+    // Stage for an incident with `duplicate_incident`. This incident is not
+    // authoritative anymore and the `duplicate_incident` should be used to
+    // determine the stage.
+    STAGE_DUPLICATE = 6;
+  }
+
+  // Output only. Resource name of the incident, for example,
+  // "projects/{project_id}/incidents/{incident_id}".
+  string name = 1;
+
+  // One-line summary of the incident.
+  string title = 2;
+
+  // Escalation level of the incident.
+  EscalationLevel escalation_level = 3;
+
+  // Etag to validate the object is unchanged for a read-modify-write operation.
+  // An empty etag will overwrite other changes.
+  string etag = 4;
+
+  // Severity of the incident.
+  Severity severity = 5;
+
+  // Stage of the incident.
+  Stage stage = 6;
+
+  // Resource name of the incident this incident is a duplicate of. Empty if
+  // this incident is not a duplicate.
+  // An incident can only be a duplicate of an incident that is not marked as a
+  // duplicate already. Setting this to a non-empty value must also set the
+  // stage to `STAGE_DUPLICATE`. Unsetting this value value must also update
+  // `stage` to a value other than `STAGE_DUPLICATE`.
+  string duplicate_incident = 9;
+
+  // Output only. Time this incident started. Used to measure the 'elapsed
+  // time'. Start time of an incident is the earliest creation time of any of
+  // its Signals or the create time of the incident if no Signals are assigned.
+  google.protobuf.Timestamp start_time = 7;
+
+  // Output only. Synopsis of this incident.
+  Synopsis synopsis = 8;
+
+  // Location of communications for this incident. This is informational
+  // only; IRM does not use this to send messages.
+  CommunicationVenue communication_venue = 10;
+}
+
+// Describes a role that can be assigned to an incident.
+message IncidentRole {
+  // List of possible roles.
+  enum Type {
+    // The role is unspecified.
+    TYPE_UNSPECIFIED = 0;
+
+    // Incident Commander: Manages response plan, near-term and long-term
+    // objectives, establishes priorities, and delegates tasks as needed.
+    TYPE_INCIDENT_COMMANDER = 1;
+
+    // Communications Lead: Keeps everybody outside and within the response team
+    // informed.
+    TYPE_COMMUNICATIONS_LEAD = 2;
+
+    // Operations Lead: Figures out what to do, and gets it done.
+    TYPE_OPERATIONS_LEAD = 3;
+
+    // External Customer Communications Lead: Responsible for communicating
+    // incident details to customers/public.
+    TYPE_EXTERNAL_CUSTOMER_COMMUNICATIONS_LEAD = 4;
+
+    // Primary Oncall: Responds to the initial page and handles all
+    // responsibilities for pre-escalated incidents.
+    TYPE_PRIMARY_ONCALL = 5;
+
+    // Secondary Oncall: Helps the primary oncall if necessary; mostly useful
+    // for pre-escalated incidents.
+    TYPE_SECONDARY_ONCALL = 6;
+
+    // User-specified roles. One example is a Planning Lead, who keeps track of
+    // the incident. Another is an assistant Incident Commander.
+    TYPE_OTHER = 7;
+  }
+
+  // The type of role. The role type is immutable in role assignments. Each role
+  // 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.
+  string title = 2;
+
+  // Output only 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 {
+  // Output only. Resource name such as
+  // "projects/{project_id}/incidents/{incident_id}/role_assignments/{role_id}".
+  string name = 1;
+
+  // Output only. Etag for this version of the resource. Must be specified in
+  // update requests and match the current version in storage. Must not be
+  // modified by the client.
+  string etag = 2;
+
+  // The role that is or will be assigned.
+  IncidentRole role = 3;
+
+  // The user this role is assigned to. This field can only be directly set
+  // during creation request. Subsequent updates are done via the
+  // IncidentRoleHandover methods.
+  User assignee = 4;
+
+  // The recipient of a requested role handoff. This field can only be directly
+  // set during creation request. Subsequent updates are done via the
+  // IncidentRoleHandover methods.
+  //
+  // `assignee` is always the current role-holder, and `proposed_assignee` is
+  // used to track unfinished assignments and handoffs. Let's say Bob assigns
+  // Alice to a role. Then the fields are:
+  //   `assignee`: nil, `proposed_assignee`: Alice
+  // If Alice accepts, then the fields are:
+  //   `assignee`: Alice, `proposed_assignee`: nil
+  // If she cancels, then the RoleAssignment is deleted.
+  // Let's say Alice has the role. Then the fields are:
+  //   `assignee`: Alice, `proposed_assignee`: nil
+  // If Alice becomes incapacitated and Bob requests Carol to take over, then
+  // the fields are:
+  //   `assignee`: Alice, `proposed_assignee`: Carol
+  // After Carol accepts the handover, the fields are:
+  //   `assignee`: Carol, `proposed_assignee`: nil
+  // Or if Carol refuses the handover, the fields are:
+  //   `assignee`: Alice, `proposed_assignee`: nil
+  User proposed_assignee = 5;
+}
+
+// External artifact associated to an incident.
+message Artifact {
+  // Possible types of an artifact.
+  enum Type {
+    // External type is unspecified.
+    TYPE_UNSPECIFIED = 0;
+
+    // URL.
+    TYPE_URL = 1;
+
+    // A JIRA issue.
+    TYPE_JIRA_ISSUE = 4;
+  }
+
+  // Output only. Resource name such as
+  // "projects/{project_id}/incidents/{incident_id}/artifacts/{artifact_id}".
+  string name = 1;
+
+  // User provided name of an artifact.
+  string display_name = 2;
+
+  // Output only. Etag for this version of the resource. Must be specified in
+  // update requests and match the current version in storage. Must not be
+  // modified by the client.
+  string etag = 3;
+
+  // URL to access the artifact.
+  string url = 4;
+
+  // Type of this artifact.
+  Type type = 5;
+}
+
+// Communication Channels are mechanisms used to receive notifications
+// about changes to incidents.
+message CommunicationChannel {
+  // A communication channel that delivers messages to an email address.
+  message Email {
+    // The email address, for example, "user@example.com".
+    string address = 1;
+  }
+
+  // A communication channel that delivers messages to a Stackdriver
+  // notification channel.
+  message NotificationChannel {
+    // Stackdriver notification channel name.
+    string name = 1;
+  }
+
+  // An endpoint describes how messages will be delivered.
+  oneof endpoint {
+    // Messages will be delivered via email.
+    Email email = 1;
+
+    // Messages will be delivered via a Stackdriver notification channel.
+    NotificationChannel notification_channel = 2;
+  }
+}
+
+// A subscription allows users to get notifications about changes to
+// an incident.
+message Subscription {
+  // Types of changes that users can subscribe to in an incident.
+  enum EventType {
+    // An event_type that's not specified is an error.
+    EVENT_TYPE_UNSPECIFIED = 0;
+
+    // The incident's title has changed.
+    EVENT_TYPE_TITLE_CHANGE = 1;
+
+    // The incident's synopsis has changed.
+    EVENT_TYPE_SYNOPSIS_CHANGE = 2;
+
+    // The incident's stage has changed.
+    EVENT_TYPE_STAGE_CHANGE = 3;
+
+    // The incident's severity has changed.
+    EVENT_TYPE_SEVERITY_CHANGE = 4;
+
+    // A new annotation has been added to the incident.
+    EVENT_TYPE_ANNOTATION_ADD = 5;
+
+    // An annotation has been modified.
+    EVENT_TYPE_ANNOTATION_CHANGE = 6;
+  }
+
+  // Output only. Resource name such as
+  // "projects/{project_id}/incidents/{incident_id}/subscriptions/{subscription_id}".
+  string name = 1;
+
+  // Output only. Etag for this version of the resource. Must be specified in
+  // update requests and match the current version in storage. Must not be
+  // modified by the client.
+  string etag = 2;
+
+  // A communications channel to send subscription messages to.
+  CommunicationChannel subscription_channel = 3;
+
+  // Types of events this subscription receives notifications for.
+  repeated EventType event_types = 4;
+}
diff --git a/irm/google/cloud/irm_v1alpha2/proto/incidents_pb2.py b/irm/google/cloud/irm_v1alpha2/proto/incidents_pb2.py
new file mode 100644
index 000000000000..e99a1c95fac2
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/proto/incidents_pb2.py
@@ -0,0 +1,2357 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/irm_v1alpha2/proto/incidents.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/irm_v1alpha2/proto/incidents.proto",
+    package="google.cloud.irm.v1alpha2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n#com.google.irm.service.v1alpha2.apiP\001Z<google.golang.org/genproto/googleapis/cloud/irm/v1alpha2;irm\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/irm_v1alpha2/proto/incidents.proto\x12\x19google.cloud.irm.v1alpha2\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"2\n\x04User\x12\x11\n\x07user_id\x18\x01 \x01(\tH\x00\x12\x0f\n\x05\x65mail\x18\x02 \x01(\tH\x00\x42\x06\n\x04user"\xc2\x04\n\x06Signal\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x65tag\x18\x02 \x01(\t\x12\x10\n\x08incident\x18\x03 \x01(\t\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nclose_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x64\x65tect_time\x18\x0f \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x07\x63reator\x18\x05 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User\x12\r\n\x05title\x18\x06 \x01(\t\x12\x14\n\x0c\x63ontent_type\x18\x07 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x08 \x01(\t\x12=\n\x0csignal_state\x18\t \x01(\x0e\x32\'.google.cloud.irm.v1alpha2.Signal.State\x12J\n\x10signal_artifacts\x18\x10 \x03(\x0b\x32\x30.google.cloud.irm.v1alpha2.Signal.SignalArtifact\x1a\x43\n\x0eSignalArtifact\x12\x13\n\tuser_type\x18\x02 \x01(\tH\x00\x12\x0b\n\x03uri\x18\x03 \x01(\tB\x0f\n\rartifact_type"@\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0e\n\nSTATE_OPEN\x10\x01\x12\x10\n\x0cSTATE_CLOSED\x10\x02"\xa3\x01\n\nAnnotation\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x06\x61uthor\x18\x02 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0f\n\x07\x63ontent\x18\x04 \x01(\t\x12\x14\n\x0c\x63ontent_type\x18\x05 \x01(\t")\n\x03Tag\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t"\x93\x01\n\x08Synopsis\x12\x14\n\x0c\x63ontent_type\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12/\n\x0bupdate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x06\x61uthor\x18\x04 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User"\xc9\x08\n\x08Incident\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12M\n\x10\x65scalation_level\x18\x03 \x01(\x0e\x32\x33.google.cloud.irm.v1alpha2.Incident.EscalationLevel\x12\x0c\n\x04\x65tag\x18\x04 \x01(\t\x12>\n\x08severity\x18\x05 \x01(\x0e\x32,.google.cloud.irm.v1alpha2.Incident.Severity\x12\x38\n\x05stage\x18\x06 \x01(\x0e\x32).google.cloud.irm.v1alpha2.Incident.Stage\x12\x1a\n\x12\x64uplicate_incident\x18\t \x01(\t\x12.\n\nstart_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x08synopsis\x18\x08 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Synopsis\x12S\n\x13\x63ommunication_venue\x18\n \x01(\x0b\x32\x36.google.cloud.irm.v1alpha2.Incident.CommunicationVenue\x1a\xec\x01\n\x12\x43ommunicationVenue\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12X\n\x0c\x63hannel_type\x18\x03 \x01(\x0e\x32\x42.google.cloud.irm.v1alpha2.Incident.CommunicationVenue.ChannelType"Y\n\x0b\x43hannelType\x12\x1c\n\x18\x43HANNEL_TYPE_UNSPECIFIED\x10\x00\x12\x14\n\x10\x43HANNEL_TYPE_URI\x10\x01\x12\x16\n\x12\x43HANNEL_TYPE_SLACK\x10\x05"V\n\x0f\x45scalationLevel\x12 \n\x1c\x45SCALATION_LEVEL_UNSPECIFIED\x10\x00\x12!\n\x1d\x45SCALATION_LEVEL_ORGANIZATION\x10\x01"\x8d\x01\n\x08Severity\x12\x18\n\x14SEVERITY_UNSPECIFIED\x10\x00\x12\x11\n\rSEVERITY_HUGE\x10\x01\x12\x12\n\x0eSEVERITY_MAJOR\x10\x02\x12\x13\n\x0fSEVERITY_MEDIUM\x10\x03\x12\x12\n\x0eSEVERITY_MINOR\x10\x04\x12\x17\n\x13SEVERITY_NEGLIGIBLE\x10\x05"\x99\x01\n\x05Stage\x12\x15\n\x11STAGE_UNSPECIFIED\x10\x00\x12\x12\n\x0eSTAGE_DETECTED\x10\x04\x12\x11\n\rSTAGE_TRIAGED\x10\x01\x12\x13\n\x0fSTAGE_MITIGATED\x10\x02\x12\x12\n\x0eSTAGE_RESOLVED\x10\x03\x12\x14\n\x10STAGE_DOCUMENTED\x10\x05\x12\x13\n\x0fSTAGE_DUPLICATE\x10\x06"\xd6\x02\n\x0cIncidentRole\x12:\n\x04type\x18\x01 \x01(\x0e\x32,.google.cloud.irm.v1alpha2.IncidentRole.Type\x12\r\n\x05title\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t"\xe5\x01\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x1b\n\x17TYPE_INCIDENT_COMMANDER\x10\x01\x12\x1c\n\x18TYPE_COMMUNICATIONS_LEAD\x10\x02\x12\x18\n\x14TYPE_OPERATIONS_LEAD\x10\x03\x12.\n*TYPE_EXTERNAL_CUSTOMER_COMMUNICATIONS_LEAD\x10\x04\x12\x17\n\x13TYPE_PRIMARY_ONCALL\x10\x05\x12\x19\n\x15TYPE_SECONDARY_ONCALL\x10\x06\x12\x0e\n\nTYPE_OTHER\x10\x07"\xda\x01\n\x16IncidentRoleAssignment\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x65tag\x18\x02 \x01(\t\x12\x35\n\x04role\x18\x03 \x01(\x0b\x32\'.google.cloud.irm.v1alpha2.IncidentRole\x12\x31\n\x08\x61ssignee\x18\x04 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User\x12:\n\x11proposed_assignee\x18\x05 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User"\xc2\x01\n\x08\x41rtifact\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x0c\n\x04\x65tag\x18\x03 \x01(\t\x12\x0b\n\x03url\x18\x04 \x01(\t\x12\x36\n\x04type\x18\x05 \x01(\x0e\x32(.google.cloud.irm.v1alpha2.Artifact.Type"?\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08TYPE_URL\x10\x01\x12\x13\n\x0fTYPE_JIRA_ISSUE\x10\x04"\x8e\x02\n\x14\x43ommunicationChannel\x12\x46\n\x05\x65mail\x18\x01 \x01(\x0b\x32\x35.google.cloud.irm.v1alpha2.CommunicationChannel.EmailH\x00\x12\x63\n\x14notification_channel\x18\x02 \x01(\x0b\x32\x43.google.cloud.irm.v1alpha2.CommunicationChannel.NotificationChannelH\x00\x1a\x18\n\x05\x45mail\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x1a#\n\x13NotificationChannel\x12\x0c\n\x04name\x18\x01 \x01(\tB\n\n\x08\x65ndpoint"\xa6\x03\n\x0cSubscription\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x65tag\x18\x02 \x01(\t\x12M\n\x14subscription_channel\x18\x03 \x01(\x0b\x32/.google.cloud.irm.v1alpha2.CommunicationChannel\x12\x46\n\x0b\x65vent_types\x18\x04 \x03(\x0e\x32\x31.google.cloud.irm.v1alpha2.Subscription.EventType"\xe2\x01\n\tEventType\x12\x1a\n\x16\x45VENT_TYPE_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x45VENT_TYPE_TITLE_CHANGE\x10\x01\x12\x1e\n\x1a\x45VENT_TYPE_SYNOPSIS_CHANGE\x10\x02\x12\x1b\n\x17\x45VENT_TYPE_STAGE_CHANGE\x10\x03\x12\x1e\n\x1a\x45VENT_TYPE_SEVERITY_CHANGE\x10\x04\x12\x1d\n\x19\x45VENT_TYPE_ANNOTATION_ADD\x10\x05\x12 \n\x1c\x45VENT_TYPE_ANNOTATION_CHANGE\x10\x06\x42h\n#com.google.irm.service.v1alpha2.apiP\x01Z<google.golang.org/genproto/googleapis/cloud/irm/v1alpha2;irm\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_SIGNAL_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.irm.v1alpha2.Signal.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STATE_OPEN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STATE_CLOSED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=708,
+    serialized_end=772,
+)
+_sym_db.RegisterEnumDescriptor(_SIGNAL_STATE)
+
+_INCIDENT_COMMUNICATIONVENUE_CHANNELTYPE = _descriptor.EnumDescriptor(
+    name="ChannelType",
+    full_name="google.cloud.irm.v1alpha2.Incident.CommunicationVenue.ChannelType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CHANNEL_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHANNEL_TYPE_URI",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHANNEL_TYPE_SLACK",
+            index=2,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1754,
+    serialized_end=1843,
+)
+_sym_db.RegisterEnumDescriptor(_INCIDENT_COMMUNICATIONVENUE_CHANNELTYPE)
+
+_INCIDENT_ESCALATIONLEVEL = _descriptor.EnumDescriptor(
+    name="EscalationLevel",
+    full_name="google.cloud.irm.v1alpha2.Incident.EscalationLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ESCALATION_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ESCALATION_LEVEL_ORGANIZATION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1845,
+    serialized_end=1931,
+)
+_sym_db.RegisterEnumDescriptor(_INCIDENT_ESCALATIONLEVEL)
+
+_INCIDENT_SEVERITY = _descriptor.EnumDescriptor(
+    name="Severity",
+    full_name="google.cloud.irm.v1alpha2.Incident.Severity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_HUGE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_MAJOR", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_MEDIUM",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_MINOR", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEVERITY_NEGLIGIBLE",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1934,
+    serialized_end=2075,
+)
+_sym_db.RegisterEnumDescriptor(_INCIDENT_SEVERITY)
+
+_INCIDENT_STAGE = _descriptor.EnumDescriptor(
+    name="Stage",
+    full_name="google.cloud.irm.v1alpha2.Incident.Stage",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_DETECTED", index=1, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_TRIAGED", index=2, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_MITIGATED",
+            index=3,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_RESOLVED", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_DOCUMENTED",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STAGE_DUPLICATE",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2078,
+    serialized_end=2231,
+)
+_sym_db.RegisterEnumDescriptor(_INCIDENT_STAGE)
+
+_INCIDENTROLE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.irm.v1alpha2.IncidentRole.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_INCIDENT_COMMANDER",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_COMMUNICATIONS_LEAD",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_OPERATIONS_LEAD",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_EXTERNAL_CUSTOMER_COMMUNICATIONS_LEAD",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_PRIMARY_ONCALL",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_SECONDARY_ONCALL",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_OTHER", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2347,
+    serialized_end=2576,
+)
+_sym_db.RegisterEnumDescriptor(_INCIDENTROLE_TYPE)
+
+_ARTIFACT_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.irm.v1alpha2.Artifact.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_URL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_JIRA_ISSUE",
+            index=2,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2931,
+    serialized_end=2994,
+)
+_sym_db.RegisterEnumDescriptor(_ARTIFACT_TYPE)
+
+_SUBSCRIPTION_EVENTTYPE = _descriptor.EnumDescriptor(
+    name="EventType",
+    full_name="google.cloud.irm.v1alpha2.Subscription.EventType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_TITLE_CHANGE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_SYNOPSIS_CHANGE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_STAGE_CHANGE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_SEVERITY_CHANGE",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_ANNOTATION_ADD",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT_TYPE_ANNOTATION_CHANGE",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3466,
+    serialized_end=3692,
+)
+_sym_db.RegisterEnumDescriptor(_SUBSCRIPTION_EVENTTYPE)
+
+
+_USER = _descriptor.Descriptor(
+    name="User",
+    full_name="google.cloud.irm.v1alpha2.User",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="user_id",
+            full_name="google.cloud.irm.v1alpha2.User.user_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="email",
+            full_name="google.cloud.irm.v1alpha2.User.email",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="user",
+            full_name="google.cloud.irm.v1alpha2.User.user",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=141,
+    serialized_end=191,
+)
+
+
+_SIGNAL_SIGNALARTIFACT = _descriptor.Descriptor(
+    name="SignalArtifact",
+    full_name="google.cloud.irm.v1alpha2.Signal.SignalArtifact",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="user_type",
+            full_name="google.cloud.irm.v1alpha2.Signal.SignalArtifact.user_type",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.irm.v1alpha2.Signal.SignalArtifact.uri",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="artifact_type",
+            full_name="google.cloud.irm.v1alpha2.Signal.SignalArtifact.artifact_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=639,
+    serialized_end=706,
+)
+
+_SIGNAL = _descriptor.Descriptor(
+    name="Signal",
+    full_name="google.cloud.irm.v1alpha2.Signal",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.Signal.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.irm.v1alpha2.Signal.etag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="incident",
+            full_name="google.cloud.irm.v1alpha2.Signal.incident",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.irm.v1alpha2.Signal.create_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="close_time",
+            full_name="google.cloud.irm.v1alpha2.Signal.close_time",
+            index=4,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detect_time",
+            full_name="google.cloud.irm.v1alpha2.Signal.detect_time",
+            index=5,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="creator",
+            full_name="google.cloud.irm.v1alpha2.Signal.creator",
+            index=6,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="title",
+            full_name="google.cloud.irm.v1alpha2.Signal.title",
+            index=7,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.irm.v1alpha2.Signal.content_type",
+            index=8,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.irm.v1alpha2.Signal.content",
+            index=9,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signal_state",
+            full_name="google.cloud.irm.v1alpha2.Signal.signal_state",
+            index=10,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signal_artifacts",
+            full_name="google.cloud.irm.v1alpha2.Signal.signal_artifacts",
+            index=11,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SIGNAL_SIGNALARTIFACT],
+    enum_types=[_SIGNAL_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=194,
+    serialized_end=772,
+)
+
+
+_ANNOTATION = _descriptor.Descriptor(
+    name="Annotation",
+    full_name="google.cloud.irm.v1alpha2.Annotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.Annotation.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="author",
+            full_name="google.cloud.irm.v1alpha2.Annotation.author",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.irm.v1alpha2.Annotation.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.irm.v1alpha2.Annotation.content",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.irm.v1alpha2.Annotation.content_type",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=775,
+    serialized_end=938,
+)
+
+
+_TAG = _descriptor.Descriptor(
+    name="Tag",
+    full_name="google.cloud.irm.v1alpha2.Tag",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.Tag.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.irm.v1alpha2.Tag.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=940,
+    serialized_end=981,
+)
+
+
+_SYNOPSIS = _descriptor.Descriptor(
+    name="Synopsis",
+    full_name="google.cloud.irm.v1alpha2.Synopsis",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.irm.v1alpha2.Synopsis.content_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.irm.v1alpha2.Synopsis.content",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.irm.v1alpha2.Synopsis.update_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="author",
+            full_name="google.cloud.irm.v1alpha2.Synopsis.author",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=984,
+    serialized_end=1131,
+)
+
+
+_INCIDENT_COMMUNICATIONVENUE = _descriptor.Descriptor(
+    name="CommunicationVenue",
+    full_name="google.cloud.irm.v1alpha2.Incident.CommunicationVenue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.irm.v1alpha2.Incident.CommunicationVenue.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.irm.v1alpha2.Incident.CommunicationVenue.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="channel_type",
+            full_name="google.cloud.irm.v1alpha2.Incident.CommunicationVenue.channel_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_INCIDENT_COMMUNICATIONVENUE_CHANNELTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1607,
+    serialized_end=1843,
+)
+
+_INCIDENT = _descriptor.Descriptor(
+    name="Incident",
+    full_name="google.cloud.irm.v1alpha2.Incident",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.Incident.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="title",
+            full_name="google.cloud.irm.v1alpha2.Incident.title",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="escalation_level",
+            full_name="google.cloud.irm.v1alpha2.Incident.escalation_level",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.irm.v1alpha2.Incident.etag",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="severity",
+            full_name="google.cloud.irm.v1alpha2.Incident.severity",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stage",
+            full_name="google.cloud.irm.v1alpha2.Incident.stage",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duplicate_incident",
+            full_name="google.cloud.irm.v1alpha2.Incident.duplicate_incident",
+            index=6,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.irm.v1alpha2.Incident.start_time",
+            index=7,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="synopsis",
+            full_name="google.cloud.irm.v1alpha2.Incident.synopsis",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="communication_venue",
+            full_name="google.cloud.irm.v1alpha2.Incident.communication_venue",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INCIDENT_COMMUNICATIONVENUE],
+    enum_types=[_INCIDENT_ESCALATIONLEVEL, _INCIDENT_SEVERITY, _INCIDENT_STAGE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1134,
+    serialized_end=2231,
+)
+
+
+_INCIDENTROLE = _descriptor.Descriptor(
+    name="IncidentRole",
+    full_name="google.cloud.irm.v1alpha2.IncidentRole",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.irm.v1alpha2.IncidentRole.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="title",
+            full_name="google.cloud.irm.v1alpha2.IncidentRole.title",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.irm.v1alpha2.IncidentRole.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_INCIDENTROLE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2234,
+    serialized_end=2576,
+)
+
+
+_INCIDENTROLEASSIGNMENT = _descriptor.Descriptor(
+    name="IncidentRoleAssignment",
+    full_name="google.cloud.irm.v1alpha2.IncidentRoleAssignment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.IncidentRoleAssignment.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.irm.v1alpha2.IncidentRoleAssignment.etag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="role",
+            full_name="google.cloud.irm.v1alpha2.IncidentRoleAssignment.role",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="assignee",
+            full_name="google.cloud.irm.v1alpha2.IncidentRoleAssignment.assignee",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="proposed_assignee",
+            full_name="google.cloud.irm.v1alpha2.IncidentRoleAssignment.proposed_assignee",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2579,
+    serialized_end=2797,
+)
+
+
+_ARTIFACT = _descriptor.Descriptor(
+    name="Artifact",
+    full_name="google.cloud.irm.v1alpha2.Artifact",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.Artifact.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.irm.v1alpha2.Artifact.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.irm.v1alpha2.Artifact.etag",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.irm.v1alpha2.Artifact.url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.irm.v1alpha2.Artifact.type",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ARTIFACT_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2800,
+    serialized_end=2994,
+)
+
+
+_COMMUNICATIONCHANNEL_EMAIL = _descriptor.Descriptor(
+    name="Email",
+    full_name="google.cloud.irm.v1alpha2.CommunicationChannel.Email",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="address",
+            full_name="google.cloud.irm.v1alpha2.CommunicationChannel.Email.address",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3194,
+    serialized_end=3218,
+)
+
+_COMMUNICATIONCHANNEL_NOTIFICATIONCHANNEL = _descriptor.Descriptor(
+    name="NotificationChannel",
+    full_name="google.cloud.irm.v1alpha2.CommunicationChannel.NotificationChannel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.CommunicationChannel.NotificationChannel.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3220,
+    serialized_end=3255,
+)
+
+_COMMUNICATIONCHANNEL = _descriptor.Descriptor(
+    name="CommunicationChannel",
+    full_name="google.cloud.irm.v1alpha2.CommunicationChannel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="email",
+            full_name="google.cloud.irm.v1alpha2.CommunicationChannel.email",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notification_channel",
+            full_name="google.cloud.irm.v1alpha2.CommunicationChannel.notification_channel",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _COMMUNICATIONCHANNEL_EMAIL,
+        _COMMUNICATIONCHANNEL_NOTIFICATIONCHANNEL,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="endpoint",
+            full_name="google.cloud.irm.v1alpha2.CommunicationChannel.endpoint",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2997,
+    serialized_end=3267,
+)
+
+
+_SUBSCRIPTION = _descriptor.Descriptor(
+    name="Subscription",
+    full_name="google.cloud.irm.v1alpha2.Subscription",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.Subscription.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="etag",
+            full_name="google.cloud.irm.v1alpha2.Subscription.etag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subscription_channel",
+            full_name="google.cloud.irm.v1alpha2.Subscription.subscription_channel",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_types",
+            full_name="google.cloud.irm.v1alpha2.Subscription.event_types",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SUBSCRIPTION_EVENTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3270,
+    serialized_end=3692,
+)
+
+_USER.oneofs_by_name["user"].fields.append(_USER.fields_by_name["user_id"])
+_USER.fields_by_name["user_id"].containing_oneof = _USER.oneofs_by_name["user"]
+_USER.oneofs_by_name["user"].fields.append(_USER.fields_by_name["email"])
+_USER.fields_by_name["email"].containing_oneof = _USER.oneofs_by_name["user"]
+_SIGNAL_SIGNALARTIFACT.containing_type = _SIGNAL
+_SIGNAL_SIGNALARTIFACT.oneofs_by_name["artifact_type"].fields.append(
+    _SIGNAL_SIGNALARTIFACT.fields_by_name["user_type"]
+)
+_SIGNAL_SIGNALARTIFACT.fields_by_name[
+    "user_type"
+].containing_oneof = _SIGNAL_SIGNALARTIFACT.oneofs_by_name["artifact_type"]
+_SIGNAL.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SIGNAL.fields_by_name[
+    "close_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SIGNAL.fields_by_name[
+    "detect_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SIGNAL.fields_by_name["creator"].message_type = _USER
+_SIGNAL.fields_by_name["signal_state"].enum_type = _SIGNAL_STATE
+_SIGNAL.fields_by_name["signal_artifacts"].message_type = _SIGNAL_SIGNALARTIFACT
+_SIGNAL_STATE.containing_type = _SIGNAL
+_ANNOTATION.fields_by_name["author"].message_type = _USER
+_ANNOTATION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SYNOPSIS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SYNOPSIS.fields_by_name["author"].message_type = _USER
+_INCIDENT_COMMUNICATIONVENUE.fields_by_name[
+    "channel_type"
+].enum_type = _INCIDENT_COMMUNICATIONVENUE_CHANNELTYPE
+_INCIDENT_COMMUNICATIONVENUE.containing_type = _INCIDENT
+_INCIDENT_COMMUNICATIONVENUE_CHANNELTYPE.containing_type = _INCIDENT_COMMUNICATIONVENUE
+_INCIDENT.fields_by_name["escalation_level"].enum_type = _INCIDENT_ESCALATIONLEVEL
+_INCIDENT.fields_by_name["severity"].enum_type = _INCIDENT_SEVERITY
+_INCIDENT.fields_by_name["stage"].enum_type = _INCIDENT_STAGE
+_INCIDENT.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INCIDENT.fields_by_name["synopsis"].message_type = _SYNOPSIS
+_INCIDENT.fields_by_name[
+    "communication_venue"
+].message_type = _INCIDENT_COMMUNICATIONVENUE
+_INCIDENT_ESCALATIONLEVEL.containing_type = _INCIDENT
+_INCIDENT_SEVERITY.containing_type = _INCIDENT
+_INCIDENT_STAGE.containing_type = _INCIDENT
+_INCIDENTROLE.fields_by_name["type"].enum_type = _INCIDENTROLE_TYPE
+_INCIDENTROLE_TYPE.containing_type = _INCIDENTROLE
+_INCIDENTROLEASSIGNMENT.fields_by_name["role"].message_type = _INCIDENTROLE
+_INCIDENTROLEASSIGNMENT.fields_by_name["assignee"].message_type = _USER
+_INCIDENTROLEASSIGNMENT.fields_by_name["proposed_assignee"].message_type = _USER
+_ARTIFACT.fields_by_name["type"].enum_type = _ARTIFACT_TYPE
+_ARTIFACT_TYPE.containing_type = _ARTIFACT
+_COMMUNICATIONCHANNEL_EMAIL.containing_type = _COMMUNICATIONCHANNEL
+_COMMUNICATIONCHANNEL_NOTIFICATIONCHANNEL.containing_type = _COMMUNICATIONCHANNEL
+_COMMUNICATIONCHANNEL.fields_by_name["email"].message_type = _COMMUNICATIONCHANNEL_EMAIL
+_COMMUNICATIONCHANNEL.fields_by_name[
+    "notification_channel"
+].message_type = _COMMUNICATIONCHANNEL_NOTIFICATIONCHANNEL
+_COMMUNICATIONCHANNEL.oneofs_by_name["endpoint"].fields.append(
+    _COMMUNICATIONCHANNEL.fields_by_name["email"]
+)
+_COMMUNICATIONCHANNEL.fields_by_name[
+    "email"
+].containing_oneof = _COMMUNICATIONCHANNEL.oneofs_by_name["endpoint"]
+_COMMUNICATIONCHANNEL.oneofs_by_name["endpoint"].fields.append(
+    _COMMUNICATIONCHANNEL.fields_by_name["notification_channel"]
+)
+_COMMUNICATIONCHANNEL.fields_by_name[
+    "notification_channel"
+].containing_oneof = _COMMUNICATIONCHANNEL.oneofs_by_name["endpoint"]
+_SUBSCRIPTION.fields_by_name[
+    "subscription_channel"
+].message_type = _COMMUNICATIONCHANNEL
+_SUBSCRIPTION.fields_by_name["event_types"].enum_type = _SUBSCRIPTION_EVENTTYPE
+_SUBSCRIPTION_EVENTTYPE.containing_type = _SUBSCRIPTION
+DESCRIPTOR.message_types_by_name["User"] = _USER
+DESCRIPTOR.message_types_by_name["Signal"] = _SIGNAL
+DESCRIPTOR.message_types_by_name["Annotation"] = _ANNOTATION
+DESCRIPTOR.message_types_by_name["Tag"] = _TAG
+DESCRIPTOR.message_types_by_name["Synopsis"] = _SYNOPSIS
+DESCRIPTOR.message_types_by_name["Incident"] = _INCIDENT
+DESCRIPTOR.message_types_by_name["IncidentRole"] = _INCIDENTROLE
+DESCRIPTOR.message_types_by_name["IncidentRoleAssignment"] = _INCIDENTROLEASSIGNMENT
+DESCRIPTOR.message_types_by_name["Artifact"] = _ARTIFACT
+DESCRIPTOR.message_types_by_name["CommunicationChannel"] = _COMMUNICATIONCHANNEL
+DESCRIPTOR.message_types_by_name["Subscription"] = _SUBSCRIPTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+User = _reflection.GeneratedProtocolMessageType(
+    "User",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_USER,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""A user of the IRM app.
+  
+  
+  Attributes:
+      user:
+          One of several ways to uniquely identify a user.
+      user_id:
+          Output only. User id that will allow to get additional
+          information from People API. This field will be populated
+          implicitly if the caller creates or edits a resource (for
+          example, posts an annotation).
+      email:
+          Email address of the user. This must be associated with a
+          Google account. This field will be set if the user is
+          explicitly identified (verbatim) by email address in an API
+          request (potentially sometime in the past). It will not be
+          populated based on the credentials of a caller of the API.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.User)
+    ),
+)
+_sym_db.RegisterMessage(User)
+
+Signal = _reflection.GeneratedProtocolMessageType(
+    "Signal",
+    (_message.Message,),
+    dict(
+        SignalArtifact=_reflection.GeneratedProtocolMessageType(
+            "SignalArtifact",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SIGNAL_SIGNALARTIFACT,
+                __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+                __doc__="""An artifact associated with the Signal.
+    
+    
+    Attributes:
+        artifact_type:
+            The type of resource linked to
+        user_type:
+            A custom user type
+        uri:
+            The URI for the artifact.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Signal.SignalArtifact)
+            ),
+        ),
+        DESCRIPTOR=_SIGNAL,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""A signal is a message calling attention to a (potential) incident. An
+  example is a page based on a Stackdriver Alerting policy.
+  
+  
+  Attributes:
+      name:
+          Resource name of the signal, for example,
+          "projects/{project_id}/signals/{signal_id}".
+      etag:
+          Etag to validate the object is unchanged for a read-modify-
+          write operation. An empty etag will overwrite other changes.
+      incident:
+          Resource name of the incident this signal is currently
+          assigned to. May be empty if signal is unassigned.
+      create_time:
+          Output only. Time this signal was created.
+      close_time:
+          Output only. Time this signal was closed. This field is not
+          populated while the signal is still firing.
+      detect_time:
+          The time this Signal was first detected. This is identical to
+          create_time for Signals created by Stackdriver Alerting.
+      creator:
+          Output only. The user that created this signal for manually
+          created signals. Empty if this signal was generated by a
+          system (for example, Stackdriver Alerting).
+      title:
+          One-line summary of the signal. Immutable.
+      content_type:
+          Content type string. 'text/plain' is currently the only
+          supported content type for Signals created via the API.
+          Signals created by Stackdriver Alerting support 'text/html' as
+          well. Immutable for Signals created by Stackdriver Alerting.
+      content:
+          Full message of the signal. Immutable for Signals created by
+          Stackdriver Alerting.
+      signal_state:
+          The state of this signal. For Signals created by Stackdriver
+          Alerting this field is output only.
+      signal_artifacts:
+          A set of artifacts to additional resources for this Signal.
+          For example, a link to Stackdriver logging for the Signal.
+          Immutable for Signals created by Stackdriver Alerting.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Signal)
+    ),
+)
+_sym_db.RegisterMessage(Signal)
+_sym_db.RegisterMessage(Signal.SignalArtifact)
+
+Annotation = _reflection.GeneratedProtocolMessageType(
+    "Annotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATION,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""A text annotation by a user.
+  
+  
+  Attributes:
+      name:
+          Resource name of the annotation, for example, "projects/{proje
+          ct_id}/incidents/{incident_id}/annotations/{annotation_id}"
+          .
+      author:
+          Output only. Author of the annotation.
+      create_time:
+          Output only. Time the annotation was created.
+      content:
+          Content of the annotation. Immutable.
+      content_type:
+          Content type of the annotation, for example, 'text/plain' or
+          'text/markdown'. Immutable.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Annotation)
+    ),
+)
+_sym_db.RegisterMessage(Annotation)
+
+Tag = _reflection.GeneratedProtocolMessageType(
+    "Tag",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TAG,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""A tag by a user.
+  
+  
+  Attributes:
+      name:
+          Resource name of a tag, for example, "projects/{project_id}/i
+          ncidents/{incident_id}/tags/{tag_id}"
+      display_name:
+          Display name of the resource (for example, "cause:rollout").
+          Immutable.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Tag)
+    ),
+)
+_sym_db.RegisterMessage(Tag)
+
+Synopsis = _reflection.GeneratedProtocolMessageType(
+    "Synopsis",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNOPSIS,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""Synopsis is a summary of an incident and it contains a textual content,
+  an author and a last updated timestamp.
+  
+  
+  Attributes:
+      content_type:
+          Content type string, for example, 'text/plain' or
+          'text/markdown'.
+      content:
+          Textual content of the synopsis. It can be plain text or
+          markdown as indicated by the content_type.
+      update_time:
+          Last updated timestamp.
+      author:
+          Author of the synopsis.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Synopsis)
+    ),
+)
+_sym_db.RegisterMessage(Synopsis)
+
+Incident = _reflection.GeneratedProtocolMessageType(
+    "Incident",
+    (_message.Message,),
+    dict(
+        CommunicationVenue=_reflection.GeneratedProtocolMessageType(
+            "CommunicationVenue",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INCIDENT_COMMUNICATIONVENUE,
+                __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+                __doc__="""CommunicationVenue is a record of where conversations about an incident
+    are happening.
+    
+    
+    Attributes:
+        uri:
+            A URI to the web interface of the channel.
+        display_name:
+            A name representing the channel in IRM UI.
+        channel_type:
+            The type of channel/venue for incident communications.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Incident.CommunicationVenue)
+            ),
+        ),
+        DESCRIPTOR=_INCIDENT,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""Representation of an incident.
+  
+  
+  Attributes:
+      name:
+          Output only. Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      title:
+          One-line summary of the incident.
+      escalation_level:
+          Escalation level of the incident.
+      etag:
+          Etag to validate the object is unchanged for a read-modify-
+          write operation. An empty etag will overwrite other changes.
+      severity:
+          Severity of the incident.
+      stage:
+          Stage of the incident.
+      duplicate_incident:
+          Resource name of the incident this incident is a duplicate of.
+          Empty if this incident is not a duplicate. An incident can
+          only be a duplicate of an incident that is not marked as a
+          duplicate already. Setting this to a non-empty value must also
+          set the stage to ``STAGE_DUPLICATE``. Unsetting this value
+          value must also update ``stage`` to a value other than
+          ``STAGE_DUPLICATE``.
+      start_time:
+          Output only. Time this incident started. Used to measure the
+          'elapsed time'. Start time of an incident is the earliest
+          creation time of any of its Signals or the create time of the
+          incident if no Signals are assigned.
+      synopsis:
+          Output only. Synopsis of this incident.
+      communication_venue:
+          Location of communications for this incident. This is
+          informational only; IRM does not use this to send messages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Incident)
+    ),
+)
+_sym_db.RegisterMessage(Incident)
+_sym_db.RegisterMessage(Incident.CommunicationVenue)
+
+IncidentRole = _reflection.GeneratedProtocolMessageType(
+    "IncidentRole",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INCIDENTROLE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""Describes a role that can be assigned to an incident.
+  
+  
+  Attributes:
+      type:
+          The type of role. The role type is immutable in role
+          assignments. Each role type can only be used once per
+          incident, except for TYPE_OTHER.
+      title:
+          Output only unless TYPE_OTHER is used. Title of the role. For
+          TYPE_OTHER, must be unique within an incident.
+      description:
+          Output only unless TYPE_OTHER is used. Description of the
+          role.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.IncidentRole)
+    ),
+)
+_sym_db.RegisterMessage(IncidentRole)
+
+IncidentRoleAssignment = _reflection.GeneratedProtocolMessageType(
+    "IncidentRoleAssignment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INCIDENTROLEASSIGNMENT,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""Stores the assignee of a role as well as the proposed next assignee.
+  
+  
+  Attributes:
+      name:
+          Output only. Resource name such as "projects/{project_id}/inc
+          idents/{incident_id}/role_assignments/{role_id}".
+      etag:
+          Output only. Etag for this version of the resource. Must be
+          specified in update requests and match the current version in
+          storage. Must not be modified by the client.
+      role:
+          The role that is or will be assigned.
+      assignee:
+          The user this role is assigned to. This field can only be
+          directly set during creation request. Subsequent updates are
+          done via the IncidentRoleHandover methods.
+      proposed_assignee:
+          The recipient of a requested role handoff. This field can only
+          be directly set during creation request. Subsequent updates
+          are done via the IncidentRoleHandover methods.  ``assignee``
+          is always the current role-holder, and ``proposed_assignee``
+          is used to track unfinished assignments and handoffs. Let's
+          say Bob assigns Alice to a role. Then the fields are:
+          ``assignee``: nil, ``proposed_assignee``: Alice If Alice
+          accepts, then the fields are: ``assignee``: Alice,
+          ``proposed_assignee``: nil If she cancels, then the
+          RoleAssignment is deleted. Let's say Alice has the role. Then
+          the fields are: ``assignee``: Alice, ``proposed_assignee``:
+          nil If Alice becomes incapacitated and Bob requests Carol to
+          take over, then the fields are: ``assignee``: Alice,
+          ``proposed_assignee``: Carol After Carol accepts the handover,
+          the fields are: ``assignee``: Carol, ``proposed_assignee``:
+          nil Or if Carol refuses the handover, the fields are:
+          ``assignee``: Alice, ``proposed_assignee``: nil
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.IncidentRoleAssignment)
+    ),
+)
+_sym_db.RegisterMessage(IncidentRoleAssignment)
+
+Artifact = _reflection.GeneratedProtocolMessageType(
+    "Artifact",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ARTIFACT,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""External artifact associated to an incident.
+  
+  
+  Attributes:
+      name:
+          Output only. Resource name such as "projects/{project_id}/inc
+          idents/{incident_id}/artifacts/{artifact_id}".
+      display_name:
+          User provided name of an artifact.
+      etag:
+          Output only. Etag for this version of the resource. Must be
+          specified in update requests and match the current version in
+          storage. Must not be modified by the client.
+      url:
+          URL to access the artifact.
+      type:
+          Type of this artifact.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Artifact)
+    ),
+)
+_sym_db.RegisterMessage(Artifact)
+
+CommunicationChannel = _reflection.GeneratedProtocolMessageType(
+    "CommunicationChannel",
+    (_message.Message,),
+    dict(
+        Email=_reflection.GeneratedProtocolMessageType(
+            "Email",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMMUNICATIONCHANNEL_EMAIL,
+                __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+                __doc__="""A communication channel that delivers messages to an email address.
+    
+    
+    Attributes:
+        address:
+            The email address, for example, "user@example.com".
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CommunicationChannel.Email)
+            ),
+        ),
+        NotificationChannel=_reflection.GeneratedProtocolMessageType(
+            "NotificationChannel",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMMUNICATIONCHANNEL_NOTIFICATIONCHANNEL,
+                __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+                __doc__="""A communication channel that delivers messages to a Stackdriver
+    notification channel.
+    
+    
+    Attributes:
+        name:
+            Stackdriver notification channel name.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CommunicationChannel.NotificationChannel)
+            ),
+        ),
+        DESCRIPTOR=_COMMUNICATIONCHANNEL,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""Communication Channels are mechanisms used to receive notifications
+  about changes to incidents.
+  
+  
+  Attributes:
+      endpoint:
+          An endpoint describes how messages will be delivered.
+      email:
+          Messages will be delivered via email.
+      notification_channel:
+          Messages will be delivered via a Stackdriver notification
+          channel.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CommunicationChannel)
+    ),
+)
+_sym_db.RegisterMessage(CommunicationChannel)
+_sym_db.RegisterMessage(CommunicationChannel.Email)
+_sym_db.RegisterMessage(CommunicationChannel.NotificationChannel)
+
+Subscription = _reflection.GeneratedProtocolMessageType(
+    "Subscription",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SUBSCRIPTION,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_pb2",
+        __doc__="""A subscription allows users to get notifications about changes to an
+  incident.
+  
+  
+  Attributes:
+      name:
+          Output only. Resource name such as "projects/{project_id}/inc
+          idents/{incident_id}/subscriptions/{subscription_id}".
+      etag:
+          Output only. Etag for this version of the resource. Must be
+          specified in update requests and match the current version in
+          storage. Must not be modified by the client.
+      subscription_channel:
+          A communications channel to send subscription messages to.
+      event_types:
+          Types of events this subscription receives notifications for.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.Subscription)
+    ),
+)
+_sym_db.RegisterMessage(Subscription)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/irm/google/cloud/irm_v1alpha2/proto/incidents_pb2_grpc.py b/irm/google/cloud/irm_v1alpha2/proto/incidents_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/proto/incidents_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/irm/google/cloud/irm_v1alpha2/proto/incidents_service.proto b/irm/google/cloud/irm_v1alpha2/proto/incidents_service.proto
new file mode 100644
index 000000000000..76cc3ae38e59
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/proto/incidents_service.proto
@@ -0,0 +1,914 @@
+// 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.irm.v1alpha2;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/irm/v1alpha2/incidents.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/irm/v1alpha2;irm";
+option java_multiple_files = true;
+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";
+
+  // Creates a new incident.
+  rpc CreateIncident(CreateIncidentRequest) returns (Incident) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*}/incidents"
+      body: "incident"
+    };
+  }
+
+  // Returns an incident by name.
+  rpc GetIncident(GetIncidentRequest) returns (Incident) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{name=projects/*/incidents/*}"
+    };
+  }
+
+  // Returns a list of incidents.
+  // Incidents are ordered by start time, with the most recent incidents first.
+  rpc SearchIncidents(SearchIncidentsRequest)
+      returns (SearchIncidentsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*}/incidents:search"
+    };
+  }
+
+  // Updates an existing incident.
+  rpc UpdateIncident(UpdateIncidentRequest) returns (Incident) {
+    option (google.api.http) = {
+      patch: "/v1alpha2/{incident.name=projects/*/incidents/*}"
+      body: "incident"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{name=projects/*/incidents/*}:searchSimilar"
+      additional_bindings {
+        get: "/v1alpha2/{name=projects/*/signals/*}:searchSimilarIncidents"
+      }
+    };
+  }
+
+  // Creates an annotation on an existing incident. Only 'text/plain' and
+  // 'text/markdown' annotations can be created via this method.
+  rpc CreateAnnotation(CreateAnnotationRequest) returns (Annotation) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*/incidents/*}/annotations"
+      body: "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) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*/incidents/*}/annotations"
+    };
+  }
+
+  // Creates a tag on an existing incident.
+  rpc CreateTag(CreateTagRequest) returns (Tag) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*/incidents/*}/tags"
+      body: "tag"
+    };
+  }
+
+  // Deletes an existing tag.
+  rpc DeleteTag(DeleteTagRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1alpha2/{name=projects/*/incidents/*/tags/*}"
+    };
+  }
+
+  // Lists tags that are part of an incident.
+  rpc ListTags(ListTagsRequest) returns (ListTagsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*/incidents/*}/tags"
+    };
+  }
+
+  // Creates a new signal.
+  rpc CreateSignal(CreateSignalRequest) returns (Signal) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*}/signals"
+      body: "signal"
+    };
+  }
+
+  // Lists signals that are part of an incident.
+  // Signals are returned in reverse chronological order.
+  rpc SearchSignals(SearchSignalsRequest) returns (SearchSignalsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*}/signals:search"
+    };
+  }
+
+  // Finds a signal by other unique IDs.
+  rpc LookupSignal(LookupSignalRequest) returns (Signal) {
+    option (google.api.http) = {
+      get: "/v1alpha2/signals:lookup"
+    };
+  }
+
+  // Returns a signal by name.
+  rpc GetSignal(GetSignalRequest) returns (Signal) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{name=projects/*/signals/*}"
+    };
+  }
+
+  // Updates an existing signal (for example, to assign/unassign it to an
+  // incident).
+  rpc UpdateSignal(UpdateSignalRequest) returns (Signal) {
+    option (google.api.http) = {
+      patch: "/v1alpha2/{signal.name=projects/*/signals/*}"
+      body: "signal"
+    };
+  }
+
+  // Escalates an incident.
+  rpc EscalateIncident(EscalateIncidentRequest)
+      returns (EscalateIncidentResponse) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{incident.name=projects/*/incidents/*}:escalate"
+      body: "*"
+    };
+  }
+
+  // Creates a new artifact.
+  rpc CreateArtifact(CreateArtifactRequest) returns (Artifact) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*/incidents/*}/artifacts"
+      body: "artifact"
+    };
+  }
+
+  // Returns a list of artifacts for an incident.
+  rpc ListArtifacts(ListArtifactsRequest) returns (ListArtifactsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*/incidents/*}/artifacts"
+    };
+  }
+
+  // Updates an existing artifact.
+  rpc UpdateArtifact(UpdateArtifactRequest) returns (Artifact) {
+    option (google.api.http) = {
+      patch: "/v1alpha2/{artifact.name=projects/*/incidents/*/artifacts/*}"
+      body: "artifact"
+    };
+  }
+
+  // Deletes an existing artifact.
+  rpc DeleteArtifact(DeleteArtifactRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1alpha2/{name=projects/*/incidents/*/artifacts/*}"
+    };
+  }
+
+  // Sends a summary of the shift for oncall handoff.
+  rpc SendShiftHandoff(SendShiftHandoffRequest)
+      returns (SendShiftHandoffResponse) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*}/shiftHandoff:send"
+      body: "*"
+    };
+  }
+
+  // Creates a new subscription.
+  // This will fail if:
+  //    a. there are too many (50) subscriptions in the incident already
+  //    b. a subscription using the given channel already exists
+  rpc CreateSubscription(CreateSubscriptionRequest) returns (Subscription) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*/incidents/*}/subscriptions"
+      body: "subscription"
+    };
+  }
+
+  // Updates a subscription.
+  rpc UpdateSubscription(UpdateSubscriptionRequest) returns (Subscription) {
+    option (google.api.http) = {
+      patch: "/v1alpha2/{subscription.name=projects/*/incidents/*/subscriptions/*}"
+      body: "subscription"
+    };
+  }
+
+  // Returns a list of subscriptions for an incident.
+  rpc ListSubscriptions(ListSubscriptionsRequest)
+      returns (ListSubscriptionsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*/incidents/*}/subscriptions"
+    };
+  }
+
+  // Deletes an existing subscription.
+  rpc DeleteSubscription(DeleteSubscriptionRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1alpha2/{name=projects/*/incidents/*/subscriptions/*}"
+    };
+  }
+
+  // Creates a role assignment on an existing incident. Normally, the user field
+  // will be set when assigning a role to oneself, and the next field will be
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments"
+      body: "*"
+    };
+  }
+
+  // Deletes an existing role assignment.
+  rpc DeleteIncidentRoleAssignment(DeleteIncidentRoleAssignmentRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}"
+    };
+  }
+
+  // Lists role assignments that are part of an incident.
+  rpc ListIncidentRoleAssignments(ListIncidentRoleAssignmentsRequest)
+      returns (ListIncidentRoleAssignmentsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:requestHandover"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:confirmHandover"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:forceHandover"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:cancelHandover"
+      body: "*"
+    };
+  }
+}
+
+// Request for the CreateIncident method.
+message CreateIncidentRequest {
+  // The incident to create.
+  Incident incident = 1;
+
+  // 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;
+}
+
+// Request for the GetIncident method.
+message GetIncidentRequest {
+  // Resource name of the incident, for example,
+  // "projects/{project_id}/incidents/{incident_id}".
+  string name = 1;
+}
+
+// Request for the UpdateIncident method.
+message UpdateIncidentRequest {
+  // The incident to update with the new values.
+  Incident incident = 1;
+
+  // List of fields that should be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// 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;
+
+  // Number of similar incidents to return.
+  int32 page_size = 2;
+
+  // Page token from an earlier query, as returned in 'next_page_token'.
+  string page_token = 3;
+}
+
+// Response for the SearchSimilarIncidents method.
+message SearchSimilarIncidentsResponse {
+  // A single search result, i.e. an incident with (potentially) additional
+  // information.
+  message Result {
+    // An incident that is "similar" to the incident or signal specified in the
+    // request.
+    Incident incident = 1;
+  }
+
+  // The search results, ordered by descending relevance.
+  repeated Result results = 1;
+
+  // Page token to fetch the next set of similar incidents.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// Request for the ListAnnotations method.
+message ListAnnotationsRequest {
+  // Resource name of the incident, for example,
+  // "projects/{project_id}/incidents/{incident_id}".
+  string parent = 1;
+
+  // Number of annotations to return.
+  int32 page_size = 2;
+
+  // Page token from an earlier query, as returned in `next_page_token`.
+  string page_token = 3;
+}
+
+// Response for the ListAnnotations method.
+message ListAnnotationsResponse {
+  // List of annotations.
+  repeated Annotation annotations = 1;
+
+  // Page token to fetch the next set of annotations.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// Request for the DeleteTag method.
+message DeleteTagRequest {
+  // Resource name of the tag.
+  string name = 1;
+}
+
+// Request for the ListTagsForIncident method.
+message ListTagsRequest {
+  // Resource name of the incident, for example,
+  // "projects/{project_id}/incidents/{incident_id}".
+  string parent = 1;
+
+  // Number of tags to return.
+  int32 page_size = 2;
+
+  // Page token from an earlier query, as returned in `next_page_token`.
+  string page_token = 3;
+}
+
+// Response for the ListTagsForIncident method.
+message ListTagsResponse {
+  // Tags.
+  repeated Tag tags = 1;
+
+  // Page token to fetch the next set of tags.
+  string next_page_token = 2;
+}
+
+// Request for the CreateSignal method.
+message CreateSignalRequest {
+  // The resource name of the hosting Stackdriver project which requested
+  // signal belongs to.
+  string parent = 1;
+
+  // The signal to create.
+  Signal signal = 2;
+}
+
+// Request for the SearchSignals method.
+message SearchSignalsRequest {
+  // The resource name of the hosting Stackdriver project which requested
+  // incidents belong to.
+  string parent = 1;
+
+  // An expression that defines which signals to return.
+  //
+  // Search atoms can be used to match certain specific fields.  Otherwise,
+  // plain text will match text fields in the signal.
+  //
+  // Search atoms:
+  //
+  // * `start` - (timestamp) The time the signal was created.
+  // * `title` - The title of the signal.
+  // * `signal_state` - `open` or `closed`. State of the signal.
+  //   (e.g., `signal_state:open`)
+  //
+  // Timestamp formats:
+  //
+  // * yyyy-MM-dd - an absolute date, treated as a calendar-day-wide window.
+  //   In other words, the "<" operator will match dates before that date, the
+  //   ">" operator will match dates after that date, and the ":" operator will
+  //   match the entire day.
+  // * yyyy-MM-ddTHH:mm - Same as above, but with minute resolution.
+  // * yyyy-MM-ddTHH:mm:ss - Same as above, but with second resolution.
+  // * Nd (e.g. 7d) - a relative number of days ago, treated as a moment in time
+  //   (as opposed to a day-wide span) a multiple of 24 hours ago (as opposed to
+  //   calendar days).  In the case of daylight savings time, it will apply the
+  //   current timezone to both ends of the range.  Note that exact matching
+  //   (e.g. `start:7d`) is unlikely to be useful because that would only match
+  //   signals created precisely at a particular instant in time.
+  //
+  // The absolute timestamp formats (everything starting with a year) can
+  // optionally be followed with a UTC offset in +/-hh:mm format.  Also, the 'T'
+  // separating dates and times can optionally be replaced with a space. Note
+  // that any timestamp containing a space or colon will need to be quoted.
+  //
+  // Examples:
+  //
+  // * `foo` - matches signals containing the word "foo"
+  // * `"foo bar"` - matches signals containing the phrase "foo bar"
+  // * `foo bar` or `foo AND bar` - matches signals containing the words
+  //   "foo" and "bar"
+  // * `foo -bar` or `foo AND NOT bar` - matches signals containing the
+  //   word
+  //   "foo" but not the word "bar"
+  // * `foo OR bar` - matches signals containing the word "foo" or the
+  //   word "bar"
+  // * `start>2018-11-28` - matches signals which started after November
+  //   11, 2018.
+  // * `start<=2018-11-28` - matches signals which started on or before
+  //   November 11, 2018.
+  // * `start:2018-11-28` - matches signals which started on November 11,
+  //   2018.
+  // * `start>"2018-11-28 01:02:03+04:00"` - matches signals which started
+  //   after November 11, 2018 at 1:02:03 AM according to the UTC+04 time
+  //   zone.
+  // * `start>7d` - matches signals which started after the point in time
+  //   7*24 hours ago
+  // * `start>180d` - similar to 7d, but likely to cross the daylight savings
+  //   time boundary, so the end time will be 1 hour different from "now."
+  // * `foo AND start>90d AND stage<resolved` - unresolved signals from
+  //   the past 90 days containing the word "foo"
+  string query = 2;
+
+  // Maximum number of `signals` to return in the response.
+  int32 page_size = 3;
+
+  // Page token from an earlier query, as returned in `next_page_token`. All
+  // field values except for page_size and page_token should be the same as the
+  // original query (may return an error or unexpected data otherwise).
+  string page_token = 4;
+}
+
+// Response for the SearchSignals method.
+message SearchSignalsResponse {
+  // Signals that matched the query in the request.
+  repeated Signal signals = 1;
+
+  // Page token to fetch the next set of signals.
+  string next_page_token = 2;
+}
+
+// Request for the GetSignal method.
+message GetSignalRequest {
+  // Resource name of the Signal resource, for example,
+  // "projects/{project_id}/signals/{signal_id}".
+  string name = 1;
+}
+
+// Request for the LookupSignal method.
+message LookupSignalRequest {
+  // Required. The ID to use for lookup.
+  oneof alternate_id {
+    // Full resource name of the CSCC finding id this signal refers to (e.g.
+    // "organizations/abc/sources/123/findings/xyz")
+    string cscc_finding = 2;
+
+    // The ID from the Stackdriver Alerting notification.
+    string stackdriver_notification_id = 3;
+  }
+}
+
+// Request for the UpdateSignal method.
+message UpdateSignalRequest {
+  // The signal to update with the new values.
+  Signal signal = 1;
+
+  // List of fields that should be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request for the SearchIncidents method.
+message SearchIncidentsRequest {
+  // The resource name of the hosting Stackdriver project which requested
+  // incidents belong to.
+  string parent = 1;
+
+  // An expression that defines which incidents to return.
+  //
+  // Search atoms can be used to match certain specific fields.  Otherwise,
+  // plain text will match text fields in the incident.
+  //
+  // Search atoms:
+  // * `start` - (timestamp) The time the incident started.
+  // * `stage` - The stage of the incident, one of detected, triaged, mitigated,
+  //   resolved, documented, or duplicate (which correspond to values in the
+  //   Incident.Stage enum). These are ordered, so `stage<resolved` is
+  //   equivalent to `stage:detected OR stage:triaged OR stage:mitigated`.
+  // * `severity` - (Incident.Severity) The severity of the incident.
+  //    + Supports matching on a specific severity (for example,
+  //    `severity:major`) or on a range (for example, `severity>medium`,
+  //    `severity<=minor`, etc.).
+  //
+  // Timestamp formats:
+  // * yyyy-MM-dd - an absolute date, treated as a calendar-day-wide window.
+  //   In other words, the "<" operator will match dates before that date, the
+  //   ">" operator will match dates after that date, and the ":" or "="
+  //   operators will match the entire day.
+  // * Nd (for example, 7d) - a relative number of days ago, treated as a moment
+  //   in time (as opposed to a day-wide span). A multiple of 24 hours ago (as
+  //   opposed to calendar days).  In the case of daylight savings time, it will
+  //   apply the current timezone to both ends of the range.  Note that exact
+  //   matching (for example, `start:7d`) is unlikely to be useful because that
+  //   would only match incidents created precisely at a particular instant in
+  //   time.
+  //
+  // Examples:
+  //
+  // * `foo` - matches incidents containing the word "foo"
+  // * `"foo bar"` - matches incidents containing the phrase "foo bar"
+  // * `foo bar` or `foo AND bar` - matches incidents containing the words "foo"
+  //   and "bar"
+  // * `foo -bar` or `foo AND NOT bar` - matches incidents containing the word
+  //   "foo" but not the word "bar"
+  // * `foo OR bar` - matches incidents containing the word "foo" or the word
+  //   "bar"
+  // * `start>2018-11-28` - matches incidents which started after November 11,
+  //   2018.
+  // * `start<=2018-11-28` - matches incidents which started on or before
+  //   November 11, 2018.
+  // * `start:2018-11-28` - matches incidents which started on November 11,
+  //   2018.
+  // * `start>7d` - matches incidents which started after the point in time 7*24
+  //   hours ago
+  // * `start>180d` - similar to 7d, but likely to cross the daylight savings
+  //   time boundary, so the end time will be 1 hour different from "now."
+  // * `foo AND start>90d AND stage<resolved` - unresolved incidents from the
+  //   past 90 days containing the word "foo"
+  string query = 2;
+
+  // Number of incidents to return.
+  int32 page_size = 3;
+
+  // Page token from an earlier query, as returned in `next_page_token`.
+  string page_token = 4;
+
+  // The time zone name. It should be an IANA TZ name, such as
+  // "America/Los_Angeles". For more information,
+  // see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
+  // If no time zone is specified, the default is UTC.
+  string time_zone = 5;
+}
+
+// Response for the SearchIncidents method.
+message SearchIncidentsResponse {
+  // Incidents.
+  repeated Incident incidents = 1;
+
+  // Page token to fetch the next set of incidents.
+  string next_page_token = 2;
+}
+
+// Request to escalate an incident.
+message EscalateIncidentRequest {
+  // The incident to escalate with the new values.
+  Incident incident = 1;
+
+  // List of fields that should be updated.
+  google.protobuf.FieldMask update_mask = 2;
+
+  // Subscriptions to add or update. Existing subscriptions with the same
+  // channel and address as a subscription in the list will be updated.
+  repeated Subscription subscriptions = 3;
+
+  // Tags to add. Tags identical to existing tags will be ignored.
+  repeated Tag tags = 4;
+
+  // Roles to add or update. Existing roles with the same type (and title, for
+  // TYPE_OTHER roles) will be updated.
+  repeated IncidentRoleAssignment roles = 5;
+
+  // Artifacts to add. All artifacts are added without checking for duplicates.
+  repeated Artifact artifacts = 6;
+}
+
+// Response for EscalateIncident.
+message EscalateIncidentResponse {
+  // The escalated incident.
+  Incident incident = 1;
+
+  // New or modified subscriptions.
+  repeated Subscription subscriptions = 2;
+
+  // New or modified tags.
+  repeated Tag tags = 3;
+
+  // New or modified roles.
+  repeated IncidentRole roles = 4;
+
+  // New or modified artifacts.
+  repeated Artifact artifacts = 5;
+}
+
+// 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;
+}
+
+// Request for the ListArtifacts method.
+message ListArtifactsRequest {
+  // Resource name of the incident, for example,
+  // "projects/{project_id}/incidents/{incident_id}".
+  string parent = 1;
+
+  // Number of artifacts to return.
+  int32 page_size = 2;
+
+  // Page token from an earlier query, as returned in `next_page_token`.
+  string page_token = 3;
+}
+
+// Response for the ListArtifacts method.
+message ListArtifactsResponse {
+  // List of artifacts.
+  repeated Artifact artifacts = 1;
+
+  // Page token to fetch the next set of artifacts.
+  string next_page_token = 2;
+}
+
+// Request for the UpdateArtifact method.
+message UpdateArtifactRequest {
+  // The artifact to update with the new values.
+  Artifact artifact = 1;
+
+  // List of fields that should be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request for deleting an artifact.
+message DeleteArtifactRequest {
+  // Resource name of the artifact.
+  string name = 1;
+}
+
+// SendShiftHandoff and PreviewShiftHandoff RPC request.
+message SendShiftHandoffRequest {
+  // Describes an incident for inclusion in the handoff.
+  // This is wrapped in a message to provide flexibility for potentially
+  // 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;
+  }
+
+  // The resource name of the Stackdriver project that the handoff is being sent
+  // from. for example, `projects/{project_id}`
+  string parent = 1;
+
+  // Email addresses of the recipients of the handoff, for example,
+  // "user@example.com". Must contain at least one entry.
+  repeated string recipients = 2;
+
+  // Email addresses that should be CC'd on the handoff. Optional.
+  repeated string cc = 3;
+
+  // The subject of the email. Required.
+  string subject = 4;
+
+  // 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;
+
+  // The set of incidents that should be included in the handoff. Optional.
+  repeated Incident incidents = 7;
+
+  // If set to true a ShiftHandoffResponse will be returned but the handoff
+  // will not actually be sent.
+  bool preview_only = 8;
+}
+
+// SendShiftHandoff and PreviewShiftHandoff RPC response.
+message SendShiftHandoffResponse {
+  // Content type string, for example, 'text/plain' or 'text/html'.
+  string content_type = 1;
+
+  // The contents of the handoff that was sent or would have been sent (if the
+  // request was preview_only).
+  // This will typically contain a full HTML document.
+  string content = 2;
+}
+
+// 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;
+}
+
+// Request for the UpdateSubscription method.
+message UpdateSubscriptionRequest {
+  // The subscription to update, with new values.
+  Subscription subscription = 1;
+
+  // List of fields that should be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request for the ListSubscriptions method.
+message ListSubscriptionsRequest {
+  // Resource name of the incident, for example,
+  // "projects/{project_id}/incidents/{incident_id}".
+  string parent = 1;
+
+  // Number of subscriptions to return.
+  int32 page_size = 2;
+
+  // Page token from an earlier query, as returned in `next_page_token`.
+  string page_token = 3;
+}
+
+// Response for the ListSubscriptions method.
+message ListSubscriptionsResponse {
+  // List of subscriptions.
+  repeated Subscription subscriptions = 1;
+
+  // Page token to fetch the next set of subscriptions.
+  string next_page_token = 2;
+}
+
+// Request for deleting a subscription.
+message DeleteSubscriptionRequest {
+  // Resource name of the subscription.
+  string name = 1;
+}
+
+// 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;
+}
+
+// Request for deleting a role assignment.
+message DeleteIncidentRoleAssignmentRequest {
+  // Resource name of the role assignment.
+  string name = 1;
+}
+
+// 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;
+
+  // Number of assignments to return.
+  int32 page_size = 2;
+
+  // Page token from an earlier query, as returned in `next_page_token`.
+  string page_token = 3;
+}
+
+// Response for the ListIncidentRoleAssignments method.
+message ListIncidentRoleAssignmentsResponse {
+  // List of assignments.
+  repeated IncidentRoleAssignment incident_role_assignments = 1;
+
+  // Page token to fetch the next set of assignments.
+  string next_page_token = 2;
+}
+
+// Request to start a role handover.
+message RequestIncidentRoleHandoverRequest {
+  // Resource name of the role assignment.
+  string name = 1;
+
+  // The proposed assignee.
+  User new_assignee = 2;
+}
+
+// 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
+  // current user; otherwise ForceRoleHandover should be called.
+  User new_assignee = 2;
+}
+
+// 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
+  // the current user; otherwise ConfirmRoleHandover should be called.
+  User new_assignee = 2;
+}
+
+// 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.
+  // IncidentRoleAssignment.proposed_assignee) and whose proposal is being
+  // cancelled.
+  User new_assignee = 2;
+}
diff --git a/irm/google/cloud/irm_v1alpha2/proto/incidents_service_pb2.py b/irm/google/cloud/irm_v1alpha2/proto/incidents_service_pb2.py
new file mode 100644
index 000000000000..d9fbcadac7e3
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/proto/incidents_service_pb2.py
@@ -0,0 +1,4523 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/irm_v1alpha2/proto/incidents_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.irm_v1alpha2.proto import (
+    incidents_pb2 as google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/irm_v1alpha2/proto/incidents_service.proto",
+    package="google.cloud.irm.v1alpha2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n#com.google.irm.service.v1alpha2.apiP\001Z<google.golang.org/genproto/googleapis/cloud/irm/v1alpha2;irm\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/irm_v1alpha2/proto/incidents_service.proto\x12\x19google.cloud.irm.v1alpha2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a/google/cloud/irm_v1alpha2/proto/incidents.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"^\n\x15\x43reateIncidentRequest\x12\x35\n\x08incident\x18\x01 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Incident\x12\x0e\n\x06parent\x18\x02 \x01(\t""\n\x12GetIncidentRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x7f\n\x15UpdateIncidentRequest\x12\x35\n\x08incident\x18\x01 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Incident\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"T\n\x1dSearchSimilarIncidentsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\xcd\x01\n\x1eSearchSimilarIncidentsResponse\x12Q\n\x07results\x18\x01 \x03(\x0b\x32@.google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse.Result\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x1a?\n\x06Result\x12\x35\n\x08incident\x18\x01 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Incident"d\n\x17\x43reateAnnotationRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x39\n\nannotation\x18\x02 \x01(\x0b\x32%.google.cloud.irm.v1alpha2.Annotation"O\n\x16ListAnnotationsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"n\n\x17ListAnnotationsResponse\x12:\n\x0b\x61nnotations\x18\x01 \x03(\x0b\x32%.google.cloud.irm.v1alpha2.Annotation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"O\n\x10\x43reateTagRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12+\n\x03tag\x18\x02 \x01(\x0b\x32\x1e.google.cloud.irm.v1alpha2.Tag" \n\x10\x44\x65leteTagRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"H\n\x0fListTagsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"Y\n\x10ListTagsResponse\x12,\n\x04tags\x18\x01 \x03(\x0b\x32\x1e.google.cloud.irm.v1alpha2.Tag\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"X\n\x13\x43reateSignalRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x31\n\x06signal\x18\x02 \x01(\x0b\x32!.google.cloud.irm.v1alpha2.Signal"\\\n\x14SearchSignalsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\r\n\x05query\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"d\n\x15SearchSignalsResponse\x12\x32\n\x07signals\x18\x01 \x03(\x0b\x32!.google.cloud.irm.v1alpha2.Signal\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t" \n\x10GetSignalRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"d\n\x13LookupSignalRequest\x12\x16\n\x0c\x63scc_finding\x18\x02 \x01(\tH\x00\x12%\n\x1bstackdriver_notification_id\x18\x03 \x01(\tH\x00\x42\x0e\n\x0c\x61lternate_id"y\n\x13UpdateSignalRequest\x12\x31\n\x06signal\x18\x01 \x01(\x0b\x32!.google.cloud.irm.v1alpha2.Signal\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"q\n\x16SearchIncidentsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\r\n\x05query\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x11\n\ttime_zone\x18\x05 \x01(\t"j\n\x17SearchIncidentsResponse\x12\x36\n\tincidents\x18\x01 \x03(\x0b\x32#.google.cloud.irm.v1alpha2.Incident\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\xe9\x02\n\x17\x45scalateIncidentRequest\x12\x35\n\x08incident\x18\x01 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Incident\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12>\n\rsubscriptions\x18\x03 \x03(\x0b\x32\'.google.cloud.irm.v1alpha2.Subscription\x12,\n\x04tags\x18\x04 \x03(\x0b\x32\x1e.google.cloud.irm.v1alpha2.Tag\x12@\n\x05roles\x18\x05 \x03(\x0b\x32\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment\x12\x36\n\tartifacts\x18\x06 \x03(\x0b\x32#.google.cloud.irm.v1alpha2.Artifact"\xaf\x02\n\x18\x45scalateIncidentResponse\x12\x35\n\x08incident\x18\x01 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Incident\x12>\n\rsubscriptions\x18\x02 \x03(\x0b\x32\'.google.cloud.irm.v1alpha2.Subscription\x12,\n\x04tags\x18\x03 \x03(\x0b\x32\x1e.google.cloud.irm.v1alpha2.Tag\x12\x36\n\x05roles\x18\x04 \x03(\x0b\x32\'.google.cloud.irm.v1alpha2.IncidentRole\x12\x36\n\tartifacts\x18\x05 \x03(\x0b\x32#.google.cloud.irm.v1alpha2.Artifact"^\n\x15\x43reateArtifactRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x35\n\x08\x61rtifact\x18\x02 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Artifact"M\n\x14ListArtifactsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"h\n\x15ListArtifactsResponse\x12\x36\n\tartifacts\x18\x01 \x03(\x0b\x32#.google.cloud.irm.v1alpha2.Artifact\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x7f\n\x15UpdateArtifactRequest\x12\x35\n\x08\x61rtifact\x18\x01 \x01(\x0b\x32#.google.cloud.irm.v1alpha2.Artifact\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"%\n\x15\x44\x65leteArtifactRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8d\x02\n\x17SendShiftHandoffRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\nrecipients\x18\x02 \x03(\t\x12\n\n\x02\x63\x63\x18\x03 \x03(\t\x12\x0f\n\x07subject\x18\x04 \x01(\t\x12\x1a\n\x12notes_content_type\x18\x05 \x01(\t\x12\x15\n\rnotes_content\x18\x06 \x01(\t\x12N\n\tincidents\x18\x07 \x03(\x0b\x32;.google.cloud.irm.v1alpha2.SendShiftHandoffRequest.Incident\x12\x14\n\x0cpreview_only\x18\x08 \x01(\x08\x1a\x18\n\x08Incident\x12\x0c\n\x04name\x18\x01 \x01(\t"A\n\x18SendShiftHandoffResponse\x12\x14\n\x0c\x63ontent_type\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t"j\n\x19\x43reateSubscriptionRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12=\n\x0csubscription\x18\x02 \x01(\x0b\x32\'.google.cloud.irm.v1alpha2.Subscription"\x8b\x01\n\x19UpdateSubscriptionRequest\x12=\n\x0csubscription\x18\x01 \x01(\x0b\x32\'.google.cloud.irm.v1alpha2.Subscription\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"Q\n\x18ListSubscriptionsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"t\n\x19ListSubscriptionsResponse\x12>\n\rsubscriptions\x18\x01 \x03(\x0b\x32\'.google.cloud.irm.v1alpha2.Subscription\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t")\n\x19\x44\x65leteSubscriptionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8a\x01\n#CreateIncidentRoleAssignmentRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12S\n\x18incident_role_assignment\x18\x02 \x01(\x0b\x32\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment"3\n#DeleteIncidentRoleAssignmentRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"[\n"ListIncidentRoleAssignmentsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x94\x01\n#ListIncidentRoleAssignmentsResponse\x12T\n\x19incident_role_assignments\x18\x01 \x03(\x0b\x32\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"i\n"RequestIncidentRoleHandoverRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x0cnew_assignee\x18\x02 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User"i\n"ConfirmIncidentRoleHandoverRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x0cnew_assignee\x18\x02 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User"g\n ForceIncidentRoleHandoverRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x0cnew_assignee\x18\x02 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User"h\n!CancelIncidentRoleHandoverRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x35\n\x0cnew_assignee\x18\x02 \x01(\x0b\x32\x1f.google.cloud.irm.v1alpha2.User2\xf7.\n\x0fIncidentService\x12\xa2\x01\n\x0e\x43reateIncident\x12\x30.google.cloud.irm.v1alpha2.CreateIncidentRequest\x1a#.google.cloud.irm.v1alpha2.Incident"9\x82\xd3\xe4\x93\x02\x33"\'/v1alpha2/{parent=projects/*}/incidents:\x08incident\x12\x92\x01\n\x0bGetIncident\x12-.google.cloud.irm.v1alpha2.GetIncidentRequest\x1a#.google.cloud.irm.v1alpha2.Incident"/\x82\xd3\xe4\x93\x02)\x12\'/v1alpha2/{name=projects/*/incidents/*}\x12\xb0\x01\n\x0fSearchIncidents\x12\x31.google.cloud.irm.v1alpha2.SearchIncidentsRequest\x1a\x32.google.cloud.irm.v1alpha2.SearchIncidentsResponse"6\x82\xd3\xe4\x93\x02\x30\x12./v1alpha2/{parent=projects/*}/incidents:search\x12\xab\x01\n\x0eUpdateIncident\x12\x30.google.cloud.irm.v1alpha2.UpdateIncidentRequest\x1a#.google.cloud.irm.v1alpha2.Incident"B\x82\xd3\xe4\x93\x02<20/v1alpha2/{incident.name=projects/*/incidents/*}:\x08incident\x12\x8c\x02\n\x16SearchSimilarIncidents\x12\x38.google.cloud.irm.v1alpha2.SearchSimilarIncidentsRequest\x1a\x39.google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse"}\x82\xd3\xe4\x93\x02w\x12\x35/v1alpha2/{name=projects/*/incidents/*}:searchSimilarZ>\x12</v1alpha2/{name=projects/*/signals/*}:searchSimilarIncidents\x12\xb8\x01\n\x10\x43reateAnnotation\x12\x32.google.cloud.irm.v1alpha2.CreateAnnotationRequest\x1a%.google.cloud.irm.v1alpha2.Annotation"I\x82\xd3\xe4\x93\x02\x43"5/v1alpha2/{parent=projects/*/incidents/*}/annotations:\nannotation\x12\xb7\x01\n\x0fListAnnotations\x12\x31.google.cloud.irm.v1alpha2.ListAnnotationsRequest\x1a\x32.google.cloud.irm.v1alpha2.ListAnnotationsResponse"=\x82\xd3\xe4\x93\x02\x37\x12\x35/v1alpha2/{parent=projects/*/incidents/*}/annotations\x12\x95\x01\n\tCreateTag\x12+.google.cloud.irm.v1alpha2.CreateTagRequest\x1a\x1e.google.cloud.irm.v1alpha2.Tag";\x82\xd3\xe4\x93\x02\x35"./v1alpha2/{parent=projects/*/incidents/*}/tags:\x03tag\x12\x88\x01\n\tDeleteTag\x12+.google.cloud.irm.v1alpha2.DeleteTagRequest\x1a\x16.google.protobuf.Empty"6\x82\xd3\xe4\x93\x02\x30*./v1alpha2/{name=projects/*/incidents/*/tags/*}\x12\x9b\x01\n\x08ListTags\x12*.google.cloud.irm.v1alpha2.ListTagsRequest\x1a+.google.cloud.irm.v1alpha2.ListTagsResponse"6\x82\xd3\xe4\x93\x02\x30\x12./v1alpha2/{parent=projects/*/incidents/*}/tags\x12\x98\x01\n\x0c\x43reateSignal\x12..google.cloud.irm.v1alpha2.CreateSignalRequest\x1a!.google.cloud.irm.v1alpha2.Signal"5\x82\xd3\xe4\x93\x02/"%/v1alpha2/{parent=projects/*}/signals:\x06signal\x12\xa8\x01\n\rSearchSignals\x12/.google.cloud.irm.v1alpha2.SearchSignalsRequest\x1a\x30.google.cloud.irm.v1alpha2.SearchSignalsResponse"4\x82\xd3\xe4\x93\x02.\x12,/v1alpha2/{parent=projects/*}/signals:search\x12\x83\x01\n\x0cLookupSignal\x12..google.cloud.irm.v1alpha2.LookupSignalRequest\x1a!.google.cloud.irm.v1alpha2.Signal" \x82\xd3\xe4\x93\x02\x1a\x12\x18/v1alpha2/signals:lookup\x12\x8a\x01\n\tGetSignal\x12+.google.cloud.irm.v1alpha2.GetSignalRequest\x1a!.google.cloud.irm.v1alpha2.Signal"-\x82\xd3\xe4\x93\x02\'\x12%/v1alpha2/{name=projects/*/signals/*}\x12\x9f\x01\n\x0cUpdateSignal\x12..google.cloud.irm.v1alpha2.UpdateSignalRequest\x1a!.google.cloud.irm.v1alpha2.Signal"<\x82\xd3\xe4\x93\x02\x36\x32,/v1alpha2/{signal.name=projects/*/signals/*}:\x06signal\x12\xc1\x01\n\x10\x45scalateIncident\x12\x32.google.cloud.irm.v1alpha2.EscalateIncidentRequest\x1a\x33.google.cloud.irm.v1alpha2.EscalateIncidentResponse"D\x82\xd3\xe4\x93\x02>"9/v1alpha2/{incident.name=projects/*/incidents/*}:escalate:\x01*\x12\xae\x01\n\x0e\x43reateArtifact\x12\x30.google.cloud.irm.v1alpha2.CreateArtifactRequest\x1a#.google.cloud.irm.v1alpha2.Artifact"E\x82\xd3\xe4\x93\x02?"3/v1alpha2/{parent=projects/*/incidents/*}/artifacts:\x08\x61rtifact\x12\xaf\x01\n\rListArtifacts\x12/.google.cloud.irm.v1alpha2.ListArtifactsRequest\x1a\x30.google.cloud.irm.v1alpha2.ListArtifactsResponse";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1alpha2/{parent=projects/*/incidents/*}/artifacts\x12\xb7\x01\n\x0eUpdateArtifact\x12\x30.google.cloud.irm.v1alpha2.UpdateArtifactRequest\x1a#.google.cloud.irm.v1alpha2.Artifact"N\x82\xd3\xe4\x93\x02H2</v1alpha2/{artifact.name=projects/*/incidents/*/artifacts/*}:\x08\x61rtifact\x12\x97\x01\n\x0e\x44\x65leteArtifact\x12\x30.google.cloud.irm.v1alpha2.DeleteArtifactRequest\x1a\x16.google.protobuf.Empty";\x82\xd3\xe4\x93\x02\x35*3/v1alpha2/{name=projects/*/incidents/*/artifacts/*}\x12\xb7\x01\n\x10SendShiftHandoff\x12\x32.google.cloud.irm.v1alpha2.SendShiftHandoffRequest\x1a\x33.google.cloud.irm.v1alpha2.SendShiftHandoffResponse":\x82\xd3\xe4\x93\x02\x34"//v1alpha2/{parent=projects/*}/shiftHandoff:send:\x01*\x12\xc2\x01\n\x12\x43reateSubscription\x12\x34.google.cloud.irm.v1alpha2.CreateSubscriptionRequest\x1a\'.google.cloud.irm.v1alpha2.Subscription"M\x82\xd3\xe4\x93\x02G"7/v1alpha2/{parent=projects/*/incidents/*}/subscriptions:\x0csubscription\x12\xcf\x01\n\x12UpdateSubscription\x12\x34.google.cloud.irm.v1alpha2.UpdateSubscriptionRequest\x1a\'.google.cloud.irm.v1alpha2.Subscription"Z\x82\xd3\xe4\x93\x02T2D/v1alpha2/{subscription.name=projects/*/incidents/*/subscriptions/*}:\x0csubscription\x12\xbf\x01\n\x11ListSubscriptions\x12\x33.google.cloud.irm.v1alpha2.ListSubscriptionsRequest\x1a\x34.google.cloud.irm.v1alpha2.ListSubscriptionsResponse"?\x82\xd3\xe4\x93\x02\x39\x12\x37/v1alpha2/{parent=projects/*/incidents/*}/subscriptions\x12\xa3\x01\n\x12\x44\x65leteSubscription\x12\x34.google.cloud.irm.v1alpha2.DeleteSubscriptionRequest\x1a\x16.google.protobuf.Empty"?\x82\xd3\xe4\x93\x02\x39*7/v1alpha2/{name=projects/*/incidents/*/subscriptions/*}\x12\xd7\x01\n\x1c\x43reateIncidentRoleAssignment\x12>.google.cloud.irm.v1alpha2.CreateIncidentRoleAssignmentRequest\x1a\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment"D\x82\xd3\xe4\x93\x02>"9/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments:\x01*\x12\xb9\x01\n\x1c\x44\x65leteIncidentRoleAssignment\x12>.google.cloud.irm.v1alpha2.DeleteIncidentRoleAssignmentRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02;*9/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}\x12\xdf\x01\n\x1bListIncidentRoleAssignments\x12=.google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsRequest\x1a>.google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments\x12\xe5\x01\n\x1bRequestIncidentRoleHandover\x12=.google.cloud.irm.v1alpha2.RequestIncidentRoleHandoverRequest\x1a\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment"T\x82\xd3\xe4\x93\x02N"I/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:requestHandover:\x01*\x12\xe5\x01\n\x1b\x43onfirmIncidentRoleHandover\x12=.google.cloud.irm.v1alpha2.ConfirmIncidentRoleHandoverRequest\x1a\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment"T\x82\xd3\xe4\x93\x02N"I/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:confirmHandover:\x01*\x12\xdf\x01\n\x19\x46orceIncidentRoleHandover\x12;.google.cloud.irm.v1alpha2.ForceIncidentRoleHandoverRequest\x1a\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment"R\x82\xd3\xe4\x93\x02L"G/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:forceHandover:\x01*\x12\xe2\x01\n\x1a\x43\x61ncelIncidentRoleHandover\x12<.google.cloud.irm.v1alpha2.CancelIncidentRoleHandoverRequest\x1a\x31.google.cloud.irm.v1alpha2.IncidentRoleAssignment"S\x82\xd3\xe4\x93\x02M"H/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:cancelHandover:\x01*\x1a\x46\xca\x41\x12irm.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBh\n#com.google.irm.service.v1alpha2.apiP\x01Z<google.golang.org/genproto/googleapis/cloud/irm/v1alpha2;irm\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEINCIDENTREQUEST = _descriptor.Descriptor(
+    name="CreateIncidentRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateIncidentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incident",
+            full_name="google.cloud.irm.v1alpha2.CreateIncidentRequest.incident",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateIncidentRequest.parent",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=286,
+    serialized_end=380,
+)
+
+
+_GETINCIDENTREQUEST = _descriptor.Descriptor(
+    name="GetIncidentRequest",
+    full_name="google.cloud.irm.v1alpha2.GetIncidentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.GetIncidentRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=382,
+    serialized_end=416,
+)
+
+
+_UPDATEINCIDENTREQUEST = _descriptor.Descriptor(
+    name="UpdateIncidentRequest",
+    full_name="google.cloud.irm.v1alpha2.UpdateIncidentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incident",
+            full_name="google.cloud.irm.v1alpha2.UpdateIncidentRequest.incident",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.irm.v1alpha2.UpdateIncidentRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=418,
+    serialized_end=545,
+)
+
+
+_SEARCHSIMILARINCIDENTSREQUEST = _descriptor.Descriptor(
+    name="SearchSimilarIncidentsRequest",
+    full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=547,
+    serialized_end=631,
+)
+
+
+_SEARCHSIMILARINCIDENTSRESPONSE_RESULT = _descriptor.Descriptor(
+    name="Result",
+    full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse.Result",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incident",
+            full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse.Result.incident",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=776,
+    serialized_end=839,
+)
+
+_SEARCHSIMILARINCIDENTSRESPONSE = _descriptor.Descriptor(
+    name="SearchSimilarIncidentsResponse",
+    full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse.results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SEARCHSIMILARINCIDENTSRESPONSE_RESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=634,
+    serialized_end=839,
+)
+
+
+_CREATEANNOTATIONREQUEST = _descriptor.Descriptor(
+    name="CreateAnnotationRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateAnnotationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateAnnotationRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation",
+            full_name="google.cloud.irm.v1alpha2.CreateAnnotationRequest.annotation",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=841,
+    serialized_end=941,
+)
+
+
+_LISTANNOTATIONSREQUEST = _descriptor.Descriptor(
+    name="ListAnnotationsRequest",
+    full_name="google.cloud.irm.v1alpha2.ListAnnotationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.ListAnnotationsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.ListAnnotationsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.ListAnnotationsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=943,
+    serialized_end=1022,
+)
+
+
+_LISTANNOTATIONSRESPONSE = _descriptor.Descriptor(
+    name="ListAnnotationsResponse",
+    full_name="google.cloud.irm.v1alpha2.ListAnnotationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotations",
+            full_name="google.cloud.irm.v1alpha2.ListAnnotationsResponse.annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.ListAnnotationsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1024,
+    serialized_end=1134,
+)
+
+
+_CREATETAGREQUEST = _descriptor.Descriptor(
+    name="CreateTagRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateTagRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateTagRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag",
+            full_name="google.cloud.irm.v1alpha2.CreateTagRequest.tag",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1136,
+    serialized_end=1215,
+)
+
+
+_DELETETAGREQUEST = _descriptor.Descriptor(
+    name="DeleteTagRequest",
+    full_name="google.cloud.irm.v1alpha2.DeleteTagRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.DeleteTagRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1217,
+    serialized_end=1249,
+)
+
+
+_LISTTAGSREQUEST = _descriptor.Descriptor(
+    name="ListTagsRequest",
+    full_name="google.cloud.irm.v1alpha2.ListTagsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.ListTagsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.ListTagsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.ListTagsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1251,
+    serialized_end=1323,
+)
+
+
+_LISTTAGSRESPONSE = _descriptor.Descriptor(
+    name="ListTagsResponse",
+    full_name="google.cloud.irm.v1alpha2.ListTagsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.cloud.irm.v1alpha2.ListTagsResponse.tags",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.ListTagsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1325,
+    serialized_end=1414,
+)
+
+
+_CREATESIGNALREQUEST = _descriptor.Descriptor(
+    name="CreateSignalRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateSignalRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateSignalRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="signal",
+            full_name="google.cloud.irm.v1alpha2.CreateSignalRequest.signal",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1416,
+    serialized_end=1504,
+)
+
+
+_SEARCHSIGNALSREQUEST = _descriptor.Descriptor(
+    name="SearchSignalsRequest",
+    full_name="google.cloud.irm.v1alpha2.SearchSignalsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.SearchSignalsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.irm.v1alpha2.SearchSignalsRequest.query",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.SearchSignalsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.SearchSignalsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1506,
+    serialized_end=1598,
+)
+
+
+_SEARCHSIGNALSRESPONSE = _descriptor.Descriptor(
+    name="SearchSignalsResponse",
+    full_name="google.cloud.irm.v1alpha2.SearchSignalsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="signals",
+            full_name="google.cloud.irm.v1alpha2.SearchSignalsResponse.signals",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.SearchSignalsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1600,
+    serialized_end=1700,
+)
+
+
+_GETSIGNALREQUEST = _descriptor.Descriptor(
+    name="GetSignalRequest",
+    full_name="google.cloud.irm.v1alpha2.GetSignalRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.GetSignalRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1702,
+    serialized_end=1734,
+)
+
+
+_LOOKUPSIGNALREQUEST = _descriptor.Descriptor(
+    name="LookupSignalRequest",
+    full_name="google.cloud.irm.v1alpha2.LookupSignalRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="cscc_finding",
+            full_name="google.cloud.irm.v1alpha2.LookupSignalRequest.cscc_finding",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stackdriver_notification_id",
+            full_name="google.cloud.irm.v1alpha2.LookupSignalRequest.stackdriver_notification_id",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="alternate_id",
+            full_name="google.cloud.irm.v1alpha2.LookupSignalRequest.alternate_id",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1736,
+    serialized_end=1836,
+)
+
+
+_UPDATESIGNALREQUEST = _descriptor.Descriptor(
+    name="UpdateSignalRequest",
+    full_name="google.cloud.irm.v1alpha2.UpdateSignalRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="signal",
+            full_name="google.cloud.irm.v1alpha2.UpdateSignalRequest.signal",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.irm.v1alpha2.UpdateSignalRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1838,
+    serialized_end=1959,
+)
+
+
+_SEARCHINCIDENTSREQUEST = _descriptor.Descriptor(
+    name="SearchIncidentsRequest",
+    full_name="google.cloud.irm.v1alpha2.SearchIncidentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsRequest.query",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_zone",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsRequest.time_zone",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1961,
+    serialized_end=2074,
+)
+
+
+_SEARCHINCIDENTSRESPONSE = _descriptor.Descriptor(
+    name="SearchIncidentsResponse",
+    full_name="google.cloud.irm.v1alpha2.SearchIncidentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incidents",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsResponse.incidents",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.SearchIncidentsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2076,
+    serialized_end=2182,
+)
+
+
+_ESCALATEINCIDENTREQUEST = _descriptor.Descriptor(
+    name="EscalateIncidentRequest",
+    full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incident",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest.incident",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subscriptions",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest.subscriptions",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest.tags",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roles",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest.roles",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="artifacts",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentRequest.artifacts",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2185,
+    serialized_end=2546,
+)
+
+
+_ESCALATEINCIDENTRESPONSE = _descriptor.Descriptor(
+    name="EscalateIncidentResponse",
+    full_name="google.cloud.irm.v1alpha2.EscalateIncidentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incident",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentResponse.incident",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subscriptions",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentResponse.subscriptions",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tags",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentResponse.tags",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roles",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentResponse.roles",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="artifacts",
+            full_name="google.cloud.irm.v1alpha2.EscalateIncidentResponse.artifacts",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2549,
+    serialized_end=2852,
+)
+
+
+_CREATEARTIFACTREQUEST = _descriptor.Descriptor(
+    name="CreateArtifactRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateArtifactRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateArtifactRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="artifact",
+            full_name="google.cloud.irm.v1alpha2.CreateArtifactRequest.artifact",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2854,
+    serialized_end=2948,
+)
+
+
+_LISTARTIFACTSREQUEST = _descriptor.Descriptor(
+    name="ListArtifactsRequest",
+    full_name="google.cloud.irm.v1alpha2.ListArtifactsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.ListArtifactsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.ListArtifactsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.ListArtifactsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2950,
+    serialized_end=3027,
+)
+
+
+_LISTARTIFACTSRESPONSE = _descriptor.Descriptor(
+    name="ListArtifactsResponse",
+    full_name="google.cloud.irm.v1alpha2.ListArtifactsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="artifacts",
+            full_name="google.cloud.irm.v1alpha2.ListArtifactsResponse.artifacts",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.ListArtifactsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3029,
+    serialized_end=3133,
+)
+
+
+_UPDATEARTIFACTREQUEST = _descriptor.Descriptor(
+    name="UpdateArtifactRequest",
+    full_name="google.cloud.irm.v1alpha2.UpdateArtifactRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="artifact",
+            full_name="google.cloud.irm.v1alpha2.UpdateArtifactRequest.artifact",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.irm.v1alpha2.UpdateArtifactRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3135,
+    serialized_end=3262,
+)
+
+
+_DELETEARTIFACTREQUEST = _descriptor.Descriptor(
+    name="DeleteArtifactRequest",
+    full_name="google.cloud.irm.v1alpha2.DeleteArtifactRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.DeleteArtifactRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3264,
+    serialized_end=3301,
+)
+
+
+_SENDSHIFTHANDOFFREQUEST_INCIDENT = _descriptor.Descriptor(
+    name="Incident",
+    full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.Incident",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.Incident.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3549,
+    serialized_end=3573,
+)
+
+_SENDSHIFTHANDOFFREQUEST = _descriptor.Descriptor(
+    name="SendShiftHandoffRequest",
+    full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recipients",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.recipients",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cc",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.cc",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subject",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.subject",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notes_content_type",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.notes_content_type",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notes_content",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.notes_content",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="incidents",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.incidents",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="preview_only",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffRequest.preview_only",
+            index=7,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SENDSHIFTHANDOFFREQUEST_INCIDENT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3304,
+    serialized_end=3573,
+)
+
+
+_SENDSHIFTHANDOFFRESPONSE = _descriptor.Descriptor(
+    name="SendShiftHandoffResponse",
+    full_name="google.cloud.irm.v1alpha2.SendShiftHandoffResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffResponse.content_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.irm.v1alpha2.SendShiftHandoffResponse.content",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3575,
+    serialized_end=3640,
+)
+
+
+_CREATESUBSCRIPTIONREQUEST = _descriptor.Descriptor(
+    name="CreateSubscriptionRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateSubscriptionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateSubscriptionRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.cloud.irm.v1alpha2.CreateSubscriptionRequest.subscription",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3642,
+    serialized_end=3748,
+)
+
+
+_UPDATESUBSCRIPTIONREQUEST = _descriptor.Descriptor(
+    name="UpdateSubscriptionRequest",
+    full_name="google.cloud.irm.v1alpha2.UpdateSubscriptionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.cloud.irm.v1alpha2.UpdateSubscriptionRequest.subscription",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.irm.v1alpha2.UpdateSubscriptionRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3751,
+    serialized_end=3890,
+)
+
+
+_LISTSUBSCRIPTIONSREQUEST = _descriptor.Descriptor(
+    name="ListSubscriptionsRequest",
+    full_name="google.cloud.irm.v1alpha2.ListSubscriptionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.ListSubscriptionsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.ListSubscriptionsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.ListSubscriptionsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3892,
+    serialized_end=3973,
+)
+
+
+_LISTSUBSCRIPTIONSRESPONSE = _descriptor.Descriptor(
+    name="ListSubscriptionsResponse",
+    full_name="google.cloud.irm.v1alpha2.ListSubscriptionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscriptions",
+            full_name="google.cloud.irm.v1alpha2.ListSubscriptionsResponse.subscriptions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.ListSubscriptionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3975,
+    serialized_end=4091,
+)
+
+
+_DELETESUBSCRIPTIONREQUEST = _descriptor.Descriptor(
+    name="DeleteSubscriptionRequest",
+    full_name="google.cloud.irm.v1alpha2.DeleteSubscriptionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.DeleteSubscriptionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4093,
+    serialized_end=4134,
+)
+
+
+_CREATEINCIDENTROLEASSIGNMENTREQUEST = _descriptor.Descriptor(
+    name="CreateIncidentRoleAssignmentRequest",
+    full_name="google.cloud.irm.v1alpha2.CreateIncidentRoleAssignmentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.CreateIncidentRoleAssignmentRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="incident_role_assignment",
+            full_name="google.cloud.irm.v1alpha2.CreateIncidentRoleAssignmentRequest.incident_role_assignment",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4137,
+    serialized_end=4275,
+)
+
+
+_DELETEINCIDENTROLEASSIGNMENTREQUEST = _descriptor.Descriptor(
+    name="DeleteIncidentRoleAssignmentRequest",
+    full_name="google.cloud.irm.v1alpha2.DeleteIncidentRoleAssignmentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.DeleteIncidentRoleAssignmentRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4277,
+    serialized_end=4328,
+)
+
+
+_LISTINCIDENTROLEASSIGNMENTSREQUEST = _descriptor.Descriptor(
+    name="ListIncidentRoleAssignmentsRequest",
+    full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4330,
+    serialized_end=4421,
+)
+
+
+_LISTINCIDENTROLEASSIGNMENTSRESPONSE = _descriptor.Descriptor(
+    name="ListIncidentRoleAssignmentsResponse",
+    full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="incident_role_assignments",
+            full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsResponse.incident_role_assignments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4424,
+    serialized_end=4572,
+)
+
+
+_REQUESTINCIDENTROLEHANDOVERREQUEST = _descriptor.Descriptor(
+    name="RequestIncidentRoleHandoverRequest",
+    full_name="google.cloud.irm.v1alpha2.RequestIncidentRoleHandoverRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.RequestIncidentRoleHandoverRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_assignee",
+            full_name="google.cloud.irm.v1alpha2.RequestIncidentRoleHandoverRequest.new_assignee",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4574,
+    serialized_end=4679,
+)
+
+
+_CONFIRMINCIDENTROLEHANDOVERREQUEST = _descriptor.Descriptor(
+    name="ConfirmIncidentRoleHandoverRequest",
+    full_name="google.cloud.irm.v1alpha2.ConfirmIncidentRoleHandoverRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.ConfirmIncidentRoleHandoverRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_assignee",
+            full_name="google.cloud.irm.v1alpha2.ConfirmIncidentRoleHandoverRequest.new_assignee",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4681,
+    serialized_end=4786,
+)
+
+
+_FORCEINCIDENTROLEHANDOVERREQUEST = _descriptor.Descriptor(
+    name="ForceIncidentRoleHandoverRequest",
+    full_name="google.cloud.irm.v1alpha2.ForceIncidentRoleHandoverRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.ForceIncidentRoleHandoverRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_assignee",
+            full_name="google.cloud.irm.v1alpha2.ForceIncidentRoleHandoverRequest.new_assignee",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4788,
+    serialized_end=4891,
+)
+
+
+_CANCELINCIDENTROLEHANDOVERREQUEST = _descriptor.Descriptor(
+    name="CancelIncidentRoleHandoverRequest",
+    full_name="google.cloud.irm.v1alpha2.CancelIncidentRoleHandoverRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.irm.v1alpha2.CancelIncidentRoleHandoverRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_assignee",
+            full_name="google.cloud.irm.v1alpha2.CancelIncidentRoleHandoverRequest.new_assignee",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4893,
+    serialized_end=4997,
+)
+
+_CREATEINCIDENTREQUEST.fields_by_name[
+    "incident"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT
+)
+_UPDATEINCIDENTREQUEST.fields_by_name[
+    "incident"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT
+)
+_UPDATEINCIDENTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_SEARCHSIMILARINCIDENTSRESPONSE_RESULT.fields_by_name[
+    "incident"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT
+)
+_SEARCHSIMILARINCIDENTSRESPONSE_RESULT.containing_type = _SEARCHSIMILARINCIDENTSRESPONSE
+_SEARCHSIMILARINCIDENTSRESPONSE.fields_by_name[
+    "results"
+].message_type = _SEARCHSIMILARINCIDENTSRESPONSE_RESULT
+_CREATEANNOTATIONREQUEST.fields_by_name[
+    "annotation"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ANNOTATION
+)
+_LISTANNOTATIONSRESPONSE.fields_by_name[
+    "annotations"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ANNOTATION
+)
+_CREATETAGREQUEST.fields_by_name[
+    "tag"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._TAG
+_LISTTAGSRESPONSE.fields_by_name[
+    "tags"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._TAG
+_CREATESIGNALREQUEST.fields_by_name[
+    "signal"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL
+_SEARCHSIGNALSRESPONSE.fields_by_name[
+    "signals"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL
+_LOOKUPSIGNALREQUEST.oneofs_by_name["alternate_id"].fields.append(
+    _LOOKUPSIGNALREQUEST.fields_by_name["cscc_finding"]
+)
+_LOOKUPSIGNALREQUEST.fields_by_name[
+    "cscc_finding"
+].containing_oneof = _LOOKUPSIGNALREQUEST.oneofs_by_name["alternate_id"]
+_LOOKUPSIGNALREQUEST.oneofs_by_name["alternate_id"].fields.append(
+    _LOOKUPSIGNALREQUEST.fields_by_name["stackdriver_notification_id"]
+)
+_LOOKUPSIGNALREQUEST.fields_by_name[
+    "stackdriver_notification_id"
+].containing_oneof = _LOOKUPSIGNALREQUEST.oneofs_by_name["alternate_id"]
+_UPDATESIGNALREQUEST.fields_by_name[
+    "signal"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL
+_UPDATESIGNALREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_SEARCHINCIDENTSRESPONSE.fields_by_name[
+    "incidents"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT
+)
+_ESCALATEINCIDENTREQUEST.fields_by_name[
+    "incident"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT
+)
+_ESCALATEINCIDENTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_ESCALATEINCIDENTREQUEST.fields_by_name[
+    "subscriptions"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION
+)
+_ESCALATEINCIDENTREQUEST.fields_by_name[
+    "tags"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._TAG
+_ESCALATEINCIDENTREQUEST.fields_by_name[
+    "roles"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT
+)
+_ESCALATEINCIDENTREQUEST.fields_by_name[
+    "artifacts"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT
+)
+_ESCALATEINCIDENTRESPONSE.fields_by_name[
+    "incident"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT
+)
+_ESCALATEINCIDENTRESPONSE.fields_by_name[
+    "subscriptions"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION
+)
+_ESCALATEINCIDENTRESPONSE.fields_by_name[
+    "tags"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._TAG
+_ESCALATEINCIDENTRESPONSE.fields_by_name[
+    "roles"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLE
+)
+_ESCALATEINCIDENTRESPONSE.fields_by_name[
+    "artifacts"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT
+)
+_CREATEARTIFACTREQUEST.fields_by_name[
+    "artifact"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT
+)
+_LISTARTIFACTSRESPONSE.fields_by_name[
+    "artifacts"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT
+)
+_UPDATEARTIFACTREQUEST.fields_by_name[
+    "artifact"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT
+)
+_UPDATEARTIFACTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_SENDSHIFTHANDOFFREQUEST_INCIDENT.containing_type = _SENDSHIFTHANDOFFREQUEST
+_SENDSHIFTHANDOFFREQUEST.fields_by_name[
+    "incidents"
+].message_type = _SENDSHIFTHANDOFFREQUEST_INCIDENT
+_CREATESUBSCRIPTIONREQUEST.fields_by_name[
+    "subscription"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION
+)
+_UPDATESUBSCRIPTIONREQUEST.fields_by_name[
+    "subscription"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION
+)
+_UPDATESUBSCRIPTIONREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTSUBSCRIPTIONSRESPONSE.fields_by_name[
+    "subscriptions"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION
+)
+_CREATEINCIDENTROLEASSIGNMENTREQUEST.fields_by_name[
+    "incident_role_assignment"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT
+)
+_LISTINCIDENTROLEASSIGNMENTSRESPONSE.fields_by_name[
+    "incident_role_assignments"
+].message_type = (
+    google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT
+)
+_REQUESTINCIDENTROLEHANDOVERREQUEST.fields_by_name[
+    "new_assignee"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._USER
+_CONFIRMINCIDENTROLEHANDOVERREQUEST.fields_by_name[
+    "new_assignee"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._USER
+_FORCEINCIDENTROLEHANDOVERREQUEST.fields_by_name[
+    "new_assignee"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._USER
+_CANCELINCIDENTROLEHANDOVERREQUEST.fields_by_name[
+    "new_assignee"
+].message_type = google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._USER
+DESCRIPTOR.message_types_by_name["CreateIncidentRequest"] = _CREATEINCIDENTREQUEST
+DESCRIPTOR.message_types_by_name["GetIncidentRequest"] = _GETINCIDENTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateIncidentRequest"] = _UPDATEINCIDENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SearchSimilarIncidentsRequest"
+] = _SEARCHSIMILARINCIDENTSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SearchSimilarIncidentsResponse"
+] = _SEARCHSIMILARINCIDENTSRESPONSE
+DESCRIPTOR.message_types_by_name["CreateAnnotationRequest"] = _CREATEANNOTATIONREQUEST
+DESCRIPTOR.message_types_by_name["ListAnnotationsRequest"] = _LISTANNOTATIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListAnnotationsResponse"] = _LISTANNOTATIONSRESPONSE
+DESCRIPTOR.message_types_by_name["CreateTagRequest"] = _CREATETAGREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTagRequest"] = _DELETETAGREQUEST
+DESCRIPTOR.message_types_by_name["ListTagsRequest"] = _LISTTAGSREQUEST
+DESCRIPTOR.message_types_by_name["ListTagsResponse"] = _LISTTAGSRESPONSE
+DESCRIPTOR.message_types_by_name["CreateSignalRequest"] = _CREATESIGNALREQUEST
+DESCRIPTOR.message_types_by_name["SearchSignalsRequest"] = _SEARCHSIGNALSREQUEST
+DESCRIPTOR.message_types_by_name["SearchSignalsResponse"] = _SEARCHSIGNALSRESPONSE
+DESCRIPTOR.message_types_by_name["GetSignalRequest"] = _GETSIGNALREQUEST
+DESCRIPTOR.message_types_by_name["LookupSignalRequest"] = _LOOKUPSIGNALREQUEST
+DESCRIPTOR.message_types_by_name["UpdateSignalRequest"] = _UPDATESIGNALREQUEST
+DESCRIPTOR.message_types_by_name["SearchIncidentsRequest"] = _SEARCHINCIDENTSREQUEST
+DESCRIPTOR.message_types_by_name["SearchIncidentsResponse"] = _SEARCHINCIDENTSRESPONSE
+DESCRIPTOR.message_types_by_name["EscalateIncidentRequest"] = _ESCALATEINCIDENTREQUEST
+DESCRIPTOR.message_types_by_name["EscalateIncidentResponse"] = _ESCALATEINCIDENTRESPONSE
+DESCRIPTOR.message_types_by_name["CreateArtifactRequest"] = _CREATEARTIFACTREQUEST
+DESCRIPTOR.message_types_by_name["ListArtifactsRequest"] = _LISTARTIFACTSREQUEST
+DESCRIPTOR.message_types_by_name["ListArtifactsResponse"] = _LISTARTIFACTSRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateArtifactRequest"] = _UPDATEARTIFACTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteArtifactRequest"] = _DELETEARTIFACTREQUEST
+DESCRIPTOR.message_types_by_name["SendShiftHandoffRequest"] = _SENDSHIFTHANDOFFREQUEST
+DESCRIPTOR.message_types_by_name["SendShiftHandoffResponse"] = _SENDSHIFTHANDOFFRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "CreateSubscriptionRequest"
+] = _CREATESUBSCRIPTIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateSubscriptionRequest"
+] = _UPDATESUBSCRIPTIONREQUEST
+DESCRIPTOR.message_types_by_name["ListSubscriptionsRequest"] = _LISTSUBSCRIPTIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListSubscriptionsResponse"
+] = _LISTSUBSCRIPTIONSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteSubscriptionRequest"
+] = _DELETESUBSCRIPTIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateIncidentRoleAssignmentRequest"
+] = _CREATEINCIDENTROLEASSIGNMENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteIncidentRoleAssignmentRequest"
+] = _DELETEINCIDENTROLEASSIGNMENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListIncidentRoleAssignmentsRequest"
+] = _LISTINCIDENTROLEASSIGNMENTSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListIncidentRoleAssignmentsResponse"
+] = _LISTINCIDENTROLEASSIGNMENTSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "RequestIncidentRoleHandoverRequest"
+] = _REQUESTINCIDENTROLEHANDOVERREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ConfirmIncidentRoleHandoverRequest"
+] = _CONFIRMINCIDENTROLEHANDOVERREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ForceIncidentRoleHandoverRequest"
+] = _FORCEINCIDENTROLEHANDOVERREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CancelIncidentRoleHandoverRequest"
+] = _CANCELINCIDENTROLEHANDOVERREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateIncidentRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateIncidentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINCIDENTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the CreateIncident method.
+  
+  
+  Attributes:
+      incident:
+          The incident to create.
+      parent:
+          The resource name of the hosting Stackdriver project which the
+          incident belongs to. The name is of the form
+          ``projects/{project_id_or_number}`` .
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateIncidentRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateIncidentRequest)
+
+GetIncidentRequest = _reflection.GeneratedProtocolMessageType(
+    "GetIncidentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINCIDENTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the GetIncident method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.GetIncidentRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetIncidentRequest)
+
+UpdateIncidentRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateIncidentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINCIDENTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the UpdateIncident method.
+  
+  
+  Attributes:
+      incident:
+          The incident to update with the new values.
+      update_mask:
+          List of fields that should be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.UpdateIncidentRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateIncidentRequest)
+
+SearchSimilarIncidentsRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchSimilarIncidentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHSIMILARINCIDENTSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the SearchSimilarIncidents method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the incident or signal, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      page_size:
+          Number of similar incidents to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          'next_page_token'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchSimilarIncidentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchSimilarIncidentsRequest)
+
+SearchSimilarIncidentsResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchSimilarIncidentsResponse",
+    (_message.Message,),
+    dict(
+        Result=_reflection.GeneratedProtocolMessageType(
+            "Result",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHSIMILARINCIDENTSRESPONSE_RESULT,
+                __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+                __doc__="""A single search result, i.e. an incident with (potentially) additional
+    information.
+    
+    
+    Attributes:
+        incident:
+            An incident that is "similar" to the incident or signal
+            specified in the request.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse.Result)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHSIMILARINCIDENTSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the SearchSimilarIncidents method.
+  
+  
+  Attributes:
+      results:
+          The search results, ordered by descending relevance.
+      next_page_token:
+          Page token to fetch the next set of similar incidents.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchSimilarIncidentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchSimilarIncidentsResponse)
+_sym_db.RegisterMessage(SearchSimilarIncidentsResponse.Result)
+
+CreateAnnotationRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateAnnotationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEANNOTATIONREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the CreateAnnotation method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      annotation:
+          Only annotation.content is an input argument.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateAnnotationRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateAnnotationRequest)
+
+ListAnnotationsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAnnotationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTANNOTATIONSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the ListAnnotations method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      page_size:
+          Number of annotations to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListAnnotationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAnnotationsRequest)
+
+ListAnnotationsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAnnotationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTANNOTATIONSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the ListAnnotations method.
+  
+  
+  Attributes:
+      annotations:
+          List of annotations.
+      next_page_token:
+          Page token to fetch the next set of annotations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListAnnotationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAnnotationsResponse)
+
+CreateTagRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTagRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETAGREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the CreateTag method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      tag:
+          Tag to create. Only tag.display_name is an input argument.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateTagRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTagRequest)
+
+DeleteTagRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTagRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETAGREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the DeleteTag method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the tag.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.DeleteTagRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTagRequest)
+
+ListTagsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTagsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTAGSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the ListTagsForIncident method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      page_size:
+          Number of tags to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListTagsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTagsRequest)
+
+ListTagsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTagsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTAGSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the ListTagsForIncident method.
+  
+  
+  Attributes:
+      tags:
+          Tags.
+      next_page_token:
+          Page token to fetch the next set of tags.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListTagsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTagsResponse)
+
+CreateSignalRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSignalRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESIGNALREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the CreateSignal method.
+  
+  
+  Attributes:
+      parent:
+          The resource name of the hosting Stackdriver project which
+          requested signal belongs to.
+      signal:
+          The signal to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateSignalRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSignalRequest)
+
+SearchSignalsRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchSignalsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHSIGNALSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the SearchSignals method.
+  
+  
+  Attributes:
+      parent:
+          The resource name of the hosting Stackdriver project which
+          requested incidents belong to.
+      query:
+          An expression that defines which signals to return.  Search
+          atoms can be used to match certain specific fields. Otherwise,
+          plain text will match text fields in the signal.  Search
+          atoms:  -  ``start`` - (timestamp) The time the signal was
+          created. -  ``title`` - The title of the signal. -
+          ``signal_state`` - ``open`` or ``closed``. State of the
+          signal.    (e.g., ``signal_state:open``)  Timestamp formats:
+          -  yyyy-MM-dd - an absolute date, treated as a calendar-day-
+          wide window.    In other words, the "<" operator will match
+          dates before that date,    the ">" operator will match dates
+          after that date, and the ":"    operator will match the entire
+          day. -  yyyy-MM-ddTHH:mm - Same as above, but with minute
+          resolution. -  yyyy-MM-ddTHH:mm:ss - Same as above, but with
+          second resolution. -  Nd (e.g. 7d) - a relative number of days
+          ago, treated as a moment in    time (as opposed to a day-wide
+          span) a multiple of 24 hours ago (as    opposed to calendar
+          days). In the case of daylight savings time, it    will apply
+          the current timezone to both ends of the range. Note that
+          exact matching (e.g. ``start:7d``) is unlikely to be useful
+          because    that would only match signals created precisely at
+          a particular    instant in time.  The absolute timestamp
+          formats (everything starting with a year) can optionally be
+          followed with a UTC offset in +/-hh:mm format. Also, the 'T'
+          separating dates and times can optionally be replaced with a
+          space. Note that any timestamp containing a space or colon
+          will need to be quoted.  Examples:  -  ``foo`` - matches
+          signals containing the word "foo" -  ``"foo bar"`` - matches
+          signals containing the phrase "foo bar" -  ``foo bar`` or
+          ``foo AND bar`` - matches signals containing the words
+          "foo" and "bar" -  ``foo -bar`` or ``foo AND NOT bar`` -
+          matches signals containing the    word "foo" but not the word
+          "bar" -  ``foo OR bar`` - matches signals containing the word
+          "foo" or the    word "bar" -  ``start>2018-11-28`` - matches
+          signals which started after November    11, 2018. -
+          ``start<=2018-11-28`` - matches signals which started on or
+          before    November 11, 2018. -  ``start:2018-11-28`` - matches
+          signals which started on November 11,  2018.   -
+          ``start>"2018-11-28 01:02:03+04:00"`` - matches signals which
+          started    after November 11, 2018 at 1:02:03 AM according to
+          the UTC+04 time    zone. -  ``start>7d`` - matches signals
+          which started after the point in time    7*24 hours ago -
+          ``start>180d`` - similar to 7d, but likely to cross the
+          daylight    savings time boundary, so the end time will be 1
+          hour different from    "now." -  ``foo AND start>90d AND
+          stage<resolved`` - unresolved signals from    the past 90 days
+          containing the word "foo"
+      page_size:
+          Maximum number of ``signals`` to return in the response.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``. All field values except for page_size
+          and page_token should be the same as the original query (may
+          return an error or unexpected data otherwise).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchSignalsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchSignalsRequest)
+
+SearchSignalsResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchSignalsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHSIGNALSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the SearchSignals method.
+  
+  
+  Attributes:
+      signals:
+          Signals that matched the query in the request.
+      next_page_token:
+          Page token to fetch the next set of signals.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchSignalsResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchSignalsResponse)
+
+GetSignalRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSignalRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSIGNALREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the GetSignal method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the Signal resource, for example,
+          "projects/{project_id}/signals/{signal_id}".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.GetSignalRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSignalRequest)
+
+LookupSignalRequest = _reflection.GeneratedProtocolMessageType(
+    "LookupSignalRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOOKUPSIGNALREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the LookupSignal method.
+  
+  
+  Attributes:
+      alternate_id:
+          Required. The ID to use for lookup.
+      cscc_finding:
+          Full resource name of the CSCC finding id this signal refers
+          to (e.g. "organizations/abc/sources/123/findings/xyz")
+      stackdriver_notification_id:
+          The ID from the Stackdriver Alerting notification.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.LookupSignalRequest)
+    ),
+)
+_sym_db.RegisterMessage(LookupSignalRequest)
+
+UpdateSignalRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSignalRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESIGNALREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the UpdateSignal method.
+  
+  
+  Attributes:
+      signal:
+          The signal to update with the new values.
+      update_mask:
+          List of fields that should be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.UpdateSignalRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSignalRequest)
+
+SearchIncidentsRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchIncidentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHINCIDENTSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the SearchIncidents method.
+  
+  
+  Attributes:
+      parent:
+          The resource name of the hosting Stackdriver project which
+          requested incidents belong to.
+      query:
+          An expression that defines which incidents to return.  Search
+          atoms can be used to match certain specific fields. Otherwise,
+          plain text will match text fields in the incident.  Search
+          atoms: * ``start`` - (timestamp) The time the incident
+          started. * ``stage`` - The stage of the incident, one of
+          detected, triaged, mitigated, resolved, documented, or
+          duplicate (which correspond to values in the Incident.Stage
+          enum). These are ordered, so ``stage<resolved`` is equivalent
+          to ``stage:detected OR stage:triaged OR stage:mitigated``. *
+          ``severity`` - (Incident.Severity) The severity of the
+          incident. + Supports matching on a specific severity (for
+          example, ``severity:major``) or on a range (for example,
+          ``severity>medium``, ``severity<=minor``, etc.).  Timestamp
+          formats: * yyyy-MM-dd - an absolute date, treated as a
+          calendar-day-wide window. In other words, the "<" operator
+          will match dates before that date, the ">" operator will match
+          dates after that date, and the ":" or "=" operators will match
+          the entire day. * Nd (for example, 7d) - a relative number of
+          days ago, treated as a moment in time (as opposed to a day-
+          wide span). A multiple of 24 hours ago (as opposed to calendar
+          days). In the case of daylight savings time, it will apply the
+          current timezone to both ends of the range. Note that exact
+          matching (for example, ``start:7d``) is unlikely to be useful
+          because that would only match incidents created precisely at a
+          particular instant in time.  Examples:  -  ``foo`` - matches
+          incidents containing the word "foo" -  ``"foo bar"`` - matches
+          incidents containing the phrase "foo bar" -  ``foo bar`` or
+          ``foo AND bar`` - matches incidents containing the    words
+          "foo" and "bar" -  ``foo -bar`` or ``foo AND NOT bar`` -
+          matches incidents containing    the word "foo" but not the
+          word "bar" -  ``foo OR bar`` - matches incidents containing
+          the word "foo" or the    word "bar" -  ``start>2018-11-28`` -
+          matches incidents which started after November    11,  2018.
+          -  ``start<=2018-11-28`` - matches incidents which started on
+          or before    November 11, 2018. -  ``start:2018-11-28`` -
+          matches incidents which started on November    11,  2018.   -
+          ``start>7d`` - matches incidents which started after the point
+          in    time 7*24 hours ago -  ``start>180d`` - similar to 7d,
+          but likely to cross the daylight    savings time boundary, so
+          the end time will be 1 hour different from    "now." -  ``foo
+          AND start>90d AND stage<resolved`` - unresolved incidents from
+          the past 90 days containing the word "foo"
+      page_size:
+          Number of incidents to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``.
+      time_zone:
+          The time zone name. It should be an IANA TZ name, such as
+          "America/Los_Angeles". For more information, see https://en.w
+          ikipedia.org/wiki/List_of_tz_database_time_zones. If no
+          time zone is specified, the default is UTC.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchIncidentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchIncidentsRequest)
+
+SearchIncidentsResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchIncidentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHINCIDENTSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the SearchIncidents method.
+  
+  
+  Attributes:
+      incidents:
+          Incidents.
+      next_page_token:
+          Page token to fetch the next set of incidents.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SearchIncidentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchIncidentsResponse)
+
+EscalateIncidentRequest = _reflection.GeneratedProtocolMessageType(
+    "EscalateIncidentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ESCALATEINCIDENTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request to escalate an incident.
+  
+  
+  Attributes:
+      incident:
+          The incident to escalate with the new values.
+      update_mask:
+          List of fields that should be updated.
+      subscriptions:
+          Subscriptions to add or update. Existing subscriptions with
+          the same channel and address as a subscription in the list
+          will be updated.
+      tags:
+          Tags to add. Tags identical to existing tags will be ignored.
+      roles:
+          Roles to add or update. Existing roles with the same type (and
+          title, for TYPE_OTHER roles) will be updated.
+      artifacts:
+          Artifacts to add. All artifacts are added without checking for
+          duplicates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.EscalateIncidentRequest)
+    ),
+)
+_sym_db.RegisterMessage(EscalateIncidentRequest)
+
+EscalateIncidentResponse = _reflection.GeneratedProtocolMessageType(
+    "EscalateIncidentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ESCALATEINCIDENTRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for EscalateIncident.
+  
+  
+  Attributes:
+      incident:
+          The escalated incident.
+      subscriptions:
+          New or modified subscriptions.
+      tags:
+          New or modified tags.
+      roles:
+          New or modified roles.
+      artifacts:
+          New or modified artifacts.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.EscalateIncidentResponse)
+    ),
+)
+_sym_db.RegisterMessage(EscalateIncidentResponse)
+
+CreateArtifactRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateArtifactRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEARTIFACTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the CreateArtifact method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      artifact:
+          The artifact to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateArtifactRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateArtifactRequest)
+
+ListArtifactsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListArtifactsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTARTIFACTSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the ListArtifacts method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      page_size:
+          Number of artifacts to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListArtifactsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListArtifactsRequest)
+
+ListArtifactsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListArtifactsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTARTIFACTSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the ListArtifacts method.
+  
+  
+  Attributes:
+      artifacts:
+          List of artifacts.
+      next_page_token:
+          Page token to fetch the next set of artifacts.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListArtifactsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListArtifactsResponse)
+
+UpdateArtifactRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateArtifactRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEARTIFACTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the UpdateArtifact method.
+  
+  
+  Attributes:
+      artifact:
+          The artifact to update with the new values.
+      update_mask:
+          List of fields that should be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.UpdateArtifactRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateArtifactRequest)
+
+DeleteArtifactRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteArtifactRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEARTIFACTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for deleting an artifact.
+  
+  
+  Attributes:
+      name:
+          Resource name of the artifact.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.DeleteArtifactRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteArtifactRequest)
+
+SendShiftHandoffRequest = _reflection.GeneratedProtocolMessageType(
+    "SendShiftHandoffRequest",
+    (_message.Message,),
+    dict(
+        Incident=_reflection.GeneratedProtocolMessageType(
+            "Incident",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SENDSHIFTHANDOFFREQUEST_INCIDENT,
+                __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+                __doc__="""Describes an incident for inclusion in the handoff. This is wrapped in a
+    message to provide flexibility for potentially attaching additional data
+    to each incident in the future.
+    
+    
+    Attributes:
+        name:
+            Resource name of the incident, for example,
+            "projects/{project_id}/incidents/{incident_id}".
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SendShiftHandoffRequest.Incident)
+            ),
+        ),
+        DESCRIPTOR=_SENDSHIFTHANDOFFREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""SendShiftHandoff and PreviewShiftHandoff RPC request.
+  
+  
+  Attributes:
+      parent:
+          The resource name of the Stackdriver project that the handoff
+          is being sent from. for example, ``projects/{project_id}``
+      recipients:
+          Email addresses of the recipients of the handoff, for example,
+          "user@example.com". Must contain at least one entry.
+      cc:
+          Email addresses that should be CC'd on the handoff. Optional.
+      subject:
+          The subject of the email. Required.
+      notes_content_type:
+          Content type string, for example, 'text/plain' or 'text/html'.
+      notes_content:
+          Additional notes to be included in the handoff. Optional.
+      incidents:
+          The set of incidents that should be included in the handoff.
+          Optional.
+      preview_only:
+          If set to true a ShiftHandoffResponse will be returned but the
+          handoff will not actually be sent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SendShiftHandoffRequest)
+    ),
+)
+_sym_db.RegisterMessage(SendShiftHandoffRequest)
+_sym_db.RegisterMessage(SendShiftHandoffRequest.Incident)
+
+SendShiftHandoffResponse = _reflection.GeneratedProtocolMessageType(
+    "SendShiftHandoffResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENDSHIFTHANDOFFRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""SendShiftHandoff and PreviewShiftHandoff RPC response.
+  
+  
+  Attributes:
+      content_type:
+          Content type string, for example, 'text/plain' or 'text/html'.
+      content:
+          The contents of the handoff that was sent or would have been
+          sent (if the request was preview_only). This will typically
+          contain a full HTML document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.SendShiftHandoffResponse)
+    ),
+)
+_sym_db.RegisterMessage(SendShiftHandoffResponse)
+
+CreateSubscriptionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSubscriptionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESUBSCRIPTIONREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the CreateSubscription method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      subscription:
+          The subscription to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateSubscriptionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSubscriptionRequest)
+
+UpdateSubscriptionRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSubscriptionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESUBSCRIPTIONREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the UpdateSubscription method.
+  
+  
+  Attributes:
+      subscription:
+          The subscription to update, with new values.
+      update_mask:
+          List of fields that should be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.UpdateSubscriptionRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSubscriptionRequest)
+
+ListSubscriptionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSubscriptionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSUBSCRIPTIONSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for the ListSubscriptions method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      page_size:
+          Number of subscriptions to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListSubscriptionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSubscriptionsRequest)
+
+ListSubscriptionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSubscriptionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSUBSCRIPTIONSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the ListSubscriptions method.
+  
+  
+  Attributes:
+      subscriptions:
+          List of subscriptions.
+      next_page_token:
+          Page token to fetch the next set of subscriptions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListSubscriptionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSubscriptionsResponse)
+
+DeleteSubscriptionRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSubscriptionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESUBSCRIPTIONREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for deleting a subscription.
+  
+  
+  Attributes:
+      name:
+          Resource name of the subscription.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.DeleteSubscriptionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSubscriptionRequest)
+
+CreateIncidentRoleAssignmentRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateIncidentRoleAssignmentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINCIDENTROLEASSIGNMENTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for creating a role assignment.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      incident_role_assignment:
+          Role assignment to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CreateIncidentRoleAssignmentRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateIncidentRoleAssignmentRequest)
+
+DeleteIncidentRoleAssignmentRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteIncidentRoleAssignmentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINCIDENTROLEASSIGNMENTREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request for deleting a role assignment.
+  
+  
+  Attributes:
+      name:
+          Resource name of the role assignment.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.DeleteIncidentRoleAssignmentRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteIncidentRoleAssignmentRequest)
+
+ListIncidentRoleAssignmentsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListIncidentRoleAssignmentsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINCIDENTROLEASSIGNMENTSREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request to list role assignments of an incident.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the incident, for example,
+          "projects/{project_id}/incidents/{incident_id}".
+      page_size:
+          Number of assignments to return.
+      page_token:
+          Page token from an earlier query, as returned in
+          ``next_page_token``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListIncidentRoleAssignmentsRequest)
+
+ListIncidentRoleAssignmentsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListIncidentRoleAssignmentsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINCIDENTROLEASSIGNMENTSRESPONSE,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Response for the ListIncidentRoleAssignments method.
+  
+  
+  Attributes:
+      incident_role_assignments:
+          List of assignments.
+      next_page_token:
+          Page token to fetch the next set of assignments.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ListIncidentRoleAssignmentsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListIncidentRoleAssignmentsResponse)
+
+RequestIncidentRoleHandoverRequest = _reflection.GeneratedProtocolMessageType(
+    "RequestIncidentRoleHandoverRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REQUESTINCIDENTROLEHANDOVERREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request to start a role handover.
+  
+  
+  Attributes:
+      name:
+          Resource name of the role assignment.
+      new_assignee:
+          The proposed assignee.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.RequestIncidentRoleHandoverRequest)
+    ),
+)
+_sym_db.RegisterMessage(RequestIncidentRoleHandoverRequest)
+
+ConfirmIncidentRoleHandoverRequest = _reflection.GeneratedProtocolMessageType(
+    "ConfirmIncidentRoleHandoverRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CONFIRMINCIDENTROLEHANDOVERREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request to confirm a role handover.
+  
+  
+  Attributes:
+      name:
+          Resource name of the role assignment.
+      new_assignee:
+          The proposed assignee, who will now be the assignee. This
+          should be the current user; otherwise ForceRoleHandover should
+          be called.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ConfirmIncidentRoleHandoverRequest)
+    ),
+)
+_sym_db.RegisterMessage(ConfirmIncidentRoleHandoverRequest)
+
+ForceIncidentRoleHandoverRequest = _reflection.GeneratedProtocolMessageType(
+    "ForceIncidentRoleHandoverRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FORCEINCIDENTROLEHANDOVERREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request to force a role handover.
+  
+  
+  Attributes:
+      name:
+          Resource name of the role assignment.
+      new_assignee:
+          The proposed assignee, who will now be the assignee. This
+          should not be the current user; otherwise ConfirmRoleHandover
+          should be called.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.ForceIncidentRoleHandoverRequest)
+    ),
+)
+_sym_db.RegisterMessage(ForceIncidentRoleHandoverRequest)
+
+CancelIncidentRoleHandoverRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelIncidentRoleHandoverRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELINCIDENTROLEHANDOVERREQUEST,
+        __module__="google.cloud.irm_v1alpha2.proto.incidents_service_pb2",
+        __doc__="""Request to cancel a role handover.
+  
+  
+  Attributes:
+      name:
+          Resource name of the role assignment.
+      new_assignee:
+          Person who was proposed as the next assignee (i.e.
+          IncidentRoleAssignment.proposed_assignee) and whose proposal
+          is being cancelled.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.irm.v1alpha2.CancelIncidentRoleHandoverRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelIncidentRoleHandoverRequest)
+
+
+DESCRIPTOR._options = None
+
+_INCIDENTSERVICE = _descriptor.ServiceDescriptor(
+    name="IncidentService",
+    full_name="google.cloud.irm.v1alpha2.IncidentService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\022irm.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=5000,
+    serialized_end=11007,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateIncident",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateIncident",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEINCIDENTREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT,
+            serialized_options=_b(
+                "\202\323\344\223\0023\"'/v1alpha2/{parent=projects/*}/incidents:\010incident"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIncident",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.GetIncident",
+            index=1,
+            containing_service=None,
+            input_type=_GETINCIDENTREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT,
+            serialized_options=_b(
+                "\202\323\344\223\002)\022'/v1alpha2/{name=projects/*/incidents/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchIncidents",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.SearchIncidents",
+            index=2,
+            containing_service=None,
+            input_type=_SEARCHINCIDENTSREQUEST,
+            output_type=_SEARCHINCIDENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0020\022./v1alpha2/{parent=projects/*}/incidents:search"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateIncident",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.UpdateIncident",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEINCIDENTREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENT,
+            serialized_options=_b(
+                "\202\323\344\223\002<20/v1alpha2/{incident.name=projects/*/incidents/*}:\010incident"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchSimilarIncidents",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.SearchSimilarIncidents",
+            index=4,
+            containing_service=None,
+            input_type=_SEARCHSIMILARINCIDENTSREQUEST,
+            output_type=_SEARCHSIMILARINCIDENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002w\0225/v1alpha2/{name=projects/*/incidents/*}:searchSimilarZ>\022</v1alpha2/{name=projects/*/signals/*}:searchSimilarIncidents"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateAnnotation",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateAnnotation",
+            index=5,
+            containing_service=None,
+            input_type=_CREATEANNOTATIONREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ANNOTATION,
+            serialized_options=_b(
+                '\202\323\344\223\002C"5/v1alpha2/{parent=projects/*/incidents/*}/annotations:\nannotation'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAnnotations",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ListAnnotations",
+            index=6,
+            containing_service=None,
+            input_type=_LISTANNOTATIONSREQUEST,
+            output_type=_LISTANNOTATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0027\0225/v1alpha2/{parent=projects/*/incidents/*}/annotations"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTag",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateTag",
+            index=7,
+            containing_service=None,
+            input_type=_CREATETAGREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._TAG,
+            serialized_options=_b(
+                '\202\323\344\223\0025"./v1alpha2/{parent=projects/*/incidents/*}/tags:\003tag'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTag",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.DeleteTag",
+            index=8,
+            containing_service=None,
+            input_type=_DELETETAGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0020*./v1alpha2/{name=projects/*/incidents/*/tags/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTags",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ListTags",
+            index=9,
+            containing_service=None,
+            input_type=_LISTTAGSREQUEST,
+            output_type=_LISTTAGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0020\022./v1alpha2/{parent=projects/*/incidents/*}/tags"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateSignal",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateSignal",
+            index=10,
+            containing_service=None,
+            input_type=_CREATESIGNALREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL,
+            serialized_options=_b(
+                '\202\323\344\223\002/"%/v1alpha2/{parent=projects/*}/signals:\006signal'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchSignals",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.SearchSignals",
+            index=11,
+            containing_service=None,
+            input_type=_SEARCHSIGNALSREQUEST,
+            output_type=_SEARCHSIGNALSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v1alpha2/{parent=projects/*}/signals:search"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LookupSignal",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.LookupSignal",
+            index=12,
+            containing_service=None,
+            input_type=_LOOKUPSIGNALREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL,
+            serialized_options=_b(
+                "\202\323\344\223\002\032\022\030/v1alpha2/signals:lookup"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSignal",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.GetSignal",
+            index=13,
+            containing_service=None,
+            input_type=_GETSIGNALREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL,
+            serialized_options=_b(
+                "\202\323\344\223\002'\022%/v1alpha2/{name=projects/*/signals/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSignal",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.UpdateSignal",
+            index=14,
+            containing_service=None,
+            input_type=_UPDATESIGNALREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SIGNAL,
+            serialized_options=_b(
+                "\202\323\344\223\00262,/v1alpha2/{signal.name=projects/*/signals/*}:\006signal"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="EscalateIncident",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.EscalateIncident",
+            index=15,
+            containing_service=None,
+            input_type=_ESCALATEINCIDENTREQUEST,
+            output_type=_ESCALATEINCIDENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002>"9/v1alpha2/{incident.name=projects/*/incidents/*}:escalate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateArtifact",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateArtifact",
+            index=16,
+            containing_service=None,
+            input_type=_CREATEARTIFACTREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT,
+            serialized_options=_b(
+                '\202\323\344\223\002?"3/v1alpha2/{parent=projects/*/incidents/*}/artifacts:\010artifact'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListArtifacts",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ListArtifacts",
+            index=17,
+            containing_service=None,
+            input_type=_LISTARTIFACTSREQUEST,
+            output_type=_LISTARTIFACTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1alpha2/{parent=projects/*/incidents/*}/artifacts"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateArtifact",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.UpdateArtifact",
+            index=18,
+            containing_service=None,
+            input_type=_UPDATEARTIFACTREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._ARTIFACT,
+            serialized_options=_b(
+                "\202\323\344\223\002H2</v1alpha2/{artifact.name=projects/*/incidents/*/artifacts/*}:\010artifact"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteArtifact",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.DeleteArtifact",
+            index=19,
+            containing_service=None,
+            input_type=_DELETEARTIFACTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0025*3/v1alpha2/{name=projects/*/incidents/*/artifacts/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SendShiftHandoff",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.SendShiftHandoff",
+            index=20,
+            containing_service=None,
+            input_type=_SENDSHIFTHANDOFFREQUEST,
+            output_type=_SENDSHIFTHANDOFFRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0024"//v1alpha2/{parent=projects/*}/shiftHandoff:send:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateSubscription",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateSubscription",
+            index=21,
+            containing_service=None,
+            input_type=_CREATESUBSCRIPTIONREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION,
+            serialized_options=_b(
+                '\202\323\344\223\002G"7/v1alpha2/{parent=projects/*/incidents/*}/subscriptions:\014subscription'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSubscription",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.UpdateSubscription",
+            index=22,
+            containing_service=None,
+            input_type=_UPDATESUBSCRIPTIONREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._SUBSCRIPTION,
+            serialized_options=_b(
+                "\202\323\344\223\002T2D/v1alpha2/{subscription.name=projects/*/incidents/*/subscriptions/*}:\014subscription"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSubscriptions",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ListSubscriptions",
+            index=23,
+            containing_service=None,
+            input_type=_LISTSUBSCRIPTIONSREQUEST,
+            output_type=_LISTSUBSCRIPTIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0029\0227/v1alpha2/{parent=projects/*/incidents/*}/subscriptions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSubscription",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.DeleteSubscription",
+            index=24,
+            containing_service=None,
+            input_type=_DELETESUBSCRIPTIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0029*7/v1alpha2/{name=projects/*/incidents/*/subscriptions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateIncidentRoleAssignment",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CreateIncidentRoleAssignment",
+            index=25,
+            containing_service=None,
+            input_type=_CREATEINCIDENTROLEASSIGNMENTREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002>"9/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteIncidentRoleAssignment",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.DeleteIncidentRoleAssignment",
+            index=26,
+            containing_service=None,
+            input_type=_DELETEINCIDENTROLEASSIGNMENTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002;*9/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListIncidentRoleAssignments",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ListIncidentRoleAssignments",
+            index=27,
+            containing_service=None,
+            input_type=_LISTINCIDENTROLEASSIGNMENTSREQUEST,
+            output_type=_LISTINCIDENTROLEASSIGNMENTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RequestIncidentRoleHandover",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.RequestIncidentRoleHandover",
+            index=28,
+            containing_service=None,
+            input_type=_REQUESTINCIDENTROLEHANDOVERREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002N"I/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:requestHandover:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ConfirmIncidentRoleHandover",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ConfirmIncidentRoleHandover",
+            index=29,
+            containing_service=None,
+            input_type=_CONFIRMINCIDENTROLEHANDOVERREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002N"I/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:confirmHandover:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ForceIncidentRoleHandover",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.ForceIncidentRoleHandover",
+            index=30,
+            containing_service=None,
+            input_type=_FORCEINCIDENTROLEHANDOVERREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002L"G/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:forceHandover:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelIncidentRoleHandover",
+            full_name="google.cloud.irm.v1alpha2.IncidentService.CancelIncidentRoleHandover",
+            index=31,
+            containing_service=None,
+            input_type=_CANCELINCIDENTROLEHANDOVERREQUEST,
+            output_type=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2._INCIDENTROLEASSIGNMENT,
+            serialized_options=_b(
+                '\202\323\344\223\002M"H/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:cancelHandover:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_INCIDENTSERVICE)
+
+DESCRIPTOR.services_by_name["IncidentService"] = _INCIDENTSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/irm/google/cloud/irm_v1alpha2/proto/incidents_service_pb2_grpc.py b/irm/google/cloud/irm_v1alpha2/proto/incidents_service_pb2_grpc.py
new file mode 100644
index 000000000000..570540373d4c
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/proto/incidents_service_pb2_grpc.py
@@ -0,0 +1,604 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.irm_v1alpha2.proto import (
+    incidents_pb2 as google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2,
+)
+from google.cloud.irm_v1alpha2.proto import (
+    incidents_service_pb2 as google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class IncidentServiceStub(object):
+    """The Incident API for Incident Response & Management.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateIncident = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateIncident",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateIncidentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Incident.FromString,
+        )
+        self.GetIncident = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/GetIncident",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.GetIncidentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Incident.FromString,
+        )
+        self.SearchIncidents = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/SearchIncidents",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchIncidentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchIncidentsResponse.FromString,
+        )
+        self.UpdateIncident = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/UpdateIncident",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateIncidentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Incident.FromString,
+        )
+        self.SearchSimilarIncidents = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/SearchSimilarIncidents",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSimilarIncidentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSimilarIncidentsResponse.FromString,
+        )
+        self.CreateAnnotation = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateAnnotation",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateAnnotationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Annotation.FromString,
+        )
+        self.ListAnnotations = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ListAnnotations",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListAnnotationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListAnnotationsResponse.FromString,
+        )
+        self.CreateTag = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateTag",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateTagRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Tag.FromString,
+        )
+        self.DeleteTag = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/DeleteTag",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteTagRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListTags = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ListTags",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListTagsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListTagsResponse.FromString,
+        )
+        self.CreateSignal = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateSignal",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateSignalRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.FromString,
+        )
+        self.SearchSignals = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/SearchSignals",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSignalsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSignalsResponse.FromString,
+        )
+        self.LookupSignal = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/LookupSignal",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.LookupSignalRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.FromString,
+        )
+        self.GetSignal = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/GetSignal",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.GetSignalRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.FromString,
+        )
+        self.UpdateSignal = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/UpdateSignal",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateSignalRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.FromString,
+        )
+        self.EscalateIncident = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/EscalateIncident",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.EscalateIncidentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.EscalateIncidentResponse.FromString,
+        )
+        self.CreateArtifact = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateArtifact",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateArtifactRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Artifact.FromString,
+        )
+        self.ListArtifacts = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ListArtifacts",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListArtifactsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListArtifactsResponse.FromString,
+        )
+        self.UpdateArtifact = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/UpdateArtifact",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateArtifactRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Artifact.FromString,
+        )
+        self.DeleteArtifact = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/DeleteArtifact",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteArtifactRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.SendShiftHandoff = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/SendShiftHandoff",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SendShiftHandoffRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SendShiftHandoffResponse.FromString,
+        )
+        self.CreateSubscription = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateSubscription",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateSubscriptionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Subscription.FromString,
+        )
+        self.UpdateSubscription = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/UpdateSubscription",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateSubscriptionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Subscription.FromString,
+        )
+        self.ListSubscriptions = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ListSubscriptions",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListSubscriptionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListSubscriptionsResponse.FromString,
+        )
+        self.DeleteSubscription = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/DeleteSubscription",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteSubscriptionRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateIncidentRoleAssignment = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CreateIncidentRoleAssignment",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateIncidentRoleAssignmentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.FromString,
+        )
+        self.DeleteIncidentRoleAssignment = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/DeleteIncidentRoleAssignment",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteIncidentRoleAssignmentRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListIncidentRoleAssignments = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ListIncidentRoleAssignments",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListIncidentRoleAssignmentsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListIncidentRoleAssignmentsResponse.FromString,
+        )
+        self.RequestIncidentRoleHandover = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/RequestIncidentRoleHandover",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.RequestIncidentRoleHandoverRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.FromString,
+        )
+        self.ConfirmIncidentRoleHandover = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ConfirmIncidentRoleHandover",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ConfirmIncidentRoleHandoverRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.FromString,
+        )
+        self.ForceIncidentRoleHandover = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/ForceIncidentRoleHandover",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ForceIncidentRoleHandoverRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.FromString,
+        )
+        self.CancelIncidentRoleHandover = channel.unary_unary(
+            "/google.cloud.irm.v1alpha2.IncidentService/CancelIncidentRoleHandover",
+            request_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CancelIncidentRoleHandoverRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.FromString,
+        )
+
+
+class IncidentServiceServicer(object):
+    """The Incident API for Incident Response & Management.
+  """
+
+    def CreateIncident(self, request, context):
+        """Creates a new incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIncident(self, request, context):
+        """Returns an incident by name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchIncidents(self, request, context):
+        """Returns a list of incidents.
+    Incidents are ordered by start time, with the most recent incidents first.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateIncident(self, request, context):
+        """Updates an existing incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchSimilarIncidents(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateAnnotation(self, request, context):
+        """Creates an annotation on an existing incident. Only 'text/plain' and
+    'text/markdown' annotations can be created via this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAnnotations(self, request, context):
+        """Lists annotations that are part of an incident. No assumptions should be
+    made on the content-type of the annotation returned.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTag(self, request, context):
+        """Creates a tag on an existing incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTag(self, request, context):
+        """Deletes an existing tag.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTags(self, request, context):
+        """Lists tags that are part of an incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateSignal(self, request, context):
+        """Creates a new signal.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchSignals(self, request, context):
+        """Lists signals that are part of an incident.
+    Signals are returned in reverse chronological order.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LookupSignal(self, request, context):
+        """Finds a signal by other unique IDs.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSignal(self, request, context):
+        """Returns a signal by name.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSignal(self, request, context):
+        """Updates an existing signal (for example, to assign/unassign it to an
+    incident).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def EscalateIncident(self, request, context):
+        """Escalates an incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateArtifact(self, request, context):
+        """Creates a new artifact.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListArtifacts(self, request, context):
+        """Returns a list of artifacts for an incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateArtifact(self, request, context):
+        """Updates an existing artifact.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteArtifact(self, request, context):
+        """Deletes an existing artifact.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SendShiftHandoff(self, request, context):
+        """Sends a summary of the shift for oncall handoff.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateSubscription(self, request, context):
+        """Creates a new subscription.
+    This will fail if:
+    a. there are too many (50) subscriptions in the incident already
+    b. a subscription using the given channel already exists
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSubscription(self, request, context):
+        """Updates a subscription.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSubscriptions(self, request, context):
+        """Returns a list of subscriptions for an incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSubscription(self, request, context):
+        """Deletes an existing subscription.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateIncidentRoleAssignment(self, request, context):
+        """Creates a role assignment on an existing incident. Normally, the user field
+    will be set when assigning a role to oneself, and the next field will be
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteIncidentRoleAssignment(self, request, context):
+        """Deletes an existing role assignment.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListIncidentRoleAssignments(self, request, context):
+        """Lists role assignments that are part of an incident.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RequestIncidentRoleHandover(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ConfirmIncidentRoleHandover(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ForceIncidentRoleHandover(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelIncidentRoleHandover(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_IncidentServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateIncident": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateIncident,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateIncidentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Incident.SerializeToString,
+        ),
+        "GetIncident": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIncident,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.GetIncidentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Incident.SerializeToString,
+        ),
+        "SearchIncidents": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchIncidents,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchIncidentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchIncidentsResponse.SerializeToString,
+        ),
+        "UpdateIncident": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateIncident,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateIncidentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Incident.SerializeToString,
+        ),
+        "SearchSimilarIncidents": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchSimilarIncidents,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSimilarIncidentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSimilarIncidentsResponse.SerializeToString,
+        ),
+        "CreateAnnotation": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateAnnotation,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateAnnotationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Annotation.SerializeToString,
+        ),
+        "ListAnnotations": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAnnotations,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListAnnotationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListAnnotationsResponse.SerializeToString,
+        ),
+        "CreateTag": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTag,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateTagRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Tag.SerializeToString,
+        ),
+        "DeleteTag": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTag,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteTagRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListTags": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTags,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListTagsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListTagsResponse.SerializeToString,
+        ),
+        "CreateSignal": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSignal,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateSignalRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.SerializeToString,
+        ),
+        "SearchSignals": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchSignals,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSignalsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SearchSignalsResponse.SerializeToString,
+        ),
+        "LookupSignal": grpc.unary_unary_rpc_method_handler(
+            servicer.LookupSignal,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.LookupSignalRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.SerializeToString,
+        ),
+        "GetSignal": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSignal,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.GetSignalRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.SerializeToString,
+        ),
+        "UpdateSignal": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSignal,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateSignalRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Signal.SerializeToString,
+        ),
+        "EscalateIncident": grpc.unary_unary_rpc_method_handler(
+            servicer.EscalateIncident,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.EscalateIncidentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.EscalateIncidentResponse.SerializeToString,
+        ),
+        "CreateArtifact": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateArtifact,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateArtifactRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Artifact.SerializeToString,
+        ),
+        "ListArtifacts": grpc.unary_unary_rpc_method_handler(
+            servicer.ListArtifacts,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListArtifactsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListArtifactsResponse.SerializeToString,
+        ),
+        "UpdateArtifact": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateArtifact,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateArtifactRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Artifact.SerializeToString,
+        ),
+        "DeleteArtifact": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteArtifact,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteArtifactRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "SendShiftHandoff": grpc.unary_unary_rpc_method_handler(
+            servicer.SendShiftHandoff,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SendShiftHandoffRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.SendShiftHandoffResponse.SerializeToString,
+        ),
+        "CreateSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSubscription,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateSubscriptionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Subscription.SerializeToString,
+        ),
+        "UpdateSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSubscription,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.UpdateSubscriptionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.Subscription.SerializeToString,
+        ),
+        "ListSubscriptions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSubscriptions,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListSubscriptionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListSubscriptionsResponse.SerializeToString,
+        ),
+        "DeleteSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSubscription,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteSubscriptionRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateIncidentRoleAssignment": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateIncidentRoleAssignment,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CreateIncidentRoleAssignmentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.SerializeToString,
+        ),
+        "DeleteIncidentRoleAssignment": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteIncidentRoleAssignment,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.DeleteIncidentRoleAssignmentRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListIncidentRoleAssignments": grpc.unary_unary_rpc_method_handler(
+            servicer.ListIncidentRoleAssignments,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListIncidentRoleAssignmentsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ListIncidentRoleAssignmentsResponse.SerializeToString,
+        ),
+        "RequestIncidentRoleHandover": grpc.unary_unary_rpc_method_handler(
+            servicer.RequestIncidentRoleHandover,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.RequestIncidentRoleHandoverRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.SerializeToString,
+        ),
+        "ConfirmIncidentRoleHandover": grpc.unary_unary_rpc_method_handler(
+            servicer.ConfirmIncidentRoleHandover,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ConfirmIncidentRoleHandoverRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.SerializeToString,
+        ),
+        "ForceIncidentRoleHandover": grpc.unary_unary_rpc_method_handler(
+            servicer.ForceIncidentRoleHandover,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.ForceIncidentRoleHandoverRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.SerializeToString,
+        ),
+        "CancelIncidentRoleHandover": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelIncidentRoleHandover,
+            request_deserializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__service__pb2.CancelIncidentRoleHandoverRequest.FromString,
+            response_serializer=google_dot_cloud_dot_irm__v1alpha2_dot_proto_dot_incidents__pb2.IncidentRoleAssignment.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.irm.v1alpha2.IncidentService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/irm/google/cloud/irm_v1alpha2/types.py b/irm/google/cloud/irm_v1alpha2/types.py
new file mode 100644
index 000000000000..764dd5c1dd6b
--- /dev/null
+++ b/irm/google/cloud/irm_v1alpha2/types.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.irm_v1alpha2.proto import incidents_pb2
+from google.cloud.irm_v1alpha2.proto import incidents_service_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [empty_pb2, field_mask_pb2, timestamp_pb2]
+
+_local_modules = [incidents_pb2, incidents_service_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.irm_v1alpha2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/irm/noxfile.py b/irm/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/irm/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/irm/setup.cfg b/irm/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/irm/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/irm/setup.py b/irm/setup.py
new file mode 100644
index 000000000000..2348088e4299
--- /dev/null
+++ b/irm/setup.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-irm"
+description = "Stackdriver Incident Response & Managment API client library"
+version = "0.1.0"
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "google-cloud-monitoring>=0.31.1, <0.34",
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.4",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/irm/synth.metadata b/irm/synth.metadata
new file mode 100644
index 000000000000..4650d21844b1
--- /dev/null
+++ b/irm/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:28:51.028503Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "irm",
+        "apiVersion": "v1alpha2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/irm/artman_irm_v1alpha2.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/irm/synth.py b/irm/synth.py
new file mode 100644
index 000000000000..33a329fc1f7b
--- /dev/null
+++ b/irm/synth.py
@@ -0,0 +1,59 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate dlp GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "irm",
+    "v1alpha2",
+    config_path="/google/cloud/irm/artman_irm_v1alpha2.yaml",
+    include_protos=True,
+)
+
+excludes = ["README.rst", "nox*.py", "setup.py", "docs/index.rst"]
+s.move(library, excludes=excludes)
+
+# Fix docstrings
+s.replace("google/**/*.py", r"\\_", "_")
+s.replace("google/**/incidents_service_pb2.py", r"""\\\*""", r"""*""")
+s.replace("google/**/incident_service_client.py", r"""\\\*""", r"""*""")
+s.replace(
+    "google/**/incident_service_client.py",
+    r"""        This will fail if:
+           a\. there are too many \(50\) subscriptions in the incident already
+           b\. a subscription using the given channel already exists""",
+    r"""        This will fail if:
+        a. there are too many (50) subscriptions in the incident already
+        b. a subscription using the given channel already exists""",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/irm/tests/unit/gapic/v1alpha2/test_incident_service_client_v1alpha2.py b/irm/tests/unit/gapic/v1alpha2/test_incident_service_client_v1alpha2.py
new file mode 100644
index 000000000000..fc2486fd0603
--- /dev/null
+++ b/irm/tests/unit/gapic/v1alpha2/test_incident_service_client_v1alpha2.py
@@ -0,0 +1,1500 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import irm_v1alpha2
+from google.cloud.irm_v1alpha2.proto import incidents_pb2
+from google.cloud.irm_v1alpha2.proto import incidents_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestIncidentServiceClient(object):
+    def test_create_incident(self):
+        # Setup Expected Response
+        name = "name3373707"
+        title = "title110371416"
+        etag = "etag3123477"
+        duplicate_incident = "duplicateIncident-316496506"
+        expected_response = {
+            "name": name,
+            "title": title,
+            "etag": etag,
+            "duplicate_incident": duplicate_incident,
+        }
+        expected_response = incidents_pb2.Incident(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        incident = {}
+        parent = client.project_path("[PROJECT]")
+
+        response = client.create_incident(incident, parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateIncidentRequest(
+            incident=incident, parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_incident_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        incident = {}
+        parent = client.project_path("[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.create_incident(incident, parent)
+
+    def test_get_incident(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        title = "title110371416"
+        etag = "etag3123477"
+        duplicate_incident = "duplicateIncident-316496506"
+        expected_response = {
+            "name": name_2,
+            "title": title,
+            "etag": etag,
+            "duplicate_incident": duplicate_incident,
+        }
+        expected_response = incidents_pb2.Incident(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        response = client.get_incident(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.GetIncidentRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_incident_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        with pytest.raises(CustomException):
+            client.get_incident(name)
+
+    def test_search_incidents(self):
+        # Setup Expected Response
+        next_page_token = ""
+        incidents_element = {}
+        incidents = [incidents_element]
+        expected_response = {"next_page_token": next_page_token, "incidents": incidents}
+        expected_response = incidents_service_pb2.SearchIncidentsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.search_incidents(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.incidents[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.SearchIncidentsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_incidents_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.search_incidents(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_incident(self):
+        # Setup Expected Response
+        name = "name3373707"
+        title = "title110371416"
+        etag = "etag3123477"
+        duplicate_incident = "duplicateIncident-316496506"
+        expected_response = {
+            "name": name,
+            "title": title,
+            "etag": etag,
+            "duplicate_incident": duplicate_incident,
+        }
+        expected_response = incidents_pb2.Incident(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        incident = {}
+
+        response = client.update_incident(incident)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.UpdateIncidentRequest(
+            incident=incident
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_incident_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        incident = {}
+
+        with pytest.raises(CustomException):
+            client.update_incident(incident)
+
+    def test_search_similar_incidents(self):
+        # Setup Expected Response
+        next_page_token = ""
+        results_element = {}
+        results = [results_element]
+        expected_response = {"next_page_token": next_page_token, "results": results}
+        expected_response = incidents_service_pb2.SearchSimilarIncidentsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.search_similar_incidents(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.SearchSimilarIncidentsRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_similar_incidents_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.search_similar_incidents(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_annotation(self):
+        # Setup Expected Response
+        name = "name3373707"
+        content = "content951530617"
+        content_type = "contentType831846208"
+        expected_response = {
+            "name": name,
+            "content": content,
+            "content_type": content_type,
+        }
+        expected_response = incidents_pb2.Annotation(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        annotation = {}
+
+        response = client.create_annotation(parent, annotation)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateAnnotationRequest(
+            parent=parent, annotation=annotation
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_annotation_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        annotation = {}
+
+        with pytest.raises(CustomException):
+            client.create_annotation(parent, annotation)
+
+    def test_list_annotations(self):
+        # Setup Expected Response
+        next_page_token = ""
+        annotations_element = {}
+        annotations = [annotations_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "annotations": annotations,
+        }
+        expected_response = incidents_service_pb2.ListAnnotationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_annotations(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.annotations[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ListAnnotationsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_annotations_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_annotations(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_tag(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = incidents_pb2.Tag(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        tag = {}
+
+        response = client.create_tag(parent, tag)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateTagRequest(
+            parent=parent, tag=tag
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_tag_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        tag = {}
+
+        with pytest.raises(CustomException):
+            client.create_tag(parent, tag)
+
+    def test_delete_tag(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.tag_path("[PROJECT]", "[INCIDENT]", "[TAG]")
+
+        client.delete_tag(name)
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.DeleteTagRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_tag_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.tag_path("[PROJECT]", "[INCIDENT]", "[TAG]")
+
+        with pytest.raises(CustomException):
+            client.delete_tag(name)
+
+    def test_list_tags(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tags_element = {}
+        tags = [tags_element]
+        expected_response = {"next_page_token": next_page_token, "tags": tags}
+        expected_response = incidents_service_pb2.ListTagsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_tags(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tags[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ListTagsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tags_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_tags(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_signal(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        incident = "incident86983890"
+        title = "title110371416"
+        content_type = "contentType831846208"
+        content = "content951530617"
+        expected_response = {
+            "name": name,
+            "etag": etag,
+            "incident": incident,
+            "title": title,
+            "content_type": content_type,
+            "content": content,
+        }
+        expected_response = incidents_pb2.Signal(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        signal = {}
+
+        response = client.create_signal(parent, signal)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateSignalRequest(
+            parent=parent, signal=signal
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_signal_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        signal = {}
+
+        with pytest.raises(CustomException):
+            client.create_signal(parent, signal)
+
+    def test_search_signals(self):
+        # Setup Expected Response
+        next_page_token = ""
+        signals_element = {}
+        signals = [signals_element]
+        expected_response = {"next_page_token": next_page_token, "signals": signals}
+        expected_response = incidents_service_pb2.SearchSignalsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.search_signals(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.signals[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.SearchSignalsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_signals_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.search_signals(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_signal(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        etag = "etag3123477"
+        incident = "incident86983890"
+        title = "title110371416"
+        content_type = "contentType831846208"
+        content = "content951530617"
+        expected_response = {
+            "name": name_2,
+            "etag": etag,
+            "incident": incident,
+            "title": title,
+            "content_type": content_type,
+            "content": content,
+        }
+        expected_response = incidents_pb2.Signal(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.signal_path("[PROJECT]", "[SIGNAL]")
+
+        response = client.get_signal(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.GetSignalRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_signal_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.signal_path("[PROJECT]", "[SIGNAL]")
+
+        with pytest.raises(CustomException):
+            client.get_signal(name)
+
+    def test_lookup_signal(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        incident = "incident86983890"
+        title = "title110371416"
+        content_type = "contentType831846208"
+        content = "content951530617"
+        expected_response = {
+            "name": name,
+            "etag": etag,
+            "incident": incident,
+            "title": title,
+            "content_type": content_type,
+            "content": content,
+        }
+        expected_response = incidents_pb2.Signal(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        response = client.lookup_signal()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.LookupSignalRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_lookup_signal_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        with pytest.raises(CustomException):
+            client.lookup_signal()
+
+    def test_update_signal(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        incident = "incident86983890"
+        title = "title110371416"
+        content_type = "contentType831846208"
+        content = "content951530617"
+        expected_response = {
+            "name": name,
+            "etag": etag,
+            "incident": incident,
+            "title": title,
+            "content_type": content_type,
+            "content": content,
+        }
+        expected_response = incidents_pb2.Signal(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        signal = {}
+
+        response = client.update_signal(signal)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.UpdateSignalRequest(signal=signal)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_signal_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        signal = {}
+
+        with pytest.raises(CustomException):
+            client.update_signal(signal)
+
+    def test_escalate_incident(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = incidents_service_pb2.EscalateIncidentResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        incident = {}
+
+        response = client.escalate_incident(incident)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.EscalateIncidentRequest(
+            incident=incident
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_escalate_incident_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        incident = {}
+
+        with pytest.raises(CustomException):
+            client.escalate_incident(incident)
+
+    def test_create_artifact(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        etag = "etag3123477"
+        url = "url116079"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "etag": etag,
+            "url": url,
+        }
+        expected_response = incidents_pb2.Artifact(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        artifact = {}
+
+        response = client.create_artifact(parent, artifact)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateArtifactRequest(
+            parent=parent, artifact=artifact
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_artifact_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        artifact = {}
+
+        with pytest.raises(CustomException):
+            client.create_artifact(parent, artifact)
+
+    def test_list_artifacts(self):
+        # Setup Expected Response
+        next_page_token = ""
+        artifacts_element = {}
+        artifacts = [artifacts_element]
+        expected_response = {"next_page_token": next_page_token, "artifacts": artifacts}
+        expected_response = incidents_service_pb2.ListArtifactsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_artifacts(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.artifacts[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ListArtifactsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_artifacts_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_artifacts(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_artifact(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        etag = "etag3123477"
+        url = "url116079"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "etag": etag,
+            "url": url,
+        }
+        expected_response = incidents_pb2.Artifact(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        artifact = {}
+
+        response = client.update_artifact(artifact)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.UpdateArtifactRequest(
+            artifact=artifact
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_artifact_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        artifact = {}
+
+        with pytest.raises(CustomException):
+            client.update_artifact(artifact)
+
+    def test_delete_artifact(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.artifact_path("[PROJECT]", "[INCIDENT]", "[ARTIFACT]")
+
+        client.delete_artifact(name)
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.DeleteArtifactRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_artifact_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.artifact_path("[PROJECT]", "[INCIDENT]", "[ARTIFACT]")
+
+        with pytest.raises(CustomException):
+            client.delete_artifact(name)
+
+    def test_send_shift_handoff(self):
+        # Setup Expected Response
+        content_type = "contentType831846208"
+        content = "content951530617"
+        expected_response = {"content_type": content_type, "content": content}
+        expected_response = incidents_service_pb2.SendShiftHandoffResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        recipients = []
+        subject = "subject-1867885268"
+
+        response = client.send_shift_handoff(parent, recipients, subject)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.SendShiftHandoffRequest(
+            parent=parent, recipients=recipients, subject=subject
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_send_shift_handoff_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        recipients = []
+        subject = "subject-1867885268"
+
+        with pytest.raises(CustomException):
+            client.send_shift_handoff(parent, recipients, subject)
+
+    def test_create_subscription(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        expected_response = {"name": name, "etag": etag}
+        expected_response = incidents_pb2.Subscription(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        subscription = {}
+
+        response = client.create_subscription(parent, subscription)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateSubscriptionRequest(
+            parent=parent, subscription=subscription
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        subscription = {}
+
+        with pytest.raises(CustomException):
+            client.create_subscription(parent, subscription)
+
+    def test_update_subscription(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        expected_response = {"name": name, "etag": etag}
+        expected_response = incidents_pb2.Subscription(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        subscription = {}
+
+        response = client.update_subscription(subscription)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.UpdateSubscriptionRequest(
+            subscription=subscription
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        subscription = {}
+
+        with pytest.raises(CustomException):
+            client.update_subscription(subscription)
+
+    def test_list_subscriptions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        subscriptions_element = {}
+        subscriptions = [subscriptions_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "subscriptions": subscriptions,
+        }
+        expected_response = incidents_service_pb2.ListSubscriptionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_subscriptions(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.subscriptions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ListSubscriptionsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_subscriptions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_subscriptions(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_subscription(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.subscription_path("[PROJECT]", "[INCIDENT]", "[SUBSCRIPTION]")
+
+        client.delete_subscription(name)
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.DeleteSubscriptionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.subscription_path("[PROJECT]", "[INCIDENT]", "[SUBSCRIPTION]")
+
+        with pytest.raises(CustomException):
+            client.delete_subscription(name)
+
+    def test_create_incident_role_assignment(self):
+        # Setup Expected Response
+        name = "name3373707"
+        etag = "etag3123477"
+        expected_response = {"name": name, "etag": etag}
+        expected_response = incidents_pb2.IncidentRoleAssignment(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        incident_role_assignment = {}
+
+        response = client.create_incident_role_assignment(
+            parent, incident_role_assignment
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CreateIncidentRoleAssignmentRequest(
+            parent=parent, incident_role_assignment=incident_role_assignment
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_incident_role_assignment_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+        incident_role_assignment = {}
+
+        with pytest.raises(CustomException):
+            client.create_incident_role_assignment(parent, incident_role_assignment)
+
+    def test_delete_incident_role_assignment(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+
+        client.delete_incident_role_assignment(name)
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.DeleteIncidentRoleAssignmentRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_incident_role_assignment_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_incident_role_assignment(name)
+
+    def test_list_incident_role_assignments(self):
+        # Setup Expected Response
+        next_page_token = ""
+        incident_role_assignments_element = {}
+        incident_role_assignments = [incident_role_assignments_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "incident_role_assignments": incident_role_assignments,
+        }
+        expected_response = incidents_service_pb2.ListIncidentRoleAssignmentsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_incident_role_assignments(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.incident_role_assignments[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ListIncidentRoleAssignmentsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_incident_role_assignments_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        parent = client.incident_path("[PROJECT]", "[INCIDENT]")
+
+        paged_list_response = client.list_incident_role_assignments(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_request_incident_role_handover(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        etag = "etag3123477"
+        expected_response = {"name": name_2, "etag": etag}
+        expected_response = incidents_pb2.IncidentRoleAssignment(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        response = client.request_incident_role_handover(name, new_assignee)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.RequestIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_request_incident_role_handover_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        with pytest.raises(CustomException):
+            client.request_incident_role_handover(name, new_assignee)
+
+    def test_confirm_incident_role_handover(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        etag = "etag3123477"
+        expected_response = {"name": name_2, "etag": etag}
+        expected_response = incidents_pb2.IncidentRoleAssignment(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        response = client.confirm_incident_role_handover(name, new_assignee)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ConfirmIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_confirm_incident_role_handover_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        with pytest.raises(CustomException):
+            client.confirm_incident_role_handover(name, new_assignee)
+
+    def test_force_incident_role_handover(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        etag = "etag3123477"
+        expected_response = {"name": name_2, "etag": etag}
+        expected_response = incidents_pb2.IncidentRoleAssignment(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        response = client.force_incident_role_handover(name, new_assignee)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.ForceIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_force_incident_role_handover_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        with pytest.raises(CustomException):
+            client.force_incident_role_handover(name, new_assignee)
+
+    def test_cancel_incident_role_handover(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        etag = "etag3123477"
+        expected_response = {"name": name_2, "etag": etag}
+        expected_response = incidents_pb2.IncidentRoleAssignment(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup Request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        response = client.cancel_incident_role_handover(name, new_assignee)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = incidents_service_pb2.CancelIncidentRoleHandoverRequest(
+            name=name, new_assignee=new_assignee
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_incident_role_handover_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = irm_v1alpha2.IncidentServiceClient()
+
+        # Setup request
+        name = client.role_assignment_path(
+            "[PROJECT]", "[INCIDENT]", "[ROLE_ASSIGNMENT]"
+        )
+        new_assignee = {}
+
+        with pytest.raises(CustomException):
+            client.cancel_incident_role_handover(name, new_assignee)
diff --git a/kms/.coveragerc b/kms/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/kms/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/kms/.flake8 b/kms/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/kms/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/kms/.repo-metadata.json b/kms/.repo-metadata.json
new file mode 100644
index 000000000000..7e09b610a16d
--- /dev/null
+++ b/kms/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudkms",
+  "name_pretty": "Google Cloud Key Management Service",
+  "product_documentation": "https://cloud.google.com/kms",
+  "client_documentation": "https://googleapis.dev/python/cloudkms/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5264932",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-kms",
+  "api_id": "cloudkms.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/kms/CHANGELOG.md b/kms/CHANGELOG.md
new file mode 100644
index 000000000000..8cc5c1ee2e8c
--- /dev/null
+++ b/kms/CHANGELOG.md
@@ -0,0 +1,131 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-kms/#history
+
+## 1.2.1
+
+08-12-2019 13:44 PDT
+
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8959](https://github.com/googleapis/google-cloud-python/pull/8959))
+
+### Documentation
+- Fix links to googleapis.dev ([#8998](https://github.com/googleapis/google-cloud-python/pull/8998))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 1.2.0
+
+07-24-2019 16:42 PDT
+
+
+### Implementation Changes
+- Accomodate new location of 'IAMPolicyStub' (via synth). ([#8679](https://github.com/googleapis/google-cloud-python/pull/8679))
+
+### New Features
+- Add 'options_' argument to client's 'get_iam_policy'; pin black version (via synth). ([#8656](https://github.com/googleapis/google-cloud-python/pull/8656))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8514](https://github.com/googleapis/google-cloud-python/pull/8514))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+## 1.1.0
+
+06-27-2019 12:32 PDT
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8395](https://github.com/googleapis/google-cloud-python/pull/8395))
+- Add empty lines (via synth). ([#8062](https://github.com/googleapis/google-cloud-python/pull/8062))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add ability to create keys via import, add crypto algorithms (via synth).  ([#8356](https://github.com/googleapis/google-cloud-python/pull/8356))
+- Retry idempotent codes for Encyrpt, Decrypt, Asymmetric Decrypt, Asymmetric Sign (via synth). ([#7715](https://github.com/googleapis/google-cloud-python/pull/7715))
+- Add CAVIUM_V2_COMPRESSED option to KeyOperationAttestation (via synth). ([#7396](https://github.com/googleapis/google-cloud-python/pull/7396))
+
+### Documentation
+- Update docstrings. ([#7868](https://github.com/googleapis/google-cloud-python/pull/7868))
+- Update information in READMEs to indicate KMS is GA. ([#7840](https://github.com/googleapis/google-cloud-python/pull/7840))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Add disclaimer to auto-generated template files (via synth). ([#8318](https://github.com/googleapis/google-cloud-python/pull/8318))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8245](https://github.com/googleapis/google-cloud-python/pull/8245))
+- Fix coverage in 'types.py'; blacken 'noxfile.py' / 'setup.py' (via synth). ([#8157](https://github.com/googleapis/google-cloud-python/pull/8157))
+- Add nox session `docs`, reorder methods (via synth). ([#7775](https://github.com/googleapis/google-cloud-python/pull/7775))
+- Copy lintified proto files (via synth). ([#7449](https://github.com/googleapis/google-cloud-python/pull/7449))
+
+## 1.0.0
+
+02-13-2019 10:53 PST
+
+### Implementation Changes
+- Remove unused message exports. ([#7270](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7270))
+- Pick up stub docstring fix in GAPIC generator. ([#6974](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6974))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+- Add KMS system test ([#7304](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7304))
+- Add protos as an artifact to library ([#7205](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7205))
+- Update copyright headers
+- Protoc-generated serialization update. ([#7086](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7086))
+
+## 0.2.1
+
+12-18-2018 09:24 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up changes in GAPIC generator. ([#6499](https://github.com/googleapis/google-cloud-python/pull/6499))
+- Fix `client_info` bug, update docstrings. ([#6414](https://github.com/googleapis/google-cloud-python/pull/6414))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Update IAM version in dependencies ([#6362](https://github.com/googleapis/google-cloud-python/pull/6362))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6569](https://github.com/googleapis/google-cloud-python/pull/6569))
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Don't update nox in 'kms/synth.py'. ([#6233](https://github.com/googleapis/google-cloud-python/pull/6233))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Don't scribble on setup.py harder. ([#6064](https://github.com/googleapis/google-cloud-python/pull/6064))
+- Harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6021](https://github.com/googleapis/google-cloud-python/pull/6021))
+- Exclude 'setup.py' from synth. ([#6038](https://github.com/googleapis/google-cloud-python/pull/6038))
+
+## 0.2.0
+
+### Documentation
+- Docs: Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Re-generate library using kms/synth.py ([#5977](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5977))
+- Re-generate library using kms/synth.py ([#5951](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5951))
+- Remove synth fix for replacing `iam_policy_pb2_grpc` ([#5755](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5755))
+
+## 0.1.0
+
+### New Features
+- KMS v1
+
diff --git a/kms/LICENSE b/kms/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/kms/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/kms/MANIFEST.in b/kms/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/kms/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/kms/README.rst b/kms/README.rst
new file mode 100644
index 000000000000..d1a48ae0fcab
--- /dev/null
+++ b/kms/README.rst
@@ -0,0 +1,89 @@
+Python Client for Cloud Key Management Service (KMS) API
+========================================================
+
+|GA| |pypi| |versions| 
+
+`Cloud Key Management Service (KMS) API`_: Manages keys and performs
+cryptographic operations in a central cloud service, for direct use by other
+cloud resources and applications.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availabilityt
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-kms.svg
+   :target: https://pypi.org/project/google-cloud-kms/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-kms.svg
+   :target: https://pypi.org/project/google-cloud-kms/
+.. _Cloud Key Management Service (KMS) API: https://cloud.google.com/kms
+.. _Client Library Documentation: https://googleapis.dev/python/cloudkms/latest
+.. _Product Documentation:  https://cloud.google.com/kms
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Key Management Service (KMS) API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Key Management Service (KMS) API.:  https://cloud.google.com/kms
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-kms
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-kms
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ to see other available methods on
+   the client.
+-  Read the `Product Documentation`_ to learn more about the product and see
+   How-to Guides.
+
diff --git a/kms/docs/README.rst b/kms/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/kms/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/kms/docs/changelog.md b/kms/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/kms/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/kms/docs/conf.py b/kms/docs/conf.py
new file mode 100644
index 000000000000..934d87ed45a3
--- /dev/null
+++ b/kms/docs/conf.py
@@ -0,0 +1,350 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-kms documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-kms"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-kms-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-kms.tex",
+        u"google-cloud-kms Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-kms", u"google-cloud-kms Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-kms",
+        u"google-cloud-kms Documentation",
+        author,
+        "google-cloud-kms",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/kms/docs/gapic/v1/api.rst b/kms/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..cb91e8588bd0
--- /dev/null
+++ b/kms/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Key Management Service (KMS) API
+=================================================
+
+.. automodule:: google.cloud.kms_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/kms/docs/gapic/v1/types.rst b/kms/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..b04846228f17
--- /dev/null
+++ b/kms/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Key Management Service (KMS) API Client
+=======================================================
+
+.. automodule:: google.cloud.kms_v1.types
+    :members:
\ No newline at end of file
diff --git a/kms/docs/index.rst b/kms/docs/index.rst
new file mode 100644
index 000000000000..7ae49b7a9bb3
--- /dev/null
+++ b/kms/docs/index.rst
@@ -0,0 +1,21 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1/api
+   gapic/v1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-kms`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/kms/google/__init__.py b/kms/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/kms/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/kms/google/cloud/__init__.py b/kms/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/kms/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/kms/google/cloud/kms.py b/kms/google/cloud/kms.py
new file mode 100644
index 000000000000..24b1655c0b98
--- /dev/null
+++ b/kms/google/cloud/kms.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.kms_v1 import KeyManagementServiceClient
+from google.cloud.kms_v1 import enums
+from google.cloud.kms_v1 import types
+
+
+__all__ = ("enums", "types", "KeyManagementServiceClient")
diff --git a/kms/google/cloud/kms_v1/__init__.py b/kms/google/cloud/kms_v1/__init__.py
new file mode 100644
index 000000000000..3156b3eb188d
--- /dev/null
+++ b/kms/google/cloud/kms_v1/__init__.py
@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.kms_v1 import types
+from google.cloud.kms_v1.gapic import enums
+from google.cloud.kms_v1.gapic import key_management_service_client
+
+
+class KeyManagementServiceClient(
+    key_management_service_client.KeyManagementServiceClient
+):
+    __doc__ = key_management_service_client.KeyManagementServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "KeyManagementServiceClient")
diff --git a/kms/google/cloud/kms_v1/gapic/__init__.py b/kms/google/cloud/kms_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/kms/google/cloud/kms_v1/gapic/enums.py b/kms/google/cloud/kms_v1/gapic/enums.py
new file mode 100644
index 000000000000..894087ddacfa
--- /dev/null
+++ b/kms/google/cloud/kms_v1/gapic/enums.py
@@ -0,0 +1,248 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ProtectionLevel(enum.IntEnum):
+    """
+    ``ProtectionLevel`` specifies how cryptographic operations are
+    performed. For more information, see [Protection levels]
+    (https://cloud.google.com/kms/docs/algorithms#protection\_levels).
+
+    Attributes:
+      PROTECTION_LEVEL_UNSPECIFIED (int): Not specified.
+      SOFTWARE (int): Crypto operations are performed in software.
+      HSM (int): Crypto operations are performed in a Hardware Security Module.
+    """
+
+    PROTECTION_LEVEL_UNSPECIFIED = 0
+    SOFTWARE = 1
+    HSM = 2
+
+
+class CryptoKey(object):
+    class CryptoKeyPurpose(enum.IntEnum):
+        """
+        ``CryptoKeyPurpose`` describes the cryptographic capabilities of a
+        ``CryptoKey``. A given key can only be used for the operations allowed
+        by its purpose. For more information, see `Key
+        purposes <https://cloud.google.com/kms/docs/algorithms#key_purposes>`__.
+
+        Attributes:
+          CRYPTO_KEY_PURPOSE_UNSPECIFIED (int): Not specified.
+          ENCRYPT_DECRYPT (int): ``CryptoKeys`` with this purpose may be used with ``Encrypt`` and
+          ``Decrypt``.
+          ASYMMETRIC_SIGN (int): ``CryptoKeys`` with this purpose may be used with ``AsymmetricSign`` and
+          ``GetPublicKey``.
+          ASYMMETRIC_DECRYPT (int): ``CryptoKeys`` with this purpose may be used with ``AsymmetricDecrypt``
+          and ``GetPublicKey``.
+        """
+
+        CRYPTO_KEY_PURPOSE_UNSPECIFIED = 0
+        ENCRYPT_DECRYPT = 1
+        ASYMMETRIC_SIGN = 5
+        ASYMMETRIC_DECRYPT = 6
+
+
+class CryptoKeyVersion(object):
+    class CryptoKeyVersionAlgorithm(enum.IntEnum):
+        """
+        The algorithm of the ``CryptoKeyVersion``, indicating what parameters
+        must be used for each cryptographic operation.
+
+        The ``GOOGLE_SYMMETRIC_ENCRYPTION`` algorithm is usable with
+        ``CryptoKey.purpose`` ``ENCRYPT_DECRYPT``.
+
+        Algorithms beginning with "RSA\_SIGN\_" are usable with
+        ``CryptoKey.purpose`` ``ASYMMETRIC_SIGN``.
+
+        The fields in the name after "RSA\_SIGN\_" correspond to the following
+        parameters: padding algorithm, modulus bit length, and digest algorithm.
+
+        For PSS, the salt length used is equal to the length of digest
+        algorithm. For example, ``RSA_SIGN_PSS_2048_SHA256`` will use PSS with a
+        salt length of 256 bits or 32 bytes.
+
+        Algorithms beginning with "RSA\_DECRYPT\_" are usable with
+        ``CryptoKey.purpose`` ``ASYMMETRIC_DECRYPT``.
+
+        The fields in the name after "RSA\_DECRYPT\_" correspond to the
+        following parameters: padding algorithm, modulus bit length, and digest
+        algorithm.
+
+        Algorithms beginning with "EC\_SIGN\_" are usable with
+        ``CryptoKey.purpose`` ``ASYMMETRIC_SIGN``.
+
+        The fields in the name after "EC\_SIGN\_" correspond to the following
+        parameters: elliptic curve, digest algorithm.
+
+        For more information, see [Key purposes and algorithms]
+        (https://cloud.google.com/kms/docs/algorithms).
+
+        Attributes:
+          CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED (int): Not specified.
+          GOOGLE_SYMMETRIC_ENCRYPTION (int): Creates symmetric encryption keys.
+          RSA_SIGN_PSS_2048_SHA256 (int): RSASSA-PSS 2048 bit key with a SHA256 digest.
+          RSA_SIGN_PSS_3072_SHA256 (int): RSASSA-PSS 3072 bit key with a SHA256 digest.
+          RSA_SIGN_PSS_4096_SHA256 (int): RSASSA-PSS 4096 bit key with a SHA256 digest.
+          RSA_SIGN_PSS_4096_SHA512 (int): RSASSA-PSS 4096 bit key with a SHA512 digest.
+          RSA_SIGN_PKCS1_2048_SHA256 (int): RSASSA-PKCS1-v1\_5 with a 2048 bit key and a SHA256 digest.
+          RSA_SIGN_PKCS1_3072_SHA256 (int): RSASSA-PKCS1-v1\_5 with a 3072 bit key and a SHA256 digest.
+          RSA_SIGN_PKCS1_4096_SHA256 (int): RSASSA-PKCS1-v1\_5 with a 4096 bit key and a SHA256 digest.
+          RSA_SIGN_PKCS1_4096_SHA512 (int): RSASSA-PKCS1-v1\_5 with a 4096 bit key and a SHA512 digest.
+          RSA_DECRYPT_OAEP_2048_SHA256 (int): RSAES-OAEP 2048 bit key with a SHA256 digest.
+          RSA_DECRYPT_OAEP_3072_SHA256 (int): RSAES-OAEP 3072 bit key with a SHA256 digest.
+          RSA_DECRYPT_OAEP_4096_SHA256 (int): RSAES-OAEP 4096 bit key with a SHA256 digest.
+          RSA_DECRYPT_OAEP_4096_SHA512 (int): RSAES-OAEP 4096 bit key with a SHA512 digest.
+          EC_SIGN_P256_SHA256 (int): ECDSA on the NIST P-256 curve with a SHA256 digest.
+          EC_SIGN_P384_SHA384 (int): ECDSA on the NIST P-384 curve with a SHA384 digest.
+        """
+
+        CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED = 0
+        GOOGLE_SYMMETRIC_ENCRYPTION = 1
+        RSA_SIGN_PSS_2048_SHA256 = 2
+        RSA_SIGN_PSS_3072_SHA256 = 3
+        RSA_SIGN_PSS_4096_SHA256 = 4
+        RSA_SIGN_PSS_4096_SHA512 = 15
+        RSA_SIGN_PKCS1_2048_SHA256 = 5
+        RSA_SIGN_PKCS1_3072_SHA256 = 6
+        RSA_SIGN_PKCS1_4096_SHA256 = 7
+        RSA_SIGN_PKCS1_4096_SHA512 = 16
+        RSA_DECRYPT_OAEP_2048_SHA256 = 8
+        RSA_DECRYPT_OAEP_3072_SHA256 = 9
+        RSA_DECRYPT_OAEP_4096_SHA256 = 10
+        RSA_DECRYPT_OAEP_4096_SHA512 = 17
+        EC_SIGN_P256_SHA256 = 12
+        EC_SIGN_P384_SHA384 = 13
+
+    class CryptoKeyVersionState(enum.IntEnum):
+        """
+        The state of a ``CryptoKeyVersion``, indicating if it can be used.
+
+        Attributes:
+          CRYPTO_KEY_VERSION_STATE_UNSPECIFIED (int): Not specified.
+          PENDING_GENERATION (int): This version is still being generated. It may not be used, enabled,
+          disabled, or destroyed yet. Cloud KMS will automatically mark this
+          version ``ENABLED`` as soon as the version is ready.
+          ENABLED (int): This version may be used for cryptographic operations.
+          DISABLED (int): This version may not be used, but the key material is still available,
+          and the version can be placed back into the ``ENABLED`` state.
+          DESTROYED (int): This version is destroyed, and the key material is no longer stored.
+          A version may not leave this state once entered.
+          DESTROY_SCHEDULED (int): This version is scheduled for destruction, and will be destroyed soon.
+          Call ``RestoreCryptoKeyVersion`` to put it back into the ``DISABLED``
+          state.
+          PENDING_IMPORT (int): This version is still being imported. It may not be used, enabled,
+          disabled, or destroyed yet. Cloud KMS will automatically mark this
+          version ``ENABLED`` as soon as the version is ready.
+          IMPORT_FAILED (int): This version was not imported successfully. It may not be used, enabled,
+          disabled, or destroyed. The submitted key material has been discarded.
+          Additional details can be found in
+          ``CryptoKeyVersion.import_failure_reason``.
+        """
+
+        CRYPTO_KEY_VERSION_STATE_UNSPECIFIED = 0
+        PENDING_GENERATION = 5
+        ENABLED = 1
+        DISABLED = 2
+        DESTROYED = 3
+        DESTROY_SCHEDULED = 4
+        PENDING_IMPORT = 6
+        IMPORT_FAILED = 7
+
+    class CryptoKeyVersionView(enum.IntEnum):
+        """
+        A view for ``CryptoKeyVersion``\ s. Controls the level of detail
+        returned for ``CryptoKeyVersions`` in
+        ``KeyManagementService.ListCryptoKeyVersions`` and
+        ``KeyManagementService.ListCryptoKeys``.
+
+        Attributes:
+          CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED (int): Default view for each ``CryptoKeyVersion``. Does not include the
+          ``attestation`` field.
+          FULL (int): Provides all fields in each ``CryptoKeyVersion``, including the
+          ``attestation``.
+        """
+
+        CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED = 0
+        FULL = 1
+
+
+class ImportJob(object):
+    class ImportJobState(enum.IntEnum):
+        """
+        The state of the ``ImportJob``, indicating if it can be used.
+
+        Attributes:
+          IMPORT_JOB_STATE_UNSPECIFIED (int): Not specified.
+          PENDING_GENERATION (int): The wrapping key for this job is still being generated. It may not be
+          used. Cloud KMS will automatically mark this job as ``ACTIVE`` as soon
+          as the wrapping key is generated.
+          ACTIVE (int): This job may be used in ``CreateCryptoKey`` and
+          ``CreateCryptoKeyVersion`` requests.
+          EXPIRED (int): This job can no longer be used and may not leave this state once entered.
+        """
+
+        IMPORT_JOB_STATE_UNSPECIFIED = 0
+        PENDING_GENERATION = 1
+        ACTIVE = 2
+        EXPIRED = 3
+
+    class ImportMethod(enum.IntEnum):
+        """
+        ``ImportMethod`` describes the key wrapping method chosen for this
+        ``ImportJob``.
+
+        Attributes:
+          IMPORT_METHOD_UNSPECIFIED (int): Not specified.
+          RSA_OAEP_3072_SHA1_AES_256 (int): This ImportMethod represents the CKM\_RSA\_AES\_KEY\_WRAP key wrapping
+          scheme defined in the PKCS #11 standard. In summary, this involves
+          wrapping the raw key with an ephemeral AES key, and wrapping the
+          ephemeral AES key with a 3072 bit RSA key. For more details, see `RSA
+          AES key wrap
+          mechanism <http://docs.oasis-open.org/pkcs11/pkcs11-curr/v2.40/cos01/pkcs11-curr-v2.40-cos01.html#_Toc408226908>`__.
+          RSA_OAEP_4096_SHA1_AES_256 (int): This ImportMethod represents the CKM\_RSA\_AES\_KEY\_WRAP key wrapping
+          scheme defined in the PKCS #11 standard. In summary, this involves
+          wrapping the raw key with an ephemeral AES key, and wrapping the
+          ephemeral AES key with a 4096 bit RSA key. For more details, see `RSA
+          AES key wrap
+          mechanism <http://docs.oasis-open.org/pkcs11/pkcs11-curr/v2.40/cos01/pkcs11-curr-v2.40-cos01.html#_Toc408226908>`__.
+        """
+
+        IMPORT_METHOD_UNSPECIFIED = 0
+        RSA_OAEP_3072_SHA1_AES_256 = 1
+        RSA_OAEP_4096_SHA1_AES_256 = 2
+
+
+class KeyOperationAttestation(object):
+    class AttestationFormat(enum.IntEnum):
+        """
+        Attestation formats provided by the HSM.
+
+        Attributes:
+          ATTESTATION_FORMAT_UNSPECIFIED (int): Not specified.
+          CAVIUM_V1_COMPRESSED (int): Cavium HSM attestation compressed with gzip. Note that this format is
+          defined by Cavium and subject to change at any time.
+          CAVIUM_V2_COMPRESSED (int): Cavium HSM attestation V2 compressed with gzip. This is a new format
+          introduced in Cavium's version 3.2-08.
+        """
+
+        ATTESTATION_FORMAT_UNSPECIFIED = 0
+        CAVIUM_V1_COMPRESSED = 3
+        CAVIUM_V2_COMPRESSED = 4
diff --git a/kms/google/cloud/kms_v1/gapic/key_management_service_client.py b/kms/google/cloud/kms_v1/gapic/key_management_service_client.py
new file mode 100644
index 000000000000..05a284b0172f
--- /dev/null
+++ b/kms/google/cloud/kms_v1/gapic/key_management_service_client.py
@@ -0,0 +1,2526 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.kms.v1 KeyManagementService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.kms_v1.gapic import enums
+from google.cloud.kms_v1.gapic import key_management_service_client_config
+from google.cloud.kms_v1.gapic.transports import key_management_service_grpc_transport
+from google.cloud.kms_v1.proto import resources_pb2
+from google.cloud.kms_v1.proto import service_pb2
+from google.cloud.kms_v1.proto import service_pb2_grpc
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import iam_policy_pb2_grpc
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-kms").version
+
+
+class KeyManagementServiceClient(object):
+    """
+    Google Cloud Key Management Service
+
+    Manages cryptographic keys and operations using those keys. Implements a
+    REST model with the following objects:
+
+    -  ``KeyRing``
+    -  ``CryptoKey``
+    -  ``CryptoKeyVersion``
+
+    If you are using manual gRPC libraries, see `Using gRPC with Cloud
+    KMS <https://cloud.google.com/kms/docs/grpc>`__.
+    """
+
+    SERVICE_ADDRESS = "cloudkms.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.kms.v1.KeyManagementService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            KeyManagementServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def crypto_key_path(cls, project, location, key_ring, crypto_key):
+        """Return a fully-qualified crypto_key string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}",
+            project=project,
+            location=location,
+            key_ring=key_ring,
+            crypto_key=crypto_key,
+        )
+
+    @classmethod
+    def crypto_key_path_path(cls, project, location, key_ring, crypto_key_path):
+        """Return a fully-qualified crypto_key_path string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key_path=**}",
+            project=project,
+            location=location,
+            key_ring=key_ring,
+            crypto_key_path=crypto_key_path,
+        )
+
+    @classmethod
+    def crypto_key_version_path(
+        cls, project, location, key_ring, crypto_key, crypto_key_version
+    ):
+        """Return a fully-qualified crypto_key_version string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}",
+            project=project,
+            location=location,
+            key_ring=key_ring,
+            crypto_key=crypto_key,
+            crypto_key_version=crypto_key_version,
+        )
+
+    @classmethod
+    def import_job_path(cls, project, location, key_ring, import_job):
+        """Return a fully-qualified import_job string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/keyRings/{key_ring}/importJobs/{import_job}",
+            project=project,
+            location=location,
+            key_ring=key_ring,
+            import_job=import_job,
+        )
+
+    @classmethod
+    def key_ring_path(cls, project, location, key_ring):
+        """Return a fully-qualified key_ring string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/keyRings/{key_ring}",
+            project=project,
+            location=location,
+            key_ring=key_ring,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.KeyManagementServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.KeyManagementServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = key_management_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=key_management_service_grpc_transport.KeyManagementServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = key_management_service_grpc_transport.KeyManagementServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_key_rings(
+        self,
+        parent,
+        page_size=None,
+        filter_=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ``KeyRings``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_key_rings(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_key_rings(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The resource name of the location associated with the
+                ``KeyRings``, in the format ``projects/*/locations/*``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            filter_ (str): Optional. Only include resources that match the filter in the response.
+            order_by (str): Optional. Specify how the results should be sorted. If not specified, the
+                results will be sorted in the default order.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.kms_v1.types.KeyRing` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_key_rings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_key_rings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_key_rings,
+                default_retry=self._method_configs["ListKeyRings"].retry,
+                default_timeout=self._method_configs["ListKeyRings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListKeyRingsRequest(
+            parent=parent, page_size=page_size, filter=filter_, order_by=order_by
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_key_rings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="key_rings",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_import_jobs(
+        self,
+        parent,
+        page_size=None,
+        filter_=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ``ImportJobs``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_import_jobs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_import_jobs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The resource name of the ``KeyRing`` to list, in the format
+                ``projects/*/locations/*/keyRings/*``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            filter_ (str): Optional. Only include resources that match the filter in the response.
+            order_by (str): Optional. Specify how the results should be sorted. If not specified, the
+                results will be sorted in the default order.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.kms_v1.types.ImportJob` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_import_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_import_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_import_jobs,
+                default_retry=self._method_configs["ListImportJobs"].retry,
+                default_timeout=self._method_configs["ListImportJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListImportJobsRequest(
+            parent=parent, page_size=page_size, filter=filter_, order_by=order_by
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_import_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="import_jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_crypto_keys(
+        self,
+        parent,
+        page_size=None,
+        version_view=None,
+        filter_=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ``CryptoKeys``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_crypto_keys(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_crypto_keys(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The resource name of the ``KeyRing`` to list, in the format
+                ``projects/*/locations/*/keyRings/*``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            version_view (~google.cloud.kms_v1.types.CryptoKeyVersionView): The fields of the primary version to include in the response.
+            filter_ (str): Optional. Only include resources that match the filter in the response.
+            order_by (str): Optional. Specify how the results should be sorted. If not specified, the
+                results will be sorted in the default order.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.kms_v1.types.CryptoKey` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_crypto_keys" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_crypto_keys"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_crypto_keys,
+                default_retry=self._method_configs["ListCryptoKeys"].retry,
+                default_timeout=self._method_configs["ListCryptoKeys"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListCryptoKeysRequest(
+            parent=parent,
+            page_size=page_size,
+            version_view=version_view,
+            filter=filter_,
+            order_by=order_by,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_crypto_keys"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="crypto_keys",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_crypto_key_versions(
+        self,
+        parent,
+        page_size=None,
+        view=None,
+        filter_=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ``CryptoKeyVersions``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.crypto_key_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_crypto_key_versions(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_crypto_key_versions(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The resource name of the ``CryptoKey`` to list, in the format
+                ``projects/*/locations/*/keyRings/*/cryptoKeys/*``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            view (~google.cloud.kms_v1.types.CryptoKeyVersionView): The fields to include in the response.
+            filter_ (str): Optional. Only include resources that match the filter in the response.
+            order_by (str): Optional. Specify how the results should be sorted. If not specified, the
+                results will be sorted in the default order.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_crypto_key_versions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_crypto_key_versions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_crypto_key_versions,
+                default_retry=self._method_configs["ListCryptoKeyVersions"].retry,
+                default_timeout=self._method_configs["ListCryptoKeyVersions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.ListCryptoKeyVersionsRequest(
+            parent=parent,
+            page_size=page_size,
+            view=view,
+            filter=filter_,
+            order_by=order_by,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_crypto_key_versions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="crypto_key_versions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_key_ring(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns metadata for a given ``KeyRing``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>>
+            >>> response = client.get_key_ring(name)
+
+        Args:
+            name (str): The ``name`` of the ``KeyRing`` to get.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.KeyRing` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_key_ring" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_key_ring"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_key_ring,
+                default_retry=self._method_configs["GetKeyRing"].retry,
+                default_timeout=self._method_configs["GetKeyRing"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetKeyRingRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_key_ring"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_import_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns metadata for a given ``ImportJob``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.import_job_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[IMPORT_JOB]')
+            >>>
+            >>> response = client.get_import_job(name)
+
+        Args:
+            name (str): The ``name`` of the ``ImportJob`` to get.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.ImportJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_import_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_import_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_import_job,
+                default_retry=self._method_configs["GetImportJob"].retry,
+                default_timeout=self._method_configs["GetImportJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetImportJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_import_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_crypto_key(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns metadata for a given ``CryptoKey``, as well as its ``primary``
+        ``CryptoKeyVersion``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]')
+            >>>
+            >>> response = client.get_crypto_key(name)
+
+        Args:
+            name (str): The ``name`` of the ``CryptoKey`` to get.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_crypto_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_crypto_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_crypto_key,
+                default_retry=self._method_configs["GetCryptoKey"].retry,
+                default_timeout=self._method_configs["GetCryptoKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetCryptoKeyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_crypto_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_crypto_key_version(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns metadata for a given ``CryptoKeyVersion``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_version_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]', '[CRYPTO_KEY_VERSION]')
+            >>>
+            >>> response = client.get_crypto_key_version(name)
+
+        Args:
+            name (str): The ``name`` of the ``CryptoKeyVersion`` to get.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_crypto_key_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_crypto_key_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_crypto_key_version,
+                default_retry=self._method_configs["GetCryptoKeyVersion"].retry,
+                default_timeout=self._method_configs["GetCryptoKeyVersion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetCryptoKeyVersionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_crypto_key_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_key_ring(
+        self,
+        parent,
+        key_ring_id,
+        key_ring,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Create a new ``KeyRing`` in a given Project and Location.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `key_ring_id`:
+            >>> key_ring_id = ''
+            >>>
+            >>> # TODO: Initialize `key_ring`:
+            >>> key_ring = {}
+            >>>
+            >>> response = client.create_key_ring(parent, key_ring_id, key_ring)
+
+        Args:
+            parent (str): Required. The resource name of the location associated with the
+                ``KeyRings``, in the format ``projects/*/locations/*``.
+            key_ring_id (str): Required. It must be unique within a location and match the regular
+                expression ``[a-zA-Z0-9_-]{1,63}``
+            key_ring (Union[dict, ~google.cloud.kms_v1.types.KeyRing]): A ``KeyRing`` with initial field values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.KeyRing`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.KeyRing` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_key_ring" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_key_ring"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_key_ring,
+                default_retry=self._method_configs["CreateKeyRing"].retry,
+                default_timeout=self._method_configs["CreateKeyRing"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.CreateKeyRingRequest(
+            parent=parent, key_ring_id=key_ring_id, key_ring=key_ring
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_key_ring"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_import_job(
+        self,
+        parent,
+        import_job_id,
+        import_job,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Create a new ``ImportJob`` within a ``KeyRing``.
+
+        ``ImportJob.import_method`` is required.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>> from google.cloud.kms_v1 import enums
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>> import_job_id = 'my-import-job'
+            >>> import_method = enums.ImportJob.ImportMethod.RSA_OAEP_3072_SHA1_AES_256
+            >>> protection_level = enums.ProtectionLevel.HSM
+            >>> import_job = {'import_method': import_method, 'protection_level': protection_level}
+            >>>
+            >>> response = client.create_import_job(parent, import_job_id, import_job)
+
+        Args:
+            parent (str): Required. The ``name`` of the ``KeyRing`` associated with the
+                ``ImportJobs``.
+            import_job_id (str): Required. It must be unique within a KeyRing and match the regular
+                expression ``[a-zA-Z0-9_-]{1,63}``
+            import_job (Union[dict, ~google.cloud.kms_v1.types.ImportJob]): Required. An ``ImportJob`` with initial field values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.ImportJob`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.ImportJob` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_import_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_import_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_import_job,
+                default_retry=self._method_configs["CreateImportJob"].retry,
+                default_timeout=self._method_configs["CreateImportJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.CreateImportJobRequest(
+            parent=parent, import_job_id=import_job_id, import_job=import_job
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_import_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_crypto_key(
+        self,
+        parent,
+        crypto_key_id,
+        crypto_key,
+        skip_initial_version_creation=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Create a new ``CryptoKey`` within a ``KeyRing``.
+
+        ``CryptoKey.purpose`` and ``CryptoKey.version_template.algorithm`` are
+        required.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>> from google.cloud.kms_v1 import enums
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>> crypto_key_id = 'my-app-key'
+            >>> purpose = enums.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT
+            >>> seconds = 2147483647
+            >>> next_rotation_time = {'seconds': seconds}
+            >>> seconds_2 = 604800
+            >>> rotation_period = {'seconds': seconds_2}
+            >>> crypto_key = {'purpose': purpose, 'next_rotation_time': next_rotation_time, 'rotation_period': rotation_period}
+            >>>
+            >>> response = client.create_crypto_key(parent, crypto_key_id, crypto_key)
+
+        Args:
+            parent (str): Required. The ``name`` of the KeyRing associated with the
+                ``CryptoKeys``.
+            crypto_key_id (str): Required. It must be unique within a KeyRing and match the regular
+                expression ``[a-zA-Z0-9_-]{1,63}``
+            crypto_key (Union[dict, ~google.cloud.kms_v1.types.CryptoKey]): A ``CryptoKey`` with initial field values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.CryptoKey`
+            skip_initial_version_creation (bool): If set to true, the request will create a ``CryptoKey`` without any
+                ``CryptoKeyVersions``. You must manually call ``CreateCryptoKeyVersion``
+                or ``ImportCryptoKeyVersion`` before you can use this ``CryptoKey``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_crypto_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_crypto_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_crypto_key,
+                default_retry=self._method_configs["CreateCryptoKey"].retry,
+                default_timeout=self._method_configs["CreateCryptoKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.CreateCryptoKeyRequest(
+            parent=parent,
+            crypto_key_id=crypto_key_id,
+            crypto_key=crypto_key,
+            skip_initial_version_creation=skip_initial_version_creation,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_crypto_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_crypto_key_version(
+        self,
+        parent,
+        crypto_key_version,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Create a new ``CryptoKeyVersion`` in a ``CryptoKey``.
+
+        The server will assign the next sequential id. If unset, ``state`` will
+        be set to ``ENABLED``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.crypto_key_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]')
+            >>>
+            >>> # TODO: Initialize `crypto_key_version`:
+            >>> crypto_key_version = {}
+            >>>
+            >>> response = client.create_crypto_key_version(parent, crypto_key_version)
+
+        Args:
+            parent (str): Required. The ``name`` of the ``CryptoKey`` associated with the
+                ``CryptoKeyVersions``.
+            crypto_key_version (Union[dict, ~google.cloud.kms_v1.types.CryptoKeyVersion]): A ``CryptoKeyVersion`` with initial field values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.CryptoKeyVersion`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_crypto_key_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_crypto_key_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_crypto_key_version,
+                default_retry=self._method_configs["CreateCryptoKeyVersion"].retry,
+                default_timeout=self._method_configs["CreateCryptoKeyVersion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.CreateCryptoKeyVersionRequest(
+            parent=parent, crypto_key_version=crypto_key_version
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_crypto_key_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def import_crypto_key_version(
+        self,
+        parent,
+        algorithm,
+        import_job,
+        rsa_aes_wrapped_key=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Imports a new ``CryptoKeyVersion`` into an existing ``CryptoKey`` using
+        the wrapped key material provided in the request.
+
+        The version ID will be assigned the next sequential id within the
+        ``CryptoKey``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>> from google.cloud.kms_v1 import enums
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> parent = client.crypto_key_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]')
+            >>>
+            >>> # TODO: Initialize `algorithm`:
+            >>> algorithm = enums.CryptoKeyVersion.CryptoKeyVersionAlgorithm.CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `import_job`:
+            >>> import_job = ''
+            >>>
+            >>> response = client.import_crypto_key_version(parent, algorithm, import_job)
+
+        Args:
+            parent (str): Required. The ``name`` of the ``CryptoKey`` to be imported into.
+            algorithm (~google.cloud.kms_v1.types.CryptoKeyVersionAlgorithm): Required. The ``algorithm`` of the key being imported. This does not
+                need to match the ``version_template`` of the ``CryptoKey`` this version
+                imports into.
+            import_job (str): Required. The ``name`` of the ``ImportJob`` that was used to wrap this
+                key material.
+            rsa_aes_wrapped_key (bytes): Wrapped key material produced with ``RSA_OAEP_3072_SHA1_AES_256`` or
+                ``RSA_OAEP_4096_SHA1_AES_256``.
+
+                This field contains the concatenation of two wrapped keys:
+
+                .. raw:: html
+
+                    <ol>
+                      <li>An ephemeral AES-256 wrapping key wrapped with the
+                          `public_key` using RSAES-OAEP with SHA-1,
+                          MGF1 with SHA-1, and an empty label.
+                      </li>
+                      <li>The key to be imported, wrapped with the ephemeral AES-256 key
+                          using AES-KWP (RFC 5649).
+                      </li>
+                    </ol>
+
+                This format is the same as the format produced by PKCS#11 mechanism
+                CKM\_RSA\_AES\_KEY\_WRAP.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_crypto_key_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_crypto_key_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_crypto_key_version,
+                default_retry=self._method_configs["ImportCryptoKeyVersion"].retry,
+                default_timeout=self._method_configs["ImportCryptoKeyVersion"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            rsa_aes_wrapped_key=rsa_aes_wrapped_key
+        )
+
+        request = service_pb2.ImportCryptoKeyVersionRequest(
+            parent=parent,
+            algorithm=algorithm,
+            import_job=import_job,
+            rsa_aes_wrapped_key=rsa_aes_wrapped_key,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["import_crypto_key_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_crypto_key(
+        self,
+        crypto_key,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Update a ``CryptoKey``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> # TODO: Initialize `crypto_key`:
+            >>> crypto_key = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_crypto_key(crypto_key, update_mask)
+
+        Args:
+            crypto_key (Union[dict, ~google.cloud.kms_v1.types.CryptoKey]): ``CryptoKey`` with updated values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.CryptoKey`
+            update_mask (Union[dict, ~google.cloud.kms_v1.types.FieldMask]): Required list of fields to be updated in this request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_crypto_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_crypto_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_crypto_key,
+                default_retry=self._method_configs["UpdateCryptoKey"].retry,
+                default_timeout=self._method_configs["UpdateCryptoKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UpdateCryptoKeyRequest(
+            crypto_key=crypto_key, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("crypto_key.name", crypto_key.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_crypto_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_crypto_key_version(
+        self,
+        crypto_key_version,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Update a ``CryptoKeyVersion``'s metadata.
+
+        ``state`` may be changed between ``ENABLED`` and ``DISABLED`` using this
+        method. See ``DestroyCryptoKeyVersion`` and ``RestoreCryptoKeyVersion``
+        to move between other states.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> # TODO: Initialize `crypto_key_version`:
+            >>> crypto_key_version = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_crypto_key_version(crypto_key_version, update_mask)
+
+        Args:
+            crypto_key_version (Union[dict, ~google.cloud.kms_v1.types.CryptoKeyVersion]): ``CryptoKeyVersion`` with updated values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.CryptoKeyVersion`
+            update_mask (Union[dict, ~google.cloud.kms_v1.types.FieldMask]): Required list of fields to be updated in this request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_crypto_key_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_crypto_key_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_crypto_key_version,
+                default_retry=self._method_configs["UpdateCryptoKeyVersion"].retry,
+                default_timeout=self._method_configs["UpdateCryptoKeyVersion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UpdateCryptoKeyVersionRequest(
+            crypto_key_version=crypto_key_version, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("crypto_key_version.name", crypto_key_version.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_crypto_key_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def encrypt(
+        self,
+        name,
+        plaintext,
+        additional_authenticated_data=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Encrypts data, so that it can only be recovered by a call to
+        ``Decrypt``. The ``CryptoKey.purpose`` must be ``ENCRYPT_DECRYPT``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_path_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY_PATH]')
+            >>>
+            >>> # TODO: Initialize `plaintext`:
+            >>> plaintext = b''
+            >>>
+            >>> response = client.encrypt(name, plaintext)
+
+        Args:
+            name (str): Required. The resource name of the ``CryptoKey`` or ``CryptoKeyVersion``
+                to use for encryption.
+
+                If a ``CryptoKey`` is specified, the server will use its
+                ``primary version``.
+            plaintext (bytes): Required. The data to encrypt. Must be no larger than 64KiB.
+
+                The maximum size depends on the key version's ``protection_level``. For
+                ``SOFTWARE`` keys, the plaintext must be no larger than 64KiB. For
+                ``HSM`` keys, the combined length of the plaintext and
+                additional\_authenticated\_data fields must be no larger than 8KiB.
+            additional_authenticated_data (bytes): Optional data that, if specified, must also be provided during
+                decryption through ``DecryptRequest.additional_authenticated_data``.
+
+                The maximum size depends on the key version's ``protection_level``. For
+                ``SOFTWARE`` keys, the AAD must be no larger than 64KiB. For ``HSM``
+                keys, the combined length of the plaintext and
+                additional\_authenticated\_data fields must be no larger than 8KiB.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.EncryptResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "encrypt" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "encrypt"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.encrypt,
+                default_retry=self._method_configs["Encrypt"].retry,
+                default_timeout=self._method_configs["Encrypt"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.EncryptRequest(
+            name=name,
+            plaintext=plaintext,
+            additional_authenticated_data=additional_authenticated_data,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["encrypt"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def decrypt(
+        self,
+        name,
+        ciphertext,
+        additional_authenticated_data=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Decrypts data that was protected by ``Encrypt``. The
+        ``CryptoKey.purpose`` must be ``ENCRYPT_DECRYPT``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]')
+            >>>
+            >>> # TODO: Initialize `ciphertext`:
+            >>> ciphertext = b''
+            >>>
+            >>> response = client.decrypt(name, ciphertext)
+
+        Args:
+            name (str): Required. The resource name of the ``CryptoKey`` to use for decryption.
+                The server will choose the appropriate version.
+            ciphertext (bytes): Required. The encrypted data originally returned in
+                ``EncryptResponse.ciphertext``.
+            additional_authenticated_data (bytes): Optional data that must match the data originally supplied in
+                ``EncryptRequest.additional_authenticated_data``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.DecryptResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "decrypt" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "decrypt"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.decrypt,
+                default_retry=self._method_configs["Decrypt"].retry,
+                default_timeout=self._method_configs["Decrypt"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.DecryptRequest(
+            name=name,
+            ciphertext=ciphertext,
+            additional_authenticated_data=additional_authenticated_data,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["decrypt"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_crypto_key_primary_version(
+        self,
+        name,
+        crypto_key_version_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Update the version of a ``CryptoKey`` that will be used in ``Encrypt``.
+
+        Returns an error if called on an asymmetric key.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]')
+            >>>
+            >>> # TODO: Initialize `crypto_key_version_id`:
+            >>> crypto_key_version_id = ''
+            >>>
+            >>> response = client.update_crypto_key_primary_version(name, crypto_key_version_id)
+
+        Args:
+            name (str): The resource name of the ``CryptoKey`` to update.
+            crypto_key_version_id (str): The id of the child ``CryptoKeyVersion`` to use as primary.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_crypto_key_primary_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_crypto_key_primary_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_crypto_key_primary_version,
+                default_retry=self._method_configs[
+                    "UpdateCryptoKeyPrimaryVersion"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "UpdateCryptoKeyPrimaryVersion"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.UpdateCryptoKeyPrimaryVersionRequest(
+            name=name, crypto_key_version_id=crypto_key_version_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_crypto_key_primary_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def destroy_crypto_key_version(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Schedule a ``CryptoKeyVersion`` for destruction.
+
+        Upon calling this method, ``CryptoKeyVersion.state`` will be set to
+        ``DESTROY_SCHEDULED`` and ``destroy_time`` will be set to a time 24
+        hours in the future, at which point the ``state`` will be changed to
+        ``DESTROYED``, and the key material will be irrevocably destroyed.
+
+        Before the ``destroy_time`` is reached, ``RestoreCryptoKeyVersion`` may
+        be called to reverse the process.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_version_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]', '[CRYPTO_KEY_VERSION]')
+            >>>
+            >>> response = client.destroy_crypto_key_version(name)
+
+        Args:
+            name (str): The resource name of the ``CryptoKeyVersion`` to destroy.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "destroy_crypto_key_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "destroy_crypto_key_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.destroy_crypto_key_version,
+                default_retry=self._method_configs["DestroyCryptoKeyVersion"].retry,
+                default_timeout=self._method_configs["DestroyCryptoKeyVersion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.DestroyCryptoKeyVersionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["destroy_crypto_key_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def restore_crypto_key_version(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Restore a ``CryptoKeyVersion`` in the ``DESTROY_SCHEDULED`` state.
+
+        Upon restoration of the CryptoKeyVersion, ``state`` will be set to
+        ``DISABLED``, and ``destroy_time`` will be cleared.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_version_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]', '[CRYPTO_KEY_VERSION]')
+            >>>
+            >>> response = client.restore_crypto_key_version(name)
+
+        Args:
+            name (str): The resource name of the ``CryptoKeyVersion`` to restore.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.CryptoKeyVersion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "restore_crypto_key_version" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "restore_crypto_key_version"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.restore_crypto_key_version,
+                default_retry=self._method_configs["RestoreCryptoKeyVersion"].retry,
+                default_timeout=self._method_configs["RestoreCryptoKeyVersion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.RestoreCryptoKeyVersionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["restore_crypto_key_version"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_public_key(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns the public key for the given ``CryptoKeyVersion``. The
+        ``CryptoKey.purpose`` must be ``ASYMMETRIC_SIGN`` or
+        ``ASYMMETRIC_DECRYPT``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_version_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]', '[CRYPTO_KEY_VERSION]')
+            >>>
+            >>> response = client.get_public_key(name)
+
+        Args:
+            name (str): The ``name`` of the ``CryptoKeyVersion`` public key to get.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.PublicKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_public_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_public_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_public_key,
+                default_retry=self._method_configs["GetPublicKey"].retry,
+                default_timeout=self._method_configs["GetPublicKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.GetPublicKeyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_public_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def asymmetric_decrypt(
+        self,
+        name,
+        ciphertext,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Decrypts data that was encrypted with a public key retrieved from
+        ``GetPublicKey`` corresponding to a ``CryptoKeyVersion`` with
+        ``CryptoKey.purpose`` ASYMMETRIC\_DECRYPT.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_version_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]', '[CRYPTO_KEY_VERSION]')
+            >>>
+            >>> # TODO: Initialize `ciphertext`:
+            >>> ciphertext = b''
+            >>>
+            >>> response = client.asymmetric_decrypt(name, ciphertext)
+
+        Args:
+            name (str): Required. The resource name of the ``CryptoKeyVersion`` to use for
+                decryption.
+            ciphertext (bytes): Required. The data encrypted with the named ``CryptoKeyVersion``'s
+                public key using OAEP.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.AsymmetricDecryptResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "asymmetric_decrypt" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "asymmetric_decrypt"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.asymmetric_decrypt,
+                default_retry=self._method_configs["AsymmetricDecrypt"].retry,
+                default_timeout=self._method_configs["AsymmetricDecrypt"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.AsymmetricDecryptRequest(name=name, ciphertext=ciphertext)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["asymmetric_decrypt"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def asymmetric_sign(
+        self,
+        name,
+        digest,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Signs data using a ``CryptoKeyVersion`` with ``CryptoKey.purpose``
+        ASYMMETRIC\_SIGN, producing a signature that can be verified with the
+        public key retrieved from ``GetPublicKey``.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> name = client.crypto_key_version_path('[PROJECT]', '[LOCATION]', '[KEY_RING]', '[CRYPTO_KEY]', '[CRYPTO_KEY_VERSION]')
+            >>>
+            >>> # TODO: Initialize `digest`:
+            >>> digest = {}
+            >>>
+            >>> response = client.asymmetric_sign(name, digest)
+
+        Args:
+            name (str): Required. The resource name of the ``CryptoKeyVersion`` to use for
+                signing.
+            digest (Union[dict, ~google.cloud.kms_v1.types.Digest]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.Digest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.AsymmetricSignResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "asymmetric_sign" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "asymmetric_sign"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.asymmetric_sign,
+                default_retry=self._method_configs["AsymmetricSign"].retry,
+                default_timeout=self._method_configs["AsymmetricSign"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = service_pb2.AsymmetricSignRequest(name=name, digest=digest)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["asymmetric_sign"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on the specified resource. Replaces
+        any existing policy.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> resource = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.kms_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a resource. Returns an empty policy
+        if the resource exists and does not have a policy set.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> resource = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.kms_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.kms_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import kms_v1
+            >>>
+            >>> client = kms_v1.KeyManagementServiceClient()
+            >>>
+            >>> resource = client.key_ring_path('[PROJECT]', '[LOCATION]', '[KEY_RING]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.kms_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/kms/google/cloud/kms_v1/gapic/key_management_service_client_config.py b/kms/google/cloud/kms_v1/gapic/key_management_service_client_config.py
new file mode 100644
index 000000000000..0909a8a75eda
--- /dev/null
+++ b/kms/google/cloud/kms_v1/gapic/key_management_service_client_config.py
@@ -0,0 +1,155 @@
+config = {
+    "interfaces": {
+        "google.cloud.kms.v1.KeyManagementService": {
+            "retry_codes": {
+                "retryable": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+                "non_retryable": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListKeyRings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "ListImportJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "ListCryptoKeys": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "ListCryptoKeyVersions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "GetKeyRing": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "GetImportJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "GetCryptoKey": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "GetCryptoKeyVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "CreateKeyRing": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "CreateImportJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "CreateCryptoKey": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "CreateCryptoKeyVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_retryable",
+                    "retry_params_name": "default",
+                },
+                "ImportCryptoKeyVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_retryable",
+                    "retry_params_name": "default",
+                },
+                "UpdateCryptoKey": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "UpdateCryptoKeyVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "Encrypt": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "Decrypt": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "UpdateCryptoKeyPrimaryVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "DestroyCryptoKeyVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "RestoreCryptoKeyVersion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "GetPublicKey": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "AsymmetricDecrypt": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "AsymmetricSign": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "retryable",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/kms/google/cloud/kms_v1/gapic/transports/__init__.py b/kms/google/cloud/kms_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/kms/google/cloud/kms_v1/gapic/transports/key_management_service_grpc_transport.py b/kms/google/cloud/kms_v1/gapic/transports/key_management_service_grpc_transport.py
new file mode 100644
index 000000000000..cb900afc9278
--- /dev/null
+++ b/kms/google/cloud/kms_v1/gapic/transports/key_management_service_grpc_transport.py
@@ -0,0 +1,499 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.kms_v1.proto import service_pb2_grpc
+from google.iam.v1 import iam_policy_pb2_grpc as iam_policy_pb2_grpc
+
+
+class KeyManagementServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.kms.v1 KeyManagementService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloudkms",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudkms.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "key_management_service_stub": service_pb2_grpc.KeyManagementServiceStub(
+                channel
+            ),
+            "iam_policy_stub": iam_policy_pb2_grpc.IAMPolicyStub(channel),
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudkms.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_key_rings(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.list_key_rings`.
+
+        Lists ``KeyRings``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].ListKeyRings
+
+    @property
+    def list_import_jobs(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.list_import_jobs`.
+
+        Lists ``ImportJobs``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].ListImportJobs
+
+    @property
+    def list_crypto_keys(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.list_crypto_keys`.
+
+        Lists ``CryptoKeys``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].ListCryptoKeys
+
+    @property
+    def list_crypto_key_versions(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.list_crypto_key_versions`.
+
+        Lists ``CryptoKeyVersions``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].ListCryptoKeyVersions
+
+    @property
+    def get_key_ring(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.get_key_ring`.
+
+        Returns metadata for a given ``KeyRing``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].GetKeyRing
+
+    @property
+    def get_import_job(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.get_import_job`.
+
+        Returns metadata for a given ``ImportJob``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].GetImportJob
+
+    @property
+    def get_crypto_key(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.get_crypto_key`.
+
+        Returns metadata for a given ``CryptoKey``, as well as its ``primary``
+        ``CryptoKeyVersion``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].GetCryptoKey
+
+    @property
+    def get_crypto_key_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.get_crypto_key_version`.
+
+        Returns metadata for a given ``CryptoKeyVersion``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].GetCryptoKeyVersion
+
+    @property
+    def create_key_ring(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.create_key_ring`.
+
+        Create a new ``KeyRing`` in a given Project and Location.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].CreateKeyRing
+
+    @property
+    def create_import_job(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.create_import_job`.
+
+        Create a new ``ImportJob`` within a ``KeyRing``.
+
+        ``ImportJob.import_method`` is required.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].CreateImportJob
+
+    @property
+    def create_crypto_key(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.create_crypto_key`.
+
+        Create a new ``CryptoKey`` within a ``KeyRing``.
+
+        ``CryptoKey.purpose`` and ``CryptoKey.version_template.algorithm`` are
+        required.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].CreateCryptoKey
+
+    @property
+    def create_crypto_key_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.create_crypto_key_version`.
+
+        Create a new ``CryptoKeyVersion`` in a ``CryptoKey``.
+
+        The server will assign the next sequential id. If unset, ``state`` will
+        be set to ``ENABLED``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].CreateCryptoKeyVersion
+
+    @property
+    def import_crypto_key_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.import_crypto_key_version`.
+
+        Imports a new ``CryptoKeyVersion`` into an existing ``CryptoKey`` using
+        the wrapped key material provided in the request.
+
+        The version ID will be assigned the next sequential id within the
+        ``CryptoKey``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].ImportCryptoKeyVersion
+
+    @property
+    def update_crypto_key(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.update_crypto_key`.
+
+        Update a ``CryptoKey``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].UpdateCryptoKey
+
+    @property
+    def update_crypto_key_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.update_crypto_key_version`.
+
+        Update a ``CryptoKeyVersion``'s metadata.
+
+        ``state`` may be changed between ``ENABLED`` and ``DISABLED`` using this
+        method. See ``DestroyCryptoKeyVersion`` and ``RestoreCryptoKeyVersion``
+        to move between other states.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].UpdateCryptoKeyVersion
+
+    @property
+    def encrypt(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.encrypt`.
+
+        Encrypts data, so that it can only be recovered by a call to
+        ``Decrypt``. The ``CryptoKey.purpose`` must be ``ENCRYPT_DECRYPT``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].Encrypt
+
+    @property
+    def decrypt(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.decrypt`.
+
+        Decrypts data that was protected by ``Encrypt``. The
+        ``CryptoKey.purpose`` must be ``ENCRYPT_DECRYPT``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].Decrypt
+
+    @property
+    def update_crypto_key_primary_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.update_crypto_key_primary_version`.
+
+        Update the version of a ``CryptoKey`` that will be used in ``Encrypt``.
+
+        Returns an error if called on an asymmetric key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].UpdateCryptoKeyPrimaryVersion
+
+    @property
+    def destroy_crypto_key_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.destroy_crypto_key_version`.
+
+        Schedule a ``CryptoKeyVersion`` for destruction.
+
+        Upon calling this method, ``CryptoKeyVersion.state`` will be set to
+        ``DESTROY_SCHEDULED`` and ``destroy_time`` will be set to a time 24
+        hours in the future, at which point the ``state`` will be changed to
+        ``DESTROYED``, and the key material will be irrevocably destroyed.
+
+        Before the ``destroy_time`` is reached, ``RestoreCryptoKeyVersion`` may
+        be called to reverse the process.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].DestroyCryptoKeyVersion
+
+    @property
+    def restore_crypto_key_version(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.restore_crypto_key_version`.
+
+        Restore a ``CryptoKeyVersion`` in the ``DESTROY_SCHEDULED`` state.
+
+        Upon restoration of the CryptoKeyVersion, ``state`` will be set to
+        ``DISABLED``, and ``destroy_time`` will be cleared.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].RestoreCryptoKeyVersion
+
+    @property
+    def get_public_key(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.get_public_key`.
+
+        Returns the public key for the given ``CryptoKeyVersion``. The
+        ``CryptoKey.purpose`` must be ``ASYMMETRIC_SIGN`` or
+        ``ASYMMETRIC_DECRYPT``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].GetPublicKey
+
+    @property
+    def asymmetric_decrypt(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.asymmetric_decrypt`.
+
+        Decrypts data that was encrypted with a public key retrieved from
+        ``GetPublicKey`` corresponding to a ``CryptoKeyVersion`` with
+        ``CryptoKey.purpose`` ASYMMETRIC\_DECRYPT.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].AsymmetricDecrypt
+
+    @property
+    def asymmetric_sign(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.asymmetric_sign`.
+
+        Signs data using a ``CryptoKeyVersion`` with ``CryptoKey.purpose``
+        ASYMMETRIC\_SIGN, producing a signature that can be verified with the
+        public key retrieved from ``GetPublicKey``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["key_management_service_stub"].AsymmetricSign
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.set_iam_policy`.
+
+        Sets the access control policy on the specified resource. Replaces
+        any existing policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.get_iam_policy`.
+
+        Gets the access control policy for a resource. Returns an empty policy
+        if the resource exists and does not have a policy set.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`KeyManagementServiceClient.test_iam_permissions`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].TestIamPermissions
diff --git a/kms/google/cloud/kms_v1/proto/__init__.py b/kms/google/cloud/kms_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/kms/google/cloud/kms_v1/proto/resources.proto b/kms/google/cloud/kms_v1/proto/resources.proto
new file mode 100644
index 000000000000..09baaf1becfa
--- /dev/null
+++ b/kms/google/cloud/kms_v1/proto/resources.proto
@@ -0,0 +1,533 @@
+// 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.kms.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Kms.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/kms/v1;kms";
+option java_multiple_files = true;
+option java_outer_classname = "KmsResourcesProto";
+option java_package = "com.google.cloud.kms.v1";
+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 {
+  // Output only. The resource name for the [KeyRing][google.cloud.kms.v1.KeyRing] in the format
+  // `projects/*/locations/*/keyRings/*`.
+  string name = 1;
+
+  // Output only. The time at which this [KeyRing][google.cloud.kms.v1.KeyRing] was created.
+  google.protobuf.Timestamp create_time = 2;
+}
+
+// A [CryptoKey][google.cloud.kms.v1.CryptoKey] represents a logical key that can be used for cryptographic
+// operations.
+//
+// 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 {
+  // [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
+  // [Key purposes](https://cloud.google.com/kms/docs/algorithms#key_purposes).
+  enum CryptoKeyPurpose {
+    // Not specified.
+    CRYPTO_KEY_PURPOSE_UNSPECIFIED = 0;
+
+    // [CryptoKeys][google.cloud.kms.v1.CryptoKey] with this purpose may be used with
+    // [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt] and
+    // [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
+    ENCRYPT_DECRYPT = 1;
+
+    // [CryptoKeys][google.cloud.kms.v1.CryptoKey] with this purpose may be used with
+    // [AsymmetricSign][google.cloud.kms.v1.KeyManagementService.AsymmetricSign] and
+    // [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+    ASYMMETRIC_SIGN = 5;
+
+    // [CryptoKeys][google.cloud.kms.v1.CryptoKey] with this purpose may be used with
+    // [AsymmetricDecrypt][google.cloud.kms.v1.KeyManagementService.AsymmetricDecrypt] and
+    // [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+    ASYMMETRIC_DECRYPT = 6;
+  }
+
+  // Output only. The resource name for this [CryptoKey][google.cloud.kms.v1.CryptoKey] in the format
+  // `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+  string name = 1;
+
+  // 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
+  // in [EncryptRequest.name][google.cloud.kms.v1.EncryptRequest.name].
+  //
+  // 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
+  // primary. For other keys, this field will be omitted.
+  CryptoKeyVersion primary = 2;
+
+  // The immutable purpose of this [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  CryptoKeyPurpose purpose = 3;
+
+  // Output only. The time at which this [CryptoKey][google.cloud.kms.v1.CryptoKey] was created.
+  google.protobuf.Timestamp create_time = 5;
+
+  // At [next_rotation_time][google.cloud.kms.v1.CryptoKey.next_rotation_time], the Key Management Service will automatically:
+  //
+  // 1. Create a new version of this [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  // 2. Mark the new version as primary.
+  //
+  // Key rotations performed manually via
+  // [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion] and
+  // [UpdateCryptoKeyPrimaryVersion][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryVersion]
+  // do not affect [next_rotation_time][google.cloud.kms.v1.CryptoKey.next_rotation_time].
+  //
+  // Keys with [purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT] support
+  // automatic rotation. For other keys, this field must be omitted.
+  google.protobuf.Timestamp next_rotation_time = 7;
+
+  // 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.
+    //
+    // 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.
+    //
+    // Keys with [purpose][google.cloud.kms.v1.CryptoKey.purpose]
+    // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT] support
+    // automatic rotation. For other keys, this field must be omitted.
+    google.protobuf.Duration rotation_period = 8;
+  }
+
+  // A template describing settings for new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] instances.
+  // The properties of new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] instances created by either
+  // [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion] or
+  // auto-rotation are controlled by this template.
+  CryptoKeyVersionTemplate version_template = 11;
+
+  // Labels with user-defined metadata. For more information, see
+  // [Labeling Keys](/kms/docs/labeling-keys).
+  map<string, string> labels = 10;
+}
+
+// A [CryptoKeyVersionTemplate][google.cloud.kms.v1.CryptoKeyVersionTemplate] specifies the properties to use when creating
+// a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], either manually with
+// [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion] or
+// automatically as a result of auto-rotation.
+message CryptoKeyVersionTemplate {
+  // [ProtectionLevel][google.cloud.kms.v1.ProtectionLevel] to use when creating a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] based on
+  // this template. Immutable. Defaults to [SOFTWARE][google.cloud.kms.v1.ProtectionLevel.SOFTWARE].
+  ProtectionLevel protection_level = 1;
+
+  // Required. [Algorithm][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm] to use
+  // when creating a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] based on this template.
+  //
+  // 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;
+}
+
+// Contains an HSM-generated attestation about a key operation. For more
+// information, see [Verifying attestations]
+// (https://cloud.google.com/kms/docs/attest-key).
+message KeyOperationAttestation {
+  // Attestation formats provided by the HSM.
+  enum AttestationFormat {
+    // Not specified.
+    ATTESTATION_FORMAT_UNSPECIFIED = 0;
+
+    // Cavium HSM attestation compressed with gzip. Note that this format is
+    // defined by Cavium and subject to change at any time.
+    CAVIUM_V1_COMPRESSED = 3;
+
+    // Cavium HSM attestation V2 compressed with gzip. This is a new format
+    // introduced in Cavium's version 3.2-08.
+    CAVIUM_V2_COMPRESSED = 4;
+  }
+
+  // Output only. The format of the attestation data.
+  AttestationFormat format = 4;
+
+  // Output only. The attestation data provided by the HSM when the key
+  // operation was performed.
+  bytes content = 5;
+}
+
+// A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] represents an individual cryptographic key, and the
+// associated key material.
+//
+// An [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] version can be
+// used for cryptographic operations.
+//
+// For security reasons, the raw cryptographic key material represented by a
+// [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] can never be viewed or exported. It can only be used to
+// encrypt, decrypt, or sign data when an authorized user or application invokes
+// Cloud KMS.
+message CryptoKeyVersion {
+  // The algorithm of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], indicating what
+  // parameters must be used for each cryptographic operation.
+  //
+  // The
+  // [GOOGLE_SYMMETRIC_ENCRYPTION][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm.GOOGLE_SYMMETRIC_ENCRYPTION]
+  // algorithm is usable with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].
+  //
+  // Algorithms beginning with "RSA_SIGN_" are usable with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN].
+  //
+  // The fields in the name after "RSA_SIGN_" correspond to the following
+  // parameters: padding algorithm, modulus bit length, and digest algorithm.
+  //
+  // For PSS, the salt length used is equal to the length of digest
+  // algorithm. For example,
+  // [RSA_SIGN_PSS_2048_SHA256][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm.RSA_SIGN_PSS_2048_SHA256]
+  // will use PSS with a salt length of 256 bits or 32 bytes.
+  //
+  // Algorithms beginning with "RSA_DECRYPT_" are usable with
+  // [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].
+  //
+  // The fields in the name after "RSA_DECRYPT_" correspond to the following
+  // parameters: padding algorithm, modulus bit length, and digest algorithm.
+  //
+  // Algorithms beginning with "EC_SIGN_" are usable with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN].
+  //
+  // The fields in the name after "EC_SIGN_" correspond to the following
+  // parameters: elliptic curve, digest algorithm.
+  //
+  // For more information, see [Key purposes and algorithms]
+  // (https://cloud.google.com/kms/docs/algorithms).
+  enum CryptoKeyVersionAlgorithm {
+    // Not specified.
+    CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED = 0;
+
+    // Creates symmetric encryption keys.
+    GOOGLE_SYMMETRIC_ENCRYPTION = 1;
+
+    // RSASSA-PSS 2048 bit key with a SHA256 digest.
+    RSA_SIGN_PSS_2048_SHA256 = 2;
+
+    // RSASSA-PSS 3072 bit key with a SHA256 digest.
+    RSA_SIGN_PSS_3072_SHA256 = 3;
+
+    // RSASSA-PSS 4096 bit key with a SHA256 digest.
+    RSA_SIGN_PSS_4096_SHA256 = 4;
+
+    // RSASSA-PSS 4096 bit key with a SHA512 digest.
+    RSA_SIGN_PSS_4096_SHA512 = 15;
+
+    // RSASSA-PKCS1-v1_5 with a 2048 bit key and a SHA256 digest.
+    RSA_SIGN_PKCS1_2048_SHA256 = 5;
+
+    // RSASSA-PKCS1-v1_5 with a 3072 bit key and a SHA256 digest.
+    RSA_SIGN_PKCS1_3072_SHA256 = 6;
+
+    // RSASSA-PKCS1-v1_5 with a 4096 bit key and a SHA256 digest.
+    RSA_SIGN_PKCS1_4096_SHA256 = 7;
+
+    // RSASSA-PKCS1-v1_5 with a 4096 bit key and a SHA512 digest.
+    RSA_SIGN_PKCS1_4096_SHA512 = 16;
+
+    // RSAES-OAEP 2048 bit key with a SHA256 digest.
+    RSA_DECRYPT_OAEP_2048_SHA256 = 8;
+
+    // RSAES-OAEP 3072 bit key with a SHA256 digest.
+    RSA_DECRYPT_OAEP_3072_SHA256 = 9;
+
+    // RSAES-OAEP 4096 bit key with a SHA256 digest.
+    RSA_DECRYPT_OAEP_4096_SHA256 = 10;
+
+    // RSAES-OAEP 4096 bit key with a SHA512 digest.
+    RSA_DECRYPT_OAEP_4096_SHA512 = 17;
+
+    // ECDSA on the NIST P-256 curve with a SHA256 digest.
+    EC_SIGN_P256_SHA256 = 12;
+
+    // ECDSA on the NIST P-384 curve with a SHA384 digest.
+    EC_SIGN_P384_SHA384 = 13;
+  }
+
+  // The state of a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], indicating if it can be used.
+  enum CryptoKeyVersionState {
+    // Not specified.
+    CRYPTO_KEY_VERSION_STATE_UNSPECIFIED = 0;
+
+    // This version is still being generated. It may not be used, enabled,
+    // disabled, or destroyed yet. Cloud KMS will automatically mark this
+    // version [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] as soon as the version is ready.
+    PENDING_GENERATION = 5;
+
+    // This version may be used for cryptographic operations.
+    ENABLED = 1;
+
+    // This version may not be used, but the key material is still available,
+    // and the version can be placed back into the [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] state.
+    DISABLED = 2;
+
+    // This version is destroyed, and the key material is no longer stored.
+    // A version may not leave this state once entered.
+    DESTROYED = 3;
+
+    // This version is scheduled for destruction, and will be destroyed soon.
+    // Call
+    // [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion]
+    // to put it back into the [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] state.
+    DESTROY_SCHEDULED = 4;
+
+    // This version is still being imported. It may not be used, enabled,
+    // disabled, or destroyed yet. Cloud KMS will automatically mark this
+    // version [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] as soon as the version is ready.
+    PENDING_IMPORT = 6;
+
+    // This version was not imported successfully. It may not be used, enabled,
+    // disabled, or destroyed. The submitted key material has been discarded.
+    // Additional details can be found in
+    // [CryptoKeyVersion.import_failure_reason][google.cloud.kms.v1.CryptoKeyVersion.import_failure_reason].
+    IMPORT_FAILED = 7;
+  }
+
+  // A view for [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]s. Controls the level of detail returned
+  // for [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] in
+  // [KeyManagementService.ListCryptoKeyVersions][google.cloud.kms.v1.KeyManagementService.ListCryptoKeyVersions] and
+  // [KeyManagementService.ListCryptoKeys][google.cloud.kms.v1.KeyManagementService.ListCryptoKeys].
+  enum CryptoKeyVersionView {
+    // Default view for each [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. Does not include
+    // the [attestation][google.cloud.kms.v1.CryptoKeyVersion.attestation] field.
+    CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED = 0;
+
+    // Provides all fields in each [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], including the
+    // [attestation][google.cloud.kms.v1.CryptoKeyVersion.attestation].
+    FULL = 1;
+  }
+
+  // Output only. The resource name for this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the format
+  // `projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*`.
+  string name = 1;
+
+  // 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;
+
+  // Output only. The [CryptoKeyVersionAlgorithm][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm] that this
+  // [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] supports.
+  CryptoKeyVersionAlgorithm algorithm = 10;
+
+  // 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;
+
+  // Output only. The time at which this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] was created.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. The time this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key material was
+  // generated.
+  google.protobuf.Timestamp generate_time = 11;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // Output only. The time at which this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key material
+  // was imported.
+  google.protobuf.Timestamp import_time = 15;
+
+  // 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;
+}
+
+// The public key for a given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. Obtained via
+// [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+message 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
+  // [Textual Encoding of Subject Public Key Info]
+  // (https://tools.ietf.org/html/rfc7468#section-13).
+  string pem = 1;
+
+  // The [Algorithm][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm] associated
+  // with this key.
+  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.
+//
+// When an [ImportJob][google.cloud.kms.v1.ImportJob] is created, Cloud KMS will generate a "wrapping key",
+// which is a public/private key pair. You use the wrapping key to encrypt (also
+// known as wrap) the pre-existing key material to protect it during the import
+// process. The nature of the wrapping key depends on the choice of
+// [import_method][google.cloud.kms.v1.ImportJob.import_method]. When the wrapping key generation
+// is complete, the [state][google.cloud.kms.v1.ImportJob.state] will be set to
+// [ACTIVE][google.cloud.kms.v1.ImportJob.ImportJobState.ACTIVE] and the [public_key][google.cloud.kms.v1.ImportJob.public_key]
+// can be fetched. The fetched public key can then be used to wrap your
+// pre-existing key material.
+//
+// Once the key material is wrapped, it can be imported into a new
+// [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] by calling
+// [ImportCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion].
+// Multiple [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] can be imported with a single
+// [ImportJob][google.cloud.kms.v1.ImportJob]. Cloud KMS uses the private key portion of the wrapping key to
+// unwrap the key material. Only Cloud KMS has access to the private key.
+//
+// An [ImportJob][google.cloud.kms.v1.ImportJob] expires 3 days after it is created. Once expired, Cloud KMS
+// will no longer be able to import or unwrap any key material that was wrapped
+// with the [ImportJob][google.cloud.kms.v1.ImportJob]'s public key.
+//
+// For more information, see
+// [Importing a key](https://cloud.google.com/kms/docs/importing-a-key).
+message ImportJob {
+  // 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 {
+    // 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
+    // [Textual Encoding of Subject Public Key Info]
+    // (https://tools.ietf.org/html/rfc7468#section-13).
+    string pem = 1;
+  }
+
+  // [ImportMethod][google.cloud.kms.v1.ImportJob.ImportMethod] describes the key wrapping method chosen for this
+  // [ImportJob][google.cloud.kms.v1.ImportJob].
+  enum ImportMethod {
+    // Not specified.
+    IMPORT_METHOD_UNSPECIFIED = 0;
+
+    // This ImportMethod represents the CKM_RSA_AES_KEY_WRAP key wrapping
+    // scheme defined in the PKCS #11 standard. In summary, this involves
+    // wrapping the raw key with an ephemeral AES key, and wrapping the
+    // ephemeral AES key with a 3072 bit RSA key. For more details, see
+    // [RSA AES key wrap
+    // mechanism](http://docs.oasis-open.org/pkcs11/pkcs11-curr/v2.40/cos01/pkcs11-curr-v2.40-cos01.html#_Toc408226908).
+    RSA_OAEP_3072_SHA1_AES_256 = 1;
+
+    // This ImportMethod represents the CKM_RSA_AES_KEY_WRAP key wrapping
+    // scheme defined in the PKCS #11 standard. In summary, this involves
+    // wrapping the raw key with an ephemeral AES key, and wrapping the
+    // ephemeral AES key with a 4096 bit RSA key. For more details, see
+    // [RSA AES key wrap
+    // mechanism](http://docs.oasis-open.org/pkcs11/pkcs11-curr/v2.40/cos01/pkcs11-curr-v2.40-cos01.html#_Toc408226908).
+    RSA_OAEP_4096_SHA1_AES_256 = 2;
+  }
+
+  // The state of the [ImportJob][google.cloud.kms.v1.ImportJob], indicating if it can be used.
+  enum ImportJobState {
+    // Not specified.
+    IMPORT_JOB_STATE_UNSPECIFIED = 0;
+
+    // The wrapping key for this job is still being generated. It may not be
+    // used. Cloud KMS will automatically mark this job as
+    // [ACTIVE][google.cloud.kms.v1.ImportJob.ImportJobState.ACTIVE] as soon as the wrapping key is generated.
+    PENDING_GENERATION = 1;
+
+    // This job may be used in
+    // [CreateCryptoKey][google.cloud.kms.v1.KeyManagementService.CreateCryptoKey] and
+    // [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion]
+    // requests.
+    ACTIVE = 2;
+
+    // This job can no longer be used and may not leave this state once entered.
+    EXPIRED = 3;
+  }
+
+  // Output only. The resource name for this [ImportJob][google.cloud.kms.v1.ImportJob] in the format
+  // `projects/*/locations/*/keyRings/*/importJobs/*`.
+  string name = 1;
+
+  // Required and immutable. The wrapping method to be used for incoming
+  // key material.
+  ImportMethod import_method = 2;
+
+  // Required and 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;
+
+  // Output only. The time at which this [ImportJob][google.cloud.kms.v1.ImportJob] was created.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Output only. The time this [ImportJob][google.cloud.kms.v1.ImportJob]'s key material was generated.
+  google.protobuf.Timestamp generate_time = 4;
+
+  // 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;
+
+  // 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;
+
+  // Output only. The current state of the [ImportJob][google.cloud.kms.v1.ImportJob], indicating if it can
+  // be used.
+  ImportJobState state = 6;
+
+  // 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;
+
+  // 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;
+}
diff --git a/kms/google/cloud/kms_v1/proto/resources_pb2.py b/kms/google/cloud/kms_v1/proto/resources_pb2.py
new file mode 100644
index 000000000000..2ba0aef61b86
--- /dev/null
+++ b/kms/google/cloud/kms_v1/proto/resources_pb2.py
@@ -0,0 +1,1868 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/kms_v1/proto/resources.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/kms_v1/proto/resources.proto",
+    package="google.cloud.kms.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.cloud.kms.v1B\021KmsResourcesProtoP\001Z6google.golang.org/genproto/googleapis/cloud/kms/v1;kms\370\001\001\252\002\023Google.Cloud.Kms.V1\312\002\023Google\\Cloud\\Kms\\V1"
+    ),
+    serialized_pb=_b(
+        '\n)google/cloud/kms_v1/proto/resources.proto\x12\x13google.cloud.kms.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"H\n\x07KeyRing\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xf5\x04\n\tCryptoKey\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x36\n\x07primary\x18\x02 \x01(\x0b\x32%.google.cloud.kms.v1.CryptoKeyVersion\x12@\n\x07purpose\x18\x03 \x01(\x0e\x32/.google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x12next_rotation_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x0frotation_period\x18\x08 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12G\n\x10version_template\x18\x0b \x01(\x0b\x32-.google.cloud.kms.v1.CryptoKeyVersionTemplate\x12:\n\x06labels\x18\n \x03(\x0b\x32*.google.cloud.kms.v1.CryptoKey.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"x\n\x10\x43ryptoKeyPurpose\x12"\n\x1e\x43RYPTO_KEY_PURPOSE_UNSPECIFIED\x10\x00\x12\x13\n\x0f\x45NCRYPT_DECRYPT\x10\x01\x12\x13\n\x0f\x41SYMMETRIC_SIGN\x10\x05\x12\x16\n\x12\x41SYMMETRIC_DECRYPT\x10\x06\x42\x13\n\x11rotation_schedule"\xae\x01\n\x18\x43ryptoKeyVersionTemplate\x12>\n\x10protection_level\x18\x01 \x01(\x0e\x32$.google.cloud.kms.v1.ProtectionLevel\x12R\n\talgorithm\x18\x03 \x01(\x0e\x32?.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm"\xe7\x01\n\x17KeyOperationAttestation\x12N\n\x06\x66ormat\x18\x04 \x01(\x0e\x32>.google.cloud.kms.v1.KeyOperationAttestation.AttestationFormat\x12\x0f\n\x07\x63ontent\x18\x05 \x01(\x0c"k\n\x11\x41ttestationFormat\x12"\n\x1e\x41TTESTATION_FORMAT_UNSPECIFIED\x10\x00\x12\x18\n\x14\x43\x41VIUM_V1_COMPRESSED\x10\x03\x12\x18\n\x14\x43\x41VIUM_V2_COMPRESSED\x10\x04"\xa3\x0b\n\x10\x43ryptoKeyVersion\x12\x0c\n\x04name\x18\x01 \x01(\t\x12J\n\x05state\x18\x03 \x01(\x0e\x32;.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState\x12>\n\x10protection_level\x18\x07 \x01(\x0e\x32$.google.cloud.kms.v1.ProtectionLevel\x12R\n\talgorithm\x18\n \x01(\x0e\x32?.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm\x12\x41\n\x0b\x61ttestation\x18\x08 \x01(\x0b\x32,.google.cloud.kms.v1.KeyOperationAttestation\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rgenerate_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x0c\x64\x65stroy_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x12\x64\x65stroy_event_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nimport_job\x18\x0e \x01(\t\x12/\n\x0bimport_time\x18\x0f \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1d\n\x15import_failure_reason\x18\x10 \x01(\t"\x9c\x04\n\x19\x43ryptoKeyVersionAlgorithm\x12,\n(CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED\x10\x00\x12\x1f\n\x1bGOOGLE_SYMMETRIC_ENCRYPTION\x10\x01\x12\x1c\n\x18RSA_SIGN_PSS_2048_SHA256\x10\x02\x12\x1c\n\x18RSA_SIGN_PSS_3072_SHA256\x10\x03\x12\x1c\n\x18RSA_SIGN_PSS_4096_SHA256\x10\x04\x12\x1c\n\x18RSA_SIGN_PSS_4096_SHA512\x10\x0f\x12\x1e\n\x1aRSA_SIGN_PKCS1_2048_SHA256\x10\x05\x12\x1e\n\x1aRSA_SIGN_PKCS1_3072_SHA256\x10\x06\x12\x1e\n\x1aRSA_SIGN_PKCS1_4096_SHA256\x10\x07\x12\x1e\n\x1aRSA_SIGN_PKCS1_4096_SHA512\x10\x10\x12 \n\x1cRSA_DECRYPT_OAEP_2048_SHA256\x10\x08\x12 \n\x1cRSA_DECRYPT_OAEP_3072_SHA256\x10\t\x12 \n\x1cRSA_DECRYPT_OAEP_4096_SHA256\x10\n\x12 \n\x1cRSA_DECRYPT_OAEP_4096_SHA512\x10\x11\x12\x17\n\x13\x45\x43_SIGN_P256_SHA256\x10\x0c\x12\x17\n\x13\x45\x43_SIGN_P384_SHA384\x10\r"\xc1\x01\n\x15\x43ryptoKeyVersionState\x12(\n$CRYPTO_KEY_VERSION_STATE_UNSPECIFIED\x10\x00\x12\x16\n\x12PENDING_GENERATION\x10\x05\x12\x0b\n\x07\x45NABLED\x10\x01\x12\x0c\n\x08\x44ISABLED\x10\x02\x12\r\n\tDESTROYED\x10\x03\x12\x15\n\x11\x44\x45STROY_SCHEDULED\x10\x04\x12\x12\n\x0ePENDING_IMPORT\x10\x06\x12\x11\n\rIMPORT_FAILED\x10\x07"I\n\x14\x43ryptoKeyVersionView\x12\'\n#CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED\x10\x00\x12\x08\n\x04\x46ULL\x10\x01"l\n\tPublicKey\x12\x0b\n\x03pem\x18\x01 \x01(\t\x12R\n\talgorithm\x18\x02 \x01(\x0e\x32?.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm"\xa6\x06\n\tImportJob\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x42\n\rimport_method\x18\x02 \x01(\x0e\x32+.google.cloud.kms.v1.ImportJob.ImportMethod\x12>\n\x10protection_level\x18\t \x01(\x0e\x32$.google.cloud.kms.v1.ProtectionLevel\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rgenerate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x65xpire_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11\x65xpire_event_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\x05state\x18\x06 \x01(\x0e\x32-.google.cloud.kms.v1.ImportJob.ImportJobState\x12\x44\n\npublic_key\x18\x07 \x01(\x0b\x32\x30.google.cloud.kms.v1.ImportJob.WrappingPublicKey\x12\x41\n\x0b\x61ttestation\x18\x08 \x01(\x0b\x32,.google.cloud.kms.v1.KeyOperationAttestation\x1a \n\x11WrappingPublicKey\x12\x0b\n\x03pem\x18\x01 \x01(\t"m\n\x0cImportMethod\x12\x1d\n\x19IMPORT_METHOD_UNSPECIFIED\x10\x00\x12\x1e\n\x1aRSA_OAEP_3072_SHA1_AES_256\x10\x01\x12\x1e\n\x1aRSA_OAEP_4096_SHA1_AES_256\x10\x02"c\n\x0eImportJobState\x12 \n\x1cIMPORT_JOB_STATE_UNSPECIFIED\x10\x00\x12\x16\n\x12PENDING_GENERATION\x10\x01\x12\n\n\x06\x41\x43TIVE\x10\x02\x12\x0b\n\x07\x45XPIRED\x10\x03*J\n\x0fProtectionLevel\x12 \n\x1cPROTECTION_LEVEL_UNSPECIFIED\x10\x00\x12\x0c\n\x08SOFTWARE\x10\x01\x12\x07\n\x03HSM\x10\x02\x42\x95\x01\n\x17\x63om.google.cloud.kms.v1B\x11KmsResourcesProtoP\x01Z6google.golang.org/genproto/googleapis/cloud/kms/v1;kms\xf8\x01\x01\xaa\x02\x13Google.Cloud.Kms.V1\xca\x02\x13Google\\Cloud\\Kms\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_PROTECTIONLEVEL = _descriptor.EnumDescriptor(
+    name="ProtectionLevel",
+    full_name="google.cloud.kms.v1.ProtectionLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PROTECTION_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SOFTWARE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HSM", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3643,
+    serialized_end=3717,
+)
+_sym_db.RegisterEnumDescriptor(_PROTECTIONLEVEL)
+
+ProtectionLevel = enum_type_wrapper.EnumTypeWrapper(_PROTECTIONLEVEL)
+PROTECTION_LEVEL_UNSPECIFIED = 0
+SOFTWARE = 1
+HSM = 2
+
+
+_CRYPTOKEY_CRYPTOKEYPURPOSE = _descriptor.EnumDescriptor(
+    name="CryptoKeyPurpose",
+    full_name="google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CRYPTO_KEY_PURPOSE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENCRYPT_DECRYPT",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASYMMETRIC_SIGN",
+            index=2,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASYMMETRIC_DECRYPT",
+            index=3,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=724,
+    serialized_end=844,
+)
+_sym_db.RegisterEnumDescriptor(_CRYPTOKEY_CRYPTOKEYPURPOSE)
+
+_KEYOPERATIONATTESTATION_ATTESTATIONFORMAT = _descriptor.EnumDescriptor(
+    name="AttestationFormat",
+    full_name="google.cloud.kms.v1.KeyOperationAttestation.AttestationFormat",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ATTESTATION_FORMAT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CAVIUM_V1_COMPRESSED",
+            index=1,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CAVIUM_V2_COMPRESSED",
+            index=2,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1169,
+    serialized_end=1276,
+)
+_sym_db.RegisterEnumDescriptor(_KEYOPERATIONATTESTATION_ATTESTATIONFORMAT)
+
+_CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM = _descriptor.EnumDescriptor(
+    name="CryptoKeyVersionAlgorithm",
+    full_name="google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GOOGLE_SYMMETRIC_ENCRYPTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PSS_2048_SHA256",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PSS_3072_SHA256",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PSS_4096_SHA256",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PSS_4096_SHA512",
+            index=5,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PKCS1_2048_SHA256",
+            index=6,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PKCS1_3072_SHA256",
+            index=7,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PKCS1_4096_SHA256",
+            index=8,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_SIGN_PKCS1_4096_SHA512",
+            index=9,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_DECRYPT_OAEP_2048_SHA256",
+            index=10,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_DECRYPT_OAEP_3072_SHA256",
+            index=11,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_DECRYPT_OAEP_4096_SHA256",
+            index=12,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_DECRYPT_OAEP_4096_SHA512",
+            index=13,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EC_SIGN_P256_SHA256",
+            index=14,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EC_SIGN_P384_SHA384",
+            index=15,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1911,
+    serialized_end=2451,
+)
+_sym_db.RegisterEnumDescriptor(_CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM)
+
+_CRYPTOKEYVERSION_CRYPTOKEYVERSIONSTATE = _descriptor.EnumDescriptor(
+    name="CryptoKeyVersionState",
+    full_name="google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CRYPTO_KEY_VERSION_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING_GENERATION",
+            index=1,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENABLED", index=2, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=3, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESTROYED", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DESTROY_SCHEDULED",
+            index=5,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING_IMPORT", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPORT_FAILED", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2454,
+    serialized_end=2647,
+)
+_sym_db.RegisterEnumDescriptor(_CRYPTOKEYVERSION_CRYPTOKEYVERSIONSTATE)
+
+_CRYPTOKEYVERSION_CRYPTOKEYVERSIONVIEW = _descriptor.EnumDescriptor(
+    name="CryptoKeyVersionView",
+    full_name="google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionView",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2649,
+    serialized_end=2722,
+)
+_sym_db.RegisterEnumDescriptor(_CRYPTOKEYVERSION_CRYPTOKEYVERSIONVIEW)
+
+_IMPORTJOB_IMPORTMETHOD = _descriptor.EnumDescriptor(
+    name="ImportMethod",
+    full_name="google.cloud.kms.v1.ImportJob.ImportMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="IMPORT_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_OAEP_3072_SHA1_AES_256",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RSA_OAEP_4096_SHA1_AES_256",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3431,
+    serialized_end=3540,
+)
+_sym_db.RegisterEnumDescriptor(_IMPORTJOB_IMPORTMETHOD)
+
+_IMPORTJOB_IMPORTJOBSTATE = _descriptor.EnumDescriptor(
+    name="ImportJobState",
+    full_name="google.cloud.kms.v1.ImportJob.ImportJobState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="IMPORT_JOB_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PENDING_GENERATION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPIRED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3542,
+    serialized_end=3641,
+)
+_sym_db.RegisterEnumDescriptor(_IMPORTJOB_IMPORTJOBSTATE)
+
+
+_KEYRING = _descriptor.Descriptor(
+    name="KeyRing",
+    full_name="google.cloud.kms.v1.KeyRing",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.KeyRing.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.kms.v1.KeyRing.create_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=161,
+    serialized_end=233,
+)
+
+
+_CRYPTOKEY_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.kms.v1.CryptoKey.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.kms.v1.CryptoKey.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.kms.v1.CryptoKey.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=677,
+    serialized_end=722,
+)
+
+_CRYPTOKEY = _descriptor.Descriptor(
+    name="CryptoKey",
+    full_name="google.cloud.kms.v1.CryptoKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.CryptoKey.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="primary",
+            full_name="google.cloud.kms.v1.CryptoKey.primary",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="purpose",
+            full_name="google.cloud.kms.v1.CryptoKey.purpose",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.kms.v1.CryptoKey.create_time",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_rotation_time",
+            full_name="google.cloud.kms.v1.CryptoKey.next_rotation_time",
+            index=4,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rotation_period",
+            full_name="google.cloud.kms.v1.CryptoKey.rotation_period",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version_template",
+            full_name="google.cloud.kms.v1.CryptoKey.version_template",
+            index=6,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.kms.v1.CryptoKey.labels",
+            index=7,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CRYPTOKEY_LABELSENTRY],
+    enum_types=[_CRYPTOKEY_CRYPTOKEYPURPOSE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="rotation_schedule",
+            full_name="google.cloud.kms.v1.CryptoKey.rotation_schedule",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=236,
+    serialized_end=865,
+)
+
+
+_CRYPTOKEYVERSIONTEMPLATE = _descriptor.Descriptor(
+    name="CryptoKeyVersionTemplate",
+    full_name="google.cloud.kms.v1.CryptoKeyVersionTemplate",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="protection_level",
+            full_name="google.cloud.kms.v1.CryptoKeyVersionTemplate.protection_level",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="algorithm",
+            full_name="google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm",
+            index=1,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=868,
+    serialized_end=1042,
+)
+
+
+_KEYOPERATIONATTESTATION = _descriptor.Descriptor(
+    name="KeyOperationAttestation",
+    full_name="google.cloud.kms.v1.KeyOperationAttestation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="format",
+            full_name="google.cloud.kms.v1.KeyOperationAttestation.format",
+            index=0,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.kms.v1.KeyOperationAttestation.content",
+            index=1,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_KEYOPERATIONATTESTATION_ATTESTATIONFORMAT],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1045,
+    serialized_end=1276,
+)
+
+
+_CRYPTOKEYVERSION = _descriptor.Descriptor(
+    name="CryptoKeyVersion",
+    full_name="google.cloud.kms.v1.CryptoKeyVersion",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.state",
+            index=1,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="protection_level",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.protection_level",
+            index=2,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="algorithm",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.algorithm",
+            index=3,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attestation",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.attestation",
+            index=4,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.create_time",
+            index=5,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="generate_time",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.generate_time",
+            index=6,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destroy_time",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.destroy_time",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destroy_event_time",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.destroy_event_time",
+            index=8,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_job",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.import_job",
+            index=9,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_time",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.import_time",
+            index=10,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_failure_reason",
+            full_name="google.cloud.kms.v1.CryptoKeyVersion.import_failure_reason",
+            index=11,
+            number=16,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM,
+        _CRYPTOKEYVERSION_CRYPTOKEYVERSIONSTATE,
+        _CRYPTOKEYVERSION_CRYPTOKEYVERSIONVIEW,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1279,
+    serialized_end=2722,
+)
+
+
+_PUBLICKEY = _descriptor.Descriptor(
+    name="PublicKey",
+    full_name="google.cloud.kms.v1.PublicKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pem",
+            full_name="google.cloud.kms.v1.PublicKey.pem",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="algorithm",
+            full_name="google.cloud.kms.v1.PublicKey.algorithm",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2724,
+    serialized_end=2832,
+)
+
+
+_IMPORTJOB_WRAPPINGPUBLICKEY = _descriptor.Descriptor(
+    name="WrappingPublicKey",
+    full_name="google.cloud.kms.v1.ImportJob.WrappingPublicKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pem",
+            full_name="google.cloud.kms.v1.ImportJob.WrappingPublicKey.pem",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3397,
+    serialized_end=3429,
+)
+
+_IMPORTJOB = _descriptor.Descriptor(
+    name="ImportJob",
+    full_name="google.cloud.kms.v1.ImportJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.ImportJob.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_method",
+            full_name="google.cloud.kms.v1.ImportJob.import_method",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="protection_level",
+            full_name="google.cloud.kms.v1.ImportJob.protection_level",
+            index=2,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.kms.v1.ImportJob.create_time",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="generate_time",
+            full_name="google.cloud.kms.v1.ImportJob.generate_time",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.cloud.kms.v1.ImportJob.expire_time",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_event_time",
+            full_name="google.cloud.kms.v1.ImportJob.expire_event_time",
+            index=6,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.kms.v1.ImportJob.state",
+            index=7,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="public_key",
+            full_name="google.cloud.kms.v1.ImportJob.public_key",
+            index=8,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attestation",
+            full_name="google.cloud.kms.v1.ImportJob.attestation",
+            index=9,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_IMPORTJOB_WRAPPINGPUBLICKEY],
+    enum_types=[_IMPORTJOB_IMPORTMETHOD, _IMPORTJOB_IMPORTJOBSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2835,
+    serialized_end=3641,
+)
+
+_KEYRING.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEY_LABELSENTRY.containing_type = _CRYPTOKEY
+_CRYPTOKEY.fields_by_name["primary"].message_type = _CRYPTOKEYVERSION
+_CRYPTOKEY.fields_by_name["purpose"].enum_type = _CRYPTOKEY_CRYPTOKEYPURPOSE
+_CRYPTOKEY.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEY.fields_by_name[
+    "next_rotation_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEY.fields_by_name[
+    "rotation_period"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_CRYPTOKEY.fields_by_name["version_template"].message_type = _CRYPTOKEYVERSIONTEMPLATE
+_CRYPTOKEY.fields_by_name["labels"].message_type = _CRYPTOKEY_LABELSENTRY
+_CRYPTOKEY_CRYPTOKEYPURPOSE.containing_type = _CRYPTOKEY
+_CRYPTOKEY.oneofs_by_name["rotation_schedule"].fields.append(
+    _CRYPTOKEY.fields_by_name["rotation_period"]
+)
+_CRYPTOKEY.fields_by_name[
+    "rotation_period"
+].containing_oneof = _CRYPTOKEY.oneofs_by_name["rotation_schedule"]
+_CRYPTOKEYVERSIONTEMPLATE.fields_by_name[
+    "protection_level"
+].enum_type = _PROTECTIONLEVEL
+_CRYPTOKEYVERSIONTEMPLATE.fields_by_name[
+    "algorithm"
+].enum_type = _CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM
+_KEYOPERATIONATTESTATION.fields_by_name[
+    "format"
+].enum_type = _KEYOPERATIONATTESTATION_ATTESTATIONFORMAT
+_KEYOPERATIONATTESTATION_ATTESTATIONFORMAT.containing_type = _KEYOPERATIONATTESTATION
+_CRYPTOKEYVERSION.fields_by_name[
+    "state"
+].enum_type = _CRYPTOKEYVERSION_CRYPTOKEYVERSIONSTATE
+_CRYPTOKEYVERSION.fields_by_name["protection_level"].enum_type = _PROTECTIONLEVEL
+_CRYPTOKEYVERSION.fields_by_name[
+    "algorithm"
+].enum_type = _CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM
+_CRYPTOKEYVERSION.fields_by_name["attestation"].message_type = _KEYOPERATIONATTESTATION
+_CRYPTOKEYVERSION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEYVERSION.fields_by_name[
+    "generate_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEYVERSION.fields_by_name[
+    "destroy_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEYVERSION.fields_by_name[
+    "destroy_event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEYVERSION.fields_by_name[
+    "import_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM.containing_type = _CRYPTOKEYVERSION
+_CRYPTOKEYVERSION_CRYPTOKEYVERSIONSTATE.containing_type = _CRYPTOKEYVERSION
+_CRYPTOKEYVERSION_CRYPTOKEYVERSIONVIEW.containing_type = _CRYPTOKEYVERSION
+_PUBLICKEY.fields_by_name[
+    "algorithm"
+].enum_type = _CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM
+_IMPORTJOB_WRAPPINGPUBLICKEY.containing_type = _IMPORTJOB
+_IMPORTJOB.fields_by_name["import_method"].enum_type = _IMPORTJOB_IMPORTMETHOD
+_IMPORTJOB.fields_by_name["protection_level"].enum_type = _PROTECTIONLEVEL
+_IMPORTJOB.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_IMPORTJOB.fields_by_name[
+    "generate_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_IMPORTJOB.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_IMPORTJOB.fields_by_name[
+    "expire_event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_IMPORTJOB.fields_by_name["state"].enum_type = _IMPORTJOB_IMPORTJOBSTATE
+_IMPORTJOB.fields_by_name["public_key"].message_type = _IMPORTJOB_WRAPPINGPUBLICKEY
+_IMPORTJOB.fields_by_name["attestation"].message_type = _KEYOPERATIONATTESTATION
+_IMPORTJOB_IMPORTMETHOD.containing_type = _IMPORTJOB
+_IMPORTJOB_IMPORTJOBSTATE.containing_type = _IMPORTJOB
+DESCRIPTOR.message_types_by_name["KeyRing"] = _KEYRING
+DESCRIPTOR.message_types_by_name["CryptoKey"] = _CRYPTOKEY
+DESCRIPTOR.message_types_by_name["CryptoKeyVersionTemplate"] = _CRYPTOKEYVERSIONTEMPLATE
+DESCRIPTOR.message_types_by_name["KeyOperationAttestation"] = _KEYOPERATIONATTESTATION
+DESCRIPTOR.message_types_by_name["CryptoKeyVersion"] = _CRYPTOKEYVERSION
+DESCRIPTOR.message_types_by_name["PublicKey"] = _PUBLICKEY
+DESCRIPTOR.message_types_by_name["ImportJob"] = _IMPORTJOB
+DESCRIPTOR.enum_types_by_name["ProtectionLevel"] = _PROTECTIONLEVEL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+KeyRing = _reflection.GeneratedProtocolMessageType(
+    "KeyRing",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KEYRING,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""A [KeyRing][google.cloud.kms.v1.KeyRing] is a toplevel logical grouping
+  of [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name for the
+          [KeyRing][google.cloud.kms.v1.KeyRing] in the format
+          ``projects/*/locations/*/keyRings/*``.
+      create_time:
+          Output only. The time at which this
+          [KeyRing][google.cloud.kms.v1.KeyRing] was created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.KeyRing)
+    ),
+)
+_sym_db.RegisterMessage(KeyRing)
+
+CryptoKey = _reflection.GeneratedProtocolMessageType(
+    "CryptoKey",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CRYPTOKEY_LABELSENTRY,
+                __module__="google.cloud.kms_v1.proto.resources_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CryptoKey.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CRYPTOKEY,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""A [CryptoKey][google.cloud.kms.v1.CryptoKey] represents a logical key
+  that can be used for cryptographic operations.
+  
+  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.
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name for this
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] in the format
+          ``projects/*/locations/*/keyRings/*/cryptoKeys/*``.
+      primary:
+          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
+          in [EncryptRequest.name][google.cloud.kms.v1.EncryptRequest.na
+          me].  The [CryptoKey][google.cloud.kms.v1.CryptoKey]'s primary
+          version can be updated via [UpdateCryptoKeyPrimaryVersion][goo
+          gle.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryVe
+          rsion].  All keys with
+          [purpose][google.cloud.kms.v1.CryptoKey.purpose] [ENCRYPT\_DEC
+          RYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT\_
+          DECRYPT] have a primary. For other keys, this field will be
+          omitted.
+      purpose:
+          The immutable purpose of this
+          [CryptoKey][google.cloud.kms.v1.CryptoKey].
+      create_time:
+          Output only. The time at which this
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] was created.
+      next_rotation_time:
+          At [next\_rotation\_time][google.cloud.kms.v1.CryptoKey.next\_
+          rotation\_time], the Key Management Service will
+          automatically:  1. Create a new version of this
+          [CryptoKey][google.cloud.kms.v1.CryptoKey]. 2. Mark the new
+          version as primary.  Key rotations performed manually via [Cre
+          ateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.
+          CreateCryptoKeyVersion] and [UpdateCryptoKeyPrimaryVersion][go
+          ogle.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryV
+          ersion] do not affect [next\_rotation\_time][google.cloud.kms.
+          v1.CryptoKey.next\_rotation\_time].  Keys with
+          [purpose][google.cloud.kms.v1.CryptoKey.purpose] [ENCRYPT\_DEC
+          RYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT\_
+          DECRYPT] support automatic rotation. For other keys, this
+          field must be omitted.
+      rotation_schedule:
+          Controls the rate of automatic rotation.
+      rotation_period:
+          [next\_rotation\_time][google.cloud.kms.v1.CryptoKey.next\_rot
+          ation\_time] will be advanced by this period when the service
+          automatically rotates a key. Must be at least one day.  If [ro
+          tation\_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.  Keys with
+          [purpose][google.cloud.kms.v1.CryptoKey.purpose] [ENCRYPT\_DEC
+          RYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT\_
+          DECRYPT] support automatic rotation. For other keys, this
+          field must be omitted.
+      version_template:
+          A template describing settings for new
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+          instances. The properties of new
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+          instances created by either [CreateCryptoKeyVersion][google.cl
+          oud.kms.v1.KeyManagementService.CreateCryptoKeyVersion] or
+          auto-rotation are controlled by this template.
+      labels:
+          Labels with user-defined metadata. For more information, see
+          `Labeling Keys </kms/docs/labeling-keys>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CryptoKey)
+    ),
+)
+_sym_db.RegisterMessage(CryptoKey)
+_sym_db.RegisterMessage(CryptoKey.LabelsEntry)
+
+CryptoKeyVersionTemplate = _reflection.GeneratedProtocolMessageType(
+    "CryptoKeyVersionTemplate",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRYPTOKEYVERSIONTEMPLATE,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""A
+  [CryptoKeyVersionTemplate][google.cloud.kms.v1.CryptoKeyVersionTemplate]
+  specifies the properties to use when creating a new
+  [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], either
+  manually with
+  [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion]
+  or automatically as a result of auto-rotation.
+  
+  
+  Attributes:
+      protection_level:
+          [ProtectionLevel][google.cloud.kms.v1.ProtectionLevel] to use
+          when creating a
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] based
+          on this template. Immutable. Defaults to
+          [SOFTWARE][google.cloud.kms.v1.ProtectionLevel.SOFTWARE].
+      algorithm:
+          Required. [Algorithm][google.cloud.kms.v1.CryptoKeyVersion.Cry
+          ptoKeyVersionAlgorithm] to use when creating a
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] based
+          on this template.  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.CryptoKeyPurp
+          ose.ENCRYPT\_DECRYPT].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CryptoKeyVersionTemplate)
+    ),
+)
+_sym_db.RegisterMessage(CryptoKeyVersionTemplate)
+
+KeyOperationAttestation = _reflection.GeneratedProtocolMessageType(
+    "KeyOperationAttestation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KEYOPERATIONATTESTATION,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""Contains an HSM-generated attestation about a key operation. For more
+  information, see [Verifying attestations]
+  (https://cloud.google.com/kms/docs/attest-key).
+  
+  
+  Attributes:
+      format:
+          Output only. The format of the attestation data.
+      content:
+          Output only. The attestation data provided by the HSM when the
+          key operation was performed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.KeyOperationAttestation)
+    ),
+)
+_sym_db.RegisterMessage(KeyOperationAttestation)
+
+CryptoKeyVersion = _reflection.GeneratedProtocolMessageType(
+    "CryptoKeyVersion",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRYPTOKEYVERSION,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] represents an
+  individual cryptographic key, and the associated key material.
+  
+  An
+  [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED]
+  version can be used for cryptographic operations.
+  
+  For security reasons, the raw cryptographic key material represented by
+  a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] can never be
+  viewed or exported. It can only be used to encrypt, decrypt, or sign
+  data when an authorized user or application invokes Cloud KMS.
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name for this
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in
+          the format ``projects/*/locations/*/keyRings/*/cryptoKeys/*/cr
+          yptoKeyVersions/*``.
+      state:
+          The current state of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
+      protection_level:
+          Output only. The
+          [ProtectionLevel][google.cloud.kms.v1.ProtectionLevel]
+          describing how crypto operations are performed with this
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
+      algorithm:
+          Output only. The [CryptoKeyVersionAlgorithm][google.cloud.kms.
+          v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm] that this
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+          supports.
+      attestation:
+          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].
+      create_time:
+          Output only. The time at which this
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] was
+          created.
+      generate_time:
+          Output only. The time this
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key
+          material was generated.
+      destroy_time:
+          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 [DESTRO
+          Y\_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVe
+          rsionState.DESTROY\_SCHEDULED].
+      destroy_event_time:
+          Output only. The time this CryptoKeyVersion's key material was
+          destroyed. Only present if
+          [state][google.cloud.kms.v1.CryptoKeyVersion.state] is [DESTRO
+          YED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionStat
+          e.DESTROYED].
+      import_job:
+          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.
+      import_time:
+          Output only. The time at which this
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key
+          material was imported.
+      import_failure_reason:
+          Output only. The root cause of an import failure. Only present
+          if [state][google.cloud.kms.v1.CryptoKeyVersion.state] is [IMP
+          ORT\_FAILED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVer
+          sionState.IMPORT\_FAILED].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CryptoKeyVersion)
+    ),
+)
+_sym_db.RegisterMessage(CryptoKeyVersion)
+
+PublicKey = _reflection.GeneratedProtocolMessageType(
+    "PublicKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBLICKEY,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""The public key for a given
+  [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. Obtained via
+  [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+  
+  
+  Attributes:
+      pem:
+          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
+          [Textual Encoding of Subject Public Key Info]
+          (https://tools.ietf.org/html/rfc7468#section-13).
+      algorithm:
+          The [Algorithm][google.cloud.kms.v1.CryptoKeyVersion.CryptoKey
+          VersionAlgorithm] associated with this key.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.PublicKey)
+    ),
+)
+_sym_db.RegisterMessage(PublicKey)
+
+ImportJob = _reflection.GeneratedProtocolMessageType(
+    "ImportJob",
+    (_message.Message,),
+    dict(
+        WrappingPublicKey=_reflection.GeneratedProtocolMessageType(
+            "WrappingPublicKey",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_IMPORTJOB_WRAPPINGPUBLICKEY,
+                __module__="google.cloud.kms_v1.proto.resources_pb2",
+                __doc__="""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].
+    
+    
+    Attributes:
+        pem:
+            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
+            [Textual Encoding of Subject Public Key Info]
+            (https://tools.ietf.org/html/rfc7468#section-13).
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ImportJob.WrappingPublicKey)
+            ),
+        ),
+        DESCRIPTOR=_IMPORTJOB,
+        __module__="google.cloud.kms_v1.proto.resources_pb2",
+        __doc__="""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.
+  
+  When an [ImportJob][google.cloud.kms.v1.ImportJob] is created, Cloud KMS
+  will generate a "wrapping key", which is a public/private key pair. You
+  use the wrapping key to encrypt (also known as wrap) the pre-existing
+  key material to protect it during the import process. The nature of the
+  wrapping key depends on the choice of
+  [import\_method][google.cloud.kms.v1.ImportJob.import\_method]. When the
+  wrapping key generation is complete, the
+  [state][google.cloud.kms.v1.ImportJob.state] will be set to
+  [ACTIVE][google.cloud.kms.v1.ImportJob.ImportJobState.ACTIVE] and the
+  [public\_key][google.cloud.kms.v1.ImportJob.public\_key] can be fetched.
+  The fetched public key can then be used to wrap your pre-existing key
+  material.
+  
+  Once the key material is wrapped, it can be imported into a new
+  [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in an existing
+  [CryptoKey][google.cloud.kms.v1.CryptoKey] by calling
+  [ImportCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion].
+  Multiple [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] can
+  be imported with a single [ImportJob][google.cloud.kms.v1.ImportJob].
+  Cloud KMS uses the private key portion of the wrapping key to unwrap the
+  key material. Only Cloud KMS has access to the private key.
+  
+  An [ImportJob][google.cloud.kms.v1.ImportJob] expires 3 days after it is
+  created. Once expired, Cloud KMS will no longer be able to import or
+  unwrap any key material that was wrapped with the
+  [ImportJob][google.cloud.kms.v1.ImportJob]'s public key.
+  
+  For more information, see `Importing a
+  key <https://cloud.google.com/kms/docs/importing-a-key>`__.
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name for this
+          [ImportJob][google.cloud.kms.v1.ImportJob] in the format
+          ``projects/*/locations/*/keyRings/*/importJobs/*``.
+      import_method:
+          Required and immutable. The wrapping method to be used for
+          incoming key material.
+      protection_level:
+          Required and immutable. The protection level of the
+          [ImportJob][google.cloud.kms.v1.ImportJob]. This must match
+          the [protection\_level][google.cloud.kms.v1.CryptoKeyVersionTe
+          mplate.protection\_level] of the [version\_template][google.cl
+          oud.kms.v1.CryptoKey.version\_template] on the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] you attempt to
+          import into.
+      create_time:
+          Output only. The time at which this
+          [ImportJob][google.cloud.kms.v1.ImportJob] was created.
+      generate_time:
+          Output only. The time this
+          [ImportJob][google.cloud.kms.v1.ImportJob]'s key material was
+          generated.
+      expire_time:
+          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.
+      expire_event_time:
+          Output only. The time this
+          [ImportJob][google.cloud.kms.v1.ImportJob] expired. Only
+          present if [state][google.cloud.kms.v1.ImportJob.state] is [EX
+          PIRED][google.cloud.kms.v1.ImportJob.ImportJobState.EXPIRED].
+      state:
+          Output only. The current state of the
+          [ImportJob][google.cloud.kms.v1.ImportJob], indicating if it
+          can be used.
+      public_key:
+          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].
+      attestation:
+          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].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ImportJob)
+    ),
+)
+_sym_db.RegisterMessage(ImportJob)
+_sym_db.RegisterMessage(ImportJob.WrappingPublicKey)
+
+
+DESCRIPTOR._options = None
+_CRYPTOKEY_LABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/kms/google/cloud/kms_v1/proto/resources_pb2_grpc.py b/kms/google/cloud/kms_v1/proto/resources_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/kms/google/cloud/kms_v1/proto/resources_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/kms/google/cloud/kms_v1/proto/service.proto b/kms/google/cloud/kms_v1/proto/service.proto
new file mode 100644
index 000000000000..0f1266dfe834
--- /dev/null
+++ b/kms/google/cloud/kms_v1/proto/service.proto
@@ -0,0 +1,718 @@
+// 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.kms.v1;
+
+import "google/api/annotations.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";
+option go_package = "google.golang.org/genproto/googleapis/cloud/kms/v1;kms";
+option java_multiple_files = true;
+option java_outer_classname = "KmsProto";
+option java_package = "com.google.cloud.kms.v1";
+option php_namespace = "Google\\Cloud\\Kms\\V1";
+
+// Google Cloud Key Management Service
+//
+// Manages cryptographic keys and operations using those keys. Implements a REST
+// model with the following objects:
+//
+// * [KeyRing][google.cloud.kms.v1.KeyRing]
+// * [CryptoKey][google.cloud.kms.v1.CryptoKey]
+// * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+//
+// If you are using manual gRPC libraries, see
+// [Using gRPC with Cloud KMS](https://cloud.google.com/kms/docs/grpc).
+service KeyManagementService {
+  option (google.api.default_host) = "cloudkms.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloudkms";
+
+  // Lists [KeyRings][google.cloud.kms.v1.KeyRing].
+  rpc ListKeyRings(ListKeyRingsRequest) returns (ListKeyRingsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/keyRings"
+    };
+  }
+
+  // Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+  rpc ListCryptoKeys(ListCryptoKeysRequest) returns (ListCryptoKeysResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys"
+    };
+  }
+
+  // Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
+  rpc ListCryptoKeyVersions(ListCryptoKeyVersionsRequest) returns (ListCryptoKeyVersionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions"
+    };
+  }
+
+  // Lists [ImportJobs][google.cloud.kms.v1.ImportJob].
+  rpc ListImportJobs(ListImportJobsRequest) returns (ListImportJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs"
+    };
+  }
+
+  // Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].
+  rpc GetKeyRing(GetKeyRingRequest) returns (KeyRing) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/keyRings/*}"
+    };
+  }
+
+  // Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as well as its
+  // [primary][google.cloud.kms.v1.CryptoKey.primary] [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
+  rpc GetCryptoKey(GetCryptoKeyRequest) returns (CryptoKey) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}"
+    };
+  }
+
+  // Returns metadata for a given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
+  rpc GetCryptoKeyVersion(GetCryptoKeyVersionRequest) returns (CryptoKeyVersion) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}"
+    };
+  }
+
+  // Returns the public key for the given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The
+  // [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be
+  // [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] or
+  // [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].
+  rpc GetPublicKey(GetPublicKeyRequest) returns (PublicKey) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}/publicKey"
+    };
+  }
+
+  // Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].
+  rpc GetImportJob(GetImportJobRequest) returns (ImportJob) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/keyRings/*/importJobs/*}"
+    };
+  }
+
+  // Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and Location.
+  rpc CreateKeyRing(CreateKeyRingRequest) returns (KeyRing) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/keyRings"
+      body: "key_ring"
+    };
+  }
+
+  // Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a [KeyRing][google.cloud.kms.v1.KeyRing].
+  //
+  // [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and
+  // [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm]
+  // are required.
+  rpc CreateCryptoKey(CreateCryptoKeyRequest) returns (CryptoKey) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys"
+      body: "crypto_key"
+    };
+  }
+
+  // Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  //
+  // The server will assign the next sequential id. If unset,
+  // [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to
+  // [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED].
+  rpc CreateCryptoKeyVersion(CreateCryptoKeyVersionRequest) returns (CryptoKeyVersion) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions"
+      body: "crypto_key_version"
+    };
+  }
+
+  // Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the
+  // wrapped key material provided in the request.
+  //
+  // The version ID will be assigned the next sequential id within the
+  // [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  rpc ImportCryptoKeyVersion(ImportCryptoKeyVersionRequest) returns (CryptoKeyVersion) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions:import"
+      body: "*"
+    };
+  }
+
+  // Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a [KeyRing][google.cloud.kms.v1.KeyRing].
+  //
+  // [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is required.
+  rpc CreateImportJob(CreateImportJobRequest) returns (ImportJob) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs"
+      body: "import_job"
+    };
+  }
+
+  // Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  rpc UpdateCryptoKey(UpdateCryptoKeyRequest) returns (CryptoKey) {
+    option (google.api.http) = {
+      patch: "/v1/{crypto_key.name=projects/*/locations/*/keyRings/*/cryptoKeys/*}"
+      body: "crypto_key"
+    };
+  }
+
+  // Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s metadata.
+  //
+  // [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between
+  // [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] and
+  // [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] using this
+  // method. See [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] and [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] to
+  // move between other states.
+  rpc UpdateCryptoKeyVersion(UpdateCryptoKeyVersionRequest) returns (CryptoKeyVersion) {
+    option (google.api.http) = {
+      patch: "/v1/{crypto_key_version.name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}"
+      body: "crypto_key_version"
+    };
+  }
+
+  // Encrypts data, so that it can only be recovered by a call to [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
+  // The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be
+  // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].
+  rpc Encrypt(EncryptRequest) returns (EncryptResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/**}:encrypt"
+      body: "*"
+    };
+  }
+
+  // Decrypts data that was protected by [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // must be [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].
+  rpc Decrypt(DecryptRequest) returns (DecryptResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:decrypt"
+      body: "*"
+    };
+  }
+
+  // Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // ASYMMETRIC_SIGN, producing a signature that can be verified with the public
+  // key retrieved from [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+  rpc AsymmetricSign(AsymmetricSignRequest) returns (AsymmetricSignResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricSign"
+      body: "*"
+    };
+  }
+
+  // Decrypts data that was encrypted with a public key retrieved from
+  // [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with
+  // [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] ASYMMETRIC_DECRYPT.
+  rpc AsymmetricDecrypt(AsymmetricDecryptRequest) returns (AsymmetricDecryptResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricDecrypt"
+      body: "*"
+    };
+  }
+
+  // Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that will be used in [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
+  //
+  // Returns an error if called on an asymmetric key.
+  rpc UpdateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest) returns (CryptoKey) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:updatePrimaryVersion"
+      body: "*"
+    };
+  }
+
+  // Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for destruction.
+  //
+  // Upon calling this method, [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to
+  // [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED]
+  // and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will be set to a time 24
+  // hours in the future, at which point the [state][google.cloud.kms.v1.CryptoKeyVersion.state]
+  // will be changed to
+  // [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], and the key
+  // material will be irrevocably destroyed.
+  //
+  // Before the [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is reached,
+  // [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] may be called to reverse the process.
+  rpc DestroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest) returns (CryptoKeyVersion) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:destroy"
+      body: "*"
+    };
+  }
+
+  // Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the
+  // [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED]
+  // state.
+  //
+  // Upon restoration of the CryptoKeyVersion, [state][google.cloud.kms.v1.CryptoKeyVersion.state]
+  // will be set to [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED],
+  // and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will be cleared.
+  rpc RestoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest) returns (CryptoKeyVersion) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:restore"
+      body: "*"
+    };
+  }
+}
+
+// Request message for [KeyManagementService.ListKeyRings][google.cloud.kms.v1.KeyManagementService.ListKeyRings].
+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
+  // 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;
+
+  // Optional pagination token, returned earlier via
+  // [ListKeyRingsResponse.next_page_token][google.cloud.kms.v1.ListKeyRingsResponse.next_page_token].
+  string page_token = 3;
+
+  // Optional. Only include resources that match the filter in the response.
+  string filter = 4;
+
+  // Optional. Specify how the results should be sorted. If not specified, the
+  // results will be sorted in the default order.
+  string order_by = 5;
+}
+
+// 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
+  // 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;
+
+  // Optional pagination token, returned earlier via
+  // [ListCryptoKeysResponse.next_page_token][google.cloud.kms.v1.ListCryptoKeysResponse.next_page_token].
+  string page_token = 3;
+
+  // 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. Specify how the results should be sorted. If not specified, the
+  // results will be sorted in the default order.
+  string order_by = 6;
+}
+
+// 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
+  // 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;
+
+  // Optional pagination token, returned earlier via
+  // [ListCryptoKeyVersionsResponse.next_page_token][google.cloud.kms.v1.ListCryptoKeyVersionsResponse.next_page_token].
+  string page_token = 3;
+
+  // 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. Specify how the results should be sorted. If not specified, the
+  // results will be sorted in the default order.
+  string order_by = 6;
+}
+
+// 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
+  // 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;
+
+  // Optional pagination token, returned earlier via
+  // [ListImportJobsResponse.next_page_token][google.cloud.kms.v1.ListImportJobsResponse.next_page_token].
+  string page_token = 3;
+
+  // Optional. Only include resources that match the filter in the response.
+  string filter = 4;
+
+  // Optional. Specify how the results should be sorted. If not specified, the
+  // results will be sorted in the default order.
+  string order_by = 5;
+}
+
+// Response message for [KeyManagementService.ListKeyRings][google.cloud.kms.v1.KeyManagementService.ListKeyRings].
+message ListKeyRingsResponse {
+  // The list of [KeyRings][google.cloud.kms.v1.KeyRing].
+  repeated KeyRing key_rings = 1;
+
+  // A token to retrieve next page of results. Pass this value in
+  // [ListKeyRingsRequest.page_token][google.cloud.kms.v1.ListKeyRingsRequest.page_token] to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // The total number of [KeyRings][google.cloud.kms.v1.KeyRing] that matched the query.
+  int32 total_size = 3;
+}
+
+// Response message for [KeyManagementService.ListCryptoKeys][google.cloud.kms.v1.KeyManagementService.ListCryptoKeys].
+message ListCryptoKeysResponse {
+  // The list of [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+  repeated CryptoKey crypto_keys = 1;
+
+  // A token to retrieve next page of results. Pass this value in
+  // [ListCryptoKeysRequest.page_token][google.cloud.kms.v1.ListCryptoKeysRequest.page_token] to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // The total number of [CryptoKeys][google.cloud.kms.v1.CryptoKey] that matched the query.
+  int32 total_size = 3;
+}
+
+// Response message for [KeyManagementService.ListCryptoKeyVersions][google.cloud.kms.v1.KeyManagementService.ListCryptoKeyVersions].
+message ListCryptoKeyVersionsResponse {
+  // The list of [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
+  repeated CryptoKeyVersion crypto_key_versions = 1;
+
+  // A token to retrieve next page of results. Pass this value in
+  // [ListCryptoKeyVersionsRequest.page_token][google.cloud.kms.v1.ListCryptoKeyVersionsRequest.page_token] to retrieve the next page of
+  // results.
+  string next_page_token = 2;
+
+  // The total number of [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] that matched the
+  // query.
+  int32 total_size = 3;
+}
+
+// Response message for [KeyManagementService.ListImportJobs][google.cloud.kms.v1.KeyManagementService.ListImportJobs].
+message ListImportJobsResponse {
+  // The list of [ImportJobs][google.cloud.kms.v1.ImportJob].
+  repeated ImportJob import_jobs = 1;
+
+  // A token to retrieve next page of results. Pass this value in
+  // [ListImportJobsRequest.page_token][google.cloud.kms.v1.ListImportJobsRequest.page_token] to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // The total number of [ImportJobs][google.cloud.kms.v1.ImportJob] that matched the query.
+  int32 total_size = 3;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// 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
+  // get.
+  string name = 1;
+}
+
+// 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;
+}
+
+// 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;
+
+  // Required. It must be unique within a location and match the regular
+  // expression `[a-zA-Z0-9_-]{1,63}`
+  string key_ring_id = 2;
+
+  // A [KeyRing][google.cloud.kms.v1.KeyRing] with initial field values.
+  KeyRing key_ring = 3;
+}
+
+// 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;
+
+  // Required. It must be unique within a KeyRing and match the regular
+  // expression `[a-zA-Z0-9_-]{1,63}`
+  string crypto_key_id = 2;
+
+  // A [CryptoKey][google.cloud.kms.v1.CryptoKey] with initial field values.
+  CryptoKey crypto_key = 3;
+
+  // 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
+  // [CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion] or
+  // [ImportCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion]
+  // before you can use this [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  bool skip_initial_version_creation = 5;
+}
+
+// Request message for [KeyManagementService.CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion].
+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;
+
+  // A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with initial field values.
+  CryptoKeyVersion crypto_key_version = 2;
+}
+
+// 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;
+
+  // 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;
+
+  // 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;
+
+  // Required. The incoming wrapped key material that is to be imported.
+  oneof wrapped_key_material {
+    // Wrapped key material produced with
+    // [RSA_OAEP_3072_SHA1_AES_256][google.cloud.kms.v1.ImportJob.ImportMethod.RSA_OAEP_3072_SHA1_AES_256]
+    // or
+    // [RSA_OAEP_4096_SHA1_AES_256][google.cloud.kms.v1.ImportJob.ImportMethod.RSA_OAEP_4096_SHA1_AES_256].
+    //
+    // This field contains the concatenation of two wrapped keys:
+    // <ol>
+    //   <li>An ephemeral AES-256 wrapping key wrapped with the
+    //       [public_key][google.cloud.kms.v1.ImportJob.public_key] using RSAES-OAEP with SHA-1,
+    //       MGF1 with SHA-1, and an empty label.
+    //   </li>
+    //   <li>The key to be imported, wrapped with the ephemeral AES-256 key
+    //       using AES-KWP (RFC 5649).
+    //   </li>
+    // </ol>
+    //
+    // This format is the same as the format produced by PKCS#11 mechanism
+    // CKM_RSA_AES_KEY_WRAP.
+    bytes rsa_aes_wrapped_key = 5;
+  }
+}
+
+// Request message for [KeyManagementService.CreateImportJob][google.cloud.kms.v1.KeyManagementService.CreateImportJob].
+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;
+
+  // Required. It must be unique within a KeyRing and match the regular
+  // expression `[a-zA-Z0-9_-]{1,63}`
+  string import_job_id = 2;
+
+  // Required. An [ImportJob][google.cloud.kms.v1.ImportJob] with initial field values.
+  ImportJob import_job = 3;
+}
+
+// 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 list of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// 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 list of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for [KeyManagementService.Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
+message EncryptRequest {
+  // Required. The resource name of the [CryptoKey][google.cloud.kms.v1.CryptoKey] or [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+  // to use for encryption.
+  //
+  // 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;
+
+  // Required. The data to encrypt. Must be no larger than 64KiB.
+  //
+  // The maximum size depends on the key version's
+  // [protection_level][google.cloud.kms.v1.CryptoKeyVersionTemplate.protection_level]. For
+  // [SOFTWARE][google.cloud.kms.v1.ProtectionLevel.SOFTWARE] keys, the plaintext must be no larger
+  // 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;
+
+  // 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
+  // [protection_level][google.cloud.kms.v1.CryptoKeyVersionTemplate.protection_level]. For
+  // [SOFTWARE][google.cloud.kms.v1.ProtectionLevel.SOFTWARE] keys, the AAD must be no larger 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 additional_authenticated_data = 3;
+}
+
+// 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;
+
+  // Required. The encrypted data originally returned in
+  // [EncryptResponse.ciphertext][google.cloud.kms.v1.EncryptResponse.ciphertext].
+  bytes ciphertext = 2;
+
+  // 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;
+}
+
+// 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;
+
+  // 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;
+}
+
+// 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;
+
+  // Required. The data encrypted with the named [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s public
+  // key using OAEP.
+  bytes ciphertext = 3;
+}
+
+// Response message for [KeyManagementService.Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
+message DecryptResponse {
+  // The decrypted data originally supplied in [EncryptRequest.plaintext][google.cloud.kms.v1.EncryptRequest.plaintext].
+  bytes plaintext = 1;
+}
+
+// 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.
+  string name = 1;
+
+  // The encrypted data.
+  bytes ciphertext = 2;
+}
+
+// Response message for [KeyManagementService.AsymmetricSign][google.cloud.kms.v1.KeyManagementService.AsymmetricSign].
+message AsymmetricSignResponse {
+  // The created signature.
+  bytes signature = 1;
+}
+
+// Response message for [KeyManagementService.AsymmetricDecrypt][google.cloud.kms.v1.KeyManagementService.AsymmetricDecrypt].
+message AsymmetricDecryptResponse {
+  // The decrypted data originally encrypted with the matching public key.
+  bytes plaintext = 1;
+}
+
+// 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;
+
+  // The id of the child [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use as primary.
+  string crypto_key_version_id = 2;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// A [Digest][google.cloud.kms.v1.Digest] holds a cryptographic message digest.
+message Digest {
+  // Required. The message digest.
+  oneof digest {
+    // A message digest produced with the SHA-256 algorithm.
+    bytes sha256 = 1;
+
+    // A message digest produced with the SHA-384 algorithm.
+    bytes sha384 = 2;
+
+    // A message digest produced with the SHA-512 algorithm.
+    bytes sha512 = 3;
+  }
+}
+
+// Cloud KMS metadata for the given [google.cloud.location.Location][google.cloud.location.Location].
+message LocationMetadata {
+  // Indicates whether [CryptoKeys][google.cloud.kms.v1.CryptoKey] with
+  // [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;
+}
diff --git a/kms/google/cloud/kms_v1/proto/service_pb2.py b/kms/google/cloud/kms_v1/proto/service_pb2.py
new file mode 100644
index 000000000000..8342ee0a60af
--- /dev/null
+++ b/kms/google/cloud/kms_v1/proto/service_pb2.py
@@ -0,0 +1,3536 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/kms_v1/proto/service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.kms_v1.proto import (
+    resources_pb2 as google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2,
+)
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/kms_v1/proto/service.proto",
+    package="google.cloud.kms.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\027com.google.cloud.kms.v1B\010KmsProtoP\001Z6google.golang.org/genproto/googleapis/cloud/kms/v1;kms\370\001\001\252\002\023Google.Cloud.Kms.V1\312\002\023Google\\Cloud\\Kms\\V1"
+    ),
+    serialized_pb=_b(
+        '\n\'google/cloud/kms_v1/proto/service.proto\x12\x13google.cloud.kms.v1\x1a\x1cgoogle/api/annotations.proto\x1a)google/cloud/kms_v1/proto/resources.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/api/client.proto"n\n\x13ListKeyRingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t"\xc2\x01\n\x15ListCryptoKeysRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12P\n\x0cversion_view\x18\x04 \x01(\x0e\x32:.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionView\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t"\xc1\x01\n\x1cListCryptoKeyVersionsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12H\n\x04view\x18\x04 \x01(\x0e\x32:.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionView\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t"p\n\x15ListImportJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t\x12\x10\n\x08order_by\x18\x05 \x01(\t"t\n\x14ListKeyRingsResponse\x12/\n\tkey_rings\x18\x01 \x03(\x0b\x32\x1c.google.cloud.kms.v1.KeyRing\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"z\n\x16ListCryptoKeysResponse\x12\x33\n\x0b\x63rypto_keys\x18\x01 \x03(\x0b\x32\x1e.google.cloud.kms.v1.CryptoKey\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"\x90\x01\n\x1dListCryptoKeyVersionsResponse\x12\x42\n\x13\x63rypto_key_versions\x18\x01 \x03(\x0b\x32%.google.cloud.kms.v1.CryptoKeyVersion\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"z\n\x16ListImportJobsResponse\x12\x33\n\x0bimport_jobs\x18\x01 \x03(\x0b\x32\x1e.google.cloud.kms.v1.ImportJob\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"!\n\x11GetKeyRingRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"#\n\x13GetCryptoKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"*\n\x1aGetCryptoKeyVersionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"#\n\x13GetPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"#\n\x13GetImportJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"k\n\x14\x43reateKeyRingRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0bkey_ring_id\x18\x02 \x01(\t\x12.\n\x08key_ring\x18\x03 \x01(\x0b\x32\x1c.google.cloud.kms.v1.KeyRing"\x9a\x01\n\x16\x43reateCryptoKeyRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x15\n\rcrypto_key_id\x18\x02 \x01(\t\x12\x32\n\ncrypto_key\x18\x03 \x01(\x0b\x32\x1e.google.cloud.kms.v1.CryptoKey\x12%\n\x1dskip_initial_version_creation\x18\x05 \x01(\x08"r\n\x1d\x43reateCryptoKeyVersionRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x41\n\x12\x63rypto_key_version\x18\x02 \x01(\x0b\x32%.google.cloud.kms.v1.CryptoKeyVersion"\xce\x01\n\x1dImportCryptoKeyVersionRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12R\n\talgorithm\x18\x02 \x01(\x0e\x32?.google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm\x12\x12\n\nimport_job\x18\x04 \x01(\t\x12\x1d\n\x13rsa_aes_wrapped_key\x18\x05 \x01(\x0cH\x00\x42\x16\n\x14wrapped_key_material"s\n\x16\x43reateImportJobRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x15\n\rimport_job_id\x18\x02 \x01(\t\x12\x32\n\nimport_job\x18\x03 \x01(\x0b\x32\x1e.google.cloud.kms.v1.ImportJob"}\n\x16UpdateCryptoKeyRequest\x12\x32\n\ncrypto_key\x18\x01 \x01(\x0b\x32\x1e.google.cloud.kms.v1.CryptoKey\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x93\x01\n\x1dUpdateCryptoKeyVersionRequest\x12\x41\n\x12\x63rypto_key_version\x18\x01 \x01(\x0b\x32%.google.cloud.kms.v1.CryptoKeyVersion\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"X\n\x0e\x45ncryptRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tplaintext\x18\x02 \x01(\x0c\x12%\n\x1d\x61\x64\x64itional_authenticated_data\x18\x03 \x01(\x0c"Y\n\x0e\x44\x65\x63ryptRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nciphertext\x18\x02 \x01(\x0c\x12%\n\x1d\x61\x64\x64itional_authenticated_data\x18\x03 \x01(\x0c"R\n\x15\x41symmetricSignRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12+\n\x06\x64igest\x18\x03 \x01(\x0b\x32\x1b.google.cloud.kms.v1.Digest"<\n\x18\x41symmetricDecryptRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nciphertext\x18\x03 \x01(\x0c"$\n\x0f\x44\x65\x63ryptResponse\x12\x11\n\tplaintext\x18\x01 \x01(\x0c"3\n\x0f\x45ncryptResponse\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nciphertext\x18\x02 \x01(\x0c"+\n\x16\x41symmetricSignResponse\x12\x11\n\tsignature\x18\x01 \x01(\x0c".\n\x19\x41symmetricDecryptResponse\x12\x11\n\tplaintext\x18\x01 \x01(\x0c"S\n$UpdateCryptoKeyPrimaryVersionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1d\n\x15\x63rypto_key_version_id\x18\x02 \x01(\t".\n\x1e\x44\x65stroyCryptoKeyVersionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t".\n\x1eRestoreCryptoKeyVersionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"H\n\x06\x44igest\x12\x10\n\x06sha256\x18\x01 \x01(\x0cH\x00\x12\x10\n\x06sha384\x18\x02 \x01(\x0cH\x00\x12\x10\n\x06sha512\x18\x03 \x01(\x0cH\x00\x42\x08\n\x06\x64igest")\n\x10LocationMetadata\x12\x15\n\rhsm_available\x18\x01 \x01(\x08\x32\x97#\n\x14KeyManagementService\x12\x99\x01\n\x0cListKeyRings\x12(.google.cloud.kms.v1.ListKeyRingsRequest\x1a).google.cloud.kms.v1.ListKeyRingsResponse"4\x82\xd3\xe4\x93\x02.\x12,/v1/{parent=projects/*/locations/*}/keyRings\x12\xac\x01\n\x0eListCryptoKeys\x12*.google.cloud.kms.v1.ListCryptoKeysRequest\x1a+.google.cloud.kms.v1.ListCryptoKeysResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys\x12\xd5\x01\n\x15ListCryptoKeyVersions\x12\x31.google.cloud.kms.v1.ListCryptoKeyVersionsRequest\x1a\x32.google.cloud.kms.v1.ListCryptoKeyVersionsResponse"U\x82\xd3\xe4\x93\x02O\x12M/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions\x12\xac\x01\n\x0eListImportJobs\x12*.google.cloud.kms.v1.ListImportJobsRequest\x1a+.google.cloud.kms.v1.ListImportJobsResponse"A\x82\xd3\xe4\x93\x02;\x12\x39/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs\x12\x88\x01\n\nGetKeyRing\x12&.google.cloud.kms.v1.GetKeyRingRequest\x1a\x1c.google.cloud.kms.v1.KeyRing"4\x82\xd3\xe4\x93\x02.\x12,/v1/{name=projects/*/locations/*/keyRings/*}\x12\x9b\x01\n\x0cGetCryptoKey\x12(.google.cloud.kms.v1.GetCryptoKeyRequest\x1a\x1e.google.cloud.kms.v1.CryptoKey"A\x82\xd3\xe4\x93\x02;\x12\x39/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}\x12\xc4\x01\n\x13GetCryptoKeyVersion\x12/.google.cloud.kms.v1.GetCryptoKeyVersionRequest\x1a%.google.cloud.kms.v1.CryptoKeyVersion"U\x82\xd3\xe4\x93\x02O\x12M/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}\x12\xb9\x01\n\x0cGetPublicKey\x12(.google.cloud.kms.v1.GetPublicKeyRequest\x1a\x1e.google.cloud.kms.v1.PublicKey"_\x82\xd3\xe4\x93\x02Y\x12W/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}/publicKey\x12\x9b\x01\n\x0cGetImportJob\x12(.google.cloud.kms.v1.GetImportJobRequest\x1a\x1e.google.cloud.kms.v1.ImportJob"A\x82\xd3\xe4\x93\x02;\x12\x39/v1/{name=projects/*/locations/*/keyRings/*/importJobs/*}\x12\x98\x01\n\rCreateKeyRing\x12).google.cloud.kms.v1.CreateKeyRingRequest\x1a\x1c.google.cloud.kms.v1.KeyRing">\x82\xd3\xe4\x93\x02\x38",/v1/{parent=projects/*/locations/*}/keyRings:\x08key_ring\x12\xad\x01\n\x0f\x43reateCryptoKey\x12+.google.cloud.kms.v1.CreateCryptoKeyRequest\x1a\x1e.google.cloud.kms.v1.CryptoKey"M\x82\xd3\xe4\x93\x02G"9/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys:\ncrypto_key\x12\xde\x01\n\x16\x43reateCryptoKeyVersion\x12\x32.google.cloud.kms.v1.CreateCryptoKeyVersionRequest\x1a%.google.cloud.kms.v1.CryptoKeyVersion"i\x82\xd3\xe4\x93\x02\x63"M/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions:\x12\x63rypto_key_version\x12\xd4\x01\n\x16ImportCryptoKeyVersion\x12\x32.google.cloud.kms.v1.ImportCryptoKeyVersionRequest\x1a%.google.cloud.kms.v1.CryptoKeyVersion"_\x82\xd3\xe4\x93\x02Y"T/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions:import:\x01*\x12\xad\x01\n\x0f\x43reateImportJob\x12+.google.cloud.kms.v1.CreateImportJobRequest\x1a\x1e.google.cloud.kms.v1.ImportJob"M\x82\xd3\xe4\x93\x02G"9/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs:\nimport_job\x12\xb8\x01\n\x0fUpdateCryptoKey\x12+.google.cloud.kms.v1.UpdateCryptoKeyRequest\x1a\x1e.google.cloud.kms.v1.CryptoKey"X\x82\xd3\xe4\x93\x02R2D/v1/{crypto_key.name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:\ncrypto_key\x12\xf1\x01\n\x16UpdateCryptoKeyVersion\x12\x32.google.cloud.kms.v1.UpdateCryptoKeyVersionRequest\x1a%.google.cloud.kms.v1.CryptoKeyVersion"|\x82\xd3\xe4\x93\x02v2`/v1/{crypto_key_version.name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:\x12\x63rypto_key_version\x12\xa3\x01\n\x07\x45ncrypt\x12#.google.cloud.kms.v1.EncryptRequest\x1a$.google.cloud.kms.v1.EncryptResponse"M\x82\xd3\xe4\x93\x02G"B/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/**}:encrypt:\x01*\x12\xa2\x01\n\x07\x44\x65\x63rypt\x12#.google.cloud.kms.v1.DecryptRequest\x1a$.google.cloud.kms.v1.DecryptResponse"L\x82\xd3\xe4\x93\x02\x46"A/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:decrypt:\x01*\x12\xd2\x01\n\x0e\x41symmetricSign\x12*.google.cloud.kms.v1.AsymmetricSignRequest\x1a+.google.cloud.kms.v1.AsymmetricSignResponse"g\x82\xd3\xe4\x93\x02\x61"\\/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricSign:\x01*\x12\xde\x01\n\x11\x41symmetricDecrypt\x12-.google.cloud.kms.v1.AsymmetricDecryptRequest\x1a..google.cloud.kms.v1.AsymmetricDecryptResponse"j\x82\xd3\xe4\x93\x02\x64"_/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricDecrypt:\x01*\x12\xd5\x01\n\x1dUpdateCryptoKeyPrimaryVersion\x12\x39.google.cloud.kms.v1.UpdateCryptoKeyPrimaryVersionRequest\x1a\x1e.google.cloud.kms.v1.CryptoKey"Y\x82\xd3\xe4\x93\x02S"N/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:updatePrimaryVersion:\x01*\x12\xd7\x01\n\x17\x44\x65stroyCryptoKeyVersion\x12\x33.google.cloud.kms.v1.DestroyCryptoKeyVersionRequest\x1a%.google.cloud.kms.v1.CryptoKeyVersion"`\x82\xd3\xe4\x93\x02Z"U/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:destroy:\x01*\x12\xd7\x01\n\x17RestoreCryptoKeyVersion\x12\x33.google.cloud.kms.v1.RestoreCryptoKeyVersionRequest\x1a%.google.cloud.kms.v1.CryptoKeyVersion"`\x82\xd3\xe4\x93\x02Z"U/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:restore:\x01*\x1at\xca\x41\x17\x63loudkms.googleapis.com\xd2\x41Whttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloudkmsB\x8c\x01\n\x17\x63om.google.cloud.kms.v1B\x08KmsProtoP\x01Z6google.golang.org/genproto/googleapis/cloud/kms/v1;kms\xf8\x01\x01\xaa\x02\x13Google.Cloud.Kms.V1\xca\x02\x13Google\\Cloud\\Kms\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTKEYRINGSREQUEST = _descriptor.Descriptor(
+    name="ListKeyRingsRequest",
+    full_name="google.cloud.kms.v1.ListKeyRingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.ListKeyRingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.kms.v1.ListKeyRingsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.kms.v1.ListKeyRingsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.kms.v1.ListKeyRingsRequest.filter",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.kms.v1.ListKeyRingsRequest.order_by",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=196,
+    serialized_end=306,
+)
+
+
+_LISTCRYPTOKEYSREQUEST = _descriptor.Descriptor(
+    name="ListCryptoKeysRequest",
+    full_name="google.cloud.kms.v1.ListCryptoKeysRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.ListCryptoKeysRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.kms.v1.ListCryptoKeysRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.kms.v1.ListCryptoKeysRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version_view",
+            full_name="google.cloud.kms.v1.ListCryptoKeysRequest.version_view",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.kms.v1.ListCryptoKeysRequest.filter",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.kms.v1.ListCryptoKeysRequest.order_by",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=309,
+    serialized_end=503,
+)
+
+
+_LISTCRYPTOKEYVERSIONSREQUEST = _descriptor.Descriptor(
+    name="ListCryptoKeyVersionsRequest",
+    full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest.view",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest.filter",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsRequest.order_by",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=506,
+    serialized_end=699,
+)
+
+
+_LISTIMPORTJOBSREQUEST = _descriptor.Descriptor(
+    name="ListImportJobsRequest",
+    full_name="google.cloud.kms.v1.ListImportJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.ListImportJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.kms.v1.ListImportJobsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.kms.v1.ListImportJobsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.kms.v1.ListImportJobsRequest.filter",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.kms.v1.ListImportJobsRequest.order_by",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=701,
+    serialized_end=813,
+)
+
+
+_LISTKEYRINGSRESPONSE = _descriptor.Descriptor(
+    name="ListKeyRingsResponse",
+    full_name="google.cloud.kms.v1.ListKeyRingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key_rings",
+            full_name="google.cloud.kms.v1.ListKeyRingsResponse.key_rings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.kms.v1.ListKeyRingsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.kms.v1.ListKeyRingsResponse.total_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=815,
+    serialized_end=931,
+)
+
+
+_LISTCRYPTOKEYSRESPONSE = _descriptor.Descriptor(
+    name="ListCryptoKeysResponse",
+    full_name="google.cloud.kms.v1.ListCryptoKeysResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_keys",
+            full_name="google.cloud.kms.v1.ListCryptoKeysResponse.crypto_keys",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.kms.v1.ListCryptoKeysResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.kms.v1.ListCryptoKeysResponse.total_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=933,
+    serialized_end=1055,
+)
+
+
+_LISTCRYPTOKEYVERSIONSRESPONSE = _descriptor.Descriptor(
+    name="ListCryptoKeyVersionsResponse",
+    full_name="google.cloud.kms.v1.ListCryptoKeyVersionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_key_versions",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsResponse.crypto_key_versions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.kms.v1.ListCryptoKeyVersionsResponse.total_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1058,
+    serialized_end=1202,
+)
+
+
+_LISTIMPORTJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListImportJobsResponse",
+    full_name="google.cloud.kms.v1.ListImportJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="import_jobs",
+            full_name="google.cloud.kms.v1.ListImportJobsResponse.import_jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.kms.v1.ListImportJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.kms.v1.ListImportJobsResponse.total_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1204,
+    serialized_end=1326,
+)
+
+
+_GETKEYRINGREQUEST = _descriptor.Descriptor(
+    name="GetKeyRingRequest",
+    full_name="google.cloud.kms.v1.GetKeyRingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.GetKeyRingRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1328,
+    serialized_end=1361,
+)
+
+
+_GETCRYPTOKEYREQUEST = _descriptor.Descriptor(
+    name="GetCryptoKeyRequest",
+    full_name="google.cloud.kms.v1.GetCryptoKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.GetCryptoKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1363,
+    serialized_end=1398,
+)
+
+
+_GETCRYPTOKEYVERSIONREQUEST = _descriptor.Descriptor(
+    name="GetCryptoKeyVersionRequest",
+    full_name="google.cloud.kms.v1.GetCryptoKeyVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.GetCryptoKeyVersionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1400,
+    serialized_end=1442,
+)
+
+
+_GETPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="GetPublicKeyRequest",
+    full_name="google.cloud.kms.v1.GetPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.GetPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1444,
+    serialized_end=1479,
+)
+
+
+_GETIMPORTJOBREQUEST = _descriptor.Descriptor(
+    name="GetImportJobRequest",
+    full_name="google.cloud.kms.v1.GetImportJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.GetImportJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1481,
+    serialized_end=1516,
+)
+
+
+_CREATEKEYRINGREQUEST = _descriptor.Descriptor(
+    name="CreateKeyRingRequest",
+    full_name="google.cloud.kms.v1.CreateKeyRingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.CreateKeyRingRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_ring_id",
+            full_name="google.cloud.kms.v1.CreateKeyRingRequest.key_ring_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_ring",
+            full_name="google.cloud.kms.v1.CreateKeyRingRequest.key_ring",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1518,
+    serialized_end=1625,
+)
+
+
+_CREATECRYPTOKEYREQUEST = _descriptor.Descriptor(
+    name="CreateCryptoKeyRequest",
+    full_name="google.cloud.kms.v1.CreateCryptoKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.CreateCryptoKeyRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_key_id",
+            full_name="google.cloud.kms.v1.CreateCryptoKeyRequest.crypto_key_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_key",
+            full_name="google.cloud.kms.v1.CreateCryptoKeyRequest.crypto_key",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skip_initial_version_creation",
+            full_name="google.cloud.kms.v1.CreateCryptoKeyRequest.skip_initial_version_creation",
+            index=3,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1628,
+    serialized_end=1782,
+)
+
+
+_CREATECRYPTOKEYVERSIONREQUEST = _descriptor.Descriptor(
+    name="CreateCryptoKeyVersionRequest",
+    full_name="google.cloud.kms.v1.CreateCryptoKeyVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.CreateCryptoKeyVersionRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_key_version",
+            full_name="google.cloud.kms.v1.CreateCryptoKeyVersionRequest.crypto_key_version",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1784,
+    serialized_end=1898,
+)
+
+
+_IMPORTCRYPTOKEYVERSIONREQUEST = _descriptor.Descriptor(
+    name="ImportCryptoKeyVersionRequest",
+    full_name="google.cloud.kms.v1.ImportCryptoKeyVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.ImportCryptoKeyVersionRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="algorithm",
+            full_name="google.cloud.kms.v1.ImportCryptoKeyVersionRequest.algorithm",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_job",
+            full_name="google.cloud.kms.v1.ImportCryptoKeyVersionRequest.import_job",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rsa_aes_wrapped_key",
+            full_name="google.cloud.kms.v1.ImportCryptoKeyVersionRequest.rsa_aes_wrapped_key",
+            index=3,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="wrapped_key_material",
+            full_name="google.cloud.kms.v1.ImportCryptoKeyVersionRequest.wrapped_key_material",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1901,
+    serialized_end=2107,
+)
+
+
+_CREATEIMPORTJOBREQUEST = _descriptor.Descriptor(
+    name="CreateImportJobRequest",
+    full_name="google.cloud.kms.v1.CreateImportJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.kms.v1.CreateImportJobRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_job_id",
+            full_name="google.cloud.kms.v1.CreateImportJobRequest.import_job_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="import_job",
+            full_name="google.cloud.kms.v1.CreateImportJobRequest.import_job",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2109,
+    serialized_end=2224,
+)
+
+
+_UPDATECRYPTOKEYREQUEST = _descriptor.Descriptor(
+    name="UpdateCryptoKeyRequest",
+    full_name="google.cloud.kms.v1.UpdateCryptoKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_key",
+            full_name="google.cloud.kms.v1.UpdateCryptoKeyRequest.crypto_key",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.kms.v1.UpdateCryptoKeyRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2226,
+    serialized_end=2351,
+)
+
+
+_UPDATECRYPTOKEYVERSIONREQUEST = _descriptor.Descriptor(
+    name="UpdateCryptoKeyVersionRequest",
+    full_name="google.cloud.kms.v1.UpdateCryptoKeyVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crypto_key_version",
+            full_name="google.cloud.kms.v1.UpdateCryptoKeyVersionRequest.crypto_key_version",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.kms.v1.UpdateCryptoKeyVersionRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2354,
+    serialized_end=2501,
+)
+
+
+_ENCRYPTREQUEST = _descriptor.Descriptor(
+    name="EncryptRequest",
+    full_name="google.cloud.kms.v1.EncryptRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.EncryptRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="plaintext",
+            full_name="google.cloud.kms.v1.EncryptRequest.plaintext",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="additional_authenticated_data",
+            full_name="google.cloud.kms.v1.EncryptRequest.additional_authenticated_data",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2503,
+    serialized_end=2591,
+)
+
+
+_DECRYPTREQUEST = _descriptor.Descriptor(
+    name="DecryptRequest",
+    full_name="google.cloud.kms.v1.DecryptRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.DecryptRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ciphertext",
+            full_name="google.cloud.kms.v1.DecryptRequest.ciphertext",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="additional_authenticated_data",
+            full_name="google.cloud.kms.v1.DecryptRequest.additional_authenticated_data",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2593,
+    serialized_end=2682,
+)
+
+
+_ASYMMETRICSIGNREQUEST = _descriptor.Descriptor(
+    name="AsymmetricSignRequest",
+    full_name="google.cloud.kms.v1.AsymmetricSignRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.AsymmetricSignRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="digest",
+            full_name="google.cloud.kms.v1.AsymmetricSignRequest.digest",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2684,
+    serialized_end=2766,
+)
+
+
+_ASYMMETRICDECRYPTREQUEST = _descriptor.Descriptor(
+    name="AsymmetricDecryptRequest",
+    full_name="google.cloud.kms.v1.AsymmetricDecryptRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.AsymmetricDecryptRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ciphertext",
+            full_name="google.cloud.kms.v1.AsymmetricDecryptRequest.ciphertext",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2768,
+    serialized_end=2828,
+)
+
+
+_DECRYPTRESPONSE = _descriptor.Descriptor(
+    name="DecryptResponse",
+    full_name="google.cloud.kms.v1.DecryptResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="plaintext",
+            full_name="google.cloud.kms.v1.DecryptResponse.plaintext",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2830,
+    serialized_end=2866,
+)
+
+
+_ENCRYPTRESPONSE = _descriptor.Descriptor(
+    name="EncryptResponse",
+    full_name="google.cloud.kms.v1.EncryptResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.EncryptResponse.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ciphertext",
+            full_name="google.cloud.kms.v1.EncryptResponse.ciphertext",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2868,
+    serialized_end=2919,
+)
+
+
+_ASYMMETRICSIGNRESPONSE = _descriptor.Descriptor(
+    name="AsymmetricSignResponse",
+    full_name="google.cloud.kms.v1.AsymmetricSignResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="signature",
+            full_name="google.cloud.kms.v1.AsymmetricSignResponse.signature",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2921,
+    serialized_end=2964,
+)
+
+
+_ASYMMETRICDECRYPTRESPONSE = _descriptor.Descriptor(
+    name="AsymmetricDecryptResponse",
+    full_name="google.cloud.kms.v1.AsymmetricDecryptResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="plaintext",
+            full_name="google.cloud.kms.v1.AsymmetricDecryptResponse.plaintext",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2966,
+    serialized_end=3012,
+)
+
+
+_UPDATECRYPTOKEYPRIMARYVERSIONREQUEST = _descriptor.Descriptor(
+    name="UpdateCryptoKeyPrimaryVersionRequest",
+    full_name="google.cloud.kms.v1.UpdateCryptoKeyPrimaryVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.UpdateCryptoKeyPrimaryVersionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crypto_key_version_id",
+            full_name="google.cloud.kms.v1.UpdateCryptoKeyPrimaryVersionRequest.crypto_key_version_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3014,
+    serialized_end=3097,
+)
+
+
+_DESTROYCRYPTOKEYVERSIONREQUEST = _descriptor.Descriptor(
+    name="DestroyCryptoKeyVersionRequest",
+    full_name="google.cloud.kms.v1.DestroyCryptoKeyVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.DestroyCryptoKeyVersionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3099,
+    serialized_end=3145,
+)
+
+
+_RESTORECRYPTOKEYVERSIONREQUEST = _descriptor.Descriptor(
+    name="RestoreCryptoKeyVersionRequest",
+    full_name="google.cloud.kms.v1.RestoreCryptoKeyVersionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.kms.v1.RestoreCryptoKeyVersionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3147,
+    serialized_end=3193,
+)
+
+
+_DIGEST = _descriptor.Descriptor(
+    name="Digest",
+    full_name="google.cloud.kms.v1.Digest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sha256",
+            full_name="google.cloud.kms.v1.Digest.sha256",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sha384",
+            full_name="google.cloud.kms.v1.Digest.sha384",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sha512",
+            full_name="google.cloud.kms.v1.Digest.sha512",
+            index=2,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="digest",
+            full_name="google.cloud.kms.v1.Digest.digest",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3195,
+    serialized_end=3267,
+)
+
+
+_LOCATIONMETADATA = _descriptor.Descriptor(
+    name="LocationMetadata",
+    full_name="google.cloud.kms.v1.LocationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hsm_available",
+            full_name="google.cloud.kms.v1.LocationMetadata.hsm_available",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3269,
+    serialized_end=3310,
+)
+
+_LISTCRYPTOKEYSREQUEST.fields_by_name[
+    "version_view"
+].enum_type = (
+    google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION_CRYPTOKEYVERSIONVIEW
+)
+_LISTCRYPTOKEYVERSIONSREQUEST.fields_by_name[
+    "view"
+].enum_type = (
+    google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION_CRYPTOKEYVERSIONVIEW
+)
+_LISTKEYRINGSRESPONSE.fields_by_name[
+    "key_rings"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._KEYRING
+_LISTCRYPTOKEYSRESPONSE.fields_by_name[
+    "crypto_keys"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY
+_LISTCRYPTOKEYVERSIONSRESPONSE.fields_by_name[
+    "crypto_key_versions"
+].message_type = (
+    google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION
+)
+_LISTIMPORTJOBSRESPONSE.fields_by_name[
+    "import_jobs"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._IMPORTJOB
+_CREATEKEYRINGREQUEST.fields_by_name[
+    "key_ring"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._KEYRING
+_CREATECRYPTOKEYREQUEST.fields_by_name[
+    "crypto_key"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY
+_CREATECRYPTOKEYVERSIONREQUEST.fields_by_name[
+    "crypto_key_version"
+].message_type = (
+    google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION
+)
+_IMPORTCRYPTOKEYVERSIONREQUEST.fields_by_name[
+    "algorithm"
+].enum_type = (
+    google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION_CRYPTOKEYVERSIONALGORITHM
+)
+_IMPORTCRYPTOKEYVERSIONREQUEST.oneofs_by_name["wrapped_key_material"].fields.append(
+    _IMPORTCRYPTOKEYVERSIONREQUEST.fields_by_name["rsa_aes_wrapped_key"]
+)
+_IMPORTCRYPTOKEYVERSIONREQUEST.fields_by_name[
+    "rsa_aes_wrapped_key"
+].containing_oneof = _IMPORTCRYPTOKEYVERSIONREQUEST.oneofs_by_name[
+    "wrapped_key_material"
+]
+_CREATEIMPORTJOBREQUEST.fields_by_name[
+    "import_job"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._IMPORTJOB
+_UPDATECRYPTOKEYREQUEST.fields_by_name[
+    "crypto_key"
+].message_type = google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY
+_UPDATECRYPTOKEYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATECRYPTOKEYVERSIONREQUEST.fields_by_name[
+    "crypto_key_version"
+].message_type = (
+    google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION
+)
+_UPDATECRYPTOKEYVERSIONREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_ASYMMETRICSIGNREQUEST.fields_by_name["digest"].message_type = _DIGEST
+_DIGEST.oneofs_by_name["digest"].fields.append(_DIGEST.fields_by_name["sha256"])
+_DIGEST.fields_by_name["sha256"].containing_oneof = _DIGEST.oneofs_by_name["digest"]
+_DIGEST.oneofs_by_name["digest"].fields.append(_DIGEST.fields_by_name["sha384"])
+_DIGEST.fields_by_name["sha384"].containing_oneof = _DIGEST.oneofs_by_name["digest"]
+_DIGEST.oneofs_by_name["digest"].fields.append(_DIGEST.fields_by_name["sha512"])
+_DIGEST.fields_by_name["sha512"].containing_oneof = _DIGEST.oneofs_by_name["digest"]
+DESCRIPTOR.message_types_by_name["ListKeyRingsRequest"] = _LISTKEYRINGSREQUEST
+DESCRIPTOR.message_types_by_name["ListCryptoKeysRequest"] = _LISTCRYPTOKEYSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListCryptoKeyVersionsRequest"
+] = _LISTCRYPTOKEYVERSIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListImportJobsRequest"] = _LISTIMPORTJOBSREQUEST
+DESCRIPTOR.message_types_by_name["ListKeyRingsResponse"] = _LISTKEYRINGSRESPONSE
+DESCRIPTOR.message_types_by_name["ListCryptoKeysResponse"] = _LISTCRYPTOKEYSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ListCryptoKeyVersionsResponse"
+] = _LISTCRYPTOKEYVERSIONSRESPONSE
+DESCRIPTOR.message_types_by_name["ListImportJobsResponse"] = _LISTIMPORTJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["GetKeyRingRequest"] = _GETKEYRINGREQUEST
+DESCRIPTOR.message_types_by_name["GetCryptoKeyRequest"] = _GETCRYPTOKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetCryptoKeyVersionRequest"
+] = _GETCRYPTOKEYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name["GetPublicKeyRequest"] = _GETPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name["GetImportJobRequest"] = _GETIMPORTJOBREQUEST
+DESCRIPTOR.message_types_by_name["CreateKeyRingRequest"] = _CREATEKEYRINGREQUEST
+DESCRIPTOR.message_types_by_name["CreateCryptoKeyRequest"] = _CREATECRYPTOKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateCryptoKeyVersionRequest"
+] = _CREATECRYPTOKEYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportCryptoKeyVersionRequest"
+] = _IMPORTCRYPTOKEYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name["CreateImportJobRequest"] = _CREATEIMPORTJOBREQUEST
+DESCRIPTOR.message_types_by_name["UpdateCryptoKeyRequest"] = _UPDATECRYPTOKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateCryptoKeyVersionRequest"
+] = _UPDATECRYPTOKEYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name["EncryptRequest"] = _ENCRYPTREQUEST
+DESCRIPTOR.message_types_by_name["DecryptRequest"] = _DECRYPTREQUEST
+DESCRIPTOR.message_types_by_name["AsymmetricSignRequest"] = _ASYMMETRICSIGNREQUEST
+DESCRIPTOR.message_types_by_name["AsymmetricDecryptRequest"] = _ASYMMETRICDECRYPTREQUEST
+DESCRIPTOR.message_types_by_name["DecryptResponse"] = _DECRYPTRESPONSE
+DESCRIPTOR.message_types_by_name["EncryptResponse"] = _ENCRYPTRESPONSE
+DESCRIPTOR.message_types_by_name["AsymmetricSignResponse"] = _ASYMMETRICSIGNRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsymmetricDecryptResponse"
+] = _ASYMMETRICDECRYPTRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "UpdateCryptoKeyPrimaryVersionRequest"
+] = _UPDATECRYPTOKEYPRIMARYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DestroyCryptoKeyVersionRequest"
+] = _DESTROYCRYPTOKEYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RestoreCryptoKeyVersionRequest"
+] = _RESTORECRYPTOKEYVERSIONREQUEST
+DESCRIPTOR.message_types_by_name["Digest"] = _DIGEST
+DESCRIPTOR.message_types_by_name["LocationMetadata"] = _LOCATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListKeyRingsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListKeyRingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTKEYRINGSREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.ListKeyRings][google.cloud.kms.v1.KeyManagementService.ListKeyRings].
+  
+  
+  Attributes:
+      parent:
+          Required. The resource name of the location associated with
+          the [KeyRings][google.cloud.kms.v1.KeyRing], in the format
+          ``projects/*/locations/*``.
+      page_size:
+          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 [ListKeyRingsRespons
+          e.next\_page\_token][google.cloud.kms.v1.ListKeyRingsResponse.
+          next\_page\_token] in a subsequent request. If unspecified,
+          the server will pick an appropriate default.
+      page_token:
+          Optional pagination token, returned earlier via [ListKeyRingsR
+          esponse.next\_page\_token][google.cloud.kms.v1.ListKeyRingsRes
+          ponse.next\_page\_token].
+      filter:
+          Optional. Only include resources that match the filter in the
+          response.
+      order_by:
+          Optional. Specify how the results should be sorted. If not
+          specified, the results will be sorted in the default order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListKeyRingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListKeyRingsRequest)
+
+ListCryptoKeysRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCryptoKeysRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRYPTOKEYSREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.ListCryptoKeys][google.cloud.kms.v1.KeyManagementService.ListCryptoKeys].
+  
+  
+  Attributes:
+      parent:
+          Required. The resource name of the
+          [KeyRing][google.cloud.kms.v1.KeyRing] to list, in the format
+          ``projects/*/locations/*/keyRings/*``.
+      page_size:
+          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 [ListCryptoKeysR
+          esponse.next\_page\_token][google.cloud.kms.v1.ListCryptoKeysR
+          esponse.next\_page\_token] in a subsequent request. If
+          unspecified, the server will pick an appropriate default.
+      page_token:
+          Optional pagination token, returned earlier via [ListCryptoKey
+          sResponse.next\_page\_token][google.cloud.kms.v1.ListCryptoKey
+          sResponse.next\_page\_token].
+      version_view:
+          The fields of the primary version to include in the response.
+      filter:
+          Optional. Only include resources that match the filter in the
+          response.
+      order_by:
+          Optional. Specify how the results should be sorted. If not
+          specified, the results will be sorted in the default order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListCryptoKeysRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCryptoKeysRequest)
+
+ListCryptoKeyVersionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCryptoKeyVersionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRYPTOKEYVERSIONSREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.ListCryptoKeyVersions][google.cloud.kms.v1.KeyManagementService.ListCryptoKeyVersions].
+  
+  
+  Attributes:
+      parent:
+          Required. The resource name of the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] to list, in the
+          format ``projects/*/locations/*/keyRings/*/cryptoKeys/*``.
+      page_size:
+          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 [ListCryptoKeyVersio
+          nsResponse.next\_page\_token][google.cloud.kms.v1.ListCryptoKe
+          yVersionsResponse.next\_page\_token] in a subsequent request.
+          If unspecified, the server will pick an appropriate default.
+      page_token:
+          Optional pagination token, returned earlier via [ListCryptoKey
+          VersionsResponse.next\_page\_token][google.cloud.kms.v1.ListCr
+          yptoKeyVersionsResponse.next\_page\_token].
+      view:
+          The fields to include in the response.
+      filter:
+          Optional. Only include resources that match the filter in the
+          response.
+      order_by:
+          Optional. Specify how the results should be sorted. If not
+          specified, the results will be sorted in the default order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListCryptoKeyVersionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCryptoKeyVersionsRequest)
+
+ListImportJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListImportJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTIMPORTJOBSREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.ListImportJobs][google.cloud.kms.v1.KeyManagementService.ListImportJobs].
+  
+  
+  Attributes:
+      parent:
+          Required. The resource name of the
+          [KeyRing][google.cloud.kms.v1.KeyRing] to list, in the format
+          ``projects/*/locations/*/keyRings/*``.
+      page_size:
+          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 [ListImportJobsR
+          esponse.next\_page\_token][google.cloud.kms.v1.ListImportJobsR
+          esponse.next\_page\_token] in a subsequent request. If
+          unspecified, the server will pick an appropriate default.
+      page_token:
+          Optional pagination token, returned earlier via [ListImportJob
+          sResponse.next\_page\_token][google.cloud.kms.v1.ListImportJob
+          sResponse.next\_page\_token].
+      filter:
+          Optional. Only include resources that match the filter in the
+          response.
+      order_by:
+          Optional. Specify how the results should be sorted. If not
+          specified, the results will be sorted in the default order.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListImportJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListImportJobsRequest)
+
+ListKeyRingsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListKeyRingsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTKEYRINGSRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.ListKeyRings][google.cloud.kms.v1.KeyManagementService.ListKeyRings].
+  
+  
+  Attributes:
+      key_rings:
+          The list of [KeyRings][google.cloud.kms.v1.KeyRing].
+      next_page_token:
+          A token to retrieve next page of results. Pass this value in [
+          ListKeyRingsRequest.page\_token][google.cloud.kms.v1.ListKeyRi
+          ngsRequest.page\_token] to retrieve the next page of results.
+      total_size:
+          The total number of [KeyRings][google.cloud.kms.v1.KeyRing]
+          that matched the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListKeyRingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListKeyRingsResponse)
+
+ListCryptoKeysResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCryptoKeysResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRYPTOKEYSRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.ListCryptoKeys][google.cloud.kms.v1.KeyManagementService.ListCryptoKeys].
+  
+  
+  Attributes:
+      crypto_keys:
+          The list of [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+      next_page_token:
+          A token to retrieve next page of results. Pass this value in [
+          ListCryptoKeysRequest.page\_token][google.cloud.kms.v1.ListCry
+          ptoKeysRequest.page\_token] to retrieve the next page of
+          results.
+      total_size:
+          The total number of
+          [CryptoKeys][google.cloud.kms.v1.CryptoKey] that matched the
+          query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListCryptoKeysResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCryptoKeysResponse)
+
+ListCryptoKeyVersionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCryptoKeyVersionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRYPTOKEYVERSIONSRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.ListCryptoKeyVersions][google.cloud.kms.v1.KeyManagementService.ListCryptoKeyVersions].
+  
+  
+  Attributes:
+      crypto_key_versions:
+          The list of
+          [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
+      next_page_token:
+          A token to retrieve next page of results. Pass this value in [
+          ListCryptoKeyVersionsRequest.page\_token][google.cloud.kms.v1.
+          ListCryptoKeyVersionsRequest.page\_token] to retrieve the next
+          page of results.
+      total_size:
+          The total number of
+          [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] that
+          matched the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListCryptoKeyVersionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCryptoKeyVersionsResponse)
+
+ListImportJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListImportJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTIMPORTJOBSRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.ListImportJobs][google.cloud.kms.v1.KeyManagementService.ListImportJobs].
+  
+  
+  Attributes:
+      import_jobs:
+          The list of [ImportJobs][google.cloud.kms.v1.ImportJob].
+      next_page_token:
+          A token to retrieve next page of results. Pass this value in [
+          ListImportJobsRequest.page\_token][google.cloud.kms.v1.ListImp
+          ortJobsRequest.page\_token] to retrieve the next page of
+          results.
+      total_size:
+          The total number of
+          [ImportJobs][google.cloud.kms.v1.ImportJob] that matched the
+          query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ListImportJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListImportJobsResponse)
+
+GetKeyRingRequest = _reflection.GeneratedProtocolMessageType(
+    "GetKeyRingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETKEYRINGREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.GetKeyRing][google.cloud.kms.v1.KeyManagementService.GetKeyRing].
+  
+  
+  Attributes:
+      name:
+          The [name][google.cloud.kms.v1.KeyRing.name] of the
+          [KeyRing][google.cloud.kms.v1.KeyRing] to get.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.GetKeyRingRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetKeyRingRequest)
+
+GetCryptoKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetCryptoKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCRYPTOKEYREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.GetCryptoKey][google.cloud.kms.v1.KeyManagementService.GetCryptoKey].
+  
+  
+  Attributes:
+      name:
+          The [name][google.cloud.kms.v1.CryptoKey.name] of the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] to get.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.GetCryptoKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetCryptoKeyRequest)
+
+GetCryptoKeyVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "GetCryptoKeyVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCRYPTOKEYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.GetCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.GetCryptoKeyVersion].
+  
+  
+  Attributes:
+      name:
+          The [name][google.cloud.kms.v1.CryptoKeyVersion.name] of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          get.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.GetCryptoKeyVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetCryptoKeyVersionRequest)
+
+GetPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPUBLICKEYREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+  
+  
+  Attributes:
+      name:
+          The [name][google.cloud.kms.v1.CryptoKeyVersion.name] of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+          public key to get.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.GetPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetPublicKeyRequest)
+
+GetImportJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetImportJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETIMPORTJOBREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.GetImportJob][google.cloud.kms.v1.KeyManagementService.GetImportJob].
+  
+  
+  Attributes:
+      name:
+          The [name][google.cloud.kms.v1.ImportJob.name] of the
+          [ImportJob][google.cloud.kms.v1.ImportJob] to get.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.GetImportJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetImportJobRequest)
+
+CreateKeyRingRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateKeyRingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEKEYRINGREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.CreateKeyRing][google.cloud.kms.v1.KeyManagementService.CreateKeyRing].
+  
+  
+  Attributes:
+      parent:
+          Required. The resource name of the location associated with
+          the [KeyRings][google.cloud.kms.v1.KeyRing], in the format
+          ``projects/*/locations/*``.
+      key_ring_id:
+          Required. It must be unique within a location and match the
+          regular expression ``[a-zA-Z0-9_-]{1,63}``
+      key_ring:
+          A [KeyRing][google.cloud.kms.v1.KeyRing] with initial field
+          values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CreateKeyRingRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateKeyRingRequest)
+
+CreateCryptoKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateCryptoKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECRYPTOKEYREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.CreateCryptoKey][google.cloud.kms.v1.KeyManagementService.CreateCryptoKey].
+  
+  
+  Attributes:
+      parent:
+          Required. The [name][google.cloud.kms.v1.KeyRing.name] of the
+          KeyRing associated with the
+          [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+      crypto_key_id:
+          Required. It must be unique within a KeyRing and match the
+          regular expression ``[a-zA-Z0-9_-]{1,63}``
+      crypto_key:
+          A [CryptoKey][google.cloud.kms.v1.CryptoKey] with initial
+          field values.
+      skip_initial_version_creation:
+          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 [CreateCryptoKeyVersion][google.cloud.kms.v
+          1.KeyManagementService.CreateCryptoKeyVersion] or [ImportCrypt
+          oKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCr
+          yptoKeyVersion] before you can use this
+          [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CreateCryptoKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateCryptoKeyRequest)
+
+CreateCryptoKeyVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateCryptoKeyVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECRYPTOKEYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.CreateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion].
+  
+  
+  Attributes:
+      parent:
+          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].
+      crypto_key_version:
+          A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+          with initial field values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CreateCryptoKeyVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateCryptoKeyVersionRequest)
+
+ImportCryptoKeyVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportCryptoKeyVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTCRYPTOKEYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.ImportCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion].
+  
+  
+  Attributes:
+      parent:
+          Required. The [name][google.cloud.kms.v1.CryptoKey.name] of
+          the [CryptoKey][google.cloud.kms.v1.CryptoKey] to be imported
+          into.
+      algorithm:
+          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.km
+          s.v1.CryptoKey.version\_template] of the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] this version
+          imports into.
+      import_job:
+          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.
+      wrapped_key_material:
+          Required. The incoming wrapped key material that is to be
+          imported.
+      rsa_aes_wrapped_key:
+          Wrapped key material produced with [RSA\_OAEP\_3072\_SHA1\_AES
+          \_256][google.cloud.kms.v1.ImportJob.ImportMethod.RSA\_OAEP\_3
+          072\_SHA1\_AES\_256] or [RSA\_OAEP\_4096\_SHA1\_AES\_256][goog
+          le.cloud.kms.v1.ImportJob.ImportMethod.RSA\_OAEP\_4096\_SHA1\_
+          AES\_256].  This field contains the concatenation of two
+          wrapped keys:  .. raw:: html     <ol>  .. raw:: html     <li>
+          An ephemeral AES-256 wrapping key wrapped with the
+          [public\_key][google.cloud.kms.v1.ImportJob.public\_key] using
+          RSAES-OAEP with SHA-1, MGF1 with SHA-1, and an empty label.
+          .. raw:: html     </li>  .. raw:: html     <li>  The key to be
+          imported, wrapped with the ephemeral AES-256 key using AES-KWP
+          (RFC 5649).  .. raw:: html     </li>  .. raw:: html     </ol>
+          This format is the same as the format produced by PKCS#11
+          mechanism CKM\_RSA\_AES\_KEY\_WRAP.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.ImportCryptoKeyVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportCryptoKeyVersionRequest)
+
+CreateImportJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateImportJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEIMPORTJOBREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.CreateImportJob][google.cloud.kms.v1.KeyManagementService.CreateImportJob].
+  
+  
+  Attributes:
+      parent:
+          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].
+      import_job_id:
+          Required. It must be unique within a KeyRing and match the
+          regular expression ``[a-zA-Z0-9_-]{1,63}``
+      import_job:
+          Required. An [ImportJob][google.cloud.kms.v1.ImportJob] with
+          initial field values.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.CreateImportJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateImportJobRequest)
+
+UpdateCryptoKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateCryptoKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECRYPTOKEYREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.UpdateCryptoKey][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKey].
+  
+  
+  Attributes:
+      crypto_key:
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] with updated
+          values.
+      update_mask:
+          Required list of fields to be updated in this request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.UpdateCryptoKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateCryptoKeyRequest)
+
+UpdateCryptoKeyVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateCryptoKeyVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECRYPTOKEYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.UpdateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyVersion].
+  
+  
+  Attributes:
+      crypto_key_version:
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with
+          updated values.
+      update_mask:
+          Required list of fields to be updated in this request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.UpdateCryptoKeyVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateCryptoKeyVersionRequest)
+
+EncryptRequest = _reflection.GeneratedProtocolMessageType(
+    "EncryptRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENCRYPTREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] or
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          use for encryption.  If a
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] is specified, the
+          server will use its [primary
+          version][google.cloud.kms.v1.CryptoKey.primary].
+      plaintext:
+          Required. The data to encrypt. Must be no larger than 64KiB.
+          The maximum size depends on the key version's [protection\_lev
+          el][google.cloud.kms.v1.CryptoKeyVersionTemplate.protection\_l
+          evel]. For
+          [SOFTWARE][google.cloud.kms.v1.ProtectionLevel.SOFTWARE] keys,
+          the plaintext must be no larger 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.
+      additional_authenticated_data:
+          Optional data that, if specified, must also be provided during
+          decryption through [DecryptRequest.additional\_authenticated\_
+          data][google.cloud.kms.v1.DecryptRequest.additional\_authentic
+          ated\_data].  The maximum size depends on the key version's [p
+          rotection\_level][google.cloud.kms.v1.CryptoKeyVersionTemplate
+          .protection\_level]. For
+          [SOFTWARE][google.cloud.kms.v1.ProtectionLevel.SOFTWARE] keys,
+          the AAD must be no larger 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.EncryptRequest)
+    ),
+)
+_sym_db.RegisterMessage(EncryptRequest)
+
+DecryptRequest = _reflection.GeneratedProtocolMessageType(
+    "DecryptRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DECRYPTREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] to use for
+          decryption. The server will choose the appropriate version.
+      ciphertext:
+          Required. The encrypted data originally returned in [EncryptRe
+          sponse.ciphertext][google.cloud.kms.v1.EncryptResponse.ciphert
+          ext].
+      additional_authenticated_data:
+          Optional data that must match the data originally supplied in 
+          [EncryptRequest.additional\_authenticated\_data][google.cloud.
+          kms.v1.EncryptRequest.additional\_authenticated\_data].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.DecryptRequest)
+    ),
+)
+_sym_db.RegisterMessage(DecryptRequest)
+
+AsymmetricSignRequest = _reflection.GeneratedProtocolMessageType(
+    "AsymmetricSignRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYMMETRICSIGNREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.AsymmetricSign][google.cloud.kms.v1.KeyManagementService.AsymmetricSign].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          use for signing.
+      digest:
+          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].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.AsymmetricSignRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsymmetricSignRequest)
+
+AsymmetricDecryptRequest = _reflection.GeneratedProtocolMessageType(
+    "AsymmetricDecryptRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYMMETRICDECRYPTREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.AsymmetricDecrypt][google.cloud.kms.v1.KeyManagementService.AsymmetricDecrypt].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          use for decryption.
+      ciphertext:
+          Required. The data encrypted with the named
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s
+          public key using OAEP.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.AsymmetricDecryptRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsymmetricDecryptRequest)
+
+DecryptResponse = _reflection.GeneratedProtocolMessageType(
+    "DecryptResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DECRYPTRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
+  
+  
+  Attributes:
+      plaintext:
+          The decrypted data originally supplied in [EncryptRequest.plai
+          ntext][google.cloud.kms.v1.EncryptRequest.plaintext].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.DecryptResponse)
+    ),
+)
+_sym_db.RegisterMessage(DecryptResponse)
+
+EncryptResponse = _reflection.GeneratedProtocolMessageType(
+    "EncryptResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENCRYPTRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
+  
+  
+  Attributes:
+      name:
+          The resource name of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] used
+          in encryption.
+      ciphertext:
+          The encrypted data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.EncryptResponse)
+    ),
+)
+_sym_db.RegisterMessage(EncryptResponse)
+
+AsymmetricSignResponse = _reflection.GeneratedProtocolMessageType(
+    "AsymmetricSignResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYMMETRICSIGNRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.AsymmetricSign][google.cloud.kms.v1.KeyManagementService.AsymmetricSign].
+  
+  
+  Attributes:
+      signature:
+          The created signature.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.AsymmetricSignResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsymmetricSignResponse)
+
+AsymmetricDecryptResponse = _reflection.GeneratedProtocolMessageType(
+    "AsymmetricDecryptResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYMMETRICDECRYPTRESPONSE,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Response message for
+  [KeyManagementService.AsymmetricDecrypt][google.cloud.kms.v1.KeyManagementService.AsymmetricDecrypt].
+  
+  
+  Attributes:
+      plaintext:
+          The decrypted data originally encrypted with the matching
+          public key.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.AsymmetricDecryptResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsymmetricDecryptResponse)
+
+UpdateCryptoKeyPrimaryVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateCryptoKeyPrimaryVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECRYPTOKEYPRIMARYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.UpdateCryptoKeyPrimaryVersion][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryVersion].
+  
+  
+  Attributes:
+      name:
+          The resource name of the
+          [CryptoKey][google.cloud.kms.v1.CryptoKey] to update.
+      crypto_key_version_id:
+          The id of the child
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          use as primary.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.UpdateCryptoKeyPrimaryVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateCryptoKeyPrimaryVersionRequest)
+
+DestroyCryptoKeyVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "DestroyCryptoKeyVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DESTROYCRYPTOKEYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion].
+  
+  
+  Attributes:
+      name:
+          The resource name of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          destroy.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.DestroyCryptoKeyVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DestroyCryptoKeyVersionRequest)
+
+RestoreCryptoKeyVersionRequest = _reflection.GeneratedProtocolMessageType(
+    "RestoreCryptoKeyVersionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESTORECRYPTOKEYVERSIONREQUEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Request message for
+  [KeyManagementService.RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion].
+  
+  
+  Attributes:
+      name:
+          The resource name of the
+          [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to
+          restore.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.RestoreCryptoKeyVersionRequest)
+    ),
+)
+_sym_db.RegisterMessage(RestoreCryptoKeyVersionRequest)
+
+Digest = _reflection.GeneratedProtocolMessageType(
+    "Digest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DIGEST,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""A [Digest][google.cloud.kms.v1.Digest] holds a cryptographic message
+  digest.
+  
+  
+  Attributes:
+      digest:
+          Required. The message digest.
+      sha256:
+          A message digest produced with the SHA-256 algorithm.
+      sha384:
+          A message digest produced with the SHA-384 algorithm.
+      sha512:
+          A message digest produced with the SHA-512 algorithm.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.Digest)
+    ),
+)
+_sym_db.RegisterMessage(Digest)
+
+LocationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LocationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONMETADATA,
+        __module__="google.cloud.kms_v1.proto.service_pb2",
+        __doc__="""Cloud KMS metadata for the given
+  [google.cloud.location.Location][google.cloud.location.Location].
+  
+  
+  Attributes:
+      hsm_available:
+          Indicates whether [CryptoKeys][google.cloud.kms.v1.CryptoKey]
+          with [protection\_level][google.cloud.kms.v1.CryptoKeyVersionT
+          emplate.protection\_level]
+          [HSM][google.cloud.kms.v1.ProtectionLevel.HSM] can be created
+          in this location.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.kms.v1.LocationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LocationMetadata)
+
+
+DESCRIPTOR._options = None
+
+_KEYMANAGEMENTSERVICE = _descriptor.ServiceDescriptor(
+    name="KeyManagementService",
+    full_name="google.cloud.kms.v1.KeyManagementService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\027cloudkms.googleapis.com\322AWhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloudkms"
+    ),
+    serialized_start=3313,
+    serialized_end=7816,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListKeyRings",
+            full_name="google.cloud.kms.v1.KeyManagementService.ListKeyRings",
+            index=0,
+            containing_service=None,
+            input_type=_LISTKEYRINGSREQUEST,
+            output_type=_LISTKEYRINGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v1/{parent=projects/*/locations/*}/keyRings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCryptoKeys",
+            full_name="google.cloud.kms.v1.KeyManagementService.ListCryptoKeys",
+            index=1,
+            containing_service=None,
+            input_type=_LISTCRYPTOKEYSREQUEST,
+            output_type=_LISTCRYPTOKEYSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCryptoKeyVersions",
+            full_name="google.cloud.kms.v1.KeyManagementService.ListCryptoKeyVersions",
+            index=2,
+            containing_service=None,
+            input_type=_LISTCRYPTOKEYVERSIONSREQUEST,
+            output_type=_LISTCRYPTOKEYVERSIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002O\022M/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListImportJobs",
+            full_name="google.cloud.kms.v1.KeyManagementService.ListImportJobs",
+            index=3,
+            containing_service=None,
+            input_type=_LISTIMPORTJOBSREQUEST,
+            output_type=_LISTIMPORTJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetKeyRing",
+            full_name="google.cloud.kms.v1.KeyManagementService.GetKeyRing",
+            index=4,
+            containing_service=None,
+            input_type=_GETKEYRINGREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._KEYRING,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v1/{name=projects/*/locations/*/keyRings/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCryptoKey",
+            full_name="google.cloud.kms.v1.KeyManagementService.GetCryptoKey",
+            index=5,
+            containing_service=None,
+            input_type=_GETCRYPTOKEYREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCryptoKeyVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.GetCryptoKeyVersion",
+            index=6,
+            containing_service=None,
+            input_type=_GETCRYPTOKEYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION,
+            serialized_options=_b(
+                "\202\323\344\223\002O\022M/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetPublicKey",
+            full_name="google.cloud.kms.v1.KeyManagementService.GetPublicKey",
+            index=7,
+            containing_service=None,
+            input_type=_GETPUBLICKEYREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._PUBLICKEY,
+            serialized_options=_b(
+                "\202\323\344\223\002Y\022W/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}/publicKey"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetImportJob",
+            full_name="google.cloud.kms.v1.KeyManagementService.GetImportJob",
+            index=8,
+            containing_service=None,
+            input_type=_GETIMPORTJOBREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._IMPORTJOB,
+            serialized_options=_b(
+                "\202\323\344\223\002;\0229/v1/{name=projects/*/locations/*/keyRings/*/importJobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateKeyRing",
+            full_name="google.cloud.kms.v1.KeyManagementService.CreateKeyRing",
+            index=9,
+            containing_service=None,
+            input_type=_CREATEKEYRINGREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._KEYRING,
+            serialized_options=_b(
+                '\202\323\344\223\0028",/v1/{parent=projects/*/locations/*}/keyRings:\010key_ring'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateCryptoKey",
+            full_name="google.cloud.kms.v1.KeyManagementService.CreateCryptoKey",
+            index=10,
+            containing_service=None,
+            input_type=_CREATECRYPTOKEYREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY,
+            serialized_options=_b(
+                '\202\323\344\223\002G"9/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys:\ncrypto_key'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateCryptoKeyVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.CreateCryptoKeyVersion",
+            index=11,
+            containing_service=None,
+            input_type=_CREATECRYPTOKEYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION,
+            serialized_options=_b(
+                '\202\323\344\223\002c"M/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions:\022crypto_key_version'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportCryptoKeyVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion",
+            index=12,
+            containing_service=None,
+            input_type=_IMPORTCRYPTOKEYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION,
+            serialized_options=_b(
+                '\202\323\344\223\002Y"T/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions:import:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateImportJob",
+            full_name="google.cloud.kms.v1.KeyManagementService.CreateImportJob",
+            index=13,
+            containing_service=None,
+            input_type=_CREATEIMPORTJOBREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._IMPORTJOB,
+            serialized_options=_b(
+                '\202\323\344\223\002G"9/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs:\nimport_job'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCryptoKey",
+            full_name="google.cloud.kms.v1.KeyManagementService.UpdateCryptoKey",
+            index=14,
+            containing_service=None,
+            input_type=_UPDATECRYPTOKEYREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY,
+            serialized_options=_b(
+                "\202\323\344\223\002R2D/v1/{crypto_key.name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:\ncrypto_key"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCryptoKeyVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyVersion",
+            index=15,
+            containing_service=None,
+            input_type=_UPDATECRYPTOKEYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION,
+            serialized_options=_b(
+                "\202\323\344\223\002v2`/v1/{crypto_key_version.name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:\022crypto_key_version"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Encrypt",
+            full_name="google.cloud.kms.v1.KeyManagementService.Encrypt",
+            index=16,
+            containing_service=None,
+            input_type=_ENCRYPTREQUEST,
+            output_type=_ENCRYPTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002G"B/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/**}:encrypt:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Decrypt",
+            full_name="google.cloud.kms.v1.KeyManagementService.Decrypt",
+            index=17,
+            containing_service=None,
+            input_type=_DECRYPTREQUEST,
+            output_type=_DECRYPTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002F"A/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:decrypt:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsymmetricSign",
+            full_name="google.cloud.kms.v1.KeyManagementService.AsymmetricSign",
+            index=18,
+            containing_service=None,
+            input_type=_ASYMMETRICSIGNREQUEST,
+            output_type=_ASYMMETRICSIGNRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002a"\\/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricSign:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsymmetricDecrypt",
+            full_name="google.cloud.kms.v1.KeyManagementService.AsymmetricDecrypt",
+            index=19,
+            containing_service=None,
+            input_type=_ASYMMETRICDECRYPTREQUEST,
+            output_type=_ASYMMETRICDECRYPTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002d"_/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricDecrypt:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCryptoKeyPrimaryVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryVersion",
+            index=20,
+            containing_service=None,
+            input_type=_UPDATECRYPTOKEYPRIMARYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEY,
+            serialized_options=_b(
+                '\202\323\344\223\002S"N/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:updatePrimaryVersion:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DestroyCryptoKeyVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion",
+            index=21,
+            containing_service=None,
+            input_type=_DESTROYCRYPTOKEYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION,
+            serialized_options=_b(
+                '\202\323\344\223\002Z"U/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:destroy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RestoreCryptoKeyVersion",
+            full_name="google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion",
+            index=22,
+            containing_service=None,
+            input_type=_RESTORECRYPTOKEYVERSIONREQUEST,
+            output_type=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2._CRYPTOKEYVERSION,
+            serialized_options=_b(
+                '\202\323\344\223\002Z"U/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:restore:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_KEYMANAGEMENTSERVICE)
+
+DESCRIPTOR.services_by_name["KeyManagementService"] = _KEYMANAGEMENTSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/kms/google/cloud/kms_v1/proto/service_pb2_grpc.py b/kms/google/cloud/kms_v1/proto/service_pb2_grpc.py
new file mode 100644
index 000000000000..aa0d02262e48
--- /dev/null
+++ b/kms/google/cloud/kms_v1/proto/service_pb2_grpc.py
@@ -0,0 +1,496 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.kms_v1.proto import (
+    resources_pb2 as google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2,
+)
+from google.cloud.kms_v1.proto import (
+    service_pb2 as google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2,
+)
+
+
+class KeyManagementServiceStub(object):
+    """Google Cloud Key Management Service
+
+  Manages cryptographic keys and operations using those keys. Implements a REST
+  model with the following objects:
+
+  * [KeyRing][google.cloud.kms.v1.KeyRing]
+  * [CryptoKey][google.cloud.kms.v1.CryptoKey]
+  * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+
+  If you are using manual gRPC libraries, see
+  [Using gRPC with Cloud KMS](https://cloud.google.com/kms/docs/grpc).
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListKeyRings = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/ListKeyRings",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListKeyRingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListKeyRingsResponse.FromString,
+        )
+        self.ListCryptoKeys = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/ListCryptoKeys",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeysRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeysResponse.FromString,
+        )
+        self.ListCryptoKeyVersions = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/ListCryptoKeyVersions",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeyVersionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeyVersionsResponse.FromString,
+        )
+        self.ListImportJobs = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/ListImportJobs",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListImportJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListImportJobsResponse.FromString,
+        )
+        self.GetKeyRing = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/GetKeyRing",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetKeyRingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.KeyRing.FromString,
+        )
+        self.GetCryptoKey = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/GetCryptoKey",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetCryptoKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.FromString,
+        )
+        self.GetCryptoKeyVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/GetCryptoKeyVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetCryptoKeyVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.FromString,
+        )
+        self.GetPublicKey = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/GetPublicKey",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.PublicKey.FromString,
+        )
+        self.GetImportJob = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/GetImportJob",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetImportJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.ImportJob.FromString,
+        )
+        self.CreateKeyRing = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/CreateKeyRing",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateKeyRingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.KeyRing.FromString,
+        )
+        self.CreateCryptoKey = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/CreateCryptoKey",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateCryptoKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.FromString,
+        )
+        self.CreateCryptoKeyVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/CreateCryptoKeyVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateCryptoKeyVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.FromString,
+        )
+        self.ImportCryptoKeyVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/ImportCryptoKeyVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ImportCryptoKeyVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.FromString,
+        )
+        self.CreateImportJob = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/CreateImportJob",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateImportJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.ImportJob.FromString,
+        )
+        self.UpdateCryptoKey = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/UpdateCryptoKey",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.UpdateCryptoKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.FromString,
+        )
+        self.UpdateCryptoKeyVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/UpdateCryptoKeyVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.UpdateCryptoKeyVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.FromString,
+        )
+        self.Encrypt = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/Encrypt",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.EncryptRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.EncryptResponse.FromString,
+        )
+        self.Decrypt = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/Decrypt",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.DecryptRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.DecryptResponse.FromString,
+        )
+        self.AsymmetricSign = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/AsymmetricSign",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricSignRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricSignResponse.FromString,
+        )
+        self.AsymmetricDecrypt = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/AsymmetricDecrypt",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricDecryptRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricDecryptResponse.FromString,
+        )
+        self.UpdateCryptoKeyPrimaryVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/UpdateCryptoKeyPrimaryVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.UpdateCryptoKeyPrimaryVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.FromString,
+        )
+        self.DestroyCryptoKeyVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/DestroyCryptoKeyVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.DestroyCryptoKeyVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.FromString,
+        )
+        self.RestoreCryptoKeyVersion = channel.unary_unary(
+            "/google.cloud.kms.v1.KeyManagementService/RestoreCryptoKeyVersion",
+            request_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.RestoreCryptoKeyVersionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.FromString,
+        )
+
+
+class KeyManagementServiceServicer(object):
+    """Google Cloud Key Management Service
+
+  Manages cryptographic keys and operations using those keys. Implements a REST
+  model with the following objects:
+
+  * [KeyRing][google.cloud.kms.v1.KeyRing]
+  * [CryptoKey][google.cloud.kms.v1.CryptoKey]
+  * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+
+  If you are using manual gRPC libraries, see
+  [Using gRPC with Cloud KMS](https://cloud.google.com/kms/docs/grpc).
+  """
+
+    def ListKeyRings(self, request, context):
+        """Lists [KeyRings][google.cloud.kms.v1.KeyRing].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCryptoKeys(self, request, context):
+        """Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCryptoKeyVersions(self, request, context):
+        """Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListImportJobs(self, request, context):
+        """Lists [ImportJobs][google.cloud.kms.v1.ImportJob].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetKeyRing(self, request, context):
+        """Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCryptoKey(self, request, context):
+        """Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as well as its
+    [primary][google.cloud.kms.v1.CryptoKey.primary] [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCryptoKeyVersion(self, request, context):
+        """Returns metadata for a given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetPublicKey(self, request, context):
+        """Returns the public key for the given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The
+    [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be
+    [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] or
+    [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetImportJob(self, request, context):
+        """Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateKeyRing(self, request, context):
+        """Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and Location.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateCryptoKey(self, request, context):
+        """Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a [KeyRing][google.cloud.kms.v1.KeyRing].
+
+    [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and
+    [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm]
+    are required.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateCryptoKeyVersion(self, request, context):
+        """Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a [CryptoKey][google.cloud.kms.v1.CryptoKey].
+
+    The server will assign the next sequential id. If unset,
+    [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to
+    [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportCryptoKeyVersion(self, request, context):
+        """Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the
+    wrapped key material provided in the request.
+
+    The version ID will be assigned the next sequential id within the
+    [CryptoKey][google.cloud.kms.v1.CryptoKey].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateImportJob(self, request, context):
+        """Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a [KeyRing][google.cloud.kms.v1.KeyRing].
+
+    [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is required.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCryptoKey(self, request, context):
+        """Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCryptoKeyVersion(self, request, context):
+        """Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s metadata.
+
+    [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between
+    [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] and
+    [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] using this
+    method. See [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] and [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] to
+    move between other states.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Encrypt(self, request, context):
+        """Encrypts data, so that it can only be recovered by a call to [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
+    The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be
+    [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Decrypt(self, request, context):
+        """Decrypts data that was protected by [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+    must be [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsymmetricSign(self, request, context):
+        """Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
+    ASYMMETRIC_SIGN, producing a signature that can be verified with the public
+    key retrieved from [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsymmetricDecrypt(self, request, context):
+        """Decrypts data that was encrypted with a public key retrieved from
+    [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with
+    [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] ASYMMETRIC_DECRYPT.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCryptoKeyPrimaryVersion(self, request, context):
+        """Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that will be used in [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
+
+    Returns an error if called on an asymmetric key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DestroyCryptoKeyVersion(self, request, context):
+        """Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for destruction.
+
+    Upon calling this method, [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to
+    [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED]
+    and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will be set to a time 24
+    hours in the future, at which point the [state][google.cloud.kms.v1.CryptoKeyVersion.state]
+    will be changed to
+    [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], and the key
+    material will be irrevocably destroyed.
+
+    Before the [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is reached,
+    [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] may be called to reverse the process.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RestoreCryptoKeyVersion(self, request, context):
+        """Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the
+    [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED]
+    state.
+
+    Upon restoration of the CryptoKeyVersion, [state][google.cloud.kms.v1.CryptoKeyVersion.state]
+    will be set to [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED],
+    and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will be cleared.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_KeyManagementServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListKeyRings": grpc.unary_unary_rpc_method_handler(
+            servicer.ListKeyRings,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListKeyRingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListKeyRingsResponse.SerializeToString,
+        ),
+        "ListCryptoKeys": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCryptoKeys,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeysRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeysResponse.SerializeToString,
+        ),
+        "ListCryptoKeyVersions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCryptoKeyVersions,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeyVersionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListCryptoKeyVersionsResponse.SerializeToString,
+        ),
+        "ListImportJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListImportJobs,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListImportJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ListImportJobsResponse.SerializeToString,
+        ),
+        "GetKeyRing": grpc.unary_unary_rpc_method_handler(
+            servicer.GetKeyRing,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetKeyRingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.KeyRing.SerializeToString,
+        ),
+        "GetCryptoKey": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCryptoKey,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetCryptoKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.SerializeToString,
+        ),
+        "GetCryptoKeyVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCryptoKeyVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetCryptoKeyVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.SerializeToString,
+        ),
+        "GetPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.GetPublicKey,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.PublicKey.SerializeToString,
+        ),
+        "GetImportJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetImportJob,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.GetImportJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.ImportJob.SerializeToString,
+        ),
+        "CreateKeyRing": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateKeyRing,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateKeyRingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.KeyRing.SerializeToString,
+        ),
+        "CreateCryptoKey": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCryptoKey,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateCryptoKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.SerializeToString,
+        ),
+        "CreateCryptoKeyVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCryptoKeyVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateCryptoKeyVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.SerializeToString,
+        ),
+        "ImportCryptoKeyVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportCryptoKeyVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.ImportCryptoKeyVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.SerializeToString,
+        ),
+        "CreateImportJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateImportJob,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.CreateImportJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.ImportJob.SerializeToString,
+        ),
+        "UpdateCryptoKey": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCryptoKey,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.UpdateCryptoKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.SerializeToString,
+        ),
+        "UpdateCryptoKeyVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCryptoKeyVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.UpdateCryptoKeyVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.SerializeToString,
+        ),
+        "Encrypt": grpc.unary_unary_rpc_method_handler(
+            servicer.Encrypt,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.EncryptRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.EncryptResponse.SerializeToString,
+        ),
+        "Decrypt": grpc.unary_unary_rpc_method_handler(
+            servicer.Decrypt,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.DecryptRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.DecryptResponse.SerializeToString,
+        ),
+        "AsymmetricSign": grpc.unary_unary_rpc_method_handler(
+            servicer.AsymmetricSign,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricSignRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricSignResponse.SerializeToString,
+        ),
+        "AsymmetricDecrypt": grpc.unary_unary_rpc_method_handler(
+            servicer.AsymmetricDecrypt,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricDecryptRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.AsymmetricDecryptResponse.SerializeToString,
+        ),
+        "UpdateCryptoKeyPrimaryVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCryptoKeyPrimaryVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.UpdateCryptoKeyPrimaryVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKey.SerializeToString,
+        ),
+        "DestroyCryptoKeyVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.DestroyCryptoKeyVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.DestroyCryptoKeyVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.SerializeToString,
+        ),
+        "RestoreCryptoKeyVersion": grpc.unary_unary_rpc_method_handler(
+            servicer.RestoreCryptoKeyVersion,
+            request_deserializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_service__pb2.RestoreCryptoKeyVersionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_kms__v1_dot_proto_dot_resources__pb2.CryptoKeyVersion.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.kms.v1.KeyManagementService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/kms/google/cloud/kms_v1/types.py b/kms/google/cloud/kms_v1/types.py
new file mode 100644
index 000000000000..9b576ee86c06
--- /dev/null
+++ b/kms/google/cloud/kms_v1/types.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.kms_v1.proto import resources_pb2
+from google.cloud.kms_v1.proto import service_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [duration_pb2, field_mask_pb2, timestamp_pb2]
+
+_local_modules = [resources_pb2, service_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.kms_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/kms/noxfile.py b/kms/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/kms/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/kms/setup.cfg b/kms/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/kms/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/kms/setup.py b/kms/setup.py
new file mode 100644
index 000000000000..895f665f7039
--- /dev/null
+++ b/kms/setup.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-kms"
+description = "Cloud Key Management Service (KMS) API API client library"
+version = "1.2.1"
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/kms/synth.metadata b/kms/synth.metadata
new file mode 100644
index 000000000000..76bc063e8665
--- /dev/null
+++ b/kms/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-14T12:28:37.661447Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.33.0",
+        "dockerImage": "googleapis/artman@sha256:c6231efb525569736226b1f7af7565dbc84248efafb3692a5bb1d2d8a7975d53"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "3406d1e899f1f41123b3fa9210ad4bef25c9a720",
+        "internalRef": "263234709"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "kms",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/kms/artman_cloudkms.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/kms/synth.py b/kms/synth.py
new file mode 100644
index 000000000000..e1570a7284e0
--- /dev/null
+++ b/kms/synth.py
@@ -0,0 +1,55 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+client_library_version = "0.1.0"
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+version = "v1"
+
+# ----------------------------------------------------------------------------
+# Generate kms GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "kms",
+    version,
+    config_path="artman_cloudkms.yaml",
+    artman_output_name="kms-v1",
+    include_protos=True,
+)
+
+s.move(library, excludes=["README.rst", "setup.py", "nox*.py", "docs/**/*"])
+
+# Temporary fixup for 'grpc-google-iam-vi 0.12.4' (before generation).
+s.replace(
+    "google/cloud/kms_v1/gapic/transports/key_management_service_grpc_transport.py",
+    "from google.iam.v1 import iam_policy_pb2",
+    "from google.iam.v1 import iam_policy_pb2_grpc as iam_policy_pb2",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/kms/tests/system.py b/kms/tests/system.py
new file mode 100644
index 000000000000..4a23908dc337
--- /dev/null
+++ b/kms/tests/system.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from google.cloud import kms_v1
+
+
+class TestKeyManagementServiceClient(object):
+    def test_list_global_key_rings(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = kms_v1.KeyManagementServiceClient()
+        location = "global"
+        parent = client.location_path(project_id, location)
+        client.list_key_rings(parent)
diff --git a/kms/tests/unit/gapic/v1/test_key_management_service_client_v1.py b/kms/tests/unit/gapic/v1/test_key_management_service_client_v1.py
new file mode 100644
index 000000000000..dd73311fdb1c
--- /dev/null
+++ b/kms/tests/unit/gapic/v1/test_key_management_service_client_v1.py
@@ -0,0 +1,1332 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import kms_v1
+from google.cloud.kms_v1 import enums
+from google.cloud.kms_v1.proto import resources_pb2
+from google.cloud.kms_v1.proto import service_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestKeyManagementServiceClient(object):
+    def test_list_key_rings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        key_rings_element = {}
+        key_rings = [key_rings_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "key_rings": key_rings,
+        }
+        expected_response = service_pb2.ListKeyRingsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_key_rings(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.key_rings[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListKeyRingsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_key_rings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_key_rings(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_import_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        import_jobs_element = {}
+        import_jobs = [import_jobs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "import_jobs": import_jobs,
+        }
+        expected_response = service_pb2.ListImportJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        paged_list_response = client.list_import_jobs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.import_jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListImportJobsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_import_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        paged_list_response = client.list_import_jobs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_crypto_keys(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        crypto_keys_element = {}
+        crypto_keys = [crypto_keys_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "crypto_keys": crypto_keys,
+        }
+        expected_response = service_pb2.ListCryptoKeysResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        paged_list_response = client.list_crypto_keys(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.crypto_keys[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListCryptoKeysRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_crypto_keys_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        paged_list_response = client.list_crypto_keys(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_crypto_key_versions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        crypto_key_versions_element = {}
+        crypto_key_versions = [crypto_key_versions_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "crypto_key_versions": crypto_key_versions,
+        }
+        expected_response = service_pb2.ListCryptoKeyVersionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+
+        paged_list_response = client.list_crypto_key_versions(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.crypto_key_versions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ListCryptoKeyVersionsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_crypto_key_versions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+
+        paged_list_response = client.list_crypto_key_versions(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_key_ring(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = resources_pb2.KeyRing(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        response = client.get_key_ring(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetKeyRingRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_key_ring_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        with pytest.raises(CustomException):
+            client.get_key_ring(name)
+
+    def test_get_import_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = resources_pb2.ImportJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.import_job_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[IMPORT_JOB]"
+        )
+
+        response = client.get_import_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetImportJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_import_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.import_job_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[IMPORT_JOB]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_import_job(name)
+
+    def test_get_crypto_key(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = resources_pb2.CryptoKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+
+        response = client.get_crypto_key(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetCryptoKeyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_crypto_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_crypto_key(name)
+
+    def test_get_crypto_key_version(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        import_job = "importJob2125587491"
+        import_failure_reason = "importFailureReason-494073229"
+        expected_response = {
+            "name": name_2,
+            "import_job": import_job,
+            "import_failure_reason": import_failure_reason,
+        }
+        expected_response = resources_pb2.CryptoKeyVersion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        response = client.get_crypto_key_version(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetCryptoKeyVersionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_crypto_key_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        with pytest.raises(CustomException):
+            client.get_crypto_key_version(name)
+
+    def test_create_key_ring(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = resources_pb2.KeyRing(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        key_ring_id = "keyRingId-2056646742"
+        key_ring = {}
+
+        response = client.create_key_ring(parent, key_ring_id, key_ring)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.CreateKeyRingRequest(
+            parent=parent, key_ring_id=key_ring_id, key_ring=key_ring
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_key_ring_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        key_ring_id = "keyRingId-2056646742"
+        key_ring = {}
+
+        with pytest.raises(CustomException):
+            client.create_key_ring(parent, key_ring_id, key_ring)
+
+    def test_create_import_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = resources_pb2.ImportJob(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        import_job_id = "my-import-job"
+        import_method = enums.ImportJob.ImportMethod.RSA_OAEP_3072_SHA1_AES_256
+        protection_level = enums.ProtectionLevel.HSM
+        import_job = {
+            "import_method": import_method,
+            "protection_level": protection_level,
+        }
+
+        response = client.create_import_job(parent, import_job_id, import_job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.CreateImportJobRequest(
+            parent=parent, import_job_id=import_job_id, import_job=import_job
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_import_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        import_job_id = "my-import-job"
+        import_method = enums.ImportJob.ImportMethod.RSA_OAEP_3072_SHA1_AES_256
+        protection_level = enums.ProtectionLevel.HSM
+        import_job = {
+            "import_method": import_method,
+            "protection_level": protection_level,
+        }
+
+        with pytest.raises(CustomException):
+            client.create_import_job(parent, import_job_id, import_job)
+
+    def test_create_crypto_key(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = resources_pb2.CryptoKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        crypto_key_id = "my-app-key"
+        purpose = enums.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT
+        seconds = 2147483647
+        next_rotation_time = {"seconds": seconds}
+        seconds_2 = 604800
+        rotation_period = {"seconds": seconds_2}
+        crypto_key = {
+            "purpose": purpose,
+            "next_rotation_time": next_rotation_time,
+            "rotation_period": rotation_period,
+        }
+
+        response = client.create_crypto_key(parent, crypto_key_id, crypto_key)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.CreateCryptoKeyRequest(
+            parent=parent, crypto_key_id=crypto_key_id, crypto_key=crypto_key
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_crypto_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        crypto_key_id = "my-app-key"
+        purpose = enums.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT
+        seconds = 2147483647
+        next_rotation_time = {"seconds": seconds}
+        seconds_2 = 604800
+        rotation_period = {"seconds": seconds_2}
+        crypto_key = {
+            "purpose": purpose,
+            "next_rotation_time": next_rotation_time,
+            "rotation_period": rotation_period,
+        }
+
+        with pytest.raises(CustomException):
+            client.create_crypto_key(parent, crypto_key_id, crypto_key)
+
+    def test_create_crypto_key_version(self):
+        # Setup Expected Response
+        name = "name3373707"
+        import_job = "importJob2125587491"
+        import_failure_reason = "importFailureReason-494073229"
+        expected_response = {
+            "name": name,
+            "import_job": import_job,
+            "import_failure_reason": import_failure_reason,
+        }
+        expected_response = resources_pb2.CryptoKeyVersion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        crypto_key_version = {}
+
+        response = client.create_crypto_key_version(parent, crypto_key_version)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.CreateCryptoKeyVersionRequest(
+            parent=parent, crypto_key_version=crypto_key_version
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_crypto_key_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        crypto_key_version = {}
+
+        with pytest.raises(CustomException):
+            client.create_crypto_key_version(parent, crypto_key_version)
+
+    def test_import_crypto_key_version(self):
+        # Setup Expected Response
+        name = "name3373707"
+        import_job_2 = "importJob2-1714851050"
+        import_failure_reason = "importFailureReason-494073229"
+        expected_response = {
+            "name": name,
+            "import_job": import_job_2,
+            "import_failure_reason": import_failure_reason,
+        }
+        expected_response = resources_pb2.CryptoKeyVersion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        parent = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        algorithm = (
+            enums.CryptoKeyVersion.CryptoKeyVersionAlgorithm.CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED
+        )
+        import_job = "importJob2125587491"
+
+        response = client.import_crypto_key_version(parent, algorithm, import_job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.ImportCryptoKeyVersionRequest(
+            parent=parent, algorithm=algorithm, import_job=import_job
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_crypto_key_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        parent = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        algorithm = (
+            enums.CryptoKeyVersion.CryptoKeyVersionAlgorithm.CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED
+        )
+        import_job = "importJob2125587491"
+
+        with pytest.raises(CustomException):
+            client.import_crypto_key_version(parent, algorithm, import_job)
+
+    def test_update_crypto_key(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = resources_pb2.CryptoKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        crypto_key = {}
+        update_mask = {}
+
+        response = client.update_crypto_key(crypto_key, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UpdateCryptoKeyRequest(
+            crypto_key=crypto_key, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_crypto_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        crypto_key = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_crypto_key(crypto_key, update_mask)
+
+    def test_update_crypto_key_version(self):
+        # Setup Expected Response
+        name = "name3373707"
+        import_job = "importJob2125587491"
+        import_failure_reason = "importFailureReason-494073229"
+        expected_response = {
+            "name": name,
+            "import_job": import_job,
+            "import_failure_reason": import_failure_reason,
+        }
+        expected_response = resources_pb2.CryptoKeyVersion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        crypto_key_version = {}
+        update_mask = {}
+
+        response = client.update_crypto_key_version(crypto_key_version, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UpdateCryptoKeyVersionRequest(
+            crypto_key_version=crypto_key_version, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_crypto_key_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        crypto_key_version = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_crypto_key_version(crypto_key_version, update_mask)
+
+    def test_encrypt(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        ciphertext = b"-72"
+        expected_response = {"name": name_2, "ciphertext": ciphertext}
+        expected_response = service_pb2.EncryptResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_path_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY_PATH]"
+        )
+        plaintext = b"-9"
+
+        response = client.encrypt(name, plaintext)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.EncryptRequest(name=name, plaintext=plaintext)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_encrypt_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_path_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY_PATH]"
+        )
+        plaintext = b"-9"
+
+        with pytest.raises(CustomException):
+            client.encrypt(name, plaintext)
+
+    def test_decrypt(self):
+        # Setup Expected Response
+        plaintext = b"-9"
+        expected_response = {"plaintext": plaintext}
+        expected_response = service_pb2.DecryptResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        ciphertext = b"-72"
+
+        response = client.decrypt(name, ciphertext)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.DecryptRequest(name=name, ciphertext=ciphertext)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_decrypt_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        ciphertext = b"-72"
+
+        with pytest.raises(CustomException):
+            client.decrypt(name, ciphertext)
+
+    def test_update_crypto_key_primary_version(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = resources_pb2.CryptoKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        crypto_key_version_id = "cryptoKeyVersionId729489152"
+
+        response = client.update_crypto_key_primary_version(name, crypto_key_version_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.UpdateCryptoKeyPrimaryVersionRequest(
+            name=name, crypto_key_version_id=crypto_key_version_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_crypto_key_primary_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_path(
+            "[PROJECT]", "[LOCATION]", "[KEY_RING]", "[CRYPTO_KEY]"
+        )
+        crypto_key_version_id = "cryptoKeyVersionId729489152"
+
+        with pytest.raises(CustomException):
+            client.update_crypto_key_primary_version(name, crypto_key_version_id)
+
+    def test_destroy_crypto_key_version(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        import_job = "importJob2125587491"
+        import_failure_reason = "importFailureReason-494073229"
+        expected_response = {
+            "name": name_2,
+            "import_job": import_job,
+            "import_failure_reason": import_failure_reason,
+        }
+        expected_response = resources_pb2.CryptoKeyVersion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        response = client.destroy_crypto_key_version(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.DestroyCryptoKeyVersionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_destroy_crypto_key_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        with pytest.raises(CustomException):
+            client.destroy_crypto_key_version(name)
+
+    def test_restore_crypto_key_version(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        import_job = "importJob2125587491"
+        import_failure_reason = "importFailureReason-494073229"
+        expected_response = {
+            "name": name_2,
+            "import_job": import_job,
+            "import_failure_reason": import_failure_reason,
+        }
+        expected_response = resources_pb2.CryptoKeyVersion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        response = client.restore_crypto_key_version(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.RestoreCryptoKeyVersionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_restore_crypto_key_version_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        with pytest.raises(CustomException):
+            client.restore_crypto_key_version(name)
+
+    def test_get_public_key(self):
+        # Setup Expected Response
+        pem = "pem110872"
+        expected_response = {"pem": pem}
+        expected_response = resources_pb2.PublicKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        response = client.get_public_key(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.GetPublicKeyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_public_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+
+        with pytest.raises(CustomException):
+            client.get_public_key(name)
+
+    def test_asymmetric_decrypt(self):
+        # Setup Expected Response
+        plaintext = b"-9"
+        expected_response = {"plaintext": plaintext}
+        expected_response = service_pb2.AsymmetricDecryptResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+        ciphertext = b"-72"
+
+        response = client.asymmetric_decrypt(name, ciphertext)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.AsymmetricDecryptRequest(
+            name=name, ciphertext=ciphertext
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_asymmetric_decrypt_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+        ciphertext = b"-72"
+
+        with pytest.raises(CustomException):
+            client.asymmetric_decrypt(name, ciphertext)
+
+    def test_asymmetric_sign(self):
+        # Setup Expected Response
+        signature = b"-100"
+        expected_response = {"signature": signature}
+        expected_response = service_pb2.AsymmetricSignResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+        digest = {}
+
+        response = client.asymmetric_sign(name, digest)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = service_pb2.AsymmetricSignRequest(name=name, digest=digest)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_asymmetric_sign_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        name = client.crypto_key_version_path(
+            "[PROJECT]",
+            "[LOCATION]",
+            "[KEY_RING]",
+            "[CRYPTO_KEY]",
+            "[CRYPTO_KEY_VERSION]",
+        )
+        digest = {}
+
+        with pytest.raises(CustomException):
+            client.asymmetric_sign(name, digest)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        resource = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        resource = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        resource = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        resource = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup Request
+        resource = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = kms_v1.KeyManagementServiceClient()
+
+        # Setup request
+        resource = client.key_ring_path("[PROJECT]", "[LOCATION]", "[KEY_RING]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/language/.coveragerc b/language/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/language/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/language/.flake8 b/language/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/language/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/language/.repo-metadata.json b/language/.repo-metadata.json
new file mode 100644
index 000000000000..a9e1a79db954
--- /dev/null
+++ b/language/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "language",
+  "name_pretty": "Natural Language",
+  "product_documentation": "https://cloud.google.com/natural-language/docs/",
+  "client_documentation": "https://googleapis.dev/python/language/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559753",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-language",
+  "api_id": "language.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/language/CHANGELOG.md b/language/CHANGELOG.md
new file mode 100644
index 000000000000..50cd9793bc2f
--- /dev/null
+++ b/language/CHANGELOG.md
@@ -0,0 +1,176 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-language/#history
+
+## 1.3.0
+
+07-24-2019 16:44 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel  ([#8396](https://github.com/googleapis/google-cloud-python/pull/8396))
+
+### New Features
+- Add 'client_options' support (via synth). ([#8515](https://github.com/googleapis/google-cloud-python/pull/8515))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Add google.api proto annotations, update docstrings (via synth). ([#7659](https://github.com/googleapis/google-cloud-python/pull/7659))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8588](https://github.com/googleapis/google-cloud-python/pull/8588))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8357](https://github.com/googleapis/google-cloud-python/pull/8357))
+- Add disclaimer to auto-generated template files (via synth).  ([#8319](https://github.com/googleapis/google-cloud-python/pull/8319))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8246](https://github.com/googleapis/google-cloud-python/pull/8246))
+- Blacken 'noxfile.py' / 'setup.py' (via synth). ([#8158](https://github.com/googleapis/google-cloud-python/pull/8158))
+- Add empty lines (via synth). ([#8063](https://github.com/googleapis/google-cloud-python/pull/8063))
+- Add nox session `docs` (via synth). ([#7776](https://github.com/googleapis/google-cloud-python/pull/7776))
+
+## 1.2.0
+
+03-29-2019 09:53 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Protoc-generated serialization update. ([#7087](https://github.com/googleapis/google-cloud-python/pull/7087))
+
+### New Features
+- Add new entity types (via synth). ([#7510](https://github.com/googleapis/google-cloud-python/pull/7510))
+
+### Documentation
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+- Pick up stub docstring fix in GAPIC generator. ([#6975](https://github.com/googleapis/google-cloud-python/pull/6975))
+
+### Internal / Testing Changes
+- Copy lintified proto files (via synth). ([#7468](https://github.com/googleapis/google-cloud-python/pull/7468))
+- Add clarifying comment to blacken nox target. ([#7397](https://github.com/googleapis/google-cloud-python/pull/7397))
+- Copy in correct proto versions via synth. [#7257](https://github.com/googleapis/google-cloud-python/pull/7257))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 1.1.1
+
+12-18-2018 09:34 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6521](https://github.com/googleapis/google-cloud-python/pull/6521))
+- Fix `client_info` bug, update docstrings. ([#6415](https://github.com/googleapis/google-cloud-python/pull/6415))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Fix usage docs example for entity extraction ([#6193](https://github.com/googleapis/google-cloud-python/pull/6193))
+
+### Internal / Testing Changes
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add synth metadata. ([#6570](https://github.com/googleapis/google-cloud-python/pull/6570))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 1.1.0
+
+10-05-2018 13:52 PDT
+
+### Implementation Changes
+
+- The library has been regenerated to pick up changes in the underlying API.
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+
+### Documentation
+
+- Translate / Logging / Language: restore detailed usage docs. ([#5999](https://github.com/googleapis/google-cloud-python/pull/5999))
+- Redirect renamed 'usage.html'/'client.html' -> 'index.html'. ([#5996](https://github.com/googleapis/google-cloud-python/pull/5996))
+- Prep language docs for repo split. ([#5932](https://github.com/googleapis/google-cloud-python/pull/5932))
+
+### Internal / Testing Changes
+
+- Language: add 'synth.py'. ([#6080](https://github.com/googleapis/google-cloud-python/pull/6080))
+- Nox: use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Avoid overwriting '__module__' of messages from shared modules. ([#5364](https://github.com/googleapis/google-cloud-python/pull/5364))
+- Modify system tests to use prerelease versions of grpcio ([#5304](https://github.com/googleapis/google-cloud-python/pull/5304))
+
+## 1.0.2
+
+### Packaging
+- Update setuptools before packaging (#5265)
+- Update setup.py to use recommended method for python-verson specific dependencies (#5266)
+- Fix bad trove classifier
+
+## 1.0.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Fix coveragerc to correctly omit generated files (#4843)
+
+## 1.0.0
+
+[![release level](https://img.shields.io/badge/release%20level-general%20availability%20%28GA%29-brightgreen.svg?style&#x3D;flat)](https://cloud.google.com/terms/launch-stages)
+
+### Features
+
+##### General Availability
+
+The `google-cloud-language` package is now supported at the **general availability** quality level. This means it is stable; the code and API surface will not change in backwards-incompatible ways unless absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period.
+
+One exception to this: We will remove beta endpoints (as a semver-minor update) at whatever point the underlying endpoints go away.
+
+## 0.31.0
+
+### Release Candidate
+
+  * This update is considered a final "release candidate", and
+    the `google-cloud-language` package is preparing for a GA release
+    in the near future.
+
+### :warning: Breaking Changes!
+
+  * Some rarely-used arguments to the `LanguageServiceClient` constructor
+    have been removed (in favor of a subclass or a custom gRPC channel).
+    It is unlikely that you used these, but if you did, then this update
+    will represent a breaking change.
+      * The removed arguments are: `client_config`, `lib_name`, `lib_version`
+        `metrics_headers`, `ssl_credentials`, and `scopes`.
+
+### Features
+
+  * Added the `classify_text` method on the primary (`v1`) endpoint. (#4283)
+
+## 0.30.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+PyPI: https://pypi.org/project/google-cloud-language/0.30.0/
diff --git a/language/LICENSE b/language/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/language/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/language/MANIFEST.in b/language/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/language/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/language/README.rst b/language/README.rst
new file mode 100644
index 000000000000..dc904d4559d2
--- /dev/null
+++ b/language/README.rst
@@ -0,0 +1,102 @@
+Python Client for Google Cloud Natural Language
+===============================================
+
+|GA| |pypi| |versions| 
+
+The `Google Cloud Natural Language`_ API can be used to reveal the
+structure and meaning of text via powerful machine
+learning models. You can use it to extract information about
+people, places, events and much more, mentioned in text documents,
+news articles or blog posts. You can use it to understand
+sentiment about your product on social media or parse intent from
+customer conversations happening in a call center or a messaging
+app. You can analyze text uploaded in your request or integrate
+with your document storage on Google Cloud Storage.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-language.svg
+   :target: https://pypi.org/project/google-cloud-language/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-language.svg
+   :target: https://pypi.org/project/google-cloud-language/
+.. _Google Cloud Natural Language: https://cloud.google.com/natural-language/
+.. _Product Documentation:  https://cloud.google.com/language/docs
+.. _Client Library Documentation: https://googleapis.dev/python/language/latest
+
+.. note::
+
+    This library currently does not run on Google App Engine Standard.
+    We are actively working on adding this support.
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Language API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Language API.:  https://cloud.google.com/natural-language
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-language
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-language
+
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Usage documentation`_ for the language client
+   to see available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
+
+.. _Usage documentation: https://googleapis.dev/python/language/latest
diff --git a/language/docs/README.rst b/language/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/language/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/language/docs/api.rst b/language/docs/api.rst
new file mode 100644
index 000000000000..4d7146159b1a
--- /dev/null
+++ b/language/docs/api.rst
@@ -0,0 +1,30 @@
+Language Client API Reference
+=============================
+
+This package includes clients for multiple versions of the Natural Language
+API. By default, you will get ``v1``, the latest GA version.
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1/api
+  gapic/v1/types
+
+If you are interested in beta features ahead of the latest GA, you may
+opt-in to the v1.1 beta, which is spelled ``v1beta2``. In order to do this,
+you will want to import from ``google.cloud.language_v1beta2`` in lieu of
+``google.cloud.language``.
+
+An API and type reference is provided for the v1.1 beta also:
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1beta2/api
+  gapic/v1beta2/types
+
+.. note::
+
+  The client for the beta API is provided on a provisional basis. The API
+  surface is subject to change, and it is possible that this client will be
+  deprecated or removed after its features become GA.
diff --git a/language/docs/changelog.md b/language/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/language/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/language/docs/conf.py b/language/docs/conf.py
new file mode 100644
index 000000000000..198fdcc57c37
--- /dev/null
+++ b/language/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-language documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.doctest",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-language"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-language-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-language.tex",
+        u"google-cloud-language Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-language",
+        u"google-cloud-language Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-language",
+        u"google-cloud-language Documentation",
+        author,
+        "google-cloud-language",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/language/docs/gapic/v1/api.rst b/language/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..2c5fd4fd76ea
--- /dev/null
+++ b/language/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Natural Language Client API
+===========================
+
+.. automodule:: google.cloud.language_v1
+  :members:
+  :inherited-members:
diff --git a/language/docs/gapic/v1/types.rst b/language/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..90d27a4b96fb
--- /dev/null
+++ b/language/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Natural Language Client Types
+=============================
+
+.. automodule:: google.cloud.language_v1.types
+  :members:
diff --git a/language/docs/gapic/v1beta2/api.rst b/language/docs/gapic/v1beta2/api.rst
new file mode 100644
index 000000000000..330d7e6e7a78
--- /dev/null
+++ b/language/docs/gapic/v1beta2/api.rst
@@ -0,0 +1,6 @@
+Natural Language Beta Client API
+================================
+
+.. automodule:: google.cloud.language_v1beta2
+  :members:
+  :inherited-members:
diff --git a/language/docs/gapic/v1beta2/types.rst b/language/docs/gapic/v1beta2/types.rst
new file mode 100644
index 000000000000..d9a7eb171f00
--- /dev/null
+++ b/language/docs/gapic/v1beta2/types.rst
@@ -0,0 +1,5 @@
+Natural Language Beta Client Types
+==================================
+
+.. automodule:: google.cloud.language_v1beta2.types
+  :members:
diff --git a/language/docs/index.rst b/language/docs/index.rst
new file mode 100644
index 000000000000..1df32e07554e
--- /dev/null
+++ b/language/docs/index.rst
@@ -0,0 +1,9 @@
+.. include:: README.rst
+
+
+.. toctree::
+  :maxdepth: 2
+
+  usage
+  api
+  changelog
diff --git a/language/docs/usage.rst b/language/docs/usage.rst
new file mode 100644
index 000000000000..f2e459342e74
--- /dev/null
+++ b/language/docs/usage.rst
@@ -0,0 +1,199 @@
+Using the Language Client
+=========================
+
+Documents
+*********
+
+The Google Natural Language API has the following supported methods:
+
+- `analyzeEntities`_
+- `analyzeSentiment`_
+- `analyzeEntitySentiment`_
+- `annotateText`_
+- `classifyText`_
+
+and each method uses a :class:`~.language_v1.types.Document` for representing
+text.
+
+  .. code-block:: python
+
+      >>> document = language.types.Document(
+      ...     content='Google, headquartered in Mountain View, unveiled the '
+      ...             'new Android phone at the Consumer Electronic Show.  '
+      ...             'Sundar Pichai said in his keynote that users love '
+      ...             'their new Android phones.',
+      ...     language='en',
+      ...     type='PLAIN_TEXT',
+      ... )
+
+
+The document's language defaults to ``None``, which will cause the API to
+auto-detect the language.
+
+In addition, you can construct an HTML document:
+
+  .. code-block:: python
+
+      >>> html_content = """\
+      ... <html>
+      ...   <head>
+      ...     <title>El Tiempo de las Historias</time>
+      ...   </head>
+      ...   <body>
+      ...     <p>La vaca salt&oacute; sobre la luna.</p>
+      ...   </body>
+      ... </html>
+      ... """
+      >>> document = language.types.Document(
+      ...     content=html_content,
+      ...     language='es',
+      ...     type='HTML',
+      ... )
+
+The ``language`` argument can be either ISO-639-1 or BCP-47 language
+codes. The API reference page contains the full list of `supported languages`_.
+
+.. _supported languages: https://cloud.google.com/natural-language/docs/languages
+
+
+In addition to supplying the text / HTML content, a document can refer
+to content stored in `Google Cloud Storage`_.
+
+  .. code-block:: python
+
+     >>> document = language.types.Document(
+     ...     gcs_content_uri='gs://my-text-bucket/sentiment-me.txt',
+     ...     type=language.enums.HTML,
+     ... )
+
+.. _analyzeEntities: https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/analyzeEntities
+.. _analyzeSentiment: https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/analyzeSentiment
+.. _analyzeEntitySentiment: https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/analyzeEntitySentiment
+.. _annotateText: https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/annotateText
+.. _classifyText: https://cloud.google.com/natural-language/docs/reference/rest/v1/documents/classifyText
+.. _Google Cloud Storage: https://cloud.google.com/storage/
+
+Analyze Entities
+****************
+
+The :meth:`~.language_v1.LanguageServiceClient.analyze_entities`
+method finds named entities (i.e. proper names) in the text. This method
+returns a :class:`~.language_v1.types.AnalyzeEntitiesResponse`.
+
+  .. code-block:: python
+
+     >>> document = language.types.Document(
+     ...     content='Michelangelo Caravaggio, Italian painter, is '
+     ...             'known for "The Calling of Saint Matthew".',
+     ...     type=language.enums.Document.Type.PLAIN_TEXT,
+     ... )
+     >>> response = client.analyze_entities(
+     ...     document=document,
+     ...     encoding_type='UTF32',
+     ... )
+     >>> for entity in response.entities:
+     ...     print('=' * 20)
+     ...     print('         name: {0}'.format(entity.name))
+     ...     print('         type: {0}'.format(entity.type))
+     ...     print('     metadata: {0}'.format(entity.metadata))
+     ...     print('     salience: {0}'.format(entity.salience))
+     ====================
+              name: Michelangelo Caravaggio
+              type: PERSON
+          metadata: {'wikipedia_url': 'https://en.wikipedia.org/wiki/Caravaggio'}
+          salience: 0.7615959
+     ====================
+              name: Italian
+              type: LOCATION
+          metadata: {'wikipedia_url': 'https://en.wikipedia.org/wiki/Italy'}
+          salience: 0.19960518
+     ====================
+              name: The Calling of Saint Matthew
+              type: EVENT
+          metadata: {'wikipedia_url': 'https://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)'}
+          salience: 0.038798928
+
+.. note::
+
+  It is recommended to send an ``encoding_type`` argument to Natural
+  Language methods, so they provide useful offsets for the data they return.
+  While the correct value varies by environment, in Python you *usually*
+  want ``UTF32``.
+
+
+Analyze Sentiment
+*****************
+
+The :meth:`~.language_v1.LanguageServiceClient.analyze_sentiment` method
+analyzes the sentiment of the provided text. This method returns a
+:class:`~.language_v1.types.AnalyzeSentimentResponse`.
+
+  .. code-block:: python
+
+     >>> document = language.types.Document(
+     ...     content='Jogging is not very fun.',
+     ...     type='PLAIN_TEXT',
+     ... )
+     >>> response = client.analyze_sentiment(
+     ...     document=document,
+     ...     encoding_type='UTF32',
+     ... )
+     >>> sentiment = response.document_sentiment
+     >>> print(sentiment.score)
+     -1
+     >>> print(sentiment.magnitude)
+     0.8
+
+.. note::
+
+  It is recommended to send an ``encoding_type`` argument to Natural
+  Language methods, so they provide useful offsets for the data they return.
+  While the correct value varies by environment, in Python you *usually*
+  want ``UTF32``.
+
+
+Analyze Entity Sentiment
+************************
+
+The :meth:`~.language_v1.LanguageServiceClient.analyze_entity_sentiment`
+method is effectively the amalgamation of
+:meth:`~.language_v1.LanguageServiceClient.analyze_entities` and
+:meth:`~.language_v1.LanguageServiceClient.analyze_sentiment`.
+This method returns a
+:class:`~.language_v1.types.AnalyzeEntitySentimentResponse`.
+
+.. code-block:: python
+
+    >>> document = language.types.Document(
+    ...     content='Mona said that jogging is very fun.',
+    ...     type='PLAIN_TEXT',
+    ... )
+    >>> response = client.analyze_entity_sentiment(
+    ...     document=document,
+    ...     encoding_type='UTF32',
+    ... )
+    >>> entities = response.entities
+    >>> entities[0].name
+    'Mona'
+    >>> entities[1].name
+    'jogging'
+    >>> entities[1].sentiment.magnitude
+    0.8
+    >>> entities[1].sentiment.score
+    0.8
+
+.. note::
+
+    It is recommended to send an ``encoding_type`` argument to Natural
+    Language methods, so they provide useful offsets for the data they return.
+    While the correct value varies by environment, in Python you *usually*
+    want ``UTF32``.
+
+
+Annotate Text
+*************
+
+The :meth:`~.language_v1.LanguageServiceClient.annotate_text` method
+analyzes a document and is intended for users who are familiar with
+machine learning and need in-depth text features to build upon. This method
+returns a :class:`~.language_v1.types.AnnotateTextResponse`.
diff --git a/language/google/__init__.py b/language/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/language/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/language/google/cloud/__init__.py b/language/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/language/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/language/google/cloud/language.py b/language/google/cloud/language.py
new file mode 100644
index 000000000000..624bd1194391
--- /dev/null
+++ b/language/google/cloud/language.py
@@ -0,0 +1,21 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.language_v1 import LanguageServiceClient
+from google.cloud.language_v1 import enums
+from google.cloud.language_v1 import types
+
+__all__ = ("enums", "types", "LanguageServiceClient")
diff --git a/language/google/cloud/language_v1/__init__.py b/language/google/cloud/language_v1/__init__.py
new file mode 100644
index 000000000000..a44fe4c98d6c
--- /dev/null
+++ b/language/google/cloud/language_v1/__init__.py
@@ -0,0 +1,27 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.language_v1 import types
+from google.cloud.language_v1.gapic import enums
+from google.cloud.language_v1.gapic import language_service_client
+
+
+class LanguageServiceClient(language_service_client.LanguageServiceClient):
+    __doc__ = language_service_client.LanguageServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "LanguageServiceClient")
diff --git a/language/google/cloud/language_v1/gapic/__init__.py b/language/google/cloud/language_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/google/cloud/language_v1/gapic/enums.py b/language/google/cloud/language_v1/gapic/enums.py
new file mode 100644
index 000000000000..b4d44ab52067
--- /dev/null
+++ b/language/google/cloud/language_v1/gapic/enums.py
@@ -0,0 +1,592 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class EncodingType(enum.IntEnum):
+    """
+    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.
+
+    Attributes:
+      NONE (int): If ``EncodingType`` is not specified, encoding-dependent information
+      (such as ``begin_offset``) will be set at ``-1``.
+      UTF8 (int): 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.
+      UTF16 (int): 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.
+      UTF32 (int): 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.
+    """
+
+    NONE = 0
+    UTF8 = 1
+    UTF16 = 2
+    UTF32 = 3
+
+
+class DependencyEdge(object):
+    class Label(enum.IntEnum):
+        """
+        The parse label enum for the token.
+
+        Attributes:
+          UNKNOWN (int): Unknown
+          ABBREV (int): Abbreviation modifier
+          ACOMP (int): Adjectival complement
+          ADVCL (int): Adverbial clause modifier
+          ADVMOD (int): Adverbial modifier
+          AMOD (int): Adjectival modifier of an NP
+          APPOS (int): Appositional modifier of an NP
+          ATTR (int): Attribute dependent of a copular verb
+          AUX (int): Auxiliary (non-main) verb
+          AUXPASS (int): Passive auxiliary
+          CC (int): Coordinating conjunction
+          CCOMP (int): Clausal complement of a verb or adjective
+          CONJ (int): Conjunct
+          CSUBJ (int): Clausal subject
+          CSUBJPASS (int): Clausal passive subject
+          DEP (int): Dependency (unable to determine)
+          DET (int): Determiner
+          DISCOURSE (int): Discourse
+          DOBJ (int): Direct object
+          EXPL (int): Expletive
+          GOESWITH (int): Goes with (part of a word in a text not well edited)
+          IOBJ (int): Indirect object
+          MARK (int): Marker (word introducing a subordinate clause)
+          MWE (int): Multi-word expression
+          MWV (int): Multi-word verbal expression
+          NEG (int): Negation modifier
+          NN (int): Noun compound modifier
+          NPADVMOD (int): Noun phrase used as an adverbial modifier
+          NSUBJ (int): Nominal subject
+          NSUBJPASS (int): Passive nominal subject
+          NUM (int): Numeric modifier of a noun
+          NUMBER (int): Element of compound number
+          P (int): Punctuation mark
+          PARATAXIS (int): Parataxis relation
+          PARTMOD (int): Participial modifier
+          PCOMP (int): The complement of a preposition is a clause
+          POBJ (int): Object of a preposition
+          POSS (int): Possession modifier
+          POSTNEG (int): Postverbal negative particle
+          PRECOMP (int): Predicate complement
+          PRECONJ (int): Preconjunt
+          PREDET (int): Predeterminer
+          PREF (int): Prefix
+          PREP (int): Prepositional modifier
+          PRONL (int): The relationship between a verb and verbal morpheme
+          PRT (int): Particle
+          PS (int): Associative or possessive marker
+          QUANTMOD (int): Quantifier phrase modifier
+          RCMOD (int): Relative clause modifier
+          RCMODREL (int): Complementizer in relative clause
+          RDROP (int): Ellipsis without a preceding predicate
+          REF (int): Referent
+          REMNANT (int): Remnant
+          REPARANDUM (int): Reparandum
+          ROOT (int): Root
+          SNUM (int): Suffix specifying a unit of number
+          SUFF (int): Suffix
+          TMOD (int): Temporal modifier
+          TOPIC (int): Topic marker
+          VMOD (int): Clause headed by an infinite form of the verb that modifies a noun
+          VOCATIVE (int): Vocative
+          XCOMP (int): Open clausal complement
+          SUFFIX (int): Name suffix
+          TITLE (int): Name title
+          ADVPHMOD (int): Adverbial phrase modifier
+          AUXCAUS (int): Causative auxiliary
+          AUXVV (int): Helper auxiliary
+          DTMOD (int): Rentaishi (Prenominal modifier)
+          FOREIGN (int): Foreign words
+          KW (int): Keyword
+          LIST (int): List for chains of comparable items
+          NOMC (int): Nominalized clause
+          NOMCSUBJ (int): Nominalized clausal subject
+          NOMCSUBJPASS (int): Nominalized clausal passive
+          NUMC (int): Compound of numeric modifier
+          COP (int): Copula
+          DISLOCATED (int): Dislocated relation (for fronted/topicalized elements)
+          ASP (int): Aspect marker
+          GMOD (int): Genitive modifier
+          GOBJ (int): Genitive object
+          INFMOD (int): Infinitival modifier
+          MES (int): Measure
+          NCOMP (int): Nominal complement of a noun
+        """
+
+        UNKNOWN = 0
+        ABBREV = 1
+        ACOMP = 2
+        ADVCL = 3
+        ADVMOD = 4
+        AMOD = 5
+        APPOS = 6
+        ATTR = 7
+        AUX = 8
+        AUXPASS = 9
+        CC = 10
+        CCOMP = 11
+        CONJ = 12
+        CSUBJ = 13
+        CSUBJPASS = 14
+        DEP = 15
+        DET = 16
+        DISCOURSE = 17
+        DOBJ = 18
+        EXPL = 19
+        GOESWITH = 20
+        IOBJ = 21
+        MARK = 22
+        MWE = 23
+        MWV = 24
+        NEG = 25
+        NN = 26
+        NPADVMOD = 27
+        NSUBJ = 28
+        NSUBJPASS = 29
+        NUM = 30
+        NUMBER = 31
+        P = 32
+        PARATAXIS = 33
+        PARTMOD = 34
+        PCOMP = 35
+        POBJ = 36
+        POSS = 37
+        POSTNEG = 38
+        PRECOMP = 39
+        PRECONJ = 40
+        PREDET = 41
+        PREF = 42
+        PREP = 43
+        PRONL = 44
+        PRT = 45
+        PS = 46
+        QUANTMOD = 47
+        RCMOD = 48
+        RCMODREL = 49
+        RDROP = 50
+        REF = 51
+        REMNANT = 52
+        REPARANDUM = 53
+        ROOT = 54
+        SNUM = 55
+        SUFF = 56
+        TMOD = 57
+        TOPIC = 58
+        VMOD = 59
+        VOCATIVE = 60
+        XCOMP = 61
+        SUFFIX = 62
+        TITLE = 63
+        ADVPHMOD = 64
+        AUXCAUS = 65
+        AUXVV = 66
+        DTMOD = 67
+        FOREIGN = 68
+        KW = 69
+        LIST = 70
+        NOMC = 71
+        NOMCSUBJ = 72
+        NOMCSUBJPASS = 73
+        NUMC = 74
+        COP = 75
+        DISLOCATED = 76
+        ASP = 77
+        GMOD = 78
+        GOBJ = 79
+        INFMOD = 80
+        MES = 81
+        NCOMP = 82
+
+
+class Document(object):
+    class Type(enum.IntEnum):
+        """
+        The document types enum.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): The content type is not specified.
+          PLAIN_TEXT (int): Plain text
+          HTML (int): HTML
+        """
+
+        TYPE_UNSPECIFIED = 0
+        PLAIN_TEXT = 1
+        HTML = 2
+
+
+class Entity(object):
+    class Type(enum.IntEnum):
+        """
+        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.
+
+        Attributes:
+          UNKNOWN (int): Unknown
+          PERSON (int): Person
+          LOCATION (int): Location
+          ORGANIZATION (int): Organization
+          EVENT (int): Event
+          WORK_OF_ART (int): Artwork
+          CONSUMER_GOOD (int): Consumer product
+          OTHER (int): Other types of entities
+          PHONE_NUMBER (int): Phone number The metadata lists the phone number, formatted according to
+          local convention, plus whichever additional elements appear in the text:
+
+          .. raw:: html
+
+              <li><code>number</code> &ndash; the actual number, broken down into
+              sections as per local convention</li> <li><code>national_prefix</code>
+              &ndash; country code, if detected</li> <li><code>area_code</code> &ndash;
+              region or area code, if detected</li> <li><code>extension</code> &ndash;
+              phone extension (to be dialed after connection), if detected</li></ul>
+          ADDRESS (int): Address The metadata identifies the street number and locality plus
+          whichever additional elements appear in the text:
+
+          .. raw:: html
+
+              <li><code>street_number</code> &ndash; street number</li>
+              <li><code>locality</code> &ndash; city or town</li>
+              <li><code>street_name</code> &ndash; street/route name, if detected</li>
+              <li><code>postal_code</code> &ndash; postal code, if detected</li>
+              <li><code>country</code> &ndash; country, if detected</li>
+              <li><code>broad_region</code> &ndash; administrative area, such as the
+              state, if detected</li> <li><code>narrow_region</code> &ndash; smaller
+              administrative area, such as county, if detected</li>
+              <li><code>sublocality</code> &ndash; used in Asian addresses to demark a
+              district within a city, if detected</li></ul>
+          DATE (int): Date<br><br>
+          The metadata identifies the components of the date:<ul>
+          <li><code>year</code> &ndash; four digit year, if detected</li>
+          <li><code>month</code> &ndash; two digit month number, if detected</li>
+          <li><code>day</code> &ndash; two digit day number, if detected</li></ul>
+          NUMBER (int): Number<br><br>
+          The metadata is the number itself.
+          PRICE (int): Price<br><br>
+          The metadata identifies the <code>value</code> and <code>currency</code>.
+        """
+
+        UNKNOWN = 0
+        PERSON = 1
+        LOCATION = 2
+        ORGANIZATION = 3
+        EVENT = 4
+        WORK_OF_ART = 5
+        CONSUMER_GOOD = 6
+        OTHER = 7
+        PHONE_NUMBER = 9
+        ADDRESS = 10
+        DATE = 11
+        NUMBER = 12
+        PRICE = 13
+
+
+class EntityMention(object):
+    class Type(enum.IntEnum):
+        """
+        The supported types of mentions.
+
+        Attributes:
+          TYPE_UNKNOWN (int): Unknown
+          PROPER (int): Proper name
+          COMMON (int): Common noun (or noun compound)
+        """
+
+        TYPE_UNKNOWN = 0
+        PROPER = 1
+        COMMON = 2
+
+
+class PartOfSpeech(object):
+    class Aspect(enum.IntEnum):
+        """
+        The characteristic of a verb that expresses time flow during an event.
+
+        Attributes:
+          ASPECT_UNKNOWN (int): Aspect is not applicable in the analyzed language or is not predicted.
+          PERFECTIVE (int): Perfective
+          IMPERFECTIVE (int): Imperfective
+          PROGRESSIVE (int): Progressive
+        """
+
+        ASPECT_UNKNOWN = 0
+        PERFECTIVE = 1
+        IMPERFECTIVE = 2
+        PROGRESSIVE = 3
+
+    class Case(enum.IntEnum):
+        """
+        The grammatical function performed by a noun or pronoun in a phrase,
+        clause, or sentence. In some languages, other parts of speech, such as
+        adjective and determiner, take case inflection in agreement with the noun.
+
+        Attributes:
+          CASE_UNKNOWN (int): Case is not applicable in the analyzed language or is not predicted.
+          ACCUSATIVE (int): Accusative
+          ADVERBIAL (int): Adverbial
+          COMPLEMENTIVE (int): Complementive
+          DATIVE (int): Dative
+          GENITIVE (int): Genitive
+          INSTRUMENTAL (int): Instrumental
+          LOCATIVE (int): Locative
+          NOMINATIVE (int): Nominative
+          OBLIQUE (int): Oblique
+          PARTITIVE (int): Partitive
+          PREPOSITIONAL (int): Prepositional
+          REFLEXIVE_CASE (int): Reflexive
+          RELATIVE_CASE (int): Relative
+          VOCATIVE (int): Vocative
+        """
+
+        CASE_UNKNOWN = 0
+        ACCUSATIVE = 1
+        ADVERBIAL = 2
+        COMPLEMENTIVE = 3
+        DATIVE = 4
+        GENITIVE = 5
+        INSTRUMENTAL = 6
+        LOCATIVE = 7
+        NOMINATIVE = 8
+        OBLIQUE = 9
+        PARTITIVE = 10
+        PREPOSITIONAL = 11
+        REFLEXIVE_CASE = 12
+        RELATIVE_CASE = 13
+        VOCATIVE = 14
+
+    class Form(enum.IntEnum):
+        """
+        Depending on the language, Form can be categorizing different forms of
+        verbs, adjectives, adverbs, etc. For example, categorizing inflected
+        endings of verbs and adjectives or distinguishing between short and long
+        forms of adjectives and participles
+
+        Attributes:
+          FORM_UNKNOWN (int): Form is not applicable in the analyzed language or is not predicted.
+          ADNOMIAL (int): Adnomial
+          AUXILIARY (int): Auxiliary
+          COMPLEMENTIZER (int): Complementizer
+          FINAL_ENDING (int): Final ending
+          GERUND (int): Gerund
+          REALIS (int): Realis
+          IRREALIS (int): Irrealis
+          SHORT (int): Short form
+          LONG (int): Long form
+          ORDER (int): Order form
+          SPECIFIC (int): Specific form
+        """
+
+        FORM_UNKNOWN = 0
+        ADNOMIAL = 1
+        AUXILIARY = 2
+        COMPLEMENTIZER = 3
+        FINAL_ENDING = 4
+        GERUND = 5
+        REALIS = 6
+        IRREALIS = 7
+        SHORT = 8
+        LONG = 9
+        ORDER = 10
+        SPECIFIC = 11
+
+    class Gender(enum.IntEnum):
+        """
+        Gender classes of nouns reflected in the behaviour of associated words.
+
+        Attributes:
+          GENDER_UNKNOWN (int): Gender is not applicable in the analyzed language or is not predicted.
+          FEMININE (int): Feminine
+          MASCULINE (int): Masculine
+          NEUTER (int): Neuter
+        """
+
+        GENDER_UNKNOWN = 0
+        FEMININE = 1
+        MASCULINE = 2
+        NEUTER = 3
+
+    class Mood(enum.IntEnum):
+        """
+        The grammatical feature of verbs, used for showing modality and attitude.
+
+        Attributes:
+          MOOD_UNKNOWN (int): Mood is not applicable in the analyzed language or is not predicted.
+          CONDITIONAL_MOOD (int): Conditional
+          IMPERATIVE (int): Imperative
+          INDICATIVE (int): Indicative
+          INTERROGATIVE (int): Interrogative
+          JUSSIVE (int): Jussive
+          SUBJUNCTIVE (int): Subjunctive
+        """
+
+        MOOD_UNKNOWN = 0
+        CONDITIONAL_MOOD = 1
+        IMPERATIVE = 2
+        INDICATIVE = 3
+        INTERROGATIVE = 4
+        JUSSIVE = 5
+        SUBJUNCTIVE = 6
+
+    class Number(enum.IntEnum):
+        """
+        Count distinctions.
+
+        Attributes:
+          NUMBER_UNKNOWN (int): Number is not applicable in the analyzed language or is not predicted.
+          SINGULAR (int): Singular
+          PLURAL (int): Plural
+          DUAL (int): Dual
+        """
+
+        NUMBER_UNKNOWN = 0
+        SINGULAR = 1
+        PLURAL = 2
+        DUAL = 3
+
+    class Person(enum.IntEnum):
+        """
+        The distinction between the speaker, second person, third person, etc.
+
+        Attributes:
+          PERSON_UNKNOWN (int): Person is not applicable in the analyzed language or is not predicted.
+          FIRST (int): First
+          SECOND (int): Second
+          THIRD (int): Third
+          REFLEXIVE_PERSON (int): Reflexive
+        """
+
+        PERSON_UNKNOWN = 0
+        FIRST = 1
+        SECOND = 2
+        THIRD = 3
+        REFLEXIVE_PERSON = 4
+
+    class Proper(enum.IntEnum):
+        """
+        This category shows if the token is part of a proper name.
+
+        Attributes:
+          PROPER_UNKNOWN (int): Proper is not applicable in the analyzed language or is not predicted.
+          PROPER (int): Proper
+          NOT_PROPER (int): Not proper
+        """
+
+        PROPER_UNKNOWN = 0
+        PROPER = 1
+        NOT_PROPER = 2
+
+    class Reciprocity(enum.IntEnum):
+        """
+        Reciprocal features of a pronoun.
+
+        Attributes:
+          RECIPROCITY_UNKNOWN (int): Reciprocity is not applicable in the analyzed language or is not
+          predicted.
+          RECIPROCAL (int): Reciprocal
+          NON_RECIPROCAL (int): Non-reciprocal
+        """
+
+        RECIPROCITY_UNKNOWN = 0
+        RECIPROCAL = 1
+        NON_RECIPROCAL = 2
+
+    class Tag(enum.IntEnum):
+        """
+        The part of speech tags enum.
+
+        Attributes:
+          UNKNOWN (int): Unknown
+          ADJ (int): Adjective
+          ADP (int): Adposition (preposition and postposition)
+          ADV (int): Adverb
+          CONJ (int): Conjunction
+          DET (int): Determiner
+          NOUN (int): Noun (common and proper)
+          NUM (int): Cardinal number
+          PRON (int): Pronoun
+          PRT (int): Particle or other function word
+          PUNCT (int): Punctuation
+          VERB (int): Verb (all tenses and modes)
+          X (int): Other: foreign words, typos, abbreviations
+          AFFIX (int): Affix
+        """
+
+        UNKNOWN = 0
+        ADJ = 1
+        ADP = 2
+        ADV = 3
+        CONJ = 4
+        DET = 5
+        NOUN = 6
+        NUM = 7
+        PRON = 8
+        PRT = 9
+        PUNCT = 10
+        VERB = 11
+        X = 12
+        AFFIX = 13
+
+    class Tense(enum.IntEnum):
+        """
+        Time reference.
+
+        Attributes:
+          TENSE_UNKNOWN (int): Tense is not applicable in the analyzed language or is not predicted.
+          CONDITIONAL_TENSE (int): Conditional
+          FUTURE (int): Future
+          PAST (int): Past
+          PRESENT (int): Present
+          IMPERFECT (int): Imperfect
+          PLUPERFECT (int): Pluperfect
+        """
+
+        TENSE_UNKNOWN = 0
+        CONDITIONAL_TENSE = 1
+        FUTURE = 2
+        PAST = 3
+        PRESENT = 4
+        IMPERFECT = 5
+        PLUPERFECT = 6
+
+    class Voice(enum.IntEnum):
+        """
+        The relationship between the action that a verb expresses and the
+        participants identified by its arguments.
+
+        Attributes:
+          VOICE_UNKNOWN (int): Voice is not applicable in the analyzed language or is not predicted.
+          ACTIVE (int): Active
+          CAUSATIVE (int): Causative
+          PASSIVE (int): Passive
+        """
+
+        VOICE_UNKNOWN = 0
+        ACTIVE = 1
+        CAUSATIVE = 2
+        PASSIVE = 3
diff --git a/language/google/cloud/language_v1/gapic/language_service_client.py b/language/google/cloud/language_v1/gapic/language_service_client.py
new file mode 100644
index 000000000000..407ef04480ae
--- /dev/null
+++ b/language/google/cloud/language_v1/gapic/language_service_client.py
@@ -0,0 +1,578 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.language.v1 LanguageService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.language_v1.gapic import enums
+from google.cloud.language_v1.gapic import language_service_client_config
+from google.cloud.language_v1.gapic.transports import language_service_grpc_transport
+from google.cloud.language_v1.proto import language_service_pb2
+from google.cloud.language_v1.proto import language_service_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-language").version
+
+
+class LanguageServiceClient(object):
+    """
+    Provides text analysis operations such as sentiment analysis and entity
+    recognition.
+    """
+
+    SERVICE_ADDRESS = "language.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.language.v1.LanguageService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            LanguageServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.LanguageServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.LanguageServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = language_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=language_service_grpc_transport.LanguageServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = language_service_grpc_transport.LanguageServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def analyze_sentiment(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Analyzes the sentiment of the provided text.
+
+        Example:
+            >>> from google.cloud import language_v1
+            >>>
+            >>> client = language_v1.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_sentiment(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Document`
+            encoding_type (~google.cloud.language_v1.enums.EncodingType): The encoding type used by the API to calculate sentence offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1.types.AnalyzeSentimentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_sentiment" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_sentiment"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_sentiment,
+                default_retry=self._method_configs["AnalyzeSentiment"].retry,
+                default_timeout=self._method_configs["AnalyzeSentiment"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeSentimentRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_sentiment"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def analyze_entities(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Finds named entities (currently proper names and common nouns) in the text
+        along with entity types, salience, mentions for each entity, and
+        other properties.
+
+        Example:
+            >>> from google.cloud import language_v1
+            >>>
+            >>> client = language_v1.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_entities(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Document`
+            encoding_type (~google.cloud.language_v1.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1.types.AnalyzeEntitiesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_entities" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_entities"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_entities,
+                default_retry=self._method_configs["AnalyzeEntities"].retry,
+                default_timeout=self._method_configs["AnalyzeEntities"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeEntitiesRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_entities"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def analyze_entity_sentiment(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Finds entities, similar to ``AnalyzeEntities`` in the text and analyzes
+        sentiment associated with each entity and its mentions.
+
+        Example:
+            >>> from google.cloud import language_v1
+            >>>
+            >>> client = language_v1.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_entity_sentiment(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Document`
+            encoding_type (~google.cloud.language_v1.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1.types.AnalyzeEntitySentimentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_entity_sentiment" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_entity_sentiment"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_entity_sentiment,
+                default_retry=self._method_configs["AnalyzeEntitySentiment"].retry,
+                default_timeout=self._method_configs["AnalyzeEntitySentiment"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeEntitySentimentRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_entity_sentiment"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def analyze_syntax(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Analyzes the syntax of the text and provides sentence boundaries and
+        tokenization along with part of speech tags, dependency trees, and other
+        properties.
+
+        Example:
+            >>> from google.cloud import language_v1
+            >>>
+            >>> client = language_v1.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_syntax(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Document`
+            encoding_type (~google.cloud.language_v1.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1.types.AnalyzeSyntaxResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_syntax" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_syntax"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_syntax,
+                default_retry=self._method_configs["AnalyzeSyntax"].retry,
+                default_timeout=self._method_configs["AnalyzeSyntax"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeSyntaxRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_syntax"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def classify_text(
+        self,
+        document,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Classifies a document into categories.
+
+        Example:
+            >>> from google.cloud import language_v1
+            >>>
+            >>> client = language_v1.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.classify_text(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Document`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1.types.ClassifyTextResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "classify_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "classify_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.classify_text,
+                default_retry=self._method_configs["ClassifyText"].retry,
+                default_timeout=self._method_configs["ClassifyText"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.ClassifyTextRequest(document=document)
+        return self._inner_api_calls["classify_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def annotate_text(
+        self,
+        document,
+        features,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        A convenience method that provides all the features that analyzeSentiment,
+        analyzeEntities, and analyzeSyntax provide in one call.
+
+        Example:
+            >>> from google.cloud import language_v1
+            >>>
+            >>> client = language_v1.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> # TODO: Initialize `features`:
+            >>> features = {}
+            >>>
+            >>> response = client.annotate_text(document, features)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Document`
+            features (Union[dict, ~google.cloud.language_v1.types.Features]): The enabled features.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1.types.Features`
+            encoding_type (~google.cloud.language_v1.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1.types.AnnotateTextResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_text,
+                default_retry=self._method_configs["AnnotateText"].retry,
+                default_timeout=self._method_configs["AnnotateText"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnnotateTextRequest(
+            document=document, features=features, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["annotate_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/language/google/cloud/language_v1/gapic/language_service_client_config.py b/language/google/cloud/language_v1/gapic/language_service_client_config.py
new file mode 100644
index 000000000000..061d053ec58d
--- /dev/null
+++ b/language/google/cloud/language_v1/gapic/language_service_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.language.v1.LanguageService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnalyzeSentiment": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnalyzeEntities": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnalyzeEntitySentiment": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnalyzeSyntax": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ClassifyText": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnnotateText": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/language/google/cloud/language_v1/gapic/transports/__init__.py b/language/google/cloud/language_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/google/cloud/language_v1/gapic/transports/language_service_grpc_transport.py b/language/google/cloud/language_v1/gapic/transports/language_service_grpc_transport.py
new file mode 100644
index 000000000000..b8a13472c0c2
--- /dev/null
+++ b/language/google/cloud/language_v1/gapic/transports/language_service_grpc_transport.py
@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.language_v1.proto import language_service_pb2_grpc
+
+
+class LanguageServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.language.v1 LanguageService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-language",
+        "https://www.googleapis.com/auth/cloud-platform",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="language.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "language_service_stub": language_service_pb2_grpc.LanguageServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="language.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def analyze_sentiment(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_sentiment`.
+
+        Analyzes the sentiment of the provided text.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeSentiment
+
+    @property
+    def analyze_entities(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_entities`.
+
+        Finds named entities (currently proper names and common nouns) in the text
+        along with entity types, salience, mentions for each entity, and
+        other properties.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeEntities
+
+    @property
+    def analyze_entity_sentiment(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_entity_sentiment`.
+
+        Finds entities, similar to ``AnalyzeEntities`` in the text and analyzes
+        sentiment associated with each entity and its mentions.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeEntitySentiment
+
+    @property
+    def analyze_syntax(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_syntax`.
+
+        Analyzes the syntax of the text and provides sentence boundaries and
+        tokenization along with part of speech tags, dependency trees, and other
+        properties.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeSyntax
+
+    @property
+    def classify_text(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.classify_text`.
+
+        Classifies a document into categories.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].ClassifyText
+
+    @property
+    def annotate_text(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.annotate_text`.
+
+        A convenience method that provides all the features that analyzeSentiment,
+        analyzeEntities, and analyzeSyntax provide in one call.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnnotateText
diff --git a/language/google/cloud/language_v1/proto/__init__.py b/language/google/cloud/language_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/google/cloud/language_v1/proto/language_service.proto b/language/google/cloud/language_v1/proto/language_service.proto
new file mode 100644
index 000000000000..41d92f344c7b
--- /dev/null
+++ b/language/google/cloud/language_v1/proto/language_service.proto
@@ -0,0 +1,1122 @@
+// 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.language.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/language/v1;language";
+option java_multiple_files = true;
+option java_outer_classname = "LanguageServiceProto";
+option java_package = "com.google.cloud.language.v1";
+
+
+// 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) {
+    option (google.api.http) = {
+      post: "/v1/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) {
+    option (google.api.http) = {
+      post: "/v1/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.v1.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: "/v1/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
+  // properties.
+  rpc AnalyzeSyntax(AnalyzeSyntaxRequest) returns (AnalyzeSyntaxResponse) {
+    option (google.api.http) = {
+      post: "/v1/documents:analyzeSyntax"
+      body: "*"
+    };
+    option (google.api.method_signature) = "document,encoding_type";
+    option (google.api.method_signature) = "document";
+  }
+
+  // Classifies a document into categories.
+  rpc ClassifyText(ClassifyTextRequest) returns (ClassifyTextResponse) {
+    option (google.api.http) = {
+      post: "/v1/documents:classifyText"
+      body: "*"
+    };
+    option (google.api.method_signature) = "document";
+  }
+
+  // A convenience method that provides all the features that analyzeSentiment,
+  // analyzeEntities, and analyzeSyntax provide in one call.
+  rpc AnnotateText(AnnotateTextRequest) returns (AnnotateTextResponse) {
+    option (google.api.http) = {
+      post: "/v1/documents:annotateText"
+      body: "*"
+    };
+    option (google.api.method_signature) = "document,features,encoding_type";
+    option (google.api.method_signature) = "document,features";
+  }
+}
+
+// ################################################################ #
+//
+// Represents the input to API methods.
+message Document {
+  // The document types enum.
+  enum Type {
+    // The content type is not specified.
+    TYPE_UNSPECIFIED = 0;
+
+    // Plain text
+    PLAIN_TEXT = 1;
+
+    // HTML
+    HTML = 2;
+  }
+
+  // Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+  // returns an `INVALID_ARGUMENT` error.
+  Type type = 1;
+
+  // The source of the document: a string containing the content or a
+  // 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.
+    // This URI must be of the form: gs://bucket_name/object_name. For more
+    // details, see https://cloud.google.com/storage/docs/reference-uris.
+    // NOTE: Cloud Storage object versioning is not supported.
+    string gcs_content_uri = 3;
+  }
+
+  // The language of the document (if not specified, the language is
+  // automatically detected). Both ISO and BCP-47 language codes are
+  // accepted.<br>
+  // [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.
+  string language = 4;
+}
+
+// Represents a sentence in the input document.
+message Sentence {
+  // The sentence text.
+  TextSpan text = 1;
+
+  // For calls to [AnalyzeSentiment][] or if
+  // [AnnotateTextRequest.Features.extract_document_sentiment][google.cloud.language.v1.AnnotateTextRequest.Features.extract_document_sentiment] is set to
+  // true, this field will contain the sentiment for the sentence.
+  Sentiment sentiment = 2;
+}
+
+// Represents a phrase in the text that is a known entity, such as
+// a person, an organization, or location. The API associates information, such
+// as salience and mentions, with entities.
+message 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;
+
+    // Person
+    PERSON = 1;
+
+    // Location
+    LOCATION = 2;
+
+    // Organization
+    ORGANIZATION = 3;
+
+    // Event
+    EVENT = 4;
+
+    // Artwork
+    WORK_OF_ART = 5;
+
+    // Consumer product
+    CONSUMER_GOOD = 6;
+
+    // Other types of entities
+    OTHER = 7;
+
+    // Phone number<br><br>
+    // The metadata lists the phone number, formatted according to local
+    // convention, plus whichever additional elements appear in the text:<ul>
+    // <li><code>number</code> &ndash; the actual number, broken down into
+    // sections as per local convention</li> <li><code>national_prefix</code>
+    // &ndash; country code, if detected</li> <li><code>area_code</code> &ndash;
+    // region or area code, if detected</li> <li><code>extension</code> &ndash;
+    // phone extension (to be dialed after connection), if detected</li></ul>
+    PHONE_NUMBER = 9;
+
+    // Address<br><br>
+    // The metadata identifies the street number and locality plus whichever
+    // additional elements appear in the text:<ul>
+    // <li><code>street_number</code> &ndash; street number</li>
+    // <li><code>locality</code> &ndash; city or town</li>
+    // <li><code>street_name</code> &ndash; street/route name, if detected</li>
+    // <li><code>postal_code</code> &ndash; postal code, if detected</li>
+    // <li><code>country</code> &ndash; country, if detected</li>
+    // <li><code>broad_region</code> &ndash; administrative area, such as the
+    // state, if detected</li> <li><code>narrow_region</code> &ndash; smaller
+    // administrative area, such as county, if detected</li>
+    // <li><code>sublocality</code> &ndash; used in Asian addresses to demark a
+    // district within a city, if detected</li></ul>
+    ADDRESS = 10;
+
+    // Date<br><br>
+    // The metadata identifies the components of the date:<ul>
+    // <li><code>year</code> &ndash; four digit year, if detected</li>
+    // <li><code>month</code> &ndash; two digit month number, if detected</li>
+    // <li><code>day</code> &ndash; two digit day number, if detected</li></ul>
+    DATE = 11;
+
+    // Number<br><br>
+    // The metadata is the number itself.
+    NUMBER = 12;
+
+    // Price<br><br>
+    // The metadata identifies the <code>value</code> and <code>currency</code>.
+    PRICE = 13;
+  }
+
+  // The representative name for the entity.
+  string name = 1;
+
+  // The entity type.
+  Type type = 2;
+
+  // Metadata associated with the entity.
+  //
+  // 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<string, string> metadata = 3;
+
+  // The salience score associated with the entity in the [0, 1.0] range.
+  //
+  // The salience score for an entity provides information about the
+  // importance or centrality of that entity to the entire document text.
+  // Scores closer to 0 are less salient, while scores closer to 1.0 are highly
+  // salient.
+  float salience = 4;
+
+  // The mentions of this entity in the input document. The API currently
+  // supports proper noun mentions.
+  repeated EntityMention mentions = 5;
+
+  // For calls to [AnalyzeEntitySentiment][] or if
+  // [AnnotateTextRequest.Features.extract_entity_sentiment][google.cloud.language.v1.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;
+}
+
+// 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 smallest syntactic building block of the text.
+message Token {
+  // The token text.
+  TextSpan text = 1;
+
+  // Parts of speech tag for this token.
+  PartOfSpeech part_of_speech = 2;
+
+  // Dependency tree parse for this token.
+  DependencyEdge dependency_edge = 3;
+
+  // [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+  string lemma = 4;
+}
+
+// Represents the feeling associated with the entire text or entities in
+// the text.
+message Sentiment {
+  // A non-negative number in the [0, +inf) range, which represents
+  // the absolute magnitude of sentiment regardless of score (positive or
+  // negative).
+  float magnitude = 2;
+
+  // Sentiment score between -1.0 (negative sentiment) and 1.0
+  // (positive sentiment).
+  float score = 3;
+}
+
+// Represents part of speech information for a token. Parts of speech
+// are as defined in
+// http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+message PartOfSpeech {
+  // The part of speech tags enum.
+  enum Tag {
+    // Unknown
+    UNKNOWN = 0;
+
+    // Adjective
+    ADJ = 1;
+
+    // Adposition (preposition and postposition)
+    ADP = 2;
+
+    // Adverb
+    ADV = 3;
+
+    // Conjunction
+    CONJ = 4;
+
+    // Determiner
+    DET = 5;
+
+    // Noun (common and proper)
+    NOUN = 6;
+
+    // Cardinal number
+    NUM = 7;
+
+    // Pronoun
+    PRON = 8;
+
+    // Particle or other function word
+    PRT = 9;
+
+    // Punctuation
+    PUNCT = 10;
+
+    // Verb (all tenses and modes)
+    VERB = 11;
+
+    // Other: foreign words, typos, abbreviations
+    X = 12;
+
+    // Affix
+    AFFIX = 13;
+  }
+
+  // The characteristic of a verb that expresses time flow during an event.
+  enum Aspect {
+    // Aspect is not applicable in the analyzed language or is not predicted.
+    ASPECT_UNKNOWN = 0;
+
+    // Perfective
+    PERFECTIVE = 1;
+
+    // Imperfective
+    IMPERFECTIVE = 2;
+
+    // Progressive
+    PROGRESSIVE = 3;
+  }
+
+  // The grammatical function performed by a noun or pronoun in a phrase,
+  // clause, or sentence. In some languages, other parts of speech, such as
+  // adjective and determiner, take case inflection in agreement with the noun.
+  enum Case {
+    // Case is not applicable in the analyzed language or is not predicted.
+    CASE_UNKNOWN = 0;
+
+    // Accusative
+    ACCUSATIVE = 1;
+
+    // Adverbial
+    ADVERBIAL = 2;
+
+    // Complementive
+    COMPLEMENTIVE = 3;
+
+    // Dative
+    DATIVE = 4;
+
+    // Genitive
+    GENITIVE = 5;
+
+    // Instrumental
+    INSTRUMENTAL = 6;
+
+    // Locative
+    LOCATIVE = 7;
+
+    // Nominative
+    NOMINATIVE = 8;
+
+    // Oblique
+    OBLIQUE = 9;
+
+    // Partitive
+    PARTITIVE = 10;
+
+    // Prepositional
+    PREPOSITIONAL = 11;
+
+    // Reflexive
+    REFLEXIVE_CASE = 12;
+
+    // Relative
+    RELATIVE_CASE = 13;
+
+    // Vocative
+    VOCATIVE = 14;
+  }
+
+  // Depending on the language, Form can be categorizing different forms of
+  // verbs, adjectives, adverbs, etc. For example, categorizing inflected
+  // endings of verbs and adjectives or distinguishing between short and long
+  // forms of adjectives and participles
+  enum Form {
+    // Form is not applicable in the analyzed language or is not predicted.
+    FORM_UNKNOWN = 0;
+
+    // Adnomial
+    ADNOMIAL = 1;
+
+    // Auxiliary
+    AUXILIARY = 2;
+
+    // Complementizer
+    COMPLEMENTIZER = 3;
+
+    // Final ending
+    FINAL_ENDING = 4;
+
+    // Gerund
+    GERUND = 5;
+
+    // Realis
+    REALIS = 6;
+
+    // Irrealis
+    IRREALIS = 7;
+
+    // Short form
+    SHORT = 8;
+
+    // Long form
+    LONG = 9;
+
+    // Order form
+    ORDER = 10;
+
+    // Specific form
+    SPECIFIC = 11;
+  }
+
+  // Gender classes of nouns reflected in the behaviour of associated words.
+  enum Gender {
+    // Gender is not applicable in the analyzed language or is not predicted.
+    GENDER_UNKNOWN = 0;
+
+    // Feminine
+    FEMININE = 1;
+
+    // Masculine
+    MASCULINE = 2;
+
+    // Neuter
+    NEUTER = 3;
+  }
+
+  // The grammatical feature of verbs, used for showing modality and attitude.
+  enum Mood {
+    // Mood is not applicable in the analyzed language or is not predicted.
+    MOOD_UNKNOWN = 0;
+
+    // Conditional
+    CONDITIONAL_MOOD = 1;
+
+    // Imperative
+    IMPERATIVE = 2;
+
+    // Indicative
+    INDICATIVE = 3;
+
+    // Interrogative
+    INTERROGATIVE = 4;
+
+    // Jussive
+    JUSSIVE = 5;
+
+    // Subjunctive
+    SUBJUNCTIVE = 6;
+  }
+
+  // Count distinctions.
+  enum Number {
+    // Number is not applicable in the analyzed language or is not predicted.
+    NUMBER_UNKNOWN = 0;
+
+    // Singular
+    SINGULAR = 1;
+
+    // Plural
+    PLURAL = 2;
+
+    // Dual
+    DUAL = 3;
+  }
+
+  // The distinction between the speaker, second person, third person, etc.
+  enum Person {
+    // Person is not applicable in the analyzed language or is not predicted.
+    PERSON_UNKNOWN = 0;
+
+    // First
+    FIRST = 1;
+
+    // Second
+    SECOND = 2;
+
+    // Third
+    THIRD = 3;
+
+    // Reflexive
+    REFLEXIVE_PERSON = 4;
+  }
+
+  // This category shows if the token is part of a proper name.
+  enum Proper {
+    // Proper is not applicable in the analyzed language or is not predicted.
+    PROPER_UNKNOWN = 0;
+
+    // Proper
+    PROPER = 1;
+
+    // Not proper
+    NOT_PROPER = 2;
+  }
+
+  // Reciprocal features of a pronoun.
+  enum Reciprocity {
+    // Reciprocity is not applicable in the analyzed language or is not
+    // predicted.
+    RECIPROCITY_UNKNOWN = 0;
+
+    // Reciprocal
+    RECIPROCAL = 1;
+
+    // Non-reciprocal
+    NON_RECIPROCAL = 2;
+  }
+
+  // Time reference.
+  enum Tense {
+    // Tense is not applicable in the analyzed language or is not predicted.
+    TENSE_UNKNOWN = 0;
+
+    // Conditional
+    CONDITIONAL_TENSE = 1;
+
+    // Future
+    FUTURE = 2;
+
+    // Past
+    PAST = 3;
+
+    // Present
+    PRESENT = 4;
+
+    // Imperfect
+    IMPERFECT = 5;
+
+    // Pluperfect
+    PLUPERFECT = 6;
+  }
+
+  // The relationship between the action that a verb expresses and the
+  // participants identified by its arguments.
+  enum Voice {
+    // Voice is not applicable in the analyzed language or is not predicted.
+    VOICE_UNKNOWN = 0;
+
+    // Active
+    ACTIVE = 1;
+
+    // Causative
+    CAUSATIVE = 2;
+
+    // Passive
+    PASSIVE = 3;
+  }
+
+  // The part of speech tag.
+  Tag tag = 1;
+
+  // The grammatical aspect.
+  Aspect aspect = 2;
+
+  // The grammatical case.
+  Case case = 3;
+
+  // The grammatical form.
+  Form form = 4;
+
+  // The grammatical gender.
+  Gender gender = 5;
+
+  // The grammatical mood.
+  Mood mood = 6;
+
+  // The grammatical number.
+  Number number = 7;
+
+  // The grammatical person.
+  Person person = 8;
+
+  // The grammatical properness.
+  Proper proper = 9;
+
+  // The grammatical reciprocity.
+  Reciprocity reciprocity = 10;
+
+  // The grammatical tense.
+  Tense tense = 11;
+
+  // The grammatical voice.
+  Voice voice = 12;
+}
+
+// Represents dependency parse tree information for a token. (For more
+// information on dependency labels, see
+// http://www.aclweb.org/anthology/P13-2017
+message DependencyEdge {
+  // The parse label enum for the token.
+  enum Label {
+    // Unknown
+    UNKNOWN = 0;
+
+    // Abbreviation modifier
+    ABBREV = 1;
+
+    // Adjectival complement
+    ACOMP = 2;
+
+    // Adverbial clause modifier
+    ADVCL = 3;
+
+    // Adverbial modifier
+    ADVMOD = 4;
+
+    // Adjectival modifier of an NP
+    AMOD = 5;
+
+    // Appositional modifier of an NP
+    APPOS = 6;
+
+    // Attribute dependent of a copular verb
+    ATTR = 7;
+
+    // Auxiliary (non-main) verb
+    AUX = 8;
+
+    // Passive auxiliary
+    AUXPASS = 9;
+
+    // Coordinating conjunction
+    CC = 10;
+
+    // Clausal complement of a verb or adjective
+    CCOMP = 11;
+
+    // Conjunct
+    CONJ = 12;
+
+    // Clausal subject
+    CSUBJ = 13;
+
+    // Clausal passive subject
+    CSUBJPASS = 14;
+
+    // Dependency (unable to determine)
+    DEP = 15;
+
+    // Determiner
+    DET = 16;
+
+    // Discourse
+    DISCOURSE = 17;
+
+    // Direct object
+    DOBJ = 18;
+
+    // Expletive
+    EXPL = 19;
+
+    // Goes with (part of a word in a text not well edited)
+    GOESWITH = 20;
+
+    // Indirect object
+    IOBJ = 21;
+
+    // Marker (word introducing a subordinate clause)
+    MARK = 22;
+
+    // Multi-word expression
+    MWE = 23;
+
+    // Multi-word verbal expression
+    MWV = 24;
+
+    // Negation modifier
+    NEG = 25;
+
+    // Noun compound modifier
+    NN = 26;
+
+    // Noun phrase used as an adverbial modifier
+    NPADVMOD = 27;
+
+    // Nominal subject
+    NSUBJ = 28;
+
+    // Passive nominal subject
+    NSUBJPASS = 29;
+
+    // Numeric modifier of a noun
+    NUM = 30;
+
+    // Element of compound number
+    NUMBER = 31;
+
+    // Punctuation mark
+    P = 32;
+
+    // Parataxis relation
+    PARATAXIS = 33;
+
+    // Participial modifier
+    PARTMOD = 34;
+
+    // The complement of a preposition is a clause
+    PCOMP = 35;
+
+    // Object of a preposition
+    POBJ = 36;
+
+    // Possession modifier
+    POSS = 37;
+
+    // Postverbal negative particle
+    POSTNEG = 38;
+
+    // Predicate complement
+    PRECOMP = 39;
+
+    // Preconjunt
+    PRECONJ = 40;
+
+    // Predeterminer
+    PREDET = 41;
+
+    // Prefix
+    PREF = 42;
+
+    // Prepositional modifier
+    PREP = 43;
+
+    // The relationship between a verb and verbal morpheme
+    PRONL = 44;
+
+    // Particle
+    PRT = 45;
+
+    // Associative or possessive marker
+    PS = 46;
+
+    // Quantifier phrase modifier
+    QUANTMOD = 47;
+
+    // Relative clause modifier
+    RCMOD = 48;
+
+    // Complementizer in relative clause
+    RCMODREL = 49;
+
+    // Ellipsis without a preceding predicate
+    RDROP = 50;
+
+    // Referent
+    REF = 51;
+
+    // Remnant
+    REMNANT = 52;
+
+    // Reparandum
+    REPARANDUM = 53;
+
+    // Root
+    ROOT = 54;
+
+    // Suffix specifying a unit of number
+    SNUM = 55;
+
+    // Suffix
+    SUFF = 56;
+
+    // Temporal modifier
+    TMOD = 57;
+
+    // Topic marker
+    TOPIC = 58;
+
+    // Clause headed by an infinite form of the verb that modifies a noun
+    VMOD = 59;
+
+    // Vocative
+    VOCATIVE = 60;
+
+    // Open clausal complement
+    XCOMP = 61;
+
+    // Name suffix
+    SUFFIX = 62;
+
+    // Name title
+    TITLE = 63;
+
+    // Adverbial phrase modifier
+    ADVPHMOD = 64;
+
+    // Causative auxiliary
+    AUXCAUS = 65;
+
+    // Helper auxiliary
+    AUXVV = 66;
+
+    // Rentaishi (Prenominal modifier)
+    DTMOD = 67;
+
+    // Foreign words
+    FOREIGN = 68;
+
+    // Keyword
+    KW = 69;
+
+    // List for chains of comparable items
+    LIST = 70;
+
+    // Nominalized clause
+    NOMC = 71;
+
+    // Nominalized clausal subject
+    NOMCSUBJ = 72;
+
+    // Nominalized clausal passive
+    NOMCSUBJPASS = 73;
+
+    // Compound of numeric modifier
+    NUMC = 74;
+
+    // Copula
+    COP = 75;
+
+    // Dislocated relation (for fronted/topicalized elements)
+    DISLOCATED = 76;
+
+    // Aspect marker
+    ASP = 77;
+
+    // Genitive modifier
+    GMOD = 78;
+
+    // Genitive object
+    GOBJ = 79;
+
+    // Infinitival modifier
+    INFMOD = 80;
+
+    // Measure
+    MES = 81;
+
+    // Nominal complement of a noun
+    NCOMP = 82;
+  }
+
+  // Represents the head of this token in the dependency tree.
+  // This is the index of the token which has an arc going to this token.
+  // The index is the position of the token in the array of tokens returned
+  // by the API method. If this token is a root token, then the
+  // `head_token_index` is its own index.
+  int32 head_token_index = 1;
+
+  // The parse label for the token.
+  Label label = 2;
+}
+
+// Represents a mention for an entity in the text. Currently, proper noun
+// mentions are supported.
+message EntityMention {
+  // The supported types of mentions.
+  enum Type {
+    // Unknown
+    TYPE_UNKNOWN = 0;
+
+    // Proper name
+    PROPER = 1;
+
+    // Common noun (or noun compound)
+    COMMON = 2;
+  }
+
+  // The mention text.
+  TextSpan text = 1;
+
+  // The type of the entity mention.
+  Type type = 2;
+
+  // For calls to [AnalyzeEntitySentiment][] or if
+  // [AnnotateTextRequest.Features.extract_entity_sentiment][google.cloud.language.v1.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;
+}
+
+// Represents an output piece of text.
+message TextSpan {
+  // The content of the output text.
+  string content = 1;
+
+  // The API calculates the beginning offset of the content in the original
+  // document according to the [EncodingType][google.cloud.language.v1.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, from the [predefined
+  // taxonomy](/natural-language/docs/categories).
+  string name = 1;
+
+  // The classifier's confidence of the category. Number represents how certain
+  // the classifier is that this category represents the given text.
+  float confidence = 2;
+}
+
+// The sentiment analysis request message.
+message AnalyzeSentimentRequest {
+  // Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The encoding type used by the API to calculate sentence offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The sentiment analysis response message.
+message AnalyzeSentimentResponse {
+  // The overall sentiment of the input document.
+  Sentiment document_sentiment = 1;
+
+  // 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.v1.Document.language] field for more details.
+  string language = 2;
+
+  // The sentiment for all the sentences in the document.
+  repeated Sentence sentences = 3;
+}
+
+// The entity-level sentiment analysis request message.
+message AnalyzeEntitySentimentRequest {
+  // Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The entity-level sentiment analysis response message.
+message AnalyzeEntitySentimentResponse {
+  // The recognized entities in the input document with associated sentiments.
+  repeated Entity entities = 1;
+
+  // 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.v1.Document.language] field for more details.
+  string language = 2;
+}
+
+// The entity analysis request message.
+message AnalyzeEntitiesRequest {
+  // Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The entity analysis response message.
+message AnalyzeEntitiesResponse {
+  // The recognized entities in the input document.
+  repeated Entity entities = 1;
+
+  // 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.v1.Document.language] field for more details.
+  string language = 2;
+}
+
+// The syntax analysis request message.
+message AnalyzeSyntaxRequest {
+  // Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The syntax analysis response message.
+message AnalyzeSyntaxResponse {
+  // Sentences in the input document.
+  repeated Sentence sentences = 1;
+
+  // Tokens, along with their syntactic information, in the input document.
+  repeated Token tokens = 2;
+
+  // 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.v1.Document.language] field for more details.
+  string language = 3;
+}
+
+// The document classification request message.
+message ClassifyTextRequest {
+  // Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The document classification response message.
+message ClassifyTextResponse {
+  // Categories representing the input document.
+  repeated ClassificationCategory categories = 1;
+}
+
+// The request message for the text annotation API, which can perform multiple
+// analysis types (sentiment, entities, and syntax) in one call.
+message AnnotateTextRequest {
+  // All available features for sentiment, syntax, and semantic analysis.
+  // Setting each one to true will enable that specific analysis for the input.
+  message Features {
+    // Extract syntax information.
+    bool extract_syntax = 1;
+
+    // Extract entities.
+    bool extract_entities = 2;
+
+    // Extract document-level sentiment.
+    bool extract_document_sentiment = 3;
+
+    // Extract entities and their associated sentiment.
+    bool extract_entity_sentiment = 4;
+
+    // Classify the full document into categories.
+    bool classify_text = 6;
+  }
+
+  // Input document.
+  Document document = 1 [(google.api.field_behavior) = 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;
+}
+
+// The text annotations response message.
+message AnnotateTextResponse {
+  // Sentences in the input document. Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_syntax][google.cloud.language.v1.AnnotateTextRequest.Features.extract_syntax].
+  repeated Sentence sentences = 1;
+
+  // Tokens, along with their syntactic information, in the input document.
+  // Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_syntax][google.cloud.language.v1.AnnotateTextRequest.Features.extract_syntax].
+  repeated Token tokens = 2;
+
+  // Entities, along with their semantic information, in the input document.
+  // Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_entities][google.cloud.language.v1.AnnotateTextRequest.Features.extract_entities].
+  repeated Entity entities = 3;
+
+  // The overall sentiment for the document. Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_document_sentiment][google.cloud.language.v1.AnnotateTextRequest.Features.extract_document_sentiment].
+  Sentiment document_sentiment = 4;
+
+  // 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.v1.Document.language] field for more details.
+  string language = 5;
+
+  // Categories identified in the input document.
+  repeated ClassificationCategory categories = 6;
+}
diff --git a/language/google/cloud/language_v1/proto/language_service_pb2.py b/language/google/cloud/language_v1/proto/language_service_pb2.py
new file mode 100644
index 000000000000..b292a65ee5f0
--- /dev/null
+++ b/language/google/cloud/language_v1/proto/language_service_pb2.py
@@ -0,0 +1,3578 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/language_v1/proto/language_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/language_v1/proto/language_service.proto",
+    package="google.cloud.language.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\034com.google.cloud.language.v1B\024LanguageServiceProtoP\001Z@google.golang.org/genproto/googleapis/cloud/language/v1;language"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/language_v1/proto/language_service.proto\x12\x18google.cloud.language.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto"\xc3\x01\n\x08\x44ocument\x12\x35\n\x04type\x18\x01 \x01(\x0e\x32\'.google.cloud.language.v1.Document.Type\x12\x11\n\x07\x63ontent\x18\x02 \x01(\tH\x00\x12\x19\n\x0fgcs_content_uri\x18\x03 \x01(\tH\x00\x12\x10\n\x08language\x18\x04 \x01(\t"6\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nPLAIN_TEXT\x10\x01\x12\x08\n\x04HTML\x10\x02\x42\x08\n\x06source"t\n\x08Sentence\x12\x30\n\x04text\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.TextSpan\x12\x36\n\tsentiment\x18\x02 \x01(\x0b\x32#.google.cloud.language.v1.Sentiment"\xff\x03\n\x06\x45ntity\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x33\n\x04type\x18\x02 \x01(\x0e\x32%.google.cloud.language.v1.Entity.Type\x12@\n\x08metadata\x18\x03 \x03(\x0b\x32..google.cloud.language.v1.Entity.MetadataEntry\x12\x10\n\x08salience\x18\x04 \x01(\x02\x12\x39\n\x08mentions\x18\x05 \x03(\x0b\x32\'.google.cloud.language.v1.EntityMention\x12\x36\n\tsentiment\x18\x06 \x01(\x0b\x32#.google.cloud.language.v1.Sentiment\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xb9\x01\n\x04Type\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06PERSON\x10\x01\x12\x0c\n\x08LOCATION\x10\x02\x12\x10\n\x0cORGANIZATION\x10\x03\x12\t\n\x05\x45VENT\x10\x04\x12\x0f\n\x0bWORK_OF_ART\x10\x05\x12\x11\n\rCONSUMER_GOOD\x10\x06\x12\t\n\x05OTHER\x10\x07\x12\x10\n\x0cPHONE_NUMBER\x10\t\x12\x0b\n\x07\x41\x44\x44RESS\x10\n\x12\x08\n\x04\x44\x41TE\x10\x0b\x12\n\n\x06NUMBER\x10\x0c\x12\t\n\x05PRICE\x10\r"\xcb\x01\n\x05Token\x12\x30\n\x04text\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.TextSpan\x12>\n\x0epart_of_speech\x18\x02 \x01(\x0b\x32&.google.cloud.language.v1.PartOfSpeech\x12\x41\n\x0f\x64\x65pendency_edge\x18\x03 \x01(\x0b\x32(.google.cloud.language.v1.DependencyEdge\x12\r\n\x05lemma\x18\x04 \x01(\t"-\n\tSentiment\x12\x11\n\tmagnitude\x18\x02 \x01(\x02\x12\r\n\x05score\x18\x03 \x01(\x02"\xa3\x10\n\x0cPartOfSpeech\x12\x37\n\x03tag\x18\x01 \x01(\x0e\x32*.google.cloud.language.v1.PartOfSpeech.Tag\x12=\n\x06\x61spect\x18\x02 \x01(\x0e\x32-.google.cloud.language.v1.PartOfSpeech.Aspect\x12\x39\n\x04\x63\x61se\x18\x03 \x01(\x0e\x32+.google.cloud.language.v1.PartOfSpeech.Case\x12\x39\n\x04\x66orm\x18\x04 \x01(\x0e\x32+.google.cloud.language.v1.PartOfSpeech.Form\x12=\n\x06gender\x18\x05 \x01(\x0e\x32-.google.cloud.language.v1.PartOfSpeech.Gender\x12\x39\n\x04mood\x18\x06 \x01(\x0e\x32+.google.cloud.language.v1.PartOfSpeech.Mood\x12=\n\x06number\x18\x07 \x01(\x0e\x32-.google.cloud.language.v1.PartOfSpeech.Number\x12=\n\x06person\x18\x08 \x01(\x0e\x32-.google.cloud.language.v1.PartOfSpeech.Person\x12=\n\x06proper\x18\t \x01(\x0e\x32-.google.cloud.language.v1.PartOfSpeech.Proper\x12G\n\x0breciprocity\x18\n \x01(\x0e\x32\x32.google.cloud.language.v1.PartOfSpeech.Reciprocity\x12;\n\x05tense\x18\x0b \x01(\x0e\x32,.google.cloud.language.v1.PartOfSpeech.Tense\x12;\n\x05voice\x18\x0c \x01(\x0e\x32,.google.cloud.language.v1.PartOfSpeech.Voice"\x8d\x01\n\x03Tag\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x07\n\x03\x41\x44J\x10\x01\x12\x07\n\x03\x41\x44P\x10\x02\x12\x07\n\x03\x41\x44V\x10\x03\x12\x08\n\x04\x43ONJ\x10\x04\x12\x07\n\x03\x44\x45T\x10\x05\x12\x08\n\x04NOUN\x10\x06\x12\x07\n\x03NUM\x10\x07\x12\x08\n\x04PRON\x10\x08\x12\x07\n\x03PRT\x10\t\x12\t\n\x05PUNCT\x10\n\x12\x08\n\x04VERB\x10\x0b\x12\x05\n\x01X\x10\x0c\x12\t\n\x05\x41\x46\x46IX\x10\r"O\n\x06\x41spect\x12\x12\n\x0e\x41SPECT_UNKNOWN\x10\x00\x12\x0e\n\nPERFECTIVE\x10\x01\x12\x10\n\x0cIMPERFECTIVE\x10\x02\x12\x0f\n\x0bPROGRESSIVE\x10\x03"\xf8\x01\n\x04\x43\x61se\x12\x10\n\x0c\x43\x41SE_UNKNOWN\x10\x00\x12\x0e\n\nACCUSATIVE\x10\x01\x12\r\n\tADVERBIAL\x10\x02\x12\x11\n\rCOMPLEMENTIVE\x10\x03\x12\n\n\x06\x44\x41TIVE\x10\x04\x12\x0c\n\x08GENITIVE\x10\x05\x12\x10\n\x0cINSTRUMENTAL\x10\x06\x12\x0c\n\x08LOCATIVE\x10\x07\x12\x0e\n\nNOMINATIVE\x10\x08\x12\x0b\n\x07OBLIQUE\x10\t\x12\r\n\tPARTITIVE\x10\n\x12\x11\n\rPREPOSITIONAL\x10\x0b\x12\x12\n\x0eREFLEXIVE_CASE\x10\x0c\x12\x11\n\rRELATIVE_CASE\x10\r\x12\x0c\n\x08VOCATIVE\x10\x0e"\xaf\x01\n\x04\x46orm\x12\x10\n\x0c\x46ORM_UNKNOWN\x10\x00\x12\x0c\n\x08\x41\x44NOMIAL\x10\x01\x12\r\n\tAUXILIARY\x10\x02\x12\x12\n\x0e\x43OMPLEMENTIZER\x10\x03\x12\x10\n\x0c\x46INAL_ENDING\x10\x04\x12\n\n\x06GERUND\x10\x05\x12\n\n\x06REALIS\x10\x06\x12\x0c\n\x08IRREALIS\x10\x07\x12\t\n\x05SHORT\x10\x08\x12\x08\n\x04LONG\x10\t\x12\t\n\x05ORDER\x10\n\x12\x0c\n\x08SPECIFIC\x10\x0b"E\n\x06Gender\x12\x12\n\x0eGENDER_UNKNOWN\x10\x00\x12\x0c\n\x08\x46\x45MININE\x10\x01\x12\r\n\tMASCULINE\x10\x02\x12\n\n\x06NEUTER\x10\x03"\x7f\n\x04Mood\x12\x10\n\x0cMOOD_UNKNOWN\x10\x00\x12\x14\n\x10\x43ONDITIONAL_MOOD\x10\x01\x12\x0e\n\nIMPERATIVE\x10\x02\x12\x0e\n\nINDICATIVE\x10\x03\x12\x11\n\rINTERROGATIVE\x10\x04\x12\x0b\n\x07JUSSIVE\x10\x05\x12\x0f\n\x0bSUBJUNCTIVE\x10\x06"@\n\x06Number\x12\x12\n\x0eNUMBER_UNKNOWN\x10\x00\x12\x0c\n\x08SINGULAR\x10\x01\x12\n\n\x06PLURAL\x10\x02\x12\x08\n\x04\x44UAL\x10\x03"T\n\x06Person\x12\x12\n\x0ePERSON_UNKNOWN\x10\x00\x12\t\n\x05\x46IRST\x10\x01\x12\n\n\x06SECOND\x10\x02\x12\t\n\x05THIRD\x10\x03\x12\x14\n\x10REFLEXIVE_PERSON\x10\x04"8\n\x06Proper\x12\x12\n\x0ePROPER_UNKNOWN\x10\x00\x12\n\n\x06PROPER\x10\x01\x12\x0e\n\nNOT_PROPER\x10\x02"J\n\x0bReciprocity\x12\x17\n\x13RECIPROCITY_UNKNOWN\x10\x00\x12\x0e\n\nRECIPROCAL\x10\x01\x12\x12\n\x0eNON_RECIPROCAL\x10\x02"s\n\x05Tense\x12\x11\n\rTENSE_UNKNOWN\x10\x00\x12\x15\n\x11\x43ONDITIONAL_TENSE\x10\x01\x12\n\n\x06\x46UTURE\x10\x02\x12\x08\n\x04PAST\x10\x03\x12\x0b\n\x07PRESENT\x10\x04\x12\r\n\tIMPERFECT\x10\x05\x12\x0e\n\nPLUPERFECT\x10\x06"B\n\x05Voice\x12\x11\n\rVOICE_UNKNOWN\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\r\n\tCAUSATIVE\x10\x02\x12\x0b\n\x07PASSIVE\x10\x03"\x95\x08\n\x0e\x44\x65pendencyEdge\x12\x18\n\x10head_token_index\x18\x01 \x01(\x05\x12=\n\x05label\x18\x02 \x01(\x0e\x32..google.cloud.language.v1.DependencyEdge.Label"\xa9\x07\n\x05Label\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06\x41\x42\x42REV\x10\x01\x12\t\n\x05\x41\x43OMP\x10\x02\x12\t\n\x05\x41\x44VCL\x10\x03\x12\n\n\x06\x41\x44VMOD\x10\x04\x12\x08\n\x04\x41MOD\x10\x05\x12\t\n\x05\x41PPOS\x10\x06\x12\x08\n\x04\x41TTR\x10\x07\x12\x07\n\x03\x41UX\x10\x08\x12\x0b\n\x07\x41UXPASS\x10\t\x12\x06\n\x02\x43\x43\x10\n\x12\t\n\x05\x43\x43OMP\x10\x0b\x12\x08\n\x04\x43ONJ\x10\x0c\x12\t\n\x05\x43SUBJ\x10\r\x12\r\n\tCSUBJPASS\x10\x0e\x12\x07\n\x03\x44\x45P\x10\x0f\x12\x07\n\x03\x44\x45T\x10\x10\x12\r\n\tDISCOURSE\x10\x11\x12\x08\n\x04\x44OBJ\x10\x12\x12\x08\n\x04\x45XPL\x10\x13\x12\x0c\n\x08GOESWITH\x10\x14\x12\x08\n\x04IOBJ\x10\x15\x12\x08\n\x04MARK\x10\x16\x12\x07\n\x03MWE\x10\x17\x12\x07\n\x03MWV\x10\x18\x12\x07\n\x03NEG\x10\x19\x12\x06\n\x02NN\x10\x1a\x12\x0c\n\x08NPADVMOD\x10\x1b\x12\t\n\x05NSUBJ\x10\x1c\x12\r\n\tNSUBJPASS\x10\x1d\x12\x07\n\x03NUM\x10\x1e\x12\n\n\x06NUMBER\x10\x1f\x12\x05\n\x01P\x10 \x12\r\n\tPARATAXIS\x10!\x12\x0b\n\x07PARTMOD\x10"\x12\t\n\x05PCOMP\x10#\x12\x08\n\x04POBJ\x10$\x12\x08\n\x04POSS\x10%\x12\x0b\n\x07POSTNEG\x10&\x12\x0b\n\x07PRECOMP\x10\'\x12\x0b\n\x07PRECONJ\x10(\x12\n\n\x06PREDET\x10)\x12\x08\n\x04PREF\x10*\x12\x08\n\x04PREP\x10+\x12\t\n\x05PRONL\x10,\x12\x07\n\x03PRT\x10-\x12\x06\n\x02PS\x10.\x12\x0c\n\x08QUANTMOD\x10/\x12\t\n\x05RCMOD\x10\x30\x12\x0c\n\x08RCMODREL\x10\x31\x12\t\n\x05RDROP\x10\x32\x12\x07\n\x03REF\x10\x33\x12\x0b\n\x07REMNANT\x10\x34\x12\x0e\n\nREPARANDUM\x10\x35\x12\x08\n\x04ROOT\x10\x36\x12\x08\n\x04SNUM\x10\x37\x12\x08\n\x04SUFF\x10\x38\x12\x08\n\x04TMOD\x10\x39\x12\t\n\x05TOPIC\x10:\x12\x08\n\x04VMOD\x10;\x12\x0c\n\x08VOCATIVE\x10<\x12\t\n\x05XCOMP\x10=\x12\n\n\x06SUFFIX\x10>\x12\t\n\x05TITLE\x10?\x12\x0c\n\x08\x41\x44VPHMOD\x10@\x12\x0b\n\x07\x41UXCAUS\x10\x41\x12\t\n\x05\x41UXVV\x10\x42\x12\t\n\x05\x44TMOD\x10\x43\x12\x0b\n\x07\x46OREIGN\x10\x44\x12\x06\n\x02KW\x10\x45\x12\x08\n\x04LIST\x10\x46\x12\x08\n\x04NOMC\x10G\x12\x0c\n\x08NOMCSUBJ\x10H\x12\x10\n\x0cNOMCSUBJPASS\x10I\x12\x08\n\x04NUMC\x10J\x12\x07\n\x03\x43OP\x10K\x12\x0e\n\nDISLOCATED\x10L\x12\x07\n\x03\x41SP\x10M\x12\x08\n\x04GMOD\x10N\x12\x08\n\x04GOBJ\x10O\x12\n\n\x06INFMOD\x10P\x12\x07\n\x03MES\x10Q\x12\t\n\x05NCOMP\x10R"\xe7\x01\n\rEntityMention\x12\x30\n\x04text\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.TextSpan\x12:\n\x04type\x18\x02 \x01(\x0e\x32,.google.cloud.language.v1.EntityMention.Type\x12\x36\n\tsentiment\x18\x03 \x01(\x0b\x32#.google.cloud.language.v1.Sentiment"0\n\x04Type\x12\x10\n\x0cTYPE_UNKNOWN\x10\x00\x12\n\n\x06PROPER\x10\x01\x12\n\n\x06\x43OMMON\x10\x02"1\n\x08TextSpan\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x14\n\x0c\x62\x65gin_offset\x18\x02 \x01(\x05":\n\x16\x43lassificationCategory\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02"\x93\x01\n\x17\x41nalyzeSentimentRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.DocumentB\x03\xe0\x41\x02\x12=\n\rencoding_type\x18\x02 \x01(\x0e\x32&.google.cloud.language.v1.EncodingType"\xa4\x01\n\x18\x41nalyzeSentimentResponse\x12?\n\x12\x64ocument_sentiment\x18\x01 \x01(\x0b\x32#.google.cloud.language.v1.Sentiment\x12\x10\n\x08language\x18\x02 \x01(\t\x12\x35\n\tsentences\x18\x03 \x03(\x0b\x32".google.cloud.language.v1.Sentence"\x99\x01\n\x1d\x41nalyzeEntitySentimentRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.DocumentB\x03\xe0\x41\x02\x12=\n\rencoding_type\x18\x02 \x01(\x0e\x32&.google.cloud.language.v1.EncodingType"f\n\x1e\x41nalyzeEntitySentimentResponse\x12\x32\n\x08\x65ntities\x18\x01 \x03(\x0b\x32 .google.cloud.language.v1.Entity\x12\x10\n\x08language\x18\x02 \x01(\t"\x92\x01\n\x16\x41nalyzeEntitiesRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.DocumentB\x03\xe0\x41\x02\x12=\n\rencoding_type\x18\x02 \x01(\x0e\x32&.google.cloud.language.v1.EncodingType"_\n\x17\x41nalyzeEntitiesResponse\x12\x32\n\x08\x65ntities\x18\x01 \x03(\x0b\x32 .google.cloud.language.v1.Entity\x12\x10\n\x08language\x18\x02 \x01(\t"\x90\x01\n\x14\x41nalyzeSyntaxRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.DocumentB\x03\xe0\x41\x02\x12=\n\rencoding_type\x18\x02 \x01(\x0e\x32&.google.cloud.language.v1.EncodingType"\x91\x01\n\x15\x41nalyzeSyntaxResponse\x12\x35\n\tsentences\x18\x01 \x03(\x0b\x32".google.cloud.language.v1.Sentence\x12/\n\x06tokens\x18\x02 \x03(\x0b\x32\x1f.google.cloud.language.v1.Token\x12\x10\n\x08language\x18\x03 \x01(\t"P\n\x13\x43lassifyTextRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.DocumentB\x03\xe0\x41\x02"\\\n\x14\x43lassifyTextResponse\x12\x44\n\ncategories\x18\x01 \x03(\x0b\x32\x30.google.cloud.language.v1.ClassificationCategory"\xfa\x02\n\x13\x41nnotateTextRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32".google.cloud.language.v1.DocumentB\x03\xe0\x41\x02\x12M\n\x08\x66\x65\x61tures\x18\x02 \x01(\x0b\x32\x36.google.cloud.language.v1.AnnotateTextRequest.FeaturesB\x03\xe0\x41\x02\x12=\n\rencoding_type\x18\x03 \x01(\x0e\x32&.google.cloud.language.v1.EncodingType\x1a\x99\x01\n\x08\x46\x65\x61tures\x12\x16\n\x0e\x65xtract_syntax\x18\x01 \x01(\x08\x12\x18\n\x10\x65xtract_entities\x18\x02 \x01(\x08\x12"\n\x1a\x65xtract_document_sentiment\x18\x03 \x01(\x08\x12 \n\x18\x65xtract_entity_sentiment\x18\x04 \x01(\x08\x12\x15\n\rclassify_text\x18\x06 \x01(\x08"\xcb\x02\n\x14\x41nnotateTextResponse\x12\x35\n\tsentences\x18\x01 \x03(\x0b\x32".google.cloud.language.v1.Sentence\x12/\n\x06tokens\x18\x02 \x03(\x0b\x32\x1f.google.cloud.language.v1.Token\x12\x32\n\x08\x65ntities\x18\x03 \x03(\x0b\x32 .google.cloud.language.v1.Entity\x12?\n\x12\x64ocument_sentiment\x18\x04 \x01(\x0b\x32#.google.cloud.language.v1.Sentiment\x12\x10\n\x08language\x18\x05 \x01(\t\x12\x44\n\ncategories\x18\x06 \x03(\x0b\x32\x30.google.cloud.language.v1.ClassificationCategory*8\n\x0c\x45ncodingType\x12\x08\n\x04NONE\x10\x00\x12\x08\n\x04UTF8\x10\x01\x12\t\n\x05UTF16\x10\x02\x12\t\n\x05UTF32\x10\x03\x32\xb0\n\n\x0fLanguageService\x12\xc8\x01\n\x10\x41nalyzeSentiment\x12\x31.google.cloud.language.v1.AnalyzeSentimentRequest\x1a\x32.google.cloud.language.v1.AnalyzeSentimentResponse"M\x82\xd3\xe4\x93\x02#"\x1e/v1/documents:analyzeSentiment:\x01*\xda\x41\x16\x64ocument,encoding_type\xda\x41\x08\x64ocument\x12\xc4\x01\n\x0f\x41nalyzeEntities\x12\x30.google.cloud.language.v1.AnalyzeEntitiesRequest\x1a\x31.google.cloud.language.v1.AnalyzeEntitiesResponse"L\x82\xd3\xe4\x93\x02""\x1d/v1/documents:analyzeEntities:\x01*\xda\x41\x16\x64ocument,encoding_type\xda\x41\x08\x64ocument\x12\xe0\x01\n\x16\x41nalyzeEntitySentiment\x12\x37.google.cloud.language.v1.AnalyzeEntitySentimentRequest\x1a\x38.google.cloud.language.v1.AnalyzeEntitySentimentResponse"S\x82\xd3\xe4\x93\x02)"$/v1/documents:analyzeEntitySentiment:\x01*\xda\x41\x16\x64ocument,encoding_type\xda\x41\x08\x64ocument\x12\xbc\x01\n\rAnalyzeSyntax\x12..google.cloud.language.v1.AnalyzeSyntaxRequest\x1a/.google.cloud.language.v1.AnalyzeSyntaxResponse"J\x82\xd3\xe4\x93\x02 "\x1b/v1/documents:analyzeSyntax:\x01*\xda\x41\x16\x64ocument,encoding_type\xda\x41\x08\x64ocument\x12\x9f\x01\n\x0c\x43lassifyText\x12-.google.cloud.language.v1.ClassifyTextRequest\x1a..google.cloud.language.v1.ClassifyTextResponse"0\x82\xd3\xe4\x93\x02\x1f"\x1a/v1/documents:classifyText:\x01*\xda\x41\x08\x64ocument\x12\xca\x01\n\x0c\x41nnotateText\x12-.google.cloud.language.v1.AnnotateTextRequest\x1a..google.cloud.language.v1.AnnotateTextResponse"[\x82\xd3\xe4\x93\x02\x1f"\x1a/v1/documents:annotateText:\x01*\xda\x41\x1f\x64ocument,features,encoding_type\xda\x41\x11\x64ocument,features\x1az\xca\x41\x17language.googleapis.com\xd2\x41]https://www.googleapis.com/auth/cloud-language,https://www.googleapis.com/auth/cloud-platformBx\n\x1c\x63om.google.cloud.language.v1B\x14LanguageServiceProtoP\x01Z@google.golang.org/genproto/googleapis/cloud/language/v1;languageb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,
+    ],
+)
+
+_ENCODINGTYPE = _descriptor.EnumDescriptor(
+    name="EncodingType",
+    full_name="google.cloud.language.v1.EncodingType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NONE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF8", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF16", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF32", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6742,
+    serialized_end=6798,
+)
+_sym_db.RegisterEnumDescriptor(_ENCODINGTYPE)
+
+EncodingType = enum_type_wrapper.EnumTypeWrapper(_ENCODINGTYPE)
+NONE = 0
+UTF8 = 1
+UTF16 = 2
+UTF32 = 3
+
+
+_DOCUMENT_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.language.v1.Document.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLAIN_TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HTML", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=303,
+    serialized_end=357,
+)
+_sym_db.RegisterEnumDescriptor(_DOCUMENT_TYPE)
+
+_ENTITY_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.language.v1.Entity.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERSON", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOCATION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORGANIZATION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WORK_OF_ART", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONSUMER_GOOD", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PHONE_NUMBER", index=8, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDRESS", index=9, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATE", index=10, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMBER", index=11, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRICE", index=12, number=13, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=814,
+    serialized_end=999,
+)
+_sym_db.RegisterEnumDescriptor(_ENTITY_TYPE)
+
+_PARTOFSPEECH_TAG = _descriptor.EnumDescriptor(
+    name="Tag",
+    full_name="google.cloud.language.v1.PartOfSpeech.Tag",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADJ", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADP", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADV", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONJ", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DET", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOUN", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUM", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRON", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRT", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUNCT", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERB", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="X", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AFFIX", index=13, number=13, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2016,
+    serialized_end=2157,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_TAG)
+
+_PARTOFSPEECH_ASPECT = _descriptor.EnumDescriptor(
+    name="Aspect",
+    full_name="google.cloud.language.v1.PartOfSpeech.Aspect",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ASPECT_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERFECTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPERFECTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROGRESSIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2159,
+    serialized_end=2238,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_ASPECT)
+
+_PARTOFSPEECH_CASE = _descriptor.EnumDescriptor(
+    name="Case",
+    full_name="google.cloud.language.v1.PartOfSpeech.Case",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CASE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCUSATIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVERBIAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLEMENTIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATIVE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GENITIVE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSTRUMENTAL", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOCATIVE", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMINATIVE", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBLIQUE", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARTITIVE", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREPOSITIONAL",
+            index=11,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REFLEXIVE_CASE",
+            index=12,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RELATIVE_CASE",
+            index=13,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOCATIVE", index=14, number=14, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2241,
+    serialized_end=2489,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_CASE)
+
+_PARTOFSPEECH_FORM = _descriptor.EnumDescriptor(
+    name="Form",
+    full_name="google.cloud.language.v1.PartOfSpeech.Form",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FORM_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADNOMIAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXILIARY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLEMENTIZER", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINAL_ENDING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GERUND", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REALIS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IRREALIS", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHORT", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LONG", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORDER", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPECIFIC", index=11, number=11, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2492,
+    serialized_end=2667,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_FORM)
+
+_PARTOFSPEECH_GENDER = _descriptor.EnumDescriptor(
+    name="Gender",
+    full_name="google.cloud.language.v1.PartOfSpeech.Gender",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="GENDER_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FEMININE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MASCULINE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEUTER", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2669,
+    serialized_end=2738,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_GENDER)
+
+_PARTOFSPEECH_MOOD = _descriptor.EnumDescriptor(
+    name="Mood",
+    full_name="google.cloud.language.v1.PartOfSpeech.Mood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MOOD_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONDITIONAL_MOOD",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPERATIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INDICATIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERROGATIVE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JUSSIVE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUBJUNCTIVE", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2740,
+    serialized_end=2867,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_MOOD)
+
+_PARTOFSPEECH_NUMBER = _descriptor.EnumDescriptor(
+    name="Number",
+    full_name="google.cloud.language.v1.PartOfSpeech.Number",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NUMBER_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SINGULAR", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLURAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DUAL", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2869,
+    serialized_end=2933,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_NUMBER)
+
+_PARTOFSPEECH_PERSON = _descriptor.EnumDescriptor(
+    name="Person",
+    full_name="google.cloud.language.v1.PartOfSpeech.Person",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PERSON_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FIRST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SECOND", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="THIRD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REFLEXIVE_PERSON",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2935,
+    serialized_end=3019,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_PERSON)
+
+_PARTOFSPEECH_PROPER = _descriptor.EnumDescriptor(
+    name="Proper",
+    full_name="google.cloud.language.v1.PartOfSpeech.Proper",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PROPER_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROPER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOT_PROPER", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3021,
+    serialized_end=3077,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_PROPER)
+
+_PARTOFSPEECH_RECIPROCITY = _descriptor.EnumDescriptor(
+    name="Reciprocity",
+    full_name="google.cloud.language.v1.PartOfSpeech.Reciprocity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RECIPROCITY_UNKNOWN",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECIPROCAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NON_RECIPROCAL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3079,
+    serialized_end=3153,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_RECIPROCITY)
+
+_PARTOFSPEECH_TENSE = _descriptor.EnumDescriptor(
+    name="Tense",
+    full_name="google.cloud.language.v1.PartOfSpeech.Tense",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TENSE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONDITIONAL_TENSE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FUTURE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAST", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRESENT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPERFECT", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLUPERFECT", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3155,
+    serialized_end=3270,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_TENSE)
+
+_PARTOFSPEECH_VOICE = _descriptor.EnumDescriptor(
+    name="Voice",
+    full_name="google.cloud.language.v1.PartOfSpeech.Voice",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VOICE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CAUSATIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PASSIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3272,
+    serialized_end=3338,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_VOICE)
+
+_DEPENDENCYEDGE_LABEL = _descriptor.EnumDescriptor(
+    name="Label",
+    full_name="google.cloud.language.v1.DependencyEdge.Label",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ABBREV", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACOMP", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVCL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVMOD", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AMOD", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPOS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTR", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUX", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXPASS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CC", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CCOMP", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONJ", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CSUBJ", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CSUBJPASS", index=14, number=14, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEP", index=15, number=15, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DET", index=16, number=16, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISCOURSE", index=17, number=17, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOBJ", index=18, number=18, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPL", index=19, number=19, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GOESWITH", index=20, number=20, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IOBJ", index=21, number=21, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MARK", index=22, number=22, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MWE", index=23, number=23, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MWV", index=24, number=24, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEG", index=25, number=25, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NN", index=26, number=26, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NPADVMOD", index=27, number=27, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NSUBJ", index=28, number=28, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NSUBJPASS", index=29, number=29, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUM", index=30, number=30, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMBER", index=31, number=31, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="P", index=32, number=32, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARATAXIS", index=33, number=33, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARTMOD", index=34, number=34, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PCOMP", index=35, number=35, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POBJ", index=36, number=36, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSS", index=37, number=37, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSTNEG", index=38, number=38, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRECOMP", index=39, number=39, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRECONJ", index=40, number=40, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREDET", index=41, number=41, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREF", index=42, number=42, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREP", index=43, number=43, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRONL", index=44, number=44, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRT", index=45, number=45, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PS", index=46, number=46, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="QUANTMOD", index=47, number=47, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RCMOD", index=48, number=48, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RCMODREL", index=49, number=49, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RDROP", index=50, number=50, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REF", index=51, number=51, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMNANT", index=52, number=52, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPARANDUM", index=53, number=53, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ROOT", index=54, number=54, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SNUM", index=55, number=55, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUFF", index=56, number=56, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TMOD", index=57, number=57, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOPIC", index=58, number=58, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VMOD", index=59, number=59, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOCATIVE", index=60, number=60, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="XCOMP", index=61, number=61, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUFFIX", index=62, number=62, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TITLE", index=63, number=63, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVPHMOD", index=64, number=64, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXCAUS", index=65, number=65, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXVV", index=66, number=66, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DTMOD", index=67, number=67, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREIGN", index=68, number=68, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KW", index=69, number=69, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIST", index=70, number=70, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMC", index=71, number=71, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMCSUBJ", index=72, number=72, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMCSUBJPASS", index=73, number=73, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMC", index=74, number=74, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COP", index=75, number=75, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISLOCATED", index=76, number=76, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASP", index=77, number=77, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GMOD", index=78, number=78, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GOBJ", index=79, number=79, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INFMOD", index=80, number=80, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MES", index=81, number=81, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NCOMP", index=82, number=82, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3449,
+    serialized_end=4386,
+)
+_sym_db.RegisterEnumDescriptor(_DEPENDENCYEDGE_LABEL)
+
+_ENTITYMENTION_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.language.v1.EntityMention.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROPER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMMON", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4572,
+    serialized_end=4620,
+)
+_sym_db.RegisterEnumDescriptor(_ENTITYMENTION_TYPE)
+
+
+_DOCUMENT = _descriptor.Descriptor(
+    name="Document",
+    full_name="google.cloud.language.v1.Document",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.language.v1.Document.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.language.v1.Document.content",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcs_content_uri",
+            full_name="google.cloud.language.v1.Document.gcs_content_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1.Document.language",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCUMENT_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.language.v1.Document.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=172,
+    serialized_end=367,
+)
+
+
+_SENTENCE = _descriptor.Descriptor(
+    name="Sentence",
+    full_name="google.cloud.language.v1.Sentence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.language.v1.Sentence.text",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.language.v1.Sentence.sentiment",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=369,
+    serialized_end=485,
+)
+
+
+_ENTITY_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.language.v1.Entity.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.language.v1.Entity.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.language.v1.Entity.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=764,
+    serialized_end=811,
+)
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.language.v1.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.language.v1.Entity.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.language.v1.Entity.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.language.v1.Entity.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="salience",
+            full_name="google.cloud.language.v1.Entity.salience",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mentions",
+            full_name="google.cloud.language.v1.Entity.mentions",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.language.v1.Entity.sentiment",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ENTITY_METADATAENTRY],
+    enum_types=[_ENTITY_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=488,
+    serialized_end=999,
+)
+
+
+_TOKEN = _descriptor.Descriptor(
+    name="Token",
+    full_name="google.cloud.language.v1.Token",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.language.v1.Token.text",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="part_of_speech",
+            full_name="google.cloud.language.v1.Token.part_of_speech",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dependency_edge",
+            full_name="google.cloud.language.v1.Token.dependency_edge",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lemma",
+            full_name="google.cloud.language.v1.Token.lemma",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1002,
+    serialized_end=1205,
+)
+
+
+_SENTIMENT = _descriptor.Descriptor(
+    name="Sentiment",
+    full_name="google.cloud.language.v1.Sentiment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="magnitude",
+            full_name="google.cloud.language.v1.Sentiment.magnitude",
+            index=0,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.language.v1.Sentiment.score",
+            index=1,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1207,
+    serialized_end=1252,
+)
+
+
+_PARTOFSPEECH = _descriptor.Descriptor(
+    name="PartOfSpeech",
+    full_name="google.cloud.language.v1.PartOfSpeech",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tag",
+            full_name="google.cloud.language.v1.PartOfSpeech.tag",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="aspect",
+            full_name="google.cloud.language.v1.PartOfSpeech.aspect",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="case",
+            full_name="google.cloud.language.v1.PartOfSpeech.case",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="form",
+            full_name="google.cloud.language.v1.PartOfSpeech.form",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gender",
+            full_name="google.cloud.language.v1.PartOfSpeech.gender",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mood",
+            full_name="google.cloud.language.v1.PartOfSpeech.mood",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="number",
+            full_name="google.cloud.language.v1.PartOfSpeech.number",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="person",
+            full_name="google.cloud.language.v1.PartOfSpeech.person",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="proper",
+            full_name="google.cloud.language.v1.PartOfSpeech.proper",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reciprocity",
+            full_name="google.cloud.language.v1.PartOfSpeech.reciprocity",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tense",
+            full_name="google.cloud.language.v1.PartOfSpeech.tense",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="voice",
+            full_name="google.cloud.language.v1.PartOfSpeech.voice",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _PARTOFSPEECH_TAG,
+        _PARTOFSPEECH_ASPECT,
+        _PARTOFSPEECH_CASE,
+        _PARTOFSPEECH_FORM,
+        _PARTOFSPEECH_GENDER,
+        _PARTOFSPEECH_MOOD,
+        _PARTOFSPEECH_NUMBER,
+        _PARTOFSPEECH_PERSON,
+        _PARTOFSPEECH_PROPER,
+        _PARTOFSPEECH_RECIPROCITY,
+        _PARTOFSPEECH_TENSE,
+        _PARTOFSPEECH_VOICE,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1255,
+    serialized_end=3338,
+)
+
+
+_DEPENDENCYEDGE = _descriptor.Descriptor(
+    name="DependencyEdge",
+    full_name="google.cloud.language.v1.DependencyEdge",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="head_token_index",
+            full_name="google.cloud.language.v1.DependencyEdge.head_token_index",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.language.v1.DependencyEdge.label",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DEPENDENCYEDGE_LABEL],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3341,
+    serialized_end=4386,
+)
+
+
+_ENTITYMENTION = _descriptor.Descriptor(
+    name="EntityMention",
+    full_name="google.cloud.language.v1.EntityMention",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.language.v1.EntityMention.text",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.language.v1.EntityMention.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.language.v1.EntityMention.sentiment",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ENTITYMENTION_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4389,
+    serialized_end=4620,
+)
+
+
+_TEXTSPAN = _descriptor.Descriptor(
+    name="TextSpan",
+    full_name="google.cloud.language.v1.TextSpan",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.language.v1.TextSpan.content",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="begin_offset",
+            full_name="google.cloud.language.v1.TextSpan.begin_offset",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4622,
+    serialized_end=4671,
+)
+
+
+_CLASSIFICATIONCATEGORY = _descriptor.Descriptor(
+    name="ClassificationCategory",
+    full_name="google.cloud.language.v1.ClassificationCategory",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.language.v1.ClassificationCategory.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.language.v1.ClassificationCategory.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4673,
+    serialized_end=4731,
+)
+
+
+_ANALYZESENTIMENTREQUEST = _descriptor.Descriptor(
+    name="AnalyzeSentimentRequest",
+    full_name="google.cloud.language.v1.AnalyzeSentimentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1.AnalyzeSentimentRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1.AnalyzeSentimentRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4734,
+    serialized_end=4881,
+)
+
+
+_ANALYZESENTIMENTRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeSentimentResponse",
+    full_name="google.cloud.language.v1.AnalyzeSentimentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document_sentiment",
+            full_name="google.cloud.language.v1.AnalyzeSentimentResponse.document_sentiment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1.AnalyzeSentimentResponse.language",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentences",
+            full_name="google.cloud.language.v1.AnalyzeSentimentResponse.sentences",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4884,
+    serialized_end=5048,
+)
+
+
+_ANALYZEENTITYSENTIMENTREQUEST = _descriptor.Descriptor(
+    name="AnalyzeEntitySentimentRequest",
+    full_name="google.cloud.language.v1.AnalyzeEntitySentimentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1.AnalyzeEntitySentimentRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1.AnalyzeEntitySentimentRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5051,
+    serialized_end=5204,
+)
+
+
+_ANALYZEENTITYSENTIMENTRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeEntitySentimentResponse",
+    full_name="google.cloud.language.v1.AnalyzeEntitySentimentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entities",
+            full_name="google.cloud.language.v1.AnalyzeEntitySentimentResponse.entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1.AnalyzeEntitySentimentResponse.language",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5206,
+    serialized_end=5308,
+)
+
+
+_ANALYZEENTITIESREQUEST = _descriptor.Descriptor(
+    name="AnalyzeEntitiesRequest",
+    full_name="google.cloud.language.v1.AnalyzeEntitiesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1.AnalyzeEntitiesRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1.AnalyzeEntitiesRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5311,
+    serialized_end=5457,
+)
+
+
+_ANALYZEENTITIESRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeEntitiesResponse",
+    full_name="google.cloud.language.v1.AnalyzeEntitiesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entities",
+            full_name="google.cloud.language.v1.AnalyzeEntitiesResponse.entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1.AnalyzeEntitiesResponse.language",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5459,
+    serialized_end=5554,
+)
+
+
+_ANALYZESYNTAXREQUEST = _descriptor.Descriptor(
+    name="AnalyzeSyntaxRequest",
+    full_name="google.cloud.language.v1.AnalyzeSyntaxRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1.AnalyzeSyntaxRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1.AnalyzeSyntaxRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5557,
+    serialized_end=5701,
+)
+
+
+_ANALYZESYNTAXRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeSyntaxResponse",
+    full_name="google.cloud.language.v1.AnalyzeSyntaxResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sentences",
+            full_name="google.cloud.language.v1.AnalyzeSyntaxResponse.sentences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tokens",
+            full_name="google.cloud.language.v1.AnalyzeSyntaxResponse.tokens",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1.AnalyzeSyntaxResponse.language",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5704,
+    serialized_end=5849,
+)
+
+
+_CLASSIFYTEXTREQUEST = _descriptor.Descriptor(
+    name="ClassifyTextRequest",
+    full_name="google.cloud.language.v1.ClassifyTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1.ClassifyTextRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5851,
+    serialized_end=5931,
+)
+
+
+_CLASSIFYTEXTRESPONSE = _descriptor.Descriptor(
+    name="ClassifyTextResponse",
+    full_name="google.cloud.language.v1.ClassifyTextResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="categories",
+            full_name="google.cloud.language.v1.ClassifyTextResponse.categories",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5933,
+    serialized_end=6025,
+)
+
+
+_ANNOTATETEXTREQUEST_FEATURES = _descriptor.Descriptor(
+    name="Features",
+    full_name="google.cloud.language.v1.AnnotateTextRequest.Features",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="extract_syntax",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.Features.extract_syntax",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extract_entities",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.Features.extract_entities",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extract_document_sentiment",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.Features.extract_document_sentiment",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extract_entity_sentiment",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.Features.extract_entity_sentiment",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="classify_text",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.Features.classify_text",
+            index=4,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6253,
+    serialized_end=6406,
+)
+
+_ANNOTATETEXTREQUEST = _descriptor.Descriptor(
+    name="AnnotateTextRequest",
+    full_name="google.cloud.language.v1.AnnotateTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1.AnnotateTextRequest.encoding_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ANNOTATETEXTREQUEST_FEATURES],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6028,
+    serialized_end=6406,
+)
+
+
+_ANNOTATETEXTRESPONSE = _descriptor.Descriptor(
+    name="AnnotateTextResponse",
+    full_name="google.cloud.language.v1.AnnotateTextResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sentences",
+            full_name="google.cloud.language.v1.AnnotateTextResponse.sentences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tokens",
+            full_name="google.cloud.language.v1.AnnotateTextResponse.tokens",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entities",
+            full_name="google.cloud.language.v1.AnnotateTextResponse.entities",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_sentiment",
+            full_name="google.cloud.language.v1.AnnotateTextResponse.document_sentiment",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1.AnnotateTextResponse.language",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="categories",
+            full_name="google.cloud.language.v1.AnnotateTextResponse.categories",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6409,
+    serialized_end=6740,
+)
+
+_DOCUMENT.fields_by_name["type"].enum_type = _DOCUMENT_TYPE
+_DOCUMENT_TYPE.containing_type = _DOCUMENT
+_DOCUMENT.oneofs_by_name["source"].fields.append(_DOCUMENT.fields_by_name["content"])
+_DOCUMENT.fields_by_name["content"].containing_oneof = _DOCUMENT.oneofs_by_name[
+    "source"
+]
+_DOCUMENT.oneofs_by_name["source"].fields.append(
+    _DOCUMENT.fields_by_name["gcs_content_uri"]
+)
+_DOCUMENT.fields_by_name["gcs_content_uri"].containing_oneof = _DOCUMENT.oneofs_by_name[
+    "source"
+]
+_SENTENCE.fields_by_name["text"].message_type = _TEXTSPAN
+_SENTENCE.fields_by_name["sentiment"].message_type = _SENTIMENT
+_ENTITY_METADATAENTRY.containing_type = _ENTITY
+_ENTITY.fields_by_name["type"].enum_type = _ENTITY_TYPE
+_ENTITY.fields_by_name["metadata"].message_type = _ENTITY_METADATAENTRY
+_ENTITY.fields_by_name["mentions"].message_type = _ENTITYMENTION
+_ENTITY.fields_by_name["sentiment"].message_type = _SENTIMENT
+_ENTITY_TYPE.containing_type = _ENTITY
+_TOKEN.fields_by_name["text"].message_type = _TEXTSPAN
+_TOKEN.fields_by_name["part_of_speech"].message_type = _PARTOFSPEECH
+_TOKEN.fields_by_name["dependency_edge"].message_type = _DEPENDENCYEDGE
+_PARTOFSPEECH.fields_by_name["tag"].enum_type = _PARTOFSPEECH_TAG
+_PARTOFSPEECH.fields_by_name["aspect"].enum_type = _PARTOFSPEECH_ASPECT
+_PARTOFSPEECH.fields_by_name["case"].enum_type = _PARTOFSPEECH_CASE
+_PARTOFSPEECH.fields_by_name["form"].enum_type = _PARTOFSPEECH_FORM
+_PARTOFSPEECH.fields_by_name["gender"].enum_type = _PARTOFSPEECH_GENDER
+_PARTOFSPEECH.fields_by_name["mood"].enum_type = _PARTOFSPEECH_MOOD
+_PARTOFSPEECH.fields_by_name["number"].enum_type = _PARTOFSPEECH_NUMBER
+_PARTOFSPEECH.fields_by_name["person"].enum_type = _PARTOFSPEECH_PERSON
+_PARTOFSPEECH.fields_by_name["proper"].enum_type = _PARTOFSPEECH_PROPER
+_PARTOFSPEECH.fields_by_name["reciprocity"].enum_type = _PARTOFSPEECH_RECIPROCITY
+_PARTOFSPEECH.fields_by_name["tense"].enum_type = _PARTOFSPEECH_TENSE
+_PARTOFSPEECH.fields_by_name["voice"].enum_type = _PARTOFSPEECH_VOICE
+_PARTOFSPEECH_TAG.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_ASPECT.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_CASE.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_FORM.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_GENDER.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_MOOD.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_NUMBER.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_PERSON.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_PROPER.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_RECIPROCITY.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_TENSE.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_VOICE.containing_type = _PARTOFSPEECH
+_DEPENDENCYEDGE.fields_by_name["label"].enum_type = _DEPENDENCYEDGE_LABEL
+_DEPENDENCYEDGE_LABEL.containing_type = _DEPENDENCYEDGE
+_ENTITYMENTION.fields_by_name["text"].message_type = _TEXTSPAN
+_ENTITYMENTION.fields_by_name["type"].enum_type = _ENTITYMENTION_TYPE
+_ENTITYMENTION.fields_by_name["sentiment"].message_type = _SENTIMENT
+_ENTITYMENTION_TYPE.containing_type = _ENTITYMENTION
+_ANALYZESENTIMENTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZESENTIMENTREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZESENTIMENTRESPONSE.fields_by_name["document_sentiment"].message_type = _SENTIMENT
+_ANALYZESENTIMENTRESPONSE.fields_by_name["sentences"].message_type = _SENTENCE
+_ANALYZEENTITYSENTIMENTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZEENTITYSENTIMENTREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZEENTITYSENTIMENTRESPONSE.fields_by_name["entities"].message_type = _ENTITY
+_ANALYZEENTITIESREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZEENTITIESREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZEENTITIESRESPONSE.fields_by_name["entities"].message_type = _ENTITY
+_ANALYZESYNTAXREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZESYNTAXREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZESYNTAXRESPONSE.fields_by_name["sentences"].message_type = _SENTENCE
+_ANALYZESYNTAXRESPONSE.fields_by_name["tokens"].message_type = _TOKEN
+_CLASSIFYTEXTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_CLASSIFYTEXTRESPONSE.fields_by_name[
+    "categories"
+].message_type = _CLASSIFICATIONCATEGORY
+_ANNOTATETEXTREQUEST_FEATURES.containing_type = _ANNOTATETEXTREQUEST
+_ANNOTATETEXTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANNOTATETEXTREQUEST.fields_by_name[
+    "features"
+].message_type = _ANNOTATETEXTREQUEST_FEATURES
+_ANNOTATETEXTREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANNOTATETEXTRESPONSE.fields_by_name["sentences"].message_type = _SENTENCE
+_ANNOTATETEXTRESPONSE.fields_by_name["tokens"].message_type = _TOKEN
+_ANNOTATETEXTRESPONSE.fields_by_name["entities"].message_type = _ENTITY
+_ANNOTATETEXTRESPONSE.fields_by_name["document_sentiment"].message_type = _SENTIMENT
+_ANNOTATETEXTRESPONSE.fields_by_name[
+    "categories"
+].message_type = _CLASSIFICATIONCATEGORY
+DESCRIPTOR.message_types_by_name["Document"] = _DOCUMENT
+DESCRIPTOR.message_types_by_name["Sentence"] = _SENTENCE
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["Token"] = _TOKEN
+DESCRIPTOR.message_types_by_name["Sentiment"] = _SENTIMENT
+DESCRIPTOR.message_types_by_name["PartOfSpeech"] = _PARTOFSPEECH
+DESCRIPTOR.message_types_by_name["DependencyEdge"] = _DEPENDENCYEDGE
+DESCRIPTOR.message_types_by_name["EntityMention"] = _ENTITYMENTION
+DESCRIPTOR.message_types_by_name["TextSpan"] = _TEXTSPAN
+DESCRIPTOR.message_types_by_name["ClassificationCategory"] = _CLASSIFICATIONCATEGORY
+DESCRIPTOR.message_types_by_name["AnalyzeSentimentRequest"] = _ANALYZESENTIMENTREQUEST
+DESCRIPTOR.message_types_by_name["AnalyzeSentimentResponse"] = _ANALYZESENTIMENTRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AnalyzeEntitySentimentRequest"
+] = _ANALYZEENTITYSENTIMENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AnalyzeEntitySentimentResponse"
+] = _ANALYZEENTITYSENTIMENTRESPONSE
+DESCRIPTOR.message_types_by_name["AnalyzeEntitiesRequest"] = _ANALYZEENTITIESREQUEST
+DESCRIPTOR.message_types_by_name["AnalyzeEntitiesResponse"] = _ANALYZEENTITIESRESPONSE
+DESCRIPTOR.message_types_by_name["AnalyzeSyntaxRequest"] = _ANALYZESYNTAXREQUEST
+DESCRIPTOR.message_types_by_name["AnalyzeSyntaxResponse"] = _ANALYZESYNTAXRESPONSE
+DESCRIPTOR.message_types_by_name["ClassifyTextRequest"] = _CLASSIFYTEXTREQUEST
+DESCRIPTOR.message_types_by_name["ClassifyTextResponse"] = _CLASSIFYTEXTRESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateTextRequest"] = _ANNOTATETEXTREQUEST
+DESCRIPTOR.message_types_by_name["AnnotateTextResponse"] = _ANNOTATETEXTRESPONSE
+DESCRIPTOR.enum_types_by_name["EncodingType"] = _ENCODINGTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Document = _reflection.GeneratedProtocolMessageType(
+    "Document",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENT,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents the input to API methods.
+  
+  
+  Attributes:
+      type:
+          Required. If the type is not set or is ``TYPE_UNSPECIFIED``,
+          returns an ``INVALID_ARGUMENT`` error.
+      source:
+          The source of the document: a string containing the content or
+          a Google Cloud Storage URI.
+      content:
+          The content of the input in string format. Cloud audit logging
+          exempt since it is based on user data.
+      gcs_content_uri:
+          The Google Cloud Storage URI where the file content is
+          located. This URI must be of the form:
+          gs://bucket\_name/object\_name. For more details, see
+          https://cloud.google.com/storage/docs/reference-uris. NOTE:
+          Cloud Storage object versioning is not supported.
+      language:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.Document)
+    ),
+)
+_sym_db.RegisterMessage(Document)
+
+Sentence = _reflection.GeneratedProtocolMessageType(
+    "Sentence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENTENCE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents a sentence in the input document.
+  
+  
+  Attributes:
+      text:
+          The sentence text.
+      sentiment:
+          For calls to [AnalyzeSentiment][] or if [AnnotateTextRequest.F
+          eatures.extract\_document\_sentiment][google.cloud.language.v1
+          .AnnotateTextRequest.Features.extract\_document\_sentiment] is
+          set to true, this field will contain the sentiment for the
+          sentence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.Sentence)
+    ),
+)
+_sym_db.RegisterMessage(Sentence)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ENTITY_METADATAENTRY,
+                __module__="google.cloud.language_v1.proto.language_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.language.v1.Entity.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents a phrase in the text that is a known entity, such as a
+  person, an organization, or location. The API associates information,
+  such as salience and mentions, with entities.
+  
+  
+  Attributes:
+      name:
+          The representative name for the entity.
+      type:
+          The entity type.
+      metadata:
+          Metadata associated with the entity.  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.
+      salience:
+          The salience score associated with the entity in the [0, 1.0]
+          range.  The salience score for an entity provides information
+          about the importance or centrality of that entity to the
+          entire document text. Scores closer to 0 are less salient,
+          while scores closer to 1.0 are highly salient.
+      mentions:
+          The mentions of this entity in the input document. The API
+          currently supports proper noun mentions.
+      sentiment:
+          For calls to [AnalyzeEntitySentiment][] or if [AnnotateTextReq
+          uest.Features.extract\_entity\_sentiment][google.cloud.languag
+          e.v1.AnnotateTextRequest.Features.extract\_entity\_sentiment]
+          is set to true, this field will contain the aggregate
+          sentiment expressed for this entity in the provided document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+_sym_db.RegisterMessage(Entity.MetadataEntry)
+
+Token = _reflection.GeneratedProtocolMessageType(
+    "Token",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TOKEN,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents the smallest syntactic building block of the text.
+  
+  
+  Attributes:
+      text:
+          The token text.
+      part_of_speech:
+          Parts of speech tag for this token.
+      dependency_edge:
+          Dependency tree parse for this token.
+      lemma:
+          `Lemma
+          <https://en.wikipedia.org/wiki/Lemma_%28morphology%29>`__ of
+          the token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.Token)
+    ),
+)
+_sym_db.RegisterMessage(Token)
+
+Sentiment = _reflection.GeneratedProtocolMessageType(
+    "Sentiment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENTIMENT,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents the feeling associated with the entire text or entities in
+  the text.
+  
+  
+  Attributes:
+      magnitude:
+          A non-negative number in the [0, +inf) range, which represents
+          the absolute magnitude of sentiment regardless of score
+          (positive or negative).
+      score:
+          Sentiment score between -1.0 (negative sentiment) and 1.0
+          (positive sentiment).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.Sentiment)
+    ),
+)
+_sym_db.RegisterMessage(Sentiment)
+
+PartOfSpeech = _reflection.GeneratedProtocolMessageType(
+    "PartOfSpeech",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTOFSPEECH,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents part of speech information for a token. Parts of speech are
+  as defined in
+  http://www.lrec-conf.org/proceedings/lrec2012/pdf/274\_Paper.pdf
+  
+  
+  Attributes:
+      tag:
+          The part of speech tag.
+      aspect:
+          The grammatical aspect.
+      case:
+          The grammatical case.
+      form:
+          The grammatical form.
+      gender:
+          The grammatical gender.
+      mood:
+          The grammatical mood.
+      number:
+          The grammatical number.
+      person:
+          The grammatical person.
+      proper:
+          The grammatical properness.
+      reciprocity:
+          The grammatical reciprocity.
+      tense:
+          The grammatical tense.
+      voice:
+          The grammatical voice.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.PartOfSpeech)
+    ),
+)
+_sym_db.RegisterMessage(PartOfSpeech)
+
+DependencyEdge = _reflection.GeneratedProtocolMessageType(
+    "DependencyEdge",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEPENDENCYEDGE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents dependency parse tree information for a token. (For more
+  information on dependency labels, see
+  http://www.aclweb.org/anthology/P13-2017
+  
+  
+  Attributes:
+      head_token_index:
+          Represents the head of this token in the dependency tree. This
+          is the index of the token which has an arc going to this
+          token. The index is the position of the token in the array of
+          tokens returned by the API method. If this token is a root
+          token, then the ``head_token_index`` is its own index.
+      label:
+          The parse label for the token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.DependencyEdge)
+    ),
+)
+_sym_db.RegisterMessage(DependencyEdge)
+
+EntityMention = _reflection.GeneratedProtocolMessageType(
+    "EntityMention",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYMENTION,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents a mention for an entity in the text. Currently, proper noun
+  mentions are supported.
+  
+  
+  Attributes:
+      text:
+          The mention text.
+      type:
+          The type of the entity mention.
+      sentiment:
+          For calls to [AnalyzeEntitySentiment][] or if [AnnotateTextReq
+          uest.Features.extract\_entity\_sentiment][google.cloud.languag
+          e.v1.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.EntityMention)
+    ),
+)
+_sym_db.RegisterMessage(EntityMention)
+
+TextSpan = _reflection.GeneratedProtocolMessageType(
+    "TextSpan",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSPAN,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents an output piece of text.
+  
+  
+  Attributes:
+      content:
+          The content of the output text.
+      begin_offset:
+          The API calculates the beginning offset of the content in the
+          original document according to the
+          [EncodingType][google.cloud.language.v1.EncodingType]
+          specified in the API request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.TextSpan)
+    ),
+)
+_sym_db.RegisterMessage(TextSpan)
+
+ClassificationCategory = _reflection.GeneratedProtocolMessageType(
+    "ClassificationCategory",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFICATIONCATEGORY,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""Represents a category returned from the text classifier.
+  
+  
+  Attributes:
+      name:
+          The name of the category representing the document, from the
+          `predefined taxonomy </natural-language/docs/categories>`__.
+      confidence:
+          The classifier's confidence of the category. Number represents
+          how certain the classifier is that this category represents
+          the given text.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.ClassificationCategory)
+    ),
+)
+_sym_db.RegisterMessage(ClassificationCategory)
+
+AnalyzeSentimentRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSentimentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESENTIMENTREQUEST,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The sentiment analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate sentence
+          offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeSentimentRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSentimentRequest)
+
+AnalyzeSentimentResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSentimentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESENTIMENTRESPONSE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The sentiment analysis response message.
+  
+  
+  Attributes:
+      document_sentiment:
+          The overall sentiment of the input document.
+      language:
+          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][googl
+          e.cloud.language.v1.Document.language] field for more details.
+      sentences:
+          The sentiment for all the sentences in the document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeSentimentResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSentimentResponse)
+
+AnalyzeEntitySentimentRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitySentimentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITYSENTIMENTREQUEST,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The entity-level sentiment analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeEntitySentimentRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitySentimentRequest)
+
+AnalyzeEntitySentimentResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitySentimentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITYSENTIMENTRESPONSE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The entity-level sentiment analysis response message.
+  
+  
+  Attributes:
+      entities:
+          The recognized entities in the input document with associated
+          sentiments.
+      language:
+          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][googl
+          e.cloud.language.v1.Document.language] field for more details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeEntitySentimentResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitySentimentResponse)
+
+AnalyzeEntitiesRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitiesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITIESREQUEST,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The entity analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeEntitiesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitiesRequest)
+
+AnalyzeEntitiesResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitiesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITIESRESPONSE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The entity analysis response message.
+  
+  
+  Attributes:
+      entities:
+          The recognized entities in the input document.
+      language:
+          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][googl
+          e.cloud.language.v1.Document.language] field for more details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeEntitiesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitiesResponse)
+
+AnalyzeSyntaxRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSyntaxRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESYNTAXREQUEST,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The syntax analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeSyntaxRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSyntaxRequest)
+
+AnalyzeSyntaxResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSyntaxResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESYNTAXRESPONSE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The syntax analysis response message.
+  
+  
+  Attributes:
+      sentences:
+          Sentences in the input document.
+      tokens:
+          Tokens, along with their syntactic information, in the input
+          document.
+      language:
+          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][googl
+          e.cloud.language.v1.Document.language] field for more details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnalyzeSyntaxResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSyntaxResponse)
+
+ClassifyTextRequest = _reflection.GeneratedProtocolMessageType(
+    "ClassifyTextRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFYTEXTREQUEST,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The document classification request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.ClassifyTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(ClassifyTextRequest)
+
+ClassifyTextResponse = _reflection.GeneratedProtocolMessageType(
+    "ClassifyTextResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFYTEXTRESPONSE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The document classification response message.
+  
+  
+  Attributes:
+      categories:
+          Categories representing the input document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.ClassifyTextResponse)
+    ),
+)
+_sym_db.RegisterMessage(ClassifyTextResponse)
+
+AnnotateTextRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateTextRequest",
+    (_message.Message,),
+    dict(
+        Features=_reflection.GeneratedProtocolMessageType(
+            "Features",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ANNOTATETEXTREQUEST_FEATURES,
+                __module__="google.cloud.language_v1.proto.language_service_pb2",
+                __doc__="""All available features for sentiment, syntax, and semantic analysis.
+    Setting each one to true will enable that specific analysis for the
+    input.
+    
+    
+    Attributes:
+        extract_syntax:
+            Extract syntax information.
+        extract_entities:
+            Extract entities.
+        extract_document_sentiment:
+            Extract document-level sentiment.
+        extract_entity_sentiment:
+            Extract entities and their associated sentiment.
+        classify_text:
+            Classify the full document into categories.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnnotateTextRequest.Features)
+            ),
+        ),
+        DESCRIPTOR=_ANNOTATETEXTREQUEST,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The request message for the text annotation API, which can perform
+  multiple analysis types (sentiment, entities, and syntax) in one call.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      features:
+          The enabled features.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnnotateTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateTextRequest)
+_sym_db.RegisterMessage(AnnotateTextRequest.Features)
+
+AnnotateTextResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateTextResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATETEXTRESPONSE,
+        __module__="google.cloud.language_v1.proto.language_service_pb2",
+        __doc__="""The text annotations response message.
+  
+  
+  Attributes:
+      sentences:
+          Sentences in the input document. Populated if the user enables
+          [AnnotateTextRequest.Features.extract\_syntax][google.cloud.la
+          nguage.v1.AnnotateTextRequest.Features.extract\_syntax].
+      tokens:
+          Tokens, along with their syntactic information, in the input
+          document. Populated if the user enables [AnnotateTextRequest.F
+          eatures.extract\_syntax][google.cloud.language.v1.AnnotateText
+          Request.Features.extract\_syntax].
+      entities:
+          Entities, along with their semantic information, in the input
+          document. Populated if the user enables [AnnotateTextRequest.F
+          eatures.extract\_entities][google.cloud.language.v1.AnnotateTe
+          xtRequest.Features.extract\_entities].
+      document_sentiment:
+          The overall sentiment for the document. Populated if the user
+          enables [AnnotateTextRequest.Features.extract\_document\_senti
+          ment][google.cloud.language.v1.AnnotateTextRequest.Features.ex
+          tract\_document\_sentiment].
+      language:
+          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][googl
+          e.cloud.language.v1.Document.language] field for more details.
+      categories:
+          Categories identified in the input document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1.AnnotateTextResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateTextResponse)
+
+
+DESCRIPTOR._options = None
+_ENTITY_METADATAENTRY._options = None
+_ANALYZESENTIMENTREQUEST.fields_by_name["document"]._options = None
+_ANALYZEENTITYSENTIMENTREQUEST.fields_by_name["document"]._options = None
+_ANALYZEENTITIESREQUEST.fields_by_name["document"]._options = None
+_ANALYZESYNTAXREQUEST.fields_by_name["document"]._options = None
+_CLASSIFYTEXTREQUEST.fields_by_name["document"]._options = None
+_ANNOTATETEXTREQUEST.fields_by_name["document"]._options = None
+_ANNOTATETEXTREQUEST.fields_by_name["features"]._options = None
+
+_LANGUAGESERVICE = _descriptor.ServiceDescriptor(
+    name="LanguageService",
+    full_name="google.cloud.language.v1.LanguageService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\027language.googleapis.com\322A]https://www.googleapis.com/auth/cloud-language,https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=6801,
+    serialized_end=8129,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnalyzeSentiment",
+            full_name="google.cloud.language.v1.LanguageService.AnalyzeSentiment",
+            index=0,
+            containing_service=None,
+            input_type=_ANALYZESENTIMENTREQUEST,
+            output_type=_ANALYZESENTIMENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002#"\036/v1/documents:analyzeSentiment:\001*\332A\026document,encoding_type\332A\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnalyzeEntities",
+            full_name="google.cloud.language.v1.LanguageService.AnalyzeEntities",
+            index=1,
+            containing_service=None,
+            input_type=_ANALYZEENTITIESREQUEST,
+            output_type=_ANALYZEENTITIESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002""\035/v1/documents:analyzeEntities:\001*\332A\026document,encoding_type\332A\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnalyzeEntitySentiment",
+            full_name="google.cloud.language.v1.LanguageService.AnalyzeEntitySentiment",
+            index=2,
+            containing_service=None,
+            input_type=_ANALYZEENTITYSENTIMENTREQUEST,
+            output_type=_ANALYZEENTITYSENTIMENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v1/documents:analyzeEntitySentiment:\001*\332A\026document,encoding_type\332A\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnalyzeSyntax",
+            full_name="google.cloud.language.v1.LanguageService.AnalyzeSyntax",
+            index=3,
+            containing_service=None,
+            input_type=_ANALYZESYNTAXREQUEST,
+            output_type=_ANALYZESYNTAXRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002 "\033/v1/documents:analyzeSyntax:\001*\332A\026document,encoding_type\332A\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ClassifyText",
+            full_name="google.cloud.language.v1.LanguageService.ClassifyText",
+            index=4,
+            containing_service=None,
+            input_type=_CLASSIFYTEXTREQUEST,
+            output_type=_CLASSIFYTEXTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1/documents:classifyText:\001*\332A\010document'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnnotateText",
+            full_name="google.cloud.language.v1.LanguageService.AnnotateText",
+            index=5,
+            containing_service=None,
+            input_type=_ANNOTATETEXTREQUEST,
+            output_type=_ANNOTATETEXTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1/documents:annotateText:\001*\332A\037document,features,encoding_type\332A\021document,features'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_LANGUAGESERVICE)
+
+DESCRIPTOR.services_by_name["LanguageService"] = _LANGUAGESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/language/google/cloud/language_v1/proto/language_service_pb2_grpc.py b/language/google/cloud/language_v1/proto/language_service_pb2_grpc.py
new file mode 100644
index 000000000000..40a7da305773
--- /dev/null
+++ b/language/google/cloud/language_v1/proto/language_service_pb2_grpc.py
@@ -0,0 +1,142 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.language_v1.proto import (
+    language_service_pb2 as google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2,
+)
+
+
+class LanguageServiceStub(object):
+    """Provides text analysis operations such as sentiment analysis and entity
+  recognition.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnalyzeSentiment = channel.unary_unary(
+            "/google.cloud.language.v1.LanguageService/AnalyzeSentiment",
+            request_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSentimentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSentimentResponse.FromString,
+        )
+        self.AnalyzeEntities = channel.unary_unary(
+            "/google.cloud.language.v1.LanguageService/AnalyzeEntities",
+            request_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitiesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitiesResponse.FromString,
+        )
+        self.AnalyzeEntitySentiment = channel.unary_unary(
+            "/google.cloud.language.v1.LanguageService/AnalyzeEntitySentiment",
+            request_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentResponse.FromString,
+        )
+        self.AnalyzeSyntax = channel.unary_unary(
+            "/google.cloud.language.v1.LanguageService/AnalyzeSyntax",
+            request_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSyntaxRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSyntaxResponse.FromString,
+        )
+        self.ClassifyText = channel.unary_unary(
+            "/google.cloud.language.v1.LanguageService/ClassifyText",
+            request_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.ClassifyTextRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.ClassifyTextResponse.FromString,
+        )
+        self.AnnotateText = channel.unary_unary(
+            "/google.cloud.language.v1.LanguageService/AnnotateText",
+            request_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnnotateTextRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnnotateTextResponse.FromString,
+        )
+
+
+class LanguageServiceServicer(object):
+    """Provides text analysis operations such as sentiment analysis and entity
+  recognition.
+  """
+
+    def AnalyzeSentiment(self, request, context):
+        """Analyzes the sentiment of the provided text.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnalyzeEntities(self, request, context):
+        """Finds named entities (currently proper names and common nouns) in the text
+    along with entity types, salience, mentions for each entity, and
+    other properties.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnalyzeEntitySentiment(self, request, context):
+        """Finds entities, similar to [AnalyzeEntities][google.cloud.language.v1.LanguageService.AnalyzeEntities] in the text and analyzes
+    sentiment associated with each entity and its mentions.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnalyzeSyntax(self, request, context):
+        """Analyzes the syntax of the text and provides sentence boundaries and
+    tokenization along with part of speech tags, dependency trees, and other
+    properties.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ClassifyText(self, request, context):
+        """Classifies a document into categories.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnnotateText(self, request, context):
+        """A convenience method that provides all the features that analyzeSentiment,
+    analyzeEntities, and analyzeSyntax provide in one call.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_LanguageServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnalyzeSentiment": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeSentiment,
+            request_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSentimentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSentimentResponse.SerializeToString,
+        ),
+        "AnalyzeEntities": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeEntities,
+            request_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitiesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitiesResponse.SerializeToString,
+        ),
+        "AnalyzeEntitySentiment": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeEntitySentiment,
+            request_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentResponse.SerializeToString,
+        ),
+        "AnalyzeSyntax": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeSyntax,
+            request_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSyntaxRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnalyzeSyntaxResponse.SerializeToString,
+        ),
+        "ClassifyText": grpc.unary_unary_rpc_method_handler(
+            servicer.ClassifyText,
+            request_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.ClassifyTextRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.ClassifyTextResponse.SerializeToString,
+        ),
+        "AnnotateText": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateText,
+            request_deserializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnnotateTextRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1_dot_proto_dot_language__service__pb2.AnnotateTextResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.language.v1.LanguageService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/language/google/cloud/language_v1/types.py b/language/google/cloud/language_v1/types.py
new file mode 100644
index 000000000000..758829425134
--- /dev/null
+++ b/language/google/cloud/language_v1/types.py
@@ -0,0 +1,42 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.protobuf import descriptor_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.language_v1.proto import language_service_pb2
+
+
+_shared_modules = [http_pb2, descriptor_pb2]
+
+_local_modules = [language_service_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.language_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/language/google/cloud/language_v1beta2/__init__.py b/language/google/cloud/language_v1beta2/__init__.py
new file mode 100644
index 000000000000..d980c998cc19
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/__init__.py
@@ -0,0 +1,27 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.language_v1beta2 import types
+from google.cloud.language_v1beta2.gapic import enums
+from google.cloud.language_v1beta2.gapic import language_service_client
+
+
+class LanguageServiceClient(language_service_client.LanguageServiceClient):
+    __doc__ = language_service_client.LanguageServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "LanguageServiceClient")
diff --git a/language/google/cloud/language_v1beta2/gapic/__init__.py b/language/google/cloud/language_v1beta2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/google/cloud/language_v1beta2/gapic/enums.py b/language/google/cloud/language_v1beta2/gapic/enums.py
new file mode 100644
index 000000000000..aa68fa4911ec
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/gapic/enums.py
@@ -0,0 +1,550 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class EncodingType(enum.IntEnum):
+    """
+    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.
+
+    Attributes:
+      NONE (int): If ``EncodingType`` is not specified, encoding-dependent information
+      (such as ``begin_offset``) will be set at ``-1``.
+      UTF8 (int): 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.
+      UTF16 (int): 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.
+      UTF32 (int): 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.
+    """
+
+    NONE = 0
+    UTF8 = 1
+    UTF16 = 2
+    UTF32 = 3
+
+
+class DependencyEdge(object):
+    class Label(enum.IntEnum):
+        """
+        The parse label enum for the token.
+
+        Attributes:
+          UNKNOWN (int): Unknown
+          ABBREV (int): Abbreviation modifier
+          ACOMP (int): Adjectival complement
+          ADVCL (int): Adverbial clause modifier
+          ADVMOD (int): Adverbial modifier
+          AMOD (int): Adjectival modifier of an NP
+          APPOS (int): Appositional modifier of an NP
+          ATTR (int): Attribute dependent of a copular verb
+          AUX (int): Auxiliary (non-main) verb
+          AUXPASS (int): Passive auxiliary
+          CC (int): Coordinating conjunction
+          CCOMP (int): Clausal complement of a verb or adjective
+          CONJ (int): Conjunct
+          CSUBJ (int): Clausal subject
+          CSUBJPASS (int): Clausal passive subject
+          DEP (int): Dependency (unable to determine)
+          DET (int): Determiner
+          DISCOURSE (int): Discourse
+          DOBJ (int): Direct object
+          EXPL (int): Expletive
+          GOESWITH (int): Goes with (part of a word in a text not well edited)
+          IOBJ (int): Indirect object
+          MARK (int): Marker (word introducing a subordinate clause)
+          MWE (int): Multi-word expression
+          MWV (int): Multi-word verbal expression
+          NEG (int): Negation modifier
+          NN (int): Noun compound modifier
+          NPADVMOD (int): Noun phrase used as an adverbial modifier
+          NSUBJ (int): Nominal subject
+          NSUBJPASS (int): Passive nominal subject
+          NUM (int): Numeric modifier of a noun
+          NUMBER (int): Element of compound number
+          P (int): Punctuation mark
+          PARATAXIS (int): Parataxis relation
+          PARTMOD (int): Participial modifier
+          PCOMP (int): The complement of a preposition is a clause
+          POBJ (int): Object of a preposition
+          POSS (int): Possession modifier
+          POSTNEG (int): Postverbal negative particle
+          PRECOMP (int): Predicate complement
+          PRECONJ (int): Preconjunt
+          PREDET (int): Predeterminer
+          PREF (int): Prefix
+          PREP (int): Prepositional modifier
+          PRONL (int): The relationship between a verb and verbal morpheme
+          PRT (int): Particle
+          PS (int): Associative or possessive marker
+          QUANTMOD (int): Quantifier phrase modifier
+          RCMOD (int): Relative clause modifier
+          RCMODREL (int): Complementizer in relative clause
+          RDROP (int): Ellipsis without a preceding predicate
+          REF (int): Referent
+          REMNANT (int): Remnant
+          REPARANDUM (int): Reparandum
+          ROOT (int): Root
+          SNUM (int): Suffix specifying a unit of number
+          SUFF (int): Suffix
+          TMOD (int): Temporal modifier
+          TOPIC (int): Topic marker
+          VMOD (int): Clause headed by an infinite form of the verb that modifies a noun
+          VOCATIVE (int): Vocative
+          XCOMP (int): Open clausal complement
+          SUFFIX (int): Name suffix
+          TITLE (int): Name title
+          ADVPHMOD (int): Adverbial phrase modifier
+          AUXCAUS (int): Causative auxiliary
+          AUXVV (int): Helper auxiliary
+          DTMOD (int): Rentaishi (Prenominal modifier)
+          FOREIGN (int): Foreign words
+          KW (int): Keyword
+          LIST (int): List for chains of comparable items
+          NOMC (int): Nominalized clause
+          NOMCSUBJ (int): Nominalized clausal subject
+          NOMCSUBJPASS (int): Nominalized clausal passive
+          NUMC (int): Compound of numeric modifier
+          COP (int): Copula
+          DISLOCATED (int): Dislocated relation (for fronted/topicalized elements)
+          ASP (int): Aspect marker
+          GMOD (int): Genitive modifier
+          GOBJ (int): Genitive object
+          INFMOD (int): Infinitival modifier
+          MES (int): Measure
+          NCOMP (int): Nominal complement of a noun
+        """
+
+        UNKNOWN = 0
+        ABBREV = 1
+        ACOMP = 2
+        ADVCL = 3
+        ADVMOD = 4
+        AMOD = 5
+        APPOS = 6
+        ATTR = 7
+        AUX = 8
+        AUXPASS = 9
+        CC = 10
+        CCOMP = 11
+        CONJ = 12
+        CSUBJ = 13
+        CSUBJPASS = 14
+        DEP = 15
+        DET = 16
+        DISCOURSE = 17
+        DOBJ = 18
+        EXPL = 19
+        GOESWITH = 20
+        IOBJ = 21
+        MARK = 22
+        MWE = 23
+        MWV = 24
+        NEG = 25
+        NN = 26
+        NPADVMOD = 27
+        NSUBJ = 28
+        NSUBJPASS = 29
+        NUM = 30
+        NUMBER = 31
+        P = 32
+        PARATAXIS = 33
+        PARTMOD = 34
+        PCOMP = 35
+        POBJ = 36
+        POSS = 37
+        POSTNEG = 38
+        PRECOMP = 39
+        PRECONJ = 40
+        PREDET = 41
+        PREF = 42
+        PREP = 43
+        PRONL = 44
+        PRT = 45
+        PS = 46
+        QUANTMOD = 47
+        RCMOD = 48
+        RCMODREL = 49
+        RDROP = 50
+        REF = 51
+        REMNANT = 52
+        REPARANDUM = 53
+        ROOT = 54
+        SNUM = 55
+        SUFF = 56
+        TMOD = 57
+        TOPIC = 58
+        VMOD = 59
+        VOCATIVE = 60
+        XCOMP = 61
+        SUFFIX = 62
+        TITLE = 63
+        ADVPHMOD = 64
+        AUXCAUS = 65
+        AUXVV = 66
+        DTMOD = 67
+        FOREIGN = 68
+        KW = 69
+        LIST = 70
+        NOMC = 71
+        NOMCSUBJ = 72
+        NOMCSUBJPASS = 73
+        NUMC = 74
+        COP = 75
+        DISLOCATED = 76
+        ASP = 77
+        GMOD = 78
+        GOBJ = 79
+        INFMOD = 80
+        MES = 81
+        NCOMP = 82
+
+
+class Document(object):
+    class Type(enum.IntEnum):
+        """
+        The document types enum.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): The content type is not specified.
+          PLAIN_TEXT (int): Plain text
+          HTML (int): HTML
+        """
+
+        TYPE_UNSPECIFIED = 0
+        PLAIN_TEXT = 1
+        HTML = 2
+
+
+class Entity(object):
+    class Type(enum.IntEnum):
+        """
+        The type of the entity.
+
+        Attributes:
+          UNKNOWN (int): Unknown
+          PERSON (int): Person
+          LOCATION (int): Location
+          ORGANIZATION (int): Organization
+          EVENT (int): Event
+          WORK_OF_ART (int): Work of art
+          CONSUMER_GOOD (int): Consumer goods
+          OTHER (int): Other types
+        """
+
+        UNKNOWN = 0
+        PERSON = 1
+        LOCATION = 2
+        ORGANIZATION = 3
+        EVENT = 4
+        WORK_OF_ART = 5
+        CONSUMER_GOOD = 6
+        OTHER = 7
+
+
+class EntityMention(object):
+    class Type(enum.IntEnum):
+        """
+        The supported types of mentions.
+
+        Attributes:
+          TYPE_UNKNOWN (int): Unknown
+          PROPER (int): Proper name
+          COMMON (int): Common noun (or noun compound)
+        """
+
+        TYPE_UNKNOWN = 0
+        PROPER = 1
+        COMMON = 2
+
+
+class PartOfSpeech(object):
+    class Aspect(enum.IntEnum):
+        """
+        The characteristic of a verb that expresses time flow during an event.
+
+        Attributes:
+          ASPECT_UNKNOWN (int): Aspect is not applicable in the analyzed language or is not predicted.
+          PERFECTIVE (int): Perfective
+          IMPERFECTIVE (int): Imperfective
+          PROGRESSIVE (int): Progressive
+        """
+
+        ASPECT_UNKNOWN = 0
+        PERFECTIVE = 1
+        IMPERFECTIVE = 2
+        PROGRESSIVE = 3
+
+    class Case(enum.IntEnum):
+        """
+        The grammatical function performed by a noun or pronoun in a phrase,
+        clause, or sentence. In some languages, other parts of speech, such as
+        adjective and determiner, take case inflection in agreement with the noun.
+
+        Attributes:
+          CASE_UNKNOWN (int): Case is not applicable in the analyzed language or is not predicted.
+          ACCUSATIVE (int): Accusative
+          ADVERBIAL (int): Adverbial
+          COMPLEMENTIVE (int): Complementive
+          DATIVE (int): Dative
+          GENITIVE (int): Genitive
+          INSTRUMENTAL (int): Instrumental
+          LOCATIVE (int): Locative
+          NOMINATIVE (int): Nominative
+          OBLIQUE (int): Oblique
+          PARTITIVE (int): Partitive
+          PREPOSITIONAL (int): Prepositional
+          REFLEXIVE_CASE (int): Reflexive
+          RELATIVE_CASE (int): Relative
+          VOCATIVE (int): Vocative
+        """
+
+        CASE_UNKNOWN = 0
+        ACCUSATIVE = 1
+        ADVERBIAL = 2
+        COMPLEMENTIVE = 3
+        DATIVE = 4
+        GENITIVE = 5
+        INSTRUMENTAL = 6
+        LOCATIVE = 7
+        NOMINATIVE = 8
+        OBLIQUE = 9
+        PARTITIVE = 10
+        PREPOSITIONAL = 11
+        REFLEXIVE_CASE = 12
+        RELATIVE_CASE = 13
+        VOCATIVE = 14
+
+    class Form(enum.IntEnum):
+        """
+        Depending on the language, Form can be categorizing different forms of
+        verbs, adjectives, adverbs, etc. For example, categorizing inflected
+        endings of verbs and adjectives or distinguishing between short and long
+        forms of adjectives and participles
+
+        Attributes:
+          FORM_UNKNOWN (int): Form is not applicable in the analyzed language or is not predicted.
+          ADNOMIAL (int): Adnomial
+          AUXILIARY (int): Auxiliary
+          COMPLEMENTIZER (int): Complementizer
+          FINAL_ENDING (int): Final ending
+          GERUND (int): Gerund
+          REALIS (int): Realis
+          IRREALIS (int): Irrealis
+          SHORT (int): Short form
+          LONG (int): Long form
+          ORDER (int): Order form
+          SPECIFIC (int): Specific form
+        """
+
+        FORM_UNKNOWN = 0
+        ADNOMIAL = 1
+        AUXILIARY = 2
+        COMPLEMENTIZER = 3
+        FINAL_ENDING = 4
+        GERUND = 5
+        REALIS = 6
+        IRREALIS = 7
+        SHORT = 8
+        LONG = 9
+        ORDER = 10
+        SPECIFIC = 11
+
+    class Gender(enum.IntEnum):
+        """
+        Gender classes of nouns reflected in the behaviour of associated words.
+
+        Attributes:
+          GENDER_UNKNOWN (int): Gender is not applicable in the analyzed language or is not predicted.
+          FEMININE (int): Feminine
+          MASCULINE (int): Masculine
+          NEUTER (int): Neuter
+        """
+
+        GENDER_UNKNOWN = 0
+        FEMININE = 1
+        MASCULINE = 2
+        NEUTER = 3
+
+    class Mood(enum.IntEnum):
+        """
+        The grammatical feature of verbs, used for showing modality and attitude.
+
+        Attributes:
+          MOOD_UNKNOWN (int): Mood is not applicable in the analyzed language or is not predicted.
+          CONDITIONAL_MOOD (int): Conditional
+          IMPERATIVE (int): Imperative
+          INDICATIVE (int): Indicative
+          INTERROGATIVE (int): Interrogative
+          JUSSIVE (int): Jussive
+          SUBJUNCTIVE (int): Subjunctive
+        """
+
+        MOOD_UNKNOWN = 0
+        CONDITIONAL_MOOD = 1
+        IMPERATIVE = 2
+        INDICATIVE = 3
+        INTERROGATIVE = 4
+        JUSSIVE = 5
+        SUBJUNCTIVE = 6
+
+    class Number(enum.IntEnum):
+        """
+        Count distinctions.
+
+        Attributes:
+          NUMBER_UNKNOWN (int): Number is not applicable in the analyzed language or is not predicted.
+          SINGULAR (int): Singular
+          PLURAL (int): Plural
+          DUAL (int): Dual
+        """
+
+        NUMBER_UNKNOWN = 0
+        SINGULAR = 1
+        PLURAL = 2
+        DUAL = 3
+
+    class Person(enum.IntEnum):
+        """
+        The distinction between the speaker, second person, third person, etc.
+
+        Attributes:
+          PERSON_UNKNOWN (int): Person is not applicable in the analyzed language or is not predicted.
+          FIRST (int): First
+          SECOND (int): Second
+          THIRD (int): Third
+          REFLEXIVE_PERSON (int): Reflexive
+        """
+
+        PERSON_UNKNOWN = 0
+        FIRST = 1
+        SECOND = 2
+        THIRD = 3
+        REFLEXIVE_PERSON = 4
+
+    class Proper(enum.IntEnum):
+        """
+        This category shows if the token is part of a proper name.
+
+        Attributes:
+          PROPER_UNKNOWN (int): Proper is not applicable in the analyzed language or is not predicted.
+          PROPER (int): Proper
+          NOT_PROPER (int): Not proper
+        """
+
+        PROPER_UNKNOWN = 0
+        PROPER = 1
+        NOT_PROPER = 2
+
+    class Reciprocity(enum.IntEnum):
+        """
+        Reciprocal features of a pronoun.
+
+        Attributes:
+          RECIPROCITY_UNKNOWN (int): Reciprocity is not applicable in the analyzed language or is not
+          predicted.
+          RECIPROCAL (int): Reciprocal
+          NON_RECIPROCAL (int): Non-reciprocal
+        """
+
+        RECIPROCITY_UNKNOWN = 0
+        RECIPROCAL = 1
+        NON_RECIPROCAL = 2
+
+    class Tag(enum.IntEnum):
+        """
+        The part of speech tags enum.
+
+        Attributes:
+          UNKNOWN (int): Unknown
+          ADJ (int): Adjective
+          ADP (int): Adposition (preposition and postposition)
+          ADV (int): Adverb
+          CONJ (int): Conjunction
+          DET (int): Determiner
+          NOUN (int): Noun (common and proper)
+          NUM (int): Cardinal number
+          PRON (int): Pronoun
+          PRT (int): Particle or other function word
+          PUNCT (int): Punctuation
+          VERB (int): Verb (all tenses and modes)
+          X (int): Other: foreign words, typos, abbreviations
+          AFFIX (int): Affix
+        """
+
+        UNKNOWN = 0
+        ADJ = 1
+        ADP = 2
+        ADV = 3
+        CONJ = 4
+        DET = 5
+        NOUN = 6
+        NUM = 7
+        PRON = 8
+        PRT = 9
+        PUNCT = 10
+        VERB = 11
+        X = 12
+        AFFIX = 13
+
+    class Tense(enum.IntEnum):
+        """
+        Time reference.
+
+        Attributes:
+          TENSE_UNKNOWN (int): Tense is not applicable in the analyzed language or is not predicted.
+          CONDITIONAL_TENSE (int): Conditional
+          FUTURE (int): Future
+          PAST (int): Past
+          PRESENT (int): Present
+          IMPERFECT (int): Imperfect
+          PLUPERFECT (int): Pluperfect
+        """
+
+        TENSE_UNKNOWN = 0
+        CONDITIONAL_TENSE = 1
+        FUTURE = 2
+        PAST = 3
+        PRESENT = 4
+        IMPERFECT = 5
+        PLUPERFECT = 6
+
+    class Voice(enum.IntEnum):
+        """
+        The relationship between the action that a verb expresses and the
+        participants identified by its arguments.
+
+        Attributes:
+          VOICE_UNKNOWN (int): Voice is not applicable in the analyzed language or is not predicted.
+          ACTIVE (int): Active
+          CAUSATIVE (int): Causative
+          PASSIVE (int): Passive
+        """
+
+        VOICE_UNKNOWN = 0
+        ACTIVE = 1
+        CAUSATIVE = 2
+        PASSIVE = 3
diff --git a/language/google/cloud/language_v1beta2/gapic/language_service_client.py b/language/google/cloud/language_v1beta2/gapic/language_service_client.py
new file mode 100644
index 000000000000..dcb8e89d7fc6
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/gapic/language_service_client.py
@@ -0,0 +1,581 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.language.v1beta2 LanguageService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.language_v1beta2.gapic import enums
+from google.cloud.language_v1beta2.gapic import language_service_client_config
+from google.cloud.language_v1beta2.gapic.transports import (
+    language_service_grpc_transport,
+)
+from google.cloud.language_v1beta2.proto import language_service_pb2
+from google.cloud.language_v1beta2.proto import language_service_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-language").version
+
+
+class LanguageServiceClient(object):
+    """
+    Provides text analysis operations such as sentiment analysis and entity
+    recognition.
+    """
+
+    SERVICE_ADDRESS = "language.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.language.v1beta2.LanguageService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            LanguageServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.LanguageServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.LanguageServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = language_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=language_service_grpc_transport.LanguageServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = language_service_grpc_transport.LanguageServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def analyze_sentiment(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Analyzes the sentiment of the provided text.
+
+        Example:
+            >>> from google.cloud import language_v1beta2
+            >>>
+            >>> client = language_v1beta2.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_sentiment(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1beta2.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Document`
+            encoding_type (~google.cloud.language_v1beta2.enums.EncodingType): The encoding type used by the API to calculate sentence offsets for the
+                sentence sentiment.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1beta2.types.AnalyzeSentimentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_sentiment" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_sentiment"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_sentiment,
+                default_retry=self._method_configs["AnalyzeSentiment"].retry,
+                default_timeout=self._method_configs["AnalyzeSentiment"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeSentimentRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_sentiment"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def analyze_entities(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Finds named entities (currently proper names and common nouns) in the text
+        along with entity types, salience, mentions for each entity, and
+        other properties.
+
+        Example:
+            >>> from google.cloud import language_v1beta2
+            >>>
+            >>> client = language_v1beta2.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_entities(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1beta2.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Document`
+            encoding_type (~google.cloud.language_v1beta2.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1beta2.types.AnalyzeEntitiesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_entities" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_entities"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_entities,
+                default_retry=self._method_configs["AnalyzeEntities"].retry,
+                default_timeout=self._method_configs["AnalyzeEntities"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeEntitiesRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_entities"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def analyze_entity_sentiment(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Finds entities, similar to ``AnalyzeEntities`` in the text and analyzes
+        sentiment associated with each entity and its mentions.
+
+        Example:
+            >>> from google.cloud import language_v1beta2
+            >>>
+            >>> client = language_v1beta2.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_entity_sentiment(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1beta2.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Document`
+            encoding_type (~google.cloud.language_v1beta2.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1beta2.types.AnalyzeEntitySentimentResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_entity_sentiment" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_entity_sentiment"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_entity_sentiment,
+                default_retry=self._method_configs["AnalyzeEntitySentiment"].retry,
+                default_timeout=self._method_configs["AnalyzeEntitySentiment"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeEntitySentimentRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_entity_sentiment"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def analyze_syntax(
+        self,
+        document,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Analyzes the syntax of the text and provides sentence boundaries and
+        tokenization along with part of speech tags, dependency trees, and other
+        properties.
+
+        Example:
+            >>> from google.cloud import language_v1beta2
+            >>>
+            >>> client = language_v1beta2.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.analyze_syntax(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1beta2.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Document`
+            encoding_type (~google.cloud.language_v1beta2.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1beta2.types.AnalyzeSyntaxResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "analyze_syntax" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "analyze_syntax"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.analyze_syntax,
+                default_retry=self._method_configs["AnalyzeSyntax"].retry,
+                default_timeout=self._method_configs["AnalyzeSyntax"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnalyzeSyntaxRequest(
+            document=document, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["analyze_syntax"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def classify_text(
+        self,
+        document,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Classifies a document into categories.
+
+        Example:
+            >>> from google.cloud import language_v1beta2
+            >>>
+            >>> client = language_v1beta2.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> response = client.classify_text(document)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1beta2.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Document`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1beta2.types.ClassifyTextResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "classify_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "classify_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.classify_text,
+                default_retry=self._method_configs["ClassifyText"].retry,
+                default_timeout=self._method_configs["ClassifyText"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.ClassifyTextRequest(document=document)
+        return self._inner_api_calls["classify_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def annotate_text(
+        self,
+        document,
+        features,
+        encoding_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        A convenience method that provides all syntax, sentiment, entity, and
+        classification features in one call.
+
+        Example:
+            >>> from google.cloud import language_v1beta2
+            >>>
+            >>> client = language_v1beta2.LanguageServiceClient()
+            >>>
+            >>> # TODO: Initialize `document`:
+            >>> document = {}
+            >>>
+            >>> # TODO: Initialize `features`:
+            >>> features = {}
+            >>>
+            >>> response = client.annotate_text(document, features)
+
+        Args:
+            document (Union[dict, ~google.cloud.language_v1beta2.types.Document]): Input document.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Document`
+            features (Union[dict, ~google.cloud.language_v1beta2.types.Features]): The enabled features.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.language_v1beta2.types.Features`
+            encoding_type (~google.cloud.language_v1beta2.enums.EncodingType): The encoding type used by the API to calculate offsets.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.language_v1beta2.types.AnnotateTextResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_text,
+                default_retry=self._method_configs["AnnotateText"].retry,
+                default_timeout=self._method_configs["AnnotateText"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = language_service_pb2.AnnotateTextRequest(
+            document=document, features=features, encoding_type=encoding_type
+        )
+        return self._inner_api_calls["annotate_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/language/google/cloud/language_v1beta2/gapic/language_service_client_config.py b/language/google/cloud/language_v1beta2/gapic/language_service_client_config.py
new file mode 100644
index 000000000000..97ab1aa63434
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/gapic/language_service_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.language.v1beta2.LanguageService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnalyzeSentiment": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnalyzeEntities": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnalyzeEntitySentiment": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnalyzeSyntax": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ClassifyText": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AnnotateText": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/language/google/cloud/language_v1beta2/gapic/transports/__init__.py b/language/google/cloud/language_v1beta2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/google/cloud/language_v1beta2/gapic/transports/language_service_grpc_transport.py b/language/google/cloud/language_v1beta2/gapic/transports/language_service_grpc_transport.py
new file mode 100644
index 000000000000..df140c2f25f3
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/gapic/transports/language_service_grpc_transport.py
@@ -0,0 +1,194 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.language_v1beta2.proto import language_service_pb2_grpc
+
+
+class LanguageServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.language.v1beta2 LanguageService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="language.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "language_service_stub": language_service_pb2_grpc.LanguageServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="language.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def analyze_sentiment(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_sentiment`.
+
+        Analyzes the sentiment of the provided text.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeSentiment
+
+    @property
+    def analyze_entities(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_entities`.
+
+        Finds named entities (currently proper names and common nouns) in the text
+        along with entity types, salience, mentions for each entity, and
+        other properties.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeEntities
+
+    @property
+    def analyze_entity_sentiment(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_entity_sentiment`.
+
+        Finds entities, similar to ``AnalyzeEntities`` in the text and analyzes
+        sentiment associated with each entity and its mentions.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeEntitySentiment
+
+    @property
+    def analyze_syntax(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.analyze_syntax`.
+
+        Analyzes the syntax of the text and provides sentence boundaries and
+        tokenization along with part of speech tags, dependency trees, and other
+        properties.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnalyzeSyntax
+
+    @property
+    def classify_text(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.classify_text`.
+
+        Classifies a document into categories.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].ClassifyText
+
+    @property
+    def annotate_text(self):
+        """Return the gRPC stub for :meth:`LanguageServiceClient.annotate_text`.
+
+        A convenience method that provides all syntax, sentiment, entity, and
+        classification features in one call.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["language_service_stub"].AnnotateText
diff --git a/language/google/cloud/language_v1beta2/proto/__init__.py b/language/google/cloud/language_v1beta2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/google/cloud/language_v1beta2/proto/language_service.proto b/language/google/cloud/language_v1beta2/proto/language_service.proto
new file mode 100644
index 000000000000..0263be04aedd
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/proto/language_service.proto
@@ -0,0 +1,1069 @@
+// 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.language.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.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;
+option java_outer_classname = "LanguageServiceProto";
+option java_package = "com.google.cloud.language.v1beta2";
+
+// Provides text analysis operations such as sentiment analysis and entity
+// recognition.
+service LanguageService {
+  // Analyzes the sentiment of the provided text.
+  rpc AnalyzeSentiment(AnalyzeSentimentRequest)
+      returns (AnalyzeSentimentResponse) {
+    option (google.api.http) = {
+      post: "/v1beta2/documents:analyzeSentiment"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1beta2/documents:analyzeEntities"
+      body: "*"
+    };
+  }
+
+  // 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: "*"
+    };
+  }
+
+  // Analyzes the syntax of the text and provides sentence boundaries and
+  // 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: "*"
+    };
+  }
+
+  // Classifies a document into categories.
+  rpc ClassifyText(ClassifyTextRequest) returns (ClassifyTextResponse) {
+    option (google.api.http) = {
+      post: "/v1beta2/documents:classifyText"
+      body: "*"
+    };
+  }
+
+  // A convenience method that provides all syntax, sentiment, entity, and
+  // classification features in one call.
+  rpc AnnotateText(AnnotateTextRequest) returns (AnnotateTextResponse) {
+    option (google.api.http) = {
+      post: "/v1beta2/documents:annotateText"
+      body: "*"
+    };
+  }
+}
+
+// ################################################################ #
+//
+// Represents the input to API methods.
+message Document {
+  // The document types enum.
+  enum Type {
+    // The content type is not specified.
+    TYPE_UNSPECIFIED = 0;
+
+    // Plain text
+    PLAIN_TEXT = 1;
+
+    // HTML
+    HTML = 2;
+  }
+
+  // Required. If the type is not set or is `TYPE_UNSPECIFIED`,
+  // returns an `INVALID_ARGUMENT` error.
+  Type type = 1;
+
+  // The source of the document: a string containing the content or a
+  // Google Cloud Storage URI.
+  oneof source {
+    // The content of the input in string format.
+    string content = 2;
+
+    // The Google Cloud Storage URI where the file content is located.
+    // This URI must be of the form: gs://bucket_name/object_name. For more
+    // details, see https://cloud.google.com/storage/docs/reference-uris.
+    // NOTE: Cloud Storage object versioning is not supported.
+    string gcs_content_uri = 3;
+  }
+
+  // The language of the document (if not specified, the language is
+  // automatically detected). Both ISO and BCP-47 language codes are
+  // accepted.<br>
+  // [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.
+  string language = 4;
+}
+
+// Represents a sentence in the input document.
+message Sentence {
+  // The sentence text.
+  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.
+  Sentiment sentiment = 2;
+}
+
+// Represents a phrase in the text that is a known entity, such as
+// a person, an organization, or location. The API associates information, such
+// as salience and mentions, with entities.
+message Entity {
+  // The type of the entity.
+  enum Type {
+    // Unknown
+    UNKNOWN = 0;
+
+    // Person
+    PERSON = 1;
+
+    // Location
+    LOCATION = 2;
+
+    // Organization
+    ORGANIZATION = 3;
+
+    // Event
+    EVENT = 4;
+
+    // Work of art
+    WORK_OF_ART = 5;
+
+    // Consumer goods
+    CONSUMER_GOOD = 6;
+
+    // Other types
+    OTHER = 7;
+  }
+
+  // The representative name for the entity.
+  string name = 1;
+
+  // The entity type.
+  Type type = 2;
+
+  // 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.
+  map<string, string> metadata = 3;
+
+  // The salience score associated with the entity in the [0, 1.0] range.
+  //
+  // The salience score for an entity provides information about the
+  // importance or centrality of that entity to the entire document text.
+  // Scores closer to 0 are less salient, while scores closer to 1.0 are highly
+  // salient.
+  float salience = 4;
+
+  // The mentions of this entity in the input document. The API currently
+  // supports proper noun mentions.
+  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.
+  Sentiment sentiment = 6;
+}
+
+// Represents the smallest syntactic building block of the text.
+message Token {
+  // The token text.
+  TextSpan text = 1;
+
+  // Parts of speech tag for this token.
+  PartOfSpeech part_of_speech = 2;
+
+  // Dependency tree parse for this token.
+  DependencyEdge dependency_edge = 3;
+
+  // [Lemma](https://en.wikipedia.org/wiki/Lemma_%28morphology%29) of the token.
+  string lemma = 4;
+}
+
+// Represents the feeling associated with the entire text or entities in
+// the text.
+message Sentiment {
+  // A non-negative number in the [0, +inf) range, which represents
+  // the absolute magnitude of sentiment regardless of score (positive or
+  // negative).
+  float magnitude = 2;
+
+  // Sentiment score between -1.0 (negative sentiment) and 1.0
+  // (positive sentiment).
+  float score = 3;
+}
+
+// Represents part of speech information for a token.
+message PartOfSpeech {
+  // The part of speech tags enum.
+  enum Tag {
+    // Unknown
+    UNKNOWN = 0;
+
+    // Adjective
+    ADJ = 1;
+
+    // Adposition (preposition and postposition)
+    ADP = 2;
+
+    // Adverb
+    ADV = 3;
+
+    // Conjunction
+    CONJ = 4;
+
+    // Determiner
+    DET = 5;
+
+    // Noun (common and proper)
+    NOUN = 6;
+
+    // Cardinal number
+    NUM = 7;
+
+    // Pronoun
+    PRON = 8;
+
+    // Particle or other function word
+    PRT = 9;
+
+    // Punctuation
+    PUNCT = 10;
+
+    // Verb (all tenses and modes)
+    VERB = 11;
+
+    // Other: foreign words, typos, abbreviations
+    X = 12;
+
+    // Affix
+    AFFIX = 13;
+  }
+
+  // The characteristic of a verb that expresses time flow during an event.
+  enum Aspect {
+    // Aspect is not applicable in the analyzed language or is not predicted.
+    ASPECT_UNKNOWN = 0;
+
+    // Perfective
+    PERFECTIVE = 1;
+
+    // Imperfective
+    IMPERFECTIVE = 2;
+
+    // Progressive
+    PROGRESSIVE = 3;
+  }
+
+  // The grammatical function performed by a noun or pronoun in a phrase,
+  // clause, or sentence. In some languages, other parts of speech, such as
+  // adjective and determiner, take case inflection in agreement with the noun.
+  enum Case {
+    // Case is not applicable in the analyzed language or is not predicted.
+    CASE_UNKNOWN = 0;
+
+    // Accusative
+    ACCUSATIVE = 1;
+
+    // Adverbial
+    ADVERBIAL = 2;
+
+    // Complementive
+    COMPLEMENTIVE = 3;
+
+    // Dative
+    DATIVE = 4;
+
+    // Genitive
+    GENITIVE = 5;
+
+    // Instrumental
+    INSTRUMENTAL = 6;
+
+    // Locative
+    LOCATIVE = 7;
+
+    // Nominative
+    NOMINATIVE = 8;
+
+    // Oblique
+    OBLIQUE = 9;
+
+    // Partitive
+    PARTITIVE = 10;
+
+    // Prepositional
+    PREPOSITIONAL = 11;
+
+    // Reflexive
+    REFLEXIVE_CASE = 12;
+
+    // Relative
+    RELATIVE_CASE = 13;
+
+    // Vocative
+    VOCATIVE = 14;
+  }
+
+  // Depending on the language, Form can be categorizing different forms of
+  // verbs, adjectives, adverbs, etc. For example, categorizing inflected
+  // endings of verbs and adjectives or distinguishing between short and long
+  // forms of adjectives and participles
+  enum Form {
+    // Form is not applicable in the analyzed language or is not predicted.
+    FORM_UNKNOWN = 0;
+
+    // Adnomial
+    ADNOMIAL = 1;
+
+    // Auxiliary
+    AUXILIARY = 2;
+
+    // Complementizer
+    COMPLEMENTIZER = 3;
+
+    // Final ending
+    FINAL_ENDING = 4;
+
+    // Gerund
+    GERUND = 5;
+
+    // Realis
+    REALIS = 6;
+
+    // Irrealis
+    IRREALIS = 7;
+
+    // Short form
+    SHORT = 8;
+
+    // Long form
+    LONG = 9;
+
+    // Order form
+    ORDER = 10;
+
+    // Specific form
+    SPECIFIC = 11;
+  }
+
+  // Gender classes of nouns reflected in the behaviour of associated words.
+  enum Gender {
+    // Gender is not applicable in the analyzed language or is not predicted.
+    GENDER_UNKNOWN = 0;
+
+    // Feminine
+    FEMININE = 1;
+
+    // Masculine
+    MASCULINE = 2;
+
+    // Neuter
+    NEUTER = 3;
+  }
+
+  // The grammatical feature of verbs, used for showing modality and attitude.
+  enum Mood {
+    // Mood is not applicable in the analyzed language or is not predicted.
+    MOOD_UNKNOWN = 0;
+
+    // Conditional
+    CONDITIONAL_MOOD = 1;
+
+    // Imperative
+    IMPERATIVE = 2;
+
+    // Indicative
+    INDICATIVE = 3;
+
+    // Interrogative
+    INTERROGATIVE = 4;
+
+    // Jussive
+    JUSSIVE = 5;
+
+    // Subjunctive
+    SUBJUNCTIVE = 6;
+  }
+
+  // Count distinctions.
+  enum Number {
+    // Number is not applicable in the analyzed language or is not predicted.
+    NUMBER_UNKNOWN = 0;
+
+    // Singular
+    SINGULAR = 1;
+
+    // Plural
+    PLURAL = 2;
+
+    // Dual
+    DUAL = 3;
+  }
+
+  // The distinction between the speaker, second person, third person, etc.
+  enum Person {
+    // Person is not applicable in the analyzed language or is not predicted.
+    PERSON_UNKNOWN = 0;
+
+    // First
+    FIRST = 1;
+
+    // Second
+    SECOND = 2;
+
+    // Third
+    THIRD = 3;
+
+    // Reflexive
+    REFLEXIVE_PERSON = 4;
+  }
+
+  // This category shows if the token is part of a proper name.
+  enum Proper {
+    // Proper is not applicable in the analyzed language or is not predicted.
+    PROPER_UNKNOWN = 0;
+
+    // Proper
+    PROPER = 1;
+
+    // Not proper
+    NOT_PROPER = 2;
+  }
+
+  // Reciprocal features of a pronoun.
+  enum Reciprocity {
+    // Reciprocity is not applicable in the analyzed language or is not
+    // predicted.
+    RECIPROCITY_UNKNOWN = 0;
+
+    // Reciprocal
+    RECIPROCAL = 1;
+
+    // Non-reciprocal
+    NON_RECIPROCAL = 2;
+  }
+
+  // Time reference.
+  enum Tense {
+    // Tense is not applicable in the analyzed language or is not predicted.
+    TENSE_UNKNOWN = 0;
+
+    // Conditional
+    CONDITIONAL_TENSE = 1;
+
+    // Future
+    FUTURE = 2;
+
+    // Past
+    PAST = 3;
+
+    // Present
+    PRESENT = 4;
+
+    // Imperfect
+    IMPERFECT = 5;
+
+    // Pluperfect
+    PLUPERFECT = 6;
+  }
+
+  // The relationship between the action that a verb expresses and the
+  // participants identified by its arguments.
+  enum Voice {
+    // Voice is not applicable in the analyzed language or is not predicted.
+    VOICE_UNKNOWN = 0;
+
+    // Active
+    ACTIVE = 1;
+
+    // Causative
+    CAUSATIVE = 2;
+
+    // Passive
+    PASSIVE = 3;
+  }
+
+  // The part of speech tag.
+  Tag tag = 1;
+
+  // The grammatical aspect.
+  Aspect aspect = 2;
+
+  // The grammatical case.
+  Case case = 3;
+
+  // The grammatical form.
+  Form form = 4;
+
+  // The grammatical gender.
+  Gender gender = 5;
+
+  // The grammatical mood.
+  Mood mood = 6;
+
+  // The grammatical number.
+  Number number = 7;
+
+  // The grammatical person.
+  Person person = 8;
+
+  // The grammatical properness.
+  Proper proper = 9;
+
+  // The grammatical reciprocity.
+  Reciprocity reciprocity = 10;
+
+  // The grammatical tense.
+  Tense tense = 11;
+
+  // The grammatical voice.
+  Voice voice = 12;
+}
+
+// Represents dependency parse tree information for a token.
+message DependencyEdge {
+  // The parse label enum for the token.
+  enum Label {
+    // Unknown
+    UNKNOWN = 0;
+
+    // Abbreviation modifier
+    ABBREV = 1;
+
+    // Adjectival complement
+    ACOMP = 2;
+
+    // Adverbial clause modifier
+    ADVCL = 3;
+
+    // Adverbial modifier
+    ADVMOD = 4;
+
+    // Adjectival modifier of an NP
+    AMOD = 5;
+
+    // Appositional modifier of an NP
+    APPOS = 6;
+
+    // Attribute dependent of a copular verb
+    ATTR = 7;
+
+    // Auxiliary (non-main) verb
+    AUX = 8;
+
+    // Passive auxiliary
+    AUXPASS = 9;
+
+    // Coordinating conjunction
+    CC = 10;
+
+    // Clausal complement of a verb or adjective
+    CCOMP = 11;
+
+    // Conjunct
+    CONJ = 12;
+
+    // Clausal subject
+    CSUBJ = 13;
+
+    // Clausal passive subject
+    CSUBJPASS = 14;
+
+    // Dependency (unable to determine)
+    DEP = 15;
+
+    // Determiner
+    DET = 16;
+
+    // Discourse
+    DISCOURSE = 17;
+
+    // Direct object
+    DOBJ = 18;
+
+    // Expletive
+    EXPL = 19;
+
+    // Goes with (part of a word in a text not well edited)
+    GOESWITH = 20;
+
+    // Indirect object
+    IOBJ = 21;
+
+    // Marker (word introducing a subordinate clause)
+    MARK = 22;
+
+    // Multi-word expression
+    MWE = 23;
+
+    // Multi-word verbal expression
+    MWV = 24;
+
+    // Negation modifier
+    NEG = 25;
+
+    // Noun compound modifier
+    NN = 26;
+
+    // Noun phrase used as an adverbial modifier
+    NPADVMOD = 27;
+
+    // Nominal subject
+    NSUBJ = 28;
+
+    // Passive nominal subject
+    NSUBJPASS = 29;
+
+    // Numeric modifier of a noun
+    NUM = 30;
+
+    // Element of compound number
+    NUMBER = 31;
+
+    // Punctuation mark
+    P = 32;
+
+    // Parataxis relation
+    PARATAXIS = 33;
+
+    // Participial modifier
+    PARTMOD = 34;
+
+    // The complement of a preposition is a clause
+    PCOMP = 35;
+
+    // Object of a preposition
+    POBJ = 36;
+
+    // Possession modifier
+    POSS = 37;
+
+    // Postverbal negative particle
+    POSTNEG = 38;
+
+    // Predicate complement
+    PRECOMP = 39;
+
+    // Preconjunt
+    PRECONJ = 40;
+
+    // Predeterminer
+    PREDET = 41;
+
+    // Prefix
+    PREF = 42;
+
+    // Prepositional modifier
+    PREP = 43;
+
+    // The relationship between a verb and verbal morpheme
+    PRONL = 44;
+
+    // Particle
+    PRT = 45;
+
+    // Associative or possessive marker
+    PS = 46;
+
+    // Quantifier phrase modifier
+    QUANTMOD = 47;
+
+    // Relative clause modifier
+    RCMOD = 48;
+
+    // Complementizer in relative clause
+    RCMODREL = 49;
+
+    // Ellipsis without a preceding predicate
+    RDROP = 50;
+
+    // Referent
+    REF = 51;
+
+    // Remnant
+    REMNANT = 52;
+
+    // Reparandum
+    REPARANDUM = 53;
+
+    // Root
+    ROOT = 54;
+
+    // Suffix specifying a unit of number
+    SNUM = 55;
+
+    // Suffix
+    SUFF = 56;
+
+    // Temporal modifier
+    TMOD = 57;
+
+    // Topic marker
+    TOPIC = 58;
+
+    // Clause headed by an infinite form of the verb that modifies a noun
+    VMOD = 59;
+
+    // Vocative
+    VOCATIVE = 60;
+
+    // Open clausal complement
+    XCOMP = 61;
+
+    // Name suffix
+    SUFFIX = 62;
+
+    // Name title
+    TITLE = 63;
+
+    // Adverbial phrase modifier
+    ADVPHMOD = 64;
+
+    // Causative auxiliary
+    AUXCAUS = 65;
+
+    // Helper auxiliary
+    AUXVV = 66;
+
+    // Rentaishi (Prenominal modifier)
+    DTMOD = 67;
+
+    // Foreign words
+    FOREIGN = 68;
+
+    // Keyword
+    KW = 69;
+
+    // List for chains of comparable items
+    LIST = 70;
+
+    // Nominalized clause
+    NOMC = 71;
+
+    // Nominalized clausal subject
+    NOMCSUBJ = 72;
+
+    // Nominalized clausal passive
+    NOMCSUBJPASS = 73;
+
+    // Compound of numeric modifier
+    NUMC = 74;
+
+    // Copula
+    COP = 75;
+
+    // Dislocated relation (for fronted/topicalized elements)
+    DISLOCATED = 76;
+
+    // Aspect marker
+    ASP = 77;
+
+    // Genitive modifier
+    GMOD = 78;
+
+    // Genitive object
+    GOBJ = 79;
+
+    // Infinitival modifier
+    INFMOD = 80;
+
+    // Measure
+    MES = 81;
+
+    // Nominal complement of a noun
+    NCOMP = 82;
+  }
+
+  // Represents the head of this token in the dependency tree.
+  // This is the index of the token which has an arc going to this token.
+  // The index is the position of the token in the array of tokens returned
+  // by the API method. If this token is a root token, then the
+  // `head_token_index` is its own index.
+  int32 head_token_index = 1;
+
+  // The parse label for the token.
+  Label label = 2;
+}
+
+// Represents a mention for an entity in the text. Currently, proper noun
+// mentions are supported.
+message EntityMention {
+  // The supported types of mentions.
+  enum Type {
+    // Unknown
+    TYPE_UNKNOWN = 0;
+
+    // Proper name
+    PROPER = 1;
+
+    // Common noun (or noun compound)
+    COMMON = 2;
+  }
+
+  // The mention text.
+  TextSpan text = 1;
+
+  // The type of the entity mention.
+  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.
+  Sentiment sentiment = 3;
+}
+
+// Represents an output piece of text.
+message TextSpan {
+  // The content of the output text.
+  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.
+  int32 begin_offset = 2;
+}
+
+// Represents a category returned from the text classifier.
+message ClassificationCategory {
+  // The name of the category representing the document.
+  string name = 1;
+
+  // The classifier's confidence of the category. Number represents how certain
+  // the classifier is that this category represents the given text.
+  float confidence = 2;
+}
+
+// The sentiment analysis request message.
+message AnalyzeSentimentRequest {
+  // Input document.
+  Document document = 1;
+
+  // The encoding type used by the API to calculate sentence offsets for the
+  // sentence sentiment.
+  EncodingType encoding_type = 2;
+}
+
+// The sentiment analysis response message.
+message AnalyzeSentimentResponse {
+  // The overall sentiment of the input document.
+  Sentiment document_sentiment = 1;
+
+  // 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.
+  string language = 2;
+
+  // The sentiment for all the sentences in the document.
+  repeated Sentence sentences = 3;
+}
+
+// The entity-level sentiment analysis request message.
+message AnalyzeEntitySentimentRequest {
+  // Input document.
+  Document document = 1;
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The entity-level sentiment analysis response message.
+message AnalyzeEntitySentimentResponse {
+  // The recognized entities in the input document with associated sentiments.
+  repeated Entity entities = 1;
+
+  // 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.
+  string language = 2;
+}
+
+// The entity analysis request message.
+message AnalyzeEntitiesRequest {
+  // Input document.
+  Document document = 1;
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The entity analysis response message.
+message AnalyzeEntitiesResponse {
+  // The recognized entities in the input document.
+  repeated Entity entities = 1;
+
+  // 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.
+  string language = 2;
+}
+
+// The syntax analysis request message.
+message AnalyzeSyntaxRequest {
+  // Input document.
+  Document document = 1;
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 2;
+}
+
+// The syntax analysis response message.
+message AnalyzeSyntaxResponse {
+  // Sentences in the input document.
+  repeated Sentence sentences = 1;
+
+  // Tokens, along with their syntactic information, in the input document.
+  repeated Token tokens = 2;
+
+  // 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.
+  string language = 3;
+}
+
+// The document classification request message.
+message ClassifyTextRequest {
+  // Input document.
+  Document document = 1;
+}
+
+// The document classification response message.
+message ClassifyTextResponse {
+  // Categories representing the input document.
+  repeated ClassificationCategory categories = 1;
+}
+
+// The request message for the text annotation API, which can perform multiple
+// analysis types (sentiment, entities, and syntax) in one call.
+message AnnotateTextRequest {
+  // All available features for sentiment, syntax, and semantic analysis.
+  // Setting each one to true will enable that specific analysis for the input.
+  message Features {
+    // Extract syntax information.
+    bool extract_syntax = 1;
+
+    // Extract entities.
+    bool extract_entities = 2;
+
+    // Extract document-level sentiment.
+    bool extract_document_sentiment = 3;
+
+    // Extract entities and their associated sentiment.
+    bool extract_entity_sentiment = 4;
+
+    // Classify the full document into categories.
+    bool classify_text = 6;
+  }
+
+  // Input document.
+  Document document = 1;
+
+  // The enabled features.
+  Features features = 2;
+
+  // The encoding type used by the API to calculate offsets.
+  EncodingType encoding_type = 3;
+}
+
+// The text annotations response message.
+message AnnotateTextResponse {
+  // Sentences in the input document. Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_syntax][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_syntax].
+  repeated Sentence sentences = 1;
+
+  // Tokens, along with their syntactic information, in the input document.
+  // Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_syntax][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_syntax].
+  repeated Token tokens = 2;
+
+  // Entities, along with their semantic information, in the input document.
+  // Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_entities][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entities].
+  repeated Entity entities = 3;
+
+  // The overall sentiment for the document. Populated if the user enables
+  // [AnnotateTextRequest.Features.extract_document_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_document_sentiment].
+  Sentiment document_sentiment = 4;
+
+  // 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.
+  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/language/google/cloud/language_v1beta2/proto/language_service_pb2.py b/language/google/cloud/language_v1beta2/proto/language_service_pb2.py
new file mode 100644
index 000000000000..6e2ce20c6b5e
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/proto/language_service_pb2.py
@@ -0,0 +1,3555 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/language_v1beta2/proto/language_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/language_v1beta2/proto/language_service.proto",
+    package="google.cloud.language.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.language.v1beta2B\024LanguageServiceProtoP\001ZEgoogle.golang.org/genproto/googleapis/cloud/language/v1beta2;language"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/language_v1beta2/proto/language_service.proto\x12\x1dgoogle.cloud.language.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xc8\x01\n\x08\x44ocument\x12:\n\x04type\x18\x01 \x01(\x0e\x32,.google.cloud.language.v1beta2.Document.Type\x12\x11\n\x07\x63ontent\x18\x02 \x01(\tH\x00\x12\x19\n\x0fgcs_content_uri\x18\x03 \x01(\tH\x00\x12\x10\n\x08language\x18\x04 \x01(\t"6\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nPLAIN_TEXT\x10\x01\x12\x08\n\x04HTML\x10\x02\x42\x08\n\x06source"~\n\x08Sentence\x12\x35\n\x04text\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.TextSpan\x12;\n\tsentiment\x18\x02 \x01(\x0b\x32(.google.cloud.language.v1beta2.Sentiment"\xd2\x03\n\x06\x45ntity\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x38\n\x04type\x18\x02 \x01(\x0e\x32*.google.cloud.language.v1beta2.Entity.Type\x12\x45\n\x08metadata\x18\x03 \x03(\x0b\x32\x33.google.cloud.language.v1beta2.Entity.MetadataEntry\x12\x10\n\x08salience\x18\x04 \x01(\x02\x12>\n\x08mentions\x18\x05 \x03(\x0b\x32,.google.cloud.language.v1beta2.EntityMention\x12;\n\tsentiment\x18\x06 \x01(\x0b\x32(.google.cloud.language.v1beta2.Sentiment\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"y\n\x04Type\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06PERSON\x10\x01\x12\x0c\n\x08LOCATION\x10\x02\x12\x10\n\x0cORGANIZATION\x10\x03\x12\t\n\x05\x45VENT\x10\x04\x12\x0f\n\x0bWORK_OF_ART\x10\x05\x12\x11\n\rCONSUMER_GOOD\x10\x06\x12\t\n\x05OTHER\x10\x07"\xda\x01\n\x05Token\x12\x35\n\x04text\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.TextSpan\x12\x43\n\x0epart_of_speech\x18\x02 \x01(\x0b\x32+.google.cloud.language.v1beta2.PartOfSpeech\x12\x46\n\x0f\x64\x65pendency_edge\x18\x03 \x01(\x0b\x32-.google.cloud.language.v1beta2.DependencyEdge\x12\r\n\x05lemma\x18\x04 \x01(\t"-\n\tSentiment\x12\x11\n\tmagnitude\x18\x02 \x01(\x02\x12\r\n\x05score\x18\x03 \x01(\x02"\xdf\x10\n\x0cPartOfSpeech\x12<\n\x03tag\x18\x01 \x01(\x0e\x32/.google.cloud.language.v1beta2.PartOfSpeech.Tag\x12\x42\n\x06\x61spect\x18\x02 \x01(\x0e\x32\x32.google.cloud.language.v1beta2.PartOfSpeech.Aspect\x12>\n\x04\x63\x61se\x18\x03 \x01(\x0e\x32\x30.google.cloud.language.v1beta2.PartOfSpeech.Case\x12>\n\x04\x66orm\x18\x04 \x01(\x0e\x32\x30.google.cloud.language.v1beta2.PartOfSpeech.Form\x12\x42\n\x06gender\x18\x05 \x01(\x0e\x32\x32.google.cloud.language.v1beta2.PartOfSpeech.Gender\x12>\n\x04mood\x18\x06 \x01(\x0e\x32\x30.google.cloud.language.v1beta2.PartOfSpeech.Mood\x12\x42\n\x06number\x18\x07 \x01(\x0e\x32\x32.google.cloud.language.v1beta2.PartOfSpeech.Number\x12\x42\n\x06person\x18\x08 \x01(\x0e\x32\x32.google.cloud.language.v1beta2.PartOfSpeech.Person\x12\x42\n\x06proper\x18\t \x01(\x0e\x32\x32.google.cloud.language.v1beta2.PartOfSpeech.Proper\x12L\n\x0breciprocity\x18\n \x01(\x0e\x32\x37.google.cloud.language.v1beta2.PartOfSpeech.Reciprocity\x12@\n\x05tense\x18\x0b \x01(\x0e\x32\x31.google.cloud.language.v1beta2.PartOfSpeech.Tense\x12@\n\x05voice\x18\x0c \x01(\x0e\x32\x31.google.cloud.language.v1beta2.PartOfSpeech.Voice"\x8d\x01\n\x03Tag\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x07\n\x03\x41\x44J\x10\x01\x12\x07\n\x03\x41\x44P\x10\x02\x12\x07\n\x03\x41\x44V\x10\x03\x12\x08\n\x04\x43ONJ\x10\x04\x12\x07\n\x03\x44\x45T\x10\x05\x12\x08\n\x04NOUN\x10\x06\x12\x07\n\x03NUM\x10\x07\x12\x08\n\x04PRON\x10\x08\x12\x07\n\x03PRT\x10\t\x12\t\n\x05PUNCT\x10\n\x12\x08\n\x04VERB\x10\x0b\x12\x05\n\x01X\x10\x0c\x12\t\n\x05\x41\x46\x46IX\x10\r"O\n\x06\x41spect\x12\x12\n\x0e\x41SPECT_UNKNOWN\x10\x00\x12\x0e\n\nPERFECTIVE\x10\x01\x12\x10\n\x0cIMPERFECTIVE\x10\x02\x12\x0f\n\x0bPROGRESSIVE\x10\x03"\xf8\x01\n\x04\x43\x61se\x12\x10\n\x0c\x43\x41SE_UNKNOWN\x10\x00\x12\x0e\n\nACCUSATIVE\x10\x01\x12\r\n\tADVERBIAL\x10\x02\x12\x11\n\rCOMPLEMENTIVE\x10\x03\x12\n\n\x06\x44\x41TIVE\x10\x04\x12\x0c\n\x08GENITIVE\x10\x05\x12\x10\n\x0cINSTRUMENTAL\x10\x06\x12\x0c\n\x08LOCATIVE\x10\x07\x12\x0e\n\nNOMINATIVE\x10\x08\x12\x0b\n\x07OBLIQUE\x10\t\x12\r\n\tPARTITIVE\x10\n\x12\x11\n\rPREPOSITIONAL\x10\x0b\x12\x12\n\x0eREFLEXIVE_CASE\x10\x0c\x12\x11\n\rRELATIVE_CASE\x10\r\x12\x0c\n\x08VOCATIVE\x10\x0e"\xaf\x01\n\x04\x46orm\x12\x10\n\x0c\x46ORM_UNKNOWN\x10\x00\x12\x0c\n\x08\x41\x44NOMIAL\x10\x01\x12\r\n\tAUXILIARY\x10\x02\x12\x12\n\x0e\x43OMPLEMENTIZER\x10\x03\x12\x10\n\x0c\x46INAL_ENDING\x10\x04\x12\n\n\x06GERUND\x10\x05\x12\n\n\x06REALIS\x10\x06\x12\x0c\n\x08IRREALIS\x10\x07\x12\t\n\x05SHORT\x10\x08\x12\x08\n\x04LONG\x10\t\x12\t\n\x05ORDER\x10\n\x12\x0c\n\x08SPECIFIC\x10\x0b"E\n\x06Gender\x12\x12\n\x0eGENDER_UNKNOWN\x10\x00\x12\x0c\n\x08\x46\x45MININE\x10\x01\x12\r\n\tMASCULINE\x10\x02\x12\n\n\x06NEUTER\x10\x03"\x7f\n\x04Mood\x12\x10\n\x0cMOOD_UNKNOWN\x10\x00\x12\x14\n\x10\x43ONDITIONAL_MOOD\x10\x01\x12\x0e\n\nIMPERATIVE\x10\x02\x12\x0e\n\nINDICATIVE\x10\x03\x12\x11\n\rINTERROGATIVE\x10\x04\x12\x0b\n\x07JUSSIVE\x10\x05\x12\x0f\n\x0bSUBJUNCTIVE\x10\x06"@\n\x06Number\x12\x12\n\x0eNUMBER_UNKNOWN\x10\x00\x12\x0c\n\x08SINGULAR\x10\x01\x12\n\n\x06PLURAL\x10\x02\x12\x08\n\x04\x44UAL\x10\x03"T\n\x06Person\x12\x12\n\x0ePERSON_UNKNOWN\x10\x00\x12\t\n\x05\x46IRST\x10\x01\x12\n\n\x06SECOND\x10\x02\x12\t\n\x05THIRD\x10\x03\x12\x14\n\x10REFLEXIVE_PERSON\x10\x04"8\n\x06Proper\x12\x12\n\x0ePROPER_UNKNOWN\x10\x00\x12\n\n\x06PROPER\x10\x01\x12\x0e\n\nNOT_PROPER\x10\x02"J\n\x0bReciprocity\x12\x17\n\x13RECIPROCITY_UNKNOWN\x10\x00\x12\x0e\n\nRECIPROCAL\x10\x01\x12\x12\n\x0eNON_RECIPROCAL\x10\x02"s\n\x05Tense\x12\x11\n\rTENSE_UNKNOWN\x10\x00\x12\x15\n\x11\x43ONDITIONAL_TENSE\x10\x01\x12\n\n\x06\x46UTURE\x10\x02\x12\x08\n\x04PAST\x10\x03\x12\x0b\n\x07PRESENT\x10\x04\x12\r\n\tIMPERFECT\x10\x05\x12\x0e\n\nPLUPERFECT\x10\x06"B\n\x05Voice\x12\x11\n\rVOICE_UNKNOWN\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\r\n\tCAUSATIVE\x10\x02\x12\x0b\n\x07PASSIVE\x10\x03"\x9a\x08\n\x0e\x44\x65pendencyEdge\x12\x18\n\x10head_token_index\x18\x01 \x01(\x05\x12\x42\n\x05label\x18\x02 \x01(\x0e\x32\x33.google.cloud.language.v1beta2.DependencyEdge.Label"\xa9\x07\n\x05Label\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06\x41\x42\x42REV\x10\x01\x12\t\n\x05\x41\x43OMP\x10\x02\x12\t\n\x05\x41\x44VCL\x10\x03\x12\n\n\x06\x41\x44VMOD\x10\x04\x12\x08\n\x04\x41MOD\x10\x05\x12\t\n\x05\x41PPOS\x10\x06\x12\x08\n\x04\x41TTR\x10\x07\x12\x07\n\x03\x41UX\x10\x08\x12\x0b\n\x07\x41UXPASS\x10\t\x12\x06\n\x02\x43\x43\x10\n\x12\t\n\x05\x43\x43OMP\x10\x0b\x12\x08\n\x04\x43ONJ\x10\x0c\x12\t\n\x05\x43SUBJ\x10\r\x12\r\n\tCSUBJPASS\x10\x0e\x12\x07\n\x03\x44\x45P\x10\x0f\x12\x07\n\x03\x44\x45T\x10\x10\x12\r\n\tDISCOURSE\x10\x11\x12\x08\n\x04\x44OBJ\x10\x12\x12\x08\n\x04\x45XPL\x10\x13\x12\x0c\n\x08GOESWITH\x10\x14\x12\x08\n\x04IOBJ\x10\x15\x12\x08\n\x04MARK\x10\x16\x12\x07\n\x03MWE\x10\x17\x12\x07\n\x03MWV\x10\x18\x12\x07\n\x03NEG\x10\x19\x12\x06\n\x02NN\x10\x1a\x12\x0c\n\x08NPADVMOD\x10\x1b\x12\t\n\x05NSUBJ\x10\x1c\x12\r\n\tNSUBJPASS\x10\x1d\x12\x07\n\x03NUM\x10\x1e\x12\n\n\x06NUMBER\x10\x1f\x12\x05\n\x01P\x10 \x12\r\n\tPARATAXIS\x10!\x12\x0b\n\x07PARTMOD\x10"\x12\t\n\x05PCOMP\x10#\x12\x08\n\x04POBJ\x10$\x12\x08\n\x04POSS\x10%\x12\x0b\n\x07POSTNEG\x10&\x12\x0b\n\x07PRECOMP\x10\'\x12\x0b\n\x07PRECONJ\x10(\x12\n\n\x06PREDET\x10)\x12\x08\n\x04PREF\x10*\x12\x08\n\x04PREP\x10+\x12\t\n\x05PRONL\x10,\x12\x07\n\x03PRT\x10-\x12\x06\n\x02PS\x10.\x12\x0c\n\x08QUANTMOD\x10/\x12\t\n\x05RCMOD\x10\x30\x12\x0c\n\x08RCMODREL\x10\x31\x12\t\n\x05RDROP\x10\x32\x12\x07\n\x03REF\x10\x33\x12\x0b\n\x07REMNANT\x10\x34\x12\x0e\n\nREPARANDUM\x10\x35\x12\x08\n\x04ROOT\x10\x36\x12\x08\n\x04SNUM\x10\x37\x12\x08\n\x04SUFF\x10\x38\x12\x08\n\x04TMOD\x10\x39\x12\t\n\x05TOPIC\x10:\x12\x08\n\x04VMOD\x10;\x12\x0c\n\x08VOCATIVE\x10<\x12\t\n\x05XCOMP\x10=\x12\n\n\x06SUFFIX\x10>\x12\t\n\x05TITLE\x10?\x12\x0c\n\x08\x41\x44VPHMOD\x10@\x12\x0b\n\x07\x41UXCAUS\x10\x41\x12\t\n\x05\x41UXVV\x10\x42\x12\t\n\x05\x44TMOD\x10\x43\x12\x0b\n\x07\x46OREIGN\x10\x44\x12\x06\n\x02KW\x10\x45\x12\x08\n\x04LIST\x10\x46\x12\x08\n\x04NOMC\x10G\x12\x0c\n\x08NOMCSUBJ\x10H\x12\x10\n\x0cNOMCSUBJPASS\x10I\x12\x08\n\x04NUMC\x10J\x12\x07\n\x03\x43OP\x10K\x12\x0e\n\nDISLOCATED\x10L\x12\x07\n\x03\x41SP\x10M\x12\x08\n\x04GMOD\x10N\x12\x08\n\x04GOBJ\x10O\x12\n\n\x06INFMOD\x10P\x12\x07\n\x03MES\x10Q\x12\t\n\x05NCOMP\x10R"\xf6\x01\n\rEntityMention\x12\x35\n\x04text\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.TextSpan\x12?\n\x04type\x18\x02 \x01(\x0e\x32\x31.google.cloud.language.v1beta2.EntityMention.Type\x12;\n\tsentiment\x18\x03 \x01(\x0b\x32(.google.cloud.language.v1beta2.Sentiment"0\n\x04Type\x12\x10\n\x0cTYPE_UNKNOWN\x10\x00\x12\n\n\x06PROPER\x10\x01\x12\n\n\x06\x43OMMON\x10\x02"1\n\x08TextSpan\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x14\n\x0c\x62\x65gin_offset\x18\x02 \x01(\x05":\n\x16\x43lassificationCategory\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02"\x98\x01\n\x17\x41nalyzeSentimentRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.Document\x12\x42\n\rencoding_type\x18\x02 \x01(\x0e\x32+.google.cloud.language.v1beta2.EncodingType"\xae\x01\n\x18\x41nalyzeSentimentResponse\x12\x44\n\x12\x64ocument_sentiment\x18\x01 \x01(\x0b\x32(.google.cloud.language.v1beta2.Sentiment\x12\x10\n\x08language\x18\x02 \x01(\t\x12:\n\tsentences\x18\x03 \x03(\x0b\x32\'.google.cloud.language.v1beta2.Sentence"\x9e\x01\n\x1d\x41nalyzeEntitySentimentRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.Document\x12\x42\n\rencoding_type\x18\x02 \x01(\x0e\x32+.google.cloud.language.v1beta2.EncodingType"k\n\x1e\x41nalyzeEntitySentimentResponse\x12\x37\n\x08\x65ntities\x18\x01 \x03(\x0b\x32%.google.cloud.language.v1beta2.Entity\x12\x10\n\x08language\x18\x02 \x01(\t"\x97\x01\n\x16\x41nalyzeEntitiesRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.Document\x12\x42\n\rencoding_type\x18\x02 \x01(\x0e\x32+.google.cloud.language.v1beta2.EncodingType"d\n\x17\x41nalyzeEntitiesResponse\x12\x37\n\x08\x65ntities\x18\x01 \x03(\x0b\x32%.google.cloud.language.v1beta2.Entity\x12\x10\n\x08language\x18\x02 \x01(\t"\x95\x01\n\x14\x41nalyzeSyntaxRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.Document\x12\x42\n\rencoding_type\x18\x02 \x01(\x0e\x32+.google.cloud.language.v1beta2.EncodingType"\x9b\x01\n\x15\x41nalyzeSyntaxResponse\x12:\n\tsentences\x18\x01 \x03(\x0b\x32\'.google.cloud.language.v1beta2.Sentence\x12\x34\n\x06tokens\x18\x02 \x03(\x0b\x32$.google.cloud.language.v1beta2.Token\x12\x10\n\x08language\x18\x03 \x01(\t"P\n\x13\x43lassifyTextRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.Document"a\n\x14\x43lassifyTextResponse\x12I\n\ncategories\x18\x01 \x03(\x0b\x32\x35.google.cloud.language.v1beta2.ClassificationCategory"\xff\x02\n\x13\x41nnotateTextRequest\x12\x39\n\x08\x64ocument\x18\x01 \x01(\x0b\x32\'.google.cloud.language.v1beta2.Document\x12M\n\x08\x66\x65\x61tures\x18\x02 \x01(\x0b\x32;.google.cloud.language.v1beta2.AnnotateTextRequest.Features\x12\x42\n\rencoding_type\x18\x03 \x01(\x0e\x32+.google.cloud.language.v1beta2.EncodingType\x1a\x99\x01\n\x08\x46\x65\x61tures\x12\x16\n\x0e\x65xtract_syntax\x18\x01 \x01(\x08\x12\x18\n\x10\x65xtract_entities\x18\x02 \x01(\x08\x12"\n\x1a\x65xtract_document_sentiment\x18\x03 \x01(\x08\x12 \n\x18\x65xtract_entity_sentiment\x18\x04 \x01(\x08\x12\x15\n\rclassify_text\x18\x06 \x01(\x08"\xe4\x02\n\x14\x41nnotateTextResponse\x12:\n\tsentences\x18\x01 \x03(\x0b\x32\'.google.cloud.language.v1beta2.Sentence\x12\x34\n\x06tokens\x18\x02 \x03(\x0b\x32$.google.cloud.language.v1beta2.Token\x12\x37\n\x08\x65ntities\x18\x03 \x03(\x0b\x32%.google.cloud.language.v1beta2.Entity\x12\x44\n\x12\x64ocument_sentiment\x18\x04 \x01(\x0b\x32(.google.cloud.language.v1beta2.Sentiment\x12\x10\n\x08language\x18\x05 \x01(\t\x12I\n\ncategories\x18\x06 \x03(\x0b\x32\x35.google.cloud.language.v1beta2.ClassificationCategory*8\n\x0c\x45ncodingType\x12\x08\n\x04NONE\x10\x00\x12\x08\n\x04UTF8\x10\x01\x12\t\n\x05UTF16\x10\x02\x12\t\n\x05UTF32\x10\x03\x32\xbd\x08\n\x0fLanguageService\x12\xb3\x01\n\x10\x41nalyzeSentiment\x12\x36.google.cloud.language.v1beta2.AnalyzeSentimentRequest\x1a\x37.google.cloud.language.v1beta2.AnalyzeSentimentResponse".\x82\xd3\xe4\x93\x02("#/v1beta2/documents:analyzeSentiment:\x01*\x12\xaf\x01\n\x0f\x41nalyzeEntities\x12\x35.google.cloud.language.v1beta2.AnalyzeEntitiesRequest\x1a\x36.google.cloud.language.v1beta2.AnalyzeEntitiesResponse"-\x82\xd3\xe4\x93\x02\'""/v1beta2/documents:analyzeEntities:\x01*\x12\xcb\x01\n\x16\x41nalyzeEntitySentiment\x12<.google.cloud.language.v1beta2.AnalyzeEntitySentimentRequest\x1a=.google.cloud.language.v1beta2.AnalyzeEntitySentimentResponse"4\x82\xd3\xe4\x93\x02.")/v1beta2/documents:analyzeEntitySentiment:\x01*\x12\xa7\x01\n\rAnalyzeSyntax\x12\x33.google.cloud.language.v1beta2.AnalyzeSyntaxRequest\x1a\x34.google.cloud.language.v1beta2.AnalyzeSyntaxResponse"+\x82\xd3\xe4\x93\x02%" /v1beta2/documents:analyzeSyntax:\x01*\x12\xa3\x01\n\x0c\x43lassifyText\x12\x32.google.cloud.language.v1beta2.ClassifyTextRequest\x1a\x33.google.cloud.language.v1beta2.ClassifyTextResponse"*\x82\xd3\xe4\x93\x02$"\x1f/v1beta2/documents:classifyText:\x01*\x12\xa3\x01\n\x0c\x41nnotateText\x12\x32.google.cloud.language.v1beta2.AnnotateTextRequest\x1a\x33.google.cloud.language.v1beta2.AnnotateTextResponse"*\x82\xd3\xe4\x93\x02$"\x1f/v1beta2/documents:annotateText:\x01*B\x82\x01\n!com.google.cloud.language.v1beta2B\x14LanguageServiceProtoP\x01ZEgoogle.golang.org/genproto/googleapis/cloud/language/v1beta2;languageb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_ENCODINGTYPE = _descriptor.EnumDescriptor(
+    name="EncodingType",
+    full_name="google.cloud.language.v1beta2.EncodingType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NONE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF8", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF16", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UTF32", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6939,
+    serialized_end=6995,
+)
+_sym_db.RegisterEnumDescriptor(_ENCODINGTYPE)
+
+EncodingType = enum_type_wrapper.EnumTypeWrapper(_ENCODINGTYPE)
+NONE = 0
+UTF8 = 1
+UTF16 = 2
+UTF32 = 3
+
+
+_DOCUMENT_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.language.v1beta2.Document.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLAIN_TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HTML", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=355,
+    serialized_end=409,
+)
+_sym_db.RegisterEnumDescriptor(_DOCUMENT_TYPE)
+
+_ENTITY_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.language.v1beta2.Entity.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERSON", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOCATION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORGANIZATION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EVENT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WORK_OF_ART", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONSUMER_GOOD", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=895,
+    serialized_end=1016,
+)
+_sym_db.RegisterEnumDescriptor(_ENTITY_TYPE)
+
+_PARTOFSPEECH_TAG = _descriptor.EnumDescriptor(
+    name="Tag",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Tag",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADJ", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADP", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADV", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONJ", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DET", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOUN", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUM", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRON", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRT", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUNCT", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERB", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="X", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AFFIX", index=13, number=13, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2108,
+    serialized_end=2249,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_TAG)
+
+_PARTOFSPEECH_ASPECT = _descriptor.EnumDescriptor(
+    name="Aspect",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Aspect",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ASPECT_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERFECTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPERFECTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROGRESSIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2251,
+    serialized_end=2330,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_ASPECT)
+
+_PARTOFSPEECH_CASE = _descriptor.EnumDescriptor(
+    name="Case",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Case",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CASE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCUSATIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVERBIAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLEMENTIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATIVE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GENITIVE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSTRUMENTAL", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOCATIVE", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMINATIVE", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBLIQUE", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARTITIVE", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREPOSITIONAL",
+            index=11,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REFLEXIVE_CASE",
+            index=12,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RELATIVE_CASE",
+            index=13,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOCATIVE", index=14, number=14, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2333,
+    serialized_end=2581,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_CASE)
+
+_PARTOFSPEECH_FORM = _descriptor.EnumDescriptor(
+    name="Form",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Form",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FORM_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADNOMIAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXILIARY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLEMENTIZER", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINAL_ENDING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GERUND", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REALIS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IRREALIS", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHORT", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LONG", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ORDER", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPECIFIC", index=11, number=11, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2584,
+    serialized_end=2759,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_FORM)
+
+_PARTOFSPEECH_GENDER = _descriptor.EnumDescriptor(
+    name="Gender",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Gender",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="GENDER_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FEMININE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MASCULINE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEUTER", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2761,
+    serialized_end=2830,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_GENDER)
+
+_PARTOFSPEECH_MOOD = _descriptor.EnumDescriptor(
+    name="Mood",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Mood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MOOD_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONDITIONAL_MOOD",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPERATIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INDICATIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERROGATIVE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JUSSIVE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUBJUNCTIVE", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2832,
+    serialized_end=2959,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_MOOD)
+
+_PARTOFSPEECH_NUMBER = _descriptor.EnumDescriptor(
+    name="Number",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Number",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NUMBER_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SINGULAR", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLURAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DUAL", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2961,
+    serialized_end=3025,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_NUMBER)
+
+_PARTOFSPEECH_PERSON = _descriptor.EnumDescriptor(
+    name="Person",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Person",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PERSON_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FIRST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SECOND", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="THIRD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REFLEXIVE_PERSON",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3027,
+    serialized_end=3111,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_PERSON)
+
+_PARTOFSPEECH_PROPER = _descriptor.EnumDescriptor(
+    name="Proper",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Proper",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PROPER_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROPER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOT_PROPER", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3113,
+    serialized_end=3169,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_PROPER)
+
+_PARTOFSPEECH_RECIPROCITY = _descriptor.EnumDescriptor(
+    name="Reciprocity",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Reciprocity",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RECIPROCITY_UNKNOWN",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECIPROCAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NON_RECIPROCAL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3171,
+    serialized_end=3245,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_RECIPROCITY)
+
+_PARTOFSPEECH_TENSE = _descriptor.EnumDescriptor(
+    name="Tense",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Tense",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TENSE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONDITIONAL_TENSE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FUTURE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAST", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRESENT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPERFECT", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLUPERFECT", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3247,
+    serialized_end=3362,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_TENSE)
+
+_PARTOFSPEECH_VOICE = _descriptor.EnumDescriptor(
+    name="Voice",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech.Voice",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VOICE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CAUSATIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PASSIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3364,
+    serialized_end=3430,
+)
+_sym_db.RegisterEnumDescriptor(_PARTOFSPEECH_VOICE)
+
+_DEPENDENCYEDGE_LABEL = _descriptor.EnumDescriptor(
+    name="Label",
+    full_name="google.cloud.language.v1beta2.DependencyEdge.Label",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ABBREV", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACOMP", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVCL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVMOD", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AMOD", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPOS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ATTR", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUX", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXPASS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CC", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CCOMP", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONJ", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CSUBJ", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CSUBJPASS", index=14, number=14, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DEP", index=15, number=15, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DET", index=16, number=16, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISCOURSE", index=17, number=17, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOBJ", index=18, number=18, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPL", index=19, number=19, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GOESWITH", index=20, number=20, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IOBJ", index=21, number=21, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MARK", index=22, number=22, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MWE", index=23, number=23, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MWV", index=24, number=24, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEG", index=25, number=25, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NN", index=26, number=26, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NPADVMOD", index=27, number=27, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NSUBJ", index=28, number=28, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NSUBJPASS", index=29, number=29, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUM", index=30, number=30, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMBER", index=31, number=31, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="P", index=32, number=32, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARATAXIS", index=33, number=33, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARTMOD", index=34, number=34, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PCOMP", index=35, number=35, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POBJ", index=36, number=36, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSS", index=37, number=37, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSTNEG", index=38, number=38, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRECOMP", index=39, number=39, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRECONJ", index=40, number=40, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREDET", index=41, number=41, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREF", index=42, number=42, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PREP", index=43, number=43, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRONL", index=44, number=44, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRT", index=45, number=45, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PS", index=46, number=46, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="QUANTMOD", index=47, number=47, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RCMOD", index=48, number=48, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RCMODREL", index=49, number=49, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RDROP", index=50, number=50, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REF", index=51, number=51, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMNANT", index=52, number=52, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPARANDUM", index=53, number=53, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ROOT", index=54, number=54, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SNUM", index=55, number=55, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUFF", index=56, number=56, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TMOD", index=57, number=57, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOPIC", index=58, number=58, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VMOD", index=59, number=59, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOCATIVE", index=60, number=60, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="XCOMP", index=61, number=61, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUFFIX", index=62, number=62, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TITLE", index=63, number=63, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVPHMOD", index=64, number=64, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXCAUS", index=65, number=65, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUXVV", index=66, number=66, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DTMOD", index=67, number=67, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREIGN", index=68, number=68, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KW", index=69, number=69, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIST", index=70, number=70, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMC", index=71, number=71, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMCSUBJ", index=72, number=72, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOMCSUBJPASS", index=73, number=73, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NUMC", index=74, number=74, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COP", index=75, number=75, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISLOCATED", index=76, number=76, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASP", index=77, number=77, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GMOD", index=78, number=78, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GOBJ", index=79, number=79, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INFMOD", index=80, number=80, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MES", index=81, number=81, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NCOMP", index=82, number=82, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3546,
+    serialized_end=4483,
+)
+_sym_db.RegisterEnumDescriptor(_DEPENDENCYEDGE_LABEL)
+
+_ENTITYMENTION_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.language.v1beta2.EntityMention.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROPER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMMON", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4684,
+    serialized_end=4732,
+)
+_sym_db.RegisterEnumDescriptor(_ENTITYMENTION_TYPE)
+
+
+_DOCUMENT = _descriptor.Descriptor(
+    name="Document",
+    full_name="google.cloud.language.v1beta2.Document",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.language.v1beta2.Document.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.language.v1beta2.Document.content",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcs_content_uri",
+            full_name="google.cloud.language.v1beta2.Document.gcs_content_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1beta2.Document.language",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DOCUMENT_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.language.v1beta2.Document.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=219,
+    serialized_end=419,
+)
+
+
+_SENTENCE = _descriptor.Descriptor(
+    name="Sentence",
+    full_name="google.cloud.language.v1beta2.Sentence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.language.v1beta2.Sentence.text",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.language.v1beta2.Sentence.sentiment",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=421,
+    serialized_end=547,
+)
+
+
+_ENTITY_METADATAENTRY = _descriptor.Descriptor(
+    name="MetadataEntry",
+    full_name="google.cloud.language.v1beta2.Entity.MetadataEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.language.v1beta2.Entity.MetadataEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.language.v1beta2.Entity.MetadataEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=846,
+    serialized_end=893,
+)
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.language.v1beta2.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.language.v1beta2.Entity.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.language.v1beta2.Entity.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.language.v1beta2.Entity.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="salience",
+            full_name="google.cloud.language.v1beta2.Entity.salience",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mentions",
+            full_name="google.cloud.language.v1beta2.Entity.mentions",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.language.v1beta2.Entity.sentiment",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ENTITY_METADATAENTRY],
+    enum_types=[_ENTITY_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=550,
+    serialized_end=1016,
+)
+
+
+_TOKEN = _descriptor.Descriptor(
+    name="Token",
+    full_name="google.cloud.language.v1beta2.Token",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.language.v1beta2.Token.text",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="part_of_speech",
+            full_name="google.cloud.language.v1beta2.Token.part_of_speech",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dependency_edge",
+            full_name="google.cloud.language.v1beta2.Token.dependency_edge",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lemma",
+            full_name="google.cloud.language.v1beta2.Token.lemma",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1019,
+    serialized_end=1237,
+)
+
+
+_SENTIMENT = _descriptor.Descriptor(
+    name="Sentiment",
+    full_name="google.cloud.language.v1beta2.Sentiment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="magnitude",
+            full_name="google.cloud.language.v1beta2.Sentiment.magnitude",
+            index=0,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.language.v1beta2.Sentiment.score",
+            index=1,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1239,
+    serialized_end=1284,
+)
+
+
+_PARTOFSPEECH = _descriptor.Descriptor(
+    name="PartOfSpeech",
+    full_name="google.cloud.language.v1beta2.PartOfSpeech",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tag",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.tag",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="aspect",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.aspect",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="case",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.case",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="form",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.form",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gender",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.gender",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mood",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.mood",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="number",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.number",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="person",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.person",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="proper",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.proper",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reciprocity",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.reciprocity",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tense",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.tense",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="voice",
+            full_name="google.cloud.language.v1beta2.PartOfSpeech.voice",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _PARTOFSPEECH_TAG,
+        _PARTOFSPEECH_ASPECT,
+        _PARTOFSPEECH_CASE,
+        _PARTOFSPEECH_FORM,
+        _PARTOFSPEECH_GENDER,
+        _PARTOFSPEECH_MOOD,
+        _PARTOFSPEECH_NUMBER,
+        _PARTOFSPEECH_PERSON,
+        _PARTOFSPEECH_PROPER,
+        _PARTOFSPEECH_RECIPROCITY,
+        _PARTOFSPEECH_TENSE,
+        _PARTOFSPEECH_VOICE,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1287,
+    serialized_end=3430,
+)
+
+
+_DEPENDENCYEDGE = _descriptor.Descriptor(
+    name="DependencyEdge",
+    full_name="google.cloud.language.v1beta2.DependencyEdge",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="head_token_index",
+            full_name="google.cloud.language.v1beta2.DependencyEdge.head_token_index",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.language.v1beta2.DependencyEdge.label",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DEPENDENCYEDGE_LABEL],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3433,
+    serialized_end=4483,
+)
+
+
+_ENTITYMENTION = _descriptor.Descriptor(
+    name="EntityMention",
+    full_name="google.cloud.language.v1beta2.EntityMention",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.language.v1beta2.EntityMention.text",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.language.v1beta2.EntityMention.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentiment",
+            full_name="google.cloud.language.v1beta2.EntityMention.sentiment",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ENTITYMENTION_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4486,
+    serialized_end=4732,
+)
+
+
+_TEXTSPAN = _descriptor.Descriptor(
+    name="TextSpan",
+    full_name="google.cloud.language.v1beta2.TextSpan",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.language.v1beta2.TextSpan.content",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="begin_offset",
+            full_name="google.cloud.language.v1beta2.TextSpan.begin_offset",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4734,
+    serialized_end=4783,
+)
+
+
+_CLASSIFICATIONCATEGORY = _descriptor.Descriptor(
+    name="ClassificationCategory",
+    full_name="google.cloud.language.v1beta2.ClassificationCategory",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.language.v1beta2.ClassificationCategory.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.language.v1beta2.ClassificationCategory.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4785,
+    serialized_end=4843,
+)
+
+
+_ANALYZESENTIMENTREQUEST = _descriptor.Descriptor(
+    name="AnalyzeSentimentRequest",
+    full_name="google.cloud.language.v1beta2.AnalyzeSentimentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1beta2.AnalyzeSentimentRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1beta2.AnalyzeSentimentRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4846,
+    serialized_end=4998,
+)
+
+
+_ANALYZESENTIMENTRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeSentimentResponse",
+    full_name="google.cloud.language.v1beta2.AnalyzeSentimentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document_sentiment",
+            full_name="google.cloud.language.v1beta2.AnalyzeSentimentResponse.document_sentiment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1beta2.AnalyzeSentimentResponse.language",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sentences",
+            full_name="google.cloud.language.v1beta2.AnalyzeSentimentResponse.sentences",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5001,
+    serialized_end=5175,
+)
+
+
+_ANALYZEENTITYSENTIMENTREQUEST = _descriptor.Descriptor(
+    name="AnalyzeEntitySentimentRequest",
+    full_name="google.cloud.language.v1beta2.AnalyzeEntitySentimentRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitySentimentRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitySentimentRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5178,
+    serialized_end=5336,
+)
+
+
+_ANALYZEENTITYSENTIMENTRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeEntitySentimentResponse",
+    full_name="google.cloud.language.v1beta2.AnalyzeEntitySentimentResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entities",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitySentimentResponse.entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitySentimentResponse.language",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5338,
+    serialized_end=5445,
+)
+
+
+_ANALYZEENTITIESREQUEST = _descriptor.Descriptor(
+    name="AnalyzeEntitiesRequest",
+    full_name="google.cloud.language.v1beta2.AnalyzeEntitiesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitiesRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitiesRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5448,
+    serialized_end=5599,
+)
+
+
+_ANALYZEENTITIESRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeEntitiesResponse",
+    full_name="google.cloud.language.v1beta2.AnalyzeEntitiesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entities",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitiesResponse.entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1beta2.AnalyzeEntitiesResponse.language",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5601,
+    serialized_end=5701,
+)
+
+
+_ANALYZESYNTAXREQUEST = _descriptor.Descriptor(
+    name="AnalyzeSyntaxRequest",
+    full_name="google.cloud.language.v1beta2.AnalyzeSyntaxRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1beta2.AnalyzeSyntaxRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1beta2.AnalyzeSyntaxRequest.encoding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5704,
+    serialized_end=5853,
+)
+
+
+_ANALYZESYNTAXRESPONSE = _descriptor.Descriptor(
+    name="AnalyzeSyntaxResponse",
+    full_name="google.cloud.language.v1beta2.AnalyzeSyntaxResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sentences",
+            full_name="google.cloud.language.v1beta2.AnalyzeSyntaxResponse.sentences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tokens",
+            full_name="google.cloud.language.v1beta2.AnalyzeSyntaxResponse.tokens",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1beta2.AnalyzeSyntaxResponse.language",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5856,
+    serialized_end=6011,
+)
+
+
+_CLASSIFYTEXTREQUEST = _descriptor.Descriptor(
+    name="ClassifyTextRequest",
+    full_name="google.cloud.language.v1beta2.ClassifyTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1beta2.ClassifyTextRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6013,
+    serialized_end=6093,
+)
+
+
+_CLASSIFYTEXTRESPONSE = _descriptor.Descriptor(
+    name="ClassifyTextResponse",
+    full_name="google.cloud.language.v1beta2.ClassifyTextResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="categories",
+            full_name="google.cloud.language.v1beta2.ClassifyTextResponse.categories",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6095,
+    serialized_end=6192,
+)
+
+
+_ANNOTATETEXTREQUEST_FEATURES = _descriptor.Descriptor(
+    name="Features",
+    full_name="google.cloud.language.v1beta2.AnnotateTextRequest.Features",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="extract_syntax",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_syntax",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extract_entities",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entities",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extract_document_sentiment",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_document_sentiment",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extract_entity_sentiment",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entity_sentiment",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="classify_text",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.Features.classify_text",
+            index=4,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6425,
+    serialized_end=6578,
+)
+
+_ANNOTATETEXTREQUEST = _descriptor.Descriptor(
+    name="AnnotateTextRequest",
+    full_name="google.cloud.language.v1beta2.AnnotateTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="document",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.document",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoding_type",
+            full_name="google.cloud.language.v1beta2.AnnotateTextRequest.encoding_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ANNOTATETEXTREQUEST_FEATURES],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6195,
+    serialized_end=6578,
+)
+
+
+_ANNOTATETEXTRESPONSE = _descriptor.Descriptor(
+    name="AnnotateTextResponse",
+    full_name="google.cloud.language.v1beta2.AnnotateTextResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sentences",
+            full_name="google.cloud.language.v1beta2.AnnotateTextResponse.sentences",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tokens",
+            full_name="google.cloud.language.v1beta2.AnnotateTextResponse.tokens",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entities",
+            full_name="google.cloud.language.v1beta2.AnnotateTextResponse.entities",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="document_sentiment",
+            full_name="google.cloud.language.v1beta2.AnnotateTextResponse.document_sentiment",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language",
+            full_name="google.cloud.language.v1beta2.AnnotateTextResponse.language",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="categories",
+            full_name="google.cloud.language.v1beta2.AnnotateTextResponse.categories",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6581,
+    serialized_end=6937,
+)
+
+_DOCUMENT.fields_by_name["type"].enum_type = _DOCUMENT_TYPE
+_DOCUMENT_TYPE.containing_type = _DOCUMENT
+_DOCUMENT.oneofs_by_name["source"].fields.append(_DOCUMENT.fields_by_name["content"])
+_DOCUMENT.fields_by_name["content"].containing_oneof = _DOCUMENT.oneofs_by_name[
+    "source"
+]
+_DOCUMENT.oneofs_by_name["source"].fields.append(
+    _DOCUMENT.fields_by_name["gcs_content_uri"]
+)
+_DOCUMENT.fields_by_name["gcs_content_uri"].containing_oneof = _DOCUMENT.oneofs_by_name[
+    "source"
+]
+_SENTENCE.fields_by_name["text"].message_type = _TEXTSPAN
+_SENTENCE.fields_by_name["sentiment"].message_type = _SENTIMENT
+_ENTITY_METADATAENTRY.containing_type = _ENTITY
+_ENTITY.fields_by_name["type"].enum_type = _ENTITY_TYPE
+_ENTITY.fields_by_name["metadata"].message_type = _ENTITY_METADATAENTRY
+_ENTITY.fields_by_name["mentions"].message_type = _ENTITYMENTION
+_ENTITY.fields_by_name["sentiment"].message_type = _SENTIMENT
+_ENTITY_TYPE.containing_type = _ENTITY
+_TOKEN.fields_by_name["text"].message_type = _TEXTSPAN
+_TOKEN.fields_by_name["part_of_speech"].message_type = _PARTOFSPEECH
+_TOKEN.fields_by_name["dependency_edge"].message_type = _DEPENDENCYEDGE
+_PARTOFSPEECH.fields_by_name["tag"].enum_type = _PARTOFSPEECH_TAG
+_PARTOFSPEECH.fields_by_name["aspect"].enum_type = _PARTOFSPEECH_ASPECT
+_PARTOFSPEECH.fields_by_name["case"].enum_type = _PARTOFSPEECH_CASE
+_PARTOFSPEECH.fields_by_name["form"].enum_type = _PARTOFSPEECH_FORM
+_PARTOFSPEECH.fields_by_name["gender"].enum_type = _PARTOFSPEECH_GENDER
+_PARTOFSPEECH.fields_by_name["mood"].enum_type = _PARTOFSPEECH_MOOD
+_PARTOFSPEECH.fields_by_name["number"].enum_type = _PARTOFSPEECH_NUMBER
+_PARTOFSPEECH.fields_by_name["person"].enum_type = _PARTOFSPEECH_PERSON
+_PARTOFSPEECH.fields_by_name["proper"].enum_type = _PARTOFSPEECH_PROPER
+_PARTOFSPEECH.fields_by_name["reciprocity"].enum_type = _PARTOFSPEECH_RECIPROCITY
+_PARTOFSPEECH.fields_by_name["tense"].enum_type = _PARTOFSPEECH_TENSE
+_PARTOFSPEECH.fields_by_name["voice"].enum_type = _PARTOFSPEECH_VOICE
+_PARTOFSPEECH_TAG.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_ASPECT.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_CASE.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_FORM.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_GENDER.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_MOOD.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_NUMBER.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_PERSON.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_PROPER.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_RECIPROCITY.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_TENSE.containing_type = _PARTOFSPEECH
+_PARTOFSPEECH_VOICE.containing_type = _PARTOFSPEECH
+_DEPENDENCYEDGE.fields_by_name["label"].enum_type = _DEPENDENCYEDGE_LABEL
+_DEPENDENCYEDGE_LABEL.containing_type = _DEPENDENCYEDGE
+_ENTITYMENTION.fields_by_name["text"].message_type = _TEXTSPAN
+_ENTITYMENTION.fields_by_name["type"].enum_type = _ENTITYMENTION_TYPE
+_ENTITYMENTION.fields_by_name["sentiment"].message_type = _SENTIMENT
+_ENTITYMENTION_TYPE.containing_type = _ENTITYMENTION
+_ANALYZESENTIMENTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZESENTIMENTREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZESENTIMENTRESPONSE.fields_by_name["document_sentiment"].message_type = _SENTIMENT
+_ANALYZESENTIMENTRESPONSE.fields_by_name["sentences"].message_type = _SENTENCE
+_ANALYZEENTITYSENTIMENTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZEENTITYSENTIMENTREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZEENTITYSENTIMENTRESPONSE.fields_by_name["entities"].message_type = _ENTITY
+_ANALYZEENTITIESREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZEENTITIESREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZEENTITIESRESPONSE.fields_by_name["entities"].message_type = _ENTITY
+_ANALYZESYNTAXREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANALYZESYNTAXREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANALYZESYNTAXRESPONSE.fields_by_name["sentences"].message_type = _SENTENCE
+_ANALYZESYNTAXRESPONSE.fields_by_name["tokens"].message_type = _TOKEN
+_CLASSIFYTEXTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_CLASSIFYTEXTRESPONSE.fields_by_name[
+    "categories"
+].message_type = _CLASSIFICATIONCATEGORY
+_ANNOTATETEXTREQUEST_FEATURES.containing_type = _ANNOTATETEXTREQUEST
+_ANNOTATETEXTREQUEST.fields_by_name["document"].message_type = _DOCUMENT
+_ANNOTATETEXTREQUEST.fields_by_name[
+    "features"
+].message_type = _ANNOTATETEXTREQUEST_FEATURES
+_ANNOTATETEXTREQUEST.fields_by_name["encoding_type"].enum_type = _ENCODINGTYPE
+_ANNOTATETEXTRESPONSE.fields_by_name["sentences"].message_type = _SENTENCE
+_ANNOTATETEXTRESPONSE.fields_by_name["tokens"].message_type = _TOKEN
+_ANNOTATETEXTRESPONSE.fields_by_name["entities"].message_type = _ENTITY
+_ANNOTATETEXTRESPONSE.fields_by_name["document_sentiment"].message_type = _SENTIMENT
+_ANNOTATETEXTRESPONSE.fields_by_name[
+    "categories"
+].message_type = _CLASSIFICATIONCATEGORY
+DESCRIPTOR.message_types_by_name["Document"] = _DOCUMENT
+DESCRIPTOR.message_types_by_name["Sentence"] = _SENTENCE
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["Token"] = _TOKEN
+DESCRIPTOR.message_types_by_name["Sentiment"] = _SENTIMENT
+DESCRIPTOR.message_types_by_name["PartOfSpeech"] = _PARTOFSPEECH
+DESCRIPTOR.message_types_by_name["DependencyEdge"] = _DEPENDENCYEDGE
+DESCRIPTOR.message_types_by_name["EntityMention"] = _ENTITYMENTION
+DESCRIPTOR.message_types_by_name["TextSpan"] = _TEXTSPAN
+DESCRIPTOR.message_types_by_name["ClassificationCategory"] = _CLASSIFICATIONCATEGORY
+DESCRIPTOR.message_types_by_name["AnalyzeSentimentRequest"] = _ANALYZESENTIMENTREQUEST
+DESCRIPTOR.message_types_by_name["AnalyzeSentimentResponse"] = _ANALYZESENTIMENTRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AnalyzeEntitySentimentRequest"
+] = _ANALYZEENTITYSENTIMENTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AnalyzeEntitySentimentResponse"
+] = _ANALYZEENTITYSENTIMENTRESPONSE
+DESCRIPTOR.message_types_by_name["AnalyzeEntitiesRequest"] = _ANALYZEENTITIESREQUEST
+DESCRIPTOR.message_types_by_name["AnalyzeEntitiesResponse"] = _ANALYZEENTITIESRESPONSE
+DESCRIPTOR.message_types_by_name["AnalyzeSyntaxRequest"] = _ANALYZESYNTAXREQUEST
+DESCRIPTOR.message_types_by_name["AnalyzeSyntaxResponse"] = _ANALYZESYNTAXRESPONSE
+DESCRIPTOR.message_types_by_name["ClassifyTextRequest"] = _CLASSIFYTEXTREQUEST
+DESCRIPTOR.message_types_by_name["ClassifyTextResponse"] = _CLASSIFYTEXTRESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateTextRequest"] = _ANNOTATETEXTREQUEST
+DESCRIPTOR.message_types_by_name["AnnotateTextResponse"] = _ANNOTATETEXTRESPONSE
+DESCRIPTOR.enum_types_by_name["EncodingType"] = _ENCODINGTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Document = _reflection.GeneratedProtocolMessageType(
+    "Document",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOCUMENT,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents the input to API methods.
+  
+  
+  Attributes:
+      type:
+          Required. If the type is not set or is ``TYPE_UNSPECIFIED``,
+          returns an ``INVALID_ARGUMENT`` error.
+      source:
+          The source of the document: a string containing the content or
+          a Google Cloud Storage URI.
+      content:
+          The content of the input in string format.
+      gcs_content_uri:
+          The Google Cloud Storage URI where the file content is
+          located. This URI must be of the form:
+          gs://bucket\_name/object\_name. For more details, see
+          https://cloud.google.com/storage/docs/reference-uris. NOTE:
+          Cloud Storage object versioning is not supported.
+      language:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.Document)
+    ),
+)
+_sym_db.RegisterMessage(Document)
+
+Sentence = _reflection.GeneratedProtocolMessageType(
+    "Sentence",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENTENCE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents a sentence in the input document.
+  
+  
+  Attributes:
+      text:
+          The sentence text.
+      sentiment:
+          For calls to [AnalyzeSentiment][] or if [AnnotateTextRequest.F
+          eatures.extract\_document\_sentiment][google.cloud.language.v1
+          beta2.AnnotateTextRequest.Features.extract\_document\_sentimen
+          t] is set to true, this field will contain the sentiment for
+          the sentence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.Sentence)
+    ),
+)
+_sym_db.RegisterMessage(Sentence)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        MetadataEntry=_reflection.GeneratedProtocolMessageType(
+            "MetadataEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ENTITY_METADATAENTRY,
+                __module__="google.cloud.language_v1beta2.proto.language_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.Entity.MetadataEntry)
+            ),
+        ),
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents a phrase in the text that is a known entity, such as a
+  person, an organization, or location. The API associates information,
+  such as salience and mentions, with entities.
+  
+  
+  Attributes:
+      name:
+          The representative name for the entity.
+      type:
+          The entity type.
+      metadata:
+          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.
+      salience:
+          The salience score associated with the entity in the [0, 1.0]
+          range.  The salience score for an entity provides information
+          about the importance or centrality of that entity to the
+          entire document text. Scores closer to 0 are less salient,
+          while scores closer to 1.0 are highly salient.
+      mentions:
+          The mentions of this entity in the input document. The API
+          currently supports proper noun mentions.
+      sentiment:
+          For calls to [AnalyzeEntitySentiment][] or if [AnnotateTextReq
+          uest.Features.extract\_entity\_sentiment][google.cloud.languag
+          e.v1beta2.AnnotateTextRequest.Features.extract\_entity\_sentim
+          ent] is set to true, this field will contain the aggregate
+          sentiment expressed for this entity in the provided document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+_sym_db.RegisterMessage(Entity.MetadataEntry)
+
+Token = _reflection.GeneratedProtocolMessageType(
+    "Token",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TOKEN,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents the smallest syntactic building block of the text.
+  
+  
+  Attributes:
+      text:
+          The token text.
+      part_of_speech:
+          Parts of speech tag for this token.
+      dependency_edge:
+          Dependency tree parse for this token.
+      lemma:
+          `Lemma
+          <https://en.wikipedia.org/wiki/Lemma_%28morphology%29>`__ of
+          the token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.Token)
+    ),
+)
+_sym_db.RegisterMessage(Token)
+
+Sentiment = _reflection.GeneratedProtocolMessageType(
+    "Sentiment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENTIMENT,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents the feeling associated with the entire text or entities in
+  the text.
+  
+  
+  Attributes:
+      magnitude:
+          A non-negative number in the [0, +inf) range, which represents
+          the absolute magnitude of sentiment regardless of score
+          (positive or negative).
+      score:
+          Sentiment score between -1.0 (negative sentiment) and 1.0
+          (positive sentiment).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.Sentiment)
+    ),
+)
+_sym_db.RegisterMessage(Sentiment)
+
+PartOfSpeech = _reflection.GeneratedProtocolMessageType(
+    "PartOfSpeech",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTOFSPEECH,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents part of speech information for a token.
+  
+  
+  Attributes:
+      tag:
+          The part of speech tag.
+      aspect:
+          The grammatical aspect.
+      case:
+          The grammatical case.
+      form:
+          The grammatical form.
+      gender:
+          The grammatical gender.
+      mood:
+          The grammatical mood.
+      number:
+          The grammatical number.
+      person:
+          The grammatical person.
+      proper:
+          The grammatical properness.
+      reciprocity:
+          The grammatical reciprocity.
+      tense:
+          The grammatical tense.
+      voice:
+          The grammatical voice.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.PartOfSpeech)
+    ),
+)
+_sym_db.RegisterMessage(PartOfSpeech)
+
+DependencyEdge = _reflection.GeneratedProtocolMessageType(
+    "DependencyEdge",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEPENDENCYEDGE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents dependency parse tree information for a token.
+  
+  
+  Attributes:
+      head_token_index:
+          Represents the head of this token in the dependency tree. This
+          is the index of the token which has an arc going to this
+          token. The index is the position of the token in the array of
+          tokens returned by the API method. If this token is a root
+          token, then the ``head_token_index`` is its own index.
+      label:
+          The parse label for the token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.DependencyEdge)
+    ),
+)
+_sym_db.RegisterMessage(DependencyEdge)
+
+EntityMention = _reflection.GeneratedProtocolMessageType(
+    "EntityMention",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYMENTION,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents a mention for an entity in the text. Currently, proper noun
+  mentions are supported.
+  
+  
+  Attributes:
+      text:
+          The mention text.
+      type:
+          The type of the entity mention.
+      sentiment:
+          For calls to [AnalyzeEntitySentiment][] or if [AnnotateTextReq
+          uest.Features.extract\_entity\_sentiment][google.cloud.languag
+          e.v1beta2.AnnotateTextRequest.Features.extract\_entity\_sentim
+          ent] is set to true, this field will contain the sentiment
+          expressed for this mention of the entity in the provided
+          document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.EntityMention)
+    ),
+)
+_sym_db.RegisterMessage(EntityMention)
+
+TextSpan = _reflection.GeneratedProtocolMessageType(
+    "TextSpan",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSPAN,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents an output piece of text.
+  
+  
+  Attributes:
+      content:
+          The content of the output text.
+      begin_offset:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.TextSpan)
+    ),
+)
+_sym_db.RegisterMessage(TextSpan)
+
+ClassificationCategory = _reflection.GeneratedProtocolMessageType(
+    "ClassificationCategory",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFICATIONCATEGORY,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""Represents a category returned from the text classifier.
+  
+  
+  Attributes:
+      name:
+          The name of the category representing the document.
+      confidence:
+          The classifier's confidence of the category. Number represents
+          how certain the classifier is that this category represents
+          the given text.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.ClassificationCategory)
+    ),
+)
+_sym_db.RegisterMessage(ClassificationCategory)
+
+AnalyzeSentimentRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSentimentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESENTIMENTREQUEST,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The sentiment analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate sentence
+          offsets for the sentence sentiment.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeSentimentRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSentimentRequest)
+
+AnalyzeSentimentResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSentimentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESENTIMENTRESPONSE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The sentiment analysis response message.
+  
+  
+  Attributes:
+      document_sentiment:
+          The overall sentiment of the input document.
+      language:
+          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][googl
+          e.cloud.language.v1beta2.Document.language] field for more
+          details.
+      sentences:
+          The sentiment for all the sentences in the document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeSentimentResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSentimentResponse)
+
+AnalyzeEntitySentimentRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitySentimentRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITYSENTIMENTREQUEST,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The entity-level sentiment analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeEntitySentimentRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitySentimentRequest)
+
+AnalyzeEntitySentimentResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitySentimentResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITYSENTIMENTRESPONSE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The entity-level sentiment analysis response message.
+  
+  
+  Attributes:
+      entities:
+          The recognized entities in the input document with associated
+          sentiments.
+      language:
+          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][googl
+          e.cloud.language.v1beta2.Document.language] field for more
+          details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeEntitySentimentResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitySentimentResponse)
+
+AnalyzeEntitiesRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitiesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITIESREQUEST,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The entity analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeEntitiesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitiesRequest)
+
+AnalyzeEntitiesResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeEntitiesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZEENTITIESRESPONSE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The entity analysis response message.
+  
+  
+  Attributes:
+      entities:
+          The recognized entities in the input document.
+      language:
+          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][googl
+          e.cloud.language.v1beta2.Document.language] field for more
+          details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeEntitiesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeEntitiesResponse)
+
+AnalyzeSyntaxRequest = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSyntaxRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESYNTAXREQUEST,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The syntax analysis request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeSyntaxRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSyntaxRequest)
+
+AnalyzeSyntaxResponse = _reflection.GeneratedProtocolMessageType(
+    "AnalyzeSyntaxResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANALYZESYNTAXRESPONSE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The syntax analysis response message.
+  
+  
+  Attributes:
+      sentences:
+          Sentences in the input document.
+      tokens:
+          Tokens, along with their syntactic information, in the input
+          document.
+      language:
+          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][googl
+          e.cloud.language.v1beta2.Document.language] field for more
+          details.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnalyzeSyntaxResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnalyzeSyntaxResponse)
+
+ClassifyTextRequest = _reflection.GeneratedProtocolMessageType(
+    "ClassifyTextRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFYTEXTREQUEST,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The document classification request message.
+  
+  
+  Attributes:
+      document:
+          Input document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.ClassifyTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(ClassifyTextRequest)
+
+ClassifyTextResponse = _reflection.GeneratedProtocolMessageType(
+    "ClassifyTextResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLASSIFYTEXTRESPONSE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The document classification response message.
+  
+  
+  Attributes:
+      categories:
+          Categories representing the input document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.ClassifyTextResponse)
+    ),
+)
+_sym_db.RegisterMessage(ClassifyTextResponse)
+
+AnnotateTextRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateTextRequest",
+    (_message.Message,),
+    dict(
+        Features=_reflection.GeneratedProtocolMessageType(
+            "Features",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ANNOTATETEXTREQUEST_FEATURES,
+                __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+                __doc__="""All available features for sentiment, syntax, and semantic analysis.
+    Setting each one to true will enable that specific analysis for the
+    input.
+    
+    
+    Attributes:
+        extract_syntax:
+            Extract syntax information.
+        extract_entities:
+            Extract entities.
+        extract_document_sentiment:
+            Extract document-level sentiment.
+        extract_entity_sentiment:
+            Extract entities and their associated sentiment.
+        classify_text:
+            Classify the full document into categories.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnnotateTextRequest.Features)
+            ),
+        ),
+        DESCRIPTOR=_ANNOTATETEXTREQUEST,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The request message for the text annotation API, which can perform
+  multiple analysis types (sentiment, entities, and syntax) in one call.
+  
+  
+  Attributes:
+      document:
+          Input document.
+      features:
+          The enabled features.
+      encoding_type:
+          The encoding type used by the API to calculate offsets.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnnotateTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateTextRequest)
+_sym_db.RegisterMessage(AnnotateTextRequest.Features)
+
+AnnotateTextResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateTextResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATETEXTRESPONSE,
+        __module__="google.cloud.language_v1beta2.proto.language_service_pb2",
+        __doc__="""The text annotations response message.
+  
+  
+  Attributes:
+      sentences:
+          Sentences in the input document. Populated if the user enables
+          [AnnotateTextRequest.Features.extract\_syntax][google.cloud.la
+          nguage.v1beta2.AnnotateTextRequest.Features.extract\_syntax].
+      tokens:
+          Tokens, along with their syntactic information, in the input
+          document. Populated if the user enables [AnnotateTextRequest.F
+          eatures.extract\_syntax][google.cloud.language.v1beta2.Annotat
+          eTextRequest.Features.extract\_syntax].
+      entities:
+          Entities, along with their semantic information, in the input
+          document. Populated if the user enables [AnnotateTextRequest.F
+          eatures.extract\_entities][google.cloud.language.v1beta2.Annot
+          ateTextRequest.Features.extract\_entities].
+      document_sentiment:
+          The overall sentiment for the document. Populated if the user
+          enables [AnnotateTextRequest.Features.extract\_document\_senti
+          ment][google.cloud.language.v1beta2.AnnotateTextRequest.Featur
+          es.extract\_document\_sentiment].
+      language:
+          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][googl
+          e.cloud.language.v1beta2.Document.language] field for more
+          details.
+      categories:
+          Categories identified in the input document.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.language.v1beta2.AnnotateTextResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateTextResponse)
+
+
+DESCRIPTOR._options = None
+_ENTITY_METADATAENTRY._options = None
+
+_LANGUAGESERVICE = _descriptor.ServiceDescriptor(
+    name="LanguageService",
+    full_name="google.cloud.language.v1beta2.LanguageService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=6998,
+    serialized_end=8083,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnalyzeSentiment",
+            full_name="google.cloud.language.v1beta2.LanguageService.AnalyzeSentiment",
+            index=0,
+            containing_service=None,
+            input_type=_ANALYZESENTIMENTREQUEST,
+            output_type=_ANALYZESENTIMENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002("#/v1beta2/documents:analyzeSentiment:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnalyzeEntities",
+            full_name="google.cloud.language.v1beta2.LanguageService.AnalyzeEntities",
+            index=1,
+            containing_service=None,
+            input_type=_ANALYZEENTITIESREQUEST,
+            output_type=_ANALYZEENTITIESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\'""/v1beta2/documents:analyzeEntities:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnalyzeEntitySentiment",
+            full_name="google.cloud.language.v1beta2.LanguageService.AnalyzeEntitySentiment",
+            index=2,
+            containing_service=None,
+            input_type=_ANALYZEENTITYSENTIMENTREQUEST,
+            output_type=_ANALYZEENTITYSENTIMENTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002.")/v1beta2/documents:analyzeEntitySentiment:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnalyzeSyntax",
+            full_name="google.cloud.language.v1beta2.LanguageService.AnalyzeSyntax",
+            index=3,
+            containing_service=None,
+            input_type=_ANALYZESYNTAXREQUEST,
+            output_type=_ANALYZESYNTAXRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002%" /v1beta2/documents:analyzeSyntax:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ClassifyText",
+            full_name="google.cloud.language.v1beta2.LanguageService.ClassifyText",
+            index=4,
+            containing_service=None,
+            input_type=_CLASSIFYTEXTREQUEST,
+            output_type=_CLASSIFYTEXTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002$"\037/v1beta2/documents:classifyText:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AnnotateText",
+            full_name="google.cloud.language.v1beta2.LanguageService.AnnotateText",
+            index=5,
+            containing_service=None,
+            input_type=_ANNOTATETEXTREQUEST,
+            output_type=_ANNOTATETEXTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002$"\037/v1beta2/documents:annotateText:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_LANGUAGESERVICE)
+
+DESCRIPTOR.services_by_name["LanguageService"] = _LANGUAGESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/language/google/cloud/language_v1beta2/proto/language_service_pb2_grpc.py b/language/google/cloud/language_v1beta2/proto/language_service_pb2_grpc.py
new file mode 100644
index 000000000000..da4223708164
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/proto/language_service_pb2_grpc.py
@@ -0,0 +1,144 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.language_v1beta2.proto import (
+    language_service_pb2 as google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2,
+)
+
+
+class LanguageServiceStub(object):
+    """Provides text analysis operations such as sentiment analysis and entity
+  recognition.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnalyzeSentiment = channel.unary_unary(
+            "/google.cloud.language.v1beta2.LanguageService/AnalyzeSentiment",
+            request_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSentimentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSentimentResponse.FromString,
+        )
+        self.AnalyzeEntities = channel.unary_unary(
+            "/google.cloud.language.v1beta2.LanguageService/AnalyzeEntities",
+            request_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitiesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitiesResponse.FromString,
+        )
+        self.AnalyzeEntitySentiment = channel.unary_unary(
+            "/google.cloud.language.v1beta2.LanguageService/AnalyzeEntitySentiment",
+            request_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentResponse.FromString,
+        )
+        self.AnalyzeSyntax = channel.unary_unary(
+            "/google.cloud.language.v1beta2.LanguageService/AnalyzeSyntax",
+            request_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSyntaxRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSyntaxResponse.FromString,
+        )
+        self.ClassifyText = channel.unary_unary(
+            "/google.cloud.language.v1beta2.LanguageService/ClassifyText",
+            request_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.ClassifyTextRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.ClassifyTextResponse.FromString,
+        )
+        self.AnnotateText = channel.unary_unary(
+            "/google.cloud.language.v1beta2.LanguageService/AnnotateText",
+            request_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnnotateTextRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnnotateTextResponse.FromString,
+        )
+
+
+class LanguageServiceServicer(object):
+    """Provides text analysis operations such as sentiment analysis and entity
+  recognition.
+  """
+
+    def AnalyzeSentiment(self, request, context):
+        """Analyzes the sentiment of the provided text.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnalyzeEntities(self, request, context):
+        """Finds named entities (currently proper names and common nouns) in the text
+    along with entity types, salience, mentions for each entity, and
+    other properties.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnalyzeEntitySentiment(self, request, context):
+        """Finds entities, similar to
+    [AnalyzeEntities][google.cloud.language.v1beta2.LanguageService.AnalyzeEntities]
+    in the text and analyzes sentiment associated with each entity and its
+    mentions.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnalyzeSyntax(self, request, context):
+        """Analyzes the syntax of the text and provides sentence boundaries and
+    tokenization along with part of speech tags, dependency trees, and other
+    properties.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ClassifyText(self, request, context):
+        """Classifies a document into categories.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AnnotateText(self, request, context):
+        """A convenience method that provides all syntax, sentiment, entity, and
+    classification features in one call.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_LanguageServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnalyzeSentiment": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeSentiment,
+            request_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSentimentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSentimentResponse.SerializeToString,
+        ),
+        "AnalyzeEntities": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeEntities,
+            request_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitiesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitiesResponse.SerializeToString,
+        ),
+        "AnalyzeEntitySentiment": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeEntitySentiment,
+            request_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeEntitySentimentResponse.SerializeToString,
+        ),
+        "AnalyzeSyntax": grpc.unary_unary_rpc_method_handler(
+            servicer.AnalyzeSyntax,
+            request_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSyntaxRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnalyzeSyntaxResponse.SerializeToString,
+        ),
+        "ClassifyText": grpc.unary_unary_rpc_method_handler(
+            servicer.ClassifyText,
+            request_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.ClassifyTextRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.ClassifyTextResponse.SerializeToString,
+        ),
+        "AnnotateText": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateText,
+            request_deserializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnnotateTextRequest.FromString,
+            response_serializer=google_dot_cloud_dot_language__v1beta2_dot_proto_dot_language__service__pb2.AnnotateTextResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.language.v1beta2.LanguageService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/language/google/cloud/language_v1beta2/types.py b/language/google/cloud/language_v1beta2/types.py
new file mode 100644
index 000000000000..1a33a23ef337
--- /dev/null
+++ b/language/google/cloud/language_v1beta2/types.py
@@ -0,0 +1,55 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.language_v1beta2.proto import language_service_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    operations_pb2,
+    any_pb2,
+    descriptor_pb2,
+    empty_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [language_service_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.language_v1beta2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/language/noxfile.py b/language/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/language/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/language/pylint.config.py b/language/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/language/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/language/setup.cfg b/language/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/language/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/language/setup.py b/language/setup.py
new file mode 100644
index 000000000000..6ac5b244c7b2
--- /dev/null
+++ b/language/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-language"
+description = "Google Cloud Natural Language API client library"
+version = "1.3.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34;python_version<"3.4"',
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/language/synth.metadata b/language/synth.metadata
new file mode 100644
index 000000000000..1456f20ac240
--- /dev/null
+++ b/language/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:30:47.420536Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "language",
+        "apiVersion": "v1beta2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/language/artman_language_v1beta2.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "language",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/language/artman_language_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/language/synth.py b/language/synth.py
new file mode 100644
index 000000000000..6166eca1729e
--- /dev/null
+++ b/language/synth.py
@@ -0,0 +1,54 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta2", "v1"]
+
+
+# ----------------------------------------------------------------------------
+# Generate language GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library(
+        "language",
+        version,
+        config_path=f"/google/cloud/language/artman_language_{version}.yaml",
+        artman_output_name=f"language-{version}",
+        include_protos=True,
+    )
+
+    s.move(library / f"google/cloud/language_{version}/proto")
+    s.move(library / f"google/cloud/language_{version}/gapic")
+    s.move(library / f"tests/unit/gapic/{version}")
+    s.move(library / f"tests/system/gapic/{version}")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.replace(
+    f"google/cloud/**/gapic/language_service_client.py",
+    r"types\.EncodingType",
+    "enums.EncodingType",
+)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/language/tests/__init__.py b/language/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/language/tests/system/gapic/v1/test_system_language_service_v1.py b/language/tests/system/gapic/v1/test_system_language_service_v1.py
new file mode 100644
index 000000000000..e54b9339a998
--- /dev/null
+++ b/language/tests/system/gapic/v1/test_system_language_service_v1.py
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+
+from google.cloud import language_v1
+from google.cloud.language_v1 import enums
+from google.cloud.language_v1.proto import language_service_pb2
+
+
+class TestSystemLanguageService(object):
+    def test_analyze_sentiment(self):
+
+        client = language_v1.LanguageServiceClient()
+        content = "Hello, world!"
+        type_ = enums.Document.Type.PLAIN_TEXT
+        document = {"content": content, "type": type_}
+        response = client.analyze_sentiment(document)
diff --git a/language/tests/system/gapic/v1beta2/test_system_language_service_v1beta2.py b/language/tests/system/gapic/v1beta2/test_system_language_service_v1beta2.py
new file mode 100644
index 000000000000..24d18d098289
--- /dev/null
+++ b/language/tests/system/gapic/v1beta2/test_system_language_service_v1beta2.py
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+
+from google.cloud import language_v1beta2
+from google.cloud.language_v1beta2 import enums
+from google.cloud.language_v1beta2.proto import language_service_pb2
+
+
+class TestSystemLanguageService(object):
+    def test_analyze_sentiment(self):
+
+        client = language_v1beta2.LanguageServiceClient()
+        content = "Hello, world!"
+        type_ = enums.Document.Type.PLAIN_TEXT
+        document = {"content": content, "type": type_}
+        response = client.analyze_sentiment(document)
diff --git a/language/tests/unit/__init__.py b/language/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/language/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/language/tests/unit/gapic/v1/test_language_service_client_v1.py b/language/tests/unit/gapic/v1/test_language_service_client_v1.py
new file mode 100644
index 000000000000..2c9bef7c3c7b
--- /dev/null
+++ b/language/tests/unit/gapic/v1/test_language_service_client_v1.py
@@ -0,0 +1,310 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import language_v1
+from google.cloud.language_v1.proto import language_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestLanguageServiceClient(object):
+    def test_analyze_sentiment(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeSentimentResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_sentiment(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeSentimentRequest(
+            document=document
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_sentiment_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_sentiment(document)
+
+    def test_analyze_entities(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeEntitiesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_entities(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeEntitiesRequest(
+            document=document
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_entities_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_entities(document)
+
+    def test_analyze_entity_sentiment(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeEntitySentimentResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_entity_sentiment(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeEntitySentimentRequest(
+            document=document
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_entity_sentiment_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_entity_sentiment(document)
+
+    def test_analyze_syntax(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeSyntaxResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_syntax(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeSyntaxRequest(document=document)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_syntax_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_syntax(document)
+
+    def test_classify_text(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = language_service_pb2.ClassifyTextResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.classify_text(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.ClassifyTextRequest(document=document)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_classify_text_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.classify_text(document)
+
+    def test_annotate_text(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnnotateTextResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+        features = {}
+
+        response = client.annotate_text(document, features)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnnotateTextRequest(
+            document=document, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_text_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+        features = {}
+
+        with pytest.raises(CustomException):
+            client.annotate_text(document, features)
diff --git a/language/tests/unit/gapic/v1beta2/test_language_service_client_v1beta2.py b/language/tests/unit/gapic/v1beta2/test_language_service_client_v1beta2.py
new file mode 100644
index 000000000000..159f57f9bcce
--- /dev/null
+++ b/language/tests/unit/gapic/v1beta2/test_language_service_client_v1beta2.py
@@ -0,0 +1,310 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import language_v1beta2
+from google.cloud.language_v1beta2.proto import language_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestLanguageServiceClient(object):
+    def test_analyze_sentiment(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeSentimentResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_sentiment(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeSentimentRequest(
+            document=document
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_sentiment_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_sentiment(document)
+
+    def test_analyze_entities(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeEntitiesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_entities(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeEntitiesRequest(
+            document=document
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_entities_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_entities(document)
+
+    def test_analyze_entity_sentiment(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeEntitySentimentResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_entity_sentiment(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeEntitySentimentRequest(
+            document=document
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_entity_sentiment_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_entity_sentiment(document)
+
+    def test_analyze_syntax(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnalyzeSyntaxResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.analyze_syntax(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnalyzeSyntaxRequest(document=document)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_analyze_syntax_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.analyze_syntax(document)
+
+    def test_classify_text(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = language_service_pb2.ClassifyTextResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+
+        response = client.classify_text(document)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.ClassifyTextRequest(document=document)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_classify_text_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+
+        with pytest.raises(CustomException):
+            client.classify_text(document)
+
+    def test_annotate_text(self):
+        # Setup Expected Response
+        language = "language-1613589672"
+        expected_response = {"language": language}
+        expected_response = language_service_pb2.AnnotateTextResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup Request
+        document = {}
+        features = {}
+
+        response = client.annotate_text(document, features)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = language_service_pb2.AnnotateTextRequest(
+            document=document, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_text_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = language_v1beta2.LanguageServiceClient()
+
+        # Setup request
+        document = {}
+        features = {}
+
+        with pytest.raises(CustomException):
+            client.annotate_text(document, features)
diff --git a/legacy/google-cloud/MANIFEST.in b/legacy/google-cloud/MANIFEST.in
new file mode 100644
index 000000000000..e73a89048601
--- /dev/null
+++ b/legacy/google-cloud/MANIFEST.in
@@ -0,0 +1,2 @@
+include setup-README.rst
+global-exclude *.pyc
diff --git a/legacy/google-cloud/setup-README.rst b/legacy/google-cloud/setup-README.rst
new file mode 100644
index 000000000000..8cf3fb3d72c9
--- /dev/null
+++ b/legacy/google-cloud/setup-README.rst
@@ -0,0 +1,32 @@
+Google Cloud Python Client
+==========================
+
+    Python idiomatic client for `Google Cloud Platform`_ services.
+
+    WARNING: The google-cloud Python package is deprecated. On June 18, 2018,
+    this package will no longer install any other packages. Please install the
+    `product-specific google-cloud-* packages`__ needed for your application.
+
+.. __: https://github.com/googleapis/google-cloud-python
+
+.. _Google Cloud Platform: https://cloud.google.com/
+
+|pypi| |circleci| |appveyor| |coverage| |versions|
+
+License
+-------
+
+Apache 2.0 - See `the LICENSE`_ for more information.
+
+.. _the LICENSE: https://github.com/googleapis/google-cloud-python/blob/master/LICENSE
+
+.. |circleci| image:: https://circleci.com/gh/GoogleCloudPlatform/google-cloud-python.svg?style=shield
+   :target: https://circleci.com/gh/GoogleCloudPlatform/google-cloud-python
+.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/googlecloudplatform/google-cloud-python?branch=master&svg=true
+   :target: https://ci.appveyor.com/project/GoogleCloudPlatform/google-cloud-python
+.. |coverage| image:: https://coveralls.io/repos/GoogleCloudPlatform/google-cloud-python/badge.svg?branch=master
+   :target: https://coveralls.io/r/GoogleCloudPlatform/google-cloud-python?branch=master
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud.svg
+   :target: https://pypi.org/project/google-cloud/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud.svg
+   :target: https://pypi.org/project/google-cloud/
diff --git a/legacy/google-cloud/setup.cfg b/legacy/google-cloud/setup.cfg
new file mode 100644
index 000000000000..79874b747939
--- /dev/null
+++ b/legacy/google-cloud/setup.cfg
@@ -0,0 +1,5 @@
+[bdist_wheel]
+universal = 1
+
+[tool:pytest]
+addopts = --tb=native
diff --git a/legacy/google-cloud/setup.py b/legacy/google-cloud/setup.py
new file mode 100644
index 000000000000..4f0e106be580
--- /dev/null
+++ b/legacy/google-cloud/setup.py
@@ -0,0 +1,68 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import logging
+
+from setuptools import setup
+
+PACKAGE_ROOT = os.path.abspath(os.path.dirname(__file__))
+
+with open(os.path.join(PACKAGE_ROOT, 'setup-README.rst')) as file_obj:
+    README = file_obj.read()
+
+# NOTE: This is duplicated throughout and we should try to
+#       consolidate.
+SETUP_BASE = {
+    'author': 'Google Cloud Platform',
+    'author_email': 'googleapis-publisher@google.com',
+    'scripts': [],
+    'url': 'https://github.com/GoogleCloudPlatform/google-cloud-python',
+    'license': 'Apache 2.0',
+    'platforms': 'Posix; MacOS X; Windows',
+    'include_package_data': True,
+    'zip_safe': False,
+    'classifiers': [
+        'Development Status :: 7 - Inactive',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Topic :: Internet',
+    ],
+}
+
+REQUIREMENTS = [
+]
+
+setup(
+    name='google-cloud',
+    version='0.34.0',
+    description='API Client library for Google Cloud',
+    long_description=README,
+    install_requires=REQUIREMENTS,
+    **SETUP_BASE
+)
+
+warning = "WARNING: The google-cloud Python package is deprecated. This " \
+          "package no longer installs any other " \
+          "packages. Please install the product-specific google-cloud-* " \
+          "packages needed for your application. See " \
+          "https://github.com/GoogleCloudPlatform/google-cloud-python."
+
+logging.warn(warning)
diff --git a/logging/.coveragerc b/logging/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/logging/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/logging/.flake8 b/logging/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/logging/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/logging/.repo-metadata.json b/logging/.repo-metadata.json
new file mode 100644
index 000000000000..33d1b1f819ee
--- /dev/null
+++ b/logging/.repo-metadata.json
@@ -0,0 +1,12 @@
+{
+  "name": "logging",
+  "name_pretty": "Stackdriver Logging",
+  "product_documentation": "https://cloud.google.com/logging/docs",
+  "client_documentation": "https://googleapis.dev/python/logging/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559764",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-logging",
+  "api_id": "logging.googleapis.com"
+}
\ No newline at end of file
diff --git a/logging/CHANGELOG.md b/logging/CHANGELOG.md
new file mode 100644
index 000000000000..f7ad1b7451ed
--- /dev/null
+++ b/logging/CHANGELOG.md
@@ -0,0 +1,246 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-logging/#history
+
+## 1.12.1
+
+08-01-2019 09:45 PDT
+
+
+### Implementation Changes
+- Remove gRPC size restrictions (4MB default) ([#8860](https://github.com/googleapis/google-cloud-python/pull/8860))
+- Map stdlib loglevels to Stackdriver severity enum values. ([#8837](https://github.com/googleapis/google-cloud-python/pull/8837))
+
+### Documentation
+- Fix 'list_entries' example with projects. ([#8858](https://github.com/googleapis/google-cloud-python/pull/8858))
+
+### Internal / Testing Changes
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 1.12.0
+
+07-24-2019 16:47 PDT
+
+
+### Implementation Changes
+- Set the 'timestamp' on log records created by handler. ([#8227](https://github.com/googleapis/google-cloud-python/pull/8227))
+- Clarify worker thread implementation. ([#8228](https://github.com/googleapis/google-cloud-python/pull/8228))
+
+### New Features
+- Add path-construction helpers to GAPIC clients (via synth). ([#8631](https://github.com/googleapis/google-cloud-python/pull/8631))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8535](https://github.com/googleapis/google-cloud-python/pull/8535))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Re-add "generated" markers (via synth). ([#8538](https://github.com/googleapis/google-cloud-python/pull/8538))
+- Add nox session 'docs' to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Fix tests broken in PR [#8227](https://github.com/googleapis/google-cloud-python/pull/8227). ([#8273](https://github.com/googleapis/google-cloud-python/pull/8273))
+- Add empty lines. ([#8064](https://github.com/googleapis/google-cloud-python/pull/8064))
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+
+## 1.11.0
+
+05-16-2019 12:27 PDT
+
+
+### Implementation Changes
+- Add routing header to method metadata (via synth). ([#7598](https://github.com/googleapis/google-cloud-python/pull/7598))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Use FQDN for GCE metadata endpoint. ([#7520](https://github.com/googleapis/google-cloud-python/pull/7520))
+
+### New Features
+- Add `client_info` support to client. ([#7874](https://github.com/googleapis/google-cloud-python/pull/7874)) and ([#7901](https://github.com/googleapis/google-cloud-python/pull/7901))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Reformat snippet (via synth). ([#7216](https://github.com/googleapis/google-cloud-python/pull/7216))
+- Add snippet for logging a resource. ([#7212](https://github.com/googleapis/google-cloud-python/pull/7212))
+
+### Internal / Testing Changes
+- Reorder methods in file (via synth). ([#7810](https://github.com/googleapis/google-cloud-python/pull/7810))
+- Copy lintified proto files (via synth). ([#7450](https://github.com/googleapis/google-cloud-python/pull/7450))
+- Trivial gapic-generator change. ([#7230](https://github.com/googleapis/google-cloud-python/pull/7230))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 1.10.0
+
+01-17-2019 15:37 PST
+
+
+### Implementation Changes
+- Change WriteLogEntries retry policy.
+- Protoc-generated serialization update. ([#7088](https://github.com/googleapis/google-cloud-python/pull/7088))
+- GAPIC generation fixes. ([#7061](https://github.com/googleapis/google-cloud-python/pull/7061))
+
+### Internal / Testing Changes
+- Update copyright headers.
+- Use 'python-3.6' for 'blacken' run. ([#7064](https://github.com/googleapis/google-cloud-python/pull/7064))
+
+## 1.9.1
+
+12-17-2018 16:49 PST
+
+
+### Implementation Changes
+- Allow setting name, args on default handler (post-blacken) ([#6828](https://github.com/googleapis/google-cloud-python/pull/6828))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize docs for `page_size` / `max_results` / `page_token`. ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+## 1.9.0
+
+12-10-2018 12:55 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6631](https://github.com/googleapis/google-cloud-python/pull/6631))
+- Fix `client_info` bug, update docstrings via synth. ([#6435](https://github.com/googleapis/google-cloud-python/pull/6435))
+- Revert "Allow turning on JSON Detection in StackDriver" ([#6352](https://github.com/googleapis/google-cloud-python/pull/6352))
+- Allow turning on JSON Detection in StackDriver ([#6293](https://github.com/googleapis/google-cloud-python/pull/6293))
+
+### New Features
+- Add support for additional 'LogEntry' fields ([#6229](https://github.com/googleapis/google-cloud-python/pull/6229))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+
+### Internal / Testing Changes
+- Change the url to the canonical one ([#6843](https://github.com/googleapis/google-cloud-python/pull/6843))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Blackening Continued... ([#6667](https://github.com/googleapis/google-cloud-python/pull/6667))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Logging: add 'synth.py'. ([#6081](https://github.com/googleapis/google-cloud-python/pull/6081))
+
+## 1.8.0
+
+10-17-2018 14:23 PDT
+
+### Implementation Changes
+
+- Logging:  allow more tries on inner retry for '_list_entries'. ([#6179](https://github.com/googleapis/google-cloud-python/pull/6179))
+- Accommodate payload-less log entries. ([#6103](https://github.com/googleapis/google-cloud-python/pull/6103))
+
+### New Features
+
+- Logging: support request-correlated logging in App Engine standard python37 runtime ([#6118](https://github.com/googleapis/google-cloud-python/pull/6118))
+
+### Documentation
+
+- Logging: fix class reference in docstring ([#6153](https://github.com/googleapis/google-cloud-python/pull/6153))
+- Translate / Logging / Language: restore detailed usage docs. ([#5999](https://github.com/googleapis/google-cloud-python/pull/5999))
+- Redirect renamed 'usage.html'/'client.html' -> 'index.html'. ([#5996](https://github.com/googleapis/google-cloud-python/pull/5996))
+
+### Internal / Testing Changes
+
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Logging: harden systest teardown against 'DeadlineExceeded' retry errors. ([#6182](https://github.com/googleapis/google-cloud-python/pull/6182))
+- Logging: fix lint errors. ([#6183](https://github.com/googleapis/google-cloud-python/pull/6183))
+- Harden sink / metric creation against transient errors. ([#6180](https://github.com/googleapis/google-cloud-python/pull/6180))
+- Logging: test both GCLOUD_PROJECT and GOOGLE_CLOUD_PROJECT env vars ([#6138](https://github.com/googleapis/google-cloud-python/pull/6138))
+- Harden 'test_list_entry_with_unregistered' against 429 errors. ([#6181](https://github.com/googleapis/google-cloud-python/pull/6181))
+- Prep logging docs for repo split. ([#5943](https://github.com/googleapis/google-cloud-python/pull/5943))
+
+## 1.7.0
+
+### Implementation Changes
+- Print to stderr instead of stdout when exiting the program ([#5569](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5569))
+- Avoid overwriting '__module__' of messages from shared modules. ([#5364](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5364))
+- Support older Django versions in request middleware [#5024](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5024)
+- Fix bad trove classifier [#5386](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5386)
+
+### New Features
+- Add support for `trace` and `span_id` to logging async API ([#5908](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5908))
+- Add support for `span_id` attribute of log entries ([#5885](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5885))
+- Add support for `trace` attribute of log entries ([#5878](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5878))
+- Add support for Python 3.7 and remove 3.4 ([#5295](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5295))
+
+### Documentation
+- Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Nox: use inplace installs ([#5865](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5865))
+- Unflake logging systests ([#5698](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5698))
+- Harden `_list_entries` system test further against backoff failure. ([#5551](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5551))
+- Harden logging systests ([#5496](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5496))
+- Harden system tests against 'ResourceExhausted' quota errors. ([#5486](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5486))
+- Modify system tests to use prerelease versions of grpcio ([#5304](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5304))
+- Plug leaky sink in systests. ([#5247](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5247))
+
+## 1.6.0
+
+### Dependencies
+
+- The minimum version for `google-api-core` has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+
+## 1.5.0
+
+### New features
+
+- Added `max_latency` to `BackgroundThreadTransport`. (#4762)
+- Added support for unique writer identity in `Sink`. (#4595, #4708, #4704, #4706)
+
+### Implementation changes
+
+- The underlying auto-generated client library was re-generated to pick up new features and bugfixes. (#4759)
+- Moved the code path of `get_gae_labels()` to `emit()`. (#4824)
+- Removed a debug print statement. (#4838)
+- `LogSink.create` captures the server-generated `writerIdentity`. (#4707)
+- Accomodated a back-end change making `Sink.filter` optional. (#4699)
+
+### Testing
+
+- Fixed system tests (#4768)
+- Hardened test for `retrieve_metadata_server` against transparent DNS proxies. (#4698)
+- Added cleanup for Pub / Sub topic in logging system test. (#4532)
+- Added another check for Python 2.7 in Logging `nox -s default`. (#4523)
+- Pinned `django` test dependency to `< 2.0` in Python 2.7. (#4519)
+- Maked a `nox -s default` session for all packages. (#4324)
+- Shortened test names. (#4321)
+
+### Documentation
+
+- Added doc to highlight missing `uniqueWriterIdentity` field. (#4579)
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+## 1.4.0
+
+### Implementation Changes
+
+- Remove `deepcopy` of `Client._http` in background transport (#3954)
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+PyPI: https://pypi.org/project/google-cloud-logging/1.4.0/
diff --git a/logging/LICENSE b/logging/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/logging/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/logging/MANIFEST.in b/logging/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/logging/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/logging/README.rst b/logging/README.rst
new file mode 100644
index 000000000000..220a6cf17be2
--- /dev/null
+++ b/logging/README.rst
@@ -0,0 +1,113 @@
+Python Client for Stackdriver Logging
+=====================================
+
+|pypi| |versions| 
+
+`Stackdriver Logging API`_: Writes log entries and manages your Stackdriver
+Logging configuration.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-logging.svg
+   :target: https://pypi.org/project/google-cloud-logging/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-logging.svg
+   :target: https://pypi.org/project/google-cloud-logging/
+.. _Stackdriver Logging API: https://cloud.google.com/logging
+.. _Client Library Documentation: https://googleapis.dev/python/logging/latest
+.. _Product Documentation:  https://cloud.google.com/logging/docs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Stackdriver Logging API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Stackdriver Logging API.:  https://cloud.google.com/logging
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-logging
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-logging
+
+Using the API
+-------------
+
+.. code:: python
+
+    from google.cloud import logging_v2
+
+    client = logging_v2.LoggingServiceV2Client()
+    entries = []
+    response = client.write_log_entries(entries)
+
+.. code:: python
+
+    from google.cloud import logging
+    client = logging.Client()
+    logger = client.logger('log_name')
+    logger.log_text('A simple entry')  # API call
+
+Example of fetching entries:
+
+.. code:: python
+
+    from google.cloud import logging
+    client = logging.Client()
+    logger = client.logger('log_name')
+    for entry in logger.list_entries():
+        print(entry.payload)
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for to see other available
+   methods on the client.
+-  Read the `Product documentation`_ to learn more about the product and see
+   How-to Guides.
diff --git a/logging/docs/README.rst b/logging/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/logging/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/logging/docs/changelog.md b/logging/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/logging/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/logging/docs/client.rst b/logging/docs/client.rst
new file mode 100644
index 000000000000..f04d5c5255f1
--- /dev/null
+++ b/logging/docs/client.rst
@@ -0,0 +1,6 @@
+Stackdriver Logging Client
+==========================
+
+.. automodule:: google.cloud.logging.client
+  :members:
+  :show-inheritance:
diff --git a/logging/docs/conf.py b/logging/docs/conf.py
new file mode 100644
index 000000000000..da2faa63ec4f
--- /dev/null
+++ b/logging/docs/conf.py
@@ -0,0 +1,359 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-logging documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-logging"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-logging-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-logging.tex",
+        u"google-cloud-logging Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-logging",
+        u"google-cloud-logging Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-logging",
+        u"google-cloud-logging Documentation",
+        author,
+        "google-cloud-logging",
+        "GAPIC library for the logging API",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/logging/docs/entries.rst b/logging/docs/entries.rst
new file mode 100644
index 000000000000..223eadc0756e
--- /dev/null
+++ b/logging/docs/entries.rst
@@ -0,0 +1,7 @@
+Entries
+=======
+
+.. automodule:: google.cloud.logging.entries
+  :members:
+  :show-inheritance:
+  :member-order: groupwise
diff --git a/logging/docs/handlers-app-engine.rst b/logging/docs/handlers-app-engine.rst
new file mode 100644
index 000000000000..71c45e3690be
--- /dev/null
+++ b/logging/docs/handlers-app-engine.rst
@@ -0,0 +1,6 @@
+Google App Engine flexible Log Handler
+======================================
+
+.. automodule:: google.cloud.logging.handlers.app_engine
+  :members:
+  :show-inheritance:
diff --git a/logging/docs/handlers-container-engine.rst b/logging/docs/handlers-container-engine.rst
new file mode 100644
index 000000000000..a0c6b2bc9228
--- /dev/null
+++ b/logging/docs/handlers-container-engine.rst
@@ -0,0 +1,6 @@
+Google Container Engine Log Handler
+===================================
+
+.. automodule:: google.cloud.logging.handlers.container_engine
+  :members:
+  :show-inheritance:
diff --git a/docs/logging-handlers.rst b/logging/docs/handlers.rst
similarity index 100%
rename from docs/logging-handlers.rst
rename to logging/docs/handlers.rst
diff --git a/logging/docs/index.rst b/logging/docs/index.rst
new file mode 100644
index 000000000000..67ad362dfc69
--- /dev/null
+++ b/logging/docs/index.rst
@@ -0,0 +1,36 @@
+.. include:: README.rst
+
+Usage Documentation
+-------------------
+.. toctree::
+   :maxdepth: 2
+
+   usage
+
+Api Reference
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   client
+   logger
+   entries
+   metric
+   sink
+   stdlib-usage
+   handlers
+   handlers-app-engine
+   handlers-container-engine
+   transports-sync
+   transports-thread
+   transports-base
+
+Changelog
+~~~~~~~~~
+
+For a list of all ``google-cloud-logging`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/logging/docs/logger.rst b/logging/docs/logger.rst
new file mode 100644
index 000000000000..72533ba33774
--- /dev/null
+++ b/logging/docs/logger.rst
@@ -0,0 +1,6 @@
+Logger
+======
+
+.. automodule:: google.cloud.logging.logger
+  :members:
+  :show-inheritance:
diff --git a/docs/logging-metric.rst b/logging/docs/metric.rst
similarity index 100%
rename from docs/logging-metric.rst
rename to logging/docs/metric.rst
diff --git a/docs/logging-sink.rst b/logging/docs/sink.rst
similarity index 100%
rename from docs/logging-sink.rst
rename to logging/docs/sink.rst
diff --git a/logging/docs/snippets.py b/logging/docs/snippets.py
new file mode 100644
index 000000000000..778327989b0f
--- /dev/null
+++ b/logging/docs/snippets.py
@@ -0,0 +1,434 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Testable usage examples for Stackdriver Logging API wrapper
+
+Each example function takes a ``client`` argument (which must be an instance
+of :class:`google.cloud.logging.client.Client`) and uses it to perform a task
+with the API.
+
+To facilitate running the examples as system tests, each example is also passed
+a ``to_delete`` list;  the function adds to the list any objects created which
+need to be deleted during teardown.
+"""
+
+import time
+
+from google.cloud.logging.client import Client
+
+
+def snippet(func):
+    """Mark ``func`` as a snippet example function."""
+    func._snippet = True
+    return func
+
+
+def _millis():
+    return time.time() * 1000
+
+
+def do_something_with(item):  # pylint: disable=unused-argument
+    pass
+
+
+# pylint: disable=reimported,unused-variable,unused-argument
+@snippet
+def instantiate_client(_unused_client, _unused_to_delete):
+    """Instantiate client."""
+
+    # [START client_create_default]
+    from google.cloud import logging
+
+    client = logging.Client()
+    # [END client_create_default]
+
+    credentials = object()
+    # [START client_create_explicit]
+    from google.cloud import logging
+
+    client = logging.Client(project="my-project", credentials=credentials)
+    # [END client_create_explicit]
+
+
+# pylint: enable=reimported,unused-variable,unused-argument
+
+
+@snippet
+def client_list_entries(client, to_delete):  # pylint: disable=unused-argument
+    """List entries via client."""
+
+    # [START client_list_entries_default]
+    for entry in client.list_entries():  # API call(s)
+        do_something_with(entry)
+    # [END client_list_entries_default]
+
+    # [START client_list_entries_filter]
+    FILTER = "logName:log_name AND textPayload:simple"
+    for entry in client.list_entries(filter_=FILTER):  # API call(s)
+        do_something_with(entry)
+    # [END client_list_entries_filter]
+
+    # [START client_list_entries_order_by]
+    from google.cloud.logging import DESCENDING
+
+    for entry in client.list_entries(order_by=DESCENDING):  # API call(s)
+        do_something_with(entry)
+    # [END client_list_entries_order_by]
+
+    # [START client_list_entries_paged]
+    iterator = client.list_entries()
+    pages = iterator.pages
+
+    page1 = next(pages)  # API call
+    for entry in page1:
+        do_something_with(entry)
+
+    page2 = next(pages)  # API call
+    for entry in page2:
+        do_something_with(entry)
+    # [END client_list_entries_paged]
+
+
+# @snippet  Commented because we need real project IDs to test
+def client_list_entries_multi_project(
+    client, to_delete
+):  # pylint: disable=unused-argument
+    """List entries via client across multiple projects."""
+
+    # [START client_list_entries_multi_project]
+    PROJECT_IDS = ["one-project", "another-project"]
+    for entry in client.list_entries(projects=PROJECT_IDS):  # API call(s)
+        do_something_with(entry)
+    # [END client_list_entries_multi_project]
+
+
+@snippet
+def logger_usage(client, to_delete):
+    """Logger usage."""
+    LOG_NAME = "logger_usage_%d" % (_millis())
+
+    # [START logger_create]
+    logger = client.logger(LOG_NAME)
+    # [END logger_create]
+    to_delete.append(logger)
+
+    # [START logger_log_text]
+    logger.log_text("A simple entry")  # API call
+    # [END logger_log_text]
+
+    # [START logger_log_struct]
+    logger.log_struct(
+        {"message": "My second entry", "weather": "partly cloudy"}
+    )  # API call
+    # [END logger_log_struct]
+
+    # [START logger_log_resource_text]
+    from google.cloud.logging.resource import Resource
+
+    res = Resource(
+        type="generic_node",
+        labels={
+            "location": "us-central1-a",
+            "namespace": "default",
+            "node_id": "10.10.10.1",
+        },
+    )
+    logger.log_struct(
+        {"message": "My first entry", "weather": "partly cloudy"}, resource=res
+    )
+    # [END logger_log_resource_text]
+
+    # [START logger_list_entries]
+    from google.cloud.logging import DESCENDING
+
+    for entry in logger.list_entries(order_by=DESCENDING):  # API call(s)
+        do_something_with(entry)
+    # [END logger_list_entries]
+
+    def _logger_delete():
+        # [START logger_delete]
+        logger.delete()  # API call
+        # [END logger_delete]
+
+    _backoff_not_found(_logger_delete)
+    to_delete.remove(logger)
+
+
+@snippet
+def metric_crud(client, to_delete):
+    """Metric CRUD."""
+    METRIC_NAME = "robots-%d" % (_millis(),)
+    DESCRIPTION = "Robots all up in your server"
+    FILTER = "logName:apache-access AND textPayload:robot"
+    UPDATED_FILTER = "textPayload:robot"
+    UPDATED_DESCRIPTION = "Danger, Will Robinson!"
+
+    # [START client_list_metrics]
+    for metric in client.list_metrics():  # API call(s)
+        do_something_with(metric)
+    # [END client_list_metrics]
+
+    # [START metric_create]
+    metric = client.metric(METRIC_NAME, filter_=FILTER, description=DESCRIPTION)
+    assert not metric.exists()  # API call
+    metric.create()  # API call
+    assert metric.exists()  # API call
+    # [END metric_create]
+    to_delete.append(metric)
+
+    # [START metric_reload]
+    existing_metric = client.metric(METRIC_NAME)
+    existing_metric.reload()  # API call
+    # [END metric_reload]
+    assert existing_metric.filter_ == FILTER
+    assert existing_metric.description == DESCRIPTION
+
+    # [START metric_update]
+    existing_metric.filter_ = UPDATED_FILTER
+    existing_metric.description = UPDATED_DESCRIPTION
+    existing_metric.update()  # API call
+    # [END metric_update]
+    existing_metric.reload()
+    assert existing_metric.filter_ == UPDATED_FILTER
+    assert existing_metric.description == UPDATED_DESCRIPTION
+
+    def _metric_delete():
+        # [START metric_delete]
+        metric.delete()
+        # [END metric_delete]
+
+    _backoff_not_found(_metric_delete)
+    to_delete.remove(metric)
+
+
+def _sink_storage_setup(client):
+    from google.cloud import storage
+
+    BUCKET_NAME = "sink-storage-%d" % (_millis(),)
+    client = storage.Client()
+    bucket = client.bucket(BUCKET_NAME)
+    bucket.create()
+
+    # [START sink_bucket_permissions]
+    bucket.acl.reload()  # API call
+    logs_group = bucket.acl.group("cloud-logs@google.com")
+    logs_group.grant_owner()
+    bucket.acl.add_entity(logs_group)
+    bucket.acl.save()  # API call
+    # [END sink_bucket_permissions]
+
+    return bucket
+
+
+@snippet
+def sink_storage(client, to_delete):
+    """Sink log entries to storage."""
+    bucket = _sink_storage_setup(client)
+    to_delete.append(bucket)
+    SINK_NAME = "robots-storage-%d" % (_millis(),)
+    FILTER = "textPayload:robot"
+
+    # [START sink_storage_create]
+    DESTINATION = "storage.googleapis.com/%s" % (bucket.name,)
+    sink = client.sink(SINK_NAME, filter_=FILTER, destination=DESTINATION)
+    assert not sink.exists()  # API call
+    sink.create()  # API call
+    assert sink.exists()  # API call
+    # [END sink_storage_create]
+    to_delete.insert(0, sink)  # delete sink before bucket
+
+
+def _sink_bigquery_setup(client):
+    from google.cloud import bigquery
+
+    DATASET_NAME = "sink_bigquery_%d" % (_millis(),)
+    client = bigquery.Client()
+    dataset = client.dataset(DATASET_NAME)
+    dataset.create()
+    dataset.reload()
+
+    # [START sink_dataset_permissions]
+    from google.cloud.bigquery.dataset import AccessGrant
+
+    grants = dataset.access_grants
+    grants.append(AccessGrant("WRITER", "groupByEmail", "cloud-logs@google.com"))
+    dataset.access_grants = grants
+    dataset.update()  # API call
+    # [END sink_dataset_permissions]
+
+    return dataset
+
+
+@snippet
+def sink_bigquery(client, to_delete):
+    """Sink log entries to bigquery."""
+    dataset = _sink_bigquery_setup(client)
+    to_delete.append(dataset)
+    SINK_NAME = "robots-bigquery-%d" % (_millis(),)
+    FILTER = "textPayload:robot"
+
+    # [START sink_bigquery_create]
+    DESTINATION = "bigquery.googleapis.com%s" % (dataset.path,)
+    sink = client.sink(SINK_NAME, filter_=FILTER, destination=DESTINATION)
+    assert not sink.exists()  # API call
+    sink.create()  # API call
+    assert sink.exists()  # API call
+    # [END sink_bigquery_create]
+    to_delete.insert(0, sink)  # delete sink before dataset
+
+
+def _sink_pubsub_setup(client):
+    from google.cloud import pubsub
+
+    TOPIC_NAME = "sink-pubsub-%d" % (_millis(),)
+    client = pubsub.Client()
+    topic = client.topic(TOPIC_NAME)
+    topic.create()
+
+    # [START sink_topic_permissions]
+    policy = topic.get_iam_policy()  # API call
+    policy.owners.add(policy.group("cloud-logs@google.com"))
+    topic.set_iam_policy(policy)  # API call
+    # [END sink_topic_permissions]
+
+    return topic
+
+
+@snippet
+def sink_pubsub(client, to_delete):
+    """Sink log entries to pubsub."""
+    topic = _sink_pubsub_setup(client)
+    to_delete.append(topic)
+    SINK_NAME = "robots-pubsub-%d" % (_millis(),)
+    FILTER = "logName:apache-access AND textPayload:robot"
+    UPDATED_FILTER = "textPayload:robot"
+
+    # [START sink_pubsub_create]
+    DESTINATION = "pubsub.googleapis.com/%s" % (topic.full_name,)
+    sink = client.sink(SINK_NAME, filter_=FILTER, destination=DESTINATION)
+    assert not sink.exists()  # API call
+    sink.create()  # API call
+    assert sink.exists()  # API call
+    # [END sink_pubsub_create]
+    to_delete.insert(0, sink)  # delete sink before topic
+
+    # [START client_list_sinks]
+    for sink in client.list_sinks():  # API call(s)
+        do_something_with(sink)
+    # [END client_list_sinks]
+
+    # [START sink_reload]
+    existing_sink = client.sink(SINK_NAME)
+    existing_sink.reload()
+    # [END sink_reload]
+    assert existing_sink.filter_ == FILTER
+    assert existing_sink.destination == DESTINATION
+
+    # [START sink_update]
+    existing_sink.filter_ = UPDATED_FILTER
+    existing_sink.update()
+    # [END sink_update]
+    existing_sink.reload()
+    assert existing_sink.filter_ == UPDATED_FILTER
+
+    # [START sink_delete]
+    sink.delete()
+    # [END sink_delete]
+    to_delete.pop(0)
+
+
+@snippet
+def logging_handler(client):
+    # [START create_default_handler]
+    import logging
+
+    handler = client.get_default_handler()
+    cloud_logger = logging.getLogger("cloudLogger")
+    cloud_logger.setLevel(logging.INFO)
+    cloud_logger.addHandler(handler)
+    cloud_logger.error("bad news")
+    # [END create_default_handler]
+
+    # [START create_cloud_handler]
+    from google.cloud.logging.handlers import CloudLoggingHandler
+
+    handler = CloudLoggingHandler(client)
+    cloud_logger = logging.getLogger("cloudLogger")
+    cloud_logger.setLevel(logging.INFO)
+    cloud_logger.addHandler(handler)
+    cloud_logger.error("bad news")
+    # [END create_cloud_handler]
+
+    # [START create_named_handler]
+    handler = CloudLoggingHandler(client, name="mycustomlog")
+    # [END create_named_handler]
+
+
+@snippet
+def setup_logging(client):
+    import logging
+
+    # [START setup_logging]
+    client.setup_logging(log_level=logging.INFO)
+    # [END setup_logging]
+
+    # [START setup_logging_excludes]
+    client.setup_logging(log_level=logging.INFO, excluded_loggers=("werkzeug",))
+    # [END setup_logging_excludes]
+
+
+def _line_no(func):
+    return func.__code__.co_firstlineno
+
+
+def _find_examples():
+    funcs = [obj for obj in globals().values() if getattr(obj, "_snippet", False)]
+    for func in sorted(funcs, key=_line_no):
+        yield func
+
+
+def _name_and_doc(func):
+    return func.__name__, func.__doc__
+
+
+def _backoff_not_found(deleter):
+    from google.cloud.exceptions import NotFound
+
+    timeouts = [1, 2, 4, 8, 16]
+    while timeouts:
+        try:
+            deleter()
+        except NotFound:
+            time.sleep(timeouts.pop(0))
+        else:
+            break
+
+
+def main():
+    client = Client()
+    for example in _find_examples():
+        to_delete = []
+        print("%-25s: %s" % _name_and_doc(example))
+        try:
+            example(client, to_delete)
+        except AssertionError as failure:
+            print("   FAIL: %s" % (failure,))
+        except Exception as error:  # pylint: disable=broad-except
+            print("  ERROR: %r" % (error,))
+        for item in to_delete:
+            _backoff_not_found(item.delete)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/logging/docs/stdlib-usage.rst b/logging/docs/stdlib-usage.rst
new file mode 100644
index 000000000000..cba4080b5f5e
--- /dev/null
+++ b/logging/docs/stdlib-usage.rst
@@ -0,0 +1,70 @@
+Integration with Python logging module
+--------------------------------------
+
+
+It's possible to tie the Python :mod:`logging` module directly into Google Cloud Logging. To use it,
+create a :class:`CloudLoggingHandler <google.cloud.logging.CloudLoggingHandler>` instance from your
+Logging client.
+
+.. code-block:: python
+
+    >>> import logging
+    >>> import google.cloud.logging # Don't conflict with standard logging
+    >>> from google.cloud.logging.handlers import CloudLoggingHandler
+    >>> client = google.cloud.logging.Client()
+    >>> handler = CloudLoggingHandler(client)
+    >>> cloud_logger = logging.getLogger('cloudLogger')
+    >>> cloud_logger.setLevel(logging.INFO) # defaults to WARN
+    >>> cloud_logger.addHandler(handler)
+    >>> cloud_logger.error('bad news')
+
+.. note::
+
+    This handler by default uses an asynchronous transport that sends log entries on a background
+     thread. However, the API call will still be made in the same process. For other transport
+     options, see the transports section.
+
+All logs will go to a single custom log, which defaults to "python". The name of the Python
+logger will be included in the structured log entry under the "python_logger" field. You can
+change it by providing a name to the handler:
+
+.. code-block:: python
+
+    >>> handler = CloudLoggingHandler(client, name="mycustomlog")
+
+It is also possible to attach the handler to the root Python logger, so that for example a plain
+`logging.warn` call would be sent to Cloud Logging, as well as any other loggers created. However,
+you must avoid infinite recursion from the logging calls the client itself makes. A helper
+method :meth:`setup_logging <google.cloud.logging.handlers.setup_logging>` is provided to configure
+this automatically:
+
+.. code-block:: python
+
+    >>> import logging
+    >>> import google.cloud.logging # Don't conflict with standard logging
+    >>> from google.cloud.logging.handlers import CloudLoggingHandler, setup_logging
+    >>> client = google.cloud.logging.Client()
+    >>> handler = CloudLoggingHandler(client)
+    >>> logging.getLogger().setLevel(logging.INFO) # defaults to WARN
+    >>> setup_logging(handler)
+    >>> logging.error('bad news')
+
+You can also exclude certain loggers:
+
+.. code-block:: python
+
+   >>> setup_logging(handler, excluded_loggers=('werkzeug',))
+
+
+
+Python logging handler transports
+==================================
+
+The Python logging handler can use different transports. The default is
+:class:`google.cloud.logging.handlers.BackgroundThreadTransport`.
+
+ 1. :class:`google.cloud.logging.handlers.BackgroundThreadTransport` this is the default. It writes
+ entries on a background :class:`python.threading.Thread`.
+
+ 1. :class:`google.cloud.logging.handlers.SyncTransport` this handler does a direct API call on each
+ logging statement to write the entry.
diff --git a/docs/logging-transports-base.rst b/logging/docs/transports-base.rst
similarity index 100%
rename from docs/logging-transports-base.rst
rename to logging/docs/transports-base.rst
diff --git a/docs/logging-transports-sync.rst b/logging/docs/transports-sync.rst
similarity index 100%
rename from docs/logging-transports-sync.rst
rename to logging/docs/transports-sync.rst
diff --git a/docs/logging-transports-thread.rst b/logging/docs/transports-thread.rst
similarity index 100%
rename from docs/logging-transports-thread.rst
rename to logging/docs/transports-thread.rst
diff --git a/logging/docs/usage.rst b/logging/docs/usage.rst
new file mode 100644
index 000000000000..122a850fecba
--- /dev/null
+++ b/logging/docs/usage.rst
@@ -0,0 +1,358 @@
+Writing log entries
+-------------------
+
+To write log entries, first create a
+:class:`~google.cloud.logging.logger.Logger`, passing the "log name" with
+which to associate the entries:
+
+.. literalinclude:: snippets.py
+    :start-after: [START logger_create]
+    :end-before: [END logger_create]
+    :dedent: 4
+
+Write a simple text entry to the logger.
+
+.. literalinclude:: snippets.py
+    :start-after: [START logger_log_text]
+    :end-before: [END logger_log_text]
+    :dedent: 4
+
+Write a dictionary entry to the logger.
+
+.. literalinclude:: snippets.py
+    :start-after: [START logger_log_struct]
+    :end-before: [END logger_log_struct]
+    :dedent: 4
+
+Write a simple text entry and resource to the logger.
+
+Supported Resource values are listed at `Monitored Resource Types`_
+
+.. _Monitored Resource Types: https://cloud.google.com/logging/docs/api/v2/resource-list
+
+
+.. literalinclude:: snippets.py
+    :start-after: [START logger_log_resource_text]
+    :end-before: [END logger_log_resource_text]
+    :dedent: 4
+
+Retrieving log entries
+----------------------
+
+Fetch entries for the default project.
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_entries_default]
+    :end-before: [END client_list_entries_default]
+    :dedent: 4
+
+Entries returned by
+:meth:`Client.list_entries <google.cloud.logging.client.Client.list_entries>`
+or
+:meth:`Logger.list_entries <google.cloud.logging.logger.Logger.list_entries>`
+will be instances of one of the following classes:
+
+- :class:`~google.cloud.logging.entries.TextEntry`
+- :class:`~google.cloud.logging.entries.StructEntry`
+- :class:`~google.cloud.logging.entries.ProtobufEntry`
+
+Fetch entries across multiple projects.
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_entries_multi_project]
+    :end-before: [END client_list_entries_multi_project]
+    :dedent: 4
+
+Filter entries retrieved using the `Advanced Logs Filters`_ syntax
+
+.. _Advanced Logs Filters: https://cloud.google.com/logging/docs/view/advanced_filters
+
+Fetch entries for the default project.
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_entries_filter]
+    :end-before: [END client_list_entries_filter]
+    :dedent: 4
+
+Sort entries in descending timestamp order.
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_entries_order_by]
+    :end-before: [END client_list_entries_order_by]
+    :dedent: 4
+
+Retrieve entries in batches of 10, iterating until done.
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_entries_paged]
+    :end-before: [END client_list_entries_paged]
+    :dedent: 4
+
+Retrieve entries for a single logger, sorting in descending timestamp order:
+
+.. literalinclude:: snippets.py
+    :start-after: [START logger_list_entries]
+    :end-before: [END logger_list_entries]
+    :dedent: 4
+
+
+Delete all entries for a logger
+-------------------------------
+
+.. literalinclude:: snippets.py
+    :start-after: [START logger_delete]
+    :end-before: [END logger_delete]
+    :dedent: 8
+
+
+Manage log metrics
+------------------
+
+Metrics are counters of entries which match a given filter.  They can be
+used within Stackdriver Monitoring to create charts and alerts.
+
+List all metrics for a project:
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_metrics]
+    :end-before: [END client_list_metrics]
+    :dedent: 4
+
+Create a metric:
+
+.. literalinclude:: snippets.py
+    :start-after: [START metric_create]
+    :end-before: [END metric_create]
+    :dedent: 4
+
+Refresh local information about a metric:
+
+.. literalinclude:: snippets.py
+    :start-after: [START metric_reload]
+    :end-before: [END metric_reload]
+    :dedent: 4
+
+Update a metric:
+
+.. literalinclude:: snippets.py
+    :start-after: [START metric_update]
+    :end-before: [END metric_update]
+    :dedent: 4
+
+Delete a metric:
+
+.. literalinclude:: snippets.py
+    :start-after: [START metric_delete]
+    :end-before: [END metric_delete]
+    :dedent: 4
+
+Export log entries using sinks
+------------------------------
+
+Sinks allow exporting entries which match a given filter to Cloud Storage
+buckets, BigQuery datasets, or Cloud Pub/Sub topics.
+
+Export to Cloud Storage
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Make sure that the storage bucket you want to export logs too has
+``cloud-logs@google.com`` as the owner. See
+`Setting permissions for Cloud Storage`_.
+
+.. _Setting permissions for Cloud Storage: https://cloud.google.com/logging/docs/export/configure_export_v2#errors_exporting_to_cloud_storage
+
+Add ``cloud-logs@google.com`` as the owner of the bucket:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_bucket_permissions]
+    :end-before: [END sink_bucket_permissions]
+    :dedent: 4
+
+Create a Cloud Storage sink:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_storage_create]
+    :end-before: [END sink_storage_create]
+    :dedent: 4
+
+
+Export to BigQuery
+~~~~~~~~~~~~~~~~~~
+
+To export logs to BigQuery you must log into the Cloud Platform Console
+and add ``cloud-logs@google.com`` to a dataset.
+
+See: `Setting permissions for BigQuery`_
+
+.. _Setting permissions for BigQuery: https://cloud.google.com/logging/docs/export/configure_export_v2#errors_exporting_to_bigquery
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_dataset_permissions]
+    :end-before: [END sink_dataset_permissions]
+    :dedent: 4
+
+Create a BigQuery sink:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_bigquery_create]
+    :end-before: [END sink_bigquery_create]
+    :dedent: 4
+
+
+Export to Pub/Sub
+~~~~~~~~~~~~~~~~~
+
+To export logs to BigQuery you must log into the Cloud Platform Console
+and add ``cloud-logs@google.com`` to a topic.
+
+See: `Setting permissions for Pub/Sub`_
+
+.. _Setting permissions for Pub/Sub: https://cloud.google.com/logging/docs/export/configure_export_v2#errors_exporting_logs_to_cloud_pubsub
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_topic_permissions]
+    :end-before: [END sink_topic_permissions]
+    :dedent: 4
+
+Create a Cloud Pub/Sub sink:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_pubsub_create]
+    :end-before: [END sink_pubsub_create]
+    :dedent: 4
+
+Manage Sinks
+~~~~~~~~~~~~
+
+List all sinks for a project:
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_list_sinks]
+    :end-before: [END client_list_sinks]
+    :dedent: 4
+
+Refresh local information about a sink:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_reload]
+    :end-before: [END sink_reload]
+    :dedent: 4
+
+Update a sink:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_update]
+    :end-before: [END sink_update]
+    :dedent: 4
+
+Delete a sink:
+
+.. literalinclude:: snippets.py
+    :start-after: [START sink_delete]
+    :end-before: [END sink_delete]
+    :dedent: 4
+
+Integration with Python logging module
+--------------------------------------
+
+It's possible to tie the Python :mod:`logging` module directly into Google
+Stackdriver Logging. There are different handler options to accomplish this.
+To automatically pick the default for your current environment, use
+:meth:`~google.cloud.logging.client.Client.get_default_handler`.
+
+.. literalinclude:: snippets.py
+    :start-after: [START create_default_handler]
+    :end-before: [END create_default_handler]
+    :dedent: 4
+
+It is also possible to attach the handler to the root Python logger, so that
+for example a plain ``logging.warn`` call would be sent to Stackdriver Logging,
+as well as any other loggers created. A helper method
+:meth:`~google.cloud.logging.client.Client.setup_logging` is provided
+to configure this automatically.
+
+.. literalinclude:: snippets.py
+    :start-after: [START setup_logging]
+    :end-before: [END setup_logging]
+    :dedent: 4
+
+.. note::
+
+    To reduce cost and quota usage, do not enable Stackdriver logging
+    handlers while testing locally.
+
+You can also exclude certain loggers:
+
+.. literalinclude:: snippets.py
+    :start-after: [START setup_logging_excludes]
+    :end-before: [END setup_logging_excludes]
+    :dedent: 4
+
+Cloud Logging Handler
+~~~~~~~~~~~~~~~~~~~~~
+
+If you prefer not to use
+:meth:`~google.cloud.logging.client.Client.get_default_handler`, you can
+directly create a
+:class:`~google.cloud.logging.handlers.handlers.CloudLoggingHandler` instance
+which will write directly to the API.
+
+.. literalinclude:: snippets.py
+    :start-after: [START create_cloud_handler]
+    :end-before: [END create_cloud_handler]
+    :dedent: 4
+
+.. note::
+
+    This handler by default uses an asynchronous transport that sends log
+    entries on a background thread. However, the API call will still be made
+    in the same process. For other transport options, see the transports
+    section.
+
+All logs will go to a single custom log, which defaults to "python". The name
+of the Python logger will be included in the structured log entry under the
+"python_logger" field. You can change it by providing a name to the handler:
+
+.. literalinclude:: snippets.py
+    :start-after: [START create_named_handler]
+    :end-before: [END create_named_handler]
+    :dedent: 4
+
+Cloud Logging Handler transports
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The :class:`~google.cloud.logging.handlers.handlers.CloudLoggingHandler`
+logging handler can use different transports. The default is
+:class:`~google.cloud.logging.handlers.BackgroundThreadTransport`.
+
+ 1. :class:`~google.cloud.logging.handlers.BackgroundThreadTransport` this is
+    the default. It writes entries on a background
+    :class:`python.threading.Thread`.
+
+ 1. :class:`~google.cloud.logging.handlers.SyncTransport` this handler does a
+    direct API call on each logging statement to write the entry.
+
+
+.. _Google Container Engine: https://cloud.google.com/container-engine/
+
+fluentd logging handlers
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Besides :class:`~google.cloud.logging.handlers.handlers.CloudLoggingHandler`,
+which writes directly to the API, two other handlers are provided.
+:class:`~google.cloud.logging.handlers.app_engine.AppEngineHandler`, which is
+recommended when running on the Google App Engine Flexible vanilla runtimes
+(i.e. your app.yaml contains ``runtime: python``), and
+:class:`~google.cloud.logging.handlers.container_engine.ContainerEngineHandler`
+, which is recommended when running on `Google Container Engine`_ with the
+Stackdriver Logging plugin enabled.
+
+:meth:`~google.cloud.logging.client.Client.get_default_handler` and
+:meth:`~google.cloud.logging.client.Client.setup_logging` will attempt to use
+the environment to automatically detect whether the code is running in
+these platforms and use the appropriate handler.
+
+In both cases, the fluentd agent is configured to automatically parse log files
+in an expected format and forward them to Stackdriver logging. The handlers
+provided help set the correct metadata such as log level so that logs can be
+filtered accordingly.
diff --git a/logging/google/__init__.py b/logging/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/logging/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/logging/google/cloud/__init__.py b/logging/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/logging/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/logging/google/cloud/logging/__init__.py b/logging/google/cloud/logging/__init__.py
new file mode 100644
index 000000000000..80de6c4b6113
--- /dev/null
+++ b/logging/google/cloud/logging/__init__.py
@@ -0,0 +1,30 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Stackdriver Logging API wrapper."""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-logging").version
+
+from google.cloud.logging.client import Client
+
+
+ASCENDING = "timestamp asc"
+"""Query string to order by ascending timestamps."""
+DESCENDING = "timestamp desc"
+"""Query string to order by decending timestamps."""
+
+__all__ = ["__version__", "ASCENDING", "Client", "DESCENDING"]
diff --git a/logging/google/cloud/logging/_gapic.py b/logging/google/cloud/logging/_gapic.py
new file mode 100644
index 000000000000..32897c088142
--- /dev/null
+++ b/logging/google/cloud/logging/_gapic.py
@@ -0,0 +1,574 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrapper for adapting the autogenerated gapic client to the hand-written
+client."""
+
+import functools
+
+from google.cloud.logging_v2.gapic.config_service_v2_client import ConfigServiceV2Client
+from google.cloud.logging_v2.gapic.logging_service_v2_client import (
+    LoggingServiceV2Client,
+)
+from google.cloud.logging_v2.gapic.metrics_service_v2_client import (
+    MetricsServiceV2Client,
+)
+from google.cloud.logging_v2.proto.logging_config_pb2 import LogSink
+from google.cloud.logging_v2.proto.logging_metrics_pb2 import LogMetric
+from google.cloud.logging_v2.proto.log_entry_pb2 import LogEntry
+from google.protobuf.json_format import MessageToDict
+from google.protobuf.json_format import ParseDict
+
+from google.cloud.logging._helpers import entry_from_resource
+from google.cloud.logging.sink import Sink
+from google.cloud.logging.metric import Metric
+
+
+class _LoggingAPI(object):
+    """Helper mapping logging-related APIs.
+
+    :type gapic_api:
+        :class:`.logging_service_v2_client.LoggingServiceV2Client`
+    :param gapic_api: API object used to make RPCs.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that owns this API object.
+    """
+
+    def __init__(self, gapic_api, client):
+        self._gapic_api = gapic_api
+        self._client = client
+
+    def list_entries(
+        self, projects, filter_="", order_by="", page_size=0, page_token=None
+    ):
+        """Return a page of log entry resources.
+
+        :type projects: list of strings
+        :param projects: project IDs to include. If not passed,
+                         defaults to the project bound to the API's client.
+
+        :type filter_: str
+        :param filter_:
+            a filter expression. See
+            https://cloud.google.com/logging/docs/view/advanced_filters
+
+        :type order_by: str
+        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
+                         or :data:`~google.cloud.logging.DESCENDING`.
+
+        :type page_size: int
+        :param page_size: maximum number of entries to return, If not passed,
+                          defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: opaque marker for the next "page" of entries. If not
+                           passed, the API will return the first page of
+                           entries.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~google.cloud.logging.entries._BaseEntry`
+                  accessible to the current API.
+        """
+        page_iter = self._gapic_api.list_log_entries(
+            [],
+            project_ids=projects,
+            filter_=filter_,
+            order_by=order_by,
+            page_size=page_size,
+        )
+        page_iter.client = self._client
+        page_iter.next_page_token = page_token
+
+        # We attach a mutable loggers dictionary so that as Logger
+        # objects are created by entry_from_resource, they can be
+        # re-used by other log entries from the same logger.
+        loggers = {}
+        page_iter.item_to_value = functools.partial(_item_to_entry, loggers=loggers)
+        return page_iter
+
+    def write_entries(self, entries, logger_name=None, resource=None, labels=None):
+        """API call:  log an entry resource via a POST request
+
+        :type entries: sequence of mapping
+        :param entries: the log entry resources to log.
+
+        :type logger_name: str
+        :param logger_name: name of default logger to which to log the entries;
+                            individual entries may override.
+
+        :type resource: mapping
+        :param resource: default resource to associate with entries;
+                         individual entries may override.
+
+        :type labels: mapping
+        :param labels: default labels to associate with entries;
+                       individual entries may override.
+        """
+        partial_success = False
+        entry_pbs = [_log_entry_mapping_to_pb(entry) for entry in entries]
+        self._gapic_api.write_log_entries(
+            entry_pbs,
+            log_name=logger_name,
+            resource=resource,
+            labels=labels,
+            partial_success=partial_success,
+        )
+
+    def logger_delete(self, project, logger_name):
+        """API call:  delete all entries in a logger via a DELETE request
+
+        :type project: str
+        :param project: ID of project containing the log entries to delete
+
+        :type logger_name: str
+        :param logger_name: name of logger containing the log entries to delete
+        """
+        path = "projects/%s/logs/%s" % (project, logger_name)
+        self._gapic_api.delete_log(path)
+
+
+class _SinksAPI(object):
+    """Helper mapping sink-related APIs.
+
+    :type gapic_api:
+        :class:`.config_service_v2_client.ConfigServiceV2Client`
+    :param gapic_api: API object used to make RPCs.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that owns this API object.
+    """
+
+    def __init__(self, gapic_api, client):
+        self._gapic_api = gapic_api
+        self._client = client
+
+    def list_sinks(self, project, page_size=0, page_token=None):
+        """List sinks for the project associated with this client.
+
+        :type project: str
+        :param project: ID of the project whose sinks are to be listed.
+
+        :type page_size: int
+        :param page_size: maximum number of sinks to return, If not passed,
+                          defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: opaque marker for the next "page" of sinks. If not
+                           passed, the API will return the first page of
+                           sinks.
+
+        :rtype: tuple, (list, str)
+        :returns: list of mappings, plus a "next page token" string:
+                  if not None, indicates that more sinks can be retrieved
+                  with another call (pass that value as ``page_token``).
+        """
+        path = "projects/%s" % (project,)
+        page_iter = self._gapic_api.list_sinks(path, page_size=page_size)
+        page_iter.client = self._client
+        page_iter.next_page_token = page_token
+        page_iter.item_to_value = _item_to_sink
+        return page_iter
+
+    def sink_create(
+        self, project, sink_name, filter_, destination, unique_writer_identity=False
+    ):
+        """API call:  create a sink resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create
+
+        :type project: str
+        :param project: ID of the project in which to create the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the sink.
+
+        :type destination: str
+        :param destination: destination URI for the entries exported by
+                            the sink.
+
+        :type unique_writer_identity: bool
+        :param unique_writer_identity: (Optional) determines the kind of
+                                       IAM identity returned as
+                                       writer_identity in the new sink.
+
+        :rtype: dict
+        :returns: The sink resource returned from the API (converted from a
+                  protobuf to a dictionary).
+        """
+        parent = "projects/%s" % (project,)
+        sink_pb = LogSink(name=sink_name, filter=filter_, destination=destination)
+        created_pb = self._gapic_api.create_sink(
+            parent, sink_pb, unique_writer_identity=unique_writer_identity
+        )
+        return MessageToDict(created_pb)
+
+    def sink_get(self, project, sink_name):
+        """API call:  retrieve a sink resource.
+
+        :type project: str
+        :param project: ID of the project containing the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+
+        :rtype: dict
+        :returns: The sink object returned from the API (converted from a
+                  protobuf to a dictionary).
+        """
+        path = "projects/%s/sinks/%s" % (project, sink_name)
+        sink_pb = self._gapic_api.get_sink(path)
+        # NOTE: LogSink message type does not have an ``Any`` field
+        #       so `MessageToDict`` can safely be used.
+        return MessageToDict(sink_pb)
+
+    def sink_update(
+        self, project, sink_name, filter_, destination, unique_writer_identity=False
+    ):
+        """API call:  update a sink resource.
+
+        :type project: str
+        :param project: ID of the project containing the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the sink.
+
+        :type destination: str
+        :param destination: destination URI for the entries exported by
+                            the sink.
+
+        :type unique_writer_identity: bool
+        :param unique_writer_identity: (Optional) determines the kind of
+                                       IAM identity returned as
+                                       writer_identity in the new sink.
+
+        :rtype: dict
+        :returns: The sink resource returned from the API (converted from a
+                  protobuf to a dictionary).
+        """
+        path = "projects/%s/sinks/%s" % (project, sink_name)
+        sink_pb = LogSink(name=path, filter=filter_, destination=destination)
+        sink_pb = self._gapic_api.update_sink(
+            path, sink_pb, unique_writer_identity=unique_writer_identity
+        )
+        # NOTE: LogSink message type does not have an ``Any`` field
+        #       so `MessageToDict`` can safely be used.
+        return MessageToDict(sink_pb)
+
+    def sink_delete(self, project, sink_name):
+        """API call:  delete a sink resource.
+
+        :type project: str
+        :param project: ID of the project containing the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+        """
+        path = "projects/%s/sinks/%s" % (project, sink_name)
+        self._gapic_api.delete_sink(path)
+
+
+class _MetricsAPI(object):
+    """Helper mapping sink-related APIs.
+
+    :type gapic_api:
+        :class:`.metrics_service_v2_client.MetricsServiceV2Client`
+
+    :param gapic_api: API object used to make RPCs.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that owns this API object.
+    """
+
+    def __init__(self, gapic_api, client):
+        self._gapic_api = gapic_api
+        self._client = client
+
+    def list_metrics(self, project, page_size=0, page_token=None):
+        """List metrics for the project associated with this client.
+
+        :type project: str
+        :param project: ID of the project whose metrics are to be listed.
+
+        :type page_size: int
+        :param page_size: maximum number of metrics to return, If not passed,
+                          defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: opaque marker for the next "page" of metrics. If not
+                           passed, the API will return the first page of
+                           metrics.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of
+                  :class:`~google.cloud.logging.metric.Metric`
+                  accessible to the current API.
+        """
+        path = "projects/%s" % (project,)
+        page_iter = self._gapic_api.list_log_metrics(path, page_size=page_size)
+        page_iter.client = self._client
+        page_iter.next_page_token = page_token
+        page_iter.item_to_value = _item_to_metric
+        return page_iter
+
+    def metric_create(self, project, metric_name, filter_, description):
+        """API call:  create a metric resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/create
+
+        :type project: str
+        :param project: ID of the project in which to create the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the metric.
+
+        :type description: str
+        :param description: description of the metric.
+        """
+        parent = "projects/%s" % (project,)
+        metric_pb = LogMetric(name=metric_name, filter=filter_, description=description)
+        self._gapic_api.create_log_metric(parent, metric_pb)
+
+    def metric_get(self, project, metric_name):
+        """API call:  retrieve a metric resource.
+
+        :type project: str
+        :param project: ID of the project containing the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+
+        :rtype: dict
+        :returns: The metric object returned from the API (converted from a
+                  protobuf to a dictionary).
+        """
+        path = "projects/%s/metrics/%s" % (project, metric_name)
+        metric_pb = self._gapic_api.get_log_metric(path)
+        # NOTE: LogMetric message type does not have an ``Any`` field
+        #       so `MessageToDict`` can safely be used.
+        return MessageToDict(metric_pb)
+
+    def metric_update(self, project, metric_name, filter_, description):
+        """API call:  update a metric resource.
+
+        :type project: str
+        :param project: ID of the project containing the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the metric.
+
+        :type description: str
+        :param description: description of the metric.
+
+        :rtype: dict
+        :returns: The metric object returned from the API (converted from a
+                  protobuf to a dictionary).
+        """
+        path = "projects/%s/metrics/%s" % (project, metric_name)
+        metric_pb = LogMetric(name=path, filter=filter_, description=description)
+        metric_pb = self._gapic_api.update_log_metric(path, metric_pb)
+        # NOTE: LogMetric message type does not have an ``Any`` field
+        #       so `MessageToDict`` can safely be used.
+        return MessageToDict(metric_pb)
+
+    def metric_delete(self, project, metric_name):
+        """API call:  delete a metric resource.
+
+        :type project: str
+        :param project: ID of the project containing the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+        """
+        path = "projects/%s/metrics/%s" % (project, metric_name)
+        self._gapic_api.delete_log_metric(path)
+
+
+def _parse_log_entry(entry_pb):
+    """Special helper to parse ``LogEntry`` protobuf into a dictionary.
+
+    The ``proto_payload`` field in ``LogEntry`` is of type ``Any``. This
+    can be problematic if the type URL in the payload isn't in the
+    ``google.protobuf`` registry. To help with parsing unregistered types,
+    this function will remove ``proto_payload`` before parsing.
+
+    :type entry_pb: :class:`.log_entry_pb2.LogEntry`
+    :param entry_pb: Log entry protobuf.
+
+    :rtype: dict
+    :returns: The parsed log entry. The ``protoPayload`` key may contain
+              the raw ``Any`` protobuf from ``entry_pb.proto_payload`` if
+              it could not be parsed.
+    """
+    try:
+        return MessageToDict(entry_pb)
+    except TypeError:
+        if entry_pb.HasField("proto_payload"):
+            proto_payload = entry_pb.proto_payload
+            entry_pb.ClearField("proto_payload")
+            entry_mapping = MessageToDict(entry_pb)
+            entry_mapping["protoPayload"] = proto_payload
+            return entry_mapping
+        else:
+            raise
+
+
+def _log_entry_mapping_to_pb(mapping):
+    """Helper for :meth:`write_entries`, et aliae
+
+    Performs "impedance matching" between the protobuf attrs and
+    the keys expected in the JSON API.
+    """
+    entry_pb = LogEntry()
+    # NOTE: We assume ``mapping`` was created in ``Batch.commit``
+    #       or ``Logger._make_entry_resource``. In either case, if
+    #       the ``protoPayload`` key is present, we assume that the
+    #       type URL is registered with ``google.protobuf`` and will
+    #       not cause any issues in the JSON->protobuf conversion
+    #       of the corresponding ``proto_payload`` in the log entry
+    #       (it is an ``Any`` field).
+    ParseDict(mapping, entry_pb)
+    return entry_pb
+
+
+def _item_to_entry(iterator, entry_pb, loggers):
+    """Convert a log entry protobuf to the native object.
+
+    .. note::
+
+        This method does not have the correct signature to be used as
+        the ``item_to_value`` argument to
+        :class:`~google.api_core.page_iterator.Iterator`. It is intended to be
+        patched with a mutable ``loggers`` argument that can be updated
+        on subsequent calls. For an example, see how the method is
+        used above in :meth:`_LoggingAPI.list_entries`.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type entry_pb: :class:`.log_entry_pb2.LogEntry`
+    :param entry_pb: Log entry protobuf returned from the API.
+
+    :type loggers: dict
+    :param loggers:
+        A mapping of logger fullnames -> loggers.  If the logger
+        that owns the entry is not in ``loggers``, the entry
+        will have a newly-created logger.
+
+    :rtype: :class:`~google.cloud.logging.entries._BaseEntry`
+    :returns: The next log entry in the page.
+    """
+    resource = _parse_log_entry(entry_pb)
+    return entry_from_resource(resource, iterator.client, loggers)
+
+
+def _item_to_sink(iterator, log_sink_pb):
+    """Convert a sink protobuf to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type log_sink_pb:
+        :class:`.logging_config_pb2.LogSink`
+    :param log_sink_pb: Sink protobuf returned from the API.
+
+    :rtype: :class:`~google.cloud.logging.sink.Sink`
+    :returns: The next sink in the page.
+    """
+    # NOTE: LogSink message type does not have an ``Any`` field
+    #       so `MessageToDict`` can safely be used.
+    resource = MessageToDict(log_sink_pb)
+    return Sink.from_api_repr(resource, iterator.client)
+
+
+def _item_to_metric(iterator, log_metric_pb):
+    """Convert a metric protobuf to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type log_metric_pb:
+        :class:`.logging_metrics_pb2.LogMetric`
+    :param log_metric_pb: Metric protobuf returned from the API.
+
+    :rtype: :class:`~google.cloud.logging.metric.Metric`
+    :returns: The next metric in the page.
+    """
+    # NOTE: LogMetric message type does not have an ``Any`` field
+    #       so `MessageToDict`` can safely be used.
+    resource = MessageToDict(log_metric_pb)
+    return Metric.from_api_repr(resource, iterator.client)
+
+
+def make_logging_api(client):
+    """Create an instance of the Logging API adapter.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that holds configuration details.
+
+    :rtype: :class:`_LoggingAPI`
+    :returns: A metrics API instance with the proper credentials.
+    """
+    generated = LoggingServiceV2Client(
+        credentials=client._credentials, client_info=client._client_info
+    )
+    return _LoggingAPI(generated, client)
+
+
+def make_metrics_api(client):
+    """Create an instance of the Metrics API adapter.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that holds configuration details.
+
+    :rtype: :class:`_MetricsAPI`
+    :returns: A metrics API instance with the proper credentials.
+    """
+    generated = MetricsServiceV2Client(
+        credentials=client._credentials, client_info=client._client_info
+    )
+    return _MetricsAPI(generated, client)
+
+
+def make_sinks_api(client):
+    """Create an instance of the Sinks API adapter.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that holds configuration details.
+
+    :rtype: :class:`_SinksAPI`
+    :returns: A metrics API instance with the proper credentials.
+    """
+    generated = ConfigServiceV2Client(
+        credentials=client._credentials, client_info=client._client_info
+    )
+    return _SinksAPI(generated, client)
diff --git a/logging/google/cloud/logging/_helpers.py b/logging/google/cloud/logging/_helpers.py
new file mode 100644
index 000000000000..4df8b12736bc
--- /dev/null
+++ b/logging/google/cloud/logging/_helpers.py
@@ -0,0 +1,125 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Common logging helpers."""
+
+import logging
+
+import requests
+
+from google.cloud.logging.entries import LogEntry
+from google.cloud.logging.entries import ProtobufEntry
+from google.cloud.logging.entries import StructEntry
+from google.cloud.logging.entries import TextEntry
+
+try:
+    from google.cloud.logging_v2.gapic.enums import LogSeverity
+except ImportError:  # pragma: NO COVER
+
+    class LogSeverity(object):
+        """Map severities for non-GAPIC usage."""
+
+        DEFAULT = 0
+        DEBUG = 100
+        INFO = 200
+        NOTICE = 300
+        WARNING = 400
+        ERROR = 500
+        CRITICAL = 600
+        ALERT = 700
+        EMERGENCY = 800
+
+
+_NORMALIZED_SEVERITIES = {
+    logging.CRITICAL: LogSeverity.CRITICAL,
+    logging.ERROR: LogSeverity.ERROR,
+    logging.WARNING: LogSeverity.WARNING,
+    logging.INFO: LogSeverity.INFO,
+    logging.DEBUG: LogSeverity.DEBUG,
+    logging.NOTSET: LogSeverity.DEFAULT,
+}
+
+METADATA_URL = "http://metadata.google.internal./computeMetadata/v1/"
+METADATA_HEADERS = {"Metadata-Flavor": "Google"}
+
+
+def entry_from_resource(resource, client, loggers):
+    """Detect correct entry type from resource and instantiate.
+
+    :type resource: dict
+    :param resource: One entry resource from API response.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: Client that owns the log entry.
+
+    :type loggers: dict
+    :param loggers:
+        A mapping of logger fullnames -> loggers.  If the logger
+        that owns the entry is not in ``loggers``, the entry
+        will have a newly-created logger.
+
+    :rtype: :class:`~google.cloud.logging.entries._BaseEntry`
+    :returns: The entry instance, constructed via the resource
+    """
+    if "textPayload" in resource:
+        return TextEntry.from_api_repr(resource, client, loggers)
+
+    if "jsonPayload" in resource:
+        return StructEntry.from_api_repr(resource, client, loggers)
+
+    if "protoPayload" in resource:
+        return ProtobufEntry.from_api_repr(resource, client, loggers)
+
+    return LogEntry.from_api_repr(resource, client, loggers)
+
+
+def retrieve_metadata_server(metadata_key):
+    """Retrieve the metadata key in the metadata server.
+
+    See: https://cloud.google.com/compute/docs/storing-retrieving-metadata
+
+    :type metadata_key: str
+    :param metadata_key: Key of the metadata which will form the url. You can
+                         also supply query parameters after the metadata key.
+                         e.g. "tags?alt=json"
+
+    :rtype: str
+    :returns: The value of the metadata key returned by the metadata server.
+    """
+    url = METADATA_URL + metadata_key
+
+    try:
+        response = requests.get(url, headers=METADATA_HEADERS)
+
+        if response.status_code == requests.codes.ok:
+            return response.text
+
+    except requests.exceptions.RequestException:
+        # Ignore the exception, connection failed means the attribute does not
+        # exist in the metadata server.
+        pass
+
+    return None
+
+
+def _normalize_severity(stdlib_level):
+    """Normalize a Python stdlib severity to LogSeverity enum.
+
+    :type stdlib_level: int
+    :param stdlib_level: 'levelno' from a :class:`logging.LogRecord`
+
+    :rtype: int
+    :returns: Corresponding Stackdriver severity.
+    """
+    return _NORMALIZED_SEVERITIES.get(stdlib_level, stdlib_level)
diff --git a/logging/google/cloud/logging/_http.py b/logging/google/cloud/logging/_http.py
new file mode 100644
index 000000000000..deb6b394f49d
--- /dev/null
+++ b/logging/google/cloud/logging/_http.py
@@ -0,0 +1,540 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Interact with Stackdriver Logging via JSON-over-HTTP."""
+
+import functools
+
+from google.api_core import page_iterator
+from google.cloud import _http
+
+from google.cloud.logging import __version__
+from google.cloud.logging._helpers import entry_from_resource
+from google.cloud.logging.sink import Sink
+from google.cloud.logging.metric import Metric
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google Stackdriver Logging via the JSON REST API.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions`
+    :param client_options (Optional) Client options used to set user options
+        on the client. API Endpoint should be set through client_options.
+    """
+
+    DEFAULT_API_ENDPOINT = "https://logging.googleapis.com"
+
+    def __init__(self, client, client_info=None, api_endpoint=DEFAULT_API_ENDPOINT):
+        super(Connection, self).__init__(client, client_info)
+        self.API_BASE_URL = api_endpoint
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_VERSION = "v2"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/{api_version}{path}"
+    """A template for the URL of a particular API call."""
+
+
+class _LoggingAPI(object):
+    """Helper mapping logging-related APIs.
+
+    See
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client used to make API requests.
+    """
+
+    def __init__(self, client):
+        self._client = client
+        self.api_request = client._connection.api_request
+
+    def list_entries(
+        self, projects, filter_=None, order_by=None, page_size=None, page_token=None
+    ):
+        """Return a page of log entry resources.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list
+
+        :type projects: list of strings
+        :param projects: project IDs to include. If not passed,
+                            defaults to the project bound to the client.
+
+        :type filter_: str
+        :param filter_:
+            a filter expression. See
+            https://cloud.google.com/logging/docs/view/advanced_filters
+
+        :type order_by: str
+        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
+                         or :data:`~google.cloud.logging.DESCENDING`.
+
+        :type page_size: int
+        :param page_size: maximum number of entries to return, If not passed,
+                          defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: opaque marker for the next "page" of entries. If not
+                           passed, the API will return the first page of
+                           entries.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~google.cloud.logging.entries._BaseEntry`
+                  accessible to the current API.
+        """
+        extra_params = {"projectIds": projects}
+
+        if filter_ is not None:
+            extra_params["filter"] = filter_
+
+        if order_by is not None:
+            extra_params["orderBy"] = order_by
+
+        if page_size is not None:
+            extra_params["pageSize"] = page_size
+
+        path = "/entries:list"
+        # We attach a mutable loggers dictionary so that as Logger
+        # objects are created by entry_from_resource, they can be
+        # re-used by other log entries from the same logger.
+        loggers = {}
+        item_to_value = functools.partial(_item_to_entry, loggers=loggers)
+        iterator = page_iterator.HTTPIterator(
+            client=self._client,
+            api_request=self._client._connection.api_request,
+            path=path,
+            item_to_value=item_to_value,
+            items_key="entries",
+            page_token=page_token,
+            extra_params=extra_params,
+        )
+        # This method uses POST to make a read-only request.
+        iterator._HTTP_METHOD = "POST"
+        return iterator
+
+    def write_entries(self, entries, logger_name=None, resource=None, labels=None):
+        """API call:  log an entry resource via a POST request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
+
+        :type entries: sequence of mapping
+        :param entries: the log entry resources to log.
+
+        :type logger_name: str
+        :param logger_name: name of default logger to which to log the entries;
+                            individual entries may override.
+
+        :type resource: mapping
+        :param resource: default resource to associate with entries;
+                         individual entries may override.
+
+        :type labels: mapping
+        :param labels: default labels to associate with entries;
+                       individual entries may override.
+        """
+        data = {"entries": list(entries)}
+
+        if logger_name is not None:
+            data["logName"] = logger_name
+
+        if resource is not None:
+            data["resource"] = resource
+
+        if labels is not None:
+            data["labels"] = labels
+
+        self.api_request(method="POST", path="/entries:write", data=data)
+
+    def logger_delete(self, project, logger_name):
+        """API call:  delete all entries in a logger via a DELETE request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs/delete
+
+        :type project: str
+        :param project: ID of project containing the log entries to delete
+
+        :type logger_name: str
+        :param logger_name: name of logger containing the log entries to delete
+        """
+        path = "/projects/%s/logs/%s" % (project, logger_name)
+        self.api_request(method="DELETE", path=path)
+
+
+class _SinksAPI(object):
+    """Helper mapping sink-related APIs.
+
+    See
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client used to make API requests.
+    """
+
+    def __init__(self, client):
+        self._client = client
+        self.api_request = client._connection.api_request
+
+    def list_sinks(self, project, page_size=None, page_token=None):
+        """List sinks for the project associated with this client.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/list
+
+        :type project: str
+        :param project: ID of the project whose sinks are to be listed.
+
+        :type page_size: int
+        :param page_size: maximum number of sinks to return, If not passed,
+                          defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: opaque marker for the next "page" of sinks. If not
+                           passed, the API will return the first page of
+                           sinks.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of
+                  :class:`~google.cloud.logging.sink.Sink`
+                  accessible to the current API.
+        """
+        extra_params = {}
+
+        if page_size is not None:
+            extra_params["pageSize"] = page_size
+
+        path = "/projects/%s/sinks" % (project,)
+        return page_iterator.HTTPIterator(
+            client=self._client,
+            api_request=self._client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_sink,
+            items_key="sinks",
+            page_token=page_token,
+            extra_params=extra_params,
+        )
+
+    def sink_create(
+        self, project, sink_name, filter_, destination, unique_writer_identity=False
+    ):
+        """API call:  create a sink resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create
+
+        :type project: str
+        :param project: ID of the project in which to create the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the sink.
+
+        :type destination: str
+        :param destination: destination URI for the entries exported by
+                            the sink.
+
+        :type unique_writer_identity: bool
+        :param unique_writer_identity: (Optional) determines the kind of
+                                       IAM identity returned as
+                                       writer_identity in the new sink.
+
+        :rtype: dict
+        :returns: The returned (created) resource.
+        """
+        target = "/projects/%s/sinks" % (project,)
+        data = {"name": sink_name, "filter": filter_, "destination": destination}
+        query_params = {"uniqueWriterIdentity": unique_writer_identity}
+        return self.api_request(
+            method="POST", path=target, data=data, query_params=query_params
+        )
+
+    def sink_get(self, project, sink_name):
+        """API call:  retrieve a sink resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get
+
+        :type project: str
+        :param project: ID of the project containing the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+
+        :rtype: dict
+        :returns: The JSON sink object returned from the API.
+        """
+        target = "/projects/%s/sinks/%s" % (project, sink_name)
+        return self.api_request(method="GET", path=target)
+
+    def sink_update(
+        self, project, sink_name, filter_, destination, unique_writer_identity=False
+    ):
+        """API call:  update a sink resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/update
+
+        :type project: str
+        :param project: ID of the project containing the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the sink.
+
+        :type destination: str
+        :param destination: destination URI for the entries exported by
+                            the sink.
+
+        :type unique_writer_identity: bool
+        :param unique_writer_identity: (Optional) determines the kind of
+                                       IAM identity returned as
+                                       writer_identity in the new sink.
+
+        :rtype: dict
+        :returns: The returned (updated) resource.
+        """
+        target = "/projects/%s/sinks/%s" % (project, sink_name)
+        data = {"name": sink_name, "filter": filter_, "destination": destination}
+        query_params = {"uniqueWriterIdentity": unique_writer_identity}
+        return self.api_request(
+            method="PUT", path=target, query_params=query_params, data=data
+        )
+
+    def sink_delete(self, project, sink_name):
+        """API call:  delete a sink resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/delete
+
+        :type project: str
+        :param project: ID of the project containing the sink.
+
+        :type sink_name: str
+        :param sink_name: the name of the sink
+        """
+        target = "/projects/%s/sinks/%s" % (project, sink_name)
+        self.api_request(method="DELETE", path=target)
+
+
+class _MetricsAPI(object):
+    """Helper mapping sink-related APIs.
+
+    See
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The client used to make API requests.
+    """
+
+    def __init__(self, client):
+        self._client = client
+        self.api_request = client._connection.api_request
+
+    def list_metrics(self, project, page_size=None, page_token=None):
+        """List metrics for the project associated with this client.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/list
+
+        :type project: str
+        :param project: ID of the project whose metrics are to be listed.
+
+        :type page_size: int
+        :param page_size: maximum number of metrics to return, If not passed,
+                          defaults to a value set by the API.
+
+        :type page_token: str
+        :param page_token: opaque marker for the next "page" of metrics. If not
+                           passed, the API will return the first page of
+                           metrics.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of
+                  :class:`~google.cloud.logging.metric.Metric`
+                  accessible to the current API.
+        """
+        extra_params = {}
+
+        if page_size is not None:
+            extra_params["pageSize"] = page_size
+
+        path = "/projects/%s/metrics" % (project,)
+        return page_iterator.HTTPIterator(
+            client=self._client,
+            api_request=self._client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_metric,
+            items_key="metrics",
+            page_token=page_token,
+            extra_params=extra_params,
+        )
+
+    def metric_create(self, project, metric_name, filter_, description=None):
+        """API call:  create a metric resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/create
+
+        :type project: str
+        :param project: ID of the project in which to create the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the metric.
+
+        :type description: str
+        :param description: description of the metric.
+        """
+        target = "/projects/%s/metrics" % (project,)
+        data = {"name": metric_name, "filter": filter_, "description": description}
+        self.api_request(method="POST", path=target, data=data)
+
+    def metric_get(self, project, metric_name):
+        """API call:  retrieve a metric resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/get
+
+        :type project: str
+        :param project: ID of the project containing the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+
+        :rtype: dict
+        :returns: The JSON metric object returned from the API.
+        """
+        target = "/projects/%s/metrics/%s" % (project, metric_name)
+        return self.api_request(method="GET", path=target)
+
+    def metric_update(self, project, metric_name, filter_, description):
+        """API call:  update a metric resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/update
+
+        :type project: str
+        :param project: ID of the project containing the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries exported by the metric.
+
+        :type description: str
+        :param description: description of the metric.
+
+        :rtype: dict
+        :returns: The returned (updated) resource.
+        """
+        target = "/projects/%s/metrics/%s" % (project, metric_name)
+        data = {"name": metric_name, "filter": filter_, "description": description}
+        return self.api_request(method="PUT", path=target, data=data)
+
+    def metric_delete(self, project, metric_name):
+        """API call:  delete a metric resource.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/delete
+
+        :type project: str
+        :param project: ID of the project containing the metric.
+
+        :type metric_name: str
+        :param metric_name: the name of the metric.
+        """
+        target = "/projects/%s/metrics/%s" % (project, metric_name)
+        self.api_request(method="DELETE", path=target)
+
+
+def _item_to_entry(iterator, resource, loggers):
+    """Convert a log entry resource to the native object.
+
+    .. note::
+
+        This method does not have the correct signature to be used as
+        the ``item_to_value`` argument to
+        :class:`~google.api_core.page_iterator.Iterator`. It is intended to be
+        patched with a mutable ``loggers`` argument that can be updated
+        on subsequent calls. For an example, see how the method is
+        used above in :meth:`_LoggingAPI.list_entries`.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: Log entry JSON resource returned from the API.
+
+    :type loggers: dict
+    :param loggers:
+        A mapping of logger fullnames -> loggers.  If the logger
+        that owns the entry is not in ``loggers``, the entry
+        will have a newly-created logger.
+
+    :rtype: :class:`~google.cloud.logging.entries._BaseEntry`
+    :returns: The next log entry in the page.
+    """
+    return entry_from_resource(resource, iterator.client, loggers)
+
+
+def _item_to_sink(iterator, resource):
+    """Convert a sink resource to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: Sink JSON resource returned from the API.
+
+    :rtype: :class:`~google.cloud.logging.sink.Sink`
+    :returns: The next sink in the page.
+    """
+    return Sink.from_api_repr(resource, iterator.client)
+
+
+def _item_to_metric(iterator, resource):
+    """Convert a metric resource to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type resource: dict
+    :param resource: Metric JSON resource returned from the API.
+
+    :rtype: :class:`~google.cloud.logging.metric.Metric`
+    :returns: The next metric in the page.
+    """
+    return Metric.from_api_repr(resource, iterator.client)
diff --git a/logging/google/cloud/logging/client.py b/logging/google/cloud/logging/client.py
new file mode 100644
index 000000000000..680c29c8a9dd
--- /dev/null
+++ b/logging/google/cloud/logging/client.py
@@ -0,0 +1,400 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Google Stackdriver Logging API."""
+
+import logging
+import os
+
+try:
+    from google.cloud.logging import _gapic
+except ImportError:  # pragma: NO COVER
+    _HAVE_GRPC = False
+    _gapic = None
+else:
+    _HAVE_GRPC = True
+
+import google.api_core.client_options
+from google.cloud.client import ClientWithProject
+from google.cloud.environment_vars import DISABLE_GRPC
+from google.cloud.logging._helpers import retrieve_metadata_server
+from google.cloud.logging._http import Connection
+from google.cloud.logging._http import _LoggingAPI as JSONLoggingAPI
+from google.cloud.logging._http import _MetricsAPI as JSONMetricsAPI
+from google.cloud.logging._http import _SinksAPI as JSONSinksAPI
+from google.cloud.logging.handlers import CloudLoggingHandler
+from google.cloud.logging.handlers import AppEngineHandler
+from google.cloud.logging.handlers import ContainerEngineHandler
+from google.cloud.logging.handlers import setup_logging
+from google.cloud.logging.handlers.handlers import EXCLUDED_LOGGER_DEFAULTS
+
+from google.cloud.logging.logger import Logger
+from google.cloud.logging.metric import Metric
+from google.cloud.logging.sink import Sink
+
+
+_DISABLE_GRPC = os.getenv(DISABLE_GRPC, False)
+_USE_GRPC = _HAVE_GRPC and not _DISABLE_GRPC
+
+_APPENGINE_FLEXIBLE_ENV_VM = "GAE_APPENGINE_HOSTNAME"
+"""Environment variable set in App Engine when vm:true is set."""
+
+_APPENGINE_INSTANCE_ID = "GAE_INSTANCE"
+"""Environment variable set in App Engine standard and flexible environment."""
+
+_GKE_CLUSTER_NAME = "instance/attributes/cluster-name"
+"""Attribute in metadata server when in GKE environment."""
+
+
+class Client(ClientWithProject):
+    """Client to bundle configuration needed for API requests.
+
+    :type project: str
+    :param project: the project which the client acts on behalf of.
+                    If not passed, falls back to the default inferred
+                    from the environment.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type _use_grpc: bool
+    :param _use_grpc: (Optional) Explicitly specifies whether
+                      to use the gRPC transport or HTTP. If unset,
+                      falls back to the ``GOOGLE_CLOUD_DISABLE_GRPC``
+                      environment variable
+                      This parameter should be considered private, and could
+                      change in the future.
+
+    :type client_info:
+        :class:`google.api_core.client_info.ClientInfo` or
+        :class:`google.api_core.gapic_v1.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions`
+        or :class:`dict`
+    :param client_options: (Optional) Client options used to set user options
+        on the client. API Endpoint should be set through client_options.
+    """
+
+    _logging_api = None
+    _sinks_api = None
+    _metrics_api = None
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/logging.read",
+        "https://www.googleapis.com/auth/logging.write",
+        "https://www.googleapis.com/auth/logging.admin",
+        "https://www.googleapis.com/auth/cloud-platform",
+    )
+    """The scopes required for authenticating as a Logging consumer."""
+
+    def __init__(
+        self,
+        project=None,
+        credentials=None,
+        _http=None,
+        _use_grpc=None,
+        client_info=None,
+        client_options=None,
+    ):
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+
+        kw_args = {"client_info": client_info}
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+                kw_args["api_endpoint"] = api_endpoint
+
+        self._connection = Connection(self, **kw_args)
+
+        self._client_info = client_info
+        if _use_grpc is None:
+            self._use_grpc = _USE_GRPC
+        else:
+            self._use_grpc = _use_grpc
+
+    @property
+    def logging_api(self):
+        """Helper for logging-related API calls.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs
+        """
+        if self._logging_api is None:
+            if self._use_grpc:
+                self._logging_api = _gapic.make_logging_api(self)
+            else:
+                self._logging_api = JSONLoggingAPI(self)
+        return self._logging_api
+
+    @property
+    def sinks_api(self):
+        """Helper for log sink-related API calls.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks
+        """
+        if self._sinks_api is None:
+            if self._use_grpc:
+                self._sinks_api = _gapic.make_sinks_api(self)
+            else:
+                self._sinks_api = JSONSinksAPI(self)
+        return self._sinks_api
+
+    @property
+    def metrics_api(self):
+        """Helper for log metric-related API calls.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics
+        """
+        if self._metrics_api is None:
+            if self._use_grpc:
+                self._metrics_api = _gapic.make_metrics_api(self)
+            else:
+                self._metrics_api = JSONMetricsAPI(self)
+        return self._metrics_api
+
+    def logger(self, name):
+        """Creates a logger bound to the current client.
+
+        :type name: str
+        :param name: the name of the logger to be constructed.
+
+        :rtype: :class:`google.cloud.logging.logger.Logger`
+        :returns: Logger created with the current client.
+        """
+        return Logger(name, client=self)
+
+    def list_entries(
+        self,
+        projects=None,
+        filter_=None,
+        order_by=None,
+        page_size=None,
+        page_token=None,
+    ):
+        """Return a page of log entries.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list
+
+        :type projects: list of strings
+        :param projects: project IDs to include. If not passed,
+                            defaults to the project bound to the client.
+
+        :type filter_: str
+        :param filter_:
+            a filter expression. See
+            https://cloud.google.com/logging/docs/view/advanced_filters
+
+        :type order_by: str
+        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
+                         or :data:`~google.cloud.logging.DESCENDING`.
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of entries in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of entries, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~google.cloud.logging.entries._BaseEntry`
+                  accessible to the current client.
+        """
+        if projects is None:
+            projects = [self.project]
+
+        return self.logging_api.list_entries(
+            projects=projects,
+            filter_=filter_,
+            order_by=order_by,
+            page_size=page_size,
+            page_token=page_token,
+        )
+
+    def sink(self, name, filter_=None, destination=None):
+        """Creates a sink bound to the current client.
+
+        :type name: str
+        :param name: the name of the sink to be constructed.
+
+        :type filter_: str
+        :param filter_: (optional) the advanced logs filter expression
+                        defining the entries exported by the sink.  If not
+                        passed, the instance should already exist, to be
+                        refreshed via :meth:`Sink.reload`.
+
+        :type destination: str
+        :param destination: destination URI for the entries exported by
+                            the sink.  If not passed, the instance should
+                            already exist, to be refreshed via
+                            :meth:`Sink.reload`.
+
+        :rtype: :class:`google.cloud.logging.sink.Sink`
+        :returns: Sink created with the current client.
+        """
+        return Sink(name, filter_, destination, client=self)
+
+    def list_sinks(self, page_size=None, page_token=None):
+        """List sinks for the project associated with this client.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/list
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of sinks in each page of results from
+            this request. Non-positive values are ignored. Defaults to a
+            sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of sinks, using the
+            value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing the
+            token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of
+                  :class:`~google.cloud.logging.sink.Sink`
+                  accessible to the current client.
+        """
+        return self.sinks_api.list_sinks(self.project, page_size, page_token)
+
+    def metric(self, name, filter_=None, description=""):
+        """Creates a metric bound to the current client.
+
+        :type name: str
+        :param name: the name of the metric to be constructed.
+
+        :type filter_: str
+        :param filter_: the advanced logs filter expression defining the
+                        entries tracked by the metric.  If not
+                        passed, the instance should already exist, to be
+                        refreshed via :meth:`Metric.reload`.
+
+        :type description: str
+        :param description: the description of the metric to be constructed.
+                            If not passed, the instance should already exist,
+                            to be refreshed via :meth:`Metric.reload`.
+
+        :rtype: :class:`google.cloud.logging.metric.Metric`
+        :returns: Metric created with the current client.
+        """
+        return Metric(name, filter_, client=self, description=description)
+
+    def list_metrics(self, page_size=None, page_token=None):
+        """List metrics for the project associated with this client.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/list
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of metrics in each page of results
+            from this request. Non-positive values are ignored. Defaults to a
+            sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of metrics, using the
+            value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing the
+            token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of :class:`~google.cloud.logging.metric.Metric`
+                  accessible to the current client.
+        """
+        return self.metrics_api.list_metrics(self.project, page_size, page_token)
+
+    def get_default_handler(self, **kw):
+        """Return the default logging handler based on the local environment.
+
+        :type kw: dict
+        :param kw: keyword args passed to handler constructor
+
+        :rtype: :class:`logging.Handler`
+        :returns: The default log handler based on the environment
+        """
+        gke_cluster_name = retrieve_metadata_server(_GKE_CLUSTER_NAME)
+
+        if (
+            _APPENGINE_FLEXIBLE_ENV_VM in os.environ
+            or _APPENGINE_INSTANCE_ID in os.environ
+        ):
+            return AppEngineHandler(self, **kw)
+        elif gke_cluster_name is not None:
+            return ContainerEngineHandler(**kw)
+        else:
+            return CloudLoggingHandler(self, **kw)
+
+    def setup_logging(
+        self, log_level=logging.INFO, excluded_loggers=EXCLUDED_LOGGER_DEFAULTS, **kw
+    ):
+        """Attach default Stackdriver logging handler to the root logger.
+
+        This method uses the default log handler, obtained by
+        :meth:`~get_default_handler`, and attaches it to the root Python
+        logger, so that a call such as ``logging.warn``, as well as all child
+        loggers, will report to Stackdriver logging.
+
+        :type log_level: int
+        :param log_level: (Optional) Python logging log level. Defaults to
+                          :const:`logging.INFO`.
+
+        :type excluded_loggers: tuple
+        :param excluded_loggers: (Optional) The loggers to not attach the
+                                 handler to. This will always include the
+                                 loggers in the path of the logging client
+                                 itself.
+
+        :type kw: dict
+        :param kw: keyword args passed to handler constructor
+        """
+        handler = self.get_default_handler(**kw)
+        setup_logging(handler, log_level=log_level, excluded_loggers=excluded_loggers)
diff --git a/logging/google/cloud/logging/entries.py b/logging/google/cloud/logging/entries.py
new file mode 100644
index 000000000000..ed1c28163f60
--- /dev/null
+++ b/logging/google/cloud/logging/entries.py
@@ -0,0 +1,371 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Log entries within the Google Stackdriver Logging API."""
+
+import collections
+import json
+import re
+
+from google.protobuf.any_pb2 import Any
+from google.protobuf.json_format import MessageToDict
+from google.protobuf.json_format import Parse
+
+from google.cloud.logging.resource import Resource
+from google.cloud._helpers import _name_from_project_path
+from google.cloud._helpers import _rfc3339_nanos_to_datetime
+from google.cloud._helpers import _datetime_to_rfc3339
+
+
+_GLOBAL_RESOURCE = Resource(type="global", labels={})
+
+
+_LOGGER_TEMPLATE = re.compile(
+    r"""
+    projects/            # static prefix
+    (?P<project>[^/]+)   # initial letter, wordchars + hyphen
+    /logs/               # static midfix
+    (?P<name>[^/]+)      # initial letter, wordchars + allowed punc
+""",
+    re.VERBOSE,
+)
+
+
+def logger_name_from_path(path):
+    """Validate a logger URI path and get the logger name.
+
+    :type path: str
+    :param path: URI path for a logger API request.
+
+    :rtype: str
+    :returns: Logger name parsed from ``path``.
+    :raises: :class:`ValueError` if the ``path`` is ill-formed or if
+             the project from the ``path`` does not agree with the
+             ``project`` passed in.
+    """
+    return _name_from_project_path(path, None, _LOGGER_TEMPLATE)
+
+
+def _int_or_none(value):
+    """Helper: return an integer or ``None``."""
+    if value is not None:
+        value = int(value)
+    return value
+
+
+_LOG_ENTRY_FIELDS = (  # (name, default)
+    ("log_name", None),
+    ("labels", None),
+    ("insert_id", None),
+    ("severity", None),
+    ("http_request", None),
+    ("timestamp", None),
+    ("resource", _GLOBAL_RESOURCE),
+    ("trace", None),
+    ("span_id", None),
+    ("trace_sampled", None),
+    ("source_location", None),
+    ("operation", None),
+    ("logger", None),
+    ("payload", None),
+)
+
+
+_LogEntryTuple = collections.namedtuple(
+    "LogEntry", (field for field, _ in _LOG_ENTRY_FIELDS)
+)
+
+_LogEntryTuple.__new__.__defaults__ = tuple(default for _, default in _LOG_ENTRY_FIELDS)
+
+
+_LOG_ENTRY_PARAM_DOCSTRING = """\
+
+    :type log_name: str
+    :param log_name: the name of the logger used to post the entry.
+
+    :type labels: dict
+    :param labels: (optional) mapping of labels for the entry
+
+    :type insert_id: text
+    :param insert_id: (optional) the ID used to identify an entry uniquely.
+
+    :type severity: str
+    :param severity: (optional) severity of event being logged.
+
+    :type http_request: dict
+    :param http_request: (optional) info about HTTP request associated with
+                            the entry.
+
+    :type timestamp: :class:`datetime.datetime`
+    :param timestamp: (optional) timestamp for the entry
+
+    :type resource: :class:`~google.cloud.logging.resource.Resource`
+    :param resource: (Optional) Monitored resource of the entry
+
+    :type trace: str
+    :param trace: (optional) traceid to apply to the entry.
+
+    :type span_id: str
+    :param span_id: (optional) span_id within the trace for the log entry.
+                    Specify the trace parameter if span_id is set.
+
+    :type trace_sampled: bool
+    :param trace_sampled: (optional) the sampling decision of the trace
+                          associated with the log entry.
+
+    :type source_location: dict
+    :param source_location: (optional) location in source code from which
+                            the entry was emitted.
+
+    :type operation: dict
+    :param operation: (optional) additional information about a potentially
+                      long-running operation associated with the log entry.
+
+    :type logger: :class:`google.cloud.logging.logger.Logger`
+    :param logger: the logger used to write the entry.
+
+"""
+
+_LOG_ENTRY_SEE_ALSO_DOCSTRING = """\
+
+    See:
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry
+"""
+
+
+class LogEntry(_LogEntryTuple):
+    __doc__ = (
+        """
+    Log entry.
+
+    """
+        + _LOG_ENTRY_PARAM_DOCSTRING
+        + _LOG_ENTRY_SEE_ALSO_DOCSTRING
+    )
+
+    received_timestamp = None
+
+    @classmethod
+    def _extract_payload(cls, resource):
+        """Helper for :meth:`from_api_repr`"""
+        return None
+
+    @classmethod
+    def from_api_repr(cls, resource, client, loggers=None):
+        """Factory:  construct an entry given its API representation
+
+        :type resource: dict
+        :param resource: text entry resource representation returned from
+                         the API
+
+        :type client: :class:`google.cloud.logging.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration.
+
+        :type loggers: dict
+        :param loggers:
+            (Optional) A mapping of logger fullnames -> loggers.  If not
+            passed, the entry will have a newly-created logger.
+
+        :rtype: :class:`google.cloud.logging.entries.LogEntry`
+        :returns: Log entry parsed from ``resource``.
+        """
+        if loggers is None:
+            loggers = {}
+        logger_fullname = resource["logName"]
+        logger = loggers.get(logger_fullname)
+        if logger is None:
+            logger_name = logger_name_from_path(logger_fullname)
+            logger = loggers[logger_fullname] = client.logger(logger_name)
+        payload = cls._extract_payload(resource)
+        insert_id = resource.get("insertId")
+        timestamp = resource.get("timestamp")
+        if timestamp is not None:
+            timestamp = _rfc3339_nanos_to_datetime(timestamp)
+        labels = resource.get("labels")
+        severity = resource.get("severity")
+        http_request = resource.get("httpRequest")
+        trace = resource.get("trace")
+        span_id = resource.get("spanId")
+        trace_sampled = resource.get("traceSampled")
+        source_location = resource.get("sourceLocation")
+        if source_location is not None:
+            line = source_location.pop("line", None)
+            source_location["line"] = _int_or_none(line)
+        operation = resource.get("operation")
+
+        monitored_resource_dict = resource.get("resource")
+        monitored_resource = None
+        if monitored_resource_dict is not None:
+            monitored_resource = Resource._from_dict(monitored_resource_dict)
+
+        inst = cls(
+            log_name=logger_fullname,
+            insert_id=insert_id,
+            timestamp=timestamp,
+            labels=labels,
+            severity=severity,
+            http_request=http_request,
+            resource=monitored_resource,
+            trace=trace,
+            span_id=span_id,
+            trace_sampled=trace_sampled,
+            source_location=source_location,
+            operation=operation,
+            logger=logger,
+            payload=payload,
+        )
+        received = resource.get("receiveTimestamp")
+        if received is not None:
+            inst.received_timestamp = _rfc3339_nanos_to_datetime(received)
+        return inst
+
+    def to_api_repr(self):
+        """API repr (JSON format) for entry.
+        """
+        info = {}
+        if self.log_name is not None:
+            info["logName"] = self.log_name
+        if self.resource is not None:
+            info["resource"] = self.resource._to_dict()
+        if self.labels is not None:
+            info["labels"] = self.labels
+        if self.insert_id is not None:
+            info["insertId"] = self.insert_id
+        if self.severity is not None:
+            info["severity"] = self.severity
+        if self.http_request is not None:
+            info["httpRequest"] = self.http_request
+        if self.timestamp is not None:
+            info["timestamp"] = _datetime_to_rfc3339(self.timestamp)
+        if self.trace is not None:
+            info["trace"] = self.trace
+        if self.span_id is not None:
+            info["spanId"] = self.span_id
+        if self.trace_sampled is not None:
+            info["traceSampled"] = self.trace_sampled
+        if self.source_location is not None:
+            source_location = self.source_location.copy()
+            source_location["line"] = str(source_location.pop("line", 0))
+            info["sourceLocation"] = source_location
+        if self.operation is not None:
+            info["operation"] = self.operation
+        return info
+
+
+class TextEntry(LogEntry):
+    __doc__ = (
+        """
+    Log entry with text payload.
+
+    """
+        + _LOG_ENTRY_PARAM_DOCSTRING
+        + """
+
+    :type payload: str | unicode
+    :param payload: payload for the log entry.
+    """
+        + _LOG_ENTRY_SEE_ALSO_DOCSTRING
+    )
+
+    @classmethod
+    def _extract_payload(cls, resource):
+        """Helper for :meth:`from_api_repr`"""
+        return resource["textPayload"]
+
+    def to_api_repr(self):
+        """API repr (JSON format) for entry.
+        """
+        info = super(TextEntry, self).to_api_repr()
+        info["textPayload"] = self.payload
+        return info
+
+
+class StructEntry(LogEntry):
+    __doc__ = (
+        """
+    Log entry with JSON payload.
+
+    """
+        + _LOG_ENTRY_PARAM_DOCSTRING
+        + """
+
+    :type payload: dict
+    :param payload: payload for the log entry.
+    """
+        + _LOG_ENTRY_SEE_ALSO_DOCSTRING
+    )
+
+    @classmethod
+    def _extract_payload(cls, resource):
+        """Helper for :meth:`from_api_repr`"""
+        return resource["jsonPayload"]
+
+    def to_api_repr(self):
+        """API repr (JSON format) for entry.
+        """
+        info = super(StructEntry, self).to_api_repr()
+        info["jsonPayload"] = self.payload
+        return info
+
+
+class ProtobufEntry(LogEntry):
+    __doc__ = (
+        """
+    Log entry with protobuf message payload.
+
+    """
+        + _LOG_ENTRY_PARAM_DOCSTRING
+        + """
+
+    :type payload: protobuf message
+    :param payload: payload for the log entry.
+    """
+        + _LOG_ENTRY_SEE_ALSO_DOCSTRING
+    )
+
+    @classmethod
+    def _extract_payload(cls, resource):
+        """Helper for :meth:`from_api_repr`"""
+        return resource["protoPayload"]
+
+    @property
+    def payload_pb(self):
+        if isinstance(self.payload, Any):
+            return self.payload
+
+    @property
+    def payload_json(self):
+        if not isinstance(self.payload, Any):
+            return self.payload
+
+    def to_api_repr(self):
+        """API repr (JSON format) for entry.
+        """
+        info = super(ProtobufEntry, self).to_api_repr()
+        info["protoPayload"] = MessageToDict(self.payload)
+        return info
+
+    def parse_message(self, message):
+        """Parse payload into a protobuf message.
+
+        Mutates the passed-in ``message`` in place.
+
+        :type message: Protobuf message
+        :param message: the message to be logged
+        """
+        # NOTE: This assumes that ``payload`` is already a deserialized
+        #       ``Any`` field and ``message`` has come from an imported
+        #       ``pb2`` module with the relevant protobuf message type.
+        Parse(json.dumps(self.payload), message)
diff --git a/logging/google/cloud/logging/handlers/__init__.py b/logging/google/cloud/logging/handlers/__init__.py
new file mode 100644
index 000000000000..67b96c95e907
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/__init__.py
@@ -0,0 +1,27 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Python :mod:`logging` handlers for Google Cloud Logging."""
+
+from google.cloud.logging.handlers.app_engine import AppEngineHandler
+from google.cloud.logging.handlers.container_engine import ContainerEngineHandler
+from google.cloud.logging.handlers.handlers import CloudLoggingHandler
+from google.cloud.logging.handlers.handlers import setup_logging
+
+__all__ = [
+    "AppEngineHandler",
+    "CloudLoggingHandler",
+    "ContainerEngineHandler",
+    "setup_logging",
+]
diff --git a/logging/google/cloud/logging/handlers/_helpers.py b/logging/google/cloud/logging/handlers/_helpers.py
new file mode 100644
index 000000000000..d65a2690f8f7
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/_helpers.py
@@ -0,0 +1,142 @@
+# Copyright 2016 Google LLC 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.
+
+"""Helper functions for logging handlers."""
+
+import math
+import json
+
+try:
+    import flask
+except ImportError:  # pragma: NO COVER
+    flask = None
+
+try:
+    import webapp2
+except (ImportError, SyntaxError):  # pragma: NO COVER
+    # If you try to import webapp2 under python3, you'll get a syntax
+    # error (since it hasn't been ported yet).  We just pretend it
+    # doesn't exist.  This is unlikely to hit in real life but does
+    # in the tests.
+    webapp2 = None
+
+from google.cloud.logging.handlers.middleware.request import _get_django_request
+
+_DJANGO_TRACE_HEADER = "HTTP_X_CLOUD_TRACE_CONTEXT"
+_FLASK_TRACE_HEADER = "X_CLOUD_TRACE_CONTEXT"
+_WEBAPP2_TRACE_HEADER = "X-CLOUD-TRACE-CONTEXT"
+
+
+def format_stackdriver_json(record, message):
+    """Helper to format a LogRecord in in Stackdriver fluentd format.
+
+        :rtype: str
+        :returns: JSON str to be written to the log file.
+    """
+    subsecond, second = math.modf(record.created)
+
+    payload = {
+        "message": message,
+        "timestamp": {"seconds": int(second), "nanos": int(subsecond * 1e9)},
+        "thread": record.thread,
+        "severity": record.levelname,
+    }
+
+    return json.dumps(payload)
+
+
+def get_trace_id_from_flask():
+    """Get trace_id from flask request headers.
+
+    :rtype: str
+    :returns: TraceID in HTTP request headers.
+    """
+    if flask is None or not flask.request:
+        return None
+
+    header = flask.request.headers.get(_FLASK_TRACE_HEADER)
+
+    if header is None:
+        return None
+
+    trace_id = header.split("/", 1)[0]
+
+    return trace_id
+
+
+def get_trace_id_from_webapp2():
+    """Get trace_id from webapp2 request headers.
+
+    :rtype: str
+    :returns: TraceID in HTTP request headers.
+    """
+    if webapp2 is None:
+        return None
+
+    try:
+        # get_request() succeeds if we're in the middle of a webapp2
+        # request, or raises an assertion error otherwise:
+        # "Request global variable is not set".
+        req = webapp2.get_request()
+    except AssertionError:
+        return None
+
+    header = req.headers.get(_WEBAPP2_TRACE_HEADER)
+
+    if header is None:
+        return None
+
+    trace_id = header.split("/", 1)[0]
+
+    return trace_id
+
+
+def get_trace_id_from_django():
+    """Get trace_id from django request headers.
+
+    :rtype: str
+    :returns: TraceID in HTTP request headers.
+    """
+    request = _get_django_request()
+
+    if request is None:
+        return None
+
+    header = request.META.get(_DJANGO_TRACE_HEADER)
+    if header is None:
+        return None
+
+    trace_id = header.split("/", 1)[0]
+
+    return trace_id
+
+
+def get_trace_id():
+    """Helper to get trace_id from web application request header.
+
+    :rtype: str
+    :returns: TraceID in HTTP request headers.
+    """
+    checkers = (
+        get_trace_id_from_django,
+        get_trace_id_from_flask,
+        get_trace_id_from_webapp2,
+    )
+
+    for checker in checkers:
+        trace_id = checker()
+        if trace_id is not None:
+            return trace_id
+
+    return None
diff --git a/logging/google/cloud/logging/handlers/app_engine.py b/logging/google/cloud/logging/handlers/app_engine.py
new file mode 100644
index 000000000000..d0179fb6dcfc
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/app_engine.py
@@ -0,0 +1,124 @@
+# Copyright 2016 Google LLC 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.
+
+"""Logging handler for App Engine Flexible
+
+Sends logs to the Stackdriver Logging API with the appropriate resource
+and labels for App Engine logs.
+"""
+
+import logging
+import os
+
+from google.cloud.logging.handlers._helpers import get_trace_id
+from google.cloud.logging.handlers.transports import BackgroundThreadTransport
+from google.cloud.logging.resource import Resource
+
+_DEFAULT_GAE_LOGGER_NAME = "app"
+
+_GAE_PROJECT_ENV_FLEX = "GCLOUD_PROJECT"
+_GAE_PROJECT_ENV_STANDARD = "GOOGLE_CLOUD_PROJECT"
+_GAE_SERVICE_ENV = "GAE_SERVICE"
+_GAE_VERSION_ENV = "GAE_VERSION"
+
+_TRACE_ID_LABEL = "appengine.googleapis.com/trace_id"
+
+
+class AppEngineHandler(logging.StreamHandler):
+    """A logging handler that sends App Engine-formatted logs to Stackdriver.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The authenticated Google Cloud Logging client for this
+                   handler to use.
+
+    :type transport: :class:`type`
+    :param transport: The transport class. It should be a subclass
+                      of :class:`.Transport`. If unspecified,
+                      :class:`.BackgroundThreadTransport` will be used.
+
+    :type stream: file-like object
+    :param stream: (optional) stream to be used by the handler.
+    """
+
+    def __init__(
+        self,
+        client,
+        name=_DEFAULT_GAE_LOGGER_NAME,
+        transport=BackgroundThreadTransport,
+        stream=None,
+    ):
+        super(AppEngineHandler, self).__init__(stream)
+        self.name = name
+        self.client = client
+        self.transport = transport(client, name)
+        self.project_id = os.environ.get(
+            _GAE_PROJECT_ENV_FLEX, os.environ.get(_GAE_PROJECT_ENV_STANDARD, "")
+        )
+        self.module_id = os.environ.get(_GAE_SERVICE_ENV, "")
+        self.version_id = os.environ.get(_GAE_VERSION_ENV, "")
+        self.resource = self.get_gae_resource()
+
+    def get_gae_resource(self):
+        """Return the GAE resource using the environment variables.
+
+        :rtype: :class:`~google.cloud.logging.resource.Resource`
+        :returns: Monitored resource for GAE.
+        """
+        gae_resource = Resource(
+            type="gae_app",
+            labels={
+                "project_id": self.project_id,
+                "module_id": self.module_id,
+                "version_id": self.version_id,
+            },
+        )
+        return gae_resource
+
+    def get_gae_labels(self):
+        """Return the labels for GAE app.
+
+        If the trace ID can be detected, it will be included as a label.
+        Currently, no other labels are included.
+
+        :rtype: dict
+        :returns: Labels for GAE app.
+        """
+        gae_labels = {}
+
+        trace_id = get_trace_id()
+        if trace_id is not None:
+            gae_labels[_TRACE_ID_LABEL] = trace_id
+
+        return gae_labels
+
+    def emit(self, record):
+        """Actually log the specified logging record.
+
+        Overrides the default emit behavior of ``StreamHandler``.
+
+        See https://docs.python.org/2/library/logging.html#handler-objects
+
+        :type record: :class:`logging.LogRecord`
+        :param record: The record to be logged.
+        """
+        message = super(AppEngineHandler, self).format(record)
+        gae_labels = self.get_gae_labels()
+        trace_id = (
+            "projects/%s/traces/%s" % (self.project_id, gae_labels[_TRACE_ID_LABEL])
+            if _TRACE_ID_LABEL in gae_labels
+            else None
+        )
+        self.transport.send(
+            record, message, resource=self.resource, labels=gae_labels, trace=trace_id
+        )
diff --git a/logging/google/cloud/logging/handlers/container_engine.py b/logging/google/cloud/logging/handlers/container_engine.py
new file mode 100644
index 000000000000..3e80b7650de1
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/container_engine.py
@@ -0,0 +1,54 @@
+# Copyright 2016 Google LLC 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.
+
+"""Logging handler for Google Container Engine (GKE).
+
+Formats log messages in a JSON format, so that Kubernetes clusters with the
+fluentd Google Cloud plugin installed can format their log messages so that
+metadata such as log level is properly captured.
+"""
+
+import logging.handlers
+
+from google.cloud.logging.handlers._helpers import format_stackdriver_json
+
+
+class ContainerEngineHandler(logging.StreamHandler):
+    """Handler to format log messages the format expected by GKE fluent.
+
+    This handler is written to format messages for the Google Container Engine
+    (GKE) fluentd plugin, so that metadata such as log level are properly set.
+
+    :type name: str
+    :param name: (optional) the name of the custom log in Stackdriver Logging.
+
+    :type stream: file-like object
+    :param stream: (optional) stream to be used by the handler.
+    """
+
+    def __init__(self, name=None, stream=None):
+        super(ContainerEngineHandler, self).__init__()
+        self.name = name
+
+    def format(self, record):
+        """Format the message into JSON expected by fluentd.
+
+        :type record: :class:`~logging.LogRecord`
+        :param record: the log record
+
+        :rtype: str
+        :returns: A JSON string formatted for GKE fluentd.
+        """
+        message = super(ContainerEngineHandler, self).format(record)
+        return format_stackdriver_json(record, message)
diff --git a/logging/google/cloud/logging/handlers/handlers.py b/logging/google/cloud/logging/handlers/handlers.py
new file mode 100644
index 000000000000..111cec8d27cf
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/handlers.py
@@ -0,0 +1,156 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Python :mod:`logging` handlers for Stackdriver Logging."""
+
+import logging
+
+from google.cloud.logging.handlers.transports import BackgroundThreadTransport
+from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+DEFAULT_LOGGER_NAME = "python"
+
+EXCLUDED_LOGGER_DEFAULTS = ("google.cloud", "google.auth", "google_auth_httplib2")
+
+
+class CloudLoggingHandler(logging.StreamHandler):
+    """Handler that directly makes Stackdriver logging API calls.
+
+    This is a Python standard ``logging`` handler using that can be used to
+    route Python standard logging messages directly to the Stackdriver
+    Logging API.
+
+    This handler is used when not in GAE or GKE environment.
+
+    This handler supports both an asynchronous and synchronous transport.
+
+    :type client: :class:`google.cloud.logging.client.Client`
+    :param client: the authenticated Google Cloud Logging client for this
+                   handler to use
+
+    :type name: str
+    :param name: the name of the custom log in Stackdriver Logging. Defaults
+                 to 'python'. The name of the Python logger will be represented
+                 in the ``python_logger`` field.
+
+    :type transport: :class:`type`
+    :param transport: Class for creating new transport objects. It should
+                      extend from the base :class:`.Transport` type and
+                      implement :meth`.Transport.send`. Defaults to
+                      :class:`.BackgroundThreadTransport`. The other
+                      option is :class:`.SyncTransport`.
+
+    :type resource: :class:`~google.cloud.logging.resource.Resource`
+    :param resource: (Optional) Monitored resource of the entry, defaults
+                     to the global resource type.
+
+    :type labels: dict
+    :param labels: (Optional) Mapping of labels for the entry.
+
+    :type stream: file-like object
+    :param stream: (optional) stream to be used by the handler.
+
+    Example:
+
+    .. code-block:: python
+
+        import logging
+        import google.cloud.logging
+        from google.cloud.logging.handlers import CloudLoggingHandler
+
+        client = google.cloud.logging.Client()
+        handler = CloudLoggingHandler(client)
+
+        cloud_logger = logging.getLogger('cloudLogger')
+        cloud_logger.setLevel(logging.INFO)
+        cloud_logger.addHandler(handler)
+
+        cloud_logger.error('bad news')  # API call
+    """
+
+    def __init__(
+        self,
+        client,
+        name=DEFAULT_LOGGER_NAME,
+        transport=BackgroundThreadTransport,
+        resource=_GLOBAL_RESOURCE,
+        labels=None,
+        stream=None,
+    ):
+        super(CloudLoggingHandler, self).__init__(stream)
+        self.name = name
+        self.client = client
+        self.transport = transport(client, name)
+        self.resource = resource
+        self.labels = labels
+
+    def emit(self, record):
+        """Actually log the specified logging record.
+
+        Overrides the default emit behavior of ``StreamHandler``.
+
+        See https://docs.python.org/2/library/logging.html#handler-objects
+
+        :type record: :class:`logging.LogRecord`
+        :param record: The record to be logged.
+        """
+        message = super(CloudLoggingHandler, self).format(record)
+        self.transport.send(record, message, resource=self.resource, labels=self.labels)
+
+
+def setup_logging(
+    handler, excluded_loggers=EXCLUDED_LOGGER_DEFAULTS, log_level=logging.INFO
+):
+    """Attach a logging handler to the Python root logger
+
+    Excludes loggers that this library itself uses to avoid
+    infinite recursion.
+
+    :type handler: :class:`logging.handler`
+    :param handler: the handler to attach to the global handler
+
+    :type excluded_loggers: tuple
+    :param excluded_loggers: (Optional) The loggers to not attach the handler
+                             to. This will always include the loggers in the
+                             path of the logging client itself.
+
+    :type log_level: int
+    :param log_level: (Optional) Python logging log level. Defaults to
+                      :const:`logging.INFO`.
+
+    Example:
+
+    .. code-block:: python
+
+        import logging
+        import google.cloud.logging
+        from google.cloud.logging.handlers import CloudLoggingHandler
+
+        client = google.cloud.logging.Client()
+        handler = CloudLoggingHandler(client)
+        google.cloud.logging.handlers.setup_logging(handler)
+        logging.getLogger().setLevel(logging.DEBUG)
+
+        logging.error('bad news')  # API call
+
+    """
+    all_excluded_loggers = set(excluded_loggers + EXCLUDED_LOGGER_DEFAULTS)
+    logger = logging.getLogger()
+    logger.setLevel(log_level)
+    logger.addHandler(handler)
+    logger.addHandler(logging.StreamHandler())
+    for logger_name in all_excluded_loggers:
+        logger = logging.getLogger(logger_name)
+        logger.propagate = False
+        logger.addHandler(logging.StreamHandler())
diff --git a/logging/google/cloud/logging/handlers/middleware/__init__.py b/logging/google/cloud/logging/handlers/middleware/__init__.py
new file mode 100644
index 000000000000..d8ba3016f724
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/middleware/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2017 Google LLC 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.
+
+from google.cloud.logging.handlers.middleware.request import RequestMiddleware
+
+__all__ = ["RequestMiddleware"]
diff --git a/logging/google/cloud/logging/handlers/middleware/request.py b/logging/google/cloud/logging/handlers/middleware/request.py
new file mode 100644
index 000000000000..33bc278fcf60
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/middleware/request.py
@@ -0,0 +1,57 @@
+# Copyright 2017 Google LLC 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.
+
+"""Django middleware helper to capture a request.
+
+The request is stored on a thread-local so that it can be
+inspected by other helpers.
+"""
+
+import threading
+
+
+_thread_locals = threading.local()
+
+
+def _get_django_request():
+    """Get Django request from thread local.
+
+    :rtype: str
+    :returns: Django request.
+    """
+    return getattr(_thread_locals, "request", None)
+
+
+try:
+    # Django >= 1.10
+    from django.utils.deprecation import MiddlewareMixin
+except ImportError:
+    # Not required for Django <= 1.9, see:
+    # https://docs.djangoproject.com/en/1.10/topics/http/middleware/#upgrading-pre-django-1-10-style-middleware
+    MiddlewareMixin = object
+
+
+class RequestMiddleware(MiddlewareMixin):
+    """Saves the request in thread local"""
+
+    def __init__(self, get_response=None):
+        self.get_response = get_response
+
+    def process_request(self, request):
+        """Called on each request, before Django decides which view to execute.
+
+        :type request: :class:`~django.http.request.HttpRequest`
+        :param request: Django http request.
+        """
+        _thread_locals.request = request
diff --git a/logging/google/cloud/logging/handlers/transports/__init__.py b/logging/google/cloud/logging/handlers/transports/__init__.py
new file mode 100644
index 000000000000..3c6cc214e5e3
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/transports/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Transport classes for Python logging integration.
+
+Currently two options are provided, a synchronous transport that makes
+an API call for each log statement, and an asynchronous handler that
+sends the API using a :class:`~google.cloud.logging.logger.Batch` object in
+the background.
+"""
+
+from google.cloud.logging.handlers.transports.base import Transport
+from google.cloud.logging.handlers.transports.sync import SyncTransport
+from google.cloud.logging.handlers.transports.background_thread import (
+    BackgroundThreadTransport,
+)
+
+__all__ = ["BackgroundThreadTransport", "SyncTransport", "Transport"]
diff --git a/logging/google/cloud/logging/handlers/transports/background_thread.py b/logging/google/cloud/logging/handlers/transports/background_thread.py
new file mode 100644
index 000000000000..812b733cff92
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/transports/background_thread.py
@@ -0,0 +1,353 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Transport for Python logging handler
+
+Uses a background worker to log to Stackdriver Logging asynchronously.
+"""
+
+from __future__ import print_function
+
+import atexit
+import datetime
+import logging
+import sys
+import threading
+import time
+
+from six.moves import queue
+
+from google.cloud.logging import _helpers
+from google.cloud.logging.handlers.transports.base import Transport
+
+_DEFAULT_GRACE_PERIOD = 5.0  # Seconds
+_DEFAULT_MAX_BATCH_SIZE = 10
+_DEFAULT_MAX_LATENCY = 0  # Seconds
+_WORKER_THREAD_NAME = "google.cloud.logging.Worker"
+_WORKER_TERMINATOR = object()
+_LOGGER = logging.getLogger(__name__)
+
+
+def _get_many(queue_, max_items=None, max_latency=0):
+    """Get multiple items from a Queue.
+
+    Gets at least one (blocking) and at most ``max_items`` items
+    (non-blocking) from a given Queue. Does not mark the items as done.
+
+    :type queue_: :class:`~queue.Queue`
+    :param queue_: The Queue to get items from.
+
+    :type max_items: int
+    :param max_items: The maximum number of items to get. If ``None``, then all
+        available items in the queue are returned.
+
+    :type max_latency: float
+    :param max_latency: The maximum number of seconds to wait for more than one
+        item from a queue. This number includes the time required to retrieve
+        the first item.
+
+    :rtype: list
+    :returns: items retrieved from the queue.
+    """
+    start = time.time()
+    # Always return at least one item.
+    items = [queue_.get()]
+    while max_items is None or len(items) < max_items:
+        try:
+            elapsed = time.time() - start
+            timeout = max(0, max_latency - elapsed)
+            items.append(queue_.get(timeout=timeout))
+        except queue.Empty:
+            break
+    return items
+
+
+class _Worker(object):
+    """A background thread that writes batches of log entries.
+
+    :type cloud_logger: :class:`~google.cloud.logging.logger.Logger`
+    :param cloud_logger: The logger to send entries to.
+
+    :type grace_period: float
+    :param grace_period: The amount of time to wait for pending logs to
+        be submitted when the process is shutting down.
+
+    :type max_batch_size: int
+    :param max_batch_size: The maximum number of items to send at a time
+        in the background thread.
+
+    :type max_latency: float
+    :param max_latency: The amount of time to wait for new logs before
+        sending a new batch. It is strongly recommended to keep this smaller
+        than the grace_period. This means this is effectively the longest
+        amount of time the background thread will hold onto log entries
+        before sending them to the server.
+    """
+
+    def __init__(
+        self,
+        cloud_logger,
+        grace_period=_DEFAULT_GRACE_PERIOD,
+        max_batch_size=_DEFAULT_MAX_BATCH_SIZE,
+        max_latency=_DEFAULT_MAX_LATENCY,
+    ):
+        self._cloud_logger = cloud_logger
+        self._grace_period = grace_period
+        self._max_batch_size = max_batch_size
+        self._max_latency = max_latency
+        self._queue = queue.Queue(0)
+        self._operational_lock = threading.Lock()
+        self._thread = None
+
+    @property
+    def is_alive(self):
+        """Returns True is the background thread is running."""
+        return self._thread is not None and self._thread.is_alive()
+
+    def _safely_commit_batch(self, batch):
+        total_logs = len(batch.entries)
+
+        try:
+            if total_logs > 0:
+                batch.commit()
+                _LOGGER.debug("Submitted %d logs", total_logs)
+        except Exception:
+            _LOGGER.error("Failed to submit %d logs.", total_logs, exc_info=True)
+
+    def _thread_main(self):
+        """The entry point for the worker thread.
+
+        Pulls pending log entries off the queue and writes them in batches to
+        the Cloud Logger.
+        """
+        _LOGGER.debug("Background thread started.")
+
+        done = False
+        while not done:
+            batch = self._cloud_logger.batch()
+            items = _get_many(
+                self._queue,
+                max_items=self._max_batch_size,
+                max_latency=self._max_latency,
+            )
+
+            for item in items:
+                if item is _WORKER_TERMINATOR:
+                    done = True  # Continue processing items.
+                else:
+                    batch.log_struct(**item)
+
+            self._safely_commit_batch(batch)
+
+            for _ in items:
+                self._queue.task_done()
+
+        _LOGGER.debug("Background thread exited gracefully.")
+
+    def start(self):
+        """Starts the background thread.
+
+        Additionally, this registers a handler for process exit to attempt
+        to send any pending log entries before shutdown.
+        """
+        with self._operational_lock:
+            if self.is_alive:
+                return
+
+            self._thread = threading.Thread(
+                target=self._thread_main, name=_WORKER_THREAD_NAME
+            )
+            self._thread.daemon = True
+            self._thread.start()
+            atexit.register(self._main_thread_terminated)
+
+    def stop(self, grace_period=None):
+        """Signals the background thread to stop.
+
+        This does not terminate the background thread. It simply queues the
+        stop signal. If the main process exits before the background thread
+        processes the stop signal, it will be terminated without finishing
+        work. The ``grace_period`` parameter will give the background
+        thread some time to finish processing before this function returns.
+
+        :type grace_period: float
+        :param grace_period: If specified, this method will block up to this
+            many seconds to allow the background thread to finish work before
+            returning.
+
+        :rtype: bool
+        :returns: True if the thread terminated. False if the thread is still
+            running.
+        """
+        if not self.is_alive:
+            return True
+
+        with self._operational_lock:
+            self._queue.put_nowait(_WORKER_TERMINATOR)
+
+            if grace_period is not None:
+                print("Waiting up to %d seconds." % (grace_period,), file=sys.stderr)
+
+            self._thread.join(timeout=grace_period)
+
+            # Check this before disowning the thread, because after we disown
+            # the thread is_alive will be False regardless of if the thread
+            # exited or not.
+            success = not self.is_alive
+
+            self._thread = None
+
+            return success
+
+    def _main_thread_terminated(self):
+        """Callback that attempts to send pending logs before termination."""
+        if not self.is_alive:
+            return
+
+        if not self._queue.empty():
+            print(
+                "Program shutting down, attempting to send %d queued log "
+                "entries to Stackdriver Logging..." % (self._queue.qsize(),),
+                file=sys.stderr,
+            )
+
+        if self.stop(self._grace_period):
+            print("Sent all pending logs.", file=sys.stderr)
+        else:
+            print(
+                "Failed to send %d pending logs." % (self._queue.qsize(),),
+                file=sys.stderr,
+            )
+
+    def enqueue(
+        self, record, message, resource=None, labels=None, trace=None, span_id=None
+    ):
+        """Queues a log entry to be written by the background thread.
+
+        :type record: :class:`logging.LogRecord`
+        :param record: Python log record that the handler was called with.
+
+        :type message: str
+        :param message: The message from the ``LogRecord`` after being
+                        formatted by the associated log formatters.
+
+        :type resource: :class:`~google.cloud.logging.resource.Resource`
+        :param resource: (Optional) Monitored resource of the entry
+
+        :type labels: dict
+        :param labels: (Optional) Mapping of labels for the entry.
+
+        :type trace: str
+        :param trace: (optional) traceid to apply to the logging entry.
+
+        :type span_id: str
+        :param span_id: (optional) span_id within the trace for the log entry.
+                        Specify the trace parameter if span_id is set.
+        """
+        queue_entry = {
+            "info": {"message": message, "python_logger": record.name},
+            "severity": _helpers._normalize_severity(record.levelno),
+            "resource": resource,
+            "labels": labels,
+            "trace": trace,
+            "span_id": span_id,
+            "timestamp": datetime.datetime.utcfromtimestamp(record.created),
+        }
+        self._queue.put_nowait(queue_entry)
+
+    def flush(self):
+        """Submit any pending log records."""
+        self._queue.join()
+
+
+class BackgroundThreadTransport(Transport):
+    """Asynchronous transport that uses a background thread.
+
+    :type client: :class:`~google.cloud.logging.client.Client`
+    :param client: The Logging client.
+
+    :type name: str
+    :param name: the name of the logger.
+
+    :type grace_period: float
+    :param grace_period: The amount of time to wait for pending logs to
+        be submitted when the process is shutting down.
+
+    :type batch_size: int
+    :param batch_size: The maximum number of items to send at a time in the
+        background thread.
+
+    :type max_latency: float
+    :param max_latency: The amount of time to wait for new logs before
+        sending a new batch. It is strongly recommended to keep this smaller
+        than the grace_period. This means this is effectively the longest
+        amount of time the background thread will hold onto log entries
+        before sending them to the server.
+    """
+
+    def __init__(
+        self,
+        client,
+        name,
+        grace_period=_DEFAULT_GRACE_PERIOD,
+        batch_size=_DEFAULT_MAX_BATCH_SIZE,
+        max_latency=_DEFAULT_MAX_LATENCY,
+    ):
+        self.client = client
+        logger = self.client.logger(name)
+        self.worker = _Worker(
+            logger,
+            grace_period=grace_period,
+            max_batch_size=batch_size,
+            max_latency=max_latency,
+        )
+        self.worker.start()
+
+    def send(
+        self, record, message, resource=None, labels=None, trace=None, span_id=None
+    ):
+        """Overrides Transport.send().
+
+        :type record: :class:`logging.LogRecord`
+        :param record: Python log record that the handler was called with.
+
+        :type message: str
+        :param message: The message from the ``LogRecord`` after being
+                        formatted by the associated log formatters.
+
+        :type resource: :class:`~google.cloud.logging.resource.Resource`
+        :param resource: (Optional) Monitored resource of the entry.
+
+        :type labels: dict
+        :param labels: (Optional) Mapping of labels for the entry.
+
+        :type trace: str
+        :param trace: (optional) traceid to apply to the logging entry.
+
+        :type span_id: str
+        :param span_id: (optional) span_id within the trace for the log entry.
+                        Specify the trace parameter if span_id is set.
+        """
+        self.worker.enqueue(
+            record,
+            message,
+            resource=resource,
+            labels=labels,
+            trace=trace,
+            span_id=span_id,
+        )
+
+    def flush(self):
+        """Submit any pending log records."""
+        self.worker.flush()
diff --git a/logging/google/cloud/logging/handlers/transports/base.py b/logging/google/cloud/logging/handlers/transports/base.py
new file mode 100644
index 000000000000..7e24cc0206ca
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/transports/base.py
@@ -0,0 +1,49 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Module containing base class for logging transport."""
+
+
+class Transport(object):
+    """Base class for Google Cloud Logging handler transports.
+
+    Subclasses of :class:`Transport` must have constructors that accept a
+    client and name object, and must override :meth:`send`.
+    """
+
+    def send(
+        self, record, message, resource=None, labels=None, trace=None, span_id=None
+    ):
+        """Transport send to be implemented by subclasses.
+
+        :type record: :class:`logging.LogRecord`
+        :param record: Python log record that the handler was called with.
+
+        :type message: str
+        :param message: The message from the ``LogRecord`` after being
+                        formatted by the associated log formatters.
+
+        :type resource: :class:`~google.cloud.logging.resource.Resource`
+        :param resource: (Optional) Monitored resource of the entry.
+
+        :type labels: dict
+        :param labels: (Optional) Mapping of labels for the entry.
+        """
+        raise NotImplementedError
+
+    def flush(self):
+        """Submit any pending log records.
+
+        For blocking/sync transports, this is a no-op.
+        """
diff --git a/logging/google/cloud/logging/handlers/transports/sync.py b/logging/google/cloud/logging/handlers/transports/sync.py
new file mode 100644
index 000000000000..e87eb4885fbf
--- /dev/null
+++ b/logging/google/cloud/logging/handlers/transports/sync.py
@@ -0,0 +1,59 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Transport for Python logging handler.
+
+Logs directly to the the Stackdriver Logging API with a synchronous call.
+"""
+
+from google.cloud.logging import _helpers
+from google.cloud.logging.handlers.transports.base import Transport
+
+
+class SyncTransport(Transport):
+    """Basic sychronous transport.
+
+    Uses this library's Logging client to directly make the API call.
+    """
+
+    def __init__(self, client, name):
+        self.logger = client.logger(name)
+
+    def send(
+        self, record, message, resource=None, labels=None, trace=None, span_id=None
+    ):
+        """Overrides transport.send().
+
+        :type record: :class:`logging.LogRecord`
+        :param record: Python log record that the handler was called with.
+
+        :type message: str
+        :param message: The message from the ``LogRecord`` after being
+                        formatted by the associated log formatters.
+
+        :type resource: :class:`~google.cloud.logging.resource.Resource`
+        :param resource: (Optional) Monitored resource of the entry.
+
+        :type labels: dict
+        :param labels: (Optional) Mapping of labels for the entry.
+        """
+        info = {"message": message, "python_logger": record.name}
+        self.logger.log_struct(
+            info,
+            severity=_helpers._normalize_severity(record.levelno),
+            resource=resource,
+            labels=labels,
+            trace=trace,
+            span_id=span_id,
+        )
diff --git a/logging/google/cloud/logging/logger.py b/logging/google/cloud/logging/logger.py
new file mode 100644
index 000000000000..b212b6e8b0c3
--- /dev/null
+++ b/logging/google/cloud/logging/logger.py
@@ -0,0 +1,384 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define API Loggers."""
+
+from google.cloud.logging.entries import LogEntry
+from google.cloud.logging.entries import ProtobufEntry
+from google.cloud.logging.entries import StructEntry
+from google.cloud.logging.entries import TextEntry
+from google.cloud.logging.resource import Resource
+
+
+_GLOBAL_RESOURCE = Resource(type="global", labels={})
+
+
+_OUTBOUND_ENTRY_FIELDS = (  # (name, default)
+    ("type_", None),
+    ("log_name", None),
+    ("payload", None),
+    ("labels", None),
+    ("insert_id", None),
+    ("severity", None),
+    ("http_request", None),
+    ("timestamp", None),
+    ("resource", _GLOBAL_RESOURCE),
+    ("trace", None),
+    ("span_id", None),
+    ("trace_sampled", None),
+    ("source_location", None),
+)
+
+
+class Logger(object):
+    """Loggers represent named targets for log entries.
+
+    See
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs
+
+    :type name: str
+    :param name: the name of the logger
+
+    :type client: :class:`google.cloud.logging.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the logger (which requires a project).
+
+    :type labels: dict
+    :param labels: (optional) mapping of default labels for entries written
+                   via this logger.
+    """
+
+    def __init__(self, name, client, labels=None):
+        self.name = name
+        self._client = client
+        self.labels = labels
+
+    @property
+    def client(self):
+        """Clent bound to the logger."""
+        return self._client
+
+    @property
+    def project(self):
+        """Project bound to the logger."""
+        return self._client.project
+
+    @property
+    def full_name(self):
+        """Fully-qualified name used in logging APIs"""
+        return "projects/%s/logs/%s" % (self.project, self.name)
+
+    @property
+    def path(self):
+        """URI path for use in logging APIs"""
+        return "/%s" % (self.full_name,)
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current logger.
+
+        :rtype: :class:`google.cloud.logging.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self._client
+        return client
+
+    def batch(self, client=None):
+        """Return a batch to use as a context manager.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current topic.
+
+        :rtype: :class:`Batch`
+        :returns: A batch to use as a context manager.
+        """
+        client = self._require_client(client)
+        return Batch(self, client)
+
+    def _do_log(self, client, _entry_class, payload=None, **kw):
+        """Helper for :meth:`log_empty`, :meth:`log_text`, etc.
+        """
+        client = self._require_client(client)
+
+        # Apply defaults
+        kw["log_name"] = kw.pop("log_name", self.full_name)
+        kw["labels"] = kw.pop("labels", self.labels)
+        kw["resource"] = kw.pop("resource", _GLOBAL_RESOURCE)
+
+        if payload is not None:
+            entry = _entry_class(payload=payload, **kw)
+        else:
+            entry = _entry_class(**kw)
+
+        api_repr = entry.to_api_repr()
+        client.logging_api.write_entries([api_repr])
+
+    def log_empty(self, client=None, **kw):
+        """API call:  log an empty message via a POST request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current logger.
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self._do_log(client, LogEntry, **kw)
+
+    def log_text(self, text, client=None, **kw):
+        """API call:  log a text message via a POST request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
+
+        :type text: str
+        :param text: the log message.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current logger.
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self._do_log(client, TextEntry, text, **kw)
+
+    def log_struct(self, info, client=None, **kw):
+        """API call:  log a structured message via a POST request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/write
+
+        :type info: dict
+        :param info: the log entry information
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current logger.
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self._do_log(client, StructEntry, info, **kw)
+
+    def log_proto(self, message, client=None, **kw):
+        """API call:  log a protobuf message via a POST request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list
+
+        :type message: :class:`~google.protobuf.message.Message`
+        :param message: The protobuf message to be logged.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current logger.
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self._do_log(client, ProtobufEntry, message, **kw)
+
+    def delete(self, client=None):
+        """API call:  delete all entries in a logger via a DELETE request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.logs/delete
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current logger.
+        """
+        client = self._require_client(client)
+        client.logging_api.logger_delete(self.project, self.name)
+
+    def list_entries(
+        self,
+        projects=None,
+        filter_=None,
+        order_by=None,
+        page_size=None,
+        page_token=None,
+    ):
+        """Return a page of log entries.
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/entries/list
+
+        :type projects: list of strings
+        :param projects: project IDs to include. If not passed,
+                            defaults to the project bound to the client.
+
+        :type filter_: str
+        :param filter_:
+            a filter expression. See
+            https://cloud.google.com/logging/docs/view/advanced_filters
+
+        :type order_by: str
+        :param order_by: One of :data:`~google.cloud.logging.ASCENDING`
+                         or :data:`~google.cloud.logging.DESCENDING`.
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of entries in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of entries, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of log entries accessible to the current logger.
+                  See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        log_filter = "logName=%s" % (self.full_name,)
+        if filter_ is not None:
+            filter_ = "%s AND %s" % (filter_, log_filter)
+        else:
+            filter_ = log_filter
+        return self.client.list_entries(
+            projects=projects,
+            filter_=filter_,
+            order_by=order_by,
+            page_size=page_size,
+            page_token=page_token,
+        )
+
+
+class Batch(object):
+    """Context manager:  collect entries to log via a single API call.
+
+    Helper returned by :meth:`Logger.batch`
+
+    :type logger: :class:`google.cloud.logging.logger.Logger`
+    :param logger: the logger to which entries will be logged.
+
+    :type client: :class:`google.cloud.logging.client.Client`
+    :param client: The client to use.
+
+    :type resource: :class:`~google.cloud.logging.resource.Resource`
+    :param resource: (Optional) Monitored resource of the batch, defaults
+                     to None, which requires that every entry should have a
+                     resource specified. Since the methods used to write
+                     entries default the entry's resource to the global
+                     resource type, this parameter is only required
+                     if explicitly set to None. If no entries' resource are
+                     set to None, this parameter will be ignored on the server.
+    """
+
+    def __init__(self, logger, client, resource=None):
+        self.logger = logger
+        self.entries = []
+        self.client = client
+        self.resource = resource
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type is None:
+            self.commit()
+
+    def log_empty(self, **kw):
+        """Add a entry without payload to be logged during :meth:`commit`.
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self.entries.append(LogEntry(**kw))
+
+    def log_text(self, text, **kw):
+        """Add a text entry to be logged during :meth:`commit`.
+
+        :type text: str
+        :param text: the text entry
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self.entries.append(TextEntry(payload=text, **kw))
+
+    def log_struct(self, info, **kw):
+        """Add a struct entry to be logged during :meth:`commit`.
+
+        :type info: dict
+        :param info: the struct entry
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self.entries.append(StructEntry(payload=info, **kw))
+
+    def log_proto(self, message, **kw):
+        """Add a protobuf entry to be logged during :meth:`commit`.
+
+        :type message: protobuf message
+        :param message: the protobuf entry
+
+        :type kw: dict
+        :param kw: (optional) additional keyword arguments for the entry.
+                   See :class:`~google.cloud.logging.entries.LogEntry`.
+        """
+        self.entries.append(ProtobufEntry(payload=message, **kw))
+
+    def commit(self, client=None):
+        """Send saved log entries as a single API call.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current batch.
+        """
+        if client is None:
+            client = self.client
+
+        kwargs = {"logger_name": self.logger.full_name}
+
+        if self.resource is not None:
+            kwargs["resource"] = self.resource._to_dict()
+
+        if self.logger.labels is not None:
+            kwargs["labels"] = self.logger.labels
+
+        entries = [entry.to_api_repr() for entry in self.entries]
+
+        client.logging_api.write_entries(entries, **kwargs)
+        del self.entries[:]
diff --git a/logging/google/cloud/logging/metric.py b/logging/google/cloud/logging/metric.py
new file mode 100644
index 000000000000..3fb91bb52f0a
--- /dev/null
+++ b/logging/google/cloud/logging/metric.py
@@ -0,0 +1,185 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define Stackdriver Logging API Metrics."""
+
+from google.cloud.exceptions import NotFound
+
+
+class Metric(object):
+    """Metrics represent named filters for log entries.
+
+    See
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics
+
+    :type name: str
+    :param name: the name of the metric
+
+    :type filter_: str
+    :param filter_: the advanced logs filter expression defining the entries
+                   tracked by the metric.  If not passed, the instance should
+                   already exist, to be refreshed via :meth:`reload`.
+
+    :type client: :class:`google.cloud.logging.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the metric (which requires a project).
+
+    :type description: str
+    :param description: an optional description of the metric.
+    """
+
+    def __init__(self, name, filter_=None, client=None, description=""):
+        self.name = name
+        self._client = client
+        self.filter_ = filter_
+        self.description = description
+
+    @property
+    def client(self):
+        """Clent bound to the logger."""
+        return self._client
+
+    @property
+    def project(self):
+        """Project bound to the logger."""
+        return self._client.project
+
+    @property
+    def full_name(self):
+        """Fully-qualified name used in metric APIs"""
+        return "projects/%s/metrics/%s" % (self.project, self.name)
+
+    @property
+    def path(self):
+        """URL path for the metric's APIs"""
+        return "/%s" % (self.full_name,)
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a metric given its API representation
+
+        :type resource: dict
+        :param resource: metric resource representation returned from the API
+
+        :type client: :class:`google.cloud.logging.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the metric.
+
+        :rtype: :class:`google.cloud.logging.metric.Metric`
+        :returns: Metric parsed from ``resource``.
+        """
+        metric_name = resource["name"]
+        filter_ = resource["filter"]
+        description = resource.get("description", "")
+        return cls(metric_name, filter_, client=client, description=description)
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current metric.
+
+        :rtype: :class:`google.cloud.logging.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self._client
+        return client
+
+    def create(self, client=None):
+        """API call:  create the metric via a PUT request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/create
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current metric.
+        """
+        client = self._require_client(client)
+        client.metrics_api.metric_create(
+            self.project, self.name, self.filter_, self.description
+        )
+
+    def exists(self, client=None):
+        """API call:  test for the existence of the metric via a GET request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/get
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current metric.
+
+        :rtype: bool
+        :returns: Boolean indicating existence of the metric.
+        """
+        client = self._require_client(client)
+
+        try:
+            client.metrics_api.metric_get(self.project, self.name)
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self, client=None):
+        """API call:  sync local metric configuration via a GET request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/get
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current metric.
+        """
+        client = self._require_client(client)
+        data = client.metrics_api.metric_get(self.project, self.name)
+        self.description = data.get("description", "")
+        self.filter_ = data["filter"]
+
+    def update(self, client=None):
+        """API call:  update metric configuration via a PUT request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/update
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current metric.
+        """
+        client = self._require_client(client)
+        client.metrics_api.metric_update(
+            self.project, self.name, self.filter_, self.description
+        )
+
+    def delete(self, client=None):
+        """API call:  delete a metric via a DELETE request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.metrics/delete
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current metric.
+        """
+        client = self._require_client(client)
+        client.metrics_api.metric_delete(self.project, self.name)
diff --git a/logging/google/cloud/logging/resource.py b/logging/google/cloud/logging/resource.py
new file mode 100644
index 000000000000..dda59ca09f61
--- /dev/null
+++ b/logging/google/cloud/logging/resource.py
@@ -0,0 +1,53 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Monitored Resource for the Google Logging API V2."""
+
+import collections
+
+
+class Resource(collections.namedtuple("Resource", "type labels")):
+    """A monitored resource identified by specifying values for all labels.
+
+    :type type: str
+    :param type: The resource type name.
+
+    :type labels: dict
+    :param labels: A mapping from label names to values for all labels
+                   enumerated in the associated :class:`ResourceDescriptor`.
+    """
+
+    __slots__ = ()
+
+    @classmethod
+    def _from_dict(cls, info):
+        """Construct a resource object from the parsed JSON representation.
+
+        :type info: dict
+        :param info:
+            A ``dict`` parsed from the JSON wire-format representation.
+
+        :rtype: :class:`Resource`
+        :returns: A resource object.
+        """
+        return cls(type=info["type"], labels=info.get("labels", {}))
+
+    def _to_dict(self):
+        """Build a dictionary ready to be serialized to the JSON format.
+
+        :rtype: dict
+        :returns: A dict representation of the object that can be written to
+                  the API.
+        """
+        return {"type": self.type, "labels": self.labels}
diff --git a/logging/google/cloud/logging/sink.py b/logging/google/cloud/logging/sink.py
new file mode 100644
index 000000000000..2a7d46fdbb81
--- /dev/null
+++ b/logging/google/cloud/logging/sink.py
@@ -0,0 +1,220 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Define Stackdriver Logging API Sinks."""
+
+from google.cloud.exceptions import NotFound
+
+
+class Sink(object):
+    """Sinks represent filtered exports for log entries.
+
+    See
+    https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks
+
+    :type name: str
+    :param name: the name of the sink
+
+    :type filter_: str
+    :param filter_: (optional) the advanced logs filter expression defining
+                    the entries exported by the sink.
+
+    :type destination: str
+    :param destination: destination URI for the entries exported by the sink.
+                        If not passed, the instance should already exist, to
+                        be refreshed via :meth:`reload`.
+
+    :type client: :class:`google.cloud.logging.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the sink (which requires a project).
+    """
+
+    def __init__(self, name, filter_=None, destination=None, client=None):
+        self.name = name
+        self.filter_ = filter_
+        self.destination = destination
+        self._client = client
+        self._writer_identity = None
+
+    @property
+    def client(self):
+        """Client bound to the sink."""
+        return self._client
+
+    @property
+    def project(self):
+        """Project bound to the sink."""
+        return self._client.project
+
+    @property
+    def full_name(self):
+        """Fully-qualified name used in sink APIs"""
+        return "projects/%s/sinks/%s" % (self.project, self.name)
+
+    @property
+    def path(self):
+        """URL path for the sink's APIs"""
+        return "/%s" % (self.full_name)
+
+    @property
+    def writer_identity(self):
+        """Identity used for exports via the sink"""
+        return self._writer_identity
+
+    def _update_from_api_repr(self, resource):
+        """Helper for API methods returning sink resources."""
+        self.destination = resource["destination"]
+        self.filter_ = resource.get("filter")
+        self._writer_identity = resource.get("writerIdentity")
+
+    @classmethod
+    def from_api_repr(cls, resource, client):
+        """Factory:  construct a sink given its API representation
+
+        :type resource: dict
+        :param resource: sink resource representation returned from the API
+
+        :type client: :class:`google.cloud.logging.client.Client`
+        :param client: Client which holds credentials and project
+                       configuration for the sink.
+
+        :rtype: :class:`google.cloud.logging.sink.Sink`
+        :returns: Sink parsed from ``resource``.
+        :raises: :class:`ValueError` if ``client`` is not ``None`` and the
+                 project from the resource does not agree with the project
+                 from the client.
+        """
+        sink_name = resource["name"]
+        instance = cls(sink_name, client=client)
+        instance._update_from_api_repr(resource)
+        return instance
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current sink.
+
+        :rtype: :class:`google.cloud.logging.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self._client
+        return client
+
+    def create(self, client=None, unique_writer_identity=False):
+        """API call:  create the sink via a PUT request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current sink.
+
+        :type unique_writer_identity: bool
+        :param unique_writer_identity: (Optional) determines the kind of
+                                    IAM identity returned as
+                                    writer_identity in the new sink.
+        """
+        client = self._require_client(client)
+        resource = client.sinks_api.sink_create(
+            self.project,
+            self.name,
+            self.filter_,
+            self.destination,
+            unique_writer_identity=unique_writer_identity,
+        )
+        self._update_from_api_repr(resource)
+
+    def exists(self, client=None):
+        """API call:  test for the existence of the sink via a GET request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current sink.
+
+        :rtype: bool
+        :returns: Boolean indicating existence of the sink.
+        """
+        client = self._require_client(client)
+
+        try:
+            client.sinks_api.sink_get(self.project, self.name)
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self, client=None):
+        """API call:  sync local sink configuration via a GET request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current sink.
+        """
+        client = self._require_client(client)
+        resource = client.sinks_api.sink_get(self.project, self.name)
+        self._update_from_api_repr(resource)
+
+    def update(self, client=None, unique_writer_identity=False):
+        """API call:  update sink configuration via a PUT request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/update
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current sink.
+
+        :type unique_writer_identity: bool
+        :param unique_writer_identity: (Optional) determines the kind of
+                                    IAM identity returned as
+                                    writer_identity in the new sink.
+        """
+        client = self._require_client(client)
+        resource = client.sinks_api.sink_update(
+            self.project,
+            self.name,
+            self.filter_,
+            self.destination,
+            unique_writer_identity=unique_writer_identity,
+        )
+        self._update_from_api_repr(resource)
+
+    def delete(self, client=None):
+        """API call:  delete a sink via a DELETE request
+
+        See
+        https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/delete
+
+        :type client: :class:`~google.cloud.logging.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current sink.
+        """
+        client = self._require_client(client)
+        client.sinks_api.sink_delete(self.project, self.name)
diff --git a/logging/google/cloud/logging_v2/__init__.py b/logging/google/cloud/logging_v2/__init__.py
new file mode 100644
index 000000000000..964c99572fd6
--- /dev/null
+++ b/logging/google/cloud/logging_v2/__init__.py
@@ -0,0 +1,45 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.logging_v2 import types
+from google.cloud.logging_v2.gapic import config_service_v2_client
+from google.cloud.logging_v2.gapic import enums
+from google.cloud.logging_v2.gapic import logging_service_v2_client
+from google.cloud.logging_v2.gapic import metrics_service_v2_client
+
+
+class LoggingServiceV2Client(logging_service_v2_client.LoggingServiceV2Client):
+    __doc__ = logging_service_v2_client.LoggingServiceV2Client.__doc__
+    enums = enums
+
+
+class ConfigServiceV2Client(config_service_v2_client.ConfigServiceV2Client):
+    __doc__ = config_service_v2_client.ConfigServiceV2Client.__doc__
+    enums = enums
+
+
+class MetricsServiceV2Client(metrics_service_v2_client.MetricsServiceV2Client):
+    __doc__ = metrics_service_v2_client.MetricsServiceV2Client.__doc__
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "LoggingServiceV2Client",
+    "ConfigServiceV2Client",
+    "MetricsServiceV2Client",
+)
diff --git a/logging/google/cloud/logging_v2/gapic/__init__.py b/logging/google/cloud/logging_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/logging/google/cloud/logging_v2/gapic/config_service_v2_client.py b/logging/google/cloud/logging_v2/gapic/config_service_v2_client.py
new file mode 100644
index 000000000000..df942566a397
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/config_service_v2_client.py
@@ -0,0 +1,1242 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.logging.v2 ConfigServiceV2 API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.api import monitored_resource_pb2
+from google.cloud.logging_v2.gapic import config_service_v2_client_config
+from google.cloud.logging_v2.gapic import enums
+from google.cloud.logging_v2.gapic.transports import config_service_v2_grpc_transport
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_config_pb2
+from google.cloud.logging_v2.proto import logging_config_pb2_grpc
+from google.cloud.logging_v2.proto import logging_pb2
+from google.cloud.logging_v2.proto import logging_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-logging").version
+
+
+class ConfigServiceV2Client(object):
+    """
+    Service for configuring sinks used to export log entries out of
+    Logging.
+    """
+
+    SERVICE_ADDRESS = "logging.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.logging.v2.ConfigServiceV2"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ConfigServiceV2Client: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def billing_path(cls, billing_account):
+        """Return a fully-qualified billing string."""
+        return google.api_core.path_template.expand(
+            "billingAccounts/{billing_account}", billing_account=billing_account
+        )
+
+    @classmethod
+    def billing_exclusion_path(cls, billing_account, exclusion):
+        """Return a fully-qualified billing_exclusion string."""
+        return google.api_core.path_template.expand(
+            "billingAccounts/{billing_account}/exclusions/{exclusion}",
+            billing_account=billing_account,
+            exclusion=exclusion,
+        )
+
+    @classmethod
+    def billing_sink_path(cls, billing_account, sink):
+        """Return a fully-qualified billing_sink string."""
+        return google.api_core.path_template.expand(
+            "billingAccounts/{billing_account}/sinks/{sink}",
+            billing_account=billing_account,
+            sink=sink,
+        )
+
+    @classmethod
+    def exclusion_path(cls, project, exclusion):
+        """Return a fully-qualified exclusion string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/exclusions/{exclusion}",
+            project=project,
+            exclusion=exclusion,
+        )
+
+    @classmethod
+    def folder_path(cls, folder):
+        """Return a fully-qualified folder string."""
+        return google.api_core.path_template.expand("folders/{folder}", folder=folder)
+
+    @classmethod
+    def folder_exclusion_path(cls, folder, exclusion):
+        """Return a fully-qualified folder_exclusion string."""
+        return google.api_core.path_template.expand(
+            "folders/{folder}/exclusions/{exclusion}",
+            folder=folder,
+            exclusion=exclusion,
+        )
+
+    @classmethod
+    def folder_sink_path(cls, folder, sink):
+        """Return a fully-qualified folder_sink string."""
+        return google.api_core.path_template.expand(
+            "folders/{folder}/sinks/{sink}", folder=folder, sink=sink
+        )
+
+    @classmethod
+    def organization_path(cls, organization):
+        """Return a fully-qualified organization string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}", organization=organization
+        )
+
+    @classmethod
+    def organization_exclusion_path(cls, organization, exclusion):
+        """Return a fully-qualified organization_exclusion string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/exclusions/{exclusion}",
+            organization=organization,
+            exclusion=exclusion,
+        )
+
+    @classmethod
+    def organization_sink_path(cls, organization, sink):
+        """Return a fully-qualified organization_sink string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sinks/{sink}",
+            organization=organization,
+            sink=sink,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def sink_path(cls, project, sink):
+        """Return a fully-qualified sink string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/sinks/{sink}", project=project, sink=sink
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ConfigServiceV2GrpcTransport,
+                    Callable[[~.Credentials, type], ~.ConfigServiceV2GrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = config_service_v2_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=config_service_v2_grpc_transport.ConfigServiceV2GrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = config_service_v2_grpc_transport.ConfigServiceV2GrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_sinks(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists sinks.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_sinks(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_sinks(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The parent resource whose sinks are to be listed:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+                     "organizations/[ORGANIZATION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]"
+                     "folders/[FOLDER_ID]"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.logging_v2.types.LogSink` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_sinks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_sinks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_sinks,
+                default_retry=self._method_configs["ListSinks"].retry,
+                default_timeout=self._method_configs["ListSinks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.ListSinksRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_sinks"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="sinks",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_sink(
+        self,
+        sink_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a sink.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> sink_name = client.sink_path('[PROJECT]', '[SINK]')
+            >>>
+            >>> response = client.get_sink(sink_name)
+
+        Args:
+            sink_name (str): Required. The resource name of the sink:
+
+                ::
+
+                     "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+                     "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+                     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+
+                Example: ``"projects/my-project-id/sinks/my-sink-id"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogSink` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_sink" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_sink"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_sink,
+                default_retry=self._method_configs["GetSink"].retry,
+                default_timeout=self._method_configs["GetSink"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.GetSinkRequest(sink_name=sink_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("sink_name", sink_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_sink"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_sink(
+        self,
+        parent,
+        sink,
+        unique_writer_identity=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 export log entries only from the resource owning the sink.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `sink`:
+            >>> sink = {}
+            >>>
+            >>> response = client.create_sink(parent, sink)
+
+        Args:
+            parent (str): Required. The resource in which to create the sink:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+                     "organizations/[ORGANIZATION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]"
+                     "folders/[FOLDER_ID]"
+
+                Examples: ``"projects/my-logging-project"``,
+                ``"organizations/123456789"``.
+            sink (Union[dict, ~google.cloud.logging_v2.types.LogSink]): Required. The new sink, whose ``name`` parameter is a sink identifier
+                that is not already in use.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogSink`
+            unique_writer_identity (bool): 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 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.
+
+                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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogSink` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_sink" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_sink"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_sink,
+                default_retry=self._method_configs["CreateSink"].retry,
+                default_timeout=self._method_configs["CreateSink"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.CreateSinkRequest(
+            parent=parent, sink=sink, unique_writer_identity=unique_writer_identity
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_sink"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_sink(
+        self,
+        sink_name,
+        sink,
+        unique_writer_identity=None,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> sink_name = client.sink_path('[PROJECT]', '[SINK]')
+            >>>
+            >>> # TODO: Initialize `sink`:
+            >>> sink = {}
+            >>>
+            >>> response = client.update_sink(sink_name, sink)
+
+        Args:
+            sink_name (str): 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]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+                     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+
+                Example: ``"projects/my-project-id/sinks/my-sink-id"``.
+            sink (Union[dict, ~google.cloud.logging_v2.types.LogSink]): Required. The updated sink, whose name is the same identifier that
+                appears as part of ``sink_name``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogSink`
+            unique_writer_identity (bool): Optional. See
+                `sinks.create <https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create>`__
+                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:
+
+                -  If the old and new values of this field are both false or both true,
+                   then there is no change to the sink's ``writer_identity``.
+                -  If the old value is false and the new value is true, then
+                   ``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.
+            update_mask (Union[dict, ~google.cloud.logging_v2.types.FieldMask]): 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.
+
+                An empty updateMask is temporarily treated as using the following mask
+                for backwards compatibility purposes: destination,filter,includeChildren
+                At some point in the future, behavior will be removed and specifying an
+                empty updateMask will be an error.
+
+                For a detailed ``FieldMask`` definition, see
+                https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
+
+                Example: ``updateMask=filter``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogSink` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_sink" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_sink"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_sink,
+                default_retry=self._method_configs["UpdateSink"].retry,
+                default_timeout=self._method_configs["UpdateSink"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.UpdateSinkRequest(
+            sink_name=sink_name,
+            sink=sink,
+            unique_writer_identity=unique_writer_identity,
+            update_mask=update_mask,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("sink_name", sink_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_sink"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_sink(
+        self,
+        sink_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a sink. If the sink has a unique ``writer_identity``, then that
+        service account is also deleted.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> sink_name = client.sink_path('[PROJECT]', '[SINK]')
+            >>>
+            >>> client.delete_sink(sink_name)
+
+        Args:
+            sink_name (str): 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]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+                     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+
+                Example: ``"projects/my-project-id/sinks/my-sink-id"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_sink" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_sink"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_sink,
+                default_retry=self._method_configs["DeleteSink"].retry,
+                default_timeout=self._method_configs["DeleteSink"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.DeleteSinkRequest(sink_name=sink_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("sink_name", sink_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_sink"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_exclusions(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all the exclusions in a parent resource.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_exclusions(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_exclusions(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The parent resource whose exclusions are to be listed.
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+                     "organizations/[ORGANIZATION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]"
+                     "folders/[FOLDER_ID]"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.logging_v2.types.LogExclusion` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_exclusions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_exclusions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_exclusions,
+                default_retry=self._method_configs["ListExclusions"].retry,
+                default_timeout=self._method_configs["ListExclusions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.ListExclusionsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_exclusions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="exclusions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_exclusion(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the description of an exclusion.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> name = client.exclusion_path('[PROJECT]', '[EXCLUSION]')
+            >>>
+            >>> response = client.get_exclusion(name)
+
+        Args:
+            name (str): Required. The resource name of an existing exclusion:
+
+                ::
+
+                     "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+                     "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+                     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+
+                Example: ``"projects/my-project-id/exclusions/my-exclusion-id"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogExclusion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_exclusion" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_exclusion"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_exclusion,
+                default_retry=self._method_configs["GetExclusion"].retry,
+                default_timeout=self._method_configs["GetExclusion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.GetExclusionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_exclusion"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_exclusion(
+        self,
+        parent,
+        exclusion,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new exclusion in a specified parent resource.
+        Only log entries belonging to that resource can be excluded.
+        You can have up to 10 exclusions in a resource.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `exclusion`:
+            >>> exclusion = {}
+            >>>
+            >>> response = client.create_exclusion(parent, exclusion)
+
+        Args:
+            parent (str): Required. The parent resource in which to create the exclusion:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+                     "organizations/[ORGANIZATION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]"
+                     "folders/[FOLDER_ID]"
+
+                Examples: ``"projects/my-logging-project"``,
+                ``"organizations/123456789"``.
+            exclusion (Union[dict, ~google.cloud.logging_v2.types.LogExclusion]): Required. The new exclusion, whose ``name`` parameter is an exclusion
+                name that is not already used in the parent resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogExclusion`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogExclusion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_exclusion" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_exclusion"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_exclusion,
+                default_retry=self._method_configs["CreateExclusion"].retry,
+                default_timeout=self._method_configs["CreateExclusion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.CreateExclusionRequest(
+            parent=parent, exclusion=exclusion
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_exclusion"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_exclusion(
+        self,
+        name,
+        exclusion,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Changes one or more properties of an existing exclusion.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> name = client.exclusion_path('[PROJECT]', '[EXCLUSION]')
+            >>>
+            >>> # TODO: Initialize `exclusion`:
+            >>> exclusion = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_exclusion(name, exclusion, update_mask)
+
+        Args:
+            name (str): Required. The resource name of the exclusion to update:
+
+                ::
+
+                     "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+                     "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+                     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+
+                Example: ``"projects/my-project-id/exclusions/my-exclusion-id"``.
+            exclusion (Union[dict, ~google.cloud.logging_v2.types.LogExclusion]): Required. New values for the existing exclusion. Only the fields
+                specified in ``update_mask`` are relevant.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogExclusion`
+            update_mask (Union[dict, ~google.cloud.logging_v2.types.FieldMask]): Required. A nonempty list of fields to change in the existing exclusion.
+                New values for the fields are taken from the corresponding fields in the
+                ``LogExclusion`` included in this request. Fields not mentioned in
+                ``update_mask`` are not changed and are ignored in the request.
+
+                For example, to change the filter and description of an exclusion,
+                specify an ``update_mask`` of ``"filter,description"``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogExclusion` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_exclusion" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_exclusion"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_exclusion,
+                default_retry=self._method_configs["UpdateExclusion"].retry,
+                default_timeout=self._method_configs["UpdateExclusion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.UpdateExclusionRequest(
+            name=name, exclusion=exclusion, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_exclusion"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_exclusion(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an exclusion.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.ConfigServiceV2Client()
+            >>>
+            >>> name = client.exclusion_path('[PROJECT]', '[EXCLUSION]')
+            >>>
+            >>> client.delete_exclusion(name)
+
+        Args:
+            name (str): Required. The resource name of an existing exclusion to delete:
+
+                ::
+
+                     "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+                     "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+                     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+
+                Example: ``"projects/my-project-id/exclusions/my-exclusion-id"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_exclusion" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_exclusion"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_exclusion,
+                default_retry=self._method_configs["DeleteExclusion"].retry,
+                default_timeout=self._method_configs["DeleteExclusion"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_config_pb2.DeleteExclusionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_exclusion"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/logging/google/cloud/logging_v2/gapic/config_service_v2_client_config.py b/logging/google/cloud/logging_v2/gapic/config_service_v2_client_config.py
new file mode 100644
index 000000000000..b7c00db4cd93
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/config_service_v2_client_config.py
@@ -0,0 +1,82 @@
+config = {
+    "interfaces": {
+        "google.logging.v2.ConfigServiceV2": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+                "write_sink": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 20000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "ListSinks": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSink": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateSink": {
+                    "timeout_millis": 120000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSink": {
+                    "timeout_millis": 120000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteSink": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListExclusions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetExclusion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateExclusion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateExclusion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteExclusion": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/logging/google/cloud/logging_v2/gapic/enums.py b/logging/google/cloud/logging_v2/gapic/enums.py
new file mode 100644
index 000000000000..e677017ccbd2
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/enums.py
@@ -0,0 +1,215 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class LaunchStage(enum.IntEnum):
+    """
+    The launch stage as defined by `Google Cloud Platform Launch
+    Stages <http://cloud.google.com/terms/launch-stages>`__.
+
+    Attributes:
+      LAUNCH_STAGE_UNSPECIFIED (int): Do not use this default value.
+      EARLY_ACCESS (int): Early Access features are limited to a closed group of testers. To use
+      these features, you must sign up in advance and sign a Trusted Tester
+      agreement (which includes confidentiality provisions). These features may
+      be unstable, changed in backward-incompatible ways, and are not
+      guaranteed to be released.
+      ALPHA (int): Alpha is a limited availability test for releases before they are cleared
+      for widespread use. By Alpha, all significant design issues are resolved
+      and we are in the process of verifying functionality. Alpha customers
+      need to apply for access, agree to applicable terms, and have their
+      projects whitelisted. Alpha releases don’t have to be feature complete,
+      no SLAs are provided, and there are no technical support obligations, but
+      they will be far enough along that customers can actually use them in
+      test environments or for limited-use tests -- just like they would in
+      normal production cases.
+      BETA (int): Beta is the point at which we are ready to open a release for any
+      customer to use. There are no SLA or technical support obligations in a
+      Beta release. Products will be complete from a feature perspective, but
+      may have some open outstanding issues. Beta releases are suitable for
+      limited production use cases.
+      GA (int): GA features are open to all developers and are considered stable and
+      fully qualified for production use.
+      DEPRECATED (int): Deprecated features are scheduled to be shut down and removed. For more
+      information, see the “Deprecation Policy” section of our `Terms of
+      Service <https://cloud.google.com/terms/>`__ and the `Google Cloud
+      Platform Subject to the Deprecation
+      Policy <https://cloud.google.com/terms/deprecation>`__ documentation.
+    """
+
+    LAUNCH_STAGE_UNSPECIFIED = 0
+    EARLY_ACCESS = 1
+    ALPHA = 2
+    BETA = 3
+    GA = 4
+    DEPRECATED = 5
+
+
+class LogSeverity(enum.IntEnum):
+    """
+    The severity of the event described in a log entry, expressed as one of
+    the standard severity levels listed below. For your reference, the
+    levels are assigned the listed numeric values. The effect of using
+    numeric values other than those listed is undefined.
+
+    You can filter for log entries by severity. For example, the following
+    filter expression will match log entries with severities ``INFO``,
+    ``NOTICE``, and ``WARNING``:
+
+    ::
+
+         severity > DEBUG AND severity <= WARNING
+
+    If you are writing log entries, you should map other severity encodings
+    to one of these standard levels. For example, you might map all of
+    Java's FINE, FINER, and FINEST levels to ``LogSeverity.DEBUG``. You can
+    preserve the original severity level in the log entry payload if you
+    wish.
+
+    Attributes:
+      DEFAULT (int): (0) The log entry has no assigned severity level.
+      DEBUG (int): (100) Debug or trace information.
+      INFO (int): (200) Routine information, such as ongoing status or performance.
+      NOTICE (int): (300) Normal but significant events, such as start up, shut down, or
+      a configuration change.
+      WARNING (int): (400) Warning events might cause problems.
+      ERROR (int): (500) Error events are likely to cause problems.
+      CRITICAL (int): (600) Critical events cause more severe problems or outages.
+      ALERT (int): (700) A person must take an action immediately.
+      EMERGENCY (int): (800) One or more systems are unusable.
+    """
+
+    DEFAULT = 0
+    DEBUG = 100
+    INFO = 200
+    NOTICE = 300
+    WARNING = 400
+    ERROR = 500
+    CRITICAL = 600
+    ALERT = 700
+    EMERGENCY = 800
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class LabelDescriptor(object):
+    class ValueType(enum.IntEnum):
+        """
+        Value types that can be used as label values.
+
+        Attributes:
+          STRING (int): A variable-length string. This is the default.
+          BOOL (int): Boolean; true or false.
+          INT64 (int): A 64-bit signed integer.
+        """
+
+        STRING = 0
+        BOOL = 1
+        INT64 = 2
+
+
+class LogMetric(object):
+    class ApiVersion(enum.IntEnum):
+        """
+        Logging API version.
+
+        Attributes:
+          V2 (int): Logging API v2.
+          V1 (int): Logging API v1.
+        """
+
+        V2 = 0
+        V1 = 1
+
+
+class LogSink(object):
+    class VersionFormat(enum.IntEnum):
+        """
+        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.
+
+        Attributes:
+          VERSION_FORMAT_UNSPECIFIED (int): An unspecified format version that will default to V2.
+          V2 (int): ``LogEntry`` version 2 format.
+          V1 (int): ``LogEntry`` version 1 format.
+        """
+
+        VERSION_FORMAT_UNSPECIFIED = 0
+        V2 = 1
+        V1 = 2
+
+
+class MetricDescriptor(object):
+    class MetricKind(enum.IntEnum):
+        """
+        The kind of measurement. It describes how the data is reported.
+
+        Attributes:
+          METRIC_KIND_UNSPECIFIED (int): Do not use this default value.
+          GAUGE (int): An instantaneous measurement of a value.
+          DELTA (int): The change in a value during a time interval.
+          CUMULATIVE (int): A value accumulated over a time interval.  Cumulative
+          measurements in a time series should have the same start time
+          and increasing end times, until an event resets the cumulative
+          value to zero and sets a new start time for the following
+          points.
+        """
+
+        METRIC_KIND_UNSPECIFIED = 0
+        GAUGE = 1
+        DELTA = 2
+        CUMULATIVE = 3
+
+    class ValueType(enum.IntEnum):
+        """
+        The value type of a metric.
+
+        Attributes:
+          VALUE_TYPE_UNSPECIFIED (int): Do not use this default value.
+          BOOL (int): The value is a boolean. This value type can be used only if the metric
+          kind is ``GAUGE``.
+          INT64 (int): The value is a signed 64-bit integer.
+          DOUBLE (int): The value is a double precision floating point number.
+          STRING (int): The value is a text string. This value type can be used only if the
+          metric kind is ``GAUGE``.
+          DISTRIBUTION (int): The value is a ``Distribution``.
+          MONEY (int): The value is money.
+        """
+
+        VALUE_TYPE_UNSPECIFIED = 0
+        BOOL = 1
+        INT64 = 2
+        DOUBLE = 3
+        STRING = 4
+        DISTRIBUTION = 5
+        MONEY = 6
diff --git a/logging/google/cloud/logging_v2/gapic/logging_service_v2_client.py b/logging/google/cloud/logging_v2/gapic/logging_service_v2_client.py
new file mode 100644
index 000000000000..22aa07c592ae
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/logging_service_v2_client.py
@@ -0,0 +1,804 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.logging.v2 LoggingServiceV2 API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.api import monitored_resource_pb2
+from google.cloud.logging_v2.gapic import enums
+from google.cloud.logging_v2.gapic import logging_service_v2_client_config
+from google.cloud.logging_v2.gapic.transports import logging_service_v2_grpc_transport
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_pb2
+from google.cloud.logging_v2.proto import logging_pb2_grpc
+from google.protobuf import empty_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-logging").version
+
+
+class LoggingServiceV2Client(object):
+    """Service for ingesting and querying logs."""
+
+    SERVICE_ADDRESS = "logging.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.logging.v2.LoggingServiceV2"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            LoggingServiceV2Client: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def billing_path(cls, billing_account):
+        """Return a fully-qualified billing string."""
+        return google.api_core.path_template.expand(
+            "billingAccounts/{billing_account}", billing_account=billing_account
+        )
+
+    @classmethod
+    def billing_log_path(cls, billing_account, log):
+        """Return a fully-qualified billing_log string."""
+        return google.api_core.path_template.expand(
+            "billingAccounts/{billing_account}/logs/{log}",
+            billing_account=billing_account,
+            log=log,
+        )
+
+    @classmethod
+    def folder_path(cls, folder):
+        """Return a fully-qualified folder string."""
+        return google.api_core.path_template.expand("folders/{folder}", folder=folder)
+
+    @classmethod
+    def folder_log_path(cls, folder, log):
+        """Return a fully-qualified folder_log string."""
+        return google.api_core.path_template.expand(
+            "folders/{folder}/logs/{log}", folder=folder, log=log
+        )
+
+    @classmethod
+    def log_path(cls, project, log):
+        """Return a fully-qualified log string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/logs/{log}", project=project, log=log
+        )
+
+    @classmethod
+    def organization_path(cls, organization):
+        """Return a fully-qualified organization string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}", organization=organization
+        )
+
+    @classmethod
+    def organization_log_path(cls, organization, log):
+        """Return a fully-qualified organization_log string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/logs/{log}",
+            organization=organization,
+            log=log,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.LoggingServiceV2GrpcTransport,
+                    Callable[[~.Credentials, type], ~.LoggingServiceV2GrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = logging_service_v2_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=logging_service_v2_grpc_transport.LoggingServiceV2GrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = logging_service_v2_grpc_transport.LoggingServiceV2GrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def delete_log(
+        self,
+        log_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.LoggingServiceV2Client()
+            >>>
+            >>> log_name = client.log_path('[PROJECT]', '[LOG]')
+            >>>
+            >>> client.delete_log(log_name)
+
+        Args:
+            log_name (str): Required. The resource name of the log to delete:
+
+                ::
+
+                     "projects/[PROJECT_ID]/logs/[LOG_ID]"
+                     "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+                     "folders/[FOLDER_ID]/logs/[LOG_ID]"
+
+                ``[LOG_ID]`` must be URL-encoded. For example,
+                ``"projects/my-project-id/logs/syslog"``,
+                ``"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"``.
+                For more information about log names, see ``LogEntry``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_log" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_log"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_log,
+                default_retry=self._method_configs["DeleteLog"].retry,
+                default_timeout=self._method_configs["DeleteLog"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_pb2.DeleteLogRequest(log_name=log_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("log_name", log_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_log"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def write_log_entries(
+        self,
+        entries,
+        log_name=None,
+        resource=None,
+        labels=None,
+        partial_success=None,
+        dry_run=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Writes log entries to Logging. This API method is the
+        only way to send log entries to Logging. This method
+        is used, directly or indirectly, by the Logging agent
+        (fluentd) and all logging libraries configured to use Logging.
+        A single request may contain log entries for a maximum of 1000
+        different resources (projects, organizations, billing accounts or
+        folders)
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.LoggingServiceV2Client()
+            >>>
+            >>> # TODO: Initialize `entries`:
+            >>> entries = []
+            >>>
+            >>> response = client.write_log_entries(entries)
+
+        Args:
+            entries (list[Union[dict, ~google.cloud.logging_v2.types.LogEntry]]): 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
+                ``log_name``, ``resource``, and ``labels`` fields are copied into those
+                log entries in this list that do not include values for their
+                corresponding fields. For more information, see the ``LogEntry`` type.
+
+                If the ``timestamp`` or ``insert_id`` fields are missing in log entries,
+                then this method supplies the current time or a unique identifier,
+                respectively. The supplied values are chosen so that, among the log
+                entries that did not supply their own values, the entries earlier in the
+                list will sort before the entries later in the list. See the
+                ``entries.list`` method.
+
+                Log entries with timestamps that are more than the `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 <https://cloud.google.com/logging/docs/api/tasks/exporting-logs>`__.
+
+                To improve throughput and to avoid exceeding the `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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogEntry`
+            log_name (str): Optional. A default log resource name that is assigned to all log
+                entries in ``entries`` that do not specify a value for ``log_name``:
+
+                ::
+
+                     "projects/[PROJECT_ID]/logs/[LOG_ID]"
+                     "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+                     "folders/[FOLDER_ID]/logs/[LOG_ID]"
+
+                ``[LOG_ID]`` must be URL-encoded. For example:
+
+                ::
+
+                     "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.
+            resource (Union[dict, ~google.cloud.logging_v2.types.MonitoredResource]): Optional. A default monitored resource object that is assigned to all
+                log entries in ``entries`` that do not specify a value for ``resource``.
+                Example:
+
+                ::
+
+                     { "type": "gce_instance",
+                       "labels": {
+                         "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
+
+                See ``LogEntry``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.MonitoredResource`
+            labels (dict[str -> str]): 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``.
+            partial_success (bool): 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.
+            dry_run (bool): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.WriteLogEntriesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "write_log_entries" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "write_log_entries"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.write_log_entries,
+                default_retry=self._method_configs["WriteLogEntries"].retry,
+                default_timeout=self._method_configs["WriteLogEntries"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_pb2.WriteLogEntriesRequest(
+            entries=entries,
+            log_name=log_name,
+            resource=resource,
+            labels=labels,
+            partial_success=partial_success,
+            dry_run=dry_run,
+        )
+        return self._inner_api_calls["write_log_entries"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_log_entries(
+        self,
+        resource_names,
+        project_ids=None,
+        filter_=None,
+        order_by=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists log entries. Use this method to retrieve log entries from Logging.
+        For ways to export log entries, see `Exporting
+        Logs <https://cloud.google.com/logging/docs/export>`__.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.LoggingServiceV2Client()
+            >>>
+            >>> # TODO: Initialize `resource_names`:
+            >>> resource_names = []
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_log_entries(resource_names):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_log_entries(resource_names).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            resource_names (list[str]): Required. Names of one or more parent resources from which to retrieve
+                log entries:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+                     "organizations/[ORGANIZATION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]"
+                     "folders/[FOLDER_ID]"
+
+                Projects listed in the ``project_ids`` field are added to this list.
+            project_ids (list[str]): 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``.
+            filter_ (str): Optional. A filter that chooses which log entries to return. See
+                `Advanced Logs
+                Filters <https://cloud.google.com/logging/docs/view/advanced_filters>`__.
+                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.
+            order_by (str): Optional. How the results should be sorted. Presently, the only
+                permitted values are ``"timestamp asc"`` (default) and
+                ``"timestamp desc"``. The first option returns entries in order of
+                increasing values of ``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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.logging_v2.types.LogEntry` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_log_entries" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_log_entries"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_log_entries,
+                default_retry=self._method_configs["ListLogEntries"].retry,
+                default_timeout=self._method_configs["ListLogEntries"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_pb2.ListLogEntriesRequest(
+            resource_names=resource_names,
+            project_ids=project_ids,
+            filter=filter_,
+            order_by=order_by,
+            page_size=page_size,
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_log_entries"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="entries",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_monitored_resource_descriptors(
+        self,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the descriptors for monitored resource types used by Logging.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.LoggingServiceV2Client()
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_monitored_resource_descriptors():
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_monitored_resource_descriptors().pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.logging_v2.types.MonitoredResourceDescriptor` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_monitored_resource_descriptors" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_monitored_resource_descriptors"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_monitored_resource_descriptors,
+                default_retry=self._method_configs[
+                    "ListMonitoredResourceDescriptors"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "ListMonitoredResourceDescriptors"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_pb2.ListMonitoredResourceDescriptorsRequest(
+            page_size=page_size
+        )
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_monitored_resource_descriptors"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="resource_descriptors",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_logs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the logs in projects, organizations, folders, or billing accounts.
+        Only logs that have entries are listed.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.LoggingServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_logs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_logs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The resource name that owns the logs:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+                     "organizations/[ORGANIZATION_ID]"
+                     "billingAccounts/[BILLING_ACCOUNT_ID]"
+                     "folders/[FOLDER_ID]"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`str` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_logs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_logs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_logs,
+                default_retry=self._method_configs["ListLogs"].retry,
+                default_timeout=self._method_configs["ListLogs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_pb2.ListLogsRequest(parent=parent, page_size=page_size)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_logs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="log_names",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/logging/google/cloud/logging_v2/gapic/logging_service_v2_client_config.py b/logging/google/cloud/logging_v2/gapic/logging_service_v2_client_config.py
new file mode 100644
index 000000000000..b3da612f6caf
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/logging_service_v2_client_config.py
@@ -0,0 +1,62 @@
+config = {
+    "interfaces": {
+        "google.logging.v2.LoggingServiceV2": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+                "list": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 20000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "DeleteLog": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "WriteLogEntries": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                    "bundling": {
+                        "element_count_threshold": 1000,
+                        "request_byte_threshold": 1048576,
+                        "delay_threshold_millis": 50,
+                    },
+                },
+                "ListLogEntries": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListMonitoredResourceDescriptors": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListLogs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/logging/google/cloud/logging_v2/gapic/metrics_service_v2_client.py b/logging/google/cloud/logging_v2/gapic/metrics_service_v2_client.py
new file mode 100644
index 000000000000..59dae9c7a78f
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/metrics_service_v2_client.py
@@ -0,0 +1,649 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.logging.v2 MetricsServiceV2 API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.api import monitored_resource_pb2
+from google.cloud.logging_v2.gapic import enums
+from google.cloud.logging_v2.gapic import metrics_service_v2_client_config
+from google.cloud.logging_v2.gapic.transports import metrics_service_v2_grpc_transport
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_config_pb2
+from google.cloud.logging_v2.proto import logging_config_pb2_grpc
+from google.cloud.logging_v2.proto import logging_metrics_pb2
+from google.cloud.logging_v2.proto import logging_metrics_pb2_grpc
+from google.cloud.logging_v2.proto import logging_pb2
+from google.cloud.logging_v2.proto import logging_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-logging").version
+
+
+class MetricsServiceV2Client(object):
+    """Service for configuring logs-based metrics."""
+
+    SERVICE_ADDRESS = "logging.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.logging.v2.MetricsServiceV2"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            MetricsServiceV2Client: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def billing_path(cls, billing_account):
+        """Return a fully-qualified billing string."""
+        return google.api_core.path_template.expand(
+            "billingAccounts/{billing_account}", billing_account=billing_account
+        )
+
+    @classmethod
+    def folder_path(cls, folder):
+        """Return a fully-qualified folder string."""
+        return google.api_core.path_template.expand("folders/{folder}", folder=folder)
+
+    @classmethod
+    def metric_path(cls, project, metric):
+        """Return a fully-qualified metric string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/metrics/{metric}", project=project, metric=metric
+        )
+
+    @classmethod
+    def organization_path(cls, organization):
+        """Return a fully-qualified organization string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}", organization=organization
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.MetricsServiceV2GrpcTransport,
+                    Callable[[~.Credentials, type], ~.MetricsServiceV2GrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = metrics_service_v2_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=metrics_service_v2_grpc_transport.MetricsServiceV2GrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = metrics_service_v2_grpc_transport.MetricsServiceV2GrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_log_metrics(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists logs-based metrics.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.MetricsServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_log_metrics(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_log_metrics(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The name of the project containing the metrics:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.logging_v2.types.LogMetric` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_log_metrics" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_log_metrics"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_log_metrics,
+                default_retry=self._method_configs["ListLogMetrics"].retry,
+                default_timeout=self._method_configs["ListLogMetrics"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_metrics_pb2.ListLogMetricsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_log_metrics"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="metrics",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_log_metric(
+        self,
+        metric_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a logs-based metric.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.MetricsServiceV2Client()
+            >>>
+            >>> metric_name = client.metric_path('[PROJECT]', '[METRIC]')
+            >>>
+            >>> response = client.get_log_metric(metric_name)
+
+        Args:
+            metric_name (str): The resource name of the desired metric:
+
+                ::
+
+                     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogMetric` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_log_metric" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_log_metric"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_log_metric,
+                default_retry=self._method_configs["GetLogMetric"].retry,
+                default_timeout=self._method_configs["GetLogMetric"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_metrics_pb2.GetLogMetricRequest(metric_name=metric_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("metric_name", metric_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_log_metric"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_log_metric(
+        self,
+        parent,
+        metric,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a logs-based metric.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.MetricsServiceV2Client()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `metric`:
+            >>> metric = {}
+            >>>
+            >>> response = client.create_log_metric(parent, metric)
+
+        Args:
+            parent (str): The resource name of the project in which to create the metric:
+
+                ::
+
+                     "projects/[PROJECT_ID]"
+
+                The new metric must be provided in the request.
+            metric (Union[dict, ~google.cloud.logging_v2.types.LogMetric]): The new logs-based metric, which must not have an identifier that
+                already exists.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogMetric`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogMetric` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_log_metric" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_log_metric"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_log_metric,
+                default_retry=self._method_configs["CreateLogMetric"].retry,
+                default_timeout=self._method_configs["CreateLogMetric"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_metrics_pb2.CreateLogMetricRequest(
+            parent=parent, metric=metric
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_log_metric"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_log_metric(
+        self,
+        metric_name,
+        metric,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates or updates a logs-based metric.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.MetricsServiceV2Client()
+            >>>
+            >>> metric_name = client.metric_path('[PROJECT]', '[METRIC]')
+            >>>
+            >>> # TODO: Initialize `metric`:
+            >>> metric = {}
+            >>>
+            >>> response = client.update_log_metric(metric_name, metric)
+
+        Args:
+            metric_name (str): 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.
+            metric (Union[dict, ~google.cloud.logging_v2.types.LogMetric]): The updated metric.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.logging_v2.types.LogMetric`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.logging_v2.types.LogMetric` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_log_metric" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_log_metric"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_log_metric,
+                default_retry=self._method_configs["UpdateLogMetric"].retry,
+                default_timeout=self._method_configs["UpdateLogMetric"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_metrics_pb2.UpdateLogMetricRequest(
+            metric_name=metric_name, metric=metric
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("metric_name", metric_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_log_metric"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_log_metric(
+        self,
+        metric_name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a logs-based metric.
+
+        Example:
+            >>> from google.cloud import logging_v2
+            >>>
+            >>> client = logging_v2.MetricsServiceV2Client()
+            >>>
+            >>> metric_name = client.metric_path('[PROJECT]', '[METRIC]')
+            >>>
+            >>> client.delete_log_metric(metric_name)
+
+        Args:
+            metric_name (str): The resource name of the metric to delete:
+
+                ::
+
+                     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_log_metric" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_log_metric"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_log_metric,
+                default_retry=self._method_configs["DeleteLogMetric"].retry,
+                default_timeout=self._method_configs["DeleteLogMetric"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = logging_metrics_pb2.DeleteLogMetricRequest(metric_name=metric_name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("metric_name", metric_name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_log_metric"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/logging/google/cloud/logging_v2/gapic/metrics_service_v2_client_config.py b/logging/google/cloud/logging_v2/gapic/metrics_service_v2_client_config.py
new file mode 100644
index 000000000000..133abec23dcf
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/metrics_service_v2_client_config.py
@@ -0,0 +1,48 @@
+config = {
+    "interfaces": {
+        "google.logging.v2.MetricsServiceV2": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListLogMetrics": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetLogMetric": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateLogMetric": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateLogMetric": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteLogMetric": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/logging/google/cloud/logging_v2/gapic/transports/__init__.py b/logging/google/cloud/logging_v2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/logging/google/cloud/logging_v2/gapic/transports/config_service_v2_grpc_transport.py b/logging/google/cloud/logging_v2/gapic/transports/config_service_v2_grpc_transport.py
new file mode 100644
index 000000000000..8157764ec872
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/transports/config_service_v2_grpc_transport.py
@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.logging_v2.proto import logging_config_pb2_grpc
+
+
+class ConfigServiceV2GrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.logging.v2 ConfigServiceV2 API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="logging.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "config_service_v2_stub": logging_config_pb2_grpc.ConfigServiceV2Stub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="logging.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_sinks(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.list_sinks`.
+
+        Lists sinks.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].ListSinks
+
+    @property
+    def get_sink(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.get_sink`.
+
+        Gets a sink.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].GetSink
+
+    @property
+    def create_sink(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.create_sink`.
+
+        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 export log entries only from the resource owning the sink.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].CreateSink
+
+    @property
+    def update_sink(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.update_sink`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].UpdateSink
+
+    @property
+    def delete_sink(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.delete_sink`.
+
+        Deletes a sink. If the sink has a unique ``writer_identity``, then that
+        service account is also deleted.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].DeleteSink
+
+    @property
+    def list_exclusions(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.list_exclusions`.
+
+        Lists all the exclusions in a parent resource.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].ListExclusions
+
+    @property
+    def get_exclusion(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.get_exclusion`.
+
+        Gets the description of an exclusion.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].GetExclusion
+
+    @property
+    def create_exclusion(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.create_exclusion`.
+
+        Creates a new exclusion in a specified parent resource.
+        Only log entries belonging to that resource can be excluded.
+        You can have up to 10 exclusions in a resource.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].CreateExclusion
+
+    @property
+    def update_exclusion(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.update_exclusion`.
+
+        Changes one or more properties of an existing exclusion.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].UpdateExclusion
+
+    @property
+    def delete_exclusion(self):
+        """Return the gRPC stub for :meth:`ConfigServiceV2Client.delete_exclusion`.
+
+        Deletes an exclusion.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["config_service_v2_stub"].DeleteExclusion
diff --git a/logging/google/cloud/logging_v2/gapic/transports/logging_service_v2_grpc_transport.py b/logging/google/cloud/logging_v2/gapic/transports/logging_service_v2_grpc_transport.py
new file mode 100644
index 000000000000..caa20c480225
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/transports/logging_service_v2_grpc_transport.py
@@ -0,0 +1,191 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.logging_v2.proto import logging_pb2_grpc
+
+
+class LoggingServiceV2GrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.logging.v2 LoggingServiceV2 API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="logging.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "logging_service_v2_stub": logging_pb2_grpc.LoggingServiceV2Stub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="logging.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def delete_log(self):
+        """Return the gRPC stub for :meth:`LoggingServiceV2Client.delete_log`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["logging_service_v2_stub"].DeleteLog
+
+    @property
+    def write_log_entries(self):
+        """Return the gRPC stub for :meth:`LoggingServiceV2Client.write_log_entries`.
+
+        Writes log entries to Logging. This API method is the
+        only way to send log entries to Logging. This method
+        is used, directly or indirectly, by the Logging agent
+        (fluentd) and all logging libraries configured to use Logging.
+        A single request may contain log entries for a maximum of 1000
+        different resources (projects, organizations, billing accounts or
+        folders)
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["logging_service_v2_stub"].WriteLogEntries
+
+    @property
+    def list_log_entries(self):
+        """Return the gRPC stub for :meth:`LoggingServiceV2Client.list_log_entries`.
+
+        Lists log entries. Use this method to retrieve log entries from Logging.
+        For ways to export log entries, see `Exporting
+        Logs <https://cloud.google.com/logging/docs/export>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["logging_service_v2_stub"].ListLogEntries
+
+    @property
+    def list_monitored_resource_descriptors(self):
+        """Return the gRPC stub for :meth:`LoggingServiceV2Client.list_monitored_resource_descriptors`.
+
+        Lists the descriptors for monitored resource types used by Logging.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["logging_service_v2_stub"].ListMonitoredResourceDescriptors
+
+    @property
+    def list_logs(self):
+        """Return the gRPC stub for :meth:`LoggingServiceV2Client.list_logs`.
+
+        Lists the logs in projects, organizations, folders, or billing accounts.
+        Only logs that have entries are listed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["logging_service_v2_stub"].ListLogs
diff --git a/logging/google/cloud/logging_v2/gapic/transports/metrics_service_v2_grpc_transport.py b/logging/google/cloud/logging_v2/gapic/transports/metrics_service_v2_grpc_transport.py
new file mode 100644
index 000000000000..426edce6edd7
--- /dev/null
+++ b/logging/google/cloud/logging_v2/gapic/transports/metrics_service_v2_grpc_transport.py
@@ -0,0 +1,181 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.logging_v2.proto import logging_metrics_pb2_grpc
+
+
+class MetricsServiceV2GrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.logging.v2 MetricsServiceV2 API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="logging.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "metrics_service_v2_stub": logging_metrics_pb2_grpc.MetricsServiceV2Stub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="logging.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_log_metrics(self):
+        """Return the gRPC stub for :meth:`MetricsServiceV2Client.list_log_metrics`.
+
+        Lists logs-based metrics.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metrics_service_v2_stub"].ListLogMetrics
+
+    @property
+    def get_log_metric(self):
+        """Return the gRPC stub for :meth:`MetricsServiceV2Client.get_log_metric`.
+
+        Gets a logs-based metric.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metrics_service_v2_stub"].GetLogMetric
+
+    @property
+    def create_log_metric(self):
+        """Return the gRPC stub for :meth:`MetricsServiceV2Client.create_log_metric`.
+
+        Creates a logs-based metric.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metrics_service_v2_stub"].CreateLogMetric
+
+    @property
+    def update_log_metric(self):
+        """Return the gRPC stub for :meth:`MetricsServiceV2Client.update_log_metric`.
+
+        Creates or updates a logs-based metric.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metrics_service_v2_stub"].UpdateLogMetric
+
+    @property
+    def delete_log_metric(self):
+        """Return the gRPC stub for :meth:`MetricsServiceV2Client.delete_log_metric`.
+
+        Deletes a logs-based metric.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metrics_service_v2_stub"].DeleteLogMetric
diff --git a/logging/google/cloud/logging_v2/proto/__init__.py b/logging/google/cloud/logging_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/logging/google/cloud/logging_v2/proto/http_request.proto b/logging/google/cloud/logging_v2/proto/http_request.proto
new file mode 100644
index 000000000000..21b1367ab8ca
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/http_request.proto
@@ -0,0 +1,93 @@
+// 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.logging.type;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+
+option csharp_namespace = "Google.Cloud.Logging.Type";
+option go_package = "google.golang.org/genproto/googleapis/logging/type;ltype";
+option java_multiple_files = true;
+option java_outer_classname = "HttpRequestProto";
+option java_package = "com.google.logging.type";
+option php_namespace = "Google\\Cloud\\Logging\\Type";
+
+
+// A common proto for logging HTTP requests. Only contains semantics
+// defined by the HTTP specification. Product-specific logging
+// information MUST be defined in a separate message.
+message HttpRequest {
+  // The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+  string request_method = 1;
+
+  // The scheme (http, https), the host name, the path and the query
+  // portion of the URL that was requested.
+  // Example: `"http://example.com/some/info?color=red"`.
+  string request_url = 2;
+
+  // The size of the HTTP request message in bytes, including the request
+  // headers and the request body.
+  int64 request_size = 3;
+
+  // The response code indicating the status of response.
+  // Examples: 200, 404.
+  int32 status = 4;
+
+  // The size of the HTTP response message sent back to the client, in bytes,
+  // including the response headers and the response body.
+  int64 response_size = 5;
+
+  // The user agent sent by the client. Example:
+  // `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
+  string user_agent = 6;
+
+  // The IP address (IPv4 or IPv6) of the client that issued the HTTP
+  // request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+  string remote_ip = 7;
+
+  // The IP address (IPv4 or IPv6) of the origin server that the request was
+  // sent to.
+  string server_ip = 13;
+
+  // The referer URL of the request, as defined in
+  // [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+  string referer = 8;
+
+  // The request processing latency on the server, from the time the request was
+  // received until the response was sent.
+  google.protobuf.Duration latency = 14;
+
+  // Whether or not a cache lookup was attempted.
+  bool cache_lookup = 11;
+
+  // Whether or not an entity was served from cache
+  // (with or without validation).
+  bool cache_hit = 9;
+
+  // Whether or not the response was validated with the origin server before
+  // being served from cache. This field is only meaningful if `cache_hit` is
+  // True.
+  bool cache_validated_with_origin_server = 10;
+
+  // The number of HTTP response bytes inserted into cache. Set only when a
+  // cache fill was attempted.
+  int64 cache_fill_bytes = 12;
+
+  // Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
+  string protocol = 15;
+}
diff --git a/logging/google/cloud/logging_v2/proto/log_entry.proto b/logging/google/cloud/logging_v2/proto/log_entry.proto
new file mode 100644
index 000000000000..de9786daf733
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/log_entry.proto
@@ -0,0 +1,192 @@
+// 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.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/api/monitored_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";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Logging.V2";
+option go_package = "google.golang.org/genproto/googleapis/logging/v2;logging";
+option java_multiple_files = true;
+option java_outer_classname = "LogEntryProto";
+option java_package = "com.google.logging.v2";
+option php_namespace = "Google\\Cloud\\Logging\\V2";
+
+// An individual entry in a log.
+message LogEntry {
+  // Required. The resource name of the log to which this log entry belongs:
+  //
+  //     "projects/[PROJECT_ID]/logs/[LOG_ID]"
+  //     "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+  //     "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.
+  //
+  // `[LOG_ID]` must be URL-encoded within `log_name`. Example:
+  // `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
+  // `[LOG_ID]` must be less than 512 characters long and can only include the
+  // following characters: upper and lower case alphanumeric characters,
+  // forward-slash, underscore, hyphen, and period.
+  //
+  // For backward compatibility, if `log_name` begins with a forward-slash, such
+  // as `/projects/...`, then the log entry is ingested as usual but the
+  // 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;
+
+  // 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;
+
+  // Optional. 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.
+    google.protobuf.Any proto_payload = 2;
+
+    // The log entry payload, represented as a Unicode string (UTF-8).
+    string text_payload = 3;
+
+    // The log entry payload, represented as a structure that is
+    // expressed as a JSON object.
+    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.
+  //
+  // 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;
+
+  // Output only. The time the log entry was received by Logging.
+  google.protobuf.Timestamp receive_timestamp = 24;
+
+  // Optional. The severity of the log entry. The default value is
+  // `LogSeverity.DEFAULT`.
+  google.logging.type.LogSeverity severity = 10;
+
+  // 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. Information about the HTTP request associated with this
+  // log entry, if applicable.
+  google.logging.type.HttpRequest http_request = 7;
+
+  // Optional. A set of user-defined (key, value) data that provides additional
+  // information about the log entry.
+  map<string, string> 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;
+
+  // Optional. Information about an operation associated with the log entry, if
+  // applicable.
+  LogEntryOperation operation = 15;
+
+  // 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;
+
+  // 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 <code>"000000000000004a"</code>.
+  string span_id = 27;
+
+  // 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;
+
+  // Optional. Source code location information associated with the log entry,
+  // if any.
+  LogEntrySourceLocation source_location = 23;
+}
+
+// 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 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;
+
+  // Optional. Set this to True if this is the first log entry in the operation.
+  bool first = 3;
+
+  // Optional. Set this to True if this is the last log entry in the operation.
+  bool last = 4;
+}
+
+// Additional information about the source code location that produced the log
+// entry.
+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;
+
+  // Optional. Line within the source file. 1-based; 0 indicates no line number
+  // available.
+  int64 line = 2;
+
+  // 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
+  // used in contexts such as the logs viewer, where a file and line number are
+  // 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;
+}
diff --git a/logging/google/cloud/logging_v2/proto/log_entry_pb2.py b/logging/google/cloud/logging_v2/proto/log_entry_pb2.py
new file mode 100644
index 000000000000..6dc9ec5817f1
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/log_entry_pb2.py
@@ -0,0 +1,860 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/logging_v2/proto/log_entry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.logging.type import (
+    http_request_pb2 as google_dot_logging_dot_type_dot_http__request__pb2,
+)
+from google.logging.type import (
+    log_severity_pb2 as google_dot_logging_dot_type_dot_log__severity__pb2,
+)
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/logging_v2/proto/log_entry.proto",
+    package="google.logging.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.logging.v2B\rLogEntryProtoP\001Z8google.golang.org/genproto/googleapis/logging/v2;logging\370\001\001\252\002\027Google.Cloud.Logging.V2\312\002\027Google\\Cloud\\Logging\\V2"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/logging_v2/proto/log_entry.proto\x12\x11google.logging.v2\x1a\x1cgoogle/api/annotations.proto\x1a#google/api/monitored_resource.proto\x1a&google/logging/type/http_request.proto\x1a&google/logging/type/log_severity.proto\x1a\x19google/protobuf/any.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x8a\x06\n\x08LogEntry\x12\x10\n\x08log_name\x18\x0c \x01(\t\x12/\n\x08resource\x18\x08 \x01(\x0b\x32\x1d.google.api.MonitoredResource\x12-\n\rproto_payload\x18\x02 \x01(\x0b\x32\x14.google.protobuf.AnyH\x00\x12\x16\n\x0ctext_payload\x18\x03 \x01(\tH\x00\x12/\n\x0cjson_payload\x18\x06 \x01(\x0b\x32\x17.google.protobuf.StructH\x00\x12-\n\ttimestamp\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11receive_timestamp\x18\x18 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x32\n\x08severity\x18\n \x01(\x0e\x32 .google.logging.type.LogSeverity\x12\x11\n\tinsert_id\x18\x04 \x01(\t\x12\x36\n\x0chttp_request\x18\x07 \x01(\x0b\x32 .google.logging.type.HttpRequest\x12\x37\n\x06labels\x18\x0b \x03(\x0b\x32\'.google.logging.v2.LogEntry.LabelsEntry\x12\x37\n\x08metadata\x18\x19 \x01(\x0b\x32%.google.api.MonitoredResourceMetadata\x12\x37\n\toperation\x18\x0f \x01(\x0b\x32$.google.logging.v2.LogEntryOperation\x12\r\n\x05trace\x18\x16 \x01(\t\x12\x0f\n\x07span_id\x18\x1b \x01(\t\x12\x15\n\rtrace_sampled\x18\x1e \x01(\x08\x12\x42\n\x0fsource_location\x18\x17 \x01(\x0b\x32).google.logging.v2.LogEntrySourceLocation\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\t\n\x07payload"N\n\x11LogEntryOperation\x12\n\n\x02id\x18\x01 \x01(\t\x12\x10\n\x08producer\x18\x02 \x01(\t\x12\r\n\x05\x66irst\x18\x03 \x01(\x08\x12\x0c\n\x04last\x18\x04 \x01(\x08"F\n\x16LogEntrySourceLocation\x12\x0c\n\x04\x66ile\x18\x01 \x01(\t\x12\x0c\n\x04line\x18\x02 \x01(\x03\x12\x10\n\x08\x66unction\x18\x03 \x01(\tB\x99\x01\n\x15\x63om.google.logging.v2B\rLogEntryProtoP\x01Z8google.golang.org/genproto/googleapis/logging/v2;logging\xf8\x01\x01\xaa\x02\x17Google.Cloud.Logging.V2\xca\x02\x17Google\\Cloud\\Logging\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_logging_dot_type_dot_http__request__pb2.DESCRIPTOR,
+        google_dot_logging_dot_type_dot_log__severity__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGENTRY_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.logging.v2.LogEntry.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.logging.v2.LogEntry.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.logging.v2.LogEntry.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1028,
+    serialized_end=1073,
+)
+
+_LOGENTRY = _descriptor.Descriptor(
+    name="LogEntry",
+    full_name="google.logging.v2.LogEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="log_name",
+            full_name="google.logging.v2.LogEntry.log_name",
+            index=0,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource",
+            full_name="google.logging.v2.LogEntry.resource",
+            index=1,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="proto_payload",
+            full_name="google.logging.v2.LogEntry.proto_payload",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_payload",
+            full_name="google.logging.v2.LogEntry.text_payload",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="json_payload",
+            full_name="google.logging.v2.LogEntry.json_payload",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamp",
+            full_name="google.logging.v2.LogEntry.timestamp",
+            index=5,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="receive_timestamp",
+            full_name="google.logging.v2.LogEntry.receive_timestamp",
+            index=6,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="severity",
+            full_name="google.logging.v2.LogEntry.severity",
+            index=7,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="insert_id",
+            full_name="google.logging.v2.LogEntry.insert_id",
+            index=8,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_request",
+            full_name="google.logging.v2.LogEntry.http_request",
+            index=9,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.logging.v2.LogEntry.labels",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.logging.v2.LogEntry.metadata",
+            index=11,
+            number=25,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation",
+            full_name="google.logging.v2.LogEntry.operation",
+            index=12,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trace",
+            full_name="google.logging.v2.LogEntry.trace",
+            index=13,
+            number=22,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="span_id",
+            full_name="google.logging.v2.LogEntry.span_id",
+            index=14,
+            number=27,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trace_sampled",
+            full_name="google.logging.v2.LogEntry.trace_sampled",
+            index=15,
+            number=30,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_location",
+            full_name="google.logging.v2.LogEntry.source_location",
+            index=16,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LOGENTRY_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="payload",
+            full_name="google.logging.v2.LogEntry.payload",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=306,
+    serialized_end=1084,
+)
+
+
+_LOGENTRYOPERATION = _descriptor.Descriptor(
+    name="LogEntryOperation",
+    full_name="google.logging.v2.LogEntryOperation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.logging.v2.LogEntryOperation.id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="producer",
+            full_name="google.logging.v2.LogEntryOperation.producer",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="first",
+            full_name="google.logging.v2.LogEntryOperation.first",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last",
+            full_name="google.logging.v2.LogEntryOperation.last",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1086,
+    serialized_end=1164,
+)
+
+
+_LOGENTRYSOURCELOCATION = _descriptor.Descriptor(
+    name="LogEntrySourceLocation",
+    full_name="google.logging.v2.LogEntrySourceLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="file",
+            full_name="google.logging.v2.LogEntrySourceLocation.file",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="line",
+            full_name="google.logging.v2.LogEntrySourceLocation.line",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="function",
+            full_name="google.logging.v2.LogEntrySourceLocation.function",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1166,
+    serialized_end=1236,
+)
+
+_LOGENTRY_LABELSENTRY.containing_type = _LOGENTRY
+_LOGENTRY.fields_by_name[
+    "resource"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCE
+_LOGENTRY.fields_by_name[
+    "proto_payload"
+].message_type = google_dot_protobuf_dot_any__pb2._ANY
+_LOGENTRY.fields_by_name[
+    "json_payload"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_LOGENTRY.fields_by_name[
+    "timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LOGENTRY.fields_by_name[
+    "receive_timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LOGENTRY.fields_by_name[
+    "severity"
+].enum_type = google_dot_logging_dot_type_dot_log__severity__pb2._LOGSEVERITY
+_LOGENTRY.fields_by_name[
+    "http_request"
+].message_type = google_dot_logging_dot_type_dot_http__request__pb2._HTTPREQUEST
+_LOGENTRY.fields_by_name["labels"].message_type = _LOGENTRY_LABELSENTRY
+_LOGENTRY.fields_by_name[
+    "metadata"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCEMETADATA
+_LOGENTRY.fields_by_name["operation"].message_type = _LOGENTRYOPERATION
+_LOGENTRY.fields_by_name["source_location"].message_type = _LOGENTRYSOURCELOCATION
+_LOGENTRY.oneofs_by_name["payload"].fields.append(
+    _LOGENTRY.fields_by_name["proto_payload"]
+)
+_LOGENTRY.fields_by_name["proto_payload"].containing_oneof = _LOGENTRY.oneofs_by_name[
+    "payload"
+]
+_LOGENTRY.oneofs_by_name["payload"].fields.append(
+    _LOGENTRY.fields_by_name["text_payload"]
+)
+_LOGENTRY.fields_by_name["text_payload"].containing_oneof = _LOGENTRY.oneofs_by_name[
+    "payload"
+]
+_LOGENTRY.oneofs_by_name["payload"].fields.append(
+    _LOGENTRY.fields_by_name["json_payload"]
+)
+_LOGENTRY.fields_by_name["json_payload"].containing_oneof = _LOGENTRY.oneofs_by_name[
+    "payload"
+]
+DESCRIPTOR.message_types_by_name["LogEntry"] = _LOGENTRY
+DESCRIPTOR.message_types_by_name["LogEntryOperation"] = _LOGENTRYOPERATION
+DESCRIPTOR.message_types_by_name["LogEntrySourceLocation"] = _LOGENTRYSOURCELOCATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LogEntry = _reflection.GeneratedProtocolMessageType(
+    "LogEntry",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOGENTRY_LABELSENTRY,
+                __module__="google.cloud.logging_v2.proto.log_entry_pb2"
+                # @@protoc_insertion_point(class_scope:google.logging.v2.LogEntry.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOGENTRY,
+        __module__="google.cloud.logging_v2.proto.log_entry_pb2",
+        __doc__="""An individual entry in a log.
+  
+  
+  Attributes:
+      log_name:
+          Required. The resource name of the log to which this log entry
+          belongs:  ::      "projects/[PROJECT_ID]/logs/[LOG_ID]"
+          "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+          "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.  ``[LOG_ID]`` must be URL-encoded within
+          ``log_name``. Example: ``"organizations/1234567890/logs/cloudr
+          esourcemanager.googleapis.com%2Factivity"``. ``[LOG_ID]`` must
+          be less than 512 characters long and can only include the
+          following characters: upper and lower case alphanumeric
+          characters, forward-slash, underscore, hyphen, and period.
+          For backward compatibility, if ``log_name`` begins with a
+          forward-slash, such as ``/projects/...``, then the log entry
+          is ingested as usual but the 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.
+      resource:
+          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.
+      payload:
+          Optional. The log entry payload, which can be one of multiple
+          types.
+      proto_payload:
+          The log entry payload, represented as a protocol buffer. Some
+          Google Cloud Platform services use this field for their log
+          entry payloads.
+      text_payload:
+          The log entry payload, represented as a Unicode string
+          (UTF-8).
+      json_payload:
+          The log entry payload, represented as a structure that is
+          expressed as a JSON object.
+      timestamp:
+          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>`__.
+      receive_timestamp:
+          Output only. The time the log entry was received by Logging.
+      severity:
+          Optional. The severity of the log entry. The default value is
+          ``LogSeverity.DEFAULT``.
+      insert_id:
+          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.
+      http_request:
+          Optional. Information about the HTTP request associated with
+          this log entry, if applicable.
+      labels:
+          Optional. A set of user-defined (key, value) data that
+          provides additional information about the log entry.
+      metadata:
+          Output only. Additional metadata about the monitored resource.
+          Only ``k8s_container``, ``k8s_pod``, and ``k8s_node``
+          MonitoredResources have this field populated.
+      operation:
+          Optional. Information about an operation associated with the
+          log entry, if applicable.
+      trace:
+          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``
+      span_id:
+          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".
+      trace_sampled:
+          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.
+      source_location:
+          Optional. Source code location information associated with the
+          log entry, if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.LogEntry)
+    ),
+)
+_sym_db.RegisterMessage(LogEntry)
+_sym_db.RegisterMessage(LogEntry.LabelsEntry)
+
+LogEntryOperation = _reflection.GeneratedProtocolMessageType(
+    "LogEntryOperation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOGENTRYOPERATION,
+        __module__="google.cloud.logging_v2.proto.log_entry_pb2",
+        __doc__="""Additional information about a potentially long-running operation with
+  which a log entry is associated.
+  
+  
+  Attributes:
+      id:
+          Optional. An arbitrary operation identifier. Log entries with
+          the same identifier are assumed to be part of the same
+          operation.
+      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"``.
+      first:
+          Optional. Set this to True if this is the first log entry in
+          the operation.
+      last:
+          Optional. Set this to True if this is the last log entry in
+          the operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.LogEntryOperation)
+    ),
+)
+_sym_db.RegisterMessage(LogEntryOperation)
+
+LogEntrySourceLocation = _reflection.GeneratedProtocolMessageType(
+    "LogEntrySourceLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOGENTRYSOURCELOCATION,
+        __module__="google.cloud.logging_v2.proto.log_entry_pb2",
+        __doc__="""Additional information about the source code location that produced the
+  log entry.
+  
+  
+  Attributes:
+      file:
+          Optional. Source file name. Depending on the runtime
+          environment, this might be a simple name or a fully-qualified
+          name.
+      line:
+          Optional. Line within the source file. 1-based; 0 indicates no
+          line number available.
+      function:
+          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 used in contexts such as the
+          logs viewer, where a file and line number are less meaningful.
+          The format can vary by language. For example:
+          ``qual.if.ied.Class.method`` (Java), ``dir/package.func``
+          (Go), ``function`` (Python).
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.LogEntrySourceLocation)
+    ),
+)
+_sym_db.RegisterMessage(LogEntrySourceLocation)
+
+
+DESCRIPTOR._options = None
+_LOGENTRY_LABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/logging/google/cloud/logging_v2/proto/log_entry_pb2_grpc.py b/logging/google/cloud/logging_v2/proto/log_entry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/log_entry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/logging/google/cloud/logging_v2/proto/log_severity.proto b/logging/google/cloud/logging_v2/proto/log_severity.proto
new file mode 100644
index 000000000000..ccb08cacb445
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/log_severity.proto
@@ -0,0 +1,73 @@
+// 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.logging.type;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Logging.Type";
+option go_package = "google.golang.org/genproto/googleapis/logging/type;ltype";
+option java_multiple_files = true;
+option java_outer_classname = "LogSeverityProto";
+option java_package = "com.google.logging.type";
+option php_namespace = "Google\\Cloud\\Logging\\Type";
+
+
+// The severity of the event described in a log entry, expressed as one of the
+// standard severity levels listed below.  For your reference, the levels are
+// assigned the listed numeric values. The effect of using numeric values other
+// than those listed is undefined.
+//
+// You can filter for log entries by severity.  For example, the following
+// filter expression will match log entries with severities `INFO`, `NOTICE`,
+// and `WARNING`:
+//
+//     severity > DEBUG AND severity <= WARNING
+//
+// If you are writing log entries, you should map other severity encodings to
+// one of these standard levels. For example, you might map all of Java's FINE,
+// FINER, and FINEST levels to `LogSeverity.DEBUG`. You can preserve the
+// original severity level in the log entry payload if you wish.
+enum LogSeverity {
+  // (0) The log entry has no assigned severity level.
+  DEFAULT = 0;
+
+  // (100) Debug or trace information.
+  DEBUG = 100;
+
+  // (200) Routine information, such as ongoing status or performance.
+  INFO = 200;
+
+  // (300) Normal but significant events, such as start up, shut down, or
+  // a configuration change.
+  NOTICE = 300;
+
+  // (400) Warning events might cause problems.
+  WARNING = 400;
+
+  // (500) Error events are likely to cause problems.
+  ERROR = 500;
+
+  // (600) Critical events cause more severe problems or outages.
+  CRITICAL = 600;
+
+  // (700) A person must take an action immediately.
+  ALERT = 700;
+
+  // (800) One or more systems are unusable.
+  EMERGENCY = 800;
+}
diff --git a/logging/google/cloud/logging_v2/proto/logging.proto b/logging/google/cloud/logging_v2/proto/logging.proto
new file mode 100644
index 000000000000..d04cd5c03dd0
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging.proto
@@ -0,0 +1,331 @@
+// 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.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/api/monitored_resource.proto";
+import "google/logging/v2/log_entry.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Logging.V2";
+option go_package = "google.golang.org/genproto/googleapis/logging/v2;logging";
+option java_multiple_files = true;
+option java_outer_classname = "LoggingProto";
+option java_package = "com.google.logging.v2";
+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.
+  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/*}" }
+    };
+  }
+
+  // Writes log entries to Logging. This API method is the
+  // only way to send log entries to Logging. This method
+  // is used, directly or indirectly, by the Logging agent
+  // (fluentd) and all logging libraries configured to use Logging.
+  // 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) {
+    option (google.api.http) = {
+      post: "/v2/entries:write"
+      body: "*"
+    };
+  }
+
+  // Lists log entries.  Use this method to retrieve log entries from
+  // Logging.  For ways to export log entries, see
+  // [Exporting Logs](/logging/docs/export).
+  rpc ListLogEntries(ListLogEntriesRequest) returns (ListLogEntriesResponse) {
+    option (google.api.http) = {
+      post: "/v2/entries:list"
+      body: "*"
+    };
+  }
+
+  // Lists the descriptors for monitored resource types used by Logging.
+  rpc ListMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest)
+      returns (ListMonitoredResourceDescriptorsResponse) {
+    option (google.api.http) = {
+      get: "/v2/monitoredResourceDescriptors"
+    };
+  }
+
+  // Lists the logs in projects, organizations, folders, or billing accounts.
+  // Only logs that have entries are listed.
+  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" }
+    };
+  }
+}
+
+// The parameters to DeleteLog.
+message DeleteLogRequest {
+  // Required. The resource name of the log to delete:
+  //
+  //     "projects/[PROJECT_ID]/logs/[LOG_ID]"
+  //     "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+  //     "folders/[FOLDER_ID]/logs/[LOG_ID]"
+  //
+  // `[LOG_ID]` must be URL-encoded. For example,
+  // `"projects/my-project-id/logs/syslog"`,
+  // `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
+  // For more information about log names, see
+  // [LogEntry][google.logging.v2.LogEntry].
+  string log_name = 1;
+}
+
+// The parameters to WriteLogEntries.
+message WriteLogEntriesRequest {
+  // Optional. A default log resource name that is assigned to all log entries
+  // in `entries` that do not specify a value for `log_name`:
+  //
+  //     "projects/[PROJECT_ID]/logs/[LOG_ID]"
+  //     "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+  //     "folders/[FOLDER_ID]/logs/[LOG_ID]"
+  //
+  // `[LOG_ID]` must be URL-encoded. For example:
+  //
+  //     "projects/my-project-id/logs/syslog"
+  //     "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
+  //
+  // The permission <code>logging.logEntries.create</code> is needed on each
+  // project, organization, billing account, or folder that is receiving
+  // new log entries, whether the resource is specified in
+  // <code>logName</code> or in an individual log entry.
+  string log_name = 1;
+
+  // Optional. A default monitored resource object that is assigned to all log
+  // entries in `entries` that do not specify a value for `resource`. Example:
+  //
+  //     { "type": "gce_instance",
+  //       "labels": {
+  //         "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
+  //
+  // See [LogEntry][google.logging.v2.LogEntry].
+  google.api.MonitoredResource resource = 2;
+
+  // 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<string, string> labels = 3;
+
+  // 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
+  // `log_name`, `resource`, and `labels` fields are copied into those log
+  // entries in this list that do not include values for their corresponding
+  // fields. For more information, see the
+  // [LogEntry][google.logging.v2.LogEntry] type.
+  //
+  // If the `timestamp` or `insert_id` fields are missing in log entries, then
+  // this method supplies the current time or a unique identifier, respectively.
+  // The supplied values are chosen so that, among the log entries that did not
+  // supply their own values, the entries earlier in the list will sort before
+  // 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
+  // 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).
+  //
+  // To improve throughput and to avoid exceeding the
+  // [quota limit](/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;
+
+  // 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;
+
+  // 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;
+}
+
+// Result returned from WriteLogEntries.
+// empty
+message WriteLogEntriesResponse {}
+
+// Error details for WriteLogEntries with partial success.
+message WriteLogEntriesPartialErrors {
+  // When `WriteLogEntriesRequest.partial_success` is true, records the error
+  // status for entries that were not written due to a permanent error, keyed
+  // by the entry's zero-based index in `WriteLogEntriesRequest.entries`.
+  //
+  // Failed requests for which no entries are written will not include
+  // per-entry errors.
+  map<int32, google.rpc.Status> log_entry_errors = 1;
+}
+
+// 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:
+  //
+  //     "projects/[PROJECT_ID]"
+  //     "organizations/[ORGANIZATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]"
+  //     "folders/[FOLDER_ID]"
+  //
+  // Projects listed in the `project_ids` field are added to this list.
+  repeated string resource_names = 8;
+
+  // Optional. A filter that chooses which log entries to return.  See [Advanced
+  // Logs Filters](/logging/docs/view/advanced_filters).  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;
+
+  // Optional. How the results should be sorted.  Presently, the only permitted
+  // values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
+  // option returns entries in order of increasing values of
+  // `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;
+
+  // 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;
+
+  // 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;
+}
+
+// Result returned from `ListLogEntries`.
+message ListLogEntriesResponse {
+  // A list of log entries.  If `entries` is empty, `nextPageToken` may still be
+  // returned, indicating that more entries may exist.  See `nextPageToken` for
+  // more information.
+  repeated LogEntry entries = 1;
+
+  // If there might be more results than those appearing in this response, then
+  // `nextPageToken` is included.  To get the next set of results, call this
+  // method again using the value of `nextPageToken` as `pageToken`.
+  //
+  // If a value for `next_page_token` appears and the `entries` field is empty,
+  // it means that the search found no log entries so far but it did not have
+  // time to search all the possible log entries.  Retry the method with this
+  // value for `page_token` to continue the search.  Alternatively, consider
+  // speeding up the search by changing your filter to specify a single log name
+  // or resource type, or to narrow the time range of the search.
+  string next_page_token = 2;
+}
+
+// The parameters to ListMonitoredResourceDescriptors
+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;
+
+  // 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;
+}
+
+// Result returned from ListMonitoredResourceDescriptors.
+message ListMonitoredResourceDescriptorsResponse {
+  // A list of resource descriptors.
+  repeated google.api.MonitoredResourceDescriptor resource_descriptors = 1;
+
+  // If there might be more results than those appearing in this response, then
+  // `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 ListLogs.
+message ListLogsRequest {
+  // Required. The resource name that owns the logs:
+  //
+  //     "projects/[PROJECT_ID]"
+  //     "organizations/[ORGANIZATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]"
+  //     "folders/[FOLDER_ID]"
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Result returned from ListLogs.
+message ListLogsResponse {
+  // A list of log names. For example,
+  // `"projects/my-project/syslog"` or
+  // `"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"`.
+  repeated string log_names = 3;
+
+  // If there might be more results than those appearing in this response, then
+  // `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;
+}
diff --git a/logging/google/cloud/logging_v2/proto/logging_config.proto b/logging/google/cloud/logging_v2/proto/logging_config.proto
new file mode 100644
index 000000000000..2afea1062df5
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_config.proto
@@ -0,0 +1,584 @@
+// 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.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Logging.V2";
+option go_package = "google.golang.org/genproto/googleapis/logging/v2;logging";
+option java_multiple_files = true;
+option java_outer_classname = "LoggingConfigProto";
+option java_package = "com.google.logging.v2";
+option php_namespace = "Google\\Cloud\\Logging\\V2";
+
+// Service for configuring sinks used to export log entries out of
+// Logging.
+service ConfigServiceV2 {
+  // 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" }
+    };
+  }
+
+  // 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/*}" }
+    };
+  }
+
+  // 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
+  // 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=organizations/*}/sinks"
+        body: "sink"
+      }
+      additional_bindings { post: "/v2/{parent=folders/*}/sinks" body: "sink" }
+      additional_bindings {
+        post: "/v2/{parent=billingAccounts/*}/sinks"
+        body: "sink"
+      }
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      put: "/v2/{sink_name=*/*/sinks/*}"
+      body: "sink"
+      additional_bindings {
+        put: "/v2/{sink_name=projects/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        put: "/v2/{sink_name=organizations/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        put: "/v2/{sink_name=folders/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        put: "/v2/{sink_name=billingAccounts/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        patch: "/v2/{sink_name=projects/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        patch: "/v2/{sink_name=organizations/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        patch: "/v2/{sink_name=folders/*/sinks/*}"
+        body: "sink"
+      }
+      additional_bindings {
+        patch: "/v2/{sink_name=billingAccounts/*/sinks/*}"
+        body: "sink"
+      }
+    };
+  }
+
+  // Deletes a sink. If the sink has a unique `writer_identity`, then that
+  // service account is also deleted.
+  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=billingAccounts/*/sinks/*}"
+      }
+    };
+  }
+
+  // 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" }
+    };
+  }
+
+  // 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/*}" }
+    };
+  }
+
+  // Creates a new exclusion in a specified parent resource.
+  // Only log entries belonging to that resource can be excluded.
+  // You can have up to 10 exclusions in a resource.
+  rpc CreateExclusion(CreateExclusionRequest) returns (LogExclusion) {
+    option (google.api.http) = {
+      post: "/v2/{parent=*/*}/exclusions"
+      body: "exclusion"
+      additional_bindings {
+        post: "/v2/{parent=projects/*}/exclusions"
+        body: "exclusion"
+      }
+      additional_bindings {
+        post: "/v2/{parent=organizations/*}/exclusions"
+        body: "exclusion"
+      }
+      additional_bindings {
+        post: "/v2/{parent=folders/*}/exclusions"
+        body: "exclusion"
+      }
+      additional_bindings {
+        post: "/v2/{parent=billingAccounts/*}/exclusions"
+        body: "exclusion"
+      }
+    };
+  }
+
+  // Changes one or more properties of an existing exclusion.
+  rpc UpdateExclusion(UpdateExclusionRequest) returns (LogExclusion) {
+    option (google.api.http) = {
+      patch: "/v2/{name=*/*/exclusions/*}"
+      body: "exclusion"
+      additional_bindings {
+        patch: "/v2/{name=projects/*/exclusions/*}"
+        body: "exclusion"
+      }
+      additional_bindings {
+        patch: "/v2/{name=organizations/*/exclusions/*}"
+        body: "exclusion"
+      }
+      additional_bindings {
+        patch: "/v2/{name=folders/*/exclusions/*}"
+        body: "exclusion"
+      }
+      additional_bindings {
+        patch: "/v2/{name=billingAccounts/*/exclusions/*}"
+        body: "exclusion"
+      }
+    };
+  }
+
+  // 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=billingAccounts/*/exclusions/*}"
+      }
+    };
+  }
+}
+
+// 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.
+message LogSink {
+  // 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.
+  enum VersionFormat {
+    // An unspecified format version that will default to V2.
+    VERSION_FORMAT_UNSPECIFIED = 0;
+
+    // `LogEntry` version 2 format.
+    V2 = 1;
+
+    // `LogEntry` version 1 format.
+    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 export destination:
+  //
+  //     "storage.googleapis.com/[GCS_BUCKET]"
+  //     "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
+  //     "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
+  //
+  // 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;
+
+  // Optional.
+  // An [advanced logs filter](/logging/docs/view/advanced_filters).  The only
+  // exported log entries are those that are in the resource owning the sink and
+  // that match the filter.  For example:
+  //
+  //     logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
+  string filter = 5;
+
+  // 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.
+  VersionFormat output_version_format = 6 [deprecated = true];
+
+  // Output only. An IAM identity&mdash;a service account or group&mdash;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.
+  //
+  // 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).
+  // Consult the destination service's documentation to determine the
+  // appropriate IAM roles to assign to the identity.
+  string writer_identity = 8;
+
+  // 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
+  // sink's parent resource are available for export. If the field is true, then
+  // logs from all the projects, folders, and billing accounts contained in the
+  // sink's parent resource are also available for export. Whether a particular
+  // log entry from the children is exported depends on the sink's filter
+  // expression. For example, if this field is true, then the filter
+  // `resource.type=gce_instance` would export all Compute Engine VM instance
+  // log entries from all projects in the sink's parent. To only export entries
+  // from certain child projects, filter on the project part of the log name:
+  //
+  //     logName:("projects/test-project1/" OR "projects/test-project2/") AND
+  //     resource.type=gce_instance
+  bool include_children = 9;
+
+  // Deprecated. This field is ignored when creating or updating sinks.
+  google.protobuf.Timestamp start_time = 10 [deprecated = true];
+
+  // Deprecated. This field is ignored when creating or updating sinks.
+  google.protobuf.Timestamp end_time = 11 [deprecated = true];
+}
+
+// The parameters to `ListSinks`.
+message ListSinksRequest {
+  // Required. The parent resource whose sinks are to be listed:
+  //
+  //     "projects/[PROJECT_ID]"
+  //     "organizations/[ORGANIZATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]"
+  //     "folders/[FOLDER_ID]"
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Result returned from `ListSinks`.
+message ListSinksResponse {
+  // A list of sinks.
+  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
+  // method again using the value of `nextPageToken` as `pageToken`.
+  string next_page_token = 2;
+}
+
+// The parameters to `GetSink`.
+message GetSinkRequest {
+  // Required. The resource name of the sink:
+  //
+  //     "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+  //     "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+  //     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+  //
+  // Example: `"projects/my-project-id/sinks/my-sink-id"`.
+  string sink_name = 1;
+}
+
+// The parameters to `CreateSink`.
+message CreateSinkRequest {
+  // Required. The resource in which to create the sink:
+  //
+  //     "projects/[PROJECT_ID]"
+  //     "organizations/[ORGANIZATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]"
+  //     "folders/[FOLDER_ID]"
+  //
+  // Examples: `"projects/my-logging-project"`, `"organizations/123456789"`.
+  string parent = 1;
+
+  // Required. The new sink, whose `name` parameter is a sink identifier that
+  // is not already in use.
+  LogSink sink = 2;
+
+  // 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
+  // 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.
+  //
+  // 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;
+}
+
+// The parameters to `UpdateSink`.
+message UpdateSinkRequest {
+  // 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]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+  //     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+  //
+  // Example: `"projects/my-project-id/sinks/my-sink-id"`.
+  string sink_name = 1;
+
+  // Required. The updated sink, whose name is the same identifier that appears
+  // as part of `sink_name`.
+  LogSink sink = 2;
+
+  // 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
+  // field on the value of `writer_identity` in the updated sink depends on both
+  // the old and new values of this field:
+  //
+  // +   If the old and new values of this field are both false or both true,
+  //     then there is no change to the sink's `writer_identity`.
+  // +   If the old value is false and the new value is true, then
+  //     `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;
+
+  // 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.
+  //
+  // An empty updateMask is temporarily treated as using the following mask
+  // for backwards compatibility purposes:
+  //   destination,filter,includeChildren
+  // At some point in the future, behavior will be removed and specifying an
+  // empty updateMask will be an error.
+  //
+  // For a detailed `FieldMask` definition, see
+  // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
+  //
+  // Example: `updateMask=filter`.
+  google.protobuf.FieldMask update_mask = 4;
+}
+
+// The parameters to `DeleteSink`.
+message DeleteSinkRequest {
+  // 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]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+  //     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+  //
+  // Example: `"projects/my-project-id/sinks/my-sink-id"`.
+  string sink_name = 1;
+}
+
+// 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.
+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;
+
+  // Optional. A description of this exclusion.
+  string description = 2;
+
+  // Required.
+  // An [advanced logs filter](/logging/docs/view/advanced_filters)
+  // that matches the log entries to be excluded. By using the
+  // [sample function](/logging/docs/view/advanced_filters#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:
+  //
+  // `"resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"`
+  string filter = 3;
+
+  // Optional. If set to True, then this exclusion is disabled and it does not
+  // exclude any log entries. You can use
+  // [exclusions.patch](/logging/docs/reference/v2/rest/v2/projects.exclusions/patch)
+  // to change the value of this field.
+  bool disabled = 4;
+}
+
+// The parameters to `ListExclusions`.
+message ListExclusionsRequest {
+  // Required. The parent resource whose exclusions are to be listed.
+  //
+  //     "projects/[PROJECT_ID]"
+  //     "organizations/[ORGANIZATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]"
+  //     "folders/[FOLDER_ID]"
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Result returned from `ListExclusions`.
+message ListExclusionsResponse {
+  // A list of exclusions.
+  repeated LogExclusion exclusions = 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 `GetExclusion`.
+message GetExclusionRequest {
+  // Required. The resource name of an existing exclusion:
+  //
+  //     "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+  //     "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+  //     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+  //
+  // Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+  string name = 1;
+}
+
+// The parameters to `CreateExclusion`.
+message CreateExclusionRequest {
+  // Required. The parent resource in which to create the exclusion:
+  //
+  //     "projects/[PROJECT_ID]"
+  //     "organizations/[ORGANIZATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]"
+  //     "folders/[FOLDER_ID]"
+  //
+  // Examples: `"projects/my-logging-project"`, `"organizations/123456789"`.
+  string parent = 1;
+
+  // Required. The new exclusion, whose `name` parameter is an exclusion name
+  // that is not already used in the parent resource.
+  LogExclusion exclusion = 2;
+}
+
+// The parameters to `UpdateExclusion`.
+message UpdateExclusionRequest {
+  // Required. The resource name of the exclusion to update:
+  //
+  //     "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+  //     "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+  //     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+  //
+  // Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+  string name = 1;
+
+  // Required. New values for the existing exclusion. Only the fields specified
+  // in `update_mask` are relevant.
+  LogExclusion exclusion = 2;
+
+  // Required. A nonempty list of fields to change in the existing exclusion.
+  // New values for the fields are taken from the corresponding fields in the
+  // [LogExclusion][google.logging.v2.LogExclusion] included in this request.
+  // Fields not mentioned in `update_mask` are not changed and are ignored in
+  // the request.
+  //
+  // For example, to change the filter and description of an exclusion,
+  // specify an `update_mask` of `"filter,description"`.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// The parameters to `DeleteExclusion`.
+message DeleteExclusionRequest {
+  // Required. The resource name of an existing exclusion to delete:
+  //
+  //     "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+  //     "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+  //     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+  //
+  // Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+  string name = 1;
+}
diff --git a/logging/google/cloud/logging_v2/proto/logging_config_pb2.py b/logging/google/cloud/logging_v2/proto/logging_config_pb2.py
new file mode 100644
index 000000000000..cf50eedc6090
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_config_pb2.py
@@ -0,0 +1,1702 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/logging_v2/proto/logging_config.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/logging_v2/proto/logging_config.proto",
+    package="google.logging.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.logging.v2B\022LoggingConfigProtoP\001Z8google.golang.org/genproto/googleapis/logging/v2;logging\370\001\001\252\002\027Google.Cloud.Logging.V2\312\002\027Google\\Cloud\\Logging\\V2"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/logging_v2/proto/logging_config.proto\x12\x11google.logging.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xe3\x02\n\x07LogSink\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65stination\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12K\n\x15output_version_format\x18\x06 \x01(\x0e\x32(.google.logging.v2.LogSink.VersionFormatB\x02\x18\x01\x12\x17\n\x0fwriter_identity\x18\x08 \x01(\t\x12\x18\n\x10include_children\x18\t \x01(\x08\x12\x32\n\nstart_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x02\x18\x01\x12\x30\n\x08\x65nd_time\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x02\x18\x01"?\n\rVersionFormat\x12\x1e\n\x1aVERSION_FORMAT_UNSPECIFIED\x10\x00\x12\x06\n\x02V2\x10\x01\x12\x06\n\x02V1\x10\x02"I\n\x10ListSinksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"W\n\x11ListSinksResponse\x12)\n\x05sinks\x18\x01 \x03(\x0b\x32\x1a.google.logging.v2.LogSink\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"#\n\x0eGetSinkRequest\x12\x11\n\tsink_name\x18\x01 \x01(\t"m\n\x11\x43reateSinkRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12(\n\x04sink\x18\x02 \x01(\x0b\x32\x1a.google.logging.v2.LogSink\x12\x1e\n\x16unique_writer_identity\x18\x03 \x01(\x08"\xa1\x01\n\x11UpdateSinkRequest\x12\x11\n\tsink_name\x18\x01 \x01(\t\x12(\n\x04sink\x18\x02 \x01(\x0b\x32\x1a.google.logging.v2.LogSink\x12\x1e\n\x16unique_writer_identity\x18\x03 \x01(\x08\x12/\n\x0bupdate_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"&\n\x11\x44\x65leteSinkRequest\x12\x11\n\tsink_name\x18\x01 \x01(\t"S\n\x0cLogExclusion\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x10\n\x08\x64isabled\x18\x04 \x01(\x08"N\n\x15ListExclusionsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"f\n\x16ListExclusionsResponse\x12\x33\n\nexclusions\x18\x01 \x03(\x0b\x32\x1f.google.logging.v2.LogExclusion\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"#\n\x13GetExclusionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x16\x43reateExclusionRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x32\n\texclusion\x18\x02 \x01(\x0b\x32\x1f.google.logging.v2.LogExclusion"\x8b\x01\n\x16UpdateExclusionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x32\n\texclusion\x18\x02 \x01(\x0b\x32\x1f.google.logging.v2.LogExclusion\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"&\n\x16\x44\x65leteExclusionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t2\x94\x19\n\x0f\x43onfigServiceV2\x12\x87\x02\n\tListSinks\x12#.google.logging.v2.ListSinksRequest\x1a$.google.logging.v2.ListSinksResponse"\xae\x01\x82\xd3\xe4\x93\x02\xa7\x01\x12\x16/v2/{parent=*/*}/sinksZ\x1f\x12\x1d/v2/{parent=projects/*}/sinksZ$\x12"/v2/{parent=organizations/*}/sinksZ\x1e\x12\x1c/v2/{parent=folders/*}/sinksZ&\x12$/v2/{parent=billingAccounts/*}/sinks\x12\x92\x02\n\x07GetSink\x12!.google.logging.v2.GetSinkRequest\x1a\x1a.google.logging.v2.LogSink"\xc7\x01\x82\xd3\xe4\x93\x02\xc0\x01\x12\x1b/v2/{sink_name=*/*/sinks/*}Z$\x12"/v2/{sink_name=projects/*/sinks/*}Z)\x12\'/v2/{sink_name=organizations/*/sinks/*}Z#\x12!/v2/{sink_name=folders/*/sinks/*}Z+\x12)/v2/{sink_name=billingAccounts/*/sinks/*}\x12\x9d\x02\n\nCreateSink\x12$.google.logging.v2.CreateSinkRequest\x1a\x1a.google.logging.v2.LogSink"\xcc\x01\x82\xd3\xe4\x93\x02\xc5\x01"\x16/v2/{parent=*/*}/sinks:\x04sinkZ%"\x1d/v2/{parent=projects/*}/sinks:\x04sinkZ*""/v2/{parent=organizations/*}/sinks:\x04sinkZ$"\x1c/v2/{parent=folders/*}/sinks:\x04sinkZ,"$/v2/{parent=billingAccounts/*}/sinks:\x04sink\x12\xf1\x03\n\nUpdateSink\x12$.google.logging.v2.UpdateSinkRequest\x1a\x1a.google.logging.v2.LogSink"\xa0\x03\x82\xd3\xe4\x93\x02\x99\x03\x1a\x1b/v2/{sink_name=*/*/sinks/*}:\x04sinkZ*\x1a"/v2/{sink_name=projects/*/sinks/*}:\x04sinkZ/\x1a\'/v2/{sink_name=organizations/*/sinks/*}:\x04sinkZ)\x1a!/v2/{sink_name=folders/*/sinks/*}:\x04sinkZ1\x1a)/v2/{sink_name=billingAccounts/*/sinks/*}:\x04sinkZ*2"/v2/{sink_name=projects/*/sinks/*}:\x04sinkZ/2\'/v2/{sink_name=organizations/*/sinks/*}:\x04sinkZ)2!/v2/{sink_name=folders/*/sinks/*}:\x04sinkZ12)/v2/{sink_name=billingAccounts/*/sinks/*}:\x04sink\x12\x94\x02\n\nDeleteSink\x12$.google.logging.v2.DeleteSinkRequest\x1a\x16.google.protobuf.Empty"\xc7\x01\x82\xd3\xe4\x93\x02\xc0\x01*\x1b/v2/{sink_name=*/*/sinks/*}Z$*"/v2/{sink_name=projects/*/sinks/*}Z)*\'/v2/{sink_name=organizations/*/sinks/*}Z#*!/v2/{sink_name=folders/*/sinks/*}Z+*)/v2/{sink_name=billingAccounts/*/sinks/*}\x12\xaf\x02\n\x0eListExclusions\x12(.google.logging.v2.ListExclusionsRequest\x1a).google.logging.v2.ListExclusionsResponse"\xc7\x01\x82\xd3\xe4\x93\x02\xc0\x01\x12\x1b/v2/{parent=*/*}/exclusionsZ$\x12"/v2/{parent=projects/*}/exclusionsZ)\x12\'/v2/{parent=organizations/*}/exclusionsZ#\x12!/v2/{parent=folders/*}/exclusionsZ+\x12)/v2/{parent=billingAccounts/*}/exclusions\x12\xa1\x02\n\x0cGetExclusion\x12&.google.logging.v2.GetExclusionRequest\x1a\x1f.google.logging.v2.LogExclusion"\xc7\x01\x82\xd3\xe4\x93\x02\xc0\x01\x12\x1b/v2/{name=*/*/exclusions/*}Z$\x12"/v2/{name=projects/*/exclusions/*}Z)\x12\'/v2/{name=organizations/*/exclusions/*}Z#\x12!/v2/{name=folders/*/exclusions/*}Z+\x12)/v2/{name=billingAccounts/*/exclusions/*}\x12\xde\x02\n\x0f\x43reateExclusion\x12).google.logging.v2.CreateExclusionRequest\x1a\x1f.google.logging.v2.LogExclusion"\xfe\x01\x82\xd3\xe4\x93\x02\xf7\x01"\x1b/v2/{parent=*/*}/exclusions:\texclusionZ/""/v2/{parent=projects/*}/exclusions:\texclusionZ4"\'/v2/{parent=organizations/*}/exclusions:\texclusionZ."!/v2/{parent=folders/*}/exclusions:\texclusionZ6")/v2/{parent=billingAccounts/*}/exclusions:\texclusion\x12\xde\x02\n\x0fUpdateExclusion\x12).google.logging.v2.UpdateExclusionRequest\x1a\x1f.google.logging.v2.LogExclusion"\xfe\x01\x82\xd3\xe4\x93\x02\xf7\x01\x32\x1b/v2/{name=*/*/exclusions/*}:\texclusionZ/2"/v2/{name=projects/*/exclusions/*}:\texclusionZ42\'/v2/{name=organizations/*/exclusions/*}:\texclusionZ.2!/v2/{name=folders/*/exclusions/*}:\texclusionZ62)/v2/{name=billingAccounts/*/exclusions/*}:\texclusion\x12\x9e\x02\n\x0f\x44\x65leteExclusion\x12).google.logging.v2.DeleteExclusionRequest\x1a\x16.google.protobuf.Empty"\xc7\x01\x82\xd3\xe4\x93\x02\xc0\x01*\x1b/v2/{name=*/*/exclusions/*}Z$*"/v2/{name=projects/*/exclusions/*}Z)*\'/v2/{name=organizations/*/exclusions/*}Z#*!/v2/{name=folders/*/exclusions/*}Z+*)/v2/{name=billingAccounts/*/exclusions/*}B\x9e\x01\n\x15\x63om.google.logging.v2B\x12LoggingConfigProtoP\x01Z8google.golang.org/genproto/googleapis/logging/v2;logging\xf8\x01\x01\xaa\x02\x17Google.Cloud.Logging.V2\xca\x02\x17Google\\Cloud\\Logging\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGSINK_VERSIONFORMAT = _descriptor.EnumDescriptor(
+    name="VersionFormat",
+    full_name="google.logging.v2.LogSink.VersionFormat",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VERSION_FORMAT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="V2", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="V1", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=492,
+    serialized_end=555,
+)
+_sym_db.RegisterEnumDescriptor(_LOGSINK_VERSIONFORMAT)
+
+
+_LOGSINK = _descriptor.Descriptor(
+    name="LogSink",
+    full_name="google.logging.v2.LogSink",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.logging.v2.LogSink.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="destination",
+            full_name="google.logging.v2.LogSink.destination",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.logging.v2.LogSink.filter",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_version_format",
+            full_name="google.logging.v2.LogSink.output_version_format",
+            index=3,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="writer_identity",
+            full_name="google.logging.v2.LogSink.writer_identity",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_children",
+            full_name="google.logging.v2.LogSink.include_children",
+            index=5,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.logging.v2.LogSink.start_time",
+            index=6,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.logging.v2.LogSink.end_time",
+            index=7,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LOGSINK_VERSIONFORMAT],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=200,
+    serialized_end=555,
+)
+
+
+_LISTSINKSREQUEST = _descriptor.Descriptor(
+    name="ListSinksRequest",
+    full_name="google.logging.v2.ListSinksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.ListSinksRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.logging.v2.ListSinksRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.logging.v2.ListSinksRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=557,
+    serialized_end=630,
+)
+
+
+_LISTSINKSRESPONSE = _descriptor.Descriptor(
+    name="ListSinksResponse",
+    full_name="google.logging.v2.ListSinksResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sinks",
+            full_name="google.logging.v2.ListSinksResponse.sinks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.logging.v2.ListSinksResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=632,
+    serialized_end=719,
+)
+
+
+_GETSINKREQUEST = _descriptor.Descriptor(
+    name="GetSinkRequest",
+    full_name="google.logging.v2.GetSinkRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sink_name",
+            full_name="google.logging.v2.GetSinkRequest.sink_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=721,
+    serialized_end=756,
+)
+
+
+_CREATESINKREQUEST = _descriptor.Descriptor(
+    name="CreateSinkRequest",
+    full_name="google.logging.v2.CreateSinkRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.CreateSinkRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sink",
+            full_name="google.logging.v2.CreateSinkRequest.sink",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unique_writer_identity",
+            full_name="google.logging.v2.CreateSinkRequest.unique_writer_identity",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=758,
+    serialized_end=867,
+)
+
+
+_UPDATESINKREQUEST = _descriptor.Descriptor(
+    name="UpdateSinkRequest",
+    full_name="google.logging.v2.UpdateSinkRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sink_name",
+            full_name="google.logging.v2.UpdateSinkRequest.sink_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sink",
+            full_name="google.logging.v2.UpdateSinkRequest.sink",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unique_writer_identity",
+            full_name="google.logging.v2.UpdateSinkRequest.unique_writer_identity",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.logging.v2.UpdateSinkRequest.update_mask",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=870,
+    serialized_end=1031,
+)
+
+
+_DELETESINKREQUEST = _descriptor.Descriptor(
+    name="DeleteSinkRequest",
+    full_name="google.logging.v2.DeleteSinkRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sink_name",
+            full_name="google.logging.v2.DeleteSinkRequest.sink_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1033,
+    serialized_end=1071,
+)
+
+
+_LOGEXCLUSION = _descriptor.Descriptor(
+    name="LogExclusion",
+    full_name="google.logging.v2.LogExclusion",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.logging.v2.LogExclusion.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.logging.v2.LogExclusion.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.logging.v2.LogExclusion.filter",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disabled",
+            full_name="google.logging.v2.LogExclusion.disabled",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1073,
+    serialized_end=1156,
+)
+
+
+_LISTEXCLUSIONSREQUEST = _descriptor.Descriptor(
+    name="ListExclusionsRequest",
+    full_name="google.logging.v2.ListExclusionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.ListExclusionsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.logging.v2.ListExclusionsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.logging.v2.ListExclusionsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1158,
+    serialized_end=1236,
+)
+
+
+_LISTEXCLUSIONSRESPONSE = _descriptor.Descriptor(
+    name="ListExclusionsResponse",
+    full_name="google.logging.v2.ListExclusionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="exclusions",
+            full_name="google.logging.v2.ListExclusionsResponse.exclusions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.logging.v2.ListExclusionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1238,
+    serialized_end=1340,
+)
+
+
+_GETEXCLUSIONREQUEST = _descriptor.Descriptor(
+    name="GetExclusionRequest",
+    full_name="google.logging.v2.GetExclusionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.logging.v2.GetExclusionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1342,
+    serialized_end=1377,
+)
+
+
+_CREATEEXCLUSIONREQUEST = _descriptor.Descriptor(
+    name="CreateExclusionRequest",
+    full_name="google.logging.v2.CreateExclusionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.CreateExclusionRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclusion",
+            full_name="google.logging.v2.CreateExclusionRequest.exclusion",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1379,
+    serialized_end=1471,
+)
+
+
+_UPDATEEXCLUSIONREQUEST = _descriptor.Descriptor(
+    name="UpdateExclusionRequest",
+    full_name="google.logging.v2.UpdateExclusionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.logging.v2.UpdateExclusionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exclusion",
+            full_name="google.logging.v2.UpdateExclusionRequest.exclusion",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.logging.v2.UpdateExclusionRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1474,
+    serialized_end=1613,
+)
+
+
+_DELETEEXCLUSIONREQUEST = _descriptor.Descriptor(
+    name="DeleteExclusionRequest",
+    full_name="google.logging.v2.DeleteExclusionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.logging.v2.DeleteExclusionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1615,
+    serialized_end=1653,
+)
+
+_LOGSINK.fields_by_name["output_version_format"].enum_type = _LOGSINK_VERSIONFORMAT
+_LOGSINK.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LOGSINK.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LOGSINK_VERSIONFORMAT.containing_type = _LOGSINK
+_LISTSINKSRESPONSE.fields_by_name["sinks"].message_type = _LOGSINK
+_CREATESINKREQUEST.fields_by_name["sink"].message_type = _LOGSINK
+_UPDATESINKREQUEST.fields_by_name["sink"].message_type = _LOGSINK
+_UPDATESINKREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTEXCLUSIONSRESPONSE.fields_by_name["exclusions"].message_type = _LOGEXCLUSION
+_CREATEEXCLUSIONREQUEST.fields_by_name["exclusion"].message_type = _LOGEXCLUSION
+_UPDATEEXCLUSIONREQUEST.fields_by_name["exclusion"].message_type = _LOGEXCLUSION
+_UPDATEEXCLUSIONREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+DESCRIPTOR.message_types_by_name["LogSink"] = _LOGSINK
+DESCRIPTOR.message_types_by_name["ListSinksRequest"] = _LISTSINKSREQUEST
+DESCRIPTOR.message_types_by_name["ListSinksResponse"] = _LISTSINKSRESPONSE
+DESCRIPTOR.message_types_by_name["GetSinkRequest"] = _GETSINKREQUEST
+DESCRIPTOR.message_types_by_name["CreateSinkRequest"] = _CREATESINKREQUEST
+DESCRIPTOR.message_types_by_name["UpdateSinkRequest"] = _UPDATESINKREQUEST
+DESCRIPTOR.message_types_by_name["DeleteSinkRequest"] = _DELETESINKREQUEST
+DESCRIPTOR.message_types_by_name["LogExclusion"] = _LOGEXCLUSION
+DESCRIPTOR.message_types_by_name["ListExclusionsRequest"] = _LISTEXCLUSIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListExclusionsResponse"] = _LISTEXCLUSIONSRESPONSE
+DESCRIPTOR.message_types_by_name["GetExclusionRequest"] = _GETEXCLUSIONREQUEST
+DESCRIPTOR.message_types_by_name["CreateExclusionRequest"] = _CREATEEXCLUSIONREQUEST
+DESCRIPTOR.message_types_by_name["UpdateExclusionRequest"] = _UPDATEEXCLUSIONREQUEST
+DESCRIPTOR.message_types_by_name["DeleteExclusionRequest"] = _DELETEEXCLUSIONREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LogSink = _reflection.GeneratedProtocolMessageType(
+    "LogSink",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOGSINK,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          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.
+      destination:
+          Required. The export destination:  ::
+          "storage.googleapis.com/[GCS_BUCKET]"     "bigquery.googleapis
+          .com/projects/[PROJECT_ID]/datasets/[DATASET]"     "pubsub.goo
+          gleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"  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>`__.
+      filter:
+          Optional. An `advanced logs filter
+          </logging/docs/view/advanced_filters>`__. The only exported
+          log entries are those that are in the resource owning the sink
+          and that match the filter. For example:  ::
+          logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND
+          severity>=ERROR
+      output_version_format:
+          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.
+      writer_identity:
+          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/project
+          s.sinks/update>`__, based on the setting 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_re
+          source>`__. Consult the destination service's documentation to
+          determine the appropriate IAM roles to assign to the identity.
+      include_children:
+          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 sink's parent resource are
+          available for export. If the field is true, then logs from all
+          the projects, folders, and billing accounts contained in the
+          sink's parent resource are also available for export. Whether
+          a particular log entry from the children is exported depends
+          on the sink's filter expression. For example, if this field is
+          true, then the filter ``resource.type=gce_instance`` would
+          export all Compute Engine VM instance log entries from all
+          projects in the sink's parent. To only export entries from
+          certain child projects, filter on the project part of the log
+          name:  ::      logName:("projects/test-project1/" OR
+          "projects/test-project2/") AND     resource.type=gce_instance
+      start_time:
+          Deprecated. This field is ignored when creating or updating
+          sinks.
+      end_time:
+          Deprecated. This field is ignored when creating or updating
+          sinks.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.LogSink)
+    ),
+)
+_sym_db.RegisterMessage(LogSink)
+
+ListSinksRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSinksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSINKSREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``ListSinks``.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource whose sinks are to be listed:
+          ::      "projects/[PROJECT_ID]"
+          "organizations/[ORGANIZATION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]"
+          "folders/[FOLDER_ID]"
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListSinksRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSinksRequest)
+
+ListSinksResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSinksResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSINKSRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""Result returned from ``ListSinks``.
+  
+  
+  Attributes:
+      sinks:
+          A list of sinks.
+      next_page_token:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListSinksResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSinksResponse)
+
+GetSinkRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSinkRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSINKREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``GetSink``.
+  
+  
+  Attributes:
+      sink_name:
+          Required. The resource name of the sink:  ::
+          "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+          "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+          "folders/[FOLDER_ID]/sinks/[SINK_ID]"  Example:
+          ``"projects/my-project-id/sinks/my-sink-id"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.GetSinkRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSinkRequest)
+
+CreateSinkRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSinkRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESINKREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``CreateSink``.
+  
+  
+  Attributes:
+      parent:
+          Required. The resource in which to create the sink:  ::
+          "projects/[PROJECT_ID]"     "organizations/[ORGANIZATION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]"
+          "folders/[FOLDER_ID]"  Examples: ``"projects/my-logging-
+          project"``, ``"organizations/123456789"``.
+      sink:
+          Required. The new sink, whose ``name`` parameter is a sink
+          identifier that is not already in use.
+      unique_writer_identity:
+          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 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.  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].
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.CreateSinkRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSinkRequest)
+
+UpdateSinkRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSinkRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESINKREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``UpdateSink``.
+  
+  
+  Attributes:
+      sink_name:
+          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]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+          "folders/[FOLDER_ID]/sinks/[SINK_ID]"  Example:
+          ``"projects/my-project-id/sinks/my-sink-id"``.
+      sink:
+          Required. The updated sink, whose name is the same identifier
+          that appears as part of ``sink_name``.
+      unique_writer_identity:
+          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 field on the value of ``writer_identity`` in
+          the updated sink depends on both the old and new values of
+          this field:  -  If the old and new values of this field are
+          both false or both true,    then there is no change to the
+          sink's ``writer_identity``. -  If the old value is false and
+          the new value is true, then    ``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.
+      update_mask:
+          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.  An empty updateMask is temporarily
+          treated as using the following mask for backwards
+          compatibility purposes: destination,filter,includeChildren At
+          some point in the future, behavior will be removed and
+          specifying an empty updateMask will be an error.  For a
+          detailed ``FieldMask`` definition, see
+          https://developers.google.com/protocol-buffers/docs/reference/
+          google.protobuf#google.protobuf.FieldMask  Example:
+          ``updateMask=filter``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.UpdateSinkRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSinkRequest)
+
+DeleteSinkRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSinkRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESINKREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``DeleteSink``.
+  
+  
+  Attributes:
+      sink_name:
+          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]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+          "folders/[FOLDER_ID]/sinks/[SINK_ID]"  Example:
+          ``"projects/my-project-id/sinks/my-sink-id"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.DeleteSinkRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSinkRequest)
+
+LogExclusion = _reflection.GeneratedProtocolMessageType(
+    "LogExclusion",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOGEXCLUSION,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          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.
+      description:
+          Optional. A description of this exclusion.
+      filter:
+          Required. An `advanced logs filter
+          </logging/docs/view/advanced_filters>`__ that matches the log
+          entries to be excluded. By using the `sample function
+          </logging/docs/view/advanced_filters#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:
+          ``"resource.type=http_load_balancer severity<ERROR
+          sample(insertId, 0.99)"``
+      disabled:
+          Optional. If set to True, then this exclusion is disabled and
+          it does not exclude any log entries. You can use
+          `exclusions.patch </logging/docs/reference/v2/rest/v2/projects
+          .exclusions/patch>`__ to change the value of this field.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.LogExclusion)
+    ),
+)
+_sym_db.RegisterMessage(LogExclusion)
+
+ListExclusionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListExclusionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEXCLUSIONSREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``ListExclusions``.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource whose exclusions are to be
+          listed.  ::      "projects/[PROJECT_ID]"
+          "organizations/[ORGANIZATION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]"
+          "folders/[FOLDER_ID]"
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListExclusionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListExclusionsRequest)
+
+ListExclusionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListExclusionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTEXCLUSIONSRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""Result returned from ``ListExclusions``.
+  
+  
+  Attributes:
+      exclusions:
+          A list of exclusions.
+      next_page_token:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListExclusionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListExclusionsResponse)
+
+GetExclusionRequest = _reflection.GeneratedProtocolMessageType(
+    "GetExclusionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETEXCLUSIONREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``GetExclusion``.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of an existing exclusion:  ::
+          "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+          "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID
+          ]"     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+          Example: ``"projects/my-project-id/exclusions/my-exclusion-
+          id"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.GetExclusionRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetExclusionRequest)
+
+CreateExclusionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateExclusionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEEXCLUSIONREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``CreateExclusion``.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource in which to create the
+          exclusion:  ::      "projects/[PROJECT_ID]"
+          "organizations/[ORGANIZATION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]"
+          "folders/[FOLDER_ID]"  Examples: ``"projects/my-logging-
+          project"``, ``"organizations/123456789"``.
+      exclusion:
+          Required. The new exclusion, whose ``name`` parameter is an
+          exclusion name that is not already used in the parent
+          resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.CreateExclusionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateExclusionRequest)
+
+UpdateExclusionRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateExclusionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEEXCLUSIONREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``UpdateExclusion``.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the exclusion to update:  ::
+          "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+          "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID
+          ]"     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+          Example: ``"projects/my-project-id/exclusions/my-exclusion-
+          id"``.
+      exclusion:
+          Required. New values for the existing exclusion. Only the
+          fields specified in ``update_mask`` are relevant.
+      update_mask:
+          Required. A nonempty list of fields to change in the existing
+          exclusion. New values for the fields are taken from the
+          corresponding fields in the
+          [LogExclusion][google.logging.v2.LogExclusion] included in
+          this request. Fields not mentioned in ``update_mask`` are not
+          changed and are ignored in the request.  For example, to
+          change the filter and description of an exclusion, specify an
+          ``update_mask`` of ``"filter,description"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.UpdateExclusionRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateExclusionRequest)
+
+DeleteExclusionRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteExclusionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEEXCLUSIONREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_config_pb2",
+        __doc__="""The parameters to ``DeleteExclusion``.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of an existing exclusion to
+          delete:  ::
+          "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+          "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID
+          ]"     "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+          Example: ``"projects/my-project-id/exclusions/my-exclusion-
+          id"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.DeleteExclusionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteExclusionRequest)
+
+
+DESCRIPTOR._options = None
+_LOGSINK.fields_by_name["output_version_format"]._options = None
+_LOGSINK.fields_by_name["start_time"]._options = None
+_LOGSINK.fields_by_name["end_time"]._options = None
+
+_CONFIGSERVICEV2 = _descriptor.ServiceDescriptor(
+    name="ConfigServiceV2",
+    full_name="google.logging.v2.ConfigServiceV2",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1656,
+    serialized_end=4876,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListSinks",
+            full_name="google.logging.v2.ConfigServiceV2.ListSinks",
+            index=0,
+            containing_service=None,
+            input_type=_LISTSINKSREQUEST,
+            output_type=_LISTSINKSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\247\001\022\026/v2/{parent=*/*}/sinksZ\037\022\035/v2/{parent=projects/*}/sinksZ$\022"/v2/{parent=organizations/*}/sinksZ\036\022\034/v2/{parent=folders/*}/sinksZ&\022$/v2/{parent=billingAccounts/*}/sinks'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSink",
+            full_name="google.logging.v2.ConfigServiceV2.GetSink",
+            index=1,
+            containing_service=None,
+            input_type=_GETSINKREQUEST,
+            output_type=_LOGSINK,
+            serialized_options=_b(
+                "\202\323\344\223\002\300\001\022\033/v2/{sink_name=*/*/sinks/*}Z$\022\"/v2/{sink_name=projects/*/sinks/*}Z)\022'/v2/{sink_name=organizations/*/sinks/*}Z#\022!/v2/{sink_name=folders/*/sinks/*}Z+\022)/v2/{sink_name=billingAccounts/*/sinks/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateSink",
+            full_name="google.logging.v2.ConfigServiceV2.CreateSink",
+            index=2,
+            containing_service=None,
+            input_type=_CREATESINKREQUEST,
+            output_type=_LOGSINK,
+            serialized_options=_b(
+                '\202\323\344\223\002\305\001"\026/v2/{parent=*/*}/sinks:\004sinkZ%"\035/v2/{parent=projects/*}/sinks:\004sinkZ*""/v2/{parent=organizations/*}/sinks:\004sinkZ$"\034/v2/{parent=folders/*}/sinks:\004sinkZ,"$/v2/{parent=billingAccounts/*}/sinks:\004sink'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSink",
+            full_name="google.logging.v2.ConfigServiceV2.UpdateSink",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATESINKREQUEST,
+            output_type=_LOGSINK,
+            serialized_options=_b(
+                "\202\323\344\223\002\231\003\032\033/v2/{sink_name=*/*/sinks/*}:\004sinkZ*\032\"/v2/{sink_name=projects/*/sinks/*}:\004sinkZ/\032'/v2/{sink_name=organizations/*/sinks/*}:\004sinkZ)\032!/v2/{sink_name=folders/*/sinks/*}:\004sinkZ1\032)/v2/{sink_name=billingAccounts/*/sinks/*}:\004sinkZ*2\"/v2/{sink_name=projects/*/sinks/*}:\004sinkZ/2'/v2/{sink_name=organizations/*/sinks/*}:\004sinkZ)2!/v2/{sink_name=folders/*/sinks/*}:\004sinkZ12)/v2/{sink_name=billingAccounts/*/sinks/*}:\004sink"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSink",
+            full_name="google.logging.v2.ConfigServiceV2.DeleteSink",
+            index=4,
+            containing_service=None,
+            input_type=_DELETESINKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\300\001*\033/v2/{sink_name=*/*/sinks/*}Z$*\"/v2/{sink_name=projects/*/sinks/*}Z)*'/v2/{sink_name=organizations/*/sinks/*}Z#*!/v2/{sink_name=folders/*/sinks/*}Z+*)/v2/{sink_name=billingAccounts/*/sinks/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListExclusions",
+            full_name="google.logging.v2.ConfigServiceV2.ListExclusions",
+            index=5,
+            containing_service=None,
+            input_type=_LISTEXCLUSIONSREQUEST,
+            output_type=_LISTEXCLUSIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\300\001\022\033/v2/{parent=*/*}/exclusionsZ$\022\"/v2/{parent=projects/*}/exclusionsZ)\022'/v2/{parent=organizations/*}/exclusionsZ#\022!/v2/{parent=folders/*}/exclusionsZ+\022)/v2/{parent=billingAccounts/*}/exclusions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetExclusion",
+            full_name="google.logging.v2.ConfigServiceV2.GetExclusion",
+            index=6,
+            containing_service=None,
+            input_type=_GETEXCLUSIONREQUEST,
+            output_type=_LOGEXCLUSION,
+            serialized_options=_b(
+                "\202\323\344\223\002\300\001\022\033/v2/{name=*/*/exclusions/*}Z$\022\"/v2/{name=projects/*/exclusions/*}Z)\022'/v2/{name=organizations/*/exclusions/*}Z#\022!/v2/{name=folders/*/exclusions/*}Z+\022)/v2/{name=billingAccounts/*/exclusions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateExclusion",
+            full_name="google.logging.v2.ConfigServiceV2.CreateExclusion",
+            index=7,
+            containing_service=None,
+            input_type=_CREATEEXCLUSIONREQUEST,
+            output_type=_LOGEXCLUSION,
+            serialized_options=_b(
+                '\202\323\344\223\002\367\001"\033/v2/{parent=*/*}/exclusions:\texclusionZ/""/v2/{parent=projects/*}/exclusions:\texclusionZ4"\'/v2/{parent=organizations/*}/exclusions:\texclusionZ."!/v2/{parent=folders/*}/exclusions:\texclusionZ6")/v2/{parent=billingAccounts/*}/exclusions:\texclusion'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateExclusion",
+            full_name="google.logging.v2.ConfigServiceV2.UpdateExclusion",
+            index=8,
+            containing_service=None,
+            input_type=_UPDATEEXCLUSIONREQUEST,
+            output_type=_LOGEXCLUSION,
+            serialized_options=_b(
+                "\202\323\344\223\002\367\0012\033/v2/{name=*/*/exclusions/*}:\texclusionZ/2\"/v2/{name=projects/*/exclusions/*}:\texclusionZ42'/v2/{name=organizations/*/exclusions/*}:\texclusionZ.2!/v2/{name=folders/*/exclusions/*}:\texclusionZ62)/v2/{name=billingAccounts/*/exclusions/*}:\texclusion"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteExclusion",
+            full_name="google.logging.v2.ConfigServiceV2.DeleteExclusion",
+            index=9,
+            containing_service=None,
+            input_type=_DELETEEXCLUSIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\300\001*\033/v2/{name=*/*/exclusions/*}Z$*\"/v2/{name=projects/*/exclusions/*}Z)*'/v2/{name=organizations/*/exclusions/*}Z#*!/v2/{name=folders/*/exclusions/*}Z+*)/v2/{name=billingAccounts/*/exclusions/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CONFIGSERVICEV2)
+
+DESCRIPTOR.services_by_name["ConfigServiceV2"] = _CONFIGSERVICEV2
+
+# @@protoc_insertion_point(module_scope)
diff --git a/logging/google/cloud/logging_v2/proto/logging_config_pb2_grpc.py b/logging/google/cloud/logging_v2/proto/logging_config_pb2_grpc.py
new file mode 100644
index 000000000000..6e93d39b46b4
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_config_pb2_grpc.py
@@ -0,0 +1,214 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.logging_v2.proto import (
+    logging_config_pb2 as google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ConfigServiceV2Stub(object):
+    """Service for configuring sinks used to export log entries out of
+  Logging.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListSinks = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/ListSinks",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListSinksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListSinksResponse.FromString,
+        )
+        self.GetSink = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/GetSink",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.GetSinkRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogSink.FromString,
+        )
+        self.CreateSink = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/CreateSink",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.CreateSinkRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogSink.FromString,
+        )
+        self.UpdateSink = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/UpdateSink",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.UpdateSinkRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogSink.FromString,
+        )
+        self.DeleteSink = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/DeleteSink",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.DeleteSinkRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListExclusions = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/ListExclusions",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListExclusionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListExclusionsResponse.FromString,
+        )
+        self.GetExclusion = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/GetExclusion",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.GetExclusionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogExclusion.FromString,
+        )
+        self.CreateExclusion = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/CreateExclusion",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.CreateExclusionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogExclusion.FromString,
+        )
+        self.UpdateExclusion = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/UpdateExclusion",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.UpdateExclusionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogExclusion.FromString,
+        )
+        self.DeleteExclusion = channel.unary_unary(
+            "/google.logging.v2.ConfigServiceV2/DeleteExclusion",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.DeleteExclusionRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class ConfigServiceV2Servicer(object):
+    """Service for configuring sinks used to export log entries out of
+  Logging.
+  """
+
+    def ListSinks(self, request, context):
+        """Lists sinks.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSink(self, request, context):
+        """Gets a sink.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateSink(self, request, context):
+        """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
+    export log entries only from the resource owning the sink.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSink(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSink(self, request, context):
+        """Deletes a sink. If the sink has a unique `writer_identity`, then that
+    service account is also deleted.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListExclusions(self, request, context):
+        """Lists all the exclusions in a parent resource.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetExclusion(self, request, context):
+        """Gets the description of an exclusion.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateExclusion(self, request, context):
+        """Creates a new exclusion in a specified parent resource.
+    Only log entries belonging to that resource can be excluded.
+    You can have up to 10 exclusions in a resource.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateExclusion(self, request, context):
+        """Changes one or more properties of an existing exclusion.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteExclusion(self, request, context):
+        """Deletes an exclusion.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ConfigServiceV2Servicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListSinks": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSinks,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListSinksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListSinksResponse.SerializeToString,
+        ),
+        "GetSink": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSink,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.GetSinkRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogSink.SerializeToString,
+        ),
+        "CreateSink": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSink,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.CreateSinkRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogSink.SerializeToString,
+        ),
+        "UpdateSink": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSink,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.UpdateSinkRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogSink.SerializeToString,
+        ),
+        "DeleteSink": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSink,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.DeleteSinkRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListExclusions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListExclusions,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListExclusionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.ListExclusionsResponse.SerializeToString,
+        ),
+        "GetExclusion": grpc.unary_unary_rpc_method_handler(
+            servicer.GetExclusion,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.GetExclusionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogExclusion.SerializeToString,
+        ),
+        "CreateExclusion": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateExclusion,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.CreateExclusionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogExclusion.SerializeToString,
+        ),
+        "UpdateExclusion": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateExclusion,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.UpdateExclusionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.LogExclusion.SerializeToString,
+        ),
+        "DeleteExclusion": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteExclusion,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__config__pb2.DeleteExclusionRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.logging.v2.ConfigServiceV2", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/logging/google/cloud/logging_v2/proto/logging_metrics.proto b/logging/google/cloud/logging_v2/proto/logging_metrics.proto
new file mode 100644
index 000000000000..dd3fa87821dc
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_metrics.proto
@@ -0,0 +1,264 @@
+// 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.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/api/distribution.proto";
+import "google/api/metric.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Logging.V2";
+option go_package = "google.golang.org/genproto/googleapis/logging/v2;logging";
+option java_multiple_files = true;
+option java_outer_classname = "LoggingMetricsProto";
+option java_package = "com.google.logging.v2";
+option php_namespace = "Google\\Cloud\\Logging\\V2";
+
+// Service for configuring logs-based metrics.
+service MetricsServiceV2 {
+  // Lists logs-based metrics.
+  rpc ListLogMetrics(ListLogMetricsRequest) returns (ListLogMetricsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*}/metrics"
+    };
+  }
+
+  // Gets a logs-based metric.
+  rpc GetLogMetric(GetLogMetricRequest) returns (LogMetric) {
+    option (google.api.http) = {
+      get: "/v2/{metric_name=projects/*/metrics/*}"
+    };
+  }
+
+  // Creates a logs-based metric.
+  rpc CreateLogMetric(CreateLogMetricRequest) returns (LogMetric) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*}/metrics"
+      body: "metric"
+    };
+  }
+
+  // Creates or updates a logs-based metric.
+  rpc UpdateLogMetric(UpdateLogMetricRequest) returns (LogMetric) {
+    option (google.api.http) = {
+      put: "/v2/{metric_name=projects/*/metrics/*}"
+      body: "metric"
+    };
+  }
+
+  // Deletes a logs-based metric.
+  rpc DeleteLogMetric(DeleteLogMetricRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{metric_name=projects/*/metrics/*}"
+    };
+  }
+}
+
+// Describes a logs-based metric.  The value of the metric is the
+// number of log entries that match a logs filter in a given time interval.
+//
+// Logs-based metric can also be used to extract values from logs and create a
+// a distribution of the values. The distribution records the statistics of the
+// extracted values along with an optional histogram of the values as specified
+// by the bucket options.
+message LogMetric {
+  // Logging API version.
+  enum ApiVersion {
+    // Logging API v2.
+    V2 = 0;
+
+    // Logging API v1.
+    V1 = 1;
+  }
+
+  // Required. The client-assigned metric identifier.
+  // Examples: `"error_count"`, `"nginx/requests"`.
+  //
+  // Metric identifiers are limited to 100 characters and can include
+  // only the following characters: `A-Z`, `a-z`, `0-9`, and the
+  // special characters `_-.,+!*',()%/`.  The forward-slash character
+  // (`/`) denotes a hierarchy of name pieces, and it cannot be the
+  // first character of the name.
+  //
+  // The metric identifier in this field must not be
+  // [URL-encoded](https://en.wikipedia.org/wiki/Percent-encoding).
+  // However, when the metric identifier appears as the `[METRIC_ID]`
+  // part of a `metric_name` API parameter, then the metric identifier
+  // must be URL-encoded. Example:
+  // `"projects/my-project/metrics/nginx%2Frequests"`.
+  string name = 1;
+
+  // Optional. A description of this metric, which is used in documentation.
+  string description = 2;
+
+  // Required. An [advanced logs filter](/logging/docs/view/advanced_filters)
+  // which is used to match log entries.
+  // Example:
+  //
+  //     "resource.type=gae_app AND severity>=ERROR"
+  //
+  // The maximum length of the filter is 20000 characters.
+  string filter = 3;
+
+  // Optional. The metric descriptor associated with the logs-based metric.
+  // If unspecified, it uses a default metric descriptor with a DELTA metric
+  // kind, INT64 value type, with no labels and a unit of "1". Such a metric
+  // counts the number of log entries matching the `filter` expression.
+  //
+  // The `name`, `type`, and `description` fields in the `metric_descriptor`
+  // are output only, and is constructed using the `name` and `description`
+  // field in the LogMetric.
+  //
+  // To create a logs-based metric that records a distribution of log values, a
+  // DELTA metric kind with a DISTRIBUTION value type must be used along with
+  // a `value_extractor` expression in the LogMetric.
+  //
+  // Each label in the metric descriptor must have a matching label
+  // name as the key and an extractor expression as the value in the
+  // `label_extractors` map.
+  //
+  // The `metric_kind` and `value_type` fields in the `metric_descriptor` cannot
+  // 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;
+
+  // Optional. A `value_extractor` is required when using a distribution
+  // logs-based metric to extract the values to record from a log entry.
+  // Two functions are supported for value extraction: `EXTRACT(field)` or
+  // `REGEXP_EXTRACT(field, regex)`. The argument are:
+  //   1. field: The name of the log entry field from which the value is to be
+  //      extracted.
+  //   2. regex: A regular expression using the Google RE2 syntax
+  //      (https://github.com/google/re2/wiki/Syntax) with a single capture
+  //      group to extract data from the specified log entry field. The value
+  //      of the field is converted to a string before applying the regex.
+  //      It is an error to specify a regex that does not include exactly one
+  //      capture group.
+  //
+  // The result of the extraction must be convertible to a double type, as the
+  // distribution always records double values. If either the extraction or
+  // the conversion to double fails, then those values are not recorded in the
+  // distribution.
+  //
+  // Example: `REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*")`
+  string value_extractor = 6;
+
+  // 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.
+  // Each label key specified in the LabelDescriptor must have an associated
+  // extractor expression in this map. The syntax of the extractor expression
+  // is the same as for the `value_extractor` field.
+  //
+  // The extracted value is converted to the type defined in the label
+  // descriptor. If the either the extraction or the type conversion fails,
+  // the label will have a default value. The default value for a string
+  // label is an empty string, for an integer label its 0, and for a boolean
+  // label its `false`.
+  //
+  // 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<string, string> label_extractors = 7;
+
+  // 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;
+
+  // Deprecated. The API version that created or updated this metric.
+  // The v2 format is used by default and cannot be changed.
+  ApiVersion version = 4 [deprecated = true];
+}
+
+// The parameters to ListLogMetrics.
+message ListLogMetricsRequest {
+  // Required. The name of the project containing the metrics:
+  //
+  //     "projects/[PROJECT_ID]"
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Result returned from ListLogMetrics.
+message ListLogMetricsResponse {
+  // A list of logs-based metrics.
+  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
+  // 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:
+  //
+  //     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+  string metric_name = 1;
+}
+
+// The parameters to CreateLogMetric.
+message CreateLogMetricRequest {
+  // 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;
+
+  // The new logs-based metric, which must not have an identifier that
+  // already exists.
+  LogMetric metric = 2;
+}
+
+// The parameters to UpdateLogMetric.
+message UpdateLogMetricRequest {
+  // 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;
+
+  // The updated metric.
+  LogMetric metric = 2;
+}
+
+// The parameters to DeleteLogMetric.
+message DeleteLogMetricRequest {
+  // The resource name of the metric to delete:
+  //
+  //     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+  string metric_name = 1;
+}
diff --git a/logging/google/cloud/logging_v2/proto/logging_metrics_pb2.py b/logging/google/cloud/logging_v2/proto/logging_metrics_pb2.py
new file mode 100644
index 000000000000..fc50185871d2
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_metrics_pb2.py
@@ -0,0 +1,966 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/logging_v2/proto/logging_metrics.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import distribution_pb2 as google_dot_api_dot_distribution__pb2
+from google.api import metric_pb2 as google_dot_api_dot_metric__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/logging_v2/proto/logging_metrics.proto",
+    package="google.logging.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.logging.v2B\023LoggingMetricsProtoP\001Z8google.golang.org/genproto/googleapis/logging/v2;logging\370\001\001\252\002\027Google.Cloud.Logging.V2\312\002\027Google\\Cloud\\Logging\\V2"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/logging_v2/proto/logging_metrics.proto\x12\x11google.logging.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1dgoogle/api/distribution.proto\x1a\x17google/api/metric.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xb1\x03\n\tLogMetric\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x03 \x01(\t\x12\x37\n\x11metric_descriptor\x18\x05 \x01(\x0b\x32\x1c.google.api.MetricDescriptor\x12\x17\n\x0fvalue_extractor\x18\x06 \x01(\t\x12K\n\x10label_extractors\x18\x07 \x03(\x0b\x32\x31.google.logging.v2.LogMetric.LabelExtractorsEntry\x12>\n\x0e\x62ucket_options\x18\x08 \x01(\x0b\x32&.google.api.Distribution.BucketOptions\x12<\n\x07version\x18\x04 \x01(\x0e\x32\'.google.logging.v2.LogMetric.ApiVersionB\x02\x18\x01\x1a\x36\n\x14LabelExtractorsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x1c\n\nApiVersion\x12\x06\n\x02V2\x10\x00\x12\x06\n\x02V1\x10\x01"N\n\x15ListLogMetricsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"`\n\x16ListLogMetricsResponse\x12-\n\x07metrics\x18\x01 \x03(\x0b\x32\x1c.google.logging.v2.LogMetric\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"*\n\x13GetLogMetricRequest\x12\x13\n\x0bmetric_name\x18\x01 \x01(\t"V\n\x16\x43reateLogMetricRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12,\n\x06metric\x18\x02 \x01(\x0b\x32\x1c.google.logging.v2.LogMetric"[\n\x16UpdateLogMetricRequest\x12\x13\n\x0bmetric_name\x18\x01 \x01(\t\x12,\n\x06metric\x18\x02 \x01(\x0b\x32\x1c.google.logging.v2.LogMetric"-\n\x16\x44\x65leteLogMetricRequest\x12\x13\n\x0bmetric_name\x18\x01 \x01(\t2\xd4\x05\n\x10MetricsServiceV2\x12\x8e\x01\n\x0eListLogMetrics\x12(.google.logging.v2.ListLogMetricsRequest\x1a).google.logging.v2.ListLogMetricsResponse"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v2/{parent=projects/*}/metrics\x12\x84\x01\n\x0cGetLogMetric\x12&.google.logging.v2.GetLogMetricRequest\x1a\x1c.google.logging.v2.LogMetric".\x82\xd3\xe4\x93\x02(\x12&/v2/{metric_name=projects/*/metrics/*}\x12\x8b\x01\n\x0f\x43reateLogMetric\x12).google.logging.v2.CreateLogMetricRequest\x1a\x1c.google.logging.v2.LogMetric"/\x82\xd3\xe4\x93\x02)"\x1f/v2/{parent=projects/*}/metrics:\x06metric\x12\x92\x01\n\x0fUpdateLogMetric\x12).google.logging.v2.UpdateLogMetricRequest\x1a\x1c.google.logging.v2.LogMetric"6\x82\xd3\xe4\x93\x02\x30\x1a&/v2/{metric_name=projects/*/metrics/*}:\x06metric\x12\x84\x01\n\x0f\x44\x65leteLogMetric\x12).google.logging.v2.DeleteLogMetricRequest\x1a\x16.google.protobuf.Empty".\x82\xd3\xe4\x93\x02(*&/v2/{metric_name=projects/*/metrics/*}B\x9f\x01\n\x15\x63om.google.logging.v2B\x13LoggingMetricsProtoP\x01Z8google.golang.org/genproto/googleapis/logging/v2;logging\xf8\x01\x01\xaa\x02\x17Google.Cloud.Logging.V2\xca\x02\x17Google\\Cloud\\Logging\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_distribution__pb2.DESCRIPTOR,
+        google_dot_api_dot_metric__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGMETRIC_APIVERSION = _descriptor.EnumDescriptor(
+    name="ApiVersion",
+    full_name="google.logging.v2.LogMetric.ApiVersion",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="V2", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="V1", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=662,
+    serialized_end=690,
+)
+_sym_db.RegisterEnumDescriptor(_LOGMETRIC_APIVERSION)
+
+
+_LOGMETRIC_LABELEXTRACTORSENTRY = _descriptor.Descriptor(
+    name="LabelExtractorsEntry",
+    full_name="google.logging.v2.LogMetric.LabelExtractorsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.logging.v2.LogMetric.LabelExtractorsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.logging.v2.LogMetric.LabelExtractorsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=606,
+    serialized_end=660,
+)
+
+_LOGMETRIC = _descriptor.Descriptor(
+    name="LogMetric",
+    full_name="google.logging.v2.LogMetric",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.logging.v2.LogMetric.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.logging.v2.LogMetric.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.logging.v2.LogMetric.filter",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metric_descriptor",
+            full_name="google.logging.v2.LogMetric.metric_descriptor",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value_extractor",
+            full_name="google.logging.v2.LogMetric.value_extractor",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_extractors",
+            full_name="google.logging.v2.LogMetric.label_extractors",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bucket_options",
+            full_name="google.logging.v2.LogMetric.bucket_options",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.logging.v2.LogMetric.version",
+            index=7,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LOGMETRIC_LABELEXTRACTORSENTRY],
+    enum_types=[_LOGMETRIC_APIVERSION],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=257,
+    serialized_end=690,
+)
+
+
+_LISTLOGMETRICSREQUEST = _descriptor.Descriptor(
+    name="ListLogMetricsRequest",
+    full_name="google.logging.v2.ListLogMetricsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.ListLogMetricsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.logging.v2.ListLogMetricsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.logging.v2.ListLogMetricsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=692,
+    serialized_end=770,
+)
+
+
+_LISTLOGMETRICSRESPONSE = _descriptor.Descriptor(
+    name="ListLogMetricsResponse",
+    full_name="google.logging.v2.ListLogMetricsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metrics",
+            full_name="google.logging.v2.ListLogMetricsResponse.metrics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.logging.v2.ListLogMetricsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=772,
+    serialized_end=868,
+)
+
+
+_GETLOGMETRICREQUEST = _descriptor.Descriptor(
+    name="GetLogMetricRequest",
+    full_name="google.logging.v2.GetLogMetricRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metric_name",
+            full_name="google.logging.v2.GetLogMetricRequest.metric_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=870,
+    serialized_end=912,
+)
+
+
+_CREATELOGMETRICREQUEST = _descriptor.Descriptor(
+    name="CreateLogMetricRequest",
+    full_name="google.logging.v2.CreateLogMetricRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.CreateLogMetricRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metric",
+            full_name="google.logging.v2.CreateLogMetricRequest.metric",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=914,
+    serialized_end=1000,
+)
+
+
+_UPDATELOGMETRICREQUEST = _descriptor.Descriptor(
+    name="UpdateLogMetricRequest",
+    full_name="google.logging.v2.UpdateLogMetricRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metric_name",
+            full_name="google.logging.v2.UpdateLogMetricRequest.metric_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metric",
+            full_name="google.logging.v2.UpdateLogMetricRequest.metric",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1002,
+    serialized_end=1093,
+)
+
+
+_DELETELOGMETRICREQUEST = _descriptor.Descriptor(
+    name="DeleteLogMetricRequest",
+    full_name="google.logging.v2.DeleteLogMetricRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metric_name",
+            full_name="google.logging.v2.DeleteLogMetricRequest.metric_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1095,
+    serialized_end=1140,
+)
+
+_LOGMETRIC_LABELEXTRACTORSENTRY.containing_type = _LOGMETRIC
+_LOGMETRIC.fields_by_name[
+    "metric_descriptor"
+].message_type = google_dot_api_dot_metric__pb2._METRICDESCRIPTOR
+_LOGMETRIC.fields_by_name[
+    "label_extractors"
+].message_type = _LOGMETRIC_LABELEXTRACTORSENTRY
+_LOGMETRIC.fields_by_name[
+    "bucket_options"
+].message_type = google_dot_api_dot_distribution__pb2._DISTRIBUTION_BUCKETOPTIONS
+_LOGMETRIC.fields_by_name["version"].enum_type = _LOGMETRIC_APIVERSION
+_LOGMETRIC_APIVERSION.containing_type = _LOGMETRIC
+_LISTLOGMETRICSRESPONSE.fields_by_name["metrics"].message_type = _LOGMETRIC
+_CREATELOGMETRICREQUEST.fields_by_name["metric"].message_type = _LOGMETRIC
+_UPDATELOGMETRICREQUEST.fields_by_name["metric"].message_type = _LOGMETRIC
+DESCRIPTOR.message_types_by_name["LogMetric"] = _LOGMETRIC
+DESCRIPTOR.message_types_by_name["ListLogMetricsRequest"] = _LISTLOGMETRICSREQUEST
+DESCRIPTOR.message_types_by_name["ListLogMetricsResponse"] = _LISTLOGMETRICSRESPONSE
+DESCRIPTOR.message_types_by_name["GetLogMetricRequest"] = _GETLOGMETRICREQUEST
+DESCRIPTOR.message_types_by_name["CreateLogMetricRequest"] = _CREATELOGMETRICREQUEST
+DESCRIPTOR.message_types_by_name["UpdateLogMetricRequest"] = _UPDATELOGMETRICREQUEST
+DESCRIPTOR.message_types_by_name["DeleteLogMetricRequest"] = _DELETELOGMETRICREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LogMetric = _reflection.GeneratedProtocolMessageType(
+    "LogMetric",
+    (_message.Message,),
+    dict(
+        LabelExtractorsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelExtractorsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOGMETRIC_LABELEXTRACTORSENTRY,
+                __module__="google.cloud.logging_v2.proto.logging_metrics_pb2"
+                # @@protoc_insertion_point(class_scope:google.logging.v2.LogMetric.LabelExtractorsEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOGMETRIC,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""Describes a logs-based metric. The value of the metric is the number of
+  log entries that match a logs filter in a given time interval.
+  
+  Logs-based metric can also be used to extract values from logs and
+  create a a distribution of the values. The distribution records the
+  statistics of the extracted values along with an optional histogram of
+  the values as specified by the bucket options.
+  
+  
+  Attributes:
+      name:
+          Required. The client-assigned metric identifier. Examples:
+          ``"error_count"``, ``"nginx/requests"``.  Metric identifiers
+          are limited to 100 characters and can include only the
+          following characters: ``A-Z``, ``a-z``, ``0-9``, and the
+          special characters ``_-.,+!*',()%/``. The forward-slash
+          character (``/``) denotes a hierarchy of name pieces, and it
+          cannot be the first character of the name.  The metric
+          identifier in this field must not be `URL-encoded
+          <https://en.wikipedia.org/wiki/Percent-encoding>`__. However,
+          when the metric identifier appears as the ``[METRIC_ID]`` part
+          of a ``metric_name`` API parameter, then the metric identifier
+          must be URL-encoded. Example: ``"projects/my-
+          project/metrics/nginx%2Frequests"``.
+      description:
+          Optional. A description of this metric, which is used in
+          documentation.
+      filter:
+          Required. An `advanced logs filter
+          </logging/docs/view/advanced_filters>`__ which is used to
+          match log entries. Example:  ::      "resource.type=gae_app
+          AND severity>=ERROR"  The maximum length of the filter is
+          20000 characters.
+      metric_descriptor:
+          Optional. The metric descriptor associated with the logs-based
+          metric. If unspecified, it uses a default metric descriptor
+          with a DELTA metric kind, INT64 value type, with no labels and
+          a unit of "1". Such a metric counts the number of log entries
+          matching the ``filter`` expression.  The ``name``, ``type``,
+          and ``description`` fields in the ``metric_descriptor`` are
+          output only, and is constructed using the ``name`` and
+          ``description`` field in the LogMetric.  To create a logs-
+          based metric that records a distribution of log values, a
+          DELTA metric kind with a DISTRIBUTION value type must be used
+          along with a ``value_extractor`` expression in the LogMetric.
+          Each label in the metric descriptor must have a matching label
+          name as the key and an extractor expression as the value in
+          the ``label_extractors`` map.  The ``metric_kind`` and
+          ``value_type`` fields in the ``metric_descriptor`` cannot be
+          updated once initially configured. New labels can be added in
+          the ``metric_descriptor``, but existing labels cannot be
+          modified except for their description.
+      value_extractor:
+          Optional. A ``value_extractor`` is required when using a
+          distribution logs-based metric to extract the values to record
+          from a log entry. Two functions are supported for value
+          extraction: ``EXTRACT(field)`` or ``REGEXP_EXTRACT(field,
+          regex)``. The argument are: 1. field: The name of the log
+          entry field from which the value is to be extracted. 2. regex:
+          A regular expression using the Google RE2 syntax
+          (https://github.com/google/re2/wiki/Syntax) with a single
+          capture group to extract data from the specified log entry
+          field. The value of the field is converted to a string before
+          applying the regex. It is an error to specify a regex that
+          does not include exactly one capture group.  The result of the
+          extraction must be convertible to a double type, as the
+          distribution always records double values. If either the
+          extraction or the conversion to double fails, then those
+          values are not recorded in the distribution.  Example:
+          ``REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*")``
+      label_extractors:
+          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. Each label key specified
+          in the LabelDescriptor must have an associated extractor
+          expression in this map. The syntax of the extractor expression
+          is the same as for the ``value_extractor`` field.  The
+          extracted value is converted to the type defined in the label
+          descriptor. If the either the extraction or the type
+          conversion fails, the label will have a default value. The
+          default value for a string label is an empty string, for an
+          integer label its 0, and for a boolean label its ``false``.
+          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.
+      bucket_options:
+          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.
+      version:
+          Deprecated. The API version that created or updated this
+          metric. The v2 format is used by default and cannot be
+          changed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.LogMetric)
+    ),
+)
+_sym_db.RegisterMessage(LogMetric)
+_sym_db.RegisterMessage(LogMetric.LabelExtractorsEntry)
+
+ListLogMetricsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListLogMetricsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOGMETRICSREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""The parameters to ListLogMetrics.
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project containing the metrics:  ::
+          "projects/[PROJECT_ID]"
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListLogMetricsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListLogMetricsRequest)
+
+ListLogMetricsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListLogMetricsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOGMETRICSRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""Result returned from ListLogMetrics.
+  
+  
+  Attributes:
+      metrics:
+          A list of logs-based metrics.
+      next_page_token:
+          If there might be more results than appear in this response,
+          then ``nextPageToken`` is included. To get the next set of
+          results, call this method again using the value of
+          ``nextPageToken`` as ``pageToken``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListLogMetricsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListLogMetricsResponse)
+
+GetLogMetricRequest = _reflection.GeneratedProtocolMessageType(
+    "GetLogMetricRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETLOGMETRICREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""The parameters to GetLogMetric.
+  
+  
+  Attributes:
+      metric_name:
+          The resource name of the desired metric:  ::
+          "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.GetLogMetricRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetLogMetricRequest)
+
+CreateLogMetricRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateLogMetricRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATELOGMETRICREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""The parameters to CreateLogMetric.
+  
+  
+  Attributes:
+      parent:
+          The resource name of the project in which to create the
+          metric:  ::      "projects/[PROJECT_ID]"  The new metric must
+          be provided in the request.
+      metric:
+          The new logs-based metric, which must not have an identifier
+          that already exists.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.CreateLogMetricRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateLogMetricRequest)
+
+UpdateLogMetricRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateLogMetricRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATELOGMETRICREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""The parameters to UpdateLogMetric.
+  
+  
+  Attributes:
+      metric_name:
+          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.
+      metric:
+          The updated metric.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.UpdateLogMetricRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateLogMetricRequest)
+
+DeleteLogMetricRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteLogMetricRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETELOGMETRICREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_metrics_pb2",
+        __doc__="""The parameters to DeleteLogMetric.
+  
+  
+  Attributes:
+      metric_name:
+          The resource name of the metric to delete:  ::
+          "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.DeleteLogMetricRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteLogMetricRequest)
+
+
+DESCRIPTOR._options = None
+_LOGMETRIC_LABELEXTRACTORSENTRY._options = None
+_LOGMETRIC.fields_by_name["version"]._options = None
+
+_METRICSSERVICEV2 = _descriptor.ServiceDescriptor(
+    name="MetricsServiceV2",
+    full_name="google.logging.v2.MetricsServiceV2",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1143,
+    serialized_end=1867,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListLogMetrics",
+            full_name="google.logging.v2.MetricsServiceV2.ListLogMetrics",
+            index=0,
+            containing_service=None,
+            input_type=_LISTLOGMETRICSREQUEST,
+            output_type=_LISTLOGMETRICSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v2/{parent=projects/*}/metrics"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetLogMetric",
+            full_name="google.logging.v2.MetricsServiceV2.GetLogMetric",
+            index=1,
+            containing_service=None,
+            input_type=_GETLOGMETRICREQUEST,
+            output_type=_LOGMETRIC,
+            serialized_options=_b(
+                "\202\323\344\223\002(\022&/v2/{metric_name=projects/*/metrics/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateLogMetric",
+            full_name="google.logging.v2.MetricsServiceV2.CreateLogMetric",
+            index=2,
+            containing_service=None,
+            input_type=_CREATELOGMETRICREQUEST,
+            output_type=_LOGMETRIC,
+            serialized_options=_b(
+                '\202\323\344\223\002)"\037/v2/{parent=projects/*}/metrics:\006metric'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateLogMetric",
+            full_name="google.logging.v2.MetricsServiceV2.UpdateLogMetric",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATELOGMETRICREQUEST,
+            output_type=_LOGMETRIC,
+            serialized_options=_b(
+                "\202\323\344\223\0020\032&/v2/{metric_name=projects/*/metrics/*}:\006metric"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteLogMetric",
+            full_name="google.logging.v2.MetricsServiceV2.DeleteLogMetric",
+            index=4,
+            containing_service=None,
+            input_type=_DELETELOGMETRICREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002(*&/v2/{metric_name=projects/*/metrics/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_METRICSSERVICEV2)
+
+DESCRIPTOR.services_by_name["MetricsServiceV2"] = _METRICSSERVICEV2
+
+# @@protoc_insertion_point(module_scope)
diff --git a/logging/google/cloud/logging_v2/proto/logging_metrics_pb2_grpc.py b/logging/google/cloud/logging_v2/proto/logging_metrics_pb2_grpc.py
new file mode 100644
index 000000000000..09f84e038a1b
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_metrics_pb2_grpc.py
@@ -0,0 +1,118 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.logging_v2.proto import (
+    logging_metrics_pb2 as google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class MetricsServiceV2Stub(object):
+    """Service for configuring logs-based metrics.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListLogMetrics = channel.unary_unary(
+            "/google.logging.v2.MetricsServiceV2/ListLogMetrics",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.ListLogMetricsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.ListLogMetricsResponse.FromString,
+        )
+        self.GetLogMetric = channel.unary_unary(
+            "/google.logging.v2.MetricsServiceV2/GetLogMetric",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.GetLogMetricRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.LogMetric.FromString,
+        )
+        self.CreateLogMetric = channel.unary_unary(
+            "/google.logging.v2.MetricsServiceV2/CreateLogMetric",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.CreateLogMetricRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.LogMetric.FromString,
+        )
+        self.UpdateLogMetric = channel.unary_unary(
+            "/google.logging.v2.MetricsServiceV2/UpdateLogMetric",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.UpdateLogMetricRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.LogMetric.FromString,
+        )
+        self.DeleteLogMetric = channel.unary_unary(
+            "/google.logging.v2.MetricsServiceV2/DeleteLogMetric",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.DeleteLogMetricRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class MetricsServiceV2Servicer(object):
+    """Service for configuring logs-based metrics.
+  """
+
+    def ListLogMetrics(self, request, context):
+        """Lists logs-based metrics.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetLogMetric(self, request, context):
+        """Gets a logs-based metric.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateLogMetric(self, request, context):
+        """Creates a logs-based metric.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateLogMetric(self, request, context):
+        """Creates or updates a logs-based metric.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteLogMetric(self, request, context):
+        """Deletes a logs-based metric.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_MetricsServiceV2Servicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListLogMetrics": grpc.unary_unary_rpc_method_handler(
+            servicer.ListLogMetrics,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.ListLogMetricsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.ListLogMetricsResponse.SerializeToString,
+        ),
+        "GetLogMetric": grpc.unary_unary_rpc_method_handler(
+            servicer.GetLogMetric,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.GetLogMetricRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.LogMetric.SerializeToString,
+        ),
+        "CreateLogMetric": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateLogMetric,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.CreateLogMetricRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.LogMetric.SerializeToString,
+        ),
+        "UpdateLogMetric": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateLogMetric,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.UpdateLogMetricRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.LogMetric.SerializeToString,
+        ),
+        "DeleteLogMetric": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteLogMetric,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__metrics__pb2.DeleteLogMetricRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.logging.v2.MetricsServiceV2", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/logging/google/cloud/logging_v2/proto/logging_pb2.py b/logging/google/cloud/logging_v2/proto/logging_pb2.py
new file mode 100644
index 000000000000..2438534d754b
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_pb2.py
@@ -0,0 +1,1307 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/logging_v2/proto/logging.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.cloud.logging_v2.proto import (
+    log_entry_pb2 as google_dot_cloud_dot_logging__v2_dot_proto_dot_log__entry__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/logging_v2/proto/logging.proto",
+    package="google.logging.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.logging.v2B\014LoggingProtoP\001Z8google.golang.org/genproto/googleapis/logging/v2;logging\370\001\001\252\002\027Google.Cloud.Logging.V2\312\002\027Google\\Cloud\\Logging\\V2"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/logging_v2/proto/logging.proto\x12\x11google.logging.v2\x1a\x1cgoogle/api/annotations.proto\x1a#google/api/monitored_resource.proto\x1a-google/cloud/logging_v2/proto/log_entry.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"$\n\x10\x44\x65leteLogRequest\x12\x10\n\x08log_name\x18\x01 \x01(\t"\xa9\x02\n\x16WriteLogEntriesRequest\x12\x10\n\x08log_name\x18\x01 \x01(\t\x12/\n\x08resource\x18\x02 \x01(\x0b\x32\x1d.google.api.MonitoredResource\x12\x45\n\x06labels\x18\x03 \x03(\x0b\x32\x35.google.logging.v2.WriteLogEntriesRequest.LabelsEntry\x12,\n\x07\x65ntries\x18\x04 \x03(\x0b\x32\x1b.google.logging.v2.LogEntry\x12\x17\n\x0fpartial_success\x18\x05 \x01(\x08\x12\x0f\n\x07\x64ry_run\x18\x06 \x01(\x08\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x19\n\x17WriteLogEntriesResponse"\xc8\x01\n\x1cWriteLogEntriesPartialErrors\x12]\n\x10log_entry_errors\x18\x01 \x03(\x0b\x32\x43.google.logging.v2.WriteLogEntriesPartialErrors.LogEntryErrorsEntry\x1aI\n\x13LogEntryErrorsEntry\x12\x0b\n\x03key\x18\x01 \x01(\x05\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status:\x02\x38\x01"\x91\x01\n\x15ListLogEntriesRequest\x12\x17\n\x0bproject_ids\x18\x01 \x03(\tB\x02\x18\x01\x12\x16\n\x0eresource_names\x18\x08 \x03(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08order_by\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t"_\n\x16ListLogEntriesResponse\x12,\n\x07\x65ntries\x18\x01 \x03(\x0b\x32\x1b.google.logging.v2.LogEntry\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"P\n\'ListMonitoredResourceDescriptorsRequest\x12\x11\n\tpage_size\x18\x01 \x01(\x05\x12\x12\n\npage_token\x18\x02 \x01(\t"\x8a\x01\n(ListMonitoredResourceDescriptorsResponse\x12\x45\n\x14resource_descriptors\x18\x01 \x03(\x0b\x32\'.google.api.MonitoredResourceDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fListLogsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t">\n\x10ListLogsResponse\x12\x11\n\tlog_names\x18\x03 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xd8\x07\n\x10LoggingServiceV2\x12\xeb\x01\n\tDeleteLog\x12#.google.logging.v2.DeleteLogRequest\x1a\x16.google.protobuf.Empty"\xa0\x01\x82\xd3\xe4\x93\x02\x99\x01* /v2/{log_name=projects/*/logs/*}Z\'*%/v2/{log_name=organizations/*/logs/*}Z!*\x1f/v2/{log_name=folders/*/logs/*}Z)*\'/v2/{log_name=billingAccounts/*/logs/*}\x12\x86\x01\n\x0fWriteLogEntries\x12).google.logging.v2.WriteLogEntriesRequest\x1a*.google.logging.v2.WriteLogEntriesResponse"\x1c\x82\xd3\xe4\x93\x02\x16"\x11/v2/entries:write:\x01*\x12\x82\x01\n\x0eListLogEntries\x12(.google.logging.v2.ListLogEntriesRequest\x1a).google.logging.v2.ListLogEntriesResponse"\x1b\x82\xd3\xe4\x93\x02\x15"\x10/v2/entries:list:\x01*\x12\xc5\x01\n ListMonitoredResourceDescriptors\x12:.google.logging.v2.ListMonitoredResourceDescriptorsRequest\x1a;.google.logging.v2.ListMonitoredResourceDescriptorsResponse"(\x82\xd3\xe4\x93\x02"\x12 /v2/monitoredResourceDescriptors\x12\xff\x01\n\x08ListLogs\x12".google.logging.v2.ListLogsRequest\x1a#.google.logging.v2.ListLogsResponse"\xa9\x01\x82\xd3\xe4\x93\x02\xa2\x01\x12\x15/v2/{parent=*/*}/logsZ\x1e\x12\x1c/v2/{parent=projects/*}/logsZ#\x12!/v2/{parent=organizations/*}/logsZ\x1d\x12\x1b/v2/{parent=folders/*}/logsZ%\x12#/v2/{parent=billingAccounts/*}/logsB\x98\x01\n\x15\x63om.google.logging.v2B\x0cLoggingProtoP\x01Z8google.golang.org/genproto/googleapis/logging/v2;logging\xf8\x01\x01\xaa\x02\x17Google.Cloud.Logging.V2\xca\x02\x17Google\\Cloud\\Logging\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_logging__v2_dot_proto_dot_log__entry__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DELETELOGREQUEST = _descriptor.Descriptor(
+    name="DeleteLogRequest",
+    full_name="google.logging.v2.DeleteLogRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="log_name",
+            full_name="google.logging.v2.DeleteLogRequest.log_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=299,
+    serialized_end=335,
+)
+
+
+_WRITELOGENTRIESREQUEST_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.logging.v2.WriteLogEntriesRequest.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.logging.v2.WriteLogEntriesRequest.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.logging.v2.WriteLogEntriesRequest.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=590,
+    serialized_end=635,
+)
+
+_WRITELOGENTRIESREQUEST = _descriptor.Descriptor(
+    name="WriteLogEntriesRequest",
+    full_name="google.logging.v2.WriteLogEntriesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="log_name",
+            full_name="google.logging.v2.WriteLogEntriesRequest.log_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource",
+            full_name="google.logging.v2.WriteLogEntriesRequest.resource",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.logging.v2.WriteLogEntriesRequest.labels",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.logging.v2.WriteLogEntriesRequest.entries",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_success",
+            full_name="google.logging.v2.WriteLogEntriesRequest.partial_success",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dry_run",
+            full_name="google.logging.v2.WriteLogEntriesRequest.dry_run",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_WRITELOGENTRIESREQUEST_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=338,
+    serialized_end=635,
+)
+
+
+_WRITELOGENTRIESRESPONSE = _descriptor.Descriptor(
+    name="WriteLogEntriesResponse",
+    full_name="google.logging.v2.WriteLogEntriesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=637,
+    serialized_end=662,
+)
+
+
+_WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY = _descriptor.Descriptor(
+    name="LogEntryErrorsEntry",
+    full_name="google.logging.v2.WriteLogEntriesPartialErrors.LogEntryErrorsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.logging.v2.WriteLogEntriesPartialErrors.LogEntryErrorsEntry.key",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.logging.v2.WriteLogEntriesPartialErrors.LogEntryErrorsEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=792,
+    serialized_end=865,
+)
+
+_WRITELOGENTRIESPARTIALERRORS = _descriptor.Descriptor(
+    name="WriteLogEntriesPartialErrors",
+    full_name="google.logging.v2.WriteLogEntriesPartialErrors",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="log_entry_errors",
+            full_name="google.logging.v2.WriteLogEntriesPartialErrors.log_entry_errors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=665,
+    serialized_end=865,
+)
+
+
+_LISTLOGENTRIESREQUEST = _descriptor.Descriptor(
+    name="ListLogEntriesRequest",
+    full_name="google.logging.v2.ListLogEntriesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_ids",
+            full_name="google.logging.v2.ListLogEntriesRequest.project_ids",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_names",
+            full_name="google.logging.v2.ListLogEntriesRequest.resource_names",
+            index=1,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.logging.v2.ListLogEntriesRequest.filter",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.logging.v2.ListLogEntriesRequest.order_by",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.logging.v2.ListLogEntriesRequest.page_size",
+            index=4,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.logging.v2.ListLogEntriesRequest.page_token",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=868,
+    serialized_end=1013,
+)
+
+
+_LISTLOGENTRIESRESPONSE = _descriptor.Descriptor(
+    name="ListLogEntriesResponse",
+    full_name="google.logging.v2.ListLogEntriesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.logging.v2.ListLogEntriesResponse.entries",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.logging.v2.ListLogEntriesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1015,
+    serialized_end=1110,
+)
+
+
+_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST = _descriptor.Descriptor(
+    name="ListMonitoredResourceDescriptorsRequest",
+    full_name="google.logging.v2.ListMonitoredResourceDescriptorsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.logging.v2.ListMonitoredResourceDescriptorsRequest.page_size",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.logging.v2.ListMonitoredResourceDescriptorsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1112,
+    serialized_end=1192,
+)
+
+
+_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE = _descriptor.Descriptor(
+    name="ListMonitoredResourceDescriptorsResponse",
+    full_name="google.logging.v2.ListMonitoredResourceDescriptorsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_descriptors",
+            full_name="google.logging.v2.ListMonitoredResourceDescriptorsResponse.resource_descriptors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.logging.v2.ListMonitoredResourceDescriptorsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1195,
+    serialized_end=1333,
+)
+
+
+_LISTLOGSREQUEST = _descriptor.Descriptor(
+    name="ListLogsRequest",
+    full_name="google.logging.v2.ListLogsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.logging.v2.ListLogsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.logging.v2.ListLogsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.logging.v2.ListLogsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1335,
+    serialized_end=1407,
+)
+
+
+_LISTLOGSRESPONSE = _descriptor.Descriptor(
+    name="ListLogsResponse",
+    full_name="google.logging.v2.ListLogsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="log_names",
+            full_name="google.logging.v2.ListLogsResponse.log_names",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.logging.v2.ListLogsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1409,
+    serialized_end=1471,
+)
+
+_WRITELOGENTRIESREQUEST_LABELSENTRY.containing_type = _WRITELOGENTRIESREQUEST
+_WRITELOGENTRIESREQUEST.fields_by_name[
+    "resource"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCE
+_WRITELOGENTRIESREQUEST.fields_by_name[
+    "labels"
+].message_type = _WRITELOGENTRIESREQUEST_LABELSENTRY
+_WRITELOGENTRIESREQUEST.fields_by_name[
+    "entries"
+].message_type = (
+    google_dot_cloud_dot_logging__v2_dot_proto_dot_log__entry__pb2._LOGENTRY
+)
+_WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY.containing_type = (
+    _WRITELOGENTRIESPARTIALERRORS
+)
+_WRITELOGENTRIESPARTIALERRORS.fields_by_name[
+    "log_entry_errors"
+].message_type = _WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY
+_LISTLOGENTRIESRESPONSE.fields_by_name[
+    "entries"
+].message_type = (
+    google_dot_cloud_dot_logging__v2_dot_proto_dot_log__entry__pb2._LOGENTRY
+)
+_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE.fields_by_name[
+    "resource_descriptors"
+].message_type = (
+    google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCEDESCRIPTOR
+)
+DESCRIPTOR.message_types_by_name["DeleteLogRequest"] = _DELETELOGREQUEST
+DESCRIPTOR.message_types_by_name["WriteLogEntriesRequest"] = _WRITELOGENTRIESREQUEST
+DESCRIPTOR.message_types_by_name["WriteLogEntriesResponse"] = _WRITELOGENTRIESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "WriteLogEntriesPartialErrors"
+] = _WRITELOGENTRIESPARTIALERRORS
+DESCRIPTOR.message_types_by_name["ListLogEntriesRequest"] = _LISTLOGENTRIESREQUEST
+DESCRIPTOR.message_types_by_name["ListLogEntriesResponse"] = _LISTLOGENTRIESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ListMonitoredResourceDescriptorsRequest"
+] = _LISTMONITOREDRESOURCEDESCRIPTORSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListMonitoredResourceDescriptorsResponse"
+] = _LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE
+DESCRIPTOR.message_types_by_name["ListLogsRequest"] = _LISTLOGSREQUEST
+DESCRIPTOR.message_types_by_name["ListLogsResponse"] = _LISTLOGSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DeleteLogRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteLogRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETELOGREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""The parameters to DeleteLog.
+  
+  
+  Attributes:
+      log_name:
+          Required. The resource name of the log to delete:  ::
+          "projects/[PROJECT_ID]/logs/[LOG_ID]"
+          "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+          "folders/[FOLDER_ID]/logs/[LOG_ID]"  ``[LOG_ID]`` must be URL-
+          encoded. For example, ``"projects/my-project-
+          id/logs/syslog"``, ``"organizations/1234567890/logs/cloudresou
+          rcemanager.googleapis.com%2Factivity"``. For more information
+          about log names, see [LogEntry][google.logging.v2.LogEntry].
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.DeleteLogRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteLogRequest)
+
+WriteLogEntriesRequest = _reflection.GeneratedProtocolMessageType(
+    "WriteLogEntriesRequest",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WRITELOGENTRIESREQUEST_LABELSENTRY,
+                __module__="google.cloud.logging_v2.proto.logging_pb2"
+                # @@protoc_insertion_point(class_scope:google.logging.v2.WriteLogEntriesRequest.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_WRITELOGENTRIESREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""The parameters to WriteLogEntries.
+  
+  
+  Attributes:
+      log_name:
+          Optional. A default log resource name that is assigned to all
+          log entries in ``entries`` that do not specify a value for
+          ``log_name``:  ::      "projects/[PROJECT_ID]/logs/[LOG_ID]"
+          "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+          "folders/[FOLDER_ID]/logs/[LOG_ID]"  ``[LOG_ID]`` must be URL-
+          encoded. For example:  ::      "projects/my-project-
+          id/logs/syslog"     "organizations/1234567890/logs/cloudresour
+          cemanager.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.
+      resource:
+          Optional. A default monitored resource object that is assigned
+          to all log entries in ``entries`` that do not specify a value
+          for ``resource``. Example:  ::      { "type": "gce_instance",
+          "labels": {         "zone": "us-central1-a", "instance_id":
+          "00000000000000000000" }}  See
+          [LogEntry][google.logging.v2.LogEntry].
+      labels:
+          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].
+      entries:
+          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 ``log_name``, ``resource``, and ``labels`` fields are
+          copied into those log entries in this list that do not include
+          values for their corresponding fields. For more information,
+          see the [LogEntry][google.logging.v2.LogEntry] type.  If the
+          ``timestamp`` or ``insert_id`` fields are missing in log
+          entries, then this method supplies the current time or a
+          unique identifier, respectively. The supplied values are
+          chosen so that, among the log entries that did not supply
+          their own values, the entries earlier in the list will sort
+          before 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 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>`__.  To improve throughput and to avoid exceeding the
+          `quota limit </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.
+      partial_success:
+          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.
+      dry_run:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.WriteLogEntriesRequest)
+    ),
+)
+_sym_db.RegisterMessage(WriteLogEntriesRequest)
+_sym_db.RegisterMessage(WriteLogEntriesRequest.LabelsEntry)
+
+WriteLogEntriesResponse = _reflection.GeneratedProtocolMessageType(
+    "WriteLogEntriesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WRITELOGENTRIESRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""Result returned from WriteLogEntries. empty
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.WriteLogEntriesResponse)
+    ),
+)
+_sym_db.RegisterMessage(WriteLogEntriesResponse)
+
+WriteLogEntriesPartialErrors = _reflection.GeneratedProtocolMessageType(
+    "WriteLogEntriesPartialErrors",
+    (_message.Message,),
+    dict(
+        LogEntryErrorsEntry=_reflection.GeneratedProtocolMessageType(
+            "LogEntryErrorsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY,
+                __module__="google.cloud.logging_v2.proto.logging_pb2"
+                # @@protoc_insertion_point(class_scope:google.logging.v2.WriteLogEntriesPartialErrors.LogEntryErrorsEntry)
+            ),
+        ),
+        DESCRIPTOR=_WRITELOGENTRIESPARTIALERRORS,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""Error details for WriteLogEntries with partial success.
+  
+  
+  Attributes:
+      log_entry_errors:
+          When ``WriteLogEntriesRequest.partial_success`` is true,
+          records the error status for entries that were not written due
+          to a permanent error, keyed by the entry's zero-based index in
+          ``WriteLogEntriesRequest.entries``.  Failed requests for which
+          no entries are written will not include per-entry errors.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.WriteLogEntriesPartialErrors)
+    ),
+)
+_sym_db.RegisterMessage(WriteLogEntriesPartialErrors)
+_sym_db.RegisterMessage(WriteLogEntriesPartialErrors.LogEntryErrorsEntry)
+
+ListLogEntriesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListLogEntriesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOGENTRIESREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""The parameters to ``ListLogEntries``.
+  
+  
+  Attributes:
+      project_ids:
+          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``.
+      resource_names:
+          Required. Names of one or more parent resources from which to
+          retrieve log entries:  ::      "projects/[PROJECT_ID]"
+          "organizations/[ORGANIZATION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]"
+          "folders/[FOLDER_ID]"  Projects listed in the ``project_ids``
+          field are added to this list.
+      filter:
+          Optional. A filter that chooses which log entries to return.
+          See `Advanced Logs Filters
+          </logging/docs/view/advanced_filters>`__. 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.
+      order_by:
+          Optional. How the results should be sorted. Presently, the
+          only permitted values are ``"timestamp asc"`` (default) and
+          ``"timestamp desc"``. The first option returns entries in
+          order of increasing values of ``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.
+      page_size:
+          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.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListLogEntriesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListLogEntriesRequest)
+
+ListLogEntriesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListLogEntriesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOGENTRIESRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""Result returned from ``ListLogEntries``.
+  
+  
+  Attributes:
+      entries:
+          A list of log entries. If ``entries`` is empty,
+          ``nextPageToken`` may still be returned, indicating that more
+          entries may exist. See ``nextPageToken`` for more information.
+      next_page_token:
+          If there might be more results than those appearing in this
+          response, then ``nextPageToken`` is included. To get the next
+          set of results, call this method again using the value of
+          ``nextPageToken`` as ``pageToken``.  If a value for
+          ``next_page_token`` appears and the ``entries`` field is
+          empty, it means that the search found no log entries so far
+          but it did not have time to search all the possible log
+          entries. Retry the method with this value for ``page_token``
+          to continue the search. Alternatively, consider speeding up
+          the search by changing your filter to specify a single log
+          name or resource type, or to narrow the time range of the
+          search.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListLogEntriesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListLogEntriesResponse)
+
+ListMonitoredResourceDescriptorsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListMonitoredResourceDescriptorsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""The parameters to ListMonitoredResourceDescriptors
+  
+  
+  Attributes:
+      page_size:
+          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.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListMonitoredResourceDescriptorsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListMonitoredResourceDescriptorsRequest)
+
+ListMonitoredResourceDescriptorsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListMonitoredResourceDescriptorsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""Result returned from ListMonitoredResourceDescriptors.
+  
+  
+  Attributes:
+      resource_descriptors:
+          A list of resource descriptors.
+      next_page_token:
+          If there might be more results than those appearing in this
+          response, then ``nextPageToken`` is included. To get the next
+          set of results, call this method again using the value of
+          ``nextPageToken`` as ``pageToken``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListMonitoredResourceDescriptorsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListMonitoredResourceDescriptorsResponse)
+
+ListLogsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListLogsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOGSREQUEST,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""The parameters to ListLogs.
+  
+  
+  Attributes:
+      parent:
+          Required. The resource name that owns the logs:  ::
+          "projects/[PROJECT_ID]"     "organizations/[ORGANIZATION_ID]"
+          "billingAccounts/[BILLING_ACCOUNT_ID]"
+          "folders/[FOLDER_ID]"
+      page_size:
+          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.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListLogsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListLogsRequest)
+
+ListLogsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListLogsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTLOGSRESPONSE,
+        __module__="google.cloud.logging_v2.proto.logging_pb2",
+        __doc__="""Result returned from ListLogs.
+  
+  
+  Attributes:
+      log_names:
+          A list of log names. For example, ``"projects/my-
+          project/syslog"`` or ``"organizations/123/cloudresourcemanager
+          .googleapis.com%2Factivity"``.
+      next_page_token:
+          If there might be more results than those appearing in this
+          response, then ``nextPageToken`` is included. To get the next
+          set of results, call this method again using the value of
+          ``nextPageToken`` as ``pageToken``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.logging.v2.ListLogsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListLogsResponse)
+
+
+DESCRIPTOR._options = None
+_WRITELOGENTRIESREQUEST_LABELSENTRY._options = None
+_WRITELOGENTRIESPARTIALERRORS_LOGENTRYERRORSENTRY._options = None
+_LISTLOGENTRIESREQUEST.fields_by_name["project_ids"]._options = None
+
+_LOGGINGSERVICEV2 = _descriptor.ServiceDescriptor(
+    name="LoggingServiceV2",
+    full_name="google.logging.v2.LoggingServiceV2",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1474,
+    serialized_end=2458,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="DeleteLog",
+            full_name="google.logging.v2.LoggingServiceV2.DeleteLog",
+            index=0,
+            containing_service=None,
+            input_type=_DELETELOGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\231\001* /v2/{log_name=projects/*/logs/*}Z'*%/v2/{log_name=organizations/*/logs/*}Z!*\037/v2/{log_name=folders/*/logs/*}Z)*'/v2/{log_name=billingAccounts/*/logs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="WriteLogEntries",
+            full_name="google.logging.v2.LoggingServiceV2.WriteLogEntries",
+            index=1,
+            containing_service=None,
+            input_type=_WRITELOGENTRIESREQUEST,
+            output_type=_WRITELOGENTRIESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\026"\021/v2/entries:write:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListLogEntries",
+            full_name="google.logging.v2.LoggingServiceV2.ListLogEntries",
+            index=2,
+            containing_service=None,
+            input_type=_LISTLOGENTRIESREQUEST,
+            output_type=_LISTLOGENTRIESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\025"\020/v2/entries:list:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListMonitoredResourceDescriptors",
+            full_name="google.logging.v2.LoggingServiceV2.ListMonitoredResourceDescriptors",
+            index=3,
+            containing_service=None,
+            input_type=_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST,
+            output_type=_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002"\022 /v2/monitoredResourceDescriptors'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListLogs",
+            full_name="google.logging.v2.LoggingServiceV2.ListLogs",
+            index=4,
+            containing_service=None,
+            input_type=_LISTLOGSREQUEST,
+            output_type=_LISTLOGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\242\001\022\025/v2/{parent=*/*}/logsZ\036\022\034/v2/{parent=projects/*}/logsZ#\022!/v2/{parent=organizations/*}/logsZ\035\022\033/v2/{parent=folders/*}/logsZ%\022#/v2/{parent=billingAccounts/*}/logs"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_LOGGINGSERVICEV2)
+
+DESCRIPTOR.services_by_name["LoggingServiceV2"] = _LOGGINGSERVICEV2
+
+# @@protoc_insertion_point(module_scope)
diff --git a/logging/google/cloud/logging_v2/proto/logging_pb2_grpc.py b/logging/google/cloud/logging_v2/proto/logging_pb2_grpc.py
new file mode 100644
index 000000000000..d67dd2c95fd0
--- /dev/null
+++ b/logging/google/cloud/logging_v2/proto/logging_pb2_grpc.py
@@ -0,0 +1,130 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.logging_v2.proto import (
+    logging_pb2 as google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class LoggingServiceV2Stub(object):
+    """Service for ingesting and querying logs.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.DeleteLog = channel.unary_unary(
+            "/google.logging.v2.LoggingServiceV2/DeleteLog",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.DeleteLogRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.WriteLogEntries = channel.unary_unary(
+            "/google.logging.v2.LoggingServiceV2/WriteLogEntries",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.WriteLogEntriesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.WriteLogEntriesResponse.FromString,
+        )
+        self.ListLogEntries = channel.unary_unary(
+            "/google.logging.v2.LoggingServiceV2/ListLogEntries",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogEntriesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogEntriesResponse.FromString,
+        )
+        self.ListMonitoredResourceDescriptors = channel.unary_unary(
+            "/google.logging.v2.LoggingServiceV2/ListMonitoredResourceDescriptors",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListMonitoredResourceDescriptorsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListMonitoredResourceDescriptorsResponse.FromString,
+        )
+        self.ListLogs = channel.unary_unary(
+            "/google.logging.v2.LoggingServiceV2/ListLogs",
+            request_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogsResponse.FromString,
+        )
+
+
+class LoggingServiceV2Servicer(object):
+    """Service for ingesting and querying logs.
+  """
+
+    def DeleteLog(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def WriteLogEntries(self, request, context):
+        """Writes log entries to Logging. This API method is the
+    only way to send log entries to Logging. This method
+    is used, directly or indirectly, by the Logging agent
+    (fluentd) and all logging libraries configured to use Logging.
+    A single request may contain log entries for a maximum of 1000
+    different resources (projects, organizations, billing accounts or
+    folders)
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListLogEntries(self, request, context):
+        """Lists log entries.  Use this method to retrieve log entries from
+    Logging.  For ways to export log entries, see
+    [Exporting Logs](/logging/docs/export).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListMonitoredResourceDescriptors(self, request, context):
+        """Lists the descriptors for monitored resource types used by Logging.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListLogs(self, request, context):
+        """Lists the logs in projects, organizations, folders, or billing accounts.
+    Only logs that have entries are listed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_LoggingServiceV2Servicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "DeleteLog": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteLog,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.DeleteLogRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "WriteLogEntries": grpc.unary_unary_rpc_method_handler(
+            servicer.WriteLogEntries,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.WriteLogEntriesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.WriteLogEntriesResponse.SerializeToString,
+        ),
+        "ListLogEntries": grpc.unary_unary_rpc_method_handler(
+            servicer.ListLogEntries,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogEntriesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogEntriesResponse.SerializeToString,
+        ),
+        "ListMonitoredResourceDescriptors": grpc.unary_unary_rpc_method_handler(
+            servicer.ListMonitoredResourceDescriptors,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListMonitoredResourceDescriptorsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListMonitoredResourceDescriptorsResponse.SerializeToString,
+        ),
+        "ListLogs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListLogs,
+            request_deserializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_logging__v2_dot_proto_dot_logging__pb2.ListLogsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.logging.v2.LoggingServiceV2", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/logging/google/cloud/logging_v2/types.py b/logging/google/cloud/logging_v2/types.py
new file mode 100644
index 000000000000..464edbe709dc
--- /dev/null
+++ b/logging/google/cloud/logging_v2/types.py
@@ -0,0 +1,72 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import distribution_pb2
+from google.api import http_pb2
+from google.api import label_pb2
+from google.api import metric_pb2
+from google.api import monitored_resource_pb2
+from google.logging.type import http_request_pb2
+from google.protobuf import any_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_config_pb2
+from google.cloud.logging_v2.proto import logging_metrics_pb2
+from google.cloud.logging_v2.proto import logging_pb2
+
+
+_shared_modules = [
+    distribution_pb2,
+    http_pb2,
+    label_pb2,
+    metric_pb2,
+    monitored_resource_pb2,
+    http_request_pb2,
+    any_pb2,
+    descriptor_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [log_entry_pb2, logging_config_pb2, logging_metrics_pb2, logging_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.logging_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/logging/noxfile.py b/logging/noxfile.py
new file mode 100644
index 000000000000..d2a53d2de4fb
--- /dev/null
+++ b/logging/noxfile.py
@@ -0,0 +1,189 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import os
+import shutil
+import sys
+
+import nox
+
+
+LOCAL_DEPS = (
+    os.path.join('..', 'api_core'),
+    os.path.join('..', 'core'),
+)
+UNIT_TEST_DEPS = (
+    'mock',
+    'pytest',
+    'pytest-cov',
+    'flask',
+    'webapp2',
+    'webob',
+)
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session, django_dep=('django',)):
+    """Default unit test session.
+    """
+
+    # Install all test dependencies, then install this package in-place.
+    deps = UNIT_TEST_DEPS
+    deps += django_dep
+
+    session.install(*deps)
+    for local_dep in LOCAL_DEPS:
+        session.install('-e', local_dep)
+    session.install('-e', '.')
+
+    # Run py.test against the unit tests.
+    session.run(
+        'py.test',
+        '--quiet',
+        '--cov=google.cloud.logging',
+        '--cov=tests.unit',
+        '--cov-append',
+        '--cov-config=.coveragerc',
+        '--cov-report=',
+        '--cov-fail-under=97',
+        'tests/unit',
+        *session.posargs
+    )
+
+
+@nox.session(python=['2.7', '3.5', '3.6', '3.7'])
+def unit(session):
+    """Run the unit test suite."""
+
+    # Testing multiple version of django
+    # See https://www.djangoproject.com/download/ for supported version
+    django_deps_27 = [
+        ('django==1.8.19',),
+        ('django >= 1.11.0, < 2.0.0dev',),
+    ]
+
+    if session.virtualenv.interpreter == '2.7':
+        [default(session, django_dep=django) for django in django_deps_27]
+    else:
+        default(session)
+
+
+@nox.session(python=['2.7', '3.6'])
+def system(session):
+    """Run the system test suite."""
+
+    # Sanity check: Only run system tests if the environment variable is set.
+    if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
+        session.skip('Credentials must be set via environment variable.')
+
+    # Use pre-release gRPC for system tests.
+    session.install('--pre', 'grpcio')
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install('mock', 'pytest')
+    for local_dep in LOCAL_DEPS:
+        session.install('-e', local_dep)
+    systest_deps = [
+        '../bigquery/',
+        '../pubsub/',
+        '../storage/',
+        '../test_utils/',
+    ]
+    for systest_dep in systest_deps:
+        session.install('-e', systest_dep)
+    session.install('-e', '.')
+
+    # Run py.test against the system tests.
+    session.run(
+        'py.test',
+        '-vvv',
+        '-s',
+        'tests/system',
+        *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
\ No newline at end of file
diff --git a/logging/pylint.config.py b/logging/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/logging/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/logging/setup.cfg b/logging/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/logging/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/logging/setup.py b/logging/setup.py
new file mode 100644
index 000000000000..6d3da8a110f9
--- /dev/null
+++ b/logging/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-logging'
+description = 'Stackdriver Logging API client library'
+version = '1.12.1'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 5 - Production/Stable'
+dependencies = [
+    'google-api-core[grpc] >= 1.14.0, < 2.0.0dev',
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/googleapis/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/logging/synth.metadata b/logging/synth.metadata
new file mode 100644
index 000000000000..8d3384c18458
--- /dev/null
+++ b/logging/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-05T19:11:10.264038Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "f94d89f4b75b4bdf6a254da44eb0f70d34bcca14",
+        "internalRef": "261701508"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "logging",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/logging/artman_logging.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/logging/synth.py b/logging/synth.py
new file mode 100644
index 000000000000..c24382ce4d72
--- /dev/null
+++ b/logging/synth.py
@@ -0,0 +1,48 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate logging GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "logging",
+    "v2",
+    config_path="/google/logging/artman_logging.yaml",
+    artman_output_name="logging-v2",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/logging_v2/proto")
+s.move(library / "google/cloud/logging_v2/gapic")
+s.move(library / "tests/unit/gapic/v2")
+
+# Issues exist where python files should define the source encoding
+# https://github.com/googleapis/gapic-generator/issues/2097
+s.replace("google/**/proto/*_pb2.py", r"(^.*$\n)*", r"# -*- coding: utf-8 -*-\n\g<0>")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=95, cov_level=100)
+# Don't move noxfile. logging has special testing setups for django, etc
+s.move(templated_files, excludes="noxfile.py")
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/logging/tests/__init__.py b/logging/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/logging/tests/system/gapic/v2/test_system_logging_service_v2_v2.py b/logging/tests/system/gapic/v2/test_system_logging_service_v2_v2.py
new file mode 100644
index 000000000000..d574de7785f7
--- /dev/null
+++ b/logging/tests/system/gapic/v2/test_system_logging_service_v2_v2.py
@@ -0,0 +1,36 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+import google.auth
+from google.api import monitored_resource_pb2
+from google.cloud import logging_v2
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_pb2
+
+
+class TestSystemLoggingServiceV2(object):
+    def test_write_log_entries(self):
+        _, project_id = google.auth.default()
+
+        client = logging_v2.LoggingServiceV2Client()
+        log_name = client.log_path(project_id, "test-{0}".format(time.time()))
+        resource = {}
+        labels = {}
+        entries = []
+        response = client.write_log_entries(
+            entries, log_name=log_name, resource=resource, labels=labels
+        )
diff --git a/logging/tests/system/test_system.py b/logging/tests/system/test_system.py
new file mode 100644
index 000000000000..8e2d694081a1
--- /dev/null
+++ b/logging/tests/system/test_system.py
@@ -0,0 +1,538 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import logging
+import unittest
+
+from google.api_core.exceptions import BadGateway
+from google.api_core.exceptions import Conflict
+from google.api_core.exceptions import NotFound
+from google.api_core.exceptions import TooManyRequests
+from google.api_core.exceptions import ResourceExhausted
+from google.api_core.exceptions import RetryError
+from google.api_core.exceptions import ServiceUnavailable
+from google.cloud._helpers import UTC
+import google.cloud.logging
+import google.cloud.logging.handlers.handlers
+from google.cloud.logging.handlers.handlers import CloudLoggingHandler
+from google.cloud.logging.handlers.transports import SyncTransport
+from google.cloud.logging import client
+from google.cloud.logging.resource import Resource
+
+from test_utils.retry import RetryErrors
+from test_utils.retry import RetryResult
+from test_utils.system import unique_resource_id
+
+_RESOURCE_ID = unique_resource_id("-")
+DEFAULT_FILTER = "logName:syslog AND severity>=INFO"
+DEFAULT_DESCRIPTION = "System testing"
+retry_429 = RetryErrors(TooManyRequests)
+
+
+def _consume_entries(logger):
+    """Consume all log entries from logger iterator.
+
+    :type logger: :class:`~google.cloud.logging.logger.Logger`
+    :param logger: A Logger containing entries.
+
+    :rtype: list
+    :returns: List of all entries consumed.
+    """
+    return list(logger.list_entries())
+
+
+def _list_entries(logger):
+    """Retry-ing list entries in a logger.
+
+    Retry until there are actual results and retry on any
+    failures.
+
+    :type logger: :class:`~google.cloud.logging.logger.Logger`
+    :param logger: A Logger containing entries.
+
+    :rtype: list
+    :returns: List of all entries consumed.
+    """
+    inner = RetryResult(_has_entries, max_tries=9)(_consume_entries)
+    outer = RetryErrors((ServiceUnavailable, ResourceExhausted), max_tries=9)(inner)
+    return outer(logger)
+
+
+def _has_entries(result):
+    return len(result) > 0
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+
+
+def setUpModule():
+    Config.CLIENT = client.Client()
+
+
+class TestLogging(unittest.TestCase):
+
+    JSON_PAYLOAD = {
+        "message": "System test: test_log_struct",
+        "weather": {
+            "clouds": "party or partly",
+            "temperature": 70,
+            "precipitation": False,
+        },
+    }
+    TYPE_FILTER = 'protoPayload.@type = "{}"'
+
+    def setUp(self):
+        self.to_delete = []
+        self._handlers_cache = logging.getLogger().handlers[:]
+
+    def tearDown(self):
+        retry_not_found = RetryErrors((NotFound), max_tries=4)
+        retry_other = RetryErrors((TooManyRequests, RetryError))
+        for doomed in self.to_delete:
+            try:
+                retry_not_found(retry_other(doomed.delete))()
+            except AttributeError:
+                client, dataset = doomed
+                retry_not_found(retry_other(client.delete_dataset))(dataset)
+            except NotFound:
+                pass
+        logging.getLogger().handlers = self._handlers_cache[:]
+
+    @staticmethod
+    def _logger_name(prefix):
+        return prefix + unique_resource_id("-")
+
+    def test_list_entry_with_unregistered(self):
+        from google.protobuf import any_pb2
+        from google.protobuf import descriptor_pool
+        from google.cloud.logging import entries
+
+        pool = descriptor_pool.Default()
+        type_name = "google.cloud.audit.AuditLog"
+        # Make sure the descriptor is not known in the registry.
+        with self.assertRaises(KeyError):
+            pool.FindMessageTypeByName(type_name)
+
+        type_url = "type.googleapis.com/" + type_name
+        filter_ = self.TYPE_FILTER.format(type_url)
+        entry_iter = iter(Config.CLIENT.list_entries(page_size=1, filter_=filter_))
+
+        retry = RetryErrors(TooManyRequests)
+        protobuf_entry = retry(lambda: next(entry_iter))()
+
+        self.assertIsInstance(protobuf_entry, entries.ProtobufEntry)
+        if Config.CLIENT._use_grpc:
+            self.assertIsNone(protobuf_entry.payload_json)
+            self.assertIsInstance(protobuf_entry.payload_pb, any_pb2.Any)
+            self.assertEqual(protobuf_entry.payload_pb.type_url, type_url)
+        else:
+            self.assertIsNone(protobuf_entry.payload_pb)
+            self.assertEqual(protobuf_entry.payload_json["@type"], type_url)
+
+    def test_log_text(self):
+        TEXT_PAYLOAD = "System test: test_log_text"
+        logger = Config.CLIENT.logger(self._logger_name("log_text"))
+        self.to_delete.append(logger)
+        logger.log_text(TEXT_PAYLOAD)
+        entries = _list_entries(logger)
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, TEXT_PAYLOAD)
+
+    def test_log_text_with_timestamp(self):
+        import datetime
+
+        text_payload = "System test: test_log_text_with_timestamp"
+        logger = Config.CLIENT.logger(self._logger_name("log_text_ts"))
+        now = datetime.datetime.utcnow()
+
+        self.to_delete.append(logger)
+
+        logger.log_text(text_payload, timestamp=now)
+        entries = _list_entries(logger)
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, text_payload)
+        self.assertEqual(entries[0].timestamp, now.replace(tzinfo=UTC))
+        self.assertIsInstance(entries[0].received_timestamp, datetime.datetime)
+
+    def test_log_text_with_resource(self):
+        text_payload = "System test: test_log_text_with_timestamp"
+
+        logger = Config.CLIENT.logger(self._logger_name("log_text_res"))
+        now = datetime.datetime.utcnow()
+        resource = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+
+        self.to_delete.append(logger)
+
+        logger.log_text(text_payload, timestamp=now, resource=resource)
+        entries = _list_entries(logger)
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, text_payload)
+        # project_id is output only so we don't want it in assertion
+        del entries[0].resource.labels["project_id"]
+        self.assertEqual(entries[0].resource, resource)
+
+    def test_log_text_w_metadata(self):
+        TEXT_PAYLOAD = "System test: test_log_text"
+        INSERT_ID = "INSERTID"
+        SEVERITY = "INFO"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = 500
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        logger = Config.CLIENT.logger(self._logger_name("log_text_md"))
+        self.to_delete.append(logger)
+
+        logger.log_text(
+            TEXT_PAYLOAD, insert_id=INSERT_ID, severity=SEVERITY, http_request=REQUEST
+        )
+        entries = _list_entries(logger)
+
+        self.assertEqual(len(entries), 1)
+
+        entry = entries[0]
+        self.assertEqual(entry.payload, TEXT_PAYLOAD)
+        self.assertEqual(entry.insert_id, INSERT_ID)
+        self.assertEqual(entry.severity, SEVERITY)
+
+        request = entry.http_request
+        self.assertEqual(request["requestMethod"], METHOD)
+        self.assertEqual(request["requestUrl"], URI)
+        self.assertEqual(request["status"], STATUS)
+
+    def test_log_struct(self):
+        logger = Config.CLIENT.logger(self._logger_name("log_struct"))
+        self.to_delete.append(logger)
+
+        logger.log_struct(self.JSON_PAYLOAD)
+        entries = _list_entries(logger)
+
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, self.JSON_PAYLOAD)
+
+    def test_log_struct_w_metadata(self):
+        INSERT_ID = "INSERTID"
+        SEVERITY = "INFO"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = 500
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        logger = Config.CLIENT.logger(self._logger_name("log_struct_md"))
+        self.to_delete.append(logger)
+
+        logger.log_struct(
+            self.JSON_PAYLOAD,
+            insert_id=INSERT_ID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+        )
+        entries = _list_entries(logger)
+
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, self.JSON_PAYLOAD)
+        self.assertEqual(entries[0].insert_id, INSERT_ID)
+        self.assertEqual(entries[0].severity, SEVERITY)
+        request = entries[0].http_request
+        self.assertEqual(request["requestMethod"], METHOD)
+        self.assertEqual(request["requestUrl"], URI)
+        self.assertEqual(request["status"], STATUS)
+
+    def test_log_handler_async(self):
+        LOG_MESSAGE = "It was the worst of times"
+
+        handler_name = self._logger_name("handler_async")
+        handler = CloudLoggingHandler(Config.CLIENT, name=handler_name)
+        # only create the logger to delete, hidden otherwise
+        logger = Config.CLIENT.logger(handler_name)
+        self.to_delete.append(logger)
+
+        cloud_logger = logging.getLogger(handler.name)
+        cloud_logger.addHandler(handler)
+        cloud_logger.warn(LOG_MESSAGE)
+        handler.flush()
+        entries = _list_entries(logger)
+        expected_payload = {"message": LOG_MESSAGE, "python_logger": handler.name}
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, expected_payload)
+
+    def test_log_handler_sync(self):
+        LOG_MESSAGE = "It was the best of times."
+
+        handler_name = self._logger_name("handler_sync")
+        handler = CloudLoggingHandler(
+            Config.CLIENT, name=handler_name, transport=SyncTransport
+        )
+
+        # only create the logger to delete, hidden otherwise
+        logger = Config.CLIENT.logger(handler.name)
+        self.to_delete.append(logger)
+
+        LOGGER_NAME = "mylogger"
+        cloud_logger = logging.getLogger(LOGGER_NAME)
+        cloud_logger.addHandler(handler)
+        cloud_logger.warn(LOG_MESSAGE)
+
+        entries = _list_entries(logger)
+        expected_payload = {"message": LOG_MESSAGE, "python_logger": LOGGER_NAME}
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, expected_payload)
+
+    def test_log_root_handler(self):
+        LOG_MESSAGE = "It was the best of times."
+
+        handler = CloudLoggingHandler(
+            Config.CLIENT, name=self._logger_name("handler_root")
+        )
+        # only create the logger to delete, hidden otherwise
+        logger = Config.CLIENT.logger(handler.name)
+        self.to_delete.append(logger)
+
+        google.cloud.logging.handlers.handlers.setup_logging(handler)
+        logging.warn(LOG_MESSAGE)
+
+        entries = _list_entries(logger)
+        expected_payload = {"message": LOG_MESSAGE, "python_logger": "root"}
+
+        self.assertEqual(len(entries), 1)
+        self.assertEqual(entries[0].payload, expected_payload)
+
+    def test_create_metric(self):
+        METRIC_NAME = "test-create-metric%s" % (_RESOURCE_ID,)
+        metric = Config.CLIENT.metric(METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
+        self.assertFalse(metric.exists())
+        retry = RetryErrors(Conflict)
+
+        retry(metric.create)()
+
+        self.to_delete.append(metric)
+        self.assertTrue(metric.exists())
+
+    def test_list_metrics(self):
+        METRIC_NAME = "test-list-metrics%s" % (_RESOURCE_ID,)
+        metric = Config.CLIENT.metric(METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
+        self.assertFalse(metric.exists())
+        before_metrics = list(Config.CLIENT.list_metrics())
+        before_names = set(before.name for before in before_metrics)
+        self.assertFalse(metric.name in before_names)
+        retry = RetryErrors(Conflict)
+        retry(metric.create)()
+        self.to_delete.append(metric)
+        self.assertTrue(metric.exists())
+
+        after_metrics = list(Config.CLIENT.list_metrics())
+
+        after_names = set(after.name for after in after_metrics)
+        self.assertTrue(metric.name in after_names)
+
+    def test_reload_metric(self):
+        METRIC_NAME = "test-reload-metric%s" % (_RESOURCE_ID,)
+        retry = RetryErrors(Conflict)
+        metric = Config.CLIENT.metric(METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
+        self.assertFalse(metric.exists())
+        retry(metric.create)()
+        self.to_delete.append(metric)
+        metric.filter_ = "logName:other"
+        metric.description = "local changes"
+
+        metric.reload()
+
+        self.assertEqual(metric.filter_, DEFAULT_FILTER)
+        self.assertEqual(metric.description, DEFAULT_DESCRIPTION)
+
+    def test_update_metric(self):
+        METRIC_NAME = "test-update-metric%s" % (_RESOURCE_ID,)
+        retry = RetryErrors(Conflict)
+        NEW_FILTER = "logName:other"
+        NEW_DESCRIPTION = "updated"
+        metric = Config.CLIENT.metric(METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
+        self.assertFalse(metric.exists())
+        retry(metric.create)()
+        self.to_delete.append(metric)
+        metric.filter_ = NEW_FILTER
+        metric.description = NEW_DESCRIPTION
+
+        metric.update()
+
+        after_metrics = list(Config.CLIENT.list_metrics())
+        after_info = {metric.name: metric for metric in after_metrics}
+        after = after_info[METRIC_NAME]
+        self.assertEqual(after.filter_, NEW_FILTER)
+        self.assertEqual(after.description, NEW_DESCRIPTION)
+
+    def _init_storage_bucket(self):
+        from google.cloud import storage
+
+        BUCKET_NAME = "g-c-python-testing%s" % (_RESOURCE_ID,)
+        BUCKET_URI = "storage.googleapis.com/%s" % (BUCKET_NAME,)
+
+        # Create the destination bucket, and set up the ACL to allow
+        # Stackdriver Logging to write into it.
+        retry = RetryErrors((Conflict, TooManyRequests, ServiceUnavailable))
+        storage_client = storage.Client()
+        bucket = storage_client.bucket(BUCKET_NAME)
+        retry(bucket.create)()
+        self.to_delete.append(bucket)
+        bucket.acl.reload()
+        logs_group = bucket.acl.group("cloud-logs@google.com")
+        logs_group.grant_owner()
+        bucket.acl.add_entity(logs_group)
+        bucket.acl.save()
+
+        return BUCKET_URI
+
+    def test_create_sink_storage_bucket(self):
+        uri = self._init_storage_bucket()
+        SINK_NAME = "test-create-sink-bucket%s" % (_RESOURCE_ID,)
+
+        retry = RetryErrors((Conflict, ServiceUnavailable), max_tries=10)
+        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
+        self.assertFalse(sink.exists())
+
+        retry(sink.create)()
+
+        self.to_delete.append(sink)
+        self.assertTrue(sink.exists())
+
+    def test_create_sink_pubsub_topic(self):
+        from google.cloud import pubsub_v1
+
+        SINK_NAME = "test-create-sink-topic%s" % (_RESOURCE_ID,)
+        TOPIC_NAME = "logging-systest{}".format(unique_resource_id("-"))
+
+        # Create the destination topic, and set up the IAM policy to allow
+        # Stackdriver Logging to write into it.
+        publisher = pubsub_v1.PublisherClient()
+        topic_path = publisher.topic_path(Config.CLIENT.project, TOPIC_NAME)
+        self.to_delete.append(_DeleteWrapper(publisher, topic_path))
+        publisher.create_topic(topic_path)
+
+        policy = publisher.get_iam_policy(topic_path)
+        policy.bindings.add(role="roles/owner", members=["group:cloud-logs@google.com"])
+        publisher.set_iam_policy(topic_path, policy)
+
+        TOPIC_URI = "pubsub.googleapis.com/%s" % (topic_path,)
+
+        retry = RetryErrors((Conflict, ServiceUnavailable), max_tries=10)
+        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, TOPIC_URI)
+        self.assertFalse(sink.exists())
+
+        retry(sink.create)()
+
+        self.to_delete.append(sink)
+        self.assertTrue(sink.exists())
+
+    def _init_bigquery_dataset(self):
+        from google.cloud import bigquery
+        from google.cloud.bigquery.dataset import AccessEntry
+
+        dataset_name = ("system_testing_dataset" + _RESOURCE_ID).replace("-", "_")
+        dataset_uri = "bigquery.googleapis.com/projects/%s/datasets/%s" % (
+            Config.CLIENT.project,
+            dataset_name,
+        )
+
+        # Create the destination dataset, and set up the ACL to allow
+        # Stackdriver Logging to write into it.
+        retry = RetryErrors((TooManyRequests, BadGateway, ServiceUnavailable))
+        bigquery_client = bigquery.Client()
+        dataset_ref = bigquery_client.dataset(dataset_name)
+        dataset = retry(bigquery_client.create_dataset)(bigquery.Dataset(dataset_ref))
+        self.to_delete.append((bigquery_client, dataset))
+        bigquery_client.get_dataset(dataset)
+        access = AccessEntry("WRITER", "groupByEmail", "cloud-logs@google.com")
+        dataset.access_entries.append(access)
+        bigquery_client.update_dataset(dataset, ["access_entries"])
+        return dataset_uri
+
+    def test_create_sink_bigquery_dataset(self):
+        SINK_NAME = "test-create-sink-dataset%s" % (_RESOURCE_ID,)
+        retry = RetryErrors((Conflict, ServiceUnavailable), max_tries=10)
+        uri = self._init_bigquery_dataset()
+        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
+        self.assertFalse(sink.exists())
+
+        retry(sink.create)()
+
+        self.to_delete.append(sink)
+        self.assertTrue(sink.exists())
+
+    def test_list_sinks(self):
+        SINK_NAME = "test-list-sinks%s" % (_RESOURCE_ID,)
+        uri = self._init_storage_bucket()
+        retry = RetryErrors((Conflict, ServiceUnavailable), max_tries=10)
+        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
+        self.assertFalse(sink.exists())
+        before_sinks = list(Config.CLIENT.list_sinks())
+        before_names = set(before.name for before in before_sinks)
+        self.assertFalse(sink.name in before_names)
+        retry(sink.create)()
+        self.to_delete.append(sink)
+        self.assertTrue(sink.exists())
+
+        after_sinks = list(Config.CLIENT.list_sinks())
+
+        after_names = set(after.name for after in after_sinks)
+        self.assertTrue(sink.name in after_names)
+
+    def test_reload_sink(self):
+        SINK_NAME = "test-reload-sink%s" % (_RESOURCE_ID,)
+        retry = RetryErrors((Conflict, ServiceUnavailable), max_tries=10)
+        uri = self._init_bigquery_dataset()
+        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
+        self.assertFalse(sink.exists())
+        retry(sink.create)()
+        self.to_delete.append(sink)
+        sink.filter_ = "BOGUS FILTER"
+        sink.destination = "BOGUS DESTINATION"
+
+        sink.reload()
+
+        self.assertEqual(sink.filter_, DEFAULT_FILTER)
+        self.assertEqual(sink.destination, uri)
+
+    def test_update_sink(self):
+        SINK_NAME = "test-update-sink%s" % (_RESOURCE_ID,)
+        retry = RetryErrors((Conflict, ServiceUnavailable), max_tries=10)
+        bucket_uri = self._init_storage_bucket()
+        dataset_uri = self._init_bigquery_dataset()
+        UPDATED_FILTER = "logName:syslog"
+        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, bucket_uri)
+        self.assertFalse(sink.exists())
+        retry(sink.create)()
+        self.to_delete.append(sink)
+        sink.filter_ = UPDATED_FILTER
+        sink.destination = dataset_uri
+
+        sink.update()
+
+        self.assertEqual(sink.filter_, UPDATED_FILTER)
+        self.assertEqual(sink.destination, dataset_uri)
+
+
+class _DeleteWrapper(object):
+    def __init__(self, publisher, topic_path):
+        self.publisher = publisher
+        self.topic_path = topic_path
+
+    def delete(self):
+        self.publisher.delete_topic(self.topic_path)
diff --git a/logging/tests/unit/__init__.py b/logging/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/logging/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/logging/tests/unit/gapic/v2/test_config_service_v2_client_v2.py b/logging/tests/unit/gapic/v2/test_config_service_v2_client_v2.py
new file mode 100644
index 000000000000..5ac89493cd7e
--- /dev/null
+++ b/logging/tests/unit/gapic/v2/test_config_service_v2_client_v2.py
@@ -0,0 +1,516 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import logging_v2
+from google.cloud.logging_v2.proto import logging_config_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestConfigServiceV2Client(object):
+    def test_list_sinks(self):
+        # Setup Expected Response
+        next_page_token = ""
+        sinks_element = {}
+        sinks = [sinks_element]
+        expected_response = {"next_page_token": next_page_token, "sinks": sinks}
+        expected_response = logging_config_pb2.ListSinksResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_sinks(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.sinks[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.ListSinksRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_sinks_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_sinks(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_sink(self):
+        # Setup Expected Response
+        name = "name3373707"
+        destination = "destination-1429847026"
+        filter_ = "filter-1274492040"
+        writer_identity = "writerIdentity775638794"
+        include_children = True
+        expected_response = {
+            "name": name,
+            "destination": destination,
+            "filter": filter_,
+            "writer_identity": writer_identity,
+            "include_children": include_children,
+        }
+        expected_response = logging_config_pb2.LogSink(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        sink_name = client.sink_path("[PROJECT]", "[SINK]")
+
+        response = client.get_sink(sink_name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.GetSinkRequest(sink_name=sink_name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_sink_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        sink_name = client.sink_path("[PROJECT]", "[SINK]")
+
+        with pytest.raises(CustomException):
+            client.get_sink(sink_name)
+
+    def test_create_sink(self):
+        # Setup Expected Response
+        name = "name3373707"
+        destination = "destination-1429847026"
+        filter_ = "filter-1274492040"
+        writer_identity = "writerIdentity775638794"
+        include_children = True
+        expected_response = {
+            "name": name,
+            "destination": destination,
+            "filter": filter_,
+            "writer_identity": writer_identity,
+            "include_children": include_children,
+        }
+        expected_response = logging_config_pb2.LogSink(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        sink = {}
+
+        response = client.create_sink(parent, sink)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.CreateSinkRequest(
+            parent=parent, sink=sink
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_sink_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        sink = {}
+
+        with pytest.raises(CustomException):
+            client.create_sink(parent, sink)
+
+    def test_update_sink(self):
+        # Setup Expected Response
+        name = "name3373707"
+        destination = "destination-1429847026"
+        filter_ = "filter-1274492040"
+        writer_identity = "writerIdentity775638794"
+        include_children = True
+        expected_response = {
+            "name": name,
+            "destination": destination,
+            "filter": filter_,
+            "writer_identity": writer_identity,
+            "include_children": include_children,
+        }
+        expected_response = logging_config_pb2.LogSink(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        sink_name = client.sink_path("[PROJECT]", "[SINK]")
+        sink = {}
+
+        response = client.update_sink(sink_name, sink)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.UpdateSinkRequest(
+            sink_name=sink_name, sink=sink
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_sink_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        sink_name = client.sink_path("[PROJECT]", "[SINK]")
+        sink = {}
+
+        with pytest.raises(CustomException):
+            client.update_sink(sink_name, sink)
+
+    def test_delete_sink(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        sink_name = client.sink_path("[PROJECT]", "[SINK]")
+
+        client.delete_sink(sink_name)
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.DeleteSinkRequest(sink_name=sink_name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_sink_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        sink_name = client.sink_path("[PROJECT]", "[SINK]")
+
+        with pytest.raises(CustomException):
+            client.delete_sink(sink_name)
+
+    def test_list_exclusions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        exclusions_element = {}
+        exclusions = [exclusions_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "exclusions": exclusions,
+        }
+        expected_response = logging_config_pb2.ListExclusionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_exclusions(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.exclusions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.ListExclusionsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_exclusions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_exclusions(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_exclusion(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        filter_ = "filter-1274492040"
+        disabled = True
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "filter": filter_,
+            "disabled": disabled,
+        }
+        expected_response = logging_config_pb2.LogExclusion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        name = client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+
+        response = client.get_exclusion(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.GetExclusionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_exclusion_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        name = client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+
+        with pytest.raises(CustomException):
+            client.get_exclusion(name)
+
+    def test_create_exclusion(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        filter_ = "filter-1274492040"
+        disabled = True
+        expected_response = {
+            "name": name,
+            "description": description,
+            "filter": filter_,
+            "disabled": disabled,
+        }
+        expected_response = logging_config_pb2.LogExclusion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        exclusion = {}
+
+        response = client.create_exclusion(parent, exclusion)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.CreateExclusionRequest(
+            parent=parent, exclusion=exclusion
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_exclusion_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        exclusion = {}
+
+        with pytest.raises(CustomException):
+            client.create_exclusion(parent, exclusion)
+
+    def test_update_exclusion(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        filter_ = "filter-1274492040"
+        disabled = True
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "filter": filter_,
+            "disabled": disabled,
+        }
+        expected_response = logging_config_pb2.LogExclusion(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        name = client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+        exclusion = {}
+        update_mask = {}
+
+        response = client.update_exclusion(name, exclusion, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.UpdateExclusionRequest(
+            name=name, exclusion=exclusion, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_exclusion_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        name = client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+        exclusion = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_exclusion(name, exclusion, update_mask)
+
+    def test_delete_exclusion(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup Request
+        name = client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+
+        client.delete_exclusion(name)
+
+        assert len(channel.requests) == 1
+        expected_request = logging_config_pb2.DeleteExclusionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_exclusion_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.ConfigServiceV2Client()
+
+        # Setup request
+        name = client.exclusion_path("[PROJECT]", "[EXCLUSION]")
+
+        with pytest.raises(CustomException):
+            client.delete_exclusion(name)
diff --git a/logging/tests/unit/gapic/v2/test_logging_service_v2_client_v2.py b/logging/tests/unit/gapic/v2/test_logging_service_v2_client_v2.py
new file mode 100644
index 000000000000..30aa9b807329
--- /dev/null
+++ b/logging/tests/unit/gapic/v2/test_logging_service_v2_client_v2.py
@@ -0,0 +1,262 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.api import monitored_resource_pb2
+from google.cloud import logging_v2
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestLoggingServiceV2Client(object):
+    def test_delete_log(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup Request
+        log_name = client.log_path("[PROJECT]", "[LOG]")
+
+        client.delete_log(log_name)
+
+        assert len(channel.requests) == 1
+        expected_request = logging_pb2.DeleteLogRequest(log_name=log_name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_log_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup request
+        log_name = client.log_path("[PROJECT]", "[LOG]")
+
+        with pytest.raises(CustomException):
+            client.delete_log(log_name)
+
+    def test_write_log_entries(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = logging_pb2.WriteLogEntriesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup Request
+        entries = []
+
+        response = client.write_log_entries(entries)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_pb2.WriteLogEntriesRequest(entries=entries)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_write_log_entries_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup request
+        entries = []
+
+        with pytest.raises(CustomException):
+            client.write_log_entries(entries)
+
+    def test_list_log_entries(self):
+        # Setup Expected Response
+        next_page_token = ""
+        entries_element = {}
+        entries = [entries_element]
+        expected_response = {"next_page_token": next_page_token, "entries": entries}
+        expected_response = logging_pb2.ListLogEntriesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup Request
+        resource_names = []
+
+        paged_list_response = client.list_log_entries(resource_names)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.entries[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = logging_pb2.ListLogEntriesRequest(
+            resource_names=resource_names
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_log_entries_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup request
+        resource_names = []
+
+        paged_list_response = client.list_log_entries(resource_names)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_monitored_resource_descriptors(self):
+        # Setup Expected Response
+        next_page_token = ""
+        resource_descriptors_element = {}
+        resource_descriptors = [resource_descriptors_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "resource_descriptors": resource_descriptors,
+        }
+        expected_response = logging_pb2.ListMonitoredResourceDescriptorsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        paged_list_response = client.list_monitored_resource_descriptors()
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.resource_descriptors[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = logging_pb2.ListMonitoredResourceDescriptorsRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_monitored_resource_descriptors_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        paged_list_response = client.list_monitored_resource_descriptors()
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_logs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        log_names_element = "logNamesElement-1079688374"
+        log_names = [log_names_element]
+        expected_response = {"next_page_token": next_page_token, "log_names": log_names}
+        expected_response = logging_pb2.ListLogsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_logs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.log_names[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = logging_pb2.ListLogsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_logs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.LoggingServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_logs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/logging/tests/unit/gapic/v2/test_metrics_service_v2_client_v2.py b/logging/tests/unit/gapic/v2/test_metrics_service_v2_client_v2.py
new file mode 100644
index 000000000000..e9dd3e348d48
--- /dev/null
+++ b/logging/tests/unit/gapic/v2/test_metrics_service_v2_client_v2.py
@@ -0,0 +1,288 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import logging_v2
+from google.cloud.logging_v2.proto import logging_metrics_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestMetricsServiceV2Client(object):
+    def test_list_log_metrics(self):
+        # Setup Expected Response
+        next_page_token = ""
+        metrics_element = {}
+        metrics = [metrics_element]
+        expected_response = {"next_page_token": next_page_token, "metrics": metrics}
+        expected_response = logging_metrics_pb2.ListLogMetricsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_log_metrics(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.metrics[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = logging_metrics_pb2.ListLogMetricsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_log_metrics_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_log_metrics(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_log_metric(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        filter_ = "filter-1274492040"
+        value_extractor = "valueExtractor2047672534"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "filter": filter_,
+            "value_extractor": value_extractor,
+        }
+        expected_response = logging_metrics_pb2.LogMetric(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup Request
+        metric_name = client.metric_path("[PROJECT]", "[METRIC]")
+
+        response = client.get_log_metric(metric_name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_metrics_pb2.GetLogMetricRequest(
+            metric_name=metric_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_log_metric_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup request
+        metric_name = client.metric_path("[PROJECT]", "[METRIC]")
+
+        with pytest.raises(CustomException):
+            client.get_log_metric(metric_name)
+
+    def test_create_log_metric(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        filter_ = "filter-1274492040"
+        value_extractor = "valueExtractor2047672534"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "filter": filter_,
+            "value_extractor": value_extractor,
+        }
+        expected_response = logging_metrics_pb2.LogMetric(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        metric = {}
+
+        response = client.create_log_metric(parent, metric)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_metrics_pb2.CreateLogMetricRequest(
+            parent=parent, metric=metric
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_log_metric_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        metric = {}
+
+        with pytest.raises(CustomException):
+            client.create_log_metric(parent, metric)
+
+    def test_update_log_metric(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        filter_ = "filter-1274492040"
+        value_extractor = "valueExtractor2047672534"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "filter": filter_,
+            "value_extractor": value_extractor,
+        }
+        expected_response = logging_metrics_pb2.LogMetric(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup Request
+        metric_name = client.metric_path("[PROJECT]", "[METRIC]")
+        metric = {}
+
+        response = client.update_log_metric(metric_name, metric)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = logging_metrics_pb2.UpdateLogMetricRequest(
+            metric_name=metric_name, metric=metric
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_log_metric_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup request
+        metric_name = client.metric_path("[PROJECT]", "[METRIC]")
+        metric = {}
+
+        with pytest.raises(CustomException):
+            client.update_log_metric(metric_name, metric)
+
+    def test_delete_log_metric(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup Request
+        metric_name = client.metric_path("[PROJECT]", "[METRIC]")
+
+        client.delete_log_metric(metric_name)
+
+        assert len(channel.requests) == 1
+        expected_request = logging_metrics_pb2.DeleteLogMetricRequest(
+            metric_name=metric_name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_log_metric_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = logging_v2.MetricsServiceV2Client()
+
+        # Setup request
+        metric_name = client.metric_path("[PROJECT]", "[METRIC]")
+
+        with pytest.raises(CustomException):
+            client.delete_log_metric(metric_name)
diff --git a/logging/tests/unit/handlers/__init__.py b/logging/tests/unit/handlers/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/logging/tests/unit/handlers/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/logging/tests/unit/handlers/middleware/test_request.py b/logging/tests/unit/handlers/middleware/test_request.py
new file mode 100644
index 000000000000..f606da573cec
--- /dev/null
+++ b/logging/tests/unit/handlers/middleware/test_request.py
@@ -0,0 +1,84 @@
+# Copyright 2017 Google LLC 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.
+
+import unittest
+
+import mock
+
+
+class DjangoBase(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        from django.conf import settings
+        from django.test.utils import setup_test_environment
+
+        if not settings.configured:
+            settings.configure()
+        setup_test_environment()
+
+    @classmethod
+    def tearDownClass(cls):
+        from django.test.utils import teardown_test_environment
+
+        teardown_test_environment()
+
+
+class TestRequestMiddleware(DjangoBase):
+    def _get_target_class(self):
+        from google.cloud.logging.handlers.middleware import request
+
+        return request.RequestMiddleware
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_process_request(self):
+        from django.test import RequestFactory
+        from google.cloud.logging.handlers.middleware import request
+
+        middleware = self._make_one()
+        mock_request = RequestFactory().get("/")
+        middleware.process_request(mock_request)
+
+        django_request = request._get_django_request()
+        self.assertEqual(django_request, mock_request)
+
+
+class Test__get_django_request(DjangoBase):
+    @staticmethod
+    def _call_fut():
+        from google.cloud.logging.handlers.middleware import request
+
+        return request._get_django_request()
+
+    @staticmethod
+    def _make_patch(new_locals):
+        return mock.patch(
+            "google.cloud.logging.handlers.middleware.request._thread_locals",
+            new=new_locals,
+        )
+
+    def test_with_request(self):
+        thread_locals = mock.Mock(spec=["request"])
+        with self._make_patch(thread_locals):
+            django_request = self._call_fut()
+
+        self.assertIs(django_request, thread_locals.request)
+
+    def test_without_request(self):
+        thread_locals = mock.Mock(spec=[])
+        with self._make_patch(thread_locals):
+            django_request = self._call_fut()
+
+        self.assertIsNone(django_request)
diff --git a/logging/tests/unit/handlers/test__helpers.py b/logging/tests/unit/handlers/test__helpers.py
new file mode 100644
index 000000000000..b5ba26fd17a7
--- /dev/null
+++ b/logging/tests/unit/handlers/test__helpers.py
@@ -0,0 +1,219 @@
+# Copyright 2017 Google LLC 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.
+
+import json
+import unittest
+
+import mock
+import six
+
+try:
+    from webapp2 import RequestHandler
+except SyntaxError:
+    # webapp2 has not been ported to python3, so it will give a syntax
+    # error if we try.  We'll just skip the webapp2 tests in that case.
+    RequestHandler = object
+
+
+class Test_get_trace_id_from_flask(unittest.TestCase):
+    @staticmethod
+    def _call_fut():
+        from google.cloud.logging.handlers import _helpers
+
+        return _helpers.get_trace_id_from_flask()
+
+    @staticmethod
+    def create_app():
+        import flask
+
+        app = flask.Flask(__name__)
+
+        @app.route("/")
+        def index():
+            return "test flask trace"  # pragma: NO COVER
+
+        return app
+
+    def test_no_context_header(self):
+        app = self.create_app()
+        with app.test_request_context(path="/", headers={}):
+            trace_id = self._call_fut()
+
+        self.assertIsNone(trace_id)
+
+    def test_valid_context_header(self):
+        flask_trace_header = "X_CLOUD_TRACE_CONTEXT"
+        expected_trace_id = "testtraceidflask"
+        flask_trace_id = expected_trace_id + "/testspanid"
+
+        app = self.create_app()
+        context = app.test_request_context(
+            path="/", headers={flask_trace_header: flask_trace_id}
+        )
+
+        with context:
+            trace_id = self._call_fut()
+
+        self.assertEqual(trace_id, expected_trace_id)
+
+
+class _GetTraceId(RequestHandler):
+    def get(self):
+        from google.cloud.logging.handlers import _helpers
+
+        trace_id = _helpers.get_trace_id_from_webapp2()
+        self.response.content_type = "application/json"
+        self.response.out.write(json.dumps(trace_id))
+
+
+@unittest.skipIf(six.PY3, "webapp2 is Python 2 only")
+class Test_get_trace_id_from_webapp2(unittest.TestCase):
+    @staticmethod
+    def create_app():
+        import webapp2
+
+        app = webapp2.WSGIApplication([("/", _GetTraceId)])
+
+        return app
+
+    def test_no_context_header(self):
+        import webob
+
+        req = webob.BaseRequest.blank("/")
+        response = req.get_response(self.create_app())
+        trace_id = json.loads(response.body)
+
+        self.assertEqual(None, trace_id)
+
+    def test_valid_context_header(self):
+        import webob
+
+        webapp2_trace_header = "X-Cloud-Trace-Context"
+        expected_trace_id = "testtraceidwebapp2"
+        webapp2_trace_id = expected_trace_id + "/testspanid"
+
+        req = webob.BaseRequest.blank(
+            "/", headers={webapp2_trace_header: webapp2_trace_id}
+        )
+        response = req.get_response(self.create_app())
+        trace_id = json.loads(response.body)
+
+        self.assertEqual(trace_id, expected_trace_id)
+
+
+class Test_get_trace_id_from_django(unittest.TestCase):
+    @staticmethod
+    def _call_fut():
+        from google.cloud.logging.handlers import _helpers
+
+        return _helpers.get_trace_id_from_django()
+
+    def setUp(self):
+        from django.conf import settings
+        from django.test.utils import setup_test_environment
+
+        if not settings.configured:
+            settings.configure()
+        setup_test_environment()
+
+    def tearDown(self):
+        from django.test.utils import teardown_test_environment
+        from google.cloud.logging.handlers.middleware import request
+
+        teardown_test_environment()
+        request._thread_locals.__dict__.clear()
+
+    def test_no_context_header(self):
+        from django.test import RequestFactory
+        from google.cloud.logging.handlers.middleware import request
+
+        django_request = RequestFactory().get("/")
+
+        middleware = request.RequestMiddleware()
+        middleware.process_request(django_request)
+        trace_id = self._call_fut()
+        self.assertIsNone(trace_id)
+
+    def test_valid_context_header(self):
+        from django.test import RequestFactory
+        from google.cloud.logging.handlers.middleware import request
+
+        django_trace_header = "HTTP_X_CLOUD_TRACE_CONTEXT"
+        expected_trace_id = "testtraceiddjango"
+        django_trace_id = expected_trace_id + "/testspanid"
+
+        django_request = RequestFactory().get(
+            "/", **{django_trace_header: django_trace_id}
+        )
+
+        middleware = request.RequestMiddleware()
+        middleware.process_request(django_request)
+        trace_id = self._call_fut()
+
+        self.assertEqual(trace_id, expected_trace_id)
+
+
+class Test_get_trace_id(unittest.TestCase):
+    @staticmethod
+    def _call_fut():
+        from google.cloud.logging.handlers import _helpers
+
+        return _helpers.get_trace_id()
+
+    def _helper(self, django_return, flask_return):
+        django_patch = mock.patch(
+            "google.cloud.logging.handlers._helpers.get_trace_id_from_django",
+            return_value=django_return,
+        )
+        flask_patch = mock.patch(
+            "google.cloud.logging.handlers._helpers.get_trace_id_from_flask",
+            return_value=flask_return,
+        )
+
+        with django_patch as django_mock:
+            with flask_patch as flask_mock:
+                trace_id = self._call_fut()
+
+        return django_mock, flask_mock, trace_id
+
+    def test_from_django(self):
+        django_mock, flask_mock, trace_id = self._helper("test-django-trace-id", None)
+        self.assertEqual(trace_id, django_mock.return_value)
+
+        django_mock.assert_called_once_with()
+        flask_mock.assert_not_called()
+
+    def test_from_flask(self):
+        django_mock, flask_mock, trace_id = self._helper(None, "test-flask-trace-id")
+        self.assertEqual(trace_id, flask_mock.return_value)
+
+        django_mock.assert_called_once_with()
+        flask_mock.assert_called_once_with()
+
+    def test_from_django_and_flask(self):
+        django_mock, flask_mock, trace_id = self._helper(
+            "test-django-trace-id", "test-flask-trace-id"
+        )
+        # Django wins.
+        self.assertEqual(trace_id, django_mock.return_value)
+
+        django_mock.assert_called_once_with()
+        flask_mock.assert_not_called()
+
+    def test_missing(self):
+        django_mock, flask_mock, trace_id = self._helper(None, None)
+        self.assertIsNone(trace_id)
+
+        django_mock.assert_called_once_with()
+        flask_mock.assert_called_once_with()
diff --git a/logging/tests/unit/handlers/test_app_engine.py b/logging/tests/unit/handlers/test_app_engine.py
new file mode 100644
index 000000000000..eef4ac7410e3
--- /dev/null
+++ b/logging/tests/unit/handlers/test_app_engine.py
@@ -0,0 +1,142 @@
+# Copyright 2016 Google LLC 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.
+
+import logging
+import unittest
+
+import mock
+
+
+class TestAppEngineHandler(unittest.TestCase):
+    PROJECT = "PROJECT"
+
+    def _get_target_class(self):
+        from google.cloud.logging.handlers.app_engine import AppEngineHandler
+
+        return AppEngineHandler
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_w_gae_standard_env(self):
+        import sys
+        from google.cloud.logging.handlers import app_engine
+
+        client = mock.Mock(project=self.PROJECT, spec=["project"])
+
+        # Verify that project/service/version are picked up from the
+        # environment.
+        with mock.patch(
+            "os.environ",
+            new={
+                app_engine._GAE_PROJECT_ENV_STANDARD: "test_project",
+                app_engine._GAE_SERVICE_ENV: "test_service",
+                app_engine._GAE_VERSION_ENV: "test_version",
+            },
+        ):
+            handler = self._make_one(client, transport=_Transport)
+
+        self.assertIs(handler.client, client)
+        self.assertEqual(handler.name, app_engine._DEFAULT_GAE_LOGGER_NAME)
+        self.assertEqual(handler.resource.type, "gae_app")
+        self.assertEqual(handler.resource.labels["project_id"], "test_project")
+        self.assertEqual(handler.resource.labels["module_id"], "test_service")
+        self.assertEqual(handler.resource.labels["version_id"], "test_version")
+        self.assertIs(handler.stream, sys.stderr)
+
+    def test_constructor_w_gae_flex_env(self):
+        import io
+        from google.cloud.logging.handlers import app_engine
+
+        client = mock.Mock(project=self.PROJECT, spec=["project"])
+        name = "test-logger"
+        stream = io.BytesIO()
+
+        # Verify that _GAE_PROJECT_ENV_FLEX environment variable takes
+        # precedence over _GAE_PROJECT_ENV_STANDARD.
+        with mock.patch(
+            "os.environ",
+            new={
+                app_engine._GAE_PROJECT_ENV_FLEX: "test_project_2",
+                app_engine._GAE_PROJECT_ENV_STANDARD: "test_project_should_be_overridden",
+                app_engine._GAE_SERVICE_ENV: "test_service_2",
+                app_engine._GAE_VERSION_ENV: "test_version_2",
+            },
+        ):
+            handler = self._make_one(
+                client, name=name, transport=_Transport, stream=stream
+            )
+
+        self.assertIs(handler.client, client)
+        self.assertEqual(handler.name, name)
+        self.assertEqual(handler.resource.type, "gae_app")
+        self.assertEqual(handler.resource.labels["project_id"], "test_project_2")
+        self.assertEqual(handler.resource.labels["module_id"], "test_service_2")
+        self.assertEqual(handler.resource.labels["version_id"], "test_version_2")
+        self.assertIs(handler.stream, stream)
+
+    def test_emit(self):
+        client = mock.Mock(project=self.PROJECT, spec=["project"])
+        handler = self._make_one(client, transport=_Transport)
+        gae_resource = handler.get_gae_resource()
+        gae_labels = handler.get_gae_labels()
+        trace = None
+        logname = "app"
+        message = "hello world"
+        record = logging.LogRecord(logname, logging, None, None, message, None, None)
+        handler.emit(record)
+
+        self.assertIs(handler.transport.client, client)
+        self.assertEqual(handler.transport.name, logname)
+        self.assertEqual(
+            handler.transport.send_called_with,
+            (record, message, gae_resource, gae_labels, trace),
+        )
+
+    def _get_gae_labels_helper(self, trace_id):
+        get_trace_patch = mock.patch(
+            "google.cloud.logging.handlers.app_engine.get_trace_id",
+            return_value=trace_id,
+        )
+
+        client = mock.Mock(project=self.PROJECT, spec=["project"])
+        # The handler actually calls ``get_gae_labels()``.
+        with get_trace_patch as mock_get_trace:
+            handler = self._make_one(client, transport=_Transport)
+
+            gae_labels = handler.get_gae_labels()
+            self.assertEqual(mock_get_trace.mock_calls, [mock.call()])
+
+        return gae_labels
+
+    def test_get_gae_labels_with_label(self):
+        from google.cloud.logging.handlers import app_engine
+
+        trace_id = "test-gae-trace-id"
+        gae_labels = self._get_gae_labels_helper(trace_id)
+        expected_labels = {app_engine._TRACE_ID_LABEL: trace_id}
+        self.assertEqual(gae_labels, expected_labels)
+
+    def test_get_gae_labels_without_label(self):
+        gae_labels = self._get_gae_labels_helper(None)
+        self.assertEqual(gae_labels, {})
+
+
+class _Transport(object):
+    def __init__(self, client, name):
+        self.client = client
+        self.name = name
+
+    def send(self, record, message, resource, labels, trace):
+        self.send_called_with = (record, message, resource, labels, trace)
diff --git a/logging/tests/unit/handlers/test_container_engine.py b/logging/tests/unit/handlers/test_container_engine.py
new file mode 100644
index 000000000000..09ee329ba3f2
--- /dev/null
+++ b/logging/tests/unit/handlers/test_container_engine.py
@@ -0,0 +1,58 @@
+# Copyright 2016 Google LLC 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.
+
+import unittest
+
+
+class TestContainerEngineHandler(unittest.TestCase):
+    PROJECT = "PROJECT"
+
+    def _get_target_class(self):
+        from google.cloud.logging.handlers.container_engine import (
+            ContainerEngineHandler,
+        )
+
+        return ContainerEngineHandler
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        handler = self._make_one()
+        self.assertIsNone(handler.name)
+
+    def test_ctor_w_name(self):
+        handler = self._make_one(name="foo")
+        self.assertEqual(handler.name, "foo")
+
+    def test_format(self):
+        import logging
+        import json
+
+        handler = self._make_one()
+        logname = "loggername"
+        message = "hello world"
+        record = logging.LogRecord(
+            logname, logging.INFO, None, None, message, None, None
+        )
+        record.created = 5.03
+        expected_payload = {
+            "message": message,
+            "timestamp": {"seconds": 5, "nanos": int(0.03 * 1e9)},
+            "thread": record.thread,
+            "severity": record.levelname,
+        }
+        payload = handler.format(record)
+
+        self.assertEqual(payload, json.dumps(expected_payload))
diff --git a/logging/tests/unit/handlers/test_handlers.py b/logging/tests/unit/handlers/test_handlers.py
new file mode 100644
index 000000000000..5559791bc2fa
--- /dev/null
+++ b/logging/tests/unit/handlers/test_handlers.py
@@ -0,0 +1,152 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import unittest
+
+
+class TestCloudLoggingHandler(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.handlers.handlers import CloudLoggingHandler
+
+        return CloudLoggingHandler
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        import sys
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+        from google.cloud.logging.handlers.handlers import DEFAULT_LOGGER_NAME
+
+        client = _Client(self.PROJECT)
+        handler = self._make_one(client, transport=_Transport)
+        self.assertEqual(handler.name, DEFAULT_LOGGER_NAME)
+        self.assertIs(handler.client, client)
+        self.assertIsInstance(handler.transport, _Transport)
+        self.assertIs(handler.transport.client, client)
+        self.assertEqual(handler.transport.name, DEFAULT_LOGGER_NAME)
+        self.assertIs(handler.resource, _GLOBAL_RESOURCE)
+        self.assertIsNone(handler.labels)
+        self.assertIs(handler.stream, sys.stderr)
+
+    def test_ctor_explicit(self):
+        import io
+        from google.cloud.logging.resource import Resource
+
+        resource = Resource("resource_type", {"resource_label": "value"})
+        labels = {"handler_lable": "value"}
+        name = "test-logger"
+        client = _Client(self.PROJECT)
+        stream = io.BytesIO()
+        handler = self._make_one(
+            client,
+            name=name,
+            transport=_Transport,
+            resource=resource,
+            labels=labels,
+            stream=stream,
+        )
+        self.assertEqual(handler.name, name)
+        self.assertIs(handler.client, client)
+        self.assertIsInstance(handler.transport, _Transport)
+        self.assertIs(handler.transport.client, client)
+        self.assertEqual(handler.transport.name, name)
+        self.assertIs(handler.resource, resource)
+        self.assertEqual(handler.labels, labels)
+        self.assertIs(handler.stream, stream)
+
+    def test_emit(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        client = _Client(self.PROJECT)
+        handler = self._make_one(
+            client, transport=_Transport, resource=_GLOBAL_RESOURCE
+        )
+        logname = "loggername"
+        message = "hello world"
+        record = logging.LogRecord(logname, logging, None, None, message, None, None)
+        handler.emit(record)
+
+        self.assertEqual(
+            handler.transport.send_called_with,
+            (record, message, _GLOBAL_RESOURCE, None),
+        )
+
+
+class TestSetupLogging(unittest.TestCase):
+    def _call_fut(self, handler, excludes=None):
+        from google.cloud.logging.handlers.handlers import setup_logging
+
+        if excludes:
+            return setup_logging(handler, excluded_loggers=excludes)
+        else:
+            return setup_logging(handler)
+
+    def test_setup_logging(self):
+        handler = _Handler(logging.INFO)
+        self._call_fut(handler)
+
+        root_handlers = logging.getLogger().handlers
+        self.assertIn(handler, root_handlers)
+
+    def test_setup_logging_excludes(self):
+        INCLUDED_LOGGER_NAME = "includeme"
+        EXCLUDED_LOGGER_NAME = "excludeme"
+
+        handler = _Handler(logging.INFO)
+        self._call_fut(handler, (EXCLUDED_LOGGER_NAME,))
+
+        included_logger = logging.getLogger(INCLUDED_LOGGER_NAME)
+        self.assertTrue(included_logger.propagate)
+
+        excluded_logger = logging.getLogger(EXCLUDED_LOGGER_NAME)
+        self.assertNotIn(handler, excluded_logger.handlers)
+        self.assertFalse(excluded_logger.propagate)
+
+    def setUp(self):
+        self._handlers_cache = logging.getLogger().handlers[:]
+
+    def tearDown(self):
+        # cleanup handlers
+        logging.getLogger().handlers = self._handlers_cache[:]
+
+
+class _Handler(object):
+    def __init__(self, level):
+        self.level = level
+
+    def acquire(self):
+        pass  # pragma: NO COVER
+
+    def release(self):
+        pass  # pragma: NO COVER
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+
+
+class _Transport(object):
+    def __init__(self, client, name):
+        self.client = client
+        self.name = name
+
+    def send(self, record, message, resource, labels=None):
+        self.send_called_with = (record, message, resource, labels)
diff --git a/logging/tests/unit/handlers/transports/__init__.py b/logging/tests/unit/handlers/transports/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/logging/tests/unit/handlers/transports/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/logging/tests/unit/handlers/transports/test_background_thread.py b/logging/tests/unit/handlers/transports/test_background_thread.py
new file mode 100644
index 000000000000..7de912560aa7
--- /dev/null
+++ b/logging/tests/unit/handlers/transports/test_background_thread.py
@@ -0,0 +1,536 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+import logging
+import unittest
+
+import mock
+from six.moves import queue
+
+
+class TestBackgroundThreadHandler(unittest.TestCase):
+    PROJECT = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.handlers.transports import BackgroundThreadTransport
+
+        return BackgroundThreadTransport
+
+    def _make_one(self, *args, **kw):
+        worker_patch = mock.patch(
+            "google.cloud.logging.handlers.transports." "background_thread._Worker",
+            autospec=True,
+        )
+        with worker_patch as worker_mock:
+            return self._get_target_class()(*args, **kw), worker_mock
+
+    def test_constructor(self):
+        client = _Client(self.PROJECT)
+        name = "python_logger"
+
+        transport, worker = self._make_one(client, name)
+
+        logger, = worker.call_args[0]  # call_args[0] is *args.
+        self.assertEqual(logger.name, name)
+
+    def test_send(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        client = _Client(self.PROJECT)
+        name = "python_logger"
+
+        transport, _ = self._make_one(client, name)
+
+        python_logger_name = "mylogger"
+        message = "hello world"
+
+        record = logging.LogRecord(
+            python_logger_name, logging.INFO, None, None, message, None, None
+        )
+
+        transport.send(record, message, _GLOBAL_RESOURCE)
+
+        transport.worker.enqueue.assert_called_once_with(
+            record, message, _GLOBAL_RESOURCE, None, trace=None, span_id=None
+        )
+
+    def test_trace_send(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        client = _Client(self.PROJECT)
+        name = "python_logger"
+
+        transport, _ = self._make_one(client, name)
+
+        python_logger_name = "mylogger"
+        message = "hello world"
+        trace = "the-project/trace/longlogTraceid"
+
+        record = logging.LogRecord(
+            python_logger_name, logging.INFO, None, None, message, None, None
+        )
+
+        transport.send(record, message, _GLOBAL_RESOURCE, trace=trace)
+
+        transport.worker.enqueue.assert_called_once_with(
+            record, message, _GLOBAL_RESOURCE, None, trace=trace, span_id=None
+        )
+
+    def test_span_send(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        client = _Client(self.PROJECT)
+        name = "python_logger"
+
+        transport, _ = self._make_one(client, name)
+
+        python_logger_name = "mylogger"
+        message = "hello world"
+        span_id = "the-project/trace/longlogTraceid/span/123456789012abbacdac"
+
+        record = logging.LogRecord(
+            python_logger_name, logging.INFO, None, None, message, None, None
+        )
+
+        transport.send(record, message, _GLOBAL_RESOURCE, span_id=span_id)
+
+        transport.worker.enqueue.assert_called_once_with(
+            record, message, _GLOBAL_RESOURCE, None, trace=None, span_id=span_id
+        )
+
+    def test_flush(self):
+        client = _Client(self.PROJECT)
+        name = "python_logger"
+
+        transport, _ = self._make_one(client, name)
+
+        transport.flush()
+
+        transport.worker.flush.assert_called()
+
+    def test_worker(self):
+        client = _Client(self.PROJECT)
+        name = "python_logger"
+        batch_size = 30
+        grace_period = 20.0
+        max_latency = 0.1
+        transport, worker = self._make_one(
+            client,
+            name,
+            grace_period=grace_period,
+            batch_size=batch_size,
+            max_latency=max_latency,
+        )
+        worker_grace_period = worker.call_args[1]["grace_period"]  # **kwargs.
+        worker_batch_size = worker.call_args[1]["max_batch_size"]
+        worker_max_latency = worker.call_args[1]["max_latency"]
+        self.assertEqual(worker_grace_period, grace_period)
+        self.assertEqual(worker_batch_size, batch_size)
+        self.assertEqual(worker_max_latency, max_latency)
+
+
+class Test_Worker(unittest.TestCase):
+    NAME = "python_logger"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.handlers.transports import background_thread
+
+        return background_thread._Worker
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _start_with_thread_patch(self, worker):
+        with mock.patch("threading.Thread", new=_Thread) as thread_mock:
+            with mock.patch("atexit.register") as atexit_mock:
+                worker.start()
+                return thread_mock, atexit_mock
+
+    def test_constructor(self):
+        logger = _Logger(self.NAME)
+        grace_period = 50
+        max_batch_size = 50
+        max_latency = 0.1
+
+        worker = self._make_one(
+            logger,
+            grace_period=grace_period,
+            max_batch_size=max_batch_size,
+            max_latency=max_latency,
+        )
+
+        self.assertEqual(worker._cloud_logger, logger)
+        self.assertEqual(worker._grace_period, grace_period)
+        self.assertEqual(worker._max_batch_size, max_batch_size)
+        self.assertEqual(worker._max_latency, max_latency)
+        self.assertFalse(worker.is_alive)
+        self.assertIsNone(worker._thread)
+
+    def test_start(self):
+        from google.cloud.logging.handlers.transports import background_thread
+
+        worker = self._make_one(_Logger(self.NAME))
+
+        _, atexit_mock = self._start_with_thread_patch(worker)
+
+        self.assertTrue(worker.is_alive)
+        self.assertIsNotNone(worker._thread)
+        self.assertTrue(worker._thread.daemon)
+        self.assertEqual(worker._thread._target, worker._thread_main)
+        self.assertEqual(worker._thread._name, background_thread._WORKER_THREAD_NAME)
+        atexit_mock.assert_called_once_with(worker._main_thread_terminated)
+
+        # Calling start again should not start a new thread.
+        current_thread = worker._thread
+        self._start_with_thread_patch(worker)
+        self.assertIs(current_thread, worker._thread)
+
+    def test_stop(self):
+        from google.cloud.logging.handlers.transports import background_thread
+
+        grace_period = 5.0
+        worker = self._make_one(_Logger(self.NAME))
+
+        self._start_with_thread_patch(worker)
+        thread = worker._thread
+
+        worker.stop(grace_period)
+
+        self.assertEqual(worker._queue.qsize(), 1)
+        self.assertEqual(worker._queue.get(), background_thread._WORKER_TERMINATOR)
+        self.assertFalse(worker.is_alive)
+        self.assertIsNone(worker._thread)
+        self.assertEqual(thread._timeout, grace_period)
+
+        # Stopping twice should not be an error
+        worker.stop()
+
+    def test_stop_no_grace(self):
+        worker = self._make_one(_Logger(self.NAME))
+
+        self._start_with_thread_patch(worker)
+        thread = worker._thread
+
+        worker.stop()
+
+        self.assertEqual(thread._timeout, None)
+
+    def test__main_thread_terminated(self):
+        worker = self._make_one(_Logger(self.NAME))
+
+        self._start_with_thread_patch(worker)
+        worker._main_thread_terminated()
+
+        self.assertFalse(worker.is_alive)
+
+        # Calling twice should not be an error
+        worker._main_thread_terminated()
+
+    def test__main_thread_terminated_non_empty_queue(self):
+        worker = self._make_one(_Logger(self.NAME))
+
+        self._start_with_thread_patch(worker)
+        record = mock.Mock()
+        record.created = time.time()
+        worker.enqueue(record, "")
+        worker._main_thread_terminated()
+
+        self.assertFalse(worker.is_alive)
+
+    def test__main_thread_terminated_did_not_join(self):
+        worker = self._make_one(_Logger(self.NAME))
+
+        self._start_with_thread_patch(worker)
+        worker._thread._terminate_on_join = False
+        record = mock.Mock()
+        record.created = time.time()
+        worker.enqueue(record, "")
+        worker._main_thread_terminated()
+
+        self.assertFalse(worker.is_alive)
+
+    @staticmethod
+    def _enqueue_record(worker, message, levelno=logging.INFO, **kw):
+        record = logging.LogRecord("testing", levelno, None, None, message, None, None)
+        worker.enqueue(record, message, **kw)
+
+    def test_enqueue_defaults(self):
+        import datetime
+        from google.cloud.logging._helpers import LogSeverity
+
+        worker = self._make_one(_Logger(self.NAME))
+        self.assertTrue(worker._queue.empty())
+        message = "TEST SEVERITY"
+
+        self._enqueue_record(worker, message)
+
+        entry = worker._queue.get_nowait()
+        expected_info = {"message": message, "python_logger": "testing"}
+        self.assertEqual(entry["info"], expected_info)
+        self.assertEqual(entry["severity"], LogSeverity.INFO)
+        self.assertIsNone(entry["resource"])
+        self.assertIsNone(entry["labels"])
+        self.assertIsNone(entry["trace"])
+        self.assertIsNone(entry["span_id"])
+        self.assertIsInstance(entry["timestamp"], datetime.datetime)
+
+    def test_enqueue_explicit(self):
+        import datetime
+        from google.cloud.logging._helpers import LogSeverity
+
+        worker = self._make_one(_Logger(self.NAME))
+        self.assertTrue(worker._queue.empty())
+        message = "TEST SEVERITY"
+        resource = object()
+        labels = {"foo": "bar"}
+        trace = "TRACE"
+        span_id = "SPAN_ID"
+
+        self._enqueue_record(
+            worker,
+            message,
+            levelno=logging.ERROR,
+            resource=resource,
+            labels=labels,
+            trace=trace,
+            span_id=span_id,
+        )
+
+        entry = worker._queue.get_nowait()
+
+        expected_info = {"message": message, "python_logger": "testing"}
+        self.assertEqual(entry["info"], expected_info)
+        self.assertEqual(entry["severity"], LogSeverity.ERROR)
+        self.assertIs(entry["resource"], resource)
+        self.assertIs(entry["labels"], labels)
+        self.assertIs(entry["trace"], trace)
+        self.assertIs(entry["span_id"], span_id)
+        self.assertIsInstance(entry["timestamp"], datetime.datetime)
+
+    def test__thread_main(self):
+        from google.cloud.logging.handlers.transports import background_thread
+
+        worker = self._make_one(_Logger(self.NAME))
+
+        # Enqueue two records and the termination signal.
+        self._enqueue_record(worker, "1")
+        self._enqueue_record(worker, "2")
+        worker._queue.put_nowait(background_thread._WORKER_TERMINATOR)
+
+        worker._thread_main()
+
+        self.assertTrue(worker._cloud_logger._batch.commit_called)
+        self.assertEqual(worker._cloud_logger._batch.commit_count, 2)
+        self.assertEqual(worker._queue.qsize(), 0)
+
+    def test__thread_main_error(self):
+        from google.cloud.logging.handlers.transports import background_thread
+
+        worker = self._make_one(_Logger(self.NAME))
+        worker._cloud_logger._batch_cls = _RaisingBatch
+
+        # Enqueue one record and the termination signal.
+        self._enqueue_record(worker, "1")
+        worker._queue.put_nowait(background_thread._WORKER_TERMINATOR)
+
+        worker._thread_main()
+
+        self.assertTrue(worker._cloud_logger._batch.commit_called)
+        self.assertEqual(worker._queue.qsize(), 0)
+
+    def test__thread_main_batches(self):
+        from google.cloud.logging.handlers.transports import background_thread
+
+        worker = self._make_one(_Logger(self.NAME), max_batch_size=2)
+
+        # Enqueue three records and the termination signal. This should be
+        # enough to perform two separate batches and a third loop with just
+        # the exit.
+        self._enqueue_record(worker, "1")
+        self._enqueue_record(worker, "2")
+        self._enqueue_record(worker, "3")
+        self._enqueue_record(worker, "4")
+        worker._queue.put_nowait(background_thread._WORKER_TERMINATOR)
+
+        worker._thread_main()
+
+        # The last batch should not have been executed because it had no items.
+        self.assertFalse(worker._cloud_logger._batch.commit_called)
+        self.assertEqual(worker._queue.qsize(), 0)
+
+    @mock.patch("time.time", autospec=True, return_value=1)
+    def test__thread_main_max_latency(self, time):
+        # Note: this test is a bit brittle as it assumes the operation of
+        # _get_many invokes queue.get() followed by queue._get(). It fails
+        # the "change detector" test in that way. However, this is still a
+        # useful test to verify the queue timeout is appropriately calculated.
+        from six.moves import queue
+        from google.cloud.logging.handlers.transports import background_thread
+
+        # Use monotonically increasing time.
+        time.side_effect = range(1, 6)
+
+        worker = self._make_one(_Logger(self.NAME), max_latency=2, max_batch_size=10)
+        worker._queue = mock.create_autospec(queue.Queue, instance=True)
+
+        worker._queue.get.side_effect = [
+            {"info": {"message": "1"}},  # Single record.
+            queue.Empty(),  # Emulate a queue.get() timeout.
+            {"info": {"message": "1"}},  # Second record.
+            background_thread._WORKER_TERMINATOR,  # Stop the thread.
+            queue.Empty(),  # Emulate a queue.get() timeout.
+        ]
+
+        worker._thread_main()
+
+        self.assertEqual(worker._cloud_logger._num_batches, 2)
+        self.assertTrue(worker._cloud_logger._batch.commit_called)
+        self.assertEqual(worker._cloud_logger._batch.commit_count, 1)
+
+        # Time should have been called five times.
+        #
+        #   For the first batch, it should have been called:
+        #       * Once to get the start time. (1)
+        #       * Once to get the elapsed time while grabbing the second item.
+        #         (2)
+        #
+        #   For the second batch, it should have been called:
+        #       * Once to get start time. (3)
+        #       * Once to get the elapsed time while grabbing the second item.
+        #         (3)
+        #       * Once to get the elapsed time while grabbing the final
+        #         item. (4)
+        #       * Once final time to get the elapsed time while receiving
+        #         the empty queue.
+        #
+        self.assertEqual(time.call_count, 5)
+
+        # Queue.get should've been called 5 times as well, but with different
+        # timeouts due to the monotonically increasing time.
+        #
+        #   For the first batch, it will be called once without a timeout
+        #   (for the first item) and then with timeout=1, as start will be
+        #   1 and now will be 2.
+        #
+        #   For the second batch, it will be called once without a timeout
+        #   (for the first item) and then with timeout=1, as start will be
+        #   3 and now will be 4, and finally with timeout=0 as start will be 3
+        #   and now will be 5.
+        #
+        worker._queue.get.assert_has_calls(
+            [
+                mock.call(),
+                mock.call(timeout=1),
+                mock.call(),
+                mock.call(timeout=1),
+                mock.call(timeout=0),
+            ]
+        )
+
+    def test_flush(self):
+        worker = self._make_one(_Logger(self.NAME))
+        worker._queue = mock.Mock(spec=queue.Queue)
+
+        # Queue is empty, should not block.
+        worker.flush()
+        worker._queue.join.assert_called()
+
+
+class _Thread(object):
+    def __init__(self, target, name):
+        self._target = target
+        self._name = name
+        self._timeout = None
+        self._terminate_on_join = True
+        self.daemon = False
+
+    def is_alive(self):
+        return self._is_alive
+
+    def start(self):
+        self._is_alive = True
+
+    def stop(self):
+        self._is_alive = False
+
+    def join(self, timeout=None):
+        self._timeout = timeout
+        if self._terminate_on_join:
+            self.stop()
+
+
+class _Batch(object):
+    def __init__(self):
+        self.entries = []
+        self.commit_called = False
+        self.commit_count = None
+
+    def log_struct(
+        self,
+        info,
+        severity=logging.INFO,
+        resource=None,
+        labels=None,
+        trace=None,
+        span_id=None,
+        timestamp=None,
+    ):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        assert resource is None
+        resource = _GLOBAL_RESOURCE
+
+        self.log_struct_called_with = (info, severity, resource, labels, trace, span_id)
+        self.entries.append(info)
+
+    def commit(self):
+        self.commit_called = True
+        self.commit_count = len(self.entries)
+        del self.entries[:]
+
+
+class _RaisingBatch(_Batch):
+    def commit(self):
+        self.commit_called = True
+        raise ValueError("This batch raises on commit.")
+
+
+class _Logger(object):
+    def __init__(self, name):
+        self.name = name
+        self._batch_cls = _Batch
+        self._batch = None
+        self._num_batches = 0
+
+    def batch(self):
+        self._batch = self._batch_cls()
+        self._num_batches += 1
+        return self._batch
+
+
+class _Client(object):
+    def __init__(self, project, _http=None, credentials=None):
+        import mock
+
+        self.project = project
+        self._http = _http
+        self._credentials = credentials
+        self._connection = mock.Mock(credentials=credentials, spec=["credentials"])
+
+    def logger(self, name):  # pylint: disable=unused-argument
+        self._logger = _Logger(name)
+        return self._logger
diff --git a/logging/tests/unit/handlers/transports/test_base.py b/logging/tests/unit/handlers/transports/test_base.py
new file mode 100644
index 000000000000..03612e115a98
--- /dev/null
+++ b/logging/tests/unit/handlers/transports/test_base.py
@@ -0,0 +1,38 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestBaseHandler(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.handlers.transports import Transport
+
+        return Transport
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_send_is_abstract(self):
+        target = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            target.send(None, None, None)
+
+    def test_flush_is_abstract_and_optional(self):
+        target = self._make_one()
+        target.flush()
diff --git a/logging/tests/unit/handlers/transports/test_sync.py b/logging/tests/unit/handlers/transports/test_sync.py
new file mode 100644
index 000000000000..f2ff67d59d82
--- /dev/null
+++ b/logging/tests/unit/handlers/transports/test_sync.py
@@ -0,0 +1,107 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import unittest
+
+
+class TestSyncHandler(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.handlers.transports import SyncTransport
+
+        return SyncTransport
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        client = _Client(self.PROJECT)
+        NAME = "python_logger"
+        transport = self._make_one(client, NAME)
+        self.assertEqual(transport.logger.name, "python_logger")
+
+    def test_send(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+        from google.cloud.logging._helpers import LogSeverity
+
+        client = _Client(self.PROJECT)
+
+        stackdriver_logger_name = "python"
+        python_logger_name = "mylogger"
+        transport = self._make_one(client, stackdriver_logger_name)
+        message = "hello world"
+        record = logging.LogRecord(
+            python_logger_name, logging.INFO, None, None, message, None, None
+        )
+
+        transport.send(record, message, _GLOBAL_RESOURCE)
+        EXPECTED_STRUCT = {"message": message, "python_logger": python_logger_name}
+        EXPECTED_SENT = (
+            EXPECTED_STRUCT,
+            LogSeverity.INFO,
+            _GLOBAL_RESOURCE,
+            None,
+            None,
+            None,
+        )
+        self.assertEqual(transport.logger.log_struct_called_with, EXPECTED_SENT)
+
+
+class _Logger(object):
+    from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+    def __init__(self, name):
+        self.name = name
+
+    def log_struct(
+        self,
+        message,
+        severity=None,
+        resource=_GLOBAL_RESOURCE,
+        labels=None,
+        trace=None,
+        span_id=None,
+    ):
+        self.log_struct_called_with = (
+            message,
+            severity,
+            resource,
+            labels,
+            trace,
+            span_id,
+        )
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+
+    def logger(self, name):  # pylint: disable=unused-argument
+        self._logger = _Logger(name)
+        return self._logger
+
+
+class _Handler(object):
+    def __init__(self, level):
+        self.level = level  # pragma: NO COVER
+
+    def acquire(self):
+        pass  # pragma: NO COVER
+
+    def release(self):
+        pass  # pragma: NO COVER
diff --git a/logging/tests/unit/test__gapic.py b/logging/tests/unit/test__gapic.py
new file mode 100644
index 000000000000..ad6ded2bd1f7
--- /dev/null
+++ b/logging/tests/unit/test__gapic.py
@@ -0,0 +1,615 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+from google.api_core import grpc_helpers
+import google.auth.credentials
+from google.protobuf import empty_pb2
+import mock
+
+import google.cloud.logging
+from google.cloud.logging import _gapic
+from google.cloud.logging_v2.gapic import config_service_v2_client
+from google.cloud.logging_v2.gapic import logging_service_v2_client
+from google.cloud.logging_v2.gapic import metrics_service_v2_client
+from google.cloud.logging_v2.proto import log_entry_pb2
+from google.cloud.logging_v2.proto import logging_pb2
+from google.cloud.logging_v2.proto import logging_config_pb2
+from google.cloud.logging_v2.proto import logging_metrics_pb2
+
+
+PROJECT = "PROJECT"
+PROJECT_PATH = "projects/%s" % (PROJECT,)
+FILTER = "logName:syslog AND severity>=ERROR"
+
+
+class Test_LoggingAPI(object):
+    LOG_NAME = "log_name"
+    LOG_PATH = "projects/%s/logs/%s" % (PROJECT, LOG_NAME)
+
+    @staticmethod
+    def make_logging_api():
+        channel = grpc_helpers.ChannelStub()
+        gapic_client = logging_service_v2_client.LoggingServiceV2Client(channel=channel)
+        handwritten_client = mock.Mock()
+        api = _gapic._LoggingAPI(gapic_client, handwritten_client)
+        return channel, api
+
+    def test_ctor(self):
+        channel = grpc_helpers.ChannelStub()
+        gapic_client = logging_service_v2_client.LoggingServiceV2Client(channel=channel)
+        api = _gapic._LoggingAPI(gapic_client, mock.sentinel.client)
+        assert api._gapic_api is gapic_client
+        assert api._client is mock.sentinel.client
+
+    def test_list_entries(self):
+        channel, api = self.make_logging_api()
+
+        log_entry_msg = log_entry_pb2.LogEntry(
+            log_name=self.LOG_PATH, text_payload="text"
+        )
+        channel.ListLogEntries.response = logging_pb2.ListLogEntriesResponse(
+            entries=[log_entry_msg]
+        )
+        result = api.list_entries([PROJECT], FILTER, google.cloud.logging.DESCENDING)
+
+        entries = list(result)
+
+        # Check the response
+        assert len(entries) == 1
+        entry = entries[0]
+        assert isinstance(entry, google.cloud.logging.entries.TextEntry)
+        assert entry.payload == "text"
+
+        # Check the request
+        assert len(channel.ListLogEntries.requests) == 1
+        request = channel.ListLogEntries.requests[0]
+        assert request.project_ids == [PROJECT]
+        assert request.filter == FILTER
+        assert request.order_by == google.cloud.logging.DESCENDING
+
+    def test_list_entries_with_options(self):
+        channel, api = self.make_logging_api()
+
+        channel.ListLogEntries.response = logging_pb2.ListLogEntriesResponse(entries=[])
+
+        result = api.list_entries(
+            [PROJECT],
+            FILTER,
+            google.cloud.logging.ASCENDING,
+            page_size=42,
+            page_token="token",
+        )
+
+        list(result)
+
+        # Check the request
+        assert len(channel.ListLogEntries.requests) == 1
+        request = channel.ListLogEntries.requests[0]
+        assert request.project_ids == [PROJECT]
+        assert request.filter == FILTER
+        assert request.order_by == google.cloud.logging.ASCENDING
+        assert request.page_size == 42
+        assert request.page_token == "token"
+
+    def test_write_entries_single(self):
+        channel, api = self.make_logging_api()
+
+        channel.WriteLogEntries.response = empty_pb2.Empty()
+
+        entry = {
+            "logName": self.LOG_PATH,
+            "resource": {"type": "global"},
+            "textPayload": "text",
+        }
+
+        api.write_entries([entry])
+
+        # Check the request
+        assert len(channel.WriteLogEntries.requests) == 1
+        request = channel.WriteLogEntries.requests[0]
+        assert request.partial_success is False
+        assert len(request.entries) == 1
+        assert request.entries[0].log_name == entry["logName"]
+        assert request.entries[0].resource.type == entry["resource"]["type"]
+        assert request.entries[0].text_payload == "text"
+
+    def test_logger_delete(self):
+        channel, api = self.make_logging_api()
+
+        channel.DeleteLog.response = empty_pb2.Empty()
+
+        api.logger_delete(PROJECT, self.LOG_NAME)
+
+        assert len(channel.DeleteLog.requests) == 1
+        request = channel.DeleteLog.requests[0]
+        assert request.log_name == self.LOG_PATH
+
+
+class Test_SinksAPI(object):
+    SINK_NAME = "sink_name"
+    SINK_PATH = "projects/%s/sinks/%s" % (PROJECT, SINK_NAME)
+    DESTINATION_URI = "faux.googleapis.com/destination"
+    SINK_WRITER_IDENTITY = "serviceAccount:project-123@example.com"
+
+    @staticmethod
+    def make_sinks_api():
+        channel = grpc_helpers.ChannelStub()
+        gapic_client = config_service_v2_client.ConfigServiceV2Client(channel=channel)
+        handwritten_client = mock.Mock()
+        api = _gapic._SinksAPI(gapic_client, handwritten_client)
+        return channel, api
+
+    def test_ctor(self):
+        channel = grpc_helpers.ChannelStub()
+        gapic_client = config_service_v2_client.ConfigServiceV2Client(channel=channel)
+        api = _gapic._SinksAPI(gapic_client, mock.sentinel.client)
+        assert api._gapic_api is gapic_client
+        assert api._client is mock.sentinel.client
+
+    def test_list_sinks(self):
+        channel, api = self.make_sinks_api()
+
+        sink_msg = logging_config_pb2.LogSink(
+            name=self.SINK_PATH, destination=self.DESTINATION_URI, filter=FILTER
+        )
+        channel.ListSinks.response = logging_config_pb2.ListSinksResponse(
+            sinks=[sink_msg]
+        )
+
+        result = api.list_sinks(PROJECT)
+        sinks = list(result)
+
+        # Check the response
+        assert len(sinks) == 1
+        sink = sinks[0]
+        assert isinstance(sink, google.cloud.logging.sink.Sink)
+        assert sink.name == self.SINK_PATH
+        assert sink.destination == self.DESTINATION_URI
+        assert sink.filter_ == FILTER
+
+        # Check the request
+        assert len(channel.ListSinks.requests) == 1
+        request = channel.ListSinks.requests[0]
+        assert request.parent == PROJECT_PATH
+
+    def test_list_sinks_with_options(self):
+        channel, api = self.make_sinks_api()
+
+        channel.ListSinks.response = logging_config_pb2.ListSinksResponse(sinks=[])
+
+        result = api.list_sinks(PROJECT, page_size=42, page_token="token")
+        list(result)
+
+        # Check the request
+        assert len(channel.ListSinks.requests) == 1
+        request = channel.ListSinks.requests[0]
+        assert request.parent == "projects/%s" % PROJECT
+        assert request.page_size == 42
+        assert request.page_token == "token"
+
+    def test_sink_create(self):
+        channel, api = self.make_sinks_api()
+
+        channel.CreateSink.response = logging_config_pb2.LogSink(
+            name=self.SINK_NAME,
+            destination=self.DESTINATION_URI,
+            filter=FILTER,
+            writer_identity=self.SINK_WRITER_IDENTITY,
+        )
+
+        result = api.sink_create(
+            PROJECT,
+            self.SINK_NAME,
+            FILTER,
+            self.DESTINATION_URI,
+            unique_writer_identity=True,
+        )
+
+        # Check response
+        assert result == {
+            "name": self.SINK_NAME,
+            "filter": FILTER,
+            "destination": self.DESTINATION_URI,
+            "writerIdentity": self.SINK_WRITER_IDENTITY,
+        }
+
+        # Check request
+        assert len(channel.CreateSink.requests) == 1
+        request = channel.CreateSink.requests[0]
+        assert request.parent == PROJECT_PATH
+        assert request.unique_writer_identity is True
+        assert request.sink.name == self.SINK_NAME
+        assert request.sink.filter == FILTER
+        assert request.sink.destination == self.DESTINATION_URI
+
+    def test_sink_get(self):
+        channel, api = self.make_sinks_api()
+
+        channel.GetSink.response = logging_config_pb2.LogSink(
+            name=self.SINK_PATH, destination=self.DESTINATION_URI, filter=FILTER
+        )
+
+        response = api.sink_get(PROJECT, self.SINK_NAME)
+
+        # Check response
+        assert response == {
+            "name": self.SINK_PATH,
+            "filter": FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+
+        # Check request
+        assert len(channel.GetSink.requests) == 1
+        request = channel.GetSink.requests[0]
+        assert request.sink_name == self.SINK_PATH
+
+    def test_sink_update(self):
+        channel, api = self.make_sinks_api()
+
+        channel.UpdateSink.response = logging_config_pb2.LogSink(
+            name=self.SINK_NAME,
+            destination=self.DESTINATION_URI,
+            filter=FILTER,
+            writer_identity=self.SINK_WRITER_IDENTITY,
+        )
+
+        result = api.sink_update(
+            PROJECT,
+            self.SINK_NAME,
+            FILTER,
+            self.DESTINATION_URI,
+            unique_writer_identity=True,
+        )
+
+        # Check response
+        assert result == {
+            "name": self.SINK_NAME,
+            "filter": FILTER,
+            "destination": self.DESTINATION_URI,
+            "writerIdentity": self.SINK_WRITER_IDENTITY,
+        }
+
+        # Check request
+        assert len(channel.UpdateSink.requests) == 1
+        request = channel.UpdateSink.requests[0]
+        assert request.sink_name == self.SINK_PATH
+        assert request.unique_writer_identity is True
+        assert request.sink.name == self.SINK_PATH
+        assert request.sink.filter == FILTER
+        assert request.sink.destination == self.DESTINATION_URI
+
+    def test_sink_delete(self):
+        channel, api = self.make_sinks_api()
+
+        channel.DeleteSink.response = empty_pb2.Empty()
+
+        api.sink_delete(PROJECT, self.SINK_NAME)
+
+        assert len(channel.DeleteSink.requests) == 1
+        request = channel.DeleteSink.requests[0]
+        assert request.sink_name == self.SINK_PATH
+
+
+class Test_MetricsAPI(object):
+    METRIC_NAME = "metric_name"
+    METRIC_PATH = "projects/%s/metrics/%s" % (PROJECT, METRIC_NAME)
+    DESCRIPTION = "Description"
+
+    @staticmethod
+    def make_metrics_api():
+        channel = grpc_helpers.ChannelStub()
+        gapic_client = metrics_service_v2_client.MetricsServiceV2Client(channel=channel)
+        handwritten_client = mock.Mock()
+        api = _gapic._MetricsAPI(gapic_client, handwritten_client)
+        return channel, api
+
+    def test_ctor(self):
+        channel = grpc_helpers.ChannelStub()
+        gapic_client = metrics_service_v2_client.MetricsServiceV2Client(channel=channel)
+        api = _gapic._MetricsAPI(gapic_client, mock.sentinel.client)
+        assert api._gapic_api is gapic_client
+        assert api._client is mock.sentinel.client
+
+    def test_list_metrics(self):
+        channel, api = self.make_metrics_api()
+
+        sink_msg = logging_metrics_pb2.LogMetric(
+            name=self.METRIC_PATH, description=self.DESCRIPTION, filter=FILTER
+        )
+        channel.ListLogMetrics.response = logging_metrics_pb2.ListLogMetricsResponse(
+            metrics=[sink_msg]
+        )
+
+        result = api.list_metrics(PROJECT)
+        metrics = list(result)
+
+        # Check the response
+        assert len(metrics) == 1
+        metric = metrics[0]
+        assert isinstance(metric, google.cloud.logging.metric.Metric)
+        assert metric.name == self.METRIC_PATH
+        assert metric.description == self.DESCRIPTION
+        assert metric.filter_ == FILTER
+
+        # Check the request
+        assert len(channel.ListLogMetrics.requests) == 1
+        request = channel.ListLogMetrics.requests[0]
+        assert request.parent == PROJECT_PATH
+
+    def test_list_metrics_options(self):
+        channel, api = self.make_metrics_api()
+
+        channel.ListLogMetrics.response = logging_metrics_pb2.ListLogMetricsResponse(
+            metrics=[]
+        )
+
+        result = api.list_metrics(PROJECT, page_size=42, page_token="token")
+        list(result)
+
+        # Check the request
+        assert len(channel.ListLogMetrics.requests) == 1
+        request = channel.ListLogMetrics.requests[0]
+        assert request.parent == PROJECT_PATH
+        assert request.page_size == 42
+        assert request.page_token == "token"
+
+    def test_metric_create(self):
+        channel, api = self.make_metrics_api()
+
+        channel.CreateLogMetric.response = empty_pb2.Empty()
+
+        api.metric_create(PROJECT, self.METRIC_NAME, FILTER, self.DESCRIPTION)
+
+        # Check the request
+        assert len(channel.CreateLogMetric.requests) == 1
+        request = channel.CreateLogMetric.requests[0]
+        assert request.parent == PROJECT_PATH
+        assert request.metric.name == self.METRIC_NAME
+        assert request.metric.filter == FILTER
+        assert request.metric.description == self.DESCRIPTION
+
+    def test_metric_get(self):
+        channel, api = self.make_metrics_api()
+
+        channel.GetLogMetric.response = logging_metrics_pb2.LogMetric(
+            name=self.METRIC_PATH, description=self.DESCRIPTION, filter=FILTER
+        )
+
+        response = api.metric_get(PROJECT, self.METRIC_NAME)
+
+        # Check the response
+        assert response == {
+            "name": self.METRIC_PATH,
+            "filter": FILTER,
+            "description": self.DESCRIPTION,
+        }
+
+        # Check the request
+        assert len(channel.GetLogMetric.requests) == 1
+        request = channel.GetLogMetric.requests[0]
+        assert request.metric_name == self.METRIC_PATH
+
+    def test_metric_update(self):
+        channel, api = self.make_metrics_api()
+
+        channel.UpdateLogMetric.response = logging_metrics_pb2.LogMetric(
+            name=self.METRIC_PATH, description=self.DESCRIPTION, filter=FILTER
+        )
+
+        response = api.metric_update(
+            PROJECT, self.METRIC_NAME, FILTER, self.DESCRIPTION
+        )
+
+        # Check the response
+        assert response == {
+            "name": self.METRIC_PATH,
+            "filter": FILTER,
+            "description": self.DESCRIPTION,
+        }
+
+        # Check the request
+        assert len(channel.UpdateLogMetric.requests) == 1
+        request = channel.UpdateLogMetric.requests[0]
+        assert request.metric_name == self.METRIC_PATH
+        assert request.metric.name == self.METRIC_PATH
+        assert request.metric.filter == FILTER
+        assert request.metric.description == self.DESCRIPTION
+
+    def test_metric_delete(self):
+        channel, api = self.make_metrics_api()
+
+        channel.DeleteLogMetric.response = empty_pb2.Empty()
+
+        api.metric_delete(PROJECT, self.METRIC_NAME)
+
+        assert len(channel.DeleteLogMetric.requests) == 1
+        request = channel.DeleteLogMetric.requests[0]
+        assert request.metric_name == self.METRIC_PATH
+
+
+class Test__parse_log_entry(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.logging._gapic import _parse_log_entry
+
+        return _parse_log_entry(*args, **kwargs)
+
+    def test_simple(self):
+        from google.cloud.logging_v2.proto.log_entry_pb2 import LogEntry
+
+        entry_pb = LogEntry(log_name=u"lol-jk", text_payload=u"bah humbug")
+        result = self._call_fut(entry_pb)
+        expected = {"logName": entry_pb.log_name, "textPayload": entry_pb.text_payload}
+        self.assertEqual(result, expected)
+
+    @mock.patch("google.cloud.logging._gapic.MessageToDict", side_effect=TypeError)
+    def test_non_registry_failure(self, msg_to_dict_mock):
+        entry_pb = mock.Mock(spec=["HasField"])
+        entry_pb.HasField.return_value = False
+        with self.assertRaises(TypeError):
+            self._call_fut(entry_pb)
+
+        entry_pb.HasField.assert_called_once_with("proto_payload")
+        msg_to_dict_mock.assert_called_once_with(entry_pb)
+
+    def test_unregistered_type(self):
+        from google.cloud.logging_v2.proto.log_entry_pb2 import LogEntry
+        from google.protobuf import any_pb2
+        from google.protobuf import descriptor_pool
+        from google.protobuf.timestamp_pb2 import Timestamp
+
+        pool = descriptor_pool.Default()
+        type_name = "google.bigtable.admin.v2.UpdateClusterMetadata"
+        # Make sure the descriptor is not known in the registry.
+        with self.assertRaises(KeyError):
+            pool.FindMessageTypeByName(type_name)
+
+        type_url = "type.googleapis.com/" + type_name
+        metadata_bytes = b"\n\n\n\x03foo\x12\x03bar\x12\x06\x08\xbd\xb6\xfb\xc6\x05"
+        any_pb = any_pb2.Any(type_url=type_url, value=metadata_bytes)
+        timestamp = Timestamp(seconds=61, nanos=1234000)
+
+        entry_pb = LogEntry(proto_payload=any_pb, timestamp=timestamp)
+        result = self._call_fut(entry_pb)
+        self.assertEqual(len(result), 2)
+        self.assertEqual(result["timestamp"], "1970-01-01T00:01:01.001234Z")
+        # NOTE: This "hack" is needed on Windows, where the equality check
+        #       for an ``Any`` instance fails on unregistered types.
+        self.assertEqual(result["protoPayload"].type_url, type_url)
+        self.assertEqual(result["protoPayload"].value, metadata_bytes)
+
+    def test_registered_type(self):
+        from google.cloud.logging_v2.proto.log_entry_pb2 import LogEntry
+        from google.protobuf import any_pb2
+        from google.protobuf import descriptor_pool
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+
+        pool = descriptor_pool.Default()
+        type_name = "google.protobuf.Struct"
+        # Make sure the descriptor is known in the registry.
+        descriptor = pool.FindMessageTypeByName(type_name)
+        self.assertEqual(descriptor.name, "Struct")
+
+        type_url = "type.googleapis.com/" + type_name
+        field_name = "foo"
+        field_value = u"Bar"
+        struct_pb = Struct(fields={field_name: Value(string_value=field_value)})
+        any_pb = any_pb2.Any(type_url=type_url, value=struct_pb.SerializeToString())
+
+        entry_pb = LogEntry(proto_payload=any_pb, log_name=u"all-good")
+        result = self._call_fut(entry_pb)
+        expected_proto = {
+            "logName": entry_pb.log_name,
+            "protoPayload": {"@type": type_url, "value": {field_name: field_value}},
+        }
+        self.assertEqual(result, expected_proto)
+
+
+class Test__log_entry_mapping_to_pb(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.logging._gapic import _log_entry_mapping_to_pb
+
+        return _log_entry_mapping_to_pb(*args, **kwargs)
+
+    def test_simple(self):
+        from google.cloud.logging_v2.proto.log_entry_pb2 import LogEntry
+
+        result = self._call_fut({})
+        self.assertEqual(result, LogEntry())
+
+    def test_unregistered_type(self):
+        from google.protobuf import descriptor_pool
+        from google.protobuf.json_format import ParseError
+
+        pool = descriptor_pool.Default()
+        type_name = "google.bigtable.admin.v2.UpdateClusterMetadata"
+        # Make sure the descriptor is not known in the registry.
+        with self.assertRaises(KeyError):
+            pool.FindMessageTypeByName(type_name)
+
+        type_url = "type.googleapis.com/" + type_name
+        json_mapping = {
+            "protoPayload": {
+                "@type": type_url,
+                "originalRequest": {"name": "foo", "location": "bar"},
+                "requestTime": {"seconds": 1491000125},
+            }
+        }
+        with self.assertRaises(ParseError):
+            self._call_fut(json_mapping)
+
+    def test_registered_type(self):
+        from google.cloud.logging_v2.proto.log_entry_pb2 import LogEntry
+        from google.protobuf import any_pb2
+        from google.protobuf import descriptor_pool
+
+        pool = descriptor_pool.Default()
+        type_name = "google.protobuf.Struct"
+        # Make sure the descriptor is known in the registry.
+        descriptor = pool.FindMessageTypeByName(type_name)
+        self.assertEqual(descriptor.name, "Struct")
+
+        type_url = "type.googleapis.com/" + type_name
+        field_name = "foo"
+        field_value = u"Bar"
+        json_mapping = {
+            "logName": u"hi-everybody",
+            "protoPayload": {"@type": type_url, "value": {field_name: field_value}},
+        }
+        # Convert to a valid LogEntry.
+        result = self._call_fut(json_mapping)
+        entry_pb = LogEntry(
+            log_name=json_mapping["logName"],
+            proto_payload=any_pb2.Any(
+                type_url=type_url, value=b"\n\014\n\003foo\022\005\032\003Bar"
+            ),
+        )
+        self.assertEqual(result, entry_pb)
+
+
+@mock.patch("google.cloud.logging._gapic.LoggingServiceV2Client", autospec=True)
+def test_make_logging_api(gapic_client):
+    client = mock.Mock(spec=["_credentials", "_client_info"])
+    api = _gapic.make_logging_api(client)
+    assert api._client == client
+    assert api._gapic_api == gapic_client.return_value
+    gapic_client.assert_called_once_with(
+        credentials=client._credentials, client_info=client._client_info
+    )
+
+
+@mock.patch("google.cloud.logging._gapic.MetricsServiceV2Client", autospec=True)
+def test_make_metrics_api(gapic_client):
+    client = mock.Mock(spec=["_credentials", "_client_info"])
+    api = _gapic.make_metrics_api(client)
+    assert api._client == client
+    assert api._gapic_api == gapic_client.return_value
+    gapic_client.assert_called_once_with(
+        credentials=client._credentials, client_info=client._client_info
+    )
+
+
+@mock.patch("google.cloud.logging._gapic.ConfigServiceV2Client", autospec=True)
+def test_make_sinks_api(gapic_client):
+    client = mock.Mock(spec=["_credentials", "_client_info"])
+    api = _gapic.make_sinks_api(client)
+    assert api._client == client
+    assert api._gapic_api == gapic_client.return_value
+    gapic_client.assert_called_once_with(
+        credentials=client._credentials, client_info=client._client_info
+    )
diff --git a/logging/tests/unit/test__helpers.py b/logging/tests/unit/test__helpers.py
new file mode 100644
index 000000000000..db0804e66638
--- /dev/null
+++ b/logging/tests/unit/test__helpers.py
@@ -0,0 +1,179 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import logging
+import unittest
+
+import mock
+
+
+class Test_entry_from_resource(unittest.TestCase):
+    @staticmethod
+    def _call_fut(resource, client, loggers):
+        from google.cloud.logging._helpers import entry_from_resource
+
+        return entry_from_resource(resource, client, loggers)
+
+    def _payload_helper(self, key, class_name):
+        import mock
+
+        resource = {}
+        if key is not None:
+            resource[key] = "yup"
+        client = object()
+        loggers = {}
+        mock_class = EntryMock()
+
+        name = "google.cloud.logging._helpers." + class_name
+        with mock.patch(name, new=mock_class):
+            result = self._call_fut(resource, client, loggers)
+
+        self.assertIs(result, mock_class.sentinel)
+        self.assertEqual(mock_class.called, (resource, client, loggers))
+
+    def test_wo_payload(self):
+        self._payload_helper(None, "LogEntry")
+
+    def test_text_payload(self):
+        self._payload_helper("textPayload", "TextEntry")
+
+    def test_json_payload(self):
+        self._payload_helper("jsonPayload", "StructEntry")
+
+    def test_proto_payload(self):
+        self._payload_helper("protoPayload", "ProtobufEntry")
+
+
+class Test_retrieve_metadata_server(unittest.TestCase):
+    @staticmethod
+    def _call_fut(metadata_key):
+        from google.cloud.logging._helpers import retrieve_metadata_server
+
+        return retrieve_metadata_server(metadata_key)
+
+    def test_metadata_exists(self):
+        status_code_ok = 200
+        response_text = "my-gke-cluster"
+        metadata_key = "test_key"
+
+        response_mock = ResponseMock(status_code=status_code_ok)
+        response_mock.text = response_text
+
+        requests_mock = mock.Mock()
+        requests_mock.get.return_value = response_mock
+        requests_mock.codes.ok = status_code_ok
+
+        patch = mock.patch("google.cloud.logging._helpers.requests", requests_mock)
+
+        with patch:
+            metadata = self._call_fut(metadata_key)
+
+        self.assertEqual(metadata, response_text)
+
+    def test_metadata_does_not_exist(self):
+        status_code_ok = 200
+        status_code_not_found = 404
+        metadata_key = "test_key"
+
+        response_mock = ResponseMock(status_code=status_code_not_found)
+
+        requests_mock = mock.Mock()
+        requests_mock.get.return_value = response_mock
+        requests_mock.codes.ok = status_code_ok
+
+        patch = mock.patch("google.cloud.logging._helpers.requests", requests_mock)
+
+        with patch:
+            metadata = self._call_fut(metadata_key)
+
+        self.assertIsNone(metadata)
+
+    def test_request_exception(self):
+        import requests
+
+        metadata_key = "test_url_cannot_connect"
+        metadata_url = "http://metadata.invalid/"
+
+        requests_get_mock = mock.Mock(spec=["__call__"])
+        requests_get_mock.side_effect = requests.exceptions.RequestException
+
+        requests_get_patch = mock.patch("requests.get", requests_get_mock)
+
+        url_patch = mock.patch(
+            "google.cloud.logging._helpers.METADATA_URL", new=metadata_url
+        )
+
+        with requests_get_patch:
+            with url_patch:
+                metadata = self._call_fut(metadata_key)
+
+        self.assertIsNone(metadata)
+
+
+class Test__normalize_severity(unittest.TestCase):
+    @staticmethod
+    def _stackdriver_severity():
+        from google.cloud.logging._helpers import LogSeverity
+
+        return LogSeverity
+
+    def _normalize_severity_helper(self, stdlib_level, enum_level):
+        from google.cloud.logging._helpers import _normalize_severity
+
+        self.assertEqual(_normalize_severity(stdlib_level), enum_level)
+
+    def test__normalize_severity_critical(self):
+        severity = self._stackdriver_severity()
+        self._normalize_severity_helper(logging.CRITICAL, severity.CRITICAL)
+
+    def test__normalize_severity_error(self):
+        severity = self._stackdriver_severity()
+        self._normalize_severity_helper(logging.ERROR, severity.ERROR)
+
+    def test__normalize_severity_warning(self):
+        severity = self._stackdriver_severity()
+        self._normalize_severity_helper(logging.WARNING, severity.WARNING)
+
+    def test__normalize_severity_info(self):
+        severity = self._stackdriver_severity()
+        self._normalize_severity_helper(logging.INFO, severity.INFO)
+
+    def test__normalize_severity_debug(self):
+        severity = self._stackdriver_severity()
+        self._normalize_severity_helper(logging.DEBUG, severity.DEBUG)
+
+    def test__normalize_severity_notset(self):
+        severity = self._stackdriver_severity()
+        self._normalize_severity_helper(logging.NOTSET, severity.DEFAULT)
+
+    def test__normalize_severity_non_standard(self):
+        unknown_level = 35
+        self._normalize_severity_helper(unknown_level, unknown_level)
+
+
+class EntryMock(object):
+    def __init__(self):
+        self.sentinel = object()
+        self.called = None
+
+    def from_api_repr(self, resource, client, loggers):
+        self.called = (resource, client, loggers)
+        return self.sentinel
+
+
+class ResponseMock(object):
+    def __init__(self, status_code, text="test_response_text"):
+        self.status_code = status_code
+        self.text = text
diff --git a/logging/tests/unit/test__http.py b/logging/tests/unit/test__http.py
new file mode 100644
index 000000000000..30fef253af0c
--- /dev/null
+++ b/logging/tests/unit/test__http.py
@@ -0,0 +1,848 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestConnection(unittest.TestCase):
+
+    PROJECT = "project"
+    FILTER = "logName:syslog AND severity>=ERROR"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_default_url(self):
+        client = object()
+        conn = self._make_one(client)
+        self.assertIs(conn._client, client)
+
+    def test_build_api_url_w_custom_endpoint(self):
+        custom_endpoint = "https://foo-logging.googleapis.com"
+        conn = self._make_one(object(), api_endpoint=custom_endpoint)
+        URI = "/".join([custom_endpoint, conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_extra_headers(self):
+        import requests
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
+
+
+class Test_LoggingAPI(unittest.TestCase):
+
+    PROJECT = "project"
+    LIST_ENTRIES_PATH = "entries:list"
+    WRITE_ENTRIES_PATH = "entries:write"
+    LOGGER_NAME = "LOGGER_NAME"
+    FILTER = "logName:syslog AND severity>=ERROR"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging._http import _LoggingAPI
+
+        return _LoggingAPI
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        connection = _Connection()
+        client = _Client(connection)
+        api = self._make_one(client)
+        self.assertIs(api._client, client)
+        self.assertEqual(api.api_request, connection.api_request)
+
+    @staticmethod
+    def _make_timestamp():
+        import datetime
+        from google.cloud._helpers import UTC
+
+        NOW = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        return NOW, _datetime_to_rfc3339_w_nanos(NOW)
+
+    def test_list_entries_no_paging(self):
+        import six
+        from google.cloud.logging.client import Client
+        from google.cloud.logging.entries import TextEntry
+        from google.cloud.logging.logger import Logger
+
+        NOW, TIMESTAMP = self._make_timestamp()
+        IID = "IID"
+        TEXT = "TEXT"
+        SENT = {"projectIds": [self.PROJECT]}
+        TOKEN = "TOKEN"
+        RETURNED = {
+            "entries": [
+                {
+                    "textPayload": TEXT,
+                    "insertId": IID,
+                    "resource": {"type": "global"},
+                    "timestamp": TIMESTAMP,
+                    "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                }
+            ],
+            "nextPageToken": TOKEN,
+        }
+        client = Client(
+            project=self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        client._connection = _Connection(RETURNED)
+        api = self._make_one(client)
+
+        iterator = api.list_entries([self.PROJECT])
+        page = six.next(iterator.pages)
+        entries = list(page)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertEqual(token, TOKEN)
+        # Then check the entries returned.
+        self.assertEqual(len(entries), 1)
+        entry = entries[0]
+        self.assertIsInstance(entry, TextEntry)
+        self.assertEqual(entry.payload, TEXT)
+        self.assertIsInstance(entry.logger, Logger)
+        self.assertEqual(entry.logger.name, self.LOGGER_NAME)
+        self.assertEqual(entry.insert_id, IID)
+        self.assertEqual(entry.timestamp, NOW)
+        self.assertIsNone(entry.labels)
+        self.assertIsNone(entry.severity)
+        self.assertIsNone(entry.http_request)
+
+        called_with = client._connection._called_with
+        expected_path = "/%s" % (self.LIST_ENTRIES_PATH,)
+        self.assertEqual(
+            called_with, {"method": "POST", "path": expected_path, "data": SENT}
+        )
+
+    def test_list_entries_w_paging(self):
+        from google.cloud.logging import DESCENDING
+        from google.cloud.logging.client import Client
+        from google.cloud.logging.logger import Logger
+        from google.cloud.logging.entries import ProtobufEntry
+        from google.cloud.logging.entries import StructEntry
+
+        PROJECT1 = "PROJECT1"
+        PROJECT2 = "PROJECT2"
+        NOW, TIMESTAMP = self._make_timestamp()
+        IID1 = "IID1"
+        IID2 = "IID2"
+        PAYLOAD = {"message": "MESSAGE", "weather": "partly cloudy"}
+        PROTO_PAYLOAD = PAYLOAD.copy()
+        PROTO_PAYLOAD["@type"] = "type.googleapis.com/testing.example"
+        TOKEN = "TOKEN"
+        PAGE_SIZE = 42
+        SENT = {
+            "projectIds": [PROJECT1, PROJECT2],
+            "filter": self.FILTER,
+            "orderBy": DESCENDING,
+            "pageSize": PAGE_SIZE,
+            "pageToken": TOKEN,
+        }
+        RETURNED = {
+            "entries": [
+                {
+                    "jsonPayload": PAYLOAD,
+                    "insertId": IID1,
+                    "resource": {"type": "global"},
+                    "timestamp": TIMESTAMP,
+                    "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                },
+                {
+                    "protoPayload": PROTO_PAYLOAD,
+                    "insertId": IID2,
+                    "resource": {"type": "global"},
+                    "timestamp": TIMESTAMP,
+                    "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                },
+            ]
+        }
+        client = Client(
+            project=self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        client._connection = _Connection(RETURNED)
+        api = self._make_one(client)
+
+        iterator = api.list_entries(
+            projects=[PROJECT1, PROJECT2],
+            filter_=self.FILTER,
+            order_by=DESCENDING,
+            page_size=PAGE_SIZE,
+            page_token=TOKEN,
+        )
+        entries = list(iterator)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertIsNone(token)
+        # Then check the entries returned.
+        self.assertEqual(len(entries), 2)
+        entry1 = entries[0]
+        self.assertIsInstance(entry1, StructEntry)
+        self.assertEqual(entry1.payload, PAYLOAD)
+        self.assertIsInstance(entry1.logger, Logger)
+        self.assertEqual(entry1.logger.name, self.LOGGER_NAME)
+        self.assertEqual(entry1.insert_id, IID1)
+        self.assertEqual(entry1.timestamp, NOW)
+        self.assertIsNone(entry1.labels)
+        self.assertIsNone(entry1.severity)
+        self.assertIsNone(entry1.http_request)
+
+        entry2 = entries[1]
+        self.assertIsInstance(entry2, ProtobufEntry)
+        self.assertEqual(entry2.payload, PROTO_PAYLOAD)
+        self.assertIsInstance(entry2.logger, Logger)
+        self.assertEqual(entry2.logger.name, self.LOGGER_NAME)
+        self.assertEqual(entry2.insert_id, IID2)
+        self.assertEqual(entry2.timestamp, NOW)
+        self.assertIsNone(entry2.labels)
+        self.assertIsNone(entry2.severity)
+        self.assertIsNone(entry2.http_request)
+
+        called_with = client._connection._called_with
+        expected_path = "/%s" % (self.LIST_ENTRIES_PATH,)
+        self.assertEqual(
+            called_with, {"method": "POST", "path": expected_path, "data": SENT}
+        )
+
+    def test_write_entries_single(self):
+        TEXT = "TEXT"
+        ENTRY = {
+            "textPayload": TEXT,
+            "resource": {"type": "global"},
+            "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+        }
+        SENT = {"entries": [ENTRY]}
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.write_entries([ENTRY])
+
+        self.assertEqual(conn._called_with["method"], "POST")
+        path = "/%s" % self.WRITE_ENTRIES_PATH
+        self.assertEqual(conn._called_with["path"], path)
+        self.assertEqual(conn._called_with["data"], SENT)
+
+    def test_write_entries_multiple(self):
+        TEXT = "TEXT"
+        LOG_NAME = "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        RESOURCE = {"type": "global"}
+        LABELS = {"baz": "qux", "spam": "eggs"}
+        ENTRY1 = {"textPayload": TEXT}
+        ENTRY2 = {"jsonPayload": {"foo": "bar"}}
+        SENT = {
+            "logName": LOG_NAME,
+            "resource": RESOURCE,
+            "labels": LABELS,
+            "entries": [ENTRY1, ENTRY2],
+        }
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.write_entries([ENTRY1, ENTRY2], LOG_NAME, RESOURCE, LABELS)
+
+        self.assertEqual(conn._called_with["method"], "POST")
+        path = "/%s" % self.WRITE_ENTRIES_PATH
+        self.assertEqual(conn._called_with["path"], path)
+        self.assertEqual(conn._called_with["data"], SENT)
+
+    def test_logger_delete(self):
+        path = "/projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.logger_delete(self.PROJECT, self.LOGGER_NAME)
+
+        self.assertEqual(conn._called_with["method"], "DELETE")
+        self.assertEqual(conn._called_with["path"], path)
+
+
+class Test_SinksAPI(unittest.TestCase):
+
+    PROJECT = "project"
+    FILTER = "logName:syslog AND severity>=ERROR"
+    LIST_SINKS_PATH = "projects/%s/sinks" % (PROJECT,)
+    SINK_NAME = "sink_name"
+    SINK_PATH = "projects/%s/sinks/%s" % (PROJECT, SINK_NAME)
+    DESTINATION_URI = "faux.googleapis.com/destination"
+    WRITER_IDENTITY = "serviceAccount:project-123@example.com"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging._http import _SinksAPI
+
+        return _SinksAPI
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        connection = _Connection()
+        client = _Client(connection)
+        api = self._make_one(client)
+        self.assertIs(api._client, client)
+        self.assertEqual(api.api_request, connection.api_request)
+
+    def test_list_sinks_no_paging(self):
+        import six
+        from google.cloud.logging.sink import Sink
+
+        TOKEN = "TOKEN"
+        RETURNED = {
+            "sinks": [
+                {
+                    "name": self.SINK_PATH,
+                    "filter": self.FILTER,
+                    "destination": self.DESTINATION_URI,
+                }
+            ],
+            "nextPageToken": TOKEN,
+        }
+        conn = _Connection(RETURNED)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        iterator = api.list_sinks(self.PROJECT)
+        page = six.next(iterator.pages)
+        sinks = list(page)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertEqual(token, TOKEN)
+        # Then check the sinks returned.
+        self.assertEqual(len(sinks), 1)
+        sink = sinks[0]
+        self.assertIsInstance(sink, Sink)
+        self.assertEqual(sink.name, self.SINK_PATH)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIs(sink.client, client)
+
+        called_with = conn._called_with
+        path = "/%s" % (self.LIST_SINKS_PATH,)
+        self.assertEqual(
+            called_with, {"method": "GET", "path": path, "query_params": {}}
+        )
+
+    def test_list_sinks_w_paging(self):
+        from google.cloud.logging.sink import Sink
+
+        TOKEN = "TOKEN"
+        PAGE_SIZE = 42
+        RETURNED = {
+            "sinks": [
+                {
+                    "name": self.SINK_PATH,
+                    "filter": self.FILTER,
+                    "destination": self.DESTINATION_URI,
+                }
+            ]
+        }
+        conn = _Connection(RETURNED)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        iterator = api.list_sinks(self.PROJECT, page_size=PAGE_SIZE, page_token=TOKEN)
+        sinks = list(iterator)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertIsNone(token)
+        # Then check the sinks returned.
+        self.assertEqual(len(sinks), 1)
+        sink = sinks[0]
+        self.assertIsInstance(sink, Sink)
+        self.assertEqual(sink.name, self.SINK_PATH)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIs(sink.client, client)
+
+        called_with = conn._called_with
+        path = "/%s" % (self.LIST_SINKS_PATH,)
+        self.assertEqual(
+            called_with,
+            {
+                "method": "GET",
+                "path": path,
+                "query_params": {"pageSize": PAGE_SIZE, "pageToken": TOKEN},
+            },
+        )
+
+    def test_sink_create_conflict(self):
+        from google.cloud.exceptions import Conflict
+
+        sent = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+        conn = _Connection()
+        conn._raise_conflict = True
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(Conflict):
+            api.sink_create(
+                self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI
+            )
+
+        path = "/projects/%s/sinks" % (self.PROJECT,)
+        expected = {
+            "method": "POST",
+            "path": path,
+            "data": sent,
+            "query_params": {"uniqueWriterIdentity": False},
+        }
+        self.assertEqual(conn._called_with, expected)
+
+    def test_sink_create_ok(self):
+        sent = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+        after_create = sent.copy()
+        after_create["writerIdentity"] = self.WRITER_IDENTITY
+        conn = _Connection(after_create)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        returned = api.sink_create(
+            self.PROJECT,
+            self.SINK_NAME,
+            self.FILTER,
+            self.DESTINATION_URI,
+            unique_writer_identity=True,
+        )
+
+        self.assertEqual(returned, after_create)
+        path = "/projects/%s/sinks" % (self.PROJECT,)
+        expected = {
+            "method": "POST",
+            "path": path,
+            "data": sent,
+            "query_params": {"uniqueWriterIdentity": True},
+        }
+        self.assertEqual(conn._called_with, expected)
+
+    def test_sink_get_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        conn = _Connection()
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(NotFound):
+            api.sink_get(self.PROJECT, self.SINK_NAME)
+
+        self.assertEqual(conn._called_with["method"], "GET")
+        path = "/projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+    def test_sink_get_hit(self):
+        RESPONSE = {
+            "name": self.SINK_PATH,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+        conn = _Connection(RESPONSE)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        response = api.sink_get(self.PROJECT, self.SINK_NAME)
+
+        self.assertEqual(response, RESPONSE)
+        self.assertEqual(conn._called_with["method"], "GET")
+        path = "/projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+    def test_sink_update_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        sent = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+        conn = _Connection()
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(NotFound):
+            api.sink_update(
+                self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI
+            )
+
+        path = "/projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        expected = {
+            "method": "PUT",
+            "path": path,
+            "data": sent,
+            "query_params": {"uniqueWriterIdentity": False},
+        }
+        self.assertEqual(conn._called_with, expected)
+
+    def test_sink_update_hit(self):
+        sent = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+        after_update = sent.copy()
+        after_update["writerIdentity"] = self.WRITER_IDENTITY
+        conn = _Connection(after_update)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        returned = api.sink_update(
+            self.PROJECT,
+            self.SINK_NAME,
+            self.FILTER,
+            self.DESTINATION_URI,
+            unique_writer_identity=True,
+        )
+
+        self.assertEqual(returned, after_update)
+        path = "/projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        expected = {
+            "method": "PUT",
+            "path": path,
+            "data": sent,
+            "query_params": {"uniqueWriterIdentity": True},
+        }
+        self.assertEqual(conn._called_with, expected)
+
+    def test_sink_delete_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        conn = _Connection()
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(NotFound):
+            api.sink_delete(self.PROJECT, self.SINK_NAME)
+
+        self.assertEqual(conn._called_with["method"], "DELETE")
+        path = "/projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+    def test_sink_delete_hit(self):
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.sink_delete(self.PROJECT, self.SINK_NAME)
+
+        self.assertEqual(conn._called_with["method"], "DELETE")
+        path = "/projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+
+class Test_MetricsAPI(unittest.TestCase):
+
+    PROJECT = "project"
+    FILTER = "logName:syslog AND severity>=ERROR"
+    LIST_METRICS_PATH = "projects/%s/metrics" % (PROJECT,)
+    METRIC_NAME = "metric_name"
+    METRIC_PATH = "projects/%s/metrics/%s" % (PROJECT, METRIC_NAME)
+    DESCRIPTION = "DESCRIPTION"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging._http import _MetricsAPI
+
+        return _MetricsAPI
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_list_metrics_no_paging(self):
+        import six
+        from google.cloud.logging.metric import Metric
+
+        TOKEN = "TOKEN"
+        RETURNED = {
+            "metrics": [{"name": self.METRIC_PATH, "filter": self.FILTER}],
+            "nextPageToken": TOKEN,
+        }
+        conn = _Connection(RETURNED)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        iterator = api.list_metrics(self.PROJECT)
+        page = six.next(iterator.pages)
+        metrics = list(page)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertEqual(token, TOKEN)
+        # Then check the metrics returned.
+        self.assertEqual(len(metrics), 1)
+        metric = metrics[0]
+        self.assertIsInstance(metric, Metric)
+        self.assertEqual(metric.name, self.METRIC_PATH)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, "")
+        self.assertIs(metric.client, client)
+
+        called_with = conn._called_with
+        path = "/%s" % (self.LIST_METRICS_PATH,)
+        self.assertEqual(
+            called_with, {"method": "GET", "path": path, "query_params": {}}
+        )
+
+    def test_list_metrics_w_paging(self):
+        from google.cloud.logging.metric import Metric
+
+        TOKEN = "TOKEN"
+        PAGE_SIZE = 42
+        RETURNED = {"metrics": [{"name": self.METRIC_PATH, "filter": self.FILTER}]}
+        conn = _Connection(RETURNED)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        iterator = api.list_metrics(self.PROJECT, page_size=PAGE_SIZE, page_token=TOKEN)
+        metrics = list(iterator)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertIsNone(token)
+        # Then check the metrics returned.
+        self.assertEqual(len(metrics), 1)
+        metric = metrics[0]
+        self.assertIsInstance(metric, Metric)
+        self.assertEqual(metric.name, self.METRIC_PATH)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, "")
+        self.assertIs(metric.client, client)
+
+        called_with = conn._called_with
+        path = "/%s" % (self.LIST_METRICS_PATH,)
+        self.assertEqual(
+            called_with,
+            {
+                "method": "GET",
+                "path": path,
+                "query_params": {"pageSize": PAGE_SIZE, "pageToken": TOKEN},
+            },
+        )
+
+    def test_metric_create_conflict(self):
+        from google.cloud.exceptions import Conflict
+
+        SENT = {
+            "name": self.METRIC_NAME,
+            "filter": self.FILTER,
+            "description": self.DESCRIPTION,
+        }
+        conn = _Connection()
+        conn._raise_conflict = True
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(Conflict):
+            api.metric_create(
+                self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION
+            )
+
+        self.assertEqual(conn._called_with["method"], "POST")
+        path = "/projects/%s/metrics" % (self.PROJECT,)
+        self.assertEqual(conn._called_with["path"], path)
+        self.assertEqual(conn._called_with["data"], SENT)
+
+    def test_metric_create_ok(self):
+        SENT = {
+            "name": self.METRIC_NAME,
+            "filter": self.FILTER,
+            "description": self.DESCRIPTION,
+        }
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.metric_create(self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
+
+        self.assertEqual(conn._called_with["method"], "POST")
+        path = "/projects/%s/metrics" % (self.PROJECT,)
+        self.assertEqual(conn._called_with["path"], path)
+        self.assertEqual(conn._called_with["data"], SENT)
+
+    def test_metric_get_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        conn = _Connection()
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(NotFound):
+            api.metric_get(self.PROJECT, self.METRIC_NAME)
+
+        self.assertEqual(conn._called_with["method"], "GET")
+        path = "/projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+    def test_metric_get_hit(self):
+        RESPONSE = {
+            "name": self.METRIC_NAME,
+            "filter": self.FILTER,
+            "description": self.DESCRIPTION,
+        }
+        conn = _Connection(RESPONSE)
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        response = api.metric_get(self.PROJECT, self.METRIC_NAME)
+
+        self.assertEqual(response, RESPONSE)
+        self.assertEqual(conn._called_with["method"], "GET")
+        path = "/projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+    def test_metric_update_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        SENT = {
+            "name": self.METRIC_NAME,
+            "filter": self.FILTER,
+            "description": self.DESCRIPTION,
+        }
+        conn = _Connection()
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(NotFound):
+            api.metric_update(
+                self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION
+            )
+
+        self.assertEqual(conn._called_with["method"], "PUT")
+        path = "/projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+        self.assertEqual(conn._called_with["data"], SENT)
+
+    def test_metric_update_hit(self):
+        SENT = {
+            "name": self.METRIC_NAME,
+            "filter": self.FILTER,
+            "description": self.DESCRIPTION,
+        }
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.metric_update(self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
+
+        self.assertEqual(conn._called_with["method"], "PUT")
+        path = "/projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+        self.assertEqual(conn._called_with["data"], SENT)
+
+    def test_metric_delete_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        conn = _Connection()
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        with self.assertRaises(NotFound):
+            api.metric_delete(self.PROJECT, self.METRIC_NAME)
+
+        self.assertEqual(conn._called_with["method"], "DELETE")
+        path = "/projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+    def test_metric_delete_hit(self):
+        conn = _Connection({})
+        client = _Client(conn)
+        api = self._make_one(client)
+
+        api.metric_delete(self.PROJECT, self.METRIC_NAME)
+
+        self.assertEqual(conn._called_with["method"], "DELETE")
+        path = "/projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        self.assertEqual(conn._called_with["path"], path)
+
+
+class _Connection(object):
+
+    _called_with = None
+    _raise_conflict = False
+
+    def __init__(self, *responses):
+        self._responses = responses
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import Conflict
+        from google.cloud.exceptions import NotFound
+
+        self._called_with = kw
+        if self._raise_conflict:
+            raise Conflict("oops")
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        return response
+
+
+def _datetime_to_rfc3339_w_nanos(value):
+    from google.cloud._helpers import _RFC3339_NO_FRACTION
+
+    no_fraction = value.strftime(_RFC3339_NO_FRACTION)
+    return "%s.%09dZ" % (no_fraction, value.microsecond * 1000)
+
+
+class _Client(object):
+    def __init__(self, connection):
+        self._connection = connection
diff --git a/logging/tests/unit/test_client.py b/logging/tests/unit/test_client.py
new file mode 100644
index 000000000000..5acd736185fc
--- /dev/null
+++ b/logging/tests/unit/test_client.py
@@ -0,0 +1,738 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    LOGGER_NAME = "LOGGER_NAME"
+    SINK_NAME = "SINK_NAME"
+    FILTER = "logName:syslog AND severity>=ERROR"
+    DESTINATION_URI = "faux.googleapis.com/destination"
+    METRIC_NAME = "metric_name"
+    FILTER = "logName:syslog AND severity>=ERROR"
+    DESCRIPTION = "DESCRIPTION"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.logging._http import Connection
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIsInstance(client._connection._client_info, ClientInfo)
+
+    def test_ctor_explicit(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.logging._http import Connection
+
+        creds = _make_credentials()
+        client_info = ClientInfo()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, client_info=client_info
+        )
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertIs(client._client_info, client_info)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection._client_info, client_info)
+
+    def test_ctor_w_empty_client_options(self):
+        from google.api_core.client_options import ClientOptions
+
+        creds = _make_credentials()
+        client_options = ClientOptions()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, client_options=client_options
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, client._connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_ctor_w_client_options_object(self):
+        from google.api_core.client_options import ClientOptions
+
+        creds = _make_credentials()
+        client_options = ClientOptions(
+            api_endpoint="https://foo-logging.googleapis.com"
+        )
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, client_options=client_options
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://foo-logging.googleapis.com"
+        )
+
+    def test_ctor_w_client_options_dict(self):
+        creds = _make_credentials()
+        client_options = {"api_endpoint": "https://foo-logging.googleapis.com"}
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, client_options=client_options
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://foo-logging.googleapis.com"
+        )
+
+    def test_logging_api_wo_gapic(self):
+        from google.cloud.logging._http import _LoggingAPI
+
+        client = self._make_one(
+            self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+
+        conn = client._connection = _Connection()
+        api = client.logging_api
+
+        self.assertIsInstance(api, _LoggingAPI)
+        self.assertEqual(api.api_request, conn.api_request)
+        # API instance is cached
+        again = client.logging_api
+        self.assertIs(again, api)
+
+    def test_logging_api_w_gapic(self):
+        clients = []
+        api_obj = object()
+
+        def make_api(client_obj):
+            clients.append(client_obj)
+            return api_obj
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _use_grpc=True)
+
+        patch = mock.patch("google.cloud.logging.client._gapic")
+        with patch as gapic_module:
+            gapic_module.make_logging_api.side_effect = make_api
+            api = client.logging_api
+
+        self.assertIs(api, api_obj)
+        self.assertEqual(clients, [client])
+        # API instance is cached
+        again = client.logging_api
+        self.assertIs(again, api)
+
+    def test_no_gapic_ctor(self):
+        from google.cloud.logging._http import _LoggingAPI
+
+        creds = _make_credentials()
+        patch = mock.patch("google.cloud.logging.client._USE_GRPC", new=True)
+        with patch:
+            client = self._make_one(
+                project=self.PROJECT, credentials=creds, _use_grpc=False
+            )
+
+        api = client.logging_api
+        self.assertIsInstance(api, _LoggingAPI)
+
+    def test_sinks_api_wo_gapic(self):
+        from google.cloud.logging._http import _SinksAPI
+
+        client = self._make_one(
+            self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+
+        conn = client._connection = _Connection()
+        api = client.sinks_api
+
+        self.assertIsInstance(api, _SinksAPI)
+        self.assertEqual(api.api_request, conn.api_request)
+        # API instance is cached
+        again = client.sinks_api
+        self.assertIs(again, api)
+
+    def test_sinks_api_w_gapic(self):
+        clients = []
+        api_obj = object()
+
+        def make_api(client_obj):
+            clients.append(client_obj)
+            return api_obj
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _use_grpc=True)
+
+        patch = mock.patch("google.cloud.logging.client._gapic")
+        with patch as gapic_module:
+            gapic_module.make_sinks_api.side_effect = make_api
+            api = client.sinks_api
+
+        self.assertIs(api, api_obj)
+        self.assertEqual(clients, [client])
+        # API instance is cached
+        again = client.sinks_api
+        self.assertIs(again, api)
+
+    def test_metrics_api_wo_gapic(self):
+        from google.cloud.logging._http import _MetricsAPI
+
+        client = self._make_one(
+            self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+
+        conn = client._connection = _Connection()
+        api = client.metrics_api
+
+        self.assertIsInstance(api, _MetricsAPI)
+        self.assertEqual(api.api_request, conn.api_request)
+        # API instance is cached
+        again = client.metrics_api
+        self.assertIs(again, api)
+
+    def test_metrics_api_w_gapic(self):
+        clients = []
+        api_obj = object()
+
+        def make_api(client_obj):
+            clients.append(client_obj)
+            return api_obj
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds, _use_grpc=True)
+
+        patch = mock.patch("google.cloud.logging.client._gapic")
+        with patch as gapic_module:
+            gapic_module.make_metrics_api.side_effect = make_api
+            api = client.metrics_api
+
+        self.assertIs(api, api_obj)
+        self.assertEqual(clients, [client])
+        # API instance is cached
+        again = client.metrics_api
+        self.assertIs(again, api)
+
+    def test_logger(self):
+        from google.cloud.logging.logger import Logger
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        logger = client.logger(self.LOGGER_NAME)
+        self.assertIsInstance(logger, Logger)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.project, self.PROJECT)
+
+    def test_list_entries_defaults(self):
+        import six
+        from google.cloud.logging.entries import TextEntry
+
+        IID = "IID"
+        TEXT = "TEXT"
+        TOKEN = "TOKEN"
+        ENTRIES = [
+            {
+                "textPayload": TEXT,
+                "insertId": IID,
+                "resource": {"type": "global"},
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+            }
+        ]
+        creds = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, _use_grpc=False
+        )
+        returned = {"entries": ENTRIES, "nextPageToken": TOKEN}
+        client._connection = _Connection(returned)
+
+        iterator = client.list_entries()
+        page = six.next(iterator.pages)
+        entries = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(entries), 1)
+        entry = entries[0]
+        self.assertIsInstance(entry, TextEntry)
+        self.assertEqual(entry.insert_id, IID)
+        self.assertEqual(entry.payload, TEXT)
+        logger = entry.logger
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.project, self.PROJECT)
+        self.assertEqual(token, TOKEN)
+
+        called_with = client._connection._called_with
+        self.assertEqual(
+            called_with,
+            {
+                "path": "/entries:list",
+                "method": "POST",
+                "data": {"projectIds": [self.PROJECT]},
+            },
+        )
+
+    def test_list_entries_explicit(self):
+        from google.cloud.logging import DESCENDING
+        from google.cloud.logging.entries import ProtobufEntry
+        from google.cloud.logging.entries import StructEntry
+        from google.cloud.logging.logger import Logger
+
+        PROJECT1 = "PROJECT1"
+        PROJECT2 = "PROJECT2"
+        FILTER = "logName:LOGNAME"
+        IID1 = "IID1"
+        IID2 = "IID2"
+        PAYLOAD = {"message": "MESSAGE", "weather": "partly cloudy"}
+        PROTO_PAYLOAD = PAYLOAD.copy()
+        PROTO_PAYLOAD["@type"] = "type.googleapis.com/testing.example"
+        TOKEN = "TOKEN"
+        PAGE_SIZE = 42
+        ENTRIES = [
+            {
+                "jsonPayload": PAYLOAD,
+                "insertId": IID1,
+                "resource": {"type": "global"},
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+            },
+            {
+                "protoPayload": PROTO_PAYLOAD,
+                "insertId": IID2,
+                "resource": {"type": "global"},
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+            },
+        ]
+        client = self._make_one(
+            self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        returned = {"entries": ENTRIES}
+        client._connection = _Connection(returned)
+
+        iterator = client.list_entries(
+            projects=[PROJECT1, PROJECT2],
+            filter_=FILTER,
+            order_by=DESCENDING,
+            page_size=PAGE_SIZE,
+            page_token=TOKEN,
+        )
+        entries = list(iterator)
+        token = iterator.next_page_token
+
+        # First, check the token.
+        self.assertIsNone(token)
+        # Then check the entries.
+        self.assertEqual(len(entries), 2)
+        entry = entries[0]
+        self.assertIsInstance(entry, StructEntry)
+        self.assertEqual(entry.insert_id, IID1)
+        self.assertEqual(entry.payload, PAYLOAD)
+        logger = entry.logger
+        self.assertIsInstance(logger, Logger)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.project, self.PROJECT)
+
+        entry = entries[1]
+        self.assertIsInstance(entry, ProtobufEntry)
+        self.assertEqual(entry.insert_id, IID2)
+        self.assertEqual(entry.payload, PROTO_PAYLOAD)
+        logger = entry.logger
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.project, self.PROJECT)
+
+        self.assertIs(entries[0].logger, entries[1].logger)
+
+        called_with = client._connection._called_with
+        self.assertEqual(
+            called_with,
+            {
+                "path": "/entries:list",
+                "method": "POST",
+                "data": {
+                    "filter": FILTER,
+                    "orderBy": DESCENDING,
+                    "pageSize": PAGE_SIZE,
+                    "pageToken": TOKEN,
+                    "projectIds": [PROJECT1, PROJECT2],
+                },
+            },
+        )
+
+    def test_sink_defaults(self):
+        from google.cloud.logging.sink import Sink
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        sink = client.sink(self.SINK_NAME)
+        self.assertIsInstance(sink, Sink)
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertIsNone(sink.filter_)
+        self.assertIsNone(sink.destination)
+        self.assertIs(sink.client, client)
+        self.assertEqual(sink.project, self.PROJECT)
+
+    def test_sink_explicit(self):
+        from google.cloud.logging.sink import Sink
+
+        creds = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=creds)
+        sink = client.sink(self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
+        self.assertIsInstance(sink, Sink)
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIs(sink.client, client)
+        self.assertEqual(sink.project, self.PROJECT)
+
+    def test_list_sinks_no_paging(self):
+        import six
+        from google.cloud.logging.sink import Sink
+
+        PROJECT = "PROJECT"
+        TOKEN = "TOKEN"
+        SINK_NAME = "sink_name"
+        FILTER = "logName:syslog AND severity>=ERROR"
+        SINKS = [
+            {"name": SINK_NAME, "filter": FILTER, "destination": self.DESTINATION_URI}
+        ]
+        client = self._make_one(
+            project=PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        returned = {"sinks": SINKS, "nextPageToken": TOKEN}
+        client._connection = _Connection(returned)
+
+        iterator = client.list_sinks()
+        page = six.next(iterator.pages)
+        sinks = list(page)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertEqual(token, TOKEN)
+        # Then check the sinks returned.
+        self.assertEqual(len(sinks), 1)
+        sink = sinks[0]
+        self.assertIsInstance(sink, Sink)
+        self.assertEqual(sink.name, SINK_NAME)
+        self.assertEqual(sink.filter_, FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIs(sink.client, client)
+
+        # Verify the mocked transport.
+        called_with = client._connection._called_with
+        path = "/projects/%s/sinks" % (self.PROJECT,)
+        self.assertEqual(
+            called_with, {"method": "GET", "path": path, "query_params": {}}
+        )
+
+    def test_list_sinks_with_paging(self):
+        from google.cloud.logging.sink import Sink
+
+        PROJECT = "PROJECT"
+        SINK_NAME = "sink_name"
+        FILTER = "logName:syslog AND severity>=ERROR"
+        TOKEN = "TOKEN"
+        PAGE_SIZE = 42
+        SINKS = [
+            {"name": SINK_NAME, "filter": FILTER, "destination": self.DESTINATION_URI}
+        ]
+        client = self._make_one(
+            project=PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        returned = {"sinks": SINKS}
+        client._connection = _Connection(returned)
+
+        iterator = client.list_sinks(PAGE_SIZE, TOKEN)
+        sinks = list(iterator)
+        token = iterator.next_page_token
+
+        # First check the token.
+        self.assertIsNone(token)
+        # Then check the sinks returned.
+        self.assertEqual(len(sinks), 1)
+        sink = sinks[0]
+        self.assertIsInstance(sink, Sink)
+        self.assertEqual(sink.name, SINK_NAME)
+        self.assertEqual(sink.filter_, FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIs(sink.client, client)
+
+        # Verify the mocked transport.
+        called_with = client._connection._called_with
+        path = "/projects/%s/sinks" % (self.PROJECT,)
+        self.assertEqual(
+            called_with,
+            {
+                "method": "GET",
+                "path": path,
+                "query_params": {"pageSize": PAGE_SIZE, "pageToken": TOKEN},
+            },
+        )
+
+    def test_metric_defaults(self):
+        from google.cloud.logging.metric import Metric
+
+        creds = _make_credentials()
+
+        client_obj = self._make_one(project=self.PROJECT, credentials=creds)
+        metric = client_obj.metric(self.METRIC_NAME)
+        self.assertIsInstance(metric, Metric)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertIsNone(metric.filter_)
+        self.assertEqual(metric.description, "")
+        self.assertIs(metric.client, client_obj)
+        self.assertEqual(metric.project, self.PROJECT)
+
+    def test_metric_explicit(self):
+        from google.cloud.logging.metric import Metric
+
+        creds = _make_credentials()
+
+        client_obj = self._make_one(project=self.PROJECT, credentials=creds)
+        metric = client_obj.metric(
+            self.METRIC_NAME, self.FILTER, description=self.DESCRIPTION
+        )
+        self.assertIsInstance(metric, Metric)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, self.DESCRIPTION)
+        self.assertIs(metric.client, client_obj)
+        self.assertEqual(metric.project, self.PROJECT)
+
+    def test_list_metrics_no_paging(self):
+        from google.cloud.logging.metric import Metric
+
+        metrics = [
+            {
+                "name": self.METRIC_NAME,
+                "filter": self.FILTER,
+                "description": self.DESCRIPTION,
+            }
+        ]
+        client = self._make_one(
+            project=self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        returned = {"metrics": metrics}
+        client._connection = _Connection(returned)
+
+        # Execute request.
+        iterator = client.list_metrics()
+        metrics = list(iterator)
+
+        # Check the metrics returned.
+        self.assertEqual(len(metrics), 1)
+        metric = metrics[0]
+        self.assertIsInstance(metric, Metric)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, self.DESCRIPTION)
+        self.assertIs(metric.client, client)
+
+        # Verify mocked transport.
+        called_with = client._connection._called_with
+        path = "/projects/%s/metrics" % (self.PROJECT,)
+        self.assertEqual(
+            called_with, {"method": "GET", "path": path, "query_params": {}}
+        )
+
+    def test_list_metrics_with_paging(self):
+        import six
+        from google.cloud.logging.metric import Metric
+
+        token = "TOKEN"
+        next_token = "T00KEN"
+        page_size = 42
+        metrics = [
+            {
+                "name": self.METRIC_NAME,
+                "filter": self.FILTER,
+                "description": self.DESCRIPTION,
+            }
+        ]
+        client = self._make_one(
+            project=self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        returned = {"metrics": metrics, "nextPageToken": next_token}
+        client._connection = _Connection(returned)
+
+        # Execute request.
+        iterator = client.list_metrics(page_size, token)
+        page = six.next(iterator.pages)
+        metrics = list(page)
+
+        # First check the token.
+        self.assertEqual(iterator.next_page_token, next_token)
+        # Then check the metrics returned.
+        self.assertEqual(len(metrics), 1)
+        metric = metrics[0]
+        self.assertIsInstance(metric, Metric)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, self.DESCRIPTION)
+        self.assertIs(metric.client, client)
+
+        # Verify mocked transport.
+        called_with = client._connection._called_with
+        path = "/projects/%s/metrics" % (self.PROJECT,)
+        self.assertEqual(
+            called_with,
+            {
+                "method": "GET",
+                "path": path,
+                "query_params": {"pageSize": page_size, "pageToken": token},
+            },
+        )
+
+    def test_get_default_handler_app_engine(self):
+        import os
+        from google.cloud._testing import _Monkey
+        from google.cloud.logging.client import _APPENGINE_FLEXIBLE_ENV_VM
+        from google.cloud.logging.handlers import AppEngineHandler
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=False
+        )
+
+        with _Monkey(os, environ={_APPENGINE_FLEXIBLE_ENV_VM: "True"}):
+            handler = client.get_default_handler()
+
+        handler.transport.worker.stop()
+
+        self.assertIsInstance(handler, AppEngineHandler)
+
+    def test_get_default_handler_container_engine(self):
+        from google.cloud.logging.handlers import ContainerEngineHandler
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=False
+        )
+
+        patch = mock.patch(
+            "google.cloud.logging.client.retrieve_metadata_server",
+            return_value="test-gke-cluster",
+        )
+
+        with patch:
+            handler = client.get_default_handler()
+
+        self.assertIsInstance(handler, ContainerEngineHandler)
+
+    def test_get_default_handler_general(self):
+        import io
+        from google.cloud.logging.handlers import CloudLoggingHandler
+        from google.cloud.logging.resource import Resource
+
+        name = "test-logger"
+        resource = Resource("resource_type", {"resource_label": "value"})
+        labels = {"handler_label": "value"}
+        stream = io.BytesIO()
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=False
+        )
+
+        handler = client.get_default_handler(
+            name=name, resource=resource, labels=labels, stream=stream
+        )
+
+        handler.transport.worker.stop()
+
+        self.assertIsInstance(handler, CloudLoggingHandler)
+        self.assertEqual(handler.name, name)
+        self.assertEqual(handler.resource, resource)
+        self.assertEqual(handler.labels, labels)
+
+    def test_setup_logging(self):
+        from google.cloud.logging.handlers import CloudLoggingHandler
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=False
+        )
+
+        with mock.patch("google.cloud.logging.client.setup_logging") as mocked:
+            client.setup_logging()
+
+        self.assertEqual(len(mocked.mock_calls), 1)
+        _, args, kwargs = mocked.mock_calls[0]
+
+        handler, = args
+        self.assertIsInstance(handler, CloudLoggingHandler)
+
+        handler.transport.worker.stop()
+
+        expected_kwargs = {
+            "excluded_loggers": ("google.cloud", "google.auth", "google_auth_httplib2"),
+            "log_level": 20,
+        }
+        self.assertEqual(kwargs, expected_kwargs)
+
+    def test_setup_logging_w_extra_kwargs(self):
+        import io
+        from google.cloud.logging.handlers import CloudLoggingHandler
+        from google.cloud.logging.resource import Resource
+
+        name = "test-logger"
+        resource = Resource("resource_type", {"resource_label": "value"})
+        labels = {"handler_label": "value"}
+        stream = io.BytesIO()
+
+        credentials = _make_credentials()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, _use_grpc=False
+        )
+
+        with mock.patch("google.cloud.logging.client.setup_logging") as mocked:
+            client.setup_logging(
+                name=name, resource=resource, labels=labels, stream=stream
+            )
+
+        self.assertEqual(len(mocked.mock_calls), 1)
+        _, args, kwargs = mocked.mock_calls[0]
+
+        handler, = args
+        self.assertIsInstance(handler, CloudLoggingHandler)
+        self.assertEqual(handler.name, name)
+        self.assertEqual(handler.resource, resource)
+        self.assertEqual(handler.labels, labels)
+
+        handler.transport.worker.stop()
+
+        expected_kwargs = {
+            "excluded_loggers": ("google.cloud", "google.auth", "google_auth_httplib2"),
+            "log_level": 20,
+        }
+        self.assertEqual(kwargs, expected_kwargs)
+
+
+class _Connection(object):
+
+    _called_with = None
+
+    def __init__(self, *responses):
+        self._responses = responses
+
+    def api_request(self, **kw):
+        self._called_with = kw
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
diff --git a/logging/tests/unit/test_entries.py b/logging/tests/unit/test_entries.py
new file mode 100644
index 000000000000..3aad7fbb130c
--- /dev/null
+++ b/logging/tests/unit/test_entries.py
@@ -0,0 +1,735 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class Test_logger_name_from_path(unittest.TestCase):
+    def _call_fut(self, path):
+        from google.cloud.logging.entries import logger_name_from_path
+
+        return logger_name_from_path(path)
+
+    def test_w_simple_name(self):
+        LOGGER_NAME = "LOGGER_NAME"
+        PROJECT = "my-project-1234"
+        PATH = "projects/%s/logs/%s" % (PROJECT, LOGGER_NAME)
+        logger_name = self._call_fut(PATH)
+        self.assertEqual(logger_name, LOGGER_NAME)
+
+    def test_w_name_w_all_extras(self):
+        LOGGER_NAME = "LOGGER_NAME-part.one~part.two%part-three"
+        PROJECT = "my-project-1234"
+        PATH = "projects/%s/logs/%s" % (PROJECT, LOGGER_NAME)
+        logger_name = self._call_fut(PATH)
+        self.assertEqual(logger_name, LOGGER_NAME)
+
+
+class Test__int_or_none(unittest.TestCase):
+    def _call_fut(self, value):
+        from google.cloud.logging.entries import _int_or_none
+
+        return _int_or_none(value)
+
+    def test_w_none(self):
+        self.assertIsNone(self._call_fut(None))
+
+    def test_w_int(self):
+        self.assertEqual(self._call_fut(123), 123)
+
+    def test_w_str(self):
+        self.assertEqual(self._call_fut("123"), 123)
+
+
+class TestLogEntry(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    LOGGER_NAME = "LOGGER_NAME"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.entries import LogEntry
+
+        return LogEntry
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+
+        entry = self._make_one()
+
+        self.assertIsNone(entry.log_name)
+        self.assertIsNone(entry.logger)
+        self.assertIsNone(entry.labels)
+        self.assertIsNone(entry.insert_id)
+        self.assertIsNone(entry.severity)
+        self.assertIsNone(entry.http_request)
+        self.assertIsNone(entry.timestamp)
+        self.assertIs(entry.resource, _GLOBAL_RESOURCE)
+        self.assertIsNone(entry.trace)
+        self.assertIsNone(entry.span_id)
+        self.assertIsNone(entry.trace_sampled)
+        self.assertIsNone(entry.source_location)
+        self.assertIsNone(entry.operation)
+        self.assertIsNone(entry.payload)
+
+    def test_ctor_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+
+        LOG_NAME = "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        IID = "IID"
+        TIMESTAMP = datetime.datetime.now()
+        LABELS = {"foo": "bar", "baz": "qux"}
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        resource = Resource(type="global", labels={})
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE_NO = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": LINE_NO, "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        logger = _Logger(self.LOGGER_NAME, self.PROJECT)
+
+        entry = self._make_one(
+            log_name=LOG_NAME,
+            logger=logger,
+            insert_id=IID,
+            timestamp=TIMESTAMP,
+            labels=LABELS,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            resource=resource,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+            source_location=SOURCE_LOCATION,
+            operation=OPERATION,
+        )
+
+        self.assertEqual(entry.log_name, LOG_NAME)
+        self.assertIs(entry.logger, logger)
+        self.assertEqual(entry.insert_id, IID)
+        self.assertEqual(entry.timestamp, TIMESTAMP)
+        self.assertEqual(entry.labels, LABELS)
+        self.assertEqual(entry.severity, SEVERITY)
+        self.assertEqual(entry.http_request["requestMethod"], METHOD)
+        self.assertEqual(entry.http_request["requestUrl"], URI)
+        self.assertEqual(entry.http_request["status"], STATUS)
+        self.assertEqual(entry.resource, resource)
+        self.assertEqual(entry.trace, TRACE)
+        self.assertEqual(entry.span_id, SPANID)
+        self.assertTrue(entry.trace_sampled)
+
+        source_location = entry.source_location
+        self.assertEqual(source_location["file"], FILE)
+        self.assertEqual(source_location["line"], LINE_NO)
+        self.assertEqual(source_location["function"], FUNCTION)
+
+        self.assertEqual(entry.operation, OPERATION)
+        self.assertIsNone(entry.payload)
+
+    def test_from_api_repr_missing_data_no_loggers(self):
+        client = _Client(self.PROJECT)
+        LOG_NAME = "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        API_REPR = {"logName": LOG_NAME}
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr(API_REPR, client)
+
+        self.assertEqual(entry.log_name, LOG_NAME)
+        logger = entry.logger
+        self.assertIsInstance(logger, _Logger)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIsNone(entry.insert_id)
+        self.assertIsNone(entry.timestamp)
+        self.assertIsNone(entry.severity)
+        self.assertIsNone(entry.http_request)
+        self.assertIsNone(entry.trace)
+        self.assertIsNone(entry.span_id)
+        self.assertIsNone(entry.trace_sampled)
+        self.assertIsNone(entry.source_location)
+        self.assertIsNone(entry.operation)
+        self.assertIs(logger.client, client)
+        self.assertIsNone(entry.payload)
+
+    def test_from_api_repr_w_loggers_no_logger_match(self):
+        from datetime import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud.logging.resource import Resource
+
+        klass = self._get_target_class()
+        client = _Client(self.PROJECT)
+        SEVERITY = "CRITICAL"
+        IID = "IID"
+        NOW = datetime.utcnow().replace(tzinfo=UTC)
+        TIMESTAMP = _datetime_to_rfc3339_w_nanos(NOW)
+        LOG_NAME = "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        LABELS = {"foo": "bar", "baz": "qux"}
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        RESOURCE = Resource(
+            type="gae_app",
+            labels={
+                "type": "gae_app",
+                "labels": {"module_id": "default", "version": "test"},
+            },
+        )
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE_NO = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": str(LINE_NO), "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        API_REPR = {
+            "logName": LOG_NAME,
+            "insertId": IID,
+            "timestamp": TIMESTAMP,
+            "labels": LABELS,
+            "severity": SEVERITY,
+            "httpRequest": {
+                "requestMethod": METHOD,
+                "requestUrl": URI,
+                "status": STATUS,
+            },
+            "resource": RESOURCE._to_dict(),
+            "trace": TRACE,
+            "spanId": SPANID,
+            "traceSampled": True,
+            "sourceLocation": SOURCE_LOCATION,
+            "operation": OPERATION,
+        }
+        loggers = {}
+
+        entry = klass.from_api_repr(API_REPR, client, loggers=loggers)
+
+        self.assertEqual(entry.log_name, LOG_NAME)
+        logger = entry.logger
+        self.assertIsInstance(logger, _Logger)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertEqual(entry.insert_id, IID)
+        self.assertEqual(entry.timestamp, NOW)
+        self.assertIsNone(entry.received_timestamp)
+        self.assertEqual(entry.labels, LABELS)
+        self.assertEqual(entry.severity, SEVERITY)
+        self.assertEqual(entry.http_request["requestMethod"], METHOD)
+        self.assertEqual(entry.http_request["requestUrl"], URI)
+        self.assertEqual(entry.http_request["status"], STATUS)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertEqual(loggers, {LOG_NAME: logger})
+        self.assertEqual(entry.resource, RESOURCE)
+        self.assertEqual(entry.trace, TRACE)
+        self.assertEqual(entry.span_id, SPANID)
+        self.assertTrue(entry.trace_sampled)
+
+        source_location = entry.source_location
+        self.assertEqual(source_location["file"], FILE)
+        self.assertEqual(source_location["line"], LINE_NO)
+        self.assertEqual(source_location["function"], FUNCTION)
+
+        self.assertEqual(entry.operation, OPERATION)
+        self.assertIsNone(entry.payload)
+
+    def test_from_api_repr_w_loggers_w_logger_match(self):
+        from datetime import datetime
+        from datetime import timedelta
+        from google.cloud._helpers import UTC
+
+        client = _Client(self.PROJECT)
+        IID = "IID"
+        NOW = datetime.utcnow().replace(tzinfo=UTC)
+        LATER = NOW + timedelta(seconds=1)
+        TIMESTAMP = _datetime_to_rfc3339_w_nanos(NOW)
+        RECEIVED = _datetime_to_rfc3339_w_nanos(LATER)
+        LOG_NAME = "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        LABELS = {"foo": "bar", "baz": "qux"}
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE_NO = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": str(LINE_NO), "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        API_REPR = {
+            "logName": LOG_NAME,
+            "insertId": IID,
+            "timestamp": TIMESTAMP,
+            "receiveTimestamp": RECEIVED,
+            "labels": LABELS,
+            "trace": TRACE,
+            "spanId": SPANID,
+            "traceSampled": True,
+            "sourceLocation": SOURCE_LOCATION,
+            "operation": OPERATION,
+        }
+        LOGGER = object()
+        loggers = {LOG_NAME: LOGGER}
+        klass = self._get_target_class()
+
+        entry = klass.from_api_repr(API_REPR, client, loggers=loggers)
+
+        self.assertEqual(entry.log_name, LOG_NAME)
+        self.assertIs(entry.logger, LOGGER)
+        self.assertEqual(entry.insert_id, IID)
+        self.assertEqual(entry.timestamp, NOW)
+        self.assertEqual(entry.received_timestamp, LATER)
+        self.assertEqual(entry.labels, LABELS)
+        self.assertEqual(entry.trace, TRACE)
+        self.assertEqual(entry.span_id, SPANID)
+        self.assertTrue(entry.trace_sampled)
+
+        source_location = entry.source_location
+        self.assertEqual(source_location["file"], FILE)
+        self.assertEqual(source_location["line"], LINE_NO)
+        self.assertEqual(source_location["function"], FUNCTION)
+
+        self.assertEqual(entry.operation, OPERATION)
+        self.assertIsNone(entry.payload)
+
+    def test_to_api_repr_w_source_location_no_line(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        LOG_NAME = "test.log"
+        FILE = "my_file.py"
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "function": FUNCTION}
+        entry = self._make_one(log_name=LOG_NAME, source_location=SOURCE_LOCATION)
+        expected = {
+            "logName": LOG_NAME,
+            "resource": _GLOBAL_RESOURCE._to_dict(),
+            "sourceLocation": {"file": FILE, "line": "0", "function": FUNCTION},
+        }
+        self.assertEqual(entry.to_api_repr(), expected)
+
+    def test_to_api_repr_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        LOG_NAME = "test.log"
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": LINE, "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        expected = {
+            "logName": LOG_NAME,
+            "labels": LABELS,
+            "insertId": IID,
+            "severity": SEVERITY,
+            "httpRequest": REQUEST,
+            "timestamp": _datetime_to_rfc3339(TIMESTAMP),
+            "resource": RESOURCE._to_dict(),
+            "trace": TRACE,
+            "spanId": SPANID,
+            "traceSampled": True,
+            "sourceLocation": {"file": FILE, "line": str(LINE), "function": FUNCTION},
+            "operation": OPERATION,
+        }
+        entry = self._make_one(
+            log_name=LOG_NAME,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+            source_location=SOURCE_LOCATION,
+            operation=OPERATION,
+        )
+
+        self.assertEqual(entry.to_api_repr(), expected)
+
+
+class TestTextEntry(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    LOGGER_NAME = "LOGGER_NAME"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.entries import TextEntry
+
+        return TextEntry
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_to_api_repr_defaults(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        LOG_NAME = "test.log"
+        TEXT = "TESTING"
+        entry = self._make_one(log_name=LOG_NAME, payload=TEXT)
+        expected = {
+            "logName": LOG_NAME,
+            "textPayload": TEXT,
+            "resource": _GLOBAL_RESOURCE._to_dict(),
+        }
+        self.assertEqual(entry.to_api_repr(), expected)
+
+    def test_to_api_repr_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        LOG_NAME = "test.log"
+        TEXT = "This is the entry text"
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": LINE, "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        expected = {
+            "logName": LOG_NAME,
+            "textPayload": TEXT,
+            "labels": LABELS,
+            "insertId": IID,
+            "severity": SEVERITY,
+            "httpRequest": REQUEST,
+            "timestamp": _datetime_to_rfc3339(TIMESTAMP),
+            "resource": RESOURCE._to_dict(),
+            "trace": TRACE,
+            "spanId": SPANID,
+            "traceSampled": True,
+            "sourceLocation": {"file": FILE, "line": str(LINE), "function": FUNCTION},
+            "operation": OPERATION,
+        }
+        entry = self._make_one(
+            log_name=LOG_NAME,
+            payload=TEXT,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+            source_location=SOURCE_LOCATION,
+            operation=OPERATION,
+        )
+
+        self.assertEqual(entry.to_api_repr(), expected)
+
+
+class TestStructEntry(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    LOGGER_NAME = "LOGGER_NAME"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.entries import StructEntry
+
+        return StructEntry
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_to_api_repr_defaults(self):
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+
+        LOG_NAME = "test.log"
+        JSON_PAYLOAD = {"key": "value"}
+        entry = self._make_one(log_name=LOG_NAME, payload=JSON_PAYLOAD)
+        expected = {
+            "logName": LOG_NAME,
+            "jsonPayload": JSON_PAYLOAD,
+            "resource": _GLOBAL_RESOURCE._to_dict(),
+        }
+        self.assertEqual(entry.to_api_repr(), expected)
+
+    def test_to_api_repr_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        LOG_NAME = "test.log"
+        JSON_PAYLOAD = {"key": "value"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": LINE, "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        expected = {
+            "logName": LOG_NAME,
+            "jsonPayload": JSON_PAYLOAD,
+            "labels": LABELS,
+            "insertId": IID,
+            "severity": SEVERITY,
+            "httpRequest": REQUEST,
+            "timestamp": _datetime_to_rfc3339(TIMESTAMP),
+            "resource": RESOURCE._to_dict(),
+            "trace": TRACE,
+            "spanId": SPANID,
+            "traceSampled": True,
+            "sourceLocation": {"file": FILE, "line": str(LINE), "function": FUNCTION},
+            "operation": OPERATION,
+        }
+        entry = self._make_one(
+            log_name=LOG_NAME,
+            payload=JSON_PAYLOAD,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+            source_location=SOURCE_LOCATION,
+            operation=OPERATION,
+        )
+
+        self.assertEqual(entry.to_api_repr(), expected)
+
+
+class TestProtobufEntry(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    LOGGER_NAME = "LOGGER_NAME"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.entries import ProtobufEntry
+
+        return ProtobufEntry
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_basic(self):
+        payload = {"foo": "bar"}
+
+        pb_entry = self._make_one(payload=payload, logger=mock.sentinel.logger)
+
+        self.assertIs(pb_entry.payload, payload)
+        self.assertIsNone(pb_entry.payload_pb)
+        self.assertIs(pb_entry.payload_json, payload)
+        self.assertIs(pb_entry.logger, mock.sentinel.logger)
+        self.assertIsNone(pb_entry.insert_id)
+        self.assertIsNone(pb_entry.timestamp)
+        self.assertIsNone(pb_entry.labels)
+        self.assertIsNone(pb_entry.severity)
+        self.assertIsNone(pb_entry.http_request)
+        self.assertIsNone(pb_entry.trace)
+        self.assertIsNone(pb_entry.span_id)
+        self.assertIsNone(pb_entry.trace_sampled)
+        self.assertIsNone(pb_entry.source_location)
+
+    def test_constructor_with_any(self):
+        from google.protobuf.any_pb2 import Any
+
+        payload = Any()
+
+        pb_entry = self._make_one(payload=payload, logger=mock.sentinel.logger)
+
+        self.assertIs(pb_entry.payload, payload)
+        self.assertIs(pb_entry.payload_pb, payload)
+        self.assertIsNone(pb_entry.payload_json)
+        self.assertIs(pb_entry.logger, mock.sentinel.logger)
+        self.assertIsNone(pb_entry.insert_id)
+        self.assertIsNone(pb_entry.timestamp)
+        self.assertIsNone(pb_entry.labels)
+        self.assertIsNone(pb_entry.severity)
+        self.assertIsNone(pb_entry.http_request)
+        self.assertIsNone(pb_entry.trace)
+        self.assertIsNone(pb_entry.span_id)
+        self.assertIsNone(pb_entry.trace_sampled)
+        self.assertIsNone(pb_entry.source_location)
+
+    def test_parse_message(self):
+        import json
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct, Value
+
+        message = Struct(fields={"foo": Value(bool_value=False)})
+        with_true = Struct(fields={"foo": Value(bool_value=True)})
+        payload = json.loads(MessageToJson(with_true))
+        entry = self._make_one(payload=payload, logger=mock.sentinel.logger)
+
+        entry.parse_message(message)
+
+        self.assertTrue(message.fields["foo"])
+
+    def test_to_api_repr_proto_defaults(self):
+        from google.protobuf.json_format import MessageToDict
+        from google.cloud.logging.logger import _GLOBAL_RESOURCE
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+
+        LOG_NAME = "test.log"
+        message = Struct(fields={"foo": Value(bool_value=True)})
+
+        entry = self._make_one(log_name=LOG_NAME, payload=message)
+        expected = {
+            "logName": LOG_NAME,
+            "protoPayload": MessageToDict(message),
+            "resource": _GLOBAL_RESOURCE._to_dict(),
+        }
+        self.assertEqual(entry.to_api_repr(), expected)
+
+    def test_to_api_repr_proto_explicit(self):
+        import datetime
+        from google.protobuf.json_format import MessageToDict
+        from google.cloud.logging.resource import Resource
+        from google.cloud._helpers import _datetime_to_rfc3339
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+
+        LOG_NAME = "test.log"
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        FILE = "my_file.py"
+        LINE = 123
+        FUNCTION = "my_function"
+        SOURCE_LOCATION = {"file": FILE, "line": LINE, "function": FUNCTION}
+        OP_ID = "OP_ID"
+        PRODUCER = "PRODUCER"
+        OPERATION = {"id": OP_ID, "producer": PRODUCER, "first": True, "last": False}
+        expected = {
+            "logName": LOG_NAME,
+            "protoPayload": MessageToDict(message),
+            "labels": LABELS,
+            "insertId": IID,
+            "severity": SEVERITY,
+            "httpRequest": REQUEST,
+            "timestamp": _datetime_to_rfc3339(TIMESTAMP),
+            "resource": RESOURCE._to_dict(),
+            "trace": TRACE,
+            "spanId": SPANID,
+            "traceSampled": True,
+            "sourceLocation": {"file": FILE, "line": str(LINE), "function": FUNCTION},
+            "operation": OPERATION,
+        }
+
+        entry = self._make_one(
+            log_name=LOG_NAME,
+            payload=message,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+            source_location=SOURCE_LOCATION,
+            operation=OPERATION,
+        )
+
+        self.assertEqual(entry.to_api_repr(), expected)
+
+
+def _datetime_to_rfc3339_w_nanos(value):
+    from google.cloud._helpers import _RFC3339_NO_FRACTION
+
+    no_fraction = value.strftime(_RFC3339_NO_FRACTION)
+    return "%s.%09dZ" % (no_fraction, value.microsecond * 1000)
+
+
+class _Logger(object):
+    def __init__(self, name, client):
+        self.name = name
+        self.client = client
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+
+    def logger(self, name):
+        return _Logger(name, self)
diff --git a/logging/tests/unit/test_logger.py b/logging/tests/unit/test_logger.py
new file mode 100644
index 000000000000..5bf6a706815f
--- /dev/null
+++ b/logging/tests/unit/test_logger.py
@@ -0,0 +1,1140 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestLogger(unittest.TestCase):
+
+    PROJECT = "test-project"
+    LOGGER_NAME = "logger-name"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.logger import Logger
+
+        return Logger
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        conn = object()
+        client = _Client(self.PROJECT, conn)
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.project, self.PROJECT)
+        self.assertEqual(
+            logger.full_name, "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        )
+        self.assertEqual(
+            logger.path, "/projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        )
+        self.assertIsNone(logger.labels)
+
+    def test_ctor_explicit(self):
+        LABELS = {"foo": "bar", "baz": "qux"}
+        conn = object()
+        client = _Client(self.PROJECT, conn)
+        logger = self._make_one(self.LOGGER_NAME, client=client, labels=LABELS)
+        self.assertEqual(logger.name, self.LOGGER_NAME)
+        self.assertIs(logger.client, client)
+        self.assertEqual(logger.project, self.PROJECT)
+        self.assertEqual(
+            logger.full_name, "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        )
+        self.assertEqual(
+            logger.path, "/projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        )
+        self.assertEqual(logger.labels, LABELS)
+
+    def test_batch_w_bound_client(self):
+        from google.cloud.logging.logger import Batch
+
+        conn = object()
+        client = _Client(self.PROJECT, conn)
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+        batch = logger.batch()
+        self.assertIsInstance(batch, Batch)
+        self.assertIs(batch.logger, logger)
+        self.assertIs(batch.client, client)
+
+    def test_batch_w_alternate_client(self):
+        from google.cloud.logging.logger import Batch
+
+        conn1 = object()
+        conn2 = object()
+        client1 = _Client(self.PROJECT, conn1)
+        client2 = _Client(self.PROJECT, conn2)
+        logger = self._make_one(self.LOGGER_NAME, client=client1)
+        batch = logger.batch(client2)
+        self.assertIsInstance(batch, Batch)
+        self.assertIs(batch.logger, logger)
+        self.assertIs(batch.client, client2)
+
+    def test_log_empty_defaults_w_default_labels(self):
+        DEFAULT_LABELS = {"foo": "spam"}
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "resource": {"type": "global", "labels": {}},
+                "labels": DEFAULT_LABELS,
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client, labels=DEFAULT_LABELS)
+
+        logger.log_empty()
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_empty_w_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+
+        ALT_LOG_NAME = "projects/foo/logs/alt.log.name"
+        DEFAULT_LABELS = {"foo": "spam"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        ENTRIES = [
+            {
+                "logName": ALT_LOG_NAME,
+                "labels": LABELS,
+                "insertId": IID,
+                "severity": SEVERITY,
+                "httpRequest": REQUEST,
+                "timestamp": "2016-12-31T00:01:02.999999Z",
+                "resource": RESOURCE._to_dict(),
+                "trace": TRACE,
+                "spanId": SPANID,
+                "traceSampled": True,
+            }
+        ]
+        client1 = _Client(self.PROJECT)
+        client2 = _Client(self.PROJECT)
+        api = client2.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client1, labels=DEFAULT_LABELS)
+
+        logger.log_empty(
+            log_name=ALT_LOG_NAME,
+            client=client2,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_text_defaults(self):
+        TEXT = "TEXT"
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "textPayload": TEXT,
+                "resource": {"type": "global", "labels": {}},
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+
+        logger.log_text(TEXT)
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_text_w_unicode_and_default_labels(self):
+        TEXT = u"TEXT"
+        DEFAULT_LABELS = {"foo": "spam"}
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "textPayload": TEXT,
+                "resource": {"type": "global", "labels": {}},
+                "labels": DEFAULT_LABELS,
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client, labels=DEFAULT_LABELS)
+
+        logger.log_text(TEXT)
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_text_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+
+        ALT_LOG_NAME = "projects/foo/logs/alt.log.name"
+        TEXT = "TEXT"
+        DEFAULT_LABELS = {"foo": "spam"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        ENTRIES = [
+            {
+                "logName": ALT_LOG_NAME,
+                "textPayload": TEXT,
+                "labels": LABELS,
+                "insertId": IID,
+                "severity": SEVERITY,
+                "httpRequest": REQUEST,
+                "timestamp": "2016-12-31T00:01:02.999999Z",
+                "resource": RESOURCE._to_dict(),
+                "trace": TRACE,
+                "spanId": SPANID,
+                "traceSampled": True,
+            }
+        ]
+        client1 = _Client(self.PROJECT)
+        client2 = _Client(self.PROJECT)
+        api = client2.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client1, labels=DEFAULT_LABELS)
+
+        logger.log_text(
+            TEXT,
+            log_name=ALT_LOG_NAME,
+            client=client2,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_struct_defaults(self):
+        STRUCT = {"message": "MESSAGE", "weather": "cloudy"}
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "jsonPayload": STRUCT,
+                "resource": {"type": "global", "labels": {}},
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+
+        logger.log_struct(STRUCT)
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_struct_w_default_labels(self):
+        STRUCT = {"message": "MESSAGE", "weather": "cloudy"}
+        DEFAULT_LABELS = {"foo": "spam"}
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "jsonPayload": STRUCT,
+                "resource": {"type": "global", "labels": {}},
+                "labels": DEFAULT_LABELS,
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client, labels=DEFAULT_LABELS)
+
+        logger.log_struct(STRUCT)
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_struct_w_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+
+        ALT_LOG_NAME = "projects/foo/logs/alt.log.name"
+        STRUCT = {"message": "MESSAGE", "weather": "cloudy"}
+        DEFAULT_LABELS = {"foo": "spam"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        ENTRIES = [
+            {
+                "logName": ALT_LOG_NAME,
+                "jsonPayload": STRUCT,
+                "labels": LABELS,
+                "insertId": IID,
+                "severity": SEVERITY,
+                "httpRequest": REQUEST,
+                "timestamp": "2016-12-31T00:01:02.999999Z",
+                "resource": RESOURCE._to_dict(),
+                "trace": TRACE,
+                "spanId": SPANID,
+                "traceSampled": True,
+            }
+        ]
+        client1 = _Client(self.PROJECT)
+        client2 = _Client(self.PROJECT)
+        api = client2.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client1, labels=DEFAULT_LABELS)
+
+        logger.log_struct(
+            STRUCT,
+            log_name=ALT_LOG_NAME,
+            client=client2,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_proto_defaults(self):
+        import json
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct, Value
+
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "protoPayload": json.loads(MessageToJson(message)),
+                "resource": {"type": "global", "labels": {}},
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+
+        logger.log_proto(message)
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_proto_w_default_labels(self):
+        import json
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct, Value
+
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        DEFAULT_LABELS = {"foo": "spam"}
+        ENTRIES = [
+            {
+                "logName": "projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME),
+                "protoPayload": json.loads(MessageToJson(message)),
+                "resource": {"type": "global", "labels": {}},
+                "labels": DEFAULT_LABELS,
+            }
+        ]
+        client = _Client(self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client, labels=DEFAULT_LABELS)
+
+        logger.log_proto(message)
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_log_proto_w_explicit(self):
+        import json
+        import datetime
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.logging.resource import Resource
+
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        ALT_LOG_NAME = "projects/foo/logs/alt.log.name"
+        DEFAULT_LABELS = {"foo": "spam"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        ENTRIES = [
+            {
+                "logName": ALT_LOG_NAME,
+                "protoPayload": json.loads(MessageToJson(message)),
+                "labels": LABELS,
+                "insertId": IID,
+                "severity": SEVERITY,
+                "httpRequest": REQUEST,
+                "timestamp": "2016-12-31T00:01:02.999999Z",
+                "resource": RESOURCE._to_dict(),
+                "trace": TRACE,
+                "spanId": SPANID,
+                "traceSampled": True,
+            }
+        ]
+        client1 = _Client(self.PROJECT)
+        client2 = _Client(self.PROJECT)
+        api = client2.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client1, labels=DEFAULT_LABELS)
+
+        logger.log_proto(
+            message,
+            log_name=ALT_LOG_NAME,
+            client=client2,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        self.assertEqual(api._write_entries_called_with, (ENTRIES, None, None, None))
+
+    def test_delete_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+
+        logger.delete()
+
+        self.assertEqual(
+            api._logger_delete_called_with, (self.PROJECT, self.LOGGER_NAME)
+        )
+
+    def test_delete_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.logging_api = _DummyLoggingAPI()
+        logger = self._make_one(self.LOGGER_NAME, client=client1)
+
+        logger.delete(client=client2)
+
+        self.assertEqual(
+            api._logger_delete_called_with, (self.PROJECT, self.LOGGER_NAME)
+        )
+
+    def test_list_entries_defaults(self):
+        import six
+        from google.cloud.logging.client import Client
+
+        TOKEN = "TOKEN"
+
+        client = Client(
+            project=self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        returned = {"nextPageToken": TOKEN}
+        client._connection = _Connection(returned)
+
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+
+        iterator = logger.list_entries()
+        page = six.next(iterator.pages)
+        entries = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(entries), 0)
+        self.assertEqual(token, TOKEN)
+        called_with = client._connection._called_with
+        FILTER = "logName=projects/%s/logs/%s" % (self.PROJECT, self.LOGGER_NAME)
+        self.assertEqual(
+            called_with,
+            {
+                "method": "POST",
+                "path": "/entries:list",
+                "data": {"filter": FILTER, "projectIds": [self.PROJECT]},
+            },
+        )
+
+    def test_list_entries_explicit(self):
+        from google.cloud.logging import DESCENDING
+        from google.cloud.logging.client import Client
+
+        PROJECT1 = "PROJECT1"
+        PROJECT2 = "PROJECT2"
+        FILTER = "resource.type:global"
+        TOKEN = "TOKEN"
+        PAGE_SIZE = 42
+        client = Client(
+            project=self.PROJECT, credentials=_make_credentials(), _use_grpc=False
+        )
+        client._connection = _Connection({})
+        logger = self._make_one(self.LOGGER_NAME, client=client)
+        iterator = logger.list_entries(
+            projects=[PROJECT1, PROJECT2],
+            filter_=FILTER,
+            order_by=DESCENDING,
+            page_size=PAGE_SIZE,
+            page_token=TOKEN,
+        )
+        entries = list(iterator)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(entries), 0)
+        self.assertIsNone(token)
+        # self.assertEqual(client._listed, LISTED)
+        called_with = client._connection._called_with
+        combined_filter = "%s AND logName=projects/%s/logs/%s" % (
+            FILTER,
+            self.PROJECT,
+            self.LOGGER_NAME,
+        )
+        self.assertEqual(
+            called_with,
+            {
+                "method": "POST",
+                "path": "/entries:list",
+                "data": {
+                    "filter": combined_filter,
+                    "orderBy": DESCENDING,
+                    "pageSize": PAGE_SIZE,
+                    "pageToken": TOKEN,
+                    "projectIds": [PROJECT1, PROJECT2],
+                },
+            },
+        )
+
+
+class TestBatch(unittest.TestCase):
+
+    PROJECT = "test-project"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.logger import Batch
+
+        return Batch
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        logger = _Logger()
+        client = _Client(project=self.PROJECT)
+        batch = self._make_one(logger, client)
+        self.assertIs(batch.logger, logger)
+        self.assertIs(batch.client, client)
+        self.assertEqual(len(batch.entries), 0)
+
+    def test_log_empty_defaults(self):
+        from google.cloud.logging.entries import LogEntry
+
+        ENTRY = LogEntry()
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_empty()
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_empty_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud.logging.entries import LogEntry
+
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        ENTRY = LogEntry(
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_empty(
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_text_defaults(self):
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+        from google.cloud.logging.entries import TextEntry
+
+        TEXT = "This is the entry text"
+        ENTRY = TextEntry(payload=TEXT, resource=_GLOBAL_RESOURCE)
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_text(TEXT)
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_text_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud.logging.entries import TextEntry
+
+        TEXT = "This is the entry text"
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        ENTRY = TextEntry(
+            payload=TEXT,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_text(
+            TEXT,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_struct_defaults(self):
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+        from google.cloud.logging.entries import StructEntry
+
+        STRUCT = {"message": "Message text", "weather": "partly cloudy"}
+        ENTRY = StructEntry(payload=STRUCT, resource=_GLOBAL_RESOURCE)
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_struct(STRUCT)
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_struct_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud.logging.entries import StructEntry
+
+        STRUCT = {"message": "Message text", "weather": "partly cloudy"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        ENTRY = StructEntry(
+            payload=STRUCT,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_struct(
+            STRUCT,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_proto_defaults(self):
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+        from google.cloud.logging.entries import ProtobufEntry
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        ENTRY = ProtobufEntry(payload=message, resource=_GLOBAL_RESOURCE)
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_proto(message)
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_log_proto_explicit(self):
+        import datetime
+        from google.cloud.logging.resource import Resource
+        from google.cloud.logging.entries import ProtobufEntry
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        TRACE = "12345678-1234-5678-1234-567812345678"
+        SPANID = "000000000000004a"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+        ENTRY = ProtobufEntry(
+            payload=message,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+        batch.log_proto(
+            message,
+            labels=LABELS,
+            insert_id=IID,
+            severity=SEVERITY,
+            http_request=REQUEST,
+            timestamp=TIMESTAMP,
+            resource=RESOURCE,
+            trace=TRACE,
+            span_id=SPANID,
+            trace_sampled=True,
+        )
+        self.assertEqual(batch.entries, [ENTRY])
+
+    def test_commit_w_unknown_entry_type(self):
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+        from google.cloud.logging.entries import LogEntry
+
+        logger = _Logger()
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        api = client.logging_api = _DummyLoggingAPI()
+        batch = self._make_one(logger, client)
+        batch.entries.append(LogEntry(severity="blah"))
+        ENTRY = {"severity": "blah", "resource": _GLOBAL_RESOURCE._to_dict()}
+
+        batch.commit()
+
+        self.assertEqual(list(batch.entries), [])
+        self.assertEqual(
+            api._write_entries_called_with, ([ENTRY], logger.full_name, None, None)
+        )
+
+    def test_commit_w_resource_specified(self):
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+        from google.cloud.logging.resource import Resource
+
+        logger = _Logger()
+        client = _Client(project=self.PROJECT, connection=_make_credentials())
+        api = client.logging_api = _DummyLoggingAPI()
+        RESOURCE = Resource(
+            type="gae_app", labels={"module_id": "default", "version_id": "test"}
+        )
+
+        batch = self._make_one(logger, client, resource=RESOURCE)
+        MESSAGE = "This is the entry text"
+        ENTRIES = [
+            {"textPayload": MESSAGE},
+            {"textPayload": MESSAGE, "resource": _GLOBAL_RESOURCE._to_dict()},
+        ]
+        batch.log_text(MESSAGE, resource=None)
+        batch.log_text(MESSAGE)
+        batch.commit()
+        self.assertEqual(
+            api._write_entries_called_with,
+            (ENTRIES, logger.full_name, RESOURCE._to_dict(), None),
+        )
+
+    def test_commit_w_bound_client(self):
+        import json
+        import datetime
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud._helpers import _datetime_to_rfc3339
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+
+        TEXT = "This is the entry text"
+        STRUCT = {"message": TEXT, "weather": "partly cloudy"}
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        IID1 = "IID1"
+        IID2 = "IID2"
+        IID3 = "IID3"
+        TIMESTAMP1 = datetime.datetime(2016, 12, 31, 0, 0, 1, 999999)
+        TIMESTAMP2 = datetime.datetime(2016, 12, 31, 0, 0, 2, 999999)
+        TIMESTAMP3 = datetime.datetime(2016, 12, 31, 0, 0, 3, 999999)
+        TRACE1 = "12345678-1234-5678-1234-567812345678"
+        TRACE2 = "12345678-1234-5678-1234-567812345679"
+        TRACE3 = "12345678-1234-5678-1234-567812345670"
+        SPANID1 = "000000000000004a"
+        SPANID2 = "000000000000004b"
+        SPANID3 = "000000000000004c"
+        ENTRIES = [
+            {
+                "textPayload": TEXT,
+                "insertId": IID1,
+                "timestamp": _datetime_to_rfc3339(TIMESTAMP1),
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+                "trace": TRACE1,
+                "spanId": SPANID1,
+                "traceSampled": True,
+            },
+            {
+                "jsonPayload": STRUCT,
+                "insertId": IID2,
+                "timestamp": _datetime_to_rfc3339(TIMESTAMP2),
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+                "trace": TRACE2,
+                "spanId": SPANID2,
+                "traceSampled": False,
+            },
+            {
+                "protoPayload": json.loads(MessageToJson(message)),
+                "insertId": IID3,
+                "timestamp": _datetime_to_rfc3339(TIMESTAMP3),
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+                "trace": TRACE3,
+                "spanId": SPANID3,
+                "traceSampled": True,
+            },
+        ]
+        client = _Client(project=self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = _Logger()
+        batch = self._make_one(logger, client=client)
+
+        batch.log_text(
+            TEXT,
+            insert_id=IID1,
+            timestamp=TIMESTAMP1,
+            trace=TRACE1,
+            span_id=SPANID1,
+            trace_sampled=True,
+        )
+        batch.log_struct(
+            STRUCT,
+            insert_id=IID2,
+            timestamp=TIMESTAMP2,
+            trace=TRACE2,
+            span_id=SPANID2,
+            trace_sampled=False,
+        )
+        batch.log_proto(
+            message,
+            insert_id=IID3,
+            timestamp=TIMESTAMP3,
+            trace=TRACE3,
+            span_id=SPANID3,
+            trace_sampled=True,
+        )
+        batch.commit()
+
+        self.assertEqual(list(batch.entries), [])
+        self.assertEqual(
+            api._write_entries_called_with, (ENTRIES, logger.full_name, None, None)
+        )
+
+    def test_commit_w_alternate_client(self):
+        import json
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.logging.logger import Logger
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+
+        TEXT = "This is the entry text"
+        STRUCT = {"message": TEXT, "weather": "partly cloudy"}
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        DEFAULT_LABELS = {"foo": "spam"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.logging_api = _DummyLoggingAPI()
+        logger = Logger("logger_name", client1, labels=DEFAULT_LABELS)
+        ENTRIES = [
+            {
+                "textPayload": TEXT,
+                "labels": LABELS,
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+            },
+            {
+                "jsonPayload": STRUCT,
+                "severity": SEVERITY,
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+            },
+            {
+                "protoPayload": json.loads(MessageToJson(message)),
+                "httpRequest": REQUEST,
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+            },
+        ]
+        batch = self._make_one(logger, client=client1)
+
+        batch.log_text(TEXT, labels=LABELS)
+        batch.log_struct(STRUCT, severity=SEVERITY)
+        batch.log_proto(message, http_request=REQUEST)
+        batch.commit(client=client2)
+
+        self.assertEqual(list(batch.entries), [])
+        self.assertEqual(
+            api._write_entries_called_with,
+            (ENTRIES, logger.full_name, None, DEFAULT_LABELS),
+        )
+
+    def test_context_mgr_success(self):
+        import json
+        from google.protobuf.json_format import MessageToJson
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.logging.logger import Logger
+        from google.cloud.logging.entries import _GLOBAL_RESOURCE
+
+        TEXT = "This is the entry text"
+        STRUCT = {"message": TEXT, "weather": "partly cloudy"}
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        DEFAULT_LABELS = {"foo": "spam"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        client = _Client(project=self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = Logger("logger_name", client, labels=DEFAULT_LABELS)
+        ENTRIES = [
+            {
+                "textPayload": TEXT,
+                "httpRequest": REQUEST,
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+            },
+            {
+                "jsonPayload": STRUCT,
+                "labels": LABELS,
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+            },
+            {
+                "protoPayload": json.loads(MessageToJson(message)),
+                "resource": _GLOBAL_RESOURCE._to_dict(),
+                "severity": SEVERITY,
+            },
+        ]
+        batch = self._make_one(logger, client=client)
+
+        with batch as other:
+            other.log_text(TEXT, http_request=REQUEST)
+            other.log_struct(STRUCT, labels=LABELS)
+            other.log_proto(message, severity=SEVERITY)
+
+        self.assertEqual(list(batch.entries), [])
+        self.assertEqual(
+            api._write_entries_called_with,
+            (ENTRIES, logger.full_name, None, DEFAULT_LABELS),
+        )
+
+    def test_context_mgr_failure(self):
+        import datetime
+        from google.protobuf.struct_pb2 import Struct
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.logging.entries import TextEntry
+        from google.cloud.logging.entries import StructEntry
+        from google.cloud.logging.entries import ProtobufEntry
+
+        TEXT = "This is the entry text"
+        STRUCT = {"message": TEXT, "weather": "partly cloudy"}
+        LABELS = {"foo": "bar", "baz": "qux"}
+        IID = "IID"
+        SEVERITY = "CRITICAL"
+        METHOD = "POST"
+        URI = "https://api.example.com/endpoint"
+        STATUS = "500"
+        REQUEST = {"requestMethod": METHOD, "requestUrl": URI, "status": STATUS}
+        TIMESTAMP = datetime.datetime(2016, 12, 31, 0, 1, 2, 999999)
+        message = Struct(fields={"foo": Value(bool_value=True)})
+        client = _Client(project=self.PROJECT)
+        api = client.logging_api = _DummyLoggingAPI()
+        logger = _Logger()
+        UNSENT = [
+            TextEntry(payload=TEXT, insert_id=IID, timestamp=TIMESTAMP),
+            StructEntry(payload=STRUCT, severity=SEVERITY),
+            ProtobufEntry(payload=message, labels=LABELS, http_request=REQUEST),
+        ]
+        batch = self._make_one(logger, client=client)
+
+        try:
+            with batch as other:
+                other.log_text(TEXT, insert_id=IID, timestamp=TIMESTAMP)
+                other.log_struct(STRUCT, severity=SEVERITY)
+                other.log_proto(message, labels=LABELS, http_request=REQUEST)
+                raise _Bugout()
+        except _Bugout:
+            pass
+
+        self.assertEqual(list(batch.entries), UNSENT)
+        self.assertIsNone(api._write_entries_called_with)
+
+
+class _Logger(object):
+
+    labels = None
+
+    def __init__(self, name="NAME", project="PROJECT"):
+        self.full_name = "projects/%s/logs/%s" % (project, name)
+
+
+class _DummyLoggingAPI(object):
+
+    _write_entries_called_with = None
+
+    def write_entries(self, entries, logger_name=None, resource=None, labels=None):
+        self._write_entries_called_with = (entries, logger_name, resource, labels)
+
+    def logger_delete(self, project, logger_name):
+        self._logger_delete_called_with = (project, logger_name)
+
+
+class _Client(object):
+    def __init__(self, project, connection=None):
+        self.project = project
+        self._connection = connection
+
+
+class _Bugout(Exception):
+    pass
+
+
+class _Connection(object):
+
+    _called_with = None
+
+    def __init__(self, *responses):
+        self._responses = responses
+
+    def api_request(self, **kw):
+        self._called_with = kw
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
diff --git a/logging/tests/unit/test_metric.py b/logging/tests/unit/test_metric.py
new file mode 100644
index 000000000000..93ee90b87470
--- /dev/null
+++ b/logging/tests/unit/test_metric.py
@@ -0,0 +1,247 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestMetric(unittest.TestCase):
+
+    PROJECT = "test-project"
+    METRIC_NAME = "metric-name"
+    FILTER = "logName:syslog AND severity>=ERROR"
+    DESCRIPTION = "DESCRIPTION"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.metric import Metric
+
+        return Metric
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        FULL = "projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        client = _Client(self.PROJECT)
+        metric = self._make_one(self.METRIC_NAME, client=client)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertIsNone(metric.filter_)
+        self.assertEqual(metric.description, "")
+        self.assertIs(metric.client, client)
+        self.assertEqual(metric.project, self.PROJECT)
+        self.assertEqual(metric.full_name, FULL)
+        self.assertEqual(metric.path, "/%s" % (FULL,))
+
+    def test_ctor_explicit(self):
+        FULL = "projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        client = _Client(self.PROJECT)
+        metric = self._make_one(
+            self.METRIC_NAME, self.FILTER, client=client, description=self.DESCRIPTION
+        )
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, self.DESCRIPTION)
+        self.assertIs(metric.client, client)
+        self.assertEqual(metric.project, self.PROJECT)
+        self.assertEqual(metric.full_name, FULL)
+        self.assertEqual(metric.path, "/%s" % (FULL,))
+
+    def test_from_api_repr_minimal(self):
+        client = _Client(project=self.PROJECT)
+        FULL = "projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        RESOURCE = {"name": self.METRIC_NAME, "filter": self.FILTER}
+        klass = self._get_target_class()
+        metric = klass.from_api_repr(RESOURCE, client=client)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, "")
+        self.assertIs(metric._client, client)
+        self.assertEqual(metric.project, self.PROJECT)
+        self.assertEqual(metric.full_name, FULL)
+
+    def test_from_api_repr_w_description(self):
+        client = _Client(project=self.PROJECT)
+        FULL = "projects/%s/metrics/%s" % (self.PROJECT, self.METRIC_NAME)
+        DESCRIPTION = "DESCRIPTION"
+        RESOURCE = {
+            "name": self.METRIC_NAME,
+            "filter": self.FILTER,
+            "description": DESCRIPTION,
+        }
+        klass = self._get_target_class()
+        metric = klass.from_api_repr(RESOURCE, client=client)
+        self.assertEqual(metric.name, self.METRIC_NAME)
+        self.assertEqual(metric.filter_, self.FILTER)
+        self.assertEqual(metric.description, DESCRIPTION)
+        self.assertIs(metric._client, client)
+        self.assertEqual(metric.project, self.PROJECT)
+        self.assertEqual(metric.full_name, FULL)
+
+    def test_create_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client)
+
+        metric.create()
+
+        self.assertEqual(
+            api._metric_create_called_with,
+            (self.PROJECT, self.METRIC_NAME, self.FILTER, ""),
+        )
+
+    def test_create_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(
+            self.METRIC_NAME, self.FILTER, client=client1, description=self.DESCRIPTION
+        )
+
+        metric.create(client=client2)
+
+        self.assertEqual(
+            api._metric_create_called_with,
+            (self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION),
+        )
+
+    def test_exists_miss_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client)
+
+        self.assertFalse(metric.exists())
+
+        self.assertEqual(api._metric_get_called_with, (self.PROJECT, self.METRIC_NAME))
+
+    def test_exists_hit_w_alternate_client(self):
+        RESOURCE = {"name": self.METRIC_NAME, "filter": self.FILTER}
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.metrics_api = _DummyMetricsAPI()
+        api._metric_get_response = RESOURCE
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client1)
+
+        self.assertTrue(metric.exists(client=client2))
+
+        self.assertEqual(api._metric_get_called_with, (self.PROJECT, self.METRIC_NAME))
+
+    def test_reload_w_bound_client(self):
+        NEW_FILTER = "logName:syslog AND severity>=INFO"
+        RESOURCE = {"name": self.METRIC_NAME, "filter": NEW_FILTER}
+        client = _Client(project=self.PROJECT)
+        api = client.metrics_api = _DummyMetricsAPI()
+        api._metric_get_response = RESOURCE
+        metric = self._make_one(
+            self.METRIC_NAME, self.FILTER, client=client, description=self.DESCRIPTION
+        )
+
+        metric.reload()
+
+        self.assertEqual(metric.filter_, NEW_FILTER)
+        self.assertEqual(metric.description, "")
+        self.assertEqual(api._metric_get_called_with, (self.PROJECT, self.METRIC_NAME))
+
+    def test_reload_w_alternate_client(self):
+        NEW_FILTER = "logName:syslog AND severity>=INFO"
+        RESOURCE = {
+            "name": self.METRIC_NAME,
+            "description": self.DESCRIPTION,
+            "filter": NEW_FILTER,
+        }
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.metrics_api = _DummyMetricsAPI()
+        api._metric_get_response = RESOURCE
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client1)
+
+        metric.reload(client=client2)
+
+        self.assertEqual(metric.filter_, NEW_FILTER)
+        self.assertEqual(metric.description, self.DESCRIPTION)
+        self.assertEqual(api._metric_get_called_with, (self.PROJECT, self.METRIC_NAME))
+
+    def test_update_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client)
+
+        metric.update()
+
+        self.assertEqual(
+            api._metric_update_called_with,
+            (self.PROJECT, self.METRIC_NAME, self.FILTER, ""),
+        )
+
+    def test_update_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(
+            self.METRIC_NAME, self.FILTER, client=client1, description=self.DESCRIPTION
+        )
+
+        metric.update(client=client2)
+
+        self.assertEqual(
+            api._metric_update_called_with,
+            (self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION),
+        )
+
+    def test_delete_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client)
+
+        metric.delete()
+
+        self.assertEqual(
+            api._metric_delete_called_with, (self.PROJECT, self.METRIC_NAME)
+        )
+
+    def test_delete_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.metrics_api = _DummyMetricsAPI()
+        metric = self._make_one(self.METRIC_NAME, self.FILTER, client=client1)
+
+        metric.delete(client=client2)
+
+        self.assertEqual(
+            api._metric_delete_called_with, (self.PROJECT, self.METRIC_NAME)
+        )
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+
+
+class _DummyMetricsAPI(object):
+    def metric_create(self, project, metric_name, filter_, description):
+        self._metric_create_called_with = (project, metric_name, filter_, description)
+
+    def metric_get(self, project, metric_name):
+        from google.cloud.exceptions import NotFound
+
+        self._metric_get_called_with = (project, metric_name)
+        try:
+            return self._metric_get_response
+        except AttributeError:
+            raise NotFound("miss")
+
+    def metric_update(self, project, metric_name, filter_, description):
+        self._metric_update_called_with = (project, metric_name, filter_, description)
+
+    def metric_delete(self, project, metric_name):
+        self._metric_delete_called_with = (project, metric_name)
diff --git a/logging/tests/unit/test_sink.py b/logging/tests/unit/test_sink.py
new file mode 100644
index 000000000000..dc1ff9563f9c
--- /dev/null
+++ b/logging/tests/unit/test_sink.py
@@ -0,0 +1,322 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestSink(unittest.TestCase):
+
+    PROJECT = "test-project"
+    SINK_NAME = "sink-name"
+    FILTER = "logName:syslog AND severity>=INFO"
+    DESTINATION_URI = "faux.googleapis.com/destination"
+    WRITER_IDENTITY = "serviceAccount:project-123@example.com"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.logging.sink import Sink
+
+        return Sink
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_defaults(self):
+        FULL = "projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        client = _Client(self.PROJECT)
+        sink = self._make_one(self.SINK_NAME, client=client)
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertIsNone(sink.filter_)
+        self.assertIsNone(sink.destination)
+        self.assertIs(sink.client, client)
+        self.assertEqual(sink.project, self.PROJECT)
+        self.assertEqual(sink.full_name, FULL)
+        self.assertEqual(sink.path, "/%s" % (FULL,))
+
+    def test_ctor_explicit(self):
+        FULL = "projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        client = _Client(self.PROJECT)
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client
+        )
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIs(sink.client, client)
+        self.assertEqual(sink.project, self.PROJECT)
+        self.assertEqual(sink.full_name, FULL)
+        self.assertEqual(sink.path, "/%s" % (FULL,))
+
+    def test_from_api_repr_minimal(self):
+        client = _Client(project=self.PROJECT)
+        FULL = "projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        RESOURCE = {"name": self.SINK_NAME, "destination": self.DESTINATION_URI}
+        klass = self._get_target_class()
+        sink = klass.from_api_repr(RESOURCE, client=client)
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertIsNone(sink.filter_)
+        self.assertIsNone(sink.writer_identity)
+        self.assertIs(sink._client, client)
+        self.assertEqual(sink.project, self.PROJECT)
+        self.assertEqual(sink.full_name, FULL)
+
+    def test_from_api_repr_full(self):
+        client = _Client(project=self.PROJECT)
+        FULL = "projects/%s/sinks/%s" % (self.PROJECT, self.SINK_NAME)
+        RESOURCE = {
+            "name": self.SINK_NAME,
+            "destination": self.DESTINATION_URI,
+            "filter": self.FILTER,
+            "writerIdentity": self.WRITER_IDENTITY,
+        }
+        klass = self._get_target_class()
+        sink = klass.from_api_repr(RESOURCE, client=client)
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertEqual(sink.writer_identity, self.WRITER_IDENTITY)
+        self.assertIs(sink._client, client)
+        self.assertEqual(sink.project, self.PROJECT)
+        self.assertEqual(sink.full_name, FULL)
+
+    def test_create_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.sinks_api = _DummySinksAPI()
+        api._sink_create_response = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+            "writerIdentity": self.WRITER_IDENTITY,
+        }
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client
+        )
+
+        sink.create()
+
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertEqual(sink.writer_identity, self.WRITER_IDENTITY)
+        self.assertEqual(
+            api._sink_create_called_with,
+            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI, False),
+        )
+
+    def test_create_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client1
+        )
+        api = client2.sinks_api = _DummySinksAPI()
+        api._sink_create_response = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+            "writerIdentity": self.WRITER_IDENTITY,
+        }
+
+        sink.create(client=client2, unique_writer_identity=True)
+
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertEqual(sink.writer_identity, self.WRITER_IDENTITY)
+        self.assertEqual(
+            api._sink_create_called_with,
+            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI, True),
+        )
+
+    def test_exists_miss_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.sinks_api = _DummySinksAPI()
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client
+        )
+
+        self.assertFalse(sink.exists())
+
+        self.assertEqual(api._sink_get_called_with, (self.PROJECT, self.SINK_NAME))
+
+    def test_exists_hit_w_alternate_client(self):
+        RESOURCE = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+        }
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.sinks_api = _DummySinksAPI()
+        api._sink_get_response = RESOURCE
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client1
+        )
+
+        self.assertTrue(sink.exists(client=client2))
+
+        self.assertEqual(api._sink_get_called_with, (self.PROJECT, self.SINK_NAME))
+
+    def test_reload_w_bound_client(self):
+        NEW_DESTINATION_URI = "faux.googleapis.com/other"
+        RESOURCE = {"name": self.SINK_NAME, "destination": NEW_DESTINATION_URI}
+        client = _Client(project=self.PROJECT)
+        api = client.sinks_api = _DummySinksAPI()
+        api._sink_get_response = RESOURCE
+        sink = self._make_one(self.SINK_NAME, client=client)
+
+        sink.reload()
+
+        self.assertEqual(sink.destination, NEW_DESTINATION_URI)
+        self.assertIsNone(sink.filter_)
+        self.assertIsNone(sink.writer_identity)
+        self.assertEqual(api._sink_get_called_with, (self.PROJECT, self.SINK_NAME))
+
+    def test_reload_w_alternate_client(self):
+        NEW_FILTER = "logName:syslog AND severity>=INFO"
+        NEW_DESTINATION_URI = "faux.googleapis.com/other"
+        RESOURCE = {
+            "name": self.SINK_NAME,
+            "filter": NEW_FILTER,
+            "destination": NEW_DESTINATION_URI,
+            "writerIdentity": self.WRITER_IDENTITY,
+        }
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.sinks_api = _DummySinksAPI()
+        api._sink_get_response = RESOURCE
+        sink = self._make_one(self.SINK_NAME, client=client1)
+
+        sink.reload(client=client2)
+
+        self.assertEqual(sink.destination, NEW_DESTINATION_URI)
+        self.assertEqual(sink.filter_, NEW_FILTER)
+        self.assertEqual(sink.writer_identity, self.WRITER_IDENTITY)
+        self.assertEqual(api._sink_get_called_with, (self.PROJECT, self.SINK_NAME))
+
+    def test_update_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.sinks_api = _DummySinksAPI()
+        api._sink_update_response = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+            "writerIdentity": self.WRITER_IDENTITY,
+        }
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client
+        )
+
+        sink.update()
+
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertEqual(sink.writer_identity, self.WRITER_IDENTITY)
+        self.assertEqual(
+            api._sink_update_called_with,
+            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI, False),
+        )
+
+    def test_update_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.sinks_api = _DummySinksAPI()
+        api._sink_update_response = {
+            "name": self.SINK_NAME,
+            "filter": self.FILTER,
+            "destination": self.DESTINATION_URI,
+            "writerIdentity": self.WRITER_IDENTITY,
+        }
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client1
+        )
+
+        sink.update(client=client2, unique_writer_identity=True)
+
+        self.assertEqual(sink.name, self.SINK_NAME)
+        self.assertEqual(sink.filter_, self.FILTER)
+        self.assertEqual(sink.destination, self.DESTINATION_URI)
+        self.assertEqual(sink.writer_identity, self.WRITER_IDENTITY)
+        self.assertEqual(
+            api._sink_update_called_with,
+            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI, True),
+        )
+
+    def test_delete_w_bound_client(self):
+        client = _Client(project=self.PROJECT)
+        api = client.sinks_api = _DummySinksAPI()
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client
+        )
+
+        sink.delete()
+
+        self.assertEqual(api._sink_delete_called_with, (self.PROJECT, self.SINK_NAME))
+
+    def test_delete_w_alternate_client(self):
+        client1 = _Client(project=self.PROJECT)
+        client2 = _Client(project=self.PROJECT)
+        api = client2.sinks_api = _DummySinksAPI()
+        sink = self._make_one(
+            self.SINK_NAME, self.FILTER, self.DESTINATION_URI, client=client1
+        )
+
+        sink.delete(client=client2)
+
+        self.assertEqual(api._sink_delete_called_with, (self.PROJECT, self.SINK_NAME))
+
+
+class _Client(object):
+    def __init__(self, project):
+        self.project = project
+
+
+class _DummySinksAPI(object):
+    def sink_create(
+        self, project, sink_name, filter_, destination, unique_writer_identity=False
+    ):
+        self._sink_create_called_with = (
+            project,
+            sink_name,
+            filter_,
+            destination,
+            unique_writer_identity,
+        )
+        return self._sink_create_response
+
+    def sink_get(self, project, sink_name):
+        from google.cloud.exceptions import NotFound
+
+        self._sink_get_called_with = (project, sink_name)
+        try:
+            return self._sink_get_response
+        except AttributeError:
+            raise NotFound("miss")
+
+    def sink_update(
+        self, project, sink_name, filter_, destination, unique_writer_identity=False
+    ):
+        self._sink_update_called_with = (
+            project,
+            sink_name,
+            filter_,
+            destination,
+            unique_writer_identity,
+        )
+        return self._sink_update_response
+
+    def sink_delete(self, project, sink_name):
+        self._sink_delete_called_with = (project, sink_name)
diff --git a/monitoring/.coveragerc b/monitoring/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/monitoring/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/monitoring/.flake8 b/monitoring/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/monitoring/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/monitoring/.repo-metadata.json b/monitoring/.repo-metadata.json
new file mode 100644
index 000000000000..48920988588f
--- /dev/null
+++ b/monitoring/.repo-metadata.json
@@ -0,0 +1,12 @@
+{
+  "name": "monitoring",
+  "name_pretty": "Stackdriver Monitoring",
+  "product_documentation": "https://cloud.google.com/monitoring/docs",
+  "client_documentation": "https://googleapis.dev/python/monitoring/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559785",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-monitoring",
+  "api_id": "monitoring.googleapis.com"
+}
\ No newline at end of file
diff --git a/monitoring/CHANGELOG.md b/monitoring/CHANGELOG.md
new file mode 100644
index 000000000000..4381307d822c
--- /dev/null
+++ b/monitoring/CHANGELOG.md
@@ -0,0 +1,172 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-monitoring/#history
+
+## 0.33.0
+
+08-12-2019 13:54 PDT
+
+### New Features
+- Add notification channel verification; remove send/recv msg size limit (via synth). ([#8980](https://github.com/googleapis/google-cloud-python/pull/8980))
+
+### Documentation
+- Normalize docs. ([#8994](https://github.com/googleapis/google-cloud-python/pull/8994))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.32.0
+
+07-24-2019 16:52 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth).  ([#8397](https://github.com/googleapis/google-cloud-python/pull/8397))
+- Add routing header to method metadata, update docs config (via synth).  ([#7642](https://github.com/googleapis/google-cloud-python/pull/7642))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Remove unused message exports. ([#7271](https://github.com/googleapis/google-cloud-python/pull/7271))
+- Protoc-generated serialization update. ([#7089](https://github.com/googleapis/google-cloud-python/pull/7089))
+- Pick up stub docstring fix in GAPIC generator. ([#6976](https://github.com/googleapis/google-cloud-python/pull/6976))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8516](https://github.com/googleapis/google-cloud-python/pull/8516))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fixes [#8545](https://github.com/googleapis/google-cloud-python/pull/8545) by removing typing information for kwargs to not conflict with type checkers ([#8546](https://github.com/googleapis/google-cloud-python/pull/8546))
+- Update docstrings, copy lintified proto files (via synth). ([#7451](https://github.com/googleapis/google-cloud-python/pull/7451))
+- googlecloudplatform --> googleapis in READMEs ([#7411](https://github.com/googleapis/google-cloud-python/pull/7411))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright: 2018 -> 2019. ([#7151](https://github.com/googleapis/google-cloud-python/pull/7151))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8358](https://github.com/googleapis/google-cloud-python/pull/8358))
+- Add disclaimer to auto-generated template files (via synth). ([#8321](https://github.com/googleapis/google-cloud-python/pull/8321))
+- Fix coverage in 'types.py' (via synth). ([#8159](https://github.com/googleapis/google-cloud-python/pull/8159))
+- Add empty lines (via synth). ([#8065](https://github.com/googleapis/google-cloud-python/pull/8065))
+- Add nox session `docs` (via synth). ([#7777](https://github.com/googleapis/google-cloud-python/pull/7777))
+- Regenerate VPCSC tests to include NotificationChannelService and UptimeCheckService. ([#7853](https://github.com/googleapis/google-cloud-python/pull/7853))
+- Set environment variables for VPCSC system tests. ([#7847](https://github.com/googleapis/google-cloud-python/pull/7847))
+- Add VPCSC system test. ([#7791](https://github.com/googleapis/google-cloud-python/pull/7791))
+- protobuf file housekeeping (no user-visible changes) (via synth).  ([#7588](https://github.com/googleapis/google-cloud-python/pull/7588))
+- Add clarifying comment to blacken nox target. ([#7398](https://github.com/googleapis/google-cloud-python/pull/7398))
+- Trivial gapic-generator change. ([#7231](https://github.com/googleapis/google-cloud-python/pull/7231))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.31.1
+
+12-17-2018 16:51 PST
+
+
+### Implementation Changes
+- Import  `iam.policy` from `google.api_core.iam.policy`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize docs for `page_size` / `max_results` / `page_token`. ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+
+## 0.31.0
+
+11-29-2018 13:03 PST
+
+
+### Implementation Changes
+- Pick up enum fixes in the GAPIC generator. ([#6614](https://github.com/googleapis/google-cloud-python/pull/6614))
+- Pick up fixes to the GAPIC generator. ([#6501](https://github.com/googleapis/google-cloud-python/pull/6501))
+- Fix client_info bug, update docstrings and timeouts. ([#6416](https://github.com/googleapis/google-cloud-python/pull/6416))
+
+### Dependencies
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Docstring changes, 'account' -> 'workspace', via synth. ([#6461](https://github.com/googleapis/google-cloud-python/pull/6461))
+- Add 'dropped_labels', 'span_context', plus docstring changes. ([#6358](https://github.com/googleapis/google-cloud-python/pull/6358))
+- Fix GAX fossils ([#6264](https://github.com/googleapis/google-cloud-python/pull/6264))
+- Harmonize / DRY 'monitoring/README.rst' / 'monitoring/docs/index.rst'. ([#6156](https://github.com/googleapis/google-cloud-python/pull/6156))
+
+### Internal / Testing Changes
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Assorted synth fixups / cleanups ([#6400](https://github.com/googleapis/google-cloud-python/pull/6400))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Fix long lines from autosynth ([#5961](https://github.com/googleapis/google-cloud-python/pull/5961)
+- Test pandas under all supported Python versions ([#5858](https://github.com/googleapis/google-cloud-python/pull/5858))
+
+## 0.30.1
+
+### Implementation Changes
+- Monitoring: Add Transports Layer to clients (#5594)
+- Remove gRPC size restrictions (4MB default) (#5594)
+
+### Documentation
+- Monitoring. Update documentation links. (#5557)
+
+## 0.30.0
+
+### Implementation Changes
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+
+### New Features
+- Add aliases for new V3 service clients. (#5424)
+
+### Documentation
+- Remove link to `usage` on index of monitoring (#5272)
+
+### Internal / Testing Changes
+- Modify system tests to use prerelease versions of grpcio (#5304)
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+
+## 0.29.0
+
+### Implementation Changes
+- Update monitoring library to use new generated client (#5212)
+- Move aligner and reducer links from timeSeries.list to alertPolicies (#5011)
+
+### Internal / Testing Changes
+- Fix bad trove classifier
+
+## 0.28.1
+
+### Implementation changes
+
+- Convert label values to str in client.metric() (#4910)
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-monitoring/0.28.0/
diff --git a/monitoring/LICENSE b/monitoring/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/monitoring/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/monitoring/MANIFEST.in b/monitoring/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/monitoring/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/monitoring/README.rst b/monitoring/README.rst
new file mode 100644
index 000000000000..1f12505797eb
--- /dev/null
+++ b/monitoring/README.rst
@@ -0,0 +1,114 @@
+Python Client for Stackdriver Monitoring API (`Alpha`_)
+=======================================================
+
+|pypi| |versions| 
+
+`Stackdriver Monitoring API`_: 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.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-monitoring.svg
+   :target: https://pypi.org/project/google-cloud-monitoring/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-monitoring.svg
+   :target: https://pypi.org/project/google-cloud-monitoring/
+.. _Stackdriver Monitoring API: https://cloud.google.com/monitoring/api/ref_v3/rest/
+.. _Client Library Documentation: https://googleapis.dev/python/monitoring/latest
+.. _Product Documentation:  https://cloud.google.com/monitoring/docs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Stackdriver Monitoring API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Stackdriver Monitoring API.:  https://cloud.google.com/monitoring/api/enable-api
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-monitoring
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-monitoring
+
+Preview
+~~~~~~~
+
+MetricServiceClient
+^^^^^^^^^^^^^^^^^^^
+
+.. code:: py
+
+    from google.cloud import monitoring_v3
+
+    client = monitoring_v3.MetricServiceClient()
+
+    name = client.project_path('[PROJECT]')
+
+
+    # Iterate over all results
+    for element in client.list_monitored_resource_descriptors(name):
+        # process element
+        pass
+
+    # Or iterate over results one page at a time
+    for page in client.list_monitored_resource_descriptors(name).pages:
+        for element in page:
+            # process element
+            pass
+
+Next Steps
+~~~~~~~~~~
+
+
+-  Read the `Client Library Documentation`_ for Stackdriver Monitoring API
+   to see other available methods on the client.
+-  Read the `Product documentation`_ to learn more about the product and see
+   How-to Guides.
diff --git a/monitoring/docs/README.rst b/monitoring/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/monitoring/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/monitoring/docs/changelog.md b/monitoring/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/monitoring/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/monitoring/docs/conf.py b/monitoring/docs/conf.py
new file mode 100644
index 000000000000..1827382440ff
--- /dev/null
+++ b/monitoring/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-monitoring documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-monitoring"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-monitoring-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-monitoring.tex",
+        u"google-cloud-monitoring Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-monitoring",
+        u"google-cloud-monitoring Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-monitoring",
+        u"google-cloud-monitoring Documentation",
+        author,
+        "google-cloud-monitoring",
+        "GAPIC library for the {metadata.shortName} v3 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/monitoring/docs/gapic/v3/api.rst b/monitoring/docs/gapic/v3/api.rst
new file mode 100644
index 000000000000..615e004633e5
--- /dev/null
+++ b/monitoring/docs/gapic/v3/api.rst
@@ -0,0 +1,6 @@
+Client for Stackdriver Monitoring API
+=====================================
+
+.. automodule:: google.cloud.monitoring_v3
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/monitoring/docs/gapic/v3/types.rst b/monitoring/docs/gapic/v3/types.rst
new file mode 100644
index 000000000000..9790a948460e
--- /dev/null
+++ b/monitoring/docs/gapic/v3/types.rst
@@ -0,0 +1,5 @@
+Types for Stackdriver Monitoring API Client
+===========================================
+
+.. automodule:: google.cloud.monitoring_v3.types
+    :members:
\ No newline at end of file
diff --git a/monitoring/docs/index.rst b/monitoring/docs/index.rst
new file mode 100644
index 000000000000..49d617e4d0f7
--- /dev/null
+++ b/monitoring/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    query.rst
+    gapic/v3/api
+    gapic/v3/types
+
+Changelog
+---------
+
+For a list of all previous ``google-cloud-monitoring`` releases.
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/monitoring/docs/query.rst b/monitoring/docs/query.rst
new file mode 100644
index 000000000000..d52fd7f19077
--- /dev/null
+++ b/monitoring/docs/query.rst
@@ -0,0 +1,6 @@
+Time Series Query
+=================
+
+.. automodule:: google.cloud.monitoring_v3.query
+  :members:
+  :show-inheritance:
diff --git a/monitoring/google/__init__.py b/monitoring/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/monitoring/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/monitoring/google/cloud/__init__.py b/monitoring/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/monitoring/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/monitoring/google/cloud/monitoring.py b/monitoring/google/cloud/monitoring.py
new file mode 100644
index 000000000000..a6b0063387b9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring.py
@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.monitoring_v3 import AlertPolicyServiceClient
+from google.cloud.monitoring_v3 import GroupServiceClient
+from google.cloud.monitoring_v3 import MetricServiceClient
+from google.cloud.monitoring_v3 import NotificationChannelServiceClient
+from google.cloud.monitoring_v3 import UptimeCheckServiceClient
+from google.cloud.monitoring_v3 import enums
+from google.cloud.monitoring_v3 import types
+
+
+__all__ = (
+    "enums",
+    "types",
+    "AlertPolicyServiceClient",
+    "GroupServiceClient",
+    "MetricServiceClient",
+    "NotificationChannelServiceClient",
+    "UptimeCheckServiceClient",
+)
diff --git a/monitoring/google/cloud/monitoring_v3/__init__.py b/monitoring/google/cloud/monitoring_v3/__init__.py
new file mode 100644
index 000000000000..9aeee930f849
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/__init__.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.monitoring_v3 import types
+from google.cloud.monitoring_v3.gapic import alert_policy_service_client
+from google.cloud.monitoring_v3.gapic import enums
+from google.cloud.monitoring_v3.gapic import group_service_client
+from google.cloud.monitoring_v3.gapic import metric_service_client
+from google.cloud.monitoring_v3.gapic import (
+    notification_channel_service_client as notification_client,
+)
+from google.cloud.monitoring_v3.gapic import uptime_check_service_client
+
+
+class AlertPolicyServiceClient(alert_policy_service_client.AlertPolicyServiceClient):
+    __doc__ = alert_policy_service_client.AlertPolicyServiceClient.__doc__
+    enums = enums
+
+
+class GroupServiceClient(group_service_client.GroupServiceClient):
+    __doc__ = group_service_client.GroupServiceClient.__doc__
+    enums = enums
+
+
+class MetricServiceClient(metric_service_client.MetricServiceClient):
+    __doc__ = metric_service_client.MetricServiceClient.__doc__
+    enums = enums
+
+
+class NotificationChannelServiceClient(
+    notification_client.NotificationChannelServiceClient
+):
+    __doc__ = notification_client.NotificationChannelServiceClient.__doc__
+    enums = enums
+
+
+class UptimeCheckServiceClient(uptime_check_service_client.UptimeCheckServiceClient):
+    __doc__ = uptime_check_service_client.UptimeCheckServiceClient.__doc__
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "AlertPolicyServiceClient",
+    "GroupServiceClient",
+    "MetricServiceClient",
+    "NotificationChannelServiceClient",
+    "UptimeCheckServiceClient",
+)
diff --git a/monitoring/google/cloud/monitoring_v3/_dataframe.py b/monitoring/google/cloud/monitoring_v3/_dataframe.py
new file mode 100644
index 000000000000..5bedb39bc356
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/_dataframe.py
@@ -0,0 +1,147 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Time series as :mod:`pandas` dataframes."""
+
+import itertools
+
+try:
+    import pandas
+except ImportError:  # pragma: NO COVER
+    pandas = None
+
+from google.cloud.monitoring_v3.types import TimeSeries
+
+TOP_RESOURCE_LABELS = ("project_id", "aws_account", "location", "region", "zone")
+
+
+def _extract_header(time_series):
+    """Return a copy of time_series with the points removed."""
+    return TimeSeries(
+        metric=time_series.metric,
+        resource=time_series.resource,
+        metric_kind=time_series.metric_kind,
+        value_type=time_series.value_type,
+    )
+
+
+def _extract_labels(time_series):
+    """Build the combined resource and metric labels, with resource_type."""
+    labels = {"resource_type": time_series.resource.type}
+    labels.update(time_series.resource.labels)
+    labels.update(time_series.metric.labels)
+    return labels
+
+
+def _extract_value(typed_value):
+    """Extract the value from a TypedValue."""
+    value_type = typed_value.WhichOneof("value")
+    return typed_value.__getattribute__(value_type)
+
+
+def _build_dataframe(time_series_iterable, label=None, labels=None):  # pragma: NO COVER
+    """Build a :mod:`pandas` dataframe out of time series.
+
+    :type time_series_iterable:
+        iterable over :class:`~google.cloud.monitoring_v3.types.TimeSeries`
+    :param time_series_iterable:
+        An iterable (e.g., a query object) yielding time series.
+
+    :type label: str
+    :param label:
+        (Optional) The label name to use for the dataframe header. This can be
+        the name of a resource label or metric label (e.g.,
+        ``"instance_name"``), or the string ``"resource_type"``.
+
+    :type labels: list of strings, or None
+    :param labels:
+        A list or tuple of label names to use for the dataframe header.
+        If more than one label name is provided, the resulting dataframe
+        will have a multi-level column header.
+
+        Specifying neither ``label`` or ``labels`` results in a dataframe
+        with a multi-level column header including the resource type and
+        all available resource and metric labels.
+
+        Specifying both ``label`` and ``labels`` is an error.
+
+    :rtype: :class:`pandas.DataFrame`
+    :returns: A dataframe where each column represents one time series.
+
+    :raises: :exc:`RuntimeError` if `pandas` is not installed.
+    """
+    if pandas is None:
+        raise RuntimeError("This method requires `pandas` to be installed.")
+
+    if label is not None:
+        if labels:
+            raise ValueError("Cannot specify both `label` and `labels`.")
+        labels = (label,)
+
+    columns = []
+    headers = []
+    for time_series in time_series_iterable:
+        pandas_series = pandas.Series(
+            data=[_extract_value(point.value) for point in time_series.points],
+            index=[
+                point.interval.end_time.ToNanoseconds() for point in time_series.points
+            ],
+        )
+        columns.append(pandas_series)
+        headers.append(_extract_header(time_series))
+
+    # Implement a smart default of using all available labels.
+    if labels is None:
+        resource_labels = set(
+            itertools.chain.from_iterable(header.resource.labels for header in headers)
+        )
+        metric_labels = set(
+            itertools.chain.from_iterable(header.metric.labels for header in headers)
+        )
+        labels = (
+            ["resource_type"]
+            + _sorted_resource_labels(resource_labels)
+            + sorted(metric_labels)
+        )
+
+    # Assemble the columns into a DataFrame.
+    dataframe = pandas.DataFrame.from_records(columns).T
+
+    # Convert the timestamp strings into a DatetimeIndex.
+    dataframe.index = pandas.to_datetime(dataframe.index)
+
+    # Build a multi-level stack of column headers. Some labels may
+    # be undefined for some time series.
+    levels = []
+    for key in labels:
+        level = [_extract_labels(header).get(key, "") for header in headers]
+        levels.append(level)
+
+    # Build a column Index or MultiIndex. Do not include level names
+    # in the column header if the user requested a single-level header
+    # by specifying "label".
+    dataframe.columns = pandas.MultiIndex.from_arrays(
+        levels, names=labels if not label else None
+    )
+
+    # Sort the rows just in case (since the API doesn't guarantee the
+    # ordering), and sort the columns lexicographically.
+    return dataframe.sort_index(axis=0).sort_index(axis=1)
+
+
+def _sorted_resource_labels(labels):
+    """Sort label names, putting well-known resource labels first."""
+    head = [label for label in TOP_RESOURCE_LABELS if label in labels]
+    tail = sorted(label for label in labels if label not in TOP_RESOURCE_LABELS)
+    return head + tail
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/__init__.py b/monitoring/google/cloud/monitoring_v3/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py
new file mode 100644
index 000000000000..d13448b52d93
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client.py
@@ -0,0 +1,701 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.monitoring.v3 AlertPolicyService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.monitoring_v3.gapic import alert_policy_service_client_config
+from google.cloud.monitoring_v3.gapic import enums
+from google.cloud.monitoring_v3.gapic.transports import (
+    alert_policy_service_grpc_transport,
+)
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-monitoring"
+).version
+
+
+class AlertPolicyServiceClient(object):
+    """
+    The AlertPolicyService API is used to manage (list, create, delete,
+    edit) alert policies in Stackdriver Monitoring. An alerting policy is 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. In addition to using this API, alert policies can also
+    be managed through `Stackdriver
+    Monitoring <https://cloud.google.com/monitoring/docs/>`__, which can be
+    reached by clicking the "Monitoring" tab in `Cloud
+    Console <https://console.cloud.google.com/>`__.
+    """
+
+    SERVICE_ADDRESS = "monitoring.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.monitoring.v3.AlertPolicyService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            AlertPolicyServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def alert_policy_path(cls, project, alert_policy):
+        """Return a fully-qualified alert_policy string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/alertPolicies/{alert_policy}",
+            project=project,
+            alert_policy=alert_policy,
+        )
+
+    @classmethod
+    def alert_policy_condition_path(cls, project, alert_policy, condition):
+        """Return a fully-qualified alert_policy_condition string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}",
+            project=project,
+            alert_policy=alert_policy,
+            condition=condition,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.AlertPolicyServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.AlertPolicyServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = alert_policy_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=alert_policy_service_grpc_transport.AlertPolicyServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = alert_policy_service_grpc_transport.AlertPolicyServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_alert_policies(
+        self,
+        name,
+        filter_=None,
+        order_by=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the existing alerting policies for the project.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.AlertPolicyServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_alert_policies(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_alert_policies(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The project whose alert policies are to be listed. The format is
+
+                     projects/[PROJECT_ID]
+
+                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`` operation, instead.
+            filter_ (str): 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 <https://cloud.google.com/monitoring/api/v3/sorting-and-filtering>`__.
+            order_by (str): A comma-separated list of fields by which to sort the result. Supports
+                the same set of field references as the ``filter`` field. Entries can be
+                prefixed with a minus sign to sort by the field in descending order.
+
+                For more details, see `sorting and
+                filtering <https://cloud.google.com/monitoring/api/v3/sorting-and-filtering>`__.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.AlertPolicy` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_alert_policies" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_alert_policies"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_alert_policies,
+                default_retry=self._method_configs["ListAlertPolicies"].retry,
+                default_timeout=self._method_configs["ListAlertPolicies"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = alert_service_pb2.ListAlertPoliciesRequest(
+            name=name, filter=filter_, order_by=order_by, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_alert_policies"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="alert_policies",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_alert_policy(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single alerting policy.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.AlertPolicyServiceClient()
+            >>>
+            >>> name = client.alert_policy_path('[PROJECT]', '[ALERT_POLICY]')
+            >>>
+            >>> response = client.get_alert_policy(name)
+
+        Args:
+            name (str): The alerting policy to retrieve. The format is
+
+                     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.AlertPolicy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_alert_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_alert_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_alert_policy,
+                default_retry=self._method_configs["GetAlertPolicy"].retry,
+                default_timeout=self._method_configs["GetAlertPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = alert_service_pb2.GetAlertPolicyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_alert_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_alert_policy(
+        self,
+        name,
+        alert_policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new alerting policy.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.AlertPolicyServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `alert_policy`:
+            >>> alert_policy = {}
+            >>>
+            >>> response = client.create_alert_policy(name, alert_policy)
+
+        Args:
+            name (str): The project in which to create the alerting policy. The format is
+                ``projects/[PROJECT_ID]``.
+
+                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.
+            alert_policy (Union[dict, ~google.cloud.monitoring_v3.types.AlertPolicy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.AlertPolicy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.AlertPolicy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_alert_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_alert_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_alert_policy,
+                default_retry=self._method_configs["CreateAlertPolicy"].retry,
+                default_timeout=self._method_configs["CreateAlertPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = alert_service_pb2.CreateAlertPolicyRequest(
+            name=name, alert_policy=alert_policy
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_alert_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_alert_policy(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an alerting policy.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.AlertPolicyServiceClient()
+            >>>
+            >>> name = client.alert_policy_path('[PROJECT]', '[ALERT_POLICY]')
+            >>>
+            >>> client.delete_alert_policy(name)
+
+        Args:
+            name (str): The alerting policy to delete. The format is:
+
+                     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+
+                For more information, see ``AlertPolicy``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_alert_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_alert_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_alert_policy,
+                default_retry=self._method_configs["DeleteAlertPolicy"].retry,
+                default_timeout=self._method_configs["DeleteAlertPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = alert_service_pb2.DeleteAlertPolicyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_alert_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_alert_policy(
+        self,
+        alert_policy,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an alerting policy. You can either replace the entire policy
+        with a new one or replace only certain fields in the current alerting
+        policy by specifying the fields to be updated via ``updateMask``.
+        Returns the updated alerting policy.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.AlertPolicyServiceClient()
+            >>>
+            >>> # TODO: Initialize `alert_policy`:
+            >>> alert_policy = {}
+            >>>
+            >>> response = client.update_alert_policy(alert_policy)
+
+        Args:
+            alert_policy (Union[dict, ~google.cloud.monitoring_v3.types.AlertPolicy]): Required. The updated alerting policy or the updated values for the
+                fields listed in ``update_mask``. If ``update_mask`` is not empty, any
+                fields in this policy that are not in ``update_mask`` are ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.AlertPolicy`
+            update_mask (Union[dict, ~google.cloud.monitoring_v3.types.FieldMask]): Optional. A list of alerting policy field names. If this field is not
+                empty, each listed field in the existing alerting policy is set to the
+                value of the corresponding field in the supplied policy
+                (``alert_policy``), or to the field's default value if the field is not
+                in the supplied alerting policy. Fields not listed retain their previous
+                value.
+
+                Examples of valid field masks include ``display_name``,
+                ``documentation``, ``documentation.content``,
+                ``documentation.mime_type``, ``user_labels``, ``user_label.nameofkey``,
+                ``enabled``, ``conditions``, ``combiner``, etc.
+
+                If this field is empty, then the supplied alerting policy replaces the
+                existing policy. It is the same as deleting the existing policy and
+                adding the supplied policy, except for the following:
+
+                -  The new policy will have the same ``[ALERT_POLICY_ID]`` as the former
+                   policy. This gives you continuity with the former policy in your
+                   notifications and incidents.
+                -  Conditions in the new policy will keep their former
+                   ``[CONDITION_ID]`` if the supplied condition includes the ``name``
+                   field with that ``[CONDITION_ID]``. If the supplied condition omits
+                   the ``name`` field, then a new ``[CONDITION_ID]`` is created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.AlertPolicy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_alert_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_alert_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_alert_policy,
+                default_retry=self._method_configs["UpdateAlertPolicy"].retry,
+                default_timeout=self._method_configs["UpdateAlertPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = alert_service_pb2.UpdateAlertPolicyRequest(
+            alert_policy=alert_policy, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("alert_policy.name", alert_policy.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_alert_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client_config.py b/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client_config.py
new file mode 100644
index 000000000000..279c75403897
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/alert_policy_service_client_config.py
@@ -0,0 +1,48 @@
+config = {
+    "interfaces": {
+        "google.monitoring.v3.AlertPolicyService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListAlertPolicies": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetAlertPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateAlertPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteAlertPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateAlertPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/enums.py b/monitoring/google/cloud/monitoring_v3/gapic/enums.py
new file mode 100644
index 000000000000..56f903a8290c
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/enums.py
@@ -0,0 +1,500 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ComparisonType(enum.IntEnum):
+    """
+    Specifies an ordering relationship on two arguments, here called left and
+    right.
+
+    Attributes:
+      COMPARISON_UNSPECIFIED (int): No ordering relationship is specified.
+      COMPARISON_GT (int): The left argument is greater than the right argument.
+      COMPARISON_GE (int): The left argument is greater than or equal to the right argument.
+      COMPARISON_LT (int): The left argument is less than the right argument.
+      COMPARISON_LE (int): The left argument is less than or equal to the right argument.
+      COMPARISON_EQ (int): The left argument is equal to the right argument.
+      COMPARISON_NE (int): The left argument is not equal to the right argument.
+    """
+
+    COMPARISON_UNSPECIFIED = 0
+    COMPARISON_GT = 1
+    COMPARISON_GE = 2
+    COMPARISON_LT = 3
+    COMPARISON_LE = 4
+    COMPARISON_EQ = 5
+    COMPARISON_NE = 6
+
+
+class GroupResourceType(enum.IntEnum):
+    """
+    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. The resource types ``gae_app``
+    and ``uptime_url`` are not valid here because group checks on App Engine
+    modules and URLs are not allowed.
+
+    Attributes:
+      RESOURCE_TYPE_UNSPECIFIED (int): Default value (not valid).
+      INSTANCE (int): A group of instances from Google Cloud Platform (GCP) or
+      Amazon Web Services (AWS).
+      AWS_ELB_LOAD_BALANCER (int): A group of Amazon ELB load balancers.
+    """
+
+    RESOURCE_TYPE_UNSPECIFIED = 0
+    INSTANCE = 1
+    AWS_ELB_LOAD_BALANCER = 2
+
+
+class LaunchStage(enum.IntEnum):
+    """
+    The launch stage as defined by `Google Cloud Platform Launch
+    Stages <http://cloud.google.com/terms/launch-stages>`__.
+
+    Attributes:
+      LAUNCH_STAGE_UNSPECIFIED (int): Do not use this default value.
+      EARLY_ACCESS (int): Early Access features are limited to a closed group of testers. To use
+      these features, you must sign up in advance and sign a Trusted Tester
+      agreement (which includes confidentiality provisions). These features may
+      be unstable, changed in backward-incompatible ways, and are not
+      guaranteed to be released.
+      ALPHA (int): Alpha is a limited availability test for releases before they are cleared
+      for widespread use. By Alpha, all significant design issues are resolved
+      and we are in the process of verifying functionality. Alpha customers
+      need to apply for access, agree to applicable terms, and have their
+      projects whitelisted. Alpha releases don’t have to be feature complete,
+      no SLAs are provided, and there are no technical support obligations, but
+      they will be far enough along that customers can actually use them in
+      test environments or for limited-use tests -- just like they would in
+      normal production cases.
+      BETA (int): Beta is the point at which we are ready to open a release for any
+      customer to use. There are no SLA or technical support obligations in a
+      Beta release. Products will be complete from a feature perspective, but
+      may have some open outstanding issues. Beta releases are suitable for
+      limited production use cases.
+      GA (int): GA features are open to all developers and are considered stable and
+      fully qualified for production use.
+      DEPRECATED (int): Deprecated features are scheduled to be shut down and removed. For more
+      information, see the “Deprecation Policy” section of our `Terms of
+      Service <https://cloud.google.com/terms/>`__ and the `Google Cloud
+      Platform Subject to the Deprecation
+      Policy <https://cloud.google.com/terms/deprecation>`__ documentation.
+    """
+
+    LAUNCH_STAGE_UNSPECIFIED = 0
+    EARLY_ACCESS = 1
+    ALPHA = 2
+    BETA = 3
+    GA = 4
+    DEPRECATED = 5
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class ServiceTier(enum.IntEnum):
+    """
+    The tier of service for a Workspace. Please see the `service tiers
+    documentation <https://cloud.google.com/monitoring/workspaces/tiers>`__
+    for more details.
+
+    Attributes:
+      SERVICE_TIER_UNSPECIFIED (int): An invalid sentinel value, used to indicate that a tier has not
+      been provided explicitly.
+      SERVICE_TIER_BASIC (int): The Stackdriver Basic tier, a free tier of service that provides basic
+      features, a moderate allotment of logs, and access to built-in metrics.
+      A number of features are not available in this tier. For more details,
+      see `the service tiers
+      documentation <https://cloud.google.com/monitoring/workspaces/tiers>`__.
+      SERVICE_TIER_PREMIUM (int): The Stackdriver Premium tier, a higher, more expensive tier of service
+      that provides access to all Stackdriver features, lets you use
+      Stackdriver with AWS accounts, and has a larger allotments for logs and
+      metrics. For more details, see `the service tiers
+      documentation <https://cloud.google.com/monitoring/workspaces/tiers>`__.
+    """
+
+    SERVICE_TIER_UNSPECIFIED = 0
+    SERVICE_TIER_BASIC = 1
+    SERVICE_TIER_PREMIUM = 2
+
+
+class UptimeCheckRegion(enum.IntEnum):
+    """
+    The regions from which an uptime check can be run.
+
+    Attributes:
+      REGION_UNSPECIFIED (int): Default value if no region is specified. Will result in uptime checks
+      running from all regions.
+      USA (int): Allows checks to run from locations within the United States of America.
+      EUROPE (int): Allows checks to run from locations within the continent of Europe.
+      SOUTH_AMERICA (int): Allows checks to run from locations within the continent of South
+      America.
+      ASIA_PACIFIC (int): Allows checks to run from locations within the Asia Pacific area (ex:
+      Singapore).
+    """
+
+    REGION_UNSPECIFIED = 0
+    USA = 1
+    EUROPE = 2
+    SOUTH_AMERICA = 3
+    ASIA_PACIFIC = 4
+
+
+class Aggregation(object):
+    class Aligner(enum.IntEnum):
+        """
+        The Aligner describes how to bring the data points in a single
+        time series into temporal alignment.
+
+        Attributes:
+          ALIGN_NONE (int): 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_DELTA (int): 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_RATE (int): 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``.
+
+          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_INTERPOLATE (int): 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_NEXT_OLDER (int): 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_MIN (int): 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_MAX (int): 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_MEAN (int): 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``.
+          ALIGN_COUNT (int): 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``.
+          ALIGN_SUM (int): 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_STDDEV (int): 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``.
+          ALIGN_COUNT_TRUE (int): 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``.
+          ALIGN_COUNT_FALSE (int): 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``.
+          ALIGN_FRACTION_TRUE (int): 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``.
+          ALIGN_PERCENTILE_99 (int): 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``.
+          ALIGN_PERCENTILE_95 (int): 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``.
+          ALIGN_PERCENTILE_50 (int): 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``.
+          ALIGN_PERCENTILE_05 (int): 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``.
+          ALIGN_PERCENT_CHANGE (int): 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``.
+        """
+
+        ALIGN_NONE = 0
+        ALIGN_DELTA = 1
+        ALIGN_RATE = 2
+        ALIGN_INTERPOLATE = 3
+        ALIGN_NEXT_OLDER = 4
+        ALIGN_MIN = 10
+        ALIGN_MAX = 11
+        ALIGN_MEAN = 12
+        ALIGN_COUNT = 13
+        ALIGN_SUM = 14
+        ALIGN_STDDEV = 15
+        ALIGN_COUNT_TRUE = 16
+        ALIGN_COUNT_FALSE = 24
+        ALIGN_FRACTION_TRUE = 17
+        ALIGN_PERCENTILE_99 = 18
+        ALIGN_PERCENTILE_95 = 19
+        ALIGN_PERCENTILE_50 = 20
+        ALIGN_PERCENTILE_05 = 21
+        ALIGN_PERCENT_CHANGE = 23
+
+    class Reducer(enum.IntEnum):
+        """
+        A Reducer describes how to aggregate data points from multiple
+        time series into a single time series.
+
+        Attributes:
+          REDUCE_NONE (int): No cross-time series reduction. The output of the aligner is
+          returned.
+          REDUCE_MEAN (int): 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``.
+          REDUCE_MIN (int): 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_MAX (int): 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_SUM (int): 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_STDDEV (int): 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``.
+          REDUCE_COUNT (int): 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``.
+          REDUCE_COUNT_TRUE (int): 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``.
+          REDUCE_COUNT_FALSE (int): 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``.
+          REDUCE_FRACTION_TRUE (int): 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``.
+          REDUCE_PERCENTILE_99 (int): 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``
+          REDUCE_PERCENTILE_95 (int): 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``
+          REDUCE_PERCENTILE_50 (int): 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``
+          REDUCE_PERCENTILE_05 (int): 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``
+        """
+
+        REDUCE_NONE = 0
+        REDUCE_MEAN = 1
+        REDUCE_MIN = 2
+        REDUCE_MAX = 3
+        REDUCE_SUM = 4
+        REDUCE_STDDEV = 5
+        REDUCE_COUNT = 6
+        REDUCE_COUNT_TRUE = 7
+        REDUCE_COUNT_FALSE = 15
+        REDUCE_FRACTION_TRUE = 8
+        REDUCE_PERCENTILE_99 = 9
+        REDUCE_PERCENTILE_95 = 10
+        REDUCE_PERCENTILE_50 = 11
+        REDUCE_PERCENTILE_05 = 12
+
+
+class AlertPolicy(object):
+    class ConditionCombinerType(enum.IntEnum):
+        """
+        Operators for combining conditions.
+
+        Attributes:
+          COMBINE_UNSPECIFIED (int): An unspecified combiner.
+          AND (int): Combine conditions using the logical ``AND`` operator. An incident is
+          created only if all conditions are met simultaneously. This combiner is
+          satisfied if all conditions are met, even if they are met on completely
+          different resources.
+          OR (int): Combine conditions using the logical ``OR`` operator. An incident is
+          created if any of the listed conditions is met.
+          AND_WITH_MATCHING_RESOURCE (int): Combine conditions using logical ``AND`` operator, but unlike the
+          regular ``AND`` option, an incident is created only if all conditions
+          are met simultaneously on at least one resource.
+        """
+
+        COMBINE_UNSPECIFIED = 0
+        AND = 1
+        OR = 2
+        AND_WITH_MATCHING_RESOURCE = 3
+
+
+class LabelDescriptor(object):
+    class ValueType(enum.IntEnum):
+        """
+        Value types that can be used as label values.
+
+        Attributes:
+          STRING (int): A variable-length string. This is the default.
+          BOOL (int): Boolean; true or false.
+          INT64 (int): A 64-bit signed integer.
+        """
+
+        STRING = 0
+        BOOL = 1
+        INT64 = 2
+
+
+class ListTimeSeriesRequest(object):
+    class TimeSeriesView(enum.IntEnum):
+        """
+        Controls which fields are returned by ``ListTimeSeries``.
+
+        Attributes:
+          FULL (int): Returns the identity of the metric(s), the time series,
+          and the time series data.
+          HEADERS (int): Returns the identity of the metric and the time series resource,
+          but not the time series data.
+        """
+
+        FULL = 0
+        HEADERS = 1
+
+
+class MetricDescriptor(object):
+    class MetricKind(enum.IntEnum):
+        """
+        The kind of measurement. It describes how the data is reported.
+
+        Attributes:
+          METRIC_KIND_UNSPECIFIED (int): Do not use this default value.
+          GAUGE (int): An instantaneous measurement of a value.
+          DELTA (int): The change in a value during a time interval.
+          CUMULATIVE (int): A value accumulated over a time interval.  Cumulative
+          measurements in a time series should have the same start time
+          and increasing end times, until an event resets the cumulative
+          value to zero and sets a new start time for the following
+          points.
+        """
+
+        METRIC_KIND_UNSPECIFIED = 0
+        GAUGE = 1
+        DELTA = 2
+        CUMULATIVE = 3
+
+    class ValueType(enum.IntEnum):
+        """
+        The value type of a metric.
+
+        Attributes:
+          VALUE_TYPE_UNSPECIFIED (int): Do not use this default value.
+          BOOL (int): The value is a boolean. This value type can be used only if the metric
+          kind is ``GAUGE``.
+          INT64 (int): The value is a signed 64-bit integer.
+          DOUBLE (int): The value is a double precision floating point number.
+          STRING (int): The value is a text string. This value type can be used only if the
+          metric kind is ``GAUGE``.
+          DISTRIBUTION (int): The value is a ``Distribution``.
+          MONEY (int): The value is money.
+        """
+
+        VALUE_TYPE_UNSPECIFIED = 0
+        BOOL = 1
+        INT64 = 2
+        DOUBLE = 3
+        STRING = 4
+        DISTRIBUTION = 5
+        MONEY = 6
+
+
+class NotificationChannel(object):
+    class VerificationStatus(enum.IntEnum):
+        """
+        Indicates whether the channel has been verified or not. It is illegal to
+        specify this field in a ``CreateNotificationChannel`` or an
+        ``UpdateNotificationChannel`` operation.
+
+        Attributes:
+          VERIFICATION_STATUS_UNSPECIFIED (int): Sentinel value used to indicate that the state is unknown, omitted, or
+          is not applicable (as in the case of channels that neither support
+          nor require verification in order to function).
+          UNVERIFIED (int): The channel has yet to be verified and requires verification to function.
+          Note that this state also applies to the case where the verification
+          process has been initiated by sending a verification code but where
+          the verification code has not been submitted to complete the process.
+          VERIFIED (int): It has been proven that notifications can be received on this
+          notification channel and that someone on the project has access
+          to messages that are delivered to that channel.
+        """
+
+        VERIFICATION_STATUS_UNSPECIFIED = 0
+        UNVERIFIED = 1
+        VERIFIED = 2
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py
new file mode 100644
index 000000000000..463170230044
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/group_service_client.py
@@ -0,0 +1,793 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.monitoring.v3 GroupService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.monitoring_v3.gapic import enums
+from google.cloud.monitoring_v3.gapic import group_service_client_config
+from google.cloud.monitoring_v3.gapic.transports import group_service_grpc_transport
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import common_pb2
+from google.cloud.monitoring_v3.proto import group_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-monitoring"
+).version
+
+
+class GroupServiceClient(object):
+    """
+    The Group API lets you inspect and manage your
+    `groups <#google.monitoring.v3.Group>`__.
+
+    A group is a named filter that is used to identify a collection of
+    monitored resources. Groups are typically used to mirror the physical
+    and/or logical topology of the environment. Because group membership is
+    computed dynamically, monitored resources that are started in the future
+    are automatically placed in matching groups. By using a group to name
+    monitored resources in, for example, an alert policy, the target of that
+    alert policy is updated automatically as monitored resources are added
+    and removed from the infrastructure.
+    """
+
+    SERVICE_ADDRESS = "monitoring.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.monitoring.v3.GroupService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            GroupServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def group_path(cls, project, group):
+        """Return a fully-qualified group string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/groups/{group}", project=project, group=group
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.GroupServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.GroupServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = group_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=group_service_grpc_transport.GroupServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = group_service_grpc_transport.GroupServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_groups(
+        self,
+        name,
+        children_of_group=None,
+        ancestors_of_group=None,
+        descendants_of_group=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the existing groups.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.GroupServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_groups(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_groups(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The project whose groups are to be listed. The format is
+                ``"projects/{project_id_or_number}"``.
+            children_of_group (str): A group name: ``"projects/{project_id_or_number}/groups/{group_id}"``.
+                Returns groups whose ``parentName`` field contains the group name. If no
+                groups have this parent, the results are empty.
+            ancestors_of_group (str): A group name: ``"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.
+            descendants_of_group (str): A group name: ``"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
+                children-of-children, and so forth.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.Group` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_groups" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_groups"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_groups,
+                default_retry=self._method_configs["ListGroups"].retry,
+                default_timeout=self._method_configs["ListGroups"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            children_of_group=children_of_group,
+            ancestors_of_group=ancestors_of_group,
+            descendants_of_group=descendants_of_group,
+        )
+
+        request = group_service_pb2.ListGroupsRequest(
+            name=name,
+            children_of_group=children_of_group,
+            ancestors_of_group=ancestors_of_group,
+            descendants_of_group=descendants_of_group,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_groups"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="group",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_group(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single group.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.GroupServiceClient()
+            >>>
+            >>> name = client.group_path('[PROJECT]', '[GROUP]')
+            >>>
+            >>> response = client.get_group(name)
+
+        Args:
+            name (str): The group to retrieve. The format is
+                ``"projects/{project_id_or_number}/groups/{group_id}"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.Group` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_group" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_group"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_group,
+                default_retry=self._method_configs["GetGroup"].retry,
+                default_timeout=self._method_configs["GetGroup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = group_service_pb2.GetGroupRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_group"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_group(
+        self,
+        name,
+        group,
+        validate_only=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new group.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.GroupServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `group`:
+            >>> group = {}
+            >>>
+            >>> response = client.create_group(name, group)
+
+        Args:
+            name (str): The project in which to create the group. The format is
+                ``"projects/{project_id_or_number}"``.
+            group (Union[dict, ~google.cloud.monitoring_v3.types.Group]): A group definition. It is an error to define the ``name`` field because
+                the system assigns the name.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.Group`
+            validate_only (bool): If true, validate this request but do not create the group.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.Group` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_group" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_group"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_group,
+                default_retry=self._method_configs["CreateGroup"].retry,
+                default_timeout=self._method_configs["CreateGroup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = group_service_pb2.CreateGroupRequest(
+            name=name, group=group, validate_only=validate_only
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_group"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_group(
+        self,
+        group,
+        validate_only=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing group. You can change any group attributes except
+        ``name``.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.GroupServiceClient()
+            >>>
+            >>> # TODO: Initialize `group`:
+            >>> group = {}
+            >>>
+            >>> response = client.update_group(group)
+
+        Args:
+            group (Union[dict, ~google.cloud.monitoring_v3.types.Group]): The new definition of the group. All fields of the existing group,
+                excepting ``name``, are replaced with the corresponding fields of this
+                group.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.Group`
+            validate_only (bool): If true, validate this request but do not update the existing group.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.Group` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_group" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_group"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_group,
+                default_retry=self._method_configs["UpdateGroup"].retry,
+                default_timeout=self._method_configs["UpdateGroup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = group_service_pb2.UpdateGroupRequest(
+            group=group, validate_only=validate_only
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("group.name", group.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_group"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_group(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing group.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.GroupServiceClient()
+            >>>
+            >>> name = client.group_path('[PROJECT]', '[GROUP]')
+            >>>
+            >>> client.delete_group(name)
+
+        Args:
+            name (str): The group to delete. The format is
+                ``"projects/{project_id_or_number}/groups/{group_id}"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_group" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_group"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_group,
+                default_retry=self._method_configs["DeleteGroup"].retry,
+                default_timeout=self._method_configs["DeleteGroup"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = group_service_pb2.DeleteGroupRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_group"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_group_members(
+        self,
+        name,
+        page_size=None,
+        filter_=None,
+        interval=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the monitored resources that are members of a group.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.GroupServiceClient()
+            >>>
+            >>> name = client.group_path('[PROJECT]', '[GROUP]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_group_members(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_group_members(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The group whose members are listed. The format is
+                ``"projects/{project_id_or_number}/groups/{group_id}"``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            filter_ (str): 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"
+            interval (Union[dict, ~google.cloud.monitoring_v3.types.TimeInterval]): An optional time interval for which results should be returned. Only
+                members that were part of the group during the specified interval are
+                included in the response.  If no interval is provided then the group
+                membership over the last minute is returned.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.TimeInterval`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.MonitoredResource` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_group_members" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_group_members"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_group_members,
+                default_retry=self._method_configs["ListGroupMembers"].retry,
+                default_timeout=self._method_configs["ListGroupMembers"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = group_service_pb2.ListGroupMembersRequest(
+            name=name, page_size=page_size, filter=filter_, interval=interval
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_group_members"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="members",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/group_service_client_config.py b/monitoring/google/cloud/monitoring_v3/gapic/group_service_client_config.py
new file mode 100644
index 000000000000..24157aaacd5d
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/group_service_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.monitoring.v3.GroupService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListGroups": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetGroup": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateGroup": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateGroup": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteGroup": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListGroupMembers": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py
new file mode 100644
index 000000000000..e57a44129274
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client.py
@@ -0,0 +1,1025 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.monitoring.v3 MetricService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.api import metric_pb2 as api_metric_pb2
+from google.api import monitored_resource_pb2
+from google.cloud.monitoring_v3.gapic import enums
+from google.cloud.monitoring_v3.gapic import metric_service_client_config
+from google.cloud.monitoring_v3.gapic.transports import metric_service_grpc_transport
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import common_pb2
+from google.cloud.monitoring_v3.proto import group_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import metric_pb2 as proto_metric_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-monitoring"
+).version
+
+
+class MetricServiceClient(object):
+    """
+    Manages metric descriptors, monitored resource descriptors, and
+    time series data.
+    """
+
+    SERVICE_ADDRESS = "monitoring.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.monitoring.v3.MetricService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            MetricServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def metric_descriptor_path(cls, project, metric_descriptor):
+        """Return a fully-qualified metric_descriptor string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/metricDescriptors/{metric_descriptor=**}",
+            project=project,
+            metric_descriptor=metric_descriptor,
+        )
+
+    @classmethod
+    def monitored_resource_descriptor_path(cls, project, monitored_resource_descriptor):
+        """Return a fully-qualified monitored_resource_descriptor string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}",
+            project=project,
+            monitored_resource_descriptor=monitored_resource_descriptor,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.MetricServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.MetricServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = metric_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=metric_service_grpc_transport.MetricServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = metric_service_grpc_transport.MetricServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_monitored_resource_descriptors(
+        self,
+        name,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists monitored resource descriptors that match a filter. This method does
+        not require a Stackdriver account.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_monitored_resource_descriptors(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_monitored_resource_descriptors(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The project on which to execute the request. The format is
+                ``"projects/{project_id_or_number}"``.
+            filter_ (str): 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
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.MonitoredResourceDescriptor` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_monitored_resource_descriptors" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_monitored_resource_descriptors"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_monitored_resource_descriptors,
+                default_retry=self._method_configs[
+                    "ListMonitoredResourceDescriptors"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "ListMonitoredResourceDescriptors"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.ListMonitoredResourceDescriptorsRequest(
+            name=name, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_monitored_resource_descriptors"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="resource_descriptors",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_monitored_resource_descriptor(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single monitored resource descriptor. This method does not require a
+        Stackdriver account.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.monitored_resource_descriptor_path('[PROJECT]', '[MONITORED_RESOURCE_DESCRIPTOR]')
+            >>>
+            >>> response = client.get_monitored_resource_descriptor(name)
+
+        Args:
+            name (str): 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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.MonitoredResourceDescriptor` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_monitored_resource_descriptor" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_monitored_resource_descriptor"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_monitored_resource_descriptor,
+                default_retry=self._method_configs[
+                    "GetMonitoredResourceDescriptor"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "GetMonitoredResourceDescriptor"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.GetMonitoredResourceDescriptorRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_monitored_resource_descriptor"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_metric_descriptors(
+        self,
+        name,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists metric descriptors that match a filter. This method does not require
+        a Stackdriver account.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_metric_descriptors(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_metric_descriptors(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The project on which to execute the request. The format is
+                ``"projects/{project_id_or_number}"``.
+            filter_ (str): If this field is empty, all custom and system-defined metric descriptors
+                are returned. 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 <https://cloud.google.com/monitoring/custom-metrics>`__:
+
+                ::
+
+                     metric.type = starts_with("custom.googleapis.com/")
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.MetricDescriptor` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_metric_descriptors" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_metric_descriptors"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_metric_descriptors,
+                default_retry=self._method_configs["ListMetricDescriptors"].retry,
+                default_timeout=self._method_configs["ListMetricDescriptors"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.ListMetricDescriptorsRequest(
+            name=name, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_metric_descriptors"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="metric_descriptors",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_metric_descriptor(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single metric descriptor. This method does not require a Stackdriver
+        account.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.metric_descriptor_path('[PROJECT]', '[METRIC_DESCRIPTOR]')
+            >>>
+            >>> response = client.get_metric_descriptor(name)
+
+        Args:
+            name (str): 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"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.MetricDescriptor` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_metric_descriptor" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_metric_descriptor"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_metric_descriptor,
+                default_retry=self._method_configs["GetMetricDescriptor"].retry,
+                default_timeout=self._method_configs["GetMetricDescriptor"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.GetMetricDescriptorRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_metric_descriptor"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_metric_descriptor(
+        self,
+        name,
+        metric_descriptor,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new metric descriptor. User-created metric descriptors define
+        `custom metrics <https://cloud.google.com/monitoring/custom-metrics>`__.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `metric_descriptor`:
+            >>> metric_descriptor = {}
+            >>>
+            >>> response = client.create_metric_descriptor(name, metric_descriptor)
+
+        Args:
+            name (str): The project on which to execute the request. The format is
+                ``"projects/{project_id_or_number}"``.
+            metric_descriptor (Union[dict, ~google.cloud.monitoring_v3.types.MetricDescriptor]): The new `custom
+                metric <https://cloud.google.com/monitoring/custom-metrics>`__
+                descriptor.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.MetricDescriptor`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.MetricDescriptor` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_metric_descriptor" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_metric_descriptor"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_metric_descriptor,
+                default_retry=self._method_configs["CreateMetricDescriptor"].retry,
+                default_timeout=self._method_configs["CreateMetricDescriptor"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.CreateMetricDescriptorRequest(
+            name=name, metric_descriptor=metric_descriptor
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_metric_descriptor"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_metric_descriptor(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a metric descriptor. Only user-created `custom
+        metrics <https://cloud.google.com/monitoring/custom-metrics>`__ can be
+        deleted.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.metric_descriptor_path('[PROJECT]', '[METRIC_DESCRIPTOR]')
+            >>>
+            >>> client.delete_metric_descriptor(name)
+
+        Args:
+            name (str): 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"``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_metric_descriptor" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_metric_descriptor"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_metric_descriptor,
+                default_retry=self._method_configs["DeleteMetricDescriptor"].retry,
+                default_timeout=self._method_configs["DeleteMetricDescriptor"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.DeleteMetricDescriptorRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_metric_descriptor"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_time_series(
+        self,
+        name,
+        filter_,
+        interval,
+        view,
+        aggregation=None,
+        order_by=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists time series that match a filter. This method does not require a
+        Stackdriver account.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>> from google.cloud.monitoring_v3 import enums
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> # TODO: Initialize `interval`:
+            >>> interval = {}
+            >>>
+            >>> # TODO: Initialize `view`:
+            >>> view = enums.ListTimeSeriesRequest.TimeSeriesView.FULL
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_time_series(name, filter_, interval, view):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_time_series(name, filter_, interval, view).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The project on which to execute the request. The format is
+                "projects/{project\_id\_or\_number}".
+            filter_ (str): 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"
+            interval (Union[dict, ~google.cloud.monitoring_v3.types.TimeInterval]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.TimeInterval`
+            view (~google.cloud.monitoring_v3.types.TimeSeriesView): Specifies which information is returned about the time series.
+            aggregation (Union[dict, ~google.cloud.monitoring_v3.types.Aggregation]): By default, the raw time series data is returned.
+                Use this field to combine multiple time series for different
+                views of the data.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.Aggregation`
+            order_by (str): Unsupported: must be left blank. The points in each time series are
+                returned in reverse time order.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.TimeSeries` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_time_series" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_time_series"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_time_series,
+                default_retry=self._method_configs["ListTimeSeries"].retry,
+                default_timeout=self._method_configs["ListTimeSeries"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.ListTimeSeriesRequest(
+            name=name,
+            filter=filter_,
+            interval=interval,
+            view=view,
+            aggregation=aggregation,
+            order_by=order_by,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_time_series"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="time_series",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_time_series(
+        self,
+        name,
+        time_series,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.MetricServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `time_series`:
+            >>> time_series = []
+            >>>
+            >>> client.create_time_series(name, time_series)
+
+        Args:
+            name (str): The project on which to execute the request. The format is
+                ``"projects/{project_id_or_number}"``.
+            time_series (list[Union[dict, ~google.cloud.monitoring_v3.types.TimeSeries]]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.TimeSeries`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_time_series" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_time_series"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_time_series,
+                default_retry=self._method_configs["CreateTimeSeries"].retry,
+                default_timeout=self._method_configs["CreateTimeSeries"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = metric_service_pb2.CreateTimeSeriesRequest(
+            name=name, time_series=time_series
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["create_time_series"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client_config.py b/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client_config.py
new file mode 100644
index 000000000000..56ae49b29428
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/metric_service_client_config.py
@@ -0,0 +1,63 @@
+config = {
+    "interfaces": {
+        "google.monitoring.v3.MetricService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListMonitoredResourceDescriptors": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetMonitoredResourceDescriptor": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListMetricDescriptors": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetMetricDescriptor": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateMetricDescriptor": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteMetricDescriptor": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTimeSeries": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTimeSeries": {
+                    "timeout_millis": 12000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py
new file mode 100644
index 000000000000..8f77e1b3aff1
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client.py
@@ -0,0 +1,1176 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.monitoring.v3 NotificationChannelService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.api import metric_pb2 as api_metric_pb2
+from google.api import monitored_resource_pb2
+from google.cloud.monitoring_v3.gapic import enums
+from google.cloud.monitoring_v3.gapic import notification_channel_service_client_config
+from google.cloud.monitoring_v3.gapic.transports import (
+    notification_channel_service_grpc_transport,
+)
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import common_pb2
+from google.cloud.monitoring_v3.proto import group_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import metric_pb2 as proto_metric_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import notification_pb2
+from google.cloud.monitoring_v3.proto import notification_service_pb2
+from google.cloud.monitoring_v3.proto import notification_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-monitoring"
+).version
+
+
+class NotificationChannelServiceClient(object):
+    """
+    The Notification Channel API provides access to configuration that
+    controls how messages related to incidents are sent.
+    """
+
+    SERVICE_ADDRESS = "monitoring.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.monitoring.v3.NotificationChannelService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            NotificationChannelServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def notification_channel_path(cls, project, notification_channel):
+        """Return a fully-qualified notification_channel string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/notificationChannels/{notification_channel}",
+            project=project,
+            notification_channel=notification_channel,
+        )
+
+    @classmethod
+    def notification_channel_descriptor_path(cls, project, channel_descriptor):
+        """Return a fully-qualified notification_channel_descriptor string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/notificationChannelDescriptors/{channel_descriptor}",
+            project=project,
+            channel_descriptor=channel_descriptor,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.NotificationChannelServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.NotificationChannelServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = notification_channel_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=notification_channel_service_grpc_transport.NotificationChannelServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = notification_channel_service_grpc_transport.NotificationChannelServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_notification_channel_descriptors(
+        self,
+        name,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the descriptors for supported channel types. The use of descriptors
+        makes it possible for new channel types to be dynamically added.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_notification_channel_descriptors(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_notification_channel_descriptors(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The REST resource name of the parent from which to retrieve the
+                notification channel descriptors. The expected syntax is:
+
+                ::
+
+                     projects/[PROJECT_ID]
+
+                Note that this names the parent container in which to look for the
+                descriptors; to retrieve a single descriptor by name, use the
+                ``GetNotificationChannelDescriptor`` operation, instead.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.NotificationChannelDescriptor` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_notification_channel_descriptors" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_notification_channel_descriptors"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_notification_channel_descriptors,
+                default_retry=self._method_configs[
+                    "ListNotificationChannelDescriptors"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "ListNotificationChannelDescriptors"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.ListNotificationChannelDescriptorsRequest(
+            name=name, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_notification_channel_descriptors"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="channel_descriptors",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_notification_channel_descriptor(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single channel descriptor. The descriptor indicates which fields
+        are expected / permitted for a notification channel of the given type.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.notification_channel_descriptor_path('[PROJECT]', '[CHANNEL_DESCRIPTOR]')
+            >>>
+            >>> response = client.get_notification_channel_descriptor(name)
+
+        Args:
+            name (str): The channel type for which to execute the request. The format is
+                ``projects/[PROJECT_ID]/notificationChannelDescriptors/{channel_type}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.NotificationChannelDescriptor` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_notification_channel_descriptor" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_notification_channel_descriptor"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_notification_channel_descriptor,
+                default_retry=self._method_configs[
+                    "GetNotificationChannelDescriptor"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "GetNotificationChannelDescriptor"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.GetNotificationChannelDescriptorRequest(
+            name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_notification_channel_descriptor"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_notification_channels(
+        self,
+        name,
+        filter_=None,
+        order_by=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the notification channels that have been created for the project.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_notification_channels(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_notification_channels(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The project on which to execute the request. The format is
+                ``projects/[PROJECT_ID]``. That is, 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`` operation.
+            filter_ (str): 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 <https://cloud.google.com/monitoring/api/v3/sorting-and-filtering>`__.
+            order_by (str): A comma-separated list of fields by which to sort the result. Supports
+                the same set of fields as in ``filter``. Entries can be prefixed with a
+                minus sign to sort in descending rather than ascending order.
+
+                For more details, see `sorting and
+                filtering <https://cloud.google.com/monitoring/api/v3/sorting-and-filtering>`__.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.NotificationChannel` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_notification_channels" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_notification_channels"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_notification_channels,
+                default_retry=self._method_configs["ListNotificationChannels"].retry,
+                default_timeout=self._method_configs[
+                    "ListNotificationChannels"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.ListNotificationChannelsRequest(
+            name=name, filter=filter_, order_by=order_by, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_notification_channels"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="notification_channels",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_notification_channel(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single notification channel. The channel includes the relevant
+        configuration details with which the channel was created. However, the
+        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.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.notification_channel_path('[PROJECT]', '[NOTIFICATION_CHANNEL]')
+            >>>
+            >>> response = client.get_notification_channel(name)
+
+        Args:
+            name (str): The channel for which to execute the request. The format is
+                ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.NotificationChannel` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_notification_channel" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_notification_channel"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_notification_channel,
+                default_retry=self._method_configs["GetNotificationChannel"].retry,
+                default_timeout=self._method_configs["GetNotificationChannel"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.GetNotificationChannelRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_notification_channel"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_notification_channel(
+        self,
+        name,
+        notification_channel,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new notification channel, representing a single notification
+        endpoint such as an email address, SMS number, or PagerDuty service.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `notification_channel`:
+            >>> notification_channel = {}
+            >>>
+            >>> response = client.create_notification_channel(name, notification_channel)
+
+        Args:
+            name (str): The project on which to execute the request. The format is:
+
+                ::
+
+                     projects/[PROJECT_ID]
+
+                Note that 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.
+            notification_channel (Union[dict, ~google.cloud.monitoring_v3.types.NotificationChannel]): The definition of the ``NotificationChannel`` to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.NotificationChannel`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.NotificationChannel` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_notification_channel" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_notification_channel"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_notification_channel,
+                default_retry=self._method_configs["CreateNotificationChannel"].retry,
+                default_timeout=self._method_configs[
+                    "CreateNotificationChannel"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.CreateNotificationChannelRequest(
+            name=name, notification_channel=notification_channel
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_notification_channel"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_notification_channel(
+        self,
+        notification_channel,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a notification channel. Fields not specified in the field mask
+        remain unchanged.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> # TODO: Initialize `notification_channel`:
+            >>> notification_channel = {}
+            >>>
+            >>> response = client.update_notification_channel(notification_channel)
+
+        Args:
+            notification_channel (Union[dict, ~google.cloud.monitoring_v3.types.NotificationChannel]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.NotificationChannel`
+            update_mask (Union[dict, ~google.cloud.monitoring_v3.types.FieldMask]): The fields to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.NotificationChannel` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_notification_channel" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_notification_channel"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_notification_channel,
+                default_retry=self._method_configs["UpdateNotificationChannel"].retry,
+                default_timeout=self._method_configs[
+                    "UpdateNotificationChannel"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.UpdateNotificationChannelRequest(
+            notification_channel=notification_channel, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("notification_channel.name", notification_channel.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_notification_channel"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_notification_channel(
+        self,
+        name,
+        force=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a notification channel.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.notification_channel_path('[PROJECT]', '[NOTIFICATION_CHANNEL]')
+            >>>
+            >>> client.delete_notification_channel(name)
+
+        Args:
+            name (str): The channel for which to execute the request. The format is
+                ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``.
+            force (bool): If true, the notification channel will be deleted regardless of its
+                use in alert policies (the policies will be updated to remove the
+                channel). If false, channels that are still referenced by an existing
+                alerting policy will fail to be deleted in a delete operation.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_notification_channel" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_notification_channel"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_notification_channel,
+                default_retry=self._method_configs["DeleteNotificationChannel"].retry,
+                default_timeout=self._method_configs[
+                    "DeleteNotificationChannel"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.DeleteNotificationChannelRequest(
+            name=name, force=force
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_notification_channel"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def send_notification_channel_verification_code(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Causes a verification code to be delivered to the channel. The code can
+        then be supplied in ``VerifyNotificationChannel`` to verify the channel.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.notification_channel_path('[PROJECT]', '[NOTIFICATION_CHANNEL]')
+            >>>
+            >>> client.send_notification_channel_verification_code(name)
+
+        Args:
+            name (str): The notification channel to which to send a verification code.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "send_notification_channel_verification_code" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "send_notification_channel_verification_code"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.send_notification_channel_verification_code,
+                default_retry=self._method_configs[
+                    "SendNotificationChannelVerificationCode"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "SendNotificationChannelVerificationCode"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.SendNotificationChannelVerificationCodeRequest(
+            name=name
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["send_notification_channel_verification_code"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_notification_channel_verification_code(
+        self,
+        name,
+        expire_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Requests a verification code for an already verified channel that can then
+        be used in a call to VerifyNotificationChannel() on a different channel
+        with an equivalent identity in the same or in a different project. This
+        makes it possible to copy a channel between projects without requiring
+        manual reverification of the channel. If the channel is not in the
+        verified state, this method will fail (in other words, this may only be
+        used if the SendNotificationChannelVerificationCode and
+        VerifyNotificationChannel paths have already been used to put the given
+        channel into the verified state).
+
+        There is no guarantee that the verification codes returned by this method
+        will be of a similar structure or form as the ones that are delivered
+        to the channel via SendNotificationChannelVerificationCode; while
+        VerifyNotificationChannel() will recognize both the codes delivered via
+        SendNotificationChannelVerificationCode() and returned from
+        GetNotificationChannelVerificationCode(), it is typically the case that
+        the verification codes delivered via
+        SendNotificationChannelVerificationCode() will be shorter and also
+        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.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.notification_channel_path('[PROJECT]', '[NOTIFICATION_CHANNEL]')
+            >>>
+            >>> response = client.get_notification_channel_verification_code(name)
+
+        Args:
+            name (str): 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.
+            expire_time (Union[dict, ~google.cloud.monitoring_v3.types.Timestamp]): The desired expiration time. If specified, the API will guarantee that
+                the returned code will not be valid after the specified timestamp;
+                however, the API cannot guarantee that the returned code will be
+                valid for at least as long as the requested time (the API puts an upper
+                bound on the amount of time for which a code may be valid). If omitted,
+                a default expiration will be used, which may be less than the max
+                permissible expiration (so specifying an expiration may extend the
+                code's lifetime over omitting an expiration, even though the API does
+                impose an upper limit on the maximum expiration that is permitted).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.GetNotificationChannelVerificationCodeResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_notification_channel_verification_code" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_notification_channel_verification_code"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_notification_channel_verification_code,
+                default_retry=self._method_configs[
+                    "GetNotificationChannelVerificationCode"
+                ].retry,
+                default_timeout=self._method_configs[
+                    "GetNotificationChannelVerificationCode"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.GetNotificationChannelVerificationCodeRequest(
+            name=name, expire_time=expire_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_notification_channel_verification_code"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def verify_notification_channel(
+        self,
+        name,
+        code,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Verifies a ``NotificationChannel`` by proving receipt of the code
+        delivered to the channel as a result of calling
+        ``SendNotificationChannelVerificationCode``.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.NotificationChannelServiceClient()
+            >>>
+            >>> name = client.notification_channel_path('[PROJECT]', '[NOTIFICATION_CHANNEL]')
+            >>>
+            >>> # TODO: Initialize `code`:
+            >>> code = ''
+            >>>
+            >>> response = client.verify_notification_channel(name, code)
+
+        Args:
+            name (str): The notification channel to verify.
+            code (str): 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).
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.NotificationChannel` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "verify_notification_channel" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "verify_notification_channel"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.verify_notification_channel,
+                default_retry=self._method_configs["VerifyNotificationChannel"].retry,
+                default_timeout=self._method_configs[
+                    "VerifyNotificationChannel"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = notification_service_pb2.VerifyNotificationChannelRequest(
+            name=name, code=code
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["verify_notification_channel"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client_config.py b/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client_config.py
new file mode 100644
index 000000000000..1fa0139bf814
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/notification_channel_service_client_config.py
@@ -0,0 +1,73 @@
+config = {
+    "interfaces": {
+        "google.monitoring.v3.NotificationChannelService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListNotificationChannelDescriptors": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetNotificationChannelDescriptor": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListNotificationChannels": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetNotificationChannel": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateNotificationChannel": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateNotificationChannel": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteNotificationChannel": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SendNotificationChannelVerificationCode": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetNotificationChannelVerificationCode": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "VerifyNotificationChannel": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/transports/__init__.py b/monitoring/google/cloud/monitoring_v3/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/transports/alert_policy_service_grpc_transport.py b/monitoring/google/cloud/monitoring_v3/gapic/transports/alert_policy_service_grpc_transport.py
new file mode 100644
index 000000000000..9279df68f995
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/transports/alert_policy_service_grpc_transport.py
@@ -0,0 +1,183 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.monitoring_v3.proto import alert_service_pb2_grpc
+
+
+class AlertPolicyServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.monitoring.v3 AlertPolicyService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="monitoring.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "alert_policy_service_stub": alert_service_pb2_grpc.AlertPolicyServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="monitoring.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_alert_policies(self):
+        """Return the gRPC stub for :meth:`AlertPolicyServiceClient.list_alert_policies`.
+
+        Lists the existing alerting policies for the project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["alert_policy_service_stub"].ListAlertPolicies
+
+    @property
+    def get_alert_policy(self):
+        """Return the gRPC stub for :meth:`AlertPolicyServiceClient.get_alert_policy`.
+
+        Gets a single alerting policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["alert_policy_service_stub"].GetAlertPolicy
+
+    @property
+    def create_alert_policy(self):
+        """Return the gRPC stub for :meth:`AlertPolicyServiceClient.create_alert_policy`.
+
+        Creates a new alerting policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["alert_policy_service_stub"].CreateAlertPolicy
+
+    @property
+    def delete_alert_policy(self):
+        """Return the gRPC stub for :meth:`AlertPolicyServiceClient.delete_alert_policy`.
+
+        Deletes an alerting policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["alert_policy_service_stub"].DeleteAlertPolicy
+
+    @property
+    def update_alert_policy(self):
+        """Return the gRPC stub for :meth:`AlertPolicyServiceClient.update_alert_policy`.
+
+        Updates an alerting policy. You can either replace the entire policy
+        with a new one or replace only certain fields in the current alerting
+        policy by specifying the fields to be updated via ``updateMask``.
+        Returns the updated alerting policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["alert_policy_service_stub"].UpdateAlertPolicy
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/transports/group_service_grpc_transport.py b/monitoring/google/cloud/monitoring_v3/gapic/transports/group_service_grpc_transport.py
new file mode 100644
index 000000000000..79c565b626b1
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/transports/group_service_grpc_transport.py
@@ -0,0 +1,192 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.monitoring_v3.proto import group_service_pb2_grpc
+
+
+class GroupServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.monitoring.v3 GroupService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="monitoring.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "group_service_stub": group_service_pb2_grpc.GroupServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="monitoring.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_groups(self):
+        """Return the gRPC stub for :meth:`GroupServiceClient.list_groups`.
+
+        Lists the existing groups.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["group_service_stub"].ListGroups
+
+    @property
+    def get_group(self):
+        """Return the gRPC stub for :meth:`GroupServiceClient.get_group`.
+
+        Gets a single group.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["group_service_stub"].GetGroup
+
+    @property
+    def create_group(self):
+        """Return the gRPC stub for :meth:`GroupServiceClient.create_group`.
+
+        Creates a new group.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["group_service_stub"].CreateGroup
+
+    @property
+    def update_group(self):
+        """Return the gRPC stub for :meth:`GroupServiceClient.update_group`.
+
+        Updates an existing group. You can change any group attributes except
+        ``name``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["group_service_stub"].UpdateGroup
+
+    @property
+    def delete_group(self):
+        """Return the gRPC stub for :meth:`GroupServiceClient.delete_group`.
+
+        Deletes an existing group.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["group_service_stub"].DeleteGroup
+
+    @property
+    def list_group_members(self):
+        """Return the gRPC stub for :meth:`GroupServiceClient.list_group_members`.
+
+        Lists the monitored resources that are members of a group.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["group_service_stub"].ListGroupMembers
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/transports/metric_service_grpc_transport.py b/monitoring/google/cloud/monitoring_v3/gapic/transports/metric_service_grpc_transport.py
new file mode 100644
index 000000000000..0668bf25dd8c
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/transports/metric_service_grpc_transport.py
@@ -0,0 +1,228 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.monitoring_v3.proto import metric_service_pb2_grpc
+
+
+class MetricServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.monitoring.v3 MetricService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="monitoring.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "metric_service_stub": metric_service_pb2_grpc.MetricServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="monitoring.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_monitored_resource_descriptors(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.list_monitored_resource_descriptors`.
+
+        Lists monitored resource descriptors that match a filter. This method does
+        not require a Stackdriver account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].ListMonitoredResourceDescriptors
+
+    @property
+    def get_monitored_resource_descriptor(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.get_monitored_resource_descriptor`.
+
+        Gets a single monitored resource descriptor. This method does not require a
+        Stackdriver account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].GetMonitoredResourceDescriptor
+
+    @property
+    def list_metric_descriptors(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.list_metric_descriptors`.
+
+        Lists metric descriptors that match a filter. This method does not require
+        a Stackdriver account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].ListMetricDescriptors
+
+    @property
+    def get_metric_descriptor(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.get_metric_descriptor`.
+
+        Gets a single metric descriptor. This method does not require a Stackdriver
+        account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].GetMetricDescriptor
+
+    @property
+    def create_metric_descriptor(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.create_metric_descriptor`.
+
+        Creates a new metric descriptor. User-created metric descriptors define
+        `custom metrics <https://cloud.google.com/monitoring/custom-metrics>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].CreateMetricDescriptor
+
+    @property
+    def delete_metric_descriptor(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.delete_metric_descriptor`.
+
+        Deletes a metric descriptor. Only user-created `custom
+        metrics <https://cloud.google.com/monitoring/custom-metrics>`__ can be
+        deleted.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].DeleteMetricDescriptor
+
+    @property
+    def list_time_series(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.list_time_series`.
+
+        Lists time series that match a filter. This method does not require a
+        Stackdriver account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].ListTimeSeries
+
+    @property
+    def create_time_series(self):
+        """Return the gRPC stub for :meth:`MetricServiceClient.create_time_series`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["metric_service_stub"].CreateTimeSeries
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/transports/notification_channel_service_grpc_transport.py b/monitoring/google/cloud/monitoring_v3/gapic/transports/notification_channel_service_grpc_transport.py
new file mode 100644
index 000000000000..30d1699a0fec
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/transports/notification_channel_service_grpc_transport.py
@@ -0,0 +1,292 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.monitoring_v3.proto import notification_service_pb2_grpc
+
+
+class NotificationChannelServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.monitoring.v3 NotificationChannelService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="monitoring.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "notification_channel_service_stub": notification_service_pb2_grpc.NotificationChannelServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="monitoring.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_notification_channel_descriptors(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.list_notification_channel_descriptors`.
+
+        Lists the descriptors for supported channel types. The use of descriptors
+        makes it possible for new channel types to be dynamically added.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].ListNotificationChannelDescriptors
+
+    @property
+    def get_notification_channel_descriptor(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.get_notification_channel_descriptor`.
+
+        Gets a single channel descriptor. The descriptor indicates which fields
+        are expected / permitted for a notification channel of the given type.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].GetNotificationChannelDescriptor
+
+    @property
+    def list_notification_channels(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.list_notification_channels`.
+
+        Lists the notification channels that have been created for the project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["notification_channel_service_stub"].ListNotificationChannels
+
+    @property
+    def get_notification_channel(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.get_notification_channel`.
+
+        Gets a single notification channel. The channel includes the relevant
+        configuration details with which the channel was created. However, the
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["notification_channel_service_stub"].GetNotificationChannel
+
+    @property
+    def create_notification_channel(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.create_notification_channel`.
+
+        Creates a new notification channel, representing a single notification
+        endpoint such as an email address, SMS number, or PagerDuty service.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].CreateNotificationChannel
+
+    @property
+    def update_notification_channel(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.update_notification_channel`.
+
+        Updates a notification channel. Fields not specified in the field mask
+        remain unchanged.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].UpdateNotificationChannel
+
+    @property
+    def delete_notification_channel(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.delete_notification_channel`.
+
+        Deletes a notification channel.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].DeleteNotificationChannel
+
+    @property
+    def send_notification_channel_verification_code(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.send_notification_channel_verification_code`.
+
+        Causes a verification code to be delivered to the channel. The code can
+        then be supplied in ``VerifyNotificationChannel`` to verify the channel.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].SendNotificationChannelVerificationCode
+
+    @property
+    def get_notification_channel_verification_code(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.get_notification_channel_verification_code`.
+
+        Requests a verification code for an already verified channel that can then
+        be used in a call to VerifyNotificationChannel() on a different channel
+        with an equivalent identity in the same or in a different project. This
+        makes it possible to copy a channel between projects without requiring
+        manual reverification of the channel. If the channel is not in the
+        verified state, this method will fail (in other words, this may only be
+        used if the SendNotificationChannelVerificationCode and
+        VerifyNotificationChannel paths have already been used to put the given
+        channel into the verified state).
+
+        There is no guarantee that the verification codes returned by this method
+        will be of a similar structure or form as the ones that are delivered
+        to the channel via SendNotificationChannelVerificationCode; while
+        VerifyNotificationChannel() will recognize both the codes delivered via
+        SendNotificationChannelVerificationCode() and returned from
+        GetNotificationChannelVerificationCode(), it is typically the case that
+        the verification codes delivered via
+        SendNotificationChannelVerificationCode() will be shorter and also
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].GetNotificationChannelVerificationCode
+
+    @property
+    def verify_notification_channel(self):
+        """Return the gRPC stub for :meth:`NotificationChannelServiceClient.verify_notification_channel`.
+
+        Verifies a ``NotificationChannel`` by proving receipt of the code
+        delivered to the channel as a result of calling
+        ``SendNotificationChannelVerificationCode``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "notification_channel_service_stub"
+        ].VerifyNotificationChannel
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/transports/uptime_check_service_grpc_transport.py b/monitoring/google/cloud/monitoring_v3/gapic/transports/uptime_check_service_grpc_transport.py
new file mode 100644
index 000000000000..8b67a4ed708d
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/transports/uptime_check_service_grpc_transport.py
@@ -0,0 +1,199 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.monitoring_v3.proto import uptime_service_pb2_grpc
+
+
+class UptimeCheckServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.monitoring.v3 UptimeCheckService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="monitoring.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "uptime_check_service_stub": uptime_service_pb2_grpc.UptimeCheckServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="monitoring.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_uptime_check_configs(self):
+        """Return the gRPC stub for :meth:`UptimeCheckServiceClient.list_uptime_check_configs`.
+
+        Lists the existing valid uptime check configurations for the project,
+        leaving out any invalid configurations.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["uptime_check_service_stub"].ListUptimeCheckConfigs
+
+    @property
+    def get_uptime_check_config(self):
+        """Return the gRPC stub for :meth:`UptimeCheckServiceClient.get_uptime_check_config`.
+
+        Gets a single uptime check configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["uptime_check_service_stub"].GetUptimeCheckConfig
+
+    @property
+    def create_uptime_check_config(self):
+        """Return the gRPC stub for :meth:`UptimeCheckServiceClient.create_uptime_check_config`.
+
+        Creates a new uptime check configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["uptime_check_service_stub"].CreateUptimeCheckConfig
+
+    @property
+    def update_uptime_check_config(self):
+        """Return the gRPC stub for :meth:`UptimeCheckServiceClient.update_uptime_check_config`.
+
+        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"``. Returns the updated configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["uptime_check_service_stub"].UpdateUptimeCheckConfig
+
+    @property
+    def delete_uptime_check_config(self):
+        """Return the gRPC stub for :meth:`UptimeCheckServiceClient.delete_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
+        other dependent configs that would be rendered invalid by the deletion.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["uptime_check_service_stub"].DeleteUptimeCheckConfig
+
+    @property
+    def list_uptime_check_ips(self):
+        """Return the gRPC stub for :meth:`UptimeCheckServiceClient.list_uptime_check_ips`.
+
+        Returns the list of IPs that checkers run from
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["uptime_check_service_stub"].ListUptimeCheckIps
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py b/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py
new file mode 100644
index 000000000000..2cf0170d94c0
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client.py
@@ -0,0 +1,755 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.monitoring.v3 UptimeCheckService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.api import metric_pb2 as api_metric_pb2
+from google.api import monitored_resource_pb2
+from google.cloud.monitoring_v3.gapic import enums
+from google.cloud.monitoring_v3.gapic import uptime_check_service_client_config
+from google.cloud.monitoring_v3.gapic.transports import (
+    uptime_check_service_grpc_transport,
+)
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import common_pb2
+from google.cloud.monitoring_v3.proto import group_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import metric_pb2 as proto_metric_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import notification_pb2
+from google.cloud.monitoring_v3.proto import notification_service_pb2
+from google.cloud.monitoring_v3.proto import notification_service_pb2_grpc
+from google.cloud.monitoring_v3.proto import uptime_pb2
+from google.cloud.monitoring_v3.proto import uptime_service_pb2
+from google.cloud.monitoring_v3.proto import uptime_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-monitoring"
+).version
+
+
+class UptimeCheckServiceClient(object):
+    """
+    The UptimeCheckService API is used to manage (list, create, delete,
+    edit) 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] (http://console.cloud.google.com), selecting the appropriate
+    project, clicking on "Monitoring" on the left-hand side to navigate to
+    Stackdriver, and then clicking on "Uptime".
+    """
+
+    SERVICE_ADDRESS = "monitoring.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.monitoring.v3.UptimeCheckService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            UptimeCheckServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def uptime_check_config_path(cls, project, uptime_check_config):
+        """Return a fully-qualified uptime_check_config string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/uptimeCheckConfigs/{uptime_check_config}",
+            project=project,
+            uptime_check_config=uptime_check_config,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.UptimeCheckServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.UptimeCheckServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = uptime_check_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=uptime_check_service_grpc_transport.UptimeCheckServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = uptime_check_service_grpc_transport.UptimeCheckServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_uptime_check_configs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the existing valid uptime check configurations for the project,
+        leaving out any invalid configurations.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.UptimeCheckServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_uptime_check_configs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_uptime_check_configs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project whose uptime check configurations are listed. The format is
+                ``projects/[PROJECT_ID]``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_uptime_check_configs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_uptime_check_configs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_uptime_check_configs,
+                default_retry=self._method_configs["ListUptimeCheckConfigs"].retry,
+                default_timeout=self._method_configs["ListUptimeCheckConfigs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = uptime_service_pb2.ListUptimeCheckConfigsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_uptime_check_configs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="uptime_check_configs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_uptime_check_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single uptime check configuration.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.UptimeCheckServiceClient()
+            >>>
+            >>> name = client.uptime_check_config_path('[PROJECT]', '[UPTIME_CHECK_CONFIG]')
+            >>>
+            >>> response = client.get_uptime_check_config(name)
+
+        Args:
+            name (str): The uptime check configuration to retrieve. The format is
+                ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_uptime_check_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_uptime_check_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_uptime_check_config,
+                default_retry=self._method_configs["GetUptimeCheckConfig"].retry,
+                default_timeout=self._method_configs["GetUptimeCheckConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = uptime_service_pb2.GetUptimeCheckConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_uptime_check_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_uptime_check_config(
+        self,
+        parent,
+        uptime_check_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new uptime check configuration.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.UptimeCheckServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `uptime_check_config`:
+            >>> uptime_check_config = {}
+            >>>
+            >>> response = client.create_uptime_check_config(parent, uptime_check_config)
+
+        Args:
+            parent (str): The project in which to create the uptime check. The format is
+                ``projects/[PROJECT_ID]``.
+            uptime_check_config (Union[dict, ~google.cloud.monitoring_v3.types.UptimeCheckConfig]): The new uptime check configuration.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_uptime_check_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_uptime_check_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_uptime_check_config,
+                default_retry=self._method_configs["CreateUptimeCheckConfig"].retry,
+                default_timeout=self._method_configs["CreateUptimeCheckConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = uptime_service_pb2.CreateUptimeCheckConfigRequest(
+            parent=parent, uptime_check_config=uptime_check_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_uptime_check_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_uptime_check_config(
+        self,
+        uptime_check_config,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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"``. Returns the updated configuration.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.UptimeCheckServiceClient()
+            >>>
+            >>> # TODO: Initialize `uptime_check_config`:
+            >>> uptime_check_config = {}
+            >>>
+            >>> response = client.update_uptime_check_config(uptime_check_config)
+
+        Args:
+            uptime_check_config (Union[dict, ~google.cloud.monitoring_v3.types.UptimeCheckConfig]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig`
+            update_mask (Union[dict, ~google.cloud.monitoring_v3.types.FieldMask]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.monitoring_v3.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.monitoring_v3.types.UptimeCheckConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_uptime_check_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_uptime_check_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_uptime_check_config,
+                default_retry=self._method_configs["UpdateUptimeCheckConfig"].retry,
+                default_timeout=self._method_configs["UpdateUptimeCheckConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = uptime_service_pb2.UpdateUptimeCheckConfigRequest(
+            uptime_check_config=uptime_check_config, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("uptime_check_config.name", uptime_check_config.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_uptime_check_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_uptime_check_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.UptimeCheckServiceClient()
+            >>>
+            >>> name = client.uptime_check_config_path('[PROJECT]', '[UPTIME_CHECK_CONFIG]')
+            >>>
+            >>> client.delete_uptime_check_config(name)
+
+        Args:
+            name (str): The uptime check configuration to delete. The format is
+                ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_uptime_check_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_uptime_check_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_uptime_check_config,
+                default_retry=self._method_configs["DeleteUptimeCheckConfig"].retry,
+                default_timeout=self._method_configs["DeleteUptimeCheckConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = uptime_service_pb2.DeleteUptimeCheckConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_uptime_check_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_uptime_check_ips(
+        self,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns the list of IPs that checkers run from
+
+        Example:
+            >>> from google.cloud import monitoring_v3
+            >>>
+            >>> client = monitoring_v3.UptimeCheckServiceClient()
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_uptime_check_ips():
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_uptime_check_ips().pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.monitoring_v3.types.UptimeCheckIp` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_uptime_check_ips" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_uptime_check_ips"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_uptime_check_ips,
+                default_retry=self._method_configs["ListUptimeCheckIps"].retry,
+                default_timeout=self._method_configs["ListUptimeCheckIps"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = uptime_service_pb2.ListUptimeCheckIpsRequest(page_size=page_size)
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_uptime_check_ips"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="uptime_check_ips",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client_config.py b/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client_config.py
new file mode 100644
index 000000000000..0be9a06c1184
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/gapic/uptime_check_service_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.monitoring.v3.UptimeCheckService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListUptimeCheckConfigs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetUptimeCheckConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateUptimeCheckConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateUptimeCheckConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteUptimeCheckConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListUptimeCheckIps": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/__init__.py b/monitoring/google/cloud/monitoring_v3/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert.proto b/monitoring/google/cloud/monitoring_v3/proto/alert.proto
new file mode 100644
index 000000000000..3b3e1dca29fb
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/alert.proto
@@ -0,0 +1,347 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/monitoring/v3/common.proto";
+import "google/monitoring/v3/mutation_record.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/wrappers.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 = "AlertProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "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/).
+message AlertPolicy {
+  // A content string and a MIME type that describes the content string's
+  // format.
+  message Documentation {
+    // The text of the documentation, interpreted according to `mime_type`.
+    // The content may not exceed 8,192 Unicode characters and may not exceed
+    // more than 10,240 bytes when encoded in UTF-8 format, whichever is
+    // smaller.
+    string content = 1;
+
+    // The format of the `content` field. Presently, only the value
+    // `"text/markdown"` is supported. See
+    // [Markdown](https://en.wikipedia.org/wiki/Markdown) for more information.
+    string mime_type = 2;
+  }
+
+  // A condition is a true/false test that determines when an alerting policy
+  // should open an incident. If a condition evaluates to true, it signifies
+  // that something is wrong.
+  message Condition {
+    // 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 {
+      // A type of trigger.
+      oneof type {
+        // The absolute number of time series that must fail
+        // the predicate for the condition to be triggered.
+        int32 count = 1;
+
+        // The percentage of time series that must fail the
+        // predicate for the condition to be triggered.
+        double percent = 2;
+      }
+    }
+
+    // A condition type that compares a collection of time series
+    // against a threshold.
+    message MetricThreshold {
+      // A [filter](/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 /
+      // 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.
+      string filter = 2;
+
+      // Specifies the alignment of data points in individual time series as
+      // well as how to combine the retrieved time series together (such as
+      // when aggregating multiple streams on each resource to a single
+      // stream for each resource or when aggregating streams across all
+      // 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
+      // 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.
+      //
+      // 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
+      // restrictions on resource type, resource labels, and metric labels.
+      // This field may not exceed 2048 Unicode characters in length.
+      string denominator_filter = 9;
+
+      // Specifies the alignment of data points in individual time series
+      // selected by `denominatorFilter` as
+      // well as how to combine the retrieved time series together (such as
+      // when aggregating multiple streams on each resource to a single
+      // stream for each resource or when aggregating streams across all
+      // members of a group of resources).
+      //
+      // 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`
+      // and `aggregation`) and the threshold (indicated by `threshold_value`).
+      // The comparison is applied on each time series, with the time series
+      // on the left-hand side and the threshold on the right-hand side.
+      //
+      // Only `COMPARISON_LT` and `COMPARISON_GT` are supported currently.
+      ComparisonType comparison = 4;
+
+      // A value against which to compare the time series.
+      double threshold_value = 5;
+
+      // The amount of time that a time series must violate the
+      // threshold to be considered failing. Currently, only values
+      // that are a multiple of a minute--e.g., 0, 60, 120, or 300
+      // seconds--are supported. If an invalid value is given, an
+      // error will be returned. When choosing a duration, it is useful to
+      // keep in mind the frequency of the underlying time series data
+      // (which may also be affected by any alignments specified in the
+      // `aggregations` field); a good duration is long enough so that a single
+      // outlier does not generate spurious alerts, but short enough that
+      // unhealthy states are detected and alerted on quickly.
+      google.protobuf.Duration duration = 6;
+
+      // The number/percent of time series for which the comparison must hold
+      // in order for the condition to trigger. If unspecified, then the
+      // condition will trigger if the comparison is true for any of the
+      // time series that have been identified by `filter` and `aggregations`,
+      // or by the ratio, if `denominator_filter` and `denominator_aggregations`
+      // are specified.
+      Trigger trigger = 7;
+    }
+
+    // A condition type that checks that monitored resources
+    // are reporting data. The configuration defines a metric and
+    // a set of monitored resources. The predicate is considered in violation
+    // 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
+      // 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 /
+      // 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.
+      string filter = 1;
+
+      // Specifies the alignment of data points in individual time series as
+      // well as how to combine the retrieved time series together (such as
+      // when aggregating multiple streams on each resource to a single
+      // stream for each resource or when aggregating streams across all
+      // 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
+      // field.
+      repeated Aggregation aggregations = 5;
+
+      // The amount of time that a time series must fail to report new
+      // data to be considered failing. Currently, only values that
+      // are a multiple of a minute--e.g.  60, 120, or 300
+      // seconds--are supported. If an invalid value is given, an
+      // error will be returned. The `Duration.nanos` field is
+      // ignored.
+      google.protobuf.Duration duration = 2;
+
+      // The number/percent of time series for which the comparison must hold
+      // in order for the condition to trigger. If unspecified, then the
+      // condition will trigger if the comparison is true for any of the
+      // time series that have been identified by `filter` and `aggregations`.
+      Trigger trigger = 3;
+    }
+
+    // Required if the condition exists. The unique resource name for this
+    // condition. Its syntax is:
+    //
+    //     projects/[PROJECT_ID]/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.
+    //
+    // When calling the
+    // [alertPolicies.create][google.monitoring.v3.AlertPolicyService.CreateAlertPolicy]
+    // method, do not include the `name` field in the conditions of the
+    // requested alerting policy. Stackdriver Monitoring creates the
+    // condition identifiers and includes them in the new policy.
+    //
+    // When calling the
+    // [alertPolicies.update][google.monitoring.v3.AlertPolicyService.UpdateAlertPolicy]
+    // method to update a policy, including a condition `name` causes the
+    // existing condition to be updated. Conditions without names are added to
+    // the updated policy. Existing conditions are deleted if they are not
+    // updated.
+    //
+    // Best practice is to preserve `[CONDITION_ID]` if you make only small
+    // changes, such as those to condition thresholds, durations, or trigger
+    // values.  Otherwise, treat the change as a new condition and let the
+    // existing condition be deleted.
+    string name = 12;
+
+    // A short name or phrase used to identify the condition in dashboards,
+    // notifications, and incidents. To avoid confusion, don't use the same
+    // display name for multiple conditions in the same policy.
+    string display_name = 6;
+
+    // Only one of the following condition types will be specified.
+    oneof condition {
+      // A condition that compares a time series against a threshold.
+      MetricThreshold condition_threshold = 1;
+
+      // A condition that checks that a time series continues to
+      // receive new data points.
+      MetricAbsence condition_absent = 2;
+    }
+  }
+
+  // Operators for combining conditions.
+  enum ConditionCombinerType {
+    // An unspecified combiner.
+    COMBINE_UNSPECIFIED = 0;
+
+    // Combine conditions using the logical `AND` operator. An
+    // incident is created only if all conditions are met
+    // simultaneously. This combiner is satisfied if all conditions are
+    // met, even if they are met on completely different resources.
+    AND = 1;
+
+    // Combine conditions using the logical `OR` operator. An incident
+    // is created if any of the listed conditions is met.
+    OR = 2;
+
+    // Combine conditions using logical `AND` operator, but unlike the regular
+    // `AND` option, an incident is created only if all conditions are met
+    // simultaneously on at least one resource.
+    AND_WITH_MATCHING_RESOURCE = 3;
+  }
+
+  // Required if the policy exists. The resource name for this policy. The
+  // syntax is:
+  //
+  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //
+  // `[ALERT_POLICY_ID]` is assigned by Stackdriver Monitoring when the policy
+  // is created.  When calling the
+  // [alertPolicies.create][google.monitoring.v3.AlertPolicyService.CreateAlertPolicy]
+  // method, do not include the `name` field in the alerting policy passed as
+  // part of the request.
+  string name = 1;
+
+  // A short name or phrase used to identify the policy in dashboards,
+  // notifications, and incidents. To avoid confusion, don't use the same
+  // display name for multiple policies in the same project. The name is
+  // limited to 512 Unicode characters.
+  string display_name = 2;
+
+  // Documentation that is included with notifications and incidents related to
+  // this policy. Best practice is for the documentation to include information
+  // to help responders understand, mitigate, escalate, and correct the
+  // underlying problems detected by the alerting policy. Notification channels
+  // that have limited capacity might not show this documentation.
+  Documentation documentation = 13;
+
+  // User-supplied key/value data to be used for organizing and
+  // identifying the `AlertPolicy` objects.
+  //
+  // The field can contain up to 64 entries. Each key and value is limited to
+  // 63 Unicode characters or 128 bytes, whichever is smaller. Labels and
+  // values can contain only lowercase letters, numerals, underscores, and
+  // dashes. Keys must begin with a letter.
+  map<string, string> user_labels = 16;
+
+  // A list of conditions for the policy. The conditions are combined by AND or
+  // 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.
+  repeated Condition conditions = 12;
+
+  // How to combine the results of multiple conditions
+  // to determine if an incident should be opened.
+  ConditionCombinerType combiner = 6;
+
+  // Whether or not the policy is enabled. On write, the default interpretation
+  // if unset is that the policy is enabled. On read, clients should not make
+  // any assumption about the state if it has not been populated. The
+  // field should always be populated on List and Get operations, unless
+  // a field projection has been specified that strips it out.
+  google.protobuf.BoolValue enabled = 17;
+
+  // 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
+  // the `name` field in each of the
+  // [`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:
+  //
+  //     projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]
+  repeated string notification_channels = 14;
+
+  // A read-only record of the creation of the alerting policy. If provided
+  // in a call to create or update, this field will be ignored.
+  MutationRecord creation_record = 10;
+
+  // A read-only record of the most recent change to the alerting policy. If
+  // provided in a call to create or update, this field will be ignored.
+  MutationRecord mutation_record = 11;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py
new file mode 100644
index 000000000000..10354346ad9e
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/alert_pb2.py
@@ -0,0 +1,1259 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/alert.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.monitoring_v3.proto import (
+    common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    mutation_record_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_mutation__record__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/alert.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\nAlertProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/monitoring_v3/proto/alert.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a\x36google/cloud/monitoring_v3/proto/mutation_record.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1egoogle/protobuf/wrappers.proto"\xdd\x0c\n\x0b\x41lertPolicy\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x46\n\rdocumentation\x18\r \x01(\x0b\x32/.google.monitoring.v3.AlertPolicy.Documentation\x12\x46\n\x0buser_labels\x18\x10 \x03(\x0b\x32\x31.google.monitoring.v3.AlertPolicy.UserLabelsEntry\x12?\n\nconditions\x18\x0c \x03(\x0b\x32+.google.monitoring.v3.AlertPolicy.Condition\x12I\n\x08\x63ombiner\x18\x06 \x01(\x0e\x32\x37.google.monitoring.v3.AlertPolicy.ConditionCombinerType\x12+\n\x07\x65nabled\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x1d\n\x15notification_channels\x18\x0e \x03(\t\x12=\n\x0f\x63reation_record\x18\n \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x12=\n\x0fmutation_record\x18\x0b \x01(\x0b\x32$.google.monitoring.v3.MutationRecord\x1a\x33\n\rDocumentation\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\t\x12\x11\n\tmime_type\x18\x02 \x01(\t\x1a\xf8\x06\n\tCondition\x12\x0c\n\x04name\x18\x0c \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x06 \x01(\t\x12Z\n\x13\x63ondition_threshold\x18\x01 \x01(\x0b\x32;.google.monitoring.v3.AlertPolicy.Condition.MetricThresholdH\x00\x12U\n\x10\x63ondition_absent\x18\x02 \x01(\x0b\x32\x39.google.monitoring.v3.AlertPolicy.Condition.MetricAbsenceH\x00\x1a\x35\n\x07Trigger\x12\x0f\n\x05\x63ount\x18\x01 \x01(\x05H\x00\x12\x11\n\x07percent\x18\x02 \x01(\x01H\x00\x42\x06\n\x04type\x1a\x81\x03\n\x0fMetricThreshold\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x37\n\x0c\x61ggregations\x18\x08 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x1a\n\x12\x64\x65nominator_filter\x18\t \x01(\t\x12\x43\n\x18\x64\x65nominator_aggregations\x18\n \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x38\n\ncomparison\x18\x04 \x01(\x0e\x32$.google.monitoring.v3.ComparisonType\x12\x17\n\x0fthreshold_value\x18\x05 \x01(\x01\x12+\n\x08\x64uration\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x07 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.Trigger\x1a\xcb\x01\n\rMetricAbsence\x12\x0e\n\x06\x66ilter\x18\x01 \x01(\t\x12\x37\n\x0c\x61ggregations\x18\x05 \x03(\x0b\x32!.google.monitoring.v3.Aggregation\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x44\n\x07trigger\x18\x03 \x01(\x0b\x32\x33.google.monitoring.v3.AlertPolicy.Condition.TriggerB\x0b\n\tcondition\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"a\n\x15\x43onditionCombinerType\x12\x17\n\x13\x43OMBINE_UNSPECIFIED\x10\x00\x12\x07\n\x03\x41ND\x10\x01\x12\x06\n\x02OR\x10\x02\x12\x1e\n\x1a\x41ND_WITH_MATCHING_RESOURCE\x10\x03\x42\xa2\x01\n\x18\x63om.google.monitoring.v3B\nAlertProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_mutation__record__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_ALERTPOLICY_CONDITIONCOMBINERTYPE = _descriptor.EnumDescriptor(
+    name="ConditionCombinerType",
+    full_name="google.monitoring.v3.AlertPolicy.ConditionCombinerType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMBINE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AND", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OR", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AND_WITH_MATCHING_RESOURCE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1800,
+    serialized_end=1897,
+)
+_sym_db.RegisterEnumDescriptor(_ALERTPOLICY_CONDITIONCOMBINERTYPE)
+
+
+_ALERTPOLICY_DOCUMENTATION = _descriptor.Descriptor(
+    name="Documentation",
+    full_name="google.monitoring.v3.AlertPolicy.Documentation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.monitoring.v3.AlertPolicy.Documentation.content",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.monitoring.v3.AlertPolicy.Documentation.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=805,
+    serialized_end=856,
+)
+
+_ALERTPOLICY_CONDITION_TRIGGER = _descriptor.Descriptor(
+    name="Trigger",
+    full_name="google.monitoring.v3.AlertPolicy.Condition.Trigger",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.Trigger.count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="percent",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.Trigger.percent",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="type",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.Trigger.type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1087,
+    serialized_end=1140,
+)
+
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD = _descriptor.Descriptor(
+    name="MetricThreshold",
+    full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.filter",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="aggregations",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.aggregations",
+            index=1,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="denominator_filter",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.denominator_filter",
+            index=2,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="denominator_aggregations",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.denominator_aggregations",
+            index=3,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="comparison",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.comparison",
+            index=4,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="threshold_value",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.threshold_value",
+            index=5,
+            number=5,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duration",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.duration",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trigger",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricThreshold.trigger",
+            index=7,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1143,
+    serialized_end=1528,
+)
+
+_ALERTPOLICY_CONDITION_METRICABSENCE = _descriptor.Descriptor(
+    name="MetricAbsence",
+    full_name="google.monitoring.v3.AlertPolicy.Condition.MetricAbsence",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricAbsence.filter",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="aggregations",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricAbsence.aggregations",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duration",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricAbsence.duration",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trigger",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.MetricAbsence.trigger",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1531,
+    serialized_end=1734,
+)
+
+_ALERTPOLICY_CONDITION = _descriptor.Descriptor(
+    name="Condition",
+    full_name="google.monitoring.v3.AlertPolicy.Condition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.name",
+            index=0,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.display_name",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="condition_threshold",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.condition_threshold",
+            index=2,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="condition_absent",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.condition_absent",
+            index=3,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _ALERTPOLICY_CONDITION_TRIGGER,
+        _ALERTPOLICY_CONDITION_METRICTHRESHOLD,
+        _ALERTPOLICY_CONDITION_METRICABSENCE,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="condition",
+            full_name="google.monitoring.v3.AlertPolicy.Condition.condition",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=859,
+    serialized_end=1747,
+)
+
+_ALERTPOLICY_USERLABELSENTRY = _descriptor.Descriptor(
+    name="UserLabelsEntry",
+    full_name="google.monitoring.v3.AlertPolicy.UserLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.monitoring.v3.AlertPolicy.UserLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.AlertPolicy.UserLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1749,
+    serialized_end=1798,
+)
+
+_ALERTPOLICY = _descriptor.Descriptor(
+    name="AlertPolicy",
+    full_name="google.monitoring.v3.AlertPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.AlertPolicy.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.AlertPolicy.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="documentation",
+            full_name="google.monitoring.v3.AlertPolicy.documentation",
+            index=2,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_labels",
+            full_name="google.monitoring.v3.AlertPolicy.user_labels",
+            index=3,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="conditions",
+            full_name="google.monitoring.v3.AlertPolicy.conditions",
+            index=4,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="combiner",
+            full_name="google.monitoring.v3.AlertPolicy.combiner",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.monitoring.v3.AlertPolicy.enabled",
+            index=6,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notification_channels",
+            full_name="google.monitoring.v3.AlertPolicy.notification_channels",
+            index=7,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="creation_record",
+            full_name="google.monitoring.v3.AlertPolicy.creation_record",
+            index=8,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mutation_record",
+            full_name="google.monitoring.v3.AlertPolicy.mutation_record",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _ALERTPOLICY_DOCUMENTATION,
+        _ALERTPOLICY_CONDITION,
+        _ALERTPOLICY_USERLABELSENTRY,
+    ],
+    enum_types=[_ALERTPOLICY_CONDITIONCOMBINERTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=268,
+    serialized_end=1897,
+)
+
+_ALERTPOLICY_DOCUMENTATION.containing_type = _ALERTPOLICY
+_ALERTPOLICY_CONDITION_TRIGGER.containing_type = _ALERTPOLICY_CONDITION
+_ALERTPOLICY_CONDITION_TRIGGER.oneofs_by_name["type"].fields.append(
+    _ALERTPOLICY_CONDITION_TRIGGER.fields_by_name["count"]
+)
+_ALERTPOLICY_CONDITION_TRIGGER.fields_by_name[
+    "count"
+].containing_oneof = _ALERTPOLICY_CONDITION_TRIGGER.oneofs_by_name["type"]
+_ALERTPOLICY_CONDITION_TRIGGER.oneofs_by_name["type"].fields.append(
+    _ALERTPOLICY_CONDITION_TRIGGER.fields_by_name["percent"]
+)
+_ALERTPOLICY_CONDITION_TRIGGER.fields_by_name[
+    "percent"
+].containing_oneof = _ALERTPOLICY_CONDITION_TRIGGER.oneofs_by_name["type"]
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD.fields_by_name[
+    "aggregations"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._AGGREGATION
+)
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD.fields_by_name[
+    "denominator_aggregations"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._AGGREGATION
+)
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD.fields_by_name[
+    "comparison"
+].enum_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._COMPARISONTYPE
+)
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD.fields_by_name[
+    "duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD.fields_by_name[
+    "trigger"
+].message_type = _ALERTPOLICY_CONDITION_TRIGGER
+_ALERTPOLICY_CONDITION_METRICTHRESHOLD.containing_type = _ALERTPOLICY_CONDITION
+_ALERTPOLICY_CONDITION_METRICABSENCE.fields_by_name[
+    "aggregations"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._AGGREGATION
+)
+_ALERTPOLICY_CONDITION_METRICABSENCE.fields_by_name[
+    "duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_ALERTPOLICY_CONDITION_METRICABSENCE.fields_by_name[
+    "trigger"
+].message_type = _ALERTPOLICY_CONDITION_TRIGGER
+_ALERTPOLICY_CONDITION_METRICABSENCE.containing_type = _ALERTPOLICY_CONDITION
+_ALERTPOLICY_CONDITION.fields_by_name[
+    "condition_threshold"
+].message_type = _ALERTPOLICY_CONDITION_METRICTHRESHOLD
+_ALERTPOLICY_CONDITION.fields_by_name[
+    "condition_absent"
+].message_type = _ALERTPOLICY_CONDITION_METRICABSENCE
+_ALERTPOLICY_CONDITION.containing_type = _ALERTPOLICY
+_ALERTPOLICY_CONDITION.oneofs_by_name["condition"].fields.append(
+    _ALERTPOLICY_CONDITION.fields_by_name["condition_threshold"]
+)
+_ALERTPOLICY_CONDITION.fields_by_name[
+    "condition_threshold"
+].containing_oneof = _ALERTPOLICY_CONDITION.oneofs_by_name["condition"]
+_ALERTPOLICY_CONDITION.oneofs_by_name["condition"].fields.append(
+    _ALERTPOLICY_CONDITION.fields_by_name["condition_absent"]
+)
+_ALERTPOLICY_CONDITION.fields_by_name[
+    "condition_absent"
+].containing_oneof = _ALERTPOLICY_CONDITION.oneofs_by_name["condition"]
+_ALERTPOLICY_USERLABELSENTRY.containing_type = _ALERTPOLICY
+_ALERTPOLICY.fields_by_name["documentation"].message_type = _ALERTPOLICY_DOCUMENTATION
+_ALERTPOLICY.fields_by_name["user_labels"].message_type = _ALERTPOLICY_USERLABELSENTRY
+_ALERTPOLICY.fields_by_name["conditions"].message_type = _ALERTPOLICY_CONDITION
+_ALERTPOLICY.fields_by_name["combiner"].enum_type = _ALERTPOLICY_CONDITIONCOMBINERTYPE
+_ALERTPOLICY.fields_by_name[
+    "enabled"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_ALERTPOLICY.fields_by_name[
+    "creation_record"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_mutation__record__pb2._MUTATIONRECORD
+)
+_ALERTPOLICY.fields_by_name[
+    "mutation_record"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_mutation__record__pb2._MUTATIONRECORD
+)
+_ALERTPOLICY_CONDITIONCOMBINERTYPE.containing_type = _ALERTPOLICY
+DESCRIPTOR.message_types_by_name["AlertPolicy"] = _ALERTPOLICY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AlertPolicy = _reflection.GeneratedProtocolMessageType(
+    "AlertPolicy",
+    (_message.Message,),
+    dict(
+        Documentation=_reflection.GeneratedProtocolMessageType(
+            "Documentation",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ALERTPOLICY_DOCUMENTATION,
+                __module__="google.cloud.monitoring_v3.proto.alert_pb2",
+                __doc__="""A content string and a MIME type that describes the content string's
+    format.
+    
+    
+    Attributes:
+        content:
+            The text of the documentation, interpreted according to
+            ``mime_type``. The content may not exceed 8,192 Unicode
+            characters and may not exceed more than 10,240 bytes when
+            encoded in UTF-8 format, whichever is smaller.
+        mime_type:
+            The format of the ``content`` field. Presently, only the value
+            ``"text/markdown"`` is supported. See `Markdown
+            <https://en.wikipedia.org/wiki/Markdown>`__ for more
+            information.
+    """,
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy.Documentation)
+            ),
+        ),
+        Condition=_reflection.GeneratedProtocolMessageType(
+            "Condition",
+            (_message.Message,),
+            dict(
+                Trigger=_reflection.GeneratedProtocolMessageType(
+                    "Trigger",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ALERTPOLICY_CONDITION_TRIGGER,
+                        __module__="google.cloud.monitoring_v3.proto.alert_pb2",
+                        __doc__="""Specifies how many time series must fail a predicate to trigger a
+      condition. If not specified, then a ``{count: 1}`` trigger is used.
+      
+      
+      Attributes:
+          type:
+              A type of trigger.
+          count:
+              The absolute number of time series that must fail the
+              predicate for the condition to be triggered.
+          percent:
+              The percentage of time series that must fail the predicate for
+              the condition to be triggered.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy.Condition.Trigger)
+                    ),
+                ),
+                MetricThreshold=_reflection.GeneratedProtocolMessageType(
+                    "MetricThreshold",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ALERTPOLICY_CONDITION_METRICTHRESHOLD,
+                        __module__="google.cloud.monitoring_v3.proto.alert_pb2",
+                        __doc__="""A condition type that compares a collection of time series against a
+      threshold.
+      
+      
+      Attributes:
+          filter:
+              A `filter </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 / 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.
+          aggregations:
+              Specifies the alignment of data points in individual time
+              series as well as how to combine the retrieved time series
+              together (such as when aggregating multiple streams on each
+              resource to a single stream for each resource or when
+              aggregating streams across all 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 field.
+          denominator_filter:
+              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.  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 restrictions on resource type, resource
+              labels, and metric labels. This field may not exceed 2048
+              Unicode characters in length.
+          denominator_aggregations:
+              Specifies the alignment of data points in individual time
+              series selected by ``denominatorFilter`` as well as how to
+              combine the retrieved time series together (such as when
+              aggregating multiple streams on each resource to a single
+              stream for each resource or when aggregating streams across
+              all members of a group of resources).  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.
+          comparison:
+              The comparison to apply between the time series (indicated by
+              ``filter`` and ``aggregation``) and the threshold (indicated
+              by ``threshold_value``). The comparison is applied on each
+              time series, with the time series on the left-hand side and
+              the threshold on the right-hand side.  Only ``COMPARISON_LT``
+              and ``COMPARISON_GT`` are supported currently.
+          threshold_value:
+              A value against which to compare the time series.
+          duration:
+              The amount of time that a time series must violate the
+              threshold to be considered failing. Currently, only values
+              that are a multiple of a minute--e.g., 0, 60, 120, or 300
+              seconds--are supported. If an invalid value is given, an error
+              will be returned. When choosing a duration, it is useful to
+              keep in mind the frequency of the underlying time series data
+              (which may also be affected by any alignments specified in the
+              ``aggregations`` field); a good duration is long enough so
+              that a single outlier does not generate spurious alerts, but
+              short enough that unhealthy states are detected and alerted on
+              quickly.
+          trigger:
+              The number/percent of time series for which the comparison
+              must hold in order for the condition to trigger. If
+              unspecified, then the condition will trigger if the comparison
+              is true for any of the time series that have been identified
+              by ``filter`` and ``aggregations``, or by the ratio, if
+              ``denominator_filter`` and ``denominator_aggregations`` are
+              specified.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy.Condition.MetricThreshold)
+                    ),
+                ),
+                MetricAbsence=_reflection.GeneratedProtocolMessageType(
+                    "MetricAbsence",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_ALERTPOLICY_CONDITION_METRICABSENCE,
+                        __module__="google.cloud.monitoring_v3.proto.alert_pb2",
+                        __doc__="""A condition type that checks that monitored resources are reporting
+      data. The configuration defines a metric and a set of monitored
+      resources. The predicate is considered in violation when a time series
+      for the specified metric of a monitored resource does not include any
+      data in the specified ``duration``.
+      
+      
+      Attributes:
+          filter:
+              A `filter </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 / 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.
+          aggregations:
+              Specifies the alignment of data points in individual time
+              series as well as how to combine the retrieved time series
+              together (such as when aggregating multiple streams on each
+              resource to a single stream for each resource or when
+              aggregating streams across all 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 field.
+          duration:
+              The amount of time that a time series must fail to report new
+              data to be considered failing. Currently, only values that are
+              a multiple of a minute--e.g. 60, 120, or 300 seconds--are
+              supported. If an invalid value is given, an error will be
+              returned. The ``Duration.nanos`` field is ignored.
+          trigger:
+              The number/percent of time series for which the comparison
+              must hold in order for the condition to trigger. If
+              unspecified, then the condition will trigger if the comparison
+              is true for any of the time series that have been identified
+              by ``filter`` and ``aggregations``.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy.Condition.MetricAbsence)
+                    ),
+                ),
+                DESCRIPTOR=_ALERTPOLICY_CONDITION,
+                __module__="google.cloud.monitoring_v3.proto.alert_pb2",
+                __doc__="""A condition is a true/false test that determines when an alerting policy
+    should open an incident. If a condition evaluates to true, it signifies
+    that something is wrong.
+    
+    
+    Attributes:
+        name:
+            Required if the condition exists. The unique resource name for
+            this condition. Its syntax is:  ::      projects/[PROJECT_ID]/
+            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.  When calling the [alertPolicies.create][google.monito
+            ring.v3.AlertPolicyService.CreateAlertPolicy] method, do not
+            include the ``name`` field in the conditions of the requested
+            alerting policy. Stackdriver Monitoring creates the condition
+            identifiers and includes them in the new policy.  When calling
+            the [alertPolicies.update][google.monitoring.v3.AlertPolicySer
+            vice.UpdateAlertPolicy] method to update a policy, including a
+            condition ``name`` causes the existing condition to be
+            updated. Conditions without names are added to the updated
+            policy. Existing conditions are deleted if they are not
+            updated.  Best practice is to preserve ``[CONDITION_ID]`` if
+            you make only small changes, such as those to condition
+            thresholds, durations, or trigger values. Otherwise, treat the
+            change as a new condition and let the existing condition be
+            deleted.
+        display_name:
+            A short name or phrase used to identify the condition in
+            dashboards, notifications, and incidents. To avoid confusion,
+            don't use the same display name for multiple conditions in the
+            same policy.
+        condition:
+            Only one of the following condition types will be specified.
+        condition_threshold:
+            A condition that compares a time series against a threshold.
+        condition_absent:
+            A condition that checks that a time series continues to
+            receive new data points.
+    """,
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy.Condition)
+            ),
+        ),
+        UserLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "UserLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ALERTPOLICY_USERLABELSENTRY,
+                __module__="google.cloud.monitoring_v3.proto.alert_pb2"
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy.UserLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_ALERTPOLICY,
+        __module__="google.cloud.monitoring_v3.proto.alert_pb2",
+        __doc__="""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/>`__.
+  
+  
+  Attributes:
+      name:
+          Required if the policy exists. The resource name for this
+          policy. The syntax is:  ::
+          projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+          ``[ALERT_POLICY_ID]`` is assigned by Stackdriver Monitoring
+          when the policy is created. When calling the [alertPolicies.cr
+          eate][google.monitoring.v3.AlertPolicyService.CreateAlertPolic
+          y] method, do not include the ``name`` field in the alerting
+          policy passed as part of the request.
+      display_name:
+          A short name or phrase used to identify the policy in
+          dashboards, notifications, and incidents. To avoid confusion,
+          don't use the same display name for multiple policies in the
+          same project. The name is limited to 512 Unicode characters.
+      documentation:
+          Documentation that is included with notifications and
+          incidents related to this policy. Best practice is for the
+          documentation to include information to help responders
+          understand, mitigate, escalate, and correct the underlying
+          problems detected by the alerting policy. Notification
+          channels that have limited capacity might not show this
+          documentation.
+      user_labels:
+          User-supplied key/value data to be used for organizing and
+          identifying the ``AlertPolicy`` objects.  The field can
+          contain up to 64 entries. Each key and value is limited to 63
+          Unicode characters or 128 bytes, whichever is smaller. Labels
+          and values can contain only lowercase letters, numerals,
+          underscores, and dashes. Keys must begin with a letter.
+      conditions:
+          A list of conditions for the policy. The conditions are
+          combined by AND or 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.
+      combiner:
+          How to combine the results of multiple conditions to determine
+          if an incident should be opened.
+      enabled:
+          Whether or not the policy is enabled. On write, the default
+          interpretation if unset is that the policy is enabled. On
+          read, clients should not make any assumption about the state
+          if it has not been populated. The field should always be
+          populated on List and Get operations, unless a field
+          projection has been specified that strips it out.
+      notification_channels:
+          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 the ``name`` field in each of the
+          [``NotificationChannel``][google.monitoring.v3.NotificationCha
+          nnel] objects that are returned from the [``ListNotificationCh
+          annels``][google.monitoring.v3.NotificationChannelService.List
+          NotificationChannels] method. The syntax of the entries in
+          this field is:  ::
+          projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]
+      creation_record:
+          A read-only record of the creation of the alerting policy. If
+          provided in a call to create or update, this field will be
+          ignored.
+      mutation_record:
+          A read-only record of the most recent change to the alerting
+          policy. If provided in a call to create or update, this field
+          will be ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.AlertPolicy)
+    ),
+)
+_sym_db.RegisterMessage(AlertPolicy)
+_sym_db.RegisterMessage(AlertPolicy.Documentation)
+_sym_db.RegisterMessage(AlertPolicy.Condition)
+_sym_db.RegisterMessage(AlertPolicy.Condition.Trigger)
+_sym_db.RegisterMessage(AlertPolicy.Condition.MetricThreshold)
+_sym_db.RegisterMessage(AlertPolicy.Condition.MetricAbsence)
+_sym_db.RegisterMessage(AlertPolicy.UserLabelsEntry)
+
+
+DESCRIPTOR._options = None
+_ALERTPOLICY_USERLABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/alert_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/alert_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto b/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto
new file mode 100644
index 000000000000..0dedca1139d1
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/alert_service.proto
@@ -0,0 +1,199 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/monitoring/v3/alert.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 = "AlertServiceProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// The AlertPolicyService API is used to manage (list, create, delete,
+// edit) alert policies in Stackdriver Monitoring. An alerting policy is
+// 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. In addition to using this API, alert
+// policies can also be managed through
+// [Stackdriver Monitoring](https://cloud.google.com/monitoring/docs/),
+// which can be reached by clicking the "Monitoring" tab in
+// [Cloud Console](https://console.cloud.google.com/).
+service AlertPolicyService {
+  // Lists the existing alerting policies for the project.
+  rpc ListAlertPolicies(ListAlertPoliciesRequest)
+      returns (ListAlertPoliciesResponse) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*}/alertPolicies"
+    };
+  }
+
+  // Gets a single alerting policy.
+  rpc GetAlertPolicy(GetAlertPolicyRequest) returns (AlertPolicy) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/alertPolicies/*}"
+    };
+  }
+
+  // Creates a new alerting policy.
+  rpc CreateAlertPolicy(CreateAlertPolicyRequest) returns (AlertPolicy) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*}/alertPolicies"
+      body: "alert_policy"
+    };
+  }
+
+  // Deletes an alerting policy.
+  rpc DeleteAlertPolicy(DeleteAlertPolicyRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=projects/*/alertPolicies/*}"
+    };
+  }
+
+  // Updates an alerting policy. You can either replace the entire policy with
+  // a new one or replace only certain fields in the current alerting policy by
+  // specifying the fields to be updated via `updateMask`. Returns the
+  // updated alerting policy.
+  rpc UpdateAlertPolicy(UpdateAlertPolicyRequest) returns (AlertPolicy) {
+    option (google.api.http) = {
+      patch: "/v3/{alert_policy.name=projects/*/alertPolicies/*}"
+      body: "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]`.
+  //
+  // 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
+  // policy. The name will be returned in the new policy, including
+  // a new [ALERT_POLICY_ID] value.
+  AlertPolicy alert_policy = 2;
+}
+
+// The protocol for the `GetAlertPolicy` request.
+message GetAlertPolicyRequest {
+  // The alerting policy to retrieve. The format is
+  //
+  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  string name = 3;
+}
+
+// The protocol for the `ListAlertPolicies` request.
+message ListAlertPoliciesRequest {
+  // The project whose alert policies are to be listed. The format is
+  //
+  //     projects/[PROJECT_ID]
+  //
+  // 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;
+
+  // 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).
+  string filter = 5;
+
+  // A comma-separated list of fields by which to sort the result. Supports
+  // the same set of field references as the `filter` field. Entries can be
+  // 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).
+  string order_by = 6;
+
+  // The maximum number of results to return in a single response.
+  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 more results from the previous method call.
+  string page_token = 3;
+}
+
+// The protocol for the `ListAlertPolicies` response.
+message ListAlertPoliciesResponse {
+  // The returned alert policies.
+  repeated AlertPolicy alert_policies = 3;
+
+  // 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.
+  string next_page_token = 2;
+}
+
+// The protocol for the `UpdateAlertPolicy` request.
+message UpdateAlertPolicyRequest {
+  // Optional. A list of alerting policy field names. If this field is not
+  // empty, each listed field in the existing alerting policy is set to the
+  // value of the corresponding field in the supplied policy (`alert_policy`),
+  // or to the field's default value if the field is not in the supplied
+  // alerting policy.  Fields not listed retain their previous value.
+  //
+  // Examples of valid field masks include `display_name`, `documentation`,
+  // `documentation.content`, `documentation.mime_type`, `user_labels`,
+  // `user_label.nameofkey`, `enabled`, `conditions`, `combiner`, etc.
+  //
+  // If this field is empty, then the supplied alerting policy replaces the
+  // existing policy. It is the same as deleting the existing policy and
+  // adding the supplied policy, except for the following:
+  //
+  // +   The new policy will have the same `[ALERT_POLICY_ID]` as the former
+  //     policy. This gives you continuity with the former policy in your
+  //     notifications and incidents.
+  // +   Conditions in the new policy will keep their former `[CONDITION_ID]` if
+  //     the supplied condition includes the `name` field with that
+  //     `[CONDITION_ID]`. If the supplied condition omits the `name` field,
+  //     then a new `[CONDITION_ID]` is created.
+  google.protobuf.FieldMask update_mask = 2;
+
+  // Required. The updated alerting policy or the updated values for the
+  // 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;
+}
+
+// The protocol for the `DeleteAlertPolicy` request.
+message DeleteAlertPolicyRequest {
+  // The alerting policy to delete. The format is:
+  //
+  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //
+  // For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy].
+  string name = 3;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py
new file mode 100644
index 000000000000..8f34c2f523d5
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2.py
@@ -0,0 +1,680 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/alert_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.monitoring_v3.proto import (
+    alert_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/alert_service.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\021AlertServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/monitoring_v3/proto/alert_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a,google/cloud/monitoring_v3/proto/alert.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"a\n\x18\x43reateAlertPolicyRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x37\n\x0c\x61lert_policy\x18\x02 \x01(\x0b\x32!.google.monitoring.v3.AlertPolicy"%\n\x15GetAlertPolicyRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"q\n\x18ListAlertPoliciesRequest\x12\x0c\n\x04name\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"o\n\x19ListAlertPoliciesResponse\x12\x39\n\x0e\x61lert_policies\x18\x03 \x03(\x0b\x32!.google.monitoring.v3.AlertPolicy\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x18UpdateAlertPolicyRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x37\n\x0c\x61lert_policy\x18\x03 \x01(\x0b\x32!.google.monitoring.v3.AlertPolicy"(\n\x18\x44\x65leteAlertPolicyRequest\x12\x0c\n\x04name\x18\x03 \x01(\t2\xae\x06\n\x12\x41lertPolicyService\x12\xa1\x01\n\x11ListAlertPolicies\x12..google.monitoring.v3.ListAlertPoliciesRequest\x1a/.google.monitoring.v3.ListAlertPoliciesResponse"+\x82\xd3\xe4\x93\x02%\x12#/v3/{name=projects/*}/alertPolicies\x12\x8f\x01\n\x0eGetAlertPolicy\x12+.google.monitoring.v3.GetAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"-\x82\xd3\xe4\x93\x02\'\x12%/v3/{name=projects/*/alertPolicies/*}\x12\xa1\x01\n\x11\x43reateAlertPolicy\x12..google.monitoring.v3.CreateAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"9\x82\xd3\xe4\x93\x02\x33"#/v3/{name=projects/*}/alertPolicies:\x0c\x61lert_policy\x12\x8a\x01\n\x11\x44\x65leteAlertPolicy\x12..google.monitoring.v3.DeleteAlertPolicyRequest\x1a\x16.google.protobuf.Empty"-\x82\xd3\xe4\x93\x02\'*%/v3/{name=projects/*/alertPolicies/*}\x12\xb0\x01\n\x11UpdateAlertPolicy\x12..google.monitoring.v3.UpdateAlertPolicyRequest\x1a!.google.monitoring.v3.AlertPolicy"H\x82\xd3\xe4\x93\x02\x42\x32\x32/v3/{alert_policy.name=projects/*/alertPolicies/*}:\x0c\x61lert_policyB\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11\x41lertServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEALERTPOLICYREQUEST = _descriptor.Descriptor(
+    name="CreateAlertPolicyRequest",
+    full_name="google.monitoring.v3.CreateAlertPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.CreateAlertPolicyRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alert_policy",
+            full_name="google.monitoring.v3.CreateAlertPolicyRequest.alert_policy",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=217,
+    serialized_end=314,
+)
+
+
+_GETALERTPOLICYREQUEST = _descriptor.Descriptor(
+    name="GetAlertPolicyRequest",
+    full_name="google.monitoring.v3.GetAlertPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetAlertPolicyRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=316,
+    serialized_end=353,
+)
+
+
+_LISTALERTPOLICIESREQUEST = _descriptor.Descriptor(
+    name="ListAlertPoliciesRequest",
+    full_name="google.monitoring.v3.ListAlertPoliciesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListAlertPoliciesRequest.name",
+            index=0,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListAlertPoliciesRequest.filter",
+            index=1,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.monitoring.v3.ListAlertPoliciesRequest.order_by",
+            index=2,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListAlertPoliciesRequest.page_size",
+            index=3,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListAlertPoliciesRequest.page_token",
+            index=4,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=355,
+    serialized_end=468,
+)
+
+
+_LISTALERTPOLICIESRESPONSE = _descriptor.Descriptor(
+    name="ListAlertPoliciesResponse",
+    full_name="google.monitoring.v3.ListAlertPoliciesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alert_policies",
+            full_name="google.monitoring.v3.ListAlertPoliciesResponse.alert_policies",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListAlertPoliciesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=470,
+    serialized_end=581,
+)
+
+
+_UPDATEALERTPOLICYREQUEST = _descriptor.Descriptor(
+    name="UpdateAlertPolicyRequest",
+    full_name="google.monitoring.v3.UpdateAlertPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.monitoring.v3.UpdateAlertPolicyRequest.update_mask",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alert_policy",
+            full_name="google.monitoring.v3.UpdateAlertPolicyRequest.alert_policy",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=584,
+    serialized_end=716,
+)
+
+
+_DELETEALERTPOLICYREQUEST = _descriptor.Descriptor(
+    name="DeleteAlertPolicyRequest",
+    full_name="google.monitoring.v3.DeleteAlertPolicyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.DeleteAlertPolicyRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=718,
+    serialized_end=758,
+)
+
+_CREATEALERTPOLICYREQUEST.fields_by_name[
+    "alert_policy"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY
+)
+_LISTALERTPOLICIESRESPONSE.fields_by_name[
+    "alert_policies"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY
+)
+_UPDATEALERTPOLICYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEALERTPOLICYREQUEST.fields_by_name[
+    "alert_policy"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY
+)
+DESCRIPTOR.message_types_by_name["CreateAlertPolicyRequest"] = _CREATEALERTPOLICYREQUEST
+DESCRIPTOR.message_types_by_name["GetAlertPolicyRequest"] = _GETALERTPOLICYREQUEST
+DESCRIPTOR.message_types_by_name["ListAlertPoliciesRequest"] = _LISTALERTPOLICIESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListAlertPoliciesResponse"
+] = _LISTALERTPOLICIESRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateAlertPolicyRequest"] = _UPDATEALERTPOLICYREQUEST
+DESCRIPTOR.message_types_by_name["DeleteAlertPolicyRequest"] = _DELETEALERTPOLICYREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateAlertPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateAlertPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEALERTPOLICYREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.alert_service_pb2",
+        __doc__="""The protocol for the ``CreateAlertPolicy`` request.
+  
+  
+  Attributes:
+      name:
+          The project in which to create the alerting policy. The format
+          is ``projects/[PROJECT_ID]``.  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.
+      alert_policy:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateAlertPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateAlertPolicyRequest)
+
+GetAlertPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetAlertPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETALERTPOLICYREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.alert_service_pb2",
+        __doc__="""The protocol for the ``GetAlertPolicy`` request.
+  
+  
+  Attributes:
+      name:
+          The alerting policy to retrieve. The format is  ::
+          projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetAlertPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetAlertPolicyRequest)
+
+ListAlertPoliciesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAlertPoliciesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTALERTPOLICIESREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.alert_service_pb2",
+        __doc__="""The protocol for the ``ListAlertPolicies`` request.
+  
+  
+  Attributes:
+      name:
+          The project whose alert policies are to be listed. The format
+          is  ::      projects/[PROJECT_ID]  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.AlertPolic
+          yService.GetAlertPolicy] operation, instead.
+      filter:
+          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>`__.
+      order_by:
+          A comma-separated list of fields by which to sort the result.
+          Supports the same set of field references as the ``filter``
+          field. Entries can be 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>`__.
+      page_size:
+          The maximum number of results to return in a single response.
+      page_token:
+          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 more
+          results from the previous method call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListAlertPoliciesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAlertPoliciesRequest)
+
+ListAlertPoliciesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAlertPoliciesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTALERTPOLICIESRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.alert_service_pb2",
+        __doc__="""The protocol for the ``ListAlertPolicies`` response.
+  
+  
+  Attributes:
+      alert_policies:
+          The returned alert policies.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListAlertPoliciesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAlertPoliciesResponse)
+
+UpdateAlertPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateAlertPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEALERTPOLICYREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.alert_service_pb2",
+        __doc__="""The protocol for the ``UpdateAlertPolicy`` request.
+  
+  
+  Attributes:
+      update_mask:
+          Optional. A list of alerting policy field names. If this field
+          is not empty, each listed field in the existing alerting
+          policy is set to the value of the corresponding field in the
+          supplied policy (``alert_policy``), or to the field's default
+          value if the field is not in the supplied alerting policy.
+          Fields not listed retain their previous value.  Examples of
+          valid field masks include ``display_name``, ``documentation``,
+          ``documentation.content``, ``documentation.mime_type``,
+          ``user_labels``, ``user_label.nameofkey``, ``enabled``,
+          ``conditions``, ``combiner``, etc.  If this field is empty,
+          then the supplied alerting policy replaces the existing
+          policy. It is the same as deleting the existing policy and
+          adding the supplied policy, except for the following:  -  The
+          new policy will have the same ``[ALERT_POLICY_ID]`` as the
+          former    policy. This gives you continuity with the former
+          policy in your    notifications and incidents. -  Conditions
+          in the new policy will keep their former    ``[CONDITION_ID]``
+          if the supplied condition includes the ``name``    field with
+          that ``[CONDITION_ID]``. If the supplied condition omits
+          the ``name`` field, then a new ``[CONDITION_ID]`` is created.
+      alert_policy:
+          Required. The updated alerting policy or the updated values
+          for the fields listed in ``update_mask``. If ``update_mask``
+          is not empty, any fields in this policy that are not in
+          ``update_mask`` are ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UpdateAlertPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateAlertPolicyRequest)
+
+DeleteAlertPolicyRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteAlertPolicyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEALERTPOLICYREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.alert_service_pb2",
+        __doc__="""The protocol for the ``DeleteAlertPolicy`` request.
+  
+  
+  Attributes:
+      name:
+          The alerting policy to delete. The format is:  ::
+          projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]  For
+          more information, see
+          [AlertPolicy][google.monitoring.v3.AlertPolicy].
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteAlertPolicyRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteAlertPolicyRequest)
+
+
+DESCRIPTOR._options = None
+
+_ALERTPOLICYSERVICE = _descriptor.ServiceDescriptor(
+    name="AlertPolicyService",
+    full_name="google.monitoring.v3.AlertPolicyService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=761,
+    serialized_end=1575,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListAlertPolicies",
+            full_name="google.monitoring.v3.AlertPolicyService.ListAlertPolicies",
+            index=0,
+            containing_service=None,
+            input_type=_LISTALERTPOLICIESREQUEST,
+            output_type=_LISTALERTPOLICIESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002%\022#/v3/{name=projects/*}/alertPolicies"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetAlertPolicy",
+            full_name="google.monitoring.v3.AlertPolicyService.GetAlertPolicy",
+            index=1,
+            containing_service=None,
+            input_type=_GETALERTPOLICYREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY,
+            serialized_options=_b(
+                "\202\323\344\223\002'\022%/v3/{name=projects/*/alertPolicies/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateAlertPolicy",
+            full_name="google.monitoring.v3.AlertPolicyService.CreateAlertPolicy",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEALERTPOLICYREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY,
+            serialized_options=_b(
+                '\202\323\344\223\0023"#/v3/{name=projects/*}/alertPolicies:\014alert_policy'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteAlertPolicy",
+            full_name="google.monitoring.v3.AlertPolicyService.DeleteAlertPolicy",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEALERTPOLICYREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002'*%/v3/{name=projects/*/alertPolicies/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateAlertPolicy",
+            full_name="google.monitoring.v3.AlertPolicyService.UpdateAlertPolicy",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATEALERTPOLICYREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2._ALERTPOLICY,
+            serialized_options=_b(
+                "\202\323\344\223\002B22/v3/{alert_policy.name=projects/*/alertPolicies/*}:\014alert_policy"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_ALERTPOLICYSERVICE)
+
+DESCRIPTOR.services_by_name["AlertPolicyService"] = _ALERTPOLICYSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2_grpc.py
new file mode 100644
index 000000000000..d5773d78c4d4
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/alert_service_pb2_grpc.py
@@ -0,0 +1,140 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.monitoring_v3.proto import (
+    alert_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    alert_service_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class AlertPolicyServiceStub(object):
+    """The AlertPolicyService API is used to manage (list, create, delete,
+  edit) alert policies in Stackdriver Monitoring. An alerting policy is
+  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. In addition to using this API, alert
+  policies can also be managed through
+  [Stackdriver Monitoring](https://cloud.google.com/monitoring/docs/),
+  which can be reached by clicking the "Monitoring" tab in
+  [Cloud Console](https://console.cloud.google.com/).
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListAlertPolicies = channel.unary_unary(
+            "/google.monitoring.v3.AlertPolicyService/ListAlertPolicies",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.ListAlertPoliciesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.ListAlertPoliciesResponse.FromString,
+        )
+        self.GetAlertPolicy = channel.unary_unary(
+            "/google.monitoring.v3.AlertPolicyService/GetAlertPolicy",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.GetAlertPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.AlertPolicy.FromString,
+        )
+        self.CreateAlertPolicy = channel.unary_unary(
+            "/google.monitoring.v3.AlertPolicyService/CreateAlertPolicy",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.CreateAlertPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.AlertPolicy.FromString,
+        )
+        self.DeleteAlertPolicy = channel.unary_unary(
+            "/google.monitoring.v3.AlertPolicyService/DeleteAlertPolicy",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.DeleteAlertPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.UpdateAlertPolicy = channel.unary_unary(
+            "/google.monitoring.v3.AlertPolicyService/UpdateAlertPolicy",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.UpdateAlertPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.AlertPolicy.FromString,
+        )
+
+
+class AlertPolicyServiceServicer(object):
+    """The AlertPolicyService API is used to manage (list, create, delete,
+  edit) alert policies in Stackdriver Monitoring. An alerting policy is
+  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. In addition to using this API, alert
+  policies can also be managed through
+  [Stackdriver Monitoring](https://cloud.google.com/monitoring/docs/),
+  which can be reached by clicking the "Monitoring" tab in
+  [Cloud Console](https://console.cloud.google.com/).
+  """
+
+    def ListAlertPolicies(self, request, context):
+        """Lists the existing alerting policies for the project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetAlertPolicy(self, request, context):
+        """Gets a single alerting policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateAlertPolicy(self, request, context):
+        """Creates a new alerting policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteAlertPolicy(self, request, context):
+        """Deletes an alerting policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateAlertPolicy(self, request, context):
+        """Updates an alerting policy. You can either replace the entire policy with
+    a new one or replace only certain fields in the current alerting policy by
+    specifying the fields to be updated via `updateMask`. Returns the
+    updated alerting policy.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_AlertPolicyServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListAlertPolicies": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAlertPolicies,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.ListAlertPoliciesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.ListAlertPoliciesResponse.SerializeToString,
+        ),
+        "GetAlertPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetAlertPolicy,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.GetAlertPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.AlertPolicy.SerializeToString,
+        ),
+        "CreateAlertPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateAlertPolicy,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.CreateAlertPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.AlertPolicy.SerializeToString,
+        ),
+        "DeleteAlertPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteAlertPolicy,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.DeleteAlertPolicyRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "UpdateAlertPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateAlertPolicy,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__service__pb2.UpdateAlertPolicyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_alert__pb2.AlertPolicy.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.monitoring.v3.AlertPolicyService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/monitoring/google/cloud/monitoring_v3/proto/common.proto b/monitoring/google/cloud/monitoring_v3/proto/common.proto
new file mode 100644
index 000000000000..73ca2c4ade65
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/common.proto
@@ -0,0 +1,418 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/api/distribution.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.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 = "CommonProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// A single strongly-typed value.
+message TypedValue {
+  // The typed value field.
+  oneof value {
+    // A Boolean value: `true` or `false`.
+    bool bool_value = 1;
+
+    // A 64-bit integer. Its range is approximately &plusmn;9.2x10<sup>18</sup>.
+    int64 int64_value = 2;
+
+    // A 64-bit double-precision floating-point number. Its magnitude
+    // is approximately &plusmn;10<sup>&plusmn;300</sup> and it has 16
+    // significant digits of precision.
+    double double_value = 3;
+
+    // A variable-length string value.
+    string string_value = 4;
+
+    // A distribution value.
+    google.api.Distribution distribution_value = 5;
+  }
+}
+
+// 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.
+message TimeInterval {
+  // Required. The end of the time interval.
+  google.protobuf.Timestamp end_time = 2;
+
+  // Optional. The beginning of the time interval.  The default value
+  // for the start time is the end time. The start time must not be
+  // later than the end time.
+  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).
+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][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.
+  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;
+}
+
+// Specifies an ordering relationship on two arguments, here called left and
+// right.
+enum ComparisonType {
+  // No ordering relationship is specified.
+  COMPARISON_UNSPECIFIED = 0;
+
+  // The left argument is greater than the right argument.
+  COMPARISON_GT = 1;
+
+  // The left argument is greater than or equal to the right argument.
+  COMPARISON_GE = 2;
+
+  // The left argument is less than the right argument.
+  COMPARISON_LT = 3;
+
+  // The left argument is less than or equal to the right argument.
+  COMPARISON_LE = 4;
+
+  // The left argument is equal to the right argument.
+  COMPARISON_EQ = 5;
+
+  // The left argument is not equal to the right argument.
+  COMPARISON_NE = 6;
+}
+
+// The tier of service for a Workspace. Please see the
+// [service tiers
+// documentation](https://cloud.google.com/monitoring/workspaces/tiers) for more
+// details.
+enum ServiceTier {
+  option deprecated = true;
+
+  // An invalid sentinel value, used to indicate that a tier has not
+  // been provided explicitly.
+  SERVICE_TIER_UNSPECIFIED = 0;
+
+  // The Stackdriver Basic tier, a free tier of service that provides basic
+  // features, a moderate allotment of logs, and access to built-in metrics.
+  // A number of features are not available in this tier. For more details,
+  // see [the service tiers
+  // documentation](https://cloud.google.com/monitoring/workspaces/tiers).
+  SERVICE_TIER_BASIC = 1;
+
+  // The Stackdriver Premium tier, a higher, more expensive tier of service
+  // that provides access to all Stackdriver features, lets you use Stackdriver
+  // with AWS accounts, and has a larger allotments for logs and metrics. For
+  // more details, see [the service tiers
+  // documentation](https://cloud.google.com/monitoring/workspaces/tiers).
+  SERVICE_TIER_PREMIUM = 2;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py
new file mode 100644
index 000000000000..6b68f3bde20a
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/common_pb2.py
@@ -0,0 +1,774 @@
+# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import distribution_pb2 as google_dot_api_dot_distribution__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/common.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\013CommonProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/monitoring_v3/proto/common.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x1dgoogle/api/distribution.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xaa\x01\n\nTypedValue\x12\x14\n\nbool_value\x18\x01 \x01(\x08H\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x16\n\x0c\x64ouble_value\x18\x03 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x04 \x01(\tH\x00\x12\x36\n\x12\x64istribution_value\x18\x05 \x01(\x0b\x32\x18.google.api.DistributionH\x00\x42\x07\n\x05value"l\n\x0cTimeInterval\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xad\x07\n\x0b\x41ggregation\x12\x33\n\x10\x61lignment_period\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x45\n\x12per_series_aligner\x18\x02 \x01(\x0e\x32).google.monitoring.v3.Aggregation.Aligner\x12G\n\x14\x63ross_series_reducer\x18\x04 \x01(\x0e\x32).google.monitoring.v3.Aggregation.Reducer\x12\x17\n\x0fgroup_by_fields\x18\x05 \x03(\t"\x8b\x03\n\x07\x41ligner\x12\x0e\n\nALIGN_NONE\x10\x00\x12\x0f\n\x0b\x41LIGN_DELTA\x10\x01\x12\x0e\n\nALIGN_RATE\x10\x02\x12\x15\n\x11\x41LIGN_INTERPOLATE\x10\x03\x12\x14\n\x10\x41LIGN_NEXT_OLDER\x10\x04\x12\r\n\tALIGN_MIN\x10\n\x12\r\n\tALIGN_MAX\x10\x0b\x12\x0e\n\nALIGN_MEAN\x10\x0c\x12\x0f\n\x0b\x41LIGN_COUNT\x10\r\x12\r\n\tALIGN_SUM\x10\x0e\x12\x10\n\x0c\x41LIGN_STDDEV\x10\x0f\x12\x14\n\x10\x41LIGN_COUNT_TRUE\x10\x10\x12\x15\n\x11\x41LIGN_COUNT_FALSE\x10\x18\x12\x17\n\x13\x41LIGN_FRACTION_TRUE\x10\x11\x12\x17\n\x13\x41LIGN_PERCENTILE_99\x10\x12\x12\x17\n\x13\x41LIGN_PERCENTILE_95\x10\x13\x12\x17\n\x13\x41LIGN_PERCENTILE_50\x10\x14\x12\x17\n\x13\x41LIGN_PERCENTILE_05\x10\x15\x12\x18\n\x14\x41LIGN_PERCENT_CHANGE\x10\x17"\xb1\x02\n\x07Reducer\x12\x0f\n\x0bREDUCE_NONE\x10\x00\x12\x0f\n\x0bREDUCE_MEAN\x10\x01\x12\x0e\n\nREDUCE_MIN\x10\x02\x12\x0e\n\nREDUCE_MAX\x10\x03\x12\x0e\n\nREDUCE_SUM\x10\x04\x12\x11\n\rREDUCE_STDDEV\x10\x05\x12\x10\n\x0cREDUCE_COUNT\x10\x06\x12\x15\n\x11REDUCE_COUNT_TRUE\x10\x07\x12\x16\n\x12REDUCE_COUNT_FALSE\x10\x0f\x12\x18\n\x14REDUCE_FRACTION_TRUE\x10\x08\x12\x18\n\x14REDUCE_PERCENTILE_99\x10\t\x12\x18\n\x14REDUCE_PERCENTILE_95\x10\n\x12\x18\n\x14REDUCE_PERCENTILE_50\x10\x0b\x12\x18\n\x14REDUCE_PERCENTILE_05\x10\x0c*\x9e\x01\n\x0e\x43omparisonType\x12\x1a\n\x16\x43OMPARISON_UNSPECIFIED\x10\x00\x12\x11\n\rCOMPARISON_GT\x10\x01\x12\x11\n\rCOMPARISON_GE\x10\x02\x12\x11\n\rCOMPARISON_LT\x10\x03\x12\x11\n\rCOMPARISON_LE\x10\x04\x12\x11\n\rCOMPARISON_EQ\x10\x05\x12\x11\n\rCOMPARISON_NE\x10\x06*a\n\x0bServiceTier\x12\x1c\n\x18SERVICE_TIER_UNSPECIFIED\x10\x00\x12\x16\n\x12SERVICE_TIER_BASIC\x10\x01\x12\x18\n\x14SERVICE_TIER_PREMIUM\x10\x02\x1a\x02\x18\x01\x42\xa3\x01\n\x18\x63om.google.monitoring.v3B\x0b\x43ommonProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_distribution__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_COMPARISONTYPE = _descriptor.EnumDescriptor(
+    name="ComparisonType",
+    full_name="google.monitoring.v3.ComparisonType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_GT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_GE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_LT", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_LE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_EQ", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPARISON_NE", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1425,
+    serialized_end=1583,
+)
+_sym_db.RegisterEnumDescriptor(_COMPARISONTYPE)
+
+ComparisonType = enum_type_wrapper.EnumTypeWrapper(_COMPARISONTYPE)
+_SERVICETIER = _descriptor.EnumDescriptor(
+    name="ServiceTier",
+    full_name="google.monitoring.v3.ServiceTier",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SERVICE_TIER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SERVICE_TIER_BASIC",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SERVICE_TIER_PREMIUM",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=_b("\030\001"),
+    serialized_start=1585,
+    serialized_end=1682,
+)
+_sym_db.RegisterEnumDescriptor(_SERVICETIER)
+
+ServiceTier = enum_type_wrapper.EnumTypeWrapper(_SERVICETIER)
+COMPARISON_UNSPECIFIED = 0
+COMPARISON_GT = 1
+COMPARISON_GE = 2
+COMPARISON_LT = 3
+COMPARISON_LE = 4
+COMPARISON_EQ = 5
+COMPARISON_NE = 6
+SERVICE_TIER_UNSPECIFIED = 0
+SERVICE_TIER_BASIC = 1
+SERVICE_TIER_PREMIUM = 2
+
+
+_AGGREGATION_ALIGNER = _descriptor.EnumDescriptor(
+    name="Aligner",
+    full_name="google.monitoring.v3.Aggregation.Aligner",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_NONE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_DELTA", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_RATE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_INTERPOLATE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_NEXT_OLDER",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_MIN", index=5, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_MAX", index=6, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_MEAN", index=7, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_COUNT", index=8, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_SUM", index=9, number=14, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_STDDEV", index=10, number=15, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_COUNT_TRUE",
+            index=11,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_COUNT_FALSE",
+            index=12,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_FRACTION_TRUE",
+            index=13,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_PERCENTILE_99",
+            index=14,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_PERCENTILE_95",
+            index=15,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_PERCENTILE_50",
+            index=16,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_PERCENTILE_05",
+            index=17,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALIGN_PERCENT_CHANGE",
+            index=18,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=719,
+    serialized_end=1114,
+)
+_sym_db.RegisterEnumDescriptor(_AGGREGATION_ALIGNER)
+
+_AGGREGATION_REDUCER = _descriptor.EnumDescriptor(
+    name="Reducer",
+    full_name="google.monitoring.v3.Aggregation.Reducer",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_NONE", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_MEAN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_MIN", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_MAX", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_SUM", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_STDDEV", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_COUNT", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_COUNT_TRUE",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_COUNT_FALSE",
+            index=8,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_FRACTION_TRUE",
+            index=9,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_PERCENTILE_99",
+            index=10,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_PERCENTILE_95",
+            index=11,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_PERCENTILE_50",
+            index=12,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REDUCE_PERCENTILE_05",
+            index=13,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1117,
+    serialized_end=1422,
+)
+_sym_db.RegisterEnumDescriptor(_AGGREGATION_REDUCER)
+
+
+_TYPEDVALUE = _descriptor.Descriptor(
+    name="TypedValue",
+    full_name="google.monitoring.v3.TypedValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bool_value",
+            full_name="google.monitoring.v3.TypedValue.bool_value",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="int64_value",
+            full_name="google.monitoring.v3.TypedValue.int64_value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="double_value",
+            full_name="google.monitoring.v3.TypedValue.double_value",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.monitoring.v3.TypedValue.string_value",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distribution_value",
+            full_name="google.monitoring.v3.TypedValue.distribution_value",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.TypedValue.value",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=198,
+    serialized_end=368,
+)
+
+
+_TIMEINTERVAL = _descriptor.Descriptor(
+    name="TimeInterval",
+    full_name="google.monitoring.v3.TimeInterval",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.monitoring.v3.TimeInterval.end_time",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.monitoring.v3.TimeInterval.start_time",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=370,
+    serialized_end=478,
+)
+
+
+_AGGREGATION = _descriptor.Descriptor(
+    name="Aggregation",
+    full_name="google.monitoring.v3.Aggregation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alignment_period",
+            full_name="google.monitoring.v3.Aggregation.alignment_period",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="per_series_aligner",
+            full_name="google.monitoring.v3.Aggregation.per_series_aligner",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cross_series_reducer",
+            full_name="google.monitoring.v3.Aggregation.cross_series_reducer",
+            index=2,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_by_fields",
+            full_name="google.monitoring.v3.Aggregation.group_by_fields",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_AGGREGATION_ALIGNER, _AGGREGATION_REDUCER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=481,
+    serialized_end=1422,
+)
+
+_TYPEDVALUE.fields_by_name[
+    "distribution_value"
+].message_type = google_dot_api_dot_distribution__pb2._DISTRIBUTION
+_TYPEDVALUE.oneofs_by_name["value"].fields.append(
+    _TYPEDVALUE.fields_by_name["bool_value"]
+)
+_TYPEDVALUE.fields_by_name["bool_value"].containing_oneof = _TYPEDVALUE.oneofs_by_name[
+    "value"
+]
+_TYPEDVALUE.oneofs_by_name["value"].fields.append(
+    _TYPEDVALUE.fields_by_name["int64_value"]
+)
+_TYPEDVALUE.fields_by_name["int64_value"].containing_oneof = _TYPEDVALUE.oneofs_by_name[
+    "value"
+]
+_TYPEDVALUE.oneofs_by_name["value"].fields.append(
+    _TYPEDVALUE.fields_by_name["double_value"]
+)
+_TYPEDVALUE.fields_by_name[
+    "double_value"
+].containing_oneof = _TYPEDVALUE.oneofs_by_name["value"]
+_TYPEDVALUE.oneofs_by_name["value"].fields.append(
+    _TYPEDVALUE.fields_by_name["string_value"]
+)
+_TYPEDVALUE.fields_by_name[
+    "string_value"
+].containing_oneof = _TYPEDVALUE.oneofs_by_name["value"]
+_TYPEDVALUE.oneofs_by_name["value"].fields.append(
+    _TYPEDVALUE.fields_by_name["distribution_value"]
+)
+_TYPEDVALUE.fields_by_name[
+    "distribution_value"
+].containing_oneof = _TYPEDVALUE.oneofs_by_name["value"]
+_TIMEINTERVAL.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEINTERVAL.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_AGGREGATION.fields_by_name[
+    "alignment_period"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_AGGREGATION.fields_by_name["per_series_aligner"].enum_type = _AGGREGATION_ALIGNER
+_AGGREGATION.fields_by_name["cross_series_reducer"].enum_type = _AGGREGATION_REDUCER
+_AGGREGATION_ALIGNER.containing_type = _AGGREGATION
+_AGGREGATION_REDUCER.containing_type = _AGGREGATION
+DESCRIPTOR.message_types_by_name["TypedValue"] = _TYPEDVALUE
+DESCRIPTOR.message_types_by_name["TimeInterval"] = _TIMEINTERVAL
+DESCRIPTOR.message_types_by_name["Aggregation"] = _AGGREGATION
+DESCRIPTOR.enum_types_by_name["ComparisonType"] = _COMPARISONTYPE
+DESCRIPTOR.enum_types_by_name["ServiceTier"] = _SERVICETIER
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TypedValue = _reflection.GeneratedProtocolMessageType(
+    "TypedValue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TYPEDVALUE,
+        __module__="google.cloud.monitoring_v3.proto.common_pb2",
+        __doc__="""A single strongly-typed value.
+  
+  
+  Attributes:
+      value:
+          The typed value field.
+      bool_value:
+          A Boolean value: ``true`` or ``false``.
+      int64_value:
+          A 64-bit integer. Its range is approximately ±9.2x1018.
+      double_value:
+          A 64-bit double-precision floating-point number. Its magnitude
+          is approximately ±10±300 and it has 16 significant digits of
+          precision.
+      string_value:
+          A variable-length string value.
+      distribution_value:
+          A distribution value.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.TypedValue)
+    ),
+)
+_sym_db.RegisterMessage(TypedValue)
+
+TimeInterval = _reflection.GeneratedProtocolMessageType(
+    "TimeInterval",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEINTERVAL,
+        __module__="google.cloud.monitoring_v3.proto.common_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      end_time:
+          Required. The end of the time interval.
+      start_time:
+          Optional. The beginning of the time interval. The default
+          value for the start time is the end time. The start time must
+          not be later than the end time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.TimeInterval)
+    ),
+)
+_sym_db.RegisterMessage(TimeInterval)
+
+Aggregation = _reflection.GeneratedProtocolMessageType(
+    "Aggregation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AGGREGATION,
+        __module__="google.cloud.monitoring_v3.proto.common_pb2",
+        __doc__="""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>`__.
+  
+  
+  Attributes:
+      alignment_period:
+          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.
+      per_series_aligner:
+          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.
+      cross_series_reducer:
+          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.
+      group_by_fields:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.Aggregation)
+    ),
+)
+_sym_db.RegisterMessage(Aggregation)
+
+
+DESCRIPTOR._options = None
+_SERVICETIER._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/common_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/dropped_labels.proto b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels.proto
new file mode 100644
index 000000000000..acbe8cf25ad1
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels.proto
@@ -0,0 +1,45 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+
+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";
+
+// A set of (label, value) pairs which were dropped during aggregation, attached
+// to google.api.Distribution.Exemplars in google.api.Distribution values during
+// aggregation.
+//
+// These values are used in combination with the label values that remain on the
+// aggregated Distribution timeseries to construct the full label set for the
+// exemplar values.  The resulting full label set may be used to identify the
+// specific task/job/instance (for example) which may be contributing to a
+// long-tail, while allowing the storage savings of only storing aggregated
+// distribution values for a large group.
+//
+// Note that there are no guarantees on ordering of the labels from
+// exemplar-to-exemplar and from distribution-to-distribution in the same
+// stream, and there may be duplicates.  It is up to clients to resolve any
+// ambiguities.
+message DroppedLabels {
+  // Map from label to its value, for all labels dropped in any aggregation.
+  map<string, string> label = 1;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py
new file mode 100644
index 000000000000..7564db192854
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2.py
@@ -0,0 +1,180 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/dropped_labels.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/dropped_labels.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\022DroppedLabelsProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/monitoring_v3/proto/dropped_labels.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto"|\n\rDroppedLabels\x12=\n\x05label\x18\x01 \x03(\x0b\x32..google.monitoring.v3.DroppedLabels.LabelEntry\x1a,\n\nLabelEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42p\n\x18\x63om.google.monitoring.v3B\x12\x44roppedLabelsProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoringb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_DROPPEDLABELS_LABELENTRY = _descriptor.Descriptor(
+    name="LabelEntry",
+    full_name="google.monitoring.v3.DroppedLabels.LabelEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.monitoring.v3.DroppedLabels.LabelEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.DroppedLabels.LabelEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=189,
+    serialized_end=233,
+)
+
+_DROPPEDLABELS = _descriptor.Descriptor(
+    name="DroppedLabels",
+    full_name="google.monitoring.v3.DroppedLabels",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.monitoring.v3.DroppedLabels.label",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_DROPPEDLABELS_LABELENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=109,
+    serialized_end=233,
+)
+
+_DROPPEDLABELS_LABELENTRY.containing_type = _DROPPEDLABELS
+_DROPPEDLABELS.fields_by_name["label"].message_type = _DROPPEDLABELS_LABELENTRY
+DESCRIPTOR.message_types_by_name["DroppedLabels"] = _DROPPEDLABELS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DroppedLabels = _reflection.GeneratedProtocolMessageType(
+    "DroppedLabels",
+    (_message.Message,),
+    dict(
+        LabelEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_DROPPEDLABELS_LABELENTRY,
+                __module__="google.cloud.monitoring_v3.proto.dropped_labels_pb2"
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.DroppedLabels.LabelEntry)
+            ),
+        ),
+        DESCRIPTOR=_DROPPEDLABELS,
+        __module__="google.cloud.monitoring_v3.proto.dropped_labels_pb2",
+        __doc__="""A set of (label, value) pairs which were dropped during aggregation,
+  attached to google.api.Distribution.Exemplars in google.api.Distribution
+  values during aggregation.
+  
+  These values are used in combination with the label values that remain
+  on the aggregated Distribution timeseries to construct the full label
+  set for the exemplar values. The resulting full label set may be used to
+  identify the specific task/job/instance (for example) which may be
+  contributing to a long-tail, while allowing the storage savings of only
+  storing aggregated distribution values for a large group.
+  
+  Note that there are no guarantees on ordering of the labels from
+  exemplar-to-exemplar and from distribution-to-distribution in the same
+  stream, and there may be duplicates. It is up to clients to resolve any
+  ambiguities.
+  
+  
+  Attributes:
+      label:
+          Map from label to its value, for all labels dropped in any
+          aggregation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.DroppedLabels)
+    ),
+)
+_sym_db.RegisterMessage(DroppedLabels)
+_sym_db.RegisterMessage(DroppedLabels.LabelEntry)
+
+
+DESCRIPTOR._options = None
+_DROPPEDLABELS_LABELENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/dropped_labels_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/group.proto b/monitoring/google/cloud/monitoring_v3/proto/group.proto
new file mode 100644
index 000000000000..ca46a0c0d6d8
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/group.proto
@@ -0,0 +1,76 @@
+// 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.monitoring.v3;
+
+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";
+
+// The description of a dynamic collection of monitored resources. Each group
+// has a filter that is matched against monitored resources and their associated
+// metadata. If a group's filter matches an available monitored resource, then
+// that resource is a member of that group.  Groups can contain any number of
+// monitored resources, and each monitored resource can be a member of any
+// number of groups.
+//
+// Groups can be nested in parent-child hierarchies. The `parentName` field
+// identifies an optional parent for each group.  If a group has a parent, then
+// the only monitored resources available to be matched by the group's filter
+// are the resources contained in the parent group.  In other words, a group
+// contains the monitored resources that match its filter and the filters of all
+// the group's ancestors.  A group without a parent can contain any monitored
+// resource.
+//
+// For example, consider an infrastructure running a set of instances with two
+// user-defined tags: `"environment"` and `"role"`. A parent group has a filter,
+// `environment="production"`.  A child of that parent group has a filter,
+// `role="transcoder"`.  The parent group contains all instances in the
+// production environment, regardless of their roles.  The child group contains
+// instances that have the transcoder role *and* are in the production
+// environment.
+//
+// The monitored resources contained in a group can change at any moment,
+// 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}"`.
+  // 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.
+  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, `""`.
+  string parent_name = 3;
+
+  // The filter used to determine which monitored resources belong to this
+  // group.
+  string filter = 5;
+
+  // If true, the members of this group are considered to be a cluster.
+  // The system can perform additional analysis on groups that are clusters.
+  bool is_cluster = 6;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py
new file mode 100644
index 000000000000..e194c3f6f0db
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/group_pb2.py
@@ -0,0 +1,209 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/group.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/group.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\nGroupProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/monitoring_v3/proto/group.proto\x12\x14google.monitoring.v3"d\n\x05Group\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0bparent_name\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x12\n\nis_cluster\x18\x06 \x01(\x08\x42\xa2\x01\n\x18\x63om.google.monitoring.v3B\nGroupProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+)
+
+
+_GROUP = _descriptor.Descriptor(
+    name="Group",
+    full_name="google.monitoring.v3.Group",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.Group.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.Group.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent_name",
+            full_name="google.monitoring.v3.Group.parent_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.Group.filter",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_cluster",
+            full_name="google.monitoring.v3.Group.is_cluster",
+            index=4,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=70,
+    serialized_end=170,
+)
+
+DESCRIPTOR.message_types_by_name["Group"] = _GROUP
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Group = _reflection.GeneratedProtocolMessageType(
+    "Group",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUP,
+        __module__="google.cloud.monitoring_v3.proto.group_pb2",
+        __doc__="""The description of a dynamic collection of monitored resources. Each
+  group has a filter that is matched against monitored resources and their
+  associated metadata. If a group's filter matches an available monitored
+  resource, then that resource is a member of that group. Groups can
+  contain any number of monitored resources, and each monitored resource
+  can be a member of any number of groups.
+  
+  Groups can be nested in parent-child hierarchies. The ``parentName``
+  field identifies an optional parent for each group. If a group has a
+  parent, then the only monitored resources available to be matched by the
+  group's filter are the resources contained in the parent group. In other
+  words, a group contains the monitored resources that match its filter
+  and the filters of all the group's ancestors. A group without a parent
+  can contain any monitored resource.
+  
+  For example, consider an infrastructure running a set of instances with
+  two user-defined tags: ``"environment"`` and ``"role"``. A parent group
+  has a filter, ``environment="production"``. A child of that parent group
+  has a filter, ``role="transcoder"``. The parent group contains all
+  instances in the production environment, regardless of their roles. The
+  child group contains instances that have the transcoder role *and* are
+  in the production environment.
+  
+  The monitored resources contained in a group can change at any moment,
+  depending on what resources exist and what filters are associated with
+  the group and its ancestors.
+  
+  
+  Attributes:
+      name:
+          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.
+      display_name:
+          A user-assigned name for this group, used only for display
+          purposes.
+      parent_name:
+          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,
+          ``""``.
+      filter:
+          The filter used to determine which monitored resources belong
+          to this group.
+      is_cluster:
+          If true, the members of this group are considered to be a
+          cluster. The system can perform additional analysis on groups
+          that are clusters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.Group)
+    ),
+)
+_sym_db.RegisterMessage(Group)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/group_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/group_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_service.proto b/monitoring/google/cloud/monitoring_v3/proto/group_service.proto
new file mode 100644
index 000000000000..34e1d9e997e6
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/group_service.proto
@@ -0,0 +1,222 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/api/monitored_resource.proto";
+import "google/monitoring/v3/common.proto";
+import "google/monitoring/v3/group.proto";
+import "google/protobuf/empty.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 = "GroupServiceProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// The Group API lets you inspect and manage your
+// [groups](#google.monitoring.v3.Group).
+//
+// A group is a named filter that is used to identify
+// a collection of monitored resources. Groups are typically used to
+// mirror the physical and/or logical topology of the environment.
+// Because group membership is computed dynamically, monitored
+// resources that are started in the future are automatically placed
+// in matching groups. By using a group to name monitored resources in,
+// for example, an alert policy, the target of that alert policy is
+// updated automatically as monitored resources are added and removed
+// from the infrastructure.
+service GroupService {
+  // Lists the existing groups.
+  rpc ListGroups(ListGroupsRequest) returns (ListGroupsResponse) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*}/groups"
+    };
+  }
+
+  // Gets a single group.
+  rpc GetGroup(GetGroupRequest) returns (Group) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/groups/*}"
+    };
+  }
+
+  // Creates a new group.
+  rpc CreateGroup(CreateGroupRequest) returns (Group) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*}/groups"
+      body: "group"
+    };
+  }
+
+  // Updates an existing group.
+  // You can change any group attributes except `name`.
+  rpc UpdateGroup(UpdateGroupRequest) returns (Group) {
+    option (google.api.http) = {
+      put: "/v3/{group.name=projects/*/groups/*}"
+      body: "group"
+    };
+  }
+
+  // Deletes an existing group.
+  rpc DeleteGroup(DeleteGroupRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=projects/*/groups/*}"
+    };
+  }
+
+  // Lists the monitored resources that are members of a group.
+  rpc ListGroupMembers(ListGroupMembersRequest)
+      returns (ListGroupMembersResponse) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/groups/*}/members"
+    };
+  }
+}
+
+// The `ListGroup` request.
+message ListGroupsRequest {
+  // The project whose groups are to be listed. The format is
+  // `"projects/{project_id_or_number}"`.
+  string name = 7;
+
+  // 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
+    // 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}"`.
+    // 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}"`.
+    // Returns the descendants of the specified group.  This is a superset of
+    // the results returned by the `childrenOfGroup` filter, and includes
+    // children-of-children, and so forth.
+    string descendants_of_group = 4;
+  }
+
+  // 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
+  // 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;
+}
+
+// The `ListGroups` response.
+message ListGroupsResponse {
+  // The groups that match the specified filters.
+  repeated Group group = 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 `GetGroup` request.
+message GetGroupRequest {
+  // The group to retrieve. The format is
+  // `"projects/{project_id_or_number}/groups/{group_id}"`.
+  string name = 3;
+}
+
+// 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
+  // the system assigns the name.
+  Group group = 2;
+
+  // If true, validate this request but do not create the group.
+  bool validate_only = 3;
+}
+
+// The `UpdateGroup` request.
+message UpdateGroupRequest {
+  // 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;
+
+  // 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.
+message DeleteGroupRequest {
+  // The group to delete. The format is
+  // `"projects/{project_id_or_number}/groups/{group_id}"`.
+  string name = 3;
+}
+
+// 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;
+
+  // 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
+  // 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:
+  //
+  //     resource.type = "gce_instance"
+  string filter = 5;
+
+  // An optional time interval for which results should be returned. Only
+  // members that were part of the group during the specified interval are
+  // included in the response.  If no interval is provided then the group
+  // membership over the last minute is returned.
+  TimeInterval interval = 6;
+}
+
+// The `ListGroupMembers` response.
+message ListGroupMembersResponse {
+  // A set of monitored resources in the group.
+  repeated google.api.MonitoredResource members = 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 total number of elements matching this request.
+  int32 total_size = 3;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py
new file mode 100644
index 000000000000..310d5b31fd6b
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2.py
@@ -0,0 +1,995 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/group_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    group_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/group_service.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\021GroupServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/monitoring_v3/proto/group_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a#google/api/monitored_resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a,google/cloud/monitoring_v3/proto/group.proto\x1a\x1bgoogle/protobuf/empty.proto"\xad\x01\n\x11ListGroupsRequest\x12\x0c\n\x04name\x18\x07 \x01(\t\x12\x1b\n\x11\x63hildren_of_group\x18\x02 \x01(\tH\x00\x12\x1c\n\x12\x61ncestors_of_group\x18\x03 \x01(\tH\x00\x12\x1e\n\x14\x64\x65scendants_of_group\x18\x04 \x01(\tH\x00\x12\x11\n\tpage_size\x18\x05 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\tB\x08\n\x06\x66ilter"Y\n\x12ListGroupsResponse\x12*\n\x05group\x18\x01 \x03(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1f\n\x0fGetGroupRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"e\n\x12\x43reateGroupRequest\x12\x0c\n\x04name\x18\x04 \x01(\t\x12*\n\x05group\x18\x02 \x01(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x15\n\rvalidate_only\x18\x03 \x01(\x08"W\n\x12UpdateGroupRequest\x12*\n\x05group\x18\x02 \x01(\x0b\x32\x1b.google.monitoring.v3.Group\x12\x15\n\rvalidate_only\x18\x03 \x01(\x08""\n\x12\x44\x65leteGroupRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"\x94\x01\n\x17ListGroupMembersRequest\x12\x0c\n\x04name\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t\x12\x34\n\x08interval\x18\x06 \x01(\x0b\x32".google.monitoring.v3.TimeInterval"w\n\x18ListGroupMembersResponse\x12.\n\x07members\x18\x01 \x03(\x0b\x32\x1d.google.api.MonitoredResource\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05\x32\xbb\x06\n\x0cGroupService\x12\x85\x01\n\nListGroups\x12\'.google.monitoring.v3.ListGroupsRequest\x1a(.google.monitoring.v3.ListGroupsResponse"$\x82\xd3\xe4\x93\x02\x1e\x12\x1c/v3/{name=projects/*}/groups\x12v\n\x08GetGroup\x12%.google.monitoring.v3.GetGroupRequest\x1a\x1b.google.monitoring.v3.Group"&\x82\xd3\xe4\x93\x02 \x12\x1e/v3/{name=projects/*/groups/*}\x12\x81\x01\n\x0b\x43reateGroup\x12(.google.monitoring.v3.CreateGroupRequest\x1a\x1b.google.monitoring.v3.Group"+\x82\xd3\xe4\x93\x02%"\x1c/v3/{name=projects/*}/groups:\x05group\x12\x89\x01\n\x0bUpdateGroup\x12(.google.monitoring.v3.UpdateGroupRequest\x1a\x1b.google.monitoring.v3.Group"3\x82\xd3\xe4\x93\x02-\x1a$/v3/{group.name=projects/*/groups/*}:\x05group\x12w\n\x0b\x44\x65leteGroup\x12(.google.monitoring.v3.DeleteGroupRequest\x1a\x16.google.protobuf.Empty"&\x82\xd3\xe4\x93\x02 *\x1e/v3/{name=projects/*/groups/*}\x12\xa1\x01\n\x10ListGroupMembers\x12-.google.monitoring.v3.ListGroupMembersRequest\x1a..google.monitoring.v3.ListGroupMembersResponse".\x82\xd3\xe4\x93\x02(\x12&/v3/{name=projects/*/groups/*}/membersB\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11GroupServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTGROUPSREQUEST = _descriptor.Descriptor(
+    name="ListGroupsRequest",
+    full_name="google.monitoring.v3.ListGroupsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListGroupsRequest.name",
+            index=0,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="children_of_group",
+            full_name="google.monitoring.v3.ListGroupsRequest.children_of_group",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ancestors_of_group",
+            full_name="google.monitoring.v3.ListGroupsRequest.ancestors_of_group",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="descendants_of_group",
+            full_name="google.monitoring.v3.ListGroupsRequest.descendants_of_group",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListGroupsRequest.page_size",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListGroupsRequest.page_token",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListGroupsRequest.filter",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=268,
+    serialized_end=441,
+)
+
+
+_LISTGROUPSRESPONSE = _descriptor.Descriptor(
+    name="ListGroupsResponse",
+    full_name="google.monitoring.v3.ListGroupsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group",
+            full_name="google.monitoring.v3.ListGroupsResponse.group",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListGroupsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=443,
+    serialized_end=532,
+)
+
+
+_GETGROUPREQUEST = _descriptor.Descriptor(
+    name="GetGroupRequest",
+    full_name="google.monitoring.v3.GetGroupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetGroupRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=534,
+    serialized_end=565,
+)
+
+
+_CREATEGROUPREQUEST = _descriptor.Descriptor(
+    name="CreateGroupRequest",
+    full_name="google.monitoring.v3.CreateGroupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.CreateGroupRequest.name",
+            index=0,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group",
+            full_name="google.monitoring.v3.CreateGroupRequest.group",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validate_only",
+            full_name="google.monitoring.v3.CreateGroupRequest.validate_only",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=567,
+    serialized_end=668,
+)
+
+
+_UPDATEGROUPREQUEST = _descriptor.Descriptor(
+    name="UpdateGroupRequest",
+    full_name="google.monitoring.v3.UpdateGroupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group",
+            full_name="google.monitoring.v3.UpdateGroupRequest.group",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="validate_only",
+            full_name="google.monitoring.v3.UpdateGroupRequest.validate_only",
+            index=1,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=670,
+    serialized_end=757,
+)
+
+
+_DELETEGROUPREQUEST = _descriptor.Descriptor(
+    name="DeleteGroupRequest",
+    full_name="google.monitoring.v3.DeleteGroupRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.DeleteGroupRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=759,
+    serialized_end=793,
+)
+
+
+_LISTGROUPMEMBERSREQUEST = _descriptor.Descriptor(
+    name="ListGroupMembersRequest",
+    full_name="google.monitoring.v3.ListGroupMembersRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListGroupMembersRequest.name",
+            index=0,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListGroupMembersRequest.page_size",
+            index=1,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListGroupMembersRequest.page_token",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListGroupMembersRequest.filter",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interval",
+            full_name="google.monitoring.v3.ListGroupMembersRequest.interval",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=796,
+    serialized_end=944,
+)
+
+
+_LISTGROUPMEMBERSRESPONSE = _descriptor.Descriptor(
+    name="ListGroupMembersResponse",
+    full_name="google.monitoring.v3.ListGroupMembersResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="members",
+            full_name="google.monitoring.v3.ListGroupMembersResponse.members",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListGroupMembersResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.monitoring.v3.ListGroupMembersResponse.total_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=946,
+    serialized_end=1065,
+)
+
+_LISTGROUPSREQUEST.oneofs_by_name["filter"].fields.append(
+    _LISTGROUPSREQUEST.fields_by_name["children_of_group"]
+)
+_LISTGROUPSREQUEST.fields_by_name[
+    "children_of_group"
+].containing_oneof = _LISTGROUPSREQUEST.oneofs_by_name["filter"]
+_LISTGROUPSREQUEST.oneofs_by_name["filter"].fields.append(
+    _LISTGROUPSREQUEST.fields_by_name["ancestors_of_group"]
+)
+_LISTGROUPSREQUEST.fields_by_name[
+    "ancestors_of_group"
+].containing_oneof = _LISTGROUPSREQUEST.oneofs_by_name["filter"]
+_LISTGROUPSREQUEST.oneofs_by_name["filter"].fields.append(
+    _LISTGROUPSREQUEST.fields_by_name["descendants_of_group"]
+)
+_LISTGROUPSREQUEST.fields_by_name[
+    "descendants_of_group"
+].containing_oneof = _LISTGROUPSREQUEST.oneofs_by_name["filter"]
+_LISTGROUPSRESPONSE.fields_by_name[
+    "group"
+].message_type = google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP
+_CREATEGROUPREQUEST.fields_by_name[
+    "group"
+].message_type = google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP
+_UPDATEGROUPREQUEST.fields_by_name[
+    "group"
+].message_type = google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP
+_LISTGROUPMEMBERSREQUEST.fields_by_name[
+    "interval"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._TIMEINTERVAL
+)
+_LISTGROUPMEMBERSRESPONSE.fields_by_name[
+    "members"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCE
+DESCRIPTOR.message_types_by_name["ListGroupsRequest"] = _LISTGROUPSREQUEST
+DESCRIPTOR.message_types_by_name["ListGroupsResponse"] = _LISTGROUPSRESPONSE
+DESCRIPTOR.message_types_by_name["GetGroupRequest"] = _GETGROUPREQUEST
+DESCRIPTOR.message_types_by_name["CreateGroupRequest"] = _CREATEGROUPREQUEST
+DESCRIPTOR.message_types_by_name["UpdateGroupRequest"] = _UPDATEGROUPREQUEST
+DESCRIPTOR.message_types_by_name["DeleteGroupRequest"] = _DELETEGROUPREQUEST
+DESCRIPTOR.message_types_by_name["ListGroupMembersRequest"] = _LISTGROUPMEMBERSREQUEST
+DESCRIPTOR.message_types_by_name["ListGroupMembersResponse"] = _LISTGROUPMEMBERSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListGroupsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListGroupsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGROUPSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``ListGroup`` request.
+  
+  
+  Attributes:
+      name:
+          The project whose groups are to be listed. The format is
+          ``"projects/{project_id_or_number}"``.
+      filter:
+          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.
+      children_of_group:
+          A group name:
+          ``"projects/{project_id_or_number}/groups/{group_id}"``.
+          Returns groups whose ``parentName`` field contains the group
+          name. If no groups have this parent, the results are empty.
+      ancestors_of_group:
+          A group name:
+          ``"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.
+      descendants_of_group:
+          A group name:
+          ``"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 children-of-children, and so forth.
+      page_size:
+          A positive number that is the maximum number of results to
+          return.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListGroupsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListGroupsRequest)
+
+ListGroupsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListGroupsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGROUPSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``ListGroups`` response.
+  
+  
+  Attributes:
+      group:
+          The groups that match the specified filters.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListGroupsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListGroupsResponse)
+
+GetGroupRequest = _reflection.GeneratedProtocolMessageType(
+    "GetGroupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETGROUPREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``GetGroup`` request.
+  
+  
+  Attributes:
+      name:
+          The group to retrieve. The format is
+          ``"projects/{project_id_or_number}/groups/{group_id}"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetGroupRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetGroupRequest)
+
+CreateGroupRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateGroupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEGROUPREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``CreateGroup`` request.
+  
+  
+  Attributes:
+      name:
+          The project in which to create the group. The format is
+          ``"projects/{project_id_or_number}"``.
+      group:
+          A group definition. It is an error to define the ``name``
+          field because the system assigns the name.
+      validate_only:
+          If true, validate this request but do not create the group.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateGroupRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateGroupRequest)
+
+UpdateGroupRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateGroupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEGROUPREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``UpdateGroup`` request.
+  
+  
+  Attributes:
+      group:
+          The new definition of the group. All fields of the existing
+          group, excepting ``name``, are replaced with the corresponding
+          fields of this group.
+      validate_only:
+          If true, validate this request but do not update the existing
+          group.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UpdateGroupRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateGroupRequest)
+
+DeleteGroupRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteGroupRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEGROUPREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``DeleteGroup`` request. You can only delete a group if it has no
+  children.
+  
+  
+  Attributes:
+      name:
+          The group to delete. The format is
+          ``"projects/{project_id_or_number}/groups/{group_id}"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteGroupRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteGroupRequest)
+
+ListGroupMembersRequest = _reflection.GeneratedProtocolMessageType(
+    "ListGroupMembersRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGROUPMEMBERSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``ListGroupMembers`` request.
+  
+  
+  Attributes:
+      name:
+          The group whose members are listed. The format is
+          ``"projects/{project_id_or_number}/groups/{group_id}"``.
+      page_size:
+          A positive number that is the maximum number of results to
+          return.
+      page_token:
+          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.
+      filter:
+          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:  ::
+          resource.type = "gce_instance"
+      interval:
+          An optional time interval for which results should be
+          returned. Only members that were part of the group during the
+          specified interval are included in the response. If no
+          interval is provided then the group membership over the last
+          minute is returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListGroupMembersRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListGroupMembersRequest)
+
+ListGroupMembersResponse = _reflection.GeneratedProtocolMessageType(
+    "ListGroupMembersResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGROUPMEMBERSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.group_service_pb2",
+        __doc__="""The ``ListGroupMembers`` response.
+  
+  
+  Attributes:
+      members:
+          A set of monitored resources in the group.
+      next_page_token:
+          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.
+      total_size:
+          The total number of elements matching this request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListGroupMembersResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListGroupMembersResponse)
+
+
+DESCRIPTOR._options = None
+
+_GROUPSERVICE = _descriptor.ServiceDescriptor(
+    name="GroupService",
+    full_name="google.monitoring.v3.GroupService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1068,
+    serialized_end=1895,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListGroups",
+            full_name="google.monitoring.v3.GroupService.ListGroups",
+            index=0,
+            containing_service=None,
+            input_type=_LISTGROUPSREQUEST,
+            output_type=_LISTGROUPSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\036\022\034/v3/{name=projects/*}/groups"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetGroup",
+            full_name="google.monitoring.v3.GroupService.GetGroup",
+            index=1,
+            containing_service=None,
+            input_type=_GETGROUPREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP,
+            serialized_options=_b(
+                "\202\323\344\223\002 \022\036/v3/{name=projects/*/groups/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateGroup",
+            full_name="google.monitoring.v3.GroupService.CreateGroup",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEGROUPREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP,
+            serialized_options=_b(
+                '\202\323\344\223\002%"\034/v3/{name=projects/*}/groups:\005group'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateGroup",
+            full_name="google.monitoring.v3.GroupService.UpdateGroup",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEGROUPREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2._GROUP,
+            serialized_options=_b(
+                "\202\323\344\223\002-\032$/v3/{group.name=projects/*/groups/*}:\005group"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteGroup",
+            full_name="google.monitoring.v3.GroupService.DeleteGroup",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEGROUPREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002 *\036/v3/{name=projects/*/groups/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListGroupMembers",
+            full_name="google.monitoring.v3.GroupService.ListGroupMembers",
+            index=5,
+            containing_service=None,
+            input_type=_LISTGROUPMEMBERSREQUEST,
+            output_type=_LISTGROUPMEMBERSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002(\022&/v3/{name=projects/*/groups/*}/members"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_GROUPSERVICE)
+
+DESCRIPTOR.services_by_name["GroupService"] = _GROUPSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2_grpc.py
new file mode 100644
index 000000000000..d681b6c18642
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/group_service_pb2_grpc.py
@@ -0,0 +1,161 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.monitoring_v3.proto import (
+    group_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    group_service_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class GroupServiceStub(object):
+    """The Group API lets you inspect and manage your
+  [groups](#google.monitoring.v3.Group).
+
+  A group is a named filter that is used to identify
+  a collection of monitored resources. Groups are typically used to
+  mirror the physical and/or logical topology of the environment.
+  Because group membership is computed dynamically, monitored
+  resources that are started in the future are automatically placed
+  in matching groups. By using a group to name monitored resources in,
+  for example, an alert policy, the target of that alert policy is
+  updated automatically as monitored resources are added and removed
+  from the infrastructure.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListGroups = channel.unary_unary(
+            "/google.monitoring.v3.GroupService/ListGroups",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupsResponse.FromString,
+        )
+        self.GetGroup = channel.unary_unary(
+            "/google.monitoring.v3.GroupService/GetGroup",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.GetGroupRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.Group.FromString,
+        )
+        self.CreateGroup = channel.unary_unary(
+            "/google.monitoring.v3.GroupService/CreateGroup",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.CreateGroupRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.Group.FromString,
+        )
+        self.UpdateGroup = channel.unary_unary(
+            "/google.monitoring.v3.GroupService/UpdateGroup",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.UpdateGroupRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.Group.FromString,
+        )
+        self.DeleteGroup = channel.unary_unary(
+            "/google.monitoring.v3.GroupService/DeleteGroup",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.DeleteGroupRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListGroupMembers = channel.unary_unary(
+            "/google.monitoring.v3.GroupService/ListGroupMembers",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupMembersRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupMembersResponse.FromString,
+        )
+
+
+class GroupServiceServicer(object):
+    """The Group API lets you inspect and manage your
+  [groups](#google.monitoring.v3.Group).
+
+  A group is a named filter that is used to identify
+  a collection of monitored resources. Groups are typically used to
+  mirror the physical and/or logical topology of the environment.
+  Because group membership is computed dynamically, monitored
+  resources that are started in the future are automatically placed
+  in matching groups. By using a group to name monitored resources in,
+  for example, an alert policy, the target of that alert policy is
+  updated automatically as monitored resources are added and removed
+  from the infrastructure.
+  """
+
+    def ListGroups(self, request, context):
+        """Lists the existing groups.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetGroup(self, request, context):
+        """Gets a single group.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateGroup(self, request, context):
+        """Creates a new group.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateGroup(self, request, context):
+        """Updates an existing group.
+    You can change any group attributes except `name`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteGroup(self, request, context):
+        """Deletes an existing group.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListGroupMembers(self, request, context):
+        """Lists the monitored resources that are members of a group.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_GroupServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListGroups": grpc.unary_unary_rpc_method_handler(
+            servicer.ListGroups,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupsResponse.SerializeToString,
+        ),
+        "GetGroup": grpc.unary_unary_rpc_method_handler(
+            servicer.GetGroup,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.GetGroupRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.Group.SerializeToString,
+        ),
+        "CreateGroup": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateGroup,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.CreateGroupRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.Group.SerializeToString,
+        ),
+        "UpdateGroup": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateGroup,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.UpdateGroupRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__pb2.Group.SerializeToString,
+        ),
+        "DeleteGroup": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteGroup,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.DeleteGroupRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListGroupMembers": grpc.unary_unary_rpc_method_handler(
+            servicer.ListGroupMembers,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupMembersRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_group__service__pb2.ListGroupMembersResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.monitoring.v3.GroupService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric.proto b/monitoring/google/cloud/monitoring_v3/proto/metric.proto
new file mode 100644
index 000000000000..c111d4fb4df2
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/metric.proto
@@ -0,0 +1,95 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/api/label.proto";
+import "google/api/metric.proto";
+import "google/api/monitored_resource.proto";
+import "google/monitoring/v3/common.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 = "MetricProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "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
+  // 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
+  // subsequent points specifying the same start time and increasing end times,
+  // until an event resets the cumulative value to zero and sets a new start
+  // time for the following points.
+  TimeInterval interval = 1;
+
+  // The value of the data point.
+  TypedValue value = 2;
+}
+
+// A collection of data points that describes the time-varying values
+// of a metric. A time series is identified by a combination of a
+// fully-specified monitored resource and a fully-specified metric.
+// This type is used for both listing and creating time series.
+message TimeSeries {
+  // The associated metric. A fully-specified metric used to identify the time
+  // series.
+  google.api.Metric metric = 1;
+
+  // The associated monitored resource.  Custom metrics can use only certain
+  // monitored resource types in their time series data.
+  google.api.MonitoredResource resource = 2;
+
+  // Output only. The associated monitored resource metadata. When reading a
+  // a timeseries, this field will include metadata labels that are explicitly
+  // named in the reduction. When creating a timeseries, this field is ignored.
+  google.api.MonitoredResourceMetadata metadata = 7;
+
+  // The metric kind of the time series. When listing time series, this metric
+  // kind might be different from the metric kind of the associated metric if
+  // this time series is an alignment or reduction of other time series.
+  //
+  // When creating a time series, this field is optional. If present, it must be
+  // the same as the metric kind of the associated metric. If the associated
+  // metric's descriptor must be auto-created, then this field specifies the
+  // metric kind of the new descriptor and must be either `GAUGE` (the default)
+  // or `CUMULATIVE`.
+  google.api.MetricDescriptor.MetricKind metric_kind = 3;
+
+  // The value type of the time series. When listing time series, this value
+  // type might be different from the value type of the associated metric if
+  // this time series is an alignment or reduction of other time series.
+  //
+  // When creating a time series, this field is optional. If present, it must be
+  // the same as the type of the data in the `points` field.
+  google.api.MetricDescriptor.ValueType value_type = 4;
+
+  // The data points of this time series. When listing time series, points are
+  // returned in reverse time order.
+  //
+  // When creating a time series, this field must contain exactly one point and
+  // the point's type must be the same as the value type of the associated
+  // metric. If the associated metric's descriptor must be auto-created, then
+  // the value type of the descriptor is determined by the point's type, which
+  // must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.
+  repeated Point points = 5;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/metric_pb2.py
new file mode 100644
index 000000000000..5df4f10ceb0b
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/metric_pb2.py
@@ -0,0 +1,351 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/metric.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import label_pb2 as google_dot_api_dot_label__pb2
+from google.api import metric_pb2 as google_dot_api_dot_metric__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/metric.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\013MetricProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/monitoring_v3/proto/metric.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x16google/api/label.proto\x1a\x17google/api/metric.proto\x1a#google/api/monitored_resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto"n\n\x05Point\x12\x34\n\x08interval\x18\x01 \x01(\x0b\x32".google.monitoring.v3.TimeInterval\x12/\n\x05value\x18\x02 \x01(\x0b\x32 .google.monitoring.v3.TypedValue"\xc1\x02\n\nTimeSeries\x12"\n\x06metric\x18\x01 \x01(\x0b\x32\x12.google.api.Metric\x12/\n\x08resource\x18\x02 \x01(\x0b\x32\x1d.google.api.MonitoredResource\x12\x37\n\x08metadata\x18\x07 \x01(\x0b\x32%.google.api.MonitoredResourceMetadata\x12<\n\x0bmetric_kind\x18\x03 \x01(\x0e\x32\'.google.api.MetricDescriptor.MetricKind\x12:\n\nvalue_type\x18\x04 \x01(\x0e\x32&.google.api.MetricDescriptor.ValueType\x12+\n\x06points\x18\x05 \x03(\x0b\x32\x1b.google.monitoring.v3.PointB\xa3\x01\n\x18\x63om.google.monitoring.v3B\x0bMetricProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_label__pb2.DESCRIPTOR,
+        google_dot_api_dot_metric__pb2.DESCRIPTOR,
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_POINT = _descriptor.Descriptor(
+    name="Point",
+    full_name="google.monitoring.v3.Point",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="interval",
+            full_name="google.monitoring.v3.Point.interval",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.Point.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=234,
+    serialized_end=344,
+)
+
+
+_TIMESERIES = _descriptor.Descriptor(
+    name="TimeSeries",
+    full_name="google.monitoring.v3.TimeSeries",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metric",
+            full_name="google.monitoring.v3.TimeSeries.metric",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource",
+            full_name="google.monitoring.v3.TimeSeries.resource",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.monitoring.v3.TimeSeries.metadata",
+            index=2,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metric_kind",
+            full_name="google.monitoring.v3.TimeSeries.metric_kind",
+            index=3,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value_type",
+            full_name="google.monitoring.v3.TimeSeries.value_type",
+            index=4,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="points",
+            full_name="google.monitoring.v3.TimeSeries.points",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=347,
+    serialized_end=668,
+)
+
+_POINT.fields_by_name[
+    "interval"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._TIMEINTERVAL
+)
+_POINT.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._TYPEDVALUE
+)
+_TIMESERIES.fields_by_name[
+    "metric"
+].message_type = google_dot_api_dot_metric__pb2._METRIC
+_TIMESERIES.fields_by_name[
+    "resource"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCE
+_TIMESERIES.fields_by_name[
+    "metadata"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCEMETADATA
+_TIMESERIES.fields_by_name[
+    "metric_kind"
+].enum_type = google_dot_api_dot_metric__pb2._METRICDESCRIPTOR_METRICKIND
+_TIMESERIES.fields_by_name[
+    "value_type"
+].enum_type = google_dot_api_dot_metric__pb2._METRICDESCRIPTOR_VALUETYPE
+_TIMESERIES.fields_by_name["points"].message_type = _POINT
+DESCRIPTOR.message_types_by_name["Point"] = _POINT
+DESCRIPTOR.message_types_by_name["TimeSeries"] = _TIMESERIES
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Point = _reflection.GeneratedProtocolMessageType(
+    "Point",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POINT,
+        __module__="google.cloud.monitoring_v3.proto.metric_pb2",
+        __doc__="""A single data point in a time series.
+  
+  
+  Attributes:
+      interval:
+          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 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 subsequent points specifying the same start
+          time and increasing end times, until an event resets the
+          cumulative value to zero and sets a new start time for the
+          following points.
+      value:
+          The value of the data point.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.Point)
+    ),
+)
+_sym_db.RegisterMessage(Point)
+
+TimeSeries = _reflection.GeneratedProtocolMessageType(
+    "TimeSeries",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMESERIES,
+        __module__="google.cloud.monitoring_v3.proto.metric_pb2",
+        __doc__="""A collection of data points that describes the time-varying values of a
+  metric. A time series is identified by a combination of a
+  fully-specified monitored resource and a fully-specified metric. This
+  type is used for both listing and creating time series.
+  
+  
+  Attributes:
+      metric:
+          The associated metric. A fully-specified metric used to
+          identify the time series.
+      resource:
+          The associated monitored resource. Custom metrics can use only
+          certain monitored resource types in their time series data.
+      metadata:
+          Output only. The associated monitored resource metadata. When
+          reading a a timeseries, this field will include metadata
+          labels that are explicitly named in the reduction. When
+          creating a timeseries, this field is ignored.
+      metric_kind:
+          The metric kind of the time series. When listing time series,
+          this metric kind might be different from the metric kind of
+          the associated metric if this time series is an alignment or
+          reduction of other time series.  When creating a time series,
+          this field is optional. If present, it must be the same as the
+          metric kind of the associated metric. If the associated
+          metric's descriptor must be auto-created, then this field
+          specifies the metric kind of the new descriptor and must be
+          either ``GAUGE`` (the default) or ``CUMULATIVE``.
+      value_type:
+          The value type of the time series. When listing time series,
+          this value type might be different from the value type of the
+          associated metric if this time series is an alignment or
+          reduction of other time series.  When creating a time series,
+          this field is optional. If present, it must be the same as the
+          type of the data in the ``points`` field.
+      points:
+          The data points of this time series. When listing time series,
+          points are returned in reverse time order.  When creating a
+          time series, this field must contain exactly one point and the
+          point's type must be the same as the value type of the
+          associated metric. If the associated metric's descriptor must
+          be auto-created, then the value type of the descriptor is
+          determined by the point's type, which must be ``BOOL``,
+          ``INT64``, ``DOUBLE``, or ``DISTRIBUTION``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.TimeSeries)
+    ),
+)
+_sym_db.RegisterMessage(TimeSeries)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/metric_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/metric_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto b/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto
new file mode 100644
index 000000000000..febd3f7b54aa
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/metric_service.proto
@@ -0,0 +1,322 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/api/metric.proto";
+import "google/api/monitored_resource.proto";
+import "google/monitoring/v3/common.proto";
+import "google/monitoring/v3/metric.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
+import "google/rpc/status.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 = "MetricServiceProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// 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.http) = {
+      get: "/v3/{name=projects/*}/monitoredResourceDescriptors"
+    };
+  }
+
+  // Gets a single monitored resource descriptor. This method does not require a
+  // Stackdriver account.
+  rpc GetMonitoredResourceDescriptor(GetMonitoredResourceDescriptorRequest)
+      returns (google.api.MonitoredResourceDescriptor) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/monitoredResourceDescriptors/*}"
+    };
+  }
+
+  // Lists metric descriptors that match a filter. This method does not require
+  // a Stackdriver account.
+  rpc ListMetricDescriptors(ListMetricDescriptorsRequest)
+      returns (ListMetricDescriptorsResponse) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*}/metricDescriptors"
+    };
+  }
+
+  // Gets a single metric descriptor. This method does not require a Stackdriver
+  // account.
+  rpc GetMetricDescriptor(GetMetricDescriptorRequest)
+      returns (google.api.MetricDescriptor) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/metricDescriptors/**}"
+    };
+  }
+
+  // Creates a new metric descriptor.
+  // User-created metric descriptors define
+  // [custom metrics](/monitoring/custom-metrics).
+  rpc CreateMetricDescriptor(CreateMetricDescriptorRequest)
+      returns (google.api.MetricDescriptor) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*}/metricDescriptors"
+      body: "metric_descriptor"
+    };
+  }
+
+  // Deletes a metric descriptor. Only user-created
+  // [custom metrics](/monitoring/custom-metrics) can be deleted.
+  rpc DeleteMetricDescriptor(DeleteMetricDescriptorRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=projects/*/metricDescriptors/**}"
+    };
+  }
+
+  // Lists time series that match a filter. This method does not require a
+  // Stackdriver account.
+  rpc ListTimeSeries(ListTimeSeriesRequest) returns (ListTimeSeriesResponse) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*}/timeSeries"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*}/timeSeries"
+      body: "*"
+    };
+  }
+}
+
+// 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:
+  //
+  //     resource.type = starts_with("gce_") AND resource.label:id
+  string filter = 2;
+
+  // 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
+  // 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 `ListMonitoredResourceDescriptors` response.
+message ListMonitoredResourceDescriptorsResponse {
+  // The monitored resource descriptors that are available to this project
+  // and that match `filter`, if present.
+  repeated google.api.MonitoredResourceDescriptor resource_descriptors = 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 `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
+  // `cloudsql_database`.
+  string name = 3;
+}
+
+// The `ListMetricDescriptors` request.
+message ListMetricDescriptorsRequest {
+  // The project on which to execute the request. The format is
+  // `"projects/{project_id_or_number}"`.
+  string name = 5;
+
+  // If this field is empty, all custom and
+  // system-defined metric descriptors are returned.
+  // Otherwise, the [filter](/monitoring/api/v3/filters)
+  // specifies which metric descriptors are to be
+  // returned. For example, the following filter matches all
+  // [custom metrics](/monitoring/custom-metrics):
+  //
+  //     metric.type = starts_with("custom.googleapis.com/")
+  string filter = 2;
+
+  // 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
+  // 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 `ListMetricDescriptors` response.
+message ListMetricDescriptorsResponse {
+  // The metric descriptors that are available to the project
+  // and that match the value of `filter`, if present.
+  repeated google.api.MetricDescriptor metric_descriptors = 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 `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
+  // `"compute.googleapis.com/instance/disk/read_bytes_count"`.
+  string name = 3;
+}
+
+// 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)
+  // descriptor.
+  google.api.MetricDescriptor metric_descriptor = 2;
+}
+
+// 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:
+  // `"custom.googleapis.com/my_test_metric"`.
+  string name = 3;
+}
+
+// The `ListTimeSeries` request.
+message ListTimeSeriesRequest {
+  // Controls which fields are returned by `ListTimeSeries`.
+  enum TimeSeriesView {
+    // Returns the identity of the metric(s), the time series,
+    // and the time series data.
+    FULL = 0;
+
+    // Returns the identity of the metric and the time series resource,
+    // but not the time series data.
+    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:
+  //
+  //     metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
+  //         metric.label.instance_name = "my-instance-name"
+  string filter = 2;
+
+  // 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;
+
+  // 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 = 5;
+
+  // Unsupported: must be left blank. The points in each time series are
+  // returned in reverse time order.
+  string order_by = 6;
+
+  // Specifies which information is returned about the time series.
+  TimeSeriesView view = 7;
+
+  // 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
+  // `page_size` is 100,000 results. If `view` is set to `FULL`, this is the
+  // maximum number of `Points` returned. If `view` is set to `HEADERS`, this is
+  // the maximum number of `TimeSeries` returned.
+  int32 page_size = 8;
+
+  // 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 = 9;
+}
+
+// The `ListTimeSeries` response.
+message ListTimeSeriesResponse {
+  // One or more time series that match the filter included in the request.
+  repeated TimeSeries time_series = 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;
+
+  // Query execution errors that may have caused the time series data returned
+  // to be incomplete.
+  repeated google.rpc.Status execution_errors = 3;
+}
+
+// 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.
+  // 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;
+}
+
+// Describes the result of a failed request to write data to a time series.
+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;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py
new file mode 100644
index 000000000000..a444d41f70e1
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2.py
@@ -0,0 +1,1418 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/metric_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import metric_pb2 as google_dot_api_dot_metric__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    metric_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/metric_service.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\022MetricServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/monitoring_v3/proto/metric_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/metric.proto\x1a#google/api/monitored_resource.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a-google/cloud/monitoring_v3/proto/metric.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x17google/rpc/status.proto"n\n\'ListMonitoredResourceDescriptorsRequest\x12\x0c\n\x04name\x18\x05 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x8a\x01\n(ListMonitoredResourceDescriptorsResponse\x12\x45\n\x14resource_descriptors\x18\x01 \x03(\x0b\x32\'.google.api.MonitoredResourceDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"5\n%GetMonitoredResourceDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"c\n\x1cListMetricDescriptorsRequest\x12\x0c\n\x04name\x18\x05 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"r\n\x1dListMetricDescriptorsResponse\x12\x38\n\x12metric_descriptors\x18\x01 \x03(\x0b\x32\x1c.google.api.MetricDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"*\n\x1aGetMetricDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"f\n\x1d\x43reateMetricDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x37\n\x11metric_descriptor\x18\x02 \x01(\x0b\x32\x1c.google.api.MetricDescriptor"-\n\x1d\x44\x65leteMetricDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"\xcf\x02\n\x15ListTimeSeriesRequest\x12\x0c\n\x04name\x18\n \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x34\n\x08interval\x18\x04 \x01(\x0b\x32".google.monitoring.v3.TimeInterval\x12\x36\n\x0b\x61ggregation\x18\x05 \x01(\x0b\x32!.google.monitoring.v3.Aggregation\x12\x10\n\x08order_by\x18\x06 \x01(\t\x12H\n\x04view\x18\x07 \x01(\x0e\x32:.google.monitoring.v3.ListTimeSeriesRequest.TimeSeriesView\x12\x11\n\tpage_size\x18\x08 \x01(\x05\x12\x12\n\npage_token\x18\t \x01(\t"\'\n\x0eTimeSeriesView\x12\x08\n\x04\x46ULL\x10\x00\x12\x0b\n\x07HEADERS\x10\x01"\x96\x01\n\x16ListTimeSeriesResponse\x12\x35\n\x0btime_series\x18\x01 \x03(\x0b\x32 .google.monitoring.v3.TimeSeries\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12,\n\x10\x65xecution_errors\x18\x03 \x03(\x0b\x32\x12.google.rpc.Status"^\n\x17\x43reateTimeSeriesRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x35\n\x0btime_series\x18\x02 \x03(\x0b\x32 .google.monitoring.v3.TimeSeries"r\n\x15\x43reateTimeSeriesError\x12\x35\n\x0btime_series\x18\x01 \x01(\x0b\x32 .google.monitoring.v3.TimeSeries\x12"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status2\xf5\n\n\rMetricService\x12\xdd\x01\n ListMonitoredResourceDescriptors\x12=.google.monitoring.v3.ListMonitoredResourceDescriptorsRequest\x1a>.google.monitoring.v3.ListMonitoredResourceDescriptorsResponse":\x82\xd3\xe4\x93\x02\x34\x12\x32/v3/{name=projects/*}/monitoredResourceDescriptors\x12\xc4\x01\n\x1eGetMonitoredResourceDescriptor\x12;.google.monitoring.v3.GetMonitoredResourceDescriptorRequest\x1a\'.google.api.MonitoredResourceDescriptor"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v3/{name=projects/*/monitoredResourceDescriptors/*}\x12\xb1\x01\n\x15ListMetricDescriptors\x12\x32.google.monitoring.v3.ListMetricDescriptorsRequest\x1a\x33.google.monitoring.v3.ListMetricDescriptorsResponse"/\x82\xd3\xe4\x93\x02)\x12\'/v3/{name=projects/*}/metricDescriptors\x12\x99\x01\n\x13GetMetricDescriptor\x12\x30.google.monitoring.v3.GetMetricDescriptorRequest\x1a\x1c.google.api.MetricDescriptor"2\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*/metricDescriptors/**}\x12\xaf\x01\n\x16\x43reateMetricDescriptor\x12\x33.google.monitoring.v3.CreateMetricDescriptorRequest\x1a\x1c.google.api.MetricDescriptor"B\x82\xd3\xe4\x93\x02<"\'/v3/{name=projects/*}/metricDescriptors:\x11metric_descriptor\x12\x99\x01\n\x16\x44\x65leteMetricDescriptor\x12\x33.google.monitoring.v3.DeleteMetricDescriptorRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,**/v3/{name=projects/*/metricDescriptors/**}\x12\x95\x01\n\x0eListTimeSeries\x12+.google.monitoring.v3.ListTimeSeriesRequest\x1a,.google.monitoring.v3.ListTimeSeriesResponse"(\x82\xd3\xe4\x93\x02"\x12 /v3/{name=projects/*}/timeSeries\x12\x86\x01\n\x10\x43reateTimeSeries\x12-.google.monitoring.v3.CreateTimeSeriesRequest\x1a\x16.google.protobuf.Empty"+\x82\xd3\xe4\x93\x02%" /v3/{name=projects/*}/timeSeries:\x01*B\xaa\x01\n\x18\x63om.google.monitoring.v3B\x12MetricServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_metric__pb2.DESCRIPTOR,
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTTIMESERIESREQUEST_TIMESERIESVIEW = _descriptor.EnumDescriptor(
+    name="TimeSeriesView",
+    full_name="google.monitoring.v3.ListTimeSeriesRequest.TimeSeriesView",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEADERS", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1368,
+    serialized_end=1407,
+)
+_sym_db.RegisterEnumDescriptor(_LISTTIMESERIESREQUEST_TIMESERIESVIEW)
+
+
+_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST = _descriptor.Descriptor(
+    name="ListMonitoredResourceDescriptorsRequest",
+    full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsRequest.name",
+            index=0,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=351,
+    serialized_end=461,
+)
+
+
+_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE = _descriptor.Descriptor(
+    name="ListMonitoredResourceDescriptorsResponse",
+    full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_descriptors",
+            full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsResponse.resource_descriptors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListMonitoredResourceDescriptorsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=464,
+    serialized_end=602,
+)
+
+
+_GETMONITOREDRESOURCEDESCRIPTORREQUEST = _descriptor.Descriptor(
+    name="GetMonitoredResourceDescriptorRequest",
+    full_name="google.monitoring.v3.GetMonitoredResourceDescriptorRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetMonitoredResourceDescriptorRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=604,
+    serialized_end=657,
+)
+
+
+_LISTMETRICDESCRIPTORSREQUEST = _descriptor.Descriptor(
+    name="ListMetricDescriptorsRequest",
+    full_name="google.monitoring.v3.ListMetricDescriptorsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListMetricDescriptorsRequest.name",
+            index=0,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListMetricDescriptorsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListMetricDescriptorsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListMetricDescriptorsRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=659,
+    serialized_end=758,
+)
+
+
+_LISTMETRICDESCRIPTORSRESPONSE = _descriptor.Descriptor(
+    name="ListMetricDescriptorsResponse",
+    full_name="google.monitoring.v3.ListMetricDescriptorsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metric_descriptors",
+            full_name="google.monitoring.v3.ListMetricDescriptorsResponse.metric_descriptors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListMetricDescriptorsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=760,
+    serialized_end=874,
+)
+
+
+_GETMETRICDESCRIPTORREQUEST = _descriptor.Descriptor(
+    name="GetMetricDescriptorRequest",
+    full_name="google.monitoring.v3.GetMetricDescriptorRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetMetricDescriptorRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=876,
+    serialized_end=918,
+)
+
+
+_CREATEMETRICDESCRIPTORREQUEST = _descriptor.Descriptor(
+    name="CreateMetricDescriptorRequest",
+    full_name="google.monitoring.v3.CreateMetricDescriptorRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.CreateMetricDescriptorRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metric_descriptor",
+            full_name="google.monitoring.v3.CreateMetricDescriptorRequest.metric_descriptor",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=920,
+    serialized_end=1022,
+)
+
+
+_DELETEMETRICDESCRIPTORREQUEST = _descriptor.Descriptor(
+    name="DeleteMetricDescriptorRequest",
+    full_name="google.monitoring.v3.DeleteMetricDescriptorRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.DeleteMetricDescriptorRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1024,
+    serialized_end=1069,
+)
+
+
+_LISTTIMESERIESREQUEST = _descriptor.Descriptor(
+    name="ListTimeSeriesRequest",
+    full_name="google.monitoring.v3.ListTimeSeriesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.name",
+            index=0,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interval",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.interval",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="aggregation",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.aggregation",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.order_by",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.view",
+            index=5,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.page_size",
+            index=6,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListTimeSeriesRequest.page_token",
+            index=7,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTTIMESERIESREQUEST_TIMESERIESVIEW],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1072,
+    serialized_end=1407,
+)
+
+
+_LISTTIMESERIESRESPONSE = _descriptor.Descriptor(
+    name="ListTimeSeriesResponse",
+    full_name="google.monitoring.v3.ListTimeSeriesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_series",
+            full_name="google.monitoring.v3.ListTimeSeriesResponse.time_series",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListTimeSeriesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="execution_errors",
+            full_name="google.monitoring.v3.ListTimeSeriesResponse.execution_errors",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1410,
+    serialized_end=1560,
+)
+
+
+_CREATETIMESERIESREQUEST = _descriptor.Descriptor(
+    name="CreateTimeSeriesRequest",
+    full_name="google.monitoring.v3.CreateTimeSeriesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.CreateTimeSeriesRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_series",
+            full_name="google.monitoring.v3.CreateTimeSeriesRequest.time_series",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1562,
+    serialized_end=1656,
+)
+
+
+_CREATETIMESERIESERROR = _descriptor.Descriptor(
+    name="CreateTimeSeriesError",
+    full_name="google.monitoring.v3.CreateTimeSeriesError",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_series",
+            full_name="google.monitoring.v3.CreateTimeSeriesError.time_series",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.monitoring.v3.CreateTimeSeriesError.status",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1658,
+    serialized_end=1772,
+)
+
+_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE.fields_by_name[
+    "resource_descriptors"
+].message_type = (
+    google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCEDESCRIPTOR
+)
+_LISTMETRICDESCRIPTORSRESPONSE.fields_by_name[
+    "metric_descriptors"
+].message_type = google_dot_api_dot_metric__pb2._METRICDESCRIPTOR
+_CREATEMETRICDESCRIPTORREQUEST.fields_by_name[
+    "metric_descriptor"
+].message_type = google_dot_api_dot_metric__pb2._METRICDESCRIPTOR
+_LISTTIMESERIESREQUEST.fields_by_name[
+    "interval"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._TIMEINTERVAL
+)
+_LISTTIMESERIESREQUEST.fields_by_name[
+    "aggregation"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._AGGREGATION
+)
+_LISTTIMESERIESREQUEST.fields_by_name[
+    "view"
+].enum_type = _LISTTIMESERIESREQUEST_TIMESERIESVIEW
+_LISTTIMESERIESREQUEST_TIMESERIESVIEW.containing_type = _LISTTIMESERIESREQUEST
+_LISTTIMESERIESRESPONSE.fields_by_name[
+    "time_series"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__pb2._TIMESERIES
+)
+_LISTTIMESERIESRESPONSE.fields_by_name[
+    "execution_errors"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_CREATETIMESERIESREQUEST.fields_by_name[
+    "time_series"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__pb2._TIMESERIES
+)
+_CREATETIMESERIESERROR.fields_by_name[
+    "time_series"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__pb2._TIMESERIES
+)
+_CREATETIMESERIESERROR.fields_by_name[
+    "status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+DESCRIPTOR.message_types_by_name[
+    "ListMonitoredResourceDescriptorsRequest"
+] = _LISTMONITOREDRESOURCEDESCRIPTORSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListMonitoredResourceDescriptorsResponse"
+] = _LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetMonitoredResourceDescriptorRequest"
+] = _GETMONITOREDRESOURCEDESCRIPTORREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListMetricDescriptorsRequest"
+] = _LISTMETRICDESCRIPTORSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListMetricDescriptorsResponse"
+] = _LISTMETRICDESCRIPTORSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetMetricDescriptorRequest"
+] = _GETMETRICDESCRIPTORREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateMetricDescriptorRequest"
+] = _CREATEMETRICDESCRIPTORREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteMetricDescriptorRequest"
+] = _DELETEMETRICDESCRIPTORREQUEST
+DESCRIPTOR.message_types_by_name["ListTimeSeriesRequest"] = _LISTTIMESERIESREQUEST
+DESCRIPTOR.message_types_by_name["ListTimeSeriesResponse"] = _LISTTIMESERIESRESPONSE
+DESCRIPTOR.message_types_by_name["CreateTimeSeriesRequest"] = _CREATETIMESERIESREQUEST
+DESCRIPTOR.message_types_by_name["CreateTimeSeriesError"] = _CREATETIMESERIESERROR
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListMonitoredResourceDescriptorsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListMonitoredResourceDescriptorsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``ListMonitoredResourceDescriptors`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is
+          ``"projects/{project_id_or_number}"``.
+      filter:
+          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::
+
+              resource.type = starts_with("gce_") AND resource.label:id
+
+      page_size:
+          A positive number that is the maximum number of results to
+          return.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListMonitoredResourceDescriptorsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListMonitoredResourceDescriptorsRequest)
+
+ListMonitoredResourceDescriptorsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListMonitoredResourceDescriptorsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``ListMonitoredResourceDescriptors`` response.
+  
+  
+  Attributes:
+      resource_descriptors:
+          The monitored resource descriptors that are available to this
+          project and that match ``filter``, if present.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListMonitoredResourceDescriptorsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListMonitoredResourceDescriptorsResponse)
+
+GetMonitoredResourceDescriptorRequest = _reflection.GeneratedProtocolMessageType(
+    "GetMonitoredResourceDescriptorRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETMONITOREDRESOURCEDESCRIPTORREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``GetMonitoredResourceDescriptor`` request.
+  
+  
+  Attributes:
+      name:
+          The monitored resource descriptor to get. The format is ``"pro
+          jects/{project_id_or_number}/monitoredResourceDescriptors/{res
+          ource_type}"``. The ``{resource_type}`` is a predefined type,
+          such as ``cloudsql_database``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetMonitoredResourceDescriptorRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetMonitoredResourceDescriptorRequest)
+
+ListMetricDescriptorsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListMetricDescriptorsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMETRICDESCRIPTORSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``ListMetricDescriptors`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is
+          ``"projects/{project_id_or_number}"``.
+      filter:
+          If this field is empty, all custom and system-defined metric
+          descriptors are returned. Otherwise, the `filter
+          </monitoring/api/v3/filters>`__ specifies which metric
+          descriptors are to be returned. For example, the following
+          filter matches all `custom metrics </monitoring/custom-
+          metrics>`__:  ::      metric.type =
+          starts_with("custom.googleapis.com/")
+      page_size:
+          A positive number that is the maximum number of results to
+          return.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListMetricDescriptorsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListMetricDescriptorsRequest)
+
+ListMetricDescriptorsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListMetricDescriptorsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTMETRICDESCRIPTORSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``ListMetricDescriptors`` response.
+  
+  
+  Attributes:
+      metric_descriptors:
+          The metric descriptors that are available to the project and
+          that match the value of ``filter``, if present.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListMetricDescriptorsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListMetricDescriptorsResponse)
+
+GetMetricDescriptorRequest = _reflection.GeneratedProtocolMessageType(
+    "GetMetricDescriptorRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETMETRICDESCRIPTORREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``GetMetricDescriptor`` request.
+  
+  
+  Attributes:
+      name:
+          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"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetMetricDescriptorRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetMetricDescriptorRequest)
+
+CreateMetricDescriptorRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateMetricDescriptorRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEMETRICDESCRIPTORREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``CreateMetricDescriptor`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is
+          ``"projects/{project_id_or_number}"``.
+      metric_descriptor:
+          The new `custom metric </monitoring/custom-metrics>`__
+          descriptor.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateMetricDescriptorRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateMetricDescriptorRequest)
+
+DeleteMetricDescriptorRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteMetricDescriptorRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEMETRICDESCRIPTORREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``DeleteMetricDescriptor`` request.
+  
+  
+  Attributes:
+      name:
+          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"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteMetricDescriptorRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteMetricDescriptorRequest)
+
+ListTimeSeriesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTimeSeriesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTIMESERIESREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``ListTimeSeries`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is
+          "projects/{project\_id\_or\_number}".
+      filter:
+          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:  ::
+          metric.type = "compute.googleapis.com/instance/cpu/usage_time"
+          AND         metric.label.instance_name = "my-instance-name"
+      interval:
+          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.
+      aggregation:
+          By default, the raw time series data is returned. Use this
+          field to combine multiple time series for different views of
+          the data.
+      order_by:
+          Unsupported: must be left blank. The points in each time
+          series are returned in reverse time order.
+      view:
+          Specifies which information is returned about the time series.
+      page_size:
+          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 ``page_size`` is 100,000 results. If
+          ``view`` is set to ``FULL``, this is the maximum number of
+          ``Points`` returned. If ``view`` is set to ``HEADERS``, this
+          is the maximum number of ``TimeSeries`` returned.
+      page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListTimeSeriesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTimeSeriesRequest)
+
+ListTimeSeriesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTimeSeriesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTIMESERIESRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``ListTimeSeries`` response.
+  
+  
+  Attributes:
+      time_series:
+          One or more time series that match the filter included in the
+          request.
+      next_page_token:
+          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.
+      execution_errors:
+          Query execution errors that may have caused the time series
+          data returned to be incomplete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListTimeSeriesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTimeSeriesResponse)
+
+CreateTimeSeriesRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTimeSeriesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETIMESERIESREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""The ``CreateTimeSeries`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is
+          ``"projects/{project_id_or_number}"``.
+      time_series:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateTimeSeriesRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTimeSeriesRequest)
+
+CreateTimeSeriesError = _reflection.GeneratedProtocolMessageType(
+    "CreateTimeSeriesError",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETIMESERIESERROR,
+        __module__="google.cloud.monitoring_v3.proto.metric_service_pb2",
+        __doc__="""Describes the result of a failed request to write data to a time series.
+  
+  
+  Attributes:
+      time_series:
+          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.
+      status:
+          The status of the requested write operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateTimeSeriesError)
+    ),
+)
+_sym_db.RegisterMessage(CreateTimeSeriesError)
+
+
+DESCRIPTOR._options = None
+
+_METRICSERVICE = _descriptor.ServiceDescriptor(
+    name="MetricService",
+    full_name="google.monitoring.v3.MetricService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1775,
+    serialized_end=3172,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListMonitoredResourceDescriptors",
+            full_name="google.monitoring.v3.MetricService.ListMonitoredResourceDescriptors",
+            index=0,
+            containing_service=None,
+            input_type=_LISTMONITOREDRESOURCEDESCRIPTORSREQUEST,
+            output_type=_LISTMONITOREDRESOURCEDESCRIPTORSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v3/{name=projects/*}/monitoredResourceDescriptors"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetMonitoredResourceDescriptor",
+            full_name="google.monitoring.v3.MetricService.GetMonitoredResourceDescriptor",
+            index=1,
+            containing_service=None,
+            input_type=_GETMONITOREDRESOURCEDESCRIPTORREQUEST,
+            output_type=google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCEDESCRIPTOR,
+            serialized_options=_b(
+                "\202\323\344\223\0026\0224/v3/{name=projects/*/monitoredResourceDescriptors/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListMetricDescriptors",
+            full_name="google.monitoring.v3.MetricService.ListMetricDescriptors",
+            index=2,
+            containing_service=None,
+            input_type=_LISTMETRICDESCRIPTORSREQUEST,
+            output_type=_LISTMETRICDESCRIPTORSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002)\022'/v3/{name=projects/*}/metricDescriptors"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetMetricDescriptor",
+            full_name="google.monitoring.v3.MetricService.GetMetricDescriptor",
+            index=3,
+            containing_service=None,
+            input_type=_GETMETRICDESCRIPTORREQUEST,
+            output_type=google_dot_api_dot_metric__pb2._METRICDESCRIPTOR,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v3/{name=projects/*/metricDescriptors/**}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateMetricDescriptor",
+            full_name="google.monitoring.v3.MetricService.CreateMetricDescriptor",
+            index=4,
+            containing_service=None,
+            input_type=_CREATEMETRICDESCRIPTORREQUEST,
+            output_type=google_dot_api_dot_metric__pb2._METRICDESCRIPTOR,
+            serialized_options=_b(
+                "\202\323\344\223\002<\"'/v3/{name=projects/*}/metricDescriptors:\021metric_descriptor"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteMetricDescriptor",
+            full_name="google.monitoring.v3.MetricService.DeleteMetricDescriptor",
+            index=5,
+            containing_service=None,
+            input_type=_DELETEMETRICDESCRIPTORREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002,**/v3/{name=projects/*/metricDescriptors/**}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTimeSeries",
+            full_name="google.monitoring.v3.MetricService.ListTimeSeries",
+            index=6,
+            containing_service=None,
+            input_type=_LISTTIMESERIESREQUEST,
+            output_type=_LISTTIMESERIESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002"\022 /v3/{name=projects/*}/timeSeries'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTimeSeries",
+            full_name="google.monitoring.v3.MetricService.CreateTimeSeries",
+            index=7,
+            containing_service=None,
+            input_type=_CREATETIMESERIESREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002%" /v3/{name=projects/*}/timeSeries:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_METRICSERVICE)
+
+DESCRIPTOR.services_by_name["MetricService"] = _METRICSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2_grpc.py
new file mode 100644
index 000000000000..3a8221bc67b0
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/metric_service_pb2_grpc.py
@@ -0,0 +1,186 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.api import metric_pb2 as google_dot_api_dot_metric__pb2
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    metric_service_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class MetricServiceStub(object):
+    """Manages metric descriptors, monitored resource descriptors, and
+  time series data.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListMonitoredResourceDescriptors = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/ListMonitoredResourceDescriptors",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMonitoredResourceDescriptorsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMonitoredResourceDescriptorsResponse.FromString,
+        )
+        self.GetMonitoredResourceDescriptor = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/GetMonitoredResourceDescriptor",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.GetMonitoredResourceDescriptorRequest.SerializeToString,
+            response_deserializer=google_dot_api_dot_monitored__resource__pb2.MonitoredResourceDescriptor.FromString,
+        )
+        self.ListMetricDescriptors = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/ListMetricDescriptors",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMetricDescriptorsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMetricDescriptorsResponse.FromString,
+        )
+        self.GetMetricDescriptor = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/GetMetricDescriptor",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.GetMetricDescriptorRequest.SerializeToString,
+            response_deserializer=google_dot_api_dot_metric__pb2.MetricDescriptor.FromString,
+        )
+        self.CreateMetricDescriptor = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/CreateMetricDescriptor",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.CreateMetricDescriptorRequest.SerializeToString,
+            response_deserializer=google_dot_api_dot_metric__pb2.MetricDescriptor.FromString,
+        )
+        self.DeleteMetricDescriptor = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/DeleteMetricDescriptor",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.DeleteMetricDescriptorRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListTimeSeries = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/ListTimeSeries",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListTimeSeriesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListTimeSeriesResponse.FromString,
+        )
+        self.CreateTimeSeries = channel.unary_unary(
+            "/google.monitoring.v3.MetricService/CreateTimeSeries",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.CreateTimeSeriesRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class MetricServiceServicer(object):
+    """Manages metric descriptors, monitored resource descriptors, and
+  time series data.
+  """
+
+    def ListMonitoredResourceDescriptors(self, request, context):
+        """Lists monitored resource descriptors that match a filter. This method does
+    not require a Stackdriver account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetMonitoredResourceDescriptor(self, request, context):
+        """Gets a single monitored resource descriptor. This method does not require a
+    Stackdriver account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListMetricDescriptors(self, request, context):
+        """Lists metric descriptors that match a filter. This method does not require
+    a Stackdriver account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetMetricDescriptor(self, request, context):
+        """Gets a single metric descriptor. This method does not require a Stackdriver
+    account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateMetricDescriptor(self, request, context):
+        """Creates a new metric descriptor.
+    User-created metric descriptors define
+    [custom metrics](/monitoring/custom-metrics).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteMetricDescriptor(self, request, context):
+        """Deletes a metric descriptor. Only user-created
+    [custom metrics](/monitoring/custom-metrics) can be deleted.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTimeSeries(self, request, context):
+        """Lists time series that match a filter. This method does not require a
+    Stackdriver account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTimeSeries(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_MetricServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListMonitoredResourceDescriptors": grpc.unary_unary_rpc_method_handler(
+            servicer.ListMonitoredResourceDescriptors,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMonitoredResourceDescriptorsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMonitoredResourceDescriptorsResponse.SerializeToString,
+        ),
+        "GetMonitoredResourceDescriptor": grpc.unary_unary_rpc_method_handler(
+            servicer.GetMonitoredResourceDescriptor,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.GetMonitoredResourceDescriptorRequest.FromString,
+            response_serializer=google_dot_api_dot_monitored__resource__pb2.MonitoredResourceDescriptor.SerializeToString,
+        ),
+        "ListMetricDescriptors": grpc.unary_unary_rpc_method_handler(
+            servicer.ListMetricDescriptors,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMetricDescriptorsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListMetricDescriptorsResponse.SerializeToString,
+        ),
+        "GetMetricDescriptor": grpc.unary_unary_rpc_method_handler(
+            servicer.GetMetricDescriptor,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.GetMetricDescriptorRequest.FromString,
+            response_serializer=google_dot_api_dot_metric__pb2.MetricDescriptor.SerializeToString,
+        ),
+        "CreateMetricDescriptor": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateMetricDescriptor,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.CreateMetricDescriptorRequest.FromString,
+            response_serializer=google_dot_api_dot_metric__pb2.MetricDescriptor.SerializeToString,
+        ),
+        "DeleteMetricDescriptor": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteMetricDescriptor,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.DeleteMetricDescriptorRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListTimeSeries": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTimeSeries,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListTimeSeriesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.ListTimeSeriesResponse.SerializeToString,
+        ),
+        "CreateTimeSeries": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTimeSeries,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_metric__service__pb2.CreateTimeSeriesRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.monitoring.v3.MetricService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/monitoring/google/cloud/monitoring_v3/proto/mutation_record.proto b/monitoring/google/cloud/monitoring_v3/proto/mutation_record.proto
new file mode 100644
index 000000000000..c87e2ebcc6e5
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/mutation_record.proto
@@ -0,0 +1,36 @@
+// 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.monitoring.v3;
+
+import "google/protobuf/timestamp.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 = "MutationRecordProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// Describes a change made to a configuration.
+message MutationRecord {
+  // When the change occurred.
+  google.protobuf.Timestamp mutate_time = 1;
+
+  // The email address of the user making the change.
+  string mutated_by = 2;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/mutation_record_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/mutation_record_pb2.py
new file mode 100644
index 000000000000..d3658ee2489e
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/mutation_record_pb2.py
@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/mutation_record.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/mutation_record.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\023MutationRecordProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/monitoring_v3/proto/mutation_record.proto\x12\x14google.monitoring.v3\x1a\x1fgoogle/protobuf/timestamp.proto"U\n\x0eMutationRecord\x12/\n\x0bmutate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nmutated_by\x18\x02 \x01(\tB\xab\x01\n\x18\x63om.google.monitoring.v3B\x13MutationRecordProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR],
+)
+
+
+_MUTATIONRECORD = _descriptor.Descriptor(
+    name="MutationRecord",
+    full_name="google.monitoring.v3.MutationRecord",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mutate_time",
+            full_name="google.monitoring.v3.MutationRecord.mutate_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mutated_by",
+            full_name="google.monitoring.v3.MutationRecord.mutated_by",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=113,
+    serialized_end=198,
+)
+
+_MUTATIONRECORD.fields_by_name[
+    "mutate_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["MutationRecord"] = _MUTATIONRECORD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+MutationRecord = _reflection.GeneratedProtocolMessageType(
+    "MutationRecord",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MUTATIONRECORD,
+        __module__="google.cloud.monitoring_v3.proto.mutation_record_pb2",
+        __doc__="""Describes a change made to a configuration.
+  
+  
+  Attributes:
+      mutate_time:
+          When the change occurred.
+      mutated_by:
+          The email address of the user making the change.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.MutationRecord)
+    ),
+)
+_sym_db.RegisterMessage(MutationRecord)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/mutation_record_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/mutation_record_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/mutation_record_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification.proto b/monitoring/google/cloud/monitoring_v3/proto/notification.proto
new file mode 100644
index 000000000000..f2812548e9db
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/notification.proto
@@ -0,0 +1,165 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/api/label.proto";
+import "google/monitoring/v3/common.proto";
+import "google/protobuf/wrappers.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 = "NotificationProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "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:
+  //
+  //     projects/[PROJECT_ID]/notificationChannelDescriptors/[TYPE]
+  //
+  // In the above, `[TYPE]` is the value of the `type` field.
+  string name = 6;
+
+  // The type of notification channel, such as "email", "sms", etc.
+  // Notification channel types are globally unique.
+  string type = 1;
+
+  // A human-readable name for the notification channel type.  This
+  // form of the name is suitable for a user interface.
+  string display_name = 2;
+
+  // A human-readable description of the notification channel
+  // type. The description may include a description of the properties
+  // of the channel and pointers to external documentation.
+  string description = 3;
+
+  // The set of labels that must be defined to identify a particular
+  // channel of the corresponding type. Each label includes a
+  // description for how that field should be populated.
+  repeated google.api.LabelDescriptor labels = 4;
+
+  // 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];
+}
+
+// A `NotificationChannel` is a medium through which an alert is
+// delivered when a policy violation is detected. Examples of channels
+// include email, SMS, and third-party messaging applications. Fields
+// containing sensitive information like authentication tokens or
+// contact info are only partially populated on retrieval.
+message NotificationChannel {
+  // Indicates whether the channel has been verified or not. It is illegal
+  // to specify this field in a
+  // [`CreateNotificationChannel`][google.monitoring.v3.NotificationChannelService.CreateNotificationChannel]
+  // or an
+  // [`UpdateNotificationChannel`][google.monitoring.v3.NotificationChannelService.UpdateNotificationChannel]
+  // operation.
+  enum VerificationStatus {
+    // Sentinel value used to indicate that the state is unknown, omitted, or
+    // is not applicable (as in the case of channels that neither support
+    // nor require verification in order to function).
+    VERIFICATION_STATUS_UNSPECIFIED = 0;
+
+    // The channel has yet to be verified and requires verification to function.
+    // Note that this state also applies to the case where the verification
+    // process has been initiated by sending a verification code but where
+    // the verification code has not been submitted to complete the process.
+    UNVERIFIED = 1;
+
+    // It has been proven that notifications can be received on this
+    // notification channel and that someone on the project has access
+    // to messages that are delivered to that channel.
+    VERIFIED = 2;
+  }
+
+  // The type of the notification channel. This field matches the
+  // 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:
+  //
+  //     projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]
+  //
+  // The `[CHANNEL_ID]` is automatically assigned by the server on creation.
+  string name = 6;
+
+  // An optional human-readable name for this notification channel. It is
+  // recommended that you specify a non-empty and unique name in order to
+  // make it easier to identify the channels in your project, though this is
+  // not enforced. The display name is limited to 512 Unicode characters.
+  string display_name = 3;
+
+  // 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.
+  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.
+  map<string, string> labels = 5;
+
+  // User-supplied key/value data that does not need to conform to
+  // the corresponding `NotificationChannelDescriptor`'s schema, unlike
+  // the `labels` field. This field is intended to be used for organizing
+  // and identifying the `NotificationChannel` objects.
+  //
+  // The field can contain up to 64 entries. Each key and value is limited to
+  // 63 Unicode characters or 128 bytes, whichever is smaller. Labels and
+  // values can contain only lowercase letters, numerals, underscores, and
+  // dashes. Keys must begin with a letter.
+  map<string, string> user_labels = 8;
+
+  // Indicates whether this channel has been verified or not. On a
+  // [`ListNotificationChannels`][google.monitoring.v3.NotificationChannelService.ListNotificationChannels]
+  // or
+  // [`GetNotificationChannel`][google.monitoring.v3.NotificationChannelService.GetNotificationChannel]
+  // operation, this field is expected to be populated.
+  //
+  // If the value is `UNVERIFIED`, then it indicates that the channel is
+  // non-functioning (it both requires verification and lacks verification);
+  // otherwise, it is assumed that the channel works.
+  //
+  // If the channel is neither `VERIFIED` nor `UNVERIFIED`, it implies that
+  // the channel is of a type that does not require verification or that
+  // this specific channel has been exempted from verification because it was
+  // created prior to verification being required for channels of this type.
+  //
+  // This field cannot be modified using a standard
+  // [`UpdateNotificationChannel`][google.monitoring.v3.NotificationChannelService.UpdateNotificationChannel]
+  // operation. To change the value of this field, you must call
+  // [`VerifyNotificationChannel`][google.monitoring.v3.NotificationChannelService.VerifyNotificationChannel].
+  VerificationStatus verification_status = 9;
+
+  // Whether notifications are forwarded to the described channel. This makes
+  // it possible to disable delivery of notifications to a particular channel
+  // without removing the channel from all alerting policies that reference
+  // the channel. This is a more convenient approach when the change is
+  // temporary and you want to receive notifications from the same set
+  // of alerting policies on the channel at some point in the future.
+  google.protobuf.BoolValue enabled = 11;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py
new file mode 100644
index 000000000000..71f580b67b16
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/notification_pb2.py
@@ -0,0 +1,659 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/notification.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import label_pb2 as google_dot_api_dot_label__pb2
+from google.cloud.monitoring_v3.proto import (
+    common_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2,
+)
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/notification.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\021NotificationProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/monitoring_v3/proto/notification.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x16google/api/label.proto\x1a-google/cloud/monitoring_v3/proto/common.proto\x1a\x1egoogle/protobuf/wrappers.proto"\xd3\x01\n\x1dNotificationChannelDescriptor\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12+\n\x06labels\x18\x04 \x03(\x0b\x32\x1b.google.api.LabelDescriptor\x12>\n\x0fsupported_tiers\x18\x05 \x03(\x0e\x32!.google.monitoring.v3.ServiceTierB\x02\x18\x01"\xb6\x04\n\x13NotificationChannel\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x45\n\x06labels\x18\x05 \x03(\x0b\x32\x35.google.monitoring.v3.NotificationChannel.LabelsEntry\x12N\n\x0buser_labels\x18\x08 \x03(\x0b\x32\x39.google.monitoring.v3.NotificationChannel.UserLabelsEntry\x12Y\n\x13verification_status\x18\t \x01(\x0e\x32<.google.monitoring.v3.NotificationChannel.VerificationStatus\x12+\n\x07\x65nabled\x18\x0b \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x31\n\x0fUserLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"W\n\x12VerificationStatus\x12#\n\x1fVERIFICATION_STATUS_UNSPECIFIED\x10\x00\x12\x0e\n\nUNVERIFIED\x10\x01\x12\x0c\n\x08VERIFIED\x10\x02\x42\xa9\x01\n\x18\x63om.google.monitoring.v3B\x11NotificationProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_label__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_NOTIFICATIONCHANNEL_VERIFICATIONSTATUS = _descriptor.EnumDescriptor(
+    name="VerificationStatus",
+    full_name="google.monitoring.v3.NotificationChannel.VerificationStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VERIFICATION_STATUS_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNVERIFIED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERIFIED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=904,
+    serialized_end=991,
+)
+_sym_db.RegisterEnumDescriptor(_NOTIFICATIONCHANNEL_VERIFICATIONSTATUS)
+
+
+_NOTIFICATIONCHANNELDESCRIPTOR = _descriptor.Descriptor(
+    name="NotificationChannelDescriptor",
+    full_name="google.monitoring.v3.NotificationChannelDescriptor",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.NotificationChannelDescriptor.name",
+            index=0,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.monitoring.v3.NotificationChannelDescriptor.type",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.NotificationChannelDescriptor.display_name",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.monitoring.v3.NotificationChannelDescriptor.description",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.monitoring.v3.NotificationChannelDescriptor.labels",
+            index=4,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="supported_tiers",
+            full_name="google.monitoring.v3.NotificationChannelDescriptor.supported_tiers",
+            index=5,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=211,
+    serialized_end=422,
+)
+
+
+_NOTIFICATIONCHANNEL_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.monitoring.v3.NotificationChannel.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.monitoring.v3.NotificationChannel.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.NotificationChannel.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=806,
+    serialized_end=851,
+)
+
+_NOTIFICATIONCHANNEL_USERLABELSENTRY = _descriptor.Descriptor(
+    name="UserLabelsEntry",
+    full_name="google.monitoring.v3.NotificationChannel.UserLabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.monitoring.v3.NotificationChannel.UserLabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.NotificationChannel.UserLabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=853,
+    serialized_end=902,
+)
+
+_NOTIFICATIONCHANNEL = _descriptor.Descriptor(
+    name="NotificationChannel",
+    full_name="google.monitoring.v3.NotificationChannel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.monitoring.v3.NotificationChannel.type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.NotificationChannel.name",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.NotificationChannel.display_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.monitoring.v3.NotificationChannel.description",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.monitoring.v3.NotificationChannel.labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_labels",
+            full_name="google.monitoring.v3.NotificationChannel.user_labels",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="verification_status",
+            full_name="google.monitoring.v3.NotificationChannel.verification_status",
+            index=6,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enabled",
+            full_name="google.monitoring.v3.NotificationChannel.enabled",
+            index=7,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _NOTIFICATIONCHANNEL_LABELSENTRY,
+        _NOTIFICATIONCHANNEL_USERLABELSENTRY,
+    ],
+    enum_types=[_NOTIFICATIONCHANNEL_VERIFICATIONSTATUS],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=425,
+    serialized_end=991,
+)
+
+_NOTIFICATIONCHANNELDESCRIPTOR.fields_by_name[
+    "labels"
+].message_type = google_dot_api_dot_label__pb2._LABELDESCRIPTOR
+_NOTIFICATIONCHANNELDESCRIPTOR.fields_by_name[
+    "supported_tiers"
+].enum_type = google_dot_cloud_dot_monitoring__v3_dot_proto_dot_common__pb2._SERVICETIER
+_NOTIFICATIONCHANNEL_LABELSENTRY.containing_type = _NOTIFICATIONCHANNEL
+_NOTIFICATIONCHANNEL_USERLABELSENTRY.containing_type = _NOTIFICATIONCHANNEL
+_NOTIFICATIONCHANNEL.fields_by_name[
+    "labels"
+].message_type = _NOTIFICATIONCHANNEL_LABELSENTRY
+_NOTIFICATIONCHANNEL.fields_by_name[
+    "user_labels"
+].message_type = _NOTIFICATIONCHANNEL_USERLABELSENTRY
+_NOTIFICATIONCHANNEL.fields_by_name[
+    "verification_status"
+].enum_type = _NOTIFICATIONCHANNEL_VERIFICATIONSTATUS
+_NOTIFICATIONCHANNEL.fields_by_name[
+    "enabled"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_NOTIFICATIONCHANNEL_VERIFICATIONSTATUS.containing_type = _NOTIFICATIONCHANNEL
+DESCRIPTOR.message_types_by_name[
+    "NotificationChannelDescriptor"
+] = _NOTIFICATIONCHANNELDESCRIPTOR
+DESCRIPTOR.message_types_by_name["NotificationChannel"] = _NOTIFICATIONCHANNEL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+NotificationChannelDescriptor = _reflection.GeneratedProtocolMessageType(
+    "NotificationChannelDescriptor",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NOTIFICATIONCHANNELDESCRIPTOR,
+        __module__="google.cloud.monitoring_v3.proto.notification_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The full REST resource name for this descriptor. The syntax
+          is:  ::
+          projects/[PROJECT_ID]/notificationChannelDescriptors/[TYPE]
+          In the above, ``[TYPE]`` is the value of the ``type`` field.
+      type:
+          The type of notification channel, such as "email", "sms", etc.
+          Notification channel types are globally unique.
+      display_name:
+          A human-readable name for the notification channel type. This
+          form of the name is suitable for a user interface.
+      description:
+          A human-readable description of the notification channel type.
+          The description may include a description of the properties of
+          the channel and pointers to external documentation.
+      labels:
+          The set of labels that must be defined to identify a
+          particular channel of the corresponding type. Each label
+          includes a description for how that field should be populated.
+      supported_tiers:
+          The tiers that support this notification channel; the project
+          service tier must be one of the supported\_tiers.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.NotificationChannelDescriptor)
+    ),
+)
+_sym_db.RegisterMessage(NotificationChannelDescriptor)
+
+NotificationChannel = _reflection.GeneratedProtocolMessageType(
+    "NotificationChannel",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_NOTIFICATIONCHANNEL_LABELSENTRY,
+                __module__="google.cloud.monitoring_v3.proto.notification_pb2"
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.NotificationChannel.LabelsEntry)
+            ),
+        ),
+        UserLabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "UserLabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_NOTIFICATIONCHANNEL_USERLABELSENTRY,
+                __module__="google.cloud.monitoring_v3.proto.notification_pb2"
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.NotificationChannel.UserLabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_NOTIFICATIONCHANNEL,
+        __module__="google.cloud.monitoring_v3.proto.notification_pb2",
+        __doc__="""A ``NotificationChannel`` is a medium through which an alert is
+  delivered when a policy violation is detected. Examples of channels
+  include email, SMS, and third-party messaging applications. Fields
+  containing sensitive information like authentication tokens or contact
+  info are only partially populated on retrieval.
+  
+  
+  Attributes:
+      type:
+          The type of the notification channel. This field matches the
+          value of the [NotificationChannelDescriptor.type][google.monit
+          oring.v3.NotificationChannelDescriptor.type] field.
+      name:
+          The full REST resource name for this channel. The syntax is:
+          ::
+          projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]  The
+          ``[CHANNEL_ID]`` is automatically assigned by the server on
+          creation.
+      display_name:
+          An optional human-readable name for this notification channel.
+          It is recommended that you specify a non-empty and unique name
+          in order to make it easier to identify the channels in your
+          project, though this is not enforced. The display name is
+          limited to 512 Unicode characters.
+      description:
+          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.
+      labels:
+          Configuration fields that define the channel and its behavior.
+          The permissible and required labels are specified in the [Noti
+          ficationChannelDescriptor.labels][google.monitoring.v3.Notific
+          ationChannelDescriptor.labels] of the
+          ``NotificationChannelDescriptor`` corresponding to the
+          ``type`` field.
+      user_labels:
+          User-supplied key/value data that does not need to conform to
+          the corresponding ``NotificationChannelDescriptor``'s schema,
+          unlike the ``labels`` field. This field is intended to be used
+          for organizing and identifying the ``NotificationChannel``
+          objects.  The field can contain up to 64 entries. Each key and
+          value is limited to 63 Unicode characters or 128 bytes,
+          whichever is smaller. Labels and values can contain only
+          lowercase letters, numerals, underscores, and dashes. Keys
+          must begin with a letter.
+      verification_status:
+          Indicates whether this channel has been verified or not. On a 
+          [``ListNotificationChannels``][google.monitoring.v3.Notificati
+          onChannelService.ListNotificationChannels] or [``GetNotificati
+          onChannel``][google.monitoring.v3.NotificationChannelService.G
+          etNotificationChannel] operation, this field is expected to be
+          populated.  If the value is ``UNVERIFIED``, then it indicates
+          that the channel is non-functioning (it both requires
+          verification and lacks verification); otherwise, it is assumed
+          that the channel works.  If the channel is neither
+          ``VERIFIED`` nor ``UNVERIFIED``, it implies that the channel
+          is of a type that does not require verification or that this
+          specific channel has been exempted from verification because
+          it was created prior to verification being required for
+          channels of this type.  This field cannot be modified using a
+          standard [``UpdateNotificationChannel``][google.monitoring.v3.
+          NotificationChannelService.UpdateNotificationChannel]
+          operation. To change the value of this field, you must call [`
+          `VerifyNotificationChannel``][google.monitoring.v3.Notificatio
+          nChannelService.VerifyNotificationChannel].
+      enabled:
+          Whether notifications are forwarded to the described channel.
+          This makes it possible to disable delivery of notifications to
+          a particular channel without removing the channel from all
+          alerting policies that reference the channel. This is a more
+          convenient approach when the change is temporary and you want
+          to receive notifications from the same set of alerting
+          policies on the channel at some point in the future.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.NotificationChannel)
+    ),
+)
+_sym_db.RegisterMessage(NotificationChannel)
+_sym_db.RegisterMessage(NotificationChannel.LabelsEntry)
+_sym_db.RegisterMessage(NotificationChannel.UserLabelsEntry)
+
+
+DESCRIPTOR._options = None
+_NOTIFICATIONCHANNELDESCRIPTOR.fields_by_name["supported_tiers"]._options = None
+_NOTIFICATIONCHANNEL_LABELSENTRY._options = None
+_NOTIFICATIONCHANNEL_USERLABELSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/notification_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/notification_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification_service.proto b/monitoring/google/cloud/monitoring_v3/proto/notification_service.proto
new file mode 100644
index 000000000000..e178e0cad078
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/notification_service.proto
@@ -0,0 +1,350 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/monitoring/v3/notification.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.Monitoring.V3";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
+option java_multiple_files = true;
+option java_outer_classname = "NotificationServiceProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// The Notification Channel API provides access to configuration that
+// controls how messages related to incidents are sent.
+service NotificationChannelService {
+  // 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) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*}/notificationChannelDescriptors"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/notificationChannelDescriptors/*}"
+    };
+  }
+
+  // Lists the notification channels that have been created for the project.
+  rpc ListNotificationChannels(ListNotificationChannelsRequest)
+      returns (ListNotificationChannelsResponse) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*}/notificationChannels"
+    };
+  }
+
+  // Gets a single notification channel. The channel includes the relevant
+  // configuration details with which the channel was created. However, the
+  // 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) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/notificationChannels/*}"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*}/notificationChannels"
+      body: "notification_channel"
+    };
+  }
+
+  // Updates a notification channel. Fields not specified in the field mask
+  // remain unchanged.
+  rpc UpdateNotificationChannel(UpdateNotificationChannelRequest)
+      returns (NotificationChannel) {
+    option (google.api.http) = {
+      patch: "/v3/{notification_channel.name=projects/*/notificationChannels/*}"
+      body: "notification_channel"
+    };
+  }
+
+  // Deletes a notification channel.
+  rpc DeleteNotificationChannel(DeleteNotificationChannelRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=projects/*/notificationChannels/*}"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode"
+      body: "*"
+    };
+  }
+
+  // Requests a verification code for an already verified channel that can then
+  // be used in a call to VerifyNotificationChannel() on a different channel
+  // with an equivalent identity in the same or in a different project. This
+  // makes it possible to copy a channel between projects without requiring
+  // manual reverification of the channel. If the channel is not in the
+  // verified state, this method will fail (in other words, this may only be
+  // used if the SendNotificationChannelVerificationCode and
+  // VerifyNotificationChannel paths have already been used to put the given
+  // channel into the verified state).
+  //
+  // There is no guarantee that the verification codes returned by this method
+  // will be of a similar structure or form as the ones that are delivered
+  // to the channel via SendNotificationChannelVerificationCode; while
+  // VerifyNotificationChannel() will recognize both the codes delivered via
+  // SendNotificationChannelVerificationCode() and returned from
+  // GetNotificationChannelVerificationCode(), it is typically the case that
+  // the verification codes delivered via
+  // SendNotificationChannelVerificationCode() will be shorter and also
+  // 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) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*/notificationChannels/*}:getVerificationCode"
+      body: "*"
+    };
+  }
+
+  // Verifies a `NotificationChannel` by proving receipt of the code
+  // delivered to the channel as a result of calling
+  // `SendNotificationChannelVerificationCode`.
+  rpc VerifyNotificationChannel(VerifyNotificationChannelRequest)
+      returns (NotificationChannel) {
+    option (google.api.http) = {
+      post: "/v3/{name=projects/*/notificationChannels/*}:verify"
+      body: "*"
+    };
+  }
+}
+
+// The `ListNotificationChannelDescriptors` request.
+message ListNotificationChannelDescriptorsRequest {
+  // The REST resource name of the parent from which to retrieve
+  // the notification channel descriptors. The expected syntax is:
+  //
+  //     projects/[PROJECT_ID]
+  //
+  // 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;
+
+  // 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
+  // service.
+  int32 page_size = 2;
+
+  // If non-empty, `page_token` must contain a value returned as the
+  // `next_page_token` in a previous response to request the next set
+  // of results.
+  string page_token = 3;
+}
+
+// The `ListNotificationChannelDescriptors` response.
+message ListNotificationChannelDescriptorsResponse {
+  // The monitored resource descriptors supported for the specified
+  // project, optionally filtered.
+  repeated NotificationChannelDescriptor channel_descriptors = 1;
+
+  // If not empty, indicates that there may be more results that match
+  // the request. Use the value in the `page_token` field in a
+  // subsequent request to fetch the next set of results. If empty,
+  // all results have been returned.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// The `CreateNotificationChannel` request.
+message CreateNotificationChannelRequest {
+  // The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID]
+  //
+  // Note that 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;
+}
+
+// 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
+  // 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;
+
+  // 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).
+  string filter = 6;
+
+  // A comma-separated list of fields by which to sort the result. Supports
+  // the same set of fields as in `filter`. Entries can be prefixed with
+  // a minus sign to sort in descending rather than ascending order.
+  //
+  // For more details, see [sorting and
+  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  string order_by = 7;
+
+  // 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
+  // service.
+  int32 page_size = 3;
+
+  // If non-empty, `page_token` must contain a value returned as the
+  // `next_page_token` in a previous response to request the next set
+  // of results.
+  string page_token = 4;
+}
+
+// The `ListNotificationChannels` response.
+message ListNotificationChannelsResponse {
+  // The notification channels defined for the specified project.
+  repeated NotificationChannel notification_channels = 3;
+
+  // If not empty, indicates that there may be more results that match
+  // the request. Use the value in the `page_token` field in a
+  // subsequent request to fetch the next set of results. If empty,
+  // all results have been returned.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// The `UpdateNotificationChannel` request.
+message UpdateNotificationChannelRequest {
+  // The fields to update.
+  google.protobuf.FieldMask update_mask = 2;
+
+  // 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;
+}
+
+// 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;
+
+  // If true, the notification channel will be deleted regardless of its
+  // use in alert policies (the policies will be updated to remove the
+  // channel). If false, channels that are still referenced by an existing
+  // alerting policy will fail to be deleted in a delete operation.
+  bool force = 5;
+}
+
+// The `SendNotificationChannelVerificationCode` request.
+message SendNotificationChannelVerificationCodeRequest {
+  // The notification channel to which to send a verification code.
+  string name = 1;
+}
+
+// The `GetNotificationChannelVerificationCode` request.
+message GetNotificationChannelVerificationCodeRequest {
+  // 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;
+
+  // The desired expiration time. If specified, the API will guarantee that
+  // the returned code will not be valid after the specified timestamp;
+  // however, the API cannot guarantee that the returned code will be
+  // valid for at least as long as the requested time (the API puts an upper
+  // bound on the amount of time for which a code may be valid). If omitted,
+  // a default expiration will be used, which may be less than the max
+  // permissible expiration (so specifying an expiration may extend the
+  // code's lifetime over omitting an expiration, even though the API does
+  // impose an upper limit on the maximum expiration that is permitted).
+  google.protobuf.Timestamp expire_time = 2;
+}
+
+// The `GetNotificationChannelVerificationCode` request.
+message GetNotificationChannelVerificationCodeResponse {
+  // The verification code, which may be used to verify other channels
+  // that have an equivalent identity (i.e. other channels of the same
+  // type with the same fingerprint such as other email channels with
+  // the same email address or other sms channels with the same number).
+  string code = 1;
+
+  // The expiration time associated with the code that was returned. If
+  // an expiration was provided in the request, this is the minimum of the
+  // requested expiration in the request and the max permitted expiration.
+  google.protobuf.Timestamp expire_time = 2;
+}
+
+// The `VerifyNotificationChannel` request.
+message VerifyNotificationChannelRequest {
+  // The notification channel to verify.
+  string name = 1;
+
+  // 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;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/notification_service_pb2.py
new file mode 100644
index 000000000000..e684d8d1ef42
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/notification_service_pb2.py
@@ -0,0 +1,1346 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/notification_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.monitoring_v3.proto import (
+    notification_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/notification_service.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\030NotificationServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n;google/cloud/monitoring_v3/proto/notification_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a\x33google/cloud/monitoring_v3/proto/notification.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"`\n)ListNotificationChannelDescriptorsRequest\x12\x0c\n\x04name\x18\x04 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x97\x01\n*ListNotificationChannelDescriptorsResponse\x12P\n\x13\x63hannel_descriptors\x18\x01 \x03(\x0b\x32\x33.google.monitoring.v3.NotificationChannelDescriptor\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"7\n\'GetNotificationChannelDescriptorRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"y\n CreateNotificationChannelRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12G\n\x14notification_channel\x18\x02 \x01(\x0b\x32).google.monitoring.v3.NotificationChannel"x\n\x1fListNotificationChannelsRequest\x12\x0c\n\x04name\x18\x05 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x06 \x01(\t\x12\x10\n\x08order_by\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x85\x01\n ListNotificationChannelsResponse\x12H\n\x15notification_channels\x18\x03 \x03(\x0b\x32).google.monitoring.v3.NotificationChannel\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"-\n\x1dGetNotificationChannelRequest\x12\x0c\n\x04name\x18\x03 \x01(\t"\x9c\x01\n UpdateNotificationChannelRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12G\n\x14notification_channel\x18\x03 \x01(\x0b\x32).google.monitoring.v3.NotificationChannel"?\n DeleteNotificationChannelRequest\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\r\n\x05\x66orce\x18\x05 \x01(\x08">\n.SendNotificationChannelVerificationCodeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"n\n-GetNotificationChannelVerificationCodeRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"o\n.GetNotificationChannelVerificationCodeResponse\x12\x0c\n\x04\x63ode\x18\x01 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp">\n VerifyNotificationChannelRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04\x63ode\x18\x02 \x01(\t2\xbb\x10\n\x1aNotificationChannelService\x12\xe5\x01\n"ListNotificationChannelDescriptors\x12?.google.monitoring.v3.ListNotificationChannelDescriptorsRequest\x1a@.google.monitoring.v3.ListNotificationChannelDescriptorsResponse"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v3/{name=projects/*}/notificationChannelDescriptors\x12\xd6\x01\n GetNotificationChannelDescriptor\x12=.google.monitoring.v3.GetNotificationChannelDescriptorRequest\x1a\x33.google.monitoring.v3.NotificationChannelDescriptor">\x82\xd3\xe4\x93\x02\x38\x12\x36/v3/{name=projects/*/notificationChannelDescriptors/*}\x12\xbd\x01\n\x18ListNotificationChannels\x12\x35.google.monitoring.v3.ListNotificationChannelsRequest\x1a\x36.google.monitoring.v3.ListNotificationChannelsResponse"2\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*}/notificationChannels\x12\xae\x01\n\x16GetNotificationChannel\x12\x33.google.monitoring.v3.GetNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"4\x82\xd3\xe4\x93\x02.\x12,/v3/{name=projects/*/notificationChannels/*}\x12\xc8\x01\n\x19\x43reateNotificationChannel\x12\x36.google.monitoring.v3.CreateNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"H\x82\xd3\xe4\x93\x02\x42"*/v3/{name=projects/*}/notificationChannels:\x14notification_channel\x12\xdf\x01\n\x19UpdateNotificationChannel\x12\x36.google.monitoring.v3.UpdateNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel"_\x82\xd3\xe4\x93\x02Y2A/v3/{notification_channel.name=projects/*/notificationChannels/*}:\x14notification_channel\x12\xa1\x01\n\x19\x44\x65leteNotificationChannel\x12\x36.google.monitoring.v3.DeleteNotificationChannelRequest\x1a\x16.google.protobuf.Empty"4\x82\xd3\xe4\x93\x02.*,/v3/{name=projects/*/notificationChannels/*}\x12\xd5\x01\n\'SendNotificationChannelVerificationCode\x12\x44.google.monitoring.v3.SendNotificationChannelVerificationCodeRequest\x1a\x16.google.protobuf.Empty"L\x82\xd3\xe4\x93\x02\x46"A/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode:\x01*\x12\x80\x02\n&GetNotificationChannelVerificationCode\x12\x43.google.monitoring.v3.GetNotificationChannelVerificationCodeRequest\x1a\x44.google.monitoring.v3.GetNotificationChannelVerificationCodeResponse"K\x82\xd3\xe4\x93\x02\x45"@/v3/{name=projects/*/notificationChannels/*}:getVerificationCode:\x01*\x12\xbe\x01\n\x19VerifyNotificationChannel\x12\x36.google.monitoring.v3.VerifyNotificationChannelRequest\x1a).google.monitoring.v3.NotificationChannel">\x82\xd3\xe4\x93\x02\x38"3/v3/{name=projects/*/notificationChannels/*}:verify:\x01*B\xb0\x01\n\x18\x63om.google.monitoring.v3B\x18NotificationServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTNOTIFICATIONCHANNELDESCRIPTORSREQUEST = _descriptor.Descriptor(
+    name="ListNotificationChannelDescriptorsRequest",
+    full_name="google.monitoring.v3.ListNotificationChannelDescriptorsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListNotificationChannelDescriptorsRequest.name",
+            index=0,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListNotificationChannelDescriptorsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListNotificationChannelDescriptorsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=294,
+    serialized_end=390,
+)
+
+
+_LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE = _descriptor.Descriptor(
+    name="ListNotificationChannelDescriptorsResponse",
+    full_name="google.monitoring.v3.ListNotificationChannelDescriptorsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="channel_descriptors",
+            full_name="google.monitoring.v3.ListNotificationChannelDescriptorsResponse.channel_descriptors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListNotificationChannelDescriptorsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=393,
+    serialized_end=544,
+)
+
+
+_GETNOTIFICATIONCHANNELDESCRIPTORREQUEST = _descriptor.Descriptor(
+    name="GetNotificationChannelDescriptorRequest",
+    full_name="google.monitoring.v3.GetNotificationChannelDescriptorRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetNotificationChannelDescriptorRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=546,
+    serialized_end=601,
+)
+
+
+_CREATENOTIFICATIONCHANNELREQUEST = _descriptor.Descriptor(
+    name="CreateNotificationChannelRequest",
+    full_name="google.monitoring.v3.CreateNotificationChannelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.CreateNotificationChannelRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notification_channel",
+            full_name="google.monitoring.v3.CreateNotificationChannelRequest.notification_channel",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=603,
+    serialized_end=724,
+)
+
+
+_LISTNOTIFICATIONCHANNELSREQUEST = _descriptor.Descriptor(
+    name="ListNotificationChannelsRequest",
+    full_name="google.monitoring.v3.ListNotificationChannelsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.ListNotificationChannelsRequest.name",
+            index=0,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.monitoring.v3.ListNotificationChannelsRequest.filter",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.monitoring.v3.ListNotificationChannelsRequest.order_by",
+            index=2,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListNotificationChannelsRequest.page_size",
+            index=3,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListNotificationChannelsRequest.page_token",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=726,
+    serialized_end=846,
+)
+
+
+_LISTNOTIFICATIONCHANNELSRESPONSE = _descriptor.Descriptor(
+    name="ListNotificationChannelsResponse",
+    full_name="google.monitoring.v3.ListNotificationChannelsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="notification_channels",
+            full_name="google.monitoring.v3.ListNotificationChannelsResponse.notification_channels",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListNotificationChannelsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=849,
+    serialized_end=982,
+)
+
+
+_GETNOTIFICATIONCHANNELREQUEST = _descriptor.Descriptor(
+    name="GetNotificationChannelRequest",
+    full_name="google.monitoring.v3.GetNotificationChannelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetNotificationChannelRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=984,
+    serialized_end=1029,
+)
+
+
+_UPDATENOTIFICATIONCHANNELREQUEST = _descriptor.Descriptor(
+    name="UpdateNotificationChannelRequest",
+    full_name="google.monitoring.v3.UpdateNotificationChannelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.monitoring.v3.UpdateNotificationChannelRequest.update_mask",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="notification_channel",
+            full_name="google.monitoring.v3.UpdateNotificationChannelRequest.notification_channel",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1032,
+    serialized_end=1188,
+)
+
+
+_DELETENOTIFICATIONCHANNELREQUEST = _descriptor.Descriptor(
+    name="DeleteNotificationChannelRequest",
+    full_name="google.monitoring.v3.DeleteNotificationChannelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.DeleteNotificationChannelRequest.name",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="force",
+            full_name="google.monitoring.v3.DeleteNotificationChannelRequest.force",
+            index=1,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1190,
+    serialized_end=1253,
+)
+
+
+_SENDNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST = _descriptor.Descriptor(
+    name="SendNotificationChannelVerificationCodeRequest",
+    full_name="google.monitoring.v3.SendNotificationChannelVerificationCodeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.SendNotificationChannelVerificationCodeRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1255,
+    serialized_end=1317,
+)
+
+
+_GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST = _descriptor.Descriptor(
+    name="GetNotificationChannelVerificationCodeRequest",
+    full_name="google.monitoring.v3.GetNotificationChannelVerificationCodeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetNotificationChannelVerificationCodeRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.monitoring.v3.GetNotificationChannelVerificationCodeRequest.expire_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1319,
+    serialized_end=1429,
+)
+
+
+_GETNOTIFICATIONCHANNELVERIFICATIONCODERESPONSE = _descriptor.Descriptor(
+    name="GetNotificationChannelVerificationCodeResponse",
+    full_name="google.monitoring.v3.GetNotificationChannelVerificationCodeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.monitoring.v3.GetNotificationChannelVerificationCodeResponse.code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.monitoring.v3.GetNotificationChannelVerificationCodeResponse.expire_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1431,
+    serialized_end=1542,
+)
+
+
+_VERIFYNOTIFICATIONCHANNELREQUEST = _descriptor.Descriptor(
+    name="VerifyNotificationChannelRequest",
+    full_name="google.monitoring.v3.VerifyNotificationChannelRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.VerifyNotificationChannelRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.monitoring.v3.VerifyNotificationChannelRequest.code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1544,
+    serialized_end=1606,
+)
+
+_LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE.fields_by_name[
+    "channel_descriptors"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNELDESCRIPTOR
+)
+_CREATENOTIFICATIONCHANNELREQUEST.fields_by_name[
+    "notification_channel"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL
+)
+_LISTNOTIFICATIONCHANNELSRESPONSE.fields_by_name[
+    "notification_channels"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL
+)
+_UPDATENOTIFICATIONCHANNELREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATENOTIFICATIONCHANNELREQUEST.fields_by_name[
+    "notification_channel"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL
+)
+_GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GETNOTIFICATIONCHANNELVERIFICATIONCODERESPONSE.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name[
+    "ListNotificationChannelDescriptorsRequest"
+] = _LISTNOTIFICATIONCHANNELDESCRIPTORSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListNotificationChannelDescriptorsResponse"
+] = _LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetNotificationChannelDescriptorRequest"
+] = _GETNOTIFICATIONCHANNELDESCRIPTORREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateNotificationChannelRequest"
+] = _CREATENOTIFICATIONCHANNELREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListNotificationChannelsRequest"
+] = _LISTNOTIFICATIONCHANNELSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListNotificationChannelsResponse"
+] = _LISTNOTIFICATIONCHANNELSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetNotificationChannelRequest"
+] = _GETNOTIFICATIONCHANNELREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateNotificationChannelRequest"
+] = _UPDATENOTIFICATIONCHANNELREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteNotificationChannelRequest"
+] = _DELETENOTIFICATIONCHANNELREQUEST
+DESCRIPTOR.message_types_by_name[
+    "SendNotificationChannelVerificationCodeRequest"
+] = _SENDNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetNotificationChannelVerificationCodeRequest"
+] = _GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetNotificationChannelVerificationCodeResponse"
+] = _GETNOTIFICATIONCHANNELVERIFICATIONCODERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "VerifyNotificationChannelRequest"
+] = _VERIFYNOTIFICATIONCHANNELREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListNotificationChannelDescriptorsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListNotificationChannelDescriptorsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTIFICATIONCHANNELDESCRIPTORSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``ListNotificationChannelDescriptors`` request.
+  
+  
+  Attributes:
+      name:
+          The REST resource name of the parent from which to retrieve
+          the notification channel descriptors. The expected syntax is:
+          ::      projects/[PROJECT_ID]  Note that this names the parent
+          container in which to look for the descriptors; to retrieve a
+          single descriptor by name, use the [GetNotificationChannelDesc
+          riptor][google.monitoring.v3.NotificationChannelService.GetNot
+          ificationChannelDescriptor] operation, instead.
+      page_size:
+          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 service.
+      page_token:
+          If non-empty, ``page_token`` must contain a value returned as
+          the ``next_page_token`` in a previous response to request the
+          next set of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListNotificationChannelDescriptorsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListNotificationChannelDescriptorsRequest)
+
+ListNotificationChannelDescriptorsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListNotificationChannelDescriptorsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``ListNotificationChannelDescriptors`` response.
+  
+  
+  Attributes:
+      channel_descriptors:
+          The monitored resource descriptors supported for the specified
+          project, optionally filtered.
+      next_page_token:
+          If not empty, indicates that there may be more results that
+          match the request. Use the value in the ``page_token`` field
+          in a subsequent request to fetch the next set of results. If
+          empty, all results have been returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListNotificationChannelDescriptorsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListNotificationChannelDescriptorsResponse)
+
+GetNotificationChannelDescriptorRequest = _reflection.GeneratedProtocolMessageType(
+    "GetNotificationChannelDescriptorRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNOTIFICATIONCHANNELDESCRIPTORREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``GetNotificationChannelDescriptor`` response.
+  
+  
+  Attributes:
+      name:
+          The channel type for which to execute the request. The format
+          is ``projects/[PROJECT_ID]/notificationChannelDescriptors/{cha
+          nnel_type}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetNotificationChannelDescriptorRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetNotificationChannelDescriptorRequest)
+
+CreateNotificationChannelRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateNotificationChannelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATENOTIFICATIONCHANNELREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``CreateNotificationChannel`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is:
+          ::      projects/[PROJECT_ID]  Note that 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.
+      notification_channel:
+          The definition of the ``NotificationChannel`` to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateNotificationChannelRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateNotificationChannelRequest)
+
+ListNotificationChannelsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListNotificationChannelsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTIFICATIONCHANNELSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``ListNotificationChannels`` request.
+  
+  
+  Attributes:
+      name:
+          The project on which to execute the request. The format is
+          ``projects/[PROJECT_ID]``. That is, 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.mon
+          itoring.v3.NotificationChannelService.GetNotificationChannel]
+          operation.
+      filter:
+          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>`__.
+      order_by:
+          A comma-separated list of fields by which to sort the result.
+          Supports the same set of fields as in ``filter``. Entries can
+          be prefixed with a minus sign to sort in descending rather
+          than ascending order.  For more details, see `sorting and
+          filtering </monitoring/api/v3/sorting-and-filtering>`__.
+      page_size:
+          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 service.
+      page_token:
+          If non-empty, ``page_token`` must contain a value returned as
+          the ``next_page_token`` in a previous response to request the
+          next set of results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListNotificationChannelsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListNotificationChannelsRequest)
+
+ListNotificationChannelsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListNotificationChannelsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTNOTIFICATIONCHANNELSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``ListNotificationChannels`` response.
+  
+  
+  Attributes:
+      notification_channels:
+          The notification channels defined for the specified project.
+      next_page_token:
+          If not empty, indicates that there may be more results that
+          match the request. Use the value in the ``page_token`` field
+          in a subsequent request to fetch the next set of results. If
+          empty, all results have been returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListNotificationChannelsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListNotificationChannelsResponse)
+
+GetNotificationChannelRequest = _reflection.GeneratedProtocolMessageType(
+    "GetNotificationChannelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNOTIFICATIONCHANNELREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``GetNotificationChannel`` request.
+  
+  
+  Attributes:
+      name:
+          The channel for which to execute the request. The format is
+          ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetNotificationChannelRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetNotificationChannelRequest)
+
+UpdateNotificationChannelRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateNotificationChannelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATENOTIFICATIONCHANNELREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``UpdateNotificationChannel`` request.
+  
+  
+  Attributes:
+      update_mask:
+          The fields to update.
+      notification_channel:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UpdateNotificationChannelRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateNotificationChannelRequest)
+
+DeleteNotificationChannelRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteNotificationChannelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETENOTIFICATIONCHANNELREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``DeleteNotificationChannel`` request.
+  
+  
+  Attributes:
+      name:
+          The channel for which to execute the request. The format is
+          ``projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]``.
+      force:
+          If true, the notification channel will be deleted regardless
+          of its use in alert policies (the policies will be updated to
+          remove the channel). If false, channels that are still
+          referenced by an existing alerting policy will fail to be
+          deleted in a delete operation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteNotificationChannelRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteNotificationChannelRequest)
+
+SendNotificationChannelVerificationCodeRequest = _reflection.GeneratedProtocolMessageType(
+    "SendNotificationChannelVerificationCodeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SENDNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``SendNotificationChannelVerificationCode`` request.
+  
+  
+  Attributes:
+      name:
+          The notification channel to which to send a verification code.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.SendNotificationChannelVerificationCodeRequest)
+    ),
+)
+_sym_db.RegisterMessage(SendNotificationChannelVerificationCodeRequest)
+
+GetNotificationChannelVerificationCodeRequest = _reflection.GeneratedProtocolMessageType(
+    "GetNotificationChannelVerificationCodeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``GetNotificationChannelVerificationCode`` request.
+  
+  
+  Attributes:
+      name:
+          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.
+      expire_time:
+          The desired expiration time. If specified, the API will
+          guarantee that the returned code will not be valid after the
+          specified timestamp; however, the API cannot guarantee that
+          the returned code will be valid for at least as long as the
+          requested time (the API puts an upper bound on the amount of
+          time for which a code may be valid). If omitted, a default
+          expiration will be used, which may be less than the max
+          permissible expiration (so specifying an expiration may extend
+          the code's lifetime over omitting an expiration, even though
+          the API does impose an upper limit on the maximum expiration
+          that is permitted).
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetNotificationChannelVerificationCodeRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetNotificationChannelVerificationCodeRequest)
+
+GetNotificationChannelVerificationCodeResponse = _reflection.GeneratedProtocolMessageType(
+    "GetNotificationChannelVerificationCodeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETNOTIFICATIONCHANNELVERIFICATIONCODERESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``GetNotificationChannelVerificationCode`` request.
+  
+  
+  Attributes:
+      code:
+          The verification code, which may be used to verify other
+          channels that have an equivalent identity (i.e. other channels
+          of the same type with the same fingerprint such as other email
+          channels with the same email address or other sms channels
+          with the same number).
+      expire_time:
+          The expiration time associated with the code that was
+          returned. If an expiration was provided in the request, this
+          is the minimum of the requested expiration in the request and
+          the max permitted expiration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetNotificationChannelVerificationCodeResponse)
+    ),
+)
+_sym_db.RegisterMessage(GetNotificationChannelVerificationCodeResponse)
+
+VerifyNotificationChannelRequest = _reflection.GeneratedProtocolMessageType(
+    "VerifyNotificationChannelRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERIFYNOTIFICATIONCHANNELREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.notification_service_pb2",
+        __doc__="""The ``VerifyNotificationChannel`` request.
+  
+  
+  Attributes:
+      name:
+          The notification channel to verify.
+      code:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.VerifyNotificationChannelRequest)
+    ),
+)
+_sym_db.RegisterMessage(VerifyNotificationChannelRequest)
+
+
+DESCRIPTOR._options = None
+
+_NOTIFICATIONCHANNELSERVICE = _descriptor.ServiceDescriptor(
+    name="NotificationChannelService",
+    full_name="google.monitoring.v3.NotificationChannelService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1609,
+    serialized_end=3716,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListNotificationChannelDescriptors",
+            full_name="google.monitoring.v3.NotificationChannelService.ListNotificationChannelDescriptors",
+            index=0,
+            containing_service=None,
+            input_type=_LISTNOTIFICATIONCHANNELDESCRIPTORSREQUEST,
+            output_type=_LISTNOTIFICATIONCHANNELDESCRIPTORSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0026\0224/v3/{name=projects/*}/notificationChannelDescriptors"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetNotificationChannelDescriptor",
+            full_name="google.monitoring.v3.NotificationChannelService.GetNotificationChannelDescriptor",
+            index=1,
+            containing_service=None,
+            input_type=_GETNOTIFICATIONCHANNELDESCRIPTORREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNELDESCRIPTOR,
+            serialized_options=_b(
+                "\202\323\344\223\0028\0226/v3/{name=projects/*/notificationChannelDescriptors/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListNotificationChannels",
+            full_name="google.monitoring.v3.NotificationChannelService.ListNotificationChannels",
+            index=2,
+            containing_service=None,
+            input_type=_LISTNOTIFICATIONCHANNELSREQUEST,
+            output_type=_LISTNOTIFICATIONCHANNELSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v3/{name=projects/*}/notificationChannels"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetNotificationChannel",
+            full_name="google.monitoring.v3.NotificationChannelService.GetNotificationChannel",
+            index=3,
+            containing_service=None,
+            input_type=_GETNOTIFICATIONCHANNELREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v3/{name=projects/*/notificationChannels/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateNotificationChannel",
+            full_name="google.monitoring.v3.NotificationChannelService.CreateNotificationChannel",
+            index=4,
+            containing_service=None,
+            input_type=_CREATENOTIFICATIONCHANNELREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL,
+            serialized_options=_b(
+                '\202\323\344\223\002B"*/v3/{name=projects/*}/notificationChannels:\024notification_channel'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateNotificationChannel",
+            full_name="google.monitoring.v3.NotificationChannelService.UpdateNotificationChannel",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATENOTIFICATIONCHANNELREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL,
+            serialized_options=_b(
+                "\202\323\344\223\002Y2A/v3/{notification_channel.name=projects/*/notificationChannels/*}:\024notification_channel"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteNotificationChannel",
+            full_name="google.monitoring.v3.NotificationChannelService.DeleteNotificationChannel",
+            index=6,
+            containing_service=None,
+            input_type=_DELETENOTIFICATIONCHANNELREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002.*,/v3/{name=projects/*/notificationChannels/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SendNotificationChannelVerificationCode",
+            full_name="google.monitoring.v3.NotificationChannelService.SendNotificationChannelVerificationCode",
+            index=7,
+            containing_service=None,
+            input_type=_SENDNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002F"A/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetNotificationChannelVerificationCode",
+            full_name="google.monitoring.v3.NotificationChannelService.GetNotificationChannelVerificationCode",
+            index=8,
+            containing_service=None,
+            input_type=_GETNOTIFICATIONCHANNELVERIFICATIONCODEREQUEST,
+            output_type=_GETNOTIFICATIONCHANNELVERIFICATIONCODERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v3/{name=projects/*/notificationChannels/*}:getVerificationCode:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="VerifyNotificationChannel",
+            full_name="google.monitoring.v3.NotificationChannelService.VerifyNotificationChannel",
+            index=9,
+            containing_service=None,
+            input_type=_VERIFYNOTIFICATIONCHANNELREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2._NOTIFICATIONCHANNEL,
+            serialized_options=_b(
+                '\202\323\344\223\0028"3/v3/{name=projects/*/notificationChannels/*}:verify:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_NOTIFICATIONCHANNELSERVICE)
+
+DESCRIPTOR.services_by_name["NotificationChannelService"] = _NOTIFICATIONCHANNELSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/notification_service_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/notification_service_pb2_grpc.py
new file mode 100644
index 000000000000..ba8b68d03c70
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/notification_service_pb2_grpc.py
@@ -0,0 +1,239 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.monitoring_v3.proto import (
+    notification_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    notification_service_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class NotificationChannelServiceStub(object):
+    """The Notification Channel API provides access to configuration that
+  controls how messages related to incidents are sent.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListNotificationChannelDescriptors = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/ListNotificationChannelDescriptors",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelDescriptorsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelDescriptorsResponse.FromString,
+        )
+        self.GetNotificationChannelDescriptor = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/GetNotificationChannelDescriptor",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelDescriptorRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannelDescriptor.FromString,
+        )
+        self.ListNotificationChannels = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/ListNotificationChannels",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelsResponse.FromString,
+        )
+        self.GetNotificationChannel = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/GetNotificationChannel",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.FromString,
+        )
+        self.CreateNotificationChannel = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/CreateNotificationChannel",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.CreateNotificationChannelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.FromString,
+        )
+        self.UpdateNotificationChannel = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/UpdateNotificationChannel",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.UpdateNotificationChannelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.FromString,
+        )
+        self.DeleteNotificationChannel = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/DeleteNotificationChannel",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.DeleteNotificationChannelRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.SendNotificationChannelVerificationCode = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/SendNotificationChannelVerificationCode",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.SendNotificationChannelVerificationCodeRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetNotificationChannelVerificationCode = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/GetNotificationChannelVerificationCode",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelVerificationCodeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelVerificationCodeResponse.FromString,
+        )
+        self.VerifyNotificationChannel = channel.unary_unary(
+            "/google.monitoring.v3.NotificationChannelService/VerifyNotificationChannel",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.VerifyNotificationChannelRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.FromString,
+        )
+
+
+class NotificationChannelServiceServicer(object):
+    """The Notification Channel API provides access to configuration that
+  controls how messages related to incidents are sent.
+  """
+
+    def ListNotificationChannelDescriptors(self, request, context):
+        """Lists the descriptors for supported channel types. The use of descriptors
+    makes it possible for new channel types to be dynamically added.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetNotificationChannelDescriptor(self, request, context):
+        """Gets a single channel descriptor. The descriptor indicates which fields
+    are expected / permitted for a notification channel of the given type.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListNotificationChannels(self, request, context):
+        """Lists the notification channels that have been created for the project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetNotificationChannel(self, request, context):
+        """Gets a single notification channel. The channel includes the relevant
+    configuration details with which the channel was created. However, the
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateNotificationChannel(self, request, context):
+        """Creates a new notification channel, representing a single notification
+    endpoint such as an email address, SMS number, or PagerDuty service.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateNotificationChannel(self, request, context):
+        """Updates a notification channel. Fields not specified in the field mask
+    remain unchanged.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteNotificationChannel(self, request, context):
+        """Deletes a notification channel.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SendNotificationChannelVerificationCode(self, request, context):
+        """Causes a verification code to be delivered to the channel. The code
+    can then be supplied in `VerifyNotificationChannel` to verify the channel.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetNotificationChannelVerificationCode(self, request, context):
+        """Requests a verification code for an already verified channel that can then
+    be used in a call to VerifyNotificationChannel() on a different channel
+    with an equivalent identity in the same or in a different project. This
+    makes it possible to copy a channel between projects without requiring
+    manual reverification of the channel. If the channel is not in the
+    verified state, this method will fail (in other words, this may only be
+    used if the SendNotificationChannelVerificationCode and
+    VerifyNotificationChannel paths have already been used to put the given
+    channel into the verified state).
+
+    There is no guarantee that the verification codes returned by this method
+    will be of a similar structure or form as the ones that are delivered
+    to the channel via SendNotificationChannelVerificationCode; while
+    VerifyNotificationChannel() will recognize both the codes delivered via
+    SendNotificationChannelVerificationCode() and returned from
+    GetNotificationChannelVerificationCode(), it is typically the case that
+    the verification codes delivered via
+    SendNotificationChannelVerificationCode() will be shorter and also
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def VerifyNotificationChannel(self, request, context):
+        """Verifies a `NotificationChannel` by proving receipt of the code
+    delivered to the channel as a result of calling
+    `SendNotificationChannelVerificationCode`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_NotificationChannelServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListNotificationChannelDescriptors": grpc.unary_unary_rpc_method_handler(
+            servicer.ListNotificationChannelDescriptors,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelDescriptorsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelDescriptorsResponse.SerializeToString,
+        ),
+        "GetNotificationChannelDescriptor": grpc.unary_unary_rpc_method_handler(
+            servicer.GetNotificationChannelDescriptor,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelDescriptorRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannelDescriptor.SerializeToString,
+        ),
+        "ListNotificationChannels": grpc.unary_unary_rpc_method_handler(
+            servicer.ListNotificationChannels,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.ListNotificationChannelsResponse.SerializeToString,
+        ),
+        "GetNotificationChannel": grpc.unary_unary_rpc_method_handler(
+            servicer.GetNotificationChannel,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.SerializeToString,
+        ),
+        "CreateNotificationChannel": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateNotificationChannel,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.CreateNotificationChannelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.SerializeToString,
+        ),
+        "UpdateNotificationChannel": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateNotificationChannel,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.UpdateNotificationChannelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.SerializeToString,
+        ),
+        "DeleteNotificationChannel": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteNotificationChannel,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.DeleteNotificationChannelRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "SendNotificationChannelVerificationCode": grpc.unary_unary_rpc_method_handler(
+            servicer.SendNotificationChannelVerificationCode,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.SendNotificationChannelVerificationCodeRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetNotificationChannelVerificationCode": grpc.unary_unary_rpc_method_handler(
+            servicer.GetNotificationChannelVerificationCode,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelVerificationCodeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.GetNotificationChannelVerificationCodeResponse.SerializeToString,
+        ),
+        "VerifyNotificationChannel": grpc.unary_unary_rpc_method_handler(
+            servicer.VerifyNotificationChannel,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__service__pb2.VerifyNotificationChannelRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_notification__pb2.NotificationChannel.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.monitoring.v3.NotificationChannelService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/monitoring/google/cloud/monitoring_v3/proto/span_context.proto b/monitoring/google/cloud/monitoring_v3/proto/span_context.proto
new file mode 100644
index 000000000000..f7977c288a1f
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/span_context.proto
@@ -0,0 +1,43 @@
+// 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.monitoring.v3;
+
+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 = "SpanContextProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// The context of a span, attached to google.api.Distribution.Exemplars
+// in google.api.Distribution values during aggregation.
+//
+// It contains the name of a span with format:
+//     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+message SpanContext {
+  // The resource name of the span in the following format:
+  //
+  //     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+  //
+  // [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
+  // is a 16-character hexadecimal encoding of an 8-byte array.
+  string span_name = 1;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py
new file mode 100644
index 000000000000..d0a53f5f4a59
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2.py
@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/span_context.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/span_context.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\020SpanContextProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/monitoring_v3/proto/span_context.proto\x12\x14google.monitoring.v3" \n\x0bSpanContext\x12\x11\n\tspan_name\x18\x01 \x01(\tB\xa8\x01\n\x18\x63om.google.monitoring.v3B\x10SpanContextProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+)
+
+
+_SPANCONTEXT = _descriptor.Descriptor(
+    name="SpanContext",
+    full_name="google.monitoring.v3.SpanContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="span_name",
+            full_name="google.monitoring.v3.SpanContext.span_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=77,
+    serialized_end=109,
+)
+
+DESCRIPTOR.message_types_by_name["SpanContext"] = _SPANCONTEXT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SpanContext = _reflection.GeneratedProtocolMessageType(
+    "SpanContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPANCONTEXT,
+        __module__="google.cloud.monitoring_v3.proto.span_context_pb2",
+        __doc__="""The context of a span, attached to google.api.Distribution.Exemplars in
+  google.api.Distribution values during aggregation.
+  
+  It contains the name of a span with format:
+  projects/[PROJECT\_ID]/traces/[TRACE\_ID]/spans/[SPAN\_ID]
+  
+  
+  Attributes:
+      span_name:
+          The resource name of the span in the following format:  ::
+          projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+          [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 is a 16-character hexadecimal encoding of
+          an 8-byte array.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.SpanContext)
+    ),
+)
+_sym_db.RegisterMessage(SpanContext)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/span_context_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime.proto b/monitoring/google/cloud/monitoring_v3/proto/uptime.proto
new file mode 100644
index 000000000000..2850301ac129
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/uptime.proto
@@ -0,0 +1,271 @@
+// 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.monitoring.v3;
+
+import "google/api/monitored_resource.proto";
+import "google/protobuf/duration.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 = "UptimeProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+
+// An internal checker allows uptime checks to run on private/internal GCP
+// resources.
+message InternalChecker {
+  // A unique resource name for this InternalChecker. The format is:
+  //
+  //
+  //   `projects/[PROJECT_ID]/internalCheckers/[INTERNAL_CHECKER_ID]`.
+  //
+  // PROJECT_ID 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
+  // should be unique within a Stackdriver Workspace in order to make it easier
+  // to identify; however, uniqueness is not enforced.
+  string display_name = 2;
+
+  // The [GCP VPC network](https://cloud.google.com/vpc/docs/vpc) where the
+  // 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.
+  string gcp_zone = 4;
+
+  // The GCP project_id where the internal checker lives. Not necessary
+  // the same as the workspace project.
+  string peer_project_id = 6;
+}
+
+// This message configures which resources and services to monitor for
+// availability.
+message UptimeCheckConfig {
+  // 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/<project_id>/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.
+  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.
+    message BasicAuthentication {
+      // The username to authenticate.
+      string username = 1;
+
+      // The password to authenticate.
+      string password = 2;
+    }
+
+    // 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 "/").
+    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).
+    int32 port = 3;
+
+    // The authentication information. Optional when creating an HTTP check;
+    // defaults to empty.
+    BasicAuthentication auth_info = 4;
+
+    // Boolean specifiying whether to encrypt the header information.
+    // 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 ******.
+    bool mask_headers = 5;
+
+    // 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
+    // https://www.w3.org/Protocols/rfc2616/rfc2616.txt (page 31).
+    // Entering two separate headers with the same key in a Create call will
+    // cause the first to be overwritten by the second.
+    // The maximum number of headers allowed is 100.
+    map<string, string> headers = 6;
+  }
+
+  // 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.
+    int32 port = 1;
+  }
+
+  // Used to perform string matching. It allows substring and regular
+  // expressions, together with their negations.
+  message ContentMatcher {
+    // String or regex content to match (max 1024 bytes)
+    string content = 1;
+  }
+
+  // A unique resource name for this UptimeCheckConfig. The format is:
+  //
+  //
+  //   `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`.
+  //
+  // 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
+  // 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;
+
+  // The resource the check is checking. Required.
+  oneof resource {
+    // 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
+    google.api.MonitoredResource monitored_resource = 3;
+
+    // The group resource associated with the configuration.
+    ResourceGroup resource_group = 4;
+  }
+
+  // The type of uptime check request.
+  oneof check_request_type {
+    // Contains information needed to make an HTTP or HTTPS check.
+    HttpCheck http_check = 5;
+
+    // Contains information needed to make a TCP check.
+    TcpCheck tcp_check = 6;
+  }
+
+  // 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`.
+  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.
+  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.
+  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;
+
+  // 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;
+}
+
+// Contains the region, location, and list of IP
+// addresses where checkers in the location run from.
+message UptimeCheckIp {
+  // A broad region category in which the IP address is located.
+  UptimeCheckRegion region = 1;
+
+  // A more specific location within the region that typically encodes
+  // a particular city/town/metro (and its containing state/province or country)
+  // 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
+  // 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.
+// The resource types `gae_app` and `uptime_url` are not valid here because
+// group checks on App Engine modules and URLs are not allowed.
+enum GroupResourceType {
+  // Default value (not valid).
+  RESOURCE_TYPE_UNSPECIFIED = 0;
+
+  // A group of instances from Google Cloud Platform (GCP) or
+  // Amazon Web Services (AWS).
+  INSTANCE = 1;
+
+  // A group of Amazon ELB load balancers.
+  AWS_ELB_LOAD_BALANCER = 2;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py
new file mode 100644
index 000000000000..e819f53f5ef5
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2.py
@@ -0,0 +1,1292 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/uptime.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import (
+    monitored_resource_pb2 as google_dot_api_dot_monitored__resource__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/uptime.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\013UptimeProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        "\n-google/cloud/monitoring_v3/proto/uptime.proto\x12\x14google.monitoring.v3\x1a#google/api/monitored_resource.proto\x1a\x1egoogle/protobuf/duration.proto\"q\n\x0fInternalChecker\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x0f\n\x07network\x18\x03 \x01(\t\x12\x10\n\x08gcp_zone\x18\x04 \x01(\t\x12\x17\n\x0fpeer_project_id\x18\x06 \x01(\t\"\xc1\t\n\x11UptimeCheckConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12;\n\x12monitored_resource\x18\x03 \x01(\x0b\x32\x1d.google.api.MonitoredResourceH\x00\x12O\n\x0eresource_group\x18\x04 \x01(\x0b\x32\x35.google.monitoring.v3.UptimeCheckConfig.ResourceGroupH\x00\x12G\n\nhttp_check\x18\x05 \x01(\x0b\x32\x31.google.monitoring.v3.UptimeCheckConfig.HttpCheckH\x01\x12\x45\n\ttcp_check\x18\x06 \x01(\x0b\x32\x30.google.monitoring.v3.UptimeCheckConfig.TcpCheckH\x01\x12)\n\x06period\x18\x07 \x01(\x0b\x32\x19.google.protobuf.Duration\x12*\n\x07timeout\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12P\n\x10\x63ontent_matchers\x18\t \x03(\x0b\x32\x36.google.monitoring.v3.UptimeCheckConfig.ContentMatcher\x12\x41\n\x10selected_regions\x18\n \x03(\x0e\x32'.google.monitoring.v3.UptimeCheckRegion\x12\x13\n\x0bis_internal\x18\x0f \x01(\x08\x12@\n\x11internal_checkers\x18\x0e \x03(\x0b\x32%.google.monitoring.v3.InternalChecker\x1a\x61\n\rResourceGroup\x12\x10\n\x08group_id\x18\x01 \x01(\t\x12>\n\rresource_type\x18\x02 \x01(\x0e\x32'.google.monitoring.v3.GroupResourceType\x1a\xe4\x02\n\tHttpCheck\x12\x0f\n\x07use_ssl\x18\x01 \x01(\x08\x12\x0c\n\x04path\x18\x02 \x01(\t\x12\x0c\n\x04port\x18\x03 \x01(\x05\x12X\n\tauth_info\x18\x04 \x01(\x0b\x32\x45.google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication\x12\x14\n\x0cmask_headers\x18\x05 \x01(\x08\x12O\n\x07headers\x18\x06 \x03(\x0b\x32>.google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry\x1a\x39\n\x13\x42\x61sicAuthentication\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x18\n\x08TcpCheck\x12\x0c\n\x04port\x18\x01 \x01(\x05\x1a!\n\x0e\x43ontentMatcher\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\tB\n\n\x08resourceB\x14\n\x12\x63heck_request_type\"n\n\rUptimeCheckIp\x12\x37\n\x06region\x18\x01 \x01(\x0e\x32'.google.monitoring.v3.UptimeCheckRegion\x12\x10\n\x08location\x18\x02 \x01(\t\x12\x12\n\nip_address\x18\x03 \x01(\t*e\n\x11UptimeCheckRegion\x12\x16\n\x12REGION_UNSPECIFIED\x10\x00\x12\x07\n\x03USA\x10\x01\x12\n\n\x06\x45UROPE\x10\x02\x12\x11\n\rSOUTH_AMERICA\x10\x03\x12\x10\n\x0c\x41SIA_PACIFIC\x10\x04*[\n\x11GroupResourceType\x12\x1d\n\x19RESOURCE_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08INSTANCE\x10\x01\x12\x19\n\x15\x41WS_ELB_LOAD_BALANCER\x10\x02\x42\xa3\x01\n\x18\x63om.google.monitoring.v3B\x0bUptimeProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3"
+    ),
+    dependencies=[
+        google_dot_api_dot_monitored__resource__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+    ],
+)
+
+_UPTIMECHECKREGION = _descriptor.EnumDescriptor(
+    name="UptimeCheckRegion",
+    full_name="google.monitoring.v3.UptimeCheckRegion",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="REGION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="USA", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EUROPE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SOUTH_AMERICA", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASIA_PACIFIC", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1587,
+    serialized_end=1688,
+)
+_sym_db.RegisterEnumDescriptor(_UPTIMECHECKREGION)
+
+UptimeCheckRegion = enum_type_wrapper.EnumTypeWrapper(_UPTIMECHECKREGION)
+_GROUPRESOURCETYPE = _descriptor.EnumDescriptor(
+    name="GroupResourceType",
+    full_name="google.monitoring.v3.GroupResourceType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RESOURCE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSTANCE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AWS_ELB_LOAD_BALANCER",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1690,
+    serialized_end=1781,
+)
+_sym_db.RegisterEnumDescriptor(_GROUPRESOURCETYPE)
+
+GroupResourceType = enum_type_wrapper.EnumTypeWrapper(_GROUPRESOURCETYPE)
+REGION_UNSPECIFIED = 0
+USA = 1
+EUROPE = 2
+SOUTH_AMERICA = 3
+ASIA_PACIFIC = 4
+RESOURCE_TYPE_UNSPECIFIED = 0
+INSTANCE = 1
+AWS_ELB_LOAD_BALANCER = 2
+
+
+_INTERNALCHECKER = _descriptor.Descriptor(
+    name="InternalChecker",
+    full_name="google.monitoring.v3.InternalChecker",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.InternalChecker.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.InternalChecker.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="network",
+            full_name="google.monitoring.v3.InternalChecker.network",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcp_zone",
+            full_name="google.monitoring.v3.InternalChecker.gcp_zone",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="peer_project_id",
+            full_name="google.monitoring.v3.InternalChecker.peer_project_id",
+            index=4,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=140,
+    serialized_end=253,
+)
+
+
+_UPTIMECHECKCONFIG_RESOURCEGROUP = _descriptor.Descriptor(
+    name="ResourceGroup",
+    full_name="google.monitoring.v3.UptimeCheckConfig.ResourceGroup",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group_id",
+            full_name="google.monitoring.v3.UptimeCheckConfig.ResourceGroup.group_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_type",
+            full_name="google.monitoring.v3.UptimeCheckConfig.ResourceGroup.resource_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=922,
+    serialized_end=1019,
+)
+
+_UPTIMECHECKCONFIG_HTTPCHECK_BASICAUTHENTICATION = _descriptor.Descriptor(
+    name="BasicAuthentication",
+    full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1273,
+    serialized_end=1330,
+)
+
+_UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1332,
+    serialized_end=1378,
+)
+
+_UPTIMECHECKCONFIG_HTTPCHECK = _descriptor.Descriptor(
+    name="HttpCheck",
+    full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="use_ssl",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.use_ssl",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="path",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.path",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="port",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.port",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="auth_info",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.auth_info",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mask_headers",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.mask_headers",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.monitoring.v3.UptimeCheckConfig.HttpCheck.headers",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _UPTIMECHECKCONFIG_HTTPCHECK_BASICAUTHENTICATION,
+        _UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1022,
+    serialized_end=1378,
+)
+
+_UPTIMECHECKCONFIG_TCPCHECK = _descriptor.Descriptor(
+    name="TcpCheck",
+    full_name="google.monitoring.v3.UptimeCheckConfig.TcpCheck",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="port",
+            full_name="google.monitoring.v3.UptimeCheckConfig.TcpCheck.port",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1380,
+    serialized_end=1404,
+)
+
+_UPTIMECHECKCONFIG_CONTENTMATCHER = _descriptor.Descriptor(
+    name="ContentMatcher",
+    full_name="google.monitoring.v3.UptimeCheckConfig.ContentMatcher",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.monitoring.v3.UptimeCheckConfig.ContentMatcher.content",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1406,
+    serialized_end=1439,
+)
+
+_UPTIMECHECKCONFIG = _descriptor.Descriptor(
+    name="UptimeCheckConfig",
+    full_name="google.monitoring.v3.UptimeCheckConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.UptimeCheckConfig.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.monitoring.v3.UptimeCheckConfig.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="monitored_resource",
+            full_name="google.monitoring.v3.UptimeCheckConfig.monitored_resource",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_group",
+            full_name="google.monitoring.v3.UptimeCheckConfig.resource_group",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_check",
+            full_name="google.monitoring.v3.UptimeCheckConfig.http_check",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tcp_check",
+            full_name="google.monitoring.v3.UptimeCheckConfig.tcp_check",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="period",
+            full_name="google.monitoring.v3.UptimeCheckConfig.period",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timeout",
+            full_name="google.monitoring.v3.UptimeCheckConfig.timeout",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content_matchers",
+            full_name="google.monitoring.v3.UptimeCheckConfig.content_matchers",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="selected_regions",
+            full_name="google.monitoring.v3.UptimeCheckConfig.selected_regions",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_internal",
+            full_name="google.monitoring.v3.UptimeCheckConfig.is_internal",
+            index=10,
+            number=15,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="internal_checkers",
+            full_name="google.monitoring.v3.UptimeCheckConfig.internal_checkers",
+            index=11,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _UPTIMECHECKCONFIG_RESOURCEGROUP,
+        _UPTIMECHECKCONFIG_HTTPCHECK,
+        _UPTIMECHECKCONFIG_TCPCHECK,
+        _UPTIMECHECKCONFIG_CONTENTMATCHER,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="resource",
+            full_name="google.monitoring.v3.UptimeCheckConfig.resource",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="check_request_type",
+            full_name="google.monitoring.v3.UptimeCheckConfig.check_request_type",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=256,
+    serialized_end=1473,
+)
+
+
+_UPTIMECHECKIP = _descriptor.Descriptor(
+    name="UptimeCheckIp",
+    full_name="google.monitoring.v3.UptimeCheckIp",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="region",
+            full_name="google.monitoring.v3.UptimeCheckIp.region",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location",
+            full_name="google.monitoring.v3.UptimeCheckIp.location",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ip_address",
+            full_name="google.monitoring.v3.UptimeCheckIp.ip_address",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1475,
+    serialized_end=1585,
+)
+
+_UPTIMECHECKCONFIG_RESOURCEGROUP.fields_by_name[
+    "resource_type"
+].enum_type = _GROUPRESOURCETYPE
+_UPTIMECHECKCONFIG_RESOURCEGROUP.containing_type = _UPTIMECHECKCONFIG
+_UPTIMECHECKCONFIG_HTTPCHECK_BASICAUTHENTICATION.containing_type = (
+    _UPTIMECHECKCONFIG_HTTPCHECK
+)
+_UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY.containing_type = _UPTIMECHECKCONFIG_HTTPCHECK
+_UPTIMECHECKCONFIG_HTTPCHECK.fields_by_name[
+    "auth_info"
+].message_type = _UPTIMECHECKCONFIG_HTTPCHECK_BASICAUTHENTICATION
+_UPTIMECHECKCONFIG_HTTPCHECK.fields_by_name[
+    "headers"
+].message_type = _UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY
+_UPTIMECHECKCONFIG_HTTPCHECK.containing_type = _UPTIMECHECKCONFIG
+_UPTIMECHECKCONFIG_TCPCHECK.containing_type = _UPTIMECHECKCONFIG
+_UPTIMECHECKCONFIG_CONTENTMATCHER.containing_type = _UPTIMECHECKCONFIG
+_UPTIMECHECKCONFIG.fields_by_name[
+    "monitored_resource"
+].message_type = google_dot_api_dot_monitored__resource__pb2._MONITOREDRESOURCE
+_UPTIMECHECKCONFIG.fields_by_name[
+    "resource_group"
+].message_type = _UPTIMECHECKCONFIG_RESOURCEGROUP
+_UPTIMECHECKCONFIG.fields_by_name[
+    "http_check"
+].message_type = _UPTIMECHECKCONFIG_HTTPCHECK
+_UPTIMECHECKCONFIG.fields_by_name[
+    "tcp_check"
+].message_type = _UPTIMECHECKCONFIG_TCPCHECK
+_UPTIMECHECKCONFIG.fields_by_name[
+    "period"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_UPTIMECHECKCONFIG.fields_by_name[
+    "timeout"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_UPTIMECHECKCONFIG.fields_by_name[
+    "content_matchers"
+].message_type = _UPTIMECHECKCONFIG_CONTENTMATCHER
+_UPTIMECHECKCONFIG.fields_by_name["selected_regions"].enum_type = _UPTIMECHECKREGION
+_UPTIMECHECKCONFIG.fields_by_name["internal_checkers"].message_type = _INTERNALCHECKER
+_UPTIMECHECKCONFIG.oneofs_by_name["resource"].fields.append(
+    _UPTIMECHECKCONFIG.fields_by_name["monitored_resource"]
+)
+_UPTIMECHECKCONFIG.fields_by_name[
+    "monitored_resource"
+].containing_oneof = _UPTIMECHECKCONFIG.oneofs_by_name["resource"]
+_UPTIMECHECKCONFIG.oneofs_by_name["resource"].fields.append(
+    _UPTIMECHECKCONFIG.fields_by_name["resource_group"]
+)
+_UPTIMECHECKCONFIG.fields_by_name[
+    "resource_group"
+].containing_oneof = _UPTIMECHECKCONFIG.oneofs_by_name["resource"]
+_UPTIMECHECKCONFIG.oneofs_by_name["check_request_type"].fields.append(
+    _UPTIMECHECKCONFIG.fields_by_name["http_check"]
+)
+_UPTIMECHECKCONFIG.fields_by_name[
+    "http_check"
+].containing_oneof = _UPTIMECHECKCONFIG.oneofs_by_name["check_request_type"]
+_UPTIMECHECKCONFIG.oneofs_by_name["check_request_type"].fields.append(
+    _UPTIMECHECKCONFIG.fields_by_name["tcp_check"]
+)
+_UPTIMECHECKCONFIG.fields_by_name[
+    "tcp_check"
+].containing_oneof = _UPTIMECHECKCONFIG.oneofs_by_name["check_request_type"]
+_UPTIMECHECKIP.fields_by_name["region"].enum_type = _UPTIMECHECKREGION
+DESCRIPTOR.message_types_by_name["InternalChecker"] = _INTERNALCHECKER
+DESCRIPTOR.message_types_by_name["UptimeCheckConfig"] = _UPTIMECHECKCONFIG
+DESCRIPTOR.message_types_by_name["UptimeCheckIp"] = _UPTIMECHECKIP
+DESCRIPTOR.enum_types_by_name["UptimeCheckRegion"] = _UPTIMECHECKREGION
+DESCRIPTOR.enum_types_by_name["GroupResourceType"] = _GROUPRESOURCETYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+InternalChecker = _reflection.GeneratedProtocolMessageType(
+    "InternalChecker",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INTERNALCHECKER,
+        __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+        __doc__="""An internal checker allows uptime checks to run on private/internal GCP
+  resources.
+  
+  
+  Attributes:
+      name:
+          A unique resource name for this InternalChecker. The format
+          is:  ``projects/[PROJECT_ID]/internalCheckers/[INTERNAL_CHECKE
+          R_ID]``.  PROJECT\_ID is the stackdriver workspace project for
+          the uptime check config associated with the internal checker.
+      display_name:
+          The checker's human-readable name. The display name should be
+          unique within a Stackdriver Workspace in order to make it
+          easier to identify; however, uniqueness is not enforced.
+      network:
+          The `GCP VPC network
+          <https://cloud.google.com/vpc/docs/vpc>`__ where the internal
+          resource lives (ex: "default").
+      gcp_zone:
+          The GCP zone the uptime check should egress from. Only
+          respected for internal uptime checks, where internal\_network
+          is specified.
+      peer_project_id:
+          The GCP project\_id where the internal checker lives. Not
+          necessary the same as the workspace project.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.InternalChecker)
+    ),
+)
+_sym_db.RegisterMessage(InternalChecker)
+
+UptimeCheckConfig = _reflection.GeneratedProtocolMessageType(
+    "UptimeCheckConfig",
+    (_message.Message,),
+    dict(
+        ResourceGroup=_reflection.GeneratedProtocolMessageType(
+            "ResourceGroup",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_UPTIMECHECKCONFIG_RESOURCEGROUP,
+                __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+                __doc__="""The resource submessage for group checks. It can be used instead of a
+    monitored resource, when multiple resources are being monitored.
+    
+    
+    Attributes:
+        group_id:
+            The group of resources being monitored. Should be only the
+            group\_id, not projects//groups/.
+        resource_type:
+            The resource type of the group members.
+    """,
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig.ResourceGroup)
+            ),
+        ),
+        HttpCheck=_reflection.GeneratedProtocolMessageType(
+            "HttpCheck",
+            (_message.Message,),
+            dict(
+                BasicAuthentication=_reflection.GeneratedProtocolMessageType(
+                    "BasicAuthentication",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_UPTIMECHECKCONFIG_HTTPCHECK_BASICAUTHENTICATION,
+                        __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+                        __doc__="""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.
+      
+      
+      Attributes:
+          username:
+              The username to authenticate.
+          password:
+              The password to authenticate.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig.HttpCheck.BasicAuthentication)
+                    ),
+                ),
+                HeadersEntry=_reflection.GeneratedProtocolMessageType(
+                    "HeadersEntry",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY,
+                        __module__="google.cloud.monitoring_v3.proto.uptime_pb2"
+                        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig.HttpCheck.HeadersEntry)
+                    ),
+                ),
+                DESCRIPTOR=_UPTIMECHECKCONFIG_HTTPCHECK,
+                __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+                __doc__="""Information involved in an HTTP/HTTPS uptime check request.
+    
+    
+    Attributes:
+        use_ssl:
+            If true, use HTTPS instead of HTTP to run the check.
+        path:
+            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 "/").
+        port:
+            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).
+        auth_info:
+            The authentication information. Optional when creating an HTTP
+            check; defaults to empty.
+        mask_headers:
+            Boolean specifiying whether to encrypt the header information.
+            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
+            \*\*\*\*\*\*.
+        headers:
+            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
+            https://www.w3.org/Protocols/rfc2616/rfc2616.txt (page 31).
+            Entering two separate headers with the same key in a Create
+            call will cause the first to be overwritten by the second. The
+            maximum number of headers allowed is 100.
+    """,
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig.HttpCheck)
+            ),
+        ),
+        TcpCheck=_reflection.GeneratedProtocolMessageType(
+            "TcpCheck",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_UPTIMECHECKCONFIG_TCPCHECK,
+                __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+                __doc__="""Information required for a TCP uptime check request.
+    
+    
+    Attributes:
+        port:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig.TcpCheck)
+            ),
+        ),
+        ContentMatcher=_reflection.GeneratedProtocolMessageType(
+            "ContentMatcher",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_UPTIMECHECKCONFIG_CONTENTMATCHER,
+                __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+                __doc__="""Used to perform string matching. It allows substring and regular
+    expressions, together with their negations.
+    
+    
+    Attributes:
+        content:
+            String or regex content to match (max 1024 bytes)
+    """,
+                # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig.ContentMatcher)
+            ),
+        ),
+        DESCRIPTOR=_UPTIMECHECKCONFIG,
+        __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+        __doc__="""This message configures which resources and services to monitor for
+  availability.
+  
+  
+  Attributes:
+      name:
+          A unique resource name for this UptimeCheckConfig. The format
+          is:  ``projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_
+          ID]``.  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.
+      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.
+      resource:
+          The resource the check is checking. Required.
+      monitored_resource:
+          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
+      resource_group:
+          The group resource associated with the configuration.
+      check_request_type:
+          The type of uptime check request.
+      http_check:
+          Contains information needed to make an HTTP or HTTPS check.
+      tcp_check:
+          Contains information needed to make a TCP check.
+      period:
+          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``.
+      timeout:
+          The maximum amount of time to wait for the request to complete
+          (must be between 1 and 60 seconds). Required.
+      content_matchers:
+          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.
+      selected_regions:
+          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.
+      is_internal:
+          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.
+      internal_checkers:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckConfig)
+    ),
+)
+_sym_db.RegisterMessage(UptimeCheckConfig)
+_sym_db.RegisterMessage(UptimeCheckConfig.ResourceGroup)
+_sym_db.RegisterMessage(UptimeCheckConfig.HttpCheck)
+_sym_db.RegisterMessage(UptimeCheckConfig.HttpCheck.BasicAuthentication)
+_sym_db.RegisterMessage(UptimeCheckConfig.HttpCheck.HeadersEntry)
+_sym_db.RegisterMessage(UptimeCheckConfig.TcpCheck)
+_sym_db.RegisterMessage(UptimeCheckConfig.ContentMatcher)
+
+UptimeCheckIp = _reflection.GeneratedProtocolMessageType(
+    "UptimeCheckIp",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPTIMECHECKIP,
+        __module__="google.cloud.monitoring_v3.proto.uptime_pb2",
+        __doc__="""Contains the region, location, and list of IP addresses where checkers
+  in the location run from.
+  
+  
+  Attributes:
+      region:
+          A broad region category in which the IP address is located.
+      location:
+          A more specific location within the region that typically
+          encodes a particular city/town/metro (and its containing
+          state/province or country) within the broader umbrella region
+          category.
+      ip_address:
+          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 interpreting this field
+          in either IPv4 or IPv6 format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UptimeCheckIp)
+    ),
+)
+_sym_db.RegisterMessage(UptimeCheckIp)
+
+
+DESCRIPTOR._options = None
+_UPTIMECHECKCONFIG_HTTPCHECK_HEADERSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto b/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto
new file mode 100644
index 000000000000..ed59114d0c28
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_service.proto
@@ -0,0 +1,208 @@
+// 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.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/monitoring/v3/uptime.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 = "UptimeServiceProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "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
+// 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]
+// (http://console.cloud.google.com), selecting the appropriate project,
+// 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.http) = {
+      get: "/v3/{parent=projects/*}/uptimeCheckConfigs"
+    };
+  }
+
+  // Gets a single uptime check configuration.
+  rpc GetUptimeCheckConfig(GetUptimeCheckConfigRequest)
+      returns (UptimeCheckConfig) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/uptimeCheckConfigs/*}"
+    };
+  }
+
+  // Creates a new uptime check configuration.
+  rpc CreateUptimeCheckConfig(CreateUptimeCheckConfigRequest)
+      returns (UptimeCheckConfig) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*}/uptimeCheckConfigs"
+      body: "uptime_check_config"
+    };
+  }
+
+  // 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"`.
+  // Returns the updated configuration.
+  rpc UpdateUptimeCheckConfig(UpdateUptimeCheckConfigRequest)
+      returns (UptimeCheckConfig) {
+    option (google.api.http) = {
+      patch: "/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}"
+      body: "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
+  // other dependent configs that would be rendered invalid by the deletion.
+  rpc DeleteUptimeCheckConfig(DeleteUptimeCheckConfigRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=projects/*/uptimeCheckConfigs/*}"
+    };
+  }
+
+  // Returns the list of IPs that checkers run from
+  rpc ListUptimeCheckIps(ListUptimeCheckIpsRequest)
+      returns (ListUptimeCheckIpsResponse) {
+    option (google.api.http) = {
+      get: "/v3/uptimeCheckIps"
+    };
+  }
+}
+
+// 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;
+
+  // 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
+  // page. If the page_size is <=0, the server will decide the number of results
+  // to be returned.
+  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 more results from the previous method call.
+  string page_token = 4;
+}
+
+// The protocol for the `ListUptimeCheckConfigs` response.
+message ListUptimeCheckConfigsResponse {
+  // The returned uptime check configurations.
+  repeated UptimeCheckConfig uptime_check_configs = 1;
+
+  // This field represents the pagination token to retrieve the next page of
+  // results. If the value is empty, it means no further results for the
+  // request. To retrieve the next page of results, the value of the
+  // next_page_token is passed to the subsequent List method call (in the
+  // request message's page_token field).
+  string next_page_token = 2;
+
+  // 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;
+}
+
+// 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;
+}
+
+// The protocol for the `UpdateUptimeCheckConfig` request.
+message UpdateUptimeCheckConfigRequest {
+  // 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
+  // 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;
+}
+
+// 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;
+}
+
+// The protocol for the `ListUptimeCheckIps` request.
+message ListUptimeCheckIpsRequest {
+  // 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
+  // page. If the page_size is <=0, the server will decide the number of results
+  // to be returned.
+  // NOTE: this field is not yet implemented
+  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 more results from the previous method call.
+  // NOTE: this field is not yet implemented
+  string page_token = 3;
+}
+
+// The protocol for the `ListUptimeCheckIps` response.
+message ListUptimeCheckIpsResponse {
+  // The returned list of IP addresses (including region and location) that the
+  // checkers run from.
+  repeated UptimeCheckIp uptime_check_ips = 1;
+
+  // This field represents the pagination token to retrieve the next page of
+  // results. If the value is empty, it means no further results for the
+  // request. To retrieve the next page of results, the value of the
+  // next_page_token is passed to the subsequent List method call (in the
+  // request message's page_token field).
+  // NOTE: this field is not yet implemented
+  string next_page_token = 2;
+}
diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py b/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py
new file mode 100644
index 000000000000..85b7e154346b
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2.py
@@ -0,0 +1,835 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/monitoring_v3/proto/uptime_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.monitoring_v3.proto import (
+    uptime_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/monitoring_v3/proto/uptime_service.proto",
+    package="google.monitoring.v3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\030com.google.monitoring.v3B\022UptimeServiceProtoP\001Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\252\002\032Google.Cloud.Monitoring.V3\312\002\032Google\\Cloud\\Monitoring\\V3"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/monitoring_v3/proto/uptime_service.proto\x12\x14google.monitoring.v3\x1a\x1cgoogle/api/annotations.proto\x1a-google/cloud/monitoring_v3/proto/uptime.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"V\n\x1dListUptimeCheckConfigsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"\x94\x01\n\x1eListUptimeCheckConfigsResponse\x12\x45\n\x14uptime_check_configs\x18\x01 \x03(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05"+\n\x1bGetUptimeCheckConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"v\n\x1e\x43reateUptimeCheckConfigRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x44\n\x13uptime_check_config\x18\x02 \x01(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig"\x97\x01\n\x1eUpdateUptimeCheckConfigRequest\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x44\n\x13uptime_check_config\x18\x03 \x01(\x0b\x32\'.google.monitoring.v3.UptimeCheckConfig".\n\x1e\x44\x65leteUptimeCheckConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"B\n\x19ListUptimeCheckIpsRequest\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"t\n\x1aListUptimeCheckIpsResponse\x12=\n\x10uptime_check_ips\x18\x01 \x03(\x0b\x32#.google.monitoring.v3.UptimeCheckIp\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t2\xc7\x08\n\x12UptimeCheckService\x12\xb7\x01\n\x16ListUptimeCheckConfigs\x12\x33.google.monitoring.v3.ListUptimeCheckConfigsRequest\x1a\x34.google.monitoring.v3.ListUptimeCheckConfigsResponse"2\x82\xd3\xe4\x93\x02,\x12*/v3/{parent=projects/*}/uptimeCheckConfigs\x12\xa6\x01\n\x14GetUptimeCheckConfig\x12\x31.google.monitoring.v3.GetUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"2\x82\xd3\xe4\x93\x02,\x12*/v3/{name=projects/*/uptimeCheckConfigs/*}\x12\xc1\x01\n\x17\x43reateUptimeCheckConfig\x12\x34.google.monitoring.v3.CreateUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"G\x82\xd3\xe4\x93\x02\x41"*/v3/{parent=projects/*}/uptimeCheckConfigs:\x13uptime_check_config\x12\xd5\x01\n\x17UpdateUptimeCheckConfig\x12\x34.google.monitoring.v3.UpdateUptimeCheckConfigRequest\x1a\'.google.monitoring.v3.UptimeCheckConfig"[\x82\xd3\xe4\x93\x02U2>/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}:\x13uptime_check_config\x12\x9b\x01\n\x17\x44\x65leteUptimeCheckConfig\x12\x34.google.monitoring.v3.DeleteUptimeCheckConfigRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,**/v3/{name=projects/*/uptimeCheckConfigs/*}\x12\x93\x01\n\x12ListUptimeCheckIps\x12/.google.monitoring.v3.ListUptimeCheckIpsRequest\x1a\x30.google.monitoring.v3.ListUptimeCheckIpsResponse"\x1a\x82\xd3\xe4\x93\x02\x14\x12\x12/v3/uptimeCheckIpsB\xaa\x01\n\x18\x63om.google.monitoring.v3B\x12UptimeServiceProtoP\x01Z>google.golang.org/genproto/googleapis/monitoring/v3;monitoring\xaa\x02\x1aGoogle.Cloud.Monitoring.V3\xca\x02\x1aGoogle\\Cloud\\Monitoring\\V3b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTUPTIMECHECKCONFIGSREQUEST = _descriptor.Descriptor(
+    name="ListUptimeCheckConfigsRequest",
+    full_name="google.monitoring.v3.ListUptimeCheckConfigsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.monitoring.v3.ListUptimeCheckConfigsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListUptimeCheckConfigsRequest.page_size",
+            index=1,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListUptimeCheckConfigsRequest.page_token",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=219,
+    serialized_end=305,
+)
+
+
+_LISTUPTIMECHECKCONFIGSRESPONSE = _descriptor.Descriptor(
+    name="ListUptimeCheckConfigsResponse",
+    full_name="google.monitoring.v3.ListUptimeCheckConfigsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uptime_check_configs",
+            full_name="google.monitoring.v3.ListUptimeCheckConfigsResponse.uptime_check_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListUptimeCheckConfigsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.monitoring.v3.ListUptimeCheckConfigsResponse.total_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=308,
+    serialized_end=456,
+)
+
+
+_GETUPTIMECHECKCONFIGREQUEST = _descriptor.Descriptor(
+    name="GetUptimeCheckConfigRequest",
+    full_name="google.monitoring.v3.GetUptimeCheckConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.GetUptimeCheckConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=458,
+    serialized_end=501,
+)
+
+
+_CREATEUPTIMECHECKCONFIGREQUEST = _descriptor.Descriptor(
+    name="CreateUptimeCheckConfigRequest",
+    full_name="google.monitoring.v3.CreateUptimeCheckConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.monitoring.v3.CreateUptimeCheckConfigRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uptime_check_config",
+            full_name="google.monitoring.v3.CreateUptimeCheckConfigRequest.uptime_check_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=503,
+    serialized_end=621,
+)
+
+
+_UPDATEUPTIMECHECKCONFIGREQUEST = _descriptor.Descriptor(
+    name="UpdateUptimeCheckConfigRequest",
+    full_name="google.monitoring.v3.UpdateUptimeCheckConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.monitoring.v3.UpdateUptimeCheckConfigRequest.update_mask",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uptime_check_config",
+            full_name="google.monitoring.v3.UpdateUptimeCheckConfigRequest.uptime_check_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=624,
+    serialized_end=775,
+)
+
+
+_DELETEUPTIMECHECKCONFIGREQUEST = _descriptor.Descriptor(
+    name="DeleteUptimeCheckConfigRequest",
+    full_name="google.monitoring.v3.DeleteUptimeCheckConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.monitoring.v3.DeleteUptimeCheckConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=777,
+    serialized_end=823,
+)
+
+
+_LISTUPTIMECHECKIPSREQUEST = _descriptor.Descriptor(
+    name="ListUptimeCheckIpsRequest",
+    full_name="google.monitoring.v3.ListUptimeCheckIpsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.monitoring.v3.ListUptimeCheckIpsRequest.page_size",
+            index=0,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.monitoring.v3.ListUptimeCheckIpsRequest.page_token",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=825,
+    serialized_end=891,
+)
+
+
+_LISTUPTIMECHECKIPSRESPONSE = _descriptor.Descriptor(
+    name="ListUptimeCheckIpsResponse",
+    full_name="google.monitoring.v3.ListUptimeCheckIpsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uptime_check_ips",
+            full_name="google.monitoring.v3.ListUptimeCheckIpsResponse.uptime_check_ips",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.monitoring.v3.ListUptimeCheckIpsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=893,
+    serialized_end=1009,
+)
+
+_LISTUPTIMECHECKCONFIGSRESPONSE.fields_by_name[
+    "uptime_check_configs"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG
+)
+_CREATEUPTIMECHECKCONFIGREQUEST.fields_by_name[
+    "uptime_check_config"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG
+)
+_UPDATEUPTIMECHECKCONFIGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEUPTIMECHECKCONFIGREQUEST.fields_by_name[
+    "uptime_check_config"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG
+)
+_LISTUPTIMECHECKIPSRESPONSE.fields_by_name[
+    "uptime_check_ips"
+].message_type = (
+    google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKIP
+)
+DESCRIPTOR.message_types_by_name[
+    "ListUptimeCheckConfigsRequest"
+] = _LISTUPTIMECHECKCONFIGSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListUptimeCheckConfigsResponse"
+] = _LISTUPTIMECHECKCONFIGSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetUptimeCheckConfigRequest"
+] = _GETUPTIMECHECKCONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateUptimeCheckConfigRequest"
+] = _CREATEUPTIMECHECKCONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateUptimeCheckConfigRequest"
+] = _UPDATEUPTIMECHECKCONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteUptimeCheckConfigRequest"
+] = _DELETEUPTIMECHECKCONFIGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListUptimeCheckIpsRequest"
+] = _LISTUPTIMECHECKIPSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListUptimeCheckIpsResponse"
+] = _LISTUPTIMECHECKIPSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListUptimeCheckConfigsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListUptimeCheckConfigsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTUPTIMECHECKCONFIGSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``ListUptimeCheckConfigs`` request.
+  
+  
+  Attributes:
+      parent:
+          The project whose uptime check configurations are listed. The
+          format is ``projects/[PROJECT_ID]``.
+      page_size:
+          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 page. If the page\_size is <=0, the
+          server will decide the number of results to be returned.
+      page_token:
+          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 more
+          results from the previous method call.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListUptimeCheckConfigsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListUptimeCheckConfigsRequest)
+
+ListUptimeCheckConfigsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListUptimeCheckConfigsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTUPTIMECHECKCONFIGSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``ListUptimeCheckConfigs`` response.
+  
+  
+  Attributes:
+      uptime_check_configs:
+          The returned uptime check configurations.
+      next_page_token:
+          This field represents the pagination token to retrieve the
+          next page of results. If the value is empty, it means no
+          further results for the request. To retrieve the next page of
+          results, the value of the next\_page\_token is passed to the
+          subsequent List method call (in the request message's
+          page\_token field).
+      total_size:
+          The total number of uptime check configurations for the
+          project, irrespective of any pagination.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListUptimeCheckConfigsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListUptimeCheckConfigsResponse)
+
+GetUptimeCheckConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetUptimeCheckConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETUPTIMECHECKCONFIGREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``GetUptimeCheckConfig`` request.
+  
+  
+  Attributes:
+      name:
+          The uptime check configuration to retrieve. The format is ``pr
+          ojects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.GetUptimeCheckConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetUptimeCheckConfigRequest)
+
+CreateUptimeCheckConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateUptimeCheckConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEUPTIMECHECKCONFIGREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``CreateUptimeCheckConfig`` request.
+  
+  
+  Attributes:
+      parent:
+          The project in which to create the uptime check. The format is
+          ``projects/[PROJECT_ID]``.
+      uptime_check_config:
+          The new uptime check configuration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.CreateUptimeCheckConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateUptimeCheckConfigRequest)
+
+UpdateUptimeCheckConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateUptimeCheckConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEUPTIMECHECKCONFIGREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``UpdateUptimeCheckConfig`` request.
+  
+  
+  Attributes:
+      update_mask:
+          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.
+      uptime_check_config:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.UpdateUptimeCheckConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateUptimeCheckConfigRequest)
+
+DeleteUptimeCheckConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteUptimeCheckConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEUPTIMECHECKCONFIGREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``DeleteUptimeCheckConfig`` request.
+  
+  
+  Attributes:
+      name:
+          The uptime check configuration to delete. The format is ``proj
+          ects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.DeleteUptimeCheckConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteUptimeCheckConfigRequest)
+
+ListUptimeCheckIpsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListUptimeCheckIpsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTUPTIMECHECKIPSREQUEST,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``ListUptimeCheckIps`` request.
+  
+  
+  Attributes:
+      page_size:
+          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 page. If the page\_size is <=0, the
+          server will decide the number of results to be returned. NOTE:
+          this field is not yet implemented
+      page_token:
+          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 more
+          results from the previous method call. NOTE: this field is not
+          yet implemented
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListUptimeCheckIpsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListUptimeCheckIpsRequest)
+
+ListUptimeCheckIpsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListUptimeCheckIpsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTUPTIMECHECKIPSRESPONSE,
+        __module__="google.cloud.monitoring_v3.proto.uptime_service_pb2",
+        __doc__="""The protocol for the ``ListUptimeCheckIps`` response.
+  
+  
+  Attributes:
+      uptime_check_ips:
+          The returned list of IP addresses (including region and
+          location) that the checkers run from.
+      next_page_token:
+          This field represents the pagination token to retrieve the
+          next page of results. If the value is empty, it means no
+          further results for the request. To retrieve the next page of
+          results, the value of the next\_page\_token is passed to the
+          subsequent List method call (in the request message's
+          page\_token field). NOTE: this field is not yet implemented
+  """,
+        # @@protoc_insertion_point(class_scope:google.monitoring.v3.ListUptimeCheckIpsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListUptimeCheckIpsResponse)
+
+
+DESCRIPTOR._options = None
+
+_UPTIMECHECKSERVICE = _descriptor.ServiceDescriptor(
+    name="UptimeCheckService",
+    full_name="google.monitoring.v3.UptimeCheckService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1012,
+    serialized_end=2107,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListUptimeCheckConfigs",
+            full_name="google.monitoring.v3.UptimeCheckService.ListUptimeCheckConfigs",
+            index=0,
+            containing_service=None,
+            input_type=_LISTUPTIMECHECKCONFIGSREQUEST,
+            output_type=_LISTUPTIMECHECKCONFIGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v3/{parent=projects/*}/uptimeCheckConfigs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetUptimeCheckConfig",
+            full_name="google.monitoring.v3.UptimeCheckService.GetUptimeCheckConfig",
+            index=1,
+            containing_service=None,
+            input_type=_GETUPTIMECHECKCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v3/{name=projects/*/uptimeCheckConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateUptimeCheckConfig",
+            full_name="google.monitoring.v3.UptimeCheckService.CreateUptimeCheckConfig",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEUPTIMECHECKCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG,
+            serialized_options=_b(
+                '\202\323\344\223\002A"*/v3/{parent=projects/*}/uptimeCheckConfigs:\023uptime_check_config'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateUptimeCheckConfig",
+            full_name="google.monitoring.v3.UptimeCheckService.UpdateUptimeCheckConfig",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEUPTIMECHECKCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2._UPTIMECHECKCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002U2>/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}:\023uptime_check_config"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteUptimeCheckConfig",
+            full_name="google.monitoring.v3.UptimeCheckService.DeleteUptimeCheckConfig",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEUPTIMECHECKCONFIGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002,**/v3/{name=projects/*/uptimeCheckConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListUptimeCheckIps",
+            full_name="google.monitoring.v3.UptimeCheckService.ListUptimeCheckIps",
+            index=5,
+            containing_service=None,
+            input_type=_LISTUPTIMECHECKIPSREQUEST,
+            output_type=_LISTUPTIMECHECKIPSRESPONSE,
+            serialized_options=_b("\202\323\344\223\002\024\022\022/v3/uptimeCheckIps"),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_UPTIMECHECKSERVICE)
+
+DESCRIPTOR.services_by_name["UptimeCheckService"] = _UPTIMECHECKSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2_grpc.py b/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2_grpc.py
new file mode 100644
index 000000000000..ed2e70ed8fd1
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/proto/uptime_service_pb2_grpc.py
@@ -0,0 +1,158 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.monitoring_v3.proto import (
+    uptime_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2,
+)
+from google.cloud.monitoring_v3.proto import (
+    uptime_service_pb2 as google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class UptimeCheckServiceStub(object):
+    """The UptimeCheckService API is used to manage (list, create, delete, edit)
+  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]
+  (http://console.cloud.google.com), selecting the appropriate project,
+  clicking on "Monitoring" on the left-hand side to navigate to Stackdriver,
+  and then clicking on "Uptime".
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListUptimeCheckConfigs = channel.unary_unary(
+            "/google.monitoring.v3.UptimeCheckService/ListUptimeCheckConfigs",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckConfigsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckConfigsResponse.FromString,
+        )
+        self.GetUptimeCheckConfig = channel.unary_unary(
+            "/google.monitoring.v3.UptimeCheckService/GetUptimeCheckConfig",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.GetUptimeCheckConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.UptimeCheckConfig.FromString,
+        )
+        self.CreateUptimeCheckConfig = channel.unary_unary(
+            "/google.monitoring.v3.UptimeCheckService/CreateUptimeCheckConfig",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.CreateUptimeCheckConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.UptimeCheckConfig.FromString,
+        )
+        self.UpdateUptimeCheckConfig = channel.unary_unary(
+            "/google.monitoring.v3.UptimeCheckService/UpdateUptimeCheckConfig",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.UpdateUptimeCheckConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.UptimeCheckConfig.FromString,
+        )
+        self.DeleteUptimeCheckConfig = channel.unary_unary(
+            "/google.monitoring.v3.UptimeCheckService/DeleteUptimeCheckConfig",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.DeleteUptimeCheckConfigRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListUptimeCheckIps = channel.unary_unary(
+            "/google.monitoring.v3.UptimeCheckService/ListUptimeCheckIps",
+            request_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckIpsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckIpsResponse.FromString,
+        )
+
+
+class UptimeCheckServiceServicer(object):
+    """The UptimeCheckService API is used to manage (list, create, delete, edit)
+  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]
+  (http://console.cloud.google.com), selecting the appropriate project,
+  clicking on "Monitoring" on the left-hand side to navigate to Stackdriver,
+  and then clicking on "Uptime".
+  """
+
+    def ListUptimeCheckConfigs(self, request, context):
+        """Lists the existing valid uptime check configurations for the project,
+    leaving out any invalid configurations.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetUptimeCheckConfig(self, request, context):
+        """Gets a single uptime check configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateUptimeCheckConfig(self, request, context):
+        """Creates a new uptime check configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateUptimeCheckConfig(self, request, context):
+        """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"`.
+    Returns the updated configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteUptimeCheckConfig(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListUptimeCheckIps(self, request, context):
+        """Returns the list of IPs that checkers run from
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_UptimeCheckServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListUptimeCheckConfigs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListUptimeCheckConfigs,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckConfigsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckConfigsResponse.SerializeToString,
+        ),
+        "GetUptimeCheckConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetUptimeCheckConfig,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.GetUptimeCheckConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.UptimeCheckConfig.SerializeToString,
+        ),
+        "CreateUptimeCheckConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateUptimeCheckConfig,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.CreateUptimeCheckConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.UptimeCheckConfig.SerializeToString,
+        ),
+        "UpdateUptimeCheckConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateUptimeCheckConfig,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.UpdateUptimeCheckConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__pb2.UptimeCheckConfig.SerializeToString,
+        ),
+        "DeleteUptimeCheckConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteUptimeCheckConfig,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.DeleteUptimeCheckConfigRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListUptimeCheckIps": grpc.unary_unary_rpc_method_handler(
+            servicer.ListUptimeCheckIps,
+            request_deserializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckIpsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_monitoring__v3_dot_proto_dot_uptime__service__pb2.ListUptimeCheckIpsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.monitoring.v3.UptimeCheckService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/monitoring/google/cloud/monitoring_v3/query.py b/monitoring/google/cloud/monitoring_v3/query.py
new file mode 100644
index 000000000000..18ea0573515d
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/query.py
@@ -0,0 +1,625 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Time series query for the `Google Stackdriver Monitoring API (V3)`_.
+
+.. _Google Stackdriver Monitoring API (V3):
+    https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
+    projects.timeSeries/list
+"""
+
+import copy
+import datetime
+
+import six
+
+from google.cloud.monitoring_v3 import _dataframe
+from google.cloud.monitoring_v3 import types
+from google.cloud.monitoring_v3.gapic import enums
+
+_UTCNOW = datetime.datetime.utcnow  # To be replaced by tests.
+
+
+class Query(object):
+    """Query object for retrieving metric data.
+
+    :type client: :class:`google.cloud.monitoring_v3.gapic.
+        metric_service_client.MetricServiceClient`
+    :param client: The client to use.
+
+    :type project: str
+    :param project: The project ID or number.
+
+    :type metric_type: str
+    :param metric_type: The metric type name. The default value is
+        :data:`Query.DEFAULT_METRIC_TYPE
+        <google.cloud.monitoring.query.Query.DEFAULT_METRIC_TYPE>`,
+        but please note that this default value is provided only for
+        demonstration purposes and is subject to change. See the
+        `supported metrics`_.
+
+    :type end_time: :class:`datetime.datetime`
+    :param end_time: (Optional) The end time (inclusive) of the time interval
+        for which results should be returned, as a datetime object.
+        The default is the start of the current minute.
+
+        The start time (exclusive) is determined by combining the
+        values of  ``days``, ``hours``, and ``minutes``, and
+        subtracting the resulting duration from the end time.
+
+        It is also allowed to omit the end time and duration here,
+        in which case
+        :meth:`~google.cloud.monitoring.query.Query.select_interval`
+        must be called before the query is executed.
+
+    :type days: int
+    :param days: The number of days in the time interval.
+
+    :type hours: int
+    :param hours: The number of hours in the time interval.
+
+    :type minutes: int
+    :param minutes: The number of minutes in the time interval.
+
+    :raises: :exc:`ValueError` if ``end_time`` is specified but
+        ``days``, ``hours``, and ``minutes`` are all zero.
+        If you really want to specify a point in time, use
+        :meth:`~google.cloud.monitoring.query.Query.select_interval`.
+
+    .. _supported metrics: https://cloud.google.com/monitoring/api/metrics
+    """
+
+    DEFAULT_METRIC_TYPE = "compute.googleapis.com/instance/cpu/utilization"
+
+    def __init__(
+        self,
+        client,
+        project,
+        metric_type=DEFAULT_METRIC_TYPE,
+        end_time=None,
+        days=0,
+        hours=0,
+        minutes=0,
+    ):
+        start_time = None
+        if days or hours or minutes:
+            if end_time is None:
+                end_time = _UTCNOW().replace(second=0, microsecond=0)
+            start_time = end_time - datetime.timedelta(
+                days=days, hours=hours, minutes=minutes
+            )
+        elif end_time is not None:
+            raise ValueError("Non-zero duration required for time interval.")
+
+        self._client = client
+        self._project_path = self._client.project_path(project)
+        self._end_time = end_time
+        self._start_time = start_time
+        self._filter = _Filter(metric_type)
+
+        self._per_series_aligner = 0
+        self._alignment_period_seconds = 0
+        self._cross_series_reducer = 0
+        self._group_by_fields = ()
+
+    def __iter__(self):
+        return self.iter()
+
+    @property
+    def metric_type(self):
+        """The metric type name."""
+        return self._filter.metric_type
+
+    @property
+    def filter(self):
+        """The filter string.
+
+        This is constructed from the metric type, the resource type, and
+        selectors for the group ID, monitored projects, resource labels,
+        and metric labels.
+        """
+        return str(self._filter)
+
+    def select_interval(self, end_time, start_time=None):
+        """Copy the query and set the query time interval.
+
+        Example::
+
+            import datetime
+
+            now = datetime.datetime.utcnow()
+            query = query.select_interval(
+                end_time=now,
+                start_time=now - datetime.timedelta(minutes=5))
+
+        As a convenience, you can alternatively specify the end time and
+        an interval duration when you create the query initially.
+
+        :type end_time: :class:`datetime.datetime`
+        :param end_time: The end time (inclusive) of the time interval
+            for which results should be returned, as a datetime object.
+
+        :type start_time: :class:`datetime.datetime`
+        :param start_time:
+            (Optional) The start time (exclusive) of the time interval
+            for which results should be returned, as a datetime object.
+            If not specified, the interval is a point in time.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+        """
+        new_query = copy.deepcopy(self)
+        new_query._end_time = end_time
+        new_query._start_time = start_time
+        return new_query
+
+    def select_group(self, group_id):
+        """Copy the query and add filtering by group.
+
+        Example::
+
+            query = query.select_group('1234567')
+
+        :type group_id: str
+        :param group_id: The ID of a group to filter by.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+        """
+        new_query = copy.deepcopy(self)
+        new_query._filter.group_id = group_id
+        return new_query
+
+    def select_projects(self, *args):
+        """Copy the query and add filtering by monitored projects.
+
+        This is only useful if the target project represents a Stackdriver
+        account containing the specified monitored projects.
+
+        Examples::
+
+            query = query.select_projects('project-1')
+            query = query.select_projects('project-1', 'project-2')
+
+        :type args: tuple
+        :param args: Project IDs limiting the resources to be included
+            in the query.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+        """
+        new_query = copy.deepcopy(self)
+        new_query._filter.projects = args
+        return new_query
+
+    def select_resources(self, *args, **kwargs):
+        """Copy the query and add filtering by resource labels.
+
+        Examples::
+
+            query = query.select_resources(zone='us-central1-a')
+            query = query.select_resources(zone_prefix='europe-')
+            query = query.select_resources(resource_type='gce_instance')
+
+        A keyword argument ``<label>=<value>`` ordinarily generates a filter
+        expression of the form::
+
+            resource.label.<label> = "<value>"
+
+        However, by adding ``"_prefix"`` or ``"_suffix"`` to the keyword,
+        you can specify a partial match.
+
+        ``<label>_prefix=<value>`` generates::
+
+            resource.label.<label> = starts_with("<value>")
+
+        ``<label>_suffix=<value>`` generates::
+
+            resource.label.<label> = ends_with("<value>")
+
+        As a special case, ``"resource_type"`` is treated as a special
+        pseudo-label corresponding to the filter object ``resource.type``.
+        For example, ``resource_type=<value>`` generates::
+
+            resource.type = "<value>"
+
+        See the `defined resource types`_.
+
+        .. note::
+
+            The label ``"instance_name"`` is a metric label,
+            not a resource label. You would filter on it using
+            ``select_metrics(instance_name=...)``.
+
+        :type args: tuple
+        :param args: Raw filter expression strings to include in the
+            conjunction. If just one is provided and no keyword arguments
+            are provided, it can be a disjunction.
+
+        :param kwargs: Label filters to include in the conjunction as
+            described above.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+
+        .. _defined resource types:
+            https://cloud.google.com/monitoring/api/v3/monitored-resources
+        """
+        new_query = copy.deepcopy(self)
+        new_query._filter.select_resources(*args, **kwargs)
+        return new_query
+
+    def select_metrics(self, *args, **kwargs):
+        """Copy the query and add filtering by metric labels.
+
+        Examples::
+
+            query = query.select_metrics(instance_name='myinstance')
+            query = query.select_metrics(instance_name_prefix='mycluster-')
+
+        A keyword argument ``<label>=<value>`` ordinarily generates a filter
+        expression of the form::
+
+            metric.label.<label> = "<value>"
+
+        However, by adding ``"_prefix"`` or ``"_suffix"`` to the keyword,
+        you can specify a partial match.
+
+        ``<label>_prefix=<value>`` generates::
+
+            metric.label.<label> = starts_with("<value>")
+
+        ``<label>_suffix=<value>`` generates::
+
+            metric.label.<label> = ends_with("<value>")
+
+        If the label's value type is ``INT64``, a similar notation can be
+        used to express inequalities:
+
+        ``<label>_less=<value>`` generates::
+
+            metric.label.<label> < <value>
+
+        ``<label>_lessequal=<value>`` generates::
+
+            metric.label.<label> <= <value>
+
+        ``<label>_greater=<value>`` generates::
+
+            metric.label.<label> > <value>
+
+        ``<label>_greaterequal=<value>`` generates::
+
+            metric.label.<label> >= <value>
+
+        :type args: tuple
+        :param args: Raw filter expression strings to include in the
+            conjunction. If just one is provided and no keyword arguments
+            are provided, it can be a disjunction.
+
+        :param kwargs: Label filters to include in the conjunction as
+            described above.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+        """
+        new_query = copy.deepcopy(self)
+        new_query._filter.select_metrics(*args, **kwargs)
+        return new_query
+
+    def align(self, per_series_aligner, seconds=0, minutes=0, hours=0):
+        """Copy the query and add temporal alignment.
+
+        If ``per_series_aligner`` is not :data:`Aligner.ALIGN_NONE`, each time
+        series will contain data points only on the period boundaries.
+
+        Example::
+
+            from google.cloud.monitoring import enums
+            query = query.align(
+                enums.Aggregation.Aligner.ALIGN_MEAN, minutes=5)
+
+        It is also possible to specify the aligner as a literal string::
+
+            query = query.align('ALIGN_MEAN', minutes=5)
+
+        :type per_series_aligner: str or
+            :class:`~google.cloud.monitoring_v3.gapic.enums.Aggregation.Aligner`
+        :param per_series_aligner: The approach to be used to align
+            individual time series. For example: :data:`Aligner.ALIGN_MEAN`.
+            See
+            :class:`~google.cloud.monitoring_v3.gapic.enums.Aggregation.Aligner`
+            and the descriptions of the `supported aligners`_.
+
+        :type seconds: int
+        :param seconds: The number of seconds in the alignment period.
+
+        :type minutes: int
+        :param minutes: The number of minutes in the alignment period.
+
+        :type hours: int
+        :param hours: The number of hours in the alignment period.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+
+        .. _supported aligners:
+            https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
+            projects.timeSeries/list#Aligner
+        """
+        new_query = copy.deepcopy(self)
+        new_query._per_series_aligner = per_series_aligner
+        new_query._alignment_period_seconds = seconds + 60 * (minutes + 60 * hours)
+        return new_query
+
+    def reduce(self, cross_series_reducer, *group_by_fields):
+        """Copy the query and add cross-series reduction.
+
+        Cross-series reduction combines time series by aggregating their
+        data points.
+
+        For example, you could request an aggregated time series for each
+        combination of project and zone as follows::
+
+            from google.cloud.monitoring import enums
+            query = query.reduce(enums.Aggregation.Reducer.REDUCE_MEAN,
+                                 'resource.project_id', 'resource.zone')
+
+        :type cross_series_reducer: str or
+            :class:`~google.cloud.monitoring_v3.gapic.enums.Aggregation.Reducer`
+        :param cross_series_reducer:
+            The approach to be used to combine time series. For example:
+            :data:`Reducer.REDUCE_MEAN`. See
+            :class:`~google.cloud.monitoring_v3.gapic.enums.Aggregation.Reducer`
+            and the descriptions of the `supported reducers`_.
+
+        :type group_by_fields: strs
+        :param group_by_fields:
+            Fields to be preserved by the reduction. For example, specifying
+            just ``"resource.zone"`` will result in one time series per zone.
+            The default is to aggregate all of the time series into just one.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+
+        .. _supported reducers:
+            https://cloud.google.com/monitoring/api/ref_v3/rest/v3/\
+            projects.timeSeries/list#Reducer
+        """
+        new_query = copy.deepcopy(self)
+        new_query._cross_series_reducer = cross_series_reducer
+        new_query._group_by_fields = group_by_fields
+        return new_query
+
+    def iter(self, headers_only=False, page_size=None):
+        """Yield all time series objects selected by the query.
+
+        The generator returned iterates over
+        :class:`~google.cloud.monitoring_v3.types.TimeSeries` objects
+        containing points ordered from oldest to newest.
+
+        Note that the :class:`Query` object itself is an iterable, such that
+        the following are equivalent::
+
+            for timeseries in query:
+                ...
+
+            for timeseries in query.iter():
+                ...
+
+        :type headers_only: bool
+        :param headers_only:
+             Whether to omit the point data from the time series objects.
+
+        :type page_size: int
+        :param page_size:
+            (Optional) The maximum number of points in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :raises: :exc:`ValueError` if the query time interval has not been
+            specified.
+        """
+        if self._end_time is None:
+            raise ValueError("Query time interval not specified.")
+
+        params = self._build_query_params(headers_only, page_size)
+        for ts in self._client.list_time_series(**params):
+            yield ts
+
+    def _build_query_params(self, headers_only=False, page_size=None):
+        """Return key-value pairs for the list_time_series API call.
+
+        :type headers_only: bool
+        :param headers_only:
+             Whether to omit the point data from the
+             :class:`~google.cloud.monitoring_v3.types.TimeSeries` objects.
+
+        :type page_size: int
+        :param page_size:
+            (Optional) The maximum number of points in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+        """
+        params = {"name": self._project_path, "filter_": self.filter}
+
+        params["interval"] = types.TimeInterval()
+        params["interval"].end_time.FromDatetime(self._end_time)
+        if self._start_time:
+            params["interval"].start_time.FromDatetime(self._start_time)
+
+        if (
+            self._per_series_aligner
+            or self._alignment_period_seconds
+            or self._cross_series_reducer
+            or self._group_by_fields
+        ):
+            params["aggregation"] = types.Aggregation(
+                per_series_aligner=self._per_series_aligner,
+                cross_series_reducer=self._cross_series_reducer,
+                group_by_fields=self._group_by_fields,
+                alignment_period={"seconds": self._alignment_period_seconds},
+            )
+
+        if headers_only:
+            params["view"] = enums.ListTimeSeriesRequest.TimeSeriesView.HEADERS
+        else:
+            params["view"] = enums.ListTimeSeriesRequest.TimeSeriesView.FULL
+
+        if page_size is not None:
+            params["page_size"] = page_size
+
+        return params
+
+    def as_dataframe(self, label=None, labels=None):
+        """Return all the selected time series as a :mod:`pandas` dataframe.
+
+        .. note::
+
+            Use of this method requires that you have :mod:`pandas` installed.
+
+        Examples::
+
+            # Generate a dataframe with a multi-level column header including
+            # the resource type and all available resource and metric labels.
+            # This can be useful for seeing what labels are available.
+            dataframe = query.as_dataframe()
+
+            # Generate a dataframe using a particular label for the column
+            # names.
+            dataframe = query.as_dataframe(label='instance_name')
+
+            # Generate a dataframe with a multi-level column header.
+            dataframe = query.as_dataframe(labels=['zone', 'instance_name'])
+
+            # Generate a dataframe with a multi-level column header, assuming
+            # the metric is issued by more than one type of resource.
+            dataframe = query.as_dataframe(
+                labels=['resource_type', 'instance_id'])
+
+        :type label: str
+        :param label:
+            (Optional) The label name to use for the dataframe header.
+            This can be the name of a resource label or metric label
+            (e.g., ``"instance_name"``), or the string ``"resource_type"``.
+
+        :type labels: list of strings, or None
+        :param labels: A list or tuple of label names to use for the dataframe
+            header. If more than one label name is provided, the resulting
+            dataframe will have a multi-level column header. Providing values
+            for both ``label`` and ``labels`` is an error.
+
+        :rtype: :class:`pandas.DataFrame`
+        :returns: A dataframe where each column represents one time series.
+        """
+        return _dataframe._build_dataframe(self, label, labels)
+
+    def __deepcopy__(self, memo):
+        """Create a deepcopy of the query object.
+
+        The `client` attribute is copied by reference only.
+
+        :type memo: dict
+        :param memo: the memo dict to avoid excess copying in case  the object
+            is referenced from its member.
+
+        :rtype: :class:`Query`
+        :returns: The new query object.
+        """
+        new_query = copy.copy(self)
+        new_query._filter = copy.deepcopy(self._filter, memo)
+        return new_query
+
+
+class _Filter(object):
+    """Helper for assembling a filter string."""
+
+    def __init__(self, metric_type):
+        self.metric_type = metric_type
+        self.group_id = None
+        self.projects = ()
+        self.resource_label_filter = None
+        self.metric_label_filter = None
+
+    def select_resources(self, *args, **kwargs):
+        """Select by resource labels.
+
+        See :meth:`Query.select_resources`.
+        """
+        self.resource_label_filter = _build_label_filter("resource", *args, **kwargs)
+
+    def select_metrics(self, *args, **kwargs):
+        """Select by metric labels.
+
+        See :meth:`Query.select_metrics`.
+        """
+        self.metric_label_filter = _build_label_filter("metric", *args, **kwargs)
+
+    def __str__(self):
+        filters = ['metric.type = "{type}"'.format(type=self.metric_type)]
+        if self.group_id is not None:
+            filters.append('group.id = "{id}"'.format(id=self.group_id))
+        if self.projects:
+            filters.append(
+                " OR ".join(
+                    'project = "{project}"'.format(project=project)
+                    for project in self.projects
+                )
+            )
+        if self.resource_label_filter:
+            filters.append(self.resource_label_filter)
+        if self.metric_label_filter:
+            filters.append(self.metric_label_filter)
+
+        # Parentheses are never actually required, because OR binds more
+        # tightly than AND in the Monitoring API's filter syntax.
+        return " AND ".join(filters)
+
+
+def _build_label_filter(category, *args, **kwargs):
+    """Construct a filter string to filter on metric or resource labels."""
+    terms = list(args)
+    for key, value in six.iteritems(kwargs):
+        if value is None:
+            continue
+
+        suffix = None
+        if key.endswith(
+            ("_prefix", "_suffix", "_greater", "_greaterequal", "_less", "_lessequal")
+        ):
+            key, suffix = key.rsplit("_", 1)
+
+        if category == "resource" and key == "resource_type":
+            key = "resource.type"
+        else:
+            key = ".".join((category, "label", key))
+
+        if suffix == "prefix":
+            term = '{key} = starts_with("{value}")'
+        elif suffix == "suffix":
+            term = '{key} = ends_with("{value}")'
+        elif suffix == "greater":
+            term = "{key} > {value}"
+        elif suffix == "greaterequal":
+            term = "{key} >= {value}"
+        elif suffix == "less":
+            term = "{key} < {value}"
+        elif suffix == "lessequal":
+            term = "{key} <= {value}"
+        else:
+            term = '{key} = "{value}"'
+
+        terms.append(term.format(key=key, value=value))
+
+    return " AND ".join(sorted(terms))
diff --git a/monitoring/google/cloud/monitoring_v3/types.py b/monitoring/google/cloud/monitoring_v3/types.py
new file mode 100644
index 000000000000..4cf6acb006fd
--- /dev/null
+++ b/monitoring/google/cloud/monitoring_v3/types.py
@@ -0,0 +1,96 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.api import distribution_pb2
+from google.api import label_pb2
+from google.api import metric_pb2 as api_metric_pb2
+from google.api import monitored_resource_pb2
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.cloud.monitoring_v3.proto import common_pb2
+from google.cloud.monitoring_v3.proto import dropped_labels_pb2
+from google.cloud.monitoring_v3.proto import group_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2
+from google.cloud.monitoring_v3.proto import metric_pb2 as proto_metric_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2
+from google.cloud.monitoring_v3.proto import mutation_record_pb2
+from google.cloud.monitoring_v3.proto import notification_pb2
+from google.cloud.monitoring_v3.proto import notification_service_pb2
+from google.cloud.monitoring_v3.proto import span_context_pb2
+from google.cloud.monitoring_v3.proto import uptime_pb2
+from google.cloud.monitoring_v3.proto import uptime_service_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    distribution_pb2,
+    label_pb2,
+    api_metric_pb2,
+    monitored_resource_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+]
+
+_local_modules = [
+    alert_pb2,
+    alert_service_pb2,
+    common_pb2,
+    dropped_labels_pb2,
+    group_pb2,
+    group_service_pb2,
+    proto_metric_pb2,
+    metric_service_pb2,
+    mutation_record_pb2,
+    notification_pb2,
+    notification_service_pb2,
+    span_context_pb2,
+    uptime_pb2,
+    uptime_service_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.monitoring_v3.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/monitoring/noxfile.py b/monitoring/noxfile.py
new file mode 100644
index 000000000000..63a11673d3eb
--- /dev/null
+++ b/monitoring/noxfile.py
@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Additional setup for VPCSC system tests
+    if os.environ.get("GOOGLE_CLOUD_TESTS_IN_VPCSC") != "true":
+        # Unset PROJECT_ID, since VPCSC system tests expect this to be a project
+        # within the VPCSC perimeter.
+        env = {
+            "PROJECT_ID": "",
+            "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT": os.environ.get("PROJECT_ID"),
+        }
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, env=env, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, env=env, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=97")
+
+    session.run("coverage", "erase")
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install('-e', '.')
+    session.install('sphinx', 'alabaster', 'recommonmark')
+
+    shutil.rmtree(os.path.join('docs', '_build'), ignore_errors=True)
+    session.run(
+        'sphinx-build',
+        '-W',  # warnings as errors
+        '-T',  # show full traceback on exception
+        '-N',  # no colors
+        '-b', 'html',
+        '-d', os.path.join('docs', '_build', 'doctrees', ''),
+        os.path.join('docs', ''),
+        os.path.join('docs', '_build', 'html', ''),
+    )
diff --git a/monitoring/setup.cfg b/monitoring/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/monitoring/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/monitoring/setup.py b/monitoring/setup.py
new file mode 100644
index 000000000000..33b8b97f4f63
--- /dev/null
+++ b/monitoring/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-monitoring'
+description = 'Stackdriver Monitoring API client library'
+version = '0.33.0'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    'google-api-core[grpc] >= 1.14.0, < 2.0.0dev',
+]
+extras = {
+    'pandas': 'pandas >= 0.17.1',
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/monitoring/synth.metadata b/monitoring/synth.metadata
new file mode 100644
index 000000000000..b6830a599946
--- /dev/null
+++ b/monitoring/synth.metadata
@@ -0,0 +1,38 @@
+{
+  "updateTime": "2019-08-06T18:17:03.571363Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "53e641721f965a485af64331cfea9e5522294d78"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "monitoring",
+        "apiVersion": "v3",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/monitoring/artman_monitoring.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/monitoring/synth.py b/monitoring/synth.py
new file mode 100644
index 000000000000..447958ceeb89
--- /dev/null
+++ b/monitoring/synth.py
@@ -0,0 +1,99 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate monitoring GAPIC layer
+# ----------------------------------------------------------------------------
+v3_library = gapic.py_library(
+    "monitoring",
+    "v3",
+    config_path="/google/monitoring/artman_monitoring.yaml",
+    artman_output_name="monitoring-v3",
+    include_protos=True,
+)
+
+# don't copy nox.py, setup.py, README.rst, docs/index.rst
+excludes = ["nox.py", "setup.py", "README.rst", "docs/index.rst"]
+s.move(v3_library, excludes=excludes)
+
+# metadata in tests in none but should be empty list.
+# https://github.com/googleapis/gapic-generator/issues/2014
+s.replace(
+    "google/cloud/*/gapic/*_client.py",
+    'def .*\(([^\)]+)\n.*metadata=None\):\n\s+"""(.*\n)*?\s+"""\n',
+    "\g<0>"
+    "        if metadata is None:\n"
+    "            metadata = []\n"
+    "        metadata = list(metadata)\n",
+)
+
+# Issues exist where python files should defined the source encoding
+# https://github.com/googleapis/gapic-generator/issues/2097
+files = ["google/cloud/monitoring_v3/proto/common_pb2.py"]
+for f in files:
+    s.replace(f, r"(^.*$\n)*", r"# -*- coding: utf-8 -*-\n\g<0>")
+
+# GAPIC-Generator is mangling some docstrings
+# Missing blank line after bulleted list
+s.replace(
+    "google/cloud/monitoring_v3/gapic/alert_policy_service_client.py",
+    "then a new `\[CONDITION_ID\]` is created.\n",
+    "\g<0>\n",
+)
+
+s.replace(
+    "google/cloud/monitoring_v3/gapic/alert_policy_service_client.py",
+    "                ::\n\n",
+    "",
+)
+
+s.replace(
+    "google/cloud/monitoring_v3/proto/metric_service_pb2.py",
+    "^(\s+)have an ``id`` label:  ::      resource.type =\n.*",
+    "\g<1>have an ``id`` label::\n\n"
+    '\g<1>    resource.type = starts_with("gce_") AND resource.label:id\n',
+)
+
+# Deal with long lines due to long proto name
+s.replace(
+    ["google/cloud/monitoring_v3/__init__.py"],
+    "from google.cloud.monitoring_v3.gapic import "
+    "notification_channel_service_client\n",
+    "from google.cloud.monitoring_v3.gapic import (\n"
+    "    notification_channel_service_client as notification_client)\n",
+)
+s.replace(
+    ["google/cloud/monitoring_v3/__init__.py"],
+    "notification_channel_service_client.NotificationChannelServiceClient",
+    "notification_client.NotificationChannelServiceClient",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=97)
+s.move(templated_files, excludes=["noxfile.py"])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/monitoring/tests/__init__.py b/monitoring/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/monitoring/tests/system/gapic/v3/test_system_metric_service_v3.py b/monitoring/tests/system/gapic/v3/test_system_metric_service_v3.py
new file mode 100644
index 000000000000..314a4fdd5c8f
--- /dev/null
+++ b/monitoring/tests/system/gapic/v3/test_system_metric_service_v3.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3.proto import metric_service_pb2
+
+
+class TestSystemMetricService(object):
+    def test_list_monitored_resource_descriptors(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = monitoring_v3.MetricServiceClient()
+        name = client.project_path(project_id)
+        response = client.list_monitored_resource_descriptors(name)
diff --git a/monitoring/tests/system/test_vpcsc.py b/monitoring/tests/system/test_vpcsc.py
new file mode 100644
index 000000000000..ffc78cbfc047
--- /dev/null
+++ b/monitoring/tests/system/test_vpcsc.py
@@ -0,0 +1,587 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# DO NOT MODIFY! AUTO-GENERATED!
+# This file is auto-generated on 2019-05-03.
+
+# flake8: noqa
+
+import os
+import pytest
+
+from google.api_core import exceptions
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3 import enums
+
+PROJECT_INSIDE = os.environ.get("PROJECT_ID", None)
+if not PROJECT_INSIDE:
+    PROJECT_INSIDE = None
+PROJECT_OUTSIDE = os.environ.get(
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT", None
+)
+IS_INSIDE_VPCSC = os.environ.get("GOOGLE_CLOUD_TESTS_IN_VPCSC", "false")
+
+
+class TestVPCServiceControlV3(object):
+    @staticmethod
+    def _is_rejected(call):
+        try:
+            responses = call()
+
+            # If we reach this line, then call() did not raise. The return
+            # result must be either a google.api_core.page_iterator.Iterator
+            # instance, or None.
+            list(responses)
+        except exceptions.PermissionDenied as e:
+            return e.message == "Request is prohibited by organization's policy"
+        except:
+            pass
+        return False
+
+    @staticmethod
+    def _do_test(delayed_inside, delayed_outside):
+        if IS_INSIDE_VPCSC.lower() == "true":
+            assert TestVPCServiceControlV3._is_rejected(delayed_outside)
+            assert not (TestVPCServiceControlV3._is_rejected(delayed_inside))
+        else:
+            assert not (TestVPCServiceControlV3._is_rejected(delayed_outside))
+            assert TestVPCServiceControlV3._is_rejected(delayed_inside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_create_alert_policy(self):
+        client = monitoring_v3.AlertPolicyServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.create_alert_policy(name_inside, {})
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.create_alert_policy(name_outside, {})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_delete_alert_policy(self):
+        client = monitoring_v3.AlertPolicyServiceClient()
+        name_inside = client.alert_policy_path(PROJECT_INSIDE, "mock_alert_policy")
+        delayed_inside = lambda: client.delete_alert_policy(name_inside)
+        name_outside = client.alert_policy_path(PROJECT_OUTSIDE, "mock_alert_policy")
+        delayed_outside = lambda: client.delete_alert_policy(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_alert_policy(self):
+        client = monitoring_v3.AlertPolicyServiceClient()
+        name_inside = client.alert_policy_path(PROJECT_INSIDE, "mock_alert_policy")
+        delayed_inside = lambda: client.get_alert_policy(name_inside)
+        name_outside = client.alert_policy_path(PROJECT_OUTSIDE, "mock_alert_policy")
+        delayed_outside = lambda: client.get_alert_policy(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_alert_policies(self):
+        client = monitoring_v3.AlertPolicyServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_alert_policies(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_alert_policies(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_update_alert_policy(self):
+        client = monitoring_v3.AlertPolicyServiceClient()
+        name_inside = client.alert_policy_path(PROJECT_INSIDE, "mock_alert_policy")
+        delayed_inside = lambda: client.update_alert_policy({"name": name_inside})
+        name_outside = client.alert_policy_path(PROJECT_OUTSIDE, "mock_alert_policy")
+        delayed_outside = lambda: client.update_alert_policy({"name": name_outside})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_create_group(self):
+        client = monitoring_v3.GroupServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.create_group(name_inside, {})
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.create_group(name_outside, {})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_delete_group(self):
+        client = monitoring_v3.GroupServiceClient()
+        name_inside = client.group_path(PROJECT_INSIDE, "mock_group")
+        delayed_inside = lambda: client.delete_group(name_inside)
+        name_outside = client.group_path(PROJECT_OUTSIDE, "mock_group")
+        delayed_outside = lambda: client.delete_group(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_group(self):
+        client = monitoring_v3.GroupServiceClient()
+        name_inside = client.group_path(PROJECT_INSIDE, "mock_group")
+        delayed_inside = lambda: client.get_group(name_inside)
+        name_outside = client.group_path(PROJECT_OUTSIDE, "mock_group")
+        delayed_outside = lambda: client.get_group(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_group_members(self):
+        client = monitoring_v3.GroupServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_group_members(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_group_members(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_groups(self):
+        client = monitoring_v3.GroupServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_groups(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_groups(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_update_group(self):
+        client = monitoring_v3.GroupServiceClient()
+        name_inside = client.group_path(PROJECT_INSIDE, "mock_group")
+        delayed_inside = lambda: client.update_group({"name": name_inside})
+        name_outside = client.group_path(PROJECT_OUTSIDE, "mock_group")
+        delayed_outside = lambda: client.update_group({"name": name_outside})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_create_metric_descriptor(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.create_metric_descriptor(name_inside, {})
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.create_metric_descriptor(name_outside, {})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_create_time_series(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.create_time_series(name_inside, {})
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.create_time_series(name_outside, {})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_delete_metric_descriptor(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.metric_descriptor_path(
+            PROJECT_INSIDE, "mock_metric_descriptor"
+        )
+        delayed_inside = lambda: client.delete_metric_descriptor(name_inside)
+        name_outside = client.metric_descriptor_path(
+            PROJECT_OUTSIDE, "mock_metric_descriptor"
+        )
+        delayed_outside = lambda: client.delete_metric_descriptor(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_metric_descriptor(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.metric_descriptor_path(
+            PROJECT_INSIDE, "mock_metric_descriptor"
+        )
+        delayed_inside = lambda: client.get_metric_descriptor(name_inside)
+        name_outside = client.metric_descriptor_path(
+            PROJECT_OUTSIDE, "mock_metric_descriptor"
+        )
+        delayed_outside = lambda: client.get_metric_descriptor(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_monitored_resource_descriptor(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.monitored_resource_descriptor_path(
+            PROJECT_INSIDE, "mock_monitored_resource_descriptor"
+        )
+        delayed_inside = lambda: client.get_monitored_resource_descriptor(name_inside)
+        name_outside = client.monitored_resource_descriptor_path(
+            PROJECT_OUTSIDE, "mock_monitored_resource_descriptor"
+        )
+        delayed_outside = lambda: client.get_monitored_resource_descriptor(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_metric_descriptors(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_metric_descriptors(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_metric_descriptors(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_monitored_resource_descriptors(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_monitored_resource_descriptors(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_monitored_resource_descriptors(
+            name_outside
+        )
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_time_series(self):
+        client = monitoring_v3.MetricServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_time_series(
+            name_inside, "", {}, enums.ListTimeSeriesRequest.TimeSeriesView.FULL
+        )
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_time_series(
+            name_outside, "", {}, enums.ListTimeSeriesRequest.TimeSeriesView.FULL
+        )
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_create_notification_channel(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.create_notification_channel(name_inside, {})
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.create_notification_channel(name_outside, {})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_delete_notification_channel(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.notification_channel_path(
+            PROJECT_INSIDE, "mock_notification_channel"
+        )
+        delayed_inside = lambda: client.delete_notification_channel(name_inside)
+        name_outside = client.notification_channel_path(
+            PROJECT_OUTSIDE, "mock_notification_channel"
+        )
+        delayed_outside = lambda: client.delete_notification_channel(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_notification_channel(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.notification_channel_path(
+            PROJECT_INSIDE, "mock_notification_channel"
+        )
+        delayed_inside = lambda: client.get_notification_channel(name_inside)
+        name_outside = client.notification_channel_path(
+            PROJECT_OUTSIDE, "mock_notification_channel"
+        )
+        delayed_outside = lambda: client.get_notification_channel(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_notification_channel_descriptor(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.notification_channel_descriptor_path(
+            PROJECT_INSIDE, "mock_notification_channel_descriptor"
+        )
+        delayed_inside = lambda: client.get_notification_channel_descriptor(name_inside)
+        name_outside = client.notification_channel_descriptor_path(
+            PROJECT_OUTSIDE, "mock_notification_channel_descriptor"
+        )
+        delayed_outside = lambda: client.get_notification_channel_descriptor(
+            name_outside
+        )
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_notification_channel_descriptors(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_notification_channel_descriptors(
+            name_inside
+        )
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_notification_channel_descriptors(
+            name_outside
+        )
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_notification_channels(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_notification_channels(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_notification_channels(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_update_notification_channel(self):
+        client = monitoring_v3.NotificationChannelServiceClient()
+        name_inside = client.notification_channel_path(
+            PROJECT_INSIDE, "mock_notification_channel"
+        )
+        delayed_inside = lambda: client.update_notification_channel(
+            {"name": name_inside}
+        )
+        name_outside = client.notification_channel_path(
+            PROJECT_OUTSIDE, "mock_notification_channel"
+        )
+        delayed_outside = lambda: client.update_notification_channel(
+            {"name": name_outside}
+        )
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_create_uptime_check_config(self):
+        client = monitoring_v3.UptimeCheckServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.create_uptime_check_config(name_inside, {})
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.create_uptime_check_config(name_outside, {})
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_delete_uptime_check_config(self):
+        client = monitoring_v3.UptimeCheckServiceClient()
+        name_inside = client.uptime_check_config_path(
+            PROJECT_INSIDE, "mock_uptime_check_config"
+        )
+        delayed_inside = lambda: client.delete_uptime_check_config(name_inside)
+        name_outside = client.uptime_check_config_path(
+            PROJECT_OUTSIDE, "mock_uptime_check_config"
+        )
+        delayed_outside = lambda: client.delete_uptime_check_config(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_uptime_check_config(self):
+        client = monitoring_v3.UptimeCheckServiceClient()
+        name_inside = client.uptime_check_config_path(
+            PROJECT_INSIDE, "mock_uptime_check_config"
+        )
+        delayed_inside = lambda: client.get_uptime_check_config(name_inside)
+        name_outside = client.uptime_check_config_path(
+            PROJECT_OUTSIDE, "mock_uptime_check_config"
+        )
+        delayed_outside = lambda: client.get_uptime_check_config(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_uptime_check_configs(self):
+        client = monitoring_v3.UptimeCheckServiceClient()
+        name_inside = client.project_path(PROJECT_INSIDE)
+        delayed_inside = lambda: client.list_uptime_check_configs(name_inside)
+        name_outside = client.project_path(PROJECT_OUTSIDE)
+        delayed_outside = lambda: client.list_uptime_check_configs(name_outside)
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_update_uptime_check_config(self):
+        client = monitoring_v3.UptimeCheckServiceClient()
+        name_inside = client.uptime_check_config_path(
+            PROJECT_INSIDE, "mock_uptime_check_config"
+        )
+        delayed_inside = lambda: client.update_uptime_check_config(
+            {"name": name_inside}
+        )
+        name_outside = client.uptime_check_config_path(
+            PROJECT_OUTSIDE, "mock_uptime_check_config"
+        )
+        delayed_outside = lambda: client.update_uptime_check_config(
+            {"name": name_outside}
+        )
+        TestVPCServiceControlV3._do_test(delayed_inside, delayed_outside)
diff --git a/monitoring/tests/unit/gapic/v3/test_alert_policy_service_client_v3.py b/monitoring/tests/unit/gapic/v3/test_alert_policy_service_client_v3.py
new file mode 100644
index 000000000000..cf98f646e593
--- /dev/null
+++ b/monitoring/tests/unit/gapic/v3/test_alert_policy_service_client_v3.py
@@ -0,0 +1,265 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3.proto import alert_pb2
+from google.cloud.monitoring_v3.proto import alert_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestAlertPolicyServiceClient(object):
+    def test_list_alert_policies(self):
+        # Setup Expected Response
+        next_page_token = ""
+        alert_policies_element = {}
+        alert_policies = [alert_policies_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "alert_policies": alert_policies,
+        }
+        expected_response = alert_service_pb2.ListAlertPoliciesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_alert_policies(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.alert_policies[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = alert_service_pb2.ListAlertPoliciesRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_alert_policies_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_alert_policies(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_alert_policy(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = alert_pb2.AlertPolicy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup Request
+        name = client.alert_policy_path("[PROJECT]", "[ALERT_POLICY]")
+
+        response = client.get_alert_policy(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = alert_service_pb2.GetAlertPolicyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_alert_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup request
+        name = client.alert_policy_path("[PROJECT]", "[ALERT_POLICY]")
+
+        with pytest.raises(CustomException):
+            client.get_alert_policy(name)
+
+    def test_create_alert_policy(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = alert_pb2.AlertPolicy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        alert_policy = {}
+
+        response = client.create_alert_policy(name, alert_policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = alert_service_pb2.CreateAlertPolicyRequest(
+            name=name, alert_policy=alert_policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_alert_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        alert_policy = {}
+
+        with pytest.raises(CustomException):
+            client.create_alert_policy(name, alert_policy)
+
+    def test_delete_alert_policy(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup Request
+        name = client.alert_policy_path("[PROJECT]", "[ALERT_POLICY]")
+
+        client.delete_alert_policy(name)
+
+        assert len(channel.requests) == 1
+        expected_request = alert_service_pb2.DeleteAlertPolicyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_alert_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup request
+        name = client.alert_policy_path("[PROJECT]", "[ALERT_POLICY]")
+
+        with pytest.raises(CustomException):
+            client.delete_alert_policy(name)
+
+    def test_update_alert_policy(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = alert_pb2.AlertPolicy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup Request
+        alert_policy = {}
+
+        response = client.update_alert_policy(alert_policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = alert_service_pb2.UpdateAlertPolicyRequest(
+            alert_policy=alert_policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_alert_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.AlertPolicyServiceClient()
+
+        # Setup request
+        alert_policy = {}
+
+        with pytest.raises(CustomException):
+            client.update_alert_policy(alert_policy)
diff --git a/monitoring/tests/unit/gapic/v3/test_group_service_client_v3.py b/monitoring/tests/unit/gapic/v3/test_group_service_client_v3.py
new file mode 100644
index 000000000000..b996efae9be7
--- /dev/null
+++ b/monitoring/tests/unit/gapic/v3/test_group_service_client_v3.py
@@ -0,0 +1,334 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.api import monitored_resource_pb2
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3.proto import group_pb2
+from google.cloud.monitoring_v3.proto import group_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestGroupServiceClient(object):
+    def test_list_groups(self):
+        # Setup Expected Response
+        next_page_token = ""
+        group_element = {}
+        group = [group_element]
+        expected_response = {"next_page_token": next_page_token, "group": group}
+        expected_response = group_service_pb2.ListGroupsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_groups(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.group[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = group_service_pb2.ListGroupsRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_groups_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_groups(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_group(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        parent_name = "parentName1015022848"
+        filter_ = "filter-1274492040"
+        is_cluster = False
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "parent_name": parent_name,
+            "filter": filter_,
+            "is_cluster": is_cluster,
+        }
+        expected_response = group_pb2.Group(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup Request
+        name = client.group_path("[PROJECT]", "[GROUP]")
+
+        response = client.get_group(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = group_service_pb2.GetGroupRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_group_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup request
+        name = client.group_path("[PROJECT]", "[GROUP]")
+
+        with pytest.raises(CustomException):
+            client.get_group(name)
+
+    def test_create_group(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        parent_name = "parentName1015022848"
+        filter_ = "filter-1274492040"
+        is_cluster = False
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "parent_name": parent_name,
+            "filter": filter_,
+            "is_cluster": is_cluster,
+        }
+        expected_response = group_pb2.Group(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        group = {}
+
+        response = client.create_group(name, group)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = group_service_pb2.CreateGroupRequest(name=name, group=group)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_group_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        group = {}
+
+        with pytest.raises(CustomException):
+            client.create_group(name, group)
+
+    def test_update_group(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        parent_name = "parentName1015022848"
+        filter_ = "filter-1274492040"
+        is_cluster = False
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "parent_name": parent_name,
+            "filter": filter_,
+            "is_cluster": is_cluster,
+        }
+        expected_response = group_pb2.Group(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup Request
+        group = {}
+
+        response = client.update_group(group)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = group_service_pb2.UpdateGroupRequest(group=group)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_group_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup request
+        group = {}
+
+        with pytest.raises(CustomException):
+            client.update_group(group)
+
+    def test_delete_group(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup Request
+        name = client.group_path("[PROJECT]", "[GROUP]")
+
+        client.delete_group(name)
+
+        assert len(channel.requests) == 1
+        expected_request = group_service_pb2.DeleteGroupRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_group_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup request
+        name = client.group_path("[PROJECT]", "[GROUP]")
+
+        with pytest.raises(CustomException):
+            client.delete_group(name)
+
+    def test_list_group_members(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        members_element = {}
+        members = [members_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "members": members,
+        }
+        expected_response = group_service_pb2.ListGroupMembersResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup Request
+        name = client.group_path("[PROJECT]", "[GROUP]")
+
+        paged_list_response = client.list_group_members(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.members[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = group_service_pb2.ListGroupMembersRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_group_members_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.GroupServiceClient()
+
+        # Setup request
+        name = client.group_path("[PROJECT]", "[GROUP]")
+
+        paged_list_response = client.list_group_members(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/monitoring/tests/unit/gapic/v3/test_metric_service_client_v3.py b/monitoring/tests/unit/gapic/v3/test_metric_service_client_v3.py
new file mode 100644
index 000000000000..dd5e692eb413
--- /dev/null
+++ b/monitoring/tests/unit/gapic/v3/test_metric_service_client_v3.py
@@ -0,0 +1,441 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.api import metric_pb2 as api_metric_pb2
+from google.api import monitored_resource_pb2
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3 import enums
+from google.cloud.monitoring_v3.proto import common_pb2
+from google.cloud.monitoring_v3.proto import metric_pb2 as proto_metric_pb2
+from google.cloud.monitoring_v3.proto import metric_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestMetricServiceClient(object):
+    def test_list_monitored_resource_descriptors(self):
+        # Setup Expected Response
+        next_page_token = ""
+        resource_descriptors_element = {}
+        resource_descriptors = [resource_descriptors_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "resource_descriptors": resource_descriptors,
+        }
+        expected_response = metric_service_pb2.ListMonitoredResourceDescriptorsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_monitored_resource_descriptors(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.resource_descriptors[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.ListMonitoredResourceDescriptorsRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_monitored_resource_descriptors_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_monitored_resource_descriptors(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_monitored_resource_descriptor(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        type_ = "type3575610"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "type": type_,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = monitored_resource_pb2.MonitoredResourceDescriptor(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.monitored_resource_descriptor_path(
+            "[PROJECT]", "[MONITORED_RESOURCE_DESCRIPTOR]"
+        )
+
+        response = client.get_monitored_resource_descriptor(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.GetMonitoredResourceDescriptorRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_monitored_resource_descriptor_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.monitored_resource_descriptor_path(
+            "[PROJECT]", "[MONITORED_RESOURCE_DESCRIPTOR]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_monitored_resource_descriptor(name)
+
+    def test_list_metric_descriptors(self):
+        # Setup Expected Response
+        next_page_token = ""
+        metric_descriptors_element = {}
+        metric_descriptors = [metric_descriptors_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "metric_descriptors": metric_descriptors,
+        }
+        expected_response = metric_service_pb2.ListMetricDescriptorsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_metric_descriptors(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.metric_descriptors[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.ListMetricDescriptorsRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_metric_descriptors_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_metric_descriptors(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_metric_descriptor(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        type_ = "type3575610"
+        unit = "unit3594628"
+        description = "description-1724546052"
+        display_name = "displayName1615086568"
+        expected_response = {
+            "name": name_2,
+            "type": type_,
+            "unit": unit,
+            "description": description,
+            "display_name": display_name,
+        }
+        expected_response = api_metric_pb2.MetricDescriptor(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.metric_descriptor_path("[PROJECT]", "[METRIC_DESCRIPTOR]")
+
+        response = client.get_metric_descriptor(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.GetMetricDescriptorRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_metric_descriptor_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.metric_descriptor_path("[PROJECT]", "[METRIC_DESCRIPTOR]")
+
+        with pytest.raises(CustomException):
+            client.get_metric_descriptor(name)
+
+    def test_create_metric_descriptor(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        type_ = "type3575610"
+        unit = "unit3594628"
+        description = "description-1724546052"
+        display_name = "displayName1615086568"
+        expected_response = {
+            "name": name_2,
+            "type": type_,
+            "unit": unit,
+            "description": description,
+            "display_name": display_name,
+        }
+        expected_response = api_metric_pb2.MetricDescriptor(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        metric_descriptor = {}
+
+        response = client.create_metric_descriptor(name, metric_descriptor)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.CreateMetricDescriptorRequest(
+            name=name, metric_descriptor=metric_descriptor
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_metric_descriptor_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        metric_descriptor = {}
+
+        with pytest.raises(CustomException):
+            client.create_metric_descriptor(name, metric_descriptor)
+
+    def test_delete_metric_descriptor(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.metric_descriptor_path("[PROJECT]", "[METRIC_DESCRIPTOR]")
+
+        client.delete_metric_descriptor(name)
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.DeleteMetricDescriptorRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_metric_descriptor_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.metric_descriptor_path("[PROJECT]", "[METRIC_DESCRIPTOR]")
+
+        with pytest.raises(CustomException):
+            client.delete_metric_descriptor(name)
+
+    def test_list_time_series(self):
+        # Setup Expected Response
+        next_page_token = ""
+        time_series_element = {}
+        time_series = [time_series_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "time_series": time_series,
+        }
+        expected_response = metric_service_pb2.ListTimeSeriesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        filter_ = "filter-1274492040"
+        interval = {}
+        view = enums.ListTimeSeriesRequest.TimeSeriesView.FULL
+
+        paged_list_response = client.list_time_series(name, filter_, interval, view)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.time_series[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.ListTimeSeriesRequest(
+            name=name, filter=filter_, interval=interval, view=view
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_time_series_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        filter_ = "filter-1274492040"
+        interval = {}
+        view = enums.ListTimeSeriesRequest.TimeSeriesView.FULL
+
+        paged_list_response = client.list_time_series(name, filter_, interval, view)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_time_series(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        time_series = []
+
+        client.create_time_series(name, time_series)
+
+        assert len(channel.requests) == 1
+        expected_request = metric_service_pb2.CreateTimeSeriesRequest(
+            name=name, time_series=time_series
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_time_series_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.MetricServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        time_series = []
+
+        with pytest.raises(CustomException):
+            client.create_time_series(name, time_series)
diff --git a/monitoring/tests/unit/gapic/v3/test_notification_channel_service_client_v3.py b/monitoring/tests/unit/gapic/v3/test_notification_channel_service_client_v3.py
new file mode 100644
index 000000000000..1ae5aebda857
--- /dev/null
+++ b/monitoring/tests/unit/gapic/v3/test_notification_channel_service_client_v3.py
@@ -0,0 +1,521 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3.proto import notification_pb2
+from google.cloud.monitoring_v3.proto import notification_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestNotificationChannelServiceClient(object):
+    def test_list_notification_channel_descriptors(self):
+        # Setup Expected Response
+        next_page_token = ""
+        channel_descriptors_element = {}
+        channel_descriptors = [channel_descriptors_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "channel_descriptors": channel_descriptors,
+        }
+        expected_response = notification_service_pb2.ListNotificationChannelDescriptorsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_notification_channel_descriptors(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.channel_descriptors[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.ListNotificationChannelDescriptorsRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_notification_channel_descriptors_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_notification_channel_descriptors(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_notification_channel_descriptor(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        type_ = "type3575610"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "type": type_,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = notification_pb2.NotificationChannelDescriptor(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.notification_channel_descriptor_path(
+            "[PROJECT]", "[CHANNEL_DESCRIPTOR]"
+        )
+
+        response = client.get_notification_channel_descriptor(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.GetNotificationChannelDescriptorRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_notification_channel_descriptor_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.notification_channel_descriptor_path(
+            "[PROJECT]", "[CHANNEL_DESCRIPTOR]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_notification_channel_descriptor(name)
+
+    def test_list_notification_channels(self):
+        # Setup Expected Response
+        next_page_token = ""
+        notification_channels_element = {}
+        notification_channels = [notification_channels_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "notification_channels": notification_channels,
+        }
+        expected_response = notification_service_pb2.ListNotificationChannelsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_notification_channels(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.notification_channels[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.ListNotificationChannelsRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_notification_channels_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_notification_channels(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_notification_channel(self):
+        # Setup Expected Response
+        type_ = "type3575610"
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "type": type_,
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = notification_pb2.NotificationChannel(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        response = client.get_notification_channel(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.GetNotificationChannelRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_notification_channel_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        with pytest.raises(CustomException):
+            client.get_notification_channel(name)
+
+    def test_create_notification_channel(self):
+        # Setup Expected Response
+        type_ = "type3575610"
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "type": type_,
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = notification_pb2.NotificationChannel(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        notification_channel = {}
+
+        response = client.create_notification_channel(name, notification_channel)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.CreateNotificationChannelRequest(
+            name=name, notification_channel=notification_channel
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_notification_channel_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        notification_channel = {}
+
+        with pytest.raises(CustomException):
+            client.create_notification_channel(name, notification_channel)
+
+    def test_update_notification_channel(self):
+        # Setup Expected Response
+        type_ = "type3575610"
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "type": type_,
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = notification_pb2.NotificationChannel(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        notification_channel = {}
+
+        response = client.update_notification_channel(notification_channel)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.UpdateNotificationChannelRequest(
+            notification_channel=notification_channel
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_notification_channel_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        notification_channel = {}
+
+        with pytest.raises(CustomException):
+            client.update_notification_channel(notification_channel)
+
+    def test_delete_notification_channel(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        client.delete_notification_channel(name)
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.DeleteNotificationChannelRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_notification_channel_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        with pytest.raises(CustomException):
+            client.delete_notification_channel(name)
+
+    def test_send_notification_channel_verification_code(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        client.send_notification_channel_verification_code(name)
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.SendNotificationChannelVerificationCodeRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_send_notification_channel_verification_code_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        with pytest.raises(CustomException):
+            client.send_notification_channel_verification_code(name)
+
+    def test_get_notification_channel_verification_code(self):
+        # Setup Expected Response
+        code = "code3059181"
+        expected_response = {"code": code}
+        expected_response = notification_service_pb2.GetNotificationChannelVerificationCodeResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        response = client.get_notification_channel_verification_code(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.GetNotificationChannelVerificationCodeRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_notification_channel_verification_code_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+
+        with pytest.raises(CustomException):
+            client.get_notification_channel_verification_code(name)
+
+    def test_verify_notification_channel(self):
+        # Setup Expected Response
+        type_ = "type3575610"
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "type": type_,
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = notification_pb2.NotificationChannel(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup Request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+        code = "code3059181"
+
+        response = client.verify_notification_channel(name, code)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = notification_service_pb2.VerifyNotificationChannelRequest(
+            name=name, code=code
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_verify_notification_channel_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.NotificationChannelServiceClient()
+
+        # Setup request
+        name = client.notification_channel_path("[PROJECT]", "[NOTIFICATION_CHANNEL]")
+        code = "code3059181"
+
+        with pytest.raises(CustomException):
+            client.verify_notification_channel(name, code)
diff --git a/monitoring/tests/unit/gapic/v3/test_uptime_check_service_client_v3.py b/monitoring/tests/unit/gapic/v3/test_uptime_check_service_client_v3.py
new file mode 100644
index 000000000000..80af5c9ee9eb
--- /dev/null
+++ b/monitoring/tests/unit/gapic/v3/test_uptime_check_service_client_v3.py
@@ -0,0 +1,326 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import monitoring_v3
+from google.cloud.monitoring_v3.proto import uptime_pb2
+from google.cloud.monitoring_v3.proto import uptime_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestUptimeCheckServiceClient(object):
+    def test_list_uptime_check_configs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        uptime_check_configs_element = {}
+        uptime_check_configs = [uptime_check_configs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "uptime_check_configs": uptime_check_configs,
+        }
+        expected_response = uptime_service_pb2.ListUptimeCheckConfigsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_uptime_check_configs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.uptime_check_configs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = uptime_service_pb2.ListUptimeCheckConfigsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_uptime_check_configs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_uptime_check_configs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_uptime_check_config(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        is_internal = True
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "is_internal": is_internal,
+        }
+        expected_response = uptime_pb2.UptimeCheckConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup Request
+        name = client.uptime_check_config_path("[PROJECT]", "[UPTIME_CHECK_CONFIG]")
+
+        response = client.get_uptime_check_config(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = uptime_service_pb2.GetUptimeCheckConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_uptime_check_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup request
+        name = client.uptime_check_config_path("[PROJECT]", "[UPTIME_CHECK_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.get_uptime_check_config(name)
+
+    def test_create_uptime_check_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        is_internal = True
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "is_internal": is_internal,
+        }
+        expected_response = uptime_pb2.UptimeCheckConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        uptime_check_config = {}
+
+        response = client.create_uptime_check_config(parent, uptime_check_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = uptime_service_pb2.CreateUptimeCheckConfigRequest(
+            parent=parent, uptime_check_config=uptime_check_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_uptime_check_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        uptime_check_config = {}
+
+        with pytest.raises(CustomException):
+            client.create_uptime_check_config(parent, uptime_check_config)
+
+    def test_update_uptime_check_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        is_internal = True
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "is_internal": is_internal,
+        }
+        expected_response = uptime_pb2.UptimeCheckConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup Request
+        uptime_check_config = {}
+
+        response = client.update_uptime_check_config(uptime_check_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = uptime_service_pb2.UpdateUptimeCheckConfigRequest(
+            uptime_check_config=uptime_check_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_uptime_check_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup request
+        uptime_check_config = {}
+
+        with pytest.raises(CustomException):
+            client.update_uptime_check_config(uptime_check_config)
+
+    def test_delete_uptime_check_config(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup Request
+        name = client.uptime_check_config_path("[PROJECT]", "[UPTIME_CHECK_CONFIG]")
+
+        client.delete_uptime_check_config(name)
+
+        assert len(channel.requests) == 1
+        expected_request = uptime_service_pb2.DeleteUptimeCheckConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_uptime_check_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        # Setup request
+        name = client.uptime_check_config_path("[PROJECT]", "[UPTIME_CHECK_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.delete_uptime_check_config(name)
+
+    def test_list_uptime_check_ips(self):
+        # Setup Expected Response
+        next_page_token = ""
+        uptime_check_ips_element = {}
+        uptime_check_ips = [uptime_check_ips_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "uptime_check_ips": uptime_check_ips,
+        }
+        expected_response = uptime_service_pb2.ListUptimeCheckIpsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        paged_list_response = client.list_uptime_check_ips()
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.uptime_check_ips[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = uptime_service_pb2.ListUptimeCheckIpsRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_uptime_check_ips_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = monitoring_v3.UptimeCheckServiceClient()
+
+        paged_list_response = client.list_uptime_check_ips()
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/monitoring/tests/unit/test__dataframe.py b/monitoring/tests/unit/test__dataframe.py
new file mode 100644
index 000000000000..5626dcaaffa1
--- /dev/null
+++ b/monitoring/tests/unit/test__dataframe.py
@@ -0,0 +1,228 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pandas
+except ImportError:
+    HAVE_PANDAS = False
+else:
+    HAVE_PANDAS = True  # pragma: NO COVER
+
+import unittest
+
+
+PROJECT = "my-project"
+
+INSTANCE_NAMES = ["instance-1", "instance-2"]
+INSTANCE_ZONES = ["us-east1-a", "us-east1-b"]
+INSTANCE_IDS = ["1234567890123456789", "9876543210987654321"]
+
+METRIC_TYPE = "compute.googleapis.com/instance/cpu/utilization"
+METRIC_LABELS = list({"instance_name": name} for name in INSTANCE_NAMES)
+
+RESOURCE_TYPE = "gce_instance"
+RESOURCE_LABELS = list(
+    {"project_id": PROJECT, "zone": zone, "instance_id": instance_id}
+    for zone, instance_id in zip(INSTANCE_ZONES, INSTANCE_IDS)
+)
+
+METRIC_KIND = "GAUGE"
+VALUE_TYPE = "DOUBLE"
+
+TIMESTAMPS = [
+    "2016-04-06T22:05:00.042Z",
+    "2016-04-06T22:05:01.042Z",
+    "2016-04-06T22:05:02.042Z",
+]
+
+DIMENSIONS = len(TIMESTAMPS), len(INSTANCE_NAMES)
+VALUES = list(0.1 * i for i in range(DIMENSIONS[1]))
+ARRAY = [VALUES] * DIMENSIONS[0]
+
+
+def parse_timestamps():
+    from google.api_core import datetime_helpers
+
+    return [datetime_helpers.from_rfc3339(t).replace(tzinfo=None) for t in TIMESTAMPS]
+
+
+def generate_query_results():
+    from google.cloud.monitoring_v3 import types
+
+    def P(timestamp, value):
+        interval = types.TimeInterval()
+        interval.start_time.FromJsonString(timestamp)
+        interval.end_time.FromJsonString(timestamp)
+        return types.Point(interval=interval, value={"double_value": value})
+
+    for metric_labels, resource_labels, value in zip(
+        METRIC_LABELS, RESOURCE_LABELS, VALUES
+    ):
+        yield types.TimeSeries(
+            metric=types.Metric(type=METRIC_TYPE, labels=metric_labels),
+            resource=types.MonitoredResource(
+                type=RESOURCE_TYPE, labels=resource_labels
+            ),
+            metric_kind=METRIC_KIND,
+            value_type=VALUE_TYPE,
+            points=[P(t, value) for t in TIMESTAMPS],
+        )
+
+
+@unittest.skipUnless(HAVE_PANDAS, "No pandas")
+class Test__build_dataframe(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud.monitoring_v3._dataframe import _build_dataframe
+
+        return _build_dataframe(*args, **kwargs)
+
+    def test_both_label_and_labels_illegal(self):
+        with self.assertRaises(ValueError):
+            self._call_fut([], label="instance_name", labels=["zone"])
+
+    def test_empty_labels_illegal(self):
+        with self.assertRaises(ValueError):
+            self._call_fut([], labels=[])
+
+    def test_simple_label(self):
+        iterable = generate_query_results()
+        dataframe = self._call_fut(iterable, label="instance_name")
+
+        self.assertEqual(dataframe.shape, DIMENSIONS)
+        self.assertEqual(dataframe.values.tolist(), ARRAY)
+
+        expected_headers = [(instance_name,) for instance_name in INSTANCE_NAMES]
+        self.assertEqual(list(dataframe.columns), expected_headers)
+        self.assertIsNone(dataframe.columns.name)
+
+        self.assertEqual(list(dataframe.index), parse_timestamps())
+        self.assertIsNone(dataframe.index.name)
+
+    def test_multiple_labels(self):
+        NAMES = ["resource_type", "instance_id"]
+
+        iterable = generate_query_results()
+        dataframe = self._call_fut(iterable, labels=NAMES)
+
+        self.assertEqual(dataframe.shape, DIMENSIONS)
+        self.assertEqual(dataframe.values.tolist(), ARRAY)
+
+        expected_headers = [
+            (RESOURCE_TYPE, instance_id) for instance_id in INSTANCE_IDS
+        ]
+        self.assertEqual(list(dataframe.columns), expected_headers)
+        self.assertEqual(dataframe.columns.names, NAMES)
+        self.assertIsNone(dataframe.columns.name)
+
+        self.assertEqual(list(dataframe.index), parse_timestamps())
+        self.assertIsNone(dataframe.index.name)
+
+    def test_multiple_labels_with_just_one(self):
+        NAME = "instance_id"
+        NAMES = [NAME]
+
+        iterable = generate_query_results()
+        dataframe = self._call_fut(iterable, labels=NAMES)
+
+        self.assertEqual(dataframe.shape, DIMENSIONS)
+        self.assertEqual(dataframe.values.tolist(), ARRAY)
+
+        expected_headers = [(instance_id,) for instance_id in INSTANCE_IDS]
+        self.assertEqual(list(dataframe.columns), expected_headers)
+        self.assertEqual(dataframe.columns.names, NAMES)
+        self.assertIsNone(dataframe.columns.name)
+
+        self.assertEqual(list(dataframe.index), parse_timestamps())
+        self.assertIsNone(dataframe.index.name)
+
+    def test_smart_labels(self):
+        NAMES = ["resource_type", "project_id", "zone", "instance_id", "instance_name"]
+
+        iterable = generate_query_results()
+        dataframe = self._call_fut(iterable)
+
+        self.assertEqual(dataframe.shape, DIMENSIONS)
+        self.assertEqual(dataframe.values.tolist(), ARRAY)
+
+        expected_headers = [
+            (RESOURCE_TYPE, PROJECT, zone, instance_id, instance_name)
+            for zone, instance_id, instance_name in zip(
+                INSTANCE_ZONES, INSTANCE_IDS, INSTANCE_NAMES
+            )
+        ]
+        self.assertEqual(list(dataframe.columns), expected_headers)
+        self.assertEqual(dataframe.columns.names, NAMES)
+        self.assertIsNone(dataframe.columns.name)
+
+        self.assertEqual(list(dataframe.index), parse_timestamps())
+        self.assertIsNone(dataframe.index.name)
+
+    def test_empty_table_simple_label(self):
+        dataframe = self._call_fut([], label="instance_name")
+        self.assertEqual(dataframe.shape, (0, 0))
+        self.assertIsNone(dataframe.columns.name)
+        self.assertIsNone(dataframe.index.name)
+        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
+
+    def test_empty_table_multiple_labels(self):
+        NAMES = ["resource_type", "instance_id"]
+        dataframe = self._call_fut([], labels=NAMES)
+        self.assertEqual(dataframe.shape, (0, 0))
+        self.assertEqual(dataframe.columns.names, NAMES)
+        self.assertIsNone(dataframe.columns.name)
+        self.assertIsNone(dataframe.index.name)
+        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
+
+    def test_empty_table_multiple_labels_with_just_one(self):
+        NAME = "instance_id"
+        NAMES = [NAME]
+        dataframe = self._call_fut([], labels=NAMES)
+        self.assertEqual(dataframe.shape, (0, 0))
+        self.assertEqual(dataframe.columns.names, NAMES)
+        self.assertIsNone(dataframe.columns.name)
+        self.assertIsNone(dataframe.index.name)
+        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
+
+    def test_empty_table_smart_labels(self):
+        NAME = "resource_type"
+        NAMES = [NAME]
+        dataframe = self._call_fut([])
+        self.assertEqual(dataframe.shape, (0, 0))
+        self.assertEqual(dataframe.columns.names, NAMES)
+        self.assertIsNone(dataframe.columns.name)
+        self.assertIsNone(dataframe.index.name)
+        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
+
+
+class Test__sorted_resource_labels(unittest.TestCase):
+    def _call_fut(self, labels):
+        from google.cloud.monitoring_v3._dataframe import _sorted_resource_labels
+
+        return _sorted_resource_labels(labels)
+
+    def test_empty(self):
+        self.assertEqual(self._call_fut([]), [])
+
+    def test_sorted(self):
+        from google.cloud.monitoring_v3._dataframe import TOP_RESOURCE_LABELS
+
+        EXPECTED = TOP_RESOURCE_LABELS + ("other-1", "other-2")
+        self.assertSequenceEqual(self._call_fut(EXPECTED), EXPECTED)
+
+    def test_reversed(self):
+        from google.cloud.monitoring_v3._dataframe import TOP_RESOURCE_LABELS
+
+        EXPECTED = TOP_RESOURCE_LABELS + ("other-1", "other-2")
+        INPUT = list(reversed(EXPECTED))
+        self.assertSequenceEqual(self._call_fut(INPUT), EXPECTED)
diff --git a/monitoring/tests/unit/test_query.py b/monitoring/tests/unit/test_query.py
new file mode 100644
index 000000000000..20010ff60b37
--- /dev/null
+++ b/monitoring/tests/unit/test_query.py
@@ -0,0 +1,576 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import datetime
+import unittest
+import mock
+
+PROJECT = "my-project"
+
+METRIC_TYPE = "compute.googleapis.com/instance/uptime"
+METRIC_LABELS = {"instance_name": "instance-1"}
+METRIC_LABELS2 = {"instance_name": "instance-2"}
+
+RESOURCE_TYPE = "gce_instance"
+RESOURCE_LABELS = {
+    "project_id": "my-project",
+    "zone": "us-east1-a",
+    "instance_id": "1234567890123456789",
+}
+RESOURCE_LABELS2 = {
+    "project_id": "my-project",
+    "zone": "us-east1-b",
+    "instance_id": "9876543210987654321",
+}
+
+METRIC_KIND = "DELTA"
+VALUE_TYPE = "DOUBLE"
+
+TS0 = datetime.datetime(2016, 4, 6, 22, 5, 0, 42)
+TS1 = datetime.datetime(2016, 4, 6, 22, 5, 1, 42)
+TS2 = datetime.datetime(2016, 4, 6, 22, 5, 2, 42)
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        from google.cloud.monitoring_v3.proto import metric_service_pb2
+
+        self.responses = responses
+        self.responses = [
+            metric_service_pb2.ListTimeSeriesResponse(**response)
+            for response in responses
+        ]
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class TestQuery(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.monitoring_v3.query import Query
+
+        return Query
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _make_interval(end_time, start_time=None):
+        from google.cloud.monitoring_v3 import types
+
+        interval = types.TimeInterval()
+        interval.end_time.FromDatetime(end_time)
+        if start_time is not None:
+            interval.start_time.FromDatetime(start_time)
+        return interval
+
+    def test_constructor_minimal(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        # Mock the API response
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+
+        query = self._make_one(client, PROJECT)
+
+        self.assertEqual(query._client, client)
+        self.assertEqual(
+            query._filter.metric_type, self._get_target_class().DEFAULT_METRIC_TYPE
+        )
+
+        self.assertIsNone(query._start_time)
+        self.assertIsNone(query._end_time)
+
+        self.assertEqual(query._per_series_aligner, 0)
+        self.assertEqual(query._alignment_period_seconds, 0)
+        self.assertEqual(query._cross_series_reducer, 0)
+        self.assertEqual(query._group_by_fields, ())
+
+    def test_constructor_maximal(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        T1 = datetime.datetime(2016, 4, 7, 2, 30, 30)
+        DAYS, HOURS, MINUTES = 1, 2, 3
+        T0 = T1 - datetime.timedelta(days=DAYS, hours=HOURS, minutes=MINUTES)
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(
+            client,
+            PROJECT,
+            METRIC_TYPE,
+            end_time=T1,
+            days=DAYS,
+            hours=HOURS,
+            minutes=MINUTES,
+        )
+
+        self.assertEqual(query._client, client)
+        self.assertEqual(query._filter.metric_type, METRIC_TYPE)
+
+        self.assertEqual(query._start_time, T0)
+        self.assertEqual(query._end_time, T1)
+
+        self.assertEqual(query._per_series_aligner, 0)
+        self.assertEqual(query._alignment_period_seconds, 0)
+        self.assertEqual(query._cross_series_reducer, 0)
+        self.assertEqual(query._group_by_fields, ())
+
+    def test_constructor_default_end_time(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        MINUTES = 5
+        NOW = datetime.datetime(2016, 4, 7, 2, 30, 30)
+        T0 = datetime.datetime(2016, 4, 7, 2, 25, 0)
+        T1 = datetime.datetime(2016, 4, 7, 2, 30, 0)
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        with mock.patch("google.cloud.monitoring_v3.query._UTCNOW", new=lambda: NOW):
+            query = self._make_one(client, PROJECT, METRIC_TYPE, minutes=MINUTES)
+
+        self.assertEqual(query._start_time, T0)
+        self.assertEqual(query._end_time, T1)
+
+    def test_constructor_nonzero_duration_illegal(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        T1 = datetime.datetime(2016, 4, 7, 2, 30, 30)
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        with self.assertRaises(ValueError):
+            self._make_one(client, PROJECT, METRIC_TYPE, end_time=T1)
+
+    def test_execution_without_interval_illegal(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        with self.assertRaises(ValueError):
+            list(query)
+
+    def test_metric_type(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        self.assertEqual(query.metric_type, METRIC_TYPE)
+
+    def test_filter(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        expected = 'metric.type = "{type}"'.format(type=METRIC_TYPE)
+        self.assertEqual(query.filter, expected)
+
+    def test_filter_by_group(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        GROUP = "1234567"
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_group(GROUP)
+        expected = ('metric.type = "{type}"' ' AND group.id = "{group}"').format(
+            type=METRIC_TYPE, group=GROUP
+        )
+        self.assertEqual(query.filter, expected)
+
+    def test_filter_by_projects(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        PROJECT1, PROJECT2 = "project-1", "project-2"
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_projects(PROJECT1, PROJECT2)
+        expected = (
+            'metric.type = "{type}"'
+            ' AND project = "{project1}" OR project = "{project2}"'
+        ).format(type=METRIC_TYPE, project1=PROJECT1, project2=PROJECT2)
+        self.assertEqual(query.filter, expected)
+
+    def test_filter_by_resources(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        ZONE_PREFIX = "europe-"
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_resources(zone_prefix=ZONE_PREFIX)
+        expected = (
+            'metric.type = "{type}"'
+            ' AND resource.label.zone = starts_with("{prefix}")'
+        ).format(type=METRIC_TYPE, prefix=ZONE_PREFIX)
+        self.assertEqual(query.filter, expected)
+
+    def test_filter_by_metrics(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+
+        INSTANCE = "my-instance"
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_metrics(instance_name=INSTANCE)
+        expected = (
+            'metric.type = "{type}"' ' AND metric.label.instance_name = "{instance}"'
+        ).format(type=METRIC_TYPE, instance=INSTANCE)
+        self.assertEqual(query.filter, expected)
+
+    def test_request_parameters_minimal(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+        from google.cloud.monitoring_v3.gapic import enums
+
+        T1 = datetime.datetime(2016, 4, 7, 2, 30, 0)
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_interval(end_time=T1)
+        actual = query._build_query_params()
+        expected = {
+            "name": u"projects/{}".format(PROJECT),
+            "filter_": 'metric.type = "{type}"'.format(type=METRIC_TYPE),
+            "interval": self._make_interval(T1),
+            "view": enums.ListTimeSeriesRequest.TimeSeriesView.FULL,
+        }
+        self.assertEqual(actual, expected)
+
+    def test_request_parameters_maximal(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+        from google.cloud.monitoring_v3 import types
+        from google.cloud.monitoring_v3.gapic import enums
+
+        T0 = datetime.datetime(2016, 4, 7, 2, 0, 0)
+        T1 = datetime.datetime(2016, 4, 7, 2, 30, 0)
+
+        ALIGNER = "ALIGN_DELTA"
+        MINUTES, SECONDS, PERIOD_IN_SECONDS = 1, 30, 90
+
+        REDUCER = "REDUCE_MEAN"
+        FIELD1, FIELD2 = "resource.zone", "metric.instance_name"
+
+        PAGE_SIZE = 100
+
+        channel = ChannelStub()
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_interval(start_time=T0, end_time=T1)
+        query = query.align(ALIGNER, minutes=MINUTES, seconds=SECONDS)
+        query = query.reduce(REDUCER, FIELD1, FIELD2)
+        actual = query._build_query_params(headers_only=True, page_size=PAGE_SIZE)
+        expected = {
+            "name": "projects/%s" % PROJECT,
+            "filter_": 'metric.type = "{type}"'.format(type=METRIC_TYPE),
+            "interval": self._make_interval(T1, T0),
+            "aggregation": types.Aggregation(
+                per_series_aligner=ALIGNER,
+                alignment_period={"seconds": PERIOD_IN_SECONDS},
+                cross_series_reducer=REDUCER,
+                group_by_fields=[FIELD1, FIELD2],
+            ),
+            "view": enums.ListTimeSeriesRequest.TimeSeriesView.HEADERS,
+            "page_size": PAGE_SIZE,
+        }
+        self.assertEqual(actual, expected)
+
+    def test_iteration(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+        from google.cloud.monitoring_v3.gapic import enums
+        from google.cloud.monitoring_v3.proto import metric_service_pb2
+
+        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
+        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
+
+        INTERVAL1 = self._make_interval(TS1, TS0)
+        INTERVAL2 = self._make_interval(TS2, TS1)
+
+        VALUE1 = 60  # seconds
+        VALUE2 = 60.001  # seconds
+
+        SERIES1 = {
+            "metric": {"type": METRIC_TYPE, "labels": METRIC_LABELS},
+            "resource": {"type": RESOURCE_TYPE, "labels": RESOURCE_LABELS},
+            "metric_kind": METRIC_KIND,
+            "value_type": VALUE_TYPE,
+            "points": [
+                {"interval": INTERVAL2, "value": {"double_value": VALUE1}},
+                {"interval": INTERVAL1, "value": {"double_value": VALUE1}},
+            ],
+        }
+        SERIES2 = {
+            "metric": {"type": METRIC_TYPE, "labels": METRIC_LABELS2},
+            "resource": {"type": RESOURCE_TYPE, "labels": RESOURCE_LABELS2},
+            "metric_kind": METRIC_KIND,
+            "value_type": VALUE_TYPE,
+            "points": [
+                {"interval": INTERVAL2, "value": {"double_value": VALUE2}},
+                {"interval": INTERVAL1, "value": {"double_value": VALUE2}},
+            ],
+        }
+
+        RESPONSE = {"time_series": [SERIES1, SERIES2], "next_page_token": ""}
+
+        channel = ChannelStub(responses=[RESPONSE])
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_interval(start_time=T0, end_time=T1)
+        response = list(query)
+
+        self.assertEqual(len(response), 2)
+        series1, series2 = response
+
+        self.assertEqual(series1.metric.labels, METRIC_LABELS)
+        self.assertEqual(series2.metric.labels, METRIC_LABELS2)
+        self.assertEqual(series1.resource.labels, RESOURCE_LABELS)
+        self.assertEqual(series2.resource.labels, RESOURCE_LABELS2)
+
+        self.assertEqual(
+            [p.value.double_value for p in series1.points], [VALUE1, VALUE1]
+        )
+        self.assertEqual(
+            [p.value.double_value for p in series2.points], [VALUE2, VALUE2]
+        )
+        self.assertEqual([p.interval for p in series1.points], [INTERVAL2, INTERVAL1])
+        self.assertEqual([p.interval for p in series2.points], [INTERVAL2, INTERVAL1])
+
+        expected_request = metric_service_pb2.ListTimeSeriesRequest(
+            name="projects/" + PROJECT,
+            filter='metric.type = "{type}"'.format(type=METRIC_TYPE),
+            interval=self._make_interval(T1, T0),
+            view=enums.ListTimeSeriesRequest.TimeSeriesView.FULL,
+        )
+        request = channel.requests[0][1]
+        self.assertEqual(request, expected_request)
+
+    def test_iteration_empty(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+        from google.cloud.monitoring_v3.gapic import enums
+        from google.cloud.monitoring_v3.proto import metric_service_pb2
+
+        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
+        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
+
+        channel = ChannelStub(responses=[{"next_page_token": ""}])
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_interval(start_time=T0, end_time=T1)
+        response = list(query)
+
+        self.assertEqual(len(response), 0)
+
+        expected_request = metric_service_pb2.ListTimeSeriesRequest(
+            name="projects/" + PROJECT,
+            filter='metric.type = "{type}"'.format(type=METRIC_TYPE),
+            interval=self._make_interval(T1, T0),
+            view=enums.ListTimeSeriesRequest.TimeSeriesView.FULL,
+        )
+        request = channel.requests[0][1]
+        self.assertEqual(request, expected_request)
+
+    def test_iteration_headers_only(self):
+        from google.cloud.monitoring_v3 import MetricServiceClient
+        from google.cloud.monitoring_v3.gapic import enums
+        from google.cloud.monitoring_v3.proto import metric_service_pb2
+
+        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
+        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
+
+        SERIES1 = {
+            "metric": {"type": METRIC_TYPE, "labels": METRIC_LABELS},
+            "resource": {"type": RESOURCE_TYPE, "labels": RESOURCE_LABELS},
+            "metric_kind": METRIC_KIND,
+            "value_type": VALUE_TYPE,
+        }
+        SERIES2 = {
+            "metric": {"type": METRIC_TYPE, "labels": METRIC_LABELS2},
+            "resource": {"type": RESOURCE_TYPE, "labels": RESOURCE_LABELS2},
+            "metric_kind": METRIC_KIND,
+            "value_type": VALUE_TYPE,
+        }
+
+        RESPONSE = {"time_series": [SERIES1, SERIES2], "next_page_token": ""}
+
+        channel = ChannelStub(responses=[RESPONSE])
+        client = MetricServiceClient(channel=channel)
+        query = self._make_one(client, PROJECT, METRIC_TYPE)
+        query = query.select_interval(start_time=T0, end_time=T1)
+        response = list(query.iter(headers_only=True))
+
+        self.assertEqual(len(response), 2)
+        series1, series2 = response
+
+        self.assertEqual(series1.metric.labels, METRIC_LABELS)
+        self.assertEqual(series2.metric.labels, METRIC_LABELS2)
+        self.assertEqual(series1.resource.labels, RESOURCE_LABELS)
+        self.assertEqual(series2.resource.labels, RESOURCE_LABELS2)
+
+        self.assertFalse(len(series1.points))
+        self.assertFalse(len(series2.points))
+
+        expected_request = metric_service_pb2.ListTimeSeriesRequest(
+            name="projects/" + PROJECT,
+            filter='metric.type = "{type}"'.format(type=METRIC_TYPE),
+            interval=self._make_interval(T1, T0),
+            view=enums.ListTimeSeriesRequest.TimeSeriesView.HEADERS,
+        )
+        request = channel.requests[0][1]
+        self.assertEqual(request, expected_request)
+
+
+class Test_Filter(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.monitoring_v3.query import _Filter
+
+        return _Filter
+
+    def _make_one(self, metric_type):
+        return self._get_target_class()(metric_type)
+
+    def test_minimal(self):
+        obj = self._make_one(METRIC_TYPE)
+        expected = 'metric.type = "{type}"'.format(type=METRIC_TYPE)
+        self.assertEqual(str(obj), expected)
+
+    def test_maximal(self):
+        obj = self._make_one(METRIC_TYPE)
+        obj.group_id = "1234567"
+        obj.projects = "project-1", "project-2"
+        obj.select_resources(resource_type="some-resource", resource_label="foo")
+        obj.select_metrics(metric_label_prefix="bar-")
+
+        expected = (
+            'metric.type = "{type}"'
+            ' AND group.id = "1234567"'
+            ' AND project = "project-1" OR project = "project-2"'
+            ' AND resource.label.resource_label = "foo"'
+            ' AND resource.type = "some-resource"'
+            ' AND metric.label.metric_label = starts_with("bar-")'
+        ).format(type=METRIC_TYPE)
+
+        self.assertEqual(str(obj), expected)
+
+
+class Test__build_label_filter(unittest.TestCase):
+    def _call_fut(self, *args, **kwargs):
+        from google.cloud.monitoring_v3.query import _build_label_filter
+
+        return _build_label_filter(*args, **kwargs)
+
+    def test_no_labels(self):
+        self.assertEqual(self._call_fut("resource"), "")
+
+    def test_label_is_none(self):
+        self.assertEqual(self._call_fut("resource", foo=None), "")
+
+    def test_metric_labels(self):
+        actual = self._call_fut(
+            "metric", alpha_prefix="a-", beta_gamma_suffix="-b", delta_epsilon="xyz"
+        )
+        expected = (
+            'metric.label.alpha = starts_with("a-")'
+            ' AND metric.label.beta_gamma = ends_with("-b")'
+            ' AND metric.label.delta_epsilon = "xyz"'
+        )
+        self.assertEqual(actual, expected)
+
+    def test_metric_label_response_code_greater_less(self):
+        actual = self._call_fut(
+            "metric", response_code_greater=500, response_code_less=600
+        )
+        expected = (
+            "metric.label.response_code < 600" " AND metric.label.response_code > 500"
+        )
+        self.assertEqual(actual, expected)
+
+    def test_metric_label_response_code_greater_less_equal(self):
+        actual = self._call_fut(
+            "metric", response_code_greaterequal=500, response_code_lessequal=600
+        )
+        expected = (
+            "metric.label.response_code <= 600" " AND metric.label.response_code >= 500"
+        )
+        self.assertEqual(actual, expected)
+
+    def test_resource_labels(self):
+        actual = self._call_fut(
+            "resource", alpha_prefix="a-", beta_gamma_suffix="-b", delta_epsilon="xyz"
+        )
+        expected = (
+            'resource.label.alpha = starts_with("a-")'
+            ' AND resource.label.beta_gamma = ends_with("-b")'
+            ' AND resource.label.delta_epsilon = "xyz"'
+        )
+        self.assertEqual(actual, expected)
+
+    def test_raw_label_filters(self):
+        actual = self._call_fut(
+            "resource",
+            'resource.label.alpha = starts_with("a-")',
+            'resource.label.beta_gamma = ends_with("-b")',
+            'resource.label.delta_epsilon = "xyz"',
+        )
+        expected = (
+            'resource.label.alpha = starts_with("a-")'
+            ' AND resource.label.beta_gamma = ends_with("-b")'
+            ' AND resource.label.delta_epsilon = "xyz"'
+        )
+        self.assertEqual(actual, expected)
+
+    def test_resource_type(self):
+        actual = self._call_fut("resource", resource_type="foo")
+        expected = 'resource.type = "foo"'
+        self.assertEqual(actual, expected)
+
+    def test_resource_type_prefix(self):
+        actual = self._call_fut("resource", resource_type_prefix="foo-")
+        expected = 'resource.type = starts_with("foo-")'
+        self.assertEqual(actual, expected)
+
+    def test_resource_type_suffix(self):
+        actual = self._call_fut("resource", resource_type_suffix="-foo")
+        expected = 'resource.type = ends_with("-foo")'
+        self.assertEqual(actual, expected)
diff --git a/noxfile.py b/noxfile.py
new file mode 100644
index 000000000000..573360929b63
--- /dev/null
+++ b/noxfile.py
@@ -0,0 +1,39 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import nox
+
+
+@nox.session(python='3.6')
+def docs(session):
+    """Build the docs."""
+
+    # Install Sphinx and also all of the google-cloud-* packages.
+    session.chdir(os.path.realpath(os.path.dirname(__file__)))
+    session.install('-r', os.path.join('docs', 'requirements.txt'))
+
+    # Build the docs!
+    session.run(
+        'bash', os.path.join('.', 'test_utils', 'scripts', 'update_docs.sh'))
+
+
+@nox.session(python='3.6')
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+
+    session.install('docutils', 'Pygments')
+    session.run(
+        'python', 'legacy/google-cloud/setup.py', 'check', '--restructuredtext', '--strict')
diff --git a/oslogin/.coveragerc b/oslogin/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/oslogin/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/oslogin/.flake8 b/oslogin/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/oslogin/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/oslogin/.repo-metadata.json b/oslogin/.repo-metadata.json
new file mode 100644
index 000000000000..f041d82bff54
--- /dev/null
+++ b/oslogin/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "oslogin",
+  "name_pretty": "Google Cloud OS Login",
+  "product_documentation": "https://cloud.google.com/compute/docs/oslogin/",
+  "client_documentation": "https://googleapis.dev/python/oslogin/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559755",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-os-login",
+  "api_id": "oslogin.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/oslogin/CHANGELOG.md b/oslogin/CHANGELOG.md
new file mode 100644
index 000000000000..89a4a22cc567
--- /dev/null
+++ b/oslogin/CHANGELOG.md
@@ -0,0 +1,87 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-oslogin/#history
+
+## 0.2.0
+
+07-24-2019 17:10 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel. ([#8398](https://github.com/googleapis/google-cloud-python/pull/8398))
+- Reorder class methods, add routing header to method metadata, add nox session docs (via synth). ([#7934](https://github.com/googleapis/google-cloud-python/pull/7934))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Protoc-generated serialization update. ([#7090](https://github.com/googleapis/google-cloud-python/pull/7090))
+- Pick up stub docstring fix in GAPIC generator. ([#6977](https://github.com/googleapis/google-cloud-python/pull/6977))
+
+### New Features
+- Add 'client_options' support (via synth). ([#8517](https://github.com/googleapis/google-cloud-python/pull/8517))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- googlecloudplatform --> googleapis in READMEs ([#7411](https://github.com/googleapis/google-cloud-python/pull/7411))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8589](https://github.com/googleapis/google-cloud-python/pull/8589))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+-  Declare encoding as utf-8 in pb2 files (via synth). ([#8359](https://github.com/googleapis/google-cloud-python/pull/8359))
+- Add disclaimer to auto-generated template files (via synth). ([#8322](https://github.com/googleapis/google-cloud-python/pull/8322))
+-  Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8247](https://github.com/googleapis/google-cloud-python/pull/8247))
+- Fix coverage in 'types.py' (via synth). ([#8160](https://github.com/googleapis/google-cloud-python/pull/8160))
+- Blacken noxfile.py, setup.py (via synth). ([#8127](https://github.com/googleapis/google-cloud-python/pull/8127))
+- Add empty lines (via synth). ([#8066](https://github.com/googleapis/google-cloud-python/pull/8066))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.1.2
+
+12-18-2018 09:36 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6575](https://github.com/googleapis/google-cloud-python/pull/6575))
+- Fix `client_info` bug, update docstrings. ([#6417](https://github.com/googleapis/google-cloud-python/pull/6417))
+- Avoid overwriting `__module__` of messages from shared modules. ([#5364](https://github.com/googleapis/google-cloud-python/pull/5364))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add 'synth.py'. ([#6086](https://github.com/googleapis/google-cloud-python/pull/6086))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Rename releases to changelog and include from CHANGELOG.md ([#5191](https://github.com/googleapis/google-cloud-python/pull/5191))
+- Fix bad trove classifier
+
+## 0.1.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Normalize all setup.py files (#4909)
+
diff --git a/oslogin/LICENSE b/oslogin/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/oslogin/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/oslogin/MANIFEST.in b/oslogin/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/oslogin/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/oslogin/README.rst b/oslogin/README.rst
new file mode 100644
index 000000000000..31d64a215377
--- /dev/null
+++ b/oslogin/README.rst
@@ -0,0 +1,85 @@
+Python Client for Google Cloud OS Login API (unreleased)
+========================================================
+
+|pypi| |versions| 
+
+`Google Cloud OS Login API`_: Manages OS login configuration for Google account users.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-oslogin.svg
+   :target: https://pypi.org/project/google-cloud-oslogin/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-oslogin.svg
+   :target: https://pypi.org/project/google-cloud-oslogin/
+.. _Google Cloud OS Login API: https://cloud.google.com/os-login
+.. _Client Library Documentation: https://googleapis.dev/python/oslogin/latest
+.. _Product Documentation:  https://cloud.google.com/os-login
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud OS Login API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud OS Login API.:  https://cloud.google.com/os-login
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-os-login
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-os-login
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud OS Login API
+   to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/oslogin/docs/README.rst b/oslogin/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/oslogin/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/oslogin/docs/changelog.md b/oslogin/docs/changelog.md
new file mode 120000
index 000000000000..7f56b82c11da
--- /dev/null
+++ b/oslogin/docs/changelog.md
@@ -0,0 +1 @@
+../../oslogin/CHANGELOG.md
\ No newline at end of file
diff --git a/oslogin/docs/conf.py b/oslogin/docs/conf.py
new file mode 100644
index 000000000000..e12461cf03fb
--- /dev/null
+++ b/oslogin/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-os-login documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-os-login"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-os-login-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-os-login.tex",
+        u"google-cloud-os-login Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-os-login",
+        u"google-cloud-os-login Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-os-login",
+        u"google-cloud-os-login Documentation",
+        author,
+        "google-cloud-os-login",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/oslogin/docs/gapic/v1/api.rst b/oslogin/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..29e3db95c426
--- /dev/null
+++ b/oslogin/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud OS Login API
+====================================
+
+.. automodule:: google.cloud.oslogin_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/oslogin/docs/gapic/v1/types.rst b/oslogin/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..25d3fd0f8a94
--- /dev/null
+++ b/oslogin/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud OS Login API Client
+==========================================
+
+.. automodule:: google.cloud.oslogin_v1.types
+    :members:
\ No newline at end of file
diff --git a/oslogin/docs/index.rst b/oslogin/docs/index.rst
new file mode 100644
index 000000000000..051c6ec77fc0
--- /dev/null
+++ b/oslogin/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+    changelog
+
+Changelog
+---------
+
+For all ``google-cloud-oslogin`` releases.
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/oslogin/google/__init__.py b/oslogin/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/oslogin/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/oslogin/google/cloud/__init__.py b/oslogin/google/cloud/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/oslogin/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/oslogin/google/cloud/oslogin.py b/oslogin/google/cloud/oslogin.py
new file mode 100644
index 000000000000..3c44a48fc35c
--- /dev/null
+++ b/oslogin/google/cloud/oslogin.py
@@ -0,0 +1,20 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.oslogin_v1 import OsLoginServiceClient
+from google.cloud.oslogin_v1 import types
+
+__all__ = ("types", "OsLoginServiceClient")
diff --git a/oslogin/google/cloud/oslogin_v1/__init__.py b/oslogin/google/cloud/oslogin_v1/__init__.py
new file mode 100644
index 000000000000..2691d28a9b40
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/__init__.py
@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.oslogin_v1 import types
+from google.cloud.oslogin_v1.gapic import os_login_service_client
+
+
+class OsLoginServiceClient(os_login_service_client.OsLoginServiceClient):
+    __doc__ = os_login_service_client.OsLoginServiceClient.__doc__
+
+
+__all__ = ("types", "OsLoginServiceClient")
diff --git a/oslogin/google/cloud/oslogin_v1/gapic/__init__.py b/oslogin/google/cloud/oslogin_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/oslogin/google/cloud/oslogin_v1/gapic/os_login_service_client.py b/oslogin/google/cloud/oslogin_v1/gapic/os_login_service_client.py
new file mode 100644
index 000000000000..d19ee1de971a
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/gapic/os_login_service_client.py
@@ -0,0 +1,658 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.oslogin.v1 OsLoginService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.oslogin_v1.gapic import os_login_service_client_config
+from google.cloud.oslogin_v1.gapic.transports import os_login_service_grpc_transport
+from google.cloud.oslogin_v1.proto import common_pb2
+from google.cloud.oslogin_v1.proto import oslogin_pb2
+from google.cloud.oslogin_v1.proto import oslogin_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-os-login").version
+
+
+class OsLoginServiceClient(object):
+    """
+    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_ADDRESS = "oslogin.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.oslogin.v1.OsLoginService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            OsLoginServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def fingerprint_path(cls, user, fingerprint):
+        """Return a fully-qualified fingerprint string."""
+        return google.api_core.path_template.expand(
+            "users/{user}/sshPublicKeys/{fingerprint}",
+            user=user,
+            fingerprint=fingerprint,
+        )
+
+    @classmethod
+    def project_path(cls, user, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "users/{user}/projects/{project}", user=user, project=project
+        )
+
+    @classmethod
+    def user_path(cls, user):
+        """Return a fully-qualified user string."""
+        return google.api_core.path_template.expand("users/{user}", user=user)
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.OsLoginServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.OsLoginServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = os_login_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=os_login_service_grpc_transport.OsLoginServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = os_login_service_grpc_transport.OsLoginServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def delete_posix_account(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a POSIX account.
+
+        Example:
+            >>> from google.cloud import oslogin_v1
+            >>>
+            >>> client = oslogin_v1.OsLoginServiceClient()
+            >>>
+            >>> name = client.project_path('[USER]', '[PROJECT]')
+            >>>
+            >>> client.delete_posix_account(name)
+
+        Args:
+            name (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_posix_account" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_posix_account"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_posix_account,
+                default_retry=self._method_configs["DeletePosixAccount"].retry,
+                default_timeout=self._method_configs["DeletePosixAccount"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = oslogin_pb2.DeletePosixAccountRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_posix_account"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_ssh_public_key(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an SSH public key.
+
+        Example:
+            >>> from google.cloud import oslogin_v1
+            >>>
+            >>> client = oslogin_v1.OsLoginServiceClient()
+            >>>
+            >>> name = client.fingerprint_path('[USER]', '[FINGERPRINT]')
+            >>>
+            >>> client.delete_ssh_public_key(name)
+
+        Args:
+            name (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_ssh_public_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_ssh_public_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_ssh_public_key,
+                default_retry=self._method_configs["DeleteSshPublicKey"].retry,
+                default_timeout=self._method_configs["DeleteSshPublicKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = oslogin_pb2.DeleteSshPublicKeyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_ssh_public_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_login_profile(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves the profile information used for logging in to a virtual machine
+        on Google Compute Engine.
+
+        Example:
+            >>> from google.cloud import oslogin_v1
+            >>>
+            >>> client = oslogin_v1.OsLoginServiceClient()
+            >>>
+            >>> name = client.user_path('[USER]')
+            >>>
+            >>> response = client.get_login_profile(name)
+
+        Args:
+            name (str): The unique ID for the user in format ``users/{user}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.oslogin_v1.types.LoginProfile` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_login_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_login_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_login_profile,
+                default_retry=self._method_configs["GetLoginProfile"].retry,
+                default_timeout=self._method_configs["GetLoginProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = oslogin_pb2.GetLoginProfileRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_login_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_ssh_public_key(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves an SSH public key.
+
+        Example:
+            >>> from google.cloud import oslogin_v1
+            >>>
+            >>> client = oslogin_v1.OsLoginServiceClient()
+            >>>
+            >>> name = client.fingerprint_path('[USER]', '[FINGERPRINT]')
+            >>>
+            >>> response = client.get_ssh_public_key(name)
+
+        Args:
+            name (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.oslogin_v1.types.SshPublicKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_ssh_public_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_ssh_public_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_ssh_public_key,
+                default_retry=self._method_configs["GetSshPublicKey"].retry,
+                default_timeout=self._method_configs["GetSshPublicKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = oslogin_pb2.GetSshPublicKeyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_ssh_public_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def import_ssh_public_key(
+        self,
+        parent,
+        ssh_public_key,
+        project_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import oslogin_v1
+            >>>
+            >>> client = oslogin_v1.OsLoginServiceClient()
+            >>>
+            >>> parent = client.user_path('[USER]')
+            >>>
+            >>> # TODO: Initialize `ssh_public_key`:
+            >>> ssh_public_key = {}
+            >>>
+            >>> response = client.import_ssh_public_key(parent, ssh_public_key)
+
+        Args:
+            parent (str): The unique ID for the user in format ``users/{user}``.
+            ssh_public_key (Union[dict, ~google.cloud.oslogin_v1.types.SshPublicKey]): The SSH public key and expiration time.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.oslogin_v1.types.SshPublicKey`
+            project_id (str): The project ID of the Google Cloud Platform project.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.oslogin_v1.types.ImportSshPublicKeyResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_ssh_public_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_ssh_public_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_ssh_public_key,
+                default_retry=self._method_configs["ImportSshPublicKey"].retry,
+                default_timeout=self._method_configs["ImportSshPublicKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = oslogin_pb2.ImportSshPublicKeyRequest(
+            parent=parent, ssh_public_key=ssh_public_key, project_id=project_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["import_ssh_public_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_ssh_public_key(
+        self,
+        name,
+        ssh_public_key,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an SSH public key and returns the profile information. This method
+        supports patch semantics.
+
+        Example:
+            >>> from google.cloud import oslogin_v1
+            >>>
+            >>> client = oslogin_v1.OsLoginServiceClient()
+            >>>
+            >>> name = client.fingerprint_path('[USER]', '[FINGERPRINT]')
+            >>>
+            >>> # TODO: Initialize `ssh_public_key`:
+            >>> ssh_public_key = {}
+            >>>
+            >>> response = client.update_ssh_public_key(name, ssh_public_key)
+
+        Args:
+            name (str): 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}``.
+            ssh_public_key (Union[dict, ~google.cloud.oslogin_v1.types.SshPublicKey]): The SSH public key and expiration time.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.oslogin_v1.types.SshPublicKey`
+            update_mask (Union[dict, ~google.cloud.oslogin_v1.types.FieldMask]): Mask to control which fields get updated. Updates all if not present.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.oslogin_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.oslogin_v1.types.SshPublicKey` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_ssh_public_key" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_ssh_public_key"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_ssh_public_key,
+                default_retry=self._method_configs["UpdateSshPublicKey"].retry,
+                default_timeout=self._method_configs["UpdateSshPublicKey"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = oslogin_pb2.UpdateSshPublicKeyRequest(
+            name=name, ssh_public_key=ssh_public_key, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_ssh_public_key"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/oslogin/google/cloud/oslogin_v1/gapic/os_login_service_client_config.py b/oslogin/google/cloud/oslogin_v1/gapic/os_login_service_client_config.py
new file mode 100644
index 000000000000..e55e7963358b
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/gapic/os_login_service_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.oslogin.v1.OsLoginService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 10000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "DeletePosixAccount": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteSshPublicKey": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetLoginProfile": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSshPublicKey": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportSshPublicKey": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSshPublicKey": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/oslogin/google/cloud/oslogin_v1/gapic/transports/__init__.py b/oslogin/google/cloud/oslogin_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/oslogin/google/cloud/oslogin_v1/gapic/transports/os_login_service_grpc_transport.py b/oslogin/google/cloud/oslogin_v1/gapic/transports/os_login_service_grpc_transport.py
new file mode 100644
index 000000000000..6414cf27a0da
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/gapic/transports/os_login_service_grpc_transport.py
@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.oslogin_v1.proto import oslogin_pb2_grpc
+
+
+class OsLoginServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.oslogin.v1 OsLoginService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _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",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="oslogin.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "os_login_service_stub": oslogin_pb2_grpc.OsLoginServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="oslogin.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def delete_posix_account(self):
+        """Return the gRPC stub for :meth:`OsLoginServiceClient.delete_posix_account`.
+
+        Deletes a POSIX account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["os_login_service_stub"].DeletePosixAccount
+
+    @property
+    def delete_ssh_public_key(self):
+        """Return the gRPC stub for :meth:`OsLoginServiceClient.delete_ssh_public_key`.
+
+        Deletes an SSH public key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["os_login_service_stub"].DeleteSshPublicKey
+
+    @property
+    def get_login_profile(self):
+        """Return the gRPC stub for :meth:`OsLoginServiceClient.get_login_profile`.
+
+        Retrieves the profile information used for logging in to a virtual machine
+        on Google Compute Engine.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["os_login_service_stub"].GetLoginProfile
+
+    @property
+    def get_ssh_public_key(self):
+        """Return the gRPC stub for :meth:`OsLoginServiceClient.get_ssh_public_key`.
+
+        Retrieves an SSH public key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["os_login_service_stub"].GetSshPublicKey
+
+    @property
+    def import_ssh_public_key(self):
+        """Return the gRPC stub for :meth:`OsLoginServiceClient.import_ssh_public_key`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["os_login_service_stub"].ImportSshPublicKey
+
+    @property
+    def update_ssh_public_key(self):
+        """Return the gRPC stub for :meth:`OsLoginServiceClient.update_ssh_public_key`.
+
+        Updates an SSH public key and returns the profile information. This method
+        supports patch semantics.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["os_login_service_stub"].UpdateSshPublicKey
diff --git a/oslogin/google/cloud/oslogin_v1/proto/__init__.py b/oslogin/google/cloud/oslogin_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/oslogin/google/cloud/oslogin_v1/proto/common_pb2.py b/oslogin/google/cloud/oslogin_v1/proto/common_pb2.py
new file mode 100644
index 000000000000..7a81f9e4a322
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/common_pb2.py
@@ -0,0 +1,346 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/oslogin/common/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/oslogin/common/common.proto",
+    package="google.cloud.oslogin.common",
+    syntax="proto3",
+    serialized_pb=_b(
+        '\n(google/cloud/oslogin/common/common.proto\x12\x1bgoogle.cloud.oslogin.common\x1a\x1cgoogle/api/annotations.proto"\xa8\x01\n\x0cPosixAccount\x12\x0f\n\x07primary\x18\x01 \x01(\x08\x12\x10\n\x08username\x18\x02 \x01(\t\x12\x0b\n\x03uid\x18\x03 \x01(\x03\x12\x0b\n\x03gid\x18\x04 \x01(\x03\x12\x16\n\x0ehome_directory\x18\x05 \x01(\t\x12\r\n\x05shell\x18\x06 \x01(\t\x12\r\n\x05gecos\x18\x07 \x01(\t\x12\x11\n\tsystem_id\x18\x08 \x01(\t\x12\x12\n\naccount_id\x18\t \x01(\t"N\n\x0cSshPublicKey\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1c\n\x14\x65xpiration_time_usec\x18\x02 \x01(\x03\x12\x13\n\x0b\x66ingerprint\x18\x03 \x01(\tB\xae\x01\n\x1f\x63om.google.cloud.oslogin.commonB\x0cOsLoginProtoZAgoogle.golang.org/genproto/googleapis/cloud/oslogin/common;common\xaa\x02\x1bGoogle.Cloud.OsLogin.Common\xca\x02\x1bGoogle\\Cloud\\OsLogin\\Commonb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_POSIXACCOUNT = _descriptor.Descriptor(
+    name="PosixAccount",
+    full_name="google.cloud.oslogin.common.PosixAccount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="primary",
+            full_name="google.cloud.oslogin.common.PosixAccount.primary",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.cloud.oslogin.common.PosixAccount.username",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uid",
+            full_name="google.cloud.oslogin.common.PosixAccount.uid",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gid",
+            full_name="google.cloud.oslogin.common.PosixAccount.gid",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="home_directory",
+            full_name="google.cloud.oslogin.common.PosixAccount.home_directory",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shell",
+            full_name="google.cloud.oslogin.common.PosixAccount.shell",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gecos",
+            full_name="google.cloud.oslogin.common.PosixAccount.gecos",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="system_id",
+            full_name="google.cloud.oslogin.common.PosixAccount.system_id",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="account_id",
+            full_name="google.cloud.oslogin.common.PosixAccount.account_id",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=104,
+    serialized_end=272,
+)
+
+
+_SSHPUBLICKEY = _descriptor.Descriptor(
+    name="SshPublicKey",
+    full_name="google.cloud.oslogin.common.SshPublicKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.oslogin.common.SshPublicKey.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiration_time_usec",
+            full_name="google.cloud.oslogin.common.SshPublicKey.expiration_time_usec",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fingerprint",
+            full_name="google.cloud.oslogin.common.SshPublicKey.fingerprint",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            options=None,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=274,
+    serialized_end=352,
+)
+
+DESCRIPTOR.message_types_by_name["PosixAccount"] = _POSIXACCOUNT
+DESCRIPTOR.message_types_by_name["SshPublicKey"] = _SSHPUBLICKEY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+PosixAccount = _reflection.GeneratedProtocolMessageType(
+    "PosixAccount",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSIXACCOUNT,
+        __module__="google.cloud.oslogin.common.common_pb2",
+        __doc__="""The POSIX account information associated with a Google account.
+  
+  
+  Attributes:
+      primary:
+          Only one POSIX account can be marked as primary.
+      username:
+          The username of the POSIX account.
+      uid:
+          The user ID.
+      gid:
+          The default group ID.
+      home_directory:
+          The path to the home directory for this account.
+      shell:
+          The path to the logic shell for this account.
+      gecos:
+          The GECOS (user information) entry for this account.
+      system_id:
+          System identifier for which account the username or uid
+          applies to. By default, the empty value is used.
+      account_id:
+          Output only. A POSIX account identifier.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.common.PosixAccount)
+    ),
+)
+_sym_db.RegisterMessage(PosixAccount)
+
+SshPublicKey = _reflection.GeneratedProtocolMessageType(
+    "SshPublicKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SSHPUBLICKEY,
+        __module__="google.cloud.oslogin.common.common_pb2",
+        __doc__="""The SSH public key information associated with a Google account.
+  
+  
+  Attributes:
+      key:
+          Public key text in SSH format, defined by RFC4253 section 6.6.
+      expiration_time_usec:
+          An expiration time in microseconds since epoch.
+      fingerprint:
+          Output only. The SHA-256 fingerprint of the SSH public key.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.common.SshPublicKey)
+    ),
+)
+_sym_db.RegisterMessage(SshPublicKey)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(
+    descriptor_pb2.FileOptions(),
+    _b(
+        "\n\037com.google.cloud.oslogin.commonB\014OsLoginProtoZAgoogle.golang.org/genproto/googleapis/cloud/oslogin/common;common\252\002\033Google.Cloud.OsLogin.Common\312\002\033Google\\Cloud\\OsLogin\\Common"
+    ),
+)
+# @@protoc_insertion_point(module_scope)
diff --git a/oslogin/google/cloud/oslogin_v1/proto/common_pb2_grpc.py b/oslogin/google/cloud/oslogin_v1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin.proto b/oslogin/google/cloud/oslogin_v1/proto/oslogin.proto
new file mode 100644
index 000000000000..d76bd47e650c
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin.proto
@@ -0,0 +1,167 @@
+// 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.oslogin.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/oslogin/common/common.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option csharp_namespace = "Google.Cloud.OsLogin.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/oslogin/v1;oslogin";
+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";
+
+// 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 {
+  // Deletes a POSIX account.
+  rpc DeletePosixAccount(DeletePosixAccountRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=users/*/projects/*}"
+    };
+  }
+
+  // Deletes an SSH public key.
+  rpc DeleteSshPublicKey(DeleteSshPublicKeyRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=users/*/sshPublicKeys/*}"
+    };
+  }
+
+  // Retrieves the profile information used for logging in to a virtual machine
+  // on Google Compute Engine.
+  rpc GetLoginProfile(GetLoginProfileRequest) returns (LoginProfile) {
+    option (google.api.http) = {
+      get: "/v1/{name=users/*}/loginProfile"
+    };
+  }
+
+  // Retrieves an SSH public key.
+  rpc GetSshPublicKey(GetSshPublicKeyRequest)
+      returns (google.cloud.oslogin.common.SshPublicKey) {
+    option (google.api.http) = {
+      get: "/v1/{name=users/*/sshPublicKeys/*}"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{parent=users/*}:importSshPublicKey"
+      body: "ssh_public_key"
+    };
+  }
+
+  // Updates an SSH public key and returns the profile information. This method
+  // supports patch semantics.
+  rpc UpdateSshPublicKey(UpdateSshPublicKeyRequest)
+      returns (google.cloud.oslogin.common.SshPublicKey) {
+    option (google.api.http) = {
+      patch: "/v1/{name=users/*/sshPublicKeys/*}"
+      body: "ssh_public_key"
+    };
+  }
+}
+
+// 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;
+
+  // 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<string, google.cloud.oslogin.common.SshPublicKey> 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
+  // by the project ID they are associated with. A reference to the POSIX
+  // account is in format `users/{user}/projects/{project}`.
+  string name = 1;
+}
+
+// A request message for deleting an SSH public key.
+message DeleteSshPublicKeyRequest {
+  // 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;
+}
+
+// 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;
+}
+
+// A request message for retrieving an SSH public key.
+message GetSshPublicKeyRequest {
+  // 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;
+}
+
+// A request message for importing an SSH public key.
+message ImportSshPublicKeyRequest {
+  // The unique ID for the user in format `users/{user}`.
+  string parent = 1;
+
+  // The SSH public key and expiration time.
+  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2;
+
+  // The project ID of the Google Cloud Platform project.
+  string project_id = 3;
+}
+
+// A response message for importing an SSH public key.
+message ImportSshPublicKeyResponse {
+  // The login profile information for the user.
+  LoginProfile login_profile = 1;
+}
+
+// A request message for updating an SSH public key.
+message UpdateSshPublicKeyRequest {
+  // 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;
+
+  // Mask to control which fields get updated. Updates all if not present.
+  google.protobuf.FieldMask update_mask = 3;
+}
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/__init__.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/common_pb2.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/common_pb2.py
new file mode 100644
index 000000000000..93acf477103a
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/common_pb2.py
@@ -0,0 +1,355 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/oslogin/common/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/oslogin/common/common.proto",
+    package="google.cloud.oslogin.common",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.oslogin.commonB\014OsLoginProtoZAgoogle.golang.org/genproto/googleapis/cloud/oslogin/common;common\252\002\033Google.Cloud.OsLogin.Common\312\002\033Google\\Cloud\\OsLogin\\Common"
+    ),
+    serialized_pb=_b(
+        '\n(google/cloud/oslogin/common/common.proto\x12\x1bgoogle.cloud.oslogin.common\x1a\x1cgoogle/api/annotations.proto"\xa8\x01\n\x0cPosixAccount\x12\x0f\n\x07primary\x18\x01 \x01(\x08\x12\x10\n\x08username\x18\x02 \x01(\t\x12\x0b\n\x03uid\x18\x03 \x01(\x03\x12\x0b\n\x03gid\x18\x04 \x01(\x03\x12\x16\n\x0ehome_directory\x18\x05 \x01(\t\x12\r\n\x05shell\x18\x06 \x01(\t\x12\r\n\x05gecos\x18\x07 \x01(\t\x12\x11\n\tsystem_id\x18\x08 \x01(\t\x12\x12\n\naccount_id\x18\t \x01(\t"N\n\x0cSshPublicKey\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x1c\n\x14\x65xpiration_time_usec\x18\x02 \x01(\x03\x12\x13\n\x0b\x66ingerprint\x18\x03 \x01(\tB\xae\x01\n\x1f\x63om.google.cloud.oslogin.commonB\x0cOsLoginProtoZAgoogle.golang.org/genproto/googleapis/cloud/oslogin/common;common\xaa\x02\x1bGoogle.Cloud.OsLogin.Common\xca\x02\x1bGoogle\\Cloud\\OsLogin\\Commonb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_POSIXACCOUNT = _descriptor.Descriptor(
+    name="PosixAccount",
+    full_name="google.cloud.oslogin.common.PosixAccount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="primary",
+            full_name="google.cloud.oslogin.common.PosixAccount.primary",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.cloud.oslogin.common.PosixAccount.username",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uid",
+            full_name="google.cloud.oslogin.common.PosixAccount.uid",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gid",
+            full_name="google.cloud.oslogin.common.PosixAccount.gid",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="home_directory",
+            full_name="google.cloud.oslogin.common.PosixAccount.home_directory",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shell",
+            full_name="google.cloud.oslogin.common.PosixAccount.shell",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gecos",
+            full_name="google.cloud.oslogin.common.PosixAccount.gecos",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="system_id",
+            full_name="google.cloud.oslogin.common.PosixAccount.system_id",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="account_id",
+            full_name="google.cloud.oslogin.common.PosixAccount.account_id",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=104,
+    serialized_end=272,
+)
+
+
+_SSHPUBLICKEY = _descriptor.Descriptor(
+    name="SshPublicKey",
+    full_name="google.cloud.oslogin.common.SshPublicKey",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.oslogin.common.SshPublicKey.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiration_time_usec",
+            full_name="google.cloud.oslogin.common.SshPublicKey.expiration_time_usec",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fingerprint",
+            full_name="google.cloud.oslogin.common.SshPublicKey.fingerprint",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=274,
+    serialized_end=352,
+)
+
+DESCRIPTOR.message_types_by_name["PosixAccount"] = _POSIXACCOUNT
+DESCRIPTOR.message_types_by_name["SshPublicKey"] = _SSHPUBLICKEY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+PosixAccount = _reflection.GeneratedProtocolMessageType(
+    "PosixAccount",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSIXACCOUNT,
+        __module__="google.cloud.oslogin.common.common_pb2",
+        __doc__="""The POSIX account information associated with a Google account.
+  
+  
+  Attributes:
+      primary:
+          Only one POSIX account can be marked as primary.
+      username:
+          The username of the POSIX account.
+      uid:
+          The user ID.
+      gid:
+          The default group ID.
+      home_directory:
+          The path to the home directory for this account.
+      shell:
+          The path to the logic shell for this account.
+      gecos:
+          The GECOS (user information) entry for this account.
+      system_id:
+          System identifier for which account the username or uid
+          applies to. By default, the empty value is used.
+      account_id:
+          Output only. A POSIX account identifier.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.common.PosixAccount)
+    ),
+)
+_sym_db.RegisterMessage(PosixAccount)
+
+SshPublicKey = _reflection.GeneratedProtocolMessageType(
+    "SshPublicKey",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SSHPUBLICKEY,
+        __module__="google.cloud.oslogin.common.common_pb2",
+        __doc__="""The SSH public key information associated with a Google account.
+  
+  
+  Attributes:
+      key:
+          Public key text in SSH format, defined by RFC4253 section 6.6.
+      expiration_time_usec:
+          An expiration time in microseconds since epoch.
+      fingerprint:
+          Output only. The SHA-256 fingerprint of the SSH public key.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.common.SshPublicKey)
+    ),
+)
+_sym_db.RegisterMessage(SshPublicKey)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/common_pb2_grpc.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin/common/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin_pb2.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin_pb2.py
new file mode 100644
index 000000000000..3eb27bda6a64
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin_pb2.py
@@ -0,0 +1,847 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/oslogin_v1/proto/oslogin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.oslogin_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/oslogin_v1/proto/oslogin.proto",
+    package="google.cloud.oslogin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\033com.google.cloud.oslogin.v1B\014OsLoginProtoP\001Z>google.golang.org/genproto/googleapis/cloud/oslogin/v1;oslogin\252\002\027Google.Cloud.OsLogin.V1\312\002\027Google\\Cloud\\OsLogin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/oslogin_v1/proto/oslogin.proto\x12\x17google.cloud.oslogin.v1\x1a\x1cgoogle/api/annotations.proto\x1a(google/cloud/oslogin/common/common.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\xa6\x02\n\x0cLoginProfile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x41\n\x0eposix_accounts\x18\x02 \x03(\x0b\x32).google.cloud.oslogin.common.PosixAccount\x12Q\n\x0fssh_public_keys\x18\x03 \x03(\x0b\x32\x38.google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry\x12\x11\n\tsuspended\x18\x04 \x01(\x08\x1a_\n\x12SshPublicKeysEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x38\n\x05value\x18\x02 \x01(\x0b\x32).google.cloud.oslogin.common.SshPublicKey:\x02\x38\x01")\n\x19\x44\x65letePosixAccountRequest\x12\x0c\n\x04name\x18\x01 \x01(\t")\n\x19\x44\x65leteSshPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"&\n\x16GetLoginProfileRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"&\n\x16GetSshPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x82\x01\n\x19ImportSshPublicKeyRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x41\n\x0essh_public_key\x18\x02 \x01(\x0b\x32).google.cloud.oslogin.common.SshPublicKey\x12\x12\n\nproject_id\x18\x03 \x01(\t"Z\n\x1aImportSshPublicKeyResponse\x12<\n\rlogin_profile\x18\x01 \x01(\x0b\x32%.google.cloud.oslogin.v1.LoginProfile"\x9d\x01\n\x19UpdateSshPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x41\n\x0essh_public_key\x18\x02 \x01(\x0b\x32).google.cloud.oslogin.common.SshPublicKey\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask2\xcd\x07\n\x0eOsLoginService\x12\x87\x01\n\x12\x44\x65letePosixAccount\x12\x32.google.cloud.oslogin.v1.DeletePosixAccountRequest\x1a\x16.google.protobuf.Empty"%\x82\xd3\xe4\x93\x02\x1f*\x1d/v1/{name=users/*/projects/*}\x12\x8c\x01\n\x12\x44\x65leteSshPublicKey\x12\x32.google.cloud.oslogin.v1.DeleteSshPublicKeyRequest\x1a\x16.google.protobuf.Empty"*\x82\xd3\xe4\x93\x02$*"/v1/{name=users/*/sshPublicKeys/*}\x12\x92\x01\n\x0fGetLoginProfile\x12/.google.cloud.oslogin.v1.GetLoginProfileRequest\x1a%.google.cloud.oslogin.v1.LoginProfile"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v1/{name=users/*}/loginProfile\x12\x99\x01\n\x0fGetSshPublicKey\x12/.google.cloud.oslogin.v1.GetSshPublicKeyRequest\x1a).google.cloud.oslogin.common.SshPublicKey"*\x82\xd3\xe4\x93\x02$\x12"/v1/{name=users/*/sshPublicKeys/*}\x12\xbe\x01\n\x12ImportSshPublicKey\x12\x32.google.cloud.oslogin.v1.ImportSshPublicKeyRequest\x1a\x33.google.cloud.oslogin.v1.ImportSshPublicKeyResponse"?\x82\xd3\xe4\x93\x02\x39"\'/v1/{parent=users/*}:importSshPublicKey:\x0essh_public_key\x12\xaf\x01\n\x12UpdateSshPublicKey\x12\x32.google.cloud.oslogin.v1.UpdateSshPublicKeyRequest\x1a).google.cloud.oslogin.common.SshPublicKey":\x82\xd3\xe4\x93\x02\x34\x32"/v1/{name=users/*/sshPublicKeys/*}:\x0essh_public_keyB\xa1\x01\n\x1b\x63om.google.cloud.oslogin.v1B\x0cOsLoginProtoP\x01Z>google.golang.org/genproto/googleapis/cloud/oslogin/v1;oslogin\xaa\x02\x17Google.Cloud.OsLogin.V1\xca\x02\x17Google\\Cloud\\OsLogin\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGINPROFILE_SSHPUBLICKEYSENTRY = _descriptor.Descriptor(
+    name="SshPublicKeysEntry",
+    full_name="google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=407,
+    serialized_end=502,
+)
+
+_LOGINPROFILE = _descriptor.Descriptor(
+    name="LoginProfile",
+    full_name="google.cloud.oslogin.v1.LoginProfile",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.LoginProfile.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posix_accounts",
+            full_name="google.cloud.oslogin.v1.LoginProfile.posix_accounts",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssh_public_keys",
+            full_name="google.cloud.oslogin.v1.LoginProfile.ssh_public_keys",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="suspended",
+            full_name="google.cloud.oslogin.v1.LoginProfile.suspended",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LOGINPROFILE_SSHPUBLICKEYSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=208,
+    serialized_end=502,
+)
+
+
+_DELETEPOSIXACCOUNTREQUEST = _descriptor.Descriptor(
+    name="DeletePosixAccountRequest",
+    full_name="google.cloud.oslogin.v1.DeletePosixAccountRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.DeletePosixAccountRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=504,
+    serialized_end=545,
+)
+
+
+_DELETESSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="DeleteSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.DeleteSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.DeleteSshPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=547,
+    serialized_end=588,
+)
+
+
+_GETLOGINPROFILEREQUEST = _descriptor.Descriptor(
+    name="GetLoginProfileRequest",
+    full_name="google.cloud.oslogin.v1.GetLoginProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.GetLoginProfileRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=590,
+    serialized_end=628,
+)
+
+
+_GETSSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="GetSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.GetSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.GetSshPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=630,
+    serialized_end=668,
+)
+
+
+_IMPORTSSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="ImportSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssh_public_key",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest.ssh_public_key",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest.project_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=671,
+    serialized_end=801,
+)
+
+
+_IMPORTSSHPUBLICKEYRESPONSE = _descriptor.Descriptor(
+    name="ImportSshPublicKeyResponse",
+    full_name="google.cloud.oslogin.v1.ImportSshPublicKeyResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="login_profile",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyResponse.login_profile",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=803,
+    serialized_end=893,
+)
+
+
+_UPDATESSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="UpdateSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssh_public_key",
+            full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest.ssh_public_key",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=896,
+    serialized_end=1053,
+)
+
+_LOGINPROFILE_SSHPUBLICKEYSENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY
+_LOGINPROFILE_SSHPUBLICKEYSENTRY.containing_type = _LOGINPROFILE
+_LOGINPROFILE.fields_by_name[
+    "posix_accounts"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._POSIXACCOUNT
+_LOGINPROFILE.fields_by_name[
+    "ssh_public_keys"
+].message_type = _LOGINPROFILE_SSHPUBLICKEYSENTRY
+_IMPORTSSHPUBLICKEYREQUEST.fields_by_name[
+    "ssh_public_key"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY
+_IMPORTSSHPUBLICKEYRESPONSE.fields_by_name["login_profile"].message_type = _LOGINPROFILE
+_UPDATESSHPUBLICKEYREQUEST.fields_by_name[
+    "ssh_public_key"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY
+_UPDATESSHPUBLICKEYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+DESCRIPTOR.message_types_by_name["LoginProfile"] = _LOGINPROFILE
+DESCRIPTOR.message_types_by_name[
+    "DeletePosixAccountRequest"
+] = _DELETEPOSIXACCOUNTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteSshPublicKeyRequest"
+] = _DELETESSHPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name["GetLoginProfileRequest"] = _GETLOGINPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["GetSshPublicKeyRequest"] = _GETSSHPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportSshPublicKeyRequest"
+] = _IMPORTSSHPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportSshPublicKeyResponse"
+] = _IMPORTSSHPUBLICKEYRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "UpdateSshPublicKeyRequest"
+] = _UPDATESSHPUBLICKEYREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LoginProfile = _reflection.GeneratedProtocolMessageType(
+    "LoginProfile",
+    (_message.Message,),
+    dict(
+        SshPublicKeysEntry=_reflection.GeneratedProtocolMessageType(
+            "SshPublicKeysEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOGINPROFILE_SSHPUBLICKEYSENTRY,
+                __module__="google.cloud.oslogin_v1.proto.oslogin_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOGINPROFILE,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""The user profile information used for logging in to a virtual machine on
+  Google Compute Engine.
+  
+  
+  Attributes:
+      name:
+          The primary email address that uniquely identifies the user.
+      posix_accounts:
+          The list of POSIX accounts associated with the user.
+      ssh_public_keys:
+          A map from SSH public key fingerprint to the associated key
+          object.
+      suspended:
+          Indicates if the user is suspended. A suspended user cannot
+          log in but their profile information is retained.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.LoginProfile)
+    ),
+)
+_sym_db.RegisterMessage(LoginProfile)
+_sym_db.RegisterMessage(LoginProfile.SshPublicKeysEntry)
+
+DeletePosixAccountRequest = _reflection.GeneratedProtocolMessageType(
+    "DeletePosixAccountRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPOSIXACCOUNTREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for deleting a POSIX account entry.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.DeletePosixAccountRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeletePosixAccountRequest)
+
+DeleteSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for deleting an SSH public key.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.DeleteSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSshPublicKeyRequest)
+
+GetLoginProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "GetLoginProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETLOGINPROFILEREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for retrieving the login profile information for a
+  user.
+  
+  
+  Attributes:
+      name:
+          The unique ID for the user in format ``users/{user}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.GetLoginProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetLoginProfileRequest)
+
+GetSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for retrieving an SSH public key.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.GetSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSshPublicKeyRequest)
+
+ImportSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTSSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for importing an SSH public key.
+  
+  
+  Attributes:
+      parent:
+          The unique ID for the user in format ``users/{user}``.
+      ssh_public_key:
+          The SSH public key and expiration time.
+      project_id:
+          The project ID of the Google Cloud Platform project.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.ImportSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportSshPublicKeyRequest)
+
+ImportSshPublicKeyResponse = _reflection.GeneratedProtocolMessageType(
+    "ImportSshPublicKeyResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTSSHPUBLICKEYRESPONSE,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A response message for importing an SSH public key.
+  
+  
+  Attributes:
+      login_profile:
+          The login profile information for the user.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.ImportSshPublicKeyResponse)
+    ),
+)
+_sym_db.RegisterMessage(ImportSshPublicKeyResponse)
+
+UpdateSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for updating an SSH public key.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      ssh_public_key:
+          The SSH public key and expiration time.
+      update_mask:
+          Mask to control which fields get updated. Updates all if not
+          present.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.UpdateSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSshPublicKeyRequest)
+
+
+DESCRIPTOR._options = None
+_LOGINPROFILE_SSHPUBLICKEYSENTRY._options = None
+
+_OSLOGINSERVICE = _descriptor.ServiceDescriptor(
+    name="OsLoginService",
+    full_name="google.cloud.oslogin.v1.OsLoginService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1056,
+    serialized_end=2029,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="DeletePosixAccount",
+            full_name="google.cloud.oslogin.v1.OsLoginService.DeletePosixAccount",
+            index=0,
+            containing_service=None,
+            input_type=_DELETEPOSIXACCOUNTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\037*\035/v1/{name=users/*/projects/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.DeleteSshPublicKey",
+            index=1,
+            containing_service=None,
+            input_type=_DELETESSHPUBLICKEYREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002$*"/v1/{name=users/*/sshPublicKeys/*}'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetLoginProfile",
+            full_name="google.cloud.oslogin.v1.OsLoginService.GetLoginProfile",
+            index=2,
+            containing_service=None,
+            input_type=_GETLOGINPROFILEREQUEST,
+            output_type=_LOGINPROFILE,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v1/{name=users/*}/loginProfile"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.GetSshPublicKey",
+            index=3,
+            containing_service=None,
+            input_type=_GETSSHPUBLICKEYREQUEST,
+            output_type=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY,
+            serialized_options=_b(
+                '\202\323\344\223\002$\022"/v1/{name=users/*/sshPublicKeys/*}'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.ImportSshPublicKey",
+            index=4,
+            containing_service=None,
+            input_type=_IMPORTSSHPUBLICKEYREQUEST,
+            output_type=_IMPORTSSHPUBLICKEYRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0029\"'/v1/{parent=users/*}:importSshPublicKey:\016ssh_public_key"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.UpdateSshPublicKey",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATESSHPUBLICKEYREQUEST,
+            output_type=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY,
+            serialized_options=_b(
+                '\202\323\344\223\00242"/v1/{name=users/*/sshPublicKeys/*}:\016ssh_public_key'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_OSLOGINSERVICE)
+
+DESCRIPTOR.services_by_name["OsLoginService"] = _OSLOGINSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin_pb2_grpc.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin_pb2_grpc.py
new file mode 100644
index 000000000000..6b002666a67b
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin_pb2_grpc.py
@@ -0,0 +1,148 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.oslogin_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2,
+)
+from google.cloud.oslogin_v1.proto import (
+    oslogin_pb2 as google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class OsLoginServiceStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.DeletePosixAccount = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/DeletePosixAccount",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeletePosixAccountRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.DeleteSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/DeleteSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeleteSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetLoginProfile = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/GetLoginProfile",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetLoginProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.LoginProfile.FromString,
+        )
+        self.GetSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/GetSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.FromString,
+        )
+        self.ImportSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/ImportSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyResponse.FromString,
+        )
+        self.UpdateSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/UpdateSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.UpdateSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.FromString,
+        )
+
+
+class OsLoginServiceServicer(object):
+    """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.
+  """
+
+    def DeletePosixAccount(self, request, context):
+        """Deletes a POSIX account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSshPublicKey(self, request, context):
+        """Deletes an SSH public key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetLoginProfile(self, request, context):
+        """Retrieves the profile information used for logging in to a virtual machine
+    on Google Compute Engine.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSshPublicKey(self, request, context):
+        """Retrieves an SSH public key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportSshPublicKey(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSshPublicKey(self, request, context):
+        """Updates an SSH public key and returns the profile information. This method
+    supports patch semantics.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_OsLoginServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "DeletePosixAccount": grpc.unary_unary_rpc_method_handler(
+            servicer.DeletePosixAccount,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeletePosixAccountRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "DeleteSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeleteSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetLoginProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.GetLoginProfile,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetLoginProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.LoginProfile.SerializeToString,
+        ),
+        "GetSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.SerializeToString,
+        ),
+        "ImportSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyResponse.SerializeToString,
+        ),
+        "UpdateSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.UpdateSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.oslogin.v1.OsLoginService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/__init__.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/oslogin_pb2.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/oslogin_pb2.py
new file mode 100644
index 000000000000..11ba220ecfdc
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/oslogin_pb2.py
@@ -0,0 +1,848 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/oslogin_v1/proto/oslogin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.oslogin_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/oslogin_v1/proto/oslogin.proto",
+    package="google.cloud.oslogin.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\033com.google.cloud.oslogin.v1B\014OsLoginProtoP\001Z>google.golang.org/genproto/googleapis/cloud/oslogin/v1;oslogin\252\002\027Google.Cloud.OsLogin.V1\312\002\027Google\\Cloud\\OsLogin\\V1"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/oslogin_v1/proto/oslogin.proto\x12\x17google.cloud.oslogin.v1\x1a\x1cgoogle/api/annotations.proto\x1a(google/cloud/oslogin/common/common.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\xa6\x02\n\x0cLoginProfile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x41\n\x0eposix_accounts\x18\x02 \x03(\x0b\x32).google.cloud.oslogin.common.PosixAccount\x12Q\n\x0fssh_public_keys\x18\x03 \x03(\x0b\x32\x38.google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry\x12\x11\n\tsuspended\x18\x04 \x01(\x08\x1a_\n\x12SshPublicKeysEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x38\n\x05value\x18\x02 \x01(\x0b\x32).google.cloud.oslogin.common.SshPublicKey:\x02\x38\x01")\n\x19\x44\x65letePosixAccountRequest\x12\x0c\n\x04name\x18\x01 \x01(\t")\n\x19\x44\x65leteSshPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"&\n\x16GetLoginProfileRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"&\n\x16GetSshPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x82\x01\n\x19ImportSshPublicKeyRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x41\n\x0essh_public_key\x18\x02 \x01(\x0b\x32).google.cloud.oslogin.common.SshPublicKey\x12\x12\n\nproject_id\x18\x03 \x01(\t"Z\n\x1aImportSshPublicKeyResponse\x12<\n\rlogin_profile\x18\x01 \x01(\x0b\x32%.google.cloud.oslogin.v1.LoginProfile"\x9d\x01\n\x19UpdateSshPublicKeyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x41\n\x0essh_public_key\x18\x02 \x01(\x0b\x32).google.cloud.oslogin.common.SshPublicKey\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask2\xcd\x07\n\x0eOsLoginService\x12\x87\x01\n\x12\x44\x65letePosixAccount\x12\x32.google.cloud.oslogin.v1.DeletePosixAccountRequest\x1a\x16.google.protobuf.Empty"%\x82\xd3\xe4\x93\x02\x1f*\x1d/v1/{name=users/*/projects/*}\x12\x8c\x01\n\x12\x44\x65leteSshPublicKey\x12\x32.google.cloud.oslogin.v1.DeleteSshPublicKeyRequest\x1a\x16.google.protobuf.Empty"*\x82\xd3\xe4\x93\x02$*"/v1/{name=users/*/sshPublicKeys/*}\x12\x92\x01\n\x0fGetLoginProfile\x12/.google.cloud.oslogin.v1.GetLoginProfileRequest\x1a%.google.cloud.oslogin.v1.LoginProfile"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v1/{name=users/*}/loginProfile\x12\x99\x01\n\x0fGetSshPublicKey\x12/.google.cloud.oslogin.v1.GetSshPublicKeyRequest\x1a).google.cloud.oslogin.common.SshPublicKey"*\x82\xd3\xe4\x93\x02$\x12"/v1/{name=users/*/sshPublicKeys/*}\x12\xbe\x01\n\x12ImportSshPublicKey\x12\x32.google.cloud.oslogin.v1.ImportSshPublicKeyRequest\x1a\x33.google.cloud.oslogin.v1.ImportSshPublicKeyResponse"?\x82\xd3\xe4\x93\x02\x39"\'/v1/{parent=users/*}:importSshPublicKey:\x0essh_public_key\x12\xaf\x01\n\x12UpdateSshPublicKey\x12\x32.google.cloud.oslogin.v1.UpdateSshPublicKeyRequest\x1a).google.cloud.oslogin.common.SshPublicKey":\x82\xd3\xe4\x93\x02\x34\x32"/v1/{name=users/*/sshPublicKeys/*}:\x0essh_public_keyB\xa1\x01\n\x1b\x63om.google.cloud.oslogin.v1B\x0cOsLoginProtoP\x01Z>google.golang.org/genproto/googleapis/cloud/oslogin/v1;oslogin\xaa\x02\x17Google.Cloud.OsLogin.V1\xca\x02\x17Google\\Cloud\\OsLogin\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOGINPROFILE_SSHPUBLICKEYSENTRY = _descriptor.Descriptor(
+    name="SshPublicKeysEntry",
+    full_name="google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=407,
+    serialized_end=502,
+)
+
+_LOGINPROFILE = _descriptor.Descriptor(
+    name="LoginProfile",
+    full_name="google.cloud.oslogin.v1.LoginProfile",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.LoginProfile.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posix_accounts",
+            full_name="google.cloud.oslogin.v1.LoginProfile.posix_accounts",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssh_public_keys",
+            full_name="google.cloud.oslogin.v1.LoginProfile.ssh_public_keys",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="suspended",
+            full_name="google.cloud.oslogin.v1.LoginProfile.suspended",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LOGINPROFILE_SSHPUBLICKEYSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=208,
+    serialized_end=502,
+)
+
+
+_DELETEPOSIXACCOUNTREQUEST = _descriptor.Descriptor(
+    name="DeletePosixAccountRequest",
+    full_name="google.cloud.oslogin.v1.DeletePosixAccountRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.DeletePosixAccountRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=504,
+    serialized_end=545,
+)
+
+
+_DELETESSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="DeleteSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.DeleteSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.DeleteSshPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=547,
+    serialized_end=588,
+)
+
+
+_GETLOGINPROFILEREQUEST = _descriptor.Descriptor(
+    name="GetLoginProfileRequest",
+    full_name="google.cloud.oslogin.v1.GetLoginProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.GetLoginProfileRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=590,
+    serialized_end=628,
+)
+
+
+_GETSSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="GetSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.GetSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.GetSshPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=630,
+    serialized_end=668,
+)
+
+
+_IMPORTSSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="ImportSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssh_public_key",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest.ssh_public_key",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyRequest.project_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=671,
+    serialized_end=801,
+)
+
+
+_IMPORTSSHPUBLICKEYRESPONSE = _descriptor.Descriptor(
+    name="ImportSshPublicKeyResponse",
+    full_name="google.cloud.oslogin.v1.ImportSshPublicKeyResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="login_profile",
+            full_name="google.cloud.oslogin.v1.ImportSshPublicKeyResponse.login_profile",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=803,
+    serialized_end=893,
+)
+
+
+_UPDATESSHPUBLICKEYREQUEST = _descriptor.Descriptor(
+    name="UpdateSshPublicKeyRequest",
+    full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssh_public_key",
+            full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest.ssh_public_key",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.oslogin.v1.UpdateSshPublicKeyRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=896,
+    serialized_end=1053,
+)
+
+_LOGINPROFILE_SSHPUBLICKEYSENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY
+_LOGINPROFILE_SSHPUBLICKEYSENTRY.containing_type = _LOGINPROFILE
+_LOGINPROFILE.fields_by_name[
+    "posix_accounts"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._POSIXACCOUNT
+_LOGINPROFILE.fields_by_name[
+    "ssh_public_keys"
+].message_type = _LOGINPROFILE_SSHPUBLICKEYSENTRY
+_IMPORTSSHPUBLICKEYREQUEST.fields_by_name[
+    "ssh_public_key"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY
+_IMPORTSSHPUBLICKEYRESPONSE.fields_by_name["login_profile"].message_type = _LOGINPROFILE
+_UPDATESSHPUBLICKEYREQUEST.fields_by_name[
+    "ssh_public_key"
+].message_type = google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY
+_UPDATESSHPUBLICKEYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+DESCRIPTOR.message_types_by_name["LoginProfile"] = _LOGINPROFILE
+DESCRIPTOR.message_types_by_name[
+    "DeletePosixAccountRequest"
+] = _DELETEPOSIXACCOUNTREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteSshPublicKeyRequest"
+] = _DELETESSHPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name["GetLoginProfileRequest"] = _GETLOGINPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["GetSshPublicKeyRequest"] = _GETSSHPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportSshPublicKeyRequest"
+] = _IMPORTSSHPUBLICKEYREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportSshPublicKeyResponse"
+] = _IMPORTSSHPUBLICKEYRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "UpdateSshPublicKeyRequest"
+] = _UPDATESSHPUBLICKEYREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+LoginProfile = _reflection.GeneratedProtocolMessageType(
+    "LoginProfile",
+    (_message.Message,),
+    dict(
+        SshPublicKeysEntry=_reflection.GeneratedProtocolMessageType(
+            "SshPublicKeysEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOGINPROFILE_SSHPUBLICKEYSENTRY,
+                __module__="google.cloud.oslogin_v1.proto.oslogin_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.LoginProfile.SshPublicKeysEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOGINPROFILE,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""The user profile information used for logging in to a virtual machine on
+  Google Compute Engine.
+  
+  
+  Attributes:
+      name:
+          The primary email address that uniquely identifies the user.
+      posix_accounts:
+          The list of POSIX accounts associated with the user.
+      ssh_public_keys:
+          A map from SSH public key fingerprint to the associated key
+          object.
+      suspended:
+          Indicates if the user is suspended. A suspended user cannot
+          log in but their profile information is retained.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.LoginProfile)
+    ),
+)
+_sym_db.RegisterMessage(LoginProfile)
+_sym_db.RegisterMessage(LoginProfile.SshPublicKeysEntry)
+
+DeletePosixAccountRequest = _reflection.GeneratedProtocolMessageType(
+    "DeletePosixAccountRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPOSIXACCOUNTREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for deleting a POSIX account entry.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.DeletePosixAccountRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeletePosixAccountRequest)
+
+DeleteSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for deleting an SSH public key.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.DeleteSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSshPublicKeyRequest)
+
+GetLoginProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "GetLoginProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETLOGINPROFILEREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for retrieving the login profile information for a
+  user.
+  
+  
+  Attributes:
+      name:
+          The unique ID for the user in format ``users/{user}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.GetLoginProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetLoginProfileRequest)
+
+GetSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for retrieving an SSH public key.
+  
+  
+  Attributes:
+      name:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.GetSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSshPublicKeyRequest)
+
+ImportSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTSSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for importing an SSH public key.
+  
+  
+  Attributes:
+      parent:
+          The unique ID for the user in format ``users/{user}``.
+      ssh_public_key:
+          The SSH public key and expiration time.
+      project_id:
+          The project ID of the Google Cloud Platform project.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.ImportSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportSshPublicKeyRequest)
+
+ImportSshPublicKeyResponse = _reflection.GeneratedProtocolMessageType(
+    "ImportSshPublicKeyResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTSSHPUBLICKEYRESPONSE,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A response message for importing an SSH public key.
+  
+  
+  Attributes:
+      login_profile:
+          The login profile information for the user.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.ImportSshPublicKeyResponse)
+    ),
+)
+_sym_db.RegisterMessage(ImportSshPublicKeyResponse)
+
+UpdateSshPublicKeyRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSshPublicKeyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESSHPUBLICKEYREQUEST,
+        __module__="google.cloud.oslogin_v1.proto.oslogin_pb2",
+        __doc__="""A request message for updating an SSH public key.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      ssh_public_key:
+          The SSH public key and expiration time.
+      update_mask:
+          Mask to control which fields get updated. Updates all if not
+          present.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.oslogin.v1.UpdateSshPublicKeyRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSshPublicKeyRequest)
+
+
+DESCRIPTOR._options = None
+_LOGINPROFILE_SSHPUBLICKEYSENTRY._options = None
+
+_OSLOGINSERVICE = _descriptor.ServiceDescriptor(
+    name="OsLoginService",
+    full_name="google.cloud.oslogin.v1.OsLoginService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1056,
+    serialized_end=2029,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="DeletePosixAccount",
+            full_name="google.cloud.oslogin.v1.OsLoginService.DeletePosixAccount",
+            index=0,
+            containing_service=None,
+            input_type=_DELETEPOSIXACCOUNTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\037*\035/v1/{name=users/*/projects/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.DeleteSshPublicKey",
+            index=1,
+            containing_service=None,
+            input_type=_DELETESSHPUBLICKEYREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002$*"/v1/{name=users/*/sshPublicKeys/*}'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetLoginProfile",
+            full_name="google.cloud.oslogin.v1.OsLoginService.GetLoginProfile",
+            index=2,
+            containing_service=None,
+            input_type=_GETLOGINPROFILEREQUEST,
+            output_type=_LOGINPROFILE,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v1/{name=users/*}/loginProfile"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.GetSshPublicKey",
+            index=3,
+            containing_service=None,
+            input_type=_GETSSHPUBLICKEYREQUEST,
+            output_type=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY,
+            serialized_options=_b(
+                '\202\323\344\223\002$\022"/v1/{name=users/*/sshPublicKeys/*}'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.ImportSshPublicKey",
+            index=4,
+            containing_service=None,
+            input_type=_IMPORTSSHPUBLICKEYREQUEST,
+            output_type=_IMPORTSSHPUBLICKEYRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0029\"'/v1/{parent=users/*}:importSshPublicKey:\016ssh_public_key"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSshPublicKey",
+            full_name="google.cloud.oslogin.v1.OsLoginService.UpdateSshPublicKey",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATESSHPUBLICKEYREQUEST,
+            output_type=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2._SSHPUBLICKEY,
+            serialized_options=_b(
+                '\202\323\344\223\00242"/v1/{name=users/*/sshPublicKeys/*}:\016ssh_public_key'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_OSLOGINSERVICE)
+
+DESCRIPTOR.services_by_name["OsLoginService"] = _OSLOGINSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/oslogin_pb2_grpc.py b/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/oslogin_pb2_grpc.py
new file mode 100644
index 000000000000..6b002666a67b
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/proto/oslogin_v1/proto/oslogin_pb2_grpc.py
@@ -0,0 +1,148 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.oslogin_v1.proto import (
+    common_pb2 as google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2,
+)
+from google.cloud.oslogin_v1.proto import (
+    oslogin_pb2 as google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class OsLoginServiceStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.DeletePosixAccount = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/DeletePosixAccount",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeletePosixAccountRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.DeleteSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/DeleteSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeleteSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetLoginProfile = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/GetLoginProfile",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetLoginProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.LoginProfile.FromString,
+        )
+        self.GetSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/GetSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.FromString,
+        )
+        self.ImportSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/ImportSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyResponse.FromString,
+        )
+        self.UpdateSshPublicKey = channel.unary_unary(
+            "/google.cloud.oslogin.v1.OsLoginService/UpdateSshPublicKey",
+            request_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.UpdateSshPublicKeyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.FromString,
+        )
+
+
+class OsLoginServiceServicer(object):
+    """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.
+  """
+
+    def DeletePosixAccount(self, request, context):
+        """Deletes a POSIX account.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSshPublicKey(self, request, context):
+        """Deletes an SSH public key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetLoginProfile(self, request, context):
+        """Retrieves the profile information used for logging in to a virtual machine
+    on Google Compute Engine.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSshPublicKey(self, request, context):
+        """Retrieves an SSH public key.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportSshPublicKey(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSshPublicKey(self, request, context):
+        """Updates an SSH public key and returns the profile information. This method
+    supports patch semantics.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_OsLoginServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "DeletePosixAccount": grpc.unary_unary_rpc_method_handler(
+            servicer.DeletePosixAccount,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeletePosixAccountRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "DeleteSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.DeleteSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetLoginProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.GetLoginProfile,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetLoginProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.LoginProfile.SerializeToString,
+        ),
+        "GetSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.GetSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.SerializeToString,
+        ),
+        "ImportSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.ImportSshPublicKeyResponse.SerializeToString,
+        ),
+        "UpdateSshPublicKey": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSshPublicKey,
+            request_deserializer=google_dot_cloud_dot_oslogin__v1_dot_proto_dot_oslogin__pb2.UpdateSshPublicKeyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_oslogin_dot_common_dot_common__pb2.SshPublicKey.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.oslogin.v1.OsLoginService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/oslogin/google/cloud/oslogin_v1/types.py b/oslogin/google/cloud/oslogin_v1/types.py
new file mode 100644
index 000000000000..44770325b204
--- /dev/null
+++ b/oslogin/google/cloud/oslogin_v1/types.py
@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.oslogin_v1.proto import common_pb2
+from google.cloud.oslogin_v1.proto import oslogin_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_shared_modules = [common_pb2, empty_pb2, field_mask_pb2]
+
+_local_modules = [oslogin_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.oslogin_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/oslogin/noxfile.py b/oslogin/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/oslogin/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/oslogin/setup.cfg b/oslogin/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/oslogin/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/oslogin/setup.py b/oslogin/setup.py
new file mode 100644
index 000000000000..9dac06f68a57
--- /dev/null
+++ b/oslogin/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-os-login"
+description = "Google Cloud OS Login API client library"
+version = "0.2.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/oslogin/synth.metadata b/oslogin/synth.metadata
new file mode 100644
index 000000000000..56d7ccd28794
--- /dev/null
+++ b/oslogin/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:33:01.454928Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "oslogin",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/oslogin/artman_oslogin_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/oslogin/synth.py b/oslogin/synth.py
new file mode 100644
index 000000000000..7e76e18b1c4e
--- /dev/null
+++ b/oslogin/synth.py
@@ -0,0 +1,49 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate oslogin GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "oslogin",
+    "v1",
+    config_path="/google/cloud/oslogin/artman_oslogin_v1.yaml",
+    artman_output_name="os-login-v1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/oslogin_v1")
+s.move(library / "tests/unit/gapic/v1")
+
+# Fix up imports
+s.replace(
+    "google/**/proto/*.py",
+    "from google.cloud.oslogin.common import common_pb2",
+    "from google.cloud.oslogin_v1.proto import common_pb2",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/oslogin/tests/unit/gapic/v1/test_os_login_service_client_v1.py b/oslogin/tests/unit/gapic/v1/test_os_login_service_client_v1.py
new file mode 100644
index 000000000000..18506c0d6859
--- /dev/null
+++ b/oslogin/tests/unit/gapic/v1/test_os_login_service_client_v1.py
@@ -0,0 +1,297 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import oslogin_v1
+from google.cloud.oslogin_v1.proto import common_pb2
+from google.cloud.oslogin_v1.proto import oslogin_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestOsLoginServiceClient(object):
+    def test_delete_posix_account(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup Request
+        name = client.project_path("[USER]", "[PROJECT]")
+
+        client.delete_posix_account(name)
+
+        assert len(channel.requests) == 1
+        expected_request = oslogin_pb2.DeletePosixAccountRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_posix_account_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup request
+        name = client.project_path("[USER]", "[PROJECT]")
+
+        with pytest.raises(CustomException):
+            client.delete_posix_account(name)
+
+    def test_delete_ssh_public_key(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup Request
+        name = client.fingerprint_path("[USER]", "[FINGERPRINT]")
+
+        client.delete_ssh_public_key(name)
+
+        assert len(channel.requests) == 1
+        expected_request = oslogin_pb2.DeleteSshPublicKeyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_ssh_public_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup request
+        name = client.fingerprint_path("[USER]", "[FINGERPRINT]")
+
+        with pytest.raises(CustomException):
+            client.delete_ssh_public_key(name)
+
+    def test_get_login_profile(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        suspended = False
+        expected_response = {"name": name_2, "suspended": suspended}
+        expected_response = oslogin_pb2.LoginProfile(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup Request
+        name = client.user_path("[USER]")
+
+        response = client.get_login_profile(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = oslogin_pb2.GetLoginProfileRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_login_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup request
+        name = client.user_path("[USER]")
+
+        with pytest.raises(CustomException):
+            client.get_login_profile(name)
+
+    def test_get_ssh_public_key(self):
+        # Setup Expected Response
+        key = "key106079"
+        expiration_time_usec = 2058878882
+        fingerprint = "fingerprint-1375934236"
+        expected_response = {
+            "key": key,
+            "expiration_time_usec": expiration_time_usec,
+            "fingerprint": fingerprint,
+        }
+        expected_response = common_pb2.SshPublicKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup Request
+        name = client.fingerprint_path("[USER]", "[FINGERPRINT]")
+
+        response = client.get_ssh_public_key(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = oslogin_pb2.GetSshPublicKeyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_ssh_public_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup request
+        name = client.fingerprint_path("[USER]", "[FINGERPRINT]")
+
+        with pytest.raises(CustomException):
+            client.get_ssh_public_key(name)
+
+    def test_import_ssh_public_key(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = oslogin_pb2.ImportSshPublicKeyResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup Request
+        parent = client.user_path("[USER]")
+        ssh_public_key = {}
+
+        response = client.import_ssh_public_key(parent, ssh_public_key)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = oslogin_pb2.ImportSshPublicKeyRequest(
+            parent=parent, ssh_public_key=ssh_public_key
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_ssh_public_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup request
+        parent = client.user_path("[USER]")
+        ssh_public_key = {}
+
+        with pytest.raises(CustomException):
+            client.import_ssh_public_key(parent, ssh_public_key)
+
+    def test_update_ssh_public_key(self):
+        # Setup Expected Response
+        key = "key106079"
+        expiration_time_usec = 2058878882
+        fingerprint = "fingerprint-1375934236"
+        expected_response = {
+            "key": key,
+            "expiration_time_usec": expiration_time_usec,
+            "fingerprint": fingerprint,
+        }
+        expected_response = common_pb2.SshPublicKey(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup Request
+        name = client.fingerprint_path("[USER]", "[FINGERPRINT]")
+        ssh_public_key = {}
+
+        response = client.update_ssh_public_key(name, ssh_public_key)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = oslogin_pb2.UpdateSshPublicKeyRequest(
+            name=name, ssh_public_key=ssh_public_key
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_ssh_public_key_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = oslogin_v1.OsLoginServiceClient()
+
+        # Setup request
+        name = client.fingerprint_path("[USER]", "[FINGERPRINT]")
+        ssh_public_key = {}
+
+        with pytest.raises(CustomException):
+            client.update_ssh_public_key(name, ssh_public_key)
diff --git a/phishingprotection/.coveragerc b/phishingprotection/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/phishingprotection/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/phishingprotection/.flake8 b/phishingprotection/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/phishingprotection/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/phishingprotection/.repo-metadata.json b/phishingprotection/.repo-metadata.json
new file mode 100644
index 000000000000..a4ba9d9f6425
--- /dev/null
+++ b/phishingprotection/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "phishingprotection",
+  "name_pretty": "Phishing Protection",
+  "product_documentation": "https://cloud.google.com/phishing-protection/docs/",
+  "client_documentation": "https://googleapis.dev/python/phishingprotection/latest",
+  "issue_tracker": "",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-phishingprotection",
+  "api_id": "phishingprotection.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/phishingprotection/CHANGELOG.md b/phishingprotection/CHANGELOG.md
new file mode 100644
index 000000000000..5054a4350d8f
--- /dev/null
+++ b/phishingprotection/CHANGELOG.md
@@ -0,0 +1,13 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-phishing-protection/#history
+
+## 0.1.0
+
+04-30-2019 15:03 PDT
+
+### New Features
+- Initial release of Phishing Protection. ([#7801](https://github.com/googleapis/google-cloud-python/pull/7801))
+
diff --git a/phishingprotection/LICENSE b/phishingprotection/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/phishingprotection/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/phishingprotection/MANIFEST.in b/phishingprotection/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/phishingprotection/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/phishingprotection/README.rst b/phishingprotection/README.rst
new file mode 100644
index 000000000000..58cb992e608a
--- /dev/null
+++ b/phishingprotection/README.rst
@@ -0,0 +1,77 @@
+Python Client for Phishing Protection API (`Alpha`_)
+====================================================
+
+
+
+`Phishing Protection API`_:
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Phishing Protection API: https://cloud.google.com/phishing-protection
+.. _Client Library Documentation: https://googleapis.dev/python/phishingprotection/latest/
+.. _Product Documentation:  https://cloud.google.com/phishing-protection
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Phishing Protection API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Phishing Protection API.:  https://cloud.google.com/phishing-protection
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-phishing-protection
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-phishing-protection
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Phishing Protection API
+   API to see other available methods on the client.
+-  Read the `Phishing Protection API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Phishing Protection API Product documentation:  https://cloud.google.com/phishing-protection
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/phishingprotection/docs/README.rst b/phishingprotection/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/phishingprotection/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/phishingprotection/docs/changelog.md b/phishingprotection/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/phishingprotection/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/phishingprotection/docs/conf.py b/phishingprotection/docs/conf.py
new file mode 100644
index 000000000000..3ae6ea620720
--- /dev/null
+++ b/phishingprotection/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-phishingprotection documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-phishingprotection"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-phishingprotection-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-phishingprotection.tex",
+        u"google-cloud-phishingprotection Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-phishingprotection",
+        u"google-cloud-phishingprotection Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-phishingprotection",
+        u"google-cloud-phishingprotection Documentation",
+        author,
+        "google-cloud-phishingprotection",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/phishingprotection/docs/gapic/v1beta1/api.rst b/phishingprotection/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..a69876f41527
--- /dev/null
+++ b/phishingprotection/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Phishing Protection API
+==================================
+
+.. automodule:: google.cloud.phishingprotection_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/phishingprotection/docs/gapic/v1beta1/types.rst b/phishingprotection/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..a14e187bbffb
--- /dev/null
+++ b/phishingprotection/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Phishing Protection API Client
+========================================
+
+.. automodule:: google.cloud.phishingprotection_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/phishingprotection/docs/index.rst b/phishingprotection/docs/index.rst
new file mode 100644
index 000000000000..e2a1a304cac3
--- /dev/null
+++ b/phishingprotection/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+
+
+Changelog
+----------
+
+For all previous ``google-cloud-phishingprotection`` releases:
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
diff --git a/phishingprotection/google/__init__.py b/phishingprotection/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/phishingprotection/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/phishingprotection/google/cloud/__init__.py b/phishingprotection/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/phishingprotection/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/phishingprotection/google/cloud/phishingprotection.py b/phishingprotection/google/cloud/phishingprotection.py
new file mode 100644
index 000000000000..6ecd979bcb45
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.phishingprotection_v1beta1 import PhishingProtectionServiceClient
+from google.cloud.phishingprotection_v1beta1 import types
+
+
+__all__ = ("types", "PhishingProtectionServiceClient")
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/__init__.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/__init__.py
new file mode 100644
index 000000000000..e43500ba5b5f
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/__init__.py
@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.phishingprotection_v1beta1 import types
+from google.cloud.phishingprotection_v1beta1.gapic import (
+    phishing_protection_service_client,
+)
+
+
+class PhishingProtectionServiceClient(
+    phishing_protection_service_client.PhishingProtectionServiceClient
+):
+    __doc__ = phishing_protection_service_client.PhishingProtectionServiceClient.__doc__
+
+
+__all__ = ("types", "PhishingProtectionServiceClient")
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/__init__.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/phishing_protection_service_client.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/phishing_protection_service_client.py
new file mode 100644
index 000000000000..add1fc161b35
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/phishing_protection_service_client.py
@@ -0,0 +1,278 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.phishingprotection.v1beta1 PhishingProtectionServiceV1Beta1 API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.phishingprotection_v1beta1.gapic import (
+    phishing_protection_service_client_config,
+)
+from google.cloud.phishingprotection_v1beta1.gapic.transports import (
+    phishing_protection_service_grpc_transport,
+)
+from google.cloud.phishingprotection_v1beta1.proto import phishingprotection_pb2
+from google.cloud.phishingprotection_v1beta1.proto import phishingprotection_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-phishing-protection"
+).version
+
+
+class PhishingProtectionServiceClient(object):
+    """Service to report phishing URIs."""
+
+    SERVICE_ADDRESS = "phishingprotection.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = (
+        "google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1"
+    )
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            PhishingProtectionServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.PhishingProtectionServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.PhishingProtectionServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = phishing_protection_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=phishing_protection_service_grpc_transport.PhishingProtectionServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = phishing_protection_service_grpc_transport.PhishingProtectionServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def report_phishing(
+        self,
+        parent,
+        uri,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import phishingprotection_v1beta1
+            >>>
+            >>> client = phishingprotection_v1beta1.PhishingProtectionServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `uri`:
+            >>> uri = ''
+            >>>
+            >>> response = client.report_phishing(parent, uri)
+
+        Args:
+            parent (str): Required. The name of the project for which the report will be created,
+                in the format "projects/{project\_number}".
+            uri (str): The URI that is being reported for phishing content to be analyzed.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.phishingprotection_v1beta1.types.ReportPhishingResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "report_phishing" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "report_phishing"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.report_phishing,
+                default_retry=self._method_configs["ReportPhishing"].retry,
+                default_timeout=self._method_configs["ReportPhishing"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = phishingprotection_pb2.ReportPhishingRequest(parent=parent, uri=uri)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["report_phishing"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/phishing_protection_service_client_config.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/phishing_protection_service_client_config.py
new file mode 100644
index 000000000000..a765476f6f6a
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/phishing_protection_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ReportPhishing": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/transports/__init__.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/transports/phishing_protection_service_grpc_transport.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/transports/phishing_protection_service_grpc_transport.py
new file mode 100644
index 000000000000..8498f361b1ac
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/gapic/transports/phishing_protection_service_grpc_transport.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.phishingprotection_v1beta1.proto import phishingprotection_pb2_grpc
+
+
+class PhishingProtectionServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.phishingprotection.v1beta1 PhishingProtectionServiceV1Beta1 API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="phishingprotection.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "phishing_protection_service_v1_beta1_stub": phishingprotection_pb2_grpc.PhishingProtectionServiceV1Beta1Stub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="phishingprotection.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def report_phishing(self):
+        """Return the gRPC stub for :meth:`PhishingProtectionServiceClient.report_phishing`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["phishing_protection_service_v1_beta1_stub"].ReportPhishing
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/__init__.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection.proto b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection.proto
new file mode 100644
index 000000000000..62a9fd03e3df
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection.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.phishingprotection.v1beta1;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.PhishingProtection.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/phishingprotection/v1beta1;phishingprotection";
+option java_multiple_files = true;
+option java_outer_classname = "PhishingProtectionProto";
+option java_package = "com.google.phishingprotection.v1beta1";
+option objc_class_prefix = "GCPP";
+option php_namespace = "Google\\Cloud\\PhishingProtection\\V1beta1";
+
+// Service to report phishing URIs.
+service PhishingProtectionServiceV1Beta1 {
+  // 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.
+  rpc ReportPhishing(ReportPhishingRequest) returns (ReportPhishingResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/phishing:report"
+      body: "*"
+    };
+  }
+}
+
+// The ReportPhishing request message.
+message ReportPhishingRequest {
+  // Required. The name of the project for which the report will be created,
+  // in the format "projects/{project_number}".
+  string parent = 1;
+
+  // The URI that is being reported for phishing content to be analyzed.
+  string uri = 2;
+}
+
+// The ReportPhishing (empty) response message.
+message ReportPhishingResponse {}
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection_pb2.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection_pb2.py
new file mode 100644
index 000000000000..91b33898f9cf
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection_pb2.py
@@ -0,0 +1,181 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/phishingprotection_v1beta1/proto/phishingprotection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/phishingprotection_v1beta1/proto/phishingprotection.proto",
+    package="google.cloud.phishingprotection.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.phishingprotection.v1beta1B\027PhishingProtectionProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/phishingprotection/v1beta1;phishingprotection\242\002\004GCPP\252\002'Google.Cloud.PhishingProtection.V1Beta1\312\002'Google\\Cloud\\PhishingProtection\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\nFgoogle/cloud/phishingprotection_v1beta1/proto/phishingprotection.proto\x12\'google.cloud.phishingprotection.v1beta1\x1a\x1cgoogle/api/annotations.proto"4\n\x15ReportPhishingRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0b\n\x03uri\x18\x02 \x01(\t"\x18\n\x16ReportPhishingResponse2\xef\x01\n PhishingProtectionServiceV1Beta1\x12\xca\x01\n\x0eReportPhishing\x12>.google.cloud.phishingprotection.v1beta1.ReportPhishingRequest\x1a?.google.cloud.phishingprotection.v1beta1.ReportPhishingResponse"7\x82\xd3\xe4\x93\x02\x31",/v1beta1/{parent=projects/*}/phishing:report:\x01*B\xf8\x01\n%com.google.phishingprotection.v1beta1B\x17PhishingProtectionProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/phishingprotection/v1beta1;phishingprotection\xa2\x02\x04GCPP\xaa\x02\'Google.Cloud.PhishingProtection.V1Beta1\xca\x02\'Google\\Cloud\\PhishingProtection\\V1beta1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_REPORTPHISHINGREQUEST = _descriptor.Descriptor(
+    name="ReportPhishingRequest",
+    full_name="google.cloud.phishingprotection.v1beta1.ReportPhishingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.phishingprotection.v1beta1.ReportPhishingRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.phishingprotection.v1beta1.ReportPhishingRequest.uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=145,
+    serialized_end=197,
+)
+
+
+_REPORTPHISHINGRESPONSE = _descriptor.Descriptor(
+    name="ReportPhishingResponse",
+    full_name="google.cloud.phishingprotection.v1beta1.ReportPhishingResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=199,
+    serialized_end=223,
+)
+
+DESCRIPTOR.message_types_by_name["ReportPhishingRequest"] = _REPORTPHISHINGREQUEST
+DESCRIPTOR.message_types_by_name["ReportPhishingResponse"] = _REPORTPHISHINGRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ReportPhishingRequest = _reflection.GeneratedProtocolMessageType(
+    "ReportPhishingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPORTPHISHINGREQUEST,
+        __module__="google.cloud.phishingprotection_v1beta1.proto.phishingprotection_pb2",
+        __doc__="""The ReportPhishing request message.
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project for which the report will be
+          created, in the format "projects/{project\_number}".
+      uri:
+          The URI that is being reported for phishing content to be
+          analyzed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.phishingprotection.v1beta1.ReportPhishingRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReportPhishingRequest)
+
+ReportPhishingResponse = _reflection.GeneratedProtocolMessageType(
+    "ReportPhishingResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REPORTPHISHINGRESPONSE,
+        __module__="google.cloud.phishingprotection_v1beta1.proto.phishingprotection_pb2",
+        __doc__="""The ReportPhishing (empty) response message.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.phishingprotection.v1beta1.ReportPhishingResponse)
+    ),
+)
+_sym_db.RegisterMessage(ReportPhishingResponse)
+
+
+DESCRIPTOR._options = None
+
+_PHISHINGPROTECTIONSERVICEV1BETA1 = _descriptor.ServiceDescriptor(
+    name="PhishingProtectionServiceV1Beta1",
+    full_name="google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=226,
+    serialized_end=465,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ReportPhishing",
+            full_name="google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1.ReportPhishing",
+            index=0,
+            containing_service=None,
+            input_type=_REPORTPHISHINGREQUEST,
+            output_type=_REPORTPHISHINGRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0021",/v1beta1/{parent=projects/*}/phishing:report:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PHISHINGPROTECTIONSERVICEV1BETA1)
+
+DESCRIPTOR.services_by_name[
+    "PhishingProtectionServiceV1Beta1"
+] = _PHISHINGPROTECTIONSERVICEV1BETA1
+
+# @@protoc_insertion_point(module_scope)
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection_pb2_grpc.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection_pb2_grpc.py
new file mode 100644
index 000000000000..30c8d4c4b948
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/proto/phishingprotection_pb2_grpc.py
@@ -0,0 +1,55 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.phishingprotection_v1beta1.proto import (
+    phishingprotection_pb2 as google_dot_cloud_dot_phishingprotection__v1beta1_dot_proto_dot_phishingprotection__pb2,
+)
+
+
+class PhishingProtectionServiceV1Beta1Stub(object):
+    """Service to report phishing URIs.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ReportPhishing = channel.unary_unary(
+            "/google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1/ReportPhishing",
+            request_serializer=google_dot_cloud_dot_phishingprotection__v1beta1_dot_proto_dot_phishingprotection__pb2.ReportPhishingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_phishingprotection__v1beta1_dot_proto_dot_phishingprotection__pb2.ReportPhishingResponse.FromString,
+        )
+
+
+class PhishingProtectionServiceV1Beta1Servicer(object):
+    """Service to report phishing URIs.
+  """
+
+    def ReportPhishing(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_PhishingProtectionServiceV1Beta1Servicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ReportPhishing": grpc.unary_unary_rpc_method_handler(
+            servicer.ReportPhishing,
+            request_deserializer=google_dot_cloud_dot_phishingprotection__v1beta1_dot_proto_dot_phishingprotection__pb2.ReportPhishingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_phishingprotection__v1beta1_dot_proto_dot_phishingprotection__pb2.ReportPhishingResponse.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/phishingprotection/google/cloud/phishingprotection_v1beta1/types.py b/phishingprotection/google/cloud/phishingprotection_v1beta1/types.py
new file mode 100644
index 000000000000..be7eb674eb46
--- /dev/null
+++ b/phishingprotection/google/cloud/phishingprotection_v1beta1/types.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.phishingprotection_v1beta1.proto import phishingprotection_pb2
+
+
+_shared_modules = []
+
+_local_modules = [phishingprotection_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.phishingprotection_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/phishingprotection/noxfile.py b/phishingprotection/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/phishingprotection/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/phishingprotection/setup.cfg b/phishingprotection/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/phishingprotection/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/phishingprotection/setup.py b/phishingprotection/setup.py
new file mode 100644
index 000000000000..d837cfe294af
--- /dev/null
+++ b/phishingprotection/setup.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-phishing-protection"
+description = "Phishing Protection API API client library"
+version = "0.1.0"
+release_status = "3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/googleapis/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.4",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/phishingprotection/synth.metadata b/phishingprotection/synth.metadata
new file mode 100644
index 000000000000..0ddff81eb85a
--- /dev/null
+++ b/phishingprotection/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:33:35.867649Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "phishingprotection",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/phishingprotection/artman_phishingprotection_v1beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/phishingprotection/synth.py b/phishingprotection/synth.py
new file mode 100644
index 000000000000..4aa342460a80
--- /dev/null
+++ b/phishingprotection/synth.py
@@ -0,0 +1,96 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import os
+from pathlib import Path
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate phishingprotection GAPIC layer
+# ----------------------------------------------------------------------------
+versions = ["v1beta1"]
+for version in versions:
+    library = gapic.py_library(
+        "phishingprotection",
+        version,
+        config_path=f"/google/cloud/phishingprotection/artman_phishingprotection_{version}.yaml",
+        include_protos=True,
+        generator_args=["--dev_samples"],
+    )
+
+    excludes = ["README.rst", "nox.py", "setup.py", "docs/index.rst"]
+
+    s.move(library, excludes=excludes)
+
+    # Files to be renamed (remove v1_beta1 from name)
+    gapic_dir = Path(f"google/cloud/phishingprotection_{version}/gapic")
+    client = gapic_dir / "phishing_protection_service_v1_beta1_client.py"
+    client_config = gapic_dir / "phishing_protection_service_v1_beta1_client_config.py"
+    transport = (
+        gapic_dir / "transports/phishing_protection_service_v1_beta1_grpc_transport.py"
+    )
+    unit_test = Path(
+        "tests/unit/gapic/v1beta1/test_phishing_protection_service_v1_beta1_client_v1beta1.py"
+    )
+
+    s.replace(
+        client,
+        "google-cloud-phishingprotection",
+        "google-cloud-phishing-protection",
+    )
+
+    files = [client, client_config, transport, unit_test]
+    for file_ in files:
+        new_name = str(file_).replace("v1_beta1_", "")
+        os.rename(file_, new_name)
+
+# Rename classes in google/cloud and in tests/
+class_names = [
+    "PhishingProtectionServiceV1Beta1Client",
+    "PhishingProtectionServiceV1Beta1GrpcTransport",
+]
+
+for name in class_names:
+    new_name = name.replace("V1Beta1", "")
+    s.replace("google/cloud/**/*.py", name, new_name)
+    s.replace("tests/**/*.py", name, new_name)
+
+# Rename references to modules
+
+module_names = [
+    "phishing_protection_v1_beta1_service_client",
+    "phishing_protection_service_v1_beta1_grpc_transport",
+    "phishing_protection_service_v1_beta1_client",
+]
+
+for name in module_names:
+    new_name = name.replace("v1_beta1_", "")
+    s.replace("google/cloud/**/*.py", name, new_name)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/phishingprotection/tests/unit/gapic/v1beta1/test_phishing_protection_service_client_v1beta1.py b/phishingprotection/tests/unit/gapic/v1beta1/test_phishing_protection_service_client_v1beta1.py
new file mode 100644
index 000000000000..0a7d300491a9
--- /dev/null
+++ b/phishingprotection/tests/unit/gapic/v1beta1/test_phishing_protection_service_client_v1beta1.py
@@ -0,0 +1,104 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import phishingprotection_v1beta1
+from google.cloud.phishingprotection_v1beta1.proto import phishingprotection_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestPhishingProtectionServiceClient(object):
+    def test_report_phishing(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = phishingprotection_pb2.ReportPhishingResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = phishingprotection_v1beta1.PhishingProtectionServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        uri = "uri116076"
+
+        response = client.report_phishing(parent, uri)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = phishingprotection_pb2.ReportPhishingRequest(
+            parent=parent, uri=uri
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_report_phishing_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = phishingprotection_v1beta1.PhishingProtectionServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        uri = "uri116076"
+
+        with pytest.raises(CustomException):
+            client.report_phishing(parent, uri)
diff --git a/pubsub/.coveragerc b/pubsub/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/pubsub/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/pubsub/.flake8 b/pubsub/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/pubsub/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/pubsub/.repo-metadata.json b/pubsub/.repo-metadata.json
new file mode 100644
index 000000000000..916011d82ca9
--- /dev/null
+++ b/pubsub/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "pubsub",
+  "name_pretty": "Google Cloud Pub/Sub",
+  "product_documentation": "https://cloud.google.com/pubsub/docs/",
+  "client_documentation": "https://googleapis.dev/python/pubsub/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559741",
+  "release_level": "beta",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-pubsub",
+  "api_id": "pubsub.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/pubsub/CHANGELOG.md b/pubsub/CHANGELOG.md
new file mode 100644
index 000000000000..05df7382e81e
--- /dev/null
+++ b/pubsub/CHANGELOG.md
@@ -0,0 +1,545 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-pubsub/#history
+
+## 0.45.0
+
+07-31-2019 02:03 PDT
+
+
+### Implementation Changes
+
+- Remove deprecated methods and settings ([#8836](https://github.com/googleapis/google-cloud-python/pull/8836))
+
+
+### Documentation
+
+- Use double backticks for ReST correctness. ([#8829](https://github.com/googleapis/google-cloud-python/pull/8829))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.44.0
+
+07-29-2019 04:28 PDT
+
+
+### Implementation Changes
+
+- PubSub: Deprecate several FlowControl settings and things in Message class ([#8796](https://github.com/googleapis/google-cloud-python/pull/8796))
+
+### Documentation
+
+- Pub/Sub: document regional endpoint ([#8789](https://github.com/googleapis/google-cloud-python/pull/8789))
+
+## 0.43.0
+
+07-24-2019 17:13 PDT
+
+
+### Implementation Changes
+- Accomodate new location of 'IAMPolicyStub' (via synth). ([#8680](https://github.com/googleapis/google-cloud-python/pull/8680))
+- Use kwargs in test_subscriber_client ([#8414](https://github.com/googleapis/google-cloud-python/pull/8414))
+
+### New Features
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8657](https://github.com/googleapis/google-cloud-python/pull/8657))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8518](https://github.com/googleapis/google-cloud-python/pull/8518))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fix typo in publisher index. ([#8619](https://github.com/googleapis/google-cloud-python/pull/8619))
+- Document how to choose the PubSub auth method ([#8429](https://github.com/googleapis/google-cloud-python/pull/8429))
+- Document different PuSub received message types ([#8468](https://github.com/googleapis/google-cloud-python/pull/8468))
+- PubSub: Document batch settings, make synth operations idempotent ([#8448](https://github.com/googleapis/google-cloud-python/pull/8448))
+- Add custom docstrings for FlowControl enum and values (via synth). ([#8426](https://github.com/googleapis/google-cloud-python/pull/8426))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Add system tests for PubSub clients ([#8277](https://github.com/googleapis/google-cloud-python/pull/8277))
+
+## 0.42.1
+
+06-18-2019 15:14 PDT
+
+
+### Implementation Changes
+- Increase the minimum allowed version for api core. ([#8419](https://github.com/googleapis/google-cloud-python/pull/8419))
+- Allow kwargs to be passed to create_channel. ([#8399](https://github.com/googleapis/google-cloud-python/pull/8399))
+
+## 0.42.0
+
+06-18-2019 11:32 PDT
+
+### Implementation Changes
+- Core: Mitigate busy reopen loop in ResumableBidiRpc consuming 100% CPU ([#8193](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8193))
+- Pub/Sub: Increase initial_rpc_timeout for messaging (via synth). ([#8219](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8219))
+- PubSub: Release the state lock before calling the publish api ([#8234](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8234))
+- Pub/Sub: Expose publish retry settings ([#8231](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8231))
+- Prevent unhandled background error on SPM shutdown ([#8111](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8111))
+- Update timeouts, blacken noxfile.py, setup.py (via synth). ([#8128](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8128))
+- PubSub: Fix streaming pull incorrectly handling FlowControl max_messages setting ([#7948](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7948))
+
+### Documentation
+- Document PubSub FlowControl settings ([#8293](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8293))
+- Replace readthedocs links with links to github docs. ([#8291](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8291))
+- Pub/Sub: surface publish future in documentation ([#8229](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8229))
+- Pubsub: Separate subscriber and publish future documentation. ([#8205](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8205))
+- Drop mention of long-removed 'policy' object. ([#8081](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8081))
+
+### Internal / Testing Changes
+- Pub/Sub: staticmethod check ([#8091](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8091))
+- Add empty lines (via synth). ([#8067](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/8067))
+
+## 0.41.0
+
+05-15-2019 13:57 PDT
+
+
+### New Features
+- Add `kms_key_name` arg to `create_topic`; remove BETA warnings (via synth). ([#7936](https://github.com/googleapis/google-cloud-python/pull/7936))
+- Add message ordering (via synth). ([#7551](https://github.com/googleapis/google-cloud-python/pull/7551))
+
+### Implementation Changes
+- Propagate subscribe callback errors to main thread ([#7954](https://github.com/googleapis/google-cloud-python/pull/7954))
+- Fix pubsub Streaming Pull shutdown on RetryError ([#7863](https://github.com/googleapis/google-cloud-python/pull/7863))
+- Make PubSub subscriber Scheduler inherit from ABC ([#7690](https://github.com/googleapis/google-cloud-python/pull/7690))
+- Add routing header to method metadata (via synth). ([#7623](https://github.com/googleapis/google-cloud-python/pull/7623))
+
+### Internal / Testing Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Add nox session `docs` (via synth). ([#7778](https://github.com/googleapis/google-cloud-python/pull/7778))
+- Pub/Sub (nit): wrong var name in sample ([#7705](https://github.com/googleapis/google-cloud-python/pull/7705))
+
+## 0.40.0
+
+03-15-2019 14:09 PDT
+
+
+### Implementation Changes
+- Propagate 'RetryError' in 'PublisherClient.publish'. ([#7071](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7071))
+- Protoc-generated serialization update.. ([#7091](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7091))
+
+### New Features
+- Add 'authentication_method' to 'PushConfig' (via synth). ([#7512](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7512))
+- Add protos as an artifact to library ([#7205](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7205))
+- Pub/sub: pass transport w/ custom channel to GAPIC API clients. ([#7008](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7008))
+
+### Dependencies
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7307))
+- Update copyright headers
+- Fix broken docstring cross-reference links. ([#7132](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7132))
+- Docstring changes from updates to .proto files. ([#7054](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/7054))
+- Pick up stub docstring fix in GAPIC generator. ([#6978](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6978))
+
+### Internal / Testing Changes
+- Copy proto files alongside protoc versions.
+
+## 0.39.1
+
+12-17-2018 16:57 PST
+
+
+### Implementation Changes
+- Initialize `StreamingPullFuture._cancelled` as True. ([#6901](https://github.com/googleapis/google-cloud-python/pull/6901))
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Emphasize that returned futures may differ from stdlib futures. ([#6875](https://github.com/googleapis/google-cloud-python/pull/6875))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+
+## 0.39.0
+
+11-27-2018 13:32 PST
+
+### Implementation Changes
+- Pick up fixes to GAPIC generator. ([#6503](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6503))
+- Override client classmethod factories inherited from GAPIC. ([#6453](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6453))
+- Fix imports for hand-written client docstring examples. ([#6345](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6345))
+- Fix path for patch of 'bidi' elements. ([#6243](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6243))
+- Move bidi to api-core. ([#6211](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6211))
+- Re-generate library using pubsub/synth.py ([#6059](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6059))
+- Re-generate library using pubsub/synth.py ([#5978](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5978))
+
+### New Features
+- Add 'expiration_policy' to subscriber client. ([#6223](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6223))
+
+### Dependencies
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6391))
+- Update IAM version in dependencies. ([#6362](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6362))
+- Bump minimum 'api_core' version to '1.4.1'. ([#6134](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6134))
+
+### Documentation
+- Fix client_info bug, update docstrings. ([#6418](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6418))
+- Fix docstring reference to wrong future class. ([#6382](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6382))
+- Normalize use of support level badges. ([#6159](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6159))
+- Update subscriber example in README to current patterns. ([#6194](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6194))
+- Prep pubsub docs for repo split. ([#6001](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6001))
+
+### Internal / Testing Changes
+- Fix error from new flake8 version. ([#6346](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6346))
+- Use new Nox. ([#6175](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6175))
+
+## 0.38.0
+
+### Implementation Changes
+
+- Fix race condition in recv()'s usage of self.call. ([#5935](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5935))
+- Re-generate the underlying library from protos. ([#5953](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5953))
+- Change 'BatchSettings.max_bytes' default. ([#5899](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5899))
+- Fix race condition where pending Ack IDs can be modified by another thread. ([#5929](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5929))
+
+### Internal / Testing Changes
+
+- Nox: use inplace installs ([#5865](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5865))
+
+## 0.37.2
+
+### Implementation Changes
+
+- Fix classmethod wrapping (#5826)
+
+### Documentation
+
+- Fix Sphinx rendering for publisher client. (#5822)
+
+### Internal / Testing Changes
+
+- Re-generate library, removing obsolete synth modifications. (#5825)
+- Add test for testing invoking a wrapped class method on the class itself (#5828)
+
+## 0.37.1
+
+### Implementation Changes
+
+- Make get_initial_request more resilient to race conditions. (#5803)
+
+## 0.37.0
+
+### Implementation Changes
+
+- Make Publisher batch-related interfaces private (#5784)
+
+## 0.36.0
+
+### Implementation Changes
+- Pubsub: Make 'Message.publish_time' return datetime (#5633)
+- Ensure SPM methods check that 'self._consumer' is not None before use. (#5758)
+
+### New Features
+- PubSub: add geo-fencing support (#5769)
+- Add 'Message.ack_id' property. (#5693)
+
+## 0.35.4
+
+### Implementation Changes
+
+- Recover streams during the gRPC error callback. (#5446)
+- Use operational lock when checking for activity on streams. (#5445)
+
+## 0.35.3
+
+### Implementation Changes
+
+- Add additional error handling to unary RPCs (#5438)
+
+## 0.35.2
+
+### Implementation Changes
+- Add heartbeating to the streaming pull manager (#5413)
+- Fix retrying of bidirectional RPCs and closing the streaming pull manager (#5412)
+
+## 0.35.1
+
+### Implementation Changes
+- Catch errors when re-retying send() or recv() in addition to open() (#5402)
+
+## 0.35.0
+
+### Implementation Changes
+
+- Send requests during streaming pull over a separate unary RPC (#5377)
+- Initialize references to helper threads before starting them (#5374)
+- Make leaser exit more quickly (#5373)
+- Make re-open failures bubble to callbacks (#5372)
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+- Normalize overflow handling for max count and bytes (#5343)
+
+### New Features
+
+- Restore the synchronous pull method (#5379)
+- Promote subscribe_experimental() to subscribe(), remove old subscriber implementation. (#5274)
+- Wire up scheduler argument for subscribe() (#5279)
+
+### Documentation
+
+- Add link to streaming pull behavior documentation (#5378)
+- Fix example in subscribe's documentation (#5375)
+
+### Internal / Testing Changes
+
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+
+## 0.34.0
+
+### Implementation Changes
+
+- Lower the flow control defaults. (#5248)
+
+### New Features
+
+- A new implementation of the subscriber has been added. This is available as `SubscriberClient.subscribe_experimental`. In the next release, this will be replace the current `subscribe` method. If you use this, please report your
+findings to us on GitHub. (#5189, #5201, #5210, #5229, #5230, #5237, #5256)
+
+### Dependencies
+
+- Remove psutil dependency. (#5248)
+
+## 0.33.1
+
+### Implementation changes
+
+- Surface publish RPC errors back to the publish futures (#5124)
+- Make the pausable response iterator aware of the RPC state to prevent deadlock (#5108)
+- Properly handle graceful stop in request generator (#5097)
+
+## 0.33.0
+
+### Implementation changes
+
+- Drop leased messages after flow_control.max_lease_duration has passed. (#5020)
+- Fix mantain leases to not modack messages it just dropped (#5045)
+- Avoid race condition in maintain_leases by copying leased_messages (#5035)
+- Retry subscription stream on InternalServerError, Unknown, and GatewayTimeout (#5021)
+- Use the rpc's status to determine when to exit the request generator thread (#5054)
+- Fix missing iter on request stream (#5078)
+- Nack messages when the subscriber callback errors (#5019)
+
+### Testing
+
+- pubsub nox.py cleanup (#5056)
+- Fix test that checks for retryable exceptions (#5034)
+
+## 0.32.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+
+## 0.32.0
+
+### Implementation changes
+
+- Added support for streaming pull receipts. (#4878)
+
+## 0.31.0
+
+### New features
+
+- Added the ability for subscriber to batch requests. (#4895)
+- Added pending request backpressure for subscriber. (#4892)
+
+### Implementation changes
+
+- Raise `ValueError` when a message is too large for a batch. (#4872)
+- Updated the default batch size to 10 MB. (#4857)
+- Allow a custom `Event` type in Pub / Sub futures. (#4643)
+
+### Documentation
+
+- Clarify that `modify_ack_deadline` resets the deadline. (#4822)
+
+### Testing
+
+- Fix unit test for default `max_bytes` value. (#4860)
+
+## 0.30.1
+
+### Notable Implementation Changes
+
+- Moving lock factory used in publisher client to the Batch
+  implementation (#4628).
+- Use a UUID (rather than a sentinel object) on `Future` (#4634).
+- Apply scopes to explicitly provided credentials if needed (#4594).
+  Fixes #4479. This feature comes as part of `google-api-core==0.1.3`.
+
+### Dependencies
+
+- Upgrading to `google-api-core==0.1.3` which depends on the latest
+  `grpcio==1.8.2` (#4642). This fixes #4600. For details, see related
+  gRPC [bug](https://github.com/grpc/grpc/issues/9688) and
+  [fix](https://github.com/grpc/grpc/pull/13665).
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.30.1/
+
+## 0.30.0
+
+### Notable Implementation Changes
+
+- Dropping redundant `Policy._paused` data member (#4568).
+- Removing redundant "active" check in policy (#4603).
+- Adding a `Consumer.active` property (#4604).
+- Making it impossible to call `Policy.open()` on an already opened
+  policy (#4606).
+- **Bug fix** (#4575): Fix bug with async publish for batches. There
+  were two related bugs. The first: if a batch exceeds the `max_messages`
+  from the batch settings, then the `commit()` will fail. The second:
+  when a "monitor" worker calls `commit()` after `max_latency` seconds,
+  a failure can occur if a new message is added to the batch **during**
+  the commit. To fix, the following changes were implemented:
+  - Adding a "STARTING" status for `Batch.commit()` (#4614). This
+    fixes the issue when the batch exceeds `max_messages`.
+  - Adding extra check in `Batch.will_accept` for the number of
+    messages (#4612).
+  - Moving `will_accept()` check out of `PublisherClient.batch()`
+    factory (#4613).
+  - Checking `Batch.will_accept` in thread-safe way (#4616).
+- **Breaking API change**: As part of #4613, changing `PublisherClient.batch()`
+  to no longer accept a `message` (since the `will_accept` check needs to
+  happen in a more concurrency friendly way). In addition, changing the
+  `create` argument so that it means "create even if batch already exists"
+  rather than "create if missing".
+
+### Documentation
+
+- Add more explicit documentation for `Message.attributes` (#4601).
+- Make `Message.__repr__` a bit prettier / more useful (#4602).
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.30.0/
+
+## 0.29.4
+
+### Notable Implementation Changes
+
+- **Bug fix**: Restore previous behavior of the subscription lease
+  maintenance worker. This was accidentally "stopped" in `0.29.3`
+  due to a change in implementation that went from an `active`
+  boolean to an "inactive" / `stopped` boolean, so `True` became
+  `False` and vice-versa (#4564).
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.29.4/
+
+## 0.29.3
+
+### Notable Implementation Changes
+
+- In subscription consumer thread: Making sure the request generator
+  attached to an inactive bidirectional streaming pull is stopped before
+  spawning a new request generator. This way we have a (fairly strong)
+  guarantee that requests in the queue don't get sent into an inactive
+  stream (#4503, #4554).
+- Adding `pause` / `resume` to subscription consumer thread and using these
+  methods during flow control. The previous implementation tried to close the
+  subscription (which involved 3 worker threads and 10 executors in a thread
+  pool) and then re-open a new subscription. But, this was not entirely
+  possible to shut down correctly from **within** one of the worker threads.
+  Instead, we only pause the worker (of the 3) that is pulling new responses
+  from the bidirectional streaming pull (#4558).
+- **Bug fix** (#4516): Using `max` where `min` was used by mistake to
+  ensure the number of bytes tracked for subscription flow control
+  remained non-negative (#4514).
+- Raising `TypeError` if `SubscriberClient.subscribe` receives a
+  non-callable callback (#4497).
+- Shutting down thread pool executor when closing a subscriber
+  policy (#4522).
+- Renaming `Policy.on_callback_request` to `Policy.dispatch_callback`
+  and making the behavior much less dynamic (#4511).
+- Make sure subscription consumer thread doesn't try to join itself
+  when exiting in error (#4540).
+
+### Dependencies
+
+- Upgrading `google-api-core` dependency to latest revision (`0.1.2`)
+  since we rely on the latest version of the `concurrent.futures` backport
+  to provide the `thread_name_prefix` argument for thread pool
+  executor (#4521, #4559).
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.29.3/
+
+## 0.29.2
+
+### Notable Implementation Changes
+
+- **Bug fix** (#4463): Making a subscription consumer actually stop
+  running after encountering an exception (#4472, #4498). This bug
+  is the **only** reason for the `0.29.2` release.
+- Thread Changes
+  - Added names to all threads created directly by Pub / Sub (#4474,
+    #4476, #4480). Also removing spaces and colons from thread
+    names (#4476).
+- Logging changes
+  - Adding debug logs when lease management exits (#4484)
+  - Adding debug logs when `QueueCallbackThread` exits (#4494).
+    Instances handle the processing of messages in a
+    subscription (e.g. to `ack`).
+  - Using a named logger in `publisher.batch.thread` (#4473)
+  - Adding newlines before logging protobuf payloads (#4471)
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.29.2/
+
+## 0.29.1
+
+### Notable Implementation Changes
+
+- **Bug fix** (#4234): Adding retries for connection `UNAVAILABLE`. This
+  bug made the Pub / Sub client mostly unusable for subscribers to topics
+  that don't have a steady stream of messages. After ~2 minutes of inactivity,
+  the gRPC connection would timeout and raise `UNAVAILABLE` locally, i.e. not
+  due to a response from the backend. (#4444)
+- Updating autogenerated packages (#4438)
+
+### Documentation
+
+- Fixing broken examples in quick start (#4398)
+- Fixing broken example in README (#4402, h/t to @mehmetboraezer)
+- Updating old/dead link to usage doc in README (#4406, h/t to @mehmetboraezer)
+
+### Dependencies
+
+- Dropping dependency on `google-cloud-core` in exchange for
+  `google-api-core` (#4438)
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.29.1/
+
+## 0.29.0
+
+### Notable Implementation Changes
+
+- Honor `max_messages` always (#4262)
+- Add futures for subscriptions (#4265)
+- Set gRPC message options and keepalive (#4269)
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+PyPI: https://pypi.org/project/google-cloud-pubsub/0.29.0/
diff --git a/pubsub/LICENSE b/pubsub/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/pubsub/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/pubsub/MANIFEST.in b/pubsub/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/pubsub/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/pubsub/README.rst b/pubsub/README.rst
new file mode 100644
index 000000000000..3014e1375686
--- /dev/null
+++ b/pubsub/README.rst
@@ -0,0 +1,194 @@
+Python Client for Google Cloud Pub / Sub
+========================================
+
+|beta| |pypi| |versions| 
+
+`Google Cloud Pub / Sub`_ is a fully-managed real-time messaging service that
+allows you to send and receive messages between independent applications. You
+can leverage Cloud Pub/Sub’s flexibility to decouple systems and components
+hosted on Google Cloud Platform or elsewhere on the Internet. By building on
+the same technology Google uses, Cloud Pub / Sub is designed to provide “at
+least once” delivery at low latency with on-demand scalability to 1 million
+messages per second (and beyond).
+
+Publisher applications can send messages to a ``topic`` and other applications
+can subscribe to that topic to receive the messages. By decoupling senders and
+receivers, Google Cloud Pub/Sub allows developers to communicate between
+independently written applications.
+
+- `Product Documentation`_
+- `Client Library Documentation`_
+
+.. |beta| image:: https://img.shields.io/badge/support-beta-silver.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-pubsub.svg
+   :target: https://pypi.org/project/google-cloud-pubsub/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-pubsub.svg
+   :target: https://pypi.org/project/google-cloud-pubsub/
+.. _Google Cloud Pub / Sub: https://cloud.google.com/pubsub/
+.. _Product Documentation: https://cloud.google.com/pubsub/docs
+.. _Client Library Documentation: https://googleapis.dev/python/pubsub/latest
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Pub / Sub API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Pub / Sub API.:  https://cloud.google.com/pubsub
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-pubsub
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-pubsub
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+Publishing
+^^^^^^^^^^
+
+To publish data to Cloud Pub/Sub you must create a topic, and then publish
+messages to it
+
+.. code-block:: python
+
+    import os
+    from google.cloud import pubsub_v1
+
+    publisher = pubsub_v1.PublisherClient()
+    topic_name = 'projects/{project_id}/topics/{topic}'.format(
+        project_id=os.getenv('GOOGLE_CLOUD_PROJECT'),
+        topic='MY_TOPIC_NAME',  # Set this to something appropriate.
+    )
+    publisher.create_topic(topic_name)
+    publisher.publish(topic_name, b'My first message!', spam='eggs')
+
+To learn more, consult the `publishing documentation`_.
+
+.. _publishing documentation: https://googleapis.dev/python/pubsub/latest
+
+
+Subscribing
+^^^^^^^^^^^
+
+To subscribe to data in Cloud Pub/Sub, you create a subscription based on
+the topic, and subscribe to that, passing a callback function.
+
+.. code-block:: python
+
+    import os
+    from google.cloud import pubsub_v1
+
+    subscriber = pubsub_v1.SubscriberClient()
+    topic_name = 'projects/{project_id}/topics/{topic}'.format(
+        project_id=os.getenv('GOOGLE_CLOUD_PROJECT'),
+        topic='MY_TOPIC_NAME',  # Set this to something appropriate.
+    )
+    subscription_name = 'projects/{project_id}/subscriptions/{sub}'.format(
+        project_id=os.getenv('GOOGLE_CLOUD_PROJECT'),
+        sub='MY_SUBSCRIPTION_NAME',  # Set this to something appropriate.
+    )
+    subscriber.create_subscription(
+        name=subscription_name, topic=topic_name)
+
+    def callback(message):
+        print(message.data)
+        message.ack()
+
+    future = subscriber.subscribe(subscription_name, callback)
+
+The future returned by the call to ``subscriber.subscribe`` can be used to
+block the current thread until a given condition obtains:
+
+.. code-block:: python
+
+    try:
+        future.result()
+    except KeyboardInterrupt:
+        future.cancel()
+
+It is also possible to pull messages in a synchronous (blocking) fashion. To
+learn more about subscribing, consult the `subscriber documentation`_.
+
+.. _subscriber documentation: https://googleapis.dev/python/pubsub/latest
+
+
+Authentication
+^^^^^^^^^^^^^^
+
+It is possible to specify the authentication method to use with the Pub/Sub
+clients. This can be done by providing an explicit `Credentials`_ instance. Support
+for various authentication methods is available from the `google-auth`_ library.
+
+For example, to use JSON Web Tokens, provide a `google.auth.jwt.Credentials`_ instance:
+
+.. code-block:: python
+
+    import json
+    from google.auth import jwt
+
+    service_account_info = json.load(open("service-account-info.json"))
+    audience = "https://pubsub.googleapis.com/google.pubsub.v1.Subscriber"
+
+    credentials = jwt.Credentials.from_service_account_info(
+        service_account_info, audience=audience
+    )
+
+    subscriber = pubsub_v1.SubscriberClient(credentials=credentials)
+
+    # The same for the publisher, except that the "audience" claim needs to be adjusted
+    publisher_audience = "https://pubsub.googleapis.com/google.pubsub.v1.Publisher"
+    credentials_pub = credentials.with_claims(audience=publisher_audience) 
+    publisher = pubsub_v1.PublisherClient(credentials=credentials_pub)
+
+.. _Credentials: https://google-auth.readthedocs.io/en/latest/reference/google.auth.credentials.html#google.auth.credentials.Credentials
+.. _google-auth: https://google-auth.readthedocs.io/en/latest/index.html
+.. _google.auth.jwt.Credentials: https://google-auth.readthedocs.io/en/latest/reference/google.auth.jwt.html#google.auth.jwt.Credentials
diff --git a/pubsub/docs/README.rst b/pubsub/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/pubsub/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/pubsub/docs/changelog.md b/pubsub/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/pubsub/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/pubsub/docs/conf.py b/pubsub/docs/conf.py
new file mode 100644
index 000000000000..cc9198fc4b3b
--- /dev/null
+++ b/pubsub/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-pubsub documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-pubsub"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-pubsub-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-pubsub.tex",
+        u"google-cloud-pubsub Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-pubsub",
+        u"google-cloud-pubsub Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-pubsub",
+        u"google-cloud-pubsub Documentation",
+        author,
+        "google-cloud-pubsub",
+        "GAPIC library for the {metadata.shortName} service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/pubsub/docs/index.rst b/pubsub/docs/index.rst
new file mode 100644
index 000000000000..5f6f8d4d26d1
--- /dev/null
+++ b/pubsub/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+API Documentation
+-----------------
+
+.. toctree::
+  :maxdepth: 3
+
+  publisher/index
+  subscriber/index
+  types
+
+Changelog
+---------
+
+For a list of all ``google-cloud-pubsub`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
+
diff --git a/pubsub/docs/publisher/api/client.rst b/pubsub/docs/publisher/api/client.rst
new file mode 100644
index 000000000000..47a3aa3d5d7a
--- /dev/null
+++ b/pubsub/docs/publisher/api/client.rst
@@ -0,0 +1,6 @@
+Publisher Client API
+====================
+
+.. automodule:: google.cloud.pubsub_v1.publisher.client
+  :members:
+  :inherited-members:
diff --git a/pubsub/docs/publisher/api/futures.rst b/pubsub/docs/publisher/api/futures.rst
new file mode 100644
index 000000000000..b02b9bf9039d
--- /dev/null
+++ b/pubsub/docs/publisher/api/futures.rst
@@ -0,0 +1,6 @@
+Futures
+=======
+
+.. automodule:: google.cloud.pubsub_v1.publisher.futures
+  :members:
+  :inherited-members:
diff --git a/pubsub/docs/publisher/index.rst b/pubsub/docs/publisher/index.rst
new file mode 100644
index 000000000000..2a785359c443
--- /dev/null
+++ b/pubsub/docs/publisher/index.rst
@@ -0,0 +1,138 @@
+Publishing Messages
+===================
+
+Publishing messages is handled through the
+:class:`~.pubsub_v1.publisher.client.Client` class (aliased as
+``google.cloud.pubsub.PublisherClient``). This class provides methods to
+create topics, and (most importantly) a
+:meth:`~.pubsub_v1.publisher.client.Client.publish` method that publishes
+messages to Pub/Sub.
+
+Instantiating a publishing client is straightforward:
+
+.. code-block:: python
+
+    from google.cloud import pubsub
+    publish_client = pubsub.PublisherClient()
+
+
+Publish a Message
+-----------------
+
+To publish a message, use the
+:meth:`~.pubsub_v1.publisher.client.Client.publish` method. This method accepts
+two positional arguments: the topic to publish to, and the body of the message.
+It also accepts arbitrary keyword arguments, which are passed along as
+attributes of the message.
+
+The topic is passed along as a string; all topics have the canonical form of
+``projects/{project_name}/topics/{topic_name}``.
+
+Therefore, a very basic publishing call looks like:
+
+.. code-block:: python
+
+    topic = 'projects/{project}/topics/{topic}'
+    publish_client.publish(topic, b'This is my message.')
+
+.. note::
+
+    The message data in Pub/Sub is an opaque blob of bytes, and as such, you
+    *must* send a ``bytes`` object in Python 3 (``str`` object in Python 2).
+    If you send a text string (``str`` in Python 3, ``unicode`` in Python 2),
+    the method will raise :exc:`TypeError`.
+
+    The reason it works this way is because there is no reasonable guarantee
+    that the same language or environment is being used by the subscriber,
+    and so it is the responsibility of the publisher to properly encode
+    the payload.
+
+If you want to include attributes, simply add keyword arguments:
+
+.. code-block:: python
+
+    topic = 'projects/{project}/topics/{topic}'
+    publish_client.publish(topic, b'This is my message.', foo='bar')
+
+
+Batching
+--------
+
+Whenever you publish a message, the publisher will automatically batch the
+messages over a small time window to avoid making too many separate requests to
+the service.  This helps increase throughput.
+
+.. note::
+
+    By default, this uses ``threading``, and you will need to be in an
+    environment with threading enabled. It is possible to provide an
+    alternative batch class that uses another concurrency strategy.
+
+The way that this works is that on the first message that you send, a new batch
+is created automatically.  For every subsequent message, if there is already a
+valid batch that is still accepting messages, then that batch is used. When the
+batch is created, it begins a countdown that publishes the batch once
+sufficient time has elapsed (by default, this is 0.05 seconds).
+
+If you need different batching settings, simply provide a
+:class:`~.pubsub_v1.types.BatchSettings` object when you instantiate the
+:class:`~.pubsub_v1.publisher.client.Client`:
+
+.. code-block:: python
+
+    from google.cloud import pubsub
+    from google.cloud.pubsub import types
+
+    client = pubsub.PublisherClient(
+        batch_settings=types.BatchSettings(max_messages=500),
+    )
+
+Pub/Sub accepts a maximum of 1,000 messages in a batch, and the size of a
+batch can not exceed 10 megabytes.
+
+
+Futures
+-------
+
+Every call to :meth:`~.pubsub_v1.publisher.client.Client.publish` returns
+an instance of :class:`~.pubsub_v1.publisher.futures.Future`.
+
+.. note::
+   
+   The returned future conforms for the most part to the interface of
+   the standard library's :class:`~concurrent.futures.Future`, but might not
+   be usable in all cases which expect that exact implementaton.
+
+You can use this to ensure that the publish succeeded:
+
+.. code-block:: python
+
+    # The .result() method will block until the future is complete.
+    # If there is an error, it will raise an exception.
+    future = client.publish(topic, b'My awesome message.')
+    message_id = future.result()
+
+You can also attach a callback to the future:
+
+.. code-block:: python
+
+    # Callbacks receive the future as their only argument, as defined in
+    # the Future interface.
+    def callback(future):
+        message_id = future.result()
+        do_something_with(message_id)
+
+    # The callback is added once you get the future. If you add a callback
+    # and the future is already done, it will simply be executed immediately.
+    future = client.publish(topic, b'My awesome message.')
+    future.add_done_callback(callback)
+
+
+API Reference
+-------------
+
+.. toctree::
+  :maxdepth: 2
+
+  api/client
+  api/futures
diff --git a/pubsub/docs/subscriber/api/client.rst b/pubsub/docs/subscriber/api/client.rst
new file mode 100644
index 000000000000..965880c5a640
--- /dev/null
+++ b/pubsub/docs/subscriber/api/client.rst
@@ -0,0 +1,6 @@
+Subscriber Client API
+=====================
+
+.. automodule:: google.cloud.pubsub_v1.subscriber.client
+  :members:
+  :inherited-members:
diff --git a/pubsub/docs/subscriber/api/futures.rst b/pubsub/docs/subscriber/api/futures.rst
new file mode 100644
index 000000000000..fb0264279cf6
--- /dev/null
+++ b/pubsub/docs/subscriber/api/futures.rst
@@ -0,0 +1,6 @@
+Futures
+=======
+
+.. automodule:: google.cloud.pubsub_v1.subscriber.futures
+  :members:
+  :inherited-members:
diff --git a/pubsub/docs/subscriber/api/message.rst b/pubsub/docs/subscriber/api/message.rst
new file mode 100644
index 000000000000..cc5b0e37c9b4
--- /dev/null
+++ b/pubsub/docs/subscriber/api/message.rst
@@ -0,0 +1,5 @@
+Messages
+========
+
+.. autoclass:: google.cloud.pubsub_v1.subscriber.message.Message
+  :members:
diff --git a/pubsub/docs/subscriber/api/scheduler.rst b/pubsub/docs/subscriber/api/scheduler.rst
new file mode 100644
index 000000000000..06e839f219e6
--- /dev/null
+++ b/pubsub/docs/subscriber/api/scheduler.rst
@@ -0,0 +1,6 @@
+Scheduler
+=========
+
+.. automodule:: google.cloud.pubsub_v1.subscriber.scheduler
+  :members:
+  :inherited-members:
diff --git a/pubsub/docs/subscriber/index.rst b/pubsub/docs/subscriber/index.rst
new file mode 100644
index 000000000000..d3d1cb5415b5
--- /dev/null
+++ b/pubsub/docs/subscriber/index.rst
@@ -0,0 +1,190 @@
+Subscribing to Messages
+=======================
+
+Subscribing to messages is handled through the
+:class:`~.pubsub_v1.subscriber.client.Client` class (aliased as
+``google.cloud.pubsub.SubscriberClient``). This class provides a
+:meth:`~.pubsub_v1.subscriber.client.Client.subscribe` method to
+attach to subscriptions on existing topics.
+
+Instantiating a subscriber client is straightforward:
+
+.. code-block:: python
+
+    from google.cloud import pubsub
+    subscriber = pubsub.SubscriberClient()
+
+
+Creating a Subscription
+-----------------------
+
+In Pub/Sub, a **subscription** is a discrete pull of messages from a topic.
+If multiple clients pull the same subscription, then messages are split
+between them. If multiple clients create a subscription each, then each client
+will get every message.
+
+.. note::
+
+    Remember that Pub/Sub operates under the principle of "everything at least
+    once". Even in the case where multiple clients pull the same subscription,
+    *some* redundancy is likely.
+
+Creating a subscription requires that you already know what topic you want
+to subscribe to, and it must already exist. Once you have that, it is easy:
+
+.. code-block:: python
+
+    # Substitute PROJECT, SUBSCRIPTION, and TOPIC with appropriate values for
+    # your application.
+    sub_path = subscriber.subscription_path(PROJECT, SUBSCRIPTION)
+    topic_path = subscriber.topic_path(PROJECT, TOPIC)
+    subscriber.create_subscription(sub_path, topic_path)
+
+Once you have created a subscription (or if you already had one), the next
+step is to pull data from it.
+
+
+Pulling a Subscription Synchronously
+------------------------------------
+
+To pull the messages synchronously, use the client's
+:meth:`~.pubsub_v1.subscriber.client.Client.pull` method.
+
+.. code-block:: python
+
+    # Substitute PROJECT and SUBSCRIPTION with appropriate values for your
+    # application.
+    subscription_path = subscriber.subscription_path(PROJECT, SUBSCRIPTION)
+    response = subscriber.pull(subscription_path, max_messages=5)
+
+    for msg in response.received_messages:
+        print("Received message:", msg.message.data)
+
+    ack_ids = [msg.ack_id for msg in response.received_messages]
+    subscriber.acknowledge(subscription_path, ack_ids)
+
+The method returns a :class:`~.pubsub_v1.types.PullResponse` instance that
+cointains a list of received :class:`~.pubsub_v1.types.ReceivedMessage`
+instances.
+
+
+Pulling a Subscription Asynchronously
+-------------------------------------
+
+The subscriber client uses the
+:meth:`~.pubsub_v1.subscriber.client.Client.subscribe` method to start a
+background thread to receive messages from Pub/Sub and calls a callback with
+each message received.
+
+.. code-block:: python
+
+    # Substitute PROJECT and SUBSCRIPTION with appropriate values for your
+    # application.
+    subscription_path = subscriber.subscription_path(PROJECT, SUBSCRIPTION)
+    future = subscriber.subscribe(subscription_path, callback)
+
+This will return a
+:class:`~.pubsub_v1.subscriber.futures.StreamingPullFuture`. This future allows
+you to control the background thread that is managing the subscription.
+
+
+Subscription Callbacks
+----------------------
+
+Messages received from a subscription are processed asynchronously through
+**callbacks**.
+
+The basic idea: Define a function that takes one argument; this argument
+will be a :class:`~.pubsub_v1.subscriber.message.Message` instance, which is
+a convenience wrapper around the :class:`~.pubsub_v1.types.PubsubMessage`
+instance received from the server (and stored under the ``message`` attribute).
+
+This function should do whatever processing is necessary. At the end, the
+function should either :meth:`~.pubsub_v1.subscriber.message.Message.ack`
+or :meth:`~.pubsub_v1.subscriber.message.Message.nack` the message.
+
+When you call :meth:`~.pubsub_v1.subscriber.client.Client.subscribe`, you
+must pass the callback that will be used.
+
+Here is an example:
+
+.. code-block:: python
+
+    # Define the callback.
+    # Note that the callback is defined *before* the subscription is opened.
+    def callback(message):
+        do_something_with(message)  # Replace this with your actual logic.
+        message.ack()  # Asynchronously acknowledge the message.
+
+    # Substitute PROJECT and SUBSCRIPTION with appropriate values for your
+    # application.
+    subscription_path = subscriber.subscription_path(PROJECT, SUBSCRIPTION)
+
+    # Open the subscription, passing the callback.
+    future = subscriber.subscribe(subscription_path, callback)
+
+The :meth:`~.pubsub_v1.subscriber.client.Client.subscribe` method returns
+a :class:`~.pubsub_v1.subscriber.futures.StreamingPullFuture`, which is both
+the interface to wait on messages (e.g. block the primary thread) and to
+address exceptions.
+
+To block the thread you are in while messages are coming in the stream,
+use the :meth:`~.pubsub_v1.subscriber.futures.Future.result` method:
+
+.. code-block:: python
+
+    future.result()
+
+.. note: This will block forever assuming no errors or that ``cancel`` is never
+    called.
+
+You can also use this for error handling; any exceptions that crop up on a
+thread will be set on the future.
+
+.. code-block:: python
+
+    try:
+        future.result()
+    except Exception as ex:
+        subscription.close()
+        raise
+
+Finally, you can use
+:meth:`~.pubsub_v1.subscriber.futures.StreamingPullFuture.cancel` to stop
+receiving messages.
+
+
+.. code-block:: python
+
+    future.cancel()
+
+
+Explaining Ack
+--------------
+
+In Pub/Sub, the term **ack** stands for "acknowledge". You should ack a
+message when your processing of that message *has completed*. When you ack
+a message, you are telling Pub/Sub that you do not need to see it again.
+
+It might be tempting to ack messages immediately on receipt. While there
+are valid use cases for this, in general it is unwise. The reason why: If
+there is some error or edge case in your processing logic, and processing
+of the message fails, you will have already told Pub/Sub that you successfully
+processed the message. By contrast, if you ack only upon completion, then
+Pub/Sub will eventually re-deliver the unacknowledged message.
+
+It is also possible to **nack** a message, which is the opposite. When you
+nack, it tells Pub/Sub that you are unable or unwilling to deal with the
+message, and that the service should redeliver it.
+
+
+API Reference
+-------------
+
+.. toctree::
+  :maxdepth: 2
+
+  api/client
+  api/message
+  api/futures
+  api/scheduler
diff --git a/pubsub/docs/types.rst b/pubsub/docs/types.rst
new file mode 100644
index 000000000000..87c987571766
--- /dev/null
+++ b/pubsub/docs/types.rst
@@ -0,0 +1,5 @@
+Pub/Sub Client Types
+====================
+
+.. automodule:: google.cloud.pubsub_v1.types
+  :members:
diff --git a/pubsub/google/__init__.py b/pubsub/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/pubsub/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/pubsub/google/cloud/__init__.py b/pubsub/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/pubsub/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/pubsub/google/cloud/pubsub.py b/pubsub/google/cloud/pubsub.py
new file mode 100644
index 000000000000..b9f92e991aa6
--- /dev/null
+++ b/pubsub/google/cloud/pubsub.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.pubsub_v1 import PublisherClient
+from google.cloud.pubsub_v1 import SubscriberClient
+from google.cloud.pubsub_v1 import types
+
+
+__all__ = ("types", "PublisherClient", "SubscriberClient")
diff --git a/pubsub/google/cloud/pubsub_v1/__init__.py b/pubsub/google/cloud/pubsub_v1/__init__.py
new file mode 100644
index 000000000000..67bec51b248b
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/__init__.py
@@ -0,0 +1,30 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1 import publisher
+from google.cloud.pubsub_v1 import subscriber
+
+
+class PublisherClient(publisher.Client):
+    __doc__ = publisher.Client.__doc__
+
+
+class SubscriberClient(subscriber.Client):
+    __doc__ = subscriber.Client.__doc__
+
+
+__all__ = ("types", "PublisherClient", "SubscriberClient")
diff --git a/pubsub/google/cloud/pubsub_v1/_gapic.py b/pubsub/google/cloud/pubsub_v1/_gapic.py
new file mode 100644
index 000000000000..da755dfbca09
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/_gapic.py
@@ -0,0 +1,71 @@
+# Copyright 2019, Google LLC 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.
+
+from __future__ import absolute_import
+
+import functools
+
+
+def add_methods(source_class, blacklist=()):
+    """Add wrapped versions of the `api` member's methods to the class.
+
+    Any methods passed in `blacklist` are not added.
+    Additionally, any methods explicitly defined on the wrapped class are
+    not added.
+    """
+
+    def wrap(wrapped_fx, lookup_fx):
+        """Wrap a GAPIC method; preserve its name and docstring."""
+        # If this is a static or class method, then we do *not*
+        # send self as the first argument.
+        #
+        # For instance methods, we need to send self.api rather
+        # than self, since that is where the actual methods were declared.
+
+        if isinstance(lookup_fx, (classmethod, staticmethod)):
+            fx = lambda *a, **kw: wrapped_fx(*a, **kw)  # noqa
+            return staticmethod(functools.wraps(wrapped_fx)(fx))
+        else:
+            fx = lambda self, *a, **kw: wrapped_fx(self.api, *a, **kw)  # noqa
+            return functools.wraps(wrapped_fx)(fx)
+
+    def actual_decorator(cls):
+        # Reflectively iterate over most of the methods on the source class
+        # (the GAPIC) and make wrapped versions available on this client.
+        for name in dir(source_class):
+            # Ignore all private and magic methods.
+            if name.startswith("_"):
+                continue
+
+            # Ignore anything on our blacklist.
+            if name in blacklist:
+                continue
+
+            # Retrieve the attribute, and ignore it if it is not callable.
+            attr = getattr(source_class, name)
+            if not callable(attr):
+                continue
+
+            # Add a wrapper method to this object.
+            lookup_fx = source_class.__dict__[name]
+            fx = wrap(attr, lookup_fx)
+
+            setattr(cls, name, fx)
+
+        # Return the augmented class.
+        return cls
+
+    # Simply return the actual decorator; this is returned from this method
+    # and actually used to decorate the class.
+    return actual_decorator
diff --git a/pubsub/google/cloud/pubsub_v1/exceptions.py b/pubsub/google/cloud/pubsub_v1/exceptions.py
new file mode 100644
index 000000000000..5ab750d0477c
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/exceptions.py
@@ -0,0 +1,20 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from concurrent.futures import TimeoutError
+
+
+__all__ = ("TimeoutError",)
diff --git a/pubsub/google/cloud/pubsub_v1/futures.py b/pubsub/google/cloud/pubsub_v1/futures.py
new file mode 100644
index 000000000000..21d5d810199f
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/futures.py
@@ -0,0 +1,188 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import threading
+import uuid
+
+import google.api_core.future
+from google.cloud.pubsub_v1.publisher import exceptions
+
+
+class Future(google.api_core.future.Future):
+    """Encapsulation of the asynchronous execution of an action.
+
+    This object is returned from asychronous Pub/Sub calls, and is the
+    interface to determine the status of those calls.
+
+    This object should not be created directly, but is returned by other
+    methods in this library.
+
+    Args:
+        completed (Optional[Any]): An event, with the same interface as
+            :class:`threading.Event`. This is provided so that callers
+            with different concurrency models (e.g. ``threading`` or
+            ``multiprocessing``) can supply an event that is compatible
+            with that model. The ``wait()`` and ``set()`` methods will be
+            used. If this argument is not provided, then a new
+            :class:`threading.Event` will be created and used.
+    """
+
+    # This could be a sentinel object or None, but the sentinel object's ID
+    # can change if the process is forked, and None has the possibility of
+    # actually being a result.
+    _SENTINEL = uuid.uuid4()
+
+    def __init__(self, completed=None):
+        self._result = self._SENTINEL
+        self._exception = self._SENTINEL
+        self._callbacks = []
+        if completed is None:
+            completed = threading.Event()
+        self._completed = completed
+
+    def cancel(self):
+        """Actions in Pub/Sub generally may not be canceled.
+
+        This method always returns False.
+        """
+        return False
+
+    def cancelled(self):
+        """Actions in Pub/Sub generally may not be canceled.
+
+        This method always returns False.
+        """
+        return False
+
+    def running(self):
+        """Actions in Pub/Sub generally may not be canceled.
+
+        Returns:
+            bool: ``True`` if this method has not yet completed, or
+                ``False`` if it has completed.
+        """
+        if self.done():
+            return False
+        return True
+
+    def done(self):
+        """Return True the future is done, False otherwise.
+
+        This still returns True in failure cases; checking :meth:`result` or
+        :meth:`exception` is the canonical way to assess success or failure.
+        """
+        return self._exception != self._SENTINEL or self._result != self._SENTINEL
+
+    def result(self, timeout=None):
+        """Resolve the future and return a value where appropriate.
+
+        Args:
+            timeout (Union[int, float]): The number of seconds before this call
+                times out and raises TimeoutError.
+
+        Raises:
+            ~.pubsub_v1.TimeoutError: If the request times out.
+            Exception: For undefined exceptions in the underlying
+                call execution.
+        """
+        # Attempt to get the exception if there is one.
+        # If there is not one, then we know everything worked, and we can
+        # return an appropriate value.
+        err = self.exception(timeout=timeout)
+        if err is None:
+            return self._result
+        raise err
+
+    def exception(self, timeout=None):
+        """Return the exception raised by the call, if any.
+
+        Args:
+            timeout (Union[int, float]): The number of seconds before this call
+                times out and raises TimeoutError.
+
+        Raises:
+            TimeoutError: If the request times out.
+
+        Returns:
+            Exception: The exception raised by the call, if any.
+        """
+        # Wait until the future is done.
+        if not self._completed.wait(timeout=timeout):
+            raise exceptions.TimeoutError("Timed out waiting for result.")
+
+        # If the batch completed successfully, this should return None.
+        if self._result != self._SENTINEL:
+            return None
+
+        # Okay, this batch had an error; this should return it.
+        return self._exception
+
+    def add_done_callback(self, callback):
+        """Attach the provided callable to the future.
+
+        The provided function is called, with this future as its only argument,
+        when the future finishes running.
+
+        Args:
+            callback (Callable): The function to call.
+
+        Returns:
+            None
+        """
+        if self.done():
+            return callback(self)
+        self._callbacks.append(callback)
+
+    def set_result(self, result):
+        """Set the result of the future to the provided result.
+
+        Args:
+            result (Any): The result
+        """
+        # Sanity check: A future can only complete once.
+        if self.done():
+            raise RuntimeError("set_result can only be called once.")
+
+        # Set the result and trigger the future.
+        self._result = result
+        self._trigger()
+
+    def set_exception(self, exception):
+        """Set the result of the future to the given exception.
+
+        Args:
+            exception (:exc:`Exception`): The exception raised.
+        """
+        # Sanity check: A future can only complete once.
+        if self.done():
+            raise RuntimeError("set_exception can only be called once.")
+
+        # Set the exception and trigger the future.
+        self._exception = exception
+        self._trigger()
+
+    def _trigger(self):
+        """Trigger all callbacks registered to this Future.
+
+        This method is called internally by the batch once the batch
+        completes.
+
+        Args:
+            message_id (str): The message ID, as a string.
+        """
+        self._completed.set()
+        for callback in self._callbacks:
+            callback(self)
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/__init__.py b/pubsub/google/cloud/pubsub_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/publisher_client.py b/pubsub/google/cloud/pubsub_v1/gapic/publisher_client.py
new file mode 100644
index 000000000000..774fda25d622
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/gapic/publisher_client.py
@@ -0,0 +1,1095 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.pubsub.v1 Publisher API."""
+
+import collections
+from copy import deepcopy
+import functools
+import pkg_resources
+import six
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.path_template
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.pubsub_v1.gapic import publisher_client_config
+from google.cloud.pubsub_v1.gapic.transports import publisher_grpc_transport
+from google.cloud.pubsub_v1.proto import pubsub_pb2
+from google.cloud.pubsub_v1.proto import pubsub_pb2_grpc
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import iam_policy_pb2_grpc
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-pubsub").version
+
+
+# TODO: remove conditional import after Python 2 support is dropped
+if six.PY3:
+    from collections.abc import Mapping
+else:
+    from collections import Mapping
+
+
+def _merge_dict(d1, d2):
+    # Modifies d1 in-place to take values from d2
+    # if the nested keys from d2 are present in d1.
+    # https://stackoverflow.com/a/10704003/4488789
+    for k, v2 in d2.items():
+        v1 = d1.get(k)  # returns None if v1 has no such key
+        if v1 is None:
+            raise Exception("{} is not recognized by client_config".format(k))
+        if isinstance(v1, Mapping) and isinstance(v2, Mapping):
+            _merge_dict(v1, v2)
+        else:
+            d1[k] = v2
+    return d1
+
+
+class PublisherClient(object):
+    """
+    The service that an application uses to manipulate topics, and to send
+    messages to a topic.
+    """
+
+    SERVICE_ADDRESS = "pubsub.googleapis.com:443"
+    """The default address of the service."""
+
+    # The scopes needed to make gRPC calls to all of the methods defined in
+    # this service
+    _DEFAULT_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/pubsub",
+    )
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.pubsub.v1.Publisher"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            PublisherClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def topic_path(cls, project, topic):
+        """Return a fully-qualified topic string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/topics/{topic}", project=project, topic=topic
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.PublisherGrpcTransport,
+                    Callable[[~.Credentials, type], ~.PublisherGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        default_client_config = deepcopy(publisher_client_config.config)
+
+        if client_config is None:
+            client_config = default_client_config
+        else:
+            client_config = _merge_dict(default_client_config, client_config)
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=publisher_grpc_transport.PublisherGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = publisher_grpc_transport.PublisherGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_topic(
+        self,
+        name,
+        labels=None,
+        message_storage_policy=None,
+        kms_key_name=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates the given topic with the given name. See the resource name
+        rules.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> name = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> response = client.create_topic(name)
+
+        Args:
+            name (str): 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"`.
+            labels (dict[str -> str]): See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+                managing labels</a>.
+            message_storage_policy (Union[dict, ~google.cloud.pubsub_v1.types.MessageStoragePolicy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.MessageStoragePolicy`
+            kms_key_name (str): 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/*``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Topic` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_topic" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_topic"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_topic,
+                default_retry=self._method_configs["CreateTopic"].retry,
+                default_timeout=self._method_configs["CreateTopic"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.Topic(
+            name=name,
+            labels=labels,
+            message_storage_policy=message_storage_policy,
+            kms_key_name=kms_key_name,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_topic"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_topic(
+        self,
+        topic,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing topic. Note that certain properties of a
+        topic are not modifiable.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> # TODO: Initialize `topic`:
+            >>> topic = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_topic(topic, update_mask)
+
+        Args:
+            topic (Union[dict, ~google.cloud.pubsub_v1.types.Topic]): The updated topic object.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Topic`
+            update_mask (Union[dict, ~google.cloud.pubsub_v1.types.FieldMask]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Topic` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_topic" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_topic"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_topic,
+                default_retry=self._method_configs["UpdateTopic"].retry,
+                default_timeout=self._method_configs["UpdateTopic"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.UpdateTopicRequest(topic=topic, update_mask=update_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("topic.name", topic.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_topic"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def publish(
+        self,
+        topic,
+        messages,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Adds one or more messages to the topic. Returns ``NOT_FOUND`` if the
+        topic does not exist.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> topic = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>> data = b''
+            >>> messages_element = {'data': data}
+            >>> messages = [messages_element]
+            >>>
+            >>> response = client.publish(topic, messages)
+
+        Args:
+            topic (str): The messages in the request will be published on this topic. Format is
+                ``projects/{project}/topics/{topic}``.
+            messages (list[Union[dict, ~google.cloud.pubsub_v1.types.PubsubMessage]]): The messages to publish.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.PubsubMessage`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.PublishResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "publish" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "publish"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.publish,
+                default_retry=self._method_configs["Publish"].retry,
+                default_timeout=self._method_configs["Publish"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.PublishRequest(topic=topic, messages=messages)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("topic", topic)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["publish"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_topic(
+        self,
+        topic,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the configuration of a topic.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> topic = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> response = client.get_topic(topic)
+
+        Args:
+            topic (str): The name of the topic to get. Format is
+                ``projects/{project}/topics/{topic}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Topic` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_topic" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_topic"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_topic,
+                default_retry=self._method_configs["GetTopic"].retry,
+                default_timeout=self._method_configs["GetTopic"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.GetTopicRequest(topic=topic)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("topic", topic)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_topic"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_topics(
+        self,
+        project,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists matching topics.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> project = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_topics(project):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_topics(project).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project (str): The name of the project in which to list topics. Format is
+                ``projects/{project-id}``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.GRPCIterator` instance.
+            An iterable of :class:`~google.cloud.pubsub_v1.types.Topic` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_topics" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_topics"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_topics,
+                default_retry=self._method_configs["ListTopics"].retry,
+                default_timeout=self._method_configs["ListTopics"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.ListTopicsRequest(project=project, page_size=page_size)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project", project)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_topics"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="topics",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_topic_subscriptions(
+        self,
+        topic,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the names of the subscriptions on this topic.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> topic = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_topic_subscriptions(topic):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_topic_subscriptions(topic).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            topic (str): The name of the topic that subscriptions are attached to. Format is
+                ``projects/{project}/topics/{topic}``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.GRPCIterator` instance.
+            An iterable of :class:`str` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_topic_subscriptions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_topic_subscriptions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_topic_subscriptions,
+                default_retry=self._method_configs["ListTopicSubscriptions"].retry,
+                default_timeout=self._method_configs["ListTopicSubscriptions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.ListTopicSubscriptionsRequest(
+            topic=topic, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("topic", topic)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_topic_subscriptions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="subscriptions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_topic(
+        self,
+        topic,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the topic with the given name. Returns ``NOT_FOUND`` if the
+        topic does not exist. After a topic is deleted, a new topic may be
+        created with the same name; this is an entirely new topic with none of
+        the old configuration or subscriptions. Existing subscriptions to this
+        topic are not deleted, but their ``topic`` field is set to
+        ``_deleted-topic_``.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> topic = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> client.delete_topic(topic)
+
+        Args:
+            topic (str): Name of the topic to delete. Format is
+                ``projects/{project}/topics/{topic}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_topic" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_topic"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_topic,
+                default_retry=self._method_configs["DeleteTopic"].retry,
+                default_timeout=self._method_configs["DeleteTopic"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.DeleteTopicRequest(topic=topic)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("topic", topic)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_topic"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on the specified resource. Replaces any
+        existing policy.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> resource = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.pubsub_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a resource.
+        Returns an empty policy if the resource exists and does not have a policy
+        set.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> resource = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.pubsub_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.PublisherClient()
+            >>>
+            >>> resource = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/publisher_client_config.py b/pubsub/google/cloud/pubsub_v1/gapic/publisher_client_config.py
new file mode 100644
index 000000000000..33f0af827924
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/gapic/publisher_client_config.py
@@ -0,0 +1,99 @@
+config = {
+    "interfaces": {
+        "google.pubsub.v1.Publisher": {
+            "retry_codes": {
+                "idempotent": ["ABORTED", "UNAVAILABLE", "UNKNOWN"],
+                "non_idempotent": ["UNAVAILABLE"],
+                "none": [],
+                "publish": [
+                    "ABORTED",
+                    "CANCELLED",
+                    "DEADLINE_EXCEEDED",
+                    "INTERNAL",
+                    "RESOURCE_EXHAUSTED",
+                    "UNAVAILABLE",
+                    "UNKNOWN",
+                ],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                },
+                "messaging": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 25000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 30000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "CreateTopic": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTopic": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Publish": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "publish",
+                    "retry_params_name": "messaging",
+                    "bundling": {
+                        "element_count_threshold": 10,
+                        "element_count_limit": 1000,
+                        "request_byte_threshold": 1024,
+                        "request_byte_limit": 10485760,
+                        "delay_threshold_millis": 10,
+                    },
+                },
+                "GetTopic": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTopics": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTopicSubscriptions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTopic": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/subscriber_client.py b/pubsub/google/cloud/pubsub_v1/gapic/subscriber_client.py
new file mode 100644
index 000000000000..0ecce7ac9d1c
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/gapic/subscriber_client.py
@@ -0,0 +1,1885 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.pubsub.v1 Subscriber API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.pubsub_v1.gapic import subscriber_client_config
+from google.cloud.pubsub_v1.gapic.transports import subscriber_grpc_transport
+from google.cloud.pubsub_v1.proto import pubsub_pb2
+from google.cloud.pubsub_v1.proto import pubsub_pb2_grpc
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import iam_policy_pb2_grpc
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-pubsub").version
+
+
+class SubscriberClient(object):
+    """
+    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_ADDRESS = "pubsub.googleapis.com:443"
+    """The default address of the service."""
+
+    # The scopes needed to make gRPC calls to all of the methods defined in
+    # this service
+    _DEFAULT_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/pubsub",
+    )
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.pubsub.v1.Subscriber"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            SubscriberClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def snapshot_path(cls, project, snapshot):
+        """Return a fully-qualified snapshot string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/snapshots/{snapshot}",
+            project=project,
+            snapshot=snapshot,
+        )
+
+    @classmethod
+    def subscription_path(cls, project, subscription):
+        """Return a fully-qualified subscription string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/subscriptions/{subscription}",
+            project=project,
+            subscription=subscription,
+        )
+
+    @classmethod
+    def topic_path(cls, project, topic):
+        """Return a fully-qualified topic string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/topics/{topic}", project=project, topic=topic
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.SubscriberGrpcTransport,
+                    Callable[[~.Credentials, type], ~.SubscriberGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = subscriber_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=subscriber_grpc_transport.SubscriberGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = subscriber_grpc_transport.SubscriberGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_subscription(
+        self,
+        name,
+        topic,
+        push_config=None,
+        ack_deadline_seconds=None,
+        retain_acked_messages=None,
+        message_retention_duration=None,
+        labels=None,
+        enable_message_ordering=None,
+        expiration_policy=None,
+        dead_letter_policy=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a subscription to a given topic. See the resource name rules. If
+        the subscription already exists, returns ``ALREADY_EXISTS``. If the
+        corresponding topic doesn't exist, returns ``NOT_FOUND``.
+
+        If the name is not provided in the request, the server will assign a
+        random name for this subscription on the same project as the topic,
+        conforming to the `resource name
+        format <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+        The generated name is populated in the returned Subscription object.
+        Note that for REST API requests, you must specify a name in the request.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> name = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>> topic = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>>
+            >>> response = client.create_subscription(name, topic)
+
+        Args:
+            name (str): 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"`
+            topic (str): 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.
+            push_config (Union[dict, ~google.cloud.pubsub_v1.types.PushConfig]): If push delivery is used with this subscription, this field is used to
+                configure it. An empty ``pushConfig`` signifies that the subscriber will
+                pull and ack messages using API methods.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.PushConfig`
+            ack_deadline_seconds (int): The approximate amount of time (on a best-effort basis) Pub/Sub waits
+                for the subscriber to acknowledge receipt before resending the message.
+                In the interval after the message is delivered and before it is
+                acknowledged, it is considered to be outstanding. During that time
+                period, the message will not be redelivered (on a best-effort basis).
+
+                For pull subscriptions, this value is used as the initial value for the
+                ack deadline. To override this value for a given message, call
+                ``ModifyAckDeadline`` with the corresponding ``ack_id`` if using
+                non-streaming pull or send the ``ack_id`` in a
+                ``StreamingModifyAckDeadlineRequest`` if using streaming pull. The
+                minimum custom deadline you can specify is 10 seconds. The maximum
+                custom deadline you can specify is 600 seconds (10 minutes). If this
+                parameter is 0, a default value of 10 seconds is used.
+
+                For push delivery, this value is also used to set the request timeout
+                for the call to the push endpoint.
+
+                If the subscriber never acknowledges the message, the Pub/Sub system
+                will eventually redeliver the message.
+            retain_acked_messages (bool): Indicates whether to retain acknowledged messages. If true, then
+                messages are not expunged from the subscription's backlog, even if they
+                are acknowledged, until they fall out of the
+                ``message_retention_duration`` window. This must be true if you would
+                like to Seek to a timestamp.
+            message_retention_duration (Union[dict, ~google.cloud.pubsub_v1.types.Duration]): How long to retain unacknowledged messages in the subscription's
+                backlog, from the moment a message is published. If
+                ``retain_acked_messages`` is true, then this also configures the
+                retention of acknowledged messages, and thus configures how far back in
+                time a ``Seek`` can be done. Defaults to 7 days. Cannot be more than 7
+                days or less than 10 minutes.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Duration`
+            labels (dict[str -> str]): See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+                managing labels</a>.
+            enable_message_ordering (bool): If true, messages published with the same ``ordering_key`` in
+                ``PubsubMessage`` will be delivered to the subscribers in the order in
+                which they are received by the Pub/Sub system. Otherwise, they may be
+                delivered in any order. 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.
+            expiration_policy (Union[dict, ~google.cloud.pubsub_v1.types.ExpirationPolicy]): A policy that specifies the conditions for this subscription's
+                expiration. A subscription is considered active as long as any connected
+                subscriber is successfully consuming messages from the subscription or
+                is issuing operations on the subscription. If ``expiration_policy`` is
+                not set, a *default policy* with ``ttl`` of 31 days will be used. The
+                minimum allowed value for ``expiration_policy.ttl`` is 1 day.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.ExpirationPolicy`
+            dead_letter_policy (Union[dict, ~google.cloud.pubsub_v1.types.DeadLetterPolicy]): 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.
+                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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.DeadLetterPolicy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Subscription` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_subscription,
+                default_retry=self._method_configs["CreateSubscription"].retry,
+                default_timeout=self._method_configs["CreateSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.Subscription(
+            name=name,
+            topic=topic,
+            push_config=push_config,
+            ack_deadline_seconds=ack_deadline_seconds,
+            retain_acked_messages=retain_acked_messages,
+            message_retention_duration=message_retention_duration,
+            labels=labels,
+            enable_message_ordering=enable_message_ordering,
+            expiration_policy=expiration_policy,
+            dead_letter_policy=dead_letter_policy,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_subscription(
+        self,
+        subscription,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the configuration details of a subscription.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> response = client.get_subscription(subscription)
+
+        Args:
+            subscription (str): The name of the subscription to get. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Subscription` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_subscription,
+                default_retry=self._method_configs["GetSubscription"].retry,
+                default_timeout=self._method_configs["GetSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.GetSubscriptionRequest(subscription=subscription)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_subscription(
+        self,
+        subscription,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing subscription. Note that certain properties of a
+        subscription, such as its topic, are not modifiable.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> ack_deadline_seconds = 42
+            >>> subscription = {'ack_deadline_seconds': ack_deadline_seconds}
+            >>> paths_element = 'ack_deadline_seconds'
+            >>> paths = [paths_element]
+            >>> update_mask = {'paths': paths}
+            >>>
+            >>> response = client.update_subscription(subscription, update_mask)
+
+        Args:
+            subscription (Union[dict, ~google.cloud.pubsub_v1.types.Subscription]): The updated subscription object.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Subscription`
+            update_mask (Union[dict, ~google.cloud.pubsub_v1.types.FieldMask]): Indicates which fields in the provided subscription to update.
+                Must be specified and non-empty.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Subscription` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_subscription,
+                default_retry=self._method_configs["UpdateSubscription"].retry,
+                default_timeout=self._method_configs["UpdateSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.UpdateSubscriptionRequest(
+            subscription=subscription, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription.name", subscription.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_subscriptions(
+        self,
+        project,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists matching subscriptions.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> project = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_subscriptions(project):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_subscriptions(project).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project (str): The name of the project in which to list subscriptions. Format is
+                ``projects/{project-id}``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.GRPCIterator` instance.
+            An iterable of :class:`~google.cloud.pubsub_v1.types.Subscription` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_subscriptions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_subscriptions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_subscriptions,
+                default_retry=self._method_configs["ListSubscriptions"].retry,
+                default_timeout=self._method_configs["ListSubscriptions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.ListSubscriptionsRequest(
+            project=project, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project", project)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_subscriptions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="subscriptions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_subscription(
+        self,
+        subscription,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing subscription. All messages retained in the
+        subscription are immediately dropped. Calls to ``Pull`` after deletion
+        will return ``NOT_FOUND``. After a subscription is deleted, a new one
+        may be created with the same name, but the new one has no association
+        with the old subscription or its topic unless the same topic is
+        specified.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> client.delete_subscription(subscription)
+
+        Args:
+            subscription (str): The subscription to delete. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_subscription" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_subscription"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_subscription,
+                default_retry=self._method_configs["DeleteSubscription"].retry,
+                default_timeout=self._method_configs["DeleteSubscription"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.DeleteSubscriptionRequest(subscription=subscription)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_subscription"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def modify_ack_deadline(
+        self,
+        subscription,
+        ack_ids,
+        ack_deadline_seconds,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Modifies the ack deadline for a specific message. This method is useful
+        to indicate that more time is needed to process a message by the
+        subscriber, or to make the message available for redelivery if the
+        processing was interrupted. Note that this does not modify the
+        subscription-level ``ackDeadlineSeconds`` used for subsequent messages.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `ack_ids`:
+            >>> ack_ids = []
+            >>>
+            >>> # TODO: Initialize `ack_deadline_seconds`:
+            >>> ack_deadline_seconds = 0
+            >>>
+            >>> client.modify_ack_deadline(subscription, ack_ids, ack_deadline_seconds)
+
+        Args:
+            subscription (str): The name of the subscription. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            ack_ids (list[str]): List of acknowledgment IDs.
+            ack_deadline_seconds (int): 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).
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "modify_ack_deadline" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "modify_ack_deadline"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.modify_ack_deadline,
+                default_retry=self._method_configs["ModifyAckDeadline"].retry,
+                default_timeout=self._method_configs["ModifyAckDeadline"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.ModifyAckDeadlineRequest(
+            subscription=subscription,
+            ack_ids=ack_ids,
+            ack_deadline_seconds=ack_deadline_seconds,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["modify_ack_deadline"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def acknowledge(
+        self,
+        subscription,
+        ack_ids,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Acknowledges the messages associated with the ``ack_ids`` in the
+        ``AcknowledgeRequest``. The Pub/Sub system can remove the relevant
+        messages from the subscription.
+
+        Acknowledging a message whose ack deadline has expired may succeed, but
+        such a message may be redelivered later. Acknowledging a message more
+        than once will not result in an error.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `ack_ids`:
+            >>> ack_ids = []
+            >>>
+            >>> client.acknowledge(subscription, ack_ids)
+
+        Args:
+            subscription (str): The subscription whose message is being acknowledged. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            ack_ids (list[str]): The acknowledgment ID for the messages being acknowledged that was
+                returned by the Pub/Sub system in the ``Pull`` response. Must not be
+                empty.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "acknowledge" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "acknowledge"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.acknowledge,
+                default_retry=self._method_configs["Acknowledge"].retry,
+                default_timeout=self._method_configs["Acknowledge"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.AcknowledgeRequest(
+            subscription=subscription, ack_ids=ack_ids
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["acknowledge"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pull(
+        self,
+        subscription,
+        max_messages,
+        return_immediately=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pulls messages from the server. The server may return ``UNAVAILABLE`` if
+        there are too many concurrent pull requests pending for the given
+        subscription.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `max_messages`:
+            >>> max_messages = 0
+            >>>
+            >>> response = client.pull(subscription, max_messages)
+
+        Args:
+            subscription (str): The subscription from which messages should be pulled. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            max_messages (int): 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.
+            return_immediately (bool): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.PullResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pull" not in self._inner_api_calls:
+            self._inner_api_calls["pull"] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pull,
+                default_retry=self._method_configs["Pull"].retry,
+                default_timeout=self._method_configs["Pull"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.PullRequest(
+            subscription=subscription,
+            max_messages=max_messages,
+            return_immediately=return_immediately,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["pull"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def streaming_pull(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Establishes a stream with the server, which sends messages down to the
+        client. The client streams acknowledgements and ack deadline
+        modifications back to the server. The server will close the stream and
+        return the status on any error. The server may close the stream with
+        status ``UNAVAILABLE`` to reassign server-side resources, in which case,
+        the client should re-establish the stream. Flow control can be achieved
+        by configuring the underlying RPC channel.
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `stream_ack_deadline_seconds`:
+            >>> stream_ack_deadline_seconds = 0
+            >>> request = {'subscription': subscription, 'stream_ack_deadline_seconds': stream_ack_deadline_seconds}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.streaming_pull(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.pubsub_v1.proto.pubsub_pb2.StreamingPullRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.pubsub_v1.types.StreamingPullRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.pubsub_v1.types.StreamingPullResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "streaming_pull" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "streaming_pull"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.streaming_pull,
+                default_retry=self._method_configs["StreamingPull"].retry,
+                default_timeout=self._method_configs["StreamingPull"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["streaming_pull"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def modify_push_config(
+        self,
+        subscription,
+        push_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Modifies the ``PushConfig`` for a specified subscription.
+
+        This may be used to change a push subscription to a pull one (signified
+        by an empty ``PushConfig``) or vice versa, or change the endpoint URL
+        and other attributes of a push subscription. Messages will accumulate
+        for delivery continuously through the call regardless of changes to the
+        ``PushConfig``.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `push_config`:
+            >>> push_config = {}
+            >>>
+            >>> client.modify_push_config(subscription, push_config)
+
+        Args:
+            subscription (str): The name of the subscription. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            push_config (Union[dict, ~google.cloud.pubsub_v1.types.PushConfig]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.PushConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "modify_push_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "modify_push_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.modify_push_config,
+                default_retry=self._method_configs["ModifyPushConfig"].retry,
+                default_timeout=self._method_configs["ModifyPushConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.ModifyPushConfigRequest(
+            subscription=subscription, push_config=push_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["modify_push_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_snapshots(
+        self,
+        project,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the existing snapshots. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> project = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_snapshots(project):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_snapshots(project).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project (str): The name of the project in which to list snapshots. Format is
+                ``projects/{project-id}``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.GRPCIterator` instance.
+            An iterable of :class:`~google.cloud.pubsub_v1.types.Snapshot` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_snapshots" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_snapshots"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_snapshots,
+                default_retry=self._method_configs["ListSnapshots"].retry,
+                default_timeout=self._method_configs["ListSnapshots"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.ListSnapshotsRequest(project=project, page_size=page_size)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project", project)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_snapshots"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="snapshots",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_snapshot(
+        self,
+        name,
+        subscription,
+        labels=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a snapshot from the requested subscription. Snapshots are used
+        in Seek operations, which allow you to manage message acknowledgments in
+        bulk. That is, you can set the acknowledgment state of messages in an
+        existing subscription to the state captured by a snapshot. If the
+        snapshot already exists, returns ``ALREADY_EXISTS``. If the requested
+        subscription doesn't exist, returns ``NOT_FOUND``. If the backlog in the
+        subscription is too old -- and the resulting snapshot would expire in
+        less than 1 hour -- then ``FAILED_PRECONDITION`` is returned. See also
+        the ``Snapshot.expire_time`` field. 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, conforming to the `resource name
+        format <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+        The generated name is populated in the returned Snapshot object. Note
+        that for REST API requests, you must specify a name in the request.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> name = client.snapshot_path('[PROJECT]', '[SNAPSHOT]')
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> response = client.create_snapshot(name, subscription)
+
+        Args:
+            name (str): 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}``.
+            subscription (str): 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 unacknowledged upon the successful
+                completion of the ``CreateSnapshot`` request; as well as: (b) Any
+                messages published to the subscription's topic following the successful
+                completion of the CreateSnapshot request. Format is
+                ``projects/{project}/subscriptions/{sub}``.
+            labels (dict[str -> str]): See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+                managing labels</a>.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Snapshot` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_snapshot" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_snapshot"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_snapshot,
+                default_retry=self._method_configs["CreateSnapshot"].retry,
+                default_timeout=self._method_configs["CreateSnapshot"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.CreateSnapshotRequest(
+            name=name, subscription=subscription, labels=labels
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_snapshot"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_snapshot(
+        self,
+        snapshot,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an existing snapshot. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> seconds = 123456
+            >>> expire_time = {'seconds': seconds}
+            >>> snapshot = {'expire_time': expire_time}
+            >>> paths_element = 'expire_time'
+            >>> paths = [paths_element]
+            >>> update_mask = {'paths': paths}
+            >>>
+            >>> response = client.update_snapshot(snapshot, update_mask)
+
+        Args:
+            snapshot (Union[dict, ~google.cloud.pubsub_v1.types.Snapshot]): The updated snapshot object.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Snapshot`
+            update_mask (Union[dict, ~google.cloud.pubsub_v1.types.FieldMask]): Indicates which fields in the provided snapshot to update.
+                Must be specified and non-empty.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Snapshot` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_snapshot" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_snapshot"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_snapshot,
+                default_retry=self._method_configs["UpdateSnapshot"].retry,
+                default_timeout=self._method_configs["UpdateSnapshot"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.UpdateSnapshotRequest(
+            snapshot=snapshot, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("snapshot.name", snapshot.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_snapshot"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_snapshot(
+        self,
+        snapshot,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Removes an existing snapshot. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot.<br><br>
+        When the snapshot is deleted, all messages retained in the snapshot
+        are immediately dropped. After a snapshot is deleted, a new one may be
+        created with the same name, but the new one has no association with the old
+        snapshot or its subscription, unless the same subscription is specified.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> snapshot = client.snapshot_path('[PROJECT]', '[SNAPSHOT]')
+            >>>
+            >>> client.delete_snapshot(snapshot)
+
+        Args:
+            snapshot (str): The name of the snapshot to delete. Format is
+                ``projects/{project}/snapshots/{snap}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_snapshot" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_snapshot"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_snapshot,
+                default_retry=self._method_configs["DeleteSnapshot"].retry,
+                default_timeout=self._method_configs["DeleteSnapshot"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = pubsub_pb2.DeleteSnapshotRequest(snapshot=snapshot)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("snapshot", snapshot)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_snapshot"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def seek(
+        self,
+        subscription,
+        time=None,
+        snapshot=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Seeks an existing subscription to a point in time or to a given snapshot,
+        whichever is provided in the request. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot. Note that both the subscription and the snapshot
+        must be on the same topic.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> subscription = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> response = client.seek(subscription)
+
+        Args:
+            subscription (str): The subscription to affect.
+            time (Union[dict, ~google.cloud.pubsub_v1.types.Timestamp]): The time to seek to. Messages retained in the subscription that were
+                published before this time are marked as acknowledged, and messages
+                retained in the subscription that were published after this time are
+                marked as unacknowledged. Note that this operation affects only those
+                messages retained in the subscription (configured by the combination of
+                ``message_retention_duration`` and ``retain_acked_messages``). For
+                example, if ``time`` corresponds to a point before the message retention
+                window (or to a point before the system's notion of the subscription
+                creation time), only retained messages will be marked as unacknowledged,
+                and already-expunged messages will not be restored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Timestamp`
+            snapshot (str): 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}``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.SeekResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "seek" not in self._inner_api_calls:
+            self._inner_api_calls["seek"] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.seek,
+                default_retry=self._method_configs["Seek"].retry,
+                default_timeout=self._method_configs["Seek"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(time=time, snapshot=snapshot)
+
+        request = pubsub_pb2.SeekRequest(
+            subscription=subscription, time=time, snapshot=snapshot
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("subscription", subscription)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["seek"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on the specified resource. Replaces any
+        existing policy.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> resource = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.pubsub_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a resource.
+        Returns an empty policy if the resource exists and does not have a policy
+        set.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> resource = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.pubsub_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.pubsub_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>>
+            >>> client = pubsub_v1.SubscriberClient()
+            >>>
+            >>> resource = client.subscription_path('[PROJECT]', '[SUBSCRIPTION]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/subscriber_client_config.py b/pubsub/google/cloud/pubsub_v1/gapic/subscriber_client_config.py
new file mode 100644
index 000000000000..0aa68315c1c0
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/gapic/subscriber_client_config.py
@@ -0,0 +1,132 @@
+config = {
+    "interfaces": {
+        "google.pubsub.v1.Subscriber": {
+            "retry_codes": {
+                "idempotent": ["ABORTED", "UNAVAILABLE", "UNKNOWN"],
+                "non_idempotent": ["UNAVAILABLE"],
+                "none": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                },
+                "messaging": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 25000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 25000,
+                    "total_timeout_millis": 600000,
+                },
+                "streaming_messaging": {
+                    "initial_retry_delay_millis": 100,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 60000,
+                    "initial_rpc_timeout_millis": 600000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 600000,
+                    "total_timeout_millis": 600000,
+                },
+            },
+            "methods": {
+                "CreateSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListSubscriptions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteSubscription": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ModifyAckDeadline": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Acknowledge": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "messaging",
+                },
+                "Pull": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "messaging",
+                },
+                "StreamingPull": {
+                    "timeout_millis": 900000,
+                    "retry_codes_name": "none",
+                    "retry_params_name": "streaming_messaging",
+                },
+                "ModifyPushConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListSnapshots": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "Seek": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/transports/__init__.py b/pubsub/google/cloud/pubsub_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/transports/publisher_grpc_transport.py b/pubsub/google/cloud/pubsub_v1/gapic/transports/publisher_grpc_transport.py
new file mode 100644
index 000000000000..aedcc8c465e1
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/gapic/transports/publisher_grpc_transport.py
@@ -0,0 +1,260 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.pubsub_v1.proto import pubsub_pb2_grpc
+from google.iam.v1 import iam_policy_pb2_grpc as iam_policy_pb2_grpc
+
+
+class PublisherGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.pubsub.v1 Publisher API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/pubsub",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="pubsub.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "iam_policy_stub": iam_policy_pb2_grpc.IAMPolicyStub(channel),
+            "publisher_stub": pubsub_pb2_grpc.PublisherStub(channel),
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="pubsub.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_topic(self):
+        """Return the gRPC stub for :meth:`PublisherClient.create_topic`.
+
+        Creates the given topic with the given name. See the resource name
+        rules.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].CreateTopic
+
+    @property
+    def update_topic(self):
+        """Return the gRPC stub for :meth:`PublisherClient.update_topic`.
+
+        Updates an existing topic. Note that certain properties of a
+        topic are not modifiable.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].UpdateTopic
+
+    @property
+    def publish(self):
+        """Return the gRPC stub for :meth:`PublisherClient.publish`.
+
+        Adds one or more messages to the topic. Returns ``NOT_FOUND`` if the
+        topic does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].Publish
+
+    @property
+    def get_topic(self):
+        """Return the gRPC stub for :meth:`PublisherClient.get_topic`.
+
+        Gets the configuration of a topic.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].GetTopic
+
+    @property
+    def list_topics(self):
+        """Return the gRPC stub for :meth:`PublisherClient.list_topics`.
+
+        Lists matching topics.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].ListTopics
+
+    @property
+    def list_topic_subscriptions(self):
+        """Return the gRPC stub for :meth:`PublisherClient.list_topic_subscriptions`.
+
+        Lists the names of the subscriptions on this topic.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].ListTopicSubscriptions
+
+    @property
+    def delete_topic(self):
+        """Return the gRPC stub for :meth:`PublisherClient.delete_topic`.
+
+        Deletes the topic with the given name. Returns ``NOT_FOUND`` if the
+        topic does not exist. After a topic is deleted, a new topic may be
+        created with the same name; this is an entirely new topic with none of
+        the old configuration or subscriptions. Existing subscriptions to this
+        topic are not deleted, but their ``topic`` field is set to
+        ``_deleted-topic_``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["publisher_stub"].DeleteTopic
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`PublisherClient.set_iam_policy`.
+
+        Sets the access control policy on the specified resource. Replaces any
+        existing policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`PublisherClient.get_iam_policy`.
+
+        Gets the access control policy for a resource.
+        Returns an empty policy if the resource exists and does not have a policy
+        set.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`PublisherClient.test_iam_permissions`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].TestIamPermissions
diff --git a/pubsub/google/cloud/pubsub_v1/gapic/transports/subscriber_grpc_transport.py b/pubsub/google/cloud/pubsub_v1/gapic/transports/subscriber_grpc_transport.py
new file mode 100644
index 000000000000..fa8ac9f29329
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/gapic/transports/subscriber_grpc_transport.py
@@ -0,0 +1,434 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.pubsub_v1.proto import pubsub_pb2_grpc
+from google.iam.v1 import iam_policy_pb2_grpc as iam_policy_pb2_grpc
+
+
+class SubscriberGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.pubsub.v1 Subscriber API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/pubsub",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="pubsub.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "iam_policy_stub": iam_policy_pb2_grpc.IAMPolicyStub(channel),
+            "subscriber_stub": pubsub_pb2_grpc.SubscriberStub(channel),
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="pubsub.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_subscription(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.create_subscription`.
+
+        Creates a subscription to a given topic. See the resource name rules. If
+        the subscription already exists, returns ``ALREADY_EXISTS``. If the
+        corresponding topic doesn't exist, returns ``NOT_FOUND``.
+
+        If the name is not provided in the request, the server will assign a
+        random name for this subscription on the same project as the topic,
+        conforming to the `resource name
+        format <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+        The generated name is populated in the returned Subscription object.
+        Note that for REST API requests, you must specify a name in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].CreateSubscription
+
+    @property
+    def get_subscription(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.get_subscription`.
+
+        Gets the configuration details of a subscription.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].GetSubscription
+
+    @property
+    def update_subscription(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.update_subscription`.
+
+        Updates an existing subscription. Note that certain properties of a
+        subscription, such as its topic, are not modifiable.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].UpdateSubscription
+
+    @property
+    def list_subscriptions(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.list_subscriptions`.
+
+        Lists matching subscriptions.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].ListSubscriptions
+
+    @property
+    def delete_subscription(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.delete_subscription`.
+
+        Deletes an existing subscription. All messages retained in the
+        subscription are immediately dropped. Calls to ``Pull`` after deletion
+        will return ``NOT_FOUND``. After a subscription is deleted, a new one
+        may be created with the same name, but the new one has no association
+        with the old subscription or its topic unless the same topic is
+        specified.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].DeleteSubscription
+
+    @property
+    def modify_ack_deadline(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.modify_ack_deadline`.
+
+        Modifies the ack deadline for a specific message. This method is useful
+        to indicate that more time is needed to process a message by the
+        subscriber, or to make the message available for redelivery if the
+        processing was interrupted. Note that this does not modify the
+        subscription-level ``ackDeadlineSeconds`` used for subsequent messages.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].ModifyAckDeadline
+
+    @property
+    def acknowledge(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.acknowledge`.
+
+        Acknowledges the messages associated with the ``ack_ids`` in the
+        ``AcknowledgeRequest``. The Pub/Sub system can remove the relevant
+        messages from the subscription.
+
+        Acknowledging a message whose ack deadline has expired may succeed, but
+        such a message may be redelivered later. Acknowledging a message more
+        than once will not result in an error.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].Acknowledge
+
+    @property
+    def pull(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.pull`.
+
+        Pulls messages from the server. The server may return ``UNAVAILABLE`` if
+        there are too many concurrent pull requests pending for the given
+        subscription.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].Pull
+
+    @property
+    def streaming_pull(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.streaming_pull`.
+
+        Establishes a stream with the server, which sends messages down to the
+        client. The client streams acknowledgements and ack deadline
+        modifications back to the server. The server will close the stream and
+        return the status on any error. The server may close the stream with
+        status ``UNAVAILABLE`` to reassign server-side resources, in which case,
+        the client should re-establish the stream. Flow control can be achieved
+        by configuring the underlying RPC channel.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].StreamingPull
+
+    @property
+    def modify_push_config(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.modify_push_config`.
+
+        Modifies the ``PushConfig`` for a specified subscription.
+
+        This may be used to change a push subscription to a pull one (signified
+        by an empty ``PushConfig``) or vice versa, or change the endpoint URL
+        and other attributes of a push subscription. Messages will accumulate
+        for delivery continuously through the call regardless of changes to the
+        ``PushConfig``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].ModifyPushConfig
+
+    @property
+    def list_snapshots(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.list_snapshots`.
+
+        Lists the existing snapshots. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].ListSnapshots
+
+    @property
+    def create_snapshot(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.create_snapshot`.
+
+        Creates a snapshot from the requested subscription. Snapshots are used
+        in Seek operations, which allow you to manage message acknowledgments in
+        bulk. That is, you can set the acknowledgment state of messages in an
+        existing subscription to the state captured by a snapshot. If the
+        snapshot already exists, returns ``ALREADY_EXISTS``. If the requested
+        subscription doesn't exist, returns ``NOT_FOUND``. If the backlog in the
+        subscription is too old -- and the resulting snapshot would expire in
+        less than 1 hour -- then ``FAILED_PRECONDITION`` is returned. See also
+        the ``Snapshot.expire_time`` field. 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, conforming to the `resource name
+        format <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+        The generated name is populated in the returned Snapshot object. Note
+        that for REST API requests, you must specify a name in the request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].CreateSnapshot
+
+    @property
+    def update_snapshot(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.update_snapshot`.
+
+        Updates an existing snapshot. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].UpdateSnapshot
+
+    @property
+    def delete_snapshot(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.delete_snapshot`.
+
+        Removes an existing snapshot. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot.<br><br>
+        When the snapshot is deleted, all messages retained in the snapshot
+        are immediately dropped. After a snapshot is deleted, a new one may be
+        created with the same name, but the new one has no association with the old
+        snapshot or its subscription, unless the same subscription is specified.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].DeleteSnapshot
+
+    @property
+    def seek(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.seek`.
+
+        Seeks an existing subscription to a point in time or to a given snapshot,
+        whichever is provided in the request. Snapshots are used in
+        <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+        operations, which allow
+        you to manage message acknowledgments in bulk. That is, you can set the
+        acknowledgment state of messages in an existing subscription to the state
+        captured by a snapshot. Note that both the subscription and the snapshot
+        must be on the same topic.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["subscriber_stub"].Seek
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.set_iam_policy`.
+
+        Sets the access control policy on the specified resource. Replaces any
+        existing policy.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.get_iam_policy`.
+
+        Gets the access control policy for a resource.
+        Returns an empty policy if the resource exists and does not have a policy
+        set.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`SubscriberClient.test_iam_permissions`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["iam_policy_stub"].TestIamPermissions
diff --git a/pubsub/google/cloud/pubsub_v1/proto/__init__.py b/pubsub/google/cloud/pubsub_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/pubsub/google/cloud/pubsub_v1/proto/pubsub.proto b/pubsub/google/cloud/pubsub_v1/proto/pubsub.proto
new file mode 100644
index 000000000000..3ad6355a8bf6
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/proto/pubsub.proto
@@ -0,0 +1,1067 @@
+// 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.pubsub.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.PubSub.V1";
+option go_package = "google.golang.org/genproto/googleapis/pubsub/v1;pubsub";
+option java_multiple_files = true;
+option java_outer_classname = "PubsubProto";
+option java_package = "com.google.pubsub.v1";
+option php_namespace = "Google\\Cloud\\PubSub\\V1";
+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
+  // <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+  // resource name rules</a>.
+  rpc CreateTopic(Topic) returns (Topic) {
+    option (google.api.http) = {
+      put: "/v1/{name=projects/*/topics/*}"
+      body: "*"
+    };
+  }
+
+  // Updates an existing topic. Note that certain properties of a
+  // topic are not modifiable.
+  rpc UpdateTopic(UpdateTopicRequest) returns (Topic) {
+    option (google.api.http) = {
+      patch: "/v1/{topic.name=projects/*/topics/*}"
+      body: "*"
+    };
+  }
+
+  // Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
+  // does not exist.
+  rpc Publish(PublishRequest) returns (PublishResponse) {
+    option (google.api.http) = {
+      post: "/v1/{topic=projects/*/topics/*}:publish"
+      body: "*"
+    };
+  }
+
+  // Gets the configuration of a topic.
+  rpc GetTopic(GetTopicRequest) returns (Topic) {
+    option (google.api.http) = {
+      get: "/v1/{topic=projects/*/topics/*}"
+    };
+  }
+
+  // Lists matching topics.
+  rpc ListTopics(ListTopicsRequest) returns (ListTopicsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{project=projects/*}/topics"
+    };
+  }
+
+  // Lists the names of the subscriptions on this topic.
+  rpc ListTopicSubscriptions(ListTopicSubscriptionsRequest)
+      returns (ListTopicSubscriptionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{topic=projects/*/topics/*}/subscriptions"
+    };
+  }
+
+  // Lists the names of the snapshots on this topic. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow
+  // you to manage message acknowledgments in bulk. That is, you can set the
+  // acknowledgment state of messages in an existing subscription to the state
+  // captured by a snapshot.
+  rpc ListTopicSnapshots(ListTopicSnapshotsRequest)
+      returns (ListTopicSnapshotsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{topic=projects/*/topics/*}/snapshots"
+    };
+  }
+
+  // Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
+  // does not exist. After a topic is deleted, a new topic may be created with
+  // the same name; this is an entirely new topic with none of the old
+  // configuration or subscriptions. Existing subscriptions to this topic are
+  // not deleted, but their `topic` field is set to `_deleted-topic_`.
+  rpc DeleteTopic(DeleteTopicRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{topic=projects/*/topics/*}"
+    };
+  }
+}
+
+message MessageStoragePolicy {
+  // 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 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
+  // `"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;
+
+  // See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+  // managing labels</a>.
+  map<string, string> labels = 2;
+
+  // 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/*`.
+  string kms_key_name = 5;
+}
+
+// A message that is published by publishers and consumed by subscribers. The
+// message must contain either a non-empty data field or at least one attribute.
+// Note that client libraries represent this object differently
+// depending on the language. See the corresponding
+// <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
+// library documentation</a> for more information. See
+// <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
+// for more information about message limits.
+message PubsubMessage {
+  // The message data field. If this field is empty, the message must contain
+  // at least one attribute.
+  bytes data = 1;
+
+  // Optional attributes for this message.
+  map<string, string> attributes = 2;
+
+  // ID of this message, assigned by the server when the message is published.
+  // Guaranteed to be unique within the topic. This value may be read by a
+  // subscriber that receives a `PubsubMessage` via a `Pull` call or a push
+  // delivery. It must not be populated by the publisher in a `Publish` call.
+  string message_id = 3;
+
+  // The time at which the message was published, populated by the server when
+  // it receives the `Publish` call. It must not be populated by the
+  // 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.
+  // <b>EXPERIMENTAL:</b> 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 ordering_key = 5;
+}
+
+// Request for the GetTopic method.
+message GetTopicRequest {
+  // The name of the topic to get.
+  // Format is `projects/{project}/topics/{topic}`.
+  string topic = 1;
+}
+
+// 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;
+}
+
+// Request for the Publish method.
+message PublishRequest {
+  // The messages in the request will be published on this topic.
+  // Format is `projects/{project}/topics/{topic}`.
+  string topic = 1;
+
+  // The messages to publish.
+  repeated PubsubMessage messages = 2;
+}
+
+// Response for the `Publish` method.
+message PublishResponse {
+  // The server-assigned ID of each published message, in the same order as
+  // the messages in the request. IDs are guaranteed to be unique within
+  // the topic.
+  repeated string message_ids = 1;
+}
+
+// Request for the `ListTopics` method.
+message ListTopicsRequest {
+  // The name of the project in which to list topics.
+  // Format is `projects/{project-id}`.
+  string project = 1;
+
+  // Maximum number of topics to return.
+  int32 page_size = 2;
+
+  // The value returned by the last `ListTopicsResponse`; indicates that this is
+  // a continuation of a prior `ListTopics` call, and that the system should
+  // return the next page of data.
+  string page_token = 3;
+}
+
+// Response for the `ListTopics` method.
+message ListTopicsResponse {
+  // The resulting topics.
+  repeated Topic topics = 1;
+
+  // If not empty, indicates that there may be more topics that match the
+  // request; this value should be passed in a new `ListTopicsRequest`.
+  string next_page_token = 2;
+}
+
+// Request for the `ListTopicSubscriptions` method.
+message ListTopicSubscriptionsRequest {
+  // The name of the topic that subscriptions are attached to.
+  // Format is `projects/{project}/topics/{topic}`.
+  string topic = 1;
+
+  // Maximum number of subscription names to return.
+  int32 page_size = 2;
+
+  // The value returned by the last `ListTopicSubscriptionsResponse`; indicates
+  // that this is a continuation of a prior `ListTopicSubscriptions` call, and
+  // that the system should return the next page of data.
+  string page_token = 3;
+}
+
+// Response for the `ListTopicSubscriptions` method.
+message ListTopicSubscriptionsResponse {
+  // The names of the subscriptions that match the request.
+  repeated string subscriptions = 1;
+
+  // If not empty, indicates that there may be more subscriptions that match
+  // the request; this value should be passed in a new
+  // `ListTopicSubscriptionsRequest` to get more subscriptions.
+  string next_page_token = 2;
+}
+
+// Request for the `ListTopicSnapshots` method.
+message ListTopicSnapshotsRequest {
+  // The name of the topic that snapshots are attached to.
+  // Format is `projects/{project}/topics/{topic}`.
+  string topic = 1;
+
+  // Maximum number of snapshot names to return.
+  int32 page_size = 2;
+
+  // The value returned by the last `ListTopicSnapshotsResponse`; indicates
+  // that this is a continuation of a prior `ListTopicSnapshots` call, and
+  // that the system should return the next page of data.
+  string page_token = 3;
+}
+
+// Response for the `ListTopicSnapshots` method.
+message ListTopicSnapshotsResponse {
+  // The names of the snapshots that match the request.
+  repeated string snapshots = 1;
+
+  // If not empty, indicates that there may be more snapshots that match
+  // the request; this value should be passed in a new
+  // `ListTopicSnapshotsRequest` to get more snapshots.
+  string next_page_token = 2;
+}
+
+// Request for the `DeleteTopic` method.
+message DeleteTopicRequest {
+  // Name of the topic to delete.
+  // Format is `projects/{project}/topics/{topic}`.
+  string topic = 1;
+}
+
+// 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
+  // <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+  // resource name rules</a>.
+  // If the subscription already exists, returns `ALREADY_EXISTS`.
+  // If the corresponding topic doesn't exist, returns `NOT_FOUND`.
+  //
+  // If the name is not provided in the request, the server will assign a random
+  // name for this subscription on the same project as the topic, conforming
+  // to the
+  // [resource name
+  // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+  // generated name is populated in the returned Subscription object. Note that
+  // for REST API requests, you must specify a name in the request.
+  rpc CreateSubscription(Subscription) returns (Subscription) {
+    option (google.api.http) = {
+      put: "/v1/{name=projects/*/subscriptions/*}"
+      body: "*"
+    };
+  }
+
+  // Gets the configuration details of a subscription.
+  rpc GetSubscription(GetSubscriptionRequest) returns (Subscription) {
+    option (google.api.http) = {
+      get: "/v1/{subscription=projects/*/subscriptions/*}"
+    };
+  }
+
+  // Updates an existing subscription. Note that certain properties of a
+  // subscription, such as its topic, are not modifiable.
+  rpc UpdateSubscription(UpdateSubscriptionRequest) returns (Subscription) {
+    option (google.api.http) = {
+      patch: "/v1/{subscription.name=projects/*/subscriptions/*}"
+      body: "*"
+    };
+  }
+
+  // Lists matching subscriptions.
+  rpc ListSubscriptions(ListSubscriptionsRequest)
+      returns (ListSubscriptionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{project=projects/*}/subscriptions"
+    };
+  }
+
+  // Deletes an existing subscription. All messages retained in the subscription
+  // are immediately dropped. Calls to `Pull` after deletion will return
+  // `NOT_FOUND`. After a subscription is deleted, a new one may be created with
+  // the same name, but the new one has no association with the old
+  // subscription or its topic unless the same topic is specified.
+  rpc DeleteSubscription(DeleteSubscriptionRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{subscription=projects/*/subscriptions/*}"
+    };
+  }
+
+  // Modifies the ack deadline for a specific message. This method is useful
+  // to indicate that more time is needed to process a message by the
+  // subscriber, or to make the message available for redelivery if the
+  // processing was interrupted. Note that this does not modify the
+  // subscription-level `ackDeadlineSeconds` used for subsequent messages.
+  rpc ModifyAckDeadline(ModifyAckDeadlineRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{subscription=projects/*/subscriptions/*}:modifyAckDeadline"
+      body: "*"
+    };
+  }
+
+  // Acknowledges the messages associated with the `ack_ids` in the
+  // `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
+  // from the subscription.
+  //
+  // Acknowledging a message whose ack deadline has expired may succeed,
+  // but such a message may be redelivered later. Acknowledging a message more
+  // than once will not result in an error.
+  rpc Acknowledge(AcknowledgeRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{subscription=projects/*/subscriptions/*}:acknowledge"
+      body: "*"
+    };
+  }
+
+  // Pulls messages from the server. The server may return `UNAVAILABLE` if
+  // there are too many concurrent pull requests pending for the given
+  // subscription.
+  rpc Pull(PullRequest) returns (PullResponse) {
+    option (google.api.http) = {
+      post: "/v1/{subscription=projects/*/subscriptions/*}:pull"
+      body: "*"
+    };
+  }
+
+  // Establishes a stream with the server, which sends messages down to the
+  // client. The client streams acknowledgements and ack deadline modifications
+  // back to the server. The server will close the stream and return the status
+  // on any error. The server may close the stream with status `UNAVAILABLE` to
+  // reassign server-side resources, in which case, the client should
+  // re-establish the stream. Flow control can be achieved by configuring the
+  // underlying RPC channel.
+  rpc StreamingPull(stream StreamingPullRequest)
+      returns (stream StreamingPullResponse) {}
+
+  // Modifies the `PushConfig` for a specified subscription.
+  //
+  // This may be used to change a push subscription to a pull one (signified by
+  // an empty `PushConfig`) or vice versa, or change the endpoint URL and other
+  // attributes of a push subscription. Messages will accumulate for delivery
+  // continuously through the call regardless of changes to the `PushConfig`.
+  rpc ModifyPushConfig(ModifyPushConfigRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{subscription=projects/*/subscriptions/*}:modifyPushConfig"
+      body: "*"
+    };
+  }
+
+  // Gets the configuration details of a snapshot. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow you to manage message acknowledgments in bulk. That
+  // is, you can set the acknowledgment state of messages in an existing
+  // subscription to the state captured by a snapshot.
+  rpc GetSnapshot(GetSnapshotRequest) returns (Snapshot) {
+    option (google.api.http) = {
+      get: "/v1/{snapshot=projects/*/snapshots/*}"
+    };
+  }
+
+  // Lists the existing snapshots. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow
+  // you to manage message acknowledgments in bulk. That is, you can set the
+  // acknowledgment state of messages in an existing subscription to the state
+  // captured by a snapshot.
+  rpc ListSnapshots(ListSnapshotsRequest) returns (ListSnapshotsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{project=projects/*}/snapshots"
+    };
+  }
+
+  // Creates a snapshot from the requested subscription. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow
+  // you to manage message acknowledgments in bulk. That is, you can set the
+  // acknowledgment state of messages in an existing subscription to the state
+  // captured by a snapshot.
+  // <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+  // If the requested subscription doesn't exist, returns `NOT_FOUND`.
+  // If the backlog in the subscription is too old -- and the resulting snapshot
+  // would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
+  // See also the `Snapshot.expire_time` field. 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, conforming
+  // to the
+  // [resource name
+  // format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+  // generated name is populated in the returned Snapshot object. Note that for
+  // REST API requests, you must specify a name in the request.
+  rpc CreateSnapshot(CreateSnapshotRequest) returns (Snapshot) {
+    option (google.api.http) = {
+      put: "/v1/{name=projects/*/snapshots/*}"
+      body: "*"
+    };
+  }
+
+  // Updates an existing snapshot. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow
+  // you to manage message acknowledgments in bulk. That is, you can set the
+  // acknowledgment state of messages in an existing subscription to the state
+  // captured by a snapshot.
+  rpc UpdateSnapshot(UpdateSnapshotRequest) returns (Snapshot) {
+    option (google.api.http) = {
+      patch: "/v1/{snapshot.name=projects/*/snapshots/*}"
+      body: "*"
+    };
+  }
+
+  // Removes an existing snapshot. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow
+  // you to manage message acknowledgments in bulk. That is, you can set the
+  // acknowledgment state of messages in an existing subscription to the state
+  // captured by a snapshot.<br><br>
+  // When the snapshot is deleted, all messages retained in the snapshot
+  // are immediately dropped. After a snapshot is deleted, a new one may be
+  // created with the same name, but the new one has no association with the old
+  // snapshot or its subscription, unless the same subscription is specified.
+  rpc DeleteSnapshot(DeleteSnapshotRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{snapshot=projects/*/snapshots/*}"
+    };
+  }
+
+  // Seeks an existing subscription to a point in time or to a given snapshot,
+  // whichever is provided in the request. Snapshots are used in
+  // <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+  // operations, which allow
+  // you to manage message acknowledgments in bulk. That is, you can set the
+  // acknowledgment state of messages in an existing subscription to the state
+  // captured by a snapshot. Note that both the subscription and the snapshot
+  // must be on the same topic.
+  rpc Seek(SeekRequest) returns (SeekResponse) {
+    option (google.api.http) = {
+      post: "/v1/{subscription=projects/*/subscriptions/*}:seek"
+      body: "*"
+    };
+  }
+}
+
+// A subscription resource.
+message Subscription {
+  // 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;
+
+  // 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;
+
+  // If push delivery is used with this subscription, this field is
+  // used to configure it. An empty `pushConfig` signifies that the subscriber
+  // will pull and ack messages using API methods.
+  PushConfig push_config = 4;
+
+  // The approximate amount of time (on a best-effort basis) Pub/Sub waits for
+  // the subscriber to acknowledge receipt before resending the message. In the
+  // interval after the message is delivered and before it is acknowledged, it
+  // is considered to be <i>outstanding</i>. During that time period, the
+  // message will not be redelivered (on a best-effort basis).
+  //
+  // For pull subscriptions, this value is used as the initial value for the ack
+  // deadline. To override this value for a given message, call
+  // `ModifyAckDeadline` with the corresponding `ack_id` if using
+  // non-streaming pull or send the `ack_id` in a
+  // `StreamingModifyAckDeadlineRequest` if using streaming pull.
+  // The minimum custom deadline you can specify is 10 seconds.
+  // The maximum custom deadline you can specify is 600 seconds (10 minutes).
+  // If this parameter is 0, a default value of 10 seconds is used.
+  //
+  // For push delivery, this value is also used to set the request timeout for
+  // the call to the push endpoint.
+  //
+  // If the subscriber never acknowledges the message, the Pub/Sub
+  // system will eventually redeliver the message.
+  int32 ack_deadline_seconds = 5;
+
+  // Indicates whether to retain acknowledged messages. If true, then
+  // messages are not expunged from the subscription's backlog, even if they are
+  // acknowledged, until they fall out of the `message_retention_duration`
+  // window. This must be true if you would like to
+  // <a
+  // href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
+  // Seek to a timestamp</a>.
+  bool retain_acked_messages = 7;
+
+  // How long to retain unacknowledged messages in the subscription's backlog,
+  // from the moment a message is published.
+  // If `retain_acked_messages` is true, then this also configures the retention
+  // of acknowledged messages, and thus configures how far back in time a `Seek`
+  // can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
+  // minutes.
+  google.protobuf.Duration message_retention_duration = 8;
+
+  // See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+  // managing labels</a>.
+  map<string, string> labels = 9;
+
+  // If true, messages published with the same `ordering_key` in `PubsubMessage`
+  // will be delivered to the subscribers in the order in which they
+  // are received by the Pub/Sub system. Otherwise, they may be delivered in
+  // any order.
+  // <b>EXPERIMENTAL:</b> 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.
+  bool enable_message_ordering = 10;
+
+  // A policy that specifies the conditions for this subscription's expiration.
+  // A subscription is considered active as long as any connected subscriber is
+  // successfully consuming messages from the subscription or is issuing
+  // operations on the subscription. If `expiration_policy` is not set, a
+  // *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;
+
+  // 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.
+  // <b>EXPERIMENTAL:</b> 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.
+  DeadLetterPolicy dead_letter_policy = 13;
+}
+
+// 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.,
+// automatic resource deletion).
+message ExpirationPolicy {
+  // Specifies the "time-to-live" duration for an associated resource. The
+  // resource expires if it is not active for a period of `ttl`. The definition
+  // of "activity" depends on the type of the associated resource. The minimum
+  // and maximum allowed values for `ttl` depend on the type of the associated
+  // resource, as well. If `ttl` is not set, the associated resource never
+  // expires.
+  google.protobuf.Duration ttl = 1;
+}
+
+// Configuration for a push delivery endpoint.
+message PushConfig {
+  // Contains information needed for generating an
+  // [OpenID Connect
+  // token](https://developers.google.com/identity/protocols/OpenIDConnect).
+  message OidcToken {
+    // [Service account
+    // email](https://cloud.google.com/iam/docs/service-accounts)
+    // to be used for generating the OIDC token. The caller (for
+    // CreateSubscription, UpdateSubscription, and ModifyPushConfig RPCs) must
+    // have the iam.serviceAccounts.actAs permission for the service account.
+    string service_account_email = 1;
+
+    // Audience to be used when generating OIDC token. The audience claim
+    // identifies the recipients that the JWT is intended for. The audience
+    // value is a single case-sensitive string. Having multiple values (array)
+    // for the audience field is not supported. More info about the OIDC JWT
+    // token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
+    // Note: if not specified, the Push endpoint URL will be used.
+    string audience = 2;
+  }
+
+  // A URL locating the endpoint to which messages should be pushed.
+  // For example, a Webhook endpoint might use "https://example.com/push".
+  string push_endpoint = 1;
+
+  // Endpoint configuration attributes that can be used to control different
+  // aspects of the message delivery.
+  //
+  // 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).
+  //
+  // If not present during the `CreateSubscription` call, it will default to
+  // 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 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:
+  // <pre><code>attributes { "x-goog-version": "v1" } </code></pre>
+  map<string, string> attributes = 2;
+
+  // An authentication method used by push endpoints to verify the source of
+  // push requests. This can be used with push endpoints that are private by
+  // default to allow requests only from the Cloud Pub/Sub system, for example.
+  // This field is optional and should be set only by users interested in
+  // authenticated push.
+  oneof authentication_method {
+    // If specified, Pub/Sub will generate and attach an OIDC JWT token as an
+    // `Authorization` header in the HTTP request for every pushed message.
+    OidcToken oidc_token = 3;
+  }
+}
+
+// A message and its corresponding acknowledgment ID.
+message ReceivedMessage {
+  // This ID can be used to acknowledge the received message.
+  string ack_id = 1;
+
+  // The message.
+  PubsubMessage message = 2;
+
+  // Delivery attempt counter is 1 + (the sum of number of NACKs and 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.
+  //
+  // The first delivery of a given message will have this value as 1. The value
+  // is calculated at best effort and is approximate.
+  //
+  // If a DeadLetterPolicy is not set on the subscription, this will be 0.
+  // <b>EXPERIMENTAL:</b> 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.
+  int32 delivery_attempt = 3;
+}
+
+// Request for the GetSubscription method.
+message GetSubscriptionRequest {
+  // The name of the subscription to get.
+  // Format is `projects/{project}/subscriptions/{sub}`.
+  string subscription = 1;
+}
+
+// Request for the UpdateSubscription method.
+message UpdateSubscriptionRequest {
+  // The updated subscription object.
+  Subscription subscription = 1;
+
+  // Indicates which fields in the provided subscription to update.
+  // Must be specified and non-empty.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request for the `ListSubscriptions` method.
+message ListSubscriptionsRequest {
+  // The name of the project in which to list subscriptions.
+  // Format is `projects/{project-id}`.
+  string project = 1;
+
+  // Maximum number of subscriptions to return.
+  int32 page_size = 2;
+
+  // The value returned by the last `ListSubscriptionsResponse`; indicates that
+  // this is a continuation of a prior `ListSubscriptions` call, and that the
+  // system should return the next page of data.
+  string page_token = 3;
+}
+
+// Response for the `ListSubscriptions` method.
+message ListSubscriptionsResponse {
+  // The subscriptions that match the request.
+  repeated Subscription subscriptions = 1;
+
+  // If not empty, indicates that there may be more subscriptions that match
+  // the request; this value should be passed in a new
+  // `ListSubscriptionsRequest` to get more subscriptions.
+  string next_page_token = 2;
+}
+
+// Request for the DeleteSubscription method.
+message DeleteSubscriptionRequest {
+  // The subscription to delete.
+  // Format is `projects/{project}/subscriptions/{sub}`.
+  string subscription = 1;
+}
+
+// Request for the ModifyPushConfig method.
+message ModifyPushConfigRequest {
+  // The name of the subscription.
+  // Format is `projects/{project}/subscriptions/{sub}`.
+  string subscription = 1;
+
+  // 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;
+}
+
+// Request for the `Pull` method.
+message PullRequest {
+  // 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 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;
+}
+
+// Response for the `Pull` method.
+message PullResponse {
+  // Received Pub/Sub messages. The list will be empty if there are no more
+  // messages available in the backlog. For JSON, the response can be entirely
+  // empty. The Pub/Sub system may return fewer than the `maxMessages` requested
+  // even if there are more messages available in the backlog.
+  repeated ReceivedMessage received_messages = 1;
+}
+
+// Request for the ModifyAckDeadline method.
+message ModifyAckDeadlineRequest {
+  // 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
+  // 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;
+}
+
+// Request for the Acknowledge method.
+message AcknowledgeRequest {
+  // 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;
+}
+
+// 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
+  // subsequent requests from client to server.
+  // Format is `projects/{project}/subscriptions/{sub}`.
+  string subscription = 1;
+
+  // List of acknowledgement IDs for acknowledging previously received messages
+  // (received on this stream or a different stream). If an ack ID has expired,
+  // the corresponding message may be redelivered later. Acknowledging a message
+  // more than once will not result in an error. If the acknowledgement ID is
+  // malformed, the stream will be aborted with status `INVALID_ARGUMENT`.
+  repeated string ack_ids = 2;
+
+  // The list of new ack deadlines for the IDs listed in
+  // `modify_deadline_ack_ids`. The size of this list must be the same as the
+  // size of `modify_deadline_ack_ids`. If it differs the stream will be aborted
+  // with `INVALID_ARGUMENT`. Each element in this list is applied to the
+  // element in the same position in `modify_deadline_ack_ids`. The new ack
+  // deadline is with respect to the time this request was sent to the Pub/Sub
+  // system. Must be >= 0. For example, if the value is 10, the new ack deadline
+  // will expire 10 seconds after this request is received. If the value is 0,
+  // the message is immediately made available for another streaming or
+  // non-streaming pull request. If the value is < 0 (an error), the stream will
+  // be aborted with status `INVALID_ARGUMENT`.
+  repeated int32 modify_deadline_seconds = 3;
+
+  // List of acknowledgement IDs whose deadline will be modified based on the
+  // corresponding element in `modify_deadline_seconds`. This field can be used
+  // to indicate that more time is needed to process a message by the
+  // subscriber, or to make the message available for redelivery if the
+  // 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
+  // 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;
+}
+
+// Response for the `StreamingPull` method. This response is used to stream
+// messages from the server to the client.
+message StreamingPullResponse {
+  // Received Pub/Sub messages. This will not be empty.
+  repeated ReceivedMessage received_messages = 1;
+}
+
+// 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
+  // <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+  // resource name rules</a>.
+  // Format is `projects/{project}/snapshots/{snap}`.
+  string name = 1;
+
+  // 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
+  //      unacknowledged upon the successful completion of the
+  //      `CreateSnapshot` request; as well as:
+  //  (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;
+
+  // See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+  // managing labels</a>.
+  map<string, string> labels = 3;
+}
+
+// Request for the UpdateSnapshot method.
+message UpdateSnapshotRequest {
+  // The updated snapshot object.
+  Snapshot snapshot = 1;
+
+  // Indicates which fields in the provided snapshot to update.
+  // Must be specified and non-empty.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// A snapshot resource. Snapshots are used in
+// <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+// operations, which allow
+// you to manage message acknowledgments in bulk. That is, you can set the
+// acknowledgment state of messages in an existing subscription to the state
+// captured by a snapshot.
+message Snapshot {
+  // The name of the snapshot.
+  string name = 1;
+
+  // The name of the topic from which this snapshot is retaining messages.
+  string topic = 2;
+
+  // 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
+  // creation. Its exact lifetime is determined at creation by the existing
+  // backlog in the source subscription. Specifically, the lifetime of the
+  // snapshot is `7 days - (age of oldest unacked message in the subscription)`.
+  // For example, consider a subscription whose oldest unacked message is 3 days
+  // old. If a snapshot is created from this subscription, the snapshot -- which
+  // will always capture this 3-day-old backlog as long as the snapshot
+  // exists -- will expire in 4 days. The service will refuse to create a
+  // snapshot that would expire in less than 1 hour after creation.
+  google.protobuf.Timestamp expire_time = 3;
+
+  // See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
+  // managing labels</a>.
+  map<string, string> labels = 4;
+}
+
+// Request for the GetSnapshot method.
+message GetSnapshotRequest {
+  // The name of the snapshot to get.
+  // Format is `projects/{project}/snapshots/{snap}`.
+  string snapshot = 1;
+}
+
+// Request for the `ListSnapshots` method.
+message ListSnapshotsRequest {
+  // The name of the project in which to list snapshots.
+  // Format is `projects/{project-id}`.
+  string project = 1;
+
+  // Maximum number of snapshots to return.
+  int32 page_size = 2;
+
+  // The value returned by the last `ListSnapshotsResponse`; indicates that this
+  // is a continuation of a prior `ListSnapshots` call, and that the system
+  // should return the next page of data.
+  string page_token = 3;
+}
+
+// Response for the `ListSnapshots` method.
+message ListSnapshotsResponse {
+  // The resulting snapshots.
+  repeated Snapshot snapshots = 1;
+
+  // If not empty, indicates that there may be more snapshot that match the
+  // request; this value should be passed in a new `ListSnapshotsRequest`.
+  string next_page_token = 2;
+}
+
+// Request for the `DeleteSnapshot` method.
+message DeleteSnapshotRequest {
+  // The name of the snapshot to delete.
+  // Format is `projects/{project}/snapshots/{snap}`.
+  string snapshot = 1;
+}
+
+// Request for the `Seek` method.
+message SeekRequest {
+  // The subscription to affect.
+  string subscription = 1;
+
+  oneof target {
+    // The time to seek to.
+    // Messages retained in the subscription that were published before this
+    // time are marked as acknowledged, and messages retained in the
+    // subscription that were published after this time are marked as
+    // unacknowledged. Note that this operation affects only those messages
+    // retained in the subscription (configured by the combination of
+    // `message_retention_duration` and `retain_acked_messages`). For example,
+    // if `time` corresponds to a point before the message retention
+    // window (or to a point before the system's notion of the subscription
+    // creation time), only retained messages will be marked as unacknowledged,
+    // and already-expunged messages will not be restored.
+    google.protobuf.Timestamp time = 2;
+
+    // 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;
+  }
+}
+
+// Response for the `Seek` method (this response is empty).
+message SeekResponse {}
diff --git a/pubsub/google/cloud/pubsub_v1/proto/pubsub_pb2.py b/pubsub/google/cloud/pubsub_v1/proto/pubsub_pb2.py
new file mode 100644
index 000000000000..dd4427f7e9a1
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/proto/pubsub_pb2.py
@@ -0,0 +1,4694 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/pubsub_v1/proto/pubsub.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/pubsub_v1/proto/pubsub.proto",
+    package="google.pubsub.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\024com.google.pubsub.v1B\013PubsubProtoP\001Z6google.golang.org/genproto/googleapis/pubsub/v1;pubsub\370\001\001\252\002\026Google.Cloud.PubSub.V1\312\002\026Google\\Cloud\\PubSub\\V1\352\002\031Google::Cloud::PubSub::V1"
+    ),
+    serialized_pb=_b(
+        '\n)google/cloud/pubsub_v1/proto/pubsub.proto\x12\x10google.pubsub.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto";\n\x14MessageStoragePolicy\x12#\n\x1b\x61llowed_persistence_regions\x18\x01 \x03(\t"\xd7\x01\n\x05Topic\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x33\n\x06labels\x18\x02 \x03(\x0b\x32#.google.pubsub.v1.Topic.LabelsEntry\x12\x46\n\x16message_storage_policy\x18\x03 \x01(\x0b\x32&.google.pubsub.v1.MessageStoragePolicy\x12\x14\n\x0ckms_key_name\x18\x05 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xf1\x01\n\rPubsubMessage\x12\x0c\n\x04\x64\x61ta\x18\x01 \x01(\x0c\x12\x43\n\nattributes\x18\x02 \x03(\x0b\x32/.google.pubsub.v1.PubsubMessage.AttributesEntry\x12\x12\n\nmessage_id\x18\x03 \x01(\t\x12\x30\n\x0cpublish_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x14\n\x0cordering_key\x18\x05 \x01(\t\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01" \n\x0fGetTopicRequest\x12\r\n\x05topic\x18\x01 \x01(\t"m\n\x12UpdateTopicRequest\x12&\n\x05topic\x18\x01 \x01(\x0b\x32\x17.google.pubsub.v1.Topic\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"R\n\x0ePublishRequest\x12\r\n\x05topic\x18\x01 \x01(\t\x12\x31\n\x08messages\x18\x02 \x03(\x0b\x32\x1f.google.pubsub.v1.PubsubMessage"&\n\x0fPublishResponse\x12\x13\n\x0bmessage_ids\x18\x01 \x03(\t"K\n\x11ListTopicsRequest\x12\x0f\n\x07project\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"V\n\x12ListTopicsResponse\x12\'\n\x06topics\x18\x01 \x03(\x0b\x32\x17.google.pubsub.v1.Topic\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"U\n\x1dListTopicSubscriptionsRequest\x12\r\n\x05topic\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"P\n\x1eListTopicSubscriptionsResponse\x12\x15\n\rsubscriptions\x18\x01 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"Q\n\x19ListTopicSnapshotsRequest\x12\r\n\x05topic\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"H\n\x1aListTopicSnapshotsResponse\x12\x11\n\tsnapshots\x18\x01 \x03(\t\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"#\n\x12\x44\x65leteTopicRequest\x12\r\n\x05topic\x18\x01 \x01(\t"\xe5\x03\n\x0cSubscription\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05topic\x18\x02 \x01(\t\x12\x31\n\x0bpush_config\x18\x04 \x01(\x0b\x32\x1c.google.pubsub.v1.PushConfig\x12\x1c\n\x14\x61\x63k_deadline_seconds\x18\x05 \x01(\x05\x12\x1d\n\x15retain_acked_messages\x18\x07 \x01(\x08\x12=\n\x1amessage_retention_duration\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12:\n\x06labels\x18\t \x03(\x0b\x32*.google.pubsub.v1.Subscription.LabelsEntry\x12\x1f\n\x17\x65nable_message_ordering\x18\n \x01(\x08\x12=\n\x11\x65xpiration_policy\x18\x0b \x01(\x0b\x32".google.pubsub.v1.ExpirationPolicy\x12>\n\x12\x64\x65\x61\x64_letter_policy\x18\r \x01(\x0b\x32".google.pubsub.v1.DeadLetterPolicy\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"L\n\x10\x44\x65\x61\x64LetterPolicy\x12\x19\n\x11\x64\x65\x61\x64_letter_topic\x18\x01 \x01(\t\x12\x1d\n\x15max_delivery_attempts\x18\x02 \x01(\x05":\n\x10\x45xpirationPolicy\x12&\n\x03ttl\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration"\xad\x02\n\nPushConfig\x12\x15\n\rpush_endpoint\x18\x01 \x01(\t\x12@\n\nattributes\x18\x02 \x03(\x0b\x32,.google.pubsub.v1.PushConfig.AttributesEntry\x12<\n\noidc_token\x18\x03 \x01(\x0b\x32&.google.pubsub.v1.PushConfig.OidcTokenH\x00\x1a<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x17\n\x15\x61uthentication_method"m\n\x0fReceivedMessage\x12\x0e\n\x06\x61\x63k_id\x18\x01 \x01(\t\x12\x30\n\x07message\x18\x02 \x01(\x0b\x32\x1f.google.pubsub.v1.PubsubMessage\x12\x18\n\x10\x64\x65livery_attempt\x18\x03 \x01(\x05".\n\x16GetSubscriptionRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t"\x82\x01\n\x19UpdateSubscriptionRequest\x12\x34\n\x0csubscription\x18\x01 \x01(\x0b\x32\x1e.google.pubsub.v1.Subscription\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"R\n\x18ListSubscriptionsRequest\x12\x0f\n\x07project\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"k\n\x19ListSubscriptionsResponse\x12\x35\n\rsubscriptions\x18\x01 \x03(\x0b\x32\x1e.google.pubsub.v1.Subscription\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"1\n\x19\x44\x65leteSubscriptionRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t"b\n\x17ModifyPushConfigRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t\x12\x31\n\x0bpush_config\x18\x02 \x01(\x0b\x32\x1c.google.pubsub.v1.PushConfig"U\n\x0bPullRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t\x12\x1a\n\x12return_immediately\x18\x02 \x01(\x08\x12\x14\n\x0cmax_messages\x18\x03 \x01(\x05"L\n\x0cPullResponse\x12<\n\x11received_messages\x18\x01 \x03(\x0b\x32!.google.pubsub.v1.ReceivedMessage"_\n\x18ModifyAckDeadlineRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t\x12\x0f\n\x07\x61\x63k_ids\x18\x04 \x03(\t\x12\x1c\n\x14\x61\x63k_deadline_seconds\x18\x03 \x01(\x05";\n\x12\x41\x63knowledgeRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t\x12\x0f\n\x07\x61\x63k_ids\x18\x02 \x03(\t"\xa4\x01\n\x14StreamingPullRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t\x12\x0f\n\x07\x61\x63k_ids\x18\x02 \x03(\t\x12\x1f\n\x17modify_deadline_seconds\x18\x03 \x03(\x05\x12\x1f\n\x17modify_deadline_ack_ids\x18\x04 \x03(\t\x12#\n\x1bstream_ack_deadline_seconds\x18\x05 \x01(\x05"U\n\x15StreamingPullResponse\x12<\n\x11received_messages\x18\x01 \x03(\x0b\x32!.google.pubsub.v1.ReceivedMessage"\xaf\x01\n\x15\x43reateSnapshotRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0csubscription\x18\x02 \x01(\t\x12\x43\n\x06labels\x18\x03 \x03(\x0b\x32\x33.google.pubsub.v1.CreateSnapshotRequest.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"v\n\x15UpdateSnapshotRequest\x12,\n\x08snapshot\x18\x01 \x01(\x0b\x32\x1a.google.pubsub.v1.Snapshot\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xbf\x01\n\x08Snapshot\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05topic\x18\x02 \x01(\t\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x06labels\x18\x04 \x03(\x0b\x32&.google.pubsub.v1.Snapshot.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"&\n\x12GetSnapshotRequest\x12\x10\n\x08snapshot\x18\x01 \x01(\t"N\n\x14ListSnapshotsRequest\x12\x0f\n\x07project\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"_\n\x15ListSnapshotsResponse\x12-\n\tsnapshots\x18\x01 \x03(\x0b\x32\x1a.google.pubsub.v1.Snapshot\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t")\n\x15\x44\x65leteSnapshotRequest\x12\x10\n\x08snapshot\x18\x01 \x01(\t"m\n\x0bSeekRequest\x12\x14\n\x0csubscription\x18\x01 \x01(\t\x12*\n\x04time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x12\n\x08snapshot\x18\x03 \x01(\tH\x00\x42\x08\n\x06target"\x0e\n\x0cSeekResponse2\xb1\t\n\tPublisher\x12j\n\x0b\x43reateTopic\x12\x17.google.pubsub.v1.Topic\x1a\x17.google.pubsub.v1.Topic")\x82\xd3\xe4\x93\x02#\x1a\x1e/v1/{name=projects/*/topics/*}:\x01*\x12}\n\x0bUpdateTopic\x12$.google.pubsub.v1.UpdateTopicRequest\x1a\x17.google.pubsub.v1.Topic"/\x82\xd3\xe4\x93\x02)2$/v1/{topic.name=projects/*/topics/*}:\x01*\x12\x82\x01\n\x07Publish\x12 .google.pubsub.v1.PublishRequest\x1a!.google.pubsub.v1.PublishResponse"2\x82\xd3\xe4\x93\x02,"\'/v1/{topic=projects/*/topics/*}:publish:\x01*\x12o\n\x08GetTopic\x12!.google.pubsub.v1.GetTopicRequest\x1a\x17.google.pubsub.v1.Topic"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v1/{topic=projects/*/topics/*}\x12\x80\x01\n\nListTopics\x12#.google.pubsub.v1.ListTopicsRequest\x1a$.google.pubsub.v1.ListTopicsResponse"\'\x82\xd3\xe4\x93\x02!\x12\x1f/v1/{project=projects/*}/topics\x12\xb2\x01\n\x16ListTopicSubscriptions\x12/.google.pubsub.v1.ListTopicSubscriptionsRequest\x1a\x30.google.pubsub.v1.ListTopicSubscriptionsResponse"5\x82\xd3\xe4\x93\x02/\x12-/v1/{topic=projects/*/topics/*}/subscriptions\x12\xa2\x01\n\x12ListTopicSnapshots\x12+.google.pubsub.v1.ListTopicSnapshotsRequest\x1a,.google.pubsub.v1.ListTopicSnapshotsResponse"1\x82\xd3\xe4\x93\x02+\x12)/v1/{topic=projects/*/topics/*}/snapshots\x12t\n\x0b\x44\x65leteTopic\x12$.google.pubsub.v1.DeleteTopicRequest\x1a\x16.google.protobuf.Empty"\'\x82\xd3\xe4\x93\x02!*\x1f/v1/{topic=projects/*/topics/*}\x1ap\xca\x41\x15pubsub.googleapis.com\xd2\x41Uhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/pubsub2\xeb\x12\n\nSubscriber\x12\x86\x01\n\x12\x43reateSubscription\x12\x1e.google.pubsub.v1.Subscription\x1a\x1e.google.pubsub.v1.Subscription"0\x82\xd3\xe4\x93\x02*\x1a%/v1/{name=projects/*/subscriptions/*}:\x01*\x12\x92\x01\n\x0fGetSubscription\x12(.google.pubsub.v1.GetSubscriptionRequest\x1a\x1e.google.pubsub.v1.Subscription"5\x82\xd3\xe4\x93\x02/\x12-/v1/{subscription=projects/*/subscriptions/*}\x12\xa0\x01\n\x12UpdateSubscription\x12+.google.pubsub.v1.UpdateSubscriptionRequest\x1a\x1e.google.pubsub.v1.Subscription"=\x82\xd3\xe4\x93\x02\x37\x32\x32/v1/{subscription.name=projects/*/subscriptions/*}:\x01*\x12\x9c\x01\n\x11ListSubscriptions\x12*.google.pubsub.v1.ListSubscriptionsRequest\x1a+.google.pubsub.v1.ListSubscriptionsResponse".\x82\xd3\xe4\x93\x02(\x12&/v1/{project=projects/*}/subscriptions\x12\x90\x01\n\x12\x44\x65leteSubscription\x12+.google.pubsub.v1.DeleteSubscriptionRequest\x1a\x16.google.protobuf.Empty"5\x82\xd3\xe4\x93\x02/*-/v1/{subscription=projects/*/subscriptions/*}\x12\xa3\x01\n\x11ModifyAckDeadline\x12*.google.pubsub.v1.ModifyAckDeadlineRequest\x1a\x16.google.protobuf.Empty"J\x82\xd3\xe4\x93\x02\x44"?/v1/{subscription=projects/*/subscriptions/*}:modifyAckDeadline:\x01*\x12\x91\x01\n\x0b\x41\x63knowledge\x12$.google.pubsub.v1.AcknowledgeRequest\x1a\x16.google.protobuf.Empty"D\x82\xd3\xe4\x93\x02>"9/v1/{subscription=projects/*/subscriptions/*}:acknowledge:\x01*\x12\x84\x01\n\x04Pull\x12\x1d.google.pubsub.v1.PullRequest\x1a\x1e.google.pubsub.v1.PullResponse"=\x82\xd3\xe4\x93\x02\x37"2/v1/{subscription=projects/*/subscriptions/*}:pull:\x01*\x12\x66\n\rStreamingPull\x12&.google.pubsub.v1.StreamingPullRequest\x1a\'.google.pubsub.v1.StreamingPullResponse"\x00(\x01\x30\x01\x12\xa0\x01\n\x10ModifyPushConfig\x12).google.pubsub.v1.ModifyPushConfigRequest\x1a\x16.google.protobuf.Empty"I\x82\xd3\xe4\x93\x02\x43">/v1/{subscription=projects/*/subscriptions/*}:modifyPushConfig:\x01*\x12~\n\x0bGetSnapshot\x12$.google.pubsub.v1.GetSnapshotRequest\x1a\x1a.google.pubsub.v1.Snapshot"-\x82\xd3\xe4\x93\x02\'\x12%/v1/{snapshot=projects/*/snapshots/*}\x12\x8c\x01\n\rListSnapshots\x12&.google.pubsub.v1.ListSnapshotsRequest\x1a\'.google.pubsub.v1.ListSnapshotsResponse"*\x82\xd3\xe4\x93\x02$\x12"/v1/{project=projects/*}/snapshots\x12\x83\x01\n\x0e\x43reateSnapshot\x12\'.google.pubsub.v1.CreateSnapshotRequest\x1a\x1a.google.pubsub.v1.Snapshot",\x82\xd3\xe4\x93\x02&\x1a!/v1/{name=projects/*/snapshots/*}:\x01*\x12\x8c\x01\n\x0eUpdateSnapshot\x12\'.google.pubsub.v1.UpdateSnapshotRequest\x1a\x1a.google.pubsub.v1.Snapshot"5\x82\xd3\xe4\x93\x02/2*/v1/{snapshot.name=projects/*/snapshots/*}:\x01*\x12\x80\x01\n\x0e\x44\x65leteSnapshot\x12\'.google.pubsub.v1.DeleteSnapshotRequest\x1a\x16.google.protobuf.Empty"-\x82\xd3\xe4\x93\x02\'*%/v1/{snapshot=projects/*/snapshots/*}\x12\x84\x01\n\x04Seek\x12\x1d.google.pubsub.v1.SeekRequest\x1a\x1e.google.pubsub.v1.SeekResponse"=\x82\xd3\xe4\x93\x02\x37"2/v1/{subscription=projects/*/subscriptions/*}:seek:\x01*\x1ap\xca\x41\x15pubsub.googleapis.com\xd2\x41Uhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/pubsubB\xae\x01\n\x14\x63om.google.pubsub.v1B\x0bPubsubProtoP\x01Z6google.golang.org/genproto/googleapis/pubsub/v1;pubsub\xf8\x01\x01\xaa\x02\x16Google.Cloud.PubSub.V1\xca\x02\x16Google\\Cloud\\PubSub\\V1\xea\x02\x19Google::Cloud::PubSub::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_MESSAGESTORAGEPOLICY = _descriptor.Descriptor(
+    name="MessageStoragePolicy",
+    full_name="google.pubsub.v1.MessageStoragePolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="allowed_persistence_regions",
+            full_name="google.pubsub.v1.MessageStoragePolicy.allowed_persistence_regions",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=246,
+    serialized_end=305,
+)
+
+
+_TOPIC_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.pubsub.v1.Topic.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.pubsub.v1.Topic.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.pubsub.v1.Topic.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=478,
+    serialized_end=523,
+)
+
+_TOPIC = _descriptor.Descriptor(
+    name="Topic",
+    full_name="google.pubsub.v1.Topic",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.pubsub.v1.Topic.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.pubsub.v1.Topic.labels",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message_storage_policy",
+            full_name="google.pubsub.v1.Topic.message_storage_policy",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kms_key_name",
+            full_name="google.pubsub.v1.Topic.kms_key_name",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TOPIC_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=308,
+    serialized_end=523,
+)
+
+
+_PUBSUBMESSAGE_ATTRIBUTESENTRY = _descriptor.Descriptor(
+    name="AttributesEntry",
+    full_name="google.pubsub.v1.PubsubMessage.AttributesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.pubsub.v1.PubsubMessage.AttributesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.pubsub.v1.PubsubMessage.AttributesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=718,
+    serialized_end=767,
+)
+
+_PUBSUBMESSAGE = _descriptor.Descriptor(
+    name="PubsubMessage",
+    full_name="google.pubsub.v1.PubsubMessage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.pubsub.v1.PubsubMessage.data",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.pubsub.v1.PubsubMessage.attributes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message_id",
+            full_name="google.pubsub.v1.PubsubMessage.message_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publish_time",
+            full_name="google.pubsub.v1.PubsubMessage.publish_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ordering_key",
+            full_name="google.pubsub.v1.PubsubMessage.ordering_key",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PUBSUBMESSAGE_ATTRIBUTESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=526,
+    serialized_end=767,
+)
+
+
+_GETTOPICREQUEST = _descriptor.Descriptor(
+    name="GetTopicRequest",
+    full_name="google.pubsub.v1.GetTopicRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.GetTopicRequest.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=769,
+    serialized_end=801,
+)
+
+
+_UPDATETOPICREQUEST = _descriptor.Descriptor(
+    name="UpdateTopicRequest",
+    full_name="google.pubsub.v1.UpdateTopicRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.UpdateTopicRequest.topic",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.pubsub.v1.UpdateTopicRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=803,
+    serialized_end=912,
+)
+
+
+_PUBLISHREQUEST = _descriptor.Descriptor(
+    name="PublishRequest",
+    full_name="google.pubsub.v1.PublishRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.PublishRequest.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="messages",
+            full_name="google.pubsub.v1.PublishRequest.messages",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=914,
+    serialized_end=996,
+)
+
+
+_PUBLISHRESPONSE = _descriptor.Descriptor(
+    name="PublishResponse",
+    full_name="google.pubsub.v1.PublishResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="message_ids",
+            full_name="google.pubsub.v1.PublishResponse.message_ids",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=998,
+    serialized_end=1036,
+)
+
+
+_LISTTOPICSREQUEST = _descriptor.Descriptor(
+    name="ListTopicsRequest",
+    full_name="google.pubsub.v1.ListTopicsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project",
+            full_name="google.pubsub.v1.ListTopicsRequest.project",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.pubsub.v1.ListTopicsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.pubsub.v1.ListTopicsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1038,
+    serialized_end=1113,
+)
+
+
+_LISTTOPICSRESPONSE = _descriptor.Descriptor(
+    name="ListTopicsResponse",
+    full_name="google.pubsub.v1.ListTopicsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topics",
+            full_name="google.pubsub.v1.ListTopicsResponse.topics",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.pubsub.v1.ListTopicsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1115,
+    serialized_end=1201,
+)
+
+
+_LISTTOPICSUBSCRIPTIONSREQUEST = _descriptor.Descriptor(
+    name="ListTopicSubscriptionsRequest",
+    full_name="google.pubsub.v1.ListTopicSubscriptionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.ListTopicSubscriptionsRequest.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.pubsub.v1.ListTopicSubscriptionsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.pubsub.v1.ListTopicSubscriptionsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1203,
+    serialized_end=1288,
+)
+
+
+_LISTTOPICSUBSCRIPTIONSRESPONSE = _descriptor.Descriptor(
+    name="ListTopicSubscriptionsResponse",
+    full_name="google.pubsub.v1.ListTopicSubscriptionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscriptions",
+            full_name="google.pubsub.v1.ListTopicSubscriptionsResponse.subscriptions",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.pubsub.v1.ListTopicSubscriptionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1290,
+    serialized_end=1370,
+)
+
+
+_LISTTOPICSNAPSHOTSREQUEST = _descriptor.Descriptor(
+    name="ListTopicSnapshotsRequest",
+    full_name="google.pubsub.v1.ListTopicSnapshotsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.ListTopicSnapshotsRequest.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.pubsub.v1.ListTopicSnapshotsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.pubsub.v1.ListTopicSnapshotsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1372,
+    serialized_end=1453,
+)
+
+
+_LISTTOPICSNAPSHOTSRESPONSE = _descriptor.Descriptor(
+    name="ListTopicSnapshotsResponse",
+    full_name="google.pubsub.v1.ListTopicSnapshotsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshots",
+            full_name="google.pubsub.v1.ListTopicSnapshotsResponse.snapshots",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.pubsub.v1.ListTopicSnapshotsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1455,
+    serialized_end=1527,
+)
+
+
+_DELETETOPICREQUEST = _descriptor.Descriptor(
+    name="DeleteTopicRequest",
+    full_name="google.pubsub.v1.DeleteTopicRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.DeleteTopicRequest.topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1529,
+    serialized_end=1564,
+)
+
+
+_SUBSCRIPTION_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.pubsub.v1.Subscription.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.pubsub.v1.Subscription.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.pubsub.v1.Subscription.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=478,
+    serialized_end=523,
+)
+
+_SUBSCRIPTION = _descriptor.Descriptor(
+    name="Subscription",
+    full_name="google.pubsub.v1.Subscription",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.pubsub.v1.Subscription.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.Subscription.topic",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="push_config",
+            full_name="google.pubsub.v1.Subscription.push_config",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ack_deadline_seconds",
+            full_name="google.pubsub.v1.Subscription.ack_deadline_seconds",
+            index=3,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="retain_acked_messages",
+            full_name="google.pubsub.v1.Subscription.retain_acked_messages",
+            index=4,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message_retention_duration",
+            full_name="google.pubsub.v1.Subscription.message_retention_duration",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.pubsub.v1.Subscription.labels",
+            index=6,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_message_ordering",
+            full_name="google.pubsub.v1.Subscription.enable_message_ordering",
+            index=7,
+            number=10,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expiration_policy",
+            full_name="google.pubsub.v1.Subscription.expiration_policy",
+            index=8,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dead_letter_policy",
+            full_name="google.pubsub.v1.Subscription.dead_letter_policy",
+            index=9,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SUBSCRIPTION_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1567,
+    serialized_end=2052,
+)
+
+
+_DEADLETTERPOLICY = _descriptor.Descriptor(
+    name="DeadLetterPolicy",
+    full_name="google.pubsub.v1.DeadLetterPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dead_letter_topic",
+            full_name="google.pubsub.v1.DeadLetterPolicy.dead_letter_topic",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_delivery_attempts",
+            full_name="google.pubsub.v1.DeadLetterPolicy.max_delivery_attempts",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2054,
+    serialized_end=2130,
+)
+
+
+_EXPIRATIONPOLICY = _descriptor.Descriptor(
+    name="ExpirationPolicy",
+    full_name="google.pubsub.v1.ExpirationPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="ttl",
+            full_name="google.pubsub.v1.ExpirationPolicy.ttl",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2132,
+    serialized_end=2190,
+)
+
+
+_PUSHCONFIG_OIDCTOKEN = _descriptor.Descriptor(
+    name="OidcToken",
+    full_name="google.pubsub.v1.PushConfig.OidcToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.pubsub.v1.PushConfig.OidcToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audience",
+            full_name="google.pubsub.v1.PushConfig.OidcToken.audience",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2358,
+    serialized_end=2418,
+)
+
+_PUSHCONFIG_ATTRIBUTESENTRY = _descriptor.Descriptor(
+    name="AttributesEntry",
+    full_name="google.pubsub.v1.PushConfig.AttributesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.pubsub.v1.PushConfig.AttributesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.pubsub.v1.PushConfig.AttributesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=718,
+    serialized_end=767,
+)
+
+_PUSHCONFIG = _descriptor.Descriptor(
+    name="PushConfig",
+    full_name="google.pubsub.v1.PushConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="push_endpoint",
+            full_name="google.pubsub.v1.PushConfig.push_endpoint",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.pubsub.v1.PushConfig.attributes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oidc_token",
+            full_name="google.pubsub.v1.PushConfig.oidc_token",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PUSHCONFIG_OIDCTOKEN, _PUSHCONFIG_ATTRIBUTESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="authentication_method",
+            full_name="google.pubsub.v1.PushConfig.authentication_method",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2193,
+    serialized_end=2494,
+)
+
+
+_RECEIVEDMESSAGE = _descriptor.Descriptor(
+    name="ReceivedMessage",
+    full_name="google.pubsub.v1.ReceivedMessage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="ack_id",
+            full_name="google.pubsub.v1.ReceivedMessage.ack_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message",
+            full_name="google.pubsub.v1.ReceivedMessage.message",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delivery_attempt",
+            full_name="google.pubsub.v1.ReceivedMessage.delivery_attempt",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2496,
+    serialized_end=2605,
+)
+
+
+_GETSUBSCRIPTIONREQUEST = _descriptor.Descriptor(
+    name="GetSubscriptionRequest",
+    full_name="google.pubsub.v1.GetSubscriptionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.GetSubscriptionRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2607,
+    serialized_end=2653,
+)
+
+
+_UPDATESUBSCRIPTIONREQUEST = _descriptor.Descriptor(
+    name="UpdateSubscriptionRequest",
+    full_name="google.pubsub.v1.UpdateSubscriptionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.UpdateSubscriptionRequest.subscription",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.pubsub.v1.UpdateSubscriptionRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2656,
+    serialized_end=2786,
+)
+
+
+_LISTSUBSCRIPTIONSREQUEST = _descriptor.Descriptor(
+    name="ListSubscriptionsRequest",
+    full_name="google.pubsub.v1.ListSubscriptionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project",
+            full_name="google.pubsub.v1.ListSubscriptionsRequest.project",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.pubsub.v1.ListSubscriptionsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.pubsub.v1.ListSubscriptionsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2788,
+    serialized_end=2870,
+)
+
+
+_LISTSUBSCRIPTIONSRESPONSE = _descriptor.Descriptor(
+    name="ListSubscriptionsResponse",
+    full_name="google.pubsub.v1.ListSubscriptionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscriptions",
+            full_name="google.pubsub.v1.ListSubscriptionsResponse.subscriptions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.pubsub.v1.ListSubscriptionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2872,
+    serialized_end=2979,
+)
+
+
+_DELETESUBSCRIPTIONREQUEST = _descriptor.Descriptor(
+    name="DeleteSubscriptionRequest",
+    full_name="google.pubsub.v1.DeleteSubscriptionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.DeleteSubscriptionRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2981,
+    serialized_end=3030,
+)
+
+
+_MODIFYPUSHCONFIGREQUEST = _descriptor.Descriptor(
+    name="ModifyPushConfigRequest",
+    full_name="google.pubsub.v1.ModifyPushConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.ModifyPushConfigRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="push_config",
+            full_name="google.pubsub.v1.ModifyPushConfigRequest.push_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3032,
+    serialized_end=3130,
+)
+
+
+_PULLREQUEST = _descriptor.Descriptor(
+    name="PullRequest",
+    full_name="google.pubsub.v1.PullRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.PullRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="return_immediately",
+            full_name="google.pubsub.v1.PullRequest.return_immediately",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_messages",
+            full_name="google.pubsub.v1.PullRequest.max_messages",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3132,
+    serialized_end=3217,
+)
+
+
+_PULLRESPONSE = _descriptor.Descriptor(
+    name="PullResponse",
+    full_name="google.pubsub.v1.PullResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="received_messages",
+            full_name="google.pubsub.v1.PullResponse.received_messages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3219,
+    serialized_end=3295,
+)
+
+
+_MODIFYACKDEADLINEREQUEST = _descriptor.Descriptor(
+    name="ModifyAckDeadlineRequest",
+    full_name="google.pubsub.v1.ModifyAckDeadlineRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.ModifyAckDeadlineRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ack_ids",
+            full_name="google.pubsub.v1.ModifyAckDeadlineRequest.ack_ids",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ack_deadline_seconds",
+            full_name="google.pubsub.v1.ModifyAckDeadlineRequest.ack_deadline_seconds",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3297,
+    serialized_end=3392,
+)
+
+
+_ACKNOWLEDGEREQUEST = _descriptor.Descriptor(
+    name="AcknowledgeRequest",
+    full_name="google.pubsub.v1.AcknowledgeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.AcknowledgeRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ack_ids",
+            full_name="google.pubsub.v1.AcknowledgeRequest.ack_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3394,
+    serialized_end=3453,
+)
+
+
+_STREAMINGPULLREQUEST = _descriptor.Descriptor(
+    name="StreamingPullRequest",
+    full_name="google.pubsub.v1.StreamingPullRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.StreamingPullRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ack_ids",
+            full_name="google.pubsub.v1.StreamingPullRequest.ack_ids",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="modify_deadline_seconds",
+            full_name="google.pubsub.v1.StreamingPullRequest.modify_deadline_seconds",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="modify_deadline_ack_ids",
+            full_name="google.pubsub.v1.StreamingPullRequest.modify_deadline_ack_ids",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stream_ack_deadline_seconds",
+            full_name="google.pubsub.v1.StreamingPullRequest.stream_ack_deadline_seconds",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3456,
+    serialized_end=3620,
+)
+
+
+_STREAMINGPULLRESPONSE = _descriptor.Descriptor(
+    name="StreamingPullResponse",
+    full_name="google.pubsub.v1.StreamingPullResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="received_messages",
+            full_name="google.pubsub.v1.StreamingPullResponse.received_messages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3622,
+    serialized_end=3707,
+)
+
+
+_CREATESNAPSHOTREQUEST_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.pubsub.v1.CreateSnapshotRequest.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.pubsub.v1.CreateSnapshotRequest.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.pubsub.v1.CreateSnapshotRequest.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=478,
+    serialized_end=523,
+)
+
+_CREATESNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="CreateSnapshotRequest",
+    full_name="google.pubsub.v1.CreateSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.pubsub.v1.CreateSnapshotRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.CreateSnapshotRequest.subscription",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.pubsub.v1.CreateSnapshotRequest.labels",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_CREATESNAPSHOTREQUEST_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3710,
+    serialized_end=3885,
+)
+
+
+_UPDATESNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="UpdateSnapshotRequest",
+    full_name="google.pubsub.v1.UpdateSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshot",
+            full_name="google.pubsub.v1.UpdateSnapshotRequest.snapshot",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.pubsub.v1.UpdateSnapshotRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3887,
+    serialized_end=4005,
+)
+
+
+_SNAPSHOT_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.pubsub.v1.Snapshot.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.pubsub.v1.Snapshot.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.pubsub.v1.Snapshot.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=478,
+    serialized_end=523,
+)
+
+_SNAPSHOT = _descriptor.Descriptor(
+    name="Snapshot",
+    full_name="google.pubsub.v1.Snapshot",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.pubsub.v1.Snapshot.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topic",
+            full_name="google.pubsub.v1.Snapshot.topic",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.pubsub.v1.Snapshot.expire_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.pubsub.v1.Snapshot.labels",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SNAPSHOT_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4008,
+    serialized_end=4199,
+)
+
+
+_GETSNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="GetSnapshotRequest",
+    full_name="google.pubsub.v1.GetSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshot",
+            full_name="google.pubsub.v1.GetSnapshotRequest.snapshot",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4201,
+    serialized_end=4239,
+)
+
+
+_LISTSNAPSHOTSREQUEST = _descriptor.Descriptor(
+    name="ListSnapshotsRequest",
+    full_name="google.pubsub.v1.ListSnapshotsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project",
+            full_name="google.pubsub.v1.ListSnapshotsRequest.project",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.pubsub.v1.ListSnapshotsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.pubsub.v1.ListSnapshotsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4241,
+    serialized_end=4319,
+)
+
+
+_LISTSNAPSHOTSRESPONSE = _descriptor.Descriptor(
+    name="ListSnapshotsResponse",
+    full_name="google.pubsub.v1.ListSnapshotsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshots",
+            full_name="google.pubsub.v1.ListSnapshotsResponse.snapshots",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.pubsub.v1.ListSnapshotsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4321,
+    serialized_end=4416,
+)
+
+
+_DELETESNAPSHOTREQUEST = _descriptor.Descriptor(
+    name="DeleteSnapshotRequest",
+    full_name="google.pubsub.v1.DeleteSnapshotRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="snapshot",
+            full_name="google.pubsub.v1.DeleteSnapshotRequest.snapshot",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4418,
+    serialized_end=4459,
+)
+
+
+_SEEKREQUEST = _descriptor.Descriptor(
+    name="SeekRequest",
+    full_name="google.pubsub.v1.SeekRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="subscription",
+            full_name="google.pubsub.v1.SeekRequest.subscription",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time",
+            full_name="google.pubsub.v1.SeekRequest.time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="snapshot",
+            full_name="google.pubsub.v1.SeekRequest.snapshot",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target",
+            full_name="google.pubsub.v1.SeekRequest.target",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=4461,
+    serialized_end=4570,
+)
+
+
+_SEEKRESPONSE = _descriptor.Descriptor(
+    name="SeekResponse",
+    full_name="google.pubsub.v1.SeekResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4572,
+    serialized_end=4586,
+)
+
+_TOPIC_LABELSENTRY.containing_type = _TOPIC
+_TOPIC.fields_by_name["labels"].message_type = _TOPIC_LABELSENTRY
+_TOPIC.fields_by_name["message_storage_policy"].message_type = _MESSAGESTORAGEPOLICY
+_PUBSUBMESSAGE_ATTRIBUTESENTRY.containing_type = _PUBSUBMESSAGE
+_PUBSUBMESSAGE.fields_by_name[
+    "attributes"
+].message_type = _PUBSUBMESSAGE_ATTRIBUTESENTRY
+_PUBSUBMESSAGE.fields_by_name[
+    "publish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATETOPICREQUEST.fields_by_name["topic"].message_type = _TOPIC
+_UPDATETOPICREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_PUBLISHREQUEST.fields_by_name["messages"].message_type = _PUBSUBMESSAGE
+_LISTTOPICSRESPONSE.fields_by_name["topics"].message_type = _TOPIC
+_SUBSCRIPTION_LABELSENTRY.containing_type = _SUBSCRIPTION
+_SUBSCRIPTION.fields_by_name["push_config"].message_type = _PUSHCONFIG
+_SUBSCRIPTION.fields_by_name[
+    "message_retention_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_SUBSCRIPTION.fields_by_name["labels"].message_type = _SUBSCRIPTION_LABELSENTRY
+_SUBSCRIPTION.fields_by_name["expiration_policy"].message_type = _EXPIRATIONPOLICY
+_SUBSCRIPTION.fields_by_name["dead_letter_policy"].message_type = _DEADLETTERPOLICY
+_EXPIRATIONPOLICY.fields_by_name[
+    "ttl"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_PUSHCONFIG_OIDCTOKEN.containing_type = _PUSHCONFIG
+_PUSHCONFIG_ATTRIBUTESENTRY.containing_type = _PUSHCONFIG
+_PUSHCONFIG.fields_by_name["attributes"].message_type = _PUSHCONFIG_ATTRIBUTESENTRY
+_PUSHCONFIG.fields_by_name["oidc_token"].message_type = _PUSHCONFIG_OIDCTOKEN
+_PUSHCONFIG.oneofs_by_name["authentication_method"].fields.append(
+    _PUSHCONFIG.fields_by_name["oidc_token"]
+)
+_PUSHCONFIG.fields_by_name["oidc_token"].containing_oneof = _PUSHCONFIG.oneofs_by_name[
+    "authentication_method"
+]
+_RECEIVEDMESSAGE.fields_by_name["message"].message_type = _PUBSUBMESSAGE
+_UPDATESUBSCRIPTIONREQUEST.fields_by_name["subscription"].message_type = _SUBSCRIPTION
+_UPDATESUBSCRIPTIONREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTSUBSCRIPTIONSRESPONSE.fields_by_name["subscriptions"].message_type = _SUBSCRIPTION
+_MODIFYPUSHCONFIGREQUEST.fields_by_name["push_config"].message_type = _PUSHCONFIG
+_PULLRESPONSE.fields_by_name["received_messages"].message_type = _RECEIVEDMESSAGE
+_STREAMINGPULLRESPONSE.fields_by_name[
+    "received_messages"
+].message_type = _RECEIVEDMESSAGE
+_CREATESNAPSHOTREQUEST_LABELSENTRY.containing_type = _CREATESNAPSHOTREQUEST
+_CREATESNAPSHOTREQUEST.fields_by_name[
+    "labels"
+].message_type = _CREATESNAPSHOTREQUEST_LABELSENTRY
+_UPDATESNAPSHOTREQUEST.fields_by_name["snapshot"].message_type = _SNAPSHOT
+_UPDATESNAPSHOTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_SNAPSHOT_LABELSENTRY.containing_type = _SNAPSHOT
+_SNAPSHOT.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SNAPSHOT.fields_by_name["labels"].message_type = _SNAPSHOT_LABELSENTRY
+_LISTSNAPSHOTSRESPONSE.fields_by_name["snapshots"].message_type = _SNAPSHOT
+_SEEKREQUEST.fields_by_name[
+    "time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SEEKREQUEST.oneofs_by_name["target"].fields.append(_SEEKREQUEST.fields_by_name["time"])
+_SEEKREQUEST.fields_by_name["time"].containing_oneof = _SEEKREQUEST.oneofs_by_name[
+    "target"
+]
+_SEEKREQUEST.oneofs_by_name["target"].fields.append(
+    _SEEKREQUEST.fields_by_name["snapshot"]
+)
+_SEEKREQUEST.fields_by_name["snapshot"].containing_oneof = _SEEKREQUEST.oneofs_by_name[
+    "target"
+]
+DESCRIPTOR.message_types_by_name["MessageStoragePolicy"] = _MESSAGESTORAGEPOLICY
+DESCRIPTOR.message_types_by_name["Topic"] = _TOPIC
+DESCRIPTOR.message_types_by_name["PubsubMessage"] = _PUBSUBMESSAGE
+DESCRIPTOR.message_types_by_name["GetTopicRequest"] = _GETTOPICREQUEST
+DESCRIPTOR.message_types_by_name["UpdateTopicRequest"] = _UPDATETOPICREQUEST
+DESCRIPTOR.message_types_by_name["PublishRequest"] = _PUBLISHREQUEST
+DESCRIPTOR.message_types_by_name["PublishResponse"] = _PUBLISHRESPONSE
+DESCRIPTOR.message_types_by_name["ListTopicsRequest"] = _LISTTOPICSREQUEST
+DESCRIPTOR.message_types_by_name["ListTopicsResponse"] = _LISTTOPICSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ListTopicSubscriptionsRequest"
+] = _LISTTOPICSUBSCRIPTIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListTopicSubscriptionsResponse"
+] = _LISTTOPICSUBSCRIPTIONSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ListTopicSnapshotsRequest"
+] = _LISTTOPICSNAPSHOTSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListTopicSnapshotsResponse"
+] = _LISTTOPICSNAPSHOTSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteTopicRequest"] = _DELETETOPICREQUEST
+DESCRIPTOR.message_types_by_name["Subscription"] = _SUBSCRIPTION
+DESCRIPTOR.message_types_by_name["DeadLetterPolicy"] = _DEADLETTERPOLICY
+DESCRIPTOR.message_types_by_name["ExpirationPolicy"] = _EXPIRATIONPOLICY
+DESCRIPTOR.message_types_by_name["PushConfig"] = _PUSHCONFIG
+DESCRIPTOR.message_types_by_name["ReceivedMessage"] = _RECEIVEDMESSAGE
+DESCRIPTOR.message_types_by_name["GetSubscriptionRequest"] = _GETSUBSCRIPTIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateSubscriptionRequest"
+] = _UPDATESUBSCRIPTIONREQUEST
+DESCRIPTOR.message_types_by_name["ListSubscriptionsRequest"] = _LISTSUBSCRIPTIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListSubscriptionsResponse"
+] = _LISTSUBSCRIPTIONSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "DeleteSubscriptionRequest"
+] = _DELETESUBSCRIPTIONREQUEST
+DESCRIPTOR.message_types_by_name["ModifyPushConfigRequest"] = _MODIFYPUSHCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["PullRequest"] = _PULLREQUEST
+DESCRIPTOR.message_types_by_name["PullResponse"] = _PULLRESPONSE
+DESCRIPTOR.message_types_by_name["ModifyAckDeadlineRequest"] = _MODIFYACKDEADLINEREQUEST
+DESCRIPTOR.message_types_by_name["AcknowledgeRequest"] = _ACKNOWLEDGEREQUEST
+DESCRIPTOR.message_types_by_name["StreamingPullRequest"] = _STREAMINGPULLREQUEST
+DESCRIPTOR.message_types_by_name["StreamingPullResponse"] = _STREAMINGPULLRESPONSE
+DESCRIPTOR.message_types_by_name["CreateSnapshotRequest"] = _CREATESNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateSnapshotRequest"] = _UPDATESNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["Snapshot"] = _SNAPSHOT
+DESCRIPTOR.message_types_by_name["GetSnapshotRequest"] = _GETSNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["ListSnapshotsRequest"] = _LISTSNAPSHOTSREQUEST
+DESCRIPTOR.message_types_by_name["ListSnapshotsResponse"] = _LISTSNAPSHOTSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteSnapshotRequest"] = _DELETESNAPSHOTREQUEST
+DESCRIPTOR.message_types_by_name["SeekRequest"] = _SEEKREQUEST
+DESCRIPTOR.message_types_by_name["SeekResponse"] = _SEEKRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+MessageStoragePolicy = _reflection.GeneratedProtocolMessageType(
+    "MessageStoragePolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MESSAGESTORAGEPOLICY,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A message storage policy.
+
+
+    Attributes:
+      allowed_persistence_regions:
+          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 means that no regions
+          are allowed, and is not a valid configuration.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.MessageStoragePolicy)
+    ),
+)
+_sym_db.RegisterMessage(MessageStoragePolicy)
+
+Topic = _reflection.GeneratedProtocolMessageType(
+    "Topic",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TOPIC_LABELSENTRY,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2"
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.Topic.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TOPIC,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A topic resource.
+  
+  
+  Attributes:
+      name:
+          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"``.
+      labels:
+          See Creating and managing labels.
+      message_storage_policy:
+          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.
+      kms_key_name:
+          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/*``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.Topic)
+    ),
+)
+_sym_db.RegisterMessage(Topic)
+_sym_db.RegisterMessage(Topic.LabelsEntry)
+
+PubsubMessage = _reflection.GeneratedProtocolMessageType(
+    "PubsubMessage",
+    (_message.Message,),
+    dict(
+        AttributesEntry=_reflection.GeneratedProtocolMessageType(
+            "AttributesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PUBSUBMESSAGE_ATTRIBUTESENTRY,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2"
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.PubsubMessage.AttributesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PUBSUBMESSAGE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A message that is published by publishers and consumed by subscribers.
+  The message must contain either a non-empty data field or at least one
+  attribute. Note that client libraries represent this object differently
+  depending on the language. See the corresponding client library
+  documentation for more information. See Quotas and limits for more
+  information about message limits.
+  
+  
+  Attributes:
+      data:
+          The message data field. If this field is empty, the message
+          must contain at least one attribute.
+      attributes:
+          Optional attributes for this message.
+      message_id:
+          ID of this message, assigned by the server when the message is
+          published. Guaranteed to be unique within the topic. This
+          value may be read by a subscriber that receives a
+          ``PubsubMessage`` via a ``Pull`` call or a push delivery. It
+          must not be populated by the publisher in a ``Publish`` call.
+      publish_time:
+          The time at which the message was published, populated by the
+          server when it receives the ``Publish`` call. It must not be
+          populated by the publisher in a ``Publish`` call.
+      ordering_key:
+          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. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.PubsubMessage)
+    ),
+)
+_sym_db.RegisterMessage(PubsubMessage)
+_sym_db.RegisterMessage(PubsubMessage.AttributesEntry)
+
+GetTopicRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTopicRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTOPICREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the GetTopic method.
+  
+  
+  Attributes:
+      topic:
+          The name of the topic to get. Format is
+          ``projects/{project}/topics/{topic}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.GetTopicRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTopicRequest)
+
+UpdateTopicRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTopicRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETOPICREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the UpdateTopic method.
+  
+  
+  Attributes:
+      topic:
+          The updated topic object.
+      update_mask:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.UpdateTopicRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTopicRequest)
+
+PublishRequest = _reflection.GeneratedProtocolMessageType(
+    "PublishRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBLISHREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the Publish method.
+  
+  
+  Attributes:
+      topic:
+          The messages in the request will be published on this topic.
+          Format is ``projects/{project}/topics/{topic}``.
+      messages:
+          The messages to publish.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.PublishRequest)
+    ),
+)
+_sym_db.RegisterMessage(PublishRequest)
+
+PublishResponse = _reflection.GeneratedProtocolMessageType(
+    "PublishResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBLISHRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``Publish`` method.
+  
+  
+  Attributes:
+      message_ids:
+          The server-assigned ID of each published message, in the same
+          order as the messages in the request. IDs are guaranteed to be
+          unique within the topic.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.PublishResponse)
+    ),
+)
+_sym_db.RegisterMessage(PublishResponse)
+
+ListTopicsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTopicsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTOPICSREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``ListTopics`` method.
+  
+  
+  Attributes:
+      project:
+          The name of the project in which to list topics. Format is
+          ``projects/{project-id}``.
+      page_size:
+          Maximum number of topics to return.
+      page_token:
+          The value returned by the last ``ListTopicsResponse``;
+          indicates that this is a continuation of a prior
+          ``ListTopics`` call, and that the system should return the
+          next page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListTopicsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTopicsRequest)
+
+ListTopicsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTopicsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTOPICSRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``ListTopics`` method.
+  
+  
+  Attributes:
+      topics:
+          The resulting topics.
+      next_page_token:
+          If not empty, indicates that there may be more topics that
+          match the request; this value should be passed in a new
+          ``ListTopicsRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListTopicsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTopicsResponse)
+
+ListTopicSubscriptionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTopicSubscriptionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTOPICSUBSCRIPTIONSREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``ListTopicSubscriptions`` method.
+  
+  
+  Attributes:
+      topic:
+          The name of the topic that subscriptions are attached to.
+          Format is ``projects/{project}/topics/{topic}``.
+      page_size:
+          Maximum number of subscription names to return.
+      page_token:
+          The value returned by the last
+          ``ListTopicSubscriptionsResponse``; indicates that this is a
+          continuation of a prior ``ListTopicSubscriptions`` call, and
+          that the system should return the next page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListTopicSubscriptionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTopicSubscriptionsRequest)
+
+ListTopicSubscriptionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTopicSubscriptionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTOPICSUBSCRIPTIONSRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``ListTopicSubscriptions`` method.
+  
+  
+  Attributes:
+      subscriptions:
+          The names of the subscriptions that match the request.
+      next_page_token:
+          If not empty, indicates that there may be more subscriptions
+          that match the request; this value should be passed in a new
+          ``ListTopicSubscriptionsRequest`` to get more subscriptions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListTopicSubscriptionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTopicSubscriptionsResponse)
+
+ListTopicSnapshotsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTopicSnapshotsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTOPICSNAPSHOTSREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``ListTopicSnapshots`` method.
+  
+  
+  Attributes:
+      topic:
+          The name of the topic that snapshots are attached to. Format
+          is ``projects/{project}/topics/{topic}``.
+      page_size:
+          Maximum number of snapshot names to return.
+      page_token:
+          The value returned by the last ``ListTopicSnapshotsResponse``;
+          indicates that this is a continuation of a prior
+          ``ListTopicSnapshots`` call, and that the system should return
+          the next page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListTopicSnapshotsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTopicSnapshotsRequest)
+
+ListTopicSnapshotsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTopicSnapshotsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTOPICSNAPSHOTSRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``ListTopicSnapshots`` method.
+  
+  
+  Attributes:
+      snapshots:
+          The names of the snapshots that match the request.
+      next_page_token:
+          If not empty, indicates that there may be more snapshots that
+          match the request; this value should be passed in a new
+          ``ListTopicSnapshotsRequest`` to get more snapshots.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListTopicSnapshotsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTopicSnapshotsResponse)
+
+DeleteTopicRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTopicRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETOPICREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``DeleteTopic`` method.
+  
+  
+  Attributes:
+      topic:
+          Name of the topic to delete. Format is
+          ``projects/{project}/topics/{topic}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.DeleteTopicRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTopicRequest)
+
+Subscription = _reflection.GeneratedProtocolMessageType(
+    "Subscription",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SUBSCRIPTION_LABELSENTRY,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2"
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.Subscription.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_SUBSCRIPTION,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A subscription resource.
+  
+  
+  Attributes:
+      name:
+          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"``.
+      topic:
+          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.
+      push_config:
+          If push delivery is used with this subscription, this field is
+          used to configure it. An empty ``pushConfig`` signifies that
+          the subscriber will pull and ack messages using API methods.
+      ack_deadline_seconds:
+          The approximate amount of time (on a best-effort basis)
+          Pub/Sub waits for the subscriber to acknowledge receipt before
+          resending the message. In the interval after the message is
+          delivered and before it is acknowledged, it is considered to
+          be outstanding. During that time period, the message will not
+          be redelivered (on a best-effort basis).  For pull
+          subscriptions, this value is used as the initial value for the
+          ack deadline. To override this value for a given message, call
+          ``ModifyAckDeadline`` with the corresponding ``ack_id`` if
+          using non-streaming pull or send the ``ack_id`` in a
+          ``StreamingModifyAckDeadlineRequest`` if using streaming pull.
+          The minimum custom deadline you can specify is 10 seconds. The
+          maximum custom deadline you can specify is 600 seconds (10
+          minutes). If this parameter is 0, a default value of 10
+          seconds is used.  For push delivery, this value is also used
+          to set the request timeout for the call to the push endpoint.
+          If the subscriber never acknowledges the message, the Pub/Sub
+          system will eventually redeliver the message.
+      retain_acked_messages:
+          Indicates whether to retain acknowledged messages. If true,
+          then messages are not expunged from the subscription's
+          backlog, even if they are acknowledged, until they fall out of
+          the ``message_retention_duration`` window. This must be true
+          if you would like to Seek to a timestamp.
+      message_retention_duration:
+          How long to retain unacknowledged messages in the
+          subscription's backlog, from the moment a message is
+          published. If ``retain_acked_messages`` is true, then this
+          also configures the retention of acknowledged messages, and
+          thus configures how far back in time a ``Seek`` can be done.
+          Defaults to 7 days. Cannot be more than 7 days or less than 10
+          minutes.
+      labels:
+          See Creating and managing labels.
+      enable_message_ordering:
+          If true, messages published with the same ``ordering_key`` in
+          ``PubsubMessage`` will be delivered to the subscribers in the
+          order in which they are received by the Pub/Sub system.
+          Otherwise, they may be delivered in any order. 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.
+      expiration_policy:
+          A policy that specifies the conditions for this subscription's
+          expiration. A subscription is considered active as long as any
+          connected subscriber is successfully consuming messages from
+          the subscription or is issuing operations on the subscription.
+          If ``expiration_policy`` is not set, a *default policy* with
+          ``ttl`` of 31 days will be used. The minimum allowed value for
+          ``expiration_policy.ttl`` is 1 day.
+      dead_letter_policy:
+          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. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.Subscription)
+    ),
+)
+_sym_db.RegisterMessage(Subscription)
+_sym_db.RegisterMessage(Subscription.LabelsEntry)
+
+DeadLetterPolicy = _reflection.GeneratedProtocolMessageType(
+    "DeadLetterPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEADLETTERPOLICY,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      dead_letter_topic:
+          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.
+      max_delivery_attempts:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.DeadLetterPolicy)
+    ),
+)
+_sym_db.RegisterMessage(DeadLetterPolicy)
+
+ExpirationPolicy = _reflection.GeneratedProtocolMessageType(
+    "ExpirationPolicy",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPIRATIONPOLICY,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A policy that specifies the conditions for resource expiration (i.e.,
+  automatic resource deletion).
+  
+  
+  Attributes:
+      ttl:
+          Specifies the "time-to-live" duration for an associated
+          resource. The resource expires if it is not active for a
+          period of ``ttl``. The definition of "activity" depends on the
+          type of the associated resource. The minimum and maximum
+          allowed values for ``ttl`` depend on the type of the
+          associated resource, as well. If ``ttl`` is not set, the
+          associated resource never expires.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ExpirationPolicy)
+    ),
+)
+_sym_db.RegisterMessage(ExpirationPolicy)
+
+PushConfig = _reflection.GeneratedProtocolMessageType(
+    "PushConfig",
+    (_message.Message,),
+    dict(
+        OidcToken=_reflection.GeneratedProtocolMessageType(
+            "OidcToken",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PUSHCONFIG_OIDCTOKEN,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+                __doc__="""Contains information needed for generating an `OpenID Connect
+    token <https://developers.google.com/identity/protocols/OpenIDConnect>`__.
+    
+    
+    Attributes:
+        service_account_email:
+            `Service account email
+            <https://cloud.google.com/iam/docs/service-accounts>`__ to be
+            used for generating the OIDC token. The caller (for
+            CreateSubscription, UpdateSubscription, and ModifyPushConfig
+            RPCs) must have the iam.serviceAccounts.actAs permission for
+            the service account.
+        audience:
+            Audience to be used when generating OIDC token. The audience
+            claim identifies the recipients that the JWT is intended for.
+            The audience value is a single case-sensitive string. Having
+            multiple values (array) for the audience field is not
+            supported. More info about the OIDC JWT token audience here:
+            https://tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not
+            specified, the Push endpoint URL will be used.
+    """,
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.PushConfig.OidcToken)
+            ),
+        ),
+        AttributesEntry=_reflection.GeneratedProtocolMessageType(
+            "AttributesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PUSHCONFIG_ATTRIBUTESENTRY,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2"
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.PushConfig.AttributesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PUSHCONFIG,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Configuration for a push delivery endpoint.
+  
+  
+  Attributes:
+      push_endpoint:
+          A URL locating the endpoint to which messages should be
+          pushed. For example, a Webhook endpoint might use
+          "https://example.com/push".
+      attributes:
+          Endpoint configuration attributes that can be used to control
+          different aspects of the message delivery.  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).  If not present during the
+          ``CreateSubscription`` call, it will default to 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 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:  ..
+          raw:: html     <pre><code>attributes { "x-goog-version": "v1"
+          } </code></pre>
+      authentication_method:
+          An authentication method used by push endpoints to verify the
+          source of push requests. This can be used with push endpoints
+          that are private by default to allow requests only from the
+          Cloud Pub/Sub system, for example. This field is optional and
+          should be set only by users interested in authenticated push.
+      oidc_token:
+          If specified, Pub/Sub will generate and attach an OIDC JWT
+          token as an ``Authorization`` header in the HTTP request for
+          every pushed message.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.PushConfig)
+    ),
+)
+_sym_db.RegisterMessage(PushConfig)
+_sym_db.RegisterMessage(PushConfig.OidcToken)
+_sym_db.RegisterMessage(PushConfig.AttributesEntry)
+
+ReceivedMessage = _reflection.GeneratedProtocolMessageType(
+    "ReceivedMessage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECEIVEDMESSAGE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A message and its corresponding acknowledgment ID.
+  
+  
+  Attributes:
+      ack_id:
+          This ID can be used to acknowledge the received message.
+      message:
+          The message.
+      delivery_attempt:
+          Delivery attempt counter is 1 + (the sum of number of NACKs
+          and 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.  The first
+          delivery of a given message will have this value as 1. The
+          value is calculated at best effort and is approximate.  If a
+          DeadLetterPolicy is not set on the subscription, this will be
+          0. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ReceivedMessage)
+    ),
+)
+_sym_db.RegisterMessage(ReceivedMessage)
+
+GetSubscriptionRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSubscriptionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSUBSCRIPTIONREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the GetSubscription method.
+  
+  
+  Attributes:
+      subscription:
+          The name of the subscription to get. Format is
+          ``projects/{project}/subscriptions/{sub}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.GetSubscriptionRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSubscriptionRequest)
+
+UpdateSubscriptionRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSubscriptionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESUBSCRIPTIONREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the UpdateSubscription method.
+  
+  
+  Attributes:
+      subscription:
+          The updated subscription object.
+      update_mask:
+          Indicates which fields in the provided subscription to update.
+          Must be specified and non-empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.UpdateSubscriptionRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSubscriptionRequest)
+
+ListSubscriptionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSubscriptionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSUBSCRIPTIONSREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``ListSubscriptions`` method.
+  
+  
+  Attributes:
+      project:
+          The name of the project in which to list subscriptions. Format
+          is ``projects/{project-id}``.
+      page_size:
+          Maximum number of subscriptions to return.
+      page_token:
+          The value returned by the last ``ListSubscriptionsResponse``;
+          indicates that this is a continuation of a prior
+          ``ListSubscriptions`` call, and that the system should return
+          the next page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListSubscriptionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSubscriptionsRequest)
+
+ListSubscriptionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSubscriptionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSUBSCRIPTIONSRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``ListSubscriptions`` method.
+  
+  
+  Attributes:
+      subscriptions:
+          The subscriptions that match the request.
+      next_page_token:
+          If not empty, indicates that there may be more subscriptions
+          that match the request; this value should be passed in a new
+          ``ListSubscriptionsRequest`` to get more subscriptions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListSubscriptionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSubscriptionsResponse)
+
+DeleteSubscriptionRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSubscriptionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESUBSCRIPTIONREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the DeleteSubscription method.
+  
+  
+  Attributes:
+      subscription:
+          The subscription to delete. Format is
+          ``projects/{project}/subscriptions/{sub}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.DeleteSubscriptionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSubscriptionRequest)
+
+ModifyPushConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "ModifyPushConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODIFYPUSHCONFIGREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ModifyPushConfig method.
+  
+  
+  Attributes:
+      subscription:
+          The name of the subscription. Format is
+          ``projects/{project}/subscriptions/{sub}``.
+      push_config:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ModifyPushConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(ModifyPushConfigRequest)
+
+PullRequest = _reflection.GeneratedProtocolMessageType(
+    "PullRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PULLREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``Pull`` method.
+  
+  
+  Attributes:
+      subscription:
+          The subscription from which messages should be pulled. Format
+          is ``projects/{project}/subscriptions/{sub}``.
+      return_immediately:
+          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.
+      max_messages:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.PullRequest)
+    ),
+)
+_sym_db.RegisterMessage(PullRequest)
+
+PullResponse = _reflection.GeneratedProtocolMessageType(
+    "PullResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PULLRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``Pull`` method.
+  
+  
+  Attributes:
+      received_messages:
+          Received Pub/Sub messages. The list will be empty if there are
+          no more messages available in the backlog. For JSON, the
+          response can be entirely empty. The Pub/Sub system may return
+          fewer than the ``maxMessages`` requested even if there are
+          more messages available in the backlog.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.PullResponse)
+    ),
+)
+_sym_db.RegisterMessage(PullResponse)
+
+ModifyAckDeadlineRequest = _reflection.GeneratedProtocolMessageType(
+    "ModifyAckDeadlineRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODIFYACKDEADLINEREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ModifyAckDeadline method.
+  
+  
+  Attributes:
+      subscription:
+          The name of the subscription. Format is
+          ``projects/{project}/subscriptions/{sub}``.
+      ack_ids:
+          List of acknowledgment IDs.
+      ack_deadline_seconds:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ModifyAckDeadlineRequest)
+    ),
+)
+_sym_db.RegisterMessage(ModifyAckDeadlineRequest)
+
+AcknowledgeRequest = _reflection.GeneratedProtocolMessageType(
+    "AcknowledgeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACKNOWLEDGEREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the Acknowledge method.
+  
+  
+  Attributes:
+      subscription:
+          The subscription whose message is being acknowledged. Format
+          is ``projects/{project}/subscriptions/{sub}``.
+      ack_ids:
+          The acknowledgment ID for the messages being acknowledged that
+          was returned by the Pub/Sub system in the ``Pull`` response.
+          Must not be empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.AcknowledgeRequest)
+    ),
+)
+_sym_db.RegisterMessage(AcknowledgeRequest)
+
+StreamingPullRequest = _reflection.GeneratedProtocolMessageType(
+    "StreamingPullRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGPULLREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      subscription:
+          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}``.
+      ack_ids:
+          List of acknowledgement IDs for acknowledging previously
+          received messages (received on this stream or a different
+          stream). If an ack ID has expired, the corresponding message
+          may be redelivered later. Acknowledging a message more than
+          once will not result in an error. If the acknowledgement ID is
+          malformed, the stream will be aborted with status
+          ``INVALID_ARGUMENT``.
+      modify_deadline_seconds:
+          The list of new ack deadlines for the IDs listed in
+          ``modify_deadline_ack_ids``. The size of this list must be the
+          same as the size of ``modify_deadline_ack_ids``. If it differs
+          the stream will be aborted with ``INVALID_ARGUMENT``. Each
+          element in this list is applied to the element in the same
+          position in ``modify_deadline_ack_ids``. The new ack deadline
+          is with respect to the time this request was sent to the
+          Pub/Sub system. Must be >= 0. For example, if the value is 10,
+          the new ack deadline will expire 10 seconds after this request
+          is received. If the value is 0, the message is immediately
+          made available for another streaming or non-streaming pull
+          request. If the value is < 0 (an error), the stream will be
+          aborted with status ``INVALID_ARGUMENT``.
+      modify_deadline_ack_ids:
+          List of acknowledgement IDs whose deadline will be modified
+          based on the corresponding element in
+          ``modify_deadline_seconds``. This field can be used to
+          indicate that more time is needed to process a message by the
+          subscriber, or to make the message available for redelivery if
+          the processing was interrupted.
+      stream_ack_deadline_seconds:
+          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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.StreamingPullRequest)
+    ),
+)
+_sym_db.RegisterMessage(StreamingPullRequest)
+
+StreamingPullResponse = _reflection.GeneratedProtocolMessageType(
+    "StreamingPullResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGPULLRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``StreamingPull`` method. This response is used to
+  stream messages from the server to the client.
+  
+  
+  Attributes:
+      received_messages:
+          Received Pub/Sub messages. This will not be empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.StreamingPullResponse)
+    ),
+)
+_sym_db.RegisterMessage(StreamingPullResponse)
+
+CreateSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSnapshotRequest",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_CREATESNAPSHOTREQUEST_LABELSENTRY,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2"
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.CreateSnapshotRequest.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_CREATESNAPSHOTREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``CreateSnapshot`` method.
+  
+  
+  Attributes:
+      name:
+          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}``.
+      subscription:
+          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 unacknowledged upon the successful completion of the
+          ``CreateSnapshot`` request; as well as: (b) Any messages
+          published to the subscription's topic following the successful
+          completion of the CreateSnapshot request. Format is
+          ``projects/{project}/subscriptions/{sub}``.
+      labels:
+          See Creating and managing labels.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.CreateSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSnapshotRequest)
+_sym_db.RegisterMessage(CreateSnapshotRequest.LabelsEntry)
+
+UpdateSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSnapshotRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESNAPSHOTREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the UpdateSnapshot method.
+  
+  
+  Attributes:
+      snapshot:
+          The updated snapshot object.
+      update_mask:
+          Indicates which fields in the provided snapshot to update.
+          Must be specified and non-empty.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.UpdateSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSnapshotRequest)
+
+Snapshot = _reflection.GeneratedProtocolMessageType(
+    "Snapshot",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SNAPSHOT_LABELSENTRY,
+                __module__="google.cloud.pubsub_v1.proto.pubsub_pb2"
+                # @@protoc_insertion_point(class_scope:google.pubsub.v1.Snapshot.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_SNAPSHOT,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""A snapshot resource. Snapshots are used in Seek operations, which allow
+  you to manage message acknowledgments in bulk. That is, you can set the
+  acknowledgment state of messages in an existing subscription to the
+  state captured by a snapshot.
+  
+  
+  Attributes:
+      name:
+          The name of the snapshot.
+      topic:
+          The name of the topic from which this snapshot is retaining
+          messages.
+      expire_time:
+          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 creation. Its exact lifetime is determined at
+          creation by the existing backlog in the source subscription.
+          Specifically, the lifetime of the snapshot is ``7 days - (age
+          of oldest unacked message in the subscription)``. For example,
+          consider a subscription whose oldest unacked message is 3 days
+          old. If a snapshot is created from this subscription, the
+          snapshot -- which will always capture this 3-day-old backlog
+          as long as the snapshot exists -- will expire in 4 days. The
+          service will refuse to create a snapshot that would expire in
+          less than 1 hour after creation.
+      labels:
+          See Creating and managing labels.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.Snapshot)
+    ),
+)
+_sym_db.RegisterMessage(Snapshot)
+_sym_db.RegisterMessage(Snapshot.LabelsEntry)
+
+GetSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSnapshotRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSNAPSHOTREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the GetSnapshot method.
+  
+  
+  Attributes:
+      snapshot:
+          The name of the snapshot to get. Format is
+          ``projects/{project}/snapshots/{snap}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.GetSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSnapshotRequest)
+
+ListSnapshotsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSnapshotsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSNAPSHOTSREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``ListSnapshots`` method.
+  
+  
+  Attributes:
+      project:
+          The name of the project in which to list snapshots. Format is
+          ``projects/{project-id}``.
+      page_size:
+          Maximum number of snapshots to return.
+      page_token:
+          The value returned by the last ``ListSnapshotsResponse``;
+          indicates that this is a continuation of a prior
+          ``ListSnapshots`` call, and that the system should return the
+          next page of data.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListSnapshotsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSnapshotsRequest)
+
+ListSnapshotsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSnapshotsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSNAPSHOTSRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``ListSnapshots`` method.
+  
+  
+  Attributes:
+      snapshots:
+          The resulting snapshots.
+      next_page_token:
+          If not empty, indicates that there may be more snapshot that
+          match the request; this value should be passed in a new
+          ``ListSnapshotsRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.ListSnapshotsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSnapshotsResponse)
+
+DeleteSnapshotRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSnapshotRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESNAPSHOTREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``DeleteSnapshot`` method.
+  
+  
+  Attributes:
+      snapshot:
+          The name of the snapshot to delete. Format is
+          ``projects/{project}/snapshots/{snap}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.DeleteSnapshotRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSnapshotRequest)
+
+SeekRequest = _reflection.GeneratedProtocolMessageType(
+    "SeekRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEEKREQUEST,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Request for the ``Seek`` method.
+  
+  
+  Attributes:
+      subscription:
+          The subscription to affect.
+      time:
+          The time to seek to. Messages retained in the subscription
+          that were published before this time are marked as
+          acknowledged, and messages retained in the subscription that
+          were published after this time are marked as unacknowledged.
+          Note that this operation affects only those messages retained
+          in the subscription (configured by the combination of
+          ``message_retention_duration`` and ``retain_acked_messages``).
+          For example, if ``time`` corresponds to a point before the
+          message retention window (or to a point before the system's
+          notion of the subscription creation time), only retained
+          messages will be marked as unacknowledged, and already-
+          expunged messages will not be restored.
+      snapshot:
+          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}``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.SeekRequest)
+    ),
+)
+_sym_db.RegisterMessage(SeekRequest)
+
+SeekResponse = _reflection.GeneratedProtocolMessageType(
+    "SeekResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEEKRESPONSE,
+        __module__="google.cloud.pubsub_v1.proto.pubsub_pb2",
+        __doc__="""Response for the ``Seek`` method (this response is empty).
+  """,
+        # @@protoc_insertion_point(class_scope:google.pubsub.v1.SeekResponse)
+    ),
+)
+_sym_db.RegisterMessage(SeekResponse)
+
+
+DESCRIPTOR._options = None
+_TOPIC_LABELSENTRY._options = None
+_PUBSUBMESSAGE_ATTRIBUTESENTRY._options = None
+_SUBSCRIPTION_LABELSENTRY._options = None
+_PUSHCONFIG_ATTRIBUTESENTRY._options = None
+_CREATESNAPSHOTREQUEST_LABELSENTRY._options = None
+_SNAPSHOT_LABELSENTRY._options = None
+
+_PUBLISHER = _descriptor.ServiceDescriptor(
+    name="Publisher",
+    full_name="google.pubsub.v1.Publisher",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\025pubsub.googleapis.com\322AUhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/pubsub"
+    ),
+    serialized_start=4589,
+    serialized_end=5790,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateTopic",
+            full_name="google.pubsub.v1.Publisher.CreateTopic",
+            index=0,
+            containing_service=None,
+            input_type=_TOPIC,
+            output_type=_TOPIC,
+            serialized_options=_b(
+                "\202\323\344\223\002#\032\036/v1/{name=projects/*/topics/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTopic",
+            full_name="google.pubsub.v1.Publisher.UpdateTopic",
+            index=1,
+            containing_service=None,
+            input_type=_UPDATETOPICREQUEST,
+            output_type=_TOPIC,
+            serialized_options=_b(
+                "\202\323\344\223\002)2$/v1/{topic.name=projects/*/topics/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Publish",
+            full_name="google.pubsub.v1.Publisher.Publish",
+            index=2,
+            containing_service=None,
+            input_type=_PUBLISHREQUEST,
+            output_type=_PUBLISHRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\"'/v1/{topic=projects/*/topics/*}:publish:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTopic",
+            full_name="google.pubsub.v1.Publisher.GetTopic",
+            index=3,
+            containing_service=None,
+            input_type=_GETTOPICREQUEST,
+            output_type=_TOPIC,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v1/{topic=projects/*/topics/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTopics",
+            full_name="google.pubsub.v1.Publisher.ListTopics",
+            index=4,
+            containing_service=None,
+            input_type=_LISTTOPICSREQUEST,
+            output_type=_LISTTOPICSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002!\022\037/v1/{project=projects/*}/topics"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTopicSubscriptions",
+            full_name="google.pubsub.v1.Publisher.ListTopicSubscriptions",
+            index=5,
+            containing_service=None,
+            input_type=_LISTTOPICSUBSCRIPTIONSREQUEST,
+            output_type=_LISTTOPICSUBSCRIPTIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1/{topic=projects/*/topics/*}/subscriptions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTopicSnapshots",
+            full_name="google.pubsub.v1.Publisher.ListTopicSnapshots",
+            index=6,
+            containing_service=None,
+            input_type=_LISTTOPICSNAPSHOTSREQUEST,
+            output_type=_LISTTOPICSNAPSHOTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1/{topic=projects/*/topics/*}/snapshots"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTopic",
+            full_name="google.pubsub.v1.Publisher.DeleteTopic",
+            index=7,
+            containing_service=None,
+            input_type=_DELETETOPICREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002!*\037/v1/{topic=projects/*/topics/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PUBLISHER)
+
+DESCRIPTOR.services_by_name["Publisher"] = _PUBLISHER
+
+
+_SUBSCRIBER = _descriptor.ServiceDescriptor(
+    name="Subscriber",
+    full_name="google.pubsub.v1.Subscriber",
+    file=DESCRIPTOR,
+    index=1,
+    serialized_options=_b(
+        "\312A\025pubsub.googleapis.com\322AUhttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/pubsub"
+    ),
+    serialized_start=5793,
+    serialized_end=8204,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateSubscription",
+            full_name="google.pubsub.v1.Subscriber.CreateSubscription",
+            index=0,
+            containing_service=None,
+            input_type=_SUBSCRIPTION,
+            output_type=_SUBSCRIPTION,
+            serialized_options=_b(
+                "\202\323\344\223\002*\032%/v1/{name=projects/*/subscriptions/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSubscription",
+            full_name="google.pubsub.v1.Subscriber.GetSubscription",
+            index=1,
+            containing_service=None,
+            input_type=_GETSUBSCRIPTIONREQUEST,
+            output_type=_SUBSCRIPTION,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1/{subscription=projects/*/subscriptions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSubscription",
+            full_name="google.pubsub.v1.Subscriber.UpdateSubscription",
+            index=2,
+            containing_service=None,
+            input_type=_UPDATESUBSCRIPTIONREQUEST,
+            output_type=_SUBSCRIPTION,
+            serialized_options=_b(
+                "\202\323\344\223\002722/v1/{subscription.name=projects/*/subscriptions/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSubscriptions",
+            full_name="google.pubsub.v1.Subscriber.ListSubscriptions",
+            index=3,
+            containing_service=None,
+            input_type=_LISTSUBSCRIPTIONSREQUEST,
+            output_type=_LISTSUBSCRIPTIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002(\022&/v1/{project=projects/*}/subscriptions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSubscription",
+            full_name="google.pubsub.v1.Subscriber.DeleteSubscription",
+            index=4,
+            containing_service=None,
+            input_type=_DELETESUBSCRIPTIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002/*-/v1/{subscription=projects/*/subscriptions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ModifyAckDeadline",
+            full_name="google.pubsub.v1.Subscriber.ModifyAckDeadline",
+            index=5,
+            containing_service=None,
+            input_type=_MODIFYACKDEADLINEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002D"?/v1/{subscription=projects/*/subscriptions/*}:modifyAckDeadline:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Acknowledge",
+            full_name="google.pubsub.v1.Subscriber.Acknowledge",
+            index=6,
+            containing_service=None,
+            input_type=_ACKNOWLEDGEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002>"9/v1/{subscription=projects/*/subscriptions/*}:acknowledge:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Pull",
+            full_name="google.pubsub.v1.Subscriber.Pull",
+            index=7,
+            containing_service=None,
+            input_type=_PULLREQUEST,
+            output_type=_PULLRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1/{subscription=projects/*/subscriptions/*}:pull:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StreamingPull",
+            full_name="google.pubsub.v1.Subscriber.StreamingPull",
+            index=8,
+            containing_service=None,
+            input_type=_STREAMINGPULLREQUEST,
+            output_type=_STREAMINGPULLRESPONSE,
+            serialized_options=None,
+        ),
+        _descriptor.MethodDescriptor(
+            name="ModifyPushConfig",
+            full_name="google.pubsub.v1.Subscriber.ModifyPushConfig",
+            index=9,
+            containing_service=None,
+            input_type=_MODIFYPUSHCONFIGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002C">/v1/{subscription=projects/*/subscriptions/*}:modifyPushConfig:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSnapshot",
+            full_name="google.pubsub.v1.Subscriber.GetSnapshot",
+            index=10,
+            containing_service=None,
+            input_type=_GETSNAPSHOTREQUEST,
+            output_type=_SNAPSHOT,
+            serialized_options=_b(
+                "\202\323\344\223\002'\022%/v1/{snapshot=projects/*/snapshots/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSnapshots",
+            full_name="google.pubsub.v1.Subscriber.ListSnapshots",
+            index=11,
+            containing_service=None,
+            input_type=_LISTSNAPSHOTSREQUEST,
+            output_type=_LISTSNAPSHOTSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002$\022"/v1/{project=projects/*}/snapshots'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateSnapshot",
+            full_name="google.pubsub.v1.Subscriber.CreateSnapshot",
+            index=12,
+            containing_service=None,
+            input_type=_CREATESNAPSHOTREQUEST,
+            output_type=_SNAPSHOT,
+            serialized_options=_b(
+                "\202\323\344\223\002&\032!/v1/{name=projects/*/snapshots/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSnapshot",
+            full_name="google.pubsub.v1.Subscriber.UpdateSnapshot",
+            index=13,
+            containing_service=None,
+            input_type=_UPDATESNAPSHOTREQUEST,
+            output_type=_SNAPSHOT,
+            serialized_options=_b(
+                "\202\323\344\223\002/2*/v1/{snapshot.name=projects/*/snapshots/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSnapshot",
+            full_name="google.pubsub.v1.Subscriber.DeleteSnapshot",
+            index=14,
+            containing_service=None,
+            input_type=_DELETESNAPSHOTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002'*%/v1/{snapshot=projects/*/snapshots/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Seek",
+            full_name="google.pubsub.v1.Subscriber.Seek",
+            index=15,
+            containing_service=None,
+            input_type=_SEEKREQUEST,
+            output_type=_SEEKRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1/{subscription=projects/*/subscriptions/*}:seek:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_SUBSCRIBER)
+
+DESCRIPTOR.services_by_name["Subscriber"] = _SUBSCRIBER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/pubsub/google/cloud/pubsub_v1/proto/pubsub_pb2_grpc.py b/pubsub/google/cloud/pubsub_v1/proto/pubsub_pb2_grpc.py
new file mode 100644
index 000000000000..dd1a365877e1
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/proto/pubsub_pb2_grpc.py
@@ -0,0 +1,573 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.pubsub_v1.proto import (
+    pubsub_pb2 as google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class PublisherStub(object):
+    """The service that an application uses to manipulate topics, and to send
+  messages to a topic.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateTopic = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/CreateTopic",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.FromString,
+        )
+        self.UpdateTopic = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/UpdateTopic",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.UpdateTopicRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.FromString,
+        )
+        self.Publish = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/Publish",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PublishRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PublishResponse.FromString,
+        )
+        self.GetTopic = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/GetTopic",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.GetTopicRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.FromString,
+        )
+        self.ListTopics = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/ListTopics",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicsResponse.FromString,
+        )
+        self.ListTopicSubscriptions = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/ListTopicSubscriptions",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSubscriptionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSubscriptionsResponse.FromString,
+        )
+        self.ListTopicSnapshots = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/ListTopicSnapshots",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSnapshotsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSnapshotsResponse.FromString,
+        )
+        self.DeleteTopic = channel.unary_unary(
+            "/google.pubsub.v1.Publisher/DeleteTopic",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.DeleteTopicRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class PublisherServicer(object):
+    """The service that an application uses to manipulate topics, and to send
+  messages to a topic.
+  """
+
+    def CreateTopic(self, request, context):
+        """Creates the given topic with the given name. See the
+    <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+    resource name rules</a>.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTopic(self, request, context):
+        """Updates an existing topic. Note that certain properties of a
+    topic are not modifiable.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Publish(self, request, context):
+        """Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
+    does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTopic(self, request, context):
+        """Gets the configuration of a topic.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTopics(self, request, context):
+        """Lists matching topics.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTopicSubscriptions(self, request, context):
+        """Lists the names of the subscriptions on this topic.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTopicSnapshots(self, request, context):
+        """Lists the names of the snapshots on this topic. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow
+    you to manage message acknowledgments in bulk. That is, you can set the
+    acknowledgment state of messages in an existing subscription to the state
+    captured by a snapshot.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTopic(self, request, context):
+        """Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
+    does not exist. After a topic is deleted, a new topic may be created with
+    the same name; this is an entirely new topic with none of the old
+    configuration or subscriptions. Existing subscriptions to this topic are
+    not deleted, but their `topic` field is set to `_deleted-topic_`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_PublisherServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateTopic": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTopic,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.SerializeToString,
+        ),
+        "UpdateTopic": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTopic,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.UpdateTopicRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.SerializeToString,
+        ),
+        "Publish": grpc.unary_unary_rpc_method_handler(
+            servicer.Publish,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PublishRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PublishResponse.SerializeToString,
+        ),
+        "GetTopic": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTopic,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.GetTopicRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Topic.SerializeToString,
+        ),
+        "ListTopics": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTopics,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicsResponse.SerializeToString,
+        ),
+        "ListTopicSubscriptions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTopicSubscriptions,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSubscriptionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSubscriptionsResponse.SerializeToString,
+        ),
+        "ListTopicSnapshots": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTopicSnapshots,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSnapshotsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListTopicSnapshotsResponse.SerializeToString,
+        ),
+        "DeleteTopic": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTopic,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.DeleteTopicRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.pubsub.v1.Publisher", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
+
+
+class SubscriberStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateSubscription = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/CreateSubscription",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.FromString,
+        )
+        self.GetSubscription = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/GetSubscription",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.GetSubscriptionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.FromString,
+        )
+        self.UpdateSubscription = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/UpdateSubscription",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.UpdateSubscriptionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.FromString,
+        )
+        self.ListSubscriptions = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/ListSubscriptions",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSubscriptionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSubscriptionsResponse.FromString,
+        )
+        self.DeleteSubscription = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/DeleteSubscription",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.DeleteSubscriptionRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ModifyAckDeadline = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/ModifyAckDeadline",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ModifyAckDeadlineRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.Acknowledge = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/Acknowledge",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.AcknowledgeRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.Pull = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/Pull",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PullRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PullResponse.FromString,
+        )
+        self.StreamingPull = channel.stream_stream(
+            "/google.pubsub.v1.Subscriber/StreamingPull",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.StreamingPullRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.StreamingPullResponse.FromString,
+        )
+        self.ModifyPushConfig = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/ModifyPushConfig",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ModifyPushConfigRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetSnapshot = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/GetSnapshot",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.GetSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Snapshot.FromString,
+        )
+        self.ListSnapshots = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/ListSnapshots",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSnapshotsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSnapshotsResponse.FromString,
+        )
+        self.CreateSnapshot = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/CreateSnapshot",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.CreateSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Snapshot.FromString,
+        )
+        self.UpdateSnapshot = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/UpdateSnapshot",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.UpdateSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Snapshot.FromString,
+        )
+        self.DeleteSnapshot = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/DeleteSnapshot",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.DeleteSnapshotRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.Seek = channel.unary_unary(
+            "/google.pubsub.v1.Subscriber/Seek",
+            request_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.SeekRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.SeekResponse.FromString,
+        )
+
+
+class SubscriberServicer(object):
+    """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.
+  """
+
+    def CreateSubscription(self, request, context):
+        """Creates a subscription to a given topic. See the
+    <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
+    resource name rules</a>.
+    If the subscription already exists, returns `ALREADY_EXISTS`.
+    If the corresponding topic doesn't exist, returns `NOT_FOUND`.
+
+    If the name is not provided in the request, the server will assign a random
+    name for this subscription on the same project as the topic, conforming
+    to the
+    [resource name
+    format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+    generated name is populated in the returned Subscription object. Note that
+    for REST API requests, you must specify a name in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSubscription(self, request, context):
+        """Gets the configuration details of a subscription.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSubscription(self, request, context):
+        """Updates an existing subscription. Note that certain properties of a
+    subscription, such as its topic, are not modifiable.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSubscriptions(self, request, context):
+        """Lists matching subscriptions.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSubscription(self, request, context):
+        """Deletes an existing subscription. All messages retained in the subscription
+    are immediately dropped. Calls to `Pull` after deletion will return
+    `NOT_FOUND`. After a subscription is deleted, a new one may be created with
+    the same name, but the new one has no association with the old
+    subscription or its topic unless the same topic is specified.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ModifyAckDeadline(self, request, context):
+        """Modifies the ack deadline for a specific message. This method is useful
+    to indicate that more time is needed to process a message by the
+    subscriber, or to make the message available for redelivery if the
+    processing was interrupted. Note that this does not modify the
+    subscription-level `ackDeadlineSeconds` used for subsequent messages.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Acknowledge(self, request, context):
+        """Acknowledges the messages associated with the `ack_ids` in the
+    `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
+    from the subscription.
+
+    Acknowledging a message whose ack deadline has expired may succeed,
+    but such a message may be redelivered later. Acknowledging a message more
+    than once will not result in an error.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Pull(self, request, context):
+        """Pulls messages from the server. The server may return `UNAVAILABLE` if
+    there are too many concurrent pull requests pending for the given
+    subscription.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StreamingPull(self, request_iterator, context):
+        """Establishes a stream with the server, which sends messages down to the
+    client. The client streams acknowledgements and ack deadline modifications
+    back to the server. The server will close the stream and return the status
+    on any error. The server may close the stream with status `UNAVAILABLE` to
+    reassign server-side resources, in which case, the client should
+    re-establish the stream. Flow control can be achieved by configuring the
+    underlying RPC channel.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ModifyPushConfig(self, request, context):
+        """Modifies the `PushConfig` for a specified subscription.
+
+    This may be used to change a push subscription to a pull one (signified by
+    an empty `PushConfig`) or vice versa, or change the endpoint URL and other
+    attributes of a push subscription. Messages will accumulate for delivery
+    continuously through the call regardless of changes to the `PushConfig`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSnapshot(self, request, context):
+        """Gets the configuration details of a snapshot. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow you to manage message acknowledgments in bulk. That
+    is, you can set the acknowledgment state of messages in an existing
+    subscription to the state captured by a snapshot.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSnapshots(self, request, context):
+        """Lists the existing snapshots. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow
+    you to manage message acknowledgments in bulk. That is, you can set the
+    acknowledgment state of messages in an existing subscription to the state
+    captured by a snapshot.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateSnapshot(self, request, context):
+        """Creates a snapshot from the requested subscription. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow
+    you to manage message acknowledgments in bulk. That is, you can set the
+    acknowledgment state of messages in an existing subscription to the state
+    captured by a snapshot.
+    <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+    If the requested subscription doesn't exist, returns `NOT_FOUND`.
+    If the backlog in the subscription is too old -- and the resulting snapshot
+    would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
+    See also the `Snapshot.expire_time` field. 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, conforming
+    to the
+    [resource name
+    format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+    generated name is populated in the returned Snapshot object. Note that for
+    REST API requests, you must specify a name in the request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSnapshot(self, request, context):
+        """Updates an existing snapshot. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow
+    you to manage message acknowledgments in bulk. That is, you can set the
+    acknowledgment state of messages in an existing subscription to the state
+    captured by a snapshot.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSnapshot(self, request, context):
+        """Removes an existing snapshot. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow
+    you to manage message acknowledgments in bulk. That is, you can set the
+    acknowledgment state of messages in an existing subscription to the state
+    captured by a snapshot.<br><br>
+    When the snapshot is deleted, all messages retained in the snapshot
+    are immediately dropped. After a snapshot is deleted, a new one may be
+    created with the same name, but the new one has no association with the old
+    snapshot or its subscription, unless the same subscription is specified.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Seek(self, request, context):
+        """Seeks an existing subscription to a point in time or to a given snapshot,
+    whichever is provided in the request. Snapshots are used in
+    <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+    operations, which allow
+    you to manage message acknowledgments in bulk. That is, you can set the
+    acknowledgment state of messages in an existing subscription to the state
+    captured by a snapshot. Note that both the subscription and the snapshot
+    must be on the same topic.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SubscriberServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSubscription,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.SerializeToString,
+        ),
+        "GetSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSubscription,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.GetSubscriptionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.SerializeToString,
+        ),
+        "UpdateSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSubscription,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.UpdateSubscriptionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Subscription.SerializeToString,
+        ),
+        "ListSubscriptions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSubscriptions,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSubscriptionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSubscriptionsResponse.SerializeToString,
+        ),
+        "DeleteSubscription": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSubscription,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.DeleteSubscriptionRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ModifyAckDeadline": grpc.unary_unary_rpc_method_handler(
+            servicer.ModifyAckDeadline,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ModifyAckDeadlineRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "Acknowledge": grpc.unary_unary_rpc_method_handler(
+            servicer.Acknowledge,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.AcknowledgeRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "Pull": grpc.unary_unary_rpc_method_handler(
+            servicer.Pull,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PullRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.PullResponse.SerializeToString,
+        ),
+        "StreamingPull": grpc.stream_stream_rpc_method_handler(
+            servicer.StreamingPull,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.StreamingPullRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.StreamingPullResponse.SerializeToString,
+        ),
+        "ModifyPushConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.ModifyPushConfig,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ModifyPushConfigRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSnapshot,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.GetSnapshotRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Snapshot.SerializeToString,
+        ),
+        "ListSnapshots": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSnapshots,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSnapshotsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.ListSnapshotsResponse.SerializeToString,
+        ),
+        "CreateSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSnapshot,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.CreateSnapshotRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Snapshot.SerializeToString,
+        ),
+        "UpdateSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSnapshot,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.UpdateSnapshotRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.Snapshot.SerializeToString,
+        ),
+        "DeleteSnapshot": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSnapshot,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.DeleteSnapshotRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "Seek": grpc.unary_unary_rpc_method_handler(
+            servicer.Seek,
+            request_deserializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.SeekRequest.FromString,
+            response_serializer=google_dot_cloud_dot_pubsub__v1_dot_proto_dot_pubsub__pb2.SeekResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.pubsub.v1.Subscriber", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/__init__.py b/pubsub/google/cloud/pubsub_v1/publisher/__init__.py
new file mode 100644
index 000000000000..688ee744b7b4
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/publisher/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.pubsub_v1.publisher.client import Client
+
+
+__all__ = ("Client",)
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/_batch/__init__.py b/pubsub/google/cloud/pubsub_v1/publisher/_batch/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/_batch/base.py b/pubsub/google/cloud/pubsub_v1/publisher/_batch/base.py
new file mode 100644
index 000000000000..4dc6ceec6a80
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/publisher/_batch/base.py
@@ -0,0 +1,166 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import abc
+
+import six
+
+
+@six.add_metaclass(abc.ABCMeta)
+class Batch(object):
+    """The base batching class for Pub/Sub publishing.
+
+    Although the :class:`~.pubsub_v1.publisher.batch.thread.Batch` class, based
+    on :class:`threading.Thread`, is fine for most cases, advanced
+    users may need to implement something based on a different concurrency
+    model.
+
+    This class defines the interface for the Batch implementation;
+    subclasses may be passed as the ``batch_class`` argument to
+    :class:`~.pubsub_v1.client.PublisherClient`.
+
+    The batching behavior works like this: When the
+    :class:`~.pubsub_v1.publisher.client.Client` is asked to publish a new
+    message, it requires a batch. The client will see if there is an
+    already-opened batch for the given topic; if there is, then the message
+    is sent to that batch. If there is not, then a new batch is created
+    and the message put there.
+
+    When a new batch is created, it automatically starts a timer counting
+    down to the maximum latency before the batch should commit.
+    Essentially, if enough time passes, the batch automatically commits
+    regardless of how much is in it. However, if either the message count or
+    size thresholds are encountered first, then the batch will commit early.
+    """
+
+    def __len__(self):
+        """Return the number of messages currently in the batch."""
+        return len(self.messages)
+
+    @staticmethod
+    @abc.abstractmethod
+    def make_lock():
+        """Return a lock in the chosen concurrency model.
+
+        Returns:
+            ContextManager: A newly created lock.
+        """
+        raise NotImplementedError
+
+    @property
+    @abc.abstractmethod
+    def messages(self):
+        """Return the messages currently in the batch.
+
+        Returns:
+            Sequence: The messages currently in the batch.
+        """
+        raise NotImplementedError
+
+    @property
+    @abc.abstractmethod
+    def size(self):
+        """Return the total size of all of the messages currently in the batch.
+
+        Returns:
+            int: The total size of all of the messages currently
+                 in the batch, in bytes.
+        """
+        raise NotImplementedError
+
+    @property
+    @abc.abstractmethod
+    def settings(self):
+        """Return the batch settings.
+
+        Returns:
+            ~.pubsub_v1.types.BatchSettings: The batch settings. These are
+                considered immutable once the batch has been opened.
+        """
+        raise NotImplementedError
+
+    @property
+    @abc.abstractmethod
+    def status(self):
+        """Return the status of this batch.
+
+        Returns:
+            str: The status of this batch. All statuses are human-readable,
+                all-lowercase strings. The ones represented in the
+                :class:`BaseBatch.Status` enum are special, but other statuses
+                are permitted.
+        """
+        raise NotImplementedError
+
+    def will_accept(self, message):
+        """Return True if the batch is able to accept the message.
+
+        In concurrent implementations, the attributes on the current batch
+        may be modified by other workers. With this in mind, the caller will
+        likely want to hold a lock that will make sure the state remains
+        the same after the "will accept?" question is answered.
+
+        Args:
+            message (~.pubsub_v1.types.PubsubMessage): The Pub/Sub message.
+
+        Returns:
+            bool: Whether this batch can accept the message.
+        """
+        # If this batch is not accepting messages generally, return False.
+        if self.status != BatchStatus.ACCEPTING_MESSAGES:
+            return False
+
+        # If this message will make the batch exceed the ``max_messages``
+        # setting, return False.
+        if len(self.messages) >= self.settings.max_messages:
+            return False
+
+        # Okay, everything is good.
+        return True
+
+    @abc.abstractmethod
+    def publish(self, message):
+        """Publish a single message.
+
+        Add the given message to this object; this will cause it to be
+        published once the batch either has enough messages or a sufficient
+        period of time has elapsed.
+
+        This method is called by :meth:`~.PublisherClient.publish`.
+
+        Args:
+            message (~.pubsub_v1.types.PubsubMessage): The Pub/Sub message.
+
+        Returns:
+            ~google.api_core.future.Future: An object conforming to the
+                :class:`concurrent.futures.Future` interface.
+        """
+        raise NotImplementedError
+
+
+class BatchStatus(object):
+    """An enum-like class representing valid statuses for a batch.
+
+    It is acceptable for a class to use a status that is not on this
+    class; this represents the list of statuses where the existing
+    library hooks in functionality.
+    """
+
+    ACCEPTING_MESSAGES = "accepting messages"
+    STARTING = "starting"
+    IN_PROGRESS = "in progress"
+    ERROR = "error"
+    SUCCESS = "success"
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/_batch/thread.py b/pubsub/google/cloud/pubsub_v1/publisher/_batch/thread.py
new file mode 100644
index 000000000000..117ee12b8463
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/publisher/_batch/thread.py
@@ -0,0 +1,315 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import logging
+import threading
+import time
+
+import six
+
+import google.api_core.exceptions
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.publisher import exceptions
+from google.cloud.pubsub_v1.publisher import futures
+from google.cloud.pubsub_v1.publisher._batch import base
+
+
+_LOGGER = logging.getLogger(__name__)
+_CAN_COMMIT = (base.BatchStatus.ACCEPTING_MESSAGES, base.BatchStatus.STARTING)
+
+
+class Batch(base.Batch):
+    """A batch of messages.
+
+    The batch is the internal group of messages which are either awaiting
+    publication or currently in progress.
+
+    A batch is automatically created by the PublisherClient when the first
+    message to be published is received; subsequent messages are added to
+    that batch until the process of actual publishing _starts_.
+
+    Once this occurs, any new messages sent to :meth:`publish` open a new
+    batch.
+
+    If you are using this library, you most likely do not need to instantiate
+    batch objects directly; they will be created for you. If you want to
+    change the actual batching settings, see the ``batching`` argument on
+    :class:`~.pubsub_v1.PublisherClient`.
+
+    Any properties or methods on this class which are not defined in
+    :class:`~.pubsub_v1.publisher.batch.BaseBatch` should be considered
+    implementation details.
+
+    Args:
+        client (~.pubsub_v1.PublisherClient): The publisher client used to
+            create this batch.
+        topic (str): The topic. The format for this is
+            ``projects/{project}/topics/{topic}``.
+        settings (~.pubsub_v1.types.BatchSettings): The settings for batch
+            publishing. These should be considered immutable once the batch
+            has been opened.
+        autocommit (bool): Whether to autocommit the batch when the time
+            has elapsed. Defaults to True unless ``settings.max_latency`` is
+            inf.
+    """
+
+    def __init__(self, client, topic, settings, autocommit=True):
+        self._client = client
+        self._topic = topic
+        self._settings = settings
+
+        self._state_lock = threading.Lock()
+        # These members are all communicated between threads; ensure that
+        # any writes to them use the "state lock" to remain atomic.
+        self._futures = []
+        self._messages = []
+        self._size = 0
+        self._status = base.BatchStatus.ACCEPTING_MESSAGES
+
+        # If max latency is specified, start a thread to monitor the batch and
+        # commit when the max latency is reached.
+        self._thread = None
+        if autocommit and self._settings.max_latency < float("inf"):
+            self._thread = threading.Thread(
+                name="Thread-MonitorBatchPublisher", target=self.monitor
+            )
+            self._thread.start()
+
+    @staticmethod
+    def make_lock():
+        """Return a threading lock.
+
+        Returns:
+            _thread.Lock: A newly created lock.
+        """
+        return threading.Lock()
+
+    @property
+    def client(self):
+        """~.pubsub_v1.client.PublisherClient: A publisher client."""
+        return self._client
+
+    @property
+    def messages(self):
+        """Sequence: The messages currently in the batch."""
+        return self._messages
+
+    @property
+    def settings(self):
+        """Return the batch settings.
+
+        Returns:
+            ~.pubsub_v1.types.BatchSettings: The batch settings. These are
+                considered immutable once the batch has been opened.
+        """
+        return self._settings
+
+    @property
+    def size(self):
+        """Return the total size of all of the messages currently in the batch.
+
+        Returns:
+            int: The total size of all of the messages currently
+                 in the batch, in bytes.
+        """
+        return self._size
+
+    @property
+    def status(self):
+        """Return the status of this batch.
+
+        Returns:
+            str: The status of this batch. All statuses are human-readable,
+                all-lowercase strings.
+        """
+        return self._status
+
+    def commit(self):
+        """Actually publish all of the messages on the active batch.
+
+        .. note::
+
+            This method is non-blocking. It opens a new thread, which calls
+            :meth:`_commit`, which does block.
+
+        This synchronously sets the batch status to "starting", and then opens
+        a new thread, which handles actually sending the messages to Pub/Sub.
+
+        If the current batch is **not** accepting messages, this method
+        does nothing.
+        """
+        # Set the status to "starting" synchronously, to ensure that
+        # this batch will necessarily not accept new messages.
+        with self._state_lock:
+            if self._status == base.BatchStatus.ACCEPTING_MESSAGES:
+                self._status = base.BatchStatus.STARTING
+            else:
+                return
+
+        # Start a new thread to actually handle the commit.
+        commit_thread = threading.Thread(
+            name="Thread-CommitBatchPublisher", target=self._commit
+        )
+        commit_thread.start()
+
+    def _commit(self):
+        """Actually publish all of the messages on the active batch.
+
+        This moves the batch out from being the active batch to an in progress
+        batch on the publisher, and then the batch is discarded upon
+        completion.
+
+        .. note::
+
+            This method blocks. The :meth:`commit` method is the non-blocking
+            version, which calls this one.
+        """
+        with self._state_lock:
+            if self._status in _CAN_COMMIT:
+                self._status = base.BatchStatus.IN_PROGRESS
+            else:
+                # If, in the intervening period between when this method was
+                # called and now, the batch started to be committed, or
+                # completed a commit, then no-op at this point.
+                _LOGGER.debug("Batch is already in progress, exiting commit")
+                return
+
+        # Once in the IN_PROGRESS state, no other thread can publish additional
+        # messages or initiate a commit (those operations become a no-op), thus
+        # it is safe to release the state lock here. Releasing the lock avoids
+        # blocking other threads in case api.publish() below takes a long time
+        # to complete.
+        # https://github.com/googleapis/google-cloud-python/issues/8036
+
+        # Sanity check: If there are no messages, no-op.
+        if not self._messages:
+            _LOGGER.debug("No messages to publish, exiting commit")
+            self._status = base.BatchStatus.SUCCESS
+            return
+
+        # Begin the request to publish these messages.
+        # Log how long the underlying request takes.
+        start = time.time()
+
+        try:
+            response = self._client.api.publish(self._topic, self._messages)
+        except google.api_core.exceptions.GoogleAPIError as exc:
+            # We failed to publish, set the exception on all futures and
+            # exit.
+            self._status = base.BatchStatus.ERROR
+
+            for future in self._futures:
+                future.set_exception(exc)
+
+            _LOGGER.exception("Failed to publish %s messages.", len(self._futures))
+            return
+
+        end = time.time()
+        _LOGGER.debug("gRPC Publish took %s seconds.", end - start)
+
+        if len(response.message_ids) == len(self._futures):
+            # Iterate over the futures on the queue and return the response
+            # IDs. We are trusting that there is a 1:1 mapping, and raise
+            # an exception if not.
+            self._status = base.BatchStatus.SUCCESS
+            zip_iter = six.moves.zip(response.message_ids, self._futures)
+            for message_id, future in zip_iter:
+                future.set_result(message_id)
+        else:
+            # Sanity check: If the number of message IDs is not equal to
+            # the number of futures I have, then something went wrong.
+            self._status = base.BatchStatus.ERROR
+            exception = exceptions.PublishError(
+                "Some messages were not successfully published."
+            )
+
+            for future in self._futures:
+                future.set_exception(exception)
+
+            _LOGGER.error(
+                "Only %s of %s messages were published.",
+                len(response.message_ids),
+                len(self._futures),
+            )
+
+    def monitor(self):
+        """Commit this batch after sufficient time has elapsed.
+
+        This simply sleeps for ``self._settings.max_latency`` seconds,
+        and then calls commit unless the batch has already been committed.
+        """
+        # NOTE: This blocks; it is up to the calling code to call it
+        #       in a separate thread.
+
+        # Sleep for however long we should be waiting.
+        time.sleep(self._settings.max_latency)
+
+        _LOGGER.debug("Monitor is waking up")
+        return self._commit()
+
+    def publish(self, message):
+        """Publish a single message.
+
+        Add the given message to this object; this will cause it to be
+        published once the batch either has enough messages or a sufficient
+        period of time has elapsed. If the batch is full or the commit is
+        already in progress, the method does not do anything.
+
+        This method is called by :meth:`~.PublisherClient.publish`.
+
+        Args:
+            message (~.pubsub_v1.types.PubsubMessage): The Pub/Sub message.
+
+        Returns:
+            Optional[~google.api_core.future.Future]: An object conforming to
+            the :class:`~concurrent.futures.Future` interface or :data:`None`.
+            If :data:`None` is returned, that signals that the batch cannot
+            accept a message.
+        """
+        # Coerce the type, just in case.
+        if not isinstance(message, types.PubsubMessage):
+            message = types.PubsubMessage(**message)
+
+        future = None
+
+        with self._state_lock:
+            if not self.will_accept(message):
+                return future
+
+            new_size = self._size + message.ByteSize()
+            new_count = len(self._messages) + 1
+            overflow = (
+                new_size > self.settings.max_bytes
+                or new_count >= self._settings.max_messages
+            )
+
+            if not self._messages or not overflow:
+
+                # Store the actual message in the batch's message queue.
+                self._messages.append(message)
+                self._size = new_size
+
+                # Track the future on this batch (so that the result of the
+                # future can be set).
+                future = futures.Future(completed=threading.Event())
+                self._futures.append(future)
+
+        # Try to commit, but it must be **without** the lock held, since
+        # ``commit()`` will try to obtain the lock.
+        if overflow:
+            self.commit()
+
+        return future
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/client.py b/pubsub/google/cloud/pubsub_v1/publisher/client.py
new file mode 100644
index 000000000000..05a4161e889a
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/publisher/client.py
@@ -0,0 +1,276 @@
+# Copyright 2019, Google LLC 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.
+
+from __future__ import absolute_import
+
+import copy
+import os
+import pkg_resources
+
+import grpc
+import six
+
+from google.api_core import grpc_helpers
+from google.oauth2 import service_account
+
+from google.cloud.pubsub_v1 import _gapic
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.gapic import publisher_client
+from google.cloud.pubsub_v1.gapic.transports import publisher_grpc_transport
+from google.cloud.pubsub_v1.publisher._batch import thread
+
+
+__version__ = pkg_resources.get_distribution("google-cloud-pubsub").version
+
+_BLACKLISTED_METHODS = (
+    "publish",
+    "from_service_account_file",
+    "from_service_account_json",
+)
+
+
+@_gapic.add_methods(publisher_client.PublisherClient, blacklist=_BLACKLISTED_METHODS)
+class Client(object):
+    """A publisher client for Google Cloud Pub/Sub.
+
+    This creates an object that is capable of publishing messages.
+    Generally, you can instantiate this client with no arguments, and you
+    get sensible defaults.
+
+    Args:
+        batch_settings (~google.cloud.pubsub_v1.types.BatchSettings): The
+            settings for batch publishing.
+        kwargs (dict): Any additional arguments provided are sent as keyword
+            arguments to the underlying
+            :class:`~google.cloud.pubsub_v1.gapic.publisher_client.PublisherClient`.
+            Generally you should not need to set additional keyword
+            arguments. Optionally, publish retry settings can be set via
+            ``client_config`` where user-provided retry configurations are
+            applied to default retry settings. And regional endpoints can be
+            set via ``client_options`` that takes a single key-value pair that
+            defines the endpoint.
+
+    Example:
+
+    .. code-block:: python
+
+        from google.cloud import pubsub_v1
+
+        publisher_client = pubsub_v1.PublisherClient(
+            # Optional
+            batch_settings = pubsub_v1.types.BatchSettings(
+                max_bytes=1024,  # One kilobyte
+                max_latency=1,   # One second
+            ),
+
+            # Optional
+            client_config = {
+                "interfaces": {
+                    "google.pubsub.v1.Publisher": {
+                        "retry_params": {
+                            "messaging": {
+                                'total_timeout_millis': 650000,  # default: 600000
+                            }
+                        }
+                    }
+                }
+            },
+
+            # Optional
+            client_options = {
+                "api_endpoint": REGIONAL_ENDPOINT
+            }
+        )
+    """
+
+    _batch_class = thread.Batch
+
+    def __init__(self, batch_settings=(), **kwargs):
+        # Sanity check: Is our goal to use the emulator?
+        # If so, create a grpc insecure channel with the emulator host
+        # as the target.
+        if os.environ.get("PUBSUB_EMULATOR_HOST"):
+            kwargs["channel"] = grpc.insecure_channel(
+                target=os.environ.get("PUBSUB_EMULATOR_HOST")
+            )
+
+        # Use a custom channel.
+        # We need this in order to set appropriate default message size and
+        # keepalive options.
+        if "transport" not in kwargs:
+            channel = kwargs.pop("channel", None)
+            if channel is None:
+                channel = grpc_helpers.create_channel(
+                    credentials=kwargs.pop("credentials", None),
+                    target=self.target,
+                    scopes=publisher_client.PublisherClient._DEFAULT_SCOPES,
+                    options={
+                        "grpc.max_send_message_length": -1,
+                        "grpc.max_receive_message_length": -1,
+                    }.items(),
+                )
+            # cannot pass both 'channel' and 'credentials'
+            kwargs.pop("credentials", None)
+            transport = publisher_grpc_transport.PublisherGrpcTransport(channel=channel)
+            kwargs["transport"] = transport
+
+        # Add the metrics headers, and instantiate the underlying GAPIC
+        # client.
+        self.api = publisher_client.PublisherClient(**kwargs)
+        self.batch_settings = types.BatchSettings(*batch_settings)
+
+        # The batches on the publisher client are responsible for holding
+        # messages. One batch exists for each topic.
+        self._batch_lock = self._batch_class.make_lock()
+        self._batches = {}
+
+    @classmethod
+    def from_service_account_file(cls, filename, batch_settings=(), **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            batch_settings (~google.cloud.pubsub_v1.types.BatchSettings): The
+                settings for batch publishing.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            A Publisher :class:`~google.cloud.pubsub_v1.publisher.client.Client`
+            instance that is the constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(batch_settings, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @property
+    def target(self):
+        """Return the target (where the API is).
+
+        Returns:
+            str: The location of the API.
+        """
+        return publisher_client.PublisherClient.SERVICE_ADDRESS
+
+    def _batch(self, topic, create=False, autocommit=True):
+        """Return the current batch for the provided topic.
+
+        This will create a new batch if ``create=True`` or if no batch
+        currently exists.
+
+        Args:
+            topic (str): A string representing the topic.
+            create (bool): Whether to create a new batch. Defaults to
+                :data:`False`. If :data:`True`, this will create a new batch
+                even if one already exists.
+            autocommit (bool): Whether to autocommit this batch. This is
+                primarily useful for debugging and testing, since it allows
+                the caller to avoid some side effects that batch creation
+                might have (e.g. spawning a worker to publish a batch).
+
+        Returns:
+            ~.pubsub_v1._batch.Batch: The batch object.
+        """
+        # If there is no matching batch yet, then potentially create one
+        # and place it on the batches dictionary.
+        with self._batch_lock:
+            if not create:
+                batch = self._batches.get(topic)
+                if batch is None:
+                    create = True
+
+            if create:
+                batch = self._batch_class(
+                    autocommit=autocommit,
+                    client=self,
+                    settings=self.batch_settings,
+                    topic=topic,
+                )
+                self._batches[topic] = batch
+
+        return batch
+
+    def publish(self, topic, data, **attrs):
+        """Publish a single message.
+
+        .. note::
+            Messages in Pub/Sub are blobs of bytes. They are *binary* data,
+            not text. You must send data as a bytestring
+            (``bytes`` in Python 3; ``str`` in Python 2), and this library
+            will raise an exception if you send a text string.
+
+            The reason that this is so important (and why we do not try to
+            coerce for you) is because Pub/Sub is also platform independent
+            and there is no way to know how to decode messages properly on
+            the other side; therefore, encoding and decoding is a required
+            exercise for the developer.
+
+        Add the given message to this object; this will cause it to be
+        published once the batch either has enough messages or a sufficient
+        period of time has elapsed.
+
+        Example:
+            >>> from google.cloud import pubsub_v1
+            >>> client = pubsub_v1.PublisherClient()
+            >>> topic = client.topic_path('[PROJECT]', '[TOPIC]')
+            >>> data = b'The rain in Wales falls mainly on the snails.'
+            >>> response = client.publish(topic, data, username='guido')
+
+        Args:
+            topic (str): The topic to publish messages to.
+            data (bytes): A bytestring representing the message body. This
+                must be a bytestring.
+            attrs (Mapping[str, str]): A dictionary of attributes to be
+                sent as metadata. (These may be text strings or byte strings.)
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.publisher.futures.Future`
+            instance that conforms to Python Standard library's
+            :class:`~concurrent.futures.Future` interface (but not an
+            instance of that class).
+        """
+        # Sanity check: Is the data being sent as a bytestring?
+        # If it is literally anything else, complain loudly about it.
+        if not isinstance(data, six.binary_type):
+            raise TypeError(
+                "Data being published to Pub/Sub must be sent " "as a bytestring."
+            )
+
+        # Coerce all attributes to text strings.
+        for k, v in copy.copy(attrs).items():
+            if isinstance(v, six.text_type):
+                continue
+            if isinstance(v, six.binary_type):
+                attrs[k] = v.decode("utf-8")
+                continue
+            raise TypeError(
+                "All attributes being published to Pub/Sub must "
+                "be sent as text strings."
+            )
+
+        # Create the Pub/Sub message object.
+        message = types.PubsubMessage(data=data, attributes=attrs)
+
+        # Delegate the publishing to the batch.
+        batch = self._batch(topic)
+        future = None
+        while future is None:
+            future = batch.publish(message)
+            if future is None:
+                batch = self._batch(topic, create=True)
+
+        return future
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/exceptions.py b/pubsub/google/cloud/pubsub_v1/publisher/exceptions.py
new file mode 100644
index 000000000000..adbfaaaa1ee1
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/publisher/exceptions.py
@@ -0,0 +1,25 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.api_core.exceptions import GoogleAPICallError
+from google.cloud.pubsub_v1.exceptions import TimeoutError
+
+
+class PublishError(GoogleAPICallError):
+    pass
+
+
+__all__ = ("PublishError", "TimeoutError")
diff --git a/pubsub/google/cloud/pubsub_v1/publisher/futures.py b/pubsub/google/cloud/pubsub_v1/publisher/futures.py
new file mode 100644
index 000000000000..ed200041177b
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/publisher/futures.py
@@ -0,0 +1,52 @@
+# Copyright 2019, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.pubsub_v1 import futures
+
+
+class Future(futures.Future):
+    """This future object is returned from asychronous Pub/Sub publishing
+    calls.
+
+    Calling :meth:`result` will resolve the future by returning the message
+    ID, unless an error occurs.
+    """
+
+    def result(self, timeout=None):
+        """Return the message ID or raise an exception.
+
+        This blocks until the message has been published successfully and
+        returns the message ID unless an exception is raised.
+
+        Args:
+            timeout (Union[int, float]): The number of seconds before this call
+                times out and raises TimeoutError.
+
+        Returns:
+            str: The message ID.
+
+        Raises:
+            ~.pubsub_v1.TimeoutError: If the request times out.
+            Exception: For undefined exceptions in the underlying
+                call execution.
+        """
+        # Attempt to get the exception if there is one.
+        # If there is not one, then we know everything worked, and we can
+        # return an appropriate value.
+        err = self.exception(timeout=timeout)
+        if err is None:
+            return self._result
+        raise err
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/__init__.py b/pubsub/google/cloud/pubsub_v1/subscriber/__init__.py
new file mode 100644
index 000000000000..a444c3ea7571
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.pubsub_v1.subscriber.client import Client
+
+
+__all__ = ("Client",)
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/__init__.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/dispatcher.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/dispatcher.py
new file mode 100644
index 000000000000..2b2574829306
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/dispatcher.py
@@ -0,0 +1,170 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import collections
+import logging
+import threading
+
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.subscriber._protocol import helper_threads
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+
+
+_LOGGER = logging.getLogger(__name__)
+_CALLBACK_WORKER_NAME = "Thread-CallbackRequestDispatcher"
+
+
+_MAX_BATCH_SIZE = 100
+"""The maximum number of requests to process and dispatch at a time."""
+
+_MAX_BATCH_LATENCY = 0.01
+"""The maximum amount of time in seconds to wait for additional request items
+before processing the next batch of requests."""
+
+
+class Dispatcher(object):
+    def __init__(self, manager, queue):
+        self._manager = manager
+        self._queue = queue
+        self._thread = None
+        self._operational_lock = threading.Lock()
+
+    def start(self):
+        """Start a thread to dispatch requests queued up by callbacks.
+        Spawns a thread to run :meth:`dispatch_callback`.
+        """
+        with self._operational_lock:
+            if self._thread is not None:
+                raise ValueError("Dispatcher is already running.")
+
+            worker = helper_threads.QueueCallbackWorker(
+                self._queue,
+                self.dispatch_callback,
+                max_items=_MAX_BATCH_SIZE,
+                max_latency=_MAX_BATCH_LATENCY,
+            )
+            # Create and start the helper thread.
+            thread = threading.Thread(name=_CALLBACK_WORKER_NAME, target=worker)
+            thread.daemon = True
+            thread.start()
+            _LOGGER.debug("Started helper thread %s", thread.name)
+            self._thread = thread
+
+    def stop(self):
+        with self._operational_lock:
+            if self._thread is not None:
+                # Signal the worker to stop by queueing a "poison pill"
+                self._queue.put(helper_threads.STOP)
+                self._thread.join()
+
+            self._thread = None
+
+    def dispatch_callback(self, items):
+        """Map the callback request to the appropriate gRPC request.
+
+        Args:
+            action (str): The method to be invoked.
+            kwargs (Dict[str, Any]): The keyword arguments for the method
+                specified by ``action``.
+
+        Raises:
+            ValueError: If ``action`` isn't one of the expected actions
+                "ack", "drop", "lease", "modify_ack_deadline" or "nack".
+        """
+        if not self._manager.is_active:
+            return
+
+        batched_commands = collections.defaultdict(list)
+
+        for item in items:
+            batched_commands[item.__class__].append(item)
+
+        _LOGGER.debug("Handling %d batched requests", len(items))
+
+        if batched_commands[requests.LeaseRequest]:
+            self.lease(batched_commands.pop(requests.LeaseRequest))
+        if batched_commands[requests.ModAckRequest]:
+            self.modify_ack_deadline(batched_commands.pop(requests.ModAckRequest))
+        # Note: Drop and ack *must* be after lease. It's possible to get both
+        # the lease the and ack/drop request in the same batch.
+        if batched_commands[requests.AckRequest]:
+            self.ack(batched_commands.pop(requests.AckRequest))
+        if batched_commands[requests.NackRequest]:
+            self.nack(batched_commands.pop(requests.NackRequest))
+        if batched_commands[requests.DropRequest]:
+            self.drop(batched_commands.pop(requests.DropRequest))
+
+    def ack(self, items):
+        """Acknowledge the given messages.
+
+        Args:
+            items(Sequence[AckRequest]): The items to acknowledge.
+        """
+        # If we got timing information, add it to the histogram.
+        for item in items:
+            time_to_ack = item.time_to_ack
+            if time_to_ack is not None:
+                self._manager.ack_histogram.add(time_to_ack)
+
+        ack_ids = [item.ack_id for item in items]
+        request = types.StreamingPullRequest(ack_ids=ack_ids)
+        self._manager.send(request)
+
+        # Remove the message from lease management.
+        self.drop(items)
+
+    def drop(self, items):
+        """Remove the given messages from lease management.
+
+        Args:
+            items(Sequence[DropRequest]): The items to drop.
+        """
+        self._manager.leaser.remove(items)
+        self._manager.maybe_resume_consumer()
+
+    def lease(self, items):
+        """Add the given messages to lease management.
+
+        Args:
+            items(Sequence[LeaseRequest]): The items to lease.
+        """
+        self._manager.leaser.add(items)
+        self._manager.maybe_pause_consumer()
+
+    def modify_ack_deadline(self, items):
+        """Modify the ack deadline for the given messages.
+
+        Args:
+            items(Sequence[ModAckRequest]): The items to modify.
+        """
+        ack_ids = [item.ack_id for item in items]
+        seconds = [item.seconds for item in items]
+
+        request = types.StreamingPullRequest(
+            modify_deadline_ack_ids=ack_ids, modify_deadline_seconds=seconds
+        )
+        self._manager.send(request)
+
+    def nack(self, items):
+        """Explicitly deny receipt of messages.
+
+        Args:
+            items(Sequence[NackRequest]): The items to deny.
+        """
+        self.modify_ack_deadline(
+            [requests.ModAckRequest(ack_id=item.ack_id, seconds=0) for item in items]
+        )
+        self.drop([requests.DropRequest(*item) for item in items])
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/heartbeater.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/heartbeater.py
new file mode 100644
index 000000000000..9cd84a1e2397
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/heartbeater.py
@@ -0,0 +1,70 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import logging
+import threading
+
+
+_LOGGER = logging.getLogger(__name__)
+_HEARTBEAT_WORKER_NAME = "Thread-Heartbeater"
+# How often to send heartbeats in seconds. Determined as half the period of
+# time where the Pub/Sub server will close the stream as inactive, which is
+# 60 seconds.
+_DEFAULT_PERIOD = 30
+
+
+class Heartbeater(object):
+    def __init__(self, manager, period=_DEFAULT_PERIOD):
+        self._thread = None
+        self._operational_lock = threading.Lock()
+        self._manager = manager
+        self._stop_event = threading.Event()
+        self._period = period
+
+    def heartbeat(self):
+        """Periodically send heartbeats."""
+        while self._manager.is_active and not self._stop_event.is_set():
+            self._manager.heartbeat()
+            _LOGGER.debug("Sent heartbeat.")
+            self._stop_event.wait(timeout=self._period)
+
+        _LOGGER.info("%s exiting.", _HEARTBEAT_WORKER_NAME)
+
+    def start(self):
+        with self._operational_lock:
+            if self._thread is not None:
+                raise ValueError("Heartbeater is already running.")
+
+            # Create and start the helper thread.
+            self._stop_event.clear()
+            thread = threading.Thread(
+                name=_HEARTBEAT_WORKER_NAME, target=self.heartbeat
+            )
+            thread.daemon = True
+            thread.start()
+            _LOGGER.debug("Started helper thread %s", thread.name)
+            self._thread = thread
+
+    def stop(self):
+        with self._operational_lock:
+            self._stop_event.set()
+
+            if self._thread is not None:
+                # The thread should automatically exit when the consumer is
+                # inactive.
+                self._thread.join()
+
+            self._thread = None
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/helper_threads.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/helper_threads.py
new file mode 100644
index 000000000000..80ad58738cd1
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/helper_threads.py
@@ -0,0 +1,112 @@
+# Copyright 2017, Google LLC 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.
+
+import logging
+import time
+import uuid
+
+from six.moves import queue
+
+
+__all__ = ("QueueCallbackWorker", "STOP")
+
+_LOGGER = logging.getLogger(__name__)
+
+
+# Helper thread stop indicator. This could be a sentinel object or None,
+# but the sentinel object's ID can change if the process is forked, and
+# None has the possibility of a user accidentally killing the helper
+# thread.
+STOP = uuid.uuid4()
+
+
+def _get_many(queue_, max_items=None, max_latency=0):
+    """Get multiple items from a Queue.
+
+    Gets at least one (blocking) and at most ``max_items`` items
+    (non-blocking) from a given Queue. Does not mark the items as done.
+
+    Args:
+        queue_ (~queue.Queue`): The Queue to get items from.
+        max_items (int): The maximum number of items to get. If ``None``, then
+            all available items in the queue are returned.
+        max_latency (float):  The maximum number of seconds to wait for more
+            than one item from a queue. This number includes the time required
+            to retrieve the first item.
+
+    Returns:
+        Sequence[Any]: A sequence of items retrieved from the queue.
+    """
+    start = time.time()
+    # Always return at least one item.
+    items = [queue_.get()]
+    while max_items is None or len(items) < max_items:
+        try:
+            elapsed = time.time() - start
+            timeout = max(0, max_latency - elapsed)
+            items.append(queue_.get(timeout=timeout))
+        except queue.Empty:
+            break
+    return items
+
+
+class QueueCallbackWorker(object):
+    """A helper that executes a callback for items sent in a queue.
+
+    Calls a blocking ``get()`` on the ``queue`` until it encounters
+    :attr:`STOP`.
+
+    Args:
+        queue (~queue.Queue): A Queue instance, appropriate for crossing the
+            concurrency boundary implemented by ``executor``. Items will
+            be popped off (with a blocking ``get()``) until :attr:`STOP`
+            is encountered.
+        callback (Callable[Sequence[Any], Any]): A callback that can process
+            items pulled off of the queue. Multiple items will be passed to
+            the callback in batches.
+        max_items (int): The maximum amount of items that will be passed to the
+            callback at a time.
+        max_latency (float): The maximum amount of time in seconds to wait for
+            additional items before executing the callback.
+    """
+
+    def __init__(self, queue, callback, max_items=100, max_latency=0):
+        self.queue = queue
+        self._callback = callback
+        self.max_items = max_items
+        self.max_latency = max_latency
+
+    def __call__(self):
+        continue_ = True
+        while continue_:
+            items = _get_many(
+                self.queue, max_items=self.max_items, max_latency=self.max_latency
+            )
+
+            # If stop is in the items, process all items up to STOP and then
+            # exit.
+            try:
+                items = items[: items.index(STOP)]
+                continue_ = False
+            except ValueError:
+                pass
+
+            # Run the callback. If any exceptions occur, log them and
+            # continue.
+            try:
+                self._callback(items)
+            except Exception as exc:
+                _LOGGER.exception("Error in queue callback worker: %s", exc)
+
+        _LOGGER.debug("Exiting the QueueCallbackWorker.")
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/histogram.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/histogram.py
new file mode 100644
index 000000000000..29ee6fc61685
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/histogram.py
@@ -0,0 +1,154 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import, division
+
+
+class Histogram(object):
+    """Representation of a single histogram.
+
+    The purpose of this class is to store actual ack timing information
+    in order to predict how long to renew leases.
+
+    The default implementation uses the 99th percentile of previous ack
+    times to implicitly lease messages; however, custom
+    :class:`~.pubsub_v1.subscriber._consumer.Consumer` subclasses
+    are free to use a different formula.
+
+    The precision of data stored is to the nearest integer. Additionally,
+    values outside the range of ``10 <= x <= 600`` are stored as ``10`` or
+    ``600``, since these are the boundaries of leases in the actual API.
+    """
+
+    def __init__(self, data=None):
+        """Instantiate the histogram.
+
+        Args:
+            data (Mapping[str, int]): The data strucure to be used to store
+                the underlying data. The default is an empty dictionary.
+                This can be set to a dictionary-like object if required
+                (for example, if a special object is needed for
+                concurrency reasons).
+        """
+        # The data is stored as a dictionary, with the keys being the
+        # value being added and the values being the number of times that
+        # value was added to the dictionary.
+        #
+        # This is depending on the Python interpreter's implicit ordering
+        # of dictionaries, which is a bitwise sort by the key's ``hash()``
+        # value. Because ``hash(int i) -> i`` and all of our keys are
+        # positive integers (negatives would be a problem because the sort
+        # is bitwise), we can rely on this.
+        if data is None:
+            data = {}
+        self._data = data
+        self._len = 0
+
+    def __len__(self):
+        """Return the total number of data points in this histogram.
+
+        This is cached on a separate counter (rather than computing it using
+        ``sum([v for v in self._data.values()])``) to optimize lookup.
+
+        Returns:
+            int: The total number of data points in this histogram.
+        """
+        return self._len
+
+    def __contains__(self, needle):
+        """Return True if needle is present in the histogram, False otherwise.
+
+        Returns:
+            bool: True or False
+        """
+        return needle in self._data
+
+    def __repr__(self):
+        return "<Histogram: {len} values between {min} and {max}>".format(
+            len=len(self), max=self.max, min=self.min
+        )
+
+    @property
+    def max(self):
+        """Return the maximum value in this histogram.
+
+        If there are no values in the histogram at all, return 600.
+
+        Returns:
+            int: The maximum value in the histogram.
+        """
+        if len(self._data) == 0:
+            return 600
+        return next(iter(reversed(sorted(self._data.keys()))))
+
+    @property
+    def min(self):
+        """Return the minimum value in this histogram.
+
+        If there are no values in the histogram at all, return 10.
+
+        Returns:
+            int: The minimum value in the histogram.
+        """
+        if len(self._data) == 0:
+            return 10
+        return next(iter(sorted(self._data.keys())))
+
+    def add(self, value):
+        """Add the value to this histogram.
+
+        Args:
+            value (int): The value. Values outside of ``10 <= x <= 600``
+                will be raised to ``10`` or reduced to ``600``.
+        """
+        # If the value is out of bounds, bring it in bounds.
+        value = int(value)
+        if value < 10:
+            value = 10
+        if value > 600:
+            value = 600
+
+        # Add the value to the histogram's data dictionary.
+        self._data.setdefault(value, 0)
+        self._data[value] += 1
+        self._len += 1
+
+    def percentile(self, percent):
+        """Return the value that is the Nth precentile in the histogram.
+
+        Args:
+            percent (Union[int, float]): The precentile being sought. The
+                default consumer implementations use consistently use ``99``.
+
+        Returns:
+            int: The value corresponding to the requested percentile.
+        """
+        # Sanity check: Any value over 100 should become 100.
+        if percent >= 100:
+            percent = 100
+
+        # Determine the actual target number.
+        target = len(self) - len(self) * (percent / 100)
+
+        # Iterate over the values in reverse, dropping the target by the
+        # number of times each value has been seen. When the target passes
+        # 0, return the value we are currently viewing.
+        for k in reversed(sorted(self._data.keys())):
+            target -= self._data[k]
+            if target < 0:
+                return k
+
+        # The only way to get here is if there was no data.
+        # In this case, just return 10 seconds.
+        return 10
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/leaser.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/leaser.py
new file mode 100644
index 000000000000..8a683e4e772d
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/leaser.py
@@ -0,0 +1,193 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import collections
+import copy
+import logging
+import random
+import threading
+import time
+
+import six
+
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+
+
+_LOGGER = logging.getLogger(__name__)
+_LEASE_WORKER_NAME = "Thread-LeaseMaintainer"
+
+
+_LeasedMessage = collections.namedtuple("_LeasedMessage", ["added_time", "size"])
+
+
+class Leaser(object):
+    def __init__(self, manager):
+        self._thread = None
+        self._manager = manager
+
+        # a lock used for start/stop operations, protecting the _thread attribute
+        self._operational_lock = threading.Lock()
+
+        # A lock ensuring that add/remove operations are atomic and cannot be
+        # intertwined. Protects the _leased_messages and _bytes attributes.
+        self._add_remove_lock = threading.Lock()
+
+        self._leased_messages = {}
+        """dict[str, float]: A mapping of ack IDs to the local time when the
+            ack ID was initially leased in seconds since the epoch."""
+        self._bytes = 0
+        """int: The total number of bytes consumed by leased messages."""
+
+        self._stop_event = threading.Event()
+
+    @property
+    def message_count(self):
+        """int: The number of leased messages."""
+        return len(self._leased_messages)
+
+    @property
+    def ack_ids(self):
+        """Sequence[str]: The ack IDs of all leased messages."""
+        return self._leased_messages.keys()
+
+    @property
+    def bytes(self):
+        """int: The total size, in bytes, of all leased messages."""
+        return self._bytes
+
+    def add(self, items):
+        """Add messages to be managed by the leaser."""
+        with self._add_remove_lock:
+            for item in items:
+                # Add the ack ID to the set of managed ack IDs, and increment
+                # the size counter.
+                if item.ack_id not in self._leased_messages:
+                    self._leased_messages[item.ack_id] = _LeasedMessage(
+                        added_time=time.time(), size=item.byte_size
+                    )
+                    self._bytes += item.byte_size
+                else:
+                    _LOGGER.debug("Message %s is already lease managed", item.ack_id)
+
+    def remove(self, items):
+        """Remove messages from lease management."""
+        with self._add_remove_lock:
+            # Remove the ack ID from lease management, and decrement the
+            # byte counter.
+            for item in items:
+                if self._leased_messages.pop(item.ack_id, None) is not None:
+                    self._bytes -= item.byte_size
+                else:
+                    _LOGGER.debug("Item %s was not managed.", item.ack_id)
+
+            if self._bytes < 0:
+                _LOGGER.debug("Bytes was unexpectedly negative: %d", self._bytes)
+                self._bytes = 0
+
+    def maintain_leases(self):
+        """Maintain all of the leases being managed.
+
+        This method modifies the ack deadline for all of the managed
+        ack IDs, then waits for most of that time (but with jitter), and
+        repeats.
+        """
+        while self._manager.is_active and not self._stop_event.is_set():
+            # Determine the appropriate duration for the lease. This is
+            # based off of how long previous messages have taken to ack, with
+            # a sensible default and within the ranges allowed by Pub/Sub.
+            p99 = self._manager.ack_histogram.percentile(99)
+            _LOGGER.debug("The current p99 value is %d seconds.", p99)
+
+            # Make a copy of the leased messages. This is needed because it's
+            # possible for another thread to modify the dictionary while
+            # we're iterating over it.
+            leased_messages = copy.copy(self._leased_messages)
+
+            # Drop any leases that are well beyond max lease time. This
+            # ensures that in the event of a badly behaving actor, we can
+            # drop messages and allow Pub/Sub to resend them.
+            cutoff = time.time() - self._manager.flow_control.max_lease_duration
+            to_drop = [
+                requests.DropRequest(ack_id, item.size)
+                for ack_id, item in six.iteritems(leased_messages)
+                if item.added_time < cutoff
+            ]
+
+            if to_drop:
+                _LOGGER.warning(
+                    "Dropping %s items because they were leased too long.", len(to_drop)
+                )
+                self._manager.dispatcher.drop(to_drop)
+
+            # Remove dropped items from our copy of the leased messages (they
+            # have already been removed from the real one by
+            # self._manager.drop(), which calls self.remove()).
+            for item in to_drop:
+                leased_messages.pop(item.ack_id)
+
+            # Create a streaming pull request.
+            # We do not actually call `modify_ack_deadline` over and over
+            # because it is more efficient to make a single request.
+            ack_ids = leased_messages.keys()
+            if ack_ids:
+                _LOGGER.debug("Renewing lease for %d ack IDs.", len(ack_ids))
+
+                # NOTE: This may not work as expected if ``consumer.active``
+                #       has changed since we checked it. An implementation
+                #       without any sort of race condition would require a
+                #       way for ``send_request`` to fail when the consumer
+                #       is inactive.
+                self._manager.dispatcher.modify_ack_deadline(
+                    [requests.ModAckRequest(ack_id, p99) for ack_id in ack_ids]
+                )
+
+            # Now wait an appropriate period of time and do this again.
+            #
+            # We determine the appropriate period of time based on a random
+            # period between 0 seconds and 90% of the lease. This use of
+            # jitter (http://bit.ly/2s2ekL7) helps decrease contention in cases
+            # where there are many clients.
+            snooze = random.uniform(0.0, p99 * 0.9)
+            _LOGGER.debug("Snoozing lease management for %f seconds.", snooze)
+            self._stop_event.wait(timeout=snooze)
+
+        _LOGGER.info("%s exiting.", _LEASE_WORKER_NAME)
+
+    def start(self):
+        with self._operational_lock:
+            if self._thread is not None:
+                raise ValueError("Leaser is already running.")
+
+            # Create and start the helper thread.
+            self._stop_event.clear()
+            thread = threading.Thread(
+                name=_LEASE_WORKER_NAME, target=self.maintain_leases
+            )
+            thread.daemon = True
+            thread.start()
+            _LOGGER.debug("Started helper thread %s", thread.name)
+            self._thread = thread
+
+    def stop(self):
+        with self._operational_lock:
+            self._stop_event.set()
+
+            if self._thread is not None:
+                # The thread should automatically exit when the consumer is
+                # inactive.
+                self._thread.join()
+
+            self._thread = None
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/requests.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/requests.py
new file mode 100644
index 000000000000..ac1df0af8eff
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/requests.py
@@ -0,0 +1,33 @@
+# Copyright 2017, Google LLC 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.
+
+"""Base class for concurrency policy."""
+
+from __future__ import absolute_import, division
+
+import collections
+
+# Namedtuples for management requests. Used by the Message class to communicate
+# items of work back to the policy.
+AckRequest = collections.namedtuple(
+    "AckRequest", ["ack_id", "byte_size", "time_to_ack"]
+)
+
+DropRequest = collections.namedtuple("DropRequest", ["ack_id", "byte_size"])
+
+LeaseRequest = collections.namedtuple("LeaseRequest", ["ack_id", "byte_size"])
+
+ModAckRequest = collections.namedtuple("ModAckRequest", ["ack_id", "seconds"])
+
+NackRequest = collections.namedtuple("NackRequest", ["ack_id", "byte_size"])
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/streaming_pull_manager.py b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/streaming_pull_manager.py
new file mode 100644
index 000000000000..af6883fd067e
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/_protocol/streaming_pull_manager.py
@@ -0,0 +1,585 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import division
+
+import collections
+import functools
+import logging
+import threading
+
+import grpc
+import six
+from six.moves import queue
+
+from google.api_core import bidi
+from google.api_core import exceptions
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.subscriber._protocol import dispatcher
+from google.cloud.pubsub_v1.subscriber._protocol import heartbeater
+from google.cloud.pubsub_v1.subscriber._protocol import histogram
+from google.cloud.pubsub_v1.subscriber._protocol import leaser
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+import google.cloud.pubsub_v1.subscriber.message
+import google.cloud.pubsub_v1.subscriber.scheduler
+
+_LOGGER = logging.getLogger(__name__)
+_RPC_ERROR_THREAD_NAME = "Thread-OnRpcTerminated"
+_RETRYABLE_STREAM_ERRORS = (
+    exceptions.DeadlineExceeded,
+    exceptions.ServiceUnavailable,
+    exceptions.InternalServerError,
+    exceptions.Unknown,
+    exceptions.GatewayTimeout,
+    exceptions.Aborted,
+)
+_MAX_LOAD = 1.0
+"""The load threshold above which to pause the incoming message stream."""
+
+_RESUME_THRESHOLD = 0.8
+"""The load threshold below which to resume the incoming message stream."""
+
+
+def _maybe_wrap_exception(exception):
+    """Wraps a gRPC exception class, if needed."""
+    if isinstance(exception, grpc.RpcError):
+        return exceptions.from_grpc_error(exception)
+    return exception
+
+
+def _wrap_callback_errors(callback, on_callback_error, message):
+    """Wraps a user callback so that if an exception occurs the message is
+    nacked.
+
+    Args:
+        callback (Callable[None, Message]): The user callback.
+        message (~Message): The Pub/Sub message.
+    """
+    try:
+        callback(message)
+    except Exception as exc:
+        # Note: the likelihood of this failing is extremely low. This just adds
+        # a message to a queue, so if this doesn't work the world is in an
+        # unrecoverable state and this thread should just bail.
+        _LOGGER.exception(
+            "Top-level exception occurred in callback while processing a message"
+        )
+        message.nack()
+        on_callback_error(exc)
+
+
+class StreamingPullManager(object):
+    """The streaming pull manager coordinates pulling messages from Pub/Sub,
+    leasing them, and scheduling them to be processed.
+
+    Args:
+        client (~.pubsub_v1.subscriber.client): The subscriber client used
+            to create this instance.
+        subscription (str): The name of the subscription. The canonical
+            format for this is
+            ``projects/{project}/subscriptions/{subscription}``.
+        flow_control (~google.cloud.pubsub_v1.types.FlowControl): The flow
+            control settings.
+        scheduler (~google.cloud.pubsub_v1.scheduler.Scheduler): The scheduler
+            to use to process messages. If not provided, a thread pool-based
+            scheduler will be used.
+    """
+
+    _UNARY_REQUESTS = True
+    """If set to True, this class will make requests over a separate unary
+    RPC instead of over the streaming RPC."""
+
+    def __init__(
+        self, client, subscription, flow_control=types.FlowControl(), scheduler=None
+    ):
+        self._client = client
+        self._subscription = subscription
+        self._flow_control = flow_control
+        self._ack_histogram = histogram.Histogram()
+        self._last_histogram_size = 0
+        self._ack_deadline = 10
+        self._rpc = None
+        self._callback = None
+        self._closing = threading.Lock()
+        self._closed = False
+        self._close_callbacks = []
+
+        if scheduler is None:
+            self._scheduler = (
+                google.cloud.pubsub_v1.subscriber.scheduler.ThreadScheduler()
+            )
+        else:
+            self._scheduler = scheduler
+
+        # A FIFO queue for the messages that have been received from the server,
+        # but not yet added to the lease management (and not sent to user callback),
+        # because the FlowControl limits have been hit.
+        self._messages_on_hold = queue.Queue()
+
+        # A lock ensuring that pausing / resuming the consumer are both atomic
+        # operations that cannot be executed concurrently. Needed for properly
+        # syncing these operations with the current leaser load.
+        self._pause_resume_lock = threading.Lock()
+
+        # The threads created in ``.open()``.
+        self._dispatcher = None
+        self._leaser = None
+        self._consumer = None
+        self._heartbeater = None
+
+    @property
+    def is_active(self):
+        """bool: True if this manager is actively streaming.
+
+        Note that ``False`` does not indicate this is complete shut down,
+        just that it stopped getting new messages.
+        """
+        return self._consumer is not None and self._consumer.is_active
+
+    @property
+    def flow_control(self):
+        """google.cloud.pubsub_v1.types.FlowControl: The active flow control
+        settings."""
+        return self._flow_control
+
+    @property
+    def dispatcher(self):
+        """google.cloud.pubsub_v1.subscriber._protocol.dispatcher.Dispatcher:
+        The dispatcher helper.
+        """
+        return self._dispatcher
+
+    @property
+    def leaser(self):
+        """google.cloud.pubsub_v1.subscriber._protocol.leaser.Leaser:
+        The leaser helper.
+        """
+        return self._leaser
+
+    @property
+    def ack_histogram(self):
+        """google.cloud.pubsub_v1.subscriber._protocol.histogram.Histogram:
+        The histogram tracking time-to-acknowledge.
+        """
+        return self._ack_histogram
+
+    @property
+    def ack_deadline(self):
+        """Return the current ack deadline based on historical time-to-ack.
+
+        This method is "sticky". It will only perform the computations to
+        check on the right ack deadline if the histogram has gained a
+        significant amount of new information.
+
+        Returns:
+            int: The ack deadline.
+        """
+        target = min([self._last_histogram_size * 2, self._last_histogram_size + 100])
+        if len(self.ack_histogram) > target:
+            self._ack_deadline = self.ack_histogram.percentile(percent=99)
+        return self._ack_deadline
+
+    @property
+    def load(self):
+        """Return the current load.
+
+        The load is represented as a float, where 1.0 represents having
+        hit one of the flow control limits, and values between 0.0 and 1.0
+        represent how close we are to them. (0.5 means we have exactly half
+        of what the flow control setting allows, for example.)
+
+        There are (currently) two flow control settings; this property
+        computes how close the manager is to each of them, and returns
+        whichever value is higher. (It does not matter that we have lots of
+        running room on setting A if setting B is over.)
+
+        Returns:
+            float: The load value.
+        """
+        if self._leaser is None:
+            return 0
+
+        return max(
+            [
+                self._leaser.message_count / self._flow_control.max_messages,
+                self._leaser.bytes / self._flow_control.max_bytes,
+            ]
+        )
+
+    def add_close_callback(self, callback):
+        """Schedules a callable when the manager closes.
+
+        Args:
+            callback (Callable): The method to call.
+        """
+        self._close_callbacks.append(callback)
+
+    def maybe_pause_consumer(self):
+        """Check the current load and pause the consumer if needed."""
+        with self._pause_resume_lock:
+            if self.load >= _MAX_LOAD:
+                if self._consumer is not None and not self._consumer.is_paused:
+                    _LOGGER.debug(
+                        "Message backlog over load at %.2f, pausing.", self.load
+                    )
+                    self._consumer.pause()
+
+    def maybe_resume_consumer(self):
+        """Check the load and held messages and resume the consumer if needed.
+
+        If there are messages held internally, release those messages before
+        resuming the consumer. That will avoid leaser overload.
+        """
+        with self._pause_resume_lock:
+            # If we have been paused by flow control, check and see if we are
+            # back within our limits.
+            #
+            # In order to not thrash too much, require us to have passed below
+            # the resume threshold (80% by default) of each flow control setting
+            # before restarting.
+            if self._consumer is None or not self._consumer.is_paused:
+                return
+
+            _LOGGER.debug("Current load: %.2f", self.load)
+
+            # Before maybe resuming the background consumer, release any messages
+            # currently on hold, if the current load allows for it.
+            self._maybe_release_messages()
+
+            if self.load < _RESUME_THRESHOLD:
+                _LOGGER.debug("Current load is %.2f, resuming consumer.", self.load)
+                self._consumer.resume()
+            else:
+                _LOGGER.debug("Did not resume, current load is %.2f.", self.load)
+
+    def _maybe_release_messages(self):
+        """Release (some of) the held messages if the current load allows for it.
+
+        The method tries to release as many messages as the current leaser load
+        would allow. Each released message is added to the lease management,
+        and the user callback is scheduled for it.
+
+        If there are currently no messageges on hold, or if the leaser is
+        already overloaded, this method is effectively a no-op.
+
+        The method assumes the caller has acquired the ``_pause_resume_lock``.
+        """
+        while True:
+            if self.load >= _MAX_LOAD:
+                break  # already overloaded
+
+            try:
+                msg = self._messages_on_hold.get_nowait()
+            except queue.Empty:
+                break
+
+            self.leaser.add(
+                [requests.LeaseRequest(ack_id=msg.ack_id, byte_size=msg.size)]
+            )
+            _LOGGER.debug(
+                "Released held message to leaser, scheduling callback for it, "
+                "still on hold %s.",
+                self._messages_on_hold.qsize(),
+            )
+            self._scheduler.schedule(self._callback, msg)
+
+    def _send_unary_request(self, request):
+        """Send a request using a separate unary request instead of over the
+        stream.
+
+        Args:
+            request (types.StreamingPullRequest): The stream request to be
+                mapped into unary requests.
+        """
+        if request.ack_ids:
+            self._client.acknowledge(
+                subscription=self._subscription, ack_ids=list(request.ack_ids)
+            )
+
+        if request.modify_deadline_ack_ids:
+            # Send ack_ids with the same deadline seconds together.
+            deadline_to_ack_ids = collections.defaultdict(list)
+
+            for n, ack_id in enumerate(request.modify_deadline_ack_ids):
+                deadline = request.modify_deadline_seconds[n]
+                deadline_to_ack_ids[deadline].append(ack_id)
+
+            for deadline, ack_ids in six.iteritems(deadline_to_ack_ids):
+                self._client.modify_ack_deadline(
+                    subscription=self._subscription,
+                    ack_ids=ack_ids,
+                    ack_deadline_seconds=deadline,
+                )
+
+        _LOGGER.debug("Sent request(s) over unary RPC.")
+
+    def send(self, request):
+        """Queue a request to be sent to the RPC.
+
+        If a RetryError occurs, the manager shutdown is triggered, and the
+        error is re-raised.
+        """
+        if self._UNARY_REQUESTS:
+            try:
+                self._send_unary_request(request)
+            except exceptions.GoogleAPICallError:
+                _LOGGER.debug(
+                    "Exception while sending unary RPC. This is typically "
+                    "non-fatal as stream requests are best-effort.",
+                    exc_info=True,
+                )
+            except exceptions.RetryError as exc:
+                _LOGGER.debug(
+                    "RetryError while sending unary RPC. Waiting on a transient "
+                    "error resolution for too long, will now trigger shutdown.",
+                    exc_info=False,
+                )
+                # The underlying channel has been suffering from a retryable error
+                # for too long, time to give up and shut the streaming pull down.
+                self._on_rpc_done(exc)
+                raise
+
+        else:
+            self._rpc.send(request)
+
+    def heartbeat(self):
+        """Sends an empty request over the streaming pull RPC.
+
+        This always sends over the stream, regardless of if
+        ``self._UNARY_REQUESTS`` is set or not.
+        """
+        if self._rpc is not None and self._rpc.is_active:
+            self._rpc.send(types.StreamingPullRequest())
+
+    def open(self, callback, on_callback_error):
+        """Begin consuming messages.
+
+        Args:
+            callback (Callable[None, google.cloud.pubsub_v1.message.Message]):
+                A callback that will be called for each message received on the
+                stream.
+            on_callback_error (Callable[Exception]):
+                A callable that will be called if an exception is raised in
+                the provided `callback`.
+        """
+        if self.is_active:
+            raise ValueError("This manager is already open.")
+
+        if self._closed:
+            raise ValueError("This manager has been closed and can not be re-used.")
+
+        self._callback = functools.partial(
+            _wrap_callback_errors, callback, on_callback_error
+        )
+
+        # Create the RPC
+        self._rpc = bidi.ResumableBidiRpc(
+            start_rpc=self._client.api.streaming_pull,
+            initial_request=self._get_initial_request,
+            should_recover=self._should_recover,
+            throttle_reopen=True,
+        )
+        self._rpc.add_done_callback(self._on_rpc_done)
+
+        # Create references to threads
+        self._dispatcher = dispatcher.Dispatcher(self, self._scheduler.queue)
+        self._consumer = bidi.BackgroundConsumer(self._rpc, self._on_response)
+        self._leaser = leaser.Leaser(self)
+        self._heartbeater = heartbeater.Heartbeater(self)
+
+        # Start the thread to pass the requests.
+        self._dispatcher.start()
+
+        # Start consuming messages.
+        self._consumer.start()
+
+        # Start the lease maintainer thread.
+        self._leaser.start()
+
+        # Start the stream heartbeater thread.
+        self._heartbeater.start()
+
+    def close(self, reason=None):
+        """Stop consuming messages and shutdown all helper threads.
+
+        This method is idempotent. Additional calls will have no effect.
+
+        Args:
+            reason (Any): The reason to close this. If None, this is considered
+                an "intentional" shutdown. This is passed to the callbacks
+                specified via :meth:`add_close_callback`.
+        """
+        with self._closing:
+            if self._closed:
+                return
+
+            # Stop consuming messages.
+            if self.is_active:
+                _LOGGER.debug("Stopping consumer.")
+                self._consumer.stop()
+            self._consumer = None
+
+            # Shutdown all helper threads
+            _LOGGER.debug("Stopping scheduler.")
+            self._scheduler.shutdown()
+            self._scheduler = None
+
+            # Leaser and dispatcher reference each other through the shared
+            # StreamingPullManager instance, i.e. "self", thus do not set their
+            # references to None until both have been shut down.
+            #
+            # NOTE: Even if the dispatcher operates on an inactive leaser using
+            # the latter's add() and remove() methods, these have no impact on
+            # the stopped leaser (the leaser is never again re-started). Ditto
+            # for the manager's maybe_resume_consumer() / maybe_pause_consumer(),
+            # because the consumer gets shut down first.
+            _LOGGER.debug("Stopping leaser.")
+            self._leaser.stop()
+            _LOGGER.debug("Stopping dispatcher.")
+            self._dispatcher.stop()
+            self._dispatcher = None
+            # dispatcher terminated, OK to dispose the leaser reference now
+            self._leaser = None
+            _LOGGER.debug("Stopping heartbeater.")
+            self._heartbeater.stop()
+            self._heartbeater = None
+
+            self._rpc = None
+            self._closed = True
+            _LOGGER.debug("Finished stopping manager.")
+
+            for callback in self._close_callbacks:
+                callback(self, reason)
+
+    def _get_initial_request(self):
+        """Return the initial request for the RPC.
+
+        This defines the initial request that must always be sent to Pub/Sub
+        immediately upon opening the subscription.
+
+        Returns:
+            google.cloud.pubsub_v1.types.StreamingPullRequest: A request
+            suitable for being the first request on the stream (and not
+            suitable for any other purpose).
+        """
+        # Any ack IDs that are under lease management need to have their
+        # deadline extended immediately.
+        if self._leaser is not None:
+            # Explicitly copy the list, as it could be modified by another
+            # thread.
+            lease_ids = list(self._leaser.ack_ids)
+        else:
+            lease_ids = []
+
+        # Put the request together.
+        request = types.StreamingPullRequest(
+            modify_deadline_ack_ids=list(lease_ids),
+            modify_deadline_seconds=[self.ack_deadline] * len(lease_ids),
+            stream_ack_deadline_seconds=self.ack_histogram.percentile(99),
+            subscription=self._subscription,
+        )
+
+        # Return the initial request.
+        return request
+
+    def _on_response(self, response):
+        """Process all received Pub/Sub messages.
+
+        For each message, send a modified acknowledgment request to the
+        server. This prevents expiration of the message due to buffering by
+        gRPC or proxy/firewall. This makes the server and client expiration
+        timer closer to each other thus preventing the message being
+        redelivered multiple times.
+
+        After the messages have all had their ack deadline updated, execute
+        the callback for each message using the executor.
+        """
+        _LOGGER.debug(
+            "Processing %s received message(s), currenty on hold %s.",
+            len(response.received_messages),
+            self._messages_on_hold.qsize(),
+        )
+
+        # Immediately modack the messages we received, as this tells the server
+        # that we've received them.
+        items = [
+            requests.ModAckRequest(message.ack_id, self._ack_histogram.percentile(99))
+            for message in response.received_messages
+        ]
+        self._dispatcher.modify_ack_deadline(items)
+
+        invoke_callbacks_for = []
+
+        for received_message in response.received_messages:
+            message = google.cloud.pubsub_v1.subscriber.message.Message(
+                received_message.message, received_message.ack_id, self._scheduler.queue
+            )
+            if self.load < _MAX_LOAD:
+                req = requests.LeaseRequest(
+                    ack_id=message.ack_id, byte_size=message.size
+                )
+                self.leaser.add([req])
+                invoke_callbacks_for.append(message)
+                self.maybe_pause_consumer()
+            else:
+                self._messages_on_hold.put(message)
+
+        _LOGGER.debug(
+            "Scheduling callbacks for %s new messages, new total on hold %s.",
+            len(invoke_callbacks_for),
+            self._messages_on_hold.qsize(),
+        )
+        for msg in invoke_callbacks_for:
+            self._scheduler.schedule(self._callback, msg)
+
+    def _should_recover(self, exception):
+        """Determine if an error on the RPC stream should be recovered.
+
+        If the exception is one of the retryable exceptions, this will signal
+        to the consumer thread that it should "recover" from the failure.
+
+        This will cause the stream to exit when it returns :data:`False`.
+
+        Returns:
+            bool: Indicates if the caller should recover or shut down.
+            Will be :data:`True` if the ``exception`` is "acceptable", i.e.
+            in a list of retryable / idempotent exceptions.
+        """
+        exception = _maybe_wrap_exception(exception)
+        # If this is in the list of idempotent exceptions, then we want to
+        # recover.
+        if isinstance(exception, _RETRYABLE_STREAM_ERRORS):
+            _LOGGER.info("Observed recoverable stream error %s", exception)
+            return True
+        _LOGGER.info("Observed non-recoverable stream error %s", exception)
+        return False
+
+    def _on_rpc_done(self, future):
+        """Triggered whenever the underlying RPC terminates without recovery.
+
+        This is typically triggered from one of two threads: the background
+        consumer thread (when calling ``recv()`` produces a non-recoverable
+        error) or the grpc management thread (when cancelling the RPC).
+
+        This method is *non-blocking*. It will start another thread to deal
+        with shutting everything down. This is to prevent blocking in the
+        background consumer and preventing it from being ``joined()``.
+        """
+        _LOGGER.info("RPC termination has signaled streaming pull manager shutdown.")
+        future = _maybe_wrap_exception(future)
+        thread = threading.Thread(
+            name=_RPC_ERROR_THREAD_NAME, target=self.close, kwargs={"reason": future}
+        )
+        thread.daemon = True
+        thread.start()
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/client.py b/pubsub/google/cloud/pubsub_v1/subscriber/client.py
new file mode 100644
index 000000000000..b255fe4767ca
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/client.py
@@ -0,0 +1,230 @@
+# Copyright 2019, Google LLC 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.
+
+from __future__ import absolute_import
+
+import os
+import pkg_resources
+
+import grpc
+
+from google.api_core import grpc_helpers
+from google.oauth2 import service_account
+
+from google.cloud.pubsub_v1 import _gapic
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.gapic import subscriber_client
+from google.cloud.pubsub_v1.gapic.transports import subscriber_grpc_transport
+from google.cloud.pubsub_v1.subscriber import futures
+from google.cloud.pubsub_v1.subscriber._protocol import streaming_pull_manager
+
+
+__version__ = pkg_resources.get_distribution("google-cloud-pubsub").version
+
+_BLACKLISTED_METHODS = (
+    "publish",
+    "from_service_account_file",
+    "from_service_account_json",
+)
+
+
+@_gapic.add_methods(subscriber_client.SubscriberClient, blacklist=_BLACKLISTED_METHODS)
+class Client(object):
+    """A subscriber client for Google Cloud Pub/Sub.
+
+    This creates an object that is capable of subscribing to messages.
+    Generally, you can instantiate this client with no arguments, and you
+    get sensible defaults.
+
+    Args:
+        kwargs (dict): Any additional arguments provided are sent as keyword
+            keyword arguments to the underlying
+            :class:`~google.cloud.pubsub_v1.gapic.subscriber_client.SubscriberClient`.
+            Generally you should not need to set additional keyword
+            arguments. Optionally, regional endpoints can be set via
+            ``client_options`` that takes a single key-value pair that
+            defines the endpoint.
+
+    Example:
+
+    .. code-block:: python
+
+        from google.cloud import pubsub_v1
+
+        subscriber_client = pubsub_v1.SubscriberClient(
+            # Optional
+            client_options = {
+                "api_endpoint": REGIONAL_ENDPOINT
+            }
+        )
+    """
+
+    def __init__(self, **kwargs):
+        # Sanity check: Is our goal to use the emulator?
+        # If so, create a grpc insecure channel with the emulator host
+        # as the target.
+        if os.environ.get("PUBSUB_EMULATOR_HOST"):
+            kwargs["channel"] = grpc.insecure_channel(
+                target=os.environ.get("PUBSUB_EMULATOR_HOST")
+            )
+
+        # Use a custom channel.
+        # We need this in order to set appropriate default message size and
+        # keepalive options.
+        if "transport" not in kwargs:
+            channel = kwargs.pop("channel", None)
+            if channel is None:
+                channel = grpc_helpers.create_channel(
+                    credentials=kwargs.pop("credentials", None),
+                    target=self.target,
+                    scopes=subscriber_client.SubscriberClient._DEFAULT_SCOPES,
+                    options={
+                        "grpc.max_send_message_length": -1,
+                        "grpc.max_receive_message_length": -1,
+                        "grpc.keepalive_time_ms": 30000,
+                    }.items(),
+                )
+            # cannot pass both 'channel' and 'credentials'
+            kwargs.pop("credentials", None)
+            transport = subscriber_grpc_transport.SubscriberGrpcTransport(
+                channel=channel
+            )
+            kwargs["transport"] = transport
+
+        # Add the metrics headers, and instantiate the underlying GAPIC
+        # client.
+        self._api = subscriber_client.SubscriberClient(**kwargs)
+
+    @classmethod
+    def from_service_account_file(cls, filename, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            A Subscriber :class:`~google.cloud.pubsub_v1.subscriber.client.Client`
+            instance that is the constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(**kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @property
+    def target(self):
+        """Return the target (where the API is).
+
+        Returns:
+            str: The location of the API.
+        """
+        return subscriber_client.SubscriberClient.SERVICE_ADDRESS
+
+    @property
+    def api(self):
+        """The underlying gapic API client."""
+        return self._api
+
+    def subscribe(self, subscription, callback, flow_control=(), scheduler=None):
+        """Asynchronously start receiving messages on a given subscription.
+
+        This method starts a background thread to begin pulling messages from
+        a Pub/Sub subscription and scheduling them to be processed using the
+        provided ``callback``.
+
+        The ``callback`` will be called with an individual
+        :class:`google.cloud.pubsub_v1.subscriber.message.Message`. It is the
+        responsibility of the callback to either call ``ack()`` or ``nack()``
+        on the message when it finished processing. If an exception occurs in
+        the callback during processing, the exception is logged and the message
+        is ``nack()`` ed.
+
+        The ``flow_control`` argument can be used to control the rate of at
+        which messages are pulled. The settings are relatively conservative by
+        default to prevent "message hoarding" - a situation where the client
+        pulls a large number of messages but can not process them fast enough
+        leading it to "starve" other clients of messages. Increasing these
+        settings may lead to faster throughput for messages that do not take
+        a long time to process.
+
+        This method starts the receiver in the background and returns a
+        *Future* representing its execution. Waiting on the future (calling
+        ``result()``) will block forever or until a non-recoverable error
+        is encountered (such as loss of network connectivity). Cancelling the
+        future will signal the process to shutdown gracefully and exit.
+
+        .. note:: This uses Pub/Sub's *streaming pull* feature. This feature
+            properties that may be surprising. Please take a look at
+            https://cloud.google.com/pubsub/docs/pull#streamingpull for
+            more details on how streaming pull behaves compared to the
+            synchronous pull method.
+
+        Example:
+
+        .. code-block:: python
+
+            from google.cloud import pubsub_v1
+
+            subscriber_client = pubsub_v1.SubscriberClient()
+
+            # existing subscription
+            subscription = subscriber_client.subscription_path(
+                'my-project-id', 'my-subscription')
+
+            def callback(message):
+                print(message)
+                message.ack()
+
+            future = subscriber_client.subscribe(
+                subscription, callback)
+
+            try:
+                future.result()
+            except KeyboardInterrupt:
+                future.cancel()
+
+        Args:
+            subscription (str): The name of the subscription. The
+                subscription should have already been created (for example,
+                by using :meth:`create_subscription`).
+            callback (Callable[~google.cloud.pubsub_v1.subscriber.message.Message]):
+                The callback function. This function receives the message as
+                its only argument and will be called from a different thread/
+                process depending on the scheduling strategy.
+            flow_control (~google.cloud.pubsub_v1.types.FlowControl): The flow control
+                settings. Use this to prevent situations where you are
+                inundated with too many messages at once.
+            scheduler (~google.cloud.pubsub_v1.subscriber.scheduler.Scheduler): An optional
+                *scheduler* to use when executing the callback. This controls
+                how callbacks are executed concurrently.
+
+        Returns:
+            A :class:`~google.cloud.pubsub_v1.subscriber.futures.StreamingPullFuture`
+            instance that can be used to manage the background stream.
+        """
+        flow_control = types.FlowControl(*flow_control)
+
+        manager = streaming_pull_manager.StreamingPullManager(
+            self, subscription, flow_control=flow_control, scheduler=scheduler
+        )
+
+        future = futures.StreamingPullFuture(manager)
+
+        manager.open(callback=callback, on_callback_error=future.set_exception)
+
+        return future
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/futures.py b/pubsub/google/cloud/pubsub_v1/subscriber/futures.py
new file mode 100644
index 000000000000..12504c18b5df
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/futures.py
@@ -0,0 +1,53 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.pubsub_v1 import futures
+
+
+class StreamingPullFuture(futures.Future):
+    """Represents a process that asynchronously performs streaming pull and
+    schedules messages to be processed.
+
+    This future is resolved when the process is stopped (via :meth:`cancel`) or
+    if it encounters an unrecoverable error. Calling `.result()` will cause
+    the calling thread to block indefinitely.
+    """
+
+    def __init__(self, manager):
+        super(StreamingPullFuture, self).__init__()
+        self._manager = manager
+        self._manager.add_close_callback(self._on_close_callback)
+        self._cancelled = False
+
+    def _on_close_callback(self, manager, result):
+        if result is None:
+            self.set_result(True)
+        else:
+            self.set_exception(result)
+
+    def cancel(self):
+        """Stops pulling messages and shutdowns the background thread consuming
+        messages.
+        """
+        self._cancelled = True
+        return self._manager.close()
+
+    def cancelled(self):
+        """
+        returns:
+            bool: ``True`` if the subscription has been cancelled.
+        """
+        return self._cancelled
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/message.py b/pubsub/google/cloud/pubsub_v1/subscriber/message.py
new file mode 100644
index 000000000000..41bc42755ad7
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/message.py
@@ -0,0 +1,229 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import datetime
+import json
+import math
+import time
+
+from google.api_core import datetime_helpers
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+
+
+_MESSAGE_REPR = """\
+Message {{
+  data: {!r}
+  attributes: {}
+}}"""
+
+
+def _indent(lines, prefix="  "):
+    """Indent some text.
+
+    Note that this is present as ``textwrap.indent``, but not in Python 2.
+
+    Args:
+        lines (str): The newline delimited string to be indented.
+        prefix (Optional[str]): The prefix to indent each line with. Default
+            to two spaces.
+
+    Returns:
+        str: The newly indented content.
+    """
+    indented = []
+    for line in lines.split("\n"):
+        indented.append(prefix + line)
+    return "\n".join(indented)
+
+
+class Message(object):
+    """A representation of a single Pub/Sub message.
+
+    The common way to interact with
+    :class:`~.pubsub_v1.subscriber.message.Message` objects is to receive
+    them in callbacks on subscriptions; most users should never have a need
+    to instantiate them by hand. (The exception to this is if you are
+    implementing a custom subclass to
+    :class:`~.pubsub_v1.subscriber._consumer.Consumer`.)
+
+    Attributes:
+        message_id (str): The message ID. In general, you should not need
+            to use this directly.
+        data (bytes): The data in the message. Note that this will be a
+            :class:`bytes`, not a text string.
+        attributes (.ScalarMapContainer): The attributes sent along with the
+            message. See :attr:`attributes` for more information on this type.
+        publish_time (datetime): The time that this message was originally
+            published.
+    """
+
+    def __init__(self, message, ack_id, request_queue):
+        """Construct the Message.
+
+        .. note::
+
+            This class should not be constructed directly; it is the
+            responsibility of :class:`BasePolicy` subclasses to do so.
+
+        Args:
+            message (~.pubsub_v1.types.PubsubMessage): The message received
+                from Pub/Sub.
+            ack_id (str): The ack_id received from Pub/Sub.
+            request_queue (queue.Queue): A queue provided by the policy that
+                can accept requests; the policy is responsible for handling
+                those requests.
+        """
+        self._message = message
+        self._ack_id = ack_id
+        self._request_queue = request_queue
+        self.message_id = message.message_id
+
+        # The instantiation time is the time that this message
+        # was received. Tracking this provides us a way to be smart about
+        # the default lease deadline.
+        self._received_timestamp = time.time()
+
+    def __repr__(self):
+        # Get an abbreviated version of the data.
+        abbv_data = self._message.data
+        if len(abbv_data) > 50:
+            abbv_data = abbv_data[:50] + b"..."
+
+        pretty_attrs = json.dumps(
+            dict(self.attributes), indent=2, separators=(",", ": "), sort_keys=True
+        )
+        pretty_attrs = _indent(pretty_attrs)
+        # We don't actually want the first line indented.
+        pretty_attrs = pretty_attrs.lstrip()
+        return _MESSAGE_REPR.format(abbv_data, pretty_attrs)
+
+    @property
+    def attributes(self):
+        """Return the attributes of the underlying Pub/Sub Message.
+
+        .. warning::
+
+            A ``ScalarMapContainer`` behaves slightly differently than a
+            ``dict``. For a Pub / Sub message this is a ``string->string`` map.
+            When trying to access a value via ``map['key']``, if the key is
+            not in the map, then the default value for the string type will
+            be returned, which is an empty string. It may be more intuitive
+            to just cast the map to a ``dict`` or to one use ``map.get``.
+
+        Returns:
+            .ScalarMapContainer: The message's attributes. This is a
+            ``dict``-like object provided by ``google.protobuf``.
+        """
+        return self._message.attributes
+
+    @property
+    def data(self):
+        """Return the data for the underlying Pub/Sub Message.
+
+        Returns:
+            bytes: The message data. This is always a bytestring; if you
+                want a text string, call :meth:`bytes.decode`.
+        """
+        return self._message.data
+
+    @property
+    def publish_time(self):
+        """Return the time that the message was originally published.
+
+        Returns:
+            datetime: The date and time that the message was published.
+        """
+        timestamp = self._message.publish_time
+        delta = datetime.timedelta(
+            seconds=timestamp.seconds, microseconds=timestamp.nanos // 1000
+        )
+        return datetime_helpers._UTC_EPOCH + delta
+
+    @property
+    def size(self):
+        """Return the size of the underlying message, in bytes."""
+        return self._message.ByteSize()
+
+    @property
+    def ack_id(self):
+        """str: the ID used to ack the message."""
+        return self._ack_id
+
+    def ack(self):
+        """Acknowledge the given message.
+
+        Acknowledging a message in Pub/Sub means that you are done
+        with it, and it will not be delivered to this subscription again.
+        You should avoid acknowledging messages until you have
+        *finished* processing them, so that in the event of a failure,
+        you receive the message again.
+
+        .. warning::
+            Acks in Pub/Sub are best effort. You should always
+            ensure that your processing code is idempotent, as you may
+            receive any given message more than once.
+        """
+        time_to_ack = math.ceil(time.time() - self._received_timestamp)
+        self._request_queue.put(
+            requests.AckRequest(
+                ack_id=self._ack_id, byte_size=self.size, time_to_ack=time_to_ack
+            )
+        )
+
+    def drop(self):
+        """Release the message from lease management.
+
+        This informs the policy to no longer hold on to the lease for this
+        message. Pub/Sub will re-deliver the message if it is not acknowledged
+        before the existing lease expires.
+
+        .. warning::
+            For most use cases, the only reason to drop a message from
+            lease management is on :meth:`ack` or :meth:`nack`; these methods
+            both call this one. You probably do not want to call this method
+            directly.
+        """
+        self._request_queue.put(
+            requests.DropRequest(ack_id=self._ack_id, byte_size=self.size)
+        )
+
+    def modify_ack_deadline(self, seconds):
+        """Resets the deadline for acknowledgement.
+
+        New deadline will be the given value of seconds from now.
+
+        The default implementation handles this for you; you should not need
+        to manually deal with setting ack deadlines. The exception case is
+        if you are implementing your own custom subclass of
+        :class:`~.pubsub_v1.subcriber._consumer.Consumer`.
+
+        Args:
+            seconds (int): The number of seconds to set the lease deadline
+                to. This should be between 0 and 600. Due to network latency,
+                values below 10 are advised against.
+        """
+        self._request_queue.put(
+            requests.ModAckRequest(ack_id=self._ack_id, seconds=seconds)
+        )
+
+    def nack(self):
+        """Decline to acknowldge the given message.
+
+        This will cause the message to be re-delivered to the subscription.
+        """
+        self._request_queue.put(
+            requests.NackRequest(ack_id=self._ack_id, byte_size=self.size)
+        )
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/scheduler.py b/pubsub/google/cloud/pubsub_v1/subscriber/scheduler.py
new file mode 100644
index 000000000000..42674c824c64
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/subscriber/scheduler.py
@@ -0,0 +1,123 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Schedulers provide means to *schedule* callbacks asynchronously.
+
+These are used by the subscriber to call the user-provided callback to process
+each message.
+"""
+
+import abc
+import concurrent.futures
+import sys
+
+import six
+from six.moves import queue
+
+
+@six.add_metaclass(abc.ABCMeta)
+class Scheduler(object):
+    """Abstract base class for schedulers.
+
+    Schedulers are used to schedule callbacks asynchronously.
+    """
+
+    @property
+    @abc.abstractmethod
+    def queue(self):
+        """Queue: A concurrency-safe queue specific to the underlying
+        concurrency implementation.
+
+        This queue is used to send messages *back* to the scheduling actor.
+        """
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def schedule(self, callback, *args, **kwargs):
+        """Schedule the callback to be called asynchronously.
+
+        Args:
+            callback (Callable): The function to call.
+            args: Positional arguments passed to the function.
+            kwargs: Key-word arguments passed to the function.
+
+        Returns:
+            None
+        """
+        raise NotImplementedError
+
+    @abc.abstractmethod
+    def shutdown(self):
+        """Shuts down the scheduler and immediately end all pending callbacks.
+        """
+        raise NotImplementedError
+
+
+def _make_default_thread_pool_executor():
+    # Python 2.7 and 3.6+ have the thread_name_prefix argument, which is useful
+    # for debugging.
+    executor_kwargs = {}
+    if sys.version_info[:2] == (2, 7) or sys.version_info >= (3, 6):
+        executor_kwargs["thread_name_prefix"] = "ThreadPoolExecutor-ThreadScheduler"
+    return concurrent.futures.ThreadPoolExecutor(max_workers=10, **executor_kwargs)
+
+
+class ThreadScheduler(Scheduler):
+    """A thread pool-based scheduler.
+
+    This scheduler is useful in typical I/O-bound message processing.
+
+    Args:
+        executor(concurrent.futures.ThreadPoolExecutor): An optional executor
+            to use. If not specified, a default one will be created.
+    """
+
+    def __init__(self, executor=None):
+        self._queue = queue.Queue()
+        if executor is None:
+            self._executor = _make_default_thread_pool_executor()
+        else:
+            self._executor = executor
+
+    @property
+    def queue(self):
+        """Queue: A thread-safe queue used for communication between callbacks
+        and the scheduling thread."""
+        return self._queue
+
+    def schedule(self, callback, *args, **kwargs):
+        """Schedule the callback to be called asynchronously in a thread pool.
+
+        Args:
+            callback (Callable): The function to call.
+            args: Positional arguments passed to the function.
+            kwargs: Key-word arguments passed to the function.
+
+        Returns:
+            None
+        """
+        self._executor.submit(callback, *args, **kwargs)
+
+    def shutdown(self):
+        """Shuts down the scheduler and immediately end all pending callbacks.
+        """
+        # Drop all pending item from the executor. Without this, the executor
+        # will block until all pending items are complete, which is
+        # undesirable.
+        try:
+            while True:
+                self._executor._work_queue.get(block=False)
+        except queue.Empty:
+            pass
+        self._executor.shutdown()
diff --git a/pubsub/google/cloud/pubsub_v1/types.py b/pubsub/google/cloud/pubsub_v1/types.py
new file mode 100644
index 000000000000..733d3bf97ac0
--- /dev/null
+++ b/pubsub/google/cloud/pubsub_v1/types.py
@@ -0,0 +1,126 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+import collections
+import sys
+
+from google.api import http_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.iam.v1.logging import audit_data_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.pubsub_v1.proto import pubsub_pb2
+
+
+# Define the default values for batching.
+#
+# This class is used when creating a publisher or subscriber client, and
+# these settings can be altered to tweak Pub/Sub behavior.
+# The defaults should be fine for most use cases.
+BatchSettings = collections.namedtuple(
+    "BatchSettings", ["max_bytes", "max_latency", "max_messages"]
+)
+BatchSettings.__new__.__defaults__ = (
+    1000 * 1000 * 10,  # max_bytes: documented "10 MB", enforced 10000000
+    0.05,  # max_latency: 0.05 seconds
+    1000,  # max_messages: 1,000
+)
+
+if sys.version_info >= (3, 5):
+    BatchSettings.__doc__ = "The settings for batch publishing the messages."
+    BatchSettings.max_bytes.__doc__ = (
+        "The maximum total size of the messages to collect before automatically "
+        "publishing the batch."
+    )
+    BatchSettings.max_latency.__doc__ = (
+        "The maximum number of seconds to wait for additional messages before "
+        "automatically publishing the batch."
+    )
+    BatchSettings.max_messages.__doc__ = (
+        "The maximum number of messages to collect before automatically "
+        "publishing the batch."
+    )
+
+
+# Define the type class and default values for flow control settings.
+#
+# This class is used when creating a publisher or subscriber client, and
+# these settings can be altered to tweak Pub/Sub behavior.
+# The defaults should be fine for most use cases.
+FlowControl = collections.namedtuple(
+    "FlowControl", ["max_bytes", "max_messages", "max_lease_duration"]
+)
+FlowControl.__new__.__defaults__ = (
+    100 * 1024 * 1024,  # max_bytes: 100mb
+    100,  # max_messages: 100
+    2 * 60 * 60,  # max_lease_duration: 2 hours.
+)
+
+if sys.version_info >= (3, 5):
+    FlowControl.__doc__ = (
+        "The settings for controlling the rate at which messages are pulled "
+        "with an asynchronous subscription."
+    )
+    FlowControl.max_bytes.__doc__ = (
+        "The maximum total size of received - but not yet processed - messages "
+        "before pausing the message stream."
+    )
+    FlowControl.max_messages.__doc__ = (
+        "The maximum number of received - but not yet processed - messages before "
+        "pausing the message stream."
+    )
+    FlowControl.max_lease_duration.__doc__ = (
+        "The maximum amount of time in seconds to hold a lease on a message "
+        "before dropping it from the lease management."
+    )
+
+
+_shared_modules = [
+    http_pb2,
+    iam_policy_pb2,
+    policy_pb2,
+    audit_data_pb2,
+    descriptor_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+]
+
+_local_modules = [pubsub_pb2]
+
+
+names = ["BatchSettings", "FlowControl"]
+
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.pubsub_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/pubsub/noxfile.py b/pubsub/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/pubsub/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/pubsub/pylint.config.py b/pubsub/pylint.config.py
new file mode 100644
index 000000000000..625e52cc9bbb
--- /dev/null
+++ b/pubsub/pylint.config.py
@@ -0,0 +1,32 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+import copy
+
+from gcp_devrel.tools import pylint
+
+# Library configuration
+
+# library_additions = {}
+# Ignore generated code
+library_replacements = copy.deepcopy(pylint.DEFAULT_LIBRARY_RC_REPLACEMENTS)
+library_replacements['MASTER']['ignore'].append('gapic')
+library_replacements['MASTER']['ignore'].append('proto')
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/pubsub/setup.cfg b/pubsub/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/pubsub/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/pubsub/setup.py b/pubsub/setup.py
new file mode 100644
index 000000000000..ab1d963174a5
--- /dev/null
+++ b/pubsub/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-pubsub"
+description = "Google Cloud Pub/Sub API client library"
+version = "0.45.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 4 - Beta"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+    'enum34; python_version < "3.4"',
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/pubsub/synth.metadata b/pubsub/synth.metadata
new file mode 100644
index 000000000000..1686bce7e232
--- /dev/null
+++ b/pubsub/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-24T12:27:35.100766Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.34.0",
+        "dockerImage": "googleapis/artman@sha256:38a27ba6245f96c3e86df7acb2ebcc33b4f186d9e475efe2d64303aec3d4e0ea"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "b97af5f7fea49d533900b62cca171da0e49743de",
+        "internalRef": "265156479"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "pubsub",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/pubsub/artman_pubsub.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/pubsub/synth.py b/pubsub/synth.py
new file mode 100644
index 000000000000..a65bf2bf4f56
--- /dev/null
+++ b/pubsub/synth.py
@@ -0,0 +1,195 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import re
+import textwrap
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+version = "v1"
+
+# ----------------------------------------------------------------------------
+# Generate pubsub GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "pubsub",
+    version,
+    config_path="/google/pubsub/artman_pubsub.yaml",
+    include_protos=True,
+)
+s.move(
+    library,
+    excludes=[
+        "docs/**/*",
+        "nox.py",
+        "README.rst",
+        "setup.py",
+        "google/cloud/pubsub_v1/__init__.py",
+        "google/cloud/pubsub_v1/types.py",
+    ],
+)
+
+# Adjust tests to import the clients directly.
+s.replace(
+    "tests/unit/gapic/v1/test_publisher_client_v1.py",
+    "from google.cloud import pubsub_v1",
+    "from google.cloud.pubsub_v1.gapic import publisher_client",
+)
+
+s.replace(
+    "tests/unit/gapic/v1/test_publisher_client_v1.py", " pubsub_v1", " publisher_client"
+)
+
+s.replace(
+    "tests/unit/gapic/v1/test_subscriber_client_v1.py",
+    "from google.cloud import pubsub_v1",
+    "from google.cloud.pubsub_v1.gapic import subscriber_client",
+)
+
+s.replace(
+    "tests/unit/gapic/v1/test_subscriber_client_v1.py",
+    " pubsub_v1",
+    " subscriber_client",
+)
+
+# DEFAULT SCOPES are being used. so let's force them in.
+s.replace(
+    "google/cloud/pubsub_v1/gapic/*er_client.py",
+    "# The name of the interface for this client. This is the key used to",
+    """# The scopes needed to make gRPC calls to all of the methods defined in
+    # this service
+    _DEFAULT_SCOPES = (
+        'https://www.googleapis.com/auth/cloud-platform',
+        'https://www.googleapis.com/auth/pubsub', )
+
+    \g<0>""",
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "import google.api_core.gapic_v1.method\n",
+    "\g<0>import google.api_core.path_template\n",
+)
+
+# Doc strings are formatted poorly
+s.replace(
+    "google/cloud/pubsub_v1/proto/pubsub_pb2.py",
+    'DESCRIPTOR = _MESSAGESTORAGEPOLICY,\n\s+__module__.*\n\s+,\n\s+__doc__ = """',
+    "\g<0>A message storage policy.\n\n\n    ",
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/subscriber_client.py",
+    "subscription \(str\): The subscription whose backlog .*\n(.*\n)+?"
+    "\s+Format is .*",
+    """subscription (str): 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 \\
+                     unacknowledged upon the successful completion of the \\
+                     `CreateSnapshot` request; as well as: \\
+                 (b) Any messages published to the subscription's topic following the \\
+                     successful completion of the CreateSnapshot request. \\
+
+                Format is ``projects/{project}/subscriptions/{sub}``.""",
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "import functools\n",
+    "import collections\n"
+    "from copy import deepcopy\n\g<0>"
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "import pkg_resources\n",
+    "\g<0>import six\n"
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "class PublisherClient",
+    """# TODO: remove conditional import after Python 2 support is dropped
+if six.PY3:
+    from collections.abc import Mapping
+else:
+    from collections import Mapping
+    
+
+def _merge_dict(d1, d2):
+    # Modifies d1 in-place to take values from d2
+    # if the nested keys from d2 are present in d1.
+    # https://stackoverflow.com/a/10704003/4488789
+    for k, v2 in d2.items():
+        v1 = d1.get(k) # returns None if v1 has no such key
+        if v1 is None:
+            raise Exception("{} is not recognized by client_config".format(k))
+        if isinstance(v1, Mapping) and isinstance(v2, Mapping):
+            _merge_dict(v1, v2)
+        else:
+            d1[k] = v2
+    return d1
+    \n\n\g<0>"""
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "client_config \(dict\): DEPRECATED.",
+    "client_config (dict):"
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "# Raise deprecation warnings .*\n.*\n.*\n.*\n.*\n.*\n",
+    """default_client_config = deepcopy(publisher_client_config.config)
+
+        if client_config is None:
+            client_config = default_client_config
+        else:
+            client_config = _merge_dict(default_client_config, client_config)
+    """
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/publisher_client.py",
+    "~google.api_core.page_iterator.PageIterator",
+    "~google.api_core.page_iterator.GRPCIterator"
+)
+
+s.replace(
+    "google/cloud/pubsub_v1/gapic/subscriber_client.py",
+    "~google.api_core.page_iterator.PageIterator",
+    "~google.api_core.page_iterator.GRPCIterator"
+)
+
+# Temporary fixup for 'grpc-google-iam-vi 0.12.4' (before generation).
+s.replace(
+    "google/cloud/pubsub_v1/gapic/transports/*_grpc_transport.py",
+    "from google.iam.v1 import iam_policy_pb2",
+    "from google.iam.v1 import iam_policy_pb2_grpc as iam_policy_pb2",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = gcp.CommonTemplates().py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/pubsub/tests/system.py b/pubsub/tests/system.py
new file mode 100644
index 000000000000..7ffb4a580194
--- /dev/null
+++ b/pubsub/tests/system.py
@@ -0,0 +1,522 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import datetime
+import itertools
+import operator as op
+import threading
+import time
+
+import mock
+import pytest
+import six
+
+import google.auth
+from google.cloud import pubsub_v1
+from google.cloud.pubsub_v1 import exceptions
+from google.cloud.pubsub_v1 import futures
+from google.cloud.pubsub_v1 import types
+
+
+from test_utils.system import unique_resource_id
+
+
+@pytest.fixture(scope=u"module")
+def project():
+    _, default_project = google.auth.default()
+    yield default_project
+
+
+@pytest.fixture(scope=u"module")
+def publisher():
+    yield pubsub_v1.PublisherClient()
+
+
+@pytest.fixture(scope=u"module")
+def subscriber():
+    yield pubsub_v1.SubscriberClient()
+
+
+@pytest.fixture
+def topic_path(project, publisher):
+    topic_name = "t" + unique_resource_id("-")
+    yield publisher.topic_path(project, topic_name)
+
+
+@pytest.fixture
+def subscription_path(project, subscriber):
+    sub_name = "s" + unique_resource_id("-")
+    yield subscriber.subscription_path(project, sub_name)
+
+
+@pytest.fixture
+def cleanup():
+    registry = []
+    yield registry
+
+    # Perform all clean up.
+    for to_call, argument in registry:
+        to_call(argument)
+
+
+def test_publish_messages(publisher, topic_path, cleanup):
+    futures = []
+    # Make sure the topic gets deleted.
+    cleanup.append((publisher.delete_topic, topic_path))
+
+    publisher.create_topic(topic_path)
+    for index in six.moves.range(500):
+        futures.append(
+            publisher.publish(
+                topic_path,
+                b"The hail in Wales falls mainly on the snails.",
+                num=str(index),
+            )
+        )
+    for future in futures:
+        result = future.result()
+        assert isinstance(result, six.string_types)
+
+
+def test_subscribe_to_messages(
+    publisher, topic_path, subscriber, subscription_path, cleanup
+):
+    # Make sure the topic and subscription get deleted.
+    cleanup.append((publisher.delete_topic, topic_path))
+    cleanup.append((subscriber.delete_subscription, subscription_path))
+
+    # Create a topic.
+    publisher.create_topic(topic_path)
+
+    # Subscribe to the topic. This must happen before the messages
+    # are published.
+    subscriber.create_subscription(subscription_path, topic_path)
+
+    # Publish some messages.
+    futures = [
+        publisher.publish(topic_path, b"Wooooo! The claaaaaw!", num=str(index))
+        for index in six.moves.range(50)
+    ]
+
+    # Make sure the publish completes.
+    for future in futures:
+        future.result()
+
+    # Actually open the subscription and hold it open for a few seconds.
+    # The callback should process the message numbers to prove
+    # that we got everything at least once.
+    callback = AckCallback()
+    future = subscriber.subscribe(subscription_path, callback)
+    for second in six.moves.range(10):
+        time.sleep(1)
+
+        # The callback should have fired at least fifty times, but it
+        # may take some time.
+        if callback.calls >= 50:
+            return
+
+    # Okay, we took too long; fail out.
+    assert callback.calls >= 50
+
+    future.cancel()
+
+
+def test_subscribe_to_messages_async_callbacks(
+    publisher, topic_path, subscriber, subscription_path, cleanup
+):
+    # Make sure the topic and subscription get deleted.
+    cleanup.append((publisher.delete_topic, topic_path))
+    cleanup.append((subscriber.delete_subscription, subscription_path))
+
+    # Create a topic.
+    publisher.create_topic(topic_path)
+
+    # Subscribe to the topic. This must happen before the messages
+    # are published.
+    subscriber.create_subscription(subscription_path, topic_path)
+
+    # Publish some messages.
+    futures = [
+        publisher.publish(topic_path, b"Wooooo! The claaaaaw!", num=str(index))
+        for index in six.moves.range(2)
+    ]
+
+    # Make sure the publish completes.
+    for future in futures:
+        future.result()
+
+    # We want to make sure that the callback was called asynchronously. So
+    # track when each call happened and make sure below.
+    callback = TimesCallback(2)
+
+    # Actually open the subscription and hold it open for a few seconds.
+    future = subscriber.subscribe(subscription_path, callback)
+    for second in six.moves.range(5):
+        time.sleep(4)
+
+        # The callback should have fired at least two times, but it may
+        # take some time.
+        if callback.calls >= 2:
+            first, last = sorted(callback.call_times[:2])
+            diff = last - first
+            # "Ensure" the first two callbacks were executed asynchronously
+            # (sequentially would have resulted in a difference of 2+
+            # seconds).
+            assert diff.days == 0
+            assert diff.seconds < callback.sleep_time
+
+    # Okay, we took too long; fail out.
+    assert callback.calls >= 2
+
+    future.cancel()
+
+
+def test_creating_subscriptions_with_non_default_settings(
+    publisher, subscriber, project, topic_path, subscription_path, cleanup
+):
+    # Make sure the topic and subscription get deleted.
+    cleanup.append((publisher.delete_topic, topic_path))
+    cleanup.append((subscriber.delete_subscription, subscription_path))
+
+    # create a topic and a subscription, customize the latter's policy
+    publisher.create_topic(topic_path)
+
+    msg_retention_duration = {"seconds": 911}
+    expiration_policy = {"ttl": {"seconds": 90210}}
+    new_subscription = subscriber.create_subscription(
+        subscription_path,
+        topic_path,
+        ack_deadline_seconds=30,
+        retain_acked_messages=True,
+        message_retention_duration=msg_retention_duration,
+        expiration_policy=expiration_policy,
+    )
+
+    # fetch the subscription and check its settings
+    project_path = subscriber.project_path(project)
+    subscriptions = subscriber.list_subscriptions(project_path)
+
+    subscriptions = [sub for sub in subscriptions if sub.topic == topic_path]
+    assert len(subscriptions) == 1
+    subscription = subscriptions[0]
+
+    assert subscription == new_subscription
+    assert subscription.ack_deadline_seconds == 30
+    assert subscription.retain_acked_messages
+    assert subscription.message_retention_duration.seconds == 911
+    assert subscription.expiration_policy.ttl.seconds == 90210
+
+
+def test_listing_project_topics(publisher, project, cleanup):
+    topic_paths = [
+        publisher.topic_path(project, "topic-{}".format(i) + unique_resource_id("."))
+        for i in range(1, 4)
+    ]
+    for topic in topic_paths:
+        cleanup.append((publisher.delete_topic, topic))
+        publisher.create_topic(topic)
+
+    project_path = publisher.project_path(project)
+    project_topics = publisher.list_topics(project_path)
+    project_topics = set(t.name for t in project_topics)
+
+    # there might be other topics in the project, thus do a "is subset" check
+    assert set(topic_paths) <= project_topics
+
+
+def test_listing_project_subscriptions(publisher, subscriber, project, cleanup):
+    # create topics
+    topic_paths = [
+        publisher.topic_path(project, "topic-1" + unique_resource_id(".")),
+        publisher.topic_path(project, "topic-2" + unique_resource_id(".")),
+    ]
+    for topic in topic_paths:
+        cleanup.append((publisher.delete_topic, topic))
+        publisher.create_topic(topic)
+
+    # create subscriptions
+    subscription_paths = [
+        subscriber.subscription_path(
+            project, "sub-{}".format(i) + unique_resource_id(".")
+        )
+        for i in range(1, 4)
+    ]
+    for i, subscription in enumerate(subscription_paths):
+        topic = topic_paths[i % 2]
+        cleanup.append((subscriber.delete_subscription, subscription))
+        subscriber.create_subscription(subscription, topic)
+
+    # retrieve subscriptions and check that the list matches the expected
+    project_path = subscriber.project_path(project)
+    subscriptions = subscriber.list_subscriptions(project_path)
+    subscriptions = set(s.name for s in subscriptions)
+
+    # there might be other subscriptions in the project, thus do a "is subset" check
+    assert set(subscription_paths) <= subscriptions
+
+
+def test_listing_topic_subscriptions(publisher, subscriber, project, cleanup):
+    # create topics
+    topic_paths = [
+        publisher.topic_path(project, "topic-1" + unique_resource_id(".")),
+        publisher.topic_path(project, "topic-2" + unique_resource_id(".")),
+    ]
+    for topic in topic_paths:
+        cleanup.append((publisher.delete_topic, topic))
+        publisher.create_topic(topic)
+
+    # create subscriptions
+    subscription_paths = [
+        subscriber.subscription_path(
+            project, "sub-{}".format(i) + unique_resource_id(".")
+        )
+        for i in range(1, 4)
+    ]
+    for i, subscription in enumerate(subscription_paths):
+        topic = topic_paths[i % 2]
+        cleanup.append((subscriber.delete_subscription, subscription))
+        subscriber.create_subscription(subscription, topic)
+
+    # retrieve subscriptions and check that the list matches the expected
+    subscriptions = publisher.list_topic_subscriptions(topic_paths[0])
+    subscriptions = set(subscriptions)
+
+    assert subscriptions == {subscription_paths[0], subscription_paths[2]}
+
+
+def test_managing_topic_iam_policy(publisher, topic_path, cleanup):
+    cleanup.append((publisher.delete_topic, topic_path))
+
+    # create a topic and customize its policy
+    publisher.create_topic(topic_path)
+    topic_policy = publisher.get_iam_policy(topic_path)
+
+    topic_policy.bindings.add(role="roles/pubsub.editor", members=["domain:google.com"])
+    topic_policy.bindings.add(
+        role="roles/pubsub.viewer", members=["group:cloud-logs@google.com"]
+    )
+    new_policy = publisher.set_iam_policy(topic_path, topic_policy)
+
+    # fetch the topic policy again and check its values
+    topic_policy = publisher.get_iam_policy(topic_path)
+    assert topic_policy.bindings == new_policy.bindings
+    assert len(topic_policy.bindings) == 2
+
+    bindings = sorted(topic_policy.bindings, key=op.attrgetter("role"))
+    assert bindings[0].role == "roles/pubsub.editor"
+    assert bindings[0].members == ["domain:google.com"]
+
+    assert bindings[1].role == "roles/pubsub.viewer"
+    assert bindings[1].members == ["group:cloud-logs@google.com"]
+
+
+def test_managing_subscription_iam_policy(
+    publisher, subscriber, topic_path, subscription_path, cleanup
+):
+    # Make sure the topic and subscription get deleted.
+    cleanup.append((publisher.delete_topic, topic_path))
+    cleanup.append((subscriber.delete_subscription, subscription_path))
+
+    # create a topic and a subscription, customize the latter's policy
+    publisher.create_topic(topic_path)
+    subscriber.create_subscription(subscription_path, topic_path)
+    sub_policy = subscriber.get_iam_policy(subscription_path)
+
+    sub_policy.bindings.add(role="roles/pubsub.editor", members=["domain:google.com"])
+    sub_policy.bindings.add(
+        role="roles/pubsub.viewer", members=["group:cloud-logs@google.com"]
+    )
+    new_policy = subscriber.set_iam_policy(subscription_path, sub_policy)
+
+    # fetch the subscription policy again and check its values
+    sub_policy = subscriber.get_iam_policy(subscription_path)
+    assert sub_policy.bindings == new_policy.bindings
+    assert len(sub_policy.bindings) == 2
+
+    bindings = sorted(sub_policy.bindings, key=op.attrgetter("role"))
+    assert bindings[0].role == "roles/pubsub.editor"
+    assert bindings[0].members == ["domain:google.com"]
+
+    assert bindings[1].role == "roles/pubsub.viewer"
+    assert bindings[1].members == ["group:cloud-logs@google.com"]
+
+
+class TestStreamingPull(object):
+    def test_streaming_pull_callback_error_propagation(
+        self, publisher, topic_path, subscriber, subscription_path, cleanup
+    ):
+        # Make sure the topic and subscription get deleted.
+        cleanup.append((publisher.delete_topic, topic_path))
+        cleanup.append((subscriber.delete_subscription, subscription_path))
+
+        # create a topic and subscribe to it
+        publisher.create_topic(topic_path)
+        subscriber.create_subscription(subscription_path, topic_path)
+
+        # publish a messages and wait until published
+        future = publisher.publish(topic_path, b"hello!")
+        future.result(timeout=30)
+
+        # Now subscribe to the topic and verify that an error in the callback
+        # is propagated through the streaming pull future.
+        class CallbackError(Exception):
+            pass
+
+        callback = mock.Mock(side_effect=CallbackError)
+        future = subscriber.subscribe(subscription_path, callback)
+
+        with pytest.raises(CallbackError):
+            future.result(timeout=30)
+
+    def test_streaming_pull_max_messages(
+        self, publisher, topic_path, subscriber, subscription_path, cleanup
+    ):
+        # Make sure the topic and subscription get deleted.
+        cleanup.append((publisher.delete_topic, topic_path))
+        cleanup.append((subscriber.delete_subscription, subscription_path))
+
+        # create a topic and subscribe to it
+        publisher.create_topic(topic_path)
+        subscriber.create_subscription(subscription_path, topic_path)
+
+        batch_sizes = (7, 4, 8, 2, 10, 1, 3, 8, 6, 1)  # total: 50
+        self._publish_messages(publisher, topic_path, batch_sizes=batch_sizes)
+
+        # now subscribe and do the main part, check for max pending messages
+        total_messages = sum(batch_sizes)
+        flow_control = types.FlowControl(max_messages=5)
+        callback = StreamingPullCallback(
+            processing_time=1, resolve_at_msg_count=total_messages
+        )
+
+        subscription_future = subscriber.subscribe(
+            subscription_path, callback, flow_control=flow_control
+        )
+
+        # Expected time to process all messages in ideal case:
+        #     (total_messages / FlowControl.max_messages) * processing_time
+        #
+        # With total=50, max messages=5, and processing_time=1 this amounts to
+        # 10 seconds (+ overhead), thus a full minute should be more than enough
+        # for the processing to complete. If not, fail the test with a timeout.
+        try:
+            callback.done_future.result(timeout=60)
+        except exceptions.TimeoutError:
+            pytest.fail(
+                "Timeout: receiving/processing streamed messages took too long."
+            )
+
+        # The callback future gets resolved once total_messages have been processed,
+        # but we want to wait for just a little bit longer to possibly catch cases
+        # when the callback gets invoked *more* than total_messages times.
+        time.sleep(3)
+
+        try:
+            # All messages should have been processed exactly once, and no more
+            # than max_messages simultaneously at any time.
+            assert callback.completed_calls == total_messages
+            assert sorted(callback.seen_message_ids) == list(
+                range(1, total_messages + 1)
+            )
+            assert callback.max_pending_ack <= flow_control.max_messages
+        finally:
+            subscription_future.cancel()  # trigger clean shutdown
+
+    def _publish_messages(self, publisher, topic_path, batch_sizes):
+        """Publish ``count`` messages in batches and wait until completion."""
+        publish_futures = []
+        msg_counter = itertools.count(start=1)
+
+        for batch_size in batch_sizes:
+            msg_batch = self._make_messages(count=batch_size)
+            for msg in msg_batch:
+                future = publisher.publish(
+                    topic_path, msg, seq_num=str(next(msg_counter))
+                )
+                publish_futures.append(future)
+            time.sleep(0.1)
+
+        # wait untill all messages have been successfully published
+        for future in publish_futures:
+            future.result(timeout=30)
+
+    def _make_messages(self, count):
+        messages = [
+            u"message {}/{}".format(i, count).encode("utf-8")
+            for i in range(1, count + 1)
+        ]
+        return messages
+
+
+class AckCallback(object):
+    def __init__(self):
+        self.calls = 0
+        self.lock = threading.Lock()
+
+    def __call__(self, message):
+        message.ack()
+        # Only increment the number of calls **after** finishing.
+        with self.lock:
+            self.calls += 1
+
+
+class TimesCallback(object):
+    def __init__(self, sleep_time):
+        self.sleep_time = sleep_time
+        self.calls = 0
+        self.call_times = []
+        self.lock = threading.Lock()
+
+    def __call__(self, message):
+        now = datetime.datetime.now()
+        time.sleep(self.sleep_time)
+        message.ack()
+        # Only increment the number of calls **after** finishing.
+        with self.lock:
+            # list.append() is thread-safe, but we still wait until
+            # ``calls`` is incremented to do it.
+            self.call_times.append(now)
+            self.calls += 1
+
+
+class StreamingPullCallback(object):
+    def __init__(self, processing_time, resolve_at_msg_count):
+        self._lock = threading.Lock()
+        self._processing_time = processing_time
+        self._pending_ack = 0
+        self.max_pending_ack = 0
+        self.completed_calls = 0
+        self.seen_message_ids = []
+
+        self._resolve_at_msg_count = resolve_at_msg_count
+        self.done_future = futures.Future()
+
+    def __call__(self, message):
+        with self._lock:
+            self._pending_ack += 1
+            self.max_pending_ack = max(self.max_pending_ack, self._pending_ack)
+            self.seen_message_ids.append(int(message.attributes["seq_num"]))
+
+        time.sleep(self._processing_time)
+
+        with self._lock:
+            self._pending_ack -= 1
+            message.ack()
+            self.completed_calls += 1
+
+            if self.completed_calls >= self._resolve_at_msg_count:
+                if not self.done_future.done():
+                    self.done_future.set_result(None)
diff --git a/pubsub/tests/system/gapic/v1/test_system_publisher_v1.py b/pubsub/tests/system/gapic/v1/test_system_publisher_v1.py
new file mode 100644
index 000000000000..9c0d2b33ad11
--- /dev/null
+++ b/pubsub/tests/system/gapic/v1/test_system_publisher_v1.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import pubsub_v1
+from google.cloud.pubsub_v1.proto import pubsub_pb2
+
+
+class TestSystemPublisher(object):
+    def test_list_topics(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = pubsub_v1.PublisherClient()
+        project = client.project_path(project_id)
+        response = client.list_topics(project)
diff --git a/pubsub/tests/unit/__init__.py b/pubsub/tests/unit/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/pubsub/tests/unit/gapic/v1/test_publisher_client_v1.py b/pubsub/tests/unit/gapic/v1/test_publisher_client_v1.py
new file mode 100644
index 000000000000..6c64cf5a9ba2
--- /dev/null
+++ b/pubsub/tests/unit/gapic/v1/test_publisher_client_v1.py
@@ -0,0 +1,478 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.pubsub_v1.gapic import publisher_client
+from google.cloud.pubsub_v1.proto import pubsub_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestPublisherClient(object):
+    def test_create_topic(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        kms_key_name = "kmsKeyName2094986649"
+        expected_response = {"name": name_2, "kms_key_name": kms_key_name}
+        expected_response = pubsub_pb2.Topic(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        name = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        response = client.create_topic(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.Topic(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_topic_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        name = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        with pytest.raises(CustomException):
+            client.create_topic(name)
+
+    def test_update_topic(self):
+        # Setup Expected Response
+        name = "name3373707"
+        kms_key_name = "kmsKeyName2094986649"
+        expected_response = {"name": name, "kms_key_name": kms_key_name}
+        expected_response = pubsub_pb2.Topic(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        topic = {}
+        update_mask = {}
+
+        response = client.update_topic(topic, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.UpdateTopicRequest(
+            topic=topic, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_topic_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        topic = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_topic(topic, update_mask)
+
+    def test_publish(self):
+        # Setup Expected Response
+        message_ids_element = "messageIdsElement-744837059"
+        message_ids = [message_ids_element]
+        expected_response = {"message_ids": message_ids}
+        expected_response = pubsub_pb2.PublishResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+        data = b"-86"
+        messages_element = {"data": data}
+        messages = [messages_element]
+
+        response = client.publish(topic, messages)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.PublishRequest(topic=topic, messages=messages)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_publish_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+        data = b"-86"
+        messages_element = {"data": data}
+        messages = [messages_element]
+
+        with pytest.raises(CustomException):
+            client.publish(topic, messages)
+
+    def test_get_topic(self):
+        # Setup Expected Response
+        name = "name3373707"
+        kms_key_name = "kmsKeyName2094986649"
+        expected_response = {"name": name, "kms_key_name": kms_key_name}
+        expected_response = pubsub_pb2.Topic(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        response = client.get_topic(topic)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.GetTopicRequest(topic=topic)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_topic_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        with pytest.raises(CustomException):
+            client.get_topic(topic)
+
+    def test_list_topics(self):
+        # Setup Expected Response
+        next_page_token = ""
+        topics_element = {}
+        topics = [topics_element]
+        expected_response = {"next_page_token": next_page_token, "topics": topics}
+        expected_response = pubsub_pb2.ListTopicsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        project = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_topics(project)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.topics[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.ListTopicsRequest(project=project)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_topics_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        project = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_topics(project)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_topic_subscriptions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        subscriptions_element = "subscriptionsElement1698708147"
+        subscriptions = [subscriptions_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "subscriptions": subscriptions,
+        }
+        expected_response = pubsub_pb2.ListTopicSubscriptionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        paged_list_response = client.list_topic_subscriptions(topic)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.subscriptions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.ListTopicSubscriptionsRequest(topic=topic)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_topic_subscriptions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        paged_list_response = client.list_topic_subscriptions(topic)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_topic(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        client.delete_topic(topic)
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.DeleteTopicRequest(topic=topic)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_topic_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        with pytest.raises(CustomException):
+            client.delete_topic(topic)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        resource = client.topic_path("[PROJECT]", "[TOPIC]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        resource = client.topic_path("[PROJECT]", "[TOPIC]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        resource = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        resource = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup Request
+        resource = client.topic_path("[PROJECT]", "[TOPIC]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = publisher_client.PublisherClient()
+
+        # Setup request
+        resource = client.topic_path("[PROJECT]", "[TOPIC]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/pubsub/tests/unit/gapic/v1/test_subscriber_client_v1.py b/pubsub/tests/unit/gapic/v1/test_subscriber_client_v1.py
new file mode 100644
index 000000000000..b1d7f52fad5f
--- /dev/null
+++ b/pubsub/tests/unit/gapic/v1/test_subscriber_client_v1.py
@@ -0,0 +1,843 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.pubsub_v1.gapic import subscriber_client
+from google.cloud.pubsub_v1.proto import pubsub_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestSubscriberClient(object):
+    def test_create_subscription(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        topic_2 = "topic2-1139259102"
+        ack_deadline_seconds = 2135351438
+        retain_acked_messages = False
+        enable_message_ordering = True
+        expected_response = {
+            "name": name_2,
+            "topic": topic_2,
+            "ack_deadline_seconds": ack_deadline_seconds,
+            "retain_acked_messages": retain_acked_messages,
+            "enable_message_ordering": enable_message_ordering,
+        }
+        expected_response = pubsub_pb2.Subscription(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        name = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        response = client.create_subscription(name, topic)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.Subscription(name=name, topic=topic)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        name = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        topic = client.topic_path("[PROJECT]", "[TOPIC]")
+
+        with pytest.raises(CustomException):
+            client.create_subscription(name, topic)
+
+    def test_get_subscription(self):
+        # Setup Expected Response
+        name = "name3373707"
+        topic = "topic110546223"
+        ack_deadline_seconds = 2135351438
+        retain_acked_messages = False
+        enable_message_ordering = True
+        expected_response = {
+            "name": name,
+            "topic": topic,
+            "ack_deadline_seconds": ack_deadline_seconds,
+            "retain_acked_messages": retain_acked_messages,
+            "enable_message_ordering": enable_message_ordering,
+        }
+        expected_response = pubsub_pb2.Subscription(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        response = client.get_subscription(subscription)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.GetSubscriptionRequest(subscription=subscription)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        with pytest.raises(CustomException):
+            client.get_subscription(subscription)
+
+    def test_update_subscription(self):
+        # Setup Expected Response
+        name = "name3373707"
+        topic = "topic110546223"
+        ack_deadline_seconds_2 = 921632575
+        retain_acked_messages = False
+        enable_message_ordering = True
+        expected_response = {
+            "name": name,
+            "topic": topic,
+            "ack_deadline_seconds": ack_deadline_seconds_2,
+            "retain_acked_messages": retain_acked_messages,
+            "enable_message_ordering": enable_message_ordering,
+        }
+        expected_response = pubsub_pb2.Subscription(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        ack_deadline_seconds = 42
+        subscription = {"ack_deadline_seconds": ack_deadline_seconds}
+        paths_element = "ack_deadline_seconds"
+        paths = [paths_element]
+        update_mask = {"paths": paths}
+
+        response = client.update_subscription(subscription, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.UpdateSubscriptionRequest(
+            subscription=subscription, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        ack_deadline_seconds = 42
+        subscription = {"ack_deadline_seconds": ack_deadline_seconds}
+        paths_element = "ack_deadline_seconds"
+        paths = [paths_element]
+        update_mask = {"paths": paths}
+
+        with pytest.raises(CustomException):
+            client.update_subscription(subscription, update_mask)
+
+    def test_list_subscriptions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        subscriptions_element = {}
+        subscriptions = [subscriptions_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "subscriptions": subscriptions,
+        }
+        expected_response = pubsub_pb2.ListSubscriptionsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        project = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_subscriptions(project)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.subscriptions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.ListSubscriptionsRequest(project=project)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_subscriptions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        project = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_subscriptions(project)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_subscription(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        client.delete_subscription(subscription)
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.DeleteSubscriptionRequest(
+            subscription=subscription
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_subscription_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        with pytest.raises(CustomException):
+            client.delete_subscription(subscription)
+
+    def test_modify_ack_deadline(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        ack_ids = []
+        ack_deadline_seconds = 2135351438
+
+        client.modify_ack_deadline(subscription, ack_ids, ack_deadline_seconds)
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.ModifyAckDeadlineRequest(
+            subscription=subscription,
+            ack_ids=ack_ids,
+            ack_deadline_seconds=ack_deadline_seconds,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_modify_ack_deadline_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        ack_ids = []
+        ack_deadline_seconds = 2135351438
+
+        with pytest.raises(CustomException):
+            client.modify_ack_deadline(subscription, ack_ids, ack_deadline_seconds)
+
+    def test_acknowledge(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        ack_ids = []
+
+        client.acknowledge(subscription, ack_ids)
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.AcknowledgeRequest(
+            subscription=subscription, ack_ids=ack_ids
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_acknowledge_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        ack_ids = []
+
+        with pytest.raises(CustomException):
+            client.acknowledge(subscription, ack_ids)
+
+    def test_pull(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = pubsub_pb2.PullResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        max_messages = 496131527
+
+        response = client.pull(subscription, max_messages)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.PullRequest(
+            subscription=subscription, max_messages=max_messages
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pull_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        max_messages = 496131527
+
+        with pytest.raises(CustomException):
+            client.pull(subscription, max_messages)
+
+    def test_streaming_pull(self):
+        # Setup Expected Response
+        received_messages_element = {}
+        received_messages = [received_messages_element]
+        expected_response = {"received_messages": received_messages}
+        expected_response = pubsub_pb2.StreamingPullResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        stream_ack_deadline_seconds = 1875467245
+        request = {
+            "subscription": subscription,
+            "stream_ack_deadline_seconds": stream_ack_deadline_seconds,
+        }
+        request = pubsub_pb2.StreamingPullRequest(**request)
+        requests = [request]
+
+        response = client.streaming_pull(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_streaming_pull_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        stream_ack_deadline_seconds = 1875467245
+        request = {
+            "subscription": subscription,
+            "stream_ack_deadline_seconds": stream_ack_deadline_seconds,
+        }
+
+        request = pubsub_pb2.StreamingPullRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.streaming_pull(requests)
+
+    def test_modify_push_config(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        push_config = {}
+
+        client.modify_push_config(subscription, push_config)
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.ModifyPushConfigRequest(
+            subscription=subscription, push_config=push_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_modify_push_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        push_config = {}
+
+        with pytest.raises(CustomException):
+            client.modify_push_config(subscription, push_config)
+
+    def test_list_snapshots(self):
+        # Setup Expected Response
+        next_page_token = ""
+        snapshots_element = {}
+        snapshots = [snapshots_element]
+        expected_response = {"next_page_token": next_page_token, "snapshots": snapshots}
+        expected_response = pubsub_pb2.ListSnapshotsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        project = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_snapshots(project)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.snapshots[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.ListSnapshotsRequest(project=project)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_snapshots_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        project = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_snapshots(project)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_snapshot(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        topic = "topic110546223"
+        expected_response = {"name": name_2, "topic": topic}
+        expected_response = pubsub_pb2.Snapshot(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        name = client.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        response = client.create_snapshot(name, subscription)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.CreateSnapshotRequest(
+            name=name, subscription=subscription
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_snapshot_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        name = client.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        with pytest.raises(CustomException):
+            client.create_snapshot(name, subscription)
+
+    def test_update_snapshot(self):
+        # Setup Expected Response
+        name = "name3373707"
+        topic = "topic110546223"
+        expected_response = {"name": name, "topic": topic}
+        expected_response = pubsub_pb2.Snapshot(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        seconds = 123456
+        expire_time = {"seconds": seconds}
+        snapshot = {"expire_time": expire_time}
+        paths_element = "expire_time"
+        paths = [paths_element]
+        update_mask = {"paths": paths}
+
+        response = client.update_snapshot(snapshot, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.UpdateSnapshotRequest(
+            snapshot=snapshot, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_snapshot_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        seconds = 123456
+        expire_time = {"seconds": seconds}
+        snapshot = {"expire_time": expire_time}
+        paths_element = "expire_time"
+        paths = [paths_element]
+        update_mask = {"paths": paths}
+
+        with pytest.raises(CustomException):
+            client.update_snapshot(snapshot, update_mask)
+
+    def test_delete_snapshot(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        snapshot = client.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+
+        client.delete_snapshot(snapshot)
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.DeleteSnapshotRequest(snapshot=snapshot)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_snapshot_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        snapshot = client.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+
+        with pytest.raises(CustomException):
+            client.delete_snapshot(snapshot)
+
+    def test_seek(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = pubsub_pb2.SeekResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        response = client.seek(subscription)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = pubsub_pb2.SeekRequest(subscription=subscription)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_seek_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        subscription = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        with pytest.raises(CustomException):
+            client.seek(subscription)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        resource = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        resource = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        resource = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        resource = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup Request
+        resource = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = subscriber_client.SubscriberClient()
+
+        # Setup request
+        resource = client.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/pubsub/tests/unit/pubsub_v1/publisher/batch/test_base.py b/pubsub/tests/unit/pubsub_v1/publisher/batch/test_base.py
new file mode 100644
index 000000000000..b19a5a1f1504
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/publisher/batch/test_base.py
@@ -0,0 +1,78 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import mock
+
+from google.auth import credentials
+from google.cloud.pubsub_v1 import publisher
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.publisher._batch.base import BatchStatus
+from google.cloud.pubsub_v1.publisher._batch.thread import Batch
+
+
+def create_batch(status=None, settings=types.BatchSettings()):
+    """Create a batch object, which does not commit.
+
+    Args:
+        status (str): If provided, the batch's internal status will be set
+            to the provided status.
+
+    Returns:
+        ~.pubsub_v1.publisher.batch.thread.Batch: The batch object
+    """
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+    batch = Batch(client, "topic_name", settings, autocommit=False)
+    if status:
+        batch._status = status
+    return batch
+
+
+def test_len():
+    batch = create_batch(status=BatchStatus.ACCEPTING_MESSAGES)
+    assert len(batch) == 0
+    batch.publish(types.PubsubMessage(data=b"foo"))
+    assert len(batch) == 1
+
+
+def test_will_accept():
+    batch = create_batch(status=BatchStatus.ACCEPTING_MESSAGES)
+    message = types.PubsubMessage()
+    assert batch.will_accept(message) is True
+
+
+def test_will_accept_oversize():
+    batch = create_batch(
+        settings=types.BatchSettings(max_bytes=10),
+        status=BatchStatus.ACCEPTING_MESSAGES,
+    )
+    message = types.PubsubMessage(data=b"abcdefghijklmnopqrstuvwxyz")
+    assert batch.will_accept(message) is True
+
+
+def test_will_not_accept_status():
+    batch = create_batch(status="talk to the hand")
+    message = types.PubsubMessage()
+    assert batch.will_accept(message) is False
+
+
+def test_will_not_accept_number():
+    batch = create_batch(
+        settings=types.BatchSettings(max_messages=-1),
+        status=BatchStatus.ACCEPTING_MESSAGES,
+    )
+    message = types.PubsubMessage(data=b"abc")
+    assert batch.will_accept(message) is False
diff --git a/pubsub/tests/unit/pubsub_v1/publisher/batch/test_thread.py b/pubsub/tests/unit/pubsub_v1/publisher/batch/test_thread.py
new file mode 100644
index 000000000000..60425e748043
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/publisher/batch/test_thread.py
@@ -0,0 +1,373 @@
+# Copyright 2017, Google LLC 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.
+
+import datetime
+import threading
+import time
+
+import mock
+import pytest
+
+import google.api_core.exceptions
+from google.auth import credentials
+from google.cloud.pubsub_v1 import publisher
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.publisher import exceptions
+from google.cloud.pubsub_v1.publisher._batch.base import BatchStatus
+from google.cloud.pubsub_v1.publisher._batch import thread
+from google.cloud.pubsub_v1.publisher._batch.thread import Batch
+
+
+def create_client():
+    creds = mock.Mock(spec=credentials.Credentials)
+    return publisher.Client(credentials=creds)
+
+
+def create_batch(autocommit=False, **batch_settings):
+    """Return a batch object suitable for testing.
+
+    Args:
+        autocommit (bool): Whether the batch should commit after
+            ``max_latency`` seconds. By default, this is ``False``
+            for unit testing.
+        batch_settings (dict): Arguments passed on to the
+            :class:``~.pubsub_v1.types.BatchSettings`` constructor.
+
+    Returns:
+        ~.pubsub_v1.publisher.batch.thread.Batch: A batch object.
+    """
+    client = create_client()
+    settings = types.BatchSettings(**batch_settings)
+    return Batch(client, "topic_name", settings, autocommit=autocommit)
+
+
+def test_init():
+    """Establish that a monitor thread is usually created on init."""
+    client = create_client()
+
+    # Do not actually create a thread, but do verify that one was created;
+    # it should be running the batch's "monitor" method (which commits the
+    # batch once time elapses).
+    with mock.patch.object(threading, "Thread", autospec=True) as Thread:
+        batch = Batch(client, "topic_name", types.BatchSettings())
+        Thread.assert_called_once_with(
+            name="Thread-MonitorBatchPublisher", target=batch.monitor
+        )
+
+    # New batches start able to accept messages by default.
+    assert batch.status == BatchStatus.ACCEPTING_MESSAGES
+
+
+def test_init_infinite_latency():
+    batch = create_batch(max_latency=float("inf"))
+    assert batch._thread is None
+
+
+@mock.patch.object(threading, "Lock")
+def test_make_lock(Lock):
+    lock = Batch.make_lock()
+    assert lock is Lock.return_value
+    Lock.assert_called_once_with()
+
+
+def test_client():
+    client = create_client()
+    settings = types.BatchSettings()
+    batch = Batch(client, "topic_name", settings, autocommit=False)
+    assert batch.client is client
+
+
+def test_commit():
+    batch = create_batch()
+    with mock.patch.object(threading, "Thread", autospec=True) as Thread:
+        batch.commit()
+
+        # A thread should have been created to do the actual commit.
+        Thread.assert_called_once_with(
+            name="Thread-CommitBatchPublisher", target=batch._commit
+        )
+        Thread.return_value.start.assert_called_once_with()
+
+    # The batch's status needs to be something other than "accepting messages",
+    # since the commit started.
+    assert batch.status != BatchStatus.ACCEPTING_MESSAGES
+    assert batch.status == BatchStatus.STARTING
+
+
+def test_commit_no_op():
+    batch = create_batch()
+    batch._status = BatchStatus.IN_PROGRESS
+    with mock.patch.object(threading, "Thread", autospec=True) as Thread:
+        batch.commit()
+
+    # Make sure a thread was not created.
+    Thread.assert_not_called()
+
+    # Check that batch status is unchanged.
+    assert batch.status == BatchStatus.IN_PROGRESS
+
+
+def test_blocking__commit():
+    batch = create_batch()
+    futures = (
+        batch.publish({"data": b"This is my message."}),
+        batch.publish({"data": b"This is another message."}),
+    )
+
+    # Set up the underlying API publish method to return a PublishResponse.
+    publish_response = types.PublishResponse(message_ids=["a", "b"])
+    patch = mock.patch.object(
+        type(batch.client.api), "publish", return_value=publish_response
+    )
+    with patch as publish:
+        batch._commit()
+
+    # Establish that the underlying API call was made with expected
+    # arguments.
+    publish.assert_called_once_with(
+        "topic_name",
+        [
+            types.PubsubMessage(data=b"This is my message."),
+            types.PubsubMessage(data=b"This is another message."),
+        ],
+    )
+
+    # Establish that all of the futures are done, and that they have the
+    # expected values.
+    assert futures[0].done()
+    assert futures[0].result() == "a"
+    assert futures[1].done()
+    assert futures[1].result() == "b"
+
+
+def test_client_api_publish_not_blocking_additional_publish_calls():
+    batch = create_batch(max_messages=1)
+    api_publish_called = threading.Event()
+
+    def api_publish_delay(_, messages):
+        api_publish_called.set()
+        time.sleep(1.0)
+        message_ids = [str(i) for i in range(len(messages))]
+        return types.PublishResponse(message_ids=message_ids)
+
+    api_publish_patch = mock.patch.object(
+        type(batch.client.api), "publish", side_effect=api_publish_delay
+    )
+
+    with api_publish_patch:
+        batch.publish({"data": b"first message"})
+
+        start = datetime.datetime.now()
+        event_set = api_publish_called.wait(timeout=1.0)
+        if not event_set:
+            pytest.fail("API publish was not called in time")
+        batch.publish({"data": b"second message"})
+        end = datetime.datetime.now()
+
+    # While a batch commit in progress, waiting for the API publish call to
+    # complete should not unnecessariliy delay other calls to batch.publish().
+    assert (end - start).total_seconds() < 1.0
+
+
+@mock.patch.object(thread, "_LOGGER")
+def test_blocking__commit_starting(_LOGGER):
+    batch = create_batch()
+    batch._status = BatchStatus.STARTING
+
+    batch._commit()
+    assert batch._status == BatchStatus.SUCCESS
+
+    _LOGGER.debug.assert_called_once_with("No messages to publish, exiting commit")
+
+
+@mock.patch.object(thread, "_LOGGER")
+def test_blocking__commit_already_started(_LOGGER):
+    batch = create_batch()
+    batch._status = BatchStatus.IN_PROGRESS
+
+    batch._commit()
+    assert batch._status == BatchStatus.IN_PROGRESS
+
+    _LOGGER.debug.assert_called_once_with(
+        "Batch is already in progress, exiting commit"
+    )
+
+
+def test_blocking__commit_no_messages():
+    batch = create_batch()
+    with mock.patch.object(type(batch.client.api), "publish") as publish:
+        batch._commit()
+
+    assert publish.call_count == 0
+
+
+def test_blocking__commit_wrong_messageid_length():
+    batch = create_batch()
+    futures = (
+        batch.publish({"data": b"blah blah blah"}),
+        batch.publish({"data": b"blah blah blah blah"}),
+    )
+
+    # Set up a PublishResponse that only returns one message ID.
+    publish_response = types.PublishResponse(message_ids=["a"])
+    patch = mock.patch.object(
+        type(batch.client.api), "publish", return_value=publish_response
+    )
+
+    with patch:
+        batch._commit()
+
+    for future in futures:
+        assert future.done()
+        assert isinstance(future.exception(), exceptions.PublishError)
+
+
+def test_block__commmit_api_error():
+    batch = create_batch()
+    futures = (
+        batch.publish({"data": b"blah blah blah"}),
+        batch.publish({"data": b"blah blah blah blah"}),
+    )
+
+    # Make the API throw an error when publishing.
+    error = google.api_core.exceptions.InternalServerError("uh oh")
+    patch = mock.patch.object(type(batch.client.api), "publish", side_effect=error)
+
+    with patch:
+        batch._commit()
+
+    for future in futures:
+        assert future.done()
+        assert future.exception() == error
+
+
+def test_block__commmit_retry_error():
+    batch = create_batch()
+    futures = (
+        batch.publish({"data": b"blah blah blah"}),
+        batch.publish({"data": b"blah blah blah blah"}),
+    )
+
+    # Make the API throw an error when publishing.
+    error = google.api_core.exceptions.RetryError("uh oh", None)
+    patch = mock.patch.object(type(batch.client.api), "publish", side_effect=error)
+
+    with patch:
+        batch._commit()
+
+    for future in futures:
+        assert future.done()
+        assert future.exception() == error
+
+
+def test_monitor():
+    batch = create_batch(max_latency=5.0)
+    with mock.patch.object(time, "sleep") as sleep:
+        with mock.patch.object(type(batch), "_commit") as _commit:
+            batch.monitor()
+
+    # The monitor should have waited the given latency.
+    sleep.assert_called_once_with(5.0)
+
+    # Since `monitor` runs in its own thread, it should call
+    # the blocking commit implementation.
+    _commit.assert_called_once_with()
+
+
+def test_monitor_already_committed():
+    batch = create_batch(max_latency=5.0)
+    status = "something else"
+    batch._status = status
+    with mock.patch.object(time, "sleep") as sleep:
+        batch.monitor()
+
+    # The monitor should have waited the given latency.
+    sleep.assert_called_once_with(5.0)
+
+    # The status should not have changed.
+    assert batch._status == status
+
+
+def test_publish():
+    batch = create_batch()
+    messages = (
+        types.PubsubMessage(data=b"foobarbaz"),
+        types.PubsubMessage(data=b"spameggs"),
+        types.PubsubMessage(data=b"1335020400"),
+    )
+
+    # Publish each of the messages, which should save them to the batch.
+    futures = [batch.publish(message) for message in messages]
+
+    # There should be three messages on the batch, and three futures.
+    assert len(batch.messages) == 3
+    assert batch._futures == futures
+
+    # The size should have been incremented by the sum of the size of the
+    # messages.
+    expected_size = sum([message_pb.ByteSize() for message_pb in messages])
+    assert batch.size == expected_size
+    assert batch.size > 0  # I do not always trust protobuf.
+
+
+def test_publish_not_will_accept():
+    batch = create_batch(max_messages=0)
+
+    # Publish the message.
+    message = types.PubsubMessage(data=b"foobarbaz")
+    future = batch.publish(message)
+
+    assert future is None
+    assert batch.size == 0
+    assert batch.messages == []
+    assert batch._futures == []
+
+
+def test_publish_exceed_max_messages():
+    max_messages = 4
+    batch = create_batch(max_messages=max_messages)
+    messages = (
+        types.PubsubMessage(data=b"foobarbaz"),
+        types.PubsubMessage(data=b"spameggs"),
+        types.PubsubMessage(data=b"1335020400"),
+    )
+
+    # Publish each of the messages, which should save them to the batch.
+    with mock.patch.object(batch, "commit") as commit:
+        futures = [batch.publish(message) for message in messages]
+        assert batch._futures == futures
+        assert len(futures) == max_messages - 1
+
+        # Commit should not yet have been called.
+        assert commit.call_count == 0
+
+        # When a fourth message is published, commit should be called.
+        # No future will be returned in this case.
+        future = batch.publish(types.PubsubMessage(data=b"last one"))
+        commit.assert_called_once_with()
+
+        assert future is None
+        assert batch._futures == futures
+
+
+def test_publish_dict():
+    batch = create_batch()
+    future = batch.publish({"data": b"foobarbaz", "attributes": {"spam": "eggs"}})
+
+    # There should be one message on the batch.
+    expected_message = types.PubsubMessage(
+        data=b"foobarbaz", attributes={"spam": "eggs"}
+    )
+    assert batch.messages == [expected_message]
+    assert batch._futures == [future]
diff --git a/pubsub/tests/unit/pubsub_v1/publisher/test_futures_publisher.py b/pubsub/tests/unit/pubsub_v1/publisher/test_futures_publisher.py
new file mode 100644
index 000000000000..eb32d05185b6
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/publisher/test_futures_publisher.py
@@ -0,0 +1,32 @@
+# Copyright 2019, Google LLC 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.
+
+from __future__ import absolute_import
+
+import pytest
+
+from google.cloud.pubsub_v1.publisher import futures
+
+
+class TestFuture(object):
+    def test_result_on_success(self):
+        future = futures.Future()
+        future.set_result("570307942214048")
+        assert future.result() == "570307942214048"
+
+    def test_result_on_failure(self):
+        future = futures.Future()
+        future.set_exception(RuntimeError("Something bad happened."))
+        with pytest.raises(RuntimeError):
+            future.result()
diff --git a/pubsub/tests/unit/pubsub_v1/publisher/test_publisher_client.py b/pubsub/tests/unit/pubsub_v1/publisher/test_publisher_client.py
new file mode 100644
index 000000000000..05e4c8c67209
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/publisher/test_publisher_client.py
@@ -0,0 +1,237 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.auth import credentials
+
+import mock
+import pytest
+
+from google.cloud.pubsub_v1.gapic import publisher_client
+from google.cloud.pubsub_v1 import publisher
+from google.cloud.pubsub_v1 import types
+
+
+def test_init():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    # A plain client should have an `api` (the underlying GAPIC) and a
+    # batch settings object, which should have the defaults.
+    assert isinstance(client.api, publisher_client.PublisherClient)
+    assert client.batch_settings.max_bytes == 10 * 1000 * 1000
+    assert client.batch_settings.max_latency == 0.05
+    assert client.batch_settings.max_messages == 1000
+
+
+def test_init_w_custom_transport():
+    transport = object()
+    client = publisher.Client(transport=transport)
+
+    # A plain client should have an `api` (the underlying GAPIC) and a
+    # batch settings object, which should have the defaults.
+    assert isinstance(client.api, publisher_client.PublisherClient)
+    assert client.api.transport is transport
+    assert client.batch_settings.max_bytes == 10 * 1000 * 1000
+    assert client.batch_settings.max_latency == 0.05
+    assert client.batch_settings.max_messages == 1000
+
+
+def test_init_emulator(monkeypatch):
+    monkeypatch.setenv("PUBSUB_EMULATOR_HOST", "/foo/bar/")
+    # NOTE: When the emulator host is set, a custom channel will be used, so
+    #       no credentials (mock ot otherwise) can be passed in.
+    client = publisher.Client()
+
+    # Establish that a gRPC request would attempt to hit the emulator host.
+    #
+    # Sadly, there seems to be no good way to do this without poking at
+    # the private API of gRPC.
+    channel = client.api.transport.publish._channel
+    assert channel.target().decode("utf8") == "/foo/bar/"
+
+
+def test_batch_create():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    assert len(client._batches) == 0
+    topic = "topic/path"
+    batch = client._batch(topic, autocommit=False)
+    assert client._batches == {topic: batch}
+
+
+def test_batch_exists():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    topic = "topic/path"
+    client._batches[topic] = mock.sentinel.batch
+
+    # A subsequent request should return the same batch.
+    batch = client._batch(topic, autocommit=False)
+    assert batch is mock.sentinel.batch
+    assert client._batches == {topic: batch}
+
+
+def test_batch_create_and_exists():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    topic = "topic/path"
+    client._batches[topic] = mock.sentinel.batch
+
+    # A subsequent request should return the same batch.
+    batch = client._batch(topic, create=True, autocommit=False)
+    assert batch is not mock.sentinel.batch
+    assert client._batches == {topic: batch}
+
+
+def test_publish():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    # Use a mock in lieu of the actual batch class.
+    batch = mock.Mock(spec=client._batch_class)
+    # Set the mock up to claim indiscriminately that it accepts all messages.
+    batch.will_accept.return_value = True
+    batch.publish.side_effect = (mock.sentinel.future1, mock.sentinel.future2)
+
+    topic = "topic/path"
+    client._batches[topic] = batch
+
+    # Begin publishing.
+    future1 = client.publish(topic, b"spam")
+    future2 = client.publish(topic, b"foo", bar="baz")
+
+    assert future1 is mock.sentinel.future1
+    assert future2 is mock.sentinel.future2
+
+    # Check mock.
+    batch.publish.assert_has_calls(
+        [
+            mock.call(types.PubsubMessage(data=b"spam")),
+            mock.call(types.PubsubMessage(data=b"foo", attributes={"bar": "baz"})),
+        ]
+    )
+
+
+def test_publish_data_not_bytestring_error():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+    topic = "topic/path"
+    with pytest.raises(TypeError):
+        client.publish(topic, u"This is a text string.")
+    with pytest.raises(TypeError):
+        client.publish(topic, 42)
+
+
+def test_publish_attrs_bytestring():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    # Use a mock in lieu of the actual batch class.
+    batch = mock.Mock(spec=client._batch_class)
+    # Set the mock up to claim indiscriminately that it accepts all messages.
+    batch.will_accept.return_value = True
+
+    topic = "topic/path"
+    client._batches[topic] = batch
+
+    # Begin publishing.
+    future = client.publish(topic, b"foo", bar=b"baz")
+
+    assert future is batch.publish.return_value
+
+    # The attributes should have been sent as text.
+    batch.publish.assert_called_once_with(
+        types.PubsubMessage(data=b"foo", attributes={"bar": u"baz"})
+    )
+
+
+def test_publish_new_batch_needed():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    # Use mocks in lieu of the actual batch class.
+    batch1 = mock.Mock(spec=client._batch_class)
+    batch2 = mock.Mock(spec=client._batch_class)
+    # Set the first mock up to claim indiscriminately that it rejects all
+    # messages and the second accepts all.
+    batch1.publish.return_value = None
+    batch2.publish.return_value = mock.sentinel.future
+
+    topic = "topic/path"
+    client._batches[topic] = batch1
+
+    # Actually mock the batch class now.
+    batch_class = mock.Mock(spec=(), return_value=batch2)
+    client._batch_class = batch_class
+
+    # Publish a message.
+    future = client.publish(topic, b"foo", bar=b"baz")
+    assert future is mock.sentinel.future
+
+    # Check the mocks.
+    batch_class.assert_called_once_with(
+        autocommit=True, client=client, settings=client.batch_settings, topic=topic
+    )
+    message_pb = types.PubsubMessage(data=b"foo", attributes={"bar": u"baz"})
+    batch1.publish.assert_called_once_with(message_pb)
+    batch2.publish.assert_called_once_with(message_pb)
+
+
+def test_publish_attrs_type_error():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+    topic = "topic/path"
+    with pytest.raises(TypeError):
+        client.publish(topic, b"foo", answer=42)
+
+
+def test_gapic_instance_method():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+
+    ct = mock.Mock()
+    client.api._inner_api_calls["create_topic"] = ct
+
+    client.create_topic("projects/foo/topics/bar")
+    assert ct.call_count == 1
+    _, args, _ = ct.mock_calls[0]
+    assert args[0] == types.Topic(name="projects/foo/topics/bar")
+
+
+def test_gapic_class_method_on_class():
+    answer = publisher.Client.topic_path("foo", "bar")
+    assert answer == "projects/foo/topics/bar"
+
+
+def test_class_method_factory():
+    patch = mock.patch(
+        "google.oauth2.service_account.Credentials.from_service_account_file"
+    )
+
+    with patch:
+        client = publisher.Client.from_service_account_file("filename.json")
+
+    assert isinstance(client, publisher.Client)
+
+
+def test_gapic_class_method_on_instance():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = publisher.Client(credentials=creds)
+    answer = client.topic_path("foo", "bar")
+    assert answer == "projects/foo/topics/bar"
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_dispatcher.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_dispatcher.py
new file mode 100644
index 000000000000..0e1e9744f6d9
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_dispatcher.py
@@ -0,0 +1,204 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import threading
+
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.subscriber._protocol import dispatcher
+from google.cloud.pubsub_v1.subscriber._protocol import helper_threads
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+from google.cloud.pubsub_v1.subscriber._protocol import streaming_pull_manager
+
+import mock
+from six.moves import queue
+import pytest
+
+
+@pytest.mark.parametrize(
+    "item,method_name",
+    [
+        (requests.AckRequest(0, 0, 0), "ack"),
+        (requests.DropRequest(0, 0), "drop"),
+        (requests.LeaseRequest(0, 0), "lease"),
+        (requests.ModAckRequest(0, 0), "modify_ack_deadline"),
+        (requests.NackRequest(0, 0), "nack"),
+    ],
+)
+def test_dispatch_callback(item, method_name):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [item]
+
+    with mock.patch.object(dispatcher_, method_name) as method:
+        dispatcher_.dispatch_callback(items)
+
+    method.assert_called_once_with([item])
+
+
+def test_dispatch_callback_inactive():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    manager.is_active = False
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    dispatcher_.dispatch_callback([requests.AckRequest(0, 0, 0)])
+
+    manager.send.assert_not_called()
+
+
+def test_ack():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [requests.AckRequest(ack_id="ack_id_string", byte_size=0, time_to_ack=20)]
+    dispatcher_.ack(items)
+
+    manager.send.assert_called_once_with(
+        types.StreamingPullRequest(ack_ids=["ack_id_string"])
+    )
+
+    manager.leaser.remove.assert_called_once_with(items)
+    manager.maybe_resume_consumer.assert_called_once()
+    manager.ack_histogram.add.assert_called_once_with(20)
+
+
+def test_ack_no_time():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [requests.AckRequest(ack_id="ack_id_string", byte_size=0, time_to_ack=None)]
+    dispatcher_.ack(items)
+
+    manager.send.assert_called_once_with(
+        types.StreamingPullRequest(ack_ids=["ack_id_string"])
+    )
+
+    manager.ack_histogram.add.assert_not_called()
+
+
+def test_lease():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [requests.LeaseRequest(ack_id="ack_id_string", byte_size=10)]
+    dispatcher_.lease(items)
+
+    manager.leaser.add.assert_called_once_with(items)
+    manager.maybe_pause_consumer.assert_called_once()
+
+
+def test_drop():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [requests.DropRequest(ack_id="ack_id_string", byte_size=10)]
+    dispatcher_.drop(items)
+
+    manager.leaser.remove.assert_called_once_with(items)
+    manager.maybe_resume_consumer.assert_called_once()
+
+
+def test_nack():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [requests.NackRequest(ack_id="ack_id_string", byte_size=10)]
+    dispatcher_.nack(items)
+
+    manager.send.assert_called_once_with(
+        types.StreamingPullRequest(
+            modify_deadline_ack_ids=["ack_id_string"], modify_deadline_seconds=[0]
+        )
+    )
+
+
+def test_modify_ack_deadline():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    items = [requests.ModAckRequest(ack_id="ack_id_string", seconds=60)]
+    dispatcher_.modify_ack_deadline(items)
+
+    manager.send.assert_called_once_with(
+        types.StreamingPullRequest(
+            modify_deadline_ack_ids=["ack_id_string"], modify_deadline_seconds=[60]
+        )
+    )
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start(thread):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+
+    dispatcher_.start()
+
+    thread.assert_called_once_with(
+        name=dispatcher._CALLBACK_WORKER_NAME, target=mock.ANY
+    )
+
+    thread.return_value.start.assert_called_once()
+
+    assert dispatcher_._thread is not None
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start_already_started(thread):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    dispatcher_ = dispatcher.Dispatcher(manager, mock.sentinel.queue)
+    dispatcher_._thread = mock.sentinel.thread
+
+    with pytest.raises(ValueError):
+        dispatcher_.start()
+
+    thread.assert_not_called()
+
+
+def test_stop():
+    queue_ = queue.Queue()
+    dispatcher_ = dispatcher.Dispatcher(mock.sentinel.manager, queue_)
+    thread = mock.create_autospec(threading.Thread, instance=True)
+    dispatcher_._thread = thread
+
+    dispatcher_.stop()
+
+    assert queue_.get() is helper_threads.STOP
+    thread.join.assert_called_once()
+    assert dispatcher_._thread is None
+
+
+def test_stop_no_join():
+    dispatcher_ = dispatcher.Dispatcher(mock.sentinel.manager, mock.sentinel.queue)
+
+    dispatcher_.stop()
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_futures_subscriber.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_futures_subscriber.py
new file mode 100644
index 000000000000..2b4566018f7f
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_futures_subscriber.py
@@ -0,0 +1,66 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import mock
+import pytest
+
+from google.cloud.pubsub_v1.subscriber import futures
+from google.cloud.pubsub_v1.subscriber._protocol import streaming_pull_manager
+
+
+class TestStreamingPullFuture(object):
+    def make_future(self):
+        manager = mock.create_autospec(
+            streaming_pull_manager.StreamingPullManager, instance=True
+        )
+        future = futures.StreamingPullFuture(manager)
+        return future
+
+    def test_default_state(self):
+        future = self.make_future()
+
+        assert future.running()
+        assert not future.done()
+        assert not future.cancelled()
+        future._manager.add_close_callback.assert_called_once_with(
+            future._on_close_callback
+        )
+
+    def test__on_close_callback_success(self):
+        future = self.make_future()
+
+        future._on_close_callback(mock.sentinel.manager, None)
+
+        assert future.result() is True
+        assert not future.running()
+
+    def test__on_close_callback_failure(self):
+        future = self.make_future()
+
+        future._on_close_callback(mock.sentinel.manager, ValueError("meep"))
+
+        with pytest.raises(ValueError):
+            future.result()
+
+        assert not future.running()
+
+    def test_cancel(self):
+        future = self.make_future()
+
+        future.cancel()
+
+        future._manager.close.assert_called_once()
+        assert future.cancelled()
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_heartbeater.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_heartbeater.py
new file mode 100644
index 000000000000..8f5049691a9d
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_heartbeater.py
@@ -0,0 +1,125 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import threading
+
+from google.cloud.pubsub_v1.subscriber._protocol import heartbeater
+from google.cloud.pubsub_v1.subscriber._protocol import streaming_pull_manager
+
+import mock
+import pytest
+
+
+def test_heartbeat_inactive(caplog):
+    caplog.set_level(logging.INFO)
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    manager.is_active = False
+
+    heartbeater_ = heartbeater.Heartbeater(manager)
+
+    heartbeater_.heartbeat()
+
+    assert "exiting" in caplog.text
+
+
+def test_heartbeat_stopped(caplog):
+    caplog.set_level(logging.INFO)
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+
+    heartbeater_ = heartbeater.Heartbeater(manager)
+    heartbeater_.stop()
+
+    heartbeater_.heartbeat()
+
+    assert "exiting" in caplog.text
+
+
+def make_sleep_mark_manager_as_inactive(heartbeater):
+    # Make sleep mark the manager as inactive so that heartbeat()
+    # exits at the end of the first run.
+    def trigger_inactive(timeout):
+        assert timeout
+        heartbeater._manager.is_active = False
+
+    heartbeater._stop_event.wait = trigger_inactive
+
+
+def test_heartbeat_once():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    heartbeater_ = heartbeater.Heartbeater(manager)
+    make_sleep_mark_manager_as_inactive(heartbeater_)
+
+    heartbeater_.heartbeat()
+
+    manager.heartbeat.assert_called_once()
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start(thread):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    heartbeater_ = heartbeater.Heartbeater(manager)
+
+    heartbeater_.start()
+
+    thread.assert_called_once_with(
+        name=heartbeater._HEARTBEAT_WORKER_NAME, target=heartbeater_.heartbeat
+    )
+
+    thread.return_value.start.assert_called_once()
+
+    assert heartbeater_._thread is not None
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start_already_started(thread):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    heartbeater_ = heartbeater.Heartbeater(manager)
+    heartbeater_._thread = mock.sentinel.thread
+
+    with pytest.raises(ValueError):
+        heartbeater_.start()
+
+    thread.assert_not_called()
+
+
+def test_stop():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    heartbeater_ = heartbeater.Heartbeater(manager)
+    thread = mock.create_autospec(threading.Thread, instance=True)
+    heartbeater_._thread = thread
+
+    heartbeater_.stop()
+
+    assert heartbeater_._stop_event.is_set()
+    thread.join.assert_called_once()
+    assert heartbeater_._thread is None
+
+
+def test_stop_no_join():
+    heartbeater_ = heartbeater.Heartbeater(mock.sentinel.manager)
+
+    heartbeater_.stop()
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_helper_threads.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_helper_threads.py
new file mode 100644
index 000000000000..6e1bcc813c89
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_helper_threads.py
@@ -0,0 +1,118 @@
+# Copyright 2017, Google LLC 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.
+
+import mock
+from six.moves import queue
+
+from google.cloud.pubsub_v1.subscriber._protocol import helper_threads
+
+
+def test_queue_callback_worker():
+    queue_ = queue.Queue()
+    callback = mock.Mock(spec=())
+    qct = helper_threads.QueueCallbackWorker(queue_, callback)
+
+    # Set up an appropriate mock for the queue, and call the queue callback
+    # thread.
+    with mock.patch.object(queue.Queue, "get") as get:
+        get.side_effect = (mock.sentinel.A, helper_threads.STOP, queue.Empty())
+        qct()
+
+        # Assert that we got the expected calls.
+        assert get.call_count == 3
+        callback.assert_called_once_with([mock.sentinel.A])
+
+
+def test_queue_callback_worker_stop_with_extra_items():
+    queue_ = queue.Queue()
+    callback = mock.Mock(spec=())
+    qct = helper_threads.QueueCallbackWorker(queue_, callback)
+
+    # Set up an appropriate mock for the queue, and call the queue callback
+    # thread.
+    with mock.patch.object(queue.Queue, "get") as get:
+        get.side_effect = (
+            mock.sentinel.A,
+            helper_threads.STOP,
+            mock.sentinel.B,
+            queue.Empty(),
+        )
+        qct()
+
+        # Assert that we got the expected calls.
+        assert get.call_count == 4
+        callback.assert_called_once_with([mock.sentinel.A])
+
+
+def test_queue_callback_worker_get_many():
+    queue_ = queue.Queue()
+    callback = mock.Mock(spec=())
+    qct = helper_threads.QueueCallbackWorker(queue_, callback)
+
+    # Set up an appropriate mock for the queue, and call the queue callback
+    # thread.
+    with mock.patch.object(queue.Queue, "get") as get:
+        get.side_effect = (
+            mock.sentinel.A,
+            queue.Empty(),
+            mock.sentinel.B,
+            helper_threads.STOP,
+            queue.Empty(),
+        )
+        qct()
+
+        # Assert that we got the expected calls.
+        assert get.call_count == 5
+        callback.assert_has_calls(
+            [mock.call([(mock.sentinel.A)]), mock.call([(mock.sentinel.B)])]
+        )
+
+
+def test_queue_callback_worker_max_items():
+    queue_ = queue.Queue()
+    callback = mock.Mock(spec=())
+    qct = helper_threads.QueueCallbackWorker(queue_, callback, max_items=1)
+
+    # Set up an appropriate mock for the queue, and call the queue callback
+    # thread.
+    with mock.patch.object(queue.Queue, "get") as get:
+        get.side_effect = (
+            mock.sentinel.A,
+            mock.sentinel.B,
+            helper_threads.STOP,
+            queue.Empty(),
+        )
+        qct()
+
+        # Assert that we got the expected calls.
+        assert get.call_count == 3
+        callback.assert_has_calls(
+            [mock.call([(mock.sentinel.A)]), mock.call([(mock.sentinel.B)])]
+        )
+
+
+def test_queue_callback_worker_exception():
+    queue_ = queue.Queue()
+    callback = mock.Mock(spec=(), side_effect=(Exception,))
+    qct = helper_threads.QueueCallbackWorker(queue_, callback)
+
+    # Set up an appropriate mock for the queue, and call the queue callback
+    # thread.
+    with mock.patch.object(queue.Queue, "get") as get:
+        get.side_effect = (mock.sentinel.A, helper_threads.STOP, queue.Empty())
+        qct()
+
+        # Assert that we got the expected calls.
+        assert get.call_count == 3
+        callback.assert_called_once_with([mock.sentinel.A])
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_histogram.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_histogram.py
new file mode 100644
index 000000000000..d3c15cdcee9c
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_histogram.py
@@ -0,0 +1,84 @@
+# Copyright 2017, Google LLC 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.
+
+from google.cloud.pubsub_v1.subscriber._protocol import histogram
+
+
+def test_init():
+    data = {}
+    histo = histogram.Histogram(data=data)
+    assert histo._data is data
+    assert len(histo) == 0
+
+
+def test_contains():
+    histo = histogram.Histogram()
+    histo.add(10)
+    histo.add(20)
+    assert 10 in histo
+    assert 20 in histo
+    assert 30 not in histo
+
+
+def test_max():
+    histo = histogram.Histogram()
+    assert histo.max == 600
+    histo.add(120)
+    assert histo.max == 120
+    histo.add(150)
+    assert histo.max == 150
+    histo.add(20)
+    assert histo.max == 150
+
+
+def test_min():
+    histo = histogram.Histogram()
+    assert histo.min == 10
+    histo.add(60)
+    assert histo.min == 60
+    histo.add(30)
+    assert histo.min == 30
+    histo.add(120)
+    assert histo.min == 30
+
+
+def test_add():
+    histo = histogram.Histogram()
+    histo.add(60)
+    assert histo._data[60] == 1
+    histo.add(60)
+    assert histo._data[60] == 2
+
+
+def test_add_lower_limit():
+    histo = histogram.Histogram()
+    histo.add(5)
+    assert 5 not in histo
+    assert 10 in histo
+
+
+def test_add_upper_limit():
+    histo = histogram.Histogram()
+    histo.add(12000)
+    assert 12000 not in histo
+    assert 600 in histo
+
+
+def test_percentile():
+    histo = histogram.Histogram()
+    [histo.add(i) for i in range(101, 201)]
+    assert histo.percentile(100) == 200
+    assert histo.percentile(101) == 200
+    assert histo.percentile(99) == 199
+    assert histo.percentile(1) == 101
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_leaser.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_leaser.py
new file mode 100644
index 000000000000..c8b217473d40
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_leaser.py
@@ -0,0 +1,225 @@
+# Copyright 2017, Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import threading
+
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.subscriber._protocol import dispatcher
+from google.cloud.pubsub_v1.subscriber._protocol import histogram
+from google.cloud.pubsub_v1.subscriber._protocol import leaser
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+from google.cloud.pubsub_v1.subscriber._protocol import streaming_pull_manager
+
+import mock
+import pytest
+
+
+def test_add_and_remove():
+    leaser_ = leaser.Leaser(mock.sentinel.manager)
+
+    leaser_.add([requests.LeaseRequest(ack_id="ack1", byte_size=50)])
+    leaser_.add([requests.LeaseRequest(ack_id="ack2", byte_size=25)])
+
+    assert leaser_.message_count == 2
+    assert set(leaser_.ack_ids) == set(["ack1", "ack2"])
+    assert leaser_.bytes == 75
+
+    leaser_.remove([requests.DropRequest(ack_id="ack1", byte_size=50)])
+
+    assert leaser_.message_count == 1
+    assert set(leaser_.ack_ids) == set(["ack2"])
+    assert leaser_.bytes == 25
+
+
+def test_add_already_managed(caplog):
+    caplog.set_level(logging.DEBUG)
+
+    leaser_ = leaser.Leaser(mock.sentinel.manager)
+
+    leaser_.add([requests.LeaseRequest(ack_id="ack1", byte_size=50)])
+    leaser_.add([requests.LeaseRequest(ack_id="ack1", byte_size=50)])
+
+    assert "already lease managed" in caplog.text
+
+
+def test_remove_not_managed(caplog):
+    caplog.set_level(logging.DEBUG)
+
+    leaser_ = leaser.Leaser(mock.sentinel.manager)
+
+    leaser_.remove([requests.DropRequest(ack_id="ack1", byte_size=50)])
+
+    assert "not managed" in caplog.text
+
+
+def test_remove_negative_bytes(caplog):
+    caplog.set_level(logging.DEBUG)
+
+    leaser_ = leaser.Leaser(mock.sentinel.manager)
+
+    leaser_.add([requests.LeaseRequest(ack_id="ack1", byte_size=50)])
+    leaser_.remove([requests.DropRequest(ack_id="ack1", byte_size=75)])
+
+    assert leaser_.bytes == 0
+    assert "unexpectedly negative" in caplog.text
+
+
+def create_manager(flow_control=types.FlowControl()):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    manager.dispatcher = mock.create_autospec(dispatcher.Dispatcher, instance=True)
+    manager.is_active = True
+    manager.flow_control = flow_control
+    manager.ack_histogram = histogram.Histogram()
+    return manager
+
+
+def test_maintain_leases_inactive(caplog):
+    caplog.set_level(logging.INFO)
+    manager = create_manager()
+    manager.is_active = False
+
+    leaser_ = leaser.Leaser(manager)
+
+    leaser_.maintain_leases()
+
+    assert "exiting" in caplog.text
+
+
+def test_maintain_leases_stopped(caplog):
+    caplog.set_level(logging.INFO)
+    manager = create_manager()
+
+    leaser_ = leaser.Leaser(manager)
+    leaser_.stop()
+
+    leaser_.maintain_leases()
+
+    assert "exiting" in caplog.text
+
+
+def make_sleep_mark_manager_as_inactive(leaser):
+    # Make sleep mark the manager as inactive so that maintain_leases
+    # exits at the end of the first run.
+    def trigger_inactive(timeout):
+        assert 0 < timeout < 10
+        leaser._manager.is_active = False
+
+    leaser._stop_event.wait = trigger_inactive
+
+
+def test_maintain_leases_ack_ids():
+    manager = create_manager()
+    leaser_ = leaser.Leaser(manager)
+    make_sleep_mark_manager_as_inactive(leaser_)
+    leaser_.add([requests.LeaseRequest(ack_id="my ack id", byte_size=50)])
+
+    leaser_.maintain_leases()
+
+    manager.dispatcher.modify_ack_deadline.assert_called_once_with(
+        [requests.ModAckRequest(ack_id="my ack id", seconds=10)]
+    )
+
+
+def test_maintain_leases_no_ack_ids():
+    manager = create_manager()
+    leaser_ = leaser.Leaser(manager)
+    make_sleep_mark_manager_as_inactive(leaser_)
+
+    leaser_.maintain_leases()
+
+    manager.dispatcher.modify_ack_deadline.assert_not_called()
+
+
+@mock.patch("time.time", autospec=True)
+def test_maintain_leases_outdated_items(time):
+    manager = create_manager()
+    leaser_ = leaser.Leaser(manager)
+    make_sleep_mark_manager_as_inactive(leaser_)
+
+    # Add these items at the beginning of the timeline
+    time.return_value = 0
+    leaser_.add([requests.LeaseRequest(ack_id="ack1", byte_size=50)])
+
+    # Add another item at towards end of the timeline
+    time.return_value = manager.flow_control.max_lease_duration - 1
+    leaser_.add([requests.LeaseRequest(ack_id="ack2", byte_size=50)])
+
+    # Now make sure time reports that we are at the end of our timeline.
+    time.return_value = manager.flow_control.max_lease_duration + 1
+
+    leaser_.maintain_leases()
+
+    # Only ack2 should be renewed. ack1 should've been dropped
+    manager.dispatcher.modify_ack_deadline.assert_called_once_with(
+        [requests.ModAckRequest(ack_id="ack2", seconds=10)]
+    )
+    manager.dispatcher.drop.assert_called_once_with(
+        [requests.DropRequest(ack_id="ack1", byte_size=50)]
+    )
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start(thread):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    leaser_ = leaser.Leaser(manager)
+
+    leaser_.start()
+
+    thread.assert_called_once_with(
+        name=leaser._LEASE_WORKER_NAME, target=leaser_.maintain_leases
+    )
+
+    thread.return_value.start.assert_called_once()
+
+    assert leaser_._thread is not None
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test_start_already_started(thread):
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    leaser_ = leaser.Leaser(manager)
+    leaser_._thread = mock.sentinel.thread
+
+    with pytest.raises(ValueError):
+        leaser_.start()
+
+    thread.assert_not_called()
+
+
+def test_stop():
+    manager = mock.create_autospec(
+        streaming_pull_manager.StreamingPullManager, instance=True
+    )
+    leaser_ = leaser.Leaser(manager)
+    thread = mock.create_autospec(threading.Thread, instance=True)
+    leaser_._thread = thread
+
+    leaser_.stop()
+
+    assert leaser_._stop_event.is_set()
+    thread.join.assert_called_once()
+    assert leaser_._thread is None
+
+
+def test_stop_no_join():
+    leaser_ = leaser.Leaser(mock.sentinel.manager)
+
+    leaser_.stop()
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_message.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_message.py
new file mode 100644
index 000000000000..4bb3329a29f0
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_message.py
@@ -0,0 +1,160 @@
+# Copyright 2017, Google LLC 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.
+
+import datetime
+import time
+
+import mock
+import pytz
+from six.moves import queue
+from google.protobuf import timestamp_pb2
+
+from google.api_core import datetime_helpers
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.subscriber import message
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+
+
+RECEIVED = datetime.datetime(2012, 4, 21, 15, 0, tzinfo=pytz.utc)
+RECEIVED_SECONDS = datetime_helpers.to_milliseconds(RECEIVED) // 1000
+PUBLISHED_MICROS = 123456
+PUBLISHED = RECEIVED + datetime.timedelta(days=1, microseconds=PUBLISHED_MICROS)
+PUBLISHED_SECONDS = datetime_helpers.to_milliseconds(PUBLISHED) // 1000
+
+
+def create_message(data, ack_id="ACKID", **attrs):
+    with mock.patch.object(time, "time") as time_:
+        time_.return_value = RECEIVED_SECONDS
+        msg = message.Message(
+            types.PubsubMessage(
+                attributes=attrs,
+                data=data,
+                message_id="message_id",
+                publish_time=timestamp_pb2.Timestamp(
+                    seconds=PUBLISHED_SECONDS, nanos=PUBLISHED_MICROS * 1000
+                ),
+            ),
+            ack_id,
+            queue.Queue(),
+        )
+        return msg
+
+
+def test_attributes():
+    msg = create_message(b"foo", baz="bacon", spam="eggs")
+    assert msg.attributes == {"baz": "bacon", "spam": "eggs"}
+
+
+def test_data():
+    msg = create_message(b"foo")
+    assert msg.data == b"foo"
+
+
+def test_size():
+    msg = create_message(b"foo")
+    assert msg.size == 30  # payload + protobuf overhead
+
+
+def test_ack_id():
+    ack_id = "MY-ACK-ID"
+    msg = create_message(b"foo", ack_id=ack_id)
+    assert msg.ack_id == ack_id
+
+
+def test_publish_time():
+    msg = create_message(b"foo")
+    assert msg.publish_time == PUBLISHED
+
+
+def check_call_types(mock, *args, **kwargs):
+    """Checks a mock's call types.
+
+    Args:
+        mock: The mock to check.
+        args: The types of the positional arguments.
+        kwargs: The names of the keyword args to check and their respective
+            types.
+
+    Raises:
+        AssertionError: if any of the types don't match, or if the number of
+            arguments does not match.
+    """
+    for call in mock.mock_calls:
+        _, call_args, call_kwargs = call
+        assert len(call_args) == len(args)
+        for n, argtype in enumerate(args):
+            assert isinstance(call_args[n], argtype)
+        for argname, argtype in kwargs:
+            assert argname in call_kwargs
+            assert isinstance(call_kwargs[argname], argtype)
+
+
+def test_ack():
+    msg = create_message(b"foo", ack_id="bogus_ack_id")
+    with mock.patch.object(msg._request_queue, "put") as put:
+        msg.ack()
+        put.assert_called_once_with(
+            requests.AckRequest(
+                ack_id="bogus_ack_id", byte_size=30, time_to_ack=mock.ANY
+            )
+        )
+        check_call_types(put, requests.AckRequest)
+
+
+def test_drop():
+    msg = create_message(b"foo", ack_id="bogus_ack_id")
+    with mock.patch.object(msg._request_queue, "put") as put:
+        msg.drop()
+        put.assert_called_once_with(
+            requests.DropRequest(ack_id="bogus_ack_id", byte_size=30)
+        )
+        check_call_types(put, requests.DropRequest)
+
+
+def test_modify_ack_deadline():
+    msg = create_message(b"foo", ack_id="bogus_ack_id")
+    with mock.patch.object(msg._request_queue, "put") as put:
+        msg.modify_ack_deadline(60)
+        put.assert_called_once_with(
+            requests.ModAckRequest(ack_id="bogus_ack_id", seconds=60)
+        )
+        check_call_types(put, requests.ModAckRequest)
+
+
+def test_nack():
+    msg = create_message(b"foo", ack_id="bogus_ack_id")
+    with mock.patch.object(msg._request_queue, "put") as put:
+        msg.nack()
+        put.assert_called_once_with(
+            requests.NackRequest(ack_id="bogus_ack_id", byte_size=30)
+        )
+        check_call_types(put, requests.NackRequest)
+
+
+def test_repr():
+    data = b"foo"
+    msg = create_message(data, snow="cones", orange="juice")
+    data_line = "  data: {!r}".format(data)
+    expected_repr = "\n".join(
+        (
+            "Message {",
+            data_line,
+            "  attributes: {",
+            '    "orange": "juice",',
+            '    "snow": "cones"',
+            "  }",
+            "}",
+        )
+    )
+    assert repr(msg) == expected_repr
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_scheduler.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_scheduler.py
new file mode 100644
index 000000000000..774d0d63e2a2
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_scheduler.py
@@ -0,0 +1,56 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import concurrent.futures
+import threading
+
+import mock
+from six.moves import queue
+
+from google.cloud.pubsub_v1.subscriber import scheduler
+
+
+def test_subclasses_base_abc():
+    assert issubclass(scheduler.ThreadScheduler, scheduler.Scheduler)
+
+
+def test_constructor_defaults():
+    scheduler_ = scheduler.ThreadScheduler()
+
+    assert isinstance(scheduler_.queue, queue.Queue)
+    assert isinstance(scheduler_._executor, concurrent.futures.Executor)
+
+
+def test_constructor_options():
+    scheduler_ = scheduler.ThreadScheduler(executor=mock.sentinel.executor)
+
+    assert scheduler_._executor == mock.sentinel.executor
+
+
+def test_schedule():
+    called_with = []
+    called = threading.Event()
+
+    def callback(*args, **kwargs):
+        called_with.append((args, kwargs))
+        called.set()
+
+    scheduler_ = scheduler.ThreadScheduler()
+
+    scheduler_.schedule(callback, "arg1", kwarg1="meep")
+
+    called.wait()
+    scheduler_.shutdown()
+
+    assert called_with == [(("arg1",), {"kwarg1": "meep"})]
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_streaming_pull_manager.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_streaming_pull_manager.py
new file mode 100644
index 000000000000..877ccf97fd9a
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_streaming_pull_manager.py
@@ -0,0 +1,730 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import threading
+import time
+import types as stdlib_types
+
+import mock
+import pytest
+from six.moves import queue
+
+from google.api_core import bidi
+from google.api_core import exceptions
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.gapic import subscriber_client_config
+from google.cloud.pubsub_v1.subscriber import client
+from google.cloud.pubsub_v1.subscriber import message
+from google.cloud.pubsub_v1.subscriber import scheduler
+from google.cloud.pubsub_v1.subscriber._protocol import dispatcher
+from google.cloud.pubsub_v1.subscriber._protocol import heartbeater
+from google.cloud.pubsub_v1.subscriber._protocol import leaser
+from google.cloud.pubsub_v1.subscriber._protocol import requests
+from google.cloud.pubsub_v1.subscriber._protocol import streaming_pull_manager
+import grpc
+
+
+@pytest.mark.parametrize(
+    "exception,expected_cls",
+    [
+        (ValueError("meep"), ValueError),
+        (
+            mock.create_autospec(grpc.RpcError, instance=True),
+            exceptions.GoogleAPICallError,
+        ),
+    ],
+)
+def test__maybe_wrap_exception(exception, expected_cls):
+    assert isinstance(
+        streaming_pull_manager._maybe_wrap_exception(exception), expected_cls
+    )
+
+
+def test__wrap_callback_errors_no_error():
+    msg = mock.create_autospec(message.Message, instance=True)
+    callback = mock.Mock()
+    on_callback_error = mock.Mock()
+
+    streaming_pull_manager._wrap_callback_errors(callback, on_callback_error, msg)
+
+    callback.assert_called_once_with(msg)
+    msg.nack.assert_not_called()
+    on_callback_error.assert_not_called()
+
+
+def test__wrap_callback_errors_error():
+    callback_error = ValueError("meep")
+
+    msg = mock.create_autospec(message.Message, instance=True)
+    callback = mock.Mock(side_effect=callback_error)
+    on_callback_error = mock.Mock()
+
+    streaming_pull_manager._wrap_callback_errors(callback, on_callback_error, msg)
+
+    msg.nack.assert_called_once()
+    on_callback_error.assert_called_once_with(callback_error)
+
+
+def test_constructor_and_default_state():
+    manager = streaming_pull_manager.StreamingPullManager(
+        mock.sentinel.client, mock.sentinel.subscription
+    )
+
+    # Public state
+    assert manager.is_active is False
+    assert manager.flow_control == types.FlowControl()
+    assert manager.dispatcher is None
+    assert manager.leaser is None
+    assert manager.ack_histogram is not None
+    assert manager.ack_deadline == 10
+    assert manager.load == 0
+
+    # Private state
+    assert manager._client == mock.sentinel.client
+    assert manager._subscription == mock.sentinel.subscription
+    assert manager._scheduler is not None
+
+
+def test_constructor_with_options():
+    manager = streaming_pull_manager.StreamingPullManager(
+        mock.sentinel.client,
+        mock.sentinel.subscription,
+        flow_control=mock.sentinel.flow_control,
+        scheduler=mock.sentinel.scheduler,
+    )
+
+    assert manager.flow_control == mock.sentinel.flow_control
+    assert manager._scheduler == mock.sentinel.scheduler
+
+
+def make_manager(**kwargs):
+    client_ = mock.create_autospec(client.Client, instance=True)
+    scheduler_ = mock.create_autospec(scheduler.Scheduler, instance=True)
+    return streaming_pull_manager.StreamingPullManager(
+        client_, "subscription-name", scheduler=scheduler_, **kwargs
+    )
+
+
+def fake_leaser_add(leaser, init_msg_count=0, init_bytes=0):
+    """Add a simplified fake add() method to a leaser instance.
+
+    The fake add() method actually increases the leaser's internal message count
+    by one for each message, and the total bytes by 10 for each message (hardcoded,
+    regardless of the actual message size).
+    """
+
+    def fake_add(self, items):
+        self.message_count += len(items)
+        self.bytes += len(items) * 10
+
+    leaser.message_count = init_msg_count
+    leaser.bytes = init_bytes
+    leaser.add = stdlib_types.MethodType(fake_add, leaser)
+
+
+def test_ack_deadline():
+    manager = make_manager()
+    assert manager.ack_deadline == 10
+    manager.ack_histogram.add(20)
+    assert manager.ack_deadline == 20
+    manager.ack_histogram.add(10)
+    assert manager.ack_deadline == 20
+
+
+def test_maybe_pause_consumer_wo_consumer_set():
+    manager = make_manager(
+        flow_control=types.FlowControl(max_messages=10, max_bytes=1000)
+    )
+    manager.maybe_pause_consumer()  # no raise
+    # Ensure load > 1
+    _leaser = manager._leaser = mock.create_autospec(leaser.Leaser)
+    _leaser.message_count = 100
+    _leaser.bytes = 10000
+    manager.maybe_pause_consumer()  # no raise
+
+
+def test_lease_load_and_pause():
+    manager = make_manager(
+        flow_control=types.FlowControl(max_messages=10, max_bytes=1000)
+    )
+    manager._leaser = leaser.Leaser(manager)
+    manager._consumer = mock.create_autospec(bidi.BackgroundConsumer, instance=True)
+    manager._consumer.is_paused = False
+
+    # This should mean that our messages count is at 10%, and our bytes
+    # are at 15%; load should return the higher (0.15), and shouldn't cause
+    # the consumer to pause.
+    manager.leaser.add([requests.LeaseRequest(ack_id="one", byte_size=150)])
+    assert manager.load == 0.15
+    manager.maybe_pause_consumer()
+    manager._consumer.pause.assert_not_called()
+
+    # After this message is added, the messages should be higher at 20%
+    # (versus 16% for bytes).
+    manager.leaser.add([requests.LeaseRequest(ack_id="two", byte_size=10)])
+    assert manager.load == 0.2
+
+    # Returning a number above 100% is fine, and it should cause this to pause.
+    manager.leaser.add([requests.LeaseRequest(ack_id="three", byte_size=1000)])
+    assert manager.load == 1.16
+    manager.maybe_pause_consumer()
+    manager._consumer.pause.assert_called_once()
+
+
+def test_drop_and_resume():
+    manager = make_manager(
+        flow_control=types.FlowControl(max_messages=10, max_bytes=1000)
+    )
+    manager._leaser = leaser.Leaser(manager)
+    manager._consumer = mock.create_autospec(bidi.BackgroundConsumer, instance=True)
+    manager._consumer.is_paused = True
+
+    # Add several messages until we're over the load threshold.
+    manager.leaser.add(
+        [
+            requests.LeaseRequest(ack_id="one", byte_size=750),
+            requests.LeaseRequest(ack_id="two", byte_size=250),
+        ]
+    )
+
+    assert manager.load == 1.0
+
+    # Trying to resume now should have no effect as we're over the threshold.
+    manager.maybe_resume_consumer()
+    manager._consumer.resume.assert_not_called()
+
+    # Drop the 200 byte message, which should put us under the resume
+    # threshold.
+    manager.leaser.remove([requests.DropRequest(ack_id="two", byte_size=250)])
+    manager.maybe_resume_consumer()
+    manager._consumer.resume.assert_called_once()
+
+
+def test_resume_not_paused():
+    manager = make_manager()
+    manager._consumer = mock.create_autospec(bidi.BackgroundConsumer, instance=True)
+    manager._consumer.is_paused = False
+
+    # Resuming should have no effect is the consumer is not actually paused.
+    manager.maybe_resume_consumer()
+    manager._consumer.resume.assert_not_called()
+
+
+def test_maybe_resume_consumer_wo_consumer_set():
+    manager = make_manager(
+        flow_control=types.FlowControl(max_messages=10, max_bytes=1000)
+    )
+    manager.maybe_resume_consumer()  # no raise
+
+
+def test__maybe_release_messages_on_overload():
+    manager = make_manager(
+        flow_control=types.FlowControl(max_messages=10, max_bytes=1000)
+    )
+    # Ensure load is exactly 1.0 (to verify that >= condition is used)
+    _leaser = manager._leaser = mock.create_autospec(leaser.Leaser)
+    _leaser.message_count = 10
+    _leaser.bytes = 1000
+
+    msg = mock.create_autospec(message.Message, instance=True, ack_id="ack", size=11)
+    manager._messages_on_hold.put(msg)
+
+    manager._maybe_release_messages()
+
+    assert manager._messages_on_hold.qsize() == 1
+    manager._leaser.add.assert_not_called()
+    manager._scheduler.schedule.assert_not_called()
+
+
+def test__maybe_release_messages_below_overload():
+    manager = make_manager(
+        flow_control=types.FlowControl(max_messages=10, max_bytes=1000)
+    )
+    manager._callback = mock.sentinel.callback
+
+    # init leaser message count to 8 to leave room for 2 more messages
+    _leaser = manager._leaser = mock.create_autospec(leaser.Leaser)
+    fake_leaser_add(_leaser, init_msg_count=8, init_bytes=200)
+    _leaser.add = mock.Mock(wraps=_leaser.add)  # to spy on calls
+
+    messages = [
+        mock.create_autospec(message.Message, instance=True, ack_id="ack_foo", size=11),
+        mock.create_autospec(message.Message, instance=True, ack_id="ack_bar", size=22),
+        mock.create_autospec(message.Message, instance=True, ack_id="ack_baz", size=33),
+    ]
+    for msg in messages:
+        manager._messages_on_hold.put(msg)
+
+    # the actual call of MUT
+    manager._maybe_release_messages()
+
+    assert manager._messages_on_hold.qsize() == 1
+    msg = manager._messages_on_hold.get_nowait()
+    assert msg.ack_id == "ack_baz"
+
+    assert len(_leaser.add.mock_calls) == 2
+    expected_calls = [
+        mock.call([requests.LeaseRequest(ack_id="ack_foo", byte_size=11)]),
+        mock.call([requests.LeaseRequest(ack_id="ack_bar", byte_size=22)]),
+    ]
+    _leaser.add.assert_has_calls(expected_calls)
+
+    schedule_calls = manager._scheduler.schedule.mock_calls
+    assert len(schedule_calls) == 2
+    for _, call_args, _ in schedule_calls:
+        assert call_args[0] == mock.sentinel.callback
+        assert isinstance(call_args[1], message.Message)
+        assert call_args[1].ack_id in ("ack_foo", "ack_bar")
+
+
+def test_send_unary():
+    manager = make_manager()
+    manager._UNARY_REQUESTS = True
+
+    manager.send(
+        types.StreamingPullRequest(
+            ack_ids=["ack_id1", "ack_id2"],
+            modify_deadline_ack_ids=["ack_id3", "ack_id4", "ack_id5"],
+            modify_deadline_seconds=[10, 20, 20],
+        )
+    )
+
+    manager._client.acknowledge.assert_called_once_with(
+        subscription=manager._subscription, ack_ids=["ack_id1", "ack_id2"]
+    )
+
+    manager._client.modify_ack_deadline.assert_has_calls(
+        [
+            mock.call(
+                subscription=manager._subscription,
+                ack_ids=["ack_id3"],
+                ack_deadline_seconds=10,
+            ),
+            mock.call(
+                subscription=manager._subscription,
+                ack_ids=["ack_id4", "ack_id5"],
+                ack_deadline_seconds=20,
+            ),
+        ],
+        any_order=True,
+    )
+
+
+def test_send_unary_empty():
+    manager = make_manager()
+    manager._UNARY_REQUESTS = True
+
+    manager.send(types.StreamingPullRequest())
+
+    manager._client.acknowledge.assert_not_called()
+    manager._client.modify_ack_deadline.assert_not_called()
+
+
+def test_send_unary_api_call_error(caplog):
+    caplog.set_level(logging.DEBUG)
+
+    manager = make_manager()
+    manager._UNARY_REQUESTS = True
+
+    error = exceptions.GoogleAPICallError("The front fell off")
+    manager._client.acknowledge.side_effect = error
+
+    manager.send(types.StreamingPullRequest(ack_ids=["ack_id1", "ack_id2"]))
+
+    assert "The front fell off" in caplog.text
+
+
+def test_send_unary_retry_error(caplog):
+    caplog.set_level(logging.DEBUG)
+
+    manager, _, _, _, _, _ = make_running_manager()
+    manager._UNARY_REQUESTS = True
+
+    error = exceptions.RetryError(
+        "Too long a transient error", cause=Exception("Out of time!")
+    )
+    manager._client.acknowledge.side_effect = error
+
+    with pytest.raises(exceptions.RetryError):
+        manager.send(types.StreamingPullRequest(ack_ids=["ack_id1", "ack_id2"]))
+
+    assert "RetryError while sending unary RPC" in caplog.text
+    assert "signaled streaming pull manager shutdown" in caplog.text
+
+
+def test_send_streaming():
+    manager = make_manager()
+    manager._UNARY_REQUESTS = False
+    manager._rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+
+    manager.send(mock.sentinel.request)
+
+    manager._rpc.send.assert_called_once_with(mock.sentinel.request)
+
+
+def test_heartbeat():
+    manager = make_manager()
+    manager._rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+    manager._rpc.is_active = True
+
+    manager.heartbeat()
+
+    manager._rpc.send.assert_called_once_with(types.StreamingPullRequest())
+
+
+def test_heartbeat_inactive():
+    manager = make_manager()
+    manager._rpc = mock.create_autospec(bidi.BidiRpc, instance=True)
+    manager._rpc.is_active = False
+
+    manager.heartbeat()
+
+    manager._rpc.send.assert_not_called()
+
+
+@mock.patch("google.api_core.bidi.ResumableBidiRpc", autospec=True)
+@mock.patch("google.api_core.bidi.BackgroundConsumer", autospec=True)
+@mock.patch("google.cloud.pubsub_v1.subscriber._protocol.leaser.Leaser", autospec=True)
+@mock.patch(
+    "google.cloud.pubsub_v1.subscriber._protocol.dispatcher.Dispatcher", autospec=True
+)
+@mock.patch(
+    "google.cloud.pubsub_v1.subscriber._protocol.heartbeater.Heartbeater", autospec=True
+)
+def test_open(heartbeater, dispatcher, leaser, background_consumer, resumable_bidi_rpc):
+    manager = make_manager()
+
+    manager.open(mock.sentinel.callback, mock.sentinel.on_callback_error)
+
+    heartbeater.assert_called_once_with(manager)
+    heartbeater.return_value.start.assert_called_once()
+    assert manager._heartbeater == heartbeater.return_value
+
+    dispatcher.assert_called_once_with(manager, manager._scheduler.queue)
+    dispatcher.return_value.start.assert_called_once()
+    assert manager._dispatcher == dispatcher.return_value
+
+    leaser.assert_called_once_with(manager)
+    leaser.return_value.start.assert_called_once()
+    assert manager.leaser == leaser.return_value
+
+    background_consumer.assert_called_once_with(manager._rpc, manager._on_response)
+    background_consumer.return_value.start.assert_called_once()
+    assert manager._consumer == background_consumer.return_value
+
+    resumable_bidi_rpc.assert_called_once_with(
+        start_rpc=manager._client.api.streaming_pull,
+        initial_request=manager._get_initial_request,
+        should_recover=manager._should_recover,
+        throttle_reopen=True,
+    )
+    resumable_bidi_rpc.return_value.add_done_callback.assert_called_once_with(
+        manager._on_rpc_done
+    )
+    assert manager._rpc == resumable_bidi_rpc.return_value
+
+    manager._consumer.is_active = True
+    assert manager.is_active is True
+
+
+def test_open_already_active():
+    manager = make_manager()
+    manager._consumer = mock.create_autospec(bidi.BackgroundConsumer, instance=True)
+    manager._consumer.is_active = True
+
+    with pytest.raises(ValueError, match="already open"):
+        manager.open(mock.sentinel.callback, mock.sentinel.on_callback_error)
+
+
+def test_open_has_been_closed():
+    manager = make_manager()
+    manager._closed = True
+
+    with pytest.raises(ValueError, match="closed"):
+        manager.open(mock.sentinel.callback, mock.sentinel.on_callback_error)
+
+
+def make_running_manager():
+    manager = make_manager()
+    manager._consumer = mock.create_autospec(bidi.BackgroundConsumer, instance=True)
+    manager._consumer.is_active = True
+    manager._dispatcher = mock.create_autospec(dispatcher.Dispatcher, instance=True)
+    manager._leaser = mock.create_autospec(leaser.Leaser, instance=True)
+    manager._heartbeater = mock.create_autospec(heartbeater.Heartbeater, instance=True)
+
+    return (
+        manager,
+        manager._consumer,
+        manager._dispatcher,
+        manager._leaser,
+        manager._heartbeater,
+        manager._scheduler,
+    )
+
+
+def test_close():
+    manager, consumer, dispatcher, leaser, heartbeater, scheduler = (
+        make_running_manager()
+    )
+
+    manager.close()
+
+    consumer.stop.assert_called_once()
+    leaser.stop.assert_called_once()
+    dispatcher.stop.assert_called_once()
+    heartbeater.stop.assert_called_once()
+    scheduler.shutdown.assert_called_once()
+
+    assert manager.is_active is False
+
+
+def test_close_inactive_consumer():
+    manager, consumer, dispatcher, leaser, heartbeater, scheduler = (
+        make_running_manager()
+    )
+    consumer.is_active = False
+
+    manager.close()
+
+    consumer.stop.assert_not_called()
+    leaser.stop.assert_called_once()
+    dispatcher.stop.assert_called_once()
+    heartbeater.stop.assert_called_once()
+    scheduler.shutdown.assert_called_once()
+
+
+def test_close_idempotent():
+    manager, _, _, _, _, scheduler = make_running_manager()
+
+    manager.close()
+    manager.close()
+
+    assert scheduler.shutdown.call_count == 1
+
+
+class FakeDispatcher(object):
+    def __init__(self, manager, error_callback):
+        self._manager = manager
+        self._error_callback = error_callback
+        self._thread = None
+        self._stop = False
+
+    def start(self):
+        self._thread = threading.Thread(target=self._do_work)
+        self._thread.daemon = True
+        self._thread.start()
+
+    def stop(self):
+        self._stop = True
+        self._thread.join()
+        self._thread = None
+
+    def _do_work(self):
+        while not self._stop:
+            try:
+                self._manager.leaser.add([mock.Mock()])
+            except Exception as exc:
+                self._error_callback(exc)
+            time.sleep(0.1)
+
+        # also try to interact with the leaser after the stop flag has been set
+        try:
+            self._manager.leaser.remove([mock.Mock()])
+        except Exception as exc:
+            self._error_callback(exc)
+
+
+def test_close_no_dispatcher_error():
+    manager, _, _, _, _, _ = make_running_manager()
+    error_callback = mock.Mock(name="error_callback")
+    dispatcher = FakeDispatcher(manager=manager, error_callback=error_callback)
+    manager._dispatcher = dispatcher
+    dispatcher.start()
+
+    manager.close()
+
+    error_callback.assert_not_called()
+
+
+def test_close_callbacks():
+    manager, _, _, _, _, _ = make_running_manager()
+
+    callback = mock.Mock()
+
+    manager.add_close_callback(callback)
+    manager.close(reason="meep")
+
+    callback.assert_called_once_with(manager, "meep")
+
+
+def test__get_initial_request():
+    manager = make_manager()
+    manager._leaser = mock.create_autospec(leaser.Leaser, instance=True)
+    manager._leaser.ack_ids = ["1", "2"]
+
+    initial_request = manager._get_initial_request()
+
+    assert isinstance(initial_request, types.StreamingPullRequest)
+    assert initial_request.subscription == "subscription-name"
+    assert initial_request.stream_ack_deadline_seconds == 10
+    assert initial_request.modify_deadline_ack_ids == ["1", "2"]
+    assert initial_request.modify_deadline_seconds == [10, 10]
+
+
+def test__get_initial_request_wo_leaser():
+    manager = make_manager()
+    manager._leaser = None
+
+    initial_request = manager._get_initial_request()
+
+    assert isinstance(initial_request, types.StreamingPullRequest)
+    assert initial_request.subscription == "subscription-name"
+    assert initial_request.stream_ack_deadline_seconds == 10
+    assert initial_request.modify_deadline_ack_ids == []
+    assert initial_request.modify_deadline_seconds == []
+
+
+def test__on_response_no_leaser_overload():
+    manager, _, dispatcher, leaser, _, scheduler = make_running_manager()
+    manager._callback = mock.sentinel.callback
+
+    # Set up the messages.
+    response = types.StreamingPullResponse(
+        received_messages=[
+            types.ReceivedMessage(
+                ack_id="fack", message=types.PubsubMessage(data=b"foo", message_id="1")
+            ),
+            types.ReceivedMessage(
+                ack_id="back", message=types.PubsubMessage(data=b"bar", message_id="2")
+            ),
+        ]
+    )
+
+    # adjust message bookkeeping in leaser
+    fake_leaser_add(leaser, init_msg_count=0, init_bytes=0)
+
+    # Actually run the method and prove that modack and schedule
+    # are called in the expected way.
+    manager._on_response(response)
+
+    dispatcher.modify_ack_deadline.assert_called_once_with(
+        [requests.ModAckRequest("fack", 10), requests.ModAckRequest("back", 10)]
+    )
+
+    schedule_calls = scheduler.schedule.mock_calls
+    assert len(schedule_calls) == 2
+    for call in schedule_calls:
+        assert call[1][0] == mock.sentinel.callback
+        assert isinstance(call[1][1], message.Message)
+
+    # the leaser load limit not hit, no messages had to be put on hold
+    assert manager._messages_on_hold.qsize() == 0
+
+
+def test__on_response_with_leaser_overload():
+    manager, _, dispatcher, leaser, _, scheduler = make_running_manager()
+    manager._callback = mock.sentinel.callback
+
+    # Set up the messages.
+    response = types.StreamingPullResponse(
+        received_messages=[
+            types.ReceivedMessage(
+                ack_id="fack", message=types.PubsubMessage(data=b"foo", message_id="1")
+            ),
+            types.ReceivedMessage(
+                ack_id="back", message=types.PubsubMessage(data=b"bar", message_id="2")
+            ),
+            types.ReceivedMessage(
+                ack_id="zack", message=types.PubsubMessage(data=b"baz", message_id="3")
+            ),
+        ]
+    )
+
+    # Adjust message bookkeeping in leaser. Pick 99 messages, which is just below
+    # the default FlowControl.max_messages limit.
+    fake_leaser_add(leaser, init_msg_count=99, init_bytes=990)
+
+    # Actually run the method and prove that modack and schedule
+    # are called in the expected way.
+    manager._on_response(response)
+
+    dispatcher.modify_ack_deadline.assert_called_once_with(
+        [
+            requests.ModAckRequest("fack", 10),
+            requests.ModAckRequest("back", 10),
+            requests.ModAckRequest("zack", 10),
+        ]
+    )
+
+    # one message should be scheduled, the leaser capacity allows for it
+    schedule_calls = scheduler.schedule.mock_calls
+    assert len(schedule_calls) == 1
+    call_args = schedule_calls[0][1]
+    assert call_args[0] == mock.sentinel.callback
+    assert isinstance(call_args[1], message.Message)
+    assert call_args[1].message_id == "1"
+
+    # the rest of the messages should have been put on hold
+    assert manager._messages_on_hold.qsize() == 2
+    while True:
+        try:
+            msg = manager._messages_on_hold.get_nowait()
+        except queue.Empty:
+            break
+        else:
+            assert isinstance(msg, message.Message)
+            assert msg.message_id in ("2", "3")
+
+
+def test_retryable_stream_errors():
+    # Make sure the config matches our hard-coded tuple of exceptions.
+    interfaces = subscriber_client_config.config["interfaces"]
+    retry_codes = interfaces["google.pubsub.v1.Subscriber"]["retry_codes"]
+    idempotent = retry_codes["idempotent"]
+
+    status_codes = tuple(getattr(grpc.StatusCode, name, None) for name in idempotent)
+    expected = tuple(
+        exceptions.exception_class_for_grpc_status(status_code)
+        for status_code in status_codes
+    )
+    assert set(expected).issubset(set(streaming_pull_manager._RETRYABLE_STREAM_ERRORS))
+
+
+def test__should_recover_true():
+    manager = make_manager()
+
+    details = "UNAVAILABLE. Service taking nap."
+    exc = exceptions.ServiceUnavailable(details)
+
+    assert manager._should_recover(exc) is True
+
+
+def test__should_recover_false():
+    manager = make_manager()
+
+    exc = TypeError("wahhhhhh")
+
+    assert manager._should_recover(exc) is False
+
+
+@mock.patch("threading.Thread", autospec=True)
+def test__on_rpc_done(thread):
+    manager = make_manager()
+
+    manager._on_rpc_done(mock.sentinel.error)
+
+    thread.assert_called_once_with(
+        name=mock.ANY, target=manager.close, kwargs={"reason": mock.sentinel.error}
+    )
diff --git a/pubsub/tests/unit/pubsub_v1/subscriber/test_subscriber_client.py b/pubsub/tests/unit/pubsub_v1/subscriber/test_subscriber_client.py
new file mode 100644
index 000000000000..b367733aa705
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/subscriber/test_subscriber_client.py
@@ -0,0 +1,108 @@
+# Copyright 2017, Google LLC 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.
+
+from google.auth import credentials
+import mock
+
+from google.cloud.pubsub_v1 import subscriber
+from google.cloud.pubsub_v1.gapic import subscriber_client
+from google.cloud.pubsub_v1 import types
+from google.cloud.pubsub_v1.subscriber import futures
+
+
+def test_init():
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = subscriber.Client(credentials=creds)
+    assert isinstance(client.api, subscriber_client.SubscriberClient)
+
+
+def test_init_w_custom_transport():
+    transport = object()
+    client = subscriber.Client(transport=transport)
+    assert isinstance(client.api, subscriber_client.SubscriberClient)
+    assert client.api.transport is transport
+
+
+def test_init_emulator(monkeypatch):
+    monkeypatch.setenv("PUBSUB_EMULATOR_HOST", "/baz/bacon/")
+    # NOTE: When the emulator host is set, a custom channel will be used, so
+    #       no credentials (mock ot otherwise) can be passed in.
+    client = subscriber.Client()
+
+    # Establish that a gRPC request would attempt to hit the emulator host.
+    #
+    # Sadly, there seems to be no good way to do this without poking at
+    # the private API of gRPC.
+    channel = client.api.transport.pull._channel
+    assert channel.target().decode("utf8") == "/baz/bacon/"
+
+
+def test_class_method_factory():
+    patch = mock.patch(
+        "google.oauth2.service_account.Credentials.from_service_account_file"
+    )
+
+    with patch:
+        client = subscriber.Client.from_service_account_file("filename.json")
+
+    assert isinstance(client, subscriber.Client)
+
+
+@mock.patch(
+    "google.cloud.pubsub_v1.subscriber._protocol.streaming_pull_manager."
+    "StreamingPullManager.open",
+    autospec=True,
+)
+def test_subscribe(manager_open):
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = subscriber.Client(credentials=creds)
+
+    future = client.subscribe("sub_name_a", callback=mock.sentinel.callback)
+    assert isinstance(future, futures.StreamingPullFuture)
+
+    assert future._manager._subscription == "sub_name_a"
+    manager_open.assert_called_once_with(
+        mock.ANY,
+        callback=mock.sentinel.callback,
+        on_callback_error=future.set_exception,
+    )
+
+
+@mock.patch(
+    "google.cloud.pubsub_v1.subscriber._protocol.streaming_pull_manager."
+    "StreamingPullManager.open",
+    autospec=True,
+)
+def test_subscribe_options(manager_open):
+    creds = mock.Mock(spec=credentials.Credentials)
+    client = subscriber.Client(credentials=creds)
+    flow_control = types.FlowControl(max_bytes=42)
+    scheduler = mock.sentinel.scheduler
+
+    future = client.subscribe(
+        "sub_name_a",
+        callback=mock.sentinel.callback,
+        flow_control=flow_control,
+        scheduler=scheduler,
+    )
+    assert isinstance(future, futures.StreamingPullFuture)
+
+    assert future._manager._subscription == "sub_name_a"
+    assert future._manager.flow_control == flow_control
+    assert future._manager._scheduler == scheduler
+    manager_open.assert_called_once_with(
+        mock.ANY,
+        callback=mock.sentinel.callback,
+        on_callback_error=future.set_exception,
+    )
diff --git a/pubsub/tests/unit/pubsub_v1/test__gapic.py b/pubsub/tests/unit/pubsub_v1/test__gapic.py
new file mode 100644
index 000000000000..5478aee18213
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/test__gapic.py
@@ -0,0 +1,63 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from google.cloud.pubsub_v1 import _gapic
+
+
+class SourceClass(object):
+    def __init__(self):
+        self.x = "x"
+
+    def method(self):
+        return "source class instance method"
+
+    @staticmethod
+    def static_method():
+        return "source class static method"
+
+    @classmethod
+    def class_method(cls):
+        return "source class class method"
+
+    @classmethod
+    def blacklisted_method(cls):
+        return "source class blacklisted method"
+
+
+def test_add_method():
+    @_gapic.add_methods(SourceClass, ("blacklisted_method",))
+    class Foo(object):
+        def __init__(self):
+            self.api = SourceClass()
+
+        def method(self):
+            return "foo class instance method"
+
+    foo = Foo()
+
+    # Any method that's callable and not blacklisted is "inherited".
+    assert set(["method", "static_method", "class_method"]) <= set(dir(foo))
+    assert "blacklisted_method" not in dir(foo)
+
+    # Source Class's static and class methods become static methods.
+    assert type(Foo.__dict__["static_method"]) == staticmethod
+    assert foo.static_method() == "source class static method"
+    assert type(Foo.__dict__["class_method"]) == staticmethod
+    assert foo.class_method() == "source class class method"
+
+    # The decorator changes the behavior of instance methods of the wrapped class.
+    # method() is called on an instance of the Source Class (stored as an
+    # attribute on the wrapped class).
+    assert foo.method() == "source class instance method"
diff --git a/pubsub/tests/unit/pubsub_v1/test_futures.py b/pubsub/tests/unit/pubsub_v1/test_futures.py
new file mode 100644
index 000000000000..11349d5d480a
--- /dev/null
+++ b/pubsub/tests/unit/pubsub_v1/test_futures.py
@@ -0,0 +1,148 @@
+# Copyright 2017, Google LLC 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.
+
+import threading
+
+import mock
+import pytest
+
+from google.cloud.pubsub_v1 import exceptions
+from google.cloud.pubsub_v1 import futures
+
+
+def _future(*args, **kwargs):
+    return futures.Future(*args, **kwargs)
+
+
+def test_constructor_defaults():
+    with mock.patch.object(threading, "Event", autospec=True) as Event:
+        future = _future()
+
+    assert future._result == futures.Future._SENTINEL
+    assert future._exception == futures.Future._SENTINEL
+    assert future._callbacks == []
+    assert future._completed is Event.return_value
+
+    Event.assert_called_once_with()
+
+
+def test_constructor_explicit_completed():
+    completed = mock.sentinel.completed
+    future = _future(completed=completed)
+
+    assert future._result == futures.Future._SENTINEL
+    assert future._exception == futures.Future._SENTINEL
+    assert future._callbacks == []
+    assert future._completed is completed
+
+
+def test_cancel():
+    assert _future().cancel() is False
+
+
+def test_cancelled():
+    assert _future().cancelled() is False
+
+
+def test_running():
+    future = _future()
+    assert future.running() is True
+    future.set_result("foobar")
+    assert future.running() is False
+
+
+def test_done():
+    future = _future()
+    assert future.done() is False
+    future.set_result("12345")
+    assert future.done() is True
+
+
+def test_exception_no_error():
+    future = _future()
+    future.set_result("12345")
+    assert future.exception() is None
+
+
+def test_exception_with_error():
+    future = _future()
+    error = RuntimeError("Something really bad happened.")
+    future.set_exception(error)
+
+    # Make sure that the exception that is returned is the batch's error.
+    # Also check the type to ensure the batch's error did not somehow
+    # change internally.
+    assert future.exception() is error
+    assert isinstance(future.exception(), RuntimeError)
+    with pytest.raises(RuntimeError):
+        future.result()
+
+
+def test_exception_timeout():
+    future = _future()
+    with pytest.raises(exceptions.TimeoutError):
+        future.exception(timeout=0.01)
+
+
+def test_result_no_error():
+    future = _future()
+    future.set_result("42")
+    assert future.result() == "42"
+
+
+def test_result_with_error():
+    future = _future()
+    future.set_exception(RuntimeError("Something really bad happened."))
+    with pytest.raises(RuntimeError):
+        future.result()
+
+
+def test_add_done_callback_pending_batch():
+    future = _future()
+    callback = mock.Mock()
+    future.add_done_callback(callback)
+    assert len(future._callbacks) == 1
+    assert callback in future._callbacks
+    assert callback.call_count == 0
+
+
+def test_add_done_callback_completed_batch():
+    future = _future()
+    future.set_result("12345")
+    callback = mock.Mock(spec=())
+    future.add_done_callback(callback)
+    callback.assert_called_once_with(future)
+
+
+def test_trigger():
+    future = _future()
+    callback = mock.Mock(spec=())
+    future.add_done_callback(callback)
+    assert callback.call_count == 0
+    future.set_result("12345")
+    callback.assert_called_once_with(future)
+
+
+def test_set_result_once_only():
+    future = _future()
+    future.set_result("12345")
+    with pytest.raises(RuntimeError):
+        future.set_result("67890")
+
+
+def test_set_exception_once_only():
+    future = _future()
+    future.set_exception(ValueError("wah wah"))
+    with pytest.raises(RuntimeError):
+        future.set_exception(TypeError("other wah wah"))
diff --git a/pubsub/tests/unit/test_pubsub.py b/pubsub/tests/unit/test_pubsub.py
new file mode 100644
index 000000000000..76d590a492c5
--- /dev/null
+++ b/pubsub/tests/unit/test_pubsub.py
@@ -0,0 +1,22 @@
+# Copyright 2017, Google LLC 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.
+
+from google.cloud import pubsub
+from google.cloud import pubsub_v1
+
+
+def test_exported_things():
+    assert pubsub.PublisherClient is pubsub_v1.PublisherClient
+    assert pubsub.SubscriberClient is pubsub_v1.SubscriberClient
+    assert pubsub.types is pubsub_v1.types
diff --git a/redis/.coveragerc b/redis/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/redis/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/redis/.flake8 b/redis/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/redis/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/redis/.repo-metadata.json b/redis/.repo-metadata.json
new file mode 100644
index 000000000000..7f7f221f15c4
--- /dev/null
+++ b/redis/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "redis",
+  "name_pretty": "Cloud Redis",
+  "product_documentation": "https://cloud.google.com/memorystore/docs/redis/",
+  "client_documentation": "https://googleapis.dev/python/redis/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5169231",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-redis",
+  "api_id": "redis.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/redis/CHANGELOG.md b/redis/CHANGELOG.md
new file mode 100644
index 000000000000..8813cf9e6471
--- /dev/null
+++ b/redis/CHANGELOG.md
@@ -0,0 +1,104 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-redis/#history
+
+## 0.3.0
+
+07-24-2019 17:15 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8400](https://github.com/googleapis/google-cloud-python/pull/8400))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Remove unused message exports. ([#7272](https://github.com/googleapis/google-cloud-python/pull/7272))
+- Protoc-generated serialization update. ([#7092](https://github.com/googleapis/google-cloud-python/pull/7092))
+- Pick up stub docstring fix in GAPIC generator. ([#6979](https://github.com/googleapis/google-cloud-python/pull/6979))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8519](https://github.com/googleapis/google-cloud-python/pull/8519))
+- Add 'import_instance' / 'export_instance' support (via synth). ([#8220](https://github.com/googleapis/google-cloud-python/pull/8220))
+- Remove v1 'import_instance' / 'export_instance'; add v1beta1 'failover_instance' (via synth). ([#7937](https://github.com/googleapis/google-cloud-python/pull/7937))
+- Add support for instance import / export / failover (via synth). ([#7423](https://github.com/googleapis/google-cloud-python/pull/7423))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Pin black version (via synth). ([#8592](https://github.com/googleapis/google-cloud-python/pull/8592))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update year: 2018 -> 2019. ([#7154](https://github.com/googleapis/google-cloud-python/pull/7154))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8360](https://github.com/googleapis/google-cloud-python/pull/8360))
+- Add disclaimer to auto-generated template files (via synth).  ([#8324](https://github.com/googleapis/google-cloud-python/pull/8324))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8249](https://github.com/googleapis/google-cloud-python/pull/8249))
+- Fix coverage in 'types.py' (via synth). ([#8161](https://github.com/googleapis/google-cloud-python/pull/8161))
+- Blacken noxfile.py, setup.py (via synth). ([#8129](https://github.com/googleapis/google-cloud-python/pull/8129))
+- Add empty lines (via synth). ([#8068](https://github.com/googleapis/google-cloud-python/pull/8068))
+- Finsh setup for 'docs' session in nox. ([#8101](https://github.com/googleapis/google-cloud-python/pull/8101))
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+- Copy lintified proto files (via synth).
+- Add clarifying comment to blacken nox target. ([#7400](https://github.com/googleapis/google-cloud-python/pull/7400))
+- Copy proto files alongside protoc versions.
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.2.1
+
+12-18-2018 09:40 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6504](https://github.com/googleapis/google-cloud-python/pull/6504))
+- Assorted synth fixups / cleanups ([#6400](https://github.com/googleapis/google-cloud-python/pull/6400))
+- Fix `client_info` bug, update docstrings. ([#6419](https://github.com/googleapis/google-cloud-python/pull/6419))
+- Re-generate library using redis/synth.py ([#6016](https://github.com/googleapis/google-cloud-python/pull/6016))
+- Re-generate library using redis/synth.py ([#5993](https://github.com/googleapis/google-cloud-python/pull/5993))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Don't synth 'README.rst'. ([#6262](https://github.com/googleapis/google-cloud-python/pull/6262))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.2.0
+
+### New Features
+
+- Add the v1 API client library. ([#5945](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5945))
+
+### Documentation
+
+- Docs: Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5901))
+- Redis: Fix README.md links ([#5745](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5745))
+- Add redis documentation to main index.rst ([#5405](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5405))
+
+### Internal / Testing Changes
+
+- Nox: use inplace installs ([#5865](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5865))
+- Avoid overwriting '__module__' of messages from shared modules. ([#5364](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5364))
+- Unit tests require grpcio. ([#5363](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5363))
+
+## 0.1.0
+
+### New Features
+Initial version of Redis client library v1beta1.
+
diff --git a/redis/LICENSE b/redis/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/redis/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/redis/MANIFEST.in b/redis/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/redis/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/redis/README.rst b/redis/README.rst
new file mode 100644
index 000000000000..e66a8716154a
--- /dev/null
+++ b/redis/README.rst
@@ -0,0 +1,88 @@
+Python Client for Google Cloud Memorystore for Redis API
+========================================================
+
+|alpha| |pypi| |versions| 
+
+`Google Cloud Memorystore for Redis API`_: The Google Cloud Memorystore for
+Redis API is used for creating and managing Redis instances on the Google
+Cloud Platform.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-redis.svg
+   :target: https://pypi.org/project/google-cloud-redis/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-redis.svg
+   :target: https://pypi.org/project/google-cloud-redis/
+.. _Google Cloud Memorystore for Redis API: https://cloud.google.com/memorystore/
+.. _Client Library Documentation: https://googleapis.dev/python/redis/latest
+.. _Product Documentation:  https://cloud.google.com/memorystore/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Memorystore for Redis API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Memorystore for Redis API.:  https://console.cloud.google.com/apis/library/redis.googleapis.com
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-redis
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-redis
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Memorystore for
+   Redis API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn more about the product and see
+   How-to Guides.
diff --git a/redis/docs/README.rst b/redis/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/redis/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/redis/docs/conf.py b/redis/docs/conf.py
new file mode 100644
index 000000000000..55f004284af5
--- /dev/null
+++ b/redis/docs/conf.py
@@ -0,0 +1,359 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-redis documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", "md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-redis"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-redis-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-redis.tex",
+        u"google-cloud-redis Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-automl",
+        u"google-cloud-automl Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-redis",
+        u"google-cloud-redis Documentation",
+        author,
+        "google-cloud-redis",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/redis/docs/gapic/v1/api.rst b/redis/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..50ad1f8a5f64
--- /dev/null
+++ b/redis/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Memorystore for Redis API
+=================================================
+
+.. automodule:: google.cloud.redis_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/redis/docs/gapic/v1/types.rst b/redis/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..ba92173ded8e
--- /dev/null
+++ b/redis/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Memorystore for Redis API Client
+=======================================================
+
+.. automodule:: google.cloud.redis_v1.types
+    :members:
\ No newline at end of file
diff --git a/redis/docs/gapic/v1beta1/api.rst b/redis/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..b1505646c85c
--- /dev/null
+++ b/redis/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Memorystore for Redis API
+=================================================
+
+.. automodule:: google.cloud.redis_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/redis/docs/gapic/v1beta1/types.rst b/redis/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..579707e712de
--- /dev/null
+++ b/redis/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Memorystore for Redis API Client
+=======================================================
+
+.. automodule:: google.cloud.redis_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/redis/docs/index.rst b/redis/docs/index.rst
new file mode 100644
index 000000000000..5338f59ab023
--- /dev/null
+++ b/redis/docs/index.rst
@@ -0,0 +1,11 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+    gapic/v1beta1/api
+    gapic/v1beta1/types
diff --git a/redis/google/__init__.py b/redis/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/redis/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/redis/google/cloud/__init__.py b/redis/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/redis/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/redis/google/cloud/redis.py b/redis/google/cloud/redis.py
new file mode 100644
index 000000000000..d9b71e7bcd2f
--- /dev/null
+++ b/redis/google/cloud/redis.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.redis_v1 import CloudRedisClient
+from google.cloud.redis_v1 import enums
+from google.cloud.redis_v1 import types
+
+
+__all__ = ("enums", "types", "CloudRedisClient")
diff --git a/redis/google/cloud/redis_v1/__init__.py b/redis/google/cloud/redis_v1/__init__.py
new file mode 100644
index 000000000000..1908b57c9ce4
--- /dev/null
+++ b/redis/google/cloud/redis_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.redis_v1 import types
+from google.cloud.redis_v1.gapic import cloud_redis_client
+from google.cloud.redis_v1.gapic import enums
+
+
+class CloudRedisClient(cloud_redis_client.CloudRedisClient):
+    __doc__ = cloud_redis_client.CloudRedisClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudRedisClient")
diff --git a/redis/google/cloud/redis_v1/gapic/__init__.py b/redis/google/cloud/redis_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/redis/google/cloud/redis_v1/gapic/cloud_redis_client.py b/redis/google/cloud/redis_v1/gapic/cloud_redis_client.py
new file mode 100644
index 000000000000..2cec791768ac
--- /dev/null
+++ b/redis/google/cloud/redis_v1/gapic/cloud_redis_client.py
@@ -0,0 +1,1033 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.redis.v1 CloudRedis API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.redis_v1.gapic import cloud_redis_client_config
+from google.cloud.redis_v1.gapic import enums
+from google.cloud.redis_v1.gapic.transports import cloud_redis_grpc_transport
+from google.cloud.redis_v1.proto import cloud_redis_pb2
+from google.cloud.redis_v1.proto import cloud_redis_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-redis").version
+
+
+class CloudRedisClient(object):
+    """
+    Configures and manages Cloud Memorystore for Redis instances
+
+    Google Cloud Memorystore for Redis v1
+
+    The ``redis.googleapis.com`` service implements the Google Cloud
+    Memorystore for Redis API and defines the following resource model for
+    managing Redis 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 Redis instances, named:
+       ``/instances/*``
+    -  As such, Redis instances are resources of the form:
+       ``/projects/{project_id}/locations/{location_id}/instances/{instance_id}``
+
+    Note that location\_id must be referring to a GCP ``region``; for
+    example:
+
+    -  ``projects/redpepper-1290/locations/us-central1/instances/my-redis``
+    """
+
+    SERVICE_ADDRESS = "redis.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.redis.v1.CloudRedis"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudRedisClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def instance_path(cls, project, location, instance):
+        """Return a fully-qualified instance string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/instances/{instance}",
+            project=project,
+            location=location,
+            instance=instance,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudRedisGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudRedisGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_redis_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_redis_grpc_transport.CloudRedisGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_redis_grpc_transport.CloudRedisGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_instances(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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
+        available to the project are queried, and the results are aggregated.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_instances(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_instances(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.redis_v1.types.Instance` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_instances" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_instances"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_instances,
+                default_retry=self._method_configs["ListInstances"].retry,
+                default_timeout=self._method_configs["ListInstances"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.ListInstancesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_instances"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="instances",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the details of a specific Redis instance.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> response = client.get_instance(name)
+
+        Args:
+            name (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types.Instance` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_instance,
+                default_retry=self._method_configs["GetInstance"].retry,
+                default_timeout=self._method_configs["GetInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.GetInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_instance(
+        self,
+        parent,
+        instance_id,
+        instance,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a Redis instance based on the specified tier and memory size.
+
+        By default, the instance is accessible from the project's `default
+        network <https://cloud.google.com/compute/docs/networks-and-firewalls#networks>`__.
+
+        The creation is executed asynchronously and callers may check the
+        returned operation to track its progress. Once the operation is
+        completed the Redis instance will be fully functional. Completed
+        longrunning.Operation will contain the new instance object in the
+        response field.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>> from google.cloud.redis_v1 import enums
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>> instance_id = 'test_instance'
+            >>> tier = enums.Instance.Tier.BASIC
+            >>> memory_size_gb = 1
+            >>> instance = {'tier': tier, 'memory_size_gb': memory_size_gb}
+            >>>
+            >>> response = client.create_instance(parent, instance_id, instance)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): 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.
+            instance_id (str): Required. The logical name of the Redis instance in the customer 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 customer project / location
+            instance (Union[dict, ~google.cloud.redis_v1.types.Instance]): Required. A Redis [Instance] resource
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1.types.Instance`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_instance,
+                default_retry=self._method_configs["CreateInstance"].retry,
+                default_timeout=self._method_configs["CreateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=cloud_redis_pb2.OperationMetadata,
+        )
+
+    def update_instance(
+        self,
+        update_mask,
+        instance,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the metadata and configuration of a specific Redis instance.
+
+        Completed longrunning.Operation will contain the new instance object
+        in the response field. The returned operation is automatically deleted
+        after a few hours, so there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> paths_element = 'display_name'
+            >>> paths_element_2 = 'memory_size_gb'
+            >>> paths = [paths_element, paths_element_2]
+            >>> update_mask = {'paths': paths}
+            >>> display_name = ' instance.memory_size_gb=4'
+            >>> instance = {'display_name': display_name}
+            >>>
+            >>> response = client.update_instance(update_mask, instance)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            update_mask (Union[dict, ~google.cloud.redis_v1.types.FieldMask]): 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``:
+
+                -  ``displayName``
+                -  ``labels``
+                -  ``memorySizeGb``
+                -  ``redisConfig``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1.types.FieldMask`
+            instance (Union[dict, ~google.cloud.redis_v1.types.Instance]): Required. Update description. Only fields specified in update\_mask are
+                updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1.types.Instance`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_instance,
+                default_retry=self._method_configs["UpdateInstance"].retry,
+                default_timeout=self._method_configs["UpdateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.UpdateInstanceRequest(
+            update_mask=update_mask, instance=instance
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("instance.name", instance.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["update_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=cloud_redis_pb2.OperationMetadata,
+        )
+
+    def import_instance(
+        self,
+        name,
+        input_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+
+        Redis may stop serving during this operation. Instance state will be
+        IMPORTING for entire operation. When complete, the instance will contain
+        only data from the imported file.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_instance(name, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            input_config (Union[dict, ~google.cloud.redis_v1.types.InputConfig]): Required. Specify data to be imported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1.types.InputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_instance,
+                default_retry=self._method_configs["ImportInstance"].retry,
+                default_timeout=self._method_configs["ImportInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.ImportInstanceRequest(
+            name=name, input_config=input_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=cloud_redis_pb2.OperationMetadata,
+        )
+
+    def export_instance(
+        self,
+        name,
+        output_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Export Redis instance data into a Redis RDB format file in Cloud Storage.
+
+        Redis will continue serving during this operation.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_instance(name, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            output_config (Union[dict, ~google.cloud.redis_v1.types.OutputConfig]): Required. Specify data to be exported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1.types.OutputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_instance,
+                default_retry=self._method_configs["ExportInstance"].retry,
+                default_timeout=self._method_configs["ExportInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.ExportInstanceRequest(
+            name=name, output_config=output_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=cloud_redis_pb2.OperationMetadata,
+        )
+
+    def failover_instance(
+        self,
+        name,
+        data_protection_mode,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Initiates a failover of the master node to current replica node for a
+        specific STANDARD tier Cloud Memorystore for Redis instance.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>> from google.cloud.redis_v1 import enums
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `data_protection_mode`:
+            >>> data_protection_mode = enums.FailoverInstanceRequest.DataProtectionMode.DATA_PROTECTION_MODE_UNSPECIFIED
+            >>>
+            >>> response = client.failover_instance(name, data_protection_mode)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            data_protection_mode (~google.cloud.redis_v1.types.DataProtectionMode): Optional. Available data protection modes that the user can choose. If
+                it's unspecified, data protection mode will be LIMITED\_DATA\_LOSS by
+                default.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "failover_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "failover_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.failover_instance,
+                default_retry=self._method_configs["FailoverInstance"].retry,
+                default_timeout=self._method_configs["FailoverInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.FailoverInstanceRequest(
+            name=name, data_protection_mode=data_protection_mode
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["failover_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=cloud_redis_pb2.OperationMetadata,
+        )
+
+    def delete_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a specific Redis instance.  Instance stops serving and data is
+        deleted.
+
+        Example:
+            >>> from google.cloud import redis_v1
+            >>>
+            >>> client = redis_v1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> response = client.delete_instance(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_instance,
+                default_retry=self._method_configs["DeleteInstance"].retry,
+                default_timeout=self._method_configs["DeleteInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.DeleteInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["delete_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=cloud_redis_pb2.OperationMetadata,
+        )
diff --git a/redis/google/cloud/redis_v1/gapic/cloud_redis_client_config.py b/redis/google/cloud/redis_v1/gapic/cloud_redis_client_config.py
new file mode 100644
index 000000000000..9d0264891f0b
--- /dev/null
+++ b/redis/google/cloud/redis_v1/gapic/cloud_redis_client_config.py
@@ -0,0 +1,63 @@
+config = {
+    "interfaces": {
+        "google.cloud.redis.v1.CloudRedis": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListInstances": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "FailoverInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/redis/google/cloud/redis_v1/gapic/enums.py b/redis/google/cloud/redis_v1/gapic/enums.py
new file mode 100644
index 000000000000..ede91f2a3be8
--- /dev/null
+++ b/redis/google/cloud/redis_v1/gapic/enums.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class FailoverInstanceRequest(object):
+    class DataProtectionMode(enum.IntEnum):
+        """
+        Attributes:
+          DATA_PROTECTION_MODE_UNSPECIFIED (int): Defaults to LIMITED\_DATA\_LOSS if a data protection mode is not
+          specified.
+          LIMITED_DATA_LOSS (int): Instance failover will be protected with data loss control. More
+          specifically, the failover will only be performed if the current
+          replication offset diff between master and replica is under a certain
+          threshold.
+          FORCE_DATA_LOSS (int): Instance failover will be performed without data loss control.
+        """
+
+        DATA_PROTECTION_MODE_UNSPECIFIED = 0
+        LIMITED_DATA_LOSS = 1
+        FORCE_DATA_LOSS = 2
+
+
+class Instance(object):
+    class State(enum.IntEnum):
+        """
+        Represents the different states of a Redis instance.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Not set.
+          CREATING (int): Redis instance is being created.
+          READY (int): Redis instance has been created and is fully usable.
+          UPDATING (int): Redis instance configuration is being updated. Certain kinds of updates
+          may cause the instance to become unusable while the update is in
+          progress.
+          DELETING (int): Redis instance is being deleted.
+          REPAIRING (int): Redis instance is being repaired and may be unusable.
+          MAINTENANCE (int): Maintenance is being performed on this Redis instance.
+          IMPORTING (int): Redis instance is importing data (availability may be affected).
+          FAILING_OVER (int): Redis instance is failing over (availability may be affected).
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATING = 1
+        READY = 2
+        UPDATING = 3
+        DELETING = 4
+        REPAIRING = 5
+        MAINTENANCE = 6
+        IMPORTING = 8
+        FAILING_OVER = 9
+
+    class Tier(enum.IntEnum):
+        """
+        Available service tiers to choose from
+
+        Attributes:
+          TIER_UNSPECIFIED (int): Not set.
+          BASIC (int): BASIC tier: standalone instance
+          STANDARD_HA (int): STANDARD\_HA tier: highly available primary/replica instances
+        """
+
+        TIER_UNSPECIFIED = 0
+        BASIC = 1
+        STANDARD_HA = 3
diff --git a/redis/google/cloud/redis_v1/gapic/transports/__init__.py b/redis/google/cloud/redis_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/redis/google/cloud/redis_v1/gapic/transports/cloud_redis_grpc_transport.py b/redis/google/cloud/redis_v1/gapic/transports/cloud_redis_grpc_transport.py
new file mode 100644
index 000000000000..e10be5fecd6a
--- /dev/null
+++ b/redis/google/cloud/redis_v1/gapic/transports/cloud_redis_grpc_transport.py
@@ -0,0 +1,256 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.redis_v1.proto import cloud_redis_pb2_grpc
+
+
+class CloudRedisGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.redis.v1 CloudRedis API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="redis.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"cloud_redis_stub": cloud_redis_pb2_grpc.CloudRedisStub(channel)}
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="redis.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_instances(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.list_instances`.
+
+        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
+        available to the project are queried, and the results are aggregated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].ListInstances
+
+    @property
+    def get_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.get_instance`.
+
+        Gets the details of a specific Redis instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].GetInstance
+
+    @property
+    def create_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.create_instance`.
+
+        Creates a Redis instance based on the specified tier and memory size.
+
+        By default, the instance is accessible from the project's `default
+        network <https://cloud.google.com/compute/docs/networks-and-firewalls#networks>`__.
+
+        The creation is executed asynchronously and callers may check the
+        returned operation to track its progress. Once the operation is
+        completed the Redis instance will be fully functional. Completed
+        longrunning.Operation will contain the new instance object in the
+        response field.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].CreateInstance
+
+    @property
+    def update_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.update_instance`.
+
+        Updates the metadata and configuration of a specific Redis instance.
+
+        Completed longrunning.Operation will contain the new instance object
+        in the response field. The returned operation is automatically deleted
+        after a few hours, so there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].UpdateInstance
+
+    @property
+    def import_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.import_instance`.
+
+        Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+
+        Redis may stop serving during this operation. Instance state will be
+        IMPORTING for entire operation. When complete, the instance will contain
+        only data from the imported file.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].ImportInstance
+
+    @property
+    def export_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.export_instance`.
+
+        Export Redis instance data into a Redis RDB format file in Cloud Storage.
+
+        Redis will continue serving during this operation.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].ExportInstance
+
+    @property
+    def failover_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.failover_instance`.
+
+        Initiates a failover of the master node to current replica node for a
+        specific STANDARD tier Cloud Memorystore for Redis instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].FailoverInstance
+
+    @property
+    def delete_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.delete_instance`.
+
+        Deletes a specific Redis instance.  Instance stops serving and data is
+        deleted.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].DeleteInstance
diff --git a/redis/google/cloud/redis_v1/proto/__init__.py b/redis/google/cloud/redis_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/redis/google/cloud/redis_v1/proto/cloud_redis.proto b/redis/google/cloud/redis_v1/proto/cloud_redis.proto
new file mode 100644
index 000000000000..65366ca432ab
--- /dev/null
+++ b/redis/google/cloud/redis_v1/proto/cloud_redis.proto
@@ -0,0 +1,514 @@
+// 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.redis.v1;
+
+import "google/api/annotations.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;
+option java_outer_classname = "CloudRedisServiceV1Proto";
+option java_package = "com.google.cloud.redis.v1";
+
+// Configures and manages Cloud Memorystore for Redis instances
+//
+// Google Cloud Memorystore for Redis v1
+//
+// The `redis.googleapis.com` service implements the Google Cloud Memorystore
+// for Redis API and defines the following resource model for managing Redis
+// 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 Redis instances, named: `/instances/*`
+// * As such, Redis instances are resources of the form:
+//   `/projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+//
+// Note that location_id must be referring to a GCP `region`; for example:
+// * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
+service CloudRedis {
+  option (google.api.default_host) = "redis.googleapis.com";
+
+  // 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
+  // available to the project are queried, and the results are aggregated.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/instances"
+    };
+  }
+
+  // Gets the details of a specific Redis instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/instances/*}"
+    };
+  }
+
+  // Creates a Redis instance based on the specified tier and memory size.
+  //
+  // By default, the instance is accessible from the project's
+  // [default network](/compute/docs/networks-and-firewalls#networks).
+  //
+  // The creation is executed asynchronously and callers may check the returned
+  // operation to track its progress. Once the operation is completed the Redis
+  // instance will be fully functional. Completed longrunning.Operation will
+  // contain the new instance object in the response field.
+  //
+  // The returned operation is automatically deleted after a few hours, so there
+  // is no need to call DeleteOperation.
+  rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/instances"
+      body: "instance"
+    };
+  }
+
+  // Updates the metadata and configuration of a specific Redis instance.
+  //
+  // Completed longrunning.Operation will contain the new instance object
+  // in the response field. The returned operation is automatically deleted
+  // after a few hours, so there is no need to call DeleteOperation.
+  rpc UpdateInstance(UpdateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/{instance.name=projects/*/locations/*/instances/*}"
+      body: "instance"
+    };
+  }
+
+  // Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+  //
+  // Redis may stop serving during this operation. Instance state will be
+  // IMPORTING for entire operation. When complete, the instance will contain
+  // only data from the imported file.
+  //
+  // The returned operation is automatically deleted after a few hours, so
+  // there is no need to call DeleteOperation.
+  rpc ImportInstance(ImportInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/instances/*}:import"
+      body: "*"
+    };
+  }
+
+  // Export Redis instance data into a Redis RDB format file in Cloud Storage.
+  //
+  // Redis will continue serving during this operation.
+  //
+  // The returned operation is automatically deleted after a few hours, so
+  // there is no need to call DeleteOperation.
+  rpc ExportInstance(ExportInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/instances/*}:export"
+      body: "*"
+    };
+  }
+
+  // Initiates a failover of the master node to current replica node for a
+  // specific STANDARD tier Cloud Memorystore for Redis instance.
+  rpc FailoverInstance(FailoverInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/instances/*}:failover"
+      body: "*"
+    };
+  }
+
+  // Deletes a specific Redis instance.  Instance stops serving and data is
+  // deleted.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/instances/*}"
+    };
+  }
+}
+
+// A Google Cloud Redis instance.
+message Instance {
+  // Represents the different states of a Redis instance.
+  enum State {
+    // Not set.
+    STATE_UNSPECIFIED = 0;
+
+    // Redis instance is being created.
+    CREATING = 1;
+
+    // Redis instance has been created and is fully usable.
+    READY = 2;
+
+    // Redis instance configuration is being updated. Certain kinds of updates
+    // may cause the instance to become unusable while the update is in
+    // progress.
+    UPDATING = 3;
+
+    // Redis instance is being deleted.
+    DELETING = 4;
+
+    // Redis instance is being repaired and may be unusable.
+    REPAIRING = 5;
+
+    // Maintenance is being performed on this Redis instance.
+    MAINTENANCE = 6;
+
+    // Redis instance is importing data (availability may be affected).
+    IMPORTING = 8;
+
+    // Redis instance is failing over (availability may be affected).
+    FAILING_OVER = 9;
+  }
+
+  // Available service tiers to choose from
+  enum Tier {
+    // Not set.
+    TIER_UNSPECIFIED = 0;
+
+    // BASIC tier: standalone instance
+    BASIC = 1;
+
+    // STANDARD_HA tier: highly available primary/replica instances
+    STANDARD_HA = 3;
+  }
+
+  // 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: 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;
+
+  // An arbitrary and optional user-provided name for the instance.
+  string display_name = 2;
+
+  // Resource labels to represent user provided metadata
+  map<string, string> labels = 3;
+
+  // 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;
+
+  // 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;
+
+  // 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:
+  //
+  //  *   `REDIS_4_0` for Redis 4.0 compatibility (default)
+  //  *   `REDIS_3_2` for Redis 3.2 compatibility
+  string redis_version = 7;
+
+  // 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;
+
+  // Output only. Hostname or IP address of the exposed Redis endpoint used by
+  // clients to connect to the service.
+  string host = 10;
+
+  // Output only. The port number of the exposed Redis endpoint.
+  int32 port = 11;
+
+  // 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]
+  // provided by the user at creation time. For Standard Tier instances,
+  // this can be either [location_id] or [alternative_location_id] and can
+  // change after a failover event.
+  string current_location_id = 12;
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 13;
+
+  // Output only. The current state of this instance.
+  State state = 14;
+
+  // Output only. Additional information about the current status of this
+  // instance, if available.
+  string status_message = 15;
+
+  // Optional. Redis configuration parameters, according to
+  // http://redis.io/topics/config. Currently, the only supported parameters
+  // are:
+  //
+  //  Redis 3.2 and above:
+  //
+  //  *   maxmemory-policy
+  //  *   notify-keyspace-events
+  //
+  //  Redis 4.0 and above:
+  //
+  //  *   activedefrag
+  //  *   lfu-log-factor
+  //  *   lfu-decay-time
+  map<string, string> redis_configs = 16;
+
+  // Required. The service tier of the instance.
+  Tier tier = 17;
+
+  // Required. Redis memory size in GiB.
+  int32 memory_size_gb = 18;
+
+  // 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;
+
+  // Output only. Cloud IAM identity used by import / export operations to
+  // transfer data to/from Cloud Storage. Format is
+  // "serviceAccount:<service_account_email>". The value may change over time
+  // for a given instance so should be checked before each import/export
+  // operation.
+  string persistence_iam_identity = 21;
+}
+
+// Request for [ListInstances][google.cloud.redis.v1.CloudRedis.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;
+
+  // 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]
+  // 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;
+}
+
+// Response for [ListInstances][google.cloud.redis.v1.CloudRedis.ListInstances].
+message ListInstancesResponse {
+  // A list of Redis 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.
+  // 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".
+  repeated Instance instances = 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.redis.v1.CloudRedis.GetInstance].
+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;
+}
+
+// Request for [CreateInstance][google.cloud.redis.v1.CloudRedis.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;
+
+  // Required. The logical name of the Redis instance in the customer 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 customer project / location
+  string instance_id = 2;
+
+  // Required. A Redis [Instance] resource
+  Instance instance = 3;
+}
+
+// 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]:
+  //
+  //  *   `displayName`
+  //  *   `labels`
+  //  *   `memorySizeGb`
+  //  *   `redisConfig`
+  google.protobuf.FieldMask update_mask = 1;
+
+  // Required. Update description.
+  // Only fields specified in update_mask are updated.
+  Instance instance = 2;
+}
+
+// Request for [DeleteInstance][google.cloud.redis.v1.CloudRedis.DeleteInstance].
+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;
+}
+
+// The Cloud Storage location for the input content
+message GcsSource {
+  // Required. Source data URI. (e.g. 'gs://my_bucket/my_object').
+  string uri = 1;
+}
+
+// The input content
+message InputConfig {
+  // Required. Specify source location of input data
+  oneof source {
+    // Google Cloud Storage location where input content is located.
+    GcsSource gcs_source = 1;
+  }
+}
+
+// Request for [Import][google.cloud.redis.v1.CloudRedis.ImportInstance].
+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;
+
+  // Required. Specify data to be imported.
+  InputConfig input_config = 3;
+}
+
+// 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;
+}
+
+// The output content
+message OutputConfig {
+  // Required. Specify destination location of output data
+  oneof destination {
+    // Google Cloud Storage destination for output content.
+    GcsDestination gcs_destination = 1;
+  }
+}
+
+// Request for [Export][google.cloud.redis.v1.CloudRedis.ExportInstance].
+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;
+
+  // Required. Specify data to be exported.
+  OutputConfig output_config = 3;
+}
+
+// Request for [Failover][google.cloud.redis.v1.CloudRedis.FailoverInstance].
+message FailoverInstanceRequest {
+  enum DataProtectionMode {
+    // Defaults to LIMITED_DATA_LOSS if a data protection mode is not
+    // specified.
+    DATA_PROTECTION_MODE_UNSPECIFIED = 0;
+
+    // Instance failover will be protected with data loss control. More
+    // specifically, the failover will only be performed if the current
+    // replication offset diff between master and replica is under a certain
+    // threshold.
+    LIMITED_DATA_LOSS = 1;
+
+    // Instance failover will be performed without data loss control.
+    FORCE_DATA_LOSS = 2;
+  }
+
+  // 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;
+
+  // 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;
+}
+
+// Represents the v1 metadata of the long-running operation.
+message OperationMetadata {
+  // Creation timestamp.
+  google.protobuf.Timestamp create_time = 1;
+
+  // End timestamp.
+  google.protobuf.Timestamp end_time = 2;
+
+  // Operation target.
+  string target = 3;
+
+  // Operation verb.
+  string verb = 4;
+
+  // Operation status details.
+  string status_detail = 5;
+
+  // Specifies if cancellation was requested for the operation.
+  bool cancel_requested = 6;
+
+  // API version.
+  string api_version = 7;
+}
+
+// This location metadata represents additional configuration options for a
+// given location where a Redis instance may be created. All fields are output
+// only. It is returned as content of the
+// `google.cloud.location.Location.metadata` field.
+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 `location_id` or `alternative_location_id` fields when
+  // creating a Redis instance.
+  map<string, ZoneMetadata> available_zones = 1;
+}
+
+// Defines specific information for a particular zone. Currently empty and
+// reserved for future use only.
+message ZoneMetadata {
+
+}
diff --git a/redis/google/cloud/redis_v1/proto/cloud_redis_pb2.py b/redis/google/cloud/redis_v1/proto/cloud_redis_pb2.py
new file mode 100644
index 000000000000..92983de8facf
--- /dev/null
+++ b/redis/google/cloud/redis_v1/proto/cloud_redis_pb2.py
@@ -0,0 +1,2257 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/redis_v1/proto/cloud_redis.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/redis_v1/proto/cloud_redis.proto",
+    package="google.cloud.redis.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.redis.v1B\030CloudRedisServiceV1ProtoP\001Z:google.golang.org/genproto/googleapis/cloud/redis/v1;redis"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/redis_v1/proto/cloud_redis.proto\x12\x15google.cloud.redis.v1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/api/client.proto"\x94\x07\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12;\n\x06labels\x18\x03 \x03(\x0b\x32+.google.cloud.redis.v1.Instance.LabelsEntry\x12\x13\n\x0blocation_id\x18\x04 \x01(\t\x12\x1f\n\x17\x61lternative_location_id\x18\x05 \x01(\t\x12\x15\n\rredis_version\x18\x07 \x01(\t\x12\x19\n\x11reserved_ip_range\x18\t \x01(\t\x12\x0c\n\x04host\x18\n \x01(\t\x12\x0c\n\x04port\x18\x0b \x01(\x05\x12\x1b\n\x13\x63urrent_location_id\x18\x0c \x01(\t\x12/\n\x0b\x63reate_time\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x05state\x18\x0e \x01(\x0e\x32%.google.cloud.redis.v1.Instance.State\x12\x16\n\x0estatus_message\x18\x0f \x01(\t\x12H\n\rredis_configs\x18\x10 \x03(\x0b\x32\x31.google.cloud.redis.v1.Instance.RedisConfigsEntry\x12\x32\n\x04tier\x18\x11 \x01(\x0e\x32$.google.cloud.redis.v1.Instance.Tier\x12\x16\n\x0ememory_size_gb\x18\x12 \x01(\x05\x12\x1a\n\x12\x61uthorized_network\x18\x14 \x01(\t\x12 \n\x18persistence_iam_identity\x18\x15 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x33\n\x11RedisConfigsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x94\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x0c\n\x08UPDATING\x10\x03\x12\x0c\n\x08\x44\x45LETING\x10\x04\x12\r\n\tREPAIRING\x10\x05\x12\x0f\n\x0bMAINTENANCE\x10\x06\x12\r\n\tIMPORTING\x10\x08\x12\x10\n\x0c\x46\x41ILING_OVER\x10\t"8\n\x04Tier\x12\x14\n\x10TIER_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x0f\n\x0bSTANDARD_HA\x10\x03"M\n\x14ListInstancesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"y\n\x15ListInstancesResponse\x12\x32\n\tinstances\x18\x01 \x03(\x0b\x32\x1f.google.cloud.redis.v1.Instance\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x13\n\x0bunreachable\x18\x03 \x03(\t""\n\x12GetInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"o\n\x15\x43reateInstanceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0binstance_id\x18\x02 \x01(\t\x12\x31\n\x08instance\x18\x03 \x01(\x0b\x32\x1f.google.cloud.redis.v1.Instance"{\n\x15UpdateInstanceRequest\x12/\n\x0bupdate_mask\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x31\n\x08instance\x18\x02 \x01(\x0b\x32\x1f.google.cloud.redis.v1.Instance"%\n\x15\x44\x65leteInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x18\n\tGcsSource\x12\x0b\n\x03uri\x18\x01 \x01(\t"O\n\x0bInputConfig\x12\x36\n\ngcs_source\x18\x01 \x01(\x0b\x32 .google.cloud.redis.v1.GcsSourceH\x00\x42\x08\n\x06source"_\n\x15ImportInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x38\n\x0cinput_config\x18\x03 \x01(\x0b\x32".google.cloud.redis.v1.InputConfig"\x1d\n\x0eGcsDestination\x12\x0b\n\x03uri\x18\x01 \x01(\t"_\n\x0cOutputConfig\x12@\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32%.google.cloud.redis.v1.GcsDestinationH\x00\x42\r\n\x0b\x64\x65stination"a\n\x15\x45xportInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12:\n\routput_config\x18\x03 \x01(\x0b\x32#.google.cloud.redis.v1.OutputConfig"\xf0\x01\n\x17\x46\x61iloverInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12_\n\x14\x64\x61ta_protection_mode\x18\x02 \x01(\x0e\x32\x41.google.cloud.redis.v1.FailoverInstanceRequest.DataProtectionMode"f\n\x12\x44\x61taProtectionMode\x12$\n DATA_PROTECTION_MODE_UNSPECIFIED\x10\x00\x12\x15\n\x11LIMITED_DATA_LOSS\x10\x01\x12\x13\n\x0f\x46ORCE_DATA_LOSS\x10\x02"\xd6\x01\n\x11OperationMetadata\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06target\x18\x03 \x01(\t\x12\x0c\n\x04verb\x18\x04 \x01(\t\x12\x15\n\rstatus_detail\x18\x05 \x01(\t\x12\x18\n\x10\x63\x61ncel_requested\x18\x06 \x01(\x08\x12\x13\n\x0b\x61pi_version\x18\x07 \x01(\t"\xc4\x01\n\x10LocationMetadata\x12T\n\x0f\x61vailable_zones\x18\x01 \x03(\x0b\x32;.google.cloud.redis.v1.LocationMetadata.AvailableZonesEntry\x1aZ\n\x13\x41vailableZonesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x32\n\x05value\x18\x02 \x01(\x0b\x32#.google.cloud.redis.v1.ZoneMetadata:\x02\x38\x01"\x0e\n\x0cZoneMetadata2\xa7\n\n\nCloudRedis\x12\xa1\x01\n\rListInstances\x12+.google.cloud.redis.v1.ListInstancesRequest\x1a,.google.cloud.redis.v1.ListInstancesResponse"5\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/locations/*}/instances\x12\x90\x01\n\x0bGetInstance\x12).google.cloud.redis.v1.GetInstanceRequest\x1a\x1f.google.cloud.redis.v1.Instance"5\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/locations/*/instances/*}\x12\x9e\x01\n\x0e\x43reateInstance\x12,.google.cloud.redis.v1.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation"?\x82\xd3\xe4\x93\x02\x39"-/v1/{parent=projects/*/locations/*}/instances:\x08instance\x12\xa7\x01\n\x0eUpdateInstance\x12,.google.cloud.redis.v1.UpdateInstanceRequest\x1a\x1d.google.longrunning.Operation"H\x82\xd3\xe4\x93\x02\x42\x32\x36/v1/{instance.name=projects/*/locations/*/instances/*}:\x08instance\x12\x9e\x01\n\x0eImportInstance\x12,.google.cloud.redis.v1.ImportInstanceRequest\x1a\x1d.google.longrunning.Operation"?\x82\xd3\xe4\x93\x02\x39"4/v1/{name=projects/*/locations/*/instances/*}:import:\x01*\x12\x9e\x01\n\x0e\x45xportInstance\x12,.google.cloud.redis.v1.ExportInstanceRequest\x1a\x1d.google.longrunning.Operation"?\x82\xd3\xe4\x93\x02\x39"4/v1/{name=projects/*/locations/*/instances/*}:export:\x01*\x12\xa4\x01\n\x10\x46\x61iloverInstance\x12..google.cloud.redis.v1.FailoverInstanceRequest\x1a\x1d.google.longrunning.Operation"A\x82\xd3\xe4\x93\x02;"6/v1/{name=projects/*/locations/*/instances/*}:failover:\x01*\x12\x94\x01\n\x0e\x44\x65leteInstance\x12,.google.cloud.redis.v1.DeleteInstanceRequest\x1a\x1d.google.longrunning.Operation"5\x82\xd3\xe4\x93\x02/*-/v1/{name=projects/*/locations/*/instances/*}\x1a\x17\xca\x41\x14redis.googleapis.comBs\n\x19\x63om.google.cloud.redis.v1B\x18\x43loudRedisServiceV1ProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/redis/v1;redisb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_INSTANCE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.redis.v1.Instance.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPAIRING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MAINTENANCE", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPORTING", index=7, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILING_OVER", index=8, number=9, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=942,
+    serialized_end=1090,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_STATE)
+
+_INSTANCE_TIER = _descriptor.EnumDescriptor(
+    name="Tier",
+    full_name="google.cloud.redis.v1.Instance.Tier",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TIER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STANDARD_HA", index=2, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1092,
+    serialized_end=1148,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_TIER)
+
+_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE = _descriptor.EnumDescriptor(
+    name="DataProtectionMode",
+    full_name="google.cloud.redis.v1.FailoverInstanceRequest.DataProtectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_PROTECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIMITED_DATA_LOSS",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FORCE_DATA_LOSS",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2235,
+    serialized_end=2337,
+)
+_sym_db.RegisterEnumDescriptor(_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE)
+
+
+_INSTANCE_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.redis.v1.Instance.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.redis.v1.Instance.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.redis.v1.Instance.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=841,
+    serialized_end=886,
+)
+
+_INSTANCE_REDISCONFIGSENTRY = _descriptor.Descriptor(
+    name="RedisConfigsEntry",
+    full_name="google.cloud.redis.v1.Instance.RedisConfigsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.redis.v1.Instance.RedisConfigsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.redis.v1.Instance.RedisConfigsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=888,
+    serialized_end=939,
+)
+
+_INSTANCE = _descriptor.Descriptor(
+    name="Instance",
+    full_name="google.cloud.redis.v1.Instance",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1.Instance.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.redis.v1.Instance.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.redis.v1.Instance.labels",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.redis.v1.Instance.location_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alternative_location_id",
+            full_name="google.cloud.redis.v1.Instance.alternative_location_id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redis_version",
+            full_name="google.cloud.redis.v1.Instance.redis_version",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reserved_ip_range",
+            full_name="google.cloud.redis.v1.Instance.reserved_ip_range",
+            index=6,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.redis.v1.Instance.host",
+            index=7,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="port",
+            full_name="google.cloud.redis.v1.Instance.port",
+            index=8,
+            number=11,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_location_id",
+            full_name="google.cloud.redis.v1.Instance.current_location_id",
+            index=9,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.redis.v1.Instance.create_time",
+            index=10,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.redis.v1.Instance.state",
+            index=11,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.cloud.redis.v1.Instance.status_message",
+            index=12,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redis_configs",
+            full_name="google.cloud.redis.v1.Instance.redis_configs",
+            index=13,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tier",
+            full_name="google.cloud.redis.v1.Instance.tier",
+            index=14,
+            number=17,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="memory_size_gb",
+            full_name="google.cloud.redis.v1.Instance.memory_size_gb",
+            index=15,
+            number=18,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authorized_network",
+            full_name="google.cloud.redis.v1.Instance.authorized_network",
+            index=16,
+            number=20,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="persistence_iam_identity",
+            full_name="google.cloud.redis.v1.Instance.persistence_iam_identity",
+            index=17,
+            number=21,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSTANCE_LABELSENTRY, _INSTANCE_REDISCONFIGSENTRY],
+    enum_types=[_INSTANCE_STATE, _INSTANCE_TIER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=232,
+    serialized_end=1148,
+)
+
+
+_LISTINSTANCESREQUEST = _descriptor.Descriptor(
+    name="ListInstancesRequest",
+    full_name="google.cloud.redis.v1.ListInstancesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.redis.v1.ListInstancesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.redis.v1.ListInstancesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.redis.v1.ListInstancesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1150,
+    serialized_end=1227,
+)
+
+
+_LISTINSTANCESRESPONSE = _descriptor.Descriptor(
+    name="ListInstancesResponse",
+    full_name="google.cloud.redis.v1.ListInstancesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instances",
+            full_name="google.cloud.redis.v1.ListInstancesResponse.instances",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.redis.v1.ListInstancesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unreachable",
+            full_name="google.cloud.redis.v1.ListInstancesResponse.unreachable",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1229,
+    serialized_end=1350,
+)
+
+
+_GETINSTANCEREQUEST = _descriptor.Descriptor(
+    name="GetInstanceRequest",
+    full_name="google.cloud.redis.v1.GetInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1.GetInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1352,
+    serialized_end=1386,
+)
+
+
+_CREATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="CreateInstanceRequest",
+    full_name="google.cloud.redis.v1.CreateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.redis.v1.CreateInstanceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.cloud.redis.v1.CreateInstanceRequest.instance_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.redis.v1.CreateInstanceRequest.instance",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1388,
+    serialized_end=1499,
+)
+
+
+_UPDATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="UpdateInstanceRequest",
+    full_name="google.cloud.redis.v1.UpdateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.redis.v1.UpdateInstanceRequest.update_mask",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.redis.v1.UpdateInstanceRequest.instance",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1501,
+    serialized_end=1624,
+)
+
+
+_DELETEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="DeleteInstanceRequest",
+    full_name="google.cloud.redis.v1.DeleteInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1.DeleteInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1626,
+    serialized_end=1663,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.redis.v1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.redis.v1.GcsSource.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1665,
+    serialized_end=1689,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.redis.v1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.redis.v1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.redis.v1.InputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1691,
+    serialized_end=1770,
+)
+
+
+_IMPORTINSTANCEREQUEST = _descriptor.Descriptor(
+    name="ImportInstanceRequest",
+    full_name="google.cloud.redis.v1.ImportInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1.ImportInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.redis.v1.ImportInstanceRequest.input_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1772,
+    serialized_end=1867,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.redis.v1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.redis.v1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1869,
+    serialized_end=1898,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.redis.v1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.redis.v1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.redis.v1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1900,
+    serialized_end=1995,
+)
+
+
+_EXPORTINSTANCEREQUEST = _descriptor.Descriptor(
+    name="ExportInstanceRequest",
+    full_name="google.cloud.redis.v1.ExportInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1.ExportInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.redis.v1.ExportInstanceRequest.output_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1997,
+    serialized_end=2094,
+)
+
+
+_FAILOVERINSTANCEREQUEST = _descriptor.Descriptor(
+    name="FailoverInstanceRequest",
+    full_name="google.cloud.redis.v1.FailoverInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1.FailoverInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_protection_mode",
+            full_name="google.cloud.redis.v1.FailoverInstanceRequest.data_protection_mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2097,
+    serialized_end=2337,
+)
+
+
+_OPERATIONMETADATA = _descriptor.Descriptor(
+    name="OperationMetadata",
+    full_name="google.cloud.redis.v1.OperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.redis.v1.OperationMetadata.create_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.redis.v1.OperationMetadata.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target",
+            full_name="google.cloud.redis.v1.OperationMetadata.target",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="verb",
+            full_name="google.cloud.redis.v1.OperationMetadata.verb",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_detail",
+            full_name="google.cloud.redis.v1.OperationMetadata.status_detail",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cancel_requested",
+            full_name="google.cloud.redis.v1.OperationMetadata.cancel_requested",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="api_version",
+            full_name="google.cloud.redis.v1.OperationMetadata.api_version",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2340,
+    serialized_end=2554,
+)
+
+
+_LOCATIONMETADATA_AVAILABLEZONESENTRY = _descriptor.Descriptor(
+    name="AvailableZonesEntry",
+    full_name="google.cloud.redis.v1.LocationMetadata.AvailableZonesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.redis.v1.LocationMetadata.AvailableZonesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.redis.v1.LocationMetadata.AvailableZonesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2663,
+    serialized_end=2753,
+)
+
+_LOCATIONMETADATA = _descriptor.Descriptor(
+    name="LocationMetadata",
+    full_name="google.cloud.redis.v1.LocationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="available_zones",
+            full_name="google.cloud.redis.v1.LocationMetadata.available_zones",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_LOCATIONMETADATA_AVAILABLEZONESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2557,
+    serialized_end=2753,
+)
+
+
+_ZONEMETADATA = _descriptor.Descriptor(
+    name="ZoneMetadata",
+    full_name="google.cloud.redis.v1.ZoneMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2755,
+    serialized_end=2769,
+)
+
+_INSTANCE_LABELSENTRY.containing_type = _INSTANCE
+_INSTANCE_REDISCONFIGSENTRY.containing_type = _INSTANCE
+_INSTANCE.fields_by_name["labels"].message_type = _INSTANCE_LABELSENTRY
+_INSTANCE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INSTANCE.fields_by_name["state"].enum_type = _INSTANCE_STATE
+_INSTANCE.fields_by_name["redis_configs"].message_type = _INSTANCE_REDISCONFIGSENTRY
+_INSTANCE.fields_by_name["tier"].enum_type = _INSTANCE_TIER
+_INSTANCE_STATE.containing_type = _INSTANCE
+_INSTANCE_TIER.containing_type = _INSTANCE
+_LISTINSTANCESRESPONSE.fields_by_name["instances"].message_type = _INSTANCE
+_CREATEINSTANCEREQUEST.fields_by_name["instance"].message_type = _INSTANCE
+_UPDATEINSTANCEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEINSTANCEREQUEST.fields_by_name["instance"].message_type = _INSTANCE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["gcs_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_IMPORTINSTANCEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_EXPORTINSTANCEREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_FAILOVERINSTANCEREQUEST.fields_by_name[
+    "data_protection_mode"
+].enum_type = _FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE
+_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE.containing_type = _FAILOVERINSTANCEREQUEST
+_OPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LOCATIONMETADATA_AVAILABLEZONESENTRY.fields_by_name[
+    "value"
+].message_type = _ZONEMETADATA
+_LOCATIONMETADATA_AVAILABLEZONESENTRY.containing_type = _LOCATIONMETADATA
+_LOCATIONMETADATA.fields_by_name[
+    "available_zones"
+].message_type = _LOCATIONMETADATA_AVAILABLEZONESENTRY
+DESCRIPTOR.message_types_by_name["Instance"] = _INSTANCE
+DESCRIPTOR.message_types_by_name["ListInstancesRequest"] = _LISTINSTANCESREQUEST
+DESCRIPTOR.message_types_by_name["ListInstancesResponse"] = _LISTINSTANCESRESPONSE
+DESCRIPTOR.message_types_by_name["GetInstanceRequest"] = _GETINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["CreateInstanceRequest"] = _CREATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateInstanceRequest"] = _UPDATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteInstanceRequest"] = _DELETEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["ImportInstanceRequest"] = _IMPORTINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["ExportInstanceRequest"] = _EXPORTINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["FailoverInstanceRequest"] = _FAILOVERINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["OperationMetadata"] = _OPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["LocationMetadata"] = _LOCATIONMETADATA
+DESCRIPTOR.message_types_by_name["ZoneMetadata"] = _ZONEMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Instance = _reflection.GeneratedProtocolMessageType(
+    "Instance",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANCE_LABELSENTRY,
+                __module__="google.cloud.redis_v1.proto.cloud_redis_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.Instance.LabelsEntry)
+            ),
+        ),
+        RedisConfigsEntry=_reflection.GeneratedProtocolMessageType(
+            "RedisConfigsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANCE_REDISCONFIGSENTRY,
+                __module__="google.cloud.redis_v1.proto.cloud_redis_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.Instance.RedisConfigsEntry)
+            ),
+        ),
+        DESCRIPTOR=_INSTANCE,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""A Google Cloud Redis instance.
+  
+  
+  Attributes:
+      name:
+          Required. Unique name of the resource in this scope including
+          project and location using the form: ``projects/{project_id}/l
+          ocations/{location_id}/instances/{instance_id}``  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.
+      display_name:
+          An arbitrary and optional user-provided name for the instance.
+      labels:
+          Resource labels to represent user provided metadata
+      location_id:
+          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].
+      alternative_location_id:
+          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].
+      redis_version:
+          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:  -  ``REDIS_4_0`` for
+          Redis 4.0 compatibility (default) -  ``REDIS_3_2`` for Redis
+          3.2 compatibility
+      reserved_ip_range:
+          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.
+      host:
+          Output only. Hostname or IP address of the exposed Redis
+          endpoint used by clients to connect to the service.
+      port:
+          Output only. The port number of the exposed Redis endpoint.
+      current_location_id:
+          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] provided by the user at creation time.
+          For Standard Tier instances, this can be either [location\_id]
+          or [alternative\_location\_id] and can change after a failover
+          event.
+      create_time:
+          Output only. The time the instance was created.
+      state:
+          Output only. The current state of this instance.
+      status_message:
+          Output only. Additional information about the current status
+          of this instance, if available.
+      redis_configs:
+          Optional. Redis configuration parameters, according to
+          http://redis.io/topics/config. Currently, the only supported
+          parameters are:  Redis 3.2 and above:  -  maxmemory-policy -
+          notify-keyspace-events  Redis 4.0 and above:  -  activedefrag
+          -  lfu-log-factor -  lfu-decay-time
+      tier:
+          Required. The service tier of the instance.
+      memory_size_gb:
+          Required. Redis memory size in GiB.
+      authorized_network:
+          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.
+      persistence_iam_identity:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.Instance)
+    ),
+)
+_sym_db.RegisterMessage(Instance)
+_sym_db.RegisterMessage(Instance.LabelsEntry)
+_sym_db.RegisterMessage(Instance.RedisConfigsEntry)
+
+ListInstancesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [ListInstances][google.cloud.redis.v1.CloudRedis.ListInstances].
+  
+  
+  Attributes:
+      parent:
+          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.
+      page_size:
+          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] to
+          determine if there are more instances left to be queried.
+      page_token:
+          The next\_page\_token value returned from a previous List
+          request, if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.ListInstancesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesRequest)
+
+ListInstancesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESRESPONSE,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Response for
+  [ListInstances][google.cloud.redis.v1.CloudRedis.ListInstances].
+  
+  
+  Attributes:
+      instances:
+          A list of Redis 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. 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".
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+      unreachable:
+          Locations that could not be reached.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.ListInstancesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesResponse)
+
+GetInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for [GetInstance][google.cloud.redis.v1.CloudRedis.GetInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.GetInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInstanceRequest)
+
+CreateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [CreateInstance][google.cloud.redis.v1.CloudRedis.CreateInstance].
+  
+  
+  Attributes:
+      parent:
+          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.
+      instance_id:
+          Required. The logical name of the Redis instance in the
+          customer 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 customer project / location
+      instance:
+          Required. A Redis [Instance] resource
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.CreateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstanceRequest)
+
+UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [UpdateInstance][google.cloud.redis.v1.CloudRedis.UpdateInstance].
+  
+  
+  Attributes:
+      update_mask:
+          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]:  -  ``displayName`` -
+          ``labels`` -  ``memorySizeGb`` -  ``redisConfig``
+      instance:
+          Required. Update description. Only fields specified in
+          update\_mask are updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.UpdateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateInstanceRequest)
+
+DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [DeleteInstance][google.cloud.redis.v1.CloudRedis.DeleteInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.DeleteInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteInstanceRequest)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""The Cloud Storage location for the input content
+  
+  
+  Attributes:
+      uri:
+          Required. Source data URI. (e.g.
+          'gs://my\_bucket/my\_object').
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""The input content
+  
+  
+  Attributes:
+      source:
+          Required. Specify source location of input data
+      gcs_source:
+          Google Cloud Storage location where input content is located.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+ImportInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for [Import][google.cloud.redis.v1.CloudRedis.ImportInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+      input_config:
+          Required. Specify data to be imported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.ImportInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportInstanceRequest)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""The Cloud Storage location for the output content
+  
+  
+  Attributes:
+      uri:
+          Required. Data destination URI (e.g.
+          'gs://my\_bucket/my\_object'). Existing files will be
+          overwritten.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""The output content
+  
+  
+  Attributes:
+      destination:
+          Required. Specify destination location of output data
+      gcs_destination:
+          Google Cloud Storage destination for output content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+ExportInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for [Export][google.cloud.redis.v1.CloudRedis.ExportInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+      output_config:
+          Required. Specify data to be exported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.ExportInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportInstanceRequest)
+
+FailoverInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "FailoverInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FAILOVERINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [Failover][google.cloud.redis.v1.CloudRedis.FailoverInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+      data_protection_mode:
+          Optional. Available data protection modes that the user can
+          choose. If it's unspecified, data protection mode will be
+          LIMITED\_DATA\_LOSS by default.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.FailoverInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(FailoverInstanceRequest)
+
+OperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATIONMETADATA,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Represents the v1 metadata of the long-running operation.
+  
+  
+  Attributes:
+      create_time:
+          Creation timestamp.
+      end_time:
+          End timestamp.
+      target:
+          Operation target.
+      verb:
+          Operation verb.
+      status_detail:
+          Operation status details.
+      cancel_requested:
+          Specifies if cancellation was requested for the operation.
+      api_version:
+          API version.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.OperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperationMetadata)
+
+LocationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LocationMetadata",
+    (_message.Message,),
+    dict(
+        AvailableZonesEntry=_reflection.GeneratedProtocolMessageType(
+            "AvailableZonesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOCATIONMETADATA_AVAILABLEZONESENTRY,
+                __module__="google.cloud.redis_v1.proto.cloud_redis_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.LocationMetadata.AvailableZonesEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOCATIONMETADATA,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""This location metadata represents additional configuration options for a
+  given location where a Redis instance may be created. All fields are
+  output only. It is returned as content of the
+  ``google.cloud.location.Location.metadata`` field.
+  
+  
+  Attributes:
+      available_zones:
+          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 ``location_id`` or
+          ``alternative_location_id`` fields when creating a Redis
+          instance.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.LocationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LocationMetadata)
+_sym_db.RegisterMessage(LocationMetadata.AvailableZonesEntry)
+
+ZoneMetadata = _reflection.GeneratedProtocolMessageType(
+    "ZoneMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ZONEMETADATA,
+        __module__="google.cloud.redis_v1.proto.cloud_redis_pb2",
+        __doc__="""Defines specific information for a particular zone. Currently empty and
+  reserved for future use only.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1.ZoneMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ZoneMetadata)
+
+
+DESCRIPTOR._options = None
+_INSTANCE_LABELSENTRY._options = None
+_INSTANCE_REDISCONFIGSENTRY._options = None
+_LOCATIONMETADATA_AVAILABLEZONESENTRY._options = None
+
+_CLOUDREDIS = _descriptor.ServiceDescriptor(
+    name="CloudRedis",
+    full_name="google.cloud.redis.v1.CloudRedis",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b("\312A\024redis.googleapis.com"),
+    serialized_start=2772,
+    serialized_end=4091,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListInstances",
+            full_name="google.cloud.redis.v1.CloudRedis.ListInstances",
+            index=0,
+            containing_service=None,
+            input_type=_LISTINSTANCESREQUEST,
+            output_type=_LISTINSTANCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1/{parent=projects/*/locations/*}/instances"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.GetInstance",
+            index=1,
+            containing_service=None,
+            input_type=_GETINSTANCEREQUEST,
+            output_type=_INSTANCE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1/{name=projects/*/locations/*/instances/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.CreateInstance",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0029"-/v1/{parent=projects/*/locations/*}/instances:\010instance'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.UpdateInstance",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002B26/v1/{instance.name=projects/*/locations/*/instances/*}:\010instance"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.ImportInstance",
+            index=4,
+            containing_service=None,
+            input_type=_IMPORTINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0029"4/v1/{name=projects/*/locations/*/instances/*}:import:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.ExportInstance",
+            index=5,
+            containing_service=None,
+            input_type=_EXPORTINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0029"4/v1/{name=projects/*/locations/*/instances/*}:export:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="FailoverInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.FailoverInstance",
+            index=6,
+            containing_service=None,
+            input_type=_FAILOVERINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1/{name=projects/*/locations/*/instances/*}:failover:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteInstance",
+            full_name="google.cloud.redis.v1.CloudRedis.DeleteInstance",
+            index=7,
+            containing_service=None,
+            input_type=_DELETEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002/*-/v1/{name=projects/*/locations/*/instances/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDREDIS)
+
+DESCRIPTOR.services_by_name["CloudRedis"] = _CLOUDREDIS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/redis/google/cloud/redis_v1/proto/cloud_redis_pb2_grpc.py b/redis/google/cloud/redis_v1/proto/cloud_redis_pb2_grpc.py
new file mode 100644
index 000000000000..e066fbf19a23
--- /dev/null
+++ b/redis/google/cloud/redis_v1/proto/cloud_redis_pb2_grpc.py
@@ -0,0 +1,235 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.redis_v1.proto import (
+    cloud_redis_pb2 as google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class CloudRedisStub(object):
+    """Configures and manages Cloud Memorystore for Redis instances
+
+  Google Cloud Memorystore for Redis v1
+
+  The `redis.googleapis.com` service implements the Google Cloud Memorystore
+  for Redis API and defines the following resource model for managing Redis
+  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 Redis instances, named: `/instances/*`
+  * As such, Redis instances are resources of the form:
+  `/projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+
+  Note that location_id must be referring to a GCP `region`; for example:
+  * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListInstances = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/ListInstances",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ListInstancesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ListInstancesResponse.FromString,
+        )
+        self.GetInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/GetInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.GetInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.Instance.FromString,
+        )
+        self.CreateInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/CreateInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.CreateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/UpdateInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.UpdateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ImportInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/ImportInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ImportInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ExportInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/ExportInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ExportInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.FailoverInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/FailoverInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.FailoverInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteInstance = channel.unary_unary(
+            "/google.cloud.redis.v1.CloudRedis/DeleteInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.DeleteInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class CloudRedisServicer(object):
+    """Configures and manages Cloud Memorystore for Redis instances
+
+  Google Cloud Memorystore for Redis v1
+
+  The `redis.googleapis.com` service implements the Google Cloud Memorystore
+  for Redis API and defines the following resource model for managing Redis
+  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 Redis instances, named: `/instances/*`
+  * As such, Redis instances are resources of the form:
+  `/projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+
+  Note that location_id must be referring to a GCP `region`; for example:
+  * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
+  """
+
+    def ListInstances(self, request, context):
+        """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
+    available to the project are queried, and the results are aggregated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInstance(self, request, context):
+        """Gets the details of a specific Redis instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateInstance(self, request, context):
+        """Creates a Redis instance based on the specified tier and memory size.
+
+    By default, the instance is accessible from the project's
+    [default network](/compute/docs/networks-and-firewalls#networks).
+
+    The creation is executed asynchronously and callers may check the returned
+    operation to track its progress. Once the operation is completed the Redis
+    instance will be fully functional. Completed longrunning.Operation will
+    contain the new instance object in the response field.
+
+    The returned operation is automatically deleted after a few hours, so there
+    is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateInstance(self, request, context):
+        """Updates the metadata and configuration of a specific Redis instance.
+
+    Completed longrunning.Operation will contain the new instance object
+    in the response field. The returned operation is automatically deleted
+    after a few hours, so there is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportInstance(self, request, context):
+        """Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+
+    Redis may stop serving during this operation. Instance state will be
+    IMPORTING for entire operation. When complete, the instance will contain
+    only data from the imported file.
+
+    The returned operation is automatically deleted after a few hours, so
+    there is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportInstance(self, request, context):
+        """Export Redis instance data into a Redis RDB format file in Cloud Storage.
+
+    Redis will continue serving during this operation.
+
+    The returned operation is automatically deleted after a few hours, so
+    there is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def FailoverInstance(self, request, context):
+        """Initiates a failover of the master node to current replica node for a
+    specific STANDARD tier Cloud Memorystore for Redis instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteInstance(self, request, context):
+        """Deletes a specific Redis instance.  Instance stops serving and data is
+    deleted.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudRedisServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListInstances": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInstances,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ListInstancesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ListInstancesResponse.SerializeToString,
+        ),
+        "GetInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.GetInstanceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.Instance.SerializeToString,
+        ),
+        "CreateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.CreateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.UpdateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ImportInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ImportInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ExportInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.ExportInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "FailoverInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.FailoverInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.FailoverInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1_dot_proto_dot_cloud__redis__pb2.DeleteInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.redis.v1.CloudRedis", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/redis/google/cloud/redis_v1/types.py b/redis/google/cloud/redis_v1/types.py
new file mode 100644
index 000000000000..9c3c84a7f90c
--- /dev/null
+++ b/redis/google/cloud/redis_v1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.redis_v1.proto import cloud_redis_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, field_mask_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [cloud_redis_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.redis_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/redis/google/cloud/redis_v1beta1/__init__.py b/redis/google/cloud/redis_v1beta1/__init__.py
new file mode 100644
index 000000000000..e63ad5491d54
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.redis_v1beta1 import types
+from google.cloud.redis_v1beta1.gapic import cloud_redis_client
+from google.cloud.redis_v1beta1.gapic import enums
+
+
+class CloudRedisClient(cloud_redis_client.CloudRedisClient):
+    __doc__ = cloud_redis_client.CloudRedisClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudRedisClient")
diff --git a/redis/google/cloud/redis_v1beta1/gapic/__init__.py b/redis/google/cloud/redis_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py b/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py
new file mode 100644
index 000000000000..1615278daab4
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py
@@ -0,0 +1,1035 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.redis.v1beta1 CloudRedis API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.redis_v1beta1.gapic import cloud_redis_client_config
+from google.cloud.redis_v1beta1.gapic import enums
+from google.cloud.redis_v1beta1.gapic.transports import cloud_redis_grpc_transport
+from google.cloud.redis_v1beta1.proto import cloud_redis_pb2
+from google.cloud.redis_v1beta1.proto import cloud_redis_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-redis").version
+
+
+class CloudRedisClient(object):
+    """
+    Configures and manages Cloud Memorystore for Redis instances
+
+    Google Cloud Memorystore for Redis v1beta1
+
+    The ``redis.googleapis.com`` service implements the Google Cloud
+    Memorystore for Redis API and defines the following resource model for
+    managing Redis 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 Redis instances, named:
+       ``/instances/*``
+    -  As such, Redis 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/redpepper-1290/locations/us-central1/instances/my-redis``
+    """
+
+    SERVICE_ADDRESS = "redis.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.redis.v1beta1.CloudRedis"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudRedisClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def instance_path(cls, project, location, instance):
+        """Return a fully-qualified instance string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/instances/{instance}",
+            project=project,
+            location=location,
+            instance=instance,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudRedisGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudRedisGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_redis_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_redis_grpc_transport.CloudRedisGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_redis_grpc_transport.CloudRedisGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_instances(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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
+        available to the project are queried, and the results are aggregated.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_instances(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_instances(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.redis_v1beta1.types.Instance` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_instances" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_instances"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_instances,
+                default_retry=self._method_configs["ListInstances"].retry,
+                default_timeout=self._method_configs["ListInstances"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.ListInstancesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_instances"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="instances",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the details of a specific Redis instance.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> response = client.get_instance(name)
+
+        Args:
+            name (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types.Instance` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_instance,
+                default_retry=self._method_configs["GetInstance"].retry,
+                default_timeout=self._method_configs["GetInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.GetInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_instance(
+        self,
+        parent,
+        instance_id,
+        instance,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a Redis instance based on the specified tier and memory size.
+
+        By default, the instance is accessible from the project's `default
+        network <https://cloud.google.com/compute/docs/networks-and-firewalls#networks>`__.
+
+        The creation is executed asynchronously and callers may check the
+        returned operation to track its progress. Once the operation is
+        completed the Redis instance will be fully functional. Completed
+        longrunning.Operation will contain the new instance object in the
+        response field.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>> from google.cloud.redis_v1beta1 import enums
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>> instance_id = 'test_instance'
+            >>> tier = enums.Instance.Tier.BASIC
+            >>> memory_size_gb = 1
+            >>> instance = {'tier': tier, 'memory_size_gb': memory_size_gb}
+            >>>
+            >>> response = client.create_instance(parent, instance_id, instance)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): 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.
+            instance_id (str): Required. The logical name of the Redis instance in the customer 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 customer project / location
+            instance (Union[dict, ~google.cloud.redis_v1beta1.types.Instance]): Required. A Redis [Instance] resource
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1beta1.types.Instance`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_instance,
+                default_retry=self._method_configs["CreateInstance"].retry,
+                default_timeout=self._method_configs["CreateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=any_pb2.Any,
+        )
+
+    def update_instance(
+        self,
+        update_mask,
+        instance,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the metadata and configuration of a specific Redis instance.
+
+        Completed longrunning.Operation will contain the new instance object
+        in the response field. The returned operation is automatically deleted
+        after a few hours, so there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> paths_element = 'display_name'
+            >>> paths_element_2 = 'memory_size_gb'
+            >>> paths = [paths_element, paths_element_2]
+            >>> update_mask = {'paths': paths}
+            >>> display_name = 'UpdatedDisplayName'
+            >>> memory_size_gb = 4
+            >>> instance = {'display_name': display_name, 'memory_size_gb': memory_size_gb}
+            >>>
+            >>> response = client.update_instance(update_mask, instance)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            update_mask (Union[dict, ~google.cloud.redis_v1beta1.types.FieldMask]): 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``:
+
+                -  ``displayName``
+                -  ``labels``
+                -  ``memorySizeGb``
+                -  ``redisConfig``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1beta1.types.FieldMask`
+            instance (Union[dict, ~google.cloud.redis_v1beta1.types.Instance]): Required. Update description. Only fields specified in update\_mask are
+                updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1beta1.types.Instance`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_instance,
+                default_retry=self._method_configs["UpdateInstance"].retry,
+                default_timeout=self._method_configs["UpdateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.UpdateInstanceRequest(
+            update_mask=update_mask, instance=instance
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("instance.name", instance.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["update_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=any_pb2.Any,
+        )
+
+    def import_instance(
+        self,
+        name,
+        input_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+
+        Redis may stop serving during this operation. Instance state will be
+        IMPORTING for entire operation. When complete, the instance will contain
+        only data from the imported file.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_instance(name, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            input_config (Union[dict, ~google.cloud.redis_v1beta1.types.InputConfig]): Required. Specify data to be imported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1beta1.types.InputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_instance,
+                default_retry=self._method_configs["ImportInstance"].retry,
+                default_timeout=self._method_configs["ImportInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.ImportInstanceRequest(
+            name=name, input_config=input_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=any_pb2.Any,
+        )
+
+    def export_instance(
+        self,
+        name,
+        output_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Export Redis instance data into a Redis RDB format file in Cloud Storage.
+
+        Redis will continue serving during this operation.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.export_instance(name, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            output_config (Union[dict, ~google.cloud.redis_v1beta1.types.OutputConfig]): Required. Specify data to be exported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.redis_v1beta1.types.OutputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "export_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "export_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.export_instance,
+                default_retry=self._method_configs["ExportInstance"].retry,
+                default_timeout=self._method_configs["ExportInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.ExportInstanceRequest(
+            name=name, output_config=output_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["export_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=any_pb2.Any,
+        )
+
+    def failover_instance(
+        self,
+        name,
+        data_protection_mode,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Initiates a failover of the master node to current replica node for a
+        specific STANDARD tier Cloud Memorystore for Redis instance.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>> from google.cloud.redis_v1beta1 import enums
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `data_protection_mode`:
+            >>> data_protection_mode = enums.FailoverInstanceRequest.DataProtectionMode.DATA_PROTECTION_MODE_UNSPECIFIED
+            >>>
+            >>> response = client.failover_instance(name, data_protection_mode)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            data_protection_mode (~google.cloud.redis_v1beta1.types.DataProtectionMode): Optional. Available data protection modes that the user can choose. If
+                it's unspecified, data protection mode will be LIMITED\_DATA\_LOSS by
+                default.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "failover_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "failover_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.failover_instance,
+                default_retry=self._method_configs["FailoverInstance"].retry,
+                default_timeout=self._method_configs["FailoverInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.FailoverInstanceRequest(
+            name=name, data_protection_mode=data_protection_mode
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["failover_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_redis_pb2.Instance,
+            metadata_type=any_pb2.Any,
+        )
+
+    def delete_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a specific Redis instance.  Instance stops serving and data is
+        deleted.
+
+        Example:
+            >>> from google.cloud import redis_v1beta1
+            >>>
+            >>> client = redis_v1beta1.CloudRedisClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[LOCATION]', '[INSTANCE]')
+            >>>
+            >>> response = client.delete_instance(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.redis_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_instance,
+                default_retry=self._method_configs["DeleteInstance"].retry,
+                default_timeout=self._method_configs["DeleteInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_redis_pb2.DeleteInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["delete_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=any_pb2.Any,
+        )
diff --git a/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client_config.py b/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client_config.py
new file mode 100644
index 000000000000..262a77dc9af0
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client_config.py
@@ -0,0 +1,63 @@
+config = {
+    "interfaces": {
+        "google.cloud.redis.v1beta1.CloudRedis": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListInstances": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExportInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "FailoverInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteInstance": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/redis/google/cloud/redis_v1beta1/gapic/enums.py b/redis/google/cloud/redis_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..680daa0ef2ec
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/gapic/enums.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class FailoverInstanceRequest(object):
+    class DataProtectionMode(enum.IntEnum):
+        """
+        Attributes:
+          DATA_PROTECTION_MODE_UNSPECIFIED (int): Defaults to LIMITED\_DATA\_LOSS if a data protection mode is not
+          specified.
+          LIMITED_DATA_LOSS (int): Instance failover will be protected with data loss control. More
+          specifically, the failover will only be performed if the current
+          replication offset diff between master and replica is under a certain
+          threshold.
+          FORCE_DATA_LOSS (int): Instance failover will be performed without data loss control.
+        """
+
+        DATA_PROTECTION_MODE_UNSPECIFIED = 0
+        LIMITED_DATA_LOSS = 1
+        FORCE_DATA_LOSS = 2
+
+
+class Instance(object):
+    class State(enum.IntEnum):
+        """
+        Represents the different states of a Redis instance.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Not set.
+          CREATING (int): Redis instance is being created.
+          READY (int): Redis instance has been created and is fully usable.
+          UPDATING (int): Redis instance configuration is being updated. Certain kinds of updates
+          may cause the instance to become unusable while the update is in
+          progress.
+          DELETING (int): Redis instance is being deleted.
+          REPAIRING (int): Redis instance is being repaired and may be unusable.
+          MAINTENANCE (int): Maintenance is being performed on this Redis instance.
+          IMPORTING (int): Redis instance is importing data (availability may be affected).
+          FAILING_OVER (int): Redis instance is failing over (availability may be affected).
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATING = 1
+        READY = 2
+        UPDATING = 3
+        DELETING = 4
+        REPAIRING = 5
+        MAINTENANCE = 6
+        IMPORTING = 8
+        FAILING_OVER = 10
+
+    class Tier(enum.IntEnum):
+        """
+        Available service tiers to choose from
+
+        Attributes:
+          TIER_UNSPECIFIED (int): Not set.
+          BASIC (int): BASIC tier: standalone instance
+          STANDARD_HA (int): STANDARD\_HA tier: highly available primary/replica instances
+        """
+
+        TIER_UNSPECIFIED = 0
+        BASIC = 1
+        STANDARD_HA = 3
diff --git a/redis/google/cloud/redis_v1beta1/gapic/transports/__init__.py b/redis/google/cloud/redis_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/redis/google/cloud/redis_v1beta1/gapic/transports/cloud_redis_grpc_transport.py b/redis/google/cloud/redis_v1beta1/gapic/transports/cloud_redis_grpc_transport.py
new file mode 100644
index 000000000000..72b2cd5cfef9
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/gapic/transports/cloud_redis_grpc_transport.py
@@ -0,0 +1,256 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.redis_v1beta1.proto import cloud_redis_pb2_grpc
+
+
+class CloudRedisGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.redis.v1beta1 CloudRedis API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="redis.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"cloud_redis_stub": cloud_redis_pb2_grpc.CloudRedisStub(channel)}
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="redis.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_instances(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.list_instances`.
+
+        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
+        available to the project are queried, and the results are aggregated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].ListInstances
+
+    @property
+    def get_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.get_instance`.
+
+        Gets the details of a specific Redis instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].GetInstance
+
+    @property
+    def create_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.create_instance`.
+
+        Creates a Redis instance based on the specified tier and memory size.
+
+        By default, the instance is accessible from the project's `default
+        network <https://cloud.google.com/compute/docs/networks-and-firewalls#networks>`__.
+
+        The creation is executed asynchronously and callers may check the
+        returned operation to track its progress. Once the operation is
+        completed the Redis instance will be fully functional. Completed
+        longrunning.Operation will contain the new instance object in the
+        response field.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].CreateInstance
+
+    @property
+    def update_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.update_instance`.
+
+        Updates the metadata and configuration of a specific Redis instance.
+
+        Completed longrunning.Operation will contain the new instance object
+        in the response field. The returned operation is automatically deleted
+        after a few hours, so there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].UpdateInstance
+
+    @property
+    def import_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.import_instance`.
+
+        Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+
+        Redis may stop serving during this operation. Instance state will be
+        IMPORTING for entire operation. When complete, the instance will contain
+        only data from the imported file.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].ImportInstance
+
+    @property
+    def export_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.export_instance`.
+
+        Export Redis instance data into a Redis RDB format file in Cloud Storage.
+
+        Redis will continue serving during this operation.
+
+        The returned operation is automatically deleted after a few hours, so
+        there is no need to call DeleteOperation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].ExportInstance
+
+    @property
+    def failover_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.failover_instance`.
+
+        Initiates a failover of the master node to current replica node for a
+        specific STANDARD tier Cloud Memorystore for Redis instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].FailoverInstance
+
+    @property
+    def delete_instance(self):
+        """Return the gRPC stub for :meth:`CloudRedisClient.delete_instance`.
+
+        Deletes a specific Redis instance.  Instance stops serving and data is
+        deleted.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_redis_stub"].DeleteInstance
diff --git a/redis/google/cloud/redis_v1beta1/proto/__init__.py b/redis/google/cloud/redis_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/redis/google/cloud/redis_v1beta1/proto/cloud_redis.proto b/redis/google/cloud/redis_v1beta1/proto/cloud_redis.proto
new file mode 100644
index 000000000000..699df83fa89a
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/proto/cloud_redis.proto
@@ -0,0 +1,490 @@
+// 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.redis.v1beta1;
+
+import "google/api/annotations.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;
+option java_outer_classname = "CloudRedisServiceBetaProto";
+option java_package = "com.google.cloud.redis.v1beta1";
+
+// Configures and manages Cloud Memorystore for Redis instances
+//
+// Google Cloud Memorystore for Redis v1beta1
+//
+// The `redis.googleapis.com` service implements the Google Cloud Memorystore
+// for Redis API and defines the following resource model for managing Redis
+// 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 Redis instances, named: `/instances/*`
+// * As such, Redis 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/redpepper-1290/locations/us-central1/instances/my-redis`
+service CloudRedis {
+  option (google.api.default_host) = "redis.googleapis.com";
+
+  // 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
+  // available to the project are queried, and the results are aggregated.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/instances"
+    };
+  }
+
+  // Gets the details of a specific Redis instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/instances/*}"
+    };
+  }
+
+  // Creates a Redis instance based on the specified tier and memory size.
+  //
+  // By default, the instance is accessible from the project's
+  // [default network](/compute/docs/networks-and-firewalls#networks).
+  //
+  // The creation is executed asynchronously and callers may check the returned
+  // operation to track its progress. Once the operation is completed the Redis
+  // instance will be fully functional. Completed longrunning.Operation will
+  // contain the new instance object in the response field.
+  //
+  // The returned operation is automatically deleted after a few hours, so there
+  // is no need to call DeleteOperation.
+  rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/instances"
+      body: "instance"
+    };
+  }
+
+  // Updates the metadata and configuration of a specific Redis instance.
+  //
+  // Completed longrunning.Operation will contain the new instance object
+  // in the response field. The returned operation is automatically deleted
+  // after a few hours, so there is no need to call DeleteOperation.
+  rpc UpdateInstance(UpdateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{instance.name=projects/*/locations/*/instances/*}"
+      body: "instance"
+    };
+  }
+
+  // Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+  //
+  // Redis may stop serving during this operation. Instance state will be
+  // IMPORTING for entire operation. When complete, the instance will contain
+  // only data from the imported file.
+  //
+  // The returned operation is automatically deleted after a few hours, so
+  // there is no need to call DeleteOperation.
+  rpc ImportInstance(ImportInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/instances/*}:import"
+      body: "*"
+    };
+  }
+
+  // Export Redis instance data into a Redis RDB format file in Cloud Storage.
+  //
+  // Redis will continue serving during this operation.
+  //
+  // The returned operation is automatically deleted after a few hours, so
+  // there is no need to call DeleteOperation.
+  rpc ExportInstance(ExportInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/instances/*}:export"
+      body: "*"
+    };
+  }
+
+  // Initiates a failover of the master node to current replica node for a
+  // specific STANDARD tier Cloud Memorystore for Redis instance.
+  rpc FailoverInstance(FailoverInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/instances/*}:failover"
+      body: "*"
+    };
+  }
+
+  // Deletes a specific Redis instance.  Instance stops serving and data is
+  // deleted.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/instances/*}"
+    };
+  }
+}
+
+// A Google Cloud Redis instance.
+message Instance {
+  // Represents the different states of a Redis instance.
+  enum State {
+    // Not set.
+    STATE_UNSPECIFIED = 0;
+
+    // Redis instance is being created.
+    CREATING = 1;
+
+    // Redis instance has been created and is fully usable.
+    READY = 2;
+
+    // Redis instance configuration is being updated. Certain kinds of updates
+    // may cause the instance to become unusable while the update is in
+    // progress.
+    UPDATING = 3;
+
+    // Redis instance is being deleted.
+    DELETING = 4;
+
+    // Redis instance is being repaired and may be unusable.
+    REPAIRING = 5;
+
+    // Maintenance is being performed on this Redis instance.
+    MAINTENANCE = 6;
+
+    // Redis instance is importing data (availability may be affected).
+    IMPORTING = 8;
+
+    // Redis instance is failing over (availability may be affected).
+    FAILING_OVER = 10;
+  }
+
+  // Available service tiers to choose from
+  enum Tier {
+    // Not set.
+    TIER_UNSPECIFIED = 0;
+
+    // BASIC tier: standalone instance
+    BASIC = 1;
+
+    // STANDARD_HA tier: highly available primary/replica instances
+    STANDARD_HA = 3;
+  }
+
+  // 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: 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;
+
+  // An arbitrary and optional user-provided name for the instance.
+  string display_name = 2;
+
+  // Resource labels to represent user provided metadata
+  map<string, string> labels = 3;
+
+  // 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;
+
+  // 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;
+
+  // 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:
+  //
+  //  *   `REDIS_4_0` for Redis 4.0 compatibility (default)
+  //  *   `REDIS_3_2` for Redis 3.2 compatibility
+  string redis_version = 7;
+
+  // 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;
+
+  // Output only. Hostname or IP address of the exposed Redis endpoint used by
+  // clients to connect to the service.
+  string host = 10;
+
+  // Output only. The port number of the exposed Redis endpoint.
+  int32 port = 11;
+
+  // 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]
+  // provided by the user at creation time. For Standard Tier instances,
+  // this can be either [location_id] or [alternative_location_id] and can
+  // change after a failover event.
+  string current_location_id = 12;
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 13;
+
+  // Output only. The current state of this instance.
+  State state = 14;
+
+  // Output only. Additional information about the current status of this
+  // instance, if available.
+  string status_message = 15;
+
+  // Optional. Redis configuration parameters, according to
+  // http://redis.io/topics/config. Currently, the only supported parameters
+  // are:
+  //
+  //  Redis 3.2 and above:
+  //
+  //  *   maxmemory-policy
+  //  *   notify-keyspace-events
+  //
+  //  Redis 4.0 and above:
+  //
+  //  *   activedefrag
+  //  *   lfu-log-factor
+  //  *   lfu-decay-time
+  map<string, string> redis_configs = 16;
+
+  // Required. The service tier of the instance.
+  Tier tier = 17;
+
+  // Required. Redis memory size in GiB.
+  int32 memory_size_gb = 18;
+
+  // 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;
+
+  // Output only. Cloud IAM identity used by import / export operations to
+  // transfer data to/from Cloud Storage. Format is
+  // "serviceAccount:<service_account_email>". The value may change over time
+  // for a given instance so should be checked before each import/export
+  // operation.
+  string persistence_iam_identity = 21;
+}
+
+// Request for [ListInstances][google.cloud.redis.v1beta1.CloudRedis.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;
+
+  // 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]
+  // 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;
+}
+
+// Response for [ListInstances][google.cloud.redis.v1beta1.CloudRedis.ListInstances].
+message ListInstancesResponse {
+  // A list of Redis 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.
+  // 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".
+  repeated Instance instances = 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.redis.v1beta1.CloudRedis.GetInstance].
+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;
+}
+
+// Request for [CreateInstance][google.cloud.redis.v1beta1.CloudRedis.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;
+
+  // Required. The logical name of the Redis instance in the customer 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 customer project / location
+  string instance_id = 2;
+
+  // Required. A Redis [Instance] resource
+  Instance instance = 3;
+}
+
+// Request for [UpdateInstance][google.cloud.redis.v1beta1.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][google.cloud.redis.v1beta1.Instance]:
+  //
+  //  *   `displayName`
+  //  *   `labels`
+  //  *   `memorySizeGb`
+  //  *   `redisConfig`
+  google.protobuf.FieldMask update_mask = 1;
+
+  // Required. Update description.
+  // Only fields specified in update_mask are updated.
+  Instance instance = 2;
+}
+
+// Request for [DeleteInstance][google.cloud.redis.v1beta1.CloudRedis.DeleteInstance].
+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;
+}
+
+// The Cloud Storage location for the input content
+message GcsSource {
+  // Required. Source data URI. (e.g. 'gs://my_bucket/my_object').
+  string uri = 1;
+}
+
+// The input content
+message InputConfig {
+  // Required. Specify source location of input data
+  oneof source {
+    // Google Cloud Storage location where input content is located.
+    GcsSource gcs_source = 1;
+  }
+}
+
+// Request for [Import][google.cloud.redis.v1beta1.CloudRedis.ImportInstance].
+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;
+
+  // Required. Specify data to be imported.
+  InputConfig input_config = 3;
+}
+
+// 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;
+}
+
+// The output content
+message OutputConfig {
+  // Required. Specify destination location of output data
+  oneof destination {
+    // Google Cloud Storage destination for output content.
+    GcsDestination gcs_destination = 1;
+  }
+}
+
+// Request for [Export][google.cloud.redis.v1beta1.CloudRedis.ExportInstance].
+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;
+
+  // Required. Specify data to be exported.
+  OutputConfig output_config = 3;
+}
+
+// Request for [Failover][google.cloud.redis.v1beta1.CloudRedis.FailoverInstance].
+message FailoverInstanceRequest {
+  enum DataProtectionMode {
+    // Defaults to LIMITED_DATA_LOSS if a data protection mode is not
+    // specified.
+    DATA_PROTECTION_MODE_UNSPECIFIED = 0;
+
+    // Instance failover will be protected with data loss control. More
+    // specifically, the failover will only be performed if the current
+    // replication offset diff between master and replica is under a certain
+    // threshold.
+    LIMITED_DATA_LOSS = 1;
+
+    // Instance failover will be performed without data loss control.
+    FORCE_DATA_LOSS = 2;
+  }
+
+  // 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;
+
+  // 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;
+}
+
+// This location metadata represents additional configuration options for a
+// given location where a Redis instance may be created. All fields are output
+// only. It is returned as content of the
+// `google.cloud.location.Location.metadata` field.
+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 `location_id` or `alternative_location_id` fields when
+  // creating a Redis instance.
+  map<string, ZoneMetadata> available_zones = 1;
+}
+
+// Defines specific information for a particular zone. Currently empty and
+// reserved for future use only.
+message ZoneMetadata {
+
+}
diff --git a/redis/google/cloud/redis_v1beta1/proto/cloud_redis_pb2.py b/redis/google/cloud/redis_v1beta1/proto/cloud_redis_pb2.py
new file mode 100644
index 000000000000..58869537cef1
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/proto/cloud_redis_pb2.py
@@ -0,0 +1,2077 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/redis_v1beta1/proto/cloud_redis.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/redis_v1beta1/proto/cloud_redis.proto",
+    package="google.cloud.redis.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.redis.v1beta1B\032CloudRedisServiceBetaProtoP\001Z?google.golang.org/genproto/googleapis/cloud/redis/v1beta1;redis"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/redis_v1beta1/proto/cloud_redis.proto\x12\x1agoogle.cloud.redis.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/api/client.proto"\xa8\x07\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12@\n\x06labels\x18\x03 \x03(\x0b\x32\x30.google.cloud.redis.v1beta1.Instance.LabelsEntry\x12\x13\n\x0blocation_id\x18\x04 \x01(\t\x12\x1f\n\x17\x61lternative_location_id\x18\x05 \x01(\t\x12\x15\n\rredis_version\x18\x07 \x01(\t\x12\x19\n\x11reserved_ip_range\x18\t \x01(\t\x12\x0c\n\x04host\x18\n \x01(\t\x12\x0c\n\x04port\x18\x0b \x01(\x05\x12\x1b\n\x13\x63urrent_location_id\x18\x0c \x01(\t\x12/\n\x0b\x63reate_time\x18\r \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x39\n\x05state\x18\x0e \x01(\x0e\x32*.google.cloud.redis.v1beta1.Instance.State\x12\x16\n\x0estatus_message\x18\x0f \x01(\t\x12M\n\rredis_configs\x18\x10 \x03(\x0b\x32\x36.google.cloud.redis.v1beta1.Instance.RedisConfigsEntry\x12\x37\n\x04tier\x18\x11 \x01(\x0e\x32).google.cloud.redis.v1beta1.Instance.Tier\x12\x16\n\x0ememory_size_gb\x18\x12 \x01(\x05\x12\x1a\n\x12\x61uthorized_network\x18\x14 \x01(\t\x12 \n\x18persistence_iam_identity\x18\x15 \x01(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1a\x33\n\x11RedisConfigsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x94\x01\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x0c\n\x08UPDATING\x10\x03\x12\x0c\n\x08\x44\x45LETING\x10\x04\x12\r\n\tREPAIRING\x10\x05\x12\x0f\n\x0bMAINTENANCE\x10\x06\x12\r\n\tIMPORTING\x10\x08\x12\x10\n\x0c\x46\x41ILING_OVER\x10\n"8\n\x04Tier\x12\x14\n\x10TIER_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x0f\n\x0bSTANDARD_HA\x10\x03"M\n\x14ListInstancesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"~\n\x15ListInstancesResponse\x12\x37\n\tinstances\x18\x01 \x03(\x0b\x32$.google.cloud.redis.v1beta1.Instance\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x13\n\x0bunreachable\x18\x03 \x03(\t""\n\x12GetInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"t\n\x15\x43reateInstanceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0binstance_id\x18\x02 \x01(\t\x12\x36\n\x08instance\x18\x03 \x01(\x0b\x32$.google.cloud.redis.v1beta1.Instance"\x80\x01\n\x15UpdateInstanceRequest\x12/\n\x0bupdate_mask\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x36\n\x08instance\x18\x02 \x01(\x0b\x32$.google.cloud.redis.v1beta1.Instance"%\n\x15\x44\x65leteInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x18\n\tGcsSource\x12\x0b\n\x03uri\x18\x01 \x01(\t"T\n\x0bInputConfig\x12;\n\ngcs_source\x18\x01 \x01(\x0b\x32%.google.cloud.redis.v1beta1.GcsSourceH\x00\x42\x08\n\x06source"d\n\x15ImportInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12=\n\x0cinput_config\x18\x03 \x01(\x0b\x32\'.google.cloud.redis.v1beta1.InputConfig"\x1d\n\x0eGcsDestination\x12\x0b\n\x03uri\x18\x01 \x01(\t"d\n\x0cOutputConfig\x12\x45\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32*.google.cloud.redis.v1beta1.GcsDestinationH\x00\x42\r\n\x0b\x64\x65stination"f\n\x15\x45xportInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12?\n\routput_config\x18\x03 \x01(\x0b\x32(.google.cloud.redis.v1beta1.OutputConfig"\xf5\x01\n\x17\x46\x61iloverInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x64\n\x14\x64\x61ta_protection_mode\x18\x02 \x01(\x0e\x32\x46.google.cloud.redis.v1beta1.FailoverInstanceRequest.DataProtectionMode"f\n\x12\x44\x61taProtectionMode\x12$\n DATA_PROTECTION_MODE_UNSPECIFIED\x10\x00\x12\x15\n\x11LIMITED_DATA_LOSS\x10\x01\x12\x13\n\x0f\x46ORCE_DATA_LOSS\x10\x02"\xce\x01\n\x10LocationMetadata\x12Y\n\x0f\x61vailable_zones\x18\x01 \x03(\x0b\x32@.google.cloud.redis.v1beta1.LocationMetadata.AvailableZonesEntry\x1a_\n\x13\x41vailableZonesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x37\n\x05value\x18\x02 \x01(\x0b\x32(.google.cloud.redis.v1beta1.ZoneMetadata:\x02\x38\x01"\x0e\n\x0cZoneMetadata2\x81\x0b\n\nCloudRedis\x12\xb0\x01\n\rListInstances\x12\x30.google.cloud.redis.v1beta1.ListInstancesRequest\x1a\x31.google.cloud.redis.v1beta1.ListInstancesResponse":\x82\xd3\xe4\x93\x02\x34\x12\x32/v1beta1/{parent=projects/*/locations/*}/instances\x12\x9f\x01\n\x0bGetInstance\x12..google.cloud.redis.v1beta1.GetInstanceRequest\x1a$.google.cloud.redis.v1beta1.Instance":\x82\xd3\xe4\x93\x02\x34\x12\x32/v1beta1/{name=projects/*/locations/*/instances/*}\x12\xa8\x01\n\x0e\x43reateInstance\x12\x31.google.cloud.redis.v1beta1.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation"D\x82\xd3\xe4\x93\x02>"2/v1beta1/{parent=projects/*/locations/*}/instances:\x08instance\x12\xb1\x01\n\x0eUpdateInstance\x12\x31.google.cloud.redis.v1beta1.UpdateInstanceRequest\x1a\x1d.google.longrunning.Operation"M\x82\xd3\xe4\x93\x02G2;/v1beta1/{instance.name=projects/*/locations/*/instances/*}:\x08instance\x12\xa8\x01\n\x0eImportInstance\x12\x31.google.cloud.redis.v1beta1.ImportInstanceRequest\x1a\x1d.google.longrunning.Operation"D\x82\xd3\xe4\x93\x02>"9/v1beta1/{name=projects/*/locations/*/instances/*}:import:\x01*\x12\xa8\x01\n\x0e\x45xportInstance\x12\x31.google.cloud.redis.v1beta1.ExportInstanceRequest\x1a\x1d.google.longrunning.Operation"D\x82\xd3\xe4\x93\x02>"9/v1beta1/{name=projects/*/locations/*/instances/*}:export:\x01*\x12\xae\x01\n\x10\x46\x61iloverInstance\x12\x33.google.cloud.redis.v1beta1.FailoverInstanceRequest\x1a\x1d.google.longrunning.Operation"F\x82\xd3\xe4\x93\x02@";/v1beta1/{name=projects/*/locations/*/instances/*}:failover:\x01*\x12\x9e\x01\n\x0e\x44\x65leteInstance\x12\x31.google.cloud.redis.v1beta1.DeleteInstanceRequest\x1a\x1d.google.longrunning.Operation":\x82\xd3\xe4\x93\x02\x34*2/v1beta1/{name=projects/*/locations/*/instances/*}\x1a\x17\xca\x41\x14redis.googleapis.comB\x7f\n\x1e\x63om.google.cloud.redis.v1beta1B\x1a\x43loudRedisServiceBetaProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/redis/v1beta1;redisb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_INSTANCE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.redis.v1beta1.Instance.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REPAIRING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MAINTENANCE", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPORTING", index=7, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILING_OVER", index=8, number=10, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=972,
+    serialized_end=1120,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_STATE)
+
+_INSTANCE_TIER = _descriptor.EnumDescriptor(
+    name="Tier",
+    full_name="google.cloud.redis.v1beta1.Instance.Tier",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TIER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STANDARD_HA", index=2, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1122,
+    serialized_end=1178,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_TIER)
+
+_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE = _descriptor.EnumDescriptor(
+    name="DataProtectionMode",
+    full_name="google.cloud.redis.v1beta1.FailoverInstanceRequest.DataProtectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_PROTECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIMITED_DATA_LOSS",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FORCE_DATA_LOSS",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2306,
+    serialized_end=2408,
+)
+_sym_db.RegisterEnumDescriptor(_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE)
+
+
+_INSTANCE_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.cloud.redis.v1beta1.Instance.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.redis.v1beta1.Instance.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.redis.v1beta1.Instance.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=871,
+    serialized_end=916,
+)
+
+_INSTANCE_REDISCONFIGSENTRY = _descriptor.Descriptor(
+    name="RedisConfigsEntry",
+    full_name="google.cloud.redis.v1beta1.Instance.RedisConfigsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.redis.v1beta1.Instance.RedisConfigsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.redis.v1beta1.Instance.RedisConfigsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=918,
+    serialized_end=969,
+)
+
+_INSTANCE = _descriptor.Descriptor(
+    name="Instance",
+    full_name="google.cloud.redis.v1beta1.Instance",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1beta1.Instance.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.redis.v1beta1.Instance.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.cloud.redis.v1beta1.Instance.labels",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.redis.v1beta1.Instance.location_id",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alternative_location_id",
+            full_name="google.cloud.redis.v1beta1.Instance.alternative_location_id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redis_version",
+            full_name="google.cloud.redis.v1beta1.Instance.redis_version",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reserved_ip_range",
+            full_name="google.cloud.redis.v1beta1.Instance.reserved_ip_range",
+            index=6,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.redis.v1beta1.Instance.host",
+            index=7,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="port",
+            full_name="google.cloud.redis.v1beta1.Instance.port",
+            index=8,
+            number=11,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current_location_id",
+            full_name="google.cloud.redis.v1beta1.Instance.current_location_id",
+            index=9,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.redis.v1beta1.Instance.create_time",
+            index=10,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.redis.v1beta1.Instance.state",
+            index=11,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status_message",
+            full_name="google.cloud.redis.v1beta1.Instance.status_message",
+            index=12,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="redis_configs",
+            full_name="google.cloud.redis.v1beta1.Instance.redis_configs",
+            index=13,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tier",
+            full_name="google.cloud.redis.v1beta1.Instance.tier",
+            index=14,
+            number=17,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="memory_size_gb",
+            full_name="google.cloud.redis.v1beta1.Instance.memory_size_gb",
+            index=15,
+            number=18,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authorized_network",
+            full_name="google.cloud.redis.v1beta1.Instance.authorized_network",
+            index=16,
+            number=20,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="persistence_iam_identity",
+            full_name="google.cloud.redis.v1beta1.Instance.persistence_iam_identity",
+            index=17,
+            number=21,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSTANCE_LABELSENTRY, _INSTANCE_REDISCONFIGSENTRY],
+    enum_types=[_INSTANCE_STATE, _INSTANCE_TIER],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=242,
+    serialized_end=1178,
+)
+
+
+_LISTINSTANCESREQUEST = _descriptor.Descriptor(
+    name="ListInstancesRequest",
+    full_name="google.cloud.redis.v1beta1.ListInstancesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.redis.v1beta1.ListInstancesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.redis.v1beta1.ListInstancesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.redis.v1beta1.ListInstancesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1180,
+    serialized_end=1257,
+)
+
+
+_LISTINSTANCESRESPONSE = _descriptor.Descriptor(
+    name="ListInstancesResponse",
+    full_name="google.cloud.redis.v1beta1.ListInstancesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instances",
+            full_name="google.cloud.redis.v1beta1.ListInstancesResponse.instances",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.redis.v1beta1.ListInstancesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unreachable",
+            full_name="google.cloud.redis.v1beta1.ListInstancesResponse.unreachable",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1259,
+    serialized_end=1385,
+)
+
+
+_GETINSTANCEREQUEST = _descriptor.Descriptor(
+    name="GetInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.GetInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1beta1.GetInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1387,
+    serialized_end=1421,
+)
+
+
+_CREATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="CreateInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.CreateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.redis.v1beta1.CreateInstanceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.cloud.redis.v1beta1.CreateInstanceRequest.instance_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.redis.v1beta1.CreateInstanceRequest.instance",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1423,
+    serialized_end=1539,
+)
+
+
+_UPDATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="UpdateInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.UpdateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.redis.v1beta1.UpdateInstanceRequest.update_mask",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.redis.v1beta1.UpdateInstanceRequest.instance",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1542,
+    serialized_end=1670,
+)
+
+
+_DELETEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="DeleteInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.DeleteInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1beta1.DeleteInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1672,
+    serialized_end=1709,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.redis.v1beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.redis.v1beta1.GcsSource.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1711,
+    serialized_end=1735,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.redis.v1beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.redis.v1beta1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.redis.v1beta1.InputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1737,
+    serialized_end=1821,
+)
+
+
+_IMPORTINSTANCEREQUEST = _descriptor.Descriptor(
+    name="ImportInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.ImportInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1beta1.ImportInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.redis.v1beta1.ImportInstanceRequest.input_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1823,
+    serialized_end=1923,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.redis.v1beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.redis.v1beta1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1925,
+    serialized_end=1954,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.redis.v1beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.redis.v1beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.redis.v1beta1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1956,
+    serialized_end=2056,
+)
+
+
+_EXPORTINSTANCEREQUEST = _descriptor.Descriptor(
+    name="ExportInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.ExportInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1beta1.ExportInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.redis.v1beta1.ExportInstanceRequest.output_config",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2058,
+    serialized_end=2160,
+)
+
+
+_FAILOVERINSTANCEREQUEST = _descriptor.Descriptor(
+    name="FailoverInstanceRequest",
+    full_name="google.cloud.redis.v1beta1.FailoverInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.redis.v1beta1.FailoverInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data_protection_mode",
+            full_name="google.cloud.redis.v1beta1.FailoverInstanceRequest.data_protection_mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2163,
+    serialized_end=2408,
+)
+
+
+_LOCATIONMETADATA_AVAILABLEZONESENTRY = _descriptor.Descriptor(
+    name="AvailableZonesEntry",
+    full_name="google.cloud.redis.v1beta1.LocationMetadata.AvailableZonesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.redis.v1beta1.LocationMetadata.AvailableZonesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.redis.v1beta1.LocationMetadata.AvailableZonesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2522,
+    serialized_end=2617,
+)
+
+_LOCATIONMETADATA = _descriptor.Descriptor(
+    name="LocationMetadata",
+    full_name="google.cloud.redis.v1beta1.LocationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="available_zones",
+            full_name="google.cloud.redis.v1beta1.LocationMetadata.available_zones",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_LOCATIONMETADATA_AVAILABLEZONESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2411,
+    serialized_end=2617,
+)
+
+
+_ZONEMETADATA = _descriptor.Descriptor(
+    name="ZoneMetadata",
+    full_name="google.cloud.redis.v1beta1.ZoneMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2619,
+    serialized_end=2633,
+)
+
+_INSTANCE_LABELSENTRY.containing_type = _INSTANCE
+_INSTANCE_REDISCONFIGSENTRY.containing_type = _INSTANCE
+_INSTANCE.fields_by_name["labels"].message_type = _INSTANCE_LABELSENTRY
+_INSTANCE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_INSTANCE.fields_by_name["state"].enum_type = _INSTANCE_STATE
+_INSTANCE.fields_by_name["redis_configs"].message_type = _INSTANCE_REDISCONFIGSENTRY
+_INSTANCE.fields_by_name["tier"].enum_type = _INSTANCE_TIER
+_INSTANCE_STATE.containing_type = _INSTANCE
+_INSTANCE_TIER.containing_type = _INSTANCE
+_LISTINSTANCESRESPONSE.fields_by_name["instances"].message_type = _INSTANCE
+_CREATEINSTANCEREQUEST.fields_by_name["instance"].message_type = _INSTANCE
+_UPDATEINSTANCEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEINSTANCEREQUEST.fields_by_name["instance"].message_type = _INSTANCE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["gcs_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_IMPORTINSTANCEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_EXPORTINSTANCEREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_FAILOVERINSTANCEREQUEST.fields_by_name[
+    "data_protection_mode"
+].enum_type = _FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE
+_FAILOVERINSTANCEREQUEST_DATAPROTECTIONMODE.containing_type = _FAILOVERINSTANCEREQUEST
+_LOCATIONMETADATA_AVAILABLEZONESENTRY.fields_by_name[
+    "value"
+].message_type = _ZONEMETADATA
+_LOCATIONMETADATA_AVAILABLEZONESENTRY.containing_type = _LOCATIONMETADATA
+_LOCATIONMETADATA.fields_by_name[
+    "available_zones"
+].message_type = _LOCATIONMETADATA_AVAILABLEZONESENTRY
+DESCRIPTOR.message_types_by_name["Instance"] = _INSTANCE
+DESCRIPTOR.message_types_by_name["ListInstancesRequest"] = _LISTINSTANCESREQUEST
+DESCRIPTOR.message_types_by_name["ListInstancesResponse"] = _LISTINSTANCESRESPONSE
+DESCRIPTOR.message_types_by_name["GetInstanceRequest"] = _GETINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["CreateInstanceRequest"] = _CREATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateInstanceRequest"] = _UPDATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteInstanceRequest"] = _DELETEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["ImportInstanceRequest"] = _IMPORTINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["ExportInstanceRequest"] = _EXPORTINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["FailoverInstanceRequest"] = _FAILOVERINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["LocationMetadata"] = _LOCATIONMETADATA
+DESCRIPTOR.message_types_by_name["ZoneMetadata"] = _ZONEMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Instance = _reflection.GeneratedProtocolMessageType(
+    "Instance",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANCE_LABELSENTRY,
+                __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.Instance.LabelsEntry)
+            ),
+        ),
+        RedisConfigsEntry=_reflection.GeneratedProtocolMessageType(
+            "RedisConfigsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANCE_REDISCONFIGSENTRY,
+                __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.Instance.RedisConfigsEntry)
+            ),
+        ),
+        DESCRIPTOR=_INSTANCE,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""A Google Cloud Redis instance.
+  
+  
+  Attributes:
+      name:
+          Required. Unique name of the resource in this scope including
+          project and location using the form: ``projects/{project_id}/l
+          ocations/{location_id}/instances/{instance_id}``  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.
+      display_name:
+          An arbitrary and optional user-provided name for the instance.
+      labels:
+          Resource labels to represent user provided metadata
+      location_id:
+          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].
+      alternative_location_id:
+          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].
+      redis_version:
+          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:  -  ``REDIS_4_0`` for
+          Redis 4.0 compatibility (default) -  ``REDIS_3_2`` for Redis
+          3.2 compatibility
+      reserved_ip_range:
+          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.
+      host:
+          Output only. Hostname or IP address of the exposed Redis
+          endpoint used by clients to connect to the service.
+      port:
+          Output only. The port number of the exposed Redis endpoint.
+      current_location_id:
+          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] provided by the user at creation time.
+          For Standard Tier instances, this can be either [location\_id]
+          or [alternative\_location\_id] and can change after a failover
+          event.
+      create_time:
+          Output only. The time the instance was created.
+      state:
+          Output only. The current state of this instance.
+      status_message:
+          Output only. Additional information about the current status
+          of this instance, if available.
+      redis_configs:
+          Optional. Redis configuration parameters, according to
+          http://redis.io/topics/config. Currently, the only supported
+          parameters are:  Redis 3.2 and above:  -  maxmemory-policy -
+          notify-keyspace-events  Redis 4.0 and above:  -  activedefrag
+          -  lfu-log-factor -  lfu-decay-time
+      tier:
+          Required. The service tier of the instance.
+      memory_size_gb:
+          Required. Redis memory size in GiB.
+      authorized_network:
+          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.
+      persistence_iam_identity:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.Instance)
+    ),
+)
+_sym_db.RegisterMessage(Instance)
+_sym_db.RegisterMessage(Instance.LabelsEntry)
+_sym_db.RegisterMessage(Instance.RedisConfigsEntry)
+
+ListInstancesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [ListInstances][google.cloud.redis.v1beta1.CloudRedis.ListInstances].
+  
+  
+  Attributes:
+      parent:
+          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.
+      page_size:
+          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] to
+          determine if there are more instances left to be queried.
+      page_token:
+          The next\_page\_token value returned from a previous List
+          request, if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.ListInstancesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesRequest)
+
+ListInstancesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESRESPONSE,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Response for
+  [ListInstances][google.cloud.redis.v1beta1.CloudRedis.ListInstances].
+  
+  
+  Attributes:
+      instances:
+          A list of Redis 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. 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".
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+      unreachable:
+          Locations that could not be reached.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.ListInstancesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesResponse)
+
+GetInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [GetInstance][google.cloud.redis.v1beta1.CloudRedis.GetInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.GetInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInstanceRequest)
+
+CreateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [CreateInstance][google.cloud.redis.v1beta1.CloudRedis.CreateInstance].
+  
+  
+  Attributes:
+      parent:
+          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.
+      instance_id:
+          Required. The logical name of the Redis instance in the
+          customer 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 customer project / location
+      instance:
+          Required. A Redis [Instance] resource
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.CreateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstanceRequest)
+
+UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [UpdateInstance][google.cloud.redis.v1beta1.CloudRedis.UpdateInstance].
+  
+  
+  Attributes:
+      update_mask:
+          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][google.cloud.redis.v1beta1.Instance]:  -
+          ``displayName`` -  ``labels`` -  ``memorySizeGb`` -
+          ``redisConfig``
+      instance:
+          Required. Update description. Only fields specified in
+          update\_mask are updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.UpdateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateInstanceRequest)
+
+DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [DeleteInstance][google.cloud.redis.v1beta1.CloudRedis.DeleteInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.DeleteInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteInstanceRequest)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""The Cloud Storage location for the input content
+  
+  
+  Attributes:
+      uri:
+          Required. Source data URI. (e.g.
+          'gs://my\_bucket/my\_object').
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""The input content
+  
+  
+  Attributes:
+      source:
+          Required. Specify source location of input data
+      gcs_source:
+          Google Cloud Storage location where input content is located.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+ImportInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [Import][google.cloud.redis.v1beta1.CloudRedis.ImportInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+      input_config:
+          Required. Specify data to be imported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.ImportInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportInstanceRequest)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""The Cloud Storage location for the output content
+  
+  
+  Attributes:
+      uri:
+          Required. Data destination URI (e.g.
+          'gs://my\_bucket/my\_object'). Existing files will be
+          overwritten.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""The output content
+  
+  
+  Attributes:
+      destination:
+          Required. Specify destination location of output data
+      gcs_destination:
+          Google Cloud Storage destination for output content.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+ExportInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "ExportInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPORTINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [Export][google.cloud.redis.v1beta1.CloudRedis.ExportInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+      output_config:
+          Required. Specify data to be exported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.ExportInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExportInstanceRequest)
+
+FailoverInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "FailoverInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FAILOVERINSTANCEREQUEST,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Request for
+  [Failover][google.cloud.redis.v1beta1.CloudRedis.FailoverInstance].
+  
+  
+  Attributes:
+      name:
+          Required. Redis instance resource name using the form: ``proje
+          cts/{project_id}/locations/{location_id}/instances/{instance_i
+          d}`` where ``location_id`` refers to a GCP region.
+      data_protection_mode:
+          Optional. Available data protection modes that the user can
+          choose. If it's unspecified, data protection mode will be
+          LIMITED\_DATA\_LOSS by default.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.FailoverInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(FailoverInstanceRequest)
+
+LocationMetadata = _reflection.GeneratedProtocolMessageType(
+    "LocationMetadata",
+    (_message.Message,),
+    dict(
+        AvailableZonesEntry=_reflection.GeneratedProtocolMessageType(
+            "AvailableZonesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LOCATIONMETADATA_AVAILABLEZONESENTRY,
+                __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.LocationMetadata.AvailableZonesEntry)
+            ),
+        ),
+        DESCRIPTOR=_LOCATIONMETADATA,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""This location metadata represents additional configuration options for a
+  given location where a Redis instance may be created. All fields are
+  output only. It is returned as content of the
+  ``google.cloud.location.Location.metadata`` field.
+  
+  
+  Attributes:
+      available_zones:
+          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 ``location_id`` or
+          ``alternative_location_id`` fields when creating a Redis
+          instance.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.LocationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LocationMetadata)
+_sym_db.RegisterMessage(LocationMetadata.AvailableZonesEntry)
+
+ZoneMetadata = _reflection.GeneratedProtocolMessageType(
+    "ZoneMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ZONEMETADATA,
+        __module__="google.cloud.redis_v1beta1.proto.cloud_redis_pb2",
+        __doc__="""Defines specific information for a particular zone. Currently empty and
+  reserved for future use only.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.redis.v1beta1.ZoneMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ZoneMetadata)
+
+
+DESCRIPTOR._options = None
+_INSTANCE_LABELSENTRY._options = None
+_INSTANCE_REDISCONFIGSENTRY._options = None
+_LOCATIONMETADATA_AVAILABLEZONESENTRY._options = None
+
+_CLOUDREDIS = _descriptor.ServiceDescriptor(
+    name="CloudRedis",
+    full_name="google.cloud.redis.v1beta1.CloudRedis",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b("\312A\024redis.googleapis.com"),
+    serialized_start=2636,
+    serialized_end=4045,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListInstances",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.ListInstances",
+            index=0,
+            containing_service=None,
+            input_type=_LISTINSTANCESREQUEST,
+            output_type=_LISTINSTANCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v1beta1/{parent=projects/*/locations/*}/instances"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.GetInstance",
+            index=1,
+            containing_service=None,
+            input_type=_GETINSTANCEREQUEST,
+            output_type=_INSTANCE,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v1beta1/{name=projects/*/locations/*/instances/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.CreateInstance",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002>"2/v1beta1/{parent=projects/*/locations/*}/instances:\010instance'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.UpdateInstance",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002G2;/v1beta1/{instance.name=projects/*/locations/*/instances/*}:\010instance"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.ImportInstance",
+            index=4,
+            containing_service=None,
+            input_type=_IMPORTINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002>"9/v1beta1/{name=projects/*/locations/*/instances/*}:import:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExportInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.ExportInstance",
+            index=5,
+            containing_service=None,
+            input_type=_EXPORTINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002>"9/v1beta1/{name=projects/*/locations/*/instances/*}:export:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="FailoverInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.FailoverInstance",
+            index=6,
+            containing_service=None,
+            input_type=_FAILOVERINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v1beta1/{name=projects/*/locations/*/instances/*}:failover:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteInstance",
+            full_name="google.cloud.redis.v1beta1.CloudRedis.DeleteInstance",
+            index=7,
+            containing_service=None,
+            input_type=_DELETEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\0024*2/v1beta1/{name=projects/*/locations/*/instances/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDREDIS)
+
+DESCRIPTOR.services_by_name["CloudRedis"] = _CLOUDREDIS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/redis/google/cloud/redis_v1beta1/proto/cloud_redis_pb2_grpc.py b/redis/google/cloud/redis_v1beta1/proto/cloud_redis_pb2_grpc.py
new file mode 100644
index 000000000000..b25842d334a8
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/proto/cloud_redis_pb2_grpc.py
@@ -0,0 +1,235 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.redis_v1beta1.proto import (
+    cloud_redis_pb2 as google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class CloudRedisStub(object):
+    """Configures and manages Cloud Memorystore for Redis instances
+
+  Google Cloud Memorystore for Redis v1beta1
+
+  The `redis.googleapis.com` service implements the Google Cloud Memorystore
+  for Redis API and defines the following resource model for managing Redis
+  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 Redis instances, named: `/instances/*`
+  * As such, Redis 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/redpepper-1290/locations/us-central1/instances/my-redis`
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListInstances = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/ListInstances",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ListInstancesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ListInstancesResponse.FromString,
+        )
+        self.GetInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/GetInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.GetInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.Instance.FromString,
+        )
+        self.CreateInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/CreateInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.CreateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/UpdateInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.UpdateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ImportInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/ImportInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ImportInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ExportInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/ExportInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ExportInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.FailoverInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/FailoverInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.FailoverInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteInstance = channel.unary_unary(
+            "/google.cloud.redis.v1beta1.CloudRedis/DeleteInstance",
+            request_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.DeleteInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class CloudRedisServicer(object):
+    """Configures and manages Cloud Memorystore for Redis instances
+
+  Google Cloud Memorystore for Redis v1beta1
+
+  The `redis.googleapis.com` service implements the Google Cloud Memorystore
+  for Redis API and defines the following resource model for managing Redis
+  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 Redis instances, named: `/instances/*`
+  * As such, Redis 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/redpepper-1290/locations/us-central1/instances/my-redis`
+  """
+
+    def ListInstances(self, request, context):
+        """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
+    available to the project are queried, and the results are aggregated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInstance(self, request, context):
+        """Gets the details of a specific Redis instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateInstance(self, request, context):
+        """Creates a Redis instance based on the specified tier and memory size.
+
+    By default, the instance is accessible from the project's
+    [default network](/compute/docs/networks-and-firewalls#networks).
+
+    The creation is executed asynchronously and callers may check the returned
+    operation to track its progress. Once the operation is completed the Redis
+    instance will be fully functional. Completed longrunning.Operation will
+    contain the new instance object in the response field.
+
+    The returned operation is automatically deleted after a few hours, so there
+    is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateInstance(self, request, context):
+        """Updates the metadata and configuration of a specific Redis instance.
+
+    Completed longrunning.Operation will contain the new instance object
+    in the response field. The returned operation is automatically deleted
+    after a few hours, so there is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportInstance(self, request, context):
+        """Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
+
+    Redis may stop serving during this operation. Instance state will be
+    IMPORTING for entire operation. When complete, the instance will contain
+    only data from the imported file.
+
+    The returned operation is automatically deleted after a few hours, so
+    there is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExportInstance(self, request, context):
+        """Export Redis instance data into a Redis RDB format file in Cloud Storage.
+
+    Redis will continue serving during this operation.
+
+    The returned operation is automatically deleted after a few hours, so
+    there is no need to call DeleteOperation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def FailoverInstance(self, request, context):
+        """Initiates a failover of the master node to current replica node for a
+    specific STANDARD tier Cloud Memorystore for Redis instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteInstance(self, request, context):
+        """Deletes a specific Redis instance.  Instance stops serving and data is
+    deleted.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudRedisServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListInstances": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInstances,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ListInstancesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ListInstancesResponse.SerializeToString,
+        ),
+        "GetInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.GetInstanceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.Instance.SerializeToString,
+        ),
+        "CreateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.CreateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.UpdateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ImportInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ImportInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ExportInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.ExportInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.ExportInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "FailoverInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.FailoverInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.FailoverInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteInstance,
+            request_deserializer=google_dot_cloud_dot_redis__v1beta1_dot_proto_dot_cloud__redis__pb2.DeleteInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.redis.v1beta1.CloudRedis", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/redis/google/cloud/redis_v1beta1/types.py b/redis/google/cloud/redis_v1beta1/types.py
new file mode 100644
index 000000000000..018883644e59
--- /dev/null
+++ b/redis/google/cloud/redis_v1beta1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.redis_v1beta1.proto import cloud_redis_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, field_mask_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [cloud_redis_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.redis_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/redis/noxfile.py b/redis/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/redis/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/redis/setup.cfg b/redis/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/redis/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/redis/setup.py b/redis/setup.py
new file mode 100644
index 000000000000..5ed53d6a6119
--- /dev/null
+++ b/redis/setup.py
@@ -0,0 +1,88 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-redis"
+description = "Google Cloud Memorystore for Redis API client library"
+version = "0.3.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+extras = {}
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/redis/synth.metadata b/redis/synth.metadata
new file mode 100644
index 000000000000..d3e5f77ab007
--- /dev/null
+++ b/redis/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:35:18.058175Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "redis",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/redis/artman_redis_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "redis",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/redis/artman_redis_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/redis/synth.py b/redis/synth.py
new file mode 100644
index 000000000000..b569680461f3
--- /dev/null
+++ b/redis/synth.py
@@ -0,0 +1,104 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+excludes = ["README.rst", "setup.py", "nox*.py", "docs/conf.py", "docs/index.rst"]
+
+# ----------------------------------------------------------------------------
+# Generate redis GAPIC layer
+# ----------------------------------------------------------------------------
+for version in ["v1beta1", "v1"]:
+    library = gapic.py_library(
+        "redis",
+        version,
+        config_path=f"artman_redis_{version}.yaml",
+        include_protos=True,
+    )
+
+    s.copy(library, excludes=excludes)
+
+# Fix docstrings
+s.replace(
+    "google/cloud/**/cloud_redis_client.py",
+    r"resources of the form:\n      ``",
+    r"resources of the form:\n\n      ``",
+)
+
+s.replace(
+    "google/cloud/**/cloud_redis_client.py",
+    r"""
+            parent \(str\): 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""",
+    r"""
+            parent (str): 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""",
+)
+
+
+s.replace(
+    "google/cloud/**/cloud_redis_client.py",
+    r"""
+                with the following restrictions:
+
+                \* Must contain only lowercase letters, numbers, and hyphens\.""",
+    r"""
+                with the following restrictions:
+                * Must contain only lowercase letters, numbers, and hyphens.""",
+)
+
+s.replace(
+    "google/cloud/**/cloud_redis_client.py",
+    r"""
+            name \(str\): 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""",
+    r"""
+            name (str): 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""",
+)
+
+s.replace(
+    "google/cloud/**/cloud_redis_client.py",
+    r"""
+                fields from ``Instance``:
+
+                 \*   ``displayName``
+                 \*   ``labels``
+                 \*   ``memorySizeGb``
+                 \*   ``redisConfig``""",
+    r"""
+                fields from ``Instance``: ``displayName``, ``labels``, ``memorySizeGb``, and ``redisConfig``.""",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/redis/tests/unit/gapic/v1/test_cloud_redis_client_v1.py b/redis/tests/unit/gapic/v1/test_cloud_redis_client_v1.py
new file mode 100644
index 000000000000..b2c85652f882
--- /dev/null
+++ b/redis/tests/unit/gapic/v1/test_cloud_redis_client_v1.py
@@ -0,0 +1,647 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import redis_v1
+from google.cloud.redis_v1 import enums
+from google.cloud.redis_v1.proto import cloud_redis_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudRedisClient(object):
+    def test_list_instances(self):
+        # Setup Expected Response
+        next_page_token = ""
+        instances_element = {}
+        instances = [instances_element]
+        expected_response = {"next_page_token": next_page_token, "instances": instances}
+        expected_response = cloud_redis_pb2.ListInstancesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_instances(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.instances[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.ListInstancesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_instances_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_instances(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        response = client.get_instance(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.GetInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.get_instance(name)
+
+    def test_create_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb_2 = 1493816946
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb_2,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        instance_id = "test_instance"
+        tier = enums.Instance.Tier.BASIC
+        memory_size_gb = 1
+        instance = {"tier": tier, "memory_size_gb": memory_size_gb}
+
+        response = client.create_instance(parent, instance_id, instance)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        instance_id = "test_instance"
+        tier = enums.Instance.Tier.BASIC
+        memory_size_gb = 1
+        instance = {"tier": tier, "memory_size_gb": memory_size_gb}
+
+        response = client.create_instance(parent, instance_id, instance)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name_2 = "displayName21615000987"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name,
+            "display_name": display_name_2,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        paths_element = "display_name"
+        paths_element_2 = "memory_size_gb"
+        paths = [paths_element, paths_element_2]
+        update_mask = {"paths": paths}
+        display_name = " instance.memory_size_gb=4"
+        instance = {"display_name": display_name}
+
+        response = client.update_instance(update_mask, instance)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.UpdateInstanceRequest(
+            update_mask=update_mask, instance=instance
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        paths_element = "display_name"
+        paths_element_2 = "memory_size_gb"
+        paths = [paths_element, paths_element_2]
+        update_mask = {"paths": paths}
+        display_name = " instance.memory_size_gb=4"
+        instance = {"display_name": display_name}
+
+        response = client.update_instance(update_mask, instance)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_import_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_import_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        input_config = {}
+
+        response = client.import_instance(name, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.ImportInstanceRequest(
+            name=name, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_import_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        input_config = {}
+
+        response = client.import_instance(name, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_export_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        output_config = {}
+
+        response = client.export_instance(name, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.ExportInstanceRequest(
+            name=name, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        output_config = {}
+
+        response = client.export_instance(name, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_failover_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_failover_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        data_protection_mode = (
+            enums.FailoverInstanceRequest.DataProtectionMode.DATA_PROTECTION_MODE_UNSPECIFIED
+        )
+
+        response = client.failover_instance(name, data_protection_mode)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.FailoverInstanceRequest(
+            name=name, data_protection_mode=data_protection_mode
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_failover_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_failover_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        data_protection_mode = (
+            enums.FailoverInstanceRequest.DataProtectionMode.DATA_PROTECTION_MODE_UNSPECIFIED
+        )
+
+        response = client.failover_instance(name, data_protection_mode)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_instance(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        response = client.delete_instance(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.DeleteInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        response = client.delete_instance(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/redis/tests/unit/gapic/v1beta1/test_cloud_redis_client_v1beta1.py b/redis/tests/unit/gapic/v1beta1/test_cloud_redis_client_v1beta1.py
new file mode 100644
index 000000000000..36de8aa567b9
--- /dev/null
+++ b/redis/tests/unit/gapic/v1beta1/test_cloud_redis_client_v1beta1.py
@@ -0,0 +1,649 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import redis_v1beta1
+from google.cloud.redis_v1beta1 import enums
+from google.cloud.redis_v1beta1.proto import cloud_redis_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudRedisClient(object):
+    def test_list_instances(self):
+        # Setup Expected Response
+        next_page_token = ""
+        instances_element = {}
+        instances = [instances_element]
+        expected_response = {"next_page_token": next_page_token, "instances": instances}
+        expected_response = cloud_redis_pb2.ListInstancesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_instances(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.instances[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.ListInstancesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_instances_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_instances(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        response = client.get_instance(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.GetInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.get_instance(name)
+
+    def test_create_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb_2 = 1493816946
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb_2,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        instance_id = "test_instance"
+        tier = enums.Instance.Tier.BASIC
+        memory_size_gb = 1
+        instance = {"tier": tier, "memory_size_gb": memory_size_gb}
+
+        response = client.create_instance(parent, instance_id, instance)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        instance_id = "test_instance"
+        tier = enums.Instance.Tier.BASIC
+        memory_size_gb = 1
+        instance = {"tier": tier, "memory_size_gb": memory_size_gb}
+
+        response = client.create_instance(parent, instance_id, instance)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name_2 = "displayName21615000987"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb_2 = 1493816946
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name,
+            "display_name": display_name_2,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb_2,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        paths_element = "display_name"
+        paths_element_2 = "memory_size_gb"
+        paths = [paths_element, paths_element_2]
+        update_mask = {"paths": paths}
+        display_name = "UpdatedDisplayName"
+        memory_size_gb = 4
+        instance = {"display_name": display_name, "memory_size_gb": memory_size_gb}
+
+        response = client.update_instance(update_mask, instance)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.UpdateInstanceRequest(
+            update_mask=update_mask, instance=instance
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        paths_element = "display_name"
+        paths_element_2 = "memory_size_gb"
+        paths = [paths_element, paths_element_2]
+        update_mask = {"paths": paths}
+        display_name = "UpdatedDisplayName"
+        memory_size_gb = 4
+        instance = {"display_name": display_name, "memory_size_gb": memory_size_gb}
+
+        response = client.update_instance(update_mask, instance)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_import_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_import_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        input_config = {}
+
+        response = client.import_instance(name, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.ImportInstanceRequest(
+            name=name, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_import_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        input_config = {}
+
+        response = client.import_instance(name, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_export_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_export_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        output_config = {}
+
+        response = client.export_instance(name, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.ExportInstanceRequest(
+            name=name, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_export_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_export_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        output_config = {}
+
+        response = client.export_instance(name, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_failover_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        location_id = "locationId552319461"
+        alternative_location_id = "alternativeLocationId-718920621"
+        redis_version = "redisVersion-685310444"
+        reserved_ip_range = "reservedIpRange-1082940580"
+        host = "host3208616"
+        port = 3446913
+        current_location_id = "currentLocationId1312712735"
+        status_message = "statusMessage-239442758"
+        memory_size_gb = 34199707
+        authorized_network = "authorizedNetwork-1733809270"
+        persistence_iam_identity = "persistenceIamIdentity1061944584"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "location_id": location_id,
+            "alternative_location_id": alternative_location_id,
+            "redis_version": redis_version,
+            "reserved_ip_range": reserved_ip_range,
+            "host": host,
+            "port": port,
+            "current_location_id": current_location_id,
+            "status_message": status_message,
+            "memory_size_gb": memory_size_gb,
+            "authorized_network": authorized_network,
+            "persistence_iam_identity": persistence_iam_identity,
+        }
+        expected_response = cloud_redis_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_failover_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        data_protection_mode = (
+            enums.FailoverInstanceRequest.DataProtectionMode.DATA_PROTECTION_MODE_UNSPECIFIED
+        )
+
+        response = client.failover_instance(name, data_protection_mode)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.FailoverInstanceRequest(
+            name=name, data_protection_mode=data_protection_mode
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_failover_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_failover_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+        data_protection_mode = (
+            enums.FailoverInstanceRequest.DataProtectionMode.DATA_PROTECTION_MODE_UNSPECIFIED
+        )
+
+        response = client.failover_instance(name, data_protection_mode)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_instance(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        response = client.delete_instance(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_redis_pb2.DeleteInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = redis_v1beta1.CloudRedisClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[LOCATION]", "[INSTANCE]")
+
+        response = client.delete_instance(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/renovate.json b/renovate.json
new file mode 100644
index 000000000000..4fa949311b20
--- /dev/null
+++ b/renovate.json
@@ -0,0 +1,5 @@
+{
+  "extends": [
+    "config:base",  ":preserveSemverRanges"
+  ]
+}
diff --git a/resource_manager/.coveragerc b/resource_manager/.coveragerc
new file mode 100644
index 000000000000..098720f672e1
--- /dev/null
+++ b/resource_manager/.coveragerc
@@ -0,0 +1,16 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
diff --git a/resource_manager/.flake8 b/resource_manager/.flake8
new file mode 100644
index 000000000000..61766fa84d02
--- /dev/null
+++ b/resource_manager/.flake8
@@ -0,0 +1,13 @@
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/resource_manager/.repo-metadata.json b/resource_manager/.repo-metadata.json
new file mode 100644
index 000000000000..6986af7d7a09
--- /dev/null
+++ b/resource_manager/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudresourcemanager",
+  "name_pretty": "Google Cloud Resource Manager API",
+  "product_documentation": "https://cloud.google.com/resource-manager",
+  "client_documentation": "https://googleapis.dev/python/cloudresourcemanager/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559757",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-resource-manager",
+  "api_id": "cloudresourcemanager.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/resource_manager/CHANGELOG.md b/resource_manager/CHANGELOG.md
new file mode 100644
index 000000000000..3cb946992452
--- /dev/null
+++ b/resource_manager/CHANGELOG.md
@@ -0,0 +1,109 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-resource-manager/#history
+
+## 0.29.2
+
+07-24-2019 17:25 PDT
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Add nox session 'docs' to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.29.1
+
+06-04-2019 11:14 PDT
+
+
+### Dependencies
+- Don't pin `google-api-core` in libs using `google-cloud-core`. ([#8213](https://github.com/googleapis/google-cloud-python/pull/8213))
+
+## 0.29.0
+
+05-16-2019 12:31 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to client / connection. ([#7870](https://github.com/googleapis/google-cloud-python/pull/7870))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+## 0.28.3
+
+12-17-2018 16:59 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Docs/fixit: normalize docs for `page_size` / `max_results` / `page_token`. ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+## 0.28.2
+
+12-10-2018 13:00 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Fix `filter_params` argument in `list_projects` ([#5383](https://github.com/googleapis/google-cloud-python/pull/5383))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Prep docs for repo split. ([#6022](https://github.com/googleapis/google-cloud-python/pull/6022))
+- Declutter sidebar by supplying explict short titles. ([#5939](https://github.com/googleapis/google-cloud-python/pull/5939))
+
+### Internal / Testing Changes
+- Add blacken to noxfile ([#6795](https://github.com/googleapis/google-cloud-python/pull/6795))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Nox: use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Fix bad trove classifier
+
+## 0.28.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-resource-manager/0.28.0/
diff --git a/resource_manager/LICENSE b/resource_manager/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/resource_manager/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/resource_manager/MANIFEST.in b/resource_manager/MANIFEST.in
new file mode 100644
index 000000000000..fc77f8c82ff0
--- /dev/null
+++ b/resource_manager/MANIFEST.in
@@ -0,0 +1,4 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.pyc __pycache__
diff --git a/resource_manager/README.rst b/resource_manager/README.rst
new file mode 100644
index 000000000000..6470b391db1f
--- /dev/null
+++ b/resource_manager/README.rst
@@ -0,0 +1,159 @@
+Python Client for Google Cloud Resource Manager
+===============================================
+
+|alpha| |pypi| |versions| 
+
+`Google Cloud Resource Manager`_ API provides methods that you can use
+to programmatically manage your projects in the Google Cloud Platform.
+With this API, you can do the following:
+
+- Get a list of all projects associated with an account
+- Create new projects
+- Update existing projects
+- Delete projects
+- Undelete, or recover, projects that you don't want to delete
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-resource-manager.svg
+   :target: https://pypi.org/project/google-cloud-resource-manager/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-resource-manager.svg
+   :target: https://pypi.org/project/google-cloud-resource-manager/
+.. _Google Cloud Resource Manager: https://cloud.google.com/resource-manager/
+.. _Client Library Documentation: https://googleapis.dev/python/cloudresourcemanager/latest
+.. _Product Documentation: https://cloud.google.com/resource-manager/docs/
+
+.. note::
+
+    Don't forget to look at the `Authentication`_ section below.
+    It's slightly different from the rest of this library.
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Resource Manager API.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Resource Manager API.:  https://cloud.google.com/resource-manager
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-resource-manager
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-resource-manager
+
+
+Authentication
+~~~~~~~~~~~~~~
+
+Unlike the other APIs, the Resource Manager API is focused on managing your
+various projects inside Google Cloud Platform. What this means (currently, as
+of August 2015) is that you can't use a Service Account to work with some
+parts of this API (for example, creating projects).
+
+The reason is actually pretty simple: if your API call is trying to do
+something like create a project, what project's Service Account can you use?
+Currently none.
+
+This means that for this API you should always use the credentials
+provided by the `Google Cloud SDK`_, which you can get by running
+``gcloud auth login``.
+
+.. _Google Cloud SDK: http://cloud.google.com/sdk
+
+Once you run that command, ``google-cloud-python`` will automatically pick up
+the credentials, and you can use the "automatic discovery" feature of the
+library.
+
+Start by authenticating:
+
+.. code-block:: bash
+
+    $ gcloud auth login
+
+And then simply create a client:
+
+.. code-block:: python
+
+   from google.cloud import resource_manager
+   client = resource_manager.Client()
+
+Using the API
+-------------
+
+Here's a quick example of the full life-cycle:
+
+.. code-block:: python
+
+   from google.cloud import resource_manager
+
+   client = resource_manager.Client()
+
+   # List all projects you have access to
+   for project in client.list_projects():
+       print(project)
+
+   # Create a new project
+   new_project = client.new_project(
+    'your-project-id-here', name='My new project')
+   new_project.create()
+
+   # Update an existing project
+   project = client.fetch_project('my-existing-project')
+   project.name = 'Modified name'
+   project.update()
+
+   # Delete a project
+   project = client.new_project('my-existing-project')
+   project.delete()
+
+   # Undelete a project
+   project = client.new_project('my-existing-project')
+   project.undelete()
diff --git a/resource_manager/docs/README.rst b/resource_manager/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/resource_manager/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/resource_manager/docs/changelog.md b/resource_manager/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/resource_manager/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/resource_manager/docs/client.rst b/resource_manager/docs/client.rst
new file mode 100644
index 000000000000..1678f85d7066
--- /dev/null
+++ b/resource_manager/docs/client.rst
@@ -0,0 +1,10 @@
+.. toctree::
+  :maxdepth: 0
+  :hidden:
+
+Client
+------
+
+.. automodule:: google.cloud.resource_manager.client
+  :members:
+  :show-inheritance:
diff --git a/resource_manager/docs/conf.py b/resource_manager/docs/conf.py
new file mode 100644
index 000000000000..7a7904ebe73a
--- /dev/null
+++ b/resource_manager/docs/conf.py
@@ -0,0 +1,359 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-resource-manager documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-resource-manager"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-resource-manager-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-resource-manager.tex",
+        u"google-cloud-resource-manager Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-resource-manager",
+        u"google-cloud-resource-manager Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-resource-manager",
+        u"google-cloud-resource-manager Documentation",
+        author,
+        "google-cloud-resource-manager",
+        "GAPIC library for the Resource Manager API",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/resource_manager/docs/index.rst b/resource_manager/docs/index.rst
new file mode 100644
index 000000000000..14c5767258ca
--- /dev/null
+++ b/resource_manager/docs/index.rst
@@ -0,0 +1,21 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+.. toctree::
+  :maxdepth: 2
+
+  client
+  project
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-resource-manager`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/docs/resource-manager-project.rst b/resource_manager/docs/project.rst
similarity index 100%
rename from docs/resource-manager-project.rst
rename to resource_manager/docs/project.rst
diff --git a/resource_manager/google/__init__.py b/resource_manager/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/resource_manager/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/resource_manager/google/cloud/__init__.py b/resource_manager/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/resource_manager/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/resource_manager/google/cloud/resource_manager/__init__.py b/resource_manager/google/cloud/resource_manager/__init__.py
new file mode 100644
index 000000000000..bf71be7546f9
--- /dev/null
+++ b/resource_manager/google/cloud/resource_manager/__init__.py
@@ -0,0 +1,28 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud Resource Manager API wrapper."""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-resource-manager").version
+
+from google.cloud.resource_manager.client import Client
+from google.cloud.resource_manager.project import Project
+
+
+SCOPE = Client.SCOPE
+
+__all__ = ["__version__", "Client", "Project", "SCOPE"]
diff --git a/resource_manager/google/cloud/resource_manager/_http.py b/resource_manager/google/cloud/resource_manager/_http.py
new file mode 100644
index 000000000000..dcf1aeb0b9ea
--- /dev/null
+++ b/resource_manager/google/cloud/resource_manager/_http.py
@@ -0,0 +1,49 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Resource Manager connections."""
+
+
+from google.cloud import _http
+
+from google.cloud.resource_manager import __version__
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google Cloud Resource Manager via the JSON REST API.
+
+    :type client: :class:`~google.cloud.resource_manager.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions`
+    :param client_options (Optional) Client options used to set user options
+        on the client. API Endpoint should be set through client_options.
+    """
+
+    DEFAULT_API_ENDPOINT = "https://cloudresourcemanager.googleapis.com"
+
+    def __init__(self, client, client_info=None, api_endpoint=DEFAULT_API_ENDPOINT):
+        super(Connection, self).__init__(client, client_info)
+        self.API_BASE_URL = api_endpoint
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_VERSION = "v1beta1"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/{api_version}{path}"
+    """A template for the URL of a particular API call."""
diff --git a/resource_manager/google/cloud/resource_manager/client.py b/resource_manager/google/cloud/resource_manager/client.py
new file mode 100644
index 000000000000..70d15b311261
--- /dev/null
+++ b/resource_manager/google/cloud/resource_manager/client.py
@@ -0,0 +1,217 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A Client for interacting with the Resource Manager API."""
+
+import six
+
+import google.api_core.client_options
+from google.api_core import page_iterator
+from google.cloud.client import Client as BaseClient
+
+from google.cloud.resource_manager._http import Connection
+from google.cloud.resource_manager.project import Project
+
+
+class Client(BaseClient):
+    """Client to bundle configuration needed for API requests.
+
+    See
+    https://cloud.google.com/resource-manager/reference/rest/
+    for more information on this API.
+
+    Automatically get credentials::
+
+        >>> from google.cloud import resource_manager
+        >>> client = resource_manager.Client()
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions`
+        or :class:`dict`
+    :param client_options: (Optional) Client options used to set user options
+        on the client. API Endpoint should be set through client_options.
+    """
+
+    SCOPE = ("https://www.googleapis.com/auth/cloud-platform",)
+    """The scopes required for authenticating as a Resouce Manager consumer."""
+
+    def __init__(
+        self, credentials=None, _http=None, client_info=None, client_options=None
+    ):
+        super(Client, self).__init__(credentials=credentials, _http=_http)
+
+        kw_args = {"client_info": client_info}
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+                kw_args["api_endpoint"] = api_endpoint
+
+        self._connection = Connection(self, **kw_args)
+
+    def new_project(self, project_id, name=None, labels=None):
+        """Create a project bound to the current client.
+
+        Use :meth:`Project.reload() \
+        <google.cloud.resource_manager.project.Project.reload>` to retrieve
+        project metadata after creating a
+        :class:`~google.cloud.resource_manager.project.Project` instance.
+
+        .. note:
+
+            This does not make an API call.
+
+        :type project_id: str
+        :param project_id: The ID for this project.
+
+        :type name: str
+        :param name: The display name of the project.
+
+        :type labels: dict
+        :param labels: A list of labels associated with the project.
+
+        :rtype: :class:`~google.cloud.resource_manager.project.Project`
+        :returns: A new instance of a
+                  :class:`~google.cloud.resource_manager.project.Project`
+                  **without** any metadata loaded.
+        """
+        return Project(project_id=project_id, client=self, name=name, labels=labels)
+
+    def fetch_project(self, project_id):
+        """Fetch an existing project and it's relevant metadata by ID.
+
+        .. note::
+
+            If the project does not exist, this will raise a
+            :class:`NotFound <google.cloud.exceptions.NotFound>` error.
+
+        :type project_id: str
+        :param project_id: The ID for this project.
+
+        :rtype: :class:`~google.cloud.resource_manager.project.Project`
+        :returns: A :class:`~google.cloud.resource_manager.project.Project`
+                  with metadata fetched from the API.
+        """
+        project = self.new_project(project_id)
+        project.reload()
+        return project
+
+    def list_projects(self, filter_params=None, page_size=None):
+        """List the projects visible to this client.
+
+        Example::
+
+            >>> from google.cloud import resource_manager
+            >>> client = resource_manager.Client()
+            >>> for project in client.list_projects():
+            ...     print(project.project_id)
+
+        List all projects with label ``'environment'`` set to ``'prod'``
+        (filtering by labels)::
+
+            >>> from google.cloud import resource_manager
+            >>> client = resource_manager.Client()
+            >>> env_filter = {'labels.environment': 'prod'}
+            >>> for project in client.list_projects(env_filter):
+            ...     print(project.project_id)
+
+        See
+        https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/list
+
+        Complete filtering example::
+
+            >>> project_filter = {  # Return projects with...
+            ...     'name': 'My Project',  # name set to 'My Project'.
+            ...     'id': 'my-project-id',  # id set to 'my-project-id'.
+            ...     'labels.stage': 'prod',  # the label 'stage' set to 'prod'
+            ...     'labels.color': '*'  # a label 'color' set to anything.
+            ... }
+            >>> client.list_projects(project_filter)
+
+        :type filter_params: dict
+        :param filter_params: (Optional) A dictionary of filter options where
+                              each key is a property to filter on, and each
+                              value is the (case-insensitive) value to check
+                              (or the glob ``*`` to check for existence of the
+                              property). See the example above for more
+                              details.
+
+        :type page_size: int
+        :param page_size: (Optional) The maximum number of projects in each
+                          page of results from this request. Non-positive
+                          values are ignored. Defaults to a sensible value
+                          set by the API.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of all
+                  :class:`~google.cloud.resource_manager.project.Project`.
+                  that the current user has access to.
+        """
+        extra_params = {}
+
+        if page_size is not None:
+            extra_params["pageSize"] = page_size
+
+        if filter_params is not None:
+            extra_params["filter"] = [
+                "{}:{}".format(key, value)
+                for key, value in six.iteritems(filter_params)
+            ]
+
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=self._connection.api_request,
+            path="/projects",
+            item_to_value=_item_to_project,
+            items_key="projects",
+            extra_params=extra_params,
+        )
+
+
+def _item_to_project(iterator, resource):
+    """Convert a JSON project to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type resource: dict
+    :param resource: A resource to be converted to a project.
+
+    :rtype: :class:`.Project`
+    :returns: The next project in the page.
+    """
+    return Project.from_api_repr(resource, client=iterator.client)
diff --git a/google/cloud/resource_manager/project.py b/resource_manager/google/cloud/resource_manager/project.py
similarity index 87%
rename from google/cloud/resource_manager/project.py
rename to resource_manager/google/cloud/resource_manager/project.py
index a13df3040fdb..cf499fa286b1 100644
--- a/google/cloud/resource_manager/project.py
+++ b/resource_manager/google/cloud/resource_manager/project.py
@@ -1,4 +1,4 @@
-# Copyright 2015 Google Inc. All rights reserved.
+# Copyright 2015 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -36,21 +36,22 @@ class Project(object):
         >>> project.labels['environment'] = 'production'
         >>> project.update()
 
-    See:
+    See
     https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects
 
-    :type project_id: string
+    :type project_id: str
     :param project_id: The globally unique ID of the project.
 
     :type client: :class:`google.cloud.resource_manager.client.Client`
     :param client: The Client used with this project.
 
-    :type name: string
+    :type name: str
     :param name: The display name of the project.
 
     :type labels: dict
     :param labels: A list of labels associated with the project.
     """
+
     def __init__(self, project_id, client, name=None, labels=None):
         self._client = client
         self.project_id = project_id
@@ -58,9 +59,10 @@ def __init__(self, project_id, client, name=None, labels=None):
         self.number = None
         self.labels = labels or {}
         self.status = None
+        self.parent = None
 
     def __repr__(self):
-        return '<Project: %r (%r)>' % (self.name, self.project_id)
+        return "<Project: %r (%r)>" % (self.name, self.project_id)
 
     @classmethod
     def from_api_repr(cls, resource, client):
@@ -75,28 +77,30 @@ def from_api_repr(cls, resource, client):
         :rtype: :class:`google.cloud.resource_manager.project.Project`
         :returns: The project created.
         """
-        project = cls(project_id=resource['projectId'], client=client)
+        project = cls(project_id=resource["projectId"], client=client)
         project.set_properties_from_api_repr(resource)
         return project
 
     def set_properties_from_api_repr(self, resource):
         """Update specific properties from its API representation."""
-        self.name = resource.get('name')
-        self.number = resource['projectNumber']
-        self.labels = resource.get('labels', {})
-        self.status = resource['lifecycleState']
+        self.name = resource.get("name")
+        self.number = resource["projectNumber"]
+        self.labels = resource.get("labels", {})
+        self.status = resource["lifecycleState"]
+        if "parent" in resource:
+            self.parent = resource["parent"]
 
     @property
     def full_name(self):
         """Fully-qualified name (ie, ``'projects/purple-spaceship-123'``)."""
         if not self.project_id:
-            raise ValueError('Missing project ID.')
-        return 'projects/%s' % (self.project_id)
+            raise ValueError("Missing project ID.")
+        return "projects/%s" % (self.project_id)
 
     @property
     def path(self):
         """URL for the project (ie, ``'/projects/purple-spaceship-123'``)."""
-        return '/%s' % (self.full_name)
+        return "/%s" % (self.full_name)
 
     def _require_client(self, client):
         """Check client or verify over-ride.
@@ -126,13 +130,10 @@ def create(self, client=None):
         """
         client = self._require_client(client)
 
-        data = {
-            'projectId': self.project_id,
-            'name': self.name,
-            'labels': self.labels,
-        }
-        resp = client.connection.api_request(method='POST', path='/projects',
-                                             data=data)
+        data = {"projectId": self.project_id, "name": self.name, "labels": self.labels}
+        resp = client._connection.api_request(
+            method="POST", path="/projects", data=data
+        )
         self.set_properties_from_api_repr(resource=resp)
 
     def reload(self, client=None):
@@ -161,7 +162,7 @@ def reload(self, client=None):
 
         # We assume the project exists. If it doesn't it will raise a NotFound
         # exception.
-        resp = client.connection.api_request(method='GET', path=self.path)
+        resp = client._connection.api_request(method="GET", path=self.path)
         self.set_properties_from_api_repr(resource=resp)
 
     def exists(self, client=None):
@@ -183,7 +184,7 @@ def exists(self, client=None):
         try:
             # Note that we have to request the entire resource as the API
             # doesn't provide a way tocheck for existence only.
-            client.connection.api_request(method='GET', path=self.path)
+            client._connection.api_request(method="GET", path=self.path)
         except NotFound:
             return False
         else:
@@ -202,15 +203,15 @@ def update(self, client=None):
         """
         client = self._require_client(client)
 
-        data = {'name': self.name, 'labels': self.labels}
-        resp = client.connection.api_request(method='PUT', path=self.path,
-                                             data=data)
+        data = {"name": self.name, "labels": self.labels, "parent": self.parent}
+
+        resp = client._connection.api_request(method="PUT", path=self.path, data=data)
         self.set_properties_from_api_repr(resp)
 
     def delete(self, client=None, reload_data=False):
         """API call:  delete the project via a ``DELETE`` request.
 
-        See:
+        See
         https://cloud.google.com/resource-manager/reference/rest/v1beta1/projects/delete
 
         This actually changes the status (``lifecycleState``) from ``ACTIVE``
@@ -232,7 +233,7 @@ def delete(self, client=None, reload_data=False):
                             Default: :data:`False`.
         """
         client = self._require_client(client)
-        client.connection.api_request(method='DELETE', path=self.path)
+        client._connection.api_request(method="DELETE", path=self.path)
 
         # If the reload flag is set, reload the project.
         if reload_data:
@@ -262,8 +263,7 @@ def undelete(self, client=None, reload_data=False):
                             Default: :data:`False`.
         """
         client = self._require_client(client)
-        client.connection.api_request(method='POST',
-                                      path=self.path + ':undelete')
+        client._connection.api_request(method="POST", path=self.path + ":undelete")
 
         # If the reload flag is set, reload the project.
         if reload_data:
diff --git a/resource_manager/noxfile.py b/resource_manager/noxfile.py
new file mode 100644
index 000000000000..5d245ca88440
--- /dev/null
+++ b/resource_manager/noxfile.py
@@ -0,0 +1,131 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (
+    os.path.join('..', 'api_core'),
+    os.path.join('..', 'core'),
+)
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python='3.6')
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install('docutils', 'Pygments')
+    session.run(
+        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+
+
+def default(session):
+    """Default unit test session.
+
+    This is intended to be run **without** an interpreter set, so
+    that the current ``python`` (on the ``PATH``) or the version of
+    Python corresponding to the ``nox`` binary the ``PATH`` can
+    run the tests.
+    """
+    # Install all test dependencies, then install local packages in-place.
+    session.install('mock', 'pytest', 'pytest-cov')
+    for local_dep in LOCAL_DEPS:
+        session.install('-e', local_dep)
+    session.install('-e', '.')
+
+    # Run py.test against the unit tests.
+    session.run(
+        'py.test',
+        '--quiet',
+        '--cov=google.cloud.resource_manager',
+        '--cov=tests.unit',
+        '--cov-append',
+        '--cov-config=.coveragerc',
+        '--cov-report=',
+        '--cov-fail-under=97',
+        'tests/unit',
+    )
+
+
+@nox.session(python=['2.7', '3.5', '3.6', '3.7'])
+def unit(session):
+    default(session)
+
+
+@nox.session(python='3.6')
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install('coverage', 'pytest-cov')
+    session.run('coverage', 'report', '--show-missing', '--fail-under=100')
+    session.run('coverage', 'erase')
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
\ No newline at end of file
diff --git a/resource_manager/pylint.config.py b/resource_manager/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/resource_manager/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/resource_manager/setup.cfg b/resource_manager/setup.cfg
new file mode 100644
index 000000000000..2a9acf13daa9
--- /dev/null
+++ b/resource_manager/setup.cfg
@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1
diff --git a/resource_manager/setup.py b/resource_manager/setup.py
new file mode 100644
index 000000000000..f2f28c680f29
--- /dev/null
+++ b/resource_manager/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-resource-manager'
+description = 'Google Cloud Resource Manager API client library'
+version = '0.29.2'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    "google-cloud-core >= 1.0.3, < 2.0dev",
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/resource_manager/tests/__init__.py b/resource_manager/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/resource_manager/tests/unit/__init__.py b/resource_manager/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/resource_manager/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/resource_manager/tests/unit/test__http.py b/resource_manager/tests/unit/test__http.py
new file mode 100644
index 000000000000..619845cb3126
--- /dev/null
+++ b/resource_manager/tests/unit/test__http.py
@@ -0,0 +1,78 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.resource_manager._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_build_api_url_no_extra_query_params(self):
+        conn = self._make_one(object())
+        URI = "/".join([conn.DEFAULT_API_ENDPOINT, conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_custom_endpoint(self):
+        custom_endpoint = "https://foo-cloudresourcemanager.googleapis.com"
+        conn = self._make_one(object(), api_endpoint=custom_endpoint)
+        URI = "/".join([custom_endpoint, conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_extra_query_params(self):
+        from six.moves.urllib.parse import parse_qsl
+        from six.moves.urllib.parse import urlsplit
+
+        conn = self._make_one(object())
+        uri = conn.build_api_url("/foo", {"bar": "baz"})
+        scheme, netloc, path, qs, _ = urlsplit(uri)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        self.assertEqual(path, "/".join(["", conn.API_VERSION, "foo"]))
+        parms = dict(parse_qsl(qs))
+        self.assertEqual(parms["bar"], "baz")
+
+    def test_extra_headers(self):
+        import requests
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
diff --git a/resource_manager/tests/unit/test_client.py b/resource_manager/tests/unit/test_client.py
new file mode 100644
index 000000000000..7ecd814b5066
--- /dev/null
+++ b/resource_manager/tests/unit/test_client.py
@@ -0,0 +1,339 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.resource_manager.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_wo_client_info(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.resource_manager._http import Connection
+
+        http = object()
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials, _http=http)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._credentials, credentials)
+        self.assertIs(client._http_internal, http)
+        self.assertIsInstance(client._connection._client_info, ClientInfo)
+
+    def test_ctor_w_client_info(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.resource_manager._http import Connection
+
+        http = object()
+        client_info = ClientInfo()
+        credentials = _make_credentials()
+        client = self._make_one(
+            credentials=credentials, _http=http, client_info=client_info
+        )
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._credentials, credentials)
+        self.assertIs(client._http_internal, http)
+        self.assertIs(client._connection._client_info, client_info)
+
+    def test_ctor_w_empty_client_options(self):
+        from google.api_core.client_options import ClientOptions
+
+        http = object()
+        client_options = ClientOptions()
+        client = self._make_one(_http=http, client_options=client_options)
+        self.assertEqual(
+            client._connection.API_BASE_URL, client._connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_ctor_w_client_options_object(self):
+        from google.api_core.client_options import ClientOptions
+
+        http = object()
+        client_options = ClientOptions(
+            api_endpoint="https://foo-cloudresourcemanager.googleapis.com"
+        )
+        client = self._make_one(_http=http, client_options=client_options)
+        self.assertEqual(
+            client._connection.API_BASE_URL,
+            "https://foo-cloudresourcemanager.googleapis.com",
+        )
+
+    def test_ctor_w_client_options_dict(self):
+        http = object()
+        client_options = {
+            "api_endpoint": "https://foo-cloudresourcemanager.googleapis.com"
+        }
+
+        client = self._make_one(_http=http, client_options=client_options)
+        self.assertEqual(
+            client._connection.API_BASE_URL,
+            "https://foo-cloudresourcemanager.googleapis.com",
+        )
+
+    def test_new_project_factory(self):
+        from google.cloud.resource_manager.project import Project
+
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+        project_id = "project_id"
+        name = object()
+        labels = object()
+        project = client.new_project(project_id, name=name, labels=labels)
+
+        self.assertIsInstance(project, Project)
+        self.assertEqual(project._client, client)
+        self.assertEqual(project.project_id, project_id)
+        self.assertEqual(project.name, name)
+        self.assertEqual(project.labels, labels)
+
+    def test_fetch_project(self):
+        from google.cloud.resource_manager.project import Project
+
+        project_id = "project-id"
+        project_number = 123
+        project_name = "Project Name"
+        labels = {"env": "prod"}
+        project_resource = {
+            "projectId": project_id,
+            "projectNumber": project_number,
+            "name": project_name,
+            "labels": labels,
+            "lifecycleState": "ACTIVE",
+        }
+
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+        # Patch the connection with one we can easily control.
+        client._connection = _Connection(project_resource)
+
+        project = client.fetch_project(project_id)
+        self.assertIsInstance(project, Project)
+        self.assertEqual(project._client, client)
+        self.assertEqual(project.project_id, project_id)
+        self.assertEqual(project.name, project_name)
+        self.assertEqual(project.labels, labels)
+
+    def test_list_projects_return_type(self):
+        from google.api_core import page_iterator
+
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+        # Patch the connection with one we can easily control.
+        client._connection = _Connection({})
+
+        results = client.list_projects()
+        self.assertIsInstance(results, page_iterator.HTTPIterator)
+
+    def test_list_projects_no_paging(self):
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 1
+        STATUS = "ACTIVE"
+        PROJECTS_RESOURCE = {
+            "projects": [
+                {
+                    "projectId": PROJECT_ID,
+                    "projectNumber": PROJECT_NUMBER,
+                    "lifecycleState": STATUS,
+                }
+            ]
+        }
+        # Patch the connection with one we can easily control.
+        client._connection = _Connection(PROJECTS_RESOURCE)
+        # Make sure there will be no paging.
+        self.assertFalse("nextPageToken" in PROJECTS_RESOURCE)
+
+        results = list(client.list_projects())
+
+        project, = results
+        self.assertEqual(project.project_id, PROJECT_ID)
+        self.assertEqual(project.number, PROJECT_NUMBER)
+        self.assertEqual(project.status, STATUS)
+
+    def test_list_projects_with_paging(self):
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+
+        PROJECT_ID1 = "project-id"
+        PROJECT_NUMBER1 = 1
+        STATUS = "ACTIVE"
+        TOKEN = "next-page-token"
+        FIRST_PROJECTS_RESOURCE = {
+            "projects": [
+                {
+                    "projectId": PROJECT_ID1,
+                    "projectNumber": PROJECT_NUMBER1,
+                    "lifecycleState": STATUS,
+                }
+            ],
+            "nextPageToken": TOKEN,
+        }
+        PROJECT_ID2 = "project-id-2"
+        PROJECT_NUMBER2 = 42
+        SECOND_PROJECTS_RESOURCE = {
+            "projects": [
+                {
+                    "projectId": PROJECT_ID2,
+                    "projectNumber": PROJECT_NUMBER2,
+                    "lifecycleState": STATUS,
+                }
+            ]
+        }
+        # Patch the connection with one we can easily control.
+        client._connection = _Connection(
+            FIRST_PROJECTS_RESOURCE, SECOND_PROJECTS_RESOURCE
+        )
+
+        # Page size = 1 with two response means we'll have two requests.
+        results = list(client.list_projects(page_size=1))
+
+        # Check that the results are as expected.
+        project1, project2 = results
+        self.assertEqual(project1.project_id, PROJECT_ID1)
+        self.assertEqual(project1.number, PROJECT_NUMBER1)
+        self.assertEqual(project1.status, STATUS)
+        self.assertEqual(project2.project_id, PROJECT_ID2)
+        self.assertEqual(project2.number, PROJECT_NUMBER2)
+        self.assertEqual(project2.status, STATUS)
+
+        # Check that two requests were required since page_size=1.
+        request1, request2 = client._connection._requested
+        self.assertEqual(
+            request1,
+            {"path": "/projects", "method": "GET", "query_params": {"pageSize": 1}},
+        )
+        self.assertEqual(
+            request2,
+            {
+                "path": "/projects",
+                "method": "GET",
+                "query_params": {"pageSize": 1, "pageToken": TOKEN},
+            },
+        )
+
+    def test_list_projects_with_filter(self):
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 1
+        STATUS = "ACTIVE"
+        PROJECTS_RESOURCE = {
+            "projects": [
+                {
+                    "projectId": PROJECT_ID,
+                    "projectNumber": PROJECT_NUMBER,
+                    "lifecycleState": STATUS,
+                }
+            ]
+        }
+        # Patch the connection with one we can easily control.
+        client._connection = _Connection(PROJECTS_RESOURCE)
+
+        FILTER_PARAMS = {"id": "project-id"}
+        results = list(client.list_projects(filter_params=FILTER_PARAMS))
+
+        project, = results
+        self.assertEqual(project.project_id, PROJECT_ID)
+        self.assertEqual(project.number, PROJECT_NUMBER)
+        self.assertEqual(project.status, STATUS)
+
+        # Check that the filter made it in the request.
+        FLATTENED_FILTER_PARAMS = ["id:project-id"]
+        request, = client._connection._requested
+        self.assertEqual(
+            request,
+            {
+                "path": "/projects",
+                "method": "GET",
+                "query_params": {"filter": FLATTENED_FILTER_PARAMS},
+            },
+        )
+
+    def test_page_empty_response(self):
+        from google.api_core import page_iterator
+
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+        iterator = client.list_projects()
+        page = page_iterator.Page(iterator, (), None)
+        iterator._page = page
+        self.assertEqual(page.num_items, 0)
+        self.assertEqual(page.remaining, 0)
+        self.assertEqual(list(page), [])
+
+    def test_page_non_empty_response(self):
+        import six
+        from google.cloud.resource_manager.project import Project
+
+        project_id = "project-id"
+        project_name = "My Project Name"
+        project_number = 12345678
+        project_labels = {"env": "prod"}
+        project_lifecycle_state = "ACTIVE"
+        api_resource = {
+            "projectId": project_id,
+            "name": project_name,
+            "projectNumber": project_number,
+            "labels": project_labels,
+            "lifecycleState": project_lifecycle_state,
+        }
+        response = {"projects": [api_resource]}
+        credentials = _make_credentials()
+        client = self._make_one(credentials=credentials)
+
+        def dummy_response():
+            return response
+
+        iterator = client.list_projects()
+        iterator._get_next_page_response = dummy_response
+
+        page = six.next(iterator.pages)
+        self.assertEqual(page.num_items, 1)
+        project = six.next(page)
+        self.assertEqual(page.remaining, 0)
+        self.assertIsInstance(project, Project)
+        self.assertEqual(project.project_id, project_id)
+        self.assertEqual(project._client, client)
+        self.assertEqual(project.name, project_name)
+        self.assertEqual(project.number, project_number)
+        self.assertEqual(project.labels, project_labels)
+        self.assertEqual(project.status, project_lifecycle_state)
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
diff --git a/resource_manager/tests/unit/test_project.py b/resource_manager/tests/unit/test_project.py
new file mode 100644
index 000000000000..bc23bdc02cb7
--- /dev/null
+++ b/resource_manager/tests/unit/test_project.py
@@ -0,0 +1,328 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestProject(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.resource_manager.project import Project
+
+        return Project
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        client = object()
+        PROJECT_ID = "project-id"
+        project = self._make_one(PROJECT_ID, client)
+        self.assertEqual(project.project_id, PROJECT_ID)
+        self.assertEqual(project._client, client)
+        self.assertIsNone(project.name)
+        self.assertIsNone(project.number)
+        self.assertEqual(project.labels, {})
+        self.assertIsNone(project.status)
+        self.assertIsNone(project.parent)
+
+    def test_constructor_explicit(self):
+        client = object()
+        PROJECT_ID = "project-id"
+        DISPLAY_NAME = "name"
+        LABELS = {"foo": "bar"}
+        project = self._make_one(PROJECT_ID, client, name=DISPLAY_NAME, labels=LABELS)
+        self.assertEqual(project.project_id, PROJECT_ID)
+        self.assertEqual(project._client, client)
+        self.assertEqual(project.name, DISPLAY_NAME)
+        self.assertIsNone(project.number)
+        self.assertEqual(project.labels, LABELS)
+        self.assertIsNone(project.status)
+        self.assertIsNone(project.parent)
+
+    def test_from_api_repr(self):
+        client = object()
+        PROJECT_ID = "project-id"
+        PROJECT_NAME = "My Project Name"
+        PROJECT_NUMBER = 12345678
+        PROJECT_LABELS = {"env": "prod"}
+        PROJECT_LIFECYCLE_STATE = "ACTIVE"
+        PARENT = {"type": "organization", "id": "433637338579"}
+
+        resource = {
+            "projectId": PROJECT_ID,
+            "name": PROJECT_NAME,
+            "projectNumber": PROJECT_NUMBER,
+            "labels": PROJECT_LABELS,
+            "lifecycleState": PROJECT_LIFECYCLE_STATE,
+            "parent": PARENT,
+        }
+        project = self._get_target_class().from_api_repr(resource, client)
+        self.assertEqual(project.project_id, PROJECT_ID)
+        self.assertEqual(project._client, client)
+        self.assertEqual(project.name, PROJECT_NAME)
+        self.assertEqual(project.number, PROJECT_NUMBER)
+        self.assertEqual(project.labels, PROJECT_LABELS)
+        self.assertEqual(project.status, PROJECT_LIFECYCLE_STATE)
+        self.assertEqual(project.parent, PARENT)
+
+    def test_full_name(self):
+        PROJECT_ID = "project-id"
+        project = self._make_one(PROJECT_ID, None)
+        self.assertEqual("projects/%s" % PROJECT_ID, project.full_name)
+
+    def test_full_name_missing_id(self):
+        project = self._make_one(None, None)
+        with self.assertRaises(ValueError):
+            self.assertIsNone(project.full_name)
+
+    def test_path(self):
+        PROJECT_ID = "project-id"
+        project = self._make_one(PROJECT_ID, None)
+        self.assertEqual("/projects/%s" % PROJECT_ID, project.path)
+
+    def test_create(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": "Project Name",
+            "labels": {},
+            "lifecycleState": "ACTIVE",
+            "parent": {"type": "organization", "id": "433637338589"},
+        }
+        connection = _Connection(PROJECT_RESOURCE)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        self.assertIsNone(project.number)
+        project.create()
+        self.assertEqual(project.number, PROJECT_NUMBER)
+        request, = connection._requested
+
+        expected_request = {
+            "method": "POST",
+            "data": {"projectId": PROJECT_ID, "labels": {}, "name": None},
+            "path": "/projects",
+        }
+        self.assertEqual(request, expected_request)
+
+    def test_reload(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": "Project Name",
+            "labels": {"env": "prod"},
+            "lifecycleState": "ACTIVE",
+            "parent": {"type": "organization", "id": "433637338579"},
+        }
+        connection = _Connection(PROJECT_RESOURCE)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        self.assertIsNone(project.number)
+        self.assertIsNone(project.name)
+        self.assertEqual(project.labels, {})
+        self.assertIsNone(project.status)
+        project.reload()
+        self.assertEqual(project.name, PROJECT_RESOURCE["name"])
+        self.assertEqual(project.number, PROJECT_NUMBER)
+        self.assertEqual(project.labels, PROJECT_RESOURCE["labels"])
+        self.assertEqual(project.status, PROJECT_RESOURCE["lifecycleState"])
+
+        request, = connection._requested
+        # NOTE: data is not in the request since a GET request.
+        expected_request = {"method": "GET", "path": project.path}
+        self.assertEqual(request, expected_request)
+
+    def test_exists(self):
+        PROJECT_ID = "project-id"
+        connection = _Connection({"projectId": PROJECT_ID})
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        self.assertTrue(project.exists())
+
+    def test_exists_with_explicitly_passed_client(self):
+        PROJECT_ID = "project-id"
+        connection = _Connection({"projectId": PROJECT_ID})
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, None)
+        self.assertTrue(project.exists(client=client))
+
+    def test_exists_with_missing_client(self):
+        PROJECT_ID = "project-id"
+        project = self._make_one(PROJECT_ID, None)
+        with self.assertRaises(AttributeError):
+            project.exists()
+
+    def test_exists_not_found(self):
+        PROJECT_ID = "project-id"
+        connection = _Connection()
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        self.assertFalse(project.exists())
+
+    def test_update(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_NAME = "Project Name"
+        LABELS = {"env": "prod"}
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": PROJECT_NAME,
+            "labels": LABELS,
+            "lifecycleState": "ACTIVE",
+        }
+        connection = _Connection(PROJECT_RESOURCE)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        project.name = PROJECT_NAME
+        project.labels = LABELS
+        project.update()
+
+        request, = connection._requested
+        expected_request = {
+            "method": "PUT",
+            "data": {"name": PROJECT_NAME, "labels": LABELS, "parent": None},
+            "path": project.path,
+        }
+        self.assertEqual(request, expected_request)
+
+    def test_delete_without_reload_data(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": "Project Name",
+            "labels": {"env": "prod"},
+            "lifecycleState": "ACTIVE",
+            "parent": {"type": "organization", "id": "433637338579"},
+        }
+        connection = _Connection(PROJECT_RESOURCE)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        project.delete(reload_data=False)
+
+        request, = connection._requested
+        # NOTE: data is not in the request since a DELETE request.
+        expected_request = {"method": "DELETE", "path": project.path}
+        self.assertEqual(request, expected_request)
+
+    def test_delete_with_reload_data(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": "Project Name",
+            "labels": {"env": "prod"},
+            "lifecycleState": "ACTIVE",
+            "parent": {"type": "organization", "id": "433637338579"},
+        }
+        DELETING_PROJECT = PROJECT_RESOURCE.copy()
+        DELETING_PROJECT["lifecycleState"] = NEW_STATE = "DELETE_REQUESTED"
+
+        connection = _Connection(PROJECT_RESOURCE, DELETING_PROJECT)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        project.delete(reload_data=True)
+        self.assertEqual(project.status, NEW_STATE)
+
+        delete_request, get_request = connection._requested
+        # NOTE: data is not in the request since a DELETE request.
+        expected_delete_request = {"method": "DELETE", "path": project.path}
+        self.assertEqual(delete_request, expected_delete_request)
+
+        # NOTE: data is not in the request since a GET request.
+        expected_get_request = {"method": "GET", "path": project.path}
+        self.assertEqual(get_request, expected_get_request)
+
+    def test_undelete_without_reload_data(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": "Project Name",
+            "labels": {"env": "prod"},
+            "lifecycleState": "DELETE_REQUESTED",
+            "parent": {"type": "organization", "id": "433637338579"},
+        }
+        connection = _Connection(PROJECT_RESOURCE)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        project.undelete(reload_data=False)
+
+        request, = connection._requested
+        # NOTE: data is not in the request, undelete doesn't need it.
+        expected_request = {"method": "POST", "path": project.path + ":undelete"}
+        self.assertEqual(request, expected_request)
+
+    def test_undelete_with_reload_data(self):
+        PROJECT_ID = "project-id"
+        PROJECT_NUMBER = 123
+        PROJECT_RESOURCE = {
+            "projectId": PROJECT_ID,
+            "projectNumber": PROJECT_NUMBER,
+            "name": "Project Name",
+            "labels": {"env": "prod"},
+            "lifecycleState": "DELETE_REQUESTED",
+            "parent": {"type": "organization", "id": "433637338579"},
+        }
+        UNDELETED_PROJECT = PROJECT_RESOURCE.copy()
+        UNDELETED_PROJECT["lifecycleState"] = NEW_STATE = "ACTIVE"
+
+        connection = _Connection(PROJECT_RESOURCE, UNDELETED_PROJECT)
+        client = _Client(connection=connection)
+        project = self._make_one(PROJECT_ID, client)
+        project.undelete(reload_data=True)
+        self.assertEqual(project.status, NEW_STATE)
+
+        undelete_request, get_request = connection._requested
+        # NOTE: data is not in the request, undelete doesn't need it.
+        expected_undelete_request = {
+            "method": "POST",
+            "path": project.path + ":undelete",
+        }
+        self.assertEqual(undelete_request, expected_undelete_request)
+
+        # NOTE: data is not in the request since a GET request.
+        expected_get_request = {"method": "GET", "path": project.path}
+        self.assertEqual(get_request, expected_get_request)
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        self._requested.append(kw)
+
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        else:
+            return response
+
+
+class _Client(object):
+    def __init__(self, connection=None):
+        self._connection = connection
diff --git a/runtimeconfig/.coveragerc b/runtimeconfig/.coveragerc
new file mode 100644
index 000000000000..098720f672e1
--- /dev/null
+++ b/runtimeconfig/.coveragerc
@@ -0,0 +1,16 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
diff --git a/runtimeconfig/.flake8 b/runtimeconfig/.flake8
new file mode 100644
index 000000000000..61766fa84d02
--- /dev/null
+++ b/runtimeconfig/.flake8
@@ -0,0 +1,13 @@
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/runtimeconfig/.repo-metadata.json b/runtimeconfig/.repo-metadata.json
new file mode 100644
index 000000000000..7801655872cf
--- /dev/null
+++ b/runtimeconfig/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "runtimeconfig",
+  "name_pretty": "Google Cloud Runtime Configurator",
+  "product_documentation": "https://cloud.google.com/deployment-manager/runtime-configurator/",
+  "client_documentation": "https://googleapis.dev/python/runtimeconfig/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559663",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-runtimeconfig",
+  "api_id": "runtimeconfig.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/runtimeconfig/CHANGELOG.md b/runtimeconfig/CHANGELOG.md
new file mode 100644
index 000000000000..3c930b633c60
--- /dev/null
+++ b/runtimeconfig/CHANGELOG.md
@@ -0,0 +1,117 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-runtimeconfig/#history
+
+## 0.29.2
+
+07-24-2019 17:26 PDT
+
+
+### Documentation
+- Fix docs navigation issues. ([#8723](https://github.com/googleapis/google-cloud-python/pull/8723))
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Add nox session 'docs' to remaining manual clients. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 0.29.1
+
+06-04-2019 11:15 PDT
+
+
+### Dependencies
+- Don't pin `google-api-core` in libs using `google-cloud-core`. ([#8213](https://github.com/googleapis/google-cloud-python/pull/8213))
+
+## 0.29.0
+
+05-16-2019 12:32 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to client / connection. ([#7871](https://github.com/googleapis/google-cloud-python/pull/7871))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+## 0.28.3
+
+12-17-2018 17:01 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Docs/fixit: normalize docs for `page_size` / `max_results` / `page_token`. ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+## 0.28.2
+
+12-10-2018 13:05 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Fix variable nanosecond timestamp `update_time` from response ([#4819](https://github.com/googleapis/google-cloud-python/pull/4819))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Update README service links in quickstart guides. ([#6322](https://github.com/googleapis/google-cloud-python/pull/6322))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Prep docs for repo split. ([#6023](https://github.com/googleapis/google-cloud-python/pull/6023))
+
+### Internal / Testing Changes
+- Add blacken to noxfile ([#6795](https://github.com/googleapis/google-cloud-python/pull/6795))
+- Blackening Continued... ([#6667](https://github.com/googleapis/google-cloud-python/pull/6667))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Add tests with microseconds and nanoseconds ([#5150](https://github.com/googleapis/google-cloud-python/pull/5150))
+- Fix bad trove classifier
+
+## 0.28.1
+
+### Implementation changes
+
+- Set default variable state to Unspecified (#4738)
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+- Fix example in `Config.get_variable()` (#3910)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-runtimeconfig/0.28.0/
diff --git a/runtimeconfig/LICENSE b/runtimeconfig/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/runtimeconfig/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/runtimeconfig/MANIFEST.in b/runtimeconfig/MANIFEST.in
new file mode 100644
index 000000000000..fc77f8c82ff0
--- /dev/null
+++ b/runtimeconfig/MANIFEST.in
@@ -0,0 +1,4 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.pyc __pycache__
diff --git a/runtimeconfig/README.rst b/runtimeconfig/README.rst
new file mode 100644
index 000000000000..8069229a56db
--- /dev/null
+++ b/runtimeconfig/README.rst
@@ -0,0 +1,93 @@
+Python Client for Google Cloud RuntimeConfig
+============================================
+
+|alpha| |pypi| |versions| 
+
+The `Google Cloud RuntimeConfig`_ API enables developers to dynamically
+configure and expose variables through Google Cloud Platform. In addition, you
+can also set Watchers and Waiters that will watch for changes to your data and
+return based on certain conditions.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-runtimeconfig.svg
+   :target: https://pypi.org/project/google-cloud-runtimeconfig/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-runtimeconfig.svg
+   :target: https://pypi.org/project/google-cloud-runtimeconfig/
+.. _Google Cloud RuntimeConfig: https://cloud.google.com/deployment-manager/runtime-configurator/
+.. _Client Library Documentation: https://googleapis.dev/python/runtimeconfig/latest
+.. _Product Documentation: https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/
+
+**This client library is currently in alpha and may be subject to change.**
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud RuntimeConfig API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud RuntimeConfig API.:  https://cloud.google.com/runtimeconfig
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-runtimeconfig
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-runtimeconfig
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud RuntimeConfig
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
+
+
diff --git a/runtimeconfig/docs/README.rst b/runtimeconfig/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/runtimeconfig/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/runtimeconfig/docs/changelog.md b/runtimeconfig/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/runtimeconfig/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/runtimeconfig/docs/client.rst b/runtimeconfig/docs/client.rst
new file mode 100644
index 000000000000..20775256be84
--- /dev/null
+++ b/runtimeconfig/docs/client.rst
@@ -0,0 +1,6 @@
+Runtime Configuration Client
+============================
+
+.. automodule:: google.cloud.runtimeconfig.client
+  :members:
+  :show-inheritance:
diff --git a/runtimeconfig/docs/conf.py b/runtimeconfig/docs/conf.py
new file mode 100644
index 000000000000..b745c4631310
--- /dev/null
+++ b/runtimeconfig/docs/conf.py
@@ -0,0 +1,359 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-automl documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-automl"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-automl-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-automl.tex",
+        u"google-cloud-automl Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-automl",
+        u"google-cloud-automl Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-automl",
+        u"google-cloud-automl Documentation",
+        author,
+        "google-cloud-automl",
+        "GAPIC library for the RuntimeConfig API",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/runtimeconfig/docs/config.rst b/runtimeconfig/docs/config.rst
new file mode 100644
index 000000000000..6a612bfaa5c4
--- /dev/null
+++ b/runtimeconfig/docs/config.rst
@@ -0,0 +1,6 @@
+Configuration
+~~~~~~~~~~~~~
+
+.. automodule:: google.cloud.runtimeconfig.config
+  :members:
+  :show-inheritance:
diff --git a/runtimeconfig/docs/index.rst b/runtimeconfig/docs/index.rst
new file mode 100644
index 000000000000..1fa0aef135e7
--- /dev/null
+++ b/runtimeconfig/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+API Reference
+-------------
+
+.. toctree::
+   :maxdepth: 2
+
+   client
+   config
+   variable
+
+Changelog
+---------
+
+For a list of all ``google-cloud-runtimeconfig`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
+
diff --git a/runtimeconfig/docs/usage.html b/runtimeconfig/docs/usage.html
new file mode 100644
index 000000000000..9b81d6976cda
--- /dev/null
+++ b/runtimeconfig/docs/usage.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <script>
+   window.location.href = "./index.html"
+ </script>
+</head>
+</html>
diff --git a/runtimeconfig/docs/variable.rst b/runtimeconfig/docs/variable.rst
new file mode 100644
index 000000000000..7ead6393fe90
--- /dev/null
+++ b/runtimeconfig/docs/variable.rst
@@ -0,0 +1,6 @@
+Variables
+~~~~~~~~~
+
+.. automodule:: google.cloud.runtimeconfig.variable
+  :members:
+  :show-inheritance:
diff --git a/runtimeconfig/google/__init__.py b/runtimeconfig/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/runtimeconfig/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/runtimeconfig/google/cloud/__init__.py b/runtimeconfig/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/runtimeconfig/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/runtimeconfig/google/cloud/runtimeconfig/__init__.py b/runtimeconfig/google/cloud/runtimeconfig/__init__.py
new file mode 100644
index 000000000000..5078041661c5
--- /dev/null
+++ b/runtimeconfig/google/cloud/runtimeconfig/__init__.py
@@ -0,0 +1,24 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud Runtime Configurator API package."""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-runtimeconfig").version
+
+from google.cloud.runtimeconfig.client import Client
+
+__all__ = ["__version__", "Client"]
diff --git a/runtimeconfig/google/cloud/runtimeconfig/_helpers.py b/runtimeconfig/google/cloud/runtimeconfig/_helpers.py
new file mode 100644
index 000000000000..d554a79684e0
--- /dev/null
+++ b/runtimeconfig/google/cloud/runtimeconfig/_helpers.py
@@ -0,0 +1,73 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shared helper functions for RuntimeConfig API classes."""
+
+
+def config_name_from_full_name(full_name):
+    """Extract the config name from a full resource name.
+
+      >>> config_name_from_full_name('projects/my-proj/configs/my-config')
+      "my-config"
+
+    :type full_name: str
+    :param full_name:
+        The full resource name of a config. The full resource name looks like
+        ``projects/project-name/configs/config-name`` and is returned as the
+        ``name`` field of a config resource.  See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs
+
+    :rtype: str
+    :returns: The config's short name, given its full resource name.
+    :raises: :class:`ValueError` if ``full_name`` is not the expected format
+    """
+    projects, _, configs, result = full_name.split("/")
+    if projects != "projects" or configs != "configs":
+        raise ValueError(
+            "Unexpected format of resource",
+            full_name,
+            'Expected "projects/{proj}/configs/{cfg}"',
+        )
+    return result
+
+
+def variable_name_from_full_name(full_name):
+    """Extract the variable name from a full resource name.
+
+      >>> variable_name_from_full_name(
+              'projects/my-proj/configs/my-config/variables/var-name')
+      "var-name"
+      >>> variable_name_from_full_name(
+              'projects/my-proj/configs/my-config/variables/another/var/name')
+      "another/var/name"
+
+    :type full_name: str
+    :param full_name:
+        The full resource name of a variable. The full resource name looks like
+        ``projects/prj-name/configs/cfg-name/variables/var-name`` and is
+        returned as the ``name`` field of a variable resource.  See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables
+
+    :rtype: str
+    :returns: The variable's short name, given its full resource name.
+    :raises: :class:`ValueError` if ``full_name`` is not the expected format
+    """
+    projects, _, configs, _, variables, result = full_name.split("/", 5)
+    if projects != "projects" or configs != "configs" or variables != "variables":
+        raise ValueError(
+            "Unexpected format of resource",
+            full_name,
+            'Expected "projects/{proj}/configs/{cfg}/variables/..."',
+        )
+    return result
diff --git a/runtimeconfig/google/cloud/runtimeconfig/_http.py b/runtimeconfig/google/cloud/runtimeconfig/_http.py
new file mode 100644
index 000000000000..44e8d8455cc1
--- /dev/null
+++ b/runtimeconfig/google/cloud/runtimeconfig/_http.py
@@ -0,0 +1,46 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Create / interact with Google Cloud RuntimeConfig connections."""
+
+
+from google.cloud import _http
+
+from google.cloud.runtimeconfig import __version__
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google Cloud RuntimeConfig via the JSON REST API.
+
+    :type client: :class:`~google.cloud.runtimeconfig.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+    """
+
+    DEFAULT_API_ENDPOINT = "https://runtimeconfig.googleapis.com"
+
+    def __init__(self, client, client_info=None, api_endpoint=DEFAULT_API_ENDPOINT):
+        super(Connection, self).__init__(client, client_info)
+        self.API_BASE_URL = api_endpoint
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_VERSION = "v1beta1"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/{api_version}{path}"
+    """A template for the URL of a particular API call."""
diff --git a/runtimeconfig/google/cloud/runtimeconfig/client.py b/runtimeconfig/google/cloud/runtimeconfig/client.py
new file mode 100644
index 000000000000..9a2db25304cd
--- /dev/null
+++ b/runtimeconfig/google/cloud/runtimeconfig/client.py
@@ -0,0 +1,99 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Google Cloud RuntimeConfig API."""
+
+import google.api_core.client_options
+from google.cloud.client import ClientWithProject
+
+from google.cloud.runtimeconfig._http import Connection
+from google.cloud.runtimeconfig.config import Config
+
+
+class Client(ClientWithProject):
+    """Client to bundle configuration needed for API requests.
+
+    :type project: str
+    :param project:
+        (Optional) The project which the client acts on behalf of.  If not
+        passed, falls back to the default inferred from the environment.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions`
+        or :class:`dict`
+    :param client_options: (Optional) Client options used to set user options
+        on the client. API Endpoint should be set through client_options.
+    """
+
+    SCOPE = ("https://www.googleapis.com/auth/cloudruntimeconfig",)
+    """The scopes required for authenticating as a RuntimeConfig consumer."""
+
+    def __init__(
+        self,
+        project=None,
+        credentials=None,
+        _http=None,
+        client_info=None,
+        client_options=None,
+    ):
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+
+        kw_args = {"client_info": client_info}
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+                kw_args["api_endpoint"] = api_endpoint
+
+        self._connection = Connection(self, **kw_args)
+
+    def config(self, config_name):
+        """Factory constructor for config object.
+
+        .. note::
+          This will not make an HTTP request; it simply instantiates
+          a config object owned by this client.
+
+        :type config_name: str
+        :param config_name: The name of the config to be instantiated.
+
+        :rtype: :class:`google.cloud.runtimeconfig.config.Config`
+        :returns: The config object created.
+        """
+        return Config(client=self, name=config_name)
diff --git a/runtimeconfig/google/cloud/runtimeconfig/config.py b/runtimeconfig/google/cloud/runtimeconfig/config.py
new file mode 100644
index 000000000000..3e02b6e6cce3
--- /dev/null
+++ b/runtimeconfig/google/cloud/runtimeconfig/config.py
@@ -0,0 +1,275 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud RuntimeConfig configs."""
+
+from google.api_core import page_iterator
+from google.cloud.exceptions import NotFound
+from google.cloud.runtimeconfig._helpers import config_name_from_full_name
+from google.cloud.runtimeconfig.variable import Variable
+
+
+class Config(object):
+    """A Config resource in the Cloud RuntimeConfig service.
+
+    This consists of metadata and a hierarchy of variables.
+
+    See
+    https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs
+
+    :type client: :class:`google.cloud.runtimeconfig.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the config (which requires a project).
+
+    :type name: str
+    :param name: The name of the config.
+    """
+
+    def __init__(self, client, name):
+        self._client = client
+        self.name = name
+        self._properties = {}
+
+    def __repr__(self):
+        return "<Config: %s>" % (self.name,)
+
+    @property
+    def client(self):
+        """The client bound to this config."""
+        return self._client
+
+    @property
+    def description(self):
+        """Description of the config object.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs#resource-runtimeconfig
+
+        :rtype: str, or ``NoneType``
+        :returns: the description (None until set from the server).
+        """
+        return self._properties.get("description")
+
+    @property
+    def project(self):
+        """Project bound to the config.
+
+        :rtype: str
+        :returns: the project (derived from the client).
+        """
+        return self._client.project
+
+    @property
+    def full_name(self):
+        """Fully-qualified name of this variable.
+
+        Example:
+        ``projects/my-project/configs/my-config``
+
+        :rtype: str
+        :returns: The full name based on project and config names.
+
+        :raises: :class:`ValueError` if the config is missing a name.
+        """
+        if not self.name:
+            raise ValueError("Missing config name.")
+        return "projects/%s/configs/%s" % (self._client.project, self.name)
+
+    @property
+    def path(self):
+        """URL path for the config's APIs.
+
+        :rtype: str
+        :returns: The URL path based on project and config names.
+        """
+        return "/%s" % (self.full_name,)
+
+    def variable(self, variable_name):
+        """Factory constructor for variable object.
+
+        .. note::
+          This will not make an HTTP request; it simply instantiates
+          a variable object owned by this config.
+
+        :type variable_name: str
+        :param variable_name: The name of the variable to be instantiated.
+
+        :rtype: :class:`google.cloud.runtimeconfig.variable.Variable`
+        :returns: The variable object created.
+        """
+        return Variable(name=variable_name, config=self)
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`google.cloud.runtimconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: :class:`google.cloud.runtimeconfig.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self._client
+        return client
+
+    def _set_properties(self, api_response):
+        """Update properties from resource in body of ``api_response``
+
+        :type api_response: dict
+        :param api_response: response returned from an API call
+        """
+        self._properties.clear()
+        cleaned = api_response.copy()
+        if "name" in cleaned:
+            self.name = config_name_from_full_name(cleaned.pop("name"))
+        self._properties.update(cleaned)
+
+    def exists(self, client=None):
+        """Determines whether or not this config exists.
+
+        :type client: :class:`~google.cloud.runtimeconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            ``client`` stored on the current config.
+
+        :rtype: bool
+        :returns: True if the config exists in Cloud Runtime Configurator.
+        """
+        client = self._require_client(client)
+        try:
+            # We only need the status code (200 or not) so we seek to
+            # minimize the returned payload.
+            query_params = {"fields": "name"}
+            client._connection.api_request(
+                method="GET", path=self.path, query_params=query_params
+            )
+            return True
+        except NotFound:
+            return False
+
+    def reload(self, client=None):
+        """API call:  reload the config via a ``GET`` request.
+
+        This method will reload the newest data for the config.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs/get
+
+        :type client: :class:`google.cloud.runtimeconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            client stored on the current config.
+        """
+        client = self._require_client(client)
+
+        # We assume the config exists. If it doesn't it will raise a NotFound
+        # exception.
+        resp = client._connection.api_request(method="GET", path=self.path)
+        self._set_properties(api_response=resp)
+
+    def get_variable(self, variable_name, client=None):
+        """API call:  get a variable via a ``GET`` request.
+
+        This will return None if the variable doesn't exist::
+
+          >>> from google.cloud import runtimeconfig
+          >>> client = runtimeconfig.Client()
+          >>> config = client.config('my-config')
+          >>> print(config.get_variable('variable-name'))
+          <Variable: my-config, variable-name>
+          >>> print(config.get_variable('does-not-exist'))
+          None
+
+        :type variable_name: str
+        :param variable_name: The name of the variable to retrieve.
+
+        :type client: :class:`~google.cloud.runtimeconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            ``client`` stored on the current config.
+
+        :rtype: :class:`google.cloud.runtimeconfig.variable.Variable` or None
+        :returns: The variable object if it exists, otherwise None.
+        """
+        client = self._require_client(client)
+        variable = Variable(config=self, name=variable_name)
+        try:
+            variable.reload(client=client)
+            return variable
+        except NotFound:
+            return None
+
+    def list_variables(self, page_size=None, page_token=None, client=None):
+        """API call:  list variables for this config.
+
+        This only lists variable names, not the values.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/list
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of variables in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of variables, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
+
+        :type client: :class:`~google.cloud.runtimeconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            ``client`` stored on the current config.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns:
+            Iterator of :class:`~google.cloud.runtimeconfig.variable.Variable`
+            belonging to this project.
+        """
+        path = "%s/variables" % (self.path,)
+        client = self._require_client(client)
+        iterator = page_iterator.HTTPIterator(
+            client=client,
+            api_request=client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_variable,
+            items_key="variables",
+            page_token=page_token,
+            max_results=page_size,
+        )
+        iterator._MAX_RESULTS = "pageSize"
+        iterator.config = self
+        return iterator
+
+
+def _item_to_variable(iterator, resource):
+    """Convert a JSON variable to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type resource: dict
+    :param resource: An item to be converted to a variable.
+
+    :rtype: :class:`.Variable`
+    :returns: The next variable in the page.
+    """
+    return Variable.from_api_repr(resource, iterator.config)
diff --git a/runtimeconfig/google/cloud/runtimeconfig/variable.py b/runtimeconfig/google/cloud/runtimeconfig/variable.py
new file mode 100644
index 000000000000..e7974c70418a
--- /dev/null
+++ b/runtimeconfig/google/cloud/runtimeconfig/variable.py
@@ -0,0 +1,251 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud RuntimeConfig variables.
+
+.. data:: STATE_UNSPECIFIED
+
+    The default variable state.  See
+    https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState
+
+.. data:: STATE_UPDATED
+
+    Indicates the variable was updated, while `variables.watch` was executing.
+    See
+    https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState
+
+.. data:: STATE_DELETED
+
+    Indicates the variable was deleted, while `variables.watch`_ was executing.
+    See
+    https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState
+
+.. _variables.watch:
+    https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/watch
+"""
+
+import base64
+import datetime
+
+import pytz
+
+from google.api_core import datetime_helpers
+from google.cloud.exceptions import NotFound
+from google.cloud.runtimeconfig._helpers import variable_name_from_full_name
+
+
+STATE_UNSPECIFIED = "VARIABLE_STATE_UNSPECIFIED"
+STATE_UPDATED = "UPDATED"
+STATE_DELETED = "DELETED"
+
+
+class Variable(object):
+    """A variable in the Cloud RuntimeConfig service.
+
+    See
+    https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables
+
+    :type name: str
+    :param name: The name of the variable.  This corresponds to the
+                 unique path of the variable in the config.
+
+    :type config: :class:`google.cloud.runtimeconfig.config.Config`
+    :param config: The config to which this variable belongs.
+    """
+
+    def __init__(self, name, config):
+        self.name = name
+        self.config = config
+        self._properties = {}
+
+    @classmethod
+    def from_api_repr(cls, resource, config):
+        """Factory:  construct a Variable given its API representation
+
+        :type resource: dict
+        :param resource: change set representation returned from the API.
+
+        :type config: :class:`google.cloud.runtimeconfig.config.Config`
+        :param config: The config to which this variable belongs.
+
+        :rtype: :class:`google.cloud.runtimeconfig.variable.Variable`
+        :returns: Variable parsed from ``resource``.
+        """
+        name = variable_name_from_full_name(resource.get("name"))
+        variable = cls(name=name, config=config)
+        variable._set_properties(resource=resource)
+        return variable
+
+    @property
+    def full_name(self):
+        """Fully-qualified name of this variable.
+
+        Example:
+        ``projects/my-project/configs/my-config/variables/my-var``
+
+        :rtype: str
+        :returns: The full name based on config and variable names.
+
+        :raises: :class:`ValueError` if the variable is missing a name.
+        """
+        if not self.name:
+            raise ValueError("Missing variable name.")
+        return "%s/variables/%s" % (self.config.full_name, self.name)
+
+    @property
+    def path(self):
+        """URL path for the variable's APIs.
+
+        :rtype: str
+        :returns: The URL path based on config and variable names.
+        """
+        return "/%s" % (self.full_name,)
+
+    @property
+    def client(self):
+        """The client bound to this variable."""
+        return self.config.client
+
+    @property
+    def value(self):
+        """Value of the variable, as bytes.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables
+
+        :rtype: bytes or ``NoneType``
+        :returns: The value of the variable or ``None`` if the property
+                  is not set locally.
+        """
+        value = self._properties.get("value")
+        if value is not None:
+            value = base64.b64decode(value)
+        return value
+
+    @property
+    def state(self):
+        """Retrieve the state of the variable.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables#VariableState
+
+        :rtype: str
+        :returns:
+            If set, one of "UPDATED", "DELETED", or defaults to
+            "VARIABLE_STATE_UNSPECIFIED".
+        """
+        return self._properties.get("state", STATE_UNSPECIFIED)
+
+    @property
+    def update_time(self):
+        """Retrieve the timestamp at which the variable was updated.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables
+
+        Returns:
+            :class:`~api_core.datetime_helpers.DatetimeWithNanoseconds`,
+            :class:`datetime.datetime` or ``NoneType``:
+            Datetime object parsed from RFC3339 valid timestamp, or
+            ``None`` if the property is not set locally.
+
+        Raises:
+            ValueError: if value is not a valid RFC3339 timestamp
+        """
+        value = self._properties.get("updateTime")
+        if value is not None:
+            try:
+                value = datetime.datetime.strptime(
+                    value, datetime_helpers._RFC3339_MICROS
+                )
+            except ValueError:
+                DatetimeNS = datetime_helpers.DatetimeWithNanoseconds
+                value = DatetimeNS.from_rfc3339(value)
+            naive = value.tzinfo is None or value.tzinfo.utcoffset(value) is None
+            if naive:
+                value = pytz.utc.localize(value)
+        return value
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`google.cloud.runtimconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            ``client`` stored on the current zone.
+
+        :rtype: :class:`google.cloud.runtimeconfig.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self.client
+        return client
+
+    def _set_properties(self, resource):
+        """Update properties from resource in body of ``api_response``
+
+        :type resource: dict
+        :param resource: variable representation returned from the API.
+        """
+        self._properties.clear()
+        cleaned = resource.copy()
+        if "name" in cleaned:
+            self.name = variable_name_from_full_name(cleaned.pop("name"))
+        self._properties.update(cleaned)
+
+    def exists(self, client=None):
+        """API call:  test for the existence of the variable via a GET request
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs.variables/get
+
+        :type client: :class:`~google.cloud.runtimeconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            ``client`` stored on the variable's config.
+
+        :rtype: bool
+        :returns: True if the variable exists in Cloud RuntimeConfig.
+        """
+        client = self._require_client(client)
+        try:
+            # We only need the status code (200 or not) so we seek to
+            # minimize the returned payload.
+            query_params = {"fields": "name"}
+            client._connection.api_request(
+                method="GET", path=self.path, query_params=query_params
+            )
+            return True
+        except NotFound:
+            return False
+
+    def reload(self, client=None):
+        """API call:  reload the variable via a ``GET`` request.
+
+        This method will reload the newest data for the variable.
+
+        See
+        https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/v1beta1/projects.configs/get
+
+        :type client: :class:`google.cloud.runtimeconfig.client.Client`
+        :param client:
+            (Optional) The client to use.  If not passed, falls back to the
+            client stored on the current config.
+        """
+        client = self._require_client(client)
+
+        # We assume the variable exists. If it doesn't it will raise a NotFound
+        # exception.
+        resp = client._connection.api_request(method="GET", path=self.path)
+        self._set_properties(resource=resp)
diff --git a/runtimeconfig/noxfile.py b/runtimeconfig/noxfile.py
new file mode 100644
index 000000000000..4b6e3e058261
--- /dev/null
+++ b/runtimeconfig/noxfile.py
@@ -0,0 +1,127 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (
+    os.path.join('..', 'api_core'),
+    os.path.join('..', 'core'),
+)
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+    Format code to uniform standard.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python='3.6')
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install('docutils', 'Pygments')
+    session.run(
+        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+
+
+def default(session):
+    """Default unit test session.
+    """
+    # Install all test dependencies, then install local packages in-place.
+    session.install('mock', 'pytest', 'pytest-cov')
+    for local_dep in LOCAL_DEPS:
+        session.install('-e', local_dep)
+    session.install('-e', '.')
+
+    # Run py.test against the unit tests.
+    session.run(
+        'py.test',
+        '--quiet',
+        '--cov=google.cloud.runtimeconfig',
+        '--cov=tests.unit',
+        '--cov-append',
+        '--cov-config=.coveragerc',
+        '--cov-report=',
+        '--cov-fail-under=97',
+        'tests/unit',
+    )
+
+
+@nox.session(python=['2.7', '3.5', '3.6', '3.7'])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python='3.6')
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install('coverage', 'pytest-cov')
+    session.run('coverage', 'report', '--show-missing', '--fail-under=100')
+    session.run('coverage', 'erase')
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
\ No newline at end of file
diff --git a/runtimeconfig/pylint.config.py b/runtimeconfig/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/runtimeconfig/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/runtimeconfig/setup.cfg b/runtimeconfig/setup.cfg
new file mode 100644
index 000000000000..2a9acf13daa9
--- /dev/null
+++ b/runtimeconfig/setup.cfg
@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1
diff --git a/runtimeconfig/setup.py b/runtimeconfig/setup.py
new file mode 100644
index 000000000000..34b92d567f2e
--- /dev/null
+++ b/runtimeconfig/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-runtimeconfig'
+description = 'Google Cloud RuntimeConfig API client library'
+version = '0.29.2'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/runtimeconfig/tests/unit/__init__.py b/runtimeconfig/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/runtimeconfig/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/runtimeconfig/tests/unit/test__helpers.py b/runtimeconfig/tests/unit/test__helpers.py
new file mode 100644
index 000000000000..3d30762561b3
--- /dev/null
+++ b/runtimeconfig/tests/unit/test__helpers.py
@@ -0,0 +1,77 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class Test_config_name_from_full_name(unittest.TestCase):
+    def _call_fut(self, full_name):
+        from google.cloud.runtimeconfig._helpers import config_name_from_full_name
+
+        return config_name_from_full_name(full_name)
+
+    def test_w_simple_name(self):
+        CONFIG_NAME = "CONFIG_NAME"
+        PROJECT = "my-project-1234"
+        PATH = "projects/%s/configs/%s" % (PROJECT, CONFIG_NAME)
+        config_name = self._call_fut(PATH)
+        self.assertEqual(config_name, CONFIG_NAME)
+
+    def test_w_name_w_all_extras(self):
+        CONFIG_NAME = "CONFIG_NAME-part.one~part.two%part-three"
+        PROJECT = "my-project-1234"
+        PATH = "projects/%s/configs/%s" % (PROJECT, CONFIG_NAME)
+        config_name = self._call_fut(PATH)
+        self.assertEqual(config_name, CONFIG_NAME)
+
+    def test_w_bad_format(self):
+        PATH = "definitley/not/a/resource-name"
+        with self.assertRaises(ValueError):
+            self._call_fut(PATH)
+
+
+class Test_variable_name_from_full_name(unittest.TestCase):
+    def _call_fut(self, full_name):
+        from google.cloud.runtimeconfig._helpers import variable_name_from_full_name
+
+        return variable_name_from_full_name(full_name)
+
+    def test_w_simple_name(self):
+        VARIABLE_NAME = "VARIABLE_NAME"
+        CONFIG_NAME = "CONFIG_NAME"
+        PROJECT = "my-project-1234"
+        PATH = "projects/%s/configs/%s/variables/%s" % (
+            PROJECT,
+            CONFIG_NAME,
+            VARIABLE_NAME,
+        )
+        variable_name = self._call_fut(PATH)
+        self.assertEqual(variable_name, VARIABLE_NAME)
+
+    def test_w_name_w_all_extras(self):
+        VARIABLE_NAME = "VARIABLE_NAME-part.one/part.two/part-three"
+        CONFIG_NAME = "CONFIG_NAME"
+        PROJECT = "my-project-1234"
+        PATH = "projects/%s/configs/%s/variables/%s" % (
+            PROJECT,
+            CONFIG_NAME,
+            VARIABLE_NAME,
+        )
+        variable_name = self._call_fut(PATH)
+        self.assertEqual(variable_name, VARIABLE_NAME)
+
+    def test_w_bad_format(self):
+        PATH = "definitley/not/a/resource/name/for/a/variable"
+        with self.assertRaises(ValueError):
+            self._call_fut(PATH)
diff --git a/runtimeconfig/tests/unit/test__http.py b/runtimeconfig/tests/unit/test__http.py
new file mode 100644
index 000000000000..041afd32a15e
--- /dev/null
+++ b/runtimeconfig/tests/unit/test__http.py
@@ -0,0 +1,66 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.runtimeconfig._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_default_url(self):
+        client = object()
+        conn = self._make_one(client)
+        self.assertIs(conn._client, client)
+
+    def test_build_api_url_w_custom_endpoint(self):
+        custom_endpoint = "https://foo-runtimeconfig.googleapis.com"
+        conn = self._make_one(object(), api_endpoint=custom_endpoint)
+        URI = "/".join([custom_endpoint, conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_extra_headers(self):
+        import requests
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
diff --git a/runtimeconfig/tests/unit/test_client.py b/runtimeconfig/tests/unit/test_client.py
new file mode 100644
index 000000000000..858866efc5f3
--- /dev/null
+++ b/runtimeconfig/tests/unit/test_client.py
@@ -0,0 +1,110 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.runtimeconfig.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_wo_client_info(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.runtimeconfig._http import Connection
+
+        PROJECT = "PROJECT"
+        http = object()
+        creds = _make_credentials()
+
+        client = self._make_one(project=PROJECT, credentials=creds, _http=http)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._credentials, creds)
+        self.assertIs(client._http_internal, http)
+        self.assertIsInstance(client._connection._client_info, ClientInfo)
+
+    def test_ctor_w_client_info(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.runtimeconfig._http import Connection
+
+        PROJECT = "PROJECT"
+        http = object()
+        creds = _make_credentials()
+        client_info = ClientInfo()
+
+        client = self._make_one(
+            project=PROJECT, credentials=creds, _http=http, client_info=client_info
+        )
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._credentials, creds)
+        self.assertIs(client._http_internal, http)
+        self.assertIs(client._connection._client_info, client_info)
+
+    def test_ctor_w_empty_client_options(self):
+        from google.api_core.client_options import ClientOptions
+
+        http = object()
+        client_options = ClientOptions()
+        client = self._make_one(_http=http, client_options=client_options)
+        self.assertEqual(
+            client._connection.API_BASE_URL, client._connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_constructor_w_client_options_object(self):
+        from google.api_core.client_options import ClientOptions
+
+        http = object()
+        client_options = ClientOptions(
+            api_endpoint="https://foo-runtimeconfig.googleapis.com"
+        )
+        client = self._make_one(_http=http, client_options=client_options)
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://foo-runtimeconfig.googleapis.com"
+        )
+
+    def test_constructor_w_client_options_dict(self):
+        http = object()
+        client_options = {"api_endpoint": "https://foo-runtimeconfig.googleapis.com"}
+        client = self._make_one(_http=http, client_options=client_options)
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://foo-runtimeconfig.googleapis.com"
+        )
+
+    def test_config(self):
+        PROJECT = "PROJECT"
+        CONFIG_NAME = "config_name"
+        creds = _make_credentials()
+
+        client = self._make_one(project=PROJECT, credentials=creds)
+        new_config = client.config(CONFIG_NAME)
+        self.assertEqual(new_config.name, CONFIG_NAME)
+        self.assertIs(new_config._client, client)
+        self.assertEqual(new_config.project, PROJECT)
+        self.assertEqual(
+            new_config.full_name, "projects/%s/configs/%s" % (PROJECT, CONFIG_NAME)
+        )
+        self.assertFalse(new_config.description)
diff --git a/runtimeconfig/tests/unit/test_config.py b/runtimeconfig/tests/unit/test_config.py
new file mode 100644
index 000000000000..104ee04f184c
--- /dev/null
+++ b/runtimeconfig/tests/unit/test_config.py
@@ -0,0 +1,352 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestConfig(unittest.TestCase):
+    PROJECT = "PROJECT"
+    CONFIG_NAME = "config_name"
+    CONFIG_PATH = "projects/%s/configs/%s" % (PROJECT, CONFIG_NAME)
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.runtimeconfig.config import Config
+
+        return Config
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _verifyResourceProperties(self, config, resource):
+        from google.cloud.runtimeconfig._helpers import config_name_from_full_name
+
+        if "name" in resource:
+            self.assertEqual(config.full_name, resource["name"])
+            self.assertEqual(config.name, config_name_from_full_name(resource["name"]))
+        if "description" in resource:
+            self.assertEqual(config.description, resource["description"])
+
+    def test_ctor(self):
+        client = _Client(project=self.PROJECT)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+        self.assertEqual(config.name, self.CONFIG_NAME)
+        self.assertEqual(config.project, self.PROJECT)
+        self.assertEqual(config.full_name, self.CONFIG_PATH)
+
+    def test_ctor_w_no_name(self):
+        client = _Client(project=self.PROJECT)
+        config = self._make_one(name=None, client=client)
+        with self.assertRaises(ValueError):
+            getattr(config, "full_name")
+
+    def test_exists_miss_w_bound_client(self):
+        conn = _Connection()
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(client=client, name=self.CONFIG_NAME)
+
+        self.assertFalse(config.exists())
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.CONFIG_PATH,))
+        self.assertEqual(req["query_params"], {"fields": "name"})
+
+    def test_exists_hit_w_alternate_client(self):
+        conn1 = _Connection()
+        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection({})
+        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
+        config = self._make_one(client=CLIENT1, name=self.CONFIG_NAME)
+
+        self.assertTrue(config.exists(client=CLIENT2))
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.CONFIG_PATH,))
+        self.assertEqual(req["query_params"], {"fields": "name"})
+
+    def test_reload_w_empty_resource(self):
+        RESOURCE = {}
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        config.reload()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        # Name should not be overwritten if not in the response.
+        self.assertEqual(self.CONFIG_NAME, config.name)
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.CONFIG_PATH,))
+        self._verifyResourceProperties(config, RESOURCE)
+
+    def test_reload_w_bound_client(self):
+        RESOURCE = {"name": self.CONFIG_PATH, "description": "hello"}
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        config.reload()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.CONFIG_PATH,))
+        self._verifyResourceProperties(config, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        RESOURCE = {"name": self.CONFIG_PATH, "description": "hello"}
+        conn1 = _Connection()
+        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(RESOURCE)
+        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
+        config = self._make_one(name=self.CONFIG_NAME, client=CLIENT1)
+
+        config.reload(client=CLIENT2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.CONFIG_PATH,))
+        self._verifyResourceProperties(config, RESOURCE)
+
+    def test_variable(self):
+        VARIABLE_NAME = "my-variable/abcd"
+        VARIABLE_PATH = "%s/variables/%s" % (self.CONFIG_PATH, VARIABLE_NAME)
+        conn = _Connection()
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        variable = config.variable(VARIABLE_NAME)
+
+        self.assertEqual(variable.name, VARIABLE_NAME)
+        self.assertEqual(variable.full_name, VARIABLE_PATH)
+        self.assertEqual(len(conn._requested), 0)
+
+    def test_get_variable_w_bound_client(self):
+        from google.api_core import datetime_helpers
+
+        VARIABLE_NAME = "my-variable/abcd"
+        VARIABLE_PATH = "%s/variables/%s" % (self.CONFIG_PATH, VARIABLE_NAME)
+        RESOURCE = {
+            "name": VARIABLE_PATH,
+            "value": "bXktdmFyaWFibGUtdmFsdWU=",  # base64 my-variable-value
+            "updateTime": "2016-04-14T21:21:54.123456789Z",
+            "state": "VARIABLE_STATE_UNSPECIFIED",
+        }
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        variable = config.get_variable(VARIABLE_NAME)
+
+        self.assertEqual(variable.name, VARIABLE_NAME)
+        self.assertEqual(variable.full_name, VARIABLE_PATH)
+        DatetimeWithNanoseconds = datetime_helpers.DatetimeWithNanoseconds
+        self.assertEqual(
+            variable.update_time,
+            DatetimeWithNanoseconds.from_rfc3339(RESOURCE["updateTime"]),
+        )
+        self.assertEqual(variable.state, RESOURCE["state"])
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (VARIABLE_PATH,))
+
+    def test_get_variable_w_notfound(self):
+        VARIABLE_NAME = "my-variable/abcd"
+        conn = _Connection()
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+        variable = config.get_variable(VARIABLE_NAME)
+        self.assertIsNone(variable)
+
+    def test_get_variable_w_alternate_client(self):
+        from google.cloud._helpers import _rfc3339_to_datetime
+
+        VARIABLE_NAME = "my-variable/abcd"
+        VARIABLE_PATH = "%s/variables/%s" % (self.CONFIG_PATH, VARIABLE_NAME)
+        RESOURCE = {
+            "name": VARIABLE_PATH,
+            "value": "bXktdmFyaWFibGUtdmFsdWU=",  # base64 my-variable-value
+            "updateTime": "2016-04-14T21:21:54.5000Z",
+            "state": "VARIABLE_STATE_UNSPECIFIED",
+        }
+        conn1 = _Connection()
+        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
+        conn2 = _Connection(RESOURCE)
+        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
+        config = self._make_one(client=CLIENT1, name=self.CONFIG_NAME)
+
+        variable = config.get_variable(VARIABLE_NAME, client=CLIENT2)
+
+        self.assertEqual(variable.name, VARIABLE_NAME)
+        self.assertEqual(variable.full_name, VARIABLE_PATH)
+        self.assertEqual(
+            variable.update_time, _rfc3339_to_datetime(RESOURCE["updateTime"])
+        )
+        self.assertEqual(variable.state, RESOURCE["state"])
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (VARIABLE_PATH,))
+
+    def test_list_variables_empty(self):
+        import six
+
+        conn = _Connection({})
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        iterator = config.list_variables()
+        page = six.next(iterator.pages)
+        variables = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(variables, [])
+        self.assertIsNone(token)
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        PATH = "projects/%s/configs/%s/variables" % (self.PROJECT, self.CONFIG_NAME)
+        self.assertEqual(req["path"], "/%s" % (PATH,))
+
+    def test_list_variables_defaults(self):
+        import six
+        from google.cloud._helpers import _rfc3339_to_datetime
+        from google.cloud.runtimeconfig.variable import Variable
+
+        VARIABLE_1 = "variable-one"
+        VARIABLE_2 = "variable/two"
+        PATH = "projects/%s/configs/%s/variables" % (self.PROJECT, self.CONFIG_NAME)
+        TOKEN = "TOKEN"
+        DATA = {
+            "nextPageToken": TOKEN,
+            "variables": [
+                {
+                    "name": "%s/%s" % (PATH, VARIABLE_1),
+                    "updateTime": "2016-04-14T21:21:54.5000Z",
+                },
+                {
+                    "name": "%s/%s" % (PATH, VARIABLE_2),
+                    "updateTime": "2016-04-21T21:21:54.6000Z",
+                },
+            ],
+        }
+
+        conn = _Connection(DATA)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        iterator = config.list_variables()
+        page = six.next(iterator.pages)
+        variables = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(variables), len(DATA["variables"]))
+        for found, expected in zip(variables, DATA["variables"]):
+            self.assertIsInstance(found, Variable)
+            self.assertEqual(found.full_name, expected["name"])
+            self.assertEqual(
+                found.update_time, _rfc3339_to_datetime(expected["updateTime"])
+            )
+        self.assertEqual(token, TOKEN)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (PATH,))
+        self.assertNotIn("filter", req["query_params"])
+
+    def test_list_variables_explicit(self):
+        import six
+        from google.cloud._helpers import _rfc3339_to_datetime
+        from google.cloud.runtimeconfig.variable import Variable
+
+        VARIABLE_1 = "variable-one"
+        VARIABLE_2 = "variable/two"
+        PATH = "projects/%s/configs/%s/variables" % (self.PROJECT, self.CONFIG_NAME)
+        TOKEN = "TOKEN"
+        DATA = {
+            "variables": [
+                {
+                    "name": "%s/%s" % (PATH, VARIABLE_1),
+                    "updateTime": "2016-04-14T21:21:54.5000Z",
+                },
+                {
+                    "name": "%s/%s" % (PATH, VARIABLE_2),
+                    "updateTime": "2016-04-21T21:21:54.6000Z",
+                },
+            ]
+        }
+
+        conn = _Connection(DATA)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = self._make_one(name=self.CONFIG_NAME, client=client)
+
+        iterator = config.list_variables(page_size=3, page_token=TOKEN, client=client)
+        page = six.next(iterator.pages)
+        variables = list(page)
+        token = iterator.next_page_token
+
+        self.assertEqual(len(variables), len(DATA["variables"]))
+        for found, expected in zip(variables, DATA["variables"]):
+            self.assertIsInstance(found, Variable)
+            self.assertEqual(found.full_name, expected["name"])
+            self.assertEqual(
+                found.update_time, _rfc3339_to_datetime(expected["updateTime"])
+            )
+        self.assertIsNone(token)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (PATH,))
+        self.assertEqual(req["query_params"], {"pageSize": 3, "pageToken": TOKEN})
+
+
+class _Client(object):
+
+    _connection = None
+
+    def __init__(self, project, connection=None):
+        self.project = project
+        self._connection = connection
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        self._requested.append(kw)
+
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        else:
+            return response
diff --git a/runtimeconfig/tests/unit/test_variable.py b/runtimeconfig/tests/unit/test_variable.py
new file mode 100644
index 000000000000..3044a23d05aa
--- /dev/null
+++ b/runtimeconfig/tests/unit/test_variable.py
@@ -0,0 +1,229 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestVariable(unittest.TestCase):
+    PROJECT = "PROJECT"
+    CONFIG_NAME = "config_name"
+    VARIABLE_NAME = "variable_name"
+    PATH = "projects/%s/configs/%s/variables/%s" % (PROJECT, CONFIG_NAME, VARIABLE_NAME)
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.runtimeconfig.variable import Variable
+
+        return Variable
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _verifyResourceProperties(self, variable, resource):
+        import base64
+        from google.api_core import datetime_helpers
+
+        if "name" in resource:
+            self.assertEqual(variable.full_name, resource["name"])
+
+        if "value" in resource:
+            self.assertEqual(variable.value, base64.b64decode(resource["value"]))
+        else:
+            self.assertIsNone(variable.value)
+
+        if "state" in resource:
+            self.assertEqual(variable.state, resource["state"])
+
+        if "updateTime" in resource:
+            self.assertEqual(
+                variable.update_time,
+                datetime_helpers.DatetimeWithNanoseconds.from_rfc3339(
+                    resource["updateTime"]
+                ),
+            )
+        else:
+            self.assertIsNone(variable.update_time)
+
+    def test_ctor(self):
+        from google.cloud.runtimeconfig.config import Config
+        from google.cloud.runtimeconfig.variable import STATE_UNSPECIFIED
+
+        client = _Client(project=self.PROJECT)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=config)
+        self.assertEqual(variable.name, self.VARIABLE_NAME)
+        self.assertEqual(variable.full_name, self.PATH)
+        self.assertEqual(variable.path, "/%s" % (self.PATH,))
+        self.assertEqual(variable.state, STATE_UNSPECIFIED)
+        self.assertIs(variable.client, client)
+
+    def test_ctor_w_no_name(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        client = _Client(project=self.PROJECT)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=None, config=config)
+        with self.assertRaises(ValueError):
+            getattr(variable, "full_name")
+
+    def test_exists_miss_w_bound_client(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        conn = _Connection()
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=config)
+
+        self.assertFalse(variable.exists())
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.PATH,))
+        self.assertEqual(req["query_params"], {"fields": "name"})
+
+    def test_exists_hit_w_alternate_client(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        conn1 = _Connection()
+        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
+        CONFIG1 = Config(name=self.CONFIG_NAME, client=CLIENT1)
+        conn2 = _Connection({})
+        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=CONFIG1)
+
+        self.assertTrue(variable.exists(client=CLIENT2))
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.PATH,))
+        self.assertEqual(req["query_params"], {"fields": "name"})
+
+    def test_reload_w_bound_client(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        RESOURCE = {
+            "name": self.PATH,
+            "value": "bXktdmFyaWFibGUtdmFsdWU=",  # base64 my-variable-value
+            "updateTime": "2016-04-14T21:21:54.5000Z",
+            "state": "VARIABLE_STATE_UNSPECIFIED",
+        }
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=config)
+
+        variable.reload()
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.PATH,))
+        self._verifyResourceProperties(variable, RESOURCE)
+
+    def test_reload_w_empty_resource(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        RESOURCE = {}
+        conn = _Connection(RESOURCE)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=config)
+
+        variable.reload()
+
+        # Name should not be overwritten.
+        self.assertEqual(self.VARIABLE_NAME, variable.name)
+
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.PATH,))
+        self._verifyResourceProperties(variable, RESOURCE)
+
+    def test_reload_w_alternate_client(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        RESOURCE = {
+            "name": self.PATH,
+            "value": "bXktdmFyaWFibGUtdmFsdWU=",  # base64 my-variable-value
+            "updateTime": "2016-04-14T21:21:54.5000Z",
+            "state": "VARIABLE_STATE_UNSPECIFIED",
+        }
+        conn1 = _Connection()
+        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
+        CONFIG1 = Config(name=self.CONFIG_NAME, client=CLIENT1)
+        conn2 = _Connection(RESOURCE)
+        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=CONFIG1)
+
+        variable.reload(client=CLIENT2)
+
+        self.assertEqual(len(conn1._requested), 0)
+        self.assertEqual(len(conn2._requested), 1)
+        req = conn2._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/%s" % (self.PATH,))
+        self._verifyResourceProperties(variable, RESOURCE)
+
+    def test_with_microseconds(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        resource = {"updateTime": "2016-04-14T21:21:54.123456Z"}
+        conn = _Connection(resource)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=config)
+        variable.reload(client=client)
+        self._verifyResourceProperties(variable, resource)
+
+    def test_with_nanoseconds(self):
+        from google.cloud.runtimeconfig.config import Config
+
+        resource = {"updateTime": "2016-04-14T21:21:54.123456789Z"}
+        conn = _Connection(resource)
+        client = _Client(project=self.PROJECT, connection=conn)
+        config = Config(name=self.CONFIG_NAME, client=client)
+        variable = self._make_one(name=self.VARIABLE_NAME, config=config)
+        variable.reload(client=client)
+        self._verifyResourceProperties(variable, resource)
+
+
+class _Client(object):
+
+    _connection = None
+
+    def __init__(self, project, connection=None):
+        self.project = project
+        self._connection = connection
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        self._requested.append(kw)
+
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        else:
+            return response
diff --git a/scheduler/.coveragerc b/scheduler/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/scheduler/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/scheduler/.flake8 b/scheduler/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/scheduler/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/scheduler/.repo-metadata.json b/scheduler/.repo-metadata.json
new file mode 100644
index 000000000000..d6b2d5ea1ce7
--- /dev/null
+++ b/scheduler/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudscheduler",
+  "name_pretty": "Google Cloud Scheduler",
+  "product_documentation": "https://cloud.google.com/scheduler/docs",
+  "client_documentation": "https://googleapis.dev/python/cloudscheduler/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5411429",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-scheduler",
+  "api_id": "cloudscheduler.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/scheduler/CHANGELOG.md b/scheduler/CHANGELOG.md
new file mode 100644
index 000000000000..45610feca865
--- /dev/null
+++ b/scheduler/CHANGELOG.md
@@ -0,0 +1,116 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-scheduler/#history
+
+## 1.2.1
+
+08-12-2019 13:53 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8966](https://github.com/googleapis/google-cloud-python/pull/8966))
+
+### Documentation
+- Fix links to googleapis.dev ([#8998](https://github.com/googleapis/google-cloud-python/pull/8998))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 1.2.0
+
+07-24-2019 17:27 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth).  ([#8401](https://github.com/googleapis/google-cloud-python/pull/8401))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8520](https://github.com/googleapis/google-cloud-python/pull/8520))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Pin black version (via synth). ([#8593](https://github.com/googleapis/google-cloud-python/pull/8593))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8361](https://github.com/googleapis/google-cloud-python/pull/8361))
+- Add disclaimer to auto-generated template (via synth). ([#8325](https://github.com/googleapis/google-cloud-python/pull/8325))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8250](https://github.com/googleapis/google-cloud-python/pull/8250))
+- Fix coverage in 'types.py' (via synth). ([#8162](https://github.com/googleapis/google-cloud-python/pull/8162))
+- Blacken noxfile.py, setup.py (via synth). ([#8130](https://github.com/googleapis/google-cloud-python/pull/8130))
+- Add empty lines (via synth). ([#8069](https://github.com/googleapis/google-cloud-python/pull/8069))
+
+## 1.1.0
+
+05-13-2019 13:15 PDT
+
+### New Features
+- Add authorization headers and deadline for job attempts (via synth). ([#7938](https://github.com/googleapis/google-cloud-python/pull/7938))
+
+### Internal / Testing Changes
+- Add nox session `docs`, reorder methods (via synth). ([#7779](https://github.com/googleapis/google-cloud-python/pull/7779))
+
+## 1.0.0
+
+05-03-2019 10:04 PDT
+
+### Internal / Testing Changes
+- Add smoke test for scheduler. ([#7854](https://github.com/googleapis/google-cloud-python/pull/7854))
+
+## 0.3.0
+
+04-15-2019 10:32 PDT
+
+
+### New Features
+- add auth and configurable timeouts to v1beta1 (via synth). ([#7665](https://github.com/googleapis/google-cloud-python/pull/7665))
+
+## 0.2.0
+
+04-01-2019 15:39 PDT
+
+
+### Implementation Changes
+- Add routing header to method metadata (via synth). ([#7599](https://github.com/googleapis/google-cloud-python/pull/7599))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Remove unused message exports. ([#7273](https://github.com/googleapis/google-cloud-python/pull/7273))
+- Protoc-generated serialization update. ([#7093](https://github.com/googleapis/google-cloud-python/pull/7093))
+- Protoc-generated serialization update. ([#7055](https://github.com/googleapis/google-cloud-python/pull/7055))
+- Use moved iam.policy now at google.api_core.iam.policy. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+
+### New Features
+- Add v1. ([#7608](https://github.com/googleapis/google-cloud-python/pull/7608))
+- Pick up fixes to GAPIC generator. ([#6505](https://github.com/googleapis/google-cloud-python/pull/6505))
+
+### Documentation
+- googlecloudplatform --> googleapis in READMEs. ([#7411](https://github.com/googleapis/google-cloud-python/pull/7411))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright year. ([#7155](https://github.com/googleapis/google-cloud-python/pull/7155))
+- Correct a link in a documentation string. ([#7119](https://github.com/googleapis/google-cloud-python/pull/7119))
+- Pick up stub docstring fix in GAPIC generator. ([#6980](https://github.com/googleapis/google-cloud-python/pull/6980))
+- Document Python 2 deprecation. ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Update link for Scheduler Docs. ([#6925](https://github.com/googleapis/google-cloud-python/pull/6925))
+
+### Internal / Testing Changes
+- Copy lintified proto files (via synth). ([#7469](https://github.com/googleapis/google-cloud-python/pull/7469))
+- Add clarifying comment to blacken nox target. ([#7401](https://github.com/googleapis/google-cloud-python/pull/7401))
+- Add protos as an artifact to library. ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Add baseline for synth.metadata. ([#6792](https://github.com/googleapis/google-cloud-python/pull/6865))
+- Update noxfile. ([#6814](https://github.com/googleapis/google-cloud-python/pull/6814))
+- Blacken all gen'd libs. ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps. ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py. ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries. ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+
+## 0.1.0
+
+11-13-2018 11:03 PST
+
+
+### New Features
+- Initial release of Cloud Scheduler library. ([#6482](https://github.com/googleapis/google-cloud-python/pull/6482))
+
diff --git a/scheduler/LICENSE b/scheduler/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/scheduler/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/scheduler/MANIFEST.in b/scheduler/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/scheduler/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/scheduler/README.rst b/scheduler/README.rst
new file mode 100644
index 000000000000..e9b2b2527c99
--- /dev/null
+++ b/scheduler/README.rst
@@ -0,0 +1,91 @@
+Python Client for Cloud Scheduler API
+================================================
+
+|GA| |pypi| |versions| 
+
+`Cloud Scheduler API`_: Creates and manages jobs run on a regular recurring schedule.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-scheduler.svg
+   :target: https://pypi.org/project/google-cloud-scheduler/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-scheduler.svg
+   :target: https://pypi.org/project/google-cloud-scheduler/
+.. _Cloud Scheduler API: https://cloud.google.com/scheduler
+.. _Client Library Documentation: https://googleapis.dev/python/cloudscheduler/latest
+.. _Product Documentation:  https://cloud.google.com/scheduler
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Scheduler API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Scheduler API.:  https://cloud.google.com/scheduler
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-scheduler
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-scheduler
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Scheduler API
+   API to see other available methods on the client.
+-  Read the `Cloud Scheduler API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Cloud Scheduler API Product documentation:  https://cloud.google.com/scheduler
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/scheduler/docs/README.rst b/scheduler/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/scheduler/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/scheduler/docs/changelog.md b/scheduler/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/scheduler/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/scheduler/docs/conf.py b/scheduler/docs/conf.py
new file mode 100644
index 000000000000..eb6601eacaeb
--- /dev/null
+++ b/scheduler/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-scheduler documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-scheduler"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-scheduler-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-scheduler.tex",
+        u"google-cloud-scheduler Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-scheduler",
+        u"google-cloud-scheduler Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-scheduler",
+        u"google-cloud-scheduler Documentation",
+        author,
+        "google-cloud-scheduler",
+        "GAPIC library for the {metadata.shortName} service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/scheduler/docs/gapic/v1/api.rst b/scheduler/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..bbcbba2363e1
--- /dev/null
+++ b/scheduler/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Scheduler API
+==============================
+
+.. automodule:: google.cloud.scheduler_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/scheduler/docs/gapic/v1/types.rst b/scheduler/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..024654cfadfb
--- /dev/null
+++ b/scheduler/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Scheduler API Client
+====================================
+
+.. automodule:: google.cloud.scheduler_v1.types
+    :members:
\ No newline at end of file
diff --git a/scheduler/docs/gapic/v1beta1/api.rst b/scheduler/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..b28e8ef35fd4
--- /dev/null
+++ b/scheduler/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Scheduler API
+==============================
+
+.. automodule:: google.cloud.scheduler_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/scheduler/docs/gapic/v1beta1/types.rst b/scheduler/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..81ca2a36dc3f
--- /dev/null
+++ b/scheduler/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Scheduler API Client
+====================================
+
+.. automodule:: google.cloud.scheduler_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/scheduler/docs/index.rst b/scheduler/docs/index.rst
new file mode 100644
index 000000000000..8b86e0b90ef9
--- /dev/null
+++ b/scheduler/docs/index.rst
@@ -0,0 +1,32 @@
+.. include:: README.rst
+
+This package includes clients for multiple versions of the Cloud Scheduler
+API. By default, you will get ``v1``, the latest stable version.
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1/api
+  gapic/v1/types
+
+
+Previous beta release ``v1beta1`` is provided as well.
+
+An API and type reference is provided for ``v1beta1``:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+    
+
+Changelog
+---------
+
+For a list of all ``google-cloud-scheduler`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
\ No newline at end of file
diff --git a/scheduler/google/__init__.py b/scheduler/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/scheduler/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/scheduler/google/cloud/__init__.py b/scheduler/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/scheduler/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/scheduler/google/cloud/scheduler.py b/scheduler/google/cloud/scheduler.py
new file mode 100644
index 000000000000..808eb145e45e
--- /dev/null
+++ b/scheduler/google/cloud/scheduler.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.scheduler_v1 import CloudSchedulerClient
+from google.cloud.scheduler_v1 import enums
+from google.cloud.scheduler_v1 import types
+
+
+__all__ = ("enums", "types", "CloudSchedulerClient")
diff --git a/scheduler/google/cloud/scheduler_v1/__init__.py b/scheduler/google/cloud/scheduler_v1/__init__.py
new file mode 100644
index 000000000000..2bd302f8517b
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.scheduler_v1 import types
+from google.cloud.scheduler_v1.gapic import cloud_scheduler_client
+from google.cloud.scheduler_v1.gapic import enums
+
+
+class CloudSchedulerClient(cloud_scheduler_client.CloudSchedulerClient):
+    __doc__ = cloud_scheduler_client.CloudSchedulerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudSchedulerClient")
diff --git a/scheduler/google/cloud/scheduler_v1/gapic/__init__.py b/scheduler/google/cloud/scheduler_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/scheduler/google/cloud/scheduler_v1/gapic/cloud_scheduler_client.py b/scheduler/google/cloud/scheduler_v1/gapic/cloud_scheduler_client.py
new file mode 100644
index 000000000000..68a4f3909189
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/gapic/cloud_scheduler_client.py
@@ -0,0 +1,872 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.scheduler.v1 CloudScheduler API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.scheduler_v1.gapic import cloud_scheduler_client_config
+from google.cloud.scheduler_v1.gapic import enums
+from google.cloud.scheduler_v1.gapic.transports import cloud_scheduler_grpc_transport
+from google.cloud.scheduler_v1.proto import cloudscheduler_pb2
+from google.cloud.scheduler_v1.proto import cloudscheduler_pb2_grpc
+from google.cloud.scheduler_v1.proto import job_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-scheduler"
+).version
+
+
+class CloudSchedulerClient(object):
+    """
+    The Cloud Scheduler API allows external entities to reliably
+    schedule asynchronous jobs.
+    """
+
+    SERVICE_ADDRESS = "cloudscheduler.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.scheduler.v1.CloudScheduler"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudSchedulerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def job_path(cls, project, location, job):
+        """Return a fully-qualified job string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/jobs/{job}",
+            project=project,
+            location=location,
+            job=job,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudSchedulerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudSchedulerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_scheduler_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_scheduler_grpc_transport.CloudSchedulerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_scheduler_grpc_transport.CloudSchedulerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_jobs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists jobs.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_jobs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_jobs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+
+                The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.scheduler_v1.types.Job` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_jobs,
+                default_retry=self._method_configs["ListJobs"].retry,
+                default_timeout=self._method_configs["ListJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.ListJobsRequest(parent=parent, page_size=page_size)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a job.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.get_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_job,
+                default_retry=self._method_configs["GetJob"].retry,
+                default_timeout=self._method_configs["GetJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.GetJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_job(
+        self,
+        parent,
+        job,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a job.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.create_job(parent, job)
+
+        Args:
+            parent (str): Required.
+
+                The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``.
+            job (Union[dict, ~google.cloud.scheduler_v1.types.Job]): Required.
+
+                The job to add. The user can optionally specify a name for the job in
+                ``name``. ``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``) in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.scheduler_v1.types.Job`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_job,
+                default_retry=self._method_configs["CreateJob"].retry,
+                default_timeout=self._method_configs["CreateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.CreateJobRequest(parent=parent, job=job)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_job(
+        self,
+        job,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a job.
+
+        If successful, the updated ``Job`` is returned. If the job does not
+        exist, ``NOT_FOUND`` is returned.
+
+        If UpdateJob does not successfully return, it is possible for the job to
+        be in an ``Job.State.UPDATE_FAILED`` state. A job in this state may not
+        be executed. If this happens, retry the UpdateJob request until a
+        successful response is received.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_job(job, update_mask)
+
+        Args:
+            job (Union[dict, ~google.cloud.scheduler_v1.types.Job]): Required.
+
+                The new job properties. ``name`` must be specified.
+
+                Output only fields cannot be modified using UpdateJob. Any value
+                specified for an output only field will be ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.scheduler_v1.types.Job`
+            update_mask (Union[dict, ~google.cloud.scheduler_v1.types.FieldMask]): A  mask used to specify which fields of the job are being updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.scheduler_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_job,
+                default_retry=self._method_configs["UpdateJob"].retry,
+                default_timeout=self._method_configs["UpdateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.UpdateJobRequest(job=job, update_mask=update_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("job.name", job.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a job.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> client.delete_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_job,
+                default_retry=self._method_configs["DeleteJob"].retry,
+                default_timeout=self._method_configs["DeleteJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.DeleteJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pause_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pauses a job.
+
+        If a job is paused then the system will stop executing the job until it
+        is re-enabled via ``ResumeJob``. The state of the job is stored in
+        ``state``; if paused it will be set to ``Job.State.PAUSED``. A job must
+        be in ``Job.State.ENABLED`` to be paused.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.pause_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pause_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "pause_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pause_job,
+                default_retry=self._method_configs["PauseJob"].retry,
+                default_timeout=self._method_configs["PauseJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.PauseJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["pause_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def resume_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Resume a job.
+
+        This method reenables a job after it has been ``Job.State.PAUSED``. The
+        state of a job is stored in ``Job.state``; after calling this method it
+        will be set to ``Job.State.ENABLED``. A job must be in
+        ``Job.State.PAUSED`` to be resumed.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.resume_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "resume_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "resume_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.resume_job,
+                default_retry=self._method_configs["ResumeJob"].retry,
+                default_timeout=self._method_configs["ResumeJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.ResumeJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["resume_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Forces a job to run now.
+
+        When this method is called, Cloud Scheduler will dispatch the job, even
+        if the job is already running.
+
+        Example:
+            >>> from google.cloud import scheduler_v1
+            >>>
+            >>> client = scheduler_v1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.run_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_job,
+                default_retry=self._method_configs["RunJob"].retry,
+                default_timeout=self._method_configs["RunJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.RunJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/scheduler/google/cloud/scheduler_v1/gapic/cloud_scheduler_client_config.py b/scheduler/google/cloud/scheduler_v1/gapic/cloud_scheduler_client_config.py
new file mode 100644
index 000000000000..31ccca1db159
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/gapic/cloud_scheduler_client_config.py
@@ -0,0 +1,63 @@
+config = {
+    "interfaces": {
+        "google.cloud.scheduler.v1.CloudScheduler": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListJobs": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PauseJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ResumeJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunJob": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/scheduler/google/cloud/scheduler_v1/gapic/enums.py b/scheduler/google/cloud/scheduler_v1/gapic/enums.py
new file mode 100644
index 000000000000..a1282aef95c5
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/gapic/enums.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class HttpMethod(enum.IntEnum):
+    """
+    The HTTP method used to execute the job.
+
+    Attributes:
+      HTTP_METHOD_UNSPECIFIED (int): HTTP method unspecified. Defaults to POST.
+      POST (int): HTTP POST
+      GET (int): HTTP GET
+      HEAD (int): HTTP HEAD
+      PUT (int): HTTP PUT
+      DELETE (int): HTTP DELETE
+      PATCH (int): HTTP PATCH
+      OPTIONS (int): HTTP OPTIONS
+    """
+
+    HTTP_METHOD_UNSPECIFIED = 0
+    POST = 1
+    GET = 2
+    HEAD = 3
+    PUT = 4
+    DELETE = 5
+    PATCH = 6
+    OPTIONS = 7
+
+
+class Job(object):
+    class State(enum.IntEnum):
+        """
+        State of the job.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          ENABLED (int): The job is executing normally.
+          PAUSED (int): The job is paused by the user. It will not execute. A user can
+          intentionally pause the job using ``PauseJobRequest``.
+          DISABLED (int): The job is disabled by the system due to error. The user
+          cannot directly set a job to be disabled.
+          UPDATE_FAILED (int): The job state resulting from a failed ``CloudScheduler.UpdateJob``
+          operation. To recover a job from this state, retry
+          ``CloudScheduler.UpdateJob`` until a successful response is received.
+        """
+
+        STATE_UNSPECIFIED = 0
+        ENABLED = 1
+        PAUSED = 2
+        DISABLED = 3
+        UPDATE_FAILED = 4
diff --git a/scheduler/google/cloud/scheduler_v1/gapic/transports/__init__.py b/scheduler/google/cloud/scheduler_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/scheduler/google/cloud/scheduler_v1/gapic/transports/cloud_scheduler_grpc_transport.py b/scheduler/google/cloud/scheduler_v1/gapic/transports/cloud_scheduler_grpc_transport.py
new file mode 100644
index 000000000000..85993be2eb4a
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/gapic/transports/cloud_scheduler_grpc_transport.py
@@ -0,0 +1,236 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.scheduler_v1.proto import cloudscheduler_pb2_grpc
+
+
+class CloudSchedulerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.scheduler.v1 CloudScheduler API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="cloudscheduler.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "cloud_scheduler_stub": cloudscheduler_pb2_grpc.CloudSchedulerStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudscheduler.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_jobs(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.list_jobs`.
+
+        Lists jobs.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].ListJobs
+
+    @property
+    def get_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.get_job`.
+
+        Gets a job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].GetJob
+
+    @property
+    def create_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.create_job`.
+
+        Creates a job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].CreateJob
+
+    @property
+    def update_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.update_job`.
+
+        Updates a job.
+
+        If successful, the updated ``Job`` is returned. If the job does not
+        exist, ``NOT_FOUND`` is returned.
+
+        If UpdateJob does not successfully return, it is possible for the job to
+        be in an ``Job.State.UPDATE_FAILED`` state. A job in this state may not
+        be executed. If this happens, retry the UpdateJob request until a
+        successful response is received.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].UpdateJob
+
+    @property
+    def delete_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.delete_job`.
+
+        Deletes a job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].DeleteJob
+
+    @property
+    def pause_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.pause_job`.
+
+        Pauses a job.
+
+        If a job is paused then the system will stop executing the job until it
+        is re-enabled via ``ResumeJob``. The state of the job is stored in
+        ``state``; if paused it will be set to ``Job.State.PAUSED``. A job must
+        be in ``Job.State.ENABLED`` to be paused.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].PauseJob
+
+    @property
+    def resume_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.resume_job`.
+
+        Resume a job.
+
+        This method reenables a job after it has been ``Job.State.PAUSED``. The
+        state of a job is stored in ``Job.state``; after calling this method it
+        will be set to ``Job.State.ENABLED``. A job must be in
+        ``Job.State.PAUSED`` to be resumed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].ResumeJob
+
+    @property
+    def run_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.run_job`.
+
+        Forces a job to run now.
+
+        When this method is called, Cloud Scheduler will dispatch the job, even
+        if the job is already running.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].RunJob
diff --git a/scheduler/google/cloud/scheduler_v1/proto/__init__.py b/scheduler/google/cloud/scheduler_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler.proto b/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler.proto
new file mode 100644
index 000000000000..a68446235c38
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler.proto
@@ -0,0 +1,237 @@
+// 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.scheduler.v1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+import "google/cloud/scheduler/v1/job.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler";
+option java_multiple_files = true;
+option java_outer_classname = "SchedulerProto";
+option java_package = "com.google.cloud.scheduler.v1";
+option objc_class_prefix = "SCHEDULER";
+
+// The Cloud Scheduler API allows external entities to reliably
+// schedule asynchronous jobs.
+service CloudScheduler {
+  // Lists jobs.
+  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/jobs"
+    };
+  }
+
+  // Gets a job.
+  rpc GetJob(GetJobRequest) returns (Job) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/jobs/*}"
+    };
+  }
+
+  // Creates a job.
+  rpc CreateJob(CreateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/jobs"
+      body: "job"
+    };
+  }
+
+  // Updates a job.
+  //
+  // If successful, the updated [Job][google.cloud.scheduler.v1.Job] is returned. If the job does
+  // not exist, `NOT_FOUND` is returned.
+  //
+  // If UpdateJob does not successfully return, it is possible for the
+  // job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1.Job.State.UPDATE_FAILED] state. A job in this state may
+  // not be executed. If this happens, retry the UpdateJob request
+  // until a successful response is received.
+  rpc UpdateJob(UpdateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      patch: "/v1/{job.name=projects/*/locations/*/jobs/*}"
+      body: "job"
+    };
+  }
+
+  // Deletes a job.
+  rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/jobs/*}"
+    };
+  }
+
+  // Pauses a job.
+  //
+  // If a job is paused then the system will stop executing the job
+  // until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob]. The
+  // state of the job is stored in [state][google.cloud.scheduler.v1.Job.state]; if paused it
+  // will be set to [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]
+  // to be paused.
+  rpc PauseJob(PauseJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/jobs/*}:pause"
+      body: "*"
+    };
+  }
+
+  // Resume a job.
+  //
+  // This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. The
+  // state of a job is stored in [Job.state][google.cloud.scheduler.v1.Job.state]; after calling this method it
+  // will be set to [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]. A job must be in
+  // [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED] to be resumed.
+  rpc ResumeJob(ResumeJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/jobs/*}:resume"
+      body: "*"
+    };
+  }
+
+  // Forces a job to run now.
+  //
+  // When this method is called, Cloud Scheduler will dispatch the job, even
+  // if the job is already running.
+  rpc RunJob(RunJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/jobs/*}:run"
+      body: "*"
+    };
+  }
+}
+
+// Request message for listing jobs using [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs].
+message ListJobsRequest {
+  // Required.
+  //
+  // The location name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID`.
+  string parent = 1;
+
+  // Requested page size.
+  //
+  // The maximum page size is 500. If unspecified, the page size will
+  // be the maximum. Fewer jobs than requested might be returned,
+  // even if more jobs exist; use next_page_token to determine if more
+  // jobs exist.
+  int32 page_size = 5;
+
+  // A token identifying a page of results the server will 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.scheduler.v1.ListJobsResponse.next_page_token] returned from
+  // the previous call to [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs]. It is an error to
+  // switch the value of [filter][google.cloud.scheduler.v1.ListJobsRequest.filter] or
+  // [order_by][google.cloud.scheduler.v1.ListJobsRequest.order_by] while iterating through pages.
+  string page_token = 6;
+}
+
+// Response message for listing jobs using [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs].
+message ListJobsResponse {
+  // The list of jobs.
+  repeated Job jobs = 1;
+
+  // A token to retrieve next page of results. Pass this value in the
+  // [page_token][google.cloud.scheduler.v1.ListJobsRequest.page_token] field in the subsequent call to
+  // [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs] to retrieve the next page of results.
+  // If this is empty it indicates that there are no more results
+  // through which to paginate.
+  //
+  // The page token is valid for only 2 hours.
+  string next_page_token = 2;
+}
+
+// Request message for [GetJob][google.cloud.scheduler.v1.CloudScheduler.GetJob].
+message GetJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// Request message for [CreateJob][google.cloud.scheduler.v1.CloudScheduler.CreateJob].
+message CreateJobRequest {
+  // Required.
+  //
+  // The location name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID`.
+  string parent = 1;
+
+  // 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;
+}
+
+// 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.
+  //
+  // Output only fields cannot be modified using UpdateJob.
+  // Any value specified for an output only field will be ignored.
+  Job job = 1;
+
+  // A  mask used to specify which fields of the job are being updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for deleting a job using
+// [DeleteJob][google.cloud.scheduler.v1.CloudScheduler.DeleteJob].
+message DeleteJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// Request message for [PauseJob][google.cloud.scheduler.v1.CloudScheduler.PauseJob].
+message PauseJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// Request message for [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob].
+message ResumeJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// 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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
diff --git a/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler_pb2.py b/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler_pb2.py
new file mode 100644
index 000000000000..109cb95585aa
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler_pb2.py
@@ -0,0 +1,833 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/scheduler_v1/proto/cloudscheduler.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.scheduler_v1.proto import (
+    job_pb2 as google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/scheduler_v1/proto/cloudscheduler.proto",
+    package="google.cloud.scheduler.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.cloud.scheduler.v1B\016SchedulerProtoP\001ZBgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler\242\002\tSCHEDULER"
+    ),
+    serialized_pb=_b(
+        '\n4google/cloud/scheduler_v1/proto/cloudscheduler.proto\x12\x19google.cloud.scheduler.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a)google/cloud/scheduler_v1/proto/job.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"H\n\x0fListJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x05 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"Y\n\x10ListJobsResponse\x12,\n\x04jobs\x18\x01 \x03(\x0b\x32\x1e.google.cloud.scheduler.v1.Job\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1d\n\rGetJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x10\x43reateJobRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12+\n\x03job\x18\x02 \x01(\x0b\x32\x1e.google.cloud.scheduler.v1.Job"p\n\x10UpdateJobRequest\x12+\n\x03job\x18\x01 \x01(\x0b\x32\x1e.google.cloud.scheduler.v1.Job\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask" \n\x10\x44\x65leteJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x1f\n\x0fPauseJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t" \n\x10ResumeJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x1d\n\rRunJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t2\x95\t\n\x0e\x43loudScheduler\x12\x95\x01\n\x08ListJobs\x12*.google.cloud.scheduler.v1.ListJobsRequest\x1a+.google.cloud.scheduler.v1.ListJobsResponse"0\x82\xd3\xe4\x93\x02*\x12(/v1/{parent=projects/*/locations/*}/jobs\x12\x84\x01\n\x06GetJob\x12(.google.cloud.scheduler.v1.GetJobRequest\x1a\x1e.google.cloud.scheduler.v1.Job"0\x82\xd3\xe4\x93\x02*\x12(/v1/{name=projects/*/locations/*/jobs/*}\x12\x8f\x01\n\tCreateJob\x12+.google.cloud.scheduler.v1.CreateJobRequest\x1a\x1e.google.cloud.scheduler.v1.Job"5\x82\xd3\xe4\x93\x02/"(/v1/{parent=projects/*/locations/*}/jobs:\x03job\x12\x93\x01\n\tUpdateJob\x12+.google.cloud.scheduler.v1.UpdateJobRequest\x1a\x1e.google.cloud.scheduler.v1.Job"9\x82\xd3\xe4\x93\x02\x33\x32,/v1/{job.name=projects/*/locations/*/jobs/*}:\x03job\x12\x82\x01\n\tDeleteJob\x12+.google.cloud.scheduler.v1.DeleteJobRequest\x1a\x16.google.protobuf.Empty"0\x82\xd3\xe4\x93\x02**(/v1/{name=projects/*/locations/*/jobs/*}\x12\x91\x01\n\x08PauseJob\x12*.google.cloud.scheduler.v1.PauseJobRequest\x1a\x1e.google.cloud.scheduler.v1.Job"9\x82\xd3\xe4\x93\x02\x33"./v1/{name=projects/*/locations/*/jobs/*}:pause:\x01*\x12\x94\x01\n\tResumeJob\x12+.google.cloud.scheduler.v1.ResumeJobRequest\x1a\x1e.google.cloud.scheduler.v1.Job":\x82\xd3\xe4\x93\x02\x34"//v1/{name=projects/*/locations/*/jobs/*}:resume:\x01*\x12\x8b\x01\n\x06RunJob\x12(.google.cloud.scheduler.v1.RunJobRequest\x1a\x1e.google.cloud.scheduler.v1.Job"7\x82\xd3\xe4\x93\x02\x31",/v1/{name=projects/*/locations/*/jobs/*}:run:\x01*B\x81\x01\n\x1d\x63om.google.cloud.scheduler.v1B\x0eSchedulerProtoP\x01ZBgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler\xa2\x02\tSCHEDULERb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTJOBSREQUEST = _descriptor.Descriptor(
+    name="ListJobsRequest",
+    full_name="google.cloud.scheduler.v1.ListJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.scheduler.v1.ListJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.scheduler.v1.ListJobsRequest.page_size",
+            index=1,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.scheduler.v1.ListJobsRequest.page_token",
+            index=2,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=246,
+    serialized_end=318,
+)
+
+
+_LISTJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListJobsResponse",
+    full_name="google.cloud.scheduler.v1.ListJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.scheduler.v1.ListJobsResponse.jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.scheduler.v1.ListJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=320,
+    serialized_end=409,
+)
+
+
+_GETJOBREQUEST = _descriptor.Descriptor(
+    name="GetJobRequest",
+    full_name="google.cloud.scheduler.v1.GetJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1.GetJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=411,
+    serialized_end=440,
+)
+
+
+_CREATEJOBREQUEST = _descriptor.Descriptor(
+    name="CreateJobRequest",
+    full_name="google.cloud.scheduler.v1.CreateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.scheduler.v1.CreateJobRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.scheduler.v1.CreateJobRequest.job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=442,
+    serialized_end=521,
+)
+
+
+_UPDATEJOBREQUEST = _descriptor.Descriptor(
+    name="UpdateJobRequest",
+    full_name="google.cloud.scheduler.v1.UpdateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.scheduler.v1.UpdateJobRequest.job",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.scheduler.v1.UpdateJobRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=523,
+    serialized_end=635,
+)
+
+
+_DELETEJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteJobRequest",
+    full_name="google.cloud.scheduler.v1.DeleteJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1.DeleteJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=637,
+    serialized_end=669,
+)
+
+
+_PAUSEJOBREQUEST = _descriptor.Descriptor(
+    name="PauseJobRequest",
+    full_name="google.cloud.scheduler.v1.PauseJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1.PauseJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=671,
+    serialized_end=702,
+)
+
+
+_RESUMEJOBREQUEST = _descriptor.Descriptor(
+    name="ResumeJobRequest",
+    full_name="google.cloud.scheduler.v1.ResumeJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1.ResumeJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=704,
+    serialized_end=736,
+)
+
+
+_RUNJOBREQUEST = _descriptor.Descriptor(
+    name="RunJobRequest",
+    full_name="google.cloud.scheduler.v1.RunJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1.RunJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=738,
+    serialized_end=767,
+)
+
+_LISTJOBSRESPONSE.fields_by_name[
+    "jobs"
+].message_type = google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB
+_CREATEJOBREQUEST.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+DESCRIPTOR.message_types_by_name["ListJobsRequest"] = _LISTJOBSREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsResponse"] = _LISTJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["GetJobRequest"] = _GETJOBREQUEST
+DESCRIPTOR.message_types_by_name["CreateJobRequest"] = _CREATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["UpdateJobRequest"] = _UPDATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["DeleteJobRequest"] = _DELETEJOBREQUEST
+DESCRIPTOR.message_types_by_name["PauseJobRequest"] = _PAUSEJOBREQUEST
+DESCRIPTOR.message_types_by_name["ResumeJobRequest"] = _RESUMEJOBREQUEST
+DESCRIPTOR.message_types_by_name["RunJobRequest"] = _RUNJOBREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for listing jobs using
+  [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs].
+  
+  
+  Attributes:
+      parent:
+          Required.  The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``.
+      page_size:
+          Requested page size.  The maximum page size is 500. If
+          unspecified, the page size will be the maximum. Fewer jobs
+          than requested might be returned, even if more jobs exist; use
+          next\_page\_token to determine if more jobs exist.
+      page_token:
+          A token identifying a page of results the server will 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.scheduler.v1.ListJob
+          sResponse.next\_page\_token] returned from the previous call
+          to
+          [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs].
+          It is an error to switch the value of
+          [filter][google.cloud.scheduler.v1.ListJobsRequest.filter] or 
+          [order\_by][google.cloud.scheduler.v1.ListJobsRequest.order\_b
+          y] while iterating through pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.ListJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsRequest)
+
+ListJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSRESPONSE,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Response message for listing jobs using
+  [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs].
+  
+  
+  Attributes:
+      jobs:
+          The list of jobs.
+      next_page_token:
+          A token to retrieve next page of results. Pass this value in
+          the [page\_token][google.cloud.scheduler.v1.ListJobsRequest.pa
+          ge\_token] field in the subsequent call to
+          [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs]
+          to retrieve the next page of results. If this is empty it
+          indicates that there are no more results through which to
+          paginate.  The page token is valid for only 2 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.ListJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsResponse)
+
+GetJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [GetJob][google.cloud.scheduler.v1.CloudScheduler.GetJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.GetJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetJobRequest)
+
+CreateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [CreateJob][google.cloud.scheduler.v1.CloudScheduler.CreateJob].
+  
+  
+  Attributes:
+      parent:
+          Required.  The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``.
+      job:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.CreateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateJobRequest)
+
+UpdateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [UpdateJob][google.cloud.scheduler.v1.CloudScheduler.UpdateJob].
+  
+  
+  Attributes:
+      job:
+          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.
+      update_mask:
+          A mask used to specify which fields of the job are being
+          updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.UpdateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateJobRequest)
+
+DeleteJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for deleting a job using
+  [DeleteJob][google.cloud.scheduler.v1.CloudScheduler.DeleteJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.DeleteJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteJobRequest)
+
+PauseJobRequest = _reflection.GeneratedProtocolMessageType(
+    "PauseJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAUSEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [PauseJob][google.cloud.scheduler.v1.CloudScheduler.PauseJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.PauseJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(PauseJobRequest)
+
+ResumeJobRequest = _reflection.GeneratedProtocolMessageType(
+    "ResumeJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUMEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.ResumeJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(ResumeJobRequest)
+
+RunJobRequest = _reflection.GeneratedProtocolMessageType(
+    "RunJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNJOBREQUEST,
+        __module__="google.cloud.scheduler_v1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for forcing a job to run now using
+  [RunJob][google.cloud.scheduler.v1.CloudScheduler.RunJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.RunJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunJobRequest)
+
+
+DESCRIPTOR._options = None
+
+_CLOUDSCHEDULER = _descriptor.ServiceDescriptor(
+    name="CloudScheduler",
+    full_name="google.cloud.scheduler.v1.CloudScheduler",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=770,
+    serialized_end=1943,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListJobs",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.ListJobs",
+            index=0,
+            containing_service=None,
+            input_type=_LISTJOBSREQUEST,
+            output_type=_LISTJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002*\022(/v1/{parent=projects/*/locations/*}/jobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.GetJob",
+            index=1,
+            containing_service=None,
+            input_type=_GETJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002*\022(/v1/{name=projects/*/locations/*/jobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.CreateJob",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\002/"(/v1/{parent=projects/*/locations/*}/jobs:\003job'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.UpdateJob",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                "\202\323\344\223\00232,/v1/{job.name=projects/*/locations/*/jobs/*}:\003job"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.DeleteJob",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002**(/v1/{name=projects/*/locations/*/jobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PauseJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.PauseJob",
+            index=5,
+            containing_service=None,
+            input_type=_PAUSEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0023"./v1/{name=projects/*/locations/*/jobs/*}:pause:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ResumeJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.ResumeJob",
+            index=6,
+            containing_service=None,
+            input_type=_RESUMEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0024"//v1/{name=projects/*/locations/*/jobs/*}:resume:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunJob",
+            full_name="google.cloud.scheduler.v1.CloudScheduler.RunJob",
+            index=7,
+            containing_service=None,
+            input_type=_RUNJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0021",/v1/{name=projects/*/locations/*/jobs/*}:run:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDSCHEDULER)
+
+DESCRIPTOR.services_by_name["CloudScheduler"] = _CLOUDSCHEDULER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler_pb2_grpc.py b/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler_pb2_grpc.py
new file mode 100644
index 000000000000..7a55cab6f193
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/cloudscheduler_pb2_grpc.py
@@ -0,0 +1,196 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.scheduler_v1.proto import (
+    cloudscheduler_pb2 as google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2,
+)
+from google.cloud.scheduler_v1.proto import (
+    job_pb2 as google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class CloudSchedulerStub(object):
+    """The Cloud Scheduler API allows external entities to reliably
+  schedule asynchronous jobs.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListJobs = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/ListJobs",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.ListJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.ListJobsResponse.FromString,
+        )
+        self.GetJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/GetJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.GetJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.CreateJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/CreateJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.CreateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.UpdateJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/UpdateJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.UpdateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.DeleteJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/DeleteJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.DeleteJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.PauseJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/PauseJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.PauseJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.ResumeJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/ResumeJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.ResumeJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.RunJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1.CloudScheduler/RunJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.RunJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+
+
+class CloudSchedulerServicer(object):
+    """The Cloud Scheduler API allows external entities to reliably
+  schedule asynchronous jobs.
+  """
+
+    def ListJobs(self, request, context):
+        """Lists jobs.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetJob(self, request, context):
+        """Gets a job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateJob(self, request, context):
+        """Creates a job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateJob(self, request, context):
+        """Updates a job.
+
+    If successful, the updated [Job][google.cloud.scheduler.v1.Job] is returned. If the job does
+    not exist, `NOT_FOUND` is returned.
+
+    If UpdateJob does not successfully return, it is possible for the
+    job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1.Job.State.UPDATE_FAILED] state. A job in this state may
+    not be executed. If this happens, retry the UpdateJob request
+    until a successful response is received.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteJob(self, request, context):
+        """Deletes a job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PauseJob(self, request, context):
+        """Pauses a job.
+
+    If a job is paused then the system will stop executing the job
+    until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob]. The
+    state of the job is stored in [state][google.cloud.scheduler.v1.Job.state]; if paused it
+    will be set to [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]
+    to be paused.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ResumeJob(self, request, context):
+        """Resume a job.
+
+    This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]. The
+    state of a job is stored in [Job.state][google.cloud.scheduler.v1.Job.state]; after calling this method it
+    will be set to [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]. A job must be in
+    [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED] to be resumed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunJob(self, request, context):
+        """Forces a job to run now.
+
+    When this method is called, Cloud Scheduler will dispatch the job, even
+    if the job is already running.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudSchedulerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListJobs,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.ListJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.ListJobsResponse.SerializeToString,
+        ),
+        "GetJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.GetJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "CreateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.CreateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "UpdateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.UpdateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "DeleteJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.DeleteJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PauseJob": grpc.unary_unary_rpc_method_handler(
+            servicer.PauseJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.PauseJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "ResumeJob": grpc.unary_unary_rpc_method_handler(
+            servicer.ResumeJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.ResumeJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "RunJob": grpc.unary_unary_rpc_method_handler(
+            servicer.RunJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_cloudscheduler__pb2.RunJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.scheduler.v1.CloudScheduler", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/scheduler/google/cloud/scheduler_v1/proto/job.proto b/scheduler/google/cloud/scheduler_v1/proto/job.proto
new file mode 100644
index 000000000000..60b47263151b
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/job.proto
@@ -0,0 +1,232 @@
+// 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.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";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler";
+option java_multiple_files = true;
+option java_outer_classname = "JobProto";
+option java_package = "com.google.cloud.scheduler.v1";
+
+// Configuration for a job.
+// The maximum allowed size for a job is 100KB.
+message Job {
+  // State of the job.
+  enum State {
+    // Unspecified state.
+    STATE_UNSPECIFIED = 0;
+
+    // The job is executing normally.
+    ENABLED = 1;
+
+    // The job is paused by the user. It will not execute. A user can
+    // intentionally pause the job using
+    // [PauseJobRequest][google.cloud.scheduler.v1.PauseJobRequest].
+    PAUSED = 2;
+
+    // The job is disabled by the system due to error. The user
+    // cannot directly set a job to be disabled.
+    DISABLED = 3;
+
+    // The job state resulting from a failed [CloudScheduler.UpdateJob][google.cloud.scheduler.v1.CloudScheduler.UpdateJob]
+    // operation. To recover a job from this state, retry
+    // [CloudScheduler.UpdateJob][google.cloud.scheduler.v1.CloudScheduler.UpdateJob] until a successful response is received.
+    UPDATE_FAILED = 4;
+  }
+
+  // Optionally caller-specified in [CreateJob][google.cloud.scheduler.v1.CloudScheduler.CreateJob], after
+  // which it becomes output only.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the job's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), or underscores (_). The maximum length is 500 characters.
+  string name = 1;
+
+  // Optionally caller-specified in [CreateJob][google.cloud.scheduler.v1.CloudScheduler.CreateJob] or
+  // [UpdateJob][google.cloud.scheduler.v1.CloudScheduler.UpdateJob].
+  //
+  // A human-readable description for the job. This string must not contain
+  // more than 500 characters.
+  string description = 2;
+
+  // Required.
+  //
+  // Delivery settings containing destination and parameters.
+  oneof target {
+    // Pub/Sub target.
+    PubsubTarget pubsub_target = 4;
+
+    // App Engine HTTP target.
+    AppEngineHttpTarget app_engine_http_target = 5;
+
+    // HTTP target.
+    HttpTarget http_target = 6;
+  }
+
+  // Required, except when used with [UpdateJob][google.cloud.scheduler.v1.CloudScheduler.UpdateJob].
+  //
+  // Describes the schedule on which the job will be executed.
+  //
+  // The schedule can be either of the following types:
+  //
+  // * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview)
+  // * English-like
+  // [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules)
+  //
+  // As a general rule, execution `n + 1` of a job will not begin
+  // until execution `n` has finished. Cloud Scheduler will never
+  // allow two simultaneously outstanding executions. For example,
+  // this implies that if the `n+1`th execution is scheduled to run at
+  // 16:00 but the `n`th execution takes until 16:15, the `n+1`th
+  // execution will not start until `16:15`.
+  // A scheduled start time will be delayed if the previous
+  // execution has not ended when its scheduled time occurs.
+  //
+  // If [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count] > 0 and a job attempt fails,
+  // the job will be tried a total of [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count]
+  // times, with exponential backoff, until the next scheduled start
+  // time.
+  string schedule = 20;
+
+  // Specifies the time zone to be used in interpreting
+  // [schedule][google.cloud.scheduler.v1.Job.schedule]. The value of this field must be a time
+  // zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database).
+  //
+  // Note that some time zones include a provision for
+  // daylight savings time. The rules for daylight saving time are
+  // determined by the chosen tz. For UTC use the string "utc". If a
+  // time zone is not specified, the default will be in UTC (also known
+  // as GMT).
+  string time_zone = 21;
+
+  // Output only. The creation time of the job.
+  google.protobuf.Timestamp user_update_time = 9;
+
+  // Output only. State of the job.
+  State state = 10;
+
+  // Output only. The response from the target for the last attempted execution.
+  google.rpc.Status status = 11;
+
+  // Output only. The next time the job is scheduled. Note that this may be a
+  // retry of a previously failed attempt or the next execution time
+  // according to the schedule.
+  google.protobuf.Timestamp schedule_time = 17;
+
+  // Output only. The time the last job attempt started.
+  google.protobuf.Timestamp last_attempt_time = 18;
+
+  // Settings that determine the retry behavior.
+  RetryConfig retry_config = 19;
+
+  // The deadline for job attempts. If the request handler does not respond by
+  // this deadline then the request is cancelled and the attempt is marked as a
+  // `DEADLINE_EXCEEDED` failure. The failed attempt can be viewed in
+  // execution logs. Cloud Scheduler will retry the job according
+  // to the [RetryConfig][google.cloud.scheduler.v1.RetryConfig].
+  //
+  // The allowed duration for this deadline is:
+  // * For [HTTP targets][google.cloud.scheduler.v1.Job.http_target], between 15 seconds and 30 minutes.
+  // * For [App Engine HTTP targets][google.cloud.scheduler.v1.Job.app_engine_http_target], between 15
+  //   seconds and 24 hours.
+  google.protobuf.Duration attempt_deadline = 22;
+}
+
+// Settings that determine the retry behavior.
+//
+// By default, if a job does not complete successfully (meaning that
+// an acknowledgement is not received from the handler, then it will be retried
+// with exponential backoff according to the settings in [RetryConfig][google.cloud.scheduler.v1.RetryConfig].
+message RetryConfig {
+  // The number of attempts that the system will make to run a job using the
+  // exponential backoff procedure described by
+  // [max_doublings][google.cloud.scheduler.v1.RetryConfig.max_doublings].
+  //
+  // The default value of retry_count is zero.
+  //
+  // If retry_count is zero, a job attempt will *not* be retried if
+  // it fails. Instead the Cloud Scheduler system will wait for the
+  // next scheduled execution time.
+  //
+  // If retry_count is set to a non-zero number then Cloud Scheduler
+  // will retry failed attempts, using exponential backoff,
+  // retry_count times, or until the next scheduled execution time,
+  // whichever comes first.
+  //
+  // Values greater than 5 and negative values are not allowed.
+  int32 retry_count = 1;
+
+  // The time limit for retrying a failed job, measured from time when an
+  // execution was first attempted. If specified with
+  // [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count], the job will be retried until both
+  // limits are reached.
+  //
+  // The default value for max_retry_duration is zero, which means retry
+  // duration is unlimited.
+  google.protobuf.Duration max_retry_duration = 2;
+
+  // The minimum amount of time to wait before retrying a job after
+  // it fails.
+  //
+  // The default value of this field is 5 seconds.
+  google.protobuf.Duration min_backoff_duration = 3;
+
+  // The maximum amount of time to wait before retrying a job after
+  // it fails.
+  //
+  // The default value of this field is 1 hour.
+  google.protobuf.Duration max_backoff_duration = 4;
+
+  // The time between retries will double `max_doublings` times.
+  //
+  // A job's retry interval starts at
+  // [min_backoff_duration][google.cloud.scheduler.v1.RetryConfig.min_backoff_duration], then doubles
+  // `max_doublings` times, then increases linearly, and finally
+  // retries retries at intervals of
+  // [max_backoff_duration][google.cloud.scheduler.v1.RetryConfig.max_backoff_duration] up to
+  // [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count] times.
+  //
+  // For example, if [min_backoff_duration][google.cloud.scheduler.v1.RetryConfig.min_backoff_duration] is
+  // 10s, [max_backoff_duration][google.cloud.scheduler.v1.RetryConfig.max_backoff_duration] is 300s, and
+  // `max_doublings` is 3, then the a job will first be retried in 10s. The
+  // retry interval will double three times, and then increase linearly by
+  // 2^3 * 10s.  Finally, the job will retry at intervals of
+  // [max_backoff_duration][google.cloud.scheduler.v1.RetryConfig.max_backoff_duration] until the job has
+  // been attempted [retry_count][google.cloud.scheduler.v1.RetryConfig.retry_count] times. Thus, the
+  // requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....
+  //
+  // The default value of this field is 5.
+  int32 max_doublings = 5;
+}
diff --git a/scheduler/google/cloud/scheduler_v1/proto/job_pb2.py b/scheduler/google/cloud/scheduler_v1/proto/job_pb2.py
new file mode 100644
index 000000000000..7f5d3a791458
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/job_pb2.py
@@ -0,0 +1,703 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/scheduler_v1/proto/job.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.scheduler_v1.proto import (
+    target_pb2 as google_dot_cloud_dot_scheduler__v1_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/scheduler_v1/proto/job.proto",
+    package="google.cloud.scheduler.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.cloud.scheduler.v1B\010JobProtoP\001ZBgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler"
+    ),
+    serialized_pb=_b(
+        '\n)google/cloud/scheduler_v1/proto/job.proto\x12\x19google.cloud.scheduler.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/scheduler_v1/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xef\x05\n\x03Job\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12@\n\rpubsub_target\x18\x04 \x01(\x0b\x32\'.google.cloud.scheduler.v1.PubsubTargetH\x00\x12P\n\x16\x61pp_engine_http_target\x18\x05 \x01(\x0b\x32..google.cloud.scheduler.v1.AppEngineHttpTargetH\x00\x12<\n\x0bhttp_target\x18\x06 \x01(\x0b\x32%.google.cloud.scheduler.v1.HttpTargetH\x00\x12\x10\n\x08schedule\x18\x14 \x01(\t\x12\x11\n\ttime_zone\x18\x15 \x01(\t\x12\x34\n\x10user_update_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x05state\x18\n \x01(\x0e\x32$.google.cloud.scheduler.v1.Job.State\x12"\n\x06status\x18\x0b \x01(\x0b\x32\x12.google.rpc.Status\x12\x31\n\rschedule_time\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11last_attempt_time\x18\x12 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12<\n\x0cretry_config\x18\x13 \x01(\x0b\x32&.google.cloud.scheduler.v1.RetryConfig\x12\x33\n\x10\x61ttempt_deadline\x18\x16 \x01(\x0b\x32\x19.google.protobuf.Duration"X\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x45NABLED\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03\x12\x11\n\rUPDATE_FAILED\x10\x04\x42\x08\n\x06target"\xe2\x01\n\x0bRetryConfig\x12\x13\n\x0bretry_count\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x37\n\x14min_backoff_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x37\n\x14max_backoff_duration\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05\x42o\n\x1d\x63om.google.cloud.scheduler.v1B\x08JobProtoP\x01ZBgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1;schedulerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_scheduler__v1_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_JOB_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.scheduler.v1.Job.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENABLED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATE_FAILED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=919,
+    serialized_end=1007,
+)
+_sym_db.RegisterEnumDescriptor(_JOB_STATE)
+
+
+_JOB = _descriptor.Descriptor(
+    name="Job",
+    full_name="google.cloud.scheduler.v1.Job",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1.Job.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.scheduler.v1.Job.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pubsub_target",
+            full_name="google.cloud.scheduler.v1.Job.pubsub_target",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_target",
+            full_name="google.cloud.scheduler.v1.Job.app_engine_http_target",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_target",
+            full_name="google.cloud.scheduler.v1.Job.http_target",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.scheduler.v1.Job.schedule",
+            index=5,
+            number=20,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_zone",
+            full_name="google.cloud.scheduler.v1.Job.time_zone",
+            index=6,
+            number=21,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_update_time",
+            full_name="google.cloud.scheduler.v1.Job.user_update_time",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.scheduler.v1.Job.state",
+            index=8,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.scheduler.v1.Job.status",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.scheduler.v1.Job.schedule_time",
+            index=10,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_attempt_time",
+            full_name="google.cloud.scheduler.v1.Job.last_attempt_time",
+            index=11,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="retry_config",
+            full_name="google.cloud.scheduler.v1.Job.retry_config",
+            index=12,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attempt_deadline",
+            full_name="google.cloud.scheduler.v1.Job.attempt_deadline",
+            index=13,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_JOB_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target",
+            full_name="google.cloud.scheduler.v1.Job.target",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=266,
+    serialized_end=1017,
+)
+
+
+_RETRYCONFIG = _descriptor.Descriptor(
+    name="RetryConfig",
+    full_name="google.cloud.scheduler.v1.RetryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="retry_count",
+            full_name="google.cloud.scheduler.v1.RetryConfig.retry_count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_retry_duration",
+            full_name="google.cloud.scheduler.v1.RetryConfig.max_retry_duration",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_backoff_duration",
+            full_name="google.cloud.scheduler.v1.RetryConfig.min_backoff_duration",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_backoff_duration",
+            full_name="google.cloud.scheduler.v1.RetryConfig.max_backoff_duration",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_doublings",
+            full_name="google.cloud.scheduler.v1.RetryConfig.max_doublings",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1020,
+    serialized_end=1246,
+)
+
+_JOB.fields_by_name[
+    "pubsub_target"
+].message_type = (
+    google_dot_cloud_dot_scheduler__v1_dot_proto_dot_target__pb2._PUBSUBTARGET
+)
+_JOB.fields_by_name[
+    "app_engine_http_target"
+].message_type = (
+    google_dot_cloud_dot_scheduler__v1_dot_proto_dot_target__pb2._APPENGINEHTTPTARGET
+)
+_JOB.fields_by_name[
+    "http_target"
+].message_type = (
+    google_dot_cloud_dot_scheduler__v1_dot_proto_dot_target__pb2._HTTPTARGET
+)
+_JOB.fields_by_name[
+    "user_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name["state"].enum_type = _JOB_STATE
+_JOB.fields_by_name["status"].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_JOB.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "last_attempt_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name["retry_config"].message_type = _RETRYCONFIG
+_JOB.fields_by_name[
+    "attempt_deadline"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_JOB_STATE.containing_type = _JOB
+_JOB.oneofs_by_name["target"].fields.append(_JOB.fields_by_name["pubsub_target"])
+_JOB.fields_by_name["pubsub_target"].containing_oneof = _JOB.oneofs_by_name["target"]
+_JOB.oneofs_by_name["target"].fields.append(
+    _JOB.fields_by_name["app_engine_http_target"]
+)
+_JOB.fields_by_name["app_engine_http_target"].containing_oneof = _JOB.oneofs_by_name[
+    "target"
+]
+_JOB.oneofs_by_name["target"].fields.append(_JOB.fields_by_name["http_target"])
+_JOB.fields_by_name["http_target"].containing_oneof = _JOB.oneofs_by_name["target"]
+_RETRYCONFIG.fields_by_name[
+    "max_retry_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "min_backoff_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "max_backoff_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["Job"] = _JOB
+DESCRIPTOR.message_types_by_name["RetryConfig"] = _RETRYCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Job = _reflection.GeneratedProtocolMessageType(
+    "Job",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOB,
+        __module__="google.cloud.scheduler_v1.proto.job_pb2",
+        __doc__="""Configuration for a job. The maximum allowed size for a job is 100KB.
+  
+  
+  Attributes:
+      name:
+          Optionally caller-specified in [CreateJob][google.cloud.schedu
+          ler.v1.CloudScheduler.CreateJob], after which it becomes
+          output only.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.  -
+          ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`__ -  ``LOCATION_ID``
+          is the canonical ID for the job's location. The list    of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``JOB_ID`` can
+          contain only letters ([A-Za-z]), numbers ([0-9]),    hyphens
+          (-), or underscores (\_). The maximum length is 500
+          characters.
+      description:
+          Optionally caller-specified in [CreateJob][google.cloud.schedu
+          ler.v1.CloudScheduler.CreateJob] or [UpdateJob][google.cloud.s
+          cheduler.v1.CloudScheduler.UpdateJob].  A human-readable
+          description for the job. This string must not contain more
+          than 500 characters.
+      target:
+          Required.  Delivery settings containing destination and
+          parameters.
+      pubsub_target:
+          Pub/Sub target.
+      app_engine_http_target:
+          App Engine HTTP target.
+      http_target:
+          HTTP target.
+      schedule:
+          Required, except when used with [UpdateJob][google.cloud.sched
+          uler.v1.CloudScheduler.UpdateJob].  Describes the schedule on
+          which the job will be executed.  The schedule can be either of
+          the following types:  -  `Crontab
+          <http://en.wikipedia.org/wiki/Cron#Overview>`__ -  English-
+          like    `schedule
+          <https://cloud.google.com/scheduler/docs/configuring/cron-job-
+          schedules>`__  As a general rule, execution ``n + 1`` of a job
+          will not begin until execution ``n`` has finished. Cloud
+          Scheduler will never allow two simultaneously outstanding
+          executions. For example, this implies that if the ``n+1``\ th
+          execution is scheduled to run at 16:00 but the ``n``\ th
+          execution takes until 16:15, the ``n+1``\ th execution will
+          not start until ``16:15``. A scheduled start time will be
+          delayed if the previous execution has not ended when its
+          scheduled time occurs.  If [retry\_count][google.cloud.schedul
+          er.v1.RetryConfig.retry\_count] > 0 and a job attempt fails,
+          the job will be tried a total of [retry\_count][google.cloud.s
+          cheduler.v1.RetryConfig.retry\_count] times, with exponential
+          backoff, until the next scheduled start time.
+      time_zone:
+          Specifies the time zone to be used in interpreting
+          [schedule][google.cloud.scheduler.v1.Job.schedule]. The value
+          of this field must be a time zone name from the `tz database
+          <http://en.wikipedia.org/wiki/Tz_database>`__.  Note that some
+          time zones include a provision for daylight savings time. The
+          rules for daylight saving time are determined by the chosen
+          tz. For UTC use the string "utc". If a time zone is not
+          specified, the default will be in UTC (also known as GMT).
+      user_update_time:
+          Output only. The creation time of the job.
+      state:
+          Output only. State of the job.
+      status:
+          Output only. The response from the target for the last
+          attempted execution.
+      schedule_time:
+          Output only. The next time the job is scheduled. Note that
+          this may be a retry of a previously failed attempt or the next
+          execution time according to the schedule.
+      last_attempt_time:
+          Output only. The time the last job attempt started.
+      retry_config:
+          Settings that determine the retry behavior.
+      attempt_deadline:
+          The deadline for job attempts. If the request handler does not
+          respond by this deadline then the request is cancelled and the
+          attempt is marked as a ``DEADLINE_EXCEEDED`` failure. The
+          failed attempt can be viewed in execution logs. Cloud
+          Scheduler will retry the job according to the
+          [RetryConfig][google.cloud.scheduler.v1.RetryConfig].  The
+          allowed duration for this deadline is: \* For [HTTP
+          targets][google.cloud.scheduler.v1.Job.http\_target], between
+          15 seconds and 30 minutes. \* For [App Engine HTTP targets][go
+          ogle.cloud.scheduler.v1.Job.app\_engine\_http\_target],
+          between 15 seconds and 24 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.Job)
+    ),
+)
+_sym_db.RegisterMessage(Job)
+
+RetryConfig = _reflection.GeneratedProtocolMessageType(
+    "RetryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RETRYCONFIG,
+        __module__="google.cloud.scheduler_v1.proto.job_pb2",
+        __doc__="""Settings that determine the retry behavior.
+  
+  By default, if a job does not complete successfully (meaning that an
+  acknowledgement is not received from the handler, then it will be
+  retried with exponential backoff according to the settings in
+  [RetryConfig][google.cloud.scheduler.v1.RetryConfig].
+  
+  
+  Attributes:
+      retry_count:
+          The number of attempts that the system will make to run a job
+          using the exponential backoff procedure described by [max\_dou
+          blings][google.cloud.scheduler.v1.RetryConfig.max\_doublings].
+          The default value of retry\_count is zero.  If retry\_count is
+          zero, a job attempt will *not* be retried if it fails. Instead
+          the Cloud Scheduler system will wait for the next scheduled
+          execution time.  If retry\_count is set to a non-zero number
+          then Cloud Scheduler will retry failed attempts, using
+          exponential backoff, retry\_count times, or until the next
+          scheduled execution time, whichever comes first.  Values
+          greater than 5 and negative values are not allowed.
+      max_retry_duration:
+          The time limit for retrying a failed job, measured from time
+          when an execution was first attempted. If specified with [retr
+          y\_count][google.cloud.scheduler.v1.RetryConfig.retry\_count],
+          the job will be retried until both limits are reached.  The
+          default value for max\_retry\_duration is zero, which means
+          retry duration is unlimited.
+      min_backoff_duration:
+          The minimum amount of time to wait before retrying a job after
+          it fails.  The default value of this field is 5 seconds.
+      max_backoff_duration:
+          The maximum amount of time to wait before retrying a job after
+          it fails.  The default value of this field is 1 hour.
+      max_doublings:
+          The time between retries will double ``max_doublings`` times.
+          A job's retry interval starts at [min\_backoff\_duration][goog
+          le.cloud.scheduler.v1.RetryConfig.min\_backoff\_duration],
+          then doubles ``max_doublings`` times, then increases linearly,
+          and finally retries retries at intervals of [max\_backoff\_dur
+          ation][google.cloud.scheduler.v1.RetryConfig.max\_backoff\_dur
+          ation] up to [retry\_count][google.cloud.scheduler.v1.RetryCon
+          fig.retry\_count] times.  For example, if [min\_backoff\_durat
+          ion][google.cloud.scheduler.v1.RetryConfig.min\_backoff\_durat
+          ion] is 10s, [max\_backoff\_duration][google.cloud.scheduler.v
+          1.RetryConfig.max\_backoff\_duration] is 300s, and
+          ``max_doublings`` is 3, then the a job will first be retried
+          in 10s. The retry interval will double three times, and then
+          increase linearly by 2^3 \* 10s. Finally, the job will retry
+          at intervals of [max\_backoff\_duration][google.cloud.schedule
+          r.v1.RetryConfig.max\_backoff\_duration] until the job has
+          been attempted [retry\_count][google.cloud.scheduler.v1.RetryC
+          onfig.retry\_count] times. Thus, the requests will retry at
+          10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....  The default
+          value of this field is 5.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.RetryConfig)
+    ),
+)
+_sym_db.RegisterMessage(RetryConfig)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/scheduler/google/cloud/scheduler_v1/proto/job_pb2_grpc.py b/scheduler/google/cloud/scheduler_v1/proto/job_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/job_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/scheduler/google/cloud/scheduler_v1/proto/target.proto b/scheduler/google/cloud/scheduler_v1/proto/target.proto
new file mode 100644
index 000000000000..e33b1558e53d
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/target.proto
@@ -0,0 +1,348 @@
+// 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.scheduler.v1;
+
+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;
+option java_outer_classname = "TargetProto";
+option java_package = "com.google.cloud.scheduler.v1";
+
+// Http target. The job will be pushed to the job handler by means of
+// an HTTP request via an [http_method][google.cloud.scheduler.v1.HttpTarget.http_method] such as HTTP
+// POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
+// response code in the range [200 - 299]. A failure to receive a response
+// 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
+  // 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
+  // encode some characters for safety and compatibility. The maximum allowed
+  // URL length is 2083 characters after encoding.
+  string uri = 1;
+
+  // Which HTTP method to use for the request.
+  HttpMethod http_method = 2;
+
+  // The user can specify HTTP request headers to send with the job's
+  // HTTP request. This map contains the header field names and
+  // values. Repeated headers are not supported, but a header value can
+  // contain commas. These headers represent a subset of the headers
+  // that will accompany the job's HTTP request. Some HTTP request
+  // headers will be ignored or replaced. A partial list of headers that
+  // will be ignored or replaced is below:
+  // - Host: This will be computed by Cloud Scheduler and derived from
+  // [uri][google.cloud.scheduler.v1.HttpTarget.uri].
+  // * `Content-Length`: This will be computed by Cloud Scheduler.
+  // * `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`.
+  // * `X-Google-*`: Google internal use only.
+  // * `X-AppEngine-*`: Google internal use only.
+  //
+  // The total size of headers must be less than 80KB.
+  map<string, string> headers = 3;
+
+  // HTTP request body. A request body is allowed only if the HTTP
+  // method is POST, PUT, or PATCH. It is an error to set body on a job with an
+  // incompatible [HttpMethod][google.cloud.scheduler.v1.HttpMethod].
+  bytes body = 4;
+
+  // The mode for generating an `Authorization` header for HTTP requests.
+  //
+  // If specified, all `Authorization` headers in the [HttpTarget.headers][google.cloud.scheduler.v1.HttpTarget.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 be used when sending requests to a GCP
+    // endpoint.
+    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 should be used when sending requests to third
+    // party endpoints or Cloud Run.
+    OidcToken oidc_token = 6;
+  }
+}
+
+// App Engine target. The job will be pushed to a job handler by means
+// of an HTTP request via an [http_method][google.cloud.scheduler.v1.AppEngineHttpTarget.http_method] such
+// as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
+// HTTP response code in the range [200 - 299]. Error 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, constitutes a failed attempt.
+message AppEngineHttpTarget {
+  // The HTTP method to use for the request. PATCH and OPTIONS are not
+  // permitted.
+  HttpMethod http_method = 1;
+
+  // App Engine Routing setting for the job.
+  AppEngineRouting app_engine_routing = 2;
+
+  // The relative URI.
+  //
+  // The relative URL must begin with "/" and must be a valid HTTP relative URL.
+  // It can contain a path, query string arguments, and `#` fragments.
+  // If the relative URL is empty, then the root path "/" will be used.
+  // No spaces are allowed, and the maximum length allowed is 2083 characters.
+  string relative_uri = 3;
+
+  // HTTP request headers.
+  //
+  // This map contains the header field names and values. Headers can be set
+  // when the job is created.
+  //
+  // Cloud Scheduler sets some headers to default values:
+  //
+  // * `User-Agent`: By default, this header is
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+  //   This header can be modified, but Cloud Scheduler will append
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+  //   modified `User-Agent`.
+  // * `X-CloudScheduler`: This header will be set to true.
+  //
+  // If the job has an [body][google.cloud.scheduler.v1.AppEngineHttpTarget.body], Cloud Scheduler sets
+  // the following headers:
+  //
+  // * `Content-Type`: By default, the `Content-Type` header is set to
+  //   `"application/octet-stream"`. The default can be overridden by explictly
+  //   setting `Content-Type` to a particular media type when the job is
+  //   created.
+  //   For example, `Content-Type` can be set to `"application/json"`.
+  // * `Content-Length`: This is computed by Cloud Scheduler. This value is
+  //   output only. It cannot be changed.
+  //
+  // The headers below are output only. They cannot be set or overridden:
+  //
+  // * `X-Google-*`: For Google internal use only.
+  // * `X-AppEngine-*`: For Google internal use only.
+  //
+  // In addition, some App Engine headers, which contain
+  // job-specific information, are also be sent to the job handler.
+  map<string, string> headers = 4;
+
+  // Body.
+  //
+  // HTTP request body. A request body is allowed only if the HTTP method is
+  // POST or PUT. It will result in invalid argument error to set a body on a
+  // job with an incompatible [HttpMethod][google.cloud.scheduler.v1.HttpMethod].
+  bytes body = 5;
+}
+
+// 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
+  // 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;
+
+  // The message payload for PubsubMessage.
+  //
+  // Pubsub message must contain either non-empty data, or at least one
+  // attribute.
+  bytes data = 3;
+
+  // Attributes for PubsubMessage.
+  //
+  // Pubsub message must contain either non-empty data, or at least one
+  // attribute.
+  map<string, string> attributes = 4;
+}
+
+// App Engine Routing.
+//
+// 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),
+// [Microservices Architecture on Google App
+// Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+// [App Engine Standard request
+// 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).
+message AppEngineRouting {
+  // App service.
+  //
+  // By default, the job is sent to the service which is the default
+  // service when the job is attempted.
+  string service = 1;
+
+  // App version.
+  //
+  // By default, the job is sent to the version which is the default
+  // version when the job is attempted.
+  string version = 2;
+
+  // App instance.
+  //
+  // By default, the job is sent to an instance which is available when
+  // the job is attempted.
+  //
+  // Requests can only be sent to a specific instance if
+  // [manual scaling is used in App Engine
+  // Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+  // App Engine Flex does not support instances. For more information, see
+  // [App Engine Standard request
+  // 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).
+  string instance = 3;
+
+  // Output only. The host that the job is sent to.
+  //
+  // For more information about how App Engine requests are routed, see
+  // [here](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+  //
+  // The host is constructed as:
+  //
+  //
+  // * `host = [application_domain_name]`</br>
+  //   `| [service] + '.' + [application_domain_name]`</br>
+  //   `| [version] + '.' + [application_domain_name]`</br>
+  //   `| [version_dot_service]+ '.' + [application_domain_name]`</br>
+  //   `| [instance] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_service] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_version] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_version_dot_service] + '.' + [application_domain_name]`
+  //
+  // * `application_domain_name` = The domain name of the app, for
+  //   example <app-id>.appspot.com, which is associated with the
+  //   job's project ID.
+  //
+  // * `service =` [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+  //
+  // * `version =` [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+  //
+  // * `version_dot_service =`
+  //   [version][google.cloud.scheduler.v1.AppEngineRouting.version] `+ '.' +`
+  //   [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+  //
+  // * `instance =` [instance][google.cloud.scheduler.v1.AppEngineRouting.instance]
+  //
+  // * `instance_dot_service =`
+  //   [instance][google.cloud.scheduler.v1.AppEngineRouting.instance] `+ '.' +`
+  //   [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+  //
+  // * `instance_dot_version =`
+  //   [instance][google.cloud.scheduler.v1.AppEngineRouting.instance] `+ '.' +`
+  //   [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+  //
+  // * `instance_dot_version_dot_service =`
+  //   [instance][google.cloud.scheduler.v1.AppEngineRouting.instance] `+ '.' +`
+  //   [version][google.cloud.scheduler.v1.AppEngineRouting.version] `+ '.' +`
+  //   [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+  //
+  //
+  // If [service][google.cloud.scheduler.v1.AppEngineRouting.service] is empty, then the job will be sent
+  // to the service which is the default service when the job is attempted.
+  //
+  // If [version][google.cloud.scheduler.v1.AppEngineRouting.version] is empty, then the job will be sent
+  // to the version which is the default version when the job is attempted.
+  //
+  // If [instance][google.cloud.scheduler.v1.AppEngineRouting.instance] is empty, then the job will be
+  // sent to an instance which is available when the job is attempted.
+  //
+  // If [service][google.cloud.scheduler.v1.AppEngineRouting.service],
+  // [version][google.cloud.scheduler.v1.AppEngineRouting.version], or
+  // [instance][google.cloud.scheduler.v1.AppEngineRouting.instance] is invalid, then the job will be sent
+  // to the default version of the default service when the job is attempted.
+  string host = 4;
+}
+
+// The HTTP method used to execute the job.
+enum HttpMethod {
+  // HTTP method unspecified. Defaults to POST.
+  HTTP_METHOD_UNSPECIFIED = 0;
+
+  // HTTP POST
+  POST = 1;
+
+  // HTTP GET
+  GET = 2;
+
+  // HTTP HEAD
+  HEAD = 3;
+
+  // HTTP PUT
+  PUT = 4;
+
+  // HTTP DELETE
+  DELETE = 5;
+
+  // HTTP PATCH
+  PATCH = 6;
+
+  // HTTP OPTIONS
+  OPTIONS = 7;
+}
+
+// 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.
+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 job. 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 should be used when sending requests to third party
+// endpoints or Cloud Run.
+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 job. 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/scheduler/google/cloud/scheduler_v1/proto/target_pb2.py b/scheduler/google/cloud/scheduler_v1/proto/target_pb2.py
new file mode 100644
index 000000000000..c6cb1357681c
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/target_pb2.py
@@ -0,0 +1,1181 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/scheduler_v1/proto/target.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/scheduler_v1/proto/target.proto",
+    package="google.cloud.scheduler.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\035com.google.cloud.scheduler.v1B\013TargetProtoP\001ZBgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/scheduler_v1/proto/target.proto\x12\x19google.cloud.scheduler.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/protobuf/any.proto"\xea\x02\n\nHttpTarget\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12:\n\x0bhttp_method\x18\x02 \x01(\x0e\x32%.google.cloud.scheduler.v1.HttpMethod\x12\x43\n\x07headers\x18\x03 \x03(\x0b\x32\x32.google.cloud.scheduler.v1.HttpTarget.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12<\n\x0boauth_token\x18\x05 \x01(\x0b\x32%.google.cloud.scheduler.v1.OAuthTokenH\x00\x12:\n\noidc_token\x18\x06 \x01(\x0b\x32$.google.cloud.scheduler.v1.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"\xbc\x02\n\x13\x41ppEngineHttpTarget\x12:\n\x0bhttp_method\x18\x01 \x01(\x0e\x32%.google.cloud.scheduler.v1.HttpMethod\x12G\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32+.google.cloud.scheduler.v1.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12L\n\x07headers\x18\x04 \x03(\x0b\x32;.google.cloud.scheduler.v1.AppEngineHttpTarget.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xb0\x01\n\x0cPubsubTarget\x12\x12\n\ntopic_name\x18\x01 \x01(\t\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\x12K\n\nattributes\x18\x04 \x03(\x0b\x32\x37.google.cloud.scheduler.v1.PubsubTarget.AttributesEntry\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42r\n\x1d\x63om.google.cloud.scheduler.v1B\x0bTargetProtoP\x01ZBgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1;schedulerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+    ],
+)
+
+_HTTPMETHOD = _descriptor.EnumDescriptor(
+    name="HttpMethod",
+    full_name="google.cloud.scheduler.v1.HttpMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GET", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEAD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PATCH", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OPTIONS", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1203,
+    serialized_end=1318,
+)
+_sym_db.RegisterEnumDescriptor(_HTTPMETHOD)
+
+HttpMethod = enum_type_wrapper.EnumTypeWrapper(_HTTPMETHOD)
+HTTP_METHOD_UNSPECIFIED = 0
+POST = 1
+GET = 2
+HEAD = 3
+PUT = 4
+DELETE = 5
+PATCH = 6
+OPTIONS = 7
+
+
+_HTTPTARGET_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.scheduler.v1.HttpTarget.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.scheduler.v1.HttpTarget.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.scheduler.v1.HttpTarget.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=425,
+    serialized_end=471,
+)
+
+_HTTPTARGET = _descriptor.Descriptor(
+    name="HttpTarget",
+    full_name="google.cloud.scheduler.v1.HttpTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.scheduler.v1.HttpTarget.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.scheduler.v1.HttpTarget.http_method",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.scheduler.v1.HttpTarget.headers",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.scheduler.v1.HttpTarget.body",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oauth_token",
+            full_name="google.cloud.scheduler.v1.HttpTarget.oauth_token",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oidc_token",
+            full_name="google.cloud.scheduler.v1.HttpTarget.oidc_token",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HTTPTARGET_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="authorization_header",
+            full_name="google.cloud.scheduler.v1.HttpTarget.authorization_header",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=133,
+    serialized_end=495,
+)
+
+
+_APPENGINEHTTPTARGET_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=425,
+    serialized_end=471,
+)
+
+_APPENGINEHTTPTARGET = _descriptor.Descriptor(
+    name="AppEngineHttpTarget",
+    full_name="google.cloud.scheduler.v1.AppEngineHttpTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.http_method",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.app_engine_routing",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_uri",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.relative_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.headers",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.scheduler.v1.AppEngineHttpTarget.body",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_APPENGINEHTTPTARGET_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=498,
+    serialized_end=814,
+)
+
+
+_PUBSUBTARGET_ATTRIBUTESENTRY = _descriptor.Descriptor(
+    name="AttributesEntry",
+    full_name="google.cloud.scheduler.v1.PubsubTarget.AttributesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.scheduler.v1.PubsubTarget.AttributesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.scheduler.v1.PubsubTarget.AttributesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=944,
+    serialized_end=993,
+)
+
+_PUBSUBTARGET = _descriptor.Descriptor(
+    name="PubsubTarget",
+    full_name="google.cloud.scheduler.v1.PubsubTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic_name",
+            full_name="google.cloud.scheduler.v1.PubsubTarget.topic_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.cloud.scheduler.v1.PubsubTarget.data",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.cloud.scheduler.v1.PubsubTarget.attributes",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PUBSUBTARGET_ATTRIBUTESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=817,
+    serialized_end=993,
+)
+
+
+_APPENGINEROUTING = _descriptor.Descriptor(
+    name="AppEngineRouting",
+    full_name="google.cloud.scheduler.v1.AppEngineRouting",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.cloud.scheduler.v1.AppEngineRouting.service",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.scheduler.v1.AppEngineRouting.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.scheduler.v1.AppEngineRouting.instance",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.scheduler.v1.AppEngineRouting.host",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=995,
+    serialized_end=1079,
+)
+
+
+_OAUTHTOKEN = _descriptor.Descriptor(
+    name="OAuthToken",
+    full_name="google.cloud.scheduler.v1.OAuthToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.cloud.scheduler.v1.OAuthToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="google.cloud.scheduler.v1.OAuthToken.scope",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1081,
+    serialized_end=1139,
+)
+
+
+_OIDCTOKEN = _descriptor.Descriptor(
+    name="OidcToken",
+    full_name="google.cloud.scheduler.v1.OidcToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.cloud.scheduler.v1.OidcToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audience",
+            full_name="google.cloud.scheduler.v1.OidcToken.audience",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1141,
+    serialized_end=1201,
+)
+
+_HTTPTARGET_HEADERSENTRY.containing_type = _HTTPTARGET
+_HTTPTARGET.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_HTTPTARGET.fields_by_name["headers"].message_type = _HTTPTARGET_HEADERSENTRY
+_HTTPTARGET.fields_by_name["oauth_token"].message_type = _OAUTHTOKEN
+_HTTPTARGET.fields_by_name["oidc_token"].message_type = _OIDCTOKEN
+_HTTPTARGET.oneofs_by_name["authorization_header"].fields.append(
+    _HTTPTARGET.fields_by_name["oauth_token"]
+)
+_HTTPTARGET.fields_by_name["oauth_token"].containing_oneof = _HTTPTARGET.oneofs_by_name[
+    "authorization_header"
+]
+_HTTPTARGET.oneofs_by_name["authorization_header"].fields.append(
+    _HTTPTARGET.fields_by_name["oidc_token"]
+)
+_HTTPTARGET.fields_by_name["oidc_token"].containing_oneof = _HTTPTARGET.oneofs_by_name[
+    "authorization_header"
+]
+_APPENGINEHTTPTARGET_HEADERSENTRY.containing_type = _APPENGINEHTTPTARGET
+_APPENGINEHTTPTARGET.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_APPENGINEHTTPTARGET.fields_by_name[
+    "app_engine_routing"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPTARGET.fields_by_name[
+    "headers"
+].message_type = _APPENGINEHTTPTARGET_HEADERSENTRY
+_PUBSUBTARGET_ATTRIBUTESENTRY.containing_type = _PUBSUBTARGET
+_PUBSUBTARGET.fields_by_name["attributes"].message_type = _PUBSUBTARGET_ATTRIBUTESENTRY
+DESCRIPTOR.message_types_by_name["HttpTarget"] = _HTTPTARGET
+DESCRIPTOR.message_types_by_name["AppEngineHttpTarget"] = _APPENGINEHTTPTARGET
+DESCRIPTOR.message_types_by_name["PubsubTarget"] = _PUBSUBTARGET
+DESCRIPTOR.message_types_by_name["AppEngineRouting"] = _APPENGINEROUTING
+DESCRIPTOR.message_types_by_name["OAuthToken"] = _OAUTHTOKEN
+DESCRIPTOR.message_types_by_name["OidcToken"] = _OIDCTOKEN
+DESCRIPTOR.enum_types_by_name["HttpMethod"] = _HTTPMETHOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+HttpTarget = _reflection.GeneratedProtocolMessageType(
+    "HttpTarget",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HTTPTARGET_HEADERSENTRY,
+                __module__="google.cloud.scheduler_v1.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.HttpTarget.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_HTTPTARGET,
+        __module__="google.cloud.scheduler_v1.proto.target_pb2",
+        __doc__="""Http target. The job will be pushed to the job handler by means of an
+  HTTP request via an
+  [http\_method][google.cloud.scheduler.v1.HttpTarget.http\_method] such
+  as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
+  response code in the range [200 - 299]. A failure to receive a response
+  constitutes a failed execution. For a redirected request, the response
+  returned by the redirected request is considered.
+  
+  
+  Attributes:
+      uri:
+          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 encode some characters for safety and
+          compatibility. The maximum allowed URL length is 2083
+          characters after encoding.
+      http_method:
+          Which HTTP method to use for the request.
+      headers:
+          The user can specify HTTP request headers to send with the
+          job's HTTP request. This map contains the header field names
+          and values. Repeated headers are not supported, but a header
+          value can contain commas. These headers represent a subset of
+          the headers that will accompany the job's HTTP request. Some
+          HTTP request headers will be ignored or replaced. A partial
+          list of headers that will be ignored or replaced is below: -
+          Host: This will be computed by Cloud Scheduler and derived
+          from [uri][google.cloud.scheduler.v1.HttpTarget.uri]. \*
+          ``Content-Length``: This will be computed by Cloud Scheduler.
+          \* ``User-Agent``: This will be set to ``"Google-Cloud-
+          Scheduler"``. \* ``X-Google-*``: Google internal use only. \*
+          ``X-AppEngine-*``: Google internal use only.  The total size
+          of headers must be less than 80KB.
+      body:
+          HTTP request body. A request body is allowed only if the HTTP
+          method is POST, PUT, or PATCH. It is an error to set body on a
+          job with an incompatible
+          [HttpMethod][google.cloud.scheduler.v1.HttpMethod].
+      authorization_header:
+          The mode for generating an ``Authorization`` header for HTTP
+          requests.  If specified, all ``Authorization`` headers in the 
+          [HttpTarget.headers][google.cloud.scheduler.v1.HttpTarget.head
+          ers] field will be overridden.
+      oauth_token:
+          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 be
+          used when sending requests to a GCP endpoint.
+      oidc_token:
+          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 should be used when sending
+          requests to third party endpoints or Cloud Run.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.HttpTarget)
+    ),
+)
+_sym_db.RegisterMessage(HttpTarget)
+_sym_db.RegisterMessage(HttpTarget.HeadersEntry)
+
+AppEngineHttpTarget = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpTarget",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPENGINEHTTPTARGET_HEADERSENTRY,
+                __module__="google.cloud.scheduler_v1.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.AppEngineHttpTarget.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_APPENGINEHTTPTARGET,
+        __module__="google.cloud.scheduler_v1.proto.target_pb2",
+        __doc__="""App Engine target. The job will be pushed to a job handler by means of
+  an HTTP request via an
+  [http\_method][google.cloud.scheduler.v1.AppEngineHttpTarget.http\_method]
+  such as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
+  HTTP response code in the range [200 - 299]. Error 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, constitutes a failed
+  attempt.
+  
+  
+  Attributes:
+      http_method:
+          The HTTP method to use for the request. PATCH and OPTIONS are
+          not permitted.
+      app_engine_routing:
+          App Engine Routing setting for the job.
+      relative_uri:
+          The relative URI.  The relative URL must begin with "/" and
+          must be a valid HTTP relative URL. It can contain a path,
+          query string arguments, and ``#`` fragments. If the relative
+          URL is empty, then the root path "/" will be used. No spaces
+          are allowed, and the maximum length allowed is 2083
+          characters.
+      headers:
+          HTTP request headers.  This map contains the header field
+          names and values. Headers can be set when the job is created.
+          Cloud Scheduler sets some headers to default values:  -
+          ``User-Agent``: By default, this header is    ``"AppEngine-
+          Google; (+http://code.google.com/appengine)"``. This    header
+          can be modified, but Cloud Scheduler will append
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"`` to
+          the    modified ``User-Agent``. -  ``X-CloudScheduler``: This
+          header will be set to true.  If the job has an
+          [body][google.cloud.scheduler.v1.AppEngineHttpTarget.body],
+          Cloud Scheduler sets the following headers:  -  ``Content-
+          Type``: By default, the ``Content-Type`` header is set to
+          ``"application/octet-stream"``. The default can be overridden
+          by    explictly setting ``Content-Type`` to a particular media
+          type when    the job is created. For example, ``Content-Type``
+          can be set to    ``"application/json"``. -  ``Content-
+          Length``: This is computed by Cloud Scheduler. This value
+          is output only. It cannot be changed.  The headers below are
+          output only. They cannot be set or overridden:  -
+          ``X-Google-*``: For Google internal use only. -
+          ``X-AppEngine-*``: For Google internal use only.  In addition,
+          some App Engine headers, which contain job-specific
+          information, are also be sent to the job handler.
+      body:
+          Body.  HTTP request body. A request body is allowed only if
+          the HTTP method is POST or PUT. It will result in invalid
+          argument error to set a body on a job with an incompatible
+          [HttpMethod][google.cloud.scheduler.v1.HttpMethod].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.AppEngineHttpTarget)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpTarget)
+_sym_db.RegisterMessage(AppEngineHttpTarget.HeadersEntry)
+
+PubsubTarget = _reflection.GeneratedProtocolMessageType(
+    "PubsubTarget",
+    (_message.Message,),
+    dict(
+        AttributesEntry=_reflection.GeneratedProtocolMessageType(
+            "AttributesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PUBSUBTARGET_ATTRIBUTESENTRY,
+                __module__="google.cloud.scheduler_v1.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.PubsubTarget.AttributesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PUBSUBTARGET,
+        __module__="google.cloud.scheduler_v1.proto.target_pb2",
+        __doc__="""Pub/Sub target. The job will be delivered by publishing a message to the
+  given Pub/Sub topic.
+  
+  
+  Attributes:
+      topic_name:
+          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/ref
+          erence/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.
+      data:
+          The message payload for PubsubMessage.  Pubsub message must
+          contain either non-empty data, or at least one attribute.
+      attributes:
+          Attributes for PubsubMessage.  Pubsub message must contain
+          either non-empty data, or at least one attribute.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.PubsubTarget)
+    ),
+)
+_sym_db.RegisterMessage(PubsubTarget)
+_sym_db.RegisterMessage(PubsubTarget.AttributesEntry)
+
+AppEngineRouting = _reflection.GeneratedProtocolMessageType(
+    "AppEngineRouting",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEROUTING,
+        __module__="google.cloud.scheduler_v1.proto.target_pb2",
+        __doc__="""App Engine Routing.
+  
+  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>`__,
+  `Microservices Architecture on Google App
+  Engine <https://cloud.google.com/appengine/docs/python/microservices-on-app-engine>`__,
+  `App Engine Standard request
+  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>`__.
+  
+  
+  Attributes:
+      service:
+          App service.  By default, the job is sent to the service which
+          is the default service when the job is attempted.
+      version:
+          App version.  By default, the job is sent to the version which
+          is the default version when the job is attempted.
+      instance:
+          App instance.  By default, the job is sent to an instance
+          which is available when the job is attempted.  Requests can
+          only be sent to a specific instance if `manual scaling is used
+          in App Engine Standard
+          <https://cloud.google.com/appengine/docs/python/an-overview-
+          of-app-engine?hl=en_US#scaling_types_and_instance_classes>`__.
+          App Engine Flex does not support instances. For more
+          information, see `App Engine Standard request 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>`__.
+      host:
+          Output only. The host that the job is sent to.  For more
+          information about how App Engine requests are routed, see
+          `here
+          <https://cloud.google.com/appengine/docs/standard/python/how-
+          requests-are-routed>`__.  The host is constructed as:  -
+          ``host = [application_domain_name]``\     ``| [service] + '.'
+          + [application_domain_name]``\     ``| [version] + '.' +
+          [application_domain_name]``\     ``| [version_dot_service]+
+          '.' + [application_domain_name]``\     ``| [instance] + '.' +
+          [application_domain_name]``\     ``| [instance_dot_service] +
+          '.' + [application_domain_name]``\     ``|
+          [instance_dot_version] + '.' + [application_domain_name]``\
+          ``| [instance_dot_version_dot_service] + '.' +
+          [application_domain_name]``  -  ``application_domain_name`` =
+          The domain name of the app, for example    .appspot.com, which
+          is associated with the job's project ID.  -  ``service =``
+          [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+          -  ``version =``
+          [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+          -  ``version_dot_service =``
+          [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+          ``+ '.' +``
+          [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+          -  ``instance =``    [instance][google.cloud.scheduler.v1.AppE
+          ngineRouting.instance]  -  ``instance_dot_service =``    [inst
+          ance][google.cloud.scheduler.v1.AppEngineRouting.instance]
+          ``+ '.' +``
+          [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+          -  ``instance_dot_version =``    [instance][google.cloud.sched
+          uler.v1.AppEngineRouting.instance]    ``+ '.' +``
+          [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+          -  ``instance_dot_version_dot_service =``    [instance][google
+          .cloud.scheduler.v1.AppEngineRouting.instance]    ``+ '.' +``
+          [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+          ``+ '.' +``
+          [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+          If
+          [service][google.cloud.scheduler.v1.AppEngineRouting.service]
+          is empty, then the job will be sent to the service which is
+          the default service when the job is attempted.  If
+          [version][google.cloud.scheduler.v1.AppEngineRouting.version]
+          is empty, then the job will be sent to the version which is
+          the default version when the job is attempted.  If [instance][
+          google.cloud.scheduler.v1.AppEngineRouting.instance] is empty,
+          then the job will be sent to an instance which is available
+          when the job is attempted.  If
+          [service][google.cloud.scheduler.v1.AppEngineRouting.service],
+          [version][google.cloud.scheduler.v1.AppEngineRouting.version],
+          or [instance][google.cloud.scheduler.v1.AppEngineRouting.insta
+          nce] is invalid, then the job will be sent to the default
+          version of the default service when the job is attempted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.AppEngineRouting)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineRouting)
+
+OAuthToken = _reflection.GeneratedProtocolMessageType(
+    "OAuthToken",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OAUTHTOKEN,
+        __module__="google.cloud.scheduler_v1.proto.target_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      service_account_email:
+          `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 job. The caller must have
+          iam.serviceAccounts.actAs permission for the service account.
+      scope:
+          OAuth scope to be used for generating OAuth access token. If
+          not specified, "https://www.googleapis.com/auth/cloud-
+          platform" will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.OAuthToken)
+    ),
+)
+_sym_db.RegisterMessage(OAuthToken)
+
+OidcToken = _reflection.GeneratedProtocolMessageType(
+    "OidcToken",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OIDCTOKEN,
+        __module__="google.cloud.scheduler_v1.proto.target_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      service_account_email:
+          `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 job. The caller must have
+          iam.serviceAccounts.actAs permission for the service account.
+      audience:
+          Audience to be used when generating OIDC token. If not
+          specified, the URI specified in target will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1.OidcToken)
+    ),
+)
+_sym_db.RegisterMessage(OidcToken)
+
+
+DESCRIPTOR._options = None
+_HTTPTARGET_HEADERSENTRY._options = None
+_APPENGINEHTTPTARGET_HEADERSENTRY._options = None
+_PUBSUBTARGET_ATTRIBUTESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/scheduler/google/cloud/scheduler_v1/proto/target_pb2_grpc.py b/scheduler/google/cloud/scheduler_v1/proto/target_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/proto/target_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/scheduler/google/cloud/scheduler_v1/types.py b/scheduler/google/cloud/scheduler_v1/types.py
new file mode 100644
index 000000000000..3f9516be7394
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1/types.py
@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.scheduler_v1.proto import cloudscheduler_pb2
+from google.cloud.scheduler_v1.proto import job_pb2
+from google.cloud.scheduler_v1.proto import target_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [cloudscheduler_pb2, job_pb2, target_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.scheduler_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/scheduler/google/cloud/scheduler_v1beta1/__init__.py b/scheduler/google/cloud/scheduler_v1beta1/__init__.py
new file mode 100644
index 000000000000..ba33236f1f82
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.scheduler_v1beta1 import types
+from google.cloud.scheduler_v1beta1.gapic import cloud_scheduler_client
+from google.cloud.scheduler_v1beta1.gapic import enums
+
+
+class CloudSchedulerClient(cloud_scheduler_client.CloudSchedulerClient):
+    __doc__ = cloud_scheduler_client.CloudSchedulerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudSchedulerClient")
diff --git a/scheduler/google/cloud/scheduler_v1beta1/gapic/__init__.py b/scheduler/google/cloud/scheduler_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/scheduler/google/cloud/scheduler_v1beta1/gapic/cloud_scheduler_client.py b/scheduler/google/cloud/scheduler_v1beta1/gapic/cloud_scheduler_client.py
new file mode 100644
index 000000000000..50879081907b
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/gapic/cloud_scheduler_client.py
@@ -0,0 +1,871 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.scheduler.v1beta1 CloudScheduler API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.scheduler_v1beta1.gapic import cloud_scheduler_client_config
+from google.cloud.scheduler_v1beta1.gapic import enums
+from google.cloud.scheduler_v1beta1.gapic.transports import (
+    cloud_scheduler_grpc_transport,
+)
+from google.cloud.scheduler_v1beta1.proto import cloudscheduler_pb2
+from google.cloud.scheduler_v1beta1.proto import cloudscheduler_pb2_grpc
+from google.cloud.scheduler_v1beta1.proto import job_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-scheduler"
+).version
+
+
+class CloudSchedulerClient(object):
+    """
+    The Cloud Scheduler API allows external entities to reliably
+    schedule asynchronous jobs.
+    """
+
+    SERVICE_ADDRESS = "cloudscheduler.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.scheduler.v1beta1.CloudScheduler"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudSchedulerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def job_path(cls, project, location, job):
+        """Return a fully-qualified job string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/jobs/{job}",
+            project=project,
+            location=location,
+            job=job,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudSchedulerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudSchedulerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_scheduler_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_scheduler_grpc_transport.CloudSchedulerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_scheduler_grpc_transport.CloudSchedulerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_jobs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists jobs.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_jobs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_jobs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+
+                The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.scheduler_v1beta1.types.Job` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_jobs,
+                default_retry=self._method_configs["ListJobs"].retry,
+                default_timeout=self._method_configs["ListJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.ListJobsRequest(parent=parent, page_size=page_size)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a job.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.get_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_job,
+                default_retry=self._method_configs["GetJob"].retry,
+                default_timeout=self._method_configs["GetJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.GetJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_job(
+        self,
+        parent,
+        job,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a job.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.create_job(parent, job)
+
+        Args:
+            parent (str): Required.
+
+                The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``.
+            job (Union[dict, ~google.cloud.scheduler_v1beta1.types.Job]): Required.
+
+                The job to add. The user can optionally specify a name for the job in
+                ``name``. ``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``) in the response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.scheduler_v1beta1.types.Job`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_job,
+                default_retry=self._method_configs["CreateJob"].retry,
+                default_timeout=self._method_configs["CreateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.CreateJobRequest(parent=parent, job=job)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_job(
+        self,
+        job,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a job.
+
+        If successful, the updated ``Job`` is returned. If the job does not
+        exist, ``NOT_FOUND`` is returned.
+
+        If UpdateJob does not successfully return, it is possible for the job to
+        be in an ``Job.State.UPDATE_FAILED`` state. A job in this state may not
+        be executed. If this happens, retry the UpdateJob request until a
+        successful response is received.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.update_job(job)
+
+        Args:
+            job (Union[dict, ~google.cloud.scheduler_v1beta1.types.Job]): Required.
+
+                The new job properties. ``name`` must be specified.
+
+                Output only fields cannot be modified using UpdateJob. Any value
+                specified for an output only field will be ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.scheduler_v1beta1.types.Job`
+            update_mask (Union[dict, ~google.cloud.scheduler_v1beta1.types.FieldMask]): A  mask used to specify which fields of the job are being updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.scheduler_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_job,
+                default_retry=self._method_configs["UpdateJob"].retry,
+                default_timeout=self._method_configs["UpdateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.UpdateJobRequest(job=job, update_mask=update_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("job.name", job.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a job.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> client.delete_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_job,
+                default_retry=self._method_configs["DeleteJob"].retry,
+                default_timeout=self._method_configs["DeleteJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.DeleteJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pause_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pauses a job.
+
+        If a job is paused then the system will stop executing the job until it
+        is re-enabled via ``ResumeJob``. The state of the job is stored in
+        ``state``; if paused it will be set to ``Job.State.PAUSED``. A job must
+        be in ``Job.State.ENABLED`` to be paused.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.pause_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pause_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "pause_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pause_job,
+                default_retry=self._method_configs["PauseJob"].retry,
+                default_timeout=self._method_configs["PauseJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.PauseJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["pause_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def resume_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Resume a job.
+
+        This method reenables a job after it has been ``Job.State.PAUSED``. The
+        state of a job is stored in ``Job.state``; after calling this method it
+        will be set to ``Job.State.ENABLED``. A job must be in
+        ``Job.State.PAUSED`` to be resumed.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.resume_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "resume_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "resume_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.resume_job,
+                default_retry=self._method_configs["ResumeJob"].retry,
+                default_timeout=self._method_configs["ResumeJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.ResumeJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["resume_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Forces a job to run now.
+
+        When this method is called, Cloud Scheduler will dispatch the job, even
+        if the job is already running.
+
+        Example:
+            >>> from google.cloud import scheduler_v1beta1
+            >>>
+            >>> client = scheduler_v1beta1.CloudSchedulerClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[LOCATION]', '[JOB]')
+            >>>
+            >>> response = client.run_job(name)
+
+        Args:
+            name (str): Required.
+
+                The job name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.scheduler_v1beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_job,
+                default_retry=self._method_configs["RunJob"].retry,
+                default_timeout=self._method_configs["RunJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudscheduler_pb2.RunJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/scheduler/google/cloud/scheduler_v1beta1/gapic/cloud_scheduler_client_config.py b/scheduler/google/cloud/scheduler_v1beta1/gapic/cloud_scheduler_client_config.py
new file mode 100644
index 000000000000..d972bce85f76
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/gapic/cloud_scheduler_client_config.py
@@ -0,0 +1,63 @@
+config = {
+    "interfaces": {
+        "google.cloud.scheduler.v1beta1.CloudScheduler": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListJobs": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PauseJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ResumeJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunJob": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/scheduler/google/cloud/scheduler_v1beta1/gapic/enums.py b/scheduler/google/cloud/scheduler_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..a1282aef95c5
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/gapic/enums.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class HttpMethod(enum.IntEnum):
+    """
+    The HTTP method used to execute the job.
+
+    Attributes:
+      HTTP_METHOD_UNSPECIFIED (int): HTTP method unspecified. Defaults to POST.
+      POST (int): HTTP POST
+      GET (int): HTTP GET
+      HEAD (int): HTTP HEAD
+      PUT (int): HTTP PUT
+      DELETE (int): HTTP DELETE
+      PATCH (int): HTTP PATCH
+      OPTIONS (int): HTTP OPTIONS
+    """
+
+    HTTP_METHOD_UNSPECIFIED = 0
+    POST = 1
+    GET = 2
+    HEAD = 3
+    PUT = 4
+    DELETE = 5
+    PATCH = 6
+    OPTIONS = 7
+
+
+class Job(object):
+    class State(enum.IntEnum):
+        """
+        State of the job.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          ENABLED (int): The job is executing normally.
+          PAUSED (int): The job is paused by the user. It will not execute. A user can
+          intentionally pause the job using ``PauseJobRequest``.
+          DISABLED (int): The job is disabled by the system due to error. The user
+          cannot directly set a job to be disabled.
+          UPDATE_FAILED (int): The job state resulting from a failed ``CloudScheduler.UpdateJob``
+          operation. To recover a job from this state, retry
+          ``CloudScheduler.UpdateJob`` until a successful response is received.
+        """
+
+        STATE_UNSPECIFIED = 0
+        ENABLED = 1
+        PAUSED = 2
+        DISABLED = 3
+        UPDATE_FAILED = 4
diff --git a/scheduler/google/cloud/scheduler_v1beta1/gapic/transports/__init__.py b/scheduler/google/cloud/scheduler_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/scheduler/google/cloud/scheduler_v1beta1/gapic/transports/cloud_scheduler_grpc_transport.py b/scheduler/google/cloud/scheduler_v1beta1/gapic/transports/cloud_scheduler_grpc_transport.py
new file mode 100644
index 000000000000..31f80e045d94
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/gapic/transports/cloud_scheduler_grpc_transport.py
@@ -0,0 +1,236 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.scheduler_v1beta1.proto import cloudscheduler_pb2_grpc
+
+
+class CloudSchedulerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.scheduler.v1beta1 CloudScheduler API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="cloudscheduler.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "cloud_scheduler_stub": cloudscheduler_pb2_grpc.CloudSchedulerStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudscheduler.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_jobs(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.list_jobs`.
+
+        Lists jobs.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].ListJobs
+
+    @property
+    def get_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.get_job`.
+
+        Gets a job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].GetJob
+
+    @property
+    def create_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.create_job`.
+
+        Creates a job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].CreateJob
+
+    @property
+    def update_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.update_job`.
+
+        Updates a job.
+
+        If successful, the updated ``Job`` is returned. If the job does not
+        exist, ``NOT_FOUND`` is returned.
+
+        If UpdateJob does not successfully return, it is possible for the job to
+        be in an ``Job.State.UPDATE_FAILED`` state. A job in this state may not
+        be executed. If this happens, retry the UpdateJob request until a
+        successful response is received.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].UpdateJob
+
+    @property
+    def delete_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.delete_job`.
+
+        Deletes a job.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].DeleteJob
+
+    @property
+    def pause_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.pause_job`.
+
+        Pauses a job.
+
+        If a job is paused then the system will stop executing the job until it
+        is re-enabled via ``ResumeJob``. The state of the job is stored in
+        ``state``; if paused it will be set to ``Job.State.PAUSED``. A job must
+        be in ``Job.State.ENABLED`` to be paused.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].PauseJob
+
+    @property
+    def resume_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.resume_job`.
+
+        Resume a job.
+
+        This method reenables a job after it has been ``Job.State.PAUSED``. The
+        state of a job is stored in ``Job.state``; after calling this method it
+        will be set to ``Job.State.ENABLED``. A job must be in
+        ``Job.State.PAUSED`` to be resumed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].ResumeJob
+
+    @property
+    def run_job(self):
+        """Return the gRPC stub for :meth:`CloudSchedulerClient.run_job`.
+
+        Forces a job to run now.
+
+        When this method is called, Cloud Scheduler will dispatch the job, even
+        if the job is already running.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_scheduler_stub"].RunJob
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/__init__.py b/scheduler/google/cloud/scheduler_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler.proto b/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler.proto
new file mode 100644
index 000000000000..4c1d9661839e
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler.proto
@@ -0,0 +1,237 @@
+// 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.scheduler.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+import "google/cloud/scheduler/v1beta1/job.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler";
+option java_multiple_files = true;
+option java_outer_classname = "SchedulerProto";
+option java_package = "com.google.cloud.scheduler.v1beta1";
+option objc_class_prefix = "SCHEDULER";
+
+// The Cloud Scheduler API allows external entities to reliably
+// schedule asynchronous jobs.
+service CloudScheduler {
+  // Lists jobs.
+  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/jobs"
+    };
+  }
+
+  // Gets a job.
+  rpc GetJob(GetJobRequest) returns (Job) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/jobs/*}"
+    };
+  }
+
+  // Creates a job.
+  rpc CreateJob(CreateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/jobs"
+      body: "job"
+    };
+  }
+
+  // Updates a job.
+  //
+  // If successful, the updated [Job][google.cloud.scheduler.v1beta1.Job] is returned. If the job does
+  // not exist, `NOT_FOUND` is returned.
+  //
+  // If UpdateJob does not successfully return, it is possible for the
+  // job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1beta1.Job.State.UPDATE_FAILED] state. A job in this state may
+  // not be executed. If this happens, retry the UpdateJob request
+  // until a successful response is received.
+  rpc UpdateJob(UpdateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{job.name=projects/*/locations/*/jobs/*}"
+      body: "job"
+    };
+  }
+
+  // Deletes a job.
+  rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/jobs/*}"
+    };
+  }
+
+  // Pauses a job.
+  //
+  // If a job is paused then the system will stop executing the job
+  // until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob]. The
+  // state of the job is stored in [state][google.cloud.scheduler.v1beta1.Job.state]; if paused it
+  // will be set to [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]
+  // to be paused.
+  rpc PauseJob(PauseJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/jobs/*}:pause"
+      body: "*"
+    };
+  }
+
+  // Resume a job.
+  //
+  // This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. The
+  // state of a job is stored in [Job.state][google.cloud.scheduler.v1beta1.Job.state]; after calling this method it
+  // will be set to [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]. A job must be in
+  // [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED] to be resumed.
+  rpc ResumeJob(ResumeJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/jobs/*}:resume"
+      body: "*"
+    };
+  }
+
+  // Forces a job to run now.
+  //
+  // When this method is called, Cloud Scheduler will dispatch the job, even
+  // if the job is already running.
+  rpc RunJob(RunJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/jobs/*}:run"
+      body: "*"
+    };
+  }
+}
+
+// Request message for listing jobs using [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs].
+message ListJobsRequest {
+  // Required.
+  //
+  // The location name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID`.
+  string parent = 1;
+
+  // Requested page size.
+  //
+  // The maximum page size is 500. If unspecified, the page size will
+  // be the maximum. Fewer jobs than requested might be returned,
+  // even if more jobs exist; use next_page_token to determine if more
+  // jobs exist.
+  int32 page_size = 5;
+
+  // A token identifying a page of results the server will 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.scheduler.v1beta1.ListJobsResponse.next_page_token] returned from
+  // the previous call to [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs]. It is an error to
+  // switch the value of [filter][google.cloud.scheduler.v1beta1.ListJobsRequest.filter] or
+  // [order_by][google.cloud.scheduler.v1beta1.ListJobsRequest.order_by] while iterating through pages.
+  string page_token = 6;
+}
+
+// Response message for listing jobs using [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs].
+message ListJobsResponse {
+  // The list of jobs.
+  repeated Job jobs = 1;
+
+  // A token to retrieve next page of results. Pass this value in the
+  // [page_token][google.cloud.scheduler.v1beta1.ListJobsRequest.page_token] field in the subsequent call to
+  // [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs] to retrieve the next page of results.
+  // If this is empty it indicates that there are no more results
+  // through which to paginate.
+  //
+  // The page token is valid for only 2 hours.
+  string next_page_token = 2;
+}
+
+// Request message for [GetJob][google.cloud.scheduler.v1beta1.CloudScheduler.GetJob].
+message GetJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// Request message for [CreateJob][google.cloud.scheduler.v1beta1.CloudScheduler.CreateJob].
+message CreateJobRequest {
+  // Required.
+  //
+  // The location name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID`.
+  string parent = 1;
+
+  // 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;
+}
+
+// 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.
+  //
+  // Output only fields cannot be modified using UpdateJob.
+  // Any value specified for an output only field will be ignored.
+  Job job = 1;
+
+  // A  mask used to specify which fields of the job are being updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for deleting a job using
+// [DeleteJob][google.cloud.scheduler.v1beta1.CloudScheduler.DeleteJob].
+message DeleteJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// Request message for [PauseJob][google.cloud.scheduler.v1beta1.CloudScheduler.PauseJob].
+message PauseJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// Request message for [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob].
+message ResumeJobRequest {
+  // Required.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
+
+// 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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  string name = 1;
+}
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler_pb2.py b/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler_pb2.py
new file mode 100644
index 000000000000..f85e45704dc3
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler_pb2.py
@@ -0,0 +1,834 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/scheduler_v1beta1/proto/cloudscheduler.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.scheduler_v1beta1.proto import (
+    job_pb2 as google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/scheduler_v1beta1/proto/cloudscheduler.proto",
+    package="google.cloud.scheduler.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.scheduler.v1beta1B\016SchedulerProtoP\001ZGgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler\242\002\tSCHEDULER'
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/scheduler_v1beta1/proto/cloudscheduler.proto\x12\x1egoogle.cloud.scheduler.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a.google/cloud/scheduler_v1beta1/proto/job.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"H\n\x0fListJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x05 \x01(\x05\x12\x12\n\npage_token\x18\x06 \x01(\t"^\n\x10ListJobsResponse\x12\x31\n\x04jobs\x18\x01 \x03(\x0b\x32#.google.cloud.scheduler.v1beta1.Job\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x1d\n\rGetJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"T\n\x10\x43reateJobRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x30\n\x03job\x18\x02 \x01(\x0b\x32#.google.cloud.scheduler.v1beta1.Job"u\n\x10UpdateJobRequest\x12\x30\n\x03job\x18\x01 \x01(\x0b\x32#.google.cloud.scheduler.v1beta1.Job\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask" \n\x10\x44\x65leteJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x1f\n\x0fPauseJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t" \n\x10ResumeJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x1d\n\rRunJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t2\x88\n\n\x0e\x43loudScheduler\x12\xa4\x01\n\x08ListJobs\x12/.google.cloud.scheduler.v1beta1.ListJobsRequest\x1a\x30.google.cloud.scheduler.v1beta1.ListJobsResponse"5\x82\xd3\xe4\x93\x02/\x12-/v1beta1/{parent=projects/*/locations/*}/jobs\x12\x93\x01\n\x06GetJob\x12-.google.cloud.scheduler.v1beta1.GetJobRequest\x1a#.google.cloud.scheduler.v1beta1.Job"5\x82\xd3\xe4\x93\x02/\x12-/v1beta1/{name=projects/*/locations/*/jobs/*}\x12\x9e\x01\n\tCreateJob\x12\x30.google.cloud.scheduler.v1beta1.CreateJobRequest\x1a#.google.cloud.scheduler.v1beta1.Job":\x82\xd3\xe4\x93\x02\x34"-/v1beta1/{parent=projects/*/locations/*}/jobs:\x03job\x12\xa2\x01\n\tUpdateJob\x12\x30.google.cloud.scheduler.v1beta1.UpdateJobRequest\x1a#.google.cloud.scheduler.v1beta1.Job">\x82\xd3\xe4\x93\x02\x38\x32\x31/v1beta1/{job.name=projects/*/locations/*/jobs/*}:\x03job\x12\x8c\x01\n\tDeleteJob\x12\x30.google.cloud.scheduler.v1beta1.DeleteJobRequest\x1a\x16.google.protobuf.Empty"5\x82\xd3\xe4\x93\x02/*-/v1beta1/{name=projects/*/locations/*/jobs/*}\x12\xa0\x01\n\x08PauseJob\x12/.google.cloud.scheduler.v1beta1.PauseJobRequest\x1a#.google.cloud.scheduler.v1beta1.Job">\x82\xd3\xe4\x93\x02\x38"3/v1beta1/{name=projects/*/locations/*/jobs/*}:pause:\x01*\x12\xa3\x01\n\tResumeJob\x12\x30.google.cloud.scheduler.v1beta1.ResumeJobRequest\x1a#.google.cloud.scheduler.v1beta1.Job"?\x82\xd3\xe4\x93\x02\x39"4/v1beta1/{name=projects/*/locations/*/jobs/*}:resume:\x01*\x12\x9a\x01\n\x06RunJob\x12-.google.cloud.scheduler.v1beta1.RunJobRequest\x1a#.google.cloud.scheduler.v1beta1.Job"<\x82\xd3\xe4\x93\x02\x36"1/v1beta1/{name=projects/*/locations/*/jobs/*}:run:\x01*B\x8b\x01\n"com.google.cloud.scheduler.v1beta1B\x0eSchedulerProtoP\x01ZGgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler\xa2\x02\tSCHEDULERb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTJOBSREQUEST = _descriptor.Descriptor(
+    name="ListJobsRequest",
+    full_name="google.cloud.scheduler.v1beta1.ListJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.scheduler.v1beta1.ListJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.scheduler.v1beta1.ListJobsRequest.page_size",
+            index=1,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.scheduler.v1beta1.ListJobsRequest.page_token",
+            index=2,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=261,
+    serialized_end=333,
+)
+
+
+_LISTJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListJobsResponse",
+    full_name="google.cloud.scheduler.v1beta1.ListJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.scheduler.v1beta1.ListJobsResponse.jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.scheduler.v1beta1.ListJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=335,
+    serialized_end=429,
+)
+
+
+_GETJOBREQUEST = _descriptor.Descriptor(
+    name="GetJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.GetJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1beta1.GetJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=431,
+    serialized_end=460,
+)
+
+
+_CREATEJOBREQUEST = _descriptor.Descriptor(
+    name="CreateJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.CreateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.scheduler.v1beta1.CreateJobRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.scheduler.v1beta1.CreateJobRequest.job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=462,
+    serialized_end=546,
+)
+
+
+_UPDATEJOBREQUEST = _descriptor.Descriptor(
+    name="UpdateJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.UpdateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.scheduler.v1beta1.UpdateJobRequest.job",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.scheduler.v1beta1.UpdateJobRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=548,
+    serialized_end=665,
+)
+
+
+_DELETEJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.DeleteJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1beta1.DeleteJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=667,
+    serialized_end=699,
+)
+
+
+_PAUSEJOBREQUEST = _descriptor.Descriptor(
+    name="PauseJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.PauseJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1beta1.PauseJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=701,
+    serialized_end=732,
+)
+
+
+_RESUMEJOBREQUEST = _descriptor.Descriptor(
+    name="ResumeJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.ResumeJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1beta1.ResumeJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=734,
+    serialized_end=766,
+)
+
+
+_RUNJOBREQUEST = _descriptor.Descriptor(
+    name="RunJobRequest",
+    full_name="google.cloud.scheduler.v1beta1.RunJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1beta1.RunJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=768,
+    serialized_end=797,
+)
+
+_LISTJOBSRESPONSE.fields_by_name[
+    "jobs"
+].message_type = google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB
+_CREATEJOBREQUEST.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+DESCRIPTOR.message_types_by_name["ListJobsRequest"] = _LISTJOBSREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsResponse"] = _LISTJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["GetJobRequest"] = _GETJOBREQUEST
+DESCRIPTOR.message_types_by_name["CreateJobRequest"] = _CREATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["UpdateJobRequest"] = _UPDATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["DeleteJobRequest"] = _DELETEJOBREQUEST
+DESCRIPTOR.message_types_by_name["PauseJobRequest"] = _PAUSEJOBREQUEST
+DESCRIPTOR.message_types_by_name["ResumeJobRequest"] = _RESUMEJOBREQUEST
+DESCRIPTOR.message_types_by_name["RunJobRequest"] = _RUNJOBREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for listing jobs using
+  [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs].
+  
+  
+  Attributes:
+      parent:
+          Required.  The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``.
+      page_size:
+          Requested page size.  The maximum page size is 500. If
+          unspecified, the page size will be the maximum. Fewer jobs
+          than requested might be returned, even if more jobs exist; use
+          next\_page\_token to determine if more jobs exist.
+      page_token:
+          A token identifying a page of results the server will 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.scheduler.v1beta1.Li
+          stJobsResponse.next\_page\_token] returned from the previous
+          call to [ListJobs][google.cloud.scheduler.v1beta1.CloudSchedul
+          er.ListJobs]. It is an error to switch the value of [filter][g
+          oogle.cloud.scheduler.v1beta1.ListJobsRequest.filter] or [orde
+          r\_by][google.cloud.scheduler.v1beta1.ListJobsRequest.order\_b
+          y] while iterating through pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.ListJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsRequest)
+
+ListJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSRESPONSE,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Response message for listing jobs using
+  [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs].
+  
+  
+  Attributes:
+      jobs:
+          The list of jobs.
+      next_page_token:
+          A token to retrieve next page of results. Pass this value in
+          the [page\_token][google.cloud.scheduler.v1beta1.ListJobsReque
+          st.page\_token] field in the subsequent call to [ListJobs][goo
+          gle.cloud.scheduler.v1beta1.CloudScheduler.ListJobs] to
+          retrieve the next page of results. If this is empty it
+          indicates that there are no more results through which to
+          paginate.  The page token is valid for only 2 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.ListJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsResponse)
+
+GetJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [GetJob][google.cloud.scheduler.v1beta1.CloudScheduler.GetJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.GetJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetJobRequest)
+
+CreateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [CreateJob][google.cloud.scheduler.v1beta1.CloudScheduler.CreateJob].
+  
+  
+  Attributes:
+      parent:
+          Required.  The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``.
+      job:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.CreateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateJobRequest)
+
+UpdateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [UpdateJob][google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob].
+  
+  
+  Attributes:
+      job:
+          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.
+      update_mask:
+          A mask used to specify which fields of the job are being
+          updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.UpdateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateJobRequest)
+
+DeleteJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for deleting a job using
+  [DeleteJob][google.cloud.scheduler.v1beta1.CloudScheduler.DeleteJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.DeleteJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteJobRequest)
+
+PauseJobRequest = _reflection.GeneratedProtocolMessageType(
+    "PauseJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAUSEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [PauseJob][google.cloud.scheduler.v1beta1.CloudScheduler.PauseJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.PauseJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(PauseJobRequest)
+
+ResumeJobRequest = _reflection.GeneratedProtocolMessageType(
+    "ResumeJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUMEJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for
+  [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.ResumeJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(ResumeJobRequest)
+
+RunJobRequest = _reflection.GeneratedProtocolMessageType(
+    "RunJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNJOBREQUEST,
+        __module__="google.cloud.scheduler_v1beta1.proto.cloudscheduler_pb2",
+        __doc__="""Request message for forcing a job to run now using
+  [RunJob][google.cloud.scheduler.v1beta1.CloudScheduler.RunJob].
+  
+  
+  Attributes:
+      name:
+          Required.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.RunJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunJobRequest)
+
+
+DESCRIPTOR._options = None
+
+_CLOUDSCHEDULER = _descriptor.ServiceDescriptor(
+    name="CloudScheduler",
+    full_name="google.cloud.scheduler.v1beta1.CloudScheduler",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=800,
+    serialized_end=2088,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListJobs",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs",
+            index=0,
+            containing_service=None,
+            input_type=_LISTJOBSREQUEST,
+            output_type=_LISTJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1beta1/{parent=projects/*/locations/*}/jobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.GetJob",
+            index=1,
+            containing_service=None,
+            input_type=_GETJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1beta1/{name=projects/*/locations/*/jobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.CreateJob",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0024"-/v1beta1/{parent=projects/*/locations/*}/jobs:\003job'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002821/v1beta1/{job.name=projects/*/locations/*/jobs/*}:\003job"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.DeleteJob",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002/*-/v1beta1/{name=projects/*/locations/*/jobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PauseJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.PauseJob",
+            index=5,
+            containing_service=None,
+            input_type=_PAUSEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0028"3/v1beta1/{name=projects/*/locations/*/jobs/*}:pause:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ResumeJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob",
+            index=6,
+            containing_service=None,
+            input_type=_RESUMEJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0029"4/v1beta1/{name=projects/*/locations/*/jobs/*}:resume:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunJob",
+            full_name="google.cloud.scheduler.v1beta1.CloudScheduler.RunJob",
+            index=7,
+            containing_service=None,
+            input_type=_RUNJOBREQUEST,
+            output_type=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\0026"1/v1beta1/{name=projects/*/locations/*/jobs/*}:run:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDSCHEDULER)
+
+DESCRIPTOR.services_by_name["CloudScheduler"] = _CLOUDSCHEDULER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler_pb2_grpc.py b/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler_pb2_grpc.py
new file mode 100644
index 000000000000..fca5a0d9d8ec
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/cloudscheduler_pb2_grpc.py
@@ -0,0 +1,196 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.scheduler_v1beta1.proto import (
+    cloudscheduler_pb2 as google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2,
+)
+from google.cloud.scheduler_v1beta1.proto import (
+    job_pb2 as google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class CloudSchedulerStub(object):
+    """The Cloud Scheduler API allows external entities to reliably
+  schedule asynchronous jobs.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListJobs = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/ListJobs",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.ListJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.ListJobsResponse.FromString,
+        )
+        self.GetJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/GetJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.GetJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.CreateJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/CreateJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.CreateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.UpdateJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/UpdateJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.UpdateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.DeleteJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/DeleteJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.DeleteJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.PauseJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/PauseJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.PauseJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.ResumeJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/ResumeJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.ResumeJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.RunJob = channel.unary_unary(
+            "/google.cloud.scheduler.v1beta1.CloudScheduler/RunJob",
+            request_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.RunJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+
+
+class CloudSchedulerServicer(object):
+    """The Cloud Scheduler API allows external entities to reliably
+  schedule asynchronous jobs.
+  """
+
+    def ListJobs(self, request, context):
+        """Lists jobs.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetJob(self, request, context):
+        """Gets a job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateJob(self, request, context):
+        """Creates a job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateJob(self, request, context):
+        """Updates a job.
+
+    If successful, the updated [Job][google.cloud.scheduler.v1beta1.Job] is returned. If the job does
+    not exist, `NOT_FOUND` is returned.
+
+    If UpdateJob does not successfully return, it is possible for the
+    job to be in an [Job.State.UPDATE_FAILED][google.cloud.scheduler.v1beta1.Job.State.UPDATE_FAILED] state. A job in this state may
+    not be executed. If this happens, retry the UpdateJob request
+    until a successful response is received.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteJob(self, request, context):
+        """Deletes a job.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PauseJob(self, request, context):
+        """Pauses a job.
+
+    If a job is paused then the system will stop executing the job
+    until it is re-enabled via [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob]. The
+    state of the job is stored in [state][google.cloud.scheduler.v1beta1.Job.state]; if paused it
+    will be set to [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. A job must be in [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]
+    to be paused.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ResumeJob(self, request, context):
+        """Resume a job.
+
+    This method reenables a job after it has been [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED]. The
+    state of a job is stored in [Job.state][google.cloud.scheduler.v1beta1.Job.state]; after calling this method it
+    will be set to [Job.State.ENABLED][google.cloud.scheduler.v1beta1.Job.State.ENABLED]. A job must be in
+    [Job.State.PAUSED][google.cloud.scheduler.v1beta1.Job.State.PAUSED] to be resumed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunJob(self, request, context):
+        """Forces a job to run now.
+
+    When this method is called, Cloud Scheduler will dispatch the job, even
+    if the job is already running.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudSchedulerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListJobs,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.ListJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.ListJobsResponse.SerializeToString,
+        ),
+        "GetJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.GetJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "CreateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.CreateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "UpdateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.UpdateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "DeleteJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.DeleteJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PauseJob": grpc.unary_unary_rpc_method_handler(
+            servicer.PauseJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.PauseJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "ResumeJob": grpc.unary_unary_rpc_method_handler(
+            servicer.ResumeJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.ResumeJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "RunJob": grpc.unary_unary_rpc_method_handler(
+            servicer.RunJob,
+            request_deserializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_cloudscheduler__pb2.RunJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.scheduler.v1beta1.CloudScheduler", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/job.proto b/scheduler/google/cloud/scheduler_v1beta1/proto/job.proto
new file mode 100644
index 000000000000..ddf910b03384
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/job.proto
@@ -0,0 +1,234 @@
+// 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.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";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler";
+option java_multiple_files = true;
+option java_outer_classname = "JobProto";
+option java_package = "com.google.cloud.scheduler.v1beta1";
+
+// Configuration for a job.
+// The maximum allowed size for a job is 100KB.
+message Job {
+  // State of the job.
+  enum State {
+    // Unspecified state.
+    STATE_UNSPECIFIED = 0;
+
+    // The job is executing normally.
+    ENABLED = 1;
+
+    // The job is paused by the user. It will not execute. A user can
+    // intentionally pause the job using
+    // [PauseJobRequest][google.cloud.scheduler.v1beta1.PauseJobRequest].
+    PAUSED = 2;
+
+    // The job is disabled by the system due to error. The user
+    // cannot directly set a job to be disabled.
+    DISABLED = 3;
+
+    // The job state resulting from a failed [CloudScheduler.UpdateJob][google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob]
+    // operation. To recover a job from this state, retry
+    // [CloudScheduler.UpdateJob][google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob] until a successful response is received.
+    UPDATE_FAILED = 4;
+  }
+
+  // Optionally caller-specified in [CreateJob][google.cloud.scheduler.v1beta1.CloudScheduler.CreateJob], after
+  // which it becomes output only.
+  //
+  // The job name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the job's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), or underscores (_). The maximum length is 500 characters.
+  string name = 1;
+
+  // Optionally caller-specified in [CreateJob][google.cloud.scheduler.v1beta1.CloudScheduler.CreateJob] or
+  // [UpdateJob][google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob].
+  //
+  // A human-readable description for the job. This string must not contain
+  // more than 500 characters.
+  string description = 2;
+
+  // Required.
+  //
+  // Delivery settings containing destination and parameters.
+  oneof target {
+    // Pub/Sub target.
+    PubsubTarget pubsub_target = 4;
+
+    // App Engine HTTP target.
+    AppEngineHttpTarget app_engine_http_target = 5;
+
+    // HTTP target.
+    HttpTarget http_target = 6;
+  }
+
+  // Required, except when used with [UpdateJob][google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob].
+  //
+  // Describes the schedule on which the job will be executed.
+  //
+  // The schedule can be either of the following types:
+  //
+  // * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview)
+  // * English-like
+  // [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules)
+  //
+  // As a general rule, execution `n + 1` of a job will not begin
+  // until execution `n` has finished. Cloud Scheduler will never
+  // allow two simultaneously outstanding executions. For example,
+  // this implies that if the `n+1`th execution is scheduled to run at
+  // 16:00 but the `n`th execution takes until 16:15, the `n+1`th
+  // execution will not start until `16:15`.
+  // A scheduled start time will be delayed if the previous
+  // execution has not ended when its scheduled time occurs.
+  //
+  // If [retry_count][google.cloud.scheduler.v1beta1.RetryConfig.retry_count] > 0 and a job attempt fails,
+  // the job will be tried a total of [retry_count][google.cloud.scheduler.v1beta1.RetryConfig.retry_count]
+  // times, with exponential backoff, until the next scheduled start
+  // time.
+  string schedule = 20;
+
+  // Specifies the time zone to be used in interpreting
+  // [schedule][google.cloud.scheduler.v1beta1.Job.schedule]. The value of this field must be a time
+  // zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database).
+  //
+  // Note that some time zones include a provision for
+  // daylight savings time. The rules for daylight saving time are
+  // determined by the chosen tz. For UTC use the string "utc". If a
+  // time zone is not specified, the default will be in UTC (also known
+  // as GMT).
+  string time_zone = 21;
+
+  // Output only. The creation time of the job.
+  google.protobuf.Timestamp user_update_time = 9;
+
+  // Output only. State of the job.
+  State state = 10;
+
+  // Output only. The response from the target for the last attempted execution.
+  google.rpc.Status status = 11;
+
+  // Output only. The next time the job is scheduled. Note that this may be a
+  // retry of a previously failed attempt or the next execution time
+  // according to the schedule.
+  google.protobuf.Timestamp schedule_time = 17;
+
+  // Output only. The time the last job attempt started.
+  google.protobuf.Timestamp last_attempt_time = 18;
+
+  // Settings that determine the retry behavior.
+  RetryConfig retry_config = 19;
+
+  // The deadline for job attempts. If the request handler does not respond by
+  // this deadline then the request is cancelled and the attempt is marked as a
+  // `DEADLINE_EXCEEDED` failure. The failed attempt can be viewed in
+  // execution logs. Cloud Scheduler will retry the job according
+  // to the [RetryConfig][google.cloud.scheduler.v1beta1.RetryConfig].
+  //
+  // The allowed duration for this deadline is:
+  //
+  // * For [HTTP targets][google.cloud.scheduler.v1beta1.Job.http_target], between 15 seconds and 30 minutes.
+  // * For [App Engine HTTP targets][google.cloud.scheduler.v1beta1.Job.app_engine_http_target], between 15
+  //   seconds and 24 hours.
+  // * For [PubSub targets][google.cloud.scheduler.v1beta1.Job.pubsub_target], this field is ignored.
+  google.protobuf.Duration attempt_deadline = 22;
+}
+
+// Settings that determine the retry behavior.
+//
+// By default, if a job does not complete successfully (meaning that
+// an acknowledgement is not received from the handler, then it will be retried
+// with exponential backoff according to the settings in [RetryConfig][google.cloud.scheduler.v1beta1.RetryConfig].
+message RetryConfig {
+  // The number of attempts that the system will make to run a job using the
+  // exponential backoff procedure described by
+  // [max_doublings][google.cloud.scheduler.v1beta1.RetryConfig.max_doublings].
+  //
+  // The default value of retry_count is zero.
+  //
+  // If retry_count is zero, a job attempt will *not* be retried if
+  // it fails. Instead the Cloud Scheduler system will wait for the
+  // next scheduled execution time.
+  //
+  // If retry_count is set to a non-zero number then Cloud Scheduler
+  // will retry failed attempts, using exponential backoff,
+  // retry_count times, or until the next scheduled execution time,
+  // whichever comes first.
+  //
+  // Values greater than 5 and negative values are not allowed.
+  int32 retry_count = 1;
+
+  // The time limit for retrying a failed job, measured from time when an
+  // execution was first attempted. If specified with
+  // [retry_count][google.cloud.scheduler.v1beta1.RetryConfig.retry_count], the job will be retried until both
+  // limits are reached.
+  //
+  // The default value for max_retry_duration is zero, which means retry
+  // duration is unlimited.
+  google.protobuf.Duration max_retry_duration = 2;
+
+  // The minimum amount of time to wait before retrying a job after
+  // it fails.
+  //
+  // The default value of this field is 5 seconds.
+  google.protobuf.Duration min_backoff_duration = 3;
+
+  // The maximum amount of time to wait before retrying a job after
+  // it fails.
+  //
+  // The default value of this field is 1 hour.
+  google.protobuf.Duration max_backoff_duration = 4;
+
+  // The time between retries will double `max_doublings` times.
+  //
+  // A job's retry interval starts at
+  // [min_backoff_duration][google.cloud.scheduler.v1beta1.RetryConfig.min_backoff_duration], then doubles
+  // `max_doublings` times, then increases linearly, and finally
+  // retries retries at intervals of
+  // [max_backoff_duration][google.cloud.scheduler.v1beta1.RetryConfig.max_backoff_duration] up to
+  // [retry_count][google.cloud.scheduler.v1beta1.RetryConfig.retry_count] times.
+  //
+  // For example, if [min_backoff_duration][google.cloud.scheduler.v1beta1.RetryConfig.min_backoff_duration] is
+  // 10s, [max_backoff_duration][google.cloud.scheduler.v1beta1.RetryConfig.max_backoff_duration] is 300s, and
+  // `max_doublings` is 3, then the a job will first be retried in 10s. The
+  // retry interval will double three times, and then increase linearly by
+  // 2^3 * 10s.  Finally, the job will retry at intervals of
+  // [max_backoff_duration][google.cloud.scheduler.v1beta1.RetryConfig.max_backoff_duration] until the job has
+  // been attempted [retry_count][google.cloud.scheduler.v1beta1.RetryConfig.retry_count] times. Thus, the
+  // requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....
+  //
+  // The default value of this field is 5.
+  int32 max_doublings = 5;
+}
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/job_pb2.py b/scheduler/google/cloud/scheduler_v1beta1/proto/job_pb2.py
new file mode 100644
index 000000000000..0536ae370635
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/job_pb2.py
@@ -0,0 +1,706 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/scheduler_v1beta1/proto/job.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.scheduler_v1beta1.proto import (
+    target_pb2 as google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/scheduler_v1beta1/proto/job.proto",
+    package="google.cloud.scheduler.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.scheduler.v1beta1B\010JobProtoP\001ZGgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler'
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/scheduler_v1beta1/proto/job.proto\x12\x1egoogle.cloud.scheduler.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a\x31google/cloud/scheduler_v1beta1/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\x88\x06\n\x03Job\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x45\n\rpubsub_target\x18\x04 \x01(\x0b\x32,.google.cloud.scheduler.v1beta1.PubsubTargetH\x00\x12U\n\x16\x61pp_engine_http_target\x18\x05 \x01(\x0b\x32\x33.google.cloud.scheduler.v1beta1.AppEngineHttpTargetH\x00\x12\x41\n\x0bhttp_target\x18\x06 \x01(\x0b\x32*.google.cloud.scheduler.v1beta1.HttpTargetH\x00\x12\x10\n\x08schedule\x18\x14 \x01(\t\x12\x11\n\ttime_zone\x18\x15 \x01(\t\x12\x34\n\x10user_update_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x38\n\x05state\x18\n \x01(\x0e\x32).google.cloud.scheduler.v1beta1.Job.State\x12"\n\x06status\x18\x0b \x01(\x0b\x32\x12.google.rpc.Status\x12\x31\n\rschedule_time\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11last_attempt_time\x18\x12 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x41\n\x0cretry_config\x18\x13 \x01(\x0b\x32+.google.cloud.scheduler.v1beta1.RetryConfig\x12\x33\n\x10\x61ttempt_deadline\x18\x16 \x01(\x0b\x32\x19.google.protobuf.Duration"X\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x45NABLED\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03\x12\x11\n\rUPDATE_FAILED\x10\x04\x42\x08\n\x06target"\xe2\x01\n\x0bRetryConfig\x12\x13\n\x0bretry_count\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x37\n\x14min_backoff_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x37\n\x14max_backoff_duration\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05\x42y\n"com.google.cloud.scheduler.v1beta1B\x08JobProtoP\x01ZGgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;schedulerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_JOB_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.scheduler.v1beta1.Job.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENABLED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATE_FAILED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=959,
+    serialized_end=1047,
+)
+_sym_db.RegisterEnumDescriptor(_JOB_STATE)
+
+
+_JOB = _descriptor.Descriptor(
+    name="Job",
+    full_name="google.cloud.scheduler.v1beta1.Job",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.scheduler.v1beta1.Job.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.scheduler.v1beta1.Job.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pubsub_target",
+            full_name="google.cloud.scheduler.v1beta1.Job.pubsub_target",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_target",
+            full_name="google.cloud.scheduler.v1beta1.Job.app_engine_http_target",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_target",
+            full_name="google.cloud.scheduler.v1beta1.Job.http_target",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.scheduler.v1beta1.Job.schedule",
+            index=5,
+            number=20,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_zone",
+            full_name="google.cloud.scheduler.v1beta1.Job.time_zone",
+            index=6,
+            number=21,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_update_time",
+            full_name="google.cloud.scheduler.v1beta1.Job.user_update_time",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.scheduler.v1beta1.Job.state",
+            index=8,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.scheduler.v1beta1.Job.status",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.scheduler.v1beta1.Job.schedule_time",
+            index=10,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_attempt_time",
+            full_name="google.cloud.scheduler.v1beta1.Job.last_attempt_time",
+            index=11,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="retry_config",
+            full_name="google.cloud.scheduler.v1beta1.Job.retry_config",
+            index=12,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attempt_deadline",
+            full_name="google.cloud.scheduler.v1beta1.Job.attempt_deadline",
+            index=13,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_JOB_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target",
+            full_name="google.cloud.scheduler.v1beta1.Job.target",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=281,
+    serialized_end=1057,
+)
+
+
+_RETRYCONFIG = _descriptor.Descriptor(
+    name="RetryConfig",
+    full_name="google.cloud.scheduler.v1beta1.RetryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="retry_count",
+            full_name="google.cloud.scheduler.v1beta1.RetryConfig.retry_count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_retry_duration",
+            full_name="google.cloud.scheduler.v1beta1.RetryConfig.max_retry_duration",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_backoff_duration",
+            full_name="google.cloud.scheduler.v1beta1.RetryConfig.min_backoff_duration",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_backoff_duration",
+            full_name="google.cloud.scheduler.v1beta1.RetryConfig.max_backoff_duration",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_doublings",
+            full_name="google.cloud.scheduler.v1beta1.RetryConfig.max_doublings",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1060,
+    serialized_end=1286,
+)
+
+_JOB.fields_by_name[
+    "pubsub_target"
+].message_type = (
+    google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_target__pb2._PUBSUBTARGET
+)
+_JOB.fields_by_name[
+    "app_engine_http_target"
+].message_type = (
+    google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_target__pb2._APPENGINEHTTPTARGET
+)
+_JOB.fields_by_name[
+    "http_target"
+].message_type = (
+    google_dot_cloud_dot_scheduler__v1beta1_dot_proto_dot_target__pb2._HTTPTARGET
+)
+_JOB.fields_by_name[
+    "user_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name["state"].enum_type = _JOB_STATE
+_JOB.fields_by_name["status"].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_JOB.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "last_attempt_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name["retry_config"].message_type = _RETRYCONFIG
+_JOB.fields_by_name[
+    "attempt_deadline"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_JOB_STATE.containing_type = _JOB
+_JOB.oneofs_by_name["target"].fields.append(_JOB.fields_by_name["pubsub_target"])
+_JOB.fields_by_name["pubsub_target"].containing_oneof = _JOB.oneofs_by_name["target"]
+_JOB.oneofs_by_name["target"].fields.append(
+    _JOB.fields_by_name["app_engine_http_target"]
+)
+_JOB.fields_by_name["app_engine_http_target"].containing_oneof = _JOB.oneofs_by_name[
+    "target"
+]
+_JOB.oneofs_by_name["target"].fields.append(_JOB.fields_by_name["http_target"])
+_JOB.fields_by_name["http_target"].containing_oneof = _JOB.oneofs_by_name["target"]
+_RETRYCONFIG.fields_by_name[
+    "max_retry_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "min_backoff_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "max_backoff_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["Job"] = _JOB
+DESCRIPTOR.message_types_by_name["RetryConfig"] = _RETRYCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Job = _reflection.GeneratedProtocolMessageType(
+    "Job",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOB,
+        __module__="google.cloud.scheduler_v1beta1.proto.job_pb2",
+        __doc__="""Configuration for a job. The maximum allowed size for a job is 100KB.
+  
+  
+  Attributes:
+      name:
+          Optionally caller-specified in [CreateJob][google.cloud.schedu
+          ler.v1beta1.CloudScheduler.CreateJob], after which it becomes
+          output only.  The job name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID``.  -
+          ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`__ -  ``LOCATION_ID``
+          is the canonical ID for the job's location. The list    of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``JOB_ID`` can
+          contain only letters ([A-Za-z]), numbers ([0-9]),    hyphens
+          (-), or underscores (\_). The maximum length is 500
+          characters.
+      description:
+          Optionally caller-specified in [CreateJob][google.cloud.schedu
+          ler.v1beta1.CloudScheduler.CreateJob] or [UpdateJob][google.cl
+          oud.scheduler.v1beta1.CloudScheduler.UpdateJob].  A human-
+          readable description for the job. This string must not contain
+          more than 500 characters.
+      target:
+          Required.  Delivery settings containing destination and
+          parameters.
+      pubsub_target:
+          Pub/Sub target.
+      app_engine_http_target:
+          App Engine HTTP target.
+      http_target:
+          HTTP target.
+      schedule:
+          Required, except when used with [UpdateJob][google.cloud.sched
+          uler.v1beta1.CloudScheduler.UpdateJob].  Describes the
+          schedule on which the job will be executed.  The schedule can
+          be either of the following types:  -  `Crontab
+          <http://en.wikipedia.org/wiki/Cron#Overview>`__ -  English-
+          like    `schedule
+          <https://cloud.google.com/scheduler/docs/configuring/cron-job-
+          schedules>`__  As a general rule, execution ``n + 1`` of a job
+          will not begin until execution ``n`` has finished. Cloud
+          Scheduler will never allow two simultaneously outstanding
+          executions. For example, this implies that if the ``n+1``\ th
+          execution is scheduled to run at 16:00 but the ``n``\ th
+          execution takes until 16:15, the ``n+1``\ th execution will
+          not start until ``16:15``. A scheduled start time will be
+          delayed if the previous execution has not ended when its
+          scheduled time occurs.  If [retry\_count][google.cloud.schedul
+          er.v1beta1.RetryConfig.retry\_count] > 0 and a job attempt
+          fails, the job will be tried a total of [retry\_count][google.
+          cloud.scheduler.v1beta1.RetryConfig.retry\_count] times, with
+          exponential backoff, until the next scheduled start time.
+      time_zone:
+          Specifies the time zone to be used in interpreting
+          [schedule][google.cloud.scheduler.v1beta1.Job.schedule]. The
+          value of this field must be a time zone name from the `tz
+          database <http://en.wikipedia.org/wiki/Tz_database>`__.  Note
+          that some time zones include a provision for daylight savings
+          time. The rules for daylight saving time are determined by the
+          chosen tz. For UTC use the string "utc". If a time zone is not
+          specified, the default will be in UTC (also known as GMT).
+      user_update_time:
+          Output only. The creation time of the job.
+      state:
+          Output only. State of the job.
+      status:
+          Output only. The response from the target for the last
+          attempted execution.
+      schedule_time:
+          Output only. The next time the job is scheduled. Note that
+          this may be a retry of a previously failed attempt or the next
+          execution time according to the schedule.
+      last_attempt_time:
+          Output only. The time the last job attempt started.
+      retry_config:
+          Settings that determine the retry behavior.
+      attempt_deadline:
+          The deadline for job attempts. If the request handler does not
+          respond by this deadline then the request is cancelled and the
+          attempt is marked as a ``DEADLINE_EXCEEDED`` failure. The
+          failed attempt can be viewed in execution logs. Cloud
+          Scheduler will retry the job according to the
+          [RetryConfig][google.cloud.scheduler.v1beta1.RetryConfig].
+          The allowed duration for this deadline is:  -  For [HTTP
+          targets][google.cloud.scheduler.v1beta1.Job.http\_target],
+          between 15 seconds and 30 minutes. -  For [App Engine HTTP    
+          targets][google.cloud.scheduler.v1beta1.Job.app\_engine\_http\
+          _target],    between 15 seconds and 24 hours. -  For [PubSub
+          targets][google.cloud.scheduler.v1beta1.Job.pubsub\_target],
+          this    field is ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.Job)
+    ),
+)
+_sym_db.RegisterMessage(Job)
+
+RetryConfig = _reflection.GeneratedProtocolMessageType(
+    "RetryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RETRYCONFIG,
+        __module__="google.cloud.scheduler_v1beta1.proto.job_pb2",
+        __doc__="""Settings that determine the retry behavior.
+  
+  By default, if a job does not complete successfully (meaning that an
+  acknowledgement is not received from the handler, then it will be
+  retried with exponential backoff according to the settings in
+  [RetryConfig][google.cloud.scheduler.v1beta1.RetryConfig].
+  
+  
+  Attributes:
+      retry_count:
+          The number of attempts that the system will make to run a job
+          using the exponential backoff procedure described by [max\_dou
+          blings][google.cloud.scheduler.v1beta1.RetryConfig.max\_doubli
+          ngs].  The default value of retry\_count is zero.  If
+          retry\_count is zero, a job attempt will *not* be retried if
+          it fails. Instead the Cloud Scheduler system will wait for the
+          next scheduled execution time.  If retry\_count is set to a
+          non-zero number then Cloud Scheduler will retry failed
+          attempts, using exponential backoff, retry\_count times, or
+          until the next scheduled execution time, whichever comes
+          first.  Values greater than 5 and negative values are not
+          allowed.
+      max_retry_duration:
+          The time limit for retrying a failed job, measured from time
+          when an execution was first attempted. If specified with [retr
+          y\_count][google.cloud.scheduler.v1beta1.RetryConfig.retry\_co
+          unt], the job will be retried until both limits are reached.
+          The default value for max\_retry\_duration is zero, which
+          means retry duration is unlimited.
+      min_backoff_duration:
+          The minimum amount of time to wait before retrying a job after
+          it fails.  The default value of this field is 5 seconds.
+      max_backoff_duration:
+          The maximum amount of time to wait before retrying a job after
+          it fails.  The default value of this field is 1 hour.
+      max_doublings:
+          The time between retries will double ``max_doublings`` times.
+          A job's retry interval starts at [min\_backoff\_duration][goog
+          le.cloud.scheduler.v1beta1.RetryConfig.min\_backoff\_duration]
+          , then doubles ``max_doublings`` times, then increases
+          linearly, and finally retries retries at intervals of [max\_ba
+          ckoff\_duration][google.cloud.scheduler.v1beta1.RetryConfig.ma
+          x\_backoff\_duration] up to [retry\_count][google.cloud.schedu
+          ler.v1beta1.RetryConfig.retry\_count] times.  For example, if 
+          [min\_backoff\_duration][google.cloud.scheduler.v1beta1.RetryC
+          onfig.min\_backoff\_duration] is 10s, [max\_backoff\_duration]
+          [google.cloud.scheduler.v1beta1.RetryConfig.max\_backoff\_dura
+          tion] is 300s, and ``max_doublings`` is 3, then the a job will
+          first be retried in 10s. The retry interval will double three
+          times, and then increase linearly by 2^3 \* 10s. Finally, the
+          job will retry at intervals of [max\_backoff\_duration][google
+          .cloud.scheduler.v1beta1.RetryConfig.max\_backoff\_duration]
+          until the job has been attempted [retry\_count][google.cloud.s
+          cheduler.v1beta1.RetryConfig.retry\_count] times. Thus, the
+          requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s,
+          300s, ....  The default value of this field is 5.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.RetryConfig)
+    ),
+)
+_sym_db.RegisterMessage(RetryConfig)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/job_pb2_grpc.py b/scheduler/google/cloud/scheduler_v1beta1/proto/job_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/job_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/target.proto b/scheduler/google/cloud/scheduler_v1beta1/proto/target.proto
new file mode 100644
index 000000000000..3bb44a1fb85d
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/target.proto
@@ -0,0 +1,348 @@
+// 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.scheduler.v1beta1;
+
+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;
+option java_outer_classname = "TargetProto";
+option java_package = "com.google.cloud.scheduler.v1beta1";
+
+// Http target. The job will be pushed to the job handler by means of
+// an HTTP request via an [http_method][google.cloud.scheduler.v1beta1.HttpTarget.http_method] such as HTTP
+// POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
+// response code in the range [200 - 299]. A failure to receive a response
+// 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
+  // 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
+  // encode some characters for safety and compatibility. The maximum allowed
+  // URL length is 2083 characters after encoding.
+  string uri = 1;
+
+  // Which HTTP method to use for the request.
+  HttpMethod http_method = 2;
+
+  // The user can specify HTTP request headers to send with the job's
+  // HTTP request. This map contains the header field names and
+  // values. Repeated headers are not supported, but a header value can
+  // contain commas. These headers represent a subset of the headers
+  // that will accompany the job's HTTP request. Some HTTP request
+  // headers will be ignored or replaced. A partial list of headers that
+  // will be ignored or replaced is below:
+  // - Host: This will be computed by Cloud Scheduler and derived from
+  // [uri][google.cloud.scheduler.v1beta1.HttpTarget.uri].
+  // * `Content-Length`: This will be computed by Cloud Scheduler.
+  // * `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`.
+  // * `X-Google-*`: Google internal use only.
+  // * `X-AppEngine-*`: Google internal use only.
+  //
+  // The total size of headers must be less than 80KB.
+  map<string, string> headers = 3;
+
+  // HTTP request body. A request body is allowed only if the HTTP
+  // method is POST, PUT, or PATCH. It is an error to set body on a job with an
+  // incompatible [HttpMethod][google.cloud.scheduler.v1beta1.HttpMethod].
+  bytes body = 4;
+
+  // The mode for generating an `Authorization` header for HTTP requests.
+  //
+  // If specified, all `Authorization` headers in the [HttpTarget.headers][google.cloud.scheduler.v1beta1.HttpTarget.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 be used when sending requests to a GCP
+    // endpoint.
+    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 should be used when sending requests to third
+    // party endpoints.
+    OidcToken oidc_token = 6;
+  }
+}
+
+// App Engine target. The job will be pushed to a job handler by means
+// of an HTTP request via an [http_method][google.cloud.scheduler.v1beta1.AppEngineHttpTarget.http_method] such
+// as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
+// HTTP response code in the range [200 - 299]. Error 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, constitutes a failed attempt.
+message AppEngineHttpTarget {
+  // The HTTP method to use for the request. PATCH and OPTIONS are not
+  // permitted.
+  HttpMethod http_method = 1;
+
+  // App Engine Routing setting for the job.
+  AppEngineRouting app_engine_routing = 2;
+
+  // The relative URI.
+  //
+  // The relative URL must begin with "/" and must be a valid HTTP relative URL.
+  // It can contain a path, query string arguments, and `#` fragments.
+  // If the relative URL is empty, then the root path "/" will be used.
+  // No spaces are allowed, and the maximum length allowed is 2083 characters.
+  string relative_uri = 3;
+
+  // HTTP request headers.
+  //
+  // This map contains the header field names and values. Headers can be set
+  // when the job is created.
+  //
+  // Cloud Scheduler sets some headers to default values:
+  //
+  // * `User-Agent`: By default, this header is
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+  //   This header can be modified, but Cloud Scheduler will append
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+  //   modified `User-Agent`.
+  // * `X-CloudScheduler`: This header will be set to true.
+  //
+  // If the job has an [body][google.cloud.scheduler.v1beta1.AppEngineHttpTarget.body], Cloud Scheduler sets
+  // the following headers:
+  //
+  // * `Content-Type`: By default, the `Content-Type` header is set to
+  //   `"application/octet-stream"`. The default can be overridden by explictly
+  //   setting `Content-Type` to a particular media type when the job is
+  //   created.
+  //   For example, `Content-Type` can be set to `"application/json"`.
+  // * `Content-Length`: This is computed by Cloud Scheduler. This value is
+  //   output only. It cannot be changed.
+  //
+  // The headers below are output only. They cannot be set or overridden:
+  //
+  // * `X-Google-*`: For Google internal use only.
+  // * `X-AppEngine-*`: For Google internal use only.
+  //
+  // In addition, some App Engine headers, which contain
+  // job-specific information, are also be sent to the job handler.
+  map<string, string> headers = 4;
+
+  // Body.
+  //
+  // HTTP request body. A request body is allowed only if the HTTP method is
+  // POST or PUT. It will result in invalid argument error to set a body on a
+  // job with an incompatible [HttpMethod][google.cloud.scheduler.v1beta1.HttpMethod].
+  bytes body = 5;
+}
+
+// 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
+  // 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;
+
+  // The message payload for PubsubMessage.
+  //
+  // Pubsub message must contain either non-empty data, or at least one
+  // attribute.
+  bytes data = 3;
+
+  // Attributes for PubsubMessage.
+  //
+  // Pubsub message must contain either non-empty data, or at least one
+  // attribute.
+  map<string, string> attributes = 4;
+}
+
+// App Engine Routing.
+//
+// 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),
+// [Microservices Architecture on Google App
+// Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+// [App Engine Standard request
+// 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).
+message AppEngineRouting {
+  // App service.
+  //
+  // By default, the job is sent to the service which is the default
+  // service when the job is attempted.
+  string service = 1;
+
+  // App version.
+  //
+  // By default, the job is sent to the version which is the default
+  // version when the job is attempted.
+  string version = 2;
+
+  // App instance.
+  //
+  // By default, the job is sent to an instance which is available when
+  // the job is attempted.
+  //
+  // Requests can only be sent to a specific instance if
+  // [manual scaling is used in App Engine
+  // Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+  // App Engine Flex does not support instances. For more information, see
+  // [App Engine Standard request
+  // 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).
+  string instance = 3;
+
+  // Output only. The host that the job is sent to.
+  //
+  // For more information about how App Engine requests are routed, see
+  // [here](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+  //
+  // The host is constructed as:
+  //
+  //
+  // * `host = [application_domain_name]`</br>
+  //   `| [service] + '.' + [application_domain_name]`</br>
+  //   `| [version] + '.' + [application_domain_name]`</br>
+  //   `| [version_dot_service]+ '.' + [application_domain_name]`</br>
+  //   `| [instance] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_service] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_version] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_version_dot_service] + '.' + [application_domain_name]`
+  //
+  // * `application_domain_name` = The domain name of the app, for
+  //   example <app-id>.appspot.com, which is associated with the
+  //   job's project ID.
+  //
+  // * `service =` [service][google.cloud.scheduler.v1beta1.AppEngineRouting.service]
+  //
+  // * `version =` [version][google.cloud.scheduler.v1beta1.AppEngineRouting.version]
+  //
+  // * `version_dot_service =`
+  //   [version][google.cloud.scheduler.v1beta1.AppEngineRouting.version] `+ '.' +`
+  //   [service][google.cloud.scheduler.v1beta1.AppEngineRouting.service]
+  //
+  // * `instance =` [instance][google.cloud.scheduler.v1beta1.AppEngineRouting.instance]
+  //
+  // * `instance_dot_service =`
+  //   [instance][google.cloud.scheduler.v1beta1.AppEngineRouting.instance] `+ '.' +`
+  //   [service][google.cloud.scheduler.v1beta1.AppEngineRouting.service]
+  //
+  // * `instance_dot_version =`
+  //   [instance][google.cloud.scheduler.v1beta1.AppEngineRouting.instance] `+ '.' +`
+  //   [version][google.cloud.scheduler.v1beta1.AppEngineRouting.version]
+  //
+  // * `instance_dot_version_dot_service =`
+  //   [instance][google.cloud.scheduler.v1beta1.AppEngineRouting.instance] `+ '.' +`
+  //   [version][google.cloud.scheduler.v1beta1.AppEngineRouting.version] `+ '.' +`
+  //   [service][google.cloud.scheduler.v1beta1.AppEngineRouting.service]
+  //
+  //
+  // If [service][google.cloud.scheduler.v1beta1.AppEngineRouting.service] is empty, then the job will be sent
+  // to the service which is the default service when the job is attempted.
+  //
+  // If [version][google.cloud.scheduler.v1beta1.AppEngineRouting.version] is empty, then the job will be sent
+  // to the version which is the default version when the job is attempted.
+  //
+  // If [instance][google.cloud.scheduler.v1beta1.AppEngineRouting.instance] is empty, then the job will be
+  // sent to an instance which is available when the job is attempted.
+  //
+  // If [service][google.cloud.scheduler.v1beta1.AppEngineRouting.service],
+  // [version][google.cloud.scheduler.v1beta1.AppEngineRouting.version], or
+  // [instance][google.cloud.scheduler.v1beta1.AppEngineRouting.instance] is invalid, then the job will be sent
+  // to the default version of the default service when the job is attempted.
+  string host = 4;
+}
+
+// The HTTP method used to execute the job.
+enum HttpMethod {
+  // HTTP method unspecified. Defaults to POST.
+  HTTP_METHOD_UNSPECIFIED = 0;
+
+  // HTTP POST
+  POST = 1;
+
+  // HTTP GET
+  GET = 2;
+
+  // HTTP HEAD
+  HEAD = 3;
+
+  // HTTP PUT
+  PUT = 4;
+
+  // HTTP DELETE
+  DELETE = 5;
+
+  // HTTP PATCH
+  PATCH = 6;
+
+  // HTTP OPTIONS
+  OPTIONS = 7;
+}
+
+// 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.
+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 job. 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 should be used when sending requests to third party
+// endpoints.
+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 job. 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/scheduler/google/cloud/scheduler_v1beta1/proto/target_pb2.py b/scheduler/google/cloud/scheduler_v1beta1/proto/target_pb2.py
new file mode 100644
index 000000000000..f44a902f973d
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/target_pb2.py
@@ -0,0 +1,1178 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/scheduler_v1beta1/proto/target.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/scheduler_v1beta1/proto/target.proto",
+    package="google.cloud.scheduler.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.scheduler.v1beta1B\013TargetProtoP\001ZGgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler'
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/scheduler_v1beta1/proto/target.proto\x12\x1egoogle.cloud.scheduler.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/protobuf/any.proto"\xfe\x02\n\nHttpTarget\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12?\n\x0bhttp_method\x18\x02 \x01(\x0e\x32*.google.cloud.scheduler.v1beta1.HttpMethod\x12H\n\x07headers\x18\x03 \x03(\x0b\x32\x37.google.cloud.scheduler.v1beta1.HttpTarget.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12\x41\n\x0boauth_token\x18\x05 \x01(\x0b\x32*.google.cloud.scheduler.v1beta1.OAuthTokenH\x00\x12?\n\noidc_token\x18\x06 \x01(\x0b\x32).google.cloud.scheduler.v1beta1.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"\xcb\x02\n\x13\x41ppEngineHttpTarget\x12?\n\x0bhttp_method\x18\x01 \x01(\x0e\x32*.google.cloud.scheduler.v1beta1.HttpMethod\x12L\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32\x30.google.cloud.scheduler.v1beta1.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12Q\n\x07headers\x18\x04 \x03(\x0b\x32@.google.cloud.scheduler.v1beta1.AppEngineHttpTarget.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\xb5\x01\n\x0cPubsubTarget\x12\x12\n\ntopic_name\x18\x01 \x01(\t\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\x12P\n\nattributes\x18\x04 \x03(\x0b\x32<.google.cloud.scheduler.v1beta1.PubsubTarget.AttributesEntry\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42|\n"com.google.cloud.scheduler.v1beta1B\x0bTargetProtoP\x01ZGgoogle.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;schedulerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+    ],
+)
+
+_HTTPMETHOD = _descriptor.EnumDescriptor(
+    name="HttpMethod",
+    full_name="google.cloud.scheduler.v1beta1.HttpMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GET", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEAD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PATCH", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OPTIONS", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1253,
+    serialized_end=1368,
+)
+_sym_db.RegisterEnumDescriptor(_HTTPMETHOD)
+
+HttpMethod = enum_type_wrapper.EnumTypeWrapper(_HTTPMETHOD)
+HTTP_METHOD_UNSPECIFIED = 0
+POST = 1
+GET = 2
+HEAD = 3
+PUT = 4
+DELETE = 5
+PATCH = 6
+OPTIONS = 7
+
+
+_HTTPTARGET_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.scheduler.v1beta1.HttpTarget.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=455,
+    serialized_end=501,
+)
+
+_HTTPTARGET = _descriptor.Descriptor(
+    name="HttpTarget",
+    full_name="google.cloud.scheduler.v1beta1.HttpTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.http_method",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.headers",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.body",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oauth_token",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.oauth_token",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oidc_token",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.oidc_token",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HTTPTARGET_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="authorization_header",
+            full_name="google.cloud.scheduler.v1beta1.HttpTarget.authorization_header",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=143,
+    serialized_end=525,
+)
+
+
+_APPENGINEHTTPTARGET_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=455,
+    serialized_end=501,
+)
+
+_APPENGINEHTTPTARGET = _descriptor.Descriptor(
+    name="AppEngineHttpTarget",
+    full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.http_method",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.app_engine_routing",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_uri",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.relative_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.headers",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineHttpTarget.body",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_APPENGINEHTTPTARGET_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=528,
+    serialized_end=859,
+)
+
+
+_PUBSUBTARGET_ATTRIBUTESENTRY = _descriptor.Descriptor(
+    name="AttributesEntry",
+    full_name="google.cloud.scheduler.v1beta1.PubsubTarget.AttributesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.scheduler.v1beta1.PubsubTarget.AttributesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.scheduler.v1beta1.PubsubTarget.AttributesEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=994,
+    serialized_end=1043,
+)
+
+_PUBSUBTARGET = _descriptor.Descriptor(
+    name="PubsubTarget",
+    full_name="google.cloud.scheduler.v1beta1.PubsubTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="topic_name",
+            full_name="google.cloud.scheduler.v1beta1.PubsubTarget.topic_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="data",
+            full_name="google.cloud.scheduler.v1beta1.PubsubTarget.data",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.cloud.scheduler.v1beta1.PubsubTarget.attributes",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PUBSUBTARGET_ATTRIBUTESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=862,
+    serialized_end=1043,
+)
+
+
+_APPENGINEROUTING = _descriptor.Descriptor(
+    name="AppEngineRouting",
+    full_name="google.cloud.scheduler.v1beta1.AppEngineRouting",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineRouting.service",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineRouting.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineRouting.instance",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.scheduler.v1beta1.AppEngineRouting.host",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1045,
+    serialized_end=1129,
+)
+
+
+_OAUTHTOKEN = _descriptor.Descriptor(
+    name="OAuthToken",
+    full_name="google.cloud.scheduler.v1beta1.OAuthToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.cloud.scheduler.v1beta1.OAuthToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="google.cloud.scheduler.v1beta1.OAuthToken.scope",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1131,
+    serialized_end=1189,
+)
+
+
+_OIDCTOKEN = _descriptor.Descriptor(
+    name="OidcToken",
+    full_name="google.cloud.scheduler.v1beta1.OidcToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.cloud.scheduler.v1beta1.OidcToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audience",
+            full_name="google.cloud.scheduler.v1beta1.OidcToken.audience",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1191,
+    serialized_end=1251,
+)
+
+_HTTPTARGET_HEADERSENTRY.containing_type = _HTTPTARGET
+_HTTPTARGET.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_HTTPTARGET.fields_by_name["headers"].message_type = _HTTPTARGET_HEADERSENTRY
+_HTTPTARGET.fields_by_name["oauth_token"].message_type = _OAUTHTOKEN
+_HTTPTARGET.fields_by_name["oidc_token"].message_type = _OIDCTOKEN
+_HTTPTARGET.oneofs_by_name["authorization_header"].fields.append(
+    _HTTPTARGET.fields_by_name["oauth_token"]
+)
+_HTTPTARGET.fields_by_name["oauth_token"].containing_oneof = _HTTPTARGET.oneofs_by_name[
+    "authorization_header"
+]
+_HTTPTARGET.oneofs_by_name["authorization_header"].fields.append(
+    _HTTPTARGET.fields_by_name["oidc_token"]
+)
+_HTTPTARGET.fields_by_name["oidc_token"].containing_oneof = _HTTPTARGET.oneofs_by_name[
+    "authorization_header"
+]
+_APPENGINEHTTPTARGET_HEADERSENTRY.containing_type = _APPENGINEHTTPTARGET
+_APPENGINEHTTPTARGET.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_APPENGINEHTTPTARGET.fields_by_name[
+    "app_engine_routing"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPTARGET.fields_by_name[
+    "headers"
+].message_type = _APPENGINEHTTPTARGET_HEADERSENTRY
+_PUBSUBTARGET_ATTRIBUTESENTRY.containing_type = _PUBSUBTARGET
+_PUBSUBTARGET.fields_by_name["attributes"].message_type = _PUBSUBTARGET_ATTRIBUTESENTRY
+DESCRIPTOR.message_types_by_name["HttpTarget"] = _HTTPTARGET
+DESCRIPTOR.message_types_by_name["AppEngineHttpTarget"] = _APPENGINEHTTPTARGET
+DESCRIPTOR.message_types_by_name["PubsubTarget"] = _PUBSUBTARGET
+DESCRIPTOR.message_types_by_name["AppEngineRouting"] = _APPENGINEROUTING
+DESCRIPTOR.message_types_by_name["OAuthToken"] = _OAUTHTOKEN
+DESCRIPTOR.message_types_by_name["OidcToken"] = _OIDCTOKEN
+DESCRIPTOR.enum_types_by_name["HttpMethod"] = _HTTPMETHOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+HttpTarget = _reflection.GeneratedProtocolMessageType(
+    "HttpTarget",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HTTPTARGET_HEADERSENTRY,
+                __module__="google.cloud.scheduler_v1beta1.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.HttpTarget.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_HTTPTARGET,
+        __module__="google.cloud.scheduler_v1beta1.proto.target_pb2",
+        __doc__="""Http target. The job will be pushed to the job handler by means of an
+  HTTP request via an
+  [http\_method][google.cloud.scheduler.v1beta1.HttpTarget.http\_method]
+  such as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
+  HTTP response code in the range [200 - 299]. A failure to receive a
+  response constitutes a failed execution. For a redirected request, the
+  response returned by the redirected request is considered.
+  
+  
+  Attributes:
+      uri:
+          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 encode some characters for safety and
+          compatibility. The maximum allowed URL length is 2083
+          characters after encoding.
+      http_method:
+          Which HTTP method to use for the request.
+      headers:
+          The user can specify HTTP request headers to send with the
+          job's HTTP request. This map contains the header field names
+          and values. Repeated headers are not supported, but a header
+          value can contain commas. These headers represent a subset of
+          the headers that will accompany the job's HTTP request. Some
+          HTTP request headers will be ignored or replaced. A partial
+          list of headers that will be ignored or replaced is below: -
+          Host: This will be computed by Cloud Scheduler and derived
+          from [uri][google.cloud.scheduler.v1beta1.HttpTarget.uri]. \*
+          ``Content-Length``: This will be computed by Cloud Scheduler.
+          \* ``User-Agent``: This will be set to ``"Google-Cloud-
+          Scheduler"``. \* ``X-Google-*``: Google internal use only. \*
+          ``X-AppEngine-*``: Google internal use only.  The total size
+          of headers must be less than 80KB.
+      body:
+          HTTP request body. A request body is allowed only if the HTTP
+          method is POST, PUT, or PATCH. It is an error to set body on a
+          job with an incompatible
+          [HttpMethod][google.cloud.scheduler.v1beta1.HttpMethod].
+      authorization_header:
+          The mode for generating an ``Authorization`` header for HTTP
+          requests.  If specified, all ``Authorization`` headers in the 
+          [HttpTarget.headers][google.cloud.scheduler.v1beta1.HttpTarget
+          .headers] field will be overridden.
+      oauth_token:
+          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 be
+          used when sending requests to a GCP endpoint.
+      oidc_token:
+          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 should be used when sending
+          requests to third party endpoints.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.HttpTarget)
+    ),
+)
+_sym_db.RegisterMessage(HttpTarget)
+_sym_db.RegisterMessage(HttpTarget.HeadersEntry)
+
+AppEngineHttpTarget = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpTarget",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPENGINEHTTPTARGET_HEADERSENTRY,
+                __module__="google.cloud.scheduler_v1beta1.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.AppEngineHttpTarget.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_APPENGINEHTTPTARGET,
+        __module__="google.cloud.scheduler_v1beta1.proto.target_pb2",
+        __doc__="""App Engine target. The job will be pushed to a job handler by means of
+  an HTTP request via an
+  [http\_method][google.cloud.scheduler.v1beta1.AppEngineHttpTarget.http\_method]
+  such as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
+  HTTP response code in the range [200 - 299]. Error 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, constitutes a failed
+  attempt.
+  
+  
+  Attributes:
+      http_method:
+          The HTTP method to use for the request. PATCH and OPTIONS are
+          not permitted.
+      app_engine_routing:
+          App Engine Routing setting for the job.
+      relative_uri:
+          The relative URI.  The relative URL must begin with "/" and
+          must be a valid HTTP relative URL. It can contain a path,
+          query string arguments, and ``#`` fragments. If the relative
+          URL is empty, then the root path "/" will be used. No spaces
+          are allowed, and the maximum length allowed is 2083
+          characters.
+      headers:
+          HTTP request headers.  This map contains the header field
+          names and values. Headers can be set when the job is created.
+          Cloud Scheduler sets some headers to default values:  -
+          ``User-Agent``: By default, this header is    ``"AppEngine-
+          Google; (+http://code.google.com/appengine)"``. This    header
+          can be modified, but Cloud Scheduler will append
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"`` to
+          the    modified ``User-Agent``. -  ``X-CloudScheduler``: This
+          header will be set to true.  If the job has an [body][google.c
+          loud.scheduler.v1beta1.AppEngineHttpTarget.body], Cloud
+          Scheduler sets the following headers:  -  ``Content-Type``: By
+          default, the ``Content-Type`` header is set to
+          ``"application/octet-stream"``. The default can be overridden
+          by    explictly setting ``Content-Type`` to a particular media
+          type when    the job is created. For example, ``Content-Type``
+          can be set to    ``"application/json"``. -  ``Content-
+          Length``: This is computed by Cloud Scheduler. This value
+          is output only. It cannot be changed.  The headers below are
+          output only. They cannot be set or overridden:  -
+          ``X-Google-*``: For Google internal use only. -
+          ``X-AppEngine-*``: For Google internal use only.  In addition,
+          some App Engine headers, which contain job-specific
+          information, are also be sent to the job handler.
+      body:
+          Body.  HTTP request body. A request body is allowed only if
+          the HTTP method is POST or PUT. It will result in invalid
+          argument error to set a body on a job with an incompatible
+          [HttpMethod][google.cloud.scheduler.v1beta1.HttpMethod].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.AppEngineHttpTarget)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpTarget)
+_sym_db.RegisterMessage(AppEngineHttpTarget.HeadersEntry)
+
+PubsubTarget = _reflection.GeneratedProtocolMessageType(
+    "PubsubTarget",
+    (_message.Message,),
+    dict(
+        AttributesEntry=_reflection.GeneratedProtocolMessageType(
+            "AttributesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PUBSUBTARGET_ATTRIBUTESENTRY,
+                __module__="google.cloud.scheduler_v1beta1.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.PubsubTarget.AttributesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PUBSUBTARGET,
+        __module__="google.cloud.scheduler_v1beta1.proto.target_pb2",
+        __doc__="""Pub/Sub target. The job will be delivered by publishing a message to the
+  given Pub/Sub topic.
+  
+  
+  Attributes:
+      topic_name:
+          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/ref
+          erence/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.
+      data:
+          The message payload for PubsubMessage.  Pubsub message must
+          contain either non-empty data, or at least one attribute.
+      attributes:
+          Attributes for PubsubMessage.  Pubsub message must contain
+          either non-empty data, or at least one attribute.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.PubsubTarget)
+    ),
+)
+_sym_db.RegisterMessage(PubsubTarget)
+_sym_db.RegisterMessage(PubsubTarget.AttributesEntry)
+
+AppEngineRouting = _reflection.GeneratedProtocolMessageType(
+    "AppEngineRouting",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEROUTING,
+        __module__="google.cloud.scheduler_v1beta1.proto.target_pb2",
+        __doc__="""App Engine Routing.
+  
+  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>`__,
+  `Microservices Architecture on Google App
+  Engine <https://cloud.google.com/appengine/docs/python/microservices-on-app-engine>`__,
+  `App Engine Standard request
+  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>`__.
+  
+  
+  Attributes:
+      service:
+          App service.  By default, the job is sent to the service which
+          is the default service when the job is attempted.
+      version:
+          App version.  By default, the job is sent to the version which
+          is the default version when the job is attempted.
+      instance:
+          App instance.  By default, the job is sent to an instance
+          which is available when the job is attempted.  Requests can
+          only be sent to a specific instance if `manual scaling is used
+          in App Engine Standard
+          <https://cloud.google.com/appengine/docs/python/an-overview-
+          of-app-engine?hl=en_US#scaling_types_and_instance_classes>`__.
+          App Engine Flex does not support instances. For more
+          information, see `App Engine Standard request 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>`__.
+      host:
+          Output only. The host that the job is sent to.  For more
+          information about how App Engine requests are routed, see
+          `here
+          <https://cloud.google.com/appengine/docs/standard/python/how-
+          requests-are-routed>`__.  The host is constructed as:  -
+          ``host = [application_domain_name]``\     ``| [service] + '.'
+          + [application_domain_name]``\     ``| [version] + '.' +
+          [application_domain_name]``\     ``| [version_dot_service]+
+          '.' + [application_domain_name]``\     ``| [instance] + '.' +
+          [application_domain_name]``\     ``| [instance_dot_service] +
+          '.' + [application_domain_name]``\     ``|
+          [instance_dot_version] + '.' + [application_domain_name]``\
+          ``| [instance_dot_version_dot_service] + '.' +
+          [application_domain_name]``  -  ``application_domain_name`` =
+          The domain name of the app, for example    .appspot.com, which
+          is associated with the job's project ID.  -  ``service =``    
+          [service][google.cloud.scheduler.v1beta1.AppEngineRouting.serv
+          ice]  -  ``version =``    [version][google.cloud.scheduler.v1b
+          eta1.AppEngineRouting.version]  -  ``version_dot_service =``
+          [version][google.cloud.scheduler.v1beta1.AppEngineRouting.vers
+          ion]    ``+ '.' +``    [service][google.cloud.scheduler.v1beta
+          1.AppEngineRouting.service]  -  ``instance =``    [instance][g
+          oogle.cloud.scheduler.v1beta1.AppEngineRouting.instance]  -
+          ``instance_dot_service =``    [instance][google.cloud.schedule
+          r.v1beta1.AppEngineRouting.instance]    ``+ '.' +``    [servic
+          e][google.cloud.scheduler.v1beta1.AppEngineRouting.service]  -
+          ``instance_dot_version =``    [instance][google.cloud.schedule
+          r.v1beta1.AppEngineRouting.instance]    ``+ '.' +``    [versio
+          n][google.cloud.scheduler.v1beta1.AppEngineRouting.version]  -
+          ``instance_dot_version_dot_service =``    [instance][google.cl
+          oud.scheduler.v1beta1.AppEngineRouting.instance]    ``+ '.'
+          +``    [version][google.cloud.scheduler.v1beta1.AppEngineRouti
+          ng.version]    ``+ '.' +``    [service][google.cloud.scheduler
+          .v1beta1.AppEngineRouting.service]  If [service][google.cloud.
+          scheduler.v1beta1.AppEngineRouting.service] is empty, then the
+          job will be sent to the service which is the default service
+          when the job is attempted.  If [version][google.cloud.schedule
+          r.v1beta1.AppEngineRouting.version] is empty, then the job
+          will be sent to the version which is the default version when
+          the job is attempted.  If [instance][google.cloud.scheduler.v1
+          beta1.AppEngineRouting.instance] is empty, then the job will
+          be sent to an instance which is available when the job is
+          attempted.  If [service][google.cloud.scheduler.v1beta1.AppEng
+          ineRouting.service], [version][google.cloud.scheduler.v1beta1.
+          AppEngineRouting.version], or [instance][google.cloud.schedule
+          r.v1beta1.AppEngineRouting.instance] is invalid, then the job
+          will be sent to the default version of the default service
+          when the job is attempted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.AppEngineRouting)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineRouting)
+
+OAuthToken = _reflection.GeneratedProtocolMessageType(
+    "OAuthToken",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OAUTHTOKEN,
+        __module__="google.cloud.scheduler_v1beta1.proto.target_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      service_account_email:
+          `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 job. The caller must have
+          iam.serviceAccounts.actAs permission for the service account.
+      scope:
+          OAuth scope to be used for generating OAuth access token. If
+          not specified, "https://www.googleapis.com/auth/cloud-
+          platform" will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.OAuthToken)
+    ),
+)
+_sym_db.RegisterMessage(OAuthToken)
+
+OidcToken = _reflection.GeneratedProtocolMessageType(
+    "OidcToken",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OIDCTOKEN,
+        __module__="google.cloud.scheduler_v1beta1.proto.target_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      service_account_email:
+          `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 job. The caller must have
+          iam.serviceAccounts.actAs permission for the service account.
+      audience:
+          Audience to be used when generating OIDC token. If not
+          specified, the URI specified in target will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.scheduler.v1beta1.OidcToken)
+    ),
+)
+_sym_db.RegisterMessage(OidcToken)
+
+
+DESCRIPTOR._options = None
+_HTTPTARGET_HEADERSENTRY._options = None
+_APPENGINEHTTPTARGET_HEADERSENTRY._options = None
+_PUBSUBTARGET_ATTRIBUTESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/scheduler/google/cloud/scheduler_v1beta1/proto/target_pb2_grpc.py b/scheduler/google/cloud/scheduler_v1beta1/proto/target_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/proto/target_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/scheduler/google/cloud/scheduler_v1beta1/types.py b/scheduler/google/cloud/scheduler_v1beta1/types.py
new file mode 100644
index 000000000000..259dbb09c985
--- /dev/null
+++ b/scheduler/google/cloud/scheduler_v1beta1/types.py
@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.scheduler_v1beta1.proto import cloudscheduler_pb2
+from google.cloud.scheduler_v1beta1.proto import job_pb2
+from google.cloud.scheduler_v1beta1.proto import target_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [cloudscheduler_pb2, job_pb2, target_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.scheduler_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/scheduler/noxfile.py b/scheduler/noxfile.py
new file mode 100644
index 000000000000..3d92df19084f
--- /dev/null
+++ b/scheduler/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=80")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/scheduler/setup.cfg b/scheduler/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/scheduler/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/scheduler/setup.py b/scheduler/setup.py
new file mode 100644
index 000000000000..ca8f804d556a
--- /dev/null
+++ b/scheduler/setup.py
@@ -0,0 +1,84 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+# Package metadata.
+
+name = "google-cloud-scheduler"
+description = "Cloud Scheduler API API client library"
+version = "1.2.1"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/scheduler/synth.metadata b/scheduler/synth.metadata
new file mode 100644
index 000000000000..86c1219f85b7
--- /dev/null
+++ b/scheduler/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:36:15.641949Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "scheduler",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/scheduler/artman_cloudscheduler_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "scheduler",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/scheduler/artman_cloudscheduler_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/scheduler/synth.py b/scheduler/synth.py
new file mode 100644
index 000000000000..4855440ae90b
--- /dev/null
+++ b/scheduler/synth.py
@@ -0,0 +1,55 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ['v1beta1', 'v1']
+
+# ----------------------------------------------------------------------------
+# Generate scheduler GAPIC layer
+# ----------------------------------------------------------------------------
+
+for version in versions:
+	library = gapic.py_library(
+	    "scheduler",
+	    version,
+	    config_path=f"artman_cloudscheduler_{version}.yaml",
+	    artman_output_name=f"cloudscheduler-{version}",
+	    include_protos=True,
+	)
+
+	excludes = ["README.rst", "nox.py", "setup.py", "docs/conf.py", "docs/index.rst"]
+	s.move(library, excludes=excludes)
+
+	s.replace(
+	    f"google/cloud/scheduler_{version}/gapic/cloud_scheduler_client.py",
+	    "google-cloud-cloudscheduler",
+	    "google-cloud-scheduler",
+	)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=79, cov_level=80)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/scheduler/tests/system.py b/scheduler/tests/system.py
new file mode 100644
index 000000000000..6e4daabbebb5
--- /dev/null
+++ b/scheduler/tests/system.py
@@ -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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from google.cloud import scheduler_v1
+
+
+class TestSystemScheduler(object):
+    def test_create_job(self):
+        client = scheduler_v1.CloudSchedulerClient()
+        parent = client.location_path(os.environ.get("PROJECT_ID"), "us-central1")
+        client.list_jobs(parent)
diff --git a/scheduler/tests/unit/gapic/v1/test_cloud_scheduler_client_v1.py b/scheduler/tests/unit/gapic/v1/test_cloud_scheduler_client_v1.py
new file mode 100644
index 000000000000..18f368c74bf8
--- /dev/null
+++ b/scheduler/tests/unit/gapic/v1/test_cloud_scheduler_client_v1.py
@@ -0,0 +1,420 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import scheduler_v1
+from google.cloud.scheduler_v1.proto import cloudscheduler_pb2
+from google.cloud.scheduler_v1.proto import job_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudSchedulerClient(object):
+    def test_list_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        jobs_element = {}
+        jobs = [jobs_element]
+        expected_response = {"next_page_token": next_page_token, "jobs": jobs}
+        expected_response = cloudscheduler_pb2.ListJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_jobs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.ListJobsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_jobs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.get_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.GetJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.get_job(name)
+
+    def test_create_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        job = {}
+
+        response = client.create_job(parent, job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.CreateJobRequest(parent=parent, job=job)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.create_job(parent, job)
+
+    def test_update_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        job = {}
+        update_mask = {}
+
+        response = client.update_job(job, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.UpdateJobRequest(
+            job=job, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        job = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_job(job, update_mask)
+
+    def test_delete_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        client.delete_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.DeleteJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.delete_job(name)
+
+    def test_pause_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.pause_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.PauseJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pause_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.pause_job(name)
+
+    def test_resume_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.resume_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.ResumeJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_resume_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.resume_job(name)
+
+    def test_run_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.run_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.RunJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.run_job(name)
diff --git a/scheduler/tests/unit/gapic/v1beta1/test_cloud_scheduler_client_v1beta1.py b/scheduler/tests/unit/gapic/v1beta1/test_cloud_scheduler_client_v1beta1.py
new file mode 100644
index 000000000000..ed37e3e5e473
--- /dev/null
+++ b/scheduler/tests/unit/gapic/v1beta1/test_cloud_scheduler_client_v1beta1.py
@@ -0,0 +1,415 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import scheduler_v1beta1
+from google.cloud.scheduler_v1beta1.proto import cloudscheduler_pb2
+from google.cloud.scheduler_v1beta1.proto import job_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudSchedulerClient(object):
+    def test_list_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        jobs_element = {}
+        jobs = [jobs_element]
+        expected_response = {"next_page_token": next_page_token, "jobs": jobs}
+        expected_response = cloudscheduler_pb2.ListJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_jobs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.ListJobsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_jobs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.get_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.GetJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.get_job(name)
+
+    def test_create_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        job = {}
+
+        response = client.create_job(parent, job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.CreateJobRequest(parent=parent, job=job)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.create_job(parent, job)
+
+    def test_update_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        job = {}
+
+        response = client.update_job(job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.UpdateJobRequest(job=job)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.update_job(job)
+
+    def test_delete_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        client.delete_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.DeleteJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.delete_job(name)
+
+    def test_pause_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.pause_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.PauseJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pause_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.pause_job(name)
+
+    def test_resume_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.resume_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.ResumeJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_resume_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.resume_job(name)
+
+    def test_run_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        description = "description-1724546052"
+        schedule = "schedule-697920873"
+        time_zone = "timeZone36848094"
+        expected_response = {
+            "name": name_2,
+            "description": description,
+            "schedule": schedule,
+            "time_zone": time_zone,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        response = client.run_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudscheduler_pb2.RunJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = scheduler_v1beta1.CloudSchedulerClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[LOCATION]", "[JOB]")
+
+        with pytest.raises(CustomException):
+            client.run_job(name)
diff --git a/scripts/generate_json_docs.py b/scripts/generate_json_docs.py
deleted file mode 100644
index b7a569130529..000000000000
--- a/scripts/generate_json_docs.py
+++ /dev/null
@@ -1,657 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import argparse
-import cgi
-import doctest
-import inspect
-import json
-import os
-import shutil
-import types
-
-import pdoc
-from parinx.parser import parse_docstring
-from parinx.errors import MethodParsingException
-import six
-
-from verify_included_modules import get_public_modules
-
-
-_DOCSTRING_TEST_PARSER = doctest.DocTestParser()
-
-
-class Module(object):
-
-    def __init__(self, module_id, name, description=None,
-                 examples=None, methods=None, source=None):
-        self.module_id = module_id
-        self.name = name
-        self.description = description
-        self.examples = examples or []
-        self.methods = methods
-        self.source = source
-
-    @classmethod
-    def from_module_name(cls, name, base_path):
-        module = pdoc.Module(pdoc.import_module(name), allsubmodules=True)
-        methods = module.functions() + module.variables()
-        examples = []
-
-        if '__init__' in name:
-            snippets = get_snippet_examples(name.split('.')[1],
-                                            os.path.join(base_path, 'docs'))
-            examples.extend(snippets)
-
-        source_path = clean_source_path(module)
-
-        return cls(module_id=name,
-                   name=name.split('.')[-1].title(),
-                   description=module.docstring,
-                   examples=examples or [],
-                   methods=[Method.from_pdoc(m) for m in methods],
-                   source=source_path)
-
-    def to_dict(self):
-        return {'id': self.module_id,
-                'name': self.name,
-                'description': format_sphinx_doc(self.description),
-                'examples': self.examples,
-                'methods': [m.to_dict() for m in self.methods],
-                'source': self.source}
-
-
-class Klass(object):
-    def __init__(self, module_id, name, refname=None, description=None,
-                 examples=None, methods=None, source=None):
-        self.module_id = module_id
-        self.name = name
-        self.refname = refname
-        self.description = description
-        self.examples = examples or []
-        self.methods = methods
-        self.source = source
-
-    @classmethod
-    def from_class_name(cls, module, kls):
-        methods = kls.methods()
-
-        examples = []
-        source_path = clean_source_path(module)
-
-        return cls(module_id=kls.name,
-                   name=kls.name.split('.')[-1].title(),
-                   refname=module.refname,
-                   description=module.docstring,
-                   examples=examples,
-                   methods=[Method.from_pdoc(m) for m in methods],
-                   source=source_path)
-
-    def to_dict(self):
-        return {'id': '%s.%s' % (self.refname, self.name.lower()),
-                'name': self.name,
-                'description': format_sphinx_doc(self.description),
-                'examples': self.examples,
-                'methods': [m.to_dict() for m in self.methods],
-                'source': self.source}
-
-
-class Method(object):
-
-    def __init__(self, method_id, name, is_class, examples=None, params=None,
-                 exceptions=None, returns=None, source=None):
-        self.method_id = method_id
-        self.name = name
-        self.examples = examples or []
-        self.params = params or []
-        self.exceptions = exceptions or []
-        self.returns = returns or []
-        self.source = source or ''
-
-        if is_class:
-            self.type = 'constructor'
-        else:
-            self.type = 'instance'
-
-    def add_param(self, param):
-        self.params.append(param)
-
-    def add_example(self, example):
-        self.examples.append({'code': example})
-
-    def add_source_line(self, source_line):
-        self.source = source_line
-
-    def set_returns(self, return_types):
-        self.returns = [{'types': [return_types]}]
-
-    def to_dict(self):
-        return {'id': self.method_id,
-                'name': self.name,
-                'examples': self.examples,
-                'source': self.source,
-                'params': [p.to_dict() for p in self.params],
-                'exceptions': self.exceptions,
-                'returns': self.returns,
-                'type': self.type}
-
-    @classmethod
-    def from_pdoc(cls, element):
-        is_class = isinstance(element, pdoc.Class)
-        method = cls(element.refname, element.name, is_class)
-        components = element.refname.split('.')
-
-        mod = __import__(components[0])
-        for comp in components[1:]:
-            mod = getattr(mod, comp)
-
-        # Get method line number.
-        method.add_source_line(get_source_line_number(mod))
-
-        # Get method Examples.
-        examples = get_examples_from_docstring(element.docstring)
-        if examples:
-            method.add_example(examples)
-
-        if element.docstring:
-            if not isinstance(element, pdoc.Class) and element.cls:
-                klass = element.cls.cls
-            elif element.cls:
-                klass = element.cls
-            else:
-                klass = None
-
-            # Hack for old-style classes
-            if not str(klass).startswith('<'):
-                klass = '<class \'%s\'>' % (klass,)
-
-            try:
-                method_info = parse_docstring(element.docstring, klass)
-            except (MethodParsingException, IndexError):
-                return method
-
-            for name, data in method_info['arguments'].items():
-                param = Param.from_docstring_section(name, data)
-                method.add_param(param)
-
-            if method_info.get('return'):
-                if len(method_info['return']['type_name']) > 0:
-                    type_name = method_info.get('return').get('type_name')
-
-                    type_type = 'instance'
-                    if any(x.isupper() for x in type_name):
-                        type_type = 'constructor'
-
-                    type_markup = build_link_from_type(type_name, type_type)
-
-                    method.set_returns(type_markup)
-
-        return method
-
-
-class Param(object):
-
-    def __init__(self, name, description=None, param_types=None, optional=None,
-                 nullable=None):
-        self.name = name
-        self.description = description
-        self.param_types = param_types or []
-        self.optional = optional
-        self.nullable = nullable
-
-    def to_dict(self):
-        return {'name': self.name,
-                'description': process_words(self.description),
-                'types': build_link_from_list_of_types(self.param_types),
-                'optional': self.optional,
-                'nullable': self.nullable}
-
-    @classmethod
-    def from_docstring_section(cls, name, data):
-        param_types = build_link_from_type(data['type_name'])
-        return cls(name=name, description=data['description'],
-                   param_types=[param_types])
-
-
-def clean_type_name(type_name):
-    if type_name.lower().startswith('list of'):
-        type_name = (type_name.replace('list of', '')
-                     .replace('List of', ''))
-    type_name = (type_name.replace('`', '').replace('class', '')
-                 .replace(':', ''))
-    return type_name
-
-
-def build_link_from_list_of_types(type_names, object_type=None):
-    processed_types = []
-    for type_link in type_names:
-        type_link = clean_type_name(type_link)
-        processed_types.append(build_link_from_type(type_link, object_type))
-    return processed_types
-
-
-def build_link_from_type(type_name, object_type=None):
-    type_name = clean_type_name(type_name)
-
-    if not type_name.startswith('google.cloud'):
-        return type_name
-    doc_path = type_name
-
-    doc_path = '/'.join(doc_path.split('.')).lower()
-
-    type_markup = '<a data-custom-type="%s"' % doc_path
-    if object_type == 'instance':
-        type_markup += ' data-method="%s"' % type_name
-    type_markup += '>%s</a>' % (type_name,)
-
-    return type_markup
-
-
-def build_source(module, method):
-    if isinstance(module, (types.ModuleType, types.ClassType,
-                           types.MethodType, types.FunctionType,
-                           types.TracebackType, types.FrameType,
-                           types.CodeType, types.TypeType)):
-
-        _, line = inspect.getsourcelines(module)
-        source_path = clean_source_path(module)
-
-        if line:
-            source_path = source_path + '#L' + str(line)
-
-        method.add_source_line(source_path)
-
-        # Sketchy get examples from method docstring.
-        examples = []
-        for example in examples:
-            method.add_example(example)
-
-
-def build_toc_entry(title, toc_type):
-    return {
-        'title': title,
-        'type': toc_type
-    }
-
-
-def build_type(type_id, title, contents):
-    return {
-        'id': type_id,
-        'title': title,
-        'contents': contents
-    }
-
-
-def clean_source_path(module):
-    if isinstance(module, six.string_types):
-        source_id = module
-    elif hasattr(module, 'refname'):
-        source_id = module.refname
-    else:
-        source_id = inspect.getmodule(module).__name__
-    return '%s.py' % (source_id.replace('.', '/'),)
-
-
-def get_examples_from_docstring(doc_str):
-    """Parse doctest style code examples from a docstring."""
-    examples = _DOCSTRING_TEST_PARSER.get_examples(doc_str)
-    example_str = ''
-    for example in examples:
-        example_str += '%s' % (example.source,)
-        example_str += '%s' % (example.want,)
-
-    return cgi.escape(example_str)
-
-
-def get_source_line_number(module):
-    if isinstance(module, (types.ModuleType, types.ClassType,
-                           types.MethodType, types.FunctionType,
-                           types.TracebackType, types.FrameType,
-                           types.CodeType, types.TypeType)):
-
-        _, line = inspect.getsourcelines(module)
-        source_path = clean_source_path(module)
-
-        if line:
-            source_path = source_path + '#L' + str(line)
-        return source_path
-
-
-def process_code_blocks(doc):
-    blocks = []
-    index = 0
-
-    for line in doc.splitlines(True):
-        if len(blocks) - 1 < index:
-            blocks.append('')
-
-        if line.strip():
-            blocks[index] += line
-        else:
-            index += 1
-
-    formatted_blocks = []
-    for block in blocks:
-        is_code = False
-        if block.splitlines()[0].startswith('  '):
-            is_code = True
-
-        if is_code:
-            block = {'code': '<pre><code>%s</code></pre>' % (block,)}
-
-        formatted_blocks.append(block)
-    return formatted_blocks
-
-
-def format_sphinx_doc(doc):
-    doc = process_code_blocks(doc)
-    example_lines = ""
-    for line in doc:
-        if isinstance(line, dict):
-            line = line['code']
-        else:
-            line = process_words(line)
-        example_lines = '%s\n%s' % (example_lines, line)
-    return example_lines
-
-
-def process_words(line):
-    processed_line = ''
-    for word in line.split():
-        end_sentence = False
-        if word.endswith('.'):
-            end_sentence = True
-            word = word[:-1]
-
-        if word.startswith('``') and word.endswith('``'):
-            word = word.replace('``', '')
-            word = '<code>%s</code>' % (word,)
-
-        if word.startswith('**') and word.endswith('**'):
-            word = word.replace('**', '')
-            word = '<b>%s</b>' % (word,)
-
-        if word.startswith(':class:'):
-            word = word.replace(':class:', '').replace('`', '')
-            word = build_link_from_type(word)
-
-        if word.startswith(':mod:'):
-            word = word.replace(':mod:', '').replace('`', '')
-            word = build_link_from_type(word)
-
-        if word.startswith(':meth:'):
-            word = word.replace(':meth:', '').replace('`', '')
-            word = build_link_from_type(word)
-
-        if word.startswith(':func:'):
-            word = word.replace(':func:', '').replace('`', '')
-            word = build_link_from_type(word)
-
-        word = word.replace('`', '')
-
-        if word.startswith('https://') or word.startswith('http://'):
-            word = '<a href="%s">%s</a>' % (word, word)
-
-        if end_sentence:
-            word += '.'
-
-        processed_line += ' %s' % (word,)
-
-    processed_line = processed_line.replace('::', '')
-
-    return processed_line
-
-
-def write_docs_file(path, contents):
-    if not os.path.exists(os.path.dirname(path)):
-        try:
-            os.makedirs(os.path.dirname(path))
-        except OSError:
-            raise
-    with open(path, 'w') as output_file:
-        output_file.write(contents)
-
-
-def generate_doc_types_json(modules, types_file_path):
-    doc_types_list = [{
-        'id': 'google-cloud',
-        'contents': 'index.json',
-        'title': 'google-cloud'
-    }]
-
-    for module_name in modules:
-        if module_name == 'google.cloud.__init__':
-            continue
-
-        module_title = module_name.replace('.__init__', '').split('.')
-        module_contents = (module_name.replace('.', '/')
-                           .replace('__init__', 'index'))
-
-        if len(module_name.split('.')) > 2:
-            module_id = module_name.replace('.', '/')
-        else:
-            module_id = (module_name.replace('.', '/'))
-
-        module_contents += '.json'
-
-        doc_type_object = build_type(module_id.replace('/__init__', ''),
-                                     module_title, module_contents)
-
-        doc_types_list.append(doc_type_object)
-
-        pdoc_module = pdoc.Module(pdoc.import_module(module_name),
-                                  allsubmodules=True)
-        for c in pdoc_module.classes():
-            generate_doc_types_classes_json(c, doc_types_list)
-
-    write_docs_file(types_file_path,
-                    json.dumps(doc_types_list))
-
-
-def generate_doc_types_classes_json(klass, doc_types_list):
-
-    module_contents = (klass.refname.replace('.', '/')
-                       .replace('__init__', 'index'))
-    module_contents += '.json'
-
-    doc_type_object = build_type(klass.refname.lower().replace('.', '/'),
-                                 klass.refname.split('.'),
-                                 module_contents.lower())
-
-    doc_types_list.append(doc_type_object)
-
-
-def generate_module_docs(modules, docs_path, real_base_path, toc):
-    for module_name in modules:
-        module = Module.from_module_name(module_name, real_base_path)
-        pdoc_module = pdoc.Module(pdoc.import_module(module_name),
-                                  allsubmodules=True)
-        for c in pdoc_module.classes():
-            generate_class_docs(pdoc_module, c, docs_path, toc)
-
-        module_path = (module_name.replace('.', '/')
-                       .replace('__init__', 'index'))
-        module_docs_path = os.path.join(docs_path, module_path) + '.json'
-
-        if pdoc_module.functions():
-            toc_key = module_name.replace('google.cloud.', '').split('.')[0]
-            toc_entry = build_toc_entry(module.name, module_path)
-            toc['services'][toc_key].append(toc_entry)
-
-        write_docs_file(module_docs_path,
-                        json.dumps(module.to_dict(),
-                                   indent=2, sort_keys=True))
-
-
-def generate_class_docs(module, klass, base_path, toc):
-    kls = Klass.from_class_name(module, klass)
-
-    module_path = (module.refname.replace('.', '/')
-                   .replace('__init__', 'index'))
-    module_docs_path = os.path.join(base_path, module_path,
-                                    klass.name.lower()) + '.json'
-    toc_key = module.name.replace('google.cloud.', '').split('.')[0]
-
-    toc_entry = build_toc_entry(klass.name,
-                                os.path.join(module_path,
-                                             klass.name.lower()))
-
-    toc['services'][toc_key].append(toc_entry)
-
-    write_docs_file(module_docs_path,
-                    json.dumps(kls.to_dict(),
-                               indent=2, sort_keys=True))
-
-
-def get_snippet_examples(module, json_docs_dir):
-    snippets_file_path = os.path.join(json_docs_dir,
-                                      module + '_snippets.py')
-    usage_rst_path = os.path.join(json_docs_dir, module + '-usage.rst')
-
-    snippet_labels = {}
-
-    if os.path.isfile(usage_rst_path):
-        with open(usage_rst_path, 'r') as snippet_labels_file:
-            usage_rst = snippet_labels_file.read().splitlines()
-            line_index = 0
-
-            include_string = '.. literalinclude:: %s_snippets.py'
-            for line in usage_rst:
-                if line.startswith(include_string % module):
-                    label_key = (usage_rst[line_index + 1]
-                                 .replace('   :start-after: [START ', '')
-                                 .replace(']', ''))
-                    snippet_labels[label_key] = usage_rst[line_index - 2]
-                line_index += 1
-
-    snippets = []
-
-    if os.path.isfile(snippets_file_path):
-        with open(snippets_file_path, 'r') as snippets_file:
-            snippets_string = snippets_file.read()
-            label = None
-            snippet = ''
-            for line in snippets_string.splitlines(True):
-                if line.strip().startswith('# [END'):
-                    example = {
-                        'caption': snippet_labels.get(label),
-                        'code': snippet
-                    }
-                    snippets.append(example)
-
-                    # Reset for next snippet
-                    snippet = ''
-                    label = None
-
-                if label:
-                    snippet += line
-
-                if line.strip().startswith('# [START'):
-                    label = (line.replace('# [START', '').replace(']', '')
-                             .strip())
-                    snippet = '# %s\n' % label
-    return snippets
-
-
-def package_files(generated_json_dir, docs_build_dir, static_json_dir,
-                  tag='master'):
-    """Copy app and JSON files into a convenient place to deploy from.
-
-    Structure needs to be...
-    root
-        - src/
-            - images/
-            - app.js
-            - app.css
-            - vendor.js
-            - vendor.css
-        - json/
-            - master/
-                - toc.json
-                - types.json
-                - index.json
-                - overview.html
-            - home.html
-        - index.html
-        - manifest.json
-    """
-    package_path = os.path.join(docs_build_dir, 'json_build')
-    shutil.rmtree(package_path, ignore_errors=True)
-
-    shutil.copytree(static_json_dir, package_path)
-    shutil.copytree(os.path.join(generated_json_dir, 'google', 'cloud'),
-                    os.path.join(package_path, 'json', tag, 'google', 'cloud'))
-    shutil.copyfile(os.path.join(generated_json_dir, 'types.json'),
-                    os.path.join(package_path, 'json', tag, 'types.json'))
-
-
-def main():
-    parser = argparse.ArgumentParser(description='Document Python modules.')
-    parser.add_argument('--tag', help='The version of the documentation.',
-                        default='master')
-    parser.add_argument('--basepath', help='Path to the library.',
-                        default=os.path.join(os.path.dirname(__file__), '..'))
-    parser.add_argument('--show-toc', help='Prints partial table of contents',
-                        default=False)
-    args = parser.parse_args()
-
-    toc = {
-        'services': {
-            '__init__': [],
-            'google': [],
-            'cloud': [],
-            'bigquery': [],
-            'bigtable': [],
-            'client': [],
-            'connection': [],
-            'credentials': [],
-            'datastore': [],
-            'dns': [],
-            'environment_vars': [],
-            'error_reporting': [],
-            'exceptions': [],
-            'iterator': [],
-            'language': [],
-            'logging': [],
-            'monitoring': [],
-            'operation': [],
-            'pubsub': [],
-            'resource_manager': [],
-            'storage': [],
-            'streaming': [],
-            'translate': [],
-            'vision': [],
-        }
-    }
-
-    BASE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
-    BASE_JSON_DOCS_DIR = os.path.join(BASE_DIR, 'docs', 'json')
-
-    DOCS_BUILD_DIR = os.path.join(BASE_DIR, 'docs', '_build')
-    JSON_DOCS_DIR = os.path.join(DOCS_BUILD_DIR, 'json', args.tag)
-    LIB_DIR = os.path.abspath(args.basepath)
-
-    library_dir = os.path.join(LIB_DIR, 'google', 'cloud')
-    public_mods = get_public_modules(library_dir,
-                                     base_package='google.cloud')
-
-    generate_module_docs(public_mods, JSON_DOCS_DIR, BASE_DIR, toc)
-    generate_doc_types_json(public_mods,
-                            os.path.join(JSON_DOCS_DIR, 'types.json'))
-    package_files(JSON_DOCS_DIR, DOCS_BUILD_DIR, BASE_JSON_DOCS_DIR)
-    if args.show_toc:
-        print json.dumps(toc, indent=4)
-
-if __name__ == '__main__':
-    main()
diff --git a/scripts/get_version.py b/scripts/get_version.py
deleted file mode 100644
index 78a146d45041..000000000000
--- a/scripts/get_version.py
+++ /dev/null
@@ -1,19 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Simple script to get the google-cloud version."""
-
-from __future__ import print_function
-from pkg_resources import get_distribution
-print(get_distribution('google-cloud').version)
diff --git a/scripts/make_datastore_grpc.py b/scripts/make_datastore_grpc.py
deleted file mode 100644
index 1acb29ea9197..000000000000
--- a/scripts/make_datastore_grpc.py
+++ /dev/null
@@ -1,150 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Get the inserted gRPC lines for datastore pb2 file."""
-
-import os
-import shutil
-import subprocess
-import sys
-import tempfile
-
-
-ROOT_DIR = os.path.abspath(
-    os.path.join(os.path.dirname(__file__), '..'))
-PROTOS_DIR = os.path.join(ROOT_DIR, 'googleapis-pb')
-PROTO_PATH = os.path.join(PROTOS_DIR, 'google', 'datastore',
-                          'v1', 'datastore.proto')
-GRPC_ONLY_FILE = os.path.join(ROOT_DIR, 'google', 'cloud', 'datastore',
-                              '_generated', 'datastore_grpc_pb2.py')
-GRPCIO_VIRTUALENV = os.getenv('GRPCIO_VIRTUALENV')
-if GRPCIO_VIRTUALENV is None:
-    PYTHON_EXECUTABLE = sys.executable
-else:
-    PYTHON_EXECUTABLE = os.path.join(GRPCIO_VIRTUALENV, 'bin', 'python')
-MESSAGE_SNIPPET = ' = _reflection.GeneratedProtocolMessageType('
-IMPORT_TEMPLATE = (
-    'from google.cloud.datastore._generated.datastore_pb2 import %s\n')
-
-
-def get_pb2_contents_with_grpc():
-    """Get pb2 lines generated by protoc with gRPC plugin.
-
-    :rtype: list
-    :returns: A list of lines in the generated file.
-    """
-    temp_dir = tempfile.mkdtemp()
-    generated_path = os.path.join(temp_dir, 'google', 'datastore',
-                                  'v1', 'datastore_pb2.py')
-    try:
-        return_code = subprocess.call([
-            PYTHON_EXECUTABLE,
-            '-m',
-            'grpc.tools.protoc',
-            '--proto_path',
-            PROTOS_DIR,
-            '--python_out',
-            temp_dir,
-            '--grpc_python_out',
-            temp_dir,
-            PROTO_PATH,
-        ])
-        if return_code != 0:
-            sys.exit(return_code)
-        with open(generated_path, 'rb') as file_obj:
-            return file_obj.readlines()
-    finally:
-        shutil.rmtree(temp_dir, ignore_errors=True)
-
-
-def get_pb2_contents_without_grpc():
-    """Get pb2 lines generated by protoc without gRPC plugin.
-
-    :rtype: list
-    :returns: A list of lines in the generated file.
-    """
-    temp_dir = tempfile.mkdtemp()
-    generated_path = os.path.join(temp_dir, 'google', 'datastore',
-                                  'v1', 'datastore_pb2.py')
-    try:
-        return_code = subprocess.call([
-            PYTHON_EXECUTABLE,
-            '-m',
-            'grpc.tools.protoc',
-            '--proto_path',
-            PROTOS_DIR,
-            '--python_out',
-            temp_dir,
-            PROTO_PATH,
-        ])
-        if return_code != 0:
-            sys.exit(return_code)
-        with open(generated_path, 'rb') as file_obj:
-            return file_obj.readlines()
-    finally:
-        shutil.rmtree(temp_dir, ignore_errors=True)
-
-
-def get_pb2_grpc_only():
-    """Get pb2 lines that are only in gRPC.
-
-    :rtype: list
-    :returns: A list of lines that are only in the pb2 file
-              generated with the gRPC plugin.
-    """
-    grpc_contents = get_pb2_contents_with_grpc()
-    non_grpc_contents = get_pb2_contents_without_grpc()
-
-    grpc_only_lines = []
-    curr_non_grpc_line = 0
-    for line in grpc_contents:
-        if line == non_grpc_contents[curr_non_grpc_line]:
-            curr_non_grpc_line += 1
-        else:
-            grpc_only_lines.append(line)
-
-    return grpc_only_lines
-
-
-def get_pb2_message_types():
-    """Get message types defined in datastore pb2 file.
-
-    :rtype: list
-    :returns: A list of names that are defined as message types.
-    """
-    non_grpc_contents = get_pb2_contents_without_grpc()
-    result = []
-    for line in non_grpc_contents:
-        if MESSAGE_SNIPPET in line:
-            name, _ = line.split(MESSAGE_SNIPPET)
-            result.append(name)
-
-    return sorted(result)
-
-
-def main():
-    """Write gRPC-only lines to custom module."""
-    grpc_only_lines = get_pb2_grpc_only()
-    with open(GRPC_ONLY_FILE, 'wb') as file_obj:
-        # First add imports for public objects in the original.
-        file_obj.write('# BEGIN: Imports from datastore_pb2\n')
-        for name in get_pb2_message_types():
-            import_line = IMPORT_TEMPLATE % (name,)
-            file_obj.write(import_line)
-        file_obj.write('#   END: Imports from datastore_pb2\n')
-        file_obj.write(''.join(grpc_only_lines))
-
-
-if __name__ == '__main__':
-    main()
diff --git a/scripts/make_operations_grpc.py b/scripts/make_operations_grpc.py
deleted file mode 100644
index 375887d2379b..000000000000
--- a/scripts/make_operations_grpc.py
+++ /dev/null
@@ -1,126 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Get the inserted gRPC lines for datastore pb2 file."""
-
-import os
-import shutil
-import subprocess
-import sys
-import tempfile
-
-
-ROOT_DIR = os.path.abspath(
-    os.path.join(os.path.dirname(__file__), '..'))
-PROTOS_DIR = os.path.join(ROOT_DIR, 'googleapis-pb')
-PROTO_PATH = os.path.join(PROTOS_DIR, 'google', 'longrunning',
-                          'operations.proto')
-GENERATED_SUBDIR = os.getenv('GENERATED_SUBDIR', '_generated')
-GRPC_ONLY_FILE = os.path.join(ROOT_DIR, 'google', 'cloud', 'bigtable',
-                              GENERATED_SUBDIR, 'operations_grpc_pb2.py')
-GRPCIO_VIRTUALENV = os.getenv('GRPCIO_VIRTUALENV')
-if GRPCIO_VIRTUALENV is None:
-    PYTHON_EXECUTABLE = sys.executable
-else:
-    PYTHON_EXECUTABLE = os.path.join(GRPCIO_VIRTUALENV, 'bin', 'python')
-
-
-def get_pb2_contents_with_grpc():
-    """Get pb2 lines generated by protoc with gRPC plugin.
-
-    :rtype: list
-    :returns: A list of lines in the generated file.
-    """
-    temp_dir = tempfile.mkdtemp()
-    generated_path = os.path.join(temp_dir, 'google', 'longrunning',
-                                  'operations_pb2.py')
-    try:
-        return_code = subprocess.call([
-            PYTHON_EXECUTABLE,
-            '-m',
-            'grpc.tools.protoc',
-            '--proto_path',
-            PROTOS_DIR,
-            '--python_out',
-            temp_dir,
-            '--grpc_python_out',
-            temp_dir,
-            PROTO_PATH,
-        ])
-        if return_code != 0:
-            sys.exit(return_code)
-        with open(generated_path, 'rb') as file_obj:
-            return file_obj.readlines()
-    finally:
-        shutil.rmtree(temp_dir, ignore_errors=True)
-
-
-def get_pb2_contents_without_grpc():
-    """Get pb2 lines generated by protoc without gRPC plugin.
-
-    :rtype: list
-    :returns: A list of lines in the generated file.
-    """
-    temp_dir = tempfile.mkdtemp()
-    generated_path = os.path.join(temp_dir, 'google', 'longrunning',
-                                  'operations_pb2.py')
-    try:
-        return_code = subprocess.call([
-            PYTHON_EXECUTABLE,
-            '-m',
-            'grpc.tools.protoc',
-            '--proto_path',
-            PROTOS_DIR,
-            '--python_out',
-            temp_dir,
-            PROTO_PATH,
-        ])
-        if return_code != 0:
-            sys.exit(return_code)
-        with open(generated_path, 'rb') as file_obj:
-            return file_obj.readlines()
-    finally:
-        shutil.rmtree(temp_dir, ignore_errors=True)
-
-
-def get_pb2_grpc_only():
-    """Get pb2 lines that are only in gRPC.
-
-    :rtype: list
-    :returns: A list of lines that are only in the pb2 file
-              generated with the gRPC plugin.
-    """
-    grpc_contents = get_pb2_contents_with_grpc()
-    non_grpc_contents = get_pb2_contents_without_grpc()
-
-    grpc_only_lines = []
-    curr_non_grpc_line = 0
-    for line in grpc_contents:
-        if line == non_grpc_contents[curr_non_grpc_line]:
-            curr_non_grpc_line += 1
-        else:
-            grpc_only_lines.append(line)
-
-    return grpc_only_lines
-
-
-def main():
-    """Write gRPC-only lines to custom module."""
-    grpc_only_lines = get_pb2_grpc_only()
-    with open(GRPC_ONLY_FILE, 'wb') as file_obj:
-        file_obj.writelines(grpc_only_lines)
-
-
-if __name__ == '__main__':
-    main()
diff --git a/scripts/pycodestyle_on_repo.py b/scripts/pycodestyle_on_repo.py
deleted file mode 100644
index 777ca197fb7a..000000000000
--- a/scripts/pycodestyle_on_repo.py
+++ /dev/null
@@ -1,41 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Custom script to run pycodestyle on google-cloud codebase.
-
-This runs pycodestyle as a script via subprocess but only runs it on the
-.py files that are checked in to the repository.
-"""
-
-
-import os
-import subprocess
-import sys
-
-
-def main():
-    """Run pycodestyle on all Python files in the repository."""
-    git_root = subprocess.check_output(
-        ['git', 'rev-parse', '--show-toplevel']).strip()
-    os.chdir(git_root)
-    python_files = subprocess.check_output(['git', 'ls-files', '*py'])
-    python_files = python_files.strip().split()
-
-    pycodestyle_command = ['pycodestyle'] + python_files
-    status_code = subprocess.call(pycodestyle_command)
-    sys.exit(status_code)
-
-
-if __name__ == '__main__':
-    main()
diff --git a/scripts/pylintrc_default b/scripts/pylintrc_default
deleted file mode 100644
index 893435eef1ef..000000000000
--- a/scripts/pylintrc_default
+++ /dev/null
@@ -1,424 +0,0 @@
-# PyLint config for 'google-cloud' *library* code.
-#
-# NOTES:
-#
-# - Rules for test code are generated into 'pylintrc_reduced'
-#   as deltas from this configuration by the 'run_pylint.py' script.
-#
-# - 'RATIONALE:  API mapping' as a defense for non-default settings is
-#   based on the fact that this library maps APIs which are outside our
-#   control, and adhereing to the out-of-the-box defaults would induce
-#   breakage / complexity in those mappings
-#
-[MASTER]
-
-# Specify a configuration file.
-# DEFAULT:  rcfile=
-
-# Python code to execute, usually for sys.path manipulation such as
-# pygtk.require().
-# DEFAULT: init-hook=
-
-# Profiled execution.
-# DEFAULT:  profile=no
-
-# Add files or directories to the blacklist. They should be base names, not
-# paths.
-# DEFAULT:  ignore=CVS
-# NOTE: This path must be relative due to the use of
-#       os.walk in astroid.modutils.get_module_files.
-# RATIONALE: No files to ignore.
-ignore=
-
-# Pickle collected data for later comparisons.
-# DEFAULT:  persistent=yes
-
-# List of plugins (as comma separated values of python modules names) to load,
-# usually to register additional checkers.
-# DEFAULT:  load-plugins=
-# RATIONALE: We want to make sure our docstrings match the objects
-#            they document.
-load-plugins=pylint.extensions.check_docs
-
-# DEPRECATED
-# DEFAULT:  include-ids=no
-
-# DEPRECATED
-# DEFAULT:  symbols=no
-
-
-[MESSAGES CONTROL]
-
-# Enable the message, report, category or checker with the given id(s). You can
-# either give multiple identifier separated by comma (,) or put this option
-# multiple time. See also the "--disable" option for examples.
-# DEFAULT:  enable=
-
-# Disable the message, report, category or checker with the given id(s). You
-# can either give multiple identifiers separated by comma (,) or put this
-# option multiple times (only on the command line, not in the configuration
-# file where it should appear only once).You can also use "--disable=all" to
-# disable everything first and then reenable specific checks. For example, if
-# you want to run only the similarities checker, you can use "--disable=all
-# --enable=similarities". If you want to run only the classes checker, but have
-# no Warning level messages displayed, use"--disable=all --enable=classes
-# --disable=W"
-# DEFAULT:  disable=
-# RATIONALE:
-# - maybe-no-member:  bi-modal functions confuse pylint type inference.
-# - no-member:  indirections in protobuf-generated code
-# - protected-access: helpers use '_foo' of classes from generated code.
-# - similarities:  'Bucket' and 'Blob' define 'metageneration' and 'owner' with
-#                  identical implementation but different docstrings.
-# - star-args:  standard Python idioms for varargs:
-#                  ancestor = Query().filter(*order_props)
-# - redefined-variable-type: This error is overzealous and complains at e.g.
-#                      if some_prop:
-#                          return int(value)
-#                      else:
-#                          return float(value)
-# - import-error: imports are checked via tests.
-# - wrong-import-position: This error is overzealous. It assumes imports are
-#                          completed whenever something non-trivial is
-#                          defined, e.g.
-#                              try:
-#                                  from foo import Bar
-#                              except ImportError:
-#                                  class Bar(object):
-#                                      """Hi everyone"""
-#                          and thus causes subsequent imports to be
-#                          diagnosed as out-of-order.
-# - no-name-in-module: Error gives a lot of false positives for names which
-#                      are defined dynamically. Also, any truly missing names
-#                      will be detected by our 100% code coverage.
-#
-# New opinions in pylint 1.6, enforcing PEP 257.  #1968 for eventual fixes
-# - missing-raises-doc
-disable =
-    maybe-no-member,
-    no-member,
-    protected-access,
-    similarities,
-    star-args,
-    redefined-variable-type,
-    import-error,
-    wrong-import-position,
-    no-name-in-module,
-    missing-raises-doc,
-
-
-[REPORTS]
-
-# Set the output format. Available formats are text, parseable, colorized, msvs
-# (visual studio) and html. You can also give a reporter class, eg
-# mypackage.mymodule.MyReporterClass.
-# DEFAULT:  output-format=text
-
-# Put messages in a separate file for each module / package specified on the
-# command line instead of printing them on stdout. Reports (if any) will be
-# written in a file name "pylint_global.[txt|html]".
-# DEFAULT:  files-output=no
-
-# Tells whether to display a full report or only the messages
-# DEFAULT:  reports=yes
-# RATIONALE:  run from Travis / tox, and don't need / want to parse output.
-reports=no
-
-# Python expression which should return a note less than 10 (10 is the highest
-# note). You have access to the variables errors warning, statement which
-# respectively contain the number of errors / warnings messages and the total
-# number of statements analyzed. This is used by the global evaluation report
-# (RP0004).
-# DEFAULT:  evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
-
-# Add a comment according to your evaluation note. This is used by the global
-# evaluation report (RP0004).
-# DEFAULT:  comment=no
-
-# Template used to display messages. This is a python new-style format string
-# used to format the message information. See doc for all details
-#msg-template=
-
-
-[SIMILARITIES]
-
-# Minimum lines number of a similarity.
-# DEFAULT:  min-similarity-lines=4
-
-# Ignore comments when computing similarities.
-# DEFAULT:  ignore-comments=yes
-
-# Ignore docstrings when computing similarities.
-# DEFAULT:  ignore-docstrings=yes
-
-# Ignore imports when computing similarities.
-# DEFAULT:  ignore-imports=no
-
-
-[VARIABLES]
-
-# Tells whether we should check for unused import in __init__ files.
-# DEFAULT:  init-import=no
-
-# A regular expression matching the name of dummy variables (i.e. expectedly
-# not used).
-# DEFAULT:  dummy-variables-rgx=_$|dummy
-
-# List of additional names supposed to be defined in builtins. Remember that
-# you should avoid to define new builtins when possible.
-# DEFAULT:  additional-builtins=
-
-
-[LOGGING]
-
-# Logging modules to check that the string format arguments are in logging
-# function parameter format
-# DEFAULT:  logging-modules=logging
-
-
-[FORMAT]
-
-# Maximum number of characters on a single line.
-# DEFAULT:  max-line-length=80
-
-# Regexp for a line that is allowed to be longer than the limit.
-# DEFAULT:  ignore-long-lines=^\s*(# )?<?https?://\S+>?$
-
-# Allow the body of an if to be on the same line as the test if there is no
-# else.
-# DEFAULT:  single-line-if-stmt=no
-
-# List of optional constructs for which whitespace checking is disabled
-# DEFAULT:  no-space-check=trailing-comma,dict-separator
-# RATIONALE: pylint ignores whitespace checks around the
-#            constructs "dict-separator" (cases like {1:2}) and
-#            "trailing-comma" (cases like {1: 2, }).
-#            By setting "no-space-check" to empty whitespace checks will be
-#            enforced around both constructs.
-no-space-check =
-
-# Maximum number of lines in a module
-# DEFAULT:  max-module-lines=1000
-# RATIONALE:  API-mapping
-max-module-lines=1200
-
-# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
-# tab).
-# DEFAULT:  indent-string='    '
-
-# Number of spaces of indent required inside a hanging or continued line.
-# DEFAULT:  indent-after-paren=4
-
-
-[MISCELLANEOUS]
-
-# List of note tags to take in consideration, separated by a comma.
-# DEFAULT:  notes=FIXME,XXX,TODO
-
-
-[BASIC]
-
-# Required attributes for module, separated by a comma
-# DEFAULT:  required-attributes=
-
-# List of builtins function names that should not be used, separated by a comma
-# DEFAULT:  bad-functions=map,filter,apply,input,file
-
-# Good variable names which should always be accepted, separated by a comma
-# DEFAULT:  good-names=i,j,k,ex,Run,_
-# RATIONALE:  'pb' and 'id' have well-understood meainings in the code.
-good-names = i, j, k, ex, Run, _,
-             pb,
-             id,
-
-# Bad variable names which should always be refused, separated by a comma
-# DEFAULT:  bad-names=foo,bar,baz,toto,tutu,tata
-
-# Colon-delimited sets of names that determine each other's naming style when
-# the name regexes allow several styles.
-# DEFAULT:  name-group=
-
-# Include a hint for the correct naming format with invalid-name
-# DEFAULT:  include-naming-hint=no
-
-# Regular expression matching correct function names
-# DEFAULT:  function-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Naming hint for function names
-# DEFAULT:  function-name-hint=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression matching correct variable names
-# DEFAULT:  variable-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Naming hint for variable names
-# DEFAULT:  variable-name-hint=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression matching correct constant names
-# DEFAULT:  const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
-
-# Naming hint for constant names
-# DEFAULT:  const-name-hint=(([A-Z_][A-Z0-9_]*)|(__.*__))$
-
-# Regular expression matching correct attribute names
-# DEFAULT:  attr-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Naming hint for attribute names
-# DEFAULT:  attr-name-hint=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression matching correct argument names
-# DEFAULT:  argument-rgx=[a-z_][a-z0-9_]{2,30}$
-
-# Naming hint for argument names
-# DEFAULT:  argument-name-hint=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression matching correct class attribute names
-# DEFAULT:  class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
-
-# Naming hint for class attribute names
-# DEFAULT:  class-attribute-name-hint=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
-
-# Regular expression matching correct inline iteration names
-# DEFAULT:  inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
-
-# Naming hint for inline iteration names
-# DEFAULT:  inlinevar-name-hint=[A-Za-z_][A-Za-z0-9_]*$
-
-# Regular expression matching correct class names
-# DEFAULT:  class-rgx=[A-Z_][a-zA-Z0-9]+$
-
-# Naming hint for class names
-# DEFAULT:  class-name-hint=[A-Z_][a-zA-Z0-9]+$
-
-# Regular expression matching correct module names
-# DEFAULT:  module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
-
-# Naming hint for module names
-# DEFAULT:  module-name-hint=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
-
-# Regular expression matching correct method names
-# DEFAULT:  method-rgx=[a-z_][a-z0-9_]{2,30}$
-# RATIONALE:  mapping long API names onto connection methods
-method-rgx=[a-z_][a-z0-9_]{2,35}$
-
-# Naming hint for method names
-# DEFAULT:  method-name-hint=[a-z_][a-z0-9_]{2,30}$
-
-# Regular expression which should only match function or class names that do
-# not require a docstring.
-no-docstring-rgx=__.*__
-
-# Minimum line length for functions/classes that require docstrings, shorter
-# ones are exempt.
-# DEFAULT:  docstring-min-length=-1
-
-
-[TYPECHECK]
-
-# Tells whether missing members accessed in mixin class should be ignored. A
-# mixin class is detected if its name ends with "mixin" (case insensitive).
-# DEFAULT:  ignore-mixin-members=yes
-
-# List of module names for which member attributes should not be checked
-# (useful for modules/projects where namespaces are manipulated during runtime
-# and thus existing member attributes cannot be deduced by static analysis
-# DEFAULT:  ignored-modules=
-# RATIONALE:  six aliases stuff for compatibility.
-#             google.protobuf fixes up namespace package "late".
-ignored-modules = six, google.protobuf
-
-# List of classes names for which member attributes should not be checked
-# (useful for classes with attributes dynamically set).
-# DEFAULT:  ignored-classes=SQLObject
-
-# When zope mode is activated, add a predefined set of Zope acquired attributes
-# to generated-members.
-# DEFAULT:  zope=no
-
-# List of members which are set dynamically and missed by pylint inference
-# system, and so shouldn't trigger E0201 when accessed. Python regular
-# expressions are accepted.
-# DEFAULT:  generated-members=REQUEST,acl_users,aq_parent
-
-
-[IMPORTS]
-
-# Deprecated modules which should not be used, separated by a comma
-# DEFAULT:  deprecated-modules=regsub,TERMIOS,Bastion,rexec
-
-# Create a graph of every (i.e. internal and external) dependencies in the
-# given file (report RP0402 must not be disabled)
-# DEFAULT:  import-graph=
-
-# Create a graph of external dependencies in the given file (report RP0402 must
-# not be disabled)
-# DEFAULT:  ext-import-graph=
-
-# Create a graph of internal dependencies in the given file (report RP0402 must
-# not be disabled)
-# DEFAULT:  int-import-graph=
-
-
-[CLASSES]
-
-# List of interface methods to ignore, separated by a comma. This is used for
-# instance to not check methods defines in Zope's Interface base class.
-# DEFAULT:  ignore-iface-methods=isImplementedBy,deferred,extends,names,namesAndDescriptions,queryDescriptionFor,getBases,getDescriptionFor,getDoc,getName,getTaggedValue,getTaggedValueTags,isEqualOrExtendedBy,setTaggedValue,isImplementedByInstancesOf,adaptWith,is_implemented_by
-
-# List of method names used to declare (i.e. assign) instance attributes.
-# DEFAULT:  defining-attr-methods=__init__,__new__,setUp
-
-# List of valid names for the first argument in a class method.
-# DEFAULT:  valid-classmethod-first-arg=cls
-
-# List of valid names for the first argument in a metaclass class method.
-# DEFAULT:  valid-metaclass-classmethod-first-arg=mcs
-
-
-[DESIGN]
-
-# Maximum number of arguments for function / method
-# DEFAULT:  max-args=5
-# RATIONALE:  API-mapping
-max-args = 10
-
-# Argument names that match this expression will be ignored. Default to name
-# with leading underscore
-# DEFAULT:  ignored-argument-names=_.*
-
-# Maximum number of locals for function / method body
-# DEFAULT:  max-locals=15
-max-locals=20
-
-# Maximum number of return / yield for function / method body
-# DEFAULT:  max-returns=6
-
-# Maximum number of branch for function / method body
-# DEFAULT:  max-branches=12
-
-# Maximum number of statements in function / method body
-# DEFAULT:  max-statements=50
-
-# Maximum number of parents for a class (see R0901).
-# DEFAULT:  max-parents=7
-
-# Maximum number of attributes for a class (see R0902).
-# DEFAULT:  max-attributes=7
-# RATIONALE:  API mapping
-max-attributes=15
-
-# Minimum number of public methods for a class (see R0903).
-# DEFAULT:  min-public-methods=2
-# RATIONALE:  context mgrs may have *no* public methods
-min-public-methods=0
-
-# Maximum number of public methods for a class (see R0904).
-# DEFAULT:  max-public-methods=20
-# RATIONALE:  API mapping
-max-public-methods=40
-
-
-[EXCEPTIONS]
-
-# Exceptions that will emit a warning when being caught. Defaults to
-# "Exception"
-# DEFAULT:  overgeneral-exceptions=Exception
diff --git a/scripts/rewrite_imports.py b/scripts/rewrite_imports.py
deleted file mode 100644
index 03128ebe222e..000000000000
--- a/scripts/rewrite_imports.py
+++ /dev/null
@@ -1,148 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Build script for rewriting imports for protobuf generated modules.
-
-Intended to be used for Google Cloud Bigtable protos (google/bigtable/v1)
-and the dependent modules (google/api and google/protobuf).
-"""
-
-import sys
-
-
-IMPORT_TEMPLATE = 'import %s'
-IMPORT_FROM_TEMPLATE = 'from %s import '
-REPLACEMENTS = {
-    # Bigtable v2
-    'google.bigtable.v2': 'google.cloud.bigtable._generated',
-    'google.bigtable.admin.v2': 'google.cloud.bigtable._generated',
-    # Datastore v1
-    'google.datastore.v1': 'google.cloud.datastore._generated',
-}
-
-
-def transform_old_to_new(line, old_module, new_module,
-                         ignore_import_from=False):
-    """Transforms from an old module to a new one.
-
-    First checks if a line starts with
-        "from {old_module} import ..."
-    then checks if the line contains
-        "import {old_module} ..."
-    then checks if the line starts with (ignoring whitespace)
-        "{old_module} ..."
-    and finally checks if the line contians
-        "'some-dict-key': {old_module} ..."
-
-    In any of these cases, "{old_module}" is replaced with "{new_module}".
-    If none match, nothing is returned.
-
-    :type line: str
-    :param line: The line to be transformed.
-
-    :type old_module: str
-    :param old_module: The import to be re-written.
-
-    :type new_module: str
-    :param new_module: The new location of the re-written import.
-
-    :type ignore_import_from: bool
-    :param ignore_import_from: Flag to determine if the "from * import"
-                               statements should be ignored.
-
-    :rtype: :class:`str` or :data:`NoneType <types.NoneType>`
-    :returns: The transformed line if the old module was found, otherwise
-              does nothing.
-    """
-    if not ignore_import_from:
-        import_from_statement = IMPORT_FROM_TEMPLATE % (old_module,)
-        if line.startswith(import_from_statement):
-            new_import_from_statement = IMPORT_FROM_TEMPLATE % (new_module,)
-            # Only replace the first instance of the import statement.
-            return line.replace(import_from_statement,
-                                new_import_from_statement, 1)
-
-    # If the line doesn't start with a "from * import *" statement, it
-    # may still contain a "import * ..." statement.
-    import_statement = IMPORT_TEMPLATE % (old_module,)
-    if import_statement in line:
-        new_import_statement = IMPORT_TEMPLATE % (new_module,)
-        # Only replace the first instance of the import statement.
-        return line.replace(import_statement,
-                            new_import_statement, 1)
-
-    # Also need to change references to the standalone imports. As a
-    # stop-gap we fix references to them at the beginning of a line
-    # (ignoring whitespace).
-    if line.lstrip().startswith(old_module):
-        # Only replace the first instance of the old_module.
-        return line.replace(old_module, new_module, 1)
-
-    # Finally check for usage in dictionaries.
-    if ': ' + old_module in line:
-        # Only replace the first instance of the old_module.
-        return line.replace(': ' + old_module, ': ' + new_module, 1)
-
-
-def transform_line(line):
-    """Transforms an import line in a PB2 module.
-
-    If the line is not an import of one of the packages in ``REPLACEMENTS``,
-    does nothing and returns the original. Otherwise it replaces the package
-    matched with our local package.
-
-    :type line: str
-    :param line: The line to be transformed.
-
-    :rtype: str
-    :returns: The transformed line.
-    """
-    # Work around https://github.com/grpc/grpc/issues/7101
-    if line == 'import ':
-        return ''
-
-    for old_module, new_module in REPLACEMENTS.iteritems():
-        result = transform_old_to_new(line, old_module, new_module)
-        if result is not None:
-            return result
-
-    # If no matches, there is nothing to transform.
-    return line
-
-
-def rewrite_file(filename):
-    """Rewrites a given PB2 modules.
-
-    :type filename: str
-    :param filename: The name of the file to be rewritten.
-    """
-    with open(filename, 'rU') as file_obj:
-        content_lines = file_obj.read().split('\n')
-
-    new_content = []
-    for line in content_lines:
-        new_content.append(transform_line(line))
-
-    with open(filename, 'w') as file_obj:
-        file_obj.write('\n'.join(new_content))
-
-
-def main():
-    """Rewrites all PB2 files."""
-    for filename in sys.argv[1:]:
-        rewrite_file(filename)
-
-
-if __name__ == '__main__':
-    main()
diff --git a/scripts/run_pylint.py b/scripts/run_pylint.py
deleted file mode 100644
index 7774b68a7765..000000000000
--- a/scripts/run_pylint.py
+++ /dev/null
@@ -1,252 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Custom script to run PyLint on google-cloud codebase.
-
-This runs pylint as a script via subprocess in two different
-subprocesses. The first lints the production/library code
-using the default rc file (PRODUCTION_RC). The second lints the
-test code using an rc file (TEST_RC) which allows more style
-violations (hence it has a reduced number of style checks).
-"""
-
-from __future__ import print_function
-
-import ConfigParser
-import copy
-import os
-import subprocess
-import sys
-
-
-IGNORED_DIRECTORIES = [
-    os.path.join('google', 'cloud', 'bigtable', '_generated'),
-    os.path.join('google', 'cloud', 'datastore', '_generated'),
-    'scripts/verify_included_modules.py',
-]
-IGNORED_FILES = [
-    os.path.join('docs', 'conf.py'),
-    'setup.py',
-]
-SCRIPTS_DIR = os.path.abspath(os.path.dirname(__file__))
-PRODUCTION_RC = os.path.join(SCRIPTS_DIR, 'pylintrc_default')
-TEST_RC = os.path.join(SCRIPTS_DIR, 'pylintrc_reduced')
-TEST_DISABLED_MESSAGES = [
-    'abstract-method',
-    'arguments-differ',
-    'assignment-from-no-return',
-    'attribute-defined-outside-init',
-    'exec-used',
-    'import-error',
-    'invalid-name',
-    'missing-docstring',
-    'no-init',
-    'no-self-use',
-    'superfluous-parens',
-    'too-few-public-methods',
-    'too-many-locals',
-    'too-many-public-methods',
-    'unbalanced-tuple-unpacking',
-]
-TEST_RC_ADDITIONS = {
-    'MESSAGES CONTROL': {
-        'disable': ', '.join(TEST_DISABLED_MESSAGES),
-    },
-}
-TEST_RC_REPLACEMENTS = {
-    'FORMAT': {
-        'max-module-lines': 1950,
-    },
-}
-
-
-def read_config(filename):
-    """Reads pylintrc config onto native ConfigParser object."""
-    config = ConfigParser.ConfigParser()
-    with open(filename, 'r') as file_obj:
-        config.readfp(file_obj)
-    return config
-
-
-def make_test_rc(base_rc_filename, additions_dict,
-                 replacements_dict, target_filename):
-    """Combines a base rc and test additions into single file."""
-    main_cfg = read_config(base_rc_filename)
-
-    # Create fresh config for test, which must extend production.
-    test_cfg = ConfigParser.ConfigParser()
-    test_cfg._sections = copy.deepcopy(main_cfg._sections)
-
-    for section, opts in additions_dict.items():
-        curr_section = test_cfg._sections.setdefault(
-            section, test_cfg._dict())
-        for opt, opt_val in opts.items():
-            curr_val = curr_section.get(opt)
-            if curr_val is None:
-                raise KeyError('Expected to be adding to existing option.')
-            curr_val = curr_val.rstrip(',')
-            curr_section[opt] = '%s, %s' % (curr_val, opt_val)
-
-    for section, opts in replacements_dict.items():
-        curr_section = test_cfg._sections.setdefault(
-            section, test_cfg._dict())
-        for opt, opt_val in opts.items():
-            curr_val = curr_section.get(opt)
-            if curr_val is None:
-                raise KeyError('Expected to be replacing existing option.')
-            curr_section[opt] = '%s' % (opt_val,)
-
-    with open(target_filename, 'w') as file_obj:
-        test_cfg.write(file_obj)
-
-
-def valid_filename(filename):
-    """Checks if a file is a Python file and is not ignored."""
-    for directory in IGNORED_DIRECTORIES:
-        if filename.startswith(directory):
-            return False
-    return (filename.endswith('.py') and
-            filename not in IGNORED_FILES)
-
-
-def is_production_filename(filename):
-    """Checks if the file contains production code.
-
-    :rtype: bool
-    :returns: Boolean indicating production status.
-    """
-    return 'test' not in filename and 'docs' not in filename
-
-
-def get_files_for_linting(allow_limited=True):
-    """Gets a list of files in the repository.
-
-    By default, returns all files via ``git ls-files``. However, in some cases
-    uses a specific commit or branch (a so-called diff base) to compare
-    against for changed files. (This requires ``allow_limited=True``.)
-
-    To speed up linting on Travis pull requests against master, we manually
-    set the diff base to origin/master. We don't do this on non-pull requests
-    since origin/master will be equivalent to the currently checked out code.
-    One could potentially use ${TRAVIS_COMMIT_RANGE} to find a diff base but
-    this value is not dependable.
-
-    To allow faster local ``tox`` runs, the environment variables
-    ``GOOGLE_CLOUD_REMOTE_FOR_LINT`` and ``GOOGLE_CLOUD_BRANCH_FOR_LINT`` can
-    be set to specify a remote branch to diff against.
-
-    :type allow_limited: bool
-    :param allow_limited: Boolean indicating if a reduced set of files can
-                          be used.
-
-    :rtype: pair
-    :returns: Tuple of the diff base using the the list of filenames to be
-              linted.
-    """
-    diff_base = None
-    if (os.getenv('TRAVIS_BRANCH') == 'master' and
-            os.getenv('TRAVIS_PULL_REQUEST') != 'false'):
-        # In the case of a pull request into master, we want to
-        # diff against HEAD in master.
-        diff_base = 'origin/master'
-    elif os.getenv('TRAVIS') is None:
-        # Only allow specified remote and branch in local dev.
-        remote = os.getenv('GOOGLE_CLOUD_REMOTE_FOR_LINT')
-        branch = os.getenv('GOOGLE_CLOUD_BRANCH_FOR_LINT')
-        if remote is not None and branch is not None:
-            diff_base = '%s/%s' % (remote, branch)
-
-    if diff_base is not None and allow_limited:
-        result = subprocess.check_output(['git', 'diff', '--name-only',
-                                          diff_base])
-        print('Using files changed relative to %s:' % (diff_base,))
-        print('-' * 60)
-        print(result.rstrip('\n'))  # Don't print trailing newlines.
-        print('-' * 60)
-    else:
-        print('Diff base not specified, listing all files in repository.')
-        result = subprocess.check_output(['git', 'ls-files'])
-
-    return result.rstrip('\n').split('\n'), diff_base
-
-
-def get_python_files(all_files=None):
-    """Gets a list of all Python files in the repository that need linting.
-
-    Relies on :func:`get_files_for_linting()` to determine which files should
-    be considered.
-
-    NOTE: This requires ``git`` to be installed and requires that this
-          is run within the ``git`` repository.
-
-    :type all_files: list or ``NoneType``
-    :param all_files: Optional list of files to be linted.
-
-    :rtype: tuple
-    :returns: A tuple containing two lists. The first list
-              contains all production files, the next all test files.
-    """
-    if all_files is None:
-        all_files, diff_base = get_files_for_linting()
-
-    library_files = []
-    non_library_files = []
-    for filename in all_files:
-        if valid_filename(filename):
-            if is_production_filename(filename):
-                library_files.append(filename)
-            else:
-                non_library_files.append(filename)
-
-    return library_files, non_library_files, diff_base
-
-
-def lint_fileset(filenames, rcfile, description):
-    """Lints a group of files using a given rcfile."""
-    # Only lint filenames that exist. For example, 'git diff --name-only'
-    # could spit out deleted / renamed files. Another alternative could
-    # be to use 'git diff --name-status' and filter out files with a
-    # status of 'D'.
-    filenames = [filename for filename in filenames
-                 if os.path.exists(filename)]
-    if filenames:
-        rc_flag = '--rcfile=%s' % (rcfile,)
-        pylint_shell_command = ['pylint', rc_flag]
-        errors = {}  # filename -> status_code
-        for filename in filenames:
-            cmd = pylint_shell_command + [filename]
-            status_code = subprocess.call(cmd)
-            if status_code != 0:
-                errors[filename] = status_code
-        if errors:
-            for filename, status_code in sorted(errors.items()):
-                print('%-30s: %d' % (filename, status_code), file=sys.stderr)
-            sys.exit(len(errors))
-    else:
-        print('Skipping %s, no files to lint.' % (description,))
-
-
-def main():
-    """Script entry point. Lints both sets of files."""
-    make_test_rc(PRODUCTION_RC, TEST_RC_ADDITIONS,
-                 TEST_RC_REPLACEMENTS, TEST_RC)
-    library_files, non_library_files, diff_base = get_python_files()
-    if diff_base:
-        print('Checking only files which differ from base.')
-    lint_fileset(library_files, PRODUCTION_RC, 'library code')
-    lint_fileset(non_library_files, TEST_RC, 'test code')
-
-
-if __name__ == '__main__':
-    main()
diff --git a/scripts/update_docs.sh b/scripts/update_docs.sh
deleted file mode 100755
index cfbe1c33b715..000000000000
--- a/scripts/update_docs.sh
+++ /dev/null
@@ -1,89 +0,0 @@
-#!/bin/bash
-
-# Copyright 2016 Google Inc. 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.
-
-set -ev
-
-#########################################
-# Only update docs if we are on Travis. #
-#########################################
-if [[ "${TRAVIS_BRANCH}" == "master" ]] && \
-       [[ "${TRAVIS_PULL_REQUEST}" == "false" ]]; then
-  echo "Building new docs on a merged commit."
-elif [[ -n "${TRAVIS_TAG}" ]]; then
-  echo "Building new docs on a tag."
-else
-  echo "No docs to update for a new tag or merged commit on Travis."
-  echo "Verifying docs build successfully."
-  tox -e docs
-  exit
-fi
-
-# Adding GitHub pages branch. `git submodule add` checks it
-# out at HEAD.
-GH_PAGES_DIR="ghpages"
-git submodule add -q -b gh-pages \
-    "https://${GH_OAUTH_TOKEN}@github.com/${GH_OWNER}/${GH_PROJECT_NAME}" \
-    ${GH_PAGES_DIR}
-
-# Determine if we are building a new tag or are building docs
-# for master. Then build new docset in docs/_build from master.
-if [[ -z "${TRAVIS_TAG}" ]]; then
-    SPHINX_RELEASE=$(git log -1 --pretty=%h) tox -e docs
-else
-    # Sphinx will use the package version by default.
-    tox -e docs
-fi
-
-# Get the current version. Assumes the PWD is the root of the git repo.
-# We run this after `tox -e docs` to make sure the `docs` env is
-# set up.
-CURRENT_VERSION=$(.tox/docs/bin/python scripts/get_version.py)
-
-# Update gh-pages with the created docs.
-cd ${GH_PAGES_DIR}
-if [[ -z "${TRAVIS_TAG}" ]]; then
-    git rm -fr latest/
-    cp -R ../docs/_build/html/ latest/
-else
-    if [[ -d ${CURRENT_VERSION} ]]; then
-        echo "The directory ${CURRENT_VERSION} already exists."
-        exit 1
-    fi
-    git rm -fr stable/
-    # Put the new release in stable and with the actual version.
-    cp -R ../docs/_build/html/ stable/
-    cp -R ../docs/_build/html/ "${CURRENT_VERSION}/"
-fi
-
-# Update the files push to gh-pages.
-git add .
-git status
-
-# H/T: https://github.com/dhermes
-if [[ -z "$(git status --porcelain)" ]]; then
-    echo "Nothing to commit. Exiting without pushing changes."
-    exit
-fi
-
-# Commit to gh-pages branch to apply changes.
-git config --global user.email "travis@travis-ci.org"
-git config --global user.name "travis-ci"
-git commit -m "Update docs after merge to master."
-# NOTE: This may fail if two docs updates (on merges to master)
-#       happen in close proximity.
-git push -q \
-    "https://${GH_OAUTH_TOKEN}@github.com/${GH_OWNER}/${GH_PROJECT_NAME}" \
-    HEAD:gh-pages
diff --git a/scripts/update_json_docs.sh b/scripts/update_json_docs.sh
deleted file mode 100755
index 623b0c478209..000000000000
--- a/scripts/update_json_docs.sh
+++ /dev/null
@@ -1,67 +0,0 @@
-#!/bin/bash
-
-set -ev
-
-
-function buildDocs () {
-  echo "Building JSON documentation..."
-  python scripts/generate_json_docs.py --tag ${1}
-  echo "Done building JSON documentation."
-}
-
-
-function pushDocs () {
-  echo "Deploying JSON documentation..."
-  if [[ ! -d "ghpages" ]]; then
-      git submodule add -q -f -b gh-pages https://${GH_OAUTH_TOKEN}@github.com/${GH_OWNER}/${GH_PROJECT_NAME} ghpages
-  fi
-  mkdir -p ghpages/json/${1}
-  cp -R docs/_build/json_build/* ghpages/
-  cd ghpages
-  git add .
-  if [[ -n "$(git status --porcelain)" ]]; then
-    git config user.name "travis-ci"
-    git config user.email "travis@travis-ci.org"
-    git commit -m "Updating docs for ${1}"
-    git status
-    git push -q https://${GH_OAUTH_TOKEN}@github.com/${GH_OWNER}/${GH_PROJECT_NAME} HEAD:gh-pages
-  else
-    echo "Nothing to commit."
-  fi
-  cd ..
-
-  echo "Done deploying JSON documentation."
-}
-
-function cleanSubmodule () {
-    echo "Cleaning up!"
-    git submodule deinit -q -f ghpages
-    git reset HEAD .gitmodules
-    git reset HEAD ghpages
-    rm -rf ghpages
-    rm -f .gitmodules
-    rm -rf .git/modules/ghpages
-    echo "Done cleaning up!"
-}
-
-# Run this to verifiy that the docs build successfully.
-DOC_VERSION='master'
-if [[ ! -z ${TRAVIS_TAG} ]]; then
-  DOC_VERSION=${TRAVIS_TAG}
-else
-  DOC_VERSION=${TRAVIS_BRANCH}
-fi
-
-buildDocs ${DOC_VERSION}
-
-if [ "${TRAVIS_BRANCH}" == "master" ] && [ "${TRAVIS_PULL_REQUEST}" == "false" ]; then
-  pushDocs ${DOC_VERSION}
-  cleanSubmodule
-  echo "Done pushing docsite. See: https://googlecloudplatform.github.io/google-cloud-python/"
-fi
-
-if [[ ! -z ${TRAVIS_TAG} ]]; then
-  pushDocs ${DOC_VERSION}
-  cleanSubmodule
-  echo "Done pushing docsite. See: https://googlecloudplatform.github.io/google-cloud-python/"
-fi
diff --git a/scripts/verify_included_modules.py b/scripts/verify_included_modules.py
deleted file mode 100644
index 013ad0bab0fc..000000000000
--- a/scripts/verify_included_modules.py
+++ /dev/null
@@ -1,178 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Check if all public modules are included in our docs."""
-
-
-from __future__ import print_function
-
-import argparse
-import os
-import sys
-import warnings
-
-from sphinx.ext.intersphinx import fetch_inventory
-
-
-BASE_DIR = os.path.abspath(
-    os.path.join(os.path.dirname(__file__), '..'))
-DOCS_DIR = os.path.join(BASE_DIR, 'docs')
-IGNORED_PREFIXES = ('test_', '_')
-IGNORED_MODULES = frozenset([
-    'google.cloud.__init__',
-    'google.cloud.bigquery.__init__',
-    'google.cloud.bigtable.__init__',
-    'google.cloud.datastore.__init__',
-    'google.cloud.dns.__init__',
-    'google.cloud.error_reporting.__init__',
-    'google.cloud.iterator',
-    'google.cloud.language.__init__',
-    'google.cloud.logging.__init__',
-    'google.cloud.logging.handlers.__init__',
-    'google.cloud.logging.handlers.transports.__init__',
-    'google.cloud.monitoring.__init__',
-    'google.cloud.pubsub.__init__',
-    'google.cloud.resource_manager.__init__',
-    'google.cloud.speech.__init__',
-    'google.cloud.storage.__init__',
-    'google.cloud.streaming.__init__',
-    'google.cloud.streaming.buffered_stream',
-    'google.cloud.streaming.exceptions',
-    'google.cloud.streaming.http_wrapper',
-    'google.cloud.streaming.stream_slice',
-    'google.cloud.streaming.transfer',
-    'google.cloud.streaming.util',
-    'google.cloud.translate.__init__',
-    'google.cloud.vision.__init__',
-    'google.cloud.vision.fixtures',
-])
-
-
-class SphinxApp(object):
-    """Mock app to interact with Sphinx helpers."""
-    warn = warnings.warn
-    srcdir = DOCS_DIR
-
-
-def is_valid_module(filename):
-    """Determines if a filename is a valid Python module.
-
-    Assumes if is just the end of a path (i.e. does not contain
-    ``os.path.sep``.
-
-    :type filename: string
-    :param filename: The name of a file.
-
-    :rtype: bool
-    :returns: Flag indicating if the filename is valid.
-    """
-    if not filename.endswith('.py'):
-        return False
-    if filename == '__init__.py':
-        return True
-    for prefix in IGNORED_PREFIXES:
-        if filename.startswith(prefix):
-            return False
-    return True
-
-
-def get_public_modules(path, base_package=None):
-    """Get list of all public modules relative to a path.
-
-    :type path: string
-    :param path: The path containing the python modules.
-
-    :type base_package: string
-    :param base_package: (Optional) A package to prepend in
-                         front of the path.
-
-    :rtype: list
-    :returns: List of all modules found.
-    """
-    result = []
-    for subdir, _, files in os.walk(path):
-        # Skip folders that start with _.
-        if any([part.startswith('_')
-                for part in subdir.split(os.path.sep)]):
-            continue
-        _, rel_dir = subdir.split(path)
-        rel_dir = rel_dir.lstrip(os.path.sep)
-        for filename in files:
-            if is_valid_module(filename):
-                mod_name, _ = os.path.splitext(filename)
-                rel_path = os.path.join(rel_dir, mod_name)
-                if base_package is not None:
-                    rel_path = os.path.join(base_package, rel_path)
-                # Turn into a Python module rather than a file path.
-                result.append(rel_path.replace(os.path.sep, '.'))
-
-    return result
-
-
-def main(build_root='_build'):
-    """Main script to verify modules included.
-
-    :type build_root: str
-    :param build_root: The root of the directory where docs are built into.
-                       Defaults to ``_build``.
-    """
-    object_inventory_relpath = os.path.join(build_root, 'html', 'objects.inv')
-
-    mock_uri = ''
-    inventory = fetch_inventory(SphinxApp, mock_uri,
-                                object_inventory_relpath)
-    sphinx_mods = set(inventory['py:module'].keys())
-
-    library_dir = os.path.join(BASE_DIR, 'google', 'cloud')
-    public_mods = get_public_modules(library_dir,
-                                     base_package='google.cloud')
-    public_mods = set(public_mods)
-
-    if not sphinx_mods <= public_mods:
-        unexpected_mods = sphinx_mods - public_mods
-        message = ['Unexpected error. There were modules referenced by '
-                   'Sphinx that are not among the public modules.']
-        message.extend(['- %s' % (mod,) for mod in unexpected_mods])
-        print('\n'.join(message), file=sys.stderr)
-        sys.exit(1)
-
-    undocumented_mods = public_mods - sphinx_mods
-    # Remove ignored modules.
-    undocumented_mods -= IGNORED_MODULES
-    if undocumented_mods:
-        message_parts = ['Found undocumented public modules:']
-        message_parts.extend(['- ' + mod_name
-                              for mod_name in sorted(undocumented_mods)])
-        print('\n'.join(message_parts), file=sys.stderr)
-        sys.exit(1)
-
-
-def get_parser():
-    """Get simple ``argparse`` parser to determine package.
-
-    :rtype: :class:`argparse.ArgumentParser`
-    :returns: The parser for this script.
-    """
-    description = ('Run check that all google-cloud '
-                   'modules are included in docs.')
-    parser = argparse.ArgumentParser(description=description)
-    parser.add_argument('--build-root', dest='build_root',
-                        help='The root directory where docs are located.')
-    return parser
-
-
-if __name__ == '__main__':
-    parser = get_parser()
-    args = parser.parse_args()
-    main(build_root=args.build_root)
diff --git a/securitycenter/.coveragerc b/securitycenter/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/securitycenter/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/securitycenter/.flake8 b/securitycenter/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/securitycenter/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/securitycenter/.repo-metadata.json b/securitycenter/.repo-metadata.json
new file mode 100644
index 000000000000..4f88503d7db9
--- /dev/null
+++ b/securitycenter/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "securitycenter",
+  "name_pretty": "Google Cloud Security Command Center",
+  "product_documentation": "https://cloud.google.com/security-command-center",
+  "client_documentation": "https://googleapis.dev/python/securitycenter/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559748",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-securitycenter",
+  "api_id": "securitycenter.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/securitycenter/CHANGELOG.md b/securitycenter/CHANGELOG.md
new file mode 100644
index 000000000000..504c1f61a062
--- /dev/null
+++ b/securitycenter/CHANGELOG.md
@@ -0,0 +1,105 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-securitycenter/#history
+
+## 0.3.0
+
+07-24-2019 17:29 PDT
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel, update templates (via synth). ([#8402](https://github.com/googleapis/google-cloud-python/pull/8402))
+- Update return type of run_asset_discovery (via synth). ([#8032](https://github.com/googleapis/google-cloud-python/pull/8032))
+- Security Center: Add routing header to method metadata (via synth). ([#7589](https://github.com/googleapis/google-cloud-python/pull/7589))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8658](https://github.com/googleapis/google-cloud-python/pull/8658))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8521](https://github.com/googleapis/google-cloud-python/pull/8521))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Update docstrings (via synth). ([#8711](https://github.com/googleapis/google-cloud-python/pull/8711))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Docstring changes (via synth). ([#7704](https://github.com/googleapis/google-cloud-python/pull/7704))
+- Add Snippets for security center list_assets call ([#7538](https://github.com/googleapis/google-cloud-python/pull/7538))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8362](https://github.com/googleapis/google-cloud-python/pull/8362))
+- Add disclaimer to auto-generated template files (via synth).([#8326](https://github.com/googleapis/google-cloud-python/pull/8326))
+- Fix coverage in 'types.py' (via synth). ([#8163](https://github.com/googleapis/google-cloud-python/pull/8163))
+- Add empty lines (via synth). ([#8070](https://github.com/googleapis/google-cloud-python/pull/8070))
+- Add nox session `docs`, reorder methods (via synth). ([#7780](https://github.com/googleapis/google-cloud-python/pull/7780))
+- Use alabaster theme everwhere. ([#8021](https://github.com/googleapis/google-cloud-python/pull/8021))
+- Add Ruby package configuration in protos (via synth). ([#7741](https://github.com/googleapis/google-cloud-python/pull/7741))
+- proto file housekeeping FBO PHP (via synth).
+
+## 0.2.0
+
+03-12-2019 17:09 PDT
+
+
+### Implementation Changes
+- Remove 'having' filter arguments from query methods (via synth). [#7511](https://github.com/googleapis/google-cloud-python/pull/7511))
+- Remove unused message exports. ([#7274](https://github.com/googleapis/google-cloud-python/pull/7274))
+- Trivial gapic-generator change. ([#7233](https://github.com/googleapis/google-cloud-python/pull/7233))
+- Protoc-generated serialization update, docstring tweak. ([#7094](https://github.com/googleapis/google-cloud-python/pull/7094))
+
+### New Features
+- Add support for `v1` API. ([#7495](https://github.com/googleapis/google-cloud-python/pull/7495))
+
+### Documentation
+- googlecloudplatform --> googleapis in READMEs ([#7411](https://github.com/googleapis/google-cloud-python/pull/7411))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+- Docstring update from .proto file. ([#7056](https://github.com/googleapis/google-cloud-python/pull/7056))
+- Fix 404 for 'Client Library Documentation' link. ([#7041](https://github.com/googleapis/google-cloud-python/pull/7041))
+- Pick up stub docstring fix in GAPIC generator. ([#6981](https://github.com/googleapis/google-cloud-python/pull/6981))
+
+### Internal / Testing Changes
+- Proto file housekeeping FBO C# (via synth). ([#7502](https://github.com/googleapis/google-cloud-python/pull/7502))
+- Copy lintified proto files (via synth). ([#7470](https://github.com/googleapis/google-cloud-python/pull/7470))
+- Add clarifying comment to blacken nox target. ([#7402](https://github.com/googleapis/google-cloud-python/pull/7402))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.1.1
+
+12-18-2018 09:45 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up changes to GAPIC generator. ([#6506](https://github.com/googleapis/google-cloud-python/pull/6506))
+- Assorted synth fixups / cleanups ([#6400](https://github.com/googleapis/google-cloud-python/pull/6400))
+- Fix `client_info` bug, update docstrings via synth. ([#6438](https://github.com/googleapis/google-cloud-python/pull/6438))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Docstring changes via synth. ([#6473](https://github.com/googleapis/google-cloud-python/pull/6473))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Overlooked synth changes. ([#6439](https://github.com/googleapis/google-cloud-python/pull/6439))
+
+## 0.1.0
+
+11-01-2018 15:12 PDT
+
+### New Features
+- Generate Security Center Client Library ([#6356](https://github.com/googleapis/google-cloud-python/pull/6356))
+
diff --git a/securitycenter/LICENSE b/securitycenter/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/securitycenter/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/securitycenter/MANIFEST.in b/securitycenter/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/securitycenter/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/securitycenter/README.rst b/securitycenter/README.rst
new file mode 100644
index 000000000000..5828416c0eb4
--- /dev/null
+++ b/securitycenter/README.rst
@@ -0,0 +1,85 @@
+Python Client for Cloud Security Command Center API (`Alpha`_)
+==============================================================
+|alpha| |pypi| |versions| 
+
+`Cloud Security Command Center API`_: The public Cloud Security Command Center API.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-securitycenter.svg
+   :target: https://pypi.org/project/google-cloud-securitycenter/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-securitycenter.svg
+   :target: https://pypi.org/project/google-cloud-securitycenter/
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Cloud Security Command Center API: https://cloud.google.com/security-command-center
+.. _Client Library Documentation: https://googleapis.dev/python/securitycenter/latest
+.. _Product Documentation:  https://cloud.google.com/security-command-center
+
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Security Command Center API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Security Command Center API.:  https://cloud.google.com/security-command-center
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-securitycenter
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-securitycenter
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/securitycenter/docs/README.rst b/securitycenter/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/securitycenter/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/securitycenter/docs/changelog.md b/securitycenter/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/securitycenter/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/securitycenter/docs/conf.py b/securitycenter/docs/conf.py
new file mode 100644
index 000000000000..ebb74d010e89
--- /dev/null
+++ b/securitycenter/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-securitycenter documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-securitycenter"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-securitycenter-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-securitycenter.tex",
+        u"google-cloud-securitycenter Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-securitycenter",
+        u"google-cloud-securitycenter Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-securitycenter",
+        u"google-cloud-securitycenter Documentation",
+        author,
+        "google-cloud-securitycenter",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/securitycenter/docs/gapic/v1/api.rst b/securitycenter/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..c0ff129f7264
--- /dev/null
+++ b/securitycenter/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Security Command Center API
+============================================
+
+.. automodule:: google.cloud.securitycenter_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/securitycenter/docs/gapic/v1/types.rst b/securitycenter/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..ee29f3e0a147
--- /dev/null
+++ b/securitycenter/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Security Command Center API Client
+==================================================
+
+.. automodule:: google.cloud.securitycenter_v1.types
+    :members:
\ No newline at end of file
diff --git a/securitycenter/docs/gapic/v1beta1/api.rst b/securitycenter/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..5bf656fea5f0
--- /dev/null
+++ b/securitycenter/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Security Command Center API
+============================================
+
+.. automodule:: google.cloud.securitycenter_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/securitycenter/docs/gapic/v1beta1/types.rst b/securitycenter/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..4af19d8c571a
--- /dev/null
+++ b/securitycenter/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Security Command Center API Client
+==================================================
+
+.. automodule:: google.cloud.securitycenter_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/securitycenter/docs/index.rst b/securitycenter/docs/index.rst
new file mode 100644
index 000000000000..57184dabf1a0
--- /dev/null
+++ b/securitycenter/docs/index.rst
@@ -0,0 +1,21 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+
+Changelog
+----------
+
+For a list of all ``google-cloud-securitycenter`` releases:
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/securitycenter/docs/snippets_list_assets.py b/securitycenter/docs/snippets_list_assets.py
new file mode 100644
index 000000000000..e75b5cfa9f86
--- /dev/null
+++ b/securitycenter/docs/snippets_list_assets.py
@@ -0,0 +1,126 @@
+#!/usr/bin/env python
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+""" Examples of listing assets in Cloud Security Command Center."""
+import os
+from datetime import datetime, timedelta
+
+
+# The numeric identifier for the organization.
+ORGANIZATION_ID = os.environ["GCLOUD_ORGANIZATION"]
+
+
+def test_list_all_assets():
+    """Demonstrate listing and printing all assets."""
+    from google.cloud import securitycenter_v1beta1 as securitycenter
+
+    # [START demo_list_all_assets]
+    client = securitycenter.SecurityCenterClient()
+    # ORGANIZATION_ID is the numeric ID of the organization (e.g. 123213123121)
+    org_name = "organizations/{org_id}".format(org_id=ORGANIZATION_ID)
+
+    # Call the API and print results.
+    asset_iterator = client.list_assets(org_name)
+    for i, asset_result in enumerate(asset_iterator):
+        print(i, asset_result)
+    # [END demo_list_all_assets]
+    assert i > 0
+
+
+def test_list_assets_with_filters():
+    """Demonstrate listing assets with a filter."""
+    from google.cloud import securitycenter_v1beta1 as securitycenter
+
+    # [START demo_list_assets_with_filter]
+    client = securitycenter.SecurityCenterClient()
+
+    # ORGANIZATION_ID is the numeric ID of the organization (e.g. 123213123121)
+    org_name = "organizations/{org_id}".format(org_id=ORGANIZATION_ID)
+
+    project_filter = (
+        "security_center_properties.resource_type="
+        + '"google.cloud.resourcemanager.Project"'
+    )
+    # Call the API and print results.
+    asset_iterator = client.list_assets(org_name, filter_=project_filter)
+    for i, asset_result in enumerate(asset_iterator):
+        print(i, asset_result)
+    # [END demo_list_assets_with_filter]
+    assert i > 0
+
+
+def test_list_assets_with_filters_and_read_time():
+    """Demonstrate listing assets with a filter."""
+    from datetime import datetime, timedelta
+    from google.cloud import securitycenter_v1beta1 as securitycenter
+    from google.protobuf.timestamp_pb2 import Timestamp
+
+    # [START demo_list_assets_with_filter_and_time]
+    client = securitycenter.SecurityCenterClient()
+
+    # ORGANIZATION_ID is the numeric ID of the organization (e.g. 123213123121)
+    org_name = "organizations/{org_id}".format(org_id=ORGANIZATION_ID)
+
+    project_filter = (
+        "security_center_properties.resource_type="
+        + '"google.cloud.resourcemanager.Project"'
+    )
+
+    # Lists assets as of yesterday.
+    read_time = datetime.utcnow() - timedelta(days=1)
+    timestamp_proto = Timestamp()
+    timestamp_proto.FromDatetime(read_time)
+
+    # Call the API and print results.
+    asset_iterator = client.list_assets(
+        org_name, filter_=project_filter, read_time=timestamp_proto
+    )
+    for i, asset_result in enumerate(asset_iterator):
+        print(i, asset_result)
+    # [END demo_list_assets_with_filter_and_time]
+    assert i > 0
+
+
+def test_list_point_in_time_changes():
+    """Demonstrate listing assets along with their state changes."""
+    from google.cloud import securitycenter_v1beta1 as securitycenter
+    from google.protobuf.duration_pb2 import Duration
+    from datetime import timedelta
+
+    # [START demo_list_assets_changes]
+    client = securitycenter.SecurityCenterClient()
+
+    # ORGANIZATION_ID is the numeric ID of the organization (e.g. 123213123121)
+    org_name = "organizations/{org_id}".format(org_id=ORGANIZATION_ID)
+    project_filter = (
+        "security_center_properties.resource_type="
+        + '"google.cloud.resourcemanager.Project"'
+    )
+
+    # List assets and their state change the last 30 days
+    compare_delta = timedelta(days=30)
+    # Convert the timedelta to a Duration
+    duration_proto = Duration()
+    duration_proto.FromTimedelta(compare_delta)
+    # Call the API and print results.
+    asset_iterator = client.list_assets(
+        org_name, filter_=project_filter, compare_duration=duration_proto
+    )
+    for i, asset in enumerate(asset_iterator):
+        print(i, asset)
+
+    # [END demo_list_assets_changes]
+    assert i > 0
diff --git a/securitycenter/google/__init__.py b/securitycenter/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/securitycenter/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/securitycenter/google/cloud/__init__.py b/securitycenter/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/securitycenter/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/securitycenter/google/cloud/securitycenter.py b/securitycenter/google/cloud/securitycenter.py
new file mode 100644
index 000000000000..7b5ed2b41912
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.securitycenter_v1 import SecurityCenterClient
+from google.cloud.securitycenter_v1 import enums
+from google.cloud.securitycenter_v1 import types
+
+
+__all__ = ("enums", "types", "SecurityCenterClient")
diff --git a/securitycenter/google/cloud/securitycenter_v1/__init__.py b/securitycenter/google/cloud/securitycenter_v1/__init__.py
new file mode 100644
index 000000000000..f8442f6bfc9b
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.securitycenter_v1 import types
+from google.cloud.securitycenter_v1.gapic import enums
+from google.cloud.securitycenter_v1.gapic import security_center_client
+
+
+class SecurityCenterClient(security_center_client.SecurityCenterClient):
+    __doc__ = security_center_client.SecurityCenterClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "SecurityCenterClient")
diff --git a/securitycenter/google/cloud/securitycenter_v1/gapic/__init__.py b/securitycenter/google/cloud/securitycenter_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/securitycenter/google/cloud/securitycenter_v1/gapic/enums.py b/securitycenter/google/cloud/securitycenter_v1/gapic/enums.py
new file mode 100644
index 000000000000..36055ab1e2c6
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/gapic/enums.py
@@ -0,0 +1,150 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class Finding(object):
+    class State(enum.IntEnum):
+        """
+        The state of the finding.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          ACTIVE (int): The finding requires attention and has not been addressed yet.
+          INACTIVE (int): The finding has been fixed, triaged as a non-issue or otherwise addressed
+          and is no longer active.
+        """
+
+        STATE_UNSPECIFIED = 0
+        ACTIVE = 1
+        INACTIVE = 2
+
+
+class ListAssetsResponse(object):
+    class ListAssetsResult(object):
+        class StateChange(enum.IntEnum):
+            """
+            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
+
+            Attributes:
+              UNUSED (int): State change is unused, this is the canonical default for this enum.
+              ADDED (int): Asset was added between the points in time.
+              REMOVED (int): Asset was removed between the points in time.
+              ACTIVE (int): Asset was present at both point(s) in time.
+            """
+
+            UNUSED = 0
+            ADDED = 1
+            REMOVED = 2
+            ACTIVE = 3
+
+
+class ListFindingsResponse(object):
+    class ListFindingsResult(object):
+        class StateChange(enum.IntEnum):
+            """
+            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
+
+            Attributes:
+              UNUSED (int): State change is unused, this is the canonical default for this enum.
+              CHANGED (int): The finding has changed state in some way between the points in time
+              and existed at both points.
+              UNCHANGED (int): The finding has not changed state between the points in time and
+              existed at both points.
+              ADDED (int): The finding was created between the points in time.
+              REMOVED (int): The finding at timestamp does not match the filter specified, but it did
+              at timestamp - compare\_duration.
+            """
+
+            UNUSED = 0
+            CHANGED = 1
+            UNCHANGED = 2
+            ADDED = 3
+            REMOVED = 4
+
+
+class OrganizationSettings(object):
+    class AssetDiscoveryConfig(object):
+        class InclusionMode(enum.IntEnum):
+            """
+            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.
+
+            Attributes:
+              INCLUSION_MODE_UNSPECIFIED (int): Unspecified. Setting the mode with this value will disable
+              inclusion/exclusion filtering for Asset Discovery.
+              INCLUDE_ONLY (int): Asset Discovery will capture only the resources within the projects
+              specified. All other resources will be ignored.
+              EXCLUDE (int): Asset Discovery will ignore all resources under the projects specified.
+              All other resources will be retrieved.
+            """
+
+            INCLUSION_MODE_UNSPECIFIED = 0
+            INCLUDE_ONLY = 1
+            EXCLUDE = 2
+
+
+class RunAssetDiscoveryResponse(object):
+    class State(enum.IntEnum):
+        """
+        The state of an asset discovery run.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Asset discovery run state was unspecified.
+          COMPLETED (int): Asset discovery run completed successfully.
+          SUPERSEDED (int): Asset discovery run was cancelled with tasks still pending, as another
+          run for the same organization was started with a higher priority.
+          TERMINATED (int): Asset discovery run was killed and terminated.
+        """
+
+        STATE_UNSPECIFIED = 0
+        COMPLETED = 1
+        SUPERSEDED = 2
+        TERMINATED = 3
diff --git a/securitycenter/google/cloud/securitycenter_v1/gapic/security_center_client.py b/securitycenter/google/cloud/securitycenter_v1/gapic/security_center_client.py
new file mode 100644
index 000000000000..ccc7c2a93a53
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/gapic/security_center_client.py
@@ -0,0 +1,2314 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.securitycenter.v1 SecurityCenter API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.securitycenter_v1.gapic import enums
+from google.cloud.securitycenter_v1.gapic import security_center_client_config
+from google.cloud.securitycenter_v1.gapic.transports import (
+    security_center_grpc_transport,
+)
+from google.cloud.securitycenter_v1.proto import finding_pb2
+from google.cloud.securitycenter_v1.proto import organization_settings_pb2
+from google.cloud.securitycenter_v1.proto import run_asset_discovery_response_pb2
+from google.cloud.securitycenter_v1.proto import security_marks_pb2
+from google.cloud.securitycenter_v1.proto import securitycenter_service_pb2
+from google.cloud.securitycenter_v1.proto import securitycenter_service_pb2_grpc
+from google.cloud.securitycenter_v1.proto import source_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-securitycenter"
+).version
+
+
+class SecurityCenterClient(object):
+    """V1 APIs for Security Center service."""
+
+    SERVICE_ADDRESS = "securitycenter.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.securitycenter.v1.SecurityCenter"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            SecurityCenterClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def asset_path(cls, organization, asset):
+        """Return a fully-qualified asset string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/assets/{asset}",
+            organization=organization,
+            asset=asset,
+        )
+
+    @classmethod
+    def asset_security_marks_path(cls, organization, asset):
+        """Return a fully-qualified asset_security_marks string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/assets/{asset}/securityMarks",
+            organization=organization,
+            asset=asset,
+        )
+
+    @classmethod
+    def finding_path(cls, organization, source, finding):
+        """Return a fully-qualified finding string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/{source}/findings/{finding}",
+            organization=organization,
+            source=source,
+            finding=finding,
+        )
+
+    @classmethod
+    def finding_security_marks_path(cls, organization, source, finding):
+        """Return a fully-qualified finding_security_marks string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/{source}/findings/{finding}/securityMarks",
+            organization=organization,
+            source=source,
+            finding=finding,
+        )
+
+    @classmethod
+    def organization_path(cls, organization):
+        """Return a fully-qualified organization string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}", organization=organization
+        )
+
+    @classmethod
+    def organization_settings_path(cls, organization):
+        """Return a fully-qualified organization_settings string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/organizationSettings",
+            organization=organization,
+        )
+
+    @classmethod
+    def organization_sources_path(cls, organization):
+        """Return a fully-qualified organization_sources string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/-", organization=organization
+        )
+
+    @classmethod
+    def source_path(cls, organization, source):
+        """Return a fully-qualified source string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/{source}",
+            organization=organization,
+            source=source,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.SecurityCenterGrpcTransport,
+                    Callable[[~.Credentials, type], ~.SecurityCenterGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = security_center_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=security_center_grpc_transport.SecurityCenterGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = security_center_grpc_transport.SecurityCenterGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_source(
+        self,
+        parent,
+        source,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # TODO: Initialize `source`:
+            >>> source = {}
+            >>>
+            >>> response = client.create_source(parent, source)
+
+        Args:
+            parent (str): Resource name of the new source's parent. Its format should be
+                "organizations/[organization\_id]".
+            source (Union[dict, ~google.cloud.securitycenter_v1.types.Source]): The Source being created, only the display\_name and description will be
+                used. All other fields will be ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Source`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Source` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_source,
+                default_retry=self._method_configs["CreateSource"].retry,
+                default_timeout=self._method_configs["CreateSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.CreateSourceRequest(
+            parent=parent, source=source
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_finding(
+        self,
+        parent,
+        finding_id,
+        finding,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a finding. The corresponding source must exist for finding creation
+        to succeed.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `finding_id`:
+            >>> finding_id = ''
+            >>>
+            >>> # TODO: Initialize `finding`:
+            >>> finding = {}
+            >>>
+            >>> response = client.create_finding(parent, finding_id, finding)
+
+        Args:
+            parent (str): Resource name of the new finding's parent. Its format should be
+                "organizations/[organization\_id]/sources/[source\_id]".
+            finding_id (str): 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.
+            finding (Union[dict, ~google.cloud.securitycenter_v1.types.Finding]): The Finding being created. The name and security\_marks will be ignored
+                as they are both output only fields on this resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Finding`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_finding" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_finding"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_finding,
+                default_retry=self._method_configs["CreateFinding"].retry,
+                default_timeout=self._method_configs["CreateFinding"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.CreateFindingRequest(
+            parent=parent, finding_id=finding_id, finding=finding
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_finding"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy on the specified Source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> resource = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.securitycenter_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_organization_settings(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the settings for an organization.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> name = client.organization_settings_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.get_organization_settings(name)
+
+        Args:
+            name (str): Name of the organization to get organization settings for. Its format is
+                "organizations/[organization\_id]/organizationSettings".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.OrganizationSettings` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_organization_settings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_organization_settings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_organization_settings,
+                default_retry=self._method_configs["GetOrganizationSettings"].retry,
+                default_timeout=self._method_configs["GetOrganizationSettings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GetOrganizationSettingsRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_organization_settings"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_source(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> name = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> response = client.get_source(name)
+
+        Args:
+            name (str): Relative resource name of the source. Its format is
+                "organizations/[organization\_id]/source/[source\_id]".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Source` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_source,
+                default_retry=self._method_configs["GetSource"].retry,
+                default_timeout=self._method_configs["GetSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GetSourceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def group_assets(
+        self,
+        parent,
+        group_by,
+        filter_=None,
+        compare_duration=None,
+        read_time=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Filters an organization's assets and  groups them by their specified
+        properties.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # TODO: Initialize `group_by`:
+            >>> group_by = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.group_assets(parent, group_by):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.group_assets(parent, group_by).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Name of the organization to groupBy. Its format is
+                "organizations/[organization\_id]".
+            group_by (str): 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\_type
+                -  security\_center\_properties.resource\_parent
+
+                The following fields are supported when compare\_duration is set:
+
+                -  security\_center\_properties.resource\_type
+            filter_ (str): 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 ``<field> <operator> <value>`` 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 \| '=', ':'
+                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 \| '=', ':'
+
+                For example, ``resource_properties.size = 100`` is a valid filter
+                string.
+            compare_duration (Union[dict, ~google.cloud.securitycenter_v1.types.Duration]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Duration`
+            read_time (Union[dict, ~google.cloud.securitycenter_v1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Timestamp`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1.types.GroupResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "group_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "group_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.group_assets,
+                default_retry=self._method_configs["GroupAssets"].retry,
+                default_timeout=self._method_configs["GroupAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GroupAssetsRequest(
+            parent=parent,
+            group_by=group_by,
+            filter=filter_,
+            compare_duration=compare_duration,
+            read_time=read_time,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["group_assets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="group_by_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def group_findings(
+        self,
+        parent,
+        group_by,
+        filter_=None,
+        read_time=None,
+        compare_duration=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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:
+        /v1/organizations/123/sources/-/findings
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `group_by`:
+            >>> group_by = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.group_findings(parent, group_by):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.group_findings(parent, group_by).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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/-
+            group_by (str): 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
+            filter_ (str): 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 ``<field> <operator> <value>`` 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 \| '=', ':' source\_properties \| '=', ':', ``>``,
+                ``<``, ``>=``, ``<=``
+
+                For example, ``source_properties.size = 100`` is a valid filter string.
+            read_time (Union[dict, ~google.cloud.securitycenter_v1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Timestamp`
+            compare_duration (Union[dict, ~google.cloud.securitycenter_v1.types.Duration]): 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``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Duration`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1.types.GroupResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "group_findings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "group_findings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.group_findings,
+                default_retry=self._method_configs["GroupFindings"].retry,
+                default_timeout=self._method_configs["GroupFindings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GroupFindingsRequest(
+            parent=parent,
+            group_by=group_by,
+            filter=filter_,
+            read_time=read_time,
+            compare_duration=compare_duration,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["group_findings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="group_by_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_assets(
+        self,
+        parent,
+        filter_=None,
+        order_by=None,
+        read_time=None,
+        compare_duration=None,
+        field_mask=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists an organization's assets.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_assets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_assets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Name of the organization assets should belong to. Its format is
+                "organizations/[organization\_id]".
+            filter_ (str): 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 ``<field> <operator> <value>`` 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 \| '=', ':'
+                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 \| '=', ':'
+
+                For example, ``resource_properties.size = 100`` is a valid filter
+                string.
+            order_by (str): 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
+                security\_center\_properties.resource\_name
+                security\_center\_properties.resource\_parent
+                security\_center\_properties.resource\_project
+                security\_center\_properties.resource\_type
+            read_time (Union[dict, ~google.cloud.securitycenter_v1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Timestamp`
+            compare_duration (Union[dict, ~google.cloud.securitycenter_v1.types.Duration]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Duration`
+            field_mask (Union[dict, ~google.cloud.securitycenter_v1.types.FieldMask]): Optional.
+
+                A field mask to specify the ListAssetsResult fields to be listed in the
+                response.
+                An empty field mask will list all fields.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.FieldMask`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1.types.ListAssetsResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_assets,
+                default_retry=self._method_configs["ListAssets"].retry,
+                default_timeout=self._method_configs["ListAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.ListAssetsRequest(
+            parent=parent,
+            filter=filter_,
+            order_by=order_by,
+            read_time=read_time,
+            compare_duration=compare_duration,
+            field_mask=field_mask,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_assets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="list_assets_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_findings(
+        self,
+        parent,
+        filter_=None,
+        order_by=None,
+        read_time=None,
+        compare_duration=None,
+        field_mask=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_findings(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_findings(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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/-
+            filter_ (str): 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 ``<field> <operator> <value>`` 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 \| '=', ':' source\_properties \| '=', ':', ``>``,
+                ``<``, ``>=``, ``<=``
+
+                For example, ``source_properties.size = 100`` is a valid filter string.
+            order_by (str): 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
+            read_time (Union[dict, ~google.cloud.securitycenter_v1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Timestamp`
+            compare_duration (Union[dict, ~google.cloud.securitycenter_v1.types.Duration]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Duration`
+            field_mask (Union[dict, ~google.cloud.securitycenter_v1.types.FieldMask]): Optional.
+
+                A field mask to specify the Finding fields to be listed in the response.
+                An empty field mask will list all fields.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.FieldMask`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1.types.ListFindingsResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_findings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_findings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_findings,
+                default_retry=self._method_configs["ListFindings"].retry,
+                default_timeout=self._method_configs["ListFindings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.ListFindingsRequest(
+            parent=parent,
+            filter=filter_,
+            order_by=order_by,
+            read_time=read_time,
+            compare_duration=compare_duration,
+            field_mask=field_mask,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_findings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="list_findings_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_sources(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all sources belonging to an organization.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_sources(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_sources(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the parent of sources to list. Its format should be
+                "organizations/[organization\_id]".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1.types.Source` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_sources" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_sources"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_sources,
+                default_retry=self._method_configs["ListSources"].retry,
+                default_timeout=self._method_configs["ListSources"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.ListSourcesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_sources"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="sources",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def run_asset_discovery(
+        self,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.run_asset_discovery(parent)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Name of the organization to run asset discovery for. Its format is
+                "organizations/[organization\_id]".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_asset_discovery" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_asset_discovery"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_asset_discovery,
+                default_retry=self._method_configs["RunAssetDiscovery"].retry,
+                default_timeout=self._method_configs["RunAssetDiscovery"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.RunAssetDiscoveryRequest(parent=parent)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["run_asset_discovery"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            run_asset_discovery_response_pb2.RunAssetDiscoveryResponse,
+            metadata_type=empty_pb2.Empty,
+        )
+
+    def set_finding_state(
+        self,
+        name,
+        state,
+        start_time,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the state of a finding.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>> from google.cloud.securitycenter_v1 import enums
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> name = client.finding_path('[ORGANIZATION]', '[SOURCE]', '[FINDING]')
+            >>>
+            >>> # TODO: Initialize `state`:
+            >>> state = enums.Finding.State.STATE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `start_time`:
+            >>> start_time = {}
+            >>>
+            >>> response = client.set_finding_state(name, state, start_time)
+
+        Args:
+            name (str): 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".
+            state (~google.cloud.securitycenter_v1.types.State): The desired State of the finding.
+            start_time (Union[dict, ~google.cloud.securitycenter_v1.types.Timestamp]): The time at which the updated state takes effect.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_finding_state" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_finding_state"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_finding_state,
+                default_retry=self._method_configs["SetFindingState"].retry,
+                default_timeout=self._method_configs["SetFindingState"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.SetFindingStateRequest(
+            name=name, state=state, start_time=start_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_finding_state"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on the specified Source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> resource = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.securitycenter_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns the permissions that a caller has on the specified source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> resource = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_finding(
+        self,
+        finding,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates or updates a finding. The corresponding source must exist for a
+        finding creation to succeed.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `finding`:
+            >>> finding = {}
+            >>>
+            >>> response = client.update_finding(finding)
+
+        Args:
+            finding (Union[dict, ~google.cloud.securitycenter_v1.types.Finding]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Finding`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1.types.FieldMask]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_finding" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_finding"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_finding,
+                default_retry=self._method_configs["UpdateFinding"].retry,
+                default_timeout=self._method_configs["UpdateFinding"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateFindingRequest(
+            finding=finding, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("finding.name", finding.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_finding"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_organization_settings(
+        self,
+        organization_settings,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an organization's settings.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `organization_settings`:
+            >>> organization_settings = {}
+            >>>
+            >>> response = client.update_organization_settings(organization_settings)
+
+        Args:
+            organization_settings (Union[dict, ~google.cloud.securitycenter_v1.types.OrganizationSettings]): The organization settings resource to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.OrganizationSettings`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1.types.FieldMask]): The FieldMask to use when updating the settings resource.
+
+                 If empty all mutable fields will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.OrganizationSettings` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_organization_settings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_organization_settings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_organization_settings,
+                default_retry=self._method_configs["UpdateOrganizationSettings"].retry,
+                default_timeout=self._method_configs[
+                    "UpdateOrganizationSettings"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateOrganizationSettingsRequest(
+            organization_settings=organization_settings, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [
+                ("organization_settings.name", organization_settings.name)
+            ]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_organization_settings"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_source(
+        self,
+        source,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `source`:
+            >>> source = {}
+            >>>
+            >>> response = client.update_source(source)
+
+        Args:
+            source (Union[dict, ~google.cloud.securitycenter_v1.types.Source]): The source resource to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Source`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1.types.FieldMask]): The FieldMask to use when updating the source resource.
+
+                If empty all mutable fields will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.Source` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_source,
+                default_retry=self._method_configs["UpdateSource"].retry,
+                default_timeout=self._method_configs["UpdateSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateSourceRequest(
+            source=source, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("source.name", source.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_security_marks(
+        self,
+        security_marks,
+        update_mask=None,
+        start_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates security marks.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1
+            >>>
+            >>> client = securitycenter_v1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `security_marks`:
+            >>> security_marks = {}
+            >>>
+            >>> response = client.update_security_marks(security_marks)
+
+        Args:
+            security_marks (Union[dict, ~google.cloud.securitycenter_v1.types.SecurityMarks]): The security marks resource to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.SecurityMarks`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1.types.FieldMask]): 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.<mark\_key>".
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.FieldMask`
+            start_time (Union[dict, ~google.cloud.securitycenter_v1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1.types.SecurityMarks` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_security_marks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_security_marks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_security_marks,
+                default_retry=self._method_configs["UpdateSecurityMarks"].retry,
+                default_timeout=self._method_configs["UpdateSecurityMarks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateSecurityMarksRequest(
+            security_marks=security_marks,
+            update_mask=update_mask,
+            start_time=start_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("security_marks.name", security_marks.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_security_marks"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/securitycenter/google/cloud/securitycenter_v1/gapic/security_center_client_config.py b/securitycenter/google/cloud/securitycenter_v1/gapic/security_center_client_config.py
new file mode 100644
index 000000000000..e25009be0fd5
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/gapic/security_center_client_config.py
@@ -0,0 +1,113 @@
+config = {
+    "interfaces": {
+        "google.cloud.securitycenter.v1.SecurityCenter": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateSource": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateFinding": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetOrganizationSettings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSource": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GroupAssets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GroupFindings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListAssets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFindings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListSources": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunAssetDiscovery": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetFindingState": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateFinding": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateOrganizationSettings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSource": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSecurityMarks": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1/gapic/transports/__init__.py b/securitycenter/google/cloud/securitycenter_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/securitycenter/google/cloud/securitycenter_v1/gapic/transports/security_center_grpc_transport.py b/securitycenter/google/cloud/securitycenter_v1/gapic/transports/security_center_grpc_transport.py
new file mode 100644
index 000000000000..f93386352719
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/gapic/transports/security_center_grpc_transport.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.securitycenter_v1.proto import securitycenter_service_pb2_grpc
+
+
+class SecurityCenterGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.securitycenter.v1 SecurityCenter API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="securitycenter.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "security_center_stub": securitycenter_service_pb2_grpc.SecurityCenterStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="securitycenter.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_source(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.create_source`.
+
+        Creates a source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].CreateSource
+
+    @property
+    def create_finding(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.create_finding`.
+
+        Creates a finding. The corresponding source must exist for finding creation
+        to succeed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].CreateFinding
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.get_iam_policy`.
+
+        Gets the access control policy on the specified Source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GetIamPolicy
+
+    @property
+    def get_organization_settings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.get_organization_settings`.
+
+        Gets the settings for an organization.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GetOrganizationSettings
+
+    @property
+    def get_source(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.get_source`.
+
+        Gets a source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GetSource
+
+    @property
+    def group_assets(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.group_assets`.
+
+        Filters an organization's assets and  groups them by their specified
+        properties.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GroupAssets
+
+    @property
+    def group_findings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.group_findings`.
+
+        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:
+        /v1/organizations/123/sources/-/findings
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GroupFindings
+
+    @property
+    def list_assets(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.list_assets`.
+
+        Lists an organization's assets.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].ListAssets
+
+    @property
+    def list_findings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.list_findings`.
+
+        Lists an organization or source's findings.
+
+        To list across all sources provide a ``-`` as the source id. Example:
+        /v1/organizations/123/sources/-/findings
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].ListFindings
+
+    @property
+    def list_sources(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.list_sources`.
+
+        Lists all sources belonging to an organization.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].ListSources
+
+    @property
+    def run_asset_discovery(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.run_asset_discovery`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].RunAssetDiscovery
+
+    @property
+    def set_finding_state(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.set_finding_state`.
+
+        Updates the state of a finding.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].SetFindingState
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.set_iam_policy`.
+
+        Sets the access control policy on the specified Source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].SetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.test_iam_permissions`.
+
+        Returns the permissions that a caller has on the specified source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].TestIamPermissions
+
+    @property
+    def update_finding(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_finding`.
+
+        Creates or updates a finding. The corresponding source must exist for a
+        finding creation to succeed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateFinding
+
+    @property
+    def update_organization_settings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_organization_settings`.
+
+        Updates an organization's settings.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateOrganizationSettings
+
+    @property
+    def update_source(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_source`.
+
+        Updates a source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateSource
+
+    @property
+    def update_security_marks(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_security_marks`.
+
+        Updates security marks.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateSecurityMarks
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/__init__.py b/securitycenter/google/cloud/securitycenter_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/asset.proto b/securitycenter/google/cloud/securitycenter_v1/proto/asset.proto
new file mode 100644
index 000000000000..74ec9b2138a6
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/asset.proto
@@ -0,0 +1,104 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1/security_marks.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.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_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+
+// 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 {
+  // 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;
+  }
+
+  // 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/123/assets/456".
+  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<string, google.protobuf.Value> 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/securitycenter/google/cloud/securitycenter_v1/proto/asset_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/asset_pb2.py
new file mode 100644
index 000000000000..68d334f060d7
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/asset_pb2.py
@@ -0,0 +1,543 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/asset.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.securitycenter_v1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2,
+)
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/asset.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/securitycenter_v1/proto/asset.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x39google/cloud/securitycenter_v1/proto/security_marks.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xcf\x05\n\x05\x41sset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x62\n\x1asecurity_center_properties\x18\x02 \x01(\x0b\x32>.google.cloud.securitycenter.v1.Asset.SecurityCenterProperties\x12Z\n\x13resource_properties\x18\x07 \x03(\x0b\x32=.google.cloud.securitycenter.v1.Asset.ResourcePropertiesEntry\x12\x45\n\x0esecurity_marks\x18\x08 \x01(\x0b\x32-.google.cloud.securitycenter.v1.SecurityMarks\x12/\n\x0b\x63reate_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x43\n\niam_policy\x18\x0b \x01(\x0b\x32/.google.cloud.securitycenter.v1.Asset.IamPolicy\x1a\x94\x01\n\x18SecurityCenterProperties\x12\x15\n\rresource_name\x18\x01 \x01(\t\x12\x15\n\rresource_type\x18\x02 \x01(\t\x12\x17\n\x0fresource_parent\x18\x03 \x01(\t\x12\x18\n\x10resource_project\x18\x04 \x01(\t\x12\x17\n\x0fresource_owners\x18\x05 \x03(\t\x1a \n\tIamPolicy\x12\x13\n\x0bpolicy_blob\x18\x01 \x01(\t\x1aQ\n\x17ResourcePropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01\x42\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_ASSET_SECURITYCENTERPROPERTIES = _descriptor.Descriptor(
+    name="SecurityCenterProperties",
+    full_name="google.cloud.securitycenter.v1.Asset.SecurityCenterProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_name",
+            full_name="google.cloud.securitycenter.v1.Asset.SecurityCenterProperties.resource_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_type",
+            full_name="google.cloud.securitycenter.v1.Asset.SecurityCenterProperties.resource_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_parent",
+            full_name="google.cloud.securitycenter.v1.Asset.SecurityCenterProperties.resource_parent",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_project",
+            full_name="google.cloud.securitycenter.v1.Asset.SecurityCenterProperties.resource_project",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_owners",
+            full_name="google.cloud.securitycenter.v1.Asset.SecurityCenterProperties.resource_owners",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=691,
+    serialized_end=839,
+)
+
+_ASSET_IAMPOLICY = _descriptor.Descriptor(
+    name="IamPolicy",
+    full_name="google.cloud.securitycenter.v1.Asset.IamPolicy",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="policy_blob",
+            full_name="google.cloud.securitycenter.v1.Asset.IamPolicy.policy_blob",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=841,
+    serialized_end=873,
+)
+
+_ASSET_RESOURCEPROPERTIESENTRY = _descriptor.Descriptor(
+    name="ResourcePropertiesEntry",
+    full_name="google.cloud.securitycenter.v1.Asset.ResourcePropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1.Asset.ResourcePropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1.Asset.ResourcePropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=875,
+    serialized_end=956,
+)
+
+_ASSET = _descriptor.Descriptor(
+    name="Asset",
+    full_name="google.cloud.securitycenter.v1.Asset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.Asset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_center_properties",
+            full_name="google.cloud.securitycenter.v1.Asset.security_center_properties",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_properties",
+            full_name="google.cloud.securitycenter.v1.Asset.resource_properties",
+            index=2,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_marks",
+            full_name="google.cloud.securitycenter.v1.Asset.security_marks",
+            index=3,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.securitycenter.v1.Asset.create_time",
+            index=4,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.securitycenter.v1.Asset.update_time",
+            index=5,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="iam_policy",
+            full_name="google.cloud.securitycenter.v1.Asset.iam_policy",
+            index=6,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _ASSET_SECURITYCENTERPROPERTIES,
+        _ASSET_IAMPOLICY,
+        _ASSET_RESOURCEPROPERTIESENTRY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=237,
+    serialized_end=956,
+)
+
+_ASSET_SECURITYCENTERPROPERTIES.containing_type = _ASSET
+_ASSET_IAMPOLICY.containing_type = _ASSET
+_ASSET_RESOURCEPROPERTIESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_ASSET_RESOURCEPROPERTIESENTRY.containing_type = _ASSET
+_ASSET.fields_by_name[
+    "security_center_properties"
+].message_type = _ASSET_SECURITYCENTERPROPERTIES
+_ASSET.fields_by_name[
+    "resource_properties"
+].message_type = _ASSET_RESOURCEPROPERTIESENTRY
+_ASSET.fields_by_name[
+    "security_marks"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2._SECURITYMARKS
+)
+_ASSET.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ASSET.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ASSET.fields_by_name["iam_policy"].message_type = _ASSET_IAMPOLICY
+DESCRIPTOR.message_types_by_name["Asset"] = _ASSET
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Asset = _reflection.GeneratedProtocolMessageType(
+    "Asset",
+    (_message.Message,),
+    dict(
+        SecurityCenterProperties=_reflection.GeneratedProtocolMessageType(
+            "SecurityCenterProperties",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ASSET_SECURITYCENTERPROPERTIES,
+                __module__="google.cloud.securitycenter_v1.proto.asset_pb2",
+                __doc__="""Cloud SCC managed properties. These properties are managed by Cloud SCC
+    and cannot be modified by the user.
+    
+    
+    Attributes:
+        resource_name:
+            The full resource name of the GCP resource this asset
+            represents. This field is immutable after create time. See: ht
+            tps://cloud.google.com/apis/design/resource\_names#full\_resou
+            rce\_name
+        resource_type:
+            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.
+        resource_parent:
+            The full resource name of the immediate parent of the
+            resource. See: https://cloud.google.com/apis/design/resource\_
+            names#full\_resource\_name
+        resource_project:
+            The full resource name of the project the resource belongs to.
+            See: https://cloud.google.com/apis/design/resource\_names#full
+            \_resource\_name
+        resource_owners:
+            Owners of the Google Cloud resource.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Asset.SecurityCenterProperties)
+            ),
+        ),
+        IamPolicy=_reflection.GeneratedProtocolMessageType(
+            "IamPolicy",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ASSET_IAMPOLICY,
+                __module__="google.cloud.securitycenter_v1.proto.asset_pb2",
+                __doc__="""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.
+    
+    
+    Attributes:
+        policy_blob:
+            The JSON representation of the Policy associated with the
+            asset. See
+            https://cloud.google.com/iam/reference/rest/v1/Policy for
+            format details.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Asset.IamPolicy)
+            ),
+        ),
+        ResourcePropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "ResourcePropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ASSET_RESOURCEPROPERTIESENTRY,
+                __module__="google.cloud.securitycenter_v1.proto.asset_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Asset.ResourcePropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_ASSET,
+        __module__="google.cloud.securitycenter_v1.proto.asset_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of this asset. See: https://cloud.g
+          oogle.com/apis/design/resource\_names#relative\_resource\_name
+          Example: "organizations/123/assets/456".
+      security_center_properties:
+          Cloud SCC managed properties. These properties are managed by
+          Cloud SCC and cannot be modified by the user.
+      resource_properties:
+          Resource managed properties. These properties are managed and
+          defined by the GCP resource and cannot be modified by the
+          user.
+      security_marks:
+          User specified security marks. These marks are entirely
+          managed by the user and come from the SecurityMarks resource
+          that belongs to the asset.
+      create_time:
+          The time at which the asset was created in Cloud SCC.
+      update_time:
+          The time at which the asset was last updated, added, or
+          deleted in Cloud SCC.
+      iam_policy:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Asset)
+    ),
+)
+_sym_db.RegisterMessage(Asset)
+_sym_db.RegisterMessage(Asset.SecurityCenterProperties)
+_sym_db.RegisterMessage(Asset.IamPolicy)
+_sym_db.RegisterMessage(Asset.ResourcePropertiesEntry)
+
+
+DESCRIPTOR._options = None
+_ASSET_RESOURCEPROPERTIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/asset_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/asset_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/asset_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/finding.proto b/securitycenter/google/cloud/securitycenter_v1/proto/finding.proto
new file mode 100644
index 000000000000..e75247e88e84
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/finding.proto
@@ -0,0 +1,102 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1/security_marks.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.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_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+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.
+message 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/123/sources/456/findings/789"
+  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"
+  string parent = 2;
+
+  // The full resource name of the Google Cloud Platform (GCP) resource this
+  // finding is for. See:
+  // https://cloud.google.com/apis/design/resource_names#full_resource_name
+  // 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<string, google.protobuf.Value> 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;
+
+  // 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.
+  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/securitycenter/google/cloud/securitycenter_v1/proto/finding_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/finding_pb2.py
new file mode 100644
index 000000000000..5b96096dee3b
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/finding_pb2.py
@@ -0,0 +1,427 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/finding.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.securitycenter_v1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2,
+)
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/finding.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/securitycenter_v1/proto/finding.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x39google/cloud/securitycenter_v1/proto/security_marks.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xb1\x04\n\x07\x46inding\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06parent\x18\x02 \x01(\t\x12\x15\n\rresource_name\x18\x03 \x01(\t\x12<\n\x05state\x18\x04 \x01(\x0e\x32-.google.cloud.securitycenter.v1.Finding.State\x12\x10\n\x08\x63\x61tegory\x18\x05 \x01(\t\x12\x14\n\x0c\x65xternal_uri\x18\x06 \x01(\t\x12X\n\x11source_properties\x18\x07 \x03(\x0b\x32=.google.cloud.securitycenter.v1.Finding.SourcePropertiesEntry\x12\x45\n\x0esecurity_marks\x18\x08 \x01(\x0b\x32-.google.cloud.securitycenter.v1.SecurityMarks\x12.\n\nevent_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1aO\n\x15SourcePropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01"8\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0c\n\x08INACTIVE\x10\x02\x42\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_FINDING_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.securitycenter.v1.Finding.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INACTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=744,
+    serialized_end=800,
+)
+_sym_db.RegisterEnumDescriptor(_FINDING_STATE)
+
+
+_FINDING_SOURCEPROPERTIESENTRY = _descriptor.Descriptor(
+    name="SourcePropertiesEntry",
+    full_name="google.cloud.securitycenter.v1.Finding.SourcePropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1.Finding.SourcePropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1.Finding.SourcePropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=663,
+    serialized_end=742,
+)
+
+_FINDING = _descriptor.Descriptor(
+    name="Finding",
+    full_name="google.cloud.securitycenter.v1.Finding",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.Finding.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.Finding.parent",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_name",
+            full_name="google.cloud.securitycenter.v1.Finding.resource_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.securitycenter.v1.Finding.state",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category",
+            full_name="google.cloud.securitycenter.v1.Finding.category",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="external_uri",
+            full_name="google.cloud.securitycenter.v1.Finding.external_uri",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_properties",
+            full_name="google.cloud.securitycenter.v1.Finding.source_properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_marks",
+            full_name="google.cloud.securitycenter.v1.Finding.security_marks",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_time",
+            full_name="google.cloud.securitycenter.v1.Finding.event_time",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.securitycenter.v1.Finding.create_time",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FINDING_SOURCEPROPERTIESENTRY],
+    enum_types=[_FINDING_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=239,
+    serialized_end=800,
+)
+
+_FINDING_SOURCEPROPERTIESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_FINDING_SOURCEPROPERTIESENTRY.containing_type = _FINDING
+_FINDING.fields_by_name["state"].enum_type = _FINDING_STATE
+_FINDING.fields_by_name[
+    "source_properties"
+].message_type = _FINDING_SOURCEPROPERTIESENTRY
+_FINDING.fields_by_name[
+    "security_marks"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2._SECURITYMARKS
+)
+_FINDING.fields_by_name[
+    "event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FINDING.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FINDING_STATE.containing_type = _FINDING
+DESCRIPTOR.message_types_by_name["Finding"] = _FINDING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Finding = _reflection.GeneratedProtocolMessageType(
+    "Finding",
+    (_message.Message,),
+    dict(
+        SourcePropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "SourcePropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FINDING_SOURCEPROPERTIESENTRY,
+                __module__="google.cloud.securitycenter_v1.proto.finding_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Finding.SourcePropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_FINDING,
+        __module__="google.cloud.securitycenter_v1.proto.finding_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of this finding. See: https://cloud
+          .google.com/apis/design/resource\_names#relative\_resource\_na
+          me Example: "organizations/123/sources/456/findings/789"
+      parent:
+          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"
+      resource_name:
+          The full resource name of the Google Cloud Platform (GCP)
+          resource this finding is for. See: https://cloud.google.com/ap
+          is/design/resource\_names#full\_resource\_name This field is
+          immutable after creation time.
+      state:
+          The state of the finding.
+      category:
+          The additional taxonomy group within findings from a given
+          source. This field is immutable after creation time. Example:
+          "XSS\_FLASH\_INJECTION"
+      external_uri:
+          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.
+      source_properties:
+          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.
+      security_marks:
+          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.
+      event_time:
+          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.
+      create_time:
+          The time at which the finding was created in Cloud SCC.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Finding)
+    ),
+)
+_sym_db.RegisterMessage(Finding)
+_sym_db.RegisterMessage(Finding.SourcePropertiesEntry)
+
+
+DESCRIPTOR._options = None
+_FINDING_SOURCEPROPERTIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/finding_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/finding_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/finding_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings.proto b/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings.proto
new file mode 100644
index 000000000000..e975e566cbae
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings.proto
@@ -0,0 +1,79 @@
+// 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.v1;
+
+import "google/api/annotations.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_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+
+// User specified settings that are attached to the Cloud Security Command
+// Center (Cloud SCC) organization.
+message 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/123/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;
+
+  reserved 4, 5;
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings_pb2.py
new file mode 100644
index 000000000000..8e9189fbb162
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings_pb2.py
@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/organization_settings.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/organization_settings.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\n@google/cloud/securitycenter_v1/proto/organization_settings.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1cgoogle/api/annotations.proto"\xaa\x03\n\x14OrganizationSettings\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1e\n\x16\x65nable_asset_discovery\x18\x02 \x01(\x08\x12i\n\x16\x61sset_discovery_config\x18\x03 \x01(\x0b\x32I.google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig\x1a\xec\x01\n\x14\x41ssetDiscoveryConfig\x12\x13\n\x0bproject_ids\x18\x01 \x03(\t\x12o\n\x0einclusion_mode\x18\x02 \x01(\x0e\x32W.google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig.InclusionMode"N\n\rInclusionMode\x12\x1e\n\x1aINCLUSION_MODE_UNSPECIFIED\x10\x00\x12\x10\n\x0cINCLUDE_ONLY\x10\x01\x12\x0b\n\x07\x45XCLUDE\x10\x02J\x04\x08\x04\x10\x05J\x04\x08\x05\x10\x06\x42\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE = _descriptor.EnumDescriptor(
+    name="InclusionMode",
+    full_name="google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig.InclusionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="INCLUSION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INCLUDE_ONLY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXCLUDE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=467,
+    serialized_end=545,
+)
+_sym_db.RegisterEnumDescriptor(_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE)
+
+
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG = _descriptor.Descriptor(
+    name="AssetDiscoveryConfig",
+    full_name="google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_ids",
+            full_name="google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig.project_ids",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inclusion_mode",
+            full_name="google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig.inclusion_mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=309,
+    serialized_end=545,
+)
+
+_ORGANIZATIONSETTINGS = _descriptor.Descriptor(
+    name="OrganizationSettings",
+    full_name="google.cloud.securitycenter.v1.OrganizationSettings",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.OrganizationSettings.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_asset_discovery",
+            full_name="google.cloud.securitycenter.v1.OrganizationSettings.enable_asset_discovery",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_discovery_config",
+            full_name="google.cloud.securitycenter.v1.OrganizationSettings.asset_discovery_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=131,
+    serialized_end=557,
+)
+
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG.fields_by_name[
+    "inclusion_mode"
+].enum_type = _ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG.containing_type = _ORGANIZATIONSETTINGS
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE.containing_type = (
+    _ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG
+)
+_ORGANIZATIONSETTINGS.fields_by_name[
+    "asset_discovery_config"
+].message_type = _ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG
+DESCRIPTOR.message_types_by_name["OrganizationSettings"] = _ORGANIZATIONSETTINGS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+OrganizationSettings = _reflection.GeneratedProtocolMessageType(
+    "OrganizationSettings",
+    (_message.Message,),
+    dict(
+        AssetDiscoveryConfig=_reflection.GeneratedProtocolMessageType(
+            "AssetDiscoveryConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG,
+                __module__="google.cloud.securitycenter_v1.proto.organization_settings_pb2",
+                __doc__="""The configuration used for Asset Discovery runs.
+    
+    
+    Attributes:
+        project_ids:
+            The project ids to use for filtering asset discovery.
+        inclusion_mode:
+            The mode to use for filtering asset discovery.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.OrganizationSettings.AssetDiscoveryConfig)
+            ),
+        ),
+        DESCRIPTOR=_ORGANIZATIONSETTINGS,
+        __module__="google.cloud.securitycenter_v1.proto.organization_settings_pb2",
+        __doc__="""User specified settings that are attached to the Cloud Security Command
+  Center (Cloud SCC) organization.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of the settings. See: https://cloud
+          .google.com/apis/design/resource\_names#relative\_resource\_na
+          me Example: "organizations/123/organizationSettings".
+      enable_asset_discovery:
+          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.
+      asset_discovery_config:
+          The configuration used for Asset Discovery runs.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.OrganizationSettings)
+    ),
+)
+_sym_db.RegisterMessage(OrganizationSettings)
+_sym_db.RegisterMessage(OrganizationSettings.AssetDiscoveryConfig)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/organization_settings_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto b/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto
new file mode 100644
index 000000000000..1cbba38e713a
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto
@@ -0,0 +1,54 @@
+// 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.v1;
+
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.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_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+
+// 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/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response_pb2.py
new file mode 100644
index 000000000000..447d1c4ad733
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response_pb2.py
@@ -0,0 +1,162 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\nGgoogle/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xe7\x01\n\x19RunAssetDiscoveryResponse\x12N\n\x05state\x18\x01 \x01(\x0e\x32?.google.cloud.securitycenter.v1.RunAssetDiscoveryResponse.State\x12+\n\x08\x64uration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"M\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\r\n\tCOMPLETED\x10\x01\x12\x0e\n\nSUPERSEDED\x10\x02\x12\x0e\n\nTERMINATED\x10\x03\x42\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_RUNASSETDISCOVERYRESPONSE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.securitycenter.v1.RunAssetDiscoveryResponse.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUPERSEDED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TERMINATED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=357,
+    serialized_end=434,
+)
+_sym_db.RegisterEnumDescriptor(_RUNASSETDISCOVERYRESPONSE_STATE)
+
+
+_RUNASSETDISCOVERYRESPONSE = _descriptor.Descriptor(
+    name="RunAssetDiscoveryResponse",
+    full_name="google.cloud.securitycenter.v1.RunAssetDiscoveryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.securitycenter.v1.RunAssetDiscoveryResponse.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="duration",
+            full_name="google.cloud.securitycenter.v1.RunAssetDiscoveryResponse.duration",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_RUNASSETDISCOVERYRESPONSE_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=203,
+    serialized_end=434,
+)
+
+_RUNASSETDISCOVERYRESPONSE.fields_by_name[
+    "state"
+].enum_type = _RUNASSETDISCOVERYRESPONSE_STATE
+_RUNASSETDISCOVERYRESPONSE.fields_by_name[
+    "duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RUNASSETDISCOVERYRESPONSE_STATE.containing_type = _RUNASSETDISCOVERYRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "RunAssetDiscoveryResponse"
+] = _RUNASSETDISCOVERYRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+RunAssetDiscoveryResponse = _reflection.GeneratedProtocolMessageType(
+    "RunAssetDiscoveryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNASSETDISCOVERYRESPONSE,
+        __module__="google.cloud.securitycenter_v1.proto.run_asset_discovery_response_pb2",
+        __doc__="""Response of asset discovery run
+  
+  
+  Attributes:
+      state:
+          The state of an asset discovery run.
+      duration:
+          The duration between asset discovery run start and end
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.RunAssetDiscoveryResponse)
+    ),
+)
+_sym_db.RegisterMessage(RunAssetDiscoveryResponse)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/run_asset_discovery_response_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/security_marks.proto b/securitycenter/google/cloud/securitycenter_v1/proto/security_marks.proto
new file mode 100644
index 000000000000..97b3f93775b8
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/security_marks.proto
@@ -0,0 +1,49 @@
+// 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.v1;
+
+import "google/api/annotations.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_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+
+// 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 {
+  // 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".
+  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<string, string> marks = 2;
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/security_marks_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/security_marks_pb2.py
new file mode 100644
index 000000000000..ab891dada5a8
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/security_marks_pb2.py
@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/security_marks.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/security_marks.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/securitycenter_v1/proto/security_marks.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1cgoogle/api/annotations.proto"\x94\x01\n\rSecurityMarks\x12\x0c\n\x04name\x18\x01 \x01(\t\x12G\n\x05marks\x18\x02 \x03(\x0b\x32\x38.google.cloud.securitycenter.v1.SecurityMarks.MarksEntry\x1a,\n\nMarksEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_SECURITYMARKS_MARKSENTRY = _descriptor.Descriptor(
+    name="MarksEntry",
+    full_name="google.cloud.securitycenter.v1.SecurityMarks.MarksEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1.SecurityMarks.MarksEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1.SecurityMarks.MarksEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=228,
+    serialized_end=272,
+)
+
+_SECURITYMARKS = _descriptor.Descriptor(
+    name="SecurityMarks",
+    full_name="google.cloud.securitycenter.v1.SecurityMarks",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.SecurityMarks.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="marks",
+            full_name="google.cloud.securitycenter.v1.SecurityMarks.marks",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SECURITYMARKS_MARKSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=124,
+    serialized_end=272,
+)
+
+_SECURITYMARKS_MARKSENTRY.containing_type = _SECURITYMARKS
+_SECURITYMARKS.fields_by_name["marks"].message_type = _SECURITYMARKS_MARKSENTRY
+DESCRIPTOR.message_types_by_name["SecurityMarks"] = _SECURITYMARKS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SecurityMarks = _reflection.GeneratedProtocolMessageType(
+    "SecurityMarks",
+    (_message.Message,),
+    dict(
+        MarksEntry=_reflection.GeneratedProtocolMessageType(
+            "MarksEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SECURITYMARKS_MARKSENTRY,
+                __module__="google.cloud.securitycenter_v1.proto.security_marks_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.SecurityMarks.MarksEntry)
+            ),
+        ),
+        DESCRIPTOR=_SECURITYMARKS,
+        __module__="google.cloud.securitycenter_v1.proto.security_marks_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of the SecurityMarks. See: https://
+          cloud.google.com/apis/design/resource\_names#relative\_resourc
+          e\_name Examples: "organizations/123/assets/456/securityMarks"
+          "organizations/123/sources/456/findings/789/securityMarks".
+      marks:
+          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)
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.SecurityMarks)
+    ),
+)
+_sym_db.RegisterMessage(SecurityMarks)
+_sym_db.RegisterMessage(SecurityMarks.MarksEntry)
+
+
+DESCRIPTOR._options = None
+_SECURITYMARKS_MARKSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/security_marks_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/security_marks_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/security_marks_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service.proto b/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service.proto
new file mode 100644
index 000000000000..0687928f3ba1
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service.proto
@@ -0,0 +1,990 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1/asset.proto";
+import "google/cloud/securitycenter/v1/finding.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";
+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.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+
+// V1 APIs for Security Center service.
+service SecurityCenter {
+  // Creates a source.
+  rpc CreateSource(CreateSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      post: "/v1/{parent=organizations/*}/sources"
+      body: "source"
+    };
+  }
+
+  // Creates a finding. The corresponding source must exist for finding creation
+  // to succeed.
+  rpc CreateFinding(CreateFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      post: "/v1/{parent=organizations/*/sources/*}/findings"
+      body: "finding"
+    };
+  }
+
+  // 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: "/v1/{resource=organizations/*/sources/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the settings for an organization.
+  rpc GetOrganizationSettings(GetOrganizationSettingsRequest)
+      returns (OrganizationSettings) {
+    option (google.api.http) = {
+      get: "/v1/{name=organizations/*/organizationSettings}"
+    };
+  }
+
+  // Gets a source.
+  rpc GetSource(GetSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      get: "/v1/{name=organizations/*/sources/*}"
+    };
+  }
+
+  // Filters an organization's assets and  groups them by their specified
+  // properties.
+  rpc GroupAssets(GroupAssetsRequest) returns (GroupAssetsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{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: /v1/organizations/123/sources/-/findings
+  rpc GroupFindings(GroupFindingsRequest) returns (GroupFindingsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=organizations/*/sources/*}/findings:group"
+      body: "*"
+    };
+  }
+
+  // Lists an organization's assets.
+  rpc ListAssets(ListAssetsRequest) returns (ListAssetsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=organizations/*}/assets"
+    };
+  }
+
+  // Lists an organization or source's findings.
+  //
+  // To list across all sources provide a `-` as the source id.
+  // Example: /v1/organizations/123/sources/-/findings
+  rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=organizations/*/sources/*}/findings"
+    };
+  }
+
+  // Lists all sources belonging to an organization.
+  rpc ListSources(ListSourcesRequest) returns (ListSourcesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=organizations/*}/sources"
+    };
+  }
+
+  // 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: "/v1/{parent=organizations/*}/assets:runDiscovery"
+      body: "*"
+    };
+  }
+
+  // Updates the state of a finding.
+  rpc SetFindingState(SetFindingStateRequest) returns (Finding) {
+    option (google.api.http) = {
+      post: "/v1/{name=organizations/*/sources/*/findings/*}:setState"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1/{resource=organizations/*/sources/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1/{resource=organizations/*/sources/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1/{finding.name=organizations/*/sources/*/findings/*}"
+      body: "finding"
+    };
+  }
+
+  // Updates an organization's settings.
+  rpc UpdateOrganizationSettings(UpdateOrganizationSettingsRequest)
+      returns (OrganizationSettings) {
+    option (google.api.http) = {
+      patch: "/v1/{organization_settings.name=organizations/*/organizationSettings}"
+      body: "organization_settings"
+    };
+  }
+
+  // Updates a source.
+  rpc UpdateSource(UpdateSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      patch: "/v1/{source.name=organizations/*/sources/*}"
+      body: "source"
+    };
+  }
+
+  // Updates security marks.
+  rpc UpdateSecurityMarks(UpdateSecurityMarksRequest) returns (SecurityMarks) {
+    option (google.api.http) = {
+      patch: "/v1/{security_marks.name=organizations/*/assets/*/securityMarks}"
+      body: "security_marks"
+      additional_bindings {
+        patch: "/v1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}"
+        body: "security_marks"
+      }
+    };
+  }
+}
+
+// Request message for creating a finding.
+message CreateFindingRequest {
+  // Resource name of the new finding's parent. Its format should be
+  // "organizations/[organization_id]/sources/[source_id]".
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Request message for creating a source.
+message CreateSourceRequest {
+  // Resource name of the new source's parent. Its format should be
+  // "organizations/[organization_id]".
+  string parent = 1;
+
+  // The Source being created, only the display_name and description will be
+  // used. All other fields will be ignored.
+  Source source = 2;
+}
+
+// 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;
+}
+
+// Request message for getting a source.
+message GetSourceRequest {
+  // Relative resource name of the source. Its format is
+  // "organizations/[organization_id]/source/[source_id]".
+  string name = 1;
+}
+
+// Request message for grouping by assets.
+message GroupAssetsRequest {
+  // Name of the organization to groupBy. Its format is
+  // "organizations/[organization_id]".
+  string parent = 1;
+
+  // 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 `<field> <operator> <value>` 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 | '=', ':'
+  // 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 | '=', ':'
+  //
+  // 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:
+  // "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_type
+  // * security_center_properties.resource_parent
+  //
+  // The following fields are supported when compare_duration is set:
+  //
+  // * security_center_properties.resource_type
+  string group_by = 3;
+
+  // 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;
+
+  // 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;
+
+  reserved 6;
+}
+
+// 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 {
+  // 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;
+
+  // 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 `<field> <operator> <value>` 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 | '=', ':'
+  // 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".
+  //
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  reserved 6;
+}
+
+// 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<string, google.protobuf.Value> properties = 1;
+
+  // Total count of resources for the given properties.
+  int64 count = 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;
+
+  // 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 {
+  // Name of the organization assets should belong to. Its format is
+  // "organizations/[organization_id]".
+  string parent = 1;
+
+  // 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 `<field> <operator> <value>` 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 | '=', ':'
+  // 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 | '=', ':'
+  //
+  // 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
+  // security_center_properties.resource_name
+  // security_center_properties.resource_parent
+  // security_center_properties.resource_project
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  reserved 6;
+}
+
+// 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 {
+  // 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;
+
+  // 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 `<field> <operator> <value>` 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 | '=', ':'
+  // 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
+  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;
+
+  // 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;
+
+  // 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;
+
+  reserved 6;
+}
+
+// Response message for listing findings.
+message ListFindingsResponse {
+  // Result containing the Finding and its StateChange.
+  message ListFindingsResult {
+    // 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;
+  }
+
+  // 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 {
+  // 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;
+
+  // The desired State of the finding.
+  Finding.State state = 2;
+
+  // The time at which the updated state takes effect.
+  google.protobuf.Timestamp start_time = 3;
+}
+
+// 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;
+}
+
+// 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.
+  //
+  // 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;
+
+  // 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.<property key>" in the field
+  // mask.
+  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;
+
+  // 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 {
+  // The source resource to update.
+  Source source = 1;
+
+  // 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 {
+  // The security marks resource to update.
+  SecurityMarks security_marks = 1;
+
+  // 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.<mark_key>".
+  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/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service_pb2.py
new file mode 100644
index 000000000000..87d92ccf653a
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service_pb2.py
@@ -0,0 +1,3286 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/securitycenter_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.securitycenter_v1.proto import (
+    asset_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_asset__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    finding_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    organization_settings_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    run_asset_discovery_response_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_run__asset__discovery__response__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    source_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/securitycenter_service.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\nAgoogle/cloud/securitycenter_v1/proto/securitycenter_service.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x30google/cloud/securitycenter_v1/proto/asset.proto\x1a\x32google/cloud/securitycenter_v1/proto/finding.proto\x1a@google/cloud/securitycenter_v1/proto/organization_settings.proto\x1aGgoogle/cloud/securitycenter_v1/proto/run_asset_discovery_response.proto\x1a\x39google/cloud/securitycenter_v1/proto/security_marks.proto\x1a\x31google/cloud/securitycenter_v1/proto/source.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"t\n\x14\x43reateFindingRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\nfinding_id\x18\x02 \x01(\t\x12\x38\n\x07\x66inding\x18\x03 \x01(\x0b\x32\'.google.cloud.securitycenter.v1.Finding"]\n\x13\x43reateSourceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x36\n\x06source\x18\x02 \x01(\x0b\x32&.google.cloud.securitycenter.v1.Source".\n\x1eGetOrganizationSettingsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t" \n\x10GetSourceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xd7\x01\n\x12GroupAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08group_by\x18\x03 \x01(\t\x12\x33\n\x10\x63ompare_duration\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12-\n\tread_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\npage_token\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x08 \x01(\x05J\x04\x08\x06\x10\x07"\xb8\x01\n\x13GroupAssetsResponse\x12\x45\n\x10group_by_results\x18\x01 \x03(\x0b\x32+.google.cloud.securitycenter.v1.GroupResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12\x12\n\ntotal_size\x18\x04 \x01(\x05"\xd9\x01\n\x14GroupFindingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08group_by\x18\x03 \x01(\t\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x10\x63ompare_duration\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\npage_token\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x08 \x01(\x05J\x04\x08\x06\x10\x07"\xba\x01\n\x15GroupFindingsResponse\x12\x45\n\x10group_by_results\x18\x01 \x03(\x0b\x32+.google.cloud.securitycenter.v1.GroupResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12\x12\n\ntotal_size\x18\x04 \x01(\x05"\xb8\x01\n\x0bGroupResult\x12O\n\nproperties\x18\x01 \x03(\x0b\x32;.google.cloud.securitycenter.v1.GroupResult.PropertiesEntry\x12\r\n\x05\x63ount\x18\x02 \x01(\x03\x1aI\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01"K\n\x12ListSourcesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x07 \x01(\x05"g\n\x13ListSourcesResponse\x12\x37\n\x07sources\x18\x01 \x03(\x0b\x32&.google.cloud.securitycenter.v1.Source\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x86\x02\n\x11ListAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08order_by\x18\x03 \x01(\t\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x10\x63ompare_duration\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\nfield_mask\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x12\n\npage_token\x18\x08 \x01(\t\x12\x11\n\tpage_size\x18\t \x01(\x05J\x04\x08\x06\x10\x07"\xc3\x03\n\x12ListAssetsResponse\x12`\n\x13list_assets_results\x18\x01 \x03(\x0b\x32\x43.google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12\x12\n\ntotal_size\x18\x04 \x01(\x05\x1a\xee\x01\n\x10ListAssetsResult\x12\x34\n\x05\x61sset\x18\x01 \x01(\x0b\x32%.google.cloud.securitycenter.v1.Asset\x12\x65\n\x0cstate_change\x18\x02 \x01(\x0e\x32O.google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult.StateChange"=\n\x0bStateChange\x12\n\n\x06UNUSED\x10\x00\x12\t\n\x05\x41\x44\x44\x45\x44\x10\x01\x12\x0b\n\x07REMOVED\x10\x02\x12\n\n\x06\x41\x43TIVE\x10\x03"\x88\x02\n\x13ListFindingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08order_by\x18\x03 \x01(\t\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x10\x63ompare_duration\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\nfield_mask\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x12\n\npage_token\x18\x08 \x01(\t\x12\x11\n\tpage_size\x18\t \x01(\x05J\x04\x08\x06\x10\x07"\xe5\x03\n\x14ListFindingsResponse\x12\x66\n\x15list_findings_results\x18\x01 \x03(\x0b\x32G.google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12\x12\n\ntotal_size\x18\x04 \x01(\x05\x1a\x88\x02\n\x12ListFindingsResult\x12\x38\n\x07\x66inding\x18\x01 \x01(\x0b\x32\'.google.cloud.securitycenter.v1.Finding\x12i\n\x0cstate_change\x18\x02 \x01(\x0e\x32S.google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult.StateChange"M\n\x0bStateChange\x12\n\n\x06UNUSED\x10\x00\x12\x0b\n\x07\x43HANGED\x10\x01\x12\r\n\tUNCHANGED\x10\x02\x12\t\n\x05\x41\x44\x44\x45\x44\x10\x03\x12\x0b\n\x07REMOVED\x10\x04"\x94\x01\n\x16SetFindingStateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12<\n\x05state\x18\x02 \x01(\x0e\x32-.google.cloud.securitycenter.v1.Finding.State\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"*\n\x18RunAssetDiscoveryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t"\x81\x01\n\x14UpdateFindingRequest\x12\x38\n\x07\x66inding\x18\x01 \x01(\x0b\x32\'.google.cloud.securitycenter.v1.Finding\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xa9\x01\n!UpdateOrganizationSettingsRequest\x12S\n\x15organization_settings\x18\x01 \x01(\x0b\x32\x34.google.cloud.securitycenter.v1.OrganizationSettings\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"~\n\x13UpdateSourceRequest\x12\x36\n\x06source\x18\x01 \x01(\x0b\x32&.google.cloud.securitycenter.v1.Source\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xc4\x01\n\x1aUpdateSecurityMarksRequest\x12\x45\n\x0esecurity_marks\x18\x01 \x01(\x0b\x32-.google.cloud.securitycenter.v1.SecurityMarks\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\x90\x1a\n\x0eSecurityCenter\x12\xa1\x01\n\x0c\x43reateSource\x12\x33.google.cloud.securitycenter.v1.CreateSourceRequest\x1a&.google.cloud.securitycenter.v1.Source"4\x82\xd3\xe4\x93\x02."$/v1/{parent=organizations/*}/sources:\x06source\x12\xb0\x01\n\rCreateFinding\x12\x34.google.cloud.securitycenter.v1.CreateFindingRequest\x1a\'.google.cloud.securitycenter.v1.Finding"@\x82\xd3\xe4\x93\x02:"//v1/{parent=organizations/*/sources/*}/findings:\x07\x66inding\x12\x8b\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"@\x82\xd3\xe4\x93\x02:"5/v1/{resource=organizations/*/sources/*}:getIamPolicy:\x01*\x12\xc8\x01\n\x17GetOrganizationSettings\x12>.google.cloud.securitycenter.v1.GetOrganizationSettingsRequest\x1a\x34.google.cloud.securitycenter.v1.OrganizationSettings"7\x82\xd3\xe4\x93\x02\x31\x12//v1/{name=organizations/*/organizationSettings}\x12\x93\x01\n\tGetSource\x12\x30.google.cloud.securitycenter.v1.GetSourceRequest\x1a&.google.cloud.securitycenter.v1.Source",\x82\xd3\xe4\x93\x02&\x12$/v1/{name=organizations/*/sources/*}\x12\xac\x01\n\x0bGroupAssets\x12\x32.google.cloud.securitycenter.v1.GroupAssetsRequest\x1a\x33.google.cloud.securitycenter.v1.GroupAssetsResponse"4\x82\xd3\xe4\x93\x02.")/v1/{parent=organizations/*}/assets:group:\x01*\x12\xbe\x01\n\rGroupFindings\x12\x34.google.cloud.securitycenter.v1.GroupFindingsRequest\x1a\x35.google.cloud.securitycenter.v1.GroupFindingsResponse"@\x82\xd3\xe4\x93\x02:"5/v1/{parent=organizations/*/sources/*}/findings:group:\x01*\x12\xa0\x01\n\nListAssets\x12\x31.google.cloud.securitycenter.v1.ListAssetsRequest\x1a\x32.google.cloud.securitycenter.v1.ListAssetsResponse"+\x82\xd3\xe4\x93\x02%\x12#/v1/{parent=organizations/*}/assets\x12\xb2\x01\n\x0cListFindings\x12\x33.google.cloud.securitycenter.v1.ListFindingsRequest\x1a\x34.google.cloud.securitycenter.v1.ListFindingsResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v1/{parent=organizations/*/sources/*}/findings\x12\xa4\x01\n\x0bListSources\x12\x32.google.cloud.securitycenter.v1.ListSourcesRequest\x1a\x33.google.cloud.securitycenter.v1.ListSourcesResponse",\x82\xd3\xe4\x93\x02&\x12$/v1/{parent=organizations/*}/sources\x12\xa9\x01\n\x11RunAssetDiscovery\x12\x38.google.cloud.securitycenter.v1.RunAssetDiscoveryRequest\x1a\x1d.google.longrunning.Operation";\x82\xd3\xe4\x93\x02\x35"0/v1/{parent=organizations/*}/assets:runDiscovery:\x01*\x12\xb7\x01\n\x0fSetFindingState\x12\x36.google.cloud.securitycenter.v1.SetFindingStateRequest\x1a\'.google.cloud.securitycenter.v1.Finding"C\x82\xd3\xe4\x93\x02="8/v1/{name=organizations/*/sources/*/findings/*}:setState:\x01*\x12\x8b\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"@\x82\xd3\xe4\x93\x02:"5/v1/{resource=organizations/*/sources/*}:setIamPolicy:\x01*\x12\xb1\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"F\x82\xd3\xe4\x93\x02@";/v1/{resource=organizations/*/sources/*}:testIamPermissions:\x01*\x12\xb8\x01\n\rUpdateFinding\x12\x34.google.cloud.securitycenter.v1.UpdateFindingRequest\x1a\'.google.cloud.securitycenter.v1.Finding"H\x82\xd3\xe4\x93\x02\x42\x32\x37/v1/{finding.name=organizations/*/sources/*/findings/*}:\x07\x66inding\x12\xfb\x01\n\x1aUpdateOrganizationSettings\x12\x41.google.cloud.securitycenter.v1.UpdateOrganizationSettingsRequest\x1a\x34.google.cloud.securitycenter.v1.OrganizationSettings"d\x82\xd3\xe4\x93\x02^2E/v1/{organization_settings.name=organizations/*/organizationSettings}:\x15organization_settings\x12\xa8\x01\n\x0cUpdateSource\x12\x33.google.cloud.securitycenter.v1.UpdateSourceRequest\x1a&.google.cloud.securitycenter.v1.Source";\x82\xd3\xe4\x93\x02\x35\x32+/v1/{source.name=organizations/*/sources/*}:\x06source\x12\xbc\x02\n\x13UpdateSecurityMarks\x12:.google.cloud.securitycenter.v1.UpdateSecurityMarksRequest\x1a-.google.cloud.securitycenter.v1.SecurityMarks"\xb9\x01\x82\xd3\xe4\x93\x02\xb2\x01\x32@/v1/{security_marks.name=organizations/*/assets/*/securityMarks}:\x0esecurity_marksZ^2L/v1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}:\x0esecurity_marksB\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_asset__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_run__asset__discovery__response__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTASSETSRESPONSE_LISTASSETSRESULT_STATECHANGE = _descriptor.EnumDescriptor(
+    name="StateChange",
+    full_name="google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult.StateChange",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNUSED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2871,
+    serialized_end=2932,
+)
+_sym_db.RegisterEnumDescriptor(_LISTASSETSRESPONSE_LISTASSETSRESULT_STATECHANGE)
+
+_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT_STATECHANGE = _descriptor.EnumDescriptor(
+    name="StateChange",
+    full_name="google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult.StateChange",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNUSED", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHANGED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNCHANGED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3610,
+    serialized_end=3687,
+)
+_sym_db.RegisterEnumDescriptor(_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT_STATECHANGE)
+
+
+_CREATEFINDINGREQUEST = _descriptor.Descriptor(
+    name="CreateFindingRequest",
+    full_name="google.cloud.securitycenter.v1.CreateFindingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.CreateFindingRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding_id",
+            full_name="google.cloud.securitycenter.v1.CreateFindingRequest.finding_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding",
+            full_name="google.cloud.securitycenter.v1.CreateFindingRequest.finding",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=737,
+    serialized_end=853,
+)
+
+
+_CREATESOURCEREQUEST = _descriptor.Descriptor(
+    name="CreateSourceRequest",
+    full_name="google.cloud.securitycenter.v1.CreateSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.CreateSourceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.securitycenter.v1.CreateSourceRequest.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=855,
+    serialized_end=948,
+)
+
+
+_GETORGANIZATIONSETTINGSREQUEST = _descriptor.Descriptor(
+    name="GetOrganizationSettingsRequest",
+    full_name="google.cloud.securitycenter.v1.GetOrganizationSettingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.GetOrganizationSettingsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=950,
+    serialized_end=996,
+)
+
+
+_GETSOURCEREQUEST = _descriptor.Descriptor(
+    name="GetSourceRequest",
+    full_name="google.cloud.securitycenter.v1.GetSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.GetSourceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=998,
+    serialized_end=1030,
+)
+
+
+_GROUPASSETSREQUEST = _descriptor.Descriptor(
+    name="GroupAssetsRequest",
+    full_name="google.cloud.securitycenter.v1.GroupAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_by",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.group_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compare_duration",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.compare_duration",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.read_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.page_token",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsRequest.page_size",
+            index=6,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1033,
+    serialized_end=1248,
+)
+
+
+_GROUPASSETSRESPONSE = _descriptor.Descriptor(
+    name="GroupAssetsResponse",
+    full_name="google.cloud.securitycenter.v1.GroupAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group_by_results",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsResponse.group_by_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.securitycenter.v1.GroupAssetsResponse.total_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1251,
+    serialized_end=1435,
+)
+
+
+_GROUPFINDINGSREQUEST = _descriptor.Descriptor(
+    name="GroupFindingsRequest",
+    full_name="google.cloud.securitycenter.v1.GroupFindingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_by",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.group_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compare_duration",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.compare_duration",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.page_token",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsRequest.page_size",
+            index=6,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1438,
+    serialized_end=1655,
+)
+
+
+_GROUPFINDINGSRESPONSE = _descriptor.Descriptor(
+    name="GroupFindingsResponse",
+    full_name="google.cloud.securitycenter.v1.GroupFindingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group_by_results",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsResponse.group_by_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.securitycenter.v1.GroupFindingsResponse.total_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1658,
+    serialized_end=1844,
+)
+
+
+_GROUPRESULT_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.securitycenter.v1.GroupResult.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1.GroupResult.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1.GroupResult.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1958,
+    serialized_end=2031,
+)
+
+_GROUPRESULT = _descriptor.Descriptor(
+    name="GroupResult",
+    full_name="google.cloud.securitycenter.v1.GroupResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.securitycenter.v1.GroupResult.properties",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.securitycenter.v1.GroupResult.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GROUPRESULT_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1847,
+    serialized_end=2031,
+)
+
+
+_LISTSOURCESREQUEST = _descriptor.Descriptor(
+    name="ListSourcesRequest",
+    full_name="google.cloud.securitycenter.v1.ListSourcesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.ListSourcesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1.ListSourcesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1.ListSourcesRequest.page_size",
+            index=2,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2033,
+    serialized_end=2108,
+)
+
+
+_LISTSOURCESRESPONSE = _descriptor.Descriptor(
+    name="ListSourcesResponse",
+    full_name="google.cloud.securitycenter.v1.ListSourcesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sources",
+            full_name="google.cloud.securitycenter.v1.ListSourcesResponse.sources",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1.ListSourcesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2110,
+    serialized_end=2213,
+)
+
+
+_LISTASSETSREQUEST = _descriptor.Descriptor(
+    name="ListAssetsRequest",
+    full_name="google.cloud.securitycenter.v1.ListAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.order_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compare_duration",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.compare_duration",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.field_mask",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.page_token",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1.ListAssetsRequest.page_size",
+            index=7,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2216,
+    serialized_end=2478,
+)
+
+
+_LISTASSETSRESPONSE_LISTASSETSRESULT = _descriptor.Descriptor(
+    name="ListAssetsResult",
+    full_name="google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="asset",
+            full_name="google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult.asset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_change",
+            full_name="google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult.state_change",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTASSETSRESPONSE_LISTASSETSRESULT_STATECHANGE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2694,
+    serialized_end=2932,
+)
+
+_LISTASSETSRESPONSE = _descriptor.Descriptor(
+    name="ListAssetsResponse",
+    full_name="google.cloud.securitycenter.v1.ListAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="list_assets_results",
+            full_name="google.cloud.securitycenter.v1.ListAssetsResponse.list_assets_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.ListAssetsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1.ListAssetsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.securitycenter.v1.ListAssetsResponse.total_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LISTASSETSRESPONSE_LISTASSETSRESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2481,
+    serialized_end=2932,
+)
+
+
+_LISTFINDINGSREQUEST = _descriptor.Descriptor(
+    name="ListFindingsRequest",
+    full_name="google.cloud.securitycenter.v1.ListFindingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.order_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compare_duration",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.compare_duration",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.field_mask",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.page_token",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1.ListFindingsRequest.page_size",
+            index=7,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2935,
+    serialized_end=3199,
+)
+
+
+_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT = _descriptor.Descriptor(
+    name="ListFindingsResult",
+    full_name="google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding",
+            full_name="google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult.finding",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_change",
+            full_name="google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult.state_change",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT_STATECHANGE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3423,
+    serialized_end=3687,
+)
+
+_LISTFINDINGSRESPONSE = _descriptor.Descriptor(
+    name="ListFindingsResponse",
+    full_name="google.cloud.securitycenter.v1.ListFindingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="list_findings_results",
+            full_name="google.cloud.securitycenter.v1.ListFindingsResponse.list_findings_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1.ListFindingsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1.ListFindingsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.securitycenter.v1.ListFindingsResponse.total_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3202,
+    serialized_end=3687,
+)
+
+
+_SETFINDINGSTATEREQUEST = _descriptor.Descriptor(
+    name="SetFindingStateRequest",
+    full_name="google.cloud.securitycenter.v1.SetFindingStateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.SetFindingStateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.securitycenter.v1.SetFindingStateRequest.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.securitycenter.v1.SetFindingStateRequest.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3690,
+    serialized_end=3838,
+)
+
+
+_RUNASSETDISCOVERYREQUEST = _descriptor.Descriptor(
+    name="RunAssetDiscoveryRequest",
+    full_name="google.cloud.securitycenter.v1.RunAssetDiscoveryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1.RunAssetDiscoveryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3840,
+    serialized_end=3882,
+)
+
+
+_UPDATEFINDINGREQUEST = _descriptor.Descriptor(
+    name="UpdateFindingRequest",
+    full_name="google.cloud.securitycenter.v1.UpdateFindingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding",
+            full_name="google.cloud.securitycenter.v1.UpdateFindingRequest.finding",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1.UpdateFindingRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3885,
+    serialized_end=4014,
+)
+
+
+_UPDATEORGANIZATIONSETTINGSREQUEST = _descriptor.Descriptor(
+    name="UpdateOrganizationSettingsRequest",
+    full_name="google.cloud.securitycenter.v1.UpdateOrganizationSettingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="organization_settings",
+            full_name="google.cloud.securitycenter.v1.UpdateOrganizationSettingsRequest.organization_settings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1.UpdateOrganizationSettingsRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4017,
+    serialized_end=4186,
+)
+
+
+_UPDATESOURCEREQUEST = _descriptor.Descriptor(
+    name="UpdateSourceRequest",
+    full_name="google.cloud.securitycenter.v1.UpdateSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.securitycenter.v1.UpdateSourceRequest.source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1.UpdateSourceRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4188,
+    serialized_end=4314,
+)
+
+
+_UPDATESECURITYMARKSREQUEST = _descriptor.Descriptor(
+    name="UpdateSecurityMarksRequest",
+    full_name="google.cloud.securitycenter.v1.UpdateSecurityMarksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="security_marks",
+            full_name="google.cloud.securitycenter.v1.UpdateSecurityMarksRequest.security_marks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1.UpdateSecurityMarksRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.securitycenter.v1.UpdateSecurityMarksRequest.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4317,
+    serialized_end=4513,
+)
+
+_CREATEFINDINGREQUEST.fields_by_name[
+    "finding"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING
+)
+_CREATESOURCEREQUEST.fields_by_name[
+    "source"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2._SOURCE
+)
+_GROUPASSETSREQUEST.fields_by_name[
+    "compare_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_GROUPASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPASSETSRESPONSE.fields_by_name["group_by_results"].message_type = _GROUPRESULT
+_GROUPASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPFINDINGSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPFINDINGSREQUEST.fields_by_name[
+    "compare_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_GROUPFINDINGSRESPONSE.fields_by_name["group_by_results"].message_type = _GROUPRESULT
+_GROUPFINDINGSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPRESULT_PROPERTIESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_GROUPRESULT_PROPERTIESENTRY.containing_type = _GROUPRESULT
+_GROUPRESULT.fields_by_name["properties"].message_type = _GROUPRESULT_PROPERTIESENTRY
+_LISTSOURCESRESPONSE.fields_by_name[
+    "sources"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2._SOURCE
+)
+_LISTASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTASSETSREQUEST.fields_by_name[
+    "compare_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LISTASSETSREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTASSETSRESPONSE_LISTASSETSRESULT.fields_by_name[
+    "asset"
+].message_type = google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_asset__pb2._ASSET
+_LISTASSETSRESPONSE_LISTASSETSRESULT.fields_by_name[
+    "state_change"
+].enum_type = _LISTASSETSRESPONSE_LISTASSETSRESULT_STATECHANGE
+_LISTASSETSRESPONSE_LISTASSETSRESULT.containing_type = _LISTASSETSRESPONSE
+_LISTASSETSRESPONSE_LISTASSETSRESULT_STATECHANGE.containing_type = (
+    _LISTASSETSRESPONSE_LISTASSETSRESULT
+)
+_LISTASSETSRESPONSE.fields_by_name[
+    "list_assets_results"
+].message_type = _LISTASSETSRESPONSE_LISTASSETSRESULT
+_LISTASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTFINDINGSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTFINDINGSREQUEST.fields_by_name[
+    "compare_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LISTFINDINGSREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT.fields_by_name[
+    "finding"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING
+)
+_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT.fields_by_name[
+    "state_change"
+].enum_type = _LISTFINDINGSRESPONSE_LISTFINDINGSRESULT_STATECHANGE
+_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT.containing_type = _LISTFINDINGSRESPONSE
+_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT_STATECHANGE.containing_type = (
+    _LISTFINDINGSRESPONSE_LISTFINDINGSRESULT
+)
+_LISTFINDINGSRESPONSE.fields_by_name[
+    "list_findings_results"
+].message_type = _LISTFINDINGSRESPONSE_LISTFINDINGSRESULT
+_LISTFINDINGSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SETFINDINGSTATEREQUEST.fields_by_name[
+    "state"
+].enum_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING_STATE
+)
+_SETFINDINGSTATEREQUEST.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEFINDINGREQUEST.fields_by_name[
+    "finding"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING
+)
+_UPDATEFINDINGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEORGANIZATIONSETTINGSREQUEST.fields_by_name[
+    "organization_settings"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2._ORGANIZATIONSETTINGS
+)
+_UPDATEORGANIZATIONSETTINGSREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATESOURCEREQUEST.fields_by_name[
+    "source"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2._SOURCE
+)
+_UPDATESOURCEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATESECURITYMARKSREQUEST.fields_by_name[
+    "security_marks"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2._SECURITYMARKS
+)
+_UPDATESECURITYMARKSREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATESECURITYMARKSREQUEST.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["CreateFindingRequest"] = _CREATEFINDINGREQUEST
+DESCRIPTOR.message_types_by_name["CreateSourceRequest"] = _CREATESOURCEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetOrganizationSettingsRequest"
+] = _GETORGANIZATIONSETTINGSREQUEST
+DESCRIPTOR.message_types_by_name["GetSourceRequest"] = _GETSOURCEREQUEST
+DESCRIPTOR.message_types_by_name["GroupAssetsRequest"] = _GROUPASSETSREQUEST
+DESCRIPTOR.message_types_by_name["GroupAssetsResponse"] = _GROUPASSETSRESPONSE
+DESCRIPTOR.message_types_by_name["GroupFindingsRequest"] = _GROUPFINDINGSREQUEST
+DESCRIPTOR.message_types_by_name["GroupFindingsResponse"] = _GROUPFINDINGSRESPONSE
+DESCRIPTOR.message_types_by_name["GroupResult"] = _GROUPRESULT
+DESCRIPTOR.message_types_by_name["ListSourcesRequest"] = _LISTSOURCESREQUEST
+DESCRIPTOR.message_types_by_name["ListSourcesResponse"] = _LISTSOURCESRESPONSE
+DESCRIPTOR.message_types_by_name["ListAssetsRequest"] = _LISTASSETSREQUEST
+DESCRIPTOR.message_types_by_name["ListAssetsResponse"] = _LISTASSETSRESPONSE
+DESCRIPTOR.message_types_by_name["ListFindingsRequest"] = _LISTFINDINGSREQUEST
+DESCRIPTOR.message_types_by_name["ListFindingsResponse"] = _LISTFINDINGSRESPONSE
+DESCRIPTOR.message_types_by_name["SetFindingStateRequest"] = _SETFINDINGSTATEREQUEST
+DESCRIPTOR.message_types_by_name["RunAssetDiscoveryRequest"] = _RUNASSETDISCOVERYREQUEST
+DESCRIPTOR.message_types_by_name["UpdateFindingRequest"] = _UPDATEFINDINGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateOrganizationSettingsRequest"
+] = _UPDATEORGANIZATIONSETTINGSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateSourceRequest"] = _UPDATESOURCEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateSecurityMarksRequest"
+] = _UPDATESECURITYMARKSREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateFindingRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateFindingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEFINDINGREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for creating a finding.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the new finding's parent. Its format should
+          be "organizations/[organization\_id]/sources/[source\_id]".
+      finding_id:
+          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.
+      finding:
+          The Finding being created. The name and security\_marks will
+          be ignored as they are both output only fields on this
+          resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.CreateFindingRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateFindingRequest)
+
+CreateSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESOURCEREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for creating a source.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the new source's parent. Its format should be
+          "organizations/[organization\_id]".
+      source:
+          The Source being created, only the display\_name and
+          description will be used. All other fields will be ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.CreateSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSourceRequest)
+
+GetOrganizationSettingsRequest = _reflection.GeneratedProtocolMessageType(
+    "GetOrganizationSettingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETORGANIZATIONSETTINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for getting organization settings.
+  
+  
+  Attributes:
+      name:
+          Name of the organization to get organization settings for. Its
+          format is
+          "organizations/[organization\_id]/organizationSettings".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GetOrganizationSettingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetOrganizationSettingsRequest)
+
+GetSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSOURCEREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for getting a source.
+  
+  
+  Attributes:
+      name:
+          Relative resource name of the source. Its format is
+          "organizations/[organization\_id]/source/[source\_id]".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GetSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSourceRequest)
+
+GroupAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "GroupAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPASSETSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for grouping by assets.
+  
+  
+  Attributes:
+      parent:
+          Name of the organization to groupBy. Its format is
+          "organizations/[organization\_id]".
+      filter:
+          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 ``<field> <operator> <value>`` 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 \| '=', ':'
+          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 \| '=', ':'  For
+          example, ``resource_properties.size = 100`` is a valid filter
+          string.
+      group_by:
+          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\_prop
+          erties.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\_type -
+          security\_center\_properties.resource\_parent  The following
+          fields are supported when compare\_duration is set:  -
+          security\_center\_properties.resource\_type
+      compare_duration:
+          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``.
+      read_time:
+          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.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GroupAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(GroupAssetsRequest)
+
+GroupAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "GroupAssetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPASSETSRESPONSE,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for grouping by assets.
+  
+  
+  Attributes:
+      group_by_results:
+          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.
+      read_time:
+          Time used for executing the groupBy request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+      total_size:
+          The total number of results matching the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GroupAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(GroupAssetsResponse)
+
+GroupFindingsRequest = _reflection.GeneratedProtocolMessageType(
+    "GroupFindingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPFINDINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for grouping by findings.
+  
+  
+  Attributes:
+      parent:
+          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/-
+      filter:
+          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 ``<field> <operator> <value>`` 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 \| '=', ':' source\_properties \| '=', ':',
+          ``>``, ``<``, ``>=``, ``<=``  For example,
+          ``source_properties.size = 100`` is a valid filter string.
+      group_by:
+          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
+      read_time:
+          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.
+      compare_duration:
+          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``.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GroupFindingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(GroupFindingsRequest)
+
+GroupFindingsResponse = _reflection.GeneratedProtocolMessageType(
+    "GroupFindingsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPFINDINGSRESPONSE,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for group by findings.
+  
+  
+  Attributes:
+      group_by_results:
+          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.
+      read_time:
+          Time used for executing the groupBy request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+      total_size:
+          The total number of results matching the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GroupFindingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(GroupFindingsResponse)
+
+GroupResult = _reflection.GeneratedProtocolMessageType(
+    "GroupResult",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GROUPRESULT_PROPERTIESENTRY,
+                __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GroupResult.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_GROUPRESULT,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Result containing the properties and count of a groupBy request.
+  
+  
+  Attributes:
+      properties:
+          Properties matching the groupBy fields in the request.
+      count:
+          Total count of resources for the given properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.GroupResult)
+    ),
+)
+_sym_db.RegisterMessage(GroupResult)
+_sym_db.RegisterMessage(GroupResult.PropertiesEntry)
+
+ListSourcesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSourcesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSOURCESREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for listing sources.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the parent of sources to list. Its format
+          should be "organizations/[organization\_id]".
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListSourcesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSourcesRequest)
+
+ListSourcesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSourcesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSOURCESRESPONSE,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for listing sources.
+  
+  
+  Attributes:
+      sources:
+          Sources belonging to the requested parent.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListSourcesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSourcesResponse)
+
+ListAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTASSETSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for listing assets.
+  
+  
+  Attributes:
+      parent:
+          Name of the organization assets should belong to. Its format
+          is "organizations/[organization\_id]".
+      filter:
+          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 ``<field> <operator> <value>`` 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 \| '=',
+          ':' 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 \| '=', ':'  For
+          example, ``resource_properties.size = 100`` is a valid filter
+          string.
+      order_by:
+          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
+          security\_center\_properties.resource\_name
+          security\_center\_properties.resource\_parent
+          security\_center\_properties.resource\_project
+          security\_center\_properties.resource\_type
+      read_time:
+          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.
+      compare_duration:
+          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.
+      field_mask:
+          Optional.  A field mask to specify the ListAssetsResult fields
+          to be listed in the response. An empty field mask will list
+          all fields.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAssetsRequest)
+
+ListAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAssetsResponse",
+    (_message.Message,),
+    dict(
+        ListAssetsResult=_reflection.GeneratedProtocolMessageType(
+            "ListAssetsResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LISTASSETSRESPONSE_LISTASSETSRESULT,
+                __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+                __doc__="""Result containing the Asset and its State.
+    
+    
+    Attributes:
+        asset:
+            Asset matching the search request.
+        state_change:
+            State change of the asset between the points in time.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListAssetsResponse.ListAssetsResult)
+            ),
+        ),
+        DESCRIPTOR=_LISTASSETSRESPONSE,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for listing assets.
+  
+  
+  Attributes:
+      list_assets_results:
+          Assets matching the list request.
+      read_time:
+          Time used for executing the list request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+      total_size:
+          The total number of assets matching the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAssetsResponse)
+_sym_db.RegisterMessage(ListAssetsResponse.ListAssetsResult)
+
+ListFindingsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for listing findings.
+  
+  
+  Attributes:
+      parent:
+          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/-
+      filter:
+          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 ``<field> <operator> <value>`` 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 \| '=', ':' source\_properties \| '=', ':',
+          ``>``, ``<``, ``>=``, ``<=``  For example,
+          ``source_properties.size = 100`` is a valid filter string.
+      order_by:
+          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
+      read_time:
+          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.
+      compare_duration:
+          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.
+      field_mask:
+          Optional.  A field mask to specify the Finding fields to be
+          listed in the response. An empty field mask will list all
+          fields.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListFindingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsRequest)
+
+ListFindingsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsResponse",
+    (_message.Message,),
+    dict(
+        ListFindingsResult=_reflection.GeneratedProtocolMessageType(
+            "ListFindingsResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LISTFINDINGSRESPONSE_LISTFINDINGSRESULT,
+                __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+                __doc__="""Result containing the Finding and its StateChange.
+    
+    
+    Attributes:
+        finding:
+            Finding matching the search request.
+        state_change:
+            State change of the finding between the points in time.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListFindingsResponse.ListFindingsResult)
+            ),
+        ),
+        DESCRIPTOR=_LISTFINDINGSRESPONSE,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for listing findings.
+  
+  
+  Attributes:
+      list_findings_results:
+          Findings matching the list request.
+      read_time:
+          Time used for executing the list request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+      total_size:
+          The total number of findings matching the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.ListFindingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsResponse)
+_sym_db.RegisterMessage(ListFindingsResponse.ListFindingsResult)
+
+SetFindingStateRequest = _reflection.GeneratedProtocolMessageType(
+    "SetFindingStateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETFINDINGSTATEREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating a finding's state.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of the finding. See: https://cloud.
+          google.com/apis/design/resource\_names#relative\_resource\_nam
+          e Example: "organizations/123/sources/456/finding/789".
+      state:
+          The desired State of the finding.
+      start_time:
+          The time at which the updated state takes effect.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.SetFindingStateRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetFindingStateRequest)
+
+RunAssetDiscoveryRequest = _reflection.GeneratedProtocolMessageType(
+    "RunAssetDiscoveryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNASSETDISCOVERYREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for running asset discovery for an organization.
+  
+  
+  Attributes:
+      parent:
+          Name of the organization to run asset discovery for. Its
+          format is "organizations/[organization\_id]".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.RunAssetDiscoveryRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunAssetDiscoveryRequest)
+
+UpdateFindingRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateFindingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEFINDINGREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating or creating a finding.
+  
+  
+  Attributes:
+      finding:
+          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.
+      update_mask:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.UpdateFindingRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateFindingRequest)
+
+UpdateOrganizationSettingsRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateOrganizationSettingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEORGANIZATIONSETTINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating an organization's settings.
+  
+  
+  Attributes:
+      organization_settings:
+          The organization settings resource to update.
+      update_mask:
+          The FieldMask to use when updating the settings resource.  If
+          empty all mutable fields will be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.UpdateOrganizationSettingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateOrganizationSettingsRequest)
+
+UpdateSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESOURCEREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating a source.
+  
+  
+  Attributes:
+      source:
+          The source resource to update.
+      update_mask:
+          The FieldMask to use when updating the source resource.  If
+          empty all mutable fields will be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.UpdateSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSourceRequest)
+
+UpdateSecurityMarksRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSecurityMarksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESECURITYMARKSREQUEST,
+        __module__="google.cloud.securitycenter_v1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating a SecurityMarks resource.
+  
+  
+  Attributes:
+      security_marks:
+          The security marks resource to update.
+      update_mask:
+          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.".
+      start_time:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.UpdateSecurityMarksRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSecurityMarksRequest)
+
+
+DESCRIPTOR._options = None
+_GROUPRESULT_PROPERTIESENTRY._options = None
+
+_SECURITYCENTER = _descriptor.ServiceDescriptor(
+    name="SecurityCenter",
+    full_name="google.cloud.securitycenter.v1.SecurityCenter",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4516,
+    serialized_end=7860,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateSource",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.CreateSource",
+            index=0,
+            containing_service=None,
+            input_type=_CREATESOURCEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2._SOURCE,
+            serialized_options=_b(
+                '\202\323\344\223\002."$/v1/{parent=organizations/*}/sources:\006source'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateFinding",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.CreateFinding",
+            index=1,
+            containing_service=None,
+            input_type=_CREATEFINDINGREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                '\202\323\344\223\002:"//v1/{parent=organizations/*/sources/*}/findings:\007finding'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.GetIamPolicy",
+            index=2,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v1/{resource=organizations/*/sources/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetOrganizationSettings",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.GetOrganizationSettings",
+            index=3,
+            containing_service=None,
+            input_type=_GETORGANIZATIONSETTINGSREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2._ORGANIZATIONSETTINGS,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1/{name=organizations/*/organizationSettings}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSource",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.GetSource",
+            index=4,
+            containing_service=None,
+            input_type=_GETSOURCEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2._SOURCE,
+            serialized_options=_b(
+                "\202\323\344\223\002&\022$/v1/{name=organizations/*/sources/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GroupAssets",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.GroupAssets",
+            index=5,
+            containing_service=None,
+            input_type=_GROUPASSETSREQUEST,
+            output_type=_GROUPASSETSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002.")/v1/{parent=organizations/*}/assets:group:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GroupFindings",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.GroupFindings",
+            index=6,
+            containing_service=None,
+            input_type=_GROUPFINDINGSREQUEST,
+            output_type=_GROUPFINDINGSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v1/{parent=organizations/*/sources/*}/findings:group:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAssets",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.ListAssets",
+            index=7,
+            containing_service=None,
+            input_type=_LISTASSETSREQUEST,
+            output_type=_LISTASSETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002%\022#/v1/{parent=organizations/*}/assets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFindings",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.ListFindings",
+            index=8,
+            containing_service=None,
+            input_type=_LISTFINDINGSREQUEST,
+            output_type=_LISTFINDINGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1/{parent=organizations/*/sources/*}/findings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSources",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.ListSources",
+            index=9,
+            containing_service=None,
+            input_type=_LISTSOURCESREQUEST,
+            output_type=_LISTSOURCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002&\022$/v1/{parent=organizations/*}/sources"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunAssetDiscovery",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.RunAssetDiscovery",
+            index=10,
+            containing_service=None,
+            input_type=_RUNASSETDISCOVERYREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0025"0/v1/{parent=organizations/*}/assets:runDiscovery:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetFindingState",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.SetFindingState",
+            index=11,
+            containing_service=None,
+            input_type=_SETFINDINGSTATEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v1/{name=organizations/*/sources/*/findings/*}:setState:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.SetIamPolicy",
+            index=12,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v1/{resource=organizations/*/sources/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.TestIamPermissions",
+            index=13,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v1/{resource=organizations/*/sources/*}:testIamPermissions:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateFinding",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.UpdateFinding",
+            index=14,
+            containing_service=None,
+            input_type=_UPDATEFINDINGREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                "\202\323\344\223\002B27/v1/{finding.name=organizations/*/sources/*/findings/*}:\007finding"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateOrganizationSettings",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.UpdateOrganizationSettings",
+            index=15,
+            containing_service=None,
+            input_type=_UPDATEORGANIZATIONSETTINGSREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2._ORGANIZATIONSETTINGS,
+            serialized_options=_b(
+                "\202\323\344\223\002^2E/v1/{organization_settings.name=organizations/*/organizationSettings}:\025organization_settings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSource",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.UpdateSource",
+            index=16,
+            containing_service=None,
+            input_type=_UPDATESOURCEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2._SOURCE,
+            serialized_options=_b(
+                "\202\323\344\223\00252+/v1/{source.name=organizations/*/sources/*}:\006source"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSecurityMarks",
+            full_name="google.cloud.securitycenter.v1.SecurityCenter.UpdateSecurityMarks",
+            index=17,
+            containing_service=None,
+            input_type=_UPDATESECURITYMARKSREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2._SECURITYMARKS,
+            serialized_options=_b(
+                "\202\323\344\223\002\262\0012@/v1/{security_marks.name=organizations/*/assets/*/securityMarks}:\016security_marksZ^2L/v1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}:\016security_marks"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_SECURITYCENTER)
+
+DESCRIPTOR.services_by_name["SecurityCenter"] = _SECURITYCENTER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service_pb2_grpc.py
new file mode 100644
index 000000000000..5a710c7a23ca
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/securitycenter_service_pb2_grpc.py
@@ -0,0 +1,370 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.securitycenter_v1.proto import (
+    finding_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    organization_settings_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    securitycenter_service_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2,
+)
+from google.cloud.securitycenter_v1.proto import (
+    source_pb2 as google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class SecurityCenterStub(object):
+    """V1 APIs for Security Center service.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateSource = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/CreateSource",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.CreateSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.Source.FromString,
+        )
+        self.CreateFinding = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/CreateFinding",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.CreateFindingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetOrganizationSettings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/GetOrganizationSettings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GetOrganizationSettingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.FromString,
+        )
+        self.GetSource = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/GetSource",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GetSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.Source.FromString,
+        )
+        self.GroupAssets = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/GroupAssets",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsResponse.FromString,
+        )
+        self.GroupFindings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/GroupFindings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsResponse.FromString,
+        )
+        self.ListAssets = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/ListAssets",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListAssetsResponse.FromString,
+        )
+        self.ListFindings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/ListFindings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListFindingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListFindingsResponse.FromString,
+        )
+        self.ListSources = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/ListSources",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListSourcesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListSourcesResponse.FromString,
+        )
+        self.RunAssetDiscovery = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/RunAssetDiscovery",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.RunAssetDiscoveryRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.SetFindingState = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/SetFindingState",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.SetFindingStateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+        self.UpdateFinding = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/UpdateFinding",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateFindingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.UpdateOrganizationSettings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/UpdateOrganizationSettings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateOrganizationSettingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.FromString,
+        )
+        self.UpdateSource = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/UpdateSource",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.Source.FromString,
+        )
+        self.UpdateSecurityMarks = channel.unary_unary(
+            "/google.cloud.securitycenter.v1.SecurityCenter/UpdateSecurityMarks",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateSecurityMarksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2.SecurityMarks.FromString,
+        )
+
+
+class SecurityCenterServicer(object):
+    """V1 APIs for Security Center service.
+  """
+
+    def CreateSource(self, request, context):
+        """Creates a source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateFinding(self, request, context):
+        """Creates a finding. The corresponding source must exist for finding creation
+    to succeed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy on the specified Source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetOrganizationSettings(self, request, context):
+        """Gets the settings for an organization.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSource(self, request, context):
+        """Gets a source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GroupAssets(self, request, context):
+        """Filters an organization's assets and  groups them by their specified
+    properties.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GroupFindings(self, request, context):
+        """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: /v1/organizations/123/sources/-/findings
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAssets(self, request, context):
+        """Lists an organization's assets.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFindings(self, request, context):
+        """Lists an organization or source's findings.
+
+    To list across all sources provide a `-` as the source id.
+    Example: /v1/organizations/123/sources/-/findings
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSources(self, request, context):
+        """Lists all sources belonging to an organization.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunAssetDiscovery(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetFindingState(self, request, context):
+        """Updates the state of a finding.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on the specified Source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns the permissions that a caller has on the specified source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateFinding(self, request, context):
+        """Creates or updates a finding. The corresponding source must exist for a
+    finding creation to succeed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateOrganizationSettings(self, request, context):
+        """Updates an organization's settings.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSource(self, request, context):
+        """Updates a source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSecurityMarks(self, request, context):
+        """Updates security marks.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SecurityCenterServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateSource": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSource,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.CreateSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.Source.SerializeToString,
+        ),
+        "CreateFinding": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateFinding,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.CreateFindingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetOrganizationSettings": grpc.unary_unary_rpc_method_handler(
+            servicer.GetOrganizationSettings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GetOrganizationSettingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.SerializeToString,
+        ),
+        "GetSource": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSource,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GetSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.Source.SerializeToString,
+        ),
+        "GroupAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.GroupAssets,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsResponse.SerializeToString,
+        ),
+        "GroupFindings": grpc.unary_unary_rpc_method_handler(
+            servicer.GroupFindings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsResponse.SerializeToString,
+        ),
+        "ListAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAssets,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListAssetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListAssetsResponse.SerializeToString,
+        ),
+        "ListFindings": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFindings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListFindingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListFindingsResponse.SerializeToString,
+        ),
+        "ListSources": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSources,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListSourcesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.ListSourcesResponse.SerializeToString,
+        ),
+        "RunAssetDiscovery": grpc.unary_unary_rpc_method_handler(
+            servicer.RunAssetDiscovery,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.RunAssetDiscoveryRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "SetFindingState": grpc.unary_unary_rpc_method_handler(
+            servicer.SetFindingState,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.SetFindingStateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "UpdateFinding": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateFinding,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateFindingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "UpdateOrganizationSettings": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateOrganizationSettings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateOrganizationSettingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.SerializeToString,
+        ),
+        "UpdateSource": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSource,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_source__pb2.Source.SerializeToString,
+        ),
+        "UpdateSecurityMarks": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSecurityMarks,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_securitycenter__service__pb2.UpdateSecurityMarksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1_dot_proto_dot_security__marks__pb2.SecurityMarks.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.securitycenter.v1.SecurityCenter", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/source.proto b/securitycenter/google/cloud/securitycenter_v1/proto/source.proto
new file mode 100644
index 000000000000..26b0d5a64d13
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/source.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.securitycenter.v1;
+
+import "google/api/annotations.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_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+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.
+message 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"
+  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}])?.
+  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;
+
+  reserved 4;
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/source_pb2.py b/securitycenter/google/cloud/securitycenter_v1/proto/source_pb2.py
new file mode 100644
index 000000000000..b9e7fe1d5034
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/source_pb2.py
@@ -0,0 +1,153 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1/proto/source.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1/proto/source.proto",
+    package="google.cloud.securitycenter.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.securitycenter.v1P\001ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\252\002\036Google.Cloud.SecurityCenter.V1\312\002\036Google\\Cloud\\SecurityCenter\\V1\352\002!Google::Cloud::SecurityCenter::V1'
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/securitycenter_v1/proto/source.proto\x12\x1egoogle.cloud.securitycenter.v1\x1a\x1cgoogle/api/annotations.proto"G\n\x06Source\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\tJ\x04\x08\x04\x10\x05\x42\xda\x01\n"com.google.cloud.securitycenter.v1P\x01ZLgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter\xaa\x02\x1eGoogle.Cloud.SecurityCenter.V1\xca\x02\x1eGoogle\\Cloud\\SecurityCenter\\V1\xea\x02!Google::Cloud::SecurityCenter::V1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_SOURCE = _descriptor.Descriptor(
+    name="Source",
+    full_name="google.cloud.securitycenter.v1.Source",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1.Source.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.securitycenter.v1.Source.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.securitycenter.v1.Source.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=115,
+    serialized_end=186,
+)
+
+DESCRIPTOR.message_types_by_name["Source"] = _SOURCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Source = _reflection.GeneratedProtocolMessageType(
+    "Source",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SOURCE,
+        __module__="google.cloud.securitycenter_v1.proto.source_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of this source. See: https://cloud.
+          google.com/apis/design/resource\_names#relative\_resource\_nam
+          e Example: "organizations/123/sources/456"
+      display_name:
+          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: `:raw-latex:`\p{L}`:raw-latex:`\p{N}` <%7B\p%7BL%7
+          D\p%7BN%7D_-%20%5D%7B0,30%7D%5B\p%7BL%7D\p%7BN%7D%5D>`__?.
+      description:
+          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."
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1.Source)
+    ),
+)
+_sym_db.RegisterMessage(Source)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1/proto/source_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1/proto/source_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/proto/source_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1/types.py b/securitycenter/google/cloud/securitycenter_v1/types.py
new file mode 100644
index 000000000000..10c2f93d8d61
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1/types.py
@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.securitycenter_v1.proto import asset_pb2
+from google.cloud.securitycenter_v1.proto import finding_pb2
+from google.cloud.securitycenter_v1.proto import organization_settings_pb2
+from google.cloud.securitycenter_v1.proto import run_asset_discovery_response_pb2
+from google.cloud.securitycenter_v1.proto import security_marks_pb2
+from google.cloud.securitycenter_v1.proto import securitycenter_service_pb2
+from google.cloud.securitycenter_v1.proto import source_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    operations_pb2,
+    any_pb2,
+    duration_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [
+    asset_pb2,
+    finding_pb2,
+    organization_settings_pb2,
+    run_asset_discovery_response_pb2,
+    security_marks_pb2,
+    securitycenter_service_pb2,
+    source_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.securitycenter_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/__init__.py b/securitycenter/google/cloud/securitycenter_v1beta1/__init__.py
new file mode 100644
index 000000000000..f15d206643a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.securitycenter_v1beta1 import types
+from google.cloud.securitycenter_v1beta1.gapic import enums
+from google.cloud.securitycenter_v1beta1.gapic import security_center_client
+
+
+class SecurityCenterClient(security_center_client.SecurityCenterClient):
+    __doc__ = security_center_client.SecurityCenterClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "SecurityCenterClient")
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/gapic/__init__.py b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/gapic/enums.py b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..20e5d1c7fcc9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/enums.py
@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class Finding(object):
+    class State(enum.IntEnum):
+        """
+        The state of the finding.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          ACTIVE (int): The finding requires attention and has not been addressed yet.
+          INACTIVE (int): The finding has been fixed, triaged as a non-issue or otherwise addressed
+          and is no longer active.
+        """
+
+        STATE_UNSPECIFIED = 0
+        ACTIVE = 1
+        INACTIVE = 2
+
+
+class ListAssetsResponse(object):
+    class ListAssetsResult(object):
+        class State(enum.IntEnum):
+            """
+            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 should be: UNUSED
+
+            Attributes:
+              STATE_UNSPECIFIED (int): Unspecified state.
+              UNUSED (int): Request did not specify use of this field in the result.
+              ADDED (int): Asset was added between the points in time.
+              REMOVED (int): Asset was removed between the points in time.
+              ACTIVE (int): Asset was active at both point(s) in time.
+            """
+
+            STATE_UNSPECIFIED = 0
+            UNUSED = 1
+            ADDED = 2
+            REMOVED = 3
+            ACTIVE = 4
+
+
+class OrganizationSettings(object):
+    class AssetDiscoveryConfig(object):
+        class InclusionMode(enum.IntEnum):
+            """
+            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.
+
+            Attributes:
+              INCLUSION_MODE_UNSPECIFIED (int): Unspecified. Setting the mode with this value will disable
+              inclusion/exclusion filtering for Asset Discovery.
+              INCLUDE_ONLY (int): Asset Discovery will capture only the resources within the projects
+              specified. All other resources will be ignored.
+              EXCLUDE (int): Asset Discovery will ignore all resources under the projects specified.
+              All other resources will be retrieved.
+            """
+
+            INCLUSION_MODE_UNSPECIFIED = 0
+            INCLUDE_ONLY = 1
+            EXCLUDE = 2
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/gapic/security_center_client.py b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/security_center_client.py
new file mode 100644
index 000000000000..7b26dffaf78a
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/security_center_client.py
@@ -0,0 +1,2135 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.securitycenter.v1beta1 SecurityCenter API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.securitycenter_v1beta1.gapic import enums
+from google.cloud.securitycenter_v1beta1.gapic import security_center_client_config
+from google.cloud.securitycenter_v1beta1.gapic.transports import (
+    security_center_grpc_transport,
+)
+from google.cloud.securitycenter_v1beta1.proto import finding_pb2
+from google.cloud.securitycenter_v1beta1.proto import organization_settings_pb2
+from google.cloud.securitycenter_v1beta1.proto import security_marks_pb2
+from google.cloud.securitycenter_v1beta1.proto import securitycenter_service_pb2
+from google.cloud.securitycenter_v1beta1.proto import securitycenter_service_pb2_grpc
+from google.cloud.securitycenter_v1beta1.proto import source_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-securitycenter"
+).version
+
+
+class SecurityCenterClient(object):
+    """V1 Beta APIs for Security Center service."""
+
+    SERVICE_ADDRESS = "securitycenter.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.securitycenter.v1beta1.SecurityCenter"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            SecurityCenterClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def asset_security_marks_path(cls, organization, asset):
+        """Return a fully-qualified asset_security_marks string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/assets/{asset}/securityMarks",
+            organization=organization,
+            asset=asset,
+        )
+
+    @classmethod
+    def finding_path(cls, organization, source, finding):
+        """Return a fully-qualified finding string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/{source}/findings/{finding}",
+            organization=organization,
+            source=source,
+            finding=finding,
+        )
+
+    @classmethod
+    def finding_security_marks_path(cls, organization, source, finding):
+        """Return a fully-qualified finding_security_marks string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/{source}/findings/{finding}/securityMarks",
+            organization=organization,
+            source=source,
+            finding=finding,
+        )
+
+    @classmethod
+    def organization_path(cls, organization):
+        """Return a fully-qualified organization string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}", organization=organization
+        )
+
+    @classmethod
+    def organization_settings_path(cls, organization):
+        """Return a fully-qualified organization_settings string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/organizationSettings",
+            organization=organization,
+        )
+
+    @classmethod
+    def source_path(cls, organization, source):
+        """Return a fully-qualified source string."""
+        return google.api_core.path_template.expand(
+            "organizations/{organization}/sources/{source}",
+            organization=organization,
+            source=source,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.SecurityCenterGrpcTransport,
+                    Callable[[~.Credentials, type], ~.SecurityCenterGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = security_center_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=security_center_grpc_transport.SecurityCenterGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = security_center_grpc_transport.SecurityCenterGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_source(
+        self,
+        parent,
+        source,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # TODO: Initialize `source`:
+            >>> source = {}
+            >>>
+            >>> response = client.create_source(parent, source)
+
+        Args:
+            parent (str): Resource name of the new source's parent. Its format should be
+                "organizations/[organization\_id]".
+            source (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Source]): The Source being created, only the display\_name and description will be
+                used. All other fields will be ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Source`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Source` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_source,
+                default_retry=self._method_configs["CreateSource"].retry,
+                default_timeout=self._method_configs["CreateSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.CreateSourceRequest(
+            parent=parent, source=source
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_finding(
+        self,
+        parent,
+        finding_id,
+        finding,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a finding. The corresponding source must exist for finding creation
+        to succeed.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `finding_id`:
+            >>> finding_id = ''
+            >>>
+            >>> # TODO: Initialize `finding`:
+            >>> finding = {}
+            >>>
+            >>> response = client.create_finding(parent, finding_id, finding)
+
+        Args:
+            parent (str): Resource name of the new finding's parent. Its format should be
+                "organizations/[organization\_id]/sources/[source\_id]".
+            finding_id (str): 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.
+            finding (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Finding]): The Finding being created. The name and security\_marks will be ignored
+                as they are both output only fields on this resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Finding`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_finding" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_finding"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_finding,
+                default_retry=self._method_configs["CreateFinding"].retry,
+                default_timeout=self._method_configs["CreateFinding"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.CreateFindingRequest(
+            parent=parent, finding_id=finding_id, finding=finding
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_finding"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy on the specified Source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> resource = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.securitycenter_v1beta1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_organization_settings(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the settings for an organization.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> name = client.organization_settings_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.get_organization_settings(name)
+
+        Args:
+            name (str): Name of the organization to get organization settings for. Its format is
+                "organizations/[organization\_id]/organizationSettings".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.OrganizationSettings` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_organization_settings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_organization_settings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_organization_settings,
+                default_retry=self._method_configs["GetOrganizationSettings"].retry,
+                default_timeout=self._method_configs["GetOrganizationSettings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GetOrganizationSettingsRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_organization_settings"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_source(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> name = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> response = client.get_source(name)
+
+        Args:
+            name (str): Relative resource name of the source. Its format is
+                "organizations/[organization\_id]/source/[source\_id]".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Source` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_source,
+                default_retry=self._method_configs["GetSource"].retry,
+                default_timeout=self._method_configs["GetSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GetSourceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def group_assets(
+        self,
+        parent,
+        group_by,
+        filter_=None,
+        compare_duration=None,
+        read_time=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Filters an organization's assets and  groups them by their specified
+        properties.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # TODO: Initialize `group_by`:
+            >>> group_by = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.group_assets(parent, group_by):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.group_assets(parent, group_by).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Name of the organization to groupBy. Its format is
+                "organizations/[organization\_id]".
+            group_by (str): 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\_type
+                -  security\_center\_properties.resource\_parent
+
+                The following fields are supported when compare\_duration is set:
+
+                -  security\_center\_properties.resource\_type
+            filter_ (str): 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 not supported, and ``OR``
+                has higher precedence than ``AND``.
+
+                Restrictions have the form ``<field> <operator> <value>`` 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.
+
+                For example, ``resource_properties.size = 100`` is a valid filter
+                string.
+            compare_duration (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Duration]): When compare\_duration is set, the Asset's "state" 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 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" values when compare\_duration is specified:
+
+                -  "ADDED": indicates that the asset was not present before
+                   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.
+
+                This field is ignored if ``state`` is not a field in ``group_by``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Duration`
+            read_time (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Timestamp`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1beta1.types.GroupResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "group_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "group_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.group_assets,
+                default_retry=self._method_configs["GroupAssets"].retry,
+                default_timeout=self._method_configs["GroupAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GroupAssetsRequest(
+            parent=parent,
+            group_by=group_by,
+            filter=filter_,
+            compare_duration=compare_duration,
+            read_time=read_time,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["group_assets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="group_by_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def group_findings(
+        self,
+        parent,
+        group_by,
+        filter_=None,
+        read_time=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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:
+        /v1beta1/organizations/123/sources/-/findings
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `group_by`:
+            >>> group_by = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.group_findings(parent, group_by):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.group_findings(parent, group_by).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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/-
+            group_by (str): 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".
+
+                The following fields are supported:
+
+                -  resource\_name
+                -  category
+                -  state
+                -  parent
+            filter_ (str): 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 not supported, and ``OR``
+                has higher precedence than ``AND``.
+
+                Restrictions have the form ``<field> <operator> <value>`` 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.
+
+                For example, ``source_properties.size = 100`` is a valid filter string.
+            read_time (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Timestamp`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1beta1.types.GroupResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "group_findings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "group_findings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.group_findings,
+                default_retry=self._method_configs["GroupFindings"].retry,
+                default_timeout=self._method_configs["GroupFindings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.GroupFindingsRequest(
+            parent=parent,
+            group_by=group_by,
+            filter=filter_,
+            read_time=read_time,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["group_findings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="group_by_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_assets(
+        self,
+        parent,
+        filter_=None,
+        order_by=None,
+        read_time=None,
+        compare_duration=None,
+        field_mask=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists an organization's assets.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_assets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_assets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Name of the organization assets should belong to. Its format is
+                "organizations/[organization\_id]".
+            filter_ (str): 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 not supported, and ``OR``
+                has higher precedence than ``AND``.
+
+                Restrictions have the form ``<field> <operator> <value>`` 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.
+
+                For example, ``resource_properties.size = 100`` is a valid filter
+                string.
+            order_by (str): 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.
+            read_time (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Timestamp`
+            compare_duration (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Duration]): When compare\_duration is set, the ListAssetResult's "state" 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 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" values when compare\_duration is specified:
+
+                -  "ADDED": indicates that the asset was not present before
+                   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 is
+                "UNUSED", which indicates that the asset is present at read\_time.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Duration`
+            field_mask (Union[dict, ~google.cloud.securitycenter_v1beta1.types.FieldMask]): Optional.
+
+                A field mask to specify the ListAssetsResult fields to be listed in the
+                response.
+                An empty field mask will list all fields.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.FieldMask`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1beta1.types.ListAssetsResult` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_assets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_assets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_assets,
+                default_retry=self._method_configs["ListAssets"].retry,
+                default_timeout=self._method_configs["ListAssets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.ListAssetsRequest(
+            parent=parent,
+            filter=filter_,
+            order_by=order_by,
+            read_time=read_time,
+            compare_duration=compare_duration,
+            field_mask=field_mask,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_assets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="list_assets_results",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_findings(
+        self,
+        parent,
+        filter_=None,
+        order_by=None,
+        read_time=None,
+        field_mask=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_findings(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_findings(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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/-
+            filter_ (str): 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 not supported, and ``OR``
+                has higher precedence than ``AND``.
+
+                Restrictions have the form ``<field> <operator> <value>`` 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.
+
+                For example, ``source_properties.size = 100`` is a valid filter string.
+            order_by (str): 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.
+            read_time (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Timestamp`
+            field_mask (Union[dict, ~google.cloud.securitycenter_v1beta1.types.FieldMask]): Optional.
+
+                A field mask to specify the Finding fields to be listed in the response.
+                An empty field mask will list all fields.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.FieldMask`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1beta1.types.Finding` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_findings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_findings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_findings,
+                default_retry=self._method_configs["ListFindings"].retry,
+                default_timeout=self._method_configs["ListFindings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.ListFindingsRequest(
+            parent=parent,
+            filter=filter_,
+            order_by=order_by,
+            read_time=read_time,
+            field_mask=field_mask,
+            page_size=page_size,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_findings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="findings",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_sources(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all sources belonging to an organization.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_sources(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_sources(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the parent of sources to list. Its format should be
+                "organizations/[organization\_id]".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.securitycenter_v1beta1.types.Source` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_sources" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_sources"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_sources,
+                default_retry=self._method_configs["ListSources"].retry,
+                default_timeout=self._method_configs["ListSources"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.ListSourcesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_sources"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="sources",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def run_asset_discovery(
+        self,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> parent = client.organization_path('[ORGANIZATION]')
+            >>>
+            >>> response = client.run_asset_discovery(parent)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Name of the organization to run asset discovery for. Its format is
+                "organizations/[organization\_id]".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_asset_discovery" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_asset_discovery"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_asset_discovery,
+                default_retry=self._method_configs["RunAssetDiscovery"].retry,
+                default_timeout=self._method_configs["RunAssetDiscovery"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.RunAssetDiscoveryRequest(parent=parent)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["run_asset_discovery"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=empty_pb2.Empty,
+        )
+
+    def set_finding_state(
+        self,
+        name,
+        state,
+        start_time,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the state of a finding.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>> from google.cloud.securitycenter_v1beta1 import enums
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> name = client.finding_path('[ORGANIZATION]', '[SOURCE]', '[FINDING]')
+            >>>
+            >>> # TODO: Initialize `state`:
+            >>> state = enums.Finding.State.STATE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `start_time`:
+            >>> start_time = {}
+            >>>
+            >>> response = client.set_finding_state(name, state, start_time)
+
+        Args:
+            name (str): 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".
+            state (~google.cloud.securitycenter_v1beta1.types.State): The desired State of the finding.
+            start_time (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Timestamp]): The time at which the updated state takes effect.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_finding_state" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_finding_state"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_finding_state,
+                default_retry=self._method_configs["SetFindingState"].retry,
+                default_timeout=self._method_configs["SetFindingState"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.SetFindingStateRequest(
+            name=name, state=state, start_time=start_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_finding_state"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on the specified Source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> resource = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns the permissions that a caller has on the specified source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> resource = client.source_path('[ORGANIZATION]', '[SOURCE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_finding(
+        self,
+        finding,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates or updates a finding. The corresponding source must exist for a
+        finding creation to succeed.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `finding`:
+            >>> finding = {}
+            >>>
+            >>> response = client.update_finding(finding)
+
+        Args:
+            finding (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Finding]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Finding`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1beta1.types.FieldMask]): The FieldMask to use when updating the finding resource. This field should
+                not be specified when creating a finding.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_finding" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_finding"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_finding,
+                default_retry=self._method_configs["UpdateFinding"].retry,
+                default_timeout=self._method_configs["UpdateFinding"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateFindingRequest(
+            finding=finding, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("finding.name", finding.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_finding"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_organization_settings(
+        self,
+        organization_settings,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an organization's settings.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `organization_settings`:
+            >>> organization_settings = {}
+            >>>
+            >>> response = client.update_organization_settings(organization_settings)
+
+        Args:
+            organization_settings (Union[dict, ~google.cloud.securitycenter_v1beta1.types.OrganizationSettings]): The organization settings resource to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.OrganizationSettings`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1beta1.types.FieldMask]): The FieldMask to use when updating the settings resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.OrganizationSettings` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_organization_settings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_organization_settings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_organization_settings,
+                default_retry=self._method_configs["UpdateOrganizationSettings"].retry,
+                default_timeout=self._method_configs[
+                    "UpdateOrganizationSettings"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateOrganizationSettingsRequest(
+            organization_settings=organization_settings, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [
+                ("organization_settings.name", organization_settings.name)
+            ]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_organization_settings"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_source(
+        self,
+        source,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a source.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `source`:
+            >>> source = {}
+            >>>
+            >>> response = client.update_source(source)
+
+        Args:
+            source (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Source]): The source resource to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Source`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1beta1.types.FieldMask]): The FieldMask to use when updating the source resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.Source` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_source" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_source"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_source,
+                default_retry=self._method_configs["UpdateSource"].retry,
+                default_timeout=self._method_configs["UpdateSource"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateSourceRequest(
+            source=source, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("source.name", source.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_source"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_security_marks(
+        self,
+        security_marks,
+        update_mask=None,
+        start_time=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates security marks.
+
+        Example:
+            >>> from google.cloud import securitycenter_v1beta1
+            >>>
+            >>> client = securitycenter_v1beta1.SecurityCenterClient()
+            >>>
+            >>> # TODO: Initialize `security_marks`:
+            >>> security_marks = {}
+            >>>
+            >>> response = client.update_security_marks(security_marks)
+
+        Args:
+            security_marks (Union[dict, ~google.cloud.securitycenter_v1beta1.types.SecurityMarks]): The security marks resource to update.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.SecurityMarks`
+            update_mask (Union[dict, ~google.cloud.securitycenter_v1beta1.types.FieldMask]): The FieldMask to use when updating the security marks resource.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.FieldMask`
+            start_time (Union[dict, ~google.cloud.securitycenter_v1beta1.types.Timestamp]): The time at which the updated SecurityMarks take effect.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.securitycenter_v1beta1.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.securitycenter_v1beta1.types.SecurityMarks` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_security_marks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_security_marks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_security_marks,
+                default_retry=self._method_configs["UpdateSecurityMarks"].retry,
+                default_timeout=self._method_configs["UpdateSecurityMarks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = securitycenter_service_pb2.UpdateSecurityMarksRequest(
+            security_marks=security_marks,
+            update_mask=update_mask,
+            start_time=start_time,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("security_marks.name", security_marks.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_security_marks"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/gapic/security_center_client_config.py b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/security_center_client_config.py
new file mode 100644
index 000000000000..9b5c01a985a6
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/security_center_client_config.py
@@ -0,0 +1,113 @@
+config = {
+    "interfaces": {
+        "google.cloud.securitycenter.v1beta1.SecurityCenter": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateSource": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateFinding": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetOrganizationSettings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSource": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GroupAssets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GroupFindings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListAssets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFindings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListSources": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunAssetDiscovery": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetFindingState": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateFinding": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateOrganizationSettings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSource": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateSecurityMarks": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/gapic/transports/__init__.py b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/gapic/transports/security_center_grpc_transport.py b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/transports/security_center_grpc_transport.py
new file mode 100644
index 000000000000..46419728cc2d
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/gapic/transports/security_center_grpc_transport.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.securitycenter_v1beta1.proto import securitycenter_service_pb2_grpc
+
+
+class SecurityCenterGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.securitycenter.v1beta1 SecurityCenter API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="securitycenter.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "security_center_stub": securitycenter_service_pb2_grpc.SecurityCenterStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="securitycenter.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_source(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.create_source`.
+
+        Creates a source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].CreateSource
+
+    @property
+    def create_finding(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.create_finding`.
+
+        Creates a finding. The corresponding source must exist for finding creation
+        to succeed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].CreateFinding
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.get_iam_policy`.
+
+        Gets the access control policy on the specified Source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GetIamPolicy
+
+    @property
+    def get_organization_settings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.get_organization_settings`.
+
+        Gets the settings for an organization.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GetOrganizationSettings
+
+    @property
+    def get_source(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.get_source`.
+
+        Gets a source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GetSource
+
+    @property
+    def group_assets(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.group_assets`.
+
+        Filters an organization's assets and  groups them by their specified
+        properties.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GroupAssets
+
+    @property
+    def group_findings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.group_findings`.
+
+        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:
+        /v1beta1/organizations/123/sources/-/findings
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].GroupFindings
+
+    @property
+    def list_assets(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.list_assets`.
+
+        Lists an organization's assets.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].ListAssets
+
+    @property
+    def list_findings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.list_findings`.
+
+        Lists an organization or source's findings.
+
+        To list across all sources provide a ``-`` as the source id. Example:
+        /v1beta1/organizations/123/sources/-/findings
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].ListFindings
+
+    @property
+    def list_sources(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.list_sources`.
+
+        Lists all sources belonging to an organization.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].ListSources
+
+    @property
+    def run_asset_discovery(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.run_asset_discovery`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].RunAssetDiscovery
+
+    @property
+    def set_finding_state(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.set_finding_state`.
+
+        Updates the state of a finding.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].SetFindingState
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.set_iam_policy`.
+
+        Sets the access control policy on the specified Source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].SetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.test_iam_permissions`.
+
+        Returns the permissions that a caller has on the specified source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].TestIamPermissions
+
+    @property
+    def update_finding(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_finding`.
+
+        Creates or updates a finding. The corresponding source must exist for a
+        finding creation to succeed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateFinding
+
+    @property
+    def update_organization_settings(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_organization_settings`.
+
+        Updates an organization's settings.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateOrganizationSettings
+
+    @property
+    def update_source(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_source`.
+
+        Updates a source.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateSource
+
+    @property
+    def update_security_marks(self):
+        """Return the gRPC stub for :meth:`SecurityCenterClient.update_security_marks`.
+
+        Updates security marks.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["security_center_stub"].UpdateSecurityMarks
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/__init__.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset.proto b/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset.proto
new file mode 100644
index 000000000000..3dd5b358141d
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset.proto
@@ -0,0 +1,86 @@
+// 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.cloud.securitycenter.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1beta1/security_marks.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.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";
+
+// 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 {
+  // 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 relative resource name of this asset. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/123/assets/456".
+  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<string, google.protobuf.Value> 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;
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset_pb2.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset_pb2.py
new file mode 100644
index 000000000000..fc37a148ba90
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset_pb2.py
@@ -0,0 +1,454 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1beta1/proto/asset.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.securitycenter_v1beta1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2,
+)
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1beta1/proto/asset.proto",
+    package="google.cloud.securitycenter.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n'com.google.cloud.securitycenter.v1beta1P\001ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter"
+    ),
+    serialized_pb=_b(
+        "\n5google/cloud/securitycenter_v1beta1/proto/asset.proto\x12#google.cloud.securitycenter.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a>google/cloud/securitycenter_v1beta1/proto/security_marks.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xf7\x04\n\x05\x41sset\x12\x0c\n\x04name\x18\x01 \x01(\t\x12g\n\x1asecurity_center_properties\x18\x02 \x01(\x0b\x32\x43.google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties\x12_\n\x13resource_properties\x18\x07 \x03(\x0b\x32\x42.google.cloud.securitycenter.v1beta1.Asset.ResourcePropertiesEntry\x12J\n\x0esecurity_marks\x18\x08 \x01(\x0b\x32\x32.google.cloud.securitycenter.v1beta1.SecurityMarks\x12/\n\x0b\x63reate_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a\x94\x01\n\x18SecurityCenterProperties\x12\x15\n\rresource_name\x18\x01 \x01(\t\x12\x15\n\rresource_type\x18\x02 \x01(\t\x12\x17\n\x0fresource_parent\x18\x03 \x01(\t\x12\x18\n\x10resource_project\x18\x04 \x01(\t\x12\x17\n\x0fresource_owners\x18\x05 \x03(\t\x1aQ\n\x17ResourcePropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01\x42~\n'com.google.cloud.securitycenter.v1beta1P\x01ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenterb\x06proto3"
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_ASSET_SECURITYCENTERPROPERTIES = _descriptor.Descriptor(
+    name="SecurityCenterProperties",
+    full_name="google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="resource_name",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties.resource_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_type",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties.resource_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_parent",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties.resource_parent",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_project",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties.resource_project",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_owners",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties.resource_owners",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=652,
+    serialized_end=800,
+)
+
+_ASSET_RESOURCEPROPERTIESENTRY = _descriptor.Descriptor(
+    name="ResourcePropertiesEntry",
+    full_name="google.cloud.securitycenter.v1beta1.Asset.ResourcePropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.ResourcePropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.ResourcePropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=802,
+    serialized_end=883,
+)
+
+_ASSET = _descriptor.Descriptor(
+    name="Asset",
+    full_name="google.cloud.securitycenter.v1beta1.Asset",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_center_properties",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.security_center_properties",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_properties",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.resource_properties",
+            index=2,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_marks",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.security_marks",
+            index=3,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.create_time",
+            index=4,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.securitycenter.v1beta1.Asset.update_time",
+            index=5,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ASSET_SECURITYCENTERPROPERTIES, _ASSET_RESOURCEPROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=252,
+    serialized_end=883,
+)
+
+_ASSET_SECURITYCENTERPROPERTIES.containing_type = _ASSET
+_ASSET_RESOURCEPROPERTIESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_ASSET_RESOURCEPROPERTIESENTRY.containing_type = _ASSET
+_ASSET.fields_by_name[
+    "security_center_properties"
+].message_type = _ASSET_SECURITYCENTERPROPERTIES
+_ASSET.fields_by_name[
+    "resource_properties"
+].message_type = _ASSET_RESOURCEPROPERTIESENTRY
+_ASSET.fields_by_name[
+    "security_marks"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2._SECURITYMARKS
+)
+_ASSET.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ASSET.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["Asset"] = _ASSET
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Asset = _reflection.GeneratedProtocolMessageType(
+    "Asset",
+    (_message.Message,),
+    dict(
+        SecurityCenterProperties=_reflection.GeneratedProtocolMessageType(
+            "SecurityCenterProperties",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ASSET_SECURITYCENTERPROPERTIES,
+                __module__="google.cloud.securitycenter_v1beta1.proto.asset_pb2",
+                __doc__="""Cloud SCC managed properties. These properties are managed by Cloud SCC
+    and cannot be modified by the user.
+    
+    
+    Attributes:
+        resource_name:
+            The full resource name of the GCP resource this asset
+            represents. This field is immutable after create time. See: ht
+            tps://cloud.google.com/apis/design/resource\_names#full\_resou
+            rce\_name
+        resource_type:
+            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.
+        resource_parent:
+            The full resource name of the immediate parent of the
+            resource. See: https://cloud.google.com/apis/design/resource\_
+            names#full\_resource\_name
+        resource_project:
+            The full resource name of the project the resource belongs to.
+            See: https://cloud.google.com/apis/design/resource\_names#full
+            \_resource\_name
+        resource_owners:
+            Owners of the Google Cloud resource.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.Asset.SecurityCenterProperties)
+            ),
+        ),
+        ResourcePropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "ResourcePropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ASSET_RESOURCEPROPERTIESENTRY,
+                __module__="google.cloud.securitycenter_v1beta1.proto.asset_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.Asset.ResourcePropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_ASSET,
+        __module__="google.cloud.securitycenter_v1beta1.proto.asset_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of this asset. See: https://cloud.g
+          oogle.com/apis/design/resource\_names#relative\_resource\_name
+          Example: "organizations/123/assets/456".
+      security_center_properties:
+          Cloud SCC managed properties. These properties are managed by
+          Cloud SCC and cannot be modified by the user.
+      resource_properties:
+          Resource managed properties. These properties are managed and
+          defined by the GCP resource and cannot be modified by the
+          user.
+      security_marks:
+          User specified security marks. These marks are entirely
+          managed by the user and come from the SecurityMarks resource
+          that belongs to the asset.
+      create_time:
+          The time at which the asset was created in Cloud SCC.
+      update_time:
+          The time at which the asset was last updated, added, or
+          deleted in Cloud SCC.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.Asset)
+    ),
+)
+_sym_db.RegisterMessage(Asset)
+_sym_db.RegisterMessage(Asset.SecurityCenterProperties)
+_sym_db.RegisterMessage(Asset.ResourcePropertiesEntry)
+
+
+DESCRIPTOR._options = None
+_ASSET_RESOURCEPROPERTIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/asset_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding.proto b/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding.proto
new file mode 100644
index 000000000000..21dfdd5616e2
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding.proto
@@ -0,0 +1,99 @@
+// 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.cloud.securitycenter.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1beta1/security_marks.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.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";
+
+// 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 {
+  // 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/123/sources/456/findings/789"
+  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"
+  string parent = 2;
+
+  // The full resource name of the Google Cloud Platform (GCP) resource this
+  // finding is for. See:
+  // https://cloud.google.com/apis/design/resource_names#full_resource_name
+  // 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<string, google.protobuf.Value> 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;
+
+  // 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.
+  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/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding_pb2.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding_pb2.py
new file mode 100644
index 000000000000..a85a20232890
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding_pb2.py
@@ -0,0 +1,427 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1beta1/proto/finding.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.securitycenter_v1beta1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2,
+)
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1beta1/proto/finding.proto",
+    package="google.cloud.securitycenter.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n'com.google.cloud.securitycenter.v1beta1P\001ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/securitycenter_v1beta1/proto/finding.proto\x12#google.cloud.securitycenter.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a>google/cloud/securitycenter_v1beta1/proto/security_marks.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xc0\x04\n\x07\x46inding\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06parent\x18\x02 \x01(\t\x12\x15\n\rresource_name\x18\x03 \x01(\t\x12\x41\n\x05state\x18\x04 \x01(\x0e\x32\x32.google.cloud.securitycenter.v1beta1.Finding.State\x12\x10\n\x08\x63\x61tegory\x18\x05 \x01(\t\x12\x14\n\x0c\x65xternal_uri\x18\x06 \x01(\t\x12]\n\x11source_properties\x18\x07 \x03(\x0b\x32\x42.google.cloud.securitycenter.v1beta1.Finding.SourcePropertiesEntry\x12J\n\x0esecurity_marks\x18\x08 \x01(\x0b\x32\x32.google.cloud.securitycenter.v1beta1.SecurityMarks\x12.\n\nevent_time\x18\t \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1aO\n\x15SourcePropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01"8\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\n\n\x06\x41\x43TIVE\x10\x01\x12\x0c\n\x08INACTIVE\x10\x02\x42~\n\'com.google.cloud.securitycenter.v1beta1P\x01ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenterb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_FINDING_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.securitycenter.v1beta1.Finding.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INACTIVE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=774,
+    serialized_end=830,
+)
+_sym_db.RegisterEnumDescriptor(_FINDING_STATE)
+
+
+_FINDING_SOURCEPROPERTIESENTRY = _descriptor.Descriptor(
+    name="SourcePropertiesEntry",
+    full_name="google.cloud.securitycenter.v1beta1.Finding.SourcePropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.SourcePropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.SourcePropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=693,
+    serialized_end=772,
+)
+
+_FINDING = _descriptor.Descriptor(
+    name="Finding",
+    full_name="google.cloud.securitycenter.v1beta1.Finding",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.parent",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_name",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.resource_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.state",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.category",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="external_uri",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.external_uri",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_properties",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.source_properties",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="security_marks",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.security_marks",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_time",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.event_time",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.securitycenter.v1beta1.Finding.create_time",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FINDING_SOURCEPROPERTIESENTRY],
+    enum_types=[_FINDING_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=254,
+    serialized_end=830,
+)
+
+_FINDING_SOURCEPROPERTIESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_FINDING_SOURCEPROPERTIESENTRY.containing_type = _FINDING
+_FINDING.fields_by_name["state"].enum_type = _FINDING_STATE
+_FINDING.fields_by_name[
+    "source_properties"
+].message_type = _FINDING_SOURCEPROPERTIESENTRY
+_FINDING.fields_by_name[
+    "security_marks"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2._SECURITYMARKS
+)
+_FINDING.fields_by_name[
+    "event_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FINDING.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_FINDING_STATE.containing_type = _FINDING
+DESCRIPTOR.message_types_by_name["Finding"] = _FINDING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Finding = _reflection.GeneratedProtocolMessageType(
+    "Finding",
+    (_message.Message,),
+    dict(
+        SourcePropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "SourcePropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FINDING_SOURCEPROPERTIESENTRY,
+                __module__="google.cloud.securitycenter_v1beta1.proto.finding_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.Finding.SourcePropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_FINDING,
+        __module__="google.cloud.securitycenter_v1beta1.proto.finding_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of this finding. See: https://cloud
+          .google.com/apis/design/resource\_names#relative\_resource\_na
+          me Example: "organizations/123/sources/456/findings/789"
+      parent:
+          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"
+      resource_name:
+          The full resource name of the Google Cloud Platform (GCP)
+          resource this finding is for. See: https://cloud.google.com/ap
+          is/design/resource\_names#full\_resource\_name This field is
+          immutable after creation time.
+      state:
+          The state of the finding.
+      category:
+          The additional taxonomy group within findings from a given
+          source. This field is immutable after creation time. Example:
+          "XSS\_FLASH\_INJECTION"
+      external_uri:
+          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.
+      source_properties:
+          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.
+      security_marks:
+          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.
+      event_time:
+          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.
+      create_time:
+          The time at which the finding was created in Cloud SCC.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.Finding)
+    ),
+)
+_sym_db.RegisterMessage(Finding)
+_sym_db.RegisterMessage(Finding.SourcePropertiesEntry)
+
+
+DESCRIPTOR._options = None
+_FINDING_SOURCEPROPERTIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/finding_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings.proto b/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings.proto
new file mode 100644
index 000000000000..ca9be1145473
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings.proto
@@ -0,0 +1,74 @@
+// 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.cloud.securitycenter.v1beta1;
+
+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";
+
+// User specified settings that are attached to the Cloud Security Command
+// Center (Cloud SCC) organization.
+message 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/123/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/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings_pb2.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings_pb2.py
new file mode 100644
index 000000000000..e7c1588af71e
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings_pb2.py
@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1beta1/proto/organization_settings.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1beta1/proto/organization_settings.proto",
+    package="google.cloud.securitycenter.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n'com.google.cloud.securitycenter.v1beta1P\001ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter"
+    ),
+    serialized_pb=_b(
+        '\nEgoogle/cloud/securitycenter_v1beta1/proto/organization_settings.proto\x12#google.cloud.securitycenter.v1beta1\x1a\x1cgoogle/api/annotations.proto"\xa8\x03\n\x14OrganizationSettings\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x1e\n\x16\x65nable_asset_discovery\x18\x02 \x01(\x08\x12n\n\x16\x61sset_discovery_config\x18\x03 \x01(\x0b\x32N.google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig\x1a\xf1\x01\n\x14\x41ssetDiscoveryConfig\x12\x13\n\x0bproject_ids\x18\x01 \x03(\t\x12t\n\x0einclusion_mode\x18\x02 \x01(\x0e\x32\\.google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig.InclusionMode"N\n\rInclusionMode\x12\x1e\n\x1aINCLUSION_MODE_UNSPECIFIED\x10\x00\x12\x10\n\x0cINCLUDE_ONLY\x10\x01\x12\x0b\n\x07\x45XCLUDE\x10\x02\x42~\n\'com.google.cloud.securitycenter.v1beta1P\x01ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenterb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE = _descriptor.EnumDescriptor(
+    name="InclusionMode",
+    full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig.InclusionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="INCLUSION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INCLUDE_ONLY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXCLUDE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=487,
+    serialized_end=565,
+)
+_sym_db.RegisterEnumDescriptor(_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE)
+
+
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG = _descriptor.Descriptor(
+    name="AssetDiscoveryConfig",
+    full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_ids",
+            full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig.project_ids",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inclusion_mode",
+            full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig.inclusion_mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=324,
+    serialized_end=565,
+)
+
+_ORGANIZATIONSETTINGS = _descriptor.Descriptor(
+    name="OrganizationSettings",
+    full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_asset_discovery",
+            full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.enable_asset_discovery",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="asset_discovery_config",
+            full_name="google.cloud.securitycenter.v1beta1.OrganizationSettings.asset_discovery_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=141,
+    serialized_end=565,
+)
+
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG.fields_by_name[
+    "inclusion_mode"
+].enum_type = _ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG.containing_type = _ORGANIZATIONSETTINGS
+_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG_INCLUSIONMODE.containing_type = (
+    _ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG
+)
+_ORGANIZATIONSETTINGS.fields_by_name[
+    "asset_discovery_config"
+].message_type = _ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG
+DESCRIPTOR.message_types_by_name["OrganizationSettings"] = _ORGANIZATIONSETTINGS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+OrganizationSettings = _reflection.GeneratedProtocolMessageType(
+    "OrganizationSettings",
+    (_message.Message,),
+    dict(
+        AssetDiscoveryConfig=_reflection.GeneratedProtocolMessageType(
+            "AssetDiscoveryConfig",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_ORGANIZATIONSETTINGS_ASSETDISCOVERYCONFIG,
+                __module__="google.cloud.securitycenter_v1beta1.proto.organization_settings_pb2",
+                __doc__="""The configuration used for Asset Discovery runs.
+    
+    
+    Attributes:
+        project_ids:
+            The project ids to use for filtering asset discovery.
+        inclusion_mode:
+            The mode to use for filtering asset discovery.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.OrganizationSettings.AssetDiscoveryConfig)
+            ),
+        ),
+        DESCRIPTOR=_ORGANIZATIONSETTINGS,
+        __module__="google.cloud.securitycenter_v1beta1.proto.organization_settings_pb2",
+        __doc__="""User specified settings that are attached to the Cloud Security Command
+  Center (Cloud SCC) organization.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of the settings. See: https://cloud
+          .google.com/apis/design/resource\_names#relative\_resource\_na
+          me Example: "organizations/123/organizationSettings".
+      enable_asset_discovery:
+          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.
+      asset_discovery_config:
+          The configuration used for Asset Discovery runs.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.OrganizationSettings)
+    ),
+)
+_sym_db.RegisterMessage(OrganizationSettings)
+_sym_db.RegisterMessage(OrganizationSettings.AssetDiscoveryConfig)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/organization_settings_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks.proto b/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks.proto
new file mode 100644
index 000000000000..cfcb5f7dcb92
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks.proto
@@ -0,0 +1,45 @@
+// 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.cloud.securitycenter.v1beta1;
+
+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";
+
+// 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 {
+  // 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".
+  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
+  //     characters must be between 1 - 4096 characters (inclusive)
+  map<string, string> marks = 2;
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks_pb2.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks_pb2.py
new file mode 100644
index 000000000000..dcee636baff8
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks_pb2.py
@@ -0,0 +1,196 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1beta1/proto/security_marks.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1beta1/proto/security_marks.proto",
+    package="google.cloud.securitycenter.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n'com.google.cloud.securitycenter.v1beta1P\001ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter"
+    ),
+    serialized_pb=_b(
+        "\n>google/cloud/securitycenter_v1beta1/proto/security_marks.proto\x12#google.cloud.securitycenter.v1beta1\x1a\x1cgoogle/api/annotations.proto\"\x99\x01\n\rSecurityMarks\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x05marks\x18\x02 \x03(\x0b\x32=.google.cloud.securitycenter.v1beta1.SecurityMarks.MarksEntry\x1a,\n\nMarksEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42~\n'com.google.cloud.securitycenter.v1beta1P\x01ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenterb\x06proto3"
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_SECURITYMARKS_MARKSENTRY = _descriptor.Descriptor(
+    name="MarksEntry",
+    full_name="google.cloud.securitycenter.v1beta1.SecurityMarks.MarksEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityMarks.MarksEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityMarks.MarksEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=243,
+    serialized_end=287,
+)
+
+_SECURITYMARKS = _descriptor.Descriptor(
+    name="SecurityMarks",
+    full_name="google.cloud.securitycenter.v1beta1.SecurityMarks",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityMarks.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="marks",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityMarks.marks",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SECURITYMARKS_MARKSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=134,
+    serialized_end=287,
+)
+
+_SECURITYMARKS_MARKSENTRY.containing_type = _SECURITYMARKS
+_SECURITYMARKS.fields_by_name["marks"].message_type = _SECURITYMARKS_MARKSENTRY
+DESCRIPTOR.message_types_by_name["SecurityMarks"] = _SECURITYMARKS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SecurityMarks = _reflection.GeneratedProtocolMessageType(
+    "SecurityMarks",
+    (_message.Message,),
+    dict(
+        MarksEntry=_reflection.GeneratedProtocolMessageType(
+            "MarksEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SECURITYMARKS_MARKSENTRY,
+                __module__="google.cloud.securitycenter_v1beta1.proto.security_marks_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.SecurityMarks.MarksEntry)
+            ),
+        ),
+        DESCRIPTOR=_SECURITYMARKS,
+        __module__="google.cloud.securitycenter_v1beta1.proto.security_marks_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of the SecurityMarks. See: https://
+          cloud.google.com/apis/design/resource\_names#relative\_resourc
+          e\_name Examples: "organizations/123/assets/456/securityMarks"
+          "organizations/123/sources/456/findings/789/securityMarks".
+      marks:
+          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 characters must be
+          between 1 - 4096 characters (inclusive)
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.SecurityMarks)
+    ),
+)
+_sym_db.RegisterMessage(SecurityMarks)
+_sym_db.RegisterMessage(SecurityMarks.MarksEntry)
+
+
+DESCRIPTOR._options = None
+_SECURITYMARKS_MARKSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/security_marks_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service.proto b/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service.proto
new file mode 100644
index 000000000000..dafce562dc7e
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service.proto
@@ -0,0 +1,755 @@
+// 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.cloud.securitycenter.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1beta1/asset.proto";
+import "google/cloud/securitycenter/v1beta1/finding.proto";
+import "google/cloud/securitycenter/v1beta1/organization_settings.proto";
+import "google/cloud/securitycenter/v1beta1/security_marks.proto";
+import "google/cloud/securitycenter/v1beta1/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 go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1beta1";
+
+// V1 Beta APIs for Security Center service.
+service SecurityCenter {
+  // Creates a source.
+  rpc CreateSource(CreateSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=organizations/*}/sources"
+      body: "source"
+    };
+  }
+
+  // Creates a finding. The corresponding source must exist for finding creation
+  // to succeed.
+  rpc CreateFinding(CreateFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=organizations/*/sources/*}/findings"
+      body: "finding"
+    };
+  }
+
+  // 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: "/v1beta1/{resource=organizations/*/sources/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the settings for an organization.
+  rpc GetOrganizationSettings(GetOrganizationSettingsRequest)
+      returns (OrganizationSettings) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=organizations/*/organizationSettings}"
+    };
+  }
+
+  // Gets a source.
+  rpc GetSource(GetSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=organizations/*/sources/*}"
+    };
+  }
+
+  // Filters an organization's assets and  groups them by their specified
+  // properties.
+  rpc GroupAssets(GroupAssetsRequest) returns (GroupAssetsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{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: /v1beta1/organizations/123/sources/-/findings
+  rpc GroupFindings(GroupFindingsRequest) returns (GroupFindingsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=organizations/*/sources/*}/findings:group"
+      body: "*"
+    };
+  }
+
+  // Lists an organization's assets.
+  rpc ListAssets(ListAssetsRequest) returns (ListAssetsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=organizations/*}/assets"
+    };
+  }
+
+  // Lists an organization or source's findings.
+  //
+  // To list across all sources provide a `-` as the source id.
+  // Example: /v1beta1/organizations/123/sources/-/findings
+  rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=organizations/*/sources/*}/findings"
+    };
+  }
+
+  // Lists all sources belonging to an organization.
+  rpc ListSources(ListSourcesRequest) returns (ListSourcesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=organizations/*}/sources"
+    };
+  }
+
+  // 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: "/v1beta1/{parent=organizations/*}/assets:runDiscovery"
+      body: "*"
+    };
+  }
+
+  // Updates the state of a finding.
+  rpc SetFindingState(SetFindingStateRequest) returns (Finding) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=organizations/*/sources/*/findings/*}:setState"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1beta1/{resource=organizations/*/sources/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1beta1/{resource=organizations/*/sources/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1beta1/{finding.name=organizations/*/sources/*/findings/*}"
+      body: "finding"
+    };
+  }
+
+  // Updates an organization's settings.
+  rpc UpdateOrganizationSettings(UpdateOrganizationSettingsRequest)
+      returns (OrganizationSettings) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{organization_settings.name=organizations/*/organizationSettings}"
+      body: "organization_settings"
+    };
+  }
+
+  // Updates a source.
+  rpc UpdateSource(UpdateSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{source.name=organizations/*/sources/*}"
+      body: "source"
+    };
+  }
+
+  // Updates security marks.
+  rpc UpdateSecurityMarks(UpdateSecurityMarksRequest) returns (SecurityMarks) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{security_marks.name=organizations/*/assets/*/securityMarks}"
+      body: "security_marks"
+      additional_bindings {
+        patch: "/v1beta1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}"
+        body: "security_marks"
+      }
+    };
+  }
+}
+
+// Request message for creating a finding.
+message CreateFindingRequest {
+  // Resource name of the new finding's parent. Its format should be
+  // "organizations/[organization_id]/sources/[source_id]".
+  string parent = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// Request message for creating a source.
+message CreateSourceRequest {
+  // Resource name of the new source's parent. Its format should be
+  // "organizations/[organization_id]".
+  string parent = 1;
+
+  // The Source being created, only the display_name and description will be
+  // used. All other fields will be ignored.
+  Source source = 2;
+}
+
+// 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;
+}
+
+// Request message for getting a source.
+message GetSourceRequest {
+  // Relative resource name of the source. Its format is
+  // "organizations/[organization_id]/source/[source_id]".
+  string name = 1;
+}
+
+// Request message for grouping by assets.
+message GroupAssetsRequest {
+  // Name of the organization to groupBy. Its format is
+  // "organizations/[organization_id]".
+  string parent = 1;
+
+  // 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 not supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `<field> <operator> <value>` 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.
+  //
+  // 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:
+  // "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_type
+  // * security_center_properties.resource_parent
+  //
+  // The following fields are supported when compare_duration is set:
+  //
+  // * security_center_properties.resource_type
+  string group_by = 3;
+
+  // When compare_duration is set, the Asset's "state" 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 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" values when compare_duration is specified:
+  //
+  // * "ADDED": indicates that the asset was not present before
+  //              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.
+  //
+  // This field is ignored if `state` is not a 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;
+
+  // 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;
+}
+
+// Request message for grouping by findings.
+message GroupFindingsRequest {
+  // 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;
+
+  // 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 not supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `<field> <operator> <value>` 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.
+  //
+  // 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`). 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
+  string group_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;
+
+  // 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 = 5;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 6;
+}
+
+// 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;
+}
+
+// Result containing the properties and count of a groupBy request.
+message GroupResult {
+  // Properties matching the groupBy fields in the request.
+  map<string, google.protobuf.Value> properties = 1;
+
+  // Total count of resources for the given properties.
+  int64 count = 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;
+
+  // 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 {
+  // Name of the organization assets should belong to. Its format is
+  // "organizations/[organization_id]".
+  string parent = 1;
+
+  // 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 not supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `<field> <operator> <value>` 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.
+  //
+  // 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.
+  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 ListAssetResult's "state" 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 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" values when compare_duration is specified:
+  //
+  // * "ADDED": indicates that the asset was not present before
+  //              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 is
+  // "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
+  // response.
+  // An empty field mask will list all fields.
+  google.protobuf.FieldMask field_mask = 7;
+
+  // 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 {
+    // 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 should
+    // be: UNUSED
+    enum State {
+      // Unspecified state.
+      STATE_UNSPECIFIED = 0;
+
+      // Request did not specify use of this field in the result.
+      UNUSED = 1;
+
+      // Asset was added between the points in time.
+      ADDED = 2;
+
+      // Asset was removed between the points in time.
+      REMOVED = 3;
+
+      // Asset was active at both point(s) in time.
+      ACTIVE = 4;
+    }
+
+    // Asset matching the search request.
+    Asset asset = 1;
+
+    // State of the asset.
+    State state = 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 {
+  // 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;
+
+  // 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 not supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `<field> <operator> <value>` 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.
+  //
+  // 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.
+  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;
+
+  // 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;
+
+  // 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 = 6;
+
+  // 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 findings.
+message ListFindingsResponse {
+  // Findings matching the list request.
+  repeated Finding findings = 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 {
+  // 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;
+
+  // The desired State of the finding.
+  Finding.State state = 2;
+
+  // The time at which the updated state takes effect.
+  google.protobuf.Timestamp start_time = 3;
+}
+
+// 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;
+}
+
+// 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.
+  //
+  // 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;
+
+  // The FieldMask to use when updating the finding resource. This field should
+  // not be specified when creating a finding.
+  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;
+
+  // The FieldMask to use when updating the settings resource.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for updating a source.
+message UpdateSourceRequest {
+  // The source resource to update.
+  Source source = 1;
+
+  // The FieldMask to use when updating the source resource.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for updating a SecurityMarks resource.
+message UpdateSecurityMarksRequest {
+  // The security marks resource to update.
+  SecurityMarks security_marks = 1;
+
+  // The FieldMask to use when updating the security marks resource.
+  google.protobuf.FieldMask update_mask = 2;
+
+  // The time at which the updated SecurityMarks take effect.
+  google.protobuf.Timestamp start_time = 3;
+}
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service_pb2.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service_pb2.py
new file mode 100644
index 000000000000..42d309b63cdb
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service_pb2.py
@@ -0,0 +1,2974 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1beta1/proto/securitycenter_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.securitycenter_v1beta1.proto import (
+    asset_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_asset__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    finding_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    organization_settings_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    source_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1beta1/proto/securitycenter_service.proto",
+    package="google.cloud.securitycenter.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n'com.google.cloud.securitycenter.v1beta1P\001ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter"
+    ),
+    serialized_pb=_b(
+        '\nFgoogle/cloud/securitycenter_v1beta1/proto/securitycenter_service.proto\x12#google.cloud.securitycenter.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x35google/cloud/securitycenter_v1beta1/proto/asset.proto\x1a\x37google/cloud/securitycenter_v1beta1/proto/finding.proto\x1a\x45google/cloud/securitycenter_v1beta1/proto/organization_settings.proto\x1a>google/cloud/securitycenter_v1beta1/proto/security_marks.proto\x1a\x36google/cloud/securitycenter_v1beta1/proto/source.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"y\n\x14\x43reateFindingRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\nfinding_id\x18\x02 \x01(\t\x12=\n\x07\x66inding\x18\x03 \x01(\x0b\x32,.google.cloud.securitycenter.v1beta1.Finding"b\n\x13\x43reateSourceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12;\n\x06source\x18\x02 \x01(\x0b\x32+.google.cloud.securitycenter.v1beta1.Source".\n\x1eGetOrganizationSettingsRequest\x12\x0c\n\x04name\x18\x01 \x01(\t" \n\x10GetSourceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xd1\x01\n\x12GroupAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08group_by\x18\x03 \x01(\t\x12\x33\n\x10\x63ompare_duration\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12-\n\tread_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\npage_token\x18\x07 \x01(\t\x12\x11\n\tpage_size\x18\x08 \x01(\x05"\xa9\x01\n\x13GroupAssetsResponse\x12J\n\x10group_by_results\x18\x01 \x03(\x0b\x32\x30.google.cloud.securitycenter.v1beta1.GroupResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"\x9e\x01\n\x14GroupFindingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08group_by\x18\x03 \x01(\t\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\npage_token\x18\x05 \x01(\t\x12\x11\n\tpage_size\x18\x06 \x01(\x05"\xab\x01\n\x15GroupFindingsResponse\x12J\n\x10group_by_results\x18\x01 \x03(\x0b\x32\x30.google.cloud.securitycenter.v1beta1.GroupResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"\xbd\x01\n\x0bGroupResult\x12T\n\nproperties\x18\x01 \x03(\x0b\x32@.google.cloud.securitycenter.v1beta1.GroupResult.PropertiesEntry\x12\r\n\x05\x63ount\x18\x02 \x01(\x03\x1aI\n\x0fPropertiesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01"K\n\x12ListSourcesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x07 \x01(\x05"l\n\x13ListSourcesResponse\x12<\n\x07sources\x18\x01 \x03(\x0b\x32+.google.cloud.securitycenter.v1beta1.Source\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x80\x02\n\x11ListAssetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08order_by\x18\x03 \x01(\t\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x10\x63ompare_duration\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\nfield_mask\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x12\n\npage_token\x18\x08 \x01(\t\x12\x11\n\tpage_size\x18\t \x01(\x05"\xd6\x03\n\x12ListAssetsResponse\x12\x65\n\x13list_assets_results\x18\x01 \x03(\x0b\x32H.google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12\x12\n\ntotal_size\x18\x04 \x01(\x05\x1a\xfc\x01\n\x10ListAssetsResult\x12\x39\n\x05\x61sset\x18\x01 \x01(\x0b\x32*.google.cloud.securitycenter.v1beta1.Asset\x12]\n\x05state\x18\x02 \x01(\x0e\x32N.google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult.State"N\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\n\n\x06UNUSED\x10\x01\x12\t\n\x05\x41\x44\x44\x45\x44\x10\x02\x12\x0b\n\x07REMOVED\x10\x03\x12\n\n\x06\x41\x43TIVE\x10\x04"\xcd\x01\n\x13ListFindingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x10\n\x08order_by\x18\x03 \x01(\t\x12-\n\tread_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nfield_mask\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12\x12\n\npage_token\x18\x06 \x01(\t\x12\x11\n\tpage_size\x18\x07 \x01(\x05"\xb2\x01\n\x14ListFindingsResponse\x12>\n\x08\x66indings\x18\x01 \x03(\x0b\x32,.google.cloud.securitycenter.v1beta1.Finding\x12-\n\tread_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12\x12\n\ntotal_size\x18\x04 \x01(\x05"\x99\x01\n\x16SetFindingStateRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x41\n\x05state\x18\x02 \x01(\x0e\x32\x32.google.cloud.securitycenter.v1beta1.Finding.State\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"*\n\x18RunAssetDiscoveryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t"\x86\x01\n\x14UpdateFindingRequest\x12=\n\x07\x66inding\x18\x01 \x01(\x0b\x32,.google.cloud.securitycenter.v1beta1.Finding\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xae\x01\n!UpdateOrganizationSettingsRequest\x12X\n\x15organization_settings\x18\x01 \x01(\x0b\x32\x39.google.cloud.securitycenter.v1beta1.OrganizationSettings\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\x83\x01\n\x13UpdateSourceRequest\x12;\n\x06source\x18\x01 \x01(\x0b\x32+.google.cloud.securitycenter.v1beta1.Source\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xc9\x01\n\x1aUpdateSecurityMarksRequest\x12J\n\x0esecurity_marks\x18\x01 \x01(\x0b\x32\x32.google.cloud.securitycenter.v1beta1.SecurityMarks\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\x80\x1c\n\x0eSecurityCenter\x12\xb0\x01\n\x0c\x43reateSource\x12\x38.google.cloud.securitycenter.v1beta1.CreateSourceRequest\x1a+.google.cloud.securitycenter.v1beta1.Source"9\x82\xd3\xe4\x93\x02\x33")/v1beta1/{parent=organizations/*}/sources:\x06source\x12\xbf\x01\n\rCreateFinding\x12\x39.google.cloud.securitycenter.v1beta1.CreateFindingRequest\x1a,.google.cloud.securitycenter.v1beta1.Finding"E\x82\xd3\xe4\x93\x02?"4/v1beta1/{parent=organizations/*/sources/*}/findings:\x07\x66inding\x12\x90\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"E\x82\xd3\xe4\x93\x02?":/v1beta1/{resource=organizations/*/sources/*}:getIamPolicy:\x01*\x12\xd7\x01\n\x17GetOrganizationSettings\x12\x43.google.cloud.securitycenter.v1beta1.GetOrganizationSettingsRequest\x1a\x39.google.cloud.securitycenter.v1beta1.OrganizationSettings"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{name=organizations/*/organizationSettings}\x12\xa2\x01\n\tGetSource\x12\x35.google.cloud.securitycenter.v1beta1.GetSourceRequest\x1a+.google.cloud.securitycenter.v1beta1.Source"1\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{name=organizations/*/sources/*}\x12\xbb\x01\n\x0bGroupAssets\x12\x37.google.cloud.securitycenter.v1beta1.GroupAssetsRequest\x1a\x38.google.cloud.securitycenter.v1beta1.GroupAssetsResponse"9\x82\xd3\xe4\x93\x02\x33"./v1beta1/{parent=organizations/*}/assets:group:\x01*\x12\xcd\x01\n\rGroupFindings\x12\x39.google.cloud.securitycenter.v1beta1.GroupFindingsRequest\x1a:.google.cloud.securitycenter.v1beta1.GroupFindingsResponse"E\x82\xd3\xe4\x93\x02?":/v1beta1/{parent=organizations/*/sources/*}/findings:group:\x01*\x12\xaf\x01\n\nListAssets\x12\x36.google.cloud.securitycenter.v1beta1.ListAssetsRequest\x1a\x37.google.cloud.securitycenter.v1beta1.ListAssetsResponse"0\x82\xd3\xe4\x93\x02*\x12(/v1beta1/{parent=organizations/*}/assets\x12\xc1\x01\n\x0cListFindings\x12\x38.google.cloud.securitycenter.v1beta1.ListFindingsRequest\x1a\x39.google.cloud.securitycenter.v1beta1.ListFindingsResponse"<\x82\xd3\xe4\x93\x02\x36\x12\x34/v1beta1/{parent=organizations/*/sources/*}/findings\x12\xb3\x01\n\x0bListSources\x12\x37.google.cloud.securitycenter.v1beta1.ListSourcesRequest\x1a\x38.google.cloud.securitycenter.v1beta1.ListSourcesResponse"1\x82\xd3\xe4\x93\x02+\x12)/v1beta1/{parent=organizations/*}/sources\x12\xb3\x01\n\x11RunAssetDiscovery\x12=.google.cloud.securitycenter.v1beta1.RunAssetDiscoveryRequest\x1a\x1d.google.longrunning.Operation"@\x82\xd3\xe4\x93\x02:"5/v1beta1/{parent=organizations/*}/assets:runDiscovery:\x01*\x12\xc6\x01\n\x0fSetFindingState\x12;.google.cloud.securitycenter.v1beta1.SetFindingStateRequest\x1a,.google.cloud.securitycenter.v1beta1.Finding"H\x82\xd3\xe4\x93\x02\x42"=/v1beta1/{name=organizations/*/sources/*/findings/*}:setState:\x01*\x12\x90\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"E\x82\xd3\xe4\x93\x02?":/v1beta1/{resource=organizations/*/sources/*}:setIamPolicy:\x01*\x12\xb6\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"K\x82\xd3\xe4\x93\x02\x45"@/v1beta1/{resource=organizations/*/sources/*}:testIamPermissions:\x01*\x12\xc7\x01\n\rUpdateFinding\x12\x39.google.cloud.securitycenter.v1beta1.UpdateFindingRequest\x1a,.google.cloud.securitycenter.v1beta1.Finding"M\x82\xd3\xe4\x93\x02G2</v1beta1/{finding.name=organizations/*/sources/*/findings/*}:\x07\x66inding\x12\x8a\x02\n\x1aUpdateOrganizationSettings\x12\x46.google.cloud.securitycenter.v1beta1.UpdateOrganizationSettingsRequest\x1a\x39.google.cloud.securitycenter.v1beta1.OrganizationSettings"i\x82\xd3\xe4\x93\x02\x63\x32J/v1beta1/{organization_settings.name=organizations/*/organizationSettings}:\x15organization_settings\x12\xb7\x01\n\x0cUpdateSource\x12\x38.google.cloud.securitycenter.v1beta1.UpdateSourceRequest\x1a+.google.cloud.securitycenter.v1beta1.Source"@\x82\xd3\xe4\x93\x02:20/v1beta1/{source.name=organizations/*/sources/*}:\x06source\x12\xd0\x02\n\x13UpdateSecurityMarks\x12?.google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest\x1a\x32.google.cloud.securitycenter.v1beta1.SecurityMarks"\xc3\x01\x82\xd3\xe4\x93\x02\xbc\x01\x32\x45/v1beta1/{security_marks.name=organizations/*/assets/*/securityMarks}:\x0esecurity_marksZc2Q/v1beta1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}:\x0esecurity_marksB~\n\'com.google.cloud.securitycenter.v1beta1P\x01ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenterb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_asset__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTASSETSRESPONSE_LISTASSETSRESULT_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNUSED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADDED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REMOVED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACTIVE", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2754,
+    serialized_end=2832,
+)
+_sym_db.RegisterEnumDescriptor(_LISTASSETSRESPONSE_LISTASSETSRESULT_STATE)
+
+
+_CREATEFINDINGREQUEST = _descriptor.Descriptor(
+    name="CreateFindingRequest",
+    full_name="google.cloud.securitycenter.v1beta1.CreateFindingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.CreateFindingRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding_id",
+            full_name="google.cloud.securitycenter.v1beta1.CreateFindingRequest.finding_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding",
+            full_name="google.cloud.securitycenter.v1beta1.CreateFindingRequest.finding",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=699,
+    serialized_end=820,
+)
+
+
+_CREATESOURCEREQUEST = _descriptor.Descriptor(
+    name="CreateSourceRequest",
+    full_name="google.cloud.securitycenter.v1beta1.CreateSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.CreateSourceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.securitycenter.v1beta1.CreateSourceRequest.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=822,
+    serialized_end=920,
+)
+
+
+_GETORGANIZATIONSETTINGSREQUEST = _descriptor.Descriptor(
+    name="GetOrganizationSettingsRequest",
+    full_name="google.cloud.securitycenter.v1beta1.GetOrganizationSettingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.GetOrganizationSettingsRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=922,
+    serialized_end=968,
+)
+
+
+_GETSOURCEREQUEST = _descriptor.Descriptor(
+    name="GetSourceRequest",
+    full_name="google.cloud.securitycenter.v1beta1.GetSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.GetSourceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=970,
+    serialized_end=1002,
+)
+
+
+_GROUPASSETSREQUEST = _descriptor.Descriptor(
+    name="GroupAssetsRequest",
+    full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_by",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.group_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compare_duration",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.compare_duration",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.read_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.page_token",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsRequest.page_size",
+            index=6,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1005,
+    serialized_end=1214,
+)
+
+
+_GROUPASSETSRESPONSE = _descriptor.Descriptor(
+    name="GroupAssetsResponse",
+    full_name="google.cloud.securitycenter.v1beta1.GroupAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group_by_results",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsResponse.group_by_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1beta1.GroupAssetsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1217,
+    serialized_end=1386,
+)
+
+
+_GROUPFINDINGSREQUEST = _descriptor.Descriptor(
+    name="GroupFindingsRequest",
+    full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_by",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest.group_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest.page_token",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsRequest.page_size",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1389,
+    serialized_end=1547,
+)
+
+
+_GROUPFINDINGSRESPONSE = _descriptor.Descriptor(
+    name="GroupFindingsResponse",
+    full_name="google.cloud.securitycenter.v1beta1.GroupFindingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="group_by_results",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsResponse.group_by_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1beta1.GroupFindingsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1550,
+    serialized_end=1721,
+)
+
+
+_GROUPRESULT_PROPERTIESENTRY = _descriptor.Descriptor(
+    name="PropertiesEntry",
+    full_name="google.cloud.securitycenter.v1beta1.GroupResult.PropertiesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.securitycenter.v1beta1.GroupResult.PropertiesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.securitycenter.v1beta1.GroupResult.PropertiesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1840,
+    serialized_end=1913,
+)
+
+_GROUPRESULT = _descriptor.Descriptor(
+    name="GroupResult",
+    full_name="google.cloud.securitycenter.v1beta1.GroupResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.securitycenter.v1beta1.GroupResult.properties",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="count",
+            full_name="google.cloud.securitycenter.v1beta1.GroupResult.count",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GROUPRESULT_PROPERTIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1724,
+    serialized_end=1913,
+)
+
+
+_LISTSOURCESREQUEST = _descriptor.Descriptor(
+    name="ListSourcesRequest",
+    full_name="google.cloud.securitycenter.v1beta1.ListSourcesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.ListSourcesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1beta1.ListSourcesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1beta1.ListSourcesRequest.page_size",
+            index=2,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1915,
+    serialized_end=1990,
+)
+
+
+_LISTSOURCESRESPONSE = _descriptor.Descriptor(
+    name="ListSourcesResponse",
+    full_name="google.cloud.securitycenter.v1beta1.ListSourcesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sources",
+            full_name="google.cloud.securitycenter.v1beta1.ListSourcesResponse.sources",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1beta1.ListSourcesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1992,
+    serialized_end=2100,
+)
+
+
+_LISTASSETSREQUEST = _descriptor.Descriptor(
+    name="ListAssetsRequest",
+    full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.order_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compare_duration",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.compare_duration",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.field_mask",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.page_token",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsRequest.page_size",
+            index=7,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2103,
+    serialized_end=2359,
+)
+
+
+_LISTASSETSRESPONSE_LISTASSETSRESULT = _descriptor.Descriptor(
+    name="ListAssetsResult",
+    full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="asset",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult.asset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTASSETSRESPONSE_LISTASSETSRESULT_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2580,
+    serialized_end=2832,
+)
+
+_LISTASSETSRESPONSE = _descriptor.Descriptor(
+    name="ListAssetsResponse",
+    full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="list_assets_results",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.list_assets_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.securitycenter.v1beta1.ListAssetsResponse.total_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_LISTASSETSRESPONSE_LISTASSETSRESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2362,
+    serialized_end=2832,
+)
+
+
+_LISTFINDINGSREQUEST = _descriptor.Descriptor(
+    name="ListFindingsRequest",
+    full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.order_by",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.read_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.field_mask",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.page_token",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsRequest.page_size",
+            index=6,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2835,
+    serialized_end=3040,
+)
+
+
+_LISTFINDINGSRESPONSE = _descriptor.Descriptor(
+    name="ListFindingsResponse",
+    full_name="google.cloud.securitycenter.v1beta1.ListFindingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="findings",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsResponse.findings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_time",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsResponse.read_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.securitycenter.v1beta1.ListFindingsResponse.total_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3043,
+    serialized_end=3221,
+)
+
+
+_SETFINDINGSTATEREQUEST = _descriptor.Descriptor(
+    name="SetFindingStateRequest",
+    full_name="google.cloud.securitycenter.v1beta1.SetFindingStateRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.SetFindingStateRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.securitycenter.v1beta1.SetFindingStateRequest.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.securitycenter.v1beta1.SetFindingStateRequest.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3224,
+    serialized_end=3377,
+)
+
+
+_RUNASSETDISCOVERYREQUEST = _descriptor.Descriptor(
+    name="RunAssetDiscoveryRequest",
+    full_name="google.cloud.securitycenter.v1beta1.RunAssetDiscoveryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.securitycenter.v1beta1.RunAssetDiscoveryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3379,
+    serialized_end=3421,
+)
+
+
+_UPDATEFINDINGREQUEST = _descriptor.Descriptor(
+    name="UpdateFindingRequest",
+    full_name="google.cloud.securitycenter.v1beta1.UpdateFindingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateFindingRequest.finding",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateFindingRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3424,
+    serialized_end=3558,
+)
+
+
+_UPDATEORGANIZATIONSETTINGSREQUEST = _descriptor.Descriptor(
+    name="UpdateOrganizationSettingsRequest",
+    full_name="google.cloud.securitycenter.v1beta1.UpdateOrganizationSettingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="organization_settings",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateOrganizationSettingsRequest.organization_settings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateOrganizationSettingsRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3561,
+    serialized_end=3735,
+)
+
+
+_UPDATESOURCEREQUEST = _descriptor.Descriptor(
+    name="UpdateSourceRequest",
+    full_name="google.cloud.securitycenter.v1beta1.UpdateSourceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateSourceRequest.source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateSourceRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3738,
+    serialized_end=3869,
+)
+
+
+_UPDATESECURITYMARKSREQUEST = _descriptor.Descriptor(
+    name="UpdateSecurityMarksRequest",
+    full_name="google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="security_marks",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest.security_marks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3872,
+    serialized_end=4073,
+)
+
+_CREATEFINDINGREQUEST.fields_by_name[
+    "finding"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING
+)
+_CREATESOURCEREQUEST.fields_by_name[
+    "source"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2._SOURCE
+)
+_GROUPASSETSREQUEST.fields_by_name[
+    "compare_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_GROUPASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPASSETSRESPONSE.fields_by_name["group_by_results"].message_type = _GROUPRESULT
+_GROUPASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPFINDINGSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPFINDINGSRESPONSE.fields_by_name["group_by_results"].message_type = _GROUPRESULT
+_GROUPFINDINGSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GROUPRESULT_PROPERTIESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_GROUPRESULT_PROPERTIESENTRY.containing_type = _GROUPRESULT
+_GROUPRESULT.fields_by_name["properties"].message_type = _GROUPRESULT_PROPERTIESENTRY
+_LISTSOURCESRESPONSE.fields_by_name[
+    "sources"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2._SOURCE
+)
+_LISTASSETSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTASSETSREQUEST.fields_by_name[
+    "compare_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LISTASSETSREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTASSETSRESPONSE_LISTASSETSRESULT.fields_by_name[
+    "asset"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_asset__pb2._ASSET
+)
+_LISTASSETSRESPONSE_LISTASSETSRESULT.fields_by_name[
+    "state"
+].enum_type = _LISTASSETSRESPONSE_LISTASSETSRESULT_STATE
+_LISTASSETSRESPONSE_LISTASSETSRESULT.containing_type = _LISTASSETSRESPONSE
+_LISTASSETSRESPONSE_LISTASSETSRESULT_STATE.containing_type = (
+    _LISTASSETSRESPONSE_LISTASSETSRESULT
+)
+_LISTASSETSRESPONSE.fields_by_name[
+    "list_assets_results"
+].message_type = _LISTASSETSRESPONSE_LISTASSETSRESULT
+_LISTASSETSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTFINDINGSREQUEST.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTFINDINGSREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTFINDINGSRESPONSE.fields_by_name[
+    "findings"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING
+)
+_LISTFINDINGSRESPONSE.fields_by_name[
+    "read_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SETFINDINGSTATEREQUEST.fields_by_name[
+    "state"
+].enum_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING_STATE
+)
+_SETFINDINGSTATEREQUEST.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEFINDINGREQUEST.fields_by_name[
+    "finding"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING
+)
+_UPDATEFINDINGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATEORGANIZATIONSETTINGSREQUEST.fields_by_name[
+    "organization_settings"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2._ORGANIZATIONSETTINGS
+)
+_UPDATEORGANIZATIONSETTINGSREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATESOURCEREQUEST.fields_by_name[
+    "source"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2._SOURCE
+)
+_UPDATESOURCEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATESECURITYMARKSREQUEST.fields_by_name[
+    "security_marks"
+].message_type = (
+    google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2._SECURITYMARKS
+)
+_UPDATESECURITYMARKSREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_UPDATESECURITYMARKSREQUEST.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["CreateFindingRequest"] = _CREATEFINDINGREQUEST
+DESCRIPTOR.message_types_by_name["CreateSourceRequest"] = _CREATESOURCEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "GetOrganizationSettingsRequest"
+] = _GETORGANIZATIONSETTINGSREQUEST
+DESCRIPTOR.message_types_by_name["GetSourceRequest"] = _GETSOURCEREQUEST
+DESCRIPTOR.message_types_by_name["GroupAssetsRequest"] = _GROUPASSETSREQUEST
+DESCRIPTOR.message_types_by_name["GroupAssetsResponse"] = _GROUPASSETSRESPONSE
+DESCRIPTOR.message_types_by_name["GroupFindingsRequest"] = _GROUPFINDINGSREQUEST
+DESCRIPTOR.message_types_by_name["GroupFindingsResponse"] = _GROUPFINDINGSRESPONSE
+DESCRIPTOR.message_types_by_name["GroupResult"] = _GROUPRESULT
+DESCRIPTOR.message_types_by_name["ListSourcesRequest"] = _LISTSOURCESREQUEST
+DESCRIPTOR.message_types_by_name["ListSourcesResponse"] = _LISTSOURCESRESPONSE
+DESCRIPTOR.message_types_by_name["ListAssetsRequest"] = _LISTASSETSREQUEST
+DESCRIPTOR.message_types_by_name["ListAssetsResponse"] = _LISTASSETSRESPONSE
+DESCRIPTOR.message_types_by_name["ListFindingsRequest"] = _LISTFINDINGSREQUEST
+DESCRIPTOR.message_types_by_name["ListFindingsResponse"] = _LISTFINDINGSRESPONSE
+DESCRIPTOR.message_types_by_name["SetFindingStateRequest"] = _SETFINDINGSTATEREQUEST
+DESCRIPTOR.message_types_by_name["RunAssetDiscoveryRequest"] = _RUNASSETDISCOVERYREQUEST
+DESCRIPTOR.message_types_by_name["UpdateFindingRequest"] = _UPDATEFINDINGREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateOrganizationSettingsRequest"
+] = _UPDATEORGANIZATIONSETTINGSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateSourceRequest"] = _UPDATESOURCEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateSecurityMarksRequest"
+] = _UPDATESECURITYMARKSREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateFindingRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateFindingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEFINDINGREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for creating a finding.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the new finding's parent. Its format should
+          be "organizations/[organization\_id]/sources/[source\_id]".
+      finding_id:
+          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.
+      finding:
+          The Finding being created. The name and security\_marks will
+          be ignored as they are both output only fields on this
+          resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.CreateFindingRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateFindingRequest)
+
+CreateSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESOURCEREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for creating a source.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the new source's parent. Its format should be
+          "organizations/[organization\_id]".
+      source:
+          The Source being created, only the display\_name and
+          description will be used. All other fields will be ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.CreateSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSourceRequest)
+
+GetOrganizationSettingsRequest = _reflection.GeneratedProtocolMessageType(
+    "GetOrganizationSettingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETORGANIZATIONSETTINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for getting organization settings.
+  
+  
+  Attributes:
+      name:
+          Name of the organization to get organization settings for. Its
+          format is
+          "organizations/[organization\_id]/organizationSettings".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GetOrganizationSettingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetOrganizationSettingsRequest)
+
+GetSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSOURCEREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for getting a source.
+  
+  
+  Attributes:
+      name:
+          Relative resource name of the source. Its format is
+          "organizations/[organization\_id]/source/[source\_id]".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GetSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSourceRequest)
+
+GroupAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "GroupAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPASSETSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for grouping by assets.
+  
+  
+  Attributes:
+      parent:
+          Name of the organization to groupBy. Its format is
+          "organizations/[organization\_id]".
+      filter:
+          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 not
+          supported, and ``OR`` has higher precedence than ``AND``.
+          Restrictions have the form ``<field> <operator> <value>`` 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.  For example,
+          ``resource_properties.size = 100`` is a valid filter string.
+      group_by:
+          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\_prop
+          erties.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\_type -
+          security\_center\_properties.resource\_parent  The following
+          fields are supported when compare\_duration is set:  -
+          security\_center\_properties.resource\_type
+      compare_duration:
+          When compare\_duration is set, the Asset's "state" 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
+          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" values when compare\_duration is specified:
+          -  "ADDED": indicates that the asset was not present before
+          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.  This field is
+          ignored if ``state`` is not a field in ``group_by``.
+      read_time:
+          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.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GroupAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(GroupAssetsRequest)
+
+GroupAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "GroupAssetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPASSETSRESPONSE,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for grouping by assets.
+  
+  
+  Attributes:
+      group_by_results:
+          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.
+      read_time:
+          Time used for executing the groupBy request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GroupAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(GroupAssetsResponse)
+
+GroupFindingsRequest = _reflection.GeneratedProtocolMessageType(
+    "GroupFindingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPFINDINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for grouping by findings.
+  
+  
+  Attributes:
+      parent:
+          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/-
+      filter:
+          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 not
+          supported, and ``OR`` has higher precedence than ``AND``.
+          Restrictions have the form ``<field> <operator> <value>`` 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.  For example, ``source_properties.size = 100``
+          is a valid filter string.
+      group_by:
+          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".  The following fields are supported:
+          -  resource\_name -  category -  state -  parent
+      read_time:
+          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.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GroupFindingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(GroupFindingsRequest)
+
+GroupFindingsResponse = _reflection.GeneratedProtocolMessageType(
+    "GroupFindingsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GROUPFINDINGSRESPONSE,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for group by findings.
+  
+  
+  Attributes:
+      group_by_results:
+          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.
+      read_time:
+          Time used for executing the groupBy request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GroupFindingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(GroupFindingsResponse)
+
+GroupResult = _reflection.GeneratedProtocolMessageType(
+    "GroupResult",
+    (_message.Message,),
+    dict(
+        PropertiesEntry=_reflection.GeneratedProtocolMessageType(
+            "PropertiesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GROUPRESULT_PROPERTIESENTRY,
+                __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GroupResult.PropertiesEntry)
+            ),
+        ),
+        DESCRIPTOR=_GROUPRESULT,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Result containing the properties and count of a groupBy request.
+  
+  
+  Attributes:
+      properties:
+          Properties matching the groupBy fields in the request.
+      count:
+          Total count of resources for the given properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.GroupResult)
+    ),
+)
+_sym_db.RegisterMessage(GroupResult)
+_sym_db.RegisterMessage(GroupResult.PropertiesEntry)
+
+ListSourcesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSourcesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSOURCESREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for listing sources.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the parent of sources to list. Its format
+          should be "organizations/[organization\_id]".
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListSourcesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSourcesRequest)
+
+ListSourcesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSourcesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSOURCESRESPONSE,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for listing sources.
+  
+  
+  Attributes:
+      sources:
+          Sources belonging to the requested parent.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListSourcesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSourcesResponse)
+
+ListAssetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListAssetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTASSETSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for listing assets.
+  
+  
+  Attributes:
+      parent:
+          Name of the organization assets should belong to. Its format
+          is "organizations/[organization\_id]".
+      filter:
+          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 not
+          supported, and ``OR`` has higher precedence than ``AND``.
+          Restrictions have the form ``<field> <operator> <value>`` 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.  For example,
+          ``resource_properties.size = 100`` is a valid filter string.
+      order_by:
+          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.
+      read_time:
+          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.
+      compare_duration:
+          When compare\_duration is set, the ListAssetResult's "state"
+          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 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" values when compare\_duration is specified:
+          -  "ADDED": indicates that the asset was not present before
+          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 is "UNUSED", which indicates that the
+          asset is present at read\_time.
+      field_mask:
+          Optional.  A field mask to specify the ListAssetsResult fields
+          to be listed in the response. An empty field mask will list
+          all fields.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListAssetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListAssetsRequest)
+
+ListAssetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListAssetsResponse",
+    (_message.Message,),
+    dict(
+        ListAssetsResult=_reflection.GeneratedProtocolMessageType(
+            "ListAssetsResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_LISTASSETSRESPONSE_LISTASSETSRESULT,
+                __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+                __doc__="""Result containing the Asset and its State.
+    
+    
+    Attributes:
+        asset:
+            Asset matching the search request.
+        state:
+            State of the asset.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListAssetsResponse.ListAssetsResult)
+            ),
+        ),
+        DESCRIPTOR=_LISTASSETSRESPONSE,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for listing assets.
+  
+  
+  Attributes:
+      list_assets_results:
+          Assets matching the list request.
+      read_time:
+          Time used for executing the list request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+      total_size:
+          The total number of assets matching the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListAssetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListAssetsResponse)
+_sym_db.RegisterMessage(ListAssetsResponse.ListAssetsResult)
+
+ListFindingsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for listing findings.
+  
+  
+  Attributes:
+      parent:
+          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/-
+      filter:
+          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 not
+          supported, and ``OR`` has higher precedence than ``AND``.
+          Restrictions have the form ``<field> <operator> <value>`` 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.  For example, ``source_properties.size = 100``
+          is a valid filter string.
+      order_by:
+          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.
+      read_time:
+          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.
+      field_mask:
+          Optional.  A field mask to specify the Finding fields to be
+          listed in the response. An empty field mask will list all
+          fields.
+      page_token:
+          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.
+      page_size:
+          The maximum number of results to return in a single response.
+          Default is 10, minimum is 1, maximum is 1000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListFindingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsRequest)
+
+ListFindingsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSRESPONSE,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Response message for listing findings.
+  
+  
+  Attributes:
+      findings:
+          Findings matching the list request.
+      read_time:
+          Time used for executing the list request.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results.
+      total_size:
+          The total number of findings matching the query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.ListFindingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsResponse)
+
+SetFindingStateRequest = _reflection.GeneratedProtocolMessageType(
+    "SetFindingStateRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SETFINDINGSTATEREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating a finding's state.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of the finding. See: https://cloud.
+          google.com/apis/design/resource\_names#relative\_resource\_nam
+          e Example: "organizations/123/sources/456/finding/789".
+      state:
+          The desired State of the finding.
+      start_time:
+          The time at which the updated state takes effect.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.SetFindingStateRequest)
+    ),
+)
+_sym_db.RegisterMessage(SetFindingStateRequest)
+
+RunAssetDiscoveryRequest = _reflection.GeneratedProtocolMessageType(
+    "RunAssetDiscoveryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNASSETDISCOVERYREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for running asset discovery for an organization.
+  
+  
+  Attributes:
+      parent:
+          Name of the organization to run asset discovery for. Its
+          format is "organizations/[organization\_id]".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.RunAssetDiscoveryRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunAssetDiscoveryRequest)
+
+UpdateFindingRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateFindingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEFINDINGREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating or creating a finding.
+  
+  
+  Attributes:
+      finding:
+          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.
+      update_mask:
+          The FieldMask to use when updating the finding resource. This
+          field should not be specified when creating a finding.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.UpdateFindingRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateFindingRequest)
+
+UpdateOrganizationSettingsRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateOrganizationSettingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEORGANIZATIONSETTINGSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating an organization's settings.
+  
+  
+  Attributes:
+      organization_settings:
+          The organization settings resource to update.
+      update_mask:
+          The FieldMask to use when updating the settings resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.UpdateOrganizationSettingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateOrganizationSettingsRequest)
+
+UpdateSourceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSourceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESOURCEREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating a source.
+  
+  
+  Attributes:
+      source:
+          The source resource to update.
+      update_mask:
+          The FieldMask to use when updating the source resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.UpdateSourceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSourceRequest)
+
+UpdateSecurityMarksRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateSecurityMarksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESECURITYMARKSREQUEST,
+        __module__="google.cloud.securitycenter_v1beta1.proto.securitycenter_service_pb2",
+        __doc__="""Request message for updating a SecurityMarks resource.
+  
+  
+  Attributes:
+      security_marks:
+          The security marks resource to update.
+      update_mask:
+          The FieldMask to use when updating the security marks
+          resource.
+      start_time:
+          The time at which the updated SecurityMarks take effect.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.UpdateSecurityMarksRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateSecurityMarksRequest)
+
+
+DESCRIPTOR._options = None
+_GROUPRESULT_PROPERTIESENTRY._options = None
+
+_SECURITYCENTER = _descriptor.ServiceDescriptor(
+    name="SecurityCenter",
+    full_name="google.cloud.securitycenter.v1beta1.SecurityCenter",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4076,
+    serialized_end=7660,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateSource",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.CreateSource",
+            index=0,
+            containing_service=None,
+            input_type=_CREATESOURCEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2._SOURCE,
+            serialized_options=_b(
+                '\202\323\344\223\0023")/v1beta1/{parent=organizations/*}/sources:\006source'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateFinding",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.CreateFinding",
+            index=1,
+            containing_service=None,
+            input_type=_CREATEFINDINGREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                '\202\323\344\223\002?"4/v1beta1/{parent=organizations/*/sources/*}/findings:\007finding'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.GetIamPolicy",
+            index=2,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v1beta1/{resource=organizations/*/sources/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetOrganizationSettings",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.GetOrganizationSettings",
+            index=3,
+            containing_service=None,
+            input_type=_GETORGANIZATIONSETTINGSREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2._ORGANIZATIONSETTINGS,
+            serialized_options=_b(
+                "\202\323\344\223\0026\0224/v1beta1/{name=organizations/*/organizationSettings}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSource",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.GetSource",
+            index=4,
+            containing_service=None,
+            input_type=_GETSOURCEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2._SOURCE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1beta1/{name=organizations/*/sources/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GroupAssets",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.GroupAssets",
+            index=5,
+            containing_service=None,
+            input_type=_GROUPASSETSREQUEST,
+            output_type=_GROUPASSETSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0023"./v1beta1/{parent=organizations/*}/assets:group:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GroupFindings",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.GroupFindings",
+            index=6,
+            containing_service=None,
+            input_type=_GROUPFINDINGSREQUEST,
+            output_type=_GROUPFINDINGSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v1beta1/{parent=organizations/*/sources/*}/findings:group:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListAssets",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.ListAssets",
+            index=7,
+            containing_service=None,
+            input_type=_LISTASSETSREQUEST,
+            output_type=_LISTASSETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002*\022(/v1beta1/{parent=organizations/*}/assets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFindings",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.ListFindings",
+            index=8,
+            containing_service=None,
+            input_type=_LISTFINDINGSREQUEST,
+            output_type=_LISTFINDINGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0026\0224/v1beta1/{parent=organizations/*/sources/*}/findings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSources",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.ListSources",
+            index=9,
+            containing_service=None,
+            input_type=_LISTSOURCESREQUEST,
+            output_type=_LISTSOURCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002+\022)/v1beta1/{parent=organizations/*}/sources"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunAssetDiscovery",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.RunAssetDiscovery",
+            index=10,
+            containing_service=None,
+            input_type=_RUNASSETDISCOVERYREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v1beta1/{parent=organizations/*}/assets:runDiscovery:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetFindingState",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.SetFindingState",
+            index=11,
+            containing_service=None,
+            input_type=_SETFINDINGSTATEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v1beta1/{name=organizations/*/sources/*/findings/*}:setState:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.SetIamPolicy",
+            index=12,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v1beta1/{resource=organizations/*/sources/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.TestIamPermissions",
+            index=13,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v1beta1/{resource=organizations/*/sources/*}:testIamPermissions:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateFinding",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.UpdateFinding",
+            index=14,
+            containing_service=None,
+            input_type=_UPDATEFINDINGREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                "\202\323\344\223\002G2</v1beta1/{finding.name=organizations/*/sources/*/findings/*}:\007finding"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateOrganizationSettings",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.UpdateOrganizationSettings",
+            index=15,
+            containing_service=None,
+            input_type=_UPDATEORGANIZATIONSETTINGSREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2._ORGANIZATIONSETTINGS,
+            serialized_options=_b(
+                "\202\323\344\223\002c2J/v1beta1/{organization_settings.name=organizations/*/organizationSettings}:\025organization_settings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSource",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.UpdateSource",
+            index=16,
+            containing_service=None,
+            input_type=_UPDATESOURCEREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2._SOURCE,
+            serialized_options=_b(
+                "\202\323\344\223\002:20/v1beta1/{source.name=organizations/*/sources/*}:\006source"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateSecurityMarks",
+            full_name="google.cloud.securitycenter.v1beta1.SecurityCenter.UpdateSecurityMarks",
+            index=17,
+            containing_service=None,
+            input_type=_UPDATESECURITYMARKSREQUEST,
+            output_type=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2._SECURITYMARKS,
+            serialized_options=_b(
+                "\202\323\344\223\002\274\0012E/v1beta1/{security_marks.name=organizations/*/assets/*/securityMarks}:\016security_marksZc2Q/v1beta1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}:\016security_marks"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_SECURITYCENTER)
+
+DESCRIPTOR.services_by_name["SecurityCenter"] = _SECURITYCENTER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service_pb2_grpc.py
new file mode 100644
index 000000000000..f5cb963e7d03
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/securitycenter_service_pb2_grpc.py
@@ -0,0 +1,370 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.securitycenter_v1beta1.proto import (
+    finding_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    organization_settings_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    security_marks_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    securitycenter_service_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2,
+)
+from google.cloud.securitycenter_v1beta1.proto import (
+    source_pb2 as google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class SecurityCenterStub(object):
+    """V1 Beta APIs for Security Center service.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateSource = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/CreateSource",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.CreateSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.Source.FromString,
+        )
+        self.CreateFinding = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/CreateFinding",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.CreateFindingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetOrganizationSettings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/GetOrganizationSettings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GetOrganizationSettingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.FromString,
+        )
+        self.GetSource = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/GetSource",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GetSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.Source.FromString,
+        )
+        self.GroupAssets = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/GroupAssets",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsResponse.FromString,
+        )
+        self.GroupFindings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/GroupFindings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsResponse.FromString,
+        )
+        self.ListAssets = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/ListAssets",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListAssetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListAssetsResponse.FromString,
+        )
+        self.ListFindings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/ListFindings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListFindingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListFindingsResponse.FromString,
+        )
+        self.ListSources = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/ListSources",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListSourcesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListSourcesResponse.FromString,
+        )
+        self.RunAssetDiscovery = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/RunAssetDiscovery",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.RunAssetDiscoveryRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.SetFindingState = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/SetFindingState",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.SetFindingStateRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+        self.UpdateFinding = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/UpdateFinding",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateFindingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.UpdateOrganizationSettings = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/UpdateOrganizationSettings",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateOrganizationSettingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.FromString,
+        )
+        self.UpdateSource = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/UpdateSource",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateSourceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.Source.FromString,
+        )
+        self.UpdateSecurityMarks = channel.unary_unary(
+            "/google.cloud.securitycenter.v1beta1.SecurityCenter/UpdateSecurityMarks",
+            request_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateSecurityMarksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2.SecurityMarks.FromString,
+        )
+
+
+class SecurityCenterServicer(object):
+    """V1 Beta APIs for Security Center service.
+  """
+
+    def CreateSource(self, request, context):
+        """Creates a source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateFinding(self, request, context):
+        """Creates a finding. The corresponding source must exist for finding creation
+    to succeed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy on the specified Source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetOrganizationSettings(self, request, context):
+        """Gets the settings for an organization.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSource(self, request, context):
+        """Gets a source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GroupAssets(self, request, context):
+        """Filters an organization's assets and  groups them by their specified
+    properties.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GroupFindings(self, request, context):
+        """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: /v1beta1/organizations/123/sources/-/findings
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListAssets(self, request, context):
+        """Lists an organization's assets.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFindings(self, request, context):
+        """Lists an organization or source's findings.
+
+    To list across all sources provide a `-` as the source id.
+    Example: /v1beta1/organizations/123/sources/-/findings
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSources(self, request, context):
+        """Lists all sources belonging to an organization.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunAssetDiscovery(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetFindingState(self, request, context):
+        """Updates the state of a finding.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on the specified Source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns the permissions that a caller has on the specified source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateFinding(self, request, context):
+        """Creates or updates a finding. The corresponding source must exist for a
+    finding creation to succeed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateOrganizationSettings(self, request, context):
+        """Updates an organization's settings.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSource(self, request, context):
+        """Updates a source.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateSecurityMarks(self, request, context):
+        """Updates security marks.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SecurityCenterServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateSource": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSource,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.CreateSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.Source.SerializeToString,
+        ),
+        "CreateFinding": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateFinding,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.CreateFindingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetOrganizationSettings": grpc.unary_unary_rpc_method_handler(
+            servicer.GetOrganizationSettings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GetOrganizationSettingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.SerializeToString,
+        ),
+        "GetSource": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSource,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GetSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.Source.SerializeToString,
+        ),
+        "GroupAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.GroupAssets,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupAssetsResponse.SerializeToString,
+        ),
+        "GroupFindings": grpc.unary_unary_rpc_method_handler(
+            servicer.GroupFindings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.GroupFindingsResponse.SerializeToString,
+        ),
+        "ListAssets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListAssets,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListAssetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListAssetsResponse.SerializeToString,
+        ),
+        "ListFindings": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFindings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListFindingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListFindingsResponse.SerializeToString,
+        ),
+        "ListSources": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSources,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListSourcesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.ListSourcesResponse.SerializeToString,
+        ),
+        "RunAssetDiscovery": grpc.unary_unary_rpc_method_handler(
+            servicer.RunAssetDiscovery,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.RunAssetDiscoveryRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "SetFindingState": grpc.unary_unary_rpc_method_handler(
+            servicer.SetFindingState,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.SetFindingStateRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "UpdateFinding": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateFinding,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateFindingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "UpdateOrganizationSettings": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateOrganizationSettings,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateOrganizationSettingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_organization__settings__pb2.OrganizationSettings.SerializeToString,
+        ),
+        "UpdateSource": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSource,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateSourceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_source__pb2.Source.SerializeToString,
+        ),
+        "UpdateSecurityMarks": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateSecurityMarks,
+            request_deserializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_securitycenter__service__pb2.UpdateSecurityMarksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_securitycenter__v1beta1_dot_proto_dot_security__marks__pb2.SecurityMarks.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.securitycenter.v1beta1.SecurityCenter", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/source.proto b/securitycenter/google/cloud/securitycenter_v1beta1/proto/source.proto
new file mode 100644
index 000000000000..cc1fae6eaa66
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/source.proto
@@ -0,0 +1,53 @@
+// 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.cloud.securitycenter.v1beta1;
+
+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";
+
+// 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 {
+  // The relative resource name of this source. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/123/sources/456"
+  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}])?.
+  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/securitycenter/google/cloud/securitycenter_v1beta1/proto/source_pb2.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/source_pb2.py
new file mode 100644
index 000000000000..0fa2b9c2771d
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/source_pb2.py
@@ -0,0 +1,153 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/securitycenter_v1beta1/proto/source.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/securitycenter_v1beta1/proto/source.proto",
+    package="google.cloud.securitycenter.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n'com.google.cloud.securitycenter.v1beta1P\001ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter"
+    ),
+    serialized_pb=_b(
+        "\n6google/cloud/securitycenter_v1beta1/proto/source.proto\x12#google.cloud.securitycenter.v1beta1\x1a\x1cgoogle/api/annotations.proto\"A\n\x06Source\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\tB~\n'com.google.cloud.securitycenter.v1beta1P\x01ZQgoogle.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenterb\x06proto3"
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_SOURCE = _descriptor.Descriptor(
+    name="Source",
+    full_name="google.cloud.securitycenter.v1beta1.Source",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.securitycenter.v1beta1.Source.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.securitycenter.v1beta1.Source.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.securitycenter.v1beta1.Source.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=125,
+    serialized_end=190,
+)
+
+DESCRIPTOR.message_types_by_name["Source"] = _SOURCE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Source = _reflection.GeneratedProtocolMessageType(
+    "Source",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SOURCE,
+        __module__="google.cloud.securitycenter_v1beta1.proto.source_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          The relative resource name of this source. See: https://cloud.
+          google.com/apis/design/resource\_names#relative\_resource\_nam
+          e Example: "organizations/123/sources/456"
+      display_name:
+          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: `:raw-latex:`\p{L}`:raw-latex:`\p{N}` <%7B\p%7BL%7
+          D\p%7BN%7D_-%20%5D%7B0,30%7D%5B\p%7BL%7D\p%7BN%7D%5D>`__?.
+      description:
+          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."
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.securitycenter.v1beta1.Source)
+    ),
+)
+_sym_db.RegisterMessage(Source)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/proto/source_pb2_grpc.py b/securitycenter/google/cloud/securitycenter_v1beta1/proto/source_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/proto/source_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/securitycenter/google/cloud/securitycenter_v1beta1/types.py b/securitycenter/google/cloud/securitycenter_v1beta1/types.py
new file mode 100644
index 000000000000..2c8342a6fb54
--- /dev/null
+++ b/securitycenter/google/cloud/securitycenter_v1beta1/types.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.securitycenter_v1beta1.proto import asset_pb2
+from google.cloud.securitycenter_v1beta1.proto import finding_pb2
+from google.cloud.securitycenter_v1beta1.proto import organization_settings_pb2
+from google.cloud.securitycenter_v1beta1.proto import security_marks_pb2
+from google.cloud.securitycenter_v1beta1.proto import securitycenter_service_pb2
+from google.cloud.securitycenter_v1beta1.proto import source_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    operations_pb2,
+    any_pb2,
+    duration_pb2,
+    field_mask_pb2,
+    struct_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [
+    asset_pb2,
+    finding_pb2,
+    organization_settings_pb2,
+    security_marks_pb2,
+    securitycenter_service_pb2,
+    source_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.securitycenter_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/securitycenter/noxfile.py b/securitycenter/noxfile.py
new file mode 100644
index 000000000000..067648f8765a
--- /dev/null
+++ b/securitycenter/noxfile.py
@@ -0,0 +1,184 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil 
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def snippets(session):
+    """Run the documentation example snippets."""
+    # Sanity check: Only run snippets system tests if the environment variable
+    # is set.
+    if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
+        session.skip('Credentials must be set via environment variable.')
+    if not os.environ.get('GCLOUD_ORGANIZATION', ''):
+        session.skip('Credentials must be set via environment variable.')
+
+
+    # Install all test dependencies, then install local packages in place.
+    session.install('mock', 'pytest')
+    session.install('-e', '../test_utils/')
+    session.install('-e', '.')
+    session.run(
+        'py.test',
+        '--quiet',
+        os.path.join('docs', 'snippets_list_assets.py'),
+        *session.posargs
+    )
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install('-e', '.')
+    session.install('sphinx', 'alabaster', 'recommonmark')
+
+    shutil.rmtree(os.path.join('docs', '_build'), ignore_errors=True)
+    session.run(
+        'sphinx-build',
+        '-W',  # warnings as errors
+        '-T',  # show full traceback on exception
+        '-N',  # no colors
+        '-b', 'html',
+        '-d', os.path.join('docs', '_build', 'doctrees', ''),
+        os.path.join('docs', ''),
+        os.path.join('docs', '_build', 'html', ''),
+    )
\ No newline at end of file
diff --git a/securitycenter/setup.cfg b/securitycenter/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/securitycenter/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/securitycenter/setup.py b/securitycenter/setup.py
new file mode 100644
index 000000000000..13909e6a6d16
--- /dev/null
+++ b/securitycenter/setup.py
@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = 'google-cloud-securitycenter'
+description = 'Cloud Security Command Center API API client library'
+version = '0.3.0'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    'google-api-core[grpc] >= 1.14.0, < 2.0.0dev',
+    'grpc-google-iam-v1 >= 0.12.3, < 0.13dev',
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')
+]
+
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/securitycenter/synth.metadata b/securitycenter/synth.metadata
new file mode 100644
index 000000000000..9530dd07871f
--- /dev/null
+++ b/securitycenter/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:37:26.268094Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "securitycenter",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/securitycenter/artman_securitycenter_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "securitycenter",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/securitycenter/artman_securitycenter_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/securitycenter/synth.py b/securitycenter/synth.py
new file mode 100644
index 000000000000..19fde3bc21af
--- /dev/null
+++ b/securitycenter/synth.py
@@ -0,0 +1,41 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1", "v1"]
+
+# ----------------------------------------------------------------------------
+# Generate securitycenter GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("securitycenter", version, include_protos=True)
+    s.move(library / f"google/cloud/securitycenter_{version}")
+    s.move(library / f"tests/unit/gapic/{version}")
+    s.move(library / f"docs/gapic/{version}")
+
+# Use the highest version library to generate import alias.
+s.move(library / "google/cloud/securitycenter.py")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files, excludes=['noxfile.py'])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/securitycenter/tests/unit/gapic/v1/test_security_center_client_v1.py b/securitycenter/tests/unit/gapic/v1/test_security_center_client_v1.py
new file mode 100644
index 000000000000..7f60e4faa720
--- /dev/null
+++ b/securitycenter/tests/unit/gapic/v1/test_security_center_client_v1.py
@@ -0,0 +1,931 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import securitycenter_v1
+from google.cloud.securitycenter_v1 import enums
+from google.cloud.securitycenter_v1.proto import finding_pb2
+from google.cloud.securitycenter_v1.proto import organization_settings_pb2
+from google.cloud.securitycenter_v1.proto import run_asset_discovery_response_pb2
+from google.cloud.securitycenter_v1.proto import security_marks_pb2
+from google.cloud.securitycenter_v1.proto import securitycenter_service_pb2
+from google.cloud.securitycenter_v1.proto import source_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestSecurityCenterClient(object):
+    def test_create_source(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = source_pb2.Source(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+        source = {}
+
+        response = client.create_source(parent, source)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.CreateSourceRequest(
+            parent=parent, source=source
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+        source = {}
+
+        with pytest.raises(CustomException):
+            client.create_source(parent, source)
+
+    def test_create_finding(self):
+        # Setup Expected Response
+        name = "name3373707"
+        parent_2 = "parent21175163357"
+        resource_name = "resourceName979421212"
+        category = "category50511102"
+        external_uri = "externalUri-1385596168"
+        expected_response = {
+            "name": name,
+            "parent": parent_2,
+            "resource_name": resource_name,
+            "category": category,
+            "external_uri": external_uri,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        finding_id = "findingId728776081"
+        finding = {}
+
+        response = client.create_finding(parent, finding_id, finding)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.CreateFindingRequest(
+            parent=parent, finding_id=finding_id, finding=finding
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_finding_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        finding_id = "findingId728776081"
+        finding = {}
+
+        with pytest.raises(CustomException):
+            client.create_finding(parent, finding_id, finding)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_get_organization_settings(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        enable_asset_discovery = False
+        expected_response = {
+            "name": name_2,
+            "enable_asset_discovery": enable_asset_discovery,
+        }
+        expected_response = organization_settings_pb2.OrganizationSettings(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        name = client.organization_settings_path("[ORGANIZATION]")
+
+        response = client.get_organization_settings(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GetOrganizationSettingsRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_organization_settings_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        name = client.organization_settings_path("[ORGANIZATION]")
+
+        with pytest.raises(CustomException):
+            client.get_organization_settings(name)
+
+    def test_get_source(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = source_pb2.Source(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        name = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        response = client.get_source(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GetSourceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        name = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        with pytest.raises(CustomException):
+            client.get_source(name)
+
+    def test_group_assets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        group_by_results_element = {}
+        group_by_results = [group_by_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "group_by_results": group_by_results,
+        }
+        expected_response = securitycenter_service_pb2.GroupAssetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_assets(parent, group_by)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.group_by_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GroupAssetsRequest(
+            parent=parent, group_by=group_by
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_group_assets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_assets(parent, group_by)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_group_findings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        group_by_results_element = {}
+        group_by_results = [group_by_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "group_by_results": group_by_results,
+        }
+        expected_response = securitycenter_service_pb2.GroupFindingsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_findings(parent, group_by)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.group_by_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GroupFindingsRequest(
+            parent=parent, group_by=group_by
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_group_findings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_findings(parent, group_by)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_assets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        list_assets_results_element = {}
+        list_assets_results = [list_assets_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "list_assets_results": list_assets_results,
+        }
+        expected_response = securitycenter_service_pb2.ListAssetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_assets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.list_assets_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.ListAssetsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_assets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_assets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_findings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        list_findings_results_element = {}
+        list_findings_results = [list_findings_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "list_findings_results": list_findings_results,
+        }
+        expected_response = securitycenter_service_pb2.ListFindingsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        paged_list_response = client.list_findings(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.list_findings_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.ListFindingsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_findings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        paged_list_response = client.list_findings(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_sources(self):
+        # Setup Expected Response
+        next_page_token = ""
+        sources_element = {}
+        sources = [sources_element]
+        expected_response = {"next_page_token": next_page_token, "sources": sources}
+        expected_response = securitycenter_service_pb2.ListSourcesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_sources(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.sources[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.ListSourcesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_sources_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_sources(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_run_asset_discovery(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = run_asset_discovery_response_pb2.RunAssetDiscoveryResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_run_asset_discovery", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.run_asset_discovery(parent)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.RunAssetDiscoveryRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_asset_discovery_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_run_asset_discovery_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.run_asset_discovery(parent)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_set_finding_state(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        parent = "parent-995424086"
+        resource_name = "resourceName979421212"
+        category = "category50511102"
+        external_uri = "externalUri-1385596168"
+        expected_response = {
+            "name": name_2,
+            "parent": parent,
+            "resource_name": resource_name,
+            "category": category,
+            "external_uri": external_uri,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        name = client.finding_path("[ORGANIZATION]", "[SOURCE]", "[FINDING]")
+        state = enums.Finding.State.STATE_UNSPECIFIED
+        start_time = {}
+
+        response = client.set_finding_state(name, state, start_time)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.SetFindingStateRequest(
+            name=name, state=state, start_time=start_time
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_finding_state_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        name = client.finding_path("[ORGANIZATION]", "[SOURCE]", "[FINDING]")
+        state = enums.Finding.State.STATE_UNSPECIFIED
+        start_time = {}
+
+        with pytest.raises(CustomException):
+            client.set_finding_state(name, state, start_time)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
+
+    def test_update_finding(self):
+        # Setup Expected Response
+        name = "name3373707"
+        parent = "parent-995424086"
+        resource_name = "resourceName979421212"
+        category = "category50511102"
+        external_uri = "externalUri-1385596168"
+        expected_response = {
+            "name": name,
+            "parent": parent,
+            "resource_name": resource_name,
+            "category": category,
+            "external_uri": external_uri,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        finding = {}
+
+        response = client.update_finding(finding)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateFindingRequest(
+            finding=finding
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_finding_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        finding = {}
+
+        with pytest.raises(CustomException):
+            client.update_finding(finding)
+
+    def test_update_organization_settings(self):
+        # Setup Expected Response
+        name = "name3373707"
+        enable_asset_discovery = False
+        expected_response = {
+            "name": name,
+            "enable_asset_discovery": enable_asset_discovery,
+        }
+        expected_response = organization_settings_pb2.OrganizationSettings(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        organization_settings = {}
+
+        response = client.update_organization_settings(organization_settings)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateOrganizationSettingsRequest(
+            organization_settings=organization_settings
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_organization_settings_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        organization_settings = {}
+
+        with pytest.raises(CustomException):
+            client.update_organization_settings(organization_settings)
+
+    def test_update_source(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = source_pb2.Source(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        source = {}
+
+        response = client.update_source(source)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateSourceRequest(source=source)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        source = {}
+
+        with pytest.raises(CustomException):
+            client.update_source(source)
+
+    def test_update_security_marks(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = security_marks_pb2.SecurityMarks(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup Request
+        security_marks = {}
+
+        response = client.update_security_marks(security_marks)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateSecurityMarksRequest(
+            security_marks=security_marks
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_security_marks_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1.SecurityCenterClient()
+
+        # Setup request
+        security_marks = {}
+
+        with pytest.raises(CustomException):
+            client.update_security_marks(security_marks)
diff --git a/securitycenter/tests/unit/gapic/v1beta1/test_security_center_client_v1beta1.py b/securitycenter/tests/unit/gapic/v1beta1/test_security_center_client_v1beta1.py
new file mode 100644
index 000000000000..4f9022fec300
--- /dev/null
+++ b/securitycenter/tests/unit/gapic/v1beta1/test_security_center_client_v1beta1.py
@@ -0,0 +1,925 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import securitycenter_v1beta1
+from google.cloud.securitycenter_v1beta1 import enums
+from google.cloud.securitycenter_v1beta1.proto import finding_pb2
+from google.cloud.securitycenter_v1beta1.proto import organization_settings_pb2
+from google.cloud.securitycenter_v1beta1.proto import security_marks_pb2
+from google.cloud.securitycenter_v1beta1.proto import securitycenter_service_pb2
+from google.cloud.securitycenter_v1beta1.proto import source_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestSecurityCenterClient(object):
+    def test_create_source(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = source_pb2.Source(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+        source = {}
+
+        response = client.create_source(parent, source)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.CreateSourceRequest(
+            parent=parent, source=source
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+        source = {}
+
+        with pytest.raises(CustomException):
+            client.create_source(parent, source)
+
+    def test_create_finding(self):
+        # Setup Expected Response
+        name = "name3373707"
+        parent_2 = "parent21175163357"
+        resource_name = "resourceName979421212"
+        category = "category50511102"
+        external_uri = "externalUri-1385596168"
+        expected_response = {
+            "name": name,
+            "parent": parent_2,
+            "resource_name": resource_name,
+            "category": category,
+            "external_uri": external_uri,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        finding_id = "findingId728776081"
+        finding = {}
+
+        response = client.create_finding(parent, finding_id, finding)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.CreateFindingRequest(
+            parent=parent, finding_id=finding_id, finding=finding
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_finding_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        finding_id = "findingId728776081"
+        finding = {}
+
+        with pytest.raises(CustomException):
+            client.create_finding(parent, finding_id, finding)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_get_organization_settings(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        enable_asset_discovery = False
+        expected_response = {
+            "name": name_2,
+            "enable_asset_discovery": enable_asset_discovery,
+        }
+        expected_response = organization_settings_pb2.OrganizationSettings(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        name = client.organization_settings_path("[ORGANIZATION]")
+
+        response = client.get_organization_settings(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GetOrganizationSettingsRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_organization_settings_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        name = client.organization_settings_path("[ORGANIZATION]")
+
+        with pytest.raises(CustomException):
+            client.get_organization_settings(name)
+
+    def test_get_source(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = source_pb2.Source(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        name = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        response = client.get_source(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GetSourceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        name = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        with pytest.raises(CustomException):
+            client.get_source(name)
+
+    def test_group_assets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        group_by_results_element = {}
+        group_by_results = [group_by_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "group_by_results": group_by_results,
+        }
+        expected_response = securitycenter_service_pb2.GroupAssetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_assets(parent, group_by)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.group_by_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GroupAssetsRequest(
+            parent=parent, group_by=group_by
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_group_assets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_assets(parent, group_by)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_group_findings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        group_by_results_element = {}
+        group_by_results = [group_by_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "group_by_results": group_by_results,
+        }
+        expected_response = securitycenter_service_pb2.GroupFindingsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_findings(parent, group_by)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.group_by_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.GroupFindingsRequest(
+            parent=parent, group_by=group_by
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_group_findings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        group_by = "groupBy506361367"
+
+        paged_list_response = client.group_findings(parent, group_by)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_assets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        list_assets_results_element = {}
+        list_assets_results = [list_assets_results_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "list_assets_results": list_assets_results,
+        }
+        expected_response = securitycenter_service_pb2.ListAssetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_assets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.list_assets_results[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.ListAssetsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_assets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_assets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_findings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        total_size = 705419236
+        findings_element = {}
+        findings = [findings_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "total_size": total_size,
+            "findings": findings,
+        }
+        expected_response = securitycenter_service_pb2.ListFindingsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        paged_list_response = client.list_findings(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.findings[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.ListFindingsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_findings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.source_path("[ORGANIZATION]", "[SOURCE]")
+
+        paged_list_response = client.list_findings(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_sources(self):
+        # Setup Expected Response
+        next_page_token = ""
+        sources_element = {}
+        sources = [sources_element]
+        expected_response = {"next_page_token": next_page_token, "sources": sources}
+        expected_response = securitycenter_service_pb2.ListSourcesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_sources(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.sources[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.ListSourcesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_sources_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        paged_list_response = client.list_sources(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_run_asset_discovery(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_run_asset_discovery", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.run_asset_discovery(parent)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.RunAssetDiscoveryRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_asset_discovery_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_run_asset_discovery_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        parent = client.organization_path("[ORGANIZATION]")
+
+        response = client.run_asset_discovery(parent)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_set_finding_state(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        parent = "parent-995424086"
+        resource_name = "resourceName979421212"
+        category = "category50511102"
+        external_uri = "externalUri-1385596168"
+        expected_response = {
+            "name": name_2,
+            "parent": parent,
+            "resource_name": resource_name,
+            "category": category,
+            "external_uri": external_uri,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        name = client.finding_path("[ORGANIZATION]", "[SOURCE]", "[FINDING]")
+        state = enums.Finding.State.STATE_UNSPECIFIED
+        start_time = {}
+
+        response = client.set_finding_state(name, state, start_time)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.SetFindingStateRequest(
+            name=name, state=state, start_time=start_time
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_finding_state_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        name = client.finding_path("[ORGANIZATION]", "[SOURCE]", "[FINDING]")
+        state = enums.Finding.State.STATE_UNSPECIFIED
+        start_time = {}
+
+        with pytest.raises(CustomException):
+            client.set_finding_state(name, state, start_time)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        resource = client.source_path("[ORGANIZATION]", "[SOURCE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
+
+    def test_update_finding(self):
+        # Setup Expected Response
+        name = "name3373707"
+        parent = "parent-995424086"
+        resource_name = "resourceName979421212"
+        category = "category50511102"
+        external_uri = "externalUri-1385596168"
+        expected_response = {
+            "name": name,
+            "parent": parent,
+            "resource_name": resource_name,
+            "category": category,
+            "external_uri": external_uri,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        finding = {}
+
+        response = client.update_finding(finding)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateFindingRequest(
+            finding=finding
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_finding_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        finding = {}
+
+        with pytest.raises(CustomException):
+            client.update_finding(finding)
+
+    def test_update_organization_settings(self):
+        # Setup Expected Response
+        name = "name3373707"
+        enable_asset_discovery = False
+        expected_response = {
+            "name": name,
+            "enable_asset_discovery": enable_asset_discovery,
+        }
+        expected_response = organization_settings_pb2.OrganizationSettings(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        organization_settings = {}
+
+        response = client.update_organization_settings(organization_settings)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateOrganizationSettingsRequest(
+            organization_settings=organization_settings
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_organization_settings_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        organization_settings = {}
+
+        with pytest.raises(CustomException):
+            client.update_organization_settings(organization_settings)
+
+    def test_update_source(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+        }
+        expected_response = source_pb2.Source(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        source = {}
+
+        response = client.update_source(source)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateSourceRequest(source=source)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_source_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        source = {}
+
+        with pytest.raises(CustomException):
+            client.update_source(source)
+
+    def test_update_security_marks(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = security_marks_pb2.SecurityMarks(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup Request
+        security_marks = {}
+
+        response = client.update_security_marks(security_marks)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = securitycenter_service_pb2.UpdateSecurityMarksRequest(
+            security_marks=security_marks
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_security_marks_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = securitycenter_v1beta1.SecurityCenterClient()
+
+        # Setup request
+        security_marks = {}
+
+        with pytest.raises(CustomException):
+            client.update_security_marks(security_marks)
diff --git a/setup.py b/setup.py
deleted file mode 100644
index f1e9a2eac826..000000000000
--- a/setup.py
+++ /dev/null
@@ -1,66 +0,0 @@
-import os
-import sys
-
-from setuptools import setup
-from setuptools import find_packages
-
-
-PROJECT_ROOT = os.path.abspath(os.path.dirname(__file__))
-
-with open(os.path.join(PROJECT_ROOT, 'README.rst')) as file_obj:
-    README = file_obj.read()
-
-
-REQUIREMENTS = [
-    'httplib2 >= 0.9.1',
-    'googleapis-common-protos',
-    'oauth2client >= 2.0.1',
-    'protobuf >= 3.0.0',
-    'six',
-]
-
-GRPC_PACKAGES = [
-    'grpcio >= 1.0.0',
-    'google-gax >= 0.13.0, < 0.14dev',
-    'gapic-google-pubsub-v1 >= 0.9.0, < 0.10dev',
-    'grpc-google-pubsub-v1 >= 0.9.0, < 0.10dev',
-    'gapic-google-logging-v2 >= 0.9.0, < 0.10dev',
-    'grpc-google-logging-v2 >= 0.9.0, < 0.10dev',
-]
-
-RTD_ENV_VAR = 'READTHEDOCS'
-if RTD_ENV_VAR not in os.environ:
-    REQUIREMENTS.extend(GRPC_PACKAGES)
-
-setup(
-    name='google-cloud',
-    version='0.19.0',
-    description='API Client library for Google Cloud',
-    author='Google Cloud Platform',
-    author_email='jjg+google-cloud-python@google.com',
-    long_description=README,
-    scripts=[],
-    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
-    namespace_packages=[
-        'google',
-        'google.cloud',
-    ],
-    packages=find_packages(),
-    license='Apache 2.0',
-    platforms='Posix; MacOS X; Windows',
-    include_package_data=True,
-    zip_safe=False,
-    install_requires=REQUIREMENTS,
-    classifiers=[
-        'Development Status :: 4 - Beta',
-        'Intended Audience :: Developers',
-        'License :: OSI Approved :: Apache Software License',
-        'Operating System :: OS Independent',
-        'Programming Language :: Python :: 2',
-        'Programming Language :: Python :: 2.7',
-        'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.4',
-        'Programming Language :: Python :: 3.5',
-        'Topic :: Internet',
-    ]
-)
diff --git a/spanner/.coveragerc b/spanner/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/spanner/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/spanner/.flake8 b/spanner/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/spanner/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/spanner/.repo-metadata.json b/spanner/.repo-metadata.json
new file mode 100644
index 000000000000..05efd37f1dbd
--- /dev/null
+++ b/spanner/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "spanner",
+  "name_pretty": "Cloud Spanner",
+  "product_documentation": "https://cloud.google.com/spanner/docs/",
+  "client_documentation": "https://googleapis.dev/python/spanner/latest",
+  "issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-spanner",
+  "api_id": "spanner.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/spanner/CHANGELOG.md b/spanner/CHANGELOG.md
new file mode 100644
index 000000000000..d217c95b3be7
--- /dev/null
+++ b/spanner/CHANGELOG.md
@@ -0,0 +1,291 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-spanner/#history
+
+## 1.10.0
+
+07-24-2019 17:32 PDT
+
+
+### Implementation Changes
+- Add backoff for `run_in_transaction' when backend does not provide 'RetryInfo' in response. ([#8461](https://github.com/googleapis/google-cloud-python/pull/8461))
+- Adjust gRPC timeouts (via synth). ([#8445](https://github.com/googleapis/google-cloud-python/pull/8445))
+- Allow kwargs to be passed to create_channel (via synth). ([#8403](https://github.com/googleapis/google-cloud-python/pull/8403))
+
+### New Features
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8659](https://github.com/googleapis/google-cloud-python/pull/8659))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8522](https://github.com/googleapis/google-cloud-python/pull/8522))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Fixes [#8545](https://github.com/googleapis/google-cloud-python/pull/8545) by removing typing information for kwargs to not conflict with type checkers ([#8546](https://github.com/googleapis/google-cloud-python/pull/8546))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8363](https://github.com/googleapis/google-cloud-python/pull/8363))
+- Add disclaimer to auto-generated template files (via synth). ([#8327](https://github.com/googleapis/google-cloud-python/pull/8327))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8251](https://github.com/googleapis/google-cloud-python/pull/8251))
+- Blacken noxfile.py, setup.py (via synth). ([#8131](https://github.com/googleapis/google-cloud-python/pull/8131))
+- Harden synth replacement against template adding whitespace. ([#8103](https://github.com/googleapis/google-cloud-python/pull/8103))
+
+## 1.9.0
+
+05-16-2019 12:54 PDT
+
+
+### Implementation Changes
+- Add routing header to method metadata (via synth). ([#7750](https://github.com/googleapis/google-cloud-python/pull/7750))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to client. ([#7878](https://github.com/googleapis/google-cloud-python/pull/7878))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Expand API reference for snapshot / transaction. ([#7618](https://github.com/googleapis/google-cloud-python/pull/7618))
+
+### Internal / Testing Changes
+- Add nox session `docs`, remove retries for DEADLINE_EXCEEDED (via synth). ([#7781](https://github.com/googleapis/google-cloud-python/pull/7781))
+- Added matching END tags to Spanner Tests ([#7529](https://github.com/googleapis/google-cloud-python/pull/7529))
+
+## 1.8.0
+
+03-05-2019 12:57 PST
+
+
+### Implementation Changes
+- Protoc-generated serialization update. ([#7095](https://github.com/googleapis/google-cloud-python/pull/7095))
+- Fix typo in exported param type name. ([#7295](https://github.com/googleapis/google-cloud-python/pull/7295))
+
+### New Features
+- Add Batch DML support. ([#7485](https://github.com/googleapis/google-cloud-python/pull/7485))
+
+### Documentation
+- Copy lintified proto files, update docstrings (via synth). ([#7453](https://github.com/googleapis/google-cloud-python/pull/7453))
+- Fix Batch object creation instructions. ([#7341](https://github.com/googleapis/google-cloud-python/pull/7341))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Fix README to install spanner instead of datastore. ([#7301](https://github.com/googleapis/google-cloud-python/pull/7301))
+
+### Internal / Testing Changes
+- Add clarifying comment to blacken nox target. ([#7403](https://github.com/googleapis/google-cloud-python/pull/7403))
+- Ensure that GRPC config file is included in MANIFEST.in after templating. ([#7046](https://github.com/googleapis/google-cloud-python/pull/7046))
+- Add protos as an artifact to library. ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers.
+
+## 1.7.1
+
+12-14-2018 15:18 PST
+
+
+### Documentation
+- Announce Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize documentation for 'page_size' / 'max_results' / 'page_token' ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+### Internal / Testing Changes
+- Include grpc config in manifest ([#6928](https://github.com/googleapis/google-cloud-python/pull/6928))
+
+## 1.7.0
+
+12-10-2018 13:10 PST
+
+
+### Implementation Changes
+- Add PingingPool and TransactionPingingPool to toplevel module ([#6886](https://github.com/googleapis/google-cloud-python/pull/6886))
+- Add `operation_id` parameter to `Database.update_ddl`. ([#6825](https://github.com/googleapis/google-cloud-python/pull/6825))
+- Pick up changes to GAPIC method configuration ([#6615](https://github.com/googleapis/google-cloud-python/pull/6615))
+- Add timeout + retry settings to Sessions/Snapshots ([#6536](https://github.com/googleapis/google-cloud-python/pull/6536))
+- Pick up fixes to GAPIC generator. ([#6576](https://github.com/googleapis/google-cloud-python/pull/6576))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Blacken. ([#6846](https://github.com/googleapis/google-cloud-python/pull/6846))
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add tags to DML system tests ([#6580](https://github.com/googleapis/google-cloud-python/pull/6580))
+
+## 1.6.1
+
+11-09-2018 14:49 PST
+
+### Implementation Changes
+- Fix client_info bug, update docstrings. ([#6420](https://github.com/googleapis/google-cloud-python/pull/6420))
+
+### Documentation
+- Update README service links in quickstart guides. ([#6322](https://github.com/googleapis/google-cloud-python/pull/6322))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Fix typo in spanner usage documentation ([#6209](https://github.com/googleapis/google-cloud-python/pull/6209))
+
+### Internal / Testing Changes
+- Rationalize 'all_types' round-trip systest ([#6379](https://github.com/googleapis/google-cloud-python/pull/6379))
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Add systest for returning empty array struct ([#4449](https://github.com/googleapis/google-cloud-python/pull/4449))
+- Add systests not needing tables ([#6308](https://github.com/googleapis/google-cloud-python/pull/6308))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 1.6.0
+
+10-08-2018 08:25 PDT
+
+### New Features
+- Add support for DML/PDML. ([#6151](https://github.com/googleapis/google-cloud-python/pull/6151))
+
+### Implementation Changes
+- Add 'synth.py' and regen GAPIC code. ([#6040](https://github.com/googleapis/google-cloud-python/pull/6040))
+
+### Documentation
+- Remove invalid examples of `database.transaction()`. ([#6032](https://github.com/googleapis/google-cloud-python/pull/6032))
+- Redirect renamed `usage.html`/`client.html` -> `index.html`. ([#5996](https://github.com/googleapis/google-cloud-python/pull/5996))
+- Fix leakage of sections into sidebar menu. ([#5986](https://github.com/googleapis/google-cloud-python/pull/5986))
+- Prepare documentation for repo split. ([#5938](https://github.com/googleapis/google-cloud-python/pull/5938))
+
+### Internal / Testing Changes
+- Remove extra `grpc_gcp` system tests. ([#6049](https://github.com/googleapis/google-cloud-python/pull/6049))
+
+## 1.5.0
+
+### New Features
+
+- Add support for session / pool labels ([#5734](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5734))
+- Add support for gRPC connection management ([#5553](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5553))
+
+### Dependencies
+
+- Add `grpcio-gcp` dependency for Cloud Spanner ([#5904](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5904))
+
+### Internal / Testing Changes
+
+- Don't hardcode endpoint URL in grpc_gcp unit tests. ([#5893](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5893))
+- Run `grpc_gcp` unit tests only with Python 2.7 / 3.6. ([#5871](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5871))
+- Nox: use inplace installs ([#5865](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5865))
+- Benchmarks: print() is a function in Python 3 ([#5862](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5862))
+- Retry `test_transaction_read_and_insert_then_rollback` when aborted. ([#5737](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5737))
+- Skip the flaky `test_update_database_ddl` systest. ([#5704](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5704))
+
+## 1.4.0
+
+### Implementation Changes
+- Ensure that initial resume token is bytes, not text. (#5450)
+- Prevent process_read_batch from mutating params (#5416)
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+
+### New Features
+- Add support for Python 3.7 (#5288)
+- Add support for Spanner struct params. (#5463)
+
+### Internal / Testing Changes
+- Modify system tests to use prerelease versions of grpcio (#5304)
+
+## 1.3.0
+
+### Interface additions
+
+- Added `spanner_v1.COMMIT_TIMESTAMP`. (#5102)
+
+## 1.2.0
+
+### New features
+
+- Added batch query support (#4938)
+
+### Implementation changes
+
+- Removed custom timestamp class in favor of the one in google-api-core. (#4980)
+
+### Dependencies
+
+- Update minimum version for google-api-core to 1.1.0 (#5030)
+
+### Documentation
+
+- Update package metadata release status to 'Stable' (#5031)
+
+## 1.1.0
+
+### Dependencies
+
+- The minimum version for `google-api-core` has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)
+
+### Testing and internal changes
+
+- Fix load_keys() in YCSB-like benchmark for cloud spanner. (#4919)
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Fix system test util to populate streaming (#4888)
+- Retry conflict errors in system test (#4850)
+
+## 1.0.0
+
+### Breaking Changes
+
+- `to_pb` has now been made private (`_to_pb`) in `KeySet`
+  and `KeyRange` (#4740)
+
+### Documentation Changes
+- Database update_ddl missing param in documentation (#4749)
+
+## 0.30.0
+
+### Breaking Changes
+
+- The underlying autogenerated client library was re-generated to pick up new 
+  features and resolve bugs, this may change the exceptions raised from various
+  methods. (#4695)
+- Made `StreamedResultSet`'s `row`, `consume_all`, and `consume_next` members
+  private (#4492)
+
+### Implementation Changes
+
+- `Keyset` can now infer defaults to `start_closed` or `end_closed` when only one argument is specified. (#4735)
+
+### Documentation
+
+- Brought Spanner README more in line with others. (#4306, #4317)
+
+### Testing
+
+- Added several new system tests and fixed minor issues with existing tests. (
+  #4631, #4569, #4573, #4572, #4416, #4411, #4407, #4386, #4419, #4489,
+  #4678, #4620, #4418, #4403, #4397, #4383, #4371, #4372, #4374, #4370, #4285,
+  #4321)
+- Excluded generated code from linting. (#4375)
+- Added a `nox -s default` session for all packages. (#4324)
+
+## 0.29.0
+
+### Implementation Changes
+
+- **Bugfix**: Clear `session._transaction` before calling
+  `_delay_until_retry` (#4185)
+- **Bugfix**: Be permissive about merging an empty list. (#4170,
+  fixes #4164)
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+PyPI: https://pypi.org/project/google-cloud-spanner/0.29.0/
diff --git a/spanner/LICENSE b/spanner/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/spanner/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/spanner/MANIFEST.in b/spanner/MANIFEST.in
new file mode 100644
index 000000000000..d2edac373469
--- /dev/null
+++ b/spanner/MANIFEST.in
@@ -0,0 +1,6 @@
+include README.rst LICENSE
+include google/cloud/spanner_v1/gapic/transports/spanner.grpc.config
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/spanner/README.rst b/spanner/README.rst
new file mode 100644
index 000000000000..d18dbcfbc628
--- /dev/null
+++ b/spanner/README.rst
@@ -0,0 +1,242 @@
+Python Client for Cloud Spanner
+===============================
+
+|GA| |pypi| |versions| 
+
+`Cloud Spanner`_ is the world's first fully managed relational database service
+to offer both strong consistency and horizontal scalability for
+mission-critical online transaction processing (OLTP) applications. With Cloud
+Spanner you enjoy all the traditional benefits of a relational database; but
+unlike any other relational database service, Cloud Spanner scales horizontally
+to hundreds or thousands of servers to handle the biggest transactional
+workloads.
+
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-spanner.svg
+   :target: https://pypi.org/project/google-cloud-spanner/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-spanner.svg
+   :target: https://pypi.org/project/google-cloud-spanner/
+.. _Cloud Spanner: https://cloud.google.com/spanner/
+.. _Client Library Documentation: https://googleapis.dev/python/spanner/latest
+.. _Product Documentation:  https://cloud.google.com/spanner/docs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Spanner API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Spanner API.:  https://cloud.google.com/spanner
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-spanner
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-spanner
+
+
+Example Usage
+-------------
+
+
+Executing Arbitrary SQL in a Transaction
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Generally, to work with Cloud Spanner, you will want a transaction. The
+preferred mechanism for this is to create a single function, which executes
+as a callback to ``database.run_in_transaction``:
+
+.. code:: python
+
+    # First, define the function that represents a single "unit of work"
+    # that should be run within the transaction.
+    def update_anniversary(transaction, person_id, unix_timestamp):
+        # The query itself is just a string.
+        #
+        # The use of @parameters is recommended rather than doing your
+        # own string interpolation; this provides protections against
+        # SQL injection attacks.
+        query = """SELECT anniversary FROM people
+            WHERE id = @person_id"""
+
+        # When executing the SQL statement, the query and parameters are sent
+        # as separate arguments. When using parameters, you must specify
+        # both the parameters themselves and their types.
+        row = transaction.execute_sql(
+            query=query,
+            params={'person_id': person_id},
+            param_types={
+                'person_id': types.INT64_PARAM_TYPE,
+            },
+        ).one()
+
+        # Now perform an update on the data.
+        old_anniversary = row[0]
+        new_anniversary = _compute_anniversary(old_anniversary, years)
+        transaction.update(
+            'people',
+            ['person_id', 'anniversary'],
+            [person_id, new_anniversary],
+        )
+
+    # Actually run the `update_anniversary` function in a transaction.
+    database.run_in_transaction(update_anniversary,
+        person_id=42,
+        unix_timestamp=1335020400,
+    )
+
+
+Select records using a Transaction
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Once you have a transaction object (such as the first argument sent to
+``run_in_transaction``), reading data is easy:
+
+.. code:: python
+
+    # Define a SELECT query.
+    query = """SELECT e.first_name, e.last_name, p.telephone
+        FROM employees as e, phones as p
+        WHERE p.employee_id == e.employee_id"""
+
+    # Execute the query and return results.
+    result = transaction.execute_sql(query)
+    for row in result.rows:
+        print(row)
+
+
+Insert records using Data Manipulation Language (DML) with a Transaction
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use the ``execute_update()`` method to execute a DML statement:
+
+.. code:: python
+
+    spanner_client = spanner.Client()
+    instance = spanner_client.instance(instance_id)
+    database = instance.database(database_id)
+
+    def insert_singers(transaction):
+        row_ct = transaction.execute_update(
+            "INSERT Singers (SingerId, FirstName, LastName) "
+            " VALUES (10, 'Virginia', 'Watson')"
+        )
+
+        print("{} record(s) inserted.".format(row_ct))
+
+    database.run_in_transaction(insert_singers)
+
+
+Insert records using Mutations with a Transaction
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To add one or more records to a table, use ``insert``:
+
+.. code:: python
+
+    transaction.insert(
+        'citizens',
+        columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+            ['bharney@example.com', 'Bharney', 'Rhubble', 31],
+        ],
+    )
+
+
+Update records using Data Manipulation Language (DML) with a Transaction
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code:: python
+
+    spanner_client = spanner.Client()
+    instance = spanner_client.instance(instance_id)
+    database = instance.database(database_id)
+
+    def update_albums(transaction):
+        row_ct = transaction.execute_update(
+            "UPDATE Albums "
+            "SET MarketingBudget = MarketingBudget * 2 "
+            "WHERE SingerId = 1 and AlbumId = 1"
+        )
+
+        print("{} record(s) updated.".format(row_ct))
+
+    database.run_in_transaction(update_albums)
+
+
+Update records using Mutations with a Transaction
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``Transaction.update`` updates one or more existing records in a table.  Fails
+if any of the records does not already exist.
+
+.. code:: python
+
+    transaction.update(
+        'citizens',
+        columns=['email', 'age'],
+        values=[
+            ['phred@exammple.com', 33],
+            ['bharney@example.com', 32],
+        ],
+    )
+
+
+Next Steps
+~~~~~~~~~~
+
+- See the `Client Library Documentation`_ to learn how to connect to Cloud
+  Spanner using this Client Library.
+- Read the `Product documentation`_ to learn
+  more about the product and see How-to Guides.
diff --git a/spanner/benchmark/bin/ycsb b/spanner/benchmark/bin/ycsb
new file mode 100644
index 000000000000..bb98c8c174ae
--- /dev/null
+++ b/spanner/benchmark/bin/ycsb
@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+# A YCSB-like executable that can be integrated into PerfKitBenchmarker.
+
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+python ${DIR}/../ycsb.py "${@:1}"
diff --git a/spanner/benchmark/ycsb.py b/spanner/benchmark/ycsb.py
new file mode 100644
index 000000000000..bad4e0fe9271
--- /dev/null
+++ b/spanner/benchmark/ycsb.py
@@ -0,0 +1,266 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+
+"""The YCSB client in Python.
+
+Usage:
+
+  # Set up instance and load data into database.
+
+  # Set up environment variables. You should use your own credentials and gcloud
+  # project.
+  $ export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
+  $ export GCLOUD_PROJECT=gcloud-project-name
+
+  # Run the benchmark.
+  $ python spanner/benchmark/ycsb.py run cloud_spanner -P pkb/workloada \
+    -p table=usertable -p cloudspanner.instance=ycsb-542756a4 \
+    -p recordcount=5000 -p operationcount=100 -p cloudspanner.database=ycsb \
+    -p num_worker=1
+
+  # To make a package so it can work with PerfKitBenchmarker.
+  $ cd spanner; tar -cvzf ycsb-python.0.0.5.tar.gz benchmark/*
+
+"""
+
+from google.cloud import spanner
+
+import argparse
+import numpy
+import random
+import string
+import threading
+import timeit
+
+
+OPERATIONS = ['readproportion', 'updateproportion', 'scanproportion',
+              'insertproportion']
+NUM_FIELD = 10
+
+
+def parse_options():
+    """Parses options."""
+    parser = argparse.ArgumentParser()
+    parser.add_argument('command', help='The YCSB command.')
+    parser.add_argument('benchmark', help='The YCSB benchmark.')
+    parser.add_argument('-P', '--workload', action='store', dest='workload',
+                        default='', help='The path to a YCSB workload file.')
+    parser.add_argument('-p', '--parameter', action='append', dest='parameters',
+                        default=[], help='The key=value pair of parameter.')
+    parser.add_argument('-b', '--num_bucket', action='store', type=int,
+                        dest='num_bucket', default=1000,
+                        help='The number of buckets in output.')
+
+    args = parser.parse_args()
+
+    parameters = {}
+    parameters['command'] = args.command
+    parameters['num_bucket'] = args.num_bucket
+
+    for parameter in args.parameters:
+        parts = parameter.strip().split('=')
+        parameters[parts[0]] = parts[1]
+
+    with open(args.workload, 'r') as f:
+        for line in f.readlines():
+            parts = line.split('=')
+            key = parts[0].strip()
+            if key in OPERATIONS:
+                parameters[key] = parts[1].strip()
+
+    return parameters
+
+
+def open_database(parameters):
+    """Opens a database specified by the parameters from parse_options()."""
+    spanner_client = spanner.Client()
+    instance_id = parameters['cloudspanner.instance']
+    instance = spanner_client.instance(instance_id)
+    database_id = parameters['cloudspanner.database']
+    pool = spanner.BurstyPool(int(parameters['num_worker']))
+    database = instance.database(database_id, pool=pool)
+
+    return database
+
+
+def load_keys(database, parameters):
+    """Loads keys from database."""
+    keys = []
+    with database.snapshot() as snapshot:
+        results = snapshot.execute_sql(
+            'SELECT u.id FROM %s u' % parameters['table'])
+
+    for row in results:
+        keys.append(row[0])
+
+    return keys
+
+
+def read(database, table, key):
+    """Does a single read operation."""
+    with database.snapshot() as snapshot:
+        result = snapshot.execute_sql('SELECT u.* FROM %s u WHERE u.id="%s"' %
+                                      (table, key))
+        for row in result:
+            key = row[0]
+        for i in range(NUM_FIELD):
+            field = row[i + 1]
+
+
+def update(database, table, key):
+    """Does a single update operation."""
+    field = random.randrange(10)
+    value = ''.join(random.choice(string.printable) for i in range(100))
+    with database.batch() as batch:
+        batch.update(table=table, columns=('id', 'field%d' % field),
+                     values=[(key, value)])
+
+
+def do_operation(database, keys, table, operation, latencies_ms):
+    """Does a single operation and records latency."""
+    key = random.choice(keys)
+    start = timeit.default_timer()
+    if operation == 'read':
+        read(database, table, key)
+    elif operation == 'update':
+        update(database, table,  key)
+    else:
+        raise ValueError('Unknown operation: %s' % operation)
+    end = timeit.default_timer()
+    latencies_ms[operation].append((end - start) * 1000)
+
+
+def aggregate_metrics(latencies_ms, duration_ms, num_bucket):
+    """Aggregates metrics."""
+    overall_op_count = 0
+    op_counts = {operation : len(latency) for operation,
+                 latency in latencies_ms.iteritems()}
+    overall_op_count = sum([op_count for op_count in op_counts.itervalues()])
+
+    print('[OVERALL], RunTime(ms), %f' % duration_ms)
+    print('[OVERALL], Throughput(ops/sec), %f' % (float(overall_op_count) /
+                                                duration_ms * 1000.0))
+
+    for operation in op_counts.keys():
+        operation_upper = operation.upper()
+        print('[%s], Operations, %d' % (operation_upper, op_counts[operation]))
+        print('[%s], AverageLatency(us), %f' % (
+            operation_upper, numpy.average(latencies_ms[operation]) * 1000.0))
+        print('[%s], LatencyVariance(us), %f' % (
+            operation_upper, numpy.var(latencies_ms[operation]) * 1000.0))
+        print('[%s], MinLatency(us), %f' % (
+            operation_upper, min(latencies_ms[operation]) * 1000.0))
+        print('[%s], MaxLatency(us), %f' % (
+            operation_upper, max(latencies_ms[operation]) * 1000.0))
+        print('[%s], 95thPercentileLatency(us), %f' % (
+            operation_upper,
+            numpy.percentile(latencies_ms[operation], 95.0) * 1000.0))
+        print('[%s], 99thPercentileLatency(us), %f' % (
+            operation_upper,
+            numpy.percentile(latencies_ms[operation], 99.0) * 1000.0))
+        print('[%s], 99.9thPercentileLatency(us), %f' % (
+            operation_upper,
+            numpy.percentile(latencies_ms[operation], 99.9) * 1000.0))
+        print('[%s], Return=OK, %d' % (operation_upper, op_counts[operation]))
+        latency_array = numpy.array(latencies_ms[operation])
+        for j in range(num_bucket):
+            print('[%s], %d, %d' % (
+                operation_upper, j,
+                ((j <= latency_array) & (latency_array < (j + 1))).sum()))
+        print('[%s], >%d, %d' % (operation_upper, num_bucket,
+                                 (num_bucket <= latency_array).sum()))
+
+
+class WorkloadThread(threading.Thread):
+    """A single thread running workload."""
+
+    def __init__(self, database, keys, parameters, total_weight, weights,
+                 operations):
+        threading.Thread.__init__(self)
+        self._database = database
+        self._keys = keys
+        self._parameters = parameters
+        self._total_weight = total_weight
+        self._weights = weights
+        self._operations = operations
+        self._latencies_ms = {}
+        for operation in self._operations:
+            self._latencies_ms[operation] = []
+
+    def run(self):
+        """Run a single thread of the workload."""
+        i = 0
+        operation_count = int(self._parameters['operationcount'])
+        while i < operation_count:
+            i += 1
+            weight = random.uniform(0, self._total_weight)
+            for j in range(len(self._weights)):
+                if weight <= self._weights[j]:
+                    do_operation(self._database, self._keys,
+                                 self._parameters['table'],
+                                 self._operations[j], self._latencies_ms)
+                    break
+
+    def latencies_ms(self):
+        """Returns the latencies."""
+        return self._latencies_ms
+
+
+def run_workload(database, keys, parameters):
+    """Runs workload against the database."""
+    total_weight = 0.0
+    weights = []
+    operations = []
+    latencies_ms = {}
+    for operation in OPERATIONS:
+        weight = float(parameters[operation])
+        if weight <= 0.0:
+            continue
+        total_weight += weight
+        op_code = operation.split('proportion')[0]
+        operations.append(op_code)
+        weights.append(total_weight)
+        latencies_ms[op_code] = []
+
+    threads = []
+    start = timeit.default_timer()
+    for i in range(int(parameters['num_worker'])):
+        thread = WorkloadThread(database, keys, parameters, total_weight,
+                                weights, operations)
+        thread.start()
+        threads.append(thread)
+
+    for thread in threads:
+        thread.join()
+        end = timeit.default_timer()
+
+    for thread in threads:
+        thread_latencies_ms = thread.latencies_ms()
+        for key in latencies_ms.keys():
+            latencies_ms[key].extend(thread_latencies_ms[key])
+
+    aggregate_metrics(latencies_ms, (end - start) * 1000.0,
+                      parameters['num_bucket'])
+
+
+if __name__ == '__main__':
+    parameters = parse_options()
+    if parameters['command'] == 'run':
+        if 'cloudspanner.channels' in parameters:
+            assert parameters['cloudspanner.channels'] == 1, (
+                'Python doesn\'t support channels > 1.')
+        database = open_database(parameters)
+        keys = load_keys(database, parameters)
+        run_workload(database, keys, parameters)
+    else:
+        raise ValueError('Unknown command %s.' % parameters['command'])
diff --git a/spanner/docs/README.rst b/spanner/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/spanner/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/spanner/docs/advanced-session-pool-topics.rst b/spanner/docs/advanced-session-pool-topics.rst
new file mode 100644
index 000000000000..b8b4e8c9253a
--- /dev/null
+++ b/spanner/docs/advanced-session-pool-topics.rst
@@ -0,0 +1,98 @@
+Advanced Session Pool Topics
+============================
+
+Custom Session Pool Implementations
+-----------------------------------
+
+You can supply your own pool implementation, which must satisfy the
+contract laid out in
+:class:`~google.cloud.spanner.pool.AbstractSessionPool`:
+
+.. code-block:: python
+
+   from google.cloud.spanner.pool import AbstractSessionPool
+
+   class MyCustomPool(AbstractSessionPool):
+
+        def __init__(self, custom_param):
+            super(MyCustomPool, self).__init__()
+            self.custom_param = custom_param
+
+        def bind(self, database):
+            ...
+
+        def get(self, read_only=False):
+            ...
+
+        def put(self, session, discard_if_full=True):
+            ...
+
+   pool = MyCustomPool(custom_param=42)
+   database = instance.database(DATABASE_NAME, pool=pool)
+
+Lowering latency for read / query operations
+--------------------------------------------
+
+Some applications may need to minimize latency for read operations, including
+particularly the overhead of making an API request to create or refresh a
+session.  :class:`~google.cloud.spanner.pool.PingingPool` is designed for such
+applications, which need to configure a background thread to do the work of
+keeping the sessions fresh.
+
+Create an instance of :class:`~google.cloud.spanner.pool.PingingPool`:
+
+.. code-block:: python
+
+   from google.cloud.spanner import Client
+   from google.cloud.spanner.pool import PingingPool
+
+   client = Client()
+   instance = client.instance(INSTANCE_NAME)
+   pool = PingingPool(size=10, default_timeout=5, ping_interval=300)
+   database = instance.database(DATABASE_NAME, pool=pool)
+
+Set up a background thread to ping the pool's session, keeping them
+from becoming stale:
+
+.. code-block:: python
+
+   import threading
+
+   background = threading.Thread(target=pool.ping, name='ping-pool')
+   background.daemon = True
+   background.start()
+
+Lowering latency for mixed read-write operations
+------------------------------------------------
+
+Some applications may need to minimize latency for read write operations,
+including particularly the overhead of making an API request to create or
+refresh a session or to begin a session's transaction.
+:class:`~google.cloud.spanner.pool.TransactionPingingPool` is designed for
+such applications, which need to configure a background thread to do the work
+of keeping the sessions fresh and starting their transactions after use.
+
+Create an instance of
+:class:`~google.cloud.spanner.pool.TransactionPingingPool`:
+
+.. code-block:: python
+
+   from google.cloud.spanner import Client
+   from google.cloud.spanner.pool import TransactionPingingPool
+
+   client = Client()
+   instance = client.instance(INSTANCE_NAME)
+   pool = TransactionPingingPool(size=10, default_timeout=5, ping_interval=300)
+   database = instance.database(DATABASE_NAME, pool=pool)
+
+Set up a background thread to ping the pool's session, keeping them
+from becoming stale, and ensuring that each session has a new transaction
+started before it is used:
+
+.. code-block:: python
+
+   import threading
+
+   background = threading.Thread(target=pool.ping, name='ping-pool')
+   background.daemon = True
+   background.start()
diff --git a/spanner/docs/api-reference.rst b/spanner/docs/api-reference.rst
new file mode 100644
index 000000000000..c767b23afac0
--- /dev/null
+++ b/spanner/docs/api-reference.rst
@@ -0,0 +1,33 @@
+API Reference
+=============
+
+The following classes and methods constitute the Spanner client.
+Most likely, you will be interacting almost exclusively with these:
+
+.. toctree::
+    :maxdepth: 1
+
+    client-api
+    instance-api
+    database-api
+    session-api
+    keyset-api
+    snapshot-api
+    batch-api
+    transaction-api
+    streamed-api
+
+
+The classes and methods above depend on the following, lower-level
+classes and methods. Documentation for these is provided for completion,
+and some advanced use cases may wish to interact with these directly:
+
+.. toctree::
+    :maxdepth: 1
+
+    gapic/v1/api
+    gapic/v1/types
+    gapic/v1/admin_database_api
+    gapic/v1/admin_database_types
+    gapic/v1/admin_instance_api
+    gapic/v1/admin_instance_types
diff --git a/spanner/docs/batch-api.rst b/spanner/docs/batch-api.rst
new file mode 100644
index 000000000000..ecd51b01cdd9
--- /dev/null
+++ b/spanner/docs/batch-api.rst
@@ -0,0 +1,6 @@
+Batch API
+=========
+
+.. automodule:: google.cloud.spanner_v1.batch
+  :members:
+  :show-inheritance:
diff --git a/spanner/docs/batch-usage.rst b/spanner/docs/batch-usage.rst
new file mode 100644
index 000000000000..d0f38a63b2df
--- /dev/null
+++ b/spanner/docs/batch-usage.rst
@@ -0,0 +1,203 @@
+Batching Modifications
+######################
+
+A :class:`~google.cloud.spanner.batch.Batch` represents a set of data
+modification operations to be performed on tables in a database.  Use of a
+``Batch`` does not require creating an explicit
+:class:`~google.cloud.spanner.snapshot.Snapshot` or
+:class:`~google.cloud.spanner.transaction.Transaction`.  Until
+:meth:`~google.cloud.spanner.batch.Batch.commit` is called on a ``Batch``,
+no changes are propagated to the back-end.
+
+
+Starting a Batch
+----------------
+
+Construct a :class:`~google.cloud.spanner.batch.Batch` object from a :class:`~google.cloud.spanner.database.Database` object:
+
+.. code:: python
+
+    from google.cloud import spanner
+
+    client = spanner.Client()
+    instance = client.instance(INSTANCE_NAME)
+    database = instance.database(DATABASE_NAME)
+
+    batch = database.batch()
+
+
+Inserting records using a Batch
+-------------------------------
+
+:meth:`Batch.insert` adds one or more new records to a table.  Fails if
+any of the records already exists.
+
+.. code:: python
+
+    batch.insert(
+        'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+            ['bharney@example.com', 'Bharney', 'Rhubble', 31],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Update records using a Batch
+-------------------------------
+
+:meth:`Batch.update` updates one or more existing records in a table.  Fails
+if any of the records does not already exist.
+
+.. code:: python
+
+    batch.update(
+        'citizens', columns=['email', 'age'],
+        values=[
+            ['phred@exammple.com', 33],
+            ['bharney@example.com', 32],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Insert or update records using a Batch
+--------------------------------------
+
+:meth:`Batch.insert_or_update` inserts *or* updates one or more records in a
+table.  Existing rows have values for the supplied columns overwritten;  other
+column values are preserved.
+
+.. code:: python
+
+    batch.insert_or_update(
+        'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['phred@exammple.com', 'Phred', 'Phlyntstone', 31],
+            ['wylma@example.com', 'Wylma', 'Phlyntstone', 29],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Replace records using a Batch
+-----------------------------
+
+:meth:`Batch.replace` inserts *or* updates one or more records in a
+table.  Existing rows have values for the supplied columns overwritten;  other
+column values are set to null.
+
+.. code:: python
+
+    batch.replace(
+        'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['bharney@example.com', 'Bharney', 'Rhubble', 30],
+            ['bhettye@example.com', 'Bhettye', 'Rhubble', 30],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Delete records using a Batch
+----------------------------
+
+:meth:`Batch.delete` removes one or more records from a table.  Non-existent
+rows do not cause errors.
+
+.. code:: python
+
+    from google.cloud.spanner.keyset import KeySet
+
+    to_delete = KeySet(keys=[
+        ('bharney@example.com',)
+        ('nonesuch@example.com',)
+    ])
+
+    batch.delete('citizens', to_delete)
+
+
+Commit changes for a Batch
+--------------------------
+
+After describing the modifications to be made to table data via the
+:meth:`Batch.insert`, :meth:`Batch.update`, :meth:`Batch.insert_or_update`,
+:meth:`Batch.replace`, and :meth:`Batch.delete` methods above, send them to
+the back-end by calling :meth:`Batch.commit`, which makes the ``Commit``
+API call.
+
+.. code:: python
+
+    batch.commit()
+
+
+Use a Batch as a Context Manager
+--------------------------------
+
+Rather than calling :meth:`Batch.commit` manually, you can use the
+:class:`Batch` instance as a context manager, and have it called automatically
+if the ``with`` block exits without raising an exception.
+
+.. code:: python
+
+    from google.cloud.spanner.keyset import KeySet
+
+    client = spanner.Client()
+    instance = client.instance(INSTANCE_NAME)
+    database = instance.database(DATABASE_NAME)
+
+    to_delete = KeySet(keys=[
+        ('bharney@example.com',)
+        ('nonesuch@example.com',)
+    ])
+
+    with database.batch() as batch:
+
+        batch.insert(
+            'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+            values=[
+                ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+                ['bharney@example.com', 'Bharney', 'Rhubble', 31],
+            ])
+
+        batch.update(
+            'citizens', columns=['email', 'age'],
+            values=[
+                ['phred@exammple.com', 33],
+                ['bharney@example.com', 32],
+            ])
+
+        ...
+
+        batch.delete('citizens', to_delete)
+
+
+Next Step
+---------
+
+Next, learn about :doc:`snapshot-usage`.
diff --git a/spanner/docs/changelog.md b/spanner/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/spanner/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/spanner/docs/client-api.rst b/spanner/docs/client-api.rst
new file mode 100644
index 000000000000..3cc5a89b2137
--- /dev/null
+++ b/spanner/docs/client-api.rst
@@ -0,0 +1,7 @@
+Spanner Client
+==============
+
+.. automodule:: google.cloud.spanner_v1.client
+  :members:
+  :show-inheritance:
+
diff --git a/spanner/docs/client-usage.rst b/spanner/docs/client-usage.rst
new file mode 100644
index 000000000000..f0340d3111b5
--- /dev/null
+++ b/spanner/docs/client-usage.rst
@@ -0,0 +1,87 @@
+Spanner Client
+==============
+
+.. _spanner-client:
+
+
+Instantiating a Client
+----------------------
+
+To use the API, the :class:`~google.cloud.spanner_v1.client.Client`
+class defines a high-level interface which handles authorization
+and creating other objects:
+
+.. code:: python
+
+    from google.cloud import spanner_v1
+    client = spanner_v1.Client()
+
+Long-lived Defaults
+-------------------
+
+When creating a :class:`~google.cloud.spanner_v1.client.Client`, the
+``user_agent`` and ``timeout_seconds`` arguments have sensible
+defaults
+(:data:`~google.cloud.spanner_v1.client.DEFAULT_USER_AGENT` and
+:data:`~google.cloud.spanner_v1.client.DEFAULT_TIMEOUT_SECONDS`).
+However, you may over-ride them and these will be used throughout all API
+requests made with the ``client`` you create.
+
+Configuration
+-------------
+
+- For an overview of authentication in ``google.cloud-python``,
+  see `Authentication
+  <https://googleapis.dev/python/google-api-core/latest/auth.html>`_.
+
+- In addition to any authentication configuration, you can also set the
+  :envvar:`GCLOUD_PROJECT` environment variable for the Google Cloud Console
+  project you'd like to interact with. If your code is running in Google App
+  Engine or Google Compute Engine the project will be detected automatically.
+  (Setting this environment variable is not required, you may instead pass the
+  ``project`` explicitly when constructing a
+  :class:`~google.cloud.spanner_v1.client.Client`).
+
+- After configuring your environment, create a
+  :class:`~google.cloud.spanner_v1.client.Client`
+
+  .. code::
+
+     >>> from google.cloud import spanner_v1
+     >>> client = spanner_v1.Client()
+
+  or pass in ``credentials`` and ``project`` explicitly
+
+  .. code::
+
+     >>> from google.cloud import spanner_v1
+     >>> client = spanner_v1.Client(project='my-project', credentials=creds)
+
+.. tip::
+
+    Be sure to use the **Project ID**, not the **Project Number**.
+
+
+Warnings about Multiprocessing
+------------------------------
+
+.. warning::
+   When using multiprocessing, the application may hang if a
+   :class:`Client <google.cloud.spanner_v1.client.Client>` instance is created
+   before :class:`multiprocessing.Pool` or :class:`multiprocessing.Process`
+   invokes :func:`os.fork`.  The issue is under investigation, but may be only
+   happening on Macintosh and not Linux.  See `GRPC/GRPC#12455
+   <https://github.com/grpc/grpc/issues/12455#issuecomment-348578950>`_ for
+   more information.
+
+Next Step
+---------
+
+After a :class:`~google.cloud.spanner_v1.client.Client`, the next
+highest-level object is an :class:`~google.cloud.spanner_v1.instance.Instance`.
+You'll need one before you can interact with databases.
+
+Next, learn about the :doc:`instance-usage`.
+
+.. _Instance Admin: https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1
+.. _Database Admin: https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1
diff --git a/spanner/docs/conf.py b/spanner/docs/conf.py
new file mode 100644
index 000000000000..320b3c2fc87f
--- /dev/null
+++ b/spanner/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-spanner documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.doctest",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-spanner"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-spanner-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-spanner.tex",
+        u"google-cloud-spanner Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-spanner",
+        u"google-cloud-spanner Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-spanner",
+        u"google-cloud-spanner Documentation",
+        author,
+        "google-cloud-spanner",
+        "GAPIC library for the {metadata.shortName} service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/spanner/docs/database-api.rst b/spanner/docs/database-api.rst
new file mode 100644
index 000000000000..f1ce2a6d8e26
--- /dev/null
+++ b/spanner/docs/database-api.rst
@@ -0,0 +1,8 @@
+Database API
+============
+
+.. automodule:: google.cloud.spanner_v1.database
+  :members:
+  :show-inheritance:
+
+
diff --git a/spanner/docs/database-usage.rst b/spanner/docs/database-usage.rst
new file mode 100644
index 000000000000..5d47d71cdc82
--- /dev/null
+++ b/spanner/docs/database-usage.rst
@@ -0,0 +1,251 @@
+Database Admin
+==============
+
+After creating a :class:`~google.cloud.spanner.instance.Instance`, you can
+interact with individual databases for that instance.
+
+
+List Databases
+--------------
+
+To iterate over all existing databases for an instance, use its
+:meth:`~google.cloud.spanner.instance.Instance.list_databases` method:
+
+.. code:: python
+
+    for database in instance.list_databases():
+        # `database` is a `Database` object.
+
+This method yields :class:`~.spanner_admin_database_v1.types.Database`
+objects.
+
+
+Database Factory
+----------------
+
+To create a :class:`~google.cloud.spanner.database.Database` object:
+
+.. code:: python
+
+    database = instance.database(database_id, ddl_statements)
+
+- ``ddl_statements`` is a string containing DDL for the new database.
+
+You can also use :meth:`Instance.database` to create a local wrapper for
+a database that has already been created:
+
+.. code:: python
+
+    database = instance.database(existing_database_id)
+
+
+Create a new Database
+---------------------
+
+After creating the database object, use its
+:meth:`~google.cloud.spanner.database.Database.create` method to
+trigger its creation on the server:
+
+.. code:: python
+
+    operation = database.create()
+
+.. note::
+
+    Creating an instance triggers a "long-running operation" and
+    returns an :class:`~concurrent.futures.Future`-like object. Use
+    the :meth:`~concurrent.futures.Future.result` method to wait for
+    and inspect the result.
+
+
+Update an existing Database
+---------------------------
+
+After creating the database object, you can apply additional DDL statements
+via its :meth:`~google.cloud.spanner.database.Database.update_ddl` method:
+
+.. code:: python
+
+    operation = database.update_ddl(ddl_statements, operation_id)
+
+- ``ddl_statements`` is a string containing DDL to be applied to
+  the database.
+
+- ``operation_id`` is a string ID for the long-running operation.
+
+.. note::
+
+    Update an instance triggers a "long-running operation" and
+    returns a :class:`google.cloud.spanner.database.Operation`
+    object.  See :ref:`check-on-current-database-operation` for polling
+    to find out if the operation is completed.
+
+
+Drop a Database
+---------------
+
+Drop a database using its
+:meth:`~google.cloud.spanner.database.Database.drop` method:
+
+.. code:: python
+
+    database.drop()
+
+
+.. _check-on-current-database-operation:
+
+Check on Current Database Operation
+-----------------------------------
+
+The :meth:`~google.cloud.spanner.database.Database.create` and
+:meth:`~google.cloud.spanner.database.Database.update` methods of instance
+object trigger long-running operations on the server, and return instances
+conforming to the :class:`~.concurrent.futures.Future` class.
+
+.. code:: python
+
+    >>> operation = instance.create()
+    >>> operation.result()
+
+
+Non-Admin Database Usage
+========================
+
+Use a Snapshot to Read / Query the Database
+-------------------------------------------
+
+A snapshot represents a read-only point-in-time view of the database.
+
+Calling :meth:`~google.cloud.spanner.database.Database.snapshot` with
+no arguments creates a snapshot with strong concurrency:
+
+.. code:: python
+
+   with database.snapshot() as snapshot:
+       do_something_with(snapshot)
+
+See :class:`~google.cloud.spanner.snapshot.Snapshot` for the other options
+which can be passed.
+
+.. note::
+
+   :meth:`~google.cloud.spanner.database.Database.snapshot` returns an
+   object intended to be used as a Python context manager (i.e., as the
+   target of a ``with`` statement).  Use the instance, and any result
+   sets returned by its ``read`` or ``execute_sql`` methods, only inside
+   the block created by the ``with`` statement.
+
+See :doc:`snapshot-usage` for more complete examples of snapshot usage.
+
+Use a Batch to Modify Rows in the Database
+------------------------------------------
+
+A batch represents a bundled set of insert/upsert/update/delete operations
+on the rows of tables in the database.
+
+.. code:: python
+
+   with database.batch() as batch:
+        batch.insert_or_update(table, columns, rows)
+        batch.delete(table, keyset_to_delete)
+
+.. note::
+
+   :meth:`~google.cloud.spanner.database.Database.batch` returns an
+   object intended to be used as a Python context manager (i.e., as the
+   target of a ``with`` statement).  It applies any changes made inside
+   the block of its ``with`` statement when exiting the block, unless an
+   exception is raised within the block.  Use the batch only inside
+   the block created by the ``with`` statement.
+
+See :doc:`batch-usage` for more complete examples of batch usage.
+
+Use a Transaction to Query / Modify Rows in the Database
+--------------------------------------------------------
+
+A transaction represents the union of a "strong" snapshot and a batch:
+it allows ``read`` and ``execute_sql`` operations, and accumulates
+insert/upsert/update/delete operations.
+
+Because other applications may be performing concurrent updates which
+would invalidate the reads / queries, the work done by a transaction needs
+to be bundled as a retryable "unit of work" function, which takes the
+transaction as a required argument:
+
+.. code:: python
+
+   def unit_of_work(transaction):
+       result = transaction.execute_sql(QUERY)
+
+       for emp_id, hours, pay in _compute_pay(result):
+           transaction.insert_or_update(
+               table='monthly_hours',
+               columns=['employee_id', 'month', 'hours', 'pay'],
+               values=[emp_id, month_start, hours, pay])
+
+   database.run_in_transaction(unit_of_work)
+
+.. note::
+
+   :meth:`~google.cloud.spanner.database.Database.run_in_transaction`
+   commits the transaction automatically if the "unit of work" function
+   returns without raising an exception.
+
+.. note::
+
+   :meth:`~google.cloud.spanner.database.Database.run_in_transaction`
+   retries the "unit of work" function if the read / query operatoins
+   or the commit are aborted due to concurrent updates
+
+See :doc:`transaction-usage` for more complete examples of transaction usage.
+
+Configuring a session pool for a database
+-----------------------------------------
+
+Under the covers, the ``snapshot``, ``batch``, and ``run_in_transaction``
+methods use a pool of :class:`~google.cloud.spanner.session.Session` objects
+to manage their communication with the back-end.  You can configure
+one of the pools manually to control the number of sessions, timeouts, etc.,
+and then passing it to the :class:`~google.cloud.spanner.database.Database`
+constructor:
+
+.. code-block:: python
+
+    from google.cloud import spanner
+
+    # Instantiate the Spanner client, and get the appropriate instance.
+    client = spanner.Client()
+    instance = client.instance(INSTANCE_NAME)
+
+    # Create a database with a pool of a fixed size.
+    pool = spanner.FixedSizePool(size=10, default_timeout=5)
+    database = instance.database(DATABASE_NAME, pool=pool)
+
+Note that creating a database with a pool may presume that its database
+already exists, as it may need to pre-create sessions (rather than creating
+them on demand, as the default implementation does).
+
+You can supply your own pool implementation, which must satisfy the
+contract laid out in :class:`~google.cloud.spanner.pool.AbstractSessionPool`:
+
+.. code-block:: python
+
+   from google.cloud.pool import AbstractSessionPool
+
+   class MyCustomPool(AbstractSessionPool):
+
+        def __init__(self, database, custom_param):
+            super(MyCustomPool, self).__init__(database)
+            self.custom_param = custom_param
+
+        def get(self, read_only=False):
+            ...
+
+        def put(self, session, discard_if_full=True):
+            ...
+
+   database = instance.database(DATABASE_NAME, pool=pool)
+   pool = MyCustomPool(database, custom_param=42)
+
+See :doc:`advanced-session-pool-topics` for more advanced coverage of
+session pools.
diff --git a/spanner/docs/gapic/v1/admin_database_api.rst b/spanner/docs/gapic/v1/admin_database_api.rst
new file mode 100644
index 000000000000..c63f242e8557
--- /dev/null
+++ b/spanner/docs/gapic/v1/admin_database_api.rst
@@ -0,0 +1,6 @@
+Spanner Admin Database Client API
+=================================
+
+.. automodule:: google.cloud.spanner_admin_database_v1
+  :members:
+  :inherited-members:
diff --git a/spanner/docs/gapic/v1/admin_database_types.rst b/spanner/docs/gapic/v1/admin_database_types.rst
new file mode 100644
index 000000000000..de3d9585c715
--- /dev/null
+++ b/spanner/docs/gapic/v1/admin_database_types.rst
@@ -0,0 +1,5 @@
+Spanner Admin Database Client Types
+===================================
+
+.. automodule:: google.cloud.spanner_admin_database_v1.types
+  :members:
diff --git a/spanner/docs/gapic/v1/admin_instance_api.rst b/spanner/docs/gapic/v1/admin_instance_api.rst
new file mode 100644
index 000000000000..c8c320a6cf41
--- /dev/null
+++ b/spanner/docs/gapic/v1/admin_instance_api.rst
@@ -0,0 +1,6 @@
+Spanner Admin Instance Client API
+=================================
+
+.. automodule:: google.cloud.spanner_admin_instance_v1
+  :members:
+  :inherited-members:
diff --git a/spanner/docs/gapic/v1/admin_instance_types.rst b/spanner/docs/gapic/v1/admin_instance_types.rst
new file mode 100644
index 000000000000..4cd06b3ca0d9
--- /dev/null
+++ b/spanner/docs/gapic/v1/admin_instance_types.rst
@@ -0,0 +1,5 @@
+Spanner Admin Instance Client Types
+===================================
+
+.. automodule:: google.cloud.spanner_admin_instance_v1.types
+  :members:
diff --git a/spanner/docs/gapic/v1/api.rst b/spanner/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..79e4835f2222
--- /dev/null
+++ b/spanner/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Spanner Client API
+==================
+
+.. automodule:: google.cloud.spanner_v1
+  :members:
+  :inherited-members:
diff --git a/spanner/docs/gapic/v1/transactions.rst b/spanner/docs/gapic/v1/transactions.rst
new file mode 100644
index 000000000000..d34af43b4ae9
--- /dev/null
+++ b/spanner/docs/gapic/v1/transactions.rst
@@ -0,0 +1,241 @@
+..
+    This page is pulled from the TransactionOption type, where this entire
+    kaboodle is auto-generated. Sphinx does not particularly appreciate
+    entire narrative documentation, complete with headers, in an arbitrary
+    class docstring, and complains about this, so I (lukesneeringer@)
+    manually copied it over here.
+
+    This should probably be updated when the Spanner code is re-generated.
+    This will be easy to remember because the source that needs to be copied
+    will be dropped in transaction_pb2.py and Sphinx will complain loudly
+    about it.
+
+    Internal Google ticket: b/65243734
+
+:orphan:
+
+.. _spanner-txn:
+
+Transactions
+============
+
+Each session can have at most one active transaction at a time. After
+the active transaction is completed, the session can immediately be
+re-used for the next transaction. It is not necessary to create a new
+session for each transaction.
+
+Transaction Modes
+=================
+
+Cloud Spanner supports two transaction modes:
+
+1. Locking read-write. This type of transaction is the only way to write
+   data into Cloud Spanner. These transactions rely on pessimistic
+   locking and, if necessary, two-phase commit. Locking read-write
+   transactions may abort, requiring the application to retry.
+
+2. Snapshot read-only. This transaction type provides guaranteed
+   consistency across several reads, but does not allow writes. Snapshot
+   read-only transactions can be configured to read at timestamps in the
+   past. Snapshot read-only transactions do not need to be committed.
+
+For transactions that only read, snapshot read-only transactions provide
+simpler semantics and are almost always faster. In particular, read-only
+transactions do not take locks, so they do not conflict with read-write
+transactions. As a consequence of not taking locks, they also do not
+abort, so retry loops are not needed.
+
+Transactions may only read/write data in a single database. They may,
+however, read/write data in different tables within that database.
+
+Locking Read-Write Transactions
+-------------------------------
+
+Locking transactions may be used to atomically read-modify-write data
+anywhere in a database. This type of transaction is externally
+consistent.
+
+Clients should attempt to minimize the amount of time a transaction is
+active. Faster transactions commit with higher probability and cause
+less contention. Cloud Spanner attempts to keep read locks active as
+long as the transaction continues to do reads, and the transaction has
+not been terminated by [Commit][google.spanner.v1.Spanner.Commit] or
+[Rollback][google.spanner.v1.Spanner.Rollback]. Long periods of
+inactivity at the client may cause Cloud Spanner to release a
+transaction's locks and abort it.
+
+Reads performed within a transaction acquire locks on the data being
+read. Writes can only be done at commit time, after all reads have been
+completed. Conceptually, a read-write transaction consists of zero or
+more reads or SQL queries followed by
+[Commit][google.spanner.v1.Spanner.Commit]. At any time before
+[Commit][google.spanner.v1.Spanner.Commit], the client can send a
+[Rollback][google.spanner.v1.Spanner.Rollback] request to abort the
+transaction.
+
+Semantics
+~~~~~~~~~
+
+Cloud Spanner can commit the transaction if all read locks it acquired
+are still valid at commit time, and it is able to acquire write locks
+for all writes. Cloud Spanner can abort the transaction for any reason.
+If a commit attempt returns ``ABORTED``, Cloud Spanner guarantees that
+the transaction has not modified any user data in Cloud Spanner.
+
+Unless the transaction commits, Cloud Spanner makes no guarantees about
+how long the transaction's locks were held for. It is an error to use
+Cloud Spanner locks for any sort of mutual exclusion other than between
+Cloud Spanner transactions themselves.
+
+Retrying Aborted Transactions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a transaction aborts, the application can choose to retry the whole
+transaction again. To maximize the chances of successfully committing
+the retry, the client should execute the retry in the same session as
+the original attempt. The original session's lock priority increases
+with each consecutive abort, meaning that each attempt has a slightly
+better chance of success than the previous.
+
+Under some circumstances (e.g., many transactions attempting to modify
+the same row(s)), a transaction can abort many times in a short period
+before successfully committing. Thus, it is not a good idea to cap the
+number of retries a transaction can attempt; instead, it is better to
+limit the total amount of wall time spent retrying.
+
+Idle Transactions
+~~~~~~~~~~~~~~~~~
+
+A transaction is considered idle if it has no outstanding reads or SQL
+queries and has not started a read or SQL query within the last 10
+seconds. Idle transactions can be aborted by Cloud Spanner so that they
+don't hold on to locks indefinitely. In that case, the commit will fail
+with error ``ABORTED``.
+
+If this behavior is undesirable, periodically executing a simple SQL
+query in the transaction (e.g., ``SELECT 1``) prevents the transaction
+from becoming idle.
+
+Snapshot Read-Only Transactions
+-------------------------------
+
+Snapshot read-only transactions provides a simpler method than locking
+read-write transactions for doing several consistent reads. However,
+this type of transaction does not support writes.
+
+Snapshot transactions do not take locks. Instead, they work by choosing
+a Cloud Spanner timestamp, then executing all reads at that timestamp.
+Since they do not acquire locks, they do not block concurrent read-write
+transactions.
+
+Unlike locking read-write transactions, snapshot read-only transactions
+never abort. They can fail if the chosen read timestamp is garbage
+collected; however, the default garbage collection policy is generous
+enough that most applications do not need to worry about this in
+practice.
+
+Snapshot read-only transactions do not need to call
+[Commit][google.spanner.v1.Spanner.Commit] or
+[Rollback][google.spanner.v1.Spanner.Rollback] (and in fact are not
+permitted to do so).
+
+To execute a snapshot transaction, the client specifies a timestamp
+bound, which tells Cloud Spanner how to choose a read timestamp.
+
+The types of timestamp bound are:
+
+-  Strong (the default).
+-  Bounded staleness.
+-  Exact staleness.
+
+If the Cloud Spanner database to be read is geographically distributed,
+stale read-only transactions can execute more quickly than strong or
+read-write transaction, because they are able to execute far from the
+leader replica.
+
+Each type of timestamp bound is discussed in detail below.
+
+Strong
+~~~~~~
+
+Strong reads are guaranteed to see the effects of all transactions that
+have committed before the start of the read. Furthermore, all rows
+yielded by a single read are consistent with each other -- if any part
+of the read observes a transaction, all parts of the read see the
+transaction.
+
+Strong reads are not repeatable: two consecutive strong read-only
+transactions might return inconsistent results if there are concurrent
+writes. If consistency across reads is required, the reads should be
+executed within a transaction or at an exact read timestamp.
+
+See
+[TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong].
+
+Exact Staleness
+~~~~~~~~~~~~~~~
+
+These timestamp bounds execute reads at a user-specified timestamp.
+Reads at a timestamp are guaranteed to see a consistent prefix of the
+global transaction history: they observe modifications done by all
+transactions with a commit timestamp <= the read timestamp, and observe
+none of the modifications done by transactions with a larger commit
+timestamp. They will block until all conflicting transactions that may
+be assigned commit timestamps <= the read timestamp have finished.
+
+The timestamp can either be expressed as an absolute Cloud Spanner
+commit timestamp or a staleness relative to the current time.
+
+These modes do not require a "negotiation phase" to pick a timestamp. As
+a result, they execute slightly faster than the 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
+[TransactionOptions.ReadOnly.exact\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact\_staleness].
+
+Bounded Staleness
+~~~~~~~~~~~~~~~~~
+
+Bounded staleness modes allow Cloud Spanner to pick the read timestamp,
+subject to a user-provided staleness bound. Cloud Spanner chooses the
+newest timestamp within the staleness bound that allows execution of the
+reads at the closest available replica without blocking.
+
+All rows yielded are consistent with each other -- if any part of the
+read observes a transaction, all parts of the read see the transaction.
+Boundedly stale reads are not repeatable: two stale reads, even if they
+use the same staleness bound, can execute at different timestamps and
+thus return inconsistent results.
+
+Boundedly stale reads execute in two phases: the first phase negotiates
+a timestamp among all replicas needed to serve the read. In the second
+phase, reads are executed at the negotiated timestamp.
+
+As a result of the two phase execution, bounded staleness reads are
+usually a little slower than comparable exact staleness reads. However,
+they are typically able to return fresher results, and are more likely
+to execute at the closest replica.
+
+Because the timestamp negotiation requires up-front knowledge of 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
+[TransactionOptions.ReadOnly.min\_read\_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min\_read\_timestamp].
+
+Old Read Timestamps and Garbage Collection
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Cloud Spanner continuously garbage collects deleted and overwritten data
+in the background to reclaim storage space. This process is known as
+"version GC". By default, version GC reclaims versions after they are
+one hour old. Because of this, Cloud Spanner cannot perform reads at
+read timestamps more than one hour in the past. This restriction also
+applies to in-progress reads and/or SQL queries whose timestamp become
+too old while executing. Reads and SQL queries with too-old read
+timestamps fail with the error ``FAILED_PRECONDITION``.
diff --git a/spanner/docs/gapic/v1/types.rst b/spanner/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..28956e60c769
--- /dev/null
+++ b/spanner/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Spanner Client Types
+===================================
+
+.. automodule:: google.cloud.spanner_v1.types
+  :members:
diff --git a/spanner/docs/index.rst b/spanner/docs/index.rst
new file mode 100644
index 000000000000..729f42d0e062
--- /dev/null
+++ b/spanner/docs/index.rst
@@ -0,0 +1,33 @@
+.. include:: README.rst
+
+Usage Documentation
+-------------------
+.. toctree::
+  :maxdepth: 1
+  :titlesonly:
+
+  client-usage
+  instance-usage
+  database-usage
+  batch-usage
+  snapshot-usage
+  transaction-usage
+
+API Documentation
+-----------------
+.. toctree::
+  :maxdepth: 1
+  :titlesonly:
+
+  api-reference
+  advanced-session-pool-topics
+
+Changelog
+---------
+
+For a list of all ``google-cloud-spanner`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/spanner/docs/instance-api.rst b/spanner/docs/instance-api.rst
new file mode 100644
index 000000000000..127b4c687372
--- /dev/null
+++ b/spanner/docs/instance-api.rst
@@ -0,0 +1,8 @@
+Instance API
+============
+
+.. automodule:: google.cloud.spanner_v1.instance
+  :members:
+  :show-inheritance:
+
+
diff --git a/spanner/docs/instance-usage.rst b/spanner/docs/instance-usage.rst
new file mode 100644
index 000000000000..909e36b93f98
--- /dev/null
+++ b/spanner/docs/instance-usage.rst
@@ -0,0 +1,181 @@
+Instance Admin
+==============
+
+After creating a :class:`~google.cloud.spanner.client.Client`, you can
+interact with individual instances for a project.
+
+Instance Configurations
+-----------------------
+
+Each instance within a project maps to a named "instance configuration",
+specifying the location and other parameters for a set of instances.  These
+configurations are defined by the server, and cannot be changed.
+
+To iterate over all instance configurations available to your project, use the
+:meth:`~google.cloud.spanner.client.Client.list_instance_configs`
+method of the client:
+
+.. code:: python
+
+    for config in client.list_instance_configs():
+        # `config` is an instance of `InstanceConfig`
+
+
+To fetch a single instance configuration, use the
+:meth:`~google.cloud.spanner.client.Client.get_instance_configuration`
+method of the client:
+
+.. code:: python
+
+    config = client.get_instance_configuration('config-name')
+
+Each of these methods provide
+:class:`~.spanner_admin_instance_v1.types.InstanceConfig` objects.
+
+
+List Instances
+--------------
+
+If you want a comprehensive list of all existing instances, iterate over the
+:meth:`~google.cloud.spanner.client.Client.list_instances` method of
+the client:
+
+.. code:: python
+
+    for instance in client.list_instances():
+        # `instance` is an instance of `Instance`
+
+This iterator yields :class:`~.spanner_admin_instance_v1.types.Instance`
+objects.
+
+
+Instance Factory
+----------------
+
+To create a :class:`~google.cloud.spanner.instance.Instance` object:
+
+.. code:: python
+
+    config = configs[0]
+    instance = client.instance(instance_id,
+                               configuration_name=config.name,
+                               node_count=10,
+                               display_name='My Instance')
+
+- ``configuration_name`` is the name of the instance configuration to which the
+  instance will be bound.  It must be one of the names configured for your
+  project, discoverable via
+  :meth:`~google.cloud.spanner.client.Client.list_instance_configs`.
+
+- ``node_count`` is a postitive integral count of the number of nodes used
+  by the instance.  More nodes allows for higher performance, but at a higher
+  billing cost.
+
+- ``display_name`` is optional. When not provided, ``display_name`` defaults
+  to the ``instance_id`` value.
+
+You can also use :meth:`Client.instance` to create a local wrapper for
+an instance that has already been created:
+
+.. code:: python
+
+    instance = client.instance(existing_instance_id)
+    instance.reload()
+
+
+Create a new Instance
+---------------------
+
+After creating the instance object, use its
+:meth:`~google.cloud.spanner.instance.Instance.create` method to
+trigger its creation on the server:
+
+.. code:: python
+
+    instance.display_name = 'My very own instance'
+    operation = instance.create()
+
+.. note::
+
+    Creating an instance triggers a "long-running operation" and
+    returns an :class:`google.cloud.spanner.instance.Operation`
+    object.  See :ref:`check-on-current-instance-operation` for polling
+    to find out if the operation is completed.
+
+
+Refresh metadata for an existing Instance
+-----------------------------------------
+
+After creating the instance object, reload its server-side configuration
+using its :meth:`~google.cloud.spanner.instance.Instance.reload` method:
+
+.. code:: python
+
+    instance.reload()
+
+This will load ``display_name``, ``config_name``, and ``node_count``
+for the existing ``instance`` object from the back-end.
+
+
+Update an existing Instance
+---------------------------
+
+After creating the instance object, you can update its metadata via
+its :meth:`~google.cloud.spanner.instance.Instance.update` method:
+
+.. code:: python
+
+    client.display_name = 'New display_name'
+    operation = instance.update()
+
+.. note::
+
+    Update an instance triggers a "long-running operation" and
+    returns a :class:`google.cloud.spanner.instance.Operation`
+    object.  See :ref:`check-on-current-instance-operation` for polling
+    to find out if the operation is completed.
+
+
+Delete an existing Instance
+---------------------------
+
+Delete an instance using its
+:meth:`~google.cloud.spanner.instance.Instance.delete` method:
+
+.. code:: python
+
+    instance.delete()
+
+
+.. _check-on-current-instance-operation:
+
+Resolve Current Instance Operation
+----------------------------------
+
+The :meth:`~google.cloud.spanner.instance.Instance.create` and
+:meth:`~google.cloud.spanner.instance.Instance.update` methods of instance
+object trigger long-running operations on the server, and return instances
+of the :class:`~google.cloud.spanner.instance.Operation` class.
+
+If you want to block on the completion of those operations, use the
+``result`` method on the returned objects:
+
+.. code:: python
+
+    >>> operation = instance.create()
+    >>> result = operation.result()
+
+This method will raise an exception if the operation fails.
+
+
+Next Step
+---------
+
+Now we go down the hierarchy from
+:class:`~google.cloud.spanner.instance.Instance` to a
+:class:`~google.cloud.spanner.database.Database`.
+
+Next, learn about the :doc:`database-usage`.
+
+
+.. _Instance Admin API: https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1
diff --git a/spanner/docs/keyset-api.rst b/spanner/docs/keyset-api.rst
new file mode 100644
index 000000000000..90137cf87640
--- /dev/null
+++ b/spanner/docs/keyset-api.rst
@@ -0,0 +1,8 @@
+Keyset API
+==========
+
+.. automodule:: google.cloud.spanner_v1.keyset
+  :members:
+  :show-inheritance:
+
+
diff --git a/spanner/docs/session-api.rst b/spanner/docs/session-api.rst
new file mode 100644
index 000000000000..1f6d0ac60261
--- /dev/null
+++ b/spanner/docs/session-api.rst
@@ -0,0 +1,15 @@
+Session API
+===========
+
+.. automodule:: google.cloud.spanner_v1.session
+  :members:
+  :show-inheritance:
+
+
+Session Pools API
+=================
+
+.. automodule:: google.cloud.spanner_v1.pool
+  :members:
+  :show-inheritance:
+
diff --git a/spanner/docs/snapshot-api.rst b/spanner/docs/snapshot-api.rst
new file mode 100644
index 000000000000..ca37d8a2591a
--- /dev/null
+++ b/spanner/docs/snapshot-api.rst
@@ -0,0 +1,8 @@
+Snapshot API
+============
+
+.. automodule:: google.cloud.spanner_v1.snapshot
+  :members:
+  :inherited-members:
+
+
diff --git a/spanner/docs/snapshot-usage.rst b/spanner/docs/snapshot-usage.rst
new file mode 100644
index 000000000000..4c5a5b24204c
--- /dev/null
+++ b/spanner/docs/snapshot-usage.rst
@@ -0,0 +1,108 @@
+Read-only Transactions via Snapshots
+####################################
+
+A :class:`~google.cloud.spanner.snapshot.Snapshot` represents a read-only
+transaction:  when multiple read operations are peformed via a Snapshot,
+the results are consistent as of a particular point in time.
+
+
+Beginning a Snapshot
+--------------------
+
+To begin using a snapshot using the default "bound" (which is "strong"),
+meaning all reads are performed at a timestamp where all previously-committed
+transactions are visible:
+
+.. code:: python
+
+    snapshot = database.snapshot()
+
+You can also specify a weaker bound, which can either be to perform all
+reads as of a given timestamp:
+
+.. code:: python
+
+    import datetime
+    from pytz import UTC
+    TIMESTAMP = datetime.datetime.utcnow().replace(tzinfo=UTC)
+    snapshot = database.snapshot(read_timestamp=TIMESTAMP)
+
+or as of a given duration in the past:
+
+.. code:: python
+
+    import datetime
+    DURATION = datetime.timedelta(seconds=5)
+    snapshot = database.snapshot(exact_staleness=DURATION)
+
+Single Use and Multiple Use Snapshots
+-------------------------------------
+
+In the context of read only transactions, ``read`` and ``execute_sql``
+methods can be used multiple times if you specify ``multi_use=True``
+in the constructor of the snapshot.  However, ``multi_use=True`` is
+incompatible with either ``max_staleness`` and/or ``min_read_timestamp``.
+
+Otherwise ``multi_use`` defaults to ``False`` and the snapshot cannot be
+reused.
+
+.. code:: python
+
+    snapshot = database.snapshot(multi_use=True)
+
+:meth:`~.spanner_v1.snapshot.Snapshot.begin` can only be used on a
+snapshot with ``multi_use=True``.  In which case it is also necessary
+to call if you need to have multiple pending operations.
+
+Read Table Data
+---------------
+
+Read data for selected rows from a table in the database.  Calls
+the ``Read`` API, which returns all rows specified in ``key_set``, or else
+fails if the result set is too large,
+
+.. code:: python
+
+    with database.snapshot() as snapshot:
+        result = snapshot.read(
+            table='table-name', columns=['first_name', 'last_name', 'age'],
+            key_set=['phred@example.com', 'bharney@example.com'])
+
+        for row in result.rows:
+            print(row)
+
+.. note::
+
+   Perform all iteration within the context of the ``with database.snapshot()``
+   block.
+
+
+Execute a SQL Select Statement
+------------------------------
+
+Read data from a query against tables in the database.  Calls
+the ``ExecuteSql`` API, which returns all rows matching the query, or else
+fails if the result set is too large,
+
+.. code:: python
+
+    with database.snapshot() as snapshot:
+        QUERY = (
+            'SELECT e.first_name, e.last_name, p.telephone '
+            'FROM employees as e, phones as p '
+            'WHERE p.employee_id == e.employee_id')
+        result = snapshot.execute_sql(QUERY)
+
+        for row in list(result):
+            print(row)
+
+.. note::
+
+   Perform all iteration within the context of the ``with database.snapshot()``
+   block.
+
+
+Next Step
+---------
+
+Next, learn about :doc:`transaction-usage`.
diff --git a/spanner/docs/streamed-api.rst b/spanner/docs/streamed-api.rst
new file mode 100644
index 000000000000..53bab89ba491
--- /dev/null
+++ b/spanner/docs/streamed-api.rst
@@ -0,0 +1,8 @@
+StreamedResultSet API
+=====================
+
+.. automodule:: google.cloud.spanner_v1.streamed
+  :members:
+  :show-inheritance:
+
+
diff --git a/spanner/docs/transaction-api.rst b/spanner/docs/transaction-api.rst
new file mode 100644
index 000000000000..f7e8d4759aa9
--- /dev/null
+++ b/spanner/docs/transaction-api.rst
@@ -0,0 +1,8 @@
+Transaction API
+===============
+
+.. automodule:: google.cloud.spanner_v1.transaction
+  :members:
+  :inherited-members:
+
+
diff --git a/spanner/docs/transaction-usage.rst b/spanner/docs/transaction-usage.rst
new file mode 100644
index 000000000000..4e943ed405df
--- /dev/null
+++ b/spanner/docs/transaction-usage.rst
@@ -0,0 +1,291 @@
+Read-write Transactions
+#######################
+
+A :class:`~google.cloud.spanner.transaction.Transaction` represents a
+transaction:  when the transaction commits, it will send any accumulated
+mutations to the server.
+
+To understand more about how transactions work, visit :ref:`spanner-txn`.
+To learn more about how to use them in the Python client, continue reading.
+
+
+Read Table Data
+---------------
+
+Read data for selected rows from a table in the database.  Calls the ``Read``
+API, which returns all rows specified in ``key_set``, or else fails if the
+result set is too large,
+
+.. code:: python
+
+    result = transaction.read(
+        table='table-name', columns=['first_name', 'last_name', 'age'],
+        key_set=['phred@example.com', 'bharney@example.com'])
+
+    for row in list(result):
+        print(row)
+
+.. note::
+
+   If streaming a chunk fails due to a "resumable" error,
+   :meth:`Snapshot.read` retries the ``StreamingRead`` API request,
+   passing the ``resume_token`` from the last partial result streamed.
+
+
+Execute a SQL Select Statement
+------------------------------
+
+Read data from a query against tables in the database.  Calls
+the ``ExecuteSql`` API, which returns all rows matching the query, or else
+fails if the result set is too large,
+
+.. code:: python
+
+    QUERY = (
+        'SELECT e.first_name, e.last_name, p.telephone '
+        'FROM employees as e, phones as p '
+        'WHERE p.employee_id == e.employee_id')
+    result = transaction.execute_sql(QUERY)
+
+    for row in list(result):
+        print(row)
+
+
+Insert records using a Transaction
+----------------------------------
+
+:meth:`Transaction.insert` adds one or more new records to a table.  Fails if
+any of the records already exists.
+
+.. code:: python
+
+    transaction.insert(
+        'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+            ['bharney@example.com', 'Bharney', 'Rhubble', 31],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Update records using a Transaction
+----------------------------------
+
+:meth:`Transaction.update` updates one or more existing records in a table.  Fails
+if any of the records does not already exist.
+
+.. code:: python
+
+    transaction.update(
+        'citizens', columns=['email', 'age'],
+        values=[
+            ['phred@exammple.com', 33],
+            ['bharney@example.com', 32],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Insert or update records using a Transaction
+--------------------------------------------
+
+:meth:`Transaction.insert_or_update` inserts *or* updates one or more records
+in a table.  Existing rows have values for the supplied columns overwritten;
+other column values are preserved.
+
+.. code:: python
+
+    transaction.insert_or_update(
+        'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['phred@exammple.com', 'Phred', 'Phlyntstone', 31],
+            ['wylma@example.com', 'Wylma', 'Phlyntstone', 29],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Replace records using a Transaction
+-----------------------------------
+
+:meth:`Transaction.replace` inserts *or* updates one or more records in a
+table.  Existing rows have values for the supplied columns overwritten;  other
+column values are set to null.
+
+.. code:: python
+
+    transaction.replace(
+        'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+        values=[
+            ['bharney@example.com', 'Bharney', 'Rhubble', 30],
+            ['bhettye@example.com', 'Bhettye', 'Rhubble', 30],
+        ])
+
+.. note::
+
+    Ensure that data being sent for ``STRING`` columns uses a text string
+    (``str`` in Python 3; ``unicode`` in Python 2).
+
+    Additionally, if you are writing data intended for a ``BYTES`` column, you
+    must base64 encode it.
+
+
+Delete records using a Transaction
+----------------------------------
+
+:meth:`Transaction.delete` removes one or more records from a table.
+Non-existent rows do not cause errors.
+
+.. code:: python
+
+    transaction.delete(
+        'citizens', keyset=['bharney@example.com', 'nonesuch@example.com'])
+
+
+Using :meth:`~Database.run_in_transaction`
+------------------------------------------
+
+Rather than calling :meth:`~Transaction.commit` or :meth:`~Transaction.rollback`
+manually, you should use :meth:`~Database.run_in_transaction` to run the
+function that you need.  The transaction's :meth:`~Transaction.commit` method
+will be called automatically if the ``with`` block exits without raising an
+exception.  The function will automatically be retried for
+:class:`~google.api_core.exceptions.Aborted` errors, but will raise on
+:class:`~google.api_core.exceptions.GoogleAPICallError` and
+:meth:`~Transaction.rollback` will be called on all others.
+
+.. code:: python
+
+    def _unit_of_work(transaction):
+
+        transaction.insert(
+            'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+            values=[
+                ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+                ['bharney@example.com', 'Bharney', 'Rhubble', 31],
+            ])
+
+        transaction.update(
+            'citizens', columns=['email', 'age'],
+            values=[
+                ['phred@exammple.com', 33],
+                ['bharney@example.com', 32],
+            ])
+
+        ...
+
+        transaction.delete('citizens',
+            keyset['bharney@example.com', 'nonesuch@example.com'])
+
+    db.run_in_transaction(_unit_of_work)
+
+
+Use a Transaction as a Context Manager
+--------------------------------------
+
+Alternatively, you can use the :class:`Transaction` instance as a context
+manager.  The transaction's :meth:`~Transaction.commit` method will be called
+automatically if the ``with`` block exits without raising an exception.
+
+If an exception is raised inside the ``with`` block, the transaction's
+:meth:`~Transaction.rollback` method will automatically be called.
+
+.. code:: python
+
+    with session.transaction() as transaction:
+
+        transaction.insert(
+            'citizens', columns=['email', 'first_name', 'last_name', 'age'],
+            values=[
+                ['phred@exammple.com', 'Phred', 'Phlyntstone', 32],
+                ['bharney@example.com', 'Bharney', 'Rhubble', 31],
+            ])
+
+        transaction.update(
+            'citizens', columns=['email', 'age'],
+            values=[
+                ['phred@exammple.com', 33],
+                ['bharney@example.com', 32],
+            ])
+
+        ...
+
+        transaction.delete('citizens',
+            keyset['bharney@example.com', 'nonesuch@example.com'])
+
+
+Begin a Transaction
+-------------------
+
+.. note::
+
+   Normally, applications will not construct transactions manually.  Rather,
+   consider using :meth:`~Database.run_in_transaction` or the context manager 
+   as described above.
+
+To begin using a transaction manually:
+
+.. code:: python
+
+    transaction = session.transaction()
+
+
+Commit changes for a Transaction
+--------------------------------
+
+.. note::
+
+   Normally, applications will not commit transactions manually.  Rather,
+   consider using :meth:`~Database.run_in_transaction` or the context manager
+   as described above.
+
+After  modifications to be made to table data via the
+:meth:`Transaction.insert`, :meth:`Transaction.update`,
+:meth:`Transaction.insert_or_update`, :meth:`Transaction.replace`, and
+:meth:`Transaction.delete` methods above, send them to
+the back-end by calling :meth:`Transaction.commit`, which makes the ``Commit``
+API call.
+
+.. code:: python
+
+    transaction.commit()
+
+
+Roll back changes for a Transaction
+-----------------------------------
+
+.. note::
+
+   Normally, applications will not roll back transactions manually.  Rather,
+   consider using :meth:`~Database.run_in_transaction` or the context manager
+   as described above.
+
+After describing the modifications to be made to table data via the
+:meth:`Transaction.insert`, :meth:`Transaction.update`,
+:meth:`Transaction.insert_or_update`, :meth:`Transaction.replace`, and
+:meth:`Transaction.delete` methods above, cancel the transaction on the
+the back-end by calling :meth:`Transaction.rollback`, which makes the
+``Rollback`` API call.
+
+.. code:: python
+
+    transaction.rollback()
diff --git a/spanner/docs/usage.html b/spanner/docs/usage.html
new file mode 100644
index 000000000000..9b81d6976cda
--- /dev/null
+++ b/spanner/docs/usage.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <script>
+   window.location.href = "./index.html"
+ </script>
+</head>
+</html>
diff --git a/spanner/google/__init__.py b/spanner/google/__init__.py
new file mode 100644
index 000000000000..2f4b4738aee1
--- /dev/null
+++ b/spanner/google/__init__.py
@@ -0,0 +1,8 @@
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/spanner/google/cloud/__init__.py b/spanner/google/cloud/__init__.py
new file mode 100644
index 000000000000..2f4b4738aee1
--- /dev/null
+++ b/spanner/google/cloud/__init__.py
@@ -0,0 +1,8 @@
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/spanner/google/cloud/spanner.py b/spanner/google/cloud/spanner.py
new file mode 100644
index 000000000000..0b1d3d949f31
--- /dev/null
+++ b/spanner/google/cloud/spanner.py
@@ -0,0 +1,48 @@
+# Copyright 2016 Google LLC 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.
+
+"""Cloud Spanner API package."""
+
+from __future__ import absolute_import
+
+from google.cloud.spanner_v1 import __version__
+from google.cloud.spanner_v1 import AbstractSessionPool
+from google.cloud.spanner_v1 import BurstyPool
+from google.cloud.spanner_v1 import Client
+from google.cloud.spanner_v1 import COMMIT_TIMESTAMP
+from google.cloud.spanner_v1 import enums
+from google.cloud.spanner_v1 import FixedSizePool
+from google.cloud.spanner_v1 import KeyRange
+from google.cloud.spanner_v1 import KeySet
+from google.cloud.spanner_v1 import param_types
+from google.cloud.spanner_v1 import PingingPool
+from google.cloud.spanner_v1 import TransactionPingingPool
+from google.cloud.spanner_v1 import types
+
+
+__all__ = (
+    "__version__",
+    "AbstractSessionPool",
+    "BurstyPool",
+    "Client",
+    "COMMIT_TIMESTAMP",
+    "enums",
+    "FixedSizePool",
+    "KeyRange",
+    "KeySet",
+    "param_types",
+    "PingingPool",
+    "TransactionPingingPool",
+    "types",
+)
diff --git a/spanner/google/cloud/spanner_admin_database_v1/__init__.py b/spanner/google/cloud/spanner_admin_database_v1/__init__.py
new file mode 100644
index 000000000000..3a5b42403c0d
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/__init__.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.spanner_admin_database_v1 import types
+from google.cloud.spanner_admin_database_v1.gapic import database_admin_client
+from google.cloud.spanner_admin_database_v1.gapic import enums
+
+
+class DatabaseAdminClient(database_admin_client.DatabaseAdminClient):
+    __doc__ = database_admin_client.DatabaseAdminClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "DatabaseAdminClient")
diff --git a/spanner/google/cloud/spanner_admin_database_v1/gapic/__init__.py b/spanner/google/cloud/spanner_admin_database_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py b/spanner/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py
new file mode 100644
index 000000000000..6555ec3c8da0
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py
@@ -0,0 +1,1003 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.spanner.admin.database.v1 DatabaseAdmin API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.spanner_admin_database_v1.gapic import database_admin_client_config
+from google.cloud.spanner_admin_database_v1.gapic import enums
+from google.cloud.spanner_admin_database_v1.gapic.transports import (
+    database_admin_grpc_transport,
+)
+from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2
+from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2_grpc
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version
+
+
+class DatabaseAdminClient(object):
+    """
+    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.
+    """
+
+    SERVICE_ADDRESS = "spanner.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.spanner.admin.database.v1.DatabaseAdmin"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            DatabaseAdminClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def database_path(cls, project, instance, database):
+        """Return a fully-qualified database string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/databases/{database}",
+            project=project,
+            instance=instance,
+            database=database,
+        )
+
+    @classmethod
+    def instance_path(cls, project, instance):
+        """Return a fully-qualified instance string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}",
+            project=project,
+            instance=instance,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.DatabaseAdminGrpcTransport,
+                    Callable[[~.Credentials, type], ~.DatabaseAdminGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = database_admin_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=database_admin_grpc_transport.DatabaseAdminGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = database_admin_grpc_transport.DatabaseAdminGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_databases(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists Cloud Spanner databases.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_databases(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_databases(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The instance whose databases should be listed. Values are of
+                the form ``projects/<project>/instances/<instance>``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.spanner_admin_database_v1.types.Database` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_databases" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_databases"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_databases,
+                default_retry=self._method_configs["ListDatabases"].retry,
+                default_timeout=self._method_configs["ListDatabases"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_database_admin_pb2.ListDatabasesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_databases"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="databases",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_database(
+        self,
+        parent,
+        create_statement,
+        extra_statements=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new Cloud Spanner database and starts to prepare it for
+        serving. The returned ``long-running operation`` will have a name of the
+        format ``<database_name>/operations/<operation_id>`` and can be used to
+        track preparation of the database. The ``metadata`` field type is
+        ``CreateDatabaseMetadata``. The ``response`` field type is ``Database``,
+        if successful.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> parent = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `create_statement`:
+            >>> create_statement = ''
+            >>>
+            >>> response = client.create_database(parent, create_statement)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. The name of the instance that will serve the new database.
+                Values are of the form ``projects/<project>/instances/<instance>``.
+            create_statement (str): 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 (`````).
+            extra_statements (list[str]): An optional 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_database" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_database"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_database,
+                default_retry=self._method_configs["CreateDatabase"].retry,
+                default_timeout=self._method_configs["CreateDatabase"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_database_admin_pb2.CreateDatabaseRequest(
+            parent=parent,
+            create_statement=create_statement,
+            extra_statements=extra_statements,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_database"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            spanner_database_admin_pb2.Database,
+            metadata_type=spanner_database_admin_pb2.CreateDatabaseMetadata,
+        )
+
+    def get_database(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the state of a Cloud Spanner database.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> name = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> response = client.get_database(name)
+
+        Args:
+            name (str): Required. The name of the requested database. Values are of the form
+                ``projects/<project>/instances/<instance>/databases/<database>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types.Database` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_database" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_database"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_database,
+                default_retry=self._method_configs["GetDatabase"].retry,
+                default_timeout=self._method_configs["GetDatabase"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_database_admin_pb2.GetDatabaseRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_database"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_database_ddl(
+        self,
+        database,
+        statements,
+        operation_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the schema of a Cloud Spanner database by
+        creating/altering/dropping tables, columns, indexes, etc. The returned
+        ``long-running operation`` will have a name of the format
+        ``<database_name>/operations/<operation_id>`` and can be used to track
+        execution of the schema change(s). The ``metadata`` field type is
+        ``UpdateDatabaseDdlMetadata``. The operation has no response.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> database = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `statements`:
+            >>> statements = []
+            >>>
+            >>> response = client.update_database_ddl(database, statements)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            database (str): Required. The database to update.
+            statements (list[str]): DDL statements to be applied to the database.
+            operation_id (str): If empty, the new update request is assigned an automatically-generated
+                operation ID. Otherwise, ``operation_id`` is used to construct the name
+                of the resulting ``Operation``.
+
+                Specifying an explicit operation ID simplifies determining whether the
+                statements were executed in the event that the ``UpdateDatabaseDdl``
+                call is replayed, or the return value is otherwise lost: the
+                ``database`` and ``operation_id`` fields can be combined to form the
+                ``name`` of the resulting ``longrunning.Operation``:
+                ``<database>/operations/<operation_id>``.
+
+                ``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`` returns ``ALREADY_EXISTS``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_database_ddl" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_database_ddl"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_database_ddl,
+                default_retry=self._method_configs["UpdateDatabaseDdl"].retry,
+                default_timeout=self._method_configs["UpdateDatabaseDdl"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_database_admin_pb2.UpdateDatabaseDdlRequest(
+            database=database, statements=statements, operation_id=operation_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["update_database_ddl"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=spanner_database_admin_pb2.UpdateDatabaseDdlMetadata,
+        )
+
+    def drop_database(
+        self,
+        database,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Drops (aka deletes) a Cloud Spanner database.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> database = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> client.drop_database(database)
+
+        Args:
+            database (str): Required. The database to be dropped.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "drop_database" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "drop_database"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.drop_database,
+                default_retry=self._method_configs["DropDatabase"].retry,
+                default_timeout=self._method_configs["DropDatabase"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_database_admin_pb2.DropDatabaseRequest(database=database)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["drop_database"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_database_ddl(
+        self,
+        database,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns the schema of a Cloud Spanner database as a list of formatted
+        DDL statements. This method does not show pending schema updates, those
+        may be queried using the ``Operations`` API.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> database = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> response = client.get_database_ddl(database)
+
+        Args:
+            database (str): Required. The database whose schema we wish to get.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types.GetDatabaseDdlResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_database_ddl" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_database_ddl"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_database_ddl,
+                default_retry=self._method_configs["GetDatabaseDdl"].retry,
+                default_timeout=self._method_configs["GetDatabaseDdl"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_database_admin_pb2.GetDatabaseDdlRequest(database=database)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_database_ddl"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on a database resource. Replaces any
+        existing policy.
+
+        Authorization requires ``spanner.databases.setIamPolicy`` permission on
+        ``resource``.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> resource = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_database_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a database resource. Returns an empty
+        policy if a database exists but does not have a policy set.
+
+        Authorization requires ``spanner.databases.getIamPolicy`` permission on
+        ``resource``.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> resource = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.spanner_admin_database_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_database_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns permissions that the caller has on the specified database
+        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.
+
+        Example:
+            >>> from google.cloud import spanner_admin_database_v1
+            >>>
+            >>> client = spanner_admin_database_v1.DatabaseAdminClient()
+            >>>
+            >>> resource = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_database_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/spanner/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py b/spanner/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py
new file mode 100644
index 000000000000..46d60f01919e
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py
@@ -0,0 +1,68 @@
+config = {
+    "interfaces": {
+        "google.spanner.admin.database.v1.DatabaseAdmin": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListDatabases": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateDatabase": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDatabase": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateDatabaseDdl": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DropDatabase": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetDatabaseDdl": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/spanner/google/cloud/spanner_admin_database_v1/gapic/enums.py b/spanner/google/cloud/spanner_admin_database_v1/gapic/enums.py
new file mode 100644
index 000000000000..eab6503a65bc
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/gapic/enums.py
@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Database(object):
+    class State(enum.IntEnum):
+        """
+        Indicates the current state of the database.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Not specified.
+          CREATING (int): The database is still being created. Operations on the database may fail
+          with ``FAILED_PRECONDITION`` in this state.
+          READY (int): The database is fully created and ready for use.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATING = 1
+        READY = 2
diff --git a/spanner/google/cloud/spanner_admin_database_v1/gapic/transports/__init__.py b/spanner/google/cloud/spanner_admin_database_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py b/spanner/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py
new file mode 100644
index 000000000000..7308d265ea82
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2_grpc
+
+
+class DatabaseAdminGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.spanner.admin.database.v1 DatabaseAdmin API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/spanner.admin",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="spanner.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "database_admin_stub": spanner_database_admin_pb2_grpc.DatabaseAdminStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="spanner.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_databases(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.list_databases`.
+
+        Lists Cloud Spanner databases.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].ListDatabases
+
+    @property
+    def create_database(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.create_database`.
+
+        Creates a new Cloud Spanner database and starts to prepare it for
+        serving. The returned ``long-running operation`` will have a name of the
+        format ``<database_name>/operations/<operation_id>`` and can be used to
+        track preparation of the database. The ``metadata`` field type is
+        ``CreateDatabaseMetadata``. The ``response`` field type is ``Database``,
+        if successful.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].CreateDatabase
+
+    @property
+    def get_database(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.get_database`.
+
+        Gets the state of a Cloud Spanner database.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].GetDatabase
+
+    @property
+    def update_database_ddl(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.update_database_ddl`.
+
+        Updates the schema of a Cloud Spanner database by
+        creating/altering/dropping tables, columns, indexes, etc. The returned
+        ``long-running operation`` will have a name of the format
+        ``<database_name>/operations/<operation_id>`` and can be used to track
+        execution of the schema change(s). The ``metadata`` field type is
+        ``UpdateDatabaseDdlMetadata``. The operation has no response.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].UpdateDatabaseDdl
+
+    @property
+    def drop_database(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.drop_database`.
+
+        Drops (aka deletes) a Cloud Spanner database.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].DropDatabase
+
+    @property
+    def get_database_ddl(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.get_database_ddl`.
+
+        Returns the schema of a Cloud Spanner database as a list of formatted
+        DDL statements. This method does not show pending schema updates, those
+        may be queried using the ``Operations`` API.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].GetDatabaseDdl
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.set_iam_policy`.
+
+        Sets the access control policy on a database resource. Replaces any
+        existing policy.
+
+        Authorization requires ``spanner.databases.setIamPolicy`` permission on
+        ``resource``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.get_iam_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.
+
+        Authorization requires ``spanner.databases.getIamPolicy`` permission on
+        ``resource``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`DatabaseAdminClient.test_iam_permissions`.
+
+        Returns permissions that the caller has on the specified database
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["database_admin_stub"].TestIamPermissions
diff --git a/spanner/google/cloud/spanner_admin_database_v1/proto/__init__.py b/spanner/google/cloud/spanner_admin_database_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto b/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto
new file mode 100644
index 000000000000..491606e6f711
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto
@@ -0,0 +1,317 @@
+// 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.spanner.admin.database.v1;
+
+import "google/api/annotations.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";
+
+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 = "SpannerDatabaseAdminProto";
+option java_package = "com.google.spanner.admin.database.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Database\\V1";
+
+// 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.
+service DatabaseAdmin {
+  // Lists Cloud Spanner databases.
+  rpc ListDatabases(ListDatabasesRequest) returns (ListDatabasesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/instances/*}/databases"
+    };
+  }
+
+  // Creates a new Cloud Spanner database and starts to prepare it for serving.
+  // The returned [long-running operation][google.longrunning.Operation] will
+  // have a name of the format `<database_name>/operations/<operation_id>` 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
+  // [Database][google.spanner.admin.database.v1.Database], if successful.
+  rpc CreateDatabase(CreateDatabaseRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/instances/*}/databases"
+      body: "*"
+    };
+  }
+
+  // Gets the state of a Cloud Spanner database.
+  rpc GetDatabase(GetDatabaseRequest) returns (Database) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instances/*/databases/*}"
+    };
+  }
+
+  // Updates the schema of a Cloud Spanner database by
+  // creating/altering/dropping tables, columns, indexes, etc. The returned
+  // [long-running operation][google.longrunning.Operation] will have a name of
+  // the format `<database_name>/operations/<operation_id>` 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) {
+    option (google.api.http) = {
+      patch: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
+      body: "*"
+    };
+  }
+
+  // Drops (aka deletes) a Cloud Spanner database.
+  rpc DropDatabase(DropDatabaseRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{database=projects/*/instances/*/databases/*}"
+    };
+  }
+
+  // Returns the schema of a Cloud Spanner database as a list of formatted
+  // DDL statements. This method does not show pending schema updates, those may
+  // be queried using the [Operations][google.longrunning.Operations] API.
+  rpc GetDatabaseDdl(GetDatabaseDdlRequest) returns (GetDatabaseDdlResponse) {
+    option (google.api.http) = {
+      get: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
+    };
+  }
+
+  // Sets the access control policy on a database 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the access control policy for a database resource. Returns an empty
+  // policy if a database 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Returns permissions that the caller has on the specified database 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*/databases/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// A Cloud Spanner database.
+message Database {
+  // Indicates the current state of the database.
+  enum State {
+    // Not specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The database is still being created. Operations on the database may fail
+    // with `FAILED_PRECONDITION` in this state.
+    CREATING = 1;
+
+    // The database is fully created and ready for use.
+    READY = 2;
+  }
+
+  // Required. The name of the database. Values are of the form
+  // `projects/<project>/instances/<instance>/databases/<database>`,
+  // where `<database>` is as specified in the `CREATE DATABASE`
+  // statement. This name can be passed to other API methods to
+  // identify the database.
+  string name = 1;
+
+  // Output only. The current database state.
+  State state = 2;
+}
+
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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].
+  string page_token = 4;
+}
+
+// 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.
+  string next_page_token = 2;
+}
+
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // An optional 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;
+}
+
+// Metadata type for the operation returned by
+// [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
+message CreateDatabaseMetadata {
+  // The database being created.
+  string database = 1;
+}
+
+// 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/<project>/instances/<instance>/databases/<database>`.
+  string name = 1;
+}
+
+// Enqueues the given DDL statements to be applied, in order but not
+// necessarily all at once, to the database schema at some point (or
+// points) in the future. The server checks that the statements
+// are executable (syntactically valid, name tables that exist, etc.)
+// before enqueueing them, but they may still fail upon
+// later execution (e.g., if a statement from another batch of
+// statements is applied first and it conflicts in some way, or if
+// there is some data-related problem like a `NULL` value in a column to
+// which `NOT NULL` would be added). If a statement fails, all
+// subsequent statements in the batch are automatically cancelled.
+//
+// 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.
+message UpdateDatabaseDdlRequest {
+  // Required. The database to update.
+  string database = 1;
+
+  // DDL statements to be applied to the database.
+  repeated string statements = 2;
+
+  // If empty, the new update request is assigned an
+  // automatically-generated operation ID. Otherwise, `operation_id`
+  // is used to construct the name of the resulting
+  // [Operation][google.longrunning.Operation].
+  //
+  // 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
+  // [name][google.longrunning.Operation.name] of the resulting
+  // [longrunning.Operation][google.longrunning.Operation]:
+  // `<database>/operations/<operation_id>`.
+  //
+  // `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`.
+  string operation_id = 3;
+}
+
+// Metadata type for the operation returned by
+// [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl].
+message UpdateDatabaseDdlMetadata {
+  // The database being modified.
+  string database = 1;
+
+  // For an update this list contains all the statements. For an
+  // individual statement, this list contains only that statement.
+  repeated string statements = 2;
+
+  // Reports the commit timestamps of all statements that have
+  // succeeded so far, where `commit_timestamps[i]` is the commit
+  // timestamp for the statement `statements[i]`.
+  repeated google.protobuf.Timestamp commit_timestamps = 3;
+}
+
+// The request for
+// [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
+message DropDatabaseRequest {
+  // Required. The database to be dropped.
+  string database = 1;
+}
+
+// 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;
+}
+
+// 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;
+}
diff --git a/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py b/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py
new file mode 100644
index 000000000000..bce18741da55
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py
@@ -0,0 +1,1113 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto",
+    package="google.spanner.admin.database.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n$com.google.spanner.admin.database.v1B\031SpannerDatabaseAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1"
+    ),
+    serialized_pb=_b(
+        '\nIgoogle/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto\x12 google.spanner.admin.database.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x92\x01\n\x08\x44\x61tabase\x12\x0c\n\x04name\x18\x01 \x01(\t\x12?\n\x05state\x18\x02 \x01(\x0e\x32\x30.google.spanner.admin.database.v1.Database.State"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02"M\n\x14ListDatabasesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"o\n\x15ListDatabasesResponse\x12=\n\tdatabases\x18\x01 \x03(\x0b\x32*.google.spanner.admin.database.v1.Database\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"[\n\x15\x43reateDatabaseRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x18\n\x10\x63reate_statement\x18\x02 \x01(\t\x12\x18\n\x10\x65xtra_statements\x18\x03 \x03(\t"*\n\x16\x43reateDatabaseMetadata\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t""\n\x12GetDatabaseRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"V\n\x18UpdateDatabaseDdlRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x12\n\nstatements\x18\x02 \x03(\t\x12\x14\n\x0coperation_id\x18\x03 \x01(\t"x\n\x19UpdateDatabaseDdlMetadata\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x12\n\nstatements\x18\x02 \x03(\t\x12\x35\n\x11\x63ommit_timestamps\x18\x03 \x03(\x0b\x32\x1a.google.protobuf.Timestamp"\'\n\x13\x44ropDatabaseRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t")\n\x15GetDatabaseDdlRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t",\n\x16GetDatabaseDdlResponse\x12\x12\n\nstatements\x18\x01 \x03(\t2\x95\x0c\n\rDatabaseAdmin\x12\xb7\x01\n\rListDatabases\x12\x36.google.spanner.admin.database.v1.ListDatabasesRequest\x1a\x37.google.spanner.admin.database.v1.ListDatabasesResponse"5\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/instances/*}/databases\x12\xa2\x01\n\x0e\x43reateDatabase\x12\x37.google.spanner.admin.database.v1.CreateDatabaseRequest\x1a\x1d.google.longrunning.Operation"8\x82\xd3\xe4\x93\x02\x32"-/v1/{parent=projects/*/instances/*}/databases:\x01*\x12\xa6\x01\n\x0bGetDatabase\x12\x34.google.spanner.admin.database.v1.GetDatabaseRequest\x1a*.google.spanner.admin.database.v1.Database"5\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/instances/*/databases/*}\x12\xb0\x01\n\x11UpdateDatabaseDdl\x12:.google.spanner.admin.database.v1.UpdateDatabaseDdlRequest\x1a\x1d.google.longrunning.Operation"@\x82\xd3\xe4\x93\x02:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\x01*\x12\x98\x01\n\x0c\x44ropDatabase\x12\x35.google.spanner.admin.database.v1.DropDatabaseRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02\x33*1/v1/{database=projects/*/instances/*/databases/*}\x12\xc2\x01\n\x0eGetDatabaseDdl\x12\x37.google.spanner.admin.database.v1.GetDatabaseDdlRequest\x1a\x38.google.spanner.admin.database.v1.GetDatabaseDdlResponse"=\x82\xd3\xe4\x93\x02\x37\x12\x35/v1/{database=projects/*/instances/*/databases/*}/ddl\x12\x94\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"I\x82\xd3\xe4\x93\x02\x43">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\x01*\x12\x94\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"I\x82\xd3\xe4\x93\x02\x43">/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\x01*\x12\xba\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"O\x82\xd3\xe4\x93\x02I"D/v1/{resource=projects/*/instances/*/databases/*}:testIamPermissions:\x01*B\xdf\x01\n$com.google.spanner.admin.database.v1B\x19SpannerDatabaseAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_DATABASE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.spanner.admin.database.v1.Database.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=392,
+    serialized_end=447,
+)
+_sym_db.RegisterEnumDescriptor(_DATABASE_STATE)
+
+
+_DATABASE = _descriptor.Descriptor(
+    name="Database",
+    full_name="google.spanner.admin.database.v1.Database",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.database.v1.Database.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.spanner.admin.database.v1.Database.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DATABASE_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=301,
+    serialized_end=447,
+)
+
+
+_LISTDATABASESREQUEST = _descriptor.Descriptor(
+    name="ListDatabasesRequest",
+    full_name="google.spanner.admin.database.v1.ListDatabasesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.spanner.admin.database.v1.ListDatabasesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.spanner.admin.database.v1.ListDatabasesRequest.page_size",
+            index=1,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.spanner.admin.database.v1.ListDatabasesRequest.page_token",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=449,
+    serialized_end=526,
+)
+
+
+_LISTDATABASESRESPONSE = _descriptor.Descriptor(
+    name="ListDatabasesResponse",
+    full_name="google.spanner.admin.database.v1.ListDatabasesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="databases",
+            full_name="google.spanner.admin.database.v1.ListDatabasesResponse.databases",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.spanner.admin.database.v1.ListDatabasesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=528,
+    serialized_end=639,
+)
+
+
+_CREATEDATABASEREQUEST = _descriptor.Descriptor(
+    name="CreateDatabaseRequest",
+    full_name="google.spanner.admin.database.v1.CreateDatabaseRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.spanner.admin.database.v1.CreateDatabaseRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_statement",
+            full_name="google.spanner.admin.database.v1.CreateDatabaseRequest.create_statement",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="extra_statements",
+            full_name="google.spanner.admin.database.v1.CreateDatabaseRequest.extra_statements",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=641,
+    serialized_end=732,
+)
+
+
+_CREATEDATABASEMETADATA = _descriptor.Descriptor(
+    name="CreateDatabaseMetadata",
+    full_name="google.spanner.admin.database.v1.CreateDatabaseMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.admin.database.v1.CreateDatabaseMetadata.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=734,
+    serialized_end=776,
+)
+
+
+_GETDATABASEREQUEST = _descriptor.Descriptor(
+    name="GetDatabaseRequest",
+    full_name="google.spanner.admin.database.v1.GetDatabaseRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.database.v1.GetDatabaseRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=778,
+    serialized_end=812,
+)
+
+
+_UPDATEDATABASEDDLREQUEST = _descriptor.Descriptor(
+    name="UpdateDatabaseDdlRequest",
+    full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="statements",
+            full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.statements",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="operation_id",
+            full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=814,
+    serialized_end=900,
+)
+
+
+_UPDATEDATABASEDDLMETADATA = _descriptor.Descriptor(
+    name="UpdateDatabaseDdlMetadata",
+    full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="statements",
+            full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata.statements",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commit_timestamps",
+            full_name="google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata.commit_timestamps",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=902,
+    serialized_end=1022,
+)
+
+
+_DROPDATABASEREQUEST = _descriptor.Descriptor(
+    name="DropDatabaseRequest",
+    full_name="google.spanner.admin.database.v1.DropDatabaseRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.admin.database.v1.DropDatabaseRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1024,
+    serialized_end=1063,
+)
+
+
+_GETDATABASEDDLREQUEST = _descriptor.Descriptor(
+    name="GetDatabaseDdlRequest",
+    full_name="google.spanner.admin.database.v1.GetDatabaseDdlRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.admin.database.v1.GetDatabaseDdlRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1065,
+    serialized_end=1106,
+)
+
+
+_GETDATABASEDDLRESPONSE = _descriptor.Descriptor(
+    name="GetDatabaseDdlResponse",
+    full_name="google.spanner.admin.database.v1.GetDatabaseDdlResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="statements",
+            full_name="google.spanner.admin.database.v1.GetDatabaseDdlResponse.statements",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1108,
+    serialized_end=1152,
+)
+
+_DATABASE.fields_by_name["state"].enum_type = _DATABASE_STATE
+_DATABASE_STATE.containing_type = _DATABASE
+_LISTDATABASESRESPONSE.fields_by_name["databases"].message_type = _DATABASE
+_UPDATEDATABASEDDLMETADATA.fields_by_name[
+    "commit_timestamps"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["Database"] = _DATABASE
+DESCRIPTOR.message_types_by_name["ListDatabasesRequest"] = _LISTDATABASESREQUEST
+DESCRIPTOR.message_types_by_name["ListDatabasesResponse"] = _LISTDATABASESRESPONSE
+DESCRIPTOR.message_types_by_name["CreateDatabaseRequest"] = _CREATEDATABASEREQUEST
+DESCRIPTOR.message_types_by_name["CreateDatabaseMetadata"] = _CREATEDATABASEMETADATA
+DESCRIPTOR.message_types_by_name["GetDatabaseRequest"] = _GETDATABASEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateDatabaseDdlRequest"] = _UPDATEDATABASEDDLREQUEST
+DESCRIPTOR.message_types_by_name[
+    "UpdateDatabaseDdlMetadata"
+] = _UPDATEDATABASEDDLMETADATA
+DESCRIPTOR.message_types_by_name["DropDatabaseRequest"] = _DROPDATABASEREQUEST
+DESCRIPTOR.message_types_by_name["GetDatabaseDdlRequest"] = _GETDATABASEDDLREQUEST
+DESCRIPTOR.message_types_by_name["GetDatabaseDdlResponse"] = _GETDATABASEDDLRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Database = _reflection.GeneratedProtocolMessageType(
+    "Database",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DATABASE,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""A Cloud Spanner database.
+  
+  
+  Attributes:
+      name:
+          Required. The name of the database. Values are of the form ``p
+          rojects/<project>/instances/<instance>/databases/<database>``,
+          where ``<database>`` is as specified in the ``CREATE
+          DATABASE`` statement. This name can be passed to other API
+          methods to identify the database.
+      state:
+          Output only. The current database state.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.Database)
+    ),
+)
+_sym_db.RegisterMessage(Database)
+
+ListDatabasesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListDatabasesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATABASESREQUEST,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The request for
+  [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
+  
+  
+  Attributes:
+      parent:
+          Required. The instance whose databases should be listed.
+          Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      page_size:
+          Number of databases to be returned in the response. If 0 or
+          less, defaults to the server's maximum allowed page size.
+      page_token:
+          If non-empty, ``page_token`` should contain a [next\_page\_tok
+          en][google.spanner.admin.database.v1.ListDatabasesResponse.nex
+          t\_page\_token] from a previous [ListDatabasesResponse][google
+          .spanner.admin.database.v1.ListDatabasesResponse].
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabasesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListDatabasesRequest)
+
+ListDatabasesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListDatabasesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTDATABASESRESPONSE,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The response for
+  [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
+  
+  
+  Attributes:
+      databases:
+          Databases that matched the request.
+      next_page_token:
+          ``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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabasesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListDatabasesResponse)
+
+CreateDatabaseRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateDatabaseRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDATABASEREQUEST,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The request for
+  [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the instance that will serve the new
+          database. Values are of the form
+          ``projects/<project>/instances/<instance>``.
+      create_statement:
+          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 (`````).
+      extra_statements:
+          An optional 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateDatabaseRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateDatabaseRequest)
+
+CreateDatabaseMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateDatabaseMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEDATABASEMETADATA,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""Metadata type for the operation returned by
+  [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
+  
+  
+  Attributes:
+      database:
+          The database being created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateDatabaseMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateDatabaseMetadata)
+
+GetDatabaseRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDatabaseRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATABASEREQUEST,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The request for
+  [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the requested database. Values are of
+          the form ``projects/<project>/instances/<instance>/databases/<
+          database>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDatabaseRequest)
+
+UpdateDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateDatabaseDdlRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDATABASEDDLREQUEST,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""Enqueues the given DDL statements to be applied, in order but not
+  necessarily all at once, to the database schema at some point (or
+  points) in the future. The server checks that the statements are
+  executable (syntactically valid, name tables that exist, etc.) before
+  enqueueing them, but they may still fail upon later execution (e.g., if
+  a statement from another batch of statements is applied first and it
+  conflicts in some way, or if there is some data-related problem like a
+  ``NULL`` value in a column to which ``NOT NULL`` would be added). If a
+  statement fails, all subsequent statements in the batch are
+  automatically cancelled.
+  
+  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.
+  
+  
+  Attributes:
+      database:
+          Required. The database to update.
+      statements:
+          DDL statements to be applied to the database.
+      operation_id:
+          If empty, the new update request is assigned an automatically-
+          generated operation ID. Otherwise, ``operation_id`` is used to
+          construct the name of the resulting
+          [Operation][google.longrunning.Operation].  Specifying an
+          explicit operation ID simplifies determining whether the
+          statements were executed in the event that the [UpdateDatabase
+          Ddl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateData
+          baseDdl] call is replayed, or the return value is otherwise
+          lost: the [database][google.spanner.admin.database.v1.UpdateDa
+          tabaseDdlRequest.database] and ``operation_id`` fields can be
+          combined to form the [name][google.longrunning.Operation.name]
+          of the resulting
+          [longrunning.Operation][google.longrunning.Operation]:
+          ``<database>/operations/<operation_id>``.  ``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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDatabaseDdlRequest)
+
+UpdateDatabaseDdlMetadata = _reflection.GeneratedProtocolMessageType(
+    "UpdateDatabaseDdlMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEDATABASEDDLMETADATA,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""Metadata type for the operation returned by
+  [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl].
+  
+  
+  Attributes:
+      database:
+          The database being modified.
+      statements:
+          For an update this list contains all the statements. For an
+          individual statement, this list contains only that statement.
+      commit_timestamps:
+          Reports the commit timestamps of all statements that have
+          succeeded so far, where ``commit_timestamps[i]`` is the commit
+          timestamp for the statement ``statements[i]``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata)
+    ),
+)
+_sym_db.RegisterMessage(UpdateDatabaseDdlMetadata)
+
+DropDatabaseRequest = _reflection.GeneratedProtocolMessageType(
+    "DropDatabaseRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DROPDATABASEREQUEST,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The request for
+  [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
+  
+  
+  Attributes:
+      database:
+          Required. The database to be dropped.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DropDatabaseRequest)
+    ),
+)
+_sym_db.RegisterMessage(DropDatabaseRequest)
+
+GetDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType(
+    "GetDatabaseDdlRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATABASEDDLREQUEST,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The request for
+  [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
+  
+  
+  Attributes:
+      database:
+          Required. The database whose schema we wish to get.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetDatabaseDdlRequest)
+
+GetDatabaseDdlResponse = _reflection.GeneratedProtocolMessageType(
+    "GetDatabaseDdlResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETDATABASEDDLRESPONSE,
+        __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2",
+        __doc__="""The response for
+  [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
+  
+  
+  Attributes:
+      statements:
+          A list of formatted DDL statements defining the schema of the
+          database specified in the request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlResponse)
+    ),
+)
+_sym_db.RegisterMessage(GetDatabaseDdlResponse)
+
+
+DESCRIPTOR._options = None
+
+_DATABASEADMIN = _descriptor.ServiceDescriptor(
+    name="DatabaseAdmin",
+    full_name="google.spanner.admin.database.v1.DatabaseAdmin",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1155,
+    serialized_end=2712,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListDatabases",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases",
+            index=0,
+            containing_service=None,
+            input_type=_LISTDATABASESREQUEST,
+            output_type=_LISTDATABASESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1/{parent=projects/*/instances/*}/databases"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateDatabase",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase",
+            index=1,
+            containing_service=None,
+            input_type=_CREATEDATABASEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0022"-/v1/{parent=projects/*/instances/*}/databases:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDatabase",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase",
+            index=2,
+            containing_service=None,
+            input_type=_GETDATABASEREQUEST,
+            output_type=_DATABASE,
+            serialized_options=_b(
+                "\202\323\344\223\002/\022-/v1/{name=projects/*/instances/*/databases/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateDatabaseDdl",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEDATABASEDDLREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DropDatabase",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase",
+            index=4,
+            containing_service=None,
+            input_type=_DROPDATABASEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0023*1/v1/{database=projects/*/instances/*/databases/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetDatabaseDdl",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl",
+            index=5,
+            containing_service=None,
+            input_type=_GETDATABASEDDLREQUEST,
+            output_type=_GETDATABASEDDLRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0027\0225/v1/{database=projects/*/instances/*/databases/*}/ddl"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy",
+            index=6,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002C">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.GetIamPolicy",
+            index=7,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002C">/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.spanner.admin.database.v1.DatabaseAdmin.TestIamPermissions",
+            index=8,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002I"D/v1/{resource=projects/*/instances/*/databases/*}:testIamPermissions:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_DATABASEADMIN)
+
+DESCRIPTOR.services_by_name["DatabaseAdmin"] = _DATABASEADMIN
+
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py b/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py
new file mode 100644
index 000000000000..64b083bfd93c
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py
@@ -0,0 +1,228 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.spanner_admin_database_v1.proto import (
+    spanner_database_admin_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class DatabaseAdminStub(object):
+    """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.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListDatabases = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/ListDatabases",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.ListDatabasesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.ListDatabasesResponse.FromString,
+        )
+        self.CreateDatabase = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/CreateDatabase",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.CreateDatabaseRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.GetDatabase = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetDatabase",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.GetDatabaseRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.Database.FromString,
+        )
+        self.UpdateDatabaseDdl = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/UpdateDatabaseDdl",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.UpdateDatabaseDdlRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DropDatabase = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/DropDatabase",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.DropDatabaseRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetDatabaseDdl = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetDatabaseDdl",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.GetDatabaseDdlRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.GetDatabaseDdlResponse.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.spanner.admin.database.v1.DatabaseAdmin/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+
+
+class DatabaseAdminServicer(object):
+    """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.
+  """
+
+    def ListDatabases(self, request, context):
+        """Lists Cloud Spanner databases.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateDatabase(self, request, context):
+        """Creates a new Cloud Spanner database and starts to prepare it for serving.
+    The returned [long-running operation][google.longrunning.Operation] will
+    have a name of the format `<database_name>/operations/<operation_id>` 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
+    [Database][google.spanner.admin.database.v1.Database], if successful.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDatabase(self, request, context):
+        """Gets the state of a Cloud Spanner database.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateDatabaseDdl(self, request, context):
+        """Updates the schema of a Cloud Spanner database by
+    creating/altering/dropping tables, columns, indexes, etc. The returned
+    [long-running operation][google.longrunning.Operation] will have a name of
+    the format `<database_name>/operations/<operation_id>` 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DropDatabase(self, request, context):
+        """Drops (aka deletes) a Cloud Spanner database.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetDatabaseDdl(self, request, context):
+        """Returns the schema of a Cloud Spanner database as a list of formatted
+    DDL statements. This method does not show pending schema updates, those may
+    be queried using the [Operations][google.longrunning.Operations] API.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on a database resource. Replaces any
+    existing policy.
+
+    Authorization requires `spanner.databases.setIamPolicy` permission on
+    [resource][google.iam.v1.SetIamPolicyRequest.resource].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for a database resource. Returns an empty
+    policy if a database exists but does not have a policy set.
+
+    Authorization requires `spanner.databases.getIamPolicy` permission on
+    [resource][google.iam.v1.GetIamPolicyRequest.resource].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns permissions that the caller has on the specified database 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_DatabaseAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListDatabases": grpc.unary_unary_rpc_method_handler(
+            servicer.ListDatabases,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.ListDatabasesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.ListDatabasesResponse.SerializeToString,
+        ),
+        "CreateDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateDatabase,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.CreateDatabaseRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "GetDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDatabase,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.GetDatabaseRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.Database.SerializeToString,
+        ),
+        "UpdateDatabaseDdl": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateDatabaseDdl,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.UpdateDatabaseDdlRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DropDatabase": grpc.unary_unary_rpc_method_handler(
+            servicer.DropDatabase,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.DropDatabaseRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetDatabaseDdl": grpc.unary_unary_rpc_method_handler(
+            servicer.GetDatabaseDdl,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.GetDatabaseDdlRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_spanner__database__admin__pb2.GetDatabaseDdlResponse.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.spanner.admin.database.v1.DatabaseAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/spanner/google/cloud/spanner_admin_database_v1/types.py b/spanner/google/cloud/spanner_admin_database_v1/types.py
new file mode 100644
index 000000000000..43103a0b6d9d
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_database_v1/types.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.iam.v1.logging import audit_data_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    iam_policy_pb2,
+    policy_pb2,
+    audit_data_pb2,
+    operations_pb2,
+    any_pb2,
+    descriptor_pb2,
+    empty_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [spanner_database_admin_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.spanner_admin_database_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/__init__.py b/spanner/google/cloud/spanner_admin_instance_v1/__init__.py
new file mode 100644
index 000000000000..53f32d3b4705
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/__init__.py
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.spanner_admin_instance_v1 import types
+from google.cloud.spanner_admin_instance_v1.gapic import enums
+from google.cloud.spanner_admin_instance_v1.gapic import instance_admin_client
+
+
+class InstanceAdminClient(instance_admin_client.InstanceAdminClient):
+    __doc__ = instance_admin_client.InstanceAdminClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "InstanceAdminClient")
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/gapic/__init__.py b/spanner/google/cloud/spanner_admin_instance_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/gapic/enums.py b/spanner/google/cloud/spanner_admin_instance_v1/gapic/enums.py
new file mode 100644
index 000000000000..93650fd1f4a8
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/gapic/enums.py
@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Instance(object):
+    class State(enum.IntEnum):
+        """
+        Indicates the current state of the instance.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Not specified.
+          CREATING (int): The instance is still being created. Resources may not be
+          available yet, and operations such as database creation may not
+          work.
+          READY (int): The instance is fully created and ready to do work such as
+          creating databases.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATING = 1
+        READY = 2
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py b/spanner/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py
new file mode 100644
index 000000000000..d66b505a7caf
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py
@@ -0,0 +1,1214 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.spanner.admin.instance.v1 InstanceAdmin API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.spanner_admin_instance_v1.gapic import enums
+from google.cloud.spanner_admin_instance_v1.gapic import instance_admin_client_config
+from google.cloud.spanner_admin_instance_v1.gapic.transports import (
+    instance_admin_grpc_transport,
+)
+from google.cloud.spanner_admin_instance_v1.proto import spanner_instance_admin_pb2
+from google.cloud.spanner_admin_instance_v1.proto import spanner_instance_admin_pb2_grpc
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version
+
+
+class InstanceAdminClient(object):
+    """
+    Cloud Spanner Instance Admin API
+
+    The Cloud Spanner Instance Admin API can be used to create, delete,
+    modify and list instances. Instances are dedicated Cloud Spanner serving
+    and storage resources to be used by Cloud Spanner databases.
+
+    Each instance has a "configuration", which dictates where the
+    serving resources for the Cloud Spanner instance are located (e.g.,
+    US-central, Europe). Configurations are created by Google based on
+    resource availability.
+
+    Cloud Spanner billing is based on the instances that exist and their
+    sizes. After an instance exists, there are no additional
+    per-database or per-operation charges for use of the instance
+    (though there may be additional network bandwidth charges).
+    Instances offer isolation: problems with databases in one instance
+    will not affect other instances. However, within an instance
+    databases can affect each other. For example, if one database in an
+    instance receives a lot of requests and consumes most of the
+    instance resources, fewer resources are available for other
+    databases in that instance, and their performance may suffer.
+    """
+
+    SERVICE_ADDRESS = "spanner.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.spanner.admin.instance.v1.InstanceAdmin"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            InstanceAdminClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def instance_path(cls, project, instance):
+        """Return a fully-qualified instance string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}",
+            project=project,
+            instance=instance,
+        )
+
+    @classmethod
+    def instance_config_path(cls, project, instance_config):
+        """Return a fully-qualified instance_config string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instanceConfigs/{instance_config}",
+            project=project,
+            instance_config=instance_config,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.InstanceAdminGrpcTransport,
+                    Callable[[~.Credentials, type], ~.InstanceAdminGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = instance_admin_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=instance_admin_grpc_transport.InstanceAdminGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = instance_admin_grpc_transport.InstanceAdminGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_instance_configs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the supported instance configurations for a given project.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_instance_configs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_instance_configs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The name of the project for which a list of supported instance
+                configurations is requested. Values are of the form
+                ``projects/<project>``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.spanner_admin_instance_v1.types.InstanceConfig` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_instance_configs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_instance_configs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_instance_configs,
+                default_retry=self._method_configs["ListInstanceConfigs"].retry,
+                default_timeout=self._method_configs["ListInstanceConfigs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.ListInstanceConfigsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_instance_configs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="instance_configs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_instance_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information about a particular instance configuration.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> name = client.instance_config_path('[PROJECT]', '[INSTANCE_CONFIG]')
+            >>>
+            >>> response = client.get_instance_config(name)
+
+        Args:
+            name (str): Required. The name of the requested instance configuration. Values are
+                of the form ``projects/<project>/instanceConfigs/<config>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types.InstanceConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_instance_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_instance_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_instance_config,
+                default_retry=self._method_configs["GetInstanceConfig"].retry,
+                default_timeout=self._method_configs["GetInstanceConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.GetInstanceConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_instance_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_instances(
+        self,
+        parent,
+        page_size=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all instances in the given project.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_instances(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_instances(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The name of the project for which a list of instances is
+                requested. Values are of the form ``projects/<project>``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            filter_ (str): An expression for filtering the results of the request. Filter rules are
+                case insensitive. The fields eligible for filtering are:
+
+                -  ``name``
+                -  ``display_name``
+                -  ``labels.key`` where key is the name of a label
+
+                Some examples of using filters are:
+
+                -  ``name:*`` --> The instance has a name.
+                -  ``name:Howl`` --> The instance's name contains the string "howl".
+                -  ``name:HOWL`` --> Equivalent to above.
+                -  ``NAME:howl`` --> Equivalent to above.
+                -  ``labels.env:*`` --> The instance has the label "env".
+                -  ``labels.env:dev`` --> The instance has the label "env" and the value
+                   of the label contains the string "dev".
+                -  ``name:howl labels.env:dev`` --> The instance's name contains "howl"
+                   and it has the label "env" with its value containing "dev".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.spanner_admin_instance_v1.types.Instance` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_instances" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_instances"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_instances,
+                default_retry=self._method_configs["ListInstances"].retry,
+                default_timeout=self._method_configs["ListInstances"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.ListInstancesRequest(
+            parent=parent, page_size=page_size, filter=filter_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_instances"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="instances",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information about a particular instance.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> response = client.get_instance(name)
+
+        Args:
+            name (str): Required. The name of the requested instance. Values are of the form
+                ``projects/<project>/instances/<instance>``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types.Instance` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_instance,
+                default_retry=self._method_configs["GetInstance"].retry,
+                default_timeout=self._method_configs["GetInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.GetInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_instance(
+        self,
+        parent,
+        instance_id,
+        instance,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates an instance and begins preparing it to begin serving. The
+        returned ``long-running operation`` can be used to track the progress of
+        preparing the new instance. The instance name is assigned by the caller.
+        If the named instance already exists, ``CreateInstance`` returns
+        ``ALREADY_EXISTS``.
+
+        Immediately upon completion of this request:
+
+        -  The instance is readable via the API, with all requested attributes
+           but no allocated resources. Its state is ``CREATING``.
+
+        Until completion of the returned operation:
+
+        -  Cancelling the operation renders the instance immediately unreadable
+           via the API.
+        -  The instance can be deleted.
+        -  All other attempts to modify the instance are rejected.
+
+        Upon completion of the returned operation:
+
+        -  Billing for all successfully-allocated resources begins (some types
+           may have lower than the requested levels).
+        -  Databases can be created in the instance.
+        -  The instance's allocated resource levels are readable via the API.
+        -  The instance's state becomes ``READY``.
+
+        The returned ``long-running operation`` will have a name of the format
+        ``<instance_name>/operations/<operation_id>`` and can be used to track
+        creation of the instance. The ``metadata`` field type is
+        ``CreateInstanceMetadata``. The ``response`` field type is ``Instance``,
+        if successful.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `instance_id`:
+            >>> instance_id = ''
+            >>>
+            >>> # TODO: Initialize `instance`:
+            >>> instance = {}
+            >>>
+            >>> response = client.create_instance(parent, instance_id, instance)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. The name of the project in which to create the instance.
+                Values are of the form ``projects/<project>``.
+            instance_id (str): 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 length.
+            instance (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Instance]): Required. The instance to create. The name may be omitted, but if
+                specified must be ``<parent>/instances/<instance_id>``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_instance_v1.types.Instance`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_instance,
+                default_retry=self._method_configs["CreateInstance"].retry,
+                default_timeout=self._method_configs["CreateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            spanner_instance_admin_pb2.Instance,
+            metadata_type=spanner_instance_admin_pb2.CreateInstanceMetadata,
+        )
+
+    def update_instance(
+        self,
+        instance,
+        field_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates an instance, and begins allocating or releasing resources as
+        requested. The returned ``long-running operation`` can be used to track
+        the progress of updating the instance. If the named instance does not
+        exist, returns ``NOT_FOUND``.
+
+        Immediately upon completion of this request:
+
+        -  For resource types for which a decrease in the instance's allocation
+           has been requested, billing is based on the newly-requested level.
+
+        Until completion of the returned operation:
+
+        -  Cancelling the operation sets its metadata's ``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
+           resource levels.
+
+        Upon completion of the returned operation:
+
+        -  Billing begins for all successfully-allocated resources (some types
+           may have lower than the requested levels).
+        -  All newly-reserved resources are available for serving the instance's
+           tables.
+        -  The instance's new resource levels are readable via the API.
+
+        The returned ``long-running operation`` will have a name of the format
+        ``<instance_name>/operations/<operation_id>`` and can be used to track
+        the instance modification. The ``metadata`` field type is
+        ``UpdateInstanceMetadata``. The ``response`` field type is ``Instance``,
+        if successful.
+
+        Authorization requires ``spanner.instances.update`` permission on
+        resource ``name``.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> # TODO: Initialize `instance`:
+            >>> instance = {}
+            >>>
+            >>> # TODO: Initialize `field_mask`:
+            >>> field_mask = {}
+            >>>
+            >>> response = client.update_instance(instance, field_mask)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            instance (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Instance]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_instance_v1.types.Instance`
+            field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_instance_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_instance,
+                default_retry=self._method_configs["UpdateInstance"].retry,
+                default_timeout=self._method_configs["UpdateInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.UpdateInstanceRequest(
+            instance=instance, field_mask=field_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("instance.name", instance.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["update_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            spanner_instance_admin_pb2.Instance,
+            metadata_type=spanner_instance_admin_pb2.UpdateInstanceMetadata,
+        )
+
+    def delete_instance(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an instance.
+
+        Immediately upon completion of the request:
+
+        -  Billing ceases for all of the instance's reserved resources.
+
+        Soon afterward:
+
+        -  The instance and *all of its databases* immediately and irrevocably
+           disappear from the API. All data in the databases is permanently
+           deleted.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> name = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> client.delete_instance(name)
+
+        Args:
+            name (str): Required. The name of the instance to be deleted. Values are of the form
+                ``projects/<project>/instances/<instance>``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_instance" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_instance"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_instance,
+                default_retry=self._method_configs["DeleteInstance"].retry,
+                default_timeout=self._method_configs["DeleteInstance"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_instance_admin_pb2.DeleteInstanceRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_instance"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy on an instance resource. Replaces any
+        existing policy.
+
+        Authorization requires ``spanner.instances.setIamPolicy`` on
+        ``resource``.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> resource = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_instance_v1.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for an instance resource. Returns an
+        empty policy if an instance exists but does not have a policy set.
+
+        Authorization requires ``spanner.instances.getIamPolicy`` on
+        ``resource``.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> resource = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_admin_instance_v1.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns permissions that the caller has on the specified instance
+        resource.
+
+        Attempting this RPC on a non-existent Cloud Spanner instance resource
+        will 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.
+
+        Example:
+            >>> from google.cloud import spanner_admin_instance_v1
+            >>>
+            >>> client = spanner_admin_instance_v1.InstanceAdminClient()
+            >>>
+            >>> resource = client.instance_path('[PROJECT]', '[INSTANCE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_admin_instance_v1.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client_config.py b/spanner/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client_config.py
new file mode 100644
index 000000000000..4331f879de11
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client_config.py
@@ -0,0 +1,73 @@
+config = {
+    "interfaces": {
+        "google.spanner.admin.instance.v1.InstanceAdmin": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListInstanceConfigs": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetInstanceConfig": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListInstances": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetInstance": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateInstance": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateInstance": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteInstance": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/gapic/transports/__init__.py b/spanner/google/cloud/spanner_admin_instance_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py b/spanner/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py
new file mode 100644
index 000000000000..18da775b6d8c
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py
@@ -0,0 +1,340 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.spanner_admin_instance_v1.proto import spanner_instance_admin_pb2_grpc
+
+
+class InstanceAdminGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.spanner.admin.instance.v1 InstanceAdmin API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/spanner.admin",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="spanner.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "instance_admin_stub": spanner_instance_admin_pb2_grpc.InstanceAdminStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="spanner.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_instance_configs(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.list_instance_configs`.
+
+        Lists the supported instance configurations for a given project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].ListInstanceConfigs
+
+    @property
+    def get_instance_config(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.get_instance_config`.
+
+        Gets information about a particular instance configuration.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].GetInstanceConfig
+
+    @property
+    def list_instances(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.list_instances`.
+
+        Lists all instances in the given project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].ListInstances
+
+    @property
+    def get_instance(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.get_instance`.
+
+        Gets information about a particular instance.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].GetInstance
+
+    @property
+    def create_instance(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.create_instance`.
+
+        Creates an instance and begins preparing it to begin serving. The
+        returned ``long-running operation`` can be used to track the progress of
+        preparing the new instance. The instance name is assigned by the caller.
+        If the named instance already exists, ``CreateInstance`` returns
+        ``ALREADY_EXISTS``.
+
+        Immediately upon completion of this request:
+
+        -  The instance is readable via the API, with all requested attributes
+           but no allocated resources. Its state is ``CREATING``.
+
+        Until completion of the returned operation:
+
+        -  Cancelling the operation renders the instance immediately unreadable
+           via the API.
+        -  The instance can be deleted.
+        -  All other attempts to modify the instance are rejected.
+
+        Upon completion of the returned operation:
+
+        -  Billing for all successfully-allocated resources begins (some types
+           may have lower than the requested levels).
+        -  Databases can be created in the instance.
+        -  The instance's allocated resource levels are readable via the API.
+        -  The instance's state becomes ``READY``.
+
+        The returned ``long-running operation`` will have a name of the format
+        ``<instance_name>/operations/<operation_id>`` and can be used to track
+        creation of the instance. The ``metadata`` field type is
+        ``CreateInstanceMetadata``. The ``response`` field type is ``Instance``,
+        if successful.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].CreateInstance
+
+    @property
+    def update_instance(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.update_instance`.
+
+        Updates an instance, and begins allocating or releasing resources as
+        requested. The returned ``long-running operation`` can be used to track
+        the progress of updating the instance. If the named instance does not
+        exist, returns ``NOT_FOUND``.
+
+        Immediately upon completion of this request:
+
+        -  For resource types for which a decrease in the instance's allocation
+           has been requested, billing is based on the newly-requested level.
+
+        Until completion of the returned operation:
+
+        -  Cancelling the operation sets its metadata's ``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
+           resource levels.
+
+        Upon completion of the returned operation:
+
+        -  Billing begins for all successfully-allocated resources (some types
+           may have lower than the requested levels).
+        -  All newly-reserved resources are available for serving the instance's
+           tables.
+        -  The instance's new resource levels are readable via the API.
+
+        The returned ``long-running operation`` will have a name of the format
+        ``<instance_name>/operations/<operation_id>`` and can be used to track
+        the instance modification. The ``metadata`` field type is
+        ``UpdateInstanceMetadata``. The ``response`` field type is ``Instance``,
+        if successful.
+
+        Authorization requires ``spanner.instances.update`` permission on
+        resource ``name``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].UpdateInstance
+
+    @property
+    def delete_instance(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.delete_instance`.
+
+        Deletes an instance.
+
+        Immediately upon completion of the request:
+
+        -  Billing ceases for all of the instance's reserved resources.
+
+        Soon afterward:
+
+        -  The instance and *all of its databases* immediately and irrevocably
+           disappear from the API. All data in the databases is permanently
+           deleted.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].DeleteInstance
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.set_iam_policy`.
+
+        Sets the access control policy on an instance resource. Replaces any
+        existing policy.
+
+        Authorization requires ``spanner.instances.setIamPolicy`` on
+        ``resource``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].SetIamPolicy
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.get_iam_policy`.
+
+        Gets the access control policy for an instance resource. Returns an
+        empty policy if an instance exists but does not have a policy set.
+
+        Authorization requires ``spanner.instances.getIamPolicy`` on
+        ``resource``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].GetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`InstanceAdminClient.test_iam_permissions`.
+
+        Returns permissions that the caller has on the specified instance
+        resource.
+
+        Attempting this RPC on a non-existent Cloud Spanner instance resource
+        will 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["instance_admin_stub"].TestIamPermissions
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/proto/__init__.py b/spanner/google/cloud/spanner_admin_instance_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto b/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto
new file mode 100644
index 000000000000..c6ca85c9ce89
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto
@@ -0,0 +1,496 @@
+// 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.spanner.admin.instance.v1;
+
+import "google/api/annotations.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/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.Admin.Instance.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance";
+option java_multiple_files = true;
+option java_outer_classname = "SpannerInstanceAdminProto";
+option java_package = "com.google.spanner.admin.instance.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Instance\\V1";
+
+// Cloud Spanner Instance Admin API
+//
+// The Cloud Spanner Instance Admin API can be used to create, delete,
+// modify and list instances. Instances are dedicated Cloud Spanner serving
+// and storage resources to be used by Cloud Spanner databases.
+//
+// Each instance has a "configuration", which dictates where the
+// serving resources for the Cloud Spanner instance are located (e.g.,
+// US-central, Europe). Configurations are created by Google based on
+// resource availability.
+//
+// Cloud Spanner billing is based on the instances that exist and their
+// sizes. After an instance exists, there are no additional
+// per-database or per-operation charges for use of the instance
+// (though there may be additional network bandwidth charges).
+// Instances offer isolation: problems with databases in one instance
+// will not affect other instances. However, within an instance
+// databases can affect each other. For example, if one database in an
+// instance receives a lot of requests and consumes most of the
+// instance resources, fewer resources are available for other
+// databases in that instance, and their performance may suffer.
+service InstanceAdmin {
+  // Lists the supported instance configurations for a given project.
+  rpc ListInstanceConfigs(ListInstanceConfigsRequest)
+      returns (ListInstanceConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/instanceConfigs"
+    };
+  }
+
+  // Gets information about a particular instance configuration.
+  rpc GetInstanceConfig(GetInstanceConfigRequest) returns (InstanceConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instanceConfigs/*}"
+    };
+  }
+
+  // Lists all instances in the given project.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/instances"
+    };
+  }
+
+  // Gets information about a particular instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Creates an instance and begins preparing it to begin serving. The
+  // returned [long-running operation][google.longrunning.Operation]
+  // can be used to track the progress of preparing the new
+  // instance. The instance name is assigned by the caller. If the
+  // named instance already exists, `CreateInstance` returns
+  // `ALREADY_EXISTS`.
+  //
+  // Immediately upon completion of this request:
+  //
+  //   * The instance is readable via the API, with all requested attributes
+  //     but no allocated resources. Its state is `CREATING`.
+  //
+  // Until completion of the returned operation:
+  //
+  //   * Cancelling the operation renders the instance immediately unreadable
+  //     via the API.
+  //   * The instance can be deleted.
+  //   * All other attempts to modify the instance are rejected.
+  //
+  // Upon completion of the returned operation:
+  //
+  //   * Billing for all successfully-allocated resources begins (some types
+  //     may have lower than the requested levels).
+  //   * Databases can be created in the instance.
+  //   * The instance's allocated resource levels are readable via the API.
+  //   * The instance's state becomes `READY`.
+  //
+  // The returned [long-running operation][google.longrunning.Operation] will
+  // have a name of the format `<instance_name>/operations/<operation_id>` and
+  // can be used to track creation of the instance.  The
+  // [metadata][google.longrunning.Operation.metadata] field type is
+  // [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) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/instances"
+      body: "*"
+    };
+  }
+
+  // Updates an instance, and begins allocating or releasing resources
+  // as requested. The returned [long-running
+  // operation][google.longrunning.Operation] can be used to track the
+  // progress of updating the instance. If the named instance does not
+  // exist, returns `NOT_FOUND`.
+  //
+  // Immediately upon completion of this request:
+  //
+  //   * For resource types for which a decrease in the instance's allocation
+  //     has been requested, billing is based on the newly-requested level.
+  //
+  // 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,
+  //     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
+  //     resource levels.
+  //
+  // Upon completion of the returned operation:
+  //
+  //   * Billing begins for all successfully-allocated resources (some types
+  //     may have lower than the requested levels).
+  //   * All newly-reserved resources are available for serving the instance's
+  //     tables.
+  //   * The instance's new resource levels are readable via the API.
+  //
+  // The returned [long-running operation][google.longrunning.Operation] will
+  // have a name of the format `<instance_name>/operations/<operation_id>` and
+  // can be used to track the instance modification.  The
+  // [metadata][google.longrunning.Operation.metadata] field type is
+  // [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata].
+  // The [response][google.longrunning.Operation.response] field type is
+  // [Instance][google.spanner.admin.instance.v1.Instance], if successful.
+  //
+  // Authorization requires `spanner.instances.update` permission on
+  // resource [name][google.spanner.admin.instance.v1.Instance.name].
+  rpc UpdateInstance(UpdateInstanceRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/{instance.name=projects/*/instances/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes an instance.
+  //
+  // Immediately upon completion of the request:
+  //
+  //   * Billing ceases for all of the instance's reserved resources.
+  //
+  // Soon afterward:
+  //
+  //   * The instance and *all of its databases* immediately and
+  //     irrevocably disappear from the API. All data in the databases
+  //     is permanently deleted.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Sets the access control policy on an instance resource. Replaces any
+  // existing policy.
+  //
+  // Authorization requires `spanner.instances.setIamPolicy` 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/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the access control policy for an instance resource. Returns an empty
+  // policy if an instance exists but does not have a policy set.
+  //
+  // Authorization requires `spanner.instances.getIamPolicy` 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/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Returns permissions that the caller has on the specified instance resource.
+  //
+  // Attempting this RPC on a non-existent Cloud Spanner instance resource will
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// A possible configuration for a Cloud Spanner instance. Configurations
+// define the geographic placement of nodes and their replication.
+message InstanceConfig {
+  // A unique identifier for the instance configuration.  Values
+  // are of the form
+  // `projects/<project>/instanceConfigs/[a-z][-a-z0-9]*`
+  string name = 1;
+
+  // The name of this instance configuration as it appears in UIs.
+  string display_name = 2;
+}
+
+// An isolated set of Cloud Spanner resources on which databases can be hosted.
+message Instance {
+  // Indicates the current state of the instance.
+  enum State {
+    // Not specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The instance is still being created. Resources may not be
+    // available yet, and operations such as database creation may not
+    // work.
+    CREATING = 1;
+
+    // The instance is fully created and ready to do work such as
+    // creating databases.
+    READY = 2;
+  }
+
+  // Required. A unique identifier for the instance, which cannot be changed
+  // after the instance is created. Values are of the form
+  // `projects/<project>/instances/[a-z][-a-z0-9]*[a-z0-9]`. The final
+  // segment of the name must be between 6 and 30 characters in length.
+  string name = 1;
+
+  // Required. The name of the instance's configuration. Values are of the form
+  // `projects/<project>/instanceConfigs/<configuration>`. See
+  // also [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig] and
+  // [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
+  string config = 2;
+
+  // 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.
+  string display_name = 3;
+
+  // Required. The number of nodes allocated to this instance. This may be zero
+  // in API responses for instances that are not yet in state `READY`.
+  //
+  // See [the
+  // documentation](https://cloud.google.com/spanner/docs/instances#node_count)
+  // for more information about nodes.
+  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`.
+  State state = 6;
+
+  // Cloud Labels are a flexible and lightweight mechanism for organizing cloud
+  // resources into groups that reflect a customer's organizational needs and
+  // deployment strategies. Cloud Labels can be used to filter collections of
+  // resources. They can be used to control how resource metrics are aggregated.
+  // And they can be used as arguments to policy management rules (e.g. route,
+  // firewall, load balancing, etc.).
+  //
+  //  * 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 64 labels can be associated with a given resource.
+  //
+  // See https://goo.gl/xmQnxf for more information on and examples of labels.
+  //
+  // If you plan to use labels in your own code, please note that additional
+  // characters may be allowed in the future. And so you are advised to use an
+  // internal label representation, such as JSON, which doesn't rely upon
+  // specific characters being disallowed.  For example, representing labels
+  // as the string:  name + "_" + value  would prove problematic if we were to
+  // allow "_" in a future release.
+  map<string, string> labels = 7;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // Number of instance configurations 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.ListInstanceConfigsResponse.next_page_token]
+  // 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].
+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.
+  string next_page_token = 2;
+}
+
+// The request for
+// [GetInstanceConfigRequest][google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig].
+message GetInstanceConfigRequest {
+  // Required. The name of the requested instance configuration. Values are of
+  // the form `projects/<project>/instanceConfigs/<config>`.
+  string name = 1;
+}
+
+// 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/<project>/instances/<instance>`.
+  string name = 1;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // 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
+  // length.
+  string instance_id = 2;
+
+  // Required. The instance to create.  The name may be omitted, but if
+  // specified must be `<parent>/instances/<instance_id>`.
+  Instance instance = 3;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // 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].
+  string page_token = 3;
+
+  // An expression for filtering the results of the request. Filter rules are
+  // case insensitive. The fields eligible for filtering are:
+  //
+  //   * `name`
+  //   * `display_name`
+  //   * `labels.key` where key is the name of a label
+  //
+  // Some examples of using filters are:
+  //
+  //   * `name:*` --> The instance has a name.
+  //   * `name:Howl` --> The instance's name contains the string "howl".
+  //   * `name:HOWL` --> Equivalent to above.
+  //   * `NAME:howl` --> Equivalent to above.
+  //   * `labels.env:*` --> The instance has the label "env".
+  //   * `labels.env:dev` --> The instance has the label "env" and the value of
+  //                        the label contains the string "dev".
+  //   * `name:howl labels.env:dev` --> The instance's name contains "howl" and
+  //                                  it has the label "env" with its value
+  //                                  containing "dev".
+  string filter = 4;
+}
+
+// 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.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// 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/<project>/instances/<instance>`
+  string name = 1;
+}
+
+// Metadata type for the operation returned by
+// [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance].
+message CreateInstanceMetadata {
+  // The instance being created.
+  Instance instance = 1;
+
+  // The time at which the
+  // [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
+  // in the process of undoing itself (which is guaranteed to succeed) and
+  // cannot be cancelled again.
+  google.protobuf.Timestamp cancel_time = 3;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp end_time = 4;
+}
+
+// Metadata type for the operation returned by
+// [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
+message UpdateInstanceMetadata {
+  // The desired end state of the update.
+  Instance instance = 1;
+
+  // The time at which
+  // [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]
+  // request was received.
+  google.protobuf.Timestamp start_time = 2;
+
+  // The time at which this operation was cancelled. If set, this operation is
+  // in the process of undoing itself (which is guaranteed to succeed) and
+  // cannot be cancelled again.
+  google.protobuf.Timestamp cancel_time = 3;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp end_time = 4;
+}
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py b/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py
new file mode 100644
index 000000000000..2e16c4a16681
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py
@@ -0,0 +1,1616 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner/admin/instance_v1/proto/spanner_instance_admin.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner/admin/instance_v1/proto/spanner_instance_admin.proto",
+    package="google.spanner.admin.instance.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n$com.google.spanner.admin.instance.v1B\031SpannerInstanceAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance\252\002&Google.Cloud.Spanner.Admin.Instance.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Instance\\V1"
+    ),
+    serialized_pb=_b(
+        '\nIgoogle/cloud/spanner/admin/instance_v1/proto/spanner_instance_admin.proto\x12 google.spanner.admin.instance.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"4\n\x0eInstanceConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t"\xc3\x02\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x63onfig\x18\x02 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x12\n\nnode_count\x18\x05 \x01(\x05\x12?\n\x05state\x18\x06 \x01(\x0e\x32\x30.google.spanner.admin.instance.v1.Instance.State\x12\x46\n\x06labels\x18\x07 \x03(\x0b\x32\x36.google.spanner.admin.instance.v1.Instance.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02"S\n\x1aListInstanceConfigsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x82\x01\n\x1bListInstanceConfigsResponse\x12J\n\x10instance_configs\x18\x01 \x03(\x0b\x32\x30.google.spanner.admin.instance.v1.InstanceConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"(\n\x18GetInstanceConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t""\n\x12GetInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"z\n\x15\x43reateInstanceRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x13\n\x0binstance_id\x18\x02 \x01(\t\x12<\n\x08instance\x18\x03 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance"]\n\x14ListInstancesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"o\n\x15ListInstancesResponse\x12=\n\tinstances\x18\x01 \x03(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x85\x01\n\x15UpdateInstanceRequest\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"%\n\x15\x44\x65leteInstanceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xe5\x01\n\x16\x43reateInstanceMetadata\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63\x61ncel_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xe5\x01\n\x16UpdateInstanceMetadata\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63\x61ncel_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xe6\x0c\n\rInstanceAdmin\x12\xc3\x01\n\x13ListInstanceConfigs\x12<.google.spanner.admin.instance.v1.ListInstanceConfigsRequest\x1a=.google.spanner.admin.instance.v1.ListInstanceConfigsResponse"/\x82\xd3\xe4\x93\x02)\x12\'/v1/{parent=projects/*}/instanceConfigs\x12\xb2\x01\n\x11GetInstanceConfig\x12:.google.spanner.admin.instance.v1.GetInstanceConfigRequest\x1a\x30.google.spanner.admin.instance.v1.InstanceConfig"/\x82\xd3\xe4\x93\x02)\x12\'/v1/{name=projects/*/instanceConfigs/*}\x12\xab\x01\n\rListInstances\x12\x36.google.spanner.admin.instance.v1.ListInstancesRequest\x1a\x37.google.spanner.admin.instance.v1.ListInstancesResponse")\x82\xd3\xe4\x93\x02#\x12!/v1/{parent=projects/*}/instances\x12\x9a\x01\n\x0bGetInstance\x12\x34.google.spanner.admin.instance.v1.GetInstanceRequest\x1a*.google.spanner.admin.instance.v1.Instance")\x82\xd3\xe4\x93\x02#\x12!/v1/{name=projects/*/instances/*}\x12\x96\x01\n\x0e\x43reateInstance\x12\x37.google.spanner.admin.instance.v1.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation",\x82\xd3\xe4\x93\x02&"!/v1/{parent=projects/*}/instances:\x01*\x12\x9f\x01\n\x0eUpdateInstance\x12\x37.google.spanner.admin.instance.v1.UpdateInstanceRequest\x1a\x1d.google.longrunning.Operation"5\x82\xd3\xe4\x93\x02/2*/v1/{instance.name=projects/*/instances/*}:\x01*\x12\x8c\x01\n\x0e\x44\x65leteInstance\x12\x37.google.spanner.admin.instance.v1.DeleteInstanceRequest\x1a\x16.google.protobuf.Empty")\x82\xd3\xe4\x93\x02#*!/v1/{name=projects/*/instances/*}\x12\x88\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"=\x82\xd3\xe4\x93\x02\x37"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\x01*\x12\x88\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"=\x82\xd3\xe4\x93\x02\x37"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\x01*\x12\xae\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"C\x82\xd3\xe4\x93\x02="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\x01*B\xdf\x01\n$com.google.spanner.admin.instance.v1B\x19SpannerInstanceAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance\xaa\x02&Google.Cloud.Spanner.Admin.Instance.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Instance\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_INSTANCE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.spanner.admin.instance.v1.Instance.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="READY", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=657,
+    serialized_end=712,
+)
+_sym_db.RegisterEnumDescriptor(_INSTANCE_STATE)
+
+
+_INSTANCECONFIG = _descriptor.Descriptor(
+    name="InstanceConfig",
+    full_name="google.spanner.admin.instance.v1.InstanceConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.instance.v1.InstanceConfig.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.spanner.admin.instance.v1.InstanceConfig.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=334,
+    serialized_end=386,
+)
+
+
+_INSTANCE_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.spanner.admin.instance.v1.Instance.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.spanner.admin.instance.v1.Instance.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.spanner.admin.instance.v1.Instance.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=610,
+    serialized_end=655,
+)
+
+_INSTANCE = _descriptor.Descriptor(
+    name="Instance",
+    full_name="google.spanner.admin.instance.v1.Instance",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.instance.v1.Instance.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.spanner.admin.instance.v1.Instance.config",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.spanner.admin.instance.v1.Instance.display_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="node_count",
+            full_name="google.spanner.admin.instance.v1.Instance.node_count",
+            index=3,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.spanner.admin.instance.v1.Instance.state",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.spanner.admin.instance.v1.Instance.labels",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_INSTANCE_LABELSENTRY],
+    enum_types=[_INSTANCE_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=389,
+    serialized_end=712,
+)
+
+
+_LISTINSTANCECONFIGSREQUEST = _descriptor.Descriptor(
+    name="ListInstanceConfigsRequest",
+    full_name="google.spanner.admin.instance.v1.ListInstanceConfigsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.spanner.admin.instance.v1.ListInstanceConfigsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.spanner.admin.instance.v1.ListInstanceConfigsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.spanner.admin.instance.v1.ListInstanceConfigsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=714,
+    serialized_end=797,
+)
+
+
+_LISTINSTANCECONFIGSRESPONSE = _descriptor.Descriptor(
+    name="ListInstanceConfigsResponse",
+    full_name="google.spanner.admin.instance.v1.ListInstanceConfigsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance_configs",
+            full_name="google.spanner.admin.instance.v1.ListInstanceConfigsResponse.instance_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.spanner.admin.instance.v1.ListInstanceConfigsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=800,
+    serialized_end=930,
+)
+
+
+_GETINSTANCECONFIGREQUEST = _descriptor.Descriptor(
+    name="GetInstanceConfigRequest",
+    full_name="google.spanner.admin.instance.v1.GetInstanceConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.instance.v1.GetInstanceConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=932,
+    serialized_end=972,
+)
+
+
+_GETINSTANCEREQUEST = _descriptor.Descriptor(
+    name="GetInstanceRequest",
+    full_name="google.spanner.admin.instance.v1.GetInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.instance.v1.GetInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=974,
+    serialized_end=1008,
+)
+
+
+_CREATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="CreateInstanceRequest",
+    full_name="google.spanner.admin.instance.v1.CreateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance_id",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceRequest.instance_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceRequest.instance",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1010,
+    serialized_end=1132,
+)
+
+
+_LISTINSTANCESREQUEST = _descriptor.Descriptor(
+    name="ListInstancesRequest",
+    full_name="google.spanner.admin.instance.v1.ListInstancesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.spanner.admin.instance.v1.ListInstancesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.spanner.admin.instance.v1.ListInstancesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.spanner.admin.instance.v1.ListInstancesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.spanner.admin.instance.v1.ListInstancesRequest.filter",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1134,
+    serialized_end=1227,
+)
+
+
+_LISTINSTANCESRESPONSE = _descriptor.Descriptor(
+    name="ListInstancesResponse",
+    full_name="google.spanner.admin.instance.v1.ListInstancesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instances",
+            full_name="google.spanner.admin.instance.v1.ListInstancesResponse.instances",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.spanner.admin.instance.v1.ListInstancesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1229,
+    serialized_end=1340,
+)
+
+
+_UPDATEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="UpdateInstanceRequest",
+    full_name="google.spanner.admin.instance.v1.UpdateInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.spanner.admin.instance.v1.UpdateInstanceRequest.instance",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_mask",
+            full_name="google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1343,
+    serialized_end=1476,
+)
+
+
+_DELETEINSTANCEREQUEST = _descriptor.Descriptor(
+    name="DeleteInstanceRequest",
+    full_name="google.spanner.admin.instance.v1.DeleteInstanceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.admin.instance.v1.DeleteInstanceRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1478,
+    serialized_end=1515,
+)
+
+
+_CREATEINSTANCEMETADATA = _descriptor.Descriptor(
+    name="CreateInstanceMetadata",
+    full_name="google.spanner.admin.instance.v1.CreateInstanceMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceMetadata.instance",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceMetadata.start_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cancel_time",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceMetadata.cancel_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.spanner.admin.instance.v1.CreateInstanceMetadata.end_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1518,
+    serialized_end=1747,
+)
+
+
+_UPDATEINSTANCEMETADATA = _descriptor.Descriptor(
+    name="UpdateInstanceMetadata",
+    full_name="google.spanner.admin.instance.v1.UpdateInstanceMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.spanner.admin.instance.v1.UpdateInstanceMetadata.instance",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.spanner.admin.instance.v1.UpdateInstanceMetadata.start_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="cancel_time",
+            full_name="google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.spanner.admin.instance.v1.UpdateInstanceMetadata.end_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1750,
+    serialized_end=1979,
+)
+
+_INSTANCE_LABELSENTRY.containing_type = _INSTANCE
+_INSTANCE.fields_by_name["state"].enum_type = _INSTANCE_STATE
+_INSTANCE.fields_by_name["labels"].message_type = _INSTANCE_LABELSENTRY
+_INSTANCE_STATE.containing_type = _INSTANCE
+_LISTINSTANCECONFIGSRESPONSE.fields_by_name[
+    "instance_configs"
+].message_type = _INSTANCECONFIG
+_CREATEINSTANCEREQUEST.fields_by_name["instance"].message_type = _INSTANCE
+_LISTINSTANCESRESPONSE.fields_by_name["instances"].message_type = _INSTANCE
+_UPDATEINSTANCEREQUEST.fields_by_name["instance"].message_type = _INSTANCE
+_UPDATEINSTANCEREQUEST.fields_by_name[
+    "field_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEINSTANCEMETADATA.fields_by_name["instance"].message_type = _INSTANCE
+_CREATEINSTANCEMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATEINSTANCEMETADATA.fields_by_name[
+    "cancel_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATEINSTANCEMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEINSTANCEMETADATA.fields_by_name["instance"].message_type = _INSTANCE
+_UPDATEINSTANCEMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEINSTANCEMETADATA.fields_by_name[
+    "cancel_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_UPDATEINSTANCEMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["InstanceConfig"] = _INSTANCECONFIG
+DESCRIPTOR.message_types_by_name["Instance"] = _INSTANCE
+DESCRIPTOR.message_types_by_name[
+    "ListInstanceConfigsRequest"
+] = _LISTINSTANCECONFIGSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListInstanceConfigsResponse"
+] = _LISTINSTANCECONFIGSRESPONSE
+DESCRIPTOR.message_types_by_name["GetInstanceConfigRequest"] = _GETINSTANCECONFIGREQUEST
+DESCRIPTOR.message_types_by_name["GetInstanceRequest"] = _GETINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["CreateInstanceRequest"] = _CREATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["ListInstancesRequest"] = _LISTINSTANCESREQUEST
+DESCRIPTOR.message_types_by_name["ListInstancesResponse"] = _LISTINSTANCESRESPONSE
+DESCRIPTOR.message_types_by_name["UpdateInstanceRequest"] = _UPDATEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteInstanceRequest"] = _DELETEINSTANCEREQUEST
+DESCRIPTOR.message_types_by_name["CreateInstanceMetadata"] = _CREATEINSTANCEMETADATA
+DESCRIPTOR.message_types_by_name["UpdateInstanceMetadata"] = _UPDATEINSTANCEMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+InstanceConfig = _reflection.GeneratedProtocolMessageType(
+    "InstanceConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INSTANCECONFIG,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""A possible configuration for a Cloud Spanner instance. Configurations
+  define the geographic placement of nodes and their replication.
+  
+  
+  Attributes:
+      name:
+          A unique identifier for the instance configuration. Values are
+          of the form
+          ``projects/<project>/instanceConfigs/[a-z][-a-z0-9]*``
+      display_name:
+          The name of this instance configuration as it appears in UIs.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig)
+    ),
+)
+_sym_db.RegisterMessage(InstanceConfig)
+
+Instance = _reflection.GeneratedProtocolMessageType(
+    "Instance",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_INSTANCE_LABELSENTRY,
+                __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2"
+                # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_INSTANCE,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""An isolated set of Cloud Spanner resources on which databases can be
+  hosted.
+  
+  
+  Attributes:
+      name:
+          Required. A unique identifier for the instance, which cannot
+          be changed after the instance is created. Values are of the
+          form ``projects/<project>/instances/[a-z][-a-z0-9]*[a-z0-9]``.
+          The final segment of the name must be between 6 and 30
+          characters in length.
+      config:
+          Required. The name of the instance's configuration. Values are
+          of the form
+          ``projects/<project>/instanceConfigs/<configuration>``. See
+          also [InstanceConfig][google.spanner.admin.instance.v1.Instanc
+          eConfig] and [ListInstanceConfigs][google.spanner.admin.instan
+          ce.v1.InstanceAdmin.ListInstanceConfigs].
+      display_name:
+          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.
+      node_count:
+          Required. The number of nodes allocated to this instance. This
+          may be zero in API responses for instances that are not yet in
+          state ``READY``.  See `the documentation <https://cloud.google
+          .com/spanner/docs/instances#node_count>`__ for more
+          information about nodes.
+      state:
+          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.InstanceAdmi
+          n.UpdateInstance], the state must be either omitted or set to
+          ``READY``.
+      labels:
+          Cloud Labels are a flexible and lightweight mechanism for
+          organizing cloud resources into groups that reflect a
+          customer's organizational needs and deployment strategies.
+          Cloud Labels can be used to filter collections of resources.
+          They can be used to control how resource metrics are
+          aggregated. And they can be used as arguments to policy
+          management rules (e.g. route, firewall, load balancing, etc.).
+          -  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 64 labels can be associated with a given resource.
+          See https://goo.gl/xmQnxf for more information on and examples
+          of labels.  If you plan to use labels in your own code, please
+          note that additional characters may be allowed in the future.
+          And so you are advised to use an internal label
+          representation, such as JSON, which doesn't rely upon specific
+          characters being disallowed. For example, representing labels
+          as the string: name + "*" + value would prove problematic if
+          we were to allow "*" in a future release.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance)
+    ),
+)
+_sym_db.RegisterMessage(Instance)
+_sym_db.RegisterMessage(Instance.LabelsEntry)
+
+ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInstanceConfigsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCECONFIGSREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project for which a list of
+          supported instance configurations is requested. Values are of
+          the form ``projects/<project>``.
+      page_size:
+          Number of instance configurations to be returned in the
+          response. If 0 or less, defaults to the server's maximum
+          allowed page size.
+      page_token:
+          If non-empty, ``page_token`` should contain a [next\_page\_tok
+          en][google.spanner.admin.instance.v1.ListInstanceConfigsRespon
+          se.next\_page\_token] from a previous [ListInstanceConfigsResp
+          onse][google.spanner.admin.instance.v1.ListInstanceConfigsResp
+          onse].
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInstanceConfigsRequest)
+
+ListInstanceConfigsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInstanceConfigsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCECONFIGSRESPONSE,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The response for
+  [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
+  
+  
+  Attributes:
+      instance_configs:
+          The list of requested instance configurations.
+      next_page_token:
+          ``next_page_token`` can be sent in a subsequent [ListInstanceC
+          onfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListIns
+          tanceConfigs] call to fetch more of the matching instance
+          configurations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInstanceConfigsResponse)
+
+GetInstanceConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInstanceConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSTANCECONFIGREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [GetInstanceConfigRequest][google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the requested instance configuration.
+          Values are of the form
+          ``projects/<project>/instanceConfigs/<config>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInstanceConfigRequest)
+
+GetInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETINSTANCEREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [GetInstance][google.spanner.admin.instance.v1.InstanceAdmin.GetInstance].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the requested instance. Values are of
+          the form ``projects/<project>/instances/<instance>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetInstanceRequest)
+
+CreateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTANCEREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance].
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project in which to create the
+          instance. Values are of the form ``projects/<project>``.
+      instance_id:
+          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 length.
+      instance:
+          Required. The instance to create. The name may be omitted, but
+          if specified must be ``<parent>/instances/<instance_id>``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstanceRequest)
+
+ListInstancesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances].
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project for which a list of
+          instances is requested. Values are of the form
+          ``projects/<project>``.
+      page_size:
+          Number of instances to be returned in the response. If 0 or
+          less, defaults to the server's maximum allowed page size.
+      page_token:
+          If non-empty, ``page_token`` should contain a [next\_page\_tok
+          en][google.spanner.admin.instance.v1.ListInstancesResponse.nex
+          t\_page\_token] from a previous [ListInstancesResponse][google
+          .spanner.admin.instance.v1.ListInstancesResponse].
+      filter:
+          An expression for filtering the results of the request. Filter
+          rules are case insensitive. The fields eligible for filtering
+          are:  -  ``name`` -  ``display_name`` -  ``labels.key`` where
+          key is the name of a label  Some examples of using filters
+          are:  -  ``name:*`` --> The instance has a name. -
+          ``name:Howl`` --> The instance's name contains the string
+          "howl". -  ``name:HOWL`` --> Equivalent to above. -
+          ``NAME:howl`` --> Equivalent to above. -  ``labels.env:*`` -->
+          The instance has the label "env". -  ``labels.env:dev`` -->
+          The instance has the label "env" and the value    of the label
+          contains the string "dev". -  ``name:howl labels.env:dev`` -->
+          The instance's name contains "howl"    and it has the label
+          "env" with its value containing "dev".
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesRequest)
+
+ListInstancesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListInstancesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTINSTANCESRESPONSE,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The response for
+  [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances].
+  
+  
+  Attributes:
+      instances:
+          The list of requested instances.
+      next_page_token:
+          ``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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListInstancesResponse)
+
+UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINSTANCEREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
+  
+  
+  Attributes:
+      instance:
+          Required. The instance to update, which must always include
+          the instance name. Otherwise, only fields mentioned in [][goog
+          le.spanner.admin.instance.v1.UpdateInstanceRequest.field\_mask
+          ] need be included.
+      field_mask:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateInstanceRequest)
+
+DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteInstanceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEINSTANCEREQUEST,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""The request for
+  [DeleteInstance][google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the instance to be deleted. Values are
+          of the form ``projects/<project>/instances/<instance>``
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.DeleteInstanceRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteInstanceRequest)
+
+CreateInstanceMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateInstanceMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEINSTANCEMETADATA,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""Metadata type for the operation returned by
+  [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance].
+  
+  
+  Attributes:
+      instance:
+          The instance being created.
+      start_time:
+          The time at which the [CreateInstance][google.spanner.admin.in
+          stance.v1.InstanceAdmin.CreateInstance] request was received.
+      cancel_time:
+          The time at which this operation was cancelled. If set, this
+          operation is in the process of undoing itself (which is
+          guaranteed to succeed) and cannot be cancelled again.
+      end_time:
+          The time at which this operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateInstanceMetadata)
+
+UpdateInstanceMetadata = _reflection.GeneratedProtocolMessageType(
+    "UpdateInstanceMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEINSTANCEMETADATA,
+        __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
+        __doc__="""Metadata type for the operation returned by
+  [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
+  
+  
+  Attributes:
+      instance:
+          The desired end state of the update.
+      start_time:
+          The time at which [UpdateInstance][google.spanner.admin.instan
+          ce.v1.InstanceAdmin.UpdateInstance] request was received.
+      cancel_time:
+          The time at which this operation was cancelled. If set, this
+          operation is in the process of undoing itself (which is
+          guaranteed to succeed) and cannot be cancelled again.
+      end_time:
+          The time at which this operation failed or was completed
+          successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata)
+    ),
+)
+_sym_db.RegisterMessage(UpdateInstanceMetadata)
+
+
+DESCRIPTOR._options = None
+_INSTANCE_LABELSENTRY._options = None
+
+_INSTANCEADMIN = _descriptor.ServiceDescriptor(
+    name="InstanceAdmin",
+    full_name="google.spanner.admin.instance.v1.InstanceAdmin",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1982,
+    serialized_end=3620,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListInstanceConfigs",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs",
+            index=0,
+            containing_service=None,
+            input_type=_LISTINSTANCECONFIGSREQUEST,
+            output_type=_LISTINSTANCECONFIGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInstanceConfig",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig",
+            index=1,
+            containing_service=None,
+            input_type=_GETINSTANCECONFIGREQUEST,
+            output_type=_INSTANCECONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListInstances",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.ListInstances",
+            index=2,
+            containing_service=None,
+            input_type=_LISTINSTANCESREQUEST,
+            output_type=_LISTINSTANCESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetInstance",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetInstance",
+            index=3,
+            containing_service=None,
+            input_type=_GETINSTANCEREQUEST,
+            output_type=_INSTANCE,
+            serialized_options=_b(
+                "\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateInstance",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance",
+            index=4,
+            containing_service=None,
+            input_type=_CREATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002&"!/v1/{parent=projects/*}/instances:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateInstance",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance",
+            index=5,
+            containing_service=None,
+            input_type=_UPDATEINSTANCEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\002/2*/v1/{instance.name=projects/*/instances/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteInstance",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance",
+            index=6,
+            containing_service=None,
+            input_type=_DELETEINSTANCEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002#*!/v1/{name=projects/*/instances/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy",
+            index=7,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy",
+            index=8,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions",
+            index=9,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_INSTANCEADMIN)
+
+DESCRIPTOR.services_by_name["InstanceAdmin"] = _INSTANCEADMIN
+
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py b/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py
new file mode 100644
index 000000000000..922bba7e0df7
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py
@@ -0,0 +1,343 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.spanner_admin_instance_v1.proto import (
+    spanner_instance_admin_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class InstanceAdminStub(object):
+    """Cloud Spanner Instance Admin API
+
+  The Cloud Spanner Instance Admin API can be used to create, delete,
+  modify and list instances. Instances are dedicated Cloud Spanner serving
+  and storage resources to be used by Cloud Spanner databases.
+
+  Each instance has a "configuration", which dictates where the
+  serving resources for the Cloud Spanner instance are located (e.g.,
+  US-central, Europe). Configurations are created by Google based on
+  resource availability.
+
+  Cloud Spanner billing is based on the instances that exist and their
+  sizes. After an instance exists, there are no additional
+  per-database or per-operation charges for use of the instance
+  (though there may be additional network bandwidth charges).
+  Instances offer isolation: problems with databases in one instance
+  will not affect other instances. However, within an instance
+  databases can affect each other. For example, if one database in an
+  instance receives a lot of requests and consumes most of the
+  instance resources, fewer resources are available for other
+  databases in that instance, and their performance may suffer.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListInstanceConfigs = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString,
+        )
+        self.GetInstanceConfig = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString,
+        )
+        self.ListInstances = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString,
+        )
+        self.GetInstance = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString,
+        )
+        self.CreateInstance = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.UpdateInstance = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.DeleteInstance = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance",
+            request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+
+
+class InstanceAdminServicer(object):
+    """Cloud Spanner Instance Admin API
+
+  The Cloud Spanner Instance Admin API can be used to create, delete,
+  modify and list instances. Instances are dedicated Cloud Spanner serving
+  and storage resources to be used by Cloud Spanner databases.
+
+  Each instance has a "configuration", which dictates where the
+  serving resources for the Cloud Spanner instance are located (e.g.,
+  US-central, Europe). Configurations are created by Google based on
+  resource availability.
+
+  Cloud Spanner billing is based on the instances that exist and their
+  sizes. After an instance exists, there are no additional
+  per-database or per-operation charges for use of the instance
+  (though there may be additional network bandwidth charges).
+  Instances offer isolation: problems with databases in one instance
+  will not affect other instances. However, within an instance
+  databases can affect each other. For example, if one database in an
+  instance receives a lot of requests and consumes most of the
+  instance resources, fewer resources are available for other
+  databases in that instance, and their performance may suffer.
+  """
+
+    def ListInstanceConfigs(self, request, context):
+        """Lists the supported instance configurations for a given project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInstanceConfig(self, request, context):
+        """Gets information about a particular instance configuration.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListInstances(self, request, context):
+        """Lists all instances in the given project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetInstance(self, request, context):
+        """Gets information about a particular instance.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateInstance(self, request, context):
+        """Creates an instance and begins preparing it to begin serving. The
+    returned [long-running operation][google.longrunning.Operation]
+    can be used to track the progress of preparing the new
+    instance. The instance name is assigned by the caller. If the
+    named instance already exists, `CreateInstance` returns
+    `ALREADY_EXISTS`.
+
+    Immediately upon completion of this request:
+
+    * The instance is readable via the API, with all requested attributes
+    but no allocated resources. Its state is `CREATING`.
+
+    Until completion of the returned operation:
+
+    * Cancelling the operation renders the instance immediately unreadable
+    via the API.
+    * The instance can be deleted.
+    * All other attempts to modify the instance are rejected.
+
+    Upon completion of the returned operation:
+
+    * Billing for all successfully-allocated resources begins (some types
+    may have lower than the requested levels).
+    * Databases can be created in the instance.
+    * The instance's allocated resource levels are readable via the API.
+    * The instance's state becomes `READY`.
+
+    The returned [long-running operation][google.longrunning.Operation] will
+    have a name of the format `<instance_name>/operations/<operation_id>` and
+    can be used to track creation of the instance.  The
+    [metadata][google.longrunning.Operation.metadata] field type is
+    [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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateInstance(self, request, context):
+        """Updates an instance, and begins allocating or releasing resources
+    as requested. The returned [long-running
+    operation][google.longrunning.Operation] can be used to track the
+    progress of updating the instance. If the named instance does not
+    exist, returns `NOT_FOUND`.
+
+    Immediately upon completion of this request:
+
+    * For resource types for which a decrease in the instance's allocation
+    has been requested, billing is based on the newly-requested level.
+
+    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,
+    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
+    resource levels.
+
+    Upon completion of the returned operation:
+
+    * Billing begins for all successfully-allocated resources (some types
+    may have lower than the requested levels).
+    * All newly-reserved resources are available for serving the instance's
+    tables.
+    * The instance's new resource levels are readable via the API.
+
+    The returned [long-running operation][google.longrunning.Operation] will
+    have a name of the format `<instance_name>/operations/<operation_id>` and
+    can be used to track the instance modification.  The
+    [metadata][google.longrunning.Operation.metadata] field type is
+    [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata].
+    The [response][google.longrunning.Operation.response] field type is
+    [Instance][google.spanner.admin.instance.v1.Instance], if successful.
+
+    Authorization requires `spanner.instances.update` permission on
+    resource [name][google.spanner.admin.instance.v1.Instance.name].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteInstance(self, request, context):
+        """Deletes an instance.
+
+    Immediately upon completion of the request:
+
+    * Billing ceases for all of the instance's reserved resources.
+
+    Soon afterward:
+
+    * The instance and *all of its databases* immediately and
+    irrevocably disappear from the API. All data in the databases
+    is permanently deleted.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy on an instance resource. Replaces any
+    existing policy.
+
+    Authorization requires `spanner.instances.setIamPolicy` on
+    [resource][google.iam.v1.SetIamPolicyRequest.resource].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for an instance resource. Returns an empty
+    policy if an instance exists but does not have a policy set.
+
+    Authorization requires `spanner.instances.getIamPolicy` on
+    [resource][google.iam.v1.GetIamPolicyRequest.resource].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns permissions that the caller has on the specified instance resource.
+
+    Attempting this RPC on a non-existent Cloud Spanner instance resource will
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_InstanceAdminServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListInstanceConfigs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInstanceConfigs,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.SerializeToString,
+        ),
+        "GetInstanceConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInstanceConfig,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.SerializeToString,
+        ),
+        "ListInstances": grpc.unary_unary_rpc_method_handler(
+            servicer.ListInstances,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.SerializeToString,
+        ),
+        "GetInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.GetInstance,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.SerializeToString,
+        ),
+        "CreateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateInstance,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "UpdateInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateInstance,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "DeleteInstance": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteInstance,
+            request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.spanner.admin.instance.v1.InstanceAdmin", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/spanner/google/cloud/spanner_admin_instance_v1/types.py b/spanner/google/cloud/spanner_admin_instance_v1/types.py
new file mode 100644
index 000000000000..a20b479bf04e
--- /dev/null
+++ b/spanner/google/cloud/spanner_admin_instance_v1/types.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+
+from google.api import http_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.iam.v1.logging import audit_data_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.spanner_admin_instance_v1.proto import spanner_instance_admin_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    iam_policy_pb2,
+    policy_pb2,
+    audit_data_pb2,
+    operations_pb2,
+    any_pb2,
+    descriptor_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+]
+
+_local_modules = [spanner_instance_admin_pb2]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.spanner_admin_instance_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/spanner/google/cloud/spanner_v1/__init__.py b/spanner/google/cloud/spanner_v1/__init__.py
new file mode 100644
index 000000000000..8611405cd6cf
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/__init__.py
@@ -0,0 +1,62 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import pkg_resources
+
+__version__ = pkg_resources.get_distribution("google-cloud-spanner").version
+
+from google.cloud.spanner_v1 import param_types
+from google.cloud.spanner_v1 import types
+from google.cloud.spanner_v1.client import Client
+from google.cloud.spanner_v1.gapic import enums
+from google.cloud.spanner_v1.keyset import KeyRange
+from google.cloud.spanner_v1.keyset import KeySet
+from google.cloud.spanner_v1.pool import AbstractSessionPool
+from google.cloud.spanner_v1.pool import BurstyPool
+from google.cloud.spanner_v1.pool import FixedSizePool
+from google.cloud.spanner_v1.pool import PingingPool
+from google.cloud.spanner_v1.pool import TransactionPingingPool
+
+
+COMMIT_TIMESTAMP = "spanner.commit_timestamp()"
+"""Placeholder be used to store commit timestamp of a transaction in a column.
+
+This value can only be used for timestamp columns that have set the option
+``(allow_commit_timestamp=true)`` in the schema.
+"""
+
+
+__all__ = (
+    # google.cloud.spanner_v1
+    "__version__",
+    "param_types",
+    "types",
+    # google.cloud.spanner_v1.client
+    "Client",
+    # google.cloud.spanner_v1.keyset
+    "KeyRange",
+    "KeySet",
+    # google.cloud.spanner_v1.pool
+    "AbstractSessionPool",
+    "BurstyPool",
+    "FixedSizePool",
+    "PingingPool",
+    "TransactionPingingPool",
+    # google.cloud.spanner_v1.gapic
+    "enums",
+    # local
+    "COMMIT_TIMESTAMP",
+)
diff --git a/spanner/google/cloud/spanner_v1/_helpers.py b/spanner/google/cloud/spanner_v1/_helpers.py
new file mode 100644
index 000000000000..3b7fd586c9a5
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/_helpers.py
@@ -0,0 +1,214 @@
+# Copyright 2016 Google LLC 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.
+
+"""Helper functions for Cloud Spanner."""
+
+import datetime
+import math
+
+import six
+
+from google.protobuf.struct_pb2 import ListValue
+from google.protobuf.struct_pb2 import Value
+
+from google.api_core import datetime_helpers
+from google.cloud._helpers import _date_from_iso8601_date
+from google.cloud._helpers import _datetime_to_rfc3339
+from google.cloud.spanner_v1.proto import type_pb2
+
+
+def _try_to_coerce_bytes(bytestring):
+    """Try to coerce a byte string into the right thing based on Python
+    version and whether or not it is base64 encoded.
+
+    Return a text string or raise ValueError.
+    """
+    # Attempt to coerce using google.protobuf.Value, which will expect
+    # something that is utf-8 (and base64 consistently is).
+    try:
+        Value(string_value=bytestring)
+        return bytestring
+    except ValueError:
+        raise ValueError(
+            "Received a bytes that is not base64 encoded. "
+            "Ensure that you either send a Unicode string or a "
+            "base64-encoded bytes."
+        )
+
+
+# pylint: disable=too-many-return-statements,too-many-branches
+def _make_value_pb(value):
+    """Helper for :func:`_make_list_value_pbs`.
+
+    :type value: scalar value
+    :param value: value to convert
+
+    :rtype: :class:`~google.protobuf.struct_pb2.Value`
+    :returns: value protobufs
+    :raises ValueError: if value is not of a known scalar type.
+    """
+    if value is None:
+        return Value(null_value="NULL_VALUE")
+    if isinstance(value, (list, tuple)):
+        return Value(list_value=_make_list_value_pb(value))
+    if isinstance(value, bool):
+        return Value(bool_value=value)
+    if isinstance(value, six.integer_types):
+        return Value(string_value=str(value))
+    if isinstance(value, float):
+        if math.isnan(value):
+            return Value(string_value="NaN")
+        if math.isinf(value):
+            if value > 0:
+                return Value(string_value="Infinity")
+            else:
+                return Value(string_value="-Infinity")
+        return Value(number_value=value)
+    if isinstance(value, datetime_helpers.DatetimeWithNanoseconds):
+        return Value(string_value=value.rfc3339())
+    if isinstance(value, datetime.datetime):
+        return Value(string_value=_datetime_to_rfc3339(value))
+    if isinstance(value, datetime.date):
+        return Value(string_value=value.isoformat())
+    if isinstance(value, six.binary_type):
+        value = _try_to_coerce_bytes(value)
+        return Value(string_value=value)
+    if isinstance(value, six.text_type):
+        return Value(string_value=value)
+    if isinstance(value, ListValue):
+        return Value(list_value=value)
+    raise ValueError("Unknown type: %s" % (value,))
+
+
+# pylint: enable=too-many-return-statements,too-many-branches
+
+
+def _make_list_value_pb(values):
+    """Construct of ListValue protobufs.
+
+    :type values: list of scalar
+    :param values: Row data
+
+    :rtype: :class:`~google.protobuf.struct_pb2.ListValue`
+    :returns: protobuf
+    """
+    return ListValue(values=[_make_value_pb(value) for value in values])
+
+
+def _make_list_value_pbs(values):
+    """Construct a sequence of ListValue protobufs.
+
+    :type values: list of list of scalar
+    :param values: Row data
+
+    :rtype: list of :class:`~google.protobuf.struct_pb2.ListValue`
+    :returns: sequence of protobufs
+    """
+    return [_make_list_value_pb(row) for row in values]
+
+
+# pylint: disable=too-many-branches
+def _parse_value_pb(value_pb, field_type):
+    """Convert a Value protobuf to cell data.
+
+    :type value_pb: :class:`~google.protobuf.struct_pb2.Value`
+    :param value_pb: protobuf to convert
+
+    :type field_type: :class:`~google.cloud.spanner_v1.proto.type_pb2.Type`
+    :param field_type: type code for the value
+
+    :rtype: varies on field_type
+    :returns: value extracted from value_pb
+    :raises ValueError: if unknown type is passed
+    """
+    if value_pb.HasField("null_value"):
+        return None
+    if field_type.code == type_pb2.STRING:
+        result = value_pb.string_value
+    elif field_type.code == type_pb2.BYTES:
+        result = value_pb.string_value.encode("utf8")
+    elif field_type.code == type_pb2.BOOL:
+        result = value_pb.bool_value
+    elif field_type.code == type_pb2.INT64:
+        result = int(value_pb.string_value)
+    elif field_type.code == type_pb2.FLOAT64:
+        if value_pb.HasField("string_value"):
+            result = float(value_pb.string_value)
+        else:
+            result = value_pb.number_value
+    elif field_type.code == type_pb2.DATE:
+        result = _date_from_iso8601_date(value_pb.string_value)
+    elif field_type.code == type_pb2.TIMESTAMP:
+        DatetimeWithNanoseconds = datetime_helpers.DatetimeWithNanoseconds
+        result = DatetimeWithNanoseconds.from_rfc3339(value_pb.string_value)
+    elif field_type.code == type_pb2.ARRAY:
+        result = [
+            _parse_value_pb(item_pb, field_type.array_element_type)
+            for item_pb in value_pb.list_value.values
+        ]
+    elif field_type.code == type_pb2.STRUCT:
+        result = [
+            _parse_value_pb(item_pb, field_type.struct_type.fields[i].type)
+            for (i, item_pb) in enumerate(value_pb.list_value.values)
+        ]
+    else:
+        raise ValueError("Unknown type: %s" % (field_type,))
+    return result
+
+
+# pylint: enable=too-many-branches
+
+
+def _parse_list_value_pbs(rows, row_type):
+    """Convert a list of ListValue protobufs into a list of list of cell data.
+
+    :type rows: list of :class:`~google.protobuf.struct_pb2.ListValue`
+    :param rows: row data returned from a read/query
+
+    :type row_type: :class:`~google.cloud.spanner_v1.proto.type_pb2.StructType`
+    :param row_type: row schema specification
+
+    :rtype: list of list of cell data
+    :returns: data for the rows, coerced into appropriate types
+    """
+    result = []
+    for row in rows:
+        row_data = []
+        for value_pb, field in zip(row.values, row_type.fields):
+            row_data.append(_parse_value_pb(value_pb, field.type))
+        result.append(row_data)
+    return result
+
+
+class _SessionWrapper(object):
+    """Base class for objects wrapping a session.
+
+    :type session: :class:`~google.cloud.spanner_v1.session.Session`
+    :param session: the session used to perform the commit
+    """
+
+    def __init__(self, session):
+        self._session = session
+
+
+def _metadata_with_prefix(prefix, **kw):
+    """Create RPC metadata containing a prefix.
+
+    Args:
+        prefix (str): appropriate resource path.
+
+    Returns:
+        List[Tuple[str, str]]: RPC metadata with supplied prefix
+    """
+    return [("google-cloud-resource-prefix", prefix)]
diff --git a/spanner/google/cloud/spanner_v1/batch.py b/spanner/google/cloud/spanner_v1/batch.py
new file mode 100644
index 000000000000..3446416c897e
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/batch.py
@@ -0,0 +1,188 @@
+# Copyright 2016 Google LLC 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.
+
+"""Context manager for Cloud Spanner batched writes."""
+
+from google.cloud.spanner_v1.proto.mutation_pb2 import Mutation
+from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionOptions
+
+# pylint: disable=ungrouped-imports
+from google.cloud._helpers import _pb_timestamp_to_datetime
+from google.cloud.spanner_v1._helpers import _SessionWrapper
+from google.cloud.spanner_v1._helpers import _make_list_value_pbs
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+
+# pylint: enable=ungrouped-imports
+
+
+class _BatchBase(_SessionWrapper):
+    """Accumulate mutations for transmission during :meth:`commit`.
+
+    :type session: :class:`~google.cloud.spanner_v1.session.Session`
+    :param session: the session used to perform the commit
+    """
+
+    def __init__(self, session):
+        super(_BatchBase, self).__init__(session)
+        self._mutations = []
+
+    def _check_state(self):
+        """Helper for :meth:`commit` et al.
+
+        Subclasses must override
+
+        :raises: :exc:`ValueError` if the object's state is invalid for making
+                 API requests.
+        """
+        raise NotImplementedError
+
+    def insert(self, table, columns, values):
+        """Insert one or more new table rows.
+
+        :type table: str
+        :param table: Name of the table to be modified.
+
+        :type columns: list of str
+        :param columns: Name of the table columns to be modified.
+
+        :type values: list of lists
+        :param values: Values to be modified.
+        """
+        self._mutations.append(Mutation(insert=_make_write_pb(table, columns, values)))
+
+    def update(self, table, columns, values):
+        """Update one or more existing table rows.
+
+        :type table: str
+        :param table: Name of the table to be modified.
+
+        :type columns: list of str
+        :param columns: Name of the table columns to be modified.
+
+        :type values: list of lists
+        :param values: Values to be modified.
+        """
+        self._mutations.append(Mutation(update=_make_write_pb(table, columns, values)))
+
+    def insert_or_update(self, table, columns, values):
+        """Insert/update one or more table rows.
+
+        :type table: str
+        :param table: Name of the table to be modified.
+
+        :type columns: list of str
+        :param columns: Name of the table columns to be modified.
+
+        :type values: list of lists
+        :param values: Values to be modified.
+        """
+        self._mutations.append(
+            Mutation(insert_or_update=_make_write_pb(table, columns, values))
+        )
+
+    def replace(self, table, columns, values):
+        """Replace one or more table rows.
+
+        :type table: str
+        :param table: Name of the table to be modified.
+
+        :type columns: list of str
+        :param columns: Name of the table columns to be modified.
+
+        :type values: list of lists
+        :param values: Values to be modified.
+        """
+        self._mutations.append(Mutation(replace=_make_write_pb(table, columns, values)))
+
+    def delete(self, table, keyset):
+        """Delete one or more table rows.
+
+        :type table: str
+        :param table: Name of the table to be modified.
+
+        :type keyset: :class:`~google.cloud.spanner_v1.keyset.Keyset`
+        :param keyset: Keys/ranges identifying rows to delete.
+        """
+        delete = Mutation.Delete(table=table, key_set=keyset._to_pb())
+        self._mutations.append(Mutation(delete=delete))
+
+
+class Batch(_BatchBase):
+    """Accumulate mutations for transmission during :meth:`commit`.
+    """
+
+    committed = None
+    """Timestamp at which the batch was successfully committed."""
+
+    def _check_state(self):
+        """Helper for :meth:`commit` et al.
+
+        Subclasses must override
+
+        :raises: :exc:`ValueError` if the object's state is invalid for making
+                 API requests.
+        """
+        if self.committed is not None:
+            raise ValueError("Batch already committed")
+
+    def commit(self):
+        """Commit mutations to the database.
+
+        :rtype: datetime
+        :returns: timestamp of the committed changes.
+        """
+        self._check_state()
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        txn_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        response = api.commit(
+            self._session.name,
+            self._mutations,
+            single_use_transaction=txn_options,
+            metadata=metadata,
+        )
+        self.committed = _pb_timestamp_to_datetime(response.commit_timestamp)
+        return self.committed
+
+    def __enter__(self):
+        """Begin ``with`` block."""
+        self._check_state()
+
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """End ``with`` block."""
+        if exc_type is None:
+            self.commit()
+
+
+def _make_write_pb(table, columns, values):
+    """Helper for :meth:`Batch.insert` et aliae.
+
+    :type table: str
+    :param table: Name of the table to be modified.
+
+    :type columns: list of str
+    :param columns: Name of the table columns to be modified.
+
+    :type values: list of lists
+    :param values: Values to be modified.
+
+    :rtype: :class:`google.cloud.spanner_v1.proto.mutation_pb2.Mutation.Write`
+    :returns: Write protobuf
+    """
+    return Mutation.Write(
+        table=table, columns=columns, values=_make_list_value_pbs(values)
+    )
diff --git a/spanner/google/cloud/spanner_v1/client.py b/spanner/google/cloud/spanner_v1/client.py
new file mode 100644
index 000000000000..a6f3bd25f5e6
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/client.py
@@ -0,0 +1,337 @@
+# Copyright 2016 Google LLC 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.
+
+"""Parent client for calling the Cloud Spanner API.
+
+This is the base from which all interactions with the API occur.
+
+In the hierarchy of API concepts
+
+* a :class:`~google.cloud.spanner_v1.client.Client` owns an
+  :class:`~google.cloud.spanner_v1.instance.Instance`
+* a :class:`~google.cloud.spanner_v1.instance.Instance` owns a
+  :class:`~google.cloud.spanner_v1.database.Database`
+"""
+import warnings
+
+from google.api_core.gapic_v1 import client_info
+
+# pylint: disable=line-too-long
+from google.cloud.spanner_admin_database_v1.gapic.database_admin_client import (  # noqa
+    DatabaseAdminClient,
+)
+from google.cloud.spanner_admin_instance_v1.gapic.instance_admin_client import (  # noqa
+    InstanceAdminClient,
+)
+
+# pylint: enable=line-too-long
+
+from google.cloud.client import ClientWithProject
+from google.cloud.spanner_v1 import __version__
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+from google.cloud.spanner_v1.instance import DEFAULT_NODE_COUNT
+from google.cloud.spanner_v1.instance import Instance
+
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+SPANNER_ADMIN_SCOPE = "https://www.googleapis.com/auth/spanner.admin"
+_USER_AGENT_DEPRECATED = (
+    "The 'user_agent' argument to 'Client' is deprecated / unused. "
+    "Please pass an appropriate 'client_info' instead."
+)
+
+
+class InstanceConfig(object):
+    """Named configurations for Spanner instances.
+
+    :type name: str
+    :param name: ID of the instance configuration
+
+    :type display_name: str
+    :param display_name: Name of the instance configuration
+    """
+
+    def __init__(self, name, display_name):
+        self.name = name
+        self.display_name = display_name
+
+    @classmethod
+    def from_pb(cls, config_pb):
+        """Construct an instance from the equvalent protobuf.
+
+        :type config_pb:
+          :class:`~google.spanner.v1.spanner_instance_admin_pb2.InstanceConfig`
+        :param config_pb: the protobuf to parse
+
+        :rtype: :class:`InstanceConfig`
+        :returns: an instance of this class
+        """
+        return cls(config_pb.name, config_pb.display_name)
+
+
+class Client(ClientWithProject):
+    """Client for interacting with Cloud Spanner API.
+
+    .. note::
+
+        Since the Cloud Spanner API requires the gRPC transport, no
+        ``_http`` argument is accepted by this class.
+
+    :type project: :class:`str` or :func:`unicode <unicode>`
+    :param project: (Optional) The ID of the project which owns the
+                    instances, tables and data. If not provided, will
+                    attempt to determine from the environment.
+
+    :type credentials:
+        :class:`OAuth2Credentials <oauth2client.client.OAuth2Credentials>` or
+        :data:`NoneType <types.NoneType>`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not provided, defaults to the Google
+                        Application Default Credentials.
+
+    :type client_info: :class:`google.api_core.gapic_v1.client_info.ClientInfo`
+    :param client_info:
+        (Optional) The client info used to send a user-agent string along with
+        API requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library or
+        partner tool.
+
+    :type user_agent: str
+    :param user_agent:
+        (Deprecated) The user agent to be used with API request.
+        Not used.
+
+    :raises: :class:`ValueError <exceptions.ValueError>` if both ``read_only``
+             and ``admin`` are :data:`True`
+    """
+
+    _instance_admin_api = None
+    _database_admin_api = None
+    user_agent = None
+    _SET_PROJECT = True  # Used by from_service_account_json()
+
+    SCOPE = (SPANNER_ADMIN_SCOPE,)
+    """The scopes required for Google Cloud Spanner."""
+
+    def __init__(
+        self, project=None, credentials=None, client_info=_CLIENT_INFO, user_agent=None
+    ):
+        # NOTE: This API has no use for the _http argument, but sending it
+        #       will have no impact since the _http() @property only lazily
+        #       creates a working HTTP object.
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=None
+        )
+        self._client_info = client_info
+
+        if user_agent is not None:
+            warnings.warn(_USER_AGENT_DEPRECATED, DeprecationWarning, stacklevel=2)
+            self.user_agent = user_agent
+
+    @property
+    def credentials(self):
+        """Getter for client's credentials.
+
+        :rtype:
+            :class:`OAuth2Credentials <oauth2client.client.OAuth2Credentials>`
+        :returns: The credentials stored on the client.
+        """
+        return self._credentials
+
+    @property
+    def project_name(self):
+        """Project name to be used with Spanner APIs.
+
+        .. note::
+
+            This property will not change if ``project`` does not, but the
+            return value is not cached.
+
+        The project name is of the form
+
+            ``"projects/{project}"``
+
+        :rtype: str
+        :returns: The project name to be used with the Cloud Spanner Admin
+                  API RPC service.
+        """
+        return "projects/" + self.project
+
+    @property
+    def instance_admin_api(self):
+        """Helper for session-related API calls."""
+        if self._instance_admin_api is None:
+            self._instance_admin_api = InstanceAdminClient(
+                credentials=self.credentials, client_info=self._client_info
+            )
+        return self._instance_admin_api
+
+    @property
+    def database_admin_api(self):
+        """Helper for session-related API calls."""
+        if self._database_admin_api is None:
+            self._database_admin_api = DatabaseAdminClient(
+                credentials=self.credentials, client_info=self._client_info
+            )
+        return self._database_admin_api
+
+    def copy(self):
+        """Make a copy of this client.
+
+        Copies the local data stored as simple types but does not copy the
+        current state of any open connections with the Cloud Bigtable API.
+
+        :rtype: :class:`.Client`
+        :returns: A copy of the current client.
+        """
+        return self.__class__(project=self.project, credentials=self._credentials)
+
+    def list_instance_configs(self, page_size=None, page_token=None):
+        """List available instance configurations for the client's project.
+
+        .. _RPC docs: https://cloud.google.com/spanner/docs/reference/rpc/\
+                      google.spanner.admin.instance.v1#google.spanner.admin.\
+                      instance.v1.InstanceAdmin.ListInstanceConfigs
+
+        See `RPC docs`_.
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of configs in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of configs, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns:
+            Iterator of
+            :class:`~google.cloud.spanner_v1.instance.InstanceConfig`
+            resources within the client's project.
+        """
+        metadata = _metadata_with_prefix(self.project_name)
+        path = "projects/%s" % (self.project,)
+        page_iter = self.instance_admin_api.list_instance_configs(
+            path, page_size=page_size, metadata=metadata
+        )
+        page_iter.next_page_token = page_token
+        page_iter.item_to_value = _item_to_instance_config
+        return page_iter
+
+    def instance(
+        self,
+        instance_id,
+        configuration_name=None,
+        display_name=None,
+        node_count=DEFAULT_NODE_COUNT,
+    ):
+        """Factory to create a instance associated with this client.
+
+        :type instance_id: str
+        :param instance_id: The ID of the instance.
+
+        :type configuration_name: string
+        :param configuration_name:
+           (Optional) Name of the instance configuration used to set up the
+           instance's cluster, in the form:
+           ``projects/<project>/instanceConfigs/<config>``.
+           **Required** for instances which do not yet exist.
+
+        :type display_name: str
+        :param display_name: (Optional) The display name for the instance in
+                             the Cloud Console UI. (Must be between 4 and 30
+                             characters.) If this value is not set in the
+                             constructor, will fall back to the instance ID.
+
+        :type node_count: int
+        :param node_count: (Optional) The number of nodes in the instance's
+                            cluster; used to set up the instance's cluster.
+
+        :rtype: :class:`~google.cloud.spanner_v1.instance.Instance`
+        :returns: an instance owned by this client.
+        """
+        return Instance(instance_id, self, configuration_name, node_count, display_name)
+
+    def list_instances(self, filter_="", page_size=None, page_token=None):
+        """List instances for the client's project.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.InstanceAdmin.ListInstances
+
+        :type filter_: string
+        :param filter_: (Optional) Filter to select instances listed.  See
+                        the ``ListInstancesRequest`` docs above for examples.
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of instances in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of instances, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns:
+            Iterator of :class:`~google.cloud.spanner_v1.instance.Instance`
+            resources within the client's project.
+        """
+        metadata = _metadata_with_prefix(self.project_name)
+        path = "projects/%s" % (self.project,)
+        page_iter = self.instance_admin_api.list_instances(
+            path, page_size=page_size, metadata=metadata
+        )
+        page_iter.item_to_value = self._item_to_instance
+        page_iter.next_page_token = page_token
+        return page_iter
+
+    def _item_to_instance(self, iterator, instance_pb):
+        """Convert an instance protobuf to the native object.
+
+        :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+        :param iterator: The iterator that is currently in use.
+
+        :type instance_pb: :class:`~google.spanner.admin.instance.v1.Instance`
+        :param instance_pb: An instance returned from the API.
+
+        :rtype: :class:`~google.cloud.spanner_v1.instance.Instance`
+        :returns: The next instance in the page.
+        """
+        return Instance.from_pb(instance_pb, self)
+
+
+def _item_to_instance_config(iterator, config_pb):  # pylint: disable=unused-argument
+    """Convert an instance config protobuf to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type config_pb:
+        :class:`~google.spanner.admin.instance.v1.InstanceConfig`
+    :param config_pb: An instance config returned from the API.
+
+    :rtype: :class:`~google.cloud.spanner_v1.instance.InstanceConfig`
+    :returns: The next instance config in the page.
+    """
+    return InstanceConfig.from_pb(config_pb)
diff --git a/spanner/google/cloud/spanner_v1/database.py b/spanner/google/cloud/spanner_v1/database.py
new file mode 100644
index 000000000000..77efca155a98
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/database.py
@@ -0,0 +1,809 @@
+# Copyright 2016 Google LLC 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.
+
+"""User friendly container for Cloud Spanner Database."""
+
+import copy
+import functools
+import re
+import threading
+
+import google.auth.credentials
+from google.protobuf.struct_pb2 import Struct
+from google.cloud.exceptions import NotFound
+import six
+
+# pylint: disable=ungrouped-imports
+from google.cloud.spanner_v1._helpers import _make_value_pb
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+from google.cloud.spanner_v1.batch import Batch
+from google.cloud.spanner_v1.gapic.spanner_client import SpannerClient
+from google.cloud.spanner_v1.keyset import KeySet
+from google.cloud.spanner_v1.pool import BurstyPool
+from google.cloud.spanner_v1.pool import SessionCheckout
+from google.cloud.spanner_v1.session import Session
+from google.cloud.spanner_v1.snapshot import _restart_on_unavailable
+from google.cloud.spanner_v1.snapshot import Snapshot
+from google.cloud.spanner_v1.streamed import StreamedResultSet
+from google.cloud.spanner_v1.proto.transaction_pb2 import (
+    TransactionSelector,
+    TransactionOptions,
+)
+
+# pylint: enable=ungrouped-imports
+
+
+SPANNER_DATA_SCOPE = "https://www.googleapis.com/auth/spanner.data"
+
+
+_DATABASE_NAME_RE = re.compile(
+    r"^projects/(?P<project>[^/]+)/"
+    r"instances/(?P<instance_id>[a-z][-a-z0-9]*)/"
+    r"databases/(?P<database_id>[a-z][a-z0-9_\-]*[a-z0-9])$"
+)
+
+
+class Database(object):
+    """Representation of a Cloud Spanner Database.
+
+    We can use a :class:`Database` to:
+
+    * :meth:`create` the database
+    * :meth:`reload` the database
+    * :meth:`update` the database
+    * :meth:`drop` the database
+
+    :type database_id: str
+    :param database_id: The ID of the database.
+
+    :type instance: :class:`~google.cloud.spanner_v1.instance.Instance`
+    :param instance: The instance that owns the database.
+
+    :type ddl_statements: list of string
+    :param ddl_statements: (Optional) DDL statements, excluding the
+                           CREATE DATABASE statement.
+
+    :type pool: concrete subclass of
+                :class:`~google.cloud.spanner_v1.pool.AbstractSessionPool`.
+    :param pool: (Optional) session pool to be used by database.  If not
+                 passed, the database will construct an instance of
+                 :class:`~google.cloud.spanner_v1.pool.BurstyPool`.
+    """
+
+    _spanner_api = None
+
+    def __init__(self, database_id, instance, ddl_statements=(), pool=None):
+        self.database_id = database_id
+        self._instance = instance
+        self._ddl_statements = _check_ddl_statements(ddl_statements)
+        self._local = threading.local()
+
+        if pool is None:
+            pool = BurstyPool()
+
+        self._pool = pool
+        pool.bind(self)
+
+    @classmethod
+    def from_pb(cls, database_pb, instance, pool=None):
+        """Creates an instance of this class from a protobuf.
+
+        :type database_pb:
+            :class:`google.spanner.v2.spanner_instance_admin_pb2.Instance`
+        :param database_pb: A instance protobuf object.
+
+        :type instance: :class:`~google.cloud.spanner_v1.instance.Instance`
+        :param instance: The instance that owns the database.
+
+        :type pool: concrete subclass of
+                    :class:`~google.cloud.spanner_v1.pool.AbstractSessionPool`.
+        :param pool: (Optional) session pool to be used by database.
+
+        :rtype: :class:`Database`
+        :returns: The database parsed from the protobuf response.
+        :raises ValueError:
+            if the instance name does not match the expected format
+            or if the parsed project ID does not match the project ID
+            on the instance's client, or if the parsed instance ID does
+            not match the instance's ID.
+        """
+        match = _DATABASE_NAME_RE.match(database_pb.name)
+        if match is None:
+            raise ValueError(
+                "Database protobuf name was not in the " "expected format.",
+                database_pb.name,
+            )
+        if match.group("project") != instance._client.project:
+            raise ValueError(
+                "Project ID on database does not match the "
+                "project ID on the instance's client"
+            )
+        instance_id = match.group("instance_id")
+        if instance_id != instance.instance_id:
+            raise ValueError(
+                "Instance ID on database does not match the "
+                "Instance ID on the instance"
+            )
+        database_id = match.group("database_id")
+
+        return cls(database_id, instance, pool=pool)
+
+    @property
+    def name(self):
+        """Database name used in requests.
+
+        .. note::
+
+          This property will not change if ``database_id`` does not, but the
+          return value is not cached.
+
+        The database name is of the form
+
+            ``"projects/../instances/../databases/{database_id}"``
+
+        :rtype: str
+        :returns: The database name.
+        """
+        return self._instance.name + "/databases/" + self.database_id
+
+    @property
+    def ddl_statements(self):
+        """DDL Statements used to define database schema.
+
+        See
+        cloud.google.com/spanner/docs/data-definition-language
+
+        :rtype: sequence of string
+        :returns: the statements
+        """
+        return self._ddl_statements
+
+    @property
+    def spanner_api(self):
+        """Helper for session-related API calls."""
+        if self._spanner_api is None:
+            credentials = self._instance._client.credentials
+            if isinstance(credentials, google.auth.credentials.Scoped):
+                credentials = credentials.with_scopes((SPANNER_DATA_SCOPE,))
+            client_info = self._instance._client._client_info
+            self._spanner_api = SpannerClient(
+                credentials=credentials, client_info=client_info
+            )
+        return self._spanner_api
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return (
+            other.database_id == self.database_id and other._instance == self._instance
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    def create(self):
+        """Create this database within its instance
+
+        Inclues any configured schema assigned to :attr:`ddl_statements`.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase
+
+        :rtype: :class:`~google.api_core.operation.Operation`
+        :returns: a future used to poll the status of the create request
+        :raises Conflict: if the database already exists
+        :raises NotFound: if the instance owning the database does not exist
+        """
+        api = self._instance._client.database_admin_api
+        metadata = _metadata_with_prefix(self.name)
+        db_name = self.database_id
+        if "-" in db_name:
+            db_name = "`%s`" % (db_name,)
+
+        future = api.create_database(
+            parent=self._instance.name,
+            create_statement="CREATE DATABASE %s" % (db_name,),
+            extra_statements=list(self._ddl_statements),
+            metadata=metadata,
+        )
+        return future
+
+    def exists(self):
+        """Test whether this database exists.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDDL
+
+        :rtype: bool
+        :returns: True if the database exists, else false.
+        """
+        api = self._instance._client.database_admin_api
+        metadata = _metadata_with_prefix(self.name)
+
+        try:
+            api.get_database_ddl(self.name, metadata=metadata)
+        except NotFound:
+            return False
+        return True
+
+    def reload(self):
+        """Reload this database.
+
+        Refresh any configured schema into :attr:`ddl_statements`.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDDL
+
+        :raises NotFound: if the database does not exist
+        """
+        api = self._instance._client.database_admin_api
+        metadata = _metadata_with_prefix(self.name)
+        response = api.get_database_ddl(self.name, metadata=metadata)
+        self._ddl_statements = tuple(response.statements)
+
+    def update_ddl(self, ddl_statements, operation_id=""):
+        """Update DDL for this database.
+
+        Apply any configured schema from :attr:`ddl_statements`.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabase
+
+        :type ddl_statements: Sequence[str]
+        :param ddl_statements: a list of DDL statements to use on this database
+        :type operation_id: str
+        :param operation_id: (optional) a string ID for the long-running operation
+
+        :rtype: :class:`google.api_core.operation.Operation`
+        :returns: an operation instance
+        :raises NotFound: if the database does not exist
+        """
+        client = self._instance._client
+        api = client.database_admin_api
+        metadata = _metadata_with_prefix(self.name)
+
+        future = api.update_database_ddl(
+            self.name, ddl_statements, operation_id=operation_id, metadata=metadata
+        )
+        return future
+
+    def drop(self):
+        """Drop this database.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase
+        """
+        api = self._instance._client.database_admin_api
+        metadata = _metadata_with_prefix(self.name)
+        api.drop_database(self.name, metadata=metadata)
+
+    def execute_partitioned_dml(self, dml, params=None, param_types=None):
+        """Execute a partitionable DML statement.
+
+        :type dml: str
+        :param dml: DML statement
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``dml``.
+
+        :type param_types: dict[str -> Union[dict, .types.Type]]
+        :param param_types:
+            (Optional) maps explicit types for one or more param values;
+            required if parameters are passed.
+
+        :rtype: int
+        :returns: Count of rows affected by the DML statement.
+        """
+        if params is not None:
+            if param_types is None:
+                raise ValueError("Specify 'param_types' when passing 'params'.")
+            params_pb = Struct(
+                fields={key: _make_value_pb(value) for key, value in params.items()}
+            )
+        else:
+            params_pb = None
+
+        api = self.spanner_api
+
+        txn_options = TransactionOptions(
+            partitioned_dml=TransactionOptions.PartitionedDml()
+        )
+
+        metadata = _metadata_with_prefix(self.name)
+
+        with SessionCheckout(self._pool) as session:
+
+            txn = api.begin_transaction(session.name, txn_options, metadata=metadata)
+
+            txn_selector = TransactionSelector(id=txn.id)
+
+            restart = functools.partial(
+                api.execute_streaming_sql,
+                session.name,
+                dml,
+                transaction=txn_selector,
+                params=params_pb,
+                param_types=param_types,
+                metadata=metadata,
+            )
+
+            iterator = _restart_on_unavailable(restart)
+
+            result_set = StreamedResultSet(iterator)
+            list(result_set)  # consume all partials
+
+            return result_set.stats.row_count_lower_bound
+
+    def session(self, labels=None):
+        """Factory to create a session for this database.
+
+        :type labels: dict (str -> str) or None
+        :param labels: (Optional) user-assigned labels for the session.
+
+        :rtype: :class:`~google.cloud.spanner_v1.session.Session`
+        :returns: a session bound to this database.
+        """
+        return Session(self, labels=labels)
+
+    def snapshot(self, **kw):
+        """Return an object which wraps a snapshot.
+
+        The wrapper *must* be used as a context manager, with the snapshot
+        as the value returned by the wrapper.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.TransactionOptions.ReadOnly
+
+        :type kw: dict
+        :param kw:
+            Passed through to
+            :class:`~google.cloud.spanner_v1.snapshot.Snapshot` constructor.
+
+        :rtype: :class:`~google.cloud.spanner_v1.database.SnapshotCheckout`
+        :returns: new wrapper
+        """
+        return SnapshotCheckout(self, **kw)
+
+    def batch(self):
+        """Return an object which wraps a batch.
+
+        The wrapper *must* be used as a context manager, with the batch
+        as the value returned by the wrapper.
+
+        :rtype: :class:`~google.cloud.spanner_v1.database.BatchCheckout`
+        :returns: new wrapper
+        """
+        return BatchCheckout(self)
+
+    def batch_snapshot(self, read_timestamp=None, exact_staleness=None):
+        """Return an object which wraps a batch read / query.
+
+        :type read_timestamp: :class:`datetime.datetime`
+        :param read_timestamp: Execute all reads at the given timestamp.
+
+        :type exact_staleness: :class:`datetime.timedelta`
+        :param exact_staleness: Execute all reads at a timestamp that is
+                                ``exact_staleness`` old.
+
+        :rtype: :class:`~google.cloud.spanner_v1.database.BatchSnapshot`
+        :returns: new wrapper
+        """
+        return BatchSnapshot(
+            self, read_timestamp=read_timestamp, exact_staleness=exact_staleness
+        )
+
+    def run_in_transaction(self, func, *args, **kw):
+        """Perform a unit of work in a transaction, retrying on abort.
+
+        :type func: callable
+        :param func: takes a required positional argument, the transaction,
+                     and additional positional / keyword arguments as supplied
+                     by the caller.
+
+        :type args: tuple
+        :param args: additional positional arguments to be passed to ``func``.
+
+        :type kw: dict
+        :param kw: optional keyword arguments to be passed to ``func``.
+                   If passed, "timeout_secs" will be removed and used to
+                   override the default timeout.
+
+        :rtype: :class:`datetime.datetime`
+        :returns: timestamp of committed transaction
+        """
+        # Sanity check: Is there a transaction already running?
+        # If there is, then raise a red flag. Otherwise, mark that this one
+        # is running.
+        if getattr(self._local, "transaction_running", False):
+            raise RuntimeError("Spanner does not support nested transactions.")
+        self._local.transaction_running = True
+
+        # Check out a session and run the function in a transaction; once
+        # done, flip the sanity check bit back.
+        try:
+            with SessionCheckout(self._pool) as session:
+                return session.run_in_transaction(func, *args, **kw)
+        finally:
+            self._local.transaction_running = False
+
+
+class BatchCheckout(object):
+    """Context manager for using a batch from a database.
+
+    Inside the context manager, checks out a session from the database,
+    creates a batch from it, making the batch available.
+
+    Caller must *not* use the batch to perform API requests outside the scope
+    of the context manager.
+
+    :type database: :class:`~google.cloud.spanner.database.Database`
+    :param database: database to use
+    """
+
+    def __init__(self, database):
+        self._database = database
+        self._session = self._batch = None
+
+    def __enter__(self):
+        """Begin ``with`` block."""
+        session = self._session = self._database._pool.get()
+        batch = self._batch = Batch(session)
+        return batch
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """End ``with`` block."""
+        try:
+            if exc_type is None:
+                self._batch.commit()
+        finally:
+            self._database._pool.put(self._session)
+
+
+class SnapshotCheckout(object):
+    """Context manager for using a snapshot from a database.
+
+    Inside the context manager, checks out a session from the database,
+    creates a snapshot from it, making the snapshot available.
+
+    Caller must *not* use the snapshot to perform API requests outside the
+    scope of the context manager.
+
+    :type database: :class:`~google.cloud.spanner.database.Database`
+    :param database: database to use
+
+    :type kw: dict
+    :param kw:
+        Passed through to
+        :class:`~google.cloud.spanner_v1.snapshot.Snapshot` constructor.
+    """
+
+    def __init__(self, database, **kw):
+        self._database = database
+        self._session = None
+        self._kw = kw
+
+    def __enter__(self):
+        """Begin ``with`` block."""
+        session = self._session = self._database._pool.get()
+        return Snapshot(session, **self._kw)
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """End ``with`` block."""
+        self._database._pool.put(self._session)
+
+
+class BatchSnapshot(object):
+    """Wrapper for generating and processing read / query batches.
+
+    :type database: :class:`~google.cloud.spanner.database.Database`
+    :param database: database to use
+
+    :type read_timestamp: :class:`datetime.datetime`
+    :param read_timestamp: Execute all reads at the given timestamp.
+
+    :type exact_staleness: :class:`datetime.timedelta`
+    :param exact_staleness: Execute all reads at a timestamp that is
+                            ``exact_staleness`` old.
+    """
+
+    def __init__(self, database, read_timestamp=None, exact_staleness=None):
+        self._database = database
+        self._session = None
+        self._snapshot = None
+        self._read_timestamp = read_timestamp
+        self._exact_staleness = exact_staleness
+
+    @classmethod
+    def from_dict(cls, database, mapping):
+        """Reconstruct an instance from a mapping.
+
+        :type database: :class:`~google.cloud.spanner.database.Database`
+        :param database: database to use
+
+        :type mapping: mapping
+        :param mapping: serialized state of the instance
+
+        :rtype: :class:`BatchSnapshot`
+        """
+        instance = cls(database)
+        session = instance._session = database.session()
+        session._session_id = mapping["session_id"]
+        snapshot = instance._snapshot = session.snapshot()
+        snapshot._transaction_id = mapping["transaction_id"]
+        return instance
+
+    def to_dict(self):
+        """Return state as a dictionary.
+
+        Result can be used to serialize the instance and reconstitute
+        it later using :meth:`from_dict`.
+
+        :rtype: dict
+        """
+        session = self._get_session()
+        snapshot = self._get_snapshot()
+        return {
+            "session_id": session._session_id,
+            "transaction_id": snapshot._transaction_id,
+        }
+
+    def _get_session(self):
+        """Create session as needed.
+
+        .. note::
+
+           Caller is responsible for cleaning up the session after
+           all partitions have been processed.
+        """
+        if self._session is None:
+            session = self._session = self._database.session()
+            session.create()
+        return self._session
+
+    def _get_snapshot(self):
+        """Create snapshot if needed."""
+        if self._snapshot is None:
+            self._snapshot = self._get_session().snapshot(
+                read_timestamp=self._read_timestamp,
+                exact_staleness=self._exact_staleness,
+                multi_use=True,
+            )
+            self._snapshot.begin()
+        return self._snapshot
+
+    def read(self, *args, **kw):
+        """Convenience method:  perform read operation via snapshot.
+
+        See :meth:`~google.cloud.spanner_v1.snapshot.Snapshot.read`.
+        """
+        return self._get_snapshot().read(*args, **kw)
+
+    def execute_sql(self, *args, **kw):
+        """Convenience method:  perform query operation via snapshot.
+
+        See :meth:`~google.cloud.spanner_v1.snapshot.Snapshot.execute_sql`.
+        """
+        return self._get_snapshot().execute_sql(*args, **kw)
+
+    def generate_read_batches(
+        self,
+        table,
+        columns,
+        keyset,
+        index="",
+        partition_size_bytes=None,
+        max_partitions=None,
+    ):
+        """Start a partitioned batch read operation.
+
+        Uses the ``PartitionRead`` API request to initiate the partitioned
+        read.  Returns a list of batch information needed to perform the
+        actual reads.
+
+        :type table: str
+        :param table: name of the table from which to fetch data
+
+        :type columns: list of str
+        :param columns: names of columns to be retrieved
+
+        :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
+        :param keyset: keys / ranges identifying rows to be retrieved
+
+        :type index: str
+        :param index: (Optional) name of index to use, rather than the
+                      table's primary key
+
+        :type partition_size_bytes: int
+        :param partition_size_bytes:
+            (Optional) desired size for each partition generated.  The service
+            uses this as a hint, the actual partition size may differ.
+
+        :type max_partitions: int
+        :param max_partitions:
+            (Optional) desired maximum number of partitions generated. The
+            service uses this as a hint, the actual number of partitions may
+            differ.
+
+        :rtype: iterable of dict
+        :returns:
+            mappings of information used peform actual partitioned reads via
+            :meth:`process_read_batch`.
+        """
+        partitions = self._get_snapshot().partition_read(
+            table=table,
+            columns=columns,
+            keyset=keyset,
+            index=index,
+            partition_size_bytes=partition_size_bytes,
+            max_partitions=max_partitions,
+        )
+
+        read_info = {
+            "table": table,
+            "columns": columns,
+            "keyset": keyset._to_dict(),
+            "index": index,
+        }
+        for partition in partitions:
+            yield {"partition": partition, "read": read_info.copy()}
+
+    def process_read_batch(self, batch):
+        """Process a single, partitioned read.
+
+        :type batch: mapping
+        :param batch:
+            one of the mappings returned from an earlier call to
+            :meth:`generate_read_batches`.
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+        """
+        kwargs = copy.deepcopy(batch["read"])
+        keyset_dict = kwargs.pop("keyset")
+        kwargs["keyset"] = KeySet._from_dict(keyset_dict)
+        return self._get_snapshot().read(partition=batch["partition"], **kwargs)
+
+    def generate_query_batches(
+        self,
+        sql,
+        params=None,
+        param_types=None,
+        partition_size_bytes=None,
+        max_partitions=None,
+    ):
+        """Start a partitioned query operation.
+
+        Uses the ``PartitionQuery`` API request to start a partitioned
+        query operation.  Returns a list of batch information needed to
+        peform the actual queries.
+
+        :type sql: str
+        :param sql: SQL query statement
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``sql``.
+
+        :type param_types: dict[str -> Union[dict, .types.Type]]
+        :param param_types:
+            (Optional) maps explicit types for one or more param values;
+            required if parameters are passed.
+
+        :type partition_size_bytes: int
+        :param partition_size_bytes:
+            (Optional) desired size for each partition generated.  The service
+            uses this as a hint, the actual partition size may differ.
+
+        :type partition_size_bytes: int
+        :param partition_size_bytes:
+            (Optional) desired size for each partition generated.  The service
+            uses this as a hint, the actual partition size may differ.
+
+        :type max_partitions: int
+        :param max_partitions:
+            (Optional) desired maximum number of partitions generated. The
+            service uses this as a hint, the actual number of partitions may
+            differ.
+
+        :rtype: iterable of dict
+        :returns:
+            mappings of information used peform actual partitioned reads via
+            :meth:`process_read_batch`.
+        """
+        partitions = self._get_snapshot().partition_query(
+            sql=sql,
+            params=params,
+            param_types=param_types,
+            partition_size_bytes=partition_size_bytes,
+            max_partitions=max_partitions,
+        )
+
+        query_info = {"sql": sql}
+        if params:
+            query_info["params"] = params
+            query_info["param_types"] = param_types
+
+        for partition in partitions:
+            yield {"partition": partition, "query": query_info}
+
+    def process_query_batch(self, batch):
+        """Process a single, partitioned query.
+
+        :type batch: mapping
+        :param batch:
+            one of the mappings returned from an earlier call to
+            :meth:`generate_query_batches`.
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+        """
+        return self._get_snapshot().execute_sql(
+            partition=batch["partition"], **batch["query"]
+        )
+
+    def process(self, batch):
+        """Process a single, partitioned query or read.
+
+        :type batch: mapping
+        :param batch:
+            one of the mappings returned from an earlier call to
+            :meth:`generate_query_batches`.
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+        :raises ValueError: if batch does not contain either 'read' or 'query'
+        """
+        if "query" in batch:
+            return self.process_query_batch(batch)
+        if "read" in batch:
+            return self.process_read_batch(batch)
+        raise ValueError("Invalid batch")
+
+    def close(self):
+        """Clean up underlying session.
+
+        .. note::
+
+           If the transaction has been shared across multiple machines,
+           calling this on any machine would invalidate the transaction
+           everywhere. Ideally this would be called when data has been read
+           from all the partitions.
+        """
+        if self._session is not None:
+            self._session.delete()
+
+
+def _check_ddl_statements(value):
+    """Validate DDL Statements used to define database schema.
+
+    See
+    https://cloud.google.com/spanner/docs/data-definition-language
+
+    :type value: list of string
+    :param value: DDL statements, excluding the 'CREATE DATABSE' statement
+
+    :rtype: tuple
+    :returns: tuple of validated DDL statement strings.
+    :raises ValueError:
+        if elements in ``value`` are not strings, or if ``value`` contains
+        a ``CREATE DATABASE`` statement.
+    """
+    if not all(isinstance(line, six.string_types) for line in value):
+        raise ValueError("Pass a list of strings")
+
+    if any("create database" in line.lower() for line in value):
+        raise ValueError("Do not pass a 'CREATE DATABASE' statement")
+
+    return tuple(value)
diff --git a/spanner/google/cloud/spanner_v1/gapic/__init__.py b/spanner/google/cloud/spanner_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_v1/gapic/enums.py b/spanner/google/cloud/spanner_v1/gapic/enums.py
new file mode 100644
index 000000000000..5f38def2b828
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/gapic/enums.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class NullValue(enum.IntEnum):
+    """
+    ``NullValue`` is a singleton enumeration to represent the null value for
+    the ``Value`` type union.
+
+    The JSON representation for ``NullValue`` is JSON ``null``.
+
+    Attributes:
+      NULL_VALUE (int): Null value.
+    """
+
+    NULL_VALUE = 0
+
+
+class TypeCode(enum.IntEnum):
+    """
+    ``TypeCode`` is used as part of ``Type`` to indicate the type of a Cloud
+    Spanner value.
+
+    Each legal value of a type can be encoded to or decoded from a JSON
+    value, using the encodings described below. All Cloud Spanner values can
+    be ``null``, regardless of type; ``null``\ s are always encoded as a
+    JSON ``null``.
+
+    Attributes:
+      TYPE_CODE_UNSPECIFIED (int): Not specified.
+      BOOL (int): Encoded as JSON ``true`` or ``false``.
+      INT64 (int): Encoded as ``string``, in decimal format.
+      FLOAT64 (int): Encoded as ``number``, or the strings ``"NaN"``, ``"Infinity"``, or
+      ``"-Infinity"``.
+      TIMESTAMP (int): Encoded as ``string`` in RFC 3339 timestamp format. The time zone must
+      be present, and must be ``"Z"``.
+
+      If the schema has the column option ``allow_commit_timestamp=true``, the
+      placeholder string ``"spanner.commit_timestamp()"`` can be used to
+      instruct the system to insert the commit timestamp associated with the
+      transaction commit.
+      DATE (int): Encoded as ``string`` in RFC 3339 date format.
+      STRING (int): Encoded as ``string``.
+      BYTES (int): Encoded as a base64-encoded ``string``, as described in RFC 4648,
+      section 4.
+      ARRAY (int): Encoded as ``list``, where the list elements are represented according
+      to ``array_element_type``.
+      STRUCT (int): Encoded as ``list``, where list element ``i`` is represented according
+      to [struct\_type.fields[i]][google.spanner.v1.StructType.fields].
+    """
+
+    TYPE_CODE_UNSPECIFIED = 0
+    BOOL = 1
+    INT64 = 2
+    FLOAT64 = 3
+    TIMESTAMP = 4
+    DATE = 5
+    STRING = 6
+    BYTES = 7
+    ARRAY = 8
+    STRUCT = 9
+
+
+class ExecuteSqlRequest(object):
+    class QueryMode(enum.IntEnum):
+        """
+        Mode in which the statement must be processed.
+
+        Attributes:
+          NORMAL (int): The default mode. Only the statement results are returned.
+          PLAN (int): This mode returns only the query plan, without any results or
+          execution statistics information.
+          PROFILE (int): This mode returns both the query plan and the execution statistics along
+          with the results.
+        """
+
+        NORMAL = 0
+        PLAN = 1
+        PROFILE = 2
+
+
+class PlanNode(object):
+    class Kind(enum.IntEnum):
+        """
+        The kind of ``PlanNode``. Distinguishes between the two different kinds
+        of nodes that can appear in a query plan.
+
+        Attributes:
+          KIND_UNSPECIFIED (int): Not specified.
+          RELATIONAL (int): Denotes a Relational operator node in the expression tree. Relational
+          operators represent iterative processing of rows during query execution.
+          For example, a ``TableScan`` operation that reads rows from a table.
+          SCALAR (int): Denotes a Scalar node in the expression tree. Scalar nodes represent
+          non-iterable entities in the query plan. For example, constants or
+          arithmetic operators appearing inside predicate expressions or references
+          to column names.
+        """
+
+        KIND_UNSPECIFIED = 0
+        RELATIONAL = 1
+        SCALAR = 2
diff --git a/spanner/google/cloud/spanner_v1/gapic/spanner_client.py b/spanner/google/cloud/spanner_v1/gapic/spanner_client.py
new file mode 100644
index 000000000000..41490b0a2869
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/gapic/spanner_client.py
@@ -0,0 +1,1903 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.spanner.v1 Spanner API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.spanner_v1.gapic import enums
+from google.cloud.spanner_v1.gapic import spanner_client_config
+from google.cloud.spanner_v1.gapic.transports import spanner_grpc_transport
+from google.cloud.spanner_v1.proto import keys_pb2
+from google.cloud.spanner_v1.proto import mutation_pb2
+from google.cloud.spanner_v1.proto import result_set_pb2
+from google.cloud.spanner_v1.proto import spanner_pb2
+from google.cloud.spanner_v1.proto import spanner_pb2_grpc
+from google.cloud.spanner_v1.proto import transaction_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import struct_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version
+
+
+class SpannerClient(object):
+    """
+    Cloud Spanner API
+
+    The Cloud Spanner API can be used to manage sessions and execute
+    transactions on data stored in Cloud Spanner databases.
+    """
+
+    SERVICE_ADDRESS = "spanner.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.spanner.v1.Spanner"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            SpannerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def database_path(cls, project, instance, database):
+        """Return a fully-qualified database string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/databases/{database}",
+            project=project,
+            instance=instance,
+            database=database,
+        )
+
+    @classmethod
+    def session_path(cls, project, instance, database, session):
+        """Return a fully-qualified session string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/instances/{instance}/databases/{database}/sessions/{session}",
+            project=project,
+            instance=instance,
+            database=database,
+            session=session,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.SpannerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.SpannerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = spanner_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=spanner_grpc_transport.SpannerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = spanner_grpc_transport.SpannerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_session(
+        self,
+        database,
+        session=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 transactions.
+
+        Sessions can only execute one transaction at a time. To execute multiple
+        concurrent read-write/write-only transactions, create multiple sessions.
+        Note that standalone reads and queries use a 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 operations are sent for more than an hour. If a session is deleted,
+        requests to it return ``NOT_FOUND``.
+
+        Idle sessions can be kept alive by sending a trivial SQL query
+        periodically, e.g., ``"SELECT 1"``.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> database = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> response = client.create_session(database)
+
+        Args:
+            database (str): Required. The database in which the new session is created.
+            session (Union[dict, ~google.cloud.spanner_v1.types.Session]): The session to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Session`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.Session` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_session" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_session"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_session,
+                default_retry=self._method_configs["CreateSession"].retry,
+                default_timeout=self._method_configs["CreateSession"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.CreateSessionRequest(database=database, session=session)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_session"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_create_sessions(
+        self,
+        database,
+        session_template=None,
+        session_count=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> database = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> response = client.batch_create_sessions(database)
+
+        Args:
+            database (str): Required. The database in which the new sessions are created.
+            session_template (Union[dict, ~google.cloud.spanner_v1.types.Session]): Parameters to be applied to each created session.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Session`
+            session_count (int): 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`` as necessary).
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.BatchCreateSessionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_create_sessions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_create_sessions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_create_sessions,
+                default_retry=self._method_configs["BatchCreateSessions"].retry,
+                default_timeout=self._method_configs["BatchCreateSessions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.BatchCreateSessionsRequest(
+            database=database,
+            session_template=session_template,
+            session_count=session_count,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_create_sessions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_session(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a session. Returns ``NOT_FOUND`` if the session does not exist.
+        This is mainly useful for determining whether a session is still alive.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> name = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> response = client.get_session(name)
+
+        Args:
+            name (str): Required. The name of the session to retrieve.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.Session` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_session" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_session"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_session,
+                default_retry=self._method_configs["GetSession"].retry,
+                default_timeout=self._method_configs["GetSession"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.GetSessionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_session"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_sessions(
+        self,
+        database,
+        page_size=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all sessions in a given database.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> database = client.database_path('[PROJECT]', '[INSTANCE]', '[DATABASE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_sessions(database):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_sessions(database).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            database (str): Required. The database in which to list sessions.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            filter_ (str): An expression for filtering the results of the request. Filter rules are
+                case insensitive. The fields eligible for filtering are:
+
+                -  ``labels.key`` where key is the name of a label
+
+                Some examples of using filters are:
+
+                -  ``labels.env:*`` --> The session has the label "env".
+                -  ``labels.env:dev`` --> The session has the label "env" and the value
+                   of the label contains the string "dev".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.spanner_v1.types.Session` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_sessions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_sessions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_sessions,
+                default_retry=self._method_configs["ListSessions"].retry,
+                default_timeout=self._method_configs["ListSessions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.ListSessionsRequest(
+            database=database, page_size=page_size, filter=filter_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("database", database)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_sessions"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="sessions",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def delete_session(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Ends a session, releasing server resources associated with it. This will
+        asynchronously trigger cancellation of any operations that are running with
+        this session.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> name = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> client.delete_session(name)
+
+        Args:
+            name (str): Required. The name of the session to delete.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_session" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_session"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_session,
+                default_retry=self._method_configs["DeleteSession"].retry,
+                default_timeout=self._method_configs["DeleteSession"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.DeleteSessionRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_session"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def execute_sql(
+        self,
+        session,
+        sql,
+        transaction=None,
+        params=None,
+        param_types=None,
+        resume_token=None,
+        query_mode=None,
+        partition_token=None,
+        seqno=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Executes an SQL statement, returning all results in a single reply. This
+        method cannot be used to return a result set larger than 10 MiB; if the
+        query yields more data than that, the query fails with a
+        ``FAILED_PRECONDITION`` error.
+
+        Operations inside read-write transactions might return ``ABORTED``. If
+        this occurs, the application should restart the transaction from the
+        beginning. See ``Transaction`` for more details.
+
+        Larger result sets can be fetched in streaming fashion by calling
+        ``ExecuteStreamingSql`` instead.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `sql`:
+            >>> sql = ''
+            >>>
+            >>> response = client.execute_sql(session, sql)
+
+        Args:
+            session (str): Required. The session in which the SQL query should be performed.
+            sql (str): Required. The SQL string.
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): 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.
+
+                Partitioned DML requires an existing PartitionedDml transaction ID.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): 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.
+
+                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.
+
+                Parameter values are specified using ``params``, which is a JSON object
+                whose keys are parameter names, and whose values are the corresponding
+                parameter values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Struct`
+            param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): 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`` 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 definition
+                of ``Type`` for more information about SQL types.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Type`
+            resume_token (bytes): If this request is resuming a previously interrupted SQL statement
+                execution, ``resume_token`` should be copied from the last
+                ``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.
+            query_mode (~google.cloud.spanner_v1.types.QueryMode): Used to control the amount of debugging information returned in
+                ``ResultSetStats``. If ``partition_token`` is set, ``query_mode`` can
+                only be set to ``QueryMode.NORMAL``.
+            partition_token (bytes): If present, results will be restricted to the specified partition
+                previously created using PartitionQuery(). There must be an exact match
+                for the values of fields common to this message and the
+                PartitionQueryRequest message used to create this partition\_token.
+            seqno (long): A per-transaction sequence number used to identify this request. This
+                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.
+
+                Required for DML statements. Ignored for queries.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.ResultSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "execute_sql" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "execute_sql"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.execute_sql,
+                default_retry=self._method_configs["ExecuteSql"].retry,
+                default_timeout=self._method_configs["ExecuteSql"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.ExecuteSqlRequest(
+            session=session,
+            sql=sql,
+            transaction=transaction,
+            params=params,
+            param_types=param_types,
+            resume_token=resume_token,
+            query_mode=query_mode,
+            partition_token=partition_token,
+            seqno=seqno,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["execute_sql"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def execute_streaming_sql(
+        self,
+        session,
+        sql,
+        transaction=None,
+        params=None,
+        param_types=None,
+        resume_token=None,
+        query_mode=None,
+        partition_token=None,
+        seqno=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Like ``ExecuteSql``, except returns the result set as a stream. Unlike
+        ``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.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `sql`:
+            >>> sql = ''
+            >>>
+            >>> for element in client.execute_streaming_sql(session, sql):
+            ...     # process element
+            ...     pass
+
+        Args:
+            session (str): Required. The session in which the SQL query should be performed.
+            sql (str): Required. The SQL string.
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): 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.
+
+                Partitioned DML requires an existing PartitionedDml transaction ID.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): 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.
+
+                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.
+
+                Parameter values are specified using ``params``, which is a JSON object
+                whose keys are parameter names, and whose values are the corresponding
+                parameter values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Struct`
+            param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): 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`` 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 definition
+                of ``Type`` for more information about SQL types.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Type`
+            resume_token (bytes): If this request is resuming a previously interrupted SQL statement
+                execution, ``resume_token`` should be copied from the last
+                ``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.
+            query_mode (~google.cloud.spanner_v1.types.QueryMode): Used to control the amount of debugging information returned in
+                ``ResultSetStats``. If ``partition_token`` is set, ``query_mode`` can
+                only be set to ``QueryMode.NORMAL``.
+            partition_token (bytes): If present, results will be restricted to the specified partition
+                previously created using PartitionQuery(). There must be an exact match
+                for the values of fields common to this message and the
+                PartitionQueryRequest message used to create this partition\_token.
+            seqno (long): A per-transaction sequence number used to identify this request. This
+                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.
+
+                Required for DML statements. Ignored for queries.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.spanner_v1.types.PartialResultSet].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "execute_streaming_sql" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "execute_streaming_sql"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.execute_streaming_sql,
+                default_retry=self._method_configs["ExecuteStreamingSql"].retry,
+                default_timeout=self._method_configs["ExecuteStreamingSql"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.ExecuteSqlRequest(
+            session=session,
+            sql=sql,
+            transaction=transaction,
+            params=params,
+            param_types=param_types,
+            resume_token=resume_token,
+            query_mode=query_mode,
+            partition_token=partition_token,
+            seqno=seqno,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["execute_streaming_sql"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def execute_batch_dml(
+        self,
+        session,
+        transaction,
+        statements,
+        seqno,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Executes a batch of SQL DML statements. This method allows many
+        statements to be run with lower latency than submitting them
+        sequentially with ``ExecuteSql``.
+
+        Statements are executed in order, sequentially.
+        ``ExecuteBatchDmlResponse`` will contain a ``ResultSet`` for each DML
+        statement that has successfully executed. If a statement fails, its
+        error status will be returned as part of the
+        ``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`` and
+        ``ExecuteBatchDmlResponse``.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `transaction`:
+            >>> transaction = {}
+            >>>
+            >>> # TODO: Initialize `statements`:
+            >>> statements = []
+            >>>
+            >>> # TODO: Initialize `seqno`:
+            >>> seqno = 0
+            >>>
+            >>> response = client.execute_batch_dml(session, transaction, statements, seqno)
+
+        Args:
+            session (str): Required. The session in which the DML statements should be performed.
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            statements (list[Union[dict, ~google.cloud.spanner_v1.types.Statement]]): 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.
+
+                REQUIRES: statements\_size() > 0.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Statement`
+            seqno (long): A per-transaction sequence number used to identify this request. This is
+                used in the same space as the seqno in ``ExecuteSqlRequest``. See more
+                details in ``ExecuteSqlRequest``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.ExecuteBatchDmlResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "execute_batch_dml" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "execute_batch_dml"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.execute_batch_dml,
+                default_retry=self._method_configs["ExecuteBatchDml"].retry,
+                default_timeout=self._method_configs["ExecuteBatchDml"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.ExecuteBatchDmlRequest(
+            session=session, transaction=transaction, statements=statements, seqno=seqno
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["execute_batch_dml"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def read(
+        self,
+        session,
+        table,
+        columns,
+        key_set,
+        transaction=None,
+        index=None,
+        limit=None,
+        resume_token=None,
+        partition_token=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Reads rows from the database using key lookups and scans, as a simple
+        key/value style alternative to ``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`` for more details.
+
+        Larger result sets can be yielded in streaming fashion by calling
+        ``StreamingRead`` instead.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `table`:
+            >>> table = ''
+            >>>
+            >>> # TODO: Initialize `columns`:
+            >>> columns = []
+            >>>
+            >>> # TODO: Initialize `key_set`:
+            >>> key_set = {}
+            >>>
+            >>> response = client.read(session, table, columns, key_set)
+
+        Args:
+            session (str): Required. The session in which the read should be performed.
+            table (str): Required. The name of the table in the database to be read.
+            columns (list[str]): The columns of ``table`` to be returned for each row matching this
+                request.
+            key_set (Union[dict, ~google.cloud.spanner_v1.types.KeySet]): Required. ``key_set`` identifies the rows to be yielded. ``key_set``
+                names the primary keys of the rows in ``table`` to be yielded, unless
+                ``index`` is present. If ``index`` is present, then ``key_set`` instead
+                names index keys in ``index``.
+
+                If the ``partition_token`` field is empty, rows are yielded in table
+                primary key order (if ``index`` is empty) or index key order (if
+                ``index`` is non-empty). If the ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.KeySet`
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): The transaction to use. If none is provided, the default is a
+                temporary read-only transaction with strong concurrency.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            index (str): If non-empty, the name of an index on ``table``. This index is used
+                instead of the table primary key when interpreting ``key_set`` and
+                sorting result rows. See ``key_set`` for further information.
+            limit (long): 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 ``partition_token`` is set.
+            resume_token (bytes): If this request is resuming a previously interrupted read,
+                ``resume_token`` should be copied from the last ``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.
+            partition_token (bytes): If present, results will be restricted to the specified partition
+                previously created using PartitionRead(). There must be an exact match
+                for the values of fields common to this message and the
+                PartitionReadRequest message used to create this partition\_token.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.ResultSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "read" not in self._inner_api_calls:
+            self._inner_api_calls["read"] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.read,
+                default_retry=self._method_configs["Read"].retry,
+                default_timeout=self._method_configs["Read"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.ReadRequest(
+            session=session,
+            table=table,
+            columns=columns,
+            key_set=key_set,
+            transaction=transaction,
+            index=index,
+            limit=limit,
+            resume_token=resume_token,
+            partition_token=partition_token,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["read"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def streaming_read(
+        self,
+        session,
+        table,
+        columns,
+        key_set,
+        transaction=None,
+        index=None,
+        limit=None,
+        resume_token=None,
+        partition_token=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Like ``Read``, except returns the result set as a stream. Unlike
+        ``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.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `table`:
+            >>> table = ''
+            >>>
+            >>> # TODO: Initialize `columns`:
+            >>> columns = []
+            >>>
+            >>> # TODO: Initialize `key_set`:
+            >>> key_set = {}
+            >>>
+            >>> for element in client.streaming_read(session, table, columns, key_set):
+            ...     # process element
+            ...     pass
+
+        Args:
+            session (str): Required. The session in which the read should be performed.
+            table (str): Required. The name of the table in the database to be read.
+            columns (list[str]): The columns of ``table`` to be returned for each row matching this
+                request.
+            key_set (Union[dict, ~google.cloud.spanner_v1.types.KeySet]): Required. ``key_set`` identifies the rows to be yielded. ``key_set``
+                names the primary keys of the rows in ``table`` to be yielded, unless
+                ``index`` is present. If ``index`` is present, then ``key_set`` instead
+                names index keys in ``index``.
+
+                If the ``partition_token`` field is empty, rows are yielded in table
+                primary key order (if ``index`` is empty) or index key order (if
+                ``index`` is non-empty). If the ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.KeySet`
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): The transaction to use. If none is provided, the default is a
+                temporary read-only transaction with strong concurrency.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            index (str): If non-empty, the name of an index on ``table``. This index is used
+                instead of the table primary key when interpreting ``key_set`` and
+                sorting result rows. See ``key_set`` for further information.
+            limit (long): 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 ``partition_token`` is set.
+            resume_token (bytes): If this request is resuming a previously interrupted read,
+                ``resume_token`` should be copied from the last ``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.
+            partition_token (bytes): If present, results will be restricted to the specified partition
+                previously created using PartitionRead(). There must be an exact match
+                for the values of fields common to this message and the
+                PartitionReadRequest message used to create this partition\_token.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.spanner_v1.types.PartialResultSet].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "streaming_read" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "streaming_read"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.streaming_read,
+                default_retry=self._method_configs["StreamingRead"].retry,
+                default_timeout=self._method_configs["StreamingRead"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.ReadRequest(
+            session=session,
+            table=table,
+            columns=columns,
+            key_set=key_set,
+            transaction=transaction,
+            index=index,
+            limit=limit,
+            resume_token=resume_token,
+            partition_token=partition_token,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["streaming_read"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def begin_transaction(
+        self,
+        session,
+        options_,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Begins a new transaction. This step can often be skipped: ``Read``,
+        ``ExecuteSql`` and ``Commit`` can begin a new transaction as a
+        side-effect.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `options_`:
+            >>> options_ = {}
+            >>>
+            >>> response = client.begin_transaction(session, options_)
+
+        Args:
+            session (str): Required. The session in which the transaction runs.
+            options_ (Union[dict, ~google.cloud.spanner_v1.types.TransactionOptions]): Required. Options for the new transaction.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.Transaction` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "begin_transaction" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "begin_transaction"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.begin_transaction,
+                default_retry=self._method_configs["BeginTransaction"].retry,
+                default_timeout=self._method_configs["BeginTransaction"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.BeginTransactionRequest(session=session, options=options_)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["begin_transaction"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def commit(
+        self,
+        session,
+        mutations,
+        transaction_id=None,
+        single_use_transaction=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Commits a transaction. The request includes the mutations to be applied
+        to rows in the database.
+
+        ``Commit`` might return an ``ABORTED`` error. This can occur at any
+        time; commonly, the cause is conflicts with concurrent transactions.
+        However, it can also happen for a variety of other reasons. If
+        ``Commit`` returns ``ABORTED``, the caller should re-attempt the
+        transaction from the beginning, re-using the same session.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `mutations`:
+            >>> mutations = []
+            >>>
+            >>> response = client.commit(session, mutations)
+
+        Args:
+            session (str): Required. The session in which the transaction to be committed is running.
+            mutations (list[Union[dict, ~google.cloud.spanner_v1.types.Mutation]]): The mutations to be executed when this transaction commits. All
+                mutations are applied atomically, in the order they appear in
+                this list.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Mutation`
+            transaction_id (bytes): Commit a previously-started transaction.
+            single_use_transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionOptions]): Execute mutations in a temporary transaction. Note that unlike commit of
+                a previously-started transaction, commit with a temporary transaction is
+                non-idempotent. That is, if the ``CommitRequest`` is sent to Cloud
+                Spanner more than once (for instance, due to retries in the application,
+                or in the transport library), it is possible that the mutations are
+                executed more than once. If this is undesirable, use
+                ``BeginTransaction`` and ``Commit`` instead.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.CommitResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "commit" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "commit"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.commit,
+                default_retry=self._method_configs["Commit"].retry,
+                default_timeout=self._method_configs["Commit"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            transaction_id=transaction_id, single_use_transaction=single_use_transaction
+        )
+
+        request = spanner_pb2.CommitRequest(
+            session=session,
+            mutations=mutations,
+            transaction_id=transaction_id,
+            single_use_transaction=single_use_transaction,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["commit"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def rollback(
+        self,
+        session,
+        transaction_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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``
+        or ``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 found.
+        ``Rollback`` never returns ``ABORTED``.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `transaction_id`:
+            >>> transaction_id = b''
+            >>>
+            >>> client.rollback(session, transaction_id)
+
+        Args:
+            session (str): Required. The session in which the transaction to roll back is running.
+            transaction_id (bytes): Required. The transaction to roll back.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "rollback" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "rollback"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.rollback,
+                default_retry=self._method_configs["Rollback"].retry,
+                default_timeout=self._method_configs["Rollback"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.RollbackRequest(
+            session=session, transaction_id=transaction_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["rollback"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def partition_query(
+        self,
+        session,
+        sql,
+        transaction=None,
+        params=None,
+        param_types=None,
+        partition_options=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` 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
+        old. When any of these happen, it is not possible to resume the query,
+        and the whole operation must be restarted from the beginning.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `sql`:
+            >>> sql = ''
+            >>>
+            >>> response = client.partition_query(session, sql)
+
+        Args:
+            session (str): Required. The session used to create the partitions.
+            sql (str): 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 splits, remotely evaluates a subquery independently on each
+                split, and then unions all results.
+
+                This must not contain DML commands, such as INSERT, UPDATE, or DELETE.
+                Use ``ExecuteStreamingSql`` with a PartitionedDml transaction for large,
+                partition-friendly DML operations.
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): Read only snapshot transactions are supported, read/write and single use
+                transactions are not.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): 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.
+
+                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.
+
+                Parameter values are specified using ``params``, which is a JSON object
+                whose keys are parameter names, and whose values are the corresponding
+                parameter values.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Struct`
+            param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): 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`` 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 definition of
+                ``Type`` for more information about SQL types.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.Type`
+            partition_options (Union[dict, ~google.cloud.spanner_v1.types.PartitionOptions]): Additional options that affect how many partitions are created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.PartitionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.PartitionResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "partition_query" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "partition_query"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.partition_query,
+                default_retry=self._method_configs["PartitionQuery"].retry,
+                default_timeout=self._method_configs["PartitionQuery"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.PartitionQueryRequest(
+            session=session,
+            sql=sql,
+            transaction=transaction,
+            params=params,
+            param_types=param_types,
+            partition_options=partition_options,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["partition_query"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def partition_read(
+        self,
+        session,
+        table,
+        key_set,
+        transaction=None,
+        index=None,
+        columns=None,
+        partition_options=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` 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
+        old. When any of these happen, it is not possible to resume the read,
+        and the whole operation must be restarted from the beginning.
+
+        Example:
+            >>> from google.cloud import spanner_v1
+            >>>
+            >>> client = spanner_v1.SpannerClient()
+            >>>
+            >>> session = client.session_path('[PROJECT]', '[INSTANCE]', '[DATABASE]', '[SESSION]')
+            >>>
+            >>> # TODO: Initialize `table`:
+            >>> table = ''
+            >>>
+            >>> # TODO: Initialize `key_set`:
+            >>> key_set = {}
+            >>>
+            >>> response = client.partition_read(session, table, key_set)
+
+        Args:
+            session (str): Required. The session used to create the partitions.
+            table (str): Required. The name of the table in the database to be read.
+            key_set (Union[dict, ~google.cloud.spanner_v1.types.KeySet]): Required. ``key_set`` identifies the rows to be yielded. ``key_set``
+                names the primary keys of the rows in ``table`` to be yielded, unless
+                ``index`` is present. If ``index`` is present, then ``key_set`` instead
+                names index keys in ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.KeySet`
+            transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionSelector]): Read only snapshot transactions are supported, read/write and single use
+                transactions are not.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.TransactionSelector`
+            index (str): If non-empty, the name of an index on ``table``. This index is used
+                instead of the table primary key when interpreting ``key_set`` and
+                sorting result rows. See ``key_set`` for further information.
+            columns (list[str]): The columns of ``table`` to be returned for each row matching this
+                request.
+            partition_options (Union[dict, ~google.cloud.spanner_v1.types.PartitionOptions]): Additional options that affect how many partitions are created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.PartitionOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.spanner_v1.types.PartitionResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "partition_read" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "partition_read"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.partition_read,
+                default_retry=self._method_configs["PartitionRead"].retry,
+                default_timeout=self._method_configs["PartitionRead"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = spanner_pb2.PartitionReadRequest(
+            session=session,
+            table=table,
+            key_set=key_set,
+            transaction=transaction,
+            index=index,
+            columns=columns,
+            partition_options=partition_options,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("session", session)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["partition_read"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/spanner/google/cloud/spanner_v1/gapic/spanner_client_config.py b/spanner/google/cloud/spanner_v1/gapic/spanner_client_config.py
new file mode 100644
index 000000000000..0b4722fd8d06
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/gapic/spanner_client_config.py
@@ -0,0 +1,117 @@
+config = {
+    "interfaces": {
+        "google.spanner.v1.Spanner": {
+            "retry_codes": {
+                "idempotent": ["UNAVAILABLE"],
+                "non_idempotent": [],
+                "long_running": ["UNAVAILABLE"],
+            },
+            "retry_params": {
+                "default": {
+                    "initial_retry_delay_millis": 250,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 32000,
+                    "initial_rpc_timeout_millis": 60000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                },
+                "streaming": {
+                    "initial_retry_delay_millis": 250,
+                    "retry_delay_multiplier": 1.3,
+                    "max_retry_delay_millis": 32000,
+                    "initial_rpc_timeout_millis": 120000,
+                    "rpc_timeout_multiplier": 1.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 1200000,
+                },
+                "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.0,
+                    "max_rpc_timeout_millis": 3600000,
+                    "total_timeout_millis": 3600000,
+                },
+            },
+            "methods": {
+                "CreateSession": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchCreateSessions": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSession": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListSessions": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteSession": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExecuteSql": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ExecuteStreamingSql": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "ExecuteBatchDml": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "Read": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "StreamingRead": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "streaming",
+                },
+                "BeginTransaction": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "Commit": {
+                    "timeout_millis": 3600000,
+                    "retry_codes_name": "long_running",
+                    "retry_params_name": "long_running",
+                },
+                "Rollback": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PartitionQuery": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PartitionRead": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/spanner/google/cloud/spanner_v1/gapic/transports/__init__.py b/spanner/google/cloud/spanner_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_v1/gapic/transports/spanner.grpc.config b/spanner/google/cloud/spanner_v1/gapic/transports/spanner.grpc.config
new file mode 100755
index 000000000000..c34397a1c869
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/gapic/transports/spanner.grpc.config
@@ -0,0 +1,88 @@
+channel_pool: {
+  max_size: 10
+  max_concurrent_streams_low_watermark: 100
+}
+method: {
+  name: "/google.spanner.v1.Spanner/CreateSession"
+  affinity: {
+    command: BIND
+    affinity_key: "name"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/GetSession"
+  affinity: {
+    command: BOUND
+    affinity_key: "name"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/DeleteSession"
+  affinity: {
+    command: UNBIND
+    affinity_key: "name"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/ExecuteSql"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/ExecuteStreamingSql"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/Read"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/StreamingRead"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/BeginTransaction"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/Commit"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/Rollback"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/PartitionQuery"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
+method: {
+  name: "/google.spanner.v1.Spanner/PartitionRead"
+  affinity: {
+    command: BOUND
+    affinity_key: "session"
+  }
+}
diff --git a/spanner/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py b/spanner/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py
new file mode 100644
index 000000000000..2b5f1fd1d67f
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py
@@ -0,0 +1,417 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import pkg_resources
+import grpc_gcp
+
+import google.api_core.grpc_helpers
+
+from google.cloud.spanner_v1.proto import spanner_pb2_grpc
+
+
+_SPANNER_GRPC_CONFIG = "spanner.grpc.config"
+
+
+class SpannerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.spanner.v1 Spanner API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/spanner.data",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="spanner.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"spanner_stub": spanner_pb2_grpc.SpannerStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="spanner.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        grpc_gcp_config = grpc_gcp.api_config_from_text_pb(
+            pkg_resources.resource_string(__name__, _SPANNER_GRPC_CONFIG)
+        )
+        options = [(grpc_gcp.API_CONFIG_CHANNEL_ARG, grpc_gcp_config)]
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_session(self):
+        """Return the gRPC stub for :meth:`SpannerClient.create_session`.
+
+        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 transactions.
+
+        Sessions can only execute one transaction at a time. To execute multiple
+        concurrent read-write/write-only transactions, create multiple sessions.
+        Note that standalone reads and queries use a 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 operations are sent for more than an hour. If a session is deleted,
+        requests to it return ``NOT_FOUND``.
+
+        Idle sessions can be kept alive by sending a trivial SQL query
+        periodically, e.g., ``"SELECT 1"``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].CreateSession
+
+    @property
+    def batch_create_sessions(self):
+        """Return the gRPC stub for :meth:`SpannerClient.batch_create_sessions`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].BatchCreateSessions
+
+    @property
+    def get_session(self):
+        """Return the gRPC stub for :meth:`SpannerClient.get_session`.
+
+        Gets a session. Returns ``NOT_FOUND`` if the session does not exist.
+        This is mainly useful for determining whether a session is still alive.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].GetSession
+
+    @property
+    def list_sessions(self):
+        """Return the gRPC stub for :meth:`SpannerClient.list_sessions`.
+
+        Lists all sessions in a given database.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].ListSessions
+
+    @property
+    def delete_session(self):
+        """Return the gRPC stub for :meth:`SpannerClient.delete_session`.
+
+        Ends a session, releasing server resources associated with it. This will
+        asynchronously trigger cancellation of any operations that are running with
+        this session.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].DeleteSession
+
+    @property
+    def execute_sql(self):
+        """Return the gRPC stub for :meth:`SpannerClient.execute_sql`.
+
+        Executes an SQL statement, returning all results in a single reply. This
+        method cannot be used to return a result set larger than 10 MiB; if the
+        query yields more data than that, the query fails with a
+        ``FAILED_PRECONDITION`` error.
+
+        Operations inside read-write transactions might return ``ABORTED``. If
+        this occurs, the application should restart the transaction from the
+        beginning. See ``Transaction`` for more details.
+
+        Larger result sets can be fetched in streaming fashion by calling
+        ``ExecuteStreamingSql`` instead.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].ExecuteSql
+
+    @property
+    def execute_streaming_sql(self):
+        """Return the gRPC stub for :meth:`SpannerClient.execute_streaming_sql`.
+
+        Like ``ExecuteSql``, except returns the result set as a stream. Unlike
+        ``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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].ExecuteStreamingSql
+
+    @property
+    def execute_batch_dml(self):
+        """Return the gRPC stub for :meth:`SpannerClient.execute_batch_dml`.
+
+        Executes a batch of SQL DML statements. This method allows many
+        statements to be run with lower latency than submitting them
+        sequentially with ``ExecuteSql``.
+
+        Statements are executed in order, sequentially.
+        ``ExecuteBatchDmlResponse`` will contain a ``ResultSet`` for each DML
+        statement that has successfully executed. If a statement fails, its
+        error status will be returned as part of the
+        ``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`` and
+        ``ExecuteBatchDmlResponse``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].ExecuteBatchDml
+
+    @property
+    def read(self):
+        """Return the gRPC stub for :meth:`SpannerClient.read`.
+
+        Reads rows from the database using key lookups and scans, as a simple
+        key/value style alternative to ``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`` for more details.
+
+        Larger result sets can be yielded in streaming fashion by calling
+        ``StreamingRead`` instead.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].Read
+
+    @property
+    def streaming_read(self):
+        """Return the gRPC stub for :meth:`SpannerClient.streaming_read`.
+
+        Like ``Read``, except returns the result set as a stream. Unlike
+        ``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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].StreamingRead
+
+    @property
+    def begin_transaction(self):
+        """Return the gRPC stub for :meth:`SpannerClient.begin_transaction`.
+
+        Begins a new transaction. This step can often be skipped: ``Read``,
+        ``ExecuteSql`` and ``Commit`` can begin a new transaction as a
+        side-effect.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].BeginTransaction
+
+    @property
+    def commit(self):
+        """Return the gRPC stub for :meth:`SpannerClient.commit`.
+
+        Commits a transaction. The request includes the mutations to be applied
+        to rows in the database.
+
+        ``Commit`` might return an ``ABORTED`` error. This can occur at any
+        time; commonly, the cause is conflicts with concurrent transactions.
+        However, it can also happen for a variety of other reasons. If
+        ``Commit`` returns ``ABORTED``, the caller should re-attempt the
+        transaction from the beginning, re-using the same session.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].Commit
+
+    @property
+    def rollback(self):
+        """Return the gRPC stub for :meth:`SpannerClient.rollback`.
+
+        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``
+        or ``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 found.
+        ``Rollback`` never returns ``ABORTED``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].Rollback
+
+    @property
+    def partition_query(self):
+        """Return the gRPC stub for :meth:`SpannerClient.partition_query`.
+
+        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`` 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
+        old. When any of these happen, it is not possible to resume the query,
+        and the whole operation must be restarted from the beginning.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].PartitionQuery
+
+    @property
+    def partition_read(self):
+        """Return the gRPC stub for :meth:`SpannerClient.partition_read`.
+
+        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`` 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
+        old. When any of these happen, it is not possible to resume the read,
+        and the whole operation must be restarted from the beginning.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["spanner_stub"].PartitionRead
diff --git a/spanner/google/cloud/spanner_v1/instance.py b/spanner/google/cloud/spanner_v1/instance.py
new file mode 100644
index 000000000000..583cca00553e
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/instance.py
@@ -0,0 +1,379 @@
+# Copyright 2016 Google LLC 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.
+
+"""User friendly container for Cloud Spanner Instance."""
+
+import re
+
+from google.cloud.spanner_admin_instance_v1.proto import (
+    spanner_instance_admin_pb2 as admin_v1_pb2,
+)
+from google.protobuf.field_mask_pb2 import FieldMask
+
+# pylint: disable=ungrouped-imports
+from google.cloud.exceptions import NotFound
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+from google.cloud.spanner_v1.database import Database
+from google.cloud.spanner_v1.pool import BurstyPool
+
+# pylint: enable=ungrouped-imports
+
+
+_INSTANCE_NAME_RE = re.compile(
+    r"^projects/(?P<project>[^/]+)/" r"instances/(?P<instance_id>[a-z][-a-z0-9]*)$"
+)
+
+DEFAULT_NODE_COUNT = 1
+
+
+class Instance(object):
+    """Representation of a Cloud Spanner Instance.
+
+    We can use a :class:`Instance` to:
+
+    * :meth:`reload` itself
+    * :meth:`create` itself
+    * :meth:`update` itself
+    * :meth:`delete` itself
+
+    :type instance_id: str
+    :param instance_id: The ID of the instance.
+
+    :type client: :class:`~google.cloud.spanner_v1.client.Client`
+    :param client: The client that owns the instance. Provides
+                   authorization and a project ID.
+
+    :type configuration_name: str
+    :param configuration_name: Name of the instance configuration defining
+                        how the instance will be created.
+                        Required for instances which do not yet exist.
+
+    :type node_count: int
+    :param node_count: (Optional) Number of nodes allocated to the instance.
+
+    :type display_name: str
+    :param display_name: (Optional) The display name for the instance in the
+                         Cloud Console UI. (Must be between 4 and 30
+                         characters.) If this value is not set in the
+                         constructor, will fall back to the instance ID.
+    """
+
+    def __init__(
+        self,
+        instance_id,
+        client,
+        configuration_name=None,
+        node_count=DEFAULT_NODE_COUNT,
+        display_name=None,
+    ):
+        self.instance_id = instance_id
+        self._client = client
+        self.configuration_name = configuration_name
+        self.node_count = node_count
+        self.display_name = display_name or instance_id
+
+    def _update_from_pb(self, instance_pb):
+        """Refresh self from the server-provided protobuf.
+
+        Helper for :meth:`from_pb` and :meth:`reload`.
+        """
+        if not instance_pb.display_name:  # Simple field (string)
+            raise ValueError("Instance protobuf does not contain display_name")
+        self.display_name = instance_pb.display_name
+        self.configuration_name = instance_pb.config
+        self.node_count = instance_pb.node_count
+
+    @classmethod
+    def from_pb(cls, instance_pb, client):
+        """Creates an instance from a protobuf.
+
+        :type instance_pb:
+            :class:`google.spanner.v2.spanner_instance_admin_pb2.Instance`
+        :param instance_pb: A instance protobuf object.
+
+        :type client: :class:`~google.cloud.spanner_v1.client.Client`
+        :param client: The client that owns the instance.
+
+        :rtype: :class:`Instance`
+        :returns: The instance parsed from the protobuf response.
+        :raises ValueError:
+            if the instance name does not match
+            ``projects/{project}/instances/{instance_id}`` or if the parsed
+            project ID does not match the project ID on the client.
+        """
+        match = _INSTANCE_NAME_RE.match(instance_pb.name)
+        if match is None:
+            raise ValueError(
+                "Instance protobuf name was not in the " "expected format.",
+                instance_pb.name,
+            )
+        if match.group("project") != client.project:
+            raise ValueError(
+                "Project ID on instance does not match the " "project ID on the client"
+            )
+        instance_id = match.group("instance_id")
+        configuration_name = instance_pb.config
+
+        result = cls(instance_id, client, configuration_name)
+        result._update_from_pb(instance_pb)
+        return result
+
+    @property
+    def name(self):
+        """Instance name used in requests.
+
+        .. note::
+
+           This property will not change if ``instance_id`` does not,
+           but the return value is not cached.
+
+        The instance name is of the form
+
+            ``"projects/{project}/instances/{instance_id}"``
+
+        :rtype: str
+        :returns: The instance name.
+        """
+        return self._client.project_name + "/instances/" + self.instance_id
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        # NOTE: This does not compare the configuration values, such as
+        #       the display_name. Instead, it only compares
+        #       identifying values instance ID and client. This is
+        #       intentional, since the same instance can be in different states
+        #       if not synchronized. Instances with similar instance
+        #       settings but different clients can't be used in the same way.
+        return other.instance_id == self.instance_id and other._client == self._client
+
+    def __ne__(self, other):
+        return not self == other
+
+    def copy(self):
+        """Make a copy of this instance.
+
+        Copies the local data stored as simple types and copies the client
+        attached to this instance.
+
+        :rtype: :class:`~google.cloud.spanner_v1.instance.Instance`
+        :returns: A copy of the current instance.
+        """
+        new_client = self._client.copy()
+        return self.__class__(
+            self.instance_id,
+            new_client,
+            self.configuration_name,
+            node_count=self.node_count,
+            display_name=self.display_name,
+        )
+
+    def create(self):
+        """Create this instance.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance
+
+        .. note::
+
+           Uses the ``project`` and ``instance_id`` on the current
+           :class:`Instance` in addition to the ``display_name``.
+           To change them before creating, reset the values via
+
+           .. code:: python
+
+              instance.display_name = 'New display name'
+              instance.instance_id = 'i-changed-my-mind'
+
+           before calling :meth:`create`.
+
+        :rtype: :class:`google.api_core.operation.Operation`
+        :returns: an operation instance
+        :raises Conflict: if the instance already exists
+        """
+        api = self._client.instance_admin_api
+        instance_pb = admin_v1_pb2.Instance(
+            name=self.name,
+            config=self.configuration_name,
+            display_name=self.display_name,
+            node_count=self.node_count,
+        )
+        metadata = _metadata_with_prefix(self.name)
+
+        future = api.create_instance(
+            parent=self._client.project_name,
+            instance_id=self.instance_id,
+            instance=instance_pb,
+            metadata=metadata,
+        )
+
+        return future
+
+    def exists(self):
+        """Test whether this instance exists.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig
+
+        :rtype: bool
+        :returns: True if the instance exists, else false
+        """
+        api = self._client.instance_admin_api
+        metadata = _metadata_with_prefix(self.name)
+
+        try:
+            api.get_instance(self.name, metadata=metadata)
+        except NotFound:
+            return False
+
+        return True
+
+    def reload(self):
+        """Reload the metadata for this instance.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig
+
+        :raises NotFound: if the instance does not exist
+        """
+        api = self._client.instance_admin_api
+        metadata = _metadata_with_prefix(self.name)
+
+        instance_pb = api.get_instance(self.name, metadata=metadata)
+
+        self._update_from_pb(instance_pb)
+
+    def update(self):
+        """Update this instance.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance
+
+        .. note::
+
+           Updates the ``display_name`` and ``node_count``. To change those
+           values before updating, set them via
+
+           .. code:: python
+
+              instance.display_name = 'New display name'
+              instance.node_count = 5
+
+            before calling :meth:`update`.
+
+        :rtype: :class:`google.api_core.operation.Operation`
+        :returns: an operation instance
+        :raises NotFound: if the instance does not exist
+        """
+        api = self._client.instance_admin_api
+        instance_pb = admin_v1_pb2.Instance(
+            name=self.name,
+            config=self.configuration_name,
+            display_name=self.display_name,
+            node_count=self.node_count,
+        )
+        field_mask = FieldMask(paths=["config", "display_name", "node_count"])
+        metadata = _metadata_with_prefix(self.name)
+
+        future = api.update_instance(
+            instance=instance_pb, field_mask=field_mask, metadata=metadata
+        )
+
+        return future
+
+    def delete(self):
+        """Mark an instance and all of its databases for permanent deletion.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance
+
+        Immediately upon completion of the request:
+
+        * Billing will cease for all of the instance's reserved resources.
+
+        Soon afterward:
+
+        * The instance and all databases within the instance will be deleteed.
+          All data in the databases will be permanently deleted.
+        """
+        api = self._client.instance_admin_api
+        metadata = _metadata_with_prefix(self.name)
+
+        api.delete_instance(self.name, metadata=metadata)
+
+    def database(self, database_id, ddl_statements=(), pool=None):
+        """Factory to create a database within this instance.
+
+        :type database_id: str
+        :param database_id: The ID of the instance.
+
+        :type ddl_statements: list of string
+        :param ddl_statements: (Optional) DDL statements, excluding the
+                               'CREATE DATABSE' statement.
+
+        :type pool: concrete subclass of
+                    :class:`~google.cloud.spanner_v1.pool.AbstractSessionPool`.
+        :param pool: (Optional) session pool to be used by database.
+
+        :rtype: :class:`~google.cloud.spanner_v1.database.Database`
+        :returns: a database owned by this instance.
+        """
+        return Database(database_id, self, ddl_statements=ddl_statements, pool=pool)
+
+    def list_databases(self, page_size=None, page_token=None):
+        """List databases for the instance.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.admin.database.v1#google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases
+
+        :type page_size: int
+        :param page_size:
+            Optional. The maximum number of databases in each page of results
+            from this request. Non-positive values are ignored. Defaults
+            to a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of databases, using
+            the value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing
+            the token.
+
+        :rtype: :class:`~google.api._ore.page_iterator.Iterator`
+        :returns:
+            Iterator of :class:`~google.cloud.spanner_v1.database.Database`
+            resources within the current instance.
+        """
+        metadata = _metadata_with_prefix(self.name)
+        page_iter = self._client.database_admin_api.list_databases(
+            self.name, page_size=page_size, metadata=metadata
+        )
+        page_iter.next_page_token = page_token
+        page_iter.item_to_value = self._item_to_database
+        return page_iter
+
+    def _item_to_database(self, iterator, database_pb):
+        """Convert a database protobuf to the native object.
+
+        :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+        :param iterator: The iterator that is currently in use.
+
+        :type database_pb: :class:`~google.spanner.admin.database.v1.Database`
+        :param database_pb: A database returned from the API.
+
+        :rtype: :class:`~google.cloud.spanner_v1.database.Database`
+        :returns: The next database in the page.
+        """
+        return Database.from_pb(database_pb, self, pool=BurstyPool())
diff --git a/spanner/google/cloud/spanner_v1/keyset.py b/spanner/google/cloud/spanner_v1/keyset.py
new file mode 100644
index 000000000000..fb45882bec21
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/keyset.py
@@ -0,0 +1,193 @@
+# Copyright 2016 Google LLC 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.
+
+"""Wrap representation of Spanner keys / ranges."""
+
+from google.cloud.spanner_v1.proto.keys_pb2 import KeyRange as KeyRangePB
+from google.cloud.spanner_v1.proto.keys_pb2 import KeySet as KeySetPB
+
+from google.cloud.spanner_v1._helpers import _make_list_value_pb
+from google.cloud.spanner_v1._helpers import _make_list_value_pbs
+
+
+class KeyRange(object):
+    """Identify range of table rows via start / end points.
+
+    Specify either a `start_open` or `start_closed` key, or defaults to
+    `start_closed = []`.  Specify either an `end_open` or `end_closed` key,
+    or defaults to `end_closed = []`.  However, at least one key has to be
+    specified.  If no keys are specified, ValueError is raised.
+
+    :type start_open: list of scalars
+    :param start_open: keys identifying start of range (this key excluded)
+
+    :type start_closed: list of scalars
+    :param start_closed: keys identifying start of range (this key included)
+
+    :type end_open: list of scalars
+    :param end_open: keys identifying end of range (this key excluded)
+
+    :type end_closed: list of scalars
+    :param end_closed: keys identifying end of range (this key included)
+
+    :raises ValueError: if no keys are specified
+    """
+
+    def __init__(
+        self, start_open=None, start_closed=None, end_open=None, end_closed=None
+    ):
+        if not any([start_open, start_closed, end_open, end_closed]):
+            raise ValueError("Must specify at least a start or end row.")
+
+        if start_open and start_closed:
+            raise ValueError("Specify one of 'start_open' / 'start_closed'.")
+        elif start_open is None and start_closed is None:
+            start_closed = []
+
+        if end_open and end_closed:
+            raise ValueError("Specify one of 'end_open' / 'end_closed'.")
+        elif end_open is None and end_closed is None:
+            end_closed = []
+
+        self.start_open = start_open
+        self.start_closed = start_closed
+        self.end_open = end_open
+        self.end_closed = end_closed
+
+    def _to_pb(self):
+        """Construct a KeyRange protobuf.
+
+        :rtype: :class:`~google.cloud.spanner_v1.proto.keys_pb2.KeyRange`
+        :returns: protobuf corresponding to this instance.
+        """
+        kwargs = {}
+
+        if self.start_open is not None:
+            kwargs["start_open"] = _make_list_value_pb(self.start_open)
+
+        if self.start_closed is not None:
+            kwargs["start_closed"] = _make_list_value_pb(self.start_closed)
+
+        if self.end_open is not None:
+            kwargs["end_open"] = _make_list_value_pb(self.end_open)
+
+        if self.end_closed is not None:
+            kwargs["end_closed"] = _make_list_value_pb(self.end_closed)
+
+        return KeyRangePB(**kwargs)
+
+    def _to_dict(self):
+        """Return keyrange's state as a dict.
+
+        :rtype: dict
+        :returns: state of this instance.
+        """
+        mapping = {}
+
+        if self.start_open:
+            mapping["start_open"] = self.start_open
+
+        if self.start_closed:
+            mapping["start_closed"] = self.start_closed
+
+        if self.end_open:
+            mapping["end_open"] = self.end_open
+
+        if self.end_closed:
+            mapping["end_closed"] = self.end_closed
+
+        return mapping
+
+    def __eq__(self, other):
+        """Compare by serialized state."""
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._to_dict() == other._to_dict()
+
+
+class KeySet(object):
+    """Identify table rows via keys / ranges.
+
+    :type keys: list of list of scalars
+    :param keys: keys identifying individual rows within a table.
+
+    :type ranges: list of :class:`KeyRange`
+    :param ranges: ranges identifying rows within a table.
+
+    :type all_: boolean
+    :param all_: if True, identify all rows within a table
+    """
+
+    def __init__(self, keys=(), ranges=(), all_=False):
+        if all_ and (keys or ranges):
+            raise ValueError("'all_' is exclusive of 'keys' / 'ranges'.")
+        self.keys = list(keys)
+        self.ranges = list(ranges)
+        self.all_ = all_
+
+    def _to_pb(self):
+        """Construct a KeySet protobuf.
+
+        :rtype: :class:`~google.cloud.spanner_v1.proto.keys_pb2.KeySet`
+        :returns: protobuf corresponding to this instance.
+        """
+        if self.all_:
+            return KeySetPB(all=True)
+        kwargs = {}
+
+        if self.keys:
+            kwargs["keys"] = _make_list_value_pbs(self.keys)
+
+        if self.ranges:
+            kwargs["ranges"] = [krange._to_pb() for krange in self.ranges]
+
+        return KeySetPB(**kwargs)
+
+    def _to_dict(self):
+        """Return keyset's state as a dict.
+
+        The result can be used to serialize the instance and reconstitute
+        it later using :meth:`_from_dict`.
+
+        :rtype: dict
+        :returns: state of this instance.
+        """
+        if self.all_:
+            return {"all": True}
+
+        return {
+            "keys": self.keys,
+            "ranges": [keyrange._to_dict() for keyrange in self.ranges],
+        }
+
+    def __eq__(self, other):
+        """Compare by serialized state."""
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+        return self._to_dict() == other._to_dict()
+
+    @classmethod
+    def _from_dict(cls, mapping):
+        """Create an instance from the corresponding state mapping.
+
+        :type mapping: dict
+        :param mapping: the instance state.
+        """
+        if mapping.get("all"):
+            return cls(all_=True)
+
+        r_mappings = mapping.get("ranges", ())
+        ranges = [KeyRange(**r_mapping) for r_mapping in r_mappings]
+
+        return cls(keys=mapping.get("keys", ()), ranges=ranges)
diff --git a/spanner/google/cloud/spanner_v1/param_types.py b/spanner/google/cloud/spanner_v1/param_types.py
new file mode 100644
index 000000000000..47442bfc4bd2
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/param_types.py
@@ -0,0 +1,68 @@
+# Copyright 2017 Google LLC 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.
+
+"""Types exported from this package."""
+
+from google.cloud.spanner_v1.proto import type_pb2
+
+
+# Scalar parameter types
+STRING = type_pb2.Type(code=type_pb2.STRING)
+BYTES = type_pb2.Type(code=type_pb2.BYTES)
+BOOL = type_pb2.Type(code=type_pb2.BOOL)
+INT64 = type_pb2.Type(code=type_pb2.INT64)
+FLOAT64 = type_pb2.Type(code=type_pb2.FLOAT64)
+DATE = type_pb2.Type(code=type_pb2.DATE)
+TIMESTAMP = type_pb2.Type(code=type_pb2.TIMESTAMP)
+
+
+def Array(element_type):  # pylint: disable=invalid-name
+    """Construct an array parameter type description protobuf.
+
+    :type element_type: :class:`type_pb2.Type`
+    :param element_type: the type of elements of the array
+
+    :rtype: :class:`type_pb2.Type`
+    :returns: the appropriate array-type protobuf
+    """
+    return type_pb2.Type(code=type_pb2.ARRAY, array_element_type=element_type)
+
+
+def StructField(name, field_type):  # pylint: disable=invalid-name
+    """Construct a field description protobuf.
+
+    :type name: str
+    :param name: the name of the field
+
+    :type field_type: :class:`type_pb2.Type`
+    :param field_type: the type of the field
+
+    :rtype: :class:`type_pb2.StructType.Field`
+    :returns: the appropriate struct-field-type protobuf
+    """
+    return type_pb2.StructType.Field(name=name, type=field_type)
+
+
+def Struct(fields):  # pylint: disable=invalid-name
+    """Construct a struct parameter type description protobuf.
+
+    :type fields: list of :class:`type_pb2.StructType.Field`
+    :param fields: the fields of the struct
+
+    :rtype: :class:`type_pb2.Type`
+    :returns: the appropriate struct-type protobuf
+    """
+    return type_pb2.Type(
+        code=type_pb2.STRUCT, struct_type=type_pb2.StructType(fields=fields)
+    )
diff --git a/spanner/google/cloud/spanner_v1/pool.py b/spanner/google/cloud/spanner_v1/pool.py
new file mode 100644
index 000000000000..823681fbc864
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/pool.py
@@ -0,0 +1,521 @@
+# Copyright 2016 Google LLC 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.
+
+"""Pools managing shared Session objects."""
+
+import datetime
+
+from six.moves import queue
+from six.moves import xrange
+
+from google.cloud.exceptions import NotFound
+
+
+_NOW = datetime.datetime.utcnow  # unit tests may replace
+
+
+class AbstractSessionPool(object):
+    """Specifies required API for concrete session pool implementations.
+
+    :type labels: dict (str -> str) or None
+    :param labels: (Optional) user-assigned labels for sessions created
+                    by the pool.
+    """
+
+    _database = None
+
+    def __init__(self, labels=None):
+        if labels is None:
+            labels = {}
+        self._labels = labels
+
+    @property
+    def labels(self):
+        """User-assigned labels for sesions created by the pool.
+
+        :rtype: dict (str -> str)
+        :returns: labels assigned by the user
+        """
+        return self._labels
+
+    def bind(self, database):
+        """Associate the pool with a database.
+
+        :type database: :class:`~google.cloud.spanner_v1.database.Database`
+        :param database: database used by the pool:  used to create sessions
+                         when needed.
+
+        Concrete implementations of this method may pre-fill the pool
+        using the database.
+
+        :raises NotImplementedError: abstract method
+        """
+        raise NotImplementedError()
+
+    def get(self):
+        """Check a session out from the pool.
+
+        Concrete implementations of this method are allowed to raise an
+        error to signal that the pool is exhausted, or to block until a
+        session is available.
+
+        :raises NotImplementedError: abstract method
+        """
+        raise NotImplementedError()
+
+    def put(self, session):
+        """Return a session to the pool.
+
+        :type session: :class:`~google.cloud.spanner_v1.session.Session`
+        :param session: the session being returned.
+
+        Concrete implementations of this method are allowed to raise an
+        error to signal that the pool is full, or to block until it is
+        not full.
+
+        :raises NotImplementedError: abstract method
+        """
+        raise NotImplementedError()
+
+    def clear(self):
+        """Delete all sessions in the pool.
+
+        Concrete implementations of this method are allowed to raise an
+        error to signal that the pool is full, or to block until it is
+        not full.
+
+        :raises NotImplementedError: abstract method
+        """
+        raise NotImplementedError()
+
+    def _new_session(self):
+        """Helper for concrete methods creating session instances.
+
+        :rtype: :class:`~google.cloud.spanner_v1.session.Session`
+        :returns: new session instance.
+        """
+        if self.labels:
+            return self._database.session(labels=self.labels)
+        return self._database.session()
+
+    def session(self, **kwargs):
+        """Check out a session from the pool.
+
+        :param kwargs: (optional) keyword arguments, passed through to
+                       the returned checkout.
+
+        :rtype: :class:`~google.cloud.spanner_v1.session.SessionCheckout`
+        :returns: a checkout instance, to be used as a context manager for
+                  accessing the session and returning it to the pool.
+        """
+        return SessionCheckout(self, **kwargs)
+
+
+class FixedSizePool(AbstractSessionPool):
+    """Concrete session pool implementation:
+
+    - Pre-allocates / creates a fixed number of sessions.
+
+    - "Pings" existing sessions via :meth:`session.exists` before returning
+      them, and replaces expired sessions.
+
+    - Blocks, with a timeout, when :meth:`get` is called on an empty pool.
+      Raises after timing out.
+
+    - Raises when :meth:`put` is called on a full pool.  That error is
+      never expected in normal practice, as users should be calling
+      :meth:`get` followed by :meth:`put` whenever in need of a session.
+
+    :type size: int
+    :param size: fixed pool size
+
+    :type default_timeout: int
+    :param default_timeout: default timeout, in seconds, to wait for
+                                 a returned session.
+
+    :type labels: dict (str -> str) or None
+    :param labels: (Optional) user-assigned labels for sessions created
+                    by the pool.
+    """
+
+    DEFAULT_SIZE = 10
+    DEFAULT_TIMEOUT = 10
+
+    def __init__(self, size=DEFAULT_SIZE, default_timeout=DEFAULT_TIMEOUT, labels=None):
+        super(FixedSizePool, self).__init__(labels=labels)
+        self.size = size
+        self.default_timeout = default_timeout
+        self._sessions = queue.Queue(size)
+
+    def bind(self, database):
+        """Associate the pool with a database.
+
+        :type database: :class:`~google.cloud.spanner_v1.database.Database`
+        :param database: database used by the pool:  used to create sessions
+                         when needed.
+        """
+        self._database = database
+
+        while not self._sessions.full():
+            session = self._new_session()
+            session.create()
+            self._sessions.put(session)
+
+    def get(self, timeout=None):  # pylint: disable=arguments-differ
+        """Check a session out from the pool.
+
+        :type timeout: int
+        :param timeout: seconds to block waiting for an available session
+
+        :rtype: :class:`~google.cloud.spanner_v1.session.Session`
+        :returns: an existing session from the pool, or a newly-created
+                  session.
+        :raises: :exc:`six.moves.queue.Empty` if the queue is empty.
+        """
+        if timeout is None:
+            timeout = self.default_timeout
+
+        session = self._sessions.get(block=True, timeout=timeout)
+
+        if not session.exists():
+            session = self._database.session()
+            session.create()
+
+        return session
+
+    def put(self, session):
+        """Return a session to the pool.
+
+        Never blocks:  if the pool is full, raises.
+
+        :type session: :class:`~google.cloud.spanner_v1.session.Session`
+        :param session: the session being returned.
+
+        :raises: :exc:`six.moves.queue.Full` if the queue is full.
+        """
+        self._sessions.put_nowait(session)
+
+    def clear(self):
+        """Delete all sessions in the pool."""
+
+        while True:
+            try:
+                session = self._sessions.get(block=False)
+            except queue.Empty:
+                break
+            else:
+                session.delete()
+
+
+class BurstyPool(AbstractSessionPool):
+    """Concrete session pool implementation:
+
+    - "Pings" existing sessions via :meth:`session.exists` before returning
+      them.
+
+    - Creates a new session, rather than blocking, when :meth:`get` is called
+      on an empty pool.
+
+    - Discards the returned session, rather than blocking, when :meth:`put`
+      is called on a full pool.
+
+    :type target_size: int
+    :param target_size: max pool size
+
+    :type labels: dict (str -> str) or None
+    :param labels: (Optional) user-assigned labels for sessions created
+                    by the pool.
+    """
+
+    def __init__(self, target_size=10, labels=None):
+        super(BurstyPool, self).__init__(labels=labels)
+        self.target_size = target_size
+        self._database = None
+        self._sessions = queue.Queue(target_size)
+
+    def bind(self, database):
+        """Associate the pool with a database.
+
+        :type database: :class:`~google.cloud.spanner_v1.database.Database`
+        :param database: database used by the pool:  used to create sessions
+                         when needed.
+        """
+        self._database = database
+
+    def get(self):
+        """Check a session out from the pool.
+
+        :rtype: :class:`~google.cloud.spanner_v1.session.Session`
+        :returns: an existing session from the pool, or a newly-created
+                  session.
+        """
+        try:
+            session = self._sessions.get_nowait()
+        except queue.Empty:
+            session = self._new_session()
+            session.create()
+        else:
+            if not session.exists():
+                session = self._new_session()
+                session.create()
+        return session
+
+    def put(self, session):
+        """Return a session to the pool.
+
+        Never blocks:  if the pool is full, the returned session is
+        discarded.
+
+        :type session: :class:`~google.cloud.spanner_v1.session.Session`
+        :param session: the session being returned.
+        """
+        try:
+            self._sessions.put_nowait(session)
+        except queue.Full:
+            try:
+                session.delete()
+            except NotFound:
+                pass
+
+    def clear(self):
+        """Delete all sessions in the pool."""
+
+        while True:
+            try:
+                session = self._sessions.get(block=False)
+            except queue.Empty:
+                break
+            else:
+                session.delete()
+
+
+class PingingPool(AbstractSessionPool):
+    """Concrete session pool implementation:
+
+    - Pre-allocates / creates a fixed number of sessions.
+
+    - Sessions are used in "round-robin" order (LRU first).
+
+    - "Pings" existing sessions in the background after a specified interval
+      via an API call (``session.exists()``).
+
+    - Blocks, with a timeout, when :meth:`get` is called on an empty pool.
+      Raises after timing out.
+
+    - Raises when :meth:`put` is called on a full pool.  That error is
+      never expected in normal practice, as users should be calling
+      :meth:`get` followed by :meth:`put` whenever in need of a session.
+
+    The application is responsible for calling :meth:`ping` at appropriate
+    times, e.g. from a background thread.
+
+    :type size: int
+    :param size: fixed pool size
+
+    :type default_timeout: int
+    :param default_timeout: default timeout, in seconds, to wait for
+                            a returned session.
+
+    :type ping_interval: int
+    :param ping_interval: interval at which to ping sessions.
+
+    :type labels: dict (str -> str) or None
+    :param labels: (Optional) user-assigned labels for sessions created
+                    by the pool.
+    """
+
+    def __init__(self, size=10, default_timeout=10, ping_interval=3000, labels=None):
+        super(PingingPool, self).__init__(labels=labels)
+        self.size = size
+        self.default_timeout = default_timeout
+        self._delta = datetime.timedelta(seconds=ping_interval)
+        self._sessions = queue.PriorityQueue(size)
+
+    def bind(self, database):
+        """Associate the pool with a database.
+
+        :type database: :class:`~google.cloud.spanner_v1.database.Database`
+        :param database: database used by the pool:  used to create sessions
+                         when needed.
+        """
+        self._database = database
+
+        for _ in xrange(self.size):
+            session = self._new_session()
+            session.create()
+            self.put(session)
+
+    def get(self, timeout=None):  # pylint: disable=arguments-differ
+        """Check a session out from the pool.
+
+        :type timeout: int
+        :param timeout: seconds to block waiting for an available session
+
+        :rtype: :class:`~google.cloud.spanner_v1.session.Session`
+        :returns: an existing session from the pool, or a newly-created
+                  session.
+        :raises: :exc:`six.moves.queue.Empty` if the queue is empty.
+        """
+        if timeout is None:
+            timeout = self.default_timeout
+
+        ping_after, session = self._sessions.get(block=True, timeout=timeout)
+
+        if _NOW() > ping_after:
+            if not session.exists():
+                session = self._new_session()
+                session.create()
+
+        return session
+
+    def put(self, session):
+        """Return a session to the pool.
+
+        Never blocks:  if the pool is full, raises.
+
+        :type session: :class:`~google.cloud.spanner_v1.session.Session`
+        :param session: the session being returned.
+
+        :raises: :exc:`six.moves.queue.Full` if the queue is full.
+        """
+        self._sessions.put_nowait((_NOW() + self._delta, session))
+
+    def clear(self):
+        """Delete all sessions in the pool."""
+        while True:
+            try:
+                _, session = self._sessions.get(block=False)
+            except queue.Empty:
+                break
+            else:
+                session.delete()
+
+    def ping(self):
+        """Refresh maybe-expired sessions in the pool.
+
+        This method is designed to be called from a background thread,
+        or during the "idle" phase of an event loop.
+        """
+        while True:
+            try:
+                ping_after, session = self._sessions.get(block=False)
+            except queue.Empty:  # all sessions in use
+                break
+            if ping_after > _NOW():  # oldest session is fresh
+                # Re-add to queue with existing expiration
+                self._sessions.put((ping_after, session))
+                break
+            if not session.exists():  # stale
+                session = self._new_session()
+                session.create()
+            # Re-add to queue with new expiration
+            self.put(session)
+
+
+class TransactionPingingPool(PingingPool):
+    """Concrete session pool implementation:
+
+    In addition to the features of :class:`PingingPool`, this class
+    creates and begins a transaction for each of its sessions at startup.
+
+    When a session is returned to the pool, if its transaction has been
+    committed or rolled back, the pool creates a new transaction for the
+    session and pushes the transaction onto a separate queue of "transactions
+    to begin."  The application is responsible for flushing this queue
+    as appropriate via the pool's :meth:`begin_pending_transactions` method.
+
+    :type size: int
+    :param size: fixed pool size
+
+    :type default_timeout: int
+    :param default_timeout: default timeout, in seconds, to wait for
+                            a returned session.
+
+    :type ping_interval: int
+    :param ping_interval: interval at which to ping sessions.
+
+    :type labels: dict (str -> str) or None
+    :param labels: (Optional) user-assigned labels for sessions created
+                    by the pool.
+    """
+
+    def __init__(self, size=10, default_timeout=10, ping_interval=3000, labels=None):
+        self._pending_sessions = queue.Queue()
+
+        super(TransactionPingingPool, self).__init__(
+            size, default_timeout, ping_interval, labels=labels
+        )
+
+        self.begin_pending_transactions()
+
+    def bind(self, database):
+        """Associate the pool with a database.
+
+        :type database: :class:`~google.cloud.spanner_v1.database.Database`
+        :param database: database used by the pool:  used to create sessions
+                         when needed.
+        """
+        super(TransactionPingingPool, self).bind(database)
+        self.begin_pending_transactions()
+
+    def put(self, session):
+        """Return a session to the pool.
+
+        Never blocks:  if the pool is full, raises.
+
+        :type session: :class:`~google.cloud.spanner_v1.session.Session`
+        :param session: the session being returned.
+
+        :raises: :exc:`six.moves.queue.Full` if the queue is full.
+        """
+        if self._sessions.full():
+            raise queue.Full
+
+        txn = session._transaction
+        if txn is None or txn.committed() or txn._rolled_back:
+            session.transaction()
+            self._pending_sessions.put(session)
+        else:
+            super(TransactionPingingPool, self).put(session)
+
+    def begin_pending_transactions(self):
+        """Begin all transactions for sessions added to the pool."""
+        while not self._pending_sessions.empty():
+            session = self._pending_sessions.get()
+            session._transaction.begin()
+            super(TransactionPingingPool, self).put(session)
+
+
+class SessionCheckout(object):
+    """Context manager: hold session checked out from a pool.
+
+    :type pool: concrete subclass of
+        :class:`~google.cloud.spanner_v1.session.AbstractSessionPool`
+    :param pool: Pool from which to check out a session.
+
+    :param kwargs: extra keyword arguments to be passed to :meth:`pool.get`.
+    """
+
+    _session = None  # Not checked out until '__enter__'.
+
+    def __init__(self, pool, **kwargs):
+        self._pool = pool
+        self._kwargs = kwargs.copy()
+
+    def __enter__(self):
+        self._session = self._pool.get(**self._kwargs)
+        return self._session
+
+    def __exit__(self, *ignored):
+        self._pool.put(self._session)
diff --git a/spanner/google/cloud/spanner_v1/proto/__init__.py b/spanner/google/cloud/spanner_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/google/cloud/spanner_v1/proto/keys.proto b/spanner/google/cloud/spanner_v1/proto/keys.proto
new file mode 100644
index 000000000000..1ae95749362f
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/keys.proto
@@ -0,0 +1,163 @@
+// 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.spanner.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/struct.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+option java_outer_classname = "KeysProto";
+option java_package = "com.google.spanner.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\V1";
+
+// KeyRange represents a range of rows in a table or index.
+//
+// A range has a start key and an end key. These keys can be open or
+// closed, indicating if the range includes rows with that key.
+//
+// Keys are represented by lists, where the ith value in the list
+// corresponds to the ith component of the table or index primary key.
+// Individual values are encoded as described
+// [here][google.spanner.v1.TypeCode].
+//
+// For example, consider the following table definition:
+//
+//     CREATE TABLE UserEvents (
+//       UserName STRING(MAX),
+//       EventDate STRING(10)
+//     ) PRIMARY KEY(UserName, EventDate);
+//
+// The following keys name rows in this table:
+//
+//     ["Bob", "2014-09-23"]
+//     ["Alfred", "2015-06-12"]
+//
+// Since the `UserEvents` table's `PRIMARY KEY` clause names two
+// columns, each `UserEvents` key has two elements; the first is the
+// `UserName`, and the second is the `EventDate`.
+//
+// Key ranges with multiple components are interpreted
+// lexicographically by component using the table or index key's declared
+// sort order. For example, the following range returns all events for
+// user `"Bob"` that occurred in the year 2015:
+//
+//     "start_closed": ["Bob", "2015-01-01"]
+//     "end_closed": ["Bob", "2015-12-31"]
+//
+// Start and end keys can omit trailing key components. This affects the
+// inclusion and exclusion of rows that exactly match the provided key
+// components: if the key is closed, then rows that exactly match the
+// provided components are included; if the key is open, then rows
+// that exactly match are not included.
+//
+// For example, the following range includes all events for `"Bob"` that
+// occurred during and after the year 2000:
+//
+//     "start_closed": ["Bob", "2000-01-01"]
+//     "end_closed": ["Bob"]
+//
+// The next example retrieves all events for `"Bob"`:
+//
+//     "start_closed": ["Bob"]
+//     "end_closed": ["Bob"]
+//
+// To retrieve events before the year 2000:
+//
+//     "start_closed": ["Bob"]
+//     "end_open": ["Bob", "2000-01-01"]
+//
+// The following range includes all rows in the table:
+//
+//     "start_closed": []
+//     "end_closed": []
+//
+// This range returns all users whose `UserName` begins with any
+// character from A to C:
+//
+//     "start_closed": ["A"]
+//     "end_open": ["D"]
+//
+// This range returns all users whose `UserName` begins with B:
+//
+//     "start_closed": ["B"]
+//     "end_open": ["C"]
+//
+// Key ranges honor column sort order. For example, suppose a table is
+// defined as follows:
+//
+//     CREATE TABLE DescendingSortedTable {
+//       Key INT64,
+//       ...
+//     ) PRIMARY KEY(Key DESC);
+//
+// The following range retrieves all rows with key values between 1
+// and 100 inclusive:
+//
+//     "start_closed": ["100"]
+//     "end_closed": ["1"]
+//
+// Note that 100 is passed as the start, and 1 is passed as the end,
+// because `Key` is a descending column in the schema.
+message KeyRange {
+  // The start key must be provided. It can be either closed or open.
+  oneof start_key_type {
+    // If the start is closed, then the range includes all rows whose
+    // first `len(start_closed)` key columns exactly match `start_closed`.
+    google.protobuf.ListValue start_closed = 1;
+
+    // If the start is open, then the range excludes rows whose first
+    // `len(start_open)` key columns exactly match `start_open`.
+    google.protobuf.ListValue start_open = 2;
+  }
+
+  // The end key must be provided. It can be either closed or open.
+  oneof end_key_type {
+    // If the end is closed, then the range includes all rows whose
+    // first `len(end_closed)` key columns exactly match `end_closed`.
+    google.protobuf.ListValue end_closed = 3;
+
+    // If the end is open, then the range excludes rows whose first
+    // `len(end_open)` key columns exactly match `end_open`.
+    google.protobuf.ListValue end_open = 4;
+  }
+}
+
+// `KeySet` defines a collection of Cloud Spanner keys and/or key ranges. All
+// the keys are expected to be in the same table or index. The keys need
+// not be sorted in any particular way.
+//
+// If the same key is specified multiple times in the set (for example
+// if two ranges, two keys, or a key and a range overlap), Cloud Spanner
+// behaves as if the key were only specified once.
+message KeySet {
+  // A list of specific keys. Entries in `keys` should have exactly as
+  // many elements as there are columns in the primary or index key
+  // with which this `KeySet` is used.  Individual key values are
+  // 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.
+  repeated KeyRange ranges = 2;
+
+  // For convenience `all` can be set to `true` to indicate that this
+  // `KeySet` matches all keys in the table or index. Note that any keys
+  // specified in `keys` or `ranges` are only yielded once.
+  bool all = 3;
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/keys_pb2.py b/spanner/google/cloud/spanner_v1/proto/keys_pb2.py
new file mode 100644
index 000000000000..3d381357b88c
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/keys_pb2.py
@@ -0,0 +1,448 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/keys.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/keys.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\tKeysProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n(google/cloud/spanner_v1/proto/keys.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto"\xf4\x01\n\x08KeyRange\x12\x32\n\x0cstart_closed\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nstart_open\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nend_closed\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x12.\n\x08\x65nd_open\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x42\x10\n\x0estart_key_typeB\x0e\n\x0c\x65nd_key_type"l\n\x06KeySet\x12(\n\x04keys\x18\x01 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12+\n\x06ranges\x18\x02 \x03(\x0b\x32\x1b.google.spanner.v1.KeyRange\x12\x0b\n\x03\x61ll\x18\x03 \x01(\x08\x42\x92\x01\n\x15\x63om.google.spanner.v1B\tKeysProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_KEYRANGE = _descriptor.Descriptor(
+    name="KeyRange",
+    full_name="google.spanner.v1.KeyRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_closed",
+            full_name="google.spanner.v1.KeyRange.start_closed",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_open",
+            full_name="google.spanner.v1.KeyRange.start_open",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_closed",
+            full_name="google.spanner.v1.KeyRange.end_closed",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_open",
+            full_name="google.spanner.v1.KeyRange.end_open",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="start_key_type",
+            full_name="google.spanner.v1.KeyRange.start_key_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        ),
+        _descriptor.OneofDescriptor(
+            name="end_key_type",
+            full_name="google.spanner.v1.KeyRange.end_key_type",
+            index=1,
+            containing_type=None,
+            fields=[],
+        ),
+    ],
+    serialized_start=124,
+    serialized_end=368,
+)
+
+
+_KEYSET = _descriptor.Descriptor(
+    name="KeySet",
+    full_name="google.spanner.v1.KeySet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="keys",
+            full_name="google.spanner.v1.KeySet.keys",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ranges",
+            full_name="google.spanner.v1.KeySet.ranges",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="all",
+            full_name="google.spanner.v1.KeySet.all",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=370,
+    serialized_end=478,
+)
+
+_KEYRANGE.fields_by_name[
+    "start_closed"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_KEYRANGE.fields_by_name[
+    "start_open"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_KEYRANGE.fields_by_name[
+    "end_closed"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_KEYRANGE.fields_by_name[
+    "end_open"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_KEYRANGE.oneofs_by_name["start_key_type"].fields.append(
+    _KEYRANGE.fields_by_name["start_closed"]
+)
+_KEYRANGE.fields_by_name["start_closed"].containing_oneof = _KEYRANGE.oneofs_by_name[
+    "start_key_type"
+]
+_KEYRANGE.oneofs_by_name["start_key_type"].fields.append(
+    _KEYRANGE.fields_by_name["start_open"]
+)
+_KEYRANGE.fields_by_name["start_open"].containing_oneof = _KEYRANGE.oneofs_by_name[
+    "start_key_type"
+]
+_KEYRANGE.oneofs_by_name["end_key_type"].fields.append(
+    _KEYRANGE.fields_by_name["end_closed"]
+)
+_KEYRANGE.fields_by_name["end_closed"].containing_oneof = _KEYRANGE.oneofs_by_name[
+    "end_key_type"
+]
+_KEYRANGE.oneofs_by_name["end_key_type"].fields.append(
+    _KEYRANGE.fields_by_name["end_open"]
+)
+_KEYRANGE.fields_by_name["end_open"].containing_oneof = _KEYRANGE.oneofs_by_name[
+    "end_key_type"
+]
+_KEYSET.fields_by_name[
+    "keys"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_KEYSET.fields_by_name["ranges"].message_type = _KEYRANGE
+DESCRIPTOR.message_types_by_name["KeyRange"] = _KEYRANGE
+DESCRIPTOR.message_types_by_name["KeySet"] = _KEYSET
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+KeyRange = _reflection.GeneratedProtocolMessageType(
+    "KeyRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KEYRANGE,
+        __module__="google.cloud.spanner_v1.proto.keys_pb2",
+        __doc__="""KeyRange represents a range of rows in a table or index.
+  
+  A range has a start key and an end key. These keys can be open or
+  closed, indicating if the range includes rows with that key.
+  
+  Keys are represented by lists, where the ith value in the list
+  corresponds to the ith component of the table or index primary key.
+  Individual values are encoded as described
+  [here][google.spanner.v1.TypeCode].
+  
+  For example, consider the following table definition:
+  
+  ::
+  
+      CREATE TABLE UserEvents (
+        UserName STRING(MAX),
+        EventDate STRING(10)
+      ) PRIMARY KEY(UserName, EventDate);
+  
+  The following keys name rows in this table:
+  
+  ::
+  
+      ["Bob", "2014-09-23"]
+      ["Alfred", "2015-06-12"]
+  
+  Since the ``UserEvents`` table's ``PRIMARY KEY`` clause names two
+  columns, each ``UserEvents`` key has two elements; the first is the
+  ``UserName``, and the second is the ``EventDate``.
+  
+  Key ranges with multiple components are interpreted lexicographically by
+  component using the table or index key's declared sort order. For
+  example, the following range returns all events for user ``"Bob"`` that
+  occurred in the year 2015:
+  
+  ::
+  
+      "start_closed": ["Bob", "2015-01-01"]
+      "end_closed": ["Bob", "2015-12-31"]
+  
+  Start and end keys can omit trailing key components. This affects the
+  inclusion and exclusion of rows that exactly match the provided key
+  components: if the key is closed, then rows that exactly match the
+  provided components are included; if the key is open, then rows that
+  exactly match are not included.
+  
+  For example, the following range includes all events for ``"Bob"`` that
+  occurred during and after the year 2000:
+  
+  ::
+  
+      "start_closed": ["Bob", "2000-01-01"]
+      "end_closed": ["Bob"]
+  
+  The next example retrieves all events for ``"Bob"``:
+  
+  ::
+  
+      "start_closed": ["Bob"]
+      "end_closed": ["Bob"]
+  
+  To retrieve events before the year 2000:
+  
+  ::
+  
+      "start_closed": ["Bob"]
+      "end_open": ["Bob", "2000-01-01"]
+  
+  The following range includes all rows in the table:
+  
+  ::
+  
+      "start_closed": []
+      "end_closed": []
+  
+  This range returns all users whose ``UserName`` begins with any
+  character from A to C:
+  
+  ::
+  
+      "start_closed": ["A"]
+      "end_open": ["D"]
+  
+  This range returns all users whose ``UserName`` begins with B:
+  
+  ::
+  
+      "start_closed": ["B"]
+      "end_open": ["C"]
+  
+  Key ranges honor column sort order. For example, suppose a table is
+  defined as follows:
+  
+  ::
+  
+      CREATE TABLE DescendingSortedTable {
+        Key INT64,
+        ...
+      ) PRIMARY KEY(Key DESC);
+  
+  The following range retrieves all rows with key values between 1 and 100
+  inclusive:
+  
+  ::
+  
+      "start_closed": ["100"]
+      "end_closed": ["1"]
+  
+  Note that 100 is passed as the start, and 1 is passed as the end,
+  because ``Key`` is a descending column in the schema.
+  
+  
+  Attributes:
+      start_key_type:
+          The start key must be provided. It can be either closed or
+          open.
+      start_closed:
+          If the start is closed, then the range includes all rows whose
+          first ``len(start_closed)`` key columns exactly match
+          ``start_closed``.
+      start_open:
+          If the start is open, then the range excludes rows whose first
+          ``len(start_open)`` key columns exactly match ``start_open``.
+      end_key_type:
+          The end key must be provided. It can be either closed or open.
+      end_closed:
+          If the end is closed, then the range includes all rows whose
+          first ``len(end_closed)`` key columns exactly match
+          ``end_closed``.
+      end_open:
+          If the end is open, then the range excludes rows whose first
+          ``len(end_open)`` key columns exactly match ``end_open``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.KeyRange)
+    ),
+)
+_sym_db.RegisterMessage(KeyRange)
+
+KeySet = _reflection.GeneratedProtocolMessageType(
+    "KeySet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_KEYSET,
+        __module__="google.cloud.spanner_v1.proto.keys_pb2",
+        __doc__="""``KeySet`` defines a collection of Cloud Spanner keys and/or key ranges.
+  All the keys are expected to be in the same table or index. The keys
+  need not be sorted in any particular way.
+  
+  If the same key is specified multiple times in the set (for example if
+  two ranges, two keys, or a key and a range overlap), Cloud Spanner
+  behaves as if the key were only specified once.
+  
+  
+  Attributes:
+      keys:
+          A list of specific keys. Entries in ``keys`` should have
+          exactly as many elements as there are columns in the primary
+          or index key with which this ``KeySet`` is used. Individual
+          key values are encoded as described
+          [here][google.spanner.v1.TypeCode].
+      ranges:
+          A list of key ranges. See
+          [KeyRange][google.spanner.v1.KeyRange] for more information
+          about key range specifications.
+      all:
+          For convenience ``all`` can be set to ``true`` to indicate
+          that this ``KeySet`` matches all keys in the table or index.
+          Note that any keys specified in ``keys`` or ``ranges`` are
+          only yielded once.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet)
+    ),
+)
+_sym_db.RegisterMessage(KeySet)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/keys_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/keys_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/keys_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/spanner/google/cloud/spanner_v1/proto/mutation.proto b/spanner/google/cloud/spanner_v1/proto/mutation.proto
new file mode 100644
index 000000000000..901e6cfe001a
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/mutation.proto
@@ -0,0 +1,101 @@
+// 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.spanner.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/struct.proto";
+import "google/spanner/v1/keys.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+option java_outer_classname = "MutationProto";
+option java_package = "com.google.spanner.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\V1";
+
+// A modification to one or more Cloud Spanner rows.  Mutations can be
+// 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
+  // [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 list of columns must contain enough columns to allow
+    // Cloud Spanner to derive values for all primary key columns in the
+    // row(s) to be modified.
+    repeated string columns = 2;
+
+    // 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].
+    repeated google.protobuf.ListValue values = 3;
+  }
+
+  // Arguments to [delete][google.spanner.v1.Mutation.delete] operations.
+  message Delete {
+    // 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.
+    KeySet key_set = 2;
+  }
+
+  // Required. The operation to perform.
+  oneof operation {
+    // Insert new rows in a table. If any of the rows already exist,
+    // the write or transaction fails with error `ALREADY_EXISTS`.
+    Write insert = 1;
+
+    // Update existing rows in a table. If any of the rows does not
+    // 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.
+    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`.
+    Write replace = 4;
+
+    // Delete rows from a table. Succeeds whether or not the named
+    // rows were present.
+    Delete delete = 5;
+  }
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/mutation_pb2.py b/spanner/google/cloud/spanner_v1/proto/mutation_pb2.py
new file mode 100644
index 000000000000..6002879385af
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/mutation_pb2.py
@@ -0,0 +1,431 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/mutation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.cloud.spanner_v1.proto import (
+    keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/mutation.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\rMutationProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/spanner_v1/proto/mutation.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a(google/cloud/spanner_v1/proto/keys.proto"\xc6\x03\n\x08Mutation\x12\x33\n\x06insert\x18\x01 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x33\n\x06update\x18\x02 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12=\n\x10insert_or_update\x18\x03 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x07replace\x18\x04 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x06\x64\x65lete\x18\x05 \x01(\x0b\x32".google.spanner.v1.Mutation.DeleteH\x00\x1aS\n\x05Write\x12\r\n\x05table\x18\x01 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x02 \x03(\t\x12*\n\x06values\x18\x03 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x1a\x43\n\x06\x44\x65lete\x12\r\n\x05table\x18\x01 \x01(\t\x12*\n\x07key_set\x18\x02 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x0b\n\toperationB\x96\x01\n\x15\x63om.google.spanner.v1B\rMutationProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_MUTATION_WRITE = _descriptor.Descriptor(
+    name="Write",
+    full_name="google.spanner.v1.Mutation.Write",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.spanner.v1.Mutation.Write.table",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="columns",
+            full_name="google.spanner.v1.Mutation.Write.columns",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.spanner.v1.Mutation.Write.values",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=459,
+    serialized_end=542,
+)
+
+_MUTATION_DELETE = _descriptor.Descriptor(
+    name="Delete",
+    full_name="google.spanner.v1.Mutation.Delete",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.spanner.v1.Mutation.Delete.table",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_set",
+            full_name="google.spanner.v1.Mutation.Delete.key_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=544,
+    serialized_end=611,
+)
+
+_MUTATION = _descriptor.Descriptor(
+    name="Mutation",
+    full_name="google.spanner.v1.Mutation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="insert",
+            full_name="google.spanner.v1.Mutation.insert",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update",
+            full_name="google.spanner.v1.Mutation.update",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="insert_or_update",
+            full_name="google.spanner.v1.Mutation.insert_or_update",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="replace",
+            full_name="google.spanner.v1.Mutation.replace",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete",
+            full_name="google.spanner.v1.Mutation.delete",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_MUTATION_WRITE, _MUTATION_DELETE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="operation",
+            full_name="google.spanner.v1.Mutation.operation",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=170,
+    serialized_end=624,
+)
+
+_MUTATION_WRITE.fields_by_name[
+    "values"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_MUTATION_WRITE.containing_type = _MUTATION
+_MUTATION_DELETE.fields_by_name[
+    "key_set"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET
+_MUTATION_DELETE.containing_type = _MUTATION
+_MUTATION.fields_by_name["insert"].message_type = _MUTATION_WRITE
+_MUTATION.fields_by_name["update"].message_type = _MUTATION_WRITE
+_MUTATION.fields_by_name["insert_or_update"].message_type = _MUTATION_WRITE
+_MUTATION.fields_by_name["replace"].message_type = _MUTATION_WRITE
+_MUTATION.fields_by_name["delete"].message_type = _MUTATION_DELETE
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["insert"])
+_MUTATION.fields_by_name["insert"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["update"])
+_MUTATION.fields_by_name["update"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["operation"].fields.append(
+    _MUTATION.fields_by_name["insert_or_update"]
+)
+_MUTATION.fields_by_name[
+    "insert_or_update"
+].containing_oneof = _MUTATION.oneofs_by_name["operation"]
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["replace"])
+_MUTATION.fields_by_name["replace"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["delete"])
+_MUTATION.fields_by_name["delete"].containing_oneof = _MUTATION.oneofs_by_name[
+    "operation"
+]
+DESCRIPTOR.message_types_by_name["Mutation"] = _MUTATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Mutation = _reflection.GeneratedProtocolMessageType(
+    "Mutation",
+    (_message.Message,),
+    dict(
+        Write=_reflection.GeneratedProtocolMessageType(
+            "Write",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATION_WRITE,
+                __module__="google.cloud.spanner_v1.proto.mutation_pb2",
+                __doc__="""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.
+    
+    
+    Attributes:
+        table:
+            Required. The table whose rows will be written.
+        columns:
+            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
+            row(s) to be modified.
+        values:
+            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].
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write)
+            ),
+        ),
+        Delete=_reflection.GeneratedProtocolMessageType(
+            "Delete",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_MUTATION_DELETE,
+                __module__="google.cloud.spanner_v1.proto.mutation_pb2",
+                __doc__="""Arguments to [delete][google.spanner.v1.Mutation.delete] operations.
+    
+    
+    Attributes:
+        table:
+            Required. The table whose rows will be deleted.
+        key_set:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Delete)
+            ),
+        ),
+        DESCRIPTOR=_MUTATION,
+        __module__="google.cloud.spanner_v1.proto.mutation_pb2",
+        __doc__="""A modification to one or more Cloud Spanner rows. Mutations can be
+  applied to a Cloud Spanner database by sending them in a
+  [Commit][google.spanner.v1.Spanner.Commit] call.
+  
+  
+  Attributes:
+      operation:
+          Required. The operation to perform.
+      insert:
+          Insert new rows in a table. If any of the rows already exist,
+          the write or transaction fails with error ``ALREADY_EXISTS``.
+      update:
+          Update existing rows in a table. If any of the rows does not
+          already exist, the transaction fails with error ``NOT_FOUND``.
+      insert_or_update:
+          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.
+      replace:
+          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\_upda
+          te][google.spanner.v1.Mutation.insert\_or\_update], this means
+          any values not explicitly written become ``NULL``.
+      delete:
+          Delete rows from a table. Succeeds whether or not the named
+          rows were present.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation)
+    ),
+)
+_sym_db.RegisterMessage(Mutation)
+_sym_db.RegisterMessage(Mutation.Write)
+_sym_db.RegisterMessage(Mutation.Delete)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/spanner/google/cloud/spanner_v1/proto/query_plan.proto b/spanner/google/cloud/spanner_v1/proto/query_plan.proto
new file mode 100644
index 000000000000..3f3fe6733db4
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/query_plan.proto
@@ -0,0 +1,131 @@
+// 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.spanner.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/struct.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+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].
+message PlanNode {
+  // Metadata associated with a parent-child relationship appearing in a
+  // [PlanNode][google.spanner.v1.PlanNode].
+  message ChildLink {
+    // The node to which the link points.
+    int32 child_index = 1;
+
+    // The type of the link. For example, in Hash Joins this could be used to
+    // distinguish between the build child and the probe child, or in the case
+    // of the child being an output variable, to represent the tag associated
+    // 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.
+    string variable = 3;
+  }
+
+  // Condensed representation of a node and its subtree. Only present for
+  // `SCALAR` [PlanNode(s)][google.spanner.v1.PlanNode].
+  message ShortRepresentation {
+    // A string representation of the expression subtree rooted at this node.
+    string description = 1;
+
+    // A mapping of (subquery variable name) -> (subquery node id) for cases
+    // where the `description` string of this node references a `SCALAR`
+    // subquery contained in the expression subtree rooted at this node. The
+    // referenced `SCALAR` subquery may not necessarily be a direct child of
+    // this node.
+    map<string, int32> 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.
+  enum Kind {
+    // Not specified.
+    KIND_UNSPECIFIED = 0;
+
+    // Denotes a Relational operator node in the expression tree. Relational
+    // operators represent iterative processing of rows during query execution.
+    // For example, a `TableScan` operation that reads rows from a table.
+    RELATIONAL = 1;
+
+    // Denotes a Scalar node in the expression tree. Scalar nodes represent
+    // non-iterable entities in the query plan. For example, constants or
+    // arithmetic operators appearing inside predicate expressions or references
+    // to column names.
+    SCALAR = 2;
+  }
+
+  // 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.
+  Kind kind = 2;
+
+  // The display name for the node.
+  string display_name = 3;
+
+  // 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.
+  ShortRepresentation short_representation = 5;
+
+  // Attributes relevant to the node contained in a group of key-value pairs.
+  // For example, a Parameter Reference node could have the following
+  // information in its metadata:
+  //
+  //     {
+  //       "parameter_reference": "param1",
+  //       "parameter_type": "array"
+  //     }
+  google.protobuf.Struct metadata = 6;
+
+  // The execution statistics associated with the node, contained in a group of
+  // key-value pairs. Only present if the plan was returned as a result of a
+  // profile query. For example, number of executions, number of rows/time per
+  // execution etc.
+  google.protobuf.Struct execution_stats = 7;
+}
+
+// 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`.
+  repeated PlanNode plan_nodes = 1;
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/query_plan_pb2.py b/spanner/google/cloud/spanner_v1/proto/query_plan_pb2.py
new file mode 100644
index 000000000000..37718bdad555
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/query_plan_pb2.py
@@ -0,0 +1,601 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/query_plan.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/query_plan.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\016QueryPlanProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/spanner_v1/proto/query_plan.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto"\xf8\x04\n\x08PlanNode\x12\r\n\x05index\x18\x01 \x01(\x05\x12.\n\x04kind\x18\x02 \x01(\x0e\x32 .google.spanner.v1.PlanNode.Kind\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12:\n\x0b\x63hild_links\x18\x04 \x03(\x0b\x32%.google.spanner.v1.PlanNode.ChildLink\x12M\n\x14short_representation\x18\x05 \x01(\x0b\x32/.google.spanner.v1.PlanNode.ShortRepresentation\x12)\n\x08metadata\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x30\n\x0f\x65xecution_stats\x18\x07 \x01(\x0b\x32\x17.google.protobuf.Struct\x1a@\n\tChildLink\x12\x13\n\x0b\x63hild_index\x18\x01 \x01(\x05\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x10\n\x08variable\x18\x03 \x01(\t\x1a\xb2\x01\n\x13ShortRepresentation\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12S\n\nsubqueries\x18\x02 \x03(\x0b\x32?.google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry\x1a\x31\n\x0fSubqueriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01"8\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\x0e\n\nRELATIONAL\x10\x01\x12\n\n\x06SCALAR\x10\x02"<\n\tQueryPlan\x12/\n\nplan_nodes\x18\x01 \x03(\x0b\x32\x1b.google.spanner.v1.PlanNodeB\x97\x01\n\x15\x63om.google.spanner.v1B\x0eQueryPlanProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_PLANNODE_KIND = _descriptor.EnumDescriptor(
+    name="Kind",
+    full_name="google.spanner.v1.PlanNode.Kind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="KIND_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RELATIONAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCALAR", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=706,
+    serialized_end=762,
+)
+_sym_db.RegisterEnumDescriptor(_PLANNODE_KIND)
+
+
+_PLANNODE_CHILDLINK = _descriptor.Descriptor(
+    name="ChildLink",
+    full_name="google.spanner.v1.PlanNode.ChildLink",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="child_index",
+            full_name="google.spanner.v1.PlanNode.ChildLink.child_index",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.spanner.v1.PlanNode.ChildLink.type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="variable",
+            full_name="google.spanner.v1.PlanNode.ChildLink.variable",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=459,
+    serialized_end=523,
+)
+
+_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY = _descriptor.Descriptor(
+    name="SubqueriesEntry",
+    full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.value",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=655,
+    serialized_end=704,
+)
+
+_PLANNODE_SHORTREPRESENTATION = _descriptor.Descriptor(
+    name="ShortRepresentation",
+    full_name="google.spanner.v1.PlanNode.ShortRepresentation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.spanner.v1.PlanNode.ShortRepresentation.description",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="subqueries",
+            full_name="google.spanner.v1.PlanNode.ShortRepresentation.subqueries",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=526,
+    serialized_end=704,
+)
+
+_PLANNODE = _descriptor.Descriptor(
+    name="PlanNode",
+    full_name="google.spanner.v1.PlanNode",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.spanner.v1.PlanNode.index",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.spanner.v1.PlanNode.kind",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.spanner.v1.PlanNode.display_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="child_links",
+            full_name="google.spanner.v1.PlanNode.child_links",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="short_representation",
+            full_name="google.spanner.v1.PlanNode.short_representation",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.spanner.v1.PlanNode.metadata",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="execution_stats",
+            full_name="google.spanner.v1.PlanNode.execution_stats",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PLANNODE_CHILDLINK, _PLANNODE_SHORTREPRESENTATION],
+    enum_types=[_PLANNODE_KIND],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=130,
+    serialized_end=762,
+)
+
+
+_QUERYPLAN = _descriptor.Descriptor(
+    name="QueryPlan",
+    full_name="google.spanner.v1.QueryPlan",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="plan_nodes",
+            full_name="google.spanner.v1.QueryPlan.plan_nodes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=764,
+    serialized_end=824,
+)
+
+_PLANNODE_CHILDLINK.containing_type = _PLANNODE
+_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY.containing_type = (
+    _PLANNODE_SHORTREPRESENTATION
+)
+_PLANNODE_SHORTREPRESENTATION.fields_by_name[
+    "subqueries"
+].message_type = _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY
+_PLANNODE_SHORTREPRESENTATION.containing_type = _PLANNODE
+_PLANNODE.fields_by_name["kind"].enum_type = _PLANNODE_KIND
+_PLANNODE.fields_by_name["child_links"].message_type = _PLANNODE_CHILDLINK
+_PLANNODE.fields_by_name[
+    "short_representation"
+].message_type = _PLANNODE_SHORTREPRESENTATION
+_PLANNODE.fields_by_name[
+    "metadata"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_PLANNODE.fields_by_name[
+    "execution_stats"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_PLANNODE_KIND.containing_type = _PLANNODE
+_QUERYPLAN.fields_by_name["plan_nodes"].message_type = _PLANNODE
+DESCRIPTOR.message_types_by_name["PlanNode"] = _PLANNODE
+DESCRIPTOR.message_types_by_name["QueryPlan"] = _QUERYPLAN
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+PlanNode = _reflection.GeneratedProtocolMessageType(
+    "PlanNode",
+    (_message.Message,),
+    dict(
+        ChildLink=_reflection.GeneratedProtocolMessageType(
+            "ChildLink",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PLANNODE_CHILDLINK,
+                __module__="google.cloud.spanner_v1.proto.query_plan_pb2",
+                __doc__="""Metadata associated with a parent-child relationship appearing in a
+    [PlanNode][google.spanner.v1.PlanNode].
+    
+    
+    Attributes:
+        child_index:
+            The node to which the link points.
+        type:
+            The type of the link. For example, in Hash Joins this could be
+            used to distinguish between the build child and the probe
+            child, or in the case of the child being an output variable,
+            to represent the tag associated with the output variable.
+        variable:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink)
+            ),
+        ),
+        ShortRepresentation=_reflection.GeneratedProtocolMessageType(
+            "ShortRepresentation",
+            (_message.Message,),
+            dict(
+                SubqueriesEntry=_reflection.GeneratedProtocolMessageType(
+                    "SubqueriesEntry",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY,
+                        __module__="google.cloud.spanner_v1.proto.query_plan_pb2"
+                        # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry)
+                    ),
+                ),
+                DESCRIPTOR=_PLANNODE_SHORTREPRESENTATION,
+                __module__="google.cloud.spanner_v1.proto.query_plan_pb2",
+                __doc__="""Condensed representation of a node and its subtree. Only present for
+    ``SCALAR`` [PlanNode(s)][google.spanner.v1.PlanNode].
+    
+    
+    Attributes:
+        description:
+            A string representation of the expression subtree rooted at
+            this node.
+        subqueries:
+            A mapping of (subquery variable name) -> (subquery node id)
+            for cases where the ``description`` string of this node
+            references a ``SCALAR`` subquery contained in the expression
+            subtree rooted at this node. The referenced ``SCALAR``
+            subquery may not necessarily be a direct child of this node.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ShortRepresentation)
+            ),
+        ),
+        DESCRIPTOR=_PLANNODE,
+        __module__="google.cloud.spanner_v1.proto.query_plan_pb2",
+        __doc__="""Node information for nodes appearing in a
+  [QueryPlan.plan\_nodes][google.spanner.v1.QueryPlan.plan\_nodes].
+  
+  
+  Attributes:
+      index:
+          The ``PlanNode``'s index in [node
+          list][google.spanner.v1.QueryPlan.plan\_nodes].
+      kind:
+          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.
+      display_name:
+          The display name for the node.
+      child_links:
+          List of child node ``index``\ es and their relationship to
+          this parent.
+      short_representation:
+          Condensed representation for
+          [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+      metadata:
+          Attributes relevant to the node contained in a group of key-
+          value pairs. For example, a Parameter Reference node could
+          have the following information in its metadata:  ::      {
+          "parameter_reference": "param1",       "parameter_type":
+          "array"     }
+      execution_stats:
+          The execution statistics associated with the node, contained
+          in a group of key-value pairs. Only present if the plan was
+          returned as a result of a profile query. For example, number
+          of executions, number of rows/time per execution etc.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode)
+    ),
+)
+_sym_db.RegisterMessage(PlanNode)
+_sym_db.RegisterMessage(PlanNode.ChildLink)
+_sym_db.RegisterMessage(PlanNode.ShortRepresentation)
+_sym_db.RegisterMessage(PlanNode.ShortRepresentation.SubqueriesEntry)
+
+QueryPlan = _reflection.GeneratedProtocolMessageType(
+    "QueryPlan",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUERYPLAN,
+        __module__="google.cloud.spanner_v1.proto.query_plan_pb2",
+        __doc__="""Contains an ordered list of nodes appearing in the query plan.
+  
+  
+  Attributes:
+      plan_nodes:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan)
+    ),
+)
+_sym_db.RegisterMessage(QueryPlan)
+
+
+DESCRIPTOR._options = None
+_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/spanner/google/cloud/spanner_v1/proto/result_set.proto b/spanner/google/cloud/spanner_v1/proto/result_set.proto
new file mode 100644
index 000000000000..55f612f1b9bc
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/result_set.proto
@@ -0,0 +1,208 @@
+// 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.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";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+option java_outer_classname = "ResultSetProto";
+option java_package = "com.google.spanner.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\V1";
+
+// Results from [Read][google.spanner.v1.Spanner.Read] or
+// [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
+message ResultSet {
+  // Metadata about the result set, such as row type information.
+  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].
+  repeated google.protobuf.ListValue rows = 2;
+
+  // Query plan and execution statistics for the SQL statement that
+  // produced this result set. These can be requested by setting
+  // [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].
+  // Other fields may or may not be populated, based on the
+  // [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode].
+  ResultSetStats stats = 3;
+}
+
+// Partial results from a streaming read or SQL query. Streaming reads and
+// SQL queries better tolerate large result sets, large rows, and large
+// values, but are a little trickier to consume.
+message PartialResultSet {
+  // Metadata about the result set, such as row type information.
+  // Only present in the first response.
+  ResultSetMetadata metadata = 1;
+
+  // A streamed result set consists of a stream of values, which might
+  // be split into many `PartialResultSet` messages to accommodate
+  // large rows and/or large values. Every N complete values defines a
+  // row, where N is equal to the number of entries in
+  // [metadata.row_type.fields][google.spanner.v1.StructType.fields].
+  //
+  // Most values are encoded based on type as described
+  // [here][google.spanner.v1.TypeCode].
+  //
+  // 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:
+  //
+  //   * `bool/number/null`: cannot be chunked
+  //   * `string`: concatenate the strings
+  //   * `list`: concatenate the lists. If the last element in a list is a
+  //     `string`, `list`, or `object`, merge it with the first element in
+  //     the next list by applying these rules recursively.
+  //   * `object`: concatenate the (field name, field value) pairs. If a
+  //     field name is duplicated, then apply these rules recursively
+  //     to merge the field values.
+  //
+  // Some examples of merging:
+  //
+  //     # Strings are concatenated.
+  //     "foo", "bar" => "foobar"
+  //
+  //     # Lists of non-strings are concatenated.
+  //     [2, 3], [4] => [2, 3, 4]
+  //
+  //     # Lists are concatenated, but the last and first elements are merged
+  //     # because they are strings.
+  //     ["a", "b"], ["c", "d"] => ["a", "bc", "d"]
+  //
+  //     # Lists are concatenated, but the last and first elements are merged
+  //     # because they are lists. Recursively, the last and first elements
+  //     # of the inner lists are merged because they are strings.
+  //     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]
+  //
+  //     # Non-overlapping object fields are combined.
+  //     {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}
+  //
+  //     # Overlapping object fields are merged.
+  //     {"a": "1"}, {"a": "2"} => {"a": "12"}
+  //
+  //     # Examples of merging objects containing lists of strings.
+  //     {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}
+  //
+  // For a more complete example, suppose a streaming SQL query is
+  // yielding a result set whose rows contain a single string
+  // field. The following `PartialResultSet`s might be yielded:
+  //
+  //     {
+  //       "metadata": { ... }
+  //       "values": ["Hello", "W"]
+  //       "chunked_value": true
+  //       "resume_token": "Af65..."
+  //     }
+  //     {
+  //       "values": ["orl"]
+  //       "chunked_value": true
+  //       "resume_token": "Bqp2..."
+  //     }
+  //     {
+  //       "values": ["d"]
+  //       "resume_token": "Zx1B..."
+  //     }
+  //
+  // This sequence of `PartialResultSet`s encodes two rows, one
+  // containing the field value `"Hello"`, and a second containing the
+  // 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.
+  bool chunked_value = 3;
+
+  // Streaming calls might be interrupted for a variety of reasons, such
+  // as TCP connection loss. If this occurs, the stream of results can
+  // be resumed by re-sending the original request and including
+  // `resume_token`. Note that executing any other transaction in the
+  // same session invalidates the token.
+  bytes resume_token = 4;
+
+  // 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.
+  ResultSetStats stats = 5;
+}
+
+// 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
+  // Users"` could return a `row_type` value like:
+  //
+  //     "fields": [
+  //       { "name": "UserId", "type": { "code": "INT64" } },
+  //       { "name": "UserName", "type": { "code": "STRING" } },
+  //     ]
+  StructType row_type = 1;
+
+  // If the read or SQL query began a transaction as a side-effect, the
+  // information about the new transaction is yielded here.
+  Transaction transaction = 2;
+}
+
+// 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 query_plan = 1;
+
+  // Aggregated statistics from the execution of the query. Only present when
+  // the query is profiled. For example, a query could return the statistics as
+  // follows:
+  //
+  //     {
+  //       "rows_returned": "3",
+  //       "elapsed_time": "1.22 secs",
+  //       "cpu_time": "1.19 secs"
+  //     }
+  google.protobuf.Struct query_stats = 2;
+
+  // The number of rows modified by the DML statement.
+  oneof row_count {
+    // Standard DML returns an exact count of rows that were modified.
+    int64 row_count_exact = 3;
+
+    // Partitioned DML does not offer exactly-once semantics, so it
+    // returns a lower bound of the rows modified.
+    int64 row_count_lower_bound = 4;
+  }
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/result_set_pb2.py b/spanner/google/cloud/spanner_v1/proto/result_set_pb2.py
new file mode 100644
index 000000000000..2639bd03417e
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/result_set_pb2.py
@@ -0,0 +1,624 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/result_set.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.cloud.spanner_v1.proto import (
+    query_plan_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/result_set.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\016ResultSetProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\370\001\001\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/spanner_v1/proto/result_set.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a.google/cloud/spanner_v1/proto/query_plan.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto"\x9f\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"\xd1\x01\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"y\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\x9a\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xf8\x01\x01\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_RESULTSET = _descriptor.Descriptor(
+    name="ResultSet",
+    full_name="google.spanner.v1.ResultSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.spanner.v1.ResultSet.metadata",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rows",
+            full_name="google.spanner.v1.ResultSet.rows",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stats",
+            full_name="google.spanner.v1.ResultSet.stats",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=269,
+    serialized_end=428,
+)
+
+
+_PARTIALRESULTSET = _descriptor.Descriptor(
+    name="PartialResultSet",
+    full_name="google.spanner.v1.PartialResultSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.spanner.v1.PartialResultSet.metadata",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="values",
+            full_name="google.spanner.v1.PartialResultSet.values",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="chunked_value",
+            full_name="google.spanner.v1.PartialResultSet.chunked_value",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.spanner.v1.PartialResultSet.resume_token",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stats",
+            full_name="google.spanner.v1.PartialResultSet.stats",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=431,
+    serialized_end=640,
+)
+
+
+_RESULTSETMETADATA = _descriptor.Descriptor(
+    name="ResultSetMetadata",
+    full_name="google.spanner.v1.ResultSetMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="row_type",
+            full_name="google.spanner.v1.ResultSetMetadata.row_type",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.ResultSetMetadata.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=642,
+    serialized_end=763,
+)
+
+
+_RESULTSETSTATS = _descriptor.Descriptor(
+    name="ResultSetStats",
+    full_name="google.spanner.v1.ResultSetStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query_plan",
+            full_name="google.spanner.v1.ResultSetStats.query_plan",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_stats",
+            full_name="google.spanner.v1.ResultSetStats.query_stats",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_count_exact",
+            full_name="google.spanner.v1.ResultSetStats.row_count_exact",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="row_count_lower_bound",
+            full_name="google.spanner.v1.ResultSetStats.row_count_lower_bound",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="row_count",
+            full_name="google.spanner.v1.ResultSetStats.row_count",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=766,
+    serialized_end=951,
+)
+
+_RESULTSET.fields_by_name["metadata"].message_type = _RESULTSETMETADATA
+_RESULTSET.fields_by_name[
+    "rows"
+].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_RESULTSET.fields_by_name["stats"].message_type = _RESULTSETSTATS
+_PARTIALRESULTSET.fields_by_name["metadata"].message_type = _RESULTSETMETADATA
+_PARTIALRESULTSET.fields_by_name[
+    "values"
+].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_PARTIALRESULTSET.fields_by_name["stats"].message_type = _RESULTSETSTATS
+_RESULTSETMETADATA.fields_by_name[
+    "row_type"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._STRUCTTYPE
+_RESULTSETMETADATA.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION
+)
+_RESULTSETSTATS.fields_by_name[
+    "query_plan"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2._QUERYPLAN
+)
+_RESULTSETSTATS.fields_by_name[
+    "query_stats"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_RESULTSETSTATS.oneofs_by_name["row_count"].fields.append(
+    _RESULTSETSTATS.fields_by_name["row_count_exact"]
+)
+_RESULTSETSTATS.fields_by_name[
+    "row_count_exact"
+].containing_oneof = _RESULTSETSTATS.oneofs_by_name["row_count"]
+_RESULTSETSTATS.oneofs_by_name["row_count"].fields.append(
+    _RESULTSETSTATS.fields_by_name["row_count_lower_bound"]
+)
+_RESULTSETSTATS.fields_by_name[
+    "row_count_lower_bound"
+].containing_oneof = _RESULTSETSTATS.oneofs_by_name["row_count"]
+DESCRIPTOR.message_types_by_name["ResultSet"] = _RESULTSET
+DESCRIPTOR.message_types_by_name["PartialResultSet"] = _PARTIALRESULTSET
+DESCRIPTOR.message_types_by_name["ResultSetMetadata"] = _RESULTSETMETADATA
+DESCRIPTOR.message_types_by_name["ResultSetStats"] = _RESULTSETSTATS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ResultSet = _reflection.GeneratedProtocolMessageType(
+    "ResultSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESULTSET,
+        __module__="google.cloud.spanner_v1.proto.result_set_pb2",
+        __doc__="""Results from [Read][google.spanner.v1.Spanner.Read] or
+  [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
+  
+  
+  Attributes:
+      metadata:
+          Metadata about the result set, such as row type information.
+      rows:
+          Each element in ``rows`` is a row whose format is defined by [
+          metadata.row\_type][google.spanner.v1.ResultSetMetadata.row\_t
+          ype]. The ith element in each row matches the ith field in [me
+          tadata.row\_type][google.spanner.v1.ResultSetMetadata.row\_typ
+          e]. Elements are encoded based on type as described
+          [here][google.spanner.v1.TypeCode].
+      stats:
+          Query plan and execution statistics for the SQL statement that
+          produced this result set. These can be requested by setting [E
+          xecuteSqlRequest.query\_mode][google.spanner.v1.ExecuteSqlRequ
+          est.query\_mode]. DML statements always produce stats
+          containing the number of rows modified, unless executed using
+          the [ExecuteSqlRequest.QueryMode.PLAN][google.spanner.v1.Execu
+          teSqlRequest.QueryMode.PLAN] [ExecuteSqlRequest.query\_mode][g
+          oogle.spanner.v1.ExecuteSqlRequest.query\_mode]. Other fields
+          may or may not be populated, based on the [ExecuteSqlRequest.q
+          uery\_mode][google.spanner.v1.ExecuteSqlRequest.query\_mode].
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSet)
+    ),
+)
+_sym_db.RegisterMessage(ResultSet)
+
+PartialResultSet = _reflection.GeneratedProtocolMessageType(
+    "PartialResultSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTIALRESULTSET,
+        __module__="google.cloud.spanner_v1.proto.result_set_pb2",
+        __doc__="""Partial results from a streaming read or SQL query. Streaming reads and
+  SQL queries better tolerate large result sets, large rows, and large
+  values, but are a little trickier to consume.
+  
+  
+  Attributes:
+      metadata:
+          Metadata about the result set, such as row type information.
+          Only present in the first response.
+      values:
+          A streamed result set consists of a stream of values, which
+          might be split into many ``PartialResultSet`` messages to
+          accommodate large rows and/or large values. Every N complete
+          values defines a row, where N is equal to the number of
+          entries in [metadata.row\_type.fields][google.spanner.v1.Struc
+          tType.fields].  Most values are encoded based on type as
+          described [here][google.spanner.v1.TypeCode].  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:  -
+          ``bool/number/null``: cannot be chunked -  ``string``:
+          concatenate the strings -  ``list``: concatenate the lists. If
+          the last element in a list is a    ``string``, ``list``, or
+          ``object``, merge it with the first element    in the next
+          list by applying these rules recursively. -  ``object``:
+          concatenate the (field name, field value) pairs. If a    field
+          name is duplicated, then apply these rules recursively to
+          merge    the field values.  Some examples of merging:  ::
+          # Strings are concatenated.     "foo", "bar" => "foobar"
+          # Lists of non-strings are concatenated.     [2, 3], [4] =>
+          [2, 3, 4]      # Lists are concatenated, but the last and
+          first elements are merged     # because they are strings.
+          ["a", "b"], ["c", "d"] => ["a", "bc", "d"]      # Lists are
+          concatenated, but the last and first elements are merged     #
+          because they are lists. Recursively, the last and first
+          elements     # of the inner lists are merged because they are
+          strings.     ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b",
+          "cd"], "e"]      # Non-overlapping object fields are combined.
+          {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}      #
+          Overlapping object fields are merged.     {"a": "1"}, {"a":
+          "2"} => {"a": "12"}      # Examples of merging objects
+          containing lists of strings.     {"a": ["1"]}, {"a": ["2"]} =>
+          {"a": ["12"]}  For a more complete example, suppose a
+          streaming SQL query is yielding a result set whose rows
+          contain a single string field. The following
+          ``PartialResultSet``\ s might be yielded:  ::      {
+          "metadata": { ... }       "values": ["Hello", "W"]
+          "chunked_value": true       "resume_token": "Af65..."     }
+          {       "values": ["orl"]       "chunked_value": true
+          "resume_token": "Bqp2..."     }     {       "values": ["d"]
+          "resume_token": "Zx1B..."     }  This sequence of
+          ``PartialResultSet``\ s encodes two rows, one containing the
+          field value ``"Hello"``, and a second containing the field
+          value ``"World" = "W" + "orl" + "d"``.
+      chunked_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.
+      resume_token:
+          Streaming calls might be interrupted for a variety of reasons,
+          such as TCP connection loss. If this occurs, the stream of
+          results can be resumed by re-sending the original request and
+          including ``resume_token``. Note that executing any other
+          transaction in the same session invalidates the token.
+      stats:
+          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.Exec
+          uteSqlRequest.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.PartialResultSet)
+    ),
+)
+_sym_db.RegisterMessage(PartialResultSet)
+
+ResultSetMetadata = _reflection.GeneratedProtocolMessageType(
+    "ResultSetMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESULTSETMETADATA,
+        __module__="google.cloud.spanner_v1.proto.result_set_pb2",
+        __doc__="""Metadata about a [ResultSet][google.spanner.v1.ResultSet] or
+  [PartialResultSet][google.spanner.v1.PartialResultSet].
+  
+  
+  Attributes:
+      row_type:
+          Indicates the field names and types for the rows in the result
+          set. For example, a SQL query like ``"SELECT UserId, UserName
+          FROM Users"`` could return a ``row_type`` value like:  ::
+          "fields": [       { "name": "UserId", "type": { "code":
+          "INT64" } },       { "name": "UserName", "type": { "code":
+          "STRING" } },     ]
+      transaction:
+          If the read or SQL query began a transaction as a side-effect,
+          the information about the new transaction is yielded here.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ResultSetMetadata)
+
+ResultSetStats = _reflection.GeneratedProtocolMessageType(
+    "ResultSetStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESULTSETSTATS,
+        __module__="google.cloud.spanner_v1.proto.result_set_pb2",
+        __doc__="""Additional statistics about a [ResultSet][google.spanner.v1.ResultSet]
+  or [PartialResultSet][google.spanner.v1.PartialResultSet].
+  
+  
+  Attributes:
+      query_plan:
+          [QueryPlan][google.spanner.v1.QueryPlan] for the query
+          associated with this result.
+      query_stats:
+          Aggregated statistics from the execution of the query. Only
+          present when the query is profiled. For example, a query could
+          return the statistics as follows:  ::      {
+          "rows_returned": "3",       "elapsed_time": "1.22 secs",
+          "cpu_time": "1.19 secs"     }
+      row_count:
+          The number of rows modified by the DML statement.
+      row_count_exact:
+          Standard DML returns an exact count of rows that were
+          modified.
+      row_count_lower_bound:
+          Partitioned DML does not offer exactly-once semantics, so it
+          returns a lower bound of the rows modified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats)
+    ),
+)
+_sym_db.RegisterMessage(ResultSetStats)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/spanner/google/cloud/spanner_v1/proto/spanner.proto b/spanner/google/cloud/spanner_v1/proto/spanner.proto
new file mode 100644
index 000000000000..a643e7a6c1a1
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/spanner.proto
@@ -0,0 +1,835 @@
+// 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.spanner.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/spanner/v1/keys.proto";
+import "google/spanner/v1/mutation.proto";
+import "google/spanner/v1/result_set.proto";
+import "google/spanner/v1/transaction.proto";
+import "google/spanner/v1/type.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+option java_outer_classname = "SpannerProto";
+option java_package = "com.google.spanner.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\V1";
+
+// 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 {
+  // 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
+  // transactions.
+  //
+  // Sessions can only execute one transaction at a time. To execute
+  // multiple concurrent read-write/write-only transactions, create
+  // multiple sessions. Note that standalone reads and queries use a
+  // 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
+  // operations are sent for more than an hour. If a session is deleted,
+  // requests to it return `NOT_FOUND`.
+  //
+  // Idle sessions can be kept alive by sending a trivial SQL query
+  // periodically, e.g., `"SELECT 1"`.
+  rpc CreateSession(CreateSessionRequest) returns (Session) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/instances/*/databases/*}/sessions"
+      body: "*"
+    };
+  }
+
+  // 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: "*"
+    };
+  }
+
+  // Gets a session. Returns `NOT_FOUND` if the session does not exist.
+  // This is mainly useful for determining whether a session is still
+  // alive.
+  rpc GetSession(GetSessionRequest) returns (Session) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instances/*/databases/*/sessions/*}"
+    };
+  }
+
+  // Lists all sessions in a given database.
+  rpc ListSessions(ListSessionsRequest) returns (ListSessionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{database=projects/*/instances/*/databases/*}/sessions"
+    };
+  }
+
+  // Ends a session, releasing server resources associated with it. This will
+  // asynchronously trigger cancellation of any operations that are running with
+  // this session.
+  rpc DeleteSession(DeleteSessionRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/instances/*/databases/*/sessions/*}"
+    };
+  }
+
+  // Executes an SQL statement, returning all results in a single reply. This
+  // method cannot be used to return a result set larger than 10 MiB;
+  // if the query yields more data than that, the query fails with
+  // a `FAILED_PRECONDITION` error.
+  //
+  // 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.
+  //
+  // Larger result sets can be fetched in streaming fashion by calling
+  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
+  // instead.
+  rpc ExecuteSql(ExecuteSqlRequest) returns (ResultSet) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql"
+      body: "*"
+    };
+  }
+
+  // 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"
+      body: "*"
+    };
+  }
+
+  // Executes a batch of SQL DML statements. This method allows many statements
+  // 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].
+  rpc ExecuteBatchDml(ExecuteBatchDmlRequest)
+      returns (ExecuteBatchDmlResponse) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml"
+      body: "*"
+    };
+  }
+
+  // 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
+  // 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.
+  //
+  // Larger result sets can be yielded in streaming fashion by calling
+  // [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
+  rpc Read(ReadRequest) returns (ResultSet) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead"
+      body: "*"
+    };
+  }
+
+  // Begins a new transaction. This step can often be skipped:
+  // [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) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction"
+      body: "*"
+    };
+  }
+
+  // Commits a transaction. The request includes the mutations to be
+  // applied to rows in the database.
+  //
+  // `Commit` might return an `ABORTED` error. This can occur at any time;
+  // commonly, the cause is conflicts with concurrent
+  // transactions. However, it can also happen for a variety of other
+  // reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
+  // the transaction from the beginning, re-using the same session.
+  rpc Commit(CommitRequest) returns (CommitResponse) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit"
+      body: "*"
+    };
+  }
+
+  // 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.
+  //
+  // `Rollback` returns `OK` if it successfully aborts the transaction, the
+  // transaction was already aborted, or the transaction is not
+  // found. `Rollback` never returns `ABORTED`.
+  rpc Rollback(RollbackRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback"
+      body: "*"
+    };
+  }
+
+  // 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.
+  //
+  // 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
+  // old.  When any of these happen, it is not possible to resume the query, and
+  // the whole operation must be restarted from the beginning.
+  rpc PartitionQuery(PartitionQueryRequest) returns (PartitionResponse) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery"
+      body: "*"
+    };
+  }
+
+  // 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.
+  //
+  // 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
+  // old.  When any of these happen, it is not possible to resume the read, and
+  // the whole operation must be restarted from the beginning.
+  rpc PartitionRead(PartitionReadRequest) returns (PartitionResponse) {
+    option (google.api.http) = {
+      post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead"
+      body: "*"
+    };
+  }
+}
+
+// The request for [CreateSession][google.spanner.v1.Spanner.CreateSession].
+message CreateSessionRequest {
+  // Required. The database in which the new session is created.
+  string database = 1;
+
+  // 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;
+
+  // 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;
+}
+
+// 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 {
+  // The name of the session. This is always system-assigned; values provided
+  // when creating a session are ignored.
+  string name = 1;
+
+  // The labels for the session.
+  //
+  //  * 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 64 labels can be associated with a given session.
+  //
+  // See https://goo.gl/xmQnxf for more information on and examples of labels.
+  map<string, string> labels = 2;
+
+  // Output only. The timestamp when the session is created.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Output only. The approximate timestamp when the session is last used. It is
+  // typically earlier than the actual last use time.
+  google.protobuf.Timestamp approximate_last_use_time = 4;
+}
+
+// The request for [GetSession][google.spanner.v1.Spanner.GetSession].
+message GetSessionRequest {
+  // Required. The name of the session to retrieve.
+  string name = 1;
+}
+
+// The request for [ListSessions][google.spanner.v1.Spanner.ListSessions].
+message ListSessionsRequest {
+  // Required. The database in which to list sessions.
+  string database = 1;
+
+  // 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
+  // [ListSessionsResponse][google.spanner.v1.ListSessionsResponse].
+  string page_token = 3;
+
+  // An expression for filtering the results of the request. Filter rules are
+  // case insensitive. The fields eligible for filtering are:
+  //
+  //   * `labels.key` where key is the name of a label
+  //
+  // Some examples of using filters are:
+  //
+  //   * `labels.env:*` --> The session has the label "env".
+  //   * `labels.env:dev` --> The session has the label "env" and the value of
+  //                        the label contains the string "dev".
+  string filter = 4;
+}
+
+// The response for [ListSessions][google.spanner.v1.Spanner.ListSessions].
+message ListSessionsResponse {
+  // The list of requested sessions.
+  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.
+  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;
+}
+
+// The request for [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+// [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql].
+message ExecuteSqlRequest {
+  // Mode in which the statement must be processed.
+  enum QueryMode {
+    // The default mode. Only the statement results are returned.
+    NORMAL = 0;
+
+    // This mode returns only the query plan, without any results or
+    // execution statistics information.
+    PLAN = 1;
+
+    // This mode returns both the query plan and the execution statistics along
+    // with the results.
+    PROFILE = 2;
+  }
+
+  // Required. The session in which the SQL query should be performed.
+  string session = 1;
+
+  // 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.
+  //
+  // Partitioned DML requires an existing PartitionedDml transaction ID.
+  TransactionSelector transaction = 2;
+
+  // Required. The SQL string.
+  string sql = 3;
+
+  // 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.
+  //
+  // 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.
+  //
+  // Parameter values are specified using `params`, which is a JSON
+  // object whose keys are parameter names, and whose values are the
+  // corresponding parameter values.
+  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.
+  //
+  // 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
+  // definition of [Type][google.spanner.v1.Type] for more information
+  // about SQL types.
+  map<string, Type> param_types = 5;
+
+  // 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.
+  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].
+  QueryMode query_mode = 7;
+
+  // If present, results will be restricted to the specified partition
+  // previously created using PartitionQuery().  There must be an exact
+  // match for the values of fields common to this message and the
+  // PartitionQueryRequest message used to create this partition_token.
+  bytes partition_token = 8;
+
+  // A per-transaction sequence number used to identify this request. This
+  // 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.
+  //
+  // Required for DML statements. Ignored for queries.
+  int64 seqno = 9;
+}
+
+// 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.
+    //
+    // 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.
+    //
+    // Parameter values are specified using `params`, which is a JSON
+    // object whose keys are parameter names, and whose values are the
+    // corresponding parameter values.
+    google.protobuf.Struct params = 2;
+
+    // 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.ExecuteBatchDmlRequest.Statement.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
+    // definition of [Type][google.spanner.v1.Type] for more information
+    // about SQL types.
+    map<string, Type> param_types = 3;
+  }
+
+  // Required. The session in which the DML statements should be performed.
+  string session = 1;
+
+  // 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;
+
+  // 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.
+  //
+  // REQUIRES: statements_size() > 0.
+  repeated Statement statements = 3;
+
+  // 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;
+}
+
+// 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:
+//
+//   1. Check if 'status' field is OkStatus.
+//   2. Check if result_sets_size() equals the number of statements in
+//      [ExecuteBatchDmlRequest][Spanner.ExecuteBatchDmlRequest].
+//
+// 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: 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.
+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.
+  //
+  // Only the first ResultSet in the response contains a valid
+  // [ResultSetMetadata][google.spanner.v1.ResultSetMetadata].
+  repeated ResultSet result_sets = 1;
+
+  // If all DML statements are executed successfully, status will be OK.
+  // Otherwise, the error status of the first failed statement.
+  google.rpc.Status status = 2;
+}
+
+// Options for a PartitionQueryRequest and
+// PartitionReadRequest.
+message PartitionOptions {
+  // **Note:** This hint is currently ignored by PartitionQuery and
+  // PartitionRead requests.
+  //
+  // The desired data size for each partition generated.  The default for this
+  // option is currently 1 GiB.  This is only a hint. The actual size of each
+  // partition may be smaller or larger than this size request.
+  int64 partition_size_bytes = 1;
+
+  // **Note:** This hint is currently ignored by PartitionQuery and
+  // PartitionRead requests.
+  //
+  // The desired maximum number of partitions to return.  For example, this may
+  // be set to the number of workers available.  The default for this option
+  // is currently 10,000. The maximum value is currently 200,000.  This is only
+  // a hint.  The actual number of partitions returned may be smaller or larger
+  // than this maximum count request.
+  int64 max_partitions = 2;
+}
+
+// The request for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery]
+message PartitionQueryRequest {
+  // Required. The session used to create the partitions.
+  string session = 1;
+
+  // 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
+  // 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
+  // splits, remotely evaluates a subquery independently on each split, and
+  // 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
+  // PartitionedDml transaction for large, partition-friendly DML operations.
+  string sql = 3;
+
+  // 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.
+  //
+  // 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.
+  //
+  // Parameter values are specified using `params`, which is a JSON
+  // object whose keys are parameter names, and whose values are the
+  // corresponding parameter values.
+  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.
+  //
+  // 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
+  // definition of [Type][google.spanner.v1.Type] for more information
+  // about SQL types.
+  map<string, Type> param_types = 5;
+
+  // Additional options that affect how many partitions are created.
+  PartitionOptions partition_options = 6;
+}
+
+// The request for [PartitionRead][google.spanner.v1.Spanner.PartitionRead]
+message PartitionReadRequest {
+  // Required. The session used to create the partitions.
+  string session = 1;
+
+  // 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 index = 4;
+
+  // 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
+  // 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;
+
+  // Additional options that affect how many partitions are created.
+  PartitionOptions partition_options = 9;
+}
+
+// Information returned for each partition returned in a
+// PartitionResponse.
+message Partition {
+  // This token can be passed to Read, StreamingRead, ExecuteSql, or
+  // ExecuteStreamingSql requests to restrict the results to those identified by
+  // this partition token.
+  bytes partition_token = 1;
+}
+
+// The response for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery]
+// or [PartitionRead][google.spanner.v1.Spanner.PartitionRead]
+message PartitionResponse {
+  // Partitions created by this request.
+  repeated Partition partitions = 1;
+
+  // Transaction created by this request.
+  Transaction transaction = 2;
+}
+
+// The request for [Read][google.spanner.v1.Spanner.Read] and
+// [StreamingRead][google.spanner.v1.Spanner.StreamingRead].
+message ReadRequest {
+  // Required. The session in which the read should be performed.
+  string session = 1;
+
+  // 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 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. `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.
+  //
+  // 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;
+
+  // 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
+  // `partition_token` is set.
+  int64 limit = 8;
+
+  // 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
+  // that yielded this token.
+  bytes resume_token = 9;
+
+  // If present, results will be restricted to the specified partition
+  // previously created using PartitionRead().    There must be an exact
+  // match for the values of fields common to this message and the
+  // PartitionReadRequest message used to create this partition_token.
+  bytes partition_token = 10;
+}
+
+// The request for
+// [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction].
+message BeginTransactionRequest {
+  // Required. The session in which the transaction runs.
+  string session = 1;
+
+  // Required. Options for the new transaction.
+  TransactionOptions options = 2;
+}
+
+// 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;
+
+  // Required. The transaction in which to commit.
+  oneof transaction {
+    // Commit a previously-started transaction.
+    bytes transaction_id = 2;
+
+    // Execute mutations in a temporary transaction. Note that unlike
+    // commit of a previously-started transaction, commit with a
+    // temporary transaction is non-idempotent. That is, if the
+    // `CommitRequest` is sent to Cloud Spanner more than once (for
+    // instance, due to retries in the application, or in the
+    // transport library), it is possible that the mutations are
+    // executed more than once. If this is undesirable, use
+    // [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction] and
+    // [Commit][google.spanner.v1.Spanner.Commit] instead.
+    TransactionOptions single_use_transaction = 3;
+  }
+
+  // The mutations to be executed when this transaction commits. All
+  // mutations are applied atomically, in the order they appear in
+  // this list.
+  repeated Mutation mutations = 4;
+}
+
+// The response for [Commit][google.spanner.v1.Spanner.Commit].
+message CommitResponse {
+  // The Cloud Spanner timestamp at which the transaction committed.
+  google.protobuf.Timestamp commit_timestamp = 1;
+}
+
+// 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;
+
+  // Required. The transaction to roll back.
+  bytes transaction_id = 2;
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/spanner_database_admin.proto b/spanner/google/cloud/spanner_v1/proto/spanner_database_admin.proto
new file mode 100644
index 000000000000..56dbff19e17b
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/spanner_database_admin.proto
@@ -0,0 +1,302 @@
+// 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.spanner.admin.database.v1;
+
+import "google/api/annotations.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";
+
+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 = "SpannerDatabaseAdminProto";
+option java_package = "com.google.spanner.admin.database.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Database\\V1";
+
+
+// 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.
+service DatabaseAdmin {
+  // Lists Cloud Spanner databases.
+  rpc ListDatabases(ListDatabasesRequest) returns (ListDatabasesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/instances/*}/databases"
+    };
+  }
+
+  // Creates a new Cloud Spanner database and starts to prepare it for serving.
+  // The returned [long-running operation][google.longrunning.Operation] will
+  // have a name of the format `<database_name>/operations/<operation_id>` 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
+  // [Database][google.spanner.admin.database.v1.Database], if successful.
+  rpc CreateDatabase(CreateDatabaseRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/instances/*}/databases"
+      body: "*"
+    };
+  }
+
+  // Gets the state of a Cloud Spanner database.
+  rpc GetDatabase(GetDatabaseRequest) returns (Database) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instances/*/databases/*}"
+    };
+  }
+
+  // Updates the schema of a Cloud Spanner database by
+  // creating/altering/dropping tables, columns, indexes, etc. The returned
+  // [long-running operation][google.longrunning.Operation] will have a name of
+  // the format `<database_name>/operations/<operation_id>` 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) {
+    option (google.api.http) = {
+      patch: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
+      body: "*"
+    };
+  }
+
+  // Drops (aka deletes) a Cloud Spanner database.
+  rpc DropDatabase(DropDatabaseRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{database=projects/*/instances/*/databases/*}"
+    };
+  }
+
+  // Returns the schema of a Cloud Spanner database as a list of formatted
+  // DDL statements. This method does not show pending schema updates, those may
+  // be queried using the [Operations][google.longrunning.Operations] API.
+  rpc GetDatabaseDdl(GetDatabaseDdlRequest) returns (GetDatabaseDdlResponse) {
+    option (google.api.http) = {
+      get: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
+    };
+  }
+
+  // Sets the access control policy on a database 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the access control policy for a database resource. Returns an empty
+  // policy if a database 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Returns permissions that the caller has on the specified database 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*/databases/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// A Cloud Spanner database.
+message Database {
+  // Indicates the current state of the database.
+  enum State {
+    // Not specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The database is still being created. Operations on the database may fail
+    // with `FAILED_PRECONDITION` in this state.
+    CREATING = 1;
+
+    // The database is fully created and ready for use.
+    READY = 2;
+  }
+
+  // Required. The name of the database. Values are of the form
+  // `projects/<project>/instances/<instance>/databases/<database>`,
+  // where `<database>` is as specified in the `CREATE DATABASE`
+  // statement. This name can be passed to other API methods to
+  // identify the database.
+  string name = 1;
+
+  // Output only. The current database state.
+  State state = 2;
+}
+
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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].
+  string page_token = 4;
+}
+
+// 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.
+  string next_page_token = 2;
+}
+
+// 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/<project>/instances/<instance>`.
+  string parent = 1;
+
+  // 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;
+
+  // An optional 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;
+}
+
+// Metadata type for the operation returned by
+// [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
+message CreateDatabaseMetadata {
+  // The database being created.
+  string database = 1;
+}
+
+// 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/<project>/instances/<instance>/databases/<database>`.
+  string name = 1;
+}
+
+// Enqueues the given DDL statements to be applied, in order but not
+// necessarily all at once, to the database schema at some point (or
+// points) in the future. The server checks that the statements
+// are executable (syntactically valid, name tables that exist, etc.)
+// before enqueueing them, but they may still fail upon
+// later execution (e.g., if a statement from another batch of
+// statements is applied first and it conflicts in some way, or if
+// there is some data-related problem like a `NULL` value in a column to
+// which `NOT NULL` would be added). If a statement fails, all
+// subsequent statements in the batch are automatically cancelled.
+//
+// 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.
+message UpdateDatabaseDdlRequest {
+  // Required. The database to update.
+  string database = 1;
+
+  // DDL statements to be applied to the database.
+  repeated string statements = 2;
+
+  // If empty, the new update request is assigned an
+  // automatically-generated operation ID. Otherwise, `operation_id`
+  // is used to construct the name of the resulting
+  // [Operation][google.longrunning.Operation].
+  //
+  // 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
+  // [name][google.longrunning.Operation.name] of the resulting
+  // [longrunning.Operation][google.longrunning.Operation]: `<database>/operations/<operation_id>`.
+  //
+  // `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`.
+  string operation_id = 3;
+}
+
+// Metadata type for the operation returned by
+// [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl].
+message UpdateDatabaseDdlMetadata {
+  // The database being modified.
+  string database = 1;
+
+  // For an update this list contains all the statements. For an
+  // individual statement, this list contains only that statement.
+  repeated string statements = 2;
+
+  // Reports the commit timestamps of all statements that have
+  // succeeded so far, where `commit_timestamps[i]` is the commit
+  // timestamp for the statement `statements[i]`.
+  repeated google.protobuf.Timestamp commit_timestamps = 3;
+}
+
+// The request for [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
+message DropDatabaseRequest {
+  // Required. The database to be dropped.
+  string database = 1;
+}
+
+// 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;
+}
+
+// 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;
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/spanner_instance_admin.proto b/spanner/google/cloud/spanner_v1/proto/spanner_instance_admin.proto
new file mode 100644
index 000000000000..e960e5428e3a
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/spanner_instance_admin.proto
@@ -0,0 +1,475 @@
+// 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.spanner.admin.instance.v1;
+
+import "google/api/annotations.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/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.Admin.Instance.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance";
+option java_multiple_files = true;
+option java_outer_classname = "SpannerInstanceAdminProto";
+option java_package = "com.google.spanner.admin.instance.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Instance\\V1";
+
+
+// Cloud Spanner Instance Admin API
+//
+// The Cloud Spanner Instance Admin API can be used to create, delete,
+// modify and list instances. Instances are dedicated Cloud Spanner serving
+// and storage resources to be used by Cloud Spanner databases.
+//
+// Each instance has a "configuration", which dictates where the
+// serving resources for the Cloud Spanner instance are located (e.g.,
+// US-central, Europe). Configurations are created by Google based on
+// resource availability.
+//
+// Cloud Spanner billing is based on the instances that exist and their
+// sizes. After an instance exists, there are no additional
+// per-database or per-operation charges for use of the instance
+// (though there may be additional network bandwidth charges).
+// Instances offer isolation: problems with databases in one instance
+// will not affect other instances. However, within an instance
+// databases can affect each other. For example, if one database in an
+// instance receives a lot of requests and consumes most of the
+// instance resources, fewer resources are available for other
+// databases in that instance, and their performance may suffer.
+service InstanceAdmin {
+  // Lists the supported instance configurations for a given project.
+  rpc ListInstanceConfigs(ListInstanceConfigsRequest) returns (ListInstanceConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/instanceConfigs"
+    };
+  }
+
+  // Gets information about a particular instance configuration.
+  rpc GetInstanceConfig(GetInstanceConfigRequest) returns (InstanceConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instanceConfigs/*}"
+    };
+  }
+
+  // Lists all instances in the given project.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/instances"
+    };
+  }
+
+  // Gets information about a particular instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Creates an instance and begins preparing it to begin serving. The
+  // returned [long-running operation][google.longrunning.Operation]
+  // can be used to track the progress of preparing the new
+  // instance. The instance name is assigned by the caller. If the
+  // named instance already exists, `CreateInstance` returns
+  // `ALREADY_EXISTS`.
+  //
+  // Immediately upon completion of this request:
+  //
+  //   * The instance is readable via the API, with all requested attributes
+  //     but no allocated resources. Its state is `CREATING`.
+  //
+  // Until completion of the returned operation:
+  //
+  //   * Cancelling the operation renders the instance immediately unreadable
+  //     via the API.
+  //   * The instance can be deleted.
+  //   * All other attempts to modify the instance are rejected.
+  //
+  // Upon completion of the returned operation:
+  //
+  //   * Billing for all successfully-allocated resources begins (some types
+  //     may have lower than the requested levels).
+  //   * Databases can be created in the instance.
+  //   * The instance's allocated resource levels are readable via the API.
+  //   * The instance's state becomes `READY`.
+  //
+  // The returned [long-running operation][google.longrunning.Operation] will
+  // have a name of the format `<instance_name>/operations/<operation_id>` and
+  // can be used to track creation of the instance.  The
+  // [metadata][google.longrunning.Operation.metadata] field type is
+  // [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) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/instances"
+      body: "*"
+    };
+  }
+
+  // Updates an instance, and begins allocating or releasing resources
+  // as requested. The returned [long-running
+  // operation][google.longrunning.Operation] can be used to track the
+  // progress of updating the instance. If the named instance does not
+  // exist, returns `NOT_FOUND`.
+  //
+  // Immediately upon completion of this request:
+  //
+  //   * For resource types for which a decrease in the instance's allocation
+  //     has been requested, billing is based on the newly-requested level.
+  //
+  // 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,
+  //     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
+  //     resource levels.
+  //
+  // Upon completion of the returned operation:
+  //
+  //   * Billing begins for all successfully-allocated resources (some types
+  //     may have lower than the requested levels).
+  //   * All newly-reserved resources are available for serving the instance's
+  //     tables.
+  //   * The instance's new resource levels are readable via the API.
+  //
+  // The returned [long-running operation][google.longrunning.Operation] will
+  // have a name of the format `<instance_name>/operations/<operation_id>` and
+  // can be used to track the instance modification.  The
+  // [metadata][google.longrunning.Operation.metadata] field type is
+  // [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata].
+  // The [response][google.longrunning.Operation.response] field type is
+  // [Instance][google.spanner.admin.instance.v1.Instance], if successful.
+  //
+  // Authorization requires `spanner.instances.update` permission on
+  // resource [name][google.spanner.admin.instance.v1.Instance.name].
+  rpc UpdateInstance(UpdateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/{instance.name=projects/*/instances/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes an instance.
+  //
+  // Immediately upon completion of the request:
+  //
+  //   * Billing ceases for all of the instance's reserved resources.
+  //
+  // Soon afterward:
+  //
+  //   * The instance and *all of its databases* immediately and
+  //     irrevocably disappear from the API. All data in the databases
+  //     is permanently deleted.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/instances/*}"
+    };
+  }
+
+  // Sets the access control policy on an instance resource. Replaces any
+  // existing policy.
+  //
+  // Authorization requires `spanner.instances.setIamPolicy` 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/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the access control policy for an instance resource. Returns an empty
+  // policy if an instance exists but does not have a policy set.
+  //
+  // Authorization requires `spanner.instances.getIamPolicy` 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/*}:getIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Returns permissions that the caller has on the specified instance resource.
+  //
+  // Attempting this RPC on a non-existent Cloud Spanner instance resource will
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/instances/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// A possible configuration for a Cloud Spanner instance. Configurations
+// define the geographic placement of nodes and their replication.
+message InstanceConfig {
+  // A unique identifier for the instance configuration.  Values
+  // are of the form
+  // `projects/<project>/instanceConfigs/[a-z][-a-z0-9]*`
+  string name = 1;
+
+  // The name of this instance configuration as it appears in UIs.
+  string display_name = 2;
+}
+
+// An isolated set of Cloud Spanner resources on which databases can be hosted.
+message Instance {
+  // Indicates the current state of the instance.
+  enum State {
+    // Not specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The instance is still being created. Resources may not be
+    // available yet, and operations such as database creation may not
+    // work.
+    CREATING = 1;
+
+    // The instance is fully created and ready to do work such as
+    // creating databases.
+    READY = 2;
+  }
+
+  // Required. A unique identifier for the instance, which cannot be changed
+  // after the instance is created. Values are of the form
+  // `projects/<project>/instances/[a-z][-a-z0-9]*[a-z0-9]`. The final
+  // segment of the name must be between 6 and 30 characters in length.
+  string name = 1;
+
+  // Required. The name of the instance's configuration. Values are of the form
+  // `projects/<project>/instanceConfigs/<configuration>`. See
+  // also [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig] and
+  // [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
+  string config = 2;
+
+  // 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.
+  string display_name = 3;
+
+  // Required. The number of nodes allocated to this instance. This may be zero
+  // in API responses for instances that are not yet in state `READY`.
+  //
+  // See [the documentation](https://cloud.google.com/spanner/docs/instances#node_count)
+  // for more information about nodes.
+  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`.
+  State state = 6;
+
+  // Cloud Labels are a flexible and lightweight mechanism for organizing cloud
+  // resources into groups that reflect a customer's organizational needs and
+  // deployment strategies. Cloud Labels can be used to filter collections of
+  // resources. They can be used to control how resource metrics are aggregated.
+  // And they can be used as arguments to policy management rules (e.g. route,
+  // firewall, load balancing, etc.).
+  //
+  //  * 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 64 labels can be associated with a given resource.
+  //
+  // See https://goo.gl/xmQnxf for more information on and examples of labels.
+  //
+  // If you plan to use labels in your own code, please note that additional
+  // characters may be allowed in the future. And so you are advised to use an
+  // internal label representation, such as JSON, which doesn't rely upon
+  // specific characters being disallowed.  For example, representing labels
+  // as the string:  name + "_" + value  would prove problematic if we were to
+  // allow "_" in a future release.
+  map<string, string> labels = 7;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // Number of instance configurations 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.ListInstanceConfigsResponse.next_page_token]
+  // 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].
+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.
+  string next_page_token = 2;
+}
+
+// The request for
+// [GetInstanceConfigRequest][google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig].
+message GetInstanceConfigRequest {
+  // Required. The name of the requested instance configuration. Values are of
+  // the form `projects/<project>/instanceConfigs/<config>`.
+  string name = 1;
+}
+
+// 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/<project>/instances/<instance>`.
+  string name = 1;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // 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
+  // length.
+  string instance_id = 2;
+
+  // Required. The instance to create.  The name may be omitted, but if
+  // specified must be `<parent>/instances/<instance_id>`.
+  Instance instance = 3;
+}
+
+// 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/<project>`.
+  string parent = 1;
+
+  // 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].
+  string page_token = 3;
+
+  // An expression for filtering the results of the request. Filter rules are
+  // case insensitive. The fields eligible for filtering are:
+  //
+  //   * `name`
+  //   * `display_name`
+  //   * `labels.key` where key is the name of a label
+  //
+  // Some examples of using filters are:
+  //
+  //   * `name:*` --> The instance has a name.
+  //   * `name:Howl` --> The instance's name contains the string "howl".
+  //   * `name:HOWL` --> Equivalent to above.
+  //   * `NAME:howl` --> Equivalent to above.
+  //   * `labels.env:*` --> The instance has the label "env".
+  //   * `labels.env:dev` --> The instance has the label "env" and the value of
+  //                        the label contains the string "dev".
+  //   * `name:howl labels.env:dev` --> The instance's name contains "howl" and
+  //                                  it has the label "env" with its value
+  //                                  containing "dev".
+  string filter = 4;
+}
+
+// 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.
+  string next_page_token = 2;
+}
+
+// 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;
+}
+
+// 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/<project>/instances/<instance>`
+  string name = 1;
+}
+
+// Metadata type for the operation returned by
+// [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance].
+message CreateInstanceMetadata {
+  // The instance being created.
+  Instance instance = 1;
+
+  // The time at which the
+  // [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
+  // in the process of undoing itself (which is guaranteed to succeed) and
+  // cannot be cancelled again.
+  google.protobuf.Timestamp cancel_time = 3;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp end_time = 4;
+}
+
+// Metadata type for the operation returned by
+// [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
+message UpdateInstanceMetadata {
+  // The desired end state of the update.
+  Instance instance = 1;
+
+  // The time at which [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]
+  // request was received.
+  google.protobuf.Timestamp start_time = 2;
+
+  // The time at which this operation was cancelled. If set, this operation is
+  // in the process of undoing itself (which is guaranteed to succeed) and
+  // cannot be cancelled again.
+  google.protobuf.Timestamp cancel_time = 3;
+
+  // The time at which this operation failed or was completed successfully.
+  google.protobuf.Timestamp end_time = 4;
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/spanner_pb2.py b/spanner/google/cloud/spanner_v1/proto/spanner_pb2.py
new file mode 100644
index 000000000000..78a7c4b109ef
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/spanner_pb2.py
@@ -0,0 +1,3222 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/spanner.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.cloud.spanner_v1.proto import (
+    keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    mutation_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    result_set_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/spanner.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\014SpannerProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/spanner_v1/proto/spanner.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a,google/cloud/spanner_v1/proto/mutation.proto\x1a.google/cloud/spanner_v1/proto/result_set.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto"U\n\x14\x43reateSessionRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12+\n\x07session\x18\x02 \x01(\x0b\x32\x1a.google.spanner.v1.Session"{\n\x1a\x42\x61tchCreateSessionsRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x34\n\x10session_template\x18\x02 \x01(\x0b\x32\x1a.google.spanner.v1.Session\x12\x15\n\rsession_count\x18\x03 \x01(\x05"J\n\x1b\x42\x61tchCreateSessionsResponse\x12+\n\x07session\x18\x01 \x03(\x0b\x32\x1a.google.spanner.v1.Session"\xee\x01\n\x07Session\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x36\n\x06labels\x18\x02 \x03(\x0b\x32&.google.spanner.v1.Session.LabelsEntry\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12=\n\x19\x61pproximate_last_use_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"!\n\x11GetSessionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"^\n\x13ListSessionsRequest\x12\x10\n\x08\x64\x61tabase\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"]\n\x14ListSessionsResponse\x12,\n\x08sessions\x18\x01 \x03(\x0b\x32\x1a.google.spanner.v1.Session\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"$\n\x14\x44\x65leteSessionRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xe0\x03\n\x11\x45xecuteSqlRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x0b\n\x03sql\x18\x03 \x01(\t\x12\'\n\x06params\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12I\n\x0bparam_types\x18\x05 \x03(\x0b\x32\x34.google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry\x12\x14\n\x0cresume_token\x18\x06 \x01(\x0c\x12\x42\n\nquery_mode\x18\x07 \x01(\x0e\x32..google.spanner.v1.ExecuteSqlRequest.QueryMode\x12\x17\n\x0fpartition_token\x18\x08 \x01(\x0c\x12\r\n\x05seqno\x18\t \x01(\x03\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01".\n\tQueryMode\x12\n\n\x06NORMAL\x10\x00\x12\x08\n\x04PLAN\x10\x01\x12\x0b\n\x07PROFILE\x10\x02"\xa8\x03\n\x16\x45xecuteBatchDmlRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12G\n\nstatements\x18\x03 \x03(\x0b\x32\x33.google.spanner.v1.ExecuteBatchDmlRequest.Statement\x12\r\n\x05seqno\x18\x04 \x01(\x03\x1a\xe7\x01\n\tStatement\x12\x0b\n\x03sql\x18\x01 \x01(\t\x12\'\n\x06params\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12X\n\x0bparam_types\x18\x03 \x03(\x0b\x32\x43.google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"p\n\x17\x45xecuteBatchDmlResponse\x12\x31\n\x0bresult_sets\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.ResultSet\x12"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status"H\n\x10PartitionOptions\x12\x1c\n\x14partition_size_bytes\x18\x01 \x01(\x03\x12\x16\n\x0emax_partitions\x18\x02 \x01(\x03"\xf6\x02\n\x15PartitionQueryRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x0b\n\x03sql\x18\x03 \x01(\t\x12\'\n\x06params\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12M\n\x0bparam_types\x18\x05 \x03(\x0b\x32\x38.google.spanner.v1.PartitionQueryRequest.ParamTypesEntry\x12>\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xff\x01\n\x14PartitionReadRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\r\n\x05table\x18\x03 \x01(\t\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12*\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySet\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xf4\x01\n\x0bReadRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\r\n\x05table\x18\x03 \x01(\t\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12*\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySet\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"b\n\x17\x42\x65ginTransactionRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12\x36\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptions"\xc2\x01\n\rCommitRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp":\n\x0fRollbackRequest\x12\x0f\n\x07session\x18\x01 \x01(\t\x12\x16\n\x0etransaction_id\x18\x02 \x01(\x0c\x32\x90\x14\n\x07Spanner\x12\x9b\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"E\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\x12\xc7\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"Q\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\x12\x90\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"@\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\x12\xa3\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"B\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\x12\x92\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"@\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xb7\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"W\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\x12\x9c\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"M\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\x12\x97\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"O\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*B\x95\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_EXECUTESQLREQUEST_QUERYMODE = _descriptor.EnumDescriptor(
+    name="QueryMode",
+    full_name="google.spanner.v1.ExecuteSqlRequest.QueryMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="NORMAL", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PLAN", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROFILE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1668,
+    serialized_end=1714,
+)
+_sym_db.RegisterEnumDescriptor(_EXECUTESQLREQUEST_QUERYMODE)
+
+
+_CREATESESSIONREQUEST = _descriptor.Descriptor(
+    name="CreateSessionRequest",
+    full_name="google.spanner.v1.CreateSessionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.v1.CreateSessionRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.CreateSessionRequest.session",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=440,
+    serialized_end=525,
+)
+
+
+_BATCHCREATESESSIONSREQUEST = _descriptor.Descriptor(
+    name="BatchCreateSessionsRequest",
+    full_name="google.spanner.v1.BatchCreateSessionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.v1.BatchCreateSessionsRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="session_template",
+            full_name="google.spanner.v1.BatchCreateSessionsRequest.session_template",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="session_count",
+            full_name="google.spanner.v1.BatchCreateSessionsRequest.session_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=527,
+    serialized_end=650,
+)
+
+
+_BATCHCREATESESSIONSRESPONSE = _descriptor.Descriptor(
+    name="BatchCreateSessionsResponse",
+    full_name="google.spanner.v1.BatchCreateSessionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.BatchCreateSessionsResponse.session",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=652,
+    serialized_end=726,
+)
+
+
+_SESSION_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.spanner.v1.Session.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.spanner.v1.Session.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.spanner.v1.Session.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=922,
+    serialized_end=967,
+)
+
+_SESSION = _descriptor.Descriptor(
+    name="Session",
+    full_name="google.spanner.v1.Session",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.v1.Session.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.spanner.v1.Session.labels",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.spanner.v1.Session.create_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="approximate_last_use_time",
+            full_name="google.spanner.v1.Session.approximate_last_use_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SESSION_LABELSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=729,
+    serialized_end=967,
+)
+
+
+_GETSESSIONREQUEST = _descriptor.Descriptor(
+    name="GetSessionRequest",
+    full_name="google.spanner.v1.GetSessionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.v1.GetSessionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=969,
+    serialized_end=1002,
+)
+
+
+_LISTSESSIONSREQUEST = _descriptor.Descriptor(
+    name="ListSessionsRequest",
+    full_name="google.spanner.v1.ListSessionsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="database",
+            full_name="google.spanner.v1.ListSessionsRequest.database",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.spanner.v1.ListSessionsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.spanner.v1.ListSessionsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.spanner.v1.ListSessionsRequest.filter",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1004,
+    serialized_end=1098,
+)
+
+
+_LISTSESSIONSRESPONSE = _descriptor.Descriptor(
+    name="ListSessionsResponse",
+    full_name="google.spanner.v1.ListSessionsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sessions",
+            full_name="google.spanner.v1.ListSessionsResponse.sessions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.spanner.v1.ListSessionsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1100,
+    serialized_end=1193,
+)
+
+
+_DELETESESSIONREQUEST = _descriptor.Descriptor(
+    name="DeleteSessionRequest",
+    full_name="google.spanner.v1.DeleteSessionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.v1.DeleteSessionRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1195,
+    serialized_end=1231,
+)
+
+
+_EXECUTESQLREQUEST_PARAMTYPESENTRY = _descriptor.Descriptor(
+    name="ParamTypesEntry",
+    full_name="google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1592,
+    serialized_end=1666,
+)
+
+_EXECUTESQLREQUEST = _descriptor.Descriptor(
+    name="ExecuteSqlRequest",
+    full_name="google.spanner.v1.ExecuteSqlRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.ExecuteSqlRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.ExecuteSqlRequest.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sql",
+            full_name="google.spanner.v1.ExecuteSqlRequest.sql",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.spanner.v1.ExecuteSqlRequest.params",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="param_types",
+            full_name="google.spanner.v1.ExecuteSqlRequest.param_types",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.spanner.v1.ExecuteSqlRequest.resume_token",
+            index=5,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query_mode",
+            full_name="google.spanner.v1.ExecuteSqlRequest.query_mode",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partition_token",
+            full_name="google.spanner.v1.ExecuteSqlRequest.partition_token",
+            index=7,
+            number=8,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="seqno",
+            full_name="google.spanner.v1.ExecuteSqlRequest.seqno",
+            index=8,
+            number=9,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_EXECUTESQLREQUEST_PARAMTYPESENTRY],
+    enum_types=[_EXECUTESQLREQUEST_QUERYMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1234,
+    serialized_end=1714,
+)
+
+
+_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY = _descriptor.Descriptor(
+    name="ParamTypesEntry",
+    full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1592,
+    serialized_end=1666,
+)
+
+_EXECUTEBATCHDMLREQUEST_STATEMENT = _descriptor.Descriptor(
+    name="Statement",
+    full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sql",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement.sql",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement.params",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="param_types",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.Statement.param_types",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1910,
+    serialized_end=2141,
+)
+
+_EXECUTEBATCHDMLREQUEST = _descriptor.Descriptor(
+    name="ExecuteBatchDmlRequest",
+    full_name="google.spanner.v1.ExecuteBatchDmlRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="statements",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.statements",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="seqno",
+            full_name="google.spanner.v1.ExecuteBatchDmlRequest.seqno",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_EXECUTEBATCHDMLREQUEST_STATEMENT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1717,
+    serialized_end=2141,
+)
+
+
+_EXECUTEBATCHDMLRESPONSE = _descriptor.Descriptor(
+    name="ExecuteBatchDmlResponse",
+    full_name="google.spanner.v1.ExecuteBatchDmlResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="result_sets",
+            full_name="google.spanner.v1.ExecuteBatchDmlResponse.result_sets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.spanner.v1.ExecuteBatchDmlResponse.status",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2143,
+    serialized_end=2255,
+)
+
+
+_PARTITIONOPTIONS = _descriptor.Descriptor(
+    name="PartitionOptions",
+    full_name="google.spanner.v1.PartitionOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="partition_size_bytes",
+            full_name="google.spanner.v1.PartitionOptions.partition_size_bytes",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_partitions",
+            full_name="google.spanner.v1.PartitionOptions.max_partitions",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2257,
+    serialized_end=2329,
+)
+
+
+_PARTITIONQUERYREQUEST_PARAMTYPESENTRY = _descriptor.Descriptor(
+    name="ParamTypesEntry",
+    full_name="google.spanner.v1.PartitionQueryRequest.ParamTypesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.spanner.v1.PartitionQueryRequest.ParamTypesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.spanner.v1.PartitionQueryRequest.ParamTypesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1592,
+    serialized_end=1666,
+)
+
+_PARTITIONQUERYREQUEST = _descriptor.Descriptor(
+    name="PartitionQueryRequest",
+    full_name="google.spanner.v1.PartitionQueryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.PartitionQueryRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.PartitionQueryRequest.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sql",
+            full_name="google.spanner.v1.PartitionQueryRequest.sql",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="params",
+            full_name="google.spanner.v1.PartitionQueryRequest.params",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="param_types",
+            full_name="google.spanner.v1.PartitionQueryRequest.param_types",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partition_options",
+            full_name="google.spanner.v1.PartitionQueryRequest.partition_options",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PARTITIONQUERYREQUEST_PARAMTYPESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2332,
+    serialized_end=2706,
+)
+
+
+_PARTITIONREADREQUEST = _descriptor.Descriptor(
+    name="PartitionReadRequest",
+    full_name="google.spanner.v1.PartitionReadRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.PartitionReadRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.PartitionReadRequest.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.spanner.v1.PartitionReadRequest.table",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.spanner.v1.PartitionReadRequest.index",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="columns",
+            full_name="google.spanner.v1.PartitionReadRequest.columns",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_set",
+            full_name="google.spanner.v1.PartitionReadRequest.key_set",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partition_options",
+            full_name="google.spanner.v1.PartitionReadRequest.partition_options",
+            index=6,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2709,
+    serialized_end=2964,
+)
+
+
+_PARTITION = _descriptor.Descriptor(
+    name="Partition",
+    full_name="google.spanner.v1.Partition",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="partition_token",
+            full_name="google.spanner.v1.Partition.partition_token",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2966,
+    serialized_end=3002,
+)
+
+
+_PARTITIONRESPONSE = _descriptor.Descriptor(
+    name="PartitionResponse",
+    full_name="google.spanner.v1.PartitionResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="partitions",
+            full_name="google.spanner.v1.PartitionResponse.partitions",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.PartitionResponse.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3004,
+    serialized_end=3126,
+)
+
+
+_READREQUEST = _descriptor.Descriptor(
+    name="ReadRequest",
+    full_name="google.spanner.v1.ReadRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.ReadRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.ReadRequest.transaction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="table",
+            full_name="google.spanner.v1.ReadRequest.table",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index",
+            full_name="google.spanner.v1.ReadRequest.index",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="columns",
+            full_name="google.spanner.v1.ReadRequest.columns",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="key_set",
+            full_name="google.spanner.v1.ReadRequest.key_set",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="limit",
+            full_name="google.spanner.v1.ReadRequest.limit",
+            index=6,
+            number=8,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_token",
+            full_name="google.spanner.v1.ReadRequest.resume_token",
+            index=7,
+            number=9,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partition_token",
+            full_name="google.spanner.v1.ReadRequest.partition_token",
+            index=8,
+            number=10,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3129,
+    serialized_end=3373,
+)
+
+
+_BEGINTRANSACTIONREQUEST = _descriptor.Descriptor(
+    name="BeginTransactionRequest",
+    full_name="google.spanner.v1.BeginTransactionRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.BeginTransactionRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="options",
+            full_name="google.spanner.v1.BeginTransactionRequest.options",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3375,
+    serialized_end=3473,
+)
+
+
+_COMMITREQUEST = _descriptor.Descriptor(
+    name="CommitRequest",
+    full_name="google.spanner.v1.CommitRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.CommitRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction_id",
+            full_name="google.spanner.v1.CommitRequest.transaction_id",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="single_use_transaction",
+            full_name="google.spanner.v1.CommitRequest.single_use_transaction",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mutations",
+            full_name="google.spanner.v1.CommitRequest.mutations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="transaction",
+            full_name="google.spanner.v1.CommitRequest.transaction",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3476,
+    serialized_end=3670,
+)
+
+
+_COMMITRESPONSE = _descriptor.Descriptor(
+    name="CommitResponse",
+    full_name="google.spanner.v1.CommitResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="commit_timestamp",
+            full_name="google.spanner.v1.CommitResponse.commit_timestamp",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3672,
+    serialized_end=3742,
+)
+
+
+_ROLLBACKREQUEST = _descriptor.Descriptor(
+    name="RollbackRequest",
+    full_name="google.spanner.v1.RollbackRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="session",
+            full_name="google.spanner.v1.RollbackRequest.session",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="transaction_id",
+            full_name="google.spanner.v1.RollbackRequest.transaction_id",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3744,
+    serialized_end=3802,
+)
+
+_CREATESESSIONREQUEST.fields_by_name["session"].message_type = _SESSION
+_BATCHCREATESESSIONSREQUEST.fields_by_name["session_template"].message_type = _SESSION
+_BATCHCREATESESSIONSRESPONSE.fields_by_name["session"].message_type = _SESSION
+_SESSION_LABELSENTRY.containing_type = _SESSION
+_SESSION.fields_by_name["labels"].message_type = _SESSION_LABELSENTRY
+_SESSION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SESSION.fields_by_name[
+    "approximate_last_use_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTSESSIONSRESPONSE.fields_by_name["sessions"].message_type = _SESSION
+_EXECUTESQLREQUEST_PARAMTYPESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._TYPE
+_EXECUTESQLREQUEST_PARAMTYPESENTRY.containing_type = _EXECUTESQLREQUEST
+_EXECUTESQLREQUEST.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONSELECTOR
+)
+_EXECUTESQLREQUEST.fields_by_name[
+    "params"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_EXECUTESQLREQUEST.fields_by_name[
+    "param_types"
+].message_type = _EXECUTESQLREQUEST_PARAMTYPESENTRY
+_EXECUTESQLREQUEST.fields_by_name["query_mode"].enum_type = _EXECUTESQLREQUEST_QUERYMODE
+_EXECUTESQLREQUEST_QUERYMODE.containing_type = _EXECUTESQLREQUEST
+_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._TYPE
+_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY.containing_type = (
+    _EXECUTEBATCHDMLREQUEST_STATEMENT
+)
+_EXECUTEBATCHDMLREQUEST_STATEMENT.fields_by_name[
+    "params"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_EXECUTEBATCHDMLREQUEST_STATEMENT.fields_by_name[
+    "param_types"
+].message_type = _EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY
+_EXECUTEBATCHDMLREQUEST_STATEMENT.containing_type = _EXECUTEBATCHDMLREQUEST
+_EXECUTEBATCHDMLREQUEST.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONSELECTOR
+)
+_EXECUTEBATCHDMLREQUEST.fields_by_name[
+    "statements"
+].message_type = _EXECUTEBATCHDMLREQUEST_STATEMENT
+_EXECUTEBATCHDMLRESPONSE.fields_by_name[
+    "result_sets"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET
+)
+_EXECUTEBATCHDMLRESPONSE.fields_by_name[
+    "status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_PARTITIONQUERYREQUEST_PARAMTYPESENTRY.fields_by_name[
+    "value"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._TYPE
+_PARTITIONQUERYREQUEST_PARAMTYPESENTRY.containing_type = _PARTITIONQUERYREQUEST
+_PARTITIONQUERYREQUEST.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONSELECTOR
+)
+_PARTITIONQUERYREQUEST.fields_by_name[
+    "params"
+].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_PARTITIONQUERYREQUEST.fields_by_name[
+    "param_types"
+].message_type = _PARTITIONQUERYREQUEST_PARAMTYPESENTRY
+_PARTITIONQUERYREQUEST.fields_by_name[
+    "partition_options"
+].message_type = _PARTITIONOPTIONS
+_PARTITIONREADREQUEST.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONSELECTOR
+)
+_PARTITIONREADREQUEST.fields_by_name[
+    "key_set"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET
+_PARTITIONREADREQUEST.fields_by_name[
+    "partition_options"
+].message_type = _PARTITIONOPTIONS
+_PARTITIONRESPONSE.fields_by_name["partitions"].message_type = _PARTITION
+_PARTITIONRESPONSE.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION
+)
+_READREQUEST.fields_by_name[
+    "transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONSELECTOR
+)
+_READREQUEST.fields_by_name[
+    "key_set"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET
+_BEGINTRANSACTIONREQUEST.fields_by_name[
+    "options"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONOPTIONS
+)
+_COMMITREQUEST.fields_by_name[
+    "single_use_transaction"
+].message_type = (
+    google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTIONOPTIONS
+)
+_COMMITREQUEST.fields_by_name[
+    "mutations"
+].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2._MUTATION
+_COMMITREQUEST.oneofs_by_name["transaction"].fields.append(
+    _COMMITREQUEST.fields_by_name["transaction_id"]
+)
+_COMMITREQUEST.fields_by_name[
+    "transaction_id"
+].containing_oneof = _COMMITREQUEST.oneofs_by_name["transaction"]
+_COMMITREQUEST.oneofs_by_name["transaction"].fields.append(
+    _COMMITREQUEST.fields_by_name["single_use_transaction"]
+)
+_COMMITREQUEST.fields_by_name[
+    "single_use_transaction"
+].containing_oneof = _COMMITREQUEST.oneofs_by_name["transaction"]
+_COMMITRESPONSE.fields_by_name[
+    "commit_timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name["CreateSessionRequest"] = _CREATESESSIONREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchCreateSessionsRequest"
+] = _BATCHCREATESESSIONSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchCreateSessionsResponse"
+] = _BATCHCREATESESSIONSRESPONSE
+DESCRIPTOR.message_types_by_name["Session"] = _SESSION
+DESCRIPTOR.message_types_by_name["GetSessionRequest"] = _GETSESSIONREQUEST
+DESCRIPTOR.message_types_by_name["ListSessionsRequest"] = _LISTSESSIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListSessionsResponse"] = _LISTSESSIONSRESPONSE
+DESCRIPTOR.message_types_by_name["DeleteSessionRequest"] = _DELETESESSIONREQUEST
+DESCRIPTOR.message_types_by_name["ExecuteSqlRequest"] = _EXECUTESQLREQUEST
+DESCRIPTOR.message_types_by_name["ExecuteBatchDmlRequest"] = _EXECUTEBATCHDMLREQUEST
+DESCRIPTOR.message_types_by_name["ExecuteBatchDmlResponse"] = _EXECUTEBATCHDMLRESPONSE
+DESCRIPTOR.message_types_by_name["PartitionOptions"] = _PARTITIONOPTIONS
+DESCRIPTOR.message_types_by_name["PartitionQueryRequest"] = _PARTITIONQUERYREQUEST
+DESCRIPTOR.message_types_by_name["PartitionReadRequest"] = _PARTITIONREADREQUEST
+DESCRIPTOR.message_types_by_name["Partition"] = _PARTITION
+DESCRIPTOR.message_types_by_name["PartitionResponse"] = _PARTITIONRESPONSE
+DESCRIPTOR.message_types_by_name["ReadRequest"] = _READREQUEST
+DESCRIPTOR.message_types_by_name["BeginTransactionRequest"] = _BEGINTRANSACTIONREQUEST
+DESCRIPTOR.message_types_by_name["CommitRequest"] = _COMMITREQUEST
+DESCRIPTOR.message_types_by_name["CommitResponse"] = _COMMITRESPONSE
+DESCRIPTOR.message_types_by_name["RollbackRequest"] = _ROLLBACKREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateSessionRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateSessionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESESSIONREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for
+  [CreateSession][google.spanner.v1.Spanner.CreateSession].
+  
+  
+  Attributes:
+      database:
+          Required. The database in which the new session is created.
+      session:
+          The session to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.CreateSessionRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateSessionRequest)
+
+BatchCreateSessionsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateSessionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATESESSIONSREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for
+  [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
+  
+  
+  Attributes:
+      database:
+          Required. The database in which the new sessions are created.
+      session_template:
+          Parameters to be applied to each created session.
+      session_count:
+          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.BatchCreateSessi
+          onsRequest.session\_count] as necessary).
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.BatchCreateSessionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateSessionsRequest)
+
+BatchCreateSessionsResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateSessionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATESESSIONSRESPONSE,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The response for
+  [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
+  
+  
+  Attributes:
+      session:
+          The freshly created sessions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.BatchCreateSessionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateSessionsResponse)
+
+Session = _reflection.GeneratedProtocolMessageType(
+    "Session",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SESSION_LABELSENTRY,
+                __module__="google.cloud.spanner_v1.proto.spanner_pb2"
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.Session.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_SESSION,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""A session in the Cloud Spanner API.
+  
+  
+  Attributes:
+      name:
+          The name of the session. This is always system-assigned;
+          values provided when creating a session are ignored.
+      labels:
+          The labels for the session.  -  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 64 labels
+          can be associated with a given session.  See
+          https://goo.gl/xmQnxf for more information on and examples of
+          labels.
+      create_time:
+          Output only. The timestamp when the session is created.
+      approximate_last_use_time:
+          Output only. The approximate timestamp when the session is
+          last used. It is typically earlier than the actual last use
+          time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.Session)
+    ),
+)
+_sym_db.RegisterMessage(Session)
+_sym_db.RegisterMessage(Session.LabelsEntry)
+
+GetSessionRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSessionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSESSIONREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [GetSession][google.spanner.v1.Spanner.GetSession].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the session to retrieve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.GetSessionRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSessionRequest)
+
+ListSessionsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListSessionsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSESSIONSREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [ListSessions][google.spanner.v1.Spanner.ListSessions].
+  
+  
+  Attributes:
+      database:
+          Required. The database in which to list sessions.
+      page_size:
+          Number of sessions to be returned in the response. If 0 or
+          less, defaults to the server's maximum allowed page size.
+      page_token:
+          If non-empty, ``page_token`` should contain a [next\_page\_tok
+          en][google.spanner.v1.ListSessionsResponse.next\_page\_token]
+          from a previous [ListSessionsResponse][google.spanner.v1.ListS
+          essionsResponse].
+      filter:
+          An expression for filtering the results of the request. Filter
+          rules are case insensitive. The fields eligible for filtering
+          are:  -  ``labels.key`` where key is the name of a label  Some
+          examples of using filters are:  -  ``labels.env:*`` --> The
+          session has the label "env". -  ``labels.env:dev`` --> The
+          session has the label "env" and the value    of the label
+          contains the string "dev".
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ListSessionsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListSessionsRequest)
+
+ListSessionsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListSessionsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSESSIONSRESPONSE,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The response for [ListSessions][google.spanner.v1.Spanner.ListSessions].
+  
+  
+  Attributes:
+      sessions:
+          The list of requested sessions.
+      next_page_token:
+          ``next_page_token`` can be sent in a subsequent
+          [ListSessions][google.spanner.v1.Spanner.ListSessions] call to
+          fetch more of the matching sessions.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ListSessionsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListSessionsResponse)
+
+DeleteSessionRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteSessionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESESSIONREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for
+  [DeleteSession][google.spanner.v1.Spanner.DeleteSession].
+  
+  
+  Attributes:
+      name:
+          Required. The name of the session to delete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.DeleteSessionRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteSessionRequest)
+
+ExecuteSqlRequest = _reflection.GeneratedProtocolMessageType(
+    "ExecuteSqlRequest",
+    (_message.Message,),
+    dict(
+        ParamTypesEntry=_reflection.GeneratedProtocolMessageType(
+            "ParamTypesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_EXECUTESQLREQUEST_PARAMTYPESENTRY,
+                __module__="google.cloud.spanner_v1.proto.spanner_pb2"
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry)
+            ),
+        ),
+        DESCRIPTOR=_EXECUTESQLREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+  [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql].
+  
+  
+  Attributes:
+      session:
+          Required. The session in which the SQL query should be
+          performed.
+      transaction:
+          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.  Partitioned DML
+          requires an existing PartitionedDml transaction ID.
+      sql:
+          Required. The SQL string.
+      params:
+          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.  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.  Parameter values are specified using
+          ``params``, which is a JSON object whose keys are parameter
+          names, and whose values are the corresponding parameter
+          values.
+      param_types:
+          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.  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 definition of
+          [Type][google.spanner.v1.Type] for more information about SQL
+          types.
+      resume_token:
+          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.
+      query_mode:
+          Used to control the amount of debugging information returned
+          in [ResultSetStats][google.spanner.v1.ResultSetStats]. If [par
+          tition\_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.Execut
+          eSqlRequest.QueryMode.NORMAL].
+      partition_token:
+          If present, results will be restricted to the specified
+          partition previously created using PartitionQuery(). There
+          must be an exact match for the values of fields common to this
+          message and the PartitionQueryRequest message used to create
+          this partition\_token.
+      seqno:
+          A per-transaction sequence number used to identify this
+          request. This 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.  Required for DML
+          statements. Ignored for queries.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExecuteSqlRequest)
+_sym_db.RegisterMessage(ExecuteSqlRequest.ParamTypesEntry)
+
+ExecuteBatchDmlRequest = _reflection.GeneratedProtocolMessageType(
+    "ExecuteBatchDmlRequest",
+    (_message.Message,),
+    dict(
+        Statement=_reflection.GeneratedProtocolMessageType(
+            "Statement",
+            (_message.Message,),
+            dict(
+                ParamTypesEntry=_reflection.GeneratedProtocolMessageType(
+                    "ParamTypesEntry",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY,
+                        __module__="google.cloud.spanner_v1.proto.spanner_pb2"
+                        # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry)
+                    ),
+                ),
+                DESCRIPTOR=_EXECUTEBATCHDMLREQUEST_STATEMENT,
+                __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+                __doc__="""A single DML statement.
+    
+    
+    Attributes:
+        sql:
+            Required. The DML string.
+        params:
+            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.  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.  Parameter values are specified using
+            ``params``, which is a JSON object whose keys are parameter
+            names, and whose values are the corresponding parameter
+            values.
+        param_types:
+            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.ExecuteBatchDmlRequest.Statement.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 definition of
+            [Type][google.spanner.v1.Type] for more information about SQL
+            types.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest.Statement)
+            ),
+        ),
+        DESCRIPTOR=_EXECUTEBATCHDMLREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for
+  [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]
+  
+  
+  Attributes:
+      session:
+          Required. The session in which the DML statements should be
+          performed.
+      transaction:
+          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.
+      statements:
+          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.  REQUIRES:
+          statements\_size() > 0.
+      seqno:
+          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].
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest)
+    ),
+)
+_sym_db.RegisterMessage(ExecuteBatchDmlRequest)
+_sym_db.RegisterMessage(ExecuteBatchDmlRequest.Statement)
+_sym_db.RegisterMessage(ExecuteBatchDmlRequest.Statement.ParamTypesEntry)
+
+ExecuteBatchDmlResponse = _reflection.GeneratedProtocolMessageType(
+    "ExecuteBatchDmlResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXECUTEBATCHDMLRESPONSE,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""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:
+  
+  1. Check if 'status' field is OkStatus.
+  2. Check if result\_sets\_size() equals the number of statements in
+     [ExecuteBatchDmlRequest][Spanner.ExecuteBatchDmlRequest].
+  
+  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: 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.
+  
+  
+  Attributes:
+      result_sets:
+          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.  Only the first
+          ResultSet in the response contains a valid
+          [ResultSetMetadata][google.spanner.v1.ResultSetMetadata].
+      status:
+          If all DML statements are executed successfully, status will
+          be OK. Otherwise, the error status of the first failed
+          statement.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlResponse)
+    ),
+)
+_sym_db.RegisterMessage(ExecuteBatchDmlResponse)
+
+PartitionOptions = _reflection.GeneratedProtocolMessageType(
+    "PartitionOptions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTITIONOPTIONS,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""Options for a PartitionQueryRequest and PartitionReadRequest.
+  
+  
+  Attributes:
+      partition_size_bytes:
+          **Note:** This hint is currently ignored by PartitionQuery and
+          PartitionRead requests.  The desired data size for each
+          partition generated. The default for this option is currently
+          1 GiB. This is only a hint. The actual size of each partition
+          may be smaller or larger than this size request.
+      max_partitions:
+          **Note:** This hint is currently ignored by PartitionQuery and
+          PartitionRead requests.  The desired maximum number of
+          partitions to return. For example, this may be set to the
+          number of workers available. The default for this option is
+          currently 10,000. The maximum value is currently 200,000. This
+          is only a hint. The actual number of partitions returned may
+          be smaller or larger than this maximum count request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionOptions)
+    ),
+)
+_sym_db.RegisterMessage(PartitionOptions)
+
+PartitionQueryRequest = _reflection.GeneratedProtocolMessageType(
+    "PartitionQueryRequest",
+    (_message.Message,),
+    dict(
+        ParamTypesEntry=_reflection.GeneratedProtocolMessageType(
+            "ParamTypesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PARTITIONQUERYREQUEST_PARAMTYPESENTRY,
+                __module__="google.cloud.spanner_v1.proto.spanner_pb2"
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionQueryRequest.ParamTypesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PARTITIONQUERYREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for
+  [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery]
+  
+  
+  Attributes:
+      session:
+          Required. The session used to create the partitions.
+      transaction:
+          Read only snapshot transactions are supported, read/write and
+          single use transactions are not.
+      sql:
+          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 splits, remotely evaluates a
+          subquery independently on each split, and 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 PartitionedDml
+          transaction for large, partition-friendly DML operations.
+      params:
+          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.  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.  Parameter values are
+          specified using ``params``, which is a JSON object whose keys
+          are parameter names, and whose values are the corresponding
+          parameter values.
+      param_types:
+          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.  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 definition of
+          [Type][google.spanner.v1.Type] for more information about SQL
+          types.
+      partition_options:
+          Additional options that affect how many partitions are
+          created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionQueryRequest)
+    ),
+)
+_sym_db.RegisterMessage(PartitionQueryRequest)
+_sym_db.RegisterMessage(PartitionQueryRequest.ParamTypesEntry)
+
+PartitionReadRequest = _reflection.GeneratedProtocolMessageType(
+    "PartitionReadRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTITIONREADREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [PartitionRead][google.spanner.v1.Spanner.PartitionRead]
+  
+  
+  Attributes:
+      session:
+          Required. The session used to create the partitions.
+      transaction:
+          Read only snapshot transactions are supported, read/write and
+          single use transactions are not.
+      table:
+          Required. The name of the table in the database to be read.
+      index:
+          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.
+      columns:
+          The columns of
+          [table][google.spanner.v1.PartitionReadRequest.table] to be
+          returned for each row matching this request.
+      key_set:
+          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 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.
+      partition_options:
+          Additional options that affect how many partitions are
+          created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionReadRequest)
+    ),
+)
+_sym_db.RegisterMessage(PartitionReadRequest)
+
+Partition = _reflection.GeneratedProtocolMessageType(
+    "Partition",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTITION,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""Information returned for each partition returned in a PartitionResponse.
+  
+  
+  Attributes:
+      partition_token:
+          This token can be passed to Read, StreamingRead, ExecuteSql,
+          or ExecuteStreamingSql requests to restrict the results to
+          those identified by this partition token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.Partition)
+    ),
+)
+_sym_db.RegisterMessage(Partition)
+
+PartitionResponse = _reflection.GeneratedProtocolMessageType(
+    "PartitionResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARTITIONRESPONSE,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The response for
+  [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery] or
+  [PartitionRead][google.spanner.v1.Spanner.PartitionRead]
+  
+  
+  Attributes:
+      partitions:
+          Partitions created by this request.
+      transaction:
+          Transaction created by this request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionResponse)
+    ),
+)
+_sym_db.RegisterMessage(PartitionResponse)
+
+ReadRequest = _reflection.GeneratedProtocolMessageType(
+    "ReadRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_READREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [Read][google.spanner.v1.Spanner.Read] and
+  [StreamingRead][google.spanner.v1.Spanner.StreamingRead].
+  
+  
+  Attributes:
+      session:
+          Required. The session in which the read should be performed.
+      transaction:
+          The transaction to use. If none is provided, the default is a
+          temporary read-only transaction with strong concurrency.
+      table:
+          Required. The name of the table in the database to be read.
+      index:
+          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.
+      columns:
+          The columns of [table][google.spanner.v1.ReadRequest.table] to
+          be returned for each row matching this request.
+      key_set:
+          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 [partiti
+          on\_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.
+      limit:
+          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 ``partition_token`` is set.
+      resume_token:
+          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 that yielded this
+          token.
+      partition_token:
+          If present, results will be restricted to the specified
+          partition previously created using PartitionRead(). There must
+          be an exact match for the values of fields common to this
+          message and the PartitionReadRequest message used to create
+          this partition\_token.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.ReadRequest)
+    ),
+)
+_sym_db.RegisterMessage(ReadRequest)
+
+BeginTransactionRequest = _reflection.GeneratedProtocolMessageType(
+    "BeginTransactionRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BEGINTRANSACTIONREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for
+  [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction].
+  
+  
+  Attributes:
+      session:
+          Required. The session in which the transaction runs.
+      options:
+          Required. Options for the new transaction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.BeginTransactionRequest)
+    ),
+)
+_sym_db.RegisterMessage(BeginTransactionRequest)
+
+CommitRequest = _reflection.GeneratedProtocolMessageType(
+    "CommitRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [Commit][google.spanner.v1.Spanner.Commit].
+  
+  
+  Attributes:
+      session:
+          Required. The session in which the transaction to be committed
+          is running.
+      transaction:
+          Required. The transaction in which to commit.
+      transaction_id:
+          Commit a previously-started transaction.
+      single_use_transaction:
+          Execute mutations in a temporary transaction. Note that unlike
+          commit of a previously-started transaction, commit with a
+          temporary transaction is non-idempotent. That is, if the
+          ``CommitRequest`` is sent to Cloud Spanner more than once (for
+          instance, due to retries in the application, or in the
+          transport library), it is possible that the mutations are
+          executed more than once. If this is undesirable, use
+          [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction]
+          and [Commit][google.spanner.v1.Spanner.Commit] instead.
+      mutations:
+          The mutations to be executed when this transaction commits.
+          All mutations are applied atomically, in the order they appear
+          in this list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.CommitRequest)
+    ),
+)
+_sym_db.RegisterMessage(CommitRequest)
+
+CommitResponse = _reflection.GeneratedProtocolMessageType(
+    "CommitResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMITRESPONSE,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The response for [Commit][google.spanner.v1.Spanner.Commit].
+  
+  
+  Attributes:
+      commit_timestamp:
+          The Cloud Spanner timestamp at which the transaction
+          committed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.CommitResponse)
+    ),
+)
+_sym_db.RegisterMessage(CommitResponse)
+
+RollbackRequest = _reflection.GeneratedProtocolMessageType(
+    "RollbackRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ROLLBACKREQUEST,
+        __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+        __doc__="""The request for [Rollback][google.spanner.v1.Spanner.Rollback].
+  
+  
+  Attributes:
+      session:
+          Required. The session in which the transaction to roll back is
+          running.
+      transaction_id:
+          Required. The transaction to roll back.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.RollbackRequest)
+    ),
+)
+_sym_db.RegisterMessage(RollbackRequest)
+
+
+DESCRIPTOR._options = None
+_SESSION_LABELSENTRY._options = None
+_EXECUTESQLREQUEST_PARAMTYPESENTRY._options = None
+_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY._options = None
+_PARTITIONQUERYREQUEST_PARAMTYPESENTRY._options = None
+
+_SPANNER = _descriptor.ServiceDescriptor(
+    name="Spanner",
+    full_name="google.spanner.v1.Spanner",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=3805,
+    serialized_end=6381,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateSession",
+            full_name="google.spanner.v1.Spanner.CreateSession",
+            index=0,
+            containing_service=None,
+            input_type=_CREATESESSIONREQUEST,
+            output_type=_SESSION,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchCreateSessions",
+            full_name="google.spanner.v1.Spanner.BatchCreateSessions",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHCREATESESSIONSREQUEST,
+            output_type=_BATCHCREATESESSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSession",
+            full_name="google.spanner.v1.Spanner.GetSession",
+            index=2,
+            containing_service=None,
+            input_type=_GETSESSIONREQUEST,
+            output_type=_SESSION,
+            serialized_options=_b(
+                "\202\323\344\223\002:\0228/v1/{name=projects/*/instances/*/databases/*/sessions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListSessions",
+            full_name="google.spanner.v1.Spanner.ListSessions",
+            index=3,
+            containing_service=None,
+            input_type=_LISTSESSIONSREQUEST,
+            output_type=_LISTSESSIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002<\022:/v1/{database=projects/*/instances/*/databases/*}/sessions"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteSession",
+            full_name="google.spanner.v1.Spanner.DeleteSession",
+            index=4,
+            containing_service=None,
+            input_type=_DELETESESSIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExecuteSql",
+            full_name="google.spanner.v1.Spanner.ExecuteSql",
+            index=5,
+            containing_service=None,
+            input_type=_EXECUTESQLREQUEST,
+            output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExecuteStreamingSql",
+            full_name="google.spanner.v1.Spanner.ExecuteStreamingSql",
+            index=6,
+            containing_service=None,
+            input_type=_EXECUTESQLREQUEST,
+            output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._PARTIALRESULTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ExecuteBatchDml",
+            full_name="google.spanner.v1.Spanner.ExecuteBatchDml",
+            index=7,
+            containing_service=None,
+            input_type=_EXECUTEBATCHDMLREQUEST,
+            output_type=_EXECUTEBATCHDMLRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Read",
+            full_name="google.spanner.v1.Spanner.Read",
+            index=8,
+            containing_service=None,
+            input_type=_READREQUEST,
+            output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StreamingRead",
+            full_name="google.spanner.v1.Spanner.StreamingRead",
+            index=9,
+            containing_service=None,
+            input_type=_READREQUEST,
+            output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._PARTIALRESULTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BeginTransaction",
+            full_name="google.spanner.v1.Spanner.BeginTransaction",
+            index=10,
+            containing_service=None,
+            input_type=_BEGINTRANSACTIONREQUEST,
+            output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION,
+            serialized_options=_b(
+                '\202\323\344\223\002Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Commit",
+            full_name="google.spanner.v1.Spanner.Commit",
+            index=11,
+            containing_service=None,
+            input_type=_COMMITREQUEST,
+            output_type=_COMMITRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="Rollback",
+            full_name="google.spanner.v1.Spanner.Rollback",
+            index=12,
+            containing_service=None,
+            input_type=_ROLLBACKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PartitionQuery",
+            full_name="google.spanner.v1.Spanner.PartitionQuery",
+            index=13,
+            containing_service=None,
+            input_type=_PARTITIONQUERYREQUEST,
+            output_type=_PARTITIONRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PartitionRead",
+            full_name="google.spanner.v1.Spanner.PartitionRead",
+            index=14,
+            containing_service=None,
+            input_type=_PARTITIONREADREQUEST,
+            output_type=_PARTITIONRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_SPANNER)
+
+DESCRIPTOR.services_by_name["Spanner"] = _SPANNER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py
new file mode 100644
index 000000000000..b99970b34b15
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py
@@ -0,0 +1,420 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.spanner_v1.proto import (
+    result_set_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    spanner_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2,
+)
+from google.cloud.spanner_v1.proto import (
+    transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class SpannerStub(object):
+    """Cloud Spanner API
+
+  The Cloud Spanner API can be used to manage sessions and execute
+  transactions on data stored in Cloud Spanner databases.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateSession = channel.unary_unary(
+            "/google.spanner.v1.Spanner/CreateSession",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.CreateSessionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.Session.FromString,
+        )
+        self.BatchCreateSessions = channel.unary_unary(
+            "/google.spanner.v1.Spanner/BatchCreateSessions",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.BatchCreateSessionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.BatchCreateSessionsResponse.FromString,
+        )
+        self.GetSession = channel.unary_unary(
+            "/google.spanner.v1.Spanner/GetSession",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.GetSessionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.Session.FromString,
+        )
+        self.ListSessions = channel.unary_unary(
+            "/google.spanner.v1.Spanner/ListSessions",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ListSessionsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ListSessionsResponse.FromString,
+        )
+        self.DeleteSession = channel.unary_unary(
+            "/google.spanner.v1.Spanner/DeleteSession",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.DeleteSessionRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ExecuteSql = channel.unary_unary(
+            "/google.spanner.v1.Spanner/ExecuteSql",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteSqlRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.ResultSet.FromString,
+        )
+        self.ExecuteStreamingSql = channel.unary_stream(
+            "/google.spanner.v1.Spanner/ExecuteStreamingSql",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteSqlRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.PartialResultSet.FromString,
+        )
+        self.ExecuteBatchDml = channel.unary_unary(
+            "/google.spanner.v1.Spanner/ExecuteBatchDml",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteBatchDmlRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteBatchDmlResponse.FromString,
+        )
+        self.Read = channel.unary_unary(
+            "/google.spanner.v1.Spanner/Read",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ReadRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.ResultSet.FromString,
+        )
+        self.StreamingRead = channel.unary_stream(
+            "/google.spanner.v1.Spanner/StreamingRead",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ReadRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.PartialResultSet.FromString,
+        )
+        self.BeginTransaction = channel.unary_unary(
+            "/google.spanner.v1.Spanner/BeginTransaction",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.BeginTransactionRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.Transaction.FromString,
+        )
+        self.Commit = channel.unary_unary(
+            "/google.spanner.v1.Spanner/Commit",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.CommitRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.CommitResponse.FromString,
+        )
+        self.Rollback = channel.unary_unary(
+            "/google.spanner.v1.Spanner/Rollback",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.RollbackRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.PartitionQuery = channel.unary_unary(
+            "/google.spanner.v1.Spanner/PartitionQuery",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionQueryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionResponse.FromString,
+        )
+        self.PartitionRead = channel.unary_unary(
+            "/google.spanner.v1.Spanner/PartitionRead",
+            request_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionReadRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionResponse.FromString,
+        )
+
+
+class SpannerServicer(object):
+    """Cloud Spanner API
+
+  The Cloud Spanner API can be used to manage sessions and execute
+  transactions on data stored in Cloud Spanner databases.
+  """
+
+    def CreateSession(self, request, context):
+        """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
+    transactions.
+
+    Sessions can only execute one transaction at a time. To execute
+    multiple concurrent read-write/write-only transactions, create
+    multiple sessions. Note that standalone reads and queries use a
+    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
+    operations are sent for more than an hour. If a session is deleted,
+    requests to it return `NOT_FOUND`.
+
+    Idle sessions can be kept alive by sending a trivial SQL query
+    periodically, e.g., `"SELECT 1"`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchCreateSessions(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSession(self, request, context):
+        """Gets a session. Returns `NOT_FOUND` if the session does not exist.
+    This is mainly useful for determining whether a session is still
+    alive.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListSessions(self, request, context):
+        """Lists all sessions in a given database.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteSession(self, request, context):
+        """Ends a session, releasing server resources associated with it. This will
+    asynchronously trigger cancellation of any operations that are running with
+    this session.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExecuteSql(self, request, context):
+        """Executes an SQL statement, returning all results in a single reply. This
+    method cannot be used to return a result set larger than 10 MiB;
+    if the query yields more data than that, the query fails with
+    a `FAILED_PRECONDITION` error.
+
+    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.
+
+    Larger result sets can be fetched in streaming fashion by calling
+    [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
+    instead.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExecuteStreamingSql(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ExecuteBatchDml(self, request, context):
+        """Executes a batch of SQL DML statements. This method allows many statements
+    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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Read(self, request, context):
+        """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
+    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.
+
+    Larger result sets can be yielded in streaming fashion by calling
+    [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StreamingRead(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BeginTransaction(self, request, context):
+        """Begins a new transaction. This step can often be skipped:
+    [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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Commit(self, request, context):
+        """Commits a transaction. The request includes the mutations to be
+    applied to rows in the database.
+
+    `Commit` might return an `ABORTED` error. This can occur at any time;
+    commonly, the cause is conflicts with concurrent
+    transactions. However, it can also happen for a variety of other
+    reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
+    the transaction from the beginning, re-using the same session.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def Rollback(self, request, context):
+        """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.
+
+    `Rollback` returns `OK` if it successfully aborts the transaction, the
+    transaction was already aborted, or the transaction is not
+    found. `Rollback` never returns `ABORTED`.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PartitionQuery(self, request, context):
+        """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.
+
+    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
+    old.  When any of these happen, it is not possible to resume the query, and
+    the whole operation must be restarted from the beginning.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PartitionRead(self, request, context):
+        """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.
+
+    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
+    old.  When any of these happen, it is not possible to resume the read, and
+    the whole operation must be restarted from the beginning.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SpannerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateSession": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSession,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.CreateSessionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.Session.SerializeToString,
+        ),
+        "BatchCreateSessions": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchCreateSessions,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.BatchCreateSessionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.BatchCreateSessionsResponse.SerializeToString,
+        ),
+        "GetSession": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSession,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.GetSessionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.Session.SerializeToString,
+        ),
+        "ListSessions": grpc.unary_unary_rpc_method_handler(
+            servicer.ListSessions,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ListSessionsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ListSessionsResponse.SerializeToString,
+        ),
+        "DeleteSession": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteSession,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.DeleteSessionRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ExecuteSql": grpc.unary_unary_rpc_method_handler(
+            servicer.ExecuteSql,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteSqlRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.ResultSet.SerializeToString,
+        ),
+        "ExecuteStreamingSql": grpc.unary_stream_rpc_method_handler(
+            servicer.ExecuteStreamingSql,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteSqlRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.PartialResultSet.SerializeToString,
+        ),
+        "ExecuteBatchDml": grpc.unary_unary_rpc_method_handler(
+            servicer.ExecuteBatchDml,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteBatchDmlRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ExecuteBatchDmlResponse.SerializeToString,
+        ),
+        "Read": grpc.unary_unary_rpc_method_handler(
+            servicer.Read,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ReadRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.ResultSet.SerializeToString,
+        ),
+        "StreamingRead": grpc.unary_stream_rpc_method_handler(
+            servicer.StreamingRead,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.ReadRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2.PartialResultSet.SerializeToString,
+        ),
+        "BeginTransaction": grpc.unary_unary_rpc_method_handler(
+            servicer.BeginTransaction,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.BeginTransactionRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.Transaction.SerializeToString,
+        ),
+        "Commit": grpc.unary_unary_rpc_method_handler(
+            servicer.Commit,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.CommitRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.CommitResponse.SerializeToString,
+        ),
+        "Rollback": grpc.unary_unary_rpc_method_handler(
+            servicer.Rollback,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.RollbackRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PartitionQuery": grpc.unary_unary_rpc_method_handler(
+            servicer.PartitionQuery,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionQueryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionResponse.SerializeToString,
+        ),
+        "PartitionRead": grpc.unary_unary_rpc_method_handler(
+            servicer.PartitionRead,
+            request_deserializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionReadRequest.FromString,
+            response_serializer=google_dot_cloud_dot_spanner__v1_dot_proto_dot_spanner__pb2.PartitionResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.spanner.v1.Spanner", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/spanner/google/cloud/spanner_v1/proto/transaction.proto b/spanner/google/cloud/spanner_v1/proto/transaction.proto
new file mode 100644
index 000000000000..7253bcbe0044
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/transaction.proto
@@ -0,0 +1,459 @@
+// 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.spanner.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+option java_outer_classname = "TransactionProto";
+option java_package = "com.google.spanner.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\V1";
+
+// # Transactions
+//
+//
+// Each session can have at most one active transaction at a time. After the
+// active transaction is completed, the session can immediately be
+// re-used for the next transaction. It is not necessary to create a
+// new session for each transaction.
+//
+// # Transaction Modes
+//
+// Cloud Spanner supports three transaction modes:
+//
+//   1. Locking read-write. This type of transaction is the only way
+//      to write data into Cloud Spanner. These transactions rely on
+//      pessimistic locking and, if necessary, two-phase commit.
+//      Locking read-write transactions may abort, requiring the
+//      application to retry.
+//
+//   2. Snapshot read-only. This transaction type provides guaranteed
+//      consistency across several reads, but does not allow
+//      writes. Snapshot read-only transactions can be configured to
+//      read at timestamps in the past. Snapshot read-only
+//      transactions do not need to be committed.
+//
+//   3. Partitioned DML. This type of transaction is used to execute
+//      a single Partitioned DML statement. Partitioned DML partitions
+//      the key space and runs the DML statement over each partition
+//      in parallel using separate, internal transactions that commit
+//      independently. Partitioned DML transactions do not need to be
+//      committed.
+//
+// For transactions that only read, snapshot read-only transactions
+// provide simpler semantics and are almost always faster. In
+// particular, read-only transactions do not take locks, so they do
+// not conflict with read-write transactions. As a consequence of not
+// taking locks, they also do not abort, so retry loops are not needed.
+//
+// Transactions may only read/write data in a single database. They
+// may, however, read/write data in different tables within that
+// database.
+//
+// ## Locking Read-Write Transactions
+//
+// Locking transactions may be used to atomically read-modify-write
+// data anywhere in a database. This type of transaction is externally
+// consistent.
+//
+// Clients should attempt to minimize the amount of time a transaction
+// is active. Faster transactions commit with higher probability
+// and cause less contention. Cloud Spanner attempts to keep read locks
+// active as long as the transaction continues to do reads, and the
+// transaction has not been terminated by
+// [Commit][google.spanner.v1.Spanner.Commit] or
+// [Rollback][google.spanner.v1.Spanner.Rollback].  Long periods of
+// inactivity at the client may cause Cloud Spanner to release a
+// transaction's locks and abort it.
+//
+// Conceptually, a read-write transaction consists of zero or more
+// reads or SQL statements followed by
+// [Commit][google.spanner.v1.Spanner.Commit]. At any time before
+// [Commit][google.spanner.v1.Spanner.Commit], the client can send a
+// [Rollback][google.spanner.v1.Spanner.Rollback] request to abort the
+// transaction.
+//
+// ### Semantics
+//
+// Cloud Spanner can commit the transaction if all read locks it acquired
+// are still valid at commit time, and it is able to acquire write
+// locks for all writes. Cloud Spanner can abort the transaction for any
+// reason. If a commit attempt returns `ABORTED`, Cloud Spanner guarantees
+// that the transaction has not modified any user data in Cloud Spanner.
+//
+// Unless the transaction commits, Cloud Spanner makes no guarantees about
+// how long the transaction's locks were held for. It is an error to
+// use Cloud Spanner locks for any sort of mutual exclusion other than
+// between Cloud Spanner transactions themselves.
+//
+// ### Retrying Aborted Transactions
+//
+// When a transaction aborts, the application can choose to retry the
+// whole transaction again. To maximize the chances of successfully
+// committing the retry, the client should execute the retry in the
+// same session as the original attempt. The original session's lock
+// priority increases with each consecutive abort, meaning that each
+// attempt has a slightly better chance of success than the previous.
+//
+// Under some circumstances (e.g., many transactions attempting to
+// modify the same row(s)), a transaction can abort many times in a
+// short period before successfully committing. Thus, it is not a good
+// idea to cap the number of retries a transaction can attempt;
+// instead, it is better to limit the total amount of wall time spent
+// retrying.
+//
+// ### Idle Transactions
+//
+// A transaction is considered idle if it has no outstanding reads or
+// SQL queries and has not started a read or SQL query within the last 10
+// seconds. Idle transactions can be aborted by Cloud Spanner so that they
+// don't hold on to locks indefinitely. In that case, the commit will
+// fail with error `ABORTED`.
+//
+// If this behavior is undesirable, periodically executing a simple
+// SQL query in the transaction (e.g., `SELECT 1`) prevents the
+// transaction from becoming idle.
+//
+// ## Snapshot Read-Only Transactions
+//
+// Snapshot read-only transactions provides a simpler method than
+// locking read-write transactions for doing several consistent
+// reads. However, this type of transaction does not support writes.
+//
+// Snapshot transactions do not take locks. Instead, they work by
+// choosing a Cloud Spanner timestamp, then executing all reads at that
+// timestamp. Since they do not acquire locks, they do not block
+// concurrent read-write transactions.
+//
+// Unlike locking read-write transactions, snapshot read-only
+// transactions never abort. They can fail if the chosen read
+// timestamp is garbage collected; however, the default garbage
+// collection policy is generous enough that most applications do not
+// need to worry about this in practice.
+//
+// Snapshot read-only transactions do not need to call
+// [Commit][google.spanner.v1.Spanner.Commit] or
+// [Rollback][google.spanner.v1.Spanner.Rollback] (and in fact are not
+// permitted to do so).
+//
+// To execute a snapshot transaction, the client specifies a timestamp
+// bound, which tells Cloud Spanner how to choose a read timestamp.
+//
+// The types of timestamp bound are:
+//
+//   - Strong (the default).
+//   - Bounded staleness.
+//   - Exact staleness.
+//
+// If the Cloud Spanner database to be read is geographically distributed,
+// stale read-only transactions can execute more quickly than strong
+// or read-write transaction, because they are able to execute far
+// from the leader replica.
+//
+// Each type of timestamp bound is discussed in detail below.
+//
+// ### Strong
+//
+// Strong reads are guaranteed to see the effects of all transactions
+// that have committed before the start of the read. Furthermore, all
+// rows yielded by a single read are consistent with each other -- if
+// any part of the read observes a transaction, all parts of the read
+// see the transaction.
+//
+// Strong reads are not repeatable: two consecutive strong read-only
+// transactions might return inconsistent results if there are
+// concurrent writes. If consistency across reads is required, the
+// reads should be executed within a transaction or at an exact read
+// timestamp.
+//
+// See
+// [TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong].
+//
+// ### Exact Staleness
+//
+// These timestamp bounds execute reads at a user-specified
+// timestamp. Reads at a timestamp are guaranteed to see a consistent
+// prefix of the global transaction history: they observe
+// modifications done by all transactions with a commit timestamp <=
+// the read timestamp, and observe none of the modifications done by
+// transactions with a larger commit timestamp. They will block until
+// all conflicting transactions that may be assigned commit timestamps
+// <= the read timestamp have finished.
+//
+// The timestamp can either be expressed as an absolute Cloud Spanner commit
+// timestamp or a staleness relative to the current time.
+//
+// These modes do not require a "negotiation phase" to pick a
+// timestamp. As a result, they execute slightly faster than the
+// 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
+// [TransactionOptions.ReadOnly.exact_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness].
+//
+// ### Bounded Staleness
+//
+// Bounded staleness modes allow Cloud Spanner to pick the read timestamp,
+// subject to a user-provided staleness bound. Cloud Spanner chooses the
+// newest timestamp within the staleness bound that allows execution
+// of the reads at the closest available replica without blocking.
+//
+// All rows yielded are consistent with each other -- if any part of
+// the read observes a transaction, all parts of the read see the
+// transaction. Boundedly stale reads are not repeatable: two stale
+// reads, even if they use the same staleness bound, can execute at
+// different timestamps and thus return inconsistent results.
+//
+// Boundedly stale reads execute in two phases: the first phase
+// negotiates a timestamp among all replicas needed to serve the
+// read. In the second phase, reads are executed at the negotiated
+// timestamp.
+//
+// As a result of the two phase execution, bounded staleness reads are
+// usually a little slower than comparable exact staleness
+// reads. However, they are typically able to return fresher
+// results, and are more likely to execute at the closest replica.
+//
+// Because the timestamp negotiation requires up-front knowledge of
+// 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
+// [TransactionOptions.ReadOnly.min_read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min_read_timestamp].
+//
+// ### Old Read Timestamps and Garbage Collection
+//
+// Cloud Spanner continuously garbage collects deleted and overwritten data
+// in the background to reclaim storage space. This process is known
+// as "version GC". By default, version GC reclaims versions after they
+// are one hour old. Because of this, Cloud Spanner cannot perform reads
+// at read timestamps more than one hour in the past. This
+// restriction also applies to in-progress reads and/or SQL queries whose
+// timestamp become too old while executing. Reads and SQL queries with
+// too-old read timestamps fail with the error `FAILED_PRECONDITION`.
+//
+// ## Partitioned DML Transactions
+//
+// Partitioned DML transactions are used to execute DML statements with a
+// different execution strategy that provides different, and often better,
+// scalability properties for large, table-wide operations than DML in a
+// ReadWrite transaction. Smaller scoped statements, such as an OLTP workload,
+// should prefer using ReadWrite transactions.
+//
+// Partitioned DML partitions the keyspace and runs the DML statement on each
+// partition in separate, internal transactions. These transactions commit
+// automatically when complete, and run independently from one another.
+//
+// To reduce lock contention, this execution strategy only acquires read locks
+// on rows that match the WHERE clause of the statement. Additionally, the
+// smaller per-partition transactions hold locks for less time.
+//
+// That said, Partitioned DML is not a drop-in replacement for standard DML used
+// in ReadWrite transactions.
+//
+//  - The DML statement must be fully-partitionable. Specifically, the statement
+//    must be expressible as the union of many statements which each access only
+//    a single row of the table.
+//
+//  - The statement is not applied atomically to all rows of the table. Rather,
+//    the statement is applied atomically to partitions of the table, in
+//    independent transactions. Secondary index rows are updated atomically
+//    with the base table rows.
+//
+//  - Partitioned DML does not guarantee exactly-once execution semantics
+//    against a partition. The statement will be applied at least once to each
+//    partition. It is strongly recommended that the DML statement should be
+//    idempotent to avoid unexpected results. For instance, it is potentially
+//    dangerous to run a statement such as
+//    `UPDATE table SET column = column + 1` as it could be run multiple times
+//    against some rows.
+//
+//  - The partitions are committed automatically - there is no support for
+//    Commit or Rollback. If the call returns an error, or if the client issuing
+//    the ExecuteSql call dies, it is possible that some rows had the statement
+//    executed on them successfully. It is also possible that statement was
+//    never executed against other rows.
+//
+//  - Partitioned DML transactions may only contain the execution of a single
+//    DML statement via ExecuteSql or ExecuteStreamingSql.
+//
+//  - If any error is encountered during the execution of the partitioned DML
+//    operation (for instance, a UNIQUE INDEX violation, division by zero, or a
+//    value that cannot be stored due to schema constraints), then the
+//    operation is stopped at that point and an error is returned. It is
+//    possible that at this point, some partitions have been committed (or even
+//    committed multiple times), and other partitions have not been run at all.
+//
+// Given the above, Partitioned DML is good fit for large, database-wide,
+// operations that are idempotent, such as deleting old rows from a very large
+// table.
+message TransactionOptions {
+  // Message type to initiate a read-write transaction. Currently this
+  // transaction type has no options.
+  message ReadWrite {}
+
+  // Message type to initiate a Partitioned DML transaction.
+  message PartitionedDml {}
+
+  // Message type to initiate a read-only transaction.
+  message ReadOnly {
+    // How to choose the timestamp for the read-only transaction.
+    oneof timestamp_bound {
+      // Read at a timestamp where all previously committed transactions
+      // are visible.
+      bool strong = 1;
+
+      // Executes all reads at a timestamp >= `min_read_timestamp`.
+      //
+      // This is useful for requesting fresher data than some previous
+      // read, or data that is fresh enough to observe the effects of some
+      // previously committed transaction whose timestamp is known.
+      //
+      // Note that this option can only be used in single-use transactions.
+      //
+      // A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
+      // Example: `"2014-10-02T15:01:23.045123456Z"`.
+      google.protobuf.Timestamp min_read_timestamp = 2;
+
+      // Read data at a timestamp >= `NOW - max_staleness`
+      // seconds. Guarantees that all writes that have committed more
+      // than the specified number of seconds ago are visible. Because
+      // Cloud Spanner chooses the exact timestamp, this mode works even if
+      // the client's local clock is substantially skewed from Cloud Spanner
+      // commit timestamps.
+      //
+      // Useful for reading the freshest data available at a nearby
+      // replica, while bounding the possible staleness if the local
+      // replica has fallen behind.
+      //
+      // Note that this option can only be used in single-use
+      // transactions.
+      google.protobuf.Duration max_staleness = 3;
+
+      // Executes all reads at the given timestamp. Unlike other modes,
+      // reads at a specific timestamp are repeatable; the same read at
+      // the same timestamp always returns the same data. If the
+      // timestamp is in the future, the read will block until the
+      // specified timestamp, modulo the read's deadline.
+      //
+      // Useful for large scale consistent reads such as mapreduces, or
+      // for coordinating many reads against a consistent snapshot of the
+      // data.
+      //
+      // A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
+      // Example: `"2014-10-02T15:01:23.045123456Z"`.
+      google.protobuf.Timestamp read_timestamp = 4;
+
+      // Executes all reads at a timestamp that is `exact_staleness`
+      // old. The timestamp is chosen soon after the read is started.
+      //
+      // Guarantees that all writes that have committed more than the
+      // specified number of seconds ago are visible. Because Cloud Spanner
+      // chooses the exact timestamp, this mode works even if the client's
+      // local clock is substantially skewed from Cloud Spanner commit
+      // timestamps.
+      //
+      // Useful for reading at nearby replicas without the distributed
+      // timestamp negotiation overhead of `max_staleness`.
+      google.protobuf.Duration exact_staleness = 5;
+    }
+
+    // If true, the Cloud Spanner-selected read timestamp is included in
+    // the [Transaction][google.spanner.v1.Transaction] message that describes
+    // the transaction.
+    bool return_read_timestamp = 6;
+  }
+
+  // Required. The type of transaction.
+  oneof mode {
+    // Transaction may write.
+    //
+    // Authorization to begin a read-write transaction requires
+    // `spanner.databases.beginOrRollbackReadWriteTransaction` permission
+    // on the `session` resource.
+    ReadWrite read_write = 1;
+
+    // Partitioned DML transaction.
+    //
+    // Authorization to begin a Partitioned DML transaction requires
+    // `spanner.databases.beginPartitionedDmlTransaction` permission
+    // on the `session` resource.
+    PartitionedDml partitioned_dml = 3;
+
+    // Transaction will not write.
+    //
+    // Authorization to begin a read-only transaction requires
+    // `spanner.databases.beginReadOnlyTransaction` permission
+    // on the `session` resource.
+    ReadOnly read_only = 2;
+  }
+}
+
+// A transaction.
+message Transaction {
+  // `id` may be used to identify the transaction in subsequent
+  // [Read][google.spanner.v1.Spanner.Read],
+  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql],
+  // [Commit][google.spanner.v1.Spanner.Commit], or
+  // [Rollback][google.spanner.v1.Spanner.Rollback] calls.
+  //
+  // Single-use read-only transactions do not have IDs, because
+  // single-use transactions do not support multiple requests.
+  bytes id = 1;
+
+  // For snapshot read-only transactions, the read timestamp chosen
+  // for the transaction. Not returned by default: see
+  // [TransactionOptions.ReadOnly.return_read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.return_read_timestamp].
+  //
+  // A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
+  // Example: `"2014-10-02T15:01:23.045123456Z"`.
+  google.protobuf.Timestamp read_timestamp = 2;
+}
+
+// This message is used to select the transaction in which a
+// [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.
+message TransactionSelector {
+  // If no fields are set, the default is a single use transaction
+  // with strong concurrency.
+  oneof selector {
+    // Execute the read or SQL query in a temporary transaction.
+    // This is the most efficient way to execute a transaction that
+    // consists of a single SQL query.
+    TransactionOptions single_use = 1;
+
+    // Execute the read or SQL query in a previously-started transaction.
+    bytes id = 2;
+
+    // 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].
+    TransactionOptions begin = 3;
+  }
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/transaction_pb2.py b/spanner/google/cloud/spanner_v1/proto/transaction_pb2.py
new file mode 100644
index 000000000000..db95c96805ad
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/transaction_pb2.py
@@ -0,0 +1,1018 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/transaction.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/transaction.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\020TransactionProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/spanner_v1/proto/transaction.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xc3\x04\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x1a\x0b\n\tReadWrite\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_boundB\x06\n\x04mode"M\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selectorB\x99\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TRANSACTIONOPTIONS_READWRITE = _descriptor.Descriptor(
+    name="ReadWrite",
+    full_name="google.spanner.v1.TransactionOptions.ReadWrite",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=409,
+    serialized_end=420,
+)
+
+_TRANSACTIONOPTIONS_PARTITIONEDDML = _descriptor.Descriptor(
+    name="PartitionedDml",
+    full_name="google.spanner.v1.TransactionOptions.PartitionedDml",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=422,
+    serialized_end=438,
+)
+
+_TRANSACTIONOPTIONS_READONLY = _descriptor.Descriptor(
+    name="ReadOnly",
+    full_name="google.spanner.v1.TransactionOptions.ReadOnly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="strong",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.strong",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_read_timestamp",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.min_read_timestamp",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_staleness",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.max_staleness",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_timestamp",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.read_timestamp",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="exact_staleness",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="return_read_timestamp",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.return_read_timestamp",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="timestamp_bound",
+            full_name="google.spanner.v1.TransactionOptions.ReadOnly.timestamp_bound",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=441,
+    serialized_end=737,
+)
+
+_TRANSACTIONOPTIONS = _descriptor.Descriptor(
+    name="TransactionOptions",
+    full_name="google.spanner.v1.TransactionOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="read_write",
+            full_name="google.spanner.v1.TransactionOptions.read_write",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partitioned_dml",
+            full_name="google.spanner.v1.TransactionOptions.partitioned_dml",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_only",
+            full_name="google.spanner.v1.TransactionOptions.read_only",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TRANSACTIONOPTIONS_READWRITE,
+        _TRANSACTIONOPTIONS_PARTITIONEDDML,
+        _TRANSACTIONOPTIONS_READONLY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="mode",
+            full_name="google.spanner.v1.TransactionOptions.mode",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=166,
+    serialized_end=745,
+)
+
+
+_TRANSACTION = _descriptor.Descriptor(
+    name="Transaction",
+    full_name="google.spanner.v1.Transaction",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.spanner.v1.Transaction.id",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_timestamp",
+            full_name="google.spanner.v1.Transaction.read_timestamp",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=747,
+    serialized_end=824,
+)
+
+
+_TRANSACTIONSELECTOR = _descriptor.Descriptor(
+    name="TransactionSelector",
+    full_name="google.spanner.v1.TransactionSelector",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="single_use",
+            full_name="google.spanner.v1.TransactionSelector.single_use",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.spanner.v1.TransactionSelector.id",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="begin",
+            full_name="google.spanner.v1.TransactionSelector.begin",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="selector",
+            full_name="google.spanner.v1.TransactionSelector.selector",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=827,
+    serialized_end=991,
+)
+
+_TRANSACTIONOPTIONS_READWRITE.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_PARTITIONEDDML.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "min_read_timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "max_staleness"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "read_timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "exact_staleness"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TRANSACTIONOPTIONS_READONLY.containing_type = _TRANSACTIONOPTIONS
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["strong"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "strong"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"]
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["min_read_timestamp"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "min_read_timestamp"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"]
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["max_staleness"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "max_staleness"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"]
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["read_timestamp"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "read_timestamp"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"]
+_TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"].fields.append(
+    _TRANSACTIONOPTIONS_READONLY.fields_by_name["exact_staleness"]
+)
+_TRANSACTIONOPTIONS_READONLY.fields_by_name[
+    "exact_staleness"
+].containing_oneof = _TRANSACTIONOPTIONS_READONLY.oneofs_by_name["timestamp_bound"]
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].message_type = _TRANSACTIONOPTIONS_READWRITE
+_TRANSACTIONOPTIONS.fields_by_name[
+    "partitioned_dml"
+].message_type = _TRANSACTIONOPTIONS_PARTITIONEDDML
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].message_type = _TRANSACTIONOPTIONS_READONLY
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_write"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_write"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["partitioned_dml"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "partitioned_dml"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+_TRANSACTIONOPTIONS.oneofs_by_name["mode"].fields.append(
+    _TRANSACTIONOPTIONS.fields_by_name["read_only"]
+)
+_TRANSACTIONOPTIONS.fields_by_name[
+    "read_only"
+].containing_oneof = _TRANSACTIONOPTIONS.oneofs_by_name["mode"]
+_TRANSACTION.fields_by_name[
+    "read_timestamp"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRANSACTIONSELECTOR.fields_by_name["single_use"].message_type = _TRANSACTIONOPTIONS
+_TRANSACTIONSELECTOR.fields_by_name["begin"].message_type = _TRANSACTIONOPTIONS
+_TRANSACTIONSELECTOR.oneofs_by_name["selector"].fields.append(
+    _TRANSACTIONSELECTOR.fields_by_name["single_use"]
+)
+_TRANSACTIONSELECTOR.fields_by_name[
+    "single_use"
+].containing_oneof = _TRANSACTIONSELECTOR.oneofs_by_name["selector"]
+_TRANSACTIONSELECTOR.oneofs_by_name["selector"].fields.append(
+    _TRANSACTIONSELECTOR.fields_by_name["id"]
+)
+_TRANSACTIONSELECTOR.fields_by_name[
+    "id"
+].containing_oneof = _TRANSACTIONSELECTOR.oneofs_by_name["selector"]
+_TRANSACTIONSELECTOR.oneofs_by_name["selector"].fields.append(
+    _TRANSACTIONSELECTOR.fields_by_name["begin"]
+)
+_TRANSACTIONSELECTOR.fields_by_name[
+    "begin"
+].containing_oneof = _TRANSACTIONSELECTOR.oneofs_by_name["selector"]
+DESCRIPTOR.message_types_by_name["TransactionOptions"] = _TRANSACTIONOPTIONS
+DESCRIPTOR.message_types_by_name["Transaction"] = _TRANSACTION
+DESCRIPTOR.message_types_by_name["TransactionSelector"] = _TRANSACTIONSELECTOR
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TransactionOptions = _reflection.GeneratedProtocolMessageType(
+    "TransactionOptions",
+    (_message.Message,),
+    dict(
+        ReadWrite=_reflection.GeneratedProtocolMessageType(
+            "ReadWrite",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READWRITE,
+                __module__="google.cloud.spanner_v1.proto.transaction_pb2",
+                __doc__="""Message type to initiate a read-write transaction. Currently this
+    transaction type has no options.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.ReadWrite)
+            ),
+        ),
+        PartitionedDml=_reflection.GeneratedProtocolMessageType(
+            "PartitionedDml",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_PARTITIONEDDML,
+                __module__="google.cloud.spanner_v1.proto.transaction_pb2",
+                __doc__="""Message type to initiate a Partitioned DML transaction.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.PartitionedDml)
+            ),
+        ),
+        ReadOnly=_reflection.GeneratedProtocolMessageType(
+            "ReadOnly",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRANSACTIONOPTIONS_READONLY,
+                __module__="google.cloud.spanner_v1.proto.transaction_pb2",
+                __doc__="""Message type to initiate a read-only transaction.
+    
+    
+    Attributes:
+        timestamp_bound:
+            How to choose the timestamp for the read-only transaction.
+        strong:
+            Read at a timestamp where all previously committed
+            transactions are visible.
+        min_read_timestamp:
+            Executes all reads at a timestamp >= ``min_read_timestamp``.
+            This is useful for requesting fresher data than some previous
+            read, or data that is fresh enough to observe the effects of
+            some previously committed transaction whose timestamp is
+            known.  Note that this option can only be used in single-use
+            transactions.  A timestamp in RFC3339 UTC "Zulu" format,
+            accurate to nanoseconds. Example:
+            ``"2014-10-02T15:01:23.045123456Z"``.
+        max_staleness:
+            Read data at a timestamp >= ``NOW - max_staleness`` seconds.
+            Guarantees that all writes that have committed more than the
+            specified number of seconds ago are visible. Because Cloud
+            Spanner chooses the exact timestamp, this mode works even if
+            the client's local clock is substantially skewed from Cloud
+            Spanner commit timestamps.  Useful for reading the freshest
+            data available at a nearby replica, while bounding the
+            possible staleness if the local replica has fallen behind.
+            Note that this option can only be used in single-use
+            transactions.
+        read_timestamp:
+            Executes all reads at the given timestamp. Unlike other modes,
+            reads at a specific timestamp are repeatable; the same read at
+            the same timestamp always returns the same data. If the
+            timestamp is in the future, the read will block until the
+            specified timestamp, modulo the read's deadline.  Useful for
+            large scale consistent reads such as mapreduces, or for
+            coordinating many reads against a consistent snapshot of the
+            data.  A timestamp in RFC3339 UTC "Zulu" format, accurate to
+            nanoseconds. Example: ``"2014-10-02T15:01:23.045123456Z"``.
+        exact_staleness:
+            Executes all reads at a timestamp that is ``exact_staleness``
+            old. The timestamp is chosen soon after the read is started.
+            Guarantees that all writes that have committed more than the
+            specified number of seconds ago are visible. Because Cloud
+            Spanner chooses the exact timestamp, this mode works even if
+            the client's local clock is substantially skewed from Cloud
+            Spanner commit timestamps.  Useful for reading at nearby
+            replicas without the distributed timestamp negotiation
+            overhead of ``max_staleness``.
+        return_read_timestamp:
+            If true, the Cloud Spanner-selected read timestamp is included
+            in the [Transaction][google.spanner.v1.Transaction] message
+            that describes the transaction.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.ReadOnly)
+            ),
+        ),
+        DESCRIPTOR=_TRANSACTIONOPTIONS,
+        __module__="google.cloud.spanner_v1.proto.transaction_pb2",
+        __doc__="""Transactions
+  
+  
+  Each session can have at most one active transaction at a time. After
+  the active transaction is completed, the session can immediately be
+  re-used for the next transaction. It is not necessary to create a new
+  session for each transaction.
+  
+  Transaction Modes
+  
+  
+  Cloud Spanner supports three transaction modes:
+  
+  1. Locking read-write. This type of transaction is the only way to write
+     data into Cloud Spanner. These transactions rely on pessimistic
+     locking and, if necessary, two-phase commit. Locking read-write
+     transactions may abort, requiring the application to retry.
+  
+  2. Snapshot read-only. This transaction type provides guaranteed
+     consistency across several reads, but does not allow writes. Snapshot
+     read-only transactions can be configured to read at timestamps in the
+     past. Snapshot read-only transactions do not need to be committed.
+  
+  3. Partitioned DML. This type of transaction is used to execute a single
+     Partitioned DML statement. Partitioned DML partitions the key space
+     and runs the DML statement over each partition in parallel using
+     separate, internal transactions that commit independently.
+     Partitioned DML transactions do not need to be committed.
+  
+  For transactions that only read, snapshot read-only transactions provide
+  simpler semantics and are almost always faster. In particular, read-only
+  transactions do not take locks, so they do not conflict with read-write
+  transactions. As a consequence of not taking locks, they also do not
+  abort, so retry loops are not needed.
+  
+  Transactions may only read/write data in a single database. They may,
+  however, read/write data in different tables within that database.
+  
+  Locking Read-Write Transactions
+  
+  
+  Locking transactions may be used to atomically read-modify-write data
+  anywhere in a database. This type of transaction is externally
+  consistent.
+  
+  Clients should attempt to minimize the amount of time a transaction is
+  active. Faster transactions commit with higher probability and cause
+  less contention. Cloud Spanner attempts to keep read locks active as
+  long as the transaction continues to do reads, and the transaction has
+  not been terminated by [Commit][google.spanner.v1.Spanner.Commit] or
+  [Rollback][google.spanner.v1.Spanner.Rollback]. Long periods of
+  inactivity at the client may cause Cloud Spanner to release a
+  transaction's locks and abort it.
+  
+  Conceptually, a read-write transaction consists of zero or more reads or
+  SQL statements followed by [Commit][google.spanner.v1.Spanner.Commit].
+  At any time before [Commit][google.spanner.v1.Spanner.Commit], the
+  client can send a [Rollback][google.spanner.v1.Spanner.Rollback] request
+  to abort the transaction.
+  
+  Semantics
+  
+  
+  Cloud Spanner can commit the transaction if all read locks it acquired
+  are still valid at commit time, and it is able to acquire write locks
+  for all writes. Cloud Spanner can abort the transaction for any reason.
+  If a commit attempt returns ``ABORTED``, Cloud Spanner guarantees that
+  the transaction has not modified any user data in Cloud Spanner.
+  
+  Unless the transaction commits, Cloud Spanner makes no guarantees about
+  how long the transaction's locks were held for. It is an error to use
+  Cloud Spanner locks for any sort of mutual exclusion other than between
+  Cloud Spanner transactions themselves.
+  
+  Retrying Aborted Transactions
+  
+  
+  When a transaction aborts, the application can choose to retry the whole
+  transaction again. To maximize the chances of successfully committing
+  the retry, the client should execute the retry in the same session as
+  the original attempt. The original session's lock priority increases
+  with each consecutive abort, meaning that each attempt has a slightly
+  better chance of success than the previous.
+  
+  Under some circumstances (e.g., many transactions attempting to modify
+  the same row(s)), a transaction can abort many times in a short period
+  before successfully committing. Thus, it is not a good idea to cap the
+  number of retries a transaction can attempt; instead, it is better to
+  limit the total amount of wall time spent retrying.
+  
+  Idle Transactions
+  
+  
+  A transaction is considered idle if it has no outstanding reads or SQL
+  queries and has not started a read or SQL query within the last 10
+  seconds. Idle transactions can be aborted by Cloud Spanner so that they
+  don't hold on to locks indefinitely. In that case, the commit will fail
+  with error ``ABORTED``.
+  
+  If this behavior is undesirable, periodically executing a simple SQL
+  query in the transaction (e.g., ``SELECT 1``) prevents the transaction
+  from becoming idle.
+  
+  Snapshot Read-Only Transactions
+  
+  
+  Snapshot read-only transactions provides a simpler method than locking
+  read-write transactions for doing several consistent reads. However,
+  this type of transaction does not support writes.
+  
+  Snapshot transactions do not take locks. Instead, they work by choosing
+  a Cloud Spanner timestamp, then executing all reads at that timestamp.
+  Since they do not acquire locks, they do not block concurrent read-write
+  transactions.
+  
+  Unlike locking read-write transactions, snapshot read-only transactions
+  never abort. They can fail if the chosen read timestamp is garbage
+  collected; however, the default garbage collection policy is generous
+  enough that most applications do not need to worry about this in
+  practice.
+  
+  Snapshot read-only transactions do not need to call
+  [Commit][google.spanner.v1.Spanner.Commit] or
+  [Rollback][google.spanner.v1.Spanner.Rollback] (and in fact are not
+  permitted to do so).
+  
+  To execute a snapshot transaction, the client specifies a timestamp
+  bound, which tells Cloud Spanner how to choose a read timestamp.
+  
+  The types of timestamp bound are:
+  
+  -  Strong (the default).
+  -  Bounded staleness.
+  -  Exact staleness.
+  
+  If the Cloud Spanner database to be read is geographically distributed,
+  stale read-only transactions can execute more quickly than strong or
+  read-write transaction, because they are able to execute far from the
+  leader replica.
+  
+  Each type of timestamp bound is discussed in detail below.
+  
+  Strong
+  
+  
+  Strong reads are guaranteed to see the effects of all transactions that
+  have committed before the start of the read. Furthermore, all rows
+  yielded by a single read are consistent with each other -- if any part
+  of the read observes a transaction, all parts of the read see the
+  transaction.
+  
+  Strong reads are not repeatable: two consecutive strong read-only
+  transactions might return inconsistent results if there are concurrent
+  writes. If consistency across reads is required, the reads should be
+  executed within a transaction or at an exact read timestamp.
+  
+  See
+  [TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong].
+  
+  Exact Staleness
+  
+  
+  These timestamp bounds execute reads at a user-specified timestamp.
+  Reads at a timestamp are guaranteed to see a consistent prefix of the
+  global transaction history: they observe modifications done by all
+  transactions with a commit timestamp <= the read timestamp, and observe
+  none of the modifications done by transactions with a larger commit
+  timestamp. They will block until all conflicting transactions that may
+  be assigned commit timestamps <= the read timestamp have finished.
+  
+  The timestamp can either be expressed as an absolute Cloud Spanner
+  commit timestamp or a staleness relative to the current time.
+  
+  These modes do not require a "negotiation phase" to pick a timestamp. As
+  a result, they execute slightly faster than the 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
+  [TransactionOptions.ReadOnly.exact\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact\_staleness].
+  
+  Bounded Staleness
+  
+  
+  Bounded staleness modes allow Cloud Spanner to pick the read timestamp,
+  subject to a user-provided staleness bound. Cloud Spanner chooses the
+  newest timestamp within the staleness bound that allows execution of the
+  reads at the closest available replica without blocking.
+  
+  All rows yielded are consistent with each other -- if any part of the
+  read observes a transaction, all parts of the read see the transaction.
+  Boundedly stale reads are not repeatable: two stale reads, even if they
+  use the same staleness bound, can execute at different timestamps and
+  thus return inconsistent results.
+  
+  Boundedly stale reads execute in two phases: the first phase negotiates
+  a timestamp among all replicas needed to serve the read. In the second
+  phase, reads are executed at the negotiated timestamp.
+  
+  As a result of the two phase execution, bounded staleness reads are
+  usually a little slower than comparable exact staleness reads. However,
+  they are typically able to return fresher results, and are more likely
+  to execute at the closest replica.
+  
+  Because the timestamp negotiation requires up-front knowledge of 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
+  [TransactionOptions.ReadOnly.min\_read\_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min\_read\_timestamp].
+  
+  Old Read Timestamps and Garbage Collection
+  
+  
+  Cloud Spanner continuously garbage collects deleted and overwritten data
+  in the background to reclaim storage space. This process is known as
+  "version GC". By default, version GC reclaims versions after they are
+  one hour old. Because of this, Cloud Spanner cannot perform reads at
+  read timestamps more than one hour in the past. This restriction also
+  applies to in-progress reads and/or SQL queries whose timestamp become
+  too old while executing. Reads and SQL queries with too-old read
+  timestamps fail with the error ``FAILED_PRECONDITION``.
+  
+  Partitioned DML Transactions
+  
+  
+  Partitioned DML transactions are used to execute DML statements with a
+  different execution strategy that provides different, and often better,
+  scalability properties for large, table-wide operations than DML in a
+  ReadWrite transaction. Smaller scoped statements, such as an OLTP
+  workload, should prefer using ReadWrite transactions.
+  
+  Partitioned DML partitions the keyspace and runs the DML statement on
+  each partition in separate, internal transactions. These transactions
+  commit automatically when complete, and run independently from one
+  another.
+  
+  To reduce lock contention, this execution strategy only acquires read
+  locks on rows that match the WHERE clause of the statement.
+  Additionally, the smaller per-partition transactions hold locks for less
+  time.
+  
+  That said, Partitioned DML is not a drop-in replacement for standard DML
+  used in ReadWrite transactions.
+  
+  -  The DML statement must be fully-partitionable. Specifically, the
+     statement must be expressible as the union of many statements which
+     each access only a single row of the table.
+  
+  -  The statement is not applied atomically to all rows of the table.
+     Rather, the statement is applied atomically to partitions of the
+     table, in independent transactions. Secondary index rows are updated
+     atomically with the base table rows.
+  
+  -  Partitioned DML does not guarantee exactly-once execution semantics
+     against a partition. The statement will be applied at least once to
+     each partition. It is strongly recommended that the DML statement
+     should be idempotent to avoid unexpected results. For instance, it is
+     potentially dangerous to run a statement such as
+     ``UPDATE table SET column = column + 1`` as it could be run multiple
+     times against some rows.
+  
+  -  The partitions are committed automatically - there is no support for
+     Commit or Rollback. If the call returns an error, or if the client
+     issuing the ExecuteSql call dies, it is possible that some rows had
+     the statement executed on them successfully. It is also possible that
+     statement was never executed against other rows.
+  
+  -  Partitioned DML transactions may only contain the execution of a
+     single DML statement via ExecuteSql or ExecuteStreamingSql.
+  
+  -  If any error is encountered during the execution of the partitioned
+     DML operation (for instance, a UNIQUE INDEX violation, division by
+     zero, or a value that cannot be stored due to schema constraints),
+     then the operation is stopped at that point and an error is returned.
+     It is possible that at this point, some partitions have been
+     committed (or even committed multiple times), and other partitions
+     have not been run at all.
+  
+  Given the above, Partitioned DML is good fit for large, database-wide,
+  operations that are idempotent, such as deleting old rows from a very
+  large table.
+  
+  
+  Attributes:
+      mode:
+          Required. The type of transaction.
+      read_write:
+          Transaction may write.  Authorization to begin a read-write
+          transaction requires
+          ``spanner.databases.beginOrRollbackReadWriteTransaction``
+          permission on the ``session`` resource.
+      partitioned_dml:
+          Partitioned DML transaction.  Authorization to begin a
+          Partitioned DML transaction requires
+          ``spanner.databases.beginPartitionedDmlTransaction``
+          permission on the ``session`` resource.
+      read_only:
+          Transaction will not write.  Authorization to begin a read-
+          only transaction requires
+          ``spanner.databases.beginReadOnlyTransaction`` permission on
+          the ``session`` resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions)
+    ),
+)
+_sym_db.RegisterMessage(TransactionOptions)
+_sym_db.RegisterMessage(TransactionOptions.ReadWrite)
+_sym_db.RegisterMessage(TransactionOptions.PartitionedDml)
+_sym_db.RegisterMessage(TransactionOptions.ReadOnly)
+
+Transaction = _reflection.GeneratedProtocolMessageType(
+    "Transaction",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSACTION,
+        __module__="google.cloud.spanner_v1.proto.transaction_pb2",
+        __doc__="""A transaction.
+  
+  
+  Attributes:
+      id:
+          ``id`` may be used to identify the transaction in subsequent
+          [Read][google.spanner.v1.Spanner.Read],
+          [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql],
+          [Commit][google.spanner.v1.Spanner.Commit], or
+          [Rollback][google.spanner.v1.Spanner.Rollback] calls.  Single-
+          use read-only transactions do not have IDs, because single-use
+          transactions do not support multiple requests.
+      read_timestamp:
+          For snapshot read-only transactions, the read timestamp chosen
+          for the transaction. Not returned by default: see [Transaction
+          Options.ReadOnly.return\_read\_timestamp][google.spanner.v1.Tr
+          ansactionOptions.ReadOnly.return\_read\_timestamp].  A
+          timestamp in RFC3339 UTC "Zulu" format, accurate to
+          nanoseconds. Example: ``"2014-10-02T15:01:23.045123456Z"``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.Transaction)
+    ),
+)
+_sym_db.RegisterMessage(Transaction)
+
+TransactionSelector = _reflection.GeneratedProtocolMessageType(
+    "TransactionSelector",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSACTIONSELECTOR,
+        __module__="google.cloud.spanner_v1.proto.transaction_pb2",
+        __doc__="""This message is used to select the transaction in which a
+  [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.
+  
+  
+  Attributes:
+      selector:
+          If no fields are set, the default is a single use transaction
+          with strong concurrency.
+      single_use:
+          Execute the read or SQL query in a temporary transaction. This
+          is the most efficient way to execute a transaction that
+          consists of a single SQL query.
+      id:
+          Execute the read or SQL query in a previously-started
+          transaction.
+      begin:
+          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.ResultSetMeta
+          data.transaction], which is a
+          [Transaction][google.spanner.v1.Transaction].
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionSelector)
+    ),
+)
+_sym_db.RegisterMessage(TransactionSelector)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/transaction_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/transaction_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/transaction_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/spanner/google/cloud/spanner_v1/proto/type.proto b/spanner/google/cloud/spanner_v1/proto/type.proto
new file mode 100644
index 000000000000..1ddbd62be56c
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/type.proto
@@ -0,0 +1,121 @@
+// 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.spanner.v1;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
+option java_multiple_files = true;
+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.
+//
+// Each legal value of a type can be encoded to or decoded from a JSON
+// value, using the encodings described below. All Cloud Spanner values can
+// be `null`, regardless of type; `null`s are always encoded as a JSON
+// `null`.
+enum TypeCode {
+  // Not specified.
+  TYPE_CODE_UNSPECIFIED = 0;
+
+  // Encoded as JSON `true` or `false`.
+  BOOL = 1;
+
+  // Encoded as `string`, in decimal format.
+  INT64 = 2;
+
+  // Encoded as `number`, or the strings `"NaN"`, `"Infinity"`, or
+  // `"-Infinity"`.
+  FLOAT64 = 3;
+
+  // Encoded as `string` in RFC 3339 timestamp format. The time zone
+  // must be present, and must be `"Z"`.
+  //
+  // If the schema has the column option
+  // `allow_commit_timestamp=true`, the placeholder string
+  // `"spanner.commit_timestamp()"` can be used to instruct the system
+  // to insert the commit timestamp associated with the transaction
+  // commit.
+  TIMESTAMP = 4;
+
+  // Encoded as `string` in RFC 3339 date format.
+  DATE = 5;
+
+  // Encoded as `string`.
+  STRING = 6;
+
+  // Encoded as a base64-encoded `string`, as described in RFC 4648,
+  // section 4.
+  BYTES = 7;
+
+  // Encoded as `list`, where the list elements are represented
+  // according to
+  // [array_element_type][google.spanner.v1.Type.array_element_type].
+  ARRAY = 8;
+
+  // Encoded as `list`, where list element `i` is represented according
+  // to [struct_type.fields[i]][google.spanner.v1.StructType.fields].
+  STRUCT = 9;
+}
diff --git a/spanner/google/cloud/spanner_v1/proto/type_pb2.py b/spanner/google/cloud/spanner_v1/proto/type_pb2.py
new file mode 100644
index 000000000000..3e8ba25685e9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/type_pb2.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/spanner_v1/proto/type.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/spanner_v1/proto/type.proto",
+    package="google.spanner.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\025com.google.spanner.v1B\tTypeProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1"
+    ),
+    serialized_pb=_b(
+        '\n(google/cloud/spanner_v1/proto/type.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto"\x9a\x01\n\x04Type\x12)\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCode\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\x8e\x01\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42OOL\x10\x01\x12\t\n\x05INT64\x10\x02\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x42YTES\x10\x07\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\tB\x92\x01\n\x15\x63om.google.spanner.v1B\tTypeProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_TYPECODE = _descriptor.EnumDescriptor(
+    name="TypeCode",
+    full_name="google.spanner.v1.TypeCode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_CODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INT64", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLOAT64", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIMESTAMP", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DATE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRING", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BYTES", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ARRAY", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STRUCT", index=9, number=9, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=380,
+    serialized_end=522,
+)
+_sym_db.RegisterEnumDescriptor(_TYPECODE)
+
+TypeCode = enum_type_wrapper.EnumTypeWrapper(_TYPECODE)
+TYPE_CODE_UNSPECIFIED = 0
+BOOL = 1
+INT64 = 2
+FLOAT64 = 3
+TIMESTAMP = 4
+DATE = 5
+STRING = 6
+BYTES = 7
+ARRAY = 8
+STRUCT = 9
+
+
+_TYPE = _descriptor.Descriptor(
+    name="Type",
+    full_name="google.spanner.v1.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.spanner.v1.Type.code",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="array_element_type",
+            full_name="google.spanner.v1.Type.array_element_type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="struct_type",
+            full_name="google.spanner.v1.Type.struct_type",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=94,
+    serialized_end=248,
+)
+
+
+_STRUCTTYPE_FIELD = _descriptor.Descriptor(
+    name="Field",
+    full_name="google.spanner.v1.StructType.Field",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.spanner.v1.StructType.Field.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.spanner.v1.StructType.Field.type",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=317,
+    serialized_end=377,
+)
+
+_STRUCTTYPE = _descriptor.Descriptor(
+    name="StructType",
+    full_name="google.spanner.v1.StructType",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.spanner.v1.StructType.fields",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_STRUCTTYPE_FIELD],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=250,
+    serialized_end=377,
+)
+
+_TYPE.fields_by_name["code"].enum_type = _TYPECODE
+_TYPE.fields_by_name["array_element_type"].message_type = _TYPE
+_TYPE.fields_by_name["struct_type"].message_type = _STRUCTTYPE
+_STRUCTTYPE_FIELD.fields_by_name["type"].message_type = _TYPE
+_STRUCTTYPE_FIELD.containing_type = _STRUCTTYPE
+_STRUCTTYPE.fields_by_name["fields"].message_type = _STRUCTTYPE_FIELD
+DESCRIPTOR.message_types_by_name["Type"] = _TYPE
+DESCRIPTOR.message_types_by_name["StructType"] = _STRUCTTYPE
+DESCRIPTOR.enum_types_by_name["TypeCode"] = _TYPECODE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Type = _reflection.GeneratedProtocolMessageType(
+    "Type",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TYPE,
+        __module__="google.cloud.spanner_v1.proto.type_pb2",
+        __doc__="""``Type`` indicates the type of a Cloud Spanner value, as might be stored
+  in a table cell or returned from an SQL query.
+  
+  
+  Attributes:
+      code:
+          Required. The [TypeCode][google.spanner.v1.TypeCode] for this
+          type.
+      array_element_type:
+          If [code][google.spanner.v1.Type.code] ==
+          [ARRAY][google.spanner.v1.TypeCode.ARRAY], then
+          ``array_element_type`` is the type of the array elements.
+      struct_type:
+          If [code][google.spanner.v1.Type.code] ==
+          [STRUCT][google.spanner.v1.TypeCode.STRUCT], then
+          ``struct_type`` provides type information for the struct's
+          fields.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.Type)
+    ),
+)
+_sym_db.RegisterMessage(Type)
+
+StructType = _reflection.GeneratedProtocolMessageType(
+    "StructType",
+    (_message.Message,),
+    dict(
+        Field=_reflection.GeneratedProtocolMessageType(
+            "Field",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STRUCTTYPE_FIELD,
+                __module__="google.cloud.spanner_v1.proto.type_pb2",
+                __doc__="""Message representing a single field of a struct.
+    
+    
+    Attributes:
+        name:
+            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.
+        type:
+            The type of the field.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.StructType.Field)
+            ),
+        ),
+        DESCRIPTOR=_STRUCTTYPE,
+        __module__="google.cloud.spanner_v1.proto.type_pb2",
+        __doc__="""``StructType`` defines the fields of a
+  [STRUCT][google.spanner.v1.TypeCode.STRUCT] type.
+  
+  
+  Attributes:
+      fields:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.spanner.v1.StructType)
+    ),
+)
+_sym_db.RegisterMessage(StructType)
+_sym_db.RegisterMessage(StructType.Field)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/spanner/google/cloud/spanner_v1/proto/type_pb2_grpc.py b/spanner/google/cloud/spanner_v1/proto/type_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/proto/type_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/spanner/google/cloud/spanner_v1/session.py b/spanner/google/cloud/spanner_v1/session.py
new file mode 100644
index 000000000000..4685c8b80137
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/session.py
@@ -0,0 +1,380 @@
+# Copyright 2016 Google LLC 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.
+
+"""Wrapper for Cloud Spanner Session objects."""
+
+from functools import total_ordering
+import time
+
+from google.rpc.error_details_pb2 import RetryInfo
+
+# pylint: disable=ungrouped-imports
+from google.api_core.exceptions import Aborted, GoogleAPICallError, NotFound
+import google.api_core.gapic_v1.method
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+from google.cloud.spanner_v1.batch import Batch
+from google.cloud.spanner_v1.snapshot import Snapshot
+from google.cloud.spanner_v1.transaction import Transaction
+import random
+
+# pylint: enable=ungrouped-imports
+
+
+DEFAULT_RETRY_TIMEOUT_SECS = 30
+"""Default timeout used by :meth:`Session.run_in_transaction`."""
+
+
+@total_ordering
+class Session(object):
+    """Representation of a Cloud Spanner Session.
+
+    We can use a :class:`Session` to:
+
+    * :meth:`create` the session
+    * Use :meth:`exists` to check for the existence of the session
+    * :meth:`drop` the session
+
+    :type database: :class:`~google.cloud.spanner_v1.database.Database`
+    :param database: The database to which the session is bound.
+
+    :type labels: dict (str -> str)
+    :param labels: (Optional) User-assigned labels for the session.
+    """
+
+    _session_id = None
+    _transaction = None
+
+    def __init__(self, database, labels=None):
+        self._database = database
+        if labels is None:
+            labels = {}
+        self._labels = labels
+
+    def __lt__(self, other):
+        return self._session_id < other._session_id
+
+    @property
+    def session_id(self):
+        """Read-only ID, set by the back-end during :meth:`create`."""
+        return self._session_id
+
+    @property
+    def labels(self):
+        """User-assigned labels for the session.
+
+        :rtype: dict (str -> str)
+        :returns: the labels dict (empty if no labels were assigned.
+        """
+        return self._labels
+
+    @property
+    def name(self):
+        """Session name used in requests.
+
+        .. note::
+
+          This property will not change if ``session_id`` does not, but the
+          return value is not cached.
+
+        The session name is of the form
+
+            ``"projects/../instances/../databases/../sessions/{session_id}"``
+
+        :rtype: str
+        :returns: The session name.
+        :raises ValueError: if session is not yet created
+        """
+        if self._session_id is None:
+            raise ValueError("No session ID set by back-end")
+        return self._database.name + "/sessions/" + self._session_id
+
+    def create(self):
+        """Create this session, bound to its database.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.Spanner.CreateSession
+
+        :raises: :exc:`ValueError` if :attr:`session_id` is already set.
+        """
+        if self._session_id is not None:
+            raise ValueError("Session ID already set by back-end")
+        api = self._database.spanner_api
+        metadata = _metadata_with_prefix(self._database.name)
+        kw = {}
+        if self._labels:
+            kw = {"session": {"labels": self._labels}}
+        session_pb = api.create_session(self._database.name, metadata=metadata, **kw)
+        self._session_id = session_pb.name.split("/")[-1]
+
+    def exists(self):
+        """Test for the existence of this session.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.Spanner.GetSession
+
+        :rtype: bool
+        :returns: True if the session exists on the back-end, else False.
+        """
+        if self._session_id is None:
+            return False
+        api = self._database.spanner_api
+        metadata = _metadata_with_prefix(self._database.name)
+        try:
+            api.get_session(self.name, metadata=metadata)
+        except NotFound:
+            return False
+
+        return True
+
+    def delete(self):
+        """Delete this session.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.Spanner.GetSession
+
+        :raises ValueError: if :attr:`session_id` is not already set.
+        :raises NotFound: if the session does not exist
+        """
+        if self._session_id is None:
+            raise ValueError("Session ID not set by back-end")
+        api = self._database.spanner_api
+        metadata = _metadata_with_prefix(self._database.name)
+
+        api.delete_session(self.name, metadata=metadata)
+
+    def snapshot(self, **kw):
+        """Create a snapshot to perform a set of reads with shared staleness.
+
+        See
+        https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.TransactionOptions.ReadOnly
+
+        :type kw: dict
+        :param kw: Passed through to
+                   :class:`~google.cloud.spanner_v1.snapshot.Snapshot` ctor.
+
+        :rtype: :class:`~google.cloud.spanner_v1.snapshot.Snapshot`
+        :returns: a snapshot bound to this session
+        :raises ValueError: if the session has not yet been created.
+        """
+        if self._session_id is None:
+            raise ValueError("Session has not been created.")
+
+        return Snapshot(self, **kw)
+
+    def read(self, table, columns, keyset, index="", limit=0):
+        """Perform a ``StreamingRead`` API request for rows in a table.
+
+        :type table: str
+        :param table: name of the table from which to fetch data
+
+        :type columns: list of str
+        :param columns: names of columns to be retrieved
+
+        :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
+        :param keyset: keys / ranges identifying rows to be retrieved
+
+        :type index: str
+        :param index: (Optional) name of index to use, rather than the
+                      table's primary key
+
+        :type limit: int
+        :param limit: (Optional) maximum number of rows to return
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+        """
+        return self.snapshot().read(table, columns, keyset, index, limit)
+
+    def execute_sql(
+        self,
+        sql,
+        params=None,
+        param_types=None,
+        query_mode=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+    ):
+        """Perform an ``ExecuteStreamingSql`` API request.
+
+        :type sql: str
+        :param sql: SQL query statement
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``sql``.
+
+        :type param_types:
+            dict, {str -> :class:`google.spanner.v1.type_pb2.TypeCode`}
+        :param param_types: (Optional) explicit types for one or more param
+                            values;  overrides default type detection on the
+                            back-end.
+
+        :type query_mode:
+            :class:`google.spanner.v1.spanner_pb2.ExecuteSqlRequest.QueryMode`
+        :param query_mode: Mode governing return of results / query plan. See
+            https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.ExecuteSqlRequest.QueryMode1
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+        """
+        return self.snapshot().execute_sql(
+            sql, params, param_types, query_mode, retry=retry, timeout=timeout
+        )
+
+    def batch(self):
+        """Factory to create a batch for this session.
+
+        :rtype: :class:`~google.cloud.spanner_v1.batch.Batch`
+        :returns: a batch bound to this session
+        :raises ValueError: if the session has not yet been created.
+        """
+        if self._session_id is None:
+            raise ValueError("Session has not been created.")
+
+        return Batch(self)
+
+    def transaction(self):
+        """Create a transaction to perform a set of reads with shared staleness.
+
+        :rtype: :class:`~google.cloud.spanner_v1.transaction.Transaction`
+        :returns: a transaction bound to this session
+        :raises ValueError: if the session has not yet been created.
+        """
+        if self._session_id is None:
+            raise ValueError("Session has not been created.")
+
+        if self._transaction is not None:
+            self._transaction._rolled_back = True
+            del self._transaction
+
+        txn = self._transaction = Transaction(self)
+        return txn
+
+    def run_in_transaction(self, func, *args, **kw):
+        """Perform a unit of work in a transaction, retrying on abort.
+
+        :type func: callable
+        :param func: takes a required positional argument, the transaction,
+                     and additional positional / keyword arguments as supplied
+                     by the caller.
+
+        :type args: tuple
+        :param args: additional positional arguments to be passed to ``func``.
+
+        :type kw: dict
+        :param kw: optional keyword arguments to be passed to ``func``.
+                   If passed, "timeout_secs" will be removed and used to
+                   override the default timeout.
+
+        :rtype: Any
+        :returns: The return value of ``func``.
+
+        :raises Exception:
+            reraises any non-ABORT execptions raised by ``func``.
+        """
+        deadline = time.time() + kw.pop("timeout_secs", DEFAULT_RETRY_TIMEOUT_SECS)
+        attempts = 0
+
+        while True:
+            if self._transaction is None:
+                txn = self.transaction()
+            else:
+                txn = self._transaction
+            if txn._transaction_id is None:
+                txn.begin()
+
+            try:
+                attempts += 1
+                return_value = func(txn, *args, **kw)
+            except Aborted as exc:
+                del self._transaction
+                _delay_until_retry(exc, deadline, attempts)
+                continue
+            except GoogleAPICallError:
+                del self._transaction
+                raise
+            except Exception:
+                txn.rollback()
+                raise
+
+            try:
+                txn.commit()
+            except Aborted as exc:
+                del self._transaction
+                _delay_until_retry(exc, deadline, attempts)
+            except GoogleAPICallError:
+                del self._transaction
+                raise
+            else:
+                return return_value
+
+
+# pylint: disable=misplaced-bare-raise
+#
+# Rational:  this function factors out complex shared deadline / retry
+#            handling from two `except:` clauses.
+def _delay_until_retry(exc, deadline, attempts):
+    """Helper for :meth:`Session.run_in_transaction`.
+
+    Detect retryable abort, and impose server-supplied delay.
+
+    :type exc: :class:`google.api_core.exceptions.Aborted`
+    :param exc: exception for aborted transaction
+
+    :type deadline: float
+    :param deadline: maximum timestamp to continue retrying the transaction.
+
+    :type attempts: int
+    :param attempts: number of call retries
+    """
+    cause = exc.errors[0]
+
+    now = time.time()
+
+    if now >= deadline:
+        raise
+
+    delay = _get_retry_delay(cause, attempts)
+    if delay is not None:
+
+        if now + delay > deadline:
+            raise
+
+        time.sleep(delay)
+
+
+# pylint: enable=misplaced-bare-raise
+
+
+def _get_retry_delay(cause, attempts):
+    """Helper for :func:`_delay_until_retry`.
+
+    :type exc: :class:`grpc.Call`
+    :param exc: exception for aborted transaction
+
+    :rtype: float
+    :returns: seconds to wait before retrying the transaction.
+
+    :type attempts: int
+    :param attempts: number of call retries
+    """
+    metadata = dict(cause.trailing_metadata())
+    retry_info_pb = metadata.get("google.rpc.retryinfo-bin")
+    if retry_info_pb is not None:
+        retry_info = RetryInfo()
+        retry_info.ParseFromString(retry_info_pb)
+        nanos = retry_info.retry_delay.nanos
+        return retry_info.retry_delay.seconds + nanos / 1.0e9
+
+    return 2 ** attempts + random.random()
diff --git a/spanner/google/cloud/spanner_v1/snapshot.py b/spanner/google/cloud/spanner_v1/snapshot.py
new file mode 100644
index 000000000000..ec7008fb7516
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/snapshot.py
@@ -0,0 +1,505 @@
+# Copyright 2016 Google LLC 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.
+
+"""Model a set of read-only queries to a database as a snapshot."""
+
+import functools
+
+from google.protobuf.struct_pb2 import Struct
+from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionOptions
+from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionSelector
+
+from google.api_core.exceptions import ServiceUnavailable
+import google.api_core.gapic_v1.method
+from google.cloud._helpers import _datetime_to_pb_timestamp
+from google.cloud._helpers import _timedelta_to_duration_pb
+from google.cloud.spanner_v1._helpers import _make_value_pb
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+from google.cloud.spanner_v1._helpers import _SessionWrapper
+from google.cloud.spanner_v1.streamed import StreamedResultSet
+from google.cloud.spanner_v1.types import PartitionOptions
+
+
+def _restart_on_unavailable(restart):
+    """Restart iteration after :exc:`.ServiceUnavailable`.
+
+    :type restart: callable
+    :param restart: curried function returning iterator
+    """
+    resume_token = b""
+    item_buffer = []
+    iterator = restart()
+    while True:
+        try:
+            for item in iterator:
+                item_buffer.append(item)
+                if item.resume_token:
+                    resume_token = item.resume_token
+                    break
+        except ServiceUnavailable:
+            del item_buffer[:]
+            iterator = restart(resume_token=resume_token)
+            continue
+
+        if len(item_buffer) == 0:
+            break
+
+        for item in item_buffer:
+            yield item
+
+        del item_buffer[:]
+
+
+class _SnapshotBase(_SessionWrapper):
+    """Base class for Snapshot.
+
+    Allows reuse of API request methods with different transaction selector.
+
+    :type session: :class:`~google.cloud.spanner_v1.session.Session`
+    :param session: the session used to perform the commit
+    """
+
+    _multi_use = False
+    _transaction_id = None
+    _read_request_count = 0
+    _execute_sql_count = 0
+
+    def _make_txn_selector(self):  # pylint: disable=redundant-returns-doc
+        """Helper for :meth:`read` / :meth:`execute_sql`.
+
+        Subclasses must override, returning an instance of
+        :class:`transaction_pb2.TransactionSelector`
+        appropriate for making ``read`` / ``execute_sql`` requests
+
+        :raises: NotImplementedError, always
+        """
+        raise NotImplementedError
+
+    def read(self, table, columns, keyset, index="", limit=0, partition=None):
+        """Perform a ``StreamingRead`` API request for rows in a table.
+
+        :type table: str
+        :param table: name of the table from which to fetch data
+
+        :type columns: list of str
+        :param columns: names of columns to be retrieved
+
+        :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
+        :param keyset: keys / ranges identifying rows to be retrieved
+
+        :type index: str
+        :param index: (Optional) name of index to use, rather than the
+                      table's primary key
+
+        :type limit: int
+        :param limit: (Optional) maximum number of rows to return.
+                      Incompatible with ``partition``.
+
+        :type partition: bytes
+        :param partition: (Optional) one of the partition tokens returned
+                          from :meth:`partition_read`.  Incompatible with
+                          ``limit``.
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+
+        :raises ValueError:
+            for reuse of single-use snapshots, or if a transaction ID is
+            already pending for multiple-use snapshots.
+        """
+        if self._read_request_count > 0:
+            if not self._multi_use:
+                raise ValueError("Cannot re-use single-use snapshot.")
+            if self._transaction_id is None:
+                raise ValueError("Transaction ID pending.")
+
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        transaction = self._make_txn_selector()
+
+        restart = functools.partial(
+            api.streaming_read,
+            self._session.name,
+            table,
+            columns,
+            keyset._to_pb(),
+            transaction=transaction,
+            index=index,
+            limit=limit,
+            partition_token=partition,
+            metadata=metadata,
+        )
+
+        iterator = _restart_on_unavailable(restart)
+
+        self._read_request_count += 1
+
+        if self._multi_use:
+            return StreamedResultSet(iterator, source=self)
+        else:
+            return StreamedResultSet(iterator)
+
+    def execute_sql(
+        self,
+        sql,
+        params=None,
+        param_types=None,
+        query_mode=None,
+        partition=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+    ):
+        """Perform an ``ExecuteStreamingSql`` API request.
+
+        :type sql: str
+        :param sql: SQL query statement
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``sql``.
+
+        :type param_types: dict[str -> Union[dict, .types.Type]]
+        :param param_types:
+            (Optional) maps explicit types for one or more param values;
+            required if parameters are passed.
+
+        :type query_mode:
+            :class:`google.cloud.spanner_v1.proto.ExecuteSqlRequest.QueryMode`
+        :param query_mode: Mode governing return of results / query plan. See
+            https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.ExecuteSqlRequest.QueryMode1
+
+        :type partition: bytes
+        :param partition: (Optional) one of the partition tokens returned
+                          from :meth:`partition_query`.
+
+        :rtype: :class:`~google.cloud.spanner_v1.streamed.StreamedResultSet`
+        :returns: a result set instance which can be used to consume rows.
+
+        :raises ValueError:
+            for reuse of single-use snapshots, or if a transaction ID is
+            already pending for multiple-use snapshots.
+        """
+        if self._read_request_count > 0:
+            if not self._multi_use:
+                raise ValueError("Cannot re-use single-use snapshot.")
+            if self._transaction_id is None:
+                raise ValueError("Transaction ID pending.")
+
+        if params is not None:
+            if param_types is None:
+                raise ValueError("Specify 'param_types' when passing 'params'.")
+            params_pb = Struct(
+                fields={key: _make_value_pb(value) for key, value in params.items()}
+            )
+        else:
+            params_pb = None
+
+        database = self._session._database
+        metadata = _metadata_with_prefix(database.name)
+        transaction = self._make_txn_selector()
+        api = database.spanner_api
+
+        restart = functools.partial(
+            api.execute_streaming_sql,
+            self._session.name,
+            sql,
+            transaction=transaction,
+            params=params_pb,
+            param_types=param_types,
+            query_mode=query_mode,
+            partition_token=partition,
+            seqno=self._execute_sql_count,
+            metadata=metadata,
+            retry=retry,
+            timeout=timeout,
+        )
+
+        iterator = _restart_on_unavailable(restart)
+
+        self._read_request_count += 1
+        self._execute_sql_count += 1
+
+        if self._multi_use:
+            return StreamedResultSet(iterator, source=self)
+        else:
+            return StreamedResultSet(iterator)
+
+    def partition_read(
+        self,
+        table,
+        columns,
+        keyset,
+        index="",
+        partition_size_bytes=None,
+        max_partitions=None,
+    ):
+        """Perform a ``ParitionRead`` API request for rows in a table.
+
+        :type table: str
+        :param table: name of the table from which to fetch data
+
+        :type columns: list of str
+        :param columns: names of columns to be retrieved
+
+        :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
+        :param keyset: keys / ranges identifying rows to be retrieved
+
+        :type index: str
+        :param index: (Optional) name of index to use, rather than the
+                      table's primary key
+
+        :type partition_size_bytes: int
+        :param partition_size_bytes:
+            (Optional) desired size for each partition generated.  The service
+            uses this as a hint, the actual partition size may differ.
+
+        :type max_partitions: int
+        :param max_partitions:
+            (Optional) desired maximum number of partitions generated. The
+            service uses this as a hint, the actual number of partitions may
+            differ.
+
+        :rtype: iterable of bytes
+        :returns: a sequence of partition tokens
+
+        :raises ValueError:
+            for single-use snapshots, or if a transaction ID is
+            already associtated with the snapshot.
+        """
+        if not self._multi_use:
+            raise ValueError("Cannot use single-use snapshot.")
+
+        if self._transaction_id is None:
+            raise ValueError("Transaction not started.")
+
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        transaction = self._make_txn_selector()
+        partition_options = PartitionOptions(
+            partition_size_bytes=partition_size_bytes, max_partitions=max_partitions
+        )
+
+        response = api.partition_read(
+            session=self._session.name,
+            table=table,
+            columns=columns,
+            key_set=keyset._to_pb(),
+            transaction=transaction,
+            index=index,
+            partition_options=partition_options,
+            metadata=metadata,
+        )
+
+        return [partition.partition_token for partition in response.partitions]
+
+    def partition_query(
+        self,
+        sql,
+        params=None,
+        param_types=None,
+        partition_size_bytes=None,
+        max_partitions=None,
+    ):
+        """Perform a ``ParitionQuery`` API request.
+
+        :type sql: str
+        :param sql: SQL query statement
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``sql``.
+
+        :type param_types: dict[str -> Union[dict, .types.Type]]
+        :param param_types:
+            (Optional) maps explicit types for one or more param values;
+            required if parameters are passed.
+
+        :type partition_size_bytes: int
+        :param partition_size_bytes:
+            (Optional) desired size for each partition generated.  The service
+            uses this as a hint, the actual partition size may differ.
+
+        :type max_partitions: int
+        :param max_partitions:
+            (Optional) desired maximum number of partitions generated. The
+            service uses this as a hint, the actual number of partitions may
+            differ.
+
+        :rtype: iterable of bytes
+        :returns: a sequence of partition tokens
+
+        :raises ValueError:
+            for single-use snapshots, or if a transaction ID is
+            already associtated with the snapshot.
+        """
+        if not self._multi_use:
+            raise ValueError("Cannot use single-use snapshot.")
+
+        if self._transaction_id is None:
+            raise ValueError("Transaction not started.")
+
+        if params is not None:
+            if param_types is None:
+                raise ValueError("Specify 'param_types' when passing 'params'.")
+            params_pb = Struct(
+                fields={key: _make_value_pb(value) for key, value in params.items()}
+            )
+        else:
+            params_pb = None
+
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        transaction = self._make_txn_selector()
+        partition_options = PartitionOptions(
+            partition_size_bytes=partition_size_bytes, max_partitions=max_partitions
+        )
+
+        response = api.partition_query(
+            session=self._session.name,
+            sql=sql,
+            transaction=transaction,
+            params=params_pb,
+            param_types=param_types,
+            partition_options=partition_options,
+            metadata=metadata,
+        )
+
+        return [partition.partition_token for partition in response.partitions]
+
+
+class Snapshot(_SnapshotBase):
+    """Allow a set of reads / SQL statements with shared staleness.
+
+    See
+    https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.TransactionOptions.ReadOnly
+
+    If no options are passed, reads will use the ``strong`` model, reading
+    at a timestamp where all previously committed transactions are visible.
+
+    :type session: :class:`~google.cloud.spanner_v1.session.Session`
+    :param session: the session used to perform the commit.
+
+    :type read_timestamp: :class:`datetime.datetime`
+    :param read_timestamp: Execute all reads at the given timestamp.
+
+    :type min_read_timestamp: :class:`datetime.datetime`
+    :param min_read_timestamp: Execute all reads at a
+                               timestamp >= ``min_read_timestamp``.
+
+    :type max_staleness: :class:`datetime.timedelta`
+    :param max_staleness: Read data at a
+                          timestamp >= NOW - ``max_staleness`` seconds.
+
+    :type exact_staleness: :class:`datetime.timedelta`
+    :param exact_staleness: Execute all reads at a timestamp that is
+                            ``exact_staleness`` old.
+
+    :type multi_use: :class:`bool`
+    :param multi_use: If true, multipl :meth:`read` / :meth:`execute_sql`
+                      calls can be performed with the snapshot in the
+                      context of a read-only transaction, used to ensure
+                      isolation / consistency. Incompatible with
+                      ``max_staleness`` and ``min_read_timestamp``.
+    """
+
+    def __init__(
+        self,
+        session,
+        read_timestamp=None,
+        min_read_timestamp=None,
+        max_staleness=None,
+        exact_staleness=None,
+        multi_use=False,
+    ):
+        super(Snapshot, self).__init__(session)
+        opts = [read_timestamp, min_read_timestamp, max_staleness, exact_staleness]
+        flagged = [opt for opt in opts if opt is not None]
+
+        if len(flagged) > 1:
+            raise ValueError("Supply zero or one options.")
+
+        if multi_use:
+            if min_read_timestamp is not None or max_staleness is not None:
+                raise ValueError(
+                    "'multi_use' is incompatible with "
+                    "'min_read_timestamp' / 'max_staleness'"
+                )
+
+        self._strong = len(flagged) == 0
+        self._read_timestamp = read_timestamp
+        self._min_read_timestamp = min_read_timestamp
+        self._max_staleness = max_staleness
+        self._exact_staleness = exact_staleness
+        self._multi_use = multi_use
+
+    def _make_txn_selector(self):
+        """Helper for :meth:`read`."""
+        if self._transaction_id is not None:
+            return TransactionSelector(id=self._transaction_id)
+
+        if self._read_timestamp:
+            key = "read_timestamp"
+            value = _datetime_to_pb_timestamp(self._read_timestamp)
+        elif self._min_read_timestamp:
+            key = "min_read_timestamp"
+            value = _datetime_to_pb_timestamp(self._min_read_timestamp)
+        elif self._max_staleness:
+            key = "max_staleness"
+            value = _timedelta_to_duration_pb(self._max_staleness)
+        elif self._exact_staleness:
+            key = "exact_staleness"
+            value = _timedelta_to_duration_pb(self._exact_staleness)
+        else:
+            key = "strong"
+            value = True
+
+        options = TransactionOptions(
+            read_only=TransactionOptions.ReadOnly(**{key: value})
+        )
+
+        if self._multi_use:
+            return TransactionSelector(begin=options)
+        else:
+            return TransactionSelector(single_use=options)
+
+    def begin(self):
+        """Begin a read-only transaction on the database.
+
+        :rtype: bytes
+        :returns: the ID for the newly-begun transaction.
+
+        :raises ValueError:
+            if the transaction is already begun, committed, or rolled back.
+        """
+        if not self._multi_use:
+            raise ValueError("Cannot call 'begin' on single-use snapshots")
+
+        if self._transaction_id is not None:
+            raise ValueError("Read-only transaction already begun")
+
+        if self._read_request_count > 0:
+            raise ValueError("Read-only transaction already pending")
+
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        txn_selector = self._make_txn_selector()
+        response = api.begin_transaction(
+            self._session.name, txn_selector.begin, metadata=metadata
+        )
+        self._transaction_id = response.id
+        return self._transaction_id
diff --git a/spanner/google/cloud/spanner_v1/streamed.py b/spanner/google/cloud/spanner_v1/streamed.py
new file mode 100644
index 000000000000..ddb240a68a91
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/streamed.py
@@ -0,0 +1,305 @@
+# Copyright 2016 Google LLC 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.
+
+"""Wrapper for streaming results."""
+
+from google.protobuf.struct_pb2 import ListValue
+from google.protobuf.struct_pb2 import Value
+from google.cloud import exceptions
+from google.cloud.spanner_v1.proto import type_pb2
+import six
+
+# pylint: disable=ungrouped-imports
+from google.cloud.spanner_v1._helpers import _parse_value_pb
+
+# pylint: enable=ungrouped-imports
+
+
+class StreamedResultSet(object):
+    """Process a sequence of partial result sets into a single set of row data.
+
+    :type response_iterator:
+    :param response_iterator:
+        Iterator yielding
+        :class:`google.cloud.spanner_v1.proto.result_set_pb2.PartialResultSet`
+        instances.
+
+    :type source: :class:`~google.cloud.spanner_v1.snapshot.Snapshot`
+    :param source: Snapshot from which the result set was fetched.
+    """
+
+    def __init__(self, response_iterator, source=None):
+        self._response_iterator = response_iterator
+        self._rows = []  # Fully-processed rows
+        self._counter = 0  # Counter for processed responses
+        self._metadata = None  # Until set from first PRS
+        self._stats = None  # Until set from last PRS
+        self._current_row = []  # Accumulated values for incomplete row
+        self._pending_chunk = None  # Incomplete value
+        self._source = source  # Source snapshot
+
+    @property
+    def fields(self):
+        """Field descriptors for result set columns.
+
+        :rtype: list of :class:`~google.cloud.spanner_v1.proto.type_pb2.Field`
+        :returns: list of fields describing column names / types.
+        """
+        return self._metadata.row_type.fields
+
+    @property
+    def metadata(self):
+        """Result set metadata
+
+        :rtype: :class:`~.result_set_pb2.ResultSetMetadata`
+        :returns: structure describing the results
+        """
+        return self._metadata
+
+    @property
+    def stats(self):
+        """Result set statistics
+
+        :rtype:
+           :class:`~google.cloud.spanner_v1.proto.result_set_pb2.ResultSetStats`
+        :returns: structure describing status about the response
+        """
+        return self._stats
+
+    def _merge_chunk(self, value):
+        """Merge pending chunk with next value.
+
+        :type value: :class:`~google.protobuf.struct_pb2.Value`
+        :param value: continuation of chunked value from previous
+                      partial result set.
+
+        :rtype: :class:`~google.protobuf.struct_pb2.Value`
+        :returns: the merged value
+        """
+        current_column = len(self._current_row)
+        field = self.fields[current_column]
+        merged = _merge_by_type(self._pending_chunk, value, field.type)
+        self._pending_chunk = None
+        return merged
+
+    def _merge_values(self, values):
+        """Merge values into rows.
+
+        :type values: list of :class:`~google.protobuf.struct_pb2.Value`
+        :param values: non-chunked values from partial result set.
+        """
+        width = len(self.fields)
+        for value in values:
+            index = len(self._current_row)
+            field = self.fields[index]
+            self._current_row.append(_parse_value_pb(value, field.type))
+            if len(self._current_row) == width:
+                self._rows.append(self._current_row)
+                self._current_row = []
+
+    def _consume_next(self):
+        """Consume the next partial result set from the stream.
+
+        Parse the result set into new/existing rows in :attr:`_rows`
+        """
+        response = six.next(self._response_iterator)
+        self._counter += 1
+
+        if self._metadata is None:  # first response
+            metadata = self._metadata = response.metadata
+
+            source = self._source
+            if source is not None and source._transaction_id is None:
+                source._transaction_id = metadata.transaction.id
+
+        if response.HasField("stats"):  # last response
+            self._stats = response.stats
+
+        values = list(response.values)
+        if self._pending_chunk is not None:
+            values[0] = self._merge_chunk(values[0])
+
+        if response.chunked_value:
+            self._pending_chunk = values.pop()
+
+        self._merge_values(values)
+
+    def __iter__(self):
+        iter_rows, self._rows[:] = self._rows[:], ()
+        while True:
+            if not iter_rows:
+                try:
+                    self._consume_next()
+                except StopIteration:
+                    return
+                iter_rows, self._rows[:] = self._rows[:], ()
+            while iter_rows:
+                yield iter_rows.pop(0)
+
+    def one(self):
+        """Return exactly one result, or raise an exception.
+
+        :raises: :exc:`NotFound`: If there are no results.
+        :raises: :exc:`ValueError`: If there are multiple results.
+        :raises: :exc:`RuntimeError`: If consumption has already occurred,
+            in whole or in part.
+        """
+        answer = self.one_or_none()
+        if answer is None:
+            raise exceptions.NotFound("No rows matched the given query.")
+        return answer
+
+    def one_or_none(self):
+        """Return exactly one result, or None if there are no results.
+
+        :raises: :exc:`ValueError`: If there are multiple results.
+        :raises: :exc:`RuntimeError`: If consumption has already occurred,
+            in whole or in part.
+        """
+        # Sanity check: Has consumption of this query already started?
+        # If it has, then this is an exception.
+        if self._metadata is not None:
+            raise RuntimeError(
+                "Can not call `.one` or `.one_or_none` after "
+                "stream consumption has already started."
+            )
+
+        # Consume the first result of the stream.
+        # If there is no first result, then return None.
+        iterator = iter(self)
+        try:
+            answer = next(iterator)
+        except StopIteration:
+            return None
+
+        # Attempt to consume more. This should no-op; if we get additional
+        # rows, then this is an error case.
+        try:
+            next(iterator)
+            raise ValueError("Expected one result; got more.")
+        except StopIteration:
+            return answer
+
+
+class Unmergeable(ValueError):
+    """Unable to merge two values.
+
+    :type lhs: :class:`google.protobuf.struct_pb2.Value`
+    :param lhs: pending value to be merged
+
+    :type rhs: :class:`google.protobuf.struct_pb2.Value`
+    :param rhs: remaining value to be merged
+
+    :type type_: :class:`google.cloud.spanner_v1.proto.type_pb2.Type`
+    :param type_: field type of values being merged
+    """
+
+    def __init__(self, lhs, rhs, type_):
+        message = "Cannot merge %s values: %s %s" % (
+            type_pb2.TypeCode.Name(type_.code),
+            lhs,
+            rhs,
+        )
+        super(Unmergeable, self).__init__(message)
+
+
+def _unmergeable(lhs, rhs, type_):
+    """Helper for '_merge_by_type'."""
+    raise Unmergeable(lhs, rhs, type_)
+
+
+def _merge_float64(lhs, rhs, type_):  # pylint: disable=unused-argument
+    """Helper for '_merge_by_type'."""
+    lhs_kind = lhs.WhichOneof("kind")
+    if lhs_kind == "string_value":
+        return Value(string_value=lhs.string_value + rhs.string_value)
+    rhs_kind = rhs.WhichOneof("kind")
+    array_continuation = (
+        lhs_kind == "number_value"
+        and rhs_kind == "string_value"
+        and rhs.string_value == ""
+    )
+    if array_continuation:
+        return lhs
+    raise Unmergeable(lhs, rhs, type_)
+
+
+def _merge_string(lhs, rhs, type_):  # pylint: disable=unused-argument
+    """Helper for '_merge_by_type'."""
+    return Value(string_value=lhs.string_value + rhs.string_value)
+
+
+_UNMERGEABLE_TYPES = (type_pb2.BOOL,)
+
+
+def _merge_array(lhs, rhs, type_):
+    """Helper for '_merge_by_type'."""
+    element_type = type_.array_element_type
+    if element_type.code in _UNMERGEABLE_TYPES:
+        # Individual values cannot be merged, just concatenate
+        lhs.list_value.values.extend(rhs.list_value.values)
+        return lhs
+    lhs, rhs = list(lhs.list_value.values), list(rhs.list_value.values)
+
+    # Sanity check: If either list is empty, short-circuit.
+    # This is effectively a no-op.
+    if not len(lhs) or not len(rhs):
+        return Value(list_value=ListValue(values=(lhs + rhs)))
+
+    first = rhs.pop(0)
+    if first.HasField("null_value"):  # can't merge
+        lhs.append(first)
+    else:
+        last = lhs.pop()
+        try:
+            merged = _merge_by_type(last, first, element_type)
+        except Unmergeable:
+            lhs.append(last)
+            lhs.append(first)
+        else:
+            lhs.append(merged)
+    return Value(list_value=ListValue(values=(lhs + rhs)))
+
+
+def _merge_struct(lhs, rhs, type_):
+    """Helper for '_merge_by_type'."""
+    fields = type_.struct_type.fields
+    lhs, rhs = list(lhs.list_value.values), list(rhs.list_value.values)
+    candidate_type = fields[len(lhs) - 1].type
+    first = rhs.pop(0)
+    if first.HasField("null_value") or candidate_type.code in _UNMERGEABLE_TYPES:
+        lhs.append(first)
+    else:
+        last = lhs.pop()
+        lhs.append(_merge_by_type(last, first, candidate_type))
+    return Value(list_value=ListValue(values=lhs + rhs))
+
+
+_MERGE_BY_TYPE = {
+    type_pb2.ARRAY: _merge_array,
+    type_pb2.BOOL: _unmergeable,
+    type_pb2.BYTES: _merge_string,
+    type_pb2.DATE: _merge_string,
+    type_pb2.FLOAT64: _merge_float64,
+    type_pb2.INT64: _merge_string,
+    type_pb2.STRING: _merge_string,
+    type_pb2.STRUCT: _merge_struct,
+    type_pb2.TIMESTAMP: _merge_string,
+}
+
+
+def _merge_by_type(lhs, rhs, type_):
+    """Helper for '_merge_chunk'."""
+    merger = _MERGE_BY_TYPE[type_.code]
+    return merger(lhs, rhs, type_)
diff --git a/spanner/google/cloud/spanner_v1/transaction.py b/spanner/google/cloud/spanner_v1/transaction.py
new file mode 100644
index 000000000000..b4eb21143ac7
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/transaction.py
@@ -0,0 +1,270 @@
+# Copyright 2016 Google LLC 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.
+
+"""Spanner read-write transaction support."""
+
+from google.protobuf.struct_pb2 import Struct
+
+from google.cloud._helpers import _pb_timestamp_to_datetime
+from google.cloud.spanner_v1._helpers import _make_value_pb
+from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionSelector
+from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionOptions
+from google.cloud.spanner_v1.snapshot import _SnapshotBase
+from google.cloud.spanner_v1.batch import _BatchBase
+
+
+class Transaction(_SnapshotBase, _BatchBase):
+    """Implement read-write transaction semantics for a session.
+
+    :type session: :class:`~google.cloud.spanner_v1.session.Session`
+    :param session: the session used to perform the commit
+
+    :raises ValueError: if session has an existing transaction
+    """
+
+    committed = None
+    """Timestamp at which the transaction was successfully committed."""
+    _rolled_back = False
+    _multi_use = True
+    _execute_sql_count = 0
+
+    def __init__(self, session):
+        if session._transaction is not None:
+            raise ValueError("Session has existing transaction.")
+
+        super(Transaction, self).__init__(session)
+
+    def _check_state(self):
+        """Helper for :meth:`commit` et al.
+
+        :raises: :exc:`ValueError` if the object's state is invalid for making
+                 API requests.
+        """
+        if self._transaction_id is None:
+            raise ValueError("Transaction is not begun")
+
+        if self.committed is not None:
+            raise ValueError("Transaction is already committed")
+
+        if self._rolled_back:
+            raise ValueError("Transaction is already rolled back")
+
+    def _make_txn_selector(self):
+        """Helper for :meth:`read`.
+
+        :rtype:
+            :class:`~.transaction_pb2.TransactionSelector`
+        :returns: a selector configured for read-write transaction semantics.
+        """
+        self._check_state()
+        return TransactionSelector(id=self._transaction_id)
+
+    def begin(self):
+        """Begin a transaction on the database.
+
+        :rtype: bytes
+        :returns: the ID for the newly-begun transaction.
+        :raises ValueError:
+            if the transaction is already begun, committed, or rolled back.
+        """
+        if self._transaction_id is not None:
+            raise ValueError("Transaction already begun")
+
+        if self.committed is not None:
+            raise ValueError("Transaction already committed")
+
+        if self._rolled_back:
+            raise ValueError("Transaction is already rolled back")
+
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        txn_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        response = api.begin_transaction(
+            self._session.name, txn_options, metadata=metadata
+        )
+        self._transaction_id = response.id
+        return self._transaction_id
+
+    def rollback(self):
+        """Roll back a transaction on the database."""
+        self._check_state()
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        api.rollback(self._session.name, self._transaction_id, metadata=metadata)
+        self._rolled_back = True
+        del self._session._transaction
+
+    def commit(self):
+        """Commit mutations to the database.
+
+        :rtype: datetime
+        :returns: timestamp of the committed changes.
+        :raises ValueError: if there are no mutations to commit.
+        """
+        self._check_state()
+
+        database = self._session._database
+        api = database.spanner_api
+        metadata = _metadata_with_prefix(database.name)
+        response = api.commit(
+            self._session.name,
+            self._mutations,
+            transaction_id=self._transaction_id,
+            metadata=metadata,
+        )
+        self.committed = _pb_timestamp_to_datetime(response.commit_timestamp)
+        del self._session._transaction
+        return self.committed
+
+    @staticmethod
+    def _make_params_pb(params, param_types):
+        """Helper for :meth:`execute_update`.
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``dml``.
+
+        :type param_types: dict[str -> Union[dict, .types.Type]]
+        :param param_types:
+            (Optional) maps explicit types for one or more param values;
+            required if parameters are passed.
+
+        :rtype: Union[None, :class:`Struct`]
+        :returns: a struct message for the passed params, or None
+        :raises ValueError:
+            If ``param_types`` is None but ``params`` is not None.
+        :raises ValueError:
+            If ``params`` is None but ``param_types`` is not None.
+        """
+        if params is not None:
+            if param_types is None:
+                raise ValueError("Specify 'param_types' when passing 'params'.")
+            return Struct(
+                fields={key: _make_value_pb(value) for key, value in params.items()}
+            )
+        else:
+            if param_types is not None:
+                raise ValueError("Specify 'params' when passing 'param_types'.")
+
+        return None
+
+    def execute_update(self, dml, params=None, param_types=None, query_mode=None):
+        """Perform an ``ExecuteSql`` API request with DML.
+
+        :type dml: str
+        :param dml: SQL DML statement
+
+        :type params: dict, {str -> column value}
+        :param params: values for parameter replacement.  Keys must match
+                       the names used in ``dml``.
+
+        :type param_types: dict[str -> Union[dict, .types.Type]]
+        :param param_types:
+            (Optional) maps explicit types for one or more param values;
+            required if parameters are passed.
+
+        :type query_mode:
+            :class:`google.cloud.spanner_v1.proto.ExecuteSqlRequest.QueryMode`
+        :param query_mode: Mode governing return of results / query plan. See
+            https://cloud.google.com/spanner/reference/rpc/google.spanner.v1#google.spanner.v1.ExecuteSqlRequest.QueryMode1
+
+        :rtype: int
+        :returns: Count of rows affected by the DML statement.
+        """
+        params_pb = self._make_params_pb(params, param_types)
+        database = self._session._database
+        metadata = _metadata_with_prefix(database.name)
+        transaction = self._make_txn_selector()
+        api = database.spanner_api
+
+        response = api.execute_sql(
+            self._session.name,
+            dml,
+            transaction=transaction,
+            params=params_pb,
+            param_types=param_types,
+            query_mode=query_mode,
+            seqno=self._execute_sql_count,
+            metadata=metadata,
+        )
+
+        self._execute_sql_count += 1
+        return response.stats.row_count_exact
+
+    def batch_update(self, statements):
+        """Perform a batch of DML statements via an ``ExecuteBatchDml`` request.
+
+        :type statements:
+            Sequence[Union[ str, Tuple[str, Dict[str, Any], Dict[str, Union[dict, .types.Type]]]]]
+
+        :param statements:
+            List of DML statements, with optional params / param types.
+            If passed, 'params' is a dict mapping names to the values
+            for parameter replacement.  Keys must match the names used in the
+            corresponding DML statement.  If 'params' is passed, 'param_types'
+            must also be passed, as a dict mapping names to the type of
+            value passed in 'params'.
+
+        :rtype:
+            Tuple(status, Sequence[int])
+        :returns:
+            Status code, plus counts of rows affected by each completed DML
+            statement.  Note that if the staus code is not ``OK``, the
+            statement triggering the error will not have an entry in the
+            list, nor will any statements following that one.
+        """
+        parsed = []
+        for statement in statements:
+            if isinstance(statement, str):
+                parsed.append({"sql": statement})
+            else:
+                dml, params, param_types = statement
+                params_pb = self._make_params_pb(params, param_types)
+                parsed.append(
+                    {"sql": dml, "params": params_pb, "param_types": param_types}
+                )
+
+        database = self._session._database
+        metadata = _metadata_with_prefix(database.name)
+        transaction = self._make_txn_selector()
+        api = database.spanner_api
+
+        response = api.execute_batch_dml(
+            session=self._session.name,
+            transaction=transaction,
+            statements=parsed,
+            seqno=self._execute_sql_count,
+            metadata=metadata,
+        )
+
+        self._execute_sql_count += 1
+        row_counts = [
+            result_set.stats.row_count_exact for result_set in response.result_sets
+        ]
+        return response.status, row_counts
+
+    def __enter__(self):
+        """Begin ``with`` block."""
+        self.begin()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """End ``with`` block."""
+        if exc_type is None:
+            self.commit()
+        else:
+            self.rollback()
diff --git a/spanner/google/cloud/spanner_v1/types.py b/spanner/google/cloud/spanner_v1/types.py
new file mode 100644
index 000000000000..07c94ba871e3
--- /dev/null
+++ b/spanner/google/cloud/spanner_v1/types.py
@@ -0,0 +1,67 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import sys
+
+from google.api import http_pb2
+from google.protobuf import descriptor_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import struct_pb2
+from google.protobuf import timestamp_pb2
+
+from google.api_core.protobuf_helpers import get_messages
+from google.cloud.spanner_v1.proto import keys_pb2
+from google.cloud.spanner_v1.proto import mutation_pb2
+from google.cloud.spanner_v1.proto import query_plan_pb2
+from google.cloud.spanner_v1.proto import result_set_pb2
+from google.cloud.spanner_v1.proto import spanner_pb2
+from google.cloud.spanner_v1.proto import transaction_pb2
+from google.cloud.spanner_v1.proto import type_pb2
+
+
+_shared_modules = [
+    http_pb2,
+    descriptor_pb2,
+    duration_pb2,
+    empty_pb2,
+    struct_pb2,
+    timestamp_pb2,
+]
+
+_local_modules = [
+    keys_pb2,
+    mutation_pb2,
+    query_plan_pb2,
+    result_set_pb2,
+    spanner_pb2,
+    transaction_pb2,
+    type_pb2,
+]
+
+names = []
+
+for module in _shared_modules:
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.spanner_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+__all__ = tuple(sorted(names))
diff --git a/spanner/noxfile.py b/spanner/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/spanner/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/spanner/pylint.config.py b/spanner/pylint.config.py
new file mode 100644
index 000000000000..f7928f67601e
--- /dev/null
+++ b/spanner/pylint.config.py
@@ -0,0 +1,33 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+import copy
+
+from gcp_devrel.tools import pylint
+
+# Library configuration
+
+# library_additions = {}
+# Ignore generated code
+library_replacements = copy.deepcopy(pylint.DEFAULT_LIBRARY_RC_REPLACEMENTS)
+library_replacements['MASTER']['ignore'].append('spanner_v1')
+library_replacements['MASTER']['ignore'].append('spanner_admin_instance_v1')
+library_replacements['MASTER']['ignore'].append('spanner_admin_database_v1')
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/spanner/setup.cfg b/spanner/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/spanner/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/spanner/setup.py b/spanner/setup.py
new file mode 100644
index 000000000000..5884bf628b7c
--- /dev/null
+++ b/spanner/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-spanner"
+description = "Cloud Spanner API client library"
+version = "1.10.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc, grpcgcp] >= 1.14.0, < 2.0.0dev",
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/spanner/synth.metadata b/spanner/synth.metadata
new file mode 100644
index 000000000000..7646a8a309f1
--- /dev/null
+++ b/spanner/synth.metadata
@@ -0,0 +1,59 @@
+{
+  "updateTime": "2019-08-23T12:37:16.324493Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.34.0",
+        "dockerImage": "googleapis/artman@sha256:38a27ba6245f96c3e86df7acb2ebcc33b4f186d9e475efe2d64303aec3d4e0ea"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "9c9f778aedde02f9826d2ae5d0f9c96409ba0f25",
+        "internalRef": "264996596"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "spanner",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/spanner/artman_spanner.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "spanner_admin_instance",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/spanner/admin/instance/artman_spanner_admin_instance.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "spanner_admin_database",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/spanner/admin/database/artman_spanner_admin_database.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/spanner/synth.py b/spanner/synth.py
new file mode 100644
index 000000000000..99994a87741c
--- /dev/null
+++ b/spanner/synth.py
@@ -0,0 +1,144 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate spanner GAPIC layer
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "spanner",
+    "v1",
+    config_path="/google/spanner/artman_spanner.yaml",
+    artman_output_name="spanner-v1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/spanner_v1/proto")
+s.move(library / "google/cloud/spanner_v1/gapic")
+s.move(library / "tests")
+
+# Add grpcio-gcp options
+s.replace(
+    "google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py",
+    "import google.api_core.grpc_helpers\n",
+    "import pkg_resources\n"
+    "import grpc_gcp\n"
+    "\n"
+    "import google.api_core.grpc_helpers\n",
+)
+s.replace(
+    "google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py",
+    "from google.cloud.spanner_v1.proto import spanner_pb2_grpc\n",
+    "\g<0>\n\n_SPANNER_GRPC_CONFIG = 'spanner.grpc.config'\n",
+)
+
+s.replace(
+    "google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py",
+    "(\s+)return google.api_core.grpc_helpers.create_channel\(\n",
+    "\g<1>grpc_gcp_config = grpc_gcp.api_config_from_text_pb("
+    "\g<1>    pkg_resources.resource_string(__name__, _SPANNER_GRPC_CONFIG))"
+    "\g<1>options = [(grpc_gcp.API_CONFIG_CHANNEL_ARG, grpc_gcp_config)]"
+    "\g<0>",
+)
+s.replace(
+    "tests/unit/gapic/v1/test_spanner_client_v1.py",
+    "from google.cloud import spanner_v1",
+    "from google.cloud.spanner_v1.gapic import spanner_client as spanner_v1",
+)
+
+# ----------------------------------------------------------------------------
+# Generate instance admin client
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "spanner_admin_instance",
+    "v1",
+    config_path="/google/spanner/admin/instance" "/artman_spanner_admin_instance.yaml",
+    artman_output_name="spanner-admin-instance-v1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/spanner_admin_instance_v1/gapic")
+s.move(library / "google/cloud/spanner_admin_instance_v1/proto")
+s.move(library / "tests")
+
+# Fix up the _GAPIC_LIBRARY_VERSION targets
+s.replace(
+    "google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py",
+    "'google-cloud-spanner-admin-instance'",
+    "'google-cloud-spanner'",
+)
+
+# Fix up generated imports
+s.replace(
+    "google/**/*.py",
+    "from google\.cloud\.spanner\.admin\.instance_v1.proto",
+    "from google.cloud.spanner_admin_instance_v1.proto",
+)
+
+# Fix docstrings
+s.replace("google/cloud/spanner_v1/proto/transaction_pb2.py", r"""====*""", r"")
+s.replace("google/cloud/spanner_v1/proto/transaction_pb2.py", r"""----*""", r"")
+s.replace("google/cloud/spanner_v1/proto/transaction_pb2.py", r"""~~~~*""", r"")
+
+# ----------------------------------------------------------------------------
+# Generate database admin client
+# ----------------------------------------------------------------------------
+library = gapic.py_library(
+    "spanner_admin_database",
+    "v1",
+    config_path="/google/spanner/admin/database" "/artman_spanner_admin_database.yaml",
+    artman_output_name="spanner-admin-database-v1",
+    include_protos=True,
+)
+
+s.move(library / "google/cloud/spanner_admin_database_v1/gapic")
+s.move(library / "google/cloud/spanner_admin_database_v1/proto")
+s.move(library / "tests")
+
+# Fix up the _GAPIC_LIBRARY_VERSION targets
+s.replace(
+    "google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py",
+    "'google-cloud-spanner-admin-database'",
+    "'google-cloud-spanner'",
+)
+
+# Fix up the _GAPIC_LIBRARY_VERSION targets
+s.replace(
+    "google/**/*.py",
+    "from google\.cloud\.spanner\.admin\.database_v1.proto",
+    "from google.cloud.spanner_admin_database_v1.proto",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+# Template's MANIFEST.in does not include the needed GAPIC config file.
+# See PR #6928.
+s.replace(
+    "MANIFEST.in",
+    "include README.rst LICENSE\n",
+    "include README.rst LICENSE\n"
+    "include google/cloud/spanner_v1/gapic/transports/spanner.grpc.config\n",
+)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/spanner/tests/__init__.py b/spanner/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/tests/_fixtures.py b/spanner/tests/_fixtures.py
new file mode 100644
index 000000000000..d0b78c0ba506
--- /dev/null
+++ b/spanner/tests/_fixtures.py
@@ -0,0 +1,68 @@
+# Copyright 2016 Google LLC 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.
+
+"""Test fixtures."""
+
+
+DDL = """\
+CREATE TABLE contacts (
+    contact_id INT64,
+    first_name STRING(1024),
+    last_name STRING(1024),
+    email STRING(1024) )
+    PRIMARY KEY (contact_id);
+CREATE TABLE contact_phones (
+    contact_id INT64,
+    phone_type STRING(1024),
+    phone_number STRING(1024) )
+    PRIMARY KEY (contact_id, phone_type),
+    INTERLEAVE IN PARENT contacts ON DELETE CASCADE;
+CREATE TABLE all_types (
+    pkey INT64 NOT NULL,
+    int_value INT64,
+    int_array ARRAY<INT64>,
+    bool_value BOOL,
+    bool_array ARRAY<BOOL>,
+    bytes_value BYTES(16),
+    bytes_array ARRAY<BYTES(16)>,
+    date_value DATE,
+    date_array ARRAY<DATE>,
+    float_value FLOAT64,
+    float_array ARRAY<FLOAT64>,
+    string_value STRING(16),
+    string_array ARRAY<STRING(16)>,
+    timestamp_value TIMESTAMP,
+    timestamp_array ARRAY<TIMESTAMP>)
+    PRIMARY KEY (pkey);
+CREATE TABLE counters (
+    name STRING(1024),
+    value INT64 )
+    PRIMARY KEY (name);
+CREATE TABLE string_plus_array_of_string (
+    id INT64,
+    name STRING(16),
+    tags ARRAY<STRING(16)> )
+    PRIMARY KEY (id);
+CREATE INDEX name ON contacts(first_name, last_name);
+CREATE TABLE users_history (
+     id INT64 NOT NULL,
+     commit_ts TIMESTAMP NOT NULL OPTIONS
+        (allow_commit_timestamp=true),
+     name STRING(MAX) NOT NULL,
+     email STRING(MAX),
+     deleted BOOL NOT NULL )
+     PRIMARY KEY(id, commit_ts DESC);
+"""
+
+DDL_STATEMENTS = [stmt.strip() for stmt in DDL.split(";") if stmt.strip()]
diff --git a/spanner/tests/system/__init__.py b/spanner/tests/system/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/tests/system/test_system.py b/spanner/tests/system/test_system.py
new file mode 100644
index 000000000000..730190444edf
--- /dev/null
+++ b/spanner/tests/system/test_system.py
@@ -0,0 +1,2179 @@
+# Copyright 2016 Google LLC 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.
+
+import collections
+import datetime
+import math
+import operator
+import os
+import struct
+import threading
+import time
+import unittest
+import uuid
+
+import pytest
+
+from google.api_core import exceptions
+from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+from google.cloud.spanner_v1 import param_types
+from google.cloud.spanner_v1.proto.type_pb2 import ARRAY
+from google.cloud.spanner_v1.proto.type_pb2 import BOOL
+from google.cloud.spanner_v1.proto.type_pb2 import BYTES
+from google.cloud.spanner_v1.proto.type_pb2 import DATE
+from google.cloud.spanner_v1.proto.type_pb2 import FLOAT64
+from google.cloud.spanner_v1.proto.type_pb2 import INT64
+from google.cloud.spanner_v1.proto.type_pb2 import STRING
+from google.cloud.spanner_v1.proto.type_pb2 import TIMESTAMP
+from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+from google.cloud._helpers import UTC
+from google.cloud.spanner import Client
+from google.cloud.spanner import KeyRange
+from google.cloud.spanner import KeySet
+from google.cloud.spanner import BurstyPool
+from google.cloud.spanner import COMMIT_TIMESTAMP
+
+from test_utils.retry import RetryErrors
+from test_utils.retry import RetryInstanceState
+from test_utils.retry import RetryResult
+from test_utils.system import unique_resource_id
+from tests._fixtures import DDL_STATEMENTS
+
+
+CREATE_INSTANCE = os.getenv("GOOGLE_CLOUD_TESTS_CREATE_SPANNER_INSTANCE") is not None
+
+if CREATE_INSTANCE:
+    INSTANCE_ID = "google-cloud" + unique_resource_id("-")
+else:
+    INSTANCE_ID = os.environ.get(
+        "GOOGLE_CLOUD_TESTS_SPANNER_INSTANCE", "google-cloud-python-systest"
+    )
+EXISTING_INSTANCES = []
+COUNTERS_TABLE = "counters"
+COUNTERS_COLUMNS = ("name", "value")
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    INSTANCE_CONFIG = None
+    INSTANCE = None
+
+
+def _has_all_ddl(database):
+    return len(database.ddl_statements) == len(DDL_STATEMENTS)
+
+
+def _list_instances():
+    return list(Config.CLIENT.list_instances())
+
+
+def setUpModule():
+    Config.CLIENT = Client()
+    retry = RetryErrors(exceptions.ServiceUnavailable)
+
+    configs = list(retry(Config.CLIENT.list_instance_configs)())
+
+    instances = retry(_list_instances)()
+    EXISTING_INSTANCES[:] = instances
+
+    if CREATE_INSTANCE:
+
+        # Defend against back-end returning configs for regions we aren't
+        # actually allowed to use.
+        configs = [config for config in configs if "-us-" in config.name]
+
+        if not configs:
+            raise ValueError("List instance configs failed in module set up.")
+
+        Config.INSTANCE_CONFIG = configs[0]
+        config_name = configs[0].name
+
+        Config.INSTANCE = Config.CLIENT.instance(INSTANCE_ID, config_name)
+        created_op = Config.INSTANCE.create()
+        created_op.result(30)  # block until completion
+
+    else:
+        Config.INSTANCE = Config.CLIENT.instance(INSTANCE_ID)
+        Config.INSTANCE.reload()
+
+
+def tearDownModule():
+    if CREATE_INSTANCE:
+        Config.INSTANCE.delete()
+
+
+class TestInstanceAdminAPI(unittest.TestCase):
+    def setUp(self):
+        self.instances_to_delete = []
+
+    def tearDown(self):
+        for instance in self.instances_to_delete:
+            instance.delete()
+
+    def test_list_instances(self):
+        instances = list(Config.CLIENT.list_instances())
+        # We have added one new instance in `setUpModule`.
+        if CREATE_INSTANCE:
+            self.assertEqual(len(instances), len(EXISTING_INSTANCES) + 1)
+        for instance in instances:
+            instance_existence = (
+                instance in EXISTING_INSTANCES or instance == Config.INSTANCE
+            )
+            self.assertTrue(instance_existence)
+
+    def test_reload_instance(self):
+        # Use same arguments as Config.INSTANCE (created in `setUpModule`)
+        # so we can use reload() on a fresh instance.
+        instance = Config.CLIENT.instance(INSTANCE_ID)
+        # Make sure metadata unset before reloading.
+        instance.display_name = None
+
+        instance.reload()
+        self.assertEqual(instance.display_name, Config.INSTANCE.display_name)
+
+    @unittest.skipUnless(CREATE_INSTANCE, "Skipping instance creation")
+    def test_create_instance(self):
+        ALT_INSTANCE_ID = "new" + unique_resource_id("-")
+        instance = Config.CLIENT.instance(ALT_INSTANCE_ID, Config.INSTANCE_CONFIG.name)
+        operation = instance.create()
+        # Make sure this instance gets deleted after the test case.
+        self.instances_to_delete.append(instance)
+
+        # We want to make sure the operation completes.
+        operation.result(30)  # raises on failure / timeout.
+
+        # Create a new instance instance and make sure it is the same.
+        instance_alt = Config.CLIENT.instance(
+            ALT_INSTANCE_ID, Config.INSTANCE_CONFIG.name
+        )
+        instance_alt.reload()
+
+        self.assertEqual(instance, instance_alt)
+        self.assertEqual(instance.display_name, instance_alt.display_name)
+
+    def test_update_instance(self):
+        OLD_DISPLAY_NAME = Config.INSTANCE.display_name
+        NEW_DISPLAY_NAME = "Foo Bar Baz"
+        Config.INSTANCE.display_name = NEW_DISPLAY_NAME
+        operation = Config.INSTANCE.update()
+
+        # We want to make sure the operation completes.
+        operation.result(30)  # raises on failure / timeout.
+
+        # Create a new instance instance and reload it.
+        instance_alt = Config.CLIENT.instance(INSTANCE_ID, None)
+        self.assertNotEqual(instance_alt.display_name, NEW_DISPLAY_NAME)
+        instance_alt.reload()
+        self.assertEqual(instance_alt.display_name, NEW_DISPLAY_NAME)
+
+        # Make sure to put the instance back the way it was for the
+        # other test cases.
+        Config.INSTANCE.display_name = OLD_DISPLAY_NAME
+        Config.INSTANCE.update()
+
+
+class _TestData(object):
+    TABLE = "contacts"
+    COLUMNS = ("contact_id", "first_name", "last_name", "email")
+    ROW_DATA = (
+        (1, u"Phred", u"Phlyntstone", u"phred@example.com"),
+        (2, u"Bharney", u"Rhubble", u"bharney@example.com"),
+        (3, u"Wylma", u"Phlyntstone", u"wylma@example.com"),
+    )
+    ALL = KeySet(all_=True)
+    SQL = "SELECT * FROM contacts ORDER BY contact_id"
+
+    _recurse_into_lists = True
+
+    def _assert_timestamp(self, value, nano_value):
+        self.assertIsInstance(value, datetime.datetime)
+        self.assertIsNone(value.tzinfo)
+        self.assertIs(nano_value.tzinfo, UTC)
+
+        self.assertEqual(value.year, nano_value.year)
+        self.assertEqual(value.month, nano_value.month)
+        self.assertEqual(value.day, nano_value.day)
+        self.assertEqual(value.hour, nano_value.hour)
+        self.assertEqual(value.minute, nano_value.minute)
+        self.assertEqual(value.second, nano_value.second)
+        self.assertEqual(value.microsecond, nano_value.microsecond)
+        if isinstance(value, DatetimeWithNanoseconds):
+            self.assertEqual(value.nanosecond, nano_value.nanosecond)
+        else:
+            self.assertEqual(value.microsecond * 1000, nano_value.nanosecond)
+
+    def _check_rows_data(self, rows_data, expected=None):
+        if expected is None:
+            expected = self.ROW_DATA
+
+        self.assertEqual(len(rows_data), len(expected))
+        for row, expected in zip(rows_data, expected):
+            self._check_row_data(row, expected)
+
+    def _check_row_data(self, row_data, expected):
+        self.assertEqual(len(row_data), len(expected))
+        for found_cell, expected_cell in zip(row_data, expected):
+            self._check_cell_data(found_cell, expected_cell)
+
+    def _check_cell_data(self, found_cell, expected_cell):
+        if isinstance(found_cell, DatetimeWithNanoseconds):
+            self._assert_timestamp(expected_cell, found_cell)
+        elif isinstance(found_cell, float) and math.isnan(found_cell):
+            self.assertTrue(math.isnan(expected_cell))
+        elif isinstance(found_cell, list) and self._recurse_into_lists:
+            self.assertEqual(len(found_cell), len(expected_cell))
+            for found_item, expected_item in zip(found_cell, expected_cell):
+                self._check_cell_data(found_item, expected_item)
+        else:
+            self.assertEqual(found_cell, expected_cell)
+
+
+class TestDatabaseAPI(unittest.TestCase, _TestData):
+    DATABASE_NAME = "test_database" + unique_resource_id("_")
+
+    @classmethod
+    def setUpClass(cls):
+        pool = BurstyPool(labels={"testcase": "database_api"})
+        cls._db = Config.INSTANCE.database(
+            cls.DATABASE_NAME, ddl_statements=DDL_STATEMENTS, pool=pool
+        )
+        operation = cls._db.create()
+        operation.result(30)  # raises on failure / timeout.
+
+    @classmethod
+    def tearDownClass(cls):
+        cls._db.drop()
+
+    def setUp(self):
+        self.to_delete = []
+
+    def tearDown(self):
+        for doomed in self.to_delete:
+            doomed.drop()
+
+    def test_list_databases(self):
+        # Since `Config.INSTANCE` is newly created in `setUpModule`, the
+        # database created in `setUpClass` here will be the only one.
+        database_names = [
+            database.name for database in Config.INSTANCE.list_databases()
+        ]
+        self.assertTrue(self._db.name in database_names)
+
+    def test_create_database(self):
+        pool = BurstyPool(labels={"testcase": "create_database"})
+        temp_db_id = "temp_db" + unique_resource_id("_")
+        temp_db = Config.INSTANCE.database(temp_db_id, pool=pool)
+        operation = temp_db.create()
+        self.to_delete.append(temp_db)
+
+        # We want to make sure the operation completes.
+        operation.result(30)  # raises on failure / timeout.
+
+        database_ids = [
+            database.database_id for database in Config.INSTANCE.list_databases()
+        ]
+        self.assertIn(temp_db_id, database_ids)
+
+    def test_table_not_found(self):
+        temp_db_id = "temp_db" + unique_resource_id("_")
+
+        correct_table = "MyTable"
+        incorrect_table = "NotMyTable"
+        self.assertNotEqual(correct_table, incorrect_table)
+
+        create_table = (
+            "CREATE TABLE {} (\n"
+            "    Id      STRING(36) NOT NULL,\n"
+            "    Field1  STRING(36) NOT NULL\n"
+            ") PRIMARY KEY (Id)"
+        ).format(correct_table)
+        index = "CREATE INDEX IDX ON {} (Field1)".format(incorrect_table)
+
+        temp_db = Config.INSTANCE.database(
+            temp_db_id, ddl_statements=[create_table, index]
+        )
+        self.to_delete.append(temp_db)
+        with self.assertRaises(exceptions.NotFound) as exc_info:
+            temp_db.create()
+
+        expected = "Table not found: {0}".format(incorrect_table)
+        self.assertEqual(exc_info.exception.args, (expected,))
+
+    @pytest.mark.skip(
+        reason=(
+            "update_dataset_ddl() has a flaky timeout"
+            "https://github.com/GoogleCloudPlatform/google-cloud-python/issues/"
+            "5629"
+        )
+    )
+    def test_update_database_ddl_with_operation_id(self):
+        pool = BurstyPool(labels={"testcase": "update_database_ddl"})
+        temp_db_id = "temp_db" + unique_resource_id("_")
+        temp_db = Config.INSTANCE.database(temp_db_id, pool=pool)
+        create_op = temp_db.create()
+        self.to_delete.append(temp_db)
+
+        # We want to make sure the operation completes.
+        create_op.result(240)  # raises on failure / timeout.
+        # random but shortish always start with letter
+        operation_id = "a" + str(uuid.uuid4())[:8]
+        operation = temp_db.update_ddl(DDL_STATEMENTS, operation_id=operation_id)
+
+        self.assertEqual(operation_id, operation.operation.name.split("/")[-1])
+
+        # We want to make sure the operation completes.
+        operation.result(240)  # raises on failure / timeout.
+
+        temp_db.reload()
+
+        self.assertEqual(len(temp_db.ddl_statements), len(DDL_STATEMENTS))
+
+    def test_db_batch_insert_then_db_snapshot_read(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+            batch.insert(self.TABLE, self.COLUMNS, self.ROW_DATA)
+
+        with self._db.snapshot(read_timestamp=batch.committed) as snapshot:
+            from_snap = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL))
+
+        self._check_rows_data(from_snap)
+
+    def test_db_run_in_transaction_then_snapshot_execute_sql(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        def _unit_of_work(transaction, test):
+            rows = list(transaction.read(test.TABLE, test.COLUMNS, self.ALL))
+            test.assertEqual(rows, [])
+
+            transaction.insert_or_update(test.TABLE, test.COLUMNS, test.ROW_DATA)
+
+        self._db.run_in_transaction(_unit_of_work, test=self)
+
+        with self._db.snapshot() as after:
+            rows = list(after.execute_sql(self.SQL))
+        self._check_rows_data(rows)
+
+    def test_db_run_in_transaction_twice(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        def _unit_of_work(transaction, test):
+            transaction.insert_or_update(test.TABLE, test.COLUMNS, test.ROW_DATA)
+
+        self._db.run_in_transaction(_unit_of_work, test=self)
+        self._db.run_in_transaction(_unit_of_work, test=self)
+
+        with self._db.snapshot() as after:
+            rows = list(after.execute_sql(self.SQL))
+        self._check_rows_data(rows)
+
+    def test_db_run_in_transaction_twice_4181(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(COUNTERS_TABLE, self.ALL)
+
+        def _unit_of_work(transaction, name):
+            transaction.insert(COUNTERS_TABLE, COUNTERS_COLUMNS, [[name, 0]])
+
+        self._db.run_in_transaction(_unit_of_work, name="id_1")
+
+        with self.assertRaises(exceptions.AlreadyExists):
+            self._db.run_in_transaction(_unit_of_work, name="id_1")
+
+        self._db.run_in_transaction(_unit_of_work, name="id_2")
+
+        with self._db.snapshot() as after:
+            rows = list(after.read(COUNTERS_TABLE, COUNTERS_COLUMNS, self.ALL))
+        self.assertEqual(len(rows), 2)
+
+
+SOME_DATE = datetime.date(2011, 1, 17)
+SOME_TIME = datetime.datetime(1989, 1, 17, 17, 59, 12, 345612)
+NANO_TIME = DatetimeWithNanoseconds(1995, 8, 31, nanosecond=987654321)
+POS_INF = float("+inf")
+NEG_INF = float("-inf")
+OTHER_NAN, = struct.unpack("<d", b"\x01\x00\x01\x00\x00\x00\xf8\xff")
+BYTES_1 = b"Ymlu"
+BYTES_2 = b"Ym9vdHM="
+ALL_TYPES_TABLE = "all_types"
+ALL_TYPES_COLUMNS = (
+    "pkey",
+    "int_value",
+    "int_array",
+    "bool_value",
+    "bool_array",
+    "bytes_value",
+    "bytes_array",
+    "date_value",
+    "date_array",
+    "float_value",
+    "float_array",
+    "string_value",
+    "string_array",
+    "timestamp_value",
+    "timestamp_array",
+)
+AllTypesRowData = collections.namedtuple("AllTypesRowData", ALL_TYPES_COLUMNS)
+AllTypesRowData.__new__.__defaults__ = tuple([None for colum in ALL_TYPES_COLUMNS])
+
+ALL_TYPES_ROWDATA = (
+    # all nulls
+    AllTypesRowData(pkey=0),
+    # Non-null values
+    AllTypesRowData(pkey=101, int_value=123),
+    AllTypesRowData(pkey=102, bool_value=False),
+    AllTypesRowData(pkey=103, bytes_value=BYTES_1),
+    AllTypesRowData(pkey=104, date_value=SOME_DATE),
+    AllTypesRowData(pkey=105, float_value=1.4142136),
+    AllTypesRowData(pkey=106, string_value=u"VALUE"),
+    AllTypesRowData(pkey=107, timestamp_value=SOME_TIME),
+    AllTypesRowData(pkey=108, timestamp_value=NANO_TIME),
+    # empty array values
+    AllTypesRowData(pkey=201, int_array=[]),
+    AllTypesRowData(pkey=202, bool_array=[]),
+    AllTypesRowData(pkey=203, bytes_array=[]),
+    AllTypesRowData(pkey=204, date_array=[]),
+    AllTypesRowData(pkey=205, float_array=[]),
+    AllTypesRowData(pkey=206, string_array=[]),
+    AllTypesRowData(pkey=207, timestamp_array=[]),
+    # non-empty array values, including nulls
+    AllTypesRowData(pkey=301, int_array=[123, 456, None]),
+    AllTypesRowData(pkey=302, bool_array=[True, False, None]),
+    AllTypesRowData(pkey=303, bytes_array=[BYTES_1, BYTES_2, None]),
+    AllTypesRowData(pkey=304, date_array=[SOME_DATE, None]),
+    AllTypesRowData(pkey=305, float_array=[3.1415926, 2.71828, None]),
+    AllTypesRowData(pkey=306, string_array=[u"One", u"Two", None]),
+    AllTypesRowData(pkey=307, timestamp_array=[SOME_TIME, NANO_TIME, None]),
+)
+
+
+class TestSessionAPI(unittest.TestCase, _TestData):
+    DATABASE_NAME = "test_sessions" + unique_resource_id("_")
+
+    @classmethod
+    def setUpClass(cls):
+        pool = BurstyPool(labels={"testcase": "session_api"})
+        cls._db = Config.INSTANCE.database(
+            cls.DATABASE_NAME, ddl_statements=DDL_STATEMENTS, pool=pool
+        )
+        operation = cls._db.create()
+        operation.result(30)  # raises on failure / timeout.
+
+    @classmethod
+    def tearDownClass(cls):
+        cls._db.drop()
+
+    def setUp(self):
+        self.to_delete = []
+
+    def tearDown(self):
+        for doomed in self.to_delete:
+            doomed.delete()
+
+    def test_session_crud(self):
+        retry_true = RetryResult(operator.truth)
+        retry_false = RetryResult(operator.not_)
+        session = self._db.session()
+        self.assertFalse(session.exists())
+        session.create()
+        retry_true(session.exists)()
+        session.delete()
+        retry_false(session.exists)()
+
+    def test_batch_insert_then_read(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+            batch.insert(self.TABLE, self.COLUMNS, self.ROW_DATA)
+
+        with self._db.snapshot(read_timestamp=batch.committed) as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows)
+
+    def test_batch_insert_then_read_string_array_of_string(self):
+        TABLE = "string_plus_array_of_string"
+        COLUMNS = ["id", "name", "tags"]
+        ROWDATA = [
+            (0, None, None),
+            (1, "phred", ["yabba", "dabba", "do"]),
+            (2, "bharney", []),
+            (3, "wylma", ["oh", None, "phred"]),
+        ]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(TABLE, self.ALL)
+            batch.insert(TABLE, COLUMNS, ROWDATA)
+
+        with self._db.snapshot(read_timestamp=batch.committed) as snapshot:
+            rows = list(snapshot.read(TABLE, COLUMNS, self.ALL))
+        self._check_rows_data(rows, expected=ROWDATA)
+
+    def test_batch_insert_then_read_all_datatypes(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(ALL_TYPES_TABLE, self.ALL)
+            batch.insert(ALL_TYPES_TABLE, ALL_TYPES_COLUMNS, ALL_TYPES_ROWDATA)
+
+        with self._db.snapshot(read_timestamp=batch.committed) as snapshot:
+            rows = list(snapshot.read(ALL_TYPES_TABLE, ALL_TYPES_COLUMNS, self.ALL))
+        self._check_rows_data(rows, expected=ALL_TYPES_ROWDATA)
+
+    def test_batch_insert_or_update_then_query(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.insert_or_update(self.TABLE, self.COLUMNS, self.ROW_DATA)
+
+        with self._db.snapshot(read_timestamp=batch.committed) as snapshot:
+            rows = list(snapshot.execute_sql(self.SQL))
+        self._check_rows_data(rows)
+
+    def test_batch_insert_w_commit_timestamp(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        table = "users_history"
+        columns = ["id", "commit_ts", "name", "email", "deleted"]
+        user_id = 1234
+        name = "phred"
+        email = "phred@example.com"
+        row_data = [[user_id, COMMIT_TIMESTAMP, name, email, False]]
+
+        with self._db.batch() as batch:
+            batch.delete(table, self.ALL)
+            batch.insert(table, columns, row_data)
+
+        with self._db.snapshot(read_timestamp=batch.committed) as snapshot:
+            rows = list(snapshot.read(table, columns, self.ALL))
+
+        self.assertEqual(len(rows), 1)
+        r_id, commit_ts, r_name, r_email, deleted = rows[0]
+        self.assertEqual(r_id, user_id)
+        self.assertEqual(commit_ts, batch.committed)
+        self.assertEqual(r_name, name)
+        self.assertEqual(r_email, email)
+        self.assertFalse(deleted)
+
+    @RetryErrors(exception=exceptions.ServerError)
+    @RetryErrors(exception=exceptions.Aborted)
+    def test_transaction_read_and_insert_then_rollback(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with self._db.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        transaction = session.transaction()
+        transaction.begin()
+
+        rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+        self.assertEqual(rows, [])
+
+        transaction.insert(self.TABLE, self.COLUMNS, self.ROW_DATA)
+
+        # Inserted rows can't be read until after commit.
+        rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+        self.assertEqual(rows, [])
+        transaction.rollback()
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self.assertEqual(rows, [])
+
+    def _transaction_read_then_raise(self, transaction):
+        rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+        self.assertEqual(len(rows), 0)
+        transaction.insert(self.TABLE, self.COLUMNS, self.ROW_DATA)
+        raise CustomException()
+
+    @RetryErrors(exception=exceptions.ServerError)
+    @RetryErrors(exception=exceptions.Conflict)
+    def test_transaction_read_and_insert_then_exception(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        with self.assertRaises(CustomException):
+            self._db.run_in_transaction(self._transaction_read_then_raise)
+
+        # Transaction was rolled back.
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL))
+        self.assertEqual(rows, [])
+
+    @RetryErrors(exception=exceptions.ServerError)
+    @RetryErrors(exception=exceptions.Conflict)
+    def test_transaction_read_and_insert_or_update_then_commit(self):
+        # [START spanner_test_dml_read_your_writes]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        with session.transaction() as transaction:
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+            transaction.insert_or_update(self.TABLE, self.COLUMNS, self.ROW_DATA)
+
+            # Inserted rows can't be read until after commit.
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows)
+        # [END spanner_test_dml_read_your_writes]
+
+    def _generate_insert_statements(self):
+        insert_template = "INSERT INTO {table} ({column_list}) " "VALUES ({row_data})"
+        for row in self.ROW_DATA:
+            yield insert_template.format(
+                table=self.TABLE,
+                column_list=", ".join(self.COLUMNS),
+                row_data='{}, "{}", "{}", "{}"'.format(*row),
+            )
+
+    @RetryErrors(exception=exceptions.ServerError)
+    @RetryErrors(exception=exceptions.Conflict)
+    def test_transaction_execute_sql_w_dml_read_rollback(self):
+        # [START spanner_test_dml_rollback_txn_not_committed]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        transaction = session.transaction()
+        transaction.begin()
+
+        rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+        self.assertEqual(rows, [])
+
+        for insert_statement in self._generate_insert_statements():
+            result = transaction.execute_sql(insert_statement)
+            list(result)  # iterate to get stats
+            self.assertEqual(result.stats.row_count_exact, 1)
+
+        # Rows inserted via DML *can* be read before commit.
+        during_rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(during_rows)
+
+        transaction.rollback()
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows, [])
+        # [END spanner_test_dml_rollback_txn_not_committed]
+
+    @RetryErrors(exception=exceptions.ServerError)
+    @RetryErrors(exception=exceptions.Conflict)
+    def test_transaction_execute_update_read_commit(self):
+        # [START spanner_test_dml_read_your_writes]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        with session.transaction() as transaction:
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+            for insert_statement in self._generate_insert_statements():
+                row_count = transaction.execute_update(insert_statement)
+                self.assertEqual(row_count, 1)
+
+            # Rows inserted via DML *can* be read before commit.
+            during_rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_rows_data(during_rows)
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows)
+        # [END spanner_test_dml_read_your_writes]
+
+    @RetryErrors(exception=exceptions.ServerError)
+    @RetryErrors(exception=exceptions.Conflict)
+    def test_transaction_execute_update_then_insert_commit(self):
+        # [START spanner_test_dml_with_mutation]
+        # [START spanner_test_dml_update]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        insert_statement = list(self._generate_insert_statements())[0]
+
+        with session.transaction() as transaction:
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+            row_count = transaction.execute_update(insert_statement)
+            self.assertEqual(row_count, 1)
+
+            transaction.insert(self.TABLE, self.COLUMNS, self.ROW_DATA[1:])
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows)
+        # [END spanner_test_dml_update]
+        # [END spanner_test_dml_with_mutation]
+
+    def test_transaction_batch_update_success(self):
+        # [START spanner_test_dml_with_mutation]
+        # [START spanner_test_dml_update]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        insert_statement = list(self._generate_insert_statements())[0]
+        update_statement = (
+            "UPDATE contacts SET email = @email " "WHERE contact_id = @contact_id;",
+            {"contact_id": 1, "email": "phreddy@example.com"},
+            {"contact_id": Type(code=INT64), "email": Type(code=STRING)},
+        )
+        delete_statement = (
+            "DELETE contacts WHERE contact_id = @contact_id;",
+            {"contact_id": 1},
+            {"contact_id": Type(code=INT64)},
+        )
+
+        def unit_of_work(transaction, self):
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+            status, row_counts = transaction.batch_update(
+                [insert_statement, update_statement, delete_statement]
+            )
+            self.assertEqual(status.code, 0)  # XXX: where are values defined?
+            self.assertEqual(len(row_counts), 3)
+            for row_count in row_counts:
+                self.assertEqual(row_count, 1)
+
+        session.run_in_transaction(unit_of_work, self)
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows, [])
+        # [END spanner_test_dml_with_mutation]
+        # [END spanner_test_dml_update]
+
+    def test_transaction_batch_update_and_execute_dml(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        insert_statements = list(self._generate_insert_statements())
+        update_statements = [
+            (
+                "UPDATE contacts SET email = @email " "WHERE contact_id = @contact_id;",
+                {"contact_id": 1, "email": "phreddy@example.com"},
+                {"contact_id": Type(code=INT64), "email": Type(code=STRING)},
+            )
+        ]
+
+        delete_statement = "DELETE contacts WHERE TRUE;"
+
+        def unit_of_work(transaction, self):
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+            status, row_counts = transaction.batch_update(
+                insert_statements + update_statements
+            )
+            self.assertEqual(status.code, 0)  # XXX: where are values defined?
+            self.assertEqual(len(row_counts), len(insert_statements) + 1)
+            for row_count in row_counts:
+                self.assertEqual(row_count, 1)
+
+            row_count = transaction.execute_update(delete_statement)
+
+            self.assertEqual(row_count, len(insert_statements))
+
+        session.run_in_transaction(unit_of_work, self)
+
+        rows = list(session.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(rows, [])
+
+    def test_transaction_batch_update_w_syntax_error(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.batch() as batch:
+            batch.delete(self.TABLE, self.ALL)
+
+        insert_statement = list(self._generate_insert_statements())[0]
+        update_statement = (
+            "UPDTAE contacts SET email = @email " "WHERE contact_id = @contact_id;",
+            {"contact_id": 1, "email": "phreddy@example.com"},
+            {"contact_id": Type(code=INT64), "email": Type(code=STRING)},
+        )
+        delete_statement = (
+            "DELETE contacts WHERE contact_id = @contact_id;",
+            {"contact_id": 1},
+            {"contact_id": Type(code=INT64)},
+        )
+
+        with session.transaction() as transaction:
+            rows = list(transaction.read(self.TABLE, self.COLUMNS, self.ALL))
+            self.assertEqual(rows, [])
+
+            status, row_counts = transaction.batch_update(
+                [insert_statement, update_statement, delete_statement]
+            )
+
+        self.assertEqual(status.code, 3)  # XXX: where are values defined?
+        self.assertEqual(len(row_counts), 1)
+        for row_count in row_counts:
+            self.assertEqual(row_count, 1)
+
+    def test_transaction_batch_update_wo_statements(self):
+        from google.api_core.exceptions import InvalidArgument
+
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        session = self._db.session()
+        session.create()
+        self.to_delete.append(session)
+
+        with session.transaction() as transaction:
+            with self.assertRaises(InvalidArgument):
+                transaction.batch_update([])
+
+    def test_execute_partitioned_dml(self):
+        # [START spanner_test_dml_partioned_dml_update]
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        delete_statement = "DELETE FROM {} WHERE true".format(self.TABLE)
+
+        def _setup_table(txn):
+            txn.execute_update(delete_statement)
+            for insert_statement in self._generate_insert_statements():
+                txn.execute_update(insert_statement)
+
+        committed = self._db.run_in_transaction(_setup_table)
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            before_pdml = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL))
+
+        self._check_rows_data(before_pdml)
+
+        nonesuch = "nonesuch@example.com"
+        target = "phred@example.com"
+        update_statement = (
+            "UPDATE {table} SET {table}.email = @email " "WHERE {table}.email = @target"
+        ).format(table=self.TABLE)
+
+        row_count = self._db.execute_partitioned_dml(
+            update_statement,
+            params={"email": nonesuch, "target": target},
+            param_types={"email": Type(code=STRING), "target": Type(code=STRING)},
+        )
+        self.assertEqual(row_count, 1)
+
+        row = self.ROW_DATA[0]
+        updated = [row[:3] + (nonesuch,)] + list(self.ROW_DATA[1:])
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            after_update = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL))
+        self._check_rows_data(after_update, updated)
+
+        row_count = self._db.execute_partitioned_dml(delete_statement)
+        self.assertEqual(row_count, len(self.ROW_DATA))
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            after_delete = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL))
+
+        self._check_rows_data(after_delete, [])
+        # [END spanner_test_dml_partioned_dml_update]
+
+    def _transaction_concurrency_helper(self, unit_of_work, pkey):
+        INITIAL_VALUE = 123
+        NUM_THREADS = 3  # conforms to equivalent Java systest.
+
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        with self._db.batch() as batch:
+            batch.insert_or_update(
+                COUNTERS_TABLE, COUNTERS_COLUMNS, [[pkey, INITIAL_VALUE]]
+            )
+
+        # We don't want to run the threads' transactions in the current
+        # session, which would fail.
+        txn_sessions = []
+
+        for _ in range(NUM_THREADS):
+            txn_sessions.append(self._db)
+
+        threads = [
+            threading.Thread(
+                target=txn_session.run_in_transaction, args=(unit_of_work, pkey)
+            )
+            for txn_session in txn_sessions
+        ]
+
+        for thread in threads:
+            thread.start()
+
+        for thread in threads:
+            thread.join()
+
+        with self._db.snapshot() as snapshot:
+            keyset = KeySet(keys=[(pkey,)])
+            rows = list(snapshot.read(COUNTERS_TABLE, COUNTERS_COLUMNS, keyset))
+            self.assertEqual(len(rows), 1)
+            _, value = rows[0]
+            self.assertEqual(value, INITIAL_VALUE + len(threads))
+
+    def _read_w_concurrent_update(self, transaction, pkey):
+        keyset = KeySet(keys=[(pkey,)])
+        rows = list(transaction.read(COUNTERS_TABLE, COUNTERS_COLUMNS, keyset))
+        self.assertEqual(len(rows), 1)
+        pkey, value = rows[0]
+        transaction.update(COUNTERS_TABLE, COUNTERS_COLUMNS, [[pkey, value + 1]])
+
+    def test_transaction_read_w_concurrent_updates(self):
+        PKEY = "read_w_concurrent_updates"
+        self._transaction_concurrency_helper(self._read_w_concurrent_update, PKEY)
+
+    def _query_w_concurrent_update(self, transaction, pkey):
+        SQL = "SELECT * FROM counters WHERE name = @name"
+        rows = list(
+            transaction.execute_sql(
+                SQL, params={"name": pkey}, param_types={"name": Type(code=STRING)}
+            )
+        )
+        self.assertEqual(len(rows), 1)
+        pkey, value = rows[0]
+        transaction.update(COUNTERS_TABLE, COUNTERS_COLUMNS, [[pkey, value + 1]])
+
+    def test_transaction_query_w_concurrent_updates(self):
+        PKEY = "query_w_concurrent_updates"
+        self._transaction_concurrency_helper(self._query_w_concurrent_update, PKEY)
+
+    def test_transaction_read_w_abort(self):
+        retry = RetryInstanceState(_has_all_ddl)
+        retry(self._db.reload)()
+
+        trigger = _ReadAbortTrigger()
+
+        with self._db.batch() as batch:
+            batch.delete(COUNTERS_TABLE, self.ALL)
+            batch.insert(
+                COUNTERS_TABLE, COUNTERS_COLUMNS, [[trigger.KEY1, 0], [trigger.KEY2, 0]]
+            )
+
+        provoker = threading.Thread(target=trigger.provoke_abort, args=(self._db,))
+        handler = threading.Thread(target=trigger.handle_abort, args=(self._db,))
+
+        provoker.start()
+        trigger.provoker_started.wait()
+
+        handler.start()
+        trigger.handler_done.wait()
+
+        provoker.join()
+        handler.join()
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(COUNTERS_TABLE, COUNTERS_COLUMNS, self.ALL))
+            self._check_row_data(rows, expected=[[trigger.KEY1, 1], [trigger.KEY2, 1]])
+
+    @staticmethod
+    def _row_data(max_index):
+        for index in range(max_index):
+            yield [
+                index,
+                "First%09d" % (index,),
+                "Last%09d" % (max_index - index),
+                "test-%09d@example.com" % (index,),
+            ]
+
+    def _set_up_table(self, row_count, database=None):
+        if database is None:
+            database = self._db
+            retry = RetryInstanceState(_has_all_ddl)
+            retry(database.reload)()
+
+        def _unit_of_work(transaction, test):
+            transaction.delete(test.TABLE, test.ALL)
+            transaction.insert(test.TABLE, test.COLUMNS, test._row_data(row_count))
+
+        committed = database.run_in_transaction(_unit_of_work, test=self)
+
+        return committed
+
+    def test_read_with_single_keys_index(self):
+        # [START spanner_test_single_key_index_read]
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        self._set_up_table(row_count)
+
+        expected = [[row[1], row[2]] for row in self._row_data(row_count)]
+        row = 5
+        keyset = [[expected[row][0], expected[row][1]]]
+        with self._db.snapshot() as snapshot:
+            results_iter = snapshot.read(
+                self.TABLE, columns, KeySet(keys=keyset), index="name"
+            )
+            rows = list(results_iter)
+            self.assertEqual(rows, [expected[row]])
+        # [END spanner_test_single_key_index_read]
+
+    def test_empty_read_with_single_keys_index(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        self._set_up_table(row_count)
+        keyset = [["Non", "Existent"]]
+        with self._db.snapshot() as snapshot:
+            results_iter = snapshot.read(
+                self.TABLE, columns, KeySet(keys=keyset), index="name"
+            )
+            rows = list(results_iter)
+            self.assertEqual(rows, [])
+
+    def test_read_with_multiple_keys_index(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        self._set_up_table(row_count)
+        expected = [[row[1], row[2]] for row in self._row_data(row_count)]
+        with self._db.snapshot() as snapshot:
+            rows = list(
+                snapshot.read(self.TABLE, columns, KeySet(keys=expected), index="name")
+            )
+            self.assertEqual(rows, expected)
+
+    def test_snapshot_read_w_various_staleness(self):
+        from datetime import datetime
+        from google.cloud._helpers import UTC
+
+        ROW_COUNT = 400
+        committed = self._set_up_table(ROW_COUNT)
+        all_data_rows = list(self._row_data(ROW_COUNT))
+
+        before_reads = datetime.utcnow().replace(tzinfo=UTC)
+
+        # Test w/ read timestamp
+        with self._db.snapshot(read_timestamp=committed) as read_tx:
+            rows = list(read_tx.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(rows, all_data_rows)
+
+        # Test w/ min read timestamp
+        with self._db.snapshot(min_read_timestamp=committed) as min_read_ts:
+            rows = list(min_read_ts.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(rows, all_data_rows)
+
+        staleness = datetime.utcnow().replace(tzinfo=UTC) - before_reads
+
+        # Test w/ max staleness
+        with self._db.snapshot(max_staleness=staleness) as max_staleness:
+            rows = list(max_staleness.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(rows, all_data_rows)
+
+        # Test w/ exact staleness
+        with self._db.snapshot(exact_staleness=staleness) as exact_staleness:
+            rows = list(exact_staleness.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(rows, all_data_rows)
+
+        # Test w/ strong
+        with self._db.snapshot() as strong:
+            rows = list(strong.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(rows, all_data_rows)
+
+    def test_multiuse_snapshot_read_isolation_strong(self):
+        ROW_COUNT = 40
+        self._set_up_table(ROW_COUNT)
+        all_data_rows = list(self._row_data(ROW_COUNT))
+        with self._db.snapshot(multi_use=True) as strong:
+            before = list(strong.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(before, all_data_rows)
+
+            with self._db.batch() as batch:
+                batch.delete(self.TABLE, self.ALL)
+
+            after = list(strong.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(after, all_data_rows)
+
+    def test_multiuse_snapshot_read_isolation_read_timestamp(self):
+        ROW_COUNT = 40
+        committed = self._set_up_table(ROW_COUNT)
+        all_data_rows = list(self._row_data(ROW_COUNT))
+
+        with self._db.snapshot(read_timestamp=committed, multi_use=True) as read_ts:
+
+            before = list(read_ts.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(before, all_data_rows)
+
+            with self._db.batch() as batch:
+                batch.delete(self.TABLE, self.ALL)
+
+            after = list(read_ts.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(after, all_data_rows)
+
+    def test_multiuse_snapshot_read_isolation_exact_staleness(self):
+        ROW_COUNT = 40
+
+        self._set_up_table(ROW_COUNT)
+        all_data_rows = list(self._row_data(ROW_COUNT))
+
+        time.sleep(1)
+        delta = datetime.timedelta(microseconds=1000)
+
+        with self._db.snapshot(exact_staleness=delta, multi_use=True) as exact:
+
+            before = list(exact.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(before, all_data_rows)
+
+            with self._db.batch() as batch:
+                batch.delete(self.TABLE, self.ALL)
+
+            after = list(exact.read(self.TABLE, self.COLUMNS, self.ALL))
+            self._check_row_data(after, all_data_rows)
+
+    def test_read_w_index(self):
+        ROW_COUNT = 2000
+        # Indexed reads cannot return non-indexed columns
+        MY_COLUMNS = self.COLUMNS[0], self.COLUMNS[2]
+        EXTRA_DDL = ["CREATE INDEX contacts_by_last_name ON contacts(last_name)"]
+        pool = BurstyPool(labels={"testcase": "read_w_index"})
+        temp_db = Config.INSTANCE.database(
+            "test_read" + unique_resource_id("_"),
+            ddl_statements=DDL_STATEMENTS + EXTRA_DDL,
+            pool=pool,
+        )
+        operation = temp_db.create()
+        self.to_delete.append(_DatabaseDropper(temp_db))
+
+        # We want to make sure the operation completes.
+        operation.result(30)  # raises on failure / timeout.
+        committed = self._set_up_table(ROW_COUNT, database=temp_db)
+
+        with temp_db.snapshot(read_timestamp=committed) as snapshot:
+            rows = list(
+                snapshot.read(
+                    self.TABLE, MY_COLUMNS, self.ALL, index="contacts_by_last_name"
+                )
+            )
+
+        expected = list(
+            reversed([(row[0], row[2]) for row in self._row_data(ROW_COUNT)])
+        )
+        self._check_rows_data(rows, expected)
+
+    def test_read_w_single_key(self):
+        # [START spanner_test_single_key_read]
+        ROW_COUNT = 40
+        committed = self._set_up_table(ROW_COUNT)
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, KeySet(keys=[(0,)])))
+
+        all_data_rows = list(self._row_data(ROW_COUNT))
+        expected = [all_data_rows[0]]
+        self._check_row_data(rows, expected)
+        # [END spanner_test_single_key_read]
+
+    def test_empty_read(self):
+        # [START spanner_test_empty_read]
+        ROW_COUNT = 40
+        self._set_up_table(ROW_COUNT)
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, KeySet(keys=[(40,)])))
+        self._check_row_data(rows, [])
+        # [END spanner_test_empty_read]
+
+    def test_read_w_multiple_keys(self):
+        ROW_COUNT = 40
+        indices = [0, 5, 17]
+        committed = self._set_up_table(ROW_COUNT)
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            rows = list(
+                snapshot.read(
+                    self.TABLE,
+                    self.COLUMNS,
+                    KeySet(keys=[(index,) for index in indices]),
+                )
+            )
+
+        all_data_rows = list(self._row_data(ROW_COUNT))
+        expected = [row for row in all_data_rows if row[0] in indices]
+        self._check_row_data(rows, expected)
+
+    def test_read_w_limit(self):
+        ROW_COUNT = 3000
+        LIMIT = 100
+        committed = self._set_up_table(ROW_COUNT)
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, self.ALL, limit=LIMIT))
+
+        all_data_rows = list(self._row_data(ROW_COUNT))
+        expected = all_data_rows[:LIMIT]
+        self._check_row_data(rows, expected)
+
+    def test_read_w_ranges(self):
+        ROW_COUNT = 3000
+        START = 1000
+        END = 2000
+        committed = self._set_up_table(ROW_COUNT)
+        with self._db.snapshot(read_timestamp=committed, multi_use=True) as snapshot:
+            all_data_rows = list(self._row_data(ROW_COUNT))
+
+            single_key = KeyRange(start_closed=[START], end_open=[START + 1])
+            keyset = KeySet(ranges=(single_key,))
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+            expected = all_data_rows[START : START + 1]
+            self._check_rows_data(rows, expected)
+
+            closed_closed = KeyRange(start_closed=[START], end_closed=[END])
+            keyset = KeySet(ranges=(closed_closed,))
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+            expected = all_data_rows[START : END + 1]
+            self._check_row_data(rows, expected)
+
+            closed_open = KeyRange(start_closed=[START], end_open=[END])
+            keyset = KeySet(ranges=(closed_open,))
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+            expected = all_data_rows[START:END]
+            self._check_row_data(rows, expected)
+
+            open_open = KeyRange(start_open=[START], end_open=[END])
+            keyset = KeySet(ranges=(open_open,))
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+            expected = all_data_rows[START + 1 : END]
+            self._check_row_data(rows, expected)
+
+            open_closed = KeyRange(start_open=[START], end_closed=[END])
+            keyset = KeySet(ranges=(open_closed,))
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+            expected = all_data_rows[START + 1 : END + 1]
+            self._check_row_data(rows, expected)
+
+    def test_read_partial_range_until_end(self):
+        row_count = 3000
+        start = 1000
+        committed = self._set_up_table(row_count)
+        with self._db.snapshot(read_timestamp=committed, multi_use=True) as snapshot:
+            all_data_rows = list(self._row_data(row_count))
+
+            expected_map = {
+                ("start_closed", "end_closed"): all_data_rows[start:],
+                ("start_closed", "end_open"): [],
+                ("start_open", "end_closed"): all_data_rows[start + 1 :],
+                ("start_open", "end_open"): [],
+            }
+            for start_arg in ("start_closed", "start_open"):
+                for end_arg in ("end_closed", "end_open"):
+                    range_kwargs = {start_arg: [start], end_arg: []}
+                    keyset = KeySet(ranges=(KeyRange(**range_kwargs),))
+
+                    rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+                    expected = expected_map[(start_arg, end_arg)]
+                    self._check_row_data(rows, expected)
+
+    def test_read_partial_range_from_beginning(self):
+        row_count = 3000
+        end = 2000
+        committed = self._set_up_table(row_count)
+
+        all_data_rows = list(self._row_data(row_count))
+
+        expected_map = {
+            ("start_closed", "end_closed"): all_data_rows[: end + 1],
+            ("start_closed", "end_open"): all_data_rows[:end],
+            ("start_open", "end_closed"): [],
+            ("start_open", "end_open"): [],
+        }
+        for start_arg in ("start_closed", "start_open"):
+            for end_arg in ("end_closed", "end_open"):
+                range_kwargs = {start_arg: [], end_arg: [end]}
+                keyset = KeySet(ranges=(KeyRange(**range_kwargs),))
+        with self._db.snapshot(read_timestamp=committed, multi_use=True) as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+            expected = expected_map[(start_arg, end_arg)]
+            self._check_row_data(rows, expected)
+
+    def test_read_with_range_keys_index_single_key(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start = 3
+        krange = KeyRange(start_closed=data[start], end_open=data[start + 1])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            self.assertEqual(rows, data[start : start + 1])
+
+    def test_read_with_range_keys_index_closed_closed(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end = 3, 7
+        krange = KeyRange(start_closed=data[start], end_closed=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            self.assertEqual(rows, data[start : end + 1])
+
+    def test_read_with_range_keys_index_closed_open(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end = 3, 7
+        krange = KeyRange(start_closed=data[start], end_open=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            self.assertEqual(rows, data[start:end])
+
+    def test_read_with_range_keys_index_open_closed(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end = 3, 7
+        krange = KeyRange(start_open=data[start], end_closed=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            self.assertEqual(rows, data[start + 1 : end + 1])
+
+    def test_read_with_range_keys_index_open_open(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end = 3, 7
+        krange = KeyRange(start_open=data[start], end_open=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            self.assertEqual(rows, data[start + 1 : end])
+
+    def test_read_with_range_keys_index_limit_closed_closed(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end, limit = 3, 7, 2
+        krange = KeyRange(start_closed=data[start], end_closed=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(
+                snapshot.read(self.TABLE, columns, keyset, index="name", limit=limit)
+            )
+            expected = data[start : end + 1]
+            self.assertEqual(rows, expected[:limit])
+
+    def test_read_with_range_keys_index_limit_closed_open(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end, limit = 3, 7, 2
+        krange = KeyRange(start_closed=data[start], end_open=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(
+                snapshot.read(self.TABLE, columns, keyset, index="name", limit=limit)
+            )
+            expected = data[start:end]
+            self.assertEqual(rows, expected[:limit])
+
+    def test_read_with_range_keys_index_limit_open_closed(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end, limit = 3, 7, 2
+        krange = KeyRange(start_open=data[start], end_closed=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(
+                snapshot.read(self.TABLE, columns, keyset, index="name", limit=limit)
+            )
+            expected = data[start + 1 : end + 1]
+            self.assertEqual(rows, expected[:limit])
+
+    def test_read_with_range_keys_index_limit_open_open(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        self._set_up_table(row_count)
+        start, end, limit = 3, 7, 2
+        krange = KeyRange(start_open=data[start], end_open=data[end])
+        keyset = KeySet(ranges=(krange,))
+        with self._db.snapshot() as snapshot:
+            rows = list(
+                snapshot.read(self.TABLE, columns, keyset, index="name", limit=limit)
+            )
+            expected = data[start + 1 : end]
+            self.assertEqual(rows, expected[:limit])
+
+    def test_read_with_range_keys_and_index_closed_closed(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+
+        self._set_up_table(row_count)
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        keyrow, start, end = 1, 3, 7
+        closed_closed = KeyRange(start_closed=data[start], end_closed=data[end])
+        keys = [data[keyrow]]
+        keyset = KeySet(keys=keys, ranges=(closed_closed,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            expected = [data[keyrow]] + data[start : end + 1]
+            self.assertEqual(rows, expected)
+
+    def test_read_with_range_keys_and_index_closed_open(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        self._set_up_table(row_count)
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        keyrow, start, end = 1, 3, 7
+        closed_open = KeyRange(start_closed=data[start], end_open=data[end])
+        keys = [data[keyrow]]
+        keyset = KeySet(keys=keys, ranges=(closed_open,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            expected = [data[keyrow]] + data[start:end]
+            self.assertEqual(rows, expected)
+
+    def test_read_with_range_keys_and_index_open_closed(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        self._set_up_table(row_count)
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        keyrow, start, end = 1, 3, 7
+        open_closed = KeyRange(start_open=data[start], end_closed=data[end])
+        keys = [data[keyrow]]
+        keyset = KeySet(keys=keys, ranges=(open_closed,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            expected = [data[keyrow]] + data[start + 1 : end + 1]
+            self.assertEqual(rows, expected)
+
+    def test_read_with_range_keys_and_index_open_open(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        self._set_up_table(row_count)
+        data = [[row[1], row[2]] for row in self._row_data(row_count)]
+        keyrow, start, end = 1, 3, 7
+        open_open = KeyRange(start_open=data[start], end_open=data[end])
+        keys = [data[keyrow]]
+        keyset = KeySet(keys=keys, ranges=(open_open,))
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.read(self.TABLE, columns, keyset, index="name"))
+            expected = [data[keyrow]] + data[start + 1 : end]
+            self.assertEqual(rows, expected)
+
+    def test_partition_read_w_index(self):
+        row_count = 10
+        columns = self.COLUMNS[1], self.COLUMNS[2]
+        committed = self._set_up_table(row_count)
+
+        expected = [[row[1], row[2]] for row in self._row_data(row_count)]
+        union = []
+
+        batch_txn = self._db.batch_snapshot(read_timestamp=committed)
+        batches = batch_txn.generate_read_batches(
+            self.TABLE, columns, KeySet(all_=True), index="name"
+        )
+        for batch in batches:
+            p_results_iter = batch_txn.process(batch)
+            union.extend(list(p_results_iter))
+
+        self.assertEqual(union, expected)
+        batch_txn.close()
+
+    def test_execute_sql_w_manual_consume(self):
+        ROW_COUNT = 3000
+        committed = self._set_up_table(ROW_COUNT)
+
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            streamed = snapshot.execute_sql(self.SQL)
+
+        keyset = KeySet(all_=True)
+        with self._db.snapshot(read_timestamp=committed) as snapshot:
+            rows = list(snapshot.read(self.TABLE, self.COLUMNS, keyset))
+        self.assertEqual(list(streamed), rows)
+        self.assertEqual(streamed._current_row, [])
+        self.assertEqual(streamed._pending_chunk, None)
+
+    def _check_sql_results(
+        self, database, sql, params, param_types, expected, order=True
+    ):
+        if order and "ORDER" not in sql:
+            sql += " ORDER BY pkey"
+        with database.snapshot() as snapshot:
+            rows = list(
+                snapshot.execute_sql(sql, params=params, param_types=param_types)
+            )
+        self._check_rows_data(rows, expected=expected)
+
+    def test_multiuse_snapshot_execute_sql_isolation_strong(self):
+        ROW_COUNT = 40
+        SQL = "SELECT * FROM {}".format(self.TABLE)
+        self._set_up_table(ROW_COUNT)
+        all_data_rows = list(self._row_data(ROW_COUNT))
+        with self._db.snapshot(multi_use=True) as strong:
+
+            before = list(strong.execute_sql(SQL))
+            self._check_row_data(before, all_data_rows)
+
+            with self._db.batch() as batch:
+                batch.delete(self.TABLE, self.ALL)
+
+            after = list(strong.execute_sql(SQL))
+            self._check_row_data(after, all_data_rows)
+
+    def test_execute_sql_returning_array_of_struct(self):
+        SQL = (
+            "SELECT ARRAY(SELECT AS STRUCT C1, C2 "
+            "FROM (SELECT 'a' AS C1, 1 AS C2 "
+            "UNION ALL SELECT 'b' AS C1, 2 AS C2) "
+            "ORDER BY C1 ASC)"
+        )
+        self._check_sql_results(
+            self._db,
+            sql=SQL,
+            params=None,
+            param_types=None,
+            expected=[[[["a", 1], ["b", 2]]]],
+        )
+
+    def test_execute_sql_returning_empty_array_of_struct(self):
+        SQL = (
+            "SELECT ARRAY(SELECT AS STRUCT C1, C2 "
+            "FROM (SELECT 2 AS C1) X "
+            "JOIN (SELECT 1 AS C2) Y "
+            "ON X.C1 = Y.C2 "
+            "ORDER BY C1 ASC)"
+        )
+        self._db.snapshot(multi_use=True)
+
+        self._check_sql_results(
+            self._db, sql=SQL, params=None, param_types=None, expected=[[[]]]
+        )
+
+    def test_invalid_type(self):
+        table = "counters"
+        columns = ("name", "value")
+
+        valid_input = (("", 0),)
+        with self._db.batch() as batch:
+            batch.delete(table, self.ALL)
+            batch.insert(table, columns, valid_input)
+
+        invalid_input = ((0, ""),)
+        with self.assertRaises(exceptions.FailedPrecondition) as exc_info:
+            with self._db.batch() as batch:
+                batch.delete(table, self.ALL)
+                batch.insert(table, columns, invalid_input)
+
+        error_msg = (
+            "Invalid value for column value in table " "counters: Expected INT64."
+        )
+        self.assertIn(error_msg, str(exc_info.exception))
+
+    def test_execute_sql_select_1(self):
+
+        self._db.snapshot(multi_use=True)
+
+        # Hello, world query
+        self._check_sql_results(
+            self._db,
+            sql="SELECT 1",
+            params=None,
+            param_types=None,
+            expected=[(1,)],
+            order=False,
+        )
+
+    def _bind_test_helper(
+        self, type_name, single_value, array_value, expected_array_value=None
+    ):
+
+        self._db.snapshot(multi_use=True)
+
+        # Bind a non-null <type_name>
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @v",
+            params={"v": single_value},
+            param_types={"v": Type(code=type_name)},
+            expected=[(single_value,)],
+            order=False,
+        )
+
+        # Bind a null <type_name>
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @v",
+            params={"v": None},
+            param_types={"v": Type(code=type_name)},
+            expected=[(None,)],
+            order=False,
+        )
+
+        # Bind an array of <type_name>
+        array_type = Type(code=ARRAY, array_element_type=Type(code=type_name))
+
+        if expected_array_value is None:
+            expected_array_value = array_value
+
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @v",
+            params={"v": array_value},
+            param_types={"v": array_type},
+            expected=[(expected_array_value,)],
+            order=False,
+        )
+
+        # Bind an empty array of <type_name>
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @v",
+            params={"v": []},
+            param_types={"v": array_type},
+            expected=[([],)],
+            order=False,
+        )
+
+        # Bind a null array of <type_name>
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @v",
+            params={"v": None},
+            param_types={"v": array_type},
+            expected=[(None,)],
+            order=False,
+        )
+
+    def test_execute_sql_w_string_bindings(self):
+        self._bind_test_helper(STRING, "Phred", ["Phred", "Bharney"])
+
+    def test_execute_sql_w_bool_bindings(self):
+        self._bind_test_helper(BOOL, True, [True, False, True])
+
+    def test_execute_sql_w_int64_bindings(self):
+        self._bind_test_helper(INT64, 42, [123, 456, 789])
+
+    def test_execute_sql_w_float64_bindings(self):
+        self._bind_test_helper(FLOAT64, 42.3, [12.3, 456.0, 7.89])
+
+    def test_execute_sql_w_float_bindings_transfinite(self):
+
+        # Find -inf
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @neg_inf",
+            params={"neg_inf": NEG_INF},
+            param_types={"neg_inf": Type(code=FLOAT64)},
+            expected=[(NEG_INF,)],
+            order=False,
+        )
+
+        # Find +inf
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @pos_inf",
+            params={"pos_inf": POS_INF},
+            param_types={"pos_inf": Type(code=FLOAT64)},
+            expected=[(POS_INF,)],
+            order=False,
+        )
+
+    def test_execute_sql_w_bytes_bindings(self):
+        self._bind_test_helper(BYTES, b"DEADBEEF", [b"FACEDACE", b"DEADBEEF"])
+
+    def test_execute_sql_w_timestamp_bindings(self):
+        import pytz
+        from google.api_core.datetime_helpers import DatetimeWithNanoseconds
+
+        timestamp_1 = DatetimeWithNanoseconds(
+            1989, 1, 17, 17, 59, 12, nanosecond=345612789
+        )
+
+        timestamp_2 = DatetimeWithNanoseconds(
+            1989, 1, 17, 17, 59, 13, nanosecond=456127893
+        )
+
+        timestamps = [timestamp_1, timestamp_2]
+
+        # In round-trip, timestamps acquire a timezone value.
+        expected_timestamps = [
+            timestamp.replace(tzinfo=pytz.UTC) for timestamp in timestamps
+        ]
+
+        self._recurse_into_lists = False
+        self._bind_test_helper(TIMESTAMP, timestamp_1, timestamps, expected_timestamps)
+
+    def test_execute_sql_w_date_bindings(self):
+        import datetime
+
+        dates = [SOME_DATE, SOME_DATE + datetime.timedelta(days=1)]
+        self._bind_test_helper(DATE, SOME_DATE, dates)
+
+    def test_execute_sql_w_query_param_struct(self):
+        NAME = "Phred"
+        COUNT = 123
+        SIZE = 23.456
+        HEIGHT = 188.0
+        WEIGHT = 97.6
+
+        record_type = param_types.Struct(
+            [
+                param_types.StructField("name", param_types.STRING),
+                param_types.StructField("count", param_types.INT64),
+                param_types.StructField("size", param_types.FLOAT64),
+                param_types.StructField(
+                    "nested",
+                    param_types.Struct(
+                        [
+                            param_types.StructField("height", param_types.FLOAT64),
+                            param_types.StructField("weight", param_types.FLOAT64),
+                        ]
+                    ),
+                ),
+            ]
+        )
+
+        # Query with null struct, explicit type
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @r.name, @r.count, @r.size, @r.nested.weight",
+            params={"r": None},
+            param_types={"r": record_type},
+            expected=[(None, None, None, None)],
+            order=False,
+        )
+
+        # Query with non-null struct, explicit type, NULL values
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @r.name, @r.count, @r.size, @r.nested.weight",
+            params={"r": (None, None, None, None)},
+            param_types={"r": record_type},
+            expected=[(None, None, None, None)],
+            order=False,
+        )
+
+        # Query with non-null struct, explicit type, nested NULL values
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @r.nested.weight",
+            params={"r": (None, None, None, (None, None))},
+            param_types={"r": record_type},
+            expected=[(None,)],
+            order=False,
+        )
+
+        # Query with non-null struct, explicit type
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @r.name, @r.count, @r.size, @r.nested.weight",
+            params={"r": (NAME, COUNT, SIZE, (HEIGHT, WEIGHT))},
+            param_types={"r": record_type},
+            expected=[(NAME, COUNT, SIZE, WEIGHT)],
+            order=False,
+        )
+
+        # Query with empty struct, explicitly empty type
+        empty_type = param_types.Struct([])
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @r IS NULL",
+            params={"r": ()},
+            param_types={"r": empty_type},
+            expected=[(False,)],
+            order=False,
+        )
+
+        # Query with null struct, explicitly empty type
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @r IS NULL",
+            params={"r": None},
+            param_types={"r": empty_type},
+            expected=[(True,)],
+            order=False,
+        )
+
+        # Query with equality check for struct value
+        struct_equality_query = (
+            "SELECT " '@struct_param=STRUCT<threadf INT64, userf STRING>(1,"bob")'
+        )
+        struct_type = param_types.Struct(
+            [
+                param_types.StructField("threadf", param_types.INT64),
+                param_types.StructField("userf", param_types.STRING),
+            ]
+        )
+        self._check_sql_results(
+            self._db,
+            sql=struct_equality_query,
+            params={"struct_param": (1, "bob")},
+            param_types={"struct_param": struct_type},
+            expected=[(True,)],
+            order=False,
+        )
+
+        # Query with nullness test for struct
+        self._check_sql_results(
+            self._db,
+            sql="SELECT @struct_param IS NULL",
+            params={"struct_param": None},
+            param_types={"struct_param": struct_type},
+            expected=[(True,)],
+            order=False,
+        )
+
+        # Query with null array-of-struct
+        array_elem_type = param_types.Struct(
+            [param_types.StructField("threadid", param_types.INT64)]
+        )
+        array_type = param_types.Array(array_elem_type)
+        self._check_sql_results(
+            self._db,
+            sql="SELECT a.threadid FROM UNNEST(@struct_arr_param) a",
+            params={"struct_arr_param": None},
+            param_types={"struct_arr_param": array_type},
+            expected=[],
+            order=False,
+        )
+
+        # Query with non-null array-of-struct
+        self._check_sql_results(
+            self._db,
+            sql="SELECT a.threadid FROM UNNEST(@struct_arr_param) a",
+            params={"struct_arr_param": [(123,), (456,)]},
+            param_types={"struct_arr_param": array_type},
+            expected=[(123,), (456,)],
+            order=False,
+        )
+
+        # Query with null array-of-struct field
+        struct_type_with_array_field = param_types.Struct(
+            [
+                param_types.StructField("intf", param_types.INT64),
+                param_types.StructField("arraysf", array_type),
+            ]
+        )
+        self._check_sql_results(
+            self._db,
+            sql="SELECT a.threadid FROM UNNEST(@struct_param.arraysf) a",
+            params={"struct_param": (123, None)},
+            param_types={"struct_param": struct_type_with_array_field},
+            expected=[],
+            order=False,
+        )
+
+        # Query with non-null array-of-struct field
+        self._check_sql_results(
+            self._db,
+            sql="SELECT a.threadid FROM UNNEST(@struct_param.arraysf) a",
+            params={"struct_param": (123, ((456,), (789,)))},
+            param_types={"struct_param": struct_type_with_array_field},
+            expected=[(456,), (789,)],
+            order=False,
+        )
+
+        # Query with anonymous / repeated-name fields
+        anon_repeated_array_elem_type = param_types.Struct(
+            [
+                param_types.StructField("", param_types.INT64),
+                param_types.StructField("", param_types.STRING),
+            ]
+        )
+        anon_repeated_array_type = param_types.Array(anon_repeated_array_elem_type)
+        self._check_sql_results(
+            self._db,
+            sql="SELECT CAST(t as STRUCT<threadid INT64, userid STRING>).* "
+            "FROM UNNEST(@struct_param) t",
+            params={"struct_param": [(123, "abcdef")]},
+            param_types={"struct_param": anon_repeated_array_type},
+            expected=[(123, "abcdef")],
+            order=False,
+        )
+
+        # Query and return a struct parameter
+        value_type = param_types.Struct(
+            [
+                param_types.StructField("message", param_types.STRING),
+                param_types.StructField("repeat", param_types.INT64),
+            ]
+        )
+        value_query = (
+            "SELECT ARRAY(SELECT AS STRUCT message, repeat "
+            "FROM (SELECT @value.message AS message, "
+            "@value.repeat AS repeat)) AS value"
+        )
+        self._check_sql_results(
+            self._db,
+            sql=value_query,
+            params={"value": ("hello", 1)},
+            param_types={"value": value_type},
+            expected=[([["hello", 1]],)],
+            order=False,
+        )
+
+    def test_execute_sql_returning_transfinite_floats(self):
+
+        with self._db.snapshot(multi_use=True) as snapshot:
+            # Query returning -inf, +inf, NaN as column values
+            rows = list(
+                snapshot.execute_sql(
+                    "SELECT "
+                    'CAST("-inf" AS FLOAT64), '
+                    'CAST("+inf" AS FLOAT64), '
+                    'CAST("NaN" AS FLOAT64)'
+                )
+            )
+            self.assertEqual(len(rows), 1)
+            self.assertEqual(rows[0][0], float("-inf"))
+            self.assertEqual(rows[0][1], float("+inf"))
+            # NaNs cannot be compared by equality.
+            self.assertTrue(math.isnan(rows[0][2]))
+
+            # Query returning array of -inf, +inf, NaN as one column
+            rows = list(
+                snapshot.execute_sql(
+                    "SELECT"
+                    ' [CAST("-inf" AS FLOAT64),'
+                    ' CAST("+inf" AS FLOAT64),'
+                    ' CAST("NaN" AS FLOAT64)]'
+                )
+            )
+            self.assertEqual(len(rows), 1)
+            float_array, = rows[0]
+            self.assertEqual(float_array[0], float("-inf"))
+            self.assertEqual(float_array[1], float("+inf"))
+            # NaNs cannot be searched for by equality.
+            self.assertTrue(math.isnan(float_array[2]))
+
+    def test_partition_query(self):
+        row_count = 40
+        sql = "SELECT * FROM {}".format(self.TABLE)
+        committed = self._set_up_table(row_count)
+        all_data_rows = list(self._row_data(row_count))
+
+        union = []
+        batch_txn = self._db.batch_snapshot(read_timestamp=committed)
+        for batch in batch_txn.generate_query_batches(sql):
+            p_results_iter = batch_txn.process(batch)
+            union.extend(list(p_results_iter))
+
+        self.assertEqual(union, all_data_rows)
+        batch_txn.close()
+
+
+class TestStreamingChunking(unittest.TestCase, _TestData):
+    @classmethod
+    def setUpClass(cls):
+        from tests.system.utils.streaming_utils import INSTANCE_NAME
+        from tests.system.utils.streaming_utils import DATABASE_NAME
+
+        instance = Config.CLIENT.instance(INSTANCE_NAME)
+        if not instance.exists():
+            raise unittest.SkipTest(
+                "Run 'tests/system/utils/populate_streaming.py' to enable."
+            )
+
+        database = instance.database(DATABASE_NAME)
+        if not instance.exists():
+            raise unittest.SkipTest(
+                "Run 'tests/system/utils/populate_streaming.py' to enable."
+            )
+
+        cls._db = database
+
+    def _verify_one_column(self, table_desc):
+        sql = "SELECT chunk_me FROM {}".format(table_desc.table)
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.execute_sql(sql))
+        self.assertEqual(len(rows), table_desc.row_count)
+        expected = table_desc.value()
+        for row in rows:
+            self.assertEqual(row[0], expected)
+
+    def _verify_two_columns(self, table_desc):
+        sql = "SELECT chunk_me, chunk_me_2 FROM {}".format(table_desc.table)
+        with self._db.snapshot() as snapshot:
+            rows = list(snapshot.execute_sql(sql))
+        self.assertEqual(len(rows), table_desc.row_count)
+        expected = table_desc.value()
+        for row in rows:
+            self.assertEqual(row[0], expected)
+            self.assertEqual(row[1], expected)
+
+    def test_four_kay(self):
+        from tests.system.utils.streaming_utils import FOUR_KAY
+
+        self._verify_one_column(FOUR_KAY)
+
+    def test_forty_kay(self):
+        from tests.system.utils.streaming_utils import FORTY_KAY
+
+        self._verify_one_column(FORTY_KAY)
+
+    def test_four_hundred_kay(self):
+        from tests.system.utils.streaming_utils import FOUR_HUNDRED_KAY
+
+        self._verify_one_column(FOUR_HUNDRED_KAY)
+
+    def test_four_meg(self):
+        from tests.system.utils.streaming_utils import FOUR_MEG
+
+        self._verify_two_columns(FOUR_MEG)
+
+
+class CustomException(Exception):
+    """Placeholder for any user-defined exception."""
+
+
+class _DatabaseDropper(object):
+    """Helper for cleaning up databases created on-the-fly."""
+
+    def __init__(self, db):
+        self._db = db
+
+    def delete(self):
+        self._db.drop()
+
+
+class _ReadAbortTrigger(object):
+    """Helper for tests provoking abort-during-read."""
+
+    KEY1 = "key1"
+    KEY2 = "key2"
+
+    def __init__(self):
+        self.provoker_started = threading.Event()
+        self.provoker_done = threading.Event()
+        self.handler_running = threading.Event()
+        self.handler_done = threading.Event()
+
+    def _provoke_abort_unit_of_work(self, transaction):
+        keyset = KeySet(keys=[(self.KEY1,)])
+        rows = list(transaction.read(COUNTERS_TABLE, COUNTERS_COLUMNS, keyset))
+
+        assert len(rows) == 1
+        row = rows[0]
+        value = row[1]
+
+        self.provoker_started.set()
+
+        self.handler_running.wait()
+
+        transaction.update(COUNTERS_TABLE, COUNTERS_COLUMNS, [[self.KEY1, value + 1]])
+
+    def provoke_abort(self, database):
+        database.run_in_transaction(self._provoke_abort_unit_of_work)
+        self.provoker_done.set()
+
+    def _handle_abort_unit_of_work(self, transaction):
+        keyset_1 = KeySet(keys=[(self.KEY1,)])
+        rows_1 = list(transaction.read(COUNTERS_TABLE, COUNTERS_COLUMNS, keyset_1))
+
+        assert len(rows_1) == 1
+        row_1 = rows_1[0]
+        value_1 = row_1[1]
+
+        self.handler_running.set()
+
+        self.provoker_done.wait()
+
+        keyset_2 = KeySet(keys=[(self.KEY2,)])
+        rows_2 = list(transaction.read(COUNTERS_TABLE, COUNTERS_COLUMNS, keyset_2))
+
+        assert len(rows_2) == 1
+        row_2 = rows_2[0]
+        value_2 = row_2[1]
+
+        transaction.update(
+            COUNTERS_TABLE, COUNTERS_COLUMNS, [[self.KEY2, value_1 + value_2]]
+        )
+
+    def handle_abort(self, database):
+        database.run_in_transaction(self._handle_abort_unit_of_work)
+        self.handler_done.set()
diff --git a/spanner/tests/system/utils/__init__.py b/spanner/tests/system/utils/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/spanner/tests/system/utils/clear_streaming.py b/spanner/tests/system/utils/clear_streaming.py
new file mode 100644
index 000000000000..6c9dee29f5a8
--- /dev/null
+++ b/spanner/tests/system/utils/clear_streaming.py
@@ -0,0 +1,46 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Depopulate spanner databases with data for streaming system tests."""
+
+from google.cloud.spanner import Client
+
+# Import relative to the script's directory
+from streaming_utils import DATABASE_NAME
+from streaming_utils import INSTANCE_NAME
+from streaming_utils import print_func
+
+
+def remove_database(client):
+    instance = client.instance(INSTANCE_NAME)
+
+    if not instance.exists():
+        print_func("Instance does not exist: {}".format(INSTANCE_NAME))
+        return
+
+    print_func("Instance exists: {}".format(INSTANCE_NAME))
+    instance.reload()
+
+    database = instance.database(DATABASE_NAME)
+
+    if not database.exists():
+        print_func("Database does not exist: {}".format(DATABASE_NAME))
+        return
+    print_func("Dropping database: {}".format(DATABASE_NAME))
+    database.drop()
+
+
+if __name__ == "__main__":
+    client = Client()
+    remove_database(client)
diff --git a/spanner/tests/system/utils/populate_streaming.py b/spanner/tests/system/utils/populate_streaming.py
new file mode 100644
index 000000000000..a336228a15a4
--- /dev/null
+++ b/spanner/tests/system/utils/populate_streaming.py
@@ -0,0 +1,140 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Populate spanner databases with data for streaming system tests."""
+
+from google.cloud.spanner_v1 import Client
+from google.cloud.spanner_v1.keyset import KeySet
+from google.cloud.spanner_v1.pool import BurstyPool
+
+# Import relative to the script's directory
+from streaming_utils import FOUR_KAY
+from streaming_utils import FORTY_KAY
+from streaming_utils import FOUR_HUNDRED_KAY
+from streaming_utils import FOUR_MEG
+from streaming_utils import DATABASE_NAME
+from streaming_utils import INSTANCE_NAME
+from streaming_utils import print_func
+
+
+DDL = """\
+CREATE TABLE {0.table} (
+    pkey INT64,
+    chunk_me STRING({0.value_size}) )
+    PRIMARY KEY (pkey);
+CREATE TABLE {1.table} (
+    pkey INT64,
+    chunk_me STRING({1.value_size}) )
+    PRIMARY KEY (pkey);
+CREATE TABLE {2.table} (
+    pkey INT64,
+    chunk_me STRING({2.value_size}) )
+    PRIMARY KEY (pkey);
+CREATE TABLE {3.table} (
+    pkey INT64,
+    chunk_me STRING({3.value_size}),
+    chunk_me_2 STRING({3.value_size}) )
+    PRIMARY KEY (pkey);
+""".format(
+    FOUR_KAY, FORTY_KAY, FOUR_HUNDRED_KAY, FOUR_MEG
+)
+
+
+DDL_STATEMENTS = [stmt.strip() for stmt in DDL.split(";") if stmt.strip()]
+
+
+def ensure_database(client):
+    instance = client.instance(INSTANCE_NAME)
+
+    if not instance.exists():
+        configs = list(client.list_instance_configs())
+        config_name = configs[0].name
+        print_func("Creating instance: {}".format(INSTANCE_NAME))
+        instance = client.instance(INSTANCE_NAME, config_name)
+        operation = instance.create()
+        operation.result(30)
+    else:
+        print_func("Instance exists: {}".format(INSTANCE_NAME))
+        instance.reload()
+
+    pool = BurstyPool()
+    database = instance.database(
+        DATABASE_NAME, ddl_statements=DDL_STATEMENTS, pool=pool
+    )
+
+    if not database.exists():
+        print_func("Creating database: {}".format(DATABASE_NAME))
+        operation = database.create()
+        operation.result(30)
+    else:
+        print_func("Database exists: {}".format(DATABASE_NAME))
+        database.reload()
+
+    return database
+
+
+def populate_table(database, table_desc):
+    all_ = KeySet(all_=True)
+    columns = ("pkey", "chunk_me")
+    with database.snapshot() as snapshot:
+        rows = list(
+            snapshot.execute_sql("SELECT COUNT(*) FROM {}".format(table_desc.table))
+        )
+    assert len(rows) == 1
+    count = rows[0][0]
+    if count != table_desc.row_count:
+        print_func("Repopulating table: {}".format(table_desc.table))
+        chunk_me = table_desc.value()
+        row_data = [(index, chunk_me) for index in range(table_desc.row_count)]
+        with database.batch() as batch:
+            batch.delete(table_desc.table, all_)
+            batch.insert(table_desc.table, columns, row_data)
+    else:
+        print_func("Leaving table: {}".format(table_desc.table))
+
+
+def populate_table_2_columns(database, table_desc):
+    all_ = KeySet(all_=True)
+    columns = ("pkey", "chunk_me", "chunk_me_2")
+    with database.snapshot() as snapshot:
+        rows = list(
+            snapshot.execute_sql("SELECT COUNT(*) FROM {}".format(table_desc.table))
+        )
+    assert len(rows) == 1
+    count = rows[0][0]
+    if count != table_desc.row_count:
+        print_func("Repopulating table: {}".format(table_desc.table))
+        chunk_me = table_desc.value()
+        row_data = [
+            (index, chunk_me, chunk_me) for index in range(table_desc.row_count)
+        ]
+        with database.batch() as batch:
+            batch.delete(table_desc.table, all_)
+            batch.insert(table_desc.table, columns, row_data)
+    else:
+        print_func("Leaving table: {}".format(table_desc.table))
+
+
+def populate_streaming(client):
+    database = ensure_database(client)
+    populate_table(database, FOUR_KAY)
+    populate_table(database, FORTY_KAY)
+    populate_table(database, FOUR_HUNDRED_KAY)
+    # Max STRING column size is just larger than 2 Mb, so use two columns
+    populate_table_2_columns(database, FOUR_MEG)
+
+
+if __name__ == "__main__":
+    client = Client()
+    populate_streaming(client)
diff --git a/spanner/tests/system/utils/scrub_instances.py b/spanner/tests/system/utils/scrub_instances.py
new file mode 100644
index 000000000000..79cd51fdfc94
--- /dev/null
+++ b/spanner/tests/system/utils/scrub_instances.py
@@ -0,0 +1,35 @@
+# Copyright 2017 Google LLC 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.
+
+from google.cloud.spanner import Client
+from .streaming_utils import INSTANCE_NAME as STREAMING_INSTANCE
+
+STANDARD_INSTANCE = "google-cloud-python-systest"
+
+
+def scrub_instances(client):
+    for instance in client.list_instances():
+        if instance.name == STREAMING_INSTANCE:
+            print("Not deleting streaming instance: {}".format(STREAMING_INSTANCE))
+            continue
+        elif instance.name == STANDARD_INSTANCE:
+            print("Not deleting standard instance: {}".format(STANDARD_INSTANCE))
+        else:
+            print("deleting instance: {}".format(instance.name))
+            instance.delete()
+
+
+if __name__ == "__main__":
+    client = Client()
+    scrub_instances(client)
diff --git a/spanner/tests/system/utils/streaming_utils.py b/spanner/tests/system/utils/streaming_utils.py
new file mode 100644
index 000000000000..a39637bf0f44
--- /dev/null
+++ b/spanner/tests/system/utils/streaming_utils.py
@@ -0,0 +1,40 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import os
+
+INSTANCE_NAME = "gcp-streaming-systests"
+DATABASE_NAME = "testing"
+_SHOULD_PRINT = os.getenv("GOOGLE_CLOUD_NO_PRINT") != "true"
+
+
+class _TableDesc(
+    collections.namedtuple(
+        "TableDesc", ("table", "row_count", "value_size", "column_count")
+    )
+):
+    def value(self):
+        return u"X" * self.value_size
+
+
+FOUR_KAY = _TableDesc("four_kay", 1000, 4096, 1)
+FORTY_KAY = _TableDesc("forty_kay", 100, 4096 * 10, 1)
+FOUR_HUNDRED_KAY = _TableDesc("four_hundred_kay", 25, 4096 * 100, 1)
+FOUR_MEG = _TableDesc("four_meg", 10, 2048 * 1024, 2)
+
+
+def print_func(message):
+    if _SHOULD_PRINT:
+        print(message)
diff --git a/spanner/tests/unit/__init__.py b/spanner/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/spanner/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/spanner/tests/unit/gapic/v1/test_database_admin_client_v1.py b/spanner/tests/unit/gapic/v1/test_database_admin_client_v1.py
new file mode 100644
index 000000000000..166e823b371b
--- /dev/null
+++ b/spanner/tests/unit/gapic/v1/test_database_admin_client_v1.py
@@ -0,0 +1,460 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import spanner_admin_database_v1
+from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestDatabaseAdminClient(object):
+    def test_list_databases(self):
+        # Setup Expected Response
+        next_page_token = ""
+        databases_element = {}
+        databases = [databases_element]
+        expected_response = {"next_page_token": next_page_token, "databases": databases}
+        expected_response = spanner_database_admin_pb2.ListDatabasesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        paged_list_response = client.list_databases(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.databases[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_database_admin_pb2.ListDatabasesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_databases_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        paged_list_response = client.list_databases(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_database(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = spanner_database_admin_pb2.Database(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_database", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        create_statement = "createStatement552974828"
+
+        response = client.create_database(parent, create_statement)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_database_admin_pb2.CreateDatabaseRequest(
+            parent=parent, create_statement=create_statement
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_database_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_database_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        parent = client.instance_path("[PROJECT]", "[INSTANCE]")
+        create_statement = "createStatement552974828"
+
+        response = client.create_database(parent, create_statement)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_get_database(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = spanner_database_admin_pb2.Database(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        name = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        response = client.get_database(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_database_admin_pb2.GetDatabaseRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_database_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        name = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.get_database(name)
+
+    def test_update_database_ddl(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_database_ddl", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+        statements = []
+
+        response = client.update_database_ddl(database, statements)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_database_admin_pb2.UpdateDatabaseDdlRequest(
+            database=database, statements=statements
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_database_ddl_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_database_ddl_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+        statements = []
+
+        response = client.update_database_ddl(database, statements)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_drop_database(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        client.drop_database(database)
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_database_admin_pb2.DropDatabaseRequest(
+            database=database
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_drop_database_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.drop_database(database)
+
+    def test_get_database_ddl(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = spanner_database_admin_pb2.GetDatabaseDdlResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        response = client.get_database_ddl(database)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_database_admin_pb2.GetDatabaseDdlRequest(
+            database=database
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_database_ddl_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.get_database_ddl(database)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        resource = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        resource = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        resource = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        resource = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup Request
+        resource = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_database_v1.DatabaseAdminClient()
+
+        # Setup request
+        resource = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/spanner/tests/unit/gapic/v1/test_instance_admin_client_v1.py b/spanner/tests/unit/gapic/v1/test_instance_admin_client_v1.py
new file mode 100644
index 000000000000..60f63938f976
--- /dev/null
+++ b/spanner/tests/unit/gapic/v1/test_instance_admin_client_v1.py
@@ -0,0 +1,538 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import spanner_admin_instance_v1
+from google.cloud.spanner_admin_instance_v1.proto import spanner_instance_admin_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestInstanceAdminClient(object):
+    def test_list_instance_configs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        instance_configs_element = {}
+        instance_configs = [instance_configs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "instance_configs": instance_configs,
+        }
+        expected_response = spanner_instance_admin_pb2.ListInstanceConfigsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_instance_configs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.instance_configs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.ListInstanceConfigsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_instance_configs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_instance_configs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_instance_config(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = spanner_instance_admin_pb2.InstanceConfig(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        name = client.instance_config_path("[PROJECT]", "[INSTANCE_CONFIG]")
+
+        response = client.get_instance_config(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.GetInstanceConfigRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_instance_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        name = client.instance_config_path("[PROJECT]", "[INSTANCE_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.get_instance_config(name)
+
+    def test_list_instances(self):
+        # Setup Expected Response
+        next_page_token = ""
+        instances_element = {}
+        instances = [instances_element]
+        expected_response = {"next_page_token": next_page_token, "instances": instances}
+        expected_response = spanner_instance_admin_pb2.ListInstancesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_instances(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.instances[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.ListInstancesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_instances_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_instances(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_instance(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        config = "config-1354792126"
+        display_name = "displayName1615086568"
+        node_count = 1539922066
+        expected_response = {
+            "name": name_2,
+            "config": config,
+            "display_name": display_name,
+            "node_count": node_count,
+        }
+        expected_response = spanner_instance_admin_pb2.Instance(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        response = client.get_instance(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.GetInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.get_instance(name)
+
+    def test_create_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        config = "config-1354792126"
+        display_name = "displayName1615086568"
+        node_count = 1539922066
+        expected_response = {
+            "name": name,
+            "config": config,
+            "display_name": display_name,
+            "node_count": node_count,
+        }
+        expected_response = spanner_instance_admin_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        instance_id = "instanceId-2101995259"
+        instance = {}
+
+        response = client.create_instance(parent, instance_id, instance)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.CreateInstanceRequest(
+            parent=parent, instance_id=instance_id, instance=instance
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        instance_id = "instanceId-2101995259"
+        instance = {}
+
+        response = client.create_instance(parent, instance_id, instance)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_update_instance(self):
+        # Setup Expected Response
+        name = "name3373707"
+        config = "config-1354792126"
+        display_name = "displayName1615086568"
+        node_count = 1539922066
+        expected_response = {
+            "name": name,
+            "config": config,
+            "display_name": display_name,
+            "node_count": node_count,
+        }
+        expected_response = spanner_instance_admin_pb2.Instance(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_update_instance", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        instance = {}
+        field_mask = {}
+
+        response = client.update_instance(instance, field_mask)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.UpdateInstanceRequest(
+            instance=instance, field_mask=field_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_instance_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_update_instance_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        instance = {}
+        field_mask = {}
+
+        response = client.update_instance(instance, field_mask)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_delete_instance(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        client.delete_instance(name)
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_instance_admin_pb2.DeleteInstanceRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_instance_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        name = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.delete_instance(name)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup Request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_admin_instance_v1.InstanceAdminClient()
+
+        # Setup request
+        resource = client.instance_path("[PROJECT]", "[INSTANCE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
diff --git a/spanner/tests/unit/gapic/v1/test_spanner_client_v1.py b/spanner/tests/unit/gapic/v1/test_spanner_client_v1.py
new file mode 100644
index 000000000000..3509a2d8c639
--- /dev/null
+++ b/spanner/tests/unit/gapic/v1/test_spanner_client_v1.py
@@ -0,0 +1,722 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud.spanner_v1.gapic import spanner_client as spanner_v1
+from google.cloud.spanner_v1.proto import keys_pb2
+from google.cloud.spanner_v1.proto import result_set_pb2
+from google.cloud.spanner_v1.proto import spanner_pb2
+from google.cloud.spanner_v1.proto import transaction_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def unary_stream(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestSpannerClient(object):
+    def test_create_session(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = spanner_pb2.Session(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        response = client.create_session(database)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.CreateSessionRequest(database=database)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_session_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.create_session(database)
+
+    def test_batch_create_sessions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = spanner_pb2.BatchCreateSessionsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        response = client.batch_create_sessions(database)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.BatchCreateSessionsRequest(database=database)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_create_sessions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        with pytest.raises(CustomException):
+            client.batch_create_sessions(database)
+
+    def test_get_session(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = spanner_pb2.Session(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        name = client.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
+
+        response = client.get_session(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.GetSessionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_session_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        name = client.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
+
+        with pytest.raises(CustomException):
+            client.get_session(name)
+
+    def test_list_sessions(self):
+        # Setup Expected Response
+        next_page_token = ""
+        sessions_element = {}
+        sessions = [sessions_element]
+        expected_response = {"next_page_token": next_page_token, "sessions": sessions}
+        expected_response = spanner_pb2.ListSessionsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        paged_list_response = client.list_sessions(database)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.sessions[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.ListSessionsRequest(database=database)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_sessions_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        database = client.database_path("[PROJECT]", "[INSTANCE]", "[DATABASE]")
+
+        paged_list_response = client.list_sessions(database)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_delete_session(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        name = client.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
+
+        client.delete_session(name)
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.DeleteSessionRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_session_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        name = client.session_path("[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]")
+
+        with pytest.raises(CustomException):
+            client.delete_session(name)
+
+    def test_execute_sql(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = result_set_pb2.ResultSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        sql = "sql114126"
+
+        response = client.execute_sql(session, sql)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.ExecuteSqlRequest(session=session, sql=sql)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_execute_sql_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        sql = "sql114126"
+
+        with pytest.raises(CustomException):
+            client.execute_sql(session, sql)
+
+    def test_execute_streaming_sql(self):
+        # Setup Expected Response
+        chunked_value = True
+        resume_token = b"103"
+        expected_response = {
+            "chunked_value": chunked_value,
+            "resume_token": resume_token,
+        }
+        expected_response = result_set_pb2.PartialResultSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        sql = "sql114126"
+
+        response = client.execute_streaming_sql(session, sql)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.ExecuteSqlRequest(session=session, sql=sql)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_execute_streaming_sql_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        sql = "sql114126"
+
+        with pytest.raises(CustomException):
+            client.execute_streaming_sql(session, sql)
+
+    def test_execute_batch_dml(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = spanner_pb2.ExecuteBatchDmlResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        transaction = {}
+        statements = []
+        seqno = 109325920
+
+        response = client.execute_batch_dml(session, transaction, statements, seqno)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.ExecuteBatchDmlRequest(
+            session=session, transaction=transaction, statements=statements, seqno=seqno
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_execute_batch_dml_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        transaction = {}
+        statements = []
+        seqno = 109325920
+
+        with pytest.raises(CustomException):
+            client.execute_batch_dml(session, transaction, statements, seqno)
+
+    def test_read(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = result_set_pb2.ResultSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        table = "table110115790"
+        columns = []
+        key_set = {}
+
+        response = client.read(session, table, columns, key_set)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.ReadRequest(
+            session=session, table=table, columns=columns, key_set=key_set
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_read_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        table = "table110115790"
+        columns = []
+        key_set = {}
+
+        with pytest.raises(CustomException):
+            client.read(session, table, columns, key_set)
+
+    def test_streaming_read(self):
+        # Setup Expected Response
+        chunked_value = True
+        resume_token = b"103"
+        expected_response = {
+            "chunked_value": chunked_value,
+            "resume_token": resume_token,
+        }
+        expected_response = result_set_pb2.PartialResultSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        table = "table110115790"
+        columns = []
+        key_set = {}
+
+        response = client.streaming_read(session, table, columns, key_set)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.ReadRequest(
+            session=session, table=table, columns=columns, key_set=key_set
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_streaming_read_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        table = "table110115790"
+        columns = []
+        key_set = {}
+
+        with pytest.raises(CustomException):
+            client.streaming_read(session, table, columns, key_set)
+
+    def test_begin_transaction(self):
+        # Setup Expected Response
+        id_ = b"27"
+        expected_response = {"id": id_}
+        expected_response = transaction_pb2.Transaction(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        options_ = {}
+
+        response = client.begin_transaction(session, options_)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.BeginTransactionRequest(
+            session=session, options=options_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_begin_transaction_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        options_ = {}
+
+        with pytest.raises(CustomException):
+            client.begin_transaction(session, options_)
+
+    def test_commit(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = spanner_pb2.CommitResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        mutations = []
+
+        response = client.commit(session, mutations)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.CommitRequest(
+            session=session, mutations=mutations
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_commit_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        mutations = []
+
+        with pytest.raises(CustomException):
+            client.commit(session, mutations)
+
+    def test_rollback(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        transaction_id = b"28"
+
+        client.rollback(session, transaction_id)
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.RollbackRequest(
+            session=session, transaction_id=transaction_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_rollback_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        transaction_id = b"28"
+
+        with pytest.raises(CustomException):
+            client.rollback(session, transaction_id)
+
+    def test_partition_query(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = spanner_pb2.PartitionResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        sql = "sql114126"
+
+        response = client.partition_query(session, sql)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.PartitionQueryRequest(session=session, sql=sql)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_partition_query_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        sql = "sql114126"
+
+        with pytest.raises(CustomException):
+            client.partition_query(session, sql)
+
+    def test_partition_read(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = spanner_pb2.PartitionResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup Request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        table = "table110115790"
+        key_set = {}
+
+        response = client.partition_read(session, table, key_set)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = spanner_pb2.PartitionReadRequest(
+            session=session, table=table, key_set=key_set
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_partition_read_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = spanner_v1.SpannerClient()
+
+        # Setup request
+        session = client.session_path(
+            "[PROJECT]", "[INSTANCE]", "[DATABASE]", "[SESSION]"
+        )
+        table = "table110115790"
+        key_set = {}
+
+        with pytest.raises(CustomException):
+            client.partition_read(session, table, key_set)
diff --git a/spanner/tests/unit/streaming-read-acceptance-test.json b/spanner/tests/unit/streaming-read-acceptance-test.json
new file mode 100644
index 000000000000..9b44b4077812
--- /dev/null
+++ b/spanner/tests/unit/streaming-read-acceptance-test.json
@@ -0,0 +1,217 @@
+{"tests": [
+  {
+    "result": {"value": [[
+      true,
+      "abc",
+      "100",
+      1.1,
+      "YWJj",
+      [
+        "abc",
+        "def",
+        null,
+        "ghi"
+      ],
+      [
+        ["abc"],
+        ["def"],
+        ["ghi"]
+      ]
+    ]]},
+    "chunks": ["{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"BOOL\"\n        }\n      }, {\n        \"name\": \"f2\",\n        \"type\": {\n          \"code\": \"STRING\"\n        }\n      }, {\n        \"name\": \"f3\",\n        \"type\": {\n          \"code\": \"INT64\"\n        }\n      }, {\n        \"name\": \"f4\",\n        \"type\": {\n          \"code\": \"FLOAT64\"\n        }\n      }, {\n        \"name\": \"f5\",\n        \"type\": {\n          \"code\": \"BYTES\"\n        }\n      }, {\n        \"name\": \"f6\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRING\"\n          }\n        }\n      }, {\n        \"name\": \"f7\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRUCT\",\n            \"structType\": {\n              \"fields\": [{\n                \"name\": \"f71\",\n                \"type\": {\n                  \"code\": \"STRING\"\n                }\n              }]\n            }\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [true, \"abc\", \"100\", 1.1, \"YWJj\", [\"abc\", \"def\", null, \"ghi\"], [[\"abc\"], [\"def\"], [\"ghi\"]]]\n}"],
+    "name": "Basic Test"
+  },
+  {
+    "result": {"value": [["abcdefghi"]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"STRING\"\n        }\n      }]\n    }\n  },\n  \"values\": [\"abc\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"def\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"ghi\"]\n}"
+    ],
+    "name": "String Chunking Test"
+  },
+  {
+    "result": {"value": [[[
+      "abc",
+      "def",
+      "ghi",
+      "jkl"
+    ]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRING\"\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[\"abc\", \"d\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"ef\", \"gh\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"i\", \"jkl\"]]\n}"
+    ],
+    "name": "String Array Chunking Test"
+  },
+  {
+    "result": {"value": [[[
+      "abc",
+      "def",
+      null,
+      "ghi",
+      null,
+      "jkl"
+    ]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRING\"\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[\"abc\", \"def\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[null, \"ghi\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[null, \"jkl\"]]\n}"
+    ],
+    "name": "String Array Chunking Test With Nulls"
+  },
+  {
+    "result": {"value": [[[
+      "abc",
+      "def",
+      "ghi",
+      "jkl"
+    ]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRING\"\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[\"abc\", \"def\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"\", \"ghi\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"\", \"jkl\"]]\n}"
+    ],
+    "name": "String Array Chunking Test With Empty Strings"
+  },
+  {
+    "result": {"value": [[["abcdefghi"]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRING\"\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[\"abc\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"def\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"ghi\"]]\n}"
+    ],
+    "name": "String Array Chunking Test With One Large String"
+  },
+  {
+    "result": {"value": [[[
+      "1",
+      "23",
+      "4",
+      null,
+      5
+    ]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"INT64\"\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[\"1\", \"2\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"3\", \"4\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"\", null, \"5\"]]\n}"
+    ],
+    "name": "INT64 Array Chunking Test"
+  },
+  {
+    "result": {"value": [[[
+      1,
+      2,
+      "Infinity",
+      "-Infinity",
+      "NaN",
+      null,
+      3
+    ]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"FLOAT64\"\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[1.0, 2.0]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"Infinity\", \"-Infinity\", \"NaN\"]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[\"\", null, 3.0]]\n}"
+    ],
+    "name": "FLOAT64 Array Chunking Test"
+  },
+  {
+    "result": {"value": [[[
+      [
+        "abc",
+        "defghi"
+      ],
+      [
+        "123",
+        "456"
+      ]
+    ]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRUCT\",\n            \"structType\": {\n              \"fields\": [{\n                \"name\": \"f11\",\n                \"type\": {\n                  \"code\": \"STRING\"\n                }\n              }, {\n                \"name\": \"f12\",\n                \"type\": {\n                  \"code\": \"STRING\"\n                }\n              }]\n            }\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[[\"abc\", \"def\"]]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[[\"ghi\"], [\"123\", \"456\"]]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[[\"\"]]]\n}"
+    ],
+    "name": "Struct Array Chunking Test"
+  },
+  {
+    "result": {"value": [[[[[["abc"]]]]]]},
+    "chunks": ["{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRUCT\",\n            \"structType\": {\n              \"fields\": [{\n                \"name\": \"f11\",\n                \"type\": {\n                  \"code\": \"ARRAY\",\n                  \"arrayElementType\": {\n                    \"code\": \"STRUCT\",\n                    \"structType\": {\n                      \"fields\": [{\n                        \"name\": \"f12\",\n                        \"type\": {\n                          \"code\": \"STRING\"\n                        }\n                      }]\n                    }\n                  }\n                }\n              }]\n            }\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[[[[\"abc\"]]]]]\n}"],
+    "name": "Nested Struct Array Test"
+  },
+  {
+    "result": {"value": [[[[[
+      ["abc"],
+      ["def"]
+    ]]]]]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRUCT\",\n            \"structType\": {\n              \"fields\": [{\n                \"name\": \"f11\",\n                \"type\": {\n                  \"code\": \"ARRAY\",\n                  \"arrayElementType\": {\n                    \"code\": \"STRUCT\",\n                    \"structType\": {\n                      \"fields\": [{\n                        \"name\": \"f12\",\n                        \"type\": {\n                          \"code\": \"STRING\"\n                        }\n                      }]\n                    }\n                  }\n                }\n              }]\n            }\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [[[[[\"ab\"]]]]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[[[[\"c\"], [\"def\"]]]]]\n}"
+    ],
+    "name": "Nested Struct Array Chunking Test"
+  },
+  {
+    "result": {"value": [
+      [
+        "1",
+        [["ab"]]
+      ],
+      [
+        "2",
+        [["c"]]
+      ]
+    ]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"STRING\"\n        }\n      }, {\n        \"name\": \"f2\",\n        \"type\": {\n          \"code\": \"ARRAY\",\n          \"arrayElementType\": {\n            \"code\": \"STRUCT\",\n            \"structType\": {\n              \"fields\": [{\n                \"name\": \"f21\",\n                \"type\": {\n                  \"code\": \"STRING\"\n                }\n              }]\n            }\n          }\n        }\n      }]\n    }\n  },\n  \"values\": [\"1\", [[\"a\"]]],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [[[\"b\"]], \"2\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"\", [[\"c\"]]]\n}"
+    ],
+    "name": "Struct Array And String Chunking Test"
+  },
+  {
+    "result": {"value": [
+      [
+        "abc",
+        "1"
+      ],
+      [
+        "def",
+        "2"
+      ]
+    ]},
+    "chunks": ["{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"STRING\"\n        }\n      }, {\n        \"name\": \"f2\",\n        \"type\": {\n          \"code\": \"INT64\"\n        }\n      }]\n    }\n  },\n  \"values\": [\"abc\", \"1\", \"def\", \"2\"]\n}"],
+    "name": "Multiple Row Single Chunk"
+  },
+  {
+    "result": {"value": [
+      [
+        "abc",
+        "1"
+      ],
+      [
+        "def",
+        "2"
+      ]
+    ]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"STRING\"\n        }\n      }, {\n        \"name\": \"f2\",\n        \"type\": {\n          \"code\": \"INT64\"\n        }\n      }]\n    }\n  },\n  \"values\": [\"ab\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"c\", \"1\", \"de\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"f\", \"2\"]\n}"
+    ],
+    "name": "Multiple Row Multiple Chunks"
+  },
+  {
+    "result": {"value": [
+      ["ab"],
+      ["c"],
+      ["d"],
+      ["ef"]
+    ]},
+    "chunks": [
+      "{\n  \"metadata\": {\n    \"rowType\": {\n      \"fields\": [{\n        \"name\": \"f1\",\n        \"type\": {\n          \"code\": \"STRING\"\n        }\n      }]\n    }\n  },\n  \"values\": [\"a\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"b\", \"c\"]\n}",
+      "{\n  \"values\": [\"d\", \"e\"],\n  \"chunkedValue\": true\n}",
+      "{\n  \"values\": [\"f\"]\n}"
+    ],
+    "name": "Multiple Row Chunks/Non Chunks Interleaved"
+  }
+]}
diff --git a/spanner/tests/unit/test__helpers.py b/spanner/tests/unit/test__helpers.py
new file mode 100644
index 000000000000..86ce78727b46
--- /dev/null
+++ b/spanner/tests/unit/test__helpers.py
@@ -0,0 +1,453 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+
+
+class Test_make_value_pb(unittest.TestCase):
+    def _callFUT(self, *args, **kw):
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        return _make_value_pb(*args, **kw)
+
+    def test_w_None(self):
+        value_pb = self._callFUT(None)
+        self.assertTrue(value_pb.HasField("null_value"))
+
+    def test_w_bytes(self):
+        from google.protobuf.struct_pb2 import Value
+
+        BYTES = b"BYTES"
+        expected = Value(string_value=BYTES)
+        value_pb = self._callFUT(BYTES)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb, expected)
+
+    def test_w_invalid_bytes(self):
+        BYTES = b"\xff\xfe\x03&"
+        with self.assertRaises(ValueError):
+            self._callFUT(BYTES)
+
+    def test_w_explicit_unicode(self):
+        from google.protobuf.struct_pb2 import Value
+
+        TEXT = u"TEXT"
+        value_pb = self._callFUT(TEXT)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, TEXT)
+
+    def test_w_list(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.protobuf.struct_pb2 import ListValue
+
+        value_pb = self._callFUT([u"a", u"b", u"c"])
+        self.assertIsInstance(value_pb, Value)
+        self.assertIsInstance(value_pb.list_value, ListValue)
+        values = value_pb.list_value.values
+        self.assertEqual([value.string_value for value in values], [u"a", u"b", u"c"])
+
+    def test_w_tuple(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.protobuf.struct_pb2 import ListValue
+
+        value_pb = self._callFUT((u"a", u"b", u"c"))
+        self.assertIsInstance(value_pb, Value)
+        self.assertIsInstance(value_pb.list_value, ListValue)
+        values = value_pb.list_value.values
+        self.assertEqual([value.string_value for value in values], [u"a", u"b", u"c"])
+
+    def test_w_bool(self):
+        from google.protobuf.struct_pb2 import Value
+
+        value_pb = self._callFUT(True)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.bool_value, True)
+
+    def test_w_int(self):
+        import six
+        from google.protobuf.struct_pb2 import Value
+
+        for int_type in six.integer_types:  # include 'long' on Python 2
+            value_pb = self._callFUT(int_type(42))
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, "42")
+
+    def test_w_float(self):
+        from google.protobuf.struct_pb2 import Value
+
+        value_pb = self._callFUT(3.14159)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.number_value, 3.14159)
+
+    def test_w_float_nan(self):
+        from google.protobuf.struct_pb2 import Value
+
+        value_pb = self._callFUT(float("nan"))
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, "NaN")
+
+    def test_w_float_neg_inf(self):
+        from google.protobuf.struct_pb2 import Value
+
+        value_pb = self._callFUT(float("-inf"))
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, "-Infinity")
+
+    def test_w_float_pos_inf(self):
+        from google.protobuf.struct_pb2 import Value
+
+        value_pb = self._callFUT(float("inf"))
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, "Infinity")
+
+    def test_w_date(self):
+        import datetime
+        from google.protobuf.struct_pb2 import Value
+
+        today = datetime.date.today()
+        value_pb = self._callFUT(today)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, today.isoformat())
+
+    def test_w_timestamp_w_nanos(self):
+        import pytz
+        from google.protobuf.struct_pb2 import Value
+        from google.api_core import datetime_helpers
+
+        when = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=123456789, tzinfo=pytz.UTC
+        )
+        value_pb = self._callFUT(when)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, when.rfc3339())
+
+    def test_w_listvalue(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1._helpers import _make_list_value_pb
+
+        list_value = _make_list_value_pb([1, 2, 3])
+        value_pb = self._callFUT(list_value)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.list_value, list_value)
+
+    def test_w_datetime(self):
+        import datetime
+        import pytz
+        from google.protobuf.struct_pb2 import Value
+        from google.api_core import datetime_helpers
+
+        now = datetime.datetime.utcnow().replace(tzinfo=pytz.UTC)
+        value_pb = self._callFUT(now)
+        self.assertIsInstance(value_pb, Value)
+        self.assertEqual(value_pb.string_value, datetime_helpers.to_rfc3339(now))
+
+    def test_w_unknown_type(self):
+        with self.assertRaises(ValueError):
+            self._callFUT(object())
+
+
+class Test_make_list_value_pb(unittest.TestCase):
+    def _callFUT(self, *args, **kw):
+        from google.cloud.spanner_v1._helpers import _make_list_value_pb
+
+        return _make_list_value_pb(*args, **kw)
+
+    def test_empty(self):
+        from google.protobuf.struct_pb2 import ListValue
+
+        result = self._callFUT(values=[])
+        self.assertIsInstance(result, ListValue)
+        self.assertEqual(len(result.values), 0)
+
+    def test_w_single_value(self):
+        from google.protobuf.struct_pb2 import ListValue
+
+        VALUE = u"value"
+        result = self._callFUT(values=[VALUE])
+        self.assertIsInstance(result, ListValue)
+        self.assertEqual(len(result.values), 1)
+        self.assertEqual(result.values[0].string_value, VALUE)
+
+    def test_w_multiple_values(self):
+        from google.protobuf.struct_pb2 import ListValue
+
+        VALUE_1 = u"value"
+        VALUE_2 = 42
+        result = self._callFUT(values=[VALUE_1, VALUE_2])
+        self.assertIsInstance(result, ListValue)
+        self.assertEqual(len(result.values), 2)
+        self.assertEqual(result.values[0].string_value, VALUE_1)
+        self.assertEqual(result.values[1].string_value, str(VALUE_2))
+
+
+class Test_make_list_value_pbs(unittest.TestCase):
+    def _callFUT(self, *args, **kw):
+        from google.cloud.spanner_v1._helpers import _make_list_value_pbs
+
+        return _make_list_value_pbs(*args, **kw)
+
+    def test_empty(self):
+        result = self._callFUT(values=[])
+        self.assertEqual(result, [])
+
+    def test_w_single_values(self):
+        from google.protobuf.struct_pb2 import ListValue
+
+        values = [[0], [1]]
+        result = self._callFUT(values=values)
+        self.assertEqual(len(result), len(values))
+        for found, expected in zip(result, values):
+            self.assertIsInstance(found, ListValue)
+            self.assertEqual(len(found.values), 1)
+            self.assertEqual(found.values[0].string_value, str(expected[0]))
+
+    def test_w_multiple_values(self):
+        from google.protobuf.struct_pb2 import ListValue
+
+        values = [[0, u"A"], [1, u"B"]]
+        result = self._callFUT(values=values)
+        self.assertEqual(len(result), len(values))
+        for found, expected in zip(result, values):
+            self.assertIsInstance(found, ListValue)
+            self.assertEqual(len(found.values), 2)
+            self.assertEqual(found.values[0].string_value, str(expected[0]))
+            self.assertEqual(found.values[1].string_value, expected[1])
+
+
+class Test_parse_value_pb(unittest.TestCase):
+    def _callFUT(self, *args, **kw):
+        from google.cloud.spanner_v1._helpers import _parse_value_pb
+
+        return _parse_value_pb(*args, **kw)
+
+    def test_w_null(self):
+        from google.protobuf.struct_pb2 import Value, NULL_VALUE
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, STRING
+
+        field_type = Type(code=STRING)
+        value_pb = Value(null_value=NULL_VALUE)
+
+        self.assertEqual(self._callFUT(value_pb, field_type), None)
+
+    def test_w_string(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, STRING
+
+        VALUE = u"Value"
+        field_type = Type(code=STRING)
+        value_pb = Value(string_value=VALUE)
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUE)
+
+    def test_w_bytes(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, BYTES
+
+        VALUE = b"Value"
+        field_type = Type(code=BYTES)
+        value_pb = Value(string_value=VALUE)
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUE)
+
+    def test_w_bool(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, BOOL
+
+        VALUE = True
+        field_type = Type(code=BOOL)
+        value_pb = Value(bool_value=VALUE)
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUE)
+
+    def test_w_int(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, INT64
+
+        VALUE = 12345
+        field_type = Type(code=INT64)
+        value_pb = Value(string_value=str(VALUE))
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUE)
+
+    def test_w_float(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, FLOAT64
+
+        VALUE = 3.14159
+        field_type = Type(code=FLOAT64)
+        value_pb = Value(number_value=VALUE)
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUE)
+
+    def test_w_date(self):
+        import datetime
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, DATE
+
+        VALUE = datetime.date.today()
+        field_type = Type(code=DATE)
+        value_pb = Value(string_value=VALUE.isoformat())
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUE)
+
+    def test_w_timestamp_wo_nanos(self):
+        import pytz
+        from google.protobuf.struct_pb2 import Value
+        from google.api_core import datetime_helpers
+        from google.cloud.spanner_v1.proto.type_pb2 import TIMESTAMP
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        value = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, microsecond=123456, tzinfo=pytz.UTC
+        )
+        field_type = Type(code=TIMESTAMP)
+        value_pb = Value(string_value=datetime_helpers.to_rfc3339(value))
+
+        parsed = self._callFUT(value_pb, field_type)
+        self.assertIsInstance(parsed, datetime_helpers.DatetimeWithNanoseconds)
+        self.assertEqual(parsed, value)
+
+    def test_w_timestamp_w_nanos(self):
+        import pytz
+        from google.protobuf.struct_pb2 import Value
+        from google.api_core import datetime_helpers
+        from google.cloud.spanner_v1.proto.type_pb2 import TIMESTAMP
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        value = datetime_helpers.DatetimeWithNanoseconds(
+            2016, 12, 20, 21, 13, 47, nanosecond=123456789, tzinfo=pytz.UTC
+        )
+        field_type = Type(code=TIMESTAMP)
+        value_pb = Value(string_value=datetime_helpers.to_rfc3339(value))
+
+        parsed = self._callFUT(value_pb, field_type)
+        self.assertIsInstance(parsed, datetime_helpers.DatetimeWithNanoseconds)
+        self.assertEqual(parsed, value)
+
+    def test_w_array_empty(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, ARRAY, INT64
+
+        field_type = Type(code=ARRAY, array_element_type=Type(code=INT64))
+        value_pb = Value()
+
+        self.assertEqual(self._callFUT(value_pb, field_type), [])
+
+    def test_w_array_non_empty(self):
+        from google.protobuf.struct_pb2 import Value, ListValue
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, ARRAY, INT64
+
+        field_type = Type(code=ARRAY, array_element_type=Type(code=INT64))
+        VALUES = [32, 19, 5]
+        values_pb = ListValue(
+            values=[Value(string_value=str(value)) for value in VALUES]
+        )
+        value_pb = Value(list_value=values_pb)
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUES)
+
+    def test_w_struct(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import STRUCT, STRING, INT64
+        from google.cloud.spanner_v1._helpers import _make_list_value_pb
+
+        VALUES = [u"phred", 32]
+        struct_type_pb = StructType(
+            fields=[
+                StructType.Field(name="name", type=Type(code=STRING)),
+                StructType.Field(name="age", type=Type(code=INT64)),
+            ]
+        )
+        field_type = Type(code=STRUCT, struct_type=struct_type_pb)
+        value_pb = Value(list_value=_make_list_value_pb(VALUES))
+
+        self.assertEqual(self._callFUT(value_pb, field_type), VALUES)
+
+    def test_w_unknown_type(self):
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+        from google.cloud.spanner_v1.proto.type_pb2 import TYPE_CODE_UNSPECIFIED
+
+        field_type = Type(code=TYPE_CODE_UNSPECIFIED)
+        value_pb = Value(string_value="Borked")
+
+        with self.assertRaises(ValueError):
+            self._callFUT(value_pb, field_type)
+
+
+class Test_parse_list_value_pbs(unittest.TestCase):
+    def _callFUT(self, *args, **kw):
+        from google.cloud.spanner_v1._helpers import _parse_list_value_pbs
+
+        return _parse_list_value_pbs(*args, **kw)
+
+    def test_empty(self):
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import STRING, INT64
+
+        struct_type_pb = StructType(
+            fields=[
+                StructType.Field(name="name", type=Type(code=STRING)),
+                StructType.Field(name="age", type=Type(code=INT64)),
+            ]
+        )
+
+        self.assertEqual(self._callFUT(rows=[], row_type=struct_type_pb), [])
+
+    def test_non_empty(self):
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import STRING, INT64
+        from google.cloud.spanner_v1._helpers import _make_list_value_pbs
+
+        VALUES = [[u"phred", 32], [u"bharney", 31]]
+        struct_type_pb = StructType(
+            fields=[
+                StructType.Field(name="name", type=Type(code=STRING)),
+                StructType.Field(name="age", type=Type(code=INT64)),
+            ]
+        )
+        values_pbs = _make_list_value_pbs(VALUES)
+
+        self.assertEqual(
+            self._callFUT(rows=values_pbs, row_type=struct_type_pb), VALUES
+        )
+
+
+class Test_SessionWrapper(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1._helpers import _SessionWrapper
+
+        return _SessionWrapper
+
+    def _make_one(self, session):
+        return self._getTargetClass()(session)
+
+    def test_ctor(self):
+        session = object()
+        base = self._make_one(session)
+        self.assertIs(base._session, session)
+
+
+class Test_metadata_with_prefix(unittest.TestCase):
+    def _call_fut(self, *args, **kw):
+        from google.cloud.spanner_v1._helpers import _metadata_with_prefix
+
+        return _metadata_with_prefix(*args, **kw)
+
+    def test(self):
+        prefix = "prefix"
+        metadata = self._call_fut(prefix)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", prefix)])
diff --git a/spanner/tests/unit/test_batch.py b/spanner/tests/unit/test_batch.py
new file mode 100644
index 000000000000..f4fd9d12ab3d
--- /dev/null
+++ b/spanner/tests/unit/test_batch.py
@@ -0,0 +1,340 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+
+
+TABLE_NAME = "citizens"
+COLUMNS = ["email", "first_name", "last_name", "age"]
+VALUES = [
+    [u"phred@exammple.com", u"Phred", u"Phlyntstone", 32],
+    [u"bharney@example.com", u"Bharney", u"Rhubble", 31],
+]
+
+
+class _BaseTest(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    DATABASE_ID = "database-id"
+    DATABASE_NAME = INSTANCE_NAME + "/databases/" + DATABASE_ID
+    SESSION_ID = "session-id"
+    SESSION_NAME = DATABASE_NAME + "/sessions/" + SESSION_ID
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+
+class Test_BatchBase(_BaseTest):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.batch import _BatchBase
+
+        return _BatchBase
+
+    def _compare_values(self, result, source):
+        from google.protobuf.struct_pb2 import ListValue
+        from google.protobuf.struct_pb2 import Value
+
+        for found, expected in zip(result, source):
+            self.assertIsInstance(found, ListValue)
+            self.assertEqual(len(found.values), len(expected))
+            for found_cell, expected_cell in zip(found.values, expected):
+                self.assertIsInstance(found_cell, Value)
+                if isinstance(expected_cell, int):
+                    self.assertEqual(int(found_cell.string_value), expected_cell)
+                else:
+                    self.assertEqual(found_cell.string_value, expected_cell)
+
+    def test_ctor(self):
+        session = _Session()
+        base = self._make_one(session)
+        self.assertIs(base._session, session)
+        self.assertEqual(len(base._mutations), 0)
+
+    def test__check_state_virtual(self):
+        session = _Session()
+        base = self._make_one(session)
+        with self.assertRaises(NotImplementedError):
+            base._check_state()
+
+    def test_insert(self):
+        from google.cloud.spanner_v1.proto.mutation_pb2 import Mutation
+
+        session = _Session()
+        base = self._make_one(session)
+
+        base.insert(TABLE_NAME, columns=COLUMNS, values=VALUES)
+
+        self.assertEqual(len(base._mutations), 1)
+        mutation = base._mutations[0]
+        self.assertIsInstance(mutation, Mutation)
+        write = mutation.insert
+        self.assertIsInstance(write, Mutation.Write)
+        self.assertEqual(write.table, TABLE_NAME)
+        self.assertEqual(write.columns, COLUMNS)
+        self._compare_values(write.values, VALUES)
+
+    def test_update(self):
+        from google.cloud.spanner_v1.proto.mutation_pb2 import Mutation
+
+        session = _Session()
+        base = self._make_one(session)
+
+        base.update(TABLE_NAME, columns=COLUMNS, values=VALUES)
+
+        self.assertEqual(len(base._mutations), 1)
+        mutation = base._mutations[0]
+        self.assertIsInstance(mutation, Mutation)
+        write = mutation.update
+        self.assertIsInstance(write, Mutation.Write)
+        self.assertEqual(write.table, TABLE_NAME)
+        self.assertEqual(write.columns, COLUMNS)
+        self._compare_values(write.values, VALUES)
+
+    def test_insert_or_update(self):
+        from google.cloud.spanner_v1.proto.mutation_pb2 import Mutation
+
+        session = _Session()
+        base = self._make_one(session)
+
+        base.insert_or_update(TABLE_NAME, columns=COLUMNS, values=VALUES)
+
+        self.assertEqual(len(base._mutations), 1)
+        mutation = base._mutations[0]
+        self.assertIsInstance(mutation, Mutation)
+        write = mutation.insert_or_update
+        self.assertIsInstance(write, Mutation.Write)
+        self.assertEqual(write.table, TABLE_NAME)
+        self.assertEqual(write.columns, COLUMNS)
+        self._compare_values(write.values, VALUES)
+
+    def test_replace(self):
+        from google.cloud.spanner_v1.proto.mutation_pb2 import Mutation
+
+        session = _Session()
+        base = self._make_one(session)
+
+        base.replace(TABLE_NAME, columns=COLUMNS, values=VALUES)
+
+        self.assertEqual(len(base._mutations), 1)
+        mutation = base._mutations[0]
+        self.assertIsInstance(mutation, Mutation)
+        write = mutation.replace
+        self.assertIsInstance(write, Mutation.Write)
+        self.assertEqual(write.table, TABLE_NAME)
+        self.assertEqual(write.columns, COLUMNS)
+        self._compare_values(write.values, VALUES)
+
+    def test_delete(self):
+        from google.cloud.spanner_v1.proto.mutation_pb2 import Mutation
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        keys = [[0], [1], [2]]
+        keyset = KeySet(keys=keys)
+        session = _Session()
+        base = self._make_one(session)
+
+        base.delete(TABLE_NAME, keyset=keyset)
+
+        self.assertEqual(len(base._mutations), 1)
+        mutation = base._mutations[0]
+        self.assertIsInstance(mutation, Mutation)
+        delete = mutation.delete
+        self.assertIsInstance(delete, Mutation.Delete)
+        self.assertEqual(delete.table, TABLE_NAME)
+        key_set_pb = delete.key_set
+        self.assertEqual(len(key_set_pb.ranges), 0)
+        self.assertEqual(len(key_set_pb.keys), len(keys))
+        for found, expected in zip(key_set_pb.keys, keys):
+            self.assertEqual(
+                [int(value.string_value) for value in found.values], expected
+            )
+
+
+class TestBatch(_BaseTest):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.batch import Batch
+
+        return Batch
+
+    def test_ctor(self):
+        session = _Session()
+        batch = self._make_one(session)
+        self.assertIs(batch._session, session)
+
+    def test_commit_already_committed(self):
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        keys = [[0], [1], [2]]
+        keyset = KeySet(keys=keys)
+        database = _Database()
+        session = _Session(database)
+        batch = self._make_one(session)
+        batch.committed = object()
+        batch.delete(TABLE_NAME, keyset=keyset)
+
+        with self.assertRaises(ValueError):
+            batch.commit()
+
+    def test_commit_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        keys = [[0], [1], [2]]
+        keyset = KeySet(keys=keys)
+        database = _Database()
+        database.spanner_api = _FauxSpannerAPI(_rpc_error=True)
+        session = _Session(database)
+        batch = self._make_one(session)
+        batch.delete(TABLE_NAME, keyset=keyset)
+
+        with self.assertRaises(Unknown):
+            batch.commit()
+
+    def test_commit_ok(self):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionOptions
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(_commit_response=response)
+        session = _Session(database)
+        batch = self._make_one(session)
+        batch.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        committed = batch.commit()
+
+        self.assertEqual(committed, now)
+        self.assertEqual(batch.committed, committed)
+
+        (session, mutations, single_use_txn, metadata) = api._committed
+        self.assertEqual(session, self.SESSION_NAME)
+        self.assertEqual(mutations, batch._mutations)
+        self.assertIsInstance(single_use_txn, TransactionOptions)
+        self.assertTrue(single_use_txn.HasField("read_write"))
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+    def test_context_mgr_already_committed(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI()
+        session = _Session(database)
+        batch = self._make_one(session)
+        batch.committed = now
+
+        with self.assertRaises(ValueError):
+            with batch:
+                pass  # pragma: NO COVER
+
+        self.assertEqual(api._committed, None)
+
+    def test_context_mgr_success(self):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionOptions
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(_commit_response=response)
+        session = _Session(database)
+        batch = self._make_one(session)
+
+        with batch:
+            batch.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        self.assertEqual(batch.committed, now)
+
+        (session, mutations, single_use_txn, metadata) = api._committed
+        self.assertEqual(session, self.SESSION_NAME)
+        self.assertEqual(mutations, batch._mutations)
+        self.assertIsInstance(single_use_txn, TransactionOptions)
+        self.assertTrue(single_use_txn.HasField("read_write"))
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+    def test_context_mgr_failure(self):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(_commit_response=response)
+        session = _Session(database)
+        batch = self._make_one(session)
+
+        class _BailOut(Exception):
+            pass
+
+        with self.assertRaises(_BailOut):
+            with batch:
+                batch.insert(TABLE_NAME, COLUMNS, VALUES)
+                raise _BailOut()
+
+        self.assertEqual(batch.committed, None)
+        self.assertEqual(api._committed, None)
+        self.assertEqual(len(batch._mutations), 1)
+
+
+class _Session(object):
+    def __init__(self, database=None, name=TestBatch.SESSION_NAME):
+        self._database = database
+        self.name = name
+
+
+class _Database(object):
+    name = "testing"
+
+
+class _FauxSpannerAPI:
+
+    _create_instance_conflict = False
+    _instance_not_found = False
+    _committed = None
+    _rpc_error = False
+
+    def __init__(self, **kwargs):
+        self.__dict__.update(**kwargs)
+
+    def commit(
+        self,
+        session,
+        mutations,
+        transaction_id="",
+        single_use_transaction=None,
+        metadata=None,
+    ):
+        from google.api_core.exceptions import Unknown
+
+        assert transaction_id == ""
+        self._committed = (session, mutations, single_use_transaction, metadata)
+        if self._rpc_error:
+            raise Unknown("error")
+        return self._commit_response
diff --git a/spanner/tests/unit/test_client.py b/spanner/tests/unit/test_client.py
new file mode 100644
index 000000000000..8cef6313afe9
--- /dev/null
+++ b/spanner/tests/unit/test_client.py
@@ -0,0 +1,401 @@
+# Copyright 2016 Google LLC 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.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    class _CredentialsWithScopes(
+        google.auth.credentials.Credentials, google.auth.credentials.Scoped
+    ):
+        pass
+
+    return mock.Mock(spec=_CredentialsWithScopes)
+
+
+class TestClient(unittest.TestCase):
+
+    PROJECT = "PROJECT"
+    PATH = "projects/%s" % (PROJECT,)
+    CONFIGURATION_NAME = "config-name"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "%s/instances/%s" % (PATH, INSTANCE_ID)
+    DISPLAY_NAME = "display-name"
+    NODE_COUNT = 5
+    TIMEOUT_SECONDS = 80
+    USER_AGENT = "you-sir-age-int"
+
+    def _get_target_class(self):
+        from google.cloud import spanner
+
+        return spanner.Client
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def _constructor_test_helper(
+        self,
+        expected_scopes,
+        creds,
+        expected_creds=None,
+        client_info=None,
+        user_agent=None,
+    ):
+        from google.cloud.spanner_v1 import client as MUT
+
+        kwargs = {}
+
+        if client_info is not None:
+            kwargs["client_info"] = expected_client_info = client_info
+        else:
+            expected_client_info = MUT._CLIENT_INFO
+
+        client = self._make_one(
+            project=self.PROJECT, credentials=creds, user_agent=user_agent, **kwargs
+        )
+
+        expected_creds = expected_creds or creds.with_scopes.return_value
+        self.assertIs(client._credentials, expected_creds)
+
+        self.assertIs(client._credentials, expected_creds)
+        if expected_scopes is not None:
+            creds.with_scopes.assert_called_once_with(expected_scopes)
+
+        self.assertEqual(client.project, self.PROJECT)
+        self.assertIs(client._client_info, expected_client_info)
+        self.assertEqual(client.user_agent, user_agent)
+
+    def test_constructor_default_scopes(self):
+        from google.cloud.spanner_v1 import client as MUT
+
+        expected_scopes = (MUT.SPANNER_ADMIN_SCOPE,)
+        creds = _make_credentials()
+        self._constructor_test_helper(expected_scopes, creds)
+
+    @mock.patch("warnings.warn")
+    def test_constructor_custom_user_agent_and_timeout(self, mock_warn):
+        from google.cloud.spanner_v1 import client as MUT
+
+        CUSTOM_USER_AGENT = "custom-application"
+        expected_scopes = (MUT.SPANNER_ADMIN_SCOPE,)
+        creds = _make_credentials()
+        self._constructor_test_helper(
+            expected_scopes, creds, user_agent=CUSTOM_USER_AGENT
+        )
+        mock_warn.assert_called_once_with(
+            MUT._USER_AGENT_DEPRECATED, DeprecationWarning, stacklevel=2
+        )
+
+    def test_constructor_custom_client_info(self):
+        from google.cloud.spanner_v1 import client as MUT
+
+        client_info = mock.Mock()
+        expected_scopes = (MUT.SPANNER_ADMIN_SCOPE,)
+        creds = _make_credentials()
+        self._constructor_test_helper(expected_scopes, creds, client_info=client_info)
+
+    def test_constructor_implicit_credentials(self):
+        creds = _make_credentials()
+
+        patch = mock.patch("google.auth.default", return_value=(creds, None))
+        with patch as default:
+            self._constructor_test_helper(
+                None, None, expected_creds=creds.with_scopes.return_value
+            )
+
+        default.assert_called_once_with()
+
+    def test_constructor_credentials_wo_create_scoped(self):
+        creds = _make_credentials()
+        expected_scopes = None
+        self._constructor_test_helper(expected_scopes, creds)
+
+    def test_instance_admin_api(self):
+        from google.cloud.spanner_v1.client import SPANNER_ADMIN_SCOPE
+
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, client_info=client_info
+        )
+        expected_scopes = (SPANNER_ADMIN_SCOPE,)
+
+        inst_module = "google.cloud.spanner_v1.client.InstanceAdminClient"
+        with mock.patch(inst_module) as instance_admin_client:
+            api = client.instance_admin_api
+
+        self.assertIs(api, instance_admin_client.return_value)
+
+        # API instance is cached
+        again = client.instance_admin_api
+        self.assertIs(again, api)
+
+        instance_admin_client.assert_called_once_with(
+            credentials=credentials.with_scopes.return_value, client_info=client_info
+        )
+
+        credentials.with_scopes.assert_called_once_with(expected_scopes)
+
+    def test_database_admin_api(self):
+        from google.cloud.spanner_v1.client import SPANNER_ADMIN_SCOPE
+
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.PROJECT, credentials=credentials, client_info=client_info
+        )
+        expected_scopes = (SPANNER_ADMIN_SCOPE,)
+
+        db_module = "google.cloud.spanner_v1.client.DatabaseAdminClient"
+        with mock.patch(db_module) as database_admin_client:
+            api = client.database_admin_api
+
+        self.assertIs(api, database_admin_client.return_value)
+
+        # API instance is cached
+        again = client.database_admin_api
+        self.assertIs(again, api)
+
+        database_admin_client.assert_called_once_with(
+            credentials=credentials.with_scopes.return_value, client_info=client_info
+        )
+
+        credentials.with_scopes.assert_called_once_with(expected_scopes)
+
+    def test_copy(self):
+        credentials = _make_credentials()
+        # Make sure it "already" is scoped.
+        credentials.requires_scopes = False
+
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        new_client = client.copy()
+        self.assertIs(new_client._credentials, client._credentials)
+        self.assertEqual(new_client.project, client.project)
+
+    def test_credentials_property(self):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        self.assertIs(client.credentials, credentials.with_scopes.return_value)
+
+    def test_project_name_property(self):
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        project_name = "projects/" + self.PROJECT
+        self.assertEqual(client.project_name, project_name)
+
+    def test_list_instance_configs(self):
+        from google.cloud.spanner_admin_instance_v1.gapic import instance_admin_client
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2,
+        )
+        from google.cloud.spanner_v1.client import InstanceConfig
+
+        api = instance_admin_client.InstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        client._instance_admin_api = api
+
+        instance_config_pbs = spanner_instance_admin_pb2.ListInstanceConfigsResponse(
+            instance_configs=[
+                spanner_instance_admin_pb2.InstanceConfig(
+                    name=self.CONFIGURATION_NAME, display_name=self.DISPLAY_NAME
+                )
+            ]
+        )
+
+        lic_api = api._inner_api_calls["list_instance_configs"] = mock.Mock(
+            return_value=instance_config_pbs
+        )
+
+        response = client.list_instance_configs()
+        instance_configs = list(response)
+
+        instance_config = instance_configs[0]
+        self.assertIsInstance(instance_config, InstanceConfig)
+        self.assertEqual(instance_config.name, self.CONFIGURATION_NAME)
+        self.assertEqual(instance_config.display_name, self.DISPLAY_NAME)
+
+        expected_metadata = [
+            ("google-cloud-resource-prefix", client.project_name),
+            ("x-goog-request-params", "parent={}".format(client.project_name)),
+        ]
+        lic_api.assert_called_once_with(
+            spanner_instance_admin_pb2.ListInstanceConfigsRequest(parent=self.PATH),
+            metadata=expected_metadata,
+            retry=mock.ANY,
+            timeout=mock.ANY,
+        )
+
+    def test_list_instance_configs_w_options(self):
+        from google.cloud.spanner_admin_instance_v1.gapic import instance_admin_client
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2,
+        )
+
+        api = instance_admin_client.InstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        client._instance_admin_api = api
+
+        instance_config_pbs = spanner_instance_admin_pb2.ListInstanceConfigsResponse(
+            instance_configs=[
+                spanner_instance_admin_pb2.InstanceConfig(
+                    name=self.CONFIGURATION_NAME, display_name=self.DISPLAY_NAME
+                )
+            ]
+        )
+
+        lic_api = api._inner_api_calls["list_instance_configs"] = mock.Mock(
+            return_value=instance_config_pbs
+        )
+
+        token = "token"
+        page_size = 42
+        list(client.list_instance_configs(page_token=token, page_size=42))
+
+        expected_metadata = [
+            ("google-cloud-resource-prefix", client.project_name),
+            ("x-goog-request-params", "parent={}".format(client.project_name)),
+        ]
+        lic_api.assert_called_once_with(
+            spanner_instance_admin_pb2.ListInstanceConfigsRequest(
+                parent=self.PATH, page_size=page_size, page_token=token
+            ),
+            metadata=expected_metadata,
+            retry=mock.ANY,
+            timeout=mock.ANY,
+        )
+
+    def test_instance_factory_defaults(self):
+        from google.cloud.spanner_v1.instance import DEFAULT_NODE_COUNT
+        from google.cloud.spanner_v1.instance import Instance
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        instance = client.instance(self.INSTANCE_ID)
+
+        self.assertTrue(isinstance(instance, Instance))
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertIsNone(instance.configuration_name)
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+        self.assertEqual(instance.node_count, DEFAULT_NODE_COUNT)
+        self.assertIs(instance._client, client)
+
+    def test_instance_factory_explicit(self):
+        from google.cloud.spanner_v1.instance import Instance
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+
+        instance = client.instance(
+            self.INSTANCE_ID,
+            self.CONFIGURATION_NAME,
+            display_name=self.DISPLAY_NAME,
+            node_count=self.NODE_COUNT,
+        )
+
+        self.assertTrue(isinstance(instance, Instance))
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.configuration_name, self.CONFIGURATION_NAME)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.node_count, self.NODE_COUNT)
+        self.assertIs(instance._client, client)
+
+    def test_list_instances(self):
+        from google.cloud.spanner_admin_instance_v1.gapic import instance_admin_client
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2,
+        )
+        from google.cloud.spanner_v1.client import Instance
+
+        api = instance_admin_client.InstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        client._instance_admin_api = api
+
+        instance_pbs = spanner_instance_admin_pb2.ListInstancesResponse(
+            instances=[
+                spanner_instance_admin_pb2.Instance(
+                    name=self.INSTANCE_NAME,
+                    config=self.CONFIGURATION_NAME,
+                    display_name=self.DISPLAY_NAME,
+                    node_count=self.NODE_COUNT,
+                )
+            ]
+        )
+
+        li_api = api._inner_api_calls["list_instances"] = mock.Mock(
+            return_value=instance_pbs
+        )
+
+        response = client.list_instances()
+        instances = list(response)
+
+        instance = instances[0]
+        self.assertIsInstance(instance, Instance)
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+        self.assertEqual(instance.configuration_name, self.CONFIGURATION_NAME)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.node_count, self.NODE_COUNT)
+
+        expected_metadata = [
+            ("google-cloud-resource-prefix", client.project_name),
+            ("x-goog-request-params", "parent={}".format(client.project_name)),
+        ]
+        li_api.assert_called_once_with(
+            spanner_instance_admin_pb2.ListInstancesRequest(parent=self.PATH),
+            metadata=expected_metadata,
+            retry=mock.ANY,
+            timeout=mock.ANY,
+        )
+
+    def test_list_instances_w_options(self):
+        from google.cloud.spanner_admin_instance_v1.gapic import instance_admin_client
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2,
+        )
+
+        api = instance_admin_client.InstanceAdminClient(mock.Mock())
+        credentials = _make_credentials()
+        client = self._make_one(project=self.PROJECT, credentials=credentials)
+        client._instance_admin_api = api
+
+        instance_pbs = spanner_instance_admin_pb2.ListInstancesResponse(instances=[])
+
+        li_api = api._inner_api_calls["list_instances"] = mock.Mock(
+            return_value=instance_pbs
+        )
+
+        token = "token"
+        page_size = 42
+        list(client.list_instances(page_token=token, page_size=42))
+
+        expected_metadata = [
+            ("google-cloud-resource-prefix", client.project_name),
+            ("x-goog-request-params", "parent={}".format(client.project_name)),
+        ]
+        li_api.assert_called_once_with(
+            spanner_instance_admin_pb2.ListInstancesRequest(
+                parent=self.PATH, page_size=page_size, page_token=token
+            ),
+            metadata=expected_metadata,
+            retry=mock.ANY,
+            timeout=mock.ANY,
+        )
diff --git a/spanner/tests/unit/test_database.py b/spanner/tests/unit/test_database.py
new file mode 100644
index 000000000000..e553e0bbb8dc
--- /dev/null
+++ b/spanner/tests/unit/test_database.py
@@ -0,0 +1,1583 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+
+import mock
+
+
+DML_WO_PARAM = """
+DELETE FROM citizens
+"""
+
+DML_W_PARAM = """
+INSERT INTO citizens(first_name, last_name, age)
+VALUES ("Phred", "Phlyntstone", @age)
+"""
+PARAMS = {"age": 30}
+PARAM_TYPES = {"age": "INT64"}
+MODE = 2  # PROFILE
+
+
+def _make_credentials():  # pragma: NO COVER
+    import google.auth.credentials
+
+    class _CredentialsWithScopes(
+        google.auth.credentials.Credentials, google.auth.credentials.Scoped
+    ):
+        pass
+
+    return mock.Mock(spec=_CredentialsWithScopes)
+
+
+class _BaseTest(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    PARENT = "projects/" + PROJECT_ID
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = PARENT + "/instances/" + INSTANCE_ID
+    DATABASE_ID = "database_id"
+    DATABASE_NAME = INSTANCE_NAME + "/databases/" + DATABASE_ID
+    SESSION_ID = "session_id"
+    SESSION_NAME = DATABASE_NAME + "/sessions/" + SESSION_ID
+    TRANSACTION_ID = b"transaction_id"
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    @staticmethod
+    def _make_timestamp():
+        import datetime
+        from google.cloud._helpers import UTC
+
+        return datetime.datetime.utcnow().replace(tzinfo=UTC)
+
+    @staticmethod
+    def _make_duration(seconds=1, microseconds=0):
+        import datetime
+
+        return datetime.timedelta(seconds=seconds, microseconds=microseconds)
+
+
+class TestDatabase(_BaseTest):
+    def _get_target_class(self):
+        from google.cloud.spanner_v1.database import Database
+
+        return Database
+
+    @staticmethod
+    def _make_database_admin_api():
+        from google.cloud.spanner_v1.client import DatabaseAdminClient
+
+        return mock.create_autospec(DatabaseAdminClient, instance=True)
+
+    @staticmethod
+    def _make_spanner_api():
+        import google.cloud.spanner_v1.gapic.spanner_client
+
+        return mock.create_autospec(
+            google.cloud.spanner_v1.gapic.spanner_client.SpannerClient, instance=True
+        )
+
+    def test_ctor_defaults(self):
+        from google.cloud.spanner_v1.pool import BurstyPool
+
+        instance = _Instance(self.INSTANCE_NAME)
+
+        database = self._make_one(self.DATABASE_ID, instance)
+
+        self.assertEqual(database.database_id, self.DATABASE_ID)
+        self.assertIs(database._instance, instance)
+        self.assertEqual(list(database.ddl_statements), [])
+        self.assertIsInstance(database._pool, BurstyPool)
+        # BurstyPool does not create sessions during 'bind()'.
+        self.assertTrue(database._pool._sessions.empty())
+
+    def test_ctor_w_explicit_pool(self):
+        instance = _Instance(self.INSTANCE_NAME)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+        self.assertEqual(database.database_id, self.DATABASE_ID)
+        self.assertIs(database._instance, instance)
+        self.assertEqual(list(database.ddl_statements), [])
+        self.assertIs(database._pool, pool)
+        self.assertIs(pool._bound, database)
+
+    def test_ctor_w_ddl_statements_non_string(self):
+
+        with self.assertRaises(ValueError):
+            self._make_one(
+                self.DATABASE_ID, instance=object(), ddl_statements=[object()]
+            )
+
+    def test_ctor_w_ddl_statements_w_create_database(self):
+
+        with self.assertRaises(ValueError):
+            self._make_one(
+                self.DATABASE_ID,
+                instance=object(),
+                ddl_statements=["CREATE DATABASE foo"],
+            )
+
+    def test_ctor_w_ddl_statements_ok(self):
+        from tests._fixtures import DDL_STATEMENTS
+
+        instance = _Instance(self.INSTANCE_NAME)
+        pool = _Pool()
+        database = self._make_one(
+            self.DATABASE_ID, instance, ddl_statements=DDL_STATEMENTS, pool=pool
+        )
+        self.assertEqual(database.database_id, self.DATABASE_ID)
+        self.assertIs(database._instance, instance)
+        self.assertEqual(list(database.ddl_statements), DDL_STATEMENTS)
+
+    def test_from_pb_bad_database_name(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+
+        database_name = "INCORRECT_FORMAT"
+        database_pb = admin_v1_pb2.Database(name=database_name)
+        klass = self._get_target_class()
+
+        with self.assertRaises(ValueError):
+            klass.from_pb(database_pb, None)
+
+    def test_from_pb_project_mistmatch(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+
+        ALT_PROJECT = "ALT_PROJECT"
+        client = _Client(project=ALT_PROJECT)
+        instance = _Instance(self.INSTANCE_NAME, client)
+        database_pb = admin_v1_pb2.Database(name=self.DATABASE_NAME)
+        klass = self._get_target_class()
+
+        with self.assertRaises(ValueError):
+            klass.from_pb(database_pb, instance)
+
+    def test_from_pb_instance_mistmatch(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+
+        ALT_INSTANCE = "/projects/%s/instances/ALT-INSTANCE" % (self.PROJECT_ID,)
+        client = _Client()
+        instance = _Instance(ALT_INSTANCE, client)
+        database_pb = admin_v1_pb2.Database(name=self.DATABASE_NAME)
+        klass = self._get_target_class()
+
+        with self.assertRaises(ValueError):
+            klass.from_pb(database_pb, instance)
+
+    def test_from_pb_success_w_explicit_pool(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client)
+        database_pb = admin_v1_pb2.Database(name=self.DATABASE_NAME)
+        klass = self._get_target_class()
+        pool = _Pool()
+
+        database = klass.from_pb(database_pb, instance, pool=pool)
+
+        self.assertTrue(isinstance(database, klass))
+        self.assertEqual(database._instance, instance)
+        self.assertEqual(database.database_id, self.DATABASE_ID)
+        self.assertIs(database._pool, pool)
+
+    def test_from_pb_success_w_hyphen_w_default_pool(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+        from google.cloud.spanner_v1.pool import BurstyPool
+
+        DATABASE_ID_HYPHEN = "database-id"
+        DATABASE_NAME_HYPHEN = self.INSTANCE_NAME + "/databases/" + DATABASE_ID_HYPHEN
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client)
+        database_pb = admin_v1_pb2.Database(name=DATABASE_NAME_HYPHEN)
+        klass = self._get_target_class()
+
+        database = klass.from_pb(database_pb, instance)
+
+        self.assertTrue(isinstance(database, klass))
+        self.assertEqual(database._instance, instance)
+        self.assertEqual(database.database_id, DATABASE_ID_HYPHEN)
+        self.assertIsInstance(database._pool, BurstyPool)
+        # BurstyPool does not create sessions during 'bind()'.
+        self.assertTrue(database._pool._sessions.empty())
+
+    def test_name_property(self):
+        instance = _Instance(self.INSTANCE_NAME)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+        expected_name = self.DATABASE_NAME
+        self.assertEqual(database.name, expected_name)
+
+    def test_spanner_api_property_w_scopeless_creds(self):
+        client = _Client()
+        client_info = client._client_info = mock.Mock()
+        credentials = client.credentials = object()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        patch = mock.patch("google.cloud.spanner_v1.database.SpannerClient")
+
+        with patch as spanner_client:
+            api = database.spanner_api
+
+        self.assertIs(api, spanner_client.return_value)
+
+        # API instance is cached
+        again = database.spanner_api
+        self.assertIs(again, api)
+
+        spanner_client.assert_called_once_with(
+            credentials=credentials, client_info=client_info
+        )
+
+    def test_spanner_api_w_scoped_creds(self):
+        import google.auth.credentials
+        from google.cloud.spanner_v1.database import SPANNER_DATA_SCOPE
+
+        class _CredentialsWithScopes(google.auth.credentials.Scoped):
+            def __init__(self, scopes=(), source=None):
+                self._scopes = scopes
+                self._source = source
+
+            def requires_scopes(self):  # pragma: NO COVER
+                return True
+
+            def with_scopes(self, scopes):
+                return self.__class__(scopes, self)
+
+        expected_scopes = (SPANNER_DATA_SCOPE,)
+        client = _Client()
+        client_info = client._client_info = mock.Mock()
+        credentials = client.credentials = _CredentialsWithScopes()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        patch = mock.patch("google.cloud.spanner_v1.database.SpannerClient")
+
+        with patch as spanner_client:
+            api = database.spanner_api
+
+        self.assertIs(api, spanner_client.return_value)
+
+        # API instance is cached
+        again = database.spanner_api
+        self.assertIs(again, api)
+
+        self.assertEqual(len(spanner_client.call_args_list), 1)
+        called_args, called_kw = spanner_client.call_args
+        self.assertEqual(called_args, ())
+        self.assertEqual(called_kw["client_info"], client_info)
+        scoped = called_kw["credentials"]
+        self.assertEqual(scoped._scopes, expected_scopes)
+        self.assertIs(scoped._source, credentials)
+
+    def test___eq__(self):
+        instance = _Instance(self.INSTANCE_NAME)
+        pool1, pool2 = _Pool(), _Pool()
+        database1 = self._make_one(self.DATABASE_ID, instance, pool=pool1)
+        database2 = self._make_one(self.DATABASE_ID, instance, pool=pool2)
+        self.assertEqual(database1, database2)
+
+    def test___eq__type_differ(self):
+        pool = _Pool()
+        database1 = self._make_one(self.DATABASE_ID, None, pool=pool)
+        database2 = object()
+        self.assertNotEqual(database1, database2)
+
+    def test___ne__same_value(self):
+        instance = _Instance(self.INSTANCE_NAME)
+        pool1, pool2 = _Pool(), _Pool()
+        database1 = self._make_one(self.DATABASE_ID, instance, pool=pool1)
+        database2 = self._make_one(self.DATABASE_ID, instance, pool=pool2)
+        comparison_val = database1 != database2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        pool1, pool2 = _Pool(), _Pool()
+        database1 = self._make_one("database_id1", "instance1", pool=pool1)
+        database2 = self._make_one("database_id2", "instance2", pool=pool2)
+        self.assertNotEqual(database1, database2)
+
+    def test_create_grpc_error(self):
+        from google.api_core.exceptions import GoogleAPICallError
+        from google.api_core.exceptions import Unknown
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.create_database.side_effect = Unknown("testing")
+
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(GoogleAPICallError):
+            database.create()
+
+        api.create_database.assert_called_once_with(
+            parent=self.INSTANCE_NAME,
+            create_statement="CREATE DATABASE {}".format(self.DATABASE_ID),
+            extra_statements=[],
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_create_already_exists(self):
+        from google.cloud.exceptions import Conflict
+
+        DATABASE_ID_HYPHEN = "database-id"
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.create_database.side_effect = Conflict("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(DATABASE_ID_HYPHEN, instance, pool=pool)
+
+        with self.assertRaises(Conflict):
+            database.create()
+
+        api.create_database.assert_called_once_with(
+            parent=self.INSTANCE_NAME,
+            create_statement="CREATE DATABASE `{}`".format(DATABASE_ID_HYPHEN),
+            extra_statements=[],
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_create_instance_not_found(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.create_database.side_effect = NotFound("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(NotFound):
+            database.create()
+
+        api.create_database.assert_called_once_with(
+            parent=self.INSTANCE_NAME,
+            create_statement="CREATE DATABASE {}".format(self.DATABASE_ID),
+            extra_statements=[],
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_create_success(self):
+        from tests._fixtures import DDL_STATEMENTS
+
+        op_future = object()
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.create_database.return_value = op_future
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(
+            self.DATABASE_ID, instance, ddl_statements=DDL_STATEMENTS, pool=pool
+        )
+
+        future = database.create()
+
+        self.assertIs(future, op_future)
+
+        api.create_database.assert_called_once_with(
+            parent=self.INSTANCE_NAME,
+            create_statement="CREATE DATABASE {}".format(self.DATABASE_ID),
+            extra_statements=DDL_STATEMENTS,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_exists_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.get_database_ddl.side_effect = Unknown("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(Unknown):
+            database.exists()
+
+        api.get_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_exists_not_found(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.get_database_ddl.side_effect = NotFound("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        self.assertFalse(database.exists())
+
+        api.get_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_exists_success(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+        from tests._fixtures import DDL_STATEMENTS
+
+        client = _Client()
+        ddl_pb = admin_v1_pb2.GetDatabaseDdlResponse(statements=DDL_STATEMENTS)
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.get_database_ddl.return_value = ddl_pb
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        self.assertTrue(database.exists())
+
+        api.get_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_reload_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.get_database_ddl.side_effect = Unknown("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(Unknown):
+            database.reload()
+
+        api.get_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_reload_not_found(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.get_database_ddl.side_effect = NotFound("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(NotFound):
+            database.reload()
+
+        api.get_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_reload_success(self):
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2 as admin_v1_pb2,
+        )
+        from tests._fixtures import DDL_STATEMENTS
+
+        client = _Client()
+        ddl_pb = admin_v1_pb2.GetDatabaseDdlResponse(statements=DDL_STATEMENTS)
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.get_database_ddl.return_value = ddl_pb
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        database.reload()
+
+        self.assertEqual(database._ddl_statements, tuple(DDL_STATEMENTS))
+
+        api.get_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_update_ddl_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+        from tests._fixtures import DDL_STATEMENTS
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.update_database_ddl.side_effect = Unknown("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(Unknown):
+            database.update_ddl(DDL_STATEMENTS)
+
+        api.update_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            DDL_STATEMENTS,
+            "",
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_update_ddl_not_found(self):
+        from google.cloud.exceptions import NotFound
+        from tests._fixtures import DDL_STATEMENTS
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.update_database_ddl.side_effect = NotFound("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(NotFound):
+            database.update_ddl(DDL_STATEMENTS)
+
+        api.update_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            DDL_STATEMENTS,
+            "",
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_update_ddl(self):
+        from tests._fixtures import DDL_STATEMENTS
+
+        op_future = object()
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.update_database_ddl.return_value = op_future
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        future = database.update_ddl(DDL_STATEMENTS)
+
+        self.assertIs(future, op_future)
+
+        api.update_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            DDL_STATEMENTS,
+            "",
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_update_ddl_w_operation_id(self):
+        from tests._fixtures import DDL_STATEMENTS
+
+        op_future = object()
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.update_database_ddl.return_value = op_future
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        future = database.update_ddl(DDL_STATEMENTS, operation_id="someOperationId")
+
+        self.assertIs(future, op_future)
+
+        api.update_database_ddl.assert_called_once_with(
+            self.DATABASE_NAME,
+            DDL_STATEMENTS,
+            "someOperationId",
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_drop_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.drop_database.side_effect = Unknown("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(Unknown):
+            database.drop()
+
+        api.drop_database.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_drop_not_found(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.drop_database.side_effect = NotFound("testing")
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        with self.assertRaises(NotFound):
+            database.drop()
+
+        api.drop_database.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_drop_success(self):
+        from google.protobuf.empty_pb2 import Empty
+
+        client = _Client()
+        api = client.database_admin_api = self._make_database_admin_api()
+        api.drop_database.return_value = Empty()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        database.drop()
+
+        api.drop_database.assert_called_once_with(
+            self.DATABASE_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def _execute_partitioned_dml_helper(self, dml, params=None, param_types=None):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1.proto.result_set_pb2 import (
+            PartialResultSet,
+            ResultSetStats,
+        )
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionSelector,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        transaction_pb = TransactionPB(id=self.TRANSACTION_ID)
+
+        stats_pb = ResultSetStats(row_count_lower_bound=2)
+        result_sets = [PartialResultSet(stats=stats_pb)]
+        iterator = _MockIterator(*result_sets)
+
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        session = _Session()
+        pool.put(session)
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+        api = database._spanner_api = self._make_spanner_api()
+        api.begin_transaction.return_value = transaction_pb
+        api.execute_streaming_sql.return_value = iterator
+
+        row_count = database.execute_partitioned_dml(dml, params, param_types)
+
+        self.assertEqual(row_count, 2)
+
+        txn_options = TransactionOptions(
+            partitioned_dml=TransactionOptions.PartitionedDml()
+        )
+
+        api.begin_transaction.assert_called_once_with(
+            session.name,
+            txn_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+        if params:
+            expected_params = Struct(
+                fields={key: _make_value_pb(value) for (key, value) in params.items()}
+            )
+        else:
+            expected_params = None
+
+        expected_transaction = TransactionSelector(id=self.TRANSACTION_ID)
+
+        api.execute_streaming_sql.assert_called_once_with(
+            self.SESSION_NAME,
+            dml,
+            transaction=expected_transaction,
+            params=expected_params,
+            param_types=param_types,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_execute_partitioned_dml_wo_params(self):
+        self._execute_partitioned_dml_helper(dml=DML_WO_PARAM)
+
+    def test_execute_partitioned_dml_w_params_wo_param_types(self):
+        with self.assertRaises(ValueError):
+            self._execute_partitioned_dml_helper(dml=DML_W_PARAM, params=PARAMS)
+
+    def test_execute_partitioned_dml_w_params_and_param_types(self):
+        self._execute_partitioned_dml_helper(
+            dml=DML_W_PARAM, params=PARAMS, param_types=PARAM_TYPES
+        )
+
+    def test_session_factory_defaults(self):
+        from google.cloud.spanner_v1.session import Session
+
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        session = database.session()
+
+        self.assertTrue(isinstance(session, Session))
+        self.assertIs(session.session_id, None)
+        self.assertIs(session._database, database)
+        self.assertEqual(session.labels, {})
+
+    def test_session_factory_w_labels(self):
+        from google.cloud.spanner_v1.session import Session
+
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        labels = {"foo": "bar"}
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        session = database.session(labels=labels)
+
+        self.assertTrue(isinstance(session, Session))
+        self.assertIs(session.session_id, None)
+        self.assertIs(session._database, database)
+        self.assertEqual(session.labels, labels)
+
+    def test_snapshot_defaults(self):
+        from google.cloud.spanner_v1.database import SnapshotCheckout
+
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        session = _Session()
+        pool.put(session)
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        checkout = database.snapshot()
+        self.assertIsInstance(checkout, SnapshotCheckout)
+        self.assertIs(checkout._database, database)
+        self.assertEqual(checkout._kw, {})
+
+    def test_snapshot_w_read_timestamp_and_multi_use(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud.spanner_v1.database import SnapshotCheckout
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        session = _Session()
+        pool.put(session)
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        checkout = database.snapshot(read_timestamp=now, multi_use=True)
+
+        self.assertIsInstance(checkout, SnapshotCheckout)
+        self.assertIs(checkout._database, database)
+        self.assertEqual(checkout._kw, {"read_timestamp": now, "multi_use": True})
+
+    def test_batch(self):
+        from google.cloud.spanner_v1.database import BatchCheckout
+
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        session = _Session()
+        pool.put(session)
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        checkout = database.batch()
+        self.assertIsInstance(checkout, BatchCheckout)
+        self.assertIs(checkout._database, database)
+
+    def test_batch_snapshot(self):
+        from google.cloud.spanner_v1.database import BatchSnapshot
+
+        database = self._make_one(self.DATABASE_ID, instance=object(), pool=_Pool())
+
+        batch_txn = database.batch_snapshot()
+        self.assertIsInstance(batch_txn, BatchSnapshot)
+        self.assertIs(batch_txn._database, database)
+        self.assertIsNone(batch_txn._read_timestamp)
+        self.assertIsNone(batch_txn._exact_staleness)
+
+    def test_batch_snapshot_w_read_timestamp(self):
+        from google.cloud.spanner_v1.database import BatchSnapshot
+
+        database = self._make_one(self.DATABASE_ID, instance=object(), pool=_Pool())
+        timestamp = self._make_timestamp()
+
+        batch_txn = database.batch_snapshot(read_timestamp=timestamp)
+        self.assertIsInstance(batch_txn, BatchSnapshot)
+        self.assertIs(batch_txn._database, database)
+        self.assertEqual(batch_txn._read_timestamp, timestamp)
+        self.assertIsNone(batch_txn._exact_staleness)
+
+    def test_batch_snapshot_w_exact_staleness(self):
+        from google.cloud.spanner_v1.database import BatchSnapshot
+
+        database = self._make_one(self.DATABASE_ID, instance=object(), pool=_Pool())
+        duration = self._make_duration()
+
+        batch_txn = database.batch_snapshot(exact_staleness=duration)
+        self.assertIsInstance(batch_txn, BatchSnapshot)
+        self.assertIs(batch_txn._database, database)
+        self.assertIsNone(batch_txn._read_timestamp)
+        self.assertEqual(batch_txn._exact_staleness, duration)
+
+    def test_run_in_transaction_wo_args(self):
+        import datetime
+
+        NOW = datetime.datetime.now()
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        session = _Session()
+        pool.put(session)
+        session._committed = NOW
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        _unit_of_work = object()
+
+        committed = database.run_in_transaction(_unit_of_work)
+
+        self.assertEqual(committed, NOW)
+        self.assertEqual(session._retried, (_unit_of_work, (), {}))
+
+    def test_run_in_transaction_w_args(self):
+        import datetime
+
+        SINCE = datetime.datetime(2017, 1, 1)
+        UNTIL = datetime.datetime(2018, 1, 1)
+        NOW = datetime.datetime.now()
+        client = _Client()
+        instance = _Instance(self.INSTANCE_NAME, client=client)
+        pool = _Pool()
+        session = _Session()
+        pool.put(session)
+        session._committed = NOW
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        _unit_of_work = object()
+
+        committed = database.run_in_transaction(_unit_of_work, SINCE, until=UNTIL)
+
+        self.assertEqual(committed, NOW)
+        self.assertEqual(session._retried, (_unit_of_work, (SINCE,), {"until": UNTIL}))
+
+    def test_run_in_transaction_nested(self):
+        from datetime import datetime
+
+        # Perform the various setup tasks.
+        instance = _Instance(self.INSTANCE_NAME, client=_Client())
+        pool = _Pool()
+        session = _Session(run_transaction_function=True)
+        session._committed = datetime.now()
+        pool.put(session)
+        database = self._make_one(self.DATABASE_ID, instance, pool=pool)
+
+        # Define the inner function.
+        inner = mock.Mock(spec=())
+
+        # Define the nested transaction.
+        def nested_unit_of_work():
+            return database.run_in_transaction(inner)
+
+        # Attempting to run this transaction should raise RuntimeError.
+        with self.assertRaises(RuntimeError):
+            database.run_in_transaction(nested_unit_of_work)
+        self.assertEqual(inner.call_count, 0)
+
+
+class TestBatchCheckout(_BaseTest):
+    def _get_target_class(self):
+        from google.cloud.spanner_v1.database import BatchCheckout
+
+        return BatchCheckout
+
+    @staticmethod
+    def _make_spanner_client():
+        from google.cloud.spanner_v1.gapic.spanner_client import SpannerClient
+
+        return mock.create_autospec(SpannerClient)
+
+    def test_ctor(self):
+        database = _Database(self.DATABASE_NAME)
+        checkout = self._make_one(database)
+        self.assertIs(checkout._database, database)
+
+    def test_context_mgr_success(self):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionOptions
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.spanner_v1.batch import Batch
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        database = _Database(self.DATABASE_NAME)
+        api = database.spanner_api = self._make_spanner_client()
+        api.commit.return_value = response
+        pool = database._pool = _Pool()
+        session = _Session(database)
+        pool.put(session)
+        checkout = self._make_one(database)
+
+        with checkout as batch:
+            self.assertIsNone(pool._session)
+            self.assertIsInstance(batch, Batch)
+            self.assertIs(batch._session, session)
+
+        self.assertIs(pool._session, session)
+        self.assertEqual(batch.committed, now)
+
+        expected_txn_options = TransactionOptions(read_write={})
+
+        api.commit.assert_called_once_with(
+            self.SESSION_NAME,
+            [],
+            single_use_transaction=expected_txn_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_context_mgr_failure(self):
+        from google.cloud.spanner_v1.batch import Batch
+
+        database = _Database(self.DATABASE_NAME)
+        pool = database._pool = _Pool()
+        session = _Session(database)
+        pool.put(session)
+        checkout = self._make_one(database)
+
+        class Testing(Exception):
+            pass
+
+        with self.assertRaises(Testing):
+            with checkout as batch:
+                self.assertIsNone(pool._session)
+                self.assertIsInstance(batch, Batch)
+                self.assertIs(batch._session, session)
+                raise Testing()
+
+        self.assertIs(pool._session, session)
+        self.assertIsNone(batch.committed)
+
+
+class TestSnapshotCheckout(_BaseTest):
+    def _get_target_class(self):
+        from google.cloud.spanner_v1.database import SnapshotCheckout
+
+        return SnapshotCheckout
+
+    def test_ctor_defaults(self):
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        database = _Database(self.DATABASE_NAME)
+        session = _Session(database)
+        pool = database._pool = _Pool()
+        pool.put(session)
+
+        checkout = self._make_one(database)
+        self.assertIs(checkout._database, database)
+        self.assertEqual(checkout._kw, {})
+
+        with checkout as snapshot:
+            self.assertIsNone(pool._session)
+            self.assertIsInstance(snapshot, Snapshot)
+            self.assertIs(snapshot._session, session)
+            self.assertTrue(snapshot._strong)
+            self.assertFalse(snapshot._multi_use)
+
+        self.assertIs(pool._session, session)
+
+    def test_ctor_w_read_timestamp_and_multi_use(self):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        database = _Database(self.DATABASE_NAME)
+        session = _Session(database)
+        pool = database._pool = _Pool()
+        pool.put(session)
+
+        checkout = self._make_one(database, read_timestamp=now, multi_use=True)
+        self.assertIs(checkout._database, database)
+        self.assertEqual(checkout._kw, {"read_timestamp": now, "multi_use": True})
+
+        with checkout as snapshot:
+            self.assertIsNone(pool._session)
+            self.assertIsInstance(snapshot, Snapshot)
+            self.assertIs(snapshot._session, session)
+            self.assertEqual(snapshot._read_timestamp, now)
+            self.assertTrue(snapshot._multi_use)
+
+        self.assertIs(pool._session, session)
+
+    def test_context_mgr_failure(self):
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        database = _Database(self.DATABASE_NAME)
+        pool = database._pool = _Pool()
+        session = _Session(database)
+        pool.put(session)
+        checkout = self._make_one(database)
+
+        class Testing(Exception):
+            pass
+
+        with self.assertRaises(Testing):
+            with checkout as snapshot:
+                self.assertIsNone(pool._session)
+                self.assertIsInstance(snapshot, Snapshot)
+                self.assertIs(snapshot._session, session)
+                raise Testing()
+
+        self.assertIs(pool._session, session)
+
+
+class TestBatchSnapshot(_BaseTest):
+    TABLE = "table_name"
+    COLUMNS = ["column_one", "column_two"]
+    TOKENS = [b"TOKEN1", b"TOKEN2"]
+    INDEX = "index"
+
+    def _get_target_class(self):
+        from google.cloud.spanner_v1.database import BatchSnapshot
+
+        return BatchSnapshot
+
+    @staticmethod
+    def _make_database(**kwargs):
+        from google.cloud.spanner_v1.database import Database
+
+        return mock.create_autospec(Database, instance=True, **kwargs)
+
+    @staticmethod
+    def _make_session(**kwargs):
+        from google.cloud.spanner_v1.session import Session
+
+        return mock.create_autospec(Session, instance=True, **kwargs)
+
+    @staticmethod
+    def _make_snapshot(transaction_id=None, **kwargs):
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        snapshot = mock.create_autospec(Snapshot, instance=True, **kwargs)
+        if transaction_id is not None:
+            snapshot._transaction_id = transaction_id
+
+        return snapshot
+
+    @staticmethod
+    def _make_keyset():
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        return KeySet(all_=True)
+
+    def test_ctor_no_staleness(self):
+        database = self._make_database()
+
+        batch_txn = self._make_one(database)
+
+        self.assertIs(batch_txn._database, database)
+        self.assertIsNone(batch_txn._session)
+        self.assertIsNone(batch_txn._snapshot)
+        self.assertIsNone(batch_txn._read_timestamp)
+        self.assertIsNone(batch_txn._exact_staleness)
+
+    def test_ctor_w_read_timestamp(self):
+        database = self._make_database()
+        timestamp = self._make_timestamp()
+
+        batch_txn = self._make_one(database, read_timestamp=timestamp)
+
+        self.assertIs(batch_txn._database, database)
+        self.assertIsNone(batch_txn._session)
+        self.assertIsNone(batch_txn._snapshot)
+        self.assertEqual(batch_txn._read_timestamp, timestamp)
+        self.assertIsNone(batch_txn._exact_staleness)
+
+    def test_ctor_w_exact_staleness(self):
+        database = self._make_database()
+        duration = self._make_duration()
+
+        batch_txn = self._make_one(database, exact_staleness=duration)
+
+        self.assertIs(batch_txn._database, database)
+        self.assertIsNone(batch_txn._session)
+        self.assertIsNone(batch_txn._snapshot)
+        self.assertIsNone(batch_txn._read_timestamp)
+        self.assertEqual(batch_txn._exact_staleness, duration)
+
+    def test_from_dict(self):
+        klass = self._get_target_class()
+        database = self._make_database()
+        session = database.session.return_value = self._make_session()
+        snapshot = session.snapshot.return_value = self._make_snapshot()
+        api_repr = {
+            "session_id": self.SESSION_ID,
+            "transaction_id": self.TRANSACTION_ID,
+        }
+
+        batch_txn = klass.from_dict(database, api_repr)
+        self.assertIs(batch_txn._database, database)
+        self.assertIs(batch_txn._session, session)
+        self.assertEqual(session._session_id, self.SESSION_ID)
+        self.assertEqual(snapshot._transaction_id, self.TRANSACTION_ID)
+        snapshot.begin.assert_not_called()
+        self.assertIs(batch_txn._snapshot, snapshot)
+
+    def test_to_dict(self):
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        batch_txn._session = self._make_session(_session_id=self.SESSION_ID)
+        batch_txn._snapshot = self._make_snapshot(transaction_id=self.TRANSACTION_ID)
+
+        expected = {
+            "session_id": self.SESSION_ID,
+            "transaction_id": self.TRANSACTION_ID,
+        }
+        self.assertEqual(batch_txn.to_dict(), expected)
+
+    def test__get_session_already(self):
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        already = batch_txn._session = object()
+        self.assertIs(batch_txn._get_session(), already)
+
+    def test__get_session_new(self):
+        database = self._make_database()
+        session = database.session.return_value = self._make_session()
+        batch_txn = self._make_one(database)
+        self.assertIs(batch_txn._get_session(), session)
+        session.create.assert_called_once_with()
+
+    def test__get_snapshot_already(self):
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        already = batch_txn._snapshot = self._make_snapshot()
+        self.assertIs(batch_txn._get_snapshot(), already)
+        already.begin.assert_not_called()
+
+    def test__get_snapshot_new_wo_staleness(self):
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        session = batch_txn._session = self._make_session()
+        snapshot = session.snapshot.return_value = self._make_snapshot()
+        self.assertIs(batch_txn._get_snapshot(), snapshot)
+        session.snapshot.assert_called_once_with(
+            read_timestamp=None, exact_staleness=None, multi_use=True
+        )
+        snapshot.begin.assert_called_once_with()
+
+    def test__get_snapshot_w_read_timestamp(self):
+        database = self._make_database()
+        timestamp = self._make_timestamp()
+        batch_txn = self._make_one(database, read_timestamp=timestamp)
+        session = batch_txn._session = self._make_session()
+        snapshot = session.snapshot.return_value = self._make_snapshot()
+        self.assertIs(batch_txn._get_snapshot(), snapshot)
+        session.snapshot.assert_called_once_with(
+            read_timestamp=timestamp, exact_staleness=None, multi_use=True
+        )
+        snapshot.begin.assert_called_once_with()
+
+    def test__get_snapshot_w_exact_staleness(self):
+        database = self._make_database()
+        duration = self._make_duration()
+        batch_txn = self._make_one(database, exact_staleness=duration)
+        session = batch_txn._session = self._make_session()
+        snapshot = session.snapshot.return_value = self._make_snapshot()
+        self.assertIs(batch_txn._get_snapshot(), snapshot)
+        session.snapshot.assert_called_once_with(
+            read_timestamp=None, exact_staleness=duration, multi_use=True
+        )
+        snapshot.begin.assert_called_once_with()
+
+    def test_read(self):
+        keyset = self._make_keyset()
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+
+        rows = batch_txn.read(self.TABLE, self.COLUMNS, keyset, self.INDEX)
+
+        self.assertIs(rows, snapshot.read.return_value)
+        snapshot.read.assert_called_once_with(
+            self.TABLE, self.COLUMNS, keyset, self.INDEX
+        )
+
+    def test_execute_sql(self):
+        sql = (
+            "SELECT first_name, last_name, email FROM citizens " "WHERE age <= @max_age"
+        )
+        params = {"max_age": 30}
+        param_types = {"max_age": "INT64"}
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+
+        rows = batch_txn.execute_sql(sql, params, param_types)
+
+        self.assertIs(rows, snapshot.execute_sql.return_value)
+        snapshot.execute_sql.assert_called_once_with(sql, params, param_types)
+
+    def test_generate_read_batches_w_max_partitions(self):
+        max_partitions = len(self.TOKENS)
+        keyset = self._make_keyset()
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        snapshot.partition_read.return_value = self.TOKENS
+
+        batches = list(
+            batch_txn.generate_read_batches(
+                self.TABLE, self.COLUMNS, keyset, max_partitions=max_partitions
+            )
+        )
+
+        expected_read = {
+            "table": self.TABLE,
+            "columns": self.COLUMNS,
+            "keyset": {"all": True},
+            "index": "",
+        }
+        self.assertEqual(len(batches), len(self.TOKENS))
+        for batch, token in zip(batches, self.TOKENS):
+            self.assertEqual(batch["partition"], token)
+            self.assertEqual(batch["read"], expected_read)
+
+        snapshot.partition_read.assert_called_once_with(
+            table=self.TABLE,
+            columns=self.COLUMNS,
+            keyset=keyset,
+            index="",
+            partition_size_bytes=None,
+            max_partitions=max_partitions,
+        )
+
+    def test_generate_read_batches_w_index_w_partition_size_bytes(self):
+        size = 1 << 20
+        keyset = self._make_keyset()
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        snapshot.partition_read.return_value = self.TOKENS
+
+        batches = list(
+            batch_txn.generate_read_batches(
+                self.TABLE,
+                self.COLUMNS,
+                keyset,
+                index=self.INDEX,
+                partition_size_bytes=size,
+            )
+        )
+
+        expected_read = {
+            "table": self.TABLE,
+            "columns": self.COLUMNS,
+            "keyset": {"all": True},
+            "index": self.INDEX,
+        }
+        self.assertEqual(len(batches), len(self.TOKENS))
+        for batch, token in zip(batches, self.TOKENS):
+            self.assertEqual(batch["partition"], token)
+            self.assertEqual(batch["read"], expected_read)
+
+        snapshot.partition_read.assert_called_once_with(
+            table=self.TABLE,
+            columns=self.COLUMNS,
+            keyset=keyset,
+            index=self.INDEX,
+            partition_size_bytes=size,
+            max_partitions=None,
+        )
+
+    def test_process_read_batch(self):
+        keyset = self._make_keyset()
+        token = b"TOKEN"
+        batch = {
+            "partition": token,
+            "read": {
+                "table": self.TABLE,
+                "columns": self.COLUMNS,
+                "keyset": {"all": True},
+                "index": self.INDEX,
+            },
+        }
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        expected = snapshot.read.return_value = object()
+
+        found = batch_txn.process_read_batch(batch)
+
+        self.assertIs(found, expected)
+
+        snapshot.read.assert_called_once_with(
+            table=self.TABLE,
+            columns=self.COLUMNS,
+            keyset=keyset,
+            index=self.INDEX,
+            partition=token,
+        )
+
+    def test_generate_query_batches_w_max_partitions(self):
+        sql = "SELECT COUNT(*) FROM table_name"
+        max_partitions = len(self.TOKENS)
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        snapshot.partition_query.return_value = self.TOKENS
+
+        batches = list(
+            batch_txn.generate_query_batches(sql, max_partitions=max_partitions)
+        )
+
+        expected_query = {"sql": sql}
+        self.assertEqual(len(batches), len(self.TOKENS))
+        for batch, token in zip(batches, self.TOKENS):
+            self.assertEqual(batch["partition"], token)
+            self.assertEqual(batch["query"], expected_query)
+
+        snapshot.partition_query.assert_called_once_with(
+            sql=sql,
+            params=None,
+            param_types=None,
+            partition_size_bytes=None,
+            max_partitions=max_partitions,
+        )
+
+    def test_generate_query_batches_w_params_w_partition_size_bytes(self):
+        sql = (
+            "SELECT first_name, last_name, email FROM citizens " "WHERE age <= @max_age"
+        )
+        params = {"max_age": 30}
+        param_types = {"max_age": "INT64"}
+        size = 1 << 20
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        snapshot.partition_query.return_value = self.TOKENS
+
+        batches = list(
+            batch_txn.generate_query_batches(
+                sql, params=params, param_types=param_types, partition_size_bytes=size
+            )
+        )
+
+        expected_query = {"sql": sql, "params": params, "param_types": param_types}
+        self.assertEqual(len(batches), len(self.TOKENS))
+        for batch, token in zip(batches, self.TOKENS):
+            self.assertEqual(batch["partition"], token)
+            self.assertEqual(batch["query"], expected_query)
+
+        snapshot.partition_query.assert_called_once_with(
+            sql=sql,
+            params=params,
+            param_types=param_types,
+            partition_size_bytes=size,
+            max_partitions=None,
+        )
+
+    def test_process_query_batch(self):
+        sql = (
+            "SELECT first_name, last_name, email FROM citizens " "WHERE age <= @max_age"
+        )
+        params = {"max_age": 30}
+        param_types = {"max_age": "INT64"}
+        token = b"TOKEN"
+        batch = {
+            "partition": token,
+            "query": {"sql": sql, "params": params, "param_types": param_types},
+        }
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        expected = snapshot.execute_sql.return_value = object()
+
+        found = batch_txn.process_query_batch(batch)
+
+        self.assertIs(found, expected)
+
+        snapshot.execute_sql.assert_called_once_with(
+            sql=sql, params=params, param_types=param_types, partition=token
+        )
+
+    def test_close_wo_session(self):
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+
+        batch_txn.close()  # no raise
+
+    def test_close_w_session(self):
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        session = batch_txn._session = self._make_session()
+
+        batch_txn.close()
+
+        session.delete.assert_called_once_with()
+
+    def test_process_w_invalid_batch(self):
+        token = b"TOKEN"
+        batch = {"partition": token, "bogus": b"BOGUS"}
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            batch_txn.process(batch)
+
+    def test_process_w_read_batch(self):
+        keyset = self._make_keyset()
+        token = b"TOKEN"
+        batch = {
+            "partition": token,
+            "read": {
+                "table": self.TABLE,
+                "columns": self.COLUMNS,
+                "keyset": {"all": True},
+                "index": self.INDEX,
+            },
+        }
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        expected = snapshot.read.return_value = object()
+
+        found = batch_txn.process(batch)
+
+        self.assertIs(found, expected)
+
+        snapshot.read.assert_called_once_with(
+            table=self.TABLE,
+            columns=self.COLUMNS,
+            keyset=keyset,
+            index=self.INDEX,
+            partition=token,
+        )
+
+    def test_process_w_query_batch(self):
+        sql = (
+            "SELECT first_name, last_name, email FROM citizens " "WHERE age <= @max_age"
+        )
+        params = {"max_age": 30}
+        param_types = {"max_age": "INT64"}
+        token = b"TOKEN"
+        batch = {
+            "partition": token,
+            "query": {"sql": sql, "params": params, "param_types": param_types},
+        }
+        database = self._make_database()
+        batch_txn = self._make_one(database)
+        snapshot = batch_txn._snapshot = self._make_snapshot()
+        expected = snapshot.execute_sql.return_value = object()
+
+        found = batch_txn.process(batch)
+
+        self.assertIs(found, expected)
+
+        snapshot.execute_sql.assert_called_once_with(
+            sql=sql, params=params, param_types=param_types, partition=token
+        )
+
+
+class _Client(object):
+    def __init__(self, project=TestDatabase.PROJECT_ID):
+        self.project = project
+        self.project_name = "projects/" + self.project
+
+
+class _Instance(object):
+    def __init__(self, name, client=None):
+        self.name = name
+        self.instance_id = name.rsplit("/", 1)[1]
+        self._client = client
+
+
+class _Database(object):
+    def __init__(self, name, instance=None):
+        self.name = name
+        self.database_id = name.rsplit("/", 1)[1]
+        self._instance = instance
+
+
+class _Pool(object):
+    _bound = None
+
+    def bind(self, database):
+        self._bound = database
+
+    def get(self):
+        session, self._session = self._session, None
+        return session
+
+    def put(self, session):
+        self._session = session
+
+
+class _Session(object):
+
+    _rows = ()
+    _created = False
+    _transaction = None
+    _snapshot = None
+
+    def __init__(
+        self, database=None, name=_BaseTest.SESSION_NAME, run_transaction_function=False
+    ):
+        self._database = database
+        self.name = name
+        self._run_transaction_function = run_transaction_function
+
+    def run_in_transaction(self, func, *args, **kw):
+        if self._run_transaction_function:
+            func(*args, **kw)
+        self._retried = (func, args, kw)
+        return self._committed
+
+
+class _MockIterator(object):
+    def __init__(self, *values, **kw):
+        self._iter_values = iter(values)
+        self._fail_after = kw.pop("fail_after", False)
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        try:
+            return next(self._iter_values)
+        except StopIteration:
+            raise
+
+    next = __next__
diff --git a/spanner/tests/unit/test_instance.py b/spanner/tests/unit/test_instance.py
new file mode 100644
index 000000000000..0e7bc99df479
--- /dev/null
+++ b/spanner/tests/unit/test_instance.py
@@ -0,0 +1,660 @@
+# Copyright 2016 Google LLC 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.
+
+import unittest
+
+import mock
+
+
+class TestInstance(unittest.TestCase):
+
+    PROJECT = "project"
+    PARENT = "projects/" + PROJECT
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = PARENT + "/instances/" + INSTANCE_ID
+    CONFIG_NAME = "configuration-name"
+    LOCATION = "projects/" + PROJECT + "/locations/" + CONFIG_NAME
+    DISPLAY_NAME = "display_name"
+    NODE_COUNT = 5
+    OP_ID = 8915
+    OP_NAME = "operations/projects/%s/instances/%soperations/%d" % (
+        PROJECT,
+        INSTANCE_ID,
+        OP_ID,
+    )
+    TABLE_ID = "table_id"
+    TABLE_NAME = INSTANCE_NAME + "/tables/" + TABLE_ID
+    TIMEOUT_SECONDS = 1
+    DATABASE_ID = "database_id"
+    DATABASE_NAME = "%s/databases/%s" % (INSTANCE_NAME, DATABASE_ID)
+
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.instance import Instance
+
+        return Instance
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_constructor_defaults(self):
+        from google.cloud.spanner_v1.instance import DEFAULT_NODE_COUNT
+
+        client = object()
+        instance = self._make_one(self.INSTANCE_ID, client)
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertIs(instance._client, client)
+        self.assertIs(instance.configuration_name, None)
+        self.assertEqual(instance.node_count, DEFAULT_NODE_COUNT)
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+
+    def test_constructor_non_default(self):
+        DISPLAY_NAME = "display_name"
+        client = object()
+
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            configuration_name=self.CONFIG_NAME,
+            node_count=self.NODE_COUNT,
+            display_name=DISPLAY_NAME,
+        )
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertIs(instance._client, client)
+        self.assertEqual(instance.configuration_name, self.CONFIG_NAME)
+        self.assertEqual(instance.node_count, self.NODE_COUNT)
+        self.assertEqual(instance.display_name, DISPLAY_NAME)
+
+    def test_copy(self):
+        DISPLAY_NAME = "display_name"
+
+        client = _Client(self.PROJECT)
+        instance = self._make_one(
+            self.INSTANCE_ID, client, self.CONFIG_NAME, display_name=DISPLAY_NAME
+        )
+        new_instance = instance.copy()
+
+        # Make sure the client copy succeeded.
+        self.assertIsNot(new_instance._client, client)
+        self.assertEqual(new_instance._client, client)
+        # Make sure the client got copied to a new instance.
+        self.assertIsNot(instance, new_instance)
+        self.assertEqual(instance, new_instance)
+
+    def test__update_from_pb_success(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        display_name = "display_name"
+        instance_pb = admin_v1_pb2.Instance(display_name=display_name)
+
+        instance = self._make_one(None, None, None, None)
+        self.assertEqual(instance.display_name, None)
+        instance._update_from_pb(instance_pb)
+        self.assertEqual(instance.display_name, display_name)
+
+    def test__update_from_pb_no_display_name(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        instance_pb = admin_v1_pb2.Instance()
+        instance = self._make_one(None, None, None, None)
+        self.assertEqual(instance.display_name, None)
+        with self.assertRaises(ValueError):
+            instance._update_from_pb(instance_pb)
+        self.assertEqual(instance.display_name, None)
+
+    def test_from_pb_bad_instance_name(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        instance_name = "INCORRECT_FORMAT"
+        instance_pb = admin_v1_pb2.Instance(name=instance_name)
+
+        klass = self._getTargetClass()
+        with self.assertRaises(ValueError):
+            klass.from_pb(instance_pb, None)
+
+    def test_from_pb_project_mistmatch(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        ALT_PROJECT = "ALT_PROJECT"
+        client = _Client(project=ALT_PROJECT)
+
+        self.assertNotEqual(self.PROJECT, ALT_PROJECT)
+
+        instance_pb = admin_v1_pb2.Instance(name=self.INSTANCE_NAME)
+
+        klass = self._getTargetClass()
+        with self.assertRaises(ValueError):
+            klass.from_pb(instance_pb, client)
+
+    def test_from_pb_success(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        client = _Client(project=self.PROJECT)
+
+        instance_pb = admin_v1_pb2.Instance(
+            name=self.INSTANCE_NAME,
+            config=self.CONFIG_NAME,
+            display_name=self.INSTANCE_ID,
+        )
+
+        klass = self._getTargetClass()
+        instance = klass.from_pb(instance_pb, client)
+        self.assertTrue(isinstance(instance, klass))
+        self.assertEqual(instance._client, client)
+        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.configuration_name, self.CONFIG_NAME)
+
+    def test_name_property(self):
+        client = _Client(project=self.PROJECT)
+
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+
+    def test___eq__(self):
+        client = object()
+        instance1 = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        instance2 = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        self.assertEqual(instance1, instance2)
+
+    def test___eq__type_differ(self):
+        client = object()
+        instance1 = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        instance2 = object()
+        self.assertNotEqual(instance1, instance2)
+
+    def test___ne__same_value(self):
+        client = object()
+        instance1 = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        instance2 = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        comparison_val = instance1 != instance2
+        self.assertFalse(comparison_val)
+
+    def test___ne__(self):
+        instance1 = self._make_one("instance_id1", "client1", self.CONFIG_NAME)
+        instance2 = self._make_one("instance_id2", "client2", self.CONFIG_NAME)
+        self.assertNotEqual(instance1, instance2)
+
+    def test_create_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client(self.PROJECT)
+        client.instance_admin_api = _FauxInstanceAdminAPI(_rpc_error=True)
+        instance = self._make_one(
+            self.INSTANCE_ID, client, configuration_name=self.CONFIG_NAME
+        )
+
+        with self.assertRaises(Unknown):
+            instance.create()
+
+    def test_create_already_exists(self):
+        from google.cloud.exceptions import Conflict
+
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _create_instance_conflict=True
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID, client, configuration_name=self.CONFIG_NAME
+        )
+
+        with self.assertRaises(Conflict):
+            instance.create()
+
+        (parent, instance_id, instance, metadata) = api._created_instance
+        self.assertEqual(parent, self.PARENT)
+        self.assertEqual(instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+        self.assertEqual(instance.config, self.CONFIG_NAME)
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+        self.assertEqual(instance.node_count, 1)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_create_success(self):
+        op_future = _FauxOperationFuture()
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _create_instance_response=op_future
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            configuration_name=self.CONFIG_NAME,
+            display_name=self.DISPLAY_NAME,
+            node_count=self.NODE_COUNT,
+        )
+
+        future = instance.create()
+
+        self.assertIs(future, op_future)
+
+        (parent, instance_id, instance, metadata) = api._created_instance
+        self.assertEqual(parent, self.PARENT)
+        self.assertEqual(instance_id, self.INSTANCE_ID)
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+        self.assertEqual(instance.config, self.CONFIG_NAME)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.node_count, self.NODE_COUNT)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_exists_instance_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client(self.PROJECT)
+        client.instance_admin_api = _FauxInstanceAdminAPI(_rpc_error=True)
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+
+        with self.assertRaises(Unknown):
+            instance.exists()
+
+    def test_exists_instance_not_found(self):
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _instance_not_found=True
+        )
+        api._instance_not_found = True
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+
+        self.assertFalse(instance.exists())
+
+        name, metadata = api._got_instance
+        self.assertEqual(name, self.INSTANCE_NAME)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_exists_success(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        client = _Client(self.PROJECT)
+        instance_pb = admin_v1_pb2.Instance(
+            name=self.INSTANCE_NAME,
+            config=self.CONFIG_NAME,
+            display_name=self.DISPLAY_NAME,
+            node_count=self.NODE_COUNT,
+        )
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _get_instance_response=instance_pb
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        self.assertTrue(instance.exists())
+
+        name, metadata = api._got_instance
+        self.assertEqual(name, self.INSTANCE_NAME)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_reload_instance_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client(self.PROJECT)
+        client.instance_admin_api = _FauxInstanceAdminAPI(_rpc_error=True)
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+
+        with self.assertRaises(Unknown):
+            instance.reload()
+
+    def test_reload_instance_not_found(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _instance_not_found=True
+        )
+        api._instance_not_found = True
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+
+        with self.assertRaises(NotFound):
+            instance.reload()
+
+        name, metadata = api._got_instance
+        self.assertEqual(name, self.INSTANCE_NAME)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_reload_success(self):
+        from google.cloud.spanner_admin_instance_v1.proto import (
+            spanner_instance_admin_pb2 as admin_v1_pb2,
+        )
+
+        client = _Client(self.PROJECT)
+        instance_pb = admin_v1_pb2.Instance(
+            name=self.INSTANCE_NAME,
+            config=self.CONFIG_NAME,
+            display_name=self.DISPLAY_NAME,
+            node_count=self.NODE_COUNT,
+        )
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _get_instance_response=instance_pb
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        instance.reload()
+
+        self.assertEqual(instance.configuration_name, self.CONFIG_NAME)
+        self.assertEqual(instance.node_count, self.NODE_COUNT)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+
+        name, metadata = api._got_instance
+        self.assertEqual(name, self.INSTANCE_NAME)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_update_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client(self.PROJECT)
+        client.instance_admin_api = _FauxInstanceAdminAPI(_rpc_error=True)
+        instance = self._make_one(
+            self.INSTANCE_ID, client, configuration_name=self.CONFIG_NAME
+        )
+
+        with self.assertRaises(Unknown):
+            instance.update()
+
+    def test_update_not_found(self):
+        from google.cloud.exceptions import NotFound
+        from google.cloud.spanner_v1.instance import DEFAULT_NODE_COUNT
+
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _instance_not_found=True
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID, client, configuration_name=self.CONFIG_NAME
+        )
+
+        with self.assertRaises(NotFound):
+            instance.update()
+
+        instance, field_mask, metadata = api._updated_instance
+        self.assertEqual(field_mask.paths, ["config", "display_name", "node_count"])
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+        self.assertEqual(instance.config, self.CONFIG_NAME)
+        self.assertEqual(instance.display_name, self.INSTANCE_ID)
+        self.assertEqual(instance.node_count, DEFAULT_NODE_COUNT)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_update_success(self):
+        op_future = _FauxOperationFuture()
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _update_instance_response=op_future
+        )
+        instance = self._make_one(
+            self.INSTANCE_ID,
+            client,
+            configuration_name=self.CONFIG_NAME,
+            node_count=self.NODE_COUNT,
+            display_name=self.DISPLAY_NAME,
+        )
+
+        future = instance.update()
+
+        self.assertIs(future, op_future)
+
+        instance, field_mask, metadata = api._updated_instance
+        self.assertEqual(field_mask.paths, ["config", "display_name", "node_count"])
+        self.assertEqual(instance.name, self.INSTANCE_NAME)
+        self.assertEqual(instance.config, self.CONFIG_NAME)
+        self.assertEqual(instance.display_name, self.DISPLAY_NAME)
+        self.assertEqual(instance.node_count, self.NODE_COUNT)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_delete_grpc_error(self):
+        from google.api_core.exceptions import Unknown
+
+        client = _Client(self.PROJECT)
+        client.instance_admin_api = _FauxInstanceAdminAPI(_rpc_error=True)
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        with self.assertRaises(Unknown):
+            instance.delete()
+
+    def test_delete_not_found(self):
+        from google.cloud.exceptions import NotFound
+
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _instance_not_found=True
+        )
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        with self.assertRaises(NotFound):
+            instance.delete()
+
+        name, metadata = api._deleted_instance
+        self.assertEqual(name, self.INSTANCE_NAME)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_delete_success(self):
+        from google.protobuf.empty_pb2 import Empty
+
+        client = _Client(self.PROJECT)
+        api = client.instance_admin_api = _FauxInstanceAdminAPI(
+            _delete_instance_response=Empty()
+        )
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+
+        instance.delete()
+
+        name, metadata = api._deleted_instance
+        self.assertEqual(name, self.INSTANCE_NAME)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", instance.name)])
+
+    def test_database_factory_defaults(self):
+        from google.cloud.spanner_v1.database import Database
+        from google.cloud.spanner_v1.pool import BurstyPool
+
+        client = _Client(self.PROJECT)
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        DATABASE_ID = "database-id"
+
+        database = instance.database(DATABASE_ID)
+
+        self.assertTrue(isinstance(database, Database))
+        self.assertEqual(database.database_id, DATABASE_ID)
+        self.assertIs(database._instance, instance)
+        self.assertEqual(list(database.ddl_statements), [])
+        self.assertIsInstance(database._pool, BurstyPool)
+        pool = database._pool
+        self.assertIs(pool._database, database)
+
+    def test_database_factory_explicit(self):
+        from google.cloud.spanner_v1.database import Database
+        from tests._fixtures import DDL_STATEMENTS
+
+        client = _Client(self.PROJECT)
+        instance = self._make_one(self.INSTANCE_ID, client, self.CONFIG_NAME)
+        DATABASE_ID = "database-id"
+        pool = _Pool()
+
+        database = instance.database(
+            DATABASE_ID, ddl_statements=DDL_STATEMENTS, pool=pool
+        )
+
+        self.assertTrue(isinstance(database, Database))
+        self.assertEqual(database.database_id, DATABASE_ID)
+        self.assertIs(database._instance, instance)
+        self.assertEqual(list(database.ddl_statements), DDL_STATEMENTS)
+        self.assertIs(database._pool, pool)
+        self.assertIs(pool._bound, database)
+
+    def test_list_databases(self):
+        from google.cloud.spanner_admin_database_v1.gapic import database_admin_client
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2,
+        )
+        from google.cloud.spanner_v1.database import Database
+
+        api = database_admin_client.DatabaseAdminClient(mock.Mock())
+        client = _Client(self.PROJECT)
+        client.database_admin_api = api
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        databases_pb = spanner_database_admin_pb2.ListDatabasesResponse(
+            databases=[
+                spanner_database_admin_pb2.Database(
+                    name="{}/databases/aa".format(self.INSTANCE_NAME)
+                ),
+                spanner_database_admin_pb2.Database(
+                    name="{}/databases/bb".format(self.INSTANCE_NAME)
+                ),
+            ]
+        )
+
+        ld_api = api._inner_api_calls["list_databases"] = mock.Mock(
+            return_value=databases_pb
+        )
+
+        response = instance.list_databases()
+        databases = list(response)
+
+        self.assertIsInstance(databases[0], Database)
+        self.assertTrue(databases[0].name.endswith("/aa"))
+        self.assertTrue(databases[1].name.endswith("/bb"))
+
+        expected_metadata = [
+            ("google-cloud-resource-prefix", instance.name),
+            ("x-goog-request-params", "parent={}".format(instance.name)),
+        ]
+        ld_api.assert_called_once_with(
+            spanner_database_admin_pb2.ListDatabasesRequest(parent=self.INSTANCE_NAME),
+            metadata=expected_metadata,
+            retry=mock.ANY,
+            timeout=mock.ANY,
+        )
+
+    def test_list_databases_w_options(self):
+        from google.cloud.spanner_admin_database_v1.gapic import database_admin_client
+        from google.cloud.spanner_admin_database_v1.proto import (
+            spanner_database_admin_pb2,
+        )
+
+        api = database_admin_client.DatabaseAdminClient(mock.Mock())
+        client = _Client(self.PROJECT)
+        client.database_admin_api = api
+        instance = self._make_one(self.INSTANCE_ID, client)
+
+        databases_pb = spanner_database_admin_pb2.ListDatabasesResponse(databases=[])
+
+        ld_api = api._inner_api_calls["list_databases"] = mock.Mock(
+            return_value=databases_pb
+        )
+
+        page_size = 42
+        page_token = "token"
+        response = instance.list_databases(page_size=page_size, page_token=page_token)
+        databases = list(response)
+
+        self.assertEqual(databases, [])
+
+        expected_metadata = [
+            ("google-cloud-resource-prefix", instance.name),
+            ("x-goog-request-params", "parent={}".format(instance.name)),
+        ]
+        ld_api.assert_called_once_with(
+            spanner_database_admin_pb2.ListDatabasesRequest(
+                parent=self.INSTANCE_NAME, page_size=page_size, page_token=page_token
+            ),
+            metadata=expected_metadata,
+            retry=mock.ANY,
+            timeout=mock.ANY,
+        )
+
+
+class _Client(object):
+    def __init__(self, project, timeout_seconds=None):
+        self.project = project
+        self.project_name = "projects/" + self.project
+        self.timeout_seconds = timeout_seconds
+
+    def copy(self):
+        from copy import deepcopy
+
+        return deepcopy(self)
+
+    def __eq__(self, other):
+        return (
+            other.project == self.project
+            and other.project_name == self.project_name
+            and other.timeout_seconds == self.timeout_seconds
+        )
+
+
+class _FauxInstanceAdminAPI(object):
+
+    _create_instance_conflict = False
+    _instance_not_found = False
+    _rpc_error = False
+
+    def __init__(self, **kwargs):
+        self.__dict__.update(**kwargs)
+
+    def create_instance(self, parent, instance_id, instance, metadata=None):
+        from google.api_core.exceptions import AlreadyExists, Unknown
+
+        self._created_instance = (parent, instance_id, instance, metadata)
+        if self._rpc_error:
+            raise Unknown("error")
+        if self._create_instance_conflict:
+            raise AlreadyExists("conflict")
+        return self._create_instance_response
+
+    def get_instance(self, name, metadata=None):
+        from google.api_core.exceptions import NotFound, Unknown
+
+        self._got_instance = (name, metadata)
+        if self._rpc_error:
+            raise Unknown("error")
+        if self._instance_not_found:
+            raise NotFound("error")
+        return self._get_instance_response
+
+    def update_instance(self, instance, field_mask, metadata=None):
+        from google.api_core.exceptions import NotFound, Unknown
+
+        self._updated_instance = (instance, field_mask, metadata)
+        if self._rpc_error:
+            raise Unknown("error")
+        if self._instance_not_found:
+            raise NotFound("error")
+        return self._update_instance_response
+
+    def delete_instance(self, name, metadata=None):
+        from google.api_core.exceptions import NotFound, Unknown
+
+        self._deleted_instance = name, metadata
+        if self._rpc_error:
+            raise Unknown("error")
+        if self._instance_not_found:
+            raise NotFound("error")
+        return self._delete_instance_response
+
+
+class _FauxOperationFuture(object):
+    pass
+
+
+class _Pool(object):
+    _bound = None
+
+    def bind(self, database):
+        self._bound = database
diff --git a/spanner/tests/unit/test_keyset.py b/spanner/tests/unit/test_keyset.py
new file mode 100644
index 000000000000..ed1473bf01e3
--- /dev/null
+++ b/spanner/tests/unit/test_keyset.py
@@ -0,0 +1,421 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+
+
+class TestKeyRange(unittest.TestCase):
+    def _get_target_class(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        return KeyRange
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_ctor_no_start_no_end(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+
+    def test_ctor_w_start_open_and_start_closed(self):
+        KEY_1 = [u"key_1"]
+        KEY_2 = [u"key_2"]
+        with self.assertRaises(ValueError):
+            self._make_one(start_open=KEY_1, start_closed=KEY_2)
+
+    def test_ctor_w_end_open_and_end_closed(self):
+        KEY_1 = [u"key_1"]
+        KEY_2 = [u"key_2"]
+        with self.assertRaises(ValueError):
+            self._make_one(end_open=KEY_1, end_closed=KEY_2)
+
+    def test_ctor_w_only_start_open(self):
+        KEY_1 = [u"key_1"]
+        krange = self._make_one(start_open=KEY_1)
+        self.assertEqual(krange.start_open, KEY_1)
+        self.assertEqual(krange.start_closed, None)
+        self.assertEqual(krange.end_open, None)
+        self.assertEqual(krange.end_closed, [])
+
+    def test_ctor_w_only_start_closed(self):
+        KEY_1 = [u"key_1"]
+        krange = self._make_one(start_closed=KEY_1)
+        self.assertEqual(krange.start_open, None)
+        self.assertEqual(krange.start_closed, KEY_1)
+        self.assertEqual(krange.end_open, None)
+        self.assertEqual(krange.end_closed, [])
+
+    def test_ctor_w_only_end_open(self):
+        KEY_1 = [u"key_1"]
+        krange = self._make_one(end_open=KEY_1)
+        self.assertEqual(krange.start_open, None)
+        self.assertEqual(krange.start_closed, [])
+        self.assertEqual(krange.end_open, KEY_1)
+        self.assertEqual(krange.end_closed, None)
+
+    def test_ctor_w_only_end_closed(self):
+        KEY_1 = [u"key_1"]
+        krange = self._make_one(end_closed=KEY_1)
+        self.assertEqual(krange.start_open, None)
+        self.assertEqual(krange.start_closed, [])
+        self.assertEqual(krange.end_open, None)
+        self.assertEqual(krange.end_closed, KEY_1)
+
+    def test_ctor_w_start_open_and_end_closed(self):
+        KEY_1 = [u"key_1"]
+        KEY_2 = [u"key_2"]
+        krange = self._make_one(start_open=KEY_1, end_closed=KEY_2)
+        self.assertEqual(krange.start_open, KEY_1)
+        self.assertEqual(krange.start_closed, None)
+        self.assertEqual(krange.end_open, None)
+        self.assertEqual(krange.end_closed, KEY_2)
+
+    def test_ctor_w_start_closed_and_end_open(self):
+        KEY_1 = [u"key_1"]
+        KEY_2 = [u"key_2"]
+        krange = self._make_one(start_closed=KEY_1, end_open=KEY_2)
+        self.assertEqual(krange.start_open, None)
+        self.assertEqual(krange.start_closed, KEY_1)
+        self.assertEqual(krange.end_open, KEY_2)
+        self.assertEqual(krange.end_closed, None)
+
+    def test___eq___self(self):
+        key_1 = [u"key_1"]
+        krange = self._make_one(end_open=key_1)
+        self.assertEqual(krange, krange)
+
+    def test___eq___other_type(self):
+        key_1 = [u"key_1"]
+        krange = self._make_one(end_open=key_1)
+        self.assertNotEqual(krange, object())
+
+    def test___eq___other_hit(self):
+        key_1 = [u"key_1"]
+        krange = self._make_one(end_open=key_1)
+        other = self._make_one(end_open=key_1)
+        self.assertEqual(krange, other)
+
+    def test___eq___other(self):
+        key_1 = [u"key_1"]
+        key_2 = [u"key_2"]
+        krange = self._make_one(end_open=key_1)
+        other = self._make_one(start_closed=key_2, end_open=key_1)
+        self.assertNotEqual(krange, other)
+
+    def test_to_pb_w_start_closed_and_end_open(self):
+        from google.protobuf.struct_pb2 import ListValue
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.keys_pb2 import KeyRange
+
+        key1 = u"key_1"
+        key2 = u"key_2"
+        key_range = self._make_one(start_closed=[key1], end_open=[key2])
+        key_range_pb = key_range._to_pb()
+        expected = KeyRange(
+            start_closed=ListValue(values=[Value(string_value=key1)]),
+            end_open=ListValue(values=[Value(string_value=key2)]),
+        )
+        self.assertEqual(key_range_pb, expected)
+
+    def test_to_pb_w_start_open_and_end_closed(self):
+        from google.protobuf.struct_pb2 import ListValue
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.keys_pb2 import KeyRange
+
+        key1 = u"key_1"
+        key2 = u"key_2"
+        key_range = self._make_one(start_open=[key1], end_closed=[key2])
+        key_range_pb = key_range._to_pb()
+        expected = KeyRange(
+            start_open=ListValue(values=[Value(string_value=key1)]),
+            end_closed=ListValue(values=[Value(string_value=key2)]),
+        )
+        self.assertEqual(key_range_pb, expected)
+
+    def test_to_pb_w_empty_list(self):
+        from google.protobuf.struct_pb2 import ListValue
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1.proto.keys_pb2 import KeyRange
+
+        key = u"key"
+        key_range = self._make_one(start_closed=[], end_closed=[key])
+        key_range_pb = key_range._to_pb()
+        expected = KeyRange(
+            start_closed=ListValue(values=[]),
+            end_closed=ListValue(values=[Value(string_value=key)]),
+        )
+        self.assertEqual(key_range_pb, expected)
+
+    def test_to_dict_w_start_closed_and_end_open(self):
+        key1 = u"key_1"
+        key2 = u"key_2"
+        key_range = self._make_one(start_closed=[key1], end_open=[key2])
+        expected = {"start_closed": [key1], "end_open": [key2]}
+        self.assertEqual(key_range._to_dict(), expected)
+
+    def test_to_dict_w_start_open_and_end_closed(self):
+        key1 = u"key_1"
+        key2 = u"key_2"
+        key_range = self._make_one(start_open=[key1], end_closed=[key2])
+        expected = {"start_open": [key1], "end_closed": [key2]}
+        self.assertEqual(key_range._to_dict(), expected)
+
+    def test_to_dict_w_end_closed(self):
+        key = u"key"
+        key_range = self._make_one(end_closed=[key])
+        expected = {"end_closed": [key]}
+        self.assertEqual(key_range._to_dict(), expected)
+
+
+class TestKeySet(unittest.TestCase):
+    def _get_target_class(self):
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        return KeySet
+
+    def _make_one(self, *args, **kwargs):
+        return self._get_target_class()(*args, **kwargs)
+
+    def test_ctor_w_all(self):
+        keyset = self._make_one(all_=True)
+
+        self.assertTrue(keyset.all_)
+        self.assertEqual(keyset.keys, [])
+        self.assertEqual(keyset.ranges, [])
+
+    def test_ctor_w_keys(self):
+        KEYS = [[u"key1"], [u"key2"]]
+
+        keyset = self._make_one(keys=KEYS)
+
+        self.assertFalse(keyset.all_)
+        self.assertEqual(keyset.keys, KEYS)
+        self.assertEqual(keyset.ranges, [])
+
+    def test_ctor_w_ranges(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        range_1 = KeyRange(start_closed=[u"key1"], end_open=[u"key3"])
+        range_2 = KeyRange(start_open=[u"key5"], end_closed=[u"key6"])
+
+        keyset = self._make_one(ranges=[range_1, range_2])
+
+        self.assertFalse(keyset.all_)
+        self.assertEqual(keyset.keys, [])
+        self.assertEqual(keyset.ranges, [range_1, range_2])
+
+    def test_ctor_w_all_and_keys(self):
+
+        with self.assertRaises(ValueError):
+            self._make_one(all_=True, keys=[["key1"], ["key2"]])
+
+    def test_ctor_w_all_and_ranges(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        range_1 = KeyRange(start_closed=[u"key1"], end_open=[u"key3"])
+        range_2 = KeyRange(start_open=[u"key5"], end_closed=[u"key6"])
+
+        with self.assertRaises(ValueError):
+            self._make_one(all_=True, ranges=[range_1, range_2])
+
+    def test___eq___w_self(self):
+        keyset = self._make_one(all_=True)
+        self.assertEqual(keyset, keyset)
+
+    def test___eq___w_other_type(self):
+        keyset = self._make_one(all_=True)
+        self.assertNotEqual(keyset, object())
+
+    def test___eq___w_all_hit(self):
+        keyset = self._make_one(all_=True)
+        other = self._make_one(all_=True)
+        self.assertEqual(keyset, other)
+
+    def test___eq___w_all_miss(self):
+        keys = [[u"key1"], [u"key2"]]
+        keyset = self._make_one(all_=True)
+        other = self._make_one(keys=keys)
+        self.assertNotEqual(keyset, other)
+
+    def test___eq___w_keys_hit(self):
+        keys = [[u"key1"], [u"key2"]]
+
+        keyset = self._make_one(keys=keys)
+        other = self._make_one(keys=keys)
+
+        self.assertEqual(keyset, other)
+
+    def test___eq___w_keys_miss(self):
+        keys = [[u"key1"], [u"key2"]]
+
+        keyset = self._make_one(keys=keys[:1])
+        other = self._make_one(keys=keys[1:])
+
+        self.assertNotEqual(keyset, other)
+
+    def test___eq___w_ranges_hit(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        range_1 = KeyRange(start_closed=[u"key1"], end_open=[u"key3"])
+        range_2 = KeyRange(start_open=[u"key5"], end_closed=[u"key6"])
+
+        keyset = self._make_one(ranges=[range_1, range_2])
+        other = self._make_one(ranges=[range_1, range_2])
+
+        self.assertEqual(keyset, other)
+
+    def test___eq___w_ranges_miss(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        range_1 = KeyRange(start_closed=[u"key1"], end_open=[u"key3"])
+        range_2 = KeyRange(start_open=[u"key5"], end_closed=[u"key6"])
+
+        keyset = self._make_one(ranges=[range_1])
+        other = self._make_one(ranges=[range_2])
+
+        self.assertNotEqual(keyset, other)
+
+    def test_to_pb_w_all(self):
+        from google.cloud.spanner_v1.proto.keys_pb2 import KeySet
+
+        keyset = self._make_one(all_=True)
+
+        result = keyset._to_pb()
+
+        self.assertIsInstance(result, KeySet)
+        self.assertTrue(result.all)
+        self.assertEqual(len(result.keys), 0)
+        self.assertEqual(len(result.ranges), 0)
+
+    def test_to_pb_w_only_keys(self):
+        from google.cloud.spanner_v1.proto.keys_pb2 import KeySet
+
+        KEYS = [[u"key1"], [u"key2"]]
+        keyset = self._make_one(keys=KEYS)
+
+        result = keyset._to_pb()
+
+        self.assertIsInstance(result, KeySet)
+        self.assertFalse(result.all)
+        self.assertEqual(len(result.keys), len(KEYS))
+
+        for found, expected in zip(result.keys, KEYS):
+            self.assertEqual(len(found), len(expected))
+            self.assertEqual(found.values[0].string_value, expected[0])
+
+        self.assertEqual(len(result.ranges), 0)
+
+    def test_to_pb_w_only_ranges(self):
+        from google.cloud.spanner_v1.proto.keys_pb2 import KeySet
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        KEY_1 = u"KEY_1"
+        KEY_2 = u"KEY_2"
+        KEY_3 = u"KEY_3"
+        KEY_4 = u"KEY_4"
+        RANGES = [
+            KeyRange(start_open=KEY_1, end_closed=KEY_2),
+            KeyRange(start_closed=KEY_3, end_open=KEY_4),
+        ]
+        keyset = self._make_one(ranges=RANGES)
+
+        result = keyset._to_pb()
+
+        self.assertIsInstance(result, KeySet)
+        self.assertFalse(result.all)
+        self.assertEqual(len(result.keys), 0)
+        self.assertEqual(len(result.ranges), len(RANGES))
+
+        for found, expected in zip(result.ranges, RANGES):
+            self.assertEqual(found, expected._to_pb())
+
+    def test_to_dict_w_all(self):
+        keyset = self._make_one(all_=True)
+        expected = {"all": True}
+        self.assertEqual(keyset._to_dict(), expected)
+
+    def test_to_dict_w_only_keys(self):
+        KEYS = [[u"key1"], [u"key2"]]
+        keyset = self._make_one(keys=KEYS)
+
+        expected = {"keys": KEYS, "ranges": []}
+        self.assertEqual(keyset._to_dict(), expected)
+
+    def test_to_dict_w_only_ranges(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        key_1 = u"KEY_1"
+        key_2 = u"KEY_2"
+        key_3 = u"KEY_3"
+        key_4 = u"KEY_4"
+        ranges = [
+            KeyRange(start_open=[key_1], end_closed=[key_2]),
+            KeyRange(start_closed=[key_3], end_open=[key_4]),
+        ]
+        keyset = self._make_one(ranges=ranges)
+
+        expected = {
+            "keys": [],
+            "ranges": [
+                {"start_open": [key_1], "end_closed": [key_2]},
+                {"start_closed": [key_3], "end_open": [key_4]},
+            ],
+        }
+        self.assertEqual(keyset._to_dict(), expected)
+
+    def test_from_dict_w_all(self):
+        klass = self._get_target_class()
+        mapping = {"all": True}
+
+        keyset = klass._from_dict(mapping)
+
+        self.assertTrue(keyset.all_)
+        self.assertEqual(keyset.keys, [])
+        self.assertEqual(keyset.ranges, [])
+
+    def test_from_dict_w_keys(self):
+        klass = self._get_target_class()
+        keys = [[u"key1"], [u"key2"]]
+        mapping = {"keys": keys}
+
+        keyset = klass._from_dict(mapping)
+
+        self.assertFalse(keyset.all_)
+        self.assertEqual(keyset.keys, keys)
+        self.assertEqual(keyset.ranges, [])
+
+    def test_from_dict_w_ranges(self):
+        from google.cloud.spanner_v1.keyset import KeyRange
+
+        klass = self._get_target_class()
+        key_1 = u"KEY_1"
+        key_2 = u"KEY_2"
+        key_3 = u"KEY_3"
+        key_4 = u"KEY_4"
+        mapping = {
+            "ranges": [
+                {"start_open": [key_1], "end_closed": [key_2]},
+                {"start_closed": [key_3], "end_open": [key_4]},
+            ]
+        }
+
+        keyset = klass._from_dict(mapping)
+
+        range_1 = KeyRange(start_open=[key_1], end_closed=[key_2])
+        range_2 = KeyRange(start_closed=[key_3], end_open=[key_4])
+
+        self.assertFalse(keyset.all_)
+        self.assertEqual(keyset.keys, [])
+        self.assertEqual(keyset.ranges, [range_1, range_2])
diff --git a/spanner/tests/unit/test_param_types.py b/spanner/tests/unit/test_param_types.py
new file mode 100644
index 000000000000..cb1c548af9e7
--- /dev/null
+++ b/spanner/tests/unit/test_param_types.py
@@ -0,0 +1,57 @@
+# Copyright 2017 Google LLC 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.
+
+
+import unittest
+
+
+class Test_ArrayParamType(unittest.TestCase):
+    def test_it(self):
+        from google.cloud.spanner_v1.proto import type_pb2
+        from google.cloud.spanner_v1 import param_types
+
+        expected = type_pb2.Type(
+            code=type_pb2.ARRAY, array_element_type=type_pb2.Type(code=type_pb2.INT64)
+        )
+
+        found = param_types.Array(param_types.INT64)
+
+        self.assertEqual(found, expected)
+
+
+class Test_Struct(unittest.TestCase):
+    def test_it(self):
+        from google.cloud.spanner_v1.proto import type_pb2
+        from google.cloud.spanner_v1 import param_types
+
+        struct_type = type_pb2.StructType(
+            fields=[
+                type_pb2.StructType.Field(
+                    name="name", type=type_pb2.Type(code=type_pb2.STRING)
+                ),
+                type_pb2.StructType.Field(
+                    name="count", type=type_pb2.Type(code=type_pb2.INT64)
+                ),
+            ]
+        )
+        expected = type_pb2.Type(code=type_pb2.STRUCT, struct_type=struct_type)
+
+        found = param_types.Struct(
+            [
+                param_types.StructField("name", param_types.STRING),
+                param_types.StructField("count", param_types.INT64),
+            ]
+        )
+
+        self.assertEqual(found, expected)
diff --git a/spanner/tests/unit/test_pool.py b/spanner/tests/unit/test_pool.py
new file mode 100644
index 000000000000..549044b1f423
--- /dev/null
+++ b/spanner/tests/unit/test_pool.py
@@ -0,0 +1,914 @@
+# Copyright 2016 Google LLC 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.
+
+
+from functools import total_ordering
+import unittest
+
+import mock
+
+
+def _make_database(name="name"):
+    from google.cloud.spanner_v1.database import Database
+
+    return mock.create_autospec(Database, instance=True)
+
+
+def _make_session():
+    from google.cloud.spanner_v1.database import Session
+
+    return mock.create_autospec(Session, instance=True)
+
+
+class TestAbstractSessionPool(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.pool import AbstractSessionPool
+
+        return AbstractSessionPool
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        pool = self._make_one()
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.labels, {})
+
+    def test_ctor_explicit(self):
+        labels = {"foo": "bar"}
+        pool = self._make_one(labels=labels)
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.labels, labels)
+
+    def test_bind_abstract(self):
+        pool = self._make_one()
+        database = _make_database("name")
+        with self.assertRaises(NotImplementedError):
+            pool.bind(database)
+
+    def test_get_abstract(self):
+        pool = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            pool.get()
+
+    def test_put_abstract(self):
+        pool = self._make_one()
+        session = object()
+        with self.assertRaises(NotImplementedError):
+            pool.put(session)
+
+    def test_clear_abstract(self):
+        pool = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            pool.clear()
+
+    def test__new_session_wo_labels(self):
+        pool = self._make_one()
+        database = pool._database = _make_database("name")
+        session = _make_session()
+        database.session.return_value = session
+
+        new_session = pool._new_session()
+
+        self.assertIs(new_session, session)
+        database.session.assert_called_once_with()
+
+    def test__new_session_w_labels(self):
+        labels = {"foo": "bar"}
+        pool = self._make_one(labels=labels)
+        database = pool._database = _make_database("name")
+        session = _make_session()
+        database.session.return_value = session
+
+        new_session = pool._new_session()
+
+        self.assertIs(new_session, session)
+        database.session.assert_called_once_with(labels=labels)
+
+    def test_session_wo_kwargs(self):
+        from google.cloud.spanner_v1.pool import SessionCheckout
+
+        pool = self._make_one()
+        checkout = pool.session()
+        self.assertIsInstance(checkout, SessionCheckout)
+        self.assertIs(checkout._pool, pool)
+        self.assertIsNone(checkout._session)
+        self.assertEqual(checkout._kwargs, {})
+
+    def test_session_w_kwargs(self):
+        from google.cloud.spanner_v1.pool import SessionCheckout
+
+        pool = self._make_one()
+        checkout = pool.session(foo="bar")
+        self.assertIsInstance(checkout, SessionCheckout)
+        self.assertIs(checkout._pool, pool)
+        self.assertIsNone(checkout._session)
+        self.assertEqual(checkout._kwargs, {"foo": "bar"})
+
+
+class TestFixedSizePool(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.pool import FixedSizePool
+
+        return FixedSizePool
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        pool = self._make_one()
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertTrue(pool._sessions.empty())
+        self.assertEqual(pool.labels, {})
+
+    def test_ctor_explicit(self):
+        labels = {"foo": "bar"}
+        pool = self._make_one(size=4, default_timeout=30, labels=labels)
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.size, 4)
+        self.assertEqual(pool.default_timeout, 30)
+        self.assertTrue(pool._sessions.empty())
+        self.assertEqual(pool.labels, labels)
+
+    def test_bind(self):
+        pool = self._make_one()
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 10
+        database._sessions.extend(SESSIONS)
+
+        pool.bind(database)
+
+        self.assertIs(pool._database, database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertTrue(pool._sessions.full())
+
+        for session in SESSIONS:
+            self.assertTrue(session._created)
+
+    def test_get_non_expired(self):
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 4
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        session = pool.get()
+
+        self.assertIs(session, SESSIONS[0])
+        self.assertTrue(session._exists_checked)
+        self.assertFalse(pool._sessions.full())
+
+    def test_get_expired(self):
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 5
+        SESSIONS[0]._exists = False
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        session = pool.get()
+
+        self.assertIs(session, SESSIONS[4])
+        self.assertTrue(session._created)
+        self.assertTrue(SESSIONS[0]._exists_checked)
+        self.assertFalse(pool._sessions.full())
+
+    def test_get_empty_default_timeout(self):
+        from six.moves.queue import Empty
+
+        pool = self._make_one(size=1)
+        queue = pool._sessions = _Queue()
+
+        with self.assertRaises(Empty):
+            pool.get()
+
+        self.assertEqual(queue._got, {"block": True, "timeout": 10})
+
+    def test_get_empty_explicit_timeout(self):
+        from six.moves.queue import Empty
+
+        pool = self._make_one(size=1, default_timeout=0.1)
+        queue = pool._sessions = _Queue()
+
+        with self.assertRaises(Empty):
+            pool.get(timeout=1)
+
+        self.assertEqual(queue._got, {"block": True, "timeout": 1})
+
+    def test_put_full(self):
+        from six.moves.queue import Full
+
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 4
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        with self.assertRaises(Full):
+            pool.put(_Session(database))
+
+        self.assertTrue(pool._sessions.full())
+
+    def test_put_non_full(self):
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 4
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+        pool._sessions.get()
+
+        pool.put(_Session(database))
+
+        self.assertTrue(pool._sessions.full())
+
+    def test_clear(self):
+        pool = self._make_one()
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 10
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+        self.assertTrue(pool._sessions.full())
+
+        for session in SESSIONS:
+            self.assertTrue(session._created)
+
+        pool.clear()
+
+        for session in SESSIONS:
+            self.assertTrue(session._deleted)
+
+
+class TestBurstyPool(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.pool import BurstyPool
+
+        return BurstyPool
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        pool = self._make_one()
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.target_size, 10)
+        self.assertTrue(pool._sessions.empty())
+        self.assertEqual(pool.labels, {})
+
+    def test_ctor_explicit(self):
+        labels = {"foo": "bar"}
+        pool = self._make_one(target_size=4, labels=labels)
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.target_size, 4)
+        self.assertTrue(pool._sessions.empty())
+        self.assertEqual(pool.labels, labels)
+
+    def test_get_empty(self):
+        pool = self._make_one()
+        database = _Database("name")
+        database._sessions.append(_Session(database))
+        pool.bind(database)
+
+        session = pool.get()
+
+        self.assertIsInstance(session, _Session)
+        self.assertIs(session._database, database)
+        self.assertTrue(session._created)
+        self.assertTrue(pool._sessions.empty())
+
+    def test_get_non_empty_session_exists(self):
+        pool = self._make_one()
+        database = _Database("name")
+        previous = _Session(database)
+        pool.bind(database)
+        pool.put(previous)
+
+        session = pool.get()
+
+        self.assertIs(session, previous)
+        self.assertFalse(session._created)
+        self.assertTrue(session._exists_checked)
+        self.assertTrue(pool._sessions.empty())
+
+    def test_get_non_empty_session_expired(self):
+        pool = self._make_one()
+        database = _Database("name")
+        previous = _Session(database, exists=False)
+        newborn = _Session(database)
+        database._sessions.append(newborn)
+        pool.bind(database)
+        pool.put(previous)
+
+        session = pool.get()
+
+        self.assertTrue(previous._exists_checked)
+        self.assertIs(session, newborn)
+        self.assertTrue(session._created)
+        self.assertFalse(session._exists_checked)
+        self.assertTrue(pool._sessions.empty())
+
+    def test_put_empty(self):
+        pool = self._make_one()
+        database = _Database("name")
+        pool.bind(database)
+        session = _Session(database)
+
+        pool.put(session)
+
+        self.assertFalse(pool._sessions.empty())
+
+    def test_put_full(self):
+        pool = self._make_one(target_size=1)
+        database = _Database("name")
+        pool.bind(database)
+        older = _Session(database)
+        pool.put(older)
+        self.assertFalse(pool._sessions.empty())
+
+        younger = _Session(database)
+        pool.put(younger)  # discarded silently
+
+        self.assertTrue(younger._deleted)
+        self.assertIs(pool.get(), older)
+
+    def test_put_full_expired(self):
+        pool = self._make_one(target_size=1)
+        database = _Database("name")
+        pool.bind(database)
+        older = _Session(database)
+        pool.put(older)
+        self.assertFalse(pool._sessions.empty())
+
+        younger = _Session(database, exists=False)
+        pool.put(younger)  # discarded silently
+
+        self.assertTrue(younger._deleted)
+        self.assertIs(pool.get(), older)
+
+    def test_clear(self):
+        pool = self._make_one()
+        database = _Database("name")
+        pool.bind(database)
+        previous = _Session(database)
+        pool.put(previous)
+
+        pool.clear()
+
+        self.assertTrue(previous._deleted)
+
+
+class TestPingingPool(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.pool import PingingPool
+
+        return PingingPool
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        pool = self._make_one()
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertEqual(pool._delta.seconds, 3000)
+        self.assertTrue(pool._sessions.empty())
+        self.assertEqual(pool.labels, {})
+
+    def test_ctor_explicit(self):
+        labels = {"foo": "bar"}
+        pool = self._make_one(
+            size=4, default_timeout=30, ping_interval=1800, labels=labels
+        )
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.size, 4)
+        self.assertEqual(pool.default_timeout, 30)
+        self.assertEqual(pool._delta.seconds, 1800)
+        self.assertTrue(pool._sessions.empty())
+        self.assertEqual(pool.labels, labels)
+
+    def test_bind(self):
+        pool = self._make_one()
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 10
+        database._sessions.extend(SESSIONS)
+
+        pool.bind(database)
+
+        self.assertIs(pool._database, database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertEqual(pool._delta.seconds, 3000)
+        self.assertTrue(pool._sessions.full())
+
+        for session in SESSIONS:
+            self.assertTrue(session._created)
+
+    def test_get_hit_no_ping(self):
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 4
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        session = pool.get()
+
+        self.assertIs(session, SESSIONS[0])
+        self.assertFalse(session._exists_checked)
+        self.assertFalse(pool._sessions.full())
+
+    def test_get_hit_w_ping(self):
+        import datetime
+        from google.cloud._testing import _Monkey
+        from google.cloud.spanner_v1 import pool as MUT
+
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 4
+        database._sessions.extend(SESSIONS)
+
+        sessions_created = datetime.datetime.utcnow() - datetime.timedelta(seconds=4000)
+
+        with _Monkey(MUT, _NOW=lambda: sessions_created):
+            pool.bind(database)
+
+        session = pool.get()
+
+        self.assertIs(session, SESSIONS[0])
+        self.assertTrue(session._exists_checked)
+        self.assertFalse(pool._sessions.full())
+
+    def test_get_hit_w_ping_expired(self):
+        import datetime
+        from google.cloud._testing import _Monkey
+        from google.cloud.spanner_v1 import pool as MUT
+
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 5
+        SESSIONS[0]._exists = False
+        database._sessions.extend(SESSIONS)
+
+        sessions_created = datetime.datetime.utcnow() - datetime.timedelta(seconds=4000)
+
+        with _Monkey(MUT, _NOW=lambda: sessions_created):
+            pool.bind(database)
+
+        session = pool.get()
+
+        self.assertIs(session, SESSIONS[4])
+        self.assertTrue(session._created)
+        self.assertTrue(SESSIONS[0]._exists_checked)
+        self.assertFalse(pool._sessions.full())
+
+    def test_get_empty_default_timeout(self):
+        from six.moves.queue import Empty
+
+        pool = self._make_one(size=1)
+        queue = pool._sessions = _Queue()
+
+        with self.assertRaises(Empty):
+            pool.get()
+
+        self.assertEqual(queue._got, {"block": True, "timeout": 10})
+
+    def test_get_empty_explicit_timeout(self):
+        from six.moves.queue import Empty
+
+        pool = self._make_one(size=1, default_timeout=0.1)
+        queue = pool._sessions = _Queue()
+
+        with self.assertRaises(Empty):
+            pool.get(timeout=1)
+
+        self.assertEqual(queue._got, {"block": True, "timeout": 1})
+
+    def test_put_full(self):
+        from six.moves.queue import Full
+
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 4
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        with self.assertRaises(Full):
+            pool.put(_Session(database))
+
+        self.assertTrue(pool._sessions.full())
+
+    def test_put_non_full(self):
+        import datetime
+        from google.cloud._testing import _Monkey
+        from google.cloud.spanner_v1 import pool as MUT
+
+        pool = self._make_one(size=1)
+        queue = pool._sessions = _Queue()
+
+        now = datetime.datetime.utcnow()
+        database = _Database("name")
+        session = _Session(database)
+
+        with _Monkey(MUT, _NOW=lambda: now):
+            pool.put(session)
+
+        self.assertEqual(len(queue._items), 1)
+        ping_after, queued = queue._items[0]
+        self.assertEqual(ping_after, now + datetime.timedelta(seconds=3000))
+        self.assertIs(queued, session)
+
+    def test_clear(self):
+        pool = self._make_one()
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 10
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+        self.assertTrue(pool._sessions.full())
+
+        for session in SESSIONS:
+            self.assertTrue(session._created)
+
+        pool.clear()
+
+        for session in SESSIONS:
+            self.assertTrue(session._deleted)
+
+    def test_ping_empty(self):
+        pool = self._make_one(size=1)
+        pool.ping()  # Does not raise 'Empty'
+
+    def test_ping_oldest_fresh(self):
+        pool = self._make_one(size=1)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 1
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        pool.ping()
+
+        self.assertFalse(SESSIONS[0]._exists_checked)
+
+    def test_ping_oldest_stale_but_exists(self):
+        import datetime
+        from google.cloud._testing import _Monkey
+        from google.cloud.spanner_v1 import pool as MUT
+
+        pool = self._make_one(size=1)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 1
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        later = datetime.datetime.utcnow() + datetime.timedelta(seconds=4000)
+        with _Monkey(MUT, _NOW=lambda: later):
+            pool.ping()
+
+        self.assertTrue(SESSIONS[0]._exists_checked)
+
+    def test_ping_oldest_stale_and_not_exists(self):
+        import datetime
+        from google.cloud._testing import _Monkey
+        from google.cloud.spanner_v1 import pool as MUT
+
+        pool = self._make_one(size=1)
+        database = _Database("name")
+        SESSIONS = [_Session(database)] * 2
+        SESSIONS[0]._exists = False
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        later = datetime.datetime.utcnow() + datetime.timedelta(seconds=4000)
+        with _Monkey(MUT, _NOW=lambda: later):
+            pool.ping()
+
+        self.assertTrue(SESSIONS[0]._exists_checked)
+        self.assertTrue(SESSIONS[1]._created)
+
+
+class TestTransactionPingingPool(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.pool import TransactionPingingPool
+
+        return TransactionPingingPool
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        pool = self._make_one()
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertEqual(pool._delta.seconds, 3000)
+        self.assertTrue(pool._sessions.empty())
+        self.assertTrue(pool._pending_sessions.empty())
+        self.assertEqual(pool.labels, {})
+
+    def test_ctor_explicit(self):
+        labels = {"foo": "bar"}
+        pool = self._make_one(
+            size=4, default_timeout=30, ping_interval=1800, labels=labels
+        )
+        self.assertIsNone(pool._database)
+        self.assertEqual(pool.size, 4)
+        self.assertEqual(pool.default_timeout, 30)
+        self.assertEqual(pool._delta.seconds, 1800)
+        self.assertTrue(pool._sessions.empty())
+        self.assertTrue(pool._pending_sessions.empty())
+        self.assertEqual(pool.labels, labels)
+
+    def test_bind(self):
+        pool = self._make_one()
+        database = _Database("name")
+        SESSIONS = [_Session(database) for _ in range(10)]
+        database._sessions.extend(SESSIONS)
+
+        pool.bind(database)
+
+        self.assertIs(pool._database, database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertEqual(pool._delta.seconds, 3000)
+        self.assertTrue(pool._sessions.full())
+
+        for session in SESSIONS:
+            self.assertTrue(session._created)
+            txn = session._transaction
+            self.assertTrue(txn._begun)
+
+        self.assertTrue(pool._pending_sessions.empty())
+
+    def test_bind_w_timestamp_race(self):
+        import datetime
+        from google.cloud._testing import _Monkey
+        from google.cloud.spanner_v1 import pool as MUT
+
+        NOW = datetime.datetime.utcnow()
+        pool = self._make_one()
+        database = _Database("name")
+        SESSIONS = [_Session(database) for _ in range(10)]
+        database._sessions.extend(SESSIONS)
+
+        with _Monkey(MUT, _NOW=lambda: NOW):
+            pool.bind(database)
+
+        self.assertIs(pool._database, database)
+        self.assertEqual(pool.size, 10)
+        self.assertEqual(pool.default_timeout, 10)
+        self.assertEqual(pool._delta.seconds, 3000)
+        self.assertTrue(pool._sessions.full())
+
+        for session in SESSIONS:
+            self.assertTrue(session._created)
+            txn = session._transaction
+            self.assertTrue(txn._begun)
+
+        self.assertTrue(pool._pending_sessions.empty())
+
+    def test_put_full(self):
+        from six.moves.queue import Full
+
+        pool = self._make_one(size=4)
+        database = _Database("name")
+        SESSIONS = [_Session(database) for _ in range(4)]
+        database._sessions.extend(SESSIONS)
+        pool.bind(database)
+
+        with self.assertRaises(Full):
+            pool.put(_Session(database))
+
+        self.assertTrue(pool._sessions.full())
+
+    def test_put_non_full_w_active_txn(self):
+        pool = self._make_one(size=1)
+        queue = pool._sessions = _Queue()
+        pending = pool._pending_sessions = _Queue()
+        database = _Database("name")
+        session = _Session(database)
+        txn = session.transaction()
+
+        pool.put(session)
+
+        self.assertEqual(len(queue._items), 1)
+        _, queued = queue._items[0]
+        self.assertIs(queued, session)
+
+        self.assertEqual(len(pending._items), 0)
+        self.assertFalse(txn._begun)
+
+    def test_put_non_full_w_committed_txn(self):
+        pool = self._make_one(size=1)
+        queue = pool._sessions = _Queue()
+        pending = pool._pending_sessions = _Queue()
+        database = _Database("name")
+        session = _Session(database)
+        committed = session.transaction()
+        committed._committed = True
+
+        pool.put(session)
+
+        self.assertEqual(len(queue._items), 0)
+
+        self.assertEqual(len(pending._items), 1)
+        self.assertIs(pending._items[0], session)
+        self.assertIsNot(session._transaction, committed)
+        self.assertFalse(session._transaction._begun)
+
+    def test_put_non_full(self):
+        pool = self._make_one(size=1)
+        queue = pool._sessions = _Queue()
+        pending = pool._pending_sessions = _Queue()
+        database = _Database("name")
+        session = _Session(database)
+
+        pool.put(session)
+
+        self.assertEqual(len(queue._items), 0)
+        self.assertEqual(len(pending._items), 1)
+        self.assertIs(pending._items[0], session)
+
+        self.assertFalse(pending.empty())
+
+    def test_begin_pending_transactions_empty(self):
+        pool = self._make_one(size=1)
+        pool.begin_pending_transactions()  # no raise
+
+    def test_begin_pending_transactions_non_empty(self):
+        pool = self._make_one(size=1)
+        pool._sessions = _Queue()
+
+        database = _Database("name")
+        TRANSACTIONS = [_Transaction()]
+        PENDING_SESSIONS = [_Session(database, transaction=txn) for txn in TRANSACTIONS]
+
+        pending = pool._pending_sessions = _Queue(*PENDING_SESSIONS)
+        self.assertFalse(pending.empty())
+
+        pool.begin_pending_transactions()  # no raise
+
+        for txn in TRANSACTIONS:
+            self.assertTrue(txn._begun)
+
+        self.assertTrue(pending.empty())
+
+
+class TestSessionCheckout(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.pool import SessionCheckout
+
+        return SessionCheckout
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_wo_kwargs(self):
+        pool = _Pool()
+        checkout = self._make_one(pool)
+        self.assertIs(checkout._pool, pool)
+        self.assertIsNone(checkout._session)
+        self.assertEqual(checkout._kwargs, {})
+
+    def test_ctor_w_kwargs(self):
+        pool = _Pool()
+        checkout = self._make_one(pool, foo="bar")
+        self.assertIs(checkout._pool, pool)
+        self.assertIsNone(checkout._session)
+        self.assertEqual(checkout._kwargs, {"foo": "bar"})
+
+    def test_context_manager_wo_kwargs(self):
+        session = object()
+        pool = _Pool(session)
+        checkout = self._make_one(pool)
+
+        self.assertEqual(len(pool._items), 1)
+        self.assertIs(pool._items[0], session)
+
+        with checkout as borrowed:
+            self.assertIs(borrowed, session)
+            self.assertEqual(len(pool._items), 0)
+
+        self.assertEqual(len(pool._items), 1)
+        self.assertIs(pool._items[0], session)
+        self.assertEqual(pool._got, {})
+
+    def test_context_manager_w_kwargs(self):
+        session = object()
+        pool = _Pool(session)
+        checkout = self._make_one(pool, foo="bar")
+
+        self.assertEqual(len(pool._items), 1)
+        self.assertIs(pool._items[0], session)
+
+        with checkout as borrowed:
+            self.assertIs(borrowed, session)
+            self.assertEqual(len(pool._items), 0)
+
+        self.assertEqual(len(pool._items), 1)
+        self.assertIs(pool._items[0], session)
+        self.assertEqual(pool._got, {"foo": "bar"})
+
+
+class _Transaction(object):
+
+    _begun = False
+    _committed = False
+    _rolled_back = False
+
+    def begin(self):
+        self._begun = True
+
+    def committed(self):
+        return self._committed
+
+
+@total_ordering
+class _Session(object):
+
+    _transaction = None
+
+    def __init__(self, database, exists=True, transaction=None):
+        self._database = database
+        self._exists = exists
+        self._exists_checked = False
+        self._created = False
+        self._deleted = False
+        self._transaction = transaction
+
+    def __lt__(self, other):
+        return id(self) < id(other)
+
+    def create(self):
+        self._created = True
+
+    def exists(self):
+        self._exists_checked = True
+        return self._exists
+
+    def delete(self):
+        from google.cloud.exceptions import NotFound
+
+        self._deleted = True
+        if not self._exists:
+            raise NotFound("unknown session")
+
+    def transaction(self):
+        txn = self._transaction = _Transaction()
+        return txn
+
+
+class _Database(object):
+    def __init__(self, name):
+        self.name = name
+        self._sessions = []
+
+    def session(self):
+        return self._sessions.pop()
+
+
+class _Queue(object):
+
+    _size = 1
+
+    def __init__(self, *items):
+        self._items = list(items)
+
+    def empty(self):
+        return len(self._items) == 0
+
+    def full(self):
+        return len(self._items) >= self._size
+
+    def get(self, **kwargs):
+        from six.moves.queue import Empty
+
+        self._got = kwargs
+        try:
+            return self._items.pop()
+        except IndexError:
+            raise Empty()
+
+    def put(self, item, **kwargs):
+        self._put = kwargs
+        self._items.append(item)
+
+    def put_nowait(self, item, **kwargs):
+        self._put_nowait = kwargs
+        self._items.append(item)
+
+
+class _Pool(_Queue):
+
+    _database = None
diff --git a/spanner/tests/unit/test_session.py b/spanner/tests/unit/test_session.py
new file mode 100644
index 000000000000..a198d19ecd26
--- /dev/null
+++ b/spanner/tests/unit/test_session.py
@@ -0,0 +1,1107 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+import google.api_core.gapic_v1.method
+import mock
+
+
+def _make_rpc_error(error_cls, trailing_metadata=None):
+    import grpc
+
+    grpc_error = mock.create_autospec(grpc.Call, instance=True)
+    grpc_error.trailing_metadata.return_value = trailing_metadata
+    return error_cls("error", errors=(grpc_error,))
+
+
+class TestSession(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    DATABASE_ID = "database-id"
+    DATABASE_NAME = INSTANCE_NAME + "/databases/" + DATABASE_ID
+    SESSION_ID = "session-id"
+    SESSION_NAME = DATABASE_NAME + "/sessions/" + SESSION_ID
+
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.session import Session
+
+        return Session
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    @staticmethod
+    def _make_database(name=DATABASE_NAME):
+        from google.cloud.spanner_v1.database import Database
+
+        database = mock.create_autospec(Database, instance=True)
+        database.name = name
+        return database
+
+    @staticmethod
+    def _make_session_pb(name, labels=None):
+        from google.cloud.spanner_v1.proto.spanner_pb2 import Session
+
+        return Session(name=name, labels=labels)
+
+    def _make_spanner_api(self):
+        from google.cloud.spanner_v1.gapic.spanner_client import SpannerClient
+
+        return mock.Mock(autospec=SpannerClient, instance=True)
+
+    def test_constructor_wo_labels(self):
+        database = self._make_database()
+        session = self._make_one(database)
+        self.assertIs(session.session_id, None)
+        self.assertIs(session._database, database)
+        self.assertEqual(session.labels, {})
+
+    def test_constructor_w_labels(self):
+        database = self._make_database()
+        labels = {"foo": "bar"}
+        session = self._make_one(database, labels=labels)
+        self.assertIs(session.session_id, None)
+        self.assertIs(session._database, database)
+        self.assertEqual(session.labels, labels)
+
+    def test___lt___(self):
+        database = self._make_database()
+        lhs = self._make_one(database)
+        lhs._session_id = b"123"
+        rhs = self._make_one(database)
+        rhs._session_id = b"234"
+        self.assertTrue(lhs < rhs)
+
+    def test_name_property_wo_session_id(self):
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            (session.name)
+
+    def test_name_property_w_session_id(self):
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+        self.assertEqual(session.name, self.SESSION_NAME)
+
+    def test_create_w_session_id(self):
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        with self.assertRaises(ValueError):
+            session.create()
+
+    def test_create_ok(self):
+        session_pb = self._make_session_pb(self.SESSION_NAME)
+        gax_api = self._make_spanner_api()
+        gax_api.create_session.return_value = session_pb
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+
+        session.create()
+
+        self.assertEqual(session.session_id, self.SESSION_ID)
+
+        gax_api.create_session.assert_called_once_with(
+            database.name, metadata=[("google-cloud-resource-prefix", database.name)]
+        )
+
+    def test_create_w_labels(self):
+        labels = {"foo": "bar"}
+        session_pb = self._make_session_pb(self.SESSION_NAME, labels=labels)
+        gax_api = self._make_spanner_api()
+        gax_api.create_session.return_value = session_pb
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database, labels=labels)
+
+        session.create()
+
+        self.assertEqual(session.session_id, self.SESSION_ID)
+
+        gax_api.create_session.assert_called_once_with(
+            database.name,
+            session={"labels": labels},
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_create_error(self):
+        from google.api_core.exceptions import Unknown
+
+        gax_api = self._make_spanner_api()
+        gax_api.create_session.side_effect = Unknown("error")
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+
+        with self.assertRaises(Unknown):
+            session.create()
+
+    def test_exists_wo_session_id(self):
+        database = self._make_database()
+        session = self._make_one(database)
+        self.assertFalse(session.exists())
+
+    def test_exists_hit(self):
+        session_pb = self._make_session_pb(self.SESSION_NAME)
+        gax_api = self._make_spanner_api()
+        gax_api.get_session.return_value = session_pb
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        self.assertTrue(session.exists())
+
+        gax_api.get_session.assert_called_once_with(
+            self.SESSION_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_exists_miss(self):
+        from google.api_core.exceptions import NotFound
+
+        gax_api = self._make_spanner_api()
+        gax_api.get_session.side_effect = NotFound("testing")
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        self.assertFalse(session.exists())
+
+        gax_api.get_session.assert_called_once_with(
+            self.SESSION_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_exists_error(self):
+        from google.api_core.exceptions import Unknown
+
+        gax_api = self._make_spanner_api()
+        gax_api.get_session.side_effect = Unknown("testing")
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        with self.assertRaises(Unknown):
+            session.exists()
+
+        gax_api.get_session.assert_called_once_with(
+            self.SESSION_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_delete_wo_session_id(self):
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            session.delete()
+
+    def test_delete_hit(self):
+        gax_api = self._make_spanner_api()
+        gax_api.delete_session.return_value = None
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        session.delete()
+
+        gax_api.delete_session.assert_called_once_with(
+            self.SESSION_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_delete_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        gax_api = self._make_spanner_api()
+        gax_api.delete_session.side_effect = NotFound("testing")
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        with self.assertRaises(NotFound):
+            session.delete()
+
+        gax_api.delete_session.assert_called_once_with(
+            self.SESSION_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_delete_error(self):
+        from google.api_core.exceptions import Unknown
+
+        gax_api = self._make_spanner_api()
+        gax_api.delete_session.side_effect = Unknown("testing")
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        with self.assertRaises(Unknown):
+            session.delete()
+
+        gax_api.delete_session.assert_called_once_with(
+            self.SESSION_NAME,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_snapshot_not_created(self):
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            session.snapshot()
+
+    def test_snapshot_created(self):
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"  # emulate 'session.create()'
+
+        snapshot = session.snapshot()
+
+        self.assertIsInstance(snapshot, Snapshot)
+        self.assertIs(snapshot._session, session)
+        self.assertTrue(snapshot._strong)
+        self.assertFalse(snapshot._multi_use)
+
+    def test_snapshot_created_w_multi_use(self):
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"  # emulate 'session.create()'
+
+        snapshot = session.snapshot(multi_use=True)
+
+        self.assertIsInstance(snapshot, Snapshot)
+        self.assertTrue(snapshot._session is session)
+        self.assertTrue(snapshot._strong)
+        self.assertTrue(snapshot._multi_use)
+
+    def test_read_not_created(self):
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        KEYS = ["bharney@example.com", "phred@example.com"]
+        KEYSET = KeySet(keys=KEYS)
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            session.read(TABLE_NAME, COLUMNS, KEYSET)
+
+    def test_read(self):
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        KEYS = ["bharney@example.com", "phred@example.com"]
+        KEYSET = KeySet(keys=KEYS)
+        INDEX = "email-address-index"
+        LIMIT = 20
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        with mock.patch("google.cloud.spanner_v1.session.Snapshot") as snapshot:
+            found = session.read(TABLE_NAME, COLUMNS, KEYSET, index=INDEX, limit=LIMIT)
+
+        self.assertIs(found, snapshot().read.return_value)
+
+        snapshot().read.assert_called_once_with(
+            TABLE_NAME, COLUMNS, KEYSET, INDEX, LIMIT
+        )
+
+    def test_execute_sql_not_created(self):
+        SQL = "SELECT first_name, age FROM citizens"
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            session.execute_sql(SQL)
+
+    def test_execute_sql_defaults(self):
+        SQL = "SELECT first_name, age FROM citizens"
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        with mock.patch("google.cloud.spanner_v1.session.Snapshot") as snapshot:
+            found = session.execute_sql(SQL)
+
+        self.assertIs(found, snapshot().execute_sql.return_value)
+
+        snapshot().execute_sql.assert_called_once_with(
+            SQL,
+            None,
+            None,
+            None,
+            timeout=google.api_core.gapic_v1.method.DEFAULT,
+            retry=google.api_core.gapic_v1.method.DEFAULT,
+        )
+
+    def test_execute_sql_non_default_retry(self):
+        from google.protobuf.struct_pb2 import Struct, Value
+        from google.cloud.spanner_v1.proto.type_pb2 import STRING
+
+        SQL = "SELECT first_name, age FROM citizens"
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        params = Struct(fields={"foo": Value(string_value="bar")})
+        param_types = {"foo": STRING}
+
+        with mock.patch("google.cloud.spanner_v1.session.Snapshot") as snapshot:
+            found = session.execute_sql(
+                SQL, params, param_types, "PLAN", retry=None, timeout=None
+            )
+
+        self.assertIs(found, snapshot().execute_sql.return_value)
+
+        snapshot().execute_sql.assert_called_once_with(
+            SQL, params, param_types, "PLAN", timeout=None, retry=None
+        )
+
+    def test_execute_sql_explicit(self):
+        from google.protobuf.struct_pb2 import Struct, Value
+        from google.cloud.spanner_v1.proto.type_pb2 import STRING
+
+        SQL = "SELECT first_name, age FROM citizens"
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        params = Struct(fields={"foo": Value(string_value="bar")})
+        param_types = {"foo": STRING}
+
+        with mock.patch("google.cloud.spanner_v1.session.Snapshot") as snapshot:
+            found = session.execute_sql(SQL, params, param_types, "PLAN")
+
+        self.assertIs(found, snapshot().execute_sql.return_value)
+
+        snapshot().execute_sql.assert_called_once_with(
+            SQL,
+            params,
+            param_types,
+            "PLAN",
+            timeout=google.api_core.gapic_v1.method.DEFAULT,
+            retry=google.api_core.gapic_v1.method.DEFAULT,
+        )
+
+    def test_batch_not_created(self):
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            session.batch()
+
+    def test_batch_created(self):
+        from google.cloud.spanner_v1.batch import Batch
+
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        batch = session.batch()
+
+        self.assertIsInstance(batch, Batch)
+        self.assertIs(batch._session, session)
+
+    def test_transaction_not_created(self):
+        database = self._make_database()
+        session = self._make_one(database)
+
+        with self.assertRaises(ValueError):
+            session.transaction()
+
+    def test_transaction_created(self):
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        transaction = session.transaction()
+
+        self.assertIsInstance(transaction, Transaction)
+        self.assertIs(transaction._session, session)
+        self.assertIs(session._transaction, transaction)
+
+    def test_transaction_w_existing_txn(self):
+        database = self._make_database()
+        session = self._make_one(database)
+        session._session_id = "DEADBEEF"
+
+        existing = session.transaction()
+        another = session.transaction()  # invalidates existing txn
+
+        self.assertIs(session._transaction, another)
+        self.assertTrue(existing._rolled_back)
+
+    def test_run_in_transaction_callback_raises_non_gax_error(self):
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.rollback.return_value = None
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        class Testing(Exception):
+            pass
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+            raise Testing()
+
+        with self.assertRaises(Testing):
+            session.run_in_transaction(unit_of_work)
+
+        self.assertIsNone(session._transaction)
+        self.assertEqual(len(called_with), 1)
+        txn, args, kw = called_with[0]
+        self.assertIsInstance(txn, Transaction)
+        self.assertIsNone(txn.committed)
+        self.assertTrue(txn._rolled_back)
+        self.assertEqual(args, ())
+        self.assertEqual(kw, {})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        gax_api.begin_transaction.assert_called_once_with(
+            self.SESSION_NAME,
+            expected_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+        gax_api.rollback.assert_called_once_with(
+            self.SESSION_NAME,
+            TRANSACTION_ID,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_run_in_transaction_callback_raises_non_abort_rpc_error(self):
+        from google.api_core.exceptions import Cancelled
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.rollback.return_value = None
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+            raise Cancelled("error")
+
+        with self.assertRaises(Cancelled):
+            session.run_in_transaction(unit_of_work)
+
+        self.assertIsNone(session._transaction)
+        self.assertEqual(len(called_with), 1)
+        txn, args, kw = called_with[0]
+        self.assertIsInstance(txn, Transaction)
+        self.assertIsNone(txn.committed)
+        self.assertFalse(txn._rolled_back)
+        self.assertEqual(args, ())
+        self.assertEqual(kw, {})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        gax_api.begin_transaction.assert_called_once_with(
+            self.SESSION_NAME,
+            expected_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+        gax_api.rollback.assert_not_called()
+
+    def test_run_in_transaction_w_args_w_kwargs_wo_abort(self):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.commit.return_value = response
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+            return 42
+
+        return_value = session.run_in_transaction(unit_of_work, "abc", some_arg="def")
+
+        self.assertIsNone(session._transaction)
+        self.assertEqual(len(called_with), 1)
+        txn, args, kw = called_with[0]
+        self.assertIsInstance(txn, Transaction)
+        self.assertEqual(return_value, 42)
+        self.assertEqual(args, ("abc",))
+        self.assertEqual(kw, {"some_arg": "def"})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        gax_api.begin_transaction.assert_called_once_with(
+            self.SESSION_NAME,
+            expected_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+        gax_api.commit.assert_called_once_with(
+            self.SESSION_NAME,
+            txn._mutations,
+            transaction_id=TRANSACTION_ID,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_run_in_transaction_w_commit_error(self):
+        from google.api_core.exceptions import Unknown
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        gax_api = self._make_spanner_api()
+        gax_api.commit.side_effect = Unknown("error")
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+        begun_txn = session._transaction = Transaction(session)
+        begun_txn._transaction_id = TRANSACTION_ID
+
+        assert session._transaction._transaction_id
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        with self.assertRaises(Unknown):
+            session.run_in_transaction(unit_of_work)
+
+        self.assertIsNone(session._transaction)
+        self.assertEqual(len(called_with), 1)
+        txn, args, kw = called_with[0]
+        self.assertIs(txn, begun_txn)
+        self.assertEqual(txn.committed, None)
+        self.assertEqual(args, ())
+        self.assertEqual(kw, {})
+
+        gax_api.begin_transaction.assert_not_called()
+        gax_api.commit.assert_called_once_with(
+            self.SESSION_NAME,
+            txn._mutations,
+            transaction_id=TRANSACTION_ID,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_run_in_transaction_w_abort_no_retry_metadata(self):
+        import datetime
+        from google.api_core.exceptions import Aborted
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        aborted = _make_rpc_error(Aborted, trailing_metadata=[])
+        response = CommitResponse(commit_timestamp=now_pb)
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.commit.side_effect = [aborted, response]
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+            return "answer"
+
+        return_value = session.run_in_transaction(unit_of_work, "abc", some_arg="def")
+
+        self.assertEqual(len(called_with), 2)
+        for index, (txn, args, kw) in enumerate(called_with):
+            self.assertIsInstance(txn, Transaction)
+            self.assertEqual(return_value, "answer")
+            self.assertEqual(args, ("abc",))
+            self.assertEqual(kw, {"some_arg": "def"})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        self.assertEqual(
+            gax_api.begin_transaction.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    expected_options,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 2,
+        )
+        self.assertEqual(
+            gax_api.commit.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    txn._mutations,
+                    transaction_id=TRANSACTION_ID,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 2,
+        )
+
+    def test_run_in_transaction_w_abort_w_retry_metadata(self):
+        import datetime
+        from google.api_core.exceptions import Aborted
+        from google.protobuf.duration_pb2 import Duration
+        from google.rpc.error_details_pb2 import RetryInfo
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        RETRY_SECONDS = 12
+        RETRY_NANOS = 3456
+        retry_info = RetryInfo(
+            retry_delay=Duration(seconds=RETRY_SECONDS, nanos=RETRY_NANOS)
+        )
+        trailing_metadata = [
+            ("google.rpc.retryinfo-bin", retry_info.SerializeToString())
+        ]
+        aborted = _make_rpc_error(Aborted, trailing_metadata=trailing_metadata)
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.commit.side_effect = [aborted, response]
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        with mock.patch("time.sleep") as sleep_mock:
+            session.run_in_transaction(unit_of_work, "abc", some_arg="def")
+
+        sleep_mock.assert_called_once_with(RETRY_SECONDS + RETRY_NANOS / 1.0e9)
+        self.assertEqual(len(called_with), 2)
+
+        for index, (txn, args, kw) in enumerate(called_with):
+            self.assertIsInstance(txn, Transaction)
+            if index == 1:
+                self.assertEqual(txn.committed, now)
+            else:
+                self.assertIsNone(txn.committed)
+            self.assertEqual(args, ("abc",))
+            self.assertEqual(kw, {"some_arg": "def"})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        self.assertEqual(
+            gax_api.begin_transaction.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    expected_options,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 2,
+        )
+        self.assertEqual(
+            gax_api.commit.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    txn._mutations,
+                    transaction_id=TRANSACTION_ID,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 2,
+        )
+
+    def test_run_in_transaction_w_callback_raises_abort_wo_metadata(self):
+        import datetime
+        from google.api_core.exceptions import Aborted
+        from google.protobuf.duration_pb2 import Duration
+        from google.rpc.error_details_pb2 import RetryInfo
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        RETRY_SECONDS = 1
+        RETRY_NANOS = 3456
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        retry_info = RetryInfo(
+            retry_delay=Duration(seconds=RETRY_SECONDS, nanos=RETRY_NANOS)
+        )
+        trailing_metadata = [
+            ("google.rpc.retryinfo-bin", retry_info.SerializeToString())
+        ]
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.commit.side_effect = [response]
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            if len(called_with) < 2:
+                raise _make_rpc_error(Aborted, trailing_metadata)
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        with mock.patch("time.sleep") as sleep_mock:
+            session.run_in_transaction(unit_of_work)
+
+        sleep_mock.assert_called_once_with(RETRY_SECONDS + RETRY_NANOS / 1.0e9)
+        self.assertEqual(len(called_with), 2)
+        for index, (txn, args, kw) in enumerate(called_with):
+            self.assertIsInstance(txn, Transaction)
+            if index == 0:
+                self.assertIsNone(txn.committed)
+            else:
+                self.assertEqual(txn.committed, now)
+            self.assertEqual(args, ())
+            self.assertEqual(kw, {})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        self.assertEqual(
+            gax_api.begin_transaction.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    expected_options,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 2,
+        )
+        gax_api.commit.assert_called_once_with(
+            self.SESSION_NAME,
+            txn._mutations,
+            transaction_id=TRANSACTION_ID,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_run_in_transaction_w_abort_w_retry_metadata_deadline(self):
+        import datetime
+        from google.api_core.exceptions import Aborted
+        from google.protobuf.duration_pb2 import Duration
+        from google.rpc.error_details_pb2 import RetryInfo
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1.transaction import Transaction
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        RETRY_SECONDS = 1
+        RETRY_NANOS = 3456
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        retry_info = RetryInfo(
+            retry_delay=Duration(seconds=RETRY_SECONDS, nanos=RETRY_NANOS)
+        )
+        trailing_metadata = [
+            ("google.rpc.retryinfo-bin", retry_info.SerializeToString())
+        ]
+        aborted = _make_rpc_error(Aborted, trailing_metadata=trailing_metadata)
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.commit.side_effect = [aborted, response]
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        # retry once w/ timeout_secs=1
+        def _time(_results=[1, 1.5]):
+            return _results.pop(0)
+
+        with mock.patch("time.time", _time):
+            with mock.patch("time.sleep") as sleep_mock:
+                with self.assertRaises(Aborted):
+                    session.run_in_transaction(unit_of_work, "abc", timeout_secs=1)
+
+        sleep_mock.assert_not_called()
+
+        self.assertEqual(len(called_with), 1)
+        txn, args, kw = called_with[0]
+        self.assertIsInstance(txn, Transaction)
+        self.assertIsNone(txn.committed)
+        self.assertEqual(args, ("abc",))
+        self.assertEqual(kw, {})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        gax_api.begin_transaction.assert_called_once_with(
+            self.SESSION_NAME,
+            expected_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+        gax_api.commit.assert_called_once_with(
+            self.SESSION_NAME,
+            txn._mutations,
+            transaction_id=TRANSACTION_ID,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_run_in_transaction_w_timeout(self):
+        from google.api_core.exceptions import Aborted
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        TABLE_NAME = "citizens"
+        COLUMNS = ["email", "first_name", "last_name", "age"]
+        VALUES = [
+            ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+            ["bharney@example.com", "Bharney", "Rhubble", 31],
+        ]
+        TRANSACTION_ID = b"FACEDACE"
+        transaction_pb = TransactionPB(id=TRANSACTION_ID)
+        aborted = _make_rpc_error(Aborted, trailing_metadata=[])
+        gax_api = self._make_spanner_api()
+        gax_api.begin_transaction.return_value = transaction_pb
+        gax_api.commit.side_effect = aborted
+        database = self._make_database()
+        database.spanner_api = gax_api
+        session = self._make_one(database)
+        session._session_id = self.SESSION_ID
+
+        called_with = []
+
+        def unit_of_work(txn, *args, **kw):
+            called_with.append((txn, args, kw))
+            txn.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        # retry several times to check backoff
+        def _time(_results=[1, 2, 4, 8]):
+            return _results.pop(0)
+
+        with mock.patch("time.time", _time):
+            with mock.patch("time.sleep") as sleep_mock:
+                with self.assertRaises(Aborted):
+                    session.run_in_transaction(unit_of_work, timeout_secs=8)
+
+        # unpacking call args into list
+        call_args = [call_[0][0] for call_ in sleep_mock.call_args_list]
+        call_args = list(map(int, call_args))
+        assert call_args == [2, 4]
+        assert sleep_mock.call_count == 2
+
+        self.assertEqual(len(called_with), 3)
+        for txn, args, kw in called_with:
+            self.assertIsInstance(txn, Transaction)
+            self.assertIsNone(txn.committed)
+            self.assertEqual(args, ())
+            self.assertEqual(kw, {})
+
+        expected_options = TransactionOptions(read_write=TransactionOptions.ReadWrite())
+        self.assertEqual(
+            gax_api.begin_transaction.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    expected_options,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 3,
+        )
+        self.assertEqual(
+            gax_api.commit.call_args_list,
+            [
+                mock.call(
+                    self.SESSION_NAME,
+                    txn._mutations,
+                    transaction_id=TRANSACTION_ID,
+                    metadata=[("google-cloud-resource-prefix", database.name)],
+                )
+            ]
+            * 3,
+        )
+
+    def test_delay_helper_w_no_delay(self):
+        from google.cloud.spanner_v1.session import _delay_until_retry
+
+        metadata_mock = mock.Mock()
+        metadata_mock.trailing_metadata.return_value = {}
+
+        exc_mock = mock.Mock(errors=[metadata_mock])
+
+        def _time_func():
+            return 3
+
+        # check if current time > deadline
+        with mock.patch("time.time", _time_func):
+            with self.assertRaises(Exception):
+                _delay_until_retry(exc_mock, 2, 1)
+
+        with mock.patch("time.time", _time_func):
+            with mock.patch(
+                "google.cloud.spanner_v1.session._get_retry_delay"
+            ) as get_retry_delay_mock:
+                with mock.patch("time.sleep") as sleep_mock:
+                    get_retry_delay_mock.return_value = None
+
+                    _delay_until_retry(exc_mock, 6, 1)
+                    sleep_mock.assert_not_called()
diff --git a/spanner/tests/unit/test_snapshot.py b/spanner/tests/unit/test_snapshot.py
new file mode 100644
index 000000000000..883ab7325835
--- /dev/null
+++ b/spanner/tests/unit/test_snapshot.py
@@ -0,0 +1,1002 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+import google.api_core.gapic_v1.method
+import mock
+
+
+TABLE_NAME = "citizens"
+COLUMNS = ["email", "first_name", "last_name", "age"]
+SQL_QUERY = """\
+SELECT first_name, last_name, age FROM citizens ORDER BY age"""
+SQL_QUERY_WITH_PARAM = """
+SELECT first_name, last_name, email FROM citizens WHERE age <= @max_age"""
+PARAMS = {"max_age": 30}
+PARAM_TYPES = {"max_age": "INT64"}
+SQL_QUERY_WITH_BYTES_PARAM = """\
+SELECT image_name FROM images WHERE @bytes IN image_data"""
+PARAMS_WITH_BYTES = {"bytes": b"FACEDACE"}
+RESUME_TOKEN = b"DEADBEEF"
+TXN_ID = b"DEAFBEAD"
+SECONDS = 3
+MICROS = 123456
+
+
+class Test_restart_on_unavailable(unittest.TestCase):
+    def _call_fut(self, restart):
+        from google.cloud.spanner_v1.snapshot import _restart_on_unavailable
+
+        return _restart_on_unavailable(restart)
+
+    def _make_item(self, value, resume_token=b""):
+        return mock.Mock(
+            value=value, resume_token=resume_token, spec=["value", "resume_token"]
+        )
+
+    def test_iteration_w_empty_raw(self):
+        raw = _MockIterator()
+        restart = mock.Mock(spec=[], return_value=raw)
+        resumable = self._call_fut(restart)
+        self.assertEqual(list(resumable), [])
+
+    def test_iteration_w_non_empty_raw(self):
+        ITEMS = (self._make_item(0), self._make_item(1))
+        raw = _MockIterator(*ITEMS)
+        restart = mock.Mock(spec=[], return_value=raw)
+        resumable = self._call_fut(restart)
+        self.assertEqual(list(resumable), list(ITEMS))
+        restart.assert_called_once_with()
+
+    def test_iteration_w_raw_w_resume_tken(self):
+        ITEMS = (
+            self._make_item(0),
+            self._make_item(1, resume_token=RESUME_TOKEN),
+            self._make_item(2),
+            self._make_item(3),
+        )
+        raw = _MockIterator(*ITEMS)
+        restart = mock.Mock(spec=[], return_value=raw)
+        resumable = self._call_fut(restart)
+        self.assertEqual(list(resumable), list(ITEMS))
+        restart.assert_called_once_with()
+
+    def test_iteration_w_raw_raising_unavailable_no_token(self):
+        ITEMS = (
+            self._make_item(0),
+            self._make_item(1, resume_token=RESUME_TOKEN),
+            self._make_item(2),
+        )
+        before = _MockIterator(fail_after=True)
+        after = _MockIterator(*ITEMS)
+        restart = mock.Mock(spec=[], side_effect=[before, after])
+        resumable = self._call_fut(restart)
+        self.assertEqual(list(resumable), list(ITEMS))
+        self.assertEqual(restart.mock_calls, [mock.call(), mock.call(resume_token=b"")])
+
+    def test_iteration_w_raw_raising_unavailable(self):
+        FIRST = (self._make_item(0), self._make_item(1, resume_token=RESUME_TOKEN))
+        SECOND = (self._make_item(2),)  # discarded after 503
+        LAST = (self._make_item(3),)
+        before = _MockIterator(*(FIRST + SECOND), fail_after=True)
+        after = _MockIterator(*LAST)
+        restart = mock.Mock(spec=[], side_effect=[before, after])
+        resumable = self._call_fut(restart)
+        self.assertEqual(list(resumable), list(FIRST + LAST))
+        self.assertEqual(
+            restart.mock_calls, [mock.call(), mock.call(resume_token=RESUME_TOKEN)]
+        )
+
+    def test_iteration_w_raw_raising_unavailable_after_token(self):
+        FIRST = (self._make_item(0), self._make_item(1, resume_token=RESUME_TOKEN))
+        SECOND = (self._make_item(2), self._make_item(3))
+        before = _MockIterator(*FIRST, fail_after=True)
+        after = _MockIterator(*SECOND)
+        restart = mock.Mock(spec=[], side_effect=[before, after])
+        resumable = self._call_fut(restart)
+        self.assertEqual(list(resumable), list(FIRST + SECOND))
+        self.assertEqual(
+            restart.mock_calls, [mock.call(), mock.call(resume_token=RESUME_TOKEN)]
+        )
+
+
+class Test_SnapshotBase(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    DATABASE_ID = "database-id"
+    DATABASE_NAME = INSTANCE_NAME + "/databases/" + DATABASE_ID
+    SESSION_ID = "session-id"
+    SESSION_NAME = DATABASE_NAME + "/sessions/" + SESSION_ID
+
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.snapshot import _SnapshotBase
+
+        return _SnapshotBase
+
+    def _make_one(self, session):
+        return self._getTargetClass()(session)
+
+    def _makeDerived(self, session):
+        class _Derived(self._getTargetClass()):
+
+            _transaction_id = None
+            _multi_use = False
+
+            def _make_txn_selector(self):
+                from google.cloud.spanner_v1.proto.transaction_pb2 import (
+                    TransactionOptions,
+                    TransactionSelector,
+                )
+
+                if self._transaction_id:
+                    return TransactionSelector(id=self._transaction_id)
+                options = TransactionOptions(
+                    read_only=TransactionOptions.ReadOnly(strong=True)
+                )
+                if self._multi_use:
+                    return TransactionSelector(begin=options)
+                return TransactionSelector(single_use=options)
+
+        return _Derived(session)
+
+    def _make_spanner_api(self):
+        import google.cloud.spanner_v1.gapic.spanner_client
+
+        return mock.create_autospec(
+            google.cloud.spanner_v1.gapic.spanner_client.SpannerClient, instance=True
+        )
+
+    def test_ctor(self):
+        session = _Session()
+        base = self._make_one(session)
+        self.assertIs(base._session, session)
+        self.assertEqual(base._execute_sql_count, 0)
+
+    def test__make_txn_selector_virtual(self):
+        session = _Session()
+        base = self._make_one(session)
+        with self.assertRaises(NotImplementedError):
+            base._make_txn_selector()
+
+    def test_read_other_error(self):
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        keyset = KeySet(all_=True)
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.streaming_read.side_effect = RuntimeError()
+        session = _Session(database)
+        derived = self._makeDerived(session)
+
+        with self.assertRaises(RuntimeError):
+            list(derived.read(TABLE_NAME, COLUMNS, keyset))
+
+    def _read_helper(self, multi_use, first=True, count=0, partition=None):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1.proto.result_set_pb2 import (
+            PartialResultSet,
+            ResultSetMetadata,
+            ResultSetStats,
+        )
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            TransactionSelector,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import STRING, INT64
+        from google.cloud.spanner_v1.keyset import KeySet
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        VALUES = [[u"bharney", 31], [u"phred", 32]]
+        VALUE_PBS = [[_make_value_pb(item) for item in row] for row in VALUES]
+        struct_type_pb = StructType(
+            fields=[
+                StructType.Field(name="name", type=Type(code=STRING)),
+                StructType.Field(name="age", type=Type(code=INT64)),
+            ]
+        )
+        metadata_pb = ResultSetMetadata(row_type=struct_type_pb)
+        stats_pb = ResultSetStats(
+            query_stats=Struct(fields={"rows_returned": _make_value_pb(2)})
+        )
+        result_sets = [
+            PartialResultSet(values=VALUE_PBS[0], metadata=metadata_pb),
+            PartialResultSet(values=VALUE_PBS[1], stats=stats_pb),
+        ]
+        KEYS = [["bharney@example.com"], ["phred@example.com"]]
+        keyset = KeySet(keys=KEYS)
+        INDEX = "email-address-index"
+        LIMIT = 20
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.streaming_read.return_value = _MockIterator(*result_sets)
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = multi_use
+        derived._read_request_count = count
+        if not first:
+            derived._transaction_id = TXN_ID
+
+        if partition is not None:  # 'limit' and 'partition' incompatible
+            result_set = derived.read(
+                TABLE_NAME, COLUMNS, keyset, index=INDEX, partition=partition
+            )
+        else:
+            result_set = derived.read(
+                TABLE_NAME, COLUMNS, keyset, index=INDEX, limit=LIMIT
+            )
+
+        self.assertEqual(derived._read_request_count, count + 1)
+
+        if multi_use:
+            self.assertIs(result_set._source, derived)
+        else:
+            self.assertIsNone(result_set._source)
+
+        self.assertEqual(list(result_set), VALUES)
+        self.assertEqual(result_set.metadata, metadata_pb)
+        self.assertEqual(result_set.stats, stats_pb)
+
+        txn_options = TransactionOptions(
+            read_only=TransactionOptions.ReadOnly(strong=True)
+        )
+
+        if multi_use:
+            if first:
+                expected_transaction = TransactionSelector(begin=txn_options)
+            else:
+                expected_transaction = TransactionSelector(id=TXN_ID)
+        else:
+            expected_transaction = TransactionSelector(single_use=txn_options)
+
+        if partition is not None:
+            expected_limit = 0
+        else:
+            expected_limit = LIMIT
+
+        api.streaming_read.assert_called_once_with(
+            self.SESSION_NAME,
+            TABLE_NAME,
+            COLUMNS,
+            keyset._to_pb(),
+            transaction=expected_transaction,
+            index=INDEX,
+            limit=expected_limit,
+            partition_token=partition,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_read_wo_multi_use(self):
+        self._read_helper(multi_use=False)
+
+    def test_read_wo_multi_use_w_read_request_count_gt_0(self):
+        with self.assertRaises(ValueError):
+            self._read_helper(multi_use=False, count=1)
+
+    def test_read_w_multi_use_wo_first(self):
+        self._read_helper(multi_use=True, first=False)
+
+    def test_read_w_multi_use_wo_first_w_count_gt_0(self):
+        self._read_helper(multi_use=True, first=False, count=1)
+
+    def test_read_w_multi_use_w_first_w_partition(self):
+        PARTITION = b"FADEABED"
+        self._read_helper(multi_use=True, first=True, partition=PARTITION)
+
+    def test_read_w_multi_use_w_first_w_count_gt_0(self):
+        with self.assertRaises(ValueError):
+            self._read_helper(multi_use=True, first=True, count=1)
+
+    def test_execute_sql_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.execute_streaming_sql.side_effect = RuntimeError()
+        session = _Session(database)
+        derived = self._makeDerived(session)
+
+        with self.assertRaises(RuntimeError):
+            list(derived.execute_sql(SQL_QUERY))
+
+    def test_execute_sql_w_params_wo_param_types(self):
+        database = _Database()
+        session = _Session(database)
+        derived = self._makeDerived(session)
+
+        with self.assertRaises(ValueError):
+            derived.execute_sql(SQL_QUERY_WITH_PARAM, PARAMS)
+
+    def _execute_sql_helper(
+        self,
+        multi_use,
+        first=True,
+        count=0,
+        partition=None,
+        sql_count=0,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+    ):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1.proto.result_set_pb2 import (
+            PartialResultSet,
+            ResultSetMetadata,
+            ResultSetStats,
+        )
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            TransactionSelector,
+            TransactionOptions,
+        )
+        from google.cloud.spanner_v1.proto.type_pb2 import Type, StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import STRING, INT64
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        VALUES = [[u"bharney", u"rhubbyl", 31], [u"phred", u"phlyntstone", 32]]
+        VALUE_PBS = [[_make_value_pb(item) for item in row] for row in VALUES]
+        MODE = 2  # PROFILE
+        struct_type_pb = StructType(
+            fields=[
+                StructType.Field(name="first_name", type=Type(code=STRING)),
+                StructType.Field(name="last_name", type=Type(code=STRING)),
+                StructType.Field(name="age", type=Type(code=INT64)),
+            ]
+        )
+        metadata_pb = ResultSetMetadata(row_type=struct_type_pb)
+        stats_pb = ResultSetStats(
+            query_stats=Struct(fields={"rows_returned": _make_value_pb(2)})
+        )
+        result_sets = [
+            PartialResultSet(values=VALUE_PBS[0], metadata=metadata_pb),
+            PartialResultSet(values=VALUE_PBS[1], stats=stats_pb),
+        ]
+        iterator = _MockIterator(*result_sets)
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.execute_streaming_sql.return_value = iterator
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = multi_use
+        derived._read_request_count = count
+        derived._execute_sql_count = sql_count
+        if not first:
+            derived._transaction_id = TXN_ID
+
+        result_set = derived.execute_sql(
+            SQL_QUERY_WITH_PARAM,
+            PARAMS,
+            PARAM_TYPES,
+            query_mode=MODE,
+            partition=partition,
+            retry=retry,
+            timeout=timeout,
+        )
+
+        self.assertEqual(derived._read_request_count, count + 1)
+
+        if multi_use:
+            self.assertIs(result_set._source, derived)
+        else:
+            self.assertIsNone(result_set._source)
+
+        self.assertEqual(list(result_set), VALUES)
+        self.assertEqual(result_set.metadata, metadata_pb)
+        self.assertEqual(result_set.stats, stats_pb)
+
+        txn_options = TransactionOptions(
+            read_only=TransactionOptions.ReadOnly(strong=True)
+        )
+
+        if multi_use:
+            if first:
+                expected_transaction = TransactionSelector(begin=txn_options)
+            else:
+                expected_transaction = TransactionSelector(id=TXN_ID)
+        else:
+            expected_transaction = TransactionSelector(single_use=txn_options)
+
+        expected_params = Struct(
+            fields={key: _make_value_pb(value) for (key, value) in PARAMS.items()}
+        )
+
+        api.execute_streaming_sql.assert_called_once_with(
+            self.SESSION_NAME,
+            SQL_QUERY_WITH_PARAM,
+            transaction=expected_transaction,
+            params=expected_params,
+            param_types=PARAM_TYPES,
+            query_mode=MODE,
+            partition_token=partition,
+            seqno=sql_count,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+            timeout=timeout,
+            retry=retry,
+        )
+
+        self.assertEqual(derived._execute_sql_count, sql_count + 1)
+
+    def test_execute_sql_wo_multi_use(self):
+        self._execute_sql_helper(multi_use=False)
+
+    def test_execute_sql_wo_multi_use_w_read_request_count_gt_0(self):
+        with self.assertRaises(ValueError):
+            self._execute_sql_helper(multi_use=False, count=1)
+
+    def test_execute_sql_w_multi_use_wo_first(self):
+        self._execute_sql_helper(multi_use=True, first=False, sql_count=1)
+
+    def test_execute_sql_w_multi_use_wo_first_w_count_gt_0(self):
+        self._execute_sql_helper(multi_use=True, first=False, count=1)
+
+    def test_execute_sql_w_multi_use_w_first(self):
+        self._execute_sql_helper(multi_use=True, first=True)
+
+    def test_execute_sql_w_multi_use_w_first_w_count_gt_0(self):
+        with self.assertRaises(ValueError):
+            self._execute_sql_helper(multi_use=True, first=True, count=1)
+
+    def test_execute_sql_w_retry(self):
+        self._execute_sql_helper(multi_use=False, retry=None)
+
+    def test_execute_sql_w_timeout(self):
+        self._execute_sql_helper(multi_use=False, timeout=None)
+
+    def _partition_read_helper(
+        self, multi_use, w_txn, size=None, max_partitions=None, index=None
+    ):
+        from google.cloud.spanner_v1.keyset import KeySet
+        from google.cloud.spanner_v1.types import Partition
+        from google.cloud.spanner_v1.types import PartitionOptions
+        from google.cloud.spanner_v1.types import PartitionResponse
+        from google.cloud.spanner_v1.types import Transaction
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionSelector
+
+        keyset = KeySet(all_=True)
+        new_txn_id = b"ABECAB91"
+        token_1 = b"FACE0FFF"
+        token_2 = b"BADE8CAF"
+        response = PartitionResponse(
+            partitions=[
+                Partition(partition_token=token_1),
+                Partition(partition_token=token_2),
+            ],
+            transaction=Transaction(id=new_txn_id),
+        )
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.partition_read.return_value = response
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = multi_use
+        if w_txn:
+            derived._transaction_id = TXN_ID
+
+        tokens = list(
+            derived.partition_read(
+                TABLE_NAME,
+                COLUMNS,
+                keyset,
+                index=index,
+                partition_size_bytes=size,
+                max_partitions=max_partitions,
+            )
+        )
+
+        self.assertEqual(tokens, [token_1, token_2])
+
+        expected_txn_selector = TransactionSelector(id=TXN_ID)
+
+        expected_partition_options = PartitionOptions(
+            partition_size_bytes=size, max_partitions=max_partitions
+        )
+
+        api.partition_read.assert_called_once_with(
+            session=self.SESSION_NAME,
+            table=TABLE_NAME,
+            columns=COLUMNS,
+            key_set=keyset._to_pb(),
+            transaction=expected_txn_selector,
+            index=index,
+            partition_options=expected_partition_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_partition_read_single_use_raises(self):
+        with self.assertRaises(ValueError):
+            self._partition_read_helper(multi_use=False, w_txn=True)
+
+    def test_partition_read_wo_existing_transaction_raises(self):
+        with self.assertRaises(ValueError):
+            self._partition_read_helper(multi_use=True, w_txn=False)
+
+    def test_partition_read_other_error(self):
+        from google.cloud.spanner_v1.keyset import KeySet
+
+        keyset = KeySet(all_=True)
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.partition_read.side_effect = RuntimeError()
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = True
+        derived._transaction_id = TXN_ID
+
+        with self.assertRaises(RuntimeError):
+            list(derived.partition_read(TABLE_NAME, COLUMNS, keyset))
+
+    def test_partition_read_ok_w_index_no_options(self):
+        self._partition_read_helper(multi_use=True, w_txn=True, index="index")
+
+    def test_partition_read_ok_w_size(self):
+        self._partition_read_helper(multi_use=True, w_txn=True, size=2000)
+
+    def test_partition_read_ok_w_max_partitions(self):
+        self._partition_read_helper(multi_use=True, w_txn=True, max_partitions=4)
+
+    def _partition_query_helper(self, multi_use, w_txn, size=None, max_partitions=None):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1.types import Partition
+        from google.cloud.spanner_v1.types import PartitionOptions
+        from google.cloud.spanner_v1.types import PartitionResponse
+        from google.cloud.spanner_v1.types import Transaction
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionSelector
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        new_txn_id = b"ABECAB91"
+        token_1 = b"FACE0FFF"
+        token_2 = b"BADE8CAF"
+        response = PartitionResponse(
+            partitions=[
+                Partition(partition_token=token_1),
+                Partition(partition_token=token_2),
+            ],
+            transaction=Transaction(id=new_txn_id),
+        )
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.partition_query.return_value = response
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = multi_use
+        if w_txn:
+            derived._transaction_id = TXN_ID
+
+        tokens = list(
+            derived.partition_query(
+                SQL_QUERY_WITH_PARAM,
+                PARAMS,
+                PARAM_TYPES,
+                partition_size_bytes=size,
+                max_partitions=max_partitions,
+            )
+        )
+
+        self.assertEqual(tokens, [token_1, token_2])
+
+        expected_params = Struct(
+            fields={key: _make_value_pb(value) for (key, value) in PARAMS.items()}
+        )
+
+        expected_txn_selector = TransactionSelector(id=TXN_ID)
+
+        expected_partition_options = PartitionOptions(
+            partition_size_bytes=size, max_partitions=max_partitions
+        )
+
+        api.partition_query.assert_called_once_with(
+            session=self.SESSION_NAME,
+            sql=SQL_QUERY_WITH_PARAM,
+            transaction=expected_txn_selector,
+            params=expected_params,
+            param_types=PARAM_TYPES,
+            partition_options=expected_partition_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_partition_query_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.partition_query.side_effect = RuntimeError()
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = True
+        derived._transaction_id = TXN_ID
+
+        with self.assertRaises(RuntimeError):
+            list(derived.partition_query(SQL_QUERY))
+
+    def test_partition_query_w_params_wo_param_types(self):
+        database = _Database()
+        session = _Session(database)
+        derived = self._makeDerived(session)
+        derived._multi_use = True
+        derived._transaction_id = TXN_ID
+
+        with self.assertRaises(ValueError):
+            list(derived.partition_query(SQL_QUERY_WITH_PARAM, PARAMS))
+
+    def test_partition_query_single_use_raises(self):
+        with self.assertRaises(ValueError):
+            self._partition_query_helper(multi_use=False, w_txn=True)
+
+    def test_partition_query_wo_transaction_raises(self):
+        with self.assertRaises(ValueError):
+            self._partition_query_helper(multi_use=True, w_txn=False)
+
+    def test_partition_query_ok_w_index_no_options(self):
+        self._partition_query_helper(multi_use=True, w_txn=True)
+
+    def test_partition_query_ok_w_size(self):
+        self._partition_query_helper(multi_use=True, w_txn=True, size=2000)
+
+    def test_partition_query_ok_w_max_partitions(self):
+        self._partition_query_helper(multi_use=True, w_txn=True, max_partitions=4)
+
+
+class TestSnapshot(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    DATABASE_ID = "database-id"
+    DATABASE_NAME = INSTANCE_NAME + "/databases/" + DATABASE_ID
+    SESSION_ID = "session-id"
+    SESSION_NAME = DATABASE_NAME + "/sessions/" + SESSION_ID
+
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.snapshot import Snapshot
+
+        return Snapshot
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def _make_spanner_api(self):
+        import google.cloud.spanner_v1.gapic.spanner_client
+
+        return mock.create_autospec(
+            google.cloud.spanner_v1.gapic.spanner_client.SpannerClient, instance=True
+        )
+
+    def _makeTimestamp(self):
+        import datetime
+        from google.cloud._helpers import UTC
+
+        return datetime.datetime.utcnow().replace(tzinfo=UTC)
+
+    def _makeDuration(self, seconds=1, microseconds=0):
+        import datetime
+
+        return datetime.timedelta(seconds=seconds, microseconds=microseconds)
+
+    def test_ctor_defaults(self):
+        session = _Session()
+        snapshot = self._make_one(session)
+        self.assertIs(snapshot._session, session)
+        self.assertTrue(snapshot._strong)
+        self.assertIsNone(snapshot._read_timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertIsNone(snapshot._exact_staleness)
+        self.assertFalse(snapshot._multi_use)
+
+    def test_ctor_w_multiple_options(self):
+        timestamp = self._makeTimestamp()
+        duration = self._makeDuration()
+        session = _Session()
+
+        with self.assertRaises(ValueError):
+            self._make_one(session, read_timestamp=timestamp, max_staleness=duration)
+
+    def test_ctor_w_read_timestamp(self):
+        timestamp = self._makeTimestamp()
+        session = _Session()
+        snapshot = self._make_one(session, read_timestamp=timestamp)
+        self.assertIs(snapshot._session, session)
+        self.assertFalse(snapshot._strong)
+        self.assertEqual(snapshot._read_timestamp, timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertIsNone(snapshot._exact_staleness)
+        self.assertFalse(snapshot._multi_use)
+
+    def test_ctor_w_min_read_timestamp(self):
+        timestamp = self._makeTimestamp()
+        session = _Session()
+        snapshot = self._make_one(session, min_read_timestamp=timestamp)
+        self.assertIs(snapshot._session, session)
+        self.assertFalse(snapshot._strong)
+        self.assertIsNone(snapshot._read_timestamp)
+        self.assertEqual(snapshot._min_read_timestamp, timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertIsNone(snapshot._exact_staleness)
+        self.assertFalse(snapshot._multi_use)
+
+    def test_ctor_w_max_staleness(self):
+        duration = self._makeDuration()
+        session = _Session()
+        snapshot = self._make_one(session, max_staleness=duration)
+        self.assertIs(snapshot._session, session)
+        self.assertFalse(snapshot._strong)
+        self.assertIsNone(snapshot._read_timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertEqual(snapshot._max_staleness, duration)
+        self.assertIsNone(snapshot._exact_staleness)
+        self.assertFalse(snapshot._multi_use)
+
+    def test_ctor_w_exact_staleness(self):
+        duration = self._makeDuration()
+        session = _Session()
+        snapshot = self._make_one(session, exact_staleness=duration)
+        self.assertIs(snapshot._session, session)
+        self.assertFalse(snapshot._strong)
+        self.assertIsNone(snapshot._read_timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertEqual(snapshot._exact_staleness, duration)
+        self.assertFalse(snapshot._multi_use)
+
+    def test_ctor_w_multi_use(self):
+        session = _Session()
+        snapshot = self._make_one(session, multi_use=True)
+        self.assertTrue(snapshot._session is session)
+        self.assertTrue(snapshot._strong)
+        self.assertIsNone(snapshot._read_timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertIsNone(snapshot._exact_staleness)
+        self.assertTrue(snapshot._multi_use)
+
+    def test_ctor_w_multi_use_and_read_timestamp(self):
+        timestamp = self._makeTimestamp()
+        session = _Session()
+        snapshot = self._make_one(session, read_timestamp=timestamp, multi_use=True)
+        self.assertTrue(snapshot._session is session)
+        self.assertFalse(snapshot._strong)
+        self.assertEqual(snapshot._read_timestamp, timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertIsNone(snapshot._exact_staleness)
+        self.assertTrue(snapshot._multi_use)
+
+    def test_ctor_w_multi_use_and_min_read_timestamp(self):
+        timestamp = self._makeTimestamp()
+        session = _Session()
+
+        with self.assertRaises(ValueError):
+            self._make_one(session, min_read_timestamp=timestamp, multi_use=True)
+
+    def test_ctor_w_multi_use_and_max_staleness(self):
+        duration = self._makeDuration()
+        session = _Session()
+
+        with self.assertRaises(ValueError):
+            self._make_one(session, max_staleness=duration, multi_use=True)
+
+    def test_ctor_w_multi_use_and_exact_staleness(self):
+        duration = self._makeDuration()
+        session = _Session()
+        snapshot = self._make_one(session, exact_staleness=duration, multi_use=True)
+        self.assertTrue(snapshot._session is session)
+        self.assertFalse(snapshot._strong)
+        self.assertIsNone(snapshot._read_timestamp)
+        self.assertIsNone(snapshot._min_read_timestamp)
+        self.assertIsNone(snapshot._max_staleness)
+        self.assertEqual(snapshot._exact_staleness, duration)
+        self.assertTrue(snapshot._multi_use)
+
+    def test__make_txn_selector_w_transaction_id(self):
+        session = _Session()
+        snapshot = self._make_one(session)
+        snapshot._transaction_id = TXN_ID
+        selector = snapshot._make_txn_selector()
+        self.assertEqual(selector.id, TXN_ID)
+
+    def test__make_txn_selector_strong(self):
+        session = _Session()
+        snapshot = self._make_one(session)
+        selector = snapshot._make_txn_selector()
+        options = selector.single_use
+        self.assertTrue(options.read_only.strong)
+
+    def test__make_txn_selector_w_read_timestamp(self):
+        from google.cloud._helpers import _pb_timestamp_to_datetime
+
+        timestamp = self._makeTimestamp()
+        session = _Session()
+        snapshot = self._make_one(session, read_timestamp=timestamp)
+        selector = snapshot._make_txn_selector()
+        options = selector.single_use
+        self.assertEqual(
+            _pb_timestamp_to_datetime(options.read_only.read_timestamp), timestamp
+        )
+
+    def test__make_txn_selector_w_min_read_timestamp(self):
+        from google.cloud._helpers import _pb_timestamp_to_datetime
+
+        timestamp = self._makeTimestamp()
+        session = _Session()
+        snapshot = self._make_one(session, min_read_timestamp=timestamp)
+        selector = snapshot._make_txn_selector()
+        options = selector.single_use
+        self.assertEqual(
+            _pb_timestamp_to_datetime(options.read_only.min_read_timestamp), timestamp
+        )
+
+    def test__make_txn_selector_w_max_staleness(self):
+        duration = self._makeDuration(seconds=3, microseconds=123456)
+        session = _Session()
+        snapshot = self._make_one(session, max_staleness=duration)
+        selector = snapshot._make_txn_selector()
+        options = selector.single_use
+        self.assertEqual(options.read_only.max_staleness.seconds, 3)
+        self.assertEqual(options.read_only.max_staleness.nanos, 123456000)
+
+    def test__make_txn_selector_w_exact_staleness(self):
+        duration = self._makeDuration(seconds=3, microseconds=123456)
+        session = _Session()
+        snapshot = self._make_one(session, exact_staleness=duration)
+        selector = snapshot._make_txn_selector()
+        options = selector.single_use
+        self.assertEqual(options.read_only.exact_staleness.seconds, 3)
+        self.assertEqual(options.read_only.exact_staleness.nanos, 123456000)
+
+    def test__make_txn_selector_strong_w_multi_use(self):
+        session = _Session()
+        snapshot = self._make_one(session, multi_use=True)
+        selector = snapshot._make_txn_selector()
+        options = selector.begin
+        self.assertTrue(options.read_only.strong)
+
+    def test__make_txn_selector_w_read_timestamp_w_multi_use(self):
+        from google.cloud._helpers import _pb_timestamp_to_datetime
+
+        timestamp = self._makeTimestamp()
+        session = _Session()
+        snapshot = self._make_one(session, read_timestamp=timestamp, multi_use=True)
+        selector = snapshot._make_txn_selector()
+        options = selector.begin
+        self.assertEqual(
+            _pb_timestamp_to_datetime(options.read_only.read_timestamp), timestamp
+        )
+
+    def test__make_txn_selector_w_exact_staleness_w_multi_use(self):
+        duration = self._makeDuration(seconds=3, microseconds=123456)
+        session = _Session()
+        snapshot = self._make_one(session, exact_staleness=duration, multi_use=True)
+        selector = snapshot._make_txn_selector()
+        options = selector.begin
+        self.assertEqual(options.read_only.exact_staleness.seconds, 3)
+        self.assertEqual(options.read_only.exact_staleness.nanos, 123456000)
+
+    def test_begin_wo_multi_use(self):
+        session = _Session()
+        snapshot = self._make_one(session)
+        with self.assertRaises(ValueError):
+            snapshot.begin()
+
+    def test_begin_w_read_request_count_gt_0(self):
+        session = _Session()
+        snapshot = self._make_one(session, multi_use=True)
+        snapshot._read_request_count = 1
+        with self.assertRaises(ValueError):
+            snapshot.begin()
+
+    def test_begin_w_existing_txn_id(self):
+        session = _Session()
+        snapshot = self._make_one(session, multi_use=True)
+        snapshot._transaction_id = TXN_ID
+        with self.assertRaises(ValueError):
+            snapshot.begin()
+
+    def test_begin_w_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.begin_transaction.side_effect = RuntimeError()
+        timestamp = self._makeTimestamp()
+        session = _Session(database)
+        snapshot = self._make_one(session, read_timestamp=timestamp, multi_use=True)
+
+        with self.assertRaises(RuntimeError):
+            snapshot.begin()
+
+    def test_begin_ok_exact_staleness(self):
+        from google.protobuf.duration_pb2 import Duration
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+
+        transaction_pb = TransactionPB(id=TXN_ID)
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.begin_transaction.return_value = transaction_pb
+        duration = self._makeDuration(seconds=SECONDS, microseconds=MICROS)
+        session = _Session(database)
+        snapshot = self._make_one(session, exact_staleness=duration, multi_use=True)
+
+        txn_id = snapshot.begin()
+
+        self.assertEqual(txn_id, TXN_ID)
+        self.assertEqual(snapshot._transaction_id, TXN_ID)
+
+        expected_duration = Duration(seconds=SECONDS, nanos=MICROS * 1000)
+        expected_txn_options = TransactionOptions(
+            read_only=TransactionOptions.ReadOnly(exact_staleness=expected_duration)
+        )
+
+        api.begin_transaction.assert_called_once_with(
+            session.name,
+            expected_txn_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+    def test_begin_ok_exact_strong(self):
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+            TransactionOptions,
+        )
+
+        transaction_pb = TransactionPB(id=TXN_ID)
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.begin_transaction.return_value = transaction_pb
+        session = _Session(database)
+        snapshot = self._make_one(session, multi_use=True)
+
+        txn_id = snapshot.begin()
+
+        self.assertEqual(txn_id, TXN_ID)
+        self.assertEqual(snapshot._transaction_id, TXN_ID)
+
+        expected_txn_options = TransactionOptions(
+            read_only=TransactionOptions.ReadOnly(strong=True)
+        )
+
+        api.begin_transaction.assert_called_once_with(
+            session.name,
+            expected_txn_options,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+
+class _Session(object):
+    def __init__(self, database=None, name=TestSnapshot.SESSION_NAME):
+        self._database = database
+        self.name = name
+
+
+class _Database(object):
+    name = "testing"
+
+
+class _MockIterator(object):
+    def __init__(self, *values, **kw):
+        self._iter_values = iter(values)
+        self._fail_after = kw.pop("fail_after", False)
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        from google.api_core.exceptions import ServiceUnavailable
+
+        try:
+            return next(self._iter_values)
+        except StopIteration:
+            if self._fail_after:
+                raise ServiceUnavailable("testing")
+            raise
+
+    next = __next__
diff --git a/spanner/tests/unit/test_streamed.py b/spanner/tests/unit/test_streamed.py
new file mode 100644
index 000000000000..64b76b6cb1e2
--- /dev/null
+++ b/spanner/tests/unit/test_streamed.py
@@ -0,0 +1,1017 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+
+import mock
+
+
+class TestStreamedResultSet(unittest.TestCase):
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.streamed import StreamedResultSet
+
+        return StreamedResultSet
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def test_ctor_defaults(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        self.assertIs(streamed._response_iterator, iterator)
+        self.assertIsNone(streamed._source)
+        self.assertEqual(list(streamed), [])
+        self.assertIsNone(streamed.metadata)
+        self.assertIsNone(streamed.stats)
+
+    def test_ctor_w_source(self):
+        iterator = _MockCancellableIterator()
+        source = object()
+        streamed = self._make_one(iterator, source=source)
+        self.assertIs(streamed._response_iterator, iterator)
+        self.assertIs(streamed._source, source)
+        self.assertEqual(list(streamed), [])
+        self.assertIsNone(streamed.metadata)
+        self.assertIsNone(streamed.stats)
+
+    def test_fields_unset(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        with self.assertRaises(AttributeError):
+            streamed.fields
+
+    @staticmethod
+    def _make_scalar_field(name, type_):
+        from google.cloud.spanner_v1.proto.type_pb2 import StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        return StructType.Field(name=name, type=Type(code=type_))
+
+    @staticmethod
+    def _make_array_field(name, element_type_code=None, element_type=None):
+        from google.cloud.spanner_v1.proto.type_pb2 import StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        if element_type is None:
+            element_type = Type(code=element_type_code)
+        array_type = Type(code="ARRAY", array_element_type=element_type)
+        return StructType.Field(name=name, type=array_type)
+
+    @staticmethod
+    def _make_struct_type(struct_type_fields):
+        from google.cloud.spanner_v1.proto.type_pb2 import StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        fields = [
+            StructType.Field(name=key, type=Type(code=value))
+            for key, value in struct_type_fields
+        ]
+        struct_type = StructType(fields=fields)
+        return Type(code="STRUCT", struct_type=struct_type)
+
+    @staticmethod
+    def _make_value(value):
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        return _make_value_pb(value)
+
+    @staticmethod
+    def _make_list_value(values=(), value_pbs=None):
+        from google.protobuf.struct_pb2 import ListValue
+        from google.protobuf.struct_pb2 import Value
+        from google.cloud.spanner_v1._helpers import _make_list_value_pb
+
+        if value_pbs is not None:
+            return Value(list_value=ListValue(values=value_pbs))
+        return Value(list_value=_make_list_value_pb(values))
+
+    @staticmethod
+    def _make_result_set_metadata(fields=(), transaction_id=None):
+        from google.cloud.spanner_v1.proto.result_set_pb2 import ResultSetMetadata
+
+        metadata = ResultSetMetadata()
+        for field in fields:
+            metadata.row_type.fields.add().CopyFrom(field)
+        if transaction_id is not None:
+            metadata.transaction.id = transaction_id
+        return metadata
+
+    @staticmethod
+    def _make_result_set_stats(query_plan=None, **kw):
+        from google.cloud.spanner_v1.proto.result_set_pb2 import ResultSetStats
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        query_stats = Struct(
+            fields={key: _make_value_pb(value) for key, value in kw.items()}
+        )
+        return ResultSetStats(query_plan=query_plan, query_stats=query_stats)
+
+    @staticmethod
+    def _make_partial_result_set(
+        values, metadata=None, stats=None, chunked_value=False
+    ):
+        from google.cloud.spanner_v1.proto.result_set_pb2 import PartialResultSet
+
+        return PartialResultSet(
+            values=values, metadata=metadata, stats=stats, chunked_value=chunked_value
+        )
+
+    def test_properties_set(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+        ]
+        metadata = streamed._metadata = self._make_result_set_metadata(FIELDS)
+        stats = streamed._stats = self._make_result_set_stats()
+        self.assertEqual(list(streamed.fields), FIELDS)
+        self.assertIs(streamed.metadata, metadata)
+        self.assertIs(streamed.stats, stats)
+
+    def test__merge_chunk_bool(self):
+        from google.cloud.spanner_v1.streamed import Unmergeable
+
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("registered_voter", "BOOL")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(True)
+        chunk = self._make_value(False)
+
+        with self.assertRaises(Unmergeable):
+            streamed._merge_chunk(chunk)
+
+    def test__merge_chunk_int64(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("age", "INT64")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(42)
+        chunk = self._make_value(13)
+
+        merged = streamed._merge_chunk(chunk)
+        self.assertEqual(merged.string_value, "4213")
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_float64_nan_string(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("weight", "FLOAT64")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(u"Na")
+        chunk = self._make_value(u"N")
+
+        merged = streamed._merge_chunk(chunk)
+        self.assertEqual(merged.string_value, u"NaN")
+
+    def test__merge_chunk_float64_w_empty(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("weight", "FLOAT64")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(3.14159)
+        chunk = self._make_value("")
+
+        merged = streamed._merge_chunk(chunk)
+        self.assertEqual(merged.number_value, 3.14159)
+
+    def test__merge_chunk_float64_w_float64(self):
+        from google.cloud.spanner_v1.streamed import Unmergeable
+
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("weight", "FLOAT64")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(3.14159)
+        chunk = self._make_value(2.71828)
+
+        with self.assertRaises(Unmergeable):
+            streamed._merge_chunk(chunk)
+
+    def test__merge_chunk_string(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("name", "STRING")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(u"phred")
+        chunk = self._make_value(u"wylma")
+
+        merged = streamed._merge_chunk(chunk)
+
+        self.assertEqual(merged.string_value, u"phredwylma")
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_string_w_bytes(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_scalar_field("image", "BYTES")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(
+            u"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAAAAAA"
+            u"6fptVAAAACXBIWXMAAAsTAAALEwEAmpwYAAAA\n"
+        )
+        chunk = self._make_value(
+            u"B3RJTUUH4QQGFwsBTL3HMwAAABJpVFh0Q29tbWVudAAAAAAAU0FNUExF"
+            u"MG3E+AAAAApJREFUCNdj\nYAAAAAIAAeIhvDMAAAAASUVORK5CYII=\n"
+        )
+
+        merged = streamed._merge_chunk(chunk)
+
+        self.assertEqual(
+            merged.string_value,
+            u"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAAAAAA6fptVAAAACXBIWXMAAAsTAAAL"
+            u"EwEAmpwYAAAA\nB3RJTUUH4QQGFwsBTL3HMwAAABJpVFh0Q29tbWVudAAAAAAAU0"
+            u"FNUExFMG3E+AAAAApJREFUCNdj\nYAAAAAIAAeIhvDMAAAAASUVORK5CYII=\n",
+        )
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_bool(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_array_field("name", element_type_code="BOOL")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value([True, True])
+        chunk = self._make_list_value([False, False, False])
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value([True, True, False, False, False])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_int(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_array_field("name", element_type_code="INT64")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value([0, 1, 2])
+        chunk = self._make_list_value([3, 4, 5])
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value([0, 1, 23, 4, 5])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_float(self):
+        import math
+
+        PI = math.pi
+        EULER = math.e
+        SQRT_2 = math.sqrt(2.0)
+        LOG_10 = math.log(10)
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_array_field("name", element_type_code="FLOAT64")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value([PI, SQRT_2])
+        chunk = self._make_list_value(["", EULER, LOG_10])
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value([PI, SQRT_2, EULER, LOG_10])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_string_with_empty(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_array_field("name", element_type_code="STRING")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value([u"A", u"B", u"C"])
+        chunk = self._make_list_value([])
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value([u"A", u"B", u"C"])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_string(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_array_field("name", element_type_code="STRING")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value([u"A", u"B", u"C"])
+        chunk = self._make_list_value([None, u"D", u"E"])
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value([u"A", u"B", u"C", None, u"D", u"E"])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_string_with_null(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [self._make_array_field("name", element_type_code="STRING")]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value([u"A", u"B", u"C"])
+        chunk = self._make_list_value([u"D", u"E"])
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value([u"A", u"B", u"CD", u"E"])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_array_of_int(self):
+        from google.cloud.spanner_v1.proto.type_pb2 import StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        subarray_type = Type(code="ARRAY", array_element_type=Type(code="INT64"))
+        array_type = Type(code="ARRAY", array_element_type=subarray_type)
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [StructType.Field(name="loloi", type=array_type)]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value(
+            value_pbs=[self._make_list_value([0, 1]), self._make_list_value([2])]
+        )
+        chunk = self._make_list_value(
+            value_pbs=[self._make_list_value([3]), self._make_list_value([4, 5])]
+        )
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value(
+            value_pbs=[
+                self._make_list_value([0, 1]),
+                self._make_list_value([23]),
+                self._make_list_value([4, 5]),
+            ]
+        )
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_array_of_string(self):
+        from google.cloud.spanner_v1.proto.type_pb2 import StructType
+        from google.cloud.spanner_v1.proto.type_pb2 import Type
+
+        subarray_type = Type(code="ARRAY", array_element_type=Type(code="STRING"))
+        array_type = Type(code="ARRAY", array_element_type=subarray_type)
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [StructType.Field(name="lolos", type=array_type)]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_list_value(
+            value_pbs=[
+                self._make_list_value([u"A", u"B"]),
+                self._make_list_value([u"C"]),
+            ]
+        )
+        chunk = self._make_list_value(
+            value_pbs=[
+                self._make_list_value([u"D"]),
+                self._make_list_value([u"E", u"F"]),
+            ]
+        )
+
+        merged = streamed._merge_chunk(chunk)
+
+        expected = self._make_list_value(
+            value_pbs=[
+                self._make_list_value([u"A", u"B"]),
+                self._make_list_value([u"CD"]),
+                self._make_list_value([u"E", u"F"]),
+            ]
+        )
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_struct(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        struct_type = self._make_struct_type([("name", "STRING"), ("age", "INT64")])
+        FIELDS = [self._make_array_field("test", element_type=struct_type)]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        partial = self._make_list_value([u"Phred "])
+        streamed._pending_chunk = self._make_list_value(value_pbs=[partial])
+        rest = self._make_list_value([u"Phlyntstone", 31])
+        chunk = self._make_list_value(value_pbs=[rest])
+
+        merged = streamed._merge_chunk(chunk)
+
+        struct = self._make_list_value([u"Phred Phlyntstone", 31])
+        expected = self._make_list_value(value_pbs=[struct])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test__merge_chunk_array_of_struct_unmergeable(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        struct_type = self._make_struct_type(
+            [("name", "STRING"), ("registered", "BOOL"), ("voted", "BOOL")]
+        )
+        FIELDS = [self._make_array_field("test", element_type=struct_type)]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        partial = self._make_list_value([u"Phred Phlyntstone", True])
+        streamed._pending_chunk = self._make_list_value(value_pbs=[partial])
+        rest = self._make_list_value([True])
+        chunk = self._make_list_value(value_pbs=[rest])
+
+        merged = streamed._merge_chunk(chunk)
+
+        struct = self._make_list_value([u"Phred Phlyntstone", True, True])
+        expected = self._make_list_value(value_pbs=[struct])
+        self.assertEqual(merged, expected)
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test_merge_values_empty_and_empty(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._current_row = []
+        streamed._merge_values([])
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, [])
+
+    def test_merge_values_empty_and_partial(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BARE = [u"Phred Phlyntstone", 42]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        streamed._current_row = []
+        streamed._merge_values(VALUES)
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, BARE)
+
+    def test_merge_values_empty_and_filled(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BARE = [u"Phred Phlyntstone", 42, True]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        streamed._current_row = []
+        streamed._merge_values(VALUES)
+        self.assertEqual(list(streamed), [BARE])
+        self.assertEqual(streamed._current_row, [])
+
+    def test_merge_values_empty_and_filled_plus(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BARE = [
+            u"Phred Phlyntstone",
+            42,
+            True,
+            u"Bharney Rhubble",
+            39,
+            True,
+            u"Wylma Phlyntstone",
+        ]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        streamed._current_row = []
+        streamed._merge_values(VALUES)
+        self.assertEqual(list(streamed), [BARE[0:3], BARE[3:6]])
+        self.assertEqual(streamed._current_row, BARE[6:])
+
+    def test_merge_values_partial_and_empty(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BEFORE = [u"Phred Phlyntstone"]
+        streamed._current_row[:] = BEFORE
+        streamed._merge_values([])
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, BEFORE)
+
+    def test_merge_values_partial_and_partial(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BEFORE = [u"Phred Phlyntstone"]
+        streamed._current_row[:] = BEFORE
+        MERGED = [42]
+        TO_MERGE = [self._make_value(item) for item in MERGED]
+        streamed._merge_values(TO_MERGE)
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, BEFORE + MERGED)
+
+    def test_merge_values_partial_and_filled(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BEFORE = [u"Phred Phlyntstone"]
+        streamed._current_row[:] = BEFORE
+        MERGED = [42, True]
+        TO_MERGE = [self._make_value(item) for item in MERGED]
+        streamed._merge_values(TO_MERGE)
+        self.assertEqual(list(streamed), [BEFORE + MERGED])
+        self.assertEqual(streamed._current_row, [])
+
+    def test_merge_values_partial_and_filled_plus(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        BEFORE = [self._make_value(u"Phred Phlyntstone")]
+        streamed._current_row[:] = BEFORE
+        MERGED = [42, True, u"Bharney Rhubble", 39, True, u"Wylma Phlyntstone"]
+        TO_MERGE = [self._make_value(item) for item in MERGED]
+        VALUES = BEFORE + MERGED
+        streamed._merge_values(TO_MERGE)
+        self.assertEqual(list(streamed), [VALUES[0:3], VALUES[3:6]])
+        self.assertEqual(streamed._current_row, VALUES[6:])
+
+    def test_one_or_none_no_value(self):
+        streamed = self._make_one(_MockCancellableIterator())
+        with mock.patch.object(streamed, "_consume_next") as consume_next:
+            consume_next.side_effect = StopIteration
+            self.assertIsNone(streamed.one_or_none())
+
+    def test_one_or_none_single_value(self):
+        streamed = self._make_one(_MockCancellableIterator())
+        streamed._rows = ["foo"]
+        with mock.patch.object(streamed, "_consume_next") as consume_next:
+            consume_next.side_effect = StopIteration
+            self.assertEqual(streamed.one_or_none(), "foo")
+
+    def test_one_or_none_multiple_values(self):
+        streamed = self._make_one(_MockCancellableIterator())
+        streamed._rows = ["foo", "bar"]
+        with self.assertRaises(ValueError):
+            streamed.one_or_none()
+
+    def test_one_or_none_consumed_stream(self):
+        streamed = self._make_one(_MockCancellableIterator())
+        streamed._metadata = object()
+        with self.assertRaises(RuntimeError):
+            streamed.one_or_none()
+
+    def test_one_single_value(self):
+        streamed = self._make_one(_MockCancellableIterator())
+        streamed._rows = ["foo"]
+        with mock.patch.object(streamed, "_consume_next") as consume_next:
+            consume_next.side_effect = StopIteration
+            self.assertEqual(streamed.one(), "foo")
+
+    def test_one_no_value(self):
+        from google.cloud import exceptions
+
+        iterator = _MockCancellableIterator(["foo"])
+        streamed = self._make_one(iterator)
+        with mock.patch.object(streamed, "_consume_next") as consume_next:
+            consume_next.side_effect = StopIteration
+            with self.assertRaises(exceptions.NotFound):
+                streamed.one()
+
+    def test_consume_next_empty(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        with self.assertRaises(StopIteration):
+            streamed._consume_next()
+
+    def test_consume_next_first_set_partial(self):
+        TXN_ID = b"DEADBEEF"
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        metadata = self._make_result_set_metadata(FIELDS, transaction_id=TXN_ID)
+        BARE = [u"Phred Phlyntstone", 42]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set = self._make_partial_result_set(VALUES, metadata=metadata)
+        iterator = _MockCancellableIterator(result_set)
+        source = mock.Mock(_transaction_id=None, spec=["_transaction_id"])
+        streamed = self._make_one(iterator, source=source)
+        streamed._consume_next()
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, BARE)
+        self.assertEqual(streamed.metadata, metadata)
+        self.assertEqual(source._transaction_id, TXN_ID)
+
+    def test_consume_next_first_set_partial_existing_txn_id(self):
+        TXN_ID = b"DEADBEEF"
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        metadata = self._make_result_set_metadata(FIELDS, transaction_id=b"")
+        BARE = [u"Phred Phlyntstone", 42]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set = self._make_partial_result_set(VALUES, metadata=metadata)
+        iterator = _MockCancellableIterator(result_set)
+        source = mock.Mock(_transaction_id=TXN_ID, spec=["_transaction_id"])
+        streamed = self._make_one(iterator, source=source)
+        streamed._consume_next()
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, BARE)
+        self.assertEqual(streamed.metadata, metadata)
+        self.assertEqual(source._transaction_id, TXN_ID)
+
+    def test_consume_next_w_partial_result(self):
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        VALUES = [self._make_value(u"Phred ")]
+        result_set = self._make_partial_result_set(VALUES, chunked_value=True)
+        iterator = _MockCancellableIterator(result_set)
+        streamed = self._make_one(iterator)
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._consume_next()
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, [])
+        self.assertEqual(streamed._pending_chunk, VALUES[0])
+
+    def test_consume_next_w_pending_chunk(self):
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        BARE = [
+            u"Phlyntstone",
+            42,
+            True,
+            u"Bharney Rhubble",
+            39,
+            True,
+            u"Wylma Phlyntstone",
+        ]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set = self._make_partial_result_set(VALUES)
+        iterator = _MockCancellableIterator(result_set)
+        streamed = self._make_one(iterator)
+        streamed._metadata = self._make_result_set_metadata(FIELDS)
+        streamed._pending_chunk = self._make_value(u"Phred ")
+        streamed._consume_next()
+        self.assertEqual(
+            list(streamed),
+            [[u"Phred Phlyntstone", BARE[1], BARE[2]], [BARE[3], BARE[4], BARE[5]]],
+        )
+        self.assertEqual(streamed._current_row, [BARE[6]])
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test_consume_next_last_set(self):
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        metadata = self._make_result_set_metadata(FIELDS)
+        stats = self._make_result_set_stats(
+            rows_returned="1", elapsed_time="1.23 secs", cpu_time="0.98 secs"
+        )
+        BARE = [u"Phred Phlyntstone", 42, True]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set = self._make_partial_result_set(VALUES, stats=stats)
+        iterator = _MockCancellableIterator(result_set)
+        streamed = self._make_one(iterator)
+        streamed._metadata = metadata
+        streamed._consume_next()
+        self.assertEqual(list(streamed), [BARE])
+        self.assertEqual(streamed._current_row, [])
+        self.assertEqual(streamed._stats, stats)
+
+    def test___iter___empty(self):
+        iterator = _MockCancellableIterator()
+        streamed = self._make_one(iterator)
+        found = list(streamed)
+        self.assertEqual(found, [])
+
+    def test___iter___one_result_set_partial(self):
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        metadata = self._make_result_set_metadata(FIELDS)
+        BARE = [u"Phred Phlyntstone", 42]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set = self._make_partial_result_set(VALUES, metadata=metadata)
+        iterator = _MockCancellableIterator(result_set)
+        streamed = self._make_one(iterator)
+        found = list(streamed)
+        self.assertEqual(found, [])
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, BARE)
+        self.assertEqual(streamed.metadata, metadata)
+
+    def test___iter___multiple_result_sets_filled(self):
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        metadata = self._make_result_set_metadata(FIELDS)
+        BARE = [
+            u"Phred Phlyntstone",
+            42,
+            True,
+            u"Bharney Rhubble",
+            39,
+            True,
+            u"Wylma Phlyntstone",
+            41,
+            True,
+        ]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set1 = self._make_partial_result_set(VALUES[:4], metadata=metadata)
+        result_set2 = self._make_partial_result_set(VALUES[4:])
+        iterator = _MockCancellableIterator(result_set1, result_set2)
+        streamed = self._make_one(iterator)
+        found = list(streamed)
+        self.assertEqual(
+            found,
+            [
+                [BARE[0], BARE[1], BARE[2]],
+                [BARE[3], BARE[4], BARE[5]],
+                [BARE[6], BARE[7], BARE[8]],
+            ],
+        )
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, [])
+        self.assertIsNone(streamed._pending_chunk)
+
+    def test___iter___w_existing_rows_read(self):
+        FIELDS = [
+            self._make_scalar_field("full_name", "STRING"),
+            self._make_scalar_field("age", "INT64"),
+            self._make_scalar_field("married", "BOOL"),
+        ]
+        metadata = self._make_result_set_metadata(FIELDS)
+        ALREADY = [[u"Pebbylz Phlyntstone", 4, False], [u"Dino Rhubble", 4, False]]
+        BARE = [
+            u"Phred Phlyntstone",
+            42,
+            True,
+            u"Bharney Rhubble",
+            39,
+            True,
+            u"Wylma Phlyntstone",
+            41,
+            True,
+        ]
+        VALUES = [self._make_value(bare) for bare in BARE]
+        result_set1 = self._make_partial_result_set(VALUES[:4], metadata=metadata)
+        result_set2 = self._make_partial_result_set(VALUES[4:])
+        iterator = _MockCancellableIterator(result_set1, result_set2)
+        streamed = self._make_one(iterator)
+        streamed._rows[:] = ALREADY
+        found = list(streamed)
+        self.assertEqual(
+            found,
+            ALREADY
+            + [
+                [BARE[0], BARE[1], BARE[2]],
+                [BARE[3], BARE[4], BARE[5]],
+                [BARE[6], BARE[7], BARE[8]],
+            ],
+        )
+        self.assertEqual(list(streamed), [])
+        self.assertEqual(streamed._current_row, [])
+        self.assertIsNone(streamed._pending_chunk)
+
+
+class _MockCancellableIterator(object):
+
+    cancel_calls = 0
+
+    def __init__(self, *values):
+        self.iter_values = iter(values)
+
+    def next(self):
+        return next(self.iter_values)
+
+    def __next__(self):  # pragma: NO COVER Py3k
+        return self.next()
+
+
+class TestStreamedResultSet_JSON_acceptance_tests(unittest.TestCase):
+
+    _json_tests = None
+
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.streamed import StreamedResultSet
+
+        return StreamedResultSet
+
+    def _make_one(self, *args, **kwargs):
+        return self._getTargetClass()(*args, **kwargs)
+
+    def _load_json_test(self, test_name):
+        import os
+
+        if self.__class__._json_tests is None:
+            dirname = os.path.dirname(__file__)
+            filename = os.path.join(dirname, "streaming-read-acceptance-test.json")
+            raw = _parse_streaming_read_acceptance_tests(filename)
+            tests = self.__class__._json_tests = {}
+            for (name, partial_result_sets, results) in raw:
+                tests[name] = partial_result_sets, results
+        return self.__class__._json_tests[test_name]
+
+    # Non-error cases
+
+    def _match_results(self, testcase_name, assert_equality=None):
+        partial_result_sets, expected = self._load_json_test(testcase_name)
+        iterator = _MockCancellableIterator(*partial_result_sets)
+        partial = self._make_one(iterator)
+        if assert_equality is not None:
+            assert_equality(list(partial), expected)
+        else:
+            self.assertEqual(list(partial), expected)
+
+    def test_basic(self):
+        self._match_results("Basic Test")
+
+    def test_string_chunking(self):
+        self._match_results("String Chunking Test")
+
+    def test_string_array_chunking(self):
+        self._match_results("String Array Chunking Test")
+
+    def test_string_array_chunking_with_nulls(self):
+        self._match_results("String Array Chunking Test With Nulls")
+
+    def test_string_array_chunking_with_empty_strings(self):
+        self._match_results("String Array Chunking Test With Empty Strings")
+
+    def test_string_array_chunking_with_one_large_string(self):
+        self._match_results("String Array Chunking Test With One Large String")
+
+    def test_int64_array_chunking(self):
+        self._match_results("INT64 Array Chunking Test")
+
+    def test_float64_array_chunking(self):
+        import math
+
+        def assert_float_equality(lhs, rhs):
+            # NaN, +Inf, and -Inf can't be tested for equality
+            if lhs is None:
+                self.assertIsNone(rhs)
+            elif math.isnan(lhs):
+                self.assertTrue(math.isnan(rhs))
+            elif math.isinf(lhs):
+                self.assertTrue(math.isinf(rhs))
+                # but +Inf and -Inf can be tested for magnitude
+                self.assertTrue((lhs > 0) == (rhs > 0))
+            else:
+                self.assertEqual(lhs, rhs)
+
+        def assert_rows_equality(lhs, rhs):
+            self.assertEqual(len(lhs), len(rhs))
+            for l_rows, r_rows in zip(lhs, rhs):
+                self.assertEqual(len(l_rows), len(r_rows))
+                for l_row, r_row in zip(l_rows, r_rows):
+                    self.assertEqual(len(l_row), len(r_row))
+                    for l_cell, r_cell in zip(l_row, r_row):
+                        assert_float_equality(l_cell, r_cell)
+
+        self._match_results("FLOAT64 Array Chunking Test", assert_rows_equality)
+
+    def test_struct_array_chunking(self):
+        self._match_results("Struct Array Chunking Test")
+
+    def test_nested_struct_array(self):
+        self._match_results("Nested Struct Array Test")
+
+    def test_nested_struct_array_chunking(self):
+        self._match_results("Nested Struct Array Chunking Test")
+
+    def test_struct_array_and_string_chunking(self):
+        self._match_results("Struct Array And String Chunking Test")
+
+    def test_multiple_row_single_chunk(self):
+        self._match_results("Multiple Row Single Chunk")
+
+    def test_multiple_row_multiple_chunks(self):
+        self._match_results("Multiple Row Multiple Chunks")
+
+    def test_multiple_row_chunks_non_chunks_interleaved(self):
+        self._match_results("Multiple Row Chunks/Non Chunks Interleaved")
+
+
+def _generate_partial_result_sets(prs_text_pbs):
+    from google.protobuf.json_format import Parse
+    from google.cloud.spanner_v1.proto.result_set_pb2 import PartialResultSet
+
+    partial_result_sets = []
+
+    for prs_text_pb in prs_text_pbs:
+        prs = PartialResultSet()
+        partial_result_sets.append(Parse(prs_text_pb, prs))
+
+    return partial_result_sets
+
+
+def _normalize_int_array(cell):
+    normalized = []
+    for subcell in cell:
+        if subcell is not None:
+            subcell = int(subcell)
+        normalized.append(subcell)
+    return normalized
+
+
+def _normalize_float(cell):
+    if cell == u"Infinity":
+        return float("inf")
+    if cell == u"-Infinity":
+        return float("-inf")
+    if cell == u"NaN":
+        return float("nan")
+    if cell is not None:
+        return float(cell)
+
+
+def _normalize_results(rows_data, fields):
+    """Helper for _parse_streaming_read_acceptance_tests"""
+    from google.cloud.spanner_v1.proto import type_pb2
+
+    normalized = []
+    for row_data in rows_data:
+        row = []
+        assert len(row_data) == len(fields)
+        for cell, field in zip(row_data, fields):
+            if field.type.code == type_pb2.INT64:
+                cell = int(cell)
+            if field.type.code == type_pb2.FLOAT64:
+                cell = _normalize_float(cell)
+            elif field.type.code == type_pb2.BYTES:
+                cell = cell.encode("utf8")
+            elif field.type.code == type_pb2.ARRAY:
+                if field.type.array_element_type.code == type_pb2.INT64:
+                    cell = _normalize_int_array(cell)
+                elif field.type.array_element_type.code == type_pb2.FLOAT64:
+                    cell = [_normalize_float(subcell) for subcell in cell]
+            row.append(cell)
+        normalized.append(row)
+    return normalized
+
+
+def _parse_streaming_read_acceptance_tests(filename):
+    """Parse acceptance tests from JSON
+
+    See streaming-read-acceptance-test.json
+    """
+    import json
+
+    with open(filename) as json_file:
+        test_json = json.load(json_file)
+
+    for test in test_json["tests"]:
+        name = test["name"]
+        partial_result_sets = _generate_partial_result_sets(test["chunks"])
+        fields = partial_result_sets[0].metadata.row_type.fields
+        result = _normalize_results(test["result"]["value"], fields)
+        yield name, partial_result_sets, result
diff --git a/spanner/tests/unit/test_transaction.py b/spanner/tests/unit/test_transaction.py
new file mode 100644
index 000000000000..cceff89fcaac
--- /dev/null
+++ b/spanner/tests/unit/test_transaction.py
@@ -0,0 +1,598 @@
+# Copyright 2016 Google LLC 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.
+
+
+import unittest
+
+import mock
+
+
+TABLE_NAME = "citizens"
+COLUMNS = ["email", "first_name", "last_name", "age"]
+VALUES = [
+    ["phred@exammple.com", "Phred", "Phlyntstone", 32],
+    ["bharney@example.com", "Bharney", "Rhubble", 31],
+]
+DML_QUERY = """\
+INSERT INTO citizens(first_name, last_name, age)
+VALUES ("Phred", "Phlyntstone", 32)
+"""
+DML_QUERY_WITH_PARAM = """
+INSERT INTO citizens(first_name, last_name, age)
+VALUES ("Phred", "Phlyntstone", @age)
+"""
+PARAMS = {"age": 30}
+PARAM_TYPES = {"age": "INT64"}
+
+
+class TestTransaction(unittest.TestCase):
+
+    PROJECT_ID = "project-id"
+    INSTANCE_ID = "instance-id"
+    INSTANCE_NAME = "projects/" + PROJECT_ID + "/instances/" + INSTANCE_ID
+    DATABASE_ID = "database-id"
+    DATABASE_NAME = INSTANCE_NAME + "/databases/" + DATABASE_ID
+    SESSION_ID = "session-id"
+    SESSION_NAME = DATABASE_NAME + "/sessions/" + SESSION_ID
+    TRANSACTION_ID = b"DEADBEEF"
+
+    def _getTargetClass(self):
+        from google.cloud.spanner_v1.transaction import Transaction
+
+        return Transaction
+
+    def _make_one(self, session, *args, **kwargs):
+        transaction = self._getTargetClass()(session, *args, **kwargs)
+        session._transaction = transaction
+        return transaction
+
+    def _make_spanner_api(self):
+        import google.cloud.spanner_v1.gapic.spanner_client
+
+        return mock.create_autospec(
+            google.cloud.spanner_v1.gapic.spanner_client.SpannerClient, instance=True
+        )
+
+    def test_ctor_session_w_existing_txn(self):
+        session = _Session()
+        session._transaction = object()
+        with self.assertRaises(ValueError):
+            self._make_one(session)
+
+    def test_ctor_defaults(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        self.assertIs(transaction._session, session)
+        self.assertIsNone(transaction._transaction_id)
+        self.assertIsNone(transaction.committed)
+        self.assertFalse(transaction._rolled_back)
+        self.assertTrue(transaction._multi_use)
+        self.assertEqual(transaction._execute_sql_count, 0)
+
+    def test__check_state_not_begun(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        with self.assertRaises(ValueError):
+            transaction._check_state()
+
+    def test__check_state_already_committed(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction.committed = object()
+        with self.assertRaises(ValueError):
+            transaction._check_state()
+
+    def test__check_state_already_rolled_back(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction._rolled_back = True
+        with self.assertRaises(ValueError):
+            transaction._check_state()
+
+    def test__check_state_ok(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction._check_state()  # does not raise
+
+    def test__make_txn_selector(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        selector = transaction._make_txn_selector()
+        self.assertEqual(selector.id, self.TRANSACTION_ID)
+
+    def test_begin_already_begun(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        with self.assertRaises(ValueError):
+            transaction.begin()
+
+    def test_begin_already_rolled_back(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._rolled_back = True
+        with self.assertRaises(ValueError):
+            transaction.begin()
+
+    def test_begin_already_committed(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction.committed = object()
+        with self.assertRaises(ValueError):
+            transaction.begin()
+
+    def test_begin_w_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.begin_transaction.side_effect = RuntimeError()
+        session = _Session(database)
+        transaction = self._make_one(session)
+
+        with self.assertRaises(RuntimeError):
+            transaction.begin()
+
+    def test_begin_ok(self):
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+        )
+
+        transaction_pb = TransactionPB(id=self.TRANSACTION_ID)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(
+            _begin_transaction_response=transaction_pb
+        )
+        session = _Session(database)
+        transaction = self._make_one(session)
+
+        txn_id = transaction.begin()
+
+        self.assertEqual(txn_id, self.TRANSACTION_ID)
+        self.assertEqual(transaction._transaction_id, self.TRANSACTION_ID)
+
+        session_id, txn_options, metadata = api._begun
+        self.assertEqual(session_id, session.name)
+        self.assertTrue(txn_options.HasField("read_write"))
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+    def test_rollback_not_begun(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        with self.assertRaises(ValueError):
+            transaction.rollback()
+
+    def test_rollback_already_committed(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction.committed = object()
+        with self.assertRaises(ValueError):
+            transaction.rollback()
+
+    def test_rollback_already_rolled_back(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction._rolled_back = True
+        with self.assertRaises(ValueError):
+            transaction.rollback()
+
+    def test_rollback_w_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.rollback.side_effect = RuntimeError("other error")
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        with self.assertRaises(RuntimeError):
+            transaction.rollback()
+
+        self.assertFalse(transaction._rolled_back)
+
+    def test_rollback_ok(self):
+        from google.protobuf.empty_pb2 import Empty
+
+        empty_pb = Empty()
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(_rollback_response=empty_pb)
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction.replace(TABLE_NAME, COLUMNS, VALUES)
+
+        transaction.rollback()
+
+        self.assertTrue(transaction._rolled_back)
+        self.assertIsNone(session._transaction)
+
+        session_id, txn_id, metadata = api._rolled_back
+        self.assertEqual(session_id, session.name)
+        self.assertEqual(txn_id, self.TRANSACTION_ID)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+    def test_commit_not_begun(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        with self.assertRaises(ValueError):
+            transaction.commit()
+
+    def test_commit_already_committed(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction.committed = object()
+        with self.assertRaises(ValueError):
+            transaction.commit()
+
+    def test_commit_already_rolled_back(self):
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction._rolled_back = True
+        with self.assertRaises(ValueError):
+            transaction.commit()
+
+    def test_commit_w_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.commit.side_effect = RuntimeError()
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction.replace(TABLE_NAME, COLUMNS, VALUES)
+
+        with self.assertRaises(RuntimeError):
+            transaction.commit()
+
+        self.assertIsNone(transaction.committed)
+
+    def _commit_helper(self, mutate=True):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.keyset import KeySet
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        keys = [[0], [1], [2]]
+        keyset = KeySet(keys=keys)
+        response = CommitResponse(commit_timestamp=now_pb)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(_commit_response=response)
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+
+        if mutate:
+            transaction.delete(TABLE_NAME, keyset)
+
+        transaction.commit()
+
+        self.assertEqual(transaction.committed, now)
+        self.assertIsNone(session._transaction)
+
+        session_id, mutations, txn_id, metadata = api._committed
+        self.assertEqual(session_id, session.name)
+        self.assertEqual(txn_id, self.TRANSACTION_ID)
+        self.assertEqual(mutations, transaction._mutations)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+    def test_commit_no_mutations(self):
+        self._commit_helper(mutate=False)
+
+    def test_commit_w_mutations(self):
+        self._commit_helper(mutate=True)
+
+    def test__make_params_pb_w_params_wo_param_types(self):
+        session = _Session()
+        transaction = self._make_one(session)
+
+        with self.assertRaises(ValueError):
+            transaction._make_params_pb(PARAMS, None)
+
+    def test__make_params_pb_wo_params_w_param_types(self):
+        session = _Session()
+        transaction = self._make_one(session)
+
+        with self.assertRaises(ValueError):
+            transaction._make_params_pb(None, PARAM_TYPES)
+
+    def test__make_params_pb_w_params_w_param_types(self):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        session = _Session()
+        transaction = self._make_one(session)
+
+        params_pb = transaction._make_params_pb(PARAMS, PARAM_TYPES)
+
+        expected_params = Struct(
+            fields={key: _make_value_pb(value) for (key, value) in PARAMS.items()}
+        )
+        self.assertEqual(params_pb, expected_params)
+
+    def test_execute_update_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.execute_sql.side_effect = RuntimeError()
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+
+        with self.assertRaises(RuntimeError):
+            transaction.execute_update(DML_QUERY)
+
+    def test_execute_update_w_params_wo_param_types(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        session = _Session(database)
+        session = _Session()
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+
+        with self.assertRaises(ValueError):
+            transaction.execute_update(DML_QUERY_WITH_PARAM, PARAMS)
+
+    def _execute_update_helper(self, count=0):
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1.proto.result_set_pb2 import (
+            ResultSet,
+            ResultSetStats,
+        )
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionSelector
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        MODE = 2  # PROFILE
+        stats_pb = ResultSetStats(row_count_exact=1)
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.execute_sql.return_value = ResultSet(stats=stats_pb)
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction._execute_sql_count = count
+
+        row_count = transaction.execute_update(
+            DML_QUERY_WITH_PARAM, PARAMS, PARAM_TYPES, query_mode=MODE
+        )
+
+        self.assertEqual(row_count, 1)
+
+        expected_transaction = TransactionSelector(id=self.TRANSACTION_ID)
+        expected_params = Struct(
+            fields={key: _make_value_pb(value) for (key, value) in PARAMS.items()}
+        )
+
+        api.execute_sql.assert_called_once_with(
+            self.SESSION_NAME,
+            DML_QUERY_WITH_PARAM,
+            transaction=expected_transaction,
+            params=expected_params,
+            param_types=PARAM_TYPES,
+            query_mode=MODE,
+            seqno=count,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+        self.assertEqual(transaction._execute_sql_count, count + 1)
+
+    def test_execute_update_new_transaction(self):
+        self._execute_update_helper()
+
+    def test_execute_update_w_count(self):
+        self._execute_update_helper(count=1)
+
+    def test_batch_update_other_error(self):
+        database = _Database()
+        database.spanner_api = self._make_spanner_api()
+        database.spanner_api.execute_batch_dml.side_effect = RuntimeError()
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+
+        with self.assertRaises(RuntimeError):
+            transaction.batch_update(statements=[DML_QUERY])
+
+    def _batch_update_helper(self, error_after=None, count=0):
+        from google.rpc.status_pb2 import Status
+        from google.protobuf.struct_pb2 import Struct
+        from google.cloud.spanner_v1.proto.result_set_pb2 import ResultSet
+        from google.cloud.spanner_v1.proto.result_set_pb2 import ResultSetStats
+        from google.cloud.spanner_v1.proto.spanner_pb2 import ExecuteBatchDmlResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import TransactionSelector
+        from google.cloud.spanner_v1._helpers import _make_value_pb
+
+        insert_dml = "INSERT INTO table(pkey, desc) VALUES (%pkey, %desc)"
+        insert_params = {"pkey": 12345, "desc": "DESCRIPTION"}
+        insert_param_types = {"pkey": "INT64", "desc": "STRING"}
+        update_dml = 'UPDATE table SET desc = desc + "-amended"'
+        delete_dml = "DELETE FROM table WHERE desc IS NULL"
+
+        dml_statements = [
+            (insert_dml, insert_params, insert_param_types),
+            update_dml,
+            delete_dml,
+        ]
+
+        stats_pbs = [
+            ResultSetStats(row_count_exact=1),
+            ResultSetStats(row_count_exact=2),
+            ResultSetStats(row_count_exact=3),
+        ]
+        if error_after is not None:
+            stats_pbs = stats_pbs[:error_after]
+            expected_status = Status(code=400)
+        else:
+            expected_status = Status(code=200)
+        expected_row_counts = [stats.row_count_exact for stats in stats_pbs]
+
+        response = ExecuteBatchDmlResponse(
+            status=expected_status,
+            result_sets=[ResultSet(stats=stats_pb) for stats_pb in stats_pbs],
+        )
+        database = _Database()
+        api = database.spanner_api = self._make_spanner_api()
+        api.execute_batch_dml.return_value = response
+        session = _Session(database)
+        transaction = self._make_one(session)
+        transaction._transaction_id = self.TRANSACTION_ID
+        transaction._execute_sql_count = count
+
+        status, row_counts = transaction.batch_update(dml_statements)
+
+        self.assertEqual(status, expected_status)
+        self.assertEqual(row_counts, expected_row_counts)
+
+        expected_transaction = TransactionSelector(id=self.TRANSACTION_ID)
+        expected_insert_params = Struct(
+            fields={
+                key: _make_value_pb(value) for (key, value) in insert_params.items()
+            }
+        )
+        expected_statements = [
+            {
+                "sql": insert_dml,
+                "params": expected_insert_params,
+                "param_types": insert_param_types,
+            },
+            {"sql": update_dml},
+            {"sql": delete_dml},
+        ]
+
+        api.execute_batch_dml.assert_called_once_with(
+            session=self.SESSION_NAME,
+            transaction=expected_transaction,
+            statements=expected_statements,
+            seqno=count,
+            metadata=[("google-cloud-resource-prefix", database.name)],
+        )
+
+        self.assertEqual(transaction._execute_sql_count, count + 1)
+
+    def test_batch_update_wo_errors(self):
+        self._batch_update_helper()
+
+    def test_batch_update_w_errors(self):
+        self._batch_update_helper(error_after=2, count=1)
+
+    def test_context_mgr_success(self):
+        import datetime
+        from google.cloud.spanner_v1.proto.spanner_pb2 import CommitResponse
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+        )
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        transaction_pb = TransactionPB(id=self.TRANSACTION_ID)
+        database = _Database()
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_pb = _datetime_to_pb_timestamp(now)
+        response = CommitResponse(commit_timestamp=now_pb)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(
+            _begin_transaction_response=transaction_pb, _commit_response=response
+        )
+        session = _Session(database)
+        transaction = self._make_one(session)
+
+        with transaction:
+            transaction.insert(TABLE_NAME, COLUMNS, VALUES)
+
+        self.assertEqual(transaction.committed, now)
+
+        session_id, mutations, txn_id, metadata = api._committed
+        self.assertEqual(session_id, self.SESSION_NAME)
+        self.assertEqual(txn_id, self.TRANSACTION_ID)
+        self.assertEqual(mutations, transaction._mutations)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+    def test_context_mgr_failure(self):
+        from google.protobuf.empty_pb2 import Empty
+
+        empty_pb = Empty()
+        from google.cloud.spanner_v1.proto.transaction_pb2 import (
+            Transaction as TransactionPB,
+        )
+
+        transaction_pb = TransactionPB(id=self.TRANSACTION_ID)
+        database = _Database()
+        api = database.spanner_api = _FauxSpannerAPI(
+            _begin_transaction_response=transaction_pb, _rollback_response=empty_pb
+        )
+        session = _Session(database)
+        transaction = self._make_one(session)
+
+        with self.assertRaises(Exception):
+            with transaction:
+                transaction.insert(TABLE_NAME, COLUMNS, VALUES)
+                raise Exception("bail out")
+
+        self.assertEqual(transaction.committed, None)
+        self.assertTrue(transaction._rolled_back)
+        self.assertEqual(len(transaction._mutations), 1)
+
+        self.assertEqual(api._committed, None)
+
+        session_id, txn_id, metadata = api._rolled_back
+        self.assertEqual(session_id, session.name)
+        self.assertEqual(txn_id, self.TRANSACTION_ID)
+        self.assertEqual(metadata, [("google-cloud-resource-prefix", database.name)])
+
+
+class _Database(object):
+    name = "testing"
+
+
+class _Session(object):
+
+    _transaction = None
+
+    def __init__(self, database=None, name=TestTransaction.SESSION_NAME):
+        self._database = database
+        self.name = name
+
+
+class _FauxSpannerAPI(object):
+
+    _committed = None
+
+    def __init__(self, **kwargs):
+        self.__dict__.update(**kwargs)
+
+    def begin_transaction(self, session, options_, metadata=None):
+        self._begun = (session, options_, metadata)
+        return self._begin_transaction_response
+
+    def rollback(self, session, transaction_id, metadata=None):
+        self._rolled_back = (session, transaction_id, metadata)
+        return self._rollback_response
+
+    def commit(
+        self,
+        session,
+        mutations,
+        transaction_id="",
+        single_use_transaction=None,
+        metadata=None,
+    ):
+        assert single_use_transaction is None
+        self._committed = (session, mutations, transaction_id, metadata)
+        return self._commit_response
diff --git a/speech/.coveragerc b/speech/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/speech/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/speech/.flake8 b/speech/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/speech/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/speech/.repo-metadata.json b/speech/.repo-metadata.json
new file mode 100644
index 000000000000..18500b9ac8a0
--- /dev/null
+++ b/speech/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "speech",
+  "name_pretty": "Cloud Speech",
+  "product_documentation": "https://cloud.google.com/speech-to-text/docs/",
+  "client_documentation": "https://googleapis.dev/python/speech/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559758",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-speech",
+  "api_id": "speech.googleapis.com",
+  "requires_billing": false
+}
\ No newline at end of file
diff --git a/speech/CHANGELOG.md b/speech/CHANGELOG.md
new file mode 100644
index 000000000000..46451da5488a
--- /dev/null
+++ b/speech/CHANGELOG.md
@@ -0,0 +1,214 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-speech/#history
+
+## 1.2.0
+
+07-24-2019 17:35 PDT
+
+### New Features
+- Add 'client_options' support (via synth). ([#8534](https://github.com/googleapis/google-cloud-python/pull/8534))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Pin black version (via synth). ([#8596](https://github.com/googleapis/google-cloud-python/pull/8596))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+## 1.1.0
+
+06-27-2019 16:55 PDT
+
+### Implementation Changes
+- Allow kwargs to be passed to 'create_channel' (via synth). ([#8428](https://github.com/googleapis/google-cloud-python/pull/8428))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Increase speech max received msg size to 256 MiB ([#8338](https://github.com/googleapis/google-cloud-python/pull/8338))
+- Add MP3 to Audio Encoding and add boost to Speech Context (via synth). ([#8109](https://github.com/googleapis/google-cloud-python/pull/8109))
+- Add Recognition Metadata (via synth). ([#7961](https://github.com/googleapis/google-cloud-python/pull/7961))
+
+### Documentation
+- Update to show 'google-cloud-speech' is GA. ([#8453](https://github.com/googleapis/google-cloud-python/pull/8453))
+- Tweak 'SpeechContext' docstring (via synth). ([#8223](https://github.com/googleapis/google-cloud-python/pull/8223))
+
+### Internal / Testing Changes
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- (Re)-blacken (via synth). ([#8446](https://github.com/googleapis/google-cloud-python/pull/8446))
+- Add disclaimer to auto-generated template files (via synth).  ([#8328](https://github.com/googleapis/google-cloud-python/pull/8328))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8252](https://github.com/googleapis/google-cloud-python/pull/8252))
+- Fix coverage in 'types.py' (via synth). ([#8164](https://github.com/googleapis/google-cloud-python/pull/8164))
+- Blacken noxfile.py, setup.py (via synth). ([#8132](https://github.com/googleapis/google-cloud-python/pull/8132))
+- Add empty lines. ([#8072](https://github.com/googleapis/google-cloud-python/pull/8072))
+- Update noxfile (via synth). ([#7836](https://github.com/googleapis/google-cloud-python/pull/7836))
+- Add nox session `docs` (via synth). ([#7782](https://github.com/googleapis/google-cloud-python/pull/7782))
+
+## 1.0.0
+
+03-18-2019 08:05 PDT
+
+
+### Implementation Changes
+- Remove unused message exports. ([#7275](https://github.com/googleapis/google-cloud-python/pull/7275))
+
+### New Features
+- Promote google-cloud-speech to GA ([#7525](https://github.com/googleapis/google-cloud-python/pull/7525))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+- Speech: copy lintified proto files (via synth).
+- Add clarifying comment to blacken nox target. ([#7404](https://github.com/googleapis/google-cloud-python/pull/7404))
+- Copy proto files alongside protoc versions. Remove unneeded utf-8 header.
+
+## 0.36.3
+
+01-31-2019 09:57 PST
+
+
+### New Features
+- Add 'RecognitionConfig.audio_channel_count' field via synth. ([#7240](https://github.com/googleapis/google-cloud-python/pull/7240))
+
+### Documentation
+- Modify file headers. ([#7158](https://github.com/googleapis/google-cloud-python/pull/7158))
+
+### Internal / Testing Changes
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.36.2
+
+01-10-2019 15:36 PST
+
+### Implementation Changes
+- Protoc-generated serialization update. ([#7106](https://github.com/googleapis/google-cloud-python/pull/7106))
+
+### Documentation
+- Regenerate speech to change quote chars in docstr.
+- Pick up stub docstring fix in GAPIC generator. ([#6982](https://github.com/googleapis/google-cloud-python/pull/6982))
+
+## 0.36.1
+
+12-18-2018 09:46 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAIPC generator. ([#6508](https://github.com/googleapis/google-cloud-python/pull/6508))
+- Add `result_end_time`, docstring changes via synth. ([#6462](https://github.com/googleapis/google-cloud-python/pull/6462))
+- Assorted synth fixups / cleanups ([#6400](https://github.com/googleapis/google-cloud-python/pull/6400))
+- Fix `client_info` bug, update docstrings and timeouts. ([#6421](https://github.com/googleapis/google-cloud-python/pull/6421))
+- Re-generate library using speech/synth.py ([#5979](https://github.com/googleapis/google-cloud-python/pull/5979))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Clarify passed arguments in speech examples. ([#6857](https://github.com/googleapis/google-cloud-python/pull/6857))
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Fix client library URL. ([#6052](https://github.com/googleapis/google-cloud-python/pull/6052))
+- Prep docs for repo split. ([#6017](https://github.com/googleapis/google-cloud-python/pull/6017))
+
+### Internal / Testing Changes
+- Synth.metadata. ([#6868](https://github.com/googleapis/google-cloud-python/pull/6868))
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.36.0
+
+### New Features
+
+- Re-generate the library to pick up changes and new features in the underlying API. ([#5915](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5915))
+
+### Documentation
+
+- Fix broken links to description of 'Beta' ([#5917](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5917))
+- Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5901))
+
+## 0.35.0
+
+### Implementation Changes
+
+- Re-generated the library to pick up new API features. (#5577)
+
+### Internal / Testing Changes
+
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+
+## 0.34.0
+
+### Implementation Changes
+- Regenerate GAPIC to account for the removal of GoogleDataCollectionConfig and google_data_collection_opt_in  (#5235)
+
+## 0.33.0
+
+### New Features
+
+- Add Audio Logging and Recognition Metadata. (#5123)
+
+### Internal / Testing Changes
+
+- Fix bad trove classifier
+
+## 0.32.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+
+## 0.31.1
+
+### Bugfixes
+
+- Fix speech helpers to properly pass retry and timeout args. (#4828, #4830)
+
+## 0.31.0
+
+This is the (hopefully) final release candidate before 1.0.
+
+### Breaking Changes
+
+- The deprecated Speech layer (deprecated since 0.27.0) has been removed. If you are still using  it, the [migration guide](https://cloud.google.com/speech/docs/python-client-migration) is still available.
+- The following changes are _technically_ breaking but very unlikely to affect you directly:
+  * `google.cloud.gapic.speech.v1` moved to `google.cloud.speech_v1.gapic`, in accordance with more recent clients.
+  * `google.cloud.proto.speech.v1` moved to `google.cloud.speech_v1.proto`, in accordance with more recent clients.
+
+### Dependencies
+
+  * Removed dependency on `google-gax`.
+  * Added dependency on `google-api-core`, its replacement.
+
+## 0.30.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+PyPI: https://pypi.org/project/google-cloud-speech/0.30.0/
diff --git a/speech/LICENSE b/speech/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/speech/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/speech/MANIFEST.in b/speech/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/speech/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/speech/README.rst b/speech/README.rst
new file mode 100644
index 000000000000..3cdf9fda5668
--- /dev/null
+++ b/speech/README.rst
@@ -0,0 +1,109 @@
+Python Client for Cloud Speech API
+==================================
+
+
+|GA| |pypi| |versions| 
+
+The `Cloud Speech API`_ enables developers to convert audio to text by applying
+powerful neural network models.  The API recognizes over 80 languages and
+variants, to support your global user base.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-speech.svg
+   :target: https://pypi.org/project/google-cloud-speech/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-speech.svg
+   :target: https://pypi.org/project/google-cloud-speech/
+.. _Cloud Speech API: https://cloud.google.com/speech
+.. _Client Library Documentation: https://googleapis.dev/python/speech/latest
+.. _Product Documentation:  https://cloud.google.com/speech
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Speech API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Speech API.:  https://cloud.google.com/speech
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-speech
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-speech
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code:: py
+
+    from google.cloud import speech_v1
+    from google.cloud.speech_v1 import enums
+
+    client = speech_v1.SpeechClient()
+
+    encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+    sample_rate_hertz = 44100
+    language_code = 'en-US'
+    config = {'encoding': encoding, 'sample_rate_hertz': sample_rate_hertz, 'language_code': language_code}
+    uri = 'gs://bucket_name/file_name.flac'
+    audio = {'uri': uri}
+
+    response = client.recognize(config, audio)
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Speech API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
+   APIs that we cover.
diff --git a/speech/docs/README.rst b/speech/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/speech/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/speech/docs/changelog.md b/speech/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/speech/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/speech/docs/conf.py b/speech/docs/conf.py
new file mode 100644
index 000000000000..c5561bbeb3d1
--- /dev/null
+++ b/speech/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-speech documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-speech"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-speech-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-speech.tex",
+        u"google-cloud-speech Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-speech",
+        u"google-cloud-speech Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-speech",
+        u"google-cloud-speech Documentation",
+        author,
+        "google-cloud-speech",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/speech/docs/gapic/v1/api.rst b/speech/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..45658eda89a2
--- /dev/null
+++ b/speech/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Speech API
+===========================
+
+.. automodule:: google.cloud.speech_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/speech/docs/gapic/v1/types.rst b/speech/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..6083c398def7
--- /dev/null
+++ b/speech/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Speech API Client
+=================================
+
+.. automodule:: google.cloud.speech_v1.types
+    :members:
\ No newline at end of file
diff --git a/speech/docs/gapic/v1p1beta1/api.rst b/speech/docs/gapic/v1p1beta1/api.rst
new file mode 100644
index 000000000000..4779930fdd9e
--- /dev/null
+++ b/speech/docs/gapic/v1p1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Speech API
+===========================
+
+.. automodule:: google.cloud.speech_v1p1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/speech/docs/gapic/v1p1beta1/types.rst b/speech/docs/gapic/v1p1beta1/types.rst
new file mode 100644
index 000000000000..ce33f105e230
--- /dev/null
+++ b/speech/docs/gapic/v1p1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Speech API Client
+=================================
+
+.. automodule:: google.cloud.speech_v1p1beta1.types
+    :members:
\ No newline at end of file
diff --git a/speech/docs/index.rst b/speech/docs/index.rst
new file mode 100644
index 000000000000..02f947a7e224
--- /dev/null
+++ b/speech/docs/index.rst
@@ -0,0 +1,282 @@
+.. include:: README.rst
+
+Using the Library
+-----------------
+
+Asynchronous Recognition
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The :meth:`~.speech_v1.SpeechClient.long_running_recognize` method
+sends audio data to the Speech API and initiates a Long Running Operation.
+
+Using this operation, you can periodically poll for recognition results.
+Use asynchronous requests for audio data of any duration up to 80 minutes.
+
+See: `Speech Asynchronous Recognize`_
+
+
+.. code-block:: python
+
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> audio = speech.types.RecognitionAudio(
+    ...     uri='gs://my-bucket/recording.flac')
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100)
+    >>> operation = client.long_running_recognize(config=config, audio=audio)
+    >>> op_result = operation.result()
+    >>> for result in op_result.results:
+    ...     for alternative in result.alternatives:
+    ...         print('=' * 20)
+    ...         print(alternative.transcript)
+    ...         print(alternative.confidence)
+    ====================
+    'how old is the Brooklyn Bridge'
+    0.98267895
+
+
+Synchronous Recognition
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The :meth:`~.speech_v1.SpeechClient.recognize` method converts speech
+data to text and returns alternative text transcriptions.
+
+This example uses ``language_code='en-GB'`` to better recognize a dialect from
+Great Britain.
+
+.. code-block:: python
+
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> audio = speech.types.RecognitionAudio(
+    ...     uri='gs://my-bucket/recording.flac')
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100)
+    >>> results = client.recognize(config=config, audio=audio)
+    >>> for result in results:
+    ...     for alternative in result.alternatives:
+    ...         print('=' * 20)
+    ...         print('transcript: ' + alternative.transcript)
+    ...         print('confidence: ' + str(alternative.confidence))
+    ====================
+    transcript: Hello, this is a test
+    confidence: 0.81
+    ====================
+    transcript: Hello, this is one test
+    confidence: 0
+
+Example of using the profanity filter.
+
+.. code-block:: python
+
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> audio = speech.types.RecognitionAudio(
+    ...     uri='gs://my-bucket/recording.flac')
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100,
+    ...     profanity_filter=True)
+    >>> results = client.recognize(config=config, audio=audio)
+    >>> for result in results:
+    ...     for alternative in result.alternatives:
+    ...         print('=' * 20)
+    ...         print('transcript: ' + alternative.transcript)
+    ...         print('confidence: ' + str(alternative.confidence))
+    ====================
+    transcript: Hello, this is a f****** test
+    confidence: 0.81
+
+Using speech context hints to get better results. This can be used to improve
+the accuracy for specific words and phrases. This can also be used to add new
+words to the vocabulary of the recognizer.
+
+.. code-block:: python
+
+    >>> from google.cloud import speech
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> audio = speech.types.RecognitionAudio(
+    ...     uri='gs://my-bucket/recording.flac')
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100,
+    ...     speech_contexts=[speech.types.SpeechContext(
+    ...         phrases=['hi', 'good afternoon'],
+    ...     )])
+    >>> results = client.recognize(config=config, audio=audio)
+    >>> for result in results:
+    ...     for alternative in result.alternatives:
+    ...         print('=' * 20)
+    ...         print('transcript: ' + alternative.transcript)
+    ...         print('confidence: ' + str(alternative.confidence))
+    ====================
+    transcript: Hello, this is a test
+    confidence: 0.81
+
+
+Streaming Recognition
+~~~~~~~~~~~~~~~~~~~~~
+
+The :meth:`~speech_v1.SpeechClient.streaming_recognize` method converts
+speech data to possible text alternatives on the fly.
+
+.. note::
+    Streaming recognition requests are limited to 1 minute of audio.
+
+    See: https://cloud.google.com/speech/limits#content
+
+.. code-block:: python
+
+    >>> import io
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100,
+    ... )
+    >>> with io.open('./hello.wav', 'rb') as stream:
+    ...     requests = [speech.types.StreamingRecognizeRequest(
+    ...         audio_content=stream.read(),
+    ...     )]
+    >>> results = sample.streaming_recognize(
+    ...     config=speech.types.StreamingRecognitionConfig(config=config),
+    ...     requests,
+    ... )
+    >>> for result in results:
+    ...     for alternative in result.alternatives:
+    ...         print('=' * 20)
+    ...         print('transcript: ' + alternative.transcript)
+    ...         print('confidence: ' + str(alternative.confidence))
+    ====================
+    transcript: hello thank you for using Google Cloud platform
+    confidence: 0.927983105183
+
+
+By default the API will perform continuous recognition
+(continuing to process audio even if the speaker in the audio pauses speaking)
+until the client closes the output stream or until the maximum time limit has
+been reached.
+
+If you only want to recognize a single utterance you can set
+``single_utterance`` to :data:`True` and only one result will be returned.
+
+See: `Single Utterance`_
+
+.. code-block:: python
+
+    >>> import io
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100,
+    ... )
+    >>> with io.open('./hello-pause-goodbye.wav', 'rb') as stream:
+    ...     requests = [speech.types.StreamingRecognizeRequest(
+    ...         audio_content=stream.read(),
+    ...     )]
+    >>> results = sample.streaming_recognize(
+    ...     config=speech.types.StreamingRecognitionConfig(
+    ...         config=config,
+    ...         single_utterance=False,
+    ...     ),
+    ...     requests,
+    ... )
+    >>> for result in results:
+    ...     for alternative in result.alternatives:
+    ...         print('=' * 20)
+    ...         print('transcript: ' + alternative.transcript)
+    ...         print('confidence: ' + str(alternative.confidence))
+    ...     for result in results:
+    ...         for alternative in result.alternatives:
+    ...             print('=' * 20)
+    ...             print('transcript: ' + alternative.transcript)
+    ...             print('confidence: ' + str(alternative.confidence))
+    ====================
+    transcript: testing a pause
+    confidence: 0.933770477772
+
+If ``interim_results`` is set to :data:`True`, interim results
+(tentative hypotheses) may be returned as they become available.
+
+.. code-block:: python
+
+    >>> import io
+    >>> from google.cloud import speech
+    >>> client = speech.SpeechClient()
+    >>> config = speech.types.RecognitionConfig(
+    ...     encoding=speech.enums.RecognitionConfig.AudioEncoding.LINEAR16,
+    ...     language_code='en-US',
+    ...     sample_rate_hertz=44100,
+    ... )
+    >>> with io.open('./hello.wav', 'rb') as stream:
+    ...     requests = [speech.types.StreamingRecognizeRequest(
+    ...         audio_content=stream.read(),
+    ...     )]
+    >>> config = speech.types.StreamingRecognitionConfig(config=config)
+    >>> responses = client.streaming_recognize(config,requests)
+    >>> for response in responses:
+    ...     for result in response:
+    ...         for alternative in result.alternatives:
+    ...             print('=' * 20)
+    ...             print('transcript: ' + alternative.transcript)
+    ...             print('confidence: ' + str(alternative.confidence))
+    ...             print('is_final:' + str(result.is_final))
+    ====================
+    'he'
+    None
+    False
+    ====================
+    'hell'
+    None
+    False
+    ====================
+    'hello'
+    0.973458576
+    True
+
+
+.. _Single Utterance: https://cloud.google.com/speech/reference/rpc/google.cloud.speech.v1beta1#streamingrecognitionconfig
+.. _sync_recognize: https://cloud.google.com/speech/reference/rest/v1beta1/speech/syncrecognize
+.. _Speech Asynchronous Recognize: https://cloud.google.com/speech/reference/rest/v1beta1/speech/asyncrecognize
+
+
+API Reference
+-------------
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1/api
+  gapic/v1/types
+
+A new beta release, spelled ``v1p1beta1``, is provided to provide for preview
+of upcoming features. In order to use this, you will want to import from
+``google.cloud.speech_v1p1beta1`` in lieu of ``google.cloud.speech``.
+
+An API and type reference is provided the first beta also:
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1p1beta1/api
+  gapic/v1p1beta1/types
+
+Changelog
+---------
+
+For a list of all ``google-cloud-speech`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/speech/google/__init__.py b/speech/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/speech/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/speech/google/cloud/__init__.py b/speech/google/cloud/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/speech/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/speech/google/cloud/speech.py b/speech/google/cloud/speech.py
new file mode 100644
index 000000000000..875121e86930
--- /dev/null
+++ b/speech/google/cloud/speech.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.speech_v1 import SpeechClient
+from google.cloud.speech_v1 import enums
+from google.cloud.speech_v1 import types
+
+
+__all__ = ("enums", "types", "SpeechClient")
diff --git a/speech/google/cloud/speech_v1/__init__.py b/speech/google/cloud/speech_v1/__init__.py
new file mode 100644
index 000000000000..81314685022a
--- /dev/null
+++ b/speech/google/cloud/speech_v1/__init__.py
@@ -0,0 +1,30 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.speech_v1.gapic import speech_client
+from google.cloud.speech_v1.gapic import enums
+
+from google.cloud.speech_v1.helpers import SpeechHelpers
+from google.cloud.speech_v1 import types
+
+
+class SpeechClient(SpeechHelpers, speech_client.SpeechClient):
+    __doc__ = speech_client.SpeechClient.__doc__
+    enums = enums
+    types = types
+
+
+__all__ = ("enums", "SpeechClient", "types")
diff --git a/speech/google/cloud/speech_v1/gapic/__init__.py b/speech/google/cloud/speech_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/speech/google/cloud/speech_v1/gapic/enums.py b/speech/google/cloud/speech_v1/gapic/enums.py
new file mode 100644
index 000000000000..ebf2fc95619f
--- /dev/null
+++ b/speech/google/cloud/speech_v1/gapic/enums.py
@@ -0,0 +1,194 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class RecognitionConfig(object):
+    class AudioEncoding(enum.IntEnum):
+        """
+        The encoding of the audio data sent in the request.
+
+        All encodings support only 1 channel (mono) audio.
+
+        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``.
+
+        The ``FLAC`` and ``WAV`` audio file formats include a header that
+        describes the included audio content. You can request recognition for
+        ``WAV`` files that contain either ``LINEAR16`` or ``MULAW`` encoded
+        audio. If you send ``FLAC`` or ``WAV`` audio file format in your
+        request, you do not need to specify an ``AudioEncoding``; the audio
+        encoding format is determined from the file header. If you specify 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`` error code.
+
+        Attributes:
+          ENCODING_UNSPECIFIED (int): Not specified.
+          LINEAR16 (int): Uncompressed 16-bit signed little-endian samples (Linear PCM).
+          FLAC (int): ``FLAC`` (Free Lossless Audio Codec) is the recommended encoding because
+          it is lossless--therefore recognition is not compromised--and requires
+          only about half the bandwidth of ``LINEAR16``. ``FLAC`` stream encoding
+          supports 16-bit and 24-bit samples, however, not all fields in
+          ``STREAMINFO`` are supported.
+          MULAW (int): 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
+          AMR (int): Adaptive Multi-Rate Narrowband codec. ``sample_rate_hertz`` must be
+          8000.
+          AMR_WB (int): Adaptive Multi-Rate Wideband codec. ``sample_rate_hertz`` must be 16000.
+          OGG_OPUS (int): Opus encoded audio frames in Ogg container
+          (`OggOpus <https://wiki.xiph.org/OggOpus>`__). ``sample_rate_hertz``
+          must be one of 8000, 12000, 16000, 24000, or 48000.
+          SPEEX_WITH_HEADER_BYTE (int): Although the use of lossy encodings is not recommended, if a very low
+          bitrate encoding is required, ``OGG_OPUS`` is highly preferred over
+          Speex encoding. The `Speex <https://speex.org/>`__ encoding supported by
+          Cloud Speech API has a header byte in each block, as in MIME type
+          ``audio/x-speex-with-header-byte``. It is a variant of the RTP Speex
+          encoding defined in `RFC 5574 <https://tools.ietf.org/html/rfc5574>`__.
+          The stream is a sequence of blocks, one block per RTP packet. Each block
+          starts with a byte containing the length of the block, in bytes,
+          followed by one or more frames of Speex data, padded to an integral
+          number of bytes (octets) as specified in RFC 5574. In other words, each
+          RTP header is replaced with a single byte containing the block length.
+          Only Speex wideband is supported. ``sample_rate_hertz`` must be 16000.
+        """
+
+        ENCODING_UNSPECIFIED = 0
+        LINEAR16 = 1
+        FLAC = 2
+        MULAW = 3
+        AMR = 4
+        AMR_WB = 5
+        OGG_OPUS = 6
+        SPEEX_WITH_HEADER_BYTE = 7
+
+
+class RecognitionMetadata(object):
+    class InteractionType(enum.IntEnum):
+        """
+        Use case categories that the audio recognition request can be described
+        by.
+
+        Attributes:
+          INTERACTION_TYPE_UNSPECIFIED (int): Use case is either unknown or is something other than one of the other
+          values below.
+          DISCUSSION (int): Multiple people in a conversation or discussion. For example in a
+          meeting with two or more people actively participating. Typically all
+          the primary people speaking would be in the same room (if not, see
+          PHONE\_CALL)
+          PRESENTATION (int): One or more persons lecturing or presenting to others, mostly
+          uninterrupted.
+          PHONE_CALL (int): A phone-call or video-conference in which two or more people, who are
+          not in the same room, are actively participating.
+          VOICEMAIL (int): A recorded message intended for another person to listen to.
+          PROFESSIONALLY_PRODUCED (int): Professionally produced audio (eg. TV Show, Podcast).
+          VOICE_SEARCH (int): Transcribe spoken questions and queries into text.
+          VOICE_COMMAND (int): Transcribe voice commands, such as for controlling a device.
+          DICTATION (int): Transcribe speech to text to create a written document, such as a
+          text-message, email or report.
+        """
+
+        INTERACTION_TYPE_UNSPECIFIED = 0
+        DISCUSSION = 1
+        PRESENTATION = 2
+        PHONE_CALL = 3
+        VOICEMAIL = 4
+        PROFESSIONALLY_PRODUCED = 5
+        VOICE_SEARCH = 6
+        VOICE_COMMAND = 7
+        DICTATION = 8
+
+    class MicrophoneDistance(enum.IntEnum):
+        """
+        Enumerates the types of capture settings describing an audio file.
+
+        Attributes:
+          MICROPHONE_DISTANCE_UNSPECIFIED (int): Audio type is not known.
+          NEARFIELD (int): The audio was captured from a closely placed microphone. Eg. phone,
+          dictaphone, or handheld microphone. Generally if there speaker is within
+          1 meter of the microphone.
+          MIDFIELD (int): The speaker if within 3 meters of the microphone.
+          FARFIELD (int): The speaker is more than 3 meters away from the microphone.
+        """
+
+        MICROPHONE_DISTANCE_UNSPECIFIED = 0
+        NEARFIELD = 1
+        MIDFIELD = 2
+        FARFIELD = 3
+
+    class OriginalMediaType(enum.IntEnum):
+        """
+        The original media the speech was recorded on.
+
+        Attributes:
+          ORIGINAL_MEDIA_TYPE_UNSPECIFIED (int): Unknown original media type.
+          AUDIO (int): The speech data is an audio recording.
+          VIDEO (int): The speech data originally recorded on a video.
+        """
+
+        ORIGINAL_MEDIA_TYPE_UNSPECIFIED = 0
+        AUDIO = 1
+        VIDEO = 2
+
+    class RecordingDeviceType(enum.IntEnum):
+        """
+        The type of device the speech was recorded with.
+
+        Attributes:
+          RECORDING_DEVICE_TYPE_UNSPECIFIED (int): The recording device is unknown.
+          SMARTPHONE (int): Speech was recorded on a smartphone.
+          PC (int): Speech was recorded using a personal computer or tablet.
+          PHONE_LINE (int): Speech was recorded over a phone line.
+          VEHICLE (int): Speech was recorded in a vehicle.
+          OTHER_OUTDOOR_DEVICE (int): Speech was recorded outdoors.
+          OTHER_INDOOR_DEVICE (int): Speech was recorded indoors.
+        """
+
+        RECORDING_DEVICE_TYPE_UNSPECIFIED = 0
+        SMARTPHONE = 1
+        PC = 2
+        PHONE_LINE = 3
+        VEHICLE = 4
+        OTHER_OUTDOOR_DEVICE = 5
+        OTHER_INDOOR_DEVICE = 6
+
+
+class StreamingRecognizeResponse(object):
+    class SpeechEventType(enum.IntEnum):
+        """
+        Indicates the type of speech event.
+
+        Attributes:
+          SPEECH_EVENT_UNSPECIFIED (int): No speech event specified.
+          END_OF_SINGLE_UTTERANCE (int): 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). The client should stop sending additional audio
+          data, half-close the gRPC connection, and wait for any additional
+          results until the server closes the gRPC connection. This event is only
+          sent if ``single_utterance`` was set to ``true``, and is not used
+          otherwise.
+        """
+
+        SPEECH_EVENT_UNSPECIFIED = 0
+        END_OF_SINGLE_UTTERANCE = 1
diff --git a/speech/google/cloud/speech_v1/gapic/speech_client.py b/speech/google/cloud/speech_v1/gapic/speech_client.py
new file mode 100644
index 000000000000..b5bddb0edff8
--- /dev/null
+++ b/speech/google/cloud/speech_v1/gapic/speech_client.py
@@ -0,0 +1,410 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.speech.v1 Speech API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.speech_v1.gapic import enums
+from google.cloud.speech_v1.gapic import speech_client_config
+from google.cloud.speech_v1.gapic.transports import speech_grpc_transport
+from google.cloud.speech_v1.proto import cloud_speech_pb2
+from google.cloud.speech_v1.proto import cloud_speech_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-speech").version
+
+
+class SpeechClient(object):
+    """Service that implements Google Cloud Speech API."""
+
+    SERVICE_ADDRESS = "speech.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.speech.v1.Speech"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            SpeechClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.SpeechGrpcTransport,
+                    Callable[[~.Credentials, type], ~.SpeechGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = speech_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=speech_grpc_transport.SpeechGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = speech_grpc_transport.SpeechGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def recognize(
+        self,
+        config,
+        audio,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Performs synchronous speech recognition: receive results after all audio
+        has been sent and processed.
+
+        Example:
+            >>> from google.cloud import speech_v1
+            >>> from google.cloud.speech_v1 import enums
+            >>>
+            >>> client = speech_v1.SpeechClient()
+            >>>
+            >>> encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+            >>> sample_rate_hertz = 44100
+            >>> language_code = 'en-US'
+            >>> config = {'encoding': encoding, 'sample_rate_hertz': sample_rate_hertz, 'language_code': language_code}
+            >>> uri = 'gs://bucket_name/file_name.flac'
+            >>> audio = {'uri': uri}
+            >>>
+            >>> response = client.recognize(config, audio)
+
+        Args:
+            config (Union[dict, ~google.cloud.speech_v1.types.RecognitionConfig]): *Required* Provides information to the recognizer that specifies how to
+                process the request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1.types.RecognitionConfig`
+            audio (Union[dict, ~google.cloud.speech_v1.types.RecognitionAudio]): *Required* The audio data to be recognized.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1.types.RecognitionAudio`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.speech_v1.types.RecognizeResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "recognize" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "recognize"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.recognize,
+                default_retry=self._method_configs["Recognize"].retry,
+                default_timeout=self._method_configs["Recognize"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_speech_pb2.RecognizeRequest(config=config, audio=audio)
+        return self._inner_api_calls["recognize"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def long_running_recognize(
+        self,
+        config,
+        audio,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import speech_v1
+            >>> from google.cloud.speech_v1 import enums
+            >>>
+            >>> client = speech_v1.SpeechClient()
+            >>>
+            >>> encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+            >>> sample_rate_hertz = 44100
+            >>> language_code = 'en-US'
+            >>> config = {'encoding': encoding, 'sample_rate_hertz': sample_rate_hertz, 'language_code': language_code}
+            >>> uri = 'gs://bucket_name/file_name.flac'
+            >>> audio = {'uri': uri}
+            >>>
+            >>> response = client.long_running_recognize(config, audio)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            config (Union[dict, ~google.cloud.speech_v1.types.RecognitionConfig]): *Required* Provides information to the recognizer that specifies how to
+                process the request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1.types.RecognitionConfig`
+            audio (Union[dict, ~google.cloud.speech_v1.types.RecognitionAudio]): *Required* The audio data to be recognized.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1.types.RecognitionAudio`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.speech_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "long_running_recognize" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "long_running_recognize"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.long_running_recognize,
+                default_retry=self._method_configs["LongRunningRecognize"].retry,
+                default_timeout=self._method_configs["LongRunningRecognize"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_speech_pb2.LongRunningRecognizeRequest(
+            config=config, audio=audio
+        )
+        operation = self._inner_api_calls["long_running_recognize"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_speech_pb2.LongRunningRecognizeResponse,
+            metadata_type=cloud_speech_pb2.LongRunningRecognizeMetadata,
+        )
+
+    def streaming_recognize(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Performs bidirectional streaming speech recognition: receive results while
+        sending audio. This method is only available via the gRPC API (not REST).
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import speech_v1
+            >>>
+            >>> client = speech_v1.SpeechClient()
+            >>>
+            >>> request = {}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.streaming_recognize(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.speech_v1.proto.cloud_speech_pb2.StreamingRecognizeRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.speech_v1.types.StreamingRecognizeRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.speech_v1.types.StreamingRecognizeResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "streaming_recognize" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "streaming_recognize"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.streaming_recognize,
+                default_retry=self._method_configs["StreamingRecognize"].retry,
+                default_timeout=self._method_configs["StreamingRecognize"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["streaming_recognize"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/speech/google/cloud/speech_v1/gapic/speech_client_config.py b/speech/google/cloud/speech_v1/gapic/speech_client_config.py
new file mode 100644
index 000000000000..b54aed26bed8
--- /dev/null
+++ b/speech/google/cloud/speech_v1/gapic/speech_client_config.py
@@ -0,0 +1,38 @@
+config = {
+    "interfaces": {
+        "google.cloud.speech.v1.Speech": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 1000000,
+                    "total_timeout_millis": 5000000,
+                }
+            },
+            "methods": {
+                "Recognize": {
+                    "timeout_millis": 200000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "LongRunningRecognize": {
+                    "timeout_millis": 200000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "StreamingRecognize": {
+                    "timeout_millis": 200000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/speech/google/cloud/speech_v1/gapic/transports/__init__.py b/speech/google/cloud/speech_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/speech/google/cloud/speech_v1/gapic/transports/speech_grpc_transport.py b/speech/google/cloud/speech_v1/gapic/transports/speech_grpc_transport.py
new file mode 100644
index 000000000000..c6eec5114f4c
--- /dev/null
+++ b/speech/google/cloud/speech_v1/gapic/transports/speech_grpc_transport.py
@@ -0,0 +1,158 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.speech_v1.proto import cloud_speech_pb2_grpc
+
+
+class SpeechGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.speech.v1 Speech API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="speech.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"speech_stub": cloud_speech_pb2_grpc.SpeechStub(channel)}
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="speech.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def recognize(self):
+        """Return the gRPC stub for :meth:`SpeechClient.recognize`.
+
+        Performs synchronous speech recognition: receive results after all audio
+        has been sent and processed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["speech_stub"].Recognize
+
+    @property
+    def long_running_recognize(self):
+        """Return the gRPC stub for :meth:`SpeechClient.long_running_recognize`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["speech_stub"].LongRunningRecognize
+
+    @property
+    def streaming_recognize(self):
+        """Return the gRPC stub for :meth:`SpeechClient.streaming_recognize`.
+
+        Performs bidirectional streaming speech recognition: receive results while
+        sending audio. This method is only available via the gRPC API (not REST).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["speech_stub"].StreamingRecognize
diff --git a/speech/google/cloud/speech_v1/helpers.py b/speech/google/cloud/speech_v1/helpers.py
new file mode 100644
index 000000000000..26f17dbe52d3
--- /dev/null
+++ b/speech/google/cloud/speech_v1/helpers.py
@@ -0,0 +1,102 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+import google.api_core.gapic_v1.method
+
+
+class SpeechHelpers(object):
+    """A set of convenience methods to make the Speech client easier to use.
+
+    This class should be considered abstract; it is used as a superclass
+    in a multiple-inheritance construction alongside the applicable GAPIC.
+    See the :class:`~google.cloud.speech_v1.SpeechClient`.
+    """
+
+    def streaming_recognize(
+        self,
+        config,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+    ):
+        """Perform bi-directional speech recognition.
+
+        This method allows you to receive results while sending audio;
+        it is only available via. gRPC (not REST).
+
+        .. warning::
+
+            This method is EXPERIMENTAL. Its interface might change in the
+            future.
+
+        Example:
+          >>> from google.cloud.speech_v1 import enums
+          >>> from google.cloud.speech_v1 import SpeechClient
+          >>> from google.cloud.speech_v1 import types
+          >>> client = SpeechClient()
+          >>> config = types.StreamingRecognitionConfig(
+          ...     config=types.RecognitionConfig(
+          ...         encoding=enums.RecognitionConfig.AudioEncoding.FLAC,
+          ...     ),
+          ... )
+          >>> request = types.StreamingRecognizeRequest(audio_content=b'...')
+          >>> requests = [request]
+          >>> for element in client.streaming_recognize(config, requests):
+          ...     # process element
+          ...     pass
+
+        Args:
+            config (:class:`~.types.StreamingRecognitionConfig`): The
+                configuration to use for the stream.
+            requests (Iterable[:class:`~.types.StreamingRecognizeRequest`]):
+                The input objects.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+
+        Returns:
+          Iterable[:class:`~.types.StreamingRecognizeResponse`]
+
+        Raises:
+          :exc:`google.gax.errors.GaxError` if the RPC is aborted.
+          :exc:`ValueError` if the parameters are invalid.
+        """
+        return super(SpeechHelpers, self).streaming_recognize(
+            self._streaming_request_iterable(config, requests),
+            retry=retry,
+            timeout=timeout,
+        )
+
+    def _streaming_request_iterable(self, config, requests):
+        """A generator that yields the config followed by the requests.
+
+        Args:
+            config (~.speech_v1.types.StreamingRecognitionConfig): The
+                configuration to use for the stream.
+            requests (Iterable[~.speech_v1.types.StreamingRecognizeRequest]):
+                The input objects.
+
+        Returns:
+            Iterable[~.speech_v1.types.StreamingRecognizeRequest]): The
+                correctly formatted input for
+                :meth:`~.speech_v1.SpeechClient.streaming_recognize`.
+        """
+        yield self.types.StreamingRecognizeRequest(streaming_config=config)
+        for request in requests:
+            yield request
diff --git a/speech/google/cloud/speech_v1/proto/__init__.py b/speech/google/cloud/speech_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/speech/google/cloud/speech_v1/proto/cloud_speech.proto b/speech/google/cloud/speech_v1/proto/cloud_speech.proto
new file mode 100644
index 000000000000..90ff515b5f76
--- /dev/null
+++ b/speech/google/cloud/speech_v1/proto/cloud_speech.proto
@@ -0,0 +1,698 @@
+// 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.cloud.speech.v1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/speech/v1;speech";
+option java_multiple_files = true;
+option java_outer_classname = "SpeechProto";
+option java_package = "com.google.cloud.speech.v1";
+
+// Service that implements Google Cloud Speech API.
+service Speech {
+  // Performs synchronous speech recognition: receive results after all audio
+  // has been sent and processed.
+  rpc Recognize(RecognizeRequest) returns (RecognizeResponse) {
+    option (google.api.http) = {
+      post: "/v1/speech:recognize"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1/speech:longrunningrecognize"
+      body: "*"
+    };
+  }
+
+  // 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) {}
+}
+
+// The top-level message sent by the client for the `Recognize` method.
+message RecognizeRequest {
+  // *Required* Provides information to the recognizer that specifies how to
+  // process the request.
+  RecognitionConfig config = 1;
+
+  // *Required* The audio data to be recognized.
+  RecognitionAudio audio = 2;
+}
+
+// The top-level message sent by the client for the `LongRunningRecognize`
+// method.
+message LongRunningRecognizeRequest {
+  // *Required* Provides information to the recognizer that specifies how to
+  // process the request.
+  RecognitionConfig config = 1;
+
+  // *Required* The audio data to be recognized.
+  RecognitionAudio audio = 2;
+}
+
+// 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.
+message StreamingRecognizeRequest {
+  // The streaming request, which is either a streaming config or audio content.
+  oneof streaming_request {
+    // Provides information to the recognizer that specifies how to process the
+    // request. The first `StreamingRecognizeRequest` message must contain a
+    // `streaming_config`  message.
+    StreamingRecognitionConfig streaming_config = 1;
+
+    // The audio data to be recognized. Sequential chunks of audio data are sent
+    // in sequential `StreamingRecognizeRequest` messages. The first
+    // `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
+    // pure binary representation (not base64). See
+    // [content limits](/speech-to-text/quotas#content).
+    bytes audio_content = 2;
+  }
+}
+
+// Provides information to the recognizer that specifies how to process the
+// request.
+message StreamingRecognitionConfig {
+  // *Required* Provides information to the recognizer that specifies how to
+  // process the request.
+  RecognitionConfig config = 1;
+
+  // *Optional* 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
+  // `StreamingRecognitionResult`s with the `is_final` flag set to `true`.
+  //
+  // If `true`, the recognizer 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 recognition. It will return no
+  // more than one `StreamingRecognitionResult` with the `is_final` flag set to
+  // `true`.
+  bool single_utterance = 2;
+
+  // *Optional* 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.
+  bool interim_results = 3;
+}
+
+// Provides information to the recognizer that specifies how to process the
+// request.
+message RecognitionConfig {
+  // The encoding of the audio data sent in the request.
+  //
+  // All encodings support only 1 channel (mono) audio.
+  //
+  // 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`.
+  //
+  // The `FLAC` and `WAV` audio file formats include a header that describes the
+  // included audio content. You can request recognition for `WAV` files that
+  // contain either `LINEAR16` or `MULAW` encoded audio.
+  // If you send `FLAC` or `WAV` audio file format in
+  // your request, you do not need to specify an `AudioEncoding`; the audio
+  // encoding format is determined from the file header. If you specify
+  // 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.
+  enum AudioEncoding {
+    // Not specified.
+    ENCODING_UNSPECIFIED = 0;
+
+    // Uncompressed 16-bit signed little-endian samples (Linear PCM).
+    LINEAR16 = 1;
+
+    // `FLAC` (Free Lossless Audio
+    // Codec) is the recommended encoding because it is
+    // lossless--therefore recognition is not compromised--and
+    // requires only about half the bandwidth of `LINEAR16`. `FLAC` stream
+    // encoding supports 16-bit and 24-bit samples, however, not all fields in
+    // `STREAMINFO` are supported.
+    FLAC = 2;
+
+    // 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
+    MULAW = 3;
+
+    // Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.
+    AMR = 4;
+
+    // Adaptive Multi-Rate Wideband codec. `sample_rate_hertz` must be 16000.
+    AMR_WB = 5;
+
+    // Opus encoded audio frames in Ogg container
+    // ([OggOpus](https://wiki.xiph.org/OggOpus)).
+    // `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.
+    OGG_OPUS = 6;
+
+    // Although the use of lossy encodings is not recommended, if a very low
+    // bitrate encoding is required, `OGG_OPUS` is highly preferred over
+    // Speex encoding. The [Speex](https://speex.org/)  encoding supported by
+    // Cloud Speech API has a header byte in each block, as in MIME type
+    // `audio/x-speex-with-header-byte`.
+    // It is a variant of the RTP Speex encoding defined in
+    // [RFC 5574](https://tools.ietf.org/html/rfc5574).
+    // The stream is a sequence of blocks, one block per RTP packet. Each block
+    // starts with a byte containing the length of the block, in bytes, followed
+    // by one or more frames of Speex data, padded to an integral number of
+    // bytes (octets) as specified in RFC 5574. In other words, each RTP header
+    // is replaced with a single byte containing the block length. Only Speex
+    // wideband is supported. `sample_rate_hertz` must be 16000.
+    SPEEX_WITH_HEADER_BYTE = 7;
+  }
+
+  // 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].
+  AudioEncoding encoding = 1;
+
+  // Sample rate in Hertz of the audio data sent in all
+  // `RecognitionAudio` messages. 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 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].
+  int32 sample_rate_hertz = 2;
+
+  // *Optional* 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'.
+  // Valid value for MULAW, AMR, AMR_WB and SPEEX_WITH_HEADER_BYTE is only `1`.
+  // If `0` or omitted, defaults to one channel (mono).
+  // Note: We only recognize the first channel by default.
+  // To perform independent recognition on each channel set
+  // `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
+  // 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
+  // request is billed cumulatively for all channels recognized:
+  // `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
+  // [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;
+
+  // *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 `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 = 4;
+
+  // *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 profanity_filter = 5;
+
+  // *Optional* 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).
+  repeated SpeechContext speech_contexts = 6;
+
+  // *Optional* 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.
+  // 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* Metadata regarding this request.
+  RecognitionMetadata metadata = 9;
+
+  // *Optional* 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.
+  // <table>
+  //   <tr>
+  //     <td><b>Model</b></td>
+  //     <td><b>Description</b></td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>command_and_search</code></td>
+  //     <td>Best for short queries such as voice commands or voice search.</td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>phone_call</code></td>
+  //     <td>Best for audio that originated from a phone call (typically
+  //     recorded at an 8khz sampling rate).</td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>video</code></td>
+  //     <td>Best for audio that originated from from video or includes multiple
+  //         speakers. Ideally the audio is recorded at a 16khz or greater
+  //         sampling rate. This is a premium model that costs more than the
+  //         standard rate.</td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>default</code></td>
+  //     <td>Best for audio that is not one of the specific audio models.
+  //         For example, long-form audio. Ideally the audio is high-fidelity,
+  //         recorded at a 16khz or greater sampling rate.</td>
+  //   </tr>
+  // </table>
+  string model = 13;
+
+  // *Optional* 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.
+  //
+  // If `use_enhanced` is true and an enhanced version of the specified model
+  // does not exist, then the speech is recognized using the standard version
+  // of the specified model.
+  bool use_enhanced = 14;
+}
+
+// Description of audio data to be recognized.
+message RecognitionMetadata {
+  // Use case categories that the audio recognition request can be described
+  // by.
+  enum InteractionType {
+    // Use case is either unknown or is something other than one of the other
+    // values below.
+    INTERACTION_TYPE_UNSPECIFIED = 0;
+
+    // Multiple people in a conversation or discussion. For example in a
+    // meeting with two or more people actively participating. Typically
+    // all the primary people speaking would be in the same room (if not,
+    // see PHONE_CALL)
+    DISCUSSION = 1;
+
+    // One or more persons lecturing or presenting to others, mostly
+    // uninterrupted.
+    PRESENTATION = 2;
+
+    // A phone-call or video-conference in which two or more people, who are
+    // not in the same room, are actively participating.
+    PHONE_CALL = 3;
+
+    // A recorded message intended for another person to listen to.
+    VOICEMAIL = 4;
+
+    // Professionally produced audio (eg. TV Show, Podcast).
+    PROFESSIONALLY_PRODUCED = 5;
+
+    // Transcribe spoken questions and queries into text.
+    VOICE_SEARCH = 6;
+
+    // Transcribe voice commands, such as for controlling a device.
+    VOICE_COMMAND = 7;
+
+    // Transcribe speech to text to create a written document, such as a
+    // text-message, email or report.
+    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.
+    MICROPHONE_DISTANCE_UNSPECIFIED = 0;
+
+    // The audio was captured from a closely placed microphone. Eg. phone,
+    // dictaphone, or handheld microphone. Generally if there speaker is within
+    // 1 meter of the microphone.
+    NEARFIELD = 1;
+
+    // The speaker if within 3 meters of the microphone.
+    MIDFIELD = 2;
+
+    // The speaker is more than 3 meters away from the microphone.
+    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.
+    ORIGINAL_MEDIA_TYPE_UNSPECIFIED = 0;
+
+    // The speech data is an audio recording.
+    AUDIO = 1;
+
+    // The speech data originally recorded on a video.
+    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.
+    RECORDING_DEVICE_TYPE_UNSPECIFIED = 0;
+
+    // Speech was recorded on a smartphone.
+    SMARTPHONE = 1;
+
+    // Speech was recorded using a personal computer or tablet.
+    PC = 2;
+
+    // Speech was recorded over a phone line.
+    PHONE_LINE = 3;
+
+    // Speech was recorded in a vehicle.
+    VEHICLE = 4;
+
+    // Speech was recorded outdoors.
+    OTHER_OUTDOOR_DEVICE = 5;
+
+    // Speech was recorded indoors.
+    OTHER_INDOOR_DEVICE = 6;
+  }
+
+  // The type of device the speech was recorded with.
+  RecordingDeviceType recording_device_type = 6;
+
+  // The device used to make the recording.  Examples 'Nexus 5X' or
+  // 'Polycom SoundStation IP 6000' or 'POTS' or 'VoIP' or
+  // 'Cardioid Microphone'.
+  string recording_device_name = 7;
+
+  // Mime type of the original audio file.  For example `audio/m4a`,
+  // `audio/x-alaw-basic`, `audio/mp3`, `audio/3gpp`.
+  // A list of possible audio mime types is maintained at
+  // http://www.iana.org/assignments/media-types/media-types.xhtml#audio
+  string original_mime_type = 8;
+
+  // Description of the content. Eg. "Recordings of federal supreme court
+  // hearings from 2012".
+  string audio_topic = 10;
+}
+
+// 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
+  // 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).
+  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).
+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
+    // pure binary representation, whereas JSON representations use base64.
+    bytes content = 1;
+
+    // URI that points to a file that contains audio data bytes as specified in
+    // `RecognitionConfig`. The file must not be compressed (for example, gzip).
+    // 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).
+    string uri = 2;
+  }
+}
+
+// The only message returned to the client by the `Recognize` method. It
+// contains the result as zero or more sequential `SpeechRecognitionResult`
+// messages.
+message RecognizeResponse {
+  // Output only. Sequential list of transcription results corresponding to
+  // sequential portions of audio.
+  repeated SpeechRecognitionResult results = 2;
+}
+
+// The only message returned to the client by the `LongRunningRecognize` method.
+// It contains the result as zero or more sequential `SpeechRecognitionResult`
+// messages. It is included in the `result.response` field of the `Operation`
+// returned by the `GetOperation` call of the `google::longrunning::Operations`
+// service.
+message LongRunningRecognizeResponse {
+  // Output only. Sequential list of transcription results corresponding to
+  // sequential portions of audio.
+  repeated SpeechRecognitionResult results = 2;
+}
+
+// Describes the progress of a long-running `LongRunningRecognize` call. It is
+// included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message LongRunningRecognizeMetadata {
+  // Approximate percentage of audio processed thus far. Guaranteed to be 100
+  // when the audio is fully processed and the results are available.
+  int32 progress_percent = 1;
+
+  // Time when the request was received.
+  google.protobuf.Timestamp start_time = 2;
+
+  // Time of the most recent processing update.
+  google.protobuf.Timestamp last_update_time = 3;
+}
+
+// `StreamingRecognizeResponse` is the only message returned to the client by
+// `StreamingRecognize`. A series of zero or more `StreamingRecognizeResponse`
+// messages are streamed back to the client. If there is no recognizable
+// audio, and `single_utterance` is set to false, then no messages are streamed
+// back to the client.
+//
+// Here's an example of a series of ten `StreamingRecognizeResponse`s that might
+// be returned while processing audio:
+//
+// 1. results { alternatives { transcript: "tube" } stability: 0.01 }
+//
+// 2. results { alternatives { transcript: "to be a" } stability: 0.01 }
+//
+// 3. results { alternatives { transcript: "to be" } stability: 0.9 }
+//    results { alternatives { transcript: " or not to be" } stability: 0.01 }
+//
+// 4. results { alternatives { transcript: "to be or not to be"
+//                             confidence: 0.92 }
+//              alternatives { transcript: "to bee or not to bee" }
+//              is_final: true }
+//
+// 5. results { alternatives { transcript: " that's" } stability: 0.01 }
+//
+// 6. results { alternatives { transcript: " that is" } stability: 0.9 }
+//    results { alternatives { transcript: " the question" } stability: 0.01 }
+//
+// 7. results { alternatives { transcript: " that is the question"
+//                             confidence: 0.98 }
+//              alternatives { transcript: " that was the question" }
+//              is_final: true }
+//
+// Notes:
+//
+// - Only two of the above responses #4 and #7 contain final results; they are
+//   indicated by `is_final: true`. Concatenating these together generates the
+//   full transcript: "to be or not to be that is the question".
+//
+// - The others contain interim `results`. #3 and #6 contain two interim
+//   `results`: the first portion has a high stability and is less likely to
+//   change; the second portion has a low stability and is very likely to
+//   change. A UI designer might choose to show only high stability `results`.
+//
+// - The specific `stability` and `confidence` values shown above are only for
+//   illustrative purposes. Actual values may vary.
+//
+// - In each response, only one of these fields will be set:
+//     `error`,
+//     `speech_event_type`, or
+//     one or more (repeated) `results`.
+message StreamingRecognizeResponse {
+  // Indicates the type of speech event.
+  enum SpeechEventType {
+    // No speech event specified.
+    SPEECH_EVENT_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). The client should stop sending additional audio
+    // data, half-close the gRPC connection, and wait for any additional results
+    // until the server closes the gRPC connection. 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;
+
+  // Output only. 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.
+  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
+  // 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
+  // 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
+  // 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
+  // beginning of the audio.
+  google.protobuf.Duration result_end_time = 4;
+
+  // For multi-channel audio, this is the channel number corresponding to the
+  // recognized result for the audio from that channel.
+  // 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;
+}
+
+// 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
+  // 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;
+
+  // For multi-channel audio, this is the channel number corresponding to the
+  // recognized result for the audio from that channel.
+  // For audio_channel_count = N, its output values can range from '1' to 'N'.
+  int32 channel_tag = 2;
+}
+
+// Alternative hypotheses (a.k.a. n-best list).
+message SpeechRecognitionAlternative {
+  // Output only. 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
+  // 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`.
+  // 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;
+
+  // 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;
+}
+
+// Word-specific information for recognized words.
+message WordInfo {
+  // Output only. 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.
+  // This is an experimental feature and the accuracy of the time offset can
+  // vary.
+  google.protobuf.Duration start_time = 1;
+
+  // Output only. 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.
+  // This is an experimental feature and the accuracy of the time offset can
+  // vary.
+  google.protobuf.Duration end_time = 2;
+
+  // Output only. The word corresponding to this set of information.
+  string word = 3;
+}
diff --git a/speech/google/cloud/speech_v1/proto/cloud_speech_pb2.py b/speech/google/cloud/speech_v1/proto/cloud_speech_pb2.py
new file mode 100644
index 000000000000..e2667403c18c
--- /dev/null
+++ b/speech/google/cloud/speech_v1/proto/cloud_speech_pb2.py
@@ -0,0 +1,2439 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/speech_v1/proto/cloud_speech.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/speech_v1/proto/cloud_speech.proto",
+    package="google.cloud.speech.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.speech.v1B\013SpeechProtoP\001Z<google.golang.org/genproto/googleapis/cloud/speech/v1;speech\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/speech_v1/proto/cloud_speech.proto\x12\x16google.cloud.speech.v1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\x86\x01\n\x10RecognizeRequest\x12\x39\n\x06\x63onfig\x18\x01 \x01(\x0b\x32).google.cloud.speech.v1.RecognitionConfig\x12\x37\n\x05\x61udio\x18\x02 \x01(\x0b\x32(.google.cloud.speech.v1.RecognitionAudio"\x91\x01\n\x1bLongRunningRecognizeRequest\x12\x39\n\x06\x63onfig\x18\x01 \x01(\x0b\x32).google.cloud.speech.v1.RecognitionConfig\x12\x37\n\x05\x61udio\x18\x02 \x01(\x0b\x32(.google.cloud.speech.v1.RecognitionAudio"\x99\x01\n\x19StreamingRecognizeRequest\x12N\n\x10streaming_config\x18\x01 \x01(\x0b\x32\x32.google.cloud.speech.v1.StreamingRecognitionConfigH\x00\x12\x17\n\raudio_content\x18\x02 \x01(\x0cH\x00\x42\x13\n\x11streaming_request"\x8a\x01\n\x1aStreamingRecognitionConfig\x12\x39\n\x06\x63onfig\x18\x01 \x01(\x0b\x32).google.cloud.speech.v1.RecognitionConfig\x12\x18\n\x10single_utterance\x18\x02 \x01(\x08\x12\x17\n\x0finterim_results\x18\x03 \x01(\x08"\x8c\x05\n\x11RecognitionConfig\x12I\n\x08\x65ncoding\x18\x01 \x01(\x0e\x32\x37.google.cloud.speech.v1.RecognitionConfig.AudioEncoding\x12\x19\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x12\x1b\n\x13\x61udio_channel_count\x18\x07 \x01(\x05\x12/\n\'enable_separate_recognition_per_channel\x18\x0c \x01(\x08\x12\x15\n\rlanguage_code\x18\x03 \x01(\t\x12\x18\n\x10max_alternatives\x18\x04 \x01(\x05\x12\x18\n\x10profanity_filter\x18\x05 \x01(\x08\x12>\n\x0fspeech_contexts\x18\x06 \x03(\x0b\x32%.google.cloud.speech.v1.SpeechContext\x12 \n\x18\x65nable_word_time_offsets\x18\x08 \x01(\x08\x12$\n\x1c\x65nable_automatic_punctuation\x18\x0b \x01(\x08\x12=\n\x08metadata\x18\t \x01(\x0b\x32+.google.cloud.speech.v1.RecognitionMetadata\x12\r\n\x05model\x18\r \x01(\t\x12\x14\n\x0cuse_enhanced\x18\x0e \x01(\x08"\x8b\x01\n\rAudioEncoding\x12\x18\n\x14\x45NCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\x08\n\x04\x46LAC\x10\x02\x12\t\n\x05MULAW\x10\x03\x12\x07\n\x03\x41MR\x10\x04\x12\n\n\x06\x41MR_WB\x10\x05\x12\x0c\n\x08OGG_OPUS\x10\x06\x12\x1a\n\x16SPEEX_WITH_HEADER_BYTE\x10\x07"\xa0\x08\n\x13RecognitionMetadata\x12U\n\x10interaction_type\x18\x01 \x01(\x0e\x32;.google.cloud.speech.v1.RecognitionMetadata.InteractionType\x12$\n\x1cindustry_naics_code_of_audio\x18\x03 \x01(\r\x12[\n\x13microphone_distance\x18\x04 \x01(\x0e\x32>.google.cloud.speech.v1.RecognitionMetadata.MicrophoneDistance\x12Z\n\x13original_media_type\x18\x05 \x01(\x0e\x32=.google.cloud.speech.v1.RecognitionMetadata.OriginalMediaType\x12^\n\x15recording_device_type\x18\x06 \x01(\x0e\x32?.google.cloud.speech.v1.RecognitionMetadata.RecordingDeviceType\x12\x1d\n\x15recording_device_name\x18\x07 \x01(\t\x12\x1a\n\x12original_mime_type\x18\x08 \x01(\t\x12\x13\n\x0b\x61udio_topic\x18\n \x01(\t"\xc5\x01\n\x0fInteractionType\x12 \n\x1cINTERACTION_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nDISCUSSION\x10\x01\x12\x10\n\x0cPRESENTATION\x10\x02\x12\x0e\n\nPHONE_CALL\x10\x03\x12\r\n\tVOICEMAIL\x10\x04\x12\x1b\n\x17PROFESSIONALLY_PRODUCED\x10\x05\x12\x10\n\x0cVOICE_SEARCH\x10\x06\x12\x11\n\rVOICE_COMMAND\x10\x07\x12\r\n\tDICTATION\x10\x08"d\n\x12MicrophoneDistance\x12#\n\x1fMICROPHONE_DISTANCE_UNSPECIFIED\x10\x00\x12\r\n\tNEARFIELD\x10\x01\x12\x0c\n\x08MIDFIELD\x10\x02\x12\x0c\n\x08\x46\x41RFIELD\x10\x03"N\n\x11OriginalMediaType\x12#\n\x1fORIGINAL_MEDIA_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x41UDIO\x10\x01\x12\t\n\x05VIDEO\x10\x02"\xa4\x01\n\x13RecordingDeviceType\x12%\n!RECORDING_DEVICE_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nSMARTPHONE\x10\x01\x12\x06\n\x02PC\x10\x02\x12\x0e\n\nPHONE_LINE\x10\x03\x12\x0b\n\x07VEHICLE\x10\x04\x12\x18\n\x14OTHER_OUTDOOR_DEVICE\x10\x05\x12\x17\n\x13OTHER_INDOOR_DEVICE\x10\x06" \n\rSpeechContext\x12\x0f\n\x07phrases\x18\x01 \x03(\t"D\n\x10RecognitionAudio\x12\x11\n\x07\x63ontent\x18\x01 \x01(\x0cH\x00\x12\r\n\x03uri\x18\x02 \x01(\tH\x00\x42\x0e\n\x0c\x61udio_source"U\n\x11RecognizeResponse\x12@\n\x07results\x18\x02 \x03(\x0b\x32/.google.cloud.speech.v1.SpeechRecognitionResult"`\n\x1cLongRunningRecognizeResponse\x12@\n\x07results\x18\x02 \x03(\x0b\x32/.google.cloud.speech.v1.SpeechRecognitionResult"\x9e\x01\n\x1cLongRunningRecognizeMetadata\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x10last_update_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xb1\x02\n\x1aStreamingRecognizeResponse\x12!\n\x05\x65rror\x18\x01 \x01(\x0b\x32\x12.google.rpc.Status\x12\x43\n\x07results\x18\x02 \x03(\x0b\x32\x32.google.cloud.speech.v1.StreamingRecognitionResult\x12]\n\x11speech_event_type\x18\x04 \x01(\x0e\x32\x42.google.cloud.speech.v1.StreamingRecognizeResponse.SpeechEventType"L\n\x0fSpeechEventType\x12\x1c\n\x18SPEECH_EVENT_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x45ND_OF_SINGLE_UTTERANCE\x10\x01"\xed\x01\n\x1aStreamingRecognitionResult\x12J\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32\x34.google.cloud.speech.v1.SpeechRecognitionAlternative\x12\x10\n\x08is_final\x18\x02 \x01(\x08\x12\x11\n\tstability\x18\x03 \x01(\x02\x12\x32\n\x0fresult_end_time\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x13\n\x0b\x63hannel_tag\x18\x05 \x01(\x05\x12\x15\n\rlanguage_code\x18\x06 \x01(\t"z\n\x17SpeechRecognitionResult\x12J\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32\x34.google.cloud.speech.v1.SpeechRecognitionAlternative\x12\x13\n\x0b\x63hannel_tag\x18\x02 \x01(\x05"w\n\x1cSpeechRecognitionAlternative\x12\x12\n\ntranscript\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12/\n\x05words\x18\x03 \x03(\x0b\x32 .google.cloud.speech.v1.WordInfo"t\n\x08WordInfo\x12-\n\nstart_time\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12+\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x0c\n\x04word\x18\x03 \x01(\t2\xa9\x03\n\x06Speech\x12\x81\x01\n\tRecognize\x12(.google.cloud.speech.v1.RecognizeRequest\x1a).google.cloud.speech.v1.RecognizeResponse"\x1f\x82\xd3\xe4\x93\x02\x19"\x14/v1/speech:recognize:\x01*\x12\x96\x01\n\x14LongRunningRecognize\x12\x33.google.cloud.speech.v1.LongRunningRecognizeRequest\x1a\x1d.google.longrunning.Operation"*\x82\xd3\xe4\x93\x02$"\x1f/v1/speech:longrunningrecognize:\x01*\x12\x81\x01\n\x12StreamingRecognize\x12\x31.google.cloud.speech.v1.StreamingRecognizeRequest\x1a\x32.google.cloud.speech.v1.StreamingRecognizeResponse"\x00(\x01\x30\x01\x42l\n\x1a\x63om.google.cloud.speech.v1B\x0bSpeechProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/speech/v1;speech\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_RECOGNITIONCONFIG_AUDIOENCODING = _descriptor.EnumDescriptor(
+    name="AudioEncoding",
+    full_name="google.cloud.speech.v1.RecognitionConfig.AudioEncoding",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ENCODING_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINEAR16", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLAC", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MULAW", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AMR", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AMR_WB", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OGG_OPUS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPEEX_WITH_HEADER_BYTE",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1328,
+    serialized_end=1467,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONCONFIG_AUDIOENCODING)
+
+_RECOGNITIONMETADATA_INTERACTIONTYPE = _descriptor.EnumDescriptor(
+    name="InteractionType",
+    full_name="google.cloud.speech.v1.RecognitionMetadata.InteractionType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="INTERACTION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISCUSSION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRESENTATION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PHONE_CALL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICEMAIL", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROFESSIONALLY_PRODUCED",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICE_SEARCH", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICE_COMMAND", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DICTATION", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1980,
+    serialized_end=2177,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_INTERACTIONTYPE)
+
+_RECOGNITIONMETADATA_MICROPHONEDISTANCE = _descriptor.EnumDescriptor(
+    name="MicrophoneDistance",
+    full_name="google.cloud.speech.v1.RecognitionMetadata.MicrophoneDistance",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MICROPHONE_DISTANCE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEARFIELD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDFIELD", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FARFIELD", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2179,
+    serialized_end=2279,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_MICROPHONEDISTANCE)
+
+_RECOGNITIONMETADATA_ORIGINALMEDIATYPE = _descriptor.EnumDescriptor(
+    name="OriginalMediaType",
+    full_name="google.cloud.speech.v1.RecognitionMetadata.OriginalMediaType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ORIGINAL_MEDIA_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUDIO", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2281,
+    serialized_end=2359,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_ORIGINALMEDIATYPE)
+
+_RECOGNITIONMETADATA_RECORDINGDEVICETYPE = _descriptor.EnumDescriptor(
+    name="RecordingDeviceType",
+    full_name="google.cloud.speech.v1.RecognitionMetadata.RecordingDeviceType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RECORDING_DEVICE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SMARTPHONE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PC", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PHONE_LINE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VEHICLE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_OUTDOOR_DEVICE",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_INDOOR_DEVICE",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2362,
+    serialized_end=2526,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_RECORDINGDEVICETYPE)
+
+_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE = _descriptor.EnumDescriptor(
+    name="SpeechEventType",
+    full_name="google.cloud.speech.v1.StreamingRecognizeResponse.SpeechEventType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SPEECH_EVENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="END_OF_SINGLE_UTTERANCE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3208,
+    serialized_end=3284,
+)
+_sym_db.RegisterEnumDescriptor(_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE)
+
+
+_RECOGNIZEREQUEST = _descriptor.Descriptor(
+    name="RecognizeRequest",
+    full_name="google.cloud.speech.v1.RecognizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.speech.v1.RecognizeRequest.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio",
+            full_name="google.cloud.speech.v1.RecognizeRequest.audio",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=233,
+    serialized_end=367,
+)
+
+
+_LONGRUNNINGRECOGNIZEREQUEST = _descriptor.Descriptor(
+    name="LongRunningRecognizeRequest",
+    full_name="google.cloud.speech.v1.LongRunningRecognizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.speech.v1.LongRunningRecognizeRequest.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio",
+            full_name="google.cloud.speech.v1.LongRunningRecognizeRequest.audio",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=370,
+    serialized_end=515,
+)
+
+
+_STREAMINGRECOGNIZEREQUEST = _descriptor.Descriptor(
+    name="StreamingRecognizeRequest",
+    full_name="google.cloud.speech.v1.StreamingRecognizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="streaming_config",
+            full_name="google.cloud.speech.v1.StreamingRecognizeRequest.streaming_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_content",
+            full_name="google.cloud.speech.v1.StreamingRecognizeRequest.audio_content",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="streaming_request",
+            full_name="google.cloud.speech.v1.StreamingRecognizeRequest.streaming_request",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=518,
+    serialized_end=671,
+)
+
+
+_STREAMINGRECOGNITIONCONFIG = _descriptor.Descriptor(
+    name="StreamingRecognitionConfig",
+    full_name="google.cloud.speech.v1.StreamingRecognitionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.speech.v1.StreamingRecognitionConfig.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="single_utterance",
+            full_name="google.cloud.speech.v1.StreamingRecognitionConfig.single_utterance",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interim_results",
+            full_name="google.cloud.speech.v1.StreamingRecognitionConfig.interim_results",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=674,
+    serialized_end=812,
+)
+
+
+_RECOGNITIONCONFIG = _descriptor.Descriptor(
+    name="RecognitionConfig",
+    full_name="google.cloud.speech.v1.RecognitionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="encoding",
+            full_name="google.cloud.speech.v1.RecognitionConfig.encoding",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sample_rate_hertz",
+            full_name="google.cloud.speech.v1.RecognitionConfig.sample_rate_hertz",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_channel_count",
+            full_name="google.cloud.speech.v1.RecognitionConfig.audio_channel_count",
+            index=2,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_separate_recognition_per_channel",
+            full_name="google.cloud.speech.v1.RecognitionConfig.enable_separate_recognition_per_channel",
+            index=3,
+            number=12,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.speech.v1.RecognitionConfig.language_code",
+            index=4,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_alternatives",
+            full_name="google.cloud.speech.v1.RecognitionConfig.max_alternatives",
+            index=5,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profanity_filter",
+            full_name="google.cloud.speech.v1.RecognitionConfig.profanity_filter",
+            index=6,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_contexts",
+            full_name="google.cloud.speech.v1.RecognitionConfig.speech_contexts",
+            index=7,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_word_time_offsets",
+            full_name="google.cloud.speech.v1.RecognitionConfig.enable_word_time_offsets",
+            index=8,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_automatic_punctuation",
+            full_name="google.cloud.speech.v1.RecognitionConfig.enable_automatic_punctuation",
+            index=9,
+            number=11,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.speech.v1.RecognitionConfig.metadata",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.speech.v1.RecognitionConfig.model",
+            index=11,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="use_enhanced",
+            full_name="google.cloud.speech.v1.RecognitionConfig.use_enhanced",
+            index=12,
+            number=14,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_RECOGNITIONCONFIG_AUDIOENCODING],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=815,
+    serialized_end=1467,
+)
+
+
+_RECOGNITIONMETADATA = _descriptor.Descriptor(
+    name="RecognitionMetadata",
+    full_name="google.cloud.speech.v1.RecognitionMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="interaction_type",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.interaction_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="industry_naics_code_of_audio",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.industry_naics_code_of_audio",
+            index=1,
+            number=3,
+            type=13,
+            cpp_type=3,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="microphone_distance",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.microphone_distance",
+            index=2,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="original_media_type",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.original_media_type",
+            index=3,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recording_device_type",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.recording_device_type",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recording_device_name",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.recording_device_name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="original_mime_type",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.original_mime_type",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_topic",
+            full_name="google.cloud.speech.v1.RecognitionMetadata.audio_topic",
+            index=7,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _RECOGNITIONMETADATA_INTERACTIONTYPE,
+        _RECOGNITIONMETADATA_MICROPHONEDISTANCE,
+        _RECOGNITIONMETADATA_ORIGINALMEDIATYPE,
+        _RECOGNITIONMETADATA_RECORDINGDEVICETYPE,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1470,
+    serialized_end=2526,
+)
+
+
+_SPEECHCONTEXT = _descriptor.Descriptor(
+    name="SpeechContext",
+    full_name="google.cloud.speech.v1.SpeechContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="phrases",
+            full_name="google.cloud.speech.v1.SpeechContext.phrases",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2528,
+    serialized_end=2560,
+)
+
+
+_RECOGNITIONAUDIO = _descriptor.Descriptor(
+    name="RecognitionAudio",
+    full_name="google.cloud.speech.v1.RecognitionAudio",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.speech.v1.RecognitionAudio.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.speech.v1.RecognitionAudio.uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="audio_source",
+            full_name="google.cloud.speech.v1.RecognitionAudio.audio_source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2562,
+    serialized_end=2630,
+)
+
+
+_RECOGNIZERESPONSE = _descriptor.Descriptor(
+    name="RecognizeResponse",
+    full_name="google.cloud.speech.v1.RecognizeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.speech.v1.RecognizeResponse.results",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2632,
+    serialized_end=2717,
+)
+
+
+_LONGRUNNINGRECOGNIZERESPONSE = _descriptor.Descriptor(
+    name="LongRunningRecognizeResponse",
+    full_name="google.cloud.speech.v1.LongRunningRecognizeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.speech.v1.LongRunningRecognizeResponse.results",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2719,
+    serialized_end=2815,
+)
+
+
+_LONGRUNNINGRECOGNIZEMETADATA = _descriptor.Descriptor(
+    name="LongRunningRecognizeMetadata",
+    full_name="google.cloud.speech.v1.LongRunningRecognizeMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.speech.v1.LongRunningRecognizeMetadata.progress_percent",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.speech.v1.LongRunningRecognizeMetadata.start_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_update_time",
+            full_name="google.cloud.speech.v1.LongRunningRecognizeMetadata.last_update_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2818,
+    serialized_end=2976,
+)
+
+
+_STREAMINGRECOGNIZERESPONSE = _descriptor.Descriptor(
+    name="StreamingRecognizeResponse",
+    full_name="google.cloud.speech.v1.StreamingRecognizeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.speech.v1.StreamingRecognizeResponse.error",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.speech.v1.StreamingRecognizeResponse.results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_event_type",
+            full_name="google.cloud.speech.v1.StreamingRecognizeResponse.speech_event_type",
+            index=2,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2979,
+    serialized_end=3284,
+)
+
+
+_STREAMINGRECOGNITIONRESULT = _descriptor.Descriptor(
+    name="StreamingRecognitionResult",
+    full_name="google.cloud.speech.v1.StreamingRecognitionResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.speech.v1.StreamingRecognitionResult.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_final",
+            full_name="google.cloud.speech.v1.StreamingRecognitionResult.is_final",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stability",
+            full_name="google.cloud.speech.v1.StreamingRecognitionResult.stability",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result_end_time",
+            full_name="google.cloud.speech.v1.StreamingRecognitionResult.result_end_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="channel_tag",
+            full_name="google.cloud.speech.v1.StreamingRecognitionResult.channel_tag",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.speech.v1.StreamingRecognitionResult.language_code",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3287,
+    serialized_end=3524,
+)
+
+
+_SPEECHRECOGNITIONRESULT = _descriptor.Descriptor(
+    name="SpeechRecognitionResult",
+    full_name="google.cloud.speech.v1.SpeechRecognitionResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.speech.v1.SpeechRecognitionResult.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="channel_tag",
+            full_name="google.cloud.speech.v1.SpeechRecognitionResult.channel_tag",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3526,
+    serialized_end=3648,
+)
+
+
+_SPEECHRECOGNITIONALTERNATIVE = _descriptor.Descriptor(
+    name="SpeechRecognitionAlternative",
+    full_name="google.cloud.speech.v1.SpeechRecognitionAlternative",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transcript",
+            full_name="google.cloud.speech.v1.SpeechRecognitionAlternative.transcript",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.speech.v1.SpeechRecognitionAlternative.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.speech.v1.SpeechRecognitionAlternative.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3650,
+    serialized_end=3769,
+)
+
+
+_WORDINFO = _descriptor.Descriptor(
+    name="WordInfo",
+    full_name="google.cloud.speech.v1.WordInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.speech.v1.WordInfo.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.speech.v1.WordInfo.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="word",
+            full_name="google.cloud.speech.v1.WordInfo.word",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3771,
+    serialized_end=3887,
+)
+
+_RECOGNIZEREQUEST.fields_by_name["config"].message_type = _RECOGNITIONCONFIG
+_RECOGNIZEREQUEST.fields_by_name["audio"].message_type = _RECOGNITIONAUDIO
+_LONGRUNNINGRECOGNIZEREQUEST.fields_by_name["config"].message_type = _RECOGNITIONCONFIG
+_LONGRUNNINGRECOGNIZEREQUEST.fields_by_name["audio"].message_type = _RECOGNITIONAUDIO
+_STREAMINGRECOGNIZEREQUEST.fields_by_name[
+    "streaming_config"
+].message_type = _STREAMINGRECOGNITIONCONFIG
+_STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"].fields.append(
+    _STREAMINGRECOGNIZEREQUEST.fields_by_name["streaming_config"]
+)
+_STREAMINGRECOGNIZEREQUEST.fields_by_name[
+    "streaming_config"
+].containing_oneof = _STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"]
+_STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"].fields.append(
+    _STREAMINGRECOGNIZEREQUEST.fields_by_name["audio_content"]
+)
+_STREAMINGRECOGNIZEREQUEST.fields_by_name[
+    "audio_content"
+].containing_oneof = _STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"]
+_STREAMINGRECOGNITIONCONFIG.fields_by_name["config"].message_type = _RECOGNITIONCONFIG
+_RECOGNITIONCONFIG.fields_by_name[
+    "encoding"
+].enum_type = _RECOGNITIONCONFIG_AUDIOENCODING
+_RECOGNITIONCONFIG.fields_by_name["speech_contexts"].message_type = _SPEECHCONTEXT
+_RECOGNITIONCONFIG.fields_by_name["metadata"].message_type = _RECOGNITIONMETADATA
+_RECOGNITIONCONFIG_AUDIOENCODING.containing_type = _RECOGNITIONCONFIG
+_RECOGNITIONMETADATA.fields_by_name[
+    "interaction_type"
+].enum_type = _RECOGNITIONMETADATA_INTERACTIONTYPE
+_RECOGNITIONMETADATA.fields_by_name[
+    "microphone_distance"
+].enum_type = _RECOGNITIONMETADATA_MICROPHONEDISTANCE
+_RECOGNITIONMETADATA.fields_by_name[
+    "original_media_type"
+].enum_type = _RECOGNITIONMETADATA_ORIGINALMEDIATYPE
+_RECOGNITIONMETADATA.fields_by_name[
+    "recording_device_type"
+].enum_type = _RECOGNITIONMETADATA_RECORDINGDEVICETYPE
+_RECOGNITIONMETADATA_INTERACTIONTYPE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONMETADATA_MICROPHONEDISTANCE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONMETADATA_ORIGINALMEDIATYPE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONMETADATA_RECORDINGDEVICETYPE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONAUDIO.oneofs_by_name["audio_source"].fields.append(
+    _RECOGNITIONAUDIO.fields_by_name["content"]
+)
+_RECOGNITIONAUDIO.fields_by_name[
+    "content"
+].containing_oneof = _RECOGNITIONAUDIO.oneofs_by_name["audio_source"]
+_RECOGNITIONAUDIO.oneofs_by_name["audio_source"].fields.append(
+    _RECOGNITIONAUDIO.fields_by_name["uri"]
+)
+_RECOGNITIONAUDIO.fields_by_name[
+    "uri"
+].containing_oneof = _RECOGNITIONAUDIO.oneofs_by_name["audio_source"]
+_RECOGNIZERESPONSE.fields_by_name["results"].message_type = _SPEECHRECOGNITIONRESULT
+_LONGRUNNINGRECOGNIZERESPONSE.fields_by_name[
+    "results"
+].message_type = _SPEECHRECOGNITIONRESULT
+_LONGRUNNINGRECOGNIZEMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LONGRUNNINGRECOGNIZEMETADATA.fields_by_name[
+    "last_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STREAMINGRECOGNIZERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_STREAMINGRECOGNIZERESPONSE.fields_by_name[
+    "results"
+].message_type = _STREAMINGRECOGNITIONRESULT
+_STREAMINGRECOGNIZERESPONSE.fields_by_name[
+    "speech_event_type"
+].enum_type = _STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE
+_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE.containing_type = (
+    _STREAMINGRECOGNIZERESPONSE
+)
+_STREAMINGRECOGNITIONRESULT.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_STREAMINGRECOGNITIONRESULT.fields_by_name[
+    "result_end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_SPEECHRECOGNITIONRESULT.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_SPEECHRECOGNITIONALTERNATIVE.fields_by_name["words"].message_type = _WORDINFO
+_WORDINFO.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_WORDINFO.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["RecognizeRequest"] = _RECOGNIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "LongRunningRecognizeRequest"
+] = _LONGRUNNINGRECOGNIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognizeRequest"
+] = _STREAMINGRECOGNIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognitionConfig"
+] = _STREAMINGRECOGNITIONCONFIG
+DESCRIPTOR.message_types_by_name["RecognitionConfig"] = _RECOGNITIONCONFIG
+DESCRIPTOR.message_types_by_name["RecognitionMetadata"] = _RECOGNITIONMETADATA
+DESCRIPTOR.message_types_by_name["SpeechContext"] = _SPEECHCONTEXT
+DESCRIPTOR.message_types_by_name["RecognitionAudio"] = _RECOGNITIONAUDIO
+DESCRIPTOR.message_types_by_name["RecognizeResponse"] = _RECOGNIZERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "LongRunningRecognizeResponse"
+] = _LONGRUNNINGRECOGNIZERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "LongRunningRecognizeMetadata"
+] = _LONGRUNNINGRECOGNIZEMETADATA
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognizeResponse"
+] = _STREAMINGRECOGNIZERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognitionResult"
+] = _STREAMINGRECOGNITIONRESULT
+DESCRIPTOR.message_types_by_name["SpeechRecognitionResult"] = _SPEECHRECOGNITIONRESULT
+DESCRIPTOR.message_types_by_name[
+    "SpeechRecognitionAlternative"
+] = _SPEECHRECOGNITIONALTERNATIVE
+DESCRIPTOR.message_types_by_name["WordInfo"] = _WORDINFO
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+RecognizeRequest = _reflection.GeneratedProtocolMessageType(
+    "RecognizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNIZEREQUEST,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""The top-level message sent by the client for the ``Recognize`` method.
+  
+  
+  Attributes:
+      config:
+          *Required* Provides information to the recognizer that
+          specifies how to process the request.
+      audio:
+          *Required* The audio data to be recognized.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.RecognizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(RecognizeRequest)
+
+LongRunningRecognizeRequest = _reflection.GeneratedProtocolMessageType(
+    "LongRunningRecognizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LONGRUNNINGRECOGNIZEREQUEST,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""The top-level message sent by the client for the
+  ``LongRunningRecognize`` method.
+  
+  
+  Attributes:
+      config:
+          *Required* Provides information to the recognizer that
+          specifies how to process the request.
+      audio:
+          *Required* The audio data to be recognized.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.LongRunningRecognizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(LongRunningRecognizeRequest)
+
+StreamingRecognizeRequest = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNIZEREQUEST,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      streaming_request:
+          The streaming request, which is either a streaming config or
+          audio content.
+      streaming_config:
+          Provides information to the recognizer that specifies how to
+          process the request. The first ``StreamingRecognizeRequest``
+          message must contain a ``streaming_config`` message.
+      audio_content:
+          The audio data to be recognized. Sequential chunks of audio
+          data are sent in sequential ``StreamingRecognizeRequest``
+          messages. The first ``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 pure binary representation (not
+          base64). See `content limits </speech-to-
+          text/quotas#content>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.StreamingRecognizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognizeRequest)
+
+StreamingRecognitionConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognitionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNITIONCONFIG,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Provides information to the recognizer that specifies how to process the
+  request.
+  
+  
+  Attributes:
+      config:
+          *Required* Provides information to the recognizer that
+          specifies how to process the request.
+      single_utterance:
+          *Optional* 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
+          ``StreamingRecognitionResult``\ s with the ``is_final`` flag
+          set to ``true``.  If ``true``, the recognizer 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 recognition. It
+          will return no more than one ``StreamingRecognitionResult``
+          with the ``is_final`` flag set to ``true``.
+      interim_results:
+          *Optional* 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.StreamingRecognitionConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognitionConfig)
+
+RecognitionConfig = _reflection.GeneratedProtocolMessageType(
+    "RecognitionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNITIONCONFIG,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Provides information to the recognizer that specifies how to process the
+  request.
+  
+  
+  Attributes:
+      encoding:
+          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.Recognitio
+          nConfig.AudioEncoding].
+      sample_rate_hertz:
+          Sample rate in Hertz of the audio data sent in all
+          ``RecognitionAudio`` messages. 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 is optional for ``FLAC`` and ``WAV``
+          audio files and required for all other audio formats. For
+          details, see [AudioEncoding][google.cloud.speech.v1.Recognitio
+          nConfig.AudioEncoding].
+      audio_channel_count:
+          *Optional* 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'. Valid value for MULAW, AMR, AMR\_WB and
+          SPEEX\_WITH\_HEADER\_BYTE is only ``1``. If ``0`` or omitted,
+          defaults to one channel (mono). Note: We only recognize the
+          first channel by default. To perform independent recognition
+          on each channel set
+          ``enable_separate_recognition_per_channel`` to 'true'.
+      enable_separate_recognition_per_channel:
+          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 request is billed cumulatively for all
+          channels recognized: ``audio_channel_count`` multiplied by the
+          length of the audio.
+      language_code:
+          *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.
+      max_alternatives:
+          *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
+          ``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.
+      profanity_filter:
+          *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.
+      speech_contexts:
+          *Optional* 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>`__.
+      enable_word_time_offsets:
+          *Optional* 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``.
+      enable_automatic_punctuation:
+          *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.
+      metadata:
+          *Optional* Metadata regarding this request.
+      model:
+          *Optional* 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.  .. raw::
+          html     <table>  .. raw:: html     <tr>  ::
+          <td><b>Model</b></td>     <td><b>Description</b></td>  ..
+          raw:: html     </tr>  .. raw:: html     <tr>  ::
+          <td><code>command_and_search</code></td>     <td>Best for
+          short queries such as voice commands or voice search.</td>  ..
+          raw:: html     </tr>  .. raw:: html     <tr>  ::
+          <td><code>phone_call</code></td>     <td>Best for audio that
+          originated from a phone call (typically     recorded at an
+          8khz sampling rate).</td>  .. raw:: html     </tr>  .. raw::
+          html     <tr>  ::      <td><code>video</code></td>
+          <td>Best for audio that originated from from video or includes
+          multiple         speakers. Ideally the audio is recorded at a
+          16khz or greater         sampling rate. This is a premium
+          model that costs more than the         standard rate.</td>  ..
+          raw:: html     </tr>  .. raw:: html     <tr>  ::
+          <td><code>default</code></td>     <td>Best for audio that is
+          not one of the specific audio models.         For example,
+          long-form audio. Ideally the audio is high-fidelity,
+          recorded at a 16khz or greater sampling rate.</td>  .. raw::
+          html     </tr>  .. raw:: html     </table>
+      use_enhanced:
+          *Optional* 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.  If
+          ``use_enhanced`` is true and an enhanced version of the
+          specified model does not exist, then the speech is recognized
+          using the standard version of the specified model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.RecognitionConfig)
+    ),
+)
+_sym_db.RegisterMessage(RecognitionConfig)
+
+RecognitionMetadata = _reflection.GeneratedProtocolMessageType(
+    "RecognitionMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNITIONMETADATA,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Description of audio data to be recognized.
+  
+  
+  Attributes:
+      interaction_type:
+          The use case most closely describing the audio content to be
+          recognized.
+      industry_naics_code_of_audio:
+          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/.
+      microphone_distance:
+          The audio type that most closely describes the audio being
+          recognized.
+      original_media_type:
+          The original media the speech was recorded on.
+      recording_device_type:
+          The type of device the speech was recorded with.
+      recording_device_name:
+          The device used to make the recording. Examples 'Nexus 5X' or
+          'Polycom SoundStation IP 6000' or 'POTS' or 'VoIP' or
+          'Cardioid Microphone'.
+      original_mime_type:
+          Mime type of the original audio file. For example
+          ``audio/m4a``, ``audio/x-alaw-basic``, ``audio/mp3``,
+          ``audio/3gpp``. A list of possible audio mime types is
+          maintained at http://www.iana.org/assignments/media-
+          types/media-types.xhtml#audio
+      audio_topic:
+          Description of the content. Eg. "Recordings of federal supreme
+          court hearings from 2012".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.RecognitionMetadata)
+    ),
+)
+_sym_db.RegisterMessage(RecognitionMetadata)
+
+SpeechContext = _reflection.GeneratedProtocolMessageType(
+    "SpeechContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHCONTEXT,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Provides "hints" to the speech recognizer to favor specific words and
+  phrases in the results.
+  
+  
+  Attributes:
+      phrases:
+          *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 </speech-to-text/quotas#content>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.SpeechContext)
+    ),
+)
+_sym_db.RegisterMessage(SpeechContext)
+
+RecognitionAudio = _reflection.GeneratedProtocolMessageType(
+    "RecognitionAudio",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNITIONAUDIO,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""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>`__.
+  
+  
+  Attributes:
+      audio_source:
+          The audio source, which is either inline content or a Google
+          Cloud Storage uri.
+      content:
+          The audio data bytes encoded as specified in
+          ``RecognitionConfig``. Note: as with all bytes fields,
+          protobuffers use a pure binary representation, whereas JSON
+          representations use base64.
+      uri:
+          URI that points to a file that contains audio data bytes as
+          specified in ``RecognitionConfig``. The file must not be
+          compressed (for example, gzip). 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>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.RecognitionAudio)
+    ),
+)
+_sym_db.RegisterMessage(RecognitionAudio)
+
+RecognizeResponse = _reflection.GeneratedProtocolMessageType(
+    "RecognizeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNIZERESPONSE,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""The only message returned to the client by the ``Recognize`` method. It
+  contains the result as zero or more sequential
+  ``SpeechRecognitionResult`` messages.
+  
+  
+  Attributes:
+      results:
+          Output only. Sequential list of transcription results
+          corresponding to sequential portions of audio.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.RecognizeResponse)
+    ),
+)
+_sym_db.RegisterMessage(RecognizeResponse)
+
+LongRunningRecognizeResponse = _reflection.GeneratedProtocolMessageType(
+    "LongRunningRecognizeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LONGRUNNINGRECOGNIZERESPONSE,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""The only message returned to the client by the ``LongRunningRecognize``
+  method. It contains the result as zero or more sequential
+  ``SpeechRecognitionResult`` messages. It is included in the
+  ``result.response`` field of the ``Operation`` returned by the
+  ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      results:
+          Output only. Sequential list of transcription results
+          corresponding to sequential portions of audio.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.LongRunningRecognizeResponse)
+    ),
+)
+_sym_db.RegisterMessage(LongRunningRecognizeResponse)
+
+LongRunningRecognizeMetadata = _reflection.GeneratedProtocolMessageType(
+    "LongRunningRecognizeMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LONGRUNNINGRECOGNIZEMETADATA,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Describes the progress of a long-running ``LongRunningRecognize`` call.
+  It is included in the ``metadata`` field of the ``Operation`` returned
+  by the ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      progress_percent:
+          Approximate percentage of audio processed thus far. Guaranteed
+          to be 100 when the audio is fully processed and the results
+          are available.
+      start_time:
+          Time when the request was received.
+      last_update_time:
+          Time of the most recent processing update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.LongRunningRecognizeMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LongRunningRecognizeMetadata)
+
+StreamingRecognizeResponse = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognizeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNIZERESPONSE,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""``StreamingRecognizeResponse`` is the only message returned to the
+  client by ``StreamingRecognize``. A series of zero or more
+  ``StreamingRecognizeResponse`` messages are streamed back to the client.
+  If there is no recognizable audio, and ``single_utterance`` is set to
+  false, then no messages are streamed back to the client.
+  
+  Here's an example of a series of ten ``StreamingRecognizeResponse``\ s
+  that might be returned while processing audio:
+  
+  1. results { alternatives { transcript: "tube" } stability: 0.01 }
+  
+  2. results { alternatives { transcript: "to be a" } stability: 0.01 }
+  
+  3. results { alternatives { transcript: "to be" } stability: 0.9 }
+     results { alternatives { transcript: " or not to be" } stability:
+     0.01 }
+  
+  4. results { alternatives { transcript: "to be or not to be" confidence:
+     0.92 } alternatives { transcript: "to bee or not to bee" } is\_final:
+     true }
+  
+  5. results { alternatives { transcript: " that's" } stability: 0.01 }
+  
+  6. results { alternatives { transcript: " that is" } stability: 0.9 }
+     results { alternatives { transcript: " the question" } stability:
+     0.01 }
+  
+  7. results { alternatives { transcript: " that is the question"
+     confidence: 0.98 } alternatives { transcript: " that was the
+     question" } is\_final: true }
+  
+  Notes:
+  
+  -  Only two of the above responses #4 and #7 contain final results; they
+     are indicated by ``is_final: true``. Concatenating these together
+     generates the full transcript: "to be or not to be that is the
+     question".
+  
+  -  The others contain interim ``results``. #3 and #6 contain two interim
+     ``results``: the first portion has a high stability and is less
+     likely to change; the second portion has a low stability and is very
+     likely to change. A UI designer might choose to show only high
+     stability ``results``.
+  
+  -  The specific ``stability`` and ``confidence`` values shown above are
+     only for illustrative purposes. Actual values may vary.
+  
+  -  In each response, only one of these fields will be set: ``error``,
+     ``speech_event_type``, or one or more (repeated) ``results``.
+  
+  
+  Attributes:
+      error:
+          Output only. If set, returns a
+          [google.rpc.Status][google.rpc.Status] message that specifies
+          the error for the operation.
+      results:
+          Output only. 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).
+      speech_event_type:
+          Output only. Indicates the type of speech event.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.StreamingRecognizeResponse)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognizeResponse)
+
+StreamingRecognitionResult = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognitionResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNITIONRESULT,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""A streaming speech recognition result corresponding to a portion of the
+  audio that is currently being processed.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+      is_final:
+          Output only. 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.
+      stability:
+          Output only. 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.
+      result_end_time:
+          Output only. Time offset of the end of this result relative to
+          the beginning of the audio.
+      channel_tag:
+          For multi-channel audio, this is the channel number
+          corresponding to the recognized result for the audio from that
+          channel. For audio\_channel\_count = N, its output values can
+          range from '1' to 'N'.
+      language_code:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.StreamingRecognitionResult)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognitionResult)
+
+SpeechRecognitionResult = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONRESULT,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""A speech recognition result corresponding to a portion of the audio.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+      channel_tag:
+          For multi-channel audio, this is the channel number
+          corresponding to the recognized result for the audio from that
+          channel. For audio\_channel\_count = N, its output values can
+          range from '1' to 'N'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.SpeechRecognitionResult)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionResult)
+
+SpeechRecognitionAlternative = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionAlternative",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONALTERNATIVE,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Alternative hypotheses (a.k.a. n-best list).
+  
+  
+  Attributes:
+      transcript:
+          Output only. Transcript text representing the words that the
+          user spoke.
+      confidence:
+          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 set only for
+          the top alternative of a non-streaming result or, of a
+          streaming result where ``is_final=true``. 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.
+      words:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.SpeechRecognitionAlternative)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionAlternative)
+
+WordInfo = _reflection.GeneratedProtocolMessageType(
+    "WordInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORDINFO,
+        __module__="google.cloud.speech_v1.proto.cloud_speech_pb2",
+        __doc__="""Word-specific information for recognized words.
+  
+  
+  Attributes:
+      start_time:
+          Output only. 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. This is an experimental feature
+          and the accuracy of the time offset can vary.
+      end_time:
+          Output only. 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. This is an experimental feature
+          and the accuracy of the time offset can vary.
+      word:
+          Output only. The word corresponding to this set of
+          information.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1.WordInfo)
+    ),
+)
+_sym_db.RegisterMessage(WordInfo)
+
+
+DESCRIPTOR._options = None
+
+_SPEECH = _descriptor.ServiceDescriptor(
+    name="Speech",
+    full_name="google.cloud.speech.v1.Speech",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=3890,
+    serialized_end=4315,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="Recognize",
+            full_name="google.cloud.speech.v1.Speech.Recognize",
+            index=0,
+            containing_service=None,
+            input_type=_RECOGNIZEREQUEST,
+            output_type=_RECOGNIZERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\031"\024/v1/speech:recognize:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LongRunningRecognize",
+            full_name="google.cloud.speech.v1.Speech.LongRunningRecognize",
+            index=1,
+            containing_service=None,
+            input_type=_LONGRUNNINGRECOGNIZEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002$"\037/v1/speech:longrunningrecognize:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StreamingRecognize",
+            full_name="google.cloud.speech.v1.Speech.StreamingRecognize",
+            index=2,
+            containing_service=None,
+            input_type=_STREAMINGRECOGNIZEREQUEST,
+            output_type=_STREAMINGRECOGNIZERESPONSE,
+            serialized_options=None,
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_SPEECH)
+
+DESCRIPTOR.services_by_name["Speech"] = _SPEECH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/speech/google/cloud/speech_v1/proto/cloud_speech_pb2_grpc.py b/speech/google/cloud/speech_v1/proto/cloud_speech_pb2_grpc.py
new file mode 100644
index 000000000000..1928cdb085d6
--- /dev/null
+++ b/speech/google/cloud/speech_v1/proto/cloud_speech_pb2_grpc.py
@@ -0,0 +1,91 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.speech_v1.proto import (
+    cloud_speech_pb2 as google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class SpeechStub(object):
+    """Service that implements Google Cloud Speech API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.Recognize = channel.unary_unary(
+            "/google.cloud.speech.v1.Speech/Recognize",
+            request_serializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.RecognizeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.RecognizeResponse.FromString,
+        )
+        self.LongRunningRecognize = channel.unary_unary(
+            "/google.cloud.speech.v1.Speech/LongRunningRecognize",
+            request_serializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.LongRunningRecognizeRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.StreamingRecognize = channel.stream_stream(
+            "/google.cloud.speech.v1.Speech/StreamingRecognize",
+            request_serializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeResponse.FromString,
+        )
+
+
+class SpeechServicer(object):
+    """Service that implements Google Cloud Speech API.
+  """
+
+    def Recognize(self, request, context):
+        """Performs synchronous speech recognition: receive results after all audio
+    has been sent and processed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LongRunningRecognize(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StreamingRecognize(self, request_iterator, context):
+        """Performs bidirectional streaming speech recognition: receive results while
+    sending audio. This method is only available via the gRPC API (not REST).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SpeechServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "Recognize": grpc.unary_unary_rpc_method_handler(
+            servicer.Recognize,
+            request_deserializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.RecognizeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.RecognizeResponse.SerializeToString,
+        ),
+        "LongRunningRecognize": grpc.unary_unary_rpc_method_handler(
+            servicer.LongRunningRecognize,
+            request_deserializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.LongRunningRecognizeRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "StreamingRecognize": grpc.stream_stream_rpc_method_handler(
+            servicer.StreamingRecognize,
+            request_deserializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_speech__v1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.speech.v1.Speech", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/speech/google/cloud/speech_v1/types.py b/speech/google/cloud/speech_v1/types.py
new file mode 100644
index 000000000000..f90dd13b4f54
--- /dev/null
+++ b/speech/google/cloud/speech_v1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.speech_v1.proto import cloud_speech_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [cloud_speech_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.speech_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/speech/google/cloud/speech_v1p1beta1/__init__.py b/speech/google/cloud/speech_v1p1beta1/__init__.py
new file mode 100644
index 000000000000..b68a395372f9
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/__init__.py
@@ -0,0 +1,30 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.speech_v1p1beta1 import types
+from google.cloud.speech_v1p1beta1.gapic import enums
+from google.cloud.speech_v1p1beta1.gapic import speech_client
+
+from google.cloud.speech_v1.helpers import SpeechHelpers
+
+
+class SpeechClient(SpeechHelpers, speech_client.SpeechClient):
+    __doc__ = speech_client.SpeechClient.__doc__
+    enums = enums
+    types = types
+
+
+__all__ = ("enums", "types", "SpeechClient")
diff --git a/speech/google/cloud/speech_v1p1beta1/gapic/__init__.py b/speech/google/cloud/speech_v1p1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/speech/google/cloud/speech_v1p1beta1/gapic/enums.py b/speech/google/cloud/speech_v1p1beta1/gapic/enums.py
new file mode 100644
index 000000000000..4af44fa47fe3
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/gapic/enums.py
@@ -0,0 +1,198 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class RecognitionConfig(object):
+    class AudioEncoding(enum.IntEnum):
+        """
+        The encoding of the audio data sent in the request.
+
+        All encodings support only 1 channel (mono) audio.
+
+        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``.
+
+        The ``FLAC`` and ``WAV`` audio file formats include a header that
+        describes the included audio content. You can request recognition for
+        ``WAV`` files that contain either ``LINEAR16`` or ``MULAW`` encoded
+        audio. If you send ``FLAC`` or ``WAV`` audio file format in your
+        request, you do not need to specify an ``AudioEncoding``; the audio
+        encoding format is determined from the file header. If you specify 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`` error code.
+
+        Attributes:
+          ENCODING_UNSPECIFIED (int): Not specified.
+          LINEAR16 (int): Uncompressed 16-bit signed little-endian samples (Linear PCM).
+          FLAC (int): ``FLAC`` (Free Lossless Audio Codec) is the recommended encoding because
+          it is lossless--therefore recognition is not compromised--and requires
+          only about half the bandwidth of ``LINEAR16``. ``FLAC`` stream encoding
+          supports 16-bit and 24-bit samples, however, not all fields in
+          ``STREAMINFO`` are supported.
+          MULAW (int): 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
+          AMR (int): Adaptive Multi-Rate Narrowband codec. ``sample_rate_hertz`` must be
+          8000.
+          AMR_WB (int): Adaptive Multi-Rate Wideband codec. ``sample_rate_hertz`` must be 16000.
+          OGG_OPUS (int): Opus encoded audio frames in Ogg container
+          (`OggOpus <https://wiki.xiph.org/OggOpus>`__). ``sample_rate_hertz``
+          must be one of 8000, 12000, 16000, 24000, or 48000.
+          SPEEX_WITH_HEADER_BYTE (int): Although the use of lossy encodings is not recommended, if a very low
+          bitrate encoding is required, ``OGG_OPUS`` is highly preferred over
+          Speex encoding. The `Speex <https://speex.org/>`__ encoding supported by
+          Cloud Speech API has a header byte in each block, as in MIME type
+          ``audio/x-speex-with-header-byte``. It is a variant of the RTP Speex
+          encoding defined in `RFC 5574 <https://tools.ietf.org/html/rfc5574>`__.
+          The stream is a sequence of blocks, one block per RTP packet. Each block
+          starts with a byte containing the length of the block, in bytes,
+          followed by one or more frames of Speex data, padded to an integral
+          number of bytes (octets) as specified in RFC 5574. In other words, each
+          RTP header is replaced with a single byte containing the block length.
+          Only Speex wideband is supported. ``sample_rate_hertz`` must be 16000.
+          MP3 (int): 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.
+        """
+
+        ENCODING_UNSPECIFIED = 0
+        LINEAR16 = 1
+        FLAC = 2
+        MULAW = 3
+        AMR = 4
+        AMR_WB = 5
+        OGG_OPUS = 6
+        SPEEX_WITH_HEADER_BYTE = 7
+        MP3 = 8
+
+
+class RecognitionMetadata(object):
+    class InteractionType(enum.IntEnum):
+        """
+        Use case categories that the audio recognition request can be described
+        by.
+
+        Attributes:
+          INTERACTION_TYPE_UNSPECIFIED (int): Use case is either unknown or is something other than one of the other
+          values below.
+          DISCUSSION (int): Multiple people in a conversation or discussion. For example in a
+          meeting with two or more people actively participating. Typically all
+          the primary people speaking would be in the same room (if not, see
+          PHONE\_CALL)
+          PRESENTATION (int): One or more persons lecturing or presenting to others, mostly
+          uninterrupted.
+          PHONE_CALL (int): A phone-call or video-conference in which two or more people, who are
+          not in the same room, are actively participating.
+          VOICEMAIL (int): A recorded message intended for another person to listen to.
+          PROFESSIONALLY_PRODUCED (int): Professionally produced audio (eg. TV Show, Podcast).
+          VOICE_SEARCH (int): Transcribe spoken questions and queries into text.
+          VOICE_COMMAND (int): Transcribe voice commands, such as for controlling a device.
+          DICTATION (int): Transcribe speech to text to create a written document, such as a
+          text-message, email or report.
+        """
+
+        INTERACTION_TYPE_UNSPECIFIED = 0
+        DISCUSSION = 1
+        PRESENTATION = 2
+        PHONE_CALL = 3
+        VOICEMAIL = 4
+        PROFESSIONALLY_PRODUCED = 5
+        VOICE_SEARCH = 6
+        VOICE_COMMAND = 7
+        DICTATION = 8
+
+    class MicrophoneDistance(enum.IntEnum):
+        """
+        Enumerates the types of capture settings describing an audio file.
+
+        Attributes:
+          MICROPHONE_DISTANCE_UNSPECIFIED (int): Audio type is not known.
+          NEARFIELD (int): The audio was captured from a closely placed microphone. Eg. phone,
+          dictaphone, or handheld microphone. Generally if there speaker is within
+          1 meter of the microphone.
+          MIDFIELD (int): The speaker if within 3 meters of the microphone.
+          FARFIELD (int): The speaker is more than 3 meters away from the microphone.
+        """
+
+        MICROPHONE_DISTANCE_UNSPECIFIED = 0
+        NEARFIELD = 1
+        MIDFIELD = 2
+        FARFIELD = 3
+
+    class OriginalMediaType(enum.IntEnum):
+        """
+        The original media the speech was recorded on.
+
+        Attributes:
+          ORIGINAL_MEDIA_TYPE_UNSPECIFIED (int): Unknown original media type.
+          AUDIO (int): The speech data is an audio recording.
+          VIDEO (int): The speech data originally recorded on a video.
+        """
+
+        ORIGINAL_MEDIA_TYPE_UNSPECIFIED = 0
+        AUDIO = 1
+        VIDEO = 2
+
+    class RecordingDeviceType(enum.IntEnum):
+        """
+        The type of device the speech was recorded with.
+
+        Attributes:
+          RECORDING_DEVICE_TYPE_UNSPECIFIED (int): The recording device is unknown.
+          SMARTPHONE (int): Speech was recorded on a smartphone.
+          PC (int): Speech was recorded using a personal computer or tablet.
+          PHONE_LINE (int): Speech was recorded over a phone line.
+          VEHICLE (int): Speech was recorded in a vehicle.
+          OTHER_OUTDOOR_DEVICE (int): Speech was recorded outdoors.
+          OTHER_INDOOR_DEVICE (int): Speech was recorded indoors.
+        """
+
+        RECORDING_DEVICE_TYPE_UNSPECIFIED = 0
+        SMARTPHONE = 1
+        PC = 2
+        PHONE_LINE = 3
+        VEHICLE = 4
+        OTHER_OUTDOOR_DEVICE = 5
+        OTHER_INDOOR_DEVICE = 6
+
+
+class StreamingRecognizeResponse(object):
+    class SpeechEventType(enum.IntEnum):
+        """
+        Indicates the type of speech event.
+
+        Attributes:
+          SPEECH_EVENT_UNSPECIFIED (int): No speech event specified.
+          END_OF_SINGLE_UTTERANCE (int): 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). The client should stop sending additional audio
+          data, half-close the gRPC connection, and wait for any additional
+          results until the server closes the gRPC connection. This event is only
+          sent if ``single_utterance`` was set to ``true``, and is not used
+          otherwise.
+        """
+
+        SPEECH_EVENT_UNSPECIFIED = 0
+        END_OF_SINGLE_UTTERANCE = 1
diff --git a/speech/google/cloud/speech_v1p1beta1/gapic/speech_client.py b/speech/google/cloud/speech_v1p1beta1/gapic/speech_client.py
new file mode 100644
index 000000000000..320abd7e8f8b
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/gapic/speech_client.py
@@ -0,0 +1,410 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.speech.v1p1beta1 Speech API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.speech_v1p1beta1.gapic import enums
+from google.cloud.speech_v1p1beta1.gapic import speech_client_config
+from google.cloud.speech_v1p1beta1.gapic.transports import speech_grpc_transport
+from google.cloud.speech_v1p1beta1.proto import cloud_speech_pb2
+from google.cloud.speech_v1p1beta1.proto import cloud_speech_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-speech").version
+
+
+class SpeechClient(object):
+    """Service that implements Google Cloud Speech API."""
+
+    SERVICE_ADDRESS = "speech.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.speech.v1p1beta1.Speech"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            SpeechClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.SpeechGrpcTransport,
+                    Callable[[~.Credentials, type], ~.SpeechGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = speech_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=speech_grpc_transport.SpeechGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = speech_grpc_transport.SpeechGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def recognize(
+        self,
+        config,
+        audio,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Performs synchronous speech recognition: receive results after all audio
+        has been sent and processed.
+
+        Example:
+            >>> from google.cloud import speech_v1p1beta1
+            >>> from google.cloud.speech_v1p1beta1 import enums
+            >>>
+            >>> client = speech_v1p1beta1.SpeechClient()
+            >>>
+            >>> encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+            >>> sample_rate_hertz = 44100
+            >>> language_code = 'en-US'
+            >>> config = {'encoding': encoding, 'sample_rate_hertz': sample_rate_hertz, 'language_code': language_code}
+            >>> uri = 'gs://bucket_name/file_name.flac'
+            >>> audio = {'uri': uri}
+            >>>
+            >>> response = client.recognize(config, audio)
+
+        Args:
+            config (Union[dict, ~google.cloud.speech_v1p1beta1.types.RecognitionConfig]): *Required* Provides information to the recognizer that specifies how to
+                process the request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1p1beta1.types.RecognitionConfig`
+            audio (Union[dict, ~google.cloud.speech_v1p1beta1.types.RecognitionAudio]): *Required* The audio data to be recognized.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1p1beta1.types.RecognitionAudio`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.speech_v1p1beta1.types.RecognizeResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "recognize" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "recognize"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.recognize,
+                default_retry=self._method_configs["Recognize"].retry,
+                default_timeout=self._method_configs["Recognize"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_speech_pb2.RecognizeRequest(config=config, audio=audio)
+        return self._inner_api_calls["recognize"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def long_running_recognize(
+        self,
+        config,
+        audio,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import speech_v1p1beta1
+            >>> from google.cloud.speech_v1p1beta1 import enums
+            >>>
+            >>> client = speech_v1p1beta1.SpeechClient()
+            >>>
+            >>> encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+            >>> sample_rate_hertz = 44100
+            >>> language_code = 'en-US'
+            >>> config = {'encoding': encoding, 'sample_rate_hertz': sample_rate_hertz, 'language_code': language_code}
+            >>> uri = 'gs://bucket_name/file_name.flac'
+            >>> audio = {'uri': uri}
+            >>>
+            >>> response = client.long_running_recognize(config, audio)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            config (Union[dict, ~google.cloud.speech_v1p1beta1.types.RecognitionConfig]): *Required* Provides information to the recognizer that specifies how to
+                process the request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1p1beta1.types.RecognitionConfig`
+            audio (Union[dict, ~google.cloud.speech_v1p1beta1.types.RecognitionAudio]): *Required* The audio data to be recognized.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.speech_v1p1beta1.types.RecognitionAudio`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.speech_v1p1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "long_running_recognize" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "long_running_recognize"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.long_running_recognize,
+                default_retry=self._method_configs["LongRunningRecognize"].retry,
+                default_timeout=self._method_configs["LongRunningRecognize"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_speech_pb2.LongRunningRecognizeRequest(
+            config=config, audio=audio
+        )
+        operation = self._inner_api_calls["long_running_recognize"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            cloud_speech_pb2.LongRunningRecognizeResponse,
+            metadata_type=cloud_speech_pb2.LongRunningRecognizeMetadata,
+        )
+
+    def streaming_recognize(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Performs bidirectional streaming speech recognition: receive results while
+        sending audio. This method is only available via the gRPC API (not REST).
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import speech_v1p1beta1
+            >>>
+            >>> client = speech_v1p1beta1.SpeechClient()
+            >>>
+            >>> request = {}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.streaming_recognize(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2.StreamingRecognizeRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.speech_v1p1beta1.types.StreamingRecognizeRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.speech_v1p1beta1.types.StreamingRecognizeResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "streaming_recognize" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "streaming_recognize"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.streaming_recognize,
+                default_retry=self._method_configs["StreamingRecognize"].retry,
+                default_timeout=self._method_configs["StreamingRecognize"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["streaming_recognize"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/speech/google/cloud/speech_v1p1beta1/gapic/speech_client_config.py b/speech/google/cloud/speech_v1p1beta1/gapic/speech_client_config.py
new file mode 100644
index 000000000000..8360e0273019
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/gapic/speech_client_config.py
@@ -0,0 +1,38 @@
+config = {
+    "interfaces": {
+        "google.cloud.speech.v1p1beta1.Speech": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 1000000,
+                    "total_timeout_millis": 5000000,
+                }
+            },
+            "methods": {
+                "Recognize": {
+                    "timeout_millis": 200000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "LongRunningRecognize": {
+                    "timeout_millis": 200000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "StreamingRecognize": {
+                    "timeout_millis": 905000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/speech/google/cloud/speech_v1p1beta1/gapic/transports/__init__.py b/speech/google/cloud/speech_v1p1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/speech/google/cloud/speech_v1p1beta1/gapic/transports/speech_grpc_transport.py b/speech/google/cloud/speech_v1p1beta1/gapic/transports/speech_grpc_transport.py
new file mode 100644
index 000000000000..1c373fccd56b
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/gapic/transports/speech_grpc_transport.py
@@ -0,0 +1,158 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.speech_v1p1beta1.proto import cloud_speech_pb2_grpc
+
+
+class SpeechGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.speech.v1p1beta1 Speech API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="speech.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"speech_stub": cloud_speech_pb2_grpc.SpeechStub(channel)}
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="speech.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def recognize(self):
+        """Return the gRPC stub for :meth:`SpeechClient.recognize`.
+
+        Performs synchronous speech recognition: receive results after all audio
+        has been sent and processed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["speech_stub"].Recognize
+
+    @property
+    def long_running_recognize(self):
+        """Return the gRPC stub for :meth:`SpeechClient.long_running_recognize`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["speech_stub"].LongRunningRecognize
+
+    @property
+    def streaming_recognize(self):
+        """Return the gRPC stub for :meth:`SpeechClient.streaming_recognize`.
+
+        Performs bidirectional streaming speech recognition: receive results while
+        sending audio. This method is only available via the gRPC API (not REST).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["speech_stub"].StreamingRecognize
diff --git a/speech/google/cloud/speech_v1p1beta1/proto/__init__.py b/speech/google/cloud/speech_v1p1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech.proto b/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech.proto
new file mode 100644
index 000000000000..4ca4479a8ca8
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech.proto
@@ -0,0 +1,812 @@
+// 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.cloud.speech.v1p1beta1;
+
+import "google/api/annotations.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";
+
+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 = "SpeechProto";
+option java_package = "com.google.cloud.speech.v1p1beta1";
+
+// Service that implements Google Cloud Speech API.
+service Speech {
+  // Performs synchronous speech recognition: receive results after all audio
+  // has been sent and processed.
+  rpc Recognize(RecognizeRequest) returns (RecognizeResponse) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/speech:recognize"
+      body: "*"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/speech:longrunningrecognize"
+      body: "*"
+    };
+  }
+
+  // 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) {}
+}
+
+// The top-level message sent by the client for the `Recognize` method.
+message RecognizeRequest {
+  // *Required* Provides information to the recognizer that specifies how to
+  // process the request.
+  RecognitionConfig config = 1;
+
+  // *Required* The audio data to be recognized.
+  RecognitionAudio audio = 2;
+}
+
+// The top-level message sent by the client for the `LongRunningRecognize`
+// method.
+message LongRunningRecognizeRequest {
+  // *Required* Provides information to the recognizer that specifies how to
+  // process the request.
+  RecognitionConfig config = 1;
+
+  // *Required* The audio data to be recognized.
+  RecognitionAudio audio = 2;
+}
+
+// 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.
+message StreamingRecognizeRequest {
+  // The streaming request, which is either a streaming config or audio content.
+  oneof streaming_request {
+    // Provides information to the recognizer that specifies how to process the
+    // request. The first `StreamingRecognizeRequest` message must contain a
+    // `streaming_config`  message.
+    StreamingRecognitionConfig streaming_config = 1;
+
+    // The audio data to be recognized. Sequential chunks of audio data are sent
+    // in sequential `StreamingRecognizeRequest` messages. The first
+    // `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
+    // pure binary representation (not base64). See
+    // [content limits](/speech-to-text/quotas#content).
+    bytes audio_content = 2;
+  }
+}
+
+// Provides information to the recognizer that specifies how to process the
+// request.
+message StreamingRecognitionConfig {
+  // *Required* Provides information to the recognizer that specifies how to
+  // process the request.
+  RecognitionConfig config = 1;
+
+  // *Optional* 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
+  // `StreamingRecognitionResult`s with the `is_final` flag set to `true`.
+  //
+  // If `true`, the recognizer 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 recognition. It will return no
+  // more than one `StreamingRecognitionResult` with the `is_final` flag set to
+  // `true`.
+  bool single_utterance = 2;
+
+  // *Optional* 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.
+  bool interim_results = 3;
+}
+
+// Provides information to the recognizer that specifies how to process the
+// request.
+message RecognitionConfig {
+  // The encoding of the audio data sent in the request.
+  //
+  // All encodings support only 1 channel (mono) audio.
+  //
+  // 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`.
+  //
+  // The `FLAC` and `WAV` audio file formats include a header that describes the
+  // included audio content. You can request recognition for `WAV` files that
+  // contain either `LINEAR16` or `MULAW` encoded audio.
+  // If you send `FLAC` or `WAV` audio file format in
+  // your request, you do not need to specify an `AudioEncoding`; the audio
+  // encoding format is determined from the file header. If you specify
+  // 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.
+  enum AudioEncoding {
+    // Not specified.
+    ENCODING_UNSPECIFIED = 0;
+
+    // Uncompressed 16-bit signed little-endian samples (Linear PCM).
+    LINEAR16 = 1;
+
+    // `FLAC` (Free Lossless Audio
+    // Codec) is the recommended encoding because it is
+    // lossless--therefore recognition is not compromised--and
+    // requires only about half the bandwidth of `LINEAR16`. `FLAC` stream
+    // encoding supports 16-bit and 24-bit samples, however, not all fields in
+    // `STREAMINFO` are supported.
+    FLAC = 2;
+
+    // 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
+    MULAW = 3;
+
+    // Adaptive Multi-Rate Narrowband codec. `sample_rate_hertz` must be 8000.
+    AMR = 4;
+
+    // Adaptive Multi-Rate Wideband codec. `sample_rate_hertz` must be 16000.
+    AMR_WB = 5;
+
+    // Opus encoded audio frames in Ogg container
+    // ([OggOpus](https://wiki.xiph.org/OggOpus)).
+    // `sample_rate_hertz` must be one of 8000, 12000, 16000, 24000, or 48000.
+    OGG_OPUS = 6;
+
+    // Although the use of lossy encodings is not recommended, if a very low
+    // bitrate encoding is required, `OGG_OPUS` is highly preferred over
+    // Speex encoding. The [Speex](https://speex.org/)  encoding supported by
+    // Cloud Speech API has a header byte in each block, as in MIME type
+    // `audio/x-speex-with-header-byte`.
+    // It is a variant of the RTP Speex encoding defined in
+    // [RFC 5574](https://tools.ietf.org/html/rfc5574).
+    // The stream is a sequence of blocks, one block per RTP packet. Each block
+    // starts with a byte containing the length of the block, in bytes, followed
+    // by one or more frames of Speex data, padded to an integral number of
+    // bytes (octets) as specified in RFC 5574. In other words, each RTP header
+    // is replaced with a single byte containing the block length. Only Speex
+    // wideband is supported. `sample_rate_hertz` must be 16000.
+    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.
+    MP3 = 8;
+  }
+
+  // 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.v1p1beta1.RecognitionConfig.AudioEncoding].
+  AudioEncoding encoding = 1;
+
+  // Sample rate in Hertz of the audio data sent in all
+  // `RecognitionAudio` messages. 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 is optional for `FLAC` and `WAV` audio files and 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.
+  // ONLY set this for MULTI-CHANNEL recognition.
+  // Valid values for LINEAR16 and FLAC are `1`-`8`.
+  // Valid values for OGG_OPUS are '1'-'254'.
+  // Valid value for MULAW, AMR, AMR_WB and SPEEX_WITH_HEADER_BYTE is only `1`.
+  // If `0` or omitted, defaults to one channel (mono).
+  // Note: We only recognize the first channel by default.
+  // To perform independent recognition on each channel set
+  // `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
+  // 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
+  // request is billed cumulatively for all channels recognized:
+  // `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
+  // [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;
+
+  // *Optional* 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
+  // transcription).
+  repeated string alternative_language_codes = 18;
+
+  // *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 `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 = 4;
+
+  // *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 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).
+  repeated SpeechContext speech_contexts = 6;
+
+  // *Optional* 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
+  // 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.
+  // 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
+  // the top alternative of the recognition result using a speaker_tag provided
+  // in the WordInfo.
+  // Note: Use diarization_config instead.
+  bool enable_speaker_diarization = 16 [deprecated = true];
+
+  // *Optional*
+  // 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];
+
+  // *Optional* 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;
+
+  // *Optional* Metadata regarding this request.
+  RecognitionMetadata metadata = 9;
+
+  // *Optional* 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.
+  // <table>
+  //   <tr>
+  //     <td><b>Model</b></td>
+  //     <td><b>Description</b></td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>command_and_search</code></td>
+  //     <td>Best for short queries such as voice commands or voice search.</td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>phone_call</code></td>
+  //     <td>Best for audio that originated from a phone call (typically
+  //     recorded at an 8khz sampling rate).</td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>video</code></td>
+  //     <td>Best for audio that originated from from video or includes multiple
+  //         speakers. Ideally the audio is recorded at a 16khz or greater
+  //         sampling rate. This is a premium model that costs more than the
+  //         standard rate.</td>
+  //   </tr>
+  //   <tr>
+  //     <td><code>default</code></td>
+  //     <td>Best for audio that is not one of the specific audio models.
+  //         For example, long-form audio. Ideally the audio is high-fidelity,
+  //         recorded at a 16khz or greater sampling rate.</td>
+  //   </tr>
+  // </table>
+  string model = 13;
+
+  // *Optional* 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.
+  //
+  // If `use_enhanced` is true and an enhanced version of the specified model
+  // does not exist, then the speech is recognized using the standard version
+  // of the specified model.
+  bool use_enhanced = 14;
+}
+
+// *Optional* Config to enable speaker diarization.
+message SpeakerDiarizationConfig {
+  // *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.
+  bool enable_speaker_diarization = 1;
+
+  // Note: Set min_speaker_count = max_speaker_count to fix the number of
+  // speakers to be detected in the audio.
+
+  // *Optional*
+  // 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;
+
+  // *Optional*
+  // 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;
+}
+
+// Description of audio data to be recognized.
+message RecognitionMetadata {
+  // Use case categories that the audio recognition request can be described
+  // by.
+  enum InteractionType {
+    // Use case is either unknown or is something other than one of the other
+    // values below.
+    INTERACTION_TYPE_UNSPECIFIED = 0;
+
+    // Multiple people in a conversation or discussion. For example in a
+    // meeting with two or more people actively participating. Typically
+    // all the primary people speaking would be in the same room (if not,
+    // see PHONE_CALL)
+    DISCUSSION = 1;
+
+    // One or more persons lecturing or presenting to others, mostly
+    // uninterrupted.
+    PRESENTATION = 2;
+
+    // A phone-call or video-conference in which two or more people, who are
+    // not in the same room, are actively participating.
+    PHONE_CALL = 3;
+
+    // A recorded message intended for another person to listen to.
+    VOICEMAIL = 4;
+
+    // Professionally produced audio (eg. TV Show, Podcast).
+    PROFESSIONALLY_PRODUCED = 5;
+
+    // Transcribe spoken questions and queries into text.
+    VOICE_SEARCH = 6;
+
+    // Transcribe voice commands, such as for controlling a device.
+    VOICE_COMMAND = 7;
+
+    // Transcribe speech to text to create a written document, such as a
+    // text-message, email or report.
+    DICTATION = 8;
+  }
+
+  // Enumerates the types of capture settings describing an audio file.
+  enum MicrophoneDistance {
+    // Audio type is not known.
+    MICROPHONE_DISTANCE_UNSPECIFIED = 0;
+
+    // The audio was captured from a closely placed microphone. Eg. phone,
+    // dictaphone, or handheld microphone. Generally if there speaker is within
+    // 1 meter of the microphone.
+    NEARFIELD = 1;
+
+    // The speaker if within 3 meters of the microphone.
+    MIDFIELD = 2;
+
+    // The speaker is more than 3 meters away from the microphone.
+    FARFIELD = 3;
+  }
+
+  // The original media the speech was recorded on.
+  enum OriginalMediaType {
+    // Unknown original media type.
+    ORIGINAL_MEDIA_TYPE_UNSPECIFIED = 0;
+
+    // The speech data is an audio recording.
+    AUDIO = 1;
+
+    // The speech data originally recorded on a video.
+    VIDEO = 2;
+  }
+
+  // The type of device the speech was recorded with.
+  enum RecordingDeviceType {
+    // The recording device is unknown.
+    RECORDING_DEVICE_TYPE_UNSPECIFIED = 0;
+
+    // Speech was recorded on a smartphone.
+    SMARTPHONE = 1;
+
+    // Speech was recorded using a personal computer or tablet.
+    PC = 2;
+
+    // Speech was recorded over a phone line.
+    PHONE_LINE = 3;
+
+    // Speech was recorded in a vehicle.
+    VEHICLE = 4;
+
+    // Speech was recorded outdoors.
+    OTHER_OUTDOOR_DEVICE = 5;
+
+    // Speech was recorded indoors.
+    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;
+
+  // The device used to make the recording.  Examples 'Nexus 5X' or
+  // 'Polycom SoundStation IP 6000' or 'POTS' or 'VoIP' or
+  // 'Cardioid Microphone'.
+  string recording_device_name = 7;
+
+  // Mime type of the original audio file.  For example `audio/m4a`,
+  // `audio/x-alaw-basic`, `audio/mp3`, `audio/3gpp`.
+  // A list of possible audio mime types is maintained at
+  // http://www.iana.org/assignments/media-types/media-types.xhtml#audio
+  string original_mime_type = 8;
+
+  // Obfuscated (privacy-protected) ID of the user, to identify number of
+  // unique users using the service.
+  int64 obfuscated_id = 9;
+
+  // Description of the content. Eg. "Recordings of federal supreme court
+  // hearings from 2012".
+  string audio_topic = 10;
+}
+
+// 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
+  // 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).
+  //
+  // 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;
+
+  // 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 and 20. We recommend using a binary search approach to
+  // finding the optimal value for your use case.
+  float boost = 4;
+}
+
+// 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).
+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
+    // pure binary representation, whereas JSON representations use base64.
+    bytes content = 1;
+
+    // URI that points to a file that contains audio data bytes as specified in
+    // `RecognitionConfig`. The file must not be compressed (for example, gzip).
+    // 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).
+    string uri = 2;
+  }
+}
+
+// The only message returned to the client by the `Recognize` method. It
+// contains the result as zero or more sequential `SpeechRecognitionResult`
+// messages.
+message RecognizeResponse {
+  // Output only. Sequential list of transcription results corresponding to
+  // sequential portions of audio.
+  repeated SpeechRecognitionResult results = 2;
+}
+
+// The only message returned to the client by the `LongRunningRecognize` method.
+// It contains the result as zero or more sequential `SpeechRecognitionResult`
+// messages. It is included in the `result.response` field of the `Operation`
+// returned by the `GetOperation` call of the `google::longrunning::Operations`
+// service.
+message LongRunningRecognizeResponse {
+  // Output only. Sequential list of transcription results corresponding to
+  // sequential portions of audio.
+  repeated SpeechRecognitionResult results = 2;
+}
+
+// Describes the progress of a long-running `LongRunningRecognize` call. It is
+// included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message LongRunningRecognizeMetadata {
+  // Approximate percentage of audio processed thus far. Guaranteed to be 100
+  // when the audio is fully processed and the results are available.
+  int32 progress_percent = 1;
+
+  // Time when the request was received.
+  google.protobuf.Timestamp start_time = 2;
+
+  // Time of the most recent processing update.
+  google.protobuf.Timestamp last_update_time = 3;
+}
+
+// `StreamingRecognizeResponse` is the only message returned to the client by
+// `StreamingRecognize`. A series of zero or more `StreamingRecognizeResponse`
+// messages are streamed back to the client. If there is no recognizable
+// audio, and `single_utterance` is set to false, then no messages are streamed
+// back to the client.
+//
+// Here's an example of a series of ten `StreamingRecognizeResponse`s that might
+// be returned while processing audio:
+//
+// 1. results { alternatives { transcript: "tube" } stability: 0.01 }
+//
+// 2. results { alternatives { transcript: "to be a" } stability: 0.01 }
+//
+// 3. results { alternatives { transcript: "to be" } stability: 0.9 }
+//    results { alternatives { transcript: " or not to be" } stability: 0.01 }
+//
+// 4. results { alternatives { transcript: "to be or not to be"
+//                             confidence: 0.92 }
+//              alternatives { transcript: "to bee or not to bee" }
+//              is_final: true }
+//
+// 5. results { alternatives { transcript: " that's" } stability: 0.01 }
+//
+// 6. results { alternatives { transcript: " that is" } stability: 0.9 }
+//    results { alternatives { transcript: " the question" } stability: 0.01 }
+//
+// 7. results { alternatives { transcript: " that is the question"
+//                             confidence: 0.98 }
+//              alternatives { transcript: " that was the question" }
+//              is_final: true }
+//
+// Notes:
+//
+// - Only two of the above responses #4 and #7 contain final results; they are
+//   indicated by `is_final: true`. Concatenating these together generates the
+//   full transcript: "to be or not to be that is the question".
+//
+// - The others contain interim `results`. #3 and #6 contain two interim
+//   `results`: the first portion has a high stability and is less likely to
+//   change; the second portion has a low stability and is very likely to
+//   change. A UI designer might choose to show only high stability `results`.
+//
+// - The specific `stability` and `confidence` values shown above are only for
+//   illustrative purposes. Actual values may vary.
+//
+// - In each response, only one of these fields will be set:
+//     `error`,
+//     `speech_event_type`, or
+//     one or more (repeated) `results`.
+message StreamingRecognizeResponse {
+  // Indicates the type of speech event.
+  enum SpeechEventType {
+    // No speech event specified.
+    SPEECH_EVENT_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). The client should stop sending additional audio
+    // data, half-close the gRPC connection, and wait for any additional results
+    // until the server closes the gRPC connection. 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;
+
+  // Output only. 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.
+  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
+  // 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
+  // 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
+  // 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
+  // beginning of the audio.
+  google.protobuf.Duration result_end_time = 4;
+
+  // For multi-channel audio, this is the channel number corresponding to the
+  // recognized result for the audio from that channel.
+  // 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;
+}
+
+// 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
+  // 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;
+
+  // For multi-channel audio, this is the channel number corresponding to the
+  // recognized result for the audio from that channel.
+  // 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;
+}
+
+// Alternative hypotheses (a.k.a. n-best list).
+message SpeechRecognitionAlternative {
+  // Output only. 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
+  // 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`.
+  // 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;
+
+  // 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;
+}
+
+// Word-specific information for recognized words.
+message WordInfo {
+  // Output only. 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.
+  // This is an experimental feature and the accuracy of the time offset can
+  // vary.
+  google.protobuf.Duration start_time = 1;
+
+  // Output only. 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.
+  // This is an experimental feature and the accuracy of the time offset can
+  // vary.
+  google.protobuf.Duration end_time = 2;
+
+  // Output only. 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
+  // 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`.
+  // 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;
+
+  // 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' to diarization_speaker_count.
+  // speaker_tag is set if enable_speaker_diarization = 'true' and only in the
+  // top alternative.
+  int32 speaker_tag = 5;
+}
diff --git a/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2.py b/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2.py
new file mode 100644
index 000000000000..9062c3b8dbb2
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2.py
@@ -0,0 +1,2817 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/speech_v1p1beta1/proto/cloud_speech.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/speech_v1p1beta1/proto/cloud_speech.proto",
+    package="google.cloud.speech.v1p1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.speech.v1p1beta1B\013SpeechProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/speech/v1p1beta1;speech\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/speech_v1p1beta1/proto/cloud_speech.proto\x12\x1dgoogle.cloud.speech.v1p1beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x19google/protobuf/any.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\x94\x01\n\x10RecognizeRequest\x12@\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\x30.google.cloud.speech.v1p1beta1.RecognitionConfig\x12>\n\x05\x61udio\x18\x02 \x01(\x0b\x32/.google.cloud.speech.v1p1beta1.RecognitionAudio"\x9f\x01\n\x1bLongRunningRecognizeRequest\x12@\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\x30.google.cloud.speech.v1p1beta1.RecognitionConfig\x12>\n\x05\x61udio\x18\x02 \x01(\x0b\x32/.google.cloud.speech.v1p1beta1.RecognitionAudio"\xa0\x01\n\x19StreamingRecognizeRequest\x12U\n\x10streaming_config\x18\x01 \x01(\x0b\x32\x39.google.cloud.speech.v1p1beta1.StreamingRecognitionConfigH\x00\x12\x17\n\raudio_content\x18\x02 \x01(\x0cH\x00\x42\x13\n\x11streaming_request"\x91\x01\n\x1aStreamingRecognitionConfig\x12@\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\x30.google.cloud.speech.v1p1beta1.RecognitionConfig\x12\x18\n\x10single_utterance\x18\x02 \x01(\x08\x12\x17\n\x0finterim_results\x18\x03 \x01(\x08"\x92\x07\n\x11RecognitionConfig\x12P\n\x08\x65ncoding\x18\x01 \x01(\x0e\x32>.google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding\x12\x19\n\x11sample_rate_hertz\x18\x02 \x01(\x05\x12\x1b\n\x13\x61udio_channel_count\x18\x07 \x01(\x05\x12/\n\'enable_separate_recognition_per_channel\x18\x0c \x01(\x08\x12\x15\n\rlanguage_code\x18\x03 \x01(\t\x12"\n\x1a\x61lternative_language_codes\x18\x12 \x03(\t\x12\x18\n\x10max_alternatives\x18\x04 \x01(\x05\x12\x18\n\x10profanity_filter\x18\x05 \x01(\x08\x12\x45\n\x0fspeech_contexts\x18\x06 \x03(\x0b\x32,.google.cloud.speech.v1p1beta1.SpeechContext\x12 \n\x18\x65nable_word_time_offsets\x18\x08 \x01(\x08\x12\x1e\n\x16\x65nable_word_confidence\x18\x0f \x01(\x08\x12$\n\x1c\x65nable_automatic_punctuation\x18\x0b \x01(\x08\x12&\n\x1a\x65nable_speaker_diarization\x18\x10 \x01(\x08\x42\x02\x18\x01\x12%\n\x19\x64iarization_speaker_count\x18\x11 \x01(\x05\x42\x02\x18\x01\x12S\n\x12\x64iarization_config\x18\x13 \x01(\x0b\x32\x37.google.cloud.speech.v1p1beta1.SpeakerDiarizationConfig\x12\x44\n\x08metadata\x18\t \x01(\x0b\x32\x32.google.cloud.speech.v1p1beta1.RecognitionMetadata\x12\r\n\x05model\x18\r \x01(\t\x12\x14\n\x0cuse_enhanced\x18\x0e \x01(\x08"\x94\x01\n\rAudioEncoding\x12\x18\n\x14\x45NCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\x08\n\x04\x46LAC\x10\x02\x12\t\n\x05MULAW\x10\x03\x12\x07\n\x03\x41MR\x10\x04\x12\n\n\x06\x41MR_WB\x10\x05\x12\x0c\n\x08OGG_OPUS\x10\x06\x12\x1a\n\x16SPEEX_WITH_HEADER_BYTE\x10\x07\x12\x07\n\x03MP3\x10\x08"t\n\x18SpeakerDiarizationConfig\x12"\n\x1a\x65nable_speaker_diarization\x18\x01 \x01(\x08\x12\x19\n\x11min_speaker_count\x18\x02 \x01(\x05\x12\x19\n\x11max_speaker_count\x18\x03 \x01(\x05"\xd3\x08\n\x13RecognitionMetadata\x12\\\n\x10interaction_type\x18\x01 \x01(\x0e\x32\x42.google.cloud.speech.v1p1beta1.RecognitionMetadata.InteractionType\x12$\n\x1cindustry_naics_code_of_audio\x18\x03 \x01(\r\x12\x62\n\x13microphone_distance\x18\x04 \x01(\x0e\x32\x45.google.cloud.speech.v1p1beta1.RecognitionMetadata.MicrophoneDistance\x12\x61\n\x13original_media_type\x18\x05 \x01(\x0e\x32\x44.google.cloud.speech.v1p1beta1.RecognitionMetadata.OriginalMediaType\x12\x65\n\x15recording_device_type\x18\x06 \x01(\x0e\x32\x46.google.cloud.speech.v1p1beta1.RecognitionMetadata.RecordingDeviceType\x12\x1d\n\x15recording_device_name\x18\x07 \x01(\t\x12\x1a\n\x12original_mime_type\x18\x08 \x01(\t\x12\x15\n\robfuscated_id\x18\t \x01(\x03\x12\x13\n\x0b\x61udio_topic\x18\n \x01(\t"\xc5\x01\n\x0fInteractionType\x12 \n\x1cINTERACTION_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nDISCUSSION\x10\x01\x12\x10\n\x0cPRESENTATION\x10\x02\x12\x0e\n\nPHONE_CALL\x10\x03\x12\r\n\tVOICEMAIL\x10\x04\x12\x1b\n\x17PROFESSIONALLY_PRODUCED\x10\x05\x12\x10\n\x0cVOICE_SEARCH\x10\x06\x12\x11\n\rVOICE_COMMAND\x10\x07\x12\r\n\tDICTATION\x10\x08"d\n\x12MicrophoneDistance\x12#\n\x1fMICROPHONE_DISTANCE_UNSPECIFIED\x10\x00\x12\r\n\tNEARFIELD\x10\x01\x12\x0c\n\x08MIDFIELD\x10\x02\x12\x0c\n\x08\x46\x41RFIELD\x10\x03"N\n\x11OriginalMediaType\x12#\n\x1fORIGINAL_MEDIA_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x41UDIO\x10\x01\x12\t\n\x05VIDEO\x10\x02"\xa4\x01\n\x13RecordingDeviceType\x12%\n!RECORDING_DEVICE_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nSMARTPHONE\x10\x01\x12\x06\n\x02PC\x10\x02\x12\x0e\n\nPHONE_LINE\x10\x03\x12\x0b\n\x07VEHICLE\x10\x04\x12\x18\n\x14OTHER_OUTDOOR_DEVICE\x10\x05\x12\x17\n\x13OTHER_INDOOR_DEVICE\x10\x06"/\n\rSpeechContext\x12\x0f\n\x07phrases\x18\x01 \x03(\t\x12\r\n\x05\x62oost\x18\x04 \x01(\x02"D\n\x10RecognitionAudio\x12\x11\n\x07\x63ontent\x18\x01 \x01(\x0cH\x00\x12\r\n\x03uri\x18\x02 \x01(\tH\x00\x42\x0e\n\x0c\x61udio_source"\\\n\x11RecognizeResponse\x12G\n\x07results\x18\x02 \x03(\x0b\x32\x36.google.cloud.speech.v1p1beta1.SpeechRecognitionResult"g\n\x1cLongRunningRecognizeResponse\x12G\n\x07results\x18\x02 \x03(\x0b\x32\x36.google.cloud.speech.v1p1beta1.SpeechRecognitionResult"\x9e\x01\n\x1cLongRunningRecognizeMetadata\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x10last_update_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xbf\x02\n\x1aStreamingRecognizeResponse\x12!\n\x05\x65rror\x18\x01 \x01(\x0b\x32\x12.google.rpc.Status\x12J\n\x07results\x18\x02 \x03(\x0b\x32\x39.google.cloud.speech.v1p1beta1.StreamingRecognitionResult\x12\x64\n\x11speech_event_type\x18\x04 \x01(\x0e\x32I.google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.SpeechEventType"L\n\x0fSpeechEventType\x12\x1c\n\x18SPEECH_EVENT_UNSPECIFIED\x10\x00\x12\x1b\n\x17\x45ND_OF_SINGLE_UTTERANCE\x10\x01"\xf4\x01\n\x1aStreamingRecognitionResult\x12Q\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32;.google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative\x12\x10\n\x08is_final\x18\x02 \x01(\x08\x12\x11\n\tstability\x18\x03 \x01(\x02\x12\x32\n\x0fresult_end_time\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x13\n\x0b\x63hannel_tag\x18\x05 \x01(\x05\x12\x15\n\rlanguage_code\x18\x06 \x01(\t"\x98\x01\n\x17SpeechRecognitionResult\x12Q\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32;.google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative\x12\x13\n\x0b\x63hannel_tag\x18\x02 \x01(\x05\x12\x15\n\rlanguage_code\x18\x05 \x01(\t"~\n\x1cSpeechRecognitionAlternative\x12\x12\n\ntranscript\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x36\n\x05words\x18\x03 \x03(\x0b\x32\'.google.cloud.speech.v1p1beta1.WordInfo"\x9d\x01\n\x08WordInfo\x12-\n\nstart_time\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12+\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x0c\n\x04word\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x12\x13\n\x0bspeaker_tag\x18\x05 \x01(\x05\x32\xda\x03\n\x06Speech\x12\x96\x01\n\tRecognize\x12/.google.cloud.speech.v1p1beta1.RecognizeRequest\x1a\x30.google.cloud.speech.v1p1beta1.RecognizeResponse"&\x82\xd3\xe4\x93\x02 "\x1b/v1p1beta1/speech:recognize:\x01*\x12\xa4\x01\n\x14LongRunningRecognize\x12:.google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest\x1a\x1d.google.longrunning.Operation"1\x82\xd3\xe4\x93\x02+"&/v1p1beta1/speech:longrunningrecognize:\x01*\x12\x8f\x01\n\x12StreamingRecognize\x12\x38.google.cloud.speech.v1p1beta1.StreamingRecognizeRequest\x1a\x39.google.cloud.speech.v1p1beta1.StreamingRecognizeResponse"\x00(\x01\x30\x01\x42z\n!com.google.cloud.speech.v1p1beta1B\x0bSpeechProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/speech/v1p1beta1;speech\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_RECOGNITIONCONFIG_AUDIOENCODING = _descriptor.EnumDescriptor(
+    name="AudioEncoding",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ENCODING_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINEAR16", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLAC", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MULAW", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AMR", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AMR_WB", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OGG_OPUS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPEEX_WITH_HEADER_BYTE",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MP3", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1693,
+    serialized_end=1841,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONCONFIG_AUDIOENCODING)
+
+_RECOGNITIONMETADATA_INTERACTIONTYPE = _descriptor.EnumDescriptor(
+    name="InteractionType",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.InteractionType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="INTERACTION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISCUSSION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRESENTATION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PHONE_CALL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICEMAIL", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROFESSIONALLY_PRODUCED",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICE_SEARCH", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICE_COMMAND", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DICTATION", index=8, number=8, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2523,
+    serialized_end=2720,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_INTERACTIONTYPE)
+
+_RECOGNITIONMETADATA_MICROPHONEDISTANCE = _descriptor.EnumDescriptor(
+    name="MicrophoneDistance",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.MicrophoneDistance",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="MICROPHONE_DISTANCE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEARFIELD", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDFIELD", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FARFIELD", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2722,
+    serialized_end=2822,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_MICROPHONEDISTANCE)
+
+_RECOGNITIONMETADATA_ORIGINALMEDIATYPE = _descriptor.EnumDescriptor(
+    name="OriginalMediaType",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.OriginalMediaType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ORIGINAL_MEDIA_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUDIO", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2824,
+    serialized_end=2902,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_ORIGINALMEDIATYPE)
+
+_RECOGNITIONMETADATA_RECORDINGDEVICETYPE = _descriptor.EnumDescriptor(
+    name="RecordingDeviceType",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.RecordingDeviceType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RECORDING_DEVICE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SMARTPHONE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PC", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PHONE_LINE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VEHICLE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_OUTDOOR_DEVICE",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_INDOOR_DEVICE",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2905,
+    serialized_end=3069,
+)
+_sym_db.RegisterEnumDescriptor(_RECOGNITIONMETADATA_RECORDINGDEVICETYPE)
+
+_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE = _descriptor.EnumDescriptor(
+    name="SpeechEventType",
+    full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.SpeechEventType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SPEECH_EVENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="END_OF_SINGLE_UTTERANCE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3794,
+    serialized_end=3870,
+)
+_sym_db.RegisterEnumDescriptor(_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE)
+
+
+_RECOGNIZEREQUEST = _descriptor.Descriptor(
+    name="RecognizeRequest",
+    full_name="google.cloud.speech.v1p1beta1.RecognizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.speech.v1p1beta1.RecognizeRequest.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio",
+            full_name="google.cloud.speech.v1p1beta1.RecognizeRequest.audio",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=303,
+    serialized_end=451,
+)
+
+
+_LONGRUNNINGRECOGNIZEREQUEST = _descriptor.Descriptor(
+    name="LongRunningRecognizeRequest",
+    full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio",
+            full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest.audio",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=454,
+    serialized_end=613,
+)
+
+
+_STREAMINGRECOGNIZEREQUEST = _descriptor.Descriptor(
+    name="StreamingRecognizeRequest",
+    full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="streaming_config",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeRequest.streaming_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_content",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeRequest.audio_content",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="streaming_request",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeRequest.streaming_request",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=616,
+    serialized_end=776,
+)
+
+
+_STREAMINGRECOGNITIONCONFIG = _descriptor.Descriptor(
+    name="StreamingRecognitionConfig",
+    full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="config",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionConfig.config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="single_utterance",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionConfig.single_utterance",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interim_results",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionConfig.interim_results",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=779,
+    serialized_end=924,
+)
+
+
+_RECOGNITIONCONFIG = _descriptor.Descriptor(
+    name="RecognitionConfig",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="encoding",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.encoding",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sample_rate_hertz",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.sample_rate_hertz",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_channel_count",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.audio_channel_count",
+            index=2,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_separate_recognition_per_channel",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.enable_separate_recognition_per_channel",
+            index=3,
+            number=12,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.language_code",
+            index=4,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="alternative_language_codes",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.alternative_language_codes",
+            index=5,
+            number=18,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_alternatives",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.max_alternatives",
+            index=6,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profanity_filter",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.profanity_filter",
+            index=7,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_contexts",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.speech_contexts",
+            index=8,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_word_time_offsets",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.enable_word_time_offsets",
+            index=9,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_word_confidence",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.enable_word_confidence",
+            index=10,
+            number=15,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_automatic_punctuation",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.enable_automatic_punctuation",
+            index=11,
+            number=11,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_speaker_diarization",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.enable_speaker_diarization",
+            index=12,
+            number=16,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="diarization_speaker_count",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.diarization_speaker_count",
+            index=13,
+            number=17,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="diarization_config",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.diarization_config",
+            index=14,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.metadata",
+            index=15,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.model",
+            index=16,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="use_enhanced",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionConfig.use_enhanced",
+            index=17,
+            number=14,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_RECOGNITIONCONFIG_AUDIOENCODING],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=927,
+    serialized_end=1841,
+)
+
+
+_SPEAKERDIARIZATIONCONFIG = _descriptor.Descriptor(
+    name="SpeakerDiarizationConfig",
+    full_name="google.cloud.speech.v1p1beta1.SpeakerDiarizationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_speaker_diarization",
+            full_name="google.cloud.speech.v1p1beta1.SpeakerDiarizationConfig.enable_speaker_diarization",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_speaker_count",
+            full_name="google.cloud.speech.v1p1beta1.SpeakerDiarizationConfig.min_speaker_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_speaker_count",
+            full_name="google.cloud.speech.v1p1beta1.SpeakerDiarizationConfig.max_speaker_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1843,
+    serialized_end=1959,
+)
+
+
+_RECOGNITIONMETADATA = _descriptor.Descriptor(
+    name="RecognitionMetadata",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="interaction_type",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.interaction_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="industry_naics_code_of_audio",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.industry_naics_code_of_audio",
+            index=1,
+            number=3,
+            type=13,
+            cpp_type=3,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="microphone_distance",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.microphone_distance",
+            index=2,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="original_media_type",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.original_media_type",
+            index=3,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recording_device_type",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.recording_device_type",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recording_device_name",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.recording_device_name",
+            index=5,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="original_mime_type",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.original_mime_type",
+            index=6,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="obfuscated_id",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.obfuscated_id",
+            index=7,
+            number=9,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_topic",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionMetadata.audio_topic",
+            index=8,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _RECOGNITIONMETADATA_INTERACTIONTYPE,
+        _RECOGNITIONMETADATA_MICROPHONEDISTANCE,
+        _RECOGNITIONMETADATA_ORIGINALMEDIATYPE,
+        _RECOGNITIONMETADATA_RECORDINGDEVICETYPE,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1962,
+    serialized_end=3069,
+)
+
+
+_SPEECHCONTEXT = _descriptor.Descriptor(
+    name="SpeechContext",
+    full_name="google.cloud.speech.v1p1beta1.SpeechContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="phrases",
+            full_name="google.cloud.speech.v1p1beta1.SpeechContext.phrases",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="boost",
+            full_name="google.cloud.speech.v1p1beta1.SpeechContext.boost",
+            index=1,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3071,
+    serialized_end=3118,
+)
+
+
+_RECOGNITIONAUDIO = _descriptor.Descriptor(
+    name="RecognitionAudio",
+    full_name="google.cloud.speech.v1p1beta1.RecognitionAudio",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionAudio.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionAudio.uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="audio_source",
+            full_name="google.cloud.speech.v1p1beta1.RecognitionAudio.audio_source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3120,
+    serialized_end=3188,
+)
+
+
+_RECOGNIZERESPONSE = _descriptor.Descriptor(
+    name="RecognizeResponse",
+    full_name="google.cloud.speech.v1p1beta1.RecognizeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.speech.v1p1beta1.RecognizeResponse.results",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3190,
+    serialized_end=3282,
+)
+
+
+_LONGRUNNINGRECOGNIZERESPONSE = _descriptor.Descriptor(
+    name="LongRunningRecognizeResponse",
+    full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse.results",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3284,
+    serialized_end=3387,
+)
+
+
+_LONGRUNNINGRECOGNIZEMETADATA = _descriptor.Descriptor(
+    name="LongRunningRecognizeMetadata",
+    full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata.progress_percent",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata.start_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_update_time",
+            full_name="google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata.last_update_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3390,
+    serialized_end=3548,
+)
+
+
+_STREAMINGRECOGNIZERESPONSE = _descriptor.Descriptor(
+    name="StreamingRecognizeResponse",
+    full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.error",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_event_type",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognizeResponse.speech_event_type",
+            index=2,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3551,
+    serialized_end=3870,
+)
+
+
+_STREAMINGRECOGNITIONRESULT = _descriptor.Descriptor(
+    name="StreamingRecognitionResult",
+    full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_final",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult.is_final",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stability",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult.stability",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result_end_time",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult.result_end_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="channel_tag",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult.channel_tag",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.speech.v1p1beta1.StreamingRecognitionResult.language_code",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3873,
+    serialized_end=4117,
+)
+
+
+_SPEECHRECOGNITIONRESULT = _descriptor.Descriptor(
+    name="SpeechRecognitionResult",
+    full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionResult.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="channel_tag",
+            full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionResult.channel_tag",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionResult.language_code",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4120,
+    serialized_end=4272,
+)
+
+
+_SPEECHRECOGNITIONALTERNATIVE = _descriptor.Descriptor(
+    name="SpeechRecognitionAlternative",
+    full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transcript",
+            full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative.transcript",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4274,
+    serialized_end=4400,
+)
+
+
+_WORDINFO = _descriptor.Descriptor(
+    name="WordInfo",
+    full_name="google.cloud.speech.v1p1beta1.WordInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.speech.v1p1beta1.WordInfo.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.speech.v1p1beta1.WordInfo.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="word",
+            full_name="google.cloud.speech.v1p1beta1.WordInfo.word",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.speech.v1p1beta1.WordInfo.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speaker_tag",
+            full_name="google.cloud.speech.v1p1beta1.WordInfo.speaker_tag",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4403,
+    serialized_end=4560,
+)
+
+_RECOGNIZEREQUEST.fields_by_name["config"].message_type = _RECOGNITIONCONFIG
+_RECOGNIZEREQUEST.fields_by_name["audio"].message_type = _RECOGNITIONAUDIO
+_LONGRUNNINGRECOGNIZEREQUEST.fields_by_name["config"].message_type = _RECOGNITIONCONFIG
+_LONGRUNNINGRECOGNIZEREQUEST.fields_by_name["audio"].message_type = _RECOGNITIONAUDIO
+_STREAMINGRECOGNIZEREQUEST.fields_by_name[
+    "streaming_config"
+].message_type = _STREAMINGRECOGNITIONCONFIG
+_STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"].fields.append(
+    _STREAMINGRECOGNIZEREQUEST.fields_by_name["streaming_config"]
+)
+_STREAMINGRECOGNIZEREQUEST.fields_by_name[
+    "streaming_config"
+].containing_oneof = _STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"]
+_STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"].fields.append(
+    _STREAMINGRECOGNIZEREQUEST.fields_by_name["audio_content"]
+)
+_STREAMINGRECOGNIZEREQUEST.fields_by_name[
+    "audio_content"
+].containing_oneof = _STREAMINGRECOGNIZEREQUEST.oneofs_by_name["streaming_request"]
+_STREAMINGRECOGNITIONCONFIG.fields_by_name["config"].message_type = _RECOGNITIONCONFIG
+_RECOGNITIONCONFIG.fields_by_name[
+    "encoding"
+].enum_type = _RECOGNITIONCONFIG_AUDIOENCODING
+_RECOGNITIONCONFIG.fields_by_name["speech_contexts"].message_type = _SPEECHCONTEXT
+_RECOGNITIONCONFIG.fields_by_name[
+    "diarization_config"
+].message_type = _SPEAKERDIARIZATIONCONFIG
+_RECOGNITIONCONFIG.fields_by_name["metadata"].message_type = _RECOGNITIONMETADATA
+_RECOGNITIONCONFIG_AUDIOENCODING.containing_type = _RECOGNITIONCONFIG
+_RECOGNITIONMETADATA.fields_by_name[
+    "interaction_type"
+].enum_type = _RECOGNITIONMETADATA_INTERACTIONTYPE
+_RECOGNITIONMETADATA.fields_by_name[
+    "microphone_distance"
+].enum_type = _RECOGNITIONMETADATA_MICROPHONEDISTANCE
+_RECOGNITIONMETADATA.fields_by_name[
+    "original_media_type"
+].enum_type = _RECOGNITIONMETADATA_ORIGINALMEDIATYPE
+_RECOGNITIONMETADATA.fields_by_name[
+    "recording_device_type"
+].enum_type = _RECOGNITIONMETADATA_RECORDINGDEVICETYPE
+_RECOGNITIONMETADATA_INTERACTIONTYPE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONMETADATA_MICROPHONEDISTANCE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONMETADATA_ORIGINALMEDIATYPE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONMETADATA_RECORDINGDEVICETYPE.containing_type = _RECOGNITIONMETADATA
+_RECOGNITIONAUDIO.oneofs_by_name["audio_source"].fields.append(
+    _RECOGNITIONAUDIO.fields_by_name["content"]
+)
+_RECOGNITIONAUDIO.fields_by_name[
+    "content"
+].containing_oneof = _RECOGNITIONAUDIO.oneofs_by_name["audio_source"]
+_RECOGNITIONAUDIO.oneofs_by_name["audio_source"].fields.append(
+    _RECOGNITIONAUDIO.fields_by_name["uri"]
+)
+_RECOGNITIONAUDIO.fields_by_name[
+    "uri"
+].containing_oneof = _RECOGNITIONAUDIO.oneofs_by_name["audio_source"]
+_RECOGNIZERESPONSE.fields_by_name["results"].message_type = _SPEECHRECOGNITIONRESULT
+_LONGRUNNINGRECOGNIZERESPONSE.fields_by_name[
+    "results"
+].message_type = _SPEECHRECOGNITIONRESULT
+_LONGRUNNINGRECOGNIZEMETADATA.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LONGRUNNINGRECOGNIZEMETADATA.fields_by_name[
+    "last_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_STREAMINGRECOGNIZERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_STREAMINGRECOGNIZERESPONSE.fields_by_name[
+    "results"
+].message_type = _STREAMINGRECOGNITIONRESULT
+_STREAMINGRECOGNIZERESPONSE.fields_by_name[
+    "speech_event_type"
+].enum_type = _STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE
+_STREAMINGRECOGNIZERESPONSE_SPEECHEVENTTYPE.containing_type = (
+    _STREAMINGRECOGNIZERESPONSE
+)
+_STREAMINGRECOGNITIONRESULT.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_STREAMINGRECOGNITIONRESULT.fields_by_name[
+    "result_end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_SPEECHRECOGNITIONRESULT.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_SPEECHRECOGNITIONALTERNATIVE.fields_by_name["words"].message_type = _WORDINFO
+_WORDINFO.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_WORDINFO.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["RecognizeRequest"] = _RECOGNIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "LongRunningRecognizeRequest"
+] = _LONGRUNNINGRECOGNIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognizeRequest"
+] = _STREAMINGRECOGNIZEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognitionConfig"
+] = _STREAMINGRECOGNITIONCONFIG
+DESCRIPTOR.message_types_by_name["RecognitionConfig"] = _RECOGNITIONCONFIG
+DESCRIPTOR.message_types_by_name["SpeakerDiarizationConfig"] = _SPEAKERDIARIZATIONCONFIG
+DESCRIPTOR.message_types_by_name["RecognitionMetadata"] = _RECOGNITIONMETADATA
+DESCRIPTOR.message_types_by_name["SpeechContext"] = _SPEECHCONTEXT
+DESCRIPTOR.message_types_by_name["RecognitionAudio"] = _RECOGNITIONAUDIO
+DESCRIPTOR.message_types_by_name["RecognizeResponse"] = _RECOGNIZERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "LongRunningRecognizeResponse"
+] = _LONGRUNNINGRECOGNIZERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "LongRunningRecognizeMetadata"
+] = _LONGRUNNINGRECOGNIZEMETADATA
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognizeResponse"
+] = _STREAMINGRECOGNIZERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "StreamingRecognitionResult"
+] = _STREAMINGRECOGNITIONRESULT
+DESCRIPTOR.message_types_by_name["SpeechRecognitionResult"] = _SPEECHRECOGNITIONRESULT
+DESCRIPTOR.message_types_by_name[
+    "SpeechRecognitionAlternative"
+] = _SPEECHRECOGNITIONALTERNATIVE
+DESCRIPTOR.message_types_by_name["WordInfo"] = _WORDINFO
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+RecognizeRequest = _reflection.GeneratedProtocolMessageType(
+    "RecognizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNIZEREQUEST,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""The top-level message sent by the client for the ``Recognize`` method.
+  
+  
+  Attributes:
+      config:
+          *Required* Provides information to the recognizer that
+          specifies how to process the request.
+      audio:
+          *Required* The audio data to be recognized.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.RecognizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(RecognizeRequest)
+
+LongRunningRecognizeRequest = _reflection.GeneratedProtocolMessageType(
+    "LongRunningRecognizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LONGRUNNINGRECOGNIZEREQUEST,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""The top-level message sent by the client for the
+  ``LongRunningRecognize`` method.
+  
+  
+  Attributes:
+      config:
+          *Required* Provides information to the recognizer that
+          specifies how to process the request.
+      audio:
+          *Required* The audio data to be recognized.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.LongRunningRecognizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(LongRunningRecognizeRequest)
+
+StreamingRecognizeRequest = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognizeRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNIZEREQUEST,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      streaming_request:
+          The streaming request, which is either a streaming config or
+          audio content.
+      streaming_config:
+          Provides information to the recognizer that specifies how to
+          process the request. The first ``StreamingRecognizeRequest``
+          message must contain a ``streaming_config`` message.
+      audio_content:
+          The audio data to be recognized. Sequential chunks of audio
+          data are sent in sequential ``StreamingRecognizeRequest``
+          messages. The first ``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 pure binary representation (not
+          base64). See `content limits </speech-to-
+          text/quotas#content>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.StreamingRecognizeRequest)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognizeRequest)
+
+StreamingRecognitionConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognitionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNITIONCONFIG,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Provides information to the recognizer that specifies how to process the
+  request.
+  
+  
+  Attributes:
+      config:
+          *Required* Provides information to the recognizer that
+          specifies how to process the request.
+      single_utterance:
+          *Optional* 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
+          ``StreamingRecognitionResult``\ s with the ``is_final`` flag
+          set to ``true``.  If ``true``, the recognizer 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 recognition. It
+          will return no more than one ``StreamingRecognitionResult``
+          with the ``is_final`` flag set to ``true``.
+      interim_results:
+          *Optional* 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.StreamingRecognitionConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognitionConfig)
+
+RecognitionConfig = _reflection.GeneratedProtocolMessageType(
+    "RecognitionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNITIONCONFIG,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Provides information to the recognizer that specifies how to process the
+  request.
+  
+  
+  Attributes:
+      encoding:
+          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.v1p1beta1.Rec
+          ognitionConfig.AudioEncoding].
+      sample_rate_hertz:
+          Sample rate in Hertz of the audio data sent in all
+          ``RecognitionAudio`` messages. 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 is optional for ``FLAC`` and ``WAV``
+          audio files and required for all other audio formats. For
+          details, see [AudioEncoding][google.cloud.speech.v1p1beta1.Rec
+          ognitionConfig.AudioEncoding].
+      audio_channel_count:
+          *Optional* 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'. Valid value for MULAW, AMR, AMR\_WB and
+          SPEEX\_WITH\_HEADER\_BYTE is only ``1``. If ``0`` or omitted,
+          defaults to one channel (mono). Note: We only recognize the
+          first channel by default. To perform independent recognition
+          on each channel set
+          ``enable_separate_recognition_per_channel`` to 'true'.
+      enable_separate_recognition_per_channel:
+          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 request is billed cumulatively for all
+          channels recognized: ``audio_channel_count`` multiplied by the
+          length of the audio.
+      language_code:
+          *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.
+      alternative_language_codes:
+          *Optional* 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
+          transcription).
+      max_alternatives:
+          *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
+          ``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.
+      profanity_filter:
+          *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.
+      speech_contexts:
+          *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>`__.
+      enable_word_time_offsets:
+          *Optional* 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``.
+      enable_word_confidence:
+          *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``.
+      enable_automatic_punctuation:
+          *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.
+      enable_speaker_diarization:
+          *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:
+          Use diarization\_config instead.
+      diarization_speaker_count:
+          *Optional* 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.
+      diarization_config:
+          *Optional* 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.
+      metadata:
+          *Optional* Metadata regarding this request.
+      model:
+          *Optional* 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.  .. raw::
+          html     <table>  .. raw:: html     <tr>  ::
+          <td><b>Model</b></td>     <td><b>Description</b></td>  ..
+          raw:: html     </tr>  .. raw:: html     <tr>  ::
+          <td><code>command_and_search</code></td>     <td>Best for
+          short queries such as voice commands or voice search.</td>  ..
+          raw:: html     </tr>  .. raw:: html     <tr>  ::
+          <td><code>phone_call</code></td>     <td>Best for audio that
+          originated from a phone call (typically     recorded at an
+          8khz sampling rate).</td>  .. raw:: html     </tr>  .. raw::
+          html     <tr>  ::      <td><code>video</code></td>
+          <td>Best for audio that originated from from video or includes
+          multiple         speakers. Ideally the audio is recorded at a
+          16khz or greater         sampling rate. This is a premium
+          model that costs more than the         standard rate.</td>  ..
+          raw:: html     </tr>  .. raw:: html     <tr>  ::
+          <td><code>default</code></td>     <td>Best for audio that is
+          not one of the specific audio models.         For example,
+          long-form audio. Ideally the audio is high-fidelity,
+          recorded at a 16khz or greater sampling rate.</td>  .. raw::
+          html     </tr>  .. raw:: html     </table>
+      use_enhanced:
+          *Optional* 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.  If
+          ``use_enhanced`` is true and an enhanced version of the
+          specified model does not exist, then the speech is recognized
+          using the standard version of the specified model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.RecognitionConfig)
+    ),
+)
+_sym_db.RegisterMessage(RecognitionConfig)
+
+SpeakerDiarizationConfig = _reflection.GeneratedProtocolMessageType(
+    "SpeakerDiarizationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEAKERDIARIZATIONCONFIG,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""*Optional* Config to enable speaker diarization.
+  
+  
+  Attributes:
+      enable_speaker_diarization:
+          *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.
+      min_speaker_count:
+          *Optional* 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.
+      max_speaker_count:
+          *Optional* 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.SpeakerDiarizationConfig)
+    ),
+)
+_sym_db.RegisterMessage(SpeakerDiarizationConfig)
+
+RecognitionMetadata = _reflection.GeneratedProtocolMessageType(
+    "RecognitionMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNITIONMETADATA,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Description of audio data to be recognized.
+  
+  
+  Attributes:
+      interaction_type:
+          The use case most closely describing the audio content to be
+          recognized.
+      industry_naics_code_of_audio:
+          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/.
+      microphone_distance:
+          The audio type that most closely describes the audio being
+          recognized.
+      original_media_type:
+          The original media the speech was recorded on.
+      recording_device_type:
+          The type of device the speech was recorded with.
+      recording_device_name:
+          The device used to make the recording. Examples 'Nexus 5X' or
+          'Polycom SoundStation IP 6000' or 'POTS' or 'VoIP' or
+          'Cardioid Microphone'.
+      original_mime_type:
+          Mime type of the original audio file. For example
+          ``audio/m4a``, ``audio/x-alaw-basic``, ``audio/mp3``,
+          ``audio/3gpp``. A list of possible audio mime types is
+          maintained at http://www.iana.org/assignments/media-
+          types/media-types.xhtml#audio
+      obfuscated_id:
+          Obfuscated (privacy-protected) ID of the user, to identify
+          number of unique users using the service.
+      audio_topic:
+          Description of the content. Eg. "Recordings of federal supreme
+          court hearings from 2012".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.RecognitionMetadata)
+    ),
+)
+_sym_db.RegisterMessage(RecognitionMetadata)
+
+SpeechContext = _reflection.GeneratedProtocolMessageType(
+    "SpeechContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHCONTEXT,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Provides "hints" to the speech recognizer to favor specific words and
+  phrases in the results.
+  
+  
+  Attributes:
+      phrases:
+          *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 </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.
+      boost:
+          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 and 20. We recommend using a
+          binary search approach to finding the optimal value for your
+          use case.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.SpeechContext)
+    ),
+)
+_sym_db.RegisterMessage(SpeechContext)
+
+RecognitionAudio = _reflection.GeneratedProtocolMessageType(
+    "RecognitionAudio",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNITIONAUDIO,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""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>`__.
+  
+  
+  Attributes:
+      audio_source:
+          The audio source, which is either inline content or a Google
+          Cloud Storage uri.
+      content:
+          The audio data bytes encoded as specified in
+          ``RecognitionConfig``. Note: as with all bytes fields,
+          protobuffers use a pure binary representation, whereas JSON
+          representations use base64.
+      uri:
+          URI that points to a file that contains audio data bytes as
+          specified in ``RecognitionConfig``. The file must not be
+          compressed (for example, gzip). 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>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.RecognitionAudio)
+    ),
+)
+_sym_db.RegisterMessage(RecognitionAudio)
+
+RecognizeResponse = _reflection.GeneratedProtocolMessageType(
+    "RecognizeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RECOGNIZERESPONSE,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""The only message returned to the client by the ``Recognize`` method. It
+  contains the result as zero or more sequential
+  ``SpeechRecognitionResult`` messages.
+  
+  
+  Attributes:
+      results:
+          Output only. Sequential list of transcription results
+          corresponding to sequential portions of audio.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.RecognizeResponse)
+    ),
+)
+_sym_db.RegisterMessage(RecognizeResponse)
+
+LongRunningRecognizeResponse = _reflection.GeneratedProtocolMessageType(
+    "LongRunningRecognizeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LONGRUNNINGRECOGNIZERESPONSE,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""The only message returned to the client by the ``LongRunningRecognize``
+  method. It contains the result as zero or more sequential
+  ``SpeechRecognitionResult`` messages. It is included in the
+  ``result.response`` field of the ``Operation`` returned by the
+  ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      results:
+          Output only. Sequential list of transcription results
+          corresponding to sequential portions of audio.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse)
+    ),
+)
+_sym_db.RegisterMessage(LongRunningRecognizeResponse)
+
+LongRunningRecognizeMetadata = _reflection.GeneratedProtocolMessageType(
+    "LongRunningRecognizeMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LONGRUNNINGRECOGNIZEMETADATA,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Describes the progress of a long-running ``LongRunningRecognize`` call.
+  It is included in the ``metadata`` field of the ``Operation`` returned
+  by the ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      progress_percent:
+          Approximate percentage of audio processed thus far. Guaranteed
+          to be 100 when the audio is fully processed and the results
+          are available.
+      start_time:
+          Time when the request was received.
+      last_update_time:
+          Time of the most recent processing update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata)
+    ),
+)
+_sym_db.RegisterMessage(LongRunningRecognizeMetadata)
+
+StreamingRecognizeResponse = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognizeResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNIZERESPONSE,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""``StreamingRecognizeResponse`` is the only message returned to the
+  client by ``StreamingRecognize``. A series of zero or more
+  ``StreamingRecognizeResponse`` messages are streamed back to the client.
+  If there is no recognizable audio, and ``single_utterance`` is set to
+  false, then no messages are streamed back to the client.
+  
+  Here's an example of a series of ten ``StreamingRecognizeResponse``\ s
+  that might be returned while processing audio:
+  
+  1. results { alternatives { transcript: "tube" } stability: 0.01 }
+  
+  2. results { alternatives { transcript: "to be a" } stability: 0.01 }
+  
+  3. results { alternatives { transcript: "to be" } stability: 0.9 }
+     results { alternatives { transcript: " or not to be" } stability:
+     0.01 }
+  
+  4. results { alternatives { transcript: "to be or not to be" confidence:
+     0.92 } alternatives { transcript: "to bee or not to bee" } is\_final:
+     true }
+  
+  5. results { alternatives { transcript: " that's" } stability: 0.01 }
+  
+  6. results { alternatives { transcript: " that is" } stability: 0.9 }
+     results { alternatives { transcript: " the question" } stability:
+     0.01 }
+  
+  7. results { alternatives { transcript: " that is the question"
+     confidence: 0.98 } alternatives { transcript: " that was the
+     question" } is\_final: true }
+  
+  Notes:
+  
+  -  Only two of the above responses #4 and #7 contain final results; they
+     are indicated by ``is_final: true``. Concatenating these together
+     generates the full transcript: "to be or not to be that is the
+     question".
+  
+  -  The others contain interim ``results``. #3 and #6 contain two interim
+     ``results``: the first portion has a high stability and is less
+     likely to change; the second portion has a low stability and is very
+     likely to change. A UI designer might choose to show only high
+     stability ``results``.
+  
+  -  The specific ``stability`` and ``confidence`` values shown above are
+     only for illustrative purposes. Actual values may vary.
+  
+  -  In each response, only one of these fields will be set: ``error``,
+     ``speech_event_type``, or one or more (repeated) ``results``.
+  
+  
+  Attributes:
+      error:
+          Output only. If set, returns a
+          [google.rpc.Status][google.rpc.Status] message that specifies
+          the error for the operation.
+      results:
+          Output only. 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).
+      speech_event_type:
+          Output only. Indicates the type of speech event.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.StreamingRecognizeResponse)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognizeResponse)
+
+StreamingRecognitionResult = _reflection.GeneratedProtocolMessageType(
+    "StreamingRecognitionResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGRECOGNITIONRESULT,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""A streaming speech recognition result corresponding to a portion of the
+  audio that is currently being processed.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+      is_final:
+          Output only. 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.
+      stability:
+          Output only. 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.
+      result_end_time:
+          Output only. Time offset of the end of this result relative to
+          the beginning of the audio.
+      channel_tag:
+          For multi-channel audio, this is the channel number
+          corresponding to the recognized result for the audio from that
+          channel. For audio\_channel\_count = N, its output values can
+          range from '1' to 'N'.
+      language_code:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.StreamingRecognitionResult)
+    ),
+)
+_sym_db.RegisterMessage(StreamingRecognitionResult)
+
+SpeechRecognitionResult = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionResult",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONRESULT,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""A speech recognition result corresponding to a portion of the audio.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+      channel_tag:
+          For multi-channel audio, this is the channel number
+          corresponding to the recognized result for the audio from that
+          channel. For audio\_channel\_count = N, its output values can
+          range from '1' to 'N'.
+      language_code:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.SpeechRecognitionResult)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionResult)
+
+SpeechRecognitionAlternative = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionAlternative",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONALTERNATIVE,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Alternative hypotheses (a.k.a. n-best list).
+  
+  
+  Attributes:
+      transcript:
+          Output only. Transcript text representing the words that the
+          user spoke.
+      confidence:
+          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 set only for
+          the top alternative of a non-streaming result or, of a
+          streaming result where ``is_final=true``. 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.
+      words:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionAlternative)
+
+WordInfo = _reflection.GeneratedProtocolMessageType(
+    "WordInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORDINFO,
+        __module__="google.cloud.speech_v1p1beta1.proto.cloud_speech_pb2",
+        __doc__="""Word-specific information for recognized words.
+  
+  
+  Attributes:
+      start_time:
+          Output only. 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. This is an experimental feature
+          and the accuracy of the time offset can vary.
+      end_time:
+          Output only. 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. This is an experimental feature
+          and the accuracy of the time offset can vary.
+      word:
+          Output only. The word corresponding to this set of
+          information.
+      confidence:
+          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 set only for
+          the top alternative of a non-streaming result or, of a
+          streaming result where ``is_final=true``. 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.
+      speaker_tag:
+          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' to diarization\_speaker\_count. speaker\_tag
+          is set if enable\_speaker\_diarization = 'true' and only in
+          the top alternative.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.speech.v1p1beta1.WordInfo)
+    ),
+)
+_sym_db.RegisterMessage(WordInfo)
+
+
+DESCRIPTOR._options = None
+_RECOGNITIONCONFIG.fields_by_name["enable_speaker_diarization"]._options = None
+_RECOGNITIONCONFIG.fields_by_name["diarization_speaker_count"]._options = None
+
+_SPEECH = _descriptor.ServiceDescriptor(
+    name="Speech",
+    full_name="google.cloud.speech.v1p1beta1.Speech",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4563,
+    serialized_end=5037,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="Recognize",
+            full_name="google.cloud.speech.v1p1beta1.Speech.Recognize",
+            index=0,
+            containing_service=None,
+            input_type=_RECOGNIZEREQUEST,
+            output_type=_RECOGNIZERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002 "\033/v1p1beta1/speech:recognize:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LongRunningRecognize",
+            full_name="google.cloud.speech.v1p1beta1.Speech.LongRunningRecognize",
+            index=1,
+            containing_service=None,
+            input_type=_LONGRUNNINGRECOGNIZEREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002+"&/v1p1beta1/speech:longrunningrecognize:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StreamingRecognize",
+            full_name="google.cloud.speech.v1p1beta1.Speech.StreamingRecognize",
+            index=2,
+            containing_service=None,
+            input_type=_STREAMINGRECOGNIZEREQUEST,
+            output_type=_STREAMINGRECOGNIZERESPONSE,
+            serialized_options=None,
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_SPEECH)
+
+DESCRIPTOR.services_by_name["Speech"] = _SPEECH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2_grpc.py b/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2_grpc.py
new file mode 100644
index 000000000000..750e4b781acc
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/proto/cloud_speech_pb2_grpc.py
@@ -0,0 +1,91 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.speech_v1p1beta1.proto import (
+    cloud_speech_pb2 as google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class SpeechStub(object):
+    """Service that implements Google Cloud Speech API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.Recognize = channel.unary_unary(
+            "/google.cloud.speech.v1p1beta1.Speech/Recognize",
+            request_serializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.RecognizeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.RecognizeResponse.FromString,
+        )
+        self.LongRunningRecognize = channel.unary_unary(
+            "/google.cloud.speech.v1p1beta1.Speech/LongRunningRecognize",
+            request_serializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.LongRunningRecognizeRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.StreamingRecognize = channel.stream_stream(
+            "/google.cloud.speech.v1p1beta1.Speech/StreamingRecognize",
+            request_serializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeResponse.FromString,
+        )
+
+
+class SpeechServicer(object):
+    """Service that implements Google Cloud Speech API.
+  """
+
+    def Recognize(self, request, context):
+        """Performs synchronous speech recognition: receive results after all audio
+    has been sent and processed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LongRunningRecognize(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StreamingRecognize(self, request_iterator, context):
+        """Performs bidirectional streaming speech recognition: receive results while
+    sending audio. This method is only available via the gRPC API (not REST).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_SpeechServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "Recognize": grpc.unary_unary_rpc_method_handler(
+            servicer.Recognize,
+            request_deserializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.RecognizeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.RecognizeResponse.SerializeToString,
+        ),
+        "LongRunningRecognize": grpc.unary_unary_rpc_method_handler(
+            servicer.LongRunningRecognize,
+            request_deserializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.LongRunningRecognizeRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "StreamingRecognize": grpc.stream_stream_rpc_method_handler(
+            servicer.StreamingRecognize,
+            request_deserializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeRequest.FromString,
+            response_serializer=google_dot_cloud_dot_speech__v1p1beta1_dot_proto_dot_cloud__speech__pb2.StreamingRecognizeResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.speech.v1p1beta1.Speech", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/speech/google/cloud/speech_v1p1beta1/types.py b/speech/google/cloud/speech_v1p1beta1/types.py
new file mode 100644
index 000000000000..f7415a2b9c1c
--- /dev/null
+++ b/speech/google/cloud/speech_v1p1beta1/types.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.speech_v1p1beta1.proto import cloud_speech_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, status_pb2]
+
+_local_modules = [cloud_speech_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.speech_v1p1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/speech/noxfile.py b/speech/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/speech/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/speech/pylint.config.py b/speech/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/speech/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/speech/setup.cfg b/speech/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/speech/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/speech/setup.py b/speech/setup.py
new file mode 100644
index 000000000000..d5344e4f369c
--- /dev/null
+++ b/speech/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-speech"
+description = "Google Cloud Speech API client library"
+version = "1.2.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/speech/synth.metadata b/speech/synth.metadata
new file mode 100644
index 000000000000..78f193e56bfd
--- /dev/null
+++ b/speech/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T16:44:05.691252Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "speech",
+        "apiVersion": "v1p1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/speech/artman_speech_v1p1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "speech",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/speech/artman_speech_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/speech/synth.py b/speech/synth.py
new file mode 100644
index 000000000000..20a617c82c9b
--- /dev/null
+++ b/speech/synth.py
@@ -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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import re
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1p1beta1", "v1"]
+
+
+# ----------------------------------------------------------------------------
+# Generate speech GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("speech", version, include_protos=True)
+
+    # Don't move over __init__.py, as we modify it to make the generated client
+    # use helpers.py.
+    s.move(library / f"google/cloud/speech_{version}/types.py")
+    s.move(library / f"google/cloud/speech_{version}/gapic")
+    s.move(library / f"google/cloud/speech_{version}/proto")
+    s.move(library / f"tests/unit/gapic/{version}")
+    s.move(library / f"docs/gapic/{version}")
+
+
+# Use the highest version library to generate documentation import alias.
+s.move(library / "google/cloud/speech.py")
+
+
+# Fix tests to use the direct gapic client instead of the wrapped helper
+# client.
+s.replace(
+    "tests/unit/**/test*client*.py",
+    r"from google\.cloud import speech_(.+?)$",
+    r"from google.cloud.speech_\1.gapic import speech_client as speech_\1",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/speech/tests/system/gapic/v1/test_system_speech_v1.py b/speech/tests/system/gapic/v1/test_system_speech_v1.py
new file mode 100644
index 000000000000..080e431ad81d
--- /dev/null
+++ b/speech/tests/system/gapic/v1/test_system_speech_v1.py
@@ -0,0 +1,36 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+
+from google.cloud import speech_v1
+from google.cloud.speech_v1 import enums
+from google.cloud.speech_v1.proto import cloud_speech_pb2
+
+
+class TestSystemSpeech(object):
+    def test_recognize(self):
+
+        client = speech_v1.SpeechClient()
+        language_code = "en-US"
+        sample_rate_hertz = 44100
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        config = {
+            "language_code": language_code,
+            "sample_rate_hertz": sample_rate_hertz,
+            "encoding": encoding,
+        }
+        uri = "gs://gapic-toolkit/hello.flac"
+        audio = {"uri": uri}
+        response = client.recognize(config, audio)
diff --git a/speech/tests/system/gapic/v1p1beta1/test_system_speech_v1p1beta1.py b/speech/tests/system/gapic/v1p1beta1/test_system_speech_v1p1beta1.py
new file mode 100644
index 000000000000..36636c3e2479
--- /dev/null
+++ b/speech/tests/system/gapic/v1p1beta1/test_system_speech_v1p1beta1.py
@@ -0,0 +1,36 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+
+from google.cloud import speech_v1p1beta1
+from google.cloud.speech_v1p1beta1 import enums
+from google.cloud.speech_v1p1beta1.proto import cloud_speech_pb2
+
+
+class TestSystemSpeech(object):
+    def test_recognize(self):
+
+        client = speech_v1p1beta1.SpeechClient()
+        language_code = "en-US"
+        sample_rate_hertz = 44100
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        config = {
+            "language_code": language_code,
+            "sample_rate_hertz": sample_rate_hertz,
+            "encoding": encoding,
+        }
+        uri = "gs://gapic-toolkit/hello.flac"
+        audio = {"uri": uri}
+        response = client.recognize(config, audio)
diff --git a/speech/tests/unit/gapic/v1/test_speech_client_v1.py b/speech/tests/unit/gapic/v1/test_speech_client_v1.py
new file mode 100644
index 000000000000..20f7ecfcc1f4
--- /dev/null
+++ b/speech/tests/unit/gapic/v1/test_speech_client_v1.py
@@ -0,0 +1,244 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud.speech_v1.gapic import speech_client as speech_v1
+from google.cloud.speech_v1 import enums
+from google.cloud.speech_v1.proto import cloud_speech_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestSpeechClient(object):
+    def test_recognize(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_speech_pb2.RecognizeResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1.SpeechClient()
+
+        # Setup Request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        response = client.recognize(config, audio)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_speech_pb2.RecognizeRequest(config=config, audio=audio)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_recognize_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1.SpeechClient()
+
+        # Setup request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        with pytest.raises(CustomException):
+            client.recognize(config, audio)
+
+    def test_long_running_recognize(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_speech_pb2.LongRunningRecognizeResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_long_running_recognize", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1.SpeechClient()
+
+        # Setup Request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        response = client.long_running_recognize(config, audio)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_speech_pb2.LongRunningRecognizeRequest(
+            config=config, audio=audio
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_long_running_recognize_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_long_running_recognize_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1.SpeechClient()
+
+        # Setup Request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        response = client.long_running_recognize(config, audio)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_streaming_recognize(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_speech_pb2.StreamingRecognizeResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1.SpeechClient()
+
+        # Setup Request
+        request = {}
+        request = cloud_speech_pb2.StreamingRecognizeRequest(**request)
+        requests = [request]
+
+        response = client.streaming_recognize(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_streaming_recognize_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1.SpeechClient()
+
+        # Setup request
+        request = {}
+
+        request = cloud_speech_pb2.StreamingRecognizeRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.streaming_recognize(requests)
diff --git a/speech/tests/unit/gapic/v1p1beta1/test_speech_client_v1p1beta1.py b/speech/tests/unit/gapic/v1p1beta1/test_speech_client_v1p1beta1.py
new file mode 100644
index 000000000000..93fc62289fe7
--- /dev/null
+++ b/speech/tests/unit/gapic/v1p1beta1/test_speech_client_v1p1beta1.py
@@ -0,0 +1,244 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud.speech_v1p1beta1.gapic import speech_client as speech_v1p1beta1
+from google.cloud.speech_v1p1beta1 import enums
+from google.cloud.speech_v1p1beta1.proto import cloud_speech_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestSpeechClient(object):
+    def test_recognize(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_speech_pb2.RecognizeResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1p1beta1.SpeechClient()
+
+        # Setup Request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        response = client.recognize(config, audio)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_speech_pb2.RecognizeRequest(config=config, audio=audio)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_recognize_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1p1beta1.SpeechClient()
+
+        # Setup request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        with pytest.raises(CustomException):
+            client.recognize(config, audio)
+
+    def test_long_running_recognize(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_speech_pb2.LongRunningRecognizeResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_long_running_recognize", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1p1beta1.SpeechClient()
+
+        # Setup Request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        response = client.long_running_recognize(config, audio)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_speech_pb2.LongRunningRecognizeRequest(
+            config=config, audio=audio
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_long_running_recognize_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_long_running_recognize_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1p1beta1.SpeechClient()
+
+        # Setup Request
+        encoding = enums.RecognitionConfig.AudioEncoding.FLAC
+        sample_rate_hertz = 44100
+        language_code = "en-US"
+        config = {
+            "encoding": encoding,
+            "sample_rate_hertz": sample_rate_hertz,
+            "language_code": language_code,
+        }
+        uri = "gs://bucket_name/file_name.flac"
+        audio = {"uri": uri}
+
+        response = client.long_running_recognize(config, audio)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_streaming_recognize(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_speech_pb2.StreamingRecognizeResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1p1beta1.SpeechClient()
+
+        # Setup Request
+        request = {}
+        request = cloud_speech_pb2.StreamingRecognizeRequest(**request)
+        requests = [request]
+
+        response = client.streaming_recognize(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_streaming_recognize_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = speech_v1p1beta1.SpeechClient()
+
+        # Setup request
+        request = {}
+
+        request = cloud_speech_pb2.StreamingRecognizeRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.streaming_recognize(requests)
diff --git a/speech/tests/unit/test_helpers.py b/speech/tests/unit/test_helpers.py
new file mode 100644
index 000000000000..366b1821dd4c
--- /dev/null
+++ b/speech/tests/unit/test_helpers.py
@@ -0,0 +1,53 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+from types import GeneratorType
+
+import mock
+
+import google.auth.credentials
+from google.cloud.speech_v1 import SpeechClient
+from google.cloud.speech_v1 import types
+
+
+def make_speech_client():
+    credentials = mock.Mock(spec=google.auth.credentials.Credentials)
+    return SpeechClient(credentials=credentials)
+
+
+def test_streaming_recognize():
+    client = make_speech_client()
+
+    config = types.StreamingRecognitionConfig()
+    requests = [types.StreamingRecognizeRequest(audio_content=b"...")]
+    super_patch = mock.patch(
+        "google.cloud.speech_v1.speech_client.SpeechClient." "streaming_recognize",
+        autospec=True,
+    )
+
+    with super_patch as streaming_recognize:
+        client.streaming_recognize(config, requests)
+
+    # Assert that we called streaming recognize with an iterable
+    # that evaluates to the correct format.
+    _, args, kwargs = streaming_recognize.mock_calls[0]
+    api_requests = args[1]
+    assert isinstance(api_requests, GeneratorType)
+    assert list(api_requests) == [
+        types.StreamingRecognizeRequest(streaming_config=config),
+        requests[0],
+    ]
+    assert "retry" in kwargs
+    assert "timeout" in kwargs
diff --git a/storage/.coveragerc b/storage/.coveragerc
new file mode 100644
index 000000000000..098720f672e1
--- /dev/null
+++ b/storage/.coveragerc
@@ -0,0 +1,16 @@
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
diff --git a/storage/.flake8 b/storage/.flake8
new file mode 100644
index 000000000000..61766fa84d02
--- /dev/null
+++ b/storage/.flake8
@@ -0,0 +1,13 @@
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/storage/.repo-metadata.json b/storage/.repo-metadata.json
new file mode 100644
index 000000000000..0468fe0d51e7
--- /dev/null
+++ b/storage/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "storage",
+  "name_pretty": "Google Cloud Storage",
+  "product_documentation": "https://cloud.google.com/storage",
+  "client_documentation": "https://googleapis.dev/python/storage/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559782",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-storage",
+  "api_id": "storage.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/storage/CHANGELOG.md b/storage/CHANGELOG.md
new file mode 100644
index 000000000000..e0220b603712
--- /dev/null
+++ b/storage/CHANGELOG.md
@@ -0,0 +1,302 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-storage/#history
+
+## 1.19.0
+
+08-28-2019 09:45 PDT
+
+### Implementation Changes
+- Expose 'HMACKeyMetadata.id' field. ([#9115](https://github.com/googleapis/google-cloud-python/pull/9115))
+- Make 'Blob.bucket' a readonly property. ([#9113](https://github.com/googleapis/google-cloud-python/pull/9113))
+- Clarify 'response_type' for signed_url methods. ([#8942](https://github.com/googleapis/google-cloud-python/pull/8942))
+
+### New Features
+- Add `client_options` to constructors for manual clients. ([#9054](https://github.com/googleapis/google-cloud-python/pull/9054))
+
+### Documentation
+- Remove compatability badges from READMEs. ([#9035](https://github.com/googleapis/google-cloud-python/pull/9035))
+
+### Internal / Testing Changes
+- Remove CI for gh-pages, use googleapis.dev for api_core refs. ([#9085](https://github.com/googleapis/google-cloud-python/pull/9085))
+- Fix tests broken by yesterday's google-resumable-media release. ([#9119](https://github.com/googleapis/google-cloud-python/pull/9119))
+- Harden 'test_access_to_public_bucket' systest against 429 / 503 errors. ([#8997](https://github.com/googleapis/google-cloud-python/pull/8997))
+
+## 1.18.0
+
+08-07-2019 00:37 PDT
+
+
+### New Features
+- Add HMAC key support. ([#8430](https://github.com/googleapis/google-cloud-python/pull/8430))
+
+### Documentation
+- Mark old storage classes as legacy, not deprecated. ([#8887](https://github.com/googleapis/google-cloud-python/pull/8887))
+
+### Internal / Testing Changes
+- Normalize 'lint' / 'blacken' support under nox. ([#8831](https://github.com/googleapis/google-cloud-python/pull/8831))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 1.17.0
+
+07-24-2019 12:37 PDT
+
+
+### New Features
+- Add `Bucket.location_type` property. ([#8570](https://github.com/googleapis/google-cloud-python/pull/8570))
+- Add `Client.list_blobs(bucket_or_name)`. ([#8375](https://github.com/googleapis/google-cloud-python/pull/8375))
+
+
+### Implementation Changes
+- Retry bucket creation in signing setup. ([#8620](https://github.com/googleapis/google-cloud-python/pull/8620))
+- Fix URI -> blob name conversion in `Client download_blob_to_file`. ([#8440](https://github.com/googleapis/google-cloud-python/pull/8440))
+- Avoid escaping tilde in blob public / signed URLs. ([#8434](https://github.com/googleapis/google-cloud-python/pull/8434))
+- Add generation to 'Blob.__repr__'. ([#8423](https://github.com/googleapis/google-cloud-python/pull/8423))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fix example in `Client.download_blob_to_file` docstring. ([#8629](https://github.com/googleapis/google-cloud-python/pull/8629))
+- Remove typing information for kwargs to not conflict with type checkers ([#8546](https://github.com/googleapis/google-cloud-python/pull/8546))
+
+### Internal / Testing Changes
+- Skip failing `test_bpo_set_unset_preserves_acls` systest. ([#8617](https://github.com/googleapis/google-cloud-python/pull/8617))
+- Add nox session 'docs'. ([#8478](https://github.com/googleapis/google-cloud-python/pull/8478))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+
+## 1.16.1
+
+06-04-2019 11:09 PDT
+
+
+### Dependencies
+- Don't pin `google-api-core` in libs using `google-cloud-core`. ([#8213](https://github.com/googleapis/google-cloud-python/pull/8213))
+
+### Documentation
+- Fix example in `download_blob_to_file` docstring. ([#8201](https://github.com/googleapis/google-cloud-python/pull/8201))
+- Tweak `fields` docstring further. ([#8040](https://github.com/googleapis/google-cloud-python/pull/8040))
+- Improve docs for `fields` argument to `Bucket.list_blobs`. ([#8023](https://github.com/googleapis/google-cloud-python/pull/8023))
+- Fix docs typo. ([#8027](https://github.com/googleapis/google-cloud-python/pull/8027))
+
+### Internal / Testing Changes
+- Retry harder in face of 409/429 during module teardown. ([#8113](https://github.com/googleapis/google-cloud-python/pull/8113))
+- Add more retries for 429s during teardown operations. ([#8112](https://github.com/googleapis/google-cloud-python/pull/8112))
+
+## 1.16.0
+
+05-16-2019 12:55 PDT
+
+
+### New Features
+- Update `Client.create_bucket` to take a Bucket object or string. ([#7820](https://github.com/googleapis/google-cloud-python/pull/7820))
+- Update `Client.get_bucket` to take a `Bucket` object or string. ([#7856](https://github.com/googleapis/google-cloud-python/pull/7856))
+- Add `Client.download_blob_to_file` method. ([#7949](https://github.com/googleapis/google-cloud-python/pull/7949))
+- Add `client_info` support to client / connection. ([#7872](https://github.com/googleapis/google-cloud-python/pull/7872))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+- Pin `google-auth >= 1.2.0`. ([#7798](https://github.com/googleapis/google-cloud-python/pull/7798))
+
+## 1.15.0
+
+04-17-2019 15:37 PDT
+
+### New Features
+- Add support for V4 signed URLs ([#7460](https://github.com/googleapis/google-cloud-python/pull/7460))
+- Add generation arguments to bucket / blob methods. ([#7444](https://github.com/googleapis/google-cloud-python/pull/7444))
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Ensure that 'Blob.reload' passes encryption headers. ([#7441](https://github.com/googleapis/google-cloud-python/pull/7441))
+
+### Documentation
+- Update client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+- Fix failing system tests ([#7714](https://github.com/googleapis/google-cloud-python/pull/7714))
+- Increase number of retries for 429 errors. ([#7484](https://github.com/googleapis/google-cloud-python/pull/7484))
+- Un-flake KMS integration tests expecting empty bucket. ([#7479](https://github.com/googleapis/google-cloud-python/pull/7479))
+
+## 1.14.0
+
+02-06-2019 12:49 PST
+
+
+### New Features
+- Add 'Bucket.iam_configuration' property, enabling Bucket-Policy-Only. ([#7066](https://github.com/googleapis/google-cloud-python/pull/7066))
+
+### Documentation
+- Improve docs for 'generate_signed_url'. ([#7201](https://github.com/googleapis/google-cloud-python/pull/7201))
+
+## 1.13.2
+
+12-17-2018 17:02 PST
+
+
+### Implementation Changes
+- Update `Blob.update_storage_class` to support rewrite tokens. ([#6527](https://github.com/googleapis/google-cloud-python/pull/6527))
+
+### Internal / Testing Changes
+- Skip signing tests for insufficient credentials ([#6917](https://github.com/googleapis/google-cloud-python/pull/6917))
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize docs for `page_size` / `max_results` / `page_token`. ([#6842](https://github.com/googleapis/google-cloud-python/pull/6842))
+
+## 1.13.1
+
+12-10-2018 13:31 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Accomodate new back-end restriction on retention period. ([#6388](https://github.com/googleapis/google-cloud-python/pull/6388))
+- Avoid deleting a blob renamed to itself ([#6365](https://github.com/googleapis/google-cloud-python/pull/6365))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Blacken libraries ([#6794](https://github.com/googleapis/google-cloud-python/pull/6794))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Harden teardown in system tests. ([#6444](https://github.com/googleapis/google-cloud-python/pull/6444))
+- Harden `create_bucket` call in systests vs. 429 TooManyRequests. ([#6401](https://github.com/googleapis/google-cloud-python/pull/6401))
+- Skip public bucket test in VPC Service Controls  ([#6230](https://github.com/googleapis/google-cloud-python/pull/6230))
+- Fix lint failure. ([#6219](https://github.com/googleapis/google-cloud-python/pull/6219))
+- Disable test running in VPC Service Controls  restricted environment ([#6215](https://github.com/googleapis/google-cloud-python/pull/6215))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 1.13.0
+
+### New Features
+- Add support for bucket retention policies ([#5534](https://github.com/googleapis/google-cloud-python/pull/5534))
+- Allow `destination.content_type` to be None in `Blob.compose`. ([#6031](https://github.com/googleapis/google-cloud-python/pull/6031))
+
+### Implementation Changes
+- Ensure that `method` for `Blob.generate_signed_url` is uppercase. ([#6110](https://github.com/googleapis/google-cloud-python/pull/6110))
+
+### Documentation
+- Clarify GCS URL signing limitations on GCE ([#6104](https://github.com/googleapis/google-cloud-python/pull/6104))
+- Redirect renamed 'usage.html'/'client.html' -> 'index.html'. ([#5996](https://github.com/googleapis/google-cloud-python/pull/5996))
+
+## 1.12.0
+
+### New Features
+- Add support for Python 3.7, drop support for Python 3.4. ([#5942](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5942))
+- Add lifecycle rules helpers to bucket. ([#5877](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5877))
+
+### Implementation Changes
+- Add 'stacklevel=2' to deprecation warnings. ([#5897](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5897))
+
+### Documentation
+- Storage docs: fix typos. ([#5933](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5933))
+- Prep storage docs for repo split. ([#5923](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5923))
+
+### Internal / Testing Changes
+- Harden systest teardown further. ([#5900](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5900))
+- Nox: use inplace installs ([#5865](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5865))
+
+## 1.11.0
+
+### Implementation Changes
+- Preserve message / args from an `InvalidResponse`. (#5492)
+- Fix generating signed urls for blobs with non-ascii names. (#5625)
+- Move bucket location specification to `Bucket.create`; deprecate `Bucket.location` setter (#5808)
+
+### New Features
+- Add `Client.get_service_account_email`. (#5765)
+
+### Documentation
+- Clarify `None` values for resource-backed properties. (#5509)
+- Elaborate docs for `{Bucket,Blob}.make_{public,private}`; note how to enable anonymous accesss to `Blob.public_url`. (#5767)
+
+### Internal / Testing Changes
+- Harden `create_bucket` systest against 429 responses. (#5535)
+- Add system test: signed URLs w/ non-ASCII blob name. (#5626)
+- Harden `tearDownModule` against 429 TooManyRequests. (#5701)
+- Retry `notification.create()` on `503 ServiceUnavailable`. (#5741)
+- Fix failing KMS system tests. (#5832, #5837, #5860)
+
+## 1.10.0
+
+### New Features
+- Add support for KMS keys (#5259)
+- Add `{Blob,Bucket}make_private` method (#5336)
+
+### Internal / Testing Changes
+- Modify system tests to use prerelease versions of grpcio (#5304)
+
+## 1.9.0
+
+### Implementation Changes
+- Change GCS batch endpoint from `/batch` to `/batch/storage/v1` (#5040)
+
+### New Features
+- Allow uploading files larger than 2GB by using Resumable Media Requests (#5187)
+- Add range downloads (#5081)
+
+### Documentation
+- Update docstring to reflect correct units (#5277)
+- Replace link to 404 object IAM docs with a note on limited utility. (#5181)
+- Update doc reference in GCS client documentation (#5084)
+- Add see also for `Bucket.create` method call for `Client.create_bucket()` documentation. (#5073)
+- Link out to requester pays docs. (#5065)
+
+### Internal / Testing Changes
+- Add testing support for Python 3.7; remove testing support for Python 3.4. (#5295)
+- Fix bad trove classifier
+- Remove unused var (flake8 warning) (#5280)
+- Fix unit test moving batch to batch/storage/v1 (#5082)
+
+## 1.8.0
+
+### New features
+
+- Implement predefined acl (#4757)
+- Add support for resumable signed url generation (#4789)
+
+### Implementation changes
+
+- Do not quote embedded slashes for public / signed URLs (#4716)
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Missing word in docstring (#4763)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+
+## 1.7.0
+
+### Features
+
+- Enable anonymous access to blobs in public buckets (#4315)
+- Make project optional / overridable for storage client (#4381)
+- Relax regex used to test for valid project IDs (#4543)
+- Add support for `source_generation` parameter to `Bucket.copy_blob` (#4546)
+
+## 1.6.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Requiring `google-resumable-media >= 0.3.1` (#4244)
+
+PyPI: https://pypi.org/project/google-cloud-storage/1.6.0/
diff --git a/storage/LICENSE b/storage/LICENSE
new file mode 100644
index 000000000000..d64569567334
--- /dev/null
+++ b/storage/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/storage/MANIFEST.in b/storage/MANIFEST.in
new file mode 100644
index 000000000000..fc77f8c82ff0
--- /dev/null
+++ b/storage/MANIFEST.in
@@ -0,0 +1,4 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.pyc __pycache__
diff --git a/storage/README.rst b/storage/README.rst
new file mode 100644
index 000000000000..bb15ee569b49
--- /dev/null
+++ b/storage/README.rst
@@ -0,0 +1,104 @@
+Python Client for Google Cloud Storage
+======================================
+
+|GA| |pypi| |versions| 
+
+`Google Cloud Storage`_ allows you to store data on
+Google infrastructure with very high reliability, performance and
+availability, and can be used to distribute large data objects to users
+via direct download.
+
+- `Client Library Documentation`_
+- `Storage API docs`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-storage.svg
+   :target: https://pypi.org/project/google-cloud-storage
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-storage.svg
+   :target: https://pypi.org/project/google-cloud-storage
+.. _Google Cloud Storage: https://cloud.google.com/storage/docs
+.. _Client Library Documentation: https://googleapis.dev/python/storage/latest
+.. _Storage API docs: https://cloud.google.com/storage/docs/json_api/v1
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Storage API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Storage API.:  https://cloud.google.com/storage
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-storage
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-storage
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+You need to create a Google Cloud Storage bucket to use this client library.
+Follow along with the `official Google Cloud Storage documentation`_ to learn
+how to create a bucket.
+
+.. _official Google Cloud Storage documentation: https://cloud.google.com/storage/docs/cloud-console#_creatingbuckets
+
+.. code:: python
+
+    from google.cloud import storage
+    client = storage.Client()
+    # https://console.cloud.google.com/storage/browser/[bucket-id]/
+    bucket = client.get_bucket('bucket-id-here')
+    # Then do other things...
+    blob = bucket.get_blob('remote/path/to/file.txt')
+    print(blob.download_as_string())
+    blob.upload_from_string('New contents!')
+    blob2 = bucket.blob('remote/path/storage.txt')
+    blob2.upload_from_filename(filename='/local/path.txt')
diff --git a/storage/docs/README.rst b/storage/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/storage/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/docs/storage-acl.rst b/storage/docs/acl.rst
similarity index 100%
rename from docs/storage-acl.rst
rename to storage/docs/acl.rst
diff --git a/docs/storage-batch.rst b/storage/docs/batch.rst
similarity index 100%
rename from docs/storage-batch.rst
rename to storage/docs/batch.rst
diff --git a/storage/docs/blobs.rst b/storage/docs/blobs.rst
new file mode 100644
index 000000000000..19392a741d64
--- /dev/null
+++ b/storage/docs/blobs.rst
@@ -0,0 +1,7 @@
+Blobs / Objects
+~~~~~~~~~~~~~~~
+
+.. automodule:: google.cloud.storage.blob
+  :members:
+  :inherited-members:
+  :show-inheritance:
diff --git a/storage/docs/buckets.rst b/storage/docs/buckets.rst
new file mode 100644
index 000000000000..c42d7e303166
--- /dev/null
+++ b/storage/docs/buckets.rst
@@ -0,0 +1,7 @@
+Buckets
+~~~~~~~
+
+.. automodule:: google.cloud.storage.bucket
+  :members:
+  :inherited-members:
+  :show-inheritance:
diff --git a/storage/docs/changelog.md b/storage/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/storage/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/storage/docs/client.rst b/storage/docs/client.rst
new file mode 100644
index 000000000000..54f094dea9be
--- /dev/null
+++ b/storage/docs/client.rst
@@ -0,0 +1,6 @@
+Storage Client
+~~~~~~~~~~~~~~
+
+.. automodule:: google.cloud.storage.client
+  :members:
+  :show-inheritance:
diff --git a/storage/docs/conf.py b/storage/docs/conf.py
new file mode 100644
index 000000000000..7f5c6b412f36
--- /dev/null
+++ b/storage/docs/conf.py
@@ -0,0 +1,359 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-storage documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-storage"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-storage-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-storage.tex",
+        u"google-cloud-storage Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-storage",
+        u"google-cloud-storage Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-storage",
+        u"google-cloud-storage Documentation",
+        author,
+        "google-cloud-storage",
+        "GAPIC library for the Storage API",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/storage/docs/index.rst b/storage/docs/index.rst
new file mode 100644
index 000000000000..3257eca3fc3f
--- /dev/null
+++ b/storage/docs/index.rst
@@ -0,0 +1,27 @@
+.. include:: README.rst
+
+.. note::
+
+   Because the storage client uses the third-party :mod:`requests` library by
+   default, it is safe to share instances across threads.  In multiprocessing
+   scenarious, best practice is to create client instances *after*
+   :class:`multiprocessing.Pool` or :class:`multiprocessing.Process` invokes
+   :func:`os.fork`.
+
+API Reference
+-------------
+.. toctree::
+  :maxdepth: 2
+
+  client
+  blobs
+  buckets
+  acl
+  batch
+
+Changelog
+---------
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/storage/docs/snippets.py b/storage/docs/snippets.py
new file mode 100644
index 000000000000..ed16c5279e30
--- /dev/null
+++ b/storage/docs/snippets.py
@@ -0,0 +1,317 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Testable usage examples for Google Cloud Storage API wrapper
+
+Each example function takes a ``client`` argument (which must be an instance
+of :class:`google.cloud.storage.client.Client`) and uses it to perform a task
+with the API.
+
+To facilitate running the examples as system tests, each example is also passed
+a ``to_delete`` list;  the function adds to the list any objects created which
+need to be deleted during teardown.
+"""
+
+from google.cloud import storage
+
+
+def snippet(func):
+    """Mark ``func`` as a snippet example function."""
+    func._snippet = True
+    return func
+
+
+@snippet
+def storage_get_started(client, to_delete):
+    # [START storage_get_started]
+    client = storage.Client()
+    bucket = client.get_bucket("bucket-id-here")
+    # Then do other things...
+    blob = bucket.get_blob("/remote/path/to/file.txt")
+    assert blob.download_as_string() == "My old contents!"
+    blob.upload_from_string("New contents!")
+    blob2 = bucket.blob("/remote/path/storage.txt")
+    blob2.upload_from_filename(filename="/local/path.txt")
+    # [END storage_get_started]
+
+    to_delete.append(bucket)
+
+
+@snippet
+def client_bucket_acl(client, to_delete):
+    bucket_name = "system-test-bucket"
+    bucket = client.bucket(bucket_name)
+    bucket.create()
+
+    # [START client_bucket_acl]
+    client = storage.Client()
+    bucket = client.get_bucket(bucket_name)
+    acl = bucket.acl
+    # [END client_bucket_acl]
+    to_delete.append(bucket)
+
+    # [START acl_user_settings]
+    acl.user("me@example.org").grant_read()
+    acl.all_authenticated().grant_write()
+    # [END acl_user_settings]
+
+    # [START acl_save]
+    acl.save()
+    # [END acl_save]
+
+    # [START acl_revoke_write]
+    acl.all().grant_read()
+    acl.all().revoke_write()
+    # [END acl_revoke_write]
+
+    # [START acl_save_bucket]
+    bucket.acl.save(acl=acl)
+    # [END acl_save_bucket]
+
+    # [START acl_print]
+    print(list(acl))
+    # [{'role': 'OWNER', 'entity': 'allUsers'}, ...]
+    # [END acl_print]
+
+
+@snippet
+def download_to_file(client, to_delete):
+    # [START download_to_file]
+    from google.cloud.storage import Blob
+
+    client = storage.Client(project="my-project")
+    bucket = client.get_bucket("my-bucket")
+    encryption_key = "c7f32af42e45e85b9848a6a14dd2a8f6"
+    blob = Blob("secure-data", bucket, encryption_key=encryption_key)
+    blob.upload_from_string("my secret message.")
+    with open("/tmp/my-secure-file", "wb") as file_obj:
+        blob.download_to_file(file_obj)
+    # [END download_to_file]
+
+    to_delete.append(blob)
+
+
+@snippet
+def upload_from_file(client, to_delete):
+    # [START upload_from_file]
+    from google.cloud.storage import Blob
+
+    client = storage.Client(project="my-project")
+    bucket = client.get_bucket("my-bucket")
+    encryption_key = "aa426195405adee2c8081bb9e7e74b19"
+    blob = Blob("secure-data", bucket, encryption_key=encryption_key)
+    with open("my-file", "rb") as my_file:
+        blob.upload_from_file(my_file)
+    # [END upload_from_file]
+
+    to_delete.append(blob)
+
+
+@snippet
+def get_blob(client, to_delete):
+    from google.cloud.storage.blob import Blob
+
+    # [START get_blob]
+    client = storage.Client()
+    bucket = client.get_bucket("my-bucket")
+    assert isinstance(bucket.get_blob("/path/to/blob.txt"), Blob)
+    # <Blob: my-bucket, /path/to/blob.txt>
+    assert not bucket.get_blob("/does-not-exist.txt")
+    # None
+    # [END get_blob]
+
+    to_delete.append(bucket)
+
+
+@snippet
+def delete_blob(client, to_delete):
+    # [START delete_blob]
+    from google.cloud.exceptions import NotFound
+
+    client = storage.Client()
+    bucket = client.get_bucket("my-bucket")
+    blobs = list(bucket.list_blobs())
+    assert len(blobs) > 0
+    # [<Blob: my-bucket, my-file.txt>]
+    bucket.delete_blob("my-file.txt")
+    try:
+        bucket.delete_blob("doesnt-exist")
+    except NotFound:
+        pass
+    # [END delete_blob]
+
+    blob = None
+    # [START delete_blobs]
+    bucket.delete_blobs([blob], on_error=lambda blob: None)
+    # [END delete_blobs]
+
+    to_delete.append(bucket)
+
+
+@snippet
+def configure_website(client, to_delete):
+    bucket_name = "test-bucket"
+    # [START configure_website]
+    client = storage.Client()
+    bucket = client.get_bucket(bucket_name)
+    bucket.configure_website("index.html", "404.html")
+    # [END configure_website]
+
+    # [START make_public]
+    bucket.make_public(recursive=True, future=True)
+    # [END make_public]
+
+    to_delete.append(bucket)
+
+
+@snippet
+def get_bucket(client, to_delete):
+    import google
+
+    # [START get_bucket]
+    try:
+        bucket = client.get_bucket("my-bucket")
+    except google.cloud.exceptions.NotFound:
+        print("Sorry, that bucket does not exist!")
+    # [END get_bucket]
+    to_delete.append(bucket)
+
+
+@snippet
+def add_lifecycle_delete_rule(client, to_delete):
+    # [START add_lifecycle_delete_rule]
+    bucket = client.get_bucket("my-bucket")
+    bucket.add_lifecycle_rule_delete(age=2)
+    bucket.patch()
+    # [END add_lifecycle_delete_rule]
+    to_delete.append(bucket)
+
+
+@snippet
+def add_lifecycle_set_storage_class_rule(client, to_delete):
+    # [START add_lifecycle_set_storage_class_rule]
+    bucket = client.get_bucket("my-bucket")
+    bucket.add_lifecycle_rule_set_storage_class(
+        "COLD_LINE", matches_storage_class=["NEARLINE"]
+    )
+    bucket.patch()
+    # [END add_lifecycle_set_storage_class_rule]
+    to_delete.append(bucket)
+
+
+@snippet
+def lookup_bucket(client, to_delete):
+    from google.cloud.storage.bucket import Bucket
+
+    # [START lookup_bucket]
+    bucket = client.lookup_bucket("doesnt-exist")
+    assert not bucket
+    # None
+    bucket = client.lookup_bucket("my-bucket")
+    assert isinstance(bucket, Bucket)
+    # <Bucket: my-bucket>
+    # [END lookup_bucket]
+
+    to_delete.append(bucket)
+
+
+@snippet
+def create_bucket(client, to_delete):
+    from google.cloud.storage import Bucket
+
+    # [START create_bucket]
+    bucket = client.create_bucket("my-bucket")
+    assert isinstance(bucket, Bucket)
+    # <Bucket: my-bucket>
+    # [END create_bucket]
+
+    to_delete.append(bucket)
+
+
+@snippet
+def list_buckets(client, to_delete):
+    # [START list_buckets]
+    for bucket in client.list_buckets():
+        print(bucket)
+    # [END list_buckets]
+
+    for bucket in client.list_buckets():
+        to_delete.append(bucket)
+
+
+@snippet
+def policy_document(client, to_delete):
+    # pylint: disable=unused-argument
+    # [START policy_document]
+    bucket = client.bucket("my-bucket")
+    conditions = [["starts-with", "$key", ""], {"acl": "public-read"}]
+
+    policy = bucket.generate_upload_policy(conditions)
+
+    # Generate an upload form using the form fields.
+    policy_fields = "".join(
+        '<input type="hidden" name="{key}" value="{value}">'.format(
+            key=key, value=value
+        )
+        for key, value in policy.items()
+    )
+
+    upload_form = (
+        '<form action="http://{bucket_name}.storage.googleapis.com"'
+        '   method="post" enctype="multipart/form-data">'
+        '<input type="text" name="key" value="my-test-key">'
+        '<input type="hidden" name="bucket" value="{bucket_name}">'
+        '<input type="hidden" name="acl" value="public-read">'
+        '<input name="file" type="file">'
+        '<input type="submit" value="Upload">'
+        "{policy_fields}"
+        "</form>"
+    ).format(bucket_name=bucket.name, policy_fields=policy_fields)
+
+    print(upload_form)
+    # [END policy_document]
+
+
+def _line_no(func):
+    code = getattr(func, "__code__", None) or getattr(func, "func_code")
+    return code.co_firstlineno
+
+
+def _find_examples():
+    funcs = [obj for obj in globals().values() if getattr(obj, "_snippet", False)]
+    for func in sorted(funcs, key=_line_no):
+        yield func
+
+
+def _name_and_doc(func):
+    return func.__name__, func.__doc__
+
+
+def main():
+    client = storage.Client()
+    for example in _find_examples():
+        to_delete = []
+        print("%-25s: %s" % _name_and_doc(example))
+        try:
+            example(client, to_delete)
+        except AssertionError as failure:
+            print("   FAIL: %s" % (failure,))
+        except Exception as error:  # pylint: disable=broad-except
+            print("  ERROR: %r" % (error,))
+        for item in to_delete:
+            item.delete()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/storage/google/__init__.py b/storage/google/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/storage/google/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/storage/google/cloud/__init__.py b/storage/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/storage/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/storage/google/cloud/storage/__init__.py b/storage/google/cloud/storage/__init__.py
new file mode 100644
index 000000000000..2b643fc80add
--- /dev/null
+++ b/storage/google/cloud/storage/__init__.py
@@ -0,0 +1,44 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Shortcut methods for getting set up with Google Cloud Storage.
+
+You'll typically use these to get started with the API:
+
+.. literalinclude:: snippets.py
+    :start-after: [START storage_get_started]
+    :end-before: [END storage_get_started]
+
+The main concepts with this API are:
+
+- :class:`~google.cloud.storage.bucket.Bucket` which represents a particular
+  bucket (akin to a mounted disk on a computer).
+
+- :class:`~google.cloud.storage.blob.Blob` which represents a pointer to a
+  particular entity in Cloud Storage (akin to a file path on a remote
+  machine).
+"""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-storage").version
+
+from google.cloud.storage.batch import Batch
+from google.cloud.storage.blob import Blob
+from google.cloud.storage.bucket import Bucket
+from google.cloud.storage.client import Client
+
+
+__all__ = ["__version__", "Batch", "Blob", "Bucket", "Client"]
diff --git a/storage/google/cloud/storage/_helpers.py b/storage/google/cloud/storage/_helpers.py
new file mode 100644
index 000000000000..93848daa1cde
--- /dev/null
+++ b/storage/google/cloud/storage/_helpers.py
@@ -0,0 +1,265 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helper functions for Cloud Storage utility classes.
+
+These are *not* part of the API.
+"""
+
+import base64
+from hashlib import md5
+
+
+def _validate_name(name):
+    """Pre-flight ``Bucket`` name validation.
+
+    :type name: str or :data:`NoneType`
+    :param name: Proposed bucket name.
+
+    :rtype: str or :data:`NoneType`
+    :returns: ``name`` if valid.
+    """
+    if name is None:
+        return
+
+    # The first and las characters must be alphanumeric.
+    if not all([name[0].isalnum(), name[-1].isalnum()]):
+        raise ValueError("Bucket names must start and end with a number or letter.")
+    return name
+
+
+class _PropertyMixin(object):
+    """Abstract mixin for cloud storage classes with associated properties.
+
+    Non-abstract subclasses should implement:
+      - path
+      - client
+      - user_project
+
+    :type name: str
+    :param name: The name of the object. Bucket names must start and end with a
+                 number or letter.
+    """
+
+    def __init__(self, name=None):
+        self.name = name
+        self._properties = {}
+        self._changes = set()
+
+    @property
+    def path(self):
+        """Abstract getter for the object path."""
+        raise NotImplementedError
+
+    @property
+    def client(self):
+        """Abstract getter for the object client."""
+        raise NotImplementedError
+
+    @property
+    def user_project(self):
+        """Abstract getter for the object user_project."""
+        raise NotImplementedError
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current object.
+
+        :rtype: :class:`google.cloud.storage.client.Client`
+        :returns: The client passed in or the currently bound client.
+        """
+        if client is None:
+            client = self.client
+        return client
+
+    def _encryption_headers(self):
+        """Return any encryption headers needed to fetch the object.
+
+        .. note::
+           Defined here because :meth:`reload` calls it, but this method is
+           really only relevant for :class:`~google.cloud.storage.blob.Blob`.
+
+        :rtype: dict
+        :returns: a mapping of encryption-related headers.
+        """
+        return {}
+
+    @property
+    def _query_params(self):
+        """Default query parameters."""
+        params = {}
+        if self.user_project is not None:
+            params["userProject"] = self.user_project
+        return params
+
+    def reload(self, client=None):
+        """Reload properties from Cloud Storage.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current object.
+        """
+        client = self._require_client(client)
+        query_params = self._query_params
+        # Pass only '?projection=noAcl' here because 'acl' and related
+        # are handled via custom endpoints.
+        query_params["projection"] = "noAcl"
+        api_response = client._connection.api_request(
+            method="GET",
+            path=self.path,
+            query_params=query_params,
+            headers=self._encryption_headers(),
+            _target_object=self,
+        )
+        self._set_properties(api_response)
+
+    def _patch_property(self, name, value):
+        """Update field of this object's properties.
+
+        This method will only update the field provided and will not
+        touch the other fields.
+
+        It **will not** reload the properties from the server. The behavior is
+        local only and syncing occurs via :meth:`patch`.
+
+        :type name: str
+        :param name: The field name to update.
+
+        :type value: object
+        :param value: The value being updated.
+        """
+        self._changes.add(name)
+        self._properties[name] = value
+
+    def _set_properties(self, value):
+        """Set the properties for the current object.
+
+        :type value: dict or :class:`google.cloud.storage.batch._FutureDict`
+        :param value: The properties to be set.
+        """
+        self._properties = value
+        # If the values are reset, the changes must as well.
+        self._changes = set()
+
+    def patch(self, client=None):
+        """Sends all changed properties in a PATCH request.
+
+        Updates the ``_properties`` with the response from the backend.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current object.
+        """
+        client = self._require_client(client)
+        query_params = self._query_params
+        # Pass '?projection=full' here because 'PATCH' documented not
+        # to work properly w/ 'noAcl'.
+        query_params["projection"] = "full"
+        update_properties = {key: self._properties[key] for key in self._changes}
+
+        # Make the API call.
+        api_response = client._connection.api_request(
+            method="PATCH",
+            path=self.path,
+            data=update_properties,
+            query_params=query_params,
+            _target_object=self,
+        )
+        self._set_properties(api_response)
+
+    def update(self, client=None):
+        """Sends all properties in a PUT request.
+
+        Updates the ``_properties`` with the response from the backend.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current object.
+        """
+        client = self._require_client(client)
+        query_params = self._query_params
+        query_params["projection"] = "full"
+        api_response = client._connection.api_request(
+            method="PUT",
+            path=self.path,
+            data=self._properties,
+            query_params=query_params,
+            _target_object=self,
+        )
+        self._set_properties(api_response)
+
+
+def _scalar_property(fieldname):
+    """Create a property descriptor around the :class:`_PropertyMixin` helpers.
+    """
+
+    def _getter(self):
+        """Scalar property getter."""
+        return self._properties.get(fieldname)
+
+    def _setter(self, value):
+        """Scalar property setter."""
+        self._patch_property(fieldname, value)
+
+    return property(_getter, _setter)
+
+
+def _write_buffer_to_hash(buffer_object, hash_obj, digest_block_size=8192):
+    """Read blocks from a buffer and update a hash with them.
+
+    :type buffer_object: bytes buffer
+    :param buffer_object: Buffer containing bytes used to update a hash object.
+
+    :type hash_obj: object that implements update
+    :param hash_obj: A hash object (MD5 or CRC32-C).
+
+    :type digest_block_size: int
+    :param digest_block_size: The block size to write to the hash.
+                              Defaults to 8192.
+    """
+    block = buffer_object.read(digest_block_size)
+
+    while len(block) > 0:
+        hash_obj.update(block)
+        # Update the block for the next iteration.
+        block = buffer_object.read(digest_block_size)
+
+
+def _base64_md5hash(buffer_object):
+    """Get MD5 hash of bytes (as base64).
+
+    :type buffer_object: bytes buffer
+    :param buffer_object: Buffer containing bytes used to compute an MD5
+                          hash (as base64).
+
+    :rtype: str
+    :returns: A base64 encoded digest of the MD5 hash.
+    """
+    hash_obj = md5()
+    _write_buffer_to_hash(buffer_object, hash_obj)
+    digest_bytes = hash_obj.digest()
+    return base64.b64encode(digest_bytes)
diff --git a/storage/google/cloud/storage/_http.py b/storage/google/cloud/storage/_http.py
new file mode 100644
index 000000000000..14680c9b721b
--- /dev/null
+++ b/storage/google/cloud/storage/_http.py
@@ -0,0 +1,44 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Storage connections."""
+
+from google.cloud import _http
+
+from google.cloud.storage import __version__
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google Cloud Storage via the JSON REST API.
+
+    :type client: :class:`~google.cloud.storage.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+    """
+
+    DEFAULT_API_ENDPOINT = _http.API_BASE_URL
+
+    def __init__(self, client, client_info=None, api_endpoint=DEFAULT_API_ENDPOINT):
+        super(Connection, self).__init__(client, client_info)
+        self.API_BASE_URL = api_endpoint
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_VERSION = "v1"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/storage/{api_version}{path}"
+    """A template for the URL of a particular API call."""
diff --git a/storage/google/cloud/storage/_signing.py b/storage/google/cloud/storage/_signing.py
new file mode 100644
index 000000000000..019c5f45feec
--- /dev/null
+++ b/storage/google/cloud/storage/_signing.py
@@ -0,0 +1,591 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import base64
+import binascii
+import collections
+import datetime
+import hashlib
+import re
+
+import six
+
+import google.auth.credentials
+from google.cloud import _helpers
+
+
+NOW = datetime.datetime.utcnow  # To be replaced by tests.
+MULTIPLE_SPACES_RE = r"\s+"
+MULTIPLE_SPACES = re.compile(MULTIPLE_SPACES_RE)
+
+
+def ensure_signed_credentials(credentials):
+    """Raise AttributeError if the credentials are unsigned.
+
+    :type credentials: :class:`google.auth.credentials.Signing`
+    :param credentials: The credentials used to create a private key
+                        for signing text.
+
+    :raises: :exc:`AttributeError` if credentials is not an instance
+            of :class:`google.auth.credentials.Signing`.
+    """
+    if not isinstance(credentials, google.auth.credentials.Signing):
+        auth_uri = (
+            "https://google-cloud-python.readthedocs.io/en/latest/"
+            "core/auth.html?highlight=authentication#setting-up-"
+            "a-service-account"
+        )
+        raise AttributeError(
+            "you need a private key to sign credentials."
+            "the credentials you are currently using %s "
+            "just contains a token. see %s for more "
+            "details." % (type(credentials), auth_uri)
+        )
+
+
+def get_signed_query_params_v2(credentials, expiration, string_to_sign):
+    """Gets query parameters for creating a signed URL.
+
+    :type credentials: :class:`google.auth.credentials.Signing`
+    :param credentials: The credentials used to create a private key
+                        for signing text.
+
+    :type expiration: int or long
+    :param expiration: When the signed URL should expire.
+
+    :type string_to_sign: str
+    :param string_to_sign: The string to be signed by the credentials.
+
+    :raises: :exc:`AttributeError` if credentials is not an instance
+            of :class:`google.auth.credentials.Signing`.
+
+    :rtype: dict
+    :returns: Query parameters matching the signing credentials with a
+              signed payload.
+    """
+    ensure_signed_credentials(credentials)
+    signature_bytes = credentials.sign_bytes(string_to_sign)
+    signature = base64.b64encode(signature_bytes)
+    service_account_name = credentials.signer_email
+    return {
+        "GoogleAccessId": service_account_name,
+        "Expires": str(expiration),
+        "Signature": signature,
+    }
+
+
+def get_expiration_seconds_v2(expiration):
+    """Convert 'expiration' to a number of seconds in the future.
+
+    :type expiration: Union[Integer, datetime.datetime, datetime.timedelta]
+    :param expiration: Point in time when the signed URL should expire.
+
+    :raises: :exc:`TypeError` when expiration is not a valid type.
+
+    :rtype: int
+    :returns: a timestamp as an absolute number of seconds since epoch.
+    """
+    # If it's a timedelta, add it to `now` in UTC.
+    if isinstance(expiration, datetime.timedelta):
+        now = NOW().replace(tzinfo=_helpers.UTC)
+        expiration = now + expiration
+
+    # If it's a datetime, convert to a timestamp.
+    if isinstance(expiration, datetime.datetime):
+        micros = _helpers._microseconds_from_datetime(expiration)
+        expiration = micros // 10 ** 6
+
+    if not isinstance(expiration, six.integer_types):
+        raise TypeError(
+            "Expected an integer timestamp, datetime, or "
+            "timedelta. Got %s" % type(expiration)
+        )
+    return expiration
+
+
+_EXPIRATION_TYPES = six.integer_types + (datetime.datetime, datetime.timedelta)
+
+
+def get_expiration_seconds_v4(expiration):
+    """Convert 'expiration' to a number of seconds offset from the current time.
+
+    :type expiration: Union[Integer, datetime.datetime, datetime.timedelta]
+    :param expiration: Point in time when the signed URL should expire.
+
+    :raises: :exc:`TypeError` when expiration is not a valid type.
+    :raises: :exc:`ValueError` when expiration is too large.
+    :rtype: Integer
+    :returns: seconds in the future when the signed URL will expire
+    """
+    if not isinstance(expiration, _EXPIRATION_TYPES):
+        raise TypeError(
+            "Expected an integer timestamp, datetime, or "
+            "timedelta. Got %s" % type(expiration)
+        )
+
+    now = NOW().replace(tzinfo=_helpers.UTC)
+
+    if isinstance(expiration, six.integer_types):
+        seconds = expiration
+
+    if isinstance(expiration, datetime.datetime):
+
+        if expiration.tzinfo is None:
+            expiration = expiration.replace(tzinfo=_helpers.UTC)
+
+        expiration = expiration - now
+
+    if isinstance(expiration, datetime.timedelta):
+        seconds = int(expiration.total_seconds())
+
+    if seconds > SEVEN_DAYS:
+        raise ValueError(
+            "Max allowed expiration interval is seven days (%d seconds)".format(
+                SEVEN_DAYS
+            )
+        )
+
+    return seconds
+
+
+def get_canonical_headers(headers):
+    """Canonicalize headers for signing.
+
+    See:
+    https://cloud.google.com/storage/docs/access-control/signed-urls#about-canonical-extension-headers
+
+    :type headers: Union[dict|List(Tuple(str,str))]
+    :param headers:
+        (Optional) Additional HTTP headers to be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers
+        Requests using the signed URL *must* pass the specified header
+        (name and value) with each request for the URL.
+
+    :rtype: str
+    :returns: List of headers, normalized / sortted per the URL refernced above.
+    """
+    if headers is None:
+        headers = []
+    elif isinstance(headers, dict):
+        headers = list(headers.items())
+
+    if not headers:
+        return [], []
+
+    normalized = collections.defaultdict(list)
+    for key, val in headers:
+        key = key.lower().strip()
+        val = MULTIPLE_SPACES.sub(" ", val.strip())
+        normalized[key].append(val)
+
+    ordered_headers = sorted((key, ",".join(val)) for key, val in normalized.items())
+
+    canonical_headers = ["{}:{}".format(*item) for item in ordered_headers]
+    return canonical_headers, ordered_headers
+
+
+_Canonical = collections.namedtuple(
+    "_Canonical", ["method", "resource", "query_parameters", "headers"]
+)
+
+
+def canonicalize(method, resource, query_parameters, headers):
+    """Canonicalize method, resource
+
+    :type method: str
+    :param method: The HTTP verb that will be used when requesting the URL.
+                   Defaults to ``'GET'``. If method is ``'RESUMABLE'`` then the
+                   signature will additionally contain the `x-goog-resumable`
+                   header, and the method changed to POST. See the signed URL
+                   docs regarding this flow:
+                   https://cloud.google.com/storage/docs/access-control/signed-urls
+
+    :type resource: str
+    :param resource: A pointer to a specific resource
+                     (typically, ``/bucket-name/path/to/blob.txt``).
+
+    :type query_parameters: dict
+    :param query_parameters:
+        (Optional) Additional query paramtersto be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers#query
+
+    :type headers: Union[dict|List(Tuple(str,str))]
+    :param headers:
+        (Optional) Additional HTTP headers to be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers
+        Requests using the signed URL *must* pass the specified header
+        (name and value) with each request for the URL.
+
+    :rtype: :class:_Canonical
+    :returns: Canonical method, resource, query_parameters, and headers.
+    """
+    headers, _ = get_canonical_headers(headers)
+
+    if method == "RESUMABLE":
+        method = "POST"
+        headers.append("x-goog-resumable:start")
+
+    if query_parameters is None:
+        return _Canonical(method, resource, [], headers)
+
+    normalized_qp = sorted(
+        (key.lower(), value and value.strip() or "")
+        for key, value in query_parameters.items()
+    )
+    encoded_qp = six.moves.urllib.parse.urlencode(normalized_qp)
+    canonical_resource = "{}?{}".format(resource, encoded_qp)
+    return _Canonical(method, canonical_resource, normalized_qp, headers)
+
+
+def generate_signed_url_v2(
+    credentials,
+    resource,
+    expiration,
+    api_access_endpoint="",
+    method="GET",
+    content_md5=None,
+    content_type=None,
+    response_type=None,
+    response_disposition=None,
+    generation=None,
+    headers=None,
+    query_parameters=None,
+):
+    """Generate a V2 signed URL to provide query-string auth'n to a resource.
+
+    .. note::
+
+        Assumes ``credentials`` implements the
+        :class:`google.auth.credentials.Signing` interface. Also assumes
+        ``credentials`` has a ``service_account_email`` property which
+        identifies the credentials.
+
+    .. note::
+
+        If you are on Google Compute Engine, you can't generate a signed URL.
+        Follow `Issue 922`_ for updates on this. If you'd like to be able to
+        generate a signed URL from GCE, you can use a standard service account
+        from a JSON file rather than a GCE service account.
+
+    See headers `reference`_ for more details on optional arguments.
+
+    .. _Issue 922: https://github.com/GoogleCloudPlatform/\
+                   google-cloud-python/issues/922
+    .. _reference: https://cloud.google.com/storage/docs/reference-headers
+
+    :type credentials: :class:`google.auth.credentials.Signing`
+    :param credentials: Credentials object with an associated private key to
+                        sign text.
+
+    :type resource: str
+    :param resource: A pointer to a specific resource
+                     (typically, ``/bucket-name/path/to/blob.txt``).
+
+    :type expiration: Union[Integer, datetime.datetime, datetime.timedelta]
+    :param expiration: Point in time when the signed URL should expire.
+
+    :type api_access_endpoint: str
+    :param api_access_endpoint: Optional URI base. Defaults to empty string.
+
+    :type method: str
+    :param method: The HTTP verb that will be used when requesting the URL.
+                   Defaults to ``'GET'``. If method is ``'RESUMABLE'`` then the
+                   signature will additionally contain the `x-goog-resumable`
+                   header, and the method changed to POST. See the signed URL
+                   docs regarding this flow:
+                   https://cloud.google.com/storage/docs/access-control/signed-urls
+
+
+    :type content_md5: str
+    :param content_md5: (Optional) The MD5 hash of the object referenced by
+                        ``resource``.
+
+    :type content_type: str
+    :param content_type: (Optional) The content type of the object referenced
+                         by ``resource``.
+
+    :type response_type: str
+    :param response_type: (Optional) Content type of responses to requests for
+                          the signed URL. Ignored if content_type is set on
+                          object/blob metadata.
+
+    :type response_disposition: str
+    :param response_disposition: (Optional) Content disposition of responses to
+                                 requests for the signed URL.
+
+    :type generation: str
+    :param generation: (Optional) A value that indicates which generation of
+                       the resource to fetch.
+
+    :type headers: Union[dict|List(Tuple(str,str))]
+    :param headers:
+        (Optional) Additional HTTP headers to be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers
+        Requests using the signed URL *must* pass the specified header
+        (name and value) with each request for the URL.
+
+    :type query_parameters: dict
+    :param query_parameters:
+        (Optional) Additional query paramtersto be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers#query
+
+    :raises: :exc:`TypeError` when expiration is not a valid type.
+    :raises: :exc:`AttributeError` if credentials is not an instance
+            of :class:`google.auth.credentials.Signing`.
+
+    :rtype: str
+    :returns: A signed URL you can use to access the resource
+              until expiration.
+    """
+    expiration_stamp = get_expiration_seconds_v2(expiration)
+
+    canonical = canonicalize(method, resource, query_parameters, headers)
+
+    # Generate the string to sign.
+    elements_to_sign = [
+        canonical.method,
+        content_md5 or "",
+        content_type or "",
+        str(expiration_stamp),
+    ]
+    elements_to_sign.extend(canonical.headers)
+    elements_to_sign.append(canonical.resource)
+    string_to_sign = "\n".join(elements_to_sign)
+
+    # Set the right query parameters.
+    signed_query_params = get_signed_query_params_v2(
+        credentials, expiration_stamp, string_to_sign
+    )
+
+    if response_type is not None:
+        signed_query_params["response-content-type"] = response_type
+    if response_disposition is not None:
+        signed_query_params["response-content-disposition"] = response_disposition
+    if generation is not None:
+        signed_query_params["generation"] = generation
+
+    signed_query_params.update(canonical.query_parameters)
+    sorted_signed_query_params = sorted(signed_query_params.items())
+
+    # Return the built URL.
+    return "{endpoint}{resource}?{querystring}".format(
+        endpoint=api_access_endpoint,
+        resource=resource,
+        querystring=six.moves.urllib.parse.urlencode(sorted_signed_query_params),
+    )
+
+
+SEVEN_DAYS = 7 * 24 * 60 * 60  # max age for V4 signed URLs.
+DEFAULT_ENDPOINT = "https://storage.googleapis.com"
+
+
+def generate_signed_url_v4(
+    credentials,
+    resource,
+    expiration,
+    api_access_endpoint=DEFAULT_ENDPOINT,
+    method="GET",
+    content_md5=None,
+    content_type=None,
+    response_type=None,
+    response_disposition=None,
+    generation=None,
+    headers=None,
+    query_parameters=None,
+    _request_timestamp=None,  # for testing only
+):
+    """Generate a V4 signed URL to provide query-string auth'n to a resource.
+
+    .. note::
+
+        Assumes ``credentials`` implements the
+        :class:`google.auth.credentials.Signing` interface. Also assumes
+        ``credentials`` has a ``service_account_email`` property which
+        identifies the credentials.
+
+    .. note::
+
+        If you are on Google Compute Engine, you can't generate a signed URL.
+        Follow `Issue 922`_ for updates on this. If you'd like to be able to
+        generate a signed URL from GCE, you can use a standard service account
+        from a JSON file rather than a GCE service account.
+
+    See headers `reference`_ for more details on optional arguments.
+
+    .. _Issue 922: https://github.com/GoogleCloudPlatform/\
+                   google-cloud-python/issues/922
+    .. _reference: https://cloud.google.com/storage/docs/reference-headers
+
+    :type credentials: :class:`google.auth.credentials.Signing`
+    :param credentials: Credentials object with an associated private key to
+                        sign text.
+
+    :type resource: str
+    :param resource: A pointer to a specific resource
+                     (typically, ``/bucket-name/path/to/blob.txt``).
+
+    :type expiration: Union[Integer, datetime.datetime, datetime.timedelta]
+    :param expiration: Point in time when the signed URL should expire.
+
+    :type api_access_endpoint: str
+    :param api_access_endpoint: Optional URI base. Defaults to
+                                "https://storage.googleapis.com/"
+
+    :type method: str
+    :param method: The HTTP verb that will be used when requesting the URL.
+                   Defaults to ``'GET'``. If method is ``'RESUMABLE'`` then the
+                   signature will additionally contain the `x-goog-resumable`
+                   header, and the method changed to POST. See the signed URL
+                   docs regarding this flow:
+                   https://cloud.google.com/storage/docs/access-control/signed-urls
+
+
+    :type content_md5: str
+    :param content_md5: (Optional) The MD5 hash of the object referenced by
+                        ``resource``.
+
+    :type content_type: str
+    :param content_type: (Optional) The content type of the object referenced
+                         by ``resource``.
+
+    :type response_type: str
+    :param response_type: (Optional) Content type of responses to requests for
+                          the signed URL. Ignored if content_type is set on
+                          object/blob metadata.
+
+    :type response_disposition: str
+    :param response_disposition: (Optional) Content disposition of responses to
+                                 requests for the signed URL.
+
+    :type generation: str
+    :param generation: (Optional) A value that indicates which generation of
+                       the resource to fetch.
+
+    :type headers: dict
+    :param headers:
+        (Optional) Additional HTTP headers to be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers
+        Requests using the signed URL *must* pass the specified header
+        (name and value) with each request for the URL.
+
+    :type query_parameters: dict
+    :param query_parameters:
+        (Optional) Additional query paramtersto be included as part of the
+        signed URLs.  See:
+        https://cloud.google.com/storage/docs/xml-api/reference-headers#query
+
+    :raises: :exc:`TypeError` when expiration is not a valid type.
+    :raises: :exc:`AttributeError` if credentials is not an instance
+            of :class:`google.auth.credentials.Signing`.
+
+    :rtype: str
+    :returns: A signed URL you can use to access the resource
+              until expiration.
+    """
+    ensure_signed_credentials(credentials)
+    expiration_seconds = get_expiration_seconds_v4(expiration)
+
+    if _request_timestamp is None:
+        now = NOW()
+        request_timestamp = now.strftime("%Y%m%dT%H%M%SZ")
+        datestamp = now.date().strftime("%Y%m%d")
+    else:
+        request_timestamp = _request_timestamp
+        datestamp = _request_timestamp[:8]
+
+    client_email = credentials.signer_email
+    credential_scope = "{}/auto/storage/goog4_request".format(datestamp)
+    credential = "{}/{}".format(client_email, credential_scope)
+
+    if headers is None:
+        headers = {}
+
+    if content_type is not None:
+        headers["Content-Type"] = content_type
+
+    if content_md5 is not None:
+        headers["Content-MD5"] = content_md5
+
+    header_names = [key.lower() for key in headers]
+    if "host" not in header_names:
+        headers["Host"] = "storage.googleapis.com"
+
+    if method.upper() == "RESUMABLE":
+        method = "POST"
+        headers["x-goog-resumable"] = "start"
+
+    canonical_headers, ordered_headers = get_canonical_headers(headers)
+    canonical_header_string = (
+        "\n".join(canonical_headers) + "\n"
+    )  # Yes, Virginia, the extra newline is part of the spec.
+    signed_headers = ";".join([key for key, _ in ordered_headers])
+
+    if query_parameters is None:
+        query_parameters = {}
+    else:
+        query_parameters = {key: value or "" for key, value in query_parameters.items()}
+
+    query_parameters["X-Goog-Algorithm"] = "GOOG4-RSA-SHA256"
+    query_parameters["X-Goog-Credential"] = credential
+    query_parameters["X-Goog-Date"] = request_timestamp
+    query_parameters["X-Goog-Expires"] = expiration_seconds
+    query_parameters["X-Goog-SignedHeaders"] = signed_headers
+
+    if response_type is not None:
+        query_parameters["response-content-type"] = response_type
+
+    if response_disposition is not None:
+        query_parameters["response-content-disposition"] = response_disposition
+
+    if generation is not None:
+        query_parameters["generation"] = generation
+
+    ordered_query_parameters = sorted(query_parameters.items())
+    canonical_query_string = six.moves.urllib.parse.urlencode(ordered_query_parameters)
+
+    canonical_elements = [
+        method,
+        resource,
+        canonical_query_string,
+        canonical_header_string,
+        signed_headers,
+        "UNSIGNED-PAYLOAD",
+    ]
+    canonical_request = "\n".join(canonical_elements)
+
+    canonical_request_hash = hashlib.sha256(
+        canonical_request.encode("ascii")
+    ).hexdigest()
+
+    string_elements = [
+        "GOOG4-RSA-SHA256",
+        request_timestamp,
+        credential_scope,
+        canonical_request_hash,
+    ]
+    string_to_sign = "\n".join(string_elements)
+
+    signature_bytes = credentials.sign_bytes(string_to_sign.encode("ascii"))
+    signature = binascii.hexlify(signature_bytes).decode("ascii")
+
+    return "{}{}?{}&X-Goog-Signature={}".format(
+        api_access_endpoint, resource, canonical_query_string, signature
+    )
diff --git a/google/cloud/storage/acl.py b/storage/google/cloud/storage/acl.py
similarity index 75%
rename from google/cloud/storage/acl.py
rename to storage/google/cloud/storage/acl.py
index 665dce1b7078..9b1af1d87f2f 100644
--- a/google/cloud/storage/acl.py
+++ b/storage/google/cloud/storage/acl.py
@@ -1,4 +1,4 @@
-# Copyright 2014 Google Inc. All rights reserved.
+# Copyright 2014 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,12 +16,12 @@
 
 :class:`google.cloud.storage.bucket.Bucket` has a getting method that creates
 an ACL object under the hood, and you can interact with that using
-:func:`google.cloud.storage.bucket.Bucket.acl`::
+:func:`google.cloud.storage.bucket.Bucket.acl`:
+
+.. literalinclude:: snippets.py
+    :start-after: [START client_bucket_acl]
+    :end-before: [END client_bucket_acl]
 
-  >>> from google.cloud import storage
-  >>> client = storage.Client()
-  >>> bucket = client.get_bucket(bucket_name)
-  >>> acl = bucket.acl
 
 Adding and removing permissions can be done with the following methods
 (in increasing order of granularity):
@@ -47,32 +47,33 @@
   :func:`_ACLEntity.grant_owner` and :func:`_ACLEntity.revoke_owner`
 
 You can use any of these like any other factory method (these happen to
-be :class:`_ACLEntity` factories)::
-
-  >>> acl.user('me@example.org').grant_read()
-  >>> acl.all_authenticated().grant_write()
+be :class:`_ACLEntity` factories):
 
-You can also chain these ``grant_*`` and ``revoke_*`` methods together
-for brevity::
-
-  >>> acl.all().grant_read().revoke_write()
+.. literalinclude:: snippets.py
+   :start-after: [START acl_user_settings]
+   :end-before: [END acl_user_settings]
 
 After that, you can save any changes you make with the
-:func:`google.cloud.storage.acl.ACL.save` method::
+:func:`google.cloud.storage.acl.ACL.save` method:
 
-  >>> acl.save()
+.. literalinclude:: snippets.py
+   :start-after: [START acl_save]
+   :end-before: [END acl_save]
 
 You can alternatively save any existing :class:`google.cloud.storage.acl.ACL`
 object (whether it was created by a factory method or not) from a
-:class:`google.cloud.storage.bucket.Bucket`::
+:class:`google.cloud.storage.bucket.Bucket`:
 
-  >>> bucket.acl.save(acl=acl)
+.. literalinclude:: snippets.py
+   :start-after: [START acl_save_bucket]
+   :end-before: [END acl_save_bucket]
 
 To get the list of ``entity`` and ``role`` for each unique pair, the
-:class:`ACL` class is iterable::
+:class:`ACL` class is iterable:
 
-  >>> print list(ACL)
-  [{'role': 'OWNER', 'entity': 'allUsers'}, ...]
+.. literalinclude:: snippets.py
+   :start-after: [START acl_print]
+   :end-before: [END acl_print]
 
 This list of tuples can be used as the ``entity`` and ``role`` fields
 when sending metadata for ACLs to the API.
@@ -85,17 +86,17 @@ class _ACLEntity(object):
     This is a helper class that you likely won't ever construct
     outside of using the factor methods on the :class:`ACL` object.
 
-    :type entity_type: string
+    :type entity_type: str
     :param entity_type: The type of entity (ie, 'group' or 'user').
 
-    :type identifier: string
+    :type identifier: str
     :param identifier: The ID or e-mail of the entity. For the special
                        entity types (like 'allUsers') this is optional.
     """
 
-    READER_ROLE = 'READER'
-    WRITER_ROLE = 'WRITER'
-    OWNER_ROLE = 'OWNER'
+    READER_ROLE = "READER"
+    WRITER_ROLE = "WRITER"
+    OWNER_ROLE = "OWNER"
 
     def __init__(self, entity_type, identifier=None):
         self.identifier = identifier
@@ -106,11 +107,12 @@ def __str__(self):
         if not self.identifier:
             return str(self.type)
         else:
-            return '{acl.type}-{acl.identifier}'.format(acl=self)
+            return "{acl.type}-{acl.identifier}".format(acl=self)
 
     def __repr__(self):
-        return '<ACL Entity: {acl} ({roles})>'.format(
-            acl=self, roles=', '.join(self.roles))
+        return "<ACL Entity: {acl} ({roles})>".format(
+            acl=self, roles=", ".join(self.roles)
+        )
 
     def get_roles(self):
         """Get the list of roles permitted by this entity.
@@ -123,7 +125,7 @@ def get_roles(self):
     def grant(self, role):
         """Add a role to the entity.
 
-        :type role: string
+        :type role: str
         :param role: The role to add to the entity.
         """
         self.roles.add(role)
@@ -131,7 +133,7 @@ def grant(self, role):
     def revoke(self, role):
         """Remove a role from the entity.
 
-        :type role: string
+        :type role: str
         :param role: The role to remove from the entity.
         """
         if role in self.roles:
@@ -165,30 +167,32 @@ def revoke_owner(self):
 class ACL(object):
     """Container class representing a list of access controls."""
 
-    _URL_PATH_ELEM = 'acl'
-    _PREDEFINED_QUERY_PARAM = 'predefinedAcl'
+    _URL_PATH_ELEM = "acl"
+    _PREDEFINED_QUERY_PARAM = "predefinedAcl"
 
     PREDEFINED_XML_ACLS = {
         # XML API name -> JSON API name
-        'project-private': 'projectPrivate',
-        'public-read': 'publicRead',
-        'public-read-write': 'publicReadWrite',
-        'authenticated-read': 'authenticatedRead',
-        'bucket-owner-read': 'bucketOwnerRead',
-        'bucket-owner-full-control': 'bucketOwnerFullControl',
+        "project-private": "projectPrivate",
+        "public-read": "publicRead",
+        "public-read-write": "publicReadWrite",
+        "authenticated-read": "authenticatedRead",
+        "bucket-owner-read": "bucketOwnerRead",
+        "bucket-owner-full-control": "bucketOwnerFullControl",
     }
 
-    PREDEFINED_JSON_ACLS = frozenset([
-        'private',
-        'projectPrivate',
-        'publicRead',
-        'publicReadWrite',
-        'authenticatedRead',
-        'bucketOwnerRead',
-        'bucketOwnerFullControl',
-    ])
-    """See:
-    https://cloud.google.com/storage/docs/access-control#predefined-acl
+    PREDEFINED_JSON_ACLS = frozenset(
+        [
+            "private",
+            "projectPrivate",
+            "publicRead",
+            "publicReadWrite",
+            "authenticatedRead",
+            "bucketOwnerRead",
+            "bucketOwnerFullControl",
+        ]
+    )
+    """See
+    https://cloud.google.com/storage/docs/access-control/lists#predefined-acl
     """
 
     loaded = False
@@ -197,6 +201,7 @@ class ACL(object):
     # as properties).
     reload_path = None
     save_path = None
+    user_project = None
 
     def __init__(self):
         self.entities = {}
@@ -206,6 +211,23 @@ def _ensure_loaded(self):
         if not self.loaded:
             self.reload()
 
+    @classmethod
+    def validate_predefined(cls, predefined):
+        """Ensures predefined is in list of predefined json values
+
+        :type predefined: str
+        :param predefined: name of a predefined acl
+
+        :type predefined: str
+        :param predefined: validated JSON name of predefined acl
+
+        :raises: :exc: `ValueError`: If predefined is not a valid acl
+        """
+        predefined = cls.PREDEFINED_XML_ACLS.get(predefined, predefined)
+        if predefined and predefined not in cls.PREDEFINED_JSON_ACLS:
+            raise ValueError("Invalid predefined ACL: %s" % (predefined,))
+        return predefined
+
     def reset(self):
         """Remove all entities from the ACL, and clear the ``loaded`` flag."""
         self.entities.clear()
@@ -217,7 +239,7 @@ def __iter__(self):
         for entity in self.entities.values():
             for role in entity.get_roles():
                 if role:
-                    yield {'entity': str(entity), 'role': role}
+                    yield {"entity": str(entity), "role": role}
 
     def entity_from_dict(self, entity_dict):
         """Build an _ACLEntity object from a dictionary of data.
@@ -232,22 +254,21 @@ def entity_from_dict(self, entity_dict):
         :rtype: :class:`_ACLEntity`
         :returns: An Entity constructed from the dictionary.
         """
-        entity = entity_dict['entity']
-        role = entity_dict['role']
+        entity = entity_dict["entity"]
+        role = entity_dict["role"]
 
-        if entity == 'allUsers':
+        if entity == "allUsers":
             entity = self.all()
 
-        elif entity == 'allAuthenticatedUsers':
+        elif entity == "allAuthenticatedUsers":
             entity = self.all_authenticated()
 
-        elif '-' in entity:
-            entity_type, identifier = entity.split('-', 1)
-            entity = self.entity(entity_type=entity_type,
-                                 identifier=identifier)
+        elif "-" in entity:
+            entity_type, identifier = entity.split("-", 1)
+            entity = self.entity(entity_type=entity_type, identifier=identifier)
 
         if not isinstance(entity, _ACLEntity):
-            raise ValueError('Invalid dictionary: %s' % entity_dict)
+            raise ValueError("Invalid dictionary: %s" % entity_dict)
 
         entity.grant(role)
         return entity
@@ -258,7 +279,7 @@ def has_entity(self, entity):
         :type entity: :class:`_ACLEntity`
         :param entity: The entity to check for existence in this ACL.
 
-        :rtype: boolean
+        :rtype: bool
         :returns: True of the entity exists in the ACL.
         """
         self._ensure_loaded()
@@ -298,11 +319,11 @@ def entity(self, entity_type, identifier=None):
         create a new one and add it to the list of known entities for
         this ACL.
 
-        :type entity_type: string
+        :type entity_type: str
         :param entity_type: The type of entity to create
                             (ie, ``user``, ``group``, etc)
 
-        :type identifier: string
+        :type identifier: str
         :param identifier: The ID of the entity (if applicable).
                            This can be either an ID or an e-mail address.
 
@@ -319,35 +340,35 @@ def entity(self, entity_type, identifier=None):
     def user(self, identifier):
         """Factory method for a user Entity.
 
-        :type identifier: string
+        :type identifier: str
         :param identifier: An id or e-mail for this particular user.
 
         :rtype: :class:`_ACLEntity`
         :returns: An Entity corresponding to this user.
         """
-        return self.entity('user', identifier=identifier)
+        return self.entity("user", identifier=identifier)
 
     def group(self, identifier):
         """Factory method for a group Entity.
 
-        :type identifier: string
+        :type identifier: str
         :param identifier: An id or e-mail for this particular group.
 
         :rtype: :class:`_ACLEntity`
         :returns: An Entity corresponding to this group.
         """
-        return self.entity('group', identifier=identifier)
+        return self.entity("group", identifier=identifier)
 
     def domain(self, domain):
         """Factory method for a domain Entity.
 
-        :type domain: string
+        :type domain: str
         :param domain: The domain for this entity.
 
         :rtype: :class:`_ACLEntity`
         :returns: An entity corresponding to this domain.
         """
-        return self.entity('domain', identifier=domain)
+        return self.entity("domain", identifier=domain)
 
     def all(self):
         """Factory method for an Entity representing all users.
@@ -355,7 +376,7 @@ def all(self):
         :rtype: :class:`_ACLEntity`
         :returns: An entity representing all users.
         """
-        return self.entity('allUsers')
+        return self.entity("allUsers")
 
     def all_authenticated(self):
         """Factory method for an Entity representing all authenticated users.
@@ -363,7 +384,7 @@ def all_authenticated(self):
         :rtype: :class:`_ACLEntity`
         :returns: An entity representing all authenticated users.
         """
-        return self.entity('allAuthenticatedUsers')
+        return self.entity("allAuthenticatedUsers")
 
     def get_entities(self):
         """Get a list of all Entity objects.
@@ -397,6 +418,8 @@ def _require_client(self, client):
     def reload(self, client=None):
         """Reload the ACL data from Cloud Storage.
 
+        If :attr:`user_project` is set, bills the API request to that project.
+
         :type client: :class:`~google.cloud.storage.client.Client` or
                       ``NoneType``
         :param client: Optional. The client to use.  If not passed, falls back
@@ -404,12 +427,18 @@ def reload(self, client=None):
         """
         path = self.reload_path
         client = self._require_client(client)
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
 
         self.entities.clear()
 
-        found = client.connection.api_request(method='GET', path=path)
+        found = client._connection.api_request(
+            method="GET", path=path, query_params=query_params
+        )
         self.loaded = True
-        for entry in found.get('items', ()):
+        for entry in found.get("items", ()):
             self.add_entity(self.entity_from_dict(entry))
 
     def _save(self, acl, predefined, client):
@@ -419,28 +448,33 @@ def _save(self, acl, predefined, client):
         :param acl: The ACL object to save.  If left blank, this will save
                     current entries.
 
-        :type predefined: string or None
-        :param predefined: An identifier for a predefined ACL.  Must be one
-                           of the keys in :attr:`PREDEFINED_JSON_ACLS`
-                           If passed, `acl` must be None.
+        :type predefined: str
+        :param predefined:
+            (Optional) An identifier for a predefined ACL.  Must be one of the
+            keys in :attr:`PREDEFINED_JSON_ACLS` If passed, `acl` must be None.
 
         :type client: :class:`~google.cloud.storage.client.Client` or
                       ``NoneType``
         :param client: Optional. The client to use.  If not passed, falls back
                        to the ``client`` stored on the ACL's parent.
         """
-        query_params = {'projection': 'full'}
+        query_params = {"projection": "full"}
         if predefined is not None:
             acl = []
             query_params[self._PREDEFINED_QUERY_PARAM] = predefined
 
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
         path = self.save_path
         client = self._require_client(client)
-        result = client.connection.api_request(
-            method='PATCH',
+
+        result = client._connection.api_request(
+            method="PATCH",
             path=path,
             data={self._URL_PATH_ELEM: list(acl)},
-            query_params=query_params)
+            query_params=query_params,
+        )
         self.entities.clear()
         for entry in result.get(self._URL_PATH_ELEM, ()):
             self.add_entity(self.entity_from_dict(entry))
@@ -449,6 +483,8 @@ def _save(self, acl, predefined, client):
     def save(self, acl=None, client=None):
         """Save this ACL for the current bucket.
 
+        If :attr:`user_project` is set, bills the API request to that project.
+
         :type acl: :class:`google.cloud.storage.acl.ACL`, or a compatible list.
         :param acl: The ACL object to save.  If left blank, this will save
                     current entries.
@@ -470,7 +506,9 @@ def save(self, acl=None, client=None):
     def save_predefined(self, predefined, client=None):
         """Save this ACL for the current bucket using a predefined ACL.
 
-        :type predefined: string
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type predefined: str
         :param predefined: An identifier for a predefined ACL.  Must be one
                            of the keys in :attr:`PREDEFINED_JSON_ACLS`
                            or :attr:`PREDEFINED_XML_ACLS` (which will be
@@ -482,16 +520,14 @@ def save_predefined(self, predefined, client=None):
         :param client: Optional. The client to use.  If not passed, falls back
                        to the ``client`` stored on the ACL's parent.
         """
-        predefined = self.PREDEFINED_XML_ACLS.get(predefined, predefined)
-
-        if predefined not in self.PREDEFINED_JSON_ACLS:
-            raise ValueError("Invalid predefined ACL: %s" % (predefined,))
-
+        predefined = self.validate_predefined(predefined)
         self._save(None, predefined, client)
 
     def clear(self, client=None):
         """Remove all ACL entries.
 
+        If :attr:`user_project` is set, bills the API request to that project.
+
         Note that this won't actually remove *ALL* the rules, but it
         will remove all the non-default rules.  In short, you'll still
         have access to a bucket that you created even after you clear
@@ -524,19 +560,24 @@ def client(self):
     @property
     def reload_path(self):
         """Compute the path for GET API requests for this ACL."""
-        return '%s/%s' % (self.bucket.path, self._URL_PATH_ELEM)
+        return "%s/%s" % (self.bucket.path, self._URL_PATH_ELEM)
 
     @property
     def save_path(self):
         """Compute the path for PATCH API requests for this ACL."""
         return self.bucket.path
 
+    @property
+    def user_project(self):
+        """Compute the user project charged for API requests for this ACL."""
+        return self.bucket.user_project
+
 
 class DefaultObjectACL(BucketACL):
     """A class representing the default object ACL for a bucket."""
 
-    _URL_PATH_ELEM = 'defaultObjectAcl'
-    _PREDEFINED_QUERY_PARAM = 'predefinedDefaultObjectAcl'
+    _URL_PATH_ELEM = "defaultObjectAcl"
+    _PREDEFINED_QUERY_PARAM = "predefinedDefaultObjectAcl"
 
 
 class ObjectACL(ACL):
@@ -558,9 +599,14 @@ def client(self):
     @property
     def reload_path(self):
         """Compute the path for GET API requests for this ACL."""
-        return '%s/acl' % self.blob.path
+        return "%s/acl" % self.blob.path
 
     @property
     def save_path(self):
         """Compute the path for PATCH API requests for this ACL."""
         return self.blob.path
+
+    @property
+    def user_project(self):
+        """Compute the user project charged for API requests for this ACL."""
+        return self.blob.user_project
diff --git a/storage/google/cloud/storage/batch.py b/storage/google/cloud/storage/batch.py
new file mode 100644
index 000000000000..772531222e24
--- /dev/null
+++ b/storage/google/cloud/storage/batch.py
@@ -0,0 +1,335 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Batch updates / deletes of storage buckets / blobs.
+
+See https://cloud.google.com/storage/docs/json_api/v1/how-tos/batch
+"""
+from email.encoders import encode_noop
+from email.generator import Generator
+from email.mime.application import MIMEApplication
+from email.mime.multipart import MIMEMultipart
+from email.parser import Parser
+import io
+import json
+
+import requests
+import six
+
+from google.cloud import _helpers
+from google.cloud import exceptions
+from google.cloud.storage._http import Connection
+
+
+class MIMEApplicationHTTP(MIMEApplication):
+    """MIME type for ``application/http``.
+
+    Constructs payload from headers and body
+
+    :type method: str
+    :param method: HTTP method
+
+    :type uri: str
+    :param uri: URI for HTTP request
+
+    :type headers:  dict
+    :param headers: HTTP headers
+
+    :type body: str
+    :param body: (Optional) HTTP payload
+
+    """
+
+    def __init__(self, method, uri, headers, body):
+        if isinstance(body, dict):
+            body = json.dumps(body)
+            headers["Content-Type"] = "application/json"
+            headers["Content-Length"] = len(body)
+        if body is None:
+            body = ""
+        lines = ["%s %s HTTP/1.1" % (method, uri)]
+        lines.extend(
+            ["%s: %s" % (key, value) for key, value in sorted(headers.items())]
+        )
+        lines.append("")
+        lines.append(body)
+        payload = "\r\n".join(lines)
+        if six.PY2:
+            # email.message.Message is an old-style class, so we
+            # cannot use 'super()'.
+            MIMEApplication.__init__(self, payload, "http", encode_noop)
+        else:  # pragma: NO COVER  Python3
+            super_init = super(MIMEApplicationHTTP, self).__init__
+            super_init(payload, "http", encode_noop)
+
+
+class _FutureDict(object):
+    """Class to hold a future value for a deferred request.
+
+    Used by for requests that get sent in a :class:`Batch`.
+    """
+
+    @staticmethod
+    def get(key, default=None):
+        """Stand-in for dict.get.
+
+        :type key: object
+        :param key: Hashable dictionary key.
+
+        :type default: object
+        :param default: Fallback value to dict.get.
+
+        :raises: :class:`KeyError` always since the future is intended to fail
+                 as a dictionary.
+        """
+        raise KeyError("Cannot get(%r, default=%r) on a future" % (key, default))
+
+    def __getitem__(self, key):
+        """Stand-in for dict[key].
+
+        :type key: object
+        :param key: Hashable dictionary key.
+
+        :raises: :class:`KeyError` always since the future is intended to fail
+                 as a dictionary.
+        """
+        raise KeyError("Cannot get item %r from a future" % (key,))
+
+    def __setitem__(self, key, value):
+        """Stand-in for dict[key] = value.
+
+        :type key: object
+        :param key: Hashable dictionary key.
+
+        :type value: object
+        :param value: Dictionary value.
+
+        :raises: :class:`KeyError` always since the future is intended to fail
+                 as a dictionary.
+        """
+        raise KeyError("Cannot set %r -> %r on a future" % (key, value))
+
+
+class _FutureResponse(requests.Response):
+    """Reponse that returns a placeholder dictionary for a batched requests."""
+
+    def __init__(self, future_dict):
+        super(_FutureResponse, self).__init__()
+        self._future_dict = future_dict
+        self.status_code = 204
+
+    def json(self):
+        return self._future_dict
+
+    @property
+    def content(self):
+        return self._future_dict
+
+
+class Batch(Connection):
+    """Proxy an underlying connection, batching up change operations.
+
+    :type client: :class:`google.cloud.storage.client.Client`
+    :param client: The client to use for making connections.
+    """
+
+    _MAX_BATCH_SIZE = 1000
+
+    def __init__(self, client):
+        super(Batch, self).__init__(client)
+        self._requests = []
+        self._target_objects = []
+
+    def _do_request(self, method, url, headers, data, target_object):
+        """Override Connection:  defer actual HTTP request.
+
+        Only allow up to ``_MAX_BATCH_SIZE`` requests to be deferred.
+
+        :type method: str
+        :param method: The HTTP method to use in the request.
+
+        :type url: str
+        :param url: The URL to send the request to.
+
+        :type headers: dict
+        :param headers: A dictionary of HTTP headers to send with the request.
+
+        :type data: str
+        :param data: The data to send as the body of the request.
+
+        :type target_object: object
+        :param target_object:
+            (Optional) This allows us to enable custom behavior in our batch
+            connection. Here we defer an HTTP request and complete
+            initialization of the object at a later time.
+
+        :rtype: tuple of ``response`` (a dictionary of sorts)
+                and ``content`` (a string).
+        :returns: The HTTP response object and the content of the response.
+        """
+        if len(self._requests) >= self._MAX_BATCH_SIZE:
+            raise ValueError(
+                "Too many deferred requests (max %d)" % self._MAX_BATCH_SIZE
+            )
+        self._requests.append((method, url, headers, data))
+        result = _FutureDict()
+        self._target_objects.append(target_object)
+        if target_object is not None:
+            target_object._properties = result
+        return _FutureResponse(result)
+
+    def _prepare_batch_request(self):
+        """Prepares headers and body for a batch request.
+
+        :rtype: tuple (dict, str)
+        :returns: The pair of headers and body of the batch request to be sent.
+        :raises: :class:`ValueError` if no requests have been deferred.
+        """
+        if len(self._requests) == 0:
+            raise ValueError("No deferred requests")
+
+        multi = MIMEMultipart()
+
+        for method, uri, headers, body in self._requests:
+            subrequest = MIMEApplicationHTTP(method, uri, headers, body)
+            multi.attach(subrequest)
+
+        # The `email` package expects to deal with "native" strings
+        if six.PY3:  # pragma: NO COVER  Python3
+            buf = io.StringIO()
+        else:
+            buf = io.BytesIO()
+        generator = Generator(buf, False, 0)
+        generator.flatten(multi)
+        payload = buf.getvalue()
+
+        # Strip off redundant header text
+        _, body = payload.split("\n\n", 1)
+        return dict(multi._headers), body
+
+    def _finish_futures(self, responses):
+        """Apply all the batch responses to the futures created.
+
+        :type responses: list of (headers, payload) tuples.
+        :param responses: List of headers and payloads from each response in
+                          the batch.
+
+        :raises: :class:`ValueError` if no requests have been deferred.
+        """
+        # If a bad status occurs, we track it, but don't raise an exception
+        # until all futures have been populated.
+        exception_args = None
+
+        if len(self._target_objects) != len(responses):
+            raise ValueError("Expected a response for every request.")
+
+        for target_object, subresponse in zip(self._target_objects, responses):
+            if not 200 <= subresponse.status_code < 300:
+                exception_args = exception_args or subresponse
+            elif target_object is not None:
+                try:
+                    target_object._properties = subresponse.json()
+                except ValueError:
+                    target_object._properties = subresponse.content
+
+        if exception_args is not None:
+            raise exceptions.from_http_response(exception_args)
+
+    def finish(self):
+        """Submit a single `multipart/mixed` request with deferred requests.
+
+        :rtype: list of tuples
+        :returns: one ``(headers, payload)`` tuple per deferred request.
+        """
+        headers, body = self._prepare_batch_request()
+
+        url = "%s/batch/storage/v1" % self.API_BASE_URL
+
+        # Use the private ``_base_connection`` rather than the property
+        # ``_connection``, since the property may be this
+        # current batch.
+        response = self._client._base_connection._make_request(
+            "POST", url, data=body, headers=headers
+        )
+        responses = list(_unpack_batch_response(response))
+        self._finish_futures(responses)
+        return responses
+
+    def current(self):
+        """Return the topmost batch, or None."""
+        return self._client.current_batch
+
+    def __enter__(self):
+        self._client._push_batch(self)
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        try:
+            if exc_type is None:
+                self.finish()
+        finally:
+            self._client._pop_batch()
+
+
+def _generate_faux_mime_message(parser, response):
+    """Convert response, content -> (multipart) email.message.
+
+    Helper for _unpack_batch_response.
+    """
+    # We coerce to bytes to get consistent concat across
+    # Py2 and Py3. Percent formatting is insufficient since
+    # it includes the b in Py3.
+    content_type = _helpers._to_bytes(response.headers.get("content-type", ""))
+
+    faux_message = b"".join(
+        [b"Content-Type: ", content_type, b"\nMIME-Version: 1.0\n\n", response.content]
+    )
+
+    if six.PY2:
+        return parser.parsestr(faux_message)
+    else:  # pragma: NO COVER  Python3
+        return parser.parsestr(faux_message.decode("utf-8"))
+
+
+def _unpack_batch_response(response):
+    """Convert requests.Response -> [(headers, payload)].
+
+    Creates a generator of tuples of emulating the responses to
+    :meth:`requests.Session.request`.
+
+    :type response: :class:`requests.Response`
+    :param response: HTTP response / headers from a request.
+    """
+    parser = Parser()
+    message = _generate_faux_mime_message(parser, response)
+
+    if not isinstance(message._payload, list):
+        raise ValueError("Bad response:  not multi-part")
+
+    for subrequest in message._payload:
+        status_line, rest = subrequest._payload.split("\n", 1)
+        _, status, _ = status_line.split(" ", 2)
+        sub_message = parser.parsestr(rest)
+        payload = sub_message._payload
+        msg_headers = dict(sub_message._headers)
+        content_id = msg_headers.get("Content-ID")
+
+        subresponse = requests.Response()
+        subresponse.request = requests.Request(
+            method="BATCH", url="contentid://{}".format(content_id)
+        ).prepare()
+        subresponse.status_code = int(status)
+        subresponse.headers.update(msg_headers)
+        subresponse._content = payload.encode("utf-8")
+
+        yield subresponse
diff --git a/storage/google/cloud/storage/blob.py b/storage/google/cloud/storage/blob.py
new file mode 100644
index 000000000000..5b8f217d2ec8
--- /dev/null
+++ b/storage/google/cloud/storage/blob.py
@@ -0,0 +1,2099 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# pylint: disable=too-many-lines
+
+"""Create / interact with Google Cloud Storage blobs.
+
+.. _API reference docs: https://cloud.google.com/storage/docs/\
+                        json_api/v1/objects
+.. _customer-supplied: https://cloud.google.com/storage/docs/\
+                       encryption#customer-supplied
+.. _google-resumable-media: https://googleapis.github.io/\
+                            google-resumable-media-python/latest/\
+                            google.resumable_media.requests.html
+"""
+
+import base64
+import copy
+import hashlib
+from io import BytesIO
+import mimetypes
+import os
+import time
+import warnings
+
+from six.moves.urllib.parse import parse_qsl
+from six.moves.urllib.parse import quote
+from six.moves.urllib.parse import urlencode
+from six.moves.urllib.parse import urlsplit
+from six.moves.urllib.parse import urlunsplit
+
+from google import resumable_media
+from google.resumable_media.requests import ChunkedDownload
+from google.resumable_media.requests import Download
+from google.resumable_media.requests import MultipartUpload
+from google.resumable_media.requests import ResumableUpload
+
+from google.cloud import exceptions
+from google.cloud._helpers import _rfc3339_to_datetime
+from google.cloud._helpers import _to_bytes
+from google.cloud._helpers import _bytes_to_unicode
+from google.cloud.exceptions import NotFound
+from google.api_core.iam import Policy
+from google.cloud.storage._helpers import _PropertyMixin
+from google.cloud.storage._helpers import _scalar_property
+from google.cloud.storage._signing import generate_signed_url_v2
+from google.cloud.storage._signing import generate_signed_url_v4
+from google.cloud.storage.acl import ACL
+from google.cloud.storage.acl import ObjectACL
+
+
+_API_ACCESS_ENDPOINT = "https://storage.googleapis.com"
+_DEFAULT_CONTENT_TYPE = u"application/octet-stream"
+_DOWNLOAD_URL_TEMPLATE = (
+    u"https://www.googleapis.com/download/storage/v1{path}?alt=media"
+)
+_BASE_UPLOAD_TEMPLATE = (
+    u"https://www.googleapis.com/upload/storage/v1{bucket_path}/o?uploadType="
+)
+_MULTIPART_URL_TEMPLATE = _BASE_UPLOAD_TEMPLATE + u"multipart"
+_RESUMABLE_URL_TEMPLATE = _BASE_UPLOAD_TEMPLATE + u"resumable"
+# NOTE: "acl" is also writeable but we defer ACL management to
+#       the classes in the google.cloud.storage.acl module.
+_CONTENT_TYPE_FIELD = "contentType"
+_WRITABLE_FIELDS = (
+    "cacheControl",
+    "contentDisposition",
+    "contentEncoding",
+    "contentLanguage",
+    _CONTENT_TYPE_FIELD,
+    "crc32c",
+    "md5Hash",
+    "metadata",
+    "name",
+    "storageClass",
+)
+_NUM_RETRIES_MESSAGE = (
+    "`num_retries` has been deprecated and will be removed in a future "
+    "release. The default behavior (when `num_retries` is not specified) when "
+    "a transient error (e.g. 429 Too Many Requests or 500 Internal Server "
+    "Error) occurs will be as follows: upload requests will be automatically "
+    "retried. Subsequent retries will be sent after waiting 1, 2, 4, 8, etc. "
+    "seconds (exponential backoff) until 10 minutes of wait time have "
+    "elapsed. At that point, there will be no more attempts to retry."
+)
+_READ_LESS_THAN_SIZE = (
+    "Size {:d} was specified but the file-like object only had " "{:d} bytes remaining."
+)
+
+_DEFAULT_CHUNKSIZE = 104857600  # 1024 * 1024 B * 100 = 100 MB
+_MAX_MULTIPART_SIZE = 8388608  # 8 MB
+
+
+class Blob(_PropertyMixin):
+    """A wrapper around Cloud Storage's concept of an ``Object``.
+
+    :type name: str
+    :param name: The name of the blob.  This corresponds to the unique path of
+                 the object in the bucket. If bytes, will be converted to a
+                 unicode object. Blob / object names can contain any sequence
+                 of valid unicode characters, of length 1-1024 bytes when
+                 UTF-8 encoded.
+
+    :type bucket: :class:`google.cloud.storage.bucket.Bucket`
+    :param bucket: The bucket to which this blob belongs.
+
+    :type chunk_size: int
+
+    :param chunk_size: The size of a chunk of data whenever iterating (in
+                       bytes). This must be a multiple of 256 KB per the API
+                       specification.
+
+    :type encryption_key: bytes
+    :param encryption_key:
+        Optional 32 byte encryption key for customer-supplied encryption.
+        See https://cloud.google.com/storage/docs/encryption#customer-supplied.
+
+    :type kms_key_name: str
+    :param kms_key_name:
+        Optional resource name of Cloud KMS key used to encrypt the blob's
+        contents.
+    """
+
+    _chunk_size = None  # Default value for each instance.
+    _CHUNK_SIZE_MULTIPLE = 256 * 1024
+    """Number (256 KB, in bytes) that must divide the chunk size."""
+
+    _STORAGE_CLASSES = (
+        "NEARLINE",
+        "MULTI_REGIONAL",
+        "REGIONAL",
+        "COLDLINE",
+        "STANDARD",  # alias for MULTI_REGIONAL/REGIONAL, based on location
+    )
+    """Allowed values for :attr:`storage_class`.
+
+    See
+    https://cloud.google.com/storage/docs/json_api/v1/objects#storageClass
+    https://cloud.google.com/storage/docs/per-object-storage-class
+
+    .. note::
+       This list does not include 'DURABLE_REDUCED_AVAILABILITY', which
+       is only documented for buckets (and deprecated).
+
+    .. note::
+       The documentation does *not* mention 'STANDARD', but it is the value
+       assigned by the back-end for objects created in buckets with 'STANDARD'
+       set as their 'storage_class'.
+    """
+
+    def __init__(
+        self,
+        name,
+        bucket,
+        chunk_size=None,
+        encryption_key=None,
+        kms_key_name=None,
+        generation=None,
+    ):
+        name = _bytes_to_unicode(name)
+        super(Blob, self).__init__(name=name)
+
+        self.chunk_size = chunk_size  # Check that setter accepts value.
+        self._bucket = bucket
+        self._acl = ObjectACL(self)
+        if encryption_key is not None and kms_key_name is not None:
+            raise ValueError(
+                "Pass at most one of 'encryption_key' " "and 'kms_key_name'"
+            )
+
+        self._encryption_key = encryption_key
+
+        if kms_key_name is not None:
+            self._properties["kmsKeyName"] = kms_key_name
+
+        if generation is not None:
+            self._properties["generation"] = generation
+
+    @property
+    def bucket(self):
+        """Bucket which contains the object.
+
+        :rtype: :class:`~google.cloud.storage.bucket.Bucket`
+        :returns: The object's bucket.
+        """
+        return self._bucket
+
+    @property
+    def chunk_size(self):
+        """Get the blob's default chunk size.
+
+        :rtype: int or ``NoneType``
+        :returns: The current blob's chunk size, if it is set.
+        """
+        return self._chunk_size
+
+    @chunk_size.setter
+    def chunk_size(self, value):
+        """Set the blob's default chunk size.
+
+        :type value: int
+        :param value: (Optional) The current blob's chunk size, if it is set.
+
+        :raises: :class:`ValueError` if ``value`` is not ``None`` and is not a
+                 multiple of 256 KB.
+        """
+        if value is not None and value > 0 and value % self._CHUNK_SIZE_MULTIPLE != 0:
+            raise ValueError(
+                "Chunk size must be a multiple of %d." % (self._CHUNK_SIZE_MULTIPLE,)
+            )
+        self._chunk_size = value
+
+    @staticmethod
+    def path_helper(bucket_path, blob_name):
+        """Relative URL path for a blob.
+
+        :type bucket_path: str
+        :param bucket_path: The URL path for a bucket.
+
+        :type blob_name: str
+        :param blob_name: The name of the blob.
+
+        :rtype: str
+        :returns: The relative URL path for ``blob_name``.
+        """
+        return bucket_path + "/o/" + _quote(blob_name)
+
+    @property
+    def acl(self):
+        """Create our ACL on demand."""
+        return self._acl
+
+    def __repr__(self):
+        if self.bucket:
+            bucket_name = self.bucket.name
+        else:
+            bucket_name = None
+
+        return "<Blob: %s, %s, %s>" % (bucket_name, self.name, self.generation)
+
+    @property
+    def path(self):
+        """Getter property for the URL path to this Blob.
+
+        :rtype: str
+        :returns: The URL path to this Blob.
+        """
+        if not self.name:
+            raise ValueError("Cannot determine path without a blob name.")
+
+        return self.path_helper(self.bucket.path, self.name)
+
+    @property
+    def client(self):
+        """The client bound to this blob."""
+        return self.bucket.client
+
+    @property
+    def user_project(self):
+        """Project ID billed for API requests made via this blob.
+
+        Derived from bucket's value.
+
+        :rtype: str
+        """
+        return self.bucket.user_project
+
+    def _encryption_headers(self):
+        """Return any encryption headers needed to fetch the object.
+
+        :rtype: List(Tuple(str, str))
+        :returns: a list of tuples to be passed as headers.
+        """
+        return _get_encryption_headers(self._encryption_key)
+
+    @property
+    def _query_params(self):
+        """Default query parameters."""
+        params = {}
+        if self.generation is not None:
+            params["generation"] = self.generation
+        if self.user_project is not None:
+            params["userProject"] = self.user_project
+        return params
+
+    @property
+    def public_url(self):
+        """The public URL for this blob.
+
+        Use :meth:`make_public` to enable anonymous access via the returned
+        URL.
+
+        :rtype: `string`
+        :returns: The public URL for this blob.
+        """
+        return "{storage_base_url}/{bucket_name}/{quoted_name}".format(
+            storage_base_url=_API_ACCESS_ENDPOINT,
+            bucket_name=self.bucket.name,
+            quoted_name=_quote(self.name, safe=b"/~"),
+        )
+
+    @classmethod
+    def from_string(cls, uri, client=None):
+        """Get a constructor for blob object by URI.
+
+         :type uri: str
+         :param uri: The blob uri pass to get blob object.
+
+         :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+         :param client: Optional. The client to use.
+
+         :rtype: :class:`google.cloud.storage.blob.Blob`
+         :returns: The blob object created.
+
+         Example:
+            Get a constructor for blob object by URI..
+
+            >>> from google.cloud import storage
+            >>> from google.cloud.storage.blob import Blob
+            >>> client = storage.Client()
+            >>> blob = Blob.from_string("gs://bucket/object")
+         """
+        from google.cloud.storage.bucket import Bucket
+
+        scheme, netloc, path, query, frag = urlsplit(uri)
+        if scheme != "gs":
+            raise ValueError("URI scheme must be gs")
+
+        bucket = Bucket(client, name=netloc)
+        return cls(path[1:], bucket)
+
+    def generate_signed_url(
+        self,
+        expiration=None,
+        api_access_endpoint=_API_ACCESS_ENDPOINT,
+        method="GET",
+        content_md5=None,
+        content_type=None,
+        response_disposition=None,
+        response_type=None,
+        generation=None,
+        headers=None,
+        query_parameters=None,
+        client=None,
+        credentials=None,
+        version=None,
+    ):
+        """Generates a signed URL for this blob.
+
+        .. note::
+
+            If you are on Google Compute Engine, you can't generate a signed
+            URL using GCE service account. Follow `Issue 50`_ for updates on
+            this. If you'd like to be able to generate a signed URL from GCE,
+            you can use a standard service account from a JSON file rather
+            than a GCE service account.
+
+        .. _Issue 50: https://github.com/GoogleCloudPlatform/\
+                      google-auth-library-python/issues/50
+
+        If you have a blob that you want to allow access to for a set
+        amount of time, you can use this method to generate a URL that
+        is only valid within a certain time period.
+
+        This is particularly useful if you don't want publicly
+        accessible blobs, but don't want to require users to explicitly
+        log in.
+
+        :type expiration: Union[Integer, datetime.datetime, datetime.timedelta]
+        :param expiration: Point in time when the signed URL should expire.
+
+        :type api_access_endpoint: str
+        :param api_access_endpoint: Optional URI base.
+
+        :type method: str
+        :param method: The HTTP verb that will be used when requesting the URL.
+
+        :type content_md5: str
+        :param content_md5: (Optional) The MD5 hash of the object referenced by
+                            ``resource``.
+
+        :type content_type: str
+        :param content_type: (Optional) The content type of the object
+                             referenced by ``resource``.
+
+        :type response_disposition: str
+        :param response_disposition: (Optional) Content disposition of
+                                     responses to requests for the signed URL.
+                                     For example, to enable the signed URL
+                                     to initiate a file of ``blog.png``, use
+                                     the value
+                                     ``'attachment; filename=blob.png'``.
+
+        :type response_type: str
+        :param response_type: (Optional) Content type of responses to requests
+                              for the signed URL. Ignored if content_type is
+                              set on object/blob metadata.
+
+        :type generation: str
+        :param generation: (Optional) A value that indicates which generation
+                           of the resource to fetch.
+
+        :type headers: dict
+        :param headers:
+            (Optional) Additional HTTP headers to be included as part of the
+            signed URLs.  See:
+            https://cloud.google.com/storage/docs/xml-api/reference-headers
+            Requests using the signed URL *must* pass the specified header
+            (name and value) with each request for the URL.
+
+        :type query_parameters: dict
+        :param query_parameters:
+            (Optional) Additional query paramtersto be included as part of the
+            signed URLs.  See:
+            https://cloud.google.com/storage/docs/xml-api/reference-headers#query
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+
+        :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
+                           :class:`NoneType`
+        :param credentials: (Optional) The OAuth2 credentials to use to sign
+                            the URL. Defaults to the credentials stored on the
+                            client used.
+
+        :type version: str
+        :param version: (Optional) The version of signed credential to create.
+                        Must be one of 'v2' | 'v4'.
+
+        :raises: :exc:`ValueError` when version is invalid.
+        :raises: :exc:`TypeError` when expiration is not a valid type.
+        :raises: :exc:`AttributeError` if credentials is not an instance
+                of :class:`google.auth.credentials.Signing`.
+
+        :rtype: str
+        :returns: A signed URL you can use to access the resource
+                  until expiration.
+        """
+        if version is None:
+            version = "v2"
+        elif version not in ("v2", "v4"):
+            raise ValueError("'version' must be either 'v2' or 'v4'")
+
+        quoted_name = _quote(self.name, safe=b"/~")
+        resource = "/{bucket_name}/{quoted_name}".format(
+            bucket_name=self.bucket.name, quoted_name=quoted_name
+        )
+
+        if credentials is None:
+            client = self._require_client(client)
+            credentials = client._credentials
+
+        if version == "v2":
+            helper = generate_signed_url_v2
+        else:
+            helper = generate_signed_url_v4
+
+        return helper(
+            credentials,
+            resource=resource,
+            expiration=expiration,
+            api_access_endpoint=api_access_endpoint,
+            method=method.upper(),
+            content_md5=content_md5,
+            content_type=content_type,
+            response_type=response_type,
+            response_disposition=response_disposition,
+            generation=generation,
+            headers=headers,
+            query_parameters=query_parameters,
+        )
+
+    def exists(self, client=None):
+        """Determines whether or not this blob exists.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :rtype: bool
+        :returns: True if the blob exists in Cloud Storage.
+        """
+        client = self._require_client(client)
+        # We only need the status code (200 or not) so we seek to
+        # minimize the returned payload.
+        query_params = self._query_params
+        query_params["fields"] = "name"
+
+        try:
+            # We intentionally pass `_target_object=None` since fields=name
+            # would limit the local properties.
+            client._connection.api_request(
+                method="GET",
+                path=self.path,
+                query_params=query_params,
+                _target_object=None,
+            )
+            # NOTE: This will not fail immediately in a batch. However, when
+            #       Batch.finish() is called, the resulting `NotFound` will be
+            #       raised.
+            return True
+        except NotFound:
+            return False
+
+    def delete(self, client=None):
+        """Deletes a blob from Cloud Storage.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :rtype: :class:`Blob`
+        :returns: The blob that was just deleted.
+        :raises: :class:`google.cloud.exceptions.NotFound`
+                 (propagated from
+                 :meth:`google.cloud.storage.bucket.Bucket.delete_blob`).
+        """
+        return self.bucket.delete_blob(
+            self.name, client=client, generation=self.generation
+        )
+
+    def _get_transport(self, client):
+        """Return the client's transport.
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :rtype transport:
+            :class:`~google.auth.transport.requests.AuthorizedSession`
+        :returns: The transport (with credentials) that will
+                  make authenticated requests.
+        """
+        client = self._require_client(client)
+        return client._http
+
+    def _get_download_url(self):
+        """Get the download URL for the current blob.
+
+        If the ``media_link`` has been loaded, it will be used, otherwise
+        the URL will be constructed from the current blob's path (and possibly
+        generation) to avoid a round trip.
+
+        :rtype: str
+        :returns: The download URL for the current blob.
+        """
+        name_value_pairs = []
+        if self.media_link is None:
+            base_url = _DOWNLOAD_URL_TEMPLATE.format(path=self.path)
+            if self.generation is not None:
+                name_value_pairs.append(("generation", "{:d}".format(self.generation)))
+        else:
+            base_url = self.media_link
+
+        if self.user_project is not None:
+            name_value_pairs.append(("userProject", self.user_project))
+
+        return _add_query_parameters(base_url, name_value_pairs)
+
+    def _do_download(
+        self, transport, file_obj, download_url, headers, start=None, end=None
+    ):
+        """Perform a download without any error handling.
+
+        This is intended to be called by :meth:`download_to_file` so it can
+        be wrapped with error handling / remapping.
+
+        :type transport:
+            :class:`~google.auth.transport.requests.AuthorizedSession`
+        :param transport: The transport (with credentials) that will
+                          make authenticated requests.
+
+        :type file_obj: file
+        :param file_obj: A file handle to which to write the blob's data.
+
+        :type download_url: str
+        :param download_url: The URL where the media can be accessed.
+
+        :type headers: dict
+        :param headers: Optional headers to be sent with the request(s).
+
+        :type start: int
+        :param start: Optional, the first byte in a range to be downloaded.
+
+        :type end: int
+        :param end: Optional, The last byte in a range to be downloaded.
+        """
+        if self.chunk_size is None:
+            download = Download(
+                download_url, stream=file_obj, headers=headers, start=start, end=end
+            )
+            download.consume(transport)
+        else:
+            download = ChunkedDownload(
+                download_url,
+                self.chunk_size,
+                file_obj,
+                headers=headers,
+                start=start if start else 0,
+                end=end,
+            )
+
+            while not download.finished:
+                download.consume_next_chunk(transport)
+
+    def download_to_file(self, file_obj, client=None, start=None, end=None):
+        """Download the contents of this blob into a file-like object.
+
+        .. note::
+
+           If the server-set property, :attr:`media_link`, is not yet
+           initialized, makes an additional API request to load it.
+
+        Downloading a file that has been encrypted with a `customer-supplied`_
+        encryption key:
+
+         .. literalinclude:: snippets.py
+            :start-after: [START download_to_file]
+            :end-before: [END download_to_file]
+            :dedent: 4
+
+        The ``encryption_key`` should be a str or bytes with a length of at
+        least 32.
+
+        For more fine-grained control over the download process, check out
+        `google-resumable-media`_. For example, this library allows
+        downloading **parts** of a blob rather than the whole thing.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type file_obj: file
+        :param file_obj: A file handle to which to write the blob's data.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type start: int
+        :param start: Optional, the first byte in a range to be downloaded.
+
+        :type end: int
+        :param end: Optional, The last byte in a range to be downloaded.
+
+        :raises: :class:`google.cloud.exceptions.NotFound`
+        """
+        download_url = self._get_download_url()
+        headers = _get_encryption_headers(self._encryption_key)
+        headers["accept-encoding"] = "gzip"
+
+        transport = self._get_transport(client)
+        try:
+            self._do_download(transport, file_obj, download_url, headers, start, end)
+        except resumable_media.InvalidResponse as exc:
+            _raise_from_invalid_response(exc)
+
+    def download_to_filename(self, filename, client=None, start=None, end=None):
+        """Download the contents of this blob into a named file.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type filename: str
+        :param filename: A filename to be passed to ``open``.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type start: int
+        :param start: Optional, the first byte in a range to be downloaded.
+
+        :type end: int
+        :param end: Optional, The last byte in a range to be downloaded.
+
+        :raises: :class:`google.cloud.exceptions.NotFound`
+        """
+        try:
+            with open(filename, "wb") as file_obj:
+                self.download_to_file(file_obj, client=client, start=start, end=end)
+        except resumable_media.DataCorruption:
+            # Delete the corrupt downloaded file.
+            os.remove(filename)
+            raise
+
+        updated = self.updated
+        if updated is not None:
+            mtime = time.mktime(updated.timetuple())
+            os.utime(file_obj.name, (mtime, mtime))
+
+    def download_as_string(self, client=None, start=None, end=None):
+        """Download the contents of this blob as a string.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type start: int
+        :param start: Optional, the first byte in a range to be downloaded.
+
+        :type end: int
+        :param end: Optional, The last byte in a range to be downloaded.
+
+        :rtype: bytes
+        :returns: The data stored in this blob.
+        :raises: :class:`google.cloud.exceptions.NotFound`
+        """
+        string_buffer = BytesIO()
+        self.download_to_file(string_buffer, client=client, start=start, end=end)
+        return string_buffer.getvalue()
+
+    def _get_content_type(self, content_type, filename=None):
+        """Determine the content type from the current object.
+
+        The return value will be determined in order of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        :type content_type: str
+        :param content_type: (Optional) type of content.
+
+        :type filename: str
+        :param filename: (Optional) The name of the file where the content
+                         is stored.
+
+        :rtype: str
+        :returns: Type of content gathered from the object.
+        """
+        if content_type is None:
+            content_type = self.content_type
+
+        if content_type is None and filename is not None:
+            content_type, _ = mimetypes.guess_type(filename)
+
+        if content_type is None:
+            content_type = _DEFAULT_CONTENT_TYPE
+
+        return content_type
+
+    def _get_writable_metadata(self):
+        """Get the object / blob metadata which is writable.
+
+        This is intended to be used when creating a new object / blob.
+
+        See the `API reference docs`_ for more information, the fields
+        marked as writable are:
+
+        * ``acl``
+        * ``cacheControl``
+        * ``contentDisposition``
+        * ``contentEncoding``
+        * ``contentLanguage``
+        * ``contentType``
+        * ``crc32c``
+        * ``md5Hash``
+        * ``metadata``
+        * ``name``
+        * ``storageClass``
+
+        For now, we don't support ``acl``, access control lists should be
+        managed directly through :class:`ObjectACL` methods.
+        """
+        # NOTE: This assumes `self.name` is unicode.
+        object_metadata = {"name": self.name}
+        for key in self._changes:
+            if key in _WRITABLE_FIELDS:
+                object_metadata[key] = self._properties[key]
+
+        return object_metadata
+
+    def _get_upload_arguments(self, content_type):
+        """Get required arguments for performing an upload.
+
+        The content type returned will be determined in order of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        :type content_type: str
+        :param content_type: Type of content being uploaded (or :data:`None`).
+
+        :rtype: tuple
+        :returns: A triple of
+
+                  * A header dictionary
+                  * An object metadata dictionary
+                  * The ``content_type`` as a string (according to precedence)
+        """
+        headers = _get_encryption_headers(self._encryption_key)
+        object_metadata = self._get_writable_metadata()
+        content_type = self._get_content_type(content_type)
+        return headers, object_metadata, content_type
+
+    def _do_multipart_upload(
+        self, client, stream, content_type, size, num_retries, predefined_acl
+    ):
+        """Perform a multipart upload.
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type content_type: str
+        :param content_type: Type of content being uploaded (or :data:`None`).
+
+        :type size: int
+        :param size: The number of bytes to be uploaded (which will be read
+                     from ``stream``). If not provided, the upload will be
+                     concluded once ``stream`` is exhausted (or :data:`None`).
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+
+        :rtype: :class:`~requests.Response`
+        :returns: The "200 OK" response object returned after the multipart
+                  upload request.
+        :raises: :exc:`ValueError` if ``size`` is not :data:`None` but the
+                 ``stream`` has fewer than ``size`` bytes remaining.
+        """
+        if size is None:
+            data = stream.read()
+        else:
+            data = stream.read(size)
+            if len(data) < size:
+                msg = _READ_LESS_THAN_SIZE.format(size, len(data))
+                raise ValueError(msg)
+
+        transport = self._get_transport(client)
+        info = self._get_upload_arguments(content_type)
+        headers, object_metadata, content_type = info
+
+        base_url = _MULTIPART_URL_TEMPLATE.format(bucket_path=self.bucket.path)
+        name_value_pairs = []
+
+        if self.user_project is not None:
+            name_value_pairs.append(("userProject", self.user_project))
+
+        if self.kms_key_name is not None:
+            name_value_pairs.append(("kmsKeyName", self.kms_key_name))
+
+        if predefined_acl is not None:
+            name_value_pairs.append(("predefinedAcl", predefined_acl))
+
+        upload_url = _add_query_parameters(base_url, name_value_pairs)
+        upload = MultipartUpload(upload_url, headers=headers)
+
+        if num_retries is not None:
+            upload._retry_strategy = resumable_media.RetryStrategy(
+                max_retries=num_retries
+            )
+
+        response = upload.transmit(transport, data, object_metadata, content_type)
+
+        return response
+
+    def _initiate_resumable_upload(
+        self,
+        client,
+        stream,
+        content_type,
+        size,
+        num_retries,
+        predefined_acl=None,
+        extra_headers=None,
+        chunk_size=None,
+    ):
+        """Initiate a resumable upload.
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type content_type: str
+        :param content_type: Type of content being uploaded (or :data:`None`).
+
+        :type size: int
+        :param size: The number of bytes to be uploaded (which will be read
+                     from ``stream``). If not provided, the upload will be
+                     concluded once ``stream`` is exhausted (or :data:`None`).
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :type extra_headers: dict
+        :param extra_headers: (Optional) Extra headers to add to standard
+                              headers.
+
+        :type chunk_size: int
+        :param chunk_size:
+            (Optional) Chunk size to use when creating a
+            :class:`~google.resumable_media.requests.ResumableUpload`.
+            If not passed, will fall back to the chunk size on the
+            current blob.
+
+        :rtype: tuple
+        :returns:
+            Pair of
+
+            * The :class:`~google.resumable_media.requests.ResumableUpload`
+              that was created
+            * The ``transport`` used to initiate the upload.
+        """
+        if chunk_size is None:
+            chunk_size = self.chunk_size
+            if chunk_size is None:
+                chunk_size = _DEFAULT_CHUNKSIZE
+
+        transport = self._get_transport(client)
+        info = self._get_upload_arguments(content_type)
+        headers, object_metadata, content_type = info
+        if extra_headers is not None:
+            headers.update(extra_headers)
+
+        base_url = _RESUMABLE_URL_TEMPLATE.format(bucket_path=self.bucket.path)
+        name_value_pairs = []
+
+        if self.user_project is not None:
+            name_value_pairs.append(("userProject", self.user_project))
+
+        if self.kms_key_name is not None:
+            name_value_pairs.append(("kmsKeyName", self.kms_key_name))
+
+        if predefined_acl is not None:
+            name_value_pairs.append(("predefinedAcl", predefined_acl))
+
+        upload_url = _add_query_parameters(base_url, name_value_pairs)
+        upload = ResumableUpload(upload_url, chunk_size, headers=headers)
+
+        if num_retries is not None:
+            upload._retry_strategy = resumable_media.RetryStrategy(
+                max_retries=num_retries
+            )
+
+        upload.initiate(
+            transport,
+            stream,
+            object_metadata,
+            content_type,
+            total_bytes=size,
+            stream_final=False,
+        )
+
+        return upload, transport
+
+    def _do_resumable_upload(
+        self, client, stream, content_type, size, num_retries, predefined_acl
+    ):
+        """Perform a resumable upload.
+
+        Assumes ``chunk_size`` is not :data:`None` on the current blob.
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type content_type: str
+        :param content_type: Type of content being uploaded (or :data:`None`).
+
+        :type size: int
+        :param size: The number of bytes to be uploaded (which will be read
+                     from ``stream``). If not provided, the upload will be
+                     concluded once ``stream`` is exhausted (or :data:`None`).
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+
+        :rtype: :class:`~requests.Response`
+        :returns: The "200 OK" response object returned after the final chunk
+                  is uploaded.
+        """
+        upload, transport = self._initiate_resumable_upload(
+            client,
+            stream,
+            content_type,
+            size,
+            num_retries,
+            predefined_acl=predefined_acl,
+        )
+
+        while not upload.finished:
+            response = upload.transmit_next_chunk(transport)
+
+        return response
+
+    def _do_upload(
+        self, client, stream, content_type, size, num_retries, predefined_acl
+    ):
+        """Determine an upload strategy and then perform the upload.
+
+        If the size of the data to be uploaded exceeds 5 MB a resumable media
+        request will be used, otherwise the content and the metadata will be
+        uploaded in a single multipart upload request.
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type stream: IO[bytes]
+        :param stream: A bytes IO object open for reading.
+
+        :type content_type: str
+        :param content_type: Type of content being uploaded (or :data:`None`).
+
+        :type size: int
+        :param size: The number of bytes to be uploaded (which will be read
+                     from ``stream``). If not provided, the upload will be
+                     concluded once ``stream`` is exhausted (or :data:`None`).
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+
+        :rtype: dict
+        :returns: The parsed JSON from the "200 OK" response. This will be the
+                  **only** response in the multipart case and it will be the
+                  **final** response in the resumable case.
+        """
+        if size is not None and size <= _MAX_MULTIPART_SIZE:
+            response = self._do_multipart_upload(
+                client, stream, content_type, size, num_retries, predefined_acl
+            )
+        else:
+            response = self._do_resumable_upload(
+                client, stream, content_type, size, num_retries, predefined_acl
+            )
+
+        return response.json()
+
+    def upload_from_file(
+        self,
+        file_obj,
+        rewind=False,
+        size=None,
+        content_type=None,
+        num_retries=None,
+        client=None,
+        predefined_acl=None,
+    ):
+        """Upload the contents of this blob from a file-like object.
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        .. note::
+           The effect of uploading to an existing blob depends on the
+           "versioning" and "lifecycle" policies defined on the blob's
+           bucket.  In the absence of those policies, upload will
+           overwrite any existing contents.
+
+           See the `object versioning`_ and `lifecycle`_ API documents
+           for details.
+
+        Uploading a file with a `customer-supplied`_ encryption key:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START upload_from_file]
+            :end-before: [END upload_from_file]
+            :dedent: 4
+
+        The ``encryption_key`` should be a str or bytes with a length of at
+        least 32.
+
+        For more fine-grained over the upload process, check out
+        `google-resumable-media`_.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type file_obj: file
+        :param file_obj: A file handle open for reading.
+
+        :type rewind: bool
+        :param rewind: If True, seek to the beginning of the file handle before
+                       writing the file to Cloud Storage.
+
+        :type size: int
+        :param size: The number of bytes to be uploaded (which will be read
+                     from ``file_obj``). If not provided, the upload will be
+                     concluded once ``file_obj`` is exhausted.
+
+        :type content_type: str
+        :param content_type: Optional type of content being uploaded.
+
+        :type num_retries: int
+        :param num_retries: Number of upload retries. (Deprecated: This
+                            argument will be removed in a future release.)
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+
+        :raises: :class:`~google.cloud.exceptions.GoogleCloudError`
+                 if the upload response returns an error status.
+
+        .. _object versioning: https://cloud.google.com/storage/\
+                               docs/object-versioning
+        .. _lifecycle: https://cloud.google.com/storage/docs/lifecycle
+        """
+        if num_retries is not None:
+            warnings.warn(_NUM_RETRIES_MESSAGE, DeprecationWarning, stacklevel=2)
+
+        _maybe_rewind(file_obj, rewind=rewind)
+        predefined_acl = ACL.validate_predefined(predefined_acl)
+
+        try:
+            created_json = self._do_upload(
+                client, file_obj, content_type, size, num_retries, predefined_acl
+            )
+            self._set_properties(created_json)
+        except resumable_media.InvalidResponse as exc:
+            _raise_from_invalid_response(exc)
+
+    def upload_from_filename(
+        self, filename, content_type=None, client=None, predefined_acl=None
+    ):
+        """Upload this blob's contents from the content of a named file.
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The value given by ``mimetypes.guess_type``
+        - The default value ('application/octet-stream')
+
+        .. note::
+           The effect of uploading to an existing blob depends on the
+           "versioning" and "lifecycle" policies defined on the blob's
+           bucket.  In the absence of those policies, upload will
+           overwrite any existing contents.
+
+           See the `object versioning
+           <https://cloud.google.com/storage/docs/object-versioning>`_ and
+           `lifecycle <https://cloud.google.com/storage/docs/lifecycle>`_
+           API documents for details.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type filename: str
+        :param filename: The path to the file.
+
+        :type content_type: str
+        :param content_type: Optional type of content being uploaded.
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+        """
+        content_type = self._get_content_type(content_type, filename=filename)
+
+        with open(filename, "rb") as file_obj:
+            total_bytes = os.fstat(file_obj.fileno()).st_size
+            self.upload_from_file(
+                file_obj,
+                content_type=content_type,
+                client=client,
+                size=total_bytes,
+                predefined_acl=predefined_acl,
+            )
+
+    def upload_from_string(
+        self, data, content_type="text/plain", client=None, predefined_acl=None
+    ):
+        """Upload contents of this blob from the provided string.
+
+        .. note::
+           The effect of uploading to an existing blob depends on the
+           "versioning" and "lifecycle" policies defined on the blob's
+           bucket.  In the absence of those policies, upload will
+           overwrite any existing contents.
+
+           See the `object versioning
+           <https://cloud.google.com/storage/docs/object-versioning>`_ and
+           `lifecycle <https://cloud.google.com/storage/docs/lifecycle>`_
+           API documents for details.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type data: bytes or str
+        :param data: The data to store in this blob.  If the value is
+                     text, it will be encoded as UTF-8.
+
+        :type content_type: str
+        :param content_type: Optional type of content being uploaded. Defaults
+                             to ``'text/plain'``.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :type predefined_acl: str
+        :param predefined_acl: (Optional) predefined access control list
+        """
+        data = _to_bytes(data, encoding="utf-8")
+        string_buffer = BytesIO(data)
+        self.upload_from_file(
+            file_obj=string_buffer,
+            size=len(data),
+            content_type=content_type,
+            client=client,
+            predefined_acl=predefined_acl,
+        )
+
+    def create_resumable_upload_session(
+        self, content_type=None, size=None, origin=None, client=None
+    ):
+        """Create a resumable upload session.
+
+        Resumable upload sessions allow you to start an upload session from
+        one client and complete the session in another. This method is called
+        by the initiator to set the metadata and limits. The initiator then
+        passes the session URL to the client that will upload the binary data.
+        The client performs a PUT request on the session URL to complete the
+        upload. This process allows untrusted clients to upload to an
+        access-controlled bucket. For more details, see the
+        `documentation on signed URLs`_.
+
+        .. _documentation on signed URLs:
+            https://cloud.google.com/storage/\
+            docs/access-control/signed-urls#signing-resumable
+
+        The content type of the upload will be determined in order
+        of precedence:
+
+        - The value passed in to this method (if not :data:`None`)
+        - The value stored on the current blob
+        - The default value ('application/octet-stream')
+
+        .. note::
+           The effect of uploading to an existing blob depends on the
+           "versioning" and "lifecycle" policies defined on the blob's
+           bucket.  In the absence of those policies, upload will
+           overwrite any existing contents.
+
+           See the `object versioning
+           <https://cloud.google.com/storage/docs/object-versioning>`_ and
+           `lifecycle <https://cloud.google.com/storage/docs/lifecycle>`_
+           API documents for details.
+
+        If :attr:`encryption_key` is set, the blob will be encrypted with
+        a `customer-supplied`_ encryption key.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type size: int
+        :param size: (Optional). The maximum number of bytes that can be
+                     uploaded using this session. If the size is not known
+                     when creating the session, this should be left blank.
+
+        :type content_type: str
+        :param content_type: (Optional) Type of content being uploaded.
+
+        :type origin: str
+        :param origin: (Optional) If set, the upload can only be completed
+                       by a user-agent that uploads from the given origin. This
+                       can be useful when passing the session to a web client.
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :rtype: str
+        :returns: The resumable upload session URL. The upload can be
+                  completed by making an HTTP PUT request with the
+                  file's contents.
+
+        :raises: :class:`google.cloud.exceptions.GoogleCloudError`
+                 if the session creation response returns an error status.
+        """
+        extra_headers = {}
+        if origin is not None:
+            # This header is specifically for client-side uploads, it
+            # determines the origins allowed for CORS.
+            extra_headers["Origin"] = origin
+
+        try:
+            dummy_stream = BytesIO(b"")
+            # Send a fake the chunk size which we **know** will be acceptable
+            # to the `ResumableUpload` constructor. The chunk size only
+            # matters when **sending** bytes to an upload.
+            upload, _ = self._initiate_resumable_upload(
+                client,
+                dummy_stream,
+                content_type,
+                size,
+                None,
+                predefined_acl=None,
+                extra_headers=extra_headers,
+                chunk_size=self._CHUNK_SIZE_MULTIPLE,
+            )
+
+            return upload.resumable_url
+        except resumable_media.InvalidResponse as exc:
+            _raise_from_invalid_response(exc)
+
+    def get_iam_policy(self, client=None):
+        """Retrieve the IAM policy for the object.
+
+        .. note:
+
+           Blob- / object-level IAM support does not yet exist and methods
+           currently call an internal ACL backend not providing any utility
+           beyond the blob's :attr:`acl` at this time. The API may be enhanced
+           in the future and is currently undocumented. Use :attr:`acl` for
+           managing object access control.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current object's bucket.
+
+        :rtype: :class:`google.api_core.iam.Policy`
+        :returns: the policy instance, based on the resource returned from
+                  the ``getIamPolicy`` API request.
+        """
+        client = self._require_client(client)
+
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        info = client._connection.api_request(
+            method="GET",
+            path="%s/iam" % (self.path,),
+            query_params=query_params,
+            _target_object=None,
+        )
+        return Policy.from_api_repr(info)
+
+    def set_iam_policy(self, policy, client=None):
+        """Update the IAM policy for the bucket.
+
+        .. note:
+
+           Blob- / object-level IAM support does not yet exist and methods
+           currently call an internal ACL backend not providing any utility
+           beyond the blob's :attr:`acl` at this time. The API may be enhanced
+           in the future and is currently undocumented. Use :attr:`acl` for
+           managing object access control.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type policy: :class:`google.api_core.iam.Policy`
+        :param policy: policy instance used to update bucket's IAM policy.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: :class:`google.api_core.iam.Policy`
+        :returns: the policy instance, based on the resource returned from
+                  the ``setIamPolicy`` API request.
+        """
+        client = self._require_client(client)
+
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        resource = policy.to_api_repr()
+        resource["resourceId"] = self.path
+        info = client._connection.api_request(
+            method="PUT",
+            path="%s/iam" % (self.path,),
+            query_params=query_params,
+            data=resource,
+            _target_object=None,
+        )
+        return Policy.from_api_repr(info)
+
+    def test_iam_permissions(self, permissions, client=None):
+        """API call:  test permissions
+
+        .. note:
+
+           Blob- / object-level IAM support does not yet exist and methods
+           currently call an internal ACL backend not providing any utility
+           beyond the blob's :attr:`acl` at this time. The API may be enhanced
+           in the future and is currently undocumented. Use :attr:`acl` for
+           managing object access control.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type permissions: list of string
+        :param permissions: the permissions to check
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: list of string
+        :returns: the permissions returned by the ``testIamPermissions`` API
+                  request.
+        """
+        client = self._require_client(client)
+        query_params = {"permissions": permissions}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        path = "%s/iam/testPermissions" % (self.path,)
+        resp = client._connection.api_request(
+            method="GET", path=path, query_params=query_params
+        )
+
+        return resp.get("permissions", [])
+
+    def make_public(self, client=None):
+        """Update blob's ACL, granting read access to anonymous users.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+        """
+        self.acl.all().grant_read()
+        self.acl.save(client=client)
+
+    def make_private(self, client=None):
+        """Update blob's ACL, revoking read access for anonymous users.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+        """
+        self.acl.all().revoke_read()
+        self.acl.save(client=client)
+
+    def compose(self, sources, client=None):
+        """Concatenate source blobs into this one.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type sources: list of :class:`Blob`
+        :param sources: blobs whose contents will be composed into this blob.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+        """
+        client = self._require_client(client)
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        request = {
+            "sourceObjects": [{"name": source.name} for source in sources],
+            "destination": self._properties.copy(),
+        }
+        api_response = client._connection.api_request(
+            method="POST",
+            path=self.path + "/compose",
+            query_params=query_params,
+            data=request,
+            _target_object=self,
+        )
+        self._set_properties(api_response)
+
+    def rewrite(self, source, token=None, client=None):
+        """Rewrite source blob into this one.
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type source: :class:`Blob`
+        :param source: blob whose contents will be rewritten into this blob.
+
+        :type token: str
+        :param token: Optional. Token returned from an earlier, not-completed
+                       call to rewrite the same source blob.  If passed,
+                       result will include updated status, total bytes written.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+        :rtype: tuple
+        :returns: ``(token, bytes_rewritten, total_bytes)``, where ``token``
+                  is a rewrite token (``None`` if the rewrite is complete),
+                  ``bytes_rewritten`` is the number of bytes rewritten so far,
+                  and ``total_bytes`` is the total number of bytes to be
+                  rewritten.
+        """
+        client = self._require_client(client)
+        headers = _get_encryption_headers(self._encryption_key)
+        headers.update(_get_encryption_headers(source._encryption_key, source=True))
+
+        query_params = self._query_params
+        if "generation" in query_params:
+            del query_params["generation"]
+
+        if token:
+            query_params["rewriteToken"] = token
+
+        if source.generation:
+            query_params["sourceGeneration"] = source.generation
+
+        if self.kms_key_name is not None:
+            query_params["destinationKmsKeyName"] = self.kms_key_name
+
+        api_response = client._connection.api_request(
+            method="POST",
+            path=source.path + "/rewriteTo" + self.path,
+            query_params=query_params,
+            data=self._properties,
+            headers=headers,
+            _target_object=self,
+        )
+        rewritten = int(api_response["totalBytesRewritten"])
+        size = int(api_response["objectSize"])
+
+        # The resource key is set if and only if the API response is
+        # completely done. Additionally, there is no rewrite token to return
+        # in this case.
+        if api_response["done"]:
+            self._set_properties(api_response["resource"])
+            return None, rewritten, size
+
+        return api_response["rewriteToken"], rewritten, size
+
+    def update_storage_class(self, new_class, client=None):
+        """Update blob's storage class via a rewrite-in-place. This helper will
+        wait for the rewrite to complete before returning, so it may take some
+        time for large files.
+
+        See
+        https://cloud.google.com/storage/docs/per-object-storage-class
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type new_class: str
+        :param new_class: new storage class for the object
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+        """
+        if new_class not in self._STORAGE_CLASSES:
+            raise ValueError("Invalid storage class: %s" % (new_class,))
+
+        # Update current blob's storage class prior to rewrite
+        self._patch_property("storageClass", new_class)
+
+        # Execute consecutive rewrite operations until operation is done
+        token, _, _ = self.rewrite(self)
+        while token is not None:
+            token, _, _ = self.rewrite(self, token=token)
+
+    cache_control = _scalar_property("cacheControl")
+    """HTTP 'Cache-Control' header for this object.
+
+    See `RFC 7234`_ and `API reference docs`_.
+
+    :rtype: str or ``NoneType``
+
+    .. _RFC 7234: https://tools.ietf.org/html/rfc7234#section-5.2
+    """
+
+    content_disposition = _scalar_property("contentDisposition")
+    """HTTP 'Content-Disposition' header for this object.
+
+    See `RFC 6266`_ and `API reference docs`_.
+
+    :rtype: str or ``NoneType``
+
+    .. _RFC 6266: https://tools.ietf.org/html/rfc7234#section-5.2
+    """
+
+    content_encoding = _scalar_property("contentEncoding")
+    """HTTP 'Content-Encoding' header for this object.
+
+    See `RFC 7231`_ and `API reference docs`_.
+
+    :rtype: str or ``NoneType``
+
+    .. _RFC 7231: https://tools.ietf.org/html/rfc7231#section-3.1.2.2
+    """
+
+    content_language = _scalar_property("contentLanguage")
+    """HTTP 'Content-Language' header for this object.
+
+    See `BCP47`_ and `API reference docs`_.
+
+    :rtype: str or ``NoneType``
+
+    .. _BCP47: https://tools.ietf.org/html/bcp47
+    """
+
+    content_type = _scalar_property(_CONTENT_TYPE_FIELD)
+    """HTTP 'Content-Type' header for this object.
+
+    See `RFC 2616`_ and `API reference docs`_.
+
+    :rtype: str or ``NoneType``
+
+    .. _RFC 2616: https://tools.ietf.org/html/rfc2616#section-14.17
+    """
+
+    crc32c = _scalar_property("crc32c")
+    """CRC32C checksum for this object.
+
+    See `RFC 4960`_ and `API reference docs`_.
+
+    If not set before upload, the server will compute the hash.
+
+    :rtype: str or ``NoneType``
+
+    .. _RFC 4960: https://tools.ietf.org/html/rfc4960#appendix-B
+    """
+
+    @property
+    def component_count(self):
+        """Number of underlying components that make up this object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: int or ``NoneType``
+        :returns: The component count (in case of a composed object) or
+                  ``None`` if the blob's resource has not been loaded from
+                  the server.  This property will not be set on objects
+                  not created via ``compose``.
+        """
+        component_count = self._properties.get("componentCount")
+        if component_count is not None:
+            return int(component_count)
+
+    @property
+    def etag(self):
+        """Retrieve the ETag for the object.
+
+        See `RFC 2616 (etags)`_ and `API reference docs`_.
+
+        :rtype: str or ``NoneType``
+        :returns: The blob etag or ``None`` if the blob's resource has not
+                  been loaded from the server.
+
+        .. _RFC 2616 (etags): https://tools.ietf.org/html/rfc2616#section-3.11
+        """
+        return self._properties.get("etag")
+
+    event_based_hold = _scalar_property("eventBasedHold")
+    """Is an event-based hold active on the object?
+
+    See `API reference docs`_.
+
+    If the property is not set locally, returns :data:`None`.
+
+    :rtype: bool or ``NoneType``
+    """
+
+    @property
+    def generation(self):
+        """Retrieve the generation for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: int or ``NoneType``
+        :returns: The generation of the blob or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        generation = self._properties.get("generation")
+        if generation is not None:
+            return int(generation)
+
+    @property
+    def id(self):
+        """Retrieve the ID for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        The ID consists of the bucket name, object name, and generation number.
+
+        :rtype: str or ``NoneType``
+        :returns: The ID of the blob or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        return self._properties.get("id")
+
+    md5_hash = _scalar_property("md5Hash")
+    """MD5 hash for this object.
+
+    See `RFC 1321`_ and `API reference docs`_.
+
+    If not set before upload, the server will compute the hash.
+
+    :rtype: str or ``NoneType``
+
+    .. _RFC 1321: https://tools.ietf.org/html/rfc1321
+    """
+
+    @property
+    def media_link(self):
+        """Retrieve the media download URI for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: str or ``NoneType``
+        :returns: The media link for the blob or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        return self._properties.get("mediaLink")
+
+    @property
+    def metadata(self):
+        """Retrieve arbitrary/application specific metadata for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :setter: Update arbitrary/application specific metadata for the
+                 object.
+        :getter: Retrieve arbitrary/application specific metadata for
+                 the object.
+
+        :rtype: dict or ``NoneType``
+        :returns: The metadata associated with the blob or ``None`` if the
+                  property is not set.
+        """
+        return copy.deepcopy(self._properties.get("metadata"))
+
+    @metadata.setter
+    def metadata(self, value):
+        """Update arbitrary/application specific metadata for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :type value: dict
+        :param value: (Optional) The blob metadata to set.
+        """
+        self._patch_property("metadata", value)
+
+    @property
+    def metageneration(self):
+        """Retrieve the metageneration for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: int or ``NoneType``
+        :returns: The metageneration of the blob or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        metageneration = self._properties.get("metageneration")
+        if metageneration is not None:
+            return int(metageneration)
+
+    @property
+    def owner(self):
+        """Retrieve info about the owner of the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: dict or ``NoneType``
+        :returns: Mapping of owner's role/ID, or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        return copy.deepcopy(self._properties.get("owner"))
+
+    @property
+    def retention_expiration_time(self):
+        """Retrieve timestamp at which the object's retention period expires.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the property is not set locally.
+        """
+        value = self._properties.get("retentionExpirationTime")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+    @property
+    def self_link(self):
+        """Retrieve the URI for the object.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: str or ``NoneType``
+        :returns: The self link for the blob or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        return self._properties.get("selfLink")
+
+    @property
+    def size(self):
+        """Size of the object, in bytes.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: int or ``NoneType``
+        :returns: The size of the blob or ``None`` if the blob's
+                  resource has not been loaded from the server.
+        """
+        size = self._properties.get("size")
+        if size is not None:
+            return int(size)
+
+    @property
+    def kms_key_name(self):
+        """Resource name of Cloud KMS key used to encrypt the blob's contents.
+
+        :rtype: str or ``NoneType``
+        :returns:
+            The resource name or ``None`` if no Cloud KMS key was used,
+            or the blob's resource has not been loaded from the server.
+        """
+        return self._properties.get("kmsKeyName")
+
+    storage_class = _scalar_property("storageClass")
+    """Retrieve the storage class for the object.
+
+    This can only be set at blob / object **creation** time. If you'd
+    like to change the storage class **after** the blob / object already
+    exists in a bucket, call :meth:`update_storage_class` (which uses
+    :meth:`rewrite`).
+
+    See https://cloud.google.com/storage/docs/storage-classes
+
+    :rtype: str or ``NoneType``
+    :returns: If set, one of "MULTI_REGIONAL", "REGIONAL",
+              "NEARLINE", "COLDLINE", "STANDARD", or
+              "DURABLE_REDUCED_AVAILABILITY", else ``None``.
+    """
+
+    temporary_hold = _scalar_property("temporaryHold")
+    """Is a temporary hold active on the object?
+
+    See `API reference docs`_.
+
+    If the property is not set locally, returns :data:`None`.
+
+    :rtype: bool or ``NoneType``
+    """
+
+    @property
+    def time_deleted(self):
+        """Retrieve the timestamp at which the object was deleted.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the blob's resource has not been loaded from
+                  the server (see :meth:`reload`). If the blob has
+                  not been deleted, this will never be set.
+        """
+        value = self._properties.get("timeDeleted")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+    @property
+    def time_created(self):
+        """Retrieve the timestamp at which the object was created.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the blob's resource has not been loaded from
+                  the server (see :meth:`reload`).
+        """
+        value = self._properties.get("timeCreated")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+    @property
+    def updated(self):
+        """Retrieve the timestamp at which the object was updated.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/objects
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the blob's resource has not been loaded from
+                  the server (see :meth:`reload`).
+        """
+        value = self._properties.get("updated")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+
+def _get_encryption_headers(key, source=False):
+    """Builds customer encryption key headers
+
+    :type key: bytes
+    :param key: 32 byte key to build request key and hash.
+
+    :type source: bool
+    :param source: If true, return headers for the "source" blob; otherwise,
+                   return headers for the "destination" blob.
+
+    :rtype: dict
+    :returns: dict of HTTP headers being sent in request.
+    """
+    if key is None:
+        return {}
+
+    key = _to_bytes(key)
+    key_hash = hashlib.sha256(key).digest()
+    key_hash = base64.b64encode(key_hash)
+    key = base64.b64encode(key)
+
+    if source:
+        prefix = "X-Goog-Copy-Source-Encryption-"
+    else:
+        prefix = "X-Goog-Encryption-"
+
+    return {
+        prefix + "Algorithm": "AES256",
+        prefix + "Key": _bytes_to_unicode(key),
+        prefix + "Key-Sha256": _bytes_to_unicode(key_hash),
+    }
+
+
+def _quote(value, safe=b"~"):
+    """URL-quote a string.
+
+    If the value is unicode, this method first UTF-8 encodes it as bytes and
+    then quotes the bytes. (In Python 3, ``urllib.parse.quote`` does this
+    encoding automatically, but in Python 2, non-ASCII characters cannot be
+    quoted.)
+
+    :type value: str or bytes
+    :param value: The value to be URL-quoted.
+
+    :type safe: bytes
+    :param safe: Bytes *not* to be quoted.  By default, includes only ``b'~'``.
+
+    :rtype: str
+    :returns: The encoded value (bytes in Python 2, unicode in Python 3).
+    """
+    value = _to_bytes(value, encoding="utf-8")
+    return quote(value, safe=safe)
+
+
+def _maybe_rewind(stream, rewind=False):
+    """Rewind the stream if desired.
+
+    :type stream: IO[bytes]
+    :param stream: A bytes IO object open for reading.
+
+    :type rewind: bool
+    :param rewind: Indicates if we should seek to the beginning of the stream.
+    """
+    if rewind:
+        stream.seek(0, os.SEEK_SET)
+
+
+def _raise_from_invalid_response(error):
+    """Re-wrap and raise an ``InvalidResponse`` exception.
+
+    :type error: :exc:`google.resumable_media.InvalidResponse`
+    :param error: A caught exception from the ``google-resumable-media``
+                  library.
+
+    :raises: :class:`~google.cloud.exceptions.GoogleCloudError` corresponding
+             to the failed status code
+    """
+    response = error.response
+    error_message = str(error)
+
+    message = u"{method} {url}: {error}".format(
+        method=response.request.method, url=response.request.url, error=error_message
+    )
+
+    raise exceptions.from_http_status(response.status_code, message, response=response)
+
+
+def _add_query_parameters(base_url, name_value_pairs):
+    """Add one query parameter to a base URL.
+
+    :type base_url: string
+    :param base_url: Base URL (may already contain query parameters)
+
+    :type name_value_pairs: list of (string, string) tuples.
+    :param name_value_pairs: Names and values of the query parameters to add
+
+    :rtype: string
+    :returns: URL with additional query strings appended.
+    """
+    if len(name_value_pairs) == 0:
+        return base_url
+
+    scheme, netloc, path, query, frag = urlsplit(base_url)
+    query = parse_qsl(query)
+    query.extend(name_value_pairs)
+    return urlunsplit((scheme, netloc, path, urlencode(query), frag))
diff --git a/storage/google/cloud/storage/bucket.py b/storage/google/cloud/storage/bucket.py
new file mode 100644
index 000000000000..40cadd9a0831
--- /dev/null
+++ b/storage/google/cloud/storage/bucket.py
@@ -0,0 +1,2199 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Storage buckets."""
+
+import base64
+import copy
+import datetime
+import json
+import warnings
+
+import six
+from six.moves.urllib.parse import urlsplit
+
+from google.api_core import page_iterator
+from google.api_core import datetime_helpers
+from google.cloud._helpers import _datetime_to_rfc3339
+from google.cloud._helpers import _NOW
+from google.cloud._helpers import _rfc3339_to_datetime
+from google.cloud.exceptions import NotFound
+from google.api_core.iam import Policy
+from google.cloud.storage import _signing
+from google.cloud.storage._helpers import _PropertyMixin
+from google.cloud.storage._helpers import _scalar_property
+from google.cloud.storage._helpers import _validate_name
+from google.cloud.storage._signing import generate_signed_url_v2
+from google.cloud.storage._signing import generate_signed_url_v4
+from google.cloud.storage.acl import BucketACL
+from google.cloud.storage.acl import DefaultObjectACL
+from google.cloud.storage.blob import Blob
+from google.cloud.storage.notification import BucketNotification
+from google.cloud.storage.notification import NONE_PAYLOAD_FORMAT
+
+
+_LOCATION_SETTER_MESSAGE = (
+    "Assignment to 'Bucket.location' is deprecated, as it is only "
+    "valid before the bucket is created. Instead, pass the location "
+    "to `Bucket.create`."
+)
+_API_ACCESS_ENDPOINT = "https://storage.googleapis.com"
+
+
+def _blobs_page_start(iterator, page, response):
+    """Grab prefixes after a :class:`~google.cloud.iterator.Page` started.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that is currently in use.
+
+    :type page: :class:`~google.cloud.api.core.page_iterator.Page`
+    :param page: The page that was just created.
+
+    :type response: dict
+    :param response: The JSON API response for a page of blobs.
+    """
+    page.prefixes = tuple(response.get("prefixes", ()))
+    iterator.prefixes.update(page.prefixes)
+
+
+def _item_to_blob(iterator, item):
+    """Convert a JSON blob to the native object.
+
+    .. note::
+
+        This assumes that the ``bucket`` attribute has been
+        added to the iterator after being created.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type item: dict
+    :param item: An item to be converted to a blob.
+
+    :rtype: :class:`.Blob`
+    :returns: The next blob in the page.
+    """
+    name = item.get("name")
+    blob = Blob(name, bucket=iterator.bucket)
+    blob._set_properties(item)
+    return blob
+
+
+def _item_to_notification(iterator, item):
+    """Convert a JSON blob to the native object.
+
+    .. note::
+
+        This assumes that the ``bucket`` attribute has been
+        added to the iterator after being created.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type item: dict
+    :param item: An item to be converted to a blob.
+
+    :rtype: :class:`.BucketNotification`
+    :returns: The next notification being iterated.
+    """
+    return BucketNotification.from_api_repr(item, bucket=iterator.bucket)
+
+
+class LifecycleRuleConditions(dict):
+    """Map a single lifecycle rule for a bucket.
+
+    See: https://cloud.google.com/storage/docs/lifecycle
+
+    :type age: int
+    :param age: (optional) apply rule action to items whos age, in days,
+                exceeds this value.
+
+    :type created_before: datetime.date
+    :param created_before: (optional) apply rule action to items created
+                           before this date.
+
+    :type is_live: bool
+    :param is_live: (optional) if true, apply rule action to non-versioned
+                    items, or to items with no newer versions. If false, apply
+                    rule action to versioned items with at least one newer
+                    version.
+
+    :type matches_storage_class: list(str), one or more of
+                                 :attr:`Bucket._STORAGE_CLASSES`.
+    :param matches_storage_class: (optional) apply rule action to items which
+                                  whose storage class matches this value.
+
+    :type number_of_newer_versions: int
+    :param number_of_newer_versions: (optional) apply rule action to versioned
+                                     items having N newer versions.
+
+    :raises ValueError: if no arguments are passed.
+    """
+
+    def __init__(
+        self,
+        age=None,
+        created_before=None,
+        is_live=None,
+        matches_storage_class=None,
+        number_of_newer_versions=None,
+        _factory=False,
+    ):
+        conditions = {}
+
+        if age is not None:
+            conditions["age"] = age
+
+        if created_before is not None:
+            conditions["createdBefore"] = created_before.isoformat()
+
+        if is_live is not None:
+            conditions["isLive"] = is_live
+
+        if matches_storage_class is not None:
+            conditions["matchesStorageClass"] = matches_storage_class
+
+        if number_of_newer_versions is not None:
+            conditions["numNewerVersions"] = number_of_newer_versions
+
+        if not _factory and not conditions:
+            raise ValueError("Supply at least one condition")
+
+        super(LifecycleRuleConditions, self).__init__(conditions)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory:  construct instance from resource.
+
+        :type resource: dict
+        :param resource: mapping as returned from API call.
+
+        :rtype: :class:`LifecycleRuleConditions`
+        :returns: Instance created from resource.
+        """
+        instance = cls(_factory=True)
+        instance.update(resource)
+        return instance
+
+    @property
+    def age(self):
+        """Conditon's age value."""
+        return self.get("age")
+
+    @property
+    def created_before(self):
+        """Conditon's created_before value."""
+        before = self.get("createdBefore")
+        if before is not None:
+            return datetime_helpers.from_iso8601_date(before)
+
+    @property
+    def is_live(self):
+        """Conditon's 'is_live' value."""
+        return self.get("isLive")
+
+    @property
+    def matches_storage_class(self):
+        """Conditon's 'matches_storage_class' value."""
+        return self.get("matchesStorageClass")
+
+    @property
+    def number_of_newer_versions(self):
+        """Conditon's 'number_of_newer_versions' value."""
+        return self.get("numNewerVersions")
+
+
+class LifecycleRuleDelete(dict):
+    """Map a lifecycle rule deleting matching items.
+
+    :type kw: dict
+    :params kw: arguments passed to :class:`LifecycleRuleConditions`.
+    """
+
+    def __init__(self, **kw):
+        conditions = LifecycleRuleConditions(**kw)
+        rule = {"action": {"type": "Delete"}, "condition": dict(conditions)}
+        super(LifecycleRuleDelete, self).__init__(rule)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory:  construct instance from resource.
+
+        :type resource: dict
+        :param resource: mapping as returned from API call.
+
+        :rtype: :class:`LifecycleRuleDelete`
+        :returns: Instance created from resource.
+        """
+        instance = cls(_factory=True)
+        instance.update(resource)
+        return instance
+
+
+class LifecycleRuleSetStorageClass(dict):
+    """Map a lifecycle rule upating storage class of matching items.
+
+    :type storage_class: str, one of :attr:`Bucket._STORAGE_CLASSES`.
+    :param storage_class: new storage class to assign to matching items.
+
+    :type kw: dict
+    :params kw: arguments passed to :class:`LifecycleRuleConditions`.
+    """
+
+    def __init__(self, storage_class, **kw):
+        conditions = LifecycleRuleConditions(**kw)
+        rule = {
+            "action": {"type": "SetStorageClass", "storageClass": storage_class},
+            "condition": dict(conditions),
+        }
+        super(LifecycleRuleSetStorageClass, self).__init__(rule)
+
+    @classmethod
+    def from_api_repr(cls, resource):
+        """Factory:  construct instance from resource.
+
+        :type resource: dict
+        :param resource: mapping as returned from API call.
+
+        :rtype: :class:`LifecycleRuleDelete`
+        :returns: Instance created from resource.
+        """
+        action = resource["action"]
+        instance = cls(action["storageClass"], _factory=True)
+        instance.update(resource)
+        return instance
+
+
+class IAMConfiguration(dict):
+    """Map a bucket's IAM configuration.
+
+    :type bucket: :class:`Bucket`
+    :params bucket: Bucket for which this instance is the policy.
+
+    :type bucket_policy_only_enabled: bool
+    :params bucket_policy_only_enabled: (optional) whether the IAM-only policy is enabled for the bucket.
+
+    :type bucket_policy_only_locked_time: :class:`datetime.datetime`
+    :params bucket_policy_only_locked_time: (optional) When the bucket's IAM-only policy was ehabled.  This value should normally only be set by the back-end API.
+    """
+
+    def __init__(
+        self,
+        bucket,
+        bucket_policy_only_enabled=False,
+        bucket_policy_only_locked_time=None,
+    ):
+        data = {"bucketPolicyOnly": {"enabled": bucket_policy_only_enabled}}
+        if bucket_policy_only_locked_time is not None:
+            data["bucketPolicyOnly"]["lockedTime"] = _datetime_to_rfc3339(
+                bucket_policy_only_locked_time
+            )
+        super(IAMConfiguration, self).__init__(data)
+        self._bucket = bucket
+
+    @classmethod
+    def from_api_repr(cls, resource, bucket):
+        """Factory:  construct instance from resource.
+
+        :type bucket: :class:`Bucket`
+        :params bucket: Bucket for which this instance is the policy.
+
+        :type resource: dict
+        :param resource: mapping as returned from API call.
+
+        :rtype: :class:`IAMConfiguration`
+        :returns: Instance created from resource.
+        """
+        instance = cls(bucket)
+        instance.update(resource)
+        return instance
+
+    @property
+    def bucket(self):
+        """Bucket for which this instance is the policy.
+
+        :rtype: :class:`Bucket`
+        :returns: the instance's bucket.
+        """
+        return self._bucket
+
+    @property
+    def bucket_policy_only_enabled(self):
+        """If set, access checks only use bucket-level IAM policies or above.
+
+        :rtype: bool
+        :returns: whether the bucket is configured to allow only IAM.
+        """
+        bpo = self.get("bucketPolicyOnly", {})
+        return bpo.get("enabled", False)
+
+    @bucket_policy_only_enabled.setter
+    def bucket_policy_only_enabled(self, value):
+        bpo = self.setdefault("bucketPolicyOnly", {})
+        bpo["enabled"] = bool(value)
+        self.bucket._patch_property("iamConfiguration", self)
+
+    @property
+    def bucket_policy_only_locked_time(self):
+        """Deadline for changing :attr:`bucket_policy_only_enabled` from true to false.
+
+        If the bucket's :attr:`bucket_policy_only_enabled` is true, this property
+        is time time after which that setting becomes immutable.
+
+        If the bucket's :attr:`bucket_policy_only_enabled` is false, this property
+        is ``None``.
+
+        :rtype: Union[:class:`datetime.datetime`, None]
+        :returns:  (readonly) Time after which :attr:`bucket_policy_only_enabled` will
+                   be frozen as true.
+        """
+        bpo = self.get("bucketPolicyOnly", {})
+        stamp = bpo.get("lockedTime")
+        if stamp is not None:
+            stamp = _rfc3339_to_datetime(stamp)
+        return stamp
+
+
+class Bucket(_PropertyMixin):
+    """A class representing a Bucket on Cloud Storage.
+
+    :type client: :class:`google.cloud.storage.client.Client`
+    :param client: A client which holds credentials and project configuration
+                   for the bucket (which requires a project).
+
+    :type name: str
+    :param name: The name of the bucket. Bucket names must start and end with a
+                 number or letter.
+
+    :type user_project: str
+    :param user_project: (Optional) the project ID to be billed for API
+                         requests made via this instance.
+    """
+
+    _MAX_OBJECTS_FOR_ITERATION = 256
+    """Maximum number of existing objects allowed in iteration.
+
+    This is used in Bucket.delete() and Bucket.make_public().
+    """
+
+    STANDARD_STORAGE_CLASS = "STANDARD"
+    """Storage class for objects accessed more than once per month."""
+
+    NEARLINE_STORAGE_CLASS = "NEARLINE"
+    """Storage class for objects accessed at most once per month."""
+
+    COLDLINE_STORAGE_CLASS = "COLDLINE"
+    """Storage class for objects accessed at most once per year."""
+
+    MULTI_REGIONAL_LEGACY_STORAGE_CLASS = "MULTI_REGIONAL"
+    """Legacy storage class.
+
+    Alias for :attr:`STANDARD_STORAGE_CLASS`.
+
+    Implies :attr:`MULTI_REGION_LOCATION_TYPE` for :attr:`location_type`.
+    """
+
+    REGIONAL_LEGACY_STORAGE_CLASS = "REGIONAL"
+    """Legacy storage class.
+
+    Alias for :attr:`STANDARD_STORAGE_CLASS`.
+
+    Implies :attr:`REGION_LOCATION_TYPE` for :attr:`location_type`.
+    """
+
+    DURABLE_REDUCED_AVAILABILITY_LEGACY_STORAGE_CLASS = "DURABLE_REDUCED_AVAILABILITY"
+    """Legacy storage class.
+
+    Similar to :attr:`NEARLINE_STORAGE_CLASS`.
+    """
+
+    _STORAGE_CLASSES = (
+        STANDARD_STORAGE_CLASS,
+        NEARLINE_STORAGE_CLASS,
+        COLDLINE_STORAGE_CLASS,
+        MULTI_REGIONAL_LEGACY_STORAGE_CLASS,  # legacy
+        REGIONAL_LEGACY_STORAGE_CLASS,  # legacy
+        DURABLE_REDUCED_AVAILABILITY_LEGACY_STORAGE_CLASS,  # legacy
+    )
+    """Allowed values for :attr:`storage_class`.
+
+    Default value is :attr:`STANDARD_STORAGE_CLASS`.
+
+    See
+    https://cloud.google.com/storage/docs/json_api/v1/buckets#storageClass
+    https://cloud.google.com/storage/docs/storage-classes
+    """
+
+    MULTI_REGION_LOCATION_TYPE = "multi-region"
+    """Location type: data will be replicated across regions in a multi-region.
+
+    Provides highest availability across largest area.
+    """
+
+    REGION_LOCATION_TYPE = "region"
+    """Location type: data will be stored within a single region.
+
+    Provides lowest latency within a single region.
+    """
+
+    DUAL_REGION_LOCATION_TYPE = "dual-region"
+    """Location type: data will be stored within two primary regions.
+
+    Provides high availability and low latency across two regions.
+    """
+
+    _LOCATION_TYPES = (
+        MULTI_REGION_LOCATION_TYPE,
+        REGION_LOCATION_TYPE,
+        DUAL_REGION_LOCATION_TYPE,
+    )
+    """Allowed values for :attr:`location_type`."""
+
+    def __init__(self, client, name=None, user_project=None):
+        name = _validate_name(name)
+        super(Bucket, self).__init__(name=name)
+        self._client = client
+        self._acl = BucketACL(self)
+        self._default_object_acl = DefaultObjectACL(self)
+        self._label_removals = set()
+        self._user_project = user_project
+
+    def __repr__(self):
+        return "<Bucket: %s>" % (self.name,)
+
+    @property
+    def client(self):
+        """The client bound to this bucket."""
+        return self._client
+
+    def _set_properties(self, value):
+        """Set the properties for the current object.
+
+        :type value: dict or :class:`google.cloud.storage.batch._FutureDict`
+        :param value: The properties to be set.
+        """
+        self._label_removals.clear()
+        return super(Bucket, self)._set_properties(value)
+
+    @property
+    def user_project(self):
+        """Project ID to be billed for API requests made via this bucket.
+
+        If unset, API requests are billed to the bucket owner.
+
+        :rtype: str
+        """
+        return self._user_project
+
+    @classmethod
+    def from_string(cls, uri, client=None):
+        """Get a constructor for bucket object by URI.
+
+        :type uri: str
+        :param uri: The bucket uri pass to get bucket object.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.
+
+        :rtype: :class:`google.cloud.storage.bucket.Bucket`
+        :returns: The bucket object created.
+
+        Example:
+            Get a constructor for bucket object by URI..
+
+            >>> from google.cloud import storage
+            >>> from google.cloud.storage.bucket import Bucket
+            >>> client = storage.Client()
+            >>> bucket = Bucket.from_string("gs://bucket",client)
+        """
+        scheme, netloc, path, query, frag = urlsplit(uri)
+
+        if scheme != "gs":
+            raise ValueError("URI scheme must be gs")
+
+        return cls(client, name=netloc)
+
+    def blob(
+        self,
+        blob_name,
+        chunk_size=None,
+        encryption_key=None,
+        kms_key_name=None,
+        generation=None,
+    ):
+        """Factory constructor for blob object.
+
+        .. note::
+          This will not make an HTTP request; it simply instantiates
+          a blob object owned by this bucket.
+
+        :type blob_name: str
+        :param blob_name: The name of the blob to be instantiated.
+
+        :type chunk_size: int
+        :param chunk_size: The size of a chunk of data whenever iterating
+                           (in bytes). This must be a multiple of 256 KB per
+                           the API specification.
+
+        :type encryption_key: bytes
+        :param encryption_key:
+            Optional 32 byte encryption key for customer-supplied encryption.
+
+        :type kms_key_name: str
+        :param kms_key_name:
+            Optional resource name of KMS key used to encrypt blob's content.
+
+        :type generation: long
+        :param generation: Optional. If present, selects a specific revision of
+                           this object.
+
+        :rtype: :class:`google.cloud.storage.blob.Blob`
+        :returns: The blob object created.
+        """
+        return Blob(
+            name=blob_name,
+            bucket=self,
+            chunk_size=chunk_size,
+            encryption_key=encryption_key,
+            kms_key_name=kms_key_name,
+            generation=generation,
+        )
+
+    def notification(
+        self,
+        topic_name,
+        topic_project=None,
+        custom_attributes=None,
+        event_types=None,
+        blob_name_prefix=None,
+        payload_format=NONE_PAYLOAD_FORMAT,
+    ):
+        """Factory:  create a notification resource for the bucket.
+
+        See: :class:`.BucketNotification` for parameters.
+
+        :rtype: :class:`.BucketNotification`
+        """
+        return BucketNotification(
+            self,
+            topic_name,
+            topic_project=topic_project,
+            custom_attributes=custom_attributes,
+            event_types=event_types,
+            blob_name_prefix=blob_name_prefix,
+            payload_format=payload_format,
+        )
+
+    def exists(self, client=None):
+        """Determines whether or not this bucket exists.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: bool
+        :returns: True if the bucket exists in Cloud Storage.
+        """
+        client = self._require_client(client)
+        # We only need the status code (200 or not) so we seek to
+        # minimize the returned payload.
+        query_params = {"fields": "name"}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        try:
+            # We intentionally pass `_target_object=None` since fields=name
+            # would limit the local properties.
+            client._connection.api_request(
+                method="GET",
+                path=self.path,
+                query_params=query_params,
+                _target_object=None,
+            )
+            # NOTE: This will not fail immediately in a batch. However, when
+            #       Batch.finish() is called, the resulting `NotFound` will be
+            #       raised.
+            return True
+        except NotFound:
+            return False
+
+    def create(self, client=None, project=None, location=None):
+        """Creates current bucket.
+
+        If the bucket already exists, will raise
+        :class:`google.cloud.exceptions.Conflict`.
+
+        This implements "storage.buckets.insert".
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use. If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :type project: str
+        :param project: Optional. The project under which the bucket is to
+                        be created. If not passed, uses the project set on
+                        the client.
+        :raises ValueError: if :attr:`user_project` is set.
+        :raises ValueError: if ``project`` is None and client's
+                            :attr:`project` is also None.
+
+        :type location: str
+        :param location: Optional. The location of the bucket. If not passed,
+                         the default location, US, will be used. See
+                         https://cloud.google.com/storage/docs/bucket-locations
+        """
+        if self.user_project is not None:
+            raise ValueError("Cannot create bucket with 'user_project' set.")
+
+        client = self._require_client(client)
+
+        if project is None:
+            project = client.project
+
+        if project is None:
+            raise ValueError("Client project not set:  pass an explicit project.")
+
+        query_params = {"project": project}
+        properties = {key: self._properties[key] for key in self._changes}
+        properties["name"] = self.name
+
+        if location is not None:
+            properties["location"] = location
+
+        api_response = client._connection.api_request(
+            method="POST",
+            path="/b",
+            query_params=query_params,
+            data=properties,
+            _target_object=self,
+        )
+        self._set_properties(api_response)
+
+    def patch(self, client=None):
+        """Sends all changed properties in a PATCH request.
+
+        Updates the ``_properties`` with the response from the backend.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.  If not passed, falls back to the
+                       ``client`` stored on the current object.
+        """
+        # Special case: For buckets, it is possible that labels are being
+        # removed; this requires special handling.
+        if self._label_removals:
+            self._changes.add("labels")
+            self._properties.setdefault("labels", {})
+            for removed_label in self._label_removals:
+                self._properties["labels"][removed_label] = None
+
+        # Call the superclass method.
+        return super(Bucket, self).patch(client=client)
+
+    @property
+    def acl(self):
+        """Create our ACL on demand."""
+        return self._acl
+
+    @property
+    def default_object_acl(self):
+        """Create our defaultObjectACL on demand."""
+        return self._default_object_acl
+
+    @staticmethod
+    def path_helper(bucket_name):
+        """Relative URL path for a bucket.
+
+        :type bucket_name: str
+        :param bucket_name: The bucket name in the path.
+
+        :rtype: str
+        :returns: The relative URL path for ``bucket_name``.
+        """
+        return "/b/" + bucket_name
+
+    @property
+    def path(self):
+        """The URL path to this bucket."""
+        if not self.name:
+            raise ValueError("Cannot determine path without bucket name.")
+
+        return self.path_helper(self.name)
+
+    def get_blob(
+        self, blob_name, client=None, encryption_key=None, generation=None, **kwargs
+    ):
+        """Get a blob object by name.
+
+        This will return None if the blob doesn't exist:
+
+        .. literalinclude:: snippets.py
+          :start-after: [START get_blob]
+          :end-before: [END get_blob]
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type blob_name: str
+        :param blob_name: The name of the blob to retrieve.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :type encryption_key: bytes
+        :param encryption_key:
+            Optional 32 byte encryption key for customer-supplied encryption.
+            See
+            https://cloud.google.com/storage/docs/encryption#customer-supplied.
+
+        :type generation: long
+        :param generation: Optional. If present, selects a specific revision of
+                           this object.
+
+        :param kwargs: Keyword arguments to pass to the
+                       :class:`~google.cloud.storage.blob.Blob` constructor.
+
+        :rtype: :class:`google.cloud.storage.blob.Blob` or None
+        :returns: The blob object if it exists, otherwise None.
+        """
+        blob = Blob(
+            bucket=self,
+            name=blob_name,
+            encryption_key=encryption_key,
+            generation=generation,
+            **kwargs
+        )
+        try:
+            # NOTE: This will not fail immediately in a batch. However, when
+            #       Batch.finish() is called, the resulting `NotFound` will be
+            #       raised.
+            blob.reload(client=client)
+        except NotFound:
+            return None
+        else:
+            return blob
+
+    def list_blobs(
+        self,
+        max_results=None,
+        page_token=None,
+        prefix=None,
+        delimiter=None,
+        versions=None,
+        projection="noAcl",
+        fields=None,
+        client=None,
+    ):
+        """Return an iterator used to find blobs in the bucket.
+
+        .. note::
+          Direct use of this method is deprecated. Use ``Client.list_blobs`` instead.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type max_results: int
+        :param max_results:
+            (Optional) The maximum number of blobs in each page of results
+            from this request. Non-positive values are ignored. Defaults to
+            a sensible value set by the API.
+
+        :type page_token: str
+        :param page_token:
+            (Optional) If present, return the next batch of blobs, using the
+            value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing the
+            token.
+
+        :type prefix: str
+        :param prefix: (Optional) prefix used to filter blobs.
+
+        :type delimiter: str
+        :param delimiter: (Optional) Delimiter, used with ``prefix`` to
+                          emulate hierarchy.
+
+        :type versions: bool
+        :param versions: (Optional) Whether object versions should be returned
+                         as separate blobs.
+
+        :type projection: str
+        :param projection: (Optional) If used, must be 'full' or 'noAcl'.
+                           Defaults to ``'noAcl'``. Specifies the set of
+                           properties to return.
+
+        :type fields: str
+        :param fields:
+            (Optional) Selector specifying which fields to include
+            in a partial response. Must be a list of fields. For
+            example to get a partial response with just the next
+            page token and the name and language of each blob returned:
+            ``'items(name,contentLanguage),nextPageToken'``.
+            See: https://cloud.google.com/storage/docs/json_api/v1/parameters#fields
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :returns: Iterator of all :class:`~google.cloud.storage.blob.Blob`
+                  in this bucket matching the arguments.
+        """
+        extra_params = {"projection": projection}
+
+        if prefix is not None:
+            extra_params["prefix"] = prefix
+
+        if delimiter is not None:
+            extra_params["delimiter"] = delimiter
+
+        if versions is not None:
+            extra_params["versions"] = versions
+
+        if fields is not None:
+            extra_params["fields"] = fields
+
+        if self.user_project is not None:
+            extra_params["userProject"] = self.user_project
+
+        client = self._require_client(client)
+        path = self.path + "/o"
+        iterator = page_iterator.HTTPIterator(
+            client=client,
+            api_request=client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_blob,
+            page_token=page_token,
+            max_results=max_results,
+            extra_params=extra_params,
+            page_start=_blobs_page_start,
+        )
+        iterator.bucket = self
+        iterator.prefixes = set()
+        return iterator
+
+    def list_notifications(self, client=None):
+        """List Pub / Sub notifications for this bucket.
+
+        See:
+        https://cloud.google.com/storage/docs/json_api/v1/notifications/list
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: list of :class:`.BucketNotification`
+        :returns: notification instances
+        """
+        client = self._require_client(client)
+        path = self.path + "/notificationConfigs"
+        iterator = page_iterator.HTTPIterator(
+            client=client,
+            api_request=client._connection.api_request,
+            path=path,
+            item_to_value=_item_to_notification,
+        )
+        iterator.bucket = self
+        return iterator
+
+    def delete(self, force=False, client=None):
+        """Delete this bucket.
+
+        The bucket **must** be empty in order to submit a delete request. If
+        ``force=True`` is passed, this will first attempt to delete all the
+        objects / blobs in the bucket (i.e. try to empty the bucket).
+
+        If the bucket doesn't exist, this will raise
+        :class:`google.cloud.exceptions.NotFound`.  If the bucket is not empty
+        (and ``force=False``), will raise
+        :class:`google.cloud.exceptions.Conflict`.
+
+        If ``force=True`` and the bucket contains more than 256 objects / blobs
+        this will cowardly refuse to delete the objects (or the bucket). This
+        is to prevent accidental bucket deletion and to prevent extremely long
+        runtime of this method.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type force: bool
+        :param force: If True, empties the bucket's objects then deletes it.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :raises: :class:`ValueError` if ``force`` is ``True`` and the bucket
+                 contains more than 256 objects / blobs.
+        """
+        client = self._require_client(client)
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        if force:
+            blobs = list(
+                self.list_blobs(
+                    max_results=self._MAX_OBJECTS_FOR_ITERATION + 1, client=client
+                )
+            )
+            if len(blobs) > self._MAX_OBJECTS_FOR_ITERATION:
+                message = (
+                    "Refusing to delete bucket with more than "
+                    "%d objects. If you actually want to delete "
+                    "this bucket, please delete the objects "
+                    "yourself before calling Bucket.delete()."
+                ) % (self._MAX_OBJECTS_FOR_ITERATION,)
+                raise ValueError(message)
+
+            # Ignore 404 errors on delete.
+            self.delete_blobs(blobs, on_error=lambda blob: None, client=client)
+
+        # We intentionally pass `_target_object=None` since a DELETE
+        # request has no response value (whether in a standard request or
+        # in a batch request).
+        client._connection.api_request(
+            method="DELETE",
+            path=self.path,
+            query_params=query_params,
+            _target_object=None,
+        )
+
+    def delete_blob(self, blob_name, client=None, generation=None):
+        """Deletes a blob from the current bucket.
+
+        If the blob isn't found (backend 404), raises a
+        :class:`google.cloud.exceptions.NotFound`.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+          :start-after: [START delete_blob]
+          :end-before: [END delete_blob]
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type blob_name: str
+        :param blob_name: A blob name to delete.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :type generation: long
+        :param generation: Optional. If present, permanently deletes a specific
+                           revision of this object.
+
+        :raises: :class:`google.cloud.exceptions.NotFound` (to suppress
+                 the exception, call ``delete_blobs``, passing a no-op
+                 ``on_error`` callback, e.g.:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START delete_blobs]
+            :end-before: [END delete_blobs]
+
+        """
+        client = self._require_client(client)
+        blob = Blob(blob_name, bucket=self, generation=generation)
+
+        # We intentionally pass `_target_object=None` since a DELETE
+        # request has no response value (whether in a standard request or
+        # in a batch request).
+        client._connection.api_request(
+            method="DELETE",
+            path=blob.path,
+            query_params=blob._query_params,
+            _target_object=None,
+        )
+
+    def delete_blobs(self, blobs, on_error=None, client=None):
+        """Deletes a list of blobs from the current bucket.
+
+        Uses :meth:`delete_blob` to delete each individual blob.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type blobs: list
+        :param blobs: A list of :class:`~google.cloud.storage.blob.Blob`-s or
+                      blob names to delete.
+
+        :type on_error: callable
+        :param on_error: (Optional) Takes single argument: ``blob``. Called
+                         called once for each blob raising
+                         :class:`~google.cloud.exceptions.NotFound`;
+                         otherwise, the exception is propagated.
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :raises: :class:`~google.cloud.exceptions.NotFound` (if
+                 `on_error` is not passed).
+        """
+        for blob in blobs:
+            try:
+                blob_name = blob
+                if not isinstance(blob_name, six.string_types):
+                    blob_name = blob.name
+                self.delete_blob(blob_name, client=client)
+            except NotFound:
+                if on_error is not None:
+                    on_error(blob)
+                else:
+                    raise
+
+    def copy_blob(
+        self,
+        blob,
+        destination_bucket,
+        new_name=None,
+        client=None,
+        preserve_acl=True,
+        source_generation=None,
+    ):
+        """Copy the given blob to the given bucket, optionally with a new name.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type blob: :class:`google.cloud.storage.blob.Blob`
+        :param blob: The blob to be copied.
+
+        :type destination_bucket: :class:`google.cloud.storage.bucket.Bucket`
+        :param destination_bucket: The bucket into which the blob should be
+                                   copied.
+
+        :type new_name: str
+        :param new_name: (optional) the new name for the copied file.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :type preserve_acl: bool
+        :param preserve_acl: Optional. Copies ACL from old blob to new blob.
+                             Default: True.
+
+        :type source_generation: long
+        :param source_generation: Optional. The generation of the blob to be
+                                  copied.
+
+        :rtype: :class:`google.cloud.storage.blob.Blob`
+        :returns: The new Blob.
+        """
+        client = self._require_client(client)
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        if source_generation is not None:
+            query_params["sourceGeneration"] = source_generation
+
+        if new_name is None:
+            new_name = blob.name
+
+        new_blob = Blob(bucket=destination_bucket, name=new_name)
+        api_path = blob.path + "/copyTo" + new_blob.path
+        copy_result = client._connection.api_request(
+            method="POST",
+            path=api_path,
+            query_params=query_params,
+            _target_object=new_blob,
+        )
+
+        if not preserve_acl:
+            new_blob.acl.save(acl={}, client=client)
+
+        new_blob._set_properties(copy_result)
+        return new_blob
+
+    def rename_blob(self, blob, new_name, client=None):
+        """Rename the given blob using copy and delete operations.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        Effectively, copies blob to the same bucket with a new name, then
+        deletes the blob.
+
+        .. warning::
+
+          This method will first duplicate the data and then delete the
+          old blob.  This means that with very large objects renaming
+          could be a very (temporarily) costly or a very slow operation.
+
+        :type blob: :class:`google.cloud.storage.blob.Blob`
+        :param blob: The blob to be renamed.
+
+        :type new_name: str
+        :param new_name: The new name for this blob.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: :class:`Blob`
+        :returns: The newly-renamed blob.
+        """
+        same_name = blob.name == new_name
+
+        new_blob = self.copy_blob(blob, self, new_name, client=client)
+
+        if not same_name:
+            blob.delete(client=client)
+
+        return new_blob
+
+    @property
+    def cors(self):
+        """Retrieve or set CORS policies configured for this bucket.
+
+        See http://www.w3.org/TR/cors/ and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        .. note::
+
+           The getter for this property returns a list which contains
+           *copies* of the bucket's CORS policy mappings.  Mutating the list
+           or one of its dicts has no effect unless you then re-assign the
+           dict via the setter.  E.g.:
+
+           >>> policies = bucket.cors
+           >>> policies.append({'origin': '/foo', ...})
+           >>> policies[1]['maxAgeSeconds'] = 3600
+           >>> del policies[0]
+           >>> bucket.cors = policies
+           >>> bucket.update()
+
+        :setter: Set CORS policies for this bucket.
+        :getter: Gets the CORS policies for this bucket.
+
+        :rtype: list of dictionaries
+        :returns: A sequence of mappings describing each CORS policy.
+        """
+        return [copy.deepcopy(policy) for policy in self._properties.get("cors", ())]
+
+    @cors.setter
+    def cors(self, entries):
+        """Set CORS policies configured for this bucket.
+
+        See http://www.w3.org/TR/cors/ and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :type entries: list of dictionaries
+        :param entries: A sequence of mappings describing each CORS policy.
+        """
+        self._patch_property("cors", entries)
+
+    default_event_based_hold = _scalar_property("defaultEventBasedHold")
+    """Are uploaded objects automatically placed under an even-based hold?
+
+    If True, uploaded objects will be placed under an event-based hold to
+    be released at a future time. When released an object will then begin
+    the retention period determined by the policy retention period for the
+    object bucket.
+
+    See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+    If the property is not set locally, returns ``None``.
+
+    :rtype: bool or ``NoneType``
+    """
+
+    @property
+    def default_kms_key_name(self):
+        """Retrieve / set default KMS encryption key for objects in the bucket.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :setter: Set default KMS encryption key for items in this bucket.
+        :getter: Get default KMS encryption key for items in this bucket.
+
+        :rtype: str
+        :returns: Default KMS encryption key, or ``None`` if not set.
+        """
+        encryption_config = self._properties.get("encryption", {})
+        return encryption_config.get("defaultKmsKeyName")
+
+    @default_kms_key_name.setter
+    def default_kms_key_name(self, value):
+        """Set default KMS encryption key for objects in the bucket.
+
+        :type value: str or None
+        :param value: new KMS key name (None to clear any existing key).
+        """
+        encryption_config = self._properties.get("encryption", {})
+        encryption_config["defaultKmsKeyName"] = value
+        self._patch_property("encryption", encryption_config)
+
+    @property
+    def labels(self):
+        """Retrieve or set labels assigned to this bucket.
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets#labels
+
+        .. note::
+
+           The getter for this property returns a dict which is a *copy*
+           of the bucket's labels.  Mutating that dict has no effect unless
+           you then re-assign the dict via the setter.  E.g.:
+
+           >>> labels = bucket.labels
+           >>> labels['new_key'] = 'some-label'
+           >>> del labels['old_key']
+           >>> bucket.labels = labels
+           >>> bucket.update()
+
+        :setter: Set labels for this bucket.
+        :getter: Gets the labels for this bucket.
+
+        :rtype: :class:`dict`
+        :returns: Name-value pairs (string->string) labelling the bucket.
+        """
+        labels = self._properties.get("labels")
+        if labels is None:
+            return {}
+        return copy.deepcopy(labels)
+
+    @labels.setter
+    def labels(self, mapping):
+        """Set labels assigned to this bucket.
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets#labels
+
+        :type mapping: :class:`dict`
+        :param mapping: Name-value pairs (string->string) labelling the bucket.
+        """
+        # If any labels have been expressly removed, we need to track this
+        # so that a future .patch() call can do the correct thing.
+        existing = set([k for k in self.labels.keys()])
+        incoming = set([k for k in mapping.keys()])
+        self._label_removals = self._label_removals.union(existing.difference(incoming))
+
+        # Actually update the labels on the object.
+        self._patch_property("labels", copy.deepcopy(mapping))
+
+    @property
+    def etag(self):
+        """Retrieve the ETag for the bucket.
+
+        See https://tools.ietf.org/html/rfc2616#section-3.11 and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: str or ``NoneType``
+        :returns: The bucket etag or ``None`` if the bucket's
+                  resource has not been loaded from the server.
+        """
+        return self._properties.get("etag")
+
+    @property
+    def id(self):
+        """Retrieve the ID for the bucket.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: str or ``NoneType``
+        :returns: The ID of the bucket or ``None`` if the bucket's
+                  resource has not been loaded from the server.
+        """
+        return self._properties.get("id")
+
+    @property
+    def iam_configuration(self):
+        """Retrieve IAM configuration for this bucket.
+
+        :rtype: :class:`IAMConfiguration`
+        :returns: an instance for managing the bucket's IAM configuration.
+        """
+        info = self._properties.get("iamConfiguration", {})
+        return IAMConfiguration.from_api_repr(info, self)
+
+    @property
+    def lifecycle_rules(self):
+        """Retrieve or set lifecycle rules configured for this bucket.
+
+        See https://cloud.google.com/storage/docs/lifecycle and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        .. note::
+
+           The getter for this property returns a list which contains
+           *copies* of the bucket's lifecycle rules mappings.  Mutating the
+           list or one of its dicts has no effect unless you then re-assign
+           the dict via the setter.  E.g.:
+
+           >>> rules = bucket.lifecycle_rules
+           >>> rules.append({'origin': '/foo', ...})
+           >>> rules[1]['rule']['action']['type'] = 'Delete'
+           >>> del rules[0]
+           >>> bucket.lifecycle_rules = rules
+           >>> bucket.update()
+
+        :setter: Set lifestyle rules for this bucket.
+        :getter: Gets the lifestyle rules for this bucket.
+
+        :rtype: generator(dict)
+        :returns: A sequence of mappings describing each lifecycle rule.
+        """
+        info = self._properties.get("lifecycle", {})
+        for rule in info.get("rule", ()):
+            action_type = rule["action"]["type"]
+            if action_type == "Delete":
+                yield LifecycleRuleDelete.from_api_repr(rule)
+            elif action_type == "SetStorageClass":
+                yield LifecycleRuleSetStorageClass.from_api_repr(rule)
+            else:
+                raise ValueError("Unknown lifecycle rule: {}".format(rule))
+
+    @lifecycle_rules.setter
+    def lifecycle_rules(self, rules):
+        """Set lifestyle rules configured for this bucket.
+
+        See https://cloud.google.com/storage/docs/lifecycle and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :type entries: list of dictionaries
+        :param entries: A sequence of mappings describing each lifecycle rule.
+        """
+        rules = [dict(rule) for rule in rules]  # Convert helpers if needed
+        self._patch_property("lifecycle", {"rule": rules})
+
+    def clear_lifecyle_rules(self):
+        """Set lifestyle rules configured for this bucket.
+
+        See https://cloud.google.com/storage/docs/lifecycle and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+        """
+        self.lifecycle_rules = []
+
+    def add_lifecycle_delete_rule(self, **kw):
+        """Add a "delete" rule to lifestyle rules configured for this bucket.
+
+        See https://cloud.google.com/storage/docs/lifecycle and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        .. literalinclude:: snippets.py
+          :start-after: [START add_lifecycle_delete_rule]
+          :end-before: [END add_lifecycle_delete_rule]
+
+        :type kw: dict
+        :params kw: arguments passed to :class:`LifecycleRuleConditions`.
+        """
+        rules = list(self.lifecycle_rules)
+        rules.append(LifecycleRuleDelete(**kw))
+        self.lifecycle_rules = rules
+
+    def add_lifecycle_set_storage_class_rule(self, storage_class, **kw):
+        """Add a "delete" rule to lifestyle rules configured for this bucket.
+
+        See https://cloud.google.com/storage/docs/lifecycle and
+             https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        .. literalinclude:: snippets.py
+          :start-after: [START add_lifecycle_set_storage_class_rule]
+          :end-before: [END add_lifecycle_set_storage_class_rule]
+
+        :type storage_class: str, one of :attr:`_STORAGE_CLASSES`.
+        :param storage_class: new storage class to assign to matching items.
+
+        :type kw: dict
+        :params kw: arguments passed to :class:`LifecycleRuleConditions`.
+        """
+        rules = list(self.lifecycle_rules)
+        rules.append(LifecycleRuleSetStorageClass(storage_class, **kw))
+        self.lifecycle_rules = rules
+
+    _location = _scalar_property("location")
+
+    @property
+    def location(self):
+        """Retrieve location configured for this bucket.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets and
+        https://cloud.google.com/storage/docs/bucket-locations
+
+        Returns ``None`` if the property has not been set before creation,
+        or if the bucket's resource has not been loaded from the server.
+        :rtype: str or ``NoneType``
+        """
+        return self._location
+
+    @location.setter
+    def location(self, value):
+        """(Deprecated) Set `Bucket.location`
+
+        This can only be set at bucket **creation** time.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets and
+        https://cloud.google.com/storage/docs/bucket-locations
+
+        .. warning::
+
+            Assignment to 'Bucket.location' is deprecated, as it is only
+            valid before the bucket is created. Instead, pass the location
+            to `Bucket.create`.
+        """
+        warnings.warn(_LOCATION_SETTER_MESSAGE, DeprecationWarning, stacklevel=2)
+        self._location = value
+
+    @property
+    def location_type(self):
+        """Retrieve or set the location type for the bucket.
+
+        See https://cloud.google.com/storage/docs/storage-classes
+
+        :setter: Set the location type for this bucket.
+        :getter: Gets the the location type for this bucket.
+
+        :rtype: str or ``NoneType``
+        :returns:
+            If set, one of :attr:`MULTI_REGION_LOCATION_TYPE`,
+            :attr:`REGION_LOCATION_TYPE`, or :attr:`DUAL_REGION_LOCATION_TYPE`,
+            else ``None``.
+        """
+        return self._properties.get("locationType")
+
+    def get_logging(self):
+        """Return info about access logging for this bucket.
+
+        See https://cloud.google.com/storage/docs/access-logs#status
+
+        :rtype: dict or None
+        :returns: a dict w/ keys, ``logBucket`` and ``logObjectPrefix``
+                  (if logging is enabled), or None (if not).
+        """
+        info = self._properties.get("logging")
+        return copy.deepcopy(info)
+
+    def enable_logging(self, bucket_name, object_prefix=""):
+        """Enable access logging for this bucket.
+
+        See https://cloud.google.com/storage/docs/access-logs
+
+        :type bucket_name: str
+        :param bucket_name: name of bucket in which to store access logs
+
+        :type object_prefix: str
+        :param object_prefix: prefix for access log filenames
+        """
+        info = {"logBucket": bucket_name, "logObjectPrefix": object_prefix}
+        self._patch_property("logging", info)
+
+    def disable_logging(self):
+        """Disable access logging for this bucket.
+
+        See https://cloud.google.com/storage/docs/access-logs#disabling
+        """
+        self._patch_property("logging", None)
+
+    @property
+    def metageneration(self):
+        """Retrieve the metageneration for the bucket.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: int or ``NoneType``
+        :returns: The metageneration of the bucket or ``None`` if the bucket's
+                  resource has not been loaded from the server.
+        """
+        metageneration = self._properties.get("metageneration")
+        if metageneration is not None:
+            return int(metageneration)
+
+    @property
+    def owner(self):
+        """Retrieve info about the owner of the bucket.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: dict or ``NoneType``
+        :returns: Mapping of owner's role/ID. Returns ``None`` if the bucket's
+                  resource has not been loaded from the server.
+        """
+        return copy.deepcopy(self._properties.get("owner"))
+
+    @property
+    def project_number(self):
+        """Retrieve the number of the project to which the bucket is assigned.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: int or ``NoneType``
+        :returns: The project number that owns the bucket or ``None`` if
+                  the bucket's resource has not been loaded from the server.
+        """
+        project_number = self._properties.get("projectNumber")
+        if project_number is not None:
+            return int(project_number)
+
+    @property
+    def retention_policy_effective_time(self):
+        """Retrieve the effective time of the bucket's retention policy.
+
+        :rtype: datetime.datetime or ``NoneType``
+        :returns: point-in time at which the bucket's retention policy is
+                  effective, or ``None`` if the property is not
+                  set locally.
+        """
+        policy = self._properties.get("retentionPolicy")
+        if policy is not None:
+            timestamp = policy.get("effectiveTime")
+            if timestamp is not None:
+                return _rfc3339_to_datetime(timestamp)
+
+    @property
+    def retention_policy_locked(self):
+        """Retrieve whthere the bucket's retention policy is locked.
+
+        :rtype: bool
+        :returns: True if the bucket's policy is locked, or else False
+                  if the policy is not locked, or the property is not
+                  set locally.
+        """
+        policy = self._properties.get("retentionPolicy")
+        if policy is not None:
+            return policy.get("isLocked")
+
+    @property
+    def retention_period(self):
+        """Retrieve or set the retention period for items in the bucket.
+
+        :rtype: int or ``NoneType``
+        :returns: number of seconds to retain items after upload or release
+                  from event-based lock, or ``None`` if the property is not
+                  set locally.
+        """
+        policy = self._properties.get("retentionPolicy")
+        if policy is not None:
+            period = policy.get("retentionPeriod")
+            if period is not None:
+                return int(period)
+
+    @retention_period.setter
+    def retention_period(self, value):
+        """Set the retention period for items in the bucket.
+
+        :type value: int
+        :param value:
+            number of seconds to retain items after upload or release from
+            event-based lock.
+
+        :raises ValueError: if the bucket's retention policy is locked.
+        """
+        policy = self._properties.setdefault("retentionPolicy", {})
+        if value is not None:
+            policy["retentionPeriod"] = str(value)
+        else:
+            policy = None
+        self._patch_property("retentionPolicy", policy)
+
+    @property
+    def self_link(self):
+        """Retrieve the URI for the bucket.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: str or ``NoneType``
+        :returns: The self link for the bucket or ``None`` if
+                  the bucket's resource has not been loaded from the server.
+        """
+        return self._properties.get("selfLink")
+
+    @property
+    def storage_class(self):
+        """Retrieve or set the storage class for the bucket.
+
+        See https://cloud.google.com/storage/docs/storage-classes
+
+        :setter: Set the storage class for this bucket.
+        :getter: Gets the the storage class for this bucket.
+
+        :rtype: str or ``NoneType``
+        :returns:
+            If set, one of :attr:`NEARLINE_STORAGE_CLASS`,
+            :attr:`COLDLINE_STORAGE_CLASS`, :attr:`STANDARD_STORAGE_CLASS`,
+            :attr:`MULTI_REGIONAL_LEGACY_STORAGE_CLASS`,
+            :attr:`REGIONAL_LEGACY_STORAGE_CLASS`,
+            or
+            :attr:`DURABLE_REDUCED_AVAILABILITY_LEGACY_STORAGE_CLASS`,
+            else ``None``.
+        """
+        return self._properties.get("storageClass")
+
+    @storage_class.setter
+    def storage_class(self, value):
+        """Set the storage class for the bucket.
+
+        See https://cloud.google.com/storage/docs/storage-classes
+
+        :type value: str
+        :param value:
+            One of :attr:`NEARLINE_STORAGE_CLASS`,
+            :attr:`COLDLINE_STORAGE_CLASS`, :attr:`STANDARD_STORAGE_CLASS`,
+            :attr:`MULTI_REGIONAL_LEGACY_STORAGE_CLASS`,
+            :attr:`REGIONAL_LEGACY_STORAGE_CLASS`,
+            or
+            :attr:`DURABLE_REDUCED_AVAILABILITY_LEGACY_STORAGE_CLASS`,
+        """
+        if value not in self._STORAGE_CLASSES:
+            raise ValueError("Invalid storage class: %s" % (value,))
+        self._patch_property("storageClass", value)
+
+    @property
+    def time_created(self):
+        """Retrieve the timestamp at which the bucket was created.
+
+        See https://cloud.google.com/storage/docs/json_api/v1/buckets
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the bucket's resource has not been loaded
+                  from the server.
+        """
+        value = self._properties.get("timeCreated")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+    @property
+    def versioning_enabled(self):
+        """Is versioning enabled for this bucket?
+
+        See  https://cloud.google.com/storage/docs/object-versioning for
+        details.
+
+        :setter: Update whether versioning is enabled for this bucket.
+        :getter: Query whether versioning is enabled for this bucket.
+
+        :rtype: bool
+        :returns: True if enabled, else False.
+        """
+        versioning = self._properties.get("versioning", {})
+        return versioning.get("enabled", False)
+
+    @versioning_enabled.setter
+    def versioning_enabled(self, value):
+        """Enable versioning for this bucket.
+
+        See  https://cloud.google.com/storage/docs/object-versioning for
+        details.
+
+        :type value: convertible to boolean
+        :param value: should versioning be enabled for the bucket?
+        """
+        self._patch_property("versioning", {"enabled": bool(value)})
+
+    @property
+    def requester_pays(self):
+        """Does the requester pay for API requests for this bucket?
+
+        See https://cloud.google.com/storage/docs/requester-pays for
+        details.
+
+        :setter: Update whether requester pays for this bucket.
+        :getter: Query whether requester pays for this bucket.
+
+        :rtype: bool
+        :returns: True if requester pays for API requests for the bucket,
+                  else False.
+        """
+        versioning = self._properties.get("billing", {})
+        return versioning.get("requesterPays", False)
+
+    @requester_pays.setter
+    def requester_pays(self, value):
+        """Update whether requester pays for API requests for this bucket.
+
+        See  https://cloud.google.com/storage/docs/<DOCS-MISSING> for
+        details.
+
+        :type value: convertible to boolean
+        :param value: should requester pay for API requests for the bucket?
+        """
+        self._patch_property("billing", {"requesterPays": bool(value)})
+
+    def configure_website(self, main_page_suffix=None, not_found_page=None):
+        """Configure website-related properties.
+
+        See https://cloud.google.com/storage/docs/hosting-static-website
+
+        .. note::
+          This (apparently) only works
+          if your bucket name is a domain name
+          (and to do that, you need to get approved somehow...).
+
+        If you want this bucket to host a website, just provide the name
+        of an index page and a page to use when a blob isn't found:
+
+        .. literalinclude:: snippets.py
+          :start-after: [START configure_website]
+          :end-before: [END configure_website]
+
+        You probably should also make the whole bucket public:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START make_public]
+            :end-before: [END make_public]
+
+        This says: "Make the bucket public, and all the stuff already in
+        the bucket, and anything else I add to the bucket.  Just make it
+        all public."
+
+        :type main_page_suffix: str
+        :param main_page_suffix: The page to use as the main page
+                                 of a directory.
+                                 Typically something like index.html.
+
+        :type not_found_page: str
+        :param not_found_page: The file to use when a page isn't found.
+        """
+        data = {"mainPageSuffix": main_page_suffix, "notFoundPage": not_found_page}
+        self._patch_property("website", data)
+
+    def disable_website(self):
+        """Disable the website configuration for this bucket.
+
+        This is really just a shortcut for setting the website-related
+        attributes to ``None``.
+        """
+        return self.configure_website(None, None)
+
+    def get_iam_policy(self, client=None):
+        """Retrieve the IAM policy for the bucket.
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets/getIamPolicy
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: :class:`google.api_core.iam.Policy`
+        :returns: the policy instance, based on the resource returned from
+                  the ``getIamPolicy`` API request.
+        """
+        client = self._require_client(client)
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        info = client._connection.api_request(
+            method="GET",
+            path="%s/iam" % (self.path,),
+            query_params=query_params,
+            _target_object=None,
+        )
+        return Policy.from_api_repr(info)
+
+    def set_iam_policy(self, policy, client=None):
+        """Update the IAM policy for the bucket.
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets/setIamPolicy
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type policy: :class:`google.api_core.iam.Policy`
+        :param policy: policy instance used to update bucket's IAM policy.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: :class:`google.api_core.iam.Policy`
+        :returns: the policy instance, based on the resource returned from
+                  the ``setIamPolicy`` API request.
+        """
+        client = self._require_client(client)
+        query_params = {}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        resource = policy.to_api_repr()
+        resource["resourceId"] = self.path
+        info = client._connection.api_request(
+            method="PUT",
+            path="%s/iam" % (self.path,),
+            query_params=query_params,
+            data=resource,
+            _target_object=None,
+        )
+        return Policy.from_api_repr(info)
+
+    def test_iam_permissions(self, permissions, client=None):
+        """API call:  test permissions
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets/testIamPermissions
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        :type permissions: list of string
+        :param permissions: the permissions to check
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: list of string
+        :returns: the permissions returned by the ``testIamPermissions`` API
+                  request.
+        """
+        client = self._require_client(client)
+        query_params = {"permissions": permissions}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        path = "%s/iam/testPermissions" % (self.path,)
+        resp = client._connection.api_request(
+            method="GET", path=path, query_params=query_params
+        )
+        return resp.get("permissions", [])
+
+    def make_public(self, recursive=False, future=False, client=None):
+        """Update bucket's ACL, granting read access to anonymous users.
+
+        :type recursive: bool
+        :param recursive: If True, this will make all blobs inside the bucket
+                          public as well.
+
+        :type future: bool
+        :param future: If True, this will make all objects created in the
+                       future public as well.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :raises ValueError:
+            If ``recursive`` is True, and the bucket contains more than 256
+            blobs.  This is to prevent extremely long runtime of this
+            method.  For such buckets, iterate over the blobs returned by
+            :meth:`list_blobs` and call
+            :meth:`~google.cloud.storage.blob.Blob.make_public`
+            for each blob.
+        """
+        self.acl.all().grant_read()
+        self.acl.save(client=client)
+
+        if future:
+            doa = self.default_object_acl
+            if not doa.loaded:
+                doa.reload(client=client)
+            doa.all().grant_read()
+            doa.save(client=client)
+
+        if recursive:
+            blobs = list(
+                self.list_blobs(
+                    projection="full",
+                    max_results=self._MAX_OBJECTS_FOR_ITERATION + 1,
+                    client=client,
+                )
+            )
+            if len(blobs) > self._MAX_OBJECTS_FOR_ITERATION:
+                message = (
+                    "Refusing to make public recursively with more than "
+                    "%d objects. If you actually want to make every object "
+                    "in this bucket public, iterate through the blobs "
+                    "returned by 'Bucket.list_blobs()' and call "
+                    "'make_public' on each one."
+                ) % (self._MAX_OBJECTS_FOR_ITERATION,)
+                raise ValueError(message)
+
+            for blob in blobs:
+                blob.acl.all().grant_read()
+                blob.acl.save(client=client)
+
+    def make_private(self, recursive=False, future=False, client=None):
+        """Update bucket's ACL, revoking read access for anonymous users.
+
+        :type recursive: bool
+        :param recursive: If True, this will make all blobs inside the bucket
+                          private as well.
+
+        :type future: bool
+        :param future: If True, this will make all objects created in the
+                       future private as well.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :raises ValueError:
+            If ``recursive`` is True, and the bucket contains more than 256
+            blobs.  This is to prevent extremely long runtime of this
+            method.  For such buckets, iterate over the blobs returned by
+            :meth:`list_blobs` and call
+            :meth:`~google.cloud.storage.blob.Blob.make_private`
+            for each blob.
+        """
+        self.acl.all().revoke_read()
+        self.acl.save(client=client)
+
+        if future:
+            doa = self.default_object_acl
+            if not doa.loaded:
+                doa.reload(client=client)
+            doa.all().revoke_read()
+            doa.save(client=client)
+
+        if recursive:
+            blobs = list(
+                self.list_blobs(
+                    projection="full",
+                    max_results=self._MAX_OBJECTS_FOR_ITERATION + 1,
+                    client=client,
+                )
+            )
+            if len(blobs) > self._MAX_OBJECTS_FOR_ITERATION:
+                message = (
+                    "Refusing to make private recursively with more than "
+                    "%d objects. If you actually want to make every object "
+                    "in this bucket private, iterate through the blobs "
+                    "returned by 'Bucket.list_blobs()' and call "
+                    "'make_private' on each one."
+                ) % (self._MAX_OBJECTS_FOR_ITERATION,)
+                raise ValueError(message)
+
+            for blob in blobs:
+                blob.acl.all().revoke_read()
+                blob.acl.save(client=client)
+
+    def generate_upload_policy(self, conditions, expiration=None, client=None):
+        """Create a signed upload policy for uploading objects.
+
+        This method generates and signs a policy document. You can use
+        `policy documents`_ to allow visitors to a website to upload files to
+        Google Cloud Storage without giving them direct write access.
+
+        For example:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START policy_document]
+            :end-before: [END policy_document]
+
+        .. _policy documents:
+            https://cloud.google.com/storage/docs/xml-api\
+            /post-object#policydocument
+
+        :type expiration: datetime
+        :param expiration: Optional expiration in UTC. If not specified, the
+                           policy will expire in 1 hour.
+
+        :type conditions: list
+        :param conditions: A list of conditions as described in the
+                          `policy documents`_ documentation.
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: dict
+        :returns: A dictionary of (form field name, form field value) of form
+                  fields that should be added to your HTML upload form in order
+                  to attach the signature.
+        """
+        client = self._require_client(client)
+        credentials = client._base_connection.credentials
+        _signing.ensure_signed_credentials(credentials)
+
+        if expiration is None:
+            expiration = _NOW() + datetime.timedelta(hours=1)
+
+        conditions = conditions + [{"bucket": self.name}]
+
+        policy_document = {
+            "expiration": _datetime_to_rfc3339(expiration),
+            "conditions": conditions,
+        }
+
+        encoded_policy_document = base64.b64encode(
+            json.dumps(policy_document).encode("utf-8")
+        )
+        signature = base64.b64encode(credentials.sign_bytes(encoded_policy_document))
+
+        fields = {
+            "bucket": self.name,
+            "GoogleAccessId": credentials.signer_email,
+            "policy": encoded_policy_document.decode("utf-8"),
+            "signature": signature.decode("utf-8"),
+        }
+
+        return fields
+
+    def lock_retention_policy(self, client=None):
+        """Lock the bucket's retention policy.
+
+        :raises ValueError:
+            if the bucket has no metageneration (i.e., new or never reloaded);
+            if the bucket has no retention policy assigned;
+            if the bucket's retention policy is already locked.
+        """
+        if "metageneration" not in self._properties:
+            raise ValueError("Bucket has no retention policy assigned: try 'reload'?")
+
+        policy = self._properties.get("retentionPolicy")
+
+        if policy is None:
+            raise ValueError("Bucket has no retention policy assigned: try 'reload'?")
+
+        if policy.get("isLocked"):
+            raise ValueError("Bucket's retention policy is already locked.")
+
+        client = self._require_client(client)
+
+        query_params = {"ifMetagenerationMatch": self.metageneration}
+
+        if self.user_project is not None:
+            query_params["userProject"] = self.user_project
+
+        path = "/b/{}/lockRetentionPolicy".format(self.name)
+        api_response = client._connection.api_request(
+            method="POST", path=path, query_params=query_params, _target_object=self
+        )
+        self._set_properties(api_response)
+
+    def generate_signed_url(
+        self,
+        expiration=None,
+        api_access_endpoint=_API_ACCESS_ENDPOINT,
+        method="GET",
+        headers=None,
+        query_parameters=None,
+        client=None,
+        credentials=None,
+        version=None,
+    ):
+        """Generates a signed URL for this bucket.
+
+        .. note::
+
+            If you are on Google Compute Engine, you can't generate a signed
+            URL using GCE service account. Follow `Issue 50`_ for updates on
+            this. If you'd like to be able to generate a signed URL from GCE,
+            you can use a standard service account from a JSON file rather
+            than a GCE service account.
+
+        .. _Issue 50: https://github.com/GoogleCloudPlatform/\
+                      google-auth-library-python/issues/50
+
+        If you have a bucket that you want to allow access to for a set
+        amount of time, you can use this method to generate a URL that
+        is only valid within a certain time period.
+
+        This is particularly useful if you don't want publicly
+        accessible buckets, but don't want to require users to explicitly
+        log in.
+
+        :type expiration: Union[Integer, datetime.datetime, datetime.timedelta]
+        :param expiration: Point in time when the signed URL should expire.
+
+        :type api_access_endpoint: str
+        :param api_access_endpoint: Optional URI base.
+
+        :type method: str
+        :param method: The HTTP verb that will be used when requesting the URL.
+
+        :type headers: dict
+        :param headers:
+            (Optional) Additional HTTP headers to be included as part of the
+            signed URLs.  See:
+            https://cloud.google.com/storage/docs/xml-api/reference-headers
+            Requests using the signed URL *must* pass the specified header
+            (name and value) with each request for the URL.
+
+        :type query_parameters: dict
+        :param query_parameters:
+            (Optional) Additional query paramtersto be included as part of the
+            signed URLs.  See:
+            https://cloud.google.com/storage/docs/xml-api/reference-headers#query
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: (Optional) The client to use.  If not passed, falls back
+                       to the ``client`` stored on the blob's bucket.
+
+
+        :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
+                           :class:`NoneType`
+        :param credentials: (Optional) The OAuth2 credentials to use to sign
+                            the URL. Defaults to the credentials stored on the
+                            client used.
+
+        :type version: str
+        :param version: (Optional) The version of signed credential to create.
+                        Must be one of 'v2' | 'v4'.
+
+        :raises: :exc:`ValueError` when version is invalid.
+        :raises: :exc:`TypeError` when expiration is not a valid type.
+        :raises: :exc:`AttributeError` if credentials is not an instance
+                of :class:`google.auth.credentials.Signing`.
+
+        :rtype: str
+        :returns: A signed URL you can use to access the resource
+                  until expiration.
+        """
+        if version is None:
+            version = "v2"
+        elif version not in ("v2", "v4"):
+            raise ValueError("'version' must be either 'v2' or 'v4'")
+
+        resource = "/{bucket_name}".format(bucket_name=self.name)
+
+        if credentials is None:
+            client = self._require_client(client)
+            credentials = client._credentials
+
+        if version == "v2":
+            helper = generate_signed_url_v2
+        else:
+            helper = generate_signed_url_v4
+
+        return helper(
+            credentials,
+            resource=resource,
+            expiration=expiration,
+            api_access_endpoint=api_access_endpoint,
+            method=method.upper(),
+            headers=headers,
+            query_parameters=query_parameters,
+        )
diff --git a/storage/google/cloud/storage/client.py b/storage/google/cloud/storage/client.py
new file mode 100644
index 000000000000..0bb69252aeee
--- /dev/null
+++ b/storage/google/cloud/storage/client.py
@@ -0,0 +1,706 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Google Cloud Storage API."""
+
+import google.api_core.client_options
+
+from google.auth.credentials import AnonymousCredentials
+
+from google.api_core import page_iterator
+from google.cloud._helpers import _LocalStack
+from google.cloud.client import ClientWithProject
+from google.cloud.exceptions import NotFound
+from google.cloud.storage._http import Connection
+from google.cloud.storage.batch import Batch
+from google.cloud.storage.bucket import Bucket
+from google.cloud.storage.blob import Blob
+from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+
+_marker = object()
+
+
+class Client(ClientWithProject):
+    """Client to bundle configuration needed for API requests.
+
+    :type project: str or None
+    :param project: the project which the client acts on behalf of. Will be
+                    passed when creating a topic.  If not passed,
+                    falls back to the default inferred from the environment.
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions` or :class:`dict`
+    :param client_options: (Optional) Client options used to set user options on the client.
+        API Endpoint should be set through client_options.
+    """
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/devstorage.full_control",
+        "https://www.googleapis.com/auth/devstorage.read_only",
+        "https://www.googleapis.com/auth/devstorage.read_write",
+    )
+    """The scopes required for authenticating as a Cloud Storage consumer."""
+
+    def __init__(
+        self,
+        project=_marker,
+        credentials=None,
+        _http=None,
+        client_info=None,
+        client_options=None,
+    ):
+        self._base_connection = None
+        if project is None:
+            no_project = True
+            project = "<none>"
+        else:
+            no_project = False
+        if project is _marker:
+            project = None
+        super(Client, self).__init__(
+            project=project, credentials=credentials, _http=_http
+        )
+
+        kw_args = {"client_info": client_info}
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+                kw_args["api_endpoint"] = api_endpoint
+
+        if no_project:
+            self.project = None
+        self._connection = Connection(self, **kw_args)
+        self._batch_stack = _LocalStack()
+
+    @classmethod
+    def create_anonymous_client(cls):
+        """Factory: return client with anonymous credentials.
+
+        .. note::
+
+           Such a client has only limited access to "public" buckets:
+           listing their contents and downloading their blobs.
+
+        :rtype: :class:`google.cloud.storage.client.Client`
+        :returns: Instance w/ anonymous credentials and no project.
+        """
+        client = cls(project="<none>", credentials=AnonymousCredentials())
+        client.project = None
+        return client
+
+    @property
+    def _connection(self):
+        """Get connection or batch on the client.
+
+        :rtype: :class:`google.cloud.storage._http.Connection`
+        :returns: The connection set on the client, or the batch
+                  if one is set.
+        """
+        if self.current_batch is not None:
+            return self.current_batch
+        else:
+            return self._base_connection
+
+    @_connection.setter
+    def _connection(self, value):
+        """Set connection on the client.
+
+        Intended to be used by constructor (since the base class calls)
+            self._connection = connection
+        Will raise if the connection is set more than once.
+
+        :type value: :class:`google.cloud.storage._http.Connection`
+        :param value: The connection set on the client.
+
+        :raises: :class:`ValueError` if connection has already been set.
+        """
+        if self._base_connection is not None:
+            raise ValueError("Connection already set on client")
+        self._base_connection = value
+
+    def _push_batch(self, batch):
+        """Push a batch onto our stack.
+
+        "Protected", intended for use by batch context mgrs.
+
+        :type batch: :class:`google.cloud.storage.batch.Batch`
+        :param batch: newly-active batch
+        """
+        self._batch_stack.push(batch)
+
+    def _pop_batch(self):
+        """Pop a batch from our stack.
+
+        "Protected", intended for use by batch context mgrs.
+
+        :raises: IndexError if the stack is empty.
+        :rtype: :class:`google.cloud.storage.batch.Batch`
+        :returns: the top-most batch/transaction, after removing it.
+        """
+        return self._batch_stack.pop()
+
+    def _bucket_arg_to_bucket(self, bucket_or_name):
+        """Helper to return given bucket or create new by name.
+
+        Args:
+            bucket_or_name (Union[ \
+                :class:`~google.cloud.storage.bucket.Bucket`, \
+                 str, \
+            ]):
+                The bucket resource to pass or name to create.
+
+        Returns:
+            google.cloud.storage.bucket.Bucket
+                The newly created bucket or the given one.
+        """
+        if isinstance(bucket_or_name, Bucket):
+            bucket = bucket_or_name
+        else:
+            bucket = Bucket(self, name=bucket_or_name)
+        return bucket
+
+    @property
+    def current_batch(self):
+        """Currently-active batch.
+
+        :rtype: :class:`google.cloud.storage.batch.Batch` or ``NoneType`` (if
+                no batch is active).
+        :returns: The batch at the top of the batch stack.
+        """
+        return self._batch_stack.top
+
+    def get_service_account_email(self, project=None):
+        """Get the email address of the project's GCS service account
+
+        :type project: str
+        :param project:
+            (Optional) Project ID to use for retreiving GCS service account
+            email address.  Defaults to the client's project.
+
+        :rtype: str
+        :returns: service account email address
+        """
+        if project is None:
+            project = self.project
+        path = "/projects/%s/serviceAccount" % (project,)
+        api_response = self._base_connection.api_request(method="GET", path=path)
+        return api_response["email_address"]
+
+    def bucket(self, bucket_name, user_project=None):
+        """Factory constructor for bucket object.
+
+        .. note::
+          This will not make an HTTP request; it simply instantiates
+          a bucket object owned by this client.
+
+        :type bucket_name: str
+        :param bucket_name: The name of the bucket to be instantiated.
+
+        :type user_project: str
+        :param user_project: (Optional) the project ID to be billed for API
+                             requests made via the bucket.
+
+        :rtype: :class:`google.cloud.storage.bucket.Bucket`
+        :returns: The bucket object created.
+        """
+        return Bucket(client=self, name=bucket_name, user_project=user_project)
+
+    def batch(self):
+        """Factory constructor for batch object.
+
+        .. note::
+          This will not make an HTTP request; it simply instantiates
+          a batch object owned by this client.
+
+        :rtype: :class:`google.cloud.storage.batch.Batch`
+        :returns: The batch object created.
+        """
+        return Batch(client=self)
+
+    def get_bucket(self, bucket_or_name):
+        """API call: retrieve a bucket via a GET request.
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets/get
+
+        Args:
+            bucket_or_name (Union[ \
+                :class:`~google.cloud.storage.bucket.Bucket`, \
+                 str, \
+            ]):
+                The bucket resource to pass or name to create.
+
+        Returns:
+            google.cloud.storage.bucket.Bucket
+                The bucket matching the name provided.
+
+        Raises:
+            google.cloud.exceptions.NotFound
+                If the bucket is not found.
+
+        Examples:
+            Retrieve a bucket using a string.
+
+            .. literalinclude:: snippets.py
+                :start-after: [START get_bucket]
+                :end-before: [END get_bucket]
+
+            Get a bucket using a resource.
+
+            >>> from google.cloud import storage
+            >>> client = storage.Client()
+
+            >>> # Set properties on a plain resource object.
+            >>> bucket = client.get_bucket("my-bucket-name")
+
+            >>> # Time passes. Another program may have modified the bucket
+            ... # in the meantime, so you want to get the latest state.
+            >>> bucket = client.get_bucket(bucket)  # API request.
+
+        """
+        bucket = self._bucket_arg_to_bucket(bucket_or_name)
+
+        bucket.reload(client=self)
+        return bucket
+
+    def lookup_bucket(self, bucket_name):
+        """Get a bucket by name, returning None if not found.
+
+        You can use this if you would rather check for a None value
+        than catching an exception:
+
+        .. literalinclude:: snippets.py
+            :start-after: [START lookup_bucket]
+            :end-before: [END lookup_bucket]
+
+        :type bucket_name: str
+        :param bucket_name: The name of the bucket to get.
+
+        :rtype: :class:`google.cloud.storage.bucket.Bucket`
+        :returns: The bucket matching the name provided or None if not found.
+        """
+        try:
+            return self.get_bucket(bucket_name)
+        except NotFound:
+            return None
+
+    def create_bucket(self, bucket_or_name, requester_pays=None, project=None):
+        """API call: create a new bucket via a POST request.
+
+        See
+        https://cloud.google.com/storage/docs/json_api/v1/buckets/insert
+
+        Args:
+            bucket_or_name (Union[ \
+                :class:`~google.cloud.storage.bucket.Bucket`, \
+                 str, \
+            ]):
+                The bucket resource to pass or name to create.
+            requester_pays (bool):
+                Optional. Whether requester pays for API requests for this
+                bucket and its blobs.
+            project (str):
+                Optional. the project under which the bucket is to be created.
+                If not passed, uses the project set on the client.
+
+        Returns:
+            google.cloud.storage.bucket.Bucket
+                The newly created bucket.
+
+        Raises:
+            google.cloud.exceptions.Conflict
+                If the bucket already exists.
+
+        Examples:
+            Create a bucket using a string.
+
+            .. literalinclude:: snippets.py
+                :start-after: [START create_bucket]
+                :end-before: [END create_bucket]
+
+            Create a bucket using a resource.
+
+            >>> from google.cloud import storage
+            >>> client = storage.Client()
+
+            >>> # Set properties on a plain resource object.
+            >>> bucket = storage.Bucket("my-bucket-name")
+            >>> bucket.location = "europe-west6"
+            >>> bucket.storage_class = "COLDLINE"
+
+            >>> # Pass that resource object to the client.
+            >>> bucket = client.create_bucket(bucket)  # API request.
+
+        """
+        bucket = self._bucket_arg_to_bucket(bucket_or_name)
+
+        if requester_pays is not None:
+            bucket.requester_pays = requester_pays
+        bucket.create(client=self, project=project)
+        return bucket
+
+    def download_blob_to_file(self, blob_or_uri, file_obj, start=None, end=None):
+        """Download the contents of a blob object or blob URI into a file-like object.
+
+        Args:
+            blob_or_uri (Union[ \
+            :class:`~google.cloud.storage.blob.Blob`, \
+             str, \
+            ]):
+                The blob resource to pass or URI to download.
+            file_obj (file):
+                A file handle to which to write the blob's data.
+            start (int):
+                Optional. The first byte in a range to be downloaded.
+            end (int):
+                Optional. The last byte in a range to be downloaded.
+
+        Examples:
+            Download a blob using using a blob resource.
+
+            >>> from google.cloud import storage
+            >>> client = storage.Client()
+
+            >>> bucket = client.get_bucket('my-bucket-name')
+            >>> blob = storage.Blob('path/to/blob', bucket)
+
+            >>> with open('file-to-download-to') as file_obj:
+            >>>     client.download_blob_to_file(blob, file_obj)  # API request.
+
+
+            Download a blob using a URI.
+
+            >>> from google.cloud import storage
+            >>> client = storage.Client()
+
+            >>> with open('file-to-download-to') as file_obj:
+            >>>     client.download_blob_to_file(
+            >>>         'gs://bucket_name/path/to/blob', file_obj)
+
+
+        """
+        try:
+            blob_or_uri.download_to_file(file_obj, client=self, start=start, end=end)
+        except AttributeError:
+            blob = Blob.from_string(blob_or_uri)
+            blob.download_to_file(file_obj, client=self, start=start, end=end)
+
+    def list_blobs(
+        self,
+        bucket_or_name,
+        max_results=None,
+        page_token=None,
+        prefix=None,
+        delimiter=None,
+        versions=None,
+        projection="noAcl",
+        fields=None,
+    ):
+        """Return an iterator used to find blobs in the bucket.
+
+        If :attr:`user_project` is set, bills the API request to that project.
+
+        Args:
+            bucket_or_name (Union[ \
+                :class:`~google.cloud.storage.bucket.Bucket`, \
+                 str, \
+            ]):
+                The bucket resource to pass or name to create.
+
+            max_results (int):
+                (Optional) The maximum number of blobs in each page of results
+                from this request. Non-positive values are ignored. Defaults to
+                a sensible value set by the API.
+
+            page_token (str):
+                (Optional) If present, return the next batch of blobs, using the
+                value, which must correspond to the ``nextPageToken`` value
+                returned in the previous response.  Deprecated: use the ``pages``
+                property of the returned iterator instead of manually passing the
+                token.
+
+            prefix (str):
+                (Optional) prefix used to filter blobs.
+
+            delimiter (str):
+                (Optional) Delimiter, used with ``prefix`` to
+                emulate hierarchy.
+
+            versions (bool):
+                (Optional) Whether object versions should be returned
+                as separate blobs.
+
+            projection (str):
+                (Optional) If used, must be 'full' or 'noAcl'.
+                Defaults to ``'noAcl'``. Specifies the set of
+                properties to return.
+
+            fields (str):
+                (Optional) Selector specifying which fields to include
+                in a partial response. Must be a list of fields. For
+                example to get a partial response with just the next
+                page token and the name and language of each blob returned:
+                ``'items(name,contentLanguage),nextPageToken'``.
+                See: https://cloud.google.com/storage/docs/json_api/v1/parameters#fields
+
+        Returns:
+            Iterator of all :class:`~google.cloud.storage.blob.Blob`
+            in this bucket matching the arguments.
+        """
+        bucket = self._bucket_arg_to_bucket(bucket_or_name)
+        return bucket.list_blobs(
+            max_results=max_results,
+            page_token=page_token,
+            prefix=prefix,
+            delimiter=delimiter,
+            versions=versions,
+            projection=projection,
+            fields=fields,
+            client=self,
+        )
+
+    def list_buckets(
+        self,
+        max_results=None,
+        page_token=None,
+        prefix=None,
+        projection="noAcl",
+        fields=None,
+        project=None,
+    ):
+        """Get all buckets in the project associated to the client.
+
+        This will not populate the list of blobs available in each
+        bucket.
+
+        .. literalinclude:: snippets.py
+            :start-after: [START list_buckets]
+            :end-before: [END list_buckets]
+
+        This implements "storage.buckets.list".
+
+        :type max_results: int
+        :param max_results: Optional. The maximum number of buckets to return.
+
+        :type page_token: str
+        :param page_token:
+            Optional. If present, return the next batch of buckets, using the
+            value, which must correspond to the ``nextPageToken`` value
+            returned in the previous response.  Deprecated: use the ``pages``
+            property of the returned iterator instead of manually passing the
+            token.
+
+        :type prefix: str
+        :param prefix: Optional. Filter results to buckets whose names begin
+                       with this prefix.
+
+        :type projection: str
+        :param projection:
+            (Optional) Specifies the set of properties to return. If used, must
+            be 'full' or 'noAcl'. Defaults to 'noAcl'.
+
+        :type fields: str
+        :param fields:
+            (Optional) Selector specifying which fields to include in a partial
+            response. Must be a list of fields. For example to get a partial
+            response with just the next page token and the language of each
+            bucket returned: 'items/id,nextPageToken'
+
+        :type project: str
+        :param project: (Optional) the project whose buckets are to be listed.
+                        If not passed, uses the project set on the client.
+
+        :rtype: :class:`~google.api_core.page_iterator.Iterator`
+        :raises ValueError: if both ``project`` is ``None`` and the client's
+                            project is also ``None``.
+        :returns: Iterator of all :class:`~google.cloud.storage.bucket.Bucket`
+                  belonging to this project.
+        """
+        if project is None:
+            project = self.project
+
+        if project is None:
+            raise ValueError("Client project not set:  pass an explicit project.")
+
+        extra_params = {"project": project}
+
+        if prefix is not None:
+            extra_params["prefix"] = prefix
+
+        extra_params["projection"] = projection
+
+        if fields is not None:
+            extra_params["fields"] = fields
+
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=self._connection.api_request,
+            path="/b",
+            item_to_value=_item_to_bucket,
+            page_token=page_token,
+            max_results=max_results,
+            extra_params=extra_params,
+        )
+
+    def create_hmac_key(self, service_account_email, project_id=None):
+        """Create an HMAC key for a service account.
+
+        :type service_account_email: str
+        :param service_account_email: e-mail address of the service account
+
+        :type project_id: str
+        :param project_id: (Optional) explicit project ID for the key.
+            Defaults to the client's project.
+
+        :rtype:
+            Tuple[:class:`~google.cloud.storage.hmac_key.HMACKeyMetadata`, str]
+        :returns: metadata for the created key, plus the bytes of the key's secret, which is an 40-character base64-encoded string.
+        """
+        if project_id is None:
+            project_id = self.project
+
+        path = "/projects/{}/hmacKeys".format(project_id)
+        qs_params = {"serviceAccountEmail": service_account_email}
+        api_response = self._connection.api_request(
+            method="POST", path=path, query_params=qs_params
+        )
+        metadata = HMACKeyMetadata(self)
+        metadata._properties = api_response["metadata"]
+        secret = api_response["secret"]
+        return metadata, secret
+
+    def list_hmac_keys(
+        self,
+        max_results=None,
+        service_account_email=None,
+        show_deleted_keys=None,
+        project_id=None,
+    ):
+        """List HMAC keys for a project.
+
+        :type max_results: int
+        :param max_results:
+            (Optional) max number of keys to return in a given page.
+
+        :type service_account_email: str
+        :param service_account_email:
+            (Optional) limit keys to those created by the given service account.
+
+        :type show_deleted_keys: bool
+        :param show_deleted_keys:
+            (Optional) included deleted keys in the list. Default is to
+            exclude them.
+
+        :type project_id: str
+        :param project_id: (Optional) explicit project ID for the key.
+            Defaults to the client's project.
+
+        :rtype:
+            Tuple[:class:`~google.cloud.storage.hmac_key.HMACKeyMetadata`, str]
+        :returns: metadata for the created key, plus the bytes of the key's secret, which is an 40-character base64-encoded string.
+        """
+        if project_id is None:
+            project_id = self.project
+
+        path = "/projects/{}/hmacKeys".format(project_id)
+        extra_params = {}
+
+        if service_account_email is not None:
+            extra_params["serviceAccountEmail"] = service_account_email
+
+        if show_deleted_keys is not None:
+            extra_params["showDeletedKeys"] = show_deleted_keys
+
+        return page_iterator.HTTPIterator(
+            client=self,
+            api_request=self._connection.api_request,
+            path=path,
+            item_to_value=_item_to_hmac_key_metadata,
+            max_results=max_results,
+            extra_params=extra_params,
+        )
+
+    def get_hmac_key_metadata(self, access_id, project_id=None):
+        """Return a metadata instance for the given HMAC key.
+
+        :type access_id: str
+        :param access_id: Unique ID of an existing key.
+
+        :type project_id: str
+        :param project_id: (Optional) project ID of an existing key.
+            Defaults to client's project.
+        """
+        metadata = HMACKeyMetadata(self, access_id, project_id)
+        metadata.reload()  # raises NotFound for missing key
+        return metadata
+
+
+def _item_to_bucket(iterator, item):
+    """Convert a JSON bucket to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type item: dict
+    :param item: An item to be converted to a bucket.
+
+    :rtype: :class:`.Bucket`
+    :returns: The next bucket in the page.
+    """
+    name = item.get("name")
+    bucket = Bucket(iterator.client, name)
+    bucket._set_properties(item)
+    return bucket
+
+
+def _item_to_hmac_key_metadata(iterator, item):
+    """Convert a JSON key metadata resource to the native object.
+
+    :type iterator: :class:`~google.api_core.page_iterator.Iterator`
+    :param iterator: The iterator that has retrieved the item.
+
+    :type item: dict
+    :param item: An item to be converted to a key metadata instance.
+
+    :rtype: :class:`~google.cloud.storage.hmac_key.HMACKeyMetadata`
+    :returns: The next key metadata instance in the page.
+    """
+    metadata = HMACKeyMetadata(iterator.client)
+    metadata._properties = item
+    return metadata
diff --git a/storage/google/cloud/storage/hmac_key.py b/storage/google/cloud/storage/hmac_key.py
new file mode 100644
index 000000000000..09075896fcb2
--- /dev/null
+++ b/storage/google/cloud/storage/hmac_key.py
@@ -0,0 +1,216 @@
+# 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.
+
+from google.cloud.exceptions import NotFound
+from google.cloud._helpers import _rfc3339_to_datetime
+
+
+class HMACKeyMetadata(object):
+    """Metadata about an HMAC service account key withn Cloud Storage.
+
+    :type client: :class:`~google.cloud.stoage.client.Client`
+    :param client: client associated with the key metadata.
+
+    :type access_id: str
+    :param access_id: (Optional) unique ID of an existing key.
+
+    :type project_id: str
+    :param project_id: (Optional) project ID of an existing key.
+        Defaults to client's project.
+    """
+
+    ACTIVE_STATE = "ACTIVE"
+    """Key is active, and may be used to sign requests."""
+    INACTIVE_STATE = "INACTIVE"
+    """Key is inactive, and may not be used to sign requests.
+
+    It can be re-activated via :meth:`update`.
+    """
+    DELETED_STATE = "DELETED"
+    """Key is deleted.  It cannot be re-activated."""
+
+    _SETTABLE_STATES = (ACTIVE_STATE, INACTIVE_STATE)
+
+    def __init__(self, client, access_id=None, project_id=None):
+        self._client = client
+        self._properties = {}
+
+        if access_id is not None:
+            self._properties["accessId"] = access_id
+
+        if project_id is not None:
+            self._properties["projectId"] = project_id
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._client == other._client and self.access_id == other.access_id
+
+    def __hash__(self):
+        return hash(self._client) + hash(self.access_id)
+
+    @property
+    def access_id(self):
+        """Access ID of the key.
+
+        :rtype: str or None
+        :returns: unique identifier of the key within a project.
+        """
+        return self._properties.get("accessId")
+
+    @property
+    def etag(self):
+        """ETag identifying the version of the key metadata.
+
+        :rtype: str or None
+        :returns: ETag for the version of the key's metadata.
+        """
+        return self._properties.get("etag")
+
+    @property
+    def id(self):
+        """ID of the key, including the Project ID and the Access ID.
+
+        :rtype: str or None
+        :returns: ID of the key.
+        """
+        return self._properties.get("id")
+
+    @property
+    def project(self):
+        """Project ID associated with the key.
+
+        :rtype: str or None
+        :returns: project identfier for the key.
+        """
+        return self._properties.get("projectId")
+
+    @property
+    def service_account_email(self):
+        """Service account e-mail address associated with the key.
+
+        :rtype: str or None
+        :returns: e-mail address for the service account which created the key.
+        """
+        return self._properties.get("serviceAccountEmail")
+
+    @property
+    def state(self):
+        """Get / set key's state.
+
+        One of:
+            - ``ACTIVE``
+            - ``INACTIVE``
+            - ``DELETED``
+
+        :rtype: str or None
+        :returns: key's current state.
+        """
+        return self._properties.get("state")
+
+    @state.setter
+    def state(self, value):
+        if value not in self._SETTABLE_STATES:
+            raise ValueError(
+                "State may only be set to one of: {}".format(
+                    ", ".join(self._SETTABLE_STATES)
+                )
+            )
+
+        self._properties["state"] = value
+
+    @property
+    def time_created(self):
+        """Retrieve the timestamp at which the HMAC key was created.
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the bucket's resource has not been loaded
+                  from the server.
+        """
+        value = self._properties.get("timeCreated")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+    @property
+    def updated(self):
+        """Retrieve the timestamp at which the HMAC key was created.
+
+        :rtype: :class:`datetime.datetime` or ``NoneType``
+        :returns: Datetime object parsed from RFC3339 valid timestamp, or
+                  ``None`` if the bucket's resource has not been loaded
+                  from the server.
+        """
+        value = self._properties.get("updated")
+        if value is not None:
+            return _rfc3339_to_datetime(value)
+
+    @property
+    def path(self):
+        """Resource path for the metadata's key."""
+
+        if self.access_id is None:
+            raise ValueError("No 'access_id' set.")
+
+        project = self.project
+        if project is None:
+            project = self._client.project
+
+        return "/projects/{}/hmacKeys/{}".format(project, self.access_id)
+
+    def exists(self):
+        """Determine whether or not the key for this metadata exists.
+
+        :rtype: bool
+        :returns: True if the key exists in Cloud Storage.
+        """
+        try:
+            self._client._connection.api_request(method="GET", path=self.path)
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self):
+        """Reload properties from Cloud Storage.
+
+        :raises :class:`~google.api_core.exceptions.NotFound`:
+            if the key does not exist on the back-end.
+        """
+        self._properties = self._client._connection.api_request(
+            method="GET", path=self.path
+        )
+
+    def update(self):
+        """Save writable properties to Cloud Storage.
+
+        :raises :class:`~google.api_core.exceptions.NotFound`:
+            if the key does not exist on the back-end.
+        """
+        payload = {"state": self.state}
+        self._properties = self._client._connection.api_request(
+            method="PUT", path=self.path, data=payload
+        )
+
+    def delete(self):
+        """Delete the key from Cloud Storage.
+
+        :raises :class:`~google.api_core.exceptions.NotFound`:
+            if the key does not exist on the back-end.
+        """
+        if self.state != self.INACTIVE_STATE:
+            raise ValueError("Cannot delete key if not in 'INACTIVE' state.")
+
+        self._client._connection.api_request(method="DELETE", path=self.path)
diff --git a/storage/google/cloud/storage/iam.py b/storage/google/cloud/storage/iam.py
new file mode 100644
index 000000000000..fb7e9e4ede3a
--- /dev/null
+++ b/storage/google/cloud/storage/iam.py
@@ -0,0 +1,86 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Storage API IAM policy definitions
+
+For allowed roles / permissions, see:
+https://cloud.google.com/storage/docs/access-control/iam
+"""
+
+# Storage-specific IAM roles
+
+STORAGE_OBJECT_CREATOR_ROLE = "roles/storage.objectCreator"
+"""Role implying rights to create objects, but not delete or overwrite them."""
+
+STORAGE_OBJECT_VIEWER_ROLE = "roles/storage.objectViewer"
+"""Role implying rights to view object properties, excluding ACLs."""
+
+STORAGE_OBJECT_ADMIN_ROLE = "roles/storage.objectViewer"
+"""Role implying full control of objects."""
+
+STORAGE_ADMIN_ROLE = "roles/storage.admin"
+"""Role implying full control of objects and buckets."""
+
+STORAGE_VIEWER_ROLE = "Viewer"
+"""Can list buckets."""
+
+STORAGE_EDITOR_ROLE = "Editor"
+"""Can create, list, and delete buckets."""
+
+STORAGE_OWNER_ROLE = "Owners"
+"""Can create, list, and delete buckets."""
+
+
+# Storage-specific permissions
+
+STORAGE_BUCKETS_CREATE = "storage.buckets.create"
+"""Permission: create buckets."""
+
+STORAGE_BUCKETS_DELETE = "storage.buckets.delete"
+"""Permission: delete buckets."""
+
+STORAGE_BUCKETS_GET = "storage.buckets.get"
+"""Permission: read bucket metadata, excluding ACLs."""
+
+STORAGE_BUCKETS_GET_IAM_POLICY = "storage.buckets.getIamPolicy"
+"""Permission: read bucket ACLs."""
+
+STORAGE_BUCKETS_LIST = "storage.buckets.list"
+"""Permission: list buckets."""
+
+STORAGE_BUCKETS_SET_IAM_POLICY = "storage.buckets.setIamPolicy"
+"""Permission: update bucket ACLs."""
+
+STORAGE_BUCKETS_UPDATE = "storage.buckets.list"
+"""Permission: update buckets, excluding ACLS."""
+
+STORAGE_OBJECTS_CREATE = "storage.objects.create"
+"""Permission: add new objects to a bucket."""
+
+STORAGE_OBJECTS_DELETE = "storage.objects.delete"
+"""Permission: delete objects."""
+
+STORAGE_OBJECTS_GET = "storage.objects.get"
+"""Permission: read object data / metadata, excluding ACLs."""
+
+STORAGE_OBJECTS_GET_IAM_POLICY = "storage.objects.getIamPolicy"
+"""Permission: read object ACLs."""
+
+STORAGE_OBJECTS_LIST = "storage.objects.list"
+"""Permission: list objects in a bucket."""
+
+STORAGE_OBJECTS_SET_IAM_POLICY = "storage.objects.setIamPolicy"
+"""Permission: update object ACLs."""
+
+STORAGE_OBJECTS_UPDATE = "storage.objects.update"
+"""Permission: update object metadat, excluding ACLs."""
diff --git a/storage/google/cloud/storage/notification.py b/storage/google/cloud/storage/notification.py
new file mode 100644
index 000000000000..982dc16c04d6
--- /dev/null
+++ b/storage/google/cloud/storage/notification.py
@@ -0,0 +1,389 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Support for bucket notification resources."""
+
+import re
+
+from google.api_core.exceptions import NotFound
+
+
+OBJECT_FINALIZE_EVENT_TYPE = "OBJECT_FINALIZE"
+OBJECT_METADATA_UPDATE_EVENT_TYPE = "OBJECT_METADATA_UPDATE"
+OBJECT_DELETE_EVENT_TYPE = "OBJECT_DELETE"
+OBJECT_ARCHIVE_EVENT_TYPE = "OBJECT_ARCHIVE"
+
+JSON_API_V1_PAYLOAD_FORMAT = "JSON_API_V1"
+NONE_PAYLOAD_FORMAT = "NONE"
+
+_TOPIC_REF_FMT = "//pubsub.googleapis.com/projects/{}/topics/{}"
+_PROJECT_PATTERN = r"(?P<project>[a-z][a-z0-9-]{4,28}[a-z0-9])"
+_TOPIC_NAME_PATTERN = r"(?P<name>[A-Za-z](\w|[-_.~+%])+)"
+_TOPIC_REF_PATTERN = _TOPIC_REF_FMT.format(_PROJECT_PATTERN, _TOPIC_NAME_PATTERN)
+_TOPIC_REF_RE = re.compile(_TOPIC_REF_PATTERN)
+_BAD_TOPIC = (
+    "Resource has invalid topic: {}; see "
+    "https://cloud.google.com/storage/docs/json_api/v1/"
+    "notifications/insert#topic"
+)
+
+
+class BucketNotification(object):
+    """Represent a single notification resource for a bucket.
+
+    See: https://cloud.google.com/storage/docs/json_api/v1/notifications
+
+    :type bucket: :class:`google.cloud.storage.bucket.Bucket`
+    :param bucket: Bucket to which the notification is bound.
+
+    :type topic_name: str
+    :param topic_name: Topic name to which notifications are published.
+
+    :type topic_project: str
+    :param topic_project:
+        (Optional) project ID of topic to which notifications are published.
+        If not passed, uses the project ID of the bucket's client.
+
+    :type custom_attributes: dict
+    :param custom_attributes:
+        (Optional) additional attributes passed with notification events.
+
+    :type event_types: list(str)
+    :param event_types:
+        (Optional) event types for which notificatin events are published.
+
+    :type blob_name_prefix: str
+    :param blob_name_prefix:
+        (Optional) prefix of blob names for which notification events are
+        published..
+
+    :type payload_format: str
+    :param payload_format:
+        (Optional) format of payload for notification events.
+    """
+
+    def __init__(
+        self,
+        bucket,
+        topic_name,
+        topic_project=None,
+        custom_attributes=None,
+        event_types=None,
+        blob_name_prefix=None,
+        payload_format=NONE_PAYLOAD_FORMAT,
+    ):
+        self._bucket = bucket
+        self._topic_name = topic_name
+
+        if topic_project is None:
+            topic_project = bucket.client.project
+
+        if topic_project is None:
+            raise ValueError("Client project not set:  pass an explicit topic_project.")
+
+        self._topic_project = topic_project
+
+        self._properties = {}
+
+        if custom_attributes is not None:
+            self._properties["custom_attributes"] = custom_attributes
+
+        if event_types is not None:
+            self._properties["event_types"] = event_types
+
+        if blob_name_prefix is not None:
+            self._properties["object_name_prefix"] = blob_name_prefix
+
+        self._properties["payload_format"] = payload_format
+
+    @classmethod
+    def from_api_repr(cls, resource, bucket):
+        """Construct an instance from the JSON repr returned by the server.
+
+        See: https://cloud.google.com/storage/docs/json_api/v1/notifications
+
+        :type resource: dict
+        :param resource: JSON repr of the notification
+
+        :type bucket: :class:`google.cloud.storage.bucket.Bucket`
+        :param bucket: Bucket to which the notification is bound.
+
+        :rtype: :class:`BucketNotification`
+        :returns: the new notification instance
+        """
+        topic_path = resource.get("topic")
+        if topic_path is None:
+            raise ValueError("Resource has no topic")
+
+        name, project = _parse_topic_path(topic_path)
+        instance = cls(bucket, name, topic_project=project)
+        instance._properties = resource
+
+        return instance
+
+    @property
+    def bucket(self):
+        """Bucket to which the notification is bound."""
+        return self._bucket
+
+    @property
+    def topic_name(self):
+        """Topic name to which notifications are published."""
+        return self._topic_name
+
+    @property
+    def topic_project(self):
+        """Project ID of topic to which notifications are published.
+        """
+        return self._topic_project
+
+    @property
+    def custom_attributes(self):
+        """Custom attributes passed with notification events.
+        """
+        return self._properties.get("custom_attributes")
+
+    @property
+    def event_types(self):
+        """Event types for which notification events are published.
+        """
+        return self._properties.get("event_types")
+
+    @property
+    def blob_name_prefix(self):
+        """Prefix of blob names for which notification events are published.
+        """
+        return self._properties.get("object_name_prefix")
+
+    @property
+    def payload_format(self):
+        """Format of payload of notification events."""
+        return self._properties.get("payload_format")
+
+    @property
+    def notification_id(self):
+        """Server-set ID of notification resource."""
+        return self._properties.get("id")
+
+    @property
+    def etag(self):
+        """Server-set ETag of notification resource."""
+        return self._properties.get("etag")
+
+    @property
+    def self_link(self):
+        """Server-set ETag of notification resource."""
+        return self._properties.get("selfLink")
+
+    @property
+    def client(self):
+        """The client bound to this notfication."""
+        return self.bucket.client
+
+    @property
+    def path(self):
+        """The URL path for this notification."""
+        return "/b/{}/notificationConfigs/{}".format(
+            self.bucket.name, self.notification_id
+        )
+
+    def _require_client(self, client):
+        """Check client or verify over-ride.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: the client to use.
+
+        :rtype: :class:`google.cloud.storage.client.Client`
+        :returns: The client passed in or the bucket's client.
+        """
+        if client is None:
+            client = self.client
+        return client
+
+    def _set_properties(self, response):
+        """Helper for :meth:`reload`.
+
+        :type response: dict
+        :param response: resource mapping from server
+        """
+        self._properties.clear()
+        self._properties.update(response)
+
+    def create(self, client=None):
+        """API wrapper: create the notification.
+
+        See:
+        https://cloud.google.com/storage/docs/json_api/v1/notifications/insert
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client`
+        :param client: (Optional) the client to use.  If not passed, falls back
+                       to the ``client`` stored on the notification's bucket.
+        """
+        if self.notification_id is not None:
+            raise ValueError(
+                "Notification already exists w/ id: {}".format(self.notification_id)
+            )
+
+        client = self._require_client(client)
+
+        query_params = {}
+        if self.bucket.user_project is not None:
+            query_params["userProject"] = self.bucket.user_project
+
+        path = "/b/{}/notificationConfigs".format(self.bucket.name)
+        properties = self._properties.copy()
+        properties["topic"] = _TOPIC_REF_FMT.format(self.topic_project, self.topic_name)
+        self._properties = client._connection.api_request(
+            method="POST", path=path, query_params=query_params, data=properties
+        )
+
+    def exists(self, client=None):
+        """Test whether this notification exists.
+
+        See:
+        https://cloud.google.com/storage/docs/json_api/v1/notifications/get
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: bool
+        :returns: True, if the notification exists, else False.
+        :raises ValueError: if the notification has no ID.
+        """
+        if self.notification_id is None:
+            raise ValueError("Notification not intialized by server")
+
+        client = self._require_client(client)
+
+        query_params = {}
+        if self.bucket.user_project is not None:
+            query_params["userProject"] = self.bucket.user_project
+
+        try:
+            client._connection.api_request(
+                method="GET", path=self.path, query_params=query_params
+            )
+        except NotFound:
+            return False
+        else:
+            return True
+
+    def reload(self, client=None):
+        """Update this notification from the server configuration.
+
+        See:
+        https://cloud.google.com/storage/docs/json_api/v1/notifications/get
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :rtype: bool
+        :returns: True, if the notification exists, else False.
+        :raises ValueError: if the notification has no ID.
+        """
+        if self.notification_id is None:
+            raise ValueError("Notification not intialized by server")
+
+        client = self._require_client(client)
+
+        query_params = {}
+        if self.bucket.user_project is not None:
+            query_params["userProject"] = self.bucket.user_project
+
+        response = client._connection.api_request(
+            method="GET", path=self.path, query_params=query_params
+        )
+        self._set_properties(response)
+
+    def delete(self, client=None):
+        """Delete this notification.
+
+        See:
+        https://cloud.google.com/storage/docs/json_api/v1/notifications/delete
+
+        If :attr:`user_project` is set on the bucket, bills the API request
+        to that project.
+
+        :type client: :class:`~google.cloud.storage.client.Client` or
+                      ``NoneType``
+        :param client: Optional. The client to use.  If not passed, falls back
+                       to the ``client`` stored on the current bucket.
+
+        :raises: :class:`google.api_core.exceptions.NotFound`:
+            if the notification does not exist.
+        :raises ValueError: if the notification has no ID.
+        """
+        if self.notification_id is None:
+            raise ValueError("Notification not intialized by server")
+
+        client = self._require_client(client)
+
+        query_params = {}
+        if self.bucket.user_project is not None:
+            query_params["userProject"] = self.bucket.user_project
+
+        client._connection.api_request(
+            method="DELETE", path=self.path, query_params=query_params
+        )
+
+
+def _parse_topic_path(topic_path):
+    """Verify that a topic path is in the correct format.
+
+    .. _resource manager docs: https://cloud.google.com/resource-manager/\
+                               reference/rest/v1beta1/projects#\
+                               Project.FIELDS.project_id
+    .. _topic spec: https://cloud.google.com/storage/docs/json_api/v1/\
+                    notifications/insert#topic
+
+    Expected to be of the form:
+
+        //pubsub.googleapis.com/projects/{project}/topics/{topic}
+
+    where the ``project`` value must be "6 to 30 lowercase letters, digits,
+    or hyphens. It must start with a letter. Trailing hyphens are prohibited."
+    (see `resource manager docs`_) and ``topic`` must have length at least two,
+    must start with a letter and may only contain alphanumeric characters or
+    ``-``, ``_``, ``.``, ``~``, ``+`` or ``%`` (i.e characters used for URL
+    encoding, see `topic spec`_).
+
+    Args:
+        topic_path (str): The topic path to be verified.
+
+    Returns:
+        Tuple[str, str]: The ``project`` and ``topic`` parsed from the
+        ``topic_path``.
+
+    Raises:
+        ValueError: If the topic path is invalid.
+    """
+    match = _TOPIC_REF_RE.match(topic_path)
+    if match is None:
+        raise ValueError(_BAD_TOPIC.format(topic_path))
+
+    return match.group("name"), match.group("project")
diff --git a/storage/noxfile.py b/storage/noxfile.py
new file mode 100644
index 000000000000..a391c6732b70
--- /dev/null
+++ b/storage/noxfile.py
@@ -0,0 +1,155 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "Pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+@nox.session
+def default(session):
+    """Default unit test session.
+
+    This is intended to be run **without** an interpreter set, so
+    that the current ``python`` (on the ``PATH``) or the version of
+    Python corresponding to the ``nox`` binary the ``PATH`` can
+    run the tests.
+    """
+    # Install all test dependencies, then install local packages in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud.storage",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        "tests/unit",
+        *session.posargs
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.6"])
+def system(session):
+    """Run the system test suite."""
+
+    # Sanity check: Only run system tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable.")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install local packages in-place.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    systest_deps = ["../test_utils/", "../pubsub", "../kms"]
+    for systest_dep in systest_deps:
+        session.install("-e", systest_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    session.run("py.test", "--quiet", "tests/system.py", *session.posargs)
+
+
+@nox.session(python="3.6")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/storage/pylint.config.py b/storage/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/storage/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/storage/setup.cfg b/storage/setup.cfg
new file mode 100644
index 000000000000..2a9acf13daa9
--- /dev/null
+++ b/storage/setup.cfg
@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1
diff --git a/storage/setup.py b/storage/setup.py
new file mode 100644
index 000000000000..017caf1cfa1b
--- /dev/null
+++ b/storage/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-storage"
+description = "Google Cloud Storage API client library"
+version = "1.19.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-auth >= 1.2.0",
+    "google-cloud-core >= 1.0.3, < 2.0dev",
+    "google-resumable-media >= 0.3.1",
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/storage/tests/__init__.py b/storage/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/system_tests/data/CloudPlatform_128px_Retina.png b/storage/tests/data/CloudPlatform_128px_Retina.png
similarity index 100%
rename from system_tests/data/CloudPlatform_128px_Retina.png
rename to storage/tests/data/CloudPlatform_128px_Retina.png
diff --git a/system_tests/data/five-point-one-mb-file.zip b/storage/tests/data/five-point-one-mb-file.zip
similarity index 100%
rename from system_tests/data/five-point-one-mb-file.zip
rename to storage/tests/data/five-point-one-mb-file.zip
diff --git a/system_tests/data/simple.txt b/storage/tests/data/simple.txt
similarity index 100%
rename from system_tests/data/simple.txt
rename to storage/tests/data/simple.txt
diff --git a/storage/tests/system.py b/storage/tests/system.py
new file mode 100644
index 000000000000..c2717fb2b1af
--- /dev/null
+++ b/storage/tests/system.py
@@ -0,0 +1,1774 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import os
+import re
+import tempfile
+import time
+import unittest
+
+import requests
+import six
+
+from google.cloud import exceptions
+from google.cloud import storage
+from google.cloud.storage._helpers import _base64_md5hash
+from google.cloud.storage.bucket import LifecycleRuleDelete
+from google.cloud.storage.bucket import LifecycleRuleSetStorageClass
+from google.cloud import kms
+import google.oauth2
+
+from test_utils.retry import RetryErrors
+from test_utils.system import unique_resource_id
+
+
+USER_PROJECT = os.environ.get("GOOGLE_CLOUD_TESTS_USER_PROJECT")
+RUNNING_IN_VPCSC = os.getenv("GOOGLE_CLOUD_TESTS_IN_VPCSC", "").lower() == "true"
+
+
+def _bad_copy(bad_request):
+    """Predicate: pass only exceptions for a failed copyTo."""
+    err_msg = bad_request.message
+    return err_msg.startswith("No file found in request. (POST") and "copyTo" in err_msg
+
+
+retry_429 = RetryErrors(exceptions.TooManyRequests, max_tries=6)
+retry_429_harder = RetryErrors(exceptions.TooManyRequests, max_tries=10)
+retry_429_503 = RetryErrors(
+    [exceptions.TooManyRequests, exceptions.ServiceUnavailable], max_tries=6
+)
+retry_bad_copy = RetryErrors(exceptions.BadRequest, error_predicate=_bad_copy)
+
+
+def _empty_bucket(bucket):
+    """Empty a bucket of all existing blobs (including multiple versions)."""
+    for blob in list(bucket.list_blobs(versions=True)):
+        try:
+            blob.delete()
+        except exceptions.NotFound:
+            pass
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+    TEST_BUCKET = None
+
+
+def setUpModule():
+    Config.CLIENT = storage.Client()
+    bucket_name = "new" + unique_resource_id()
+    # In the **very** rare case the bucket name is reserved, this
+    # fails with a ConnectionError.
+    Config.TEST_BUCKET = Config.CLIENT.bucket(bucket_name)
+    Config.TEST_BUCKET.versioning_enabled = True
+    retry_429(Config.TEST_BUCKET.create)()
+
+
+def tearDownModule():
+    errors = (exceptions.Conflict, exceptions.TooManyRequests)
+    retry = RetryErrors(errors, max_tries=15)
+    retry(_empty_bucket)(Config.TEST_BUCKET)
+    retry(Config.TEST_BUCKET.delete)(force=True)
+
+
+class TestClient(unittest.TestCase):
+    def setUp(self):
+        self.case_hmac_keys_to_delete = []
+
+    def tearDown(self):
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        for hmac_key in self.case_hmac_keys_to_delete:
+            if hmac_key.state == HMACKeyMetadata.ACTIVE_STATE:
+                hmac_key.state = HMACKeyMetadata.INACTIVE_STATE
+                hmac_key.update()
+            if hmac_key.state == HMACKeyMetadata.INACTIVE_STATE:
+                retry_429_harder(hmac_key.delete)()
+
+    def test_get_service_account_email(self):
+        domain = "gs-project-accounts.iam.gserviceaccount.com"
+
+        email = Config.CLIENT.get_service_account_email()
+
+        new_style = re.compile(r"service-(?P<projnum>[^@]+)@" + domain)
+        old_style = re.compile(r"{}@{}".format(Config.CLIENT.project, domain))
+        patterns = [new_style, old_style]
+        matches = [pattern.match(email) for pattern in patterns]
+
+        self.assertTrue(any(match for match in matches if match is not None))
+
+    def test_hmac_key_crud(self):
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        credentials = Config.CLIENT._credentials
+        email = credentials.service_account_email
+
+        before_keys = set(Config.CLIENT.list_hmac_keys())
+
+        metadata, secret = Config.CLIENT.create_hmac_key(email)
+        self.case_hmac_keys_to_delete.append(metadata)
+
+        self.assertIsInstance(secret, six.text_type)
+        self.assertEqual(len(secret), 40)
+
+        after_keys = set(Config.CLIENT.list_hmac_keys())
+        self.assertFalse(metadata in before_keys)
+        self.assertTrue(metadata in after_keys)
+
+        another = HMACKeyMetadata(Config.CLIENT)
+
+        another._properties["accessId"] = "nonesuch"
+        self.assertFalse(another.exists())
+
+        another._properties["accessId"] = metadata.access_id
+        self.assertTrue(another.exists())
+
+        another.reload()
+
+        self.assertEqual(another._properties, metadata._properties)
+
+        metadata.state = HMACKeyMetadata.INACTIVE_STATE
+        metadata.update()
+
+        metadata.delete()
+        self.case_hmac_keys_to_delete.remove(metadata)
+
+
+class TestStorageBuckets(unittest.TestCase):
+    def setUp(self):
+        self.case_buckets_to_delete = []
+
+    def tearDown(self):
+        for bucket_name in self.case_buckets_to_delete:
+            bucket = Config.CLIENT.bucket(bucket_name)
+            retry_429_harder(bucket.delete)()
+
+    def test_create_bucket(self):
+        new_bucket_name = "a-new-bucket" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        created = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+        self.assertEqual(created.name, new_bucket_name)
+
+    def test_lifecycle_rules(self):
+        new_bucket_name = "w-lifcycle-rules" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        bucket = Config.CLIENT.bucket(new_bucket_name)
+        bucket.add_lifecycle_delete_rule(age=42)
+        bucket.add_lifecycle_set_storage_class_rule(
+            "COLDLINE", is_live=False, matches_storage_class=["NEARLINE"]
+        )
+
+        expected_rules = [
+            LifecycleRuleDelete(age=42),
+            LifecycleRuleSetStorageClass(
+                "COLDLINE", is_live=False, matches_storage_class=["NEARLINE"]
+            ),
+        ]
+
+        retry_429(bucket.create)(location="us")
+
+        self.case_buckets_to_delete.append(new_bucket_name)
+        self.assertEqual(bucket.name, new_bucket_name)
+        self.assertEqual(list(bucket.lifecycle_rules), expected_rules)
+
+        bucket.clear_lifecyle_rules()
+        bucket.patch()
+
+        self.assertEqual(list(bucket.lifecycle_rules), [])
+
+    def test_list_buckets(self):
+        buckets_to_create = [
+            "new" + unique_resource_id(),
+            "newer" + unique_resource_id(),
+            "newest" + unique_resource_id(),
+        ]
+        created_buckets = []
+        for bucket_name in buckets_to_create:
+            bucket = Config.CLIENT.bucket(bucket_name)
+            retry_429(bucket.create)()
+            self.case_buckets_to_delete.append(bucket_name)
+
+        # Retrieve the buckets.
+        all_buckets = Config.CLIENT.list_buckets()
+        created_buckets = [
+            bucket for bucket in all_buckets if bucket.name in buckets_to_create
+        ]
+        self.assertEqual(len(created_buckets), len(buckets_to_create))
+
+    def test_bucket_update_labels(self):
+        bucket_name = "update-labels" + unique_resource_id("-")
+        bucket = retry_429(Config.CLIENT.create_bucket)(bucket_name)
+        self.case_buckets_to_delete.append(bucket_name)
+        self.assertTrue(bucket.exists())
+
+        updated_labels = {"test-label": "label-value"}
+        bucket.labels = updated_labels
+        bucket.update()
+        self.assertEqual(bucket.labels, updated_labels)
+
+        new_labels = {"another-label": "another-value"}
+        bucket.labels = new_labels
+        bucket.patch()
+        self.assertEqual(bucket.labels, new_labels)
+
+        bucket.labels = {}
+        bucket.update()
+        self.assertEqual(bucket.labels, {})
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_crud_bucket_with_requester_pays(self):
+        new_bucket_name = "w-requester-pays" + unique_resource_id("-")
+        created = retry_429(Config.CLIENT.create_bucket)(
+            new_bucket_name, requester_pays=True
+        )
+        self.case_buckets_to_delete.append(new_bucket_name)
+        self.assertEqual(created.name, new_bucket_name)
+        self.assertTrue(created.requester_pays)
+
+        with_user_project = Config.CLIENT.bucket(
+            new_bucket_name, user_project=USER_PROJECT
+        )
+
+        # Bucket will be deleted in-line below.
+        self.case_buckets_to_delete.remove(new_bucket_name)
+
+        try:
+            # Exercise 'buckets.get' w/ userProject.
+            self.assertTrue(with_user_project.exists())
+            with_user_project.reload()
+            self.assertTrue(with_user_project.requester_pays)
+
+            # Exercise 'buckets.patch' w/ userProject.
+            with_user_project.configure_website(
+                main_page_suffix="index.html", not_found_page="404.html"
+            )
+            with_user_project.patch()
+            self.assertEqual(
+                with_user_project._properties["website"],
+                {"mainPageSuffix": "index.html", "notFoundPage": "404.html"},
+            )
+
+            # Exercise 'buckets.update' w/ userProject.
+            new_labels = {"another-label": "another-value"}
+            with_user_project.labels = new_labels
+            with_user_project.update()
+            self.assertEqual(with_user_project.labels, new_labels)
+
+        finally:
+            # Exercise 'buckets.delete' w/ userProject.
+            with_user_project.delete()
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_bucket_acls_iam_with_user_project(self):
+        new_bucket_name = "acl-w-user-project" + unique_resource_id("-")
+        retry_429(Config.CLIENT.create_bucket)(new_bucket_name, requester_pays=True)
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        with_user_project = Config.CLIENT.bucket(
+            new_bucket_name, user_project=USER_PROJECT
+        )
+
+        # Exercise bucket ACL w/ userProject
+        acl = with_user_project.acl
+        acl.reload()
+        acl.all().grant_read()
+        acl.save()
+        self.assertIn("READER", acl.all().get_roles())
+        del acl.entities["allUsers"]
+        acl.save()
+        self.assertFalse(acl.has_entity("allUsers"))
+
+        # Exercise default object ACL w/ userProject
+        doa = with_user_project.default_object_acl
+        doa.reload()
+        doa.all().grant_read()
+        doa.save()
+        self.assertIn("READER", doa.all().get_roles())
+
+        # Exercise IAM w/ userProject
+        test_permissions = ["storage.buckets.get"]
+        self.assertEqual(
+            with_user_project.test_iam_permissions(test_permissions), test_permissions
+        )
+
+        policy = with_user_project.get_iam_policy()
+        viewers = policy.setdefault("roles/storage.objectViewer", set())
+        viewers.add(policy.all_users())
+        with_user_project.set_iam_policy(policy)
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_copy_existing_file_with_user_project(self):
+        new_bucket_name = "copy-w-requester-pays" + unique_resource_id("-")
+        created = retry_429(Config.CLIENT.create_bucket)(
+            new_bucket_name, requester_pays=True
+        )
+        self.case_buckets_to_delete.append(new_bucket_name)
+        self.assertEqual(created.name, new_bucket_name)
+        self.assertTrue(created.requester_pays)
+
+        to_delete = []
+        blob = storage.Blob("simple", bucket=created)
+        blob.upload_from_string(b"DEADBEEF")
+        to_delete.append(blob)
+        try:
+            with_user_project = Config.CLIENT.bucket(
+                new_bucket_name, user_project=USER_PROJECT
+            )
+
+            new_blob = retry_bad_copy(with_user_project.copy_blob)(
+                blob, with_user_project, "simple-copy"
+            )
+            to_delete.append(new_blob)
+
+            base_contents = blob.download_as_string()
+            copied_contents = new_blob.download_as_string()
+            self.assertEqual(base_contents, copied_contents)
+        finally:
+            for blob in to_delete:
+                retry_429_harder(blob.delete)()
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_bucket_get_blob_with_user_project(self):
+        new_bucket_name = "w-requester-pays" + unique_resource_id("-")
+        data = b"DEADBEEF"
+        created = retry_429(Config.CLIENT.create_bucket)(
+            new_bucket_name, requester_pays=True
+        )
+        self.case_buckets_to_delete.append(new_bucket_name)
+        self.assertEqual(created.name, new_bucket_name)
+        self.assertTrue(created.requester_pays)
+
+        with_user_project = Config.CLIENT.bucket(
+            new_bucket_name, user_project=USER_PROJECT
+        )
+
+        self.assertIsNone(with_user_project.get_blob("nonesuch"))
+        to_add = created.blob("blob-name")
+        to_add.upload_from_string(data)
+        try:
+            found = with_user_project.get_blob("blob-name")
+            self.assertEqual(found.download_as_string(), data)
+        finally:
+            to_add.delete()
+
+
+class TestStorageFiles(unittest.TestCase):
+
+    DIRNAME = os.path.realpath(os.path.dirname(__file__))
+    FILES = {
+        "logo": {"path": DIRNAME + "/data/CloudPlatform_128px_Retina.png"},
+        "big": {"path": DIRNAME + "/data/five-point-one-mb-file.zip"},
+        "simple": {"path": DIRNAME + "/data/simple.txt"},
+    }
+
+    @classmethod
+    def setUpClass(cls):
+        super(TestStorageFiles, cls).setUpClass()
+        for file_data in cls.FILES.values():
+            with open(file_data["path"], "rb") as file_obj:
+                file_data["hash"] = _base64_md5hash(file_obj)
+        cls.bucket = Config.TEST_BUCKET
+
+    def setUp(self):
+        self.case_blobs_to_delete = []
+
+    def tearDown(self):
+        errors = (exceptions.TooManyRequests, exceptions.ServiceUnavailable)
+        retry = RetryErrors(errors, max_tries=6)
+        for blob in self.case_blobs_to_delete:
+            retry(blob.delete)()
+
+
+class TestStorageWriteFiles(TestStorageFiles):
+    ENCRYPTION_KEY = "b23ff11bba187db8c37077e6af3b25b8"
+
+    def test_large_file_write_from_stream(self):
+        blob = self.bucket.blob("LargeFile")
+
+        file_data = self.FILES["big"]
+        with open(file_data["path"], "rb") as file_obj:
+            blob.upload_from_file(file_obj)
+            self.case_blobs_to_delete.append(blob)
+
+        md5_hash = blob.md5_hash
+        if not isinstance(md5_hash, six.binary_type):
+            md5_hash = md5_hash.encode("utf-8")
+        self.assertEqual(md5_hash, file_data["hash"])
+
+    def test_large_encrypted_file_write_from_stream(self):
+        blob = self.bucket.blob("LargeFile", encryption_key=self.ENCRYPTION_KEY)
+
+        file_data = self.FILES["big"]
+        with open(file_data["path"], "rb") as file_obj:
+            blob.upload_from_file(file_obj)
+            self.case_blobs_to_delete.append(blob)
+
+        md5_hash = blob.md5_hash
+        if not isinstance(md5_hash, six.binary_type):
+            md5_hash = md5_hash.encode("utf-8")
+        self.assertEqual(md5_hash, file_data["hash"])
+
+        temp_filename = tempfile.mktemp()
+        with open(temp_filename, "wb") as file_obj:
+            blob.download_to_file(file_obj)
+
+        with open(temp_filename, "rb") as file_obj:
+            md5_temp_hash = _base64_md5hash(file_obj)
+
+        self.assertEqual(md5_temp_hash, file_data["hash"])
+
+    def test_small_file_write_from_filename(self):
+        blob = self.bucket.blob("SmallFile")
+
+        file_data = self.FILES["simple"]
+        blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(blob)
+
+        md5_hash = blob.md5_hash
+        if not isinstance(md5_hash, six.binary_type):
+            md5_hash = md5_hash.encode("utf-8")
+        self.assertEqual(md5_hash, file_data["hash"])
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_crud_blob_w_user_project(self):
+        with_user_project = Config.CLIENT.bucket(
+            self.bucket.name, user_project=USER_PROJECT
+        )
+        blob = with_user_project.blob("SmallFile")
+
+        file_data = self.FILES["simple"]
+        with open(file_data["path"], mode="rb") as to_read:
+            file_contents = to_read.read()
+
+        # Exercise 'objects.insert' w/ userProject.
+        blob.upload_from_filename(file_data["path"])
+        gen0 = blob.generation
+
+        # Upload a second generation of the blob
+        blob.upload_from_string(b"gen1")
+        gen1 = blob.generation
+
+        blob0 = with_user_project.blob("SmallFile", generation=gen0)
+        blob1 = with_user_project.blob("SmallFile", generation=gen1)
+
+        # Exercise 'objects.get' w/ generation
+        self.assertEqual(with_user_project.get_blob(blob.name).generation, gen1)
+        self.assertEqual(
+            with_user_project.get_blob(blob.name, generation=gen0).generation, gen0
+        )
+
+        try:
+            # Exercise 'objects.get' (metadata) w/ userProject.
+            self.assertTrue(blob.exists())
+            blob.reload()
+
+            # Exercise 'objects.get' (media) w/ userProject.
+            self.assertEqual(blob0.download_as_string(), file_contents)
+            self.assertEqual(blob1.download_as_string(), b"gen1")
+
+            # Exercise 'objects.patch' w/ userProject.
+            blob0.content_language = "en"
+            blob0.patch()
+            self.assertEqual(blob0.content_language, "en")
+            self.assertIsNone(blob1.content_language)
+
+            # Exercise 'objects.update' w/ userProject.
+            metadata = {"foo": "Foo", "bar": "Bar"}
+            blob0.metadata = metadata
+            blob0.update()
+            self.assertEqual(blob0.metadata, metadata)
+            self.assertIsNone(blob1.metadata)
+        finally:
+            # Exercise 'objects.delete' (metadata) w/ userProject.
+            blobs = with_user_project.list_blobs(prefix=blob.name, versions=True)
+            self.assertEqual([each.generation for each in blobs], [gen0, gen1])
+
+            blob0.delete()
+            blobs = with_user_project.list_blobs(prefix=blob.name, versions=True)
+            self.assertEqual([each.generation for each in blobs], [gen1])
+
+            blob1.delete()
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_blob_acl_w_user_project(self):
+        with_user_project = Config.CLIENT.bucket(
+            self.bucket.name, user_project=USER_PROJECT
+        )
+        blob = with_user_project.blob("SmallFile")
+
+        file_data = self.FILES["simple"]
+
+        blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(blob)
+
+        # Exercise bucket ACL w/ userProject
+        acl = blob.acl
+        acl.reload()
+        acl.all().grant_read()
+        acl.save()
+        self.assertIn("READER", acl.all().get_roles())
+        del acl.entities["allUsers"]
+        acl.save()
+        self.assertFalse(acl.has_entity("allUsers"))
+
+    def test_upload_blob_acl(self):
+        control = self.bucket.blob("logo")
+        control_data = self.FILES["logo"]
+
+        blob = self.bucket.blob("SmallFile")
+        file_data = self.FILES["simple"]
+
+        try:
+            control.upload_from_filename(control_data["path"])
+            blob.upload_from_filename(file_data["path"], predefined_acl="publicRead")
+        finally:
+            self.case_blobs_to_delete.append(blob)
+            self.case_blobs_to_delete.append(control)
+
+        control_acl = control.acl
+        self.assertNotIn("READER", control_acl.all().get_roles())
+        acl = blob.acl
+        self.assertIn("READER", acl.all().get_roles())
+        acl.all().revoke_read()
+        self.assertSequenceEqual(acl.all().get_roles(), set([]))
+        self.assertEqual(control_acl.all().get_roles(), acl.all().get_roles())
+
+    def test_write_metadata(self):
+        filename = self.FILES["logo"]["path"]
+        blob_name = os.path.basename(filename)
+
+        blob = storage.Blob(blob_name, bucket=self.bucket)
+        blob.upload_from_filename(filename)
+        self.case_blobs_to_delete.append(blob)
+
+        # NOTE: This should not be necessary. We should be able to pass
+        #       it in to upload_file and also to upload_from_string.
+        blob.content_type = "image/png"
+        self.assertEqual(blob.content_type, "image/png")
+
+    def test_direct_write_and_read_into_file(self):
+        blob = self.bucket.blob("MyBuffer")
+        file_contents = b"Hello World"
+        blob.upload_from_string(file_contents)
+        self.case_blobs_to_delete.append(blob)
+
+        same_blob = self.bucket.blob("MyBuffer")
+        same_blob.reload()  # Initialize properties.
+        temp_filename = tempfile.mktemp()
+        with open(temp_filename, "wb") as file_obj:
+            same_blob.download_to_file(file_obj)
+
+        with open(temp_filename, "rb") as file_obj:
+            stored_contents = file_obj.read()
+
+        self.assertEqual(file_contents, stored_contents)
+
+    def test_copy_existing_file(self):
+        filename = self.FILES["logo"]["path"]
+        blob = storage.Blob("CloudLogo", bucket=self.bucket)
+        blob.upload_from_filename(filename)
+        self.case_blobs_to_delete.append(blob)
+
+        new_blob = retry_bad_copy(self.bucket.copy_blob)(
+            blob, self.bucket, "CloudLogoCopy"
+        )
+        self.case_blobs_to_delete.append(new_blob)
+
+        base_contents = blob.download_as_string()
+        copied_contents = new_blob.download_as_string()
+        self.assertEqual(base_contents, copied_contents)
+
+    def test_download_blob_w_uri(self):
+        blob = self.bucket.blob("MyBuffer")
+        file_contents = b"Hello World"
+        blob.upload_from_string(file_contents)
+        self.case_blobs_to_delete.append(blob)
+
+        temp_filename = tempfile.mktemp()
+        with open(temp_filename, "wb") as file_obj:
+            Config.CLIENT.download_blob_to_file(
+                "gs://" + self.bucket.name + "/MyBuffer", file_obj
+            )
+
+        with open(temp_filename, "rb") as file_obj:
+            stored_contents = file_obj.read()
+
+        self.assertEqual(file_contents, stored_contents)
+
+
+class TestUnicode(unittest.TestCase):
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_fetch_object_and_check_content(self):
+        client = storage.Client()
+        bucket = client.bucket("storage-library-test-bucket")
+
+        # Note: These files are public.
+        # Normalization form C: a single character for e-acute;
+        # URL should end with Cafe%CC%81
+        # Normalization Form D: an ASCII e followed by U+0301 combining
+        # character; URL should end with Caf%C3%A9
+        test_data = {
+            u"Caf\u00e9": b"Normalization Form C",
+            u"Cafe\u0301": b"Normalization Form D",
+        }
+        for blob_name, file_contents in test_data.items():
+            blob = bucket.blob(blob_name)
+            self.assertEqual(blob.name, blob_name)
+            self.assertEqual(blob.download_as_string(), file_contents)
+
+
+class TestStorageListFiles(TestStorageFiles):
+
+    FILENAMES = ("CloudLogo1", "CloudLogo2", "CloudLogo3")
+
+    @classmethod
+    def setUpClass(cls):
+        super(TestStorageListFiles, cls).setUpClass()
+        # Make sure bucket empty before beginning.
+        _empty_bucket(cls.bucket)
+
+        logo_path = cls.FILES["logo"]["path"]
+        blob = storage.Blob(cls.FILENAMES[0], bucket=cls.bucket)
+        blob.upload_from_filename(logo_path)
+        cls.suite_blobs_to_delete = [blob]
+
+        # Copy main blob onto remaining in FILENAMES.
+        for filename in cls.FILENAMES[1:]:
+            new_blob = retry_bad_copy(cls.bucket.copy_blob)(blob, cls.bucket, filename)
+            cls.suite_blobs_to_delete.append(new_blob)
+
+    @classmethod
+    def tearDownClass(cls):
+        errors = (exceptions.TooManyRequests, exceptions.ServiceUnavailable)
+        retry = RetryErrors(errors, max_tries=6)
+        for blob in cls.suite_blobs_to_delete:
+            retry(blob.delete)()
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_list_files(self):
+        all_blobs = list(self.bucket.list_blobs())
+        self.assertEqual(
+            sorted(blob.name for blob in all_blobs), sorted(self.FILENAMES)
+        )
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_list_files_with_user_project(self):
+        with_user_project = Config.CLIENT.bucket(
+            self.bucket.name, user_project=USER_PROJECT
+        )
+        all_blobs = list(with_user_project.list_blobs())
+        self.assertEqual(
+            sorted(blob.name for blob in all_blobs), sorted(self.FILENAMES)
+        )
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_paginate_files(self):
+        truncation_size = 1
+        count = len(self.FILENAMES) - truncation_size
+        iterator = self.bucket.list_blobs(max_results=count)
+        page_iter = iterator.pages
+
+        page1 = six.next(page_iter)
+        blobs = list(page1)
+        self.assertEqual(len(blobs), count)
+        self.assertIsNotNone(iterator.next_page_token)
+        # Technically the iterator is exhausted.
+        self.assertEqual(iterator.num_results, iterator.max_results)
+        # But we modify the iterator to continue paging after
+        # articially stopping after ``count`` items.
+        iterator.max_results = None
+
+        page2 = six.next(page_iter)
+        last_blobs = list(page2)
+        self.assertEqual(len(last_blobs), truncation_size)
+
+
+class TestStoragePseudoHierarchy(TestStorageFiles):
+
+    FILENAMES = (
+        "file01.txt",
+        "parent/file11.txt",
+        "parent/child/file21.txt",
+        "parent/child/file22.txt",
+        "parent/child/grand/file31.txt",
+        "parent/child/other/file32.txt",
+    )
+
+    @classmethod
+    def setUpClass(cls):
+        super(TestStoragePseudoHierarchy, cls).setUpClass()
+        # Make sure bucket empty before beginning.
+        _empty_bucket(cls.bucket)
+
+        cls.suite_blobs_to_delete = []
+        simple_path = cls.FILES["simple"]["path"]
+        for filename in cls.FILENAMES:
+            blob = storage.Blob(filename, bucket=cls.bucket)
+            blob.upload_from_filename(simple_path)
+            cls.suite_blobs_to_delete.append(blob)
+
+    @classmethod
+    def tearDownClass(cls):
+        errors = (exceptions.TooManyRequests, exceptions.ServiceUnavailable)
+        retry = RetryErrors(errors, max_tries=6)
+        for blob in cls.suite_blobs_to_delete:
+            retry(blob.delete)()
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_blob_get_w_delimiter(self):
+        for filename in self.FILENAMES:
+            blob = self.bucket.blob(filename)
+            self.assertTrue(blob.exists(), filename)
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_root_level_w_delimiter(self):
+        iterator = self.bucket.list_blobs(delimiter="/")
+        page = six.next(iterator.pages)
+        blobs = list(page)
+        self.assertEqual([blob.name for blob in blobs], ["file01.txt"])
+        self.assertIsNone(iterator.next_page_token)
+        self.assertEqual(iterator.prefixes, set(["parent/"]))
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_first_level(self):
+        iterator = self.bucket.list_blobs(delimiter="/", prefix="parent/")
+        page = six.next(iterator.pages)
+        blobs = list(page)
+        self.assertEqual([blob.name for blob in blobs], ["parent/file11.txt"])
+        self.assertIsNone(iterator.next_page_token)
+        self.assertEqual(iterator.prefixes, set(["parent/child/"]))
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_second_level(self):
+        expected_names = ["parent/child/file21.txt", "parent/child/file22.txt"]
+
+        iterator = self.bucket.list_blobs(delimiter="/", prefix="parent/child/")
+        page = six.next(iterator.pages)
+        blobs = list(page)
+        self.assertEqual([blob.name for blob in blobs], expected_names)
+        self.assertIsNone(iterator.next_page_token)
+        self.assertEqual(
+            iterator.prefixes, set(["parent/child/grand/", "parent/child/other/"])
+        )
+
+    @RetryErrors(unittest.TestCase.failureException)
+    def test_third_level(self):
+        # Pseudo-hierarchy can be arbitrarily deep, subject to the limit
+        # of 1024 characters in the UTF-8 encoded name:
+        # https://cloud.google.com/storage/docs/bucketnaming#objectnames
+        # Exercise a layer deeper to illustrate this.
+        iterator = self.bucket.list_blobs(delimiter="/", prefix="parent/child/grand/")
+        page = six.next(iterator.pages)
+        blobs = list(page)
+        self.assertEqual(
+            [blob.name for blob in blobs], ["parent/child/grand/file31.txt"]
+        )
+        self.assertIsNone(iterator.next_page_token)
+        self.assertEqual(iterator.prefixes, set())
+
+
+class TestStorageSignURLs(unittest.TestCase):
+    BLOB_CONTENT = b"This time for sure, Rocky!"
+
+    @classmethod
+    def setUpClass(cls):
+        if (
+            type(Config.CLIENT._credentials)
+            is not google.oauth2.service_account.Credentials
+        ):
+            cls.skipTest("Signing tests requires a service account credential")
+
+        bucket_name = "gcp-signing" + unique_resource_id()
+        cls.bucket = retry_429(Config.CLIENT.create_bucket)(bucket_name)
+        cls.blob = cls.bucket.blob("README.txt")
+        cls.blob.upload_from_string(cls.BLOB_CONTENT)
+
+    @classmethod
+    def tearDownClass(cls):
+        _empty_bucket(cls.bucket)
+        errors = (exceptions.Conflict, exceptions.TooManyRequests)
+        retry = RetryErrors(errors, max_tries=6)
+        retry(cls.bucket.delete)(force=True)
+
+    @staticmethod
+    def _morph_expiration(version, expiration):
+        if expiration is not None:
+            return expiration
+
+        if version == "v2":
+            return int(time.time()) + 10
+
+        return 10
+
+    def _create_signed_list_blobs_url_helper(
+        self, version, expiration=None, method="GET"
+    ):
+        expiration = self._morph_expiration(version, expiration)
+
+        signed_url = self.bucket.generate_signed_url(
+            expiration=expiration, method=method, client=Config.CLIENT, version=version
+        )
+
+        response = requests.get(signed_url)
+        self.assertEqual(response.status_code, 200)
+
+    def test_create_signed_list_blobs_url_v2(self):
+        self._create_signed_list_blobs_url_helper(version="v2")
+
+    def test_create_signed_list_blobs_url_v2_w_expiration(self):
+        now = datetime.datetime.utcnow()
+        delta = datetime.timedelta(seconds=10)
+
+        self._create_signed_list_blobs_url_helper(expiration=now + delta, version="v2")
+
+    def test_create_signed_list_blobs_url_v4(self):
+        self._create_signed_list_blobs_url_helper(version="v4")
+
+    def test_create_signed_list_blobs_url_v4_w_expiration(self):
+        now = datetime.datetime.utcnow()
+        delta = datetime.timedelta(seconds=10)
+        self._create_signed_list_blobs_url_helper(expiration=now + delta, version="v4")
+
+    def _create_signed_read_url_helper(
+        self,
+        blob_name="LogoToSign.jpg",
+        method="GET",
+        version="v2",
+        payload=None,
+        expiration=None,
+    ):
+        expiration = self._morph_expiration(version, expiration)
+
+        if payload is not None:
+            blob = self.bucket.blob(blob_name)
+            blob.upload_from_string(payload)
+        else:
+            blob = self.blob
+
+        signed_url = blob.generate_signed_url(
+            expiration=expiration, method=method, client=Config.CLIENT, version=version
+        )
+
+        response = requests.get(signed_url)
+        self.assertEqual(response.status_code, 200)
+        if payload is not None:
+            self.assertEqual(response.content, payload)
+        else:
+            self.assertEqual(response.content, self.BLOB_CONTENT)
+
+    def test_create_signed_read_url_v2(self):
+        self._create_signed_read_url_helper()
+
+    def test_create_signed_read_url_v4(self):
+        self._create_signed_read_url_helper(version="v4")
+
+    def test_create_signed_read_url_v2_w_expiration(self):
+        now = datetime.datetime.utcnow()
+        delta = datetime.timedelta(seconds=10)
+
+        self._create_signed_read_url_helper(expiration=now + delta)
+
+    def test_create_signed_read_url_v4_w_expiration(self):
+        now = datetime.datetime.utcnow()
+        delta = datetime.timedelta(seconds=10)
+        self._create_signed_read_url_helper(expiration=now + delta, version="v4")
+
+    def test_create_signed_read_url_v2_lowercase_method(self):
+        self._create_signed_read_url_helper(method="get")
+
+    def test_create_signed_read_url_v4_lowercase_method(self):
+        self._create_signed_read_url_helper(method="get", version="v4")
+
+    def test_create_signed_read_url_v2_w_non_ascii_name(self):
+        self._create_signed_read_url_helper(
+            blob_name=u"Caf\xe9.txt",
+            payload=b"Test signed URL for blob w/ non-ASCII name",
+        )
+
+    def test_create_signed_read_url_v4_w_non_ascii_name(self):
+        self._create_signed_read_url_helper(
+            blob_name=u"Caf\xe9.txt",
+            payload=b"Test signed URL for blob w/ non-ASCII name",
+            version="v4",
+        )
+
+    def _create_signed_delete_url_helper(self, version="v2", expiration=None):
+        expiration = self._morph_expiration(version, expiration)
+
+        blob = self.bucket.blob("DELETE_ME.txt")
+        blob.upload_from_string(b"DELETE ME!")
+
+        signed_delete_url = blob.generate_signed_url(
+            expiration=expiration,
+            method="DELETE",
+            client=Config.CLIENT,
+            version=version,
+        )
+
+        response = requests.request("DELETE", signed_delete_url)
+        self.assertEqual(response.status_code, 204)
+        self.assertEqual(response.content, b"")
+
+        self.assertFalse(blob.exists())
+
+    def test_create_signed_delete_url_v2(self):
+        self._create_signed_delete_url_helper()
+
+    def test_create_signed_delete_url_v4(self):
+        self._create_signed_delete_url_helper(version="v4")
+
+    def _signed_resumable_upload_url_helper(self, version="v2", expiration=None):
+        expiration = self._morph_expiration(version, expiration)
+        blob = self.bucket.blob("cruddy.txt")
+        payload = b"DEADBEEF"
+
+        # Initiate the upload using a signed URL.
+        signed_resumable_upload_url = blob.generate_signed_url(
+            expiration=expiration,
+            method="RESUMABLE",
+            client=Config.CLIENT,
+            version=version,
+        )
+
+        post_headers = {"x-goog-resumable": "start"}
+        post_response = requests.post(signed_resumable_upload_url, headers=post_headers)
+        self.assertEqual(post_response.status_code, 201)
+
+        # Finish uploading the body.
+        location = post_response.headers["Location"]
+        put_headers = {"content-length": str(len(payload))}
+        put_response = requests.put(location, headers=put_headers, data=payload)
+        self.assertEqual(put_response.status_code, 200)
+
+        # Download using a signed URL and verify.
+        signed_download_url = blob.generate_signed_url(
+            expiration=expiration, method="GET", client=Config.CLIENT, version=version
+        )
+
+        get_response = requests.get(signed_download_url)
+        self.assertEqual(get_response.status_code, 200)
+        self.assertEqual(get_response.content, payload)
+
+        # Finally, delete the blob using a signed URL.
+        signed_delete_url = blob.generate_signed_url(
+            expiration=expiration,
+            method="DELETE",
+            client=Config.CLIENT,
+            version=version,
+        )
+
+        delete_response = requests.delete(signed_delete_url)
+        self.assertEqual(delete_response.status_code, 204)
+
+    def test_signed_resumable_upload_url_v2(self):
+        self._signed_resumable_upload_url_helper(version="v2")
+
+    def test_signed_resumable_upload_url_v4(self):
+        self._signed_resumable_upload_url_helper(version="v4")
+
+
+class TestStorageCompose(TestStorageFiles):
+
+    FILES = {}
+
+    def test_compose_create_new_blob(self):
+        SOURCE_1 = b"AAA\n"
+        source_1 = self.bucket.blob("source-1")
+        source_1.upload_from_string(SOURCE_1)
+        self.case_blobs_to_delete.append(source_1)
+
+        SOURCE_2 = b"BBB\n"
+        source_2 = self.bucket.blob("source-2")
+        source_2.upload_from_string(SOURCE_2)
+        self.case_blobs_to_delete.append(source_2)
+
+        destination = self.bucket.blob("destination")
+        destination.content_type = "text/plain"
+        destination.compose([source_1, source_2])
+        self.case_blobs_to_delete.append(destination)
+
+        composed = destination.download_as_string()
+        self.assertEqual(composed, SOURCE_1 + SOURCE_2)
+
+    def test_compose_create_new_blob_wo_content_type(self):
+        SOURCE_1 = b"AAA\n"
+        source_1 = self.bucket.blob("source-1")
+        source_1.upload_from_string(SOURCE_1)
+        self.case_blobs_to_delete.append(source_1)
+
+        SOURCE_2 = b"BBB\n"
+        source_2 = self.bucket.blob("source-2")
+        source_2.upload_from_string(SOURCE_2)
+        self.case_blobs_to_delete.append(source_2)
+
+        destination = self.bucket.blob("destination")
+
+        destination.compose([source_1, source_2])
+        self.case_blobs_to_delete.append(destination)
+
+        self.assertIsNone(destination.content_type)
+        composed = destination.download_as_string()
+        self.assertEqual(composed, SOURCE_1 + SOURCE_2)
+
+    def test_compose_replace_existing_blob(self):
+        BEFORE = b"AAA\n"
+        original = self.bucket.blob("original")
+        original.content_type = "text/plain"
+        original.upload_from_string(BEFORE)
+        self.case_blobs_to_delete.append(original)
+
+        TO_APPEND = b"BBB\n"
+        to_append = self.bucket.blob("to_append")
+        to_append.upload_from_string(TO_APPEND)
+        self.case_blobs_to_delete.append(to_append)
+
+        original.compose([original, to_append])
+
+        composed = original.download_as_string()
+        self.assertEqual(composed, BEFORE + TO_APPEND)
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_compose_with_user_project(self):
+        new_bucket_name = "compose-user-project" + unique_resource_id("-")
+        created = retry_429(Config.CLIENT.create_bucket)(
+            new_bucket_name, requester_pays=True
+        )
+        try:
+            SOURCE_1 = b"AAA\n"
+            source_1 = created.blob("source-1")
+            source_1.upload_from_string(SOURCE_1)
+
+            SOURCE_2 = b"BBB\n"
+            source_2 = created.blob("source-2")
+            source_2.upload_from_string(SOURCE_2)
+
+            with_user_project = Config.CLIENT.bucket(
+                new_bucket_name, user_project=USER_PROJECT
+            )
+
+            destination = with_user_project.blob("destination")
+            destination.content_type = "text/plain"
+            destination.compose([source_1, source_2])
+
+            composed = destination.download_as_string()
+            self.assertEqual(composed, SOURCE_1 + SOURCE_2)
+        finally:
+            retry_429_harder(created.delete)(force=True)
+
+
+class TestStorageRewrite(TestStorageFiles):
+
+    FILENAMES = ("file01.txt",)
+
+    def test_rewrite_create_new_blob_add_encryption_key(self):
+        file_data = self.FILES["simple"]
+
+        source = self.bucket.blob("source")
+        source.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(source)
+        source_data = source.download_as_string()
+
+        KEY = os.urandom(32)
+        dest = self.bucket.blob("dest", encryption_key=KEY)
+        token, rewritten, total = dest.rewrite(source)
+        self.case_blobs_to_delete.append(dest)
+
+        self.assertEqual(token, None)
+        self.assertEqual(rewritten, len(source_data))
+        self.assertEqual(total, len(source_data))
+
+        self.assertEqual(source.download_as_string(), dest.download_as_string())
+
+    def test_rewrite_rotate_encryption_key(self):
+        BLOB_NAME = "rotating-keys"
+        file_data = self.FILES["simple"]
+
+        SOURCE_KEY = os.urandom(32)
+        source = self.bucket.blob(BLOB_NAME, encryption_key=SOURCE_KEY)
+        source.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(source)
+        source_data = source.download_as_string()
+
+        DEST_KEY = os.urandom(32)
+        dest = self.bucket.blob(BLOB_NAME, encryption_key=DEST_KEY)
+        token, rewritten, total = dest.rewrite(source)
+        # Not adding 'dest' to 'self.case_blobs_to_delete':  it is the
+        # same object as 'source'.
+
+        self.assertIsNone(token)
+        self.assertEqual(rewritten, len(source_data))
+        self.assertEqual(total, len(source_data))
+
+        self.assertEqual(dest.download_as_string(), source_data)
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_rewrite_add_key_with_user_project(self):
+        file_data = self.FILES["simple"]
+        new_bucket_name = "rewrite-key-up" + unique_resource_id("-")
+        created = retry_429(Config.CLIENT.create_bucket)(
+            new_bucket_name, requester_pays=True
+        )
+        try:
+            with_user_project = Config.CLIENT.bucket(
+                new_bucket_name, user_project=USER_PROJECT
+            )
+
+            source = with_user_project.blob("source")
+            source.upload_from_filename(file_data["path"])
+            source_data = source.download_as_string()
+
+            KEY = os.urandom(32)
+            dest = with_user_project.blob("dest", encryption_key=KEY)
+            token, rewritten, total = dest.rewrite(source)
+
+            self.assertEqual(token, None)
+            self.assertEqual(rewritten, len(source_data))
+            self.assertEqual(total, len(source_data))
+
+            self.assertEqual(source.download_as_string(), dest.download_as_string())
+        finally:
+            retry_429_harder(created.delete)(force=True)
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_rewrite_rotate_with_user_project(self):
+        BLOB_NAME = "rotating-keys"
+        file_data = self.FILES["simple"]
+        new_bucket_name = "rewrite-rotate-up" + unique_resource_id("-")
+        created = retry_429(Config.CLIENT.create_bucket)(
+            new_bucket_name, requester_pays=True
+        )
+        try:
+            with_user_project = Config.CLIENT.bucket(
+                new_bucket_name, user_project=USER_PROJECT
+            )
+
+            SOURCE_KEY = os.urandom(32)
+            source = with_user_project.blob(BLOB_NAME, encryption_key=SOURCE_KEY)
+            source.upload_from_filename(file_data["path"])
+            source_data = source.download_as_string()
+
+            DEST_KEY = os.urandom(32)
+            dest = with_user_project.blob(BLOB_NAME, encryption_key=DEST_KEY)
+            token, rewritten, total = dest.rewrite(source)
+
+            self.assertEqual(token, None)
+            self.assertEqual(rewritten, len(source_data))
+            self.assertEqual(total, len(source_data))
+
+            self.assertEqual(dest.download_as_string(), source_data)
+        finally:
+            retry_429_harder(created.delete)(force=True)
+
+
+class TestStorageUpdateStorageClass(TestStorageFiles):
+    def test_update_storage_class_small_file(self):
+        blob = self.bucket.blob("SmallFile")
+
+        file_data = self.FILES["simple"]
+        blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(blob)
+
+        blob.update_storage_class("NEARLINE")
+        blob.reload()
+        self.assertEqual(blob.storage_class, "NEARLINE")
+
+        blob.update_storage_class("COLDLINE")
+        blob.reload()
+        self.assertEqual(blob.storage_class, "COLDLINE")
+
+    def test_update_storage_class_large_file(self):
+        blob = self.bucket.blob("BigFile")
+
+        file_data = self.FILES["big"]
+        blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(blob)
+
+        blob.update_storage_class("NEARLINE")
+        blob.reload()
+        self.assertEqual(blob.storage_class, "NEARLINE")
+
+        blob.update_storage_class("COLDLINE")
+        blob.reload()
+        self.assertEqual(blob.storage_class, "COLDLINE")
+
+
+class TestStorageNotificationCRUD(unittest.TestCase):
+
+    topic = None
+    TOPIC_NAME = "notification" + unique_resource_id("-")
+    CUSTOM_ATTRIBUTES = {"attr1": "value1", "attr2": "value2"}
+    BLOB_NAME_PREFIX = "blob-name-prefix/"
+
+    @property
+    def topic_path(self):
+        return "projects/{}/topics/{}".format(Config.CLIENT.project, self.TOPIC_NAME)
+
+    def _initialize_topic(self):
+        try:
+            from google.cloud.pubsub_v1 import PublisherClient
+        except ImportError:
+            raise unittest.SkipTest("Cannot import pubsub")
+        self.publisher_client = PublisherClient()
+        retry_429(self.publisher_client.create_topic)(self.topic_path)
+        policy = self.publisher_client.get_iam_policy(self.topic_path)
+        binding = policy.bindings.add()
+        binding.role = "roles/pubsub.publisher"
+        binding.members.append(
+            "serviceAccount:{}".format(Config.CLIENT.get_service_account_email())
+        )
+        self.publisher_client.set_iam_policy(self.topic_path, policy)
+
+    def setUp(self):
+        self.case_buckets_to_delete = []
+        self._initialize_topic()
+
+    def tearDown(self):
+        retry_429(self.publisher_client.delete_topic)(self.topic_path)
+        with Config.CLIENT.batch():
+            for bucket_name in self.case_buckets_to_delete:
+                bucket = Config.CLIENT.bucket(bucket_name)
+                retry_429_harder(bucket.delete)()
+
+    @staticmethod
+    def event_types():
+        from google.cloud.storage.notification import (
+            OBJECT_FINALIZE_EVENT_TYPE,
+            OBJECT_DELETE_EVENT_TYPE,
+        )
+
+        return [OBJECT_FINALIZE_EVENT_TYPE, OBJECT_DELETE_EVENT_TYPE]
+
+    @staticmethod
+    def payload_format():
+        from google.cloud.storage.notification import JSON_API_V1_PAYLOAD_FORMAT
+
+        return JSON_API_V1_PAYLOAD_FORMAT
+
+    def test_notification_minimal(self):
+        new_bucket_name = "notification-minimal" + unique_resource_id("-")
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+        self.assertEqual(list(bucket.list_notifications()), [])
+        notification = bucket.notification(self.TOPIC_NAME)
+        retry_429_503(notification.create)()
+        try:
+            self.assertTrue(notification.exists())
+            self.assertIsNotNone(notification.notification_id)
+            notifications = list(bucket.list_notifications())
+            self.assertEqual(len(notifications), 1)
+            self.assertEqual(notifications[0].topic_name, self.TOPIC_NAME)
+        finally:
+            notification.delete()
+
+    def test_notification_explicit(self):
+        new_bucket_name = "notification-explicit" + unique_resource_id("-")
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+        notification = bucket.notification(
+            self.TOPIC_NAME,
+            custom_attributes=self.CUSTOM_ATTRIBUTES,
+            event_types=self.event_types(),
+            blob_name_prefix=self.BLOB_NAME_PREFIX,
+            payload_format=self.payload_format(),
+        )
+        retry_429_503(notification.create)()
+        try:
+            self.assertTrue(notification.exists())
+            self.assertIsNotNone(notification.notification_id)
+            self.assertEqual(notification.custom_attributes, self.CUSTOM_ATTRIBUTES)
+            self.assertEqual(notification.event_types, self.event_types())
+            self.assertEqual(notification.blob_name_prefix, self.BLOB_NAME_PREFIX)
+            self.assertEqual(notification.payload_format, self.payload_format())
+        finally:
+            notification.delete()
+
+    @unittest.skipUnless(USER_PROJECT, "USER_PROJECT not set in environment.")
+    def test_notification_w_user_project(self):
+        new_bucket_name = "notification-minimal" + unique_resource_id("-")
+        retry_429(Config.CLIENT.create_bucket)(new_bucket_name, requester_pays=True)
+        self.case_buckets_to_delete.append(new_bucket_name)
+        with_user_project = Config.CLIENT.bucket(
+            new_bucket_name, user_project=USER_PROJECT
+        )
+        self.assertEqual(list(with_user_project.list_notifications()), [])
+        notification = with_user_project.notification(self.TOPIC_NAME)
+        retry_429(notification.create)()
+        try:
+            self.assertTrue(notification.exists())
+            self.assertIsNotNone(notification.notification_id)
+            notifications = list(with_user_project.list_notifications())
+            self.assertEqual(len(notifications), 1)
+            self.assertEqual(notifications[0].topic_name, self.TOPIC_NAME)
+        finally:
+            notification.delete()
+
+
+class TestAnonymousClient(unittest.TestCase):
+
+    PUBLIC_BUCKET = "gcp-public-data-landsat"
+
+    @unittest.skipIf(RUNNING_IN_VPCSC, "Test is not VPCSC compatible.")
+    def test_access_to_public_bucket(self):
+        anonymous = storage.Client.create_anonymous_client()
+        bucket = anonymous.bucket(self.PUBLIC_BUCKET)
+        blob, = retry_429_503(bucket.list_blobs)(max_results=1)
+        with tempfile.TemporaryFile() as stream:
+            retry_429_503(blob.download_to_file)(stream)
+
+
+class TestKMSIntegration(TestStorageFiles):
+
+    FILENAMES = ("file01.txt",)
+
+    KEYRING_NAME = "gcs-test"
+    KEY_NAME = "gcs-test"
+    ALT_KEY_NAME = "gcs-test-alternate"
+
+    def _kms_key_name(self, key_name=None):
+        if key_name is None:
+            key_name = self.KEY_NAME
+
+        return ("projects/{}/" "locations/{}/" "keyRings/{}/" "cryptoKeys/{}").format(
+            Config.CLIENT.project,
+            self.bucket.location.lower(),
+            self.KEYRING_NAME,
+            key_name,
+        )
+
+    @classmethod
+    def setUpClass(cls):
+        super(TestKMSIntegration, cls).setUpClass()
+        _empty_bucket(cls.bucket)
+
+    def setUp(self):
+        super(TestKMSIntegration, self).setUp()
+        client = kms.KeyManagementServiceClient()
+        project = Config.CLIENT.project
+        location = self.bucket.location.lower()
+        keyring_name = self.KEYRING_NAME
+        purpose = kms.enums.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT
+
+        # If the keyring doesn't exist create it.
+        keyring_path = client.key_ring_path(project, location, keyring_name)
+
+        try:
+            client.get_key_ring(keyring_path)
+        except exceptions.NotFound:
+            parent = client.location_path(project, location)
+            client.create_key_ring(parent, keyring_name, {})
+
+            # Mark this service account as an owner of the new keyring
+            service_account = Config.CLIENT.get_service_account_email()
+            policy = {
+                "bindings": [
+                    {
+                        "role": "roles/cloudkms.cryptoKeyEncrypterDecrypter",
+                        "members": ["serviceAccount:" + service_account],
+                    }
+                ]
+            }
+            client.set_iam_policy(keyring_path, policy)
+
+        # Populate the keyring with the keys we use in the tests
+        key_names = [
+            "gcs-test",
+            "gcs-test-alternate",
+            "explicit-kms-key-name",
+            "default-kms-key-name",
+            "override-default-kms-key-name",
+            "alt-default-kms-key-name",
+        ]
+        for key_name in key_names:
+            key_path = client.crypto_key_path(project, location, keyring_name, key_name)
+            try:
+                client.get_crypto_key(key_path)
+            except exceptions.NotFound:
+                key = {"purpose": purpose}
+                client.create_crypto_key(keyring_path, key_name, key)
+
+    def test_blob_w_explicit_kms_key_name(self):
+        BLOB_NAME = "explicit-kms-key-name"
+        file_data = self.FILES["simple"]
+        kms_key_name = self._kms_key_name()
+        blob = self.bucket.blob(BLOB_NAME, kms_key_name=kms_key_name)
+        blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(blob)
+        with open(file_data["path"], "rb") as _file_data:
+            self.assertEqual(blob.download_as_string(), _file_data.read())
+        # We don't know the current version of the key.
+        self.assertTrue(blob.kms_key_name.startswith(kms_key_name))
+
+        listed, = list(self.bucket.list_blobs())
+        self.assertTrue(listed.kms_key_name.startswith(kms_key_name))
+
+    def test_bucket_w_default_kms_key_name(self):
+        BLOB_NAME = "default-kms-key-name"
+        OVERRIDE_BLOB_NAME = "override-default-kms-key-name"
+        ALT_BLOB_NAME = "alt-default-kms-key-name"
+        CLEARTEXT_BLOB_NAME = "cleartext"
+
+        file_data = self.FILES["simple"]
+
+        with open(file_data["path"], "rb") as _file_data:
+            contents = _file_data.read()
+
+        kms_key_name = self._kms_key_name()
+        self.bucket.default_kms_key_name = kms_key_name
+        self.bucket.patch()
+        self.assertEqual(self.bucket.default_kms_key_name, kms_key_name)
+
+        defaulted_blob = self.bucket.blob(BLOB_NAME)
+        defaulted_blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(defaulted_blob)
+
+        self.assertEqual(defaulted_blob.download_as_string(), contents)
+        # We don't know the current version of the key.
+        self.assertTrue(defaulted_blob.kms_key_name.startswith(kms_key_name))
+
+        alt_kms_key_name = self._kms_key_name(self.ALT_KEY_NAME)
+
+        override_blob = self.bucket.blob(
+            OVERRIDE_BLOB_NAME, kms_key_name=alt_kms_key_name
+        )
+        override_blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(override_blob)
+
+        self.assertEqual(override_blob.download_as_string(), contents)
+        # We don't know the current version of the key.
+        self.assertTrue(override_blob.kms_key_name.startswith(alt_kms_key_name))
+
+        self.bucket.default_kms_key_name = alt_kms_key_name
+        self.bucket.patch()
+
+        alt_blob = self.bucket.blob(ALT_BLOB_NAME)
+        alt_blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(alt_blob)
+
+        self.assertEqual(alt_blob.download_as_string(), contents)
+        # We don't know the current version of the key.
+        self.assertTrue(alt_blob.kms_key_name.startswith(alt_kms_key_name))
+
+        self.bucket.default_kms_key_name = None
+        self.bucket.patch()
+
+        cleartext_blob = self.bucket.blob(CLEARTEXT_BLOB_NAME)
+        cleartext_blob.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(cleartext_blob)
+
+        self.assertEqual(cleartext_blob.download_as_string(), contents)
+        self.assertIsNone(cleartext_blob.kms_key_name)
+
+    def test_rewrite_rotate_csek_to_cmek(self):
+        BLOB_NAME = "rotating-keys"
+        file_data = self.FILES["simple"]
+
+        SOURCE_KEY = os.urandom(32)
+        source = self.bucket.blob(BLOB_NAME, encryption_key=SOURCE_KEY)
+        source.upload_from_filename(file_data["path"])
+        self.case_blobs_to_delete.append(source)
+        source_data = source.download_as_string()
+
+        kms_key_name = self._kms_key_name()
+
+        # We can't verify it, but ideally we would check that the following
+        # URL was resolvable with our credentials
+        # KEY_URL = 'https://cloudkms.googleapis.com/v1/{}'.format(
+        #     kms_key_name)
+
+        dest = self.bucket.blob(BLOB_NAME, kms_key_name=kms_key_name)
+        token, rewritten, total = dest.rewrite(source)
+
+        while token is not None:
+            token, rewritten, total = dest.rewrite(source, token=token)
+
+        # Not adding 'dest' to 'self.case_blobs_to_delete':  it is the
+        # same object as 'source'.
+
+        self.assertIsNone(token)
+        self.assertEqual(rewritten, len(source_data))
+        self.assertEqual(total, len(source_data))
+
+        self.assertEqual(dest.download_as_string(), source_data)
+
+
+class TestRetentionPolicy(unittest.TestCase):
+    def setUp(self):
+        self.case_buckets_to_delete = []
+
+    def tearDown(self):
+        for bucket_name in self.case_buckets_to_delete:
+            bucket = Config.CLIENT.bucket(bucket_name)
+            retry_429_harder(bucket.delete)()
+
+    def test_bucket_w_retention_period(self):
+        import datetime
+        from google.api_core import exceptions
+
+        period_secs = 10
+
+        new_bucket_name = "w-retention-period" + unique_resource_id("-")
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        bucket.retention_period = period_secs
+        bucket.default_event_based_hold = False
+        bucket.patch()
+
+        self.assertEqual(bucket.retention_period, period_secs)
+        self.assertIsInstance(bucket.retention_policy_effective_time, datetime.datetime)
+        self.assertFalse(bucket.default_event_based_hold)
+        self.assertFalse(bucket.retention_policy_locked)
+
+        blob_name = "test-blob"
+        payload = b"DEADBEEF"
+        blob = bucket.blob(blob_name)
+        blob.upload_from_string(payload)
+
+        other = bucket.get_blob(blob_name)
+
+        self.assertFalse(other.event_based_hold)
+        self.assertFalse(other.temporary_hold)
+        self.assertIsInstance(other.retention_expiration_time, datetime.datetime)
+
+        with self.assertRaises(exceptions.Forbidden):
+            other.delete()
+
+        bucket.retention_period = None
+        bucket.patch()
+
+        self.assertIsNone(bucket.retention_period)
+        self.assertIsNone(bucket.retention_policy_effective_time)
+        self.assertFalse(bucket.default_event_based_hold)
+        self.assertFalse(bucket.retention_policy_locked)
+
+        other.reload()
+
+        self.assertFalse(other.event_based_hold)
+        self.assertFalse(other.temporary_hold)
+        self.assertIsNone(other.retention_expiration_time)
+
+        other.delete()
+
+    def test_bucket_w_default_event_based_hold(self):
+        from google.api_core import exceptions
+
+        new_bucket_name = "w-def-ebh" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        bucket.default_event_based_hold = True
+        bucket.patch()
+
+        self.assertTrue(bucket.default_event_based_hold)
+        self.assertIsNone(bucket.retention_period)
+        self.assertIsNone(bucket.retention_policy_effective_time)
+        self.assertFalse(bucket.retention_policy_locked)
+
+        blob_name = "test-blob"
+        payload = b"DEADBEEF"
+        blob = bucket.blob(blob_name)
+        blob.upload_from_string(payload)
+
+        other = bucket.get_blob(blob_name)
+
+        self.assertTrue(other.event_based_hold)
+        self.assertFalse(other.temporary_hold)
+        self.assertIsNone(other.retention_expiration_time)
+
+        with self.assertRaises(exceptions.Forbidden):
+            other.delete()
+
+        other.event_based_hold = False
+        other.patch()
+
+        other.delete()
+
+        bucket.default_event_based_hold = False
+        bucket.patch()
+
+        self.assertFalse(bucket.default_event_based_hold)
+        self.assertIsNone(bucket.retention_period)
+        self.assertIsNone(bucket.retention_policy_effective_time)
+        self.assertFalse(bucket.retention_policy_locked)
+
+        blob.upload_from_string(payload)
+        self.assertFalse(other.event_based_hold)
+        self.assertFalse(other.temporary_hold)
+        self.assertIsNone(other.retention_expiration_time)
+
+        blob.delete()
+
+    def test_blob_w_temporary_hold(self):
+        from google.api_core import exceptions
+
+        new_bucket_name = "w-tmp-hold" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        blob_name = "test-blob"
+        payload = b"DEADBEEF"
+        blob = bucket.blob(blob_name)
+        blob.upload_from_string(payload)
+
+        other = bucket.get_blob(blob_name)
+        other.temporary_hold = True
+        other.patch()
+
+        self.assertTrue(other.temporary_hold)
+        self.assertFalse(other.event_based_hold)
+        self.assertIsNone(other.retention_expiration_time)
+
+        with self.assertRaises(exceptions.Forbidden):
+            other.delete()
+
+        other.temporary_hold = False
+        other.patch()
+
+        other.delete()
+
+    def test_bucket_lock_retention_policy(self):
+        import datetime
+        from google.api_core import exceptions
+
+        period_secs = 10
+
+        new_bucket_name = "loc-ret-policy" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        bucket.retention_period = period_secs
+        bucket.patch()
+
+        self.assertEqual(bucket.retention_period, period_secs)
+        self.assertIsInstance(bucket.retention_policy_effective_time, datetime.datetime)
+        self.assertFalse(bucket.default_event_based_hold)
+        self.assertFalse(bucket.retention_policy_locked)
+
+        bucket.lock_retention_policy()
+
+        bucket.reload()
+        self.assertTrue(bucket.retention_policy_locked)
+
+        bucket.retention_period = None
+        with self.assertRaises(exceptions.Forbidden):
+            bucket.patch()
+
+
+class TestIAMConfiguration(unittest.TestCase):
+    def setUp(self):
+        self.case_buckets_to_delete = []
+
+    def tearDown(self):
+        for bucket_name in self.case_buckets_to_delete:
+            bucket = Config.CLIENT.bucket(bucket_name)
+            retry_429_harder(bucket.delete)(force=True)
+
+    def test_new_bucket_w_bpo(self):
+        new_bucket_name = "new-w-bpo" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        bucket = Config.CLIENT.bucket(new_bucket_name)
+        bucket.iam_configuration.bucket_policy_only_enabled = True
+        retry_429(bucket.create)()
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        bucket_acl = bucket.acl
+        with self.assertRaises(exceptions.BadRequest):
+            bucket_acl.reload()
+
+        bucket_acl.loaded = True  # Fake that we somehow loaded the ACL
+        bucket_acl.all().grant_read()
+        with self.assertRaises(exceptions.BadRequest):
+            bucket_acl.save()
+
+        blob_name = "my-blob.txt"
+        blob = bucket.blob(blob_name)
+        payload = b"DEADBEEF"
+        blob.upload_from_string(payload)
+
+        found = bucket.get_blob(blob_name)
+        self.assertEqual(found.download_as_string(), payload)
+
+        blob_acl = blob.acl
+        with self.assertRaises(exceptions.BadRequest):
+            blob_acl.reload()
+
+        blob_acl.loaded = True  # Fake that we somehow loaded the ACL
+        blob_acl.all().grant_read()
+        with self.assertRaises(exceptions.BadRequest):
+            blob_acl.save()
+
+    @unittest.skipUnless(False, "Back-end fix for BPO/UBLA expected 2019-07-12")
+    def test_bpo_set_unset_preserves_acls(self):
+        new_bucket_name = "bpo-acls" + unique_resource_id("-")
+        self.assertRaises(
+            exceptions.NotFound, Config.CLIENT.get_bucket, new_bucket_name
+        )
+        bucket = retry_429(Config.CLIENT.create_bucket)(new_bucket_name)
+        self.case_buckets_to_delete.append(new_bucket_name)
+
+        blob_name = "my-blob.txt"
+        blob = bucket.blob(blob_name)
+        payload = b"DEADBEEF"
+        blob.upload_from_string(payload)
+
+        # Preserve ACLs before setting BPO
+        bucket_acl_before = list(bucket.acl)
+        blob_acl_before = list(bucket.acl)
+
+        # Set BPO
+        bucket.iam_configuration.bucket_policy_only_enabled = True
+        bucket.patch()
+
+        self.assertTrue(bucket.iam_configuration.bucket_policy_only_enabled)
+
+        # While BPO is set, cannot get / set ACLs
+        with self.assertRaises(exceptions.BadRequest):
+            bucket.acl.reload()
+
+        # Clear BPO
+        bucket.iam_configuration.bucket_policy_only_enabled = False
+        bucket.patch()
+
+        # Query ACLs after clearing BPO
+        bucket.acl.reload()
+        bucket_acl_after = list(bucket.acl)
+        blob.acl.reload()
+        blob_acl_after = list(bucket.acl)
+
+        self.assertEqual(bucket_acl_before, bucket_acl_after)
+        self.assertEqual(blob_acl_before, blob_acl_after)
diff --git a/storage/tests/unit/__init__.py b/storage/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/storage/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/storage/tests/unit/test__helpers.py b/storage/tests/unit/test__helpers.py
new file mode 100644
index 000000000000..fb8d78cbb637
--- /dev/null
+++ b/storage/tests/unit/test__helpers.py
@@ -0,0 +1,352 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class Test_PropertyMixin(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage._helpers import _PropertyMixin
+
+        return _PropertyMixin
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _derivedClass(self, path=None, user_project=None):
+        class Derived(self._get_target_class()):
+
+            client = None
+
+            @property
+            def path(self):
+                return path
+
+            @property
+            def user_project(self):
+                return user_project
+
+        return Derived
+
+    def test_path_is_abstract(self):
+        mixin = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            mixin.path
+
+    def test_client_is_abstract(self):
+        mixin = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            mixin.client
+
+    def test_user_project_is_abstract(self):
+        mixin = self._make_one()
+        with self.assertRaises(NotImplementedError):
+            mixin.user_project
+
+    def test__encryption_headers(self):
+        mixin = self._make_one()
+        self.assertEqual(mixin._encryption_headers(), {})
+
+    def test__query_params_wo_user_project(self):
+        derived = self._derivedClass("/path", None)()
+        self.assertEqual(derived._query_params, {})
+
+    def test__query_params_w_user_project(self):
+        user_project = "user-project-123"
+        derived = self._derivedClass("/path", user_project)()
+        self.assertEqual(derived._query_params, {"userProject": user_project})
+
+    def test_reload(self):
+        connection = _Connection({"foo": "Foo"})
+        client = _Client(connection)
+        derived = self._derivedClass("/path")()
+        # Make sure changes is not a set instance before calling reload
+        # (which will clear / replace it with an empty set), checked below.
+        derived._changes = object()
+        derived.reload(client=client)
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "GET",
+                "path": "/path",
+                "query_params": {"projection": "noAcl"},
+                "headers": {},
+                "_target_object": derived,
+            },
+        )
+        self.assertEqual(derived._changes, set())
+
+    def test_reload_w_user_project(self):
+        user_project = "user-project-123"
+        connection = _Connection({"foo": "Foo"})
+        client = _Client(connection)
+        derived = self._derivedClass("/path", user_project)()
+        # Make sure changes is not a set instance before calling reload
+        # (which will clear / replace it with an empty set), checked below.
+        derived._changes = object()
+        derived.reload(client=client)
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "GET",
+                "path": "/path",
+                "query_params": {"projection": "noAcl", "userProject": user_project},
+                "headers": {},
+                "_target_object": derived,
+            },
+        )
+        self.assertEqual(derived._changes, set())
+
+    def test__set_properties(self):
+        mixin = self._make_one()
+        self.assertEqual(mixin._properties, {})
+        VALUE = object()
+        mixin._set_properties(VALUE)
+        self.assertEqual(mixin._properties, VALUE)
+
+    def test__patch_property(self):
+        derived = self._derivedClass()()
+        derived._patch_property("foo", "Foo")
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+
+    def test_patch(self):
+        connection = _Connection({"foo": "Foo"})
+        client = _Client(connection)
+        derived = self._derivedClass("/path")()
+        # Make sure changes is non-empty, so we can observe a change.
+        BAR = object()
+        BAZ = object()
+        derived._properties = {"bar": BAR, "baz": BAZ}
+        derived._changes = set(["bar"])  # Ignore baz.
+        derived.patch(client=client)
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/path",
+                "query_params": {"projection": "full"},
+                # Since changes does not include `baz`, we don't see it sent.
+                "data": {"bar": BAR},
+                "_target_object": derived,
+            },
+        )
+        # Make sure changes get reset by patch().
+        self.assertEqual(derived._changes, set())
+
+    def test_patch_w_user_project(self):
+        user_project = "user-project-123"
+        connection = _Connection({"foo": "Foo"})
+        client = _Client(connection)
+        derived = self._derivedClass("/path", user_project)()
+        # Make sure changes is non-empty, so we can observe a change.
+        BAR = object()
+        BAZ = object()
+        derived._properties = {"bar": BAR, "baz": BAZ}
+        derived._changes = set(["bar"])  # Ignore baz.
+        derived.patch(client=client)
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/path",
+                "query_params": {"projection": "full", "userProject": user_project},
+                # Since changes does not include `baz`, we don't see it sent.
+                "data": {"bar": BAR},
+                "_target_object": derived,
+            },
+        )
+        # Make sure changes get reset by patch().
+        self.assertEqual(derived._changes, set())
+
+    def test_update(self):
+        connection = _Connection({"foo": "Foo"})
+        client = _Client(connection)
+        derived = self._derivedClass("/path")()
+        # Make sure changes is non-empty, so we can observe a change.
+        BAR = object()
+        BAZ = object()
+        derived._properties = {"bar": BAR, "baz": BAZ}
+        derived._changes = set(["bar"])  # Update sends 'baz' anyway.
+        derived.update(client=client)
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PUT")
+        self.assertEqual(kw[0]["path"], "/path")
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+        self.assertEqual(kw[0]["data"], {"bar": BAR, "baz": BAZ})
+        # Make sure changes get reset by patch().
+        self.assertEqual(derived._changes, set())
+
+    def test_update_w_user_project(self):
+        user_project = "user-project-123"
+        connection = _Connection({"foo": "Foo"})
+        client = _Client(connection)
+        derived = self._derivedClass("/path", user_project)()
+        # Make sure changes is non-empty, so we can observe a change.
+        BAR = object()
+        BAZ = object()
+        derived._properties = {"bar": BAR, "baz": BAZ}
+        derived._changes = set(["bar"])  # Update sends 'baz' anyway.
+        derived.update(client=client)
+        self.assertEqual(derived._properties, {"foo": "Foo"})
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PUT")
+        self.assertEqual(kw[0]["path"], "/path")
+        self.assertEqual(
+            kw[0]["query_params"], {"projection": "full", "userProject": user_project}
+        )
+        self.assertEqual(kw[0]["data"], {"bar": BAR, "baz": BAZ})
+        # Make sure changes get reset by patch().
+        self.assertEqual(derived._changes, set())
+
+
+class Test__scalar_property(unittest.TestCase):
+    def _call_fut(self, fieldName):
+        from google.cloud.storage._helpers import _scalar_property
+
+        return _scalar_property(fieldName)
+
+    def test_getter(self):
+        class Test(object):
+            def __init__(self, **kw):
+                self._properties = kw.copy()
+
+            do_re_mi = self._call_fut("solfege")
+
+        test = Test(solfege="Latido")
+        self.assertEqual(test.do_re_mi, "Latido")
+
+    def test_setter(self):
+        class Test(object):
+            def _patch_property(self, name, value):
+                self._patched = (name, value)
+
+            do_re_mi = self._call_fut("solfege")
+
+        test = Test()
+        test.do_re_mi = "Latido"
+        self.assertEqual(test._patched, ("solfege", "Latido"))
+
+
+class Test__base64_md5hash(unittest.TestCase):
+    def _call_fut(self, bytes_to_sign):
+        from google.cloud.storage._helpers import _base64_md5hash
+
+        return _base64_md5hash(bytes_to_sign)
+
+    def test_it(self):
+        from io import BytesIO
+
+        BYTES_TO_SIGN = b"FOO"
+        BUFFER = BytesIO()
+        BUFFER.write(BYTES_TO_SIGN)
+        BUFFER.seek(0)
+
+        SIGNED_CONTENT = self._call_fut(BUFFER)
+        self.assertEqual(SIGNED_CONTENT, b"kBiQqOnIz21aGlQrIp/r/w==")
+
+    def test_it_with_stubs(self):
+        import mock
+
+        class _Buffer(object):
+            def __init__(self, return_vals):
+                self.return_vals = return_vals
+                self._block_sizes = []
+
+            def read(self, block_size):
+                self._block_sizes.append(block_size)
+                return self.return_vals.pop()
+
+        BASE64 = _Base64()
+        DIGEST_VAL = object()
+        BYTES_TO_SIGN = b"BYTES_TO_SIGN"
+        BUFFER = _Buffer([b"", BYTES_TO_SIGN])
+        MD5 = _MD5(DIGEST_VAL)
+
+        patch = mock.patch.multiple(
+            "google.cloud.storage._helpers", base64=BASE64, md5=MD5
+        )
+        with patch:
+            SIGNED_CONTENT = self._call_fut(BUFFER)
+
+        self.assertEqual(BUFFER._block_sizes, [8192, 8192])
+        self.assertIs(SIGNED_CONTENT, DIGEST_VAL)
+        self.assertEqual(BASE64._called_b64encode, [DIGEST_VAL])
+        self.assertEqual(MD5._called, [None])
+        self.assertEqual(MD5.hash_obj.num_digest_calls, 1)
+        self.assertEqual(MD5.hash_obj._blocks, [BYTES_TO_SIGN])
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
+
+
+class _MD5Hash(object):
+    def __init__(self, digest_val):
+        self.digest_val = digest_val
+        self.num_digest_calls = 0
+        self._blocks = []
+
+    def update(self, block):
+        self._blocks.append(block)
+
+    def digest(self):
+        self.num_digest_calls += 1
+        return self.digest_val
+
+
+class _MD5(object):
+    def __init__(self, digest_val):
+        self.hash_obj = _MD5Hash(digest_val)
+        self._called = []
+
+    def __call__(self, data=None):
+        self._called.append(data)
+        return self.hash_obj
+
+
+class _Base64(object):
+    def __init__(self):
+        self._called_b64encode = []
+
+    def b64encode(self, value):
+        self._called_b64encode.append(value)
+        return value
+
+
+class _Client(object):
+    def __init__(self, connection):
+        self._connection = connection
diff --git a/storage/tests/unit/test__http.py b/storage/tests/unit/test__http.py
new file mode 100644
index 000000000000..5f61ea2d7a0b
--- /dev/null
+++ b/storage/tests/unit/test__http.py
@@ -0,0 +1,78 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_extra_headers(self):
+        import requests
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        req_data = "hey-yoooouuuuu-guuuuuyyssss"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
+
+    def test_build_api_url_no_extra_query_params(self):
+        conn = self._make_one(object())
+        URI = "/".join([conn.DEFAULT_API_ENDPOINT, "storage", conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_custom_endpoint(self):
+        custom_endpoint = "https://foo-googleapis.com"
+        conn = self._make_one(object(), api_endpoint=custom_endpoint)
+        URI = "/".join([custom_endpoint, "storage", conn.API_VERSION, "foo"])
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_extra_query_params(self):
+        from six.moves.urllib.parse import parse_qsl
+        from six.moves.urllib.parse import urlsplit
+
+        conn = self._make_one(object())
+        uri = conn.build_api_url("/foo", {"bar": "baz"})
+        scheme, netloc, path, qs, _ = urlsplit(uri)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        self.assertEqual(path, "/".join(["", "storage", conn.API_VERSION, "foo"]))
+        parms = dict(parse_qsl(qs))
+        self.assertEqual(parms["bar"], "baz")
diff --git a/storage/tests/unit/test__signing.py b/storage/tests/unit/test__signing.py
new file mode 100644
index 000000000000..f2609d63e428
--- /dev/null
+++ b/storage/tests/unit/test__signing.py
@@ -0,0 +1,699 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import binascii
+import calendar
+import datetime
+import io
+import json
+import os
+import time
+import unittest
+
+import mock
+import pytest
+import six
+from six.moves import urllib_parse
+
+
+def _read_local_json(json_file):
+    here = os.path.dirname(__file__)
+    json_path = os.path.abspath(os.path.join(here, json_file))
+    with io.open(json_path, "r", encoding="utf-8-sig") as fileobj:
+        return json.load(fileobj)
+
+
+_SERVICE_ACCOUNT_JSON = _read_local_json("url_signer_v4_test_account.json")
+_CONFORMANCE_TESTS = _read_local_json("url_signer_v4_test_data.json")
+_CLIENT_TESTS = [test for test in _CONFORMANCE_TESTS if "bucket" not in test]
+_BUCKET_TESTS = [
+    test for test in _CONFORMANCE_TESTS if "bucket" in test and not test.get("object")
+]
+_BLOB_TESTS = [
+    test for test in _CONFORMANCE_TESTS if "bucket" in test and test.get("object")
+]
+
+
+def _utc_seconds(when):
+    return int(calendar.timegm(when.timetuple()))
+
+
+class Test_get_expiration_seconds_v2(unittest.TestCase):
+    @staticmethod
+    def _call_fut(expiration):
+        from google.cloud.storage._signing import get_expiration_seconds_v2
+
+        return get_expiration_seconds_v2(expiration)
+
+    def test_w_invalid_expiration_type(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(object(), None)
+
+    def test_w_expiration_none(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None)
+
+    def test_w_expiration_int(self):
+        self.assertEqual(self._call_fut(123), 123)
+
+    def test_w_expiration_long(self):
+        if six.PY3:
+            raise unittest.SkipTest("No long on Python 3")
+
+        self.assertEqual(self._call_fut(long(123)), 123)  # noqa: F821
+
+    def test_w_expiration_naive_datetime(self):
+        expiration_no_tz = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        utc_seconds = _utc_seconds(expiration_no_tz)
+        self.assertEqual(self._call_fut(expiration_no_tz), utc_seconds)
+
+    def test_w_expiration_utc_datetime(self):
+        from google.cloud._helpers import UTC
+
+        expiration_utc = datetime.datetime(2004, 8, 19, 0, 0, 0, 0, UTC)
+        utc_seconds = _utc_seconds(expiration_utc)
+        self.assertEqual(self._call_fut(expiration_utc), utc_seconds)
+
+    def test_w_expiration_other_zone_datetime(self):
+        from google.cloud._helpers import _UTC
+
+        class CET(_UTC):
+            _tzname = "CET"
+            _utcoffset = datetime.timedelta(hours=1)
+
+        zone = CET()
+        expiration_other = datetime.datetime(2004, 8, 19, 0, 0, 0, 0, zone)
+        utc_seconds = _utc_seconds(expiration_other)
+        cet_seconds = utc_seconds - (60 * 60)  # CET one hour earlier than UTC
+        self.assertEqual(self._call_fut(expiration_other), cet_seconds)
+
+    def test_w_expiration_timedelta_seconds(self):
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        utc_seconds = _utc_seconds(dummy_utcnow)
+        expiration_as_delta = datetime.timedelta(seconds=10)
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+        with patch as utcnow:
+            result = self._call_fut(expiration_as_delta)
+
+        self.assertEqual(result, utc_seconds + 10)
+        utcnow.assert_called_once_with()
+
+    def test_w_expiration_timedelta_days(self):
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        utc_seconds = _utc_seconds(dummy_utcnow)
+        expiration_as_delta = datetime.timedelta(days=1)
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+        with patch as utcnow:
+            result = self._call_fut(expiration_as_delta)
+
+        self.assertEqual(result, utc_seconds + 86400)
+        utcnow.assert_called_once_with()
+
+
+class Test_get_expiration_seconds_v4(unittest.TestCase):
+    @staticmethod
+    def _call_fut(expiration):
+        from google.cloud.storage._signing import get_expiration_seconds_v4
+
+        return get_expiration_seconds_v4(expiration)
+
+    def test_w_invalid_expiration_type(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(object(), None)
+
+    def test_w_expiration_none(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None)
+
+    def test_w_expiration_int_gt_seven_days(self):
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        delta = datetime.timedelta(days=10)
+        expiration_utc = dummy_utcnow + delta
+        expiration_seconds = _utc_seconds(expiration_utc)
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+
+        with patch as utcnow:
+            with self.assertRaises(ValueError):
+                self._call_fut(expiration_seconds)
+        utcnow.assert_called_once_with()
+
+    def test_w_expiration_int(self):
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        expiration_seconds = 10
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+
+        with patch as utcnow:
+            result = self._call_fut(expiration_seconds)
+
+        self.assertEqual(result, expiration_seconds)
+        utcnow.assert_called_once_with()
+
+    def test_w_expiration_naive_datetime(self):
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        delta = datetime.timedelta(seconds=10)
+        expiration_no_tz = dummy_utcnow + delta
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+        with patch as utcnow:
+            result = self._call_fut(expiration_no_tz)
+
+        self.assertEqual(result, delta.seconds)
+        utcnow.assert_called_once_with()
+
+    def test_w_expiration_utc_datetime(self):
+        from google.cloud._helpers import UTC
+
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0, UTC)
+        delta = datetime.timedelta(seconds=10)
+        expiration_utc = dummy_utcnow + delta
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+        with patch as utcnow:
+            result = self._call_fut(expiration_utc)
+
+        self.assertEqual(result, delta.seconds)
+        utcnow.assert_called_once_with()
+
+    def test_w_expiration_other_zone_datetime(self):
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _UTC
+
+        class CET(_UTC):
+            _tzname = "CET"
+            _utcoffset = datetime.timedelta(hours=1)
+
+        zone = CET()
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0, UTC)
+        dummy_cetnow = dummy_utcnow.astimezone(zone)
+        delta = datetime.timedelta(seconds=10)
+        expiration_other = dummy_cetnow + delta
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+        with patch as utcnow:
+            result = self._call_fut(expiration_other)
+
+        self.assertEqual(result, delta.seconds)
+        utcnow.assert_called_once_with()
+
+    def test_w_expiration_timedelta(self):
+        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
+        expiration_as_delta = datetime.timedelta(seconds=10)
+
+        patch = mock.patch(
+            "google.cloud.storage._signing.NOW", return_value=dummy_utcnow
+        )
+        with patch as utcnow:
+            result = self._call_fut(expiration_as_delta)
+
+        self.assertEqual(result, expiration_as_delta.total_seconds())
+        utcnow.assert_called_once_with()
+
+
+class Test_get_signed_query_params_v2(unittest.TestCase):
+    @staticmethod
+    def _call_fut(credentials, expiration, string_to_sign):
+        from google.cloud.storage._signing import get_signed_query_params_v2
+
+        return get_signed_query_params_v2(credentials, expiration, string_to_sign)
+
+    def test_it(self):
+        sig_bytes = b"DEADBEEF"
+        account_name = mock.sentinel.service_account_email
+        credentials = _make_credentials(signer_email=account_name)
+        credentials.sign_bytes.return_value = sig_bytes
+        expiration = 100
+        string_to_sign = "dummy_signature"
+        result = self._call_fut(credentials, expiration, string_to_sign)
+
+        expected = {
+            "GoogleAccessId": account_name,
+            "Expires": str(expiration),
+            "Signature": base64.b64encode(sig_bytes),
+        }
+        self.assertEqual(result, expected)
+        credentials.sign_bytes.assert_called_once_with(string_to_sign)
+
+
+class Test_get_canonical_headers(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage._signing import get_canonical_headers
+
+        return get_canonical_headers(*args, **kwargs)
+
+    def test_w_none(self):
+        headers = None
+        expected_canonical = []
+        expected_ordered = []
+        canonical, ordered = self._call_fut(headers)
+        self.assertEqual(canonical, expected_canonical)
+        self.assertEqual(ordered, expected_ordered)
+
+    def test_w_dict(self):
+        headers = {"foo": "Foo 1.2.3", "Bar": " baz,bam,qux   "}
+        expected_canonical = ["bar:baz,bam,qux", "foo:Foo 1.2.3"]
+        expected_ordered = [tuple(item.split(":")) for item in expected_canonical]
+        canonical, ordered = self._call_fut(headers)
+        self.assertEqual(canonical, expected_canonical)
+        self.assertEqual(ordered, expected_ordered)
+
+    def test_w_list_and_multiples(self):
+        headers = [
+            ("foo", "Foo 1.2.3"),
+            ("Bar", " baz"),
+            ("Bar", "bam"),
+            ("Bar", "qux   "),
+        ]
+        expected_canonical = ["bar:baz,bam,qux", "foo:Foo 1.2.3"]
+        expected_ordered = [tuple(item.split(":")) for item in expected_canonical]
+        canonical, ordered = self._call_fut(headers)
+        self.assertEqual(canonical, expected_canonical)
+        self.assertEqual(ordered, expected_ordered)
+
+    def test_w_embedded_ws(self):
+        headers = {"foo": "Foo\n1.2.3", "Bar": "   baz   bam   qux   "}
+        expected_canonical = ["bar:baz bam qux", "foo:Foo 1.2.3"]
+        expected_ordered = [tuple(item.split(":")) for item in expected_canonical]
+        canonical, ordered = self._call_fut(headers)
+        self.assertEqual(canonical, expected_canonical)
+        self.assertEqual(ordered, expected_ordered)
+
+
+class Test_canonicalize(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage._signing import canonicalize
+
+        return canonicalize(*args, **kwargs)
+
+    def test_wo_headers_or_query_parameters(self):
+        method = "GET"
+        resource = "/bucket/blob"
+        canonical = self._call_fut(method, resource, None, None)
+        self.assertEqual(canonical.method, method)
+        self.assertEqual(canonical.resource, resource)
+        self.assertEqual(canonical.query_parameters, [])
+        self.assertEqual(canonical.headers, [])
+
+    def test_w_headers_and_resumable(self):
+        method = "RESUMABLE"
+        resource = "/bucket/blob"
+        headers = [("x-goog-extension", "foobar")]
+        canonical = self._call_fut(method, resource, None, headers)
+        self.assertEqual(canonical.method, "POST")
+        self.assertEqual(canonical.resource, resource)
+        self.assertEqual(canonical.query_parameters, [])
+        self.assertEqual(
+            canonical.headers, ["x-goog-extension:foobar", "x-goog-resumable:start"]
+        )
+
+    def test_w_query_paramters(self):
+        method = "GET"
+        resource = "/bucket/blob"
+        query_parameters = {"foo": "bar", "baz": "qux"}
+        canonical = self._call_fut(method, resource, query_parameters, None)
+        self.assertEqual(canonical.method, method)
+        self.assertEqual(canonical.resource, "{}?baz=qux&foo=bar".format(resource))
+        self.assertEqual(canonical.query_parameters, [("baz", "qux"), ("foo", "bar")])
+        self.assertEqual(canonical.headers, [])
+
+
+class Test_generate_signed_url_v2(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage._signing import generate_signed_url_v2
+
+        return generate_signed_url_v2(*args, **kwargs)
+
+    def _generate_helper(
+        self,
+        api_access_endpoint="",
+        method="GET",
+        content_md5=None,
+        content_type=None,
+        response_type=None,
+        response_disposition=None,
+        generation=None,
+        headers=None,
+        query_parameters=None,
+    ):
+        from six.moves.urllib.parse import urlencode
+
+        resource = "/name/path"
+        credentials = _make_credentials(signer_email="service@example.com")
+        credentials.sign_bytes.return_value = b"DEADBEEF"
+        signed = base64.b64encode(credentials.sign_bytes.return_value)
+        signed = signed.decode("ascii")
+
+        expiration = 1000
+
+        url = self._call_fut(
+            credentials,
+            resource,
+            expiration=expiration,
+            api_access_endpoint=api_access_endpoint,
+            method=method,
+            content_md5=content_md5,
+            content_type=content_type,
+            response_type=response_type,
+            response_disposition=response_disposition,
+            generation=generation,
+            headers=headers,
+            query_parameters=query_parameters,
+        )
+
+        # Check the mock was called.
+        method = method.upper()
+
+        if headers is None:
+            headers = []
+        elif isinstance(headers, dict):
+            headers = sorted(headers.items())
+
+        elements = []
+        expected_resource = resource
+        if method == "RESUMABLE":
+            elements.append("POST")
+            headers.append(("x-goog-resumable", "start"))
+        else:
+            elements.append(method)
+
+        if query_parameters is not None:
+            normalized_qp = {
+                key.lower(): value and value.strip() or ""
+                for key, value in query_parameters.items()
+            }
+            expected_qp = urlencode(sorted(normalized_qp.items()))
+            expected_resource = "{}?{}".format(resource, expected_qp)
+
+        elements.append(content_md5 or "")
+        elements.append(content_type or "")
+        elements.append(str(expiration))
+        elements.extend(["{}:{}".format(*header) for header in headers])
+        elements.append(expected_resource)
+
+        string_to_sign = "\n".join(elements)
+
+        credentials.sign_bytes.assert_called_once_with(string_to_sign)
+
+        scheme, netloc, path, qs, frag = urllib_parse.urlsplit(url)
+        expected_scheme, expected_netloc, _, _, _ = urllib_parse.urlsplit(
+            api_access_endpoint
+        )
+        self.assertEqual(scheme, expected_scheme)
+        self.assertEqual(netloc, expected_netloc)
+        self.assertEqual(path, resource)
+        self.assertEqual(frag, "")
+
+        # Check the URL parameters.
+        params = dict(urllib_parse.parse_qsl(qs, keep_blank_values=True))
+
+        self.assertEqual(params["GoogleAccessId"], credentials.signer_email)
+        self.assertEqual(params["Expires"], str(expiration))
+        self.assertEqual(params["Signature"], signed)
+
+        if response_type is not None:
+            self.assertEqual(params["response-content-type"], response_type)
+
+        if response_disposition is not None:
+            self.assertEqual(
+                params["response-content-disposition"], response_disposition
+            )
+
+        if generation is not None:
+            self.assertEqual(params["generation"], str(generation))
+
+        if query_parameters is not None:
+            for key, value in query_parameters.items():
+                value = value.strip() if value else ""
+                self.assertEqual(params[key].lower(), value)
+
+    def test_w_expiration_int(self):
+        self._generate_helper()
+
+    def test_w_endpoint(self):
+        api_access_endpoint = "https://api.example.com"
+        self._generate_helper(api_access_endpoint=api_access_endpoint)
+
+    def test_w_method(self):
+        method = "POST"
+        self._generate_helper(method=method)
+
+    def test_w_method_resumable(self):
+        method = "RESUMABLE"
+        self._generate_helper(method=method)
+
+    def test_w_response_type(self):
+        response_type = "text/plain"
+        self._generate_helper(response_type=response_type)
+
+    def test_w_response_disposition(self):
+        response_disposition = "attachment; filename=blob.png"
+        self._generate_helper(response_disposition=response_disposition)
+
+    def test_w_generation(self):
+        generation = "123"
+        self._generate_helper(generation=generation)
+
+    def test_w_custom_headers_dict(self):
+        self._generate_helper(headers={"x-goog-foo": "bar"})
+
+    def test_w_custom_headers_list(self):
+        self._generate_helper(headers=[("x-goog-foo", "bar")])
+
+    def test_w_custom_query_parameters_w_string_value(self):
+        self._generate_helper(query_parameters={"bar": "/"})
+
+    def test_w_custom_query_parameters_w_none_value(self):
+        self._generate_helper(query_parameters={"qux": None})
+
+    def test_with_google_credentials(self):
+        resource = "/name/path"
+        credentials = _make_credentials()
+        expiration = int(time.time() + 5)
+        with self.assertRaises(AttributeError):
+            self._call_fut(credentials, resource=resource, expiration=expiration)
+
+
+class Test_generate_signed_url_v4(unittest.TestCase):
+    DEFAULT_EXPIRATION = 1000
+
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage._signing import generate_signed_url_v4
+
+        return generate_signed_url_v4(*args, **kwargs)
+
+    def _generate_helper(
+        self,
+        expiration=DEFAULT_EXPIRATION,
+        api_access_endpoint="",
+        method="GET",
+        content_type=None,
+        content_md5=None,
+        response_type=None,
+        response_disposition=None,
+        generation=None,
+        headers=None,
+        query_parameters=None,
+    ):
+        now = datetime.datetime(2019, 2, 26, 19, 53, 27)
+        resource = "/name/path"
+        signer_email = "service@example.com"
+        credentials = _make_credentials(signer_email=signer_email)
+        credentials.sign_bytes.return_value = b"DEADBEEF"
+
+        with mock.patch("google.cloud.storage._signing.NOW", lambda: now):
+            url = self._call_fut(
+                credentials,
+                resource,
+                expiration=expiration,
+                api_access_endpoint=api_access_endpoint,
+                method=method,
+                content_type=content_type,
+                content_md5=content_md5,
+                response_type=response_type,
+                response_disposition=response_disposition,
+                generation=generation,
+                headers=headers,
+                query_parameters=query_parameters,
+            )
+
+        # Check the mock was called.
+        credentials.sign_bytes.assert_called_once()
+
+        scheme, netloc, path, qs, frag = urllib_parse.urlsplit(url)
+
+        expected_scheme, expected_netloc, _, _, _ = urllib_parse.urlsplit(
+            api_access_endpoint
+        )
+        self.assertEqual(scheme, expected_scheme)
+        self.assertEqual(netloc, expected_netloc)
+        self.assertEqual(path, resource)
+        self.assertEqual(frag, "")
+
+        # Check the URL parameters.
+        params = dict(urllib_parse.parse_qsl(qs, keep_blank_values=True))
+        self.assertEqual(params["X-Goog-Algorithm"], "GOOG4-RSA-SHA256")
+
+        now_date = now.date().strftime("%Y%m%d")
+        expected_cred = "{}/{}/auto/storage/goog4_request".format(
+            signer_email, now_date
+        )
+        self.assertEqual(params["X-Goog-Credential"], expected_cred)
+
+        now_stamp = now.strftime("%Y%m%dT%H%M%SZ")
+        self.assertEqual(params["X-Goog-Date"], now_stamp)
+        self.assertEqual(params["X-Goog-Expires"], str(self.DEFAULT_EXPIRATION))
+
+        signed = binascii.hexlify(credentials.sign_bytes.return_value).decode("ascii")
+        self.assertEqual(params["X-Goog-Signature"], signed)
+
+        if response_type is not None:
+            self.assertEqual(params["response-content-type"], response_type)
+
+        if response_disposition is not None:
+            self.assertEqual(
+                params["response-content-disposition"], response_disposition
+            )
+
+        if generation is not None:
+            self.assertEqual(params["generation"], str(generation))
+
+        if query_parameters is not None:
+            for key, value in query_parameters.items():
+                value = value.strip() if value else ""
+                self.assertEqual(params[key].lower(), value)
+
+    def test_w_expiration_too_long(self):
+        with self.assertRaises(ValueError):
+            self._generate_helper(expiration=datetime.timedelta(days=8))
+
+    def test_w_defaults(self):
+        self._generate_helper()
+
+    def test_w_api_access_endpoint(self):
+        self._generate_helper(api_access_endpoint="http://api.example.com")
+
+    def test_w_method(self):
+        self._generate_helper(method="PUT")
+
+    def test_w_method_resumable(self):
+        self._generate_helper(method="RESUMABLE")
+
+    def test_w_content_type(self):
+        self._generate_helper(content_type="text/plain")
+
+    def test_w_content_md5(self):
+        self._generate_helper(content_md5="FACEDACE")
+
+    def test_w_response_type(self):
+        self._generate_helper(response_type="application/octets")
+
+    def test_w_response_disposition(self):
+        self._generate_helper(response_disposition="attachment")
+
+    def test_w_generation(self):
+        self._generate_helper(generation=12345)
+
+    def test_w_custom_host_header(self):
+        self._generate_helper(headers={"Host": "api.example.com"})
+
+    def test_w_custom_headers(self):
+        self._generate_helper(headers={"x-goog-foo": "bar"})
+
+    def test_w_custom_query_parameters_w_string_value(self):
+        self._generate_helper(query_parameters={"bar": "/"})
+
+    def test_w_custom_query_parameters_w_none_value(self):
+        self._generate_helper(query_parameters={"qux": None})
+
+
+_DUMMY_SERVICE_ACCOUNT = None
+
+
+def dummy_service_account():
+    global _DUMMY_SERVICE_ACCOUNT
+
+    from google.oauth2.service_account import Credentials
+
+    if _DUMMY_SERVICE_ACCOUNT is None:
+        _DUMMY_SERVICE_ACCOUNT = Credentials.from_service_account_info(
+            _SERVICE_ACCOUNT_JSON
+        )
+
+    return _DUMMY_SERVICE_ACCOUNT
+
+
+def _run_conformance_test(resource, test_data):
+    credentials = dummy_service_account()
+
+    url = Test_generate_signed_url_v4._call_fut(
+        credentials,
+        resource,
+        expiration=test_data["expiration"],
+        method=test_data["method"],
+        _request_timestamp=test_data["timestamp"],
+        headers=test_data.get("headers"),
+    )
+
+    assert url == test_data["expectedUrl"]
+
+
+@pytest.mark.parametrize("test_data", _CLIENT_TESTS)
+@pytest.mark.skip(reason="Bucketless URLs not yet supported")
+def test_conformance_client(test_data):
+    pass  # pragma: NO COVER
+
+
+@pytest.mark.parametrize("test_data", _BUCKET_TESTS)
+def test_conformance_bucket(test_data):
+    resource = "/{}".format(test_data["bucket"])
+    _run_conformance_test(resource, test_data)
+
+
+@pytest.mark.parametrize("test_data", _BLOB_TESTS)
+def test_conformance_blob(test_data):
+    resource = "/{}/{}".format(test_data["bucket"], test_data["object"])
+    _run_conformance_test(resource, test_data)
+
+
+def _make_credentials(signer_email=None):
+    import google.auth.credentials
+
+    if signer_email:
+        credentials = mock.Mock(spec=google.auth.credentials.Signing)
+        credentials.signer_email = signer_email
+        return credentials
+    else:
+        return mock.Mock(spec=google.auth.credentials.Credentials)
diff --git a/storage/tests/unit/test_acl.py b/storage/tests/unit/test_acl.py
new file mode 100644
index 000000000000..d66a9439c1cc
--- /dev/null
+++ b/storage/tests/unit/test_acl.py
@@ -0,0 +1,886 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class Test_ACLEntity(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.acl import _ACLEntity
+
+        return _ACLEntity
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_default_identifier(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        self.assertEqual(entity.type, TYPE)
+        self.assertIsNone(entity.identifier)
+        self.assertEqual(entity.get_roles(), set())
+
+    def test_ctor_w_identifier(self):
+        TYPE = "type"
+        ID = "id"
+        entity = self._make_one(TYPE, ID)
+        self.assertEqual(entity.type, TYPE)
+        self.assertEqual(entity.identifier, ID)
+        self.assertEqual(entity.get_roles(), set())
+
+    def test___str__no_identifier(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        self.assertEqual(str(entity), TYPE)
+
+    def test___str__w_identifier(self):
+        TYPE = "type"
+        ID = "id"
+        entity = self._make_one(TYPE, ID)
+        self.assertEqual(str(entity), "%s-%s" % (TYPE, ID))
+
+    def test_grant_simple(self):
+        TYPE = "type"
+        ROLE = "role"
+        entity = self._make_one(TYPE)
+        entity.grant(ROLE)
+        self.assertEqual(entity.get_roles(), set([ROLE]))
+
+    def test_grant_duplicate(self):
+        TYPE = "type"
+        ROLE1 = "role1"
+        ROLE2 = "role2"
+        entity = self._make_one(TYPE)
+        entity.grant(ROLE1)
+        entity.grant(ROLE2)
+        entity.grant(ROLE1)
+        self.assertEqual(entity.get_roles(), set([ROLE1, ROLE2]))
+
+    def test_revoke_miss(self):
+        TYPE = "type"
+        ROLE = "nonesuch"
+        entity = self._make_one(TYPE)
+        entity.revoke(ROLE)
+        self.assertEqual(entity.get_roles(), set())
+
+    def test_revoke_hit(self):
+        TYPE = "type"
+        ROLE1 = "role1"
+        ROLE2 = "role2"
+        entity = self._make_one(TYPE)
+        entity.grant(ROLE1)
+        entity.grant(ROLE2)
+        entity.revoke(ROLE1)
+        self.assertEqual(entity.get_roles(), set([ROLE2]))
+
+    def test_grant_read(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        entity.grant_read()
+        self.assertEqual(entity.get_roles(), set([entity.READER_ROLE]))
+
+    def test_grant_write(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        entity.grant_write()
+        self.assertEqual(entity.get_roles(), set([entity.WRITER_ROLE]))
+
+    def test_grant_owner(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        entity.grant_owner()
+        self.assertEqual(entity.get_roles(), set([entity.OWNER_ROLE]))
+
+    def test_revoke_read(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        entity.grant(entity.READER_ROLE)
+        entity.revoke_read()
+        self.assertEqual(entity.get_roles(), set())
+
+    def test_revoke_write(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        entity.grant(entity.WRITER_ROLE)
+        entity.revoke_write()
+        self.assertEqual(entity.get_roles(), set())
+
+    def test_revoke_owner(self):
+        TYPE = "type"
+        entity = self._make_one(TYPE)
+        entity.grant(entity.OWNER_ROLE)
+        entity.revoke_owner()
+        self.assertEqual(entity.get_roles(), set())
+
+
+class Test_ACL(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.acl import ACL
+
+        return ACL
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_validate_predefined(self):
+        ACL = self._get_target_class()
+        self.assertIsNone(ACL.validate_predefined(None))
+        self.assertEqual(ACL.validate_predefined("public-read"), "publicRead")
+        self.assertEqual(ACL.validate_predefined("publicRead"), "publicRead")
+        with self.assertRaises(ValueError):
+            ACL.validate_predefined("publicread")
+
+    def test_ctor(self):
+        acl = self._make_one()
+        self.assertEqual(acl.entities, {})
+        self.assertFalse(acl.loaded)
+
+    def test__ensure_loaded(self):
+        acl = self._make_one()
+
+        def _reload():
+            acl._really_loaded = True
+
+        acl.reload = _reload
+        acl._ensure_loaded()
+        self.assertTrue(acl._really_loaded)
+
+    def test_client_is_abstract(self):
+        acl = self._make_one()
+        self.assertRaises(NotImplementedError, lambda: acl.client)
+
+    def test_reset(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        acl.entity(TYPE, ID)
+        acl.reset()
+        self.assertEqual(acl.entities, {})
+        self.assertFalse(acl.loaded)
+
+    def test___iter___empty_eager(self):
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertEqual(list(acl), [])
+
+    def test___iter___empty_lazy(self):
+        acl = self._make_one()
+
+        def _reload():
+            acl.loaded = True
+
+        acl.reload = _reload
+        self.assertEqual(list(acl), [])
+        self.assertTrue(acl.loaded)
+
+    def test___iter___non_empty_no_roles(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        acl.entity(TYPE, ID)
+        self.assertEqual(list(acl), [])
+
+    def test___iter___non_empty_w_roles(self):
+        TYPE = "type"
+        ID = "id"
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity(TYPE, ID)
+        entity.grant(ROLE)
+        self.assertEqual(list(acl), [{"entity": "%s-%s" % (TYPE, ID), "role": ROLE}])
+
+    def test___iter___non_empty_w_empty_role(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity(TYPE, ID)
+        entity.grant("")
+        self.assertEqual(list(acl), [])
+
+    def test_entity_from_dict_allUsers_eager(self):
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity_from_dict({"entity": "allUsers", "role": ROLE})
+        self.assertEqual(entity.type, "allUsers")
+        self.assertIsNone(entity.identifier)
+        self.assertEqual(entity.get_roles(), set([ROLE]))
+        self.assertEqual(list(acl), [{"entity": "allUsers", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_entity_from_dict_allAuthenticatedUsers(self):
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity_from_dict({"entity": "allAuthenticatedUsers", "role": ROLE})
+        self.assertEqual(entity.type, "allAuthenticatedUsers")
+        self.assertIsNone(entity.identifier)
+        self.assertEqual(entity.get_roles(), set([ROLE]))
+        self.assertEqual(list(acl), [{"entity": "allAuthenticatedUsers", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_entity_from_dict_string_w_hyphen(self):
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity_from_dict({"entity": "type-id", "role": ROLE})
+        self.assertEqual(entity.type, "type")
+        self.assertEqual(entity.identifier, "id")
+        self.assertEqual(entity.get_roles(), set([ROLE]))
+        self.assertEqual(list(acl), [{"entity": "type-id", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_entity_from_dict_string_wo_hyphen(self):
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertRaises(
+            ValueError, acl.entity_from_dict, {"entity": "bogus", "role": ROLE}
+        )
+        self.assertEqual(list(acl.get_entities()), [])
+
+    def test_has_entity_miss_str_eager(self):
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertFalse(acl.has_entity("nonesuch"))
+
+    def test_has_entity_miss_str_lazy(self):
+        acl = self._make_one()
+
+        def _reload():
+            acl.loaded = True
+
+        acl.reload = _reload
+        self.assertFalse(acl.has_entity("nonesuch"))
+        self.assertTrue(acl.loaded)
+
+    def test_has_entity_miss_entity(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        TYPE = "type"
+        ID = "id"
+        entity = _ACLEntity(TYPE, ID)
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertFalse(acl.has_entity(entity))
+
+    def test_has_entity_hit_str(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        acl.entity(TYPE, ID)
+        self.assertTrue(acl.has_entity("%s-%s" % (TYPE, ID)))
+
+    def test_has_entity_hit_entity(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity(TYPE, ID)
+        self.assertTrue(acl.has_entity(entity))
+
+    def test_get_entity_miss_str_no_default_eager(self):
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertIsNone(acl.get_entity("nonesuch"))
+
+    def test_get_entity_miss_str_no_default_lazy(self):
+        acl = self._make_one()
+
+        def _reload():
+            acl.loaded = True
+
+        acl.reload = _reload
+        self.assertIsNone(acl.get_entity("nonesuch"))
+        self.assertTrue(acl.loaded)
+
+    def test_get_entity_miss_entity_no_default(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        TYPE = "type"
+        ID = "id"
+        entity = _ACLEntity(TYPE, ID)
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertIsNone(acl.get_entity(entity))
+
+    def test_get_entity_miss_str_w_default(self):
+        DEFAULT = object()
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertIs(acl.get_entity("nonesuch", DEFAULT), DEFAULT)
+
+    def test_get_entity_miss_entity_w_default(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        DEFAULT = object()
+        TYPE = "type"
+        ID = "id"
+        entity = _ACLEntity(TYPE, ID)
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertIs(acl.get_entity(entity, DEFAULT), DEFAULT)
+
+    def test_get_entity_hit_str(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        acl.entity(TYPE, ID)
+        self.assertTrue(acl.has_entity("%s-%s" % (TYPE, ID)))
+
+    def test_get_entity_hit_entity(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity(TYPE, ID)
+        self.assertTrue(acl.has_entity(entity))
+
+    def test_add_entity_miss_eager(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        TYPE = "type"
+        ID = "id"
+        ROLE = "role"
+        entity = _ACLEntity(TYPE, ID)
+        entity.grant(ROLE)
+        acl = self._make_one()
+        acl.loaded = True
+        acl.add_entity(entity)
+        self.assertTrue(acl.loaded)
+        self.assertEqual(list(acl), [{"entity": "type-id", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_add_entity_miss_lazy(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        TYPE = "type"
+        ID = "id"
+        ROLE = "role"
+        entity = _ACLEntity(TYPE, ID)
+        entity.grant(ROLE)
+        acl = self._make_one()
+
+        def _reload():
+            acl.loaded = True
+
+        acl.reload = _reload
+        acl.add_entity(entity)
+        self.assertTrue(acl.loaded)
+        self.assertEqual(list(acl), [{"entity": "type-id", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+        self.assertTrue(acl.loaded)
+
+    def test_add_entity_hit(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        TYPE = "type"
+        ID = "id"
+        ENTITY_VAL = "%s-%s" % (TYPE, ID)
+        ROLE = "role"
+        entity = _ACLEntity(TYPE, ID)
+        entity.grant(ROLE)
+        acl = self._make_one()
+        acl.loaded = True
+        before = acl.entity(TYPE, ID)
+        acl.add_entity(entity)
+        self.assertTrue(acl.loaded)
+        self.assertIsNot(acl.get_entity(ENTITY_VAL), before)
+        self.assertIs(acl.get_entity(ENTITY_VAL), entity)
+        self.assertEqual(list(acl), [{"entity": "type-id", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_entity_miss(self):
+        TYPE = "type"
+        ID = "id"
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity(TYPE, ID)
+        self.assertTrue(acl.loaded)
+        entity.grant(ROLE)
+        self.assertEqual(list(acl), [{"entity": "type-id", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_entity_hit(self):
+        TYPE = "type"
+        ID = "id"
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        before = acl.entity(TYPE, ID)
+        before.grant(ROLE)
+        entity = acl.entity(TYPE, ID)
+        self.assertIs(entity, before)
+        self.assertEqual(list(acl), [{"entity": "type-id", "role": ROLE}])
+        self.assertEqual(list(acl.get_entities()), [entity])
+
+    def test_user(self):
+        ID = "id"
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.user(ID)
+        entity.grant(ROLE)
+        self.assertEqual(entity.type, "user")
+        self.assertEqual(entity.identifier, ID)
+        self.assertEqual(list(acl), [{"entity": "user-%s" % ID, "role": ROLE}])
+
+    def test_group(self):
+        ID = "id"
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.group(ID)
+        entity.grant(ROLE)
+        self.assertEqual(entity.type, "group")
+        self.assertEqual(entity.identifier, ID)
+        self.assertEqual(list(acl), [{"entity": "group-%s" % ID, "role": ROLE}])
+
+    def test_domain(self):
+        ID = "id"
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.domain(ID)
+        entity.grant(ROLE)
+        self.assertEqual(entity.type, "domain")
+        self.assertEqual(entity.identifier, ID)
+        self.assertEqual(list(acl), [{"entity": "domain-%s" % ID, "role": ROLE}])
+
+    def test_all(self):
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.all()
+        entity.grant(ROLE)
+        self.assertEqual(entity.type, "allUsers")
+        self.assertIsNone(entity.identifier)
+        self.assertEqual(list(acl), [{"entity": "allUsers", "role": ROLE}])
+
+    def test_all_authenticated(self):
+        ROLE = "role"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.all_authenticated()
+        entity.grant(ROLE)
+        self.assertEqual(entity.type, "allAuthenticatedUsers")
+        self.assertIsNone(entity.identifier)
+        self.assertEqual(list(acl), [{"entity": "allAuthenticatedUsers", "role": ROLE}])
+
+    def test_get_entities_empty_eager(self):
+        acl = self._make_one()
+        acl.loaded = True
+        self.assertEqual(acl.get_entities(), [])
+
+    def test_get_entities_empty_lazy(self):
+        acl = self._make_one()
+
+        def _reload():
+            acl.loaded = True
+
+        acl.reload = _reload
+        self.assertEqual(acl.get_entities(), [])
+        self.assertTrue(acl.loaded)
+
+    def test_get_entities_nonempty(self):
+        TYPE = "type"
+        ID = "id"
+        acl = self._make_one()
+        acl.loaded = True
+        entity = acl.entity(TYPE, ID)
+        self.assertEqual(acl.get_entities(), [entity])
+
+    def test_reload_missing(self):
+        # https://github.com/GoogleCloudPlatform/google-cloud-python/issues/652
+        ROLE = "role"
+        connection = _Connection({})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.reload_path = "/testing/acl"
+        acl.loaded = True
+        acl.entity("allUsers", ROLE)
+        acl.reload(client=client)
+        self.assertEqual(list(acl), [])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0], {"method": "GET", "path": "/testing/acl", "query_params": {}}
+        )
+
+    def test_reload_empty_result_clears_local(self):
+        ROLE = "role"
+        connection = _Connection({"items": []})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.reload_path = "/testing/acl"
+        acl.loaded = True
+        acl.entity("allUsers", ROLE)
+
+        acl.reload(client=client)
+
+        self.assertTrue(acl.loaded)
+        self.assertEqual(list(acl), [])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0], {"method": "GET", "path": "/testing/acl", "query_params": {}}
+        )
+
+    def test_reload_nonempty_result_w_user_project(self):
+        ROLE = "role"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection({"items": [{"entity": "allUsers", "role": ROLE}]})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.reload_path = "/testing/acl"
+        acl.loaded = True
+        acl.user_project = USER_PROJECT
+
+        acl.reload(client=client)
+
+        self.assertTrue(acl.loaded)
+        self.assertEqual(list(acl), [{"entity": "allUsers", "role": ROLE}])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "GET",
+                "path": "/testing/acl",
+                "query_params": {"userProject": USER_PROJECT},
+            },
+        )
+
+    def test_save_none_set_none_passed(self):
+        connection = _Connection()
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.save(client=client)
+        kw = connection._requested
+        self.assertEqual(len(kw), 0)
+
+    def test_save_existing_missing_none_passed(self):
+        connection = _Connection({})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl.save(client=client)
+        self.assertEqual(list(acl), [])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/testing")
+        self.assertEqual(kw[0]["data"], {"acl": []})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+
+    def test_save_no_acl(self):
+        ROLE = "role"
+        AFTER = [{"entity": "allUsers", "role": ROLE}]
+        connection = _Connection({"acl": AFTER})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl.entity("allUsers").grant(ROLE)
+        acl.save(client=client)
+        self.assertEqual(list(acl), AFTER)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/testing")
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/testing",
+                "query_params": {"projection": "full"},
+                "data": {"acl": AFTER},
+            },
+        )
+
+    def test_save_w_acl_w_user_project(self):
+        ROLE1 = "role1"
+        ROLE2 = "role2"
+        STICKY = {"entity": "allUsers", "role": ROLE2}
+        USER_PROJECT = "user-project-123"
+        new_acl = [{"entity": "allUsers", "role": ROLE1}]
+        connection = _Connection({"acl": [STICKY] + new_acl})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl.user_project = USER_PROJECT
+
+        acl.save(new_acl, client=client)
+
+        entries = list(acl)
+        self.assertEqual(len(entries), 2)
+        self.assertTrue(STICKY in entries)
+        self.assertTrue(new_acl[0] in entries)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/testing",
+                "query_params": {"projection": "full", "userProject": USER_PROJECT},
+                "data": {"acl": new_acl},
+            },
+        )
+
+    def test_save_prefefined_invalid(self):
+        connection = _Connection()
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        with self.assertRaises(ValueError):
+            acl.save_predefined("bogus", client=client)
+
+    def test_save_predefined_valid(self):
+        PREDEFINED = "private"
+        connection = _Connection({"acl": []})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl.save_predefined(PREDEFINED, client=client)
+        entries = list(acl)
+        self.assertEqual(len(entries), 0)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/testing",
+                "query_params": {"projection": "full", "predefinedAcl": PREDEFINED},
+                "data": {"acl": []},
+            },
+        )
+
+    def test_save_predefined_w_XML_alias(self):
+        PREDEFINED_XML = "project-private"
+        PREDEFINED_JSON = "projectPrivate"
+        connection = _Connection({"acl": []})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl.save_predefined(PREDEFINED_XML, client=client)
+        entries = list(acl)
+        self.assertEqual(len(entries), 0)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/testing",
+                "query_params": {
+                    "projection": "full",
+                    "predefinedAcl": PREDEFINED_JSON,
+                },
+                "data": {"acl": []},
+            },
+        )
+
+    def test_save_predefined_valid_w_alternate_query_param(self):
+        # Cover case where subclass overrides _PREDEFINED_QUERY_PARAM
+        PREDEFINED = "publicRead"
+        connection = _Connection({"acl": []})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl._PREDEFINED_QUERY_PARAM = "alternate"
+        acl.save_predefined(PREDEFINED, client=client)
+        entries = list(acl)
+        self.assertEqual(len(entries), 0)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/testing",
+                "query_params": {"projection": "full", "alternate": PREDEFINED},
+                "data": {"acl": []},
+            },
+        )
+
+    def test_clear(self):
+        ROLE1 = "role1"
+        ROLE2 = "role2"
+        STICKY = {"entity": "allUsers", "role": ROLE2}
+        connection = _Connection({"acl": [STICKY]})
+        client = _Client(connection)
+        acl = self._make_one()
+        acl.save_path = "/testing"
+        acl.loaded = True
+        acl.entity("allUsers", ROLE1)
+        acl.clear(client=client)
+        self.assertEqual(list(acl), [STICKY])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "PATCH",
+                "path": "/testing",
+                "query_params": {"projection": "full"},
+                "data": {"acl": []},
+            },
+        )
+
+
+class Test_BucketACL(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.acl import BucketACL
+
+        return BucketACL
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        NAME = "name"
+        bucket = _Bucket(NAME)
+        acl = self._make_one(bucket)
+        self.assertEqual(acl.entities, {})
+        self.assertFalse(acl.loaded)
+        self.assertIs(acl.bucket, bucket)
+        self.assertEqual(acl.reload_path, "/b/%s/acl" % NAME)
+        self.assertEqual(acl.save_path, "/b/%s" % NAME)
+
+    def test_user_project(self):
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        bucket = _Bucket(NAME)
+        acl = self._make_one(bucket)
+        self.assertIsNone(acl.user_project)
+        bucket.user_project = USER_PROJECT
+        self.assertEqual(acl.user_project, USER_PROJECT)
+
+
+class Test_DefaultObjectACL(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.acl import DefaultObjectACL
+
+        return DefaultObjectACL
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        NAME = "name"
+        bucket = _Bucket(NAME)
+        acl = self._make_one(bucket)
+        self.assertEqual(acl.entities, {})
+        self.assertFalse(acl.loaded)
+        self.assertIs(acl.bucket, bucket)
+        self.assertEqual(acl.reload_path, "/b/%s/defaultObjectAcl" % NAME)
+        self.assertEqual(acl.save_path, "/b/%s" % NAME)
+
+
+class Test_ObjectACL(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.acl import ObjectACL
+
+        return ObjectACL
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket(NAME)
+        blob = _Blob(bucket, BLOB_NAME)
+        acl = self._make_one(blob)
+        self.assertEqual(acl.entities, {})
+        self.assertFalse(acl.loaded)
+        self.assertIs(acl.blob, blob)
+        self.assertEqual(acl.reload_path, "/b/%s/o/%s/acl" % (NAME, BLOB_NAME))
+        self.assertEqual(acl.save_path, "/b/%s/o/%s" % (NAME, BLOB_NAME))
+
+    def test_user_project(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        bucket = _Bucket(NAME)
+        blob = _Blob(bucket, BLOB_NAME)
+        acl = self._make_one(blob)
+        self.assertIsNone(acl.user_project)
+        blob.user_project = USER_PROJECT
+        self.assertEqual(acl.user_project, USER_PROJECT)
+
+
+class _Blob(object):
+
+    user_project = None
+
+    def __init__(self, bucket, blob):
+        self.bucket = bucket
+        self.blob = blob
+
+    @property
+    def path(self):
+        return "%s/o/%s" % (self.bucket.path, self.blob)
+
+
+class _Bucket(object):
+
+    user_project = None
+
+    def __init__(self, name):
+        self.name = name
+
+    @property
+    def path(self):
+        return "/b/%s" % self.name
+
+
+class _Connection(object):
+    _delete_ok = False
+
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+        self._deleted = []
+
+    def api_request(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
+
+
+class _Client(object):
+    def __init__(self, connection):
+        self._connection = connection
diff --git a/storage/tests/unit/test_batch.py b/storage/tests/unit/test_batch.py
new file mode 100644
index 000000000000..1c95807f0a22
--- /dev/null
+++ b/storage/tests/unit/test_batch.py
@@ -0,0 +1,633 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+import requests
+from six.moves import http_client
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_response(status=http_client.OK, content=b"", headers={}):
+    response = requests.Response()
+    response.status_code = status
+    response._content = content
+    response.headers = headers
+    response.request = requests.Request()
+    return response
+
+
+def _make_requests_session(responses):
+    session = mock.create_autospec(requests.Session, instance=True)
+    session.request.side_effect = responses
+    return session
+
+
+class TestMIMEApplicationHTTP(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.batch import MIMEApplicationHTTP
+
+        return MIMEApplicationHTTP
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_body_None(self):
+        METHOD = "DELETE"
+        PATH = "/path/to/api"
+        LINES = ["DELETE /path/to/api HTTP/1.1", ""]
+        mah = self._make_one(METHOD, PATH, {}, None)
+        self.assertEqual(mah.get_content_type(), "application/http")
+        self.assertEqual(mah.get_payload().splitlines(), LINES)
+
+    def test_ctor_body_str(self):
+        METHOD = "GET"
+        PATH = "/path/to/api"
+        BODY = "ABC"
+        HEADERS = {"Content-Length": len(BODY), "Content-Type": "text/plain"}
+        LINES = [
+            "GET /path/to/api HTTP/1.1",
+            "Content-Length: 3",
+            "Content-Type: text/plain",
+            "",
+            "ABC",
+        ]
+        mah = self._make_one(METHOD, PATH, HEADERS, BODY)
+        self.assertEqual(mah.get_payload().splitlines(), LINES)
+
+    def test_ctor_body_dict(self):
+        METHOD = "GET"
+        PATH = "/path/to/api"
+        BODY = {"foo": "bar"}
+        HEADERS = {}
+        LINES = [
+            "GET /path/to/api HTTP/1.1",
+            "Content-Length: 14",
+            "Content-Type: application/json",
+            "",
+            '{"foo": "bar"}',
+        ]
+        mah = self._make_one(METHOD, PATH, HEADERS, BODY)
+        self.assertEqual(mah.get_payload().splitlines(), LINES)
+
+
+class TestBatch(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.batch import Batch
+
+        return Batch
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor(self):
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        client = _Client(connection)
+        batch = self._make_one(client)
+        self.assertIs(batch._client, client)
+        self.assertEqual(len(batch._requests), 0)
+        self.assertEqual(len(batch._target_objects), 0)
+
+    def test_current(self):
+        from google.cloud.storage.client import Client
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = Client(project=project, credentials=credentials)
+        batch1 = self._make_one(client)
+        self.assertIsNone(batch1.current())
+
+        client._push_batch(batch1)
+        self.assertIs(batch1.current(), batch1)
+
+        batch2 = self._make_one(client)
+        client._push_batch(batch2)
+        self.assertIs(batch1.current(), batch2)
+
+    def test__make_request_GET_normal(self):
+        from google.cloud.storage.batch import _FutureDict
+
+        url = "http://example.com/api"
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        batch = self._make_one(connection)
+        target = _MockObject()
+
+        response = batch._make_request("GET", url, target_object=target)
+
+        # Check the respone
+        self.assertEqual(response.status_code, 204)
+        self.assertIsInstance(response.json(), _FutureDict)
+        self.assertIsInstance(response.content, _FutureDict)
+        self.assertIs(target._properties, response.content)
+
+        # The real http request should not have been called yet.
+        http.request.assert_not_called()
+
+        # Check the queued request
+        self.assertEqual(len(batch._requests), 1)
+        request = batch._requests[0]
+        request_method, request_url, _, request_data = request
+        self.assertEqual(request_method, "GET")
+        self.assertEqual(request_url, url)
+        self.assertIsNone(request_data)
+
+    def test__make_request_POST_normal(self):
+        from google.cloud.storage.batch import _FutureDict
+
+        url = "http://example.com/api"
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        batch = self._make_one(connection)
+        data = {"foo": 1}
+        target = _MockObject()
+
+        response = batch._make_request(
+            "POST", url, data={"foo": 1}, target_object=target
+        )
+
+        self.assertEqual(response.status_code, 204)
+        self.assertIsInstance(response.content, _FutureDict)
+        self.assertIs(target._properties, response.content)
+
+        # The real http request should not have been called yet.
+        http.request.assert_not_called()
+
+        request = batch._requests[0]
+        request_method, request_url, _, request_data = request
+        self.assertEqual(request_method, "POST")
+        self.assertEqual(request_url, url)
+        self.assertEqual(request_data, data)
+
+    def test__make_request_PATCH_normal(self):
+        from google.cloud.storage.batch import _FutureDict
+
+        url = "http://example.com/api"
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        batch = self._make_one(connection)
+        data = {"foo": 1}
+        target = _MockObject()
+
+        response = batch._make_request(
+            "PATCH", url, data={"foo": 1}, target_object=target
+        )
+
+        self.assertEqual(response.status_code, 204)
+        self.assertIsInstance(response.content, _FutureDict)
+        self.assertIs(target._properties, response.content)
+
+        # The real http request should not have been called yet.
+        http.request.assert_not_called()
+
+        request = batch._requests[0]
+        request_method, request_url, _, request_data = request
+        self.assertEqual(request_method, "PATCH")
+        self.assertEqual(request_url, url)
+        self.assertEqual(request_data, data)
+
+    def test__make_request_DELETE_normal(self):
+        from google.cloud.storage.batch import _FutureDict
+
+        url = "http://example.com/api"
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        batch = self._make_one(connection)
+        target = _MockObject()
+
+        response = batch._make_request("DELETE", url, target_object=target)
+
+        # Check the respone
+        self.assertEqual(response.status_code, 204)
+        self.assertIsInstance(response.content, _FutureDict)
+        self.assertIs(target._properties, response.content)
+
+        # The real http request should not have been called yet.
+        http.request.assert_not_called()
+
+        # Check the queued request
+        self.assertEqual(len(batch._requests), 1)
+        request = batch._requests[0]
+        request_method, request_url, _, request_data = request
+        self.assertEqual(request_method, "DELETE")
+        self.assertEqual(request_url, url)
+        self.assertIsNone(request_data)
+
+    def test__make_request_POST_too_many_requests(self):
+        url = "http://example.com/api"
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        batch = self._make_one(connection)
+
+        batch._MAX_BATCH_SIZE = 1
+        batch._requests.append(("POST", url, {}, {"bar": 2}))
+
+        with self.assertRaises(ValueError):
+            batch._make_request("POST", url, data={"foo": 1})
+
+    def test_finish_empty(self):
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        batch = self._make_one(connection)
+
+        with self.assertRaises(ValueError):
+            batch.finish()
+
+    def _get_payload_chunks(self, boundary, payload):
+        divider = "--" + boundary[len('boundary="') : -1]
+        chunks = payload.split(divider)[1:-1]  # discard prolog / epilog
+        return chunks
+
+    def _check_subrequest_no_payload(self, chunk, method, url):
+        lines = chunk.splitlines()
+        # blank + 2 headers + blank + request + blank + blank
+        self.assertEqual(len(lines), 7)
+        self.assertEqual(lines[0], "")
+        self.assertEqual(lines[1], "Content-Type: application/http")
+        self.assertEqual(lines[2], "MIME-Version: 1.0")
+        self.assertEqual(lines[3], "")
+        self.assertEqual(lines[4], "%s %s HTTP/1.1" % (method, url))
+        self.assertEqual(lines[5], "")
+        self.assertEqual(lines[6], "")
+
+    def _check_subrequest_payload(self, chunk, method, url, payload):
+        import json
+
+        lines = chunk.splitlines()
+        # blank + 2 headers + blank + request + 2 headers + blank + body
+        payload_str = json.dumps(payload)
+        self.assertEqual(lines[0], "")
+        self.assertEqual(lines[1], "Content-Type: application/http")
+        self.assertEqual(lines[2], "MIME-Version: 1.0")
+        self.assertEqual(lines[3], "")
+        self.assertEqual(lines[4], "%s %s HTTP/1.1" % (method, url))
+        if method == "GET":
+            self.assertEqual(len(lines), 7)
+            self.assertEqual(lines[5], "")
+            self.assertEqual(lines[6], "")
+        else:
+            self.assertEqual(len(lines), 9)
+            self.assertEqual(lines[5], "Content-Length: %d" % len(payload_str))
+            self.assertEqual(lines[6], "Content-Type: application/json")
+            self.assertEqual(lines[7], "")
+            self.assertEqual(json.loads(lines[8]), payload)
+
+    def _get_mutlipart_request(self, http):
+        request_call = http.request.mock_calls[0][2]
+        request_headers = request_call["headers"]
+        request_body = request_call["data"]
+        content_type, boundary = [
+            value.strip() for value in request_headers["Content-Type"].split(";")
+        ]
+
+        return request_headers, request_body, content_type, boundary
+
+    def test_finish_nonempty(self):
+        url = "http://api.example.com/other_api"
+        expected_response = _make_response(
+            content=_THREE_PART_MIME_RESPONSE,
+            headers={"content-type": 'multipart/mixed; boundary="DEADBEEF="'},
+        )
+        http = _make_requests_session([expected_response])
+        connection = _Connection(http=http)
+        client = _Client(connection)
+        batch = self._make_one(client)
+        batch.API_BASE_URL = "http://api.example.com"
+
+        batch._do_request("POST", url, {}, {"foo": 1, "bar": 2}, None)
+        batch._do_request("PATCH", url, {}, {"bar": 3}, None)
+        batch._do_request("DELETE", url, {}, None, None)
+        result = batch.finish()
+
+        self.assertEqual(len(result), len(batch._requests))
+
+        response1, response2, response3 = result
+
+        self.assertEqual(
+            response1.headers,
+            {"Content-Length": "20", "Content-Type": "application/json; charset=UTF-8"},
+        )
+        self.assertEqual(response1.json(), {"foo": 1, "bar": 2})
+
+        self.assertEqual(
+            response2.headers,
+            {"Content-Length": "20", "Content-Type": "application/json; charset=UTF-8"},
+        )
+        self.assertEqual(response2.json(), {"foo": 1, "bar": 3})
+
+        self.assertEqual(response3.headers, {"Content-Length": "0"})
+        self.assertEqual(response3.status_code, http_client.NO_CONTENT)
+
+        expected_url = "{}/batch/storage/v1".format(batch.API_BASE_URL)
+        http.request.assert_called_once_with(
+            method="POST", url=expected_url, headers=mock.ANY, data=mock.ANY
+        )
+
+        request_info = self._get_mutlipart_request(http)
+        request_headers, request_body, content_type, boundary = request_info
+
+        self.assertEqual(content_type, "multipart/mixed")
+        self.assertTrue(boundary.startswith('boundary="=='))
+        self.assertTrue(boundary.endswith('=="'))
+        self.assertEqual(request_headers["MIME-Version"], "1.0")
+
+        chunks = self._get_payload_chunks(boundary, request_body)
+        self.assertEqual(len(chunks), 3)
+        self._check_subrequest_payload(chunks[0], "POST", url, {"foo": 1, "bar": 2})
+        self._check_subrequest_payload(chunks[1], "PATCH", url, {"bar": 3})
+        self._check_subrequest_no_payload(chunks[2], "DELETE", url)
+
+    def test_finish_responses_mismatch(self):
+        url = "http://api.example.com/other_api"
+        expected_response = _make_response(
+            content=_TWO_PART_MIME_RESPONSE_WITH_FAIL,
+            headers={"content-type": 'multipart/mixed; boundary="DEADBEEF="'},
+        )
+        http = _make_requests_session([expected_response])
+        connection = _Connection(http=http)
+        client = _Client(connection)
+        batch = self._make_one(client)
+        batch.API_BASE_URL = "http://api.example.com"
+
+        batch._requests.append(("GET", url, {}, None))
+        with self.assertRaises(ValueError):
+            batch.finish()
+
+    def test_finish_nonempty_with_status_failure(self):
+        from google.cloud.exceptions import NotFound
+
+        url = "http://api.example.com/other_api"
+        expected_response = _make_response(
+            content=_TWO_PART_MIME_RESPONSE_WITH_FAIL,
+            headers={"content-type": 'multipart/mixed; boundary="DEADBEEF="'},
+        )
+        http = _make_requests_session([expected_response])
+        connection = _Connection(http=http)
+        client = _Client(connection)
+        batch = self._make_one(client)
+        batch.API_BASE_URL = "http://api.example.com"
+        target1 = _MockObject()
+        target2 = _MockObject()
+
+        batch._do_request("GET", url, {}, None, target1)
+        batch._do_request("GET", url, {}, None, target2)
+
+        # Make sure futures are not populated.
+        self.assertEqual(
+            [future for future in batch._target_objects], [target1, target2]
+        )
+        target2_future_before = target2._properties
+
+        with self.assertRaises(NotFound):
+            batch.finish()
+
+        self.assertEqual(target1._properties, {"foo": 1, "bar": 2})
+        self.assertIs(target2._properties, target2_future_before)
+
+        expected_url = "{}/batch/storage/v1".format(batch.API_BASE_URL)
+        http.request.assert_called_once_with(
+            method="POST", url=expected_url, headers=mock.ANY, data=mock.ANY
+        )
+
+        _, request_body, _, boundary = self._get_mutlipart_request(http)
+
+        chunks = self._get_payload_chunks(boundary, request_body)
+        self.assertEqual(len(chunks), 2)
+        self._check_subrequest_payload(chunks[0], "GET", url, {})
+        self._check_subrequest_payload(chunks[1], "GET", url, {})
+
+    def test_finish_nonempty_non_multipart_response(self):
+        url = "http://api.example.com/other_api"
+        http = _make_requests_session([_make_response()])
+        connection = _Connection(http=http)
+        client = _Client(connection)
+        batch = self._make_one(client)
+        batch._requests.append(("POST", url, {}, {"foo": 1, "bar": 2}))
+
+        with self.assertRaises(ValueError):
+            batch.finish()
+
+    def test_as_context_mgr_wo_error(self):
+        from google.cloud.storage.client import Client
+
+        url = "http://example.com/api"
+        expected_response = _make_response(
+            content=_THREE_PART_MIME_RESPONSE,
+            headers={"content-type": 'multipart/mixed; boundary="DEADBEEF="'},
+        )
+        http = _make_requests_session([expected_response])
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = Client(project=project, credentials=credentials)
+        client._http_internal = http
+
+        self.assertEqual(list(client._batch_stack), [])
+
+        target1 = _MockObject()
+        target2 = _MockObject()
+        target3 = _MockObject()
+
+        with self._make_one(client) as batch:
+            self.assertEqual(list(client._batch_stack), [batch])
+            batch._make_request(
+                "POST", url, {"foo": 1, "bar": 2}, target_object=target1
+            )
+            batch._make_request("PATCH", url, {"bar": 3}, target_object=target2)
+            batch._make_request("DELETE", url, target_object=target3)
+
+        self.assertEqual(list(client._batch_stack), [])
+        self.assertEqual(len(batch._requests), 3)
+        self.assertEqual(batch._requests[0][0], "POST")
+        self.assertEqual(batch._requests[1][0], "PATCH")
+        self.assertEqual(batch._requests[2][0], "DELETE")
+        self.assertEqual(batch._target_objects, [target1, target2, target3])
+        self.assertEqual(target1._properties, {"foo": 1, "bar": 2})
+        self.assertEqual(target2._properties, {"foo": 1, "bar": 3})
+        self.assertEqual(target3._properties, b"")
+
+    def test_as_context_mgr_w_error(self):
+        from google.cloud.storage.batch import _FutureDict
+        from google.cloud.storage.client import Client
+
+        URL = "http://example.com/api"
+        http = _make_requests_session([])
+        connection = _Connection(http=http)
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = Client(project=project, credentials=credentials)
+        client._base_connection = connection
+
+        self.assertEqual(list(client._batch_stack), [])
+
+        target1 = _MockObject()
+        target2 = _MockObject()
+        target3 = _MockObject()
+        try:
+            with self._make_one(client) as batch:
+                self.assertEqual(list(client._batch_stack), [batch])
+                batch._make_request(
+                    "POST", URL, {"foo": 1, "bar": 2}, target_object=target1
+                )
+                batch._make_request("PATCH", URL, {"bar": 3}, target_object=target2)
+                batch._make_request("DELETE", URL, target_object=target3)
+                raise ValueError()
+        except ValueError:
+            pass
+
+        http.request.assert_not_called()
+        self.assertEqual(list(client._batch_stack), [])
+        self.assertEqual(len(batch._requests), 3)
+        self.assertEqual(batch._target_objects, [target1, target2, target3])
+        # Since the context manager fails, finish will not get called and
+        # the _properties will still be futures.
+        self.assertIsInstance(target1._properties, _FutureDict)
+        self.assertIsInstance(target2._properties, _FutureDict)
+        self.assertIsInstance(target3._properties, _FutureDict)
+
+
+class Test__unpack_batch_response(unittest.TestCase):
+    def _call_fut(self, headers, content):
+        from google.cloud.storage.batch import _unpack_batch_response
+
+        response = _make_response(content=content, headers=headers)
+
+        return _unpack_batch_response(response)
+
+    def _unpack_helper(self, response, content):
+        result = list(self._call_fut(response, content))
+        self.assertEqual(len(result), 3)
+
+        self.assertEqual(result[0].status_code, http_client.OK)
+        self.assertEqual(result[0].json(), {u"bar": 2, u"foo": 1})
+        self.assertEqual(result[1].status_code, http_client.OK)
+        self.assertEqual(result[1].json(), {u"foo": 1, u"bar": 3})
+        self.assertEqual(result[2].status_code, http_client.NO_CONTENT)
+
+    def test_bytes_headers(self):
+        RESPONSE = {"content-type": b'multipart/mixed; boundary="DEADBEEF="'}
+        CONTENT = _THREE_PART_MIME_RESPONSE
+        self._unpack_helper(RESPONSE, CONTENT)
+
+    def test_unicode_headers(self):
+        RESPONSE = {"content-type": u'multipart/mixed; boundary="DEADBEEF="'}
+        CONTENT = _THREE_PART_MIME_RESPONSE
+        self._unpack_helper(RESPONSE, CONTENT)
+
+
+_TWO_PART_MIME_RESPONSE_WITH_FAIL = b"""\
+--DEADBEEF=
+Content-Type: application/json
+Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+1>
+
+HTTP/1.1 200 OK
+Content-Type: application/json; charset=UTF-8
+Content-Length: 20
+
+{"foo": 1, "bar": 2}
+
+--DEADBEEF=
+Content-Type: application/json
+Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+2>
+
+HTTP/1.1 404 Not Found
+Content-Type: application/json; charset=UTF-8
+Content-Length: 35
+
+{"error": {"message": "Not Found"}}
+
+--DEADBEEF=--
+"""
+
+_THREE_PART_MIME_RESPONSE = b"""\
+--DEADBEEF=
+Content-Type: application/json
+Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+1>
+
+HTTP/1.1 200 OK
+Content-Type: application/json; charset=UTF-8
+Content-Length: 20
+
+{"foo": 1, "bar": 2}
+
+--DEADBEEF=
+Content-Type: application/json
+Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+2>
+
+HTTP/1.1 200 OK
+Content-Type: application/json; charset=UTF-8
+Content-Length: 20
+
+{"foo": 1, "bar": 3}
+
+--DEADBEEF=
+Content-Type: text/plain
+Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+3>
+
+HTTP/1.1 204 No Content
+Content-Length: 0
+
+--DEADBEEF=--
+"""
+
+
+class Test__FutureDict(unittest.TestCase):
+    def _make_one(self, *args, **kw):
+        from google.cloud.storage.batch import _FutureDict
+
+        return _FutureDict(*args, **kw)
+
+    def test_get(self):
+        future = self._make_one()
+        self.assertRaises(KeyError, future.get, None)
+
+    def test___getitem__(self):
+        future = self._make_one()
+        value = orig_value = object()
+        with self.assertRaises(KeyError):
+            value = future[None]
+        self.assertIs(value, orig_value)
+
+    def test___setitem__(self):
+        future = self._make_one()
+        with self.assertRaises(KeyError):
+            future[None] = None
+
+
+class _Connection(object):
+
+    project = "TESTING"
+
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+    def _make_request(self, method, url, data=None, headers=None):
+        return self.http.request(url=url, method=method, headers=headers, data=data)
+
+
+class _MockObject(object):
+    pass
+
+
+class _Client(object):
+    def __init__(self, connection):
+        self._base_connection = connection
diff --git a/storage/tests/unit/test_blob.py b/storage/tests/unit/test_blob.py
new file mode 100644
index 000000000000..4d4890c6b4f8
--- /dev/null
+++ b/storage/tests/unit/test_blob.py
@@ -0,0 +1,3398 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+import datetime
+import hashlib
+import io
+import json
+import os
+import tempfile
+import unittest
+
+import google.cloud.storage.blob
+import mock
+import pytest
+import six
+from six.moves import http_client
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class Test_Blob(unittest.TestCase):
+    @staticmethod
+    def _make_one(*args, **kw):
+        from google.cloud.storage.blob import Blob
+
+        properties = kw.pop("properties", {})
+        blob = Blob(*args, **kw)
+        blob._properties.update(properties)
+        return blob
+
+    def test_ctor_wo_encryption_key(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {"key": "value"}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertIs(blob.bucket, bucket)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(blob._properties, properties)
+        self.assertFalse(blob._acl.loaded)
+        self.assertIs(blob._acl.blob, blob)
+        self.assertEqual(blob._encryption_key, None)
+        self.assertEqual(blob.kms_key_name, None)
+
+    def test_ctor_with_encoded_unicode(self):
+        blob_name = b"wet \xe2\x9b\xb5"
+        blob = self._make_one(blob_name, bucket=None)
+        unicode_name = u"wet \N{sailboat}"
+        self.assertNotIsInstance(blob.name, bytes)
+        self.assertIsInstance(blob.name, six.text_type)
+        self.assertEqual(blob.name, unicode_name)
+
+    def test_ctor_w_encryption_key(self):
+        KEY = b"01234567890123456789012345678901"  # 32 bytes
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=KEY)
+        self.assertEqual(blob._encryption_key, KEY)
+        self.assertEqual(blob.kms_key_name, None)
+
+    def test_ctor_w_kms_key_name_and_encryption_key(self):
+        KEY = b"01234567890123456789012345678901"  # 32 bytes
+        KMS_RESOURCE = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+
+        with self.assertRaises(ValueError):
+            self._make_one(
+                BLOB_NAME, bucket=bucket, encryption_key=KEY, kms_key_name=KMS_RESOURCE
+            )
+
+    def test_ctor_w_kms_key_name(self):
+        KMS_RESOURCE = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket, kms_key_name=KMS_RESOURCE)
+        self.assertEqual(blob._encryption_key, None)
+        self.assertEqual(blob.kms_key_name, KMS_RESOURCE)
+
+    def test_ctor_with_generation(self):
+        BLOB_NAME = "blob-name"
+        GENERATION = 12345
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket, generation=GENERATION)
+        self.assertEqual(blob.generation, GENERATION)
+
+    def _set_properties_helper(self, kms_key_name=None):
+        import datetime
+        from google.cloud._helpers import UTC
+        from google.cloud._helpers import _RFC3339_MICROS
+
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        NOW = now.strftime(_RFC3339_MICROS)
+        BLOB_NAME = "blob-name"
+        GENERATION = 12345
+        BLOB_ID = "name/{}/{}".format(BLOB_NAME, GENERATION)
+        SELF_LINK = "http://example.com/self/"
+        METAGENERATION = 23456
+        SIZE = 12345
+        MD5_HASH = "DEADBEEF"
+        MEDIA_LINK = "http://example.com/media/"
+        ENTITY = "project-owner-12345"
+        ENTITY_ID = "23456"
+        CRC32C = "FACE0DAC"
+        COMPONENT_COUNT = 2
+        ETAG = "ETAG"
+        resource = {
+            "id": BLOB_ID,
+            "selfLink": SELF_LINK,
+            "generation": GENERATION,
+            "metageneration": METAGENERATION,
+            "contentType": "text/plain",
+            "timeCreated": NOW,
+            "updated": NOW,
+            "timeDeleted": NOW,
+            "storageClass": "NEARLINE",
+            "timeStorageClassUpdated": NOW,
+            "size": SIZE,
+            "md5Hash": MD5_HASH,
+            "mediaLink": MEDIA_LINK,
+            "contentEncoding": "gzip",
+            "contentDisposition": "inline",
+            "contentLanguage": "en-US",
+            "cacheControl": "private",
+            "metadata": {"foo": "Foo"},
+            "owner": {"entity": ENTITY, "entityId": ENTITY_ID},
+            "crc32c": CRC32C,
+            "componentCount": COMPONENT_COUNT,
+            "etag": ETAG,
+        }
+
+        if kms_key_name is not None:
+            resource["kmsKeyName"] = kms_key_name
+
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        blob._set_properties(resource)
+
+        self.assertEqual(blob.id, BLOB_ID)
+        self.assertEqual(blob.self_link, SELF_LINK)
+        self.assertEqual(blob.generation, GENERATION)
+        self.assertEqual(blob.metageneration, METAGENERATION)
+        self.assertEqual(blob.content_type, "text/plain")
+        self.assertEqual(blob.time_created, now)
+        self.assertEqual(blob.updated, now)
+        self.assertEqual(blob.time_deleted, now)
+        self.assertEqual(blob.storage_class, "NEARLINE")
+        self.assertEqual(blob.size, SIZE)
+        self.assertEqual(blob.md5_hash, MD5_HASH)
+        self.assertEqual(blob.media_link, MEDIA_LINK)
+        self.assertEqual(blob.content_encoding, "gzip")
+        self.assertEqual(blob.content_disposition, "inline")
+        self.assertEqual(blob.content_language, "en-US")
+        self.assertEqual(blob.cache_control, "private")
+        self.assertEqual(blob.metadata, {"foo": "Foo"})
+        self.assertEqual(blob.owner, {"entity": ENTITY, "entityId": ENTITY_ID})
+        self.assertEqual(blob.crc32c, CRC32C)
+        self.assertEqual(blob.component_count, COMPONENT_COUNT)
+        self.assertEqual(blob.etag, ETAG)
+
+        if kms_key_name is not None:
+            self.assertEqual(blob.kms_key_name, kms_key_name)
+        else:
+            self.assertIsNone(blob.kms_key_name)
+
+    def test__set_properties_wo_kms_key_name(self):
+        self._set_properties_helper()
+
+    def test__set_properties_w_kms_key_name(self):
+        kms_resource = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        self._set_properties_helper(kms_key_name=kms_resource)
+
+    def test_chunk_size_ctor(self):
+        from google.cloud.storage.blob import Blob
+
+        BLOB_NAME = "blob-name"
+        BUCKET = object()
+        chunk_size = 10 * Blob._CHUNK_SIZE_MULTIPLE
+        blob = self._make_one(BLOB_NAME, bucket=BUCKET, chunk_size=chunk_size)
+        self.assertEqual(blob._chunk_size, chunk_size)
+
+    def test_chunk_size_getter(self):
+        BLOB_NAME = "blob-name"
+        BUCKET = object()
+        blob = self._make_one(BLOB_NAME, bucket=BUCKET)
+        self.assertIsNone(blob.chunk_size)
+        VALUE = object()
+        blob._chunk_size = VALUE
+        self.assertIs(blob.chunk_size, VALUE)
+
+    def test_chunk_size_setter(self):
+        BLOB_NAME = "blob-name"
+        BUCKET = object()
+        blob = self._make_one(BLOB_NAME, bucket=BUCKET)
+        self.assertIsNone(blob._chunk_size)
+        blob._CHUNK_SIZE_MULTIPLE = 10
+        blob.chunk_size = 20
+        self.assertEqual(blob._chunk_size, 20)
+
+    def test_chunk_size_setter_bad_value(self):
+        BLOB_NAME = "blob-name"
+        BUCKET = object()
+        blob = self._make_one(BLOB_NAME, bucket=BUCKET)
+        self.assertIsNone(blob._chunk_size)
+        blob._CHUNK_SIZE_MULTIPLE = 10
+        with self.assertRaises(ValueError):
+            blob.chunk_size = 11
+
+    def test_acl_property(self):
+        from google.cloud.storage.acl import ObjectACL
+
+        fake_bucket = _Bucket()
+        blob = self._make_one(u"name", bucket=fake_bucket)
+        acl = blob.acl
+        self.assertIsInstance(acl, ObjectACL)
+        self.assertIs(acl, blob._acl)
+
+    def test_path_bad_bucket(self):
+        fake_bucket = object()
+        name = u"blob-name"
+        blob = self._make_one(name, bucket=fake_bucket)
+        self.assertRaises(AttributeError, getattr, blob, "path")
+
+    def test_path_no_name(self):
+        bucket = _Bucket()
+        blob = self._make_one(u"", bucket=bucket)
+        self.assertRaises(ValueError, getattr, blob, "path")
+
+    def test_path_normal(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(blob.path, "/b/name/o/%s" % BLOB_NAME)
+
+    def test_path_w_slash_in_name(self):
+        BLOB_NAME = "parent/child"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(blob.path, "/b/name/o/parent%2Fchild")
+
+    def test_path_with_non_ascii(self):
+        blob_name = u"Caf\xe9"
+        bucket = _Bucket()
+        blob = self._make_one(blob_name, bucket=bucket)
+        self.assertEqual(blob.path, "/b/name/o/Caf%C3%A9")
+
+    def test_bucket_readonly_property(self):
+        blob_name = "BLOB"
+        bucket = _Bucket()
+        other = _Bucket()
+        blob = self._make_one(blob_name, bucket=bucket)
+        with self.assertRaises(AttributeError):
+            blob.bucket = other
+
+    def test_client(self):
+        blob_name = "BLOB"
+        bucket = _Bucket()
+        blob = self._make_one(blob_name, bucket=bucket)
+        self.assertIs(blob.client, bucket.client)
+
+    def test_user_project(self):
+        user_project = "user-project-123"
+        blob_name = "BLOB"
+        bucket = _Bucket(user_project=user_project)
+        blob = self._make_one(blob_name, bucket=bucket)
+        self.assertEqual(blob.user_project, user_project)
+
+    def test__encryption_headers_wo_encryption_key(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        expected = {}
+        self.assertEqual(blob._encryption_headers(), expected)
+
+    def test__encryption_headers_w_encryption_key(self):
+        key = b"aa426195405adee2c8081bb9e7e74b19"
+        header_key_value = "YWE0MjYxOTU0MDVhZGVlMmM4MDgxYmI5ZTdlNzRiMTk="
+        header_key_hash_value = "V3Kwe46nKc3xLv96+iJ707YfZfFvlObta8TQcx2gpm0="
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=key)
+        expected = {
+            "X-Goog-Encryption-Algorithm": "AES256",
+            "X-Goog-Encryption-Key": header_key_value,
+            "X-Goog-Encryption-Key-Sha256": header_key_hash_value,
+        }
+        self.assertEqual(blob._encryption_headers(), expected)
+
+    def test__query_params_default(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(blob._query_params, {})
+
+    def test__query_params_w_user_project(self):
+        user_project = "user-project-123"
+        BLOB_NAME = "BLOB"
+        bucket = _Bucket(user_project=user_project)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(blob._query_params, {"userProject": user_project})
+
+    def test__query_params_w_generation(self):
+        generation = 123456
+        BLOB_NAME = "BLOB"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket, generation=generation)
+        self.assertEqual(blob._query_params, {"generation": generation})
+
+    def test_public_url(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(
+            blob.public_url, "https://storage.googleapis.com/name/%s" % BLOB_NAME
+        )
+
+    def test_public_url_w_slash_in_name(self):
+        BLOB_NAME = "parent/child"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(
+            blob.public_url, "https://storage.googleapis.com/name/parent/child"
+        )
+
+    def test_public_url_w_tilde_in_name(self):
+        BLOB_NAME = "foo~bar"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertEqual(blob.public_url, "https://storage.googleapis.com/name/foo~bar")
+
+    def test_public_url_with_non_ascii(self):
+        blob_name = u"winter \N{snowman}"
+        bucket = _Bucket()
+        blob = self._make_one(blob_name, bucket=bucket)
+        expected_url = "https://storage.googleapis.com/name/winter%20%E2%98%83"
+        self.assertEqual(blob.public_url, expected_url)
+
+    def test_generate_signed_url_w_invalid_version(self):
+        BLOB_NAME = "blob-name"
+        EXPIRATION = "2014-10-16T20:34:37.000Z"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = _Bucket(client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        with self.assertRaises(ValueError):
+            blob.generate_signed_url(EXPIRATION, version="nonesuch")
+
+    def _generate_signed_url_helper(
+        self,
+        version=None,
+        blob_name="blob-name",
+        api_access_endpoint=None,
+        method="GET",
+        content_md5=None,
+        content_type=None,
+        response_type=None,
+        response_disposition=None,
+        generation=None,
+        headers=None,
+        query_parameters=None,
+        credentials=None,
+        expiration=None,
+    ):
+        from six.moves.urllib import parse
+        from google.cloud._helpers import UTC
+        from google.cloud.storage.blob import _API_ACCESS_ENDPOINT
+
+        api_access_endpoint = api_access_endpoint or _API_ACCESS_ENDPOINT
+
+        delta = datetime.timedelta(hours=1)
+
+        if expiration is None:
+            expiration = datetime.datetime.utcnow().replace(tzinfo=UTC) + delta
+
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        if version is None:
+            effective_version = "v2"
+        else:
+            effective_version = version
+
+        to_patch = "google.cloud.storage.blob.generate_signed_url_{}".format(
+            effective_version
+        )
+
+        with mock.patch(to_patch) as signer:
+            signed_uri = blob.generate_signed_url(
+                expiration=expiration,
+                api_access_endpoint=api_access_endpoint,
+                method=method,
+                credentials=credentials,
+                content_md5=content_md5,
+                content_type=content_type,
+                response_type=response_type,
+                response_disposition=response_disposition,
+                generation=generation,
+                headers=headers,
+                query_parameters=query_parameters,
+                version=version,
+            )
+
+        self.assertEqual(signed_uri, signer.return_value)
+
+        if credentials is None:
+            expected_creds = _Connection.credentials
+        else:
+            expected_creds = credentials
+
+        encoded_name = blob_name.encode("utf-8")
+        expected_resource = "/name/{}".format(parse.quote(encoded_name, safe=b"/~"))
+        expected_kwargs = {
+            "resource": expected_resource,
+            "expiration": expiration,
+            "api_access_endpoint": api_access_endpoint,
+            "method": method.upper(),
+            "content_md5": content_md5,
+            "content_type": content_type,
+            "response_type": response_type,
+            "response_disposition": response_disposition,
+            "generation": generation,
+            "headers": headers,
+            "query_parameters": query_parameters,
+        }
+        signer.assert_called_once_with(expected_creds, **expected_kwargs)
+
+    def test_generate_signed_url_no_version_passed_warning(self):
+        self._generate_signed_url_helper()
+
+    def _generate_signed_url_v2_helper(self, **kw):
+        version = "v2"
+        self._generate_signed_url_helper(version, **kw)
+
+    def test_generate_signed_url_v2_w_defaults(self):
+        self._generate_signed_url_v2_helper()
+
+    def test_generate_signed_url_v2_w_expiration(self):
+        from google.cloud._helpers import UTC
+
+        expiration = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        self._generate_signed_url_v2_helper(expiration=expiration)
+
+    def test_generate_signed_url_v2_w_non_ascii_name(self):
+        BLOB_NAME = u"\u0410\u043a\u043a\u043e\u0440\u0434\u044b.txt"
+        self._generate_signed_url_v2_helper(blob_name=BLOB_NAME)
+
+    def test_generate_signed_url_v2_w_slash_in_name(self):
+        BLOB_NAME = "parent/child"
+        self._generate_signed_url_v2_helper(blob_name=BLOB_NAME)
+
+    def test_generate_signed_url_v2_w_tilde_in_name(self):
+        BLOB_NAME = "foo~bar"
+        self._generate_signed_url_v2_helper(blob_name=BLOB_NAME)
+
+    def test_generate_signed_url_v2_w_endpoint(self):
+        self._generate_signed_url_v2_helper(
+            api_access_endpoint="https://api.example.com/v1"
+        )
+
+    def test_generate_signed_url_v2_w_method(self):
+        self._generate_signed_url_v2_helper(method="POST")
+
+    def test_generate_signed_url_v2_w_lowercase_method(self):
+        self._generate_signed_url_v2_helper(method="get")
+
+    def test_generate_signed_url_v2_w_content_md5(self):
+        self._generate_signed_url_v2_helper(content_md5="FACEDACE")
+
+    def test_generate_signed_url_v2_w_content_type(self):
+        self._generate_signed_url_v2_helper(content_type="text.html")
+
+    def test_generate_signed_url_v2_w_response_type(self):
+        self._generate_signed_url_v2_helper(response_type="text.html")
+
+    def test_generate_signed_url_v2_w_response_disposition(self):
+        self._generate_signed_url_v2_helper(response_disposition="inline")
+
+    def test_generate_signed_url_v2_w_generation(self):
+        self._generate_signed_url_v2_helper(generation=12345)
+
+    def test_generate_signed_url_v2_w_headers(self):
+        self._generate_signed_url_v2_helper(headers={"x-goog-foo": "bar"})
+
+    def test_generate_signed_url_v2_w_credentials(self):
+        credentials = object()
+        self._generate_signed_url_v2_helper(credentials=credentials)
+
+    def _generate_signed_url_v4_helper(self, **kw):
+        version = "v4"
+        self._generate_signed_url_helper(version, **kw)
+
+    def test_generate_signed_url_v4_w_defaults(self):
+        self._generate_signed_url_v4_helper()
+
+    def test_generate_signed_url_v4_w_non_ascii_name(self):
+        BLOB_NAME = u"\u0410\u043a\u043a\u043e\u0440\u0434\u044b.txt"
+        self._generate_signed_url_v4_helper(blob_name=BLOB_NAME)
+
+    def test_generate_signed_url_v4_w_slash_in_name(self):
+        BLOB_NAME = "parent/child"
+        self._generate_signed_url_v4_helper(blob_name=BLOB_NAME)
+
+    def test_generate_signed_url_v4_w_tilde_in_name(self):
+        BLOB_NAME = "foo~bar"
+        self._generate_signed_url_v4_helper(blob_name=BLOB_NAME)
+
+    def test_generate_signed_url_v4_w_endpoint(self):
+        self._generate_signed_url_v4_helper(
+            api_access_endpoint="https://api.example.com/v1"
+        )
+
+    def test_generate_signed_url_v4_w_method(self):
+        self._generate_signed_url_v4_helper(method="POST")
+
+    def test_generate_signed_url_v4_w_lowercase_method(self):
+        self._generate_signed_url_v4_helper(method="get")
+
+    def test_generate_signed_url_v4_w_content_md5(self):
+        self._generate_signed_url_v4_helper(content_md5="FACEDACE")
+
+    def test_generate_signed_url_v4_w_content_type(self):
+        self._generate_signed_url_v4_helper(content_type="text.html")
+
+    def test_generate_signed_url_v4_w_response_type(self):
+        self._generate_signed_url_v4_helper(response_type="text.html")
+
+    def test_generate_signed_url_v4_w_response_disposition(self):
+        self._generate_signed_url_v4_helper(response_disposition="inline")
+
+    def test_generate_signed_url_v4_w_generation(self):
+        self._generate_signed_url_v4_helper(generation=12345)
+
+    def test_generate_signed_url_v4_w_headers(self):
+        self._generate_signed_url_v4_helper(headers={"x-goog-foo": "bar"})
+
+    def test_generate_signed_url_v4_w_credentials(self):
+        credentials = object()
+        self._generate_signed_url_v4_helper(credentials=credentials)
+
+    def test_exists_miss(self):
+        NONESUCH = "nonesuch"
+        not_found_response = ({"status": http_client.NOT_FOUND}, b"")
+        connection = _Connection(not_found_response)
+        client = _Client(connection)
+        bucket = _Bucket(client)
+        blob = self._make_one(NONESUCH, bucket=bucket)
+        self.assertFalse(blob.exists())
+        self.assertEqual(len(connection._requested), 1)
+        self.assertEqual(
+            connection._requested[0],
+            {
+                "method": "GET",
+                "path": "/b/name/o/{}".format(NONESUCH),
+                "query_params": {"fields": "name"},
+                "_target_object": None,
+            },
+        )
+
+    def test_exists_hit_w_user_project(self):
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        found_response = ({"status": http_client.OK}, b"")
+        connection = _Connection(found_response)
+        client = _Client(connection)
+        bucket = _Bucket(client, user_project=USER_PROJECT)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        bucket._blobs[BLOB_NAME] = 1
+        self.assertTrue(blob.exists())
+        self.assertEqual(len(connection._requested), 1)
+        self.assertEqual(
+            connection._requested[0],
+            {
+                "method": "GET",
+                "path": "/b/name/o/{}".format(BLOB_NAME),
+                "query_params": {"fields": "name", "userProject": USER_PROJECT},
+                "_target_object": None,
+            },
+        )
+
+    def test_exists_hit_w_generation(self):
+        BLOB_NAME = "blob-name"
+        GENERATION = 123456
+        found_response = ({"status": http_client.OK}, b"")
+        connection = _Connection(found_response)
+        client = _Client(connection)
+        bucket = _Bucket(client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket, generation=GENERATION)
+        bucket._blobs[BLOB_NAME] = 1
+        self.assertTrue(blob.exists())
+        self.assertEqual(len(connection._requested), 1)
+        self.assertEqual(
+            connection._requested[0],
+            {
+                "method": "GET",
+                "path": "/b/name/o/{}".format(BLOB_NAME),
+                "query_params": {"fields": "name", "generation": GENERATION},
+                "_target_object": None,
+            },
+        )
+
+    def test_delete_wo_generation(self):
+        BLOB_NAME = "blob-name"
+        not_found_response = ({"status": http_client.NOT_FOUND}, b"")
+        connection = _Connection(not_found_response)
+        client = _Client(connection)
+        bucket = _Bucket(client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        bucket._blobs[BLOB_NAME] = 1
+        blob.delete()
+        self.assertFalse(blob.exists())
+        self.assertEqual(bucket._deleted, [(BLOB_NAME, None, None)])
+
+    def test_delete_w_generation(self):
+        BLOB_NAME = "blob-name"
+        GENERATION = 123456
+        not_found_response = ({"status": http_client.NOT_FOUND}, b"")
+        connection = _Connection(not_found_response)
+        client = _Client(connection)
+        bucket = _Bucket(client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket, generation=GENERATION)
+        bucket._blobs[BLOB_NAME] = 1
+        blob.delete()
+        self.assertFalse(blob.exists())
+        self.assertEqual(bucket._deleted, [(BLOB_NAME, None, GENERATION)])
+
+    def test__get_transport(self):
+        client = mock.Mock(spec=[u"_credentials", "_http"])
+        client._http = mock.sentinel.transport
+        blob = self._make_one(u"blob-name", bucket=None)
+
+        transport = blob._get_transport(client)
+
+        self.assertIs(transport, mock.sentinel.transport)
+
+    def test__get_download_url_with_media_link(self):
+        blob_name = "something.txt"
+        bucket = _Bucket(name="IRRELEVANT")
+        blob = self._make_one(blob_name, bucket=bucket)
+        media_link = "http://test.invalid"
+        # Set the media link on the blob
+        blob._properties["mediaLink"] = media_link
+
+        download_url = blob._get_download_url()
+        self.assertEqual(download_url, media_link)
+
+    def test__get_download_url_with_media_link_w_user_project(self):
+        blob_name = "something.txt"
+        user_project = "user-project-123"
+        bucket = _Bucket(name="IRRELEVANT", user_project=user_project)
+        blob = self._make_one(blob_name, bucket=bucket)
+        media_link = "http://test.invalid"
+        # Set the media link on the blob
+        blob._properties["mediaLink"] = media_link
+
+        download_url = blob._get_download_url()
+        self.assertEqual(
+            download_url, "{}?userProject={}".format(media_link, user_project)
+        )
+
+    def test__get_download_url_on_the_fly(self):
+        blob_name = "bzzz-fly.txt"
+        bucket = _Bucket(name="buhkit")
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        self.assertIsNone(blob.media_link)
+        download_url = blob._get_download_url()
+        expected_url = (
+            "https://www.googleapis.com/download/storage/v1/b/"
+            "buhkit/o/bzzz-fly.txt?alt=media"
+        )
+        self.assertEqual(download_url, expected_url)
+
+    def test__get_download_url_on_the_fly_with_generation(self):
+        blob_name = "pretend.txt"
+        bucket = _Bucket(name="fictional")
+        blob = self._make_one(blob_name, bucket=bucket)
+        generation = 1493058489532987
+        # Set the media link on the blob
+        blob._properties["generation"] = str(generation)
+
+        self.assertIsNone(blob.media_link)
+        download_url = blob._get_download_url()
+        expected_url = (
+            "https://www.googleapis.com/download/storage/v1/b/"
+            "fictional/o/pretend.txt?alt=media&generation=1493058489532987"
+        )
+        self.assertEqual(download_url, expected_url)
+
+    def test__get_download_url_on_the_fly_with_user_project(self):
+        blob_name = "pretend.txt"
+        user_project = "user-project-123"
+        bucket = _Bucket(name="fictional", user_project=user_project)
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        self.assertIsNone(blob.media_link)
+        download_url = blob._get_download_url()
+        expected_url = (
+            "https://www.googleapis.com/download/storage/v1/b/"
+            "fictional/o/pretend.txt?alt=media&userProject={}".format(user_project)
+        )
+        self.assertEqual(download_url, expected_url)
+
+    def test__get_download_url_on_the_fly_with_kms_key_name(self):
+        kms_resource = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        blob_name = "bzzz-fly.txt"
+        bucket = _Bucket(name="buhkit")
+        blob = self._make_one(blob_name, bucket=bucket, kms_key_name=kms_resource)
+
+        self.assertIsNone(blob.media_link)
+        download_url = blob._get_download_url()
+        expected_url = (
+            "https://www.googleapis.com/download/storage/v1/b/"
+            "buhkit/o/bzzz-fly.txt?alt=media"
+        )
+        self.assertEqual(download_url, expected_url)
+
+    @staticmethod
+    def _mock_requests_response(status_code, headers, content=b"", stream=False):
+        import requests
+
+        response = requests.Response()
+        response.status_code = status_code
+        response.headers.update(headers)
+        if stream:
+            raw = io.BytesIO(content)
+            raw.headers = headers
+            response.raw = raw
+            response._content = False
+        else:
+            response.raw = None
+            response._content = content
+
+        response.request = requests.Request("POST", "http://example.com").prepare()
+        return response
+
+    def _mock_download_transport(self):
+        fake_transport = mock.Mock(spec=["request"])
+        # Give the transport two fake responses.
+        chunk1_response = self._mock_requests_response(
+            http_client.PARTIAL_CONTENT,
+            {"content-length": "3", "content-range": "bytes 0-2/6"},
+            content=b"abc",
+        )
+        chunk2_response = self._mock_requests_response(
+            http_client.PARTIAL_CONTENT,
+            {"content-length": "3", "content-range": "bytes 3-5/6"},
+            content=b"def",
+        )
+        fake_transport.request.side_effect = [chunk1_response, chunk2_response]
+        return fake_transport
+
+    def _mock_download_transport_range(self):
+        fake_transport = mock.Mock(spec=["request"])
+        # Give the transport two fake responses.
+        chunk1_response = self._mock_requests_response(
+            http_client.PARTIAL_CONTENT,
+            {"content-length": "2", "content-range": "bytes 1-2/6"},
+            content=b"bc",
+        )
+        chunk2_response = self._mock_requests_response(
+            http_client.PARTIAL_CONTENT,
+            {"content-length": "2", "content-range": "bytes 3-4/6"},
+            content=b"de",
+        )
+        fake_transport.request.side_effect = [chunk1_response, chunk2_response]
+        return fake_transport
+
+    def _check_session_mocks(self, client, transport, expected_url, headers=None):
+        # Check that the transport was called exactly twice.
+        self.assertEqual(transport.request.call_count, 2)
+        if headers is None:
+            headers = {}
+        # NOTE: bytes=0-2 never shows up because the mock was called with
+        #       **MUTABLE** headers and it was mutated before the
+        #       second request.
+        headers["range"] = "bytes=3-5"
+        headers["accept-encoding"] = "gzip"
+        call = mock.call(
+            "GET", expected_url, data=None, headers=headers, timeout=mock.ANY
+        )
+        self.assertEqual(transport.request.mock_calls, [call, call])
+
+    def test__do_download_simple(self):
+        blob_name = "blob-name"
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_credentials=_make_credentials(), spec=["_credentials"])
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        # Make sure this will not be chunked.
+        self.assertIsNone(blob.chunk_size)
+
+        transport = mock.Mock(spec=["request"])
+        transport.request.return_value = self._mock_requests_response(
+            http_client.OK,
+            {"content-length": "6", "content-range": "bytes 0-5/6"},
+            content=b"abcdef",
+            stream=True,
+        )
+        file_obj = io.BytesIO()
+        download_url = "http://test.invalid"
+        headers = {}
+        blob._do_download(transport, file_obj, download_url, headers)
+        # Make sure the download was as expected.
+        self.assertEqual(file_obj.getvalue(), b"abcdef")
+
+        transport.request.assert_called_once_with(
+            "GET",
+            download_url,
+            data=None,
+            headers=headers,
+            stream=True,
+            timeout=mock.ANY,
+        )
+
+    def test__do_download_simple_with_range(self):
+        blob_name = "blob-name"
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_credentials=_make_credentials(), spec=["_credentials"])
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        # Make sure this will not be chunked.
+        self.assertIsNone(blob.chunk_size)
+
+        transport = mock.Mock(spec=["request"])
+        transport.request.return_value = self._mock_requests_response(
+            http_client.OK,
+            {"content-length": "3", "content-range": "bytes 1-3"},
+            content=b"bcd",
+            stream=True,
+        )
+        file_obj = io.BytesIO()
+        download_url = "http://test.invalid"
+        headers = {}
+        blob._do_download(transport, file_obj, download_url, headers, start=1, end=3)
+        # Make sure the download was as expected.
+        self.assertEqual(file_obj.getvalue(), b"bcd")
+        self.assertEqual(headers["range"], "bytes=1-3")
+
+        transport.request.assert_called_once_with(
+            "GET",
+            download_url,
+            data=None,
+            headers=headers,
+            stream=True,
+            timeout=mock.ANY,
+        )
+
+    def test__do_download_chunked(self):
+        blob_name = "blob-name"
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_credentials=_make_credentials(), spec=["_credentials"])
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        # Modify the blob so there there will be 2 chunks of size 3.
+        blob._CHUNK_SIZE_MULTIPLE = 1
+        blob.chunk_size = 3
+
+        transport = self._mock_download_transport()
+        file_obj = io.BytesIO()
+        download_url = "http://test.invalid"
+        headers = {}
+        blob._do_download(transport, file_obj, download_url, headers)
+        # Make sure the download was as expected.
+        self.assertEqual(file_obj.getvalue(), b"abcdef")
+
+        # Check that the transport was called exactly twice.
+        self.assertEqual(transport.request.call_count, 2)
+        # ``headers`` was modified (in place) once for each API call.
+        self.assertEqual(headers, {"range": "bytes=3-5"})
+        call = mock.call(
+            "GET", download_url, data=None, headers=headers, timeout=mock.ANY
+        )
+        self.assertEqual(transport.request.mock_calls, [call, call])
+
+    def test__do_download_chunked_with_range(self):
+        blob_name = "blob-name"
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_credentials=_make_credentials(), spec=["_credentials"])
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+
+        # Modify the blob so there there will be 2 chunks of size 2.
+        blob._CHUNK_SIZE_MULTIPLE = 1
+        blob.chunk_size = 2
+
+        transport = self._mock_download_transport_range()
+        file_obj = io.BytesIO()
+        download_url = "http://test.invalid"
+        headers = {}
+        blob._do_download(transport, file_obj, download_url, headers, start=1, end=4)
+        # Make sure the download was as expected.
+        self.assertEqual(file_obj.getvalue(), b"bcde")
+
+        # Check that the transport was called exactly twice.
+        self.assertEqual(transport.request.call_count, 2)
+        # ``headers`` was modified (in place) once for each API call.
+        self.assertEqual(headers, {"range": "bytes=3-4"})
+        call = mock.call(
+            "GET", download_url, data=None, headers=headers, timeout=mock.ANY
+        )
+        self.assertEqual(transport.request.mock_calls, [call, call])
+
+    def test_download_to_file_with_failure(self):
+        from google.cloud import exceptions
+
+        blob_name = "blob-name"
+        transport = mock.Mock(spec=["request"])
+        bad_response_headers = {
+            "Content-Length": "9",
+            "Content-Type": "text/html; charset=UTF-8",
+        }
+        transport.request.return_value = self._mock_requests_response(
+            http_client.NOT_FOUND, bad_response_headers, content=b"Not found"
+        )
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=[u"_http"])
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+        # Set the media link on the blob
+        blob._properties["mediaLink"] = "http://test.invalid"
+
+        file_obj = io.BytesIO()
+        with self.assertRaises(exceptions.NotFound):
+            blob.download_to_file(file_obj)
+
+        self.assertEqual(file_obj.tell(), 0)
+        # Check that the transport was called once.
+        transport.request.assert_called_once_with(
+            "GET",
+            blob.media_link,
+            data=None,
+            headers={"accept-encoding": "gzip"},
+            stream=True,
+            timeout=mock.ANY,
+        )
+
+    def test_download_to_file_wo_media_link(self):
+        blob_name = "blob-name"
+        transport = self._mock_download_transport()
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=[u"_http"])
+        bucket = _Bucket(client)
+        blob = self._make_one(blob_name, bucket=bucket)
+        # Modify the blob so there there will be 2 chunks of size 3.
+        blob._CHUNK_SIZE_MULTIPLE = 1
+        blob.chunk_size = 3
+
+        file_obj = io.BytesIO()
+        blob.download_to_file(file_obj)
+        self.assertEqual(file_obj.getvalue(), b"abcdef")
+        # Make sure the media link is still unknown.
+        self.assertIsNone(blob.media_link)
+
+        expected_url = (
+            "https://www.googleapis.com/download/storage/v1/b/"
+            "name/o/blob-name?alt=media"
+        )
+        self._check_session_mocks(client, transport, expected_url)
+
+    def _download_to_file_helper(self, use_chunks=False):
+        blob_name = "blob-name"
+        transport = self._mock_download_transport()
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=[u"_http"])
+        bucket = _Bucket(client)
+        media_link = "http://example.com/media/"
+        properties = {"mediaLink": media_link}
+        blob = self._make_one(blob_name, bucket=bucket, properties=properties)
+        if use_chunks:
+            # Modify the blob so there there will be 2 chunks of size 3.
+            blob._CHUNK_SIZE_MULTIPLE = 1
+            blob.chunk_size = 3
+        else:
+            # Modify the response.
+            single_chunk_response = self._mock_requests_response(
+                http_client.OK,
+                {"content-length": "6", "content-range": "bytes 0-5/6"},
+                content=b"abcdef",
+                stream=True,
+            )
+            transport.request.side_effect = [single_chunk_response]
+
+        file_obj = io.BytesIO()
+        blob.download_to_file(file_obj)
+        self.assertEqual(file_obj.getvalue(), b"abcdef")
+
+        if use_chunks:
+            self._check_session_mocks(client, transport, media_link)
+        else:
+            transport.request.assert_called_once_with(
+                "GET",
+                media_link,
+                data=None,
+                headers={"accept-encoding": "gzip"},
+                stream=True,
+                timeout=mock.ANY,
+            )
+
+    def test_download_to_file_default(self):
+        self._download_to_file_helper()
+
+    def test_download_to_file_with_chunk_size(self):
+        self._download_to_file_helper(use_chunks=True)
+
+    def _download_to_filename_helper(self, updated=None):
+        import os
+        import time
+        from google.cloud._testing import _NamedTemporaryFile
+
+        blob_name = "blob-name"
+        transport = self._mock_download_transport()
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=["_http"])
+        bucket = _Bucket(client)
+        media_link = "http://example.com/media/"
+        properties = {"mediaLink": media_link}
+        if updated is not None:
+            properties["updated"] = updated
+
+        blob = self._make_one(blob_name, bucket=bucket, properties=properties)
+        # Modify the blob so there there will be 2 chunks of size 3.
+        blob._CHUNK_SIZE_MULTIPLE = 1
+        blob.chunk_size = 3
+
+        with _NamedTemporaryFile() as temp:
+            blob.download_to_filename(temp.name)
+            with open(temp.name, "rb") as file_obj:
+                wrote = file_obj.read()
+                if updated is None:
+                    self.assertIsNone(blob.updated)
+                else:
+                    mtime = os.path.getmtime(temp.name)
+                    updated_time = time.mktime(blob.updated.timetuple())
+                    self.assertEqual(mtime, updated_time)
+
+        self.assertEqual(wrote, b"abcdef")
+
+        self._check_session_mocks(client, transport, media_link)
+
+    def test_download_to_filename(self):
+        updated = "2014-12-06T13:13:50.690Z"
+        self._download_to_filename_helper(updated=updated)
+
+    def test_download_to_filename_wo_updated(self):
+        self._download_to_filename_helper()
+
+    def test_download_to_filename_corrupted(self):
+        from google.resumable_media import DataCorruption
+        from google.resumable_media.requests.download import _CHECKSUM_MISMATCH
+
+        blob_name = "blob-name"
+        transport = mock.Mock(spec=["request"])
+        empty_hash = base64.b64encode(hashlib.md5(b"").digest()).decode(u"utf-8")
+        headers = {"x-goog-hash": "md5=" + empty_hash}
+        mock_raw = mock.Mock(headers=headers, spec=["headers"])
+        response = mock.MagicMock(
+            headers=headers,
+            status_code=http_client.OK,
+            raw=mock_raw,
+            spec=[
+                "__enter__",
+                "__exit__",
+                "headers",
+                "iter_content",
+                "status_code",
+                "raw",
+            ],
+        )
+        # i.e. context manager returns ``self``.
+        response.__enter__.return_value = response
+        response.__exit__.return_value = None
+        chunks = (b"noms1", b"coooookies2")
+        response.iter_content.return_value = iter(chunks)
+
+        transport.request.return_value = response
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=["_http"])
+        bucket = mock.Mock(
+            client=client, user_project=None, spec=["client", "user_project"]
+        )
+        media_link = "http://example.com/media/"
+        properties = {"mediaLink": media_link}
+        blob = self._make_one(blob_name, bucket=bucket, properties=properties)
+        # Make sure the download is **not** chunked.
+        self.assertIsNone(blob.chunk_size)
+
+        # Make sure the hash will be wrong.
+        content = b"".join(chunks)
+        expected_hash = base64.b64encode(hashlib.md5(content).digest()).decode(u"utf-8")
+        self.assertNotEqual(empty_hash, expected_hash)
+
+        # Try to download into a temporary file (don't use
+        # `_NamedTemporaryFile` it will try to remove after the file is
+        # already removed)
+        filehandle, filename = tempfile.mkstemp()
+        os.close(filehandle)
+        with self.assertRaises(DataCorruption) as exc_info:
+            blob.download_to_filename(filename)
+
+        msg = _CHECKSUM_MISMATCH.format(media_link, empty_hash, expected_hash)
+        self.assertEqual(exc_info.exception.args, (msg,))
+        # Make sure the file was cleaned up.
+        self.assertFalse(os.path.exists(filename))
+
+        # Check the mocks.
+        response.__enter__.assert_called_once_with()
+        response.__exit__.assert_called_once_with(None, None, None)
+        response.iter_content.assert_called_once_with(
+            chunk_size=8192, decode_unicode=False
+        )
+        transport.request.assert_called_once_with(
+            "GET",
+            media_link,
+            data=None,
+            headers={"accept-encoding": "gzip"},
+            stream=True,
+            timeout=mock.ANY,
+        )
+
+    def test_download_to_filename_w_key(self):
+        import os
+        import time
+        from google.cloud._testing import _NamedTemporaryFile
+
+        blob_name = "blob-name"
+        transport = self._mock_download_transport()
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=["_http"])
+        bucket = _Bucket(client)
+        media_link = "http://example.com/media/"
+        properties = {"mediaLink": media_link, "updated": "2014-12-06T13:13:50.690Z"}
+        key = b"aa426195405adee2c8081bb9e7e74b19"
+        blob = self._make_one(
+            blob_name, bucket=bucket, properties=properties, encryption_key=key
+        )
+        # Modify the blob so there there will be 2 chunks of size 3.
+        blob._CHUNK_SIZE_MULTIPLE = 1
+        blob.chunk_size = 3
+
+        with _NamedTemporaryFile() as temp:
+            blob.download_to_filename(temp.name)
+            with open(temp.name, "rb") as file_obj:
+                wrote = file_obj.read()
+                mtime = os.path.getmtime(temp.name)
+                updated_time = time.mktime(blob.updated.timetuple())
+
+        self.assertEqual(wrote, b"abcdef")
+        self.assertEqual(mtime, updated_time)
+
+        header_key_value = "YWE0MjYxOTU0MDVhZGVlMmM4MDgxYmI5ZTdlNzRiMTk="
+        header_key_hash_value = "V3Kwe46nKc3xLv96+iJ707YfZfFvlObta8TQcx2gpm0="
+        key_headers = {
+            "X-Goog-Encryption-Key-Sha256": header_key_hash_value,
+            "X-Goog-Encryption-Algorithm": "AES256",
+            "X-Goog-Encryption-Key": header_key_value,
+            "accept-encoding": "gzip",
+        }
+        self._check_session_mocks(client, transport, media_link, headers=key_headers)
+
+    def test_download_as_string(self):
+        blob_name = "blob-name"
+        transport = self._mock_download_transport()
+        # Create a fake client/bucket and use them in the Blob() constructor.
+        client = mock.Mock(_http=transport, spec=["_http"])
+        bucket = _Bucket(client)
+        media_link = "http://example.com/media/"
+        properties = {"mediaLink": media_link}
+        blob = self._make_one(blob_name, bucket=bucket, properties=properties)
+        # Modify the blob so there there will be 2 chunks of size 3.
+        blob._CHUNK_SIZE_MULTIPLE = 1
+        blob.chunk_size = 3
+
+        fetched = blob.download_as_string()
+        self.assertEqual(fetched, b"abcdef")
+
+        self._check_session_mocks(client, transport, media_link)
+
+    def test__get_content_type_explicit(self):
+        blob = self._make_one(u"blob-name", bucket=None)
+
+        content_type = u"text/plain"
+        return_value = blob._get_content_type(content_type)
+        self.assertEqual(return_value, content_type)
+
+    def test__get_content_type_from_blob(self):
+        blob = self._make_one(u"blob-name", bucket=None)
+        blob.content_type = u"video/mp4"
+
+        return_value = blob._get_content_type(None)
+        self.assertEqual(return_value, blob.content_type)
+
+    def test__get_content_type_from_filename(self):
+        blob = self._make_one(u"blob-name", bucket=None)
+
+        return_value = blob._get_content_type(None, filename="archive.tar")
+        self.assertEqual(return_value, "application/x-tar")
+
+    def test__get_content_type_default(self):
+        blob = self._make_one(u"blob-name", bucket=None)
+
+        return_value = blob._get_content_type(None)
+        self.assertEqual(return_value, u"application/octet-stream")
+
+    def test__get_writable_metadata_no_changes(self):
+        name = u"blob-name"
+        blob = self._make_one(name, bucket=None)
+
+        object_metadata = blob._get_writable_metadata()
+        expected = {"name": name}
+        self.assertEqual(object_metadata, expected)
+
+    def test__get_writable_metadata_with_changes(self):
+        name = u"blob-name"
+        blob = self._make_one(name, bucket=None)
+        blob.storage_class = "NEARLINE"
+        blob.cache_control = "max-age=3600"
+        blob.metadata = {"color": "red"}
+
+        object_metadata = blob._get_writable_metadata()
+        expected = {
+            "cacheControl": blob.cache_control,
+            "metadata": blob.metadata,
+            "name": name,
+            "storageClass": blob.storage_class,
+        }
+        self.assertEqual(object_metadata, expected)
+
+    def test__get_writable_metadata_unwritable_field(self):
+        name = u"blob-name"
+        properties = {"updated": "2016-10-16T18:18:18.181Z"}
+        blob = self._make_one(name, bucket=None, properties=properties)
+        # Fake that `updated` is in changes.
+        blob._changes.add("updated")
+
+        object_metadata = blob._get_writable_metadata()
+        expected = {"name": name}
+        self.assertEqual(object_metadata, expected)
+
+    def test__get_upload_arguments(self):
+        name = u"blob-name"
+        key = b"[pXw@,p@@AfBfrR3x-2b2SCHR,.?YwRO"
+        blob = self._make_one(name, bucket=None, encryption_key=key)
+        blob.content_disposition = "inline"
+
+        content_type = u"image/jpeg"
+        info = blob._get_upload_arguments(content_type)
+
+        headers, object_metadata, new_content_type = info
+        header_key_value = "W3BYd0AscEBAQWZCZnJSM3gtMmIyU0NIUiwuP1l3Uk8="
+        header_key_hash_value = "G0++dxF4q5rG4o9kE8gvEKn15RH6wLm0wXV1MgAlXOg="
+        expected_headers = {
+            "X-Goog-Encryption-Algorithm": "AES256",
+            "X-Goog-Encryption-Key": header_key_value,
+            "X-Goog-Encryption-Key-Sha256": header_key_hash_value,
+        }
+        self.assertEqual(headers, expected_headers)
+        expected_metadata = {
+            "contentDisposition": blob.content_disposition,
+            "name": name,
+        }
+        self.assertEqual(object_metadata, expected_metadata)
+        self.assertEqual(new_content_type, content_type)
+
+    def _mock_transport(self, status_code, headers, content=b""):
+        fake_transport = mock.Mock(spec=["request"])
+        fake_response = self._mock_requests_response(
+            status_code, headers, content=content
+        )
+        fake_transport.request.return_value = fake_response
+        return fake_transport
+
+    def _do_multipart_success(
+        self,
+        mock_get_boundary,
+        size=None,
+        num_retries=None,
+        user_project=None,
+        predefined_acl=None,
+        kms_key_name=None,
+    ):
+        from six.moves.urllib.parse import urlencode
+
+        bucket = _Bucket(name="w00t", user_project=user_project)
+        blob = self._make_one(u"blob-name", bucket=bucket, kms_key_name=kms_key_name)
+        self.assertIsNone(blob.chunk_size)
+
+        # Create mocks to be checked for doing transport.
+        transport = self._mock_transport(http_client.OK, {})
+
+        # Create some mock arguments.
+        client = mock.Mock(_http=transport, spec=["_http"])
+        data = b"data here hear hier"
+        stream = io.BytesIO(data)
+        content_type = u"application/xml"
+        response = blob._do_multipart_upload(
+            client, stream, content_type, size, num_retries, predefined_acl
+        )
+
+        # Check the mocks and the returned value.
+        self.assertIs(response, transport.request.return_value)
+        if size is None:
+            data_read = data
+            self.assertEqual(stream.tell(), len(data))
+        else:
+            data_read = data[:size]
+            self.assertEqual(stream.tell(), size)
+
+        mock_get_boundary.assert_called_once_with()
+
+        upload_url = "https://www.googleapis.com/upload/storage/v1" + bucket.path + "/o"
+
+        qs_params = [("uploadType", "multipart")]
+
+        if user_project is not None:
+            qs_params.append(("userProject", user_project))
+
+        if predefined_acl is not None:
+            qs_params.append(("predefinedAcl", predefined_acl))
+
+        if kms_key_name is not None:
+            qs_params.append(("kmsKeyName", kms_key_name))
+
+        upload_url += "?" + urlencode(qs_params)
+
+        payload = (
+            b"--==0==\r\n"
+            + b"content-type: application/json; charset=UTF-8\r\n\r\n"
+            + b'{"name": "blob-name"}\r\n'
+            + b"--==0==\r\n"
+            + b"content-type: application/xml\r\n\r\n"
+            + data_read
+            + b"\r\n--==0==--"
+        )
+        headers = {"content-type": b'multipart/related; boundary="==0=="'}
+        transport.request.assert_called_once_with(
+            "POST", upload_url, data=payload, headers=headers, timeout=mock.ANY
+        )
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload_no_size(self, mock_get_boundary):
+        self._do_multipart_success(mock_get_boundary, predefined_acl="private")
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload_with_size(self, mock_get_boundary):
+        self._do_multipart_success(mock_get_boundary, size=10)
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload_with_user_project(self, mock_get_boundary):
+        user_project = "user-project-123"
+        self._do_multipart_success(mock_get_boundary, user_project=user_project)
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload_with_kms(self, mock_get_boundary):
+        kms_resource = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        self._do_multipart_success(mock_get_boundary, kms_key_name=kms_resource)
+
+    @mock.patch(u"google.resumable_media._upload.get_boundary", return_value=b"==0==")
+    def test__do_multipart_upload_with_retry(self, mock_get_boundary):
+        self._do_multipart_success(mock_get_boundary, num_retries=8)
+
+    def test__do_multipart_upload_bad_size(self):
+        blob = self._make_one(u"blob-name", bucket=None)
+
+        data = b"data here hear hier"
+        stream = io.BytesIO(data)
+        size = 50
+        self.assertGreater(size, len(data))
+
+        with self.assertRaises(ValueError) as exc_info:
+            blob._do_multipart_upload(None, stream, None, size, None, None)
+
+        exc_contents = str(exc_info.exception)
+        self.assertIn("was specified but the file-like object only had", exc_contents)
+        self.assertEqual(stream.tell(), len(data))
+
+    def _initiate_resumable_helper(
+        self,
+        size=None,
+        extra_headers=None,
+        chunk_size=None,
+        num_retries=None,
+        user_project=None,
+        predefined_acl=None,
+        blob_chunk_size=786432,
+        kms_key_name=None,
+    ):
+        from six.moves.urllib.parse import urlencode
+        from google.resumable_media.requests import ResumableUpload
+
+        bucket = _Bucket(name="whammy", user_project=user_project)
+        blob = self._make_one(u"blob-name", bucket=bucket, kms_key_name=kms_key_name)
+        blob.metadata = {"rook": "takes knight"}
+        blob.chunk_size = blob_chunk_size
+        if blob_chunk_size is not None:
+            self.assertIsNotNone(blob.chunk_size)
+        else:
+            self.assertIsNone(blob.chunk_size)
+
+        # Need to make sure **same** dict is used because ``json.dumps()``
+        # will depend on the hash order.
+        object_metadata = blob._get_writable_metadata()
+        blob._get_writable_metadata = mock.Mock(return_value=object_metadata, spec=[])
+
+        # Create mocks to be checked for doing transport.
+        resumable_url = "http://test.invalid?upload_id=hey-you"
+        response_headers = {"location": resumable_url}
+        transport = self._mock_transport(http_client.OK, response_headers)
+
+        # Create some mock arguments and call the method under test.
+        client = mock.Mock(_http=transport, spec=[u"_http"])
+        data = b"hello hallo halo hi-low"
+        stream = io.BytesIO(data)
+        content_type = u"text/plain"
+        upload, transport = blob._initiate_resumable_upload(
+            client,
+            stream,
+            content_type,
+            size,
+            num_retries,
+            extra_headers=extra_headers,
+            chunk_size=chunk_size,
+            predefined_acl=predefined_acl,
+        )
+
+        # Check the returned values.
+        self.assertIsInstance(upload, ResumableUpload)
+
+        upload_url = "https://www.googleapis.com/upload/storage/v1" + bucket.path + "/o"
+        qs_params = [("uploadType", "resumable")]
+
+        if user_project is not None:
+            qs_params.append(("userProject", user_project))
+
+        if predefined_acl is not None:
+            qs_params.append(("predefinedAcl", predefined_acl))
+
+        if kms_key_name is not None:
+            qs_params.append(("kmsKeyName", kms_key_name))
+
+        upload_url += "?" + urlencode(qs_params)
+
+        self.assertEqual(upload.upload_url, upload_url)
+        if extra_headers is None:
+            self.assertEqual(upload._headers, {})
+        else:
+            self.assertEqual(upload._headers, extra_headers)
+            self.assertIsNot(upload._headers, extra_headers)
+        self.assertFalse(upload.finished)
+        if chunk_size is None:
+            if blob_chunk_size is None:
+                self.assertEqual(
+                    upload._chunk_size, google.cloud.storage.blob._DEFAULT_CHUNKSIZE
+                )
+            else:
+                self.assertEqual(upload._chunk_size, blob.chunk_size)
+        else:
+            self.assertNotEqual(blob.chunk_size, chunk_size)
+            self.assertEqual(upload._chunk_size, chunk_size)
+        self.assertIs(upload._stream, stream)
+        if size is None:
+            self.assertIsNone(upload._total_bytes)
+        else:
+            self.assertEqual(upload._total_bytes, size)
+        self.assertEqual(upload._content_type, content_type)
+        self.assertEqual(upload.resumable_url, resumable_url)
+        retry_strategy = upload._retry_strategy
+        self.assertEqual(retry_strategy.max_sleep, 64.0)
+        if num_retries is None:
+            self.assertEqual(retry_strategy.max_cumulative_retry, 600.0)
+            self.assertIsNone(retry_strategy.max_retries)
+        else:
+            self.assertIsNone(retry_strategy.max_cumulative_retry)
+            self.assertEqual(retry_strategy.max_retries, num_retries)
+        self.assertIs(transport, transport)
+        # Make sure we never read from the stream.
+        self.assertEqual(stream.tell(), 0)
+
+        # Check the mocks.
+        blob._get_writable_metadata.assert_called_once_with()
+        payload = json.dumps(object_metadata).encode("utf-8")
+        expected_headers = {
+            "content-type": "application/json; charset=UTF-8",
+            "x-upload-content-type": content_type,
+        }
+        if size is not None:
+            expected_headers["x-upload-content-length"] = str(size)
+        if extra_headers is not None:
+            expected_headers.update(extra_headers)
+        transport.request.assert_called_once_with(
+            "POST", upload_url, data=payload, headers=expected_headers, timeout=mock.ANY
+        )
+
+    def test__initiate_resumable_upload_no_size(self):
+        self._initiate_resumable_helper()
+
+    def test__initiate_resumable_upload_with_size(self):
+        self._initiate_resumable_helper(size=10000)
+
+    def test__initiate_resumable_upload_with_user_project(self):
+        user_project = "user-project-123"
+        self._initiate_resumable_helper(user_project=user_project)
+
+    def test__initiate_resumable_upload_with_kms(self):
+        kms_resource = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        self._initiate_resumable_helper(kms_key_name=kms_resource)
+
+    def test__initiate_resumable_upload_without_chunk_size(self):
+        self._initiate_resumable_helper(blob_chunk_size=None)
+
+    def test__initiate_resumable_upload_with_chunk_size(self):
+        one_mb = 1048576
+        self._initiate_resumable_helper(chunk_size=one_mb)
+
+    def test__initiate_resumable_upload_with_extra_headers(self):
+        extra_headers = {"origin": "http://not-in-kansas-anymore.invalid"}
+        self._initiate_resumable_helper(extra_headers=extra_headers)
+
+    def test__initiate_resumable_upload_with_retry(self):
+        self._initiate_resumable_helper(num_retries=11)
+
+    def test__initiate_resumable_upload_with_predefined_acl(self):
+        self._initiate_resumable_helper(predefined_acl="private")
+
+    def _make_resumable_transport(self, headers1, headers2, headers3, total_bytes):
+        from google import resumable_media
+
+        fake_transport = mock.Mock(spec=["request"])
+
+        fake_response1 = self._mock_requests_response(http_client.OK, headers1)
+        fake_response2 = self._mock_requests_response(
+            resumable_media.PERMANENT_REDIRECT, headers2
+        )
+        json_body = '{{"size": "{:d}"}}'.format(total_bytes)
+        fake_response3 = self._mock_requests_response(
+            http_client.OK, headers3, content=json_body.encode("utf-8")
+        )
+
+        responses = [fake_response1, fake_response2, fake_response3]
+        fake_transport.request.side_effect = responses
+        return fake_transport, responses
+
+    @staticmethod
+    def _do_resumable_upload_call0(blob, content_type, size=None, predefined_acl=None):
+        # First mock transport.request() does initiates upload.
+        upload_url = (
+            "https://www.googleapis.com/upload/storage/v1"
+            + blob.bucket.path
+            + "/o?uploadType=resumable"
+        )
+        if predefined_acl is not None:
+            upload_url += "&predefinedAcl={}".format(predefined_acl)
+        expected_headers = {
+            "content-type": "application/json; charset=UTF-8",
+            "x-upload-content-type": content_type,
+        }
+        if size is not None:
+            expected_headers["x-upload-content-length"] = str(size)
+        payload = json.dumps({"name": blob.name}).encode("utf-8")
+        return mock.call(
+            "POST", upload_url, data=payload, headers=expected_headers, timeout=mock.ANY
+        )
+
+    @staticmethod
+    def _do_resumable_upload_call1(
+        blob, content_type, data, resumable_url, size=None, predefined_acl=None
+    ):
+        # Second mock transport.request() does sends first chunk.
+        if size is None:
+            content_range = "bytes 0-{:d}/*".format(blob.chunk_size - 1)
+        else:
+            content_range = "bytes 0-{:d}/{:d}".format(blob.chunk_size - 1, size)
+
+        expected_headers = {
+            "content-type": content_type,
+            "content-range": content_range,
+        }
+        payload = data[: blob.chunk_size]
+        return mock.call(
+            "PUT",
+            resumable_url,
+            data=payload,
+            headers=expected_headers,
+            timeout=mock.ANY,
+        )
+
+    @staticmethod
+    def _do_resumable_upload_call2(
+        blob, content_type, data, resumable_url, total_bytes, predefined_acl=None
+    ):
+        # Third mock transport.request() does sends last chunk.
+        content_range = "bytes {:d}-{:d}/{:d}".format(
+            blob.chunk_size, total_bytes - 1, total_bytes
+        )
+        expected_headers = {
+            "content-type": content_type,
+            "content-range": content_range,
+        }
+        payload = data[blob.chunk_size :]
+        return mock.call(
+            "PUT",
+            resumable_url,
+            data=payload,
+            headers=expected_headers,
+            timeout=mock.ANY,
+        )
+
+    def _do_resumable_helper(
+        self, use_size=False, num_retries=None, predefined_acl=None
+    ):
+        bucket = _Bucket(name="yesterday")
+        blob = self._make_one(u"blob-name", bucket=bucket)
+        blob.chunk_size = blob._CHUNK_SIZE_MULTIPLE
+        self.assertIsNotNone(blob.chunk_size)
+
+        # Data to be uploaded.
+        data = b"<html>" + (b"A" * blob.chunk_size) + b"</html>"
+        total_bytes = len(data)
+        if use_size:
+            size = total_bytes
+        else:
+            size = None
+
+        # Create mocks to be checked for doing transport.
+        resumable_url = "http://test.invalid?upload_id=and-then-there-was-1"
+        headers1 = {"location": resumable_url}
+        headers2 = {"range": "bytes=0-{:d}".format(blob.chunk_size - 1)}
+        transport, responses = self._make_resumable_transport(
+            headers1, headers2, {}, total_bytes
+        )
+
+        # Create some mock arguments and call the method under test.
+        client = mock.Mock(_http=transport, spec=["_http"])
+        stream = io.BytesIO(data)
+        content_type = u"text/html"
+        response = blob._do_resumable_upload(
+            client, stream, content_type, size, num_retries, predefined_acl
+        )
+
+        # Check the returned values.
+        self.assertIs(response, responses[2])
+        self.assertEqual(stream.tell(), total_bytes)
+
+        # Check the mocks.
+        call0 = self._do_resumable_upload_call0(
+            blob, content_type, size=size, predefined_acl=predefined_acl
+        )
+        call1 = self._do_resumable_upload_call1(
+            blob,
+            content_type,
+            data,
+            resumable_url,
+            size=size,
+            predefined_acl=predefined_acl,
+        )
+        call2 = self._do_resumable_upload_call2(
+            blob,
+            content_type,
+            data,
+            resumable_url,
+            total_bytes,
+            predefined_acl=predefined_acl,
+        )
+        self.assertEqual(transport.request.mock_calls, [call0, call1, call2])
+
+    def test__do_resumable_upload_no_size(self):
+        self._do_resumable_helper()
+
+    def test__do_resumable_upload_with_size(self):
+        self._do_resumable_helper(use_size=True)
+
+    def test__do_resumable_upload_with_retry(self):
+        self._do_resumable_helper(num_retries=6)
+
+    def test__do_resumable_upload_with_predefined_acl(self):
+        self._do_resumable_helper(predefined_acl="private")
+
+    def _do_upload_helper(
+        self, chunk_size=None, num_retries=None, predefined_acl=None, size=None
+    ):
+        blob = self._make_one(u"blob-name", bucket=None)
+
+        # Create a fake response.
+        response = mock.Mock(spec=[u"json"])
+        response.json.return_value = mock.sentinel.json
+        # Mock **both** helpers.
+        blob._do_multipart_upload = mock.Mock(return_value=response, spec=[])
+        blob._do_resumable_upload = mock.Mock(return_value=response, spec=[])
+
+        if chunk_size is None:
+            self.assertIsNone(blob.chunk_size)
+        else:
+            blob.chunk_size = chunk_size
+            self.assertIsNotNone(blob.chunk_size)
+
+        client = mock.sentinel.client
+        stream = mock.sentinel.stream
+        content_type = u"video/mp4"
+        if size is None:
+            size = 12345654321
+        # Make the request and check the mocks.
+        created_json = blob._do_upload(
+            client, stream, content_type, size, num_retries, predefined_acl
+        )
+        self.assertIs(created_json, mock.sentinel.json)
+        response.json.assert_called_once_with()
+        if size is not None and size <= google.cloud.storage.blob._MAX_MULTIPART_SIZE:
+            blob._do_multipart_upload.assert_called_once_with(
+                client, stream, content_type, size, num_retries, predefined_acl
+            )
+            blob._do_resumable_upload.assert_not_called()
+        else:
+            blob._do_multipart_upload.assert_not_called()
+            blob._do_resumable_upload.assert_called_once_with(
+                client, stream, content_type, size, num_retries, predefined_acl
+            )
+
+    def test__do_upload_uses_multipart(self):
+        self._do_upload_helper(size=google.cloud.storage.blob._MAX_MULTIPART_SIZE)
+
+    def test__do_upload_uses_resumable(self):
+        self._do_upload_helper(
+            chunk_size=256 * 1024,  # 256KB
+            size=google.cloud.storage.blob._MAX_MULTIPART_SIZE + 1,
+        )
+
+    def test__do_upload_with_retry(self):
+        self._do_upload_helper(num_retries=20)
+
+    def _upload_from_file_helper(self, side_effect=None, **kwargs):
+        from google.cloud._helpers import UTC
+
+        blob = self._make_one("blob-name", bucket=None)
+        # Mock low-level upload helper on blob (it is tested elsewhere).
+        created_json = {"updated": "2017-01-01T09:09:09.081Z"}
+        blob._do_upload = mock.Mock(return_value=created_json, spec=[])
+        if side_effect is not None:
+            blob._do_upload.side_effect = side_effect
+        # Make sure `updated` is empty before the request.
+        self.assertIsNone(blob.updated)
+
+        data = b"data is here"
+        stream = io.BytesIO(data)
+        stream.seek(2)  # Not at zero.
+        content_type = u"font/woff"
+        client = mock.sentinel.client
+        predefined_acl = kwargs.get("predefined_acl", None)
+        ret_val = blob.upload_from_file(
+            stream, size=len(data), content_type=content_type, client=client, **kwargs
+        )
+
+        # Check the response and side-effects.
+        self.assertIsNone(ret_val)
+        new_updated = datetime.datetime(2017, 1, 1, 9, 9, 9, 81000, tzinfo=UTC)
+        self.assertEqual(blob.updated, new_updated)
+
+        # Check the mock.
+        num_retries = kwargs.get("num_retries")
+        blob._do_upload.assert_called_once_with(
+            client, stream, content_type, len(data), num_retries, predefined_acl
+        )
+        return stream
+
+    def test_upload_from_file_success(self):
+        stream = self._upload_from_file_helper(predefined_acl="private")
+        assert stream.tell() == 2
+
+    @mock.patch("warnings.warn")
+    def test_upload_from_file_with_retries(self, mock_warn):
+        from google.cloud.storage import blob as blob_module
+
+        self._upload_from_file_helper(num_retries=20)
+        mock_warn.assert_called_once_with(
+            blob_module._NUM_RETRIES_MESSAGE, DeprecationWarning, stacklevel=2
+        )
+
+    def test_upload_from_file_with_rewind(self):
+        stream = self._upload_from_file_helper(rewind=True)
+        assert stream.tell() == 0
+
+    def test_upload_from_file_failure(self):
+        import requests
+
+        from google.resumable_media import InvalidResponse
+        from google.cloud import exceptions
+
+        message = "Someone is already in this spot."
+        response = requests.Response()
+        response.status_code = http_client.CONFLICT
+        response.request = requests.Request("POST", "http://example.com").prepare()
+        side_effect = InvalidResponse(response, message)
+
+        with self.assertRaises(exceptions.Conflict) as exc_info:
+            self._upload_from_file_helper(side_effect=side_effect)
+
+        self.assertIn(message, exc_info.exception.message)
+        self.assertEqual(exc_info.exception.errors, [])
+
+    def _do_upload_mock_call_helper(self, blob, client, content_type, size):
+        self.assertEqual(blob._do_upload.call_count, 1)
+        mock_call = blob._do_upload.mock_calls[0]
+        call_name, pos_args, kwargs = mock_call
+        self.assertEqual(call_name, "")
+        self.assertEqual(len(pos_args), 6)
+        self.assertEqual(pos_args[0], client)
+        self.assertEqual(pos_args[2], content_type)
+        self.assertEqual(pos_args[3], size)
+        self.assertIsNone(pos_args[4])  # num_retries
+        self.assertIsNone(pos_args[5])  # predefined_acl
+        self.assertEqual(kwargs, {})
+
+        return pos_args[1]
+
+    def test_upload_from_filename(self):
+        from google.cloud._testing import _NamedTemporaryFile
+
+        blob = self._make_one("blob-name", bucket=None)
+        # Mock low-level upload helper on blob (it is tested elsewhere).
+        created_json = {"metadata": {"mint": "ice-cream"}}
+        blob._do_upload = mock.Mock(return_value=created_json, spec=[])
+        # Make sure `metadata` is empty before the request.
+        self.assertIsNone(blob.metadata)
+
+        data = b"soooo much data"
+        content_type = u"image/svg+xml"
+        client = mock.sentinel.client
+        with _NamedTemporaryFile() as temp:
+            with open(temp.name, "wb") as file_obj:
+                file_obj.write(data)
+
+            ret_val = blob.upload_from_filename(
+                temp.name, content_type=content_type, client=client
+            )
+
+        # Check the response and side-effects.
+        self.assertIsNone(ret_val)
+        self.assertEqual(blob.metadata, created_json["metadata"])
+
+        # Check the mock.
+        stream = self._do_upload_mock_call_helper(blob, client, content_type, len(data))
+        self.assertTrue(stream.closed)
+        self.assertEqual(stream.mode, "rb")
+        self.assertEqual(stream.name, temp.name)
+
+    def _upload_from_string_helper(self, data, **kwargs):
+        from google.cloud._helpers import _to_bytes
+
+        blob = self._make_one("blob-name", bucket=None)
+
+        # Mock low-level upload helper on blob (it is tested elsewhere).
+        created_json = {"componentCount": "5"}
+        blob._do_upload = mock.Mock(return_value=created_json, spec=[])
+        # Make sure `metadata` is empty before the request.
+        self.assertIsNone(blob.component_count)
+
+        client = mock.sentinel.client
+        ret_val = blob.upload_from_string(data, client=client, **kwargs)
+
+        # Check the response and side-effects.
+        self.assertIsNone(ret_val)
+        self.assertEqual(blob.component_count, 5)
+
+        # Check the mock.
+        payload = _to_bytes(data, encoding="utf-8")
+        stream = self._do_upload_mock_call_helper(
+            blob, client, "text/plain", len(payload)
+        )
+        self.assertIsInstance(stream, io.BytesIO)
+        self.assertEqual(stream.getvalue(), payload)
+
+    def test_upload_from_string_w_bytes(self):
+        data = b"XB]jb\xb8tad\xe0"
+        self._upload_from_string_helper(data)
+
+    def test_upload_from_string_w_text(self):
+        data = u"\N{snowman} \N{sailboat}"
+        self._upload_from_string_helper(data)
+
+    def _create_resumable_upload_session_helper(self, origin=None, side_effect=None):
+        bucket = _Bucket(name="alex-trebek")
+        blob = self._make_one("blob-name", bucket=bucket)
+        chunk_size = 99 * blob._CHUNK_SIZE_MULTIPLE
+        blob.chunk_size = chunk_size
+
+        # Create mocks to be checked for doing transport.
+        resumable_url = "http://test.invalid?upload_id=clean-up-everybody"
+        response_headers = {"location": resumable_url}
+        transport = self._mock_transport(http_client.OK, response_headers)
+        if side_effect is not None:
+            transport.request.side_effect = side_effect
+
+        # Create some mock arguments and call the method under test.
+        content_type = u"text/plain"
+        size = 10000
+        client = mock.Mock(_http=transport, spec=[u"_http"])
+        new_url = blob.create_resumable_upload_session(
+            content_type=content_type, size=size, origin=origin, client=client
+        )
+
+        # Check the returned value and (lack of) side-effect.
+        self.assertEqual(new_url, resumable_url)
+        self.assertEqual(blob.chunk_size, chunk_size)
+
+        # Check the mocks.
+        upload_url = (
+            "https://www.googleapis.com/upload/storage/v1"
+            + bucket.path
+            + "/o?uploadType=resumable"
+        )
+        payload = b'{"name": "blob-name"}'
+        expected_headers = {
+            "content-type": "application/json; charset=UTF-8",
+            "x-upload-content-length": str(size),
+            "x-upload-content-type": content_type,
+        }
+        if origin is not None:
+            expected_headers["Origin"] = origin
+        transport.request.assert_called_once_with(
+            "POST", upload_url, data=payload, headers=expected_headers, timeout=mock.ANY
+        )
+
+    def test_create_resumable_upload_session(self):
+        self._create_resumable_upload_session_helper()
+
+    def test_create_resumable_upload_session_with_origin(self):
+        self._create_resumable_upload_session_helper(origin="http://google.com")
+
+    def test_create_resumable_upload_session_with_failure(self):
+        from google.resumable_media import InvalidResponse
+        from google.cloud import exceptions
+
+        message = "5-oh-3 woe is me."
+        response = self._mock_requests_response(
+            status_code=http_client.SERVICE_UNAVAILABLE, headers={}
+        )
+        side_effect = InvalidResponse(response, message)
+
+        with self.assertRaises(exceptions.ServiceUnavailable) as exc_info:
+            self._create_resumable_upload_session_helper(side_effect=side_effect)
+
+        self.assertIn(message, exc_info.exception.message)
+        self.assertEqual(exc_info.exception.errors, [])
+
+    def test_get_iam_policy(self):
+        from google.cloud.storage.iam import STORAGE_OWNER_ROLE
+        from google.cloud.storage.iam import STORAGE_EDITOR_ROLE
+        from google.cloud.storage.iam import STORAGE_VIEWER_ROLE
+        from google.api_core.iam import Policy
+
+        BLOB_NAME = "blob-name"
+        PATH = "/b/name/o/%s" % (BLOB_NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        OWNER1 = "user:phred@example.com"
+        OWNER2 = "group:cloud-logs@google.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        RETURNED = {
+            "resourceId": PATH,
+            "etag": ETAG,
+            "version": VERSION,
+            "bindings": [
+                {"role": STORAGE_OWNER_ROLE, "members": [OWNER1, OWNER2]},
+                {"role": STORAGE_EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+                {"role": STORAGE_VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+            ],
+        }
+        after = ({"status": http_client.OK}, RETURNED)
+        EXPECTED = {
+            binding["role"]: set(binding["members"]) for binding in RETURNED["bindings"]
+        }
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        policy = blob.get_iam_policy()
+
+        self.assertIsInstance(policy, Policy)
+        self.assertEqual(policy.etag, RETURNED["etag"])
+        self.assertEqual(policy.version, RETURNED["version"])
+        self.assertEqual(dict(policy), EXPECTED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "GET",
+                "path": "%s/iam" % (PATH,),
+                "query_params": {},
+                "_target_object": None,
+            },
+        )
+
+    def test_get_iam_policy_w_user_project(self):
+        from google.api_core.iam import Policy
+
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        PATH = "/b/name/o/%s" % (BLOB_NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        RETURNED = {
+            "resourceId": PATH,
+            "etag": ETAG,
+            "version": VERSION,
+            "bindings": [],
+        }
+        after = ({"status": http_client.OK}, RETURNED)
+        EXPECTED = {}
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client, user_project=USER_PROJECT)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        policy = blob.get_iam_policy()
+
+        self.assertIsInstance(policy, Policy)
+        self.assertEqual(policy.etag, RETURNED["etag"])
+        self.assertEqual(policy.version, RETURNED["version"])
+        self.assertEqual(dict(policy), EXPECTED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "GET",
+                "path": "%s/iam" % (PATH,),
+                "query_params": {"userProject": USER_PROJECT},
+                "_target_object": None,
+            },
+        )
+
+    def test_set_iam_policy(self):
+        import operator
+        from google.cloud.storage.iam import STORAGE_OWNER_ROLE
+        from google.cloud.storage.iam import STORAGE_EDITOR_ROLE
+        from google.cloud.storage.iam import STORAGE_VIEWER_ROLE
+        from google.api_core.iam import Policy
+
+        BLOB_NAME = "blob-name"
+        PATH = "/b/name/o/%s" % (BLOB_NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        OWNER1 = "user:phred@example.com"
+        OWNER2 = "group:cloud-logs@google.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        BINDINGS = [
+            {"role": STORAGE_OWNER_ROLE, "members": [OWNER1, OWNER2]},
+            {"role": STORAGE_EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+            {"role": STORAGE_VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+        ]
+        RETURNED = {"etag": ETAG, "version": VERSION, "bindings": BINDINGS}
+        after = ({"status": http_client.OK}, RETURNED)
+        policy = Policy()
+        for binding in BINDINGS:
+            policy[binding["role"]] = binding["members"]
+
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        returned = blob.set_iam_policy(policy)
+
+        self.assertEqual(returned.etag, ETAG)
+        self.assertEqual(returned.version, VERSION)
+        self.assertEqual(dict(returned), dict(policy))
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PUT")
+        self.assertEqual(kw[0]["path"], "%s/iam" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {})
+        sent = kw[0]["data"]
+        self.assertEqual(sent["resourceId"], PATH)
+        self.assertEqual(len(sent["bindings"]), len(BINDINGS))
+        key = operator.itemgetter("role")
+        for found, expected in zip(
+            sorted(sent["bindings"], key=key), sorted(BINDINGS, key=key)
+        ):
+            self.assertEqual(found["role"], expected["role"])
+            self.assertEqual(sorted(found["members"]), sorted(expected["members"]))
+
+    def test_set_iam_policy_w_user_project(self):
+        from google.api_core.iam import Policy
+
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        PATH = "/b/name/o/%s" % (BLOB_NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        BINDINGS = []
+        RETURNED = {"etag": ETAG, "version": VERSION, "bindings": BINDINGS}
+        after = ({"status": http_client.OK}, RETURNED)
+        policy = Policy()
+
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client, user_project=USER_PROJECT)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        returned = blob.set_iam_policy(policy)
+
+        self.assertEqual(returned.etag, ETAG)
+        self.assertEqual(returned.version, VERSION)
+        self.assertEqual(dict(returned), dict(policy))
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PUT")
+        self.assertEqual(kw[0]["path"], "%s/iam" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {"userProject": USER_PROJECT})
+        self.assertEqual(kw[0]["data"], {"resourceId": PATH})
+
+    def test_test_iam_permissions(self):
+        from google.cloud.storage.iam import STORAGE_OBJECTS_LIST
+        from google.cloud.storage.iam import STORAGE_BUCKETS_GET
+        from google.cloud.storage.iam import STORAGE_BUCKETS_UPDATE
+
+        BLOB_NAME = "blob-name"
+        PATH = "/b/name/o/%s" % (BLOB_NAME,)
+        PERMISSIONS = [
+            STORAGE_OBJECTS_LIST,
+            STORAGE_BUCKETS_GET,
+            STORAGE_BUCKETS_UPDATE,
+        ]
+        ALLOWED = PERMISSIONS[1:]
+        RETURNED = {"permissions": ALLOWED}
+        after = ({"status": http_client.OK}, RETURNED)
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        allowed = blob.test_iam_permissions(PERMISSIONS)
+
+        self.assertEqual(allowed, ALLOWED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "GET")
+        self.assertEqual(kw[0]["path"], "%s/iam/testPermissions" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {"permissions": PERMISSIONS})
+
+    def test_test_iam_permissions_w_user_project(self):
+        from google.cloud.storage.iam import STORAGE_OBJECTS_LIST
+        from google.cloud.storage.iam import STORAGE_BUCKETS_GET
+        from google.cloud.storage.iam import STORAGE_BUCKETS_UPDATE
+
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        PATH = "/b/name/o/%s" % (BLOB_NAME,)
+        PERMISSIONS = [
+            STORAGE_OBJECTS_LIST,
+            STORAGE_BUCKETS_GET,
+            STORAGE_BUCKETS_UPDATE,
+        ]
+        ALLOWED = PERMISSIONS[1:]
+        RETURNED = {"permissions": ALLOWED}
+        after = ({"status": http_client.OK}, RETURNED)
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client, user_project=USER_PROJECT)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        allowed = blob.test_iam_permissions(PERMISSIONS)
+
+        self.assertEqual(allowed, ALLOWED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "GET")
+        self.assertEqual(kw[0]["path"], "%s/iam/testPermissions" % (PATH,))
+        self.assertEqual(
+            kw[0]["query_params"],
+            {"permissions": PERMISSIONS, "userProject": USER_PROJECT},
+        )
+
+    def test_make_public(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        BLOB_NAME = "blob-name"
+        permissive = [{"entity": "allUsers", "role": _ACLEntity.READER_ROLE}]
+        after = ({"status": http_client.OK}, {"acl": permissive})
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        blob.acl.loaded = True
+        blob.make_public()
+        self.assertEqual(list(blob.acl), permissive)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/name/o/%s" % BLOB_NAME)
+        self.assertEqual(kw[0]["data"], {"acl": permissive})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+
+    def test_make_private(self):
+        BLOB_NAME = "blob-name"
+        no_permissions = []
+        after = ({"status": http_client.OK}, {"acl": no_permissions})
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        blob.acl.loaded = True
+        blob.make_private()
+        self.assertEqual(list(blob.acl), no_permissions)
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/name/o/%s" % BLOB_NAME)
+        self.assertEqual(kw[0]["data"], {"acl": no_permissions})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+
+    def test_compose_wo_content_type_set(self):
+        SOURCE_1 = "source-1"
+        SOURCE_2 = "source-2"
+        DESTINATION = "destinaton"
+        RESOURCE = {}
+        after = ({"status": http_client.OK}, RESOURCE)
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        source_1 = self._make_one(SOURCE_1, bucket=bucket)
+        source_2 = self._make_one(SOURCE_2, bucket=bucket)
+        destination = self._make_one(DESTINATION, bucket=bucket)
+        # no destination.content_type set
+
+        destination.compose(sources=[source_1, source_2])
+
+        self.assertIsNone(destination.content_type)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "POST",
+                "path": "/b/name/o/%s/compose" % DESTINATION,
+                "query_params": {},
+                "data": {
+                    "sourceObjects": [{"name": source_1.name}, {"name": source_2.name}],
+                    "destination": {},
+                },
+                "_target_object": destination,
+            },
+        )
+
+    def test_compose_minimal_w_user_project(self):
+        SOURCE_1 = "source-1"
+        SOURCE_2 = "source-2"
+        DESTINATION = "destinaton"
+        RESOURCE = {"etag": "DEADBEEF"}
+        USER_PROJECT = "user-project-123"
+        after = ({"status": http_client.OK}, RESOURCE)
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client, user_project=USER_PROJECT)
+        source_1 = self._make_one(SOURCE_1, bucket=bucket)
+        source_2 = self._make_one(SOURCE_2, bucket=bucket)
+        destination = self._make_one(DESTINATION, bucket=bucket)
+        destination.content_type = "text/plain"
+
+        destination.compose(sources=[source_1, source_2])
+
+        self.assertEqual(destination.etag, "DEADBEEF")
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "POST",
+                "path": "/b/name/o/%s/compose" % DESTINATION,
+                "query_params": {"userProject": USER_PROJECT},
+                "data": {
+                    "sourceObjects": [{"name": source_1.name}, {"name": source_2.name}],
+                    "destination": {"contentType": "text/plain"},
+                },
+                "_target_object": destination,
+            },
+        )
+
+    def test_compose_w_additional_property_changes(self):
+        SOURCE_1 = "source-1"
+        SOURCE_2 = "source-2"
+        DESTINATION = "destinaton"
+        RESOURCE = {"etag": "DEADBEEF"}
+        after = ({"status": http_client.OK}, RESOURCE)
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        source_1 = self._make_one(SOURCE_1, bucket=bucket)
+        source_2 = self._make_one(SOURCE_2, bucket=bucket)
+        destination = self._make_one(DESTINATION, bucket=bucket)
+        destination.content_type = "text/plain"
+        destination.content_language = "en-US"
+        destination.metadata = {"my-key": "my-value"}
+
+        destination.compose(sources=[source_1, source_2])
+
+        self.assertEqual(destination.etag, "DEADBEEF")
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(
+            kw[0],
+            {
+                "method": "POST",
+                "path": "/b/name/o/%s/compose" % DESTINATION,
+                "query_params": {},
+                "data": {
+                    "sourceObjects": [{"name": source_1.name}, {"name": source_2.name}],
+                    "destination": {
+                        "contentType": "text/plain",
+                        "contentLanguage": "en-US",
+                        "metadata": {"my-key": "my-value"},
+                    },
+                },
+                "_target_object": destination,
+            },
+        )
+
+    def test_rewrite_response_without_resource(self):
+        SOURCE_BLOB = "source"
+        DEST_BLOB = "dest"
+        DEST_BUCKET = "other-bucket"
+        TOKEN = "TOKEN"
+        RESPONSE = {
+            "totalBytesRewritten": 33,
+            "objectSize": 42,
+            "done": False,
+            "rewriteToken": TOKEN,
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        source_bucket = _Bucket(client=client)
+        source_blob = self._make_one(SOURCE_BLOB, bucket=source_bucket)
+        dest_bucket = _Bucket(client=client, name=DEST_BUCKET)
+        dest_blob = self._make_one(DEST_BLOB, bucket=dest_bucket)
+
+        token, rewritten, size = dest_blob.rewrite(source_blob)
+
+        self.assertEqual(token, TOKEN)
+        self.assertEqual(rewritten, 33)
+        self.assertEqual(size, 42)
+
+    def test_rewrite_w_generations(self):
+        SOURCE_BLOB = "source"
+        SOURCE_GENERATION = 42
+        DEST_BLOB = "dest"
+        DEST_BUCKET = "other-bucket"
+        DEST_GENERATION = 43
+        TOKEN = "TOKEN"
+        RESPONSE = {
+            "totalBytesRewritten": 33,
+            "objectSize": 42,
+            "done": False,
+            "rewriteToken": TOKEN,
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        source_bucket = _Bucket(client=client)
+        source_blob = self._make_one(
+            SOURCE_BLOB, bucket=source_bucket, generation=SOURCE_GENERATION
+        )
+        dest_bucket = _Bucket(client=client, name=DEST_BUCKET)
+        dest_blob = self._make_one(
+            DEST_BLOB, bucket=dest_bucket, generation=DEST_GENERATION
+        )
+
+        token, rewritten, size = dest_blob.rewrite(source_blob)
+
+        self.assertEqual(token, TOKEN)
+        self.assertEqual(rewritten, 33)
+        self.assertEqual(size, 42)
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(
+            kw["path"],
+            "/b/%s/o/%s/rewriteTo/b/%s/o/%s"
+            % (
+                (source_bucket.name, source_blob.name, dest_bucket.name, dest_blob.name)
+            ),
+        )
+        self.assertEqual(kw["query_params"], {"sourceGeneration": SOURCE_GENERATION})
+
+    def test_rewrite_other_bucket_other_name_no_encryption_partial(self):
+        SOURCE_BLOB = "source"
+        DEST_BLOB = "dest"
+        DEST_BUCKET = "other-bucket"
+        TOKEN = "TOKEN"
+        RESPONSE = {
+            "totalBytesRewritten": 33,
+            "objectSize": 42,
+            "done": False,
+            "rewriteToken": TOKEN,
+            "resource": {"etag": "DEADBEEF"},
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        source_bucket = _Bucket(client=client)
+        source_blob = self._make_one(SOURCE_BLOB, bucket=source_bucket)
+        dest_bucket = _Bucket(client=client, name=DEST_BUCKET)
+        dest_blob = self._make_one(DEST_BLOB, bucket=dest_bucket)
+
+        token, rewritten, size = dest_blob.rewrite(source_blob)
+
+        self.assertEqual(token, TOKEN)
+        self.assertEqual(rewritten, 33)
+        self.assertEqual(size, 42)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "POST")
+        PATH = "/b/name/o/%s/rewriteTo/b/%s/o/%s" % (
+            SOURCE_BLOB,
+            DEST_BUCKET,
+            DEST_BLOB,
+        )
+        self.assertEqual(kw[0]["path"], PATH)
+        self.assertEqual(kw[0]["query_params"], {})
+        SENT = {}
+        self.assertEqual(kw[0]["data"], SENT)
+
+        headers = {key.title(): str(value) for key, value in kw[0]["headers"].items()}
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Algorithm", headers)
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Key", headers)
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Key-Sha256", headers)
+        self.assertNotIn("X-Goog-Encryption-Algorithm", headers)
+        self.assertNotIn("X-Goog-Encryption-Key", headers)
+        self.assertNotIn("X-Goog-Encryption-Key-Sha256", headers)
+
+    def test_rewrite_same_name_no_old_key_new_key_done_w_user_project(self):
+        import base64
+        import hashlib
+
+        KEY = b"01234567890123456789012345678901"  # 32 bytes
+        KEY_B64 = base64.b64encode(KEY).rstrip().decode("ascii")
+        KEY_HASH = hashlib.sha256(KEY).digest()
+        KEY_HASH_B64 = base64.b64encode(KEY_HASH).rstrip().decode("ascii")
+        BLOB_NAME = "blob"
+        USER_PROJECT = "user-project-123"
+        RESPONSE = {
+            "totalBytesRewritten": 42,
+            "objectSize": 42,
+            "done": True,
+            "resource": {"etag": "DEADBEEF"},
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        bucket = _Bucket(client=client, user_project=USER_PROJECT)
+        plain = self._make_one(BLOB_NAME, bucket=bucket)
+        encrypted = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=KEY)
+
+        token, rewritten, size = encrypted.rewrite(plain)
+
+        self.assertIsNone(token)
+        self.assertEqual(rewritten, 42)
+        self.assertEqual(size, 42)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "POST")
+        PATH = "/b/name/o/%s/rewriteTo/b/name/o/%s" % (BLOB_NAME, BLOB_NAME)
+        self.assertEqual(kw[0]["path"], PATH)
+        self.assertEqual(kw[0]["query_params"], {"userProject": USER_PROJECT})
+        SENT = {}
+        self.assertEqual(kw[0]["data"], SENT)
+
+        headers = {key.title(): str(value) for key, value in kw[0]["headers"].items()}
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Algorithm", headers)
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Key", headers)
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Key-Sha256", headers)
+        self.assertEqual(headers["X-Goog-Encryption-Algorithm"], "AES256")
+        self.assertEqual(headers["X-Goog-Encryption-Key"], KEY_B64)
+        self.assertEqual(headers["X-Goog-Encryption-Key-Sha256"], KEY_HASH_B64)
+
+    def test_rewrite_same_name_no_key_new_key_w_token(self):
+        import base64
+        import hashlib
+
+        SOURCE_KEY = b"01234567890123456789012345678901"  # 32 bytes
+        SOURCE_KEY_B64 = base64.b64encode(SOURCE_KEY).rstrip().decode("ascii")
+        SOURCE_KEY_HASH = hashlib.sha256(SOURCE_KEY).digest()
+        SOURCE_KEY_HASH_B64 = base64.b64encode(SOURCE_KEY_HASH).rstrip().decode("ascii")
+        DEST_KEY = b"90123456789012345678901234567890"  # 32 bytes
+        DEST_KEY_B64 = base64.b64encode(DEST_KEY).rstrip().decode("ascii")
+        DEST_KEY_HASH = hashlib.sha256(DEST_KEY).digest()
+        DEST_KEY_HASH_B64 = base64.b64encode(DEST_KEY_HASH).rstrip().decode("ascii")
+        BLOB_NAME = "blob"
+        TOKEN = "TOKEN"
+        RESPONSE = {
+            "totalBytesRewritten": 42,
+            "objectSize": 42,
+            "done": True,
+            "resource": {"etag": "DEADBEEF"},
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        source = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=SOURCE_KEY)
+        dest = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=DEST_KEY)
+
+        token, rewritten, size = dest.rewrite(source, token=TOKEN)
+
+        self.assertIsNone(token)
+        self.assertEqual(rewritten, 42)
+        self.assertEqual(size, 42)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "POST")
+        PATH = "/b/name/o/%s/rewriteTo/b/name/o/%s" % (BLOB_NAME, BLOB_NAME)
+        self.assertEqual(kw[0]["path"], PATH)
+        self.assertEqual(kw[0]["query_params"], {"rewriteToken": TOKEN})
+        SENT = {}
+        self.assertEqual(kw[0]["data"], SENT)
+
+        headers = {key.title(): str(value) for key, value in kw[0]["headers"].items()}
+        self.assertEqual(headers["X-Goog-Copy-Source-Encryption-Algorithm"], "AES256")
+        self.assertEqual(headers["X-Goog-Copy-Source-Encryption-Key"], SOURCE_KEY_B64)
+        self.assertEqual(
+            headers["X-Goog-Copy-Source-Encryption-Key-Sha256"], SOURCE_KEY_HASH_B64
+        )
+        self.assertEqual(headers["X-Goog-Encryption-Algorithm"], "AES256")
+        self.assertEqual(headers["X-Goog-Encryption-Key"], DEST_KEY_B64)
+        self.assertEqual(headers["X-Goog-Encryption-Key-Sha256"], DEST_KEY_HASH_B64)
+
+    def test_rewrite_same_name_w_old_key_new_kms_key(self):
+        import base64
+        import hashlib
+
+        SOURCE_KEY = b"01234567890123456789012345678901"  # 32 bytes
+        SOURCE_KEY_B64 = base64.b64encode(SOURCE_KEY).rstrip().decode("ascii")
+        SOURCE_KEY_HASH = hashlib.sha256(SOURCE_KEY).digest()
+        SOURCE_KEY_HASH_B64 = base64.b64encode(SOURCE_KEY_HASH).rstrip().decode("ascii")
+        DEST_KMS_RESOURCE = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        BLOB_NAME = "blob"
+        RESPONSE = {
+            "totalBytesRewritten": 42,
+            "objectSize": 42,
+            "done": True,
+            "resource": {"etag": "DEADBEEF"},
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        source = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=SOURCE_KEY)
+        dest = self._make_one(BLOB_NAME, bucket=bucket, kms_key_name=DEST_KMS_RESOURCE)
+
+        token, rewritten, size = dest.rewrite(source)
+
+        self.assertIsNone(token)
+        self.assertEqual(rewritten, 42)
+        self.assertEqual(size, 42)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "POST")
+        PATH = "/b/name/o/%s/rewriteTo/b/name/o/%s" % (BLOB_NAME, BLOB_NAME)
+        self.assertEqual(kw[0]["path"], PATH)
+        self.assertEqual(
+            kw[0]["query_params"], {"destinationKmsKeyName": DEST_KMS_RESOURCE}
+        )
+        SENT = {"kmsKeyName": DEST_KMS_RESOURCE}
+        self.assertEqual(kw[0]["data"], SENT)
+
+        headers = {key.title(): str(value) for key, value in kw[0]["headers"].items()}
+        self.assertEqual(headers["X-Goog-Copy-Source-Encryption-Algorithm"], "AES256")
+        self.assertEqual(headers["X-Goog-Copy-Source-Encryption-Key"], SOURCE_KEY_B64)
+        self.assertEqual(
+            headers["X-Goog-Copy-Source-Encryption-Key-Sha256"], SOURCE_KEY_HASH_B64
+        )
+
+    def test_update_storage_class_invalid(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        with self.assertRaises(ValueError):
+            blob.update_storage_class(u"BOGUS")
+
+    def test_update_storage_class_large_file(self):
+        BLOB_NAME = "blob-name"
+        STORAGE_CLASS = u"NEARLINE"
+        TOKEN = "TOKEN"
+        INCOMPLETE_RESPONSE = {
+            "totalBytesRewritten": 42,
+            "objectSize": 84,
+            "done": False,
+            "rewriteToken": TOKEN,
+            "resource": {"storageClass": STORAGE_CLASS},
+        }
+        COMPLETE_RESPONSE = {
+            "totalBytesRewritten": 84,
+            "objectSize": 84,
+            "done": True,
+            "resource": {"storageClass": STORAGE_CLASS},
+        }
+        response_1 = ({"status": http_client.OK}, INCOMPLETE_RESPONSE)
+        response_2 = ({"status": http_client.OK}, COMPLETE_RESPONSE)
+        connection = _Connection(response_1, response_2)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        blob.update_storage_class("NEARLINE")
+
+        self.assertEqual(blob.storage_class, "NEARLINE")
+
+    def test_update_storage_class_wo_encryption_key(self):
+        BLOB_NAME = "blob-name"
+        STORAGE_CLASS = u"NEARLINE"
+        RESPONSE = {
+            "totalBytesRewritten": 42,
+            "objectSize": 42,
+            "done": True,
+            "resource": {"storageClass": STORAGE_CLASS},
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        bucket = _Bucket(client=client)
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+
+        blob.update_storage_class("NEARLINE")
+
+        self.assertEqual(blob.storage_class, "NEARLINE")
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "POST")
+        PATH = "/b/name/o/%s/rewriteTo/b/name/o/%s" % (BLOB_NAME, BLOB_NAME)
+        self.assertEqual(kw[0]["path"], PATH)
+        self.assertEqual(kw[0]["query_params"], {})
+        SENT = {"storageClass": STORAGE_CLASS}
+        self.assertEqual(kw[0]["data"], SENT)
+
+        headers = {key.title(): str(value) for key, value in kw[0]["headers"].items()}
+        # Blob has no key, and therefore the relevant headers are not sent.
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Algorithm", headers)
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Key", headers)
+        self.assertNotIn("X-Goog-Copy-Source-Encryption-Key-Sha256", headers)
+        self.assertNotIn("X-Goog-Encryption-Algorithm", headers)
+        self.assertNotIn("X-Goog-Encryption-Key", headers)
+        self.assertNotIn("X-Goog-Encryption-Key-Sha256", headers)
+
+    def test_update_storage_class_w_encryption_key_w_user_project(self):
+        import base64
+        import hashlib
+
+        BLOB_NAME = "blob-name"
+        BLOB_KEY = b"01234567890123456789012345678901"  # 32 bytes
+        BLOB_KEY_B64 = base64.b64encode(BLOB_KEY).rstrip().decode("ascii")
+        BLOB_KEY_HASH = hashlib.sha256(BLOB_KEY).digest()
+        BLOB_KEY_HASH_B64 = base64.b64encode(BLOB_KEY_HASH).rstrip().decode("ascii")
+        STORAGE_CLASS = u"NEARLINE"
+        USER_PROJECT = "user-project-123"
+        RESPONSE = {
+            "totalBytesRewritten": 42,
+            "objectSize": 42,
+            "done": True,
+            "resource": {"storageClass": STORAGE_CLASS},
+        }
+        response = ({"status": http_client.OK}, RESPONSE)
+        connection = _Connection(response)
+        client = _Client(connection)
+        bucket = _Bucket(client=client, user_project=USER_PROJECT)
+        blob = self._make_one(BLOB_NAME, bucket=bucket, encryption_key=BLOB_KEY)
+
+        blob.update_storage_class("NEARLINE")
+
+        self.assertEqual(blob.storage_class, "NEARLINE")
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "POST")
+        PATH = "/b/name/o/%s/rewriteTo/b/name/o/%s" % (BLOB_NAME, BLOB_NAME)
+        self.assertEqual(kw[0]["path"], PATH)
+        self.assertEqual(kw[0]["query_params"], {"userProject": USER_PROJECT})
+        SENT = {"storageClass": STORAGE_CLASS}
+        self.assertEqual(kw[0]["data"], SENT)
+
+        headers = {key.title(): str(value) for key, value in kw[0]["headers"].items()}
+        # Blob has key, and therefore the relevant headers are sent.
+        self.assertEqual(headers["X-Goog-Copy-Source-Encryption-Algorithm"], "AES256")
+        self.assertEqual(headers["X-Goog-Copy-Source-Encryption-Key"], BLOB_KEY_B64)
+        self.assertEqual(
+            headers["X-Goog-Copy-Source-Encryption-Key-Sha256"], BLOB_KEY_HASH_B64
+        )
+        self.assertEqual(headers["X-Goog-Encryption-Algorithm"], "AES256")
+        self.assertEqual(headers["X-Goog-Encryption-Key"], BLOB_KEY_B64)
+        self.assertEqual(headers["X-Goog-Encryption-Key-Sha256"], BLOB_KEY_HASH_B64)
+
+    def test_cache_control_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        CACHE_CONTROL = "no-cache"
+        properties = {"cacheControl": CACHE_CONTROL}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.cache_control, CACHE_CONTROL)
+
+    def test_cache_control_setter(self):
+        BLOB_NAME = "blob-name"
+        CACHE_CONTROL = "no-cache"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.cache_control)
+        blob.cache_control = CACHE_CONTROL
+        self.assertEqual(blob.cache_control, CACHE_CONTROL)
+
+    def test_component_count(self):
+        BUCKET = object()
+        COMPONENT_COUNT = 42
+        blob = self._make_one(
+            "blob-name", bucket=BUCKET, properties={"componentCount": COMPONENT_COUNT}
+        )
+        self.assertEqual(blob.component_count, COMPONENT_COUNT)
+
+    def test_component_count_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.component_count)
+
+    def test_component_count_string_val(self):
+        BUCKET = object()
+        COMPONENT_COUNT = 42
+        blob = self._make_one(
+            "blob-name",
+            bucket=BUCKET,
+            properties={"componentCount": str(COMPONENT_COUNT)},
+        )
+        self.assertEqual(blob.component_count, COMPONENT_COUNT)
+
+    def test_content_disposition_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        CONTENT_DISPOSITION = "Attachment; filename=example.jpg"
+        properties = {"contentDisposition": CONTENT_DISPOSITION}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.content_disposition, CONTENT_DISPOSITION)
+
+    def test_content_disposition_setter(self):
+        BLOB_NAME = "blob-name"
+        CONTENT_DISPOSITION = "Attachment; filename=example.jpg"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.content_disposition)
+        blob.content_disposition = CONTENT_DISPOSITION
+        self.assertEqual(blob.content_disposition, CONTENT_DISPOSITION)
+
+    def test_content_encoding_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        CONTENT_ENCODING = "gzip"
+        properties = {"contentEncoding": CONTENT_ENCODING}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.content_encoding, CONTENT_ENCODING)
+
+    def test_content_encoding_setter(self):
+        BLOB_NAME = "blob-name"
+        CONTENT_ENCODING = "gzip"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.content_encoding)
+        blob.content_encoding = CONTENT_ENCODING
+        self.assertEqual(blob.content_encoding, CONTENT_ENCODING)
+
+    def test_content_language_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        CONTENT_LANGUAGE = "pt-BR"
+        properties = {"contentLanguage": CONTENT_LANGUAGE}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.content_language, CONTENT_LANGUAGE)
+
+    def test_content_language_setter(self):
+        BLOB_NAME = "blob-name"
+        CONTENT_LANGUAGE = "pt-BR"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.content_language)
+        blob.content_language = CONTENT_LANGUAGE
+        self.assertEqual(blob.content_language, CONTENT_LANGUAGE)
+
+    def test_content_type_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        CONTENT_TYPE = "image/jpeg"
+        properties = {"contentType": CONTENT_TYPE}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.content_type, CONTENT_TYPE)
+
+    def test_content_type_setter(self):
+        BLOB_NAME = "blob-name"
+        CONTENT_TYPE = "image/jpeg"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.content_type)
+        blob.content_type = CONTENT_TYPE
+        self.assertEqual(blob.content_type, CONTENT_TYPE)
+
+    def test_crc32c_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        CRC32C = "DEADBEEF"
+        properties = {"crc32c": CRC32C}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.crc32c, CRC32C)
+
+    def test_crc32c_setter(self):
+        BLOB_NAME = "blob-name"
+        CRC32C = "DEADBEEF"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.crc32c)
+        blob.crc32c = CRC32C
+        self.assertEqual(blob.crc32c, CRC32C)
+
+    def test_etag(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        ETAG = "ETAG"
+        properties = {"etag": ETAG}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.etag, ETAG)
+
+    def test_event_based_hold_getter_missing(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertIsNone(blob.event_based_hold)
+
+    def test_event_based_hold_getter_false(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {"eventBasedHold": False}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertFalse(blob.event_based_hold)
+
+    def test_event_based_hold_getter_true(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {"eventBasedHold": True}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertTrue(blob.event_based_hold)
+
+    def test_event_based_hold_setter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.event_based_hold)
+        blob.event_based_hold = True
+        self.assertEqual(blob.event_based_hold, True)
+
+    def test_generation(self):
+        BUCKET = object()
+        GENERATION = 42
+        blob = self._make_one(
+            "blob-name", bucket=BUCKET, properties={"generation": GENERATION}
+        )
+        self.assertEqual(blob.generation, GENERATION)
+
+    def test_generation_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.generation)
+
+    def test_generation_string_val(self):
+        BUCKET = object()
+        GENERATION = 42
+        blob = self._make_one(
+            "blob-name", bucket=BUCKET, properties={"generation": str(GENERATION)}
+        )
+        self.assertEqual(blob.generation, GENERATION)
+
+    def test_id(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        ID = "ID"
+        properties = {"id": ID}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.id, ID)
+
+    def test_md5_hash_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        MD5_HASH = "DEADBEEF"
+        properties = {"md5Hash": MD5_HASH}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.md5_hash, MD5_HASH)
+
+    def test_md5_hash_setter(self):
+        BLOB_NAME = "blob-name"
+        MD5_HASH = "DEADBEEF"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.md5_hash)
+        blob.md5_hash = MD5_HASH
+        self.assertEqual(blob.md5_hash, MD5_HASH)
+
+    def test_media_link(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        MEDIA_LINK = "http://example.com/media/"
+        properties = {"mediaLink": MEDIA_LINK}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.media_link, MEDIA_LINK)
+
+    def test_metadata_getter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        METADATA = {"foo": "Foo"}
+        properties = {"metadata": METADATA}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.metadata, METADATA)
+
+    def test_metadata_setter(self):
+        BLOB_NAME = "blob-name"
+        METADATA = {"foo": "Foo"}
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.metadata)
+        blob.metadata = METADATA
+        self.assertEqual(blob.metadata, METADATA)
+
+    def test_metageneration(self):
+        BUCKET = object()
+        METAGENERATION = 42
+        blob = self._make_one(
+            "blob-name", bucket=BUCKET, properties={"metageneration": METAGENERATION}
+        )
+        self.assertEqual(blob.metageneration, METAGENERATION)
+
+    def test_metageneration_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.metageneration)
+
+    def test_metageneration_string_val(self):
+        BUCKET = object()
+        METAGENERATION = 42
+        blob = self._make_one(
+            "blob-name",
+            bucket=BUCKET,
+            properties={"metageneration": str(METAGENERATION)},
+        )
+        self.assertEqual(blob.metageneration, METAGENERATION)
+
+    def test_owner(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        OWNER = {"entity": "project-owner-12345", "entityId": "23456"}
+        properties = {"owner": OWNER}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        owner = blob.owner
+        self.assertEqual(owner["entity"], "project-owner-12345")
+        self.assertEqual(owner["entityId"], "23456")
+
+    def test_retention_expiration_time(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+        from google.cloud._helpers import UTC
+
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
+        TIME_CREATED = TIMESTAMP.strftime(_RFC3339_MICROS)
+        properties = {"retentionExpirationTime": TIME_CREATED}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.retention_expiration_time, TIMESTAMP)
+
+    def test_retention_expiration_time_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.retention_expiration_time)
+
+    def test_self_link(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        SELF_LINK = "http://example.com/self/"
+        properties = {"selfLink": SELF_LINK}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.self_link, SELF_LINK)
+
+    def test_size(self):
+        BUCKET = object()
+        SIZE = 42
+        blob = self._make_one("blob-name", bucket=BUCKET, properties={"size": SIZE})
+        self.assertEqual(blob.size, SIZE)
+
+    def test_size_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.size)
+
+    def test_size_string_val(self):
+        BUCKET = object()
+        SIZE = 42
+        blob = self._make_one(
+            "blob-name", bucket=BUCKET, properties={"size": str(SIZE)}
+        )
+        self.assertEqual(blob.size, SIZE)
+
+    def test_storage_class_getter(self):
+        blob_name = "blob-name"
+        bucket = _Bucket()
+        storage_class = "MULTI_REGIONAL"
+        properties = {"storageClass": storage_class}
+        blob = self._make_one(blob_name, bucket=bucket, properties=properties)
+        self.assertEqual(blob.storage_class, storage_class)
+
+    def test_storage_class_setter(self):
+        blob_name = "blob-name"
+        bucket = _Bucket()
+        storage_class = "COLDLINE"
+        blob = self._make_one(blob_name, bucket=bucket)
+        self.assertIsNone(blob.storage_class)
+        blob.storage_class = storage_class
+        self.assertEqual(blob.storage_class, storage_class)
+        self.assertEqual(blob._properties, {"storageClass": storage_class})
+
+    def test_temporary_hold_getter_missing(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertIsNone(blob.temporary_hold)
+
+    def test_temporary_hold_getter_false(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {"temporaryHold": False}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertFalse(blob.temporary_hold)
+
+    def test_temporary_hold_getter_true(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        properties = {"temporaryHold": True}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertTrue(blob.temporary_hold)
+
+    def test_temporary_hold_setter(self):
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        blob = self._make_one(BLOB_NAME, bucket=bucket)
+        self.assertIsNone(blob.temporary_hold)
+        blob.temporary_hold = True
+        self.assertEqual(blob.temporary_hold, True)
+
+    def test_time_deleted(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+        from google.cloud._helpers import UTC
+
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
+        TIME_DELETED = TIMESTAMP.strftime(_RFC3339_MICROS)
+        properties = {"timeDeleted": TIME_DELETED}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.time_deleted, TIMESTAMP)
+
+    def test_time_deleted_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.time_deleted)
+
+    def test_time_created(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+        from google.cloud._helpers import UTC
+
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
+        TIME_CREATED = TIMESTAMP.strftime(_RFC3339_MICROS)
+        properties = {"timeCreated": TIME_CREATED}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.time_created, TIMESTAMP)
+
+    def test_time_created_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.time_created)
+
+    def test_updated(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+        from google.cloud._helpers import UTC
+
+        BLOB_NAME = "blob-name"
+        bucket = _Bucket()
+        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
+        UPDATED = TIMESTAMP.strftime(_RFC3339_MICROS)
+        properties = {"updated": UPDATED}
+        blob = self._make_one(BLOB_NAME, bucket=bucket, properties=properties)
+        self.assertEqual(blob.updated, TIMESTAMP)
+
+    def test_updated_unset(self):
+        BUCKET = object()
+        blob = self._make_one("blob-name", bucket=BUCKET)
+        self.assertIsNone(blob.updated)
+
+    def test_from_string_w_valid_uri(self):
+        from google.cloud.storage.blob import Blob
+
+        connection = _Connection()
+        client = _Client(connection)
+        uri = "gs://BUCKET_NAME/b"
+        blob = Blob.from_string(uri, client)
+
+        self.assertIsInstance(blob, Blob)
+        self.assertIs(blob.client, client)
+        self.assertEqual(blob.name, "b")
+        self.assertEqual(blob.bucket.name, "BUCKET_NAME")
+
+    def test_from_string_w_invalid_uri(self):
+        from google.cloud.storage.blob import Blob
+
+        connection = _Connection()
+        client = _Client(connection)
+        blob = mock.Mock()
+
+        with mock.patch("google.cloud.storage.client.Blob", return_value=blob):
+            with pytest.raises(ValueError, match="URI scheme must be gs"):
+                Blob.from_string("http://bucket_name/b", client)
+
+    def test_from_string_w_domain_name_bucket(self):
+        from google.cloud.storage.blob import Blob
+
+        connection = _Connection()
+        client = _Client(connection)
+        uri = "gs://buckets.example.com/b"
+        blob = Blob.from_string(uri, client)
+
+        self.assertIsInstance(blob, Blob)
+        self.assertIs(blob.client, client)
+        self.assertEqual(blob.name, "b")
+        self.assertEqual(blob.bucket.name, "buckets.example.com")
+
+
+class Test__quote(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kw):
+        from google.cloud.storage.blob import _quote
+
+        return _quote(*args, **kw)
+
+    def test_bytes(self):
+        quoted = self._call_fut(b"\xDE\xAD\xBE\xEF")
+        self.assertEqual(quoted, "%DE%AD%BE%EF")
+
+    def test_unicode(self):
+        helicopter = u"\U0001f681"
+        quoted = self._call_fut(helicopter)
+        self.assertEqual(quoted, "%F0%9F%9A%81")
+
+    def test_bad_type(self):
+        with self.assertRaises(TypeError):
+            self._call_fut(None)
+
+    def test_w_slash_default(self):
+        with_slash = "foo/bar/baz"
+        quoted = self._call_fut(with_slash)
+        self.assertEqual(quoted, "foo%2Fbar%2Fbaz")
+
+    def test_w_slash_w_safe(self):
+        with_slash = "foo/bar/baz"
+        quoted_safe = self._call_fut(with_slash, safe=b"/")
+        self.assertEqual(quoted_safe, with_slash)
+
+    def test_w_tilde(self):
+        with_tilde = "bam~qux"
+        quoted = self._call_fut(with_tilde, safe=b"~")
+        self.assertEqual(quoted, with_tilde)
+
+
+class Test__maybe_rewind(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage.blob import _maybe_rewind
+
+        return _maybe_rewind(*args, **kwargs)
+
+    def test_default(self):
+        stream = mock.Mock(spec=[u"seek"])
+        ret_val = self._call_fut(stream)
+        self.assertIsNone(ret_val)
+
+        stream.seek.assert_not_called()
+
+    def test_do_not_rewind(self):
+        stream = mock.Mock(spec=[u"seek"])
+        ret_val = self._call_fut(stream, rewind=False)
+        self.assertIsNone(ret_val)
+
+        stream.seek.assert_not_called()
+
+    def test_do_rewind(self):
+        stream = mock.Mock(spec=[u"seek"])
+        ret_val = self._call_fut(stream, rewind=True)
+        self.assertIsNone(ret_val)
+
+        stream.seek.assert_called_once_with(0, os.SEEK_SET)
+
+
+class Test__raise_from_invalid_response(unittest.TestCase):
+    @staticmethod
+    def _call_fut(error):
+        from google.cloud.storage.blob import _raise_from_invalid_response
+
+        return _raise_from_invalid_response(error)
+
+    def _helper(self, message, code=http_client.BAD_REQUEST, args=()):
+        import requests
+
+        from google.resumable_media import InvalidResponse
+        from google.api_core import exceptions
+
+        response = requests.Response()
+        response.request = requests.Request("GET", "http://example.com").prepare()
+        response.status_code = code
+        error = InvalidResponse(response, message, *args)
+
+        with self.assertRaises(exceptions.GoogleAPICallError) as exc_info:
+            self._call_fut(error)
+
+        return exc_info
+
+    def test_default(self):
+        message = "Failure"
+        exc_info = self._helper(message)
+        expected = "GET http://example.com/: {}".format(message)
+        self.assertEqual(exc_info.exception.message, expected)
+        self.assertEqual(exc_info.exception.errors, [])
+
+    def test_w_206_and_args(self):
+        message = "Failure"
+        args = ("one", "two")
+        exc_info = self._helper(message, code=http_client.PARTIAL_CONTENT, args=args)
+        expected = "GET http://example.com/: {}".format((message,) + args)
+        self.assertEqual(exc_info.exception.message, expected)
+        self.assertEqual(exc_info.exception.errors, [])
+
+
+class Test__add_query_parameters(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage.blob import _add_query_parameters
+
+        return _add_query_parameters(*args, **kwargs)
+
+    def test_w_empty_list(self):
+        BASE_URL = "https://test.example.com/base"
+        self.assertEqual(self._call_fut(BASE_URL, []), BASE_URL)
+
+    def test_wo_existing_qs(self):
+        BASE_URL = "https://test.example.com/base"
+        NV_LIST = [("one", "One"), ("two", "Two")]
+        expected = "&".join(["{}={}".format(name, value) for name, value in NV_LIST])
+        self.assertEqual(
+            self._call_fut(BASE_URL, NV_LIST), "{}?{}".format(BASE_URL, expected)
+        )
+
+    def test_w_existing_qs(self):
+        BASE_URL = "https://test.example.com/base?one=Three"
+        NV_LIST = [("one", "One"), ("two", "Two")]
+        expected = "&".join(["{}={}".format(name, value) for name, value in NV_LIST])
+        self.assertEqual(
+            self._call_fut(BASE_URL, NV_LIST), "{}&{}".format(BASE_URL, expected)
+        )
+
+
+class _Connection(object):
+
+    API_BASE_URL = "http://example.com"
+    USER_AGENT = "testing 1.2.3"
+    credentials = object()
+
+    def __init__(self, *responses):
+        self._responses = responses[:]
+        self._requested = []
+        self._signed = []
+
+    def _respond(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        info, content = self._respond(**kw)
+        if info.get("status") == http_client.NOT_FOUND:
+            raise NotFound(info)
+        return content
+
+
+class _Bucket(object):
+    def __init__(self, client=None, name="name", user_project=None):
+        if client is None:
+            connection = _Connection()
+            client = _Client(connection)
+        self.client = client
+        self._blobs = {}
+        self._copied = []
+        self._deleted = []
+        self.name = name
+        self.path = "/b/" + name
+        self.user_project = user_project
+
+    def delete_blob(self, blob_name, client=None, generation=None):
+        del self._blobs[blob_name]
+        self._deleted.append((blob_name, client, generation))
+
+
+class _Client(object):
+    def __init__(self, connection):
+        self._base_connection = connection
+
+    @property
+    def _connection(self):
+        return self._base_connection
+
+    @property
+    def _credentials(self):
+        return self._base_connection.credentials
diff --git a/storage/tests/unit/test_bucket.py b/storage/tests/unit/test_bucket.py
new file mode 100644
index 000000000000..be4b3933f9e9
--- /dev/null
+++ b/storage/tests/unit/test_bucket.py
@@ -0,0 +1,2844 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import unittest
+
+import mock
+import pytest
+
+
+def _create_signing_credentials():
+    import google.auth.credentials
+
+    class _SigningCredentials(
+        google.auth.credentials.Credentials, google.auth.credentials.Signing
+    ):
+        pass
+
+    credentials = mock.Mock(spec=_SigningCredentials)
+
+    return credentials
+
+
+class Test_LifecycleRuleConditions(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.bucket import LifecycleRuleConditions
+
+        return LifecycleRuleConditions
+
+    def _make_one(self, **kw):
+        return self._get_target_class()(**kw)
+
+    def test_ctor_wo_conditions(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+
+    def test_ctor_w_age_and_matches_storage_class(self):
+        conditions = self._make_one(age=10, matches_storage_class=["REGIONAL"])
+        expected = {"age": 10, "matchesStorageClass": ["REGIONAL"]}
+        self.assertEqual(dict(conditions), expected)
+        self.assertEqual(conditions.age, 10)
+        self.assertIsNone(conditions.created_before)
+        self.assertIsNone(conditions.is_live)
+        self.assertEqual(conditions.matches_storage_class, ["REGIONAL"])
+        self.assertIsNone(conditions.number_of_newer_versions)
+
+    def test_ctor_w_created_before_and_is_live(self):
+        import datetime
+
+        before = datetime.date(2018, 8, 1)
+        conditions = self._make_one(created_before=before, is_live=False)
+        expected = {"createdBefore": "2018-08-01", "isLive": False}
+        self.assertEqual(dict(conditions), expected)
+        self.assertIsNone(conditions.age)
+        self.assertEqual(conditions.created_before, before)
+        self.assertEqual(conditions.is_live, False)
+        self.assertIsNone(conditions.matches_storage_class)
+        self.assertIsNone(conditions.number_of_newer_versions)
+
+    def test_ctor_w_number_of_newer_versions(self):
+        conditions = self._make_one(number_of_newer_versions=3)
+        expected = {"numNewerVersions": 3}
+        self.assertEqual(dict(conditions), expected)
+        self.assertIsNone(conditions.age)
+        self.assertIsNone(conditions.created_before)
+        self.assertIsNone(conditions.is_live)
+        self.assertIsNone(conditions.matches_storage_class)
+        self.assertEqual(conditions.number_of_newer_versions, 3)
+
+    def test_from_api_repr(self):
+        import datetime
+
+        before = datetime.date(2018, 8, 1)
+        klass = self._get_target_class()
+        resource = {
+            "age": 10,
+            "createdBefore": "2018-08-01",
+            "isLive": True,
+            "matchesStorageClass": ["REGIONAL"],
+            "numNewerVersions": 3,
+        }
+        conditions = klass.from_api_repr(resource)
+        self.assertEqual(conditions.age, 10)
+        self.assertEqual(conditions.created_before, before)
+        self.assertEqual(conditions.is_live, True)
+        self.assertEqual(conditions.matches_storage_class, ["REGIONAL"])
+        self.assertEqual(conditions.number_of_newer_versions, 3)
+
+
+class Test_LifecycleRuleDelete(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.bucket import LifecycleRuleDelete
+
+        return LifecycleRuleDelete
+
+    def _make_one(self, **kw):
+        return self._get_target_class()(**kw)
+
+    def test_ctor_wo_conditions(self):
+        with self.assertRaises(ValueError):
+            self._make_one()
+
+    def test_ctor_w_condition(self):
+        rule = self._make_one(age=10, matches_storage_class=["REGIONAL"])
+        expected = {
+            "action": {"type": "Delete"},
+            "condition": {"age": 10, "matchesStorageClass": ["REGIONAL"]},
+        }
+        self.assertEqual(dict(rule), expected)
+
+    def test_from_api_repr(self):
+        klass = self._get_target_class()
+        conditions = {
+            "age": 10,
+            "createdBefore": "2018-08-01",
+            "isLive": True,
+            "matchesStorageClass": ["REGIONAL"],
+            "numNewerVersions": 3,
+        }
+        resource = {"action": {"type": "Delete"}, "condition": conditions}
+        rule = klass.from_api_repr(resource)
+        self.assertEqual(dict(rule), resource)
+
+
+class Test_LifecycleRuleSetStorageClass(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.bucket import LifecycleRuleSetStorageClass
+
+        return LifecycleRuleSetStorageClass
+
+    def _make_one(self, **kw):
+        return self._get_target_class()(**kw)
+
+    def test_ctor_wo_conditions(self):
+        with self.assertRaises(ValueError):
+            self._make_one(storage_class="REGIONAL")
+
+    def test_ctor_w_condition(self):
+        rule = self._make_one(
+            storage_class="NEARLINE", age=10, matches_storage_class=["REGIONAL"]
+        )
+        expected = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": {"age": 10, "matchesStorageClass": ["REGIONAL"]},
+        }
+        self.assertEqual(dict(rule), expected)
+
+    def test_from_api_repr(self):
+        klass = self._get_target_class()
+        conditions = {
+            "age": 10,
+            "createdBefore": "2018-08-01",
+            "isLive": True,
+            "matchesStorageClass": ["REGIONAL"],
+            "numNewerVersions": 3,
+        }
+        resource = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": conditions,
+        }
+        rule = klass.from_api_repr(resource)
+        self.assertEqual(dict(rule), resource)
+
+
+class Test_IAMConfiguration(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.bucket import IAMConfiguration
+
+        return IAMConfiguration
+
+    def _make_one(self, bucket, **kw):
+        return self._get_target_class()(bucket, **kw)
+
+    @staticmethod
+    def _make_bucket():
+        from google.cloud.storage.bucket import Bucket
+
+        return mock.create_autospec(Bucket, instance=True)
+
+    def test_ctor_defaults(self):
+        bucket = self._make_bucket()
+
+        config = self._make_one(bucket)
+
+        self.assertIs(config.bucket, bucket)
+        self.assertFalse(config.bucket_policy_only_enabled)
+        self.assertIsNone(config.bucket_policy_only_locked_time)
+
+    def test_ctor_explicit(self):
+        import datetime
+        import pytz
+
+        bucket = self._make_bucket()
+        now = datetime.datetime.utcnow().replace(tzinfo=pytz.UTC)
+
+        config = self._make_one(
+            bucket, bucket_policy_only_enabled=True, bucket_policy_only_locked_time=now
+        )
+
+        self.assertIs(config.bucket, bucket)
+        self.assertTrue(config.bucket_policy_only_enabled)
+        self.assertEqual(config.bucket_policy_only_locked_time, now)
+
+    def test_from_api_repr_w_empty_resource(self):
+        klass = self._get_target_class()
+        bucket = self._make_bucket()
+        resource = {}
+
+        config = klass.from_api_repr(resource, bucket)
+
+        self.assertIs(config.bucket, bucket)
+        self.assertFalse(config.bucket_policy_only_enabled)
+        self.assertIsNone(config.bucket_policy_only_locked_time)
+
+    def test_from_api_repr_w_empty_bpo(self):
+        klass = self._get_target_class()
+        bucket = self._make_bucket()
+        resource = {"bucketPolicyOnly": {}}
+
+        config = klass.from_api_repr(resource, bucket)
+
+        self.assertIs(config.bucket, bucket)
+        self.assertFalse(config.bucket_policy_only_enabled)
+        self.assertIsNone(config.bucket_policy_only_locked_time)
+
+    def test_from_api_repr_w_disabled(self):
+        klass = self._get_target_class()
+        bucket = self._make_bucket()
+        resource = {"bucketPolicyOnly": {"enabled": False}}
+
+        config = klass.from_api_repr(resource, bucket)
+
+        self.assertIs(config.bucket, bucket)
+        self.assertFalse(config.bucket_policy_only_enabled)
+        self.assertIsNone(config.bucket_policy_only_locked_time)
+
+    def test_from_api_repr_w_enabled(self):
+        import datetime
+        import pytz
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        klass = self._get_target_class()
+        bucket = self._make_bucket()
+        now = datetime.datetime.utcnow().replace(tzinfo=pytz.UTC)
+        resource = {
+            "bucketPolicyOnly": {
+                "enabled": True,
+                "lockedTime": _datetime_to_rfc3339(now),
+            }
+        }
+
+        config = klass.from_api_repr(resource, bucket)
+
+        self.assertIs(config.bucket, bucket)
+        self.assertTrue(config.bucket_policy_only_enabled)
+        self.assertEqual(config.bucket_policy_only_locked_time, now)
+
+    def test_bucket_policy_only_enabled_setter(self):
+        bucket = self._make_bucket()
+        config = self._make_one(bucket)
+
+        config.bucket_policy_only_enabled = True
+
+        self.assertTrue(config["bucketPolicyOnly"]["enabled"])
+        bucket._patch_property.assert_called_once_with("iamConfiguration", config)
+
+
+class Test_Bucket(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.bucket import Bucket
+
+        return Bucket
+
+    def _make_one(self, client=None, name=None, properties=None, user_project=None):
+        if client is None:
+            connection = _Connection()
+            client = _Client(connection)
+        if user_project is None:
+            bucket = self._get_target_class()(client, name=name)
+        else:
+            bucket = self._get_target_class()(
+                client, name=name, user_project=user_project
+            )
+        bucket._properties = properties or {}
+        return bucket
+
+    def test_ctor_w_invalid_name(self):
+        NAME = "#invalid"
+        with self.assertRaises(ValueError):
+            self._make_one(name=NAME)
+
+    def test_ctor(self):
+        NAME = "name"
+        properties = {"key": "value"}
+        bucket = self._make_one(name=NAME, properties=properties)
+        self.assertEqual(bucket.name, NAME)
+        self.assertEqual(bucket._properties, properties)
+        self.assertEqual(list(bucket._changes), [])
+        self.assertFalse(bucket._acl.loaded)
+        self.assertIs(bucket._acl.bucket, bucket)
+        self.assertFalse(bucket._default_object_acl.loaded)
+        self.assertIs(bucket._default_object_acl.bucket, bucket)
+        self.assertEqual(list(bucket._label_removals), [])
+        self.assertIsNone(bucket.user_project)
+
+    def test_ctor_w_user_project(self):
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(client, name=NAME, user_project=USER_PROJECT)
+        self.assertEqual(bucket.name, NAME)
+        self.assertEqual(bucket._properties, {})
+        self.assertEqual(list(bucket._changes), [])
+        self.assertFalse(bucket._acl.loaded)
+        self.assertIs(bucket._acl.bucket, bucket)
+        self.assertFalse(bucket._default_object_acl.loaded)
+        self.assertIs(bucket._default_object_acl.bucket, bucket)
+        self.assertEqual(list(bucket._label_removals), [])
+        self.assertEqual(bucket.user_project, USER_PROJECT)
+
+    def test_blob_wo_keys(self):
+        from google.cloud.storage.blob import Blob
+
+        BUCKET_NAME = "BUCKET_NAME"
+        BLOB_NAME = "BLOB_NAME"
+        CHUNK_SIZE = 1024 * 1024
+
+        bucket = self._make_one(name=BUCKET_NAME)
+        blob = bucket.blob(BLOB_NAME, chunk_size=CHUNK_SIZE)
+        self.assertIsInstance(blob, Blob)
+        self.assertIs(blob.bucket, bucket)
+        self.assertIs(blob.client, bucket.client)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(blob.chunk_size, CHUNK_SIZE)
+        self.assertIsNone(blob._encryption_key)
+        self.assertIsNone(blob.kms_key_name)
+
+    def test_blob_w_encryption_key(self):
+        from google.cloud.storage.blob import Blob
+
+        BUCKET_NAME = "BUCKET_NAME"
+        BLOB_NAME = "BLOB_NAME"
+        CHUNK_SIZE = 1024 * 1024
+        KEY = b"01234567890123456789012345678901"  # 32 bytes
+
+        bucket = self._make_one(name=BUCKET_NAME)
+        blob = bucket.blob(BLOB_NAME, chunk_size=CHUNK_SIZE, encryption_key=KEY)
+        self.assertIsInstance(blob, Blob)
+        self.assertIs(blob.bucket, bucket)
+        self.assertIs(blob.client, bucket.client)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(blob.chunk_size, CHUNK_SIZE)
+        self.assertEqual(blob._encryption_key, KEY)
+        self.assertIsNone(blob.kms_key_name)
+
+    def test_blob_w_generation(self):
+        from google.cloud.storage.blob import Blob
+
+        BUCKET_NAME = "BUCKET_NAME"
+        BLOB_NAME = "BLOB_NAME"
+        GENERATION = 123
+
+        bucket = self._make_one(name=BUCKET_NAME)
+        blob = bucket.blob(BLOB_NAME, generation=GENERATION)
+        self.assertIsInstance(blob, Blob)
+        self.assertIs(blob.bucket, bucket)
+        self.assertIs(blob.client, bucket.client)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(blob.generation, GENERATION)
+
+    def test_blob_w_kms_key_name(self):
+        from google.cloud.storage.blob import Blob
+
+        BUCKET_NAME = "BUCKET_NAME"
+        BLOB_NAME = "BLOB_NAME"
+        CHUNK_SIZE = 1024 * 1024
+        KMS_RESOURCE = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+
+        bucket = self._make_one(name=BUCKET_NAME)
+        blob = bucket.blob(BLOB_NAME, chunk_size=CHUNK_SIZE, kms_key_name=KMS_RESOURCE)
+        self.assertIsInstance(blob, Blob)
+        self.assertIs(blob.bucket, bucket)
+        self.assertIs(blob.client, bucket.client)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(blob.chunk_size, CHUNK_SIZE)
+        self.assertIsNone(blob._encryption_key)
+        self.assertEqual(blob.kms_key_name, KMS_RESOURCE)
+
+    def test_notification_defaults(self):
+        from google.cloud.storage.notification import BucketNotification
+        from google.cloud.storage.notification import NONE_PAYLOAD_FORMAT
+
+        PROJECT = "PROJECT"
+        BUCKET_NAME = "BUCKET_NAME"
+        TOPIC_NAME = "TOPIC_NAME"
+        client = _Client(_Connection(), project=PROJECT)
+        bucket = self._make_one(client, name=BUCKET_NAME)
+
+        notification = bucket.notification(TOPIC_NAME)
+
+        self.assertIsInstance(notification, BucketNotification)
+        self.assertIs(notification.bucket, bucket)
+        self.assertEqual(notification.topic_project, PROJECT)
+        self.assertIsNone(notification.custom_attributes)
+        self.assertIsNone(notification.event_types)
+        self.assertIsNone(notification.blob_name_prefix)
+        self.assertEqual(notification.payload_format, NONE_PAYLOAD_FORMAT)
+
+    def test_notification_explicit(self):
+        from google.cloud.storage.notification import (
+            BucketNotification,
+            OBJECT_FINALIZE_EVENT_TYPE,
+            OBJECT_DELETE_EVENT_TYPE,
+            JSON_API_V1_PAYLOAD_FORMAT,
+        )
+
+        PROJECT = "PROJECT"
+        BUCKET_NAME = "BUCKET_NAME"
+        TOPIC_NAME = "TOPIC_NAME"
+        TOPIC_ALT_PROJECT = "topic-project-456"
+        CUSTOM_ATTRIBUTES = {"attr1": "value1", "attr2": "value2"}
+        EVENT_TYPES = [OBJECT_FINALIZE_EVENT_TYPE, OBJECT_DELETE_EVENT_TYPE]
+        BLOB_NAME_PREFIX = "blob-name-prefix/"
+        client = _Client(_Connection(), project=PROJECT)
+        bucket = self._make_one(client, name=BUCKET_NAME)
+
+        notification = bucket.notification(
+            TOPIC_NAME,
+            topic_project=TOPIC_ALT_PROJECT,
+            custom_attributes=CUSTOM_ATTRIBUTES,
+            event_types=EVENT_TYPES,
+            blob_name_prefix=BLOB_NAME_PREFIX,
+            payload_format=JSON_API_V1_PAYLOAD_FORMAT,
+        )
+
+        self.assertIsInstance(notification, BucketNotification)
+        self.assertIs(notification.bucket, bucket)
+        self.assertEqual(notification.topic_project, TOPIC_ALT_PROJECT)
+        self.assertEqual(notification.custom_attributes, CUSTOM_ATTRIBUTES)
+        self.assertEqual(notification.event_types, EVENT_TYPES)
+        self.assertEqual(notification.blob_name_prefix, BLOB_NAME_PREFIX)
+        self.assertEqual(notification.payload_format, JSON_API_V1_PAYLOAD_FORMAT)
+
+    def test_bucket_name_value(self):
+        BUCKET_NAME = "bucket-name"
+        self._make_one(name=BUCKET_NAME)
+
+        bad_start_bucket_name = "/testing123"
+        with self.assertRaises(ValueError):
+            self._make_one(name=bad_start_bucket_name)
+
+        bad_end_bucket_name = "testing123/"
+        with self.assertRaises(ValueError):
+            self._make_one(name=bad_end_bucket_name)
+
+    def test_user_project(self):
+        BUCKET_NAME = "name"
+        USER_PROJECT = "user-project-123"
+        bucket = self._make_one(name=BUCKET_NAME)
+        bucket._user_project = USER_PROJECT
+        self.assertEqual(bucket.user_project, USER_PROJECT)
+
+    def test_exists_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        class _FakeConnection(object):
+
+            _called_with = []
+
+            @classmethod
+            def api_request(cls, *args, **kwargs):
+                cls._called_with.append((args, kwargs))
+                raise NotFound(args)
+
+        BUCKET_NAME = "bucket-name"
+        bucket = self._make_one(name=BUCKET_NAME)
+        client = _Client(_FakeConnection)
+        self.assertFalse(bucket.exists(client=client))
+        expected_called_kwargs = {
+            "method": "GET",
+            "path": bucket.path,
+            "query_params": {"fields": "name"},
+            "_target_object": None,
+        }
+        expected_cw = [((), expected_called_kwargs)]
+        self.assertEqual(_FakeConnection._called_with, expected_cw)
+
+    def test_exists_hit_w_user_project(self):
+        USER_PROJECT = "user-project-123"
+
+        class _FakeConnection(object):
+
+            _called_with = []
+
+            @classmethod
+            def api_request(cls, *args, **kwargs):
+                cls._called_with.append((args, kwargs))
+                # exists() does not use the return value
+                return object()
+
+        BUCKET_NAME = "bucket-name"
+        bucket = self._make_one(name=BUCKET_NAME, user_project=USER_PROJECT)
+        client = _Client(_FakeConnection)
+        self.assertTrue(bucket.exists(client=client))
+        expected_called_kwargs = {
+            "method": "GET",
+            "path": bucket.path,
+            "query_params": {"fields": "name", "userProject": USER_PROJECT},
+            "_target_object": None,
+        }
+        expected_cw = [((), expected_called_kwargs)]
+        self.assertEqual(_FakeConnection._called_with, expected_cw)
+
+    def test_create_w_user_project(self):
+        PROJECT = "PROJECT"
+        BUCKET_NAME = "bucket-name"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection()
+        client = _Client(connection, project=PROJECT)
+        bucket = self._make_one(client, BUCKET_NAME, user_project=USER_PROJECT)
+
+        with self.assertRaises(ValueError):
+            bucket.create()
+
+    def test_create_w_missing_client_project(self):
+        BUCKET_NAME = "bucket-name"
+        connection = _Connection()
+        client = _Client(connection, project=None)
+        bucket = self._make_one(client, BUCKET_NAME)
+
+        with self.assertRaises(ValueError):
+            bucket.create()
+
+    def test_create_w_explicit_project(self):
+        PROJECT = "PROJECT"
+        BUCKET_NAME = "bucket-name"
+        OTHER_PROJECT = "other-project-123"
+        DATA = {"name": BUCKET_NAME}
+        connection = _Connection(DATA)
+        client = _Client(connection, project=PROJECT)
+        bucket = self._make_one(client, BUCKET_NAME)
+
+        bucket.create(project=OTHER_PROJECT)
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], "/b")
+        self.assertEqual(kw["query_params"], {"project": OTHER_PROJECT})
+        self.assertEqual(kw["data"], DATA)
+
+    def test_create_w_explicit_location(self):
+        PROJECT = "PROJECT"
+        BUCKET_NAME = "bucket-name"
+        LOCATION = "us-central1"
+        DATA = {"location": LOCATION, "name": BUCKET_NAME}
+        connection = _Connection(
+            DATA, "{'location': 'us-central1', 'name': 'bucket-name'}"
+        )
+        client = _Client(connection, project=PROJECT)
+        bucket = self._make_one(client, BUCKET_NAME)
+
+        bucket.create(location=LOCATION)
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], "/b")
+        self.assertEqual(kw["data"], DATA)
+        self.assertEqual(bucket.location, LOCATION)
+
+    def test_create_hit(self):
+        PROJECT = "PROJECT"
+        BUCKET_NAME = "bucket-name"
+        DATA = {"name": BUCKET_NAME}
+        connection = _Connection(DATA)
+        client = _Client(connection, project=PROJECT)
+        bucket = self._make_one(client=client, name=BUCKET_NAME)
+        bucket.create()
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], "/b")
+        self.assertEqual(kw["query_params"], {"project": PROJECT})
+        self.assertEqual(kw["data"], DATA)
+
+    def test_create_w_extra_properties(self):
+        BUCKET_NAME = "bucket-name"
+        PROJECT = "PROJECT"
+        CORS = [
+            {
+                "maxAgeSeconds": 60,
+                "methods": ["*"],
+                "origin": ["https://example.com/frontend"],
+                "responseHeader": ["X-Custom-Header"],
+            }
+        ]
+        LIFECYCLE_RULES = [{"action": {"type": "Delete"}, "condition": {"age": 365}}]
+        LOCATION = "eu"
+        LABELS = {"color": "red", "flavor": "cherry"}
+        STORAGE_CLASS = "NEARLINE"
+        DATA = {
+            "name": BUCKET_NAME,
+            "cors": CORS,
+            "lifecycle": {"rule": LIFECYCLE_RULES},
+            "location": LOCATION,
+            "storageClass": STORAGE_CLASS,
+            "versioning": {"enabled": True},
+            "billing": {"requesterPays": True},
+            "labels": LABELS,
+        }
+        connection = _Connection(DATA)
+        client = _Client(connection, project=PROJECT)
+        bucket = self._make_one(client=client, name=BUCKET_NAME)
+        bucket.cors = CORS
+        bucket.lifecycle_rules = LIFECYCLE_RULES
+        bucket.storage_class = STORAGE_CLASS
+        bucket.versioning_enabled = True
+        bucket.requester_pays = True
+        bucket.labels = LABELS
+        bucket.create(location=LOCATION)
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], "/b")
+        self.assertEqual(kw["query_params"], {"project": PROJECT})
+        self.assertEqual(kw["data"], DATA)
+
+    def test_acl_property(self):
+        from google.cloud.storage.acl import BucketACL
+
+        bucket = self._make_one()
+        acl = bucket.acl
+        self.assertIsInstance(acl, BucketACL)
+        self.assertIs(acl, bucket._acl)
+
+    def test_default_object_acl_property(self):
+        from google.cloud.storage.acl import DefaultObjectACL
+
+        bucket = self._make_one()
+        acl = bucket.default_object_acl
+        self.assertIsInstance(acl, DefaultObjectACL)
+        self.assertIs(acl, bucket._default_object_acl)
+
+    def test_path_no_name(self):
+        bucket = self._make_one()
+        self.assertRaises(ValueError, getattr, bucket, "path")
+
+    def test_path_w_name(self):
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(bucket.path, "/b/%s" % NAME)
+
+    def test_get_blob_miss(self):
+        NAME = "name"
+        NONESUCH = "nonesuch"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(name=NAME)
+        result = bucket.get_blob(NONESUCH, client=client)
+        self.assertIsNone(result)
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "GET")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, NONESUCH))
+
+    def test_get_blob_hit_w_user_project(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection({"name": BLOB_NAME})
+        client = _Client(connection)
+        bucket = self._make_one(name=NAME, user_project=USER_PROJECT)
+        blob = bucket.get_blob(BLOB_NAME, client=client)
+        self.assertIs(blob.bucket, bucket)
+        self.assertEqual(blob.name, BLOB_NAME)
+        kw, = connection._requested
+        expected_qp = {"userProject": USER_PROJECT, "projection": "noAcl"}
+        self.assertEqual(kw["method"], "GET")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw["query_params"], expected_qp)
+
+    def test_get_blob_hit_w_generation(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        GENERATION = 1512565576797178
+        connection = _Connection({"name": BLOB_NAME, "generation": GENERATION})
+        client = _Client(connection)
+        bucket = self._make_one(name=NAME)
+        blob = bucket.get_blob(BLOB_NAME, client=client, generation=GENERATION)
+        self.assertIs(blob.bucket, bucket)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(blob.generation, GENERATION)
+        kw, = connection._requested
+        expected_qp = {"generation": GENERATION, "projection": "noAcl"}
+        self.assertEqual(kw["method"], "GET")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw["query_params"], expected_qp)
+
+    def test_get_blob_hit_with_kwargs(self):
+        from google.cloud.storage.blob import _get_encryption_headers
+
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        CHUNK_SIZE = 1024 * 1024
+        KEY = b"01234567890123456789012345678901"  # 32 bytes
+
+        connection = _Connection({"name": BLOB_NAME})
+        client = _Client(connection)
+        bucket = self._make_one(name=NAME)
+        blob = bucket.get_blob(
+            BLOB_NAME, client=client, encryption_key=KEY, chunk_size=CHUNK_SIZE
+        )
+        self.assertIs(blob.bucket, bucket)
+        self.assertEqual(blob.name, BLOB_NAME)
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "GET")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw["headers"], _get_encryption_headers(KEY))
+        self.assertEqual(blob.chunk_size, CHUNK_SIZE)
+        self.assertEqual(blob._encryption_key, KEY)
+
+    def test_list_blobs_defaults(self):
+        NAME = "name"
+        connection = _Connection({"items": []})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        iterator = bucket.list_blobs()
+        blobs = list(iterator)
+        self.assertEqual(blobs, [])
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "GET")
+        self.assertEqual(kw["path"], "/b/%s/o" % NAME)
+        self.assertEqual(kw["query_params"], {"projection": "noAcl"})
+
+    def test_list_blobs_w_all_arguments_and_user_project(self):
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        MAX_RESULTS = 10
+        PAGE_TOKEN = "ABCD"
+        PREFIX = "subfolder"
+        DELIMITER = "/"
+        VERSIONS = True
+        PROJECTION = "full"
+        FIELDS = "items/contentLanguage,nextPageToken"
+        EXPECTED = {
+            "maxResults": 10,
+            "pageToken": PAGE_TOKEN,
+            "prefix": PREFIX,
+            "delimiter": DELIMITER,
+            "versions": VERSIONS,
+            "projection": PROJECTION,
+            "fields": FIELDS,
+            "userProject": USER_PROJECT,
+        }
+        connection = _Connection({"items": []})
+        client = _Client(connection)
+        bucket = self._make_one(name=NAME, user_project=USER_PROJECT)
+        iterator = bucket.list_blobs(
+            max_results=MAX_RESULTS,
+            page_token=PAGE_TOKEN,
+            prefix=PREFIX,
+            delimiter=DELIMITER,
+            versions=VERSIONS,
+            projection=PROJECTION,
+            fields=FIELDS,
+            client=client,
+        )
+        blobs = list(iterator)
+        self.assertEqual(blobs, [])
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "GET")
+        self.assertEqual(kw["path"], "/b/%s/o" % NAME)
+        self.assertEqual(kw["query_params"], EXPECTED)
+
+    def test_list_notifications(self):
+        from google.cloud.storage.notification import BucketNotification
+        from google.cloud.storage.notification import _TOPIC_REF_FMT
+        from google.cloud.storage.notification import (
+            JSON_API_V1_PAYLOAD_FORMAT,
+            NONE_PAYLOAD_FORMAT,
+        )
+
+        NAME = "name"
+
+        topic_refs = [("my-project-123", "topic-1"), ("other-project-456", "topic-2")]
+
+        resources = [
+            {
+                "topic": _TOPIC_REF_FMT.format(*topic_refs[0]),
+                "id": "1",
+                "etag": "DEADBEEF",
+                "selfLink": "https://example.com/notification/1",
+                "payload_format": NONE_PAYLOAD_FORMAT,
+            },
+            {
+                "topic": _TOPIC_REF_FMT.format(*topic_refs[1]),
+                "id": "2",
+                "etag": "FACECABB",
+                "selfLink": "https://example.com/notification/2",
+                "payload_format": JSON_API_V1_PAYLOAD_FORMAT,
+            },
+        ]
+        connection = _Connection({"items": resources})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+
+        notifications = list(bucket.list_notifications())
+
+        self.assertEqual(len(notifications), len(resources))
+        for notification, resource, topic_ref in zip(
+            notifications, resources, topic_refs
+        ):
+            self.assertIsInstance(notification, BucketNotification)
+            self.assertEqual(notification.topic_project, topic_ref[0])
+            self.assertEqual(notification.topic_name, topic_ref[1])
+            self.assertEqual(notification.notification_id, resource["id"])
+            self.assertEqual(notification.etag, resource["etag"])
+            self.assertEqual(notification.self_link, resource["selfLink"])
+            self.assertEqual(
+                notification.custom_attributes, resource.get("custom_attributes")
+            )
+            self.assertEqual(notification.event_types, resource.get("event_types"))
+            self.assertEqual(
+                notification.blob_name_prefix, resource.get("blob_name_prefix")
+            )
+            self.assertEqual(
+                notification.payload_format, resource.get("payload_format")
+            )
+
+    def test_delete_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        NAME = "name"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        self.assertRaises(NotFound, bucket.delete)
+        expected_cw = [
+            {
+                "method": "DELETE",
+                "path": bucket.path,
+                "query_params": {},
+                "_target_object": None,
+            }
+        ]
+        self.assertEqual(connection._deleted_buckets, expected_cw)
+
+    def test_delete_hit_with_user_project(self):
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        GET_BLOBS_RESP = {"items": []}
+        connection = _Connection(GET_BLOBS_RESP)
+        connection._delete_bucket = True
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME, user_project=USER_PROJECT)
+        result = bucket.delete(force=True)
+        self.assertIsNone(result)
+        expected_cw = [
+            {
+                "method": "DELETE",
+                "path": bucket.path,
+                "_target_object": None,
+                "query_params": {"userProject": USER_PROJECT},
+            }
+        ]
+        self.assertEqual(connection._deleted_buckets, expected_cw)
+
+    def test_delete_force_delete_blobs(self):
+        NAME = "name"
+        BLOB_NAME1 = "blob-name1"
+        BLOB_NAME2 = "blob-name2"
+        GET_BLOBS_RESP = {"items": [{"name": BLOB_NAME1}, {"name": BLOB_NAME2}]}
+        DELETE_BLOB1_RESP = DELETE_BLOB2_RESP = {}
+        connection = _Connection(GET_BLOBS_RESP, DELETE_BLOB1_RESP, DELETE_BLOB2_RESP)
+        connection._delete_bucket = True
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        result = bucket.delete(force=True)
+        self.assertIsNone(result)
+        expected_cw = [
+            {
+                "method": "DELETE",
+                "path": bucket.path,
+                "query_params": {},
+                "_target_object": None,
+            }
+        ]
+        self.assertEqual(connection._deleted_buckets, expected_cw)
+
+    def test_delete_force_miss_blobs(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name1"
+        GET_BLOBS_RESP = {"items": [{"name": BLOB_NAME}]}
+        # Note the connection does not have a response for the blob.
+        connection = _Connection(GET_BLOBS_RESP)
+        connection._delete_bucket = True
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        result = bucket.delete(force=True)
+        self.assertIsNone(result)
+        expected_cw = [
+            {
+                "method": "DELETE",
+                "path": bucket.path,
+                "query_params": {},
+                "_target_object": None,
+            }
+        ]
+        self.assertEqual(connection._deleted_buckets, expected_cw)
+
+    def test_delete_too_many(self):
+        NAME = "name"
+        BLOB_NAME1 = "blob-name1"
+        BLOB_NAME2 = "blob-name2"
+        GET_BLOBS_RESP = {"items": [{"name": BLOB_NAME1}, {"name": BLOB_NAME2}]}
+        connection = _Connection(GET_BLOBS_RESP)
+        connection._delete_bucket = True
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+
+        # Make the Bucket refuse to delete with 2 objects.
+        bucket._MAX_OBJECTS_FOR_ITERATION = 1
+        self.assertRaises(ValueError, bucket.delete, force=True)
+        self.assertEqual(connection._deleted_buckets, [])
+
+    def test_delete_blob_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        NAME = "name"
+        NONESUCH = "nonesuch"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        self.assertRaises(NotFound, bucket.delete_blob, NONESUCH)
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "DELETE")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, NONESUCH))
+        self.assertEqual(kw["query_params"], {})
+
+    def test_delete_blob_hit_with_user_project(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection({})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME, user_project=USER_PROJECT)
+        result = bucket.delete_blob(BLOB_NAME)
+        self.assertIsNone(result)
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "DELETE")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw["query_params"], {"userProject": USER_PROJECT})
+
+    def test_delete_blob_hit_with_generation(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        GENERATION = 1512565576797178
+        connection = _Connection({})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        result = bucket.delete_blob(BLOB_NAME, generation=GENERATION)
+        self.assertIsNone(result)
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "DELETE")
+        self.assertEqual(kw["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw["query_params"], {"generation": GENERATION})
+
+    def test_delete_blobs_empty(self):
+        NAME = "name"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.delete_blobs([])
+        self.assertEqual(connection._requested, [])
+
+    def test_delete_blobs_hit_w_user_project(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection({})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME, user_project=USER_PROJECT)
+        bucket.delete_blobs([BLOB_NAME])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "DELETE")
+        self.assertEqual(kw[0]["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw[0]["query_params"], {"userProject": USER_PROJECT})
+
+    def test_delete_blobs_miss_no_on_error(self):
+        from google.cloud.exceptions import NotFound
+
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        NONESUCH = "nonesuch"
+        connection = _Connection({})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        self.assertRaises(NotFound, bucket.delete_blobs, [BLOB_NAME, NONESUCH])
+        kw = connection._requested
+        self.assertEqual(len(kw), 2)
+        self.assertEqual(kw[0]["method"], "DELETE")
+        self.assertEqual(kw[0]["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw[1]["method"], "DELETE")
+        self.assertEqual(kw[1]["path"], "/b/%s/o/%s" % (NAME, NONESUCH))
+
+    def test_delete_blobs_miss_w_on_error(self):
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        NONESUCH = "nonesuch"
+        connection = _Connection({})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        errors = []
+        bucket.delete_blobs([BLOB_NAME, NONESUCH], errors.append)
+        self.assertEqual(errors, [NONESUCH])
+        kw = connection._requested
+        self.assertEqual(len(kw), 2)
+        self.assertEqual(kw[0]["method"], "DELETE")
+        self.assertEqual(kw[0]["path"], "/b/%s/o/%s" % (NAME, BLOB_NAME))
+        self.assertEqual(kw[1]["method"], "DELETE")
+        self.assertEqual(kw[1]["path"], "/b/%s/o/%s" % (NAME, NONESUCH))
+
+    @staticmethod
+    def _make_blob(bucket_name, blob_name):
+        from google.cloud.storage.blob import Blob
+
+        blob = mock.create_autospec(Blob)
+        blob.name = blob_name
+        blob.path = "/b/{}/o/{}".format(bucket_name, blob_name)
+        return blob
+
+    def test_copy_blobs_wo_name(self):
+        SOURCE = "source"
+        DEST = "dest"
+        BLOB_NAME = "blob-name"
+        connection = _Connection({})
+        client = _Client(connection)
+        source = self._make_one(client=client, name=SOURCE)
+        dest = self._make_one(client=client, name=DEST)
+        blob = self._make_blob(SOURCE, BLOB_NAME)
+
+        new_blob = source.copy_blob(blob, dest)
+
+        self.assertIs(new_blob.bucket, dest)
+        self.assertEqual(new_blob.name, BLOB_NAME)
+
+        kw, = connection._requested
+        COPY_PATH = "/b/{}/o/{}/copyTo/b/{}/o/{}".format(
+            SOURCE, BLOB_NAME, DEST, BLOB_NAME
+        )
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], COPY_PATH)
+        self.assertEqual(kw["query_params"], {})
+
+    def test_copy_blobs_source_generation(self):
+        SOURCE = "source"
+        DEST = "dest"
+        BLOB_NAME = "blob-name"
+        GENERATION = 1512565576797178
+
+        connection = _Connection({})
+        client = _Client(connection)
+        source = self._make_one(client=client, name=SOURCE)
+        dest = self._make_one(client=client, name=DEST)
+        blob = self._make_blob(SOURCE, BLOB_NAME)
+
+        new_blob = source.copy_blob(blob, dest, source_generation=GENERATION)
+
+        self.assertIs(new_blob.bucket, dest)
+        self.assertEqual(new_blob.name, BLOB_NAME)
+
+        kw, = connection._requested
+        COPY_PATH = "/b/{}/o/{}/copyTo/b/{}/o/{}".format(
+            SOURCE, BLOB_NAME, DEST, BLOB_NAME
+        )
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], COPY_PATH)
+        self.assertEqual(kw["query_params"], {"sourceGeneration": GENERATION})
+
+    def test_copy_blobs_preserve_acl(self):
+        from google.cloud.storage.acl import ObjectACL
+
+        SOURCE = "source"
+        DEST = "dest"
+        BLOB_NAME = "blob-name"
+        NEW_NAME = "new_name"
+
+        connection = _Connection({}, {})
+        client = _Client(connection)
+        source = self._make_one(client=client, name=SOURCE)
+        dest = self._make_one(client=client, name=DEST)
+        blob = self._make_blob(SOURCE, BLOB_NAME)
+
+        new_blob = source.copy_blob(
+            blob, dest, NEW_NAME, client=client, preserve_acl=False
+        )
+
+        self.assertIs(new_blob.bucket, dest)
+        self.assertEqual(new_blob.name, NEW_NAME)
+        self.assertIsInstance(new_blob.acl, ObjectACL)
+
+        kw1, kw2 = connection._requested
+        COPY_PATH = "/b/{}/o/{}/copyTo/b/{}/o/{}".format(
+            SOURCE, BLOB_NAME, DEST, NEW_NAME
+        )
+        NEW_BLOB_PATH = "/b/{}/o/{}".format(DEST, NEW_NAME)
+
+        self.assertEqual(kw1["method"], "POST")
+        self.assertEqual(kw1["path"], COPY_PATH)
+        self.assertEqual(kw1["query_params"], {})
+
+        self.assertEqual(kw2["method"], "PATCH")
+        self.assertEqual(kw2["path"], NEW_BLOB_PATH)
+        self.assertEqual(kw2["query_params"], {"projection": "full"})
+
+    def test_copy_blobs_w_name_and_user_project(self):
+        SOURCE = "source"
+        DEST = "dest"
+        BLOB_NAME = "blob-name"
+        NEW_NAME = "new_name"
+        USER_PROJECT = "user-project-123"
+        connection = _Connection({})
+        client = _Client(connection)
+        source = self._make_one(client=client, name=SOURCE, user_project=USER_PROJECT)
+        dest = self._make_one(client=client, name=DEST)
+        blob = self._make_blob(SOURCE, BLOB_NAME)
+
+        new_blob = source.copy_blob(blob, dest, NEW_NAME)
+
+        self.assertIs(new_blob.bucket, dest)
+        self.assertEqual(new_blob.name, NEW_NAME)
+
+        COPY_PATH = "/b/{}/o/{}/copyTo/b/{}/o/{}".format(
+            SOURCE, BLOB_NAME, DEST, NEW_NAME
+        )
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], COPY_PATH)
+        self.assertEqual(kw["query_params"], {"userProject": USER_PROJECT})
+
+    def test_rename_blob(self):
+        BUCKET_NAME = "BUCKET_NAME"
+        BLOB_NAME = "blob-name"
+        NEW_BLOB_NAME = "new-blob-name"
+        DATA = {"name": NEW_BLOB_NAME}
+        connection = _Connection(DATA)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=BUCKET_NAME)
+        blob = self._make_blob(BUCKET_NAME, BLOB_NAME)
+
+        renamed_blob = bucket.rename_blob(blob, NEW_BLOB_NAME, client=client)
+
+        self.assertIs(renamed_blob.bucket, bucket)
+        self.assertEqual(renamed_blob.name, NEW_BLOB_NAME)
+
+        COPY_PATH = "/b/{}/o/{}/copyTo/b/{}/o/{}".format(
+            BUCKET_NAME, BLOB_NAME, BUCKET_NAME, NEW_BLOB_NAME
+        )
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], COPY_PATH)
+        self.assertEqual(kw["query_params"], {})
+
+        blob.delete.assert_called_once_with(client)
+
+    def test_rename_blob_to_itself(self):
+        BUCKET_NAME = "BUCKET_NAME"
+        BLOB_NAME = "blob-name"
+        DATA = {"name": BLOB_NAME}
+        connection = _Connection(DATA)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=BUCKET_NAME)
+        blob = self._make_blob(BUCKET_NAME, BLOB_NAME)
+
+        renamed_blob = bucket.rename_blob(blob, BLOB_NAME)
+
+        self.assertIs(renamed_blob.bucket, bucket)
+        self.assertEqual(renamed_blob.name, BLOB_NAME)
+
+        COPY_PATH = "/b/{}/o/{}/copyTo/b/{}/o/{}".format(
+            BUCKET_NAME, BLOB_NAME, BUCKET_NAME, BLOB_NAME
+        )
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], COPY_PATH)
+        self.assertEqual(kw["query_params"], {})
+
+        blob.delete.assert_not_called()
+
+    def test_etag(self):
+        ETAG = "ETAG"
+        properties = {"etag": ETAG}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.etag, ETAG)
+
+    def test_id(self):
+        ID = "ID"
+        properties = {"id": ID}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.id, ID)
+
+    def test_location_getter(self):
+        NAME = "name"
+        before = {"location": "AS"}
+        bucket = self._make_one(name=NAME, properties=before)
+        self.assertEqual(bucket.location, "AS")
+
+    @mock.patch("warnings.warn")
+    def test_location_setter(self, mock_warn):
+        from google.cloud.storage import bucket as bucket_module
+
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        self.assertIsNone(bucket.location)
+        bucket.location = "AS"
+        self.assertEqual(bucket.location, "AS")
+        self.assertTrue("location" in bucket._changes)
+        mock_warn.assert_called_once_with(
+            bucket_module._LOCATION_SETTER_MESSAGE, DeprecationWarning, stacklevel=2
+        )
+
+    def test_iam_configuration_policy_missing(self):
+        from google.cloud.storage.bucket import IAMConfiguration
+
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+
+        config = bucket.iam_configuration
+
+        self.assertIsInstance(config, IAMConfiguration)
+        self.assertIs(config.bucket, bucket)
+        self.assertFalse(config.bucket_policy_only_enabled)
+        self.assertIsNone(config.bucket_policy_only_locked_time)
+
+    def test_iam_configuration_policy_w_entry(self):
+        import datetime
+        import pytz
+        from google.cloud._helpers import _datetime_to_rfc3339
+        from google.cloud.storage.bucket import IAMConfiguration
+
+        now = datetime.datetime.utcnow().replace(tzinfo=pytz.UTC)
+        NAME = "name"
+        properties = {
+            "iamConfiguration": {
+                "bucketPolicyOnly": {
+                    "enabled": True,
+                    "lockedTime": _datetime_to_rfc3339(now),
+                }
+            }
+        }
+        bucket = self._make_one(name=NAME, properties=properties)
+
+        config = bucket.iam_configuration
+
+        self.assertIsInstance(config, IAMConfiguration)
+        self.assertIs(config.bucket, bucket)
+        self.assertTrue(config.bucket_policy_only_enabled)
+        self.assertEqual(config.bucket_policy_only_locked_time, now)
+
+    def test_lifecycle_rules_getter_unknown_action_type(self):
+        NAME = "name"
+        BOGUS_RULE = {"action": {"type": "Bogus"}, "condition": {"age": 42}}
+        rules = [BOGUS_RULE]
+        properties = {"lifecycle": {"rule": rules}}
+        bucket = self._make_one(name=NAME, properties=properties)
+
+        with self.assertRaises(ValueError):
+            list(bucket.lifecycle_rules)
+
+    def test_lifecycle_rules_getter(self):
+        from google.cloud.storage.bucket import (
+            LifecycleRuleDelete,
+            LifecycleRuleSetStorageClass,
+        )
+
+        NAME = "name"
+        DELETE_RULE = {"action": {"type": "Delete"}, "condition": {"age": 42}}
+        SSC_RULE = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": {"isLive": False},
+        }
+        rules = [DELETE_RULE, SSC_RULE]
+        properties = {"lifecycle": {"rule": rules}}
+        bucket = self._make_one(name=NAME, properties=properties)
+
+        found = list(bucket.lifecycle_rules)
+
+        delete_rule = found[0]
+        self.assertIsInstance(delete_rule, LifecycleRuleDelete)
+        self.assertEqual(dict(delete_rule), DELETE_RULE)
+
+        ssc_rule = found[1]
+        self.assertIsInstance(ssc_rule, LifecycleRuleSetStorageClass)
+        self.assertEqual(dict(ssc_rule), SSC_RULE)
+
+    def test_lifecycle_rules_setter_w_dicts(self):
+        NAME = "name"
+        DELETE_RULE = {"action": {"type": "Delete"}, "condition": {"age": 42}}
+        SSC_RULE = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": {"isLive": False},
+        }
+        rules = [DELETE_RULE, SSC_RULE]
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(list(bucket.lifecycle_rules), [])
+
+        bucket.lifecycle_rules = rules
+
+        self.assertEqual([dict(rule) for rule in bucket.lifecycle_rules], rules)
+        self.assertTrue("lifecycle" in bucket._changes)
+
+    def test_lifecycle_rules_setter_w_helpers(self):
+        from google.cloud.storage.bucket import (
+            LifecycleRuleDelete,
+            LifecycleRuleSetStorageClass,
+        )
+
+        NAME = "name"
+        DELETE_RULE = {"action": {"type": "Delete"}, "condition": {"age": 42}}
+        SSC_RULE = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": {"isLive": False},
+        }
+        rules = [DELETE_RULE, SSC_RULE]
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(list(bucket.lifecycle_rules), [])
+
+        bucket.lifecycle_rules = [
+            LifecycleRuleDelete(age=42),
+            LifecycleRuleSetStorageClass("NEARLINE", is_live=False),
+        ]
+
+        self.assertEqual([dict(rule) for rule in bucket.lifecycle_rules], rules)
+        self.assertTrue("lifecycle" in bucket._changes)
+
+    def test_clear_lifecycle_rules(self):
+        NAME = "name"
+        DELETE_RULE = {"action": {"type": "Delete"}, "condition": {"age": 42}}
+        SSC_RULE = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": {"isLive": False},
+        }
+        rules = [DELETE_RULE, SSC_RULE]
+        bucket = self._make_one(name=NAME)
+        bucket._properties["lifecycle"] = {"rule": rules}
+        self.assertEqual(list(bucket.lifecycle_rules), rules)
+
+        bucket.clear_lifecyle_rules()
+
+        self.assertEqual(list(bucket.lifecycle_rules), [])
+        self.assertTrue("lifecycle" in bucket._changes)
+
+    def test_add_lifecycle_delete_rule(self):
+        NAME = "name"
+        DELETE_RULE = {"action": {"type": "Delete"}, "condition": {"age": 42}}
+        rules = [DELETE_RULE]
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(list(bucket.lifecycle_rules), [])
+
+        bucket.add_lifecycle_delete_rule(age=42)
+
+        self.assertEqual([dict(rule) for rule in bucket.lifecycle_rules], rules)
+        self.assertTrue("lifecycle" in bucket._changes)
+
+    def test_add_lifecycle_set_storage_class_rule(self):
+        NAME = "name"
+        SSC_RULE = {
+            "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
+            "condition": {"isLive": False},
+        }
+        rules = [SSC_RULE]
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(list(bucket.lifecycle_rules), [])
+
+        bucket.add_lifecycle_set_storage_class_rule("NEARLINE", is_live=False)
+
+        self.assertEqual([dict(rule) for rule in bucket.lifecycle_rules], rules)
+        self.assertTrue("lifecycle" in bucket._changes)
+
+    def test_cors_getter(self):
+        NAME = "name"
+        CORS_ENTRY = {
+            "maxAgeSeconds": 1234,
+            "method": ["OPTIONS", "GET"],
+            "origin": ["127.0.0.1"],
+            "responseHeader": ["Content-Type"],
+        }
+        properties = {"cors": [CORS_ENTRY, {}]}
+        bucket = self._make_one(name=NAME, properties=properties)
+        entries = bucket.cors
+        self.assertEqual(len(entries), 2)
+        self.assertEqual(entries[0], CORS_ENTRY)
+        self.assertEqual(entries[1], {})
+        # Make sure it was a copy, not the same object.
+        self.assertIsNot(entries[0], CORS_ENTRY)
+
+    def test_cors_setter(self):
+        NAME = "name"
+        CORS_ENTRY = {
+            "maxAgeSeconds": 1234,
+            "method": ["OPTIONS", "GET"],
+            "origin": ["127.0.0.1"],
+            "responseHeader": ["Content-Type"],
+        }
+        bucket = self._make_one(name=NAME)
+
+        self.assertEqual(bucket.cors, [])
+        bucket.cors = [CORS_ENTRY]
+        self.assertEqual(bucket.cors, [CORS_ENTRY])
+        self.assertTrue("cors" in bucket._changes)
+
+    def test_default_kms_key_name_getter(self):
+        NAME = "name"
+        KMS_RESOURCE = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        ENCRYPTION_CONFIG = {"defaultKmsKeyName": KMS_RESOURCE}
+        bucket = self._make_one(name=NAME)
+        self.assertIsNone(bucket.default_kms_key_name)
+        bucket._properties["encryption"] = ENCRYPTION_CONFIG
+        self.assertEqual(bucket.default_kms_key_name, KMS_RESOURCE)
+
+    def test_default_kms_key_name_setter(self):
+        NAME = "name"
+        KMS_RESOURCE = (
+            "projects/test-project-123/"
+            "locations/us/"
+            "keyRings/test-ring/"
+            "cryptoKeys/test-key"
+        )
+        ENCRYPTION_CONFIG = {"defaultKmsKeyName": KMS_RESOURCE}
+        bucket = self._make_one(name=NAME)
+        bucket.default_kms_key_name = KMS_RESOURCE
+        self.assertEqual(bucket._properties["encryption"], ENCRYPTION_CONFIG)
+        self.assertTrue("encryption" in bucket._changes)
+
+    def test_labels_getter(self):
+        NAME = "name"
+        LABELS = {"color": "red", "flavor": "cherry"}
+        properties = {"labels": LABELS}
+        bucket = self._make_one(name=NAME, properties=properties)
+        labels = bucket.labels
+        self.assertEqual(labels, LABELS)
+        # Make sure it was a copy, not the same object.
+        self.assertIsNot(labels, LABELS)
+
+    def test_labels_setter(self):
+        NAME = "name"
+        LABELS = {"color": "red", "flavor": "cherry"}
+        bucket = self._make_one(name=NAME)
+
+        self.assertEqual(bucket.labels, {})
+        bucket.labels = LABELS
+        self.assertEqual(bucket.labels, LABELS)
+        self.assertIsNot(bucket._properties["labels"], LABELS)
+        self.assertIn("labels", bucket._changes)
+
+    def test_labels_setter_with_removal(self):
+        # Make sure the bucket labels look correct and follow the expected
+        # public structure.
+        bucket = self._make_one(name="name")
+        self.assertEqual(bucket.labels, {})
+        bucket.labels = {"color": "red", "flavor": "cherry"}
+        self.assertEqual(bucket.labels, {"color": "red", "flavor": "cherry"})
+        bucket.labels = {"color": "red"}
+        self.assertEqual(bucket.labels, {"color": "red"})
+
+        # Make sure that a patch call correctly removes the flavor label.
+        client = mock.NonCallableMock(spec=("_connection",))
+        client._connection = mock.NonCallableMock(spec=("api_request",))
+        bucket.patch(client=client)
+        client._connection.api_request.assert_called()
+        _, _, kwargs = client._connection.api_request.mock_calls[0]
+        self.assertEqual(len(kwargs["data"]["labels"]), 2)
+        self.assertEqual(kwargs["data"]["labels"]["color"], "red")
+        self.assertIsNone(kwargs["data"]["labels"]["flavor"])
+
+        # A second patch call should be a no-op for labels.
+        client._connection.api_request.reset_mock()
+        bucket.patch(client=client)
+        client._connection.api_request.assert_called()
+        _, _, kwargs = client._connection.api_request.mock_calls[0]
+        self.assertNotIn("labels", kwargs["data"])
+
+    def test_location_type_getter_unset(self):
+        bucket = self._make_one()
+        self.assertIsNone(bucket.location_type)
+
+    def test_location_type_getter_set(self):
+        klass = self._get_target_class()
+        properties = {"locationType": klass.REGION_LOCATION_TYPE}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.location_type, klass.REGION_LOCATION_TYPE)
+
+    def test_get_logging_w_prefix(self):
+        NAME = "name"
+        LOG_BUCKET = "logs"
+        LOG_PREFIX = "pfx"
+        before = {"logging": {"logBucket": LOG_BUCKET, "logObjectPrefix": LOG_PREFIX}}
+        bucket = self._make_one(name=NAME, properties=before)
+        info = bucket.get_logging()
+        self.assertEqual(info["logBucket"], LOG_BUCKET)
+        self.assertEqual(info["logObjectPrefix"], LOG_PREFIX)
+
+    def test_enable_logging_defaults(self):
+        NAME = "name"
+        LOG_BUCKET = "logs"
+        before = {"logging": None}
+        bucket = self._make_one(name=NAME, properties=before)
+        self.assertIsNone(bucket.get_logging())
+        bucket.enable_logging(LOG_BUCKET)
+        info = bucket.get_logging()
+        self.assertEqual(info["logBucket"], LOG_BUCKET)
+        self.assertEqual(info["logObjectPrefix"], "")
+
+    def test_enable_logging(self):
+        NAME = "name"
+        LOG_BUCKET = "logs"
+        LOG_PFX = "pfx"
+        before = {"logging": None}
+        bucket = self._make_one(name=NAME, properties=before)
+        self.assertIsNone(bucket.get_logging())
+        bucket.enable_logging(LOG_BUCKET, LOG_PFX)
+        info = bucket.get_logging()
+        self.assertEqual(info["logBucket"], LOG_BUCKET)
+        self.assertEqual(info["logObjectPrefix"], LOG_PFX)
+
+    def test_disable_logging(self):
+        NAME = "name"
+        before = {"logging": {"logBucket": "logs", "logObjectPrefix": "pfx"}}
+        bucket = self._make_one(name=NAME, properties=before)
+        self.assertIsNotNone(bucket.get_logging())
+        bucket.disable_logging()
+        self.assertIsNone(bucket.get_logging())
+
+    def test_metageneration(self):
+        METAGENERATION = 42
+        properties = {"metageneration": METAGENERATION}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.metageneration, METAGENERATION)
+
+    def test_metageneration_unset(self):
+        bucket = self._make_one()
+        self.assertIsNone(bucket.metageneration)
+
+    def test_metageneration_string_val(self):
+        METAGENERATION = 42
+        properties = {"metageneration": str(METAGENERATION)}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.metageneration, METAGENERATION)
+
+    def test_owner(self):
+        OWNER = {"entity": "project-owner-12345", "entityId": "23456"}
+        properties = {"owner": OWNER}
+        bucket = self._make_one(properties=properties)
+        owner = bucket.owner
+        self.assertEqual(owner["entity"], "project-owner-12345")
+        self.assertEqual(owner["entityId"], "23456")
+
+    def test_project_number(self):
+        PROJECT_NUMBER = 12345
+        properties = {"projectNumber": PROJECT_NUMBER}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.project_number, PROJECT_NUMBER)
+
+    def test_project_number_unset(self):
+        bucket = self._make_one()
+        self.assertIsNone(bucket.project_number)
+
+    def test_project_number_string_val(self):
+        PROJECT_NUMBER = 12345
+        properties = {"projectNumber": str(PROJECT_NUMBER)}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.project_number, PROJECT_NUMBER)
+
+    def test_retention_policy_effective_time_policy_missing(self):
+        bucket = self._make_one()
+        self.assertIsNone(bucket.retention_policy_effective_time)
+
+    def test_retention_policy_effective_time_et_missing(self):
+        properties = {"retentionPolicy": {}}
+        bucket = self._make_one(properties=properties)
+
+        self.assertIsNone(bucket.retention_policy_effective_time)
+
+    def test_retention_policy_effective_time(self):
+        import datetime
+        from google.cloud._helpers import _datetime_to_rfc3339
+        from google.cloud._helpers import UTC
+
+        effective_time = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        properties = {
+            "retentionPolicy": {"effectiveTime": _datetime_to_rfc3339(effective_time)}
+        }
+        bucket = self._make_one(properties=properties)
+
+        self.assertEqual(bucket.retention_policy_effective_time, effective_time)
+
+    def test_retention_policy_locked_missing(self):
+        bucket = self._make_one()
+        self.assertFalse(bucket.retention_policy_locked)
+
+    def test_retention_policy_locked_false(self):
+        properties = {"retentionPolicy": {"isLocked": False}}
+        bucket = self._make_one(properties=properties)
+        self.assertFalse(bucket.retention_policy_locked)
+
+    def test_retention_policy_locked_true(self):
+        properties = {"retentionPolicy": {"isLocked": True}}
+        bucket = self._make_one(properties=properties)
+        self.assertTrue(bucket.retention_policy_locked)
+
+    def test_retention_period_getter_policymissing(self):
+        bucket = self._make_one()
+
+        self.assertIsNone(bucket.retention_period)
+
+    def test_retention_period_getter_pr_missing(self):
+        properties = {"retentionPolicy": {}}
+        bucket = self._make_one(properties=properties)
+
+        self.assertIsNone(bucket.retention_period)
+
+    def test_retention_period_getter(self):
+        period = 86400 * 100  # 100 days
+        properties = {"retentionPolicy": {"retentionPeriod": str(period)}}
+        bucket = self._make_one(properties=properties)
+
+        self.assertEqual(bucket.retention_period, period)
+
+    def test_retention_period_setter_w_none(self):
+        period = 86400 * 100  # 100 days
+        bucket = self._make_one()
+        bucket._properties["retentionPolicy"] = {"retentionPeriod": period}
+
+        bucket.retention_period = None
+
+        self.assertIsNone(bucket._properties["retentionPolicy"])
+
+    def test_retention_period_setter_w_int(self):
+        period = 86400 * 100  # 100 days
+        bucket = self._make_one()
+
+        bucket.retention_period = period
+
+        self.assertEqual(
+            bucket._properties["retentionPolicy"]["retentionPeriod"], str(period)
+        )
+
+    def test_self_link(self):
+        SELF_LINK = "http://example.com/self/"
+        properties = {"selfLink": SELF_LINK}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.self_link, SELF_LINK)
+
+    def test_storage_class_getter(self):
+        klass = self._get_target_class()
+        properties = {"storageClass": klass.NEARLINE_STORAGE_CLASS}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.storage_class, klass.NEARLINE_STORAGE_CLASS)
+
+    def test_storage_class_setter_invalid(self):
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        with self.assertRaises(ValueError):
+            bucket.storage_class = "BOGUS"
+        self.assertFalse("storageClass" in bucket._changes)
+
+    def test_storage_class_setter_STANDARD(self):
+        klass = self._get_target_class()
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        bucket.storage_class = klass.STANDARD_STORAGE_CLASS
+        self.assertEqual(bucket.storage_class, klass.STANDARD_STORAGE_CLASS)
+        self.assertTrue("storageClass" in bucket._changes)
+
+    def test_storage_class_setter_NEARLINE(self):
+        klass = self._get_target_class()
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        bucket.storage_class = klass.NEARLINE_STORAGE_CLASS
+        self.assertEqual(bucket.storage_class, klass.NEARLINE_STORAGE_CLASS)
+        self.assertTrue("storageClass" in bucket._changes)
+
+    def test_storage_class_setter_COLDLINE(self):
+        klass = self._get_target_class()
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        bucket.storage_class = klass.COLDLINE_STORAGE_CLASS
+        self.assertEqual(bucket.storage_class, klass.COLDLINE_STORAGE_CLASS)
+        self.assertTrue("storageClass" in bucket._changes)
+
+    def test_storage_class_setter_MULTI_REGIONAL(self):
+        klass = self._get_target_class()
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        bucket.storage_class = klass.MULTI_REGIONAL_LEGACY_STORAGE_CLASS
+        self.assertEqual(
+            bucket.storage_class, klass.MULTI_REGIONAL_LEGACY_STORAGE_CLASS
+        )
+        self.assertTrue("storageClass" in bucket._changes)
+
+    def test_storage_class_setter_REGIONAL(self):
+        klass = self._get_target_class()
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        bucket.storage_class = klass.REGIONAL_LEGACY_STORAGE_CLASS
+        self.assertEqual(bucket.storage_class, klass.REGIONAL_LEGACY_STORAGE_CLASS)
+        self.assertTrue("storageClass" in bucket._changes)
+
+    def test_storage_class_setter_DURABLE_REDUCED_AVAILABILITY(self):
+        klass = self._get_target_class()
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        bucket.storage_class = klass.DURABLE_REDUCED_AVAILABILITY_LEGACY_STORAGE_CLASS
+        self.assertEqual(
+            bucket.storage_class,
+            klass.DURABLE_REDUCED_AVAILABILITY_LEGACY_STORAGE_CLASS,
+        )
+        self.assertTrue("storageClass" in bucket._changes)
+
+    def test_time_created(self):
+        from google.cloud._helpers import _RFC3339_MICROS
+        from google.cloud._helpers import UTC
+
+        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
+        TIME_CREATED = TIMESTAMP.strftime(_RFC3339_MICROS)
+        properties = {"timeCreated": TIME_CREATED}
+        bucket = self._make_one(properties=properties)
+        self.assertEqual(bucket.time_created, TIMESTAMP)
+
+    def test_time_created_unset(self):
+        bucket = self._make_one()
+        self.assertIsNone(bucket.time_created)
+
+    def test_versioning_enabled_getter_missing(self):
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(bucket.versioning_enabled, False)
+
+    def test_versioning_enabled_getter(self):
+        NAME = "name"
+        before = {"versioning": {"enabled": True}}
+        bucket = self._make_one(name=NAME, properties=before)
+        self.assertEqual(bucket.versioning_enabled, True)
+
+    def test_versioning_enabled_setter(self):
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        self.assertFalse(bucket.versioning_enabled)
+        bucket.versioning_enabled = True
+        self.assertTrue(bucket.versioning_enabled)
+
+    def test_requester_pays_getter_missing(self):
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        self.assertEqual(bucket.requester_pays, False)
+
+    def test_requester_pays_getter(self):
+        NAME = "name"
+        before = {"billing": {"requesterPays": True}}
+        bucket = self._make_one(name=NAME, properties=before)
+        self.assertEqual(bucket.requester_pays, True)
+
+    def test_requester_pays_setter(self):
+        NAME = "name"
+        bucket = self._make_one(name=NAME)
+        self.assertFalse(bucket.requester_pays)
+        bucket.requester_pays = True
+        self.assertTrue(bucket.requester_pays)
+
+    def test_configure_website_defaults(self):
+        NAME = "name"
+        UNSET = {"website": {"mainPageSuffix": None, "notFoundPage": None}}
+        bucket = self._make_one(name=NAME)
+        bucket.configure_website()
+        self.assertEqual(bucket._properties, UNSET)
+
+    def test_configure_website(self):
+        NAME = "name"
+        WEBSITE_VAL = {
+            "website": {"mainPageSuffix": "html", "notFoundPage": "404.html"}
+        }
+        bucket = self._make_one(name=NAME)
+        bucket.configure_website("html", "404.html")
+        self.assertEqual(bucket._properties, WEBSITE_VAL)
+
+    def test_disable_website(self):
+        NAME = "name"
+        UNSET = {"website": {"mainPageSuffix": None, "notFoundPage": None}}
+        bucket = self._make_one(name=NAME)
+        bucket.disable_website()
+        self.assertEqual(bucket._properties, UNSET)
+
+    def test_get_iam_policy(self):
+        from google.cloud.storage.iam import STORAGE_OWNER_ROLE
+        from google.cloud.storage.iam import STORAGE_EDITOR_ROLE
+        from google.cloud.storage.iam import STORAGE_VIEWER_ROLE
+        from google.api_core.iam import Policy
+
+        NAME = "name"
+        PATH = "/b/%s" % (NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        OWNER1 = "user:phred@example.com"
+        OWNER2 = "group:cloud-logs@google.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        RETURNED = {
+            "resourceId": PATH,
+            "etag": ETAG,
+            "version": VERSION,
+            "bindings": [
+                {"role": STORAGE_OWNER_ROLE, "members": [OWNER1, OWNER2]},
+                {"role": STORAGE_EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+                {"role": STORAGE_VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+            ],
+        }
+        EXPECTED = {
+            binding["role"]: set(binding["members"]) for binding in RETURNED["bindings"]
+        }
+        connection = _Connection(RETURNED)
+        client = _Client(connection, None)
+        bucket = self._make_one(client=client, name=NAME)
+
+        policy = bucket.get_iam_policy()
+
+        self.assertIsInstance(policy, Policy)
+        self.assertEqual(policy.etag, RETURNED["etag"])
+        self.assertEqual(policy.version, RETURNED["version"])
+        self.assertEqual(dict(policy), EXPECTED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "GET")
+        self.assertEqual(kw[0]["path"], "%s/iam" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {})
+
+    def test_get_iam_policy_w_user_project(self):
+        from google.api_core.iam import Policy
+
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        PATH = "/b/%s" % (NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        RETURNED = {
+            "resourceId": PATH,
+            "etag": ETAG,
+            "version": VERSION,
+            "bindings": [],
+        }
+        EXPECTED = {}
+        connection = _Connection(RETURNED)
+        client = _Client(connection, None)
+        bucket = self._make_one(client=client, name=NAME, user_project=USER_PROJECT)
+
+        policy = bucket.get_iam_policy()
+
+        self.assertIsInstance(policy, Policy)
+        self.assertEqual(policy.etag, RETURNED["etag"])
+        self.assertEqual(policy.version, RETURNED["version"])
+        self.assertEqual(dict(policy), EXPECTED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "GET")
+        self.assertEqual(kw[0]["path"], "%s/iam" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {"userProject": USER_PROJECT})
+
+    def test_set_iam_policy(self):
+        import operator
+        from google.cloud.storage.iam import STORAGE_OWNER_ROLE
+        from google.cloud.storage.iam import STORAGE_EDITOR_ROLE
+        from google.cloud.storage.iam import STORAGE_VIEWER_ROLE
+        from google.api_core.iam import Policy
+
+        NAME = "name"
+        PATH = "/b/%s" % (NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        OWNER1 = "user:phred@example.com"
+        OWNER2 = "group:cloud-logs@google.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        BINDINGS = [
+            {"role": STORAGE_OWNER_ROLE, "members": [OWNER1, OWNER2]},
+            {"role": STORAGE_EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+            {"role": STORAGE_VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+        ]
+        RETURNED = {"etag": ETAG, "version": VERSION, "bindings": BINDINGS}
+        policy = Policy()
+        for binding in BINDINGS:
+            policy[binding["role"]] = binding["members"]
+
+        connection = _Connection(RETURNED)
+        client = _Client(connection, None)
+        bucket = self._make_one(client=client, name=NAME)
+
+        returned = bucket.set_iam_policy(policy)
+
+        self.assertEqual(returned.etag, ETAG)
+        self.assertEqual(returned.version, VERSION)
+        self.assertEqual(dict(returned), dict(policy))
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PUT")
+        self.assertEqual(kw[0]["path"], "%s/iam" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {})
+        sent = kw[0]["data"]
+        self.assertEqual(sent["resourceId"], PATH)
+        self.assertEqual(len(sent["bindings"]), len(BINDINGS))
+        key = operator.itemgetter("role")
+        for found, expected in zip(
+            sorted(sent["bindings"], key=key), sorted(BINDINGS, key=key)
+        ):
+            self.assertEqual(found["role"], expected["role"])
+            self.assertEqual(sorted(found["members"]), sorted(expected["members"]))
+
+    def test_set_iam_policy_w_user_project(self):
+        import operator
+        from google.cloud.storage.iam import STORAGE_OWNER_ROLE
+        from google.cloud.storage.iam import STORAGE_EDITOR_ROLE
+        from google.cloud.storage.iam import STORAGE_VIEWER_ROLE
+        from google.api_core.iam import Policy
+
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        PATH = "/b/%s" % (NAME,)
+        ETAG = "DEADBEEF"
+        VERSION = 17
+        OWNER1 = "user:phred@example.com"
+        OWNER2 = "group:cloud-logs@google.com"
+        EDITOR1 = "domain:google.com"
+        EDITOR2 = "user:phred@example.com"
+        VIEWER1 = "serviceAccount:1234-abcdef@service.example.com"
+        VIEWER2 = "user:phred@example.com"
+        BINDINGS = [
+            {"role": STORAGE_OWNER_ROLE, "members": [OWNER1, OWNER2]},
+            {"role": STORAGE_EDITOR_ROLE, "members": [EDITOR1, EDITOR2]},
+            {"role": STORAGE_VIEWER_ROLE, "members": [VIEWER1, VIEWER2]},
+        ]
+        RETURNED = {"etag": ETAG, "version": VERSION, "bindings": BINDINGS}
+        policy = Policy()
+        for binding in BINDINGS:
+            policy[binding["role"]] = binding["members"]
+
+        connection = _Connection(RETURNED)
+        client = _Client(connection, None)
+        bucket = self._make_one(client=client, name=NAME, user_project=USER_PROJECT)
+
+        returned = bucket.set_iam_policy(policy)
+
+        self.assertEqual(returned.etag, ETAG)
+        self.assertEqual(returned.version, VERSION)
+        self.assertEqual(dict(returned), dict(policy))
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PUT")
+        self.assertEqual(kw[0]["path"], "%s/iam" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {"userProject": USER_PROJECT})
+        sent = kw[0]["data"]
+        self.assertEqual(sent["resourceId"], PATH)
+        self.assertEqual(len(sent["bindings"]), len(BINDINGS))
+        key = operator.itemgetter("role")
+        for found, expected in zip(
+            sorted(sent["bindings"], key=key), sorted(BINDINGS, key=key)
+        ):
+            self.assertEqual(found["role"], expected["role"])
+            self.assertEqual(sorted(found["members"]), sorted(expected["members"]))
+
+    def test_test_iam_permissions(self):
+        from google.cloud.storage.iam import STORAGE_OBJECTS_LIST
+        from google.cloud.storage.iam import STORAGE_BUCKETS_GET
+        from google.cloud.storage.iam import STORAGE_BUCKETS_UPDATE
+
+        NAME = "name"
+        PATH = "/b/%s" % (NAME,)
+        PERMISSIONS = [
+            STORAGE_OBJECTS_LIST,
+            STORAGE_BUCKETS_GET,
+            STORAGE_BUCKETS_UPDATE,
+        ]
+        ALLOWED = PERMISSIONS[1:]
+        RETURNED = {"permissions": ALLOWED}
+        connection = _Connection(RETURNED)
+        client = _Client(connection, None)
+        bucket = self._make_one(client=client, name=NAME)
+
+        allowed = bucket.test_iam_permissions(PERMISSIONS)
+
+        self.assertEqual(allowed, ALLOWED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "GET")
+        self.assertEqual(kw[0]["path"], "%s/iam/testPermissions" % (PATH,))
+        self.assertEqual(kw[0]["query_params"], {"permissions": PERMISSIONS})
+
+    def test_test_iam_permissions_w_user_project(self):
+        from google.cloud.storage.iam import STORAGE_OBJECTS_LIST
+        from google.cloud.storage.iam import STORAGE_BUCKETS_GET
+        from google.cloud.storage.iam import STORAGE_BUCKETS_UPDATE
+
+        NAME = "name"
+        USER_PROJECT = "user-project-123"
+        PATH = "/b/%s" % (NAME,)
+        PERMISSIONS = [
+            STORAGE_OBJECTS_LIST,
+            STORAGE_BUCKETS_GET,
+            STORAGE_BUCKETS_UPDATE,
+        ]
+        ALLOWED = PERMISSIONS[1:]
+        RETURNED = {"permissions": ALLOWED}
+        connection = _Connection(RETURNED)
+        client = _Client(connection, None)
+        bucket = self._make_one(client=client, name=NAME, user_project=USER_PROJECT)
+
+        allowed = bucket.test_iam_permissions(PERMISSIONS)
+
+        self.assertEqual(allowed, ALLOWED)
+
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "GET")
+        self.assertEqual(kw[0]["path"], "%s/iam/testPermissions" % (PATH,))
+        self.assertEqual(
+            kw[0]["query_params"],
+            {"permissions": PERMISSIONS, "userProject": USER_PROJECT},
+        )
+
+    def test_make_public_defaults(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        NAME = "name"
+        permissive = [{"entity": "allUsers", "role": _ACLEntity.READER_ROLE}]
+        after = {"acl": permissive, "defaultObjectAcl": []}
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = True
+        bucket.make_public()
+        self.assertEqual(list(bucket.acl), permissive)
+        self.assertEqual(list(bucket.default_object_acl), [])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[0]["data"], {"acl": after["acl"]})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+
+    def _make_public_w_future_helper(self, default_object_acl_loaded=True):
+        from google.cloud.storage.acl import _ACLEntity
+
+        NAME = "name"
+        permissive = [{"entity": "allUsers", "role": _ACLEntity.READER_ROLE}]
+        after1 = {"acl": permissive, "defaultObjectAcl": []}
+        after2 = {"acl": permissive, "defaultObjectAcl": permissive}
+        if default_object_acl_loaded:
+            num_requests = 2
+            connection = _Connection(after1, after2)
+        else:
+            num_requests = 3
+            # We return the same value for default_object_acl.reload()
+            # to consume.
+            connection = _Connection(after1, after1, after2)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = default_object_acl_loaded
+        bucket.make_public(future=True)
+        self.assertEqual(list(bucket.acl), permissive)
+        self.assertEqual(list(bucket.default_object_acl), permissive)
+        kw = connection._requested
+        self.assertEqual(len(kw), num_requests)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[0]["data"], {"acl": permissive})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+        if not default_object_acl_loaded:
+            self.assertEqual(kw[1]["method"], "GET")
+            self.assertEqual(kw[1]["path"], "/b/%s/defaultObjectAcl" % NAME)
+        # Last could be 1 or 2 depending on `default_object_acl_loaded`.
+        self.assertEqual(kw[-1]["method"], "PATCH")
+        self.assertEqual(kw[-1]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[-1]["data"], {"defaultObjectAcl": permissive})
+        self.assertEqual(kw[-1]["query_params"], {"projection": "full"})
+
+    def test_make_public_w_future(self):
+        self._make_public_w_future_helper(default_object_acl_loaded=True)
+
+    def test_make_public_w_future_reload_default(self):
+        self._make_public_w_future_helper(default_object_acl_loaded=False)
+
+    def test_make_public_recursive(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        _saved = []
+
+        class _Blob(object):
+            _granted = False
+
+            def __init__(self, bucket, name):
+                self._bucket = bucket
+                self._name = name
+
+            @property
+            def acl(self):
+                return self
+
+            # Faux ACL methods
+            def all(self):
+                return self
+
+            def grant_read(self):
+                self._granted = True
+
+            def save(self, client=None):
+                _saved.append((self._bucket, self._name, self._granted, client))
+
+        def item_to_blob(self, item):
+            return _Blob(self.bucket, item["name"])
+
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        permissive = [{"entity": "allUsers", "role": _ACLEntity.READER_ROLE}]
+        after = {"acl": permissive, "defaultObjectAcl": []}
+        connection = _Connection(after, {"items": [{"name": BLOB_NAME}]})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = True
+
+        with mock.patch("google.cloud.storage.bucket._item_to_blob", new=item_to_blob):
+            bucket.make_public(recursive=True)
+        self.assertEqual(list(bucket.acl), permissive)
+        self.assertEqual(list(bucket.default_object_acl), [])
+        self.assertEqual(_saved, [(bucket, BLOB_NAME, True, None)])
+        kw = connection._requested
+        self.assertEqual(len(kw), 2)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[0]["data"], {"acl": permissive})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+        self.assertEqual(kw[1]["method"], "GET")
+        self.assertEqual(kw[1]["path"], "/b/%s/o" % NAME)
+        max_results = bucket._MAX_OBJECTS_FOR_ITERATION + 1
+        self.assertEqual(
+            kw[1]["query_params"], {"maxResults": max_results, "projection": "full"}
+        )
+
+    def test_make_public_recursive_too_many(self):
+        from google.cloud.storage.acl import _ACLEntity
+
+        PERMISSIVE = [{"entity": "allUsers", "role": _ACLEntity.READER_ROLE}]
+        AFTER = {"acl": PERMISSIVE, "defaultObjectAcl": []}
+
+        NAME = "name"
+        BLOB_NAME1 = "blob-name1"
+        BLOB_NAME2 = "blob-name2"
+        GET_BLOBS_RESP = {"items": [{"name": BLOB_NAME1}, {"name": BLOB_NAME2}]}
+        connection = _Connection(AFTER, GET_BLOBS_RESP)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = True
+
+        # Make the Bucket refuse to make_public with 2 objects.
+        bucket._MAX_OBJECTS_FOR_ITERATION = 1
+        self.assertRaises(ValueError, bucket.make_public, recursive=True)
+
+    def test_make_private_defaults(self):
+        NAME = "name"
+        no_permissions = []
+        after = {"acl": no_permissions, "defaultObjectAcl": []}
+        connection = _Connection(after)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = True
+        bucket.make_private()
+        self.assertEqual(list(bucket.acl), no_permissions)
+        self.assertEqual(list(bucket.default_object_acl), [])
+        kw = connection._requested
+        self.assertEqual(len(kw), 1)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[0]["data"], {"acl": after["acl"]})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+
+    def _make_private_w_future_helper(self, default_object_acl_loaded=True):
+        NAME = "name"
+        no_permissions = []
+        after1 = {"acl": no_permissions, "defaultObjectAcl": []}
+        after2 = {"acl": no_permissions, "defaultObjectAcl": no_permissions}
+        if default_object_acl_loaded:
+            num_requests = 2
+            connection = _Connection(after1, after2)
+        else:
+            num_requests = 3
+            # We return the same value for default_object_acl.reload()
+            # to consume.
+            connection = _Connection(after1, after1, after2)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = default_object_acl_loaded
+        bucket.make_private(future=True)
+        self.assertEqual(list(bucket.acl), no_permissions)
+        self.assertEqual(list(bucket.default_object_acl), no_permissions)
+        kw = connection._requested
+        self.assertEqual(len(kw), num_requests)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[0]["data"], {"acl": no_permissions})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+        if not default_object_acl_loaded:
+            self.assertEqual(kw[1]["method"], "GET")
+            self.assertEqual(kw[1]["path"], "/b/%s/defaultObjectAcl" % NAME)
+        # Last could be 1 or 2 depending on `default_object_acl_loaded`.
+        self.assertEqual(kw[-1]["method"], "PATCH")
+        self.assertEqual(kw[-1]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[-1]["data"], {"defaultObjectAcl": no_permissions})
+        self.assertEqual(kw[-1]["query_params"], {"projection": "full"})
+
+    def test_make_private_w_future(self):
+        self._make_private_w_future_helper(default_object_acl_loaded=True)
+
+    def test_make_private_w_future_reload_default(self):
+        self._make_private_w_future_helper(default_object_acl_loaded=False)
+
+    def test_make_private_recursive(self):
+        _saved = []
+
+        class _Blob(object):
+            _granted = True
+
+            def __init__(self, bucket, name):
+                self._bucket = bucket
+                self._name = name
+
+            @property
+            def acl(self):
+                return self
+
+            # Faux ACL methods
+            def all(self):
+                return self
+
+            def revoke_read(self):
+                self._granted = False
+
+            def save(self, client=None):
+                _saved.append((self._bucket, self._name, self._granted, client))
+
+        def item_to_blob(self, item):
+            return _Blob(self.bucket, item["name"])
+
+        NAME = "name"
+        BLOB_NAME = "blob-name"
+        no_permissions = []
+        after = {"acl": no_permissions, "defaultObjectAcl": []}
+        connection = _Connection(after, {"items": [{"name": BLOB_NAME}]})
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = True
+
+        with mock.patch("google.cloud.storage.bucket._item_to_blob", new=item_to_blob):
+            bucket.make_private(recursive=True)
+        self.assertEqual(list(bucket.acl), no_permissions)
+        self.assertEqual(list(bucket.default_object_acl), [])
+        self.assertEqual(_saved, [(bucket, BLOB_NAME, False, None)])
+        kw = connection._requested
+        self.assertEqual(len(kw), 2)
+        self.assertEqual(kw[0]["method"], "PATCH")
+        self.assertEqual(kw[0]["path"], "/b/%s" % NAME)
+        self.assertEqual(kw[0]["data"], {"acl": no_permissions})
+        self.assertEqual(kw[0]["query_params"], {"projection": "full"})
+        self.assertEqual(kw[1]["method"], "GET")
+        self.assertEqual(kw[1]["path"], "/b/%s/o" % NAME)
+        max_results = bucket._MAX_OBJECTS_FOR_ITERATION + 1
+        self.assertEqual(
+            kw[1]["query_params"], {"maxResults": max_results, "projection": "full"}
+        )
+
+    def test_make_private_recursive_too_many(self):
+        NO_PERMISSIONS = []
+        AFTER = {"acl": NO_PERMISSIONS, "defaultObjectAcl": []}
+
+        NAME = "name"
+        BLOB_NAME1 = "blob-name1"
+        BLOB_NAME2 = "blob-name2"
+        GET_BLOBS_RESP = {"items": [{"name": BLOB_NAME1}, {"name": BLOB_NAME2}]}
+        connection = _Connection(AFTER, GET_BLOBS_RESP)
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=NAME)
+        bucket.acl.loaded = True
+        bucket.default_object_acl.loaded = True
+
+        # Make the Bucket refuse to make_private with 2 objects.
+        bucket._MAX_OBJECTS_FOR_ITERATION = 1
+        self.assertRaises(ValueError, bucket.make_private, recursive=True)
+
+    def test_page_empty_response(self):
+        from google.api_core import page_iterator
+
+        connection = _Connection()
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+        iterator = bucket.list_blobs()
+        page = page_iterator.Page(iterator, (), None)
+        iterator._page = page
+        blobs = list(page)
+        self.assertEqual(blobs, [])
+        self.assertEqual(iterator.prefixes, set())
+
+    def test_page_non_empty_response(self):
+        import six
+        from google.cloud.storage.blob import Blob
+
+        blob_name = "blob-name"
+        response = {"items": [{"name": blob_name}], "prefixes": ["foo"]}
+        connection = _Connection()
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+
+        def dummy_response():
+            return response
+
+        iterator = bucket.list_blobs()
+        iterator._get_next_page_response = dummy_response
+
+        page = six.next(iterator.pages)
+        self.assertEqual(page.prefixes, ("foo",))
+        self.assertEqual(page.num_items, 1)
+        blob = six.next(page)
+        self.assertEqual(page.remaining, 0)
+        self.assertIsInstance(blob, Blob)
+        self.assertEqual(blob.name, blob_name)
+        self.assertEqual(iterator.prefixes, set(["foo"]))
+
+    def test_cumulative_prefixes(self):
+        import six
+        from google.cloud.storage.blob import Blob
+
+        BLOB_NAME = "blob-name1"
+        response1 = {
+            "items": [{"name": BLOB_NAME}],
+            "prefixes": ["foo"],
+            "nextPageToken": "s39rmf9",
+        }
+        response2 = {"items": [], "prefixes": ["bar"]}
+        connection = _Connection()
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+        responses = [response1, response2]
+
+        def dummy_response():
+            return responses.pop(0)
+
+        iterator = bucket.list_blobs()
+        iterator._get_next_page_response = dummy_response
+
+        # Parse first response.
+        pages_iter = iterator.pages
+        page1 = six.next(pages_iter)
+        self.assertEqual(page1.prefixes, ("foo",))
+        self.assertEqual(page1.num_items, 1)
+        blob = six.next(page1)
+        self.assertEqual(page1.remaining, 0)
+        self.assertIsInstance(blob, Blob)
+        self.assertEqual(blob.name, BLOB_NAME)
+        self.assertEqual(iterator.prefixes, set(["foo"]))
+        # Parse second response.
+        page2 = six.next(pages_iter)
+        self.assertEqual(page2.prefixes, ("bar",))
+        self.assertEqual(page2.num_items, 0)
+        self.assertEqual(iterator.prefixes, set(["foo", "bar"]))
+
+    def _test_generate_upload_policy_helper(self, **kwargs):
+        import base64
+        import json
+
+        credentials = _create_signing_credentials()
+        credentials.signer_email = mock.sentinel.signer_email
+        credentials.sign_bytes.return_value = b"DEADBEEF"
+        connection = _Connection()
+        connection.credentials = credentials
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+
+        conditions = [["starts-with", "$key", ""]]
+
+        policy_fields = bucket.generate_upload_policy(conditions, **kwargs)
+
+        self.assertEqual(policy_fields["bucket"], bucket.name)
+        self.assertEqual(policy_fields["GoogleAccessId"], mock.sentinel.signer_email)
+        self.assertEqual(
+            policy_fields["signature"], base64.b64encode(b"DEADBEEF").decode("utf-8")
+        )
+
+        policy = json.loads(base64.b64decode(policy_fields["policy"]).decode("utf-8"))
+
+        policy_conditions = policy["conditions"]
+        expected_conditions = [{"bucket": bucket.name}] + conditions
+        for expected_condition in expected_conditions:
+            for condition in policy_conditions:
+                if condition == expected_condition:
+                    break
+            else:  # pragma: NO COVER
+                self.fail(
+                    "Condition {} not found in {}".format(
+                        expected_condition, policy_conditions
+                    )
+                )
+
+        return policy_fields, policy
+
+    @mock.patch(
+        "google.cloud.storage.bucket._NOW", return_value=datetime.datetime(1990, 1, 1)
+    )
+    def test_generate_upload_policy(self, now):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        _, policy = self._test_generate_upload_policy_helper()
+
+        self.assertEqual(
+            policy["expiration"],
+            _datetime_to_rfc3339(now() + datetime.timedelta(hours=1)),
+        )
+
+    def test_generate_upload_policy_args(self):
+        from google.cloud._helpers import _datetime_to_rfc3339
+
+        expiration = datetime.datetime(1990, 5, 29)
+
+        _, policy = self._test_generate_upload_policy_helper(expiration=expiration)
+
+        self.assertEqual(policy["expiration"], _datetime_to_rfc3339(expiration))
+
+    def test_generate_upload_policy_bad_credentials(self):
+        credentials = object()
+        connection = _Connection()
+        connection.credentials = credentials
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+
+        with self.assertRaises(AttributeError):
+            bucket.generate_upload_policy([])
+
+    def test_lock_retention_policy_no_policy_set(self):
+        credentials = object()
+        connection = _Connection()
+        connection.credentials = credentials
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+        bucket._properties["metageneration"] = 1234
+
+        with self.assertRaises(ValueError):
+            bucket.lock_retention_policy()
+
+    def test_lock_retention_policy_no_metageneration(self):
+        credentials = object()
+        connection = _Connection()
+        connection.credentials = credentials
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+        bucket._properties["retentionPolicy"] = {
+            "effectiveTime": "2018-03-01T16:46:27.123456Z",
+            "retentionPeriod": 86400 * 100,  # 100 days
+        }
+
+        with self.assertRaises(ValueError):
+            bucket.lock_retention_policy()
+
+    def test_lock_retention_policy_already_locked(self):
+        credentials = object()
+        connection = _Connection()
+        connection.credentials = credentials
+        client = _Client(connection)
+        name = "name"
+        bucket = self._make_one(client=client, name=name)
+        bucket._properties["metageneration"] = 1234
+        bucket._properties["retentionPolicy"] = {
+            "effectiveTime": "2018-03-01T16:46:27.123456Z",
+            "isLocked": True,
+            "retentionPeriod": 86400 * 100,  # 100 days
+        }
+
+        with self.assertRaises(ValueError):
+            bucket.lock_retention_policy()
+
+    def test_lock_retention_policy_ok(self):
+        name = "name"
+        response = {
+            "name": name,
+            "metageneration": 1235,
+            "retentionPolicy": {
+                "effectiveTime": "2018-03-01T16:46:27.123456Z",
+                "isLocked": True,
+                "retentionPeriod": 86400 * 100,  # 100 days
+            },
+        }
+        credentials = object()
+        connection = _Connection(response)
+        connection.credentials = credentials
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=name)
+        bucket._properties["metageneration"] = 1234
+        bucket._properties["retentionPolicy"] = {
+            "effectiveTime": "2018-03-01T16:46:27.123456Z",
+            "retentionPeriod": 86400 * 100,  # 100 days
+        }
+
+        bucket.lock_retention_policy()
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], "/b/{}/lockRetentionPolicy".format(name))
+        self.assertEqual(kw["query_params"], {"ifMetagenerationMatch": 1234})
+
+    def test_lock_retention_policy_w_user_project(self):
+        name = "name"
+        user_project = "user-project-123"
+        response = {
+            "name": name,
+            "metageneration": 1235,
+            "retentionPolicy": {
+                "effectiveTime": "2018-03-01T16:46:27.123456Z",
+                "isLocked": True,
+                "retentionPeriod": 86400 * 100,  # 100 days
+            },
+        }
+        credentials = object()
+        connection = _Connection(response)
+        connection.credentials = credentials
+        client = _Client(connection)
+        bucket = self._make_one(client=client, name=name, user_project=user_project)
+        bucket._properties["metageneration"] = 1234
+        bucket._properties["retentionPolicy"] = {
+            "effectiveTime": "2018-03-01T16:46:27.123456Z",
+            "retentionPeriod": 86400 * 100,  # 100 days
+        }
+
+        bucket.lock_retention_policy()
+
+        kw, = connection._requested
+        self.assertEqual(kw["method"], "POST")
+        self.assertEqual(kw["path"], "/b/{}/lockRetentionPolicy".format(name))
+        self.assertEqual(
+            kw["query_params"],
+            {"ifMetagenerationMatch": 1234, "userProject": user_project},
+        )
+
+    def test_generate_signed_url_w_invalid_version(self):
+        expiration = "2014-10-16T20:34:37.000Z"
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(name="bucket_name", client=client)
+        with self.assertRaises(ValueError):
+            bucket.generate_signed_url(expiration, version="nonesuch")
+
+    def _generate_signed_url_helper(
+        self,
+        version=None,
+        bucket_name="bucket-name",
+        api_access_endpoint=None,
+        method="GET",
+        content_md5=None,
+        content_type=None,
+        response_type=None,
+        response_disposition=None,
+        generation=None,
+        headers=None,
+        query_parameters=None,
+        credentials=None,
+        expiration=None,
+    ):
+        from six.moves.urllib import parse
+        from google.cloud._helpers import UTC
+        from google.cloud.storage.blob import _API_ACCESS_ENDPOINT
+
+        api_access_endpoint = api_access_endpoint or _API_ACCESS_ENDPOINT
+
+        delta = datetime.timedelta(hours=1)
+
+        if expiration is None:
+            expiration = datetime.datetime.utcnow().replace(tzinfo=UTC) + delta
+
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = self._make_one(name=bucket_name, client=client)
+
+        if version is None:
+            effective_version = "v2"
+        else:
+            effective_version = version
+
+        to_patch = "google.cloud.storage.bucket.generate_signed_url_{}".format(
+            effective_version
+        )
+
+        with mock.patch(to_patch) as signer:
+            signed_uri = bucket.generate_signed_url(
+                expiration=expiration,
+                api_access_endpoint=api_access_endpoint,
+                method=method,
+                credentials=credentials,
+                headers=headers,
+                query_parameters=query_parameters,
+                version=version,
+            )
+
+        self.assertEqual(signed_uri, signer.return_value)
+
+        if credentials is None:
+            expected_creds = client._credentials
+        else:
+            expected_creds = credentials
+
+        encoded_name = bucket_name.encode("utf-8")
+        expected_resource = "/{}".format(parse.quote(encoded_name))
+        expected_kwargs = {
+            "resource": expected_resource,
+            "expiration": expiration,
+            "api_access_endpoint": api_access_endpoint,
+            "method": method.upper(),
+            "headers": headers,
+            "query_parameters": query_parameters,
+        }
+        signer.assert_called_once_with(expected_creds, **expected_kwargs)
+
+    def test_get_bucket_from_string_w_valid_uri(self):
+        from google.cloud.storage.bucket import Bucket
+
+        connection = _Connection()
+        client = _Client(connection)
+        BUCKET_NAME = "BUCKET_NAME"
+        uri = "gs://" + BUCKET_NAME
+        bucket = Bucket.from_string(uri, client)
+        self.assertIsInstance(bucket, Bucket)
+        self.assertIs(bucket.client, client)
+        self.assertEqual(bucket.name, BUCKET_NAME)
+
+    def test_get_bucket_from_string_w_invalid_uri(self):
+        from google.cloud.storage.bucket import Bucket
+
+        connection = _Connection()
+        client = _Client(connection)
+        bucket = mock.Mock()
+
+        with mock.patch("google.cloud.storage.client.Bucket", return_value=bucket):
+            with pytest.raises(ValueError, match="URI scheme must be gs"):
+                Bucket.from_string("http://bucket_name", client)
+
+    def test_get_bucket_from_string_w_domain_name_bucket(self):
+        from google.cloud.storage.bucket import Bucket
+
+        connection = _Connection()
+        client = _Client(connection)
+        BUCKET_NAME = "buckets.example.com"
+        uri = "gs://" + BUCKET_NAME
+        bucket = Bucket.from_string(uri, client)
+        self.assertIsInstance(bucket, Bucket)
+        self.assertIs(bucket.client, client)
+        self.assertEqual(bucket.name, BUCKET_NAME)
+
+    def test_generate_signed_url_no_version_passed_warning(self):
+        self._generate_signed_url_helper()
+
+    def _generate_signed_url_v2_helper(self, **kw):
+        version = "v2"
+        self._generate_signed_url_helper(version, **kw)
+
+    def test_generate_signed_url_v2_w_defaults(self):
+        self._generate_signed_url_v2_helper()
+
+    def test_generate_signed_url_v2_w_expiration(self):
+        from google.cloud._helpers import UTC
+
+        expiration = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        self._generate_signed_url_v2_helper(expiration=expiration)
+
+    def test_generate_signed_url_v2_w_endpoint(self):
+        self._generate_signed_url_v2_helper(
+            api_access_endpoint="https://api.example.com/v1"
+        )
+
+    def test_generate_signed_url_v2_w_method(self):
+        self._generate_signed_url_v2_helper(method="POST")
+
+    def test_generate_signed_url_v2_w_lowercase_method(self):
+        self._generate_signed_url_v2_helper(method="get")
+
+    def test_generate_signed_url_v2_w_content_md5(self):
+        self._generate_signed_url_v2_helper(content_md5="FACEDACE")
+
+    def test_generate_signed_url_v2_w_content_type(self):
+        self._generate_signed_url_v2_helper(content_type="text.html")
+
+    def test_generate_signed_url_v2_w_response_type(self):
+        self._generate_signed_url_v2_helper(response_type="text.html")
+
+    def test_generate_signed_url_v2_w_response_disposition(self):
+        self._generate_signed_url_v2_helper(response_disposition="inline")
+
+    def test_generate_signed_url_v2_w_generation(self):
+        self._generate_signed_url_v2_helper(generation=12345)
+
+    def test_generate_signed_url_v2_w_headers(self):
+        self._generate_signed_url_v2_helper(headers={"x-goog-foo": "bar"})
+
+    def test_generate_signed_url_v2_w_credentials(self):
+        credentials = object()
+        self._generate_signed_url_v2_helper(credentials=credentials)
+
+    def _generate_signed_url_v4_helper(self, **kw):
+        version = "v4"
+        self._generate_signed_url_helper(version, **kw)
+
+    def test_generate_signed_url_v4_w_defaults(self):
+        self._generate_signed_url_v2_helper()
+
+    def test_generate_signed_url_v4_w_endpoint(self):
+        self._generate_signed_url_v4_helper(
+            api_access_endpoint="https://api.example.com/v1"
+        )
+
+    def test_generate_signed_url_v4_w_method(self):
+        self._generate_signed_url_v4_helper(method="POST")
+
+    def test_generate_signed_url_v4_w_lowercase_method(self):
+        self._generate_signed_url_v4_helper(method="get")
+
+    def test_generate_signed_url_v4_w_content_md5(self):
+        self._generate_signed_url_v4_helper(content_md5="FACEDACE")
+
+    def test_generate_signed_url_v4_w_content_type(self):
+        self._generate_signed_url_v4_helper(content_type="text.html")
+
+    def test_generate_signed_url_v4_w_response_type(self):
+        self._generate_signed_url_v4_helper(response_type="text.html")
+
+    def test_generate_signed_url_v4_w_response_disposition(self):
+        self._generate_signed_url_v4_helper(response_disposition="inline")
+
+    def test_generate_signed_url_v4_w_generation(self):
+        self._generate_signed_url_v4_helper(generation=12345)
+
+    def test_generate_signed_url_v4_w_headers(self):
+        self._generate_signed_url_v4_helper(headers={"x-goog-foo": "bar"})
+
+    def test_generate_signed_url_v4_w_credentials(self):
+        credentials = object()
+        self._generate_signed_url_v4_helper(credentials=credentials)
+
+
+class _Connection(object):
+    _delete_bucket = False
+
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+        self._deleted_buckets = []
+        self.credentials = None
+
+    @staticmethod
+    def _is_bucket_path(path):
+        # Now just ensure the path only has /b/ and one more segment.
+        return path.startswith("/b/") and path.count("/") == 2
+
+    def api_request(self, **kw):
+        from google.cloud.exceptions import NotFound
+
+        self._requested.append(kw)
+
+        method = kw.get("method")
+        path = kw.get("path", "")
+        if method == "DELETE" and self._is_bucket_path(path):
+            self._deleted_buckets.append(kw)
+            if self._delete_bucket:
+                return
+            else:
+                raise NotFound("miss")
+
+        try:
+            response, self._responses = self._responses[0], self._responses[1:]
+        except IndexError:
+            raise NotFound("miss")
+        else:
+            return response
+
+
+class _Client(object):
+    def __init__(self, connection, project=None):
+        self._base_connection = connection
+        self.project = project
+
+    @property
+    def _connection(self):
+        return self._base_connection
+
+    @property
+    def _credentials(self):
+        return self._base_connection.credentials
diff --git a/storage/tests/unit/test_client.py b/storage/tests/unit/test_client.py
new file mode 100644
index 000000000000..f8f073d887f2
--- /dev/null
+++ b/storage/tests/unit/test_client.py
@@ -0,0 +1,1202 @@
+# Copyright 2015 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import json
+import unittest
+
+import mock
+import pytest
+import requests
+from six.moves import http_client
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+def _make_connection(*responses):
+    import google.cloud.storage._http
+    from google.cloud.exceptions import NotFound
+
+    mock_conn = mock.create_autospec(google.cloud.storage._http.Connection)
+    mock_conn.user_agent = "testing 1.2.3"
+    mock_conn.api_request.side_effect = list(responses) + [NotFound("miss")]
+    return mock_conn
+
+
+def _make_response(status=http_client.OK, content=b"", headers={}):
+    response = requests.Response()
+    response.status_code = status
+    response._content = content
+    response.headers = headers
+    response.request = requests.Request()
+    return response
+
+
+def _make_json_response(data, status=http_client.OK, headers=None):
+    headers = headers or {}
+    headers["Content-Type"] = "application/json"
+    return _make_response(
+        status=status, content=json.dumps(data).encode("utf-8"), headers=headers
+    )
+
+
+def _make_requests_session(responses):
+    session = mock.create_autospec(requests.Session, instance=True)
+    session.request.side_effect = responses
+    return session
+
+
+class TestClient(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_ctor_connection_type(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.storage._http import Connection
+
+        PROJECT = "PROJECT"
+        credentials = _make_credentials()
+
+        client = self._make_one(project=PROJECT, credentials=credentials)
+
+        self.assertEqual(client.project, PROJECT)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, credentials)
+        self.assertIsNone(client.current_batch)
+        self.assertEqual(list(client._batch_stack), [])
+        self.assertIsInstance(client._connection._client_info, ClientInfo)
+        self.assertEqual(
+            client._connection.API_BASE_URL, Connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_ctor_w_empty_client_options(self):
+        from google.api_core.client_options import ClientOptions
+
+        PROJECT = "PROJECT"
+        credentials = _make_credentials()
+        client_options = ClientOptions()
+
+        client = self._make_one(
+            project=PROJECT, credentials=credentials, client_options=client_options
+        )
+
+        self.assertEqual(
+            client._connection.API_BASE_URL, client._connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_ctor_w_client_options_dict(self):
+
+        PROJECT = "PROJECT"
+        credentials = _make_credentials()
+        client_options = {"api_endpoint": "https://www.foo-googleapis.com"}
+
+        client = self._make_one(
+            project=PROJECT, credentials=credentials, client_options=client_options
+        )
+
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://www.foo-googleapis.com"
+        )
+
+    def test_ctor_w_client_options_object(self):
+        from google.api_core.client_options import ClientOptions
+
+        PROJECT = "PROJECT"
+        credentials = _make_credentials()
+        client_options = ClientOptions(api_endpoint="https://www.foo-googleapis.com")
+
+        client = self._make_one(
+            project=PROJECT, credentials=credentials, client_options=client_options
+        )
+
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://www.foo-googleapis.com"
+        )
+
+    def test_ctor_wo_project(self):
+        from google.cloud.storage._http import Connection
+
+        PROJECT = "PROJECT"
+        credentials = _make_credentials()
+
+        ddp_patch = mock.patch(
+            "google.cloud.client._determine_default_project", return_value=PROJECT
+        )
+
+        with ddp_patch:
+            client = self._make_one(credentials=credentials)
+
+        self.assertEqual(client.project, PROJECT)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, credentials)
+        self.assertIsNone(client.current_batch)
+        self.assertEqual(list(client._batch_stack), [])
+
+    def test_ctor_w_project_explicit_none(self):
+        from google.cloud.storage._http import Connection
+
+        credentials = _make_credentials()
+
+        client = self._make_one(project=None, credentials=credentials)
+
+        self.assertIsNone(client.project)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, credentials)
+        self.assertIsNone(client.current_batch)
+        self.assertEqual(list(client._batch_stack), [])
+
+    def test_ctor_w_client_info(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.storage._http import Connection
+
+        credentials = _make_credentials()
+        client_info = ClientInfo()
+
+        client = self._make_one(
+            project=None, credentials=credentials, client_info=client_info
+        )
+
+        self.assertIsNone(client.project)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIs(client._connection.credentials, credentials)
+        self.assertIsNone(client.current_batch)
+        self.assertEqual(list(client._batch_stack), [])
+        self.assertIs(client._connection._client_info, client_info)
+
+    def test_create_anonymous_client(self):
+        from google.auth.credentials import AnonymousCredentials
+        from google.cloud.storage._http import Connection
+
+        klass = self._get_target_class()
+        client = klass.create_anonymous_client()
+
+        self.assertIsNone(client.project)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIsInstance(client._connection.credentials, AnonymousCredentials)
+
+    def test__push_batch_and__pop_batch(self):
+        from google.cloud.storage.batch import Batch
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        batch1 = Batch(client)
+        batch2 = Batch(client)
+        client._push_batch(batch1)
+        self.assertEqual(list(client._batch_stack), [batch1])
+        self.assertIs(client.current_batch, batch1)
+        client._push_batch(batch2)
+        self.assertIs(client.current_batch, batch2)
+        # list(_LocalStack) returns in reverse order.
+        self.assertEqual(list(client._batch_stack), [batch2, batch1])
+        self.assertIs(client._pop_batch(), batch2)
+        self.assertEqual(list(client._batch_stack), [batch1])
+        self.assertIs(client._pop_batch(), batch1)
+        self.assertEqual(list(client._batch_stack), [])
+
+    def test__connection_setter(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        client._base_connection = None  # Unset the value from the constructor
+        client._connection = connection = object()
+        self.assertIs(client._base_connection, connection)
+
+    def test__connection_setter_when_set(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        self.assertRaises(ValueError, setattr, client, "_connection", None)
+
+    def test__connection_getter_no_batch(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        self.assertIs(client._connection, client._base_connection)
+        self.assertIsNone(client.current_batch)
+
+    def test__connection_getter_with_batch(self):
+        from google.cloud.storage.batch import Batch
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        batch = Batch(client)
+        client._push_batch(batch)
+        self.assertIsNot(client._connection, client._base_connection)
+        self.assertIs(client._connection, batch)
+        self.assertIs(client.current_batch, batch)
+
+    def test_get_service_account_email_wo_project(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        EMAIL = "storage-user-123@example.com"
+        RESOURCE = {"kind": "storage#serviceAccount", "email_address": EMAIL}
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        http = _make_requests_session([_make_json_response(RESOURCE)])
+        client._http_internal = http
+
+        service_account_email = client.get_service_account_email()
+
+        self.assertEqual(service_account_email, EMAIL)
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects/%s/serviceAccount" % (PROJECT,),
+            ]
+        )
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=None, headers=mock.ANY
+        )
+
+    def test_get_service_account_email_w_project(self):
+        PROJECT = "PROJECT"
+        OTHER_PROJECT = "OTHER_PROJECT"
+        CREDENTIALS = _make_credentials()
+        EMAIL = "storage-user-123@example.com"
+        RESOURCE = {"kind": "storage#serviceAccount", "email_address": EMAIL}
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        http = _make_requests_session([_make_json_response(RESOURCE)])
+        client._http_internal = http
+
+        service_account_email = client.get_service_account_email(project=OTHER_PROJECT)
+
+        self.assertEqual(service_account_email, EMAIL)
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects/%s/serviceAccount" % (OTHER_PROJECT,),
+            ]
+        )
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=None, headers=mock.ANY
+        )
+
+    def test_bucket(self):
+        from google.cloud.storage.bucket import Bucket
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        BUCKET_NAME = "BUCKET_NAME"
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        bucket = client.bucket(BUCKET_NAME)
+        self.assertIsInstance(bucket, Bucket)
+        self.assertIs(bucket.client, client)
+        self.assertEqual(bucket.name, BUCKET_NAME)
+        self.assertIsNone(bucket.user_project)
+
+    def test_bucket_w_user_project(self):
+        from google.cloud.storage.bucket import Bucket
+
+        PROJECT = "PROJECT"
+        USER_PROJECT = "USER_PROJECT"
+        CREDENTIALS = _make_credentials()
+        BUCKET_NAME = "BUCKET_NAME"
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        bucket = client.bucket(BUCKET_NAME, user_project=USER_PROJECT)
+        self.assertIsInstance(bucket, Bucket)
+        self.assertIs(bucket.client, client)
+        self.assertEqual(bucket.name, BUCKET_NAME)
+        self.assertEqual(bucket.user_project, USER_PROJECT)
+
+    def test_batch(self):
+        from google.cloud.storage.batch import Batch
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        batch = client.batch()
+        self.assertIsInstance(batch, Batch)
+        self.assertIs(batch._client, client)
+
+    def test_get_bucket_with_string_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        NONESUCH = "nonesuch"
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+                "nonesuch?projection=noAcl",
+            ]
+        )
+        http = _make_requests_session(
+            [_make_json_response({}, status=http_client.NOT_FOUND)]
+        )
+        client._http_internal = http
+
+        with self.assertRaises(NotFound):
+            client.get_bucket(NONESUCH)
+
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_get_bucket_with_string_hit(self):
+        from google.cloud.storage.bucket import Bucket
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        BUCKET_NAME = "bucket-name"
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+                "%s?projection=noAcl" % (BUCKET_NAME,),
+            ]
+        )
+
+        data = {"name": BUCKET_NAME}
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+
+        bucket = client.get_bucket(BUCKET_NAME)
+
+        self.assertIsInstance(bucket, Bucket)
+        self.assertEqual(bucket.name, BUCKET_NAME)
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_get_bucket_with_object_miss(self):
+        from google.cloud.exceptions import NotFound
+        from google.cloud.storage.bucket import Bucket
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        nonesuch = "nonesuch"
+        bucket_obj = Bucket(client, nonesuch)
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+                "nonesuch?projection=noAcl",
+            ]
+        )
+        http = _make_requests_session(
+            [_make_json_response({}, status=http_client.NOT_FOUND)]
+        )
+        client._http_internal = http
+
+        with self.assertRaises(NotFound):
+            client.get_bucket(bucket_obj)
+
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_get_bucket_with_object_hit(self):
+        from google.cloud.storage.bucket import Bucket
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        bucket_name = "bucket-name"
+        bucket_obj = Bucket(client, bucket_name)
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+                "%s?projection=noAcl" % (bucket_name,),
+            ]
+        )
+
+        data = {"name": bucket_name}
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+
+        bucket = client.get_bucket(bucket_obj)
+
+        self.assertIsInstance(bucket, Bucket)
+        self.assertEqual(bucket.name, bucket_name)
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_lookup_bucket_miss(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        NONESUCH = "nonesuch"
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+                "nonesuch?projection=noAcl",
+            ]
+        )
+        http = _make_requests_session(
+            [_make_json_response({}, status=http_client.NOT_FOUND)]
+        )
+        client._http_internal = http
+
+        bucket = client.lookup_bucket(NONESUCH)
+
+        self.assertIsNone(bucket)
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_lookup_bucket_hit(self):
+        from google.cloud.storage.bucket import Bucket
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        BUCKET_NAME = "bucket-name"
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+                "%s?projection=noAcl" % (BUCKET_NAME,),
+            ]
+        )
+        data = {"name": BUCKET_NAME}
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+
+        bucket = client.lookup_bucket(BUCKET_NAME)
+
+        self.assertIsInstance(bucket, Bucket)
+        self.assertEqual(bucket.name, BUCKET_NAME)
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_create_bucket_with_string_conflict(self):
+        from google.cloud.exceptions import Conflict
+
+        project = "PROJECT"
+        other_project = "OTHER_PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        bucket_name = "bucket-name"
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b?project=%s" % (other_project,),
+            ]
+        )
+        data = {"error": {"message": "Conflict"}}
+        json_expected = {"name": bucket_name}
+        http = _make_requests_session(
+            [_make_json_response(data, status=http_client.CONFLICT)]
+        )
+        client._http_internal = http
+
+        with self.assertRaises(Conflict):
+            client.create_bucket(bucket_name, project=other_project)
+
+        http.request.assert_called_once_with(
+            method="POST", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+        json_sent = http.request.call_args_list[0][1]["data"]
+        self.assertEqual(json_expected, json.loads(json_sent))
+
+    def test_create_bucket_with_object_conflict(self):
+        from google.cloud.exceptions import Conflict
+        from google.cloud.storage.bucket import Bucket
+
+        project = "PROJECT"
+        other_project = "OTHER_PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        bucket_name = "bucket-name"
+        bucket_obj = Bucket(client, bucket_name)
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b?project=%s" % (other_project,),
+            ]
+        )
+        data = {"error": {"message": "Conflict"}}
+        http = _make_requests_session(
+            [_make_json_response(data, status=http_client.CONFLICT)]
+        )
+        client._http_internal = http
+
+        with self.assertRaises(Conflict):
+            client.create_bucket(bucket_obj, project=other_project)
+
+        http.request.assert_called_once_with(
+            method="POST", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+        json_expected = {"name": bucket_name}
+        json_sent = http.request.call_args_list[0][1]["data"]
+        self.assertEqual(json_expected, json.loads(json_sent))
+
+    def test_create_bucket_with_string_success(self):
+        from google.cloud.storage.bucket import Bucket
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        bucket_name = "bucket-name"
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b?project=%s" % (project,),
+            ]
+        )
+        json_expected = {"name": bucket_name, "billing": {"requesterPays": True}}
+        data = json_expected
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+
+        bucket = client.create_bucket(bucket_name, requester_pays=True)
+
+        self.assertIsInstance(bucket, Bucket)
+        self.assertEqual(bucket.name, bucket_name)
+        self.assertTrue(bucket.requester_pays)
+        http.request.assert_called_once_with(
+            method="POST", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+        json_sent = http.request.call_args_list[0][1]["data"]
+        self.assertEqual(json_expected, json.loads(json_sent))
+
+    def test_create_bucket_with_object_success(self):
+        from google.cloud.storage.bucket import Bucket
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        bucket_name = "bucket-name"
+        bucket_obj = Bucket(client, bucket_name)
+        bucket_obj.storage_class = "COLDLINE"
+        bucket_obj.requester_pays = True
+
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b?project=%s" % (project,),
+            ]
+        )
+        json_expected = {
+            "name": bucket_name,
+            "billing": {"requesterPays": True},
+            "storageClass": "COLDLINE",
+        }
+        data = json_expected
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+
+        bucket = client.create_bucket(bucket_obj)
+
+        self.assertIsInstance(bucket, Bucket)
+        self.assertEqual(bucket.name, bucket_name)
+        self.assertTrue(bucket.requester_pays)
+        http.request.assert_called_once_with(
+            method="POST", url=URI, data=mock.ANY, headers=mock.ANY
+        )
+        json_sent = http.request.call_args_list[0][1]["data"]
+        self.assertEqual(json_expected, json.loads(json_sent))
+
+    def test_download_blob_to_file_with_blob(self):
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+        blob = mock.Mock()
+        file_obj = io.BytesIO()
+
+        client.download_blob_to_file(blob, file_obj)
+        blob.download_to_file.assert_called_once_with(
+            file_obj, client=client, start=None, end=None
+        )
+
+    def test_download_blob_to_file_with_uri(self):
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+        blob = mock.Mock()
+        file_obj = io.BytesIO()
+
+        with mock.patch(
+            "google.cloud.storage.client.Blob.from_string", return_value=blob
+        ):
+            client.download_blob_to_file("gs://bucket_name/path/to/object", file_obj)
+
+        blob.download_to_file.assert_called_once_with(
+            file_obj, client=client, start=None, end=None
+        )
+
+    def test_download_blob_to_file_with_invalid_uri(self):
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+        file_obj = io.BytesIO()
+
+        with pytest.raises(ValueError, match="URI scheme must be gs"):
+            client.download_blob_to_file("http://bucket_name/path/to/object", file_obj)
+
+    def test_list_blobs(self):
+        from google.cloud.storage.bucket import Bucket
+
+        BUCKET_NAME = "bucket-name"
+
+        credentials = _make_credentials()
+        client = self._make_one(project="PROJECT", credentials=credentials)
+        connection = _make_connection({"items": []})
+
+        with mock.patch(
+            "google.cloud.storage.client.Client._connection",
+            new_callable=mock.PropertyMock,
+        ) as client_mock:
+            client_mock.return_value = connection
+
+            bucket_obj = Bucket(client, BUCKET_NAME)
+            iterator = client.list_blobs(bucket_obj)
+            blobs = list(iterator)
+
+            self.assertEqual(blobs, [])
+            connection.api_request.assert_called_once_with(
+                method="GET",
+                path="/b/%s/o" % BUCKET_NAME,
+                query_params={"projection": "noAcl"},
+            )
+
+    def test_list_blobs_w_all_arguments_and_user_project(self):
+        from google.cloud.storage.bucket import Bucket
+
+        BUCKET_NAME = "name"
+        USER_PROJECT = "user-project-123"
+        MAX_RESULTS = 10
+        PAGE_TOKEN = "ABCD"
+        PREFIX = "subfolder"
+        DELIMITER = "/"
+        VERSIONS = True
+        PROJECTION = "full"
+        FIELDS = "items/contentLanguage,nextPageToken"
+        EXPECTED = {
+            "maxResults": 10,
+            "pageToken": PAGE_TOKEN,
+            "prefix": PREFIX,
+            "delimiter": DELIMITER,
+            "versions": VERSIONS,
+            "projection": PROJECTION,
+            "fields": FIELDS,
+            "userProject": USER_PROJECT,
+        }
+
+        credentials = _make_credentials()
+        client = self._make_one(project=USER_PROJECT, credentials=credentials)
+        connection = _make_connection({"items": []})
+
+        with mock.patch(
+            "google.cloud.storage.client.Client._connection",
+            new_callable=mock.PropertyMock,
+        ) as client_mock:
+            client_mock.return_value = connection
+
+            bucket = Bucket(client, BUCKET_NAME, user_project=USER_PROJECT)
+            iterator = client.list_blobs(
+                bucket_or_name=bucket,
+                max_results=MAX_RESULTS,
+                page_token=PAGE_TOKEN,
+                prefix=PREFIX,
+                delimiter=DELIMITER,
+                versions=VERSIONS,
+                projection=PROJECTION,
+                fields=FIELDS,
+            )
+            blobs = list(iterator)
+
+            self.assertEqual(blobs, [])
+            connection.api_request.assert_called_once_with(
+                method="GET", path="/b/%s/o" % BUCKET_NAME, query_params=EXPECTED
+            )
+
+    def test_list_buckets_wo_project(self):
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=None, credentials=CREDENTIALS)
+
+        with self.assertRaises(ValueError):
+            client.list_buckets()
+
+    def test_list_buckets_empty(self):
+        from six.moves.urllib.parse import parse_qs
+        from six.moves.urllib.parse import urlparse
+
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        http = _make_requests_session([_make_json_response({})])
+        client._http_internal = http
+
+        buckets = list(client.list_buckets())
+
+        self.assertEqual(len(buckets), 0)
+
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, data=mock.ANY, headers=mock.ANY
+        )
+
+        requested_url = http.request.mock_calls[0][2]["url"]
+        expected_base_url = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+            ]
+        )
+        self.assertTrue(requested_url.startswith(expected_base_url))
+
+        expected_query = {"project": [PROJECT], "projection": ["noAcl"]}
+        uri_parts = urlparse(requested_url)
+        self.assertEqual(parse_qs(uri_parts.query), expected_query)
+
+    def test_list_buckets_explicit_project(self):
+        from six.moves.urllib.parse import parse_qs
+        from six.moves.urllib.parse import urlparse
+
+        PROJECT = "PROJECT"
+        OTHER_PROJECT = "OTHER_PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        http = _make_requests_session([_make_json_response({})])
+        client._http_internal = http
+
+        buckets = list(client.list_buckets(project=OTHER_PROJECT))
+
+        self.assertEqual(len(buckets), 0)
+
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, data=mock.ANY, headers=mock.ANY
+        )
+
+        requested_url = http.request.mock_calls[0][2]["url"]
+        expected_base_url = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+            ]
+        )
+        self.assertTrue(requested_url.startswith(expected_base_url))
+
+        expected_query = {"project": [OTHER_PROJECT], "projection": ["noAcl"]}
+        uri_parts = urlparse(requested_url)
+        self.assertEqual(parse_qs(uri_parts.query), expected_query)
+
+    def test_list_buckets_non_empty(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        BUCKET_NAME = "bucket-name"
+
+        data = {"items": [{"name": BUCKET_NAME}]}
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+
+        buckets = list(client.list_buckets())
+
+        self.assertEqual(len(buckets), 1)
+        self.assertEqual(buckets[0].name, BUCKET_NAME)
+
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, data=mock.ANY, headers=mock.ANY
+        )
+
+    def test_list_buckets_all_arguments(self):
+        from six.moves.urllib.parse import parse_qs
+        from six.moves.urllib.parse import urlparse
+
+        PROJECT = "foo-bar"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        MAX_RESULTS = 10
+        PAGE_TOKEN = "ABCD"
+        PREFIX = "subfolder"
+        PROJECTION = "full"
+        FIELDS = "items/id,nextPageToken"
+
+        data = {"items": []}
+        http = _make_requests_session([_make_json_response(data)])
+        client._http_internal = http
+        iterator = client.list_buckets(
+            max_results=MAX_RESULTS,
+            page_token=PAGE_TOKEN,
+            prefix=PREFIX,
+            projection=PROJECTION,
+            fields=FIELDS,
+        )
+        buckets = list(iterator)
+        self.assertEqual(buckets, [])
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, data=mock.ANY, headers=mock.ANY
+        )
+
+        requested_url = http.request.mock_calls[0][2]["url"]
+        expected_base_url = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "b",
+            ]
+        )
+        self.assertTrue(requested_url.startswith(expected_base_url))
+
+        expected_query = {
+            "project": [PROJECT],
+            "maxResults": [str(MAX_RESULTS)],
+            "pageToken": [PAGE_TOKEN],
+            "prefix": [PREFIX],
+            "projection": [PROJECTION],
+            "fields": [FIELDS],
+        }
+        uri_parts = urlparse(requested_url)
+        self.assertEqual(parse_qs(uri_parts.query), expected_query)
+
+    def test_list_buckets_page_empty_response(self):
+        from google.api_core import page_iterator
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+        iterator = client.list_buckets()
+        page = page_iterator.Page(iterator, (), None)
+        iterator._page = page
+        self.assertEqual(list(page), [])
+
+    def test_list_buckets_page_non_empty_response(self):
+        import six
+        from google.cloud.storage.bucket import Bucket
+
+        project = "PROJECT"
+        credentials = _make_credentials()
+        client = self._make_one(project=project, credentials=credentials)
+
+        blob_name = "bucket-name"
+        response = {"items": [{"name": blob_name}]}
+
+        def dummy_response():
+            return response
+
+        iterator = client.list_buckets()
+        iterator._get_next_page_response = dummy_response
+
+        page = six.next(iterator.pages)
+        self.assertEqual(page.num_items, 1)
+        bucket = six.next(page)
+        self.assertEqual(page.remaining, 0)
+        self.assertIsInstance(bucket, Bucket)
+        self.assertEqual(bucket.name, blob_name)
+
+    def _create_hmac_key_helper(self, explicit_project=None):
+        import datetime
+        from pytz import UTC
+        from six.moves.urllib.parse import urlencode
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        PROJECT = "PROJECT"
+        ACCESS_ID = "ACCESS-ID"
+        CREDENTIALS = _make_credentials()
+        EMAIL = "storage-user-123@example.com"
+        SECRET = "a" * 40
+        now = datetime.datetime.utcnow().replace(tzinfo=UTC)
+        now_stamp = "{}Z".format(now.isoformat())
+
+        if explicit_project is not None:
+            expected_project = explicit_project
+        else:
+            expected_project = PROJECT
+
+        RESOURCE = {
+            "kind": "storage#hmacKey",
+            "metadata": {
+                "accessId": ACCESS_ID,
+                "etag": "ETAG",
+                "id": "projects/{}/hmacKeys/{}".format(PROJECT, ACCESS_ID),
+                "project": expected_project,
+                "state": "ACTIVE",
+                "serviceAccountEmail": EMAIL,
+                "timeCreated": now_stamp,
+                "updated": now_stamp,
+            },
+            "secret": SECRET,
+        }
+
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+        http = _make_requests_session([_make_json_response(RESOURCE)])
+        client._http_internal = http
+
+        kwargs = {}
+        if explicit_project is not None:
+            kwargs["project_id"] = explicit_project
+
+        metadata, secret = client.create_hmac_key(service_account_email=EMAIL, **kwargs)
+
+        self.assertIsInstance(metadata, HMACKeyMetadata)
+        self.assertIs(metadata._client, client)
+        self.assertEqual(metadata._properties, RESOURCE["metadata"])
+        self.assertEqual(secret, RESOURCE["secret"])
+
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects",
+                expected_project,
+                "hmacKeys",
+            ]
+        )
+        QS_PARAMS = {"serviceAccountEmail": EMAIL}
+        FULL_URI = "{}?{}".format(URI, urlencode(QS_PARAMS))
+        http.request.assert_called_once_with(
+            method="POST", url=FULL_URI, data=None, headers=mock.ANY
+        )
+
+    def test_create_hmac_key_defaults(self):
+        self._create_hmac_key_helper()
+
+    def test_create_hmac_key_explicit_project(self):
+        self._create_hmac_key_helper(explicit_project="other-project-456")
+
+    def test_list_hmac_keys_defaults_empty(self):
+        PROJECT = "PROJECT"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        http = _make_requests_session([_make_json_response({})])
+        client._http_internal = http
+
+        metadatas = list(client.list_hmac_keys())
+
+        self.assertEqual(len(metadatas), 0)
+
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects",
+                PROJECT,
+                "hmacKeys",
+            ]
+        )
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=None, headers=mock.ANY
+        )
+
+    def test_list_hmac_keys_explicit_non_empty(self):
+        from six.moves.urllib.parse import parse_qsl
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        PROJECT = "PROJECT"
+        OTHER_PROJECT = "other-project-456"
+        MAX_RESULTS = 3
+        EMAIL = "storage-user-123@example.com"
+        ACCESS_ID = "ACCESS-ID"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        response = {
+            "kind": "storage#hmacKeysMetadata",
+            "items": [
+                {
+                    "kind": "storage#hmacKeyMetadata",
+                    "accessId": ACCESS_ID,
+                    "serviceAccountEmail": EMAIL,
+                }
+            ],
+        }
+
+        http = _make_requests_session([_make_json_response(response)])
+        client._http_internal = http
+
+        metadatas = list(
+            client.list_hmac_keys(
+                max_results=MAX_RESULTS,
+                service_account_email=EMAIL,
+                show_deleted_keys=True,
+                project_id=OTHER_PROJECT,
+            )
+        )
+
+        self.assertEqual(len(metadatas), len(response["items"]))
+
+        for metadata, resource in zip(metadatas, response["items"]):
+            self.assertIsInstance(metadata, HMACKeyMetadata)
+            self.assertIs(metadata._client, client)
+            self.assertEqual(metadata._properties, resource)
+
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects",
+                OTHER_PROJECT,
+                "hmacKeys",
+            ]
+        )
+        EXPECTED_QPARAMS = {
+            "maxResults": str(MAX_RESULTS),
+            "serviceAccountEmail": EMAIL,
+            "showDeletedKeys": "True",
+        }
+        http.request.assert_called_once_with(
+            method="GET", url=mock.ANY, data=None, headers=mock.ANY
+        )
+        kwargs = http.request.mock_calls[0].kwargs
+        uri = kwargs["url"]
+        base, qparam_str = uri.split("?")
+        qparams = dict(parse_qsl(qparam_str))
+        self.assertEqual(base, URI)
+        self.assertEqual(qparams, EXPECTED_QPARAMS)
+
+    def test_get_hmac_key_metadata_wo_project(self):
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        PROJECT = "PROJECT"
+        EMAIL = "storage-user-123@example.com"
+        ACCESS_ID = "ACCESS-ID"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        resource = {
+            "kind": "storage#hmacKeyMetadata",
+            "accessId": ACCESS_ID,
+            "projectId": PROJECT,
+            "serviceAccountEmail": EMAIL,
+        }
+
+        http = _make_requests_session([_make_json_response(resource)])
+        client._http_internal = http
+
+        metadata = client.get_hmac_key_metadata(ACCESS_ID)
+
+        self.assertIsInstance(metadata, HMACKeyMetadata)
+        self.assertIs(metadata._client, client)
+        self.assertEqual(metadata.access_id, ACCESS_ID)
+        self.assertEqual(metadata.project, PROJECT)
+
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects",
+                PROJECT,
+                "hmacKeys",
+                ACCESS_ID,
+            ]
+        )
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=None, headers=mock.ANY
+        )
+
+    def test_get_hmac_key_metadata_w_project(self):
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        PROJECT = "PROJECT"
+        OTHER_PROJECT = "other-project-456"
+        EMAIL = "storage-user-123@example.com"
+        ACCESS_ID = "ACCESS-ID"
+        CREDENTIALS = _make_credentials()
+        client = self._make_one(project=PROJECT, credentials=CREDENTIALS)
+
+        resource = {
+            "kind": "storage#hmacKeyMetadata",
+            "accessId": ACCESS_ID,
+            "projectId": OTHER_PROJECT,
+            "serviceAccountEmail": EMAIL,
+        }
+
+        http = _make_requests_session([_make_json_response(resource)])
+        client._http_internal = http
+
+        metadata = client.get_hmac_key_metadata(ACCESS_ID, project_id=OTHER_PROJECT)
+
+        self.assertIsInstance(metadata, HMACKeyMetadata)
+        self.assertIs(metadata._client, client)
+        self.assertEqual(metadata.access_id, ACCESS_ID)
+        self.assertEqual(metadata.project, OTHER_PROJECT)
+
+        URI = "/".join(
+            [
+                client._connection.API_BASE_URL,
+                "storage",
+                client._connection.API_VERSION,
+                "projects",
+                OTHER_PROJECT,
+                "hmacKeys",
+                ACCESS_ID,
+            ]
+        )
+        http.request.assert_called_once_with(
+            method="GET", url=URI, data=None, headers=mock.ANY
+        )
diff --git a/storage/tests/unit/test_hmac_key.py b/storage/tests/unit/test_hmac_key.py
new file mode 100644
index 000000000000..399a82682a64
--- /dev/null
+++ b/storage/tests/unit/test_hmac_key.py
@@ -0,0 +1,401 @@
+# 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.
+
+import unittest
+
+import mock
+
+
+class TestHMACKeyMetadata(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.hmac_key import HMACKeyMetadata
+
+        return HMACKeyMetadata
+
+    def _make_one(self, client=None, *args, **kw):
+        if client is None:
+            client = _Client()
+        return self._get_target_class()(client, *args, **kw)
+
+    def test_ctor_defaults(self):
+        client = object()
+        metadata = self._make_one(client)
+        self.assertIs(metadata._client, client)
+        self.assertEqual(metadata._properties, {})
+        self.assertIsNone(metadata.access_id)
+        self.assertIsNone(metadata.etag)
+        self.assertIsNone(metadata.id)
+        self.assertIsNone(metadata.project)
+        self.assertIsNone(metadata.service_account_email)
+        self.assertIsNone(metadata.state)
+        self.assertIsNone(metadata.time_created)
+        self.assertIsNone(metadata.updated)
+
+    def test_ctor_explicit(self):
+        OTHER_PROJECT = "other-project-456"
+        ACCESS_ID = "access-id-123456789"
+        client = _Client()
+        metadata = self._make_one(client, access_id=ACCESS_ID, project_id=OTHER_PROJECT)
+        self.assertIs(metadata._client, client)
+        expected = {"accessId": ACCESS_ID, "projectId": OTHER_PROJECT}
+        self.assertEqual(metadata._properties, expected)
+        self.assertEqual(metadata.access_id, ACCESS_ID)
+        self.assertIsNone(metadata.etag)
+        self.assertIsNone(metadata.id)
+        self.assertEqual(metadata.project, OTHER_PROJECT)
+        self.assertIsNone(metadata.service_account_email)
+        self.assertIsNone(metadata.state)
+        self.assertIsNone(metadata.time_created)
+        self.assertIsNone(metadata.updated)
+
+    def test___eq___other_type(self):
+        metadata = self._make_one()
+        for bogus in (None, "bogus", 123, 456.78, [], (), {}, set()):
+            self.assertNotEqual(metadata, bogus)
+
+    def test___eq___mismatched_client(self):
+        metadata = self._make_one()
+        other_client = _Client(project="other-project-456")
+        other = self._make_one(other_client)
+        self.assertNotEqual(metadata, other)
+
+    def test___eq___mismatched_access_id(self):
+        metadata = self._make_one()
+        metadata._properties["accessId"] = "ABC123"
+        other = self._make_one(metadata._client)
+        metadata._properties["accessId"] = "DEF456"
+        self.assertNotEqual(metadata, other)
+
+    def test___eq___hit(self):
+        metadata = self._make_one()
+        metadata._properties["accessId"] = "ABC123"
+        other = self._make_one(metadata._client)
+        other._properties["accessId"] = metadata.access_id
+        self.assertEqual(metadata, other)
+
+    def test___hash__(self):
+        client = _Client()
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = "ABC123"
+        self.assertIsInstance(hash(metadata), int)
+        other = self._make_one(client)
+        metadata._properties["accessId"] = "DEF456"
+        self.assertNotEqual(hash(metadata), hash(other))
+
+    def test_access_id_getter(self):
+        metadata = self._make_one()
+        expected = "ACCESS-ID"
+        metadata._properties["accessId"] = expected
+        self.assertEqual(metadata.access_id, expected)
+
+    def test_etag_getter(self):
+        metadata = self._make_one()
+        expected = "ETAG"
+        metadata._properties["etag"] = expected
+        self.assertEqual(metadata.etag, expected)
+
+    def test_id_getter(self):
+        metadata = self._make_one()
+        expected = "ID"
+        metadata._properties["id"] = expected
+        self.assertEqual(metadata.id, expected)
+
+    def test_project_getter(self):
+        metadata = self._make_one()
+        expected = "PROJECT-ID"
+        metadata._properties["projectId"] = expected
+        self.assertEqual(metadata.project, expected)
+
+    def test_service_account_email_getter(self):
+        metadata = self._make_one()
+        expected = "service_account@example.com"
+        metadata._properties["serviceAccountEmail"] = expected
+        self.assertEqual(metadata.service_account_email, expected)
+
+    def test_state_getter(self):
+        metadata = self._make_one()
+        expected = "STATE"
+        metadata._properties["state"] = expected
+        self.assertEqual(metadata.state, expected)
+
+    def test_state_setter_invalid_state(self):
+        metadata = self._make_one()
+        expected = "INVALID"
+
+        with self.assertRaises(ValueError):
+            metadata.state = expected
+
+        self.assertIsNone(metadata.state)
+
+    def test_state_setter_inactive(self):
+        metadata = self._make_one()
+        metadata._properties["state"] = "ACTIVE"
+        expected = "INACTIVE"
+        metadata.state = expected
+        self.assertEqual(metadata.state, expected)
+        self.assertEqual(metadata._properties["state"], expected)
+
+    def test_state_setter_active(self):
+        metadata = self._make_one()
+        metadata._properties["state"] = "INACTIVE"
+        expected = "ACTIVE"
+        metadata.state = expected
+        self.assertEqual(metadata.state, expected)
+        self.assertEqual(metadata._properties["state"], expected)
+
+    def test_time_created_getter(self):
+        import datetime
+        from pytz import UTC
+
+        metadata = self._make_one()
+        now = datetime.datetime.utcnow()
+        now_stamp = "{}Z".format(now.isoformat())
+        metadata._properties["timeCreated"] = now_stamp
+        self.assertEqual(metadata.time_created, now.replace(tzinfo=UTC))
+
+    def test_updated_getter(self):
+        import datetime
+        from pytz import UTC
+
+        metadata = self._make_one()
+        now = datetime.datetime.utcnow()
+        now_stamp = "{}Z".format(now.isoformat())
+        metadata._properties["updated"] = now_stamp
+        self.assertEqual(metadata.updated, now.replace(tzinfo=UTC))
+
+    def test_path_wo_access_id(self):
+        metadata = self._make_one()
+
+        with self.assertRaises(ValueError):
+            metadata.path
+
+    def test_path_w_access_id_wo_project(self):
+        access_id = "ACCESS-ID"
+        client = _Client()
+        metadata = self._make_one()
+        metadata._properties["accessId"] = access_id
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(
+            client.DEFAULT_PROJECT, access_id
+        )
+        self.assertEqual(metadata.path, expected_path)
+
+    def test_path_w_access_id_w_explicit_project(self):
+        access_id = "ACCESS-ID"
+        project = "OTHER-PROJECT"
+        metadata = self._make_one()
+        metadata._properties["accessId"] = access_id
+        metadata._properties["projectId"] = project
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(project, access_id)
+        self.assertEqual(metadata.path, expected_path)
+
+    def test_exists_miss_no_project_set(self):
+        from google.cloud.exceptions import NotFound
+
+        access_id = "ACCESS-ID"
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.side_effect = NotFound("testing")
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+
+        self.assertFalse(metadata.exists())
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(
+            client.DEFAULT_PROJECT, access_id
+        )
+        expected_kwargs = {"method": "GET", "path": expected_path}
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_exists_hit_w_project_set(self):
+        project = "PROJECT-ID"
+        access_id = "ACCESS-ID"
+        email = "service-account@example.com"
+        resource = {
+            "kind": "storage#hmacKeyMetadata",
+            "accessId": access_id,
+            "serviceAccountEmail": email,
+        }
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.return_value = resource
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+        metadata._properties["projectId"] = project
+
+        self.assertTrue(metadata.exists())
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(project, access_id)
+        expected_kwargs = {"method": "GET", "path": expected_path}
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_reload_miss_no_project_set(self):
+        from google.cloud.exceptions import NotFound
+
+        access_id = "ACCESS-ID"
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.side_effect = NotFound("testing")
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+
+        with self.assertRaises(NotFound):
+            metadata.reload()
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(
+            client.DEFAULT_PROJECT, access_id
+        )
+        expected_kwargs = {"method": "GET", "path": expected_path}
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_reload_hit_w_project_set(self):
+        project = "PROJECT-ID"
+        access_id = "ACCESS-ID"
+        email = "service-account@example.com"
+        resource = {
+            "kind": "storage#hmacKeyMetadata",
+            "accessId": access_id,
+            "serviceAccountEmail": email,
+        }
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.return_value = resource
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+        metadata._properties["projectId"] = project
+
+        metadata.reload()
+
+        self.assertEqual(metadata._properties, resource)
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(project, access_id)
+        expected_kwargs = {"method": "GET", "path": expected_path}
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_update_miss_no_project_set(self):
+        from google.cloud.exceptions import NotFound
+
+        access_id = "ACCESS-ID"
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.side_effect = NotFound("testing")
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+        metadata.state = "INACTIVE"
+
+        with self.assertRaises(NotFound):
+            metadata.update()
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(
+            client.DEFAULT_PROJECT, access_id
+        )
+        expected_kwargs = {
+            "method": "PUT",
+            "path": expected_path,
+            "data": {"state": "INACTIVE"},
+        }
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_update_hit_w_project_set(self):
+        project = "PROJECT-ID"
+        access_id = "ACCESS-ID"
+        email = "service-account@example.com"
+        resource = {
+            "kind": "storage#hmacKeyMetadata",
+            "accessId": access_id,
+            "serviceAccountEmail": email,
+            "state": "ACTIVE",
+        }
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.return_value = resource
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+        metadata._properties["projectId"] = project
+        metadata.state = "ACTIVE"
+
+        metadata.update()
+
+        self.assertEqual(metadata._properties, resource)
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(project, access_id)
+        expected_kwargs = {
+            "method": "PUT",
+            "path": expected_path,
+            "data": {"state": "ACTIVE"},
+        }
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_delete_not_inactive(self):
+        metadata = self._make_one()
+        for state in ("ACTIVE", "DELETED"):
+            metadata._properties["state"] = state
+
+            with self.assertRaises(ValueError):
+                metadata.delete()
+
+    def test_delete_miss_no_project_set(self):
+        from google.cloud.exceptions import NotFound
+
+        access_id = "ACCESS-ID"
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.side_effect = NotFound("testing")
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+        metadata.state = "INACTIVE"
+
+        with self.assertRaises(NotFound):
+            metadata.delete()
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(
+            client.DEFAULT_PROJECT, access_id
+        )
+        expected_kwargs = {"method": "DELETE", "path": expected_path}
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+    def test_delete_hit_w_project_set(self):
+        project = "PROJECT-ID"
+        access_id = "ACCESS-ID"
+        connection = mock.Mock(spec=["api_request"])
+        connection.api_request.return_value = {}
+        client = _Client(connection)
+        metadata = self._make_one(client)
+        metadata._properties["accessId"] = access_id
+        metadata._properties["projectId"] = project
+        metadata.state = "INACTIVE"
+
+        metadata.delete()
+
+        expected_path = "/projects/{}/hmacKeys/{}".format(project, access_id)
+        expected_kwargs = {"method": "DELETE", "path": expected_path}
+        connection.api_request.assert_called_once_with(**expected_kwargs)
+
+
+class _Client(object):
+    DEFAULT_PROJECT = "project-123"
+
+    def __init__(self, connection=None, project=DEFAULT_PROJECT):
+        self._connection = connection
+        self.project = project
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):  # pragma: NO COVER
+            return NotImplemented
+        return self._connection == other._connection and self.project == other.project
+
+    def __hash__(self):
+        return hash(self._connection) + hash(self.project)
diff --git a/storage/tests/unit/test_notification.py b/storage/tests/unit/test_notification.py
new file mode 100644
index 000000000000..29b376b57496
--- /dev/null
+++ b/storage/tests/unit/test_notification.py
@@ -0,0 +1,520 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestBucketNotification(unittest.TestCase):
+
+    BUCKET_NAME = "test-bucket"
+    BUCKET_PROJECT = "bucket-project-123"
+    TOPIC_NAME = "test-topic"
+    TOPIC_ALT_PROJECT = "topic-project-456"
+    TOPIC_REF_FMT = "//pubsub.googleapis.com/projects/{}/topics/{}"
+    TOPIC_REF = TOPIC_REF_FMT.format(BUCKET_PROJECT, TOPIC_NAME)
+    TOPIC_ALT_REF = TOPIC_REF_FMT.format(TOPIC_ALT_PROJECT, TOPIC_NAME)
+    CUSTOM_ATTRIBUTES = {"attr1": "value1", "attr2": "value2"}
+    BLOB_NAME_PREFIX = "blob-name-prefix/"
+    NOTIFICATION_ID = "123"
+    SELF_LINK = "https://example.com/notification/123"
+    ETAG = "DEADBEEF"
+    CREATE_PATH = "/b/{}/notificationConfigs".format(BUCKET_NAME)
+    NOTIFICATION_PATH = "/b/{}/notificationConfigs/{}".format(
+        BUCKET_NAME, NOTIFICATION_ID
+    )
+
+    @staticmethod
+    def event_types():
+        from google.cloud.storage.notification import (
+            OBJECT_FINALIZE_EVENT_TYPE,
+            OBJECT_DELETE_EVENT_TYPE,
+        )
+
+        return [OBJECT_FINALIZE_EVENT_TYPE, OBJECT_DELETE_EVENT_TYPE]
+
+    @staticmethod
+    def payload_format():
+        from google.cloud.storage.notification import JSON_API_V1_PAYLOAD_FORMAT
+
+        return JSON_API_V1_PAYLOAD_FORMAT
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.storage.notification import BucketNotification
+
+        return BucketNotification
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def _make_client(self, project=BUCKET_PROJECT):
+        from google.cloud.storage.client import Client
+
+        return mock.Mock(project=project, spec=Client)
+
+    def _make_bucket(self, client, name=BUCKET_NAME, user_project=None):
+        bucket = mock.Mock(spec=["client", "name", "user_project"])
+        bucket.client = client
+        bucket.name = name
+        bucket.user_project = user_project
+        return bucket
+
+    def test_ctor_w_missing_project(self):
+        client = self._make_client(project=None)
+        bucket = self._make_bucket(client)
+
+        with self.assertRaises(ValueError):
+            self._make_one(bucket, self.TOPIC_NAME)
+
+    def test_ctor_defaults(self):
+        from google.cloud.storage.notification import NONE_PAYLOAD_FORMAT
+
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        self.assertIs(notification.bucket, bucket)
+        self.assertEqual(notification.topic_name, self.TOPIC_NAME)
+        self.assertEqual(notification.topic_project, self.BUCKET_PROJECT)
+        self.assertIsNone(notification.custom_attributes)
+        self.assertIsNone(notification.event_types)
+        self.assertIsNone(notification.blob_name_prefix)
+        self.assertEqual(notification.payload_format, NONE_PAYLOAD_FORMAT)
+
+    def test_ctor_explicit(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+
+        notification = self._make_one(
+            bucket,
+            self.TOPIC_NAME,
+            topic_project=self.TOPIC_ALT_PROJECT,
+            custom_attributes=self.CUSTOM_ATTRIBUTES,
+            event_types=self.event_types(),
+            blob_name_prefix=self.BLOB_NAME_PREFIX,
+            payload_format=self.payload_format(),
+        )
+
+        self.assertIs(notification.bucket, bucket)
+        self.assertEqual(notification.topic_name, self.TOPIC_NAME)
+        self.assertEqual(notification.topic_project, self.TOPIC_ALT_PROJECT)
+        self.assertEqual(notification.custom_attributes, self.CUSTOM_ATTRIBUTES)
+        self.assertEqual(notification.event_types, self.event_types())
+        self.assertEqual(notification.blob_name_prefix, self.BLOB_NAME_PREFIX)
+        self.assertEqual(notification.payload_format, self.payload_format())
+
+    def test_from_api_repr_no_topic(self):
+        klass = self._get_target_class()
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        resource = {}
+
+        with self.assertRaises(ValueError):
+            klass.from_api_repr(resource, bucket=bucket)
+
+    def test_from_api_repr_invalid_topic(self):
+        klass = self._get_target_class()
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        resource = {"topic": "@#$%"}
+
+        with self.assertRaises(ValueError):
+            klass.from_api_repr(resource, bucket=bucket)
+
+    def test_from_api_repr_minimal(self):
+        from google.cloud.storage.notification import NONE_PAYLOAD_FORMAT
+
+        klass = self._get_target_class()
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        resource = {
+            "topic": self.TOPIC_REF,
+            "id": self.NOTIFICATION_ID,
+            "etag": self.ETAG,
+            "selfLink": self.SELF_LINK,
+            "payload_format": NONE_PAYLOAD_FORMAT,
+        }
+
+        notification = klass.from_api_repr(resource, bucket=bucket)
+
+        self.assertIs(notification.bucket, bucket)
+        self.assertEqual(notification.topic_name, self.TOPIC_NAME)
+        self.assertEqual(notification.topic_project, self.BUCKET_PROJECT)
+        self.assertIsNone(notification.custom_attributes)
+        self.assertIsNone(notification.event_types)
+        self.assertIsNone(notification.blob_name_prefix)
+        self.assertEqual(notification.payload_format, NONE_PAYLOAD_FORMAT)
+        self.assertEqual(notification.etag, self.ETAG)
+        self.assertEqual(notification.self_link, self.SELF_LINK)
+
+    def test_from_api_repr_explicit(self):
+        klass = self._get_target_class()
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        resource = {
+            "topic": self.TOPIC_ALT_REF,
+            "custom_attributes": self.CUSTOM_ATTRIBUTES,
+            "event_types": self.event_types(),
+            "object_name_prefix": self.BLOB_NAME_PREFIX,
+            "payload_format": self.payload_format(),
+            "id": self.NOTIFICATION_ID,
+            "etag": self.ETAG,
+            "selfLink": self.SELF_LINK,
+        }
+
+        notification = klass.from_api_repr(resource, bucket=bucket)
+
+        self.assertIs(notification.bucket, bucket)
+        self.assertEqual(notification.topic_name, self.TOPIC_NAME)
+        self.assertEqual(notification.topic_project, self.TOPIC_ALT_PROJECT)
+        self.assertEqual(notification.custom_attributes, self.CUSTOM_ATTRIBUTES)
+        self.assertEqual(notification.event_types, self.event_types())
+        self.assertEqual(notification.blob_name_prefix, self.BLOB_NAME_PREFIX)
+        self.assertEqual(notification.payload_format, self.payload_format())
+        self.assertEqual(notification.notification_id, self.NOTIFICATION_ID)
+        self.assertEqual(notification.etag, self.ETAG)
+        self.assertEqual(notification.self_link, self.SELF_LINK)
+
+    def test_notification_id(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        self.assertIsNone(notification.notification_id)
+
+        notification._properties["id"] = self.NOTIFICATION_ID
+        self.assertEqual(notification.notification_id, self.NOTIFICATION_ID)
+
+    def test_etag(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        self.assertIsNone(notification.etag)
+
+        notification._properties["etag"] = self.ETAG
+        self.assertEqual(notification.etag, self.ETAG)
+
+    def test_self_link(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        self.assertIsNone(notification.self_link)
+
+        notification._properties["selfLink"] = self.SELF_LINK
+        self.assertEqual(notification.self_link, self.SELF_LINK)
+
+    def test_create_w_existing_notification_id(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+
+        with self.assertRaises(ValueError):
+            notification.create()
+
+    def test_create_w_defaults(self):
+        from google.cloud.storage.notification import NONE_PAYLOAD_FORMAT
+
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        api_request = client._connection.api_request
+        api_request.return_value = {
+            "topic": self.TOPIC_REF,
+            "id": self.NOTIFICATION_ID,
+            "etag": self.ETAG,
+            "selfLink": self.SELF_LINK,
+            "payload_format": NONE_PAYLOAD_FORMAT,
+        }
+
+        notification.create()
+
+        self.assertEqual(notification.notification_id, self.NOTIFICATION_ID)
+        self.assertEqual(notification.etag, self.ETAG)
+        self.assertEqual(notification.self_link, self.SELF_LINK)
+        self.assertIsNone(notification.custom_attributes)
+        self.assertIsNone(notification.event_types)
+        self.assertIsNone(notification.blob_name_prefix)
+        self.assertEqual(notification.payload_format, NONE_PAYLOAD_FORMAT)
+
+        data = {"topic": self.TOPIC_REF, "payload_format": NONE_PAYLOAD_FORMAT}
+        api_request.assert_called_once_with(
+            method="POST", path=self.CREATE_PATH, query_params={}, data=data
+        )
+
+    def test_create_w_explicit_client(self):
+        USER_PROJECT = "user-project-123"
+        client = self._make_client()
+        alt_client = self._make_client()
+        bucket = self._make_bucket(client, user_project=USER_PROJECT)
+        notification = self._make_one(
+            bucket,
+            self.TOPIC_NAME,
+            topic_project=self.TOPIC_ALT_PROJECT,
+            custom_attributes=self.CUSTOM_ATTRIBUTES,
+            event_types=self.event_types(),
+            blob_name_prefix=self.BLOB_NAME_PREFIX,
+            payload_format=self.payload_format(),
+        )
+        api_request = alt_client._connection.api_request
+        api_request.return_value = {
+            "topic": self.TOPIC_ALT_REF,
+            "custom_attributes": self.CUSTOM_ATTRIBUTES,
+            "event_types": self.event_types(),
+            "object_name_prefix": self.BLOB_NAME_PREFIX,
+            "payload_format": self.payload_format(),
+            "id": self.NOTIFICATION_ID,
+            "etag": self.ETAG,
+            "selfLink": self.SELF_LINK,
+        }
+
+        notification.create(client=alt_client)
+
+        self.assertEqual(notification.custom_attributes, self.CUSTOM_ATTRIBUTES)
+        self.assertEqual(notification.event_types, self.event_types())
+        self.assertEqual(notification.blob_name_prefix, self.BLOB_NAME_PREFIX)
+        self.assertEqual(notification.payload_format, self.payload_format())
+        self.assertEqual(notification.notification_id, self.NOTIFICATION_ID)
+        self.assertEqual(notification.etag, self.ETAG)
+        self.assertEqual(notification.self_link, self.SELF_LINK)
+
+        data = {
+            "topic": self.TOPIC_ALT_REF,
+            "custom_attributes": self.CUSTOM_ATTRIBUTES,
+            "event_types": self.event_types(),
+            "object_name_prefix": self.BLOB_NAME_PREFIX,
+            "payload_format": self.payload_format(),
+        }
+        api_request.assert_called_once_with(
+            method="POST",
+            path=self.CREATE_PATH,
+            query_params={"userProject": USER_PROJECT},
+            data=data,
+        )
+
+    def test_exists_wo_notification_id(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        with self.assertRaises(ValueError):
+            notification.exists()
+
+    def test_exists_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+        api_request = client._connection.api_request
+        api_request.side_effect = NotFound("testing")
+
+        self.assertFalse(notification.exists())
+
+        api_request.assert_called_once_with(
+            method="GET", path=self.NOTIFICATION_PATH, query_params={}
+        )
+
+    def test_exists_hit(self):
+        USER_PROJECT = "user-project-123"
+        client = self._make_client()
+        bucket = self._make_bucket(client, user_project=USER_PROJECT)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+        api_request = client._connection.api_request
+        api_request.return_value = {
+            "topic": self.TOPIC_REF,
+            "id": self.NOTIFICATION_ID,
+            "etag": self.ETAG,
+            "selfLink": self.SELF_LINK,
+        }
+
+        self.assertTrue(notification.exists(client=client))
+
+        api_request.assert_called_once_with(
+            method="GET",
+            path=self.NOTIFICATION_PATH,
+            query_params={"userProject": USER_PROJECT},
+        )
+
+    def test_reload_wo_notification_id(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        with self.assertRaises(ValueError):
+            notification.reload()
+
+    def test_reload_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+        api_request = client._connection.api_request
+        api_request.side_effect = NotFound("testing")
+
+        with self.assertRaises(NotFound):
+            notification.reload()
+
+        api_request.assert_called_once_with(
+            method="GET", path=self.NOTIFICATION_PATH, query_params={}
+        )
+
+    def test_reload_hit(self):
+        from google.cloud.storage.notification import NONE_PAYLOAD_FORMAT
+
+        USER_PROJECT = "user-project-123"
+        client = self._make_client()
+        bucket = self._make_bucket(client, user_project=USER_PROJECT)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+        api_request = client._connection.api_request
+        api_request.return_value = {
+            "topic": self.TOPIC_REF,
+            "id": self.NOTIFICATION_ID,
+            "etag": self.ETAG,
+            "selfLink": self.SELF_LINK,
+            "payload_format": NONE_PAYLOAD_FORMAT,
+        }
+
+        notification.reload(client=client)
+
+        self.assertEqual(notification.etag, self.ETAG)
+        self.assertEqual(notification.self_link, self.SELF_LINK)
+        self.assertIsNone(notification.custom_attributes)
+        self.assertIsNone(notification.event_types)
+        self.assertIsNone(notification.blob_name_prefix)
+        self.assertEqual(notification.payload_format, NONE_PAYLOAD_FORMAT)
+
+        api_request.assert_called_once_with(
+            method="GET",
+            path=self.NOTIFICATION_PATH,
+            query_params={"userProject": USER_PROJECT},
+        )
+
+    def test_delete_wo_notification_id(self):
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+
+        with self.assertRaises(ValueError):
+            notification.delete()
+
+    def test_delete_miss(self):
+        from google.cloud.exceptions import NotFound
+
+        client = self._make_client()
+        bucket = self._make_bucket(client)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+        api_request = client._connection.api_request
+        api_request.side_effect = NotFound("testing")
+
+        with self.assertRaises(NotFound):
+            notification.delete()
+
+        api_request.assert_called_once_with(
+            method="DELETE", path=self.NOTIFICATION_PATH, query_params={}
+        )
+
+    def test_delete_hit(self):
+        USER_PROJECT = "user-project-123"
+        client = self._make_client()
+        bucket = self._make_bucket(client, user_project=USER_PROJECT)
+        notification = self._make_one(bucket, self.TOPIC_NAME)
+        notification._properties["id"] = self.NOTIFICATION_ID
+        api_request = client._connection.api_request
+        api_request.return_value = None
+
+        notification.delete(client=client)
+
+        api_request.assert_called_once_with(
+            method="DELETE",
+            path=self.NOTIFICATION_PATH,
+            query_params={"userProject": USER_PROJECT},
+        )
+
+
+class Test__parse_topic_path(unittest.TestCase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.storage import notification
+
+        return notification._parse_topic_path(*args, **kwargs)
+
+    @staticmethod
+    def _make_topic_path(project, topic_name):
+        from google.cloud.storage import notification
+
+        return notification._TOPIC_REF_FMT.format(project, topic_name)
+
+    def test_project_name_too_long(self):
+        project = "a" * 31
+        topic_path = self._make_topic_path(project, "topic-name")
+        with self.assertRaises(ValueError):
+            self._call_fut(topic_path)
+
+    def test_project_name_uppercase(self):
+        project = "aaaAaa"
+        topic_path = self._make_topic_path(project, "topic-name")
+        with self.assertRaises(ValueError):
+            self._call_fut(topic_path)
+
+    def test_leading_digit(self):
+        project = "1aaaaa"
+        topic_path = self._make_topic_path(project, "topic-name")
+        with self.assertRaises(ValueError):
+            self._call_fut(topic_path)
+
+    def test_leading_hyphen(self):
+        project = "-aaaaa"
+        topic_path = self._make_topic_path(project, "topic-name")
+        with self.assertRaises(ValueError):
+            self._call_fut(topic_path)
+
+    def test_trailing_hyphen(self):
+        project = "aaaaa-"
+        topic_path = self._make_topic_path(project, "topic-name")
+        with self.assertRaises(ValueError):
+            self._call_fut(topic_path)
+
+    def test_invalid_format(self):
+        topic_path = "@#$%"
+        with self.assertRaises(ValueError):
+            self._call_fut(topic_path)
+
+    def test_success(self):
+        topic_name = "tah-pic-nehm"
+        project_choices = (
+            "a" * 30,  # Max length.
+            "a-b--c---d",  # Valid hyphen usage.
+            "abcdefghijklmnopqrstuvwxyz",  # Valid letters.
+            "z0123456789",  # Valid digits (non-leading).
+            "a-bcdefghijklmn12opqrstuv0wxyz",
+        )
+        for project in project_choices:
+            topic_path = self._make_topic_path(project, topic_name)
+            result = self._call_fut(topic_path)
+            self.assertEqual(result, (topic_name, project))
diff --git a/storage/tests/unit/url_signer_v4_test_account.json b/storage/tests/unit/url_signer_v4_test_account.json
new file mode 100644
index 000000000000..5fdc01240ef8
--- /dev/null
+++ b/storage/tests/unit/url_signer_v4_test_account.json
@@ -0,0 +1,12 @@
+{
+  "type": "service_account",
+  "project_id": "dummy-project-id",
+  "private_key_id": "ffffffffffffffffffffffffffffffffffffffff",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCsPzMirIottfQ2\nryjQmPWocSEeGo7f7Q4/tMQXHlXFzo93AGgU2t+clEj9L5loNhLVq+vk+qmnyDz5\nQ04y8jVWyMYzzGNNrGRW/yaYqnqlKZCy1O3bmnNjV7EDbC/jE1ZLBY0U3HaSHfn6\nS9ND8MXdgD0/ulRTWwq6vU8/w6i5tYsU7n2LLlQTl1fQ7/emO9nYcCFJezHZVa0H\nmeWsdHwWsok0skwQYQNIzP3JF9BpR5gJT2gNge6KopDesJeLoLzaX7cUnDn+CAnn\nLuLDwwSsIVKyVxhBFsFXPplgpaQRwmGzwEbf/Xpt9qo26w2UMgn30jsOaKlSeAX8\ncS6ViF+tAgMBAAECggEACKRuJCP8leEOhQziUx8Nmls8wmYqO4WJJLyk5xUMUC22\nSI4CauN1e0V8aQmxnIc0CDkFT7qc9xBmsMoF+yvobbeKrFApvlyzNyM7tEa/exh8\nDGD/IzjbZ8VfWhDcUTwn5QE9DCoon9m1sG+MBNlokB3OVOt8LieAAREdEBG43kJu\nyQTOkY9BGR2AY1FnAl2VZ/jhNDyrme3tp1sW1BJrawzR7Ujo8DzlVcS2geKA9at7\n55ua5GbHz3hfzFgjVXDfnkWzId6aHypUyqHrSn1SqGEbyXTaleKTc6Pgv0PgkJjG\nhZazWWdSuf1T5Xbs0OhAK9qraoAzT6cXXvMEvvPt6QKBgQDXcZKqJAOnGEU4b9+v\nOdoh+nssdrIOBNMu1m8mYbUVYS1aakc1iDGIIWNM3qAwbG+yNEIi2xi80a2RMw2T\n9RyCNB7yqCXXVKLBiwg9FbKMai6Vpk2bWIrzahM9on7AhCax/X2AeOp+UyYhFEy6\nUFG4aHb8THscL7b515ukSuKb5QKBgQDMq+9PuaB0eHsrmL6q4vHNi3MLgijGg/zu\nAXaPygSYAwYW8KglcuLZPvWrL6OG0+CrfmaWTLsyIZO4Uhdj7MLvX6yK7IMnagvk\nL3xjgxSklEHJAwi5wFeJ8ai/1MIuCn8p2re3CbwISKpvf7Sgs/W4196P4vKvTiAz\njcTiSYFIKQKBgCjMpkS4O0TakMlGTmsFnqyOneLmu4NyIHgfPb9cA4n/9DHKLKAT\noaWxBPgatOVWs7RgtyGYsk+XubHkpC6f3X0+15mGhFwJ+CSE6tN+l2iF9zp52vqP\nQwkjzm7+pdhZbmaIpcq9m1K+9lqPWJRz/3XXuqi+5xWIZ7NaxGvRjqaNAoGAdK2b\nutZ2y48XoI3uPFsuP+A8kJX+CtWZrlE1NtmS7tnicdd19AtfmTuUL6fz0FwfW4Su\nlQZfPT/5B339CaEiq/Xd1kDor+J7rvUHM2+5p+1A54gMRGCLRv92FQ4EON0RC1o9\nm2I4SHysdO3XmjmdXmfp4BsgAKJIJzutvtbqlakCgYB+Cb10z37NJJ+WgjDt+yT2\nyUNH17EAYgWXryfRgTyi2POHuJitd64Xzuy6oBVs3wVveYFM6PIKXlj8/DahYX5I\nR2WIzoCNLL3bEZ+nC6Jofpb4kspoAeRporj29SgesK6QBYWHWX2H645RkRGYGpDo\n51gjy9m/hSNqBbH2zmh04A==\n-----END PRIVATE KEY-----\n",
+  "client_email": "test-iam-credentials@dummy-project-id.iam.gserviceaccount.com",
+  "client_id": "000000000000000000000",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://oauth2.googleapis.com/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com"
+}
\ No newline at end of file
diff --git a/storage/tests/unit/url_signer_v4_test_data.json b/storage/tests/unit/url_signer_v4_test_data.json
new file mode 100644
index 000000000000..807f6cf49a3e
--- /dev/null
+++ b/storage/tests/unit/url_signer_v4_test_data.json
@@ -0,0 +1,122 @@
+[
+    {
+        "description": "Simple GET",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host&X-Goog-Signature=95e6a13d43a1d1962e667f17397f2b80ac9bdd1669210d5e08e0135df9dff4e56113485dbe429ca2266487b9d1796ebdee2d7cf682a6ef3bb9fbb4c351686fba90d7b621cf1c4eb1fdf126460dd25fa0837dfdde0a9fd98662ce60844c458448fb2b352c203d9969cb74efa4bdb742287744a4f2308afa4af0e0773f55e32e92973619249214b97283b2daa14195244444e33f938138d1e5f561088ce8011f4986dda33a556412594db7c12fc40e1ff3f1bedeb7a42f5bcda0b9567f17f65855f65071fabb88ea12371877f3f77f10e1466fff6ff6973b74a933322ff0949ce357e20abe96c3dd5cfab42c9c83e740a4d32b9e11e146f0eb3404d2e975896f74"
+    },
+
+    {
+        "description": "Simple PUT",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "method": "PUT",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host&X-Goog-Signature=8adff1d4285739e31aa68e73767a46bc5511fde377497dbe08481bf5ceb34e29cc9a59921748d8ec3dd4085b7e9b7772a952afedfcdaecb3ae8352275b8b7c867f204e3db85076220a3127a8a9589302fc1181eae13b9b7fe41109ec8cdc93c1e8bac2d7a0cc32a109ca02d06957211326563ab3d3e678a0ba296e298b5fc5e14593c99d444c94724cc4be97015dbff1dca377b508fa0cb7169195de98d0e4ac96c42b918d28c8d92d33e1bd125ce0fb3cd7ad2c45dae65c22628378f6584971b8bf3945b26f2611eb651e9b6a8648970c1ecf386bb71327b082e7296c4e1ee2fc0bdd8983da80af375c817fb1ad491d0bc22c0f51dba0d66e2cffbc90803e47"
+    },
+
+    {
+        "description": "POST for resumable uploads",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "method": "POST",
+        "expiration": 10,
+        "headers": {
+            "x-goog-resumable": "start"
+        },
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host%3Bx-goog-resumable&X-Goog-Signature=4a6d39b23343cedf4c30782aed4b384001828c79ffa3a080a481ea01a640dea0a0ceb58d67a12cef3b243c3f036bb3799c6ee88e8db3eaf7d0bdd4b70a228d0736e07eaa1ee076aff5c6ce09dff1f1f03a0d8ead0d2893408dd3604fdabff553aa6d7af2da67cdba6790006a70240f96717b98f1a6ccb24f00940749599be7ef72aaa5358db63ddd54b2de9e2d6d6a586eac4fe25f36d86fc6ab150418e9c6fa01b732cded226c6d62fc95b72473a4cc55a8257482583fe66d9ab6ede909eb41516a8690946c3e87b0f2052eb0e97e012a14b2f721c42e6e19b8a1cd5658ea36264f10b9b1ada66b8ed5bf7ed7d1708377ac6e5fe608ae361fb594d2e5b24c54"
+    },
+
+    {
+        "description": "Vary expiration and timestamp",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "method": "GET",
+        "expiration": 20,
+        "timestamp": "20190301T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190301%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190301T090000Z&X-Goog-Expires=20&X-Goog-SignedHeaders=host&X-Goog-Signature=9669ed5b10664dc594c758296580662912cf4bcc5a4ba0b6bf055bcbf6f34eed7bdad664f534962174a924741a0c273a4f67bc1847cef20192a6beab44223bd9d4fbbd749c407b79997598c30f82ddc269ff47ec09fa3afe74e00616d438df0d96a7d8ad0adacfad1dc3286f864d924fe919fb0dce45d3d975c5afe8e13af2db9cc37ba77835f92f7669b61e94c6d562196c1274529e76cfff1564cc2cad7d5387dc8e12f7a5dfd925685fe92c30b43709eee29fa2f66067472cee5423d1a3a4182fe8cea75c9329d181dc6acad7c393cd04f8bf5bc0515127d8ebd65d80c08e19ad03316053ea60033fd1b1fd85a69c576415da3bf0a3718d9ea6d03e0d66f0"
+    },
+
+    {
+        "description": "Vary bucket and object",
+        "bucket": "test-bucket2",
+        "object": "test-object2",
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket2/test-object2?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host&X-Goog-Signature=36e3d58dfd3ec1d2dd2f24b5ee372a71e811ffaa2162a2b871d26728d0354270bc116face87127532969c4a3967ed05b7309af741e19c7202f3167aa8c2ac420b61417d6451442bb91d7c822cd17be8783f01e05372769c88913561d27e6660dd8259f0081a71f831be6c50283626cbf04494ac10c394b29bb3bce74ab91548f58a37118a452693cf0483d77561fc9cac8f1765d2c724994cca46a83517a10157ee0347a233a2aaeae6e6ab5e204ff8fc5f54f90a3efdb8301d9fff5475d58cd05b181affd657f48203f4fb133c3a3d355b8eefbd10d5a0a5fd70d06e9515460ad74e22334b2cba4b29cae4f6f285cdb92d8f3126d7a1479ca3bdb69c207d860"
+    },
+
+    {
+        "description": "Simple headers",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "headers": {
+            "foo": "foo-value",
+            "BAR": "BAR-value"
+        },
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=bar%3Bfoo%3Bhost&X-Goog-Signature=68ecd3b008328ed30d91e2fe37444ed7b9b03f28ed4424555b5161980531ef87db1c3a5bc0265aad5640af30f96014c94fb2dba7479c41bfe1c020eb90c0c6d387d4dd09d4a5df8b60ea50eb6b01cdd786a1e37020f5f95eb8f9b6cd3f65a1f8a8a65c9fcb61ea662959efd9cd73b683f8d8804ef4d6d9b2852419b013368842731359d7f9e6d1139032ceca75d5e67cee5fd0192ea2125e5f2955d38d3d50cf116f3a52e6a62de77f6207f5b95aaa1d7d0f8a46de89ea72e7ea30f21286318d7eba0142232b0deb3a1dc9e1e812a981c66b5ffda3c6b01a8a9d113155792309fd53a3acfd054ca7776e8eec28c26480cd1e3c812f67f91d14217f39a606669d"
+    },
+
+    {
+        "description": "Headers should be trimmed",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "headers": {
+            "leading": "    xyz",
+            "trailing": "abc    ",
+            "collapsed": "abc    def"
+        },
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=collapsed%3Bhost%3Bleading%3Btrailing&X-Goog-Signature=1839511d6238d9ac2bbcbba8b23515b3757db35dfa7b8f9bc4b8b4aa270224df747c812526f1a3bcf294d67ed84cd14e074c36bc090e0a542782934a7c925af4a5ea68123e97533704ce8b08ccdf5fe6b412f89c9fc4de243e29abdb098382c5672188ee3f6fef7131413e252c78e7a35658825ad842a50609e9cc463731e17284ff7a14824c989f87cef22fb99dfec20cfeed69d8b3a08f00b43b8284eecd535e50e982b05cd74c5750cd5f986cfc21a2a05f7f3ab7fc31bd684ed1b823b64d29281e923fc6580c49005552ca19c253de087d9d2df881144e44eda40965cfdb4889bf3a35553c9809f4ed20b8355be481b92b9618952b6a04f3017b36053e15"
+    },
+
+    {
+        "description": "Header value with multiple inline values",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "headers": {
+            "multiple": " xyz ,  abc, def  , xyz   "
+        },
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host%3Bmultiple&X-Goog-Signature=5cc113735625341f59c7203f0c2c9febc95ba6af6b9c38814f8e523214712087dc0996e4960d273ae1889f248ac1e58d4d19cb3a69ad7670e9a8ca1b434e878f59339dc7006cf32dfd715337e9f593e0504371839174962a08294586e0c78160a7aa303397888c8350637c6af3b32ac310886cc4590bfda9ca561ee58fb5b8ec56bc606d2ada6e7df31f4276e9dcb96bcaea39dc2cd096f3fad774f9c4b30e317ad43736c05f76831437f44e8726c1e90d3f6c9827dc273f211f32fc85658dfc5d357eb606743a6b00a29e519eef1bebaf9db3e8f4b1f5f9afb648ad06e60bc42fa8b57025056697c874c9ea76f5a73201c9717ea43e54713ff3502ff3fc626b"
+    },
+
+    {
+        "description": "Customer-supplied encryption key",
+        "bucket": "test-bucket",
+        "object": "test-object",
+        "headers":
+        {
+            "X-Goog-Encryption-Key": "key",
+            "X-Goog-Encryption-Key-Sha256": "key-hash",
+            "X-Goog-Encryption-Algorithm": "AES256"
+        },
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket/test-object?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host%3Bx-goog-encryption-algorithm%3Bx-goog-encryption-key%3Bx-goog-encryption-key-sha256&X-Goog-Signature=278a1c5a3bad248637054a047014760353942433955871031ed08f515b54588654ad033e91f046ab202b68673030e117d1b786c325e870238b035ba75b3feed560a17aff9bab6bddebd4a31a52cb68b214e27d3b0bd886502c6b36b164306fe88b5a07c6063592afe746b2a5d205dbe90dd5386b94f0a78f75d9f53ee884e18f476e8fc2eb1dd910ce0b4ae1f5d7b09876ef9bf983f539c028429e14bad3c75dbd4ed1ae37856f6d6f8a1805eaf8b52a0d6fc993902e4c1ee8de477661f7b67c3663000474cb00e178189789b2a3ed6bd21b4ade684fca8108ac4dd106acb17f5954d045775f7aa5a98ebda5d3075e11a8ea49c64c6ad1481e463e8c9f11f704"
+    },
+
+    {
+        "description": "List Objects",
+        "bucket": "test-bucket",
+        "object": "",
+        "method": "GET",
+        "expiration": 10,
+        "timestamp": "20190201T090000Z",
+        "expectedUrl": "https://storage.googleapis.com/test-bucket?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-iam-credentials%40dummy-project-id.iam.gserviceaccount.com%2F20190201%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20190201T090000Z&X-Goog-Expires=10&X-Goog-SignedHeaders=host&X-Goog-Signature=6dbe94f8e52b2b8a9a476b1c857efa474e09944e2b52b925800316e094a7169d8dbe0df9c0ac08dabb22ac7e827470ceccd65f5a3eadba2a4fb9beebfe37f0d9bb1e552b851fa31a25045bdf019e507f5feb44f061551ef1aeb18dcec0e38ba2e2f77d560a46eaace9c56ed9aa642281301a9d848b0eb30749e34bc7f73a3d596240533466ff9b5f289cd0d4c845c7d96b82a35a5abd0c3aff83e4440ee6873e796087f43545544dc8c01afe1d79c726696b6f555371e491980e7ec145cca0803cf562c38f3fa1d724242f5dea25aac91d74ec9ddd739ff65523627763eaef25cd1f95ad985aaf0079b7c74eb5bcb2870a9b137a7b2c8e41fbe838c95872f75b"
+    }
+]
diff --git a/system_tests/app_credentials.json.sample b/system_tests/app_credentials.json.sample
deleted file mode 100644
index b37488e19d3b..000000000000
--- a/system_tests/app_credentials.json.sample
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "client_id": "my-project",
-  "client_email": "some-account@developer.gserviceaccount.com",
-  "private_key": "-----BEGIN PRIVATE KEY-----\nSome Private Key Text\n-----END PRIVATE KEY-----\n",
-  "private_key_id": "your-key-id",
-  "type": "service_account"
-}
diff --git a/system_tests/attempt_system_tests.py b/system_tests/attempt_system_tests.py
deleted file mode 100644
index 8b2d0a378b01..000000000000
--- a/system_tests/attempt_system_tests.py
+++ /dev/null
@@ -1,191 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-"""Attempt to run system tests.
-
-If the system tests are being run on Travis, no test need be run if
-the build is for a PR and not a merged commit.
-
-If being run as part of a Travis build for a merged commit, the
-encrypted `key.json` file need be decrypted before running tests.
-
-Before encrypting:
-
-* Visit ``https://github.com/settings/tokens/new``, get a token,
-  and store the token in travis.token file.
-* Visit
-  ``https://console.cloud.google.com/apis/credentials?project={PROJ}``
-* Click "Create credentials >> Service account key", select your
-  service account and create a JSON key (we'll call it ``key.json``)
-
-Encrypt the file via::
-
-$ travis login --github-token=$(cat travis.token)
-$ travis encrypt-file --repo=GoogleCloudPlatform/google-cloud-python key.json
-
-After running ``travis encrypt-file``, take note of the ``openssl`` command
-printed out. In particular, it'll give the name of the key and
-IV (initialization vector) environment variables added to the Travis
-project.
-
-See:
-https://docs.travis-ci.com/user/encrypting-files/
-"""
-
-
-from __future__ import print_function
-import argparse
-import os
-import subprocess
-import sys
-
-from google.cloud.environment_vars import CREDENTIALS
-
-from run_system_test import FailedSystemTestModule
-from run_system_test import run_module_tests
-
-
-MODULES = (  # ordered from most to least stable
-    'datastore',
-    'storage',
-    'bigquery',
-    'pubsub',
-    'language',
-    'logging',
-    'translate',
-    'monitoring',
-    'bigtable',
-)
-
-SCRIPTS_DIR = os.path.dirname(__file__)
-ROOT_DIR = os.path.abspath(os.path.join(SCRIPTS_DIR, '..'))
-ENCRYPTED_KEYFILE = os.path.join(ROOT_DIR, 'system_tests', 'key.json.enc')
-ENCRYPTED_KEY_ENV = 'encrypted_c16407eb06cc_key'
-ENCRYPTED_INIT_VECTOR_ENV = 'encrypted_c16407eb06cc_iv'
-ALL_MODULES = object()  # Sentinel for argparser
-
-
-def check_environment():
-    """Check what environment this is running in.
-
-    In particular, if the environment is Travis.
-
-    :rtype: tuple
-    :returns: A pair of booleans. The first indicates if the test
-              is running in Travis and the second indicates if
-              the current build is a non-PR for a merge to master.
-    """
-    if os.getenv('TRAVIS') == 'true':
-        is_travis = True
-        non_pr = (os.getenv('TRAVIS_PULL_REQUEST') == 'false' and
-                  os.getenv('TRAVIS_BRANCH') == 'master')
-    else:
-        is_travis = non_pr = False
-
-    return is_travis, non_pr
-
-
-def decrypt_keyfile():
-    """Decrypt a keyfile."""
-    print('Running in Travis during merge, decrypting stored '
-          'key file.')
-
-    encrypted_key = os.getenv(ENCRYPTED_KEY_ENV)
-    encrypted_iv = os.getenv(ENCRYPTED_INIT_VECTOR_ENV)
-    out_file = os.getenv(CREDENTIALS)
-    # Convert encrypted key file into decrypted file to be used.
-    subprocess.call([
-        'openssl', 'aes-256-cbc',
-        '-K', encrypted_key,
-        '-iv', encrypted_iv,
-        '-in', ENCRYPTED_KEYFILE,
-        '-out', out_file, '-d'
-    ])
-
-
-def prepare_to_run():
-    """Prepare to run system tests.
-
-    If on Travis during a PR, exit the entire program; there is
-    no need to run the system tests.
-
-    If on Travis during a build for a non-PR merge to master,
-    decrypts stored keyfile.
-    """
-    is_travis, non_pr = check_environment()
-    # Nothing to prepare outside of Travis. Proceed to tests.
-    if not is_travis:
-        return
-
-    # On a Travis PR, exit the program.
-    if not non_pr:
-        print('Running in Travis during non-merge to master, '
-              'doing nothing.')
-        sys.exit(0)
-
-    # On a Travis build for a merge commit to master, decrypt.
-    decrypt_keyfile()
-
-
-def get_parser():
-    """Get an argument parser to determine a list of packages."""
-    parser = argparse.ArgumentParser(
-        description='google-cloud tests runner.')
-    help_msg = ('List of packages to be tested. '
-                'If left blank, tests all packages.')
-    parser.add_argument('packages', nargs='*',
-                        default=ALL_MODULES, help=help_msg)
-    return parser
-
-
-def get_modules():
-    """Get the list of modules names to run system tests for."""
-    parser = get_parser()
-    args = parser.parse_args()
-    if args.packages is ALL_MODULES:
-        result = list(MODULES)
-    else:
-        result = []
-        invalid = []
-        for package in args.packages:
-            if package in MODULES:
-                result.append(package)
-            else:
-                invalid.append(package)
-
-        if invalid:
-            msg = 'No system test for packages: ' + ', '.join(invalid)
-            print(msg, file=sys.stderr)
-            sys.exit(1)
-
-    return result
-
-
-def main():
-    """Run all the system tests if necessary."""
-    prepare_to_run()
-
-    failed_modules = 0
-    modules = get_modules()
-    for module in modules:
-        try:
-            run_module_tests(module)
-        except FailedSystemTestModule:
-            failed_modules += 1
-
-    sys.exit(failed_modules)
-
-
-if __name__ == '__main__':
-    main()
diff --git a/system_tests/bigquery.py b/system_tests/bigquery.py
deleted file mode 100644
index d48bd146105a..000000000000
--- a/system_tests/bigquery.py
+++ /dev/null
@@ -1,468 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import operator
-
-import unittest
-
-from google.cloud import bigquery
-from google.cloud.exceptions import Forbidden
-
-from retry import RetryErrors
-from retry import RetryInstanceState
-from retry import RetryResult
-from system_test_utils import unique_resource_id
-
-
-def _make_dataset_name(prefix):
-    return '%s%s' % (prefix, unique_resource_id())
-
-
-def _rate_limit_exceeded(forbidden):
-    """Predicate: pass only exceptions with 'rateLimitExceeded' as reason."""
-    return any(error['reason'] == 'rateLimitExceeded'
-               for error in forbidden._errors)
-
-
-# We need to wait to stay within the rate limits.
-# The alternative outcome is a 403 Forbidden response from upstream, which
-# they return instead of the more appropriate 429.
-# See: https://cloud.google.com/bigquery/quota-policy
-retry_403 = RetryErrors(Forbidden, error_predicate=_rate_limit_exceeded)
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-
-
-def setUpModule():
-    Config.CLIENT = bigquery.Client()
-
-
-class TestBigQuery(unittest.TestCase):
-
-    def setUp(self):
-        self.to_delete = []
-
-    def tearDown(self):
-        from google.cloud.bigquery.dataset import Dataset
-        from google.cloud.storage import Bucket
-        from google.cloud.exceptions import BadRequest
-        from google.cloud.exceptions import Conflict
-
-        def _still_in_use(bad_request):
-            return any(error['reason'] == 'resourceInUse'
-                       for error in bad_request._errors)
-
-        retry_in_use = RetryErrors(BadRequest, error_predicate=_still_in_use)
-        retry_409 = RetryErrors(Conflict)
-        for doomed in self.to_delete:
-            if isinstance(doomed, Bucket):
-                retry_409(doomed.delete)(force=True)
-            elif isinstance(doomed, Dataset):
-                retry_in_use(doomed.delete)()
-            else:
-                doomed.delete()
-
-    def test_create_dataset(self):
-        DATASET_NAME = _make_dataset_name('create_dataset')
-        dataset = Config.CLIENT.dataset(DATASET_NAME)
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        self.assertTrue(dataset.exists())
-        self.assertEqual(dataset.name, DATASET_NAME)
-
-    def test_reload_dataset(self):
-        DATASET_NAME = _make_dataset_name('reload_dataset')
-        dataset = Config.CLIENT.dataset(DATASET_NAME)
-        dataset.friendly_name = 'Friendly'
-        dataset.description = 'Description'
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        other = Config.CLIENT.dataset(DATASET_NAME)
-        other.reload()
-        self.assertEqual(other.friendly_name, 'Friendly')
-        self.assertEqual(other.description, 'Description')
-
-    def test_patch_dataset(self):
-        dataset = Config.CLIENT.dataset(_make_dataset_name('patch_dataset'))
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        self.assertTrue(dataset.exists())
-        self.assertIsNone(dataset.friendly_name)
-        self.assertIsNone(dataset.description)
-        dataset.patch(friendly_name='Friendly', description='Description')
-        self.assertEqual(dataset.friendly_name, 'Friendly')
-        self.assertEqual(dataset.description, 'Description')
-
-    def test_update_dataset(self):
-        dataset = Config.CLIENT.dataset(_make_dataset_name('update_dataset'))
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        self.assertTrue(dataset.exists())
-        after = [grant for grant in dataset.access_grants
-                 if grant.entity_id != 'projectWriters']
-        dataset.access_grants = after
-
-        retry_403(dataset.update)()
-
-        self.assertEqual(len(dataset.access_grants), len(after))
-        for found, expected in zip(dataset.access_grants, after):
-            self.assertEqual(found.role, expected.role)
-            self.assertEqual(found.entity_type, expected.entity_type)
-            self.assertEqual(found.entity_id, expected.entity_id)
-
-    def test_list_datasets(self):
-        datasets_to_create = [
-            'new' + unique_resource_id(),
-            'newer' + unique_resource_id(),
-            'newest' + unique_resource_id(),
-        ]
-        for dataset_name in datasets_to_create:
-            dataset = Config.CLIENT.dataset(dataset_name)
-            retry_403(dataset.create)()
-            self.to_delete.append(dataset)
-
-        # Retrieve the datasets.
-        all_datasets, token = Config.CLIENT.list_datasets()
-        self.assertIsNone(token)
-        created = [dataset for dataset in all_datasets
-                   if dataset.name in datasets_to_create and
-                   dataset.project == Config.CLIENT.project]
-        self.assertEqual(len(created), len(datasets_to_create))
-
-    def test_create_table(self):
-        dataset = Config.CLIENT.dataset(_make_dataset_name('create_table'))
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        TABLE_NAME = 'test_table'
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age])
-        self.assertFalse(table.exists())
-        table.create()
-        self.to_delete.insert(0, table)
-        self.assertTrue(table.exists())
-        self.assertEqual(table.name, TABLE_NAME)
-
-    def test_list_tables(self):
-        DATASET_NAME = _make_dataset_name('list_tables')
-        dataset = Config.CLIENT.dataset(DATASET_NAME)
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        # Retrieve tables before any are created for the dataset.
-        all_tables, token = dataset.list_tables()
-        self.assertEqual(all_tables, [])
-        self.assertIsNone(token)
-
-        # Insert some tables to be listed.
-        tables_to_create = [
-            'new' + unique_resource_id(),
-            'newer' + unique_resource_id(),
-            'newest' + unique_resource_id(),
-        ]
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        for table_name in tables_to_create:
-            table = dataset.table(table_name, schema=[full_name, age])
-            table.create()
-            self.to_delete.insert(0, table)
-
-        # Retrieve the tables.
-        all_tables, token = dataset.list_tables()
-        self.assertIsNone(token)
-        created = [table for table in all_tables
-                   if (table.name in tables_to_create and
-                       table.dataset_name == DATASET_NAME)]
-        self.assertEqual(len(created), len(tables_to_create))
-
-    def test_patch_table(self):
-        dataset = Config.CLIENT.dataset(_make_dataset_name('patch_table'))
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        TABLE_NAME = 'test_table'
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age])
-        self.assertFalse(table.exists())
-        table.create()
-        self.to_delete.insert(0, table)
-        self.assertTrue(table.exists())
-        self.assertIsNone(table.friendly_name)
-        self.assertIsNone(table.description)
-        table.patch(friendly_name='Friendly', description='Description')
-        self.assertEqual(table.friendly_name, 'Friendly')
-        self.assertEqual(table.description, 'Description')
-
-    def test_update_table(self):
-        dataset = Config.CLIENT.dataset(_make_dataset_name('update_table'))
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        TABLE_NAME = 'test_table'
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age])
-        self.assertFalse(table.exists())
-        table.create()
-        self.to_delete.insert(0, table)
-        self.assertTrue(table.exists())
-        voter = bigquery.SchemaField('voter', 'BOOLEAN', mode='NULLABLE')
-        schema = table.schema
-        schema.append(voter)
-        table.schema = schema
-        table.update()
-        self.assertEqual(len(table.schema), len(schema))
-        for found, expected in zip(table.schema, schema):
-            self.assertEqual(found.name, expected.name)
-            self.assertEqual(found.field_type, expected.field_type)
-            self.assertEqual(found.mode, expected.mode)
-
-    def test_insert_data_then_dump_table(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        NOW_SECONDS = 1448911495.484366
-        NOW = datetime.datetime.utcfromtimestamp(
-            NOW_SECONDS).replace(tzinfo=UTC)
-        ROWS = [
-            ('Phred Phlyntstone', 32, NOW),
-            ('Bharney Rhubble', 33, NOW + datetime.timedelta(seconds=10)),
-            ('Wylma Phlyntstone', 29, NOW + datetime.timedelta(seconds=20)),
-            ('Bhettye Rhubble', 27, None),
-        ]
-        ROW_IDS = range(len(ROWS))
-        dataset = Config.CLIENT.dataset(
-            _make_dataset_name('insert_data_then_dump'))
-        self.assertFalse(dataset.exists())
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        TABLE_NAME = 'test_table'
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        now = bigquery.SchemaField('now', 'TIMESTAMP')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age, now])
-        self.assertFalse(table.exists())
-        table.create()
-        self.to_delete.insert(0, table)
-        self.assertTrue(table.exists())
-
-        errors = table.insert_data(ROWS, ROW_IDS)
-        self.assertEqual(len(errors), 0)
-
-        rows = ()
-
-        def _has_rows(result):
-            return len(result[0]) > 0
-
-        # Allow for 90 seconds of "warm up" before rows visible.  See:
-        # https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataavailability
-        # 8 tries -> 1 + 2 + 4 + 8 + 16 + 32 + 64 = 127 seconds
-        retry = RetryResult(_has_rows, max_tries=8)
-        rows, _, _ = retry(table.fetch_data)()
-
-        by_age = operator.itemgetter(1)
-        self.assertEqual(sorted(rows, key=by_age),
-                         sorted(ROWS, key=by_age))
-
-    def test_load_table_from_local_file_then_dump_table(self):
-        import csv
-        import tempfile
-        ROWS = [
-            ('Phred Phlyntstone', 32),
-            ('Bharney Rhubble', 33),
-            ('Wylma Phlyntstone', 29),
-            ('Bhettye Rhubble', 27),
-        ]
-        TABLE_NAME = 'test_table'
-
-        dataset = Config.CLIENT.dataset(
-            _make_dataset_name('load_local_then_dump'))
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age])
-        table.create()
-        self.to_delete.insert(0, table)
-
-        with tempfile.NamedTemporaryFile(mode='w+') as csv_file:
-            writer = csv.writer(csv_file)
-            writer.writerow(('Full Name', 'Age'))
-            writer.writerows(ROWS)
-            csv_file.flush()
-
-            with open(csv_file.name, 'rb') as csv_read:
-                job = table.upload_from_file(
-                    csv_read,
-                    source_format='CSV',
-                    skip_leading_rows=1,
-                    create_disposition='CREATE_NEVER',
-                    write_disposition='WRITE_EMPTY',
-                )
-
-        def _job_done(instance):
-            return instance.state.lower() == 'done'
-
-        # Retry until done.
-        retry = RetryInstanceState(_job_done, max_tries=8)
-        retry(job.reload)()
-
-        self.assertEqual(job.output_rows, len(ROWS))
-
-        rows, _, _ = table.fetch_data()
-        by_age = operator.itemgetter(1)
-        self.assertEqual(sorted(rows, key=by_age),
-                         sorted(ROWS, key=by_age))
-
-    def test_load_table_from_storage_then_dump_table(self):
-        import csv
-        import tempfile
-        from google.cloud.storage import Client as StorageClient
-        local_id = unique_resource_id()
-        BUCKET_NAME = 'bq_load_test' + local_id
-        BLOB_NAME = 'person_ages.csv'
-        GS_URL = 'gs://%s/%s' % (BUCKET_NAME, BLOB_NAME)
-        ROWS = [
-            ('Phred Phlyntstone', 32),
-            ('Bharney Rhubble', 33),
-            ('Wylma Phlyntstone', 29),
-            ('Bhettye Rhubble', 27),
-        ]
-        TABLE_NAME = 'test_table'
-
-        s_client = StorageClient()
-
-        # In the **very** rare case the bucket name is reserved, this
-        # fails with a ConnectionError.
-        bucket = s_client.create_bucket(BUCKET_NAME)
-        self.to_delete.append(bucket)
-
-        blob = bucket.blob(BLOB_NAME)
-
-        with tempfile.TemporaryFile(mode='w+') as csv_file:
-            writer = csv.writer(csv_file)
-            writer.writerow(('Full Name', 'Age'))
-            writer.writerows(ROWS)
-            blob.upload_from_file(
-                csv_file, rewind=True, content_type='text/csv')
-
-        self.to_delete.insert(0, blob)
-
-        dataset = Config.CLIENT.dataset(
-            _make_dataset_name('load_gcs_then_dump'))
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age])
-        table.create()
-        self.to_delete.insert(0, table)
-
-        job = Config.CLIENT.load_table_from_storage(
-            'bq_load_storage_test_' + local_id, table, GS_URL)
-        job.create_disposition = 'CREATE_NEVER'
-        job.skip_leading_rows = 1
-        job.source_format = 'CSV'
-        job.write_disposition = 'WRITE_EMPTY'
-
-        job.begin()
-
-        def _job_done(instance):
-            return instance.state in ('DONE', 'done')
-
-        # Allow for 90 seconds of "warm up" before rows visible.  See:
-        # https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataavailability
-        # 8 tries -> 1 + 2 + 4 + 8 + 16 + 32 + 64 = 127 seconds
-        retry = RetryInstanceState(_job_done, max_tries=8)
-        retry(job.reload)()
-
-        rows, _, _ = table.fetch_data()
-        by_age = operator.itemgetter(1)
-        self.assertEqual(sorted(rows, key=by_age),
-                         sorted(ROWS, key=by_age))
-
-    def test_job_cancel(self):
-        DATASET_NAME = _make_dataset_name('job_cancel')
-        JOB_NAME = 'fetch_' + DATASET_NAME
-        TABLE_NAME = 'test_table'
-        QUERY = 'SELECT * FROM %s.%s' % (DATASET_NAME, TABLE_NAME)
-
-        dataset = Config.CLIENT.dataset(DATASET_NAME)
-
-        retry_403(dataset.create)()
-        self.to_delete.append(dataset)
-
-        full_name = bigquery.SchemaField('full_name', 'STRING',
-                                         mode='REQUIRED')
-        age = bigquery.SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table(TABLE_NAME, schema=[full_name, age])
-        table.create()
-        self.to_delete.insert(0, table)
-
-        job = Config.CLIENT.run_async_query(JOB_NAME, QUERY)
-        job.begin()
-        job.cancel()
-
-        def _job_done(instance):
-            return instance.state in ('DONE', 'done')
-
-        retry = RetryInstanceState(_job_done, max_tries=8)
-        retry(job.reload)()
-
-        # The `cancel` API doesn't leave any reliable traces on
-        # the status of the job resource, so we can't really assert for
-        # them here.  The best we can do is not that the API call didn't
-        # raise an error, and that the job completed (in the `retry()`
-        # above).
diff --git a/system_tests/bigtable.py b/system_tests/bigtable.py
deleted file mode 100644
index bcb4c41965c2..000000000000
--- a/system_tests/bigtable.py
+++ /dev/null
@@ -1,473 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import datetime
-import operator
-import os
-
-import unittest
-
-from google.cloud._helpers import _datetime_from_microseconds
-from google.cloud._helpers import _microseconds_from_datetime
-from google.cloud._helpers import UTC
-from google.cloud.bigtable.client import Client
-from google.cloud.bigtable.column_family import MaxVersionsGCRule
-from google.cloud.bigtable.row_filters import ApplyLabelFilter
-from google.cloud.bigtable.row_filters import ColumnQualifierRegexFilter
-from google.cloud.bigtable.row_filters import RowFilterChain
-from google.cloud.bigtable.row_filters import RowFilterUnion
-from google.cloud.bigtable.row_data import Cell
-from google.cloud.bigtable.row_data import PartialRowData
-from google.cloud.environment_vars import BIGTABLE_EMULATOR
-
-from retry import RetryErrors
-from retry import RetryResult
-from system_test_utils import EmulatorCreds
-from system_test_utils import unique_resource_id
-
-
-LOCATION_ID = 'us-central1-c'
-INSTANCE_ID = 'g-c-p' + unique_resource_id('-')
-TABLE_ID = 'google-cloud-python-test-table'
-COLUMN_FAMILY_ID1 = u'col-fam-id1'
-COLUMN_FAMILY_ID2 = u'col-fam-id2'
-COL_NAME1 = b'col-name1'
-COL_NAME2 = b'col-name2'
-COL_NAME3 = b'col-name3-but-other-fam'
-CELL_VAL1 = b'cell-val'
-CELL_VAL2 = b'cell-val-newer'
-CELL_VAL3 = b'altcol-cell-val'
-CELL_VAL4 = b'foo'
-ROW_KEY = b'row-key'
-ROW_KEY_ALT = b'row-key-alt'
-EXISTING_INSTANCES = []
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-    INSTANCE = None
-    IN_EMULATOR = False
-
-
-def _wait_until_complete(operation, max_attempts=5):
-    """Wait until an operation has completed.
-
-    :type operation: :class:`google.cloud.bigtable.instance.Operation`
-    :param operation: Operation that has not complete.
-
-    :type max_attempts: int
-    :param max_attempts: (Optional) The maximum number of times to check if
-                         the operation has complete. Defaults to 5.
-
-    :rtype: bool
-    :returns: Boolean indicating if the operation is complete.
-    """
-
-    def _operation_complete(result):
-        return result
-
-    retry = RetryResult(_operation_complete, max_tries=max_attempts)
-    return retry(operation.poll)()
-
-
-def _retry_on_unavailable(exc):
-    """Retry only errors whose status code is 'UNAVAILABLE'."""
-    from grpc import StatusCode
-    return exc.code() == StatusCode.UNAVAILABLE
-
-
-def setUpModule():
-    from google.cloud.exceptions import GrpcRendezvous
-
-    Config.IN_EMULATOR = os.getenv(BIGTABLE_EMULATOR) is not None
-
-    if Config.IN_EMULATOR:
-        credentials = EmulatorCreds()
-        Config.CLIENT = Client(admin=True, credentials=credentials)
-    else:
-        Config.CLIENT = Client(admin=True)
-
-    Config.INSTANCE = Config.CLIENT.instance(INSTANCE_ID, LOCATION_ID)
-
-    if not Config.IN_EMULATOR:
-        retry = RetryErrors(GrpcRendezvous,
-                            error_predicate=_retry_on_unavailable)
-        instances, failed_locations = retry(Config.CLIENT.list_instances)()
-
-        if len(failed_locations) != 0:
-            raise ValueError('List instances failed in module set up.')
-
-        EXISTING_INSTANCES[:] = instances
-
-        # After listing, create the test instance.
-        created_op = Config.INSTANCE.create()
-        if not _wait_until_complete(created_op):
-            raise RuntimeError('Instance creation exceed 5 seconds.')
-
-
-def tearDownModule():
-    if not Config.IN_EMULATOR:
-        Config.INSTANCE.delete()
-
-
-class TestInstanceAdminAPI(unittest.TestCase):
-
-    def setUp(self):
-        if Config.IN_EMULATOR:
-            self.skipTest(
-                'Instance Admin API not supported in Bigtable emulator')
-        self.instances_to_delete = []
-
-    def tearDown(self):
-        for instance in self.instances_to_delete:
-            instance.delete()
-
-    def test_list_instances(self):
-        instances, failed_locations = Config.CLIENT.list_instances()
-        self.assertEqual(failed_locations, [])
-        # We have added one new instance in `setUpModule`.
-        self.assertEqual(len(instances), len(EXISTING_INSTANCES) + 1)
-        for instance in instances:
-            instance_existence = (instance in EXISTING_INSTANCES or
-                                  instance == Config.INSTANCE)
-            self.assertTrue(instance_existence)
-
-    def test_reload(self):
-        # Use same arguments as Config.INSTANCE (created in `setUpModule`)
-        # so we can use reload() on a fresh instance.
-        instance = Config.CLIENT.instance(INSTANCE_ID, LOCATION_ID)
-        # Make sure metadata unset before reloading.
-        instance.display_name = None
-
-        instance.reload()
-        self.assertEqual(instance.display_name, Config.INSTANCE.display_name)
-
-    def test_create_instance(self):
-        ALT_INSTANCE_ID = 'new' + unique_resource_id('-')
-        instance = Config.CLIENT.instance(ALT_INSTANCE_ID, LOCATION_ID)
-        operation = instance.create()
-        # Make sure this instance gets deleted after the test case.
-        self.instances_to_delete.append(instance)
-
-        # We want to make sure the operation completes.
-        self.assertTrue(_wait_until_complete(operation))
-
-        # Create a new instance instance and make sure it is the same.
-        instance_alt = Config.CLIENT.instance(ALT_INSTANCE_ID, LOCATION_ID)
-        instance_alt.reload()
-
-        self.assertEqual(instance, instance_alt)
-        self.assertEqual(instance.display_name, instance_alt.display_name)
-
-    def test_update(self):
-        OLD_DISPLAY_NAME = Config.INSTANCE.display_name
-        NEW_DISPLAY_NAME = 'Foo Bar Baz'
-        Config.INSTANCE.display_name = NEW_DISPLAY_NAME
-        Config.INSTANCE.update()
-
-        # Create a new instance instance and reload it.
-        instance_alt = Config.CLIENT.instance(INSTANCE_ID, None)
-        self.assertNotEqual(instance_alt.display_name, NEW_DISPLAY_NAME)
-        instance_alt.reload()
-        self.assertEqual(instance_alt.display_name, NEW_DISPLAY_NAME)
-
-        # Make sure to put the instance back the way it was for the
-        # other test cases.
-        Config.INSTANCE.display_name = OLD_DISPLAY_NAME
-        Config.INSTANCE.update()
-
-
-class TestTableAdminAPI(unittest.TestCase):
-
-    @classmethod
-    def setUpClass(cls):
-        cls._table = Config.INSTANCE.table(TABLE_ID)
-        cls._table.create()
-
-    @classmethod
-    def tearDownClass(cls):
-        cls._table.delete()
-
-    def setUp(self):
-        self.tables_to_delete = []
-
-    def tearDown(self):
-        for table in self.tables_to_delete:
-            table.delete()
-
-    def test_list_tables(self):
-        # Since `Config.INSTANCE` is newly created in `setUpModule`, the table
-        # created in `setUpClass` here will be the only one.
-        tables = Config.INSTANCE.list_tables()
-        self.assertEqual(tables, [self._table])
-
-    def test_create_table(self):
-        temp_table_id = 'foo-bar-baz-table'
-        temp_table = Config.INSTANCE.table(temp_table_id)
-        temp_table.create()
-        self.tables_to_delete.append(temp_table)
-
-        # First, create a sorted version of our expected result.
-        name_attr = operator.attrgetter('name')
-        expected_tables = sorted([temp_table, self._table], key=name_attr)
-
-        # Then query for the tables in the instance and sort them by
-        # name as well.
-        tables = Config.INSTANCE.list_tables()
-        sorted_tables = sorted(tables, key=name_attr)
-        self.assertEqual(sorted_tables, expected_tables)
-
-    def test_create_column_family(self):
-        temp_table_id = 'foo-bar-baz-table'
-        temp_table = Config.INSTANCE.table(temp_table_id)
-        temp_table.create()
-        self.tables_to_delete.append(temp_table)
-
-        self.assertEqual(temp_table.list_column_families(), {})
-        gc_rule = MaxVersionsGCRule(1)
-        column_family = temp_table.column_family(COLUMN_FAMILY_ID1,
-                                                 gc_rule=gc_rule)
-        column_family.create()
-
-        col_fams = temp_table.list_column_families()
-
-        self.assertEqual(len(col_fams), 1)
-        retrieved_col_fam = col_fams[COLUMN_FAMILY_ID1]
-        self.assertIs(retrieved_col_fam._table, column_family._table)
-        self.assertEqual(retrieved_col_fam.column_family_id,
-                         column_family.column_family_id)
-        self.assertEqual(retrieved_col_fam.gc_rule, gc_rule)
-
-    def test_update_column_family(self):
-        temp_table_id = 'foo-bar-baz-table'
-        temp_table = Config.INSTANCE.table(temp_table_id)
-        temp_table.create()
-        self.tables_to_delete.append(temp_table)
-
-        gc_rule = MaxVersionsGCRule(1)
-        column_family = temp_table.column_family(COLUMN_FAMILY_ID1,
-                                                 gc_rule=gc_rule)
-        column_family.create()
-
-        # Check that our created table is as expected.
-        col_fams = temp_table.list_column_families()
-        self.assertEqual(col_fams, {COLUMN_FAMILY_ID1: column_family})
-
-        # Update the column family's GC rule and then try to update.
-        column_family.gc_rule = None
-        column_family.update()
-
-        # Check that the update has propagated.
-        col_fams = temp_table.list_column_families()
-        self.assertIsNone(col_fams[COLUMN_FAMILY_ID1].gc_rule)
-
-    def test_delete_column_family(self):
-        temp_table_id = 'foo-bar-baz-table'
-        temp_table = Config.INSTANCE.table(temp_table_id)
-        temp_table.create()
-        self.tables_to_delete.append(temp_table)
-
-        self.assertEqual(temp_table.list_column_families(), {})
-        column_family = temp_table.column_family(COLUMN_FAMILY_ID1)
-        column_family.create()
-
-        # Make sure the family is there before deleting it.
-        col_fams = temp_table.list_column_families()
-        self.assertEqual(list(col_fams.keys()), [COLUMN_FAMILY_ID1])
-
-        column_family.delete()
-        # Make sure we have successfully deleted it.
-        self.assertEqual(temp_table.list_column_families(), {})
-
-
-class TestDataAPI(unittest.TestCase):
-
-    @classmethod
-    def setUpClass(cls):
-        cls._table = table = Config.INSTANCE.table(TABLE_ID)
-        table.create()
-        table.column_family(COLUMN_FAMILY_ID1).create()
-        table.column_family(COLUMN_FAMILY_ID2).create()
-
-    @classmethod
-    def tearDownClass(cls):
-        # Will also delete any data contained in the table.
-        cls._table.delete()
-
-    def _maybe_emulator_skip(self, message):
-        # NOTE: This method is necessary because ``Config.IN_EMULATOR``
-        #       is set at runtime rather than import time, which means we
-        #       can't use the @unittest.skipIf decorator.
-        if Config.IN_EMULATOR:
-            self.skipTest(message)
-
-    def setUp(self):
-        self.rows_to_delete = []
-
-    def tearDown(self):
-        for row in self.rows_to_delete:
-            row.clear()
-            row.delete()
-            row.commit()
-
-    def _write_to_row(self, row1=None, row2=None, row3=None, row4=None):
-        timestamp1 = datetime.datetime.utcnow().replace(tzinfo=UTC)
-        timestamp1_micros = _microseconds_from_datetime(timestamp1)
-        # Truncate to millisecond granularity.
-        timestamp1_micros -= (timestamp1_micros % 1000)
-        timestamp1 = _datetime_from_microseconds(timestamp1_micros)
-        # 1000 microseconds is a millisecond
-        timestamp2 = timestamp1 + datetime.timedelta(microseconds=1000)
-        timestamp3 = timestamp1 + datetime.timedelta(microseconds=2000)
-        timestamp4 = timestamp1 + datetime.timedelta(microseconds=3000)
-        if row1 is not None:
-            row1.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL1,
-                          timestamp=timestamp1)
-        if row2 is not None:
-            row2.set_cell(COLUMN_FAMILY_ID1, COL_NAME1, CELL_VAL2,
-                          timestamp=timestamp2)
-        if row3 is not None:
-            row3.set_cell(COLUMN_FAMILY_ID1, COL_NAME2, CELL_VAL3,
-                          timestamp=timestamp3)
-        if row4 is not None:
-            row4.set_cell(COLUMN_FAMILY_ID2, COL_NAME3, CELL_VAL4,
-                          timestamp=timestamp4)
-
-        # Create the cells we will check.
-        cell1 = Cell(CELL_VAL1, timestamp1)
-        cell2 = Cell(CELL_VAL2, timestamp2)
-        cell3 = Cell(CELL_VAL3, timestamp3)
-        cell4 = Cell(CELL_VAL4, timestamp4)
-        return cell1, cell2, cell3, cell4
-
-    def test_read_row(self):
-        row = self._table.row(ROW_KEY)
-        self.rows_to_delete.append(row)
-
-        cell1, cell2, cell3, cell4 = self._write_to_row(row, row, row, row)
-        row.commit()
-
-        # Read back the contents of the row.
-        partial_row_data = self._table.read_row(ROW_KEY)
-        self.assertEqual(partial_row_data.row_key, ROW_KEY)
-
-        # Check the cells match.
-        ts_attr = operator.attrgetter('timestamp')
-        expected_row_contents = {
-            COLUMN_FAMILY_ID1: {
-                COL_NAME1: sorted([cell1, cell2], key=ts_attr, reverse=True),
-                COL_NAME2: [cell3],
-            },
-            COLUMN_FAMILY_ID2: {
-                COL_NAME3: [cell4],
-            },
-        }
-        self.assertEqual(partial_row_data.cells, expected_row_contents)
-
-    def test_read_rows(self):
-        row = self._table.row(ROW_KEY)
-        row_alt = self._table.row(ROW_KEY_ALT)
-        self.rows_to_delete.extend([row, row_alt])
-
-        cell1, cell2, cell3, cell4 = self._write_to_row(row, row_alt,
-                                                        row, row_alt)
-        row.commit()
-        row_alt.commit()
-
-        rows_data = self._table.read_rows()
-        self.assertEqual(rows_data.rows, {})
-        rows_data.consume_all()
-
-        # NOTE: We should refrain from editing protected data on instances.
-        #       Instead we should make the values public or provide factories
-        #       for constructing objects with them.
-        row_data = PartialRowData(ROW_KEY)
-        row_data._chunks_encountered = True
-        row_data._committed = True
-        row_data._cells = {
-            COLUMN_FAMILY_ID1: {
-                COL_NAME1: [cell1],
-                COL_NAME2: [cell3],
-            },
-        }
-
-        row_alt_data = PartialRowData(ROW_KEY_ALT)
-        row_alt_data._chunks_encountered = True
-        row_alt_data._committed = True
-        row_alt_data._cells = {
-            COLUMN_FAMILY_ID1: {
-                COL_NAME1: [cell2],
-            },
-            COLUMN_FAMILY_ID2: {
-                COL_NAME3: [cell4],
-            },
-        }
-
-        expected_rows = {
-            ROW_KEY: row_data,
-            ROW_KEY_ALT: row_alt_data,
-        }
-        self.assertEqual(rows_data.rows, expected_rows)
-
-    def test_read_with_label_applied(self):
-        self._maybe_emulator_skip('Labels not supported by Bigtable emulator')
-        row = self._table.row(ROW_KEY)
-        self.rows_to_delete.append(row)
-
-        cell1, _, cell3, _ = self._write_to_row(row, None, row)
-        row.commit()
-
-        # Combine a label with column 1.
-        label1 = u'label-red'
-        label1_filter = ApplyLabelFilter(label1)
-        col1_filter = ColumnQualifierRegexFilter(COL_NAME1)
-        chain1 = RowFilterChain(filters=[col1_filter, label1_filter])
-
-        # Combine a label with column 2.
-        label2 = u'label-blue'
-        label2_filter = ApplyLabelFilter(label2)
-        col2_filter = ColumnQualifierRegexFilter(COL_NAME2)
-        chain2 = RowFilterChain(filters=[col2_filter, label2_filter])
-
-        # Bring our two labeled columns together.
-        row_filter = RowFilterUnion(filters=[chain1, chain2])
-        partial_row_data = self._table.read_row(ROW_KEY, filter_=row_filter)
-        self.assertEqual(partial_row_data.row_key, ROW_KEY)
-
-        cells_returned = partial_row_data.cells
-        col_fam1 = cells_returned.pop(COLUMN_FAMILY_ID1)
-        # Make sure COLUMN_FAMILY_ID1 was the only key.
-        self.assertEqual(len(cells_returned), 0)
-
-        cell1_new, = col_fam1.pop(COL_NAME1)
-        cell3_new, = col_fam1.pop(COL_NAME2)
-        # Make sure COL_NAME1 and COL_NAME2 were the only keys.
-        self.assertEqual(len(col_fam1), 0)
-
-        # Check that cell1 has matching values and gained a label.
-        self.assertEqual(cell1_new.value, cell1.value)
-        self.assertEqual(cell1_new.timestamp, cell1.timestamp)
-        self.assertEqual(cell1.labels, [])
-        self.assertEqual(cell1_new.labels, [label1])
-
-        # Check that cell3 has matching values and gained a label.
-        self.assertEqual(cell3_new.value, cell3.value)
-        self.assertEqual(cell3_new.timestamp, cell3.timestamp)
-        self.assertEqual(cell3.labels, [])
-        self.assertEqual(cell3_new.labels, [label2])
diff --git a/system_tests/clear_datastore.py b/system_tests/clear_datastore.py
deleted file mode 100644
index 0bbccd95d423..000000000000
--- a/system_tests/clear_datastore.py
+++ /dev/null
@@ -1,105 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Script to populate datastore with system test data."""
-
-from __future__ import print_function
-
-import os
-
-import six
-
-from google.cloud import datastore
-
-
-FETCH_MAX = 20
-ALL_KINDS = (
-    'Character',
-    'Company',
-    'Kind',
-    'Person',
-    'Post',
-)
-TRANSACTION_MAX_GROUPS = 5
-
-
-def print_func(message):
-    if os.getenv('GOOGLE_CLOUD_NO_PRINT') != 'true':
-        print(message)
-
-
-def fetch_keys(kind, client, fetch_max=FETCH_MAX, query=None, cursor=None):
-    if query is None:
-        query = client.query(kind=kind)
-        query.keys_only()
-
-    iterator = query.fetch(limit=fetch_max, start_cursor=cursor)
-
-    entities, _, cursor = iterator.next_page()
-    return query, entities, cursor
-
-
-def get_ancestors(entities):
-    # NOTE: A key will always have at least one path element.
-    key_roots = [entity.key.flat_path[:2] for entity in entities]
-    # Return the unique roots.
-    return list(set(key_roots))
-
-
-def remove_kind(kind, client):
-    results = []
-
-    query, curr_results, cursor = fetch_keys(kind, client)
-    results.extend(curr_results)
-    while curr_results:
-        query, curr_results, cursor = fetch_keys(
-            kind, client, query=query, cursor=cursor)
-        results.extend(curr_results)
-
-    if not results:
-        return
-
-    delete_outside_transaction = False
-    with client.transaction():
-        # Now that we have all results, we seek to delete.
-        print_func('Deleting keys:')
-        print_func(results)
-
-        ancestors = get_ancestors(results)
-        if len(ancestors) > TRANSACTION_MAX_GROUPS:
-            delete_outside_transaction = True
-        else:
-            client.delete_multi([result.key for result in results])
-
-    if delete_outside_transaction:
-        client.delete_multi([result.key for result in results])
-
-
-def remove_all_entities(client=None):
-    if client is None:
-        # Get a client that uses the test dataset.
-        client = datastore.Client()
-    for kind in ALL_KINDS:
-        remove_kind(kind, client)
-
-
-if __name__ == '__main__':
-    print_func('This command will remove all entities for '
-               'the following kinds:')
-    print_func('\n'.join('- ' + val for val in ALL_KINDS))
-    response = six.moves.input('Is this OK [y/n]? ')
-    if response.lower() == 'y':
-        remove_all_entities()
-    else:
-        print_func('Doing nothing.')
diff --git a/system_tests/datastore.py b/system_tests/datastore.py
deleted file mode 100644
index 518db17e38db..000000000000
--- a/system_tests/datastore.py
+++ /dev/null
@@ -1,490 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import datetime
-import os
-import unittest
-
-import httplib2
-
-from google.cloud._helpers import UTC
-from google.cloud import datastore
-from google.cloud.datastore.helpers import GeoPoint
-from google.cloud.environment_vars import GCD_DATASET
-from google.cloud.exceptions import Conflict
-
-import clear_datastore
-import populate_datastore
-from system_test_utils import EmulatorCreds
-from system_test_utils import unique_resource_id
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-
-
-def clone_client(client):
-    # Fool the Client constructor to avoid creating a new connection.
-    cloned_client = datastore.Client(project=client.project,
-                                     namespace=client.namespace,
-                                     http=object())
-    cloned_client.connection = client.connection
-    return cloned_client
-
-
-def setUpModule():
-    emulator_dataset = os.getenv(GCD_DATASET)
-    # Isolated namespace so concurrent test runs don't collide.
-    test_namespace = 'ns' + unique_resource_id()
-    if emulator_dataset is None:
-        Config.CLIENT = datastore.Client(namespace=test_namespace)
-    else:
-        credentials = EmulatorCreds()
-        http = httplib2.Http()  # Un-authorized.
-        Config.CLIENT = datastore.Client(project=emulator_dataset,
-                                         namespace=test_namespace,
-                                         credentials=credentials,
-                                         http=http)
-
-
-class TestDatastore(unittest.TestCase):
-
-    def setUp(self):
-        self.case_entities_to_delete = []
-
-    def tearDown(self):
-        with Config.CLIENT.transaction():
-            keys = [entity.key for entity in self.case_entities_to_delete]
-            Config.CLIENT.delete_multi(keys)
-
-
-class TestDatastoreAllocateIDs(TestDatastore):
-
-    def test_allocate_ids(self):
-        num_ids = 10
-        allocated_keys = Config.CLIENT.allocate_ids(
-            Config.CLIENT.key('Kind'), num_ids)
-        self.assertEqual(len(allocated_keys), num_ids)
-
-        unique_ids = set()
-        for key in allocated_keys:
-            unique_ids.add(key.id)
-            self.assertIsNone(key.name)
-            self.assertNotEqual(key.id, None)
-
-        self.assertEqual(len(unique_ids), num_ids)
-
-
-class TestDatastoreSave(TestDatastore):
-
-    @classmethod
-    def setUpClass(cls):
-        cls.PARENT = Config.CLIENT.key('Blog', 'PizzaMan')
-
-    def _get_post(self, id_or_name=None, post_content=None):
-        post_content = post_content or {
-            'title': u'How to make the perfect pizza in your grill',
-            'tags': [u'pizza', u'grill'],
-            'publishedAt': datetime.datetime(2001, 1, 1, tzinfo=UTC),
-            'author': u'Silvano',
-            'isDraft': False,
-            'wordCount': 400,
-            'rating': 5.0,
-        }
-        # Create an entity with the given content.
-        # NOTE: Using a parent to ensure consistency for query
-        #       in `test_empty_kind`.
-        key = Config.CLIENT.key('Post', parent=self.PARENT)
-        entity = datastore.Entity(key=key)
-        entity.update(post_content)
-
-        # Update the entity key.
-        if id_or_name is not None:
-            entity.key = entity.key.completed_key(id_or_name)
-
-        return entity
-
-    def _generic_test_post(self, name=None, key_id=None):
-        entity = self._get_post(id_or_name=(name or key_id))
-        Config.CLIENT.put(entity)
-
-        # Register entity to be deleted.
-        self.case_entities_to_delete.append(entity)
-
-        if name is not None:
-            self.assertEqual(entity.key.name, name)
-        if key_id is not None:
-            self.assertEqual(entity.key.id, key_id)
-        retrieved_entity = Config.CLIENT.get(entity.key)
-        # Check the given and retrieved are the the same.
-        self.assertEqual(retrieved_entity, entity)
-
-    def test_post_with_name(self):
-        self._generic_test_post(name='post1')
-
-    def test_post_with_id(self):
-        self._generic_test_post(key_id=123456789)
-
-    def test_post_with_generated_id(self):
-        self._generic_test_post()
-
-    def test_save_multiple(self):
-        with Config.CLIENT.transaction() as xact:
-            entity1 = self._get_post()
-            xact.put(entity1)
-            # Register entity to be deleted.
-            self.case_entities_to_delete.append(entity1)
-
-            second_post_content = {
-                'title': u'How to make the perfect homemade pasta',
-                'tags': [u'pasta', u'homemade'],
-                'publishedAt': datetime.datetime(2001, 1, 1),
-                'author': u'Silvano',
-                'isDraft': False,
-                'wordCount': 450,
-                'rating': 4.5,
-            }
-            entity2 = self._get_post(post_content=second_post_content)
-            xact.put(entity2)
-            # Register entity to be deleted.
-            self.case_entities_to_delete.append(entity2)
-
-        keys = [entity1.key, entity2.key]
-        matches = Config.CLIENT.get_multi(keys)
-        self.assertEqual(len(matches), 2)
-
-    def test_empty_kind(self):
-        query = Config.CLIENT.query(kind='Post')
-        query.ancestor = self.PARENT
-        posts = list(query.fetch(limit=2))
-        self.assertEqual(posts, [])
-
-    def test_all_value_types(self):
-        key = Config.CLIENT.key('TestPanObject', 1234)
-        entity = datastore.Entity(key=key)
-        entity['timestamp'] = datetime.datetime(2014, 9, 9, tzinfo=UTC)
-        key_stored = Config.CLIENT.key('SavedKey', 'right-here')
-        entity['key'] = key_stored
-        entity['truthy'] = True
-        entity['float'] = 2.718281828
-        entity['int'] = 3735928559
-        entity['words'] = u'foo'
-        entity['blob'] = b'seekretz'
-        entity_stored = datastore.Entity(key=key_stored)
-        entity_stored['hi'] = 'bye'
-        entity['nested'] = entity_stored
-        entity['items'] = [1, 2, 3]
-        entity['geo'] = GeoPoint(1.0, 2.0)
-        entity['nothing_here'] = None
-
-        # Store the entity.
-        self.case_entities_to_delete.append(entity)
-        Config.CLIENT.put(entity)
-
-        # Check the original and retrieved are the the same.
-        retrieved_entity = Config.CLIENT.get(entity.key)
-        self.assertEqual(retrieved_entity, entity)
-
-
-class TestDatastoreSaveKeys(TestDatastore):
-
-    def test_save_key_self_reference(self):
-        parent_key = Config.CLIENT.key('Residence', 'NewYork')
-        key = Config.CLIENT.key('Person', 'name', parent=parent_key)
-        entity = datastore.Entity(key=key)
-        entity['fullName'] = u'Full name'
-        entity['linkedTo'] = key  # Self reference.
-
-        Config.CLIENT.put(entity)
-        self.case_entities_to_delete.append(entity)
-
-        query = Config.CLIENT.query(kind='Person')
-        # Adding ancestor to ensure consistency.
-        query.ancestor = parent_key
-        query.add_filter('linkedTo', '=', key)
-
-        stored_persons = list(query.fetch(limit=2))
-        self.assertEqual(stored_persons, [entity])
-
-
-class TestDatastoreQuery(TestDatastore):
-
-    @classmethod
-    def setUpClass(cls):
-        cls.CLIENT = clone_client(Config.CLIENT)
-        # Remove the namespace from the cloned client, since these
-        # query tests rely on the entities to be already stored and indexed,
-        # hence ``test_namespace`` set at runtime can't be used.
-        cls.CLIENT.namespace = None
-
-        # In the emulator, re-populating the datastore is cheap.
-        if os.getenv(GCD_DATASET) is not None:
-            # Populate the datastore with the cloned client.
-            populate_datastore.add_characters(client=cls.CLIENT)
-
-        cls.CHARACTERS = populate_datastore.CHARACTERS
-        # Use the client for this test instead of the global.
-        cls.ANCESTOR_KEY = cls.CLIENT.key(*populate_datastore.ANCESTOR)
-
-    @classmethod
-    def tearDownClass(cls):
-        # In the emulator, destroy the query entities.
-        if os.getenv(GCD_DATASET) is not None:
-            # Use the client for this test instead of the global.
-            clear_datastore.remove_all_entities(client=cls.CLIENT)
-
-    def _base_query(self):
-        # Use the client for this test instead of the global.
-        return self.CLIENT.query(kind='Character',
-                                 ancestor=self.ANCESTOR_KEY)
-
-    def test_limit_queries(self):
-        limit = 5
-        query = self._base_query()
-
-        # Fetch characters.
-        iterator = query.fetch(limit=limit)
-        character_entities, _, cursor = iterator.next_page()
-        self.assertEqual(len(character_entities), limit)
-
-        # Check cursor after fetch.
-        self.assertIsNotNone(cursor)
-
-        # Fetch remaining of characters.
-        new_character_entities = list(iterator)
-        characters_remaining = len(self.CHARACTERS) - limit
-        self.assertEqual(len(new_character_entities), characters_remaining)
-
-    def test_query_simple_filter(self):
-        query = self._base_query()
-        query.add_filter('appearances', '>=', 20)
-        expected_matches = 6
-        # We expect 6, but allow the query to get 1 extra.
-        entities = list(query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-    def test_query_multiple_filters(self):
-        query = self._base_query()
-        query.add_filter('appearances', '>=', 26)
-        query.add_filter('family', '=', 'Stark')
-        expected_matches = 4
-        # We expect 4, but allow the query to get 1 extra.
-        entities = list(query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-    def test_ancestor_query(self):
-        filtered_query = self._base_query()
-
-        expected_matches = 8
-        # We expect 8, but allow the query to get 1 extra.
-        entities = list(filtered_query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-    def test_query_key_filter(self):
-        # Use the client for this test instead of the global.
-        rickard_key = self.CLIENT.key(*populate_datastore.RICKARD)
-
-        query = self._base_query()
-        query.key_filter(rickard_key)
-        expected_matches = 1
-        # We expect 1, but allow the query to get 1 extra.
-        entities = list(query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-    def test_ordered_query(self):
-        query = self._base_query()
-        query.order = 'appearances'
-        expected_matches = 8
-        # We expect 8, but allow the query to get 1 extra.
-        entities = list(query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-        # Actually check the ordered data returned.
-        self.assertEqual(entities[0]['name'], self.CHARACTERS[0]['name'])
-        self.assertEqual(entities[7]['name'], self.CHARACTERS[3]['name'])
-
-    def test_projection_query(self):
-        filtered_query = self._base_query()
-        filtered_query.projection = ['name', 'family']
-        filtered_query.order = ['name', 'family']
-
-        # NOTE: There are 9 responses because of Catelyn. She has both
-        #       Stark and Tully as her families, hence occurs twice in
-        #       the results.
-        expected_matches = 9
-        # We expect 9, but allow the query to get 1 extra.
-        entities = list(filtered_query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-        arya_entity = entities[0]
-        catelyn_tully_entity = entities[3]
-        sansa_entity = entities[8]
-
-        arya_dict = dict(arya_entity)
-        self.assertEqual(arya_dict, {'name': 'Arya', 'family': 'Stark'})
-
-        catelyn_stark_entity = entities[2]
-        catelyn_stark_dict = dict(catelyn_stark_entity)
-        self.assertEqual(catelyn_stark_dict,
-                         {'name': 'Catelyn', 'family': 'Stark'})
-
-        catelyn_tully_dict = dict(catelyn_tully_entity)
-        self.assertEqual(catelyn_tully_dict,
-                         {'name': 'Catelyn', 'family': 'Tully'})
-
-        # Check both Catelyn keys are the same.
-        self.assertEqual(catelyn_stark_entity.key, catelyn_tully_entity.key)
-
-        sansa_dict = dict(sansa_entity)
-        self.assertEqual(sansa_dict, {'name': 'Sansa', 'family': 'Stark'})
-
-    def test_query_paginate_with_offset(self):
-        page_query = self._base_query()
-        page_query.order = 'appearances'
-        offset = 2
-        limit = 3
-        iterator = page_query.fetch(limit=limit, offset=offset)
-
-        # Fetch characters.
-        entities, _, cursor = iterator.next_page()
-        self.assertEqual(len(entities), limit)
-        self.assertEqual(entities[0]['name'], 'Robb')
-        self.assertEqual(entities[1]['name'], 'Bran')
-        self.assertEqual(entities[2]['name'], 'Catelyn')
-
-        # Fetch next set of characters.
-        new_iterator = page_query.fetch(limit=limit, offset=0,
-                                        start_cursor=cursor)
-        entities = list(new_iterator)
-        self.assertEqual(len(entities), limit)
-        self.assertEqual(entities[0]['name'], 'Sansa')
-        self.assertEqual(entities[1]['name'], 'Jon Snow')
-        self.assertEqual(entities[2]['name'], 'Arya')
-
-    def test_query_paginate_with_start_cursor(self):
-        page_query = self._base_query()
-        page_query.order = 'appearances'
-        limit = 3
-        offset = 2
-        iterator = page_query.fetch(limit=limit, offset=offset)
-
-        # Fetch characters.
-        entities, _, cursor = iterator.next_page()
-        self.assertEqual(len(entities), limit)
-
-        # Use cursor to create a fresh query.
-        fresh_query = self._base_query()
-        fresh_query.order = 'appearances'
-
-        new_entities = list(fresh_query.fetch(start_cursor=cursor,
-                                              limit=limit))
-        characters_remaining = len(self.CHARACTERS) - limit - offset
-        self.assertEqual(len(new_entities), characters_remaining)
-        self.assertEqual(new_entities[0]['name'], 'Sansa')
-        self.assertEqual(new_entities[2]['name'], 'Arya')
-
-    def test_query_distinct_on(self):
-        query = self._base_query()
-        query.distinct_on = ['alive']
-
-        expected_matches = 2
-        # We expect 2, but allow the query to get 1 extra.
-        entities = list(query.fetch(limit=expected_matches + 1))
-        self.assertEqual(len(entities), expected_matches)
-
-        self.assertEqual(entities[0]['name'], 'Catelyn')
-        self.assertEqual(entities[1]['name'], 'Arya')
-
-
-class TestDatastoreTransaction(TestDatastore):
-
-    def test_transaction_via_with_statement(self):
-        entity = datastore.Entity(key=Config.CLIENT.key('Company', 'Google'))
-        entity['url'] = u'www.google.com'
-
-        with Config.CLIENT.transaction() as xact:
-            result = Config.CLIENT.get(entity.key)
-            if result is None:
-                xact.put(entity)
-                self.case_entities_to_delete.append(entity)
-
-        # This will always return after the transaction.
-        retrieved_entity = Config.CLIENT.get(entity.key)
-        self.case_entities_to_delete.append(retrieved_entity)
-        self.assertEqual(retrieved_entity, entity)
-
-    def test_transaction_via_explicit_begin_get_commit(self):
-        # See
-        # github.com/GoogleCloudPlatform/google-cloud-python/issues/1859
-        # Note that this example lacks the threading which provokes the race
-        # condition in that issue:  we are basically just exercising the
-        # "explict" path for using transactions.
-        BEFORE_1 = 100
-        BEFORE_2 = 0
-        TRANSFER_AMOUNT = 40
-        key1 = Config.CLIENT.key('account', '123')
-        account1 = datastore.Entity(key=key1)
-        account1['balance'] = BEFORE_1
-        key2 = Config.CLIENT.key('account', '234')
-        account2 = datastore.Entity(key=key2)
-        account2['balance'] = BEFORE_2
-        Config.CLIENT.put_multi([account1, account2])
-        self.case_entities_to_delete.append(account1)
-        self.case_entities_to_delete.append(account2)
-
-        xact = Config.CLIENT.transaction()
-        xact.begin()
-        from_account = Config.CLIENT.get(key1, transaction=xact)
-        to_account = Config.CLIENT.get(key2, transaction=xact)
-        from_account['balance'] -= TRANSFER_AMOUNT
-        to_account['balance'] += TRANSFER_AMOUNT
-
-        xact.put(from_account)
-        xact.put(to_account)
-        xact.commit()
-
-        after1 = Config.CLIENT.get(key1)
-        after2 = Config.CLIENT.get(key2)
-        self.assertEqual(after1['balance'], BEFORE_1 - TRANSFER_AMOUNT)
-        self.assertEqual(after2['balance'], BEFORE_2 + TRANSFER_AMOUNT)
-
-    def test_failure_with_contention(self):
-        contention_prop_name = 'baz'
-        local_client = clone_client(Config.CLIENT)
-
-        # Insert an entity which will be retrieved in a transaction
-        # and updated outside it with a contentious value.
-        key = local_client.key('BreakTxn', 1234)
-        orig_entity = datastore.Entity(key=key)
-        orig_entity['foo'] = u'bar'
-        local_client.put(orig_entity)
-        self.case_entities_to_delete.append(orig_entity)
-
-        with self.assertRaises(Conflict):
-            with local_client.transaction() as txn:
-                entity_in_txn = local_client.get(key)
-
-                # Update the original entity outside the transaction.
-                orig_entity[contention_prop_name] = u'outside'
-                Config.CLIENT.put(orig_entity)
-
-                # Try to update the entity which we already updated outside the
-                # transaction.
-                entity_in_txn[contention_prop_name] = u'inside'
-                txn.put(entity_in_txn)
diff --git a/system_tests/key.json.enc b/system_tests/key.json.enc
deleted file mode 100644
index 1444a17dcd1c..000000000000
Binary files a/system_tests/key.json.enc and /dev/null differ
diff --git a/system_tests/language.py b/system_tests/language.py
deleted file mode 100644
index 1cc4fa6e79bc..000000000000
--- a/system_tests/language.py
+++ /dev/null
@@ -1,123 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-from google.cloud import exceptions
-from google.cloud import language
-from google.cloud import storage
-
-from system_test_utils import unique_resource_id
-from retry import RetryErrors
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-    TEST_BUCKET = None
-
-
-def setUpModule():
-    Config.CLIENT = language.Client()
-    # Now create a bucket for GCS stored content.
-    storage_client = storage.Client()
-    bucket_name = 'new' + unique_resource_id()
-    Config.TEST_BUCKET = storage_client.bucket(bucket_name)
-    # 429 Too Many Requests in case API requests rate-limited.
-    retry_429 = RetryErrors(exceptions.TooManyRequests)
-    retry_429(Config.TEST_BUCKET.create)()
-
-
-def tearDownModule():
-    # 409 Conflict if the bucket is full.
-    # 429 Too Many Requests in case API requests rate-limited.
-    bucket_retry = RetryErrors(
-        (exceptions.TooManyRequests, exceptions.Conflict))
-    bucket_retry(Config.TEST_BUCKET.delete)(force=True)
-
-
-class TestLanguage(unittest.TestCase):
-
-    NAME1 = 'Michelangelo Caravaggio'
-    NAME2 = 'Italian'
-    NAME3 = 'The Calling of Saint Matthew'
-    TEXT_CONTENT = '%s, %s painter, is known for %r.' % (NAME1, NAME2, NAME3)
-
-    def setUp(self):
-        self.to_delete_by_case = []
-
-    def tearDown(self):
-        for value in self.to_delete_by_case:
-            value.delete()
-
-    def _check_analyze_entities_result(self, entities):
-        from google.cloud.language.entity import EntityType
-
-        self.assertEqual(len(entities), 3)
-        entity1, entity2, entity3 = entities
-        # Verify entity 1.
-        self.assertEqual(entity1.name, self.NAME1)
-        self.assertEqual(entity1.entity_type, EntityType.PERSON)
-        self.assertGreater(entity1.salience, 0.0)
-        self.assertEqual(entity1.mentions, [entity1.name])
-        self.assertEqual(entity1.wikipedia_url,
-                         'http://en.wikipedia.org/wiki/Caravaggio')
-        self.assertEqual(entity1.metadata, {})
-        # Verify entity 2.
-        self.assertEqual(entity2.name, self.NAME2)
-        self.assertEqual(entity2.entity_type, EntityType.LOCATION)
-        self.assertGreater(entity2.salience, 0.0)
-        self.assertEqual(entity2.mentions, [entity2.name])
-        self.assertEqual(entity2.wikipedia_url,
-                         'http://en.wikipedia.org/wiki/Italy')
-        self.assertEqual(entity2.metadata, {})
-        # Verify entity 3.
-        self.assertEqual(entity3.name, self.NAME3)
-        self.assertEqual(entity3.entity_type, EntityType.EVENT)
-        self.assertGreater(entity3.salience, 0.0)
-        self.assertEqual(entity3.mentions, [entity3.name])
-        wiki_url = ('http://en.wikipedia.org/wiki/'
-                    'The_Calling_of_St_Matthew_(Caravaggio)')
-        self.assertEqual(entity3.wikipedia_url, wiki_url)
-        self.assertEqual(entity3.metadata, {})
-
-    def test_analyze_entities(self):
-        document = Config.CLIENT.document_from_text(self.TEXT_CONTENT)
-        entities = document.analyze_entities()
-        self._check_analyze_entities_result(entities)
-
-    def test_analyze_entities_from_blob(self):
-        # Upload the text to a blob.
-        bucket_name = Config.TEST_BUCKET.name
-        blob_name = 'document.txt'
-        blob = Config.TEST_BUCKET.blob(blob_name)
-        self.to_delete_by_case.append(blob)  # Clean-up.
-        blob.upload_from_string(self.TEXT_CONTENT)
-
-        # Create a document referencing that blob.
-        gcs_url = 'gs://%s/%s' % (bucket_name, blob_name)
-        document = Config.CLIENT.document_from_url(gcs_url)
-        entities = document.analyze_entities()
-        self._check_analyze_entities_result(entities)
-
-    def test_analyze_sentiment(self):
-        positive_msg = 'Jogging is fun'
-        document = Config.CLIENT.document_from_text(positive_msg)
-        sentiment = document.analyze_sentiment()
-        self.assertEqual(sentiment.polarity, 1)
-        self.assertTrue(0.5 < sentiment.magnitude < 1.5)
diff --git a/system_tests/local_test_setup.sample b/system_tests/local_test_setup.sample
deleted file mode 100644
index 7fcd96dd3ddd..000000000000
--- a/system_tests/local_test_setup.sample
+++ /dev/null
@@ -1,4 +0,0 @@
-export GOOGLE_APPLICATION_CREDENTIALS="app_credentials.json.sample"
-export GOOGLE_CLOUD_REMOTE_FOR_LINT="upstream"
-export GOOGLE_CLOUD_BRANCH_FOR_LINT="master"
-export GOOGLE_CLOUD_TESTS_API_KEY="abcd1234"
diff --git a/system_tests/logging_.py b/system_tests/logging_.py
deleted file mode 100644
index 40bfcf3f44d1..000000000000
--- a/system_tests/logging_.py
+++ /dev/null
@@ -1,416 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import logging
-import unittest
-
-from google.cloud.exceptions import TooManyRequests
-import google.cloud.logging
-import google.cloud.logging.handlers.handlers
-from google.cloud.logging.handlers.handlers import CloudLoggingHandler
-from google.cloud.logging.handlers.transports import SyncTransport
-from google.cloud.logging import client
-
-from retry import RetryErrors
-from retry import RetryResult
-from system_test_utils import unique_resource_id
-
-_RESOURCE_ID = unique_resource_id('-')
-DEFAULT_FILTER = 'logName:syslog AND severity>=INFO'
-DEFAULT_DESCRIPTION = 'System testing'
-retry_429 = RetryErrors(TooManyRequests)
-
-
-def _retry_on_unavailable(exc):
-    """Retry only errors whose status code is 'UNAVAILABLE'."""
-    from grpc import StatusCode
-    return exc.code() == StatusCode.UNAVAILABLE
-
-
-def _has_entries(result):
-    return len(result[0]) > 0
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-
-
-def setUpModule():
-    Config.CLIENT = client.Client()
-
-
-class TestLogging(unittest.TestCase):
-
-    def setUp(self):
-        self.to_delete = []
-        self._handlers_cache = logging.getLogger().handlers[:]
-
-    def tearDown(self):
-        from google.cloud.exceptions import NotFound
-        retry = RetryErrors(NotFound)
-        for doomed in self.to_delete:
-            retry(doomed.delete)()
-        logging.getLogger().handlers = self._handlers_cache[:]
-
-    @staticmethod
-    def _logger_name():
-        return 'system-tests-logger' + unique_resource_id('-')
-
-    def _list_entries(self, logger):
-        from google.cloud.exceptions import GrpcRendezvous
-        inner = RetryResult(_has_entries)(logger.list_entries)
-        outer = RetryErrors(GrpcRendezvous, _retry_on_unavailable)(inner)
-        return outer()
-
-    def test_log_text(self):
-        TEXT_PAYLOAD = 'System test: test_log_text'
-        logger = Config.CLIENT.logger(self._logger_name())
-        self.to_delete.append(logger)
-        logger.log_text(TEXT_PAYLOAD)
-        entries, _ = self._list_entries(logger)
-        self.assertEqual(len(entries), 1)
-        self.assertEqual(entries[0].payload, TEXT_PAYLOAD)
-
-    def test_log_text_w_metadata(self):
-        TEXT_PAYLOAD = 'System test: test_log_text'
-        INSERT_ID = 'INSERTID'
-        SEVERITY = 'INFO'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = 500
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        logger = Config.CLIENT.logger(self._logger_name())
-        self.to_delete.append(logger)
-
-        logger.log_text(TEXT_PAYLOAD, insert_id=INSERT_ID, severity=SEVERITY,
-                        http_request=REQUEST)
-        entries, _ = self._list_entries(logger)
-
-        self.assertEqual(len(entries), 1)
-
-        entry = entries[0]
-        self.assertEqual(entry.payload, TEXT_PAYLOAD)
-        self.assertEqual(entry.insert_id, INSERT_ID)
-        self.assertEqual(entry.severity, SEVERITY)
-
-        request = entry.http_request
-        self.assertEqual(request['requestMethod'], METHOD)
-        self.assertEqual(request['requestUrl'], URI)
-        self.assertEqual(request['status'], STATUS)
-
-    def test_log_struct(self):
-        JSON_PAYLOAD = {
-            'message': 'System test: test_log_struct',
-            'weather': 'partly cloudy',
-        }
-        logger = Config.CLIENT.logger(self._logger_name())
-        self.to_delete.append(logger)
-
-        logger.log_struct(JSON_PAYLOAD)
-        entries, _ = self._list_entries(logger)
-
-        self.assertEqual(len(entries), 1)
-        self.assertEqual(entries[0].payload, JSON_PAYLOAD)
-
-    def test_log_handler_async(self):
-        LOG_MESSAGE = 'It was the worst of times'
-
-        handler = CloudLoggingHandler(Config.CLIENT)
-        # only create the logger to delete, hidden otherwise
-        logger = Config.CLIENT.logger(handler.name)
-        self.to_delete.append(logger)
-
-        cloud_logger = logging.getLogger(handler.name)
-        cloud_logger.addHandler(handler)
-        cloud_logger.warn(LOG_MESSAGE)
-        entries, _ = self._list_entries(logger)
-        JSON_PAYLOAD = {
-            'message': LOG_MESSAGE,
-            'python_logger': handler.name
-        }
-        self.assertEqual(len(entries), 1)
-        self.assertEqual(entries[0].payload, JSON_PAYLOAD)
-
-    def test_log_handler_sync(self):
-        LOG_MESSAGE = 'It was the best of times.'
-
-        handler = CloudLoggingHandler(Config.CLIENT,
-                                      name=self._logger_name(),
-                                      transport=SyncTransport)
-
-        # only create the logger to delete, hidden otherwise
-        logger = Config.CLIENT.logger(handler.name)
-        self.to_delete.append(logger)
-
-        LOGGER_NAME = 'mylogger'
-        cloud_logger = logging.getLogger(LOGGER_NAME)
-        cloud_logger.addHandler(handler)
-        cloud_logger.warn(LOG_MESSAGE)
-
-        entries, _ = self._list_entries(logger)
-        JSON_PAYLOAD = {
-            'message': LOG_MESSAGE,
-            'python_logger': LOGGER_NAME
-        }
-        self.assertEqual(len(entries), 1)
-        self.assertEqual(entries[0].payload, JSON_PAYLOAD)
-
-    def test_log_root_handler(self):
-        LOG_MESSAGE = 'It was the best of times.'
-
-        handler = CloudLoggingHandler(Config.CLIENT, name=self._logger_name())
-        # only create the logger to delete, hidden otherwise
-        logger = Config.CLIENT.logger(handler.name)
-        self.to_delete.append(logger)
-
-        google.cloud.logging.handlers.handlers.setup_logging(handler)
-        logging.warn(LOG_MESSAGE)
-
-        entries, _ = self._list_entries(logger)
-        JSON_PAYLOAD = {
-            'message': LOG_MESSAGE,
-            'python_logger': 'root'
-        }
-
-        self.assertEqual(len(entries), 1)
-        self.assertEqual(entries[0].payload, JSON_PAYLOAD)
-
-    def test_log_struct_w_metadata(self):
-        JSON_PAYLOAD = {
-            'message': 'System test: test_log_struct',
-            'weather': 'partly cloudy',
-        }
-        INSERT_ID = 'INSERTID'
-        SEVERITY = 'INFO'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = 500
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        logger = Config.CLIENT.logger(self._logger_name())
-        self.to_delete.append(logger)
-
-        logger.log_struct(JSON_PAYLOAD, insert_id=INSERT_ID, severity=SEVERITY,
-                          http_request=REQUEST)
-        entries, _ = self._list_entries(logger)
-
-        self.assertEqual(len(entries), 1)
-        self.assertEqual(entries[0].payload, JSON_PAYLOAD)
-        self.assertEqual(entries[0].insert_id, INSERT_ID)
-        self.assertEqual(entries[0].severity, SEVERITY)
-        request = entries[0].http_request
-        self.assertEqual(request['requestMethod'], METHOD)
-        self.assertEqual(request['requestUrl'], URI)
-        self.assertEqual(request['status'], STATUS)
-
-    def test_create_metric(self):
-        METRIC_NAME = 'test-create-metric%s' % (_RESOURCE_ID,)
-        metric = Config.CLIENT.metric(
-            METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
-        self.assertFalse(metric.exists())
-        metric.create()
-        self.to_delete.append(metric)
-        self.assertTrue(metric.exists())
-
-    def test_list_metrics(self):
-        METRIC_NAME = 'test-list-metrics%s' % (_RESOURCE_ID,)
-        metric = Config.CLIENT.metric(
-            METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
-        self.assertFalse(metric.exists())
-        before_metrics, _ = Config.CLIENT.list_metrics()
-        before_names = set(metric.name for metric in before_metrics)
-        metric.create()
-        self.to_delete.append(metric)
-        self.assertTrue(metric.exists())
-        after_metrics, _ = Config.CLIENT.list_metrics()
-        after_names = set(metric.name for metric in after_metrics)
-        self.assertEqual(after_names - before_names,
-                         set([METRIC_NAME]))
-
-    def test_reload_metric(self):
-        from google.cloud.exceptions import Conflict
-        METRIC_NAME = 'test-reload-metric%s' % (_RESOURCE_ID,)
-        retry = RetryErrors(Conflict)
-        metric = Config.CLIENT.metric(
-            METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
-        self.assertFalse(metric.exists())
-        retry(metric.create)()
-        self.to_delete.append(metric)
-        metric.filter_ = 'logName:other'
-        metric.description = 'local changes'
-        metric.reload()
-        self.assertEqual(metric.filter_, DEFAULT_FILTER)
-        self.assertEqual(metric.description, DEFAULT_DESCRIPTION)
-
-    def test_update_metric(self):
-        from google.cloud.exceptions import Conflict
-        METRIC_NAME = 'test-update-metric%s' % (_RESOURCE_ID,)
-        retry = RetryErrors(Conflict)
-        NEW_FILTER = 'logName:other'
-        NEW_DESCRIPTION = 'updated'
-        metric = Config.CLIENT.metric(
-            METRIC_NAME, DEFAULT_FILTER, DEFAULT_DESCRIPTION)
-        self.assertFalse(metric.exists())
-        retry(metric.create)()
-        self.to_delete.append(metric)
-        metric.filter_ = NEW_FILTER
-        metric.description = NEW_DESCRIPTION
-        metric.update()
-        after_metrics, _ = Config.CLIENT.list_metrics()
-        after_info = {metric.name: metric for metric in after_metrics}
-        after = after_info[METRIC_NAME]
-        self.assertEqual(after.filter_, NEW_FILTER)
-        self.assertEqual(after.description, NEW_DESCRIPTION)
-
-    def _init_storage_bucket(self):
-        from google.cloud import storage
-        BUCKET_NAME = 'g-c-python-testing%s' % (_RESOURCE_ID,)
-        BUCKET_URI = 'storage.googleapis.com/%s' % (BUCKET_NAME,)
-
-        # Create the destination bucket, and set up the ACL to allow
-        # Stackdriver Logging to write into it.
-        storage_client = storage.Client()
-        bucket = storage_client.bucket(BUCKET_NAME)
-        retry_429(bucket.create)()
-        self.to_delete.append(bucket)
-        bucket.acl.reload()
-        logs_group = bucket.acl.group('cloud-logs@google.com')
-        logs_group.grant_owner()
-        bucket.acl.add_entity(logs_group)
-        bucket.acl.save()
-
-        return BUCKET_URI
-
-    def test_create_sink_storage_bucket(self):
-        uri = self._init_storage_bucket()
-        SINK_NAME = 'test-create-sink-bucket%s' % (_RESOURCE_ID,)
-
-        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
-        self.assertFalse(sink.exists())
-        sink.create()
-        self.to_delete.append(sink)
-        self.assertTrue(sink.exists())
-
-    def test_create_sink_pubsub_topic(self):
-        from google.cloud.pubsub import client as pubsub_client
-        SINK_NAME = 'test-create-sink-topic%s' % (_RESOURCE_ID,)
-        TOPIC_NAME = 'logging-test-sink%s' % (_RESOURCE_ID,)
-
-        # Create the destination topic, and set up the IAM policy to allow
-        # Stackdriver Logging to write into it.
-        pubsub_client = pubsub_client.Client()
-        topic = pubsub_client.topic(TOPIC_NAME)
-        topic.create()
-        self.to_delete.append(topic)
-        policy = topic.get_iam_policy()
-        policy.owners.add(policy.group('cloud-logs@google.com'))
-        topic.set_iam_policy(policy)
-
-        TOPIC_URI = 'pubsub.googleapis.com/%s' % (topic.full_name,)
-
-        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, TOPIC_URI)
-        self.assertFalse(sink.exists())
-        sink.create()
-        self.to_delete.append(sink)
-        self.assertTrue(sink.exists())
-
-    def _init_bigquery_dataset(self):
-        from google.cloud import bigquery
-        from google.cloud.bigquery.dataset import AccessGrant
-        DATASET_NAME = (
-            'system_testing_dataset' + _RESOURCE_ID).replace('-', '_')
-        DATASET_URI = 'bigquery.googleapis.com/projects/%s/datasets/%s' % (
-            Config.CLIENT.project, DATASET_NAME,)
-
-        # Create the destination dataset, and set up the ACL to allow
-        # Stackdriver Logging to write into it.
-        bigquery_client = bigquery.Client()
-        dataset = bigquery_client.dataset(DATASET_NAME)
-        dataset.create()
-        self.to_delete.append(dataset)
-        dataset.reload()
-        grants = dataset.access_grants
-        grants.append(AccessGrant(
-            'WRITER', 'groupByEmail', 'cloud-logs@google.com'))
-        dataset.access_grants = grants
-        dataset.update()
-        return DATASET_URI
-
-    def test_create_sink_bigquery_dataset(self):
-        SINK_NAME = 'test-create-sink-dataset%s' % (_RESOURCE_ID,)
-        uri = self._init_bigquery_dataset()
-        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
-        self.assertFalse(sink.exists())
-        sink.create()
-        self.to_delete.append(sink)
-        self.assertTrue(sink.exists())
-
-    def test_list_sinks(self):
-        SINK_NAME = 'test-list-sinks%s' % (_RESOURCE_ID,)
-        uri = self._init_storage_bucket()
-        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
-        self.assertFalse(sink.exists())
-        before_sinks, _ = Config.CLIENT.list_sinks()
-        before_names = set(sink.name for sink in before_sinks)
-        sink.create()
-        self.to_delete.append(sink)
-        self.assertTrue(sink.exists())
-        after_sinks, _ = Config.CLIENT.list_sinks()
-        after_names = set(sink.name for sink in after_sinks)
-        self.assertEqual(after_names - before_names,
-                         set([SINK_NAME]))
-
-    def test_reload_sink(self):
-        from google.cloud.exceptions import Conflict
-        SINK_NAME = 'test-reload-sink%s' % (_RESOURCE_ID,)
-        retry = RetryErrors(Conflict)
-        uri = self._init_bigquery_dataset()
-        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, uri)
-        self.assertFalse(sink.exists())
-        retry(sink.create)()
-        self.to_delete.append(sink)
-        sink.filter_ = 'BOGUS FILTER'
-        sink.destination = 'BOGUS DESTINATION'
-        sink.reload()
-        self.assertEqual(sink.filter_, DEFAULT_FILTER)
-        self.assertEqual(sink.destination, uri)
-
-    def test_update_sink(self):
-        from google.cloud.exceptions import Conflict
-        SINK_NAME = 'test-update-sink%s' % (_RESOURCE_ID,)
-        retry = RetryErrors(Conflict)
-        bucket_uri = self._init_storage_bucket()
-        dataset_uri = self._init_bigquery_dataset()
-        UPDATED_FILTER = 'logName:syslog'
-        sink = Config.CLIENT.sink(SINK_NAME, DEFAULT_FILTER, bucket_uri)
-        self.assertFalse(sink.exists())
-        retry(sink.create)()
-        self.to_delete.append(sink)
-        sink.filter_ = UPDATED_FILTER
-        sink.destination = dataset_uri
-        sink.update()
-        self.assertEqual(sink.filter_, UPDATED_FILTER)
-        self.assertEqual(sink.destination, dataset_uri)
diff --git a/system_tests/monitoring.py b/system_tests/monitoring.py
deleted file mode 100644
index 6c6931693001..000000000000
--- a/system_tests/monitoring.py
+++ /dev/null
@@ -1,369 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-from google.cloud.exceptions import BadRequest
-from google.cloud.exceptions import InternalServerError
-from google.cloud.exceptions import NotFound
-from google.cloud.exceptions import ServiceUnavailable
-from google.cloud import monitoring
-
-from retry import RetryErrors
-from retry import RetryResult
-from system_test_utils import unique_resource_id
-
-retry_404 = RetryErrors(NotFound, max_tries=5)
-retry_404_500 = RetryErrors((NotFound, InternalServerError))
-retry_500 = RetryErrors(InternalServerError)
-retry_503 = RetryErrors(ServiceUnavailable)
-
-
-class TestMonitoring(unittest.TestCase):
-
-    def test_fetch_metric_descriptor(self):
-        METRIC_TYPE = (
-            'pubsub.googleapis.com/topic/send_message_operation_count')
-        METRIC_KIND = monitoring.MetricKind.DELTA
-        VALUE_TYPE = monitoring.ValueType.INT64
-
-        client = monitoring.Client()
-        descriptor = client.fetch_metric_descriptor(METRIC_TYPE)
-
-        expected_name = 'projects/{project}/metricDescriptors/{type}'.format(
-            project=client.project,
-            type=METRIC_TYPE,
-        )
-        self.assertEqual(descriptor.name, expected_name)
-        self.assertEqual(descriptor.type, METRIC_TYPE)
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-        self.assertTrue(descriptor.description)
-
-        self.assertTrue(descriptor.labels)
-        for label in descriptor.labels:
-            self.assertTrue(label.key)
-            self.assertTrue(label.value_type)
-            self.assertTrue(label.description)
-
-    def test_list_metric_descriptors(self):
-        METRIC_TYPE = (
-            'pubsub.googleapis.com/topic/send_message_operation_count')
-        METRIC_KIND = monitoring.MetricKind.DELTA
-        VALUE_TYPE = monitoring.ValueType.INT64
-
-        client = monitoring.Client()
-
-        descriptor = None
-        for item in client.list_metric_descriptors():
-            if item.type == METRIC_TYPE:
-                descriptor = item
-
-        self.assertIsNotNone(descriptor)
-
-        expected_name = 'projects/{project}/{what}/{type}'.format(
-            project=client.project,
-            what='metricDescriptors',
-            type=METRIC_TYPE,
-        )
-        self.assertEqual(descriptor.name, expected_name)
-        self.assertEqual(descriptor.type, METRIC_TYPE)
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-        self.assertTrue(descriptor.description)
-
-        self.assertTrue(descriptor.labels)
-        for label in descriptor.labels:
-            self.assertTrue(label.key)
-            self.assertTrue(label.value_type)
-            self.assertTrue(label.description)
-
-    def test_list_metric_descriptors_filtered(self):
-        client = monitoring.Client()
-
-        PREFIX = 'compute.googleapis.com/'
-        descriptors = client.list_metric_descriptors(type_prefix=PREFIX)
-
-        # There are currently 18 types with this prefix, but that may change.
-        self.assertGreater(len(descriptors), 10)
-
-        for descriptor in descriptors:
-            self.assertTrue(descriptor.type.startswith(PREFIX))
-
-    def test_fetch_resource_descriptor(self):
-        RESOURCE_TYPE = 'pubsub_topic'
-
-        client = monitoring.Client()
-        descriptor = client.fetch_resource_descriptor(RESOURCE_TYPE)
-
-        expected_name = 'projects/{project}/{what}/{type}'.format(
-            project=client.project,
-            what='monitoredResourceDescriptors',
-            type=RESOURCE_TYPE,
-        )
-        self.assertEqual(descriptor.name, expected_name)
-        self.assertEqual(descriptor.type, RESOURCE_TYPE)
-        self.assertTrue(descriptor.display_name)
-        self.assertTrue(descriptor.description)
-
-        self.assertTrue(descriptor.labels)
-        for label in descriptor.labels:
-            self.assertTrue(label.key)
-            self.assertTrue(label.value_type)
-            self.assertTrue(label.description)
-
-    def test_list_resource_descriptors(self):
-        RESOURCE_TYPE = 'pubsub_topic'
-
-        client = monitoring.Client()
-
-        descriptor = None
-        for item in client.list_resource_descriptors():
-            if item.type == RESOURCE_TYPE:
-                descriptor = item
-
-        self.assertIsNotNone(descriptor)
-
-        expected_name = 'projects/{project}/{what}/{type}'.format(
-            project=client.project,
-            what='monitoredResourceDescriptors',
-            type=RESOURCE_TYPE,
-        )
-        self.assertEqual(descriptor.name, expected_name)
-        self.assertEqual(descriptor.type, RESOURCE_TYPE)
-        self.assertTrue(descriptor.display_name)
-        self.assertTrue(descriptor.description)
-
-        self.assertTrue(descriptor.labels)
-        for label in descriptor.labels:
-            self.assertTrue(label.key)
-            self.assertTrue(label.value_type)
-            self.assertTrue(label.description)
-
-    def test_query(self):
-        METRIC_TYPE = (
-            'pubsub.googleapis.com/topic/send_message_operation_count')
-        client = monitoring.Client()
-        query = client.query(METRIC_TYPE, hours=1)
-        # There may be no data, but we can ask anyway.
-        for _ in query:
-            pass    # Not necessarily reached.
-
-    def test_create_and_delete_metric_descriptor(self):
-        METRIC_TYPE = ('custom.googleapis.com/tmp/system_test_example' +
-                       unique_resource_id())
-        METRIC_KIND = monitoring.MetricKind.GAUGE
-        VALUE_TYPE = monitoring.ValueType.DOUBLE
-        DESCRIPTION = 'System test example -- DELETE ME!'
-
-        client = monitoring.Client()
-        descriptor = client.metric_descriptor(
-            METRIC_TYPE,
-            metric_kind=METRIC_KIND,
-            value_type=VALUE_TYPE,
-            description=DESCRIPTION,
-        )
-
-        retry_500(descriptor.create)()
-        retry_404_500(descriptor.delete)()
-
-    def test_write_point(self):
-        METRIC_TYPE = ('custom.googleapis.com/tmp/system_test_example' +
-                       unique_resource_id())
-        METRIC_KIND = monitoring.MetricKind.GAUGE
-        VALUE_TYPE = monitoring.ValueType.DOUBLE
-        DESCRIPTION = 'System test example -- DELETE ME!'
-        VALUE = 3.14
-
-        client = monitoring.Client()
-        descriptor = client.metric_descriptor(
-            METRIC_TYPE,
-            metric_kind=METRIC_KIND,
-            value_type=VALUE_TYPE,
-            description=DESCRIPTION,
-        )
-
-        descriptor.create()
-
-        metric = client.metric(METRIC_TYPE, {})
-        resource = client.resource('global', {})
-
-        retry_500(client.write_point)(metric, resource, VALUE)
-
-        def _query_timeseries_with_retries():
-            def _has_timeseries(result):
-                return len(list(result)) > 0
-            retry_result = RetryResult(_has_timeseries, max_tries=7)(
-                client.query)
-            return RetryErrors(BadRequest)(retry_result)
-
-        query = _query_timeseries_with_retries()(METRIC_TYPE, minutes=5)
-        timeseries_list = list(query)
-        self.assertEqual(len(timeseries_list), 1)
-        timeseries = timeseries_list[0]
-        self.assertEqual(timeseries.metric, metric)
-        # project_id label only exists on output.
-        del timeseries.resource.labels['project_id']
-        self.assertEqual(timeseries.resource, resource)
-
-        descriptor.delete()
-
-        with self.assertRaises(NotFound):
-            descriptor.delete()
-
-
-class TestMonitoringGroups(unittest.TestCase):
-
-    def setUp(self):
-        self.to_delete = []
-        self.DISPLAY_NAME = 'Testing: New group'
-        self.FILTER = 'resource.type = "gce_instance"'
-        self.IS_CLUSTER = True
-
-    def tearDown(self):
-        for group in self.to_delete:
-            retry_404(group.delete)()
-
-    def test_create_group(self):
-        client = monitoring.Client()
-        group = client.group(
-            display_name=self.DISPLAY_NAME,
-            filter_string=self.FILTER,
-            is_cluster=self.IS_CLUSTER,
-        )
-
-        retry_503(group.create)()
-        self.to_delete.append(group)
-
-        self.assertTrue(group.exists())
-
-    def test_list_groups(self):
-        client = monitoring.Client()
-        new_group = client.group(
-            display_name=self.DISPLAY_NAME,
-            filter_string=self.FILTER,
-            is_cluster=self.IS_CLUSTER,
-        )
-        before_groups = client.list_groups()
-        before_names = set(group.name for group in before_groups)
-
-        retry_503(new_group.create)()
-        self.to_delete.append(new_group)
-
-        self.assertTrue(new_group.exists())
-        after_groups = client.list_groups()
-        after_names = set(group.name for group in after_groups)
-        self.assertEqual(after_names - before_names,
-                         set([new_group.name]))
-
-    def test_reload_group(self):
-        client = monitoring.Client()
-        group = client.group(
-            display_name=self.DISPLAY_NAME,
-            filter_string=self.FILTER,
-            is_cluster=self.IS_CLUSTER,
-        )
-
-        retry_503(group.create)()
-        self.to_delete.append(group)
-
-        group.filter = 'resource.type = "aws_ec2_instance"'
-        group.display_name = 'locally changed name'
-        group.reload()
-        self.assertEqual(group.filter, self.FILTER)
-        self.assertEqual(group.display_name, self.DISPLAY_NAME)
-
-    def test_update_group(self):
-        NEW_FILTER = 'resource.type = "aws_ec2_instance"'
-        NEW_DISPLAY_NAME = 'updated'
-
-        client = monitoring.Client()
-        group = client.group(
-            display_name=self.DISPLAY_NAME,
-            filter_string=self.FILTER,
-            is_cluster=self.IS_CLUSTER,
-        )
-
-        retry_503(group.create)()
-        self.to_delete.append(group)
-
-        group.filter = NEW_FILTER
-        group.display_name = NEW_DISPLAY_NAME
-        group.update()
-
-        after = client.fetch_group(group.id)
-        self.assertEqual(after.filter, NEW_FILTER)
-        self.assertEqual(after.display_name, NEW_DISPLAY_NAME)
-
-    def test_list_group_members(self):
-        client = monitoring.Client()
-        group = client.group(
-            display_name=self.DISPLAY_NAME,
-            filter_string=self.FILTER,
-            is_cluster=self.IS_CLUSTER,
-        )
-
-        retry_503(group.create)()
-        self.to_delete.append(group)
-
-        for member in group.list_members():
-            self.assertIsInstance(member, monitoring.Resource)
-
-    def test_group_hierarchy(self):
-        client = monitoring.Client()
-        root_group = client.group(
-            display_name='Testing: Root group',
-            filter_string=self.FILTER,
-        )
-
-        retry_503(root_group.create)()
-        self.to_delete.insert(0, root_group)
-
-        middle_group = client.group(
-            display_name='Testing: Middle group',
-            filter_string=self.FILTER,
-            parent_id=root_group.id,
-        )
-
-        retry_503(middle_group.create)()
-        self.to_delete.insert(0, middle_group)
-
-        leaf_group = client.group(
-            display_name='Testing: Leaf group',
-            filter_string=self.FILTER,
-            parent_id=middle_group.id,
-        )
-
-        retry_503(leaf_group.create)()
-        self.to_delete.insert(0, leaf_group)
-
-        # Test for parent.
-        actual_parent = middle_group.fetch_parent()
-        self.assertTrue(actual_parent.name, root_group.name)
-
-        # Test for children.
-        actual_children = middle_group.list_children()
-        children_names = [group.name for group in actual_children]
-        self.assertEqual(children_names, [leaf_group.name])
-
-        # Test for descendants.
-        actual_descendants = root_group.list_descendants()
-        descendant_names = {group.name for group in actual_descendants}
-        self.assertEqual(descendant_names,
-                         set([middle_group.name, leaf_group.name]))
-
-        # Test for ancestors.
-        actual_ancestors = leaf_group.list_ancestors()
-        ancestor_names = [group.name for group in actual_ancestors]
-        self.assertEqual(ancestor_names, [middle_group.name, root_group.name])
diff --git a/system_tests/populate_datastore.py b/system_tests/populate_datastore.py
deleted file mode 100644
index 7d852677cb6a..000000000000
--- a/system_tests/populate_datastore.py
+++ /dev/null
@@ -1,107 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Script to populate datastore with system test data."""
-
-
-from __future__ import print_function
-
-import os
-
-import six
-
-from google.cloud import datastore
-
-
-ANCESTOR = ('Book', 'GoT')
-RICKARD = ANCESTOR + ('Character', 'Rickard')
-EDDARD = RICKARD + ('Character', 'Eddard')
-KEY_PATHS = (
-    RICKARD,
-    EDDARD,
-    ANCESTOR + ('Character', 'Catelyn'),
-    EDDARD + ('Character', 'Arya'),
-    EDDARD + ('Character', 'Sansa'),
-    EDDARD + ('Character', 'Robb'),
-    EDDARD + ('Character', 'Bran'),
-    EDDARD + ('Character', 'Jon Snow'),
-)
-CHARACTERS = (
-    {
-        'name': u'Rickard',
-        'family': u'Stark',
-        'appearances': 0,
-        'alive': False,
-    }, {
-        'name': u'Eddard',
-        'family': u'Stark',
-        'appearances': 9,
-        'alive': False,
-    }, {
-        'name': u'Catelyn',
-        'family': [u'Stark', u'Tully'],
-        'appearances': 26,
-        'alive': False,
-    }, {
-        'name': u'Arya',
-        'family': u'Stark',
-        'appearances': 33,
-        'alive': True,
-    }, {
-        'name': u'Sansa',
-        'family': u'Stark',
-        'appearances': 31,
-        'alive': True,
-    }, {
-        'name': u'Robb',
-        'family': u'Stark',
-        'appearances': 22,
-        'alive': False,
-    }, {
-        'name': u'Bran',
-        'family': u'Stark',
-        'appearances': 25,
-        'alive': True,
-    }, {
-        'name': u'Jon Snow',
-        'family': u'Stark',
-        'appearances': 32,
-        'alive': True,
-    },
-)
-
-
-def print_func(message):
-    if os.getenv('GOOGLE_CLOUD_NO_PRINT') != 'true':
-        print(message)
-
-
-def add_characters(client=None):
-    if client is None:
-        # Get a client that uses the test dataset.
-        client = datastore.Client()
-    with client.transaction() as xact:
-        for key_path, character in six.moves.zip(KEY_PATHS, CHARACTERS):
-            if key_path[-1] != character['name']:
-                raise ValueError(('Character and key don\'t agree',
-                                  key_path, character))
-            entity = datastore.Entity(key=client.key(*key_path))
-            entity.update(character)
-            xact.put(entity)
-            print_func('Adding Character %s %s' % (character['name'],
-                                                   character['family']))
-
-
-if __name__ == '__main__':
-    add_characters()
diff --git a/system_tests/pubsub.py b/system_tests/pubsub.py
deleted file mode 100644
index 7da8600df946..000000000000
--- a/system_tests/pubsub.py
+++ /dev/null
@@ -1,258 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import os
-import unittest
-
-from grpc import StatusCode
-import httplib2
-
-# pylint: disable=ungrouped-imports
-from google.cloud.environment_vars import PUBSUB_EMULATOR
-from google.cloud.exceptions import GrpcRendezvous
-from google.cloud.pubsub import client
-# pylint: enable=ungrouped-imports
-
-from retry import RetryInstanceState
-from retry import RetryResult
-from retry import RetryErrors
-from system_test_utils import EmulatorCreds
-from system_test_utils import unique_resource_id
-
-
-def _unavailable(exc):
-    return exc.code() == StatusCode.UNAVAILABLE
-
-
-retry_unavailable = RetryErrors(GrpcRendezvous, _unavailable)
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-    IN_EMULATOR = False
-
-
-def setUpModule():
-    Config.IN_EMULATOR = os.getenv(PUBSUB_EMULATOR) is not None
-    if Config.IN_EMULATOR:
-        credentials = EmulatorCreds()
-        http = httplib2.Http()  # Un-authorized.
-        Config.CLIENT = client.Client(credentials=credentials,
-                                      http=http)
-    else:
-        Config.CLIENT = client.Client()
-
-
-class TestPubsub(unittest.TestCase):
-
-    def setUp(self):
-        self.to_delete = []
-
-    def tearDown(self):
-        for doomed in self.to_delete:
-            doomed.delete()
-
-    def test_create_topic(self):
-        topic_name = 'a-new-topic' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(topic_name)
-        self.assertFalse(topic.exists())
-        topic.create()
-        self.to_delete.append(topic)
-        self.assertTrue(topic.exists())
-        self.assertEqual(topic.name, topic_name)
-
-    def test_list_topics(self):
-        before, _ = Config.CLIENT.list_topics()
-        topics_to_create = [
-            'new' + unique_resource_id(),
-            'newer' + unique_resource_id(),
-            'newest' + unique_resource_id(),
-        ]
-        for topic_name in topics_to_create:
-            topic = Config.CLIENT.topic(topic_name)
-            topic.create()
-            self.to_delete.append(topic)
-
-        # Retrieve the topics.
-        def _all_created(result):
-            return len(result[0]) == len(before) + len(topics_to_create)
-
-        retry = RetryResult(_all_created)
-        after, _ = retry(Config.CLIENT.list_topics)()
-
-        created = [topic for topic in after
-                   if topic.name in topics_to_create and
-                   topic.project == Config.CLIENT.project]
-        self.assertEqual(len(created), len(topics_to_create))
-
-    def test_create_subscription_defaults(self):
-        TOPIC_NAME = 'create-sub-def' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(TOPIC_NAME)
-        self.assertFalse(topic.exists())
-        topic.create()
-        self.to_delete.append(topic)
-        SUBSCRIPTION_NAME = 'subscribing-now' + unique_resource_id('-')
-        subscription = topic.subscription(SUBSCRIPTION_NAME)
-        self.assertFalse(subscription.exists())
-        subscription.create()
-        self.to_delete.append(subscription)
-        self.assertTrue(subscription.exists())
-        self.assertEqual(subscription.name, SUBSCRIPTION_NAME)
-        self.assertIs(subscription.topic, topic)
-
-    def test_create_subscription_w_ack_deadline(self):
-        TOPIC_NAME = 'create-sub-ack' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(TOPIC_NAME)
-        self.assertFalse(topic.exists())
-        topic.create()
-        self.to_delete.append(topic)
-        SUBSCRIPTION_NAME = 'subscribing-now' + unique_resource_id()
-        subscription = topic.subscription(SUBSCRIPTION_NAME, ack_deadline=120)
-        self.assertFalse(subscription.exists())
-        subscription.create()
-        self.to_delete.append(subscription)
-        self.assertTrue(subscription.exists())
-        self.assertEqual(subscription.name, SUBSCRIPTION_NAME)
-        self.assertEqual(subscription.ack_deadline, 120)
-        self.assertIs(subscription.topic, topic)
-
-    def test_list_subscriptions(self):
-        TOPIC_NAME = 'list-sub' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(TOPIC_NAME)
-        topic.create()
-        self.to_delete.append(topic)
-        empty, _ = topic.list_subscriptions()
-        self.assertEqual(len(empty), 0)
-        subscriptions_to_create = [
-            'new' + unique_resource_id(),
-            'newer' + unique_resource_id(),
-            'newest' + unique_resource_id(),
-        ]
-        for subscription_name in subscriptions_to_create:
-            subscription = topic.subscription(subscription_name)
-            subscription.create()
-            self.to_delete.append(subscription)
-
-        # Retrieve the subscriptions.
-        def _all_created(result):
-            return len(result[0]) == len(subscriptions_to_create)
-
-        retry = RetryResult(_all_created)
-        all_subscriptions, _ = retry(topic.list_subscriptions)()
-
-        created = [subscription for subscription in all_subscriptions
-                   if subscription.name in subscriptions_to_create]
-        self.assertEqual(len(created), len(subscriptions_to_create))
-
-    def test_message_pull_mode_e2e(self):
-        import operator
-        TOPIC_NAME = 'message-e2e' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(TOPIC_NAME,
-                                    timestamp_messages=True)
-        self.assertFalse(topic.exists())
-        topic.create()
-        self.to_delete.append(topic)
-        SUBSCRIPTION_NAME = 'subscribing-now' + unique_resource_id('-')
-        subscription = topic.subscription(SUBSCRIPTION_NAME)
-        self.assertFalse(subscription.exists())
-        subscription.create()
-        self.to_delete.append(subscription)
-
-        MESSAGE_1 = b'MESSAGE ONE'
-        MESSAGE_2 = b'MESSAGE ONE'
-        EXTRA_1 = 'EXTRA 1'
-        EXTRA_2 = 'EXTRA 2'
-        topic.publish(MESSAGE_1, extra=EXTRA_1)
-        topic.publish(MESSAGE_2, extra=EXTRA_2)
-
-        class Hoover(object):
-
-            def __init__(self):
-                self.received = []
-
-            def done(self, *dummy):
-                return len(self.received) == 2
-
-            def suction(self):
-                with subscription.auto_ack(max_messages=2) as ack:
-                    self.received.extend(ack.values())
-
-        hoover = Hoover()
-        retry = RetryInstanceState(hoover.done)
-        retry(hoover.suction)()
-
-        message1, message2 = sorted(hoover.received,
-                                    key=operator.attrgetter('timestamp'))
-        self.assertEqual(message1.data, MESSAGE_1)
-        self.assertEqual(message1.attributes['extra'], EXTRA_1)
-        self.assertEqual(message2.data, MESSAGE_2)
-        self.assertEqual(message2.attributes['extra'], EXTRA_2)
-
-    def _maybe_emulator_skip(self):
-        # NOTE: This method is necessary because ``Config.IN_EMULATOR``
-        #       is set at runtime rather than import time, which means we
-        #       can't use the @unittest.skipIf decorator.
-        if Config.IN_EMULATOR:
-            self.skipTest('IAM not supported by Pub/Sub emulator')
-
-    def test_topic_iam_policy(self):
-        from google.cloud.pubsub.iam import PUBSUB_TOPICS_GET_IAM_POLICY
-        self._maybe_emulator_skip()
-        topic_name = 'test-topic-iam-policy-topic' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(topic_name)
-        topic.create()
-
-        # Retry / backoff up to 7 seconds (1 + 2 + 4)
-        retry = RetryResult(lambda result: result, max_tries=4)
-        retry(topic.exists)()
-        self.to_delete.append(topic)
-
-        if topic.check_iam_permissions([PUBSUB_TOPICS_GET_IAM_POLICY]):
-            policy = topic.get_iam_policy()
-            policy.viewers.add(policy.user('jjg@google.com'))
-            new_policy = topic.set_iam_policy(policy)
-            self.assertEqual(new_policy.viewers, policy.viewers)
-
-    def test_subscription_iam_policy(self):
-        from google.cloud.pubsub.iam import PUBSUB_SUBSCRIPTIONS_GET_IAM_POLICY
-        self._maybe_emulator_skip()
-        topic_name = 'test-sub-iam-policy-topic' + unique_resource_id('-')
-        topic = Config.CLIENT.topic(topic_name)
-        topic.create()
-
-        # Retry / backoff up to 7 seconds (1 + 2 + 4)
-        retry = RetryResult(lambda result: result, max_tries=4)
-        retry(topic.exists)()
-        self.to_delete.append(topic)
-
-        SUB_NAME = 'test-sub-iam-policy-sub' + unique_resource_id('-')
-        subscription = topic.subscription(SUB_NAME)
-        subscription.create()
-
-        # Retry / backoff up to 7 seconds (1 + 2 + 4)
-        retry = RetryResult(lambda result: result, max_tries=4)
-        retry(subscription.exists)()
-        self.to_delete.insert(0, subscription)
-
-        if subscription.check_iam_permissions(
-                [PUBSUB_SUBSCRIPTIONS_GET_IAM_POLICY]):
-            policy = subscription.get_iam_policy()
-            policy.viewers.add(policy.user('jjg@google.com'))
-            new_policy = subscription.set_iam_policy(policy)
-            self.assertEqual(new_policy.viewers, policy.viewers)
diff --git a/system_tests/retry.py b/system_tests/retry.py
deleted file mode 100644
index c48d51eded26..000000000000
--- a/system_tests/retry.py
+++ /dev/null
@@ -1,193 +0,0 @@
-import time
-from functools import wraps
-
-import six
-
-MAX_TRIES = 4
-DELAY = 1
-BACKOFF = 2
-
-
-def _retry_all(_):
-    """Retry all caught exceptions."""
-    return True
-
-
-class BackoffFailed(Exception):
-    """Retry w/ backoffs did not complete successfully."""
-
-
-class RetryBase(object):
-    """Base for retrying calling a decorated function w/ exponential backoff.
-
-    :type max_tries: int
-    :param max_tries: Number of times to try (not retry) before giving up.
-
-    :type delay: int
-    :param delay: Initial delay between retries in seconds.
-
-    :type backoff: int
-    :param backoff: Backoff multiplier e.g. value of 2 will double the
-                    delay each retry.
-
-    :type logger: logging.Logger instance
-    :param logger: Logger to use. If None, print.
-    """
-    def __init__(self, max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
-                 logger=None):
-        self.max_tries = max_tries
-        self.delay = delay
-        self.backoff = backoff
-        self.logger = logger.warning if logger else six.print_
-
-
-class RetryErrors(RetryBase):
-    """Decorator for retrying given exceptions in testing.
-
-    :type exception: Exception or tuple of Exceptions
-    :param exception: The exception to check or may be a tuple of
-                      exceptions to check.
-
-    :type error_predicate: function, takes caught exception, returns bool
-    :param error_predicate: Predicate evaluating whether to retry after a
-                            caught exception.
-
-    :type max_tries: int
-    :param max_tries: Number of times to try (not retry) before giving up.
-
-    :type delay: int
-    :param delay: Initial delay between retries in seconds.
-
-    :type backoff: int
-    :param backoff: Backoff multiplier e.g. value of 2 will double the
-                    delay each retry.
-
-    :type logger: logging.Logger instance
-    :param logger: Logger to use. If None, print.
-    """
-    def __init__(self, exception, error_predicate=_retry_all,
-                 max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
-                 logger=None):
-        super(RetryErrors, self).__init__(max_tries, delay, backoff, logger)
-        self.exception = exception
-        self.error_predicate = error_predicate
-
-    def __call__(self, to_wrap):
-        @wraps(to_wrap)
-        def wrapped_function(*args, **kwargs):
-            tries = 0
-            while tries < self.max_tries:
-                try:
-                    return to_wrap(*args, **kwargs)
-                except self.exception as caught_exception:
-
-                    if not self.error_predicate(caught_exception):
-                        raise
-
-                    delay = self.delay * self.backoff**tries
-                    msg = ("%s, Trying again in %d seconds..." %
-                           (caught_exception, delay))
-                    self.logger(msg)
-
-                    time.sleep(delay)
-                    tries += 1
-            return to_wrap(*args, **kwargs)
-
-        return wrapped_function
-
-
-class RetryResult(RetryBase):
-    """Decorator for retrying based on non-error result.
-
-    :type result_predicate: function, takes result, returns bool
-    :param result_predicate: Predicate evaluating whether to retry after a
-                             result is returned.
-
-    :type max_tries: int
-    :param max_tries: Number of times to try (not retry) before giving up.
-
-    :type delay: int
-    :param delay: Initial delay between retries in seconds.
-
-    :type backoff: int
-    :param backoff: Backoff multiplier e.g. value of 2 will double the
-                    delay each retry.
-
-    :type logger: logging.Logger instance
-    :param logger: Logger to use. If None, print.
-    """
-    def __init__(self, result_predicate,
-                 max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
-                 logger=None):
-        super(RetryResult, self).__init__(max_tries, delay, backoff, logger)
-        self.result_predicate = result_predicate
-
-    def __call__(self, to_wrap):
-        @wraps(to_wrap)
-        def wrapped_function(*args, **kwargs):
-            tries = 0
-            while tries < self.max_tries:
-                result = to_wrap(*args, **kwargs)
-                if self.result_predicate(result):
-                    return result
-
-                delay = self.delay * self.backoff**tries
-                msg = "%s. Trying again in %d seconds..." % (
-                    self.result_predicate.__name__, delay,)
-                self.logger(msg)
-
-                time.sleep(delay)
-                tries += 1
-            raise BackoffFailed()
-
-        return wrapped_function
-
-
-class RetryInstanceState(RetryBase):
-    """Decorator for retrying based on instance state.
-
-    :type instance_predicate: function, takes instance, returns bool
-    :param instance_predicate: Predicate evaluating whether to retry after an
-                               API-invoking method is called.
-
-    :type max_tries: int
-    :param max_tries: Number of times to try (not retry) before giving up.
-
-    :type delay: int
-    :param delay: Initial delay between retries in seconds.
-
-    :type backoff: int
-    :param backoff: Backoff multiplier e.g. value of 2 will double the
-                    delay each retry.
-
-    :type logger: logging.Logger instance
-    :param logger: Logger to use. If None, print.
-    """
-    def __init__(self, instance_predicate,
-                 max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
-                 logger=None):
-        super(RetryInstanceState, self).__init__(
-            max_tries, delay, backoff, logger)
-        self.instance_predicate = instance_predicate
-
-    def __call__(self, to_wrap):
-        instance = to_wrap.__self__   # only instance methods allowed
-
-        @wraps(to_wrap)
-        def wrapped_function(*args, **kwargs):
-            tries = 0
-            while tries < self.max_tries:
-                result = to_wrap(*args, **kwargs)
-                if self.instance_predicate(instance):
-                    return result
-
-                delay = self.delay * self.backoff**tries
-                msg = "%s. Trying again in %d seconds..." % (
-                    self.instance_predicate.__name__, delay,)
-                self.logger(msg)
-
-                time.sleep(delay)
-                tries += 1
-            raise BackoffFailed()
-
-        return wrapped_function
diff --git a/system_tests/run_system_test.py b/system_tests/run_system_test.py
deleted file mode 100644
index 4ee50f9514f8..000000000000
--- a/system_tests/run_system_test.py
+++ /dev/null
@@ -1,89 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import argparse
-import sys
-import unittest
-
-import bigquery
-import bigtable
-import datastore
-import language
-import logging_
-import monitoring
-import pubsub
-import storage
-import system_test_utils
-import translate
-
-
-TEST_MODULES = {
-    'datastore': datastore,
-    'storage': storage,
-    'pubsub': pubsub,
-    'bigquery': bigquery,
-    'bigtable': bigtable,
-    'language': language,
-    'logging': logging_,
-    'monitoring': monitoring,
-    'translate': translate,
-}
-
-
-class FailedSystemTestModule(Exception):
-    pass
-
-
-def get_parser():
-    parser = argparse.ArgumentParser(
-        description='google-cloud test runner against actual project.')
-    parser.add_argument('--package', dest='package',
-                        choices=TEST_MODULES.keys(),
-                        default='datastore', help='Package to be tested.')
-    parser.add_argument(
-        '--ignore-requirements',
-        dest='ignore_requirements', action='store_true',
-        help='Ignore the credentials requirement for the test.')
-    return parser
-
-
-def run_module_tests(module_name, ignore_requirements=False):
-    if not ignore_requirements:
-        # Make sure environ is set before running test.
-        system_test_utils.check_environ()
-
-    suite = unittest.TestSuite()
-    test_mod = TEST_MODULES[module_name]
-    tests = unittest.defaultTestLoader.loadTestsFromModule(test_mod)
-    suite.addTest(tests)
-
-    # Run tests.
-    test_result = unittest.TextTestRunner(verbosity=2).run(suite)
-    # Exit if not successful.
-    if not test_result.wasSuccessful():
-        raise FailedSystemTestModule(module_name)
-
-
-def main():
-    parser = get_parser()
-    args = parser.parse_args()
-    try:
-        run_module_tests(args.package,
-                         ignore_requirements=args.ignore_requirements)
-    except FailedSystemTestModule:
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()
diff --git a/system_tests/storage.py b/system_tests/storage.py
deleted file mode 100644
index 381f5668878e..000000000000
--- a/system_tests/storage.py
+++ /dev/null
@@ -1,397 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import os
-import tempfile
-import time
-import unittest
-
-import httplib2
-import six
-
-from google.cloud import exceptions
-from google.cloud import storage
-from google.cloud.storage._helpers import _base64_md5hash
-
-from system_test_utils import unique_resource_id
-from retry import RetryErrors
-
-
-HTTP = httplib2.Http()
-
-
-def _bad_copy(bad_request):
-    """Predicate: pass only exceptions for a failed copyTo."""
-    err_msg = bad_request.message
-    return (err_msg.startswith('No file found in request. (POST') and
-            'copyTo' in err_msg)
-
-
-retry_429 = RetryErrors(exceptions.TooManyRequests)
-retry_bad_copy = RetryErrors(exceptions.BadRequest,
-                             error_predicate=_bad_copy)
-
-
-def _empty_bucket(bucket):
-    """Empty a bucket of all existing blobs.
-
-    This accounts (partially) for the eventual consistency of the
-    list blobs API call.
-    """
-    for blob in bucket.list_blobs():
-        try:
-            blob.delete()
-        except exceptions.NotFound:  # eventual consistency
-            pass
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-    TEST_BUCKET = None
-
-
-def setUpModule():
-    Config.CLIENT = storage.Client()
-    bucket_name = 'new' + unique_resource_id()
-    # In the **very** rare case the bucket name is reserved, this
-    # fails with a ConnectionError.
-    Config.TEST_BUCKET = Config.CLIENT.bucket(bucket_name)
-    retry_429(Config.TEST_BUCKET.create)()
-
-
-def tearDownModule():
-    retry = RetryErrors(exceptions.Conflict)
-    retry(Config.TEST_BUCKET.delete)(force=True)
-
-
-class TestStorageBuckets(unittest.TestCase):
-
-    def setUp(self):
-        self.case_buckets_to_delete = []
-
-    def tearDown(self):
-        with Config.CLIENT.batch():
-            for bucket_name in self.case_buckets_to_delete:
-                bucket = Config.CLIENT.bucket(bucket_name)
-                retry_429(bucket.delete)()
-
-    def test_create_bucket(self):
-        new_bucket_name = 'a-new-bucket' + unique_resource_id('-')
-        self.assertRaises(exceptions.NotFound,
-                          Config.CLIENT.get_bucket, new_bucket_name)
-        created = Config.CLIENT.create_bucket(new_bucket_name)
-        self.case_buckets_to_delete.append(new_bucket_name)
-        self.assertEqual(created.name, new_bucket_name)
-
-    def test_list_buckets(self):
-        buckets_to_create = [
-            'new' + unique_resource_id(),
-            'newer' + unique_resource_id(),
-            'newest' + unique_resource_id(),
-        ]
-        created_buckets = []
-        for bucket_name in buckets_to_create:
-            bucket = Config.CLIENT.bucket(bucket_name)
-            retry_429(bucket.create)()
-            self.case_buckets_to_delete.append(bucket_name)
-
-        # Retrieve the buckets.
-        all_buckets = Config.CLIENT.list_buckets()
-        created_buckets = [bucket for bucket in all_buckets
-                           if bucket.name in buckets_to_create]
-        self.assertEqual(len(created_buckets), len(buckets_to_create))
-
-
-class TestStorageFiles(unittest.TestCase):
-
-    FILES = {
-        'logo': {
-            'path': 'system_tests/data/CloudPlatform_128px_Retina.png',
-        },
-        'big': {
-            'path': 'system_tests/data/five-point-one-mb-file.zip',
-        },
-        'simple': {
-            'path': 'system_tests/data/simple.txt',
-        }
-    }
-
-    @classmethod
-    def setUpClass(cls):
-        super(TestStorageFiles, cls).setUpClass()
-        for file_data in cls.FILES.values():
-            with open(file_data['path'], 'rb') as file_obj:
-                file_data['hash'] = _base64_md5hash(file_obj)
-        cls.bucket = Config.TEST_BUCKET
-
-    def setUp(self):
-        self.case_blobs_to_delete = []
-
-    def tearDown(self):
-        for blob in self.case_blobs_to_delete:
-            blob.delete()
-
-
-class TestStorageWriteFiles(TestStorageFiles):
-
-    def test_large_file_write_from_stream(self):
-        blob = self.bucket.blob('LargeFile')
-
-        file_data = self.FILES['big']
-        with open(file_data['path'], 'rb') as file_obj:
-            blob.upload_from_file(file_obj)
-            self.case_blobs_to_delete.append(blob)
-
-        md5_hash = blob.md5_hash
-        if not isinstance(md5_hash, six.binary_type):
-            md5_hash = md5_hash.encode('utf-8')
-        self.assertEqual(md5_hash, file_data['hash'])
-
-    def test_small_file_write_from_filename(self):
-        blob = self.bucket.blob('SmallFile')
-
-        file_data = self.FILES['simple']
-        blob.upload_from_filename(file_data['path'])
-        self.case_blobs_to_delete.append(blob)
-
-        md5_hash = blob.md5_hash
-        if not isinstance(md5_hash, six.binary_type):
-            md5_hash = md5_hash.encode('utf-8')
-        self.assertEqual(md5_hash, file_data['hash'])
-
-    def test_write_metadata(self):
-        filename = self.FILES['logo']['path']
-        blob_name = os.path.basename(filename)
-
-        blob = storage.Blob(blob_name, bucket=self.bucket)
-        blob.upload_from_filename(filename)
-        self.case_blobs_to_delete.append(blob)
-
-        # NOTE: This should not be necessary. We should be able to pass
-        #       it in to upload_file and also to upload_from_string.
-        blob.content_type = 'image/png'
-        self.assertEqual(blob.content_type, 'image/png')
-
-    def test_direct_write_and_read_into_file(self):
-        blob = self.bucket.blob('MyBuffer')
-        file_contents = b'Hello World'
-        blob.upload_from_string(file_contents)
-        self.case_blobs_to_delete.append(blob)
-
-        same_blob = self.bucket.blob('MyBuffer')
-        same_blob.reload()  # Initialize properties.
-        temp_filename = tempfile.mktemp()
-        with open(temp_filename, 'wb') as file_obj:
-            same_blob.download_to_file(file_obj)
-
-        with open(temp_filename, 'rb') as file_obj:
-            stored_contents = file_obj.read()
-
-        self.assertEqual(file_contents, stored_contents)
-
-    def test_copy_existing_file(self):
-        filename = self.FILES['logo']['path']
-        blob = storage.Blob('CloudLogo', bucket=self.bucket)
-        blob.upload_from_filename(filename)
-        self.case_blobs_to_delete.append(blob)
-
-        new_blob = retry_bad_copy(self.bucket.copy_blob)(
-            blob, self.bucket, 'CloudLogoCopy')
-        self.case_blobs_to_delete.append(new_blob)
-
-        base_contents = blob.download_as_string()
-        copied_contents = new_blob.download_as_string()
-        self.assertEqual(base_contents, copied_contents)
-
-
-class TestStorageListFiles(TestStorageFiles):
-
-    FILENAMES = ('CloudLogo1', 'CloudLogo2', 'CloudLogo3')
-
-    @classmethod
-    def setUpClass(cls):
-        super(TestStorageListFiles, cls).setUpClass()
-        # Make sure bucket empty before beginning.
-        _empty_bucket(cls.bucket)
-
-        logo_path = cls.FILES['logo']['path']
-        blob = storage.Blob(cls.FILENAMES[0], bucket=cls.bucket)
-        blob.upload_from_filename(logo_path)
-        cls.suite_blobs_to_delete = [blob]
-
-        # Copy main blob onto remaining in FILENAMES.
-        for filename in cls.FILENAMES[1:]:
-            new_blob = retry_bad_copy(cls.bucket.copy_blob)(
-                blob, cls.bucket, filename)
-            cls.suite_blobs_to_delete.append(new_blob)
-
-    @classmethod
-    def tearDownClass(cls):
-        for blob in cls.suite_blobs_to_delete:
-            blob.delete()
-
-    @RetryErrors(unittest.TestCase.failureException)
-    def test_list_files(self):
-        all_blobs = list(self.bucket.list_blobs())
-        self.assertEqual(sorted(blob.name for blob in all_blobs),
-                         sorted(self.FILENAMES))
-
-    @RetryErrors(unittest.TestCase.failureException)
-    def test_paginate_files(self):
-        truncation_size = 1
-        count = len(self.FILENAMES) - truncation_size
-        iterator = self.bucket.list_blobs(max_results=count)
-        response = iterator.get_next_page_response()
-        blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual(len(blobs), count)
-        self.assertEqual(iterator.page_number, 1)
-        self.assertIsNotNone(iterator.next_page_token)
-
-        response = iterator.get_next_page_response()
-        last_blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual(len(last_blobs), truncation_size)
-
-
-class TestStoragePseudoHierarchy(TestStorageFiles):
-
-    FILENAMES = (
-        'file01.txt',
-        'parent/file11.txt',
-        'parent/child/file21.txt',
-        'parent/child/file22.txt',
-        'parent/child/grand/file31.txt',
-        'parent/child/other/file32.txt',
-    )
-
-    @classmethod
-    def setUpClass(cls):
-        super(TestStoragePseudoHierarchy, cls).setUpClass()
-        # Make sure bucket empty before beginning.
-        _empty_bucket(cls.bucket)
-
-        simple_path = cls.FILES['simple']['path']
-        blob = storage.Blob(cls.FILENAMES[0], bucket=cls.bucket)
-        blob.upload_from_filename(simple_path)
-        cls.suite_blobs_to_delete = [blob]
-        for filename in cls.FILENAMES[1:]:
-            new_blob = retry_bad_copy(cls.bucket.copy_blob)(
-                blob, cls.bucket, filename)
-            cls.suite_blobs_to_delete.append(new_blob)
-
-    @classmethod
-    def tearDownClass(cls):
-        for blob in cls.suite_blobs_to_delete:
-            blob.delete()
-
-    @RetryErrors(unittest.TestCase.failureException)
-    def test_root_level_w_delimiter(self):
-        iterator = self.bucket.list_blobs(delimiter='/')
-        response = iterator.get_next_page_response()
-        blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual([blob.name for blob in blobs], ['file01.txt'])
-        self.assertEqual(iterator.page_number, 1)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertEqual(iterator.prefixes, set(['parent/']))
-
-    @RetryErrors(unittest.TestCase.failureException)
-    def test_first_level(self):
-        iterator = self.bucket.list_blobs(delimiter='/', prefix='parent/')
-        response = iterator.get_next_page_response()
-        blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual([blob.name for blob in blobs], ['parent/file11.txt'])
-        self.assertEqual(iterator.page_number, 1)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertEqual(iterator.prefixes, set(['parent/child/']))
-
-    @RetryErrors(unittest.TestCase.failureException)
-    def test_second_level(self):
-        expected_names = [
-            'parent/child/file21.txt',
-            'parent/child/file22.txt',
-        ]
-
-        iterator = self.bucket.list_blobs(delimiter='/',
-                                          prefix='parent/child/')
-        response = iterator.get_next_page_response()
-        blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual([blob.name for blob in blobs],
-                         expected_names)
-        self.assertEqual(iterator.page_number, 1)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertEqual(iterator.prefixes,
-                         set(['parent/child/grand/', 'parent/child/other/']))
-
-    @RetryErrors(unittest.TestCase.failureException)
-    def test_third_level(self):
-        # Pseudo-hierarchy can be arbitrarily deep, subject to the limit
-        # of 1024 characters in the UTF-8 encoded name:
-        # https://cloud.google.com/storage/docs/bucketnaming#objectnames
-        # Exercise a layer deeper to illustrate this.
-        iterator = self.bucket.list_blobs(delimiter='/',
-                                          prefix='parent/child/grand/')
-        response = iterator.get_next_page_response()
-        blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual([blob.name for blob in blobs],
-                         ['parent/child/grand/file31.txt'])
-        self.assertEqual(iterator.page_number, 1)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertEqual(iterator.prefixes, set())
-
-
-class TestStorageSignURLs(TestStorageFiles):
-
-    def setUp(self):
-        super(TestStorageSignURLs, self).setUp()
-
-        logo_path = self.FILES['logo']['path']
-        with open(logo_path, 'rb') as file_obj:
-            self.LOCAL_FILE = file_obj.read()
-
-        blob = self.bucket.blob('LogoToSign.jpg')
-        blob.upload_from_string(self.LOCAL_FILE)
-        self.case_blobs_to_delete.append(blob)
-
-    def tearDown(self):
-        for blob in self.case_blobs_to_delete:
-            if blob.exists():
-                blob.delete()
-
-    def test_create_signed_read_url(self):
-        blob = self.bucket.blob('LogoToSign.jpg')
-        expiration = int(time.time() + 5)
-        signed_url = blob.generate_signed_url(expiration, method='GET',
-                                              client=Config.CLIENT)
-
-        response, content = HTTP.request(signed_url, method='GET')
-        self.assertEqual(response.status, 200)
-        self.assertEqual(content, self.LOCAL_FILE)
-
-    def test_create_signed_delete_url(self):
-        blob = self.bucket.blob('LogoToSign.jpg')
-        expiration = int(time.time() + 283473274)
-        signed_delete_url = blob.generate_signed_url(expiration,
-                                                     method='DELETE',
-                                                     client=Config.CLIENT)
-
-        response, content = HTTP.request(signed_delete_url, method='DELETE')
-        self.assertEqual(response.status, 204)
-        self.assertEqual(content, b'')
-
-        # Check that the blob has actually been deleted.
-        self.assertFalse(blob.exists())
diff --git a/system_tests/system_test_utils.py b/system_tests/system_test_utils.py
deleted file mode 100644
index 08dfb32999ba..000000000000
--- a/system_tests/system_test_utils.py
+++ /dev/null
@@ -1,69 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-from __future__ import print_function
-import os
-import sys
-import time
-
-from google.cloud.environment_vars import CREDENTIALS as TEST_CREDENTIALS
-
-
-# From shell environ. May be None.
-CREDENTIALS = os.getenv(TEST_CREDENTIALS)
-
-ENVIRON_ERROR_MSG = """\
-To run the system tests, you need to set some environment variables.
-Please check the CONTRIBUTING guide for instructions.
-"""
-
-
-class EmulatorCreds(object):
-    """A mock credential object.
-
-    Used to avoid unnecessary token refreshing or reliance on the network
-    while an emulator is running.
-    """
-
-    @staticmethod
-    def create_scoped_required():
-        return False
-
-
-def check_environ():
-    err_msg = None
-    if CREDENTIALS is None:
-        err_msg = '\nMissing variables: ' + TEST_CREDENTIALS
-    elif not os.path.isfile(CREDENTIALS):
-        err_msg = '\nThe %s path %r is not a file.' % (TEST_CREDENTIALS,
-                                                       CREDENTIALS)
-
-    if err_msg is not None:
-        msg = ENVIRON_ERROR_MSG + err_msg
-        print(msg, file=sys.stderr)
-        sys.exit(1)
-
-
-def unique_resource_id(delimiter='_'):
-    """A unique identifier for a resource.
-
-    Intended to help locate resources created in particular
-    testing environments and at particular times.
-    """
-    build_id = os.getenv('TRAVIS_BUILD_ID', '')
-    if build_id == '':
-        return '%s%d' % (delimiter, 1000 * time.time())
-    else:
-        return '%s%s%s%d' % (delimiter, build_id,
-                             delimiter, time.time())
diff --git a/system_tests/translate.py b/system_tests/translate.py
deleted file mode 100644
index 16a99fb55e6b..000000000000
--- a/system_tests/translate.py
+++ /dev/null
@@ -1,86 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-
-import os
-
-import unittest
-
-from google.cloud import translate
-
-
-ENV_VAR = 'GOOGLE_CLOUD_TESTS_API_KEY'
-
-
-class Config(object):
-    """Run-time configuration to be modified at set-up.
-
-    This is a mutable stand-in to allow test set-up to modify
-    global state.
-    """
-    CLIENT = None
-
-
-def setUpModule():
-    api_key = os.getenv(ENV_VAR)
-    Config.CLIENT = translate.Client(api_key=api_key)
-
-
-class TestTranslate(unittest.TestCase):
-
-    def test_get_languages(self):
-        result = Config.CLIENT.get_languages()
-        # There are **many** more than 10 languages.
-        self.assertGreater(len(result), 10)
-
-        lang_map = {val['language']: val['name'] for val in result}
-        self.assertEqual(lang_map['en'], 'English')
-        self.assertEqual(lang_map['ja'], 'Japanese')
-        self.assertEqual(lang_map['lv'], 'Latvian')
-        self.assertEqual(lang_map['zu'], 'Zulu')
-
-    def test_detect_language(self):
-        values = ['takoy', u'fa\xe7ade', 's\'il vous plait']
-        detections = Config.CLIENT.detect_language(values)
-        self.assertEqual(len(values), len(detections))
-        self.assertEqual(detections[0]['language'], 'ru')
-        self.assertEqual(detections[1]['language'], 'fr')
-        self.assertEqual(detections[2]['language'], 'fr')
-
-    def test_translate(self):
-        values = ['hvala ti', 'dankon',
-                  'Me llamo Jeff', 'My name is Jeff']
-        translations = Config.CLIENT.translate(values,
-                                               target_language='de')
-        self.assertEqual(len(values), len(translations))
-
-        self.assertEqual(
-            translations[0]['detectedSourceLanguage'], 'hr')
-        self.assertEqual(
-            translations[0]['translatedText'], 'danke')
-
-        self.assertEqual(
-            translations[1]['detectedSourceLanguage'], 'eo')
-        self.assertEqual(
-            translations[1]['translatedText'], 'dank')
-
-        self.assertEqual(
-            translations[2]['detectedSourceLanguage'], 'es')
-        self.assertEqual(
-            translations[2]['translatedText'], 'Mein Name ist Jeff')
-
-        self.assertEqual(
-            translations[3]['detectedSourceLanguage'], 'en')
-        self.assertEqual(
-            translations[3]['translatedText'], 'Mein Name ist Jeff')
diff --git a/talent/.coveragerc b/talent/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/talent/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/talent/.flake8 b/talent/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/talent/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/talent/.repo-metadata.json b/talent/.repo-metadata.json
new file mode 100644
index 000000000000..3e9db085248a
--- /dev/null
+++ b/talent/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "talent",
+  "name_pretty": "Google Cloud Talent Solution",
+  "product_documentation": "https://cloud.google.com/solutions/talent-solution/",
+  "client_documentation": "https://googleapis.dev/python/talent/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559664",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-talent",
+  "api_id": "jobs.googleapis.com",
+  "requires_billing": true
+}
diff --git a/talent/CHANGELOG.md b/talent/CHANGELOG.md
new file mode 100644
index 000000000000..2a1ccc914d29
--- /dev/null
+++ b/talent/CHANGELOG.md
@@ -0,0 +1,60 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-talent/#history
+
+## 0.3.0
+
+07-24-2019 17:36 PDT
+
+
+### Implementation Changes
+- Return iterable of `SummarizedProfile` from `search_profiles` rather than`HistogramQueryResult` (via synth). ([#7962](https://github.com/googleapis/google-cloud-python/pull/7962))
+
+### New Features
+- Add strict keywords search, increase timeout (via synth). ([#8712](https://github.com/googleapis/google-cloud-python/pull/8712))
+- Add path-construction helpers to GAPIC clients (via synth). ([#8632](https://github.com/googleapis/google-cloud-python/pull/8632))
+- Add 'result_set_id' param to 'ProfileSearchClient.search_profiles'; add 'ProfileQuery.candidate_availability_filter'; pin 'black' version; dostring tweaks (via synth). ([#8597](https://github.com/googleapis/google-cloud-python/pull/8597))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8523](https://github.com/googleapis/google-cloud-python/pull/8523))
+- Add 'batch_create_jobs' and 'batch_update_jobs' (via synth). ([#8189](https://github.com/googleapis/google-cloud-python/pull/8189))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Allow kwargs to be passed to create_channel (via synth). ([#8405](https://github.com/googleapis/google-cloud-python/pull/8405))
+- Declare encoding as utf-8 in pb2 files (via synth).([#8365](https://github.com/googleapis/google-cloud-python/pull/8365))
+- Add disclaimer to auto-generated template files (via synth). ([#8329](https://github.com/googleapis/google-cloud-python/pull/8329))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8253](https://github.com/googleapis/google-cloud-python/pull/8253))
+- Fix coverage in 'types.py' (via synth). ([#8165](https://github.com/googleapis/google-cloud-python/pull/8165))
+- Blacken noxfile.py, setup.py (via synth).([#8133](https://github.com/googleapis/google-cloud-python/pull/8133))
+- Add empty lines (via synth). ([#8073](https://github.com/googleapis/google-cloud-python/pull/8073))
+
+## 0.2.0
+
+05-09-2019 12:25 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Regenerate talent (via synth). ([#7861](https://github.com/googleapis/google-cloud-python/pull/7861))
+
+### Documentation
+- Fixed broken talent client library documentation link ([#7546](https://github.com/googleapis/google-cloud-python/pull/7546))
+- Fix link in docstring.([#7508](https://github.com/googleapis/google-cloud-python/pull/7508))
+- Documentation and formatting changes. ([#7489](https://github.com/googleapis/google-cloud-python/pull/7489))
+
+## 0.1.0
+
+03-05-2019 12:50 PST
+
+- Initial release of google-cloud-talent
+
diff --git a/talent/LICENSE b/talent/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/talent/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/talent/MANIFEST.in b/talent/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/talent/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/talent/README.rst b/talent/README.rst
new file mode 100644
index 000000000000..1fc163b9c295
--- /dev/null
+++ b/talent/README.rst
@@ -0,0 +1,78 @@
+Python Client for Cloud Talent Solution API (`Alpha`_)
+======================================================
+
+
+
+`Cloud Talent Solution API`_: Cloud Talent Solution provides the capability to create, read, update, and
+delete job postings, as well as search jobs based on keywords and filters.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/README.rst
+.. _Cloud Talent Solution API: https://cloud.google.com/jobs
+.. _Client Library Documentation: https://googleapis.dev/python/talent/latest
+.. _Product Documentation:  https://cloud.google.com/jobs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Talent Solution API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Talent Solution API.:  https://cloud.google.com/jobs
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-talent
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-talent
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Talent Solution API
+   API to see other available methods on the client.
+-  Read the `Cloud Talent Solution API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Cloud Talent Solution API Product documentation:  https://cloud.google.com/jobs
+.. _repository’s main README: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/README.rst
diff --git a/talent/docs/README.rst b/talent/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/talent/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/talent/docs/changelog.md b/talent/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/talent/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/talent/docs/conf.py b/talent/docs/conf.py
new file mode 100644
index 000000000000..9b26b1fe0f7f
--- /dev/null
+++ b/talent/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-talent documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-talent"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-talent-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-talent.tex",
+        u"google-cloud-talent Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-talent",
+        u"google-cloud-talent Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-talent",
+        u"google-cloud-talent Documentation",
+        author,
+        "google-cloud-talent",
+        "GAPIC library for the {metadata.shortName} service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/talent/docs/gapic/v4beta1/api.rst b/talent/docs/gapic/v4beta1/api.rst
new file mode 100644
index 000000000000..7c2b844e8ae9
--- /dev/null
+++ b/talent/docs/gapic/v4beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Talent Solution API
+====================================
+
+.. automodule:: google.cloud.talent_v4beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/talent/docs/gapic/v4beta1/types.rst b/talent/docs/gapic/v4beta1/types.rst
new file mode 100644
index 000000000000..af0bf0f2ad21
--- /dev/null
+++ b/talent/docs/gapic/v4beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Talent Solution API Client
+==========================================
+
+.. automodule:: google.cloud.talent_v4beta1.types
+    :members:
\ No newline at end of file
diff --git a/talent/docs/index.rst b/talent/docs/index.rst
new file mode 100644
index 000000000000..46d6f0fc4cfc
--- /dev/null
+++ b/talent/docs/index.rst
@@ -0,0 +1,20 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v4beta1/api
+    gapic/v4beta1/types
+    changelog
+
+Changelog
+---------
+
+For a list of all previous `google-cloud-talent` releases.
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
diff --git a/talent/google/__init__.py b/talent/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/talent/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/talent/google/cloud/__init__.py b/talent/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/talent/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/talent/google/cloud/talent.py b/talent/google/cloud/talent.py
new file mode 100644
index 000000000000..d095bc5c8bee
--- /dev/null
+++ b/talent/google/cloud/talent.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.talent_v4beta1 import ApplicationServiceClient
+from google.cloud.talent_v4beta1 import CompanyServiceClient
+from google.cloud.talent_v4beta1 import CompletionClient
+from google.cloud.talent_v4beta1 import EventServiceClient
+from google.cloud.talent_v4beta1 import JobServiceClient
+from google.cloud.talent_v4beta1 import ProfileServiceClient
+from google.cloud.talent_v4beta1 import TenantServiceClient
+from google.cloud.talent_v4beta1 import enums
+from google.cloud.talent_v4beta1 import types
+
+
+__all__ = (
+    "enums",
+    "types",
+    "ApplicationServiceClient",
+    "CompanyServiceClient",
+    "CompletionClient",
+    "EventServiceClient",
+    "JobServiceClient",
+    "ProfileServiceClient",
+    "TenantServiceClient",
+)
diff --git a/talent/google/cloud/talent_v4beta1/__init__.py b/talent/google/cloud/talent_v4beta1/__init__.py
new file mode 100644
index 000000000000..c1df276f5eda
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/__init__.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.talent_v4beta1 import types
+from google.cloud.talent_v4beta1.gapic import application_service_client
+from google.cloud.talent_v4beta1.gapic import company_service_client
+from google.cloud.talent_v4beta1.gapic import completion_client
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic import event_service_client
+from google.cloud.talent_v4beta1.gapic import job_service_client
+from google.cloud.talent_v4beta1.gapic import profile_service_client
+from google.cloud.talent_v4beta1.gapic import tenant_service_client
+
+
+class ApplicationServiceClient(application_service_client.ApplicationServiceClient):
+    __doc__ = application_service_client.ApplicationServiceClient.__doc__
+    enums = enums
+
+
+class CompanyServiceClient(company_service_client.CompanyServiceClient):
+    __doc__ = company_service_client.CompanyServiceClient.__doc__
+    enums = enums
+
+
+class CompletionClient(completion_client.CompletionClient):
+    __doc__ = completion_client.CompletionClient.__doc__
+    enums = enums
+
+
+class EventServiceClient(event_service_client.EventServiceClient):
+    __doc__ = event_service_client.EventServiceClient.__doc__
+    enums = enums
+
+
+class JobServiceClient(job_service_client.JobServiceClient):
+    __doc__ = job_service_client.JobServiceClient.__doc__
+    enums = enums
+
+
+class ProfileServiceClient(profile_service_client.ProfileServiceClient):
+    __doc__ = profile_service_client.ProfileServiceClient.__doc__
+    enums = enums
+
+
+class TenantServiceClient(tenant_service_client.TenantServiceClient):
+    __doc__ = tenant_service_client.TenantServiceClient.__doc__
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "ApplicationServiceClient",
+    "CompanyServiceClient",
+    "CompletionClient",
+    "EventServiceClient",
+    "JobServiceClient",
+    "ProfileServiceClient",
+    "TenantServiceClient",
+)
diff --git a/talent/google/cloud/talent_v4beta1/gapic/__init__.py b/talent/google/cloud/talent_v4beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/talent/google/cloud/talent_v4beta1/gapic/application_service_client.py b/talent/google/cloud/talent_v4beta1/gapic/application_service_client.py
new file mode 100644
index 000000000000..f73835ce7795
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/application_service_client.py
@@ -0,0 +1,640 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 ApplicationService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import application_service_client_config
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic.transports import (
+    application_service_grpc_transport,
+)
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class ApplicationServiceClient(object):
+    """
+    A service that handles application management, including CRUD and
+    enumeration.
+    """
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.ApplicationService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ApplicationServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def application_path(cls, project, tenant, profile, application):
+        """Return a fully-qualified application string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/profiles/{profile}/applications/{application}",
+            project=project,
+            tenant=tenant,
+            profile=profile,
+            application=application,
+        )
+
+    @classmethod
+    def profile_path(cls, project, tenant, profile):
+        """Return a fully-qualified profile string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/profiles/{profile}",
+            project=project,
+            tenant=tenant,
+            profile=profile,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ApplicationServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ApplicationServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = application_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=application_service_grpc_transport.ApplicationServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = application_service_grpc_transport.ApplicationServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_application(
+        self,
+        parent,
+        application,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new application entity.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ApplicationServiceClient()
+            >>>
+            >>> parent = client.profile_path('[PROJECT]', '[TENANT]', '[PROFILE]')
+            >>>
+            >>> # TODO: Initialize `application`:
+            >>> application = {}
+            >>>
+            >>> response = client.create_application(parent, application)
+
+        Args:
+            parent (str): 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".
+            application (Union[dict, ~google.cloud.talent_v4beta1.types.Application]): Required. The application to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Application`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Application` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_application" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_application"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_application,
+                default_retry=self._method_configs["CreateApplication"].retry,
+                default_timeout=self._method_configs["CreateApplication"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = application_service_pb2.CreateApplicationRequest(
+            parent=parent, application=application
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_application"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_application(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves specified application.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ApplicationServiceClient()
+            >>>
+            >>> name = client.application_path('[PROJECT]', '[TENANT]', '[PROFILE]', '[APPLICATION]')
+            >>>
+            >>> response = client.get_application(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Application` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_application" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_application"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_application,
+                default_retry=self._method_configs["GetApplication"].retry,
+                default_timeout=self._method_configs["GetApplication"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = application_service_pb2.GetApplicationRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_application"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_application(
+        self,
+        application,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates specified application.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ApplicationServiceClient()
+            >>>
+            >>> # TODO: Initialize `application`:
+            >>> application = {}
+            >>>
+            >>> response = client.update_application(application)
+
+        Args:
+            application (Union[dict, ~google.cloud.talent_v4beta1.types.Application]): Required. The application resource to replace the current resource in the
+                system.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Application`
+            update_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional but strongly recommended for the best service experience.
+
+                If ``update_mask`` is provided, only the specified fields in
+                ``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`` are supported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Application` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_application" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_application"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_application,
+                default_retry=self._method_configs["UpdateApplication"].retry,
+                default_timeout=self._method_configs["UpdateApplication"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = application_service_pb2.UpdateApplicationRequest(
+            application=application, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("application.name", application.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_application"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_application(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes specified application.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ApplicationServiceClient()
+            >>>
+            >>> name = client.application_path('[PROJECT]', '[TENANT]', '[PROFILE]', '[APPLICATION]')
+            >>>
+            >>> client.delete_application(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_application" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_application"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_application,
+                default_retry=self._method_configs["DeleteApplication"].retry,
+                default_timeout=self._method_configs["DeleteApplication"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = application_service_pb2.DeleteApplicationRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_application"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_applications(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all applications associated with the profile.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ApplicationServiceClient()
+            >>>
+            >>> parent = client.profile_path('[PROJECT]', '[TENANT]', '[PROFILE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_applications(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_applications(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.Application` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_applications" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_applications"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_applications,
+                default_retry=self._method_configs["ListApplications"].retry,
+                default_timeout=self._method_configs["ListApplications"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = application_service_pb2.ListApplicationsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_applications"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="applications",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/talent/google/cloud/talent_v4beta1/gapic/application_service_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/application_service_client_config.py
new file mode 100644
index 000000000000..8fa9c6fdce0c
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/application_service_client_config.py
@@ -0,0 +1,48 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.ApplicationService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateApplication": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetApplication": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateApplication": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteApplication": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListApplications": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/company_service_client.py b/talent/google/cloud/talent_v4beta1/gapic/company_service_client.py
new file mode 100644
index 000000000000..e2c101363ea0
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/company_service_client.py
@@ -0,0 +1,662 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 CompanyService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import company_service_client_config
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic.transports import company_service_grpc_transport
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class CompanyServiceClient(object):
+    """A service that handles company management, including CRUD and enumeration."""
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.CompanyService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CompanyServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def company_path(cls, project, tenant, company):
+        """Return a fully-qualified company string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/companies/{company}",
+            project=project,
+            tenant=tenant,
+            company=company,
+        )
+
+    @classmethod
+    def company_without_tenant_path(cls, project, company):
+        """Return a fully-qualified company_without_tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/companies/{company}", project=project, company=company
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def tenant_path(cls, project, tenant):
+        """Return a fully-qualified tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}", project=project, tenant=tenant
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CompanyServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CompanyServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = company_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=company_service_grpc_transport.CompanyServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = company_service_grpc_transport.CompanyServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_company(
+        self,
+        parent,
+        company,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new company entity.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.CompanyServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `company`:
+            >>> company = {}
+            >>>
+            >>> response = client.create_company(parent, company)
+
+        Args:
+            parent (str): 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".
+            company (Union[dict, ~google.cloud.talent_v4beta1.types.Company]): Required. The company to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Company`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Company` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_company" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_company"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_company,
+                default_retry=self._method_configs["CreateCompany"].retry,
+                default_timeout=self._method_configs["CreateCompany"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = company_service_pb2.CreateCompanyRequest(
+            parent=parent, company=company
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_company"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_company(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves specified company.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.CompanyServiceClient()
+            >>>
+            >>> name = client.company_path('[PROJECT]', '[TENANT]', '[COMPANY]')
+            >>>
+            >>> response = client.get_company(name)
+
+        Args:
+            name (str): Required. The resource name of the company to be retrieved.
+
+                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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Company` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_company" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_company"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_company,
+                default_retry=self._method_configs["GetCompany"].retry,
+                default_timeout=self._method_configs["GetCompany"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = company_service_pb2.GetCompanyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_company"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_company(
+        self,
+        company,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates specified company.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.CompanyServiceClient()
+            >>>
+            >>> # TODO: Initialize `company`:
+            >>> company = {}
+            >>>
+            >>> response = client.update_company(company)
+
+        Args:
+            company (Union[dict, ~google.cloud.talent_v4beta1.types.Company]): Required. The company resource to replace the current resource in the
+                system.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Company`
+            update_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional but strongly recommended for the best service experience.
+
+                If ``update_mask`` is provided, only the specified fields in ``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`` are supported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Company` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_company" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_company"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_company,
+                default_retry=self._method_configs["UpdateCompany"].retry,
+                default_timeout=self._method_configs["UpdateCompany"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = company_service_pb2.UpdateCompanyRequest(
+            company=company, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("company.name", company.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_company"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_company(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes specified company.
+        Prerequisite: The company has no jobs associated with it.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.CompanyServiceClient()
+            >>>
+            >>> name = client.company_path('[PROJECT]', '[TENANT]', '[COMPANY]')
+            >>>
+            >>> client.delete_company(name)
+
+        Args:
+            name (str): Required. The resource name of the company to be deleted.
+
+                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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_company" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_company"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_company,
+                default_retry=self._method_configs["DeleteCompany"].retry,
+                default_timeout=self._method_configs["DeleteCompany"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = company_service_pb2.DeleteCompanyRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_company"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_companies(
+        self,
+        parent,
+        page_size=None,
+        require_open_jobs=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all companies associated with the project.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.CompanyServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_companies(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_companies(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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 the default tenant is used if unspecified, for
+                example, "projects/api-test-project".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            require_open_jobs (bool): Optional. Set to true if the companies requested must have open jobs.
+
+                Defaults to false.
+
+                If true, at most ``page_size`` of companies are fetched, among which
+                only those with open jobs are returned.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.Company` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_companies" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_companies"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_companies,
+                default_retry=self._method_configs["ListCompanies"].retry,
+                default_timeout=self._method_configs["ListCompanies"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = company_service_pb2.ListCompaniesRequest(
+            parent=parent, page_size=page_size, require_open_jobs=require_open_jobs
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_companies"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="companies",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/talent/google/cloud/talent_v4beta1/gapic/company_service_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/company_service_client_config.py
new file mode 100644
index 000000000000..c6f5d6d6c6e5
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/company_service_client_config.py
@@ -0,0 +1,48 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.CompanyService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateCompany": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetCompany": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateCompany": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteCompany": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListCompanies": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/completion_client.py b/talent/google/cloud/talent_v4beta1/gapic/completion_client.py
new file mode 100644
index 000000000000..d33123d98c98
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/completion_client.py
@@ -0,0 +1,351 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 Completion API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import completion_client_config
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic.transports import completion_grpc_transport
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+from google.cloud.talent_v4beta1.proto import completion_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class CompletionClient(object):
+    """A service handles auto completion."""
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.Completion"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CompletionClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def company_path(cls, project, tenant, company):
+        """Return a fully-qualified company string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/companies/{company}",
+            project=project,
+            tenant=tenant,
+            company=company,
+        )
+
+    @classmethod
+    def company_without_tenant_path(cls, project, company):
+        """Return a fully-qualified company_without_tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/companies/{company}", project=project, company=company
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def tenant_path(cls, project, tenant):
+        """Return a fully-qualified tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}", project=project, tenant=tenant
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CompletionGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CompletionGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = completion_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=completion_grpc_transport.CompletionGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = completion_grpc_transport.CompletionGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def complete_query(
+        self,
+        parent,
+        query,
+        page_size,
+        language_codes=None,
+        company=None,
+        scope=None,
+        type_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Completes the specified prefix with keyword suggestions.
+        Intended for use by a job search auto-complete search box.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.CompletionClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `query`:
+            >>> query = ''
+            >>>
+            >>> # TODO: Initialize `page_size`:
+            >>> page_size = 0
+            >>>
+            >>> response = client.complete_query(parent, query, page_size)
+
+        Args:
+            parent (str): 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".
+
+                Tenant id is optional and the default tenant is used if unspecified, for
+                example, "projects/api-test-project".
+            query (str): Required. The query used to generate suggestions.
+
+                The maximum number of allowed characters is 255.
+            page_size (int): Required. Completion result count.
+
+                The maximum allowed page size is 10.
+            language_codes (list[str]): Optional. 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`` type, only open jobs with the same
+                ``language_codes`` are returned.
+
+                For ``CompletionType.COMPANY_NAME`` type, only companies having open
+                jobs with the same ``language_codes`` are returned.
+
+                For ``CompletionType.COMBINED`` type, only open jobs with the same
+                ``language_codes`` or companies having open jobs with the same
+                ``language_codes`` are returned.
+
+                The maximum number of allowed characters is 255.
+            company (str): Optional. 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".
+
+                Tenant id is optional and the default tenant is used if unspecified, for
+                example, "projects/api-test-project/companies/bar".
+            scope (~google.cloud.talent_v4beta1.types.CompletionScope): Optional. The scope of the completion. The defaults is
+                ``CompletionScope.PUBLIC``.
+            type_ (~google.cloud.talent_v4beta1.types.CompletionType): Optional. The completion topic. The default is
+                ``CompletionType.COMBINED``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.CompleteQueryResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "complete_query" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "complete_query"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.complete_query,
+                default_retry=self._method_configs["CompleteQuery"].retry,
+                default_timeout=self._method_configs["CompleteQuery"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = completion_service_pb2.CompleteQueryRequest(
+            parent=parent,
+            query=query,
+            page_size=page_size,
+            language_codes=language_codes,
+            company=company,
+            scope=scope,
+            type=type_,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["complete_query"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/talent/google/cloud/talent_v4beta1/gapic/completion_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/completion_client_config.py
new file mode 100644
index 000000000000..fb888690e028
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/completion_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.Completion": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CompleteQuery": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/enums.py b/talent/google/cloud/talent_v4beta1/gapic/enums.py
new file mode 100644
index 000000000000..0769f3ed8426
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/enums.py
@@ -0,0 +1,1083 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class CommuteMethod(enum.IntEnum):
+    """
+    Method for commute.
+
+    Attributes:
+      COMMUTE_METHOD_UNSPECIFIED (int): Commute method isn't specified.
+      DRIVING (int): Commute time is calculated based on driving time.
+      TRANSIT (int): Commute time is calculated based on public transit including bus, metro,
+      subway, and so on.
+      WALKING (int): Commute time is calculated based on walking time.
+      CYCLING (int): Commute time is calculated based on biking time.
+    """
+
+    COMMUTE_METHOD_UNSPECIFIED = 0
+    DRIVING = 1
+    TRANSIT = 2
+    WALKING = 3
+    CYCLING = 4
+
+
+class CompanySize(enum.IntEnum):
+    """
+    An enum that represents the size of the company.
+
+    Attributes:
+      COMPANY_SIZE_UNSPECIFIED (int): Default value if the size isn't specified.
+      MINI (int): The company has less than 50 employees.
+      SMALL (int): The company has between 50 and 99 employees.
+      SMEDIUM (int): The company has between 100 and 499 employees.
+      MEDIUM (int): The company has between 500 and 999 employees.
+      BIG (int): The company has between 1,000 and 4,999 employees.
+      BIGGER (int): The company has between 5,000 and 9,999 employees.
+      GIANT (int): The company has 10,000 or more employees.
+    """
+
+    COMPANY_SIZE_UNSPECIFIED = 0
+    MINI = 1
+    SMALL = 2
+    SMEDIUM = 3
+    MEDIUM = 4
+    BIG = 5
+    BIGGER = 6
+    GIANT = 7
+
+
+class ContactInfoUsage(enum.IntEnum):
+    """
+    Enum that represents the usage of the contact information.
+
+    Attributes:
+      CONTACT_INFO_USAGE_UNSPECIFIED (int): Default value.
+      PERSONAL (int): Personal use.
+      WORK (int): Work use.
+      SCHOOL (int): School use.
+    """
+
+    CONTACT_INFO_USAGE_UNSPECIFIED = 0
+    PERSONAL = 1
+    WORK = 2
+    SCHOOL = 3
+
+
+class DegreeType(enum.IntEnum):
+    """
+    Educational degree level defined in International Standard Classification
+    of Education (ISCED).
+
+    Attributes:
+      DEGREE_TYPE_UNSPECIFIED (int): Default value. Represents no degree, or early childhood education.
+      Maps to ISCED code 0.
+      Ex) Kindergarten
+      PRIMARY_EDUCATION (int): Primary education which is typically the first stage of compulsory
+      education. ISCED code 1.
+      Ex) Elementary school
+      LOWER_SECONDARY_EDUCATION (int): Lower secondary education; First stage of secondary education building on
+      primary education, typically with a more subject-oriented curriculum.
+      ISCED code 2.
+      Ex) Middle school
+      UPPER_SECONDARY_EDUCATION (int): Middle education; Second/final stage of secondary education preparing for
+      tertiary education and/or providing skills relevant to employment.
+      Usually with an increased range of subject options and streams. ISCED
+      code 3.
+      Ex) High school
+      ADULT_REMEDIAL_EDUCATION (int): Adult Remedial Education; Programmes providing learning experiences that
+      build on secondary education and prepare for labour market entry and/or
+      tertiary education. The content is broader than secondary but not as
+      complex as tertiary education. ISCED code 4.
+      ASSOCIATES_OR_EQUIVALENT (int): Associate's or equivalent; Short first tertiary programmes that are
+      typically practically-based, occupationally-specific and prepare for
+      labour market entry. These programmes may also provide a pathway to other
+      tertiary programmes. ISCED code 5.
+      BACHELORS_OR_EQUIVALENT (int): Bachelor's or equivalent; Programmes designed to provide intermediate
+      academic and/or professional knowledge, skills and competencies leading
+      to a first tertiary degree or equivalent qualification. ISCED code 6.
+      MASTERS_OR_EQUIVALENT (int): Master's or equivalent; Programmes designed to provide advanced academic
+      and/or professional knowledge, skills and competencies leading to a
+      second tertiary degree or equivalent qualification. ISCED code 7.
+      DOCTORAL_OR_EQUIVALENT (int): Doctoral or equivalent; Programmes designed primarily to lead to an
+      advanced research qualification, usually concluding with the submission
+      and defense of a substantive dissertation of publishable quality based on
+      original research. ISCED code 8.
+    """
+
+    DEGREE_TYPE_UNSPECIFIED = 0
+    PRIMARY_EDUCATION = 1
+    LOWER_SECONDARY_EDUCATION = 2
+    UPPER_SECONDARY_EDUCATION = 3
+    ADULT_REMEDIAL_EDUCATION = 4
+    ASSOCIATES_OR_EQUIVALENT = 5
+    BACHELORS_OR_EQUIVALENT = 6
+    MASTERS_OR_EQUIVALENT = 7
+    DOCTORAL_OR_EQUIVALENT = 8
+
+
+class EmploymentType(enum.IntEnum):
+    """
+    An enum that represents the employment type of a job.
+
+    Attributes:
+      EMPLOYMENT_TYPE_UNSPECIFIED (int): The default value if the employment type isn't specified.
+      FULL_TIME (int): The job requires working a number of hours that constitute full
+      time employment, typically 40 or more hours per week.
+      PART_TIME (int): The job entails working fewer hours than a full time job,
+      typically less than 40 hours a week.
+      CONTRACTOR (int): The job is offered as a contracted, as opposed to a salaried employee,
+      position.
+      CONTRACT_TO_HIRE (int): 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`` jobs.
+      TEMPORARY (int): The job is offered as a temporary employment opportunity, usually
+      a short-term engagement.
+      INTERN (int): The job is a fixed-term opportunity for students or entry-level job
+      seekers to obtain on-the-job training, typically offered as a summer
+      position.
+      VOLUNTEER (int): The is an opportunity for an individual to volunteer, where there's no
+      expectation of compensation for the provided services.
+      PER_DIEM (int): The job requires an employee to work on an as-needed basis with a
+      flexible schedule.
+      FLY_IN_FLY_OUT (int): The job involves employing people in remote areas and flying them
+      temporarily to the work site instead of relocating employees and their
+      families permanently.
+      OTHER_EMPLOYMENT_TYPE (int): The job does not fit any of the other listed types.
+    """
+
+    EMPLOYMENT_TYPE_UNSPECIFIED = 0
+    FULL_TIME = 1
+    PART_TIME = 2
+    CONTRACTOR = 3
+    CONTRACT_TO_HIRE = 4
+    TEMPORARY = 5
+    INTERN = 6
+    VOLUNTEER = 7
+    PER_DIEM = 8
+    FLY_IN_FLY_OUT = 9
+    OTHER_EMPLOYMENT_TYPE = 10
+
+
+class HtmlSanitization(enum.IntEnum):
+    """
+    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.
+
+    Attributes:
+      HTML_SANITIZATION_UNSPECIFIED (int): Default value.
+      HTML_SANITIZATION_DISABLED (int): Disables sanitization on HTML input.
+      SIMPLE_FORMATTING_ONLY (int): Sanitizes HTML input, only accepts bold, italic, ordered list, and
+      unordered list markup tags.
+    """
+
+    HTML_SANITIZATION_UNSPECIFIED = 0
+    HTML_SANITIZATION_DISABLED = 1
+    SIMPLE_FORMATTING_ONLY = 2
+
+
+class JobBenefit(enum.IntEnum):
+    """
+    An enum that represents employee benefits included with the job.
+
+    Attributes:
+      JOB_BENEFIT_UNSPECIFIED (int): Default value if the type isn't specified.
+      CHILD_CARE (int): The job includes access to programs that support child care, such
+      as daycare.
+      DENTAL (int): The job includes dental services covered by a dental
+      insurance plan.
+      DOMESTIC_PARTNER (int): The job offers specific benefits to domestic partners.
+      FLEXIBLE_HOURS (int): The job allows for a flexible work schedule.
+      MEDICAL (int): The job includes health services covered by a medical insurance plan.
+      LIFE_INSURANCE (int): The job includes a life insurance plan provided by the employer or
+      available for purchase by the employee.
+      PARENTAL_LEAVE (int): The job allows for a leave of absence to a parent to care for a newborn
+      child.
+      RETIREMENT_PLAN (int): The job includes a workplace retirement plan provided by the
+      employer or available for purchase by the employee.
+      SICK_DAYS (int): The job allows for paid time off due to illness.
+      VACATION (int): The job includes paid time off for vacation.
+      VISION (int): The job includes vision services covered by a vision
+      insurance plan.
+    """
+
+    JOB_BENEFIT_UNSPECIFIED = 0
+    CHILD_CARE = 1
+    DENTAL = 2
+    DOMESTIC_PARTNER = 3
+    FLEXIBLE_HOURS = 4
+    MEDICAL = 5
+    LIFE_INSURANCE = 6
+    PARENTAL_LEAVE = 7
+    RETIREMENT_PLAN = 8
+    SICK_DAYS = 9
+    VACATION = 10
+    VISION = 11
+
+
+class JobCategory(enum.IntEnum):
+    """
+    An enum that represents the categorization or primary focus of specific
+    role. This value is different than the "industry" associated with a role,
+    which is related to the categorization of the company listing the job.
+
+    Attributes:
+      JOB_CATEGORY_UNSPECIFIED (int): The default value if the category isn't specified.
+      ACCOUNTING_AND_FINANCE (int): An accounting and finance job, such as an Accountant.
+      ADMINISTRATIVE_AND_OFFICE (int): An administrative and office job, such as an Administrative Assistant.
+      ADVERTISING_AND_MARKETING (int): An advertising and marketing job, such as Marketing Manager.
+      ANIMAL_CARE (int): An animal care job, such as Veterinarian.
+      ART_FASHION_AND_DESIGN (int): An art, fashion, or design job, such as Designer.
+      BUSINESS_OPERATIONS (int): A business operations job, such as Business Operations Manager.
+      CLEANING_AND_FACILITIES (int): A cleaning and facilities job, such as Custodial Staff.
+      COMPUTER_AND_IT (int): A computer and IT job, such as Systems Administrator.
+      CONSTRUCTION (int): A construction job, such as General Laborer.
+      CUSTOMER_SERVICE (int): A customer service job, such s Cashier.
+      EDUCATION (int): An education job, such as School Teacher.
+      ENTERTAINMENT_AND_TRAVEL (int): An entertainment and travel job, such as Flight Attendant.
+      FARMING_AND_OUTDOORS (int): A farming or outdoor job, such as Park Ranger.
+      HEALTHCARE (int): A healthcare job, such as Registered Nurse.
+      HUMAN_RESOURCES (int): A human resources job, such as Human Resources Director.
+      INSTALLATION_MAINTENANCE_AND_REPAIR (int): An installation, maintenance, or repair job, such as Electrician.
+      LEGAL (int): A legal job, such as Law Clerk.
+      MANAGEMENT (int): A management job, often used in conjunction with another category,
+      such as Store Manager.
+      MANUFACTURING_AND_WAREHOUSE (int): A manufacturing or warehouse job, such as Assembly Technician.
+      MEDIA_COMMUNICATIONS_AND_WRITING (int): A media, communications, or writing job, such as Media Relations.
+      OIL_GAS_AND_MINING (int): An oil, gas or mining job, such as Offshore Driller.
+      PERSONAL_CARE_AND_SERVICES (int): A personal care and services job, such as Hair Stylist.
+      PROTECTIVE_SERVICES (int): A protective services job, such as Security Guard.
+      REAL_ESTATE (int): A real estate job, such as Buyer's Agent.
+      RESTAURANT_AND_HOSPITALITY (int): A restaurant and hospitality job, such as Restaurant Server.
+      SALES_AND_RETAIL (int): A sales and/or retail job, such Sales Associate.
+      SCIENCE_AND_ENGINEERING (int): A science and engineering job, such as Lab Technician.
+      SOCIAL_SERVICES_AND_NON_PROFIT (int): A social services or non-profit job, such as Case Worker.
+      SPORTS_FITNESS_AND_RECREATION (int): A sports, fitness, or recreation job, such as Personal Trainer.
+      TRANSPORTATION_AND_LOGISTICS (int): A transportation or logistics job, such as Truck Driver.
+    """
+
+    JOB_CATEGORY_UNSPECIFIED = 0
+    ACCOUNTING_AND_FINANCE = 1
+    ADMINISTRATIVE_AND_OFFICE = 2
+    ADVERTISING_AND_MARKETING = 3
+    ANIMAL_CARE = 4
+    ART_FASHION_AND_DESIGN = 5
+    BUSINESS_OPERATIONS = 6
+    CLEANING_AND_FACILITIES = 7
+    COMPUTER_AND_IT = 8
+    CONSTRUCTION = 9
+    CUSTOMER_SERVICE = 10
+    EDUCATION = 11
+    ENTERTAINMENT_AND_TRAVEL = 12
+    FARMING_AND_OUTDOORS = 13
+    HEALTHCARE = 14
+    HUMAN_RESOURCES = 15
+    INSTALLATION_MAINTENANCE_AND_REPAIR = 16
+    LEGAL = 17
+    MANAGEMENT = 18
+    MANUFACTURING_AND_WAREHOUSE = 19
+    MEDIA_COMMUNICATIONS_AND_WRITING = 20
+    OIL_GAS_AND_MINING = 21
+    PERSONAL_CARE_AND_SERVICES = 22
+    PROTECTIVE_SERVICES = 23
+    REAL_ESTATE = 24
+    RESTAURANT_AND_HOSPITALITY = 25
+    SALES_AND_RETAIL = 26
+    SCIENCE_AND_ENGINEERING = 27
+    SOCIAL_SERVICES_AND_NON_PROFIT = 28
+    SPORTS_FITNESS_AND_RECREATION = 29
+    TRANSPORTATION_AND_LOGISTICS = 30
+
+
+class JobLevel(enum.IntEnum):
+    """
+    An enum that represents the required experience level required for the job.
+
+    Attributes:
+      JOB_LEVEL_UNSPECIFIED (int): The default value if the level isn't specified.
+      ENTRY_LEVEL (int): Entry-level individual contributors, typically with less than 2 years of
+      experience in a similar role. Includes interns.
+      EXPERIENCED (int): Experienced individual contributors, typically with 2+ years of
+      experience in a similar role.
+      MANAGER (int): Entry- to mid-level managers responsible for managing a team of people.
+      DIRECTOR (int): Senior-level managers responsible for managing teams of managers.
+      EXECUTIVE (int): Executive-level managers and above, including C-level positions.
+    """
+
+    JOB_LEVEL_UNSPECIFIED = 0
+    ENTRY_LEVEL = 1
+    EXPERIENCED = 2
+    MANAGER = 3
+    DIRECTOR = 4
+    EXECUTIVE = 5
+
+
+class JobView(enum.IntEnum):
+    """
+    An enum that specifies the job attributes that are returned in the
+    ``MatchingJob.job`` or ``ListJobsResponse.jobs`` fields.
+
+    Attributes:
+      JOB_VIEW_UNSPECIFIED (int): Default value.
+      JOB_VIEW_ID_ONLY (int): A ID only view of job, with following attributes: ``Job.name``,
+      ``Job.requisition_id``, ``Job.language_code``.
+      JOB_VIEW_MINIMAL (int): A minimal view of the job, with the following attributes: ``Job.name``,
+      ``Job.requisition_id``, ``Job.title``, ``Job.company``,
+      ``Job.DerivedInfo.locations``, ``Job.language_code``.
+      JOB_VIEW_SMALL (int): A small view of the job, with the following attributes in the search
+      results: ``Job.name``, ``Job.requisition_id``, ``Job.title``,
+      ``Job.company``, ``Job.DerivedInfo.locations``, ``Job.visibility``,
+      ``Job.language_code``, ``Job.description``.
+      JOB_VIEW_FULL (int): All available attributes are included in the search results.
+    """
+
+    JOB_VIEW_UNSPECIFIED = 0
+    JOB_VIEW_ID_ONLY = 1
+    JOB_VIEW_MINIMAL = 2
+    JOB_VIEW_SMALL = 3
+    JOB_VIEW_FULL = 4
+
+
+class Outcome(enum.IntEnum):
+    """
+    The overall outcome /decision / result indicator.
+
+    Attributes:
+      OUTCOME_UNSPECIFIED (int): Default value.
+      POSITIVE (int): A positive outcome / passing indicator (for example, candidate was
+      recommended for hiring or to be moved forward in the hiring process,
+      candidate passed a test).
+      NEUTRAL (int): A neutral outcome / no clear indicator (for example, no strong
+      reccommendation either to move forward / not move forward, neutral score).
+      NEGATIVE (int): A negative outcome / failing indicator (for example, candidate was
+      recommended to NOT move forward in the hiring process, failed a test).
+      OUTCOME_NOT_AVAILABLE (int): The assessment outcome is not available or otherwise unknown (for example,
+      candidate did not complete assessment).
+    """
+
+    OUTCOME_UNSPECIFIED = 0
+    POSITIVE = 1
+    NEUTRAL = 2
+    NEGATIVE = 3
+    OUTCOME_NOT_AVAILABLE = 4
+
+
+class PostingRegion(enum.IntEnum):
+    """
+    An enum that represents the job posting region. In most cases, job postings
+    don't need to specify a region. If a region is given, jobs are
+    eligible for searches in the specified region.
+
+    Attributes:
+      POSTING_REGION_UNSPECIFIED (int): If the region is unspecified, the job is only returned if it matches the
+      ``LocationFilter``.
+      ADMINISTRATIVE_AREA (int): In addition to exact location matching, job posting is returned when the
+      ``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`` has "Mountain View".
+
+      Administrative area refers to top-level administrative subdivision of
+      this country. For example, US state, IT region, UK constituent nation
+      and JP prefecture.
+      NATION (int): In addition to exact location matching, job is returned when
+      ``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`` has 'Mountain View'.
+      TELECOMMUTE (int): Job allows employees to work remotely (telecommute).
+      If locations are provided with this value, the job is
+      considered as having a location, but telecommuting is allowed.
+    """
+
+    POSTING_REGION_UNSPECIFIED = 0
+    ADMINISTRATIVE_AREA = 1
+    NATION = 2
+    TELECOMMUTE = 3
+
+
+class SkillProficiencyLevel(enum.IntEnum):
+    """
+    Enum that represents the skill proficiency level.
+
+    Attributes:
+      SKILL_PROFICIENCY_LEVEL_UNSPECIFIED (int): Default value.
+      UNSKILLED (int): Lacks any proficiency in this skill.
+      FUNDAMENTAL_AWARENESS (int): Have a common knowledge or an understanding of basic techniques and
+      concepts.
+      NOVICE (int): Have the level of experience gained in a classroom and/or experimental
+      scenarios or as a trainee on-the-job.
+      INTERMEDIATE (int): Be able to successfully complete tasks in this skill as requested. Help
+      from an expert may be required from time to time, but can usually perform
+      skill independently.
+      ADVANCED (int): Can perform the actions associated with this skill without assistance.
+      EXPERT (int): Known as an expert in this area.
+    """
+
+    SKILL_PROFICIENCY_LEVEL_UNSPECIFIED = 0
+    UNSKILLED = 6
+    FUNDAMENTAL_AWARENESS = 1
+    NOVICE = 2
+    INTERMEDIATE = 3
+    ADVANCED = 4
+    EXPERT = 5
+
+
+class Visibility(enum.IntEnum):
+    """
+    Deprecated. All resources are only visible to the owner.
+
+    An enum that represents who has view access to the resource.
+
+    Attributes:
+      VISIBILITY_UNSPECIFIED (int): Default value.
+      ACCOUNT_ONLY (int): The resource is only visible to the GCP account who owns it.
+      SHARED_WITH_GOOGLE (int): The resource is visible to the owner and may be visible to other
+      applications and processes at Google.
+      SHARED_WITH_PUBLIC (int): The resource is visible to the owner and may be visible to all other API
+      clients.
+    """
+
+    VISIBILITY_UNSPECIFIED = 0
+    ACCOUNT_ONLY = 1
+    SHARED_WITH_GOOGLE = 2
+    SHARED_WITH_PUBLIC = 3
+
+
+class Application(object):
+    class ApplicationStage(enum.IntEnum):
+        """
+        The stage of the application.
+
+        Attributes:
+          APPLICATION_STAGE_UNSPECIFIED (int): Default value.
+          NEW (int): Candidate has applied or a recruiter put candidate into consideration but
+          candidate is not yet screened / no decision has been made to move or not
+          move the candidate to the next stage.
+          SCREEN (int): A recruiter decided to screen the candidate for this role.
+          HIRING_MANAGER_REVIEW (int): Candidate is being / was sent to the customer / hiring manager for
+          detailed review.
+          INTERVIEW (int): Candidate was approved by the client / hiring manager and is being / was
+          interviewed for the role.
+          OFFER_EXTENDED (int): Candidate will be / has been given an offer of employment.
+          OFFER_ACCEPTED (int): Candidate has accepted their offer of employment.
+          STARTED (int): Candidate has begun (or completed) their employment or assignment with
+          the employer.
+        """
+
+        APPLICATION_STAGE_UNSPECIFIED = 0
+        NEW = 1
+        SCREEN = 2
+        HIRING_MANAGER_REVIEW = 3
+        INTERVIEW = 4
+        OFFER_EXTENDED = 5
+        OFFER_ACCEPTED = 6
+        STARTED = 7
+
+    class ApplicationState(enum.IntEnum):
+        """
+        Enum that represents the application status.
+
+        Attributes:
+          APPLICATION_STATE_UNSPECIFIED (int): Default value.
+          IN_PROGRESS (int): The current stage is in progress or pending, for example, interviews in
+          progress.
+          CANDIDATE_WITHDREW (int): The current stage was terminated by a candidate decision.
+          EMPLOYER_WITHDREW (int): The current stage was terminated by an employer or agency decision.
+          COMPLETED (int): The current stage is successfully completed, but the next stage (if
+          applicable) has not begun.
+          CLOSED (int): The current stage was closed without an exception, or terminated for
+          reasons unrealated to the candidate.
+        """
+
+        APPLICATION_STATE_UNSPECIFIED = 0
+        IN_PROGRESS = 1
+        CANDIDATE_WITHDREW = 2
+        EMPLOYER_WITHDREW = 3
+        COMPLETED = 4
+        CLOSED = 5
+
+
+class BatchOperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Attributes:
+          STATE_UNSPECIFIED (int): Default value.
+          INITIALIZING (int): The batch operation is being prepared for processing.
+          PROCESSING (int): The batch operation is actively being processed.
+          SUCCEEDED (int): The batch operation is processed, and at least one item has been
+          successfully processed.
+          FAILED (int): The batch operation is done and no item has been successfully processed.
+          CANCELLING (int): The batch operation is in the process of cancelling after
+          ``google.longrunning.Operations.CancelOperation`` is called.
+          CANCELLED (int): The batch operation is done after
+          ``google.longrunning.Operations.CancelOperation`` is called. Any items
+          processed before cancelling are returned in the response.
+        """
+
+        STATE_UNSPECIFIED = 0
+        INITIALIZING = 1
+        PROCESSING = 2
+        SUCCEEDED = 3
+        FAILED = 4
+        CANCELLING = 5
+        CANCELLED = 6
+
+
+class CommuteFilter(object):
+    class RoadTraffic(enum.IntEnum):
+        """
+        The traffic density to use when calculating commute time.
+
+        Attributes:
+          ROAD_TRAFFIC_UNSPECIFIED (int): Road traffic situation isn't specified.
+          TRAFFIC_FREE (int): Optimal commute time without considering any traffic impact.
+          BUSY_HOUR (int): Commute time calculation takes in account the peak traffic impact.
+        """
+
+        ROAD_TRAFFIC_UNSPECIFIED = 0
+        TRAFFIC_FREE = 1
+        BUSY_HOUR = 2
+
+
+class CompensationFilter(object):
+    class FilterType(enum.IntEnum):
+        """
+        Specify the type of filtering.
+
+        Attributes:
+          FILTER_TYPE_UNSPECIFIED (int): Filter type unspecified. Position holder, INVALID, should never be used.
+          UNIT_ONLY (int): 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``. Populate one or
+          more ``units``.
+
+          See ``CompensationInfo.CompensationEntry`` for definition of base
+          compensation entry.
+          UNIT_AND_AMOUNT (int): 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`` and amount
+          or range overlaps with provided ``CompensationRange``.
+
+          See ``CompensationInfo.CompensationEntry`` for definition of base
+          compensation entry.
+
+          Set exactly one ``units`` and populate ``range``.
+          ANNUALIZED_BASE_AMOUNT (int): Filter by annualized base compensation amount and
+          ``base compensation entry's`` unit. Populate ``range`` and zero or more
+          ``units``.
+          ANNUALIZED_TOTAL_AMOUNT (int): Filter by annualized total compensation amount and
+          ``base compensation entry's`` unit . Populate ``range`` and zero or more
+          ``units``.
+        """
+
+        FILTER_TYPE_UNSPECIFIED = 0
+        UNIT_ONLY = 1
+        UNIT_AND_AMOUNT = 2
+        ANNUALIZED_BASE_AMOUNT = 3
+        ANNUALIZED_TOTAL_AMOUNT = 4
+
+
+class CompensationInfo(object):
+    class CompensationType(enum.IntEnum):
+        """
+        The type of compensation.
+
+        For compensation amounts specified in non-monetary amounts, describe the
+        compensation scheme in the ``CompensationEntry.description``.
+
+        For example, tipping format is described in
+        ``CompensationEntry.description`` (for example, "expect 15-20% tips
+        based on customer bill.") and an estimate of the tips provided in
+        ``CompensationEntry.amount`` or ``CompensationEntry.range`` ($10 per
+        hour).
+
+        For example, equity is described in ``CompensationEntry.description``
+        (for example, "1% - 2% equity vesting over 4 years, 1 year cliff") and
+        value estimated in ``CompensationEntry.amount`` or
+        ``CompensationEntry.range``. If no value estimate is possible, units are
+        ``CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED`` and then further
+        clarified in ``CompensationEntry.description`` field.
+
+        Attributes:
+          COMPENSATION_TYPE_UNSPECIFIED (int): Default value.
+          BASE (int): Base compensation: Refers to the fixed amount of money paid to an
+          employee by an employer in return for work performed. Base compensation
+          does not include benefits, bonuses or any other potential compensation
+          from an employer.
+          BONUS (int): Bonus.
+          SIGNING_BONUS (int): Signing bonus.
+          EQUITY (int): Equity.
+          PROFIT_SHARING (int): Profit sharing.
+          COMMISSIONS (int): Commission.
+          TIPS (int): Tips.
+          OTHER_COMPENSATION_TYPE (int): Other compensation type.
+        """
+
+        COMPENSATION_TYPE_UNSPECIFIED = 0
+        BASE = 1
+        BONUS = 2
+        SIGNING_BONUS = 3
+        EQUITY = 4
+        PROFIT_SHARING = 5
+        COMMISSIONS = 6
+        TIPS = 7
+        OTHER_COMPENSATION_TYPE = 8
+
+    class CompensationUnit(enum.IntEnum):
+        """
+        Pay frequency.
+
+        Attributes:
+          COMPENSATION_UNIT_UNSPECIFIED (int): Default value.
+          HOURLY (int): Hourly.
+          DAILY (int): Daily.
+          WEEKLY (int): Weekly
+          MONTHLY (int): Monthly.
+          YEARLY (int): Yearly.
+          ONE_TIME (int): One time.
+          OTHER_COMPENSATION_UNIT (int): Other compensation units.
+        """
+
+        COMPENSATION_UNIT_UNSPECIFIED = 0
+        HOURLY = 1
+        DAILY = 2
+        WEEKLY = 3
+        MONTHLY = 4
+        YEARLY = 5
+        ONE_TIME = 6
+        OTHER_COMPENSATION_UNIT = 7
+
+
+class CompleteQueryRequest(object):
+    class CompletionScope(enum.IntEnum):
+        """
+        Enum to specify the scope of completion.
+
+        Attributes:
+          COMPLETION_SCOPE_UNSPECIFIED (int): Default value.
+          TENANT (int): Suggestions are based only on the data provided by the client.
+          PUBLIC (int): Suggestions are based on all jobs data in the system that's visible to
+          the client
+        """
+
+        COMPLETION_SCOPE_UNSPECIFIED = 0
+        TENANT = 1
+        PUBLIC = 2
+
+    class CompletionType(enum.IntEnum):
+        """
+        Enum to specify auto-completion topics.
+
+        Attributes:
+          COMPLETION_TYPE_UNSPECIFIED (int): Default value.
+          JOB_TITLE (int): Only suggest job titles.
+          COMPANY_NAME (int): Only suggest company names.
+          COMBINED (int): Suggest both job titles and company names.
+        """
+
+        COMPLETION_TYPE_UNSPECIFIED = 0
+        JOB_TITLE = 1
+        COMPANY_NAME = 2
+        COMBINED = 3
+
+
+class DeviceInfo(object):
+    class DeviceType(enum.IntEnum):
+        """
+        An enumeration describing an API access portal and exposure mechanism.
+
+        Attributes:
+          DEVICE_TYPE_UNSPECIFIED (int): The device type isn't specified.
+          WEB (int): A desktop web browser, such as, Chrome, Firefox, Safari, or Internet
+          Explorer)
+          MOBILE_WEB (int): A mobile device web browser, such as a phone or tablet with a Chrome
+          browser.
+          ANDROID (int): An Android device native application.
+          IOS (int): An iOS device native application.
+          BOT (int): A bot, as opposed to a device operated by human beings, such as a web
+          crawler.
+          OTHER (int): Other devices types.
+        """
+
+        DEVICE_TYPE_UNSPECIFIED = 0
+        WEB = 1
+        MOBILE_WEB = 2
+        ANDROID = 3
+        IOS = 4
+        BOT = 5
+        OTHER = 6
+
+
+class EmployerFilter(object):
+    class EmployerFilterMode(enum.IntEnum):
+        """
+        Enum indicating which set of ``Profile.employment_records`` to search
+        against.
+
+        Attributes:
+          EMPLOYER_FILTER_MODE_UNSPECIFIED (int): Default value.
+          ALL_EMPLOYMENT_RECORDS (int): Apply to all employers in ``Profile.employment_records``.
+          CURRENT_EMPLOYMENT_RECORDS_ONLY (int): Apply only to current employer in ``Profile.employment_records``.
+          PAST_EMPLOYMENT_RECORDS_ONLY (int): Apply only to past (not current) employers in
+          ``Profile.employment_records``.
+        """
+
+        EMPLOYER_FILTER_MODE_UNSPECIFIED = 0
+        ALL_EMPLOYMENT_RECORDS = 1
+        CURRENT_EMPLOYMENT_RECORDS_ONLY = 2
+        PAST_EMPLOYMENT_RECORDS_ONLY = 3
+
+
+class JobEvent(object):
+    class JobEventType(enum.IntEnum):
+        """
+        An enumeration of an event attributed to the behavior of the end user,
+        such as a job seeker.
+
+        Attributes:
+          JOB_EVENT_TYPE_UNSPECIFIED (int): The event is unspecified by other provided values.
+          IMPRESSION (int): The job seeker or other entity interacting with the service has
+          had a job rendered in their view, such as in a list of search results in
+          a compressed or clipped format. This event is typically associated with
+          the viewing of a jobs list on a single page by a job seeker.
+          VIEW (int): The job seeker, or other entity interacting with the service, has viewed
+          the details of a job, including the full description. This event doesn't
+          apply to the viewing a snippet of a job appearing as a part of the job
+          search results. Viewing a snippet is associated with an ``impression``).
+          VIEW_REDIRECT (int): The job seeker or other entity interacting with the service
+          performed an action to view a job and was redirected to a different
+          website for job.
+          APPLICATION_START (int): The job seeker or other entity interacting with the service
+          began the process or demonstrated the intention of applying for a job.
+          APPLICATION_FINISH (int): The job seeker or other entity interacting with the service
+          submitted an application for a job.
+          APPLICATION_QUICK_SUBMISSION (int): The job seeker or other entity interacting with the service 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`` or
+          ``JobEventType.APPLICATION_FINISH`` events.
+          APPLICATION_REDIRECT (int): The job seeker or other entity interacting with the service
+          performed an action to apply to a job and was redirected to a different
+          website to complete the application.
+          APPLICATION_START_FROM_SEARCH (int): The job seeker or other entity interacting with the service began the
+          process or demonstrated the intention of applying for a job from the
+          search results page without viewing the details of the job posting.
+          If sending this event, JobEventType.VIEW event shouldn't be sent.
+          APPLICATION_REDIRECT_FROM_SEARCH (int): The job seeker, or other entity interacting with the service, performs
+          an action with a single click from the search results page to apply to a
+          job (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``,
+          ``JobEventType.APPLICATION_FINISH`` or ``JobEventType.VIEW`` events.
+          APPLICATION_COMPANY_SUBMIT (int): This event should be used when a company submits an application
+          on behalf of a job seeker. This event is intended for use by staffing
+          agencies attempting to place candidates.
+          BOOKMARK (int): The job seeker or other entity interacting with the service demonstrated
+          an interest in a job by bookmarking or saving it.
+          NOTIFICATION (int): The job seeker or other entity interacting with the service was
+          sent a notification, such as an email alert or device notification,
+          containing one or more jobs listings generated by the service.
+          HIRED (int): The job seeker or other entity interacting with the service was
+          employed by the hiring entity (employer). Send this event
+          only if the job seeker was hired through an application that was
+          initiated by a search conducted through the Cloud Talent Solution
+          service.
+          SENT_CV (int): A recruiter or staffing agency submitted an application on behalf of the
+          candidate after interacting with the service to identify a suitable job
+          posting.
+          INTERVIEW_GRANTED (int): The entity interacting with the service (for example, the job seeker),
+          was granted an initial interview by the hiring entity (employer). This
+          event should only be sent if the job seeker was granted an interview as
+          part of an application that was initiated by a search conducted through /
+          recommendation provided by the Cloud Talent Solution service.
+        """
+
+        JOB_EVENT_TYPE_UNSPECIFIED = 0
+        IMPRESSION = 1
+        VIEW = 2
+        VIEW_REDIRECT = 3
+        APPLICATION_START = 4
+        APPLICATION_FINISH = 5
+        APPLICATION_QUICK_SUBMISSION = 6
+        APPLICATION_REDIRECT = 7
+        APPLICATION_START_FROM_SEARCH = 8
+        APPLICATION_REDIRECT_FROM_SEARCH = 9
+        APPLICATION_COMPANY_SUBMIT = 10
+        BOOKMARK = 11
+        NOTIFICATION = 12
+        HIRED = 13
+        SENT_CV = 14
+        INTERVIEW_GRANTED = 15
+
+
+class Location(object):
+    class LocationType(enum.IntEnum):
+        """
+        An enum which represents the type of a location.
+
+        Attributes:
+          LOCATION_TYPE_UNSPECIFIED (int): Default value if the type isn't specified.
+          COUNTRY (int): A country level location.
+          ADMINISTRATIVE_AREA (int): A state or equivalent level location.
+          SUB_ADMINISTRATIVE_AREA (int): A county or equivalent level location.
+          LOCALITY (int): A city or equivalent level location.
+          POSTAL_CODE (int): A postal code level location.
+          SUB_LOCALITY (int): A sublocality is a subdivision of a locality, for example a city borough,
+          ward, or arrondissement. Sublocalities are usually recognized by a local
+          political authority. For example, Manhattan and Brooklyn are recognized
+          as boroughs by the City of New York, and are therefore modeled as
+          sublocalities.
+          SUB_LOCALITY_1 (int): A district or equivalent level location.
+          SUB_LOCALITY_2 (int): A smaller district or equivalent level display.
+          NEIGHBORHOOD (int): A neighborhood level location.
+          STREET_ADDRESS (int): A street address level location.
+        """
+
+        LOCATION_TYPE_UNSPECIFIED = 0
+        COUNTRY = 1
+        ADMINISTRATIVE_AREA = 2
+        SUB_ADMINISTRATIVE_AREA = 3
+        LOCALITY = 4
+        POSTAL_CODE = 5
+        SUB_LOCALITY = 6
+        SUB_LOCALITY_1 = 7
+        SUB_LOCALITY_2 = 8
+        NEIGHBORHOOD = 9
+        STREET_ADDRESS = 10
+
+
+class LocationFilter(object):
+    class TelecommutePreference(enum.IntEnum):
+        """
+        Specify whether to include telecommute jobs.
+
+        Attributes:
+          TELECOMMUTE_PREFERENCE_UNSPECIFIED (int): Default value if the telecommute preference isn't specified.
+          TELECOMMUTE_EXCLUDED (int): Exclude telecommute jobs.
+          TELECOMMUTE_ALLOWED (int): Allow telecommute jobs.
+        """
+
+        TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0
+        TELECOMMUTE_EXCLUDED = 1
+        TELECOMMUTE_ALLOWED = 2
+
+
+class Phone(object):
+    class PhoneType(enum.IntEnum):
+        """
+        Enum that represents the type of the telephone.
+
+        Attributes:
+          PHONE_TYPE_UNSPECIFIED (int): Default value.
+          LANDLINE (int): A landline.
+          MOBILE (int): A mobile.
+          FAX (int): A fax.
+          PAGER (int): A pager.
+          TTY_OR_TDD (int): A TTY (test telephone) or TDD (telecommunication device for the deaf).
+          VOICEMAIL (int): A voicemail.
+          VIRTUAL (int): 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`` should be set to PERSONAL
+          for these phone types. Some more information can be found here:
+          http://en.wikipedia.org/wiki/Personal\_Numbers
+          VOIP (int): Voice over IP numbers. This includes TSoIP (Telephony Service over IP).
+          MOBILE_OR_LANDLINE (int): In some regions (e.g. the USA), it is impossible to distinguish between
+          fixed-line and mobile numbers by looking at the phone number itself.
+        """
+
+        PHONE_TYPE_UNSPECIFIED = 0
+        LANDLINE = 1
+        MOBILE = 2
+        FAX = 3
+        PAGER = 4
+        TTY_OR_TDD = 5
+        VOICEMAIL = 6
+        VIRTUAL = 7
+        VOIP = 8
+        MOBILE_OR_LANDLINE = 9
+
+
+class ProfileEvent(object):
+    class ProfileEventType(enum.IntEnum):
+        """
+        The enum represents types of client events for a candidate profile.
+
+        Attributes:
+          PROFILE_EVENT_TYPE_UNSPECIFIED (int): Default value.
+          IMPRESSION (int): Send this event when a ``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``).
+          VIEW (int): 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).
+
+          For a VIEW events associated with API calls, the
+          ``ClientEvent.request_id`` should be populated. If the VIEW is not
+          associated with an API call, ``request_id`` should not be populated.
+
+          This event requires a valid recruiter and one valid ID in profiles.
+          BOOKMARK (int): The profile is bookmarked.
+        """
+
+        PROFILE_EVENT_TYPE_UNSPECIFIED = 0
+        IMPRESSION = 1
+        VIEW = 2
+        BOOKMARK = 3
+
+
+class Resume(object):
+    class ResumeType(enum.IntEnum):
+        """
+        The format of a structured resume.
+
+        Attributes:
+          RESUME_TYPE_UNSPECIFIED (int): Default value.
+          HRXML (int): The profile contents in HR-XML format.
+          See http://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
+          information about Human Resources XML.
+          OTHER_RESUME_TYPE (int): Resume type not specified.
+        """
+
+        RESUME_TYPE_UNSPECIFIED = 0
+        HRXML = 1
+        OTHER_RESUME_TYPE = 2
+
+
+class SearchJobsRequest(object):
+    class DiversificationLevel(enum.IntEnum):
+        """
+        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.
+
+        Attributes:
+          DIVERSIFICATION_LEVEL_UNSPECIFIED (int): The diversification level isn't specified.
+          DISABLED (int): Disables diversification. Jobs that would normally be pushed to the last
+          page would not have their positions altered. This may result in highly
+          similar jobs appearing in sequence in the search results.
+          SIMPLE (int): 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.
+        """
+
+        DIVERSIFICATION_LEVEL_UNSPECIFIED = 0
+        DISABLED = 1
+        SIMPLE = 2
+
+    class SearchMode(enum.IntEnum):
+        """
+        A string-represented enumeration of the job search mode. The service
+        operate differently for different modes of service.
+
+        Attributes:
+          SEARCH_MODE_UNSPECIFIED (int): The mode of the search method isn't specified.
+          JOB_SEARCH (int): The job search matches against all jobs, and featured jobs
+          (jobs with promotionValue > 0) are not specially handled.
+          FEATURED_JOB_SEARCH (int): The job search matches only against featured jobs (jobs with a
+          promotionValue > 0). This method doesn't return any jobs having a
+          promotionValue <= 0. The search results order is determined by the
+          promotionValue (jobs with a higher promotionValue are returned higher up
+          in the search results), with relevance being used as a tiebreaker.
+        """
+
+        SEARCH_MODE_UNSPECIFIED = 0
+        JOB_SEARCH = 1
+        FEATURED_JOB_SEARCH = 2
+
+    class CustomRankingInfo(object):
+        class ImportanceLevel(enum.IntEnum):
+            """
+            The importance level for ``CustomRankingInfo.ranking_expression``.
+
+            Attributes:
+              IMPORTANCE_LEVEL_UNSPECIFIED (int): Default value if the importance level isn't specified.
+              NONE (int): The given ranking expression is of None importance, existing relevance
+              score (determined by API algorithm) dominates job's final ranking
+              position.
+              LOW (int): The given ranking expression is of Low importance in terms of job's
+              final ranking position compared to existing relevance
+              score (determined by API algorithm).
+              MILD (int): The given ranking expression is of Mild importance in terms of job's
+              final ranking position compared to existing relevance
+              score (determined by API algorithm).
+              MEDIUM (int): The given ranking expression is of Medium importance in terms of job's
+              final ranking position compared to existing relevance
+              score (determined by API algorithm).
+              HIGH (int): The given ranking expression is of High importance in terms of job's
+              final ranking position compared to existing relevance
+              score (determined by API algorithm).
+              EXTREME (int): The given ranking expression is of Extreme importance, and dominates
+              job's final ranking position with existing relevance
+              score (determined by API algorithm) ignored.
+            """
+
+            IMPORTANCE_LEVEL_UNSPECIFIED = 0
+            NONE = 1
+            LOW = 2
+            MILD = 3
+            MEDIUM = 4
+            HIGH = 5
+            EXTREME = 6
+
+
+class Tenant(object):
+    class DataUsageType(enum.IntEnum):
+        """
+        Enum that represents how user data owned by the tenant is used.
+
+        Attributes:
+          DATA_USAGE_TYPE_UNSPECIFIED (int): Default value.
+          AGGREGATED (int): Data owned by this tenant is used to improve search/recommendation
+          quality across tenants.
+          ISOLATED (int): Data owned by this tenant is used to improve search/recommendation
+          quality for this tenant only.
+        """
+
+        DATA_USAGE_TYPE_UNSPECIFIED = 0
+        AGGREGATED = 1
+        ISOLATED = 2
+
+
+class TimeFilter(object):
+    class TimeField(enum.IntEnum):
+        """
+        Time fields can be used in TimeFilter.
+
+        Attributes:
+          TIME_FIELD_UNSPECIFIED (int): Default value.
+          CREATE_TIME (int): Earliest profile create time.
+          UPDATE_TIME (int): Latest profile update time.
+        """
+
+        TIME_FIELD_UNSPECIFIED = 0
+        CREATE_TIME = 1
+        UPDATE_TIME = 2
diff --git a/talent/google/cloud/talent_v4beta1/gapic/event_service_client.py b/talent/google/cloud/talent_v4beta1/gapic/event_service_client.py
new file mode 100644
index 000000000000..3acdec7d3aae
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/event_service_client.py
@@ -0,0 +1,300 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 EventService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic import event_service_client_config
+from google.cloud.talent_v4beta1.gapic.transports import event_service_grpc_transport
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+from google.cloud.talent_v4beta1.proto import completion_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import event_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class EventServiceClient(object):
+    """A service handles client event report."""
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.EventService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            EventServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def tenant_path(cls, project, tenant):
+        """Return a fully-qualified tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}", project=project, tenant=tenant
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.EventServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.EventServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = event_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=event_service_grpc_transport.EventServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = event_service_grpc_transport.EventServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_client_event(
+        self,
+        parent,
+        client_event,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Report events issued when end user interacts with customer's application
+        that uses Cloud Talent Solution. You may inspect the created events in
+        `self service
+        tools <https://console.cloud.google.com/talent-solution/overview>`__.
+        `Learn
+        more <https://cloud.google.com/talent-solution/docs/management-tools>`__
+        about self service tools.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.EventServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `client_event`:
+            >>> client_event = {}
+            >>>
+            >>> response = client.create_client_event(parent, client_event)
+
+        Args:
+            parent (str): 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".
+            client_event (Union[dict, ~google.cloud.talent_v4beta1.types.ClientEvent]): Required. Events issued when end user interacts with customer's application
+                that uses Cloud Talent Solution.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.ClientEvent`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.ClientEvent` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_client_event" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_client_event"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_client_event,
+                default_retry=self._method_configs["CreateClientEvent"].retry,
+                default_timeout=self._method_configs["CreateClientEvent"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = event_service_pb2.CreateClientEventRequest(
+            parent=parent, client_event=client_event
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_client_event"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/talent/google/cloud/talent_v4beta1/gapic/event_service_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/event_service_client_config.py
new file mode 100644
index 000000000000..0e27fa36f15d
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/event_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.EventService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateClientEvent": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/job_service_client.py b/talent/google/cloud/talent_v4beta1/gapic/job_service_client.py
new file mode 100644
index 000000000000..ae4832568656
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/job_service_client.py
@@ -0,0 +1,1743 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 JobService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic import job_service_client_config
+from google.cloud.talent_v4beta1.gapic.transports import job_service_grpc_transport
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import common_pb2
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+from google.cloud.talent_v4beta1.proto import completion_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import event_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import filters_pb2
+from google.cloud.talent_v4beta1.proto import histogram_pb2
+from google.cloud.talent_v4beta1.proto import job_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class JobServiceClient(object):
+    """A service handles job management, including job CRUD, enumeration and search."""
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.JobService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            JobServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def company_path(cls, project, tenant, company):
+        """Return a fully-qualified company string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/companies/{company}",
+            project=project,
+            tenant=tenant,
+            company=company,
+        )
+
+    @classmethod
+    def company_without_tenant_path(cls, project, company):
+        """Return a fully-qualified company_without_tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/companies/{company}", project=project, company=company
+        )
+
+    @classmethod
+    def job_path(cls, project, tenant, jobs):
+        """Return a fully-qualified job string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/jobs/{jobs}",
+            project=project,
+            tenant=tenant,
+            jobs=jobs,
+        )
+
+    @classmethod
+    def job_without_tenant_path(cls, project, jobs):
+        """Return a fully-qualified job_without_tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/jobs/{jobs}", project=project, jobs=jobs
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def tenant_path(cls, project, tenant):
+        """Return a fully-qualified tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}", project=project, tenant=tenant
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.JobServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.JobServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = job_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=job_service_grpc_transport.JobServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = job_service_grpc_transport.JobServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_job(
+        self,
+        parent,
+        job,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new job.
+
+        Typically, the job becomes searchable within 10 seconds, but it may take
+        up to 5 minutes.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.create_job(parent, job)
+
+        Args:
+            parent (str): 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".
+            job (Union[dict, ~google.cloud.talent_v4beta1.types.Job]): Required. The Job to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Job`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_job,
+                default_retry=self._method_configs["CreateJob"].retry,
+                default_timeout=self._method_configs["CreateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.CreateJobRequest(parent=parent, job=job)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves the specified job, whose status is OPEN or recently EXPIRED
+        within the last 90 days.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[TENANT]', '[JOBS]')
+            >>>
+            >>> response = client.get_job(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_job,
+                default_retry=self._method_configs["GetJob"].retry,
+                default_timeout=self._method_configs["GetJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.GetJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_job(
+        self,
+        job,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates specified job.
+
+        Typically, updated contents become visible in search results within 10
+        seconds, but it may take up to 5 minutes.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> # TODO: Initialize `job`:
+            >>> job = {}
+            >>>
+            >>> response = client.update_job(job)
+
+        Args:
+            job (Union[dict, ~google.cloud.talent_v4beta1.types.Job]): Required. The Job to be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Job`
+            update_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional but strongly recommended to be provided for the best service
+                experience.
+
+                If ``update_mask`` is provided, only the specified fields in ``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`` are supported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Job` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_job,
+                default_retry=self._method_configs["UpdateJob"].retry,
+                default_timeout=self._method_configs["UpdateJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.UpdateJobRequest(job=job, update_mask=update_mask)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("job.name", job.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_job(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the specified job.
+
+        Typically, the job becomes unsearchable within 10 seconds, but it may take
+        up to 5 minutes.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> name = client.job_path('[PROJECT]', '[TENANT]', '[JOBS]')
+            >>>
+            >>> client.delete_job(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_job" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_job"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_job,
+                default_retry=self._method_configs["DeleteJob"].retry,
+                default_timeout=self._method_configs["DeleteJob"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.DeleteJobRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_job"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_jobs(
+        self,
+        parent,
+        filter_,
+        page_size=None,
+        job_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists jobs by filter.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_jobs(parent, filter_):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_jobs(parent, filter_).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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".
+            filter_ (str): Required. The filter string specifies the jobs to be enumerated.
+
+                Supported operator: =, AND
+
+                The fields eligible for filtering are:
+
+                -  ``companyName`` (Required)
+                -  ``requisitionId`` (Optional)
+                -  ``status`` (Optional) 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 requisitionId = "req-1"
+                -  companyName = "projects/api-test-project/tenants/foo/companies/bar"
+                   AND status = "EXPIRED"
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            job_view (~google.cloud.talent_v4beta1.types.JobView): Optional. The desired job attributes returned for jobs in the search
+                response. Defaults to ``JobView.JOB_VIEW_FULL`` if no value is
+                specified.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.Job` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_jobs,
+                default_retry=self._method_configs["ListJobs"].retry,
+                default_timeout=self._method_configs["ListJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.ListJobsRequest(
+            parent=parent, filter=filter_, page_size=page_size, job_view=job_view
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def batch_delete_jobs(
+        self,
+        parent,
+        filter_,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a list of ``Job``\ s by filter.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> client.batch_delete_jobs(parent, filter_)
+
+        Args:
+            parent (str): 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".
+            filter_ (str): Required. The filter string specifies the jobs to be deleted.
+
+                Supported operator: =, AND
+
+                The fields eligible for filtering are:
+
+                -  ``companyName`` (Required)
+                -  ``requisitionId`` (Required)
+
+                Sample Query: companyName = "projects/api-test-project/companies/123"
+                AND requisitionId = "req-1"
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_delete_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_delete_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_delete_jobs,
+                default_retry=self._method_configs["BatchDeleteJobs"].retry,
+                default_timeout=self._method_configs["BatchDeleteJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.BatchDeleteJobsRequest(parent=parent, filter=filter_)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["batch_delete_jobs"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_jobs(
+        self,
+        parent,
+        request_metadata,
+        search_mode=None,
+        job_query=None,
+        enable_broadening=None,
+        require_precise_result_size=None,
+        histogram_queries=None,
+        job_view=None,
+        offset=None,
+        page_size=None,
+        order_by=None,
+        diversification_level=None,
+        custom_ranking_info=None,
+        disable_keyword_match=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Searches for jobs using the provided ``SearchJobsRequest``.
+
+        This call constrains the ``visibility`` of jobs present in the database,
+        and only returns jobs that the caller has permission to search against.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `request_metadata`:
+            >>> request_metadata = {}
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_jobs(parent, request_metadata):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_jobs(parent, request_metadata).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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".
+            request_metadata (Union[dict, ~google.cloud.talent_v4beta1.types.RequestMetadata]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.RequestMetadata`
+            search_mode (~google.cloud.talent_v4beta1.types.SearchMode): Optional. Mode of a search.
+
+                Defaults to ``SearchMode.JOB_SEARCH``.
+            job_query (Union[dict, ~google.cloud.talent_v4beta1.types.JobQuery]): Optional. Query used to search against jobs, such as keyword, location
+                filters, etc.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.JobQuery`
+            enable_broadening (bool): Optional. 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.
+            require_precise_result_size (bool): Optional. 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.
+
+                Enabling this flag may adversely impact performance.
+
+                Defaults to false.
+            histogram_queries (list[Union[dict, ~google.cloud.talent_v4beta1.types.HistogramQuery]]): Optional. An expression specifies a histogram request against matching
+                jobs.
+
+                Expression syntax is an aggregation function call with histogram facets
+                and other options.
+
+                Available aggregation function calls are:
+
+                -  ``count(string_histogram_facet)``: Count the number of matching
+                   entities, for each distinct attribute value.
+                -  ``count(numeric_histogram_facet, list of buckets)``: Count the number
+                   of matching entities within each bucket.
+
+                Data types:
+
+                -  Histogram facet: facet names with format [a-zA-Z][a-zA-Z0-9\_]+.
+                -  String: string like "any string with backslash escape for quote(")."
+                -  Number: whole number and floating point number like 10, -1 and -0.01.
+                -  List: list of elements with comma(,) separator surrounded by square
+                   brackets, for example, [1, 2, 3] and ["one", "two", "three"].
+
+                Built-in constants:
+
+                -  MIN (minimum number similar to java Double.MIN\_VALUE)
+                -  MAX (maximum number similar to java Double.MAX\_VALUE)
+
+                Built-in functions:
+
+                -  bucket(start, end[, label]): bucket built-in function creates a
+                   bucket with range of \`start, end). Note that the end is exclusive,
+                   for example, bucket(1, MAX, "positive number") or bucket(1, 10).
+
+                Job histogram facets:
+
+                -  company\_display\_name: histogram by [Job.company\_display\_name\`.
+                -  employment\_type: histogram by ``Job.employment_types``, for example,
+                   "FULL\_TIME", "PART\_TIME".
+                -  company\_size: histogram by ``CompanySize``, for example, "SMALL",
+                   "MEDIUM", "BIG".
+                -  publish\_time\_in\_month: histogram by the
+                   ``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`` in years. Must specify list of numeric
+                   buckets in spec.
+                -  degree\_types: histogram by the ``Job.degree_types``, for example,
+                   "Bachelors", "Masters".
+                -  job\_level: histogram by the ``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
+                   placeholder referring to the state, province, or the particular term
+                   a country uses to define the geographic structure below the country
+                   level, for example, "CA", "IL".
+                -  city: histogram by a combination of the "city name, admin1 code". For
+                   example, "Mountain View, CA", "New York, NY".
+                -  admin1\_country: histogram by a combination of the "admin1 code,
+                   country", for example, "CA, US", "IL, US".
+                -  city\_coordinate: histogram by the city center's GPS coordinates
+                   (latitude 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``, for example, "en-US",
+                   "fr-FR".
+                -  language: histogram by the language subtag of the
+                   ``Job.language_code``, for example, "en", "fr".
+                -  category: histogram by the ``JobCategory``, for example,
+                   "COMPUTER\_AND\_IT", "HEALTHCARE".
+                -  base\_compensation\_unit: histogram by the
+                   ``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``. Values can be accessed via square bracket
+                   notations like string\_custom\_attribute["key1"].
+                -  numeric\_custom\_attribute: histogram by numeric
+                   ``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.
+
+                Example expressions:
+
+                -  ``count(admin1)``
+                -  ``count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])``
+                -  ``count(string_custom_attribute["some-string-custom-attribute"])``
+                -  ``count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.HistogramQuery`
+            job_view (~google.cloud.talent_v4beta1.types.JobView): Optional. The desired job attributes returned for jobs in the search
+                response. Defaults to ``JobView.JOB_VIEW_SMALL`` if no value is
+                specified.
+            offset (int): 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`` is unset.
+
+                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
+                pagination, (for example, pageSize = 10 and offset = 10 means to return
+                from the second page).
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Optional. The criteria determining how search results are sorted.
+                Default is ``"relevance desc"``.
+
+                Supported options are:
+
+                -  ``"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``
+                   descending.
+                -  ``"posting_update_time desc"``: By ``Job.posting_update_time``
+                   descending.
+                -  ``"title"``: By ``Job.title`` ascending.
+                -  ``"title desc"``: By ``Job.title`` descending.
+                -  ``"annualized_base_compensation"``: By job's
+                   ``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`` 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`` 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`` 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`` with
+                   weight factor assigned by
+                   ``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.
+                   ``"distance_from('Hawaii'), distance_from('Puerto Rico')"``: Order by
+                   multiple locations. See details below.
+                   ``"distance_from('Hawaii'), distance_from(19.89, 155.5)"``: Order by
+                   multiple locations. See details below. The string can have a maximum
+                   of 256 characters. When multiple distance centers are provided, a job
+                   that is close to any of the distance centers would have a high rank.
+                   When a job has multiple locations, the job location closest to one of
+                   the distance centers will be used. Jobs that don't have locations
+                   will be ranked at the bottom. Distance is calculated with a precision
+                   of 11.3 meters (37.4 feet). Diversification strategy is still applied
+                   unless explicitly disabled in ``diversification_level``.
+            diversification_level (~google.cloud.talent_v4beta1.types.DiversificationLevel): Optional. 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`` if no value is specified.
+            custom_ranking_info (Union[dict, ~google.cloud.talent_v4beta1.types.CustomRankingInfo]): Optional. Controls over how job documents get ranked on top of existing
+                relevance score (determined by API algorithm).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.CustomRankingInfo`
+            disable_keyword_match (bool): Optional. Controls whether to disable exact keyword match on
+                ``Job.title``, ``Job.description``, ``Job.company_display_name``,
+                ``Job.addresses``, ``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`` if
+                company-specific globally matched custom field/attribute string values
+                are needed. Enabling keyword match improves recall of subsequent search
+                requests.
+
+                Defaults to false.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.MatchingJob` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_jobs,
+                default_retry=self._method_configs["SearchJobs"].retry,
+                default_timeout=self._method_configs["SearchJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.SearchJobsRequest(
+            parent=parent,
+            request_metadata=request_metadata,
+            search_mode=search_mode,
+            job_query=job_query,
+            enable_broadening=enable_broadening,
+            require_precise_result_size=require_precise_result_size,
+            histogram_queries=histogram_queries,
+            job_view=job_view,
+            offset=offset,
+            page_size=page_size,
+            order_by=order_by,
+            diversification_level=diversification_level,
+            custom_ranking_info=custom_ranking_info,
+            disable_keyword_match=disable_keyword_match,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_jobs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="matching_jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def search_jobs_for_alert(
+        self,
+        parent,
+        request_metadata,
+        search_mode=None,
+        job_query=None,
+        enable_broadening=None,
+        require_precise_result_size=None,
+        histogram_queries=None,
+        job_view=None,
+        offset=None,
+        page_size=None,
+        order_by=None,
+        diversification_level=None,
+        custom_ranking_info=None,
+        disable_keyword_match=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Searches for jobs using the provided ``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`` of jobs present in the database,
+        and only returns jobs the caller has permission to search against.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `request_metadata`:
+            >>> request_metadata = {}
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_jobs_for_alert(parent, request_metadata):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_jobs_for_alert(parent, request_metadata).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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".
+            request_metadata (Union[dict, ~google.cloud.talent_v4beta1.types.RequestMetadata]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.RequestMetadata`
+            search_mode (~google.cloud.talent_v4beta1.types.SearchMode): Optional. Mode of a search.
+
+                Defaults to ``SearchMode.JOB_SEARCH``.
+            job_query (Union[dict, ~google.cloud.talent_v4beta1.types.JobQuery]): Optional. Query used to search against jobs, such as keyword, location
+                filters, etc.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.JobQuery`
+            enable_broadening (bool): Optional. 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.
+            require_precise_result_size (bool): Optional. 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.
+
+                Enabling this flag may adversely impact performance.
+
+                Defaults to false.
+            histogram_queries (list[Union[dict, ~google.cloud.talent_v4beta1.types.HistogramQuery]]): Optional. An expression specifies a histogram request against matching
+                jobs.
+
+                Expression syntax is an aggregation function call with histogram facets
+                and other options.
+
+                Available aggregation function calls are:
+
+                -  ``count(string_histogram_facet)``: Count the number of matching
+                   entities, for each distinct attribute value.
+                -  ``count(numeric_histogram_facet, list of buckets)``: Count the number
+                   of matching entities within each bucket.
+
+                Data types:
+
+                -  Histogram facet: facet names with format [a-zA-Z][a-zA-Z0-9\_]+.
+                -  String: string like "any string with backslash escape for quote(")."
+                -  Number: whole number and floating point number like 10, -1 and -0.01.
+                -  List: list of elements with comma(,) separator surrounded by square
+                   brackets, for example, [1, 2, 3] and ["one", "two", "three"].
+
+                Built-in constants:
+
+                -  MIN (minimum number similar to java Double.MIN\_VALUE)
+                -  MAX (maximum number similar to java Double.MAX\_VALUE)
+
+                Built-in functions:
+
+                -  bucket(start, end[, label]): bucket built-in function creates a
+                   bucket with range of \`start, end). Note that the end is exclusive,
+                   for example, bucket(1, MAX, "positive number") or bucket(1, 10).
+
+                Job histogram facets:
+
+                -  company\_display\_name: histogram by [Job.company\_display\_name\`.
+                -  employment\_type: histogram by ``Job.employment_types``, for example,
+                   "FULL\_TIME", "PART\_TIME".
+                -  company\_size: histogram by ``CompanySize``, for example, "SMALL",
+                   "MEDIUM", "BIG".
+                -  publish\_time\_in\_month: histogram by the
+                   ``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`` in years. Must specify list of numeric
+                   buckets in spec.
+                -  degree\_types: histogram by the ``Job.degree_types``, for example,
+                   "Bachelors", "Masters".
+                -  job\_level: histogram by the ``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
+                   placeholder referring to the state, province, or the particular term
+                   a country uses to define the geographic structure below the country
+                   level, for example, "CA", "IL".
+                -  city: histogram by a combination of the "city name, admin1 code". For
+                   example, "Mountain View, CA", "New York, NY".
+                -  admin1\_country: histogram by a combination of the "admin1 code,
+                   country", for example, "CA, US", "IL, US".
+                -  city\_coordinate: histogram by the city center's GPS coordinates
+                   (latitude 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``, for example, "en-US",
+                   "fr-FR".
+                -  language: histogram by the language subtag of the
+                   ``Job.language_code``, for example, "en", "fr".
+                -  category: histogram by the ``JobCategory``, for example,
+                   "COMPUTER\_AND\_IT", "HEALTHCARE".
+                -  base\_compensation\_unit: histogram by the
+                   ``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``. Values can be accessed via square bracket
+                   notations like string\_custom\_attribute["key1"].
+                -  numeric\_custom\_attribute: histogram by numeric
+                   ``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.
+
+                Example expressions:
+
+                -  ``count(admin1)``
+                -  ``count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000), bucket(100000, MAX)])``
+                -  ``count(string_custom_attribute["some-string-custom-attribute"])``
+                -  ``count(numeric_custom_attribute["some-numeric-custom-attribute"], [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])``
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.HistogramQuery`
+            job_view (~google.cloud.talent_v4beta1.types.JobView): Optional. The desired job attributes returned for jobs in the search
+                response. Defaults to ``JobView.JOB_VIEW_SMALL`` if no value is
+                specified.
+            offset (int): 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`` is unset.
+
+                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
+                pagination, (for example, pageSize = 10 and offset = 10 means to return
+                from the second page).
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            order_by (str): Optional. The criteria determining how search results are sorted.
+                Default is ``"relevance desc"``.
+
+                Supported options are:
+
+                -  ``"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``
+                   descending.
+                -  ``"posting_update_time desc"``: By ``Job.posting_update_time``
+                   descending.
+                -  ``"title"``: By ``Job.title`` ascending.
+                -  ``"title desc"``: By ``Job.title`` descending.
+                -  ``"annualized_base_compensation"``: By job's
+                   ``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`` 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`` 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`` 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`` with
+                   weight factor assigned by
+                   ``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.
+                   ``"distance_from('Hawaii'), distance_from('Puerto Rico')"``: Order by
+                   multiple locations. See details below.
+                   ``"distance_from('Hawaii'), distance_from(19.89, 155.5)"``: Order by
+                   multiple locations. See details below. The string can have a maximum
+                   of 256 characters. When multiple distance centers are provided, a job
+                   that is close to any of the distance centers would have a high rank.
+                   When a job has multiple locations, the job location closest to one of
+                   the distance centers will be used. Jobs that don't have locations
+                   will be ranked at the bottom. Distance is calculated with a precision
+                   of 11.3 meters (37.4 feet). Diversification strategy is still applied
+                   unless explicitly disabled in ``diversification_level``.
+            diversification_level (~google.cloud.talent_v4beta1.types.DiversificationLevel): Optional. 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`` if no value is specified.
+            custom_ranking_info (Union[dict, ~google.cloud.talent_v4beta1.types.CustomRankingInfo]): Optional. Controls over how job documents get ranked on top of existing
+                relevance score (determined by API algorithm).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.CustomRankingInfo`
+            disable_keyword_match (bool): Optional. Controls whether to disable exact keyword match on
+                ``Job.title``, ``Job.description``, ``Job.company_display_name``,
+                ``Job.addresses``, ``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`` if
+                company-specific globally matched custom field/attribute string values
+                are needed. Enabling keyword match improves recall of subsequent search
+                requests.
+
+                Defaults to false.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.MatchingJob` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_jobs_for_alert" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_jobs_for_alert"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_jobs_for_alert,
+                default_retry=self._method_configs["SearchJobsForAlert"].retry,
+                default_timeout=self._method_configs["SearchJobsForAlert"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.SearchJobsRequest(
+            parent=parent,
+            request_metadata=request_metadata,
+            search_mode=search_mode,
+            job_query=job_query,
+            enable_broadening=enable_broadening,
+            require_precise_result_size=require_precise_result_size,
+            histogram_queries=histogram_queries,
+            job_view=job_view,
+            offset=offset,
+            page_size=page_size,
+            order_by=order_by,
+            diversification_level=diversification_level,
+            custom_ranking_info=custom_ranking_info,
+            disable_keyword_match=disable_keyword_match,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_jobs_for_alert"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="matching_jobs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def batch_create_jobs(
+        self,
+        parent,
+        jobs,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Begins executing a batch create jobs operation.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `jobs`:
+            >>> jobs = []
+            >>>
+            >>> response = client.batch_create_jobs(parent, jobs)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): 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".
+            jobs (list[Union[dict, ~google.cloud.talent_v4beta1.types.Job]]): Required. The jobs to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Job`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_create_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_create_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_create_jobs,
+                default_retry=self._method_configs["BatchCreateJobs"].retry,
+                default_timeout=self._method_configs["BatchCreateJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.BatchCreateJobsRequest(parent=parent, jobs=jobs)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["batch_create_jobs"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            job_service_pb2.JobOperationResult,
+            metadata_type=common_pb2.BatchOperationMetadata,
+        )
+
+    def batch_update_jobs(
+        self,
+        parent,
+        jobs,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Begins executing a batch update jobs operation.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.JobServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `jobs`:
+            >>> jobs = []
+            >>>
+            >>> response = client.batch_update_jobs(parent, jobs)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): 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".
+            jobs (list[Union[dict, ~google.cloud.talent_v4beta1.types.Job]]): Required. The jobs to be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Job`
+            update_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional but strongly recommended to be provided for the best service
+                experience, also increase latency when checking status of batch
+                operation.
+
+                If ``update_mask`` is provided, only the specified fields in ``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`` are supported.
+
+                If ``update_mask`` is provided, The ``Job`` inside ``JobResult`` will
+                only contains fields that is updated, plus the Id of the Job. Otherwise,
+                ``Job`` will include all fields, which can yield a very large response.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_update_jobs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_update_jobs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_update_jobs,
+                default_retry=self._method_configs["BatchUpdateJobs"].retry,
+                default_timeout=self._method_configs["BatchUpdateJobs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = job_service_pb2.BatchUpdateJobsRequest(
+            parent=parent, jobs=jobs, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["batch_update_jobs"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            job_service_pb2.JobOperationResult,
+            metadata_type=common_pb2.BatchOperationMetadata,
+        )
diff --git a/talent/google/cloud/talent_v4beta1/gapic/job_service_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/job_service_client_config.py
new file mode 100644
index 000000000000..75a43488a836
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/job_service_client_config.py
@@ -0,0 +1,73 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.JobService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteJob": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchDeleteJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchJobsForAlert": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchCreateJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchUpdateJobs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/profile_service_client.py b/talent/google/cloud/talent_v4beta1/gapic/profile_service_client.py
new file mode 100644
index 000000000000..6df1f438f138
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/profile_service_client.py
@@ -0,0 +1,991 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 ProfileService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic import profile_service_client_config
+from google.cloud.talent_v4beta1.gapic.transports import profile_service_grpc_transport
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import common_pb2
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+from google.cloud.talent_v4beta1.proto import completion_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import event_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import filters_pb2
+from google.cloud.talent_v4beta1.proto import histogram_pb2
+from google.cloud.talent_v4beta1.proto import job_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import profile_pb2
+from google.cloud.talent_v4beta1.proto import profile_service_pb2
+from google.cloud.talent_v4beta1.proto import profile_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class ProfileServiceClient(object):
+    """
+    A service that handles profile management, including profile CRUD,
+    enumeration and search.
+    """
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.ProfileService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ProfileServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def profile_path(cls, project, tenant, profile):
+        """Return a fully-qualified profile string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}/profiles/{profile}",
+            project=project,
+            tenant=tenant,
+            profile=profile,
+        )
+
+    @classmethod
+    def tenant_path(cls, project, tenant):
+        """Return a fully-qualified tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}", project=project, tenant=tenant
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ProfileServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ProfileServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = profile_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=profile_service_grpc_transport.ProfileServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = profile_service_grpc_transport.ProfileServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_profiles(
+        self,
+        parent,
+        page_size=None,
+        read_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists profiles by filter. The order is unspecified.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ProfileServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_profiles(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_profiles(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            read_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional. A field mask to specify the profile fields to be listed in
+                response. All fields are listed if it is unset.
+
+                Valid values are:
+
+                -  name
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.Profile` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_profiles" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_profiles"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_profiles,
+                default_retry=self._method_configs["ListProfiles"].retry,
+                default_timeout=self._method_configs["ListProfiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = profile_service_pb2.ListProfilesRequest(
+            parent=parent, page_size=page_size, read_mask=read_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_profiles"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="profiles",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def create_profile(
+        self,
+        parent,
+        profile,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new profile.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ProfileServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `profile`:
+            >>> profile = {}
+            >>>
+            >>> response = client.create_profile(parent, profile)
+
+        Args:
+            parent (str): 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".
+            profile (Union[dict, ~google.cloud.talent_v4beta1.types.Profile]): Required. The profile to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Profile`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Profile` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_profile,
+                default_retry=self._method_configs["CreateProfile"].retry,
+                default_timeout=self._method_configs["CreateProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = profile_service_pb2.CreateProfileRequest(
+            parent=parent, profile=profile
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_profile(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the specified profile.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ProfileServiceClient()
+            >>>
+            >>> name = client.profile_path('[PROJECT]', '[TENANT]', '[PROFILE]')
+            >>>
+            >>> response = client.get_profile(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Profile` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_profile,
+                default_retry=self._method_configs["GetProfile"].retry,
+                default_timeout=self._method_configs["GetProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = profile_service_pb2.GetProfileRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_profile(
+        self,
+        profile,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates the specified profile and returns the updated result.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ProfileServiceClient()
+            >>>
+            >>> # TODO: Initialize `profile`:
+            >>> profile = {}
+            >>>
+            >>> response = client.update_profile(profile)
+
+        Args:
+            profile (Union[dict, ~google.cloud.talent_v4beta1.types.Profile]): Required. Profile to be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Profile`
+            update_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional. 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
+                -  activities
+                -  publications
+                -  patents
+                -  certifications
+                -  recruiting\_notes
+                -  custom\_attributes
+                -  group\_id
+                -  external\_system
+                -  source\_note
+                -  primary\_responsibilities
+                -  citizenships
+                -  work\_authorizations
+                -  employee\_types
+                -  language\_code
+                -  qualification\_summary
+                -  allowed\_contact\_types
+                -  preferred\_contact\_types
+                -  contact\_availability
+                -  language\_fluencies
+                -  work\_preference
+                -  industry\_experiences
+                -  work\_environment\_experiences
+                -  work\_availability
+                -  security\_clearances
+                -  references
+                -  assessments
+                -  interviews
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Profile` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_profile,
+                default_retry=self._method_configs["UpdateProfile"].retry,
+                default_timeout=self._method_configs["UpdateProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = profile_service_pb2.UpdateProfileRequest(
+            profile=profile, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("profile.name", profile.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_profile(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes the specified profile.
+        Prerequisite: The profile has no associated applications or assignments
+        associated.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ProfileServiceClient()
+            >>>
+            >>> name = client.profile_path('[PROJECT]', '[TENANT]', '[PROFILE]')
+            >>>
+            >>> client.delete_profile(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_profile" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_profile"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_profile,
+                default_retry=self._method_configs["DeleteProfile"].retry,
+                default_timeout=self._method_configs["DeleteProfile"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = profile_service_pb2.DeleteProfileRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_profile"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_profiles(
+        self,
+        parent,
+        request_metadata,
+        profile_query=None,
+        page_size=None,
+        offset=None,
+        disable_spell_check=None,
+        order_by=None,
+        case_sensitive_sort=None,
+        histogram_queries=None,
+        result_set_id=None,
+        strict_keywords_search=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Searches for profiles within a tenant.
+
+        For example, search by raw queries "software engineer in Mountain View"
+        or search by structured filters (location filter, education filter,
+        etc.).
+
+        See ``SearchProfilesRequest`` for more information.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.ProfileServiceClient()
+            >>>
+            >>> parent = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> # TODO: Initialize `request_metadata`:
+            >>> request_metadata = {}
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.search_profiles(parent, request_metadata):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.search_profiles(parent, request_metadata).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): 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".
+            request_metadata (Union[dict, ~google.cloud.talent_v4beta1.types.RequestMetadata]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.RequestMetadata`
+            profile_query (Union[dict, ~google.cloud.talent_v4beta1.types.ProfileQuery]): Optional. Search query to execute. See ``ProfileQuery`` for more
+                details.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.ProfileQuery`
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            offset (int): Optional. An integer that specifies the current offset (that is,
+                starting result) in search results. This field is only considered if
+                ``page_token`` is unset.
+
+                The maximum allowed value is 5000. Otherwise an error is thrown.
+
+                For example, 0 means to search from the first profile, and 10 means to
+                search from the 11th profile. This can be used for pagination, for
+                example pageSize = 10 and offset = 10 means to search from the second
+                page.
+            disable_spell_check (bool): Optional. This flag controls the spell-check feature. If ``false``, the
+                service attempts to correct a misspelled query.
+
+                For example, "enginee" is corrected to "engineer".
+            order_by (str): Optional. 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\_date desc": Sort by ``Profile.update_time`` in descending
+                   order (recently updated profiles first).
+                -  "create\_date desc": Sort by ``Profile.create_time`` in descending
+                   order (recently created profiles first).
+                -  "first\_name": Sort by ``PersonName.PersonStructuredName.given_name``
+                   in ascending order.
+                -  "first\_name desc": Sort by
+                   ``PersonName.PersonStructuredName.given_name`` in descending order.
+                -  "last\_name": Sort by ``PersonName.PersonStructuredName.family_name``
+                   in ascending order.
+                -  "last\_name desc": Sort by
+                   ``PersonName.PersonStructuredName.family_name`` in ascending order.
+            case_sensitive_sort (bool): 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).
+            histogram_queries (list[Union[dict, ~google.cloud.talent_v4beta1.types.HistogramQuery]]): Optional. A list of expressions specifies histogram requests against
+                matching profiles for ``SearchProfilesRequest``.
+
+                The expression syntax looks like a function definition with optional
+                parameters.
+
+                Function syntax: function\_name(histogram\_facet[, list of buckets])
+
+                Data types:
+
+                -  Histogram facet: facet names with format [a-zA-Z][a-zA-Z0-9\_]+.
+                -  String: string like "any string with backslash escape for quote(")."
+                -  Number: whole number and floating point number like 10, -1 and -0.01.
+                -  List: list of elements with comma(,) separator surrounded by square
+                   brackets. For example, [1, 2, 3] and ["one", "two", "three"].
+
+                Built-in constants:
+
+                -  MIN (minimum number similar to java Double.MIN\_VALUE)
+                -  MAX (maximum number similar to java Double.MAX\_VALUE)
+
+                Built-in functions:
+
+                -  bucket(start, end[, label]) Bucket build-in function creates a bucket
+                   with range of \`start, end). Note that the end is exclusive. For
+                   example, bucket(1, MAX, "positive number") or bucket(1, 10).
+
+                Histogram Facets:
+
+                -  admin1: Admin1 is a global placeholder for referring to state,
+                   province, or the particular term a country uses to define the
+                   geographic structure below the country level. Examples include states
+                   codes such as "CA", "IL", "NY", and provinces, such as "BC".
+                -  locality: Locality is a global placeholder for referring to city,
+                   town, or the particular term a country uses to define the geographic
+                   structure below the admin1 level. Examples include city names such as
+                   "Mountain View" and "New York".
+                -  extended\_locality: Extended locality is concatenated version of
+                   admin1 and locality with comma separator. For example, "Mountain
+                   View, CA" and "New York, NY".
+                -  postal\_code: Postal code of profile which follows locale code.
+                -  country: Country code (ISO-3166-1 alpha-2 code) of profile, such as
+                   US, JP, GB.
+                -  job\_title: Normalized job titles specified in EmploymentHistory.
+                -  company\_name: Normalized company name of profiles to match on.
+                -  institution: The school name. For example, "MIT", "University of
+                   California, Berkeley"
+                -  degree: Highest 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.
+                -  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\` for more details.
+                -  application\_outcome\_notes: The application outcome reason specifies
+                   the reasons behind the outcome of the job application. See
+                   ``ApplicationOutcomeNotesFilter`` for more details.
+                -  application\_job\_title: The application job title specifies the job
+                   applied for in the application. See ``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"].
+                -  numeric\_custom\_attribute: Numeric custom attributes. Values can be
+                   accessed via square bracket notation like
+                   numeric\_custom\_attribute["key1"].
+
+                Example expressions:
+
+                -  count(admin1)
+                -  count(experience\_in\_months, [bucket(0, 12, "1 year"), bucket(12,
+                   36, "1-3 years"), bucket(36, MAX, "3+ years")])
+                -  count(string\_custom\_attribute["assigned\_recruiter"])
+                -  count(numeric\_custom\_attribute["favorite\_number"], [bucket(MIN, 0,
+                   "negative"), bucket(0, MAX, "non-negative")])
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.HistogramQuery`
+            result_set_id (str): Optional. An id that uniquely identifies the result set of a
+                ``SearchProfiles`` call. The id should be retrieved from the
+                ``SearchProfilesResponse`` message returned from a previous invocation
+                of ``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``. A new ``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`` 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`` without this
+                field, then use the resulting ``result_set_id`` in
+                ``SearchProfilesResponse`` to page through the results.
+            strict_keywords_search (bool): Optional. 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.SummarizedProfile` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_profiles" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_profiles"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_profiles,
+                default_retry=self._method_configs["SearchProfiles"].retry,
+                default_timeout=self._method_configs["SearchProfiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = profile_service_pb2.SearchProfilesRequest(
+            parent=parent,
+            request_metadata=request_metadata,
+            profile_query=profile_query,
+            page_size=page_size,
+            offset=offset,
+            disable_spell_check=disable_spell_check,
+            order_by=order_by,
+            case_sensitive_sort=case_sensitive_sort,
+            histogram_queries=histogram_queries,
+            result_set_id=result_set_id,
+            strict_keywords_search=strict_keywords_search,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["search_profiles"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="summarized_profiles",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/talent/google/cloud/talent_v4beta1/gapic/profile_service_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/profile_service_client_config.py
new file mode 100644
index 000000000000..e2f8216b82b5
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/profile_service_client_config.py
@@ -0,0 +1,53 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.ProfileService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListProfiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProfile": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchProfiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/tenant_service_client.py b/talent/google/cloud/talent_v4beta1/gapic/tenant_service_client.py
new file mode 100644
index 000000000000..2ff8a7f962a4
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/tenant_service_client.py
@@ -0,0 +1,639 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.talent.v4beta1 TenantService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.talent_v4beta1.gapic import enums
+from google.cloud.talent_v4beta1.gapic import tenant_service_client_config
+from google.cloud.talent_v4beta1.gapic.transports import tenant_service_grpc_transport
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import common_pb2
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+from google.cloud.talent_v4beta1.proto import completion_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import event_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import filters_pb2
+from google.cloud.talent_v4beta1.proto import histogram_pb2
+from google.cloud.talent_v4beta1.proto import job_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import profile_pb2
+from google.cloud.talent_v4beta1.proto import profile_service_pb2
+from google.cloud.talent_v4beta1.proto import profile_service_pb2_grpc
+from google.cloud.talent_v4beta1.proto import tenant_pb2
+from google.cloud.talent_v4beta1.proto import tenant_service_pb2
+from google.cloud.talent_v4beta1.proto import tenant_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-talent").version
+
+
+class TenantServiceClient(object):
+    """A service that handles tenant management, including CRUD and enumeration."""
+
+    SERVICE_ADDRESS = "jobs.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.talent.v4beta1.TenantService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            TenantServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def tenant_path(cls, project, tenant):
+        """Return a fully-qualified tenant string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/tenants/{tenant}", project=project, tenant=tenant
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.TenantServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.TenantServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = tenant_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=tenant_service_grpc_transport.TenantServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = tenant_service_grpc_transport.TenantServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_tenant(
+        self,
+        parent,
+        tenant,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new tenant entity.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.TenantServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `tenant`:
+            >>> tenant = {}
+            >>>
+            >>> response = client.create_tenant(parent, tenant)
+
+        Args:
+            parent (str): Required. Resource name of the project under which the tenant is
+                created.
+
+                The format is "projects/{project\_id}", for example,
+                "projects/api-test-project".
+            tenant (Union[dict, ~google.cloud.talent_v4beta1.types.Tenant]): Required. The tenant to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Tenant`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Tenant` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_tenant" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_tenant"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_tenant,
+                default_retry=self._method_configs["CreateTenant"].retry,
+                default_timeout=self._method_configs["CreateTenant"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = tenant_service_pb2.CreateTenantRequest(parent=parent, tenant=tenant)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_tenant"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_tenant(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Retrieves specified tenant.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.TenantServiceClient()
+            >>>
+            >>> name = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> response = client.get_tenant(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Tenant` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_tenant" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_tenant"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_tenant,
+                default_retry=self._method_configs["GetTenant"].retry,
+                default_timeout=self._method_configs["GetTenant"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = tenant_service_pb2.GetTenantRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_tenant"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_tenant(
+        self,
+        tenant,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates specified tenant.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.TenantServiceClient()
+            >>>
+            >>> # TODO: Initialize `tenant`:
+            >>> tenant = {}
+            >>>
+            >>> response = client.update_tenant(tenant)
+
+        Args:
+            tenant (Union[dict, ~google.cloud.talent_v4beta1.types.Tenant]): Required. The tenant resource to replace the current resource in the
+                system.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.Tenant`
+            update_mask (Union[dict, ~google.cloud.talent_v4beta1.types.FieldMask]): Optional but strongly recommended for the best service experience.
+
+                If ``update_mask`` is provided, only the specified fields in ``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`` are supported.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.talent_v4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.talent_v4beta1.types.Tenant` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_tenant" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_tenant"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_tenant,
+                default_retry=self._method_configs["UpdateTenant"].retry,
+                default_timeout=self._method_configs["UpdateTenant"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = tenant_service_pb2.UpdateTenantRequest(
+            tenant=tenant, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("tenant.name", tenant.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_tenant"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_tenant(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes specified tenant.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.TenantServiceClient()
+            >>>
+            >>> name = client.tenant_path('[PROJECT]', '[TENANT]')
+            >>>
+            >>> client.delete_tenant(name)
+
+        Args:
+            name (str): 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".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_tenant" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_tenant"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_tenant,
+                default_retry=self._method_configs["DeleteTenant"].retry,
+                default_timeout=self._method_configs["DeleteTenant"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = tenant_service_pb2.DeleteTenantRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_tenant"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_tenants(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists all tenants associated with the project.
+
+        Example:
+            >>> from google.cloud import talent_v4beta1
+            >>>
+            >>> client = talent_v4beta1.TenantServiceClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tenants(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tenants(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. Resource name of the project under which the tenant is
+                created.
+
+                The format is "projects/{project\_id}", for example,
+                "projects/api-test-project".
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.talent_v4beta1.types.Tenant` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tenants" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tenants"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tenants,
+                default_retry=self._method_configs["ListTenants"].retry,
+                default_timeout=self._method_configs["ListTenants"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = tenant_service_pb2.ListTenantsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tenants"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tenants",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/talent/google/cloud/talent_v4beta1/gapic/tenant_service_client_config.py b/talent/google/cloud/talent_v4beta1/gapic/tenant_service_client_config.py
new file mode 100644
index 000000000000..9707dd1d5dc9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/tenant_service_client_config.py
@@ -0,0 +1,48 @@
+config = {
+    "interfaces": {
+        "google.cloud.talent.v4beta1.TenantService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateTenant": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTenant": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateTenant": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTenant": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTenants": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/__init__.py b/talent/google/cloud/talent_v4beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/application_service_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/application_service_grpc_transport.py
new file mode 100644
index 000000000000..6c1c4bd84ed6
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/application_service_grpc_transport.py
@@ -0,0 +1,178 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.talent_v4beta1.proto import application_service_pb2_grpc
+
+
+class ApplicationServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 ApplicationService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "application_service_stub": application_service_pb2_grpc.ApplicationServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_application(self):
+        """Return the gRPC stub for :meth:`ApplicationServiceClient.create_application`.
+
+        Creates a new application entity.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["application_service_stub"].CreateApplication
+
+    @property
+    def get_application(self):
+        """Return the gRPC stub for :meth:`ApplicationServiceClient.get_application`.
+
+        Retrieves specified application.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["application_service_stub"].GetApplication
+
+    @property
+    def update_application(self):
+        """Return the gRPC stub for :meth:`ApplicationServiceClient.update_application`.
+
+        Updates specified application.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["application_service_stub"].UpdateApplication
+
+    @property
+    def delete_application(self):
+        """Return the gRPC stub for :meth:`ApplicationServiceClient.delete_application`.
+
+        Deletes specified application.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["application_service_stub"].DeleteApplication
+
+    @property
+    def list_applications(self):
+        """Return the gRPC stub for :meth:`ApplicationServiceClient.list_applications`.
+
+        Lists all applications associated with the profile.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["application_service_stub"].ListApplications
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/company_service_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/company_service_grpc_transport.py
new file mode 100644
index 000000000000..64aa58db5ce7
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/company_service_grpc_transport.py
@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.talent_v4beta1.proto import company_service_pb2_grpc
+
+
+class CompanyServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 CompanyService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "company_service_stub": company_service_pb2_grpc.CompanyServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_company(self):
+        """Return the gRPC stub for :meth:`CompanyServiceClient.create_company`.
+
+        Creates a new company entity.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["company_service_stub"].CreateCompany
+
+    @property
+    def get_company(self):
+        """Return the gRPC stub for :meth:`CompanyServiceClient.get_company`.
+
+        Retrieves specified company.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["company_service_stub"].GetCompany
+
+    @property
+    def update_company(self):
+        """Return the gRPC stub for :meth:`CompanyServiceClient.update_company`.
+
+        Updates specified company.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["company_service_stub"].UpdateCompany
+
+    @property
+    def delete_company(self):
+        """Return the gRPC stub for :meth:`CompanyServiceClient.delete_company`.
+
+        Deletes specified company.
+        Prerequisite: The company has no jobs associated with it.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["company_service_stub"].DeleteCompany
+
+    @property
+    def list_companies(self):
+        """Return the gRPC stub for :meth:`CompanyServiceClient.list_companies`.
+
+        Lists all companies associated with the project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["company_service_stub"].ListCompanies
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/completion_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/completion_grpc_transport.py
new file mode 100644
index 000000000000..4c75be69d9e2
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/completion_grpc_transport.py
@@ -0,0 +1,125 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.talent_v4beta1.proto import completion_service_pb2_grpc
+
+
+class CompletionGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 Completion API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "completion_stub": completion_service_pb2_grpc.CompletionStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def complete_query(self):
+        """Return the gRPC stub for :meth:`CompletionClient.complete_query`.
+
+        Completes the specified prefix with keyword suggestions.
+        Intended for use by a job search auto-complete search box.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["completion_stub"].CompleteQuery
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/event_service_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/event_service_grpc_transport.py
new file mode 100644
index 000000000000..7f598e330ff1
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/event_service_grpc_transport.py
@@ -0,0 +1,130 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.talent_v4beta1.proto import event_service_pb2_grpc
+
+
+class EventServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 EventService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "event_service_stub": event_service_pb2_grpc.EventServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_client_event(self):
+        """Return the gRPC stub for :meth:`EventServiceClient.create_client_event`.
+
+        Report events issued when end user interacts with customer's application
+        that uses Cloud Talent Solution. You may inspect the created events in
+        `self service
+        tools <https://console.cloud.google.com/talent-solution/overview>`__.
+        `Learn
+        more <https://cloud.google.com/talent-solution/docs/management-tools>`__
+        about self service tools.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["event_service_stub"].CreateClientEvent
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/job_service_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/job_service_grpc_transport.py
new file mode 100644
index 000000000000..1e347cd1d02b
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/job_service_grpc_transport.py
@@ -0,0 +1,268 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.talent_v4beta1.proto import job_service_pb2_grpc
+
+
+class JobServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 JobService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"job_service_stub": job_service_pb2_grpc.JobServiceStub(channel)}
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_job(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.create_job`.
+
+        Creates a new job.
+
+        Typically, the job becomes searchable within 10 seconds, but it may take
+        up to 5 minutes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].CreateJob
+
+    @property
+    def get_job(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.get_job`.
+
+        Retrieves the specified job, whose status is OPEN or recently EXPIRED
+        within the last 90 days.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].GetJob
+
+    @property
+    def update_job(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.update_job`.
+
+        Updates specified job.
+
+        Typically, updated contents become visible in search results within 10
+        seconds, but it may take up to 5 minutes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].UpdateJob
+
+    @property
+    def delete_job(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.delete_job`.
+
+        Deletes the specified job.
+
+        Typically, the job becomes unsearchable within 10 seconds, but it may take
+        up to 5 minutes.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].DeleteJob
+
+    @property
+    def list_jobs(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.list_jobs`.
+
+        Lists jobs by filter.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].ListJobs
+
+    @property
+    def batch_delete_jobs(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.batch_delete_jobs`.
+
+        Deletes a list of ``Job``\ s by filter.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].BatchDeleteJobs
+
+    @property
+    def search_jobs(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.search_jobs`.
+
+        Searches for jobs using the provided ``SearchJobsRequest``.
+
+        This call constrains the ``visibility`` of jobs present in the database,
+        and only returns jobs that the caller has permission to search against.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].SearchJobs
+
+    @property
+    def search_jobs_for_alert(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.search_jobs_for_alert`.
+
+        Searches for jobs using the provided ``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`` of jobs present in the database,
+        and only returns jobs the caller has permission to search against.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].SearchJobsForAlert
+
+    @property
+    def batch_create_jobs(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.batch_create_jobs`.
+
+        Begins executing a batch create jobs operation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].BatchCreateJobs
+
+    @property
+    def batch_update_jobs(self):
+        """Return the gRPC stub for :meth:`JobServiceClient.batch_update_jobs`.
+
+        Begins executing a batch update jobs operation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["job_service_stub"].BatchUpdateJobs
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/profile_service_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/profile_service_grpc_transport.py
new file mode 100644
index 000000000000..fc1d048ee9ee
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/profile_service_grpc_transport.py
@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.talent_v4beta1.proto import profile_service_pb2_grpc
+
+
+class ProfileServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 ProfileService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "profile_service_stub": profile_service_pb2_grpc.ProfileServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_profiles(self):
+        """Return the gRPC stub for :meth:`ProfileServiceClient.list_profiles`.
+
+        Lists profiles by filter. The order is unspecified.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["profile_service_stub"].ListProfiles
+
+    @property
+    def create_profile(self):
+        """Return the gRPC stub for :meth:`ProfileServiceClient.create_profile`.
+
+        Creates and returns a new profile.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["profile_service_stub"].CreateProfile
+
+    @property
+    def get_profile(self):
+        """Return the gRPC stub for :meth:`ProfileServiceClient.get_profile`.
+
+        Gets the specified profile.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["profile_service_stub"].GetProfile
+
+    @property
+    def update_profile(self):
+        """Return the gRPC stub for :meth:`ProfileServiceClient.update_profile`.
+
+        Updates the specified profile and returns the updated result.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["profile_service_stub"].UpdateProfile
+
+    @property
+    def delete_profile(self):
+        """Return the gRPC stub for :meth:`ProfileServiceClient.delete_profile`.
+
+        Deletes the specified profile.
+        Prerequisite: The profile has no associated applications or assignments
+        associated.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["profile_service_stub"].DeleteProfile
+
+    @property
+    def search_profiles(self):
+        """Return the gRPC stub for :meth:`ProfileServiceClient.search_profiles`.
+
+        Searches for profiles within a tenant.
+
+        For example, search by raw queries "software engineer in Mountain View"
+        or search by structured filters (location filter, education filter,
+        etc.).
+
+        See ``SearchProfilesRequest`` for more information.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["profile_service_stub"].SearchProfiles
diff --git a/talent/google/cloud/talent_v4beta1/gapic/transports/tenant_service_grpc_transport.py b/talent/google/cloud/talent_v4beta1/gapic/transports/tenant_service_grpc_transport.py
new file mode 100644
index 000000000000..aca79afc9b59
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/gapic/transports/tenant_service_grpc_transport.py
@@ -0,0 +1,176 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.talent_v4beta1.proto import tenant_service_pb2_grpc
+
+
+class TenantServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.talent.v4beta1 TenantService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/jobs",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="jobs.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "tenant_service_stub": tenant_service_pb2_grpc.TenantServiceStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="jobs.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_tenant(self):
+        """Return the gRPC stub for :meth:`TenantServiceClient.create_tenant`.
+
+        Creates a new tenant entity.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["tenant_service_stub"].CreateTenant
+
+    @property
+    def get_tenant(self):
+        """Return the gRPC stub for :meth:`TenantServiceClient.get_tenant`.
+
+        Retrieves specified tenant.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["tenant_service_stub"].GetTenant
+
+    @property
+    def update_tenant(self):
+        """Return the gRPC stub for :meth:`TenantServiceClient.update_tenant`.
+
+        Updates specified tenant.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["tenant_service_stub"].UpdateTenant
+
+    @property
+    def delete_tenant(self):
+        """Return the gRPC stub for :meth:`TenantServiceClient.delete_tenant`.
+
+        Deletes specified tenant.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["tenant_service_stub"].DeleteTenant
+
+    @property
+    def list_tenants(self):
+        """Return the gRPC stub for :meth:`TenantServiceClient.list_tenants`.
+
+        Lists all tenants associated with the project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["tenant_service_stub"].ListTenants
diff --git a/talent/google/cloud/talent_v4beta1/proto/__init__.py b/talent/google/cloud/talent_v4beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/talent/google/cloud/talent_v4beta1/proto/application.proto b/talent/google/cloud/talent_v4beta1/proto/application.proto
new file mode 100644
index 000000000000..30ce2fed8d1e
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/application.proto
@@ -0,0 +1,176 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+import "google/type/date.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "ApplicationResourceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// Resource that represents a job application record of a candidate.
+message Application {
+  // Enum that represents the application status.
+  enum ApplicationState {
+    // Default value.
+    APPLICATION_STATE_UNSPECIFIED = 0;
+
+    // The current stage is in progress or pending, for example, interviews in
+    // progress.
+    IN_PROGRESS = 1;
+
+    // The current stage was terminated by a candidate decision.
+    CANDIDATE_WITHDREW = 2;
+
+    // The current stage was terminated by an employer or agency decision.
+    EMPLOYER_WITHDREW = 3;
+
+    // The current stage is successfully completed, but the next stage (if
+    // applicable) has not begun.
+    COMPLETED = 4;
+
+    // The current stage was closed without an exception, or terminated for
+    // reasons unrealated to the candidate.
+    CLOSED = 5;
+  }
+
+  // The stage of the application.
+  enum ApplicationStage {
+    // Default value.
+    APPLICATION_STAGE_UNSPECIFIED = 0;
+
+    // Candidate has applied or a recruiter put candidate into consideration but
+    // candidate is not yet screened / no decision has been made to move or not
+    // move the candidate to the next stage.
+    NEW = 1;
+
+    // A recruiter decided to screen the candidate for this role.
+    SCREEN = 2;
+
+    // Candidate is being / was sent to the customer / hiring manager for
+    // detailed review.
+    HIRING_MANAGER_REVIEW = 3;
+
+    // Candidate was approved by the client / hiring manager and is being / was
+    // interviewed for the role.
+    INTERVIEW = 4;
+
+    // Candidate will be / has been given an offer of employment.
+    OFFER_EXTENDED = 5;
+
+    // Candidate has accepted their offer of employment.
+    OFFER_ACCEPTED = 6;
+
+    // Candidate has begun (or completed) their employment or assignment with
+    // the employer.
+    STARTED = 7;
+  }
+
+  // Required during application update.
+  //
+  // 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".
+  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;
+
+  // 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;
+
+  // One of either a job or a company is 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;
+
+  // 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;
+
+  // Optional. 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;
+
+  // Optional. 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,
+  // timestamp, feedback, and so on).
+  repeated Interview interviews = 16;
+
+  // Optional. 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;
+
+  // Optional. 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).
+  //
+  // Number of characters allowed is 100.
+  string outcome_notes = 21;
+
+  // Optional. 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;
+
+  // 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;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/application_pb2.py b/talent/google/cloud/talent_v4beta1/proto/application_pb2.py
new file mode 100644
index 000000000000..f41b59fe646b
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/application_pb2.py
@@ -0,0 +1,556 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/application.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.type import date_pb2 as google_dot_type_dot_date__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/application.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\030ApplicationResourceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/talent_v4beta1/proto/application.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x16google/type/date.proto"\xc2\x07\n\x0b\x41pplication\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x1f \x01(\t\x12\x0f\n\x07profile\x18\x02 \x01(\t\x12\x0b\n\x03job\x18\x04 \x01(\t\x12\x0f\n\x07\x63ompany\x18\x05 \x01(\t\x12+\n\x10\x61pplication_date\x18\x07 \x01(\x0b\x32\x11.google.type.Date\x12H\n\x05stage\x18\x0b \x01(\x0e\x32\x39.google.cloud.talent.v4beta1.Application.ApplicationStage\x12H\n\x05state\x18\r \x01(\x0e\x32\x39.google.cloud.talent.v4beta1.Application.ApplicationState\x12:\n\ninterviews\x18\x10 \x03(\x0b\x32&.google.cloud.talent.v4beta1.Interview\x12,\n\x08referral\x18\x12 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12/\n\x0b\x63reate_time\x18\x13 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x14 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x15\n\routcome_notes\x18\x15 \x01(\t\x12\x35\n\x07outcome\x18\x16 \x01(\x0e\x32$.google.cloud.talent.v4beta1.Outcome\x12,\n\x08is_match\x18\x1c \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x19\n\x11job_title_snippet\x18\x1d \x01(\t"\x90\x01\n\x10\x41pplicationState\x12!\n\x1d\x41PPLICATION_STATE_UNSPECIFIED\x10\x00\x12\x0f\n\x0bIN_PROGRESS\x10\x01\x12\x16\n\x12\x43\x41NDIDATE_WITHDREW\x10\x02\x12\x15\n\x11\x45MPLOYER_WITHDREW\x10\x03\x12\r\n\tCOMPLETED\x10\x04\x12\n\n\x06\x43LOSED\x10\x05"\xa9\x01\n\x10\x41pplicationStage\x12!\n\x1d\x41PPLICATION_STAGE_UNSPECIFIED\x10\x00\x12\x07\n\x03NEW\x10\x01\x12\n\n\x06SCREEN\x10\x02\x12\x19\n\x15HIRING_MANAGER_REVIEW\x10\x03\x12\r\n\tINTERVIEW\x10\x04\x12\x12\n\x0eOFFER_EXTENDED\x10\x05\x12\x12\n\x0eOFFER_ACCEPTED\x10\x06\x12\x0b\n\x07STARTED\x10\x07\x42\x86\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x18\x41pplicationResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_type_dot_date__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_APPLICATION_APPLICATIONSTATE = _descriptor.EnumDescriptor(
+    name="ApplicationState",
+    full_name="google.cloud.talent.v4beta1.Application.ApplicationState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IN_PROGRESS", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANDIDATE_WITHDREW",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EMPLOYER_WITHDREW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CLOSED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=898,
+    serialized_end=1042,
+)
+_sym_db.RegisterEnumDescriptor(_APPLICATION_APPLICATIONSTATE)
+
+_APPLICATION_APPLICATIONSTAGE = _descriptor.EnumDescriptor(
+    name="ApplicationStage",
+    full_name="google.cloud.talent.v4beta1.Application.ApplicationStage",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_STAGE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEW", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCREEN", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HIRING_MANAGER_REVIEW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERVIEW", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OFFER_EXTENDED", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OFFER_ACCEPTED", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STARTED", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1045,
+    serialized_end=1214,
+)
+_sym_db.RegisterEnumDescriptor(_APPLICATION_APPLICATIONSTAGE)
+
+
+_APPLICATION = _descriptor.Descriptor(
+    name="Application",
+    full_name="google.cloud.talent.v4beta1.Application",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.Application.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="external_id",
+            full_name="google.cloud.talent.v4beta1.Application.external_id",
+            index=1,
+            number=31,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profile",
+            full_name="google.cloud.talent.v4beta1.Application.profile",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.talent.v4beta1.Application.job",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="company",
+            full_name="google.cloud.talent.v4beta1.Application.company",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="application_date",
+            full_name="google.cloud.talent.v4beta1.Application.application_date",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stage",
+            full_name="google.cloud.talent.v4beta1.Application.stage",
+            index=6,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.talent.v4beta1.Application.state",
+            index=7,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interviews",
+            full_name="google.cloud.talent.v4beta1.Application.interviews",
+            index=8,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="referral",
+            full_name="google.cloud.talent.v4beta1.Application.referral",
+            index=9,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.talent.v4beta1.Application.create_time",
+            index=10,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.talent.v4beta1.Application.update_time",
+            index=11,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="outcome_notes",
+            full_name="google.cloud.talent.v4beta1.Application.outcome_notes",
+            index=12,
+            number=21,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="outcome",
+            full_name="google.cloud.talent.v4beta1.Application.outcome",
+            index=13,
+            number=22,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_match",
+            full_name="google.cloud.talent.v4beta1.Application.is_match",
+            index=14,
+            number=28,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_title_snippet",
+            full_name="google.cloud.talent.v4beta1.Application.job_title_snippet",
+            index=15,
+            number=29,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_APPLICATION_APPLICATIONSTATE, _APPLICATION_APPLICATIONSTAGE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=252,
+    serialized_end=1214,
+)
+
+_APPLICATION.fields_by_name[
+    "application_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_APPLICATION.fields_by_name["stage"].enum_type = _APPLICATION_APPLICATIONSTAGE
+_APPLICATION.fields_by_name["state"].enum_type = _APPLICATION_APPLICATIONSTATE
+_APPLICATION.fields_by_name[
+    "interviews"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._INTERVIEW
+)
+_APPLICATION.fields_by_name[
+    "referral"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_APPLICATION.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_APPLICATION.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_APPLICATION.fields_by_name[
+    "outcome"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._OUTCOME
+_APPLICATION.fields_by_name[
+    "is_match"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_APPLICATION_APPLICATIONSTATE.containing_type = _APPLICATION
+_APPLICATION_APPLICATIONSTAGE.containing_type = _APPLICATION
+DESCRIPTOR.message_types_by_name["Application"] = _APPLICATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Application = _reflection.GeneratedProtocolMessageType(
+    "Application",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPLICATION,
+        __module__="google.cloud.talent_v4beta1.proto.application_pb2",
+        __doc__="""Resource that represents a job application record of a candidate.
+  
+  
+  Attributes:
+      name:
+          Required during application update.  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".
+      external_id:
+          Required. Client side application identifier, used to uniquely
+          identify the application.  The maximum number of allowed
+          characters is 255.
+      profile:
+          Output only. Resource name of the candidate of this
+          application.  The format is "projects/{project\_id}/tenants/{t
+          enant\_id}/profiles/{profile\_id}", for example,
+          "projects/api-test-project/tenants/foo/profiles/bar".
+      job:
+          One of either a job or a company is 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".
+      company:
+          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/{compan
+          y\_id}", for example, "projects/api-test-
+          project/tenants/foo/companies/bar".
+      application_date:
+          Optional. The application date.
+      stage:
+          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.
+      state:
+          Optional. The application state.
+      interviews:
+          Optional. 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).
+      referral:
+          Optional. If the candidate is referred by a employee.
+      create_time:
+          Required. Reflects the time that the application was created.
+      update_time:
+          Optional. The last update timestamp.
+      outcome_notes:
+          Optional. 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.
+      outcome:
+          Optional. Outcome positiveness shows how positive the outcome
+          is.
+      is_match:
+          Output only. Indicates whether this job application is a match
+          to application related filters. This value is only applicable
+          in profile search response.
+      job_title_snippet:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Application)
+    ),
+)
+_sym_db.RegisterMessage(Application)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/application_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/application_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/application_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/application_service.proto b/talent/google/cloud/talent_v4beta1/proto/application_service.proto
new file mode 100644
index 000000000000..48e4f9500d22
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/application_service.proto
@@ -0,0 +1,169 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/talent/v4beta1/application.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "ApplicationServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service that handles application management, including CRUD and
+// enumeration.
+service ApplicationService {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Creates a new application entity.
+  rpc CreateApplication(CreateApplicationRequest) returns (Application) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications"
+      body: "*"
+    };
+  }
+
+  // Retrieves specified application.
+  rpc GetApplication(GetApplicationRequest) returns (Application) {
+    option (google.api.http) = {
+      get: "/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}"
+    };
+  }
+
+  // Updates specified application.
+  rpc UpdateApplication(UpdateApplicationRequest) returns (Application) {
+    option (google.api.http) = {
+      patch: "/v4beta1/{application.name=projects/*/tenants/*/profiles/*/applications/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes specified application.
+  rpc DeleteApplication(DeleteApplicationRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}"
+    };
+  }
+
+  // Lists all applications associated with the profile.
+  rpc ListApplications(ListApplicationsRequest)
+      returns (ListApplicationsResponse) {
+    option (google.api.http) = {
+      get: "/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications"
+    };
+  }
+}
+
+// The Request of the CreateApplication method.
+message CreateApplicationRequest {
+  // 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;
+
+  // Required. The application to be created.
+  Application application = 2;
+}
+
+// Request for getting a application by name.
+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;
+}
+
+// Request for updating a specified application.
+message UpdateApplicationRequest {
+  // Required. The application resource to replace the current resource in the
+  // system.
+  Application application = 1;
+
+  // Optional but 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.
+  //
+  // A field mask to specify the application fields to be updated. Only
+  // top level fields of [Application][google.cloud.talent.v4beta1.Application]
+  // are supported.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request to delete a application.
+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;
+}
+
+// List applications for which the client has ACL visibility.
+message ListApplicationsRequest {
+  // 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.
+  string page_token = 2;
+
+  // Optional. 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.
+  repeated Application applications = 1;
+
+  // A token to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 3;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/application_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/application_service_pb2.py
new file mode 100644
index 000000000000..f1e3e31fbbc6
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/application_service_pb2.py
@@ -0,0 +1,648 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/application_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    application_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/application_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\027ApplicationServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n;google/cloud/talent_v4beta1/proto/application_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x33google/cloud/talent_v4beta1/proto/application.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"i\n\x18\x43reateApplicationRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12=\n\x0b\x61pplication\x18\x02 \x01(\x0b\x32(.google.cloud.talent.v4beta1.Application"%\n\x15GetApplicationRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8a\x01\n\x18UpdateApplicationRequest\x12=\n\x0b\x61pplication\x18\x01 \x01(\x0b\x32(.google.cloud.talent.v4beta1.Application\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"(\n\x18\x44\x65leteApplicationRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"P\n\x17ListApplicationsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"\xb4\x01\n\x18ListApplicationsResponse\x12>\n\x0c\x61pplications\x18\x01 \x03(\x0b\x32(.google.cloud.talent.v4beta1.Application\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12?\n\x08metadata\x18\x03 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata2\xc2\x08\n\x12\x41pplicationService\x12\xbf\x01\n\x11\x43reateApplication\x12\x35.google.cloud.talent.v4beta1.CreateApplicationRequest\x1a(.google.cloud.talent.v4beta1.Application"I\x82\xd3\xe4\x93\x02\x43">/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications:\x01*\x12\xb6\x01\n\x0eGetApplication\x12\x32.google.cloud.talent.v4beta1.GetApplicationRequest\x1a(.google.cloud.talent.v4beta1.Application"F\x82\xd3\xe4\x93\x02@\x12>/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}\x12\xcb\x01\n\x11UpdateApplication\x12\x35.google.cloud.talent.v4beta1.UpdateApplicationRequest\x1a(.google.cloud.talent.v4beta1.Application"U\x82\xd3\xe4\x93\x02O2J/v4beta1/{application.name=projects/*/tenants/*/profiles/*/applications/*}:\x01*\x12\xaa\x01\n\x11\x44\x65leteApplication\x12\x35.google.cloud.talent.v4beta1.DeleteApplicationRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02@*>/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}\x12\xc7\x01\n\x10ListApplications\x12\x34.google.cloud.talent.v4beta1.ListApplicationsRequest\x1a\x35.google.cloud.talent.v4beta1.ListApplicationsResponse"F\x82\xd3\xe4\x93\x02@\x12>/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB\x85\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x17\x41pplicationServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATEAPPLICATIONREQUEST = _descriptor.Descriptor(
+    name="CreateApplicationRequest",
+    full_name="google.cloud.talent.v4beta1.CreateApplicationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CreateApplicationRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="application",
+            full_name="google.cloud.talent.v4beta1.CreateApplicationRequest.application",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=311,
+    serialized_end=416,
+)
+
+
+_GETAPPLICATIONREQUEST = _descriptor.Descriptor(
+    name="GetApplicationRequest",
+    full_name="google.cloud.talent.v4beta1.GetApplicationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.GetApplicationRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=418,
+    serialized_end=455,
+)
+
+
+_UPDATEAPPLICATIONREQUEST = _descriptor.Descriptor(
+    name="UpdateApplicationRequest",
+    full_name="google.cloud.talent.v4beta1.UpdateApplicationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="application",
+            full_name="google.cloud.talent.v4beta1.UpdateApplicationRequest.application",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.talent.v4beta1.UpdateApplicationRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=458,
+    serialized_end=596,
+)
+
+
+_DELETEAPPLICATIONREQUEST = _descriptor.Descriptor(
+    name="DeleteApplicationRequest",
+    full_name="google.cloud.talent.v4beta1.DeleteApplicationRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.DeleteApplicationRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=598,
+    serialized_end=638,
+)
+
+
+_LISTAPPLICATIONSREQUEST = _descriptor.Descriptor(
+    name="ListApplicationsRequest",
+    full_name="google.cloud.talent.v4beta1.ListApplicationsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.ListApplicationsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.ListApplicationsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.ListApplicationsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=640,
+    serialized_end=720,
+)
+
+
+_LISTAPPLICATIONSRESPONSE = _descriptor.Descriptor(
+    name="ListApplicationsResponse",
+    full_name="google.cloud.talent.v4beta1.ListApplicationsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="applications",
+            full_name="google.cloud.talent.v4beta1.ListApplicationsResponse.applications",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.ListApplicationsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.ListApplicationsResponse.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=723,
+    serialized_end=903,
+)
+
+_CREATEAPPLICATIONREQUEST.fields_by_name[
+    "application"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2._APPLICATION
+)
+_UPDATEAPPLICATIONREQUEST.fields_by_name[
+    "application"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2._APPLICATION
+)
+_UPDATEAPPLICATIONREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTAPPLICATIONSRESPONSE.fields_by_name[
+    "applications"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2._APPLICATION
+)
+_LISTAPPLICATIONSRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+DESCRIPTOR.message_types_by_name["CreateApplicationRequest"] = _CREATEAPPLICATIONREQUEST
+DESCRIPTOR.message_types_by_name["GetApplicationRequest"] = _GETAPPLICATIONREQUEST
+DESCRIPTOR.message_types_by_name["UpdateApplicationRequest"] = _UPDATEAPPLICATIONREQUEST
+DESCRIPTOR.message_types_by_name["DeleteApplicationRequest"] = _DELETEAPPLICATIONREQUEST
+DESCRIPTOR.message_types_by_name["ListApplicationsRequest"] = _LISTAPPLICATIONSREQUEST
+DESCRIPTOR.message_types_by_name["ListApplicationsResponse"] = _LISTAPPLICATIONSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateApplicationRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateApplicationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEAPPLICATIONREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.application_service_pb2",
+        __doc__="""The Request of the CreateApplication method.
+  
+  
+  Attributes:
+      parent:
+          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".
+      application:
+          Required. The application to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CreateApplicationRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateApplicationRequest)
+
+GetApplicationRequest = _reflection.GeneratedProtocolMessageType(
+    "GetApplicationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETAPPLICATIONREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.application_service_pb2",
+        __doc__="""Request for getting a application by name.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the application to be
+          retrieved.  The format is "projects/{project\_id}/tenants/{ten
+          ant\_id}/profiles/{profile\_id}/applications/{application\_id}
+          ", for example, "projects/test-project/tenants/test-
+          tenant/profiles/test-profile/applications/test-application".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.GetApplicationRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetApplicationRequest)
+
+UpdateApplicationRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateApplicationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEAPPLICATIONREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.application_service_pb2",
+        __doc__="""Request for updating a specified application.
+  
+  
+  Attributes:
+      application:
+          Required. The application resource to replace the current
+          resource in the system.
+      update_mask:
+          Optional but strongly recommended for the best service
+          experience.  If [update\_mask][google.cloud.talent.v4beta1.Upd
+          ateApplicationRequest.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.UpdateApplicationRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateApplicationRequest)
+
+DeleteApplicationRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteApplicationRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEAPPLICATIONREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.application_service_pb2",
+        __doc__="""Request to delete a application.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the application to be deleted.
+          The format is "projects/{project\_id}/tenants/{tenant\_id}/pro
+          files/{profile\_id}/applications/{application\_id}", for
+          example, "projects/test-project/tenants/test-
+          tenant/profiles/test-profile/applications/test-application".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.DeleteApplicationRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteApplicationRequest)
+
+ListApplicationsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListApplicationsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTAPPLICATIONSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.application_service_pb2",
+        __doc__="""List applications for which the client has ACL visibility.
+  
+  
+  Attributes:
+      parent:
+          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".
+      page_token:
+          Optional. The starting indicator from which to return results.
+      page_size:
+          Optional. The maximum number of applications to be returned,
+          at most 100. Default is 100 if a non-positive number is
+          provided.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListApplicationsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListApplicationsRequest)
+
+ListApplicationsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListApplicationsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTAPPLICATIONSRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.application_service_pb2",
+        __doc__="""Output only.
+  
+  The List applications response object.
+  
+  
+  Attributes:
+      applications:
+          Applications for the current client.
+      next_page_token:
+          A token to retrieve the next page of results.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListApplicationsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListApplicationsResponse)
+
+
+DESCRIPTOR._options = None
+
+_APPLICATIONSERVICE = _descriptor.ServiceDescriptor(
+    name="ApplicationService",
+    full_name="google.cloud.talent.v4beta1.ApplicationService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=906,
+    serialized_end=1996,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateApplication",
+            full_name="google.cloud.talent.v4beta1.ApplicationService.CreateApplication",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEAPPLICATIONREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2._APPLICATION,
+            serialized_options=_b(
+                '\202\323\344\223\002C">/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetApplication",
+            full_name="google.cloud.talent.v4beta1.ApplicationService.GetApplication",
+            index=1,
+            containing_service=None,
+            input_type=_GETAPPLICATIONREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2._APPLICATION,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateApplication",
+            full_name="google.cloud.talent.v4beta1.ApplicationService.UpdateApplication",
+            index=2,
+            containing_service=None,
+            input_type=_UPDATEAPPLICATIONREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2._APPLICATION,
+            serialized_options=_b(
+                "\202\323\344\223\002O2J/v4beta1/{application.name=projects/*/tenants/*/profiles/*/applications/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteApplication",
+            full_name="google.cloud.talent.v4beta1.ApplicationService.DeleteApplication",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEAPPLICATIONREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002@*>/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListApplications",
+            full_name="google.cloud.talent.v4beta1.ApplicationService.ListApplications",
+            index=4,
+            containing_service=None,
+            input_type=_LISTAPPLICATIONSREQUEST,
+            output_type=_LISTAPPLICATIONSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_APPLICATIONSERVICE)
+
+DESCRIPTOR.services_by_name["ApplicationService"] = _APPLICATIONSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/application_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/application_service_pb2_grpc.py
new file mode 100644
index 000000000000..7243e94262b2
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/application_service_pb2_grpc.py
@@ -0,0 +1,123 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    application_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    application_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ApplicationServiceStub(object):
+    """A service that handles application management, including CRUD and
+  enumeration.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateApplication = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ApplicationService/CreateApplication",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.CreateApplicationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.Application.FromString,
+        )
+        self.GetApplication = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ApplicationService/GetApplication",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.GetApplicationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.Application.FromString,
+        )
+        self.UpdateApplication = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ApplicationService/UpdateApplication",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.UpdateApplicationRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.Application.FromString,
+        )
+        self.DeleteApplication = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ApplicationService/DeleteApplication",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.DeleteApplicationRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListApplications = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ApplicationService/ListApplications",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.ListApplicationsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.ListApplicationsResponse.FromString,
+        )
+
+
+class ApplicationServiceServicer(object):
+    """A service that handles application management, including CRUD and
+  enumeration.
+  """
+
+    def CreateApplication(self, request, context):
+        """Creates a new application entity.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetApplication(self, request, context):
+        """Retrieves specified application.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateApplication(self, request, context):
+        """Updates specified application.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteApplication(self, request, context):
+        """Deletes specified application.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListApplications(self, request, context):
+        """Lists all applications associated with the profile.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ApplicationServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateApplication": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateApplication,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.CreateApplicationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.Application.SerializeToString,
+        ),
+        "GetApplication": grpc.unary_unary_rpc_method_handler(
+            servicer.GetApplication,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.GetApplicationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.Application.SerializeToString,
+        ),
+        "UpdateApplication": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateApplication,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.UpdateApplicationRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__pb2.Application.SerializeToString,
+        ),
+        "DeleteApplication": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteApplication,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.DeleteApplicationRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListApplications": grpc.unary_unary_rpc_method_handler(
+            servicer.ListApplications,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.ListApplicationsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_application__service__pb2.ListApplicationsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.ApplicationService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/proto/batch.proto b/talent/google/cloud/talent_v4beta1/proto/batch.proto
new file mode 100644
index 000000000000..f67c980c79dc
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/batch.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.cloud.talent.v4beta1;
+
+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";
diff --git a/talent/google/cloud/talent_v4beta1/proto/batch_pb2.py b/talent/google/cloud/talent_v4beta1/proto/batch_pb2.py
new file mode 100644
index 000000000000..975c21e834bf
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/batch_pb2.py
@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/batch.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/batch.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\nBatchProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        "\n-google/cloud/talent_v4beta1/proto/batch.proto\x12\x1bgoogle.cloud.talent.v4beta1Bx\n\x1f\x63om.google.cloud.talent.v4beta1B\nBatchProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3"
+    ),
+)
+
+
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/batch_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/batch_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/batch_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/common.proto b/talent/google/cloud/talent_v4beta1/proto/common.proto
new file mode 100644
index 000000000000..bf70eb472de2
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/common.proto
@@ -0,0 +1,1074 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+import "google/type/date.proto";
+import "google/type/latlng.proto";
+import "google/type/money.proto";
+import "google/type/postal_address.proto";
+import "google/type/timeofday.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// Message representing a period of time between two timestamps.
+message TimestampRange {
+  // Begin of the period (inclusive).
+  google.protobuf.Timestamp start_time = 1;
+
+  // End of the period (exclusive).
+  google.protobuf.Timestamp end_time = 2;
+}
+
+// Output only. A resource that represents a location with full geographic
+// information.
+message Location {
+  // An enum which represents the type of a location.
+  enum LocationType {
+    // Default value if the type isn't specified.
+    LOCATION_TYPE_UNSPECIFIED = 0;
+
+    // A country level location.
+    COUNTRY = 1;
+
+    // A state or equivalent level location.
+    ADMINISTRATIVE_AREA = 2;
+
+    // A county or equivalent level location.
+    SUB_ADMINISTRATIVE_AREA = 3;
+
+    // A city or equivalent level location.
+    LOCALITY = 4;
+
+    // A postal code level location.
+    POSTAL_CODE = 5;
+
+    // A sublocality is a subdivision of a locality, for example a city borough,
+    // ward, or arrondissement. Sublocalities are usually recognized by a local
+    // political authority. For example, Manhattan and Brooklyn are recognized
+    // as boroughs by the City of New York, and are therefore modeled as
+    // sublocalities.
+    SUB_LOCALITY = 6;
+
+    // A district or equivalent level location.
+    SUB_LOCALITY_1 = 7;
+
+    // A smaller district or equivalent level display.
+    SUB_LOCALITY_2 = 8;
+
+    // A neighborhood level location.
+    NEIGHBORHOOD = 9;
+
+    // A street address level location.
+    STREET_ADDRESS = 10;
+  }
+
+  // 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].
+  LocationType location_type = 1;
+
+  // Postal address of the location that includes human readable information,
+  // such as postal delivery and payments addresses. Given a postal address,
+  // a postal service can deliver items to a premises, P.O. Box, or other
+  // delivery location.
+  google.type.PostalAddress postal_address = 2;
+
+  // An object representing a latitude/longitude pair.
+  google.type.LatLng lat_lng = 3;
+
+  // 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.
+  double radius_miles = 4;
+}
+
+// An enum that represents the size of the company.
+enum CompanySize {
+  // Default value if the size isn't specified.
+  COMPANY_SIZE_UNSPECIFIED = 0;
+
+  // The company has less than 50 employees.
+  MINI = 1;
+
+  // The company has between 50 and 99 employees.
+  SMALL = 2;
+
+  // The company has between 100 and 499 employees.
+  SMEDIUM = 3;
+
+  // The company has between 500 and 999 employees.
+  MEDIUM = 4;
+
+  // The company has between 1,000 and 4,999 employees.
+  BIG = 5;
+
+  // The company has between 5,000 and 9,999 employees.
+  BIGGER = 6;
+
+  // The company has 10,000 or more employees.
+  GIANT = 7;
+}
+
+// An enum that represents employee benefits included with the job.
+enum JobBenefit {
+  // Default value if the type isn't specified.
+  JOB_BENEFIT_UNSPECIFIED = 0;
+
+  // The job includes access to programs that support child care, such
+  // as daycare.
+  CHILD_CARE = 1;
+
+  // The job includes dental services covered by a dental
+  // insurance plan.
+  DENTAL = 2;
+
+  // The job offers specific benefits to domestic partners.
+  DOMESTIC_PARTNER = 3;
+
+  // The job allows for a flexible work schedule.
+  FLEXIBLE_HOURS = 4;
+
+  // The job includes health services covered by a medical insurance plan.
+  MEDICAL = 5;
+
+  // The job includes a life insurance plan provided by the employer or
+  // available for purchase by the employee.
+  LIFE_INSURANCE = 6;
+
+  // The job allows for a leave of absence to a parent to care for a newborn
+  // child.
+  PARENTAL_LEAVE = 7;
+
+  // The job includes a workplace retirement plan provided by the
+  // employer or available for purchase by the employee.
+  RETIREMENT_PLAN = 8;
+
+  // The job allows for paid time off due to illness.
+  SICK_DAYS = 9;
+
+  // The job includes paid time off for vacation.
+  VACATION = 10;
+
+  // The job includes vision services covered by a vision
+  // insurance plan.
+  VISION = 11;
+}
+
+// Educational degree level defined in International Standard Classification
+// of Education (ISCED).
+enum DegreeType {
+  // Default value. Represents no degree, or early childhood education.
+  // Maps to ISCED code 0.
+  // Ex) Kindergarten
+  DEGREE_TYPE_UNSPECIFIED = 0;
+
+  // Primary education which is typically the first stage of compulsory
+  // education. ISCED code 1.
+  // Ex) Elementary school
+  PRIMARY_EDUCATION = 1;
+
+  // Lower secondary education; First stage of secondary education building on
+  // primary education, typically with a more subject-oriented curriculum.
+  // ISCED code 2.
+  // Ex) Middle school
+  LOWER_SECONDARY_EDUCATION = 2;
+
+  // Middle education; Second/final stage of secondary education preparing for
+  // tertiary education and/or providing skills relevant to employment.
+  // Usually with an increased range of subject options and streams. ISCED
+  // code 3.
+  // Ex) High school
+  UPPER_SECONDARY_EDUCATION = 3;
+
+  // Adult Remedial Education; Programmes providing learning experiences that
+  // build on secondary education and prepare for labour market entry and/or
+  // tertiary education. The content is broader than secondary but not as
+  // complex as tertiary education. ISCED code 4.
+  ADULT_REMEDIAL_EDUCATION = 4;
+
+  // Associate's or equivalent; Short first tertiary programmes that are
+  // typically practically-based, occupationally-specific and prepare for
+  // labour market entry. These programmes may also provide a pathway to other
+  // tertiary programmes. ISCED code 5.
+  ASSOCIATES_OR_EQUIVALENT = 5;
+
+  // Bachelor's or equivalent; Programmes designed to provide intermediate
+  // academic and/or professional knowledge, skills and competencies leading
+  // to a first tertiary degree or equivalent qualification. ISCED code 6.
+  BACHELORS_OR_EQUIVALENT = 6;
+
+  // Master's or equivalent; Programmes designed to provide advanced academic
+  // and/or professional knowledge, skills and competencies leading to a
+  // second tertiary degree or equivalent qualification. ISCED code 7.
+  MASTERS_OR_EQUIVALENT = 7;
+
+  // Doctoral or equivalent; Programmes designed primarily to lead to an
+  // advanced research qualification, usually concluding with the submission
+  // and defense of a substantive dissertation of publishable quality based on
+  // original research. ISCED code 8.
+  DOCTORAL_OR_EQUIVALENT = 8;
+}
+
+// An enum that represents the employment type of a job.
+enum EmploymentType {
+  // The default value if the employment type isn't specified.
+  EMPLOYMENT_TYPE_UNSPECIFIED = 0;
+
+  // The job requires working a number of hours that constitute full
+  // time employment, typically 40 or more hours per week.
+  FULL_TIME = 1;
+
+  // The job entails working fewer hours than a full time job,
+  // typically less than 40 hours a week.
+  PART_TIME = 2;
+
+  // The job is offered as a contracted, as opposed to a salaried employee,
+  // position.
+  CONTRACTOR = 3;
+
+  // 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.
+  CONTRACT_TO_HIRE = 4;
+
+  // The job is offered as a temporary employment opportunity, usually
+  // a short-term engagement.
+  TEMPORARY = 5;
+
+  // The job is a fixed-term opportunity for students or entry-level job
+  // seekers to obtain on-the-job training, typically offered as a summer
+  // position.
+  INTERN = 6;
+
+  // The is an opportunity for an individual to volunteer, where there's no
+  // expectation of compensation for the provided services.
+  VOLUNTEER = 7;
+
+  // The job requires an employee to work on an as-needed basis with a
+  // flexible schedule.
+  PER_DIEM = 8;
+
+  // The job involves employing people in remote areas and flying them
+  // temporarily to the work site instead of relocating employees and their
+  // families permanently.
+  FLY_IN_FLY_OUT = 9;
+
+  // The job does not fit any of the other listed types.
+  OTHER_EMPLOYMENT_TYPE = 10;
+}
+
+// An enum that represents the required experience level required for the job.
+enum JobLevel {
+  // The default value if the level isn't specified.
+  JOB_LEVEL_UNSPECIFIED = 0;
+
+  // Entry-level individual contributors, typically with less than 2 years of
+  // experience in a similar role. Includes interns.
+  ENTRY_LEVEL = 1;
+
+  // Experienced individual contributors, typically with 2+ years of
+  // experience in a similar role.
+  EXPERIENCED = 2;
+
+  // Entry- to mid-level managers responsible for managing a team of people.
+  MANAGER = 3;
+
+  // Senior-level managers responsible for managing teams of managers.
+  DIRECTOR = 4;
+
+  // Executive-level managers and above, including C-level positions.
+  EXECUTIVE = 5;
+}
+
+// An enum that represents the categorization or primary focus of specific
+// role. This value is different than the "industry" associated with a role,
+// which is related to the categorization of the company listing the job.
+enum JobCategory {
+  // The default value if the category isn't specified.
+  JOB_CATEGORY_UNSPECIFIED = 0;
+
+  // An accounting and finance job, such as an Accountant.
+  ACCOUNTING_AND_FINANCE = 1;
+
+  // An administrative and office job, such as an Administrative Assistant.
+  ADMINISTRATIVE_AND_OFFICE = 2;
+
+  // An advertising and marketing job, such as Marketing Manager.
+  ADVERTISING_AND_MARKETING = 3;
+
+  // An animal care job, such as Veterinarian.
+  ANIMAL_CARE = 4;
+
+  // An art, fashion, or design job, such as Designer.
+  ART_FASHION_AND_DESIGN = 5;
+
+  // A business operations job, such as Business Operations Manager.
+  BUSINESS_OPERATIONS = 6;
+
+  // A cleaning and facilities job, such as Custodial Staff.
+  CLEANING_AND_FACILITIES = 7;
+
+  // A computer and IT job, such as Systems Administrator.
+  COMPUTER_AND_IT = 8;
+
+  // A construction job, such as General Laborer.
+  CONSTRUCTION = 9;
+
+  // A customer service job, such s Cashier.
+  CUSTOMER_SERVICE = 10;
+
+  // An education job, such as School Teacher.
+  EDUCATION = 11;
+
+  // An entertainment and travel job, such as Flight Attendant.
+  ENTERTAINMENT_AND_TRAVEL = 12;
+
+  // A farming or outdoor job, such as Park Ranger.
+  FARMING_AND_OUTDOORS = 13;
+
+  // A healthcare job, such as Registered Nurse.
+  HEALTHCARE = 14;
+
+  // A human resources job, such as Human Resources Director.
+  HUMAN_RESOURCES = 15;
+
+  // An installation, maintenance, or repair job, such as Electrician.
+  INSTALLATION_MAINTENANCE_AND_REPAIR = 16;
+
+  // A legal job, such as Law Clerk.
+  LEGAL = 17;
+
+  // A management job, often used in conjunction with another category,
+  // such as Store Manager.
+  MANAGEMENT = 18;
+
+  // A manufacturing or warehouse job, such as Assembly Technician.
+  MANUFACTURING_AND_WAREHOUSE = 19;
+
+  // A media, communications, or writing job, such as Media Relations.
+  MEDIA_COMMUNICATIONS_AND_WRITING = 20;
+
+  // An oil, gas or mining job, such as Offshore Driller.
+  OIL_GAS_AND_MINING = 21;
+
+  // A personal care and services job, such as Hair Stylist.
+  PERSONAL_CARE_AND_SERVICES = 22;
+
+  // A protective services job, such as Security Guard.
+  PROTECTIVE_SERVICES = 23;
+
+  // A real estate job, such as Buyer's Agent.
+  REAL_ESTATE = 24;
+
+  // A restaurant and hospitality job, such as Restaurant Server.
+  RESTAURANT_AND_HOSPITALITY = 25;
+
+  // A sales and/or retail job, such Sales Associate.
+  SALES_AND_RETAIL = 26;
+
+  // A science and engineering job, such as Lab Technician.
+  SCIENCE_AND_ENGINEERING = 27;
+
+  // A social services or non-profit job, such as Case Worker.
+  SOCIAL_SERVICES_AND_NON_PROFIT = 28;
+
+  // A sports, fitness, or recreation job, such as Personal Trainer.
+  SPORTS_FITNESS_AND_RECREATION = 29;
+
+  // A transportation or logistics job, such as Truck Driver.
+  TRANSPORTATION_AND_LOGISTICS = 30;
+}
+
+// An enum that represents the job posting region. In most cases, job postings
+// don't need to specify a region. If a region is given, jobs are
+// eligible for searches in the specified region.
+enum PostingRegion {
+  // If the region is unspecified, the job is only returned if it
+  // matches the [LocationFilter][google.cloud.talent.v4beta1.LocationFilter].
+  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".
+  //
+  // Administrative area refers to top-level administrative subdivision of this
+  // country. For example, US state, IT region, UK constituent nation and
+  // JP prefecture.
+  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'.
+  NATION = 2;
+
+  // Job allows employees to work remotely (telecommute).
+  // If locations are provided with this value, the job is
+  // considered as having a location, but telecommuting is allowed.
+  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;
+
+  // The resource is only visible to the GCP account who owns it.
+  ACCOUNT_ONLY = 1;
+
+  // The resource is visible to the owner and may be visible to other
+  // applications and processes at Google.
+  SHARED_WITH_GOOGLE = 2;
+
+  // The resource is visible to the owner and may be visible to all other API
+  // clients.
+  SHARED_WITH_PUBLIC = 3;
+}
+
+// Enum that represents the usage of the contact information.
+enum ContactInfoUsage {
+  // Default value.
+  CONTACT_INFO_USAGE_UNSPECIFIED = 0;
+
+  // Personal use.
+  PERSONAL = 1;
+
+  // Work use.
+  WORK = 2;
+
+  // School use.
+  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.
+enum HtmlSanitization {
+  // Default value.
+  HTML_SANITIZATION_UNSPECIFIED = 0;
+
+  // Disables sanitization on HTML input.
+  HTML_SANITIZATION_DISABLED = 1;
+
+  // Sanitizes HTML input, only accepts bold, italic, ordered list, and
+  // unordered list markup tags.
+  SIMPLE_FORMATTING_ONLY = 2;
+}
+
+// Method for commute.
+enum CommuteMethod {
+  // Commute method isn't specified.
+  COMMUTE_METHOD_UNSPECIFIED = 0;
+
+  // Commute time is calculated based on driving time.
+  DRIVING = 1;
+
+  // Commute time is calculated based on public transit including bus, metro,
+  // subway, and so on.
+  TRANSIT = 2;
+
+  // Commute time is calculated based on walking time.
+  WALKING = 3;
+
+  // Commute time is calculated based on biking time.
+  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`.
+  //
+  // The client-defined scope or source of the service call, which typically
+  // is the domain on
+  // which the service has been implemented and is currently being run.
+  //
+  // For example, if the service is being run by client <em>Foo, Inc.</em>, on
+  // job board www.foo.com and career site www.bar.com, then this field is
+  // set to "foo.com" for use on the job board, and "bar.com" for use on the
+  // career site.
+  //
+  // Note that any improvements to the model for a particular tenant site rely
+  // on this field being set correctly to a unique domain.
+  //
+  // 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`.
+  //
+  // A unique session identification string. A session is defined as the
+  // duration of an end user's interaction with the service over a certain
+  // period.
+  // Obfuscate this field for privacy concerns before
+  // providing it to the service.
+  //
+  // Note that any improvements to the model for a particular tenant site rely
+  // on this field being set correctly to a unique session ID.
+  //
+  // 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`.
+  //
+  // A unique user identification string, as determined by the client.
+  // To have the strongest positive impact on search quality
+  // make sure the client-level is unique.
+  // Obfuscate this field for privacy concerns before
+  // providing it to the service.
+  //
+  // Note that any improvements to the model for a particular tenant site rely
+  // on this field being set correctly to a unique user ID.
+  //
+  // 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.
+  bool allow_missing_ids = 4;
+
+  // Optional. 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.
+message ResponseMetadata {
+  // A unique id associated with this call.
+  // This id is logged for tracking purposes.
+  string request_id = 1;
+}
+
+// Device information collected from the job seeker, candidate, or
+// other entity conducting the job search. Providing this information improves
+// the quality of the search results across devices.
+message DeviceInfo {
+  // An enumeration describing an API access portal and exposure mechanism.
+  enum DeviceType {
+    // The device type isn't specified.
+    DEVICE_TYPE_UNSPECIFIED = 0;
+
+    // A desktop web browser, such as, Chrome, Firefox, Safari, or Internet
+    // Explorer)
+    WEB = 1;
+
+    // A mobile device web browser, such as a phone or tablet with a Chrome
+    // browser.
+    MOBILE_WEB = 2;
+
+    // An Android device native application.
+    ANDROID = 3;
+
+    // An iOS device native application.
+    IOS = 4;
+
+    // A bot, as opposed to a device operated by human beings, such as a web
+    // crawler.
+    BOT = 5;
+
+    // Other devices types.
+    OTHER = 6;
+  }
+
+  // Optional. Type of the device.
+  DeviceType device_type = 1;
+
+  // Optional. 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.
+  //
+  // 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
+  // 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.
+  //
+  // 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.
+  repeated int64 long_values = 2;
+
+  // Optional. 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.
+message SpellingCorrection {
+  // Indicates if the query was corrected by the spell checker.
+  bool corrected = 1;
+
+  // Correction output consisting of the corrected keyword string.
+  string corrected_text = 2;
+
+  // Corrected output with html tags to highlight the corrected words.
+  // Corrected words are called out with the "<b><i>...</i></b>" html tags.
+  //
+  // For example, the user input query is "software enginear", where the second
+  // word, "enginear," is incorrect. It should be "engineer". When spelling
+  // correction is enabled, this value is
+  // "software <b><i>engineer</i></b>".
+  string corrected_html = 3;
+}
+
+// Job compensation details.
+message CompensationInfo {
+  // A compensation entry that represents one component of compensation, such
+  // 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
+  // [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year].
+  message CompensationEntry {
+    // Optional. Compensation type.
+    //
+    // Default is
+    // [CompensationType.COMPENSATION_TYPE_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationType.COMPENSATION_TYPE_UNSPECIFIED].
+    CompensationType type = 1;
+
+    // Optional. Frequency of the specified amount.
+    //
+    // 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.
+      google.type.Money amount = 3;
+
+      // Optional. Compensation range.
+      CompensationRange range = 4;
+    }
+
+    // Optional. 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:
+    // - HOURLY: 2080
+    // - DAILY: 260
+    // - WEEKLY: 52
+    // - MONTHLY: 12
+    // - ANNUAL: 1
+    google.protobuf.DoubleValue expected_units_per_year = 6;
+  }
+
+  // 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.
+    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.
+    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].
+  //
+  // 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]
+  // (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.
+  enum CompensationType {
+    // Default value.
+    COMPENSATION_TYPE_UNSPECIFIED = 0;
+
+    // Base compensation: Refers to the fixed amount of money paid to an
+    // employee by an employer in return for work performed. Base compensation
+    // does not include benefits, bonuses or any other potential compensation
+    // from an employer.
+    BASE = 1;
+
+    // Bonus.
+    BONUS = 2;
+
+    // Signing bonus.
+    SIGNING_BONUS = 3;
+
+    // Equity.
+    EQUITY = 4;
+
+    // Profit sharing.
+    PROFIT_SHARING = 5;
+
+    // Commission.
+    COMMISSIONS = 6;
+
+    // Tips.
+    TIPS = 7;
+
+    // Other compensation type.
+    OTHER_COMPENSATION_TYPE = 8;
+  }
+
+  // Pay frequency.
+  enum CompensationUnit {
+    // Default value.
+    COMPENSATION_UNIT_UNSPECIFIED = 0;
+
+    // Hourly.
+    HOURLY = 1;
+
+    // Daily.
+    DAILY = 2;
+
+    // Weekly
+    WEEKLY = 3;
+
+    // Monthly.
+    MONTHLY = 4;
+
+    // Yearly.
+    YEARLY = 5;
+
+    // One time.
+    ONE_TIME = 6;
+
+    // Other compensation units.
+    OTHER_COMPENSATION_UNIT = 7;
+  }
+
+  // Optional. 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.
+  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
+  // [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;
+
+  // 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;
+}
+
+// Resource that represents a license or certification.
+message Certification {
+  // Optional. 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.
+  google.type.Date acquire_date = 2;
+
+  // Optional. Expiration date of license of certification.
+  google.type.Date expire_date = 3;
+
+  // Optional. Authority of license, such as government.
+  //
+  // Number of characters allowed is 100.
+  string authority = 4;
+
+  // Optional. Description of license or certification.
+  //
+  // Number of characters allowed is 100,000.
+  string description = 5;
+}
+
+// Resource that represents a skill of a candidate.
+message Skill {
+  // Optional. 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.
+  google.type.Date last_used_date = 2;
+
+  // Optional. Skill proficiency level which indicates how proficient the
+  // candidate is at this skill.
+  SkillProficiencyLevel level = 3;
+
+  // Optional. 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;
+}
+
+// Details of an interview.
+message Interview {
+  // Optional. The rating on this interview.
+  Rating rating = 6;
+
+  // Required. The overall decision resulting from this interview (positive,
+  // negative, nuetral).
+  Outcome outcome = 7;
+}
+
+// The details of the score received for an assessment or interview.
+message Rating {
+  // Overall score.
+  double overall = 1;
+
+  // The minimum value for the score.
+  double min = 2;
+
+  // The maximum value for the score.
+  double max = 3;
+
+  // The steps within the score (for example, interval = 1 max = 5
+  // min = 1 indicates that the score can be 1, 2, 3, 4, or 5)
+  double interval = 4;
+}
+
+// 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.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.
+  SKILL_PROFICIENCY_LEVEL_UNSPECIFIED = 0;
+
+  // Lacks any proficiency in this skill.
+  UNSKILLED = 6;
+
+  // Have a common knowledge or an understanding of basic techniques and
+  // concepts.
+  FUNDAMENTAL_AWARENESS = 1;
+
+  // Have the level of experience gained in a classroom and/or experimental
+  // scenarios or as a trainee on-the-job.
+  NOVICE = 2;
+
+  // Be able to successfully complete tasks in this skill as requested. Help
+  // from an expert may be required from time to time, but can usually perform
+  // skill independently.
+  INTERMEDIATE = 3;
+
+  // Can perform the actions associated with this skill without assistance.
+  ADVANCED = 4;
+
+  // Known as an expert in this area.
+  EXPERT = 5;
+}
+
+// The overall outcome /decision / result indicator.
+enum Outcome {
+  // Default value.
+  OUTCOME_UNSPECIFIED = 0;
+
+  // A positive outcome / passing indicator (for example, candidate was
+  // recommended for hiring or to be moved forward in the hiring process,
+  // candidate passed a test).
+  POSITIVE = 1;
+
+  // A neutral outcome / no clear indicator (for example, no strong
+  // reccommendation either to move forward / not move forward, neutral score).
+  NEUTRAL = 2;
+
+  // A negative outcome / failing indicator (for example, candidate was
+  // recommended to NOT move forward in the hiring process, failed a test).
+  NEGATIVE = 3;
+
+  // The assessment outcome is not available or otherwise unknown (for example,
+  // candidate did not complete assessment).
+  OUTCOME_NOT_AVAILABLE = 4;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/common_pb2.py b/talent/google/cloud/talent_v4beta1/proto/common_pb2.py
new file mode 100644
index 000000000000..9be63181965b
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/common_pb2.py
@@ -0,0 +1,3087 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/common.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.type import date_pb2 as google_dot_type_dot_date__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+from google.type import money_pb2 as google_dot_type_dot_money__pb2
+from google.type import postal_address_pb2 as google_dot_type_dot_postal__address__pb2
+from google.type import timeofday_pb2 as google_dot_type_dot_timeofday__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/common.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\013CommonProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/talent_v4beta1/proto/common.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x16google/type/date.proto\x1a\x18google/type/latlng.proto\x1a\x17google/type/money.proto\x1a google/type/postal_address.proto\x1a\x1bgoogle/type/timeofday.proto"n\n\x0eTimestampRange\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xb7\x03\n\x08Location\x12I\n\rlocation_type\x18\x01 \x01(\x0e\x32\x32.google.cloud.talent.v4beta1.Location.LocationType\x12\x32\n\x0epostal_address\x18\x02 \x01(\x0b\x32\x1a.google.type.PostalAddress\x12$\n\x07lat_lng\x18\x03 \x01(\x0b\x32\x13.google.type.LatLng\x12\x14\n\x0cradius_miles\x18\x04 \x01(\x01"\xef\x01\n\x0cLocationType\x12\x1d\n\x19LOCATION_TYPE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x43OUNTRY\x10\x01\x12\x17\n\x13\x41\x44MINISTRATIVE_AREA\x10\x02\x12\x1b\n\x17SUB_ADMINISTRATIVE_AREA\x10\x03\x12\x0c\n\x08LOCALITY\x10\x04\x12\x0f\n\x0bPOSTAL_CODE\x10\x05\x12\x10\n\x0cSUB_LOCALITY\x10\x06\x12\x12\n\x0eSUB_LOCALITY_1\x10\x07\x12\x12\n\x0eSUB_LOCALITY_2\x10\x08\x12\x10\n\x0cNEIGHBORHOOD\x10\t\x12\x12\n\x0eSTREET_ADDRESS\x10\n"\x9f\x01\n\x0fRequestMetadata\x12\x0e\n\x06\x64omain\x18\x01 \x01(\t\x12\x12\n\nsession_id\x18\x02 \x01(\t\x12\x0f\n\x07user_id\x18\x03 \x01(\t\x12\x19\n\x11\x61llow_missing_ids\x18\x04 \x01(\x08\x12<\n\x0b\x64\x65vice_info\x18\x05 \x01(\x0b\x32\'.google.cloud.talent.v4beta1.DeviceInfo"&\n\x10ResponseMetadata\x12\x12\n\nrequest_id\x18\x01 \x01(\t"\xcf\x01\n\nDeviceInfo\x12G\n\x0b\x64\x65vice_type\x18\x01 \x01(\x0e\x32\x32.google.cloud.talent.v4beta1.DeviceInfo.DeviceType\x12\n\n\x02id\x18\x02 \x01(\t"l\n\nDeviceType\x12\x1b\n\x17\x44\x45VICE_TYPE_UNSPECIFIED\x10\x00\x12\x07\n\x03WEB\x10\x01\x12\x0e\n\nMOBILE_WEB\x10\x02\x12\x0b\n\x07\x41NDROID\x10\x03\x12\x07\n\x03IOS\x10\x04\x12\x07\n\x03\x42OT\x10\x05\x12\t\n\x05OTHER\x10\x06"Q\n\x0f\x43ustomAttribute\x12\x15\n\rstring_values\x18\x01 \x03(\t\x12\x13\n\x0blong_values\x18\x02 \x03(\x03\x12\x12\n\nfilterable\x18\x03 \x01(\x08"W\n\x12SpellingCorrection\x12\x11\n\tcorrected\x18\x01 \x01(\x08\x12\x16\n\x0e\x63orrected_text\x18\x02 \x01(\t\x12\x16\n\x0e\x63orrected_html\x18\x03 \x01(\t"\x9c\t\n\x10\x43ompensationInfo\x12P\n\x07\x65ntries\x18\x01 \x03(\x0b\x32?.google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry\x12k\n"annualized_base_compensation_range\x18\x02 \x01(\x0b\x32?.google.cloud.talent.v4beta1.CompensationInfo.CompensationRange\x12l\n#annualized_total_compensation_range\x18\x03 \x01(\x0b\x32?.google.cloud.talent.v4beta1.CompensationInfo.CompensationRange\x1a\x92\x03\n\x11\x43ompensationEntry\x12L\n\x04type\x18\x01 \x01(\x0e\x32>.google.cloud.talent.v4beta1.CompensationInfo.CompensationType\x12L\n\x04unit\x18\x02 \x01(\x0e\x32>.google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit\x12$\n\x06\x61mount\x18\x03 \x01(\x0b\x32\x12.google.type.MoneyH\x00\x12P\n\x05range\x18\x04 \x01(\x0b\x32?.google.cloud.talent.v4beta1.CompensationInfo.CompensationRangeH\x00\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t\x12=\n\x17\x65xpected_units_per_year\x18\x06 \x01(\x0b\x32\x1c.google.protobuf.DoubleValueB\x15\n\x13\x63ompensation_amount\x1ao\n\x11\x43ompensationRange\x12,\n\x10max_compensation\x18\x02 \x01(\x0b\x32\x12.google.type.Money\x12,\n\x10min_compensation\x18\x01 \x01(\x0b\x32\x12.google.type.Money"\xb5\x01\n\x10\x43ompensationType\x12!\n\x1d\x43OMPENSATION_TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42\x41SE\x10\x01\x12\t\n\x05\x42ONUS\x10\x02\x12\x11\n\rSIGNING_BONUS\x10\x03\x12\n\n\x06\x45QUITY\x10\x04\x12\x12\n\x0ePROFIT_SHARING\x10\x05\x12\x0f\n\x0b\x43OMMISSIONS\x10\x06\x12\x08\n\x04TIPS\x10\x07\x12\x1b\n\x17OTHER_COMPENSATION_TYPE\x10\x08"\x9c\x01\n\x10\x43ompensationUnit\x12!\n\x1d\x43OMPENSATION_UNIT_UNSPECIFIED\x10\x00\x12\n\n\x06HOURLY\x10\x01\x12\t\n\x05\x44\x41ILY\x10\x02\x12\n\n\x06WEEKLY\x10\x03\x12\x0b\n\x07MONTHLY\x10\x04\x12\n\n\x06YEARLY\x10\x05\x12\x0c\n\x08ONE_TIME\x10\x06\x12\x1b\n\x17OTHER_COMPENSATION_UNIT\x10\x07"\x9e\x01\n\rCertification\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\'\n\x0c\x61\x63quire_date\x18\x02 \x01(\x0b\x32\x11.google.type.Date\x12&\n\x0b\x65xpire_date\x18\x03 \x01(\x0b\x32\x11.google.type.Date\x12\x11\n\tauthority\x18\x04 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t"\xb8\x01\n\x05Skill\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12)\n\x0elast_used_date\x18\x02 \x01(\x0b\x32\x11.google.type.Date\x12\x41\n\x05level\x18\x03 \x01(\x0e\x32\x32.google.cloud.talent.v4beta1.SkillProficiencyLevel\x12\x0f\n\x07\x63ontext\x18\x04 \x01(\t\x12\x1a\n\x12skill_name_snippet\x18\x05 \x01(\t"w\n\tInterview\x12\x33\n\x06rating\x18\x06 \x01(\x0b\x32#.google.cloud.talent.v4beta1.Rating\x12\x35\n\x07outcome\x18\x07 \x01(\x0e\x32$.google.cloud.talent.v4beta1.Outcome"E\n\x06Rating\x12\x0f\n\x07overall\x18\x01 \x01(\x01\x12\x0b\n\x03min\x18\x02 \x01(\x01\x12\x0b\n\x03max\x18\x03 \x01(\x01\x12\x10\n\x08interval\x18\x04 \x01(\x01"\xcc\x03\n\x16\x42\x61tchOperationMetadata\x12H\n\x05state\x18\x01 \x01(\x0e\x32\x39.google.cloud.talent.v4beta1.BatchOperationMetadata.State\x12\x19\n\x11state_description\x18\x02 \x01(\t\x12\x15\n\rsuccess_count\x18\x03 \x01(\x05\x12\x15\n\rfailure_count\x18\x04 \x01(\x05\x12\x13\n\x0btotal_count\x18\x05 \x01(\x05\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"z\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x10\n\x0cINITIALIZING\x10\x01\x12\x0e\n\nPROCESSING\x10\x02\x12\r\n\tSUCCEEDED\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04\x12\x0e\n\nCANCELLING\x10\x05\x12\r\n\tCANCELLED\x10\x06*y\n\x0b\x43ompanySize\x12\x1c\n\x18\x43OMPANY_SIZE_UNSPECIFIED\x10\x00\x12\x08\n\x04MINI\x10\x01\x12\t\n\x05SMALL\x10\x02\x12\x0b\n\x07SMEDIUM\x10\x03\x12\n\n\x06MEDIUM\x10\x04\x12\x07\n\x03\x42IG\x10\x05\x12\n\n\x06\x42IGGER\x10\x06\x12\t\n\x05GIANT\x10\x07*\xe2\x01\n\nJobBenefit\x12\x1b\n\x17JOB_BENEFIT_UNSPECIFIED\x10\x00\x12\x0e\n\nCHILD_CARE\x10\x01\x12\n\n\x06\x44\x45NTAL\x10\x02\x12\x14\n\x10\x44OMESTIC_PARTNER\x10\x03\x12\x12\n\x0e\x46LEXIBLE_HOURS\x10\x04\x12\x0b\n\x07MEDICAL\x10\x05\x12\x12\n\x0eLIFE_INSURANCE\x10\x06\x12\x12\n\x0ePARENTAL_LEAVE\x10\x07\x12\x13\n\x0fRETIREMENT_PLAN\x10\x08\x12\r\n\tSICK_DAYS\x10\t\x12\x0c\n\x08VACATION\x10\n\x12\n\n\x06VISION\x10\x0b*\x8e\x02\n\nDegreeType\x12\x1b\n\x17\x44\x45GREE_TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11PRIMARY_EDUCATION\x10\x01\x12\x1d\n\x19LOWER_SECONDARY_EDUCATION\x10\x02\x12\x1d\n\x19UPPER_SECONDARY_EDUCATION\x10\x03\x12\x1c\n\x18\x41\x44ULT_REMEDIAL_EDUCATION\x10\x04\x12\x1c\n\x18\x41SSOCIATES_OR_EQUIVALENT\x10\x05\x12\x1b\n\x17\x42\x41\x43HELORS_OR_EQUIVALENT\x10\x06\x12\x19\n\x15MASTERS_OR_EQUIVALENT\x10\x07\x12\x1a\n\x16\x44OCTORAL_OR_EQUIVALENT\x10\x08*\xdc\x01\n\x0e\x45mploymentType\x12\x1f\n\x1b\x45MPLOYMENT_TYPE_UNSPECIFIED\x10\x00\x12\r\n\tFULL_TIME\x10\x01\x12\r\n\tPART_TIME\x10\x02\x12\x0e\n\nCONTRACTOR\x10\x03\x12\x14\n\x10\x43ONTRACT_TO_HIRE\x10\x04\x12\r\n\tTEMPORARY\x10\x05\x12\n\n\x06INTERN\x10\x06\x12\r\n\tVOLUNTEER\x10\x07\x12\x0c\n\x08PER_DIEM\x10\x08\x12\x12\n\x0e\x46LY_IN_FLY_OUT\x10\t\x12\x19\n\x15OTHER_EMPLOYMENT_TYPE\x10\n*q\n\x08JobLevel\x12\x19\n\x15JOB_LEVEL_UNSPECIFIED\x10\x00\x12\x0f\n\x0b\x45NTRY_LEVEL\x10\x01\x12\x0f\n\x0b\x45XPERIENCED\x10\x02\x12\x0b\n\x07MANAGER\x10\x03\x12\x0c\n\x08\x44IRECTOR\x10\x04\x12\r\n\tEXECUTIVE\x10\x05*\xba\x06\n\x0bJobCategory\x12\x1c\n\x18JOB_CATEGORY_UNSPECIFIED\x10\x00\x12\x1a\n\x16\x41\x43\x43OUNTING_AND_FINANCE\x10\x01\x12\x1d\n\x19\x41\x44MINISTRATIVE_AND_OFFICE\x10\x02\x12\x1d\n\x19\x41\x44VERTISING_AND_MARKETING\x10\x03\x12\x0f\n\x0b\x41NIMAL_CARE\x10\x04\x12\x1a\n\x16\x41RT_FASHION_AND_DESIGN\x10\x05\x12\x17\n\x13\x42USINESS_OPERATIONS\x10\x06\x12\x1b\n\x17\x43LEANING_AND_FACILITIES\x10\x07\x12\x13\n\x0f\x43OMPUTER_AND_IT\x10\x08\x12\x10\n\x0c\x43ONSTRUCTION\x10\t\x12\x14\n\x10\x43USTOMER_SERVICE\x10\n\x12\r\n\tEDUCATION\x10\x0b\x12\x1c\n\x18\x45NTERTAINMENT_AND_TRAVEL\x10\x0c\x12\x18\n\x14\x46\x41RMING_AND_OUTDOORS\x10\r\x12\x0e\n\nHEALTHCARE\x10\x0e\x12\x13\n\x0fHUMAN_RESOURCES\x10\x0f\x12\'\n#INSTALLATION_MAINTENANCE_AND_REPAIR\x10\x10\x12\t\n\x05LEGAL\x10\x11\x12\x0e\n\nMANAGEMENT\x10\x12\x12\x1f\n\x1bMANUFACTURING_AND_WAREHOUSE\x10\x13\x12$\n MEDIA_COMMUNICATIONS_AND_WRITING\x10\x14\x12\x16\n\x12OIL_GAS_AND_MINING\x10\x15\x12\x1e\n\x1aPERSONAL_CARE_AND_SERVICES\x10\x16\x12\x17\n\x13PROTECTIVE_SERVICES\x10\x17\x12\x0f\n\x0bREAL_ESTATE\x10\x18\x12\x1e\n\x1aRESTAURANT_AND_HOSPITALITY\x10\x19\x12\x14\n\x10SALES_AND_RETAIL\x10\x1a\x12\x1b\n\x17SCIENCE_AND_ENGINEERING\x10\x1b\x12"\n\x1eSOCIAL_SERVICES_AND_NON_PROFIT\x10\x1c\x12!\n\x1dSPORTS_FITNESS_AND_RECREATION\x10\x1d\x12 \n\x1cTRANSPORTATION_AND_LOGISTICS\x10\x1e*e\n\rPostingRegion\x12\x1e\n\x1aPOSTING_REGION_UNSPECIFIED\x10\x00\x12\x17\n\x13\x41\x44MINISTRATIVE_AREA\x10\x01\x12\n\n\x06NATION\x10\x02\x12\x0f\n\x0bTELECOMMUTE\x10\x03*n\n\nVisibility\x12\x1a\n\x16VISIBILITY_UNSPECIFIED\x10\x00\x12\x10\n\x0c\x41\x43\x43OUNT_ONLY\x10\x01\x12\x16\n\x12SHARED_WITH_GOOGLE\x10\x02\x12\x16\n\x12SHARED_WITH_PUBLIC\x10\x03\x1a\x02\x18\x01*Z\n\x10\x43ontactInfoUsage\x12"\n\x1e\x43ONTACT_INFO_USAGE_UNSPECIFIED\x10\x00\x12\x0c\n\x08PERSONAL\x10\x01\x12\x08\n\x04WORK\x10\x02\x12\n\n\x06SCHOOL\x10\x03*q\n\x10HtmlSanitization\x12!\n\x1dHTML_SANITIZATION_UNSPECIFIED\x10\x00\x12\x1e\n\x1aHTML_SANITIZATION_DISABLED\x10\x01\x12\x1a\n\x16SIMPLE_FORMATTING_ONLY\x10\x02*c\n\rCommuteMethod\x12\x1e\n\x1a\x43OMMUTE_METHOD_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x44RIVING\x10\x01\x12\x0b\n\x07TRANSIT\x10\x02\x12\x0b\n\x07WALKING\x10\x03\x12\x0b\n\x07\x43YCLING\x10\x04*\xa2\x01\n\x15SkillProficiencyLevel\x12\'\n#SKILL_PROFICIENCY_LEVEL_UNSPECIFIED\x10\x00\x12\r\n\tUNSKILLED\x10\x06\x12\x19\n\x15\x46UNDAMENTAL_AWARENESS\x10\x01\x12\n\n\x06NOVICE\x10\x02\x12\x10\n\x0cINTERMEDIATE\x10\x03\x12\x0c\n\x08\x41\x44VANCED\x10\x04\x12\n\n\x06\x45XPERT\x10\x05*f\n\x07Outcome\x12\x17\n\x13OUTCOME_UNSPECIFIED\x10\x00\x12\x0c\n\x08POSITIVE\x10\x01\x12\x0b\n\x07NEUTRAL\x10\x02\x12\x0c\n\x08NEGATIVE\x10\x03\x12\x19\n\x15OUTCOME_NOT_AVAILABLE\x10\x04\x42y\n\x1f\x63om.google.cloud.talent.v4beta1B\x0b\x43ommonProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_type_dot_date__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+        google_dot_type_dot_money__pb2.DESCRIPTOR,
+        google_dot_type_dot_postal__address__pb2.DESCRIPTOR,
+        google_dot_type_dot_timeofday__pb2.DESCRIPTOR,
+    ],
+)
+
+_COMPANYSIZE = _descriptor.EnumDescriptor(
+    name="CompanySize",
+    full_name="google.cloud.talent.v4beta1.CompanySize",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPANY_SIZE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MINI", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SMALL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SMEDIUM", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEDIUM", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BIG", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BIGGER", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GIANT", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3636,
+    serialized_end=3757,
+)
+_sym_db.RegisterEnumDescriptor(_COMPANYSIZE)
+
+CompanySize = enum_type_wrapper.EnumTypeWrapper(_COMPANYSIZE)
+_JOBBENEFIT = _descriptor.EnumDescriptor(
+    name="JobBenefit",
+    full_name="google.cloud.talent.v4beta1.JobBenefit",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="JOB_BENEFIT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHILD_CARE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DENTAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOMESTIC_PARTNER",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLEXIBLE_HOURS", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEDICAL", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIFE_INSURANCE", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARENTAL_LEAVE", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RETIREMENT_PLAN",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SICK_DAYS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VACATION", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VISION", index=11, number=11, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3760,
+    serialized_end=3986,
+)
+_sym_db.RegisterEnumDescriptor(_JOBBENEFIT)
+
+JobBenefit = enum_type_wrapper.EnumTypeWrapper(_JOBBENEFIT)
+_DEGREETYPE = _descriptor.EnumDescriptor(
+    name="DegreeType",
+    full_name="google.cloud.talent.v4beta1.DegreeType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DEGREE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRIMARY_EDUCATION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOWER_SECONDARY_EDUCATION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_SECONDARY_EDUCATION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADULT_REMEDIAL_EDUCATION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ASSOCIATES_OR_EQUIVALENT",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BACHELORS_OR_EQUIVALENT",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MASTERS_OR_EQUIVALENT",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOCTORAL_OR_EQUIVALENT",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3989,
+    serialized_end=4259,
+)
+_sym_db.RegisterEnumDescriptor(_DEGREETYPE)
+
+DegreeType = enum_type_wrapper.EnumTypeWrapper(_DEGREETYPE)
+_EMPLOYMENTTYPE = _descriptor.EnumDescriptor(
+    name="EmploymentType",
+    full_name="google.cloud.talent.v4beta1.EmploymentType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EMPLOYMENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL_TIME", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PART_TIME", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONTRACTOR", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONTRACT_TO_HIRE",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEMPORARY", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERN", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOLUNTEER", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PER_DIEM", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FLY_IN_FLY_OUT", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_EMPLOYMENT_TYPE",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4262,
+    serialized_end=4482,
+)
+_sym_db.RegisterEnumDescriptor(_EMPLOYMENTTYPE)
+
+EmploymentType = enum_type_wrapper.EnumTypeWrapper(_EMPLOYMENTTYPE)
+_JOBLEVEL = _descriptor.EnumDescriptor(
+    name="JobLevel",
+    full_name="google.cloud.talent.v4beta1.JobLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="JOB_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENTRY_LEVEL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPERIENCED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MANAGER", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DIRECTOR", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXECUTIVE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4484,
+    serialized_end=4597,
+)
+_sym_db.RegisterEnumDescriptor(_JOBLEVEL)
+
+JobLevel = enum_type_wrapper.EnumTypeWrapper(_JOBLEVEL)
+_JOBCATEGORY = _descriptor.EnumDescriptor(
+    name="JobCategory",
+    full_name="google.cloud.talent.v4beta1.JobCategory",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="JOB_CATEGORY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCOUNTING_AND_FINANCE",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADMINISTRATIVE_AND_OFFICE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVERTISING_AND_MARKETING",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANIMAL_CARE", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ART_FASHION_AND_DESIGN",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BUSINESS_OPERATIONS",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CLEANING_AND_FACILITIES",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPUTER_AND_IT",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CONSTRUCTION", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOMER_SERVICE",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EDUCATION", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENTERTAINMENT_AND_TRAVEL",
+            index=12,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FARMING_AND_OUTDOORS",
+            index=13,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEALTHCARE", index=14, number=14, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HUMAN_RESOURCES",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSTALLATION_MAINTENANCE_AND_REPAIR",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEGAL", index=17, number=17, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MANAGEMENT", index=18, number=18, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MANUFACTURING_AND_WAREHOUSE",
+            index=19,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEDIA_COMMUNICATIONS_AND_WRITING",
+            index=20,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OIL_GAS_AND_MINING",
+            index=21,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERSONAL_CARE_AND_SERVICES",
+            index=22,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROTECTIVE_SERVICES",
+            index=23,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REAL_ESTATE", index=24, number=24, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESTAURANT_AND_HOSPITALITY",
+            index=25,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SALES_AND_RETAIL",
+            index=26,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCIENCE_AND_ENGINEERING",
+            index=27,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SOCIAL_SERVICES_AND_NON_PROFIT",
+            index=28,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPORTS_FITNESS_AND_RECREATION",
+            index=29,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TRANSPORTATION_AND_LOGISTICS",
+            index=30,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4600,
+    serialized_end=5426,
+)
+_sym_db.RegisterEnumDescriptor(_JOBCATEGORY)
+
+JobCategory = enum_type_wrapper.EnumTypeWrapper(_JOBCATEGORY)
+_POSTINGREGION = _descriptor.EnumDescriptor(
+    name="PostingRegion",
+    full_name="google.cloud.talent.v4beta1.PostingRegion",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="POSTING_REGION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADMINISTRATIVE_AREA",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NATION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TELECOMMUTE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5428,
+    serialized_end=5529,
+)
+_sym_db.RegisterEnumDescriptor(_POSTINGREGION)
+
+PostingRegion = enum_type_wrapper.EnumTypeWrapper(_POSTINGREGION)
+_VISIBILITY = _descriptor.EnumDescriptor(
+    name="Visibility",
+    full_name="google.cloud.talent.v4beta1.Visibility",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VISIBILITY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ACCOUNT_ONLY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHARED_WITH_GOOGLE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHARED_WITH_PUBLIC",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=_b("\030\001"),
+    serialized_start=5531,
+    serialized_end=5641,
+)
+_sym_db.RegisterEnumDescriptor(_VISIBILITY)
+
+Visibility = enum_type_wrapper.EnumTypeWrapper(_VISIBILITY)
+_CONTACTINFOUSAGE = _descriptor.EnumDescriptor(
+    name="ContactInfoUsage",
+    full_name="google.cloud.talent.v4beta1.ContactInfoUsage",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CONTACT_INFO_USAGE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PERSONAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WORK", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCHOOL", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5643,
+    serialized_end=5733,
+)
+_sym_db.RegisterEnumDescriptor(_CONTACTINFOUSAGE)
+
+ContactInfoUsage = enum_type_wrapper.EnumTypeWrapper(_CONTACTINFOUSAGE)
+_HTMLSANITIZATION = _descriptor.EnumDescriptor(
+    name="HtmlSanitization",
+    full_name="google.cloud.talent.v4beta1.HtmlSanitization",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTML_SANITIZATION_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HTML_SANITIZATION_DISABLED",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SIMPLE_FORMATTING_ONLY",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5735,
+    serialized_end=5848,
+)
+_sym_db.RegisterEnumDescriptor(_HTMLSANITIZATION)
+
+HtmlSanitization = enum_type_wrapper.EnumTypeWrapper(_HTMLSANITIZATION)
+_COMMUTEMETHOD = _descriptor.EnumDescriptor(
+    name="CommuteMethod",
+    full_name="google.cloud.talent.v4beta1.CommuteMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMMUTE_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DRIVING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TRANSIT", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WALKING", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CYCLING", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5850,
+    serialized_end=5949,
+)
+_sym_db.RegisterEnumDescriptor(_COMMUTEMETHOD)
+
+CommuteMethod = enum_type_wrapper.EnumTypeWrapper(_COMMUTEMETHOD)
+_SKILLPROFICIENCYLEVEL = _descriptor.EnumDescriptor(
+    name="SkillProficiencyLevel",
+    full_name="google.cloud.talent.v4beta1.SkillProficiencyLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SKILL_PROFICIENCY_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNSKILLED", index=1, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FUNDAMENTAL_AWARENESS",
+            index=2,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOVICE", index=3, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERMEDIATE", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADVANCED", index=5, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPERT", index=6, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5952,
+    serialized_end=6114,
+)
+_sym_db.RegisterEnumDescriptor(_SKILLPROFICIENCYLEVEL)
+
+SkillProficiencyLevel = enum_type_wrapper.EnumTypeWrapper(_SKILLPROFICIENCYLEVEL)
+_OUTCOME = _descriptor.EnumDescriptor(
+    name="Outcome",
+    full_name="google.cloud.talent.v4beta1.Outcome",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="OUTCOME_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSITIVE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEUTRAL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEGATIVE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OUTCOME_NOT_AVAILABLE",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6116,
+    serialized_end=6218,
+)
+_sym_db.RegisterEnumDescriptor(_OUTCOME)
+
+Outcome = enum_type_wrapper.EnumTypeWrapper(_OUTCOME)
+COMPANY_SIZE_UNSPECIFIED = 0
+MINI = 1
+SMALL = 2
+SMEDIUM = 3
+MEDIUM = 4
+BIG = 5
+BIGGER = 6
+GIANT = 7
+JOB_BENEFIT_UNSPECIFIED = 0
+CHILD_CARE = 1
+DENTAL = 2
+DOMESTIC_PARTNER = 3
+FLEXIBLE_HOURS = 4
+MEDICAL = 5
+LIFE_INSURANCE = 6
+PARENTAL_LEAVE = 7
+RETIREMENT_PLAN = 8
+SICK_DAYS = 9
+VACATION = 10
+VISION = 11
+DEGREE_TYPE_UNSPECIFIED = 0
+PRIMARY_EDUCATION = 1
+LOWER_SECONDARY_EDUCATION = 2
+UPPER_SECONDARY_EDUCATION = 3
+ADULT_REMEDIAL_EDUCATION = 4
+ASSOCIATES_OR_EQUIVALENT = 5
+BACHELORS_OR_EQUIVALENT = 6
+MASTERS_OR_EQUIVALENT = 7
+DOCTORAL_OR_EQUIVALENT = 8
+EMPLOYMENT_TYPE_UNSPECIFIED = 0
+FULL_TIME = 1
+PART_TIME = 2
+CONTRACTOR = 3
+CONTRACT_TO_HIRE = 4
+TEMPORARY = 5
+INTERN = 6
+VOLUNTEER = 7
+PER_DIEM = 8
+FLY_IN_FLY_OUT = 9
+OTHER_EMPLOYMENT_TYPE = 10
+JOB_LEVEL_UNSPECIFIED = 0
+ENTRY_LEVEL = 1
+EXPERIENCED = 2
+MANAGER = 3
+DIRECTOR = 4
+EXECUTIVE = 5
+JOB_CATEGORY_UNSPECIFIED = 0
+ACCOUNTING_AND_FINANCE = 1
+ADMINISTRATIVE_AND_OFFICE = 2
+ADVERTISING_AND_MARKETING = 3
+ANIMAL_CARE = 4
+ART_FASHION_AND_DESIGN = 5
+BUSINESS_OPERATIONS = 6
+CLEANING_AND_FACILITIES = 7
+COMPUTER_AND_IT = 8
+CONSTRUCTION = 9
+CUSTOMER_SERVICE = 10
+EDUCATION = 11
+ENTERTAINMENT_AND_TRAVEL = 12
+FARMING_AND_OUTDOORS = 13
+HEALTHCARE = 14
+HUMAN_RESOURCES = 15
+INSTALLATION_MAINTENANCE_AND_REPAIR = 16
+LEGAL = 17
+MANAGEMENT = 18
+MANUFACTURING_AND_WAREHOUSE = 19
+MEDIA_COMMUNICATIONS_AND_WRITING = 20
+OIL_GAS_AND_MINING = 21
+PERSONAL_CARE_AND_SERVICES = 22
+PROTECTIVE_SERVICES = 23
+REAL_ESTATE = 24
+RESTAURANT_AND_HOSPITALITY = 25
+SALES_AND_RETAIL = 26
+SCIENCE_AND_ENGINEERING = 27
+SOCIAL_SERVICES_AND_NON_PROFIT = 28
+SPORTS_FITNESS_AND_RECREATION = 29
+TRANSPORTATION_AND_LOGISTICS = 30
+POSTING_REGION_UNSPECIFIED = 0
+ADMINISTRATIVE_AREA = 1
+NATION = 2
+TELECOMMUTE = 3
+VISIBILITY_UNSPECIFIED = 0
+ACCOUNT_ONLY = 1
+SHARED_WITH_GOOGLE = 2
+SHARED_WITH_PUBLIC = 3
+CONTACT_INFO_USAGE_UNSPECIFIED = 0
+PERSONAL = 1
+WORK = 2
+SCHOOL = 3
+HTML_SANITIZATION_UNSPECIFIED = 0
+HTML_SANITIZATION_DISABLED = 1
+SIMPLE_FORMATTING_ONLY = 2
+COMMUTE_METHOD_UNSPECIFIED = 0
+DRIVING = 1
+TRANSIT = 2
+WALKING = 3
+CYCLING = 4
+SKILL_PROFICIENCY_LEVEL_UNSPECIFIED = 0
+UNSKILLED = 6
+FUNDAMENTAL_AWARENESS = 1
+NOVICE = 2
+INTERMEDIATE = 3
+ADVANCED = 4
+EXPERT = 5
+OUTCOME_UNSPECIFIED = 0
+POSITIVE = 1
+NEUTRAL = 2
+NEGATIVE = 3
+OUTCOME_NOT_AVAILABLE = 4
+
+
+_LOCATION_LOCATIONTYPE = _descriptor.EnumDescriptor(
+    name="LocationType",
+    full_name="google.cloud.talent.v4beta1.Location.LocationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LOCATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COUNTRY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ADMINISTRATIVE_AREA",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUB_ADMINISTRATIVE_AREA",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOCALITY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSTAL_CODE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUB_LOCALITY", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUB_LOCALITY_1", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUB_LOCALITY_2", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEIGHBORHOOD", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREET_ADDRESS",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=625,
+    serialized_end=864,
+)
+_sym_db.RegisterEnumDescriptor(_LOCATION_LOCATIONTYPE)
+
+_DEVICEINFO_DEVICETYPE = _descriptor.EnumDescriptor(
+    name="DeviceType",
+    full_name="google.cloud.talent.v4beta1.DeviceInfo.DeviceType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DEVICE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEB", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOBILE_WEB", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANDROID", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IOS", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOT", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1168,
+    serialized_end=1276,
+)
+_sym_db.RegisterEnumDescriptor(_DEVICEINFO_DEVICETYPE)
+
+_COMPENSATIONINFO_COMPENSATIONTYPE = _descriptor.EnumDescriptor(
+    name="CompensationType",
+    full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPENSATION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BONUS", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SIGNING_BONUS", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EQUITY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROFIT_SHARING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMMISSIONS", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIPS", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_COMPENSATION_TYPE",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2291,
+    serialized_end=2472,
+)
+_sym_db.RegisterEnumDescriptor(_COMPENSATIONINFO_COMPENSATIONTYPE)
+
+_COMPENSATIONINFO_COMPENSATIONUNIT = _descriptor.EnumDescriptor(
+    name="CompensationUnit",
+    full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPENSATION_UNIT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HOURLY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DAILY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEEKLY", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MONTHLY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="YEARLY", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ONE_TIME", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_COMPENSATION_UNIT",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2475,
+    serialized_end=2631,
+)
+_sym_db.RegisterEnumDescriptor(_COMPENSATIONINFO_COMPENSATIONUNIT)
+
+_BATCHOPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INITIALIZING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROCESSING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCEEDED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLING", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3512,
+    serialized_end=3634,
+)
+_sym_db.RegisterEnumDescriptor(_BATCHOPERATIONMETADATA_STATE)
+
+
+_TIMESTAMPRANGE = _descriptor.Descriptor(
+    name="TimestampRange",
+    full_name="google.cloud.talent.v4beta1.TimestampRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.talent.v4beta1.TimestampRange.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.talent.v4beta1.TimestampRange.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=312,
+    serialized_end=422,
+)
+
+
+_LOCATION = _descriptor.Descriptor(
+    name="Location",
+    full_name="google.cloud.talent.v4beta1.Location",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="location_type",
+            full_name="google.cloud.talent.v4beta1.Location.location_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="postal_address",
+            full_name="google.cloud.talent.v4beta1.Location.postal_address",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.talent.v4beta1.Location.lat_lng",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="radius_miles",
+            full_name="google.cloud.talent.v4beta1.Location.radius_miles",
+            index=3,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LOCATION_LOCATIONTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=425,
+    serialized_end=864,
+)
+
+
+_REQUESTMETADATA = _descriptor.Descriptor(
+    name="RequestMetadata",
+    full_name="google.cloud.talent.v4beta1.RequestMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="domain",
+            full_name="google.cloud.talent.v4beta1.RequestMetadata.domain",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="session_id",
+            full_name="google.cloud.talent.v4beta1.RequestMetadata.session_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_id",
+            full_name="google.cloud.talent.v4beta1.RequestMetadata.user_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_missing_ids",
+            full_name="google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="device_info",
+            full_name="google.cloud.talent.v4beta1.RequestMetadata.device_info",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=867,
+    serialized_end=1026,
+)
+
+
+_RESPONSEMETADATA = _descriptor.Descriptor(
+    name="ResponseMetadata",
+    full_name="google.cloud.talent.v4beta1.ResponseMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.talent.v4beta1.ResponseMetadata.request_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1028,
+    serialized_end=1066,
+)
+
+
+_DEVICEINFO = _descriptor.Descriptor(
+    name="DeviceInfo",
+    full_name="google.cloud.talent.v4beta1.DeviceInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="device_type",
+            full_name="google.cloud.talent.v4beta1.DeviceInfo.device_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.cloud.talent.v4beta1.DeviceInfo.id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DEVICEINFO_DEVICETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1069,
+    serialized_end=1276,
+)
+
+
+_CUSTOMATTRIBUTE = _descriptor.Descriptor(
+    name="CustomAttribute",
+    full_name="google.cloud.talent.v4beta1.CustomAttribute",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="string_values",
+            full_name="google.cloud.talent.v4beta1.CustomAttribute.string_values",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="long_values",
+            full_name="google.cloud.talent.v4beta1.CustomAttribute.long_values",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filterable",
+            full_name="google.cloud.talent.v4beta1.CustomAttribute.filterable",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1278,
+    serialized_end=1359,
+)
+
+
+_SPELLINGCORRECTION = _descriptor.Descriptor(
+    name="SpellingCorrection",
+    full_name="google.cloud.talent.v4beta1.SpellingCorrection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="corrected",
+            full_name="google.cloud.talent.v4beta1.SpellingCorrection.corrected",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="corrected_text",
+            full_name="google.cloud.talent.v4beta1.SpellingCorrection.corrected_text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="corrected_html",
+            full_name="google.cloud.talent.v4beta1.SpellingCorrection.corrected_html",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1361,
+    serialized_end=1448,
+)
+
+
+_COMPENSATIONINFO_COMPENSATIONENTRY = _descriptor.Descriptor(
+    name="CompensationEntry",
+    full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unit",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.unit",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="amount",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="range",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expected_units_per_year",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="compensation_amount",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.compensation_amount",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1773,
+    serialized_end=2175,
+)
+
+_COMPENSATIONINFO_COMPENSATIONRANGE = _descriptor.Descriptor(
+    name="CompensationRange",
+    full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationRange",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_compensation",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationRange.max_compensation",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_compensation",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.CompensationRange.min_compensation",
+            index=1,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2177,
+    serialized_end=2288,
+)
+
+_COMPENSATIONINFO = _descriptor.Descriptor(
+    name="CompensationInfo",
+    full_name="google.cloud.talent.v4beta1.CompensationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entries",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.entries",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annualized_base_compensation_range",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annualized_total_compensation_range",
+            full_name="google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _COMPENSATIONINFO_COMPENSATIONENTRY,
+        _COMPENSATIONINFO_COMPENSATIONRANGE,
+    ],
+    enum_types=[_COMPENSATIONINFO_COMPENSATIONTYPE, _COMPENSATIONINFO_COMPENSATIONUNIT],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1451,
+    serialized_end=2631,
+)
+
+
+_CERTIFICATION = _descriptor.Descriptor(
+    name="Certification",
+    full_name="google.cloud.talent.v4beta1.Certification",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.talent.v4beta1.Certification.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="acquire_date",
+            full_name="google.cloud.talent.v4beta1.Certification.acquire_date",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_date",
+            full_name="google.cloud.talent.v4beta1.Certification.expire_date",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authority",
+            full_name="google.cloud.talent.v4beta1.Certification.authority",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.talent.v4beta1.Certification.description",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2634,
+    serialized_end=2792,
+)
+
+
+_SKILL = _descriptor.Descriptor(
+    name="Skill",
+    full_name="google.cloud.talent.v4beta1.Skill",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.talent.v4beta1.Skill.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_used_date",
+            full_name="google.cloud.talent.v4beta1.Skill.last_used_date",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="level",
+            full_name="google.cloud.talent.v4beta1.Skill.level",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.cloud.talent.v4beta1.Skill.context",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skill_name_snippet",
+            full_name="google.cloud.talent.v4beta1.Skill.skill_name_snippet",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2795,
+    serialized_end=2979,
+)
+
+
+_INTERVIEW = _descriptor.Descriptor(
+    name="Interview",
+    full_name="google.cloud.talent.v4beta1.Interview",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="rating",
+            full_name="google.cloud.talent.v4beta1.Interview.rating",
+            index=0,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="outcome",
+            full_name="google.cloud.talent.v4beta1.Interview.outcome",
+            index=1,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2981,
+    serialized_end=3100,
+)
+
+
+_RATING = _descriptor.Descriptor(
+    name="Rating",
+    full_name="google.cloud.talent.v4beta1.Rating",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="overall",
+            full_name="google.cloud.talent.v4beta1.Rating.overall",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min",
+            full_name="google.cloud.talent.v4beta1.Rating.min",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max",
+            full_name="google.cloud.talent.v4beta1.Rating.max",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interval",
+            full_name="google.cloud.talent.v4beta1.Rating.interval",
+            index=3,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3102,
+    serialized_end=3171,
+)
+
+
+_BATCHOPERATIONMETADATA = _descriptor.Descriptor(
+    name="BatchOperationMetadata",
+    full_name="google.cloud.talent.v4beta1.BatchOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state_description",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.state_description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="success_count",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.success_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="failure_count",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.failure_count",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_count",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.total_count",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.create_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.update_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.talent.v4beta1.BatchOperationMetadata.end_time",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BATCHOPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3174,
+    serialized_end=3634,
+)
+
+_TIMESTAMPRANGE.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMESTAMPRANGE.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LOCATION.fields_by_name["location_type"].enum_type = _LOCATION_LOCATIONTYPE
+_LOCATION.fields_by_name[
+    "postal_address"
+].message_type = google_dot_type_dot_postal__address__pb2._POSTALADDRESS
+_LOCATION.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LOCATION_LOCATIONTYPE.containing_type = _LOCATION
+_REQUESTMETADATA.fields_by_name["device_info"].message_type = _DEVICEINFO
+_DEVICEINFO.fields_by_name["device_type"].enum_type = _DEVICEINFO_DEVICETYPE
+_DEVICEINFO_DEVICETYPE.containing_type = _DEVICEINFO
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "type"
+].enum_type = _COMPENSATIONINFO_COMPENSATIONTYPE
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "unit"
+].enum_type = _COMPENSATIONINFO_COMPENSATIONUNIT
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "amount"
+].message_type = google_dot_type_dot_money__pb2._MONEY
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "range"
+].message_type = _COMPENSATIONINFO_COMPENSATIONRANGE
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "expected_units_per_year"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_COMPENSATIONINFO_COMPENSATIONENTRY.containing_type = _COMPENSATIONINFO
+_COMPENSATIONINFO_COMPENSATIONENTRY.oneofs_by_name["compensation_amount"].fields.append(
+    _COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name["amount"]
+)
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "amount"
+].containing_oneof = _COMPENSATIONINFO_COMPENSATIONENTRY.oneofs_by_name[
+    "compensation_amount"
+]
+_COMPENSATIONINFO_COMPENSATIONENTRY.oneofs_by_name["compensation_amount"].fields.append(
+    _COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name["range"]
+)
+_COMPENSATIONINFO_COMPENSATIONENTRY.fields_by_name[
+    "range"
+].containing_oneof = _COMPENSATIONINFO_COMPENSATIONENTRY.oneofs_by_name[
+    "compensation_amount"
+]
+_COMPENSATIONINFO_COMPENSATIONRANGE.fields_by_name[
+    "max_compensation"
+].message_type = google_dot_type_dot_money__pb2._MONEY
+_COMPENSATIONINFO_COMPENSATIONRANGE.fields_by_name[
+    "min_compensation"
+].message_type = google_dot_type_dot_money__pb2._MONEY
+_COMPENSATIONINFO_COMPENSATIONRANGE.containing_type = _COMPENSATIONINFO
+_COMPENSATIONINFO.fields_by_name[
+    "entries"
+].message_type = _COMPENSATIONINFO_COMPENSATIONENTRY
+_COMPENSATIONINFO.fields_by_name[
+    "annualized_base_compensation_range"
+].message_type = _COMPENSATIONINFO_COMPENSATIONRANGE
+_COMPENSATIONINFO.fields_by_name[
+    "annualized_total_compensation_range"
+].message_type = _COMPENSATIONINFO_COMPENSATIONRANGE
+_COMPENSATIONINFO_COMPENSATIONTYPE.containing_type = _COMPENSATIONINFO
+_COMPENSATIONINFO_COMPENSATIONUNIT.containing_type = _COMPENSATIONINFO
+_CERTIFICATION.fields_by_name[
+    "acquire_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_CERTIFICATION.fields_by_name[
+    "expire_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_SKILL.fields_by_name[
+    "last_used_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_SKILL.fields_by_name["level"].enum_type = _SKILLPROFICIENCYLEVEL
+_INTERVIEW.fields_by_name["rating"].message_type = _RATING
+_INTERVIEW.fields_by_name["outcome"].enum_type = _OUTCOME
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "state"
+].enum_type = _BATCHOPERATIONMETADATA_STATE
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA_STATE.containing_type = _BATCHOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["TimestampRange"] = _TIMESTAMPRANGE
+DESCRIPTOR.message_types_by_name["Location"] = _LOCATION
+DESCRIPTOR.message_types_by_name["RequestMetadata"] = _REQUESTMETADATA
+DESCRIPTOR.message_types_by_name["ResponseMetadata"] = _RESPONSEMETADATA
+DESCRIPTOR.message_types_by_name["DeviceInfo"] = _DEVICEINFO
+DESCRIPTOR.message_types_by_name["CustomAttribute"] = _CUSTOMATTRIBUTE
+DESCRIPTOR.message_types_by_name["SpellingCorrection"] = _SPELLINGCORRECTION
+DESCRIPTOR.message_types_by_name["CompensationInfo"] = _COMPENSATIONINFO
+DESCRIPTOR.message_types_by_name["Certification"] = _CERTIFICATION
+DESCRIPTOR.message_types_by_name["Skill"] = _SKILL
+DESCRIPTOR.message_types_by_name["Interview"] = _INTERVIEW
+DESCRIPTOR.message_types_by_name["Rating"] = _RATING
+DESCRIPTOR.message_types_by_name["BatchOperationMetadata"] = _BATCHOPERATIONMETADATA
+DESCRIPTOR.enum_types_by_name["CompanySize"] = _COMPANYSIZE
+DESCRIPTOR.enum_types_by_name["JobBenefit"] = _JOBBENEFIT
+DESCRIPTOR.enum_types_by_name["DegreeType"] = _DEGREETYPE
+DESCRIPTOR.enum_types_by_name["EmploymentType"] = _EMPLOYMENTTYPE
+DESCRIPTOR.enum_types_by_name["JobLevel"] = _JOBLEVEL
+DESCRIPTOR.enum_types_by_name["JobCategory"] = _JOBCATEGORY
+DESCRIPTOR.enum_types_by_name["PostingRegion"] = _POSTINGREGION
+DESCRIPTOR.enum_types_by_name["Visibility"] = _VISIBILITY
+DESCRIPTOR.enum_types_by_name["ContactInfoUsage"] = _CONTACTINFOUSAGE
+DESCRIPTOR.enum_types_by_name["HtmlSanitization"] = _HTMLSANITIZATION
+DESCRIPTOR.enum_types_by_name["CommuteMethod"] = _COMMUTEMETHOD
+DESCRIPTOR.enum_types_by_name["SkillProficiencyLevel"] = _SKILLPROFICIENCYLEVEL
+DESCRIPTOR.enum_types_by_name["Outcome"] = _OUTCOME
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TimestampRange = _reflection.GeneratedProtocolMessageType(
+    "TimestampRange",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMESTAMPRANGE,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Message representing a period of time between two timestamps.
+  
+  
+  Attributes:
+      start_time:
+          Begin of the period (inclusive).
+      end_time:
+          End of the period (exclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.TimestampRange)
+    ),
+)
+_sym_db.RegisterMessage(TimestampRange)
+
+Location = _reflection.GeneratedProtocolMessageType(
+    "Location",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATION,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Output only. A resource that represents a location with full geographic
+  information.
+  
+  
+  Attributes:
+      location_type:
+          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 [LocationT
+          ype.NEIGHBORHOOD][google.cloud.talent.v4beta1.Location.Locatio
+          nType.NEIGHBORHOOD], and "Kansas City, KS, USA" has a type of 
+          [LocationType.LOCALITY][google.cloud.talent.v4beta1.Location.L
+          ocationType.LOCALITY].
+      postal_address:
+          Postal address of the location that includes human readable
+          information, such as postal delivery and payments addresses.
+          Given a postal address, a postal service can deliver items to
+          a premises, P.O. Box, or other delivery location.
+      lat_lng:
+          An object representing a latitude/longitude pair.
+      radius_miles:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Location)
+    ),
+)
+_sym_db.RegisterMessage(Location)
+
+RequestMetadata = _reflection.GeneratedProtocolMessageType(
+    "RequestMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REQUESTMETADATA,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      domain:
+          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 which the service has been
+          implemented and is currently being run.  For example, if the
+          service is being run by client Foo, Inc., on job board
+          www.foo.com and career site www.bar.com, then this field is
+          set to "foo.com" for use on the job board, and "bar.com" for
+          use on the career site.  Note that any improvements to the
+          model for a particular tenant site rely on this field being
+          set correctly to a unique domain.  The maximum number of
+          allowed characters is 255.
+      session_id:
+          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 period. Obfuscate this field for privacy
+          concerns before providing it to the service.  Note that any
+          improvements to the model for a particular tenant site rely on
+          this field being set correctly to a unique session ID.  The
+          maximum number of allowed characters is 255.
+      user_id:
+          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 make sure the client-level is unique. Obfuscate this
+          field for privacy concerns before providing it to the service.
+          Note that any improvements to the model for a particular
+          tenant site rely on this field being set correctly to a unique
+          user ID.  The maximum number of allowed characters is 255.
+      allow_missing_ids:
+          Optional. If set to ``true``,
+          [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], 
+          [session\_id][google.cloud.talent.v4beta1.RequestMetadata.sess
+          ion\_id] and [user\_id][google.cloud.talent.v4beta1.RequestMet
+          adata.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.sess
+          ion\_id] and [user\_id][google.cloud.talent.v4beta1.RequestMet
+          adata.user\_id] for the best service experience.
+      device_info:
+          Optional. The type of device used by the job seeker at the
+          time of the call to the service.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.RequestMetadata)
+    ),
+)
+_sym_db.RegisterMessage(RequestMetadata)
+
+ResponseMetadata = _reflection.GeneratedProtocolMessageType(
+    "ResponseMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESPONSEMETADATA,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Output only. Additional information returned to client, such as
+  debugging information.
+  
+  
+  Attributes:
+      request_id:
+          A unique id associated with this call. This id is logged for
+          tracking purposes.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ResponseMetadata)
+    ),
+)
+_sym_db.RegisterMessage(ResponseMetadata)
+
+DeviceInfo = _reflection.GeneratedProtocolMessageType(
+    "DeviceInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEVICEINFO,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Device information collected from the job seeker, candidate, or other
+  entity conducting the job search. Providing this information improves
+  the quality of the search results across devices.
+  
+  
+  Attributes:
+      device_type:
+          Optional. Type of the device.
+      id:
+          Optional. A device-specific ID. The ID must be a unique
+          identifier that distinguishes the device from other devices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.DeviceInfo)
+    ),
+)
+_sym_db.RegisterMessage(DeviceInfo)
+
+CustomAttribute = _reflection.GeneratedProtocolMessageType(
+    "CustomAttribute",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CUSTOMATTRIBUTE,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Custom attribute values that are either filterable or non-filterable.
+  
+  
+  Attributes:
+      string_values:
+          Optional but exactly one of [string\_values][google.cloud.tale
+          nt.v4beta1.CustomAttribute.string\_values] or [long\_values][g
+          oogle.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 500B. For unfilterable
+          ``string_values``, the maximum total byte size of unfilterable
+          ``string_values`` is 50KB.  Empty string isn't allowed.
+      long_values:
+          Optional but exactly one of [string\_values][google.cloud.tale
+          nt.v4beta1.CustomAttribute.string\_values] or [long\_values][g
+          oogle.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.
+      filterable:
+          Optional. If the ``filterable`` flag is true, custom field
+          values are searchable. If false, values are not searchable.
+          Default is false.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CustomAttribute)
+    ),
+)
+_sym_db.RegisterMessage(CustomAttribute)
+
+SpellingCorrection = _reflection.GeneratedProtocolMessageType(
+    "SpellingCorrection",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPELLINGCORRECTION,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Output only. Spell check result.
+  
+  
+  Attributes:
+      corrected:
+          Indicates if the query was corrected by the spell checker.
+      corrected_text:
+          Correction output consisting of the corrected keyword string.
+      corrected_html:
+          Corrected output with html tags to highlight the corrected
+          words. Corrected words are called out with the "..." html
+          tags.  For example, the user input query is "software
+          enginear", where the second word, "enginear," is incorrect. It
+          should be "engineer". When spelling correction is enabled,
+          this value is "software engineer".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SpellingCorrection)
+    ),
+)
+_sym_db.RegisterMessage(SpellingCorrection)
+
+CompensationInfo = _reflection.GeneratedProtocolMessageType(
+    "CompensationInfo",
+    (_message.Message,),
+    dict(
+        CompensationEntry=_reflection.GeneratedProtocolMessageType(
+            "CompensationEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMPENSATIONINFO_COMPENSATIONENTRY,
+                __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+                __doc__="""A compensation entry that represents one component of compensation, such
+    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
+    [expected\_units\_per\_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected\_units\_per\_year].
+    
+    
+    Attributes:
+        type:
+            Optional. Compensation type.  Default is [CompensationType.COM
+            PENSATION\_TYPE\_UNSPECIFIED][google.cloud.talent.v4beta1.Comp
+            ensationInfo.CompensationType.COMPENSATION\_TYPE\_UNSPECIFIED]
+            .
+        unit:
+            Optional. Frequency of the specified amount.  Default is [Comp
+            ensationUnit.COMPENSATION\_UNIT\_UNSPECIFIED][google.cloud.tal
+            ent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION\_UN
+            IT\_UNSPECIFIED].
+        compensation_amount:
+            Optional.  Compensation amount. It could be a fixed amount or
+            a floating range.
+        amount:
+            Optional. Compensation amount.
+        range:
+            Optional. Compensation range.
+        description:
+            Optional. Compensation description. For example, could
+            indicate equity terms or provide additional context to an
+            estimated bonus.
+        expected_units_per_year:
+            Optional. Expected number of units paid each year. If not
+            specified, when [Job.employment\_types][google.cloud.talent.v4
+            beta1.Job.employment\_types] is FULLTIME, a default value is
+            inferred based on [unit][google.cloud.talent.v4beta1.Compensat
+            ionInfo.CompensationEntry.unit]. Default values: - HOURLY:
+            2080 - DAILY: 260 - WEEKLY: 52 - MONTHLY: 12 - ANNUAL: 1
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry)
+            ),
+        ),
+        CompensationRange=_reflection.GeneratedProtocolMessageType(
+            "CompensationRange",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMPENSATIONINFO_COMPENSATIONRANGE,
+                __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+                __doc__="""Compensation range.
+    
+    
+    Attributes:
+        max_compensation:
+            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.
+        min_compensation:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompensationInfo.CompensationRange)
+            ),
+        ),
+        DESCRIPTOR=_COMPENSATIONINFO,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Job compensation details.
+  
+  
+  Attributes:
+      entries:
+          Optional. Job compensation information.  At most one entry can
+          be of type [CompensationInfo.CompensationType.BASE][google.clo
+          ud.talent.v4beta1.CompensationInfo.CompensationType.BASE],
+          which is referred as **base compensation entry** for the job.
+      annualized_base_compensation_range:
+          Output only. Annualized base compensation range. Computed as
+          base compensation entry's [CompensationEntry.amount][google.cl
+          oud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
+          times [CompensationEntry.expected\_units\_per\_year][google.cl
+          oud.talent.v4beta1.CompensationInfo.CompensationEntry.expected
+          \_units\_per\_year].  See [CompensationEntry][google.cloud.tal
+          ent.v4beta1.CompensationInfo.CompensationEntry] for
+          explanation on compensation annualization.
+      annualized_total_compensation_range:
+          Output only. Annualized total compensation range. Computed as
+          all compensation entries' [CompensationEntry.amount][google.cl
+          oud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
+          times [CompensationEntry.expected\_units\_per\_year][google.cl
+          oud.talent.v4beta1.CompensationInfo.CompensationEntry.expected
+          \_units\_per\_year].  See [CompensationEntry][google.cloud.tal
+          ent.v4beta1.CompensationInfo.CompensationEntry] for
+          explanation on compensation annualization.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompensationInfo)
+    ),
+)
+_sym_db.RegisterMessage(CompensationInfo)
+_sym_db.RegisterMessage(CompensationInfo.CompensationEntry)
+_sym_db.RegisterMessage(CompensationInfo.CompensationRange)
+
+Certification = _reflection.GeneratedProtocolMessageType(
+    "Certification",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CERTIFICATION,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Resource that represents a license or certification.
+  
+  
+  Attributes:
+      display_name:
+          Optional. Name of license or certification.  Number of
+          characters allowed is 100.
+      acquire_date:
+          Optional. Acquisition date or effective date of license or
+          certification.
+      expire_date:
+          Optional. Expiration date of license of certification.
+      authority:
+          Optional. Authority of license, such as government.  Number of
+          characters allowed is 100.
+      description:
+          Optional. Description of license or certification.  Number of
+          characters allowed is 100,000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Certification)
+    ),
+)
+_sym_db.RegisterMessage(Certification)
+
+Skill = _reflection.GeneratedProtocolMessageType(
+    "Skill",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SKILL,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Resource that represents a skill of a candidate.
+  
+  
+  Attributes:
+      display_name:
+          Optional. Skill display name.  For example, "Java", "Python".
+          Number of characters allowed is 100.
+      last_used_date:
+          Optional. The last time this skill was used.
+      level:
+          Optional. Skill proficiency level which indicates how
+          proficient the candidate is at this skill.
+      context:
+          Optional. A paragraph describes context of this skill.  Number
+          of characters allowed is 100,000.
+      skill_name_snippet:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Skill)
+    ),
+)
+_sym_db.RegisterMessage(Skill)
+
+Interview = _reflection.GeneratedProtocolMessageType(
+    "Interview",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INTERVIEW,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""Details of an interview.
+  
+  
+  Attributes:
+      rating:
+          Optional. The rating on this interview.
+      outcome:
+          Required. The overall decision resulting from this interview
+          (positive, negative, nuetral).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Interview)
+    ),
+)
+_sym_db.RegisterMessage(Interview)
+
+Rating = _reflection.GeneratedProtocolMessageType(
+    "Rating",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RATING,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""The details of the score received for an assessment or interview.
+  
+  
+  Attributes:
+      overall:
+          Overall score.
+      min:
+          The minimum value for the score.
+      max:
+          The maximum value for the score.
+      interval:
+          The steps within the score (for example, interval = 1 max = 5
+          min = 1 indicates that the score can be 1, 2, 3, 4, or 5)
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Rating)
+    ),
+)
+_sym_db.RegisterMessage(Rating)
+
+BatchOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "BatchOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHOPERATIONMETADATA,
+        __module__="google.cloud.talent_v4beta1.proto.common_pb2",
+        __doc__="""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].
+  
+  
+  Attributes:
+      state:
+          The state of a long running operation.
+      state_description:
+          More detailed information about operation state.
+      success_count:
+          Count of successful item(s) inside an operation.
+      failure_count:
+          Count of failed item(s) inside an operation.
+      total_count:
+          Count of total item(s) inside an operation.
+      create_time:
+          The time when the batch operation is created.
+      update_time:
+          The time when the batch operation status is updated. The
+          metadata and the [update\_time][google.cloud.talent.v4beta1.Ba
+          tchOperationMetadata.update\_time] is refreshed every minute
+          otherwise cached data is returned.
+      end_time:
+          The time when the batch operation is finished and [google.long
+          running.Operation.done][google.longrunning.Operation.done] is
+          set to ``true``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.BatchOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(BatchOperationMetadata)
+
+
+DESCRIPTOR._options = None
+_VISIBILITY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/common_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/common_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/common_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/company.proto b/talent/google/cloud/talent_v4beta1/proto/company.proto
new file mode 100644
index 000000000000..16053709db0d
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/company.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.cloud.talent.v4beta1;
+
+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;
+option java_outer_classname = "CompanyResourceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A Company resource represents a company in the service. A company is the
+// entity that owns job postings, that is, the hiring entity responsible for
+// employing applicants for the job position.
+message 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.
+    Location headquarters_location = 1;
+  }
+
+  // Required during company update.
+  //
+  // The resource name for a company. This is generated by the service when a
+  // company is created.
+  //
+  // 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 name = 1;
+
+  // Required. The display name of the company, for example, "Google LLC".
+  string display_name = 2;
+
+  // Required. Client side company identifier, used to uniquely identify the
+  // company.
+  //
+  // The maximum number of allowed characters is 255.
+  string external_id = 3;
+
+  // Optional. 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].
+  string headquarters_address = 5;
+
+  // Optional. 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
+  // 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,
+  // 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".
+  string career_site_uri = 9;
+
+  // Optional. 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
+  // `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 those keyword queries must be surrounded by quotes.
+  repeated string keyword_searchable_job_custom_attributes = 11;
+
+  // Output only. Derived details about the company.
+  DerivedInfo derived_info = 12;
+
+  // 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;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/company_pb2.py b/talent/google/cloud/talent_v4beta1/proto/company_pb2.py
new file mode 100644
index 000000000000..1095015570b1
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/company_pb2.py
@@ -0,0 +1,444 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/company.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/company.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\024CompanyResourceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/talent_v4beta1/proto/company.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto"\xe4\x03\n\x07\x43ompany\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x03 \x01(\t\x12\x36\n\x04size\x18\x04 \x01(\x0e\x32(.google.cloud.talent.v4beta1.CompanySize\x12\x1c\n\x14headquarters_address\x18\x05 \x01(\t\x12\x15\n\rhiring_agency\x18\x06 \x01(\x08\x12\x10\n\x08\x65\x65o_text\x18\x07 \x01(\t\x12\x13\n\x0bwebsite_uri\x18\x08 \x01(\t\x12\x17\n\x0f\x63\x61reer_site_uri\x18\t \x01(\t\x12\x11\n\timage_uri\x18\n \x01(\t\x12\x30\n(keyword_searchable_job_custom_attributes\x18\x0b \x03(\t\x12\x46\n\x0c\x64\x65rived_info\x18\x0c \x01(\x0b\x32\x30.google.cloud.talent.v4beta1.Company.DerivedInfo\x12\x11\n\tsuspended\x18\r \x01(\x08\x1aS\n\x0b\x44\x65rivedInfo\x12\x44\n\x15headquarters_location\x18\x01 \x01(\x0b\x32%.google.cloud.talent.v4beta1.LocationB\x82\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x14\x43ompanyResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_COMPANY_DERIVEDINFO = _descriptor.Descriptor(
+    name="DerivedInfo",
+    full_name="google.cloud.talent.v4beta1.Company.DerivedInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="headquarters_location",
+            full_name="google.cloud.talent.v4beta1.Company.DerivedInfo.headquarters_location",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=560,
+    serialized_end=643,
+)
+
+_COMPANY = _descriptor.Descriptor(
+    name="Company",
+    full_name="google.cloud.talent.v4beta1.Company",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.Company.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.talent.v4beta1.Company.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="external_id",
+            full_name="google.cloud.talent.v4beta1.Company.external_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="size",
+            full_name="google.cloud.talent.v4beta1.Company.size",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headquarters_address",
+            full_name="google.cloud.talent.v4beta1.Company.headquarters_address",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hiring_agency",
+            full_name="google.cloud.talent.v4beta1.Company.hiring_agency",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="eeo_text",
+            full_name="google.cloud.talent.v4beta1.Company.eeo_text",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="website_uri",
+            full_name="google.cloud.talent.v4beta1.Company.website_uri",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="career_site_uri",
+            full_name="google.cloud.talent.v4beta1.Company.career_site_uri",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.talent.v4beta1.Company.image_uri",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keyword_searchable_job_custom_attributes",
+            full_name="google.cloud.talent.v4beta1.Company.keyword_searchable_job_custom_attributes",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="derived_info",
+            full_name="google.cloud.talent.v4beta1.Company.derived_info",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="suspended",
+            full_name="google.cloud.talent.v4beta1.Company.suspended",
+            index=12,
+            number=13,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_COMPANY_DERIVEDINFO],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=159,
+    serialized_end=643,
+)
+
+_COMPANY_DERIVEDINFO.fields_by_name[
+    "headquarters_location"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._LOCATION
+)
+_COMPANY_DERIVEDINFO.containing_type = _COMPANY
+_COMPANY.fields_by_name[
+    "size"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._COMPANYSIZE
+)
+_COMPANY.fields_by_name["derived_info"].message_type = _COMPANY_DERIVEDINFO
+DESCRIPTOR.message_types_by_name["Company"] = _COMPANY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Company = _reflection.GeneratedProtocolMessageType(
+    "Company",
+    (_message.Message,),
+    dict(
+        DerivedInfo=_reflection.GeneratedProtocolMessageType(
+            "DerivedInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMPANY_DERIVEDINFO,
+                __module__="google.cloud.talent_v4beta1.proto.company_pb2",
+                __doc__="""Derived details about the company.
+    
+    
+    Attributes:
+        headquarters_location:
+            A structured headquarters location of the company, resolved
+            from [Company.headquarters\_address][google.cloud.talent.v4bet
+            a1.Company.headquarters\_address] if provided.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Company.DerivedInfo)
+            ),
+        ),
+        DESCRIPTOR=_COMPANY,
+        __module__="google.cloud.talent_v4beta1.proto.company_pb2",
+        __doc__="""A Company resource represents a company in the service. A company is the
+  entity that owns job postings, that is, the hiring entity responsible
+  for employing applicants for the job position.
+  
+  
+  Attributes:
+      name:
+          Required during company update.  The resource name for a
+          company. This is generated by the service when a company is
+          created.  The format is "projects/{project\_id}/tenants/{tenan
+          t\_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".
+      display_name:
+          Required. The display name of the company, for example,
+          "Google LLC".
+      external_id:
+          Required. Client side company identifier, used to uniquely
+          identify the company.  The maximum number of allowed
+          characters is 255.
+      size:
+          Optional. The employer's company size.
+      headquarters_address:
+          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 [Deriv
+          edInfo.headquarters\_location][google.cloud.talent.v4beta1.Com
+          pany.DerivedInfo.headquarters\_location].
+      hiring_agency:
+          Optional. Set to true if it is the hiring agency that post
+          jobs for other employers.  Defaults to false if not provided.
+      eeo_text:
+          Optional. 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.
+      website_uri:
+          Optional. 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.
+      career_site_uri:
+          Optional. The URI to employer's career site or careers page on
+          the employer's web site, for example,
+          "https://careers.google.com".
+      image_uri:
+          Optional. A URI that hosts the employer's company logo.
+      keyword_searchable_job_custom_attributes:
+          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 ``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 those keyword queries
+          must be surrounded by quotes.
+      derived_info:
+          Output only. Derived details about the company.
+      suspended:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Company)
+    ),
+)
+_sym_db.RegisterMessage(Company)
+_sym_db.RegisterMessage(Company.DerivedInfo)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/company_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/company_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/company_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/company_service.proto b/talent/google/cloud/talent_v4beta1/proto/company_service.proto
new file mode 100644
index 000000000000..1e48a46cd5b3
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/company_service.proto
@@ -0,0 +1,193 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/cloud/talent/v4beta1/company.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "CompanyServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service that handles company management, including CRUD and enumeration.
+service CompanyService {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Creates a new company entity.
+  rpc CreateCompany(CreateCompanyRequest) returns (Company) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/companies"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/companies"
+        body: "*"
+      }
+    };
+  }
+
+  // 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/*}" }
+    };
+  }
+
+  // Updates specified company.
+  rpc UpdateCompany(UpdateCompanyRequest) returns (Company) {
+    option (google.api.http) = {
+      patch: "/v4beta1/{company.name=projects/*/tenants/*/companies/*}"
+      body: "*"
+      additional_bindings {
+        patch: "/v4beta1/{company.name=projects/*/companies/*}"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes specified company.
+  // Prerequisite: The company has no jobs associated with it.
+  rpc DeleteCompany(DeleteCompanyRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v4beta1/{name=projects/*/tenants/*/companies/*}"
+      additional_bindings { delete: "/v4beta1/{name=projects/*/companies/*}" }
+    };
+  }
+
+  // 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" }
+    };
+  }
+}
+
+// The Request of the CreateCompany method.
+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;
+
+  // Required. The company to be created.
+  Company company = 2;
+}
+
+// Request for getting a company by name.
+message GetCompanyRequest {
+  // Required. The resource name of the company to be retrieved.
+  //
+  // 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 name = 1;
+}
+
+// Request for updating a specified company.
+message UpdateCompanyRequest {
+  // Required. The company resource to replace the current resource in the
+  // system.
+  Company company = 1;
+
+  // Optional but 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.
+  //
+  // A field mask to specify the company fields to be updated. Only
+  // top level fields of [Company][google.cloud.talent.v4beta1.Company] are
+  // supported.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request to delete a company.
+message DeleteCompanyRequest {
+  // Required. The resource name of the company to be deleted.
+  //
+  // 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 name = 1;
+}
+
+// List companies for which the client has ACL visibility.
+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".
+  //
+  // 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.
+  string page_token = 2;
+
+  // Optional. 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.
+  //
+  // 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.
+  bool require_open_jobs = 4;
+}
+
+// Output only.
+//
+// The List companies response object.
+message ListCompaniesResponse {
+  // Companies for the current client.
+  repeated Company companies = 1;
+
+  // A token to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 3;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/company_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/company_service_pb2.py
new file mode 100644
index 000000000000..a1247cbbe1ef
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/company_service_pb2.py
@@ -0,0 +1,674 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/company_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    company_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/company_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\023CompanyServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/talent_v4beta1/proto/company_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a/google/cloud/talent_v4beta1/proto/company.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"]\n\x14\x43reateCompanyRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x35\n\x07\x63ompany\x18\x02 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Company"!\n\x11GetCompanyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"~\n\x14UpdateCompanyRequest\x12\x35\n\x07\x63ompany\x18\x01 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Company\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteCompanyRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"h\n\x14ListCompaniesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x19\n\x11require_open_jobs\x18\x04 \x01(\x08"\xaa\x01\n\x15ListCompaniesResponse\x12\x37\n\tcompanies\x18\x01 \x03(\x0b\x32$.google.cloud.talent.v4beta1.Company\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12?\n\x08metadata\x18\x03 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata2\x9f\t\n\x0e\x43ompanyService\x12\xd2\x01\n\rCreateCompany\x12\x31.google.cloud.talent.v4beta1.CreateCompanyRequest\x1a$.google.cloud.talent.v4beta1.Company"h\x82\xd3\xe4\x93\x02\x62"0/v4beta1/{parent=projects/*/tenants/*}/companies:\x01*Z+"&/v4beta1/{parent=projects/*}/companies:\x01*\x12\xc6\x01\n\nGetCompany\x12..google.cloud.talent.v4beta1.GetCompanyRequest\x1a$.google.cloud.talent.v4beta1.Company"b\x82\xd3\xe4\x93\x02\\\x12\x30/v4beta1/{name=projects/*/tenants/*/companies/*}Z(\x12&/v4beta1/{name=projects/*/companies/*}\x12\xe2\x01\n\rUpdateCompany\x12\x31.google.cloud.talent.v4beta1.UpdateCompanyRequest\x1a$.google.cloud.talent.v4beta1.Company"x\x82\xd3\xe4\x93\x02r28/v4beta1/{company.name=projects/*/tenants/*/companies/*}:\x01*Z32./v4beta1/{company.name=projects/*/companies/*}:\x01*\x12\xbe\x01\n\rDeleteCompany\x12\x31.google.cloud.talent.v4beta1.DeleteCompanyRequest\x1a\x16.google.protobuf.Empty"b\x82\xd3\xe4\x93\x02\\*0/v4beta1/{name=projects/*/tenants/*/companies/*}Z(*&/v4beta1/{name=projects/*/companies/*}\x12\xda\x01\n\rListCompanies\x12\x31.google.cloud.talent.v4beta1.ListCompaniesRequest\x1a\x32.google.cloud.talent.v4beta1.ListCompaniesResponse"b\x82\xd3\xe4\x93\x02\\\x12\x30/v4beta1/{parent=projects/*/tenants/*}/companiesZ(\x12&/v4beta1/{parent=projects/*}/companies\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB\x81\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x13\x43ompanyServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATECOMPANYREQUEST = _descriptor.Descriptor(
+    name="CreateCompanyRequest",
+    full_name="google.cloud.talent.v4beta1.CreateCompanyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CreateCompanyRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="company",
+            full_name="google.cloud.talent.v4beta1.CreateCompanyRequest.company",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=303,
+    serialized_end=396,
+)
+
+
+_GETCOMPANYREQUEST = _descriptor.Descriptor(
+    name="GetCompanyRequest",
+    full_name="google.cloud.talent.v4beta1.GetCompanyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.GetCompanyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=398,
+    serialized_end=431,
+)
+
+
+_UPDATECOMPANYREQUEST = _descriptor.Descriptor(
+    name="UpdateCompanyRequest",
+    full_name="google.cloud.talent.v4beta1.UpdateCompanyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="company",
+            full_name="google.cloud.talent.v4beta1.UpdateCompanyRequest.company",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.talent.v4beta1.UpdateCompanyRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=433,
+    serialized_end=559,
+)
+
+
+_DELETECOMPANYREQUEST = _descriptor.Descriptor(
+    name="DeleteCompanyRequest",
+    full_name="google.cloud.talent.v4beta1.DeleteCompanyRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.DeleteCompanyRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=561,
+    serialized_end=597,
+)
+
+
+_LISTCOMPANIESREQUEST = _descriptor.Descriptor(
+    name="ListCompaniesRequest",
+    full_name="google.cloud.talent.v4beta1.ListCompaniesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="require_open_jobs",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesRequest.require_open_jobs",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=599,
+    serialized_end=703,
+)
+
+
+_LISTCOMPANIESRESPONSE = _descriptor.Descriptor(
+    name="ListCompaniesResponse",
+    full_name="google.cloud.talent.v4beta1.ListCompaniesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="companies",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesResponse.companies",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.ListCompaniesResponse.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=706,
+    serialized_end=876,
+)
+
+_CREATECOMPANYREQUEST.fields_by_name[
+    "company"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2._COMPANY
+)
+_UPDATECOMPANYREQUEST.fields_by_name[
+    "company"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2._COMPANY
+)
+_UPDATECOMPANYREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTCOMPANIESRESPONSE.fields_by_name[
+    "companies"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2._COMPANY
+)
+_LISTCOMPANIESRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+DESCRIPTOR.message_types_by_name["CreateCompanyRequest"] = _CREATECOMPANYREQUEST
+DESCRIPTOR.message_types_by_name["GetCompanyRequest"] = _GETCOMPANYREQUEST
+DESCRIPTOR.message_types_by_name["UpdateCompanyRequest"] = _UPDATECOMPANYREQUEST
+DESCRIPTOR.message_types_by_name["DeleteCompanyRequest"] = _DELETECOMPANYREQUEST
+DESCRIPTOR.message_types_by_name["ListCompaniesRequest"] = _LISTCOMPANIESREQUEST
+DESCRIPTOR.message_types_by_name["ListCompaniesResponse"] = _LISTCOMPANIESRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateCompanyRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateCompanyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECOMPANYREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.company_service_pb2",
+        __doc__="""The Request of the CreateCompany method.
+  
+  
+  Attributes:
+      parent:
+          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".
+      company:
+          Required. The company to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CreateCompanyRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateCompanyRequest)
+
+GetCompanyRequest = _reflection.GeneratedProtocolMessageType(
+    "GetCompanyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETCOMPANYREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.company_service_pb2",
+        __doc__="""Request for getting a company by name.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the company to be retrieved.
+          The format is "projects/{project\_id}/tenants/{tenant\_id}/com
+          panies/{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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.GetCompanyRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetCompanyRequest)
+
+UpdateCompanyRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateCompanyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATECOMPANYREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.company_service_pb2",
+        __doc__="""Request for updating a specified company.
+  
+  
+  Attributes:
+      company:
+          Required. The company resource to replace the current resource
+          in the system.
+      update_mask:
+          Optional but strongly recommended for the best service
+          experience.  If [update\_mask][google.cloud.talent.v4beta1.Upd
+          ateCompanyRequest.update\_mask] is provided, only the
+          specified fields in [company][google.cloud.talent.v4beta1.Upda
+          teCompanyRequest.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.UpdateCompanyRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateCompanyRequest)
+
+DeleteCompanyRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteCompanyRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETECOMPANYREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.company_service_pb2",
+        __doc__="""Request to delete a company.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the company to be deleted.  The
+          format is "projects/{project\_id}/tenants/{tenant\_id}/compani
+          es/{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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.DeleteCompanyRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteCompanyRequest)
+
+ListCompaniesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCompaniesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOMPANIESREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.company_service_pb2",
+        __doc__="""List companies for which the client has ACL visibility.
+  
+  
+  Attributes:
+      parent:
+          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 the default tenant is used if unspecified, for example,
+          "projects/api-test-project".
+      page_token:
+          Optional. The starting indicator from which to return results.
+      page_size:
+          Optional. The maximum number of companies to be returned, at
+          most 100. Default is 100 if a non-positive number is provided.
+      require_open_jobs:
+          Optional. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListCompaniesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCompaniesRequest)
+
+ListCompaniesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCompaniesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCOMPANIESRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.company_service_pb2",
+        __doc__="""Output only.
+  
+  The List companies response object.
+  
+  
+  Attributes:
+      companies:
+          Companies for the current client.
+      next_page_token:
+          A token to retrieve the next page of results.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListCompaniesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCompaniesResponse)
+
+
+DESCRIPTOR._options = None
+
+_COMPANYSERVICE = _descriptor.ServiceDescriptor(
+    name="CompanyService",
+    full_name="google.cloud.talent.v4beta1.CompanyService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=879,
+    serialized_end=2062,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateCompany",
+            full_name="google.cloud.talent.v4beta1.CompanyService.CreateCompany",
+            index=0,
+            containing_service=None,
+            input_type=_CREATECOMPANYREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2._COMPANY,
+            serialized_options=_b(
+                '\202\323\344\223\002b"0/v4beta1/{parent=projects/*/tenants/*}/companies:\001*Z+"&/v4beta1/{parent=projects/*}/companies:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetCompany",
+            full_name="google.cloud.talent.v4beta1.CompanyService.GetCompany",
+            index=1,
+            containing_service=None,
+            input_type=_GETCOMPANYREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2._COMPANY,
+            serialized_options=_b(
+                "\202\323\344\223\002\\\0220/v4beta1/{name=projects/*/tenants/*/companies/*}Z(\022&/v4beta1/{name=projects/*/companies/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateCompany",
+            full_name="google.cloud.talent.v4beta1.CompanyService.UpdateCompany",
+            index=2,
+            containing_service=None,
+            input_type=_UPDATECOMPANYREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2._COMPANY,
+            serialized_options=_b(
+                "\202\323\344\223\002r28/v4beta1/{company.name=projects/*/tenants/*/companies/*}:\001*Z32./v4beta1/{company.name=projects/*/companies/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteCompany",
+            full_name="google.cloud.talent.v4beta1.CompanyService.DeleteCompany",
+            index=3,
+            containing_service=None,
+            input_type=_DELETECOMPANYREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002\\*0/v4beta1/{name=projects/*/tenants/*/companies/*}Z(*&/v4beta1/{name=projects/*/companies/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCompanies",
+            full_name="google.cloud.talent.v4beta1.CompanyService.ListCompanies",
+            index=4,
+            containing_service=None,
+            input_type=_LISTCOMPANIESREQUEST,
+            output_type=_LISTCOMPANIESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\\\0220/v4beta1/{parent=projects/*/tenants/*}/companiesZ(\022&/v4beta1/{parent=projects/*}/companies"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_COMPANYSERVICE)
+
+DESCRIPTOR.services_by_name["CompanyService"] = _COMPANYSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/company_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/company_service_pb2_grpc.py
new file mode 100644
index 000000000000..eac13229ba00
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/company_service_pb2_grpc.py
@@ -0,0 +1,122 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    company_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    company_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class CompanyServiceStub(object):
+    """A service that handles company management, including CRUD and enumeration.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateCompany = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.CompanyService/CreateCompany",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.CreateCompanyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.Company.FromString,
+        )
+        self.GetCompany = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.CompanyService/GetCompany",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.GetCompanyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.Company.FromString,
+        )
+        self.UpdateCompany = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.CompanyService/UpdateCompany",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.UpdateCompanyRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.Company.FromString,
+        )
+        self.DeleteCompany = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.CompanyService/DeleteCompany",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.DeleteCompanyRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListCompanies = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.CompanyService/ListCompanies",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.ListCompaniesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.ListCompaniesResponse.FromString,
+        )
+
+
+class CompanyServiceServicer(object):
+    """A service that handles company management, including CRUD and enumeration.
+  """
+
+    def CreateCompany(self, request, context):
+        """Creates a new company entity.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetCompany(self, request, context):
+        """Retrieves specified company.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateCompany(self, request, context):
+        """Updates specified company.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteCompany(self, request, context):
+        """Deletes specified company.
+    Prerequisite: The company has no jobs associated with it.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCompanies(self, request, context):
+        """Lists all companies associated with the project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CompanyServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateCompany": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateCompany,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.CreateCompanyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.Company.SerializeToString,
+        ),
+        "GetCompany": grpc.unary_unary_rpc_method_handler(
+            servicer.GetCompany,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.GetCompanyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.Company.SerializeToString,
+        ),
+        "UpdateCompany": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateCompany,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.UpdateCompanyRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__pb2.Company.SerializeToString,
+        ),
+        "DeleteCompany": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteCompany,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.DeleteCompanyRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListCompanies": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCompanies,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.ListCompaniesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_company__service__pb2.ListCompaniesResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.CompanyService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/proto/completion_service.proto b/talent/google/cloud/talent_v4beta1/proto/completion_service.proto
new file mode 100644
index 000000000000..2b105c24beaf
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/completion_service.proto
@@ -0,0 +1,170 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.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;
+option java_outer_classname = "CompletionServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service handles auto completion.
+service Completion {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Completes the specified prefix with keyword suggestions.
+  // Intended for use by a job search auto-complete search box.
+  rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse) {
+    option (google.api.http) = {
+      get: "/v4beta1/{parent=projects/*/tenants/*}:complete"
+      additional_bindings { get: "/v4beta1/{parent=projects/*}:complete" }
+    };
+  }
+}
+
+// Input only.
+//
+// Auto-complete parameters.
+message CompleteQueryRequest {
+  // Enum to specify the scope of completion.
+  enum CompletionScope {
+    // Default value.
+    COMPLETION_SCOPE_UNSPECIFIED = 0;
+
+    // Suggestions are based only on the data provided by the client.
+    TENANT = 1;
+
+    // Suggestions are based on all jobs data in the system that's visible to
+    // the client
+    PUBLIC = 2;
+  }
+
+  // Enum to specify auto-completion topics.
+  enum CompletionType {
+    // Default value.
+    COMPLETION_TYPE_UNSPECIFIED = 0;
+
+    // Only suggest job titles.
+    JOB_TITLE = 1;
+
+    // Only suggest company names.
+    COMPANY_NAME = 2;
+
+    // Suggest both job titles and company names.
+    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".
+  //
+  // Tenant id is optional and the default tenant is used if unspecified, for
+  // example, "projects/api-test-project".
+  string parent = 1;
+
+  // Required. The query used to generate suggestions.
+  //
+  // The maximum number of allowed characters is 255.
+  string query = 2;
+
+  // Optional. 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;
+
+  // Optional. 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".
+  //
+  // Tenant id is optional and the default tenant is used if unspecified, for
+  // example, "projects/api-test-project/companies/bar".
+  string company = 5;
+
+  // Optional. 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].
+  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.
+    string suggestion = 1;
+
+    // The completion topic.
+    CompleteQueryRequest.CompletionType type = 2;
+
+    // The URI of the company image for
+    // [COMPANY_NAME][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMPANY_NAME].
+    string image_uri = 3;
+  }
+
+  // Results of the matching job/company candidates.
+  repeated CompletionResult completion_results = 1;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 2;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/completion_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/completion_service_pb2.py
new file mode 100644
index 000000000000..c62fde7c4329
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/completion_service_pb2.py
@@ -0,0 +1,550 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/completion_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/completion_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\026CompletionServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/talent_v4beta1/proto/completion_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto"\xc2\x03\n\x14\x43ompleteQueryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\r\n\x05query\x18\x02 \x01(\t\x12\x16\n\x0elanguage_codes\x18\x03 \x03(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x0f\n\x07\x63ompany\x18\x05 \x01(\t\x12P\n\x05scope\x18\x06 \x01(\x0e\x32\x41.google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionScope\x12N\n\x04type\x18\x07 \x01(\x0e\x32@.google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType"K\n\x0f\x43ompletionScope\x12 \n\x1c\x43OMPLETION_SCOPE_UNSPECIFIED\x10\x00\x12\n\n\x06TENANT\x10\x01\x12\n\n\x06PUBLIC\x10\x02"`\n\x0e\x43ompletionType\x12\x1f\n\x1b\x43OMPLETION_TYPE_UNSPECIFIED\x10\x00\x12\r\n\tJOB_TITLE\x10\x01\x12\x10\n\x0c\x43OMPANY_NAME\x10\x02\x12\x0c\n\x08\x43OMBINED\x10\x03"\xc5\x02\n\x15\x43ompleteQueryResponse\x12_\n\x12\x63ompletion_results\x18\x01 \x03(\x0b\x32\x43.google.cloud.talent.v4beta1.CompleteQueryResponse.CompletionResult\x12?\n\x08metadata\x18\x02 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata\x1a\x89\x01\n\x10\x43ompletionResult\x12\x12\n\nsuggestion\x18\x01 \x01(\t\x12N\n\x04type\x18\x02 \x01(\x0e\x32@.google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType\x12\x11\n\timage_uri\x18\x03 \x01(\t2\xd5\x02\n\nCompletion\x12\xd8\x01\n\rCompleteQuery\x12\x31.google.cloud.talent.v4beta1.CompleteQueryRequest\x1a\x32.google.cloud.talent.v4beta1.CompleteQueryResponse"`\x82\xd3\xe4\x93\x02Z\x12//v4beta1/{parent=projects/*/tenants/*}:completeZ\'\x12%/v4beta1/{parent=projects/*}:complete\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB\x84\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x16\x43ompletionServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_COMPLETEQUERYREQUEST_COMPLETIONSCOPE = _descriptor.EnumDescriptor(
+    name="CompletionScope",
+    full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionScope",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETION_SCOPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TENANT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUBLIC", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=472,
+    serialized_end=547,
+)
+_sym_db.RegisterEnumDescriptor(_COMPLETEQUERYREQUEST_COMPLETIONSCOPE)
+
+_COMPLETEQUERYREQUEST_COMPLETIONTYPE = _descriptor.EnumDescriptor(
+    name="CompletionType",
+    full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JOB_TITLE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPANY_NAME", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMBINED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=549,
+    serialized_end=645,
+)
+_sym_db.RegisterEnumDescriptor(_COMPLETEQUERYREQUEST_COMPLETIONTYPE)
+
+
+_COMPLETEQUERYREQUEST = _descriptor.Descriptor(
+    name="CompleteQueryRequest",
+    full_name="google.cloud.talent.v4beta1.CompleteQueryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.query",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_codes",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="company",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.company",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.scope",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryRequest.type",
+            index=6,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[
+        _COMPLETEQUERYREQUEST_COMPLETIONSCOPE,
+        _COMPLETEQUERYREQUEST_COMPLETIONTYPE,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=195,
+    serialized_end=645,
+)
+
+
+_COMPLETEQUERYRESPONSE_COMPLETIONRESULT = _descriptor.Descriptor(
+    name="CompletionResult",
+    full_name="google.cloud.talent.v4beta1.CompleteQueryResponse.CompletionResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="suggestion",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryResponse.CompletionResult.suggestion",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryResponse.CompletionResult.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryResponse.CompletionResult.image_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=836,
+    serialized_end=973,
+)
+
+_COMPLETEQUERYRESPONSE = _descriptor.Descriptor(
+    name="CompleteQueryResponse",
+    full_name="google.cloud.talent.v4beta1.CompleteQueryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="completion_results",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryResponse.completion_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.CompleteQueryResponse.metadata",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_COMPLETEQUERYRESPONSE_COMPLETIONRESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=648,
+    serialized_end=973,
+)
+
+_COMPLETEQUERYREQUEST.fields_by_name[
+    "scope"
+].enum_type = _COMPLETEQUERYREQUEST_COMPLETIONSCOPE
+_COMPLETEQUERYREQUEST.fields_by_name[
+    "type"
+].enum_type = _COMPLETEQUERYREQUEST_COMPLETIONTYPE
+_COMPLETEQUERYREQUEST_COMPLETIONSCOPE.containing_type = _COMPLETEQUERYREQUEST
+_COMPLETEQUERYREQUEST_COMPLETIONTYPE.containing_type = _COMPLETEQUERYREQUEST
+_COMPLETEQUERYRESPONSE_COMPLETIONRESULT.fields_by_name[
+    "type"
+].enum_type = _COMPLETEQUERYREQUEST_COMPLETIONTYPE
+_COMPLETEQUERYRESPONSE_COMPLETIONRESULT.containing_type = _COMPLETEQUERYRESPONSE
+_COMPLETEQUERYRESPONSE.fields_by_name[
+    "completion_results"
+].message_type = _COMPLETEQUERYRESPONSE_COMPLETIONRESULT
+_COMPLETEQUERYRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+DESCRIPTOR.message_types_by_name["CompleteQueryRequest"] = _COMPLETEQUERYREQUEST
+DESCRIPTOR.message_types_by_name["CompleteQueryResponse"] = _COMPLETEQUERYRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CompleteQueryRequest = _reflection.GeneratedProtocolMessageType(
+    "CompleteQueryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMPLETEQUERYREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.completion_service_pb2",
+        __doc__="""Input only.
+  
+  Auto-complete parameters.
+  
+  
+  Attributes:
+      parent:
+          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".  Tenant id is optional
+          and the default tenant is used if unspecified, for example,
+          "projects/api-test-project".
+      query:
+          Required. The query used to generate suggestions.  The maximum
+          number of allowed characters is 255.
+      language_codes:
+          Optional. 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.J
+          OB\_TITLE][google.cloud.talent.v4beta1.CompleteQueryRequest.Co
+          mpletionType.JOB\_TITLE] type, only open jobs with the same [l
+          anguage\_codes][google.cloud.talent.v4beta1.CompleteQueryReque
+          st.language\_codes] are returned.  For [CompletionType.COMPANY
+          \_NAME][google.cloud.talent.v4beta1.CompleteQueryRequest.Compl
+          etionType.COMPANY\_NAME] type, only companies having open jobs
+          with the same [language\_codes][google.cloud.talent.v4beta1.Co
+          mpleteQueryRequest.language\_codes] are returned.  For [Comple
+          tionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRe
+          quest.CompletionType.COMBINED] type, only open jobs with the
+          same [language\_codes][google.cloud.talent.v4beta1.CompleteQue
+          ryRequest.language\_codes] or companies having open jobs with
+          the same [language\_codes][google.cloud.talent.v4beta1.Complet
+          eQueryRequest.language\_codes] are returned.  The maximum
+          number of allowed characters is 255.
+      page_size:
+          Required. Completion result count.  The maximum allowed page
+          size is 10.
+      company:
+          Optional. If provided, restricts completion to specified
+          company.  The format is "projects/{project\_id}/tenants/{tenan
+          t\_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".
+      scope:
+          Optional. The scope of the completion. The defaults is [Comple
+          tionScope.PUBLIC][google.cloud.talent.v4beta1.CompleteQueryReq
+          uest.CompletionScope.PUBLIC].
+      type:
+          Optional. The completion topic. The default is [CompletionType
+          .COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.Co
+          mpletionType.COMBINED].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompleteQueryRequest)
+    ),
+)
+_sym_db.RegisterMessage(CompleteQueryRequest)
+
+CompleteQueryResponse = _reflection.GeneratedProtocolMessageType(
+    "CompleteQueryResponse",
+    (_message.Message,),
+    dict(
+        CompletionResult=_reflection.GeneratedProtocolMessageType(
+            "CompletionResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMPLETEQUERYRESPONSE_COMPLETIONRESULT,
+                __module__="google.cloud.talent_v4beta1.proto.completion_service_pb2",
+                __doc__="""Output only.
+    
+    Resource that represents completion results.
+    
+    
+    Attributes:
+        suggestion:
+            The suggestion for the query.
+        type:
+            The completion topic.
+        image_uri:
+            The URI of the company image for [COMPANY\_NAME][google.cloud.
+            talent.v4beta1.CompleteQueryRequest.CompletionType.COMPANY\_NA
+            ME].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompleteQueryResponse.CompletionResult)
+            ),
+        ),
+        DESCRIPTOR=_COMPLETEQUERYRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.completion_service_pb2",
+        __doc__="""Output only.
+  
+  Response of auto-complete query.
+  
+  
+  Attributes:
+      completion_results:
+          Results of the matching job/company candidates.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompleteQueryResponse)
+    ),
+)
+_sym_db.RegisterMessage(CompleteQueryResponse)
+_sym_db.RegisterMessage(CompleteQueryResponse.CompletionResult)
+
+
+DESCRIPTOR._options = None
+
+_COMPLETION = _descriptor.ServiceDescriptor(
+    name="Completion",
+    full_name="google.cloud.talent.v4beta1.Completion",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=976,
+    serialized_end=1317,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CompleteQuery",
+            full_name="google.cloud.talent.v4beta1.Completion.CompleteQuery",
+            index=0,
+            containing_service=None,
+            input_type=_COMPLETEQUERYREQUEST,
+            output_type=_COMPLETEQUERYRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002Z\022//v4beta1/{parent=projects/*/tenants/*}:completeZ'\022%/v4beta1/{parent=projects/*}:complete"
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_COMPLETION)
+
+DESCRIPTOR.services_by_name["Completion"] = _COMPLETION
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/completion_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/completion_service_pb2_grpc.py
new file mode 100644
index 000000000000..84cb66dbd4eb
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/completion_service_pb2_grpc.py
@@ -0,0 +1,50 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    completion_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_completion__service__pb2,
+)
+
+
+class CompletionStub(object):
+    """A service handles auto completion.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CompleteQuery = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.Completion/CompleteQuery",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_completion__service__pb2.CompleteQueryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_completion__service__pb2.CompleteQueryResponse.FromString,
+        )
+
+
+class CompletionServicer(object):
+    """A service handles auto completion.
+  """
+
+    def CompleteQuery(self, request, context):
+        """Completes the specified prefix with keyword suggestions.
+    Intended for use by a job search auto-complete search box.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CompletionServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CompleteQuery": grpc.unary_unary_rpc_method_handler(
+            servicer.CompleteQuery,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_completion__service__pb2.CompleteQueryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_completion__service__pb2.CompleteQueryResponse.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.Completion", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/proto/event.proto b/talent/google/cloud/talent_v4beta1/proto/event.proto
new file mode 100644
index 000000000000..d017a4ffa36e
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/event.proto
@@ -0,0 +1,249 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "EventProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// An event issued when an end user interacts with the application that
+// implements Cloud Talent Solution. Providing this information improves the
+// quality of results for the API clients, enabling the
+// 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.
+  //
+  // 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;
+
+  // Required. The timestamp of the event.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Required.
+  //
+  // The detail information of a specific event type.
+  oneof event {
+    // An event issued when a job seeker interacts with the application that
+    // implements Cloud Talent Solution.
+    JobEvent job_event = 5;
+
+    // An event issued when a profile searcher interacts with the application
+    // that implements Cloud Talent Solution.
+    ProfileEvent profile_event = 6;
+  }
+
+  // Optional. Notes about the event provided by recruiters or other users, for
+  // example, feedback on why a profile was bookmarked.
+  string event_notes = 9;
+}
+
+// An event issued when a job seeker interacts with the application that
+// implements Cloud Talent Solution.
+message JobEvent {
+  // An enumeration of an event attributed to the behavior of the end user,
+  // such as a job seeker.
+  enum JobEventType {
+    // The event is unspecified by other provided values.
+    JOB_EVENT_TYPE_UNSPECIFIED = 0;
+
+    // The job seeker or other entity interacting with the service has
+    // had a job rendered in their view, such as in a list of search results in
+    // a compressed or clipped format. This event is typically associated with
+    // the viewing of a jobs list on a single page by a job seeker.
+    IMPRESSION = 1;
+
+    // The job seeker, or other entity interacting with the service, has
+    // viewed the details of a job, including the full description. This
+    // event doesn't apply to the viewing a snippet of a job appearing as a
+    // part of the job search results. Viewing a snippet is associated with an
+    // [impression][google.cloud.talent.v4beta1.JobEvent.JobEventType.IMPRESSION]).
+    VIEW = 2;
+
+    // The job seeker or other entity interacting with the service
+    // performed an action to view a job and was redirected to a different
+    // website for job.
+    VIEW_REDIRECT = 3;
+
+    // The job seeker or other entity interacting with the service
+    // began the process or demonstrated the intention of applying for a job.
+    APPLICATION_START = 4;
+
+    // The job seeker or other entity interacting with the service
+    // submitted an application for a job.
+    APPLICATION_FINISH = 5;
+
+    // The job seeker or other entity interacting with the service
+    // 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]
+    // events.
+    APPLICATION_QUICK_SUBMISSION = 6;
+
+    // The job seeker or other entity interacting with the service
+    // performed an action to apply to a job and was redirected to a different
+    // website to complete the application.
+    APPLICATION_REDIRECT = 7;
+
+    // The job seeker or other entity interacting with the service began the
+    // process or demonstrated the intention of applying for a job from the
+    // search results page without viewing the details of the job posting.
+    // If sending this event, JobEventType.VIEW event shouldn't be sent.
+    APPLICATION_START_FROM_SEARCH = 8;
+
+    // The job seeker, or other entity interacting with the service, performs an
+    // action with a single click from the search results page to apply to a job
+    // (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.
+    APPLICATION_REDIRECT_FROM_SEARCH = 9;
+
+    // This event should be used when a company submits an application
+    // on behalf of a job seeker. This event is intended for use by staffing
+    // agencies attempting to place candidates.
+    APPLICATION_COMPANY_SUBMIT = 10;
+
+    // The job seeker or other entity interacting with the service demonstrated
+    // an interest in a job by bookmarking or saving it.
+    BOOKMARK = 11;
+
+    // The job seeker or other entity interacting with the service was
+    // sent a notification, such as an email alert or device notification,
+    // containing one or more jobs listings generated by the service.
+    NOTIFICATION = 12;
+
+    // The job seeker or other entity interacting with the service was
+    // employed by the hiring entity (employer). Send this event
+    // only if the job seeker was hired through an application that was
+    // initiated by a search conducted through the Cloud Talent Solution
+    // service.
+    HIRED = 13;
+
+    // A recruiter or staffing agency submitted an application on behalf of the
+    // candidate after interacting with the service to identify a suitable job
+    // posting.
+    SENT_CV = 14;
+
+    // The entity interacting with the service (for example, the job seeker),
+    // was granted an initial interview by the hiring entity (employer). This
+    // event should only be sent if the job seeker was granted an interview as
+    // part of an application that was initiated by a search conducted through /
+    // recommendation provided by the Cloud Talent Solution service.
+    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.
+  //
+  // 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;
+
+  // Optional. 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".
+  string profile = 3;
+}
+
+// An event issued when a profile searcher interacts with the application
+// that implements Cloud Talent Solution.
+message ProfileEvent {
+  // The enum represents types of client events for a candidate profile.
+  enum ProfileEventType {
+    // Default value.
+    PROFILE_EVENT_TYPE_UNSPECIFIED = 0;
+
+    // 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 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).
+    //
+    // 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.
+    VIEW = 2;
+
+    // The profile is bookmarked.
+    BOOKMARK = 3;
+  }
+
+  // Required. Type of event.
+  ProfileEventType type = 1;
+
+  // 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;
+
+  // 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 format is
+  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
+  // example, "projects/api-test-project/tenants/foo/jobs/1234".
+  repeated string jobs = 6;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/event_pb2.py b/talent/google/cloud/talent_v4beta1/proto/event_pb2.py
new file mode 100644
index 000000000000..d505d739c101
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/event_pb2.py
@@ -0,0 +1,595 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/event.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/event.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\nEventProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/talent_v4beta1/proto/event.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x82\x02\n\x0b\x43lientEvent\x12\x12\n\nrequest_id\x18\x01 \x01(\t\x12\x10\n\x08\x65vent_id\x18\x02 \x01(\t\x12/\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12:\n\tjob_event\x18\x05 \x01(\x0b\x32%.google.cloud.talent.v4beta1.JobEventH\x00\x12\x42\n\rprofile_event\x18\x06 \x01(\x0b\x32).google.cloud.talent.v4beta1.ProfileEventH\x00\x12\x13\n\x0b\x65vent_notes\x18\t \x01(\tB\x07\n\x05\x65vent"\xec\x03\n\x08JobEvent\x12@\n\x04type\x18\x01 \x01(\x0e\x32\x32.google.cloud.talent.v4beta1.JobEvent.JobEventType\x12\x0c\n\x04jobs\x18\x02 \x03(\t\x12\x0f\n\x07profile\x18\x03 \x01(\t"\xfe\x02\n\x0cJobEventType\x12\x1e\n\x1aJOB_EVENT_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nIMPRESSION\x10\x01\x12\x08\n\x04VIEW\x10\x02\x12\x11\n\rVIEW_REDIRECT\x10\x03\x12\x15\n\x11\x41PPLICATION_START\x10\x04\x12\x16\n\x12\x41PPLICATION_FINISH\x10\x05\x12 \n\x1c\x41PPLICATION_QUICK_SUBMISSION\x10\x06\x12\x18\n\x14\x41PPLICATION_REDIRECT\x10\x07\x12!\n\x1d\x41PPLICATION_START_FROM_SEARCH\x10\x08\x12$\n APPLICATION_REDIRECT_FROM_SEARCH\x10\t\x12\x1e\n\x1a\x41PPLICATION_COMPANY_SUBMIT\x10\n\x12\x0c\n\x08\x42OOKMARK\x10\x0b\x12\x10\n\x0cNOTIFICATION\x10\x0c\x12\t\n\x05HIRED\x10\r\x12\x0b\n\x07SENT_CV\x10\x0e\x12\x15\n\x11INTERVIEW_GRANTED\x10\x0f"\xd8\x01\n\x0cProfileEvent\x12H\n\x04type\x18\x01 \x01(\x0e\x32:.google.cloud.talent.v4beta1.ProfileEvent.ProfileEventType\x12\x10\n\x08profiles\x18\x02 \x03(\t\x12\x0c\n\x04jobs\x18\x06 \x03(\t"^\n\x10ProfileEventType\x12"\n\x1ePROFILE_EVENT_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nIMPRESSION\x10\x01\x12\x08\n\x04VIEW\x10\x02\x12\x0c\n\x08\x42OOKMARK\x10\x03\x42x\n\x1f\x63om.google.cloud.talent.v4beta1B\nEventProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_JOBEVENT_JOBEVENTTYPE = _descriptor.EnumDescriptor(
+    name="JobEventType",
+    full_name="google.cloud.talent.v4beta1.JobEvent.JobEventType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="JOB_EVENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPRESSION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIEW", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIEW_REDIRECT", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_START",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_FINISH",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_QUICK_SUBMISSION",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_REDIRECT",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_START_FROM_SEARCH",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_REDIRECT_FROM_SEARCH",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPLICATION_COMPANY_SUBMIT",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOKMARK", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOTIFICATION", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HIRED", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SENT_CV", index=14, number=14, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERVIEW_GRANTED",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=513,
+    serialized_end=895,
+)
+_sym_db.RegisterEnumDescriptor(_JOBEVENT_JOBEVENTTYPE)
+
+_PROFILEEVENT_PROFILEEVENTTYPE = _descriptor.EnumDescriptor(
+    name="ProfileEventType",
+    full_name="google.cloud.talent.v4beta1.ProfileEvent.ProfileEventType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PROFILE_EVENT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMPRESSION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIEW", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BOOKMARK", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1020,
+    serialized_end=1114,
+)
+_sym_db.RegisterEnumDescriptor(_PROFILEEVENT_PROFILEEVENTTYPE)
+
+
+_CLIENTEVENT = _descriptor.Descriptor(
+    name="ClientEvent",
+    full_name="google.cloud.talent.v4beta1.ClientEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="request_id",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.request_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_id",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.event_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.create_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_event",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.job_event",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profile_event",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.profile_event",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="event_notes",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.event_notes",
+            index=5,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="event",
+            full_name="google.cloud.talent.v4beta1.ClientEvent.event",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=142,
+    serialized_end=400,
+)
+
+
+_JOBEVENT = _descriptor.Descriptor(
+    name="JobEvent",
+    full_name="google.cloud.talent.v4beta1.JobEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.JobEvent.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.talent.v4beta1.JobEvent.jobs",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profile",
+            full_name="google.cloud.talent.v4beta1.JobEvent.profile",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_JOBEVENT_JOBEVENTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=403,
+    serialized_end=895,
+)
+
+
+_PROFILEEVENT = _descriptor.Descriptor(
+    name="ProfileEvent",
+    full_name="google.cloud.talent.v4beta1.ProfileEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.ProfileEvent.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profiles",
+            full_name="google.cloud.talent.v4beta1.ProfileEvent.profiles",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.talent.v4beta1.ProfileEvent.jobs",
+            index=2,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_PROFILEEVENT_PROFILEEVENTTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=898,
+    serialized_end=1114,
+)
+
+_CLIENTEVENT.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CLIENTEVENT.fields_by_name["job_event"].message_type = _JOBEVENT
+_CLIENTEVENT.fields_by_name["profile_event"].message_type = _PROFILEEVENT
+_CLIENTEVENT.oneofs_by_name["event"].fields.append(
+    _CLIENTEVENT.fields_by_name["job_event"]
+)
+_CLIENTEVENT.fields_by_name["job_event"].containing_oneof = _CLIENTEVENT.oneofs_by_name[
+    "event"
+]
+_CLIENTEVENT.oneofs_by_name["event"].fields.append(
+    _CLIENTEVENT.fields_by_name["profile_event"]
+)
+_CLIENTEVENT.fields_by_name[
+    "profile_event"
+].containing_oneof = _CLIENTEVENT.oneofs_by_name["event"]
+_JOBEVENT.fields_by_name["type"].enum_type = _JOBEVENT_JOBEVENTTYPE
+_JOBEVENT_JOBEVENTTYPE.containing_type = _JOBEVENT
+_PROFILEEVENT.fields_by_name["type"].enum_type = _PROFILEEVENT_PROFILEEVENTTYPE
+_PROFILEEVENT_PROFILEEVENTTYPE.containing_type = _PROFILEEVENT
+DESCRIPTOR.message_types_by_name["ClientEvent"] = _CLIENTEVENT
+DESCRIPTOR.message_types_by_name["JobEvent"] = _JOBEVENT
+DESCRIPTOR.message_types_by_name["ProfileEvent"] = _PROFILEEVENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ClientEvent = _reflection.GeneratedProtocolMessageType(
+    "ClientEvent",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CLIENTEVENT,
+        __module__="google.cloud.talent_v4beta1.proto.event_pb2",
+        __doc__="""An event issued when an end user interacts with the application that
+  implements Cloud Talent Solution. Providing this information improves
+  the quality of results for the API clients, enabling the 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.
+  
+  
+  Attributes:
+      request_id:
+          Optional but highly recommended.  A unique ID generated in the
+          API responses. It can be found in [ResponseMetadata.request\_i
+          d][google.cloud.talent.v4beta1.ResponseMetadata.request\_id].
+      event_id:
+          Required. A unique identifier, generated by the client
+          application.
+      create_time:
+          Required. The timestamp of the event.
+      event:
+          Required.  The detail information of a specific event type.
+      job_event:
+          An event issued when a job seeker interacts with the
+          application that implements Cloud Talent Solution.
+      profile_event:
+          An event issued when a profile searcher interacts with the
+          application that implements Cloud Talent Solution.
+      event_notes:
+          Optional. Notes about the event provided by recruiters or
+          other users, for example, feedback on why a profile was
+          bookmarked.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ClientEvent)
+    ),
+)
+_sym_db.RegisterMessage(ClientEvent)
+
+JobEvent = _reflection.GeneratedProtocolMessageType(
+    "JobEvent",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBEVENT,
+        __module__="google.cloud.talent_v4beta1.proto.event_pb2",
+        __doc__="""An event issued when a job seeker interacts with the application that
+  implements Cloud Talent Solution.
+  
+  
+  Attributes:
+      type:
+          Required. The type of the event (see [JobEventType][google.clo
+          ud.talent.v4beta1.JobEvent.JobEventType]).
+      jobs:
+          Required. The [job
+          name(s)][google.cloud.talent.v4beta1.Job.name] associated with
+          this event. For example, if this is an [impression][google.clo
+          ud.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".
+      profile:
+          Optional. 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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.JobEvent)
+    ),
+)
+_sym_db.RegisterMessage(JobEvent)
+
+ProfileEvent = _reflection.GeneratedProtocolMessageType(
+    "ProfileEvent",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROFILEEVENT,
+        __module__="google.cloud.talent_v4beta1.proto.event_pb2",
+        __doc__="""An event issued when a profile searcher interacts with the application
+  that implements Cloud Talent Solution.
+  
+  
+  Attributes:
+      type:
+          Required. Type of event.
+      profiles:
+          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".
+      jobs:
+          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 format is
+          "projects/{project\_id}/tenants/{tenant\_id}/jobs/{job\_id}",
+          for example, "projects/api-test-
+          project/tenants/foo/jobs/1234".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ProfileEvent)
+    ),
+)
+_sym_db.RegisterMessage(ProfileEvent)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/event_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/event_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/event_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/event_service.proto b/talent/google/cloud/talent_v4beta1/proto/event_service.proto
new file mode 100644
index 000000000000..966632e57d2e
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/event_service.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.cloud.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/talent/v4beta1/event.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "EventServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service handles client event report.
+service EventService {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Report events issued when end user interacts with customer's application
+  // that uses Cloud Talent Solution. You may inspect the created events in
+  // [self service
+  // tools](https://console.cloud.google.com/talent-solution/overview).
+  // [Learn
+  // more](https://cloud.google.com/talent-solution/docs/management-tools)
+  // about self service tools.
+  rpc CreateClientEvent(CreateClientEventRequest) returns (ClientEvent) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/clientEvents"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/clientEvents"
+        body: "*"
+      }
+    };
+  }
+}
+
+// The report event request.
+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;
+
+  // Required. Events issued when end user interacts with customer's application
+  // that uses Cloud Talent Solution.
+  ClientEvent client_event = 2;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/event_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/event_service_pb2.py
new file mode 100644
index 000000000000..7cf0778adcc7
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/event_service_pb2.py
@@ -0,0 +1,164 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/event_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    event_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/event_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\021EventServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n5google/cloud/talent_v4beta1/proto/event_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a-google/cloud/talent_v4beta1/proto/event.proto"j\n\x18\x43reateClientEventRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12>\n\x0c\x63lient_event\x18\x02 \x01(\x0b\x32(.google.cloud.talent.v4beta1.ClientEvent2\xe3\x02\n\x0c\x45ventService\x12\xe4\x01\n\x11\x43reateClientEvent\x12\x35.google.cloud.talent.v4beta1.CreateClientEventRequest\x1a(.google.cloud.talent.v4beta1.ClientEvent"n\x82\xd3\xe4\x93\x02h"3/v4beta1/{parent=projects/*/tenants/*}/clientEvents:\x01*Z.")/v4beta1/{parent=projects/*}/clientEvents:\x01*\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB\x7f\n\x1f\x63om.google.cloud.talent.v4beta1B\x11\x45ventServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATECLIENTEVENTREQUEST = _descriptor.Descriptor(
+    name="CreateClientEventRequest",
+    full_name="google.cloud.talent.v4beta1.CreateClientEventRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CreateClientEventRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="client_event",
+            full_name="google.cloud.talent.v4beta1.CreateClientEventRequest.client_event",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=188,
+    serialized_end=294,
+)
+
+_CREATECLIENTEVENTREQUEST.fields_by_name[
+    "client_event"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2._CLIENTEVENT
+)
+DESCRIPTOR.message_types_by_name["CreateClientEventRequest"] = _CREATECLIENTEVENTREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateClientEventRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateClientEventRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATECLIENTEVENTREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.event_service_pb2",
+        __doc__="""The report event request.
+  
+  
+  Attributes:
+      parent:
+          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".
+      client_event:
+          Required. Events issued when end user interacts with
+          customer's application that uses Cloud Talent Solution.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CreateClientEventRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateClientEventRequest)
+
+
+DESCRIPTOR._options = None
+
+_EVENTSERVICE = _descriptor.ServiceDescriptor(
+    name="EventService",
+    full_name="google.cloud.talent.v4beta1.EventService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=297,
+    serialized_end=652,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateClientEvent",
+            full_name="google.cloud.talent.v4beta1.EventService.CreateClientEvent",
+            index=0,
+            containing_service=None,
+            input_type=_CREATECLIENTEVENTREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2._CLIENTEVENT,
+            serialized_options=_b(
+                '\202\323\344\223\002h"3/v4beta1/{parent=projects/*/tenants/*}/clientEvents:\001*Z.")/v4beta1/{parent=projects/*}/clientEvents:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_EVENTSERVICE)
+
+DESCRIPTOR.services_by_name["EventService"] = _EVENTSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/event_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/event_service_pb2_grpc.py
new file mode 100644
index 000000000000..542f4851718c
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/event_service_pb2_grpc.py
@@ -0,0 +1,58 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    event_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    event_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__service__pb2,
+)
+
+
+class EventServiceStub(object):
+    """A service handles client event report.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateClientEvent = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.EventService/CreateClientEvent",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__service__pb2.CreateClientEventRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2.ClientEvent.FromString,
+        )
+
+
+class EventServiceServicer(object):
+    """A service handles client event report.
+  """
+
+    def CreateClientEvent(self, request, context):
+        """Report events issued when end user interacts with customer's application
+    that uses Cloud Talent Solution. You may inspect the created events in
+    [self service
+    tools](https://console.cloud.google.com/talent-solution/overview).
+    [Learn
+    more](https://cloud.google.com/talent-solution/docs/management-tools)
+    about self service tools.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_EventServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateClientEvent": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateClientEvent,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__service__pb2.CreateClientEventRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_event__pb2.ClientEvent.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.EventService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/proto/filters.proto b/talent/google/cloud/talent_v4beta1/proto/filters.proto
new file mode 100644
index 000000000000..35f5d8279457
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/filters.proto
@@ -0,0 +1,849 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/protobuf/duration.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";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+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 maximum number of allowed characters is 255.
+  string query = 1;
+
+  // Optional. This filter specifies the company entities to search against.
+  //
+  // If a value isn't specified, jobs are searched for against all
+  // companies.
+  //
+  // If multiple values are specified, jobs are searched against the
+  // companies specified.
+  //
+  // 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".
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // If a value isn't specified, jobs from any category are searched against.
+  //
+  // If multiple values are specified, jobs from any of the specified
+  // categories are searched against.
+  repeated JobCategory job_categories = 4;
+
+  // Optional. 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.
+  //
+  //  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.
+  //
+  // If a value isn't specified, jobs within the search results are
+  // associated with any company.
+  //
+  // If multiple values are specified, jobs within the search results may be
+  // associated with any of the specified companies.
+  //
+  // 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.
+  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`.
+  //
+  // The syntax for this expression is a subset of SQL syntax.
+  //
+  // Supported operators are: `=`, `!=`, `<`, `<=`, `>`, and `>=` where the
+  // left of the operator is a custom field key and the right of the operator
+  // is a number or a quoted string. You must escape backslash (\\) and
+  // quote (\") characters.
+  //
+  // Supported functions are `LOWER([field_name])` to
+  // perform a case insensitive match and `EMPTY([field_name])` to filter on the
+  // existence of a key.
+  //
+  // 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 < 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
+  // 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].
+  //
+  // If a value isn't specified, jobs in the search results includes any
+  // employment type.
+  //
+  // If multiple values are specified, jobs in the search results include
+  // any of the specified employment types.
+  repeated EmploymentType employment_types = 10;
+
+  // Optional. 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
+  // locale.
+  //
+  //
+  // Language codes 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).
+  //
+  // 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.
+  TimestampRange publish_time_range = 12;
+
+  // Optional. 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;
+}
+
+// Filters to apply when performing the search query.
+message ProfileQuery {
+  // Optional. 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.
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // If an employer filter isn't specified, profiles with any employers are
+  // retrieved.
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // If an education filter isn't specified, profiles with any education are
+  // retrieved.
+  //
+  // 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.
+  //
+  // For example, search for profiles with a master degree.
+  repeated EducationFilter education_filters = 5;
+
+  // Optional. 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.
+  //
+  // 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.
+  //
+  // If a work experience filter isn't specified, profiles with any
+  // professional experience are retrieved.
+  //
+  // If multiple work experience filters are specified, profiles that match any
+  // work experience filters are retrieved.
+  //
+  // 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.
+  //
+  // 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.
+  google.protobuf.BoolValue hirable_filter = 9;
+
+  // Optional. 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.
+  repeated ApplicationOutcomeNotesFilter application_outcome_notes_filters = 11;
+
+  // Optional. 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`.
+  //
+  // The syntax for this expression is a subset of Google SQL syntax.
+  //
+  // String custom attributes: supported operators are =, != where the left of
+  // the operator is a custom field key and the right of the operator is a
+  // string (surrounded by quotes) value.
+  //
+  // Numeric custom attributes: Supported operators are '>', '<' or '='
+  // operators where the left of the operator is a custom field key and the
+  // right of the operator is a numeric value.
+  //
+  // Supported functions are LOWER(<field_name>) to
+  // perform case insensitive match and EMPTY(<field_name>) to filter on the
+  // existence of a key.
+  //
+  // 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"), and there can be
+  // a maximum of 50 comparisons/functions in the expression. The expression
+  // must be < 2000 characters in length.
+  //
+  // Sample Query:
+  // (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.
+  //
+  // 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.
+  //
+  // Signal 2: Number of days since last profile update. See
+  // [Availability.ProfileUpdateAvailabilitySignal][google.cloud.talent.v4beta1.Availability.ProfileUpdateAvailabilitySignal]
+  // for the details of this signal.
+  //
+  // The candidate 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.
+  CandidateAvailabilityFilter candidate_availability_filter = 16;
+
+  // Optional. 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 to include telecommute jobs.
+  enum TelecommutePreference {
+    // Default value if the telecommute preference isn't specified.
+    TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0;
+
+    // Exclude telecommute jobs.
+    TELECOMMUTE_EXCLUDED = 1;
+
+    // Allow telecommute jobs.
+    TELECOMMUTE_ALLOWED = 2;
+  }
+
+  // Optional. 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".
+  //
+  // 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
+  // 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 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. 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
+  // 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.
+  //
+  // This filter can be used by itself to search exclusively for telecommuting
+  // jobs, or it can be combined with another location
+  // filter to search for a combination of job locations,
+  // 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.
+  //
+  // 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.
+  enum FilterType {
+    // Filter type unspecified. Position holder, INVALID, should never be used.
+    FILTER_TYPE_UNSPECIFIED = 0;
+
+    // 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].
+    //
+    // 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
+    // [CompensationRange][google.cloud.talent.v4beta1.CompensationInfo.CompensationRange].
+    //
+    // 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].
+    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].
+    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].
+    ANNUALIZED_TOTAL_AMOUNT = 4;
+  }
+
+  // Required. Type of filter.
+  FilterType type = 1;
+
+  // Required. Specify desired `base compensation entry's`
+  // [CompensationInfo.CompensationUnit][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit].
+  repeated CompensationInfo.CompensationUnit units = 2;
+
+  // Optional. Compensation range.
+  CompensationInfo.CompensationRange range = 3;
+
+  // Optional. 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.
+  enum RoadTraffic {
+    // Road traffic situation isn't specified.
+    ROAD_TRAFFIC_UNSPECIFIED = 0;
+
+    // Optimal commute time without considering any traffic impact.
+    TRAFFIC_FREE = 1;
+
+    // Commute time calculation takes in account the peak traffic impact.
+    BUSY_HOUR = 2;
+  }
+
+  // Required. The method of transportation for which to calculate the commute
+  // time.
+  CommuteMethod commute_method = 1;
+
+  // Required. The latitude and longitude of the location from which to
+  // calculate the commute time.
+  google.type.LatLng start_coordinates = 2;
+
+  // Required. The maximum travel time in seconds. The maximum allowed value is
+  // `3600s` (one hour). Format is `123s`.
+  google.protobuf.Duration travel_duration = 3;
+
+  // 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.
+  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.
+    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.
+    //
+    // 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;
+
+  // Optional. 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;
+
+  // Optional. 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 EmployerFilterMode {
+    // Default value.
+    EMPLOYER_FILTER_MODE_UNSPECIFIED = 0;
+
+    // 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].
+    CURRENT_EMPLOYMENT_RECORDS_ONLY = 2;
+
+    // Apply only to past (not current) employers in
+    // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
+    PAST_EMPLOYMENT_RECORDS_ONLY = 3;
+  }
+
+  // Required. The name of the employer, for example "Google", "Alphabet".
+  string employer = 1;
+
+  // Optional. 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].
+  EmployerFilterMode mode = 2;
+
+  // Optional. 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".
+  string school = 1;
+
+  // Optional. 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.
+  DegreeType degree_type = 3;
+
+  // Optional. 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].
+message WorkExperienceFilter {
+  // Optional. The minimum duration of the work experience (inclusive).
+  google.protobuf.Duration min_experience = 1;
+
+  // Optional. 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.
+message ApplicationDateFilter {
+  // Optional. 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.
+  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.
+  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.
+  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.
+  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.
+  bool negated = 4;
+}
+
+// Input only.
+//
+// Filter on create timestamp or update timestamp of profiles.
+message TimeFilter {
+  // Time fields can be used in TimeFilter.
+  enum TimeField {
+    // Default value.
+    TIME_FIELD_UNSPECIFIED = 0;
+
+    // Earliest profile create time.
+    CREATE_TIME = 1;
+
+    // Latest profile update time.
+    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.
+  google.protobuf.Timestamp start_time = 1;
+
+  // Optional. 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.
+  //
+  // Defaults to
+  // [TimeField.CREATE_TIME][google.cloud.talent.v4beta1.TimeFilter.TimeField.CREATE_TIME].
+  TimeField time_field = 3;
+}
+
+// Input only
+//
+// Filter on availability signals.
+message CandidateAvailabilityFilter {
+  // Optional. It is false by default. If true, API excludes all the potential
+  // available profiles.
+  bool negated = 1;
+}
+
+// Input only.
+//
+// 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;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py b/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py
new file mode 100644
index 000000000000..1b8de9175bf7
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/filters_pb2.py
@@ -0,0 +1,2743 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/filters.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.type import date_pb2 as google_dot_type_dot_date__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+from google.type import timeofday_pb2 as google_dot_type_dot_timeofday__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/filters.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\014FiltersProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/talent_v4beta1/proto/filters.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x16google/type/date.proto\x1a\x18google/type/latlng.proto\x1a\x1bgoogle/type/timeofday.proto"\xe3\x04\n\x08JobQuery\x12\r\n\x05query\x18\x01 \x01(\t\x12\x11\n\tcompanies\x18\x02 \x03(\t\x12\x45\n\x10location_filters\x18\x03 \x03(\x0b\x32+.google.cloud.talent.v4beta1.LocationFilter\x12@\n\x0ejob_categories\x18\x04 \x03(\x0e\x32(.google.cloud.talent.v4beta1.JobCategory\x12\x42\n\x0e\x63ommute_filter\x18\x05 \x01(\x0b\x32*.google.cloud.talent.v4beta1.CommuteFilter\x12\x1d\n\x15\x63ompany_display_names\x18\x06 \x03(\t\x12L\n\x13\x63ompensation_filter\x18\x07 \x01(\x0b\x32/.google.cloud.talent.v4beta1.CompensationFilter\x12\x1f\n\x17\x63ustom_attribute_filter\x18\x08 \x01(\t\x12\x1b\n\x13\x64isable_spell_check\x18\t \x01(\x08\x12\x45\n\x10\x65mployment_types\x18\n \x03(\x0e\x32+.google.cloud.talent.v4beta1.EmploymentType\x12\x16\n\x0elanguage_codes\x18\x0b \x03(\t\x12G\n\x12publish_time_range\x18\x0c \x01(\x0b\x32+.google.cloud.talent.v4beta1.TimestampRange\x12\x15\n\rexcluded_jobs\x18\r \x03(\t"\xa2\x08\n\x0cProfileQuery\x12\r\n\x05query\x18\x01 \x01(\t\x12\x45\n\x10location_filters\x18\x02 \x03(\x0b\x32+.google.cloud.talent.v4beta1.LocationFilter\x12\x46\n\x11job_title_filters\x18\x03 \x03(\x0b\x32+.google.cloud.talent.v4beta1.JobTitleFilter\x12\x45\n\x10\x65mployer_filters\x18\x04 \x03(\x0b\x32+.google.cloud.talent.v4beta1.EmployerFilter\x12G\n\x11\x65\x64ucation_filters\x18\x05 \x03(\x0b\x32,.google.cloud.talent.v4beta1.EducationFilter\x12?\n\rskill_filters\x18\x06 \x03(\x0b\x32(.google.cloud.talent.v4beta1.SkillFilter\x12Q\n\x16work_experience_filter\x18\x07 \x03(\x0b\x32\x31.google.cloud.talent.v4beta1.WorkExperienceFilter\x12=\n\x0ctime_filters\x18\x08 \x03(\x0b\x32\'.google.cloud.talent.v4beta1.TimeFilter\x12\x32\n\x0ehirable_filter\x18\t \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12T\n\x18\x61pplication_date_filters\x18\n \x03(\x0b\x32\x32.google.cloud.talent.v4beta1.ApplicationDateFilter\x12\x65\n!application_outcome_notes_filters\x18\x0b \x03(\x0b\x32:.google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter\x12R\n\x17\x61pplication_job_filters\x18\r \x03(\x0b\x32\x31.google.cloud.talent.v4beta1.ApplicationJobFilter\x12\x1f\n\x17\x63ustom_attribute_filter\x18\x0f \x01(\t\x12_\n\x1d\x63\x61ndidate_availability_filter\x18\x10 \x01(\x0b\x32\x38.google.cloud.talent.v4beta1.CandidateAvailabilityFilter\x12J\n\x13person_name_filters\x18\x11 \x03(\x0b\x32-.google.cloud.talent.v4beta1.PersonNameFilter"\xdf\x02\n\x0eLocationFilter\x12\x0f\n\x07\x61\x64\x64ress\x18\x01 \x01(\t\x12\x13\n\x0bregion_code\x18\x02 \x01(\t\x12$\n\x07lat_lng\x18\x03 \x01(\x0b\x32\x13.google.type.LatLng\x12\x19\n\x11\x64istance_in_miles\x18\x04 \x01(\x01\x12\x61\n\x16telecommute_preference\x18\x05 \x01(\x0e\x32\x41.google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference\x12\x0f\n\x07negated\x18\x06 \x01(\x08"r\n\x15TelecommutePreference\x12&\n"TELECOMMUTE_PREFERENCE_UNSPECIFIED\x10\x00\x12\x18\n\x14TELECOMMUTE_EXCLUDED\x10\x01\x12\x17\n\x13TELECOMMUTE_ALLOWED\x10\x02"\xc0\x03\n\x12\x43ompensationFilter\x12H\n\x04type\x18\x01 \x01(\x0e\x32:.google.cloud.talent.v4beta1.CompensationFilter.FilterType\x12M\n\x05units\x18\x02 \x03(\x0e\x32>.google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit\x12N\n\x05range\x18\x03 \x01(\x0b\x32?.google.cloud.talent.v4beta1.CompensationInfo.CompensationRange\x12\x38\n0include_jobs_with_unspecified_compensation_range\x18\x04 \x01(\x08"\x86\x01\n\nFilterType\x12\x1b\n\x17\x46ILTER_TYPE_UNSPECIFIED\x10\x00\x12\r\n\tUNIT_ONLY\x10\x01\x12\x13\n\x0fUNIT_AND_AMOUNT\x10\x02\x12\x1a\n\x16\x41NNUALIZED_BASE_AMOUNT\x10\x03\x12\x1b\n\x17\x41NNUALIZED_TOTAL_AMOUNT\x10\x04"\xbc\x03\n\rCommuteFilter\x12\x42\n\x0e\x63ommute_method\x18\x01 \x01(\x0e\x32*.google.cloud.talent.v4beta1.CommuteMethod\x12.\n\x11start_coordinates\x18\x02 \x01(\x0b\x32\x13.google.type.LatLng\x12\x32\n\x0ftravel_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12!\n\x19\x61llow_imprecise_addresses\x18\x04 \x01(\x08\x12N\n\x0croad_traffic\x18\x05 \x01(\x0e\x32\x36.google.cloud.talent.v4beta1.CommuteFilter.RoadTrafficH\x00\x12\x30\n\x0e\x64\x65parture_time\x18\x06 \x01(\x0b\x32\x16.google.type.TimeOfDayH\x00"L\n\x0bRoadTraffic\x12\x1c\n\x18ROAD_TRAFFIC_UNSPECIFIED\x10\x00\x12\x10\n\x0cTRAFFIC_FREE\x10\x01\x12\r\n\tBUSY_HOUR\x10\x02\x42\x10\n\x0etraffic_option"4\n\x0eJobTitleFilter\x12\x11\n\tjob_title\x18\x01 \x01(\t\x12\x0f\n\x07negated\x18\x02 \x01(\x08"-\n\x0bSkillFilter\x12\r\n\x05skill\x18\x01 \x01(\t\x12\x0f\n\x07negated\x18\x02 \x01(\x08"\xa1\x02\n\x0e\x45mployerFilter\x12\x10\n\x08\x65mployer\x18\x01 \x01(\t\x12L\n\x04mode\x18\x02 \x01(\x0e\x32>.google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode\x12\x0f\n\x07negated\x18\x03 \x01(\x08"\x9d\x01\n\x12\x45mployerFilterMode\x12$\n EMPLOYER_FILTER_MODE_UNSPECIFIED\x10\x00\x12\x1a\n\x16\x41LL_EMPLOYMENT_RECORDS\x10\x01\x12#\n\x1f\x43URRENT_EMPLOYMENT_RECORDS_ONLY\x10\x02\x12 \n\x1cPAST_EMPLOYMENT_RECORDS_ONLY\x10\x03"\x88\x01\n\x0f\x45\x64ucationFilter\x12\x0e\n\x06school\x18\x01 \x01(\t\x12\x16\n\x0e\x66ield_of_study\x18\x02 \x01(\t\x12<\n\x0b\x64\x65gree_type\x18\x03 \x01(\x0e\x32\'.google.cloud.talent.v4beta1.DegreeType\x12\x0f\n\x07negated\x18\x06 \x01(\x08"|\n\x14WorkExperienceFilter\x12\x31\n\x0emin_experience\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x31\n\x0emax_experience\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"c\n\x15\x41pplicationDateFilter\x12%\n\nstart_date\x18\x01 \x01(\x0b\x32\x11.google.type.Date\x12#\n\x08\x65nd_date\x18\x02 \x01(\x0b\x32\x11.google.type.Date"G\n\x1d\x41pplicationOutcomeNotesFilter\x12\x15\n\routcome_notes\x18\x01 \x01(\t\x12\x0f\n\x07negated\x18\x02 \x01(\x08"V\n\x14\x41pplicationJobFilter\x12\x1a\n\x12job_requisition_id\x18\x02 \x01(\t\x12\x11\n\tjob_title\x18\x03 \x01(\t\x12\x0f\n\x07negated\x18\x04 \x01(\x08"\xfc\x01\n\nTimeFilter\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x45\n\ntime_field\x18\x03 \x01(\x0e\x32\x31.google.cloud.talent.v4beta1.TimeFilter.TimeField"I\n\tTimeField\x12\x1a\n\x16TIME_FIELD_UNSPECIFIED\x10\x00\x12\x0f\n\x0b\x43REATE_TIME\x10\x01\x12\x0f\n\x0bUPDATE_TIME\x10\x02".\n\x1b\x43\x61ndidateAvailabilityFilter\x12\x0f\n\x07negated\x18\x01 \x01(\x08"\'\n\x10PersonNameFilter\x12\x13\n\x0bperson_name\x18\x01 \x01(\tBz\n\x1f\x63om.google.cloud.talent.v4beta1B\x0c\x46iltersProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_type_dot_date__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+        google_dot_type_dot_timeofday__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LOCATIONFILTER_TELECOMMUTEPREFERENCE = _descriptor.EnumDescriptor(
+    name="TelecommutePreference",
+    full_name="google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TELECOMMUTE_PREFERENCE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TELECOMMUTE_EXCLUDED",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TELECOMMUTE_ALLOWED",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2247,
+    serialized_end=2361,
+)
+_sym_db.RegisterEnumDescriptor(_LOCATIONFILTER_TELECOMMUTEPREFERENCE)
+
+_COMPENSATIONFILTER_FILTERTYPE = _descriptor.EnumDescriptor(
+    name="FilterType",
+    full_name="google.cloud.talent.v4beta1.CompensationFilter.FilterType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FILTER_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNIT_ONLY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNIT_AND_AMOUNT",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANNUALIZED_BASE_AMOUNT",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ANNUALIZED_TOTAL_AMOUNT",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2678,
+    serialized_end=2812,
+)
+_sym_db.RegisterEnumDescriptor(_COMPENSATIONFILTER_FILTERTYPE)
+
+_COMMUTEFILTER_ROADTRAFFIC = _descriptor.EnumDescriptor(
+    name="RoadTraffic",
+    full_name="google.cloud.talent.v4beta1.CommuteFilter.RoadTraffic",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="ROAD_TRAFFIC_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TRAFFIC_FREE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BUSY_HOUR", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3165,
+    serialized_end=3241,
+)
+_sym_db.RegisterEnumDescriptor(_COMMUTEFILTER_ROADTRAFFIC)
+
+_EMPLOYERFILTER_EMPLOYERFILTERMODE = _descriptor.EnumDescriptor(
+    name="EmployerFilterMode",
+    full_name="google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EMPLOYER_FILTER_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ALL_EMPLOYMENT_RECORDS",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CURRENT_EMPLOYMENT_RECORDS_ONLY",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAST_EMPLOYMENT_RECORDS_ONLY",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3495,
+    serialized_end=3652,
+)
+_sym_db.RegisterEnumDescriptor(_EMPLOYERFILTER_EMPLOYERFILTERMODE)
+
+_TIMEFILTER_TIMEFIELD = _descriptor.EnumDescriptor(
+    name="TimeField",
+    full_name="google.cloud.talent.v4beta1.TimeFilter.TimeField",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TIME_FIELD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATE_TIME", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPDATE_TIME", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4361,
+    serialized_end=4434,
+)
+_sym_db.RegisterEnumDescriptor(_TIMEFILTER_TIMEFIELD)
+
+
+_JOBQUERY = _descriptor.Descriptor(
+    name="JobQuery",
+    full_name="google.cloud.talent.v4beta1.JobQuery",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.talent.v4beta1.JobQuery.query",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="companies",
+            full_name="google.cloud.talent.v4beta1.JobQuery.companies",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_filters",
+            full_name="google.cloud.talent.v4beta1.JobQuery.location_filters",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_categories",
+            full_name="google.cloud.talent.v4beta1.JobQuery.job_categories",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commute_filter",
+            full_name="google.cloud.talent.v4beta1.JobQuery.commute_filter",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="company_display_names",
+            full_name="google.cloud.talent.v4beta1.JobQuery.company_display_names",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compensation_filter",
+            full_name="google.cloud.talent.v4beta1.JobQuery.compensation_filter",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_attribute_filter",
+            full_name="google.cloud.talent.v4beta1.JobQuery.custom_attribute_filter",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disable_spell_check",
+            full_name="google.cloud.talent.v4beta1.JobQuery.disable_spell_check",
+            index=8,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="employment_types",
+            full_name="google.cloud.talent.v4beta1.JobQuery.employment_types",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_codes",
+            full_name="google.cloud.talent.v4beta1.JobQuery.language_codes",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publish_time_range",
+            full_name="google.cloud.talent.v4beta1.JobQuery.publish_time_range",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="excluded_jobs",
+            full_name="google.cloud.talent.v4beta1.JobQuery.excluded_jobs",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=335,
+    serialized_end=946,
+)
+
+
+_PROFILEQUERY = _descriptor.Descriptor(
+    name="ProfileQuery",
+    full_name="google.cloud.talent.v4beta1.ProfileQuery",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="query",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.query",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.location_filters",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_title_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.job_title_filters",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="employer_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.employer_filters",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="education_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.education_filters",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skill_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.skill_filters",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="work_experience_filter",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.work_experience_filter",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.time_filters",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hirable_filter",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.hirable_filter",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="application_date_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.application_date_filters",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="application_outcome_notes_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.application_outcome_notes_filters",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="application_job_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.application_job_filters",
+            index=11,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_attribute_filter",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.custom_attribute_filter",
+            index=12,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="candidate_availability_filter",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.candidate_availability_filter",
+            index=13,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="person_name_filters",
+            full_name="google.cloud.talent.v4beta1.ProfileQuery.person_name_filters",
+            index=14,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=949,
+    serialized_end=2007,
+)
+
+
+_LOCATIONFILTER = _descriptor.Descriptor(
+    name="LocationFilter",
+    full_name="google.cloud.talent.v4beta1.LocationFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="address",
+            full_name="google.cloud.talent.v4beta1.LocationFilter.address",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="region_code",
+            full_name="google.cloud.talent.v4beta1.LocationFilter.region_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.talent.v4beta1.LocationFilter.lat_lng",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="distance_in_miles",
+            full_name="google.cloud.talent.v4beta1.LocationFilter.distance_in_miles",
+            index=3,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="telecommute_preference",
+            full_name="google.cloud.talent.v4beta1.LocationFilter.telecommute_preference",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.LocationFilter.negated",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LOCATIONFILTER_TELECOMMUTEPREFERENCE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2010,
+    serialized_end=2361,
+)
+
+
+_COMPENSATIONFILTER = _descriptor.Descriptor(
+    name="CompensationFilter",
+    full_name="google.cloud.talent.v4beta1.CompensationFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.CompensationFilter.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="units",
+            full_name="google.cloud.talent.v4beta1.CompensationFilter.units",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="range",
+            full_name="google.cloud.talent.v4beta1.CompensationFilter.range",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_jobs_with_unspecified_compensation_range",
+            full_name="google.cloud.talent.v4beta1.CompensationFilter.include_jobs_with_unspecified_compensation_range",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_COMPENSATIONFILTER_FILTERTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2364,
+    serialized_end=2812,
+)
+
+
+_COMMUTEFILTER = _descriptor.Descriptor(
+    name="CommuteFilter",
+    full_name="google.cloud.talent.v4beta1.CommuteFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="commute_method",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.commute_method",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_coordinates",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.start_coordinates",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="travel_duration",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.travel_duration",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="allow_imprecise_addresses",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.allow_imprecise_addresses",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="road_traffic",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.road_traffic",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="departure_time",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.departure_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_COMMUTEFILTER_ROADTRAFFIC],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="traffic_option",
+            full_name="google.cloud.talent.v4beta1.CommuteFilter.traffic_option",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2815,
+    serialized_end=3259,
+)
+
+
+_JOBTITLEFILTER = _descriptor.Descriptor(
+    name="JobTitleFilter",
+    full_name="google.cloud.talent.v4beta1.JobTitleFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job_title",
+            full_name="google.cloud.talent.v4beta1.JobTitleFilter.job_title",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.JobTitleFilter.negated",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3261,
+    serialized_end=3313,
+)
+
+
+_SKILLFILTER = _descriptor.Descriptor(
+    name="SkillFilter",
+    full_name="google.cloud.talent.v4beta1.SkillFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="skill",
+            full_name="google.cloud.talent.v4beta1.SkillFilter.skill",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.SkillFilter.negated",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3315,
+    serialized_end=3360,
+)
+
+
+_EMPLOYERFILTER = _descriptor.Descriptor(
+    name="EmployerFilter",
+    full_name="google.cloud.talent.v4beta1.EmployerFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="employer",
+            full_name="google.cloud.talent.v4beta1.EmployerFilter.employer",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mode",
+            full_name="google.cloud.talent.v4beta1.EmployerFilter.mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.EmployerFilter.negated",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_EMPLOYERFILTER_EMPLOYERFILTERMODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3363,
+    serialized_end=3652,
+)
+
+
+_EDUCATIONFILTER = _descriptor.Descriptor(
+    name="EducationFilter",
+    full_name="google.cloud.talent.v4beta1.EducationFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="school",
+            full_name="google.cloud.talent.v4beta1.EducationFilter.school",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_of_study",
+            full_name="google.cloud.talent.v4beta1.EducationFilter.field_of_study",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="degree_type",
+            full_name="google.cloud.talent.v4beta1.EducationFilter.degree_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.EducationFilter.negated",
+            index=3,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3655,
+    serialized_end=3791,
+)
+
+
+_WORKEXPERIENCEFILTER = _descriptor.Descriptor(
+    name="WorkExperienceFilter",
+    full_name="google.cloud.talent.v4beta1.WorkExperienceFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_experience",
+            full_name="google.cloud.talent.v4beta1.WorkExperienceFilter.min_experience",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_experience",
+            full_name="google.cloud.talent.v4beta1.WorkExperienceFilter.max_experience",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3793,
+    serialized_end=3917,
+)
+
+
+_APPLICATIONDATEFILTER = _descriptor.Descriptor(
+    name="ApplicationDateFilter",
+    full_name="google.cloud.talent.v4beta1.ApplicationDateFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_date",
+            full_name="google.cloud.talent.v4beta1.ApplicationDateFilter.start_date",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_date",
+            full_name="google.cloud.talent.v4beta1.ApplicationDateFilter.end_date",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3919,
+    serialized_end=4018,
+)
+
+
+_APPLICATIONOUTCOMENOTESFILTER = _descriptor.Descriptor(
+    name="ApplicationOutcomeNotesFilter",
+    full_name="google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="outcome_notes",
+            full_name="google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter.outcome_notes",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter.negated",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4020,
+    serialized_end=4091,
+)
+
+
+_APPLICATIONJOBFILTER = _descriptor.Descriptor(
+    name="ApplicationJobFilter",
+    full_name="google.cloud.talent.v4beta1.ApplicationJobFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job_requisition_id",
+            full_name="google.cloud.talent.v4beta1.ApplicationJobFilter.job_requisition_id",
+            index=0,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_title",
+            full_name="google.cloud.talent.v4beta1.ApplicationJobFilter.job_title",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.ApplicationJobFilter.negated",
+            index=2,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4093,
+    serialized_end=4179,
+)
+
+
+_TIMEFILTER = _descriptor.Descriptor(
+    name="TimeFilter",
+    full_name="google.cloud.talent.v4beta1.TimeFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.talent.v4beta1.TimeFilter.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.talent.v4beta1.TimeFilter.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_field",
+            full_name="google.cloud.talent.v4beta1.TimeFilter.time_field",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TIMEFILTER_TIMEFIELD],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4182,
+    serialized_end=4434,
+)
+
+
+_CANDIDATEAVAILABILITYFILTER = _descriptor.Descriptor(
+    name="CandidateAvailabilityFilter",
+    full_name="google.cloud.talent.v4beta1.CandidateAvailabilityFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="negated",
+            full_name="google.cloud.talent.v4beta1.CandidateAvailabilityFilter.negated",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4436,
+    serialized_end=4482,
+)
+
+
+_PERSONNAMEFILTER = _descriptor.Descriptor(
+    name="PersonNameFilter",
+    full_name="google.cloud.talent.v4beta1.PersonNameFilter",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="person_name",
+            full_name="google.cloud.talent.v4beta1.PersonNameFilter.person_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4484,
+    serialized_end=4523,
+)
+
+_JOBQUERY.fields_by_name["location_filters"].message_type = _LOCATIONFILTER
+_JOBQUERY.fields_by_name[
+    "job_categories"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._JOBCATEGORY
+)
+_JOBQUERY.fields_by_name["commute_filter"].message_type = _COMMUTEFILTER
+_JOBQUERY.fields_by_name["compensation_filter"].message_type = _COMPENSATIONFILTER
+_JOBQUERY.fields_by_name[
+    "employment_types"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._EMPLOYMENTTYPE
+)
+_JOBQUERY.fields_by_name[
+    "publish_time_range"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._TIMESTAMPRANGE
+)
+_PROFILEQUERY.fields_by_name["location_filters"].message_type = _LOCATIONFILTER
+_PROFILEQUERY.fields_by_name["job_title_filters"].message_type = _JOBTITLEFILTER
+_PROFILEQUERY.fields_by_name["employer_filters"].message_type = _EMPLOYERFILTER
+_PROFILEQUERY.fields_by_name["education_filters"].message_type = _EDUCATIONFILTER
+_PROFILEQUERY.fields_by_name["skill_filters"].message_type = _SKILLFILTER
+_PROFILEQUERY.fields_by_name[
+    "work_experience_filter"
+].message_type = _WORKEXPERIENCEFILTER
+_PROFILEQUERY.fields_by_name["time_filters"].message_type = _TIMEFILTER
+_PROFILEQUERY.fields_by_name[
+    "hirable_filter"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_PROFILEQUERY.fields_by_name[
+    "application_date_filters"
+].message_type = _APPLICATIONDATEFILTER
+_PROFILEQUERY.fields_by_name[
+    "application_outcome_notes_filters"
+].message_type = _APPLICATIONOUTCOMENOTESFILTER
+_PROFILEQUERY.fields_by_name[
+    "application_job_filters"
+].message_type = _APPLICATIONJOBFILTER
+_PROFILEQUERY.fields_by_name[
+    "candidate_availability_filter"
+].message_type = _CANDIDATEAVAILABILITYFILTER
+_PROFILEQUERY.fields_by_name["person_name_filters"].message_type = _PERSONNAMEFILTER
+_LOCATIONFILTER.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LOCATIONFILTER.fields_by_name[
+    "telecommute_preference"
+].enum_type = _LOCATIONFILTER_TELECOMMUTEPREFERENCE
+_LOCATIONFILTER_TELECOMMUTEPREFERENCE.containing_type = _LOCATIONFILTER
+_COMPENSATIONFILTER.fields_by_name["type"].enum_type = _COMPENSATIONFILTER_FILTERTYPE
+_COMPENSATIONFILTER.fields_by_name[
+    "units"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._COMPENSATIONINFO_COMPENSATIONUNIT
+)
+_COMPENSATIONFILTER.fields_by_name[
+    "range"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._COMPENSATIONINFO_COMPENSATIONRANGE
+)
+_COMPENSATIONFILTER_FILTERTYPE.containing_type = _COMPENSATIONFILTER
+_COMMUTEFILTER.fields_by_name[
+    "commute_method"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._COMMUTEMETHOD
+)
+_COMMUTEFILTER.fields_by_name[
+    "start_coordinates"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_COMMUTEFILTER.fields_by_name[
+    "travel_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_COMMUTEFILTER.fields_by_name["road_traffic"].enum_type = _COMMUTEFILTER_ROADTRAFFIC
+_COMMUTEFILTER.fields_by_name[
+    "departure_time"
+].message_type = google_dot_type_dot_timeofday__pb2._TIMEOFDAY
+_COMMUTEFILTER_ROADTRAFFIC.containing_type = _COMMUTEFILTER
+_COMMUTEFILTER.oneofs_by_name["traffic_option"].fields.append(
+    _COMMUTEFILTER.fields_by_name["road_traffic"]
+)
+_COMMUTEFILTER.fields_by_name[
+    "road_traffic"
+].containing_oneof = _COMMUTEFILTER.oneofs_by_name["traffic_option"]
+_COMMUTEFILTER.oneofs_by_name["traffic_option"].fields.append(
+    _COMMUTEFILTER.fields_by_name["departure_time"]
+)
+_COMMUTEFILTER.fields_by_name[
+    "departure_time"
+].containing_oneof = _COMMUTEFILTER.oneofs_by_name["traffic_option"]
+_EMPLOYERFILTER.fields_by_name["mode"].enum_type = _EMPLOYERFILTER_EMPLOYERFILTERMODE
+_EMPLOYERFILTER_EMPLOYERFILTERMODE.containing_type = _EMPLOYERFILTER
+_EDUCATIONFILTER.fields_by_name[
+    "degree_type"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._DEGREETYPE
+_WORKEXPERIENCEFILTER.fields_by_name[
+    "min_experience"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_WORKEXPERIENCEFILTER.fields_by_name[
+    "max_experience"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_APPLICATIONDATEFILTER.fields_by_name[
+    "start_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_APPLICATIONDATEFILTER.fields_by_name[
+    "end_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_TIMEFILTER.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEFILTER.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TIMEFILTER.fields_by_name["time_field"].enum_type = _TIMEFILTER_TIMEFIELD
+_TIMEFILTER_TIMEFIELD.containing_type = _TIMEFILTER
+DESCRIPTOR.message_types_by_name["JobQuery"] = _JOBQUERY
+DESCRIPTOR.message_types_by_name["ProfileQuery"] = _PROFILEQUERY
+DESCRIPTOR.message_types_by_name["LocationFilter"] = _LOCATIONFILTER
+DESCRIPTOR.message_types_by_name["CompensationFilter"] = _COMPENSATIONFILTER
+DESCRIPTOR.message_types_by_name["CommuteFilter"] = _COMMUTEFILTER
+DESCRIPTOR.message_types_by_name["JobTitleFilter"] = _JOBTITLEFILTER
+DESCRIPTOR.message_types_by_name["SkillFilter"] = _SKILLFILTER
+DESCRIPTOR.message_types_by_name["EmployerFilter"] = _EMPLOYERFILTER
+DESCRIPTOR.message_types_by_name["EducationFilter"] = _EDUCATIONFILTER
+DESCRIPTOR.message_types_by_name["WorkExperienceFilter"] = _WORKEXPERIENCEFILTER
+DESCRIPTOR.message_types_by_name["ApplicationDateFilter"] = _APPLICATIONDATEFILTER
+DESCRIPTOR.message_types_by_name[
+    "ApplicationOutcomeNotesFilter"
+] = _APPLICATIONOUTCOMENOTESFILTER
+DESCRIPTOR.message_types_by_name["ApplicationJobFilter"] = _APPLICATIONJOBFILTER
+DESCRIPTOR.message_types_by_name["TimeFilter"] = _TIMEFILTER
+DESCRIPTOR.message_types_by_name[
+    "CandidateAvailabilityFilter"
+] = _CANDIDATEAVAILABILITYFILTER
+DESCRIPTOR.message_types_by_name["PersonNameFilter"] = _PERSONNAMEFILTER
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+JobQuery = _reflection.GeneratedProtocolMessageType(
+    "JobQuery",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBQUERY,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  The query required to perform a search query.
+  
+  
+  Attributes:
+      query:
+          Optional. The query string that matches against the job title,
+          description, and location fields.  The maximum number of
+          allowed characters is 255.
+      companies:
+          Optional. This filter specifies the company entities to search
+          against.  If a value isn't specified, jobs are searched for
+          against all companies.  If multiple values are specified, jobs
+          are searched against the companies specified.  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".  At most 20 company
+          filters are allowed.
+      location_filters:
+          Optional. 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 [Location
+          Filter.distance\_in\_miles][google.cloud.talent.v4beta1.Locati
+          onFilter.distance\_in\_miles] parameter, the maximum provided
+          distance is used for all locations.  At most 5 location
+          filters are allowed.
+      job_categories:
+          Optional. 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.  If multiple values are
+          specified, jobs from any of the specified categories are
+          searched against.
+      commute_filter:
+          Optional. 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.Job
+          Query.location\_filters] is ignored.  Currently we don't
+          support sorting by commute time.
+      company_display_names:
+          Optional. This filter specifies the exact company [Company.dis
+          play\_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.  If multiple values are specified, jobs within the
+          search results may be associated with any of the specified
+          companies.  At most 20 company display name filters are
+          allowed.
+      compensation_filter:
+          Optional. This search filter is applied only to [Job.compensat
+          ion\_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.
+      custom_attribute_filter:
+          Optional. This filter specifies a structured syntax to match
+          against the [Job.custom\_attributes][google.cloud.talent.v4bet
+          a1.Job.custom\_attributes] marked as ``filterable``.  The
+          syntax for this expression is a subset of SQL syntax.
+          Supported operators are: ``=``, ``!=``, ``<``, ``<=``, ``>``,
+          and ``>=`` where the left of the operator is a custom field
+          key and the right of the operator is a number or a quoted
+          string. You must escape backslash (\\) and quote (")
+          characters.  Supported functions are ``LOWER([field_name])``
+          to perform a case insensitive match and
+          ``EMPTY([field_name])`` to filter on the existence of a key.
+          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 < 6000 bytes in length.
+          Sample Query: ``(LOWER(driving_license)="class \"a\"" OR
+          EMPTY(driving_license)) AND driving_years > 10``
+      disable_spell_check:
+          Optional. 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.
+      employment_types:
+          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].
+          If a value isn't specified, jobs in the search results
+          includes any employment type.  If multiple values are
+          specified, jobs in the search results include any of the
+          specified employment types.
+      language_codes:
+          Optional. 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 locale.  Language
+          codes 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>`__.  At most 10
+          language code filters are allowed.
+      publish_time_range:
+          Optional. Jobs published within a range specified by this
+          filter are searched against.
+      excluded_jobs:
+          Optional. This filter specifies a list of job names to be
+          excluded during search.  At most 400 excluded job names are
+          allowed.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.JobQuery)
+    ),
+)
+_sym_db.RegisterMessage(JobQuery)
+
+ProfileQuery = _reflection.GeneratedProtocolMessageType(
+    "ProfileQuery",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROFILEQUERY,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Filters to apply when performing the search query.
+  
+  
+  Attributes:
+      query:
+          Optional. Keywords to match any text fields of profiles.  For
+          example, "software engineer in Palo Alto".
+      location_filters:
+          Optional. The location filter specifies geo-regions containing
+          the profiles to search against.  One of [LocationFilter.addres
+          s][google.cloud.talent.v4beta1.LocationFilter.address] or [Loc
+          ationFilter.lat\_lng][google.cloud.talent.v4beta1.LocationFilt
+          er.lat\_lng] must be provided or an error is thrown. If both [
+          LocationFilter.address][google.cloud.talent.v4beta1.LocationFi
+          lter.address] and [LocationFilter.lat\_lng][google.cloud.talen
+          t.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.v4b
+          eta1.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.v4b
+          eta1.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.v4b
+          eta1.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.address
+          es][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.v4be
+          ta1.LocationFilter.negated] is specified, the result doesn't
+          contain profiles from that location.  If [LocationFilter.addre
+          ss][google.cloud.talent.v4beta1.LocationFilter.address] is
+          provided, the [LocationType][google.cloud.talent.v4beta1.Locat
+          ion.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.c
+          loud.talent.v4beta1.LocationFilter.address] cannot be
+          geocoded, the filter falls back to keyword search.  If the
+          detected [LocationType][google.cloud.talent.v4beta1.Location.L
+          ocationType] is [LocationType.SUB\_ADMINISTRATIVE\_AREA][googl
+          e.cloud.talent.v4beta1.Location.LocationType.SUB\_ADMINISTRATI
+          VE\_AREA], [LocationType.ADMINISTRATIVE\_AREA][google.cloud.ta
+          lent.v4beta1.Location.LocationType.ADMINISTRATIVE\_AREA], or [
+          LocationType.COUNTRY][google.cloud.talent.v4beta1.Location.Loc
+          ationType.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.distanc
+          e\_in\_miles][google.cloud.talent.v4beta1.LocationFilter.dista
+          nce\_in\_miles].  If [LocationFilter.address][google.cloud.tal
+          ent.v4beta1.LocationFilter.address] is provided, [LocationFilt
+          er.distance\_in\_miles][google.cloud.talent.v4beta1.LocationFi
+          lter.distance\_in\_miles] is the additional radius on top of
+          the radius of the location geocoded from [LocationFilter.addre
+          ss][google.cloud.talent.v4beta1.LocationFilter.address]. If [L
+          ocationFilter.lat\_lng][google.cloud.talent.v4beta1.LocationFi
+          lter.lat\_lng] is provided, [LocationFilter.distance\_in\_mile
+          s][google.cloud.talent.v4beta1.LocationFilter.distance\_in\_mi
+          les] is the only radius that is used.  [LocationFilter.distanc
+          e\_in\_miles][google.cloud.talent.v4beta1.LocationFilter.dista
+          nce\_in\_miles] is 10 by default. Note that the value of [Loca
+          tionFilter.distance\_in\_miles][google.cloud.talent.v4beta1.Lo
+          cationFilter.distance\_in\_miles] is 0 if it is unset, so the
+          server does not differentiate [LocationFilter.distance\_in\_mi
+          les][google.cloud.talent.v4beta1.LocationFilter.distance\_in\_
+          miles] that is explicitly set to 0 and [LocationFilter.distanc
+          e\_in\_miles][google.cloud.talent.v4beta1.LocationFilter.dista
+          nce\_in\_miles] that is not set. Which means that if [Location
+          Filter.distance\_in\_miles][google.cloud.talent.v4beta1.Locati
+          onFilter.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.distanc
+          e\_in\_miles] which is 10. To work around this and effectively
+          set [LocationFilter.distance\_in\_miles][google.cloud.talent.v
+          4beta1.LocationFilter.distance\_in\_miles] to 0, we recommend
+          setting [LocationFilter.distance\_in\_miles][google.cloud.tale
+          nt.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.distan
+          ce\_in\_miles] is negative, an error is thrown.
+      job_title_filters:
+          Optional. 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.JobTit
+          leFilter.negated] is specified, the result won't contain
+          profiles with the job titles.  For example, search for
+          profiles with a job title "Product Manager".
+      employer_filters:
+          Optional. Employer filter specifies employers of profiles to
+          match on.  If an employer filter isn't specified, profiles
+          with any employers are retrieved.  If multiple employer
+          filters are specified, profiles with any matching employers
+          are retrieved.  If [EmployerFilter.negated][google.cloud.talen
+          t.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".
+      education_filters:
+          Optional. Education filter specifies education of profiles to
+          match on.  If an education filter isn't specified, profiles
+          with any education are retrieved.  If multiple education
+          filters are specified, profiles that match any education
+          filters are retrieved.  If [EducationFilter.negated][google.cl
+          oud.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.
+      skill_filters:
+          Optional. 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.v4bet
+          a1.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.
+      work_experience_filter:
+          Optional. 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.  If multiple work experience filters
+          are specified, profiles that match any work experience filters
+          are retrieved.  For example, search for profiles with 10 years
+          of work experience.
+      time_filters:
+          Optional. Time filter specifies the create/update timestamp of
+          the profiles to match on.  For example, search for profiles
+          created since "2018-1-1".
+      hirable_filter:
+          Optional. The hirable filter specifies the profile's hirable
+          status to match on.
+      application_date_filters:
+          Optional. The application date filters specify application
+          date ranges to match on.
+      application_outcome_notes_filters:
+          Optional. The application outcome notes filters specify the
+          notes for the outcome of the job application.
+      application_job_filters:
+          Optional. The application job filters specify the job applied
+          for in the application.
+      custom_attribute_filter:
+          Optional. This filter specifies a structured syntax to match
+          against the [Profile.custom\_attributes][google.cloud.talent.v
+          4beta1.Profile.custom\_attributes] that are marked as
+          ``filterable``.  The syntax for this expression is a subset of
+          Google SQL syntax.  String custom attributes: supported
+          operators are =, != where the left of the operator is a custom
+          field key and the right of the operator is a string
+          (surrounded by quotes) value.  Numeric custom attributes:
+          Supported operators are '>', '<' or '=' operators where the
+          left of the operator is a custom field key and the right of
+          the operator is a numeric value.  Supported functions are
+          LOWER() to perform case insensitive match and EMPTY() to
+          filter on the existence of a key.  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"), and there can be
+          a maximum of 50 comparisons/functions in the expression. The
+          expression must be < 2000 characters in length.  Sample Query:
+          (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1))
+      candidate_availability_filter:
+          Optional. The candidate availability filter which filters
+          based on availability signals.  Signal 1: Number of days since
+          most recent job application. See [Availability.JobApplicationA
+          vailabilitySignal][google.cloud.talent.v4beta1.Availability.Jo
+          bApplicationAvailabilitySignal] for the details of this
+          signal.  Signal 2: Number of days since last profile update.
+          See [Availability.ProfileUpdateAvailabilitySignal][google.clou
+          d.talent.v4beta1.Availability.ProfileUpdateAvailabilitySignal]
+          for the details of this signal.  The candidate 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.
+      person_name_filters:
+          Optional. 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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ProfileQuery)
+    ),
+)
+_sym_db.RegisterMessage(ProfileQuery)
+
+LocationFilter = _reflection.GeneratedProtocolMessageType(
+    "LocationFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Geographic region of the search.
+  
+  
+  Attributes:
+      address:
+          Optional. The address name, such as "Mountain View" or "Bay
+          Area".
+      region_code:
+          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".  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 ht
+          tp://www.unicode.org/cldr/charts/30/supplemental/territory\_in
+          formation.html for details. Example: "CH" for Switzerland.
+          Note that this filter is not applicable for Profile Search
+          related queries.
+      lat_lng:
+          Optional. The latitude and longitude of the geographic center
+          to search from. This field is ignored if ``address`` is
+          provided.
+      distance_in_miles:
+          Optional. 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.
+      telecommute_preference:
+          Optional. 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.t
+          alent.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.LocationFi
+          lter.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 filter to search for a
+          combination of job locations, 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.
+      negated:
+          Optional. Whether to apply negation to the filter so profiles
+          matching the filter are excluded.  Currently only supported in
+          profile search.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.LocationFilter)
+    ),
+)
+_sym_db.RegisterMessage(LocationFilter)
+
+CompensationFilter = _reflection.GeneratedProtocolMessageType(
+    "CompensationFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMPENSATIONFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Filter on job compensation type and amount.
+  
+  
+  Attributes:
+      type:
+          Required. Type of filter.
+      units:
+          Required. Specify desired ``base compensation entry's`` [Compe
+          nsationInfo.CompensationUnit][google.cloud.talent.v4beta1.Comp
+          ensationInfo.CompensationUnit].
+      range:
+          Optional. Compensation range.
+      include_jobs_with_unspecified_compensation_range:
+          Optional. If set to true, jobs with unspecified compensation
+          range fields are included.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CompensationFilter)
+    ),
+)
+_sym_db.RegisterMessage(CompensationFilter)
+
+CommuteFilter = _reflection.GeneratedProtocolMessageType(
+    "CommuteFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COMMUTEFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Parameters needed for commute search.
+  
+  
+  Attributes:
+      commute_method:
+          Required. The method of transportation for which to calculate
+          the commute time.
+      start_coordinates:
+          Required. The latitude and longitude of the location from
+          which to calculate the commute time.
+      travel_duration:
+          Required. The maximum travel time in seconds. The maximum
+          allowed value is ``3600s`` (one hour). Format is ``123s``.
+      allow_imprecise_addresses:
+          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.
+      traffic_option:
+          Optional.  Traffic factor to take into account while searching
+          by commute.
+      road_traffic:
+          Optional. Specifies the traffic density to use when
+          calculating commute time.
+      departure_time:
+          Optional. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CommuteFilter)
+    ),
+)
+_sym_db.RegisterMessage(CommuteFilter)
+
+JobTitleFilter = _reflection.GeneratedProtocolMessageType(
+    "JobTitleFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_JOBTITLEFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Job title of the search.
+  
+  
+  Attributes:
+      job_title:
+          Required. The job title, for example, "Software engineer", or
+          "Product manager".
+      negated:
+          Optional. Whether to apply negation to the filter so profiles
+          matching the filter are excluded.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.JobTitleFilter)
+    ),
+)
+_sym_db.RegisterMessage(JobTitleFilter)
+
+SkillFilter = _reflection.GeneratedProtocolMessageType(
+    "SkillFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SKILLFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Skill filter of the search.
+  
+  
+  Attributes:
+      skill:
+          Required. The skill name. For example, "java", "j2ee", and so
+          on.
+      negated:
+          Optional. Whether to apply negation to the filter so profiles
+          matching the filter are excluded.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SkillFilter)
+    ),
+)
+_sym_db.RegisterMessage(SkillFilter)
+
+EmployerFilter = _reflection.GeneratedProtocolMessageType(
+    "EmployerFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EMPLOYERFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Employer filter of the search.
+  
+  
+  Attributes:
+      employer:
+          Required. The name of the employer, for example "Google",
+          "Alphabet".
+      mode:
+          Optional. Define set of [EmploymentRecord][google.cloud.talent
+          .v4beta1.EmploymentRecord]s to search against.  Defaults to [E
+          mployerFilterMode.ALL\_EMPLOYMENT\_RECORDS][google.cloud.talen
+          t.v4beta1.EmployerFilter.EmployerFilterMode.ALL\_EMPLOYMENT\_R
+          ECORDS].
+      negated:
+          Optional. Whether to apply negation to the filter so profiles
+          matching the filter is excluded.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.EmployerFilter)
+    ),
+)
+_sym_db.RegisterMessage(EmployerFilter)
+
+EducationFilter = _reflection.GeneratedProtocolMessageType(
+    "EducationFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EDUCATIONFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Education filter of the search.
+  
+  
+  Attributes:
+      school:
+          Optional. The school name. For example "MIT", "University of
+          California, Berkeley".
+      field_of_study:
+          Optional. The field of study. This is to search against value
+          provided in [Degree.fields\_of\_study][google.cloud.talent.v4b
+          eta1.Degree.fields\_of\_study]. For example "Computer
+          Science", "Mathematics".
+      degree_type:
+          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.
+      negated:
+          Optional. Whether to apply negation to the filter so profiles
+          matching the filter is excluded.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.EducationFilter)
+    ),
+)
+_sym_db.RegisterMessage(EducationFilter)
+
+WorkExperienceFilter = _reflection.GeneratedProtocolMessageType(
+    "WorkExperienceFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORKEXPERIENCEFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""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].
+  
+  
+  Attributes:
+      min_experience:
+          Optional. The minimum duration of the work experience
+          (inclusive).
+      max_experience:
+          Optional. The maximum duration of the work experience
+          (exclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.WorkExperienceFilter)
+    ),
+)
+_sym_db.RegisterMessage(WorkExperienceFilter)
+
+ApplicationDateFilter = _reflection.GeneratedProtocolMessageType(
+    "ApplicationDateFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPLICATIONDATEFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      start_date:
+          Optional. Start date. If it's missing, The API matches
+          profiles with application date not after the end date.
+      end_date:
+          Optional. End date. If it's missing, The API matches profiles
+          with application date not before the start date.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ApplicationDateFilter)
+    ),
+)
+_sym_db.RegisterMessage(ApplicationDateFilter)
+
+ApplicationOutcomeNotesFilter = _reflection.GeneratedProtocolMessageType(
+    "ApplicationOutcomeNotesFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPLICATIONOUTCOMENOTESFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Outcome Notes Filter.
+  
+  
+  Attributes:
+      outcome_notes:
+          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.
+      negated:
+          Optional. If true, The API excludes all candidates with any [A
+          pplication.outcome\_notes][google.cloud.talent.v4beta1.Applica
+          tion.outcome\_notes] matching the outcome reason specified in
+          the filter.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter)
+    ),
+)
+_sym_db.RegisterMessage(ApplicationOutcomeNotesFilter)
+
+ApplicationJobFilter = _reflection.GeneratedProtocolMessageType(
+    "ApplicationJobFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPLICATIONJOBFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Filter on the job information of Application.
+  
+  
+  Attributes:
+      job_requisition_id:
+          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.
+      job_title:
+          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.
+      negated:
+          Optional. If true, the API excludes all profiles with any
+          [Application.job][google.cloud.talent.v4beta1.Application.job]
+          matching the filters.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ApplicationJobFilter)
+    ),
+)
+_sym_db.RegisterMessage(ApplicationJobFilter)
+
+TimeFilter = _reflection.GeneratedProtocolMessageType(
+    "TimeFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMEFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Filter on create timestamp or update timestamp of profiles.
+  
+  
+  Attributes:
+      start_time:
+          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.
+      end_time:
+          Optional. End timestamp, matching profiles with the end time.
+          If this field missing, The API matches profiles with create /
+          update timestamp after the start timestamp.
+      time_field:
+          Optional. Specifies which time field to filter profiles.
+          Defaults to [TimeField.CREATE\_TIME][google.cloud.talent.v4bet
+          a1.TimeFilter.TimeField.CREATE\_TIME].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.TimeFilter)
+    ),
+)
+_sym_db.RegisterMessage(TimeFilter)
+
+CandidateAvailabilityFilter = _reflection.GeneratedProtocolMessageType(
+    "CandidateAvailabilityFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANDIDATEAVAILABILITYFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only
+  
+  Filter on availability signals.
+  
+  
+  Attributes:
+      negated:
+          Optional. It is false by default. If true, API excludes all
+          the potential available profiles.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CandidateAvailabilityFilter)
+    ),
+)
+_sym_db.RegisterMessage(CandidateAvailabilityFilter)
+
+PersonNameFilter = _reflection.GeneratedProtocolMessageType(
+    "PersonNameFilter",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PERSONNAMEFILTER,
+        __module__="google.cloud.talent_v4beta1.proto.filters_pb2",
+        __doc__="""Input only.
+  
+  Filter on person name.
+  
+  
+  Attributes:
+      person_name:
+          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.format
+          ted\_name].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.PersonNameFilter)
+    ),
+)
+_sym_db.RegisterMessage(PersonNameFilter)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/filters_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/filters_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/filters_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/histogram.proto b/talent/google/cloud/talent_v4beta1/proto/histogram.proto
new file mode 100644
index 000000000000..91183fb03c4c
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/histogram.proto
@@ -0,0 +1,63 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+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.
+  string histogram_query = 1;
+}
+
+// Output only.
+//
+// Histogram result that matches
+// [HistogramQuery][google.cloud.talent.v4beta1.HistogramQuery] specified in
+// searches.
+message HistogramQueryResult {
+  // Requested histogram expression.
+  string histogram_query = 1;
+
+  // A map from the values of the facet associated with distinct values to the
+  // number of matching entries with corresponding value.
+  //
+  // The key format is:
+  //
+  // * (for string histogram) string values stored in the field.
+  // * (for named numeric bucket) name specified in `bucket()` function, like
+  //   for `bucket(0, MAX, "non-negative")`, the key will be `non-negative`.
+  // * (for anonymous numeric bucket) range formatted as `<low>-<high>`, for
+  //   example, `0-1000`, `MIN-0`, and `0-MAX`.
+  map<string, int64> histogram = 2;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/histogram_pb2.py b/talent/google/cloud/talent_v4beta1/proto/histogram_pb2.py
new file mode 100644
index 000000000000..c56bda26312c
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/histogram_pb2.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/histogram.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/histogram.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\016HistogramProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/talent_v4beta1/proto/histogram.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto")\n\x0eHistogramQuery\x12\x17\n\x0fhistogram_query\x18\x01 \x01(\t"\xb6\x01\n\x14HistogramQueryResult\x12\x17\n\x0fhistogram_query\x18\x01 \x01(\t\x12S\n\thistogram\x18\x02 \x03(\x0b\x32@.google.cloud.talent.v4beta1.HistogramQueryResult.HistogramEntry\x1a\x30\n\x0eHistogramEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x03:\x02\x38\x01\x42|\n\x1f\x63om.google.cloud.talent.v4beta1B\x0eHistogramProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_HISTOGRAMQUERY = _descriptor.Descriptor(
+    name="HistogramQuery",
+    full_name="google.cloud.talent.v4beta1.HistogramQuery",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="histogram_query",
+            full_name="google.cloud.talent.v4beta1.HistogramQuery.histogram_query",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=112,
+    serialized_end=153,
+)
+
+
+_HISTOGRAMQUERYRESULT_HISTOGRAMENTRY = _descriptor.Descriptor(
+    name="HistogramEntry",
+    full_name="google.cloud.talent.v4beta1.HistogramQueryResult.HistogramEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.talent.v4beta1.HistogramQueryResult.HistogramEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.talent.v4beta1.HistogramQueryResult.HistogramEntry.value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=290,
+    serialized_end=338,
+)
+
+_HISTOGRAMQUERYRESULT = _descriptor.Descriptor(
+    name="HistogramQueryResult",
+    full_name="google.cloud.talent.v4beta1.HistogramQueryResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="histogram_query",
+            full_name="google.cloud.talent.v4beta1.HistogramQueryResult.histogram_query",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="histogram",
+            full_name="google.cloud.talent.v4beta1.HistogramQueryResult.histogram",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HISTOGRAMQUERYRESULT_HISTOGRAMENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=156,
+    serialized_end=338,
+)
+
+_HISTOGRAMQUERYRESULT_HISTOGRAMENTRY.containing_type = _HISTOGRAMQUERYRESULT
+_HISTOGRAMQUERYRESULT.fields_by_name[
+    "histogram"
+].message_type = _HISTOGRAMQUERYRESULT_HISTOGRAMENTRY
+DESCRIPTOR.message_types_by_name["HistogramQuery"] = _HISTOGRAMQUERY
+DESCRIPTOR.message_types_by_name["HistogramQueryResult"] = _HISTOGRAMQUERYRESULT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+HistogramQuery = _reflection.GeneratedProtocolMessageType(
+    "HistogramQuery",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_HISTOGRAMQUERY,
+        __module__="google.cloud.talent_v4beta1.proto.histogram_pb2",
+        __doc__="""Input Only.
+  
+  The histogram request.
+  
+  
+  Attributes:
+      histogram_query:
+          An expression specifies a histogram request against matching
+          resources (for example, jobs, profiles) for searches.  See [Se
+          archJobsRequest.histogram\_queries][google.cloud.talent.v4beta
+          1.SearchJobsRequest.histogram\_queries] and [SearchProfilesReq
+          uest.histogram\_queries][google.cloud.talent.v4beta1.SearchPro
+          filesRequest.histogram\_queries] for details about syntax.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.HistogramQuery)
+    ),
+)
+_sym_db.RegisterMessage(HistogramQuery)
+
+HistogramQueryResult = _reflection.GeneratedProtocolMessageType(
+    "HistogramQueryResult",
+    (_message.Message,),
+    dict(
+        HistogramEntry=_reflection.GeneratedProtocolMessageType(
+            "HistogramEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HISTOGRAMQUERYRESULT_HISTOGRAMENTRY,
+                __module__="google.cloud.talent_v4beta1.proto.histogram_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.HistogramQueryResult.HistogramEntry)
+            ),
+        ),
+        DESCRIPTOR=_HISTOGRAMQUERYRESULT,
+        __module__="google.cloud.talent_v4beta1.proto.histogram_pb2",
+        __doc__="""Output only.
+  
+  Histogram result that matches
+  [HistogramQuery][google.cloud.talent.v4beta1.HistogramQuery] specified
+  in searches.
+  
+  
+  Attributes:
+      histogram_query:
+          Requested histogram expression.
+      histogram:
+          A map from the values of the facet associated with distinct
+          values to the number of matching entries with corresponding
+          value.  The key format is:  -  (for string histogram) string
+          values stored in the field. -  (for named numeric bucket) name
+          specified in ``bucket()`` function,    like for ``bucket(0,
+          MAX, "non-negative")``, the key will be    ``non-negative``. -
+          (for anonymous numeric bucket) range formatted as
+          ``<low>-<high>``,    for example, ``0-1000``, ``MIN-0``, and
+          ``0-MAX``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.HistogramQueryResult)
+    ),
+)
+_sym_db.RegisterMessage(HistogramQueryResult)
+_sym_db.RegisterMessage(HistogramQueryResult.HistogramEntry)
+
+
+DESCRIPTOR._options = None
+_HISTOGRAMQUERYRESULT_HISTOGRAMENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/histogram_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/histogram_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/histogram_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/job.proto b/talent/google/cloud/talent_v4beta1/proto/job.proto
new file mode 100644
index 000000000000..5c0837d093ec
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/job.proto
@@ -0,0 +1,377 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/postal_address.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "JobResourceProto";
+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.
+message Job {
+  // Application related details of a job posting.
+  message ApplicationInfo {
+    // Optional. 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.
+    //
+    // 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 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.
+    //
+    // 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].
+    //
+    // [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].
+    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
+    // more precise address for the job.
+    bool disable_street_address_resolution = 1;
+
+    // Optional. Option for job HTML content sanitization. Applied fields are:
+    //
+    // * description
+    // * applicationInfo.instruction
+    // * incentives
+    // * qualifications
+    // * responsibilities
+    //
+    // 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].
+    HtmlSanitization html_sanitization = 2;
+  }
+
+  // Required during job update.
+  //
+  // The resource name for the job. This is generated by the service when a
+  // 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".
+  //
+  // Tenant id is optional and the default tenant is used if unspecified, for
+  // example, "projects/api-test-project/jobs/1234".
+  //
+  // 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.
+  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].
+  //
+  // The maximum number of allowed characters is 255.
+  string requisition_id = 3;
+
+  // Required. The title of the job, such as "Software Engineer"
+  //
+  // The maximum number of allowed characters is 500.
+  string title = 4;
+
+  // 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;
+
+  // Optional but strongly recommended for the best service experience.
+  //
+  // Location(s) where the employer is looking to hire for this job posting.
+  //
+  // Specifying the full street address(es) of the hiring location enables
+  // better API results, especially job searches by commute time.
+  //
+  // 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.
+  //
+  // The maximum number of allowed characters is 500.
+  repeated string addresses = 6;
+
+  // Optional. Job application information.
+  ApplicationInfo application_info = 7;
+
+  // Optional. 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.
+  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.
+  //
+  // 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
+  // KEY_1_LIKE_THIS.
+  //
+  // At most 100 filterable and at most 100 unfilterable keys are supported.
+  // For filterable `string_values`, across all keys at most 200 values are
+  // allowed, with each string no more than 255 characters. For unfilterable
+  // `string_values`, the maximum total size of `string_values` across all keys
+  // is 50KB.
+  map<string, CustomAttribute> custom_attributes = 10;
+
+  // Optional. 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 maximum number of allowed characters is 255.
+  string department = 12;
+
+  // Optional. 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
+  // 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
+  // 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".
+  // For more information, see
+  // [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'.
+  string language_code = 15;
+
+  // Optional. 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.
+  // 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
+  // jobs with a promotionValue >0 are returned in a FEATURED_JOB_SEARCH.
+  //
+  // 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
+  // job. 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.
+  //
+  // 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.
+  //
+  // 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 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.
+  PostingRegion posting_region = 20;
+
+  // Deprecated. The job is only visible to the owner.
+  //
+  // 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.
+  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.
+  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.
+  google.protobuf.Timestamp posting_publish_time = 24;
+
+  // Optional but 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].
+  //
+  // 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
+  // open jobs over previous 7 days. If this threshold is exceeded,
+  // expired jobs are cleaned out in order of earliest expire time.
+  // Expired jobs are no longer accessible after they are cleaned
+  // out.
+  //
+  // Invalid timestamps are ignored, and treated as expire time not provided.
+  //
+  // 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.
+  //
+  // 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
+  // example, if the job was created on 2017/01/01 13:00AM UTC with an
+  // 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.
+  google.protobuf.Timestamp posting_expire_time = 25;
+
+  // Output only. The timestamp when this job posting was created.
+  google.protobuf.Timestamp posting_create_time = 26;
+
+  // Output only. The timestamp when this job posting was last updated.
+  google.protobuf.Timestamp posting_update_time = 27;
+
+  // Output only. Display name of the company listing the job.
+  string company_display_name = 28;
+
+  // Output only. Derived details about the job posting.
+  DerivedInfo derived_info = 29;
+
+  // Optional. Options for job processing.
+  ProcessingOptions processing_options = 30;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/job_pb2.py b/talent/google/cloud/talent_v4beta1/proto/job_pb2.py
new file mode 100644
index 000000000000..1d3e43afd8d2
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/job_pb2.py
@@ -0,0 +1,1278 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/job.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.type import postal_address_pb2 as google_dot_type_dot_postal__address__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/job.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\020JobResourceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        "\n+google/cloud/talent_v4beta1/proto/job.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a google/type/postal_address.proto\"\xab\x0e\n\x03Job\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07\x63ompany\x18\x02 \x01(\t\x12\x16\n\x0erequisition_id\x18\x03 \x01(\t\x12\r\n\x05title\x18\x04 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x05 \x01(\t\x12\x11\n\taddresses\x18\x06 \x03(\t\x12J\n\x10\x61pplication_info\x18\x07 \x01(\x0b\x32\x30.google.cloud.talent.v4beta1.Job.ApplicationInfo\x12=\n\x0cjob_benefits\x18\x08 \x03(\x0e\x32'.google.cloud.talent.v4beta1.JobBenefit\x12H\n\x11\x63ompensation_info\x18\t \x01(\x0b\x32-.google.cloud.talent.v4beta1.CompensationInfo\x12Q\n\x11\x63ustom_attributes\x18\n \x03(\x0b\x32\x36.google.cloud.talent.v4beta1.Job.CustomAttributesEntry\x12=\n\x0c\x64\x65gree_types\x18\x0b \x03(\x0e\x32'.google.cloud.talent.v4beta1.DegreeType\x12\x12\n\ndepartment\x18\x0c \x01(\t\x12\x45\n\x10\x65mployment_types\x18\r \x03(\x0e\x32+.google.cloud.talent.v4beta1.EmploymentType\x12\x12\n\nincentives\x18\x0e \x01(\t\x12\x15\n\rlanguage_code\x18\x0f \x01(\t\x12\x38\n\tjob_level\x18\x10 \x01(\x0e\x32%.google.cloud.talent.v4beta1.JobLevel\x12\x17\n\x0fpromotion_value\x18\x11 \x01(\x05\x12\x16\n\x0equalifications\x18\x12 \x01(\t\x12\x18\n\x10responsibilities\x18\x13 \x01(\t\x12\x42\n\x0eposting_region\x18\x14 \x01(\x0e\x32*.google.cloud.talent.v4beta1.PostingRegion\x12?\n\nvisibility\x18\x15 \x01(\x0e\x32'.google.cloud.talent.v4beta1.VisibilityB\x02\x18\x01\x12\x32\n\x0ejob_start_time\x18\x16 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x30\n\x0cjob_end_time\x18\x17 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x38\n\x14posting_publish_time\x18\x18 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x37\n\x13posting_expire_time\x18\x19 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x37\n\x13posting_create_time\x18\x1a \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x37\n\x13posting_update_time\x18\x1b \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1c\n\x14\x63ompany_display_name\x18\x1c \x01(\t\x12\x42\n\x0c\x64\x65rived_info\x18\x1d \x01(\x0b\x32,.google.cloud.talent.v4beta1.Job.DerivedInfo\x12N\n\x12processing_options\x18\x1e \x01(\x0b\x32\x32.google.cloud.talent.v4beta1.Job.ProcessingOptions\x1a\x44\n\x0f\x41pplicationInfo\x12\x0e\n\x06\x65mails\x18\x01 \x03(\t\x12\x13\n\x0binstruction\x18\x02 \x01(\t\x12\x0c\n\x04uris\x18\x03 \x03(\t\x1a\x89\x01\n\x0b\x44\x65rivedInfo\x12\x38\n\tlocations\x18\x01 \x03(\x0b\x32%.google.cloud.talent.v4beta1.Location\x12@\n\x0ejob_categories\x18\x03 \x03(\x0e\x32(.google.cloud.talent.v4beta1.JobCategory\x1a\x88\x01\n\x11ProcessingOptions\x12)\n!disable_street_address_resolution\x18\x01 \x01(\x08\x12H\n\x11html_sanitization\x18\x02 \x01(\x0e\x32-.google.cloud.talent.v4beta1.HtmlSanitization\x1a\x65\n\x15\x43ustomAttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12;\n\x05value\x18\x02 \x01(\x0b\x32,.google.cloud.talent.v4beta1.CustomAttribute:\x02\x38\x01\x42~\n\x1f\x63om.google.cloud.talent.v4beta1B\x10JobResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3"
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_type_dot_postal__address__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_JOB_APPLICATIONINFO = _descriptor.Descriptor(
+    name="ApplicationInfo",
+    full_name="google.cloud.talent.v4beta1.Job.ApplicationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="emails",
+            full_name="google.cloud.talent.v4beta1.Job.ApplicationInfo.emails",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instruction",
+            full_name="google.cloud.talent.v4beta1.Job.ApplicationInfo.instruction",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uris",
+            full_name="google.cloud.talent.v4beta1.Job.ApplicationInfo.uris",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1607,
+    serialized_end=1675,
+)
+
+_JOB_DERIVEDINFO = _descriptor.Descriptor(
+    name="DerivedInfo",
+    full_name="google.cloud.talent.v4beta1.Job.DerivedInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.talent.v4beta1.Job.DerivedInfo.locations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_categories",
+            full_name="google.cloud.talent.v4beta1.Job.DerivedInfo.job_categories",
+            index=1,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1678,
+    serialized_end=1815,
+)
+
+_JOB_PROCESSINGOPTIONS = _descriptor.Descriptor(
+    name="ProcessingOptions",
+    full_name="google.cloud.talent.v4beta1.Job.ProcessingOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="disable_street_address_resolution",
+            full_name="google.cloud.talent.v4beta1.Job.ProcessingOptions.disable_street_address_resolution",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="html_sanitization",
+            full_name="google.cloud.talent.v4beta1.Job.ProcessingOptions.html_sanitization",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1818,
+    serialized_end=1954,
+)
+
+_JOB_CUSTOMATTRIBUTESENTRY = _descriptor.Descriptor(
+    name="CustomAttributesEntry",
+    full_name="google.cloud.talent.v4beta1.Job.CustomAttributesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.talent.v4beta1.Job.CustomAttributesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.talent.v4beta1.Job.CustomAttributesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1956,
+    serialized_end=2057,
+)
+
+_JOB = _descriptor.Descriptor(
+    name="Job",
+    full_name="google.cloud.talent.v4beta1.Job",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.Job.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="company",
+            full_name="google.cloud.talent.v4beta1.Job.company",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="requisition_id",
+            full_name="google.cloud.talent.v4beta1.Job.requisition_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="title",
+            full_name="google.cloud.talent.v4beta1.Job.title",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.talent.v4beta1.Job.description",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="addresses",
+            full_name="google.cloud.talent.v4beta1.Job.addresses",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="application_info",
+            full_name="google.cloud.talent.v4beta1.Job.application_info",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_benefits",
+            full_name="google.cloud.talent.v4beta1.Job.job_benefits",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compensation_info",
+            full_name="google.cloud.talent.v4beta1.Job.compensation_info",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_attributes",
+            full_name="google.cloud.talent.v4beta1.Job.custom_attributes",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="degree_types",
+            full_name="google.cloud.talent.v4beta1.Job.degree_types",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="department",
+            full_name="google.cloud.talent.v4beta1.Job.department",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="employment_types",
+            full_name="google.cloud.talent.v4beta1.Job.employment_types",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="incentives",
+            full_name="google.cloud.talent.v4beta1.Job.incentives",
+            index=13,
+            number=14,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.talent.v4beta1.Job.language_code",
+            index=14,
+            number=15,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_level",
+            full_name="google.cloud.talent.v4beta1.Job.job_level",
+            index=15,
+            number=16,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="promotion_value",
+            full_name="google.cloud.talent.v4beta1.Job.promotion_value",
+            index=16,
+            number=17,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="qualifications",
+            full_name="google.cloud.talent.v4beta1.Job.qualifications",
+            index=17,
+            number=18,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="responsibilities",
+            full_name="google.cloud.talent.v4beta1.Job.responsibilities",
+            index=18,
+            number=19,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posting_region",
+            full_name="google.cloud.talent.v4beta1.Job.posting_region",
+            index=19,
+            number=20,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="visibility",
+            full_name="google.cloud.talent.v4beta1.Job.visibility",
+            index=20,
+            number=21,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_start_time",
+            full_name="google.cloud.talent.v4beta1.Job.job_start_time",
+            index=21,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_end_time",
+            full_name="google.cloud.talent.v4beta1.Job.job_end_time",
+            index=22,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posting_publish_time",
+            full_name="google.cloud.talent.v4beta1.Job.posting_publish_time",
+            index=23,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posting_expire_time",
+            full_name="google.cloud.talent.v4beta1.Job.posting_expire_time",
+            index=24,
+            number=25,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posting_create_time",
+            full_name="google.cloud.talent.v4beta1.Job.posting_create_time",
+            index=25,
+            number=26,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="posting_update_time",
+            full_name="google.cloud.talent.v4beta1.Job.posting_update_time",
+            index=26,
+            number=27,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="company_display_name",
+            full_name="google.cloud.talent.v4beta1.Job.company_display_name",
+            index=27,
+            number=28,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="derived_info",
+            full_name="google.cloud.talent.v4beta1.Job.derived_info",
+            index=28,
+            number=29,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="processing_options",
+            full_name="google.cloud.talent.v4beta1.Job.processing_options",
+            index=29,
+            number=30,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _JOB_APPLICATIONINFO,
+        _JOB_DERIVEDINFO,
+        _JOB_PROCESSINGOPTIONS,
+        _JOB_CUSTOMATTRIBUTESENTRY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=222,
+    serialized_end=2057,
+)
+
+_JOB_APPLICATIONINFO.containing_type = _JOB
+_JOB_DERIVEDINFO.fields_by_name[
+    "locations"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._LOCATION
+)
+_JOB_DERIVEDINFO.fields_by_name[
+    "job_categories"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._JOBCATEGORY
+)
+_JOB_DERIVEDINFO.containing_type = _JOB
+_JOB_PROCESSINGOPTIONS.fields_by_name[
+    "html_sanitization"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._HTMLSANITIZATION
+)
+_JOB_PROCESSINGOPTIONS.containing_type = _JOB
+_JOB_CUSTOMATTRIBUTESENTRY.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CUSTOMATTRIBUTE
+)
+_JOB_CUSTOMATTRIBUTESENTRY.containing_type = _JOB
+_JOB.fields_by_name["application_info"].message_type = _JOB_APPLICATIONINFO
+_JOB.fields_by_name[
+    "job_benefits"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._JOBBENEFIT
+_JOB.fields_by_name[
+    "compensation_info"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._COMPENSATIONINFO
+)
+_JOB.fields_by_name["custom_attributes"].message_type = _JOB_CUSTOMATTRIBUTESENTRY
+_JOB.fields_by_name[
+    "degree_types"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._DEGREETYPE
+_JOB.fields_by_name[
+    "employment_types"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._EMPLOYMENTTYPE
+)
+_JOB.fields_by_name[
+    "job_level"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._JOBLEVEL
+_JOB.fields_by_name[
+    "posting_region"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._POSTINGREGION
+)
+_JOB.fields_by_name[
+    "visibility"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._VISIBILITY
+_JOB.fields_by_name[
+    "job_start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "job_end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "posting_publish_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "posting_expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "posting_create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name[
+    "posting_update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_JOB.fields_by_name["derived_info"].message_type = _JOB_DERIVEDINFO
+_JOB.fields_by_name["processing_options"].message_type = _JOB_PROCESSINGOPTIONS
+DESCRIPTOR.message_types_by_name["Job"] = _JOB
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Job = _reflection.GeneratedProtocolMessageType(
+    "Job",
+    (_message.Message,),
+    dict(
+        ApplicationInfo=_reflection.GeneratedProtocolMessageType(
+            "ApplicationInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOB_APPLICATIONINFO,
+                __module__="google.cloud.talent_v4beta1.proto.job_pb2",
+                __doc__="""Application related details of a job posting.
+    
+    
+    Attributes:
+        emails:
+            Optional. 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.
+        instruction:
+            Optional. 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.  The maximum number of allowed
+            characters is 3,000.
+        uris:
+            Optional. 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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Job.ApplicationInfo)
+            ),
+        ),
+        DerivedInfo=_reflection.GeneratedProtocolMessageType(
+            "DerivedInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOB_DERIVEDINFO,
+                __module__="google.cloud.talent_v4beta1.proto.job_pb2",
+                __doc__="""Output only.
+    
+    Derived details about the job posting.
+    
+    
+    Attributes:
+        locations:
+            Structured locations of the job, resolved from
+            [Job.addresses][google.cloud.talent.v4beta1.Job.addresses].  [
+            locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locatio
+            ns] are exactly matched to
+            [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] in
+            the same order.
+        job_categories:
+            Job categories derived from
+            [Job.title][google.cloud.talent.v4beta1.Job.title] and [Job.de
+            scription][google.cloud.talent.v4beta1.Job.description].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Job.DerivedInfo)
+            ),
+        ),
+        ProcessingOptions=_reflection.GeneratedProtocolMessageType(
+            "ProcessingOptions",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOB_PROCESSINGOPTIONS,
+                __module__="google.cloud.talent_v4beta1.proto.job_pb2",
+                __doc__="""Input only.
+    
+    Options for job processing.
+    
+    
+    Attributes:
+        disable_street_address_resolution:
+            Optional. If set to ``true``, the service does not attempt to
+            resolve a more precise address for the job.
+        html_sanitization:
+            Optional. Option for job HTML content sanitization. Applied
+            fields are:  -  description -  applicationInfo.instruction -
+            incentives -  qualifications -  responsibilities  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\_ONL
+            Y].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Job.ProcessingOptions)
+            ),
+        ),
+        CustomAttributesEntry=_reflection.GeneratedProtocolMessageType(
+            "CustomAttributesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOB_CUSTOMATTRIBUTESENTRY,
+                __module__="google.cloud.talent_v4beta1.proto.job_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Job.CustomAttributesEntry)
+            ),
+        ),
+        DESCRIPTOR=_JOB,
+        __module__="google.cloud.talent_v4beta1.proto.job_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      name:
+          Required during job update.  The resource name for the job.
+          This is generated by the service when a 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".  Tenant id is optional and the
+          default tenant is used if unspecified, for example,
+          "projects/api-test-project/jobs/1234".  Use of this field in
+          job queries and API calls is preferred over the use of [requis
+          ition\_id][google.cloud.talent.v4beta1.Job.requisition\_id]
+          since this value is unique.
+      company:
+          Required. The resource name of the company listing the job.
+          The format is "projects/{project\_id}/tenants/{tenant\_id}/com
+          panies/{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".
+      requisition_id:
+          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\_co
+          de][google.cloud.talent.v4beta1.Job.language\_code] and [requi
+          sition\_id][google.cloud.talent.v4beta1.Job.requisition\_id].
+          The maximum number of allowed characters is 255.
+      title:
+          Required. The title of the job, such as "Software Engineer"
+          The maximum number of allowed characters is 500.
+      description:
+          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.respons
+          ibilities], [qualifications][google.cloud.talent.v4beta1.Job.q
+          ualifications], 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.
+      addresses:
+          Optional but strongly recommended for the best service
+          experience.  Location(s) where the employer is looking to hire
+          for this job posting.  Specifying the full street address(es)
+          of the hiring location enables better API results, especially
+          job searches by commute time.  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.requi
+          sition\_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 [re
+          quisition\_id][google.cloud.talent.v4beta1.Job.requisition\_id
+          ] are not allowed. If the original [requisition\_id][google.cl
+          oud.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.
+      application_info:
+          Optional. Job application information.
+      job_benefits:
+          Optional. The benefits included with the job.
+      compensation_info:
+          Optional. Job compensation information (a.k.a. "pay rate")
+          i.e., the compensation that will paid to the employee.
+      custom_attributes:
+          Optional. 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
+          KEY\_1\_LIKE\_THIS.  At most 100 filterable and at most 100
+          unfilterable keys are supported. For filterable
+          ``string_values``, across all keys at most 200 values are
+          allowed, with each string no more than 255 characters. For
+          unfilterable ``string_values``, the maximum total size of
+          ``string_values`` across all keys is 50KB.
+      degree_types:
+          Optional. The desired education degrees for the job, such as
+          Bachelors, Masters.
+      department:
+          Optional. The department or functional area within the company
+          with the open position.  The maximum number of allowed
+          characters is 255.
+      employment_types:
+          Optional. 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].
+      incentives:
+          Optional. 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.
+      language_code:
+          Optional. 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". For more information, see `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'.
+      job_level:
+          Optional. The experience level associated with the job, such
+          as "Entry Level".
+      promotion_value:
+          Optional. 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 jobs
+          with a promotionValue >0 are returned in a
+          FEATURED\_JOB\_SEARCH.  Default value is 0, and negative
+          values are treated as 0.
+      qualifications:
+          Optional. 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.  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 10,000.
+      responsibilities:
+          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.  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 10,000.
+      posting_region:
+          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.Post
+          ingRegion.NATION] or [PostingRegion.ADMINISTRATIVE\_AREA][goog
+          le.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.
+      visibility:
+          Deprecated. The job is only visible to the owner.  The
+          visibility of the job.  Defaults to [Visibility.ACCOUNT\_ONLY]
+          [google.cloud.talent.v4beta1.Visibility.ACCOUNT\_ONLY] if not
+          specified.
+      job_start_time:
+          Optional. The start timestamp of the job in UTC time zone.
+          Typically this field is used for contracting engagements.
+          Invalid timestamps are ignored.
+      job_end_time:
+          Optional. The end timestamp of the job. Typically this field
+          is used for contracting engagements. Invalid timestamps are
+          ignored.
+      posting_publish_time:
+          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.
+      posting_expire_time:
+          Optional but 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 [re
+          quisition\_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 open jobs over previous 7 days. If this
+          threshold is exceeded, expired jobs are cleaned out in order
+          of earliest expire time. Expired jobs are no longer accessible
+          after they are cleaned out.  Invalid timestamps are ignored,
+          and treated as expire time not provided.  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 [pos
+          ting\_publish\_time][google.cloud.talent.v4beta1.Job.posting\_
+          publish\_time] must be set before [posting\_expire\_time][goog
+          le.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 example, if the job was created on 2017/01/01 13:00AM UTC
+          with an 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.up
+          date\_mask]. If the field masks include [job\_end\_time][googl
+          e.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.
+      posting_create_time:
+          Output only. The timestamp when this job posting was created.
+      posting_update_time:
+          Output only. The timestamp when this job posting was last
+          updated.
+      company_display_name:
+          Output only. Display name of the company listing the job.
+      derived_info:
+          Output only. Derived details about the job posting.
+      processing_options:
+          Optional. Options for job processing.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Job)
+    ),
+)
+_sym_db.RegisterMessage(Job)
+_sym_db.RegisterMessage(Job.ApplicationInfo)
+_sym_db.RegisterMessage(Job.DerivedInfo)
+_sym_db.RegisterMessage(Job.ProcessingOptions)
+_sym_db.RegisterMessage(Job.CustomAttributesEntry)
+
+
+DESCRIPTOR._options = None
+_JOB_CUSTOMATTRIBUTESENTRY._options = None
+_JOB.fields_by_name["visibility"]._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/job_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/job_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/job_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/job_service.proto b/talent/google/cloud/talent_v4beta1/proto/job_service.proto
new file mode 100644
index 000000000000..ddec147d8410
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/job_service.proto
@@ -0,0 +1,962 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.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;
+option java_outer_classname = "JobServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service handles job management, including job CRUD, enumeration and search.
+service JobService {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Creates a new job.
+  //
+  // Typically, the job becomes searchable within 10 seconds, but it may take
+  // up to 5 minutes.
+  rpc CreateJob(CreateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/jobs"
+        body: "*"
+      }
+    };
+  }
+
+  // Retrieves the specified job, whose status is OPEN or recently EXPIRED
+  // within the last 90 days.
+  rpc GetJob(GetJobRequest) returns (Job) {
+    option (google.api.http) = {
+      get: "/v4beta1/{name=projects/*/tenants/*/jobs/*}"
+      additional_bindings { get: "/v4beta1/{name=projects/*/jobs/*}" }
+    };
+  }
+
+  // Updates specified job.
+  //
+  // Typically, updated contents become visible in search results within 10
+  // seconds, but it may take up to 5 minutes.
+  rpc UpdateJob(UpdateJobRequest) returns (Job) {
+    option (google.api.http) = {
+      patch: "/v4beta1/{job.name=projects/*/tenants/*/jobs/*}"
+      body: "*"
+      additional_bindings {
+        patch: "/v4beta1/{job.name=projects/*/jobs/*}"
+        body: "*"
+      }
+    };
+  }
+
+  // Deletes the specified job.
+  //
+  // Typically, the job becomes unsearchable within 10 seconds, but it may take
+  // up to 5 minutes.
+  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" }
+    };
+  }
+
+  // Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter.
+  rpc BatchDeleteJobs(BatchDeleteJobsRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:batchDelete"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/jobs:batchDelete"
+      }
+    };
+  }
+
+  // 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.
+  rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:search"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/jobs:search"
+        body: "*"
+      }
+    };
+  }
+
+  // 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.
+  rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/jobs:searchForAlert"
+        body: "*"
+      }
+    };
+  }
+
+  // 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;
+
+  // Required. The Job to be created.
+  Job job = 2;
+}
+
+// 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;
+}
+
+// Input only.
+//
+// Update job request.
+message UpdateJobRequest {
+  // Required. The Job to be updated.
+  Job job = 1;
+
+  // Optional but strongly recommended to be provided 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.
+  //
+  // 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;
+}
+
+// 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;
+
+  // Required. The filter string specifies the jobs to be deleted.
+  //
+  // Supported operator: =, AND
+  //
+  // The fields eligible for filtering are:
+  //
+  // * `companyName` (Required)
+  // * `requisitionId` (Required)
+  //
+  // Sample Query: companyName = "projects/api-test-project/companies/123" AND
+  // requisitionId = "req-1"
+  string filter = 2;
+}
+
+// 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;
+
+  // Required. The filter string specifies the jobs to be enumerated.
+  //
+  // Supported operator: =, AND
+  //
+  // The fields eligible for filtering are:
+  //
+  // * `companyName` (Required)
+  // * `requisitionId` (Optional)
+  // * `status` (Optional) 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
+  // requisitionId = "req-1"
+  // * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+  // status = "EXPIRED"
+  string filter = 2;
+
+  // Optional. The starting point of a query result.
+  string page_token = 3;
+
+  // Optional. 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.
+  //
+  // 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.
+  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.
+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_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_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].
+  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.
+  //
+  // The maximum number of items returned is based on the limit field
+  // provided in the request.
+  repeated Job jobs = 1;
+
+  // A token to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  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].
+  message CustomRankingInfo {
+    // 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;
+
+      // The given ranking expression is of None importance, existing relevance
+      // score (determined by API algorithm) dominates job's final ranking
+      // position.
+      NONE = 1;
+
+      // The given ranking expression is of Low importance in terms of job's
+      // final ranking position compared to existing relevance
+      // score (determined by API algorithm).
+      LOW = 2;
+
+      // The given ranking expression is of Mild importance in terms of job's
+      // final ranking position compared to existing relevance
+      // score (determined by API algorithm).
+      MILD = 3;
+
+      // The given ranking expression is of Medium importance in terms of job's
+      // final ranking position compared to existing relevance
+      // score (determined by API algorithm).
+      MEDIUM = 4;
+
+      // The given ranking expression is of High importance in terms of job's
+      // final ranking position compared to existing relevance
+      // score (determined by API algorithm).
+      HIGH = 5;
+
+      // The given ranking expression is of Extreme importance, and dominates
+      // job's final ranking position with existing relevance
+      // score (determined by API algorithm) ignored.
+      EXTREME = 6;
+    }
+
+    // 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.
+    //
+    // An error is thrown if not specified.
+    ImportanceLevel importance_level = 1;
+
+    // Required. Controls over how job documents get ranked on top of existing
+    // relevance score (determined by API algorithm). The product of 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.
+    //
+    // Parenthesis are supported to adjust calculation precedence. The
+    // expression must be < 100 characters in length.
+    //
+    // Sample ranking expression
+    // (year + 25) * 0.25 - (freshness / 0.5)
+    string ranking_expression = 2;
+  }
+
+  // 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.
+    SEARCH_MODE_UNSPECIFIED = 0;
+
+    // The job search matches against all jobs, and featured jobs
+    // (jobs with promotionValue > 0) are not specially handled.
+    JOB_SEARCH = 1;
+
+    // The job search matches only against featured jobs (jobs with a
+    // promotionValue > 0). This method doesn't return any jobs having a
+    // promotionValue <= 0. The search results order is determined by the
+    // promotionValue (jobs with a higher promotionValue are returned higher up
+    // in the search results), with relevance being used as a tiebreaker.
+    FEATURED_JOB_SEARCH = 2;
+  }
+
+  // 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.
+  enum DiversificationLevel {
+    // The diversification level isn't specified.
+    DIVERSIFICATION_LEVEL_UNSPECIFIED = 0;
+
+    // Disables diversification. Jobs that would normally be pushed to the last
+    // page would not have their positions altered. This may result in highly
+    // similar jobs appearing in sequence in the search results.
+    DISABLED = 1;
+
+    // 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.
+    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;
+
+  // Optional. Mode of a 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;
+
+  // Optional. 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.
+  //
+  // 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
+  // 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.
+  //
+  // Enabling this flag may adversely impact performance.
+  //
+  // Defaults to false.
+  bool require_precise_result_size = 6;
+
+  // Optional. An expression specifies a histogram request against matching
+  // jobs.
+  //
+  // Expression syntax is an aggregation function call with histogram facets and
+  // other options.
+  //
+  // Available aggregation function calls are:
+  // * `count(string_histogram_facet)`: Count the number of matching entities,
+  // for each distinct attribute value.
+  // * `count(numeric_histogram_facet, list of buckets)`: Count the number of
+  // matching entities within each bucket.
+  //
+  // Data types:
+  //
+  // * Histogram facet: facet names with format [a-zA-Z][a-zA-Z0-9_]+.
+  // * String: string like "any string with backslash escape for quote(\")."
+  // * Number: whole number and floating point number like 10, -1 and -0.01.
+  // * List: list of elements with comma(,) separator surrounded by square
+  // brackets, for example, [1, 2, 3] and ["one", "two", "three"].
+  //
+  // Built-in constants:
+  //
+  // * MIN (minimum number similar to java Double.MIN_VALUE)
+  // * MAX (maximum number similar to java Double.MAX_VALUE)
+  //
+  // Built-in functions:
+  //
+  // * bucket(start, end[, label]): bucket built-in function creates a bucket
+  // with range of [start, end). Note that the end is exclusive, for example,
+  // bucket(1, MAX, "positive number") or bucket(1, 10).
+  //
+  // 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,
+  //   "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]
+  //   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]
+  //   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,
+  //   "Bachelors", "Masters".
+  // * 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
+  //   placeholder referring to the state, province, or the particular term a
+  //   country uses to define the geographic structure below the country level,
+  //   for example, "CA", "IL".
+  // * city: histogram by a combination of the "city name, admin1 code". For
+  //   example,  "Mountain View, CA", "New York, NY".
+  // * admin1_country: histogram by a combination of the "admin1 code, country",
+  //   for example, "CA, US", "IL, US".
+  // * city_coordinate: histogram by the city center's GPS coordinates (latitude
+  //   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",
+  //   "fr-FR".
+  // * 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,
+  //   "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".
+  // * 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].
+  //   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].
+  //   Values can be accessed via square bracket notations like
+  //   numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
+  //   group results by.
+  //
+  // Example expressions:
+  //
+  // * `count(admin1)`
+  // * `count(base_compensation, [bucket(1000, 10000), bucket(10000, 100000),
+  // bucket(100000, MAX)])`
+  // * `count(string_custom_attribute["some-string-custom-attribute"])`
+  // * `count(numeric_custom_attribute["some-numeric-custom-attribute"],
+  //   [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.
+  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.
+  //
+  // 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
+  // pagination, (for example, pageSize = 10 and offset = 10 means to return
+  // from the second page).
+  int32 offset = 9;
+
+  // Optional. 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.
+  string page_token = 11;
+
+  // Optional. The criteria determining how search results are sorted. Default
+  // is
+  // `"relevance desc"`.
+  //
+  // Supported options are:
+  //
+  // * `"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]
+  //   descending.
+  // * `"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.
+  // * `"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.
+  // * `"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.
+  // * `"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.
+  // * `"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.
+  // * `"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.
+  // * Location sorting: Use the special syntax to order jobs by distance:<br>
+  //   `"distance_from('Hawaii')"`: Order by distance from Hawaii.<br>
+  //   `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.<br>
+  //   `"distance_from('Hawaii'), distance_from('Puerto Rico')"`: Order by
+  //   multiple locations. See details below.<br>
+  //   `"distance_from('Hawaii'), distance_from(19.89, 155.5)"`: Order by
+  //   multiple locations. See details below.<br>
+  //   The string can have a maximum of 256 characters. When multiple distance
+  //   centers are provided, a job that is close to any of the distance centers
+  //   would have a high rank. When a job has multiple locations, the job
+  //   location closest to one of the distance centers will be used. Jobs that
+  //   don't have locations will be ranked at the bottom. Distance is calculated
+  //   with a precision of 11.3 meters (37.4 feet). Diversification strategy is
+  //   still applied unless explicitly disabled in
+  //   [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
+  // 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.
+  DiversificationLevel diversification_level = 13;
+
+  // Optional. 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.
+  //
+  // 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
+  // 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].
+  message MatchingJob {
+    // 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.
+    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.
+    string search_text_snippet = 4;
+
+    // Commute information which is generated based on specified
+    //  [CommuteFilter][google.cloud.talent.v4beta1.CommuteFilter].
+    CommuteInfo commute_info = 5;
+  }
+
+  // Output only.
+  //
+  // Commute details related to this job.
+  message CommuteInfo {
+    // Location used as the destination in the commute calculation.
+    Location job_location = 1;
+
+    // The number of seconds required to travel to the job location from the
+    // query location. A duration of 0 seconds indicates that the job isn't
+    // reachable within the requested duration, but was returned as part of an
+    // expanded query.
+    google.protobuf.Duration travel_duration = 2;
+  }
+
+  // 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
+  // [SearchJobsRequest.histogram_queries][google.cloud.talent.v4beta1.SearchJobsRequest.histogram_queries].
+  repeated HistogramQueryResult histogram_query_results = 2;
+
+  // The token that specifies the starting position of the next page of results.
+  // This field is empty if there are no more results.
+  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
+  // [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].
+  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`.
+  int32 total_size = 6;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 7;
+
+  // If query broadening is enabled, we may append additional results from the
+  // broadened query. This number indicates how many of the jobs returned in the
+  // jobs field are from the broadened query. These results are always at the
+  // end of the jobs list. In particular, a value of 0, or if the field isn't
+  // set, all the jobs in the jobs list are from the original
+  // (without broadening) query. If this field is non-zero, subsequent requests
+  // with offset after this result set should contain all broadened results.
+  int32 broadened_query_jobs_count = 8;
+
+  // The spell checking result, and correction.
+  SpellingCorrection spell_correction = 9;
+}
+
+// Request to create a batch of jobs.
+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;
+
+  // Required. The jobs to be created.
+  repeated Job jobs = 2;
+}
+
+// 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;
+
+  // Required. The jobs to be updated.
+  repeated Job jobs = 2;
+
+  // Optional but strongly recommended to be provided for the best service
+  // experience, also increase latency when checking status of 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.
+  //
+  // 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][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;
+}
+
+// Output only.
+//
+// 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/talent/google/cloud/talent_v4beta1/proto/job_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/job_service_pb2.py
new file mode 100644
index 000000000000..b96c8d7aba09
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/job_service_pb2.py
@@ -0,0 +1,2588 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/job_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    filters_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_filters__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    histogram_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    job_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/job_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\017JobServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n3google/cloud/talent_v4beta1/proto/job_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a/google/cloud/talent_v4beta1/proto/filters.proto\x1a\x31google/cloud/talent_v4beta1/proto/histogram.proto\x1a+google/cloud/talent_v4beta1/proto/job.proto\x1a#google/longrunning/operations.proto\x1a\x19google/protobuf/any.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x17google/rpc/status.proto"Q\n\x10\x43reateJobRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12-\n\x03job\x18\x02 \x01(\x0b\x32 .google.cloud.talent.v4beta1.Job"\x1d\n\rGetJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"r\n\x10UpdateJobRequest\x12-\n\x03job\x18\x01 \x01(\x0b\x32 .google.cloud.talent.v4beta1.Job\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask" \n\x10\x44\x65leteJobRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"8\n\x16\x42\x61tchDeleteJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t"\x90\x01\n\x0fListJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x36\n\x08job_view\x18\x05 \x01(\x0e\x32$.google.cloud.talent.v4beta1.JobView"\x9c\x01\n\x10ListJobsResponse\x12.\n\x04jobs\x18\x01 \x03(\x0b\x32 .google.cloud.talent.v4beta1.Job\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12?\n\x08metadata\x18\x03 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata"\xa0\t\n\x11SearchJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12N\n\x0bsearch_mode\x18\x02 \x01(\x0e\x32\x39.google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode\x12\x46\n\x10request_metadata\x18\x03 \x01(\x0b\x32,.google.cloud.talent.v4beta1.RequestMetadata\x12\x38\n\tjob_query\x18\x04 \x01(\x0b\x32%.google.cloud.talent.v4beta1.JobQuery\x12\x19\n\x11\x65nable_broadening\x18\x05 \x01(\x08\x12#\n\x1brequire_precise_result_size\x18\x06 \x01(\x08\x12\x46\n\x11histogram_queries\x18\x07 \x03(\x0b\x32+.google.cloud.talent.v4beta1.HistogramQuery\x12\x36\n\x08job_view\x18\x08 \x01(\x0e\x32$.google.cloud.talent.v4beta1.JobView\x12\x0e\n\x06offset\x18\t \x01(\x05\x12\x11\n\tpage_size\x18\n \x01(\x05\x12\x12\n\npage_token\x18\x0b \x01(\t\x12\x10\n\x08order_by\x18\x0c \x01(\t\x12\x62\n\x15\x64iversification_level\x18\r \x01(\x0e\x32\x43.google.cloud.talent.v4beta1.SearchJobsRequest.DiversificationLevel\x12]\n\x13\x63ustom_ranking_info\x18\x0e \x01(\x0b\x32@.google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo\x12\x1d\n\x15\x64isable_keyword_match\x18\x10 \x01(\x08\x1a\x90\x02\n\x11\x43ustomRankingInfo\x12j\n\x10importance_level\x18\x01 \x01(\x0e\x32P.google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ImportanceLevel\x12\x1a\n\x12ranking_expression\x18\x02 \x01(\t"s\n\x0fImportanceLevel\x12 \n\x1cIMPORTANCE_LEVEL_UNSPECIFIED\x10\x00\x12\x08\n\x04NONE\x10\x01\x12\x07\n\x03LOW\x10\x02\x12\x08\n\x04MILD\x10\x03\x12\n\n\x06MEDIUM\x10\x04\x12\x08\n\x04HIGH\x10\x05\x12\x0b\n\x07\x45XTREME\x10\x06"R\n\nSearchMode\x12\x1b\n\x17SEARCH_MODE_UNSPECIFIED\x10\x00\x12\x0e\n\nJOB_SEARCH\x10\x01\x12\x17\n\x13\x46\x45\x41TURED_JOB_SEARCH\x10\x02"W\n\x14\x44iversificationLevel\x12%\n!DIVERSIFICATION_LEVEL_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x44ISABLED\x10\x01\x12\n\n\x06SIMPLE\x10\x02"\xd7\x06\n\x12SearchJobsResponse\x12R\n\rmatching_jobs\x18\x01 \x03(\x0b\x32;.google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob\x12R\n\x17histogram_query_results\x18\x02 \x03(\x0b\x32\x31.google.cloud.talent.v4beta1.HistogramQueryResult\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t\x12?\n\x10location_filters\x18\x04 \x03(\x0b\x32%.google.cloud.talent.v4beta1.Location\x12\x1c\n\x14\x65stimated_total_size\x18\x05 \x01(\x05\x12\x12\n\ntotal_size\x18\x06 \x01(\x05\x12?\n\x08metadata\x18\x07 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata\x12"\n\x1a\x62roadened_query_jobs_count\x18\x08 \x01(\x05\x12I\n\x10spell_correction\x18\t \x01(\x0b\x32/.google.cloud.talent.v4beta1.SpellingCorrection\x1a\xdc\x01\n\x0bMatchingJob\x12-\n\x03job\x18\x01 \x01(\x0b\x32 .google.cloud.talent.v4beta1.Job\x12\x13\n\x0bjob_summary\x18\x02 \x01(\t\x12\x19\n\x11job_title_snippet\x18\x03 \x01(\t\x12\x1b\n\x13search_text_snippet\x18\x04 \x01(\t\x12Q\n\x0c\x63ommute_info\x18\x05 \x01(\x0b\x32;.google.cloud.talent.v4beta1.SearchJobsResponse.CommuteInfo\x1a~\n\x0b\x43ommuteInfo\x12;\n\x0cjob_location\x18\x01 \x01(\x0b\x32%.google.cloud.talent.v4beta1.Location\x12\x32\n\x0ftravel_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"X\n\x16\x42\x61tchCreateJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\x04jobs\x18\x02 \x03(\x0b\x32 .google.cloud.talent.v4beta1.Job"\x89\x01\n\x16\x42\x61tchUpdateJobsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12.\n\x04jobs\x18\x02 \x03(\x0b\x32 .google.cloud.talent.v4beta1.Job\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xc4\x01\n\x12JobOperationResult\x12N\n\x0bjob_results\x18\x01 \x03(\x0b\x32\x39.google.cloud.talent.v4beta1.JobOperationResult.JobResult\x1a^\n\tJobResult\x12-\n\x03job\x18\x01 \x01(\x0b\x32 .google.cloud.talent.v4beta1.Job\x12"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status*v\n\x07JobView\x12\x18\n\x14JOB_VIEW_UNSPECIFIED\x10\x00\x12\x14\n\x10JOB_VIEW_ID_ONLY\x10\x01\x12\x14\n\x10JOB_VIEW_MINIMAL\x10\x02\x12\x12\n\x0eJOB_VIEW_SMALL\x10\x03\x12\x11\n\rJOB_VIEW_FULL\x10\x04\x32\x90\x11\n\nJobService\x12\xbc\x01\n\tCreateJob\x12-.google.cloud.talent.v4beta1.CreateJobRequest\x1a .google.cloud.talent.v4beta1.Job"^\x82\xd3\xe4\x93\x02X"+/v4beta1/{parent=projects/*/tenants/*}/jobs:\x01*Z&"!/v4beta1/{parent=projects/*}/jobs:\x01*\x12\xb0\x01\n\x06GetJob\x12*.google.cloud.talent.v4beta1.GetJobRequest\x1a .google.cloud.talent.v4beta1.Job"X\x82\xd3\xe4\x93\x02R\x12+/v4beta1/{name=projects/*/tenants/*/jobs/*}Z#\x12!/v4beta1/{name=projects/*/jobs/*}\x12\xc4\x01\n\tUpdateJob\x12-.google.cloud.talent.v4beta1.UpdateJobRequest\x1a .google.cloud.talent.v4beta1.Job"f\x82\xd3\xe4\x93\x02`2//v4beta1/{job.name=projects/*/tenants/*/jobs/*}:\x01*Z*2%/v4beta1/{job.name=projects/*/jobs/*}:\x01*\x12\xac\x01\n\tDeleteJob\x12-.google.cloud.talent.v4beta1.DeleteJobRequest\x1a\x16.google.protobuf.Empty"X\x82\xd3\xe4\x93\x02R*+/v4beta1/{name=projects/*/tenants/*/jobs/*}Z#*!/v4beta1/{name=projects/*/jobs/*}\x12\xc1\x01\n\x08ListJobs\x12,.google.cloud.talent.v4beta1.ListJobsRequest\x1a-.google.cloud.talent.v4beta1.ListJobsResponse"X\x82\xd3\xe4\x93\x02R\x12+/v4beta1/{parent=projects/*/tenants/*}/jobsZ#\x12!/v4beta1/{parent=projects/*}/jobs\x12\xd3\x01\n\x0f\x42\x61tchDeleteJobs\x12\x33.google.cloud.talent.v4beta1.BatchDeleteJobsRequest\x1a\x16.google.protobuf.Empty"s\x82\xd3\xe4\x93\x02m"7/v4beta1/{parent=projects/*/tenants/*}/jobs:batchDelete:\x01*Z/"-/v4beta1/{parent=projects/*}/jobs:batchDelete\x12\xdb\x01\n\nSearchJobs\x12..google.cloud.talent.v4beta1.SearchJobsRequest\x1a/.google.cloud.talent.v4beta1.SearchJobsResponse"l\x82\xd3\xe4\x93\x02\x66"2/v4beta1/{parent=projects/*/tenants/*}/jobs:search:\x01*Z-"(/v4beta1/{parent=projects/*}/jobs:search:\x01*\x12\xf3\x01\n\x12SearchJobsForAlert\x12..google.cloud.talent.v4beta1.SearchJobsRequest\x1a/.google.cloud.talent.v4beta1.SearchJobsResponse"|\x82\xd3\xe4\x93\x02v":/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert:\x01*Z5"0/v4beta1/{parent=projects/*}/jobs:searchForAlert:\x01*\x12\xdd\x01\n\x0f\x42\x61tchCreateJobs\x12\x33.google.cloud.talent.v4beta1.BatchCreateJobsRequest\x1a\x1d.google.longrunning.Operation"v\x82\xd3\xe4\x93\x02p"7/v4beta1/{parent=projects/*/tenants/*}/jobs:batchCreate:\x01*Z2"-/v4beta1/{parent=projects/*}/jobs:batchCreate:\x01*\x12\xdd\x01\n\x0f\x42\x61tchUpdateJobs\x12\x33.google.cloud.talent.v4beta1.BatchUpdateJobsRequest\x1a\x1d.google.longrunning.Operation"v\x82\xd3\xe4\x93\x02p"7/v4beta1/{parent=projects/*/tenants/*}/jobs:batchUpdate:\x01*Z2"-/v4beta1/{parent=projects/*}/jobs:batchUpdate:\x01*\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB}\n\x1f\x63om.google.cloud.talent.v4beta1B\x0fJobServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_filters__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_any__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_JOBVIEW = _descriptor.EnumDescriptor(
+    name="JobView",
+    full_name="google.cloud.talent.v4beta1.JobView",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="JOB_VIEW_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JOB_VIEW_ID_ONLY",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JOB_VIEW_MINIMAL",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JOB_VIEW_SMALL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JOB_VIEW_FULL", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3618,
+    serialized_end=3736,
+)
+_sym_db.RegisterEnumDescriptor(_JOBVIEW)
+
+JobView = enum_type_wrapper.EnumTypeWrapper(_JOBVIEW)
+JOB_VIEW_UNSPECIFIED = 0
+JOB_VIEW_ID_ONLY = 1
+JOB_VIEW_MINIMAL = 2
+JOB_VIEW_SMALL = 3
+JOB_VIEW_FULL = 4
+
+
+_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO_IMPORTANCELEVEL = _descriptor.EnumDescriptor(
+    name="ImportanceLevel",
+    full_name="google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ImportanceLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="IMPORTANCE_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NONE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOW", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MILD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MEDIUM", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HIGH", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXTREME", index=6, number=6, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2041,
+    serialized_end=2156,
+)
+_sym_db.RegisterEnumDescriptor(_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO_IMPORTANCELEVEL)
+
+_SEARCHJOBSREQUEST_SEARCHMODE = _descriptor.EnumDescriptor(
+    name="SearchMode",
+    full_name="google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SEARCH_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="JOB_SEARCH", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FEATURED_JOB_SEARCH",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2158,
+    serialized_end=2240,
+)
+_sym_db.RegisterEnumDescriptor(_SEARCHJOBSREQUEST_SEARCHMODE)
+
+_SEARCHJOBSREQUEST_DIVERSIFICATIONLEVEL = _descriptor.EnumDescriptor(
+    name="DiversificationLevel",
+    full_name="google.cloud.talent.v4beta1.SearchJobsRequest.DiversificationLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DIVERSIFICATION_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SIMPLE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2242,
+    serialized_end=2329,
+)
+_sym_db.RegisterEnumDescriptor(_SEARCHJOBSREQUEST_DIVERSIFICATIONLEVEL)
+
+
+_CREATEJOBREQUEST = _descriptor.Descriptor(
+    name="CreateJobRequest",
+    full_name="google.cloud.talent.v4beta1.CreateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CreateJobRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.talent.v4beta1.CreateJobRequest.job",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=516,
+    serialized_end=597,
+)
+
+
+_GETJOBREQUEST = _descriptor.Descriptor(
+    name="GetJobRequest",
+    full_name="google.cloud.talent.v4beta1.GetJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.GetJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=599,
+    serialized_end=628,
+)
+
+
+_UPDATEJOBREQUEST = _descriptor.Descriptor(
+    name="UpdateJobRequest",
+    full_name="google.cloud.talent.v4beta1.UpdateJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.talent.v4beta1.UpdateJobRequest.job",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.talent.v4beta1.UpdateJobRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=630,
+    serialized_end=744,
+)
+
+
+_DELETEJOBREQUEST = _descriptor.Descriptor(
+    name="DeleteJobRequest",
+    full_name="google.cloud.talent.v4beta1.DeleteJobRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.DeleteJobRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=746,
+    serialized_end=778,
+)
+
+
+_BATCHDELETEJOBSREQUEST = _descriptor.Descriptor(
+    name="BatchDeleteJobsRequest",
+    full_name="google.cloud.talent.v4beta1.BatchDeleteJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.BatchDeleteJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.talent.v4beta1.BatchDeleteJobsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=780,
+    serialized_end=836,
+)
+
+
+_LISTJOBSREQUEST = _descriptor.Descriptor(
+    name="ListJobsRequest",
+    full_name="google.cloud.talent.v4beta1.ListJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.ListJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.talent.v4beta1.ListJobsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.ListJobsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.ListJobsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_view",
+            full_name="google.cloud.talent.v4beta1.ListJobsRequest.job_view",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=839,
+    serialized_end=983,
+)
+
+
+_LISTJOBSRESPONSE = _descriptor.Descriptor(
+    name="ListJobsResponse",
+    full_name="google.cloud.talent.v4beta1.ListJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.talent.v4beta1.ListJobsResponse.jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.ListJobsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.ListJobsResponse.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=986,
+    serialized_end=1142,
+)
+
+
+_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO = _descriptor.Descriptor(
+    name="CustomRankingInfo",
+    full_name="google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="importance_level",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.importance_level",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ranking_expression",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO_IMPORTANCELEVEL],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1884,
+    serialized_end=2156,
+)
+
+_SEARCHJOBSREQUEST = _descriptor.Descriptor(
+    name="SearchJobsRequest",
+    full_name="google.cloud.talent.v4beta1.SearchJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="search_mode",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.search_mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_metadata",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.request_metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_query",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.job_query",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_broadening",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.enable_broadening",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="require_precise_result_size",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.require_precise_result_size",
+            index=5,
+            number=6,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="histogram_queries",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.histogram_queries",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_view",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.job_view",
+            index=7,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.offset",
+            index=8,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.page_size",
+            index=9,
+            number=10,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.page_token",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.order_by",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="diversification_level",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.diversification_level",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_ranking_info",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.custom_ranking_info",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disable_keyword_match",
+            full_name="google.cloud.talent.v4beta1.SearchJobsRequest.disable_keyword_match",
+            index=14,
+            number=16,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO],
+    enum_types=[_SEARCHJOBSREQUEST_SEARCHMODE, _SEARCHJOBSREQUEST_DIVERSIFICATIONLEVEL],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1145,
+    serialized_end=2329,
+)
+
+
+_SEARCHJOBSRESPONSE_MATCHINGJOB = _descriptor.Descriptor(
+    name="MatchingJob",
+    full_name="google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.job",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_summary",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.job_summary",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_title_snippet",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.job_title_snippet",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="search_text_snippet",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.search_text_snippet",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="commute_info",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.commute_info",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2839,
+    serialized_end=3059,
+)
+
+_SEARCHJOBSRESPONSE_COMMUTEINFO = _descriptor.Descriptor(
+    name="CommuteInfo",
+    full_name="google.cloud.talent.v4beta1.SearchJobsResponse.CommuteInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job_location",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.CommuteInfo.job_location",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="travel_duration",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.CommuteInfo.travel_duration",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3061,
+    serialized_end=3187,
+)
+
+_SEARCHJOBSRESPONSE = _descriptor.Descriptor(
+    name="SearchJobsResponse",
+    full_name="google.cloud.talent.v4beta1.SearchJobsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="matching_jobs",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.matching_jobs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="histogram_query_results",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.histogram_query_results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_filters",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.location_filters",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="estimated_total_size",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.estimated_total_size",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_size",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.total_size",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.metadata",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="broadened_query_jobs_count",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.broadened_query_jobs_count",
+            index=7,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spell_correction",
+            full_name="google.cloud.talent.v4beta1.SearchJobsResponse.spell_correction",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SEARCHJOBSRESPONSE_MATCHINGJOB, _SEARCHJOBSRESPONSE_COMMUTEINFO],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2332,
+    serialized_end=3187,
+)
+
+
+_BATCHCREATEJOBSREQUEST = _descriptor.Descriptor(
+    name="BatchCreateJobsRequest",
+    full_name="google.cloud.talent.v4beta1.BatchCreateJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.BatchCreateJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.talent.v4beta1.BatchCreateJobsRequest.jobs",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3189,
+    serialized_end=3277,
+)
+
+
+_BATCHUPDATEJOBSREQUEST = _descriptor.Descriptor(
+    name="BatchUpdateJobsRequest",
+    full_name="google.cloud.talent.v4beta1.BatchUpdateJobsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.BatchUpdateJobsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="jobs",
+            full_name="google.cloud.talent.v4beta1.BatchUpdateJobsRequest.jobs",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.talent.v4beta1.BatchUpdateJobsRequest.update_mask",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3280,
+    serialized_end=3417,
+)
+
+
+_JOBOPERATIONRESULT_JOBRESULT = _descriptor.Descriptor(
+    name="JobResult",
+    full_name="google.cloud.talent.v4beta1.JobOperationResult.JobResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job",
+            full_name="google.cloud.talent.v4beta1.JobOperationResult.JobResult.job",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.talent.v4beta1.JobOperationResult.JobResult.status",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3522,
+    serialized_end=3616,
+)
+
+_JOBOPERATIONRESULT = _descriptor.Descriptor(
+    name="JobOperationResult",
+    full_name="google.cloud.talent.v4beta1.JobOperationResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="job_results",
+            full_name="google.cloud.talent.v4beta1.JobOperationResult.job_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_JOBOPERATIONRESULT_JOBRESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3420,
+    serialized_end=3616,
+)
+
+_CREATEJOBREQUEST.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_UPDATEJOBREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTJOBSREQUEST.fields_by_name["job_view"].enum_type = _JOBVIEW
+_LISTJOBSRESPONSE.fields_by_name[
+    "jobs"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_LISTJOBSRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO.fields_by_name[
+    "importance_level"
+].enum_type = _SEARCHJOBSREQUEST_CUSTOMRANKINGINFO_IMPORTANCELEVEL
+_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO.containing_type = _SEARCHJOBSREQUEST
+_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO_IMPORTANCELEVEL.containing_type = (
+    _SEARCHJOBSREQUEST_CUSTOMRANKINGINFO
+)
+_SEARCHJOBSREQUEST.fields_by_name[
+    "search_mode"
+].enum_type = _SEARCHJOBSREQUEST_SEARCHMODE
+_SEARCHJOBSREQUEST.fields_by_name[
+    "request_metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._REQUESTMETADATA
+)
+_SEARCHJOBSREQUEST.fields_by_name[
+    "job_query"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_filters__pb2._JOBQUERY
+)
+_SEARCHJOBSREQUEST.fields_by_name[
+    "histogram_queries"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2._HISTOGRAMQUERY
+)
+_SEARCHJOBSREQUEST.fields_by_name["job_view"].enum_type = _JOBVIEW
+_SEARCHJOBSREQUEST.fields_by_name[
+    "diversification_level"
+].enum_type = _SEARCHJOBSREQUEST_DIVERSIFICATIONLEVEL
+_SEARCHJOBSREQUEST.fields_by_name[
+    "custom_ranking_info"
+].message_type = _SEARCHJOBSREQUEST_CUSTOMRANKINGINFO
+_SEARCHJOBSREQUEST_SEARCHMODE.containing_type = _SEARCHJOBSREQUEST
+_SEARCHJOBSREQUEST_DIVERSIFICATIONLEVEL.containing_type = _SEARCHJOBSREQUEST
+_SEARCHJOBSRESPONSE_MATCHINGJOB.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_SEARCHJOBSRESPONSE_MATCHINGJOB.fields_by_name[
+    "commute_info"
+].message_type = _SEARCHJOBSRESPONSE_COMMUTEINFO
+_SEARCHJOBSRESPONSE_MATCHINGJOB.containing_type = _SEARCHJOBSRESPONSE
+_SEARCHJOBSRESPONSE_COMMUTEINFO.fields_by_name[
+    "job_location"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._LOCATION
+)
+_SEARCHJOBSRESPONSE_COMMUTEINFO.fields_by_name[
+    "travel_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_SEARCHJOBSRESPONSE_COMMUTEINFO.containing_type = _SEARCHJOBSRESPONSE
+_SEARCHJOBSRESPONSE.fields_by_name[
+    "matching_jobs"
+].message_type = _SEARCHJOBSRESPONSE_MATCHINGJOB
+_SEARCHJOBSRESPONSE.fields_by_name[
+    "histogram_query_results"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2._HISTOGRAMQUERYRESULT
+)
+_SEARCHJOBSRESPONSE.fields_by_name[
+    "location_filters"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._LOCATION
+)
+_SEARCHJOBSRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+_SEARCHJOBSRESPONSE.fields_by_name[
+    "spell_correction"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._SPELLINGCORRECTION
+)
+_BATCHCREATEJOBSREQUEST.fields_by_name[
+    "jobs"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_BATCHUPDATEJOBSREQUEST.fields_by_name[
+    "jobs"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_BATCHUPDATEJOBSREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_JOBOPERATIONRESULT_JOBRESULT.fields_by_name[
+    "job"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB
+_JOBOPERATIONRESULT_JOBRESULT.fields_by_name[
+    "status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_JOBOPERATIONRESULT_JOBRESULT.containing_type = _JOBOPERATIONRESULT
+_JOBOPERATIONRESULT.fields_by_name[
+    "job_results"
+].message_type = _JOBOPERATIONRESULT_JOBRESULT
+DESCRIPTOR.message_types_by_name["CreateJobRequest"] = _CREATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["GetJobRequest"] = _GETJOBREQUEST
+DESCRIPTOR.message_types_by_name["UpdateJobRequest"] = _UPDATEJOBREQUEST
+DESCRIPTOR.message_types_by_name["DeleteJobRequest"] = _DELETEJOBREQUEST
+DESCRIPTOR.message_types_by_name["BatchDeleteJobsRequest"] = _BATCHDELETEJOBSREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsRequest"] = _LISTJOBSREQUEST
+DESCRIPTOR.message_types_by_name["ListJobsResponse"] = _LISTJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["SearchJobsRequest"] = _SEARCHJOBSREQUEST
+DESCRIPTOR.message_types_by_name["SearchJobsResponse"] = _SEARCHJOBSRESPONSE
+DESCRIPTOR.message_types_by_name["BatchCreateJobsRequest"] = _BATCHCREATEJOBSREQUEST
+DESCRIPTOR.message_types_by_name["BatchUpdateJobsRequest"] = _BATCHUPDATEJOBSREQUEST
+DESCRIPTOR.message_types_by_name["JobOperationResult"] = _JOBOPERATIONRESULT
+DESCRIPTOR.enum_types_by_name["JobView"] = _JOBVIEW
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEJOBREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  Create job request.
+  
+  
+  Attributes:
+      parent:
+          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".
+      job:
+          Required. The Job to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CreateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateJobRequest)
+
+GetJobRequest = _reflection.GeneratedProtocolMessageType(
+    "GetJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETJOBREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  Get job request.
+  
+  
+  Attributes:
+      name:
+          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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.GetJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetJobRequest)
+
+UpdateJobRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEJOBREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  Update job request.
+  
+  
+  Attributes:
+      job:
+          Required. The Job to be updated.
+      update_mask:
+          Optional but strongly recommended to be provided for the best
+          service experience.  If [update\_mask][google.cloud.talent.v4b
+          eta1.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.UpdateJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateJobRequest)
+
+DeleteJobRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteJobRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEJOBREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  Delete job request.
+  
+  
+  Attributes:
+      name:
+          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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.DeleteJobRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteJobRequest)
+
+BatchDeleteJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchDeleteJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHDELETEJOBSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  Batch delete jobs request.
+  
+  
+  Attributes:
+      parent:
+          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".
+      filter:
+          Required. The filter string specifies the jobs to be deleted.
+          Supported operator: =, AND  The fields eligible for filtering
+          are:  -  ``companyName`` (Required) -  ``requisitionId``
+          (Required)  Sample Query: companyName = "projects/api-test-
+          project/companies/123" AND requisitionId = "req-1"
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.BatchDeleteJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchDeleteJobsRequest)
+
+ListJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  List jobs request.
+  
+  
+  Attributes:
+      parent:
+          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".
+      filter:
+          Required. The filter string specifies the jobs to be
+          enumerated.  Supported operator: =, AND  The fields eligible
+          for filtering are:  -  ``companyName`` (Required) -
+          ``requisitionId`` (Optional) -  ``status`` (Optional)
+          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 requisitionId =
+          "req-1" -  companyName = "projects/api-test-
+          project/tenants/foo/companies/bar"    AND status = "EXPIRED"
+      page_token:
+          Optional. The starting point of a query result.
+      page_size:
+          Optional. The maximum number of jobs to be returned per page
+          of results.  If [job\_view][google.cloud.talent.v4beta1.ListJo
+          bsRequest.job\_view] is set to [JobView.JOB\_VIEW\_ID\_ONLY][g
+          oogle.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.
+      job_view:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsRequest)
+
+ListJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListJobsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTJOBSRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Output only.
+  
+  List jobs response.
+  
+  
+  Attributes:
+      jobs:
+          The Jobs for a given company.  The maximum number of items
+          returned is based on the limit field provided in the request.
+      next_page_token:
+          A token to retrieve the next page of results.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListJobsResponse)
+
+SearchJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchJobsRequest",
+    (_message.Message,),
+    dict(
+        CustomRankingInfo=_reflection.GeneratedProtocolMessageType(
+            "CustomRankingInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHJOBSREQUEST_CUSTOMRANKINGINFO,
+                __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+                __doc__="""Input only.
+    
+    Custom ranking information for
+    [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+    
+    
+    Attributes:
+        importance_level:
+            Required. Controls over how important the score of [CustomRank
+            ingInfo.ranking\_expression][google.cloud.talent.v4beta1.Searc
+            hJobsRequest.CustomRankingInfo.ranking\_expression] gets
+            applied to job's final ranking position.  An error is thrown
+            if not specified.
+        ranking_expression:
+            Required. Controls over how job documents get ranked on top of
+            existing relevance score (determined by API algorithm). The
+            product of 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][goog
+            le.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.
+            Sample ranking expression (year + 25) \* 0.25 - (freshness /
+            0.5)
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHJOBSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Input only.
+  
+  The Request body of the ``SearchJobs`` call.
+  
+  
+  Attributes:
+      parent:
+          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".
+      search_mode:
+          Optional. Mode of a search.  Defaults to [SearchMode.JOB\_SEAR
+          CH][google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode.J
+          OB\_SEARCH].
+      request_metadata:
+          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.
+      job_query:
+          Optional. Query used to search against jobs, such as keyword,
+          location filters, etc.
+      enable_broadening:
+          Optional. 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.
+      require_precise_result_size:
+          Optional. 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.  Enabling this flag may adversely impact
+          performance.  Defaults to false.
+      histogram_queries:
+          Optional. An expression specifies a histogram request against
+          matching jobs.  Expression syntax is an aggregation function
+          call with histogram facets and other options.  Available
+          aggregation function calls are: \*
+          ``count(string_histogram_facet)``: Count the number of
+          matching entities, for each distinct attribute value. \*
+          ``count(numeric_histogram_facet, list of buckets)``: Count the
+          number of matching entities within each bucket.  Data types:
+          -  Histogram facet: facet names with format
+          [a-zA-Z][a-zA-Z0-9\_]+. -  String: string like "any string
+          with backslash escape for quote(")." -  Number: whole number
+          and floating point number like 10, -1 and -0.01. -  List: list
+          of elements with comma(,) separator surrounded by square
+          brackets, for example, [1, 2, 3] and ["one", "two", "three"].
+          Built-in constants:  -  MIN (minimum number similar to java
+          Double.MIN\_VALUE) -  MAX (maximum number similar to java
+          Double.MAX\_VALUE)  Built-in functions:  -  bucket(start,
+          end[, label]): bucket built-in function creates a    bucket
+          with range of [start, end). Note that the end is exclusive,
+          for example, bucket(1, MAX, "positive number") or bucket(1,
+          10).  Job histogram facets:  -  company\_display\_name:
+          histogram by    [Job.company\_display\_name][google.cloud.tale
+          nt.v4beta1.Job.company\_display\_name]. -  employment\_type:
+          histogram by    [Job.employment\_types][google.cloud.talent.v4
+          beta1.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\_pu
+          blish\_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.pos
+          ting\_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.de
+          gree\_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 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
+          placeholder referring to the state, province, or the
+          particular term    a country uses to define the geographic
+          structure below the country    level, for example, "CA", "IL".
+          -  city: histogram by a combination of the "city name, admin1
+          code". For    example, "Mountain View, CA", "New York, NY". -
+          admin1\_country: histogram by a combination of the "admin1
+          code,    country", for example, "CA, US", "IL, US". -
+          city\_coordinate: histogram by the city center's GPS
+          coordinates    (latitude 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\_co
+          de][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.ta
+          lent.v4beta1.Job.language\_code],    for example, "en", "fr".
+          -  category: histogram by the
+          [JobCategory][google.cloud.talent.v4beta1.JobCategory], for
+          example,    "COMPUTER\_AND\_IT", "HEALTHCARE". -
+          base\_compensation\_unit: histogram by the    [CompensationInf
+          o.CompensationUnit][google.cloud.talent.v4beta1.CompensationIn
+          fo.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].    Values can be accessed via square
+          bracket notations like    string\_custom\_attribute["key1"]. -
+          numeric\_custom\_attribute: histogram by numeric    [Job.custo
+          m\_attributes][google.cloud.talent.v4beta1.Job.custom\_attribu
+          tes].    Values can be accessed via square bracket notations
+          like    numeric\_custom\_attribute["key1"]. Must specify list
+          of numeric    buckets to group results by.  Example
+          expressions:  -  ``count(admin1)`` -
+          ``count(base_compensation, [bucket(1000, 10000), bucket(10000,
+          100000), bucket(100000, MAX)])`` -
+          ``count(string_custom_attribute["some-string-custom-
+          attribute"])`` -  ``count(numeric_custom_attribute["some-
+          numeric-custom-attribute"],   [bucket(MIN, 0, "negative"),
+          bucket(0, MAX, "non-negative"])``
+      job_view:
+          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.
+      offset:
+          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.Search
+          JobsRequest.page\_token] is unset.  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
+          pagination, (for example, pageSize = 10 and offset = 10 means
+          to return from the second page).
+      page_size:
+          Optional. 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.
+      page_token:
+          Optional. The token specifying the current offset within
+          search results. See [SearchJobsResponse.next\_page\_token][goo
+          gle.cloud.talent.v4beta1.SearchJobsResponse.next\_page\_token]
+          for an explanation of how to obtain the next set of query
+          results.
+      order_by:
+          Optional. The criteria determining how search results are
+          sorted. Default is ``"relevance desc"``.  Supported options
+          are:  -  ``"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]
+          descending. -  ``"posting_update_time desc"``: By    [Job.post
+          ing\_update\_time][google.cloud.talent.v4beta1.Job.posting\_up
+          date\_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.
+          -  ``"annualized_base_compensation"``: By job's    [Compensati
+          onInfo.annualized\_base\_compensation\_range][google.cloud.tal
+          ent.v4beta1.CompensationInfo.annualized\_base\_compensation\_r
+          ange]    ascending. Jobs whose annualized base compensation is
+          unspecified are    put at the end of search results. -
+          ``"annualized_base_compensation desc"``: By job's    [Compensa
+          tionInfo.annualized\_base\_compensation\_range][google.cloud.t
+          alent.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    [Compensation
+          Info.annualized\_total\_compensation\_range][google.cloud.tale
+          nt.v4beta1.CompensationInfo.annualized\_total\_compensation\_r
+          ange]    ascending. Jobs whose annualized base compensation is
+          unspecified are    put at the end of search results. -
+          ``"annualized_total_compensation desc"``: By job's    [Compens
+          ationInfo.annualized\_total\_compensation\_range][google.cloud
+          .talent.v4beta1.CompensationInfo.annualized\_total\_compensati
+          on\_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.rankin
+          g\_expression][google.cloud.talent.v4beta1.SearchJobsRequest.C
+          ustomRankingInfo.ranking\_expression]    with weight factor
+          assigned by    [SearchJobsRequest.CustomRankingInfo.importance
+          \_level][google.cloud.talent.v4beta1.SearchJobsRequest.CustomR
+          ankingInfo.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.    ``"distance_from('Hawaii'),
+          distance_from('Puerto Rico')"``: Order by    multiple
+          locations. See details below.    ``"distance_from('Hawaii'),
+          distance_from(19.89, 155.5)"``: Order by    multiple
+          locations. See details below. The string can have a maximum
+          of 256 characters. When multiple distance centers are
+          provided, a job    that is close to any of the distance
+          centers would have a high rank.    When a job has multiple
+          locations, the job location closest to one of    the distance
+          centers will be used. Jobs that don't have locations    will
+          be ranked at the bottom. Distance is calculated with a
+          precision    of 11.3 meters (37.4 feet). Diversification
+          strategy is still applied    unless explicitly disabled in    
+          [diversification\_level][google.cloud.talent.v4beta1.SearchJob
+          sRequest.diversification\_level].
+      diversification_level:
+          Optional. 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 [Diversifica
+          tionLevel.SIMPLE][google.cloud.talent.v4beta1.SearchJobsReques
+          t.DiversificationLevel.SIMPLE] if no value is specified.
+      custom_ranking_info:
+          Optional. Controls over how job documents get ranked on top of
+          existing relevance score (determined by API algorithm).
+      disable_keyword_match:
+          Optional. Controls whether to disable exact keyword match on
+          [Job.title][google.cloud.talent.v4beta1.Job.title], [Job.descr
+          iption][google.cloud.talent.v4beta1.Job.description], [Job.com
+          pany\_display\_name][google.cloud.talent.v4beta1.Job.company\_
+          display\_name],
+          [Job.addresses][google.cloud.talent.v4beta1.Job.addresses], [J
+          ob.qualifications][google.cloud.talent.v4beta1.Job.qualificati
+          ons]. 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\_search
+          able\_job\_custom\_attributes][google.cloud.talent.v4beta1.Com
+          pany.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchJobsRequest)
+_sym_db.RegisterMessage(SearchJobsRequest.CustomRankingInfo)
+
+SearchJobsResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchJobsResponse",
+    (_message.Message,),
+    dict(
+        MatchingJob=_reflection.GeneratedProtocolMessageType(
+            "MatchingJob",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHJOBSRESPONSE_MATCHINGJOB,
+                __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+                __doc__="""Output only.
+    
+    Job entry with metadata inside
+    [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse].
+    
+    
+    Attributes:
+        job:
+            Job resource that matches the specified [SearchJobsRequest][go
+            ogle.cloud.talent.v4beta1.SearchJobsRequest].
+        job_summary:
+            A summary of the job with core information that's displayed on
+            the search results listing page.
+        job_title_snippet:
+            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.
+        search_text_snippet:
+            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.
+        commute_info:
+            Commute information which is generated based on specified
+            [CommuteFilter][google.cloud.talent.v4beta1.CommuteFilter].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob)
+            ),
+        ),
+        CommuteInfo=_reflection.GeneratedProtocolMessageType(
+            "CommuteInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHJOBSRESPONSE_COMMUTEINFO,
+                __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+                __doc__="""Output only.
+    
+    Commute details related to this job.
+    
+    
+    Attributes:
+        job_location:
+            Location used as the destination in the commute calculation.
+        travel_duration:
+            The number of seconds required to travel to the job location
+            from the query location. A duration of 0 seconds indicates
+            that the job isn't reachable within the requested duration,
+            but was returned as part of an expanded query.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchJobsResponse.CommuteInfo)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHJOBSRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Output only.
+  
+  Response for SearchJob method.
+  
+  
+  Attributes:
+      matching_jobs:
+          The Job entities that match the specified [SearchJobsRequest][
+          google.cloud.talent.v4beta1.SearchJobsRequest].
+      histogram_query_results:
+          The histogram results that match with specified [SearchJobsReq
+          uest.histogram\_queries][google.cloud.talent.v4beta1.SearchJob
+          sRequest.histogram\_queries].
+      next_page_token:
+          The token that specifies the starting position of the next
+          page of results. This field is empty if there are no more
+          results.
+      location_filters:
+          The location filters that the service applied to the specified
+          query. If any filters are lat-lng based, the [Location.locatio
+          n\_type][google.cloud.talent.v4beta1.Location.location\_type]
+          is [Location.LocationType.LOCATION\_TYPE\_UNSPECIFIED][google.
+          cloud.talent.v4beta1.Location.LocationType.LOCATION\_TYPE\_UNS
+          PECIFIED].
+      estimated_total_size:
+          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\_res
+          ult\_size][google.cloud.talent.v4beta1.SearchJobsRequest.requi
+          re\_precise\_result\_size].
+      total_size:
+          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``.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+      broadened_query_jobs_count:
+          If query broadening is enabled, we may append additional
+          results from the broadened query. This number indicates how
+          many of the jobs returned in the jobs field are from the
+          broadened query. These results are always at the end of the
+          jobs list. In particular, a value of 0, or if the field isn't
+          set, all the jobs in the jobs list are from the original
+          (without broadening) query. If this field is non-zero,
+          subsequent requests with offset after this result set should
+          contain all broadened results.
+      spell_correction:
+          The spell checking result, and correction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchJobsResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchJobsResponse)
+_sym_db.RegisterMessage(SearchJobsResponse.MatchingJob)
+_sym_db.RegisterMessage(SearchJobsResponse.CommuteInfo)
+
+BatchCreateJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchCreateJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHCREATEJOBSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Request to create a batch of jobs.
+  
+  
+  Attributes:
+      parent:
+          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".
+      jobs:
+          Required. The jobs to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.BatchCreateJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchCreateJobsRequest)
+
+BatchUpdateJobsRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchUpdateJobsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHUPDATEJOBSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Request to update a batch of jobs.
+  
+  
+  Attributes:
+      parent:
+          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".
+      jobs:
+          Required. The jobs to be updated.
+      update_mask:
+          Optional but strongly recommended to be provided for the best
+          service experience, also increase latency when checking status
+          of batch operation.  If [update\_mask][google.cloud.talent.v4b
+          eta1.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.Batc
+          hUpdateJobsRequest.update\_mask] is provided, The
+          [Job][google.cloud.talent.v4beta1.Job] inside [JobResult][goog
+          le.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.BatchUpdateJobsRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchUpdateJobsRequest)
+
+JobOperationResult = _reflection.GeneratedProtocolMessageType(
+    "JobOperationResult",
+    (_message.Message,),
+    dict(
+        JobResult=_reflection.GeneratedProtocolMessageType(
+            "JobResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_JOBOPERATIONRESULT_JOBRESULT,
+                __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+                __doc__="""Mutation result of a job.
+    
+    
+    Attributes:
+        job:
+            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 [re
+            quisition\_id][google.cloud.talent.v4beta1.Job.requisition\_id
+            ], use getJob method to retrieve detailed information of the
+            created/updated job.
+        status:
+            The status of the job processed. This field is populated if
+            the processing of the [job][google.cloud.talent.v4beta1.JobOpe
+            rationResult.JobResult.job] fails.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.JobOperationResult.JobResult)
+            ),
+        ),
+        DESCRIPTOR=_JOBOPERATIONRESULT,
+        __module__="google.cloud.talent_v4beta1.proto.job_service_pb2",
+        __doc__="""Output only.
+  
+  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.
+  
+  
+  Attributes:
+      job_results:
+          List of job mutation results from a batch mutate operation. It
+          can change until operation status is FINISHED, FAILED or
+          CANCELLED.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.JobOperationResult)
+    ),
+)
+_sym_db.RegisterMessage(JobOperationResult)
+_sym_db.RegisterMessage(JobOperationResult.JobResult)
+
+
+DESCRIPTOR._options = None
+
+_JOBSERVICE = _descriptor.ServiceDescriptor(
+    name="JobService",
+    full_name="google.cloud.talent.v4beta1.JobService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=3739,
+    serialized_end=5931,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateJob",
+            full_name="google.cloud.talent.v4beta1.JobService.CreateJob",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEJOBREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                '\202\323\344\223\002X"+/v4beta1/{parent=projects/*/tenants/*}/jobs:\001*Z&"!/v4beta1/{parent=projects/*}/jobs:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetJob",
+            full_name="google.cloud.talent.v4beta1.JobService.GetJob",
+            index=1,
+            containing_service=None,
+            input_type=_GETJOBREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002R\022+/v4beta1/{name=projects/*/tenants/*/jobs/*}Z#\022!/v4beta1/{name=projects/*/jobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateJob",
+            full_name="google.cloud.talent.v4beta1.JobService.UpdateJob",
+            index=2,
+            containing_service=None,
+            input_type=_UPDATEJOBREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2._JOB,
+            serialized_options=_b(
+                "\202\323\344\223\002`2//v4beta1/{job.name=projects/*/tenants/*/jobs/*}:\001*Z*2%/v4beta1/{job.name=projects/*/jobs/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteJob",
+            full_name="google.cloud.talent.v4beta1.JobService.DeleteJob",
+            index=3,
+            containing_service=None,
+            input_type=_DELETEJOBREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002R*+/v4beta1/{name=projects/*/tenants/*/jobs/*}Z#*!/v4beta1/{name=projects/*/jobs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListJobs",
+            full_name="google.cloud.talent.v4beta1.JobService.ListJobs",
+            index=4,
+            containing_service=None,
+            input_type=_LISTJOBSREQUEST,
+            output_type=_LISTJOBSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002R\022+/v4beta1/{parent=projects/*/tenants/*}/jobsZ#\022!/v4beta1/{parent=projects/*}/jobs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchDeleteJobs",
+            full_name="google.cloud.talent.v4beta1.JobService.BatchDeleteJobs",
+            index=5,
+            containing_service=None,
+            input_type=_BATCHDELETEJOBSREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002m"7/v4beta1/{parent=projects/*/tenants/*}/jobs:batchDelete:\001*Z/"-/v4beta1/{parent=projects/*}/jobs:batchDelete'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchJobs",
+            full_name="google.cloud.talent.v4beta1.JobService.SearchJobs",
+            index=6,
+            containing_service=None,
+            input_type=_SEARCHJOBSREQUEST,
+            output_type=_SEARCHJOBSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002f"2/v4beta1/{parent=projects/*/tenants/*}/jobs:search:\001*Z-"(/v4beta1/{parent=projects/*}/jobs:search:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchJobsForAlert",
+            full_name="google.cloud.talent.v4beta1.JobService.SearchJobsForAlert",
+            index=7,
+            containing_service=None,
+            input_type=_SEARCHJOBSREQUEST,
+            output_type=_SEARCHJOBSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002v":/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert:\001*Z5"0/v4beta1/{parent=projects/*}/jobs:searchForAlert:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchCreateJobs",
+            full_name="google.cloud.talent.v4beta1.JobService.BatchCreateJobs",
+            index=8,
+            containing_service=None,
+            input_type=_BATCHCREATEJOBSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002p"7/v4beta1/{parent=projects/*/tenants/*}/jobs:batchCreate:\001*Z2"-/v4beta1/{parent=projects/*}/jobs:batchCreate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchUpdateJobs",
+            full_name="google.cloud.talent.v4beta1.JobService.BatchUpdateJobs",
+            index=9,
+            containing_service=None,
+            input_type=_BATCHUPDATEJOBSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002p"7/v4beta1/{parent=projects/*/tenants/*}/jobs:batchUpdate:\001*Z2"-/v4beta1/{parent=projects/*}/jobs:batchUpdate:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_JOBSERVICE)
+
+DESCRIPTOR.services_by_name["JobService"] = _JOBSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/job_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/job_service_pb2_grpc.py
new file mode 100644
index 000000000000..a3b63f49e71e
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/job_service_pb2_grpc.py
@@ -0,0 +1,236 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    job_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    job_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class JobServiceStub(object):
+    """A service handles job management, including job CRUD, enumeration and search.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateJob = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/CreateJob",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.CreateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.GetJob = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/GetJob",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.GetJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.UpdateJob = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/UpdateJob",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.UpdateJobRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.Job.FromString,
+        )
+        self.DeleteJob = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/DeleteJob",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.DeleteJobRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListJobs = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/ListJobs",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.ListJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.ListJobsResponse.FromString,
+        )
+        self.BatchDeleteJobs = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/BatchDeleteJobs",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.BatchDeleteJobsRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.SearchJobs = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/SearchJobs",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsResponse.FromString,
+        )
+        self.SearchJobsForAlert = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/SearchJobsForAlert",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsResponse.FromString,
+        )
+        self.BatchCreateJobs = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/BatchCreateJobs",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.BatchCreateJobsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.BatchUpdateJobs = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.JobService/BatchUpdateJobs",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.BatchUpdateJobsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class JobServiceServicer(object):
+    """A service handles job management, including job CRUD, enumeration and search.
+  """
+
+    def CreateJob(self, request, context):
+        """Creates a new job.
+
+    Typically, the job becomes searchable within 10 seconds, but it may take
+    up to 5 minutes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetJob(self, request, context):
+        """Retrieves the specified job, whose status is OPEN or recently EXPIRED
+    within the last 90 days.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateJob(self, request, context):
+        """Updates specified job.
+
+    Typically, updated contents become visible in search results within 10
+    seconds, but it may take up to 5 minutes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteJob(self, request, context):
+        """Deletes the specified job.
+
+    Typically, the job becomes unsearchable within 10 seconds, but it may take
+    up to 5 minutes.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListJobs(self, request, context):
+        """Lists jobs by filter.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchDeleteJobs(self, request, context):
+        """Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchJobs(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchJobsForAlert(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchCreateJobs(self, request, context):
+        """Begins executing a batch create jobs operation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchUpdateJobs(self, request, context):
+        """Begins executing a batch update jobs operation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_JobServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateJob,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.CreateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "GetJob": grpc.unary_unary_rpc_method_handler(
+            servicer.GetJob,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.GetJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "UpdateJob": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateJob,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.UpdateJobRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__pb2.Job.SerializeToString,
+        ),
+        "DeleteJob": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteJob,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.DeleteJobRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListJobs,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.ListJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.ListJobsResponse.SerializeToString,
+        ),
+        "BatchDeleteJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchDeleteJobs,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.BatchDeleteJobsRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "SearchJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchJobs,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsResponse.SerializeToString,
+        ),
+        "SearchJobsForAlert": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchJobsForAlert,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.SearchJobsResponse.SerializeToString,
+        ),
+        "BatchCreateJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchCreateJobs,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.BatchCreateJobsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "BatchUpdateJobs": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchUpdateJobs,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_job__service__pb2.BatchUpdateJobsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.JobService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/proto/profile.proto b/talent/google/cloud/talent_v4beta1/proto/profile.proto
new file mode 100644
index 000000000000..819f13a62e62
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/profile.proto
@@ -0,0 +1,785 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+import "google/type/date.proto";
+import "google/type/postal_address.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "ProfileResourceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// Cloud Profile Discovery API definition
+
+// A resource that represents the profile for a job candidate (also referred to
+// as a "single-source profile").
+message 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".
+  string name = 1;
+
+  // Optional. Profile's id in client system if available. This value is not
+  // required to be unique to each profile. However, providing unique values
+  // makes it easier to specify individual profiles when filing support tickets.
+  //
+  // The maximum number of bytes allowed is 100.
+  string external_id = 2;
+
+  // Optional. 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.
+  //
+  // 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 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.
+  //
+  // 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.
+  //
+  // This is used to link multiple profiles to the same candidate. For example,
+  // 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.
+  string group_id = 5;
+
+  // Optional. 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.
+  google.protobuf.Timestamp create_time = 7;
+
+  // Optional. The timestamp when the profile was last updated at this source.
+  google.protobuf.Timestamp update_time = 8;
+
+  // Optional. The resume representing this profile.
+  Resume resume = 53;
+
+  // Optional. 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. 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.
+  repeated Email email_addresses = 13;
+
+  // Optional. The candidate's phone number(s).
+  repeated Phone phone_numbers = 14;
+
+  // Optional. 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.
+  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:
+  //
+  // * 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.
+  //
+  // 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:
+  //
+  // * 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.
+  //
+  // 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 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 limitation for max number of activities is 50.
+  repeated Activity activities = 20;
+
+  // Optional. 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.
+  repeated Patent patents = 22;
+
+  // Optional. The certifications acquired by the candidate.
+  repeated Certification certifications = 23;
+
+  // Output only. The resource names of the candidate's applications.
+  repeated string applications = 47;
+
+  // Output only. The resource names of the candidate's assignments.
+  repeated string assignments = 48;
+
+  // 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.
+  //
+  // At most 100 filterable and at most 100 unfilterable keys are supported. If
+  // limit is exceeded, an error is thrown. Custom attributes are `unfilterable`
+  // by default. These are filterable when the `filterable` flag is set to
+  // `true`.
+  //
+  // Numeric custom attributes: each key can only map to one numeric value,
+  // otherwise an error is thrown. Client can also filter on numeric custom
+  // attributes using '>', '<' or '=' operators.
+  //
+  // String custom attributes: each key can map up to 50 string values. For
+  // filterable string value, each value has a byte size of no more than 256B.
+  // For unfilterable string values, the maximum byte size of a single key is
+  // 64B. An error is thrown for any request exceeding the limit.
+  // The maximum total byte size is 10KB.
+  map<string, CustomAttribute> custom_attributes = 26;
+
+  // 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;
+
+  // 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;
+
+  // 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];
+}
+
+// Resource that represents a resume.
+message Resume {
+  // The format of a structured resume.
+  enum ResumeType {
+    // Default value.
+    RESUME_TYPE_UNSPECIFIED = 0;
+
+    // The profile contents in HR-XML format.
+    // See http://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
+    // information about Human Resources XML.
+    HRXML = 1;
+
+    // Resume type not specified.
+    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.
+  // [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].
+  ResumeType resume_type = 2;
+}
+
+// Resource that represents the name of a person.
+message PersonName {
+  // Resource that represents a person's structured name.
+  message PersonStructuredName {
+    // Optional. Given/first name.
+    //
+    // 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.
+    //
+    // Number of characters allowed is 100.
+    string preferred_name = 6;
+
+    // Optional. Middle initial.
+    //
+    // 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.
+    //
+    // 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.
+    //
+    // Number of characters allowed is 20.
+    repeated string suffixes = 4;
+
+    // Optional. Prefixes.
+    //
+    // Number of characters allowed is 20.
+    repeated string prefixes = 5;
+  }
+
+  // The name of a person. It can be one of
+  // [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".
+    //
+    // 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.)
+    PersonStructuredName structured_name = 2;
+  }
+
+  // Optional. 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.
+  string preferred_name = 3;
+}
+
+// Resource that represents a address.
+message Address {
+  // Optional. 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
+  // [structured_address][google.cloud.talent.v4beta1.Address.structured_address].
+  oneof address {
+    // Optional. Unstructured address.
+    //
+    // For example, "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
+    // "Sunnyvale, California".
+    //
+    // Number of characters allowed is 100.
+    string unstructured_address = 2;
+
+    // Optional. 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.
+  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.
+  ContactInfoUsage usage = 1;
+
+  // Optional. Email address.
+  //
+  // Number of characters allowed is 4,000.
+  string email_address = 2;
+}
+
+// Resource that represents a person's telephone number.
+message Phone {
+  // Enum that represents the type of the telephone.
+  enum PhoneType {
+    // Default value.
+    PHONE_TYPE_UNSPECIFIED = 0;
+
+    // A landline.
+    LANDLINE = 1;
+
+    // A mobile.
+    MOBILE = 2;
+
+    // A fax.
+    FAX = 3;
+
+    // A pager.
+    PAGER = 4;
+
+    // A TTY (test telephone) or TDD (telecommunication device for the deaf).
+    TTY_OR_TDD = 5;
+
+    // A voicemail.
+    VOICEMAIL = 6;
+
+    // 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
+    VIRTUAL = 7;
+
+    // Voice over IP numbers. This includes TSoIP (Telephony Service over IP).
+    VOIP = 8;
+
+    // In some regions (e.g. the USA), it is impossible to distinguish between
+    // fixed-line and mobile numbers by looking at the phone number itself.
+    MOBILE_OR_LANDLINE = 9;
+  }
+
+  // Optional. The usage of the phone. For example, SCHOOL, WORK, PERSONAL.
+  ContactInfoUsage usage = 1;
+
+  // Optional. The phone type. For example, LANDLINE, MOBILE, FAX.
+  PhoneType type = 2;
+
+  // Optional. 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
+  // format of "(xxx)xxx-xxxx", in profile searches the same phone format
+  // has to be provided.
+  //
+  // Number of characters allowed is 20.
+  string number = 3;
+
+  // Optional. When this number is available. Any descriptive string is
+  // expected.
+  //
+  // Number of characters allowed is 100.
+  string when_available = 4;
+}
+
+// Resource that represents a valid URI for a personal use.
+message PersonalUri {
+  // Optional. The personal URI.
+  //
+  // Number of characters allowed is 4,000.
+  string uri = 1;
+}
+
+// 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.
+  ContactInfoUsage usage = 1;
+
+  // Optional. The name of the contact method.
+  //
+  // For example, "hangout", "skype".
+  //
+  // Number of characters allowed is 100.
+  string name = 2;
+
+  // Optional. The contact id.
+  //
+  // Number of characters allowed is 100.
+  string contact_id = 3;
+}
+
+// Resource that represents an employment record of a candidate.
+message EmploymentRecord {
+  // Optional. Start date of the employment.
+  google.type.Date start_date = 1;
+
+  // Optional. End date of the employment.
+  google.type.Date end_date = 2;
+
+  // Optional. The name of the employer company/organization.
+  //
+  // For example, "Google", "Alphabet", and so on.
+  //
+  // Number of characters allowed is 250.
+  string employer_name = 3;
+
+  // Optional. 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.
+  Address address = 5;
+
+  // Optional. The job title of the employment.
+  //
+  // For example, "Software Engineer", "Data Scientist", and so on.
+  //
+  // Number of characters allowed is 250.
+  string job_title = 6;
+
+  // Optional. The description of job content.
+  //
+  // Number of characters allowed is 100,000.
+  string job_description = 7;
+
+  // Optional. If the jobs is a supervisor position.
+  google.protobuf.BoolValue is_supervisor = 8;
+
+  // Optional. If this employment is self-employed.
+  google.protobuf.BoolValue is_self_employed = 9;
+
+  // Optional. 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
+  // 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;
+}
+
+// Resource that represents an education record of a candidate.
+message EducationRecord {
+  // Optional. The start date of the education.
+  google.type.Date start_date = 1;
+
+  // Optional. The end date of the education.
+  google.type.Date end_date = 2;
+
+  // Optional. The expected graduation date if currently pursuing a degree.
+  google.type.Date expected_graduation_date = 3;
+
+  // Optional. The name of the school or institution.
+  //
+  // For example, "Stanford University", "UC Berkeley", and so on.
+  //
+  // Number of characters allowed is 250.
+  string school_name = 4;
+
+  // Optional. 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
+  // [structured_degree][google.cloud.talent.v4beta1.EducationRecord.structured_degree].
+  oneof degree {
+    // Optional. 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.
+    Degree structured_degree = 7;
+  }
+
+  // Optional. The description of the education.
+  //
+  // Number of characters allowed is 100,000.
+  string description = 8;
+
+  // Optional. 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;
+}
+
+// Resource that represents a degree pursuing or acquired by a candidate.
+message Degree {
+  // Optional. ISCED degree type.
+  DegreeType degree_type = 1;
+
+  // Optional. 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.
+  //
+  // For example, "Computer science", "engineering".
+  //
+  // Number of characters allowed is 100.
+  repeated string fields_of_study = 3;
+}
+
+// Resource that represents an individual or collaborative activity participated
+// in by a candidate, for example, an open-source project, a class assignment,
+// and so on.
+message Activity {
+  // Optional. Activity display name.
+  //
+  // Number of characters allowed is 100.
+  string display_name = 1;
+
+  // Optional. Activity description.
+  //
+  // Number of characters allowed is 100,000.
+  string description = 2;
+
+  // Optional. Activity URI.
+  //
+  // Number of characters allowed is 4,000.
+  string uri = 3;
+
+  // Optional. The first creation date of the activity.
+  google.type.Date create_date = 4;
+
+  // Optional. The last update date of the activity.
+  google.type.Date update_date = 5;
+
+  // Optional. 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.
+  //
+  // 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 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;
+
+  // 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;
+}
+
+// Resource that represents a publication resource of a candidate.
+message Publication {
+  // Optional. A list of author names.
+  //
+  // Number of characters allowed is 100.
+  repeated string authors = 1;
+
+  // Optional. The title of the publication.
+  //
+  // Number of characters allowed is 100.
+  string title = 2;
+
+  // Optional. The description of the publication.
+  //
+  // Number of characters allowed is 100,000.
+  string description = 3;
+
+  // Optional. The journal name of the publication.
+  //
+  // Number of characters allowed is 100.
+  string journal = 4;
+
+  // Optional. Volume number.
+  //
+  // Number of characters allowed is 100.
+  string volume = 5;
+
+  // Optional. The publisher of the journal.
+  //
+  // Number of characters allowed is 100.
+  string publisher = 6;
+
+  // Optional. The publication date.
+  google.type.Date publication_date = 7;
+
+  // Optional. The publication type.
+  //
+  // Number of characters allowed is 100.
+  string publication_type = 8;
+
+  // Optional. ISBN number.
+  //
+  // Number of characters allowed is 100.
+  string isbn = 9;
+}
+
+// Resource that represents the patent acquired by a candidate.
+message Patent {
+  // Optional. Name of the patent.
+  //
+  // Number of characters allowed is 100.
+  string display_name = 1;
+
+  // Optional. A list of inventors' names.
+  //
+  // Number of characters allowed for each is 100.
+  repeated string inventors = 2;
+
+  // Optional. 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.
+  google.type.Date patent_status_date = 4;
+
+  // Optional. The date that the patent was filed.
+  google.type.Date patent_filing_date = 5;
+
+  // Optional. The name of the patent office.
+  //
+  // Number of characters allowed is 100.
+  string patent_office = 6;
+
+  // Optional. The number of the patent.
+  //
+  // Number of characters allowed is 100.
+  string patent_number = 7;
+
+  // Optional. The description of the patent.
+  //
+  // Number of characters allowed is 100,000.
+  string patent_description = 8;
+
+  // Optional. The skills used in this patent.
+  repeated Skill skills_used = 9;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py b/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py
new file mode 100644
index 000000000000..195bd143568d
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/profile_pb2.py
@@ -0,0 +1,3374 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/profile.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.type import date_pb2 as google_dot_type_dot_date__pb2
+from google.type import postal_address_pb2 as google_dot_type_dot_postal__address__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/profile.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\024ProfileResourceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n/google/cloud/talent_v4beta1/proto/profile.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x16google/type/date.proto\x1a google/type/postal_address.proto"\xc1\x0b\n\x07Profile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x02 \x01(\t\x12\x0e\n\x06source\x18\x03 \x01(\t\x12\x0b\n\x03uri\x18\x04 \x01(\t\x12\x10\n\x08group_id\x18\x05 \x01(\t\x12.\n\nis_hirable\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12/\n\x0b\x63reate_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x33\n\x06resume\x18\x35 \x01(\x0b\x32#.google.cloud.talent.v4beta1.Resume\x12=\n\x0cperson_names\x18\x0b \x03(\x0b\x32\'.google.cloud.talent.v4beta1.PersonName\x12\x37\n\taddresses\x18\x0c \x03(\x0b\x32$.google.cloud.talent.v4beta1.Address\x12;\n\x0f\x65mail_addresses\x18\r \x03(\x0b\x32".google.cloud.talent.v4beta1.Email\x12\x39\n\rphone_numbers\x18\x0e \x03(\x0b\x32".google.cloud.talent.v4beta1.Phone\x12?\n\rpersonal_uris\x18\x0f \x03(\x0b\x32(.google.cloud.talent.v4beta1.PersonalUri\x12S\n\x17\x61\x64\x64itional_contact_info\x18\x10 \x03(\x0b\x32\x32.google.cloud.talent.v4beta1.AdditionalContactInfo\x12I\n\x12\x65mployment_records\x18\x11 \x03(\x0b\x32-.google.cloud.talent.v4beta1.EmploymentRecord\x12G\n\x11\x65\x64ucation_records\x18\x12 \x03(\x0b\x32,.google.cloud.talent.v4beta1.EducationRecord\x12\x32\n\x06skills\x18\x13 \x03(\x0b\x32".google.cloud.talent.v4beta1.Skill\x12\x39\n\nactivities\x18\x14 \x03(\x0b\x32%.google.cloud.talent.v4beta1.Activity\x12>\n\x0cpublications\x18\x15 \x03(\x0b\x32(.google.cloud.talent.v4beta1.Publication\x12\x34\n\x07patents\x18\x16 \x03(\x0b\x32#.google.cloud.talent.v4beta1.Patent\x12\x42\n\x0e\x63\x65rtifications\x18\x17 \x03(\x0b\x32*.google.cloud.talent.v4beta1.Certification\x12\x14\n\x0c\x61pplications\x18/ \x03(\t\x12\x13\n\x0b\x61ssignments\x18\x30 \x03(\t\x12U\n\x11\x63ustom_attributes\x18\x1a \x03(\x0b\x32:.google.cloud.talent.v4beta1.Profile.CustomAttributesEntry\x12\x11\n\tprocessed\x18\x1b \x01(\x08\x12\x17\n\x0fkeyword_snippet\x18\x1c \x01(\t\x12\x45\n\x11\x64\x65rived_addresses\x18@ \x03(\x0b\x32%.google.cloud.talent.v4beta1.LocationB\x03\xe0\x41\x03\x1a\x65\n\x15\x43ustomAttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12;\n\x05value\x18\x02 \x01(\x0b\x32,.google.cloud.talent.v4beta1.CustomAttribute:\x02\x38\x01"\xb5\x01\n\x06Resume\x12\x19\n\x11structured_resume\x18\x01 \x01(\t\x12\x43\n\x0bresume_type\x18\x02 \x01(\x0e\x32..google.cloud.talent.v4beta1.Resume.ResumeType"K\n\nResumeType\x12\x1b\n\x17RESUME_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05HRXML\x10\x01\x12\x15\n\x11OTHER_RESUME_TYPE\x10\x02"\xbc\x02\n\nPersonName\x12\x18\n\x0e\x66ormatted_name\x18\x01 \x01(\tH\x00\x12W\n\x0fstructured_name\x18\x02 \x01(\x0b\x32<.google.cloud.talent.v4beta1.PersonName.PersonStructuredNameH\x00\x12\x16\n\x0epreferred_name\x18\x03 \x01(\t\x1a\x93\x01\n\x14PersonStructuredName\x12\x12\n\ngiven_name\x18\x01 \x01(\t\x12\x16\n\x0epreferred_name\x18\x06 \x01(\t\x12\x16\n\x0emiddle_initial\x18\x02 \x01(\t\x12\x13\n\x0b\x66\x61mily_name\x18\x03 \x01(\t\x12\x10\n\x08suffixes\x18\x04 \x03(\t\x12\x10\n\x08prefixes\x18\x05 \x03(\tB\r\n\x0bperson_name"\xd9\x01\n\x07\x41\x64\x64ress\x12<\n\x05usage\x18\x01 \x01(\x0e\x32-.google.cloud.talent.v4beta1.ContactInfoUsage\x12\x1e\n\x14unstructured_address\x18\x02 \x01(\tH\x00\x12\x38\n\x12structured_address\x18\x03 \x01(\x0b\x32\x1a.google.type.PostalAddressH\x00\x12+\n\x07\x63urrent\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.BoolValueB\t\n\x07\x61\x64\x64ress"\\\n\x05\x45mail\x12<\n\x05usage\x18\x01 \x01(\x0e\x32-.google.cloud.talent.v4beta1.ContactInfoUsage\x12\x15\n\remail_address\x18\x02 \x01(\t"\xcf\x02\n\x05Phone\x12<\n\x05usage\x18\x01 \x01(\x0e\x32-.google.cloud.talent.v4beta1.ContactInfoUsage\x12:\n\x04type\x18\x02 \x01(\x0e\x32,.google.cloud.talent.v4beta1.Phone.PhoneType\x12\x0e\n\x06number\x18\x03 \x01(\t\x12\x16\n\x0ewhen_available\x18\x04 \x01(\t"\xa3\x01\n\tPhoneType\x12\x1a\n\x16PHONE_TYPE_UNSPECIFIED\x10\x00\x12\x0c\n\x08LANDLINE\x10\x01\x12\n\n\x06MOBILE\x10\x02\x12\x07\n\x03\x46\x41X\x10\x03\x12\t\n\x05PAGER\x10\x04\x12\x0e\n\nTTY_OR_TDD\x10\x05\x12\r\n\tVOICEMAIL\x10\x06\x12\x0b\n\x07VIRTUAL\x10\x07\x12\x08\n\x04VOIP\x10\x08\x12\x16\n\x12MOBILE_OR_LANDLINE\x10\t"\x1a\n\x0bPersonalUri\x12\x0b\n\x03uri\x18\x01 \x01(\t"w\n\x15\x41\x64\x64itionalContactInfo\x12<\n\x05usage\x18\x01 \x01(\x0e\x32-.google.cloud.talent.v4beta1.ContactInfoUsage\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x12\n\ncontact_id\x18\x03 \x01(\t"\xe3\x03\n\x10\x45mploymentRecord\x12%\n\nstart_date\x18\x01 \x01(\x0b\x32\x11.google.type.Date\x12#\n\x08\x65nd_date\x18\x02 \x01(\x0b\x32\x11.google.type.Date\x12\x15\n\remployer_name\x18\x03 \x01(\t\x12\x15\n\rdivision_name\x18\x04 \x01(\t\x12\x35\n\x07\x61\x64\x64ress\x18\x05 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Address\x12\x11\n\tjob_title\x18\x06 \x01(\t\x12\x17\n\x0fjob_description\x18\x07 \x01(\t\x12\x31\n\ris_supervisor\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x34\n\x10is_self_employed\x18\t \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12.\n\nis_current\x18\n \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x19\n\x11job_title_snippet\x18\x0b \x01(\t\x12\x1f\n\x17job_description_snippet\x18\x0c \x01(\t\x12\x1d\n\x15\x65mployer_name_snippet\x18\r \x01(\t"\xc2\x03\n\x0f\x45\x64ucationRecord\x12%\n\nstart_date\x18\x01 \x01(\x0b\x32\x11.google.type.Date\x12#\n\x08\x65nd_date\x18\x02 \x01(\x0b\x32\x11.google.type.Date\x12\x33\n\x18\x65xpected_graduation_date\x18\x03 \x01(\x0b\x32\x11.google.type.Date\x12\x13\n\x0bschool_name\x18\x04 \x01(\t\x12\x35\n\x07\x61\x64\x64ress\x18\x05 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Address\x12\x1c\n\x12\x64\x65gree_description\x18\x06 \x01(\tH\x00\x12@\n\x11structured_degree\x18\x07 \x01(\x0b\x32#.google.cloud.talent.v4beta1.DegreeH\x00\x12\x13\n\x0b\x64\x65scription\x18\x08 \x01(\t\x12.\n\nis_current\x18\t \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x1b\n\x13school_name_snippet\x18\n \x01(\t\x12\x16\n\x0e\x64\x65gree_snippet\x18\x0b \x01(\tB\x08\n\x06\x64\x65gree"t\n\x06\x44\x65gree\x12<\n\x0b\x64\x65gree_type\x18\x01 \x01(\x0e\x32\'.google.cloud.talent.v4beta1.DegreeType\x12\x13\n\x0b\x64\x65gree_name\x18\x02 \x01(\t\x12\x17\n\x0f\x66ields_of_study\x18\x03 \x03(\t"\xc3\x02\n\x08\x41\x63tivity\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x0b\n\x03uri\x18\x03 \x01(\t\x12&\n\x0b\x63reate_date\x18\x04 \x01(\x0b\x32\x11.google.type.Date\x12&\n\x0bupdate_date\x18\x05 \x01(\x0b\x32\x11.google.type.Date\x12\x14\n\x0cteam_members\x18\x06 \x03(\t\x12\x37\n\x0bskills_used\x18\x07 \x03(\x0b\x32".google.cloud.talent.v4beta1.Skill\x12\x1d\n\x15\x61\x63tivity_name_snippet\x18\x08 \x01(\t\x12$\n\x1c\x61\x63tivity_description_snippet\x18\t \x01(\t\x12\x1b\n\x13skills_used_snippet\x18\n \x03(\t"\xcb\x01\n\x0bPublication\x12\x0f\n\x07\x61uthors\x18\x01 \x03(\t\x12\r\n\x05title\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x0f\n\x07journal\x18\x04 \x01(\t\x12\x0e\n\x06volume\x18\x05 \x01(\t\x12\x11\n\tpublisher\x18\x06 \x01(\t\x12+\n\x10publication_date\x18\x07 \x01(\x0b\x32\x11.google.type.Date\x12\x18\n\x10publication_type\x18\x08 \x01(\t\x12\x0c\n\x04isbn\x18\t \x01(\t"\xa9\x02\n\x06Patent\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\t\x12\x11\n\tinventors\x18\x02 \x03(\t\x12\x15\n\rpatent_status\x18\x03 \x01(\t\x12-\n\x12patent_status_date\x18\x04 \x01(\x0b\x32\x11.google.type.Date\x12-\n\x12patent_filing_date\x18\x05 \x01(\x0b\x32\x11.google.type.Date\x12\x15\n\rpatent_office\x18\x06 \x01(\t\x12\x15\n\rpatent_number\x18\x07 \x01(\t\x12\x1a\n\x12patent_description\x18\x08 \x01(\t\x12\x37\n\x0bskills_used\x18\t \x03(\x0b\x32".google.cloud.talent.v4beta1.SkillB\x82\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x14ProfileResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_type_dot_date__pb2.DESCRIPTOR,
+        google_dot_type_dot_postal__address__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_RESUME_RESUMETYPE = _descriptor.EnumDescriptor(
+    name="ResumeType",
+    full_name="google.cloud.talent.v4beta1.Resume.ResumeType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RESUME_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HRXML", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OTHER_RESUME_TYPE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1929,
+    serialized_end=2004,
+)
+_sym_db.RegisterEnumDescriptor(_RESUME_RESUMETYPE)
+
+_PHONE_PHONETYPE = _descriptor.EnumDescriptor(
+    name="PhoneType",
+    full_name="google.cloud.talent.v4beta1.Phone.PhoneType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PHONE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LANDLINE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOBILE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAX", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAGER", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TTY_OR_TDD", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOICEMAIL", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIRTUAL", index=7, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VOIP", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOBILE_OR_LANDLINE",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2812,
+    serialized_end=2975,
+)
+_sym_db.RegisterEnumDescriptor(_PHONE_PHONETYPE)
+
+
+_PROFILE_CUSTOMATTRIBUTESENTRY = _descriptor.Descriptor(
+    name="CustomAttributesEntry",
+    full_name="google.cloud.talent.v4beta1.Profile.CustomAttributesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.talent.v4beta1.Profile.CustomAttributesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.talent.v4beta1.Profile.CustomAttributesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1719,
+    serialized_end=1820,
+)
+
+_PROFILE = _descriptor.Descriptor(
+    name="Profile",
+    full_name="google.cloud.talent.v4beta1.Profile",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.Profile.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="external_id",
+            full_name="google.cloud.talent.v4beta1.Profile.external_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.talent.v4beta1.Profile.source",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.talent.v4beta1.Profile.uri",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="group_id",
+            full_name="google.cloud.talent.v4beta1.Profile.group_id",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_hirable",
+            full_name="google.cloud.talent.v4beta1.Profile.is_hirable",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.talent.v4beta1.Profile.create_time",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.talent.v4beta1.Profile.update_time",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume",
+            full_name="google.cloud.talent.v4beta1.Profile.resume",
+            index=8,
+            number=53,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="person_names",
+            full_name="google.cloud.talent.v4beta1.Profile.person_names",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="addresses",
+            full_name="google.cloud.talent.v4beta1.Profile.addresses",
+            index=10,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="email_addresses",
+            full_name="google.cloud.talent.v4beta1.Profile.email_addresses",
+            index=11,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="phone_numbers",
+            full_name="google.cloud.talent.v4beta1.Profile.phone_numbers",
+            index=12,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="personal_uris",
+            full_name="google.cloud.talent.v4beta1.Profile.personal_uris",
+            index=13,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="additional_contact_info",
+            full_name="google.cloud.talent.v4beta1.Profile.additional_contact_info",
+            index=14,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="employment_records",
+            full_name="google.cloud.talent.v4beta1.Profile.employment_records",
+            index=15,
+            number=17,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="education_records",
+            full_name="google.cloud.talent.v4beta1.Profile.education_records",
+            index=16,
+            number=18,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skills",
+            full_name="google.cloud.talent.v4beta1.Profile.skills",
+            index=17,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="activities",
+            full_name="google.cloud.talent.v4beta1.Profile.activities",
+            index=18,
+            number=20,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publications",
+            full_name="google.cloud.talent.v4beta1.Profile.publications",
+            index=19,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patents",
+            full_name="google.cloud.talent.v4beta1.Profile.patents",
+            index=20,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="certifications",
+            full_name="google.cloud.talent.v4beta1.Profile.certifications",
+            index=21,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="applications",
+            full_name="google.cloud.talent.v4beta1.Profile.applications",
+            index=22,
+            number=47,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="assignments",
+            full_name="google.cloud.talent.v4beta1.Profile.assignments",
+            index=23,
+            number=48,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_attributes",
+            full_name="google.cloud.talent.v4beta1.Profile.custom_attributes",
+            index=24,
+            number=26,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="processed",
+            full_name="google.cloud.talent.v4beta1.Profile.processed",
+            index=25,
+            number=27,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keyword_snippet",
+            full_name="google.cloud.talent.v4beta1.Profile.keyword_snippet",
+            index=26,
+            number=28,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="derived_addresses",
+            full_name="google.cloud.talent.v4beta1.Profile.derived_addresses",
+            index=27,
+            number=64,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\003"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PROFILE_CUSTOMATTRIBUTESENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=347,
+    serialized_end=1820,
+)
+
+
+_RESUME = _descriptor.Descriptor(
+    name="Resume",
+    full_name="google.cloud.talent.v4beta1.Resume",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="structured_resume",
+            full_name="google.cloud.talent.v4beta1.Resume.structured_resume",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resume_type",
+            full_name="google.cloud.talent.v4beta1.Resume.resume_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_RESUME_RESUMETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1823,
+    serialized_end=2004,
+)
+
+
+_PERSONNAME_PERSONSTRUCTUREDNAME = _descriptor.Descriptor(
+    name="PersonStructuredName",
+    full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="given_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName.given_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="preferred_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName.preferred_name",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="middle_initial",
+            full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName.middle_initial",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="family_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName.family_name",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="suffixes",
+            full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName.suffixes",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="prefixes",
+            full_name="google.cloud.talent.v4beta1.PersonName.PersonStructuredName.prefixes",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2161,
+    serialized_end=2308,
+)
+
+_PERSONNAME = _descriptor.Descriptor(
+    name="PersonName",
+    full_name="google.cloud.talent.v4beta1.PersonName",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="formatted_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.formatted_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.structured_name",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="preferred_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.preferred_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PERSONNAME_PERSONSTRUCTUREDNAME],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="person_name",
+            full_name="google.cloud.talent.v4beta1.PersonName.person_name",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2007,
+    serialized_end=2323,
+)
+
+
+_ADDRESS = _descriptor.Descriptor(
+    name="Address",
+    full_name="google.cloud.talent.v4beta1.Address",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="usage",
+            full_name="google.cloud.talent.v4beta1.Address.usage",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unstructured_address",
+            full_name="google.cloud.talent.v4beta1.Address.unstructured_address",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_address",
+            full_name="google.cloud.talent.v4beta1.Address.structured_address",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="current",
+            full_name="google.cloud.talent.v4beta1.Address.current",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="address",
+            full_name="google.cloud.talent.v4beta1.Address.address",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2326,
+    serialized_end=2543,
+)
+
+
+_EMAIL = _descriptor.Descriptor(
+    name="Email",
+    full_name="google.cloud.talent.v4beta1.Email",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="usage",
+            full_name="google.cloud.talent.v4beta1.Email.usage",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="email_address",
+            full_name="google.cloud.talent.v4beta1.Email.email_address",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2545,
+    serialized_end=2637,
+)
+
+
+_PHONE = _descriptor.Descriptor(
+    name="Phone",
+    full_name="google.cloud.talent.v4beta1.Phone",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="usage",
+            full_name="google.cloud.talent.v4beta1.Phone.usage",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.talent.v4beta1.Phone.type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="number",
+            full_name="google.cloud.talent.v4beta1.Phone.number",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="when_available",
+            full_name="google.cloud.talent.v4beta1.Phone.when_available",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_PHONE_PHONETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2640,
+    serialized_end=2975,
+)
+
+
+_PERSONALURI = _descriptor.Descriptor(
+    name="PersonalUri",
+    full_name="google.cloud.talent.v4beta1.PersonalUri",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.talent.v4beta1.PersonalUri.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2977,
+    serialized_end=3003,
+)
+
+
+_ADDITIONALCONTACTINFO = _descriptor.Descriptor(
+    name="AdditionalContactInfo",
+    full_name="google.cloud.talent.v4beta1.AdditionalContactInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="usage",
+            full_name="google.cloud.talent.v4beta1.AdditionalContactInfo.usage",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.AdditionalContactInfo.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="contact_id",
+            full_name="google.cloud.talent.v4beta1.AdditionalContactInfo.contact_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3005,
+    serialized_end=3124,
+)
+
+
+_EMPLOYMENTRECORD = _descriptor.Descriptor(
+    name="EmploymentRecord",
+    full_name="google.cloud.talent.v4beta1.EmploymentRecord",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_date",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.start_date",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_date",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.end_date",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="employer_name",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.employer_name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="division_name",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.division_name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="address",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.address",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_title",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.job_title",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_description",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.job_description",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_supervisor",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.is_supervisor",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_self_employed",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.is_self_employed",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_current",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.is_current",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_title_snippet",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.job_title_snippet",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="job_description_snippet",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.job_description_snippet",
+            index=11,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="employer_name_snippet",
+            full_name="google.cloud.talent.v4beta1.EmploymentRecord.employer_name_snippet",
+            index=12,
+            number=13,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3127,
+    serialized_end=3610,
+)
+
+
+_EDUCATIONRECORD = _descriptor.Descriptor(
+    name="EducationRecord",
+    full_name="google.cloud.talent.v4beta1.EducationRecord",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_date",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.start_date",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_date",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.end_date",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expected_graduation_date",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.expected_graduation_date",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="school_name",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.school_name",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="address",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.address",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="degree_description",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.degree_description",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="structured_degree",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.structured_degree",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.description",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_current",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.is_current",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="school_name_snippet",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.school_name_snippet",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="degree_snippet",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.degree_snippet",
+            index=10,
+            number=11,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="degree",
+            full_name="google.cloud.talent.v4beta1.EducationRecord.degree",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3613,
+    serialized_end=4063,
+)
+
+
+_DEGREE = _descriptor.Descriptor(
+    name="Degree",
+    full_name="google.cloud.talent.v4beta1.Degree",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="degree_type",
+            full_name="google.cloud.talent.v4beta1.Degree.degree_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="degree_name",
+            full_name="google.cloud.talent.v4beta1.Degree.degree_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields_of_study",
+            full_name="google.cloud.talent.v4beta1.Degree.fields_of_study",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4065,
+    serialized_end=4181,
+)
+
+
+_ACTIVITY = _descriptor.Descriptor(
+    name="Activity",
+    full_name="google.cloud.talent.v4beta1.Activity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.talent.v4beta1.Activity.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.talent.v4beta1.Activity.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.talent.v4beta1.Activity.uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_date",
+            full_name="google.cloud.talent.v4beta1.Activity.create_date",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_date",
+            full_name="google.cloud.talent.v4beta1.Activity.update_date",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="team_members",
+            full_name="google.cloud.talent.v4beta1.Activity.team_members",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skills_used",
+            full_name="google.cloud.talent.v4beta1.Activity.skills_used",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="activity_name_snippet",
+            full_name="google.cloud.talent.v4beta1.Activity.activity_name_snippet",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="activity_description_snippet",
+            full_name="google.cloud.talent.v4beta1.Activity.activity_description_snippet",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skills_used_snippet",
+            full_name="google.cloud.talent.v4beta1.Activity.skills_used_snippet",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4184,
+    serialized_end=4507,
+)
+
+
+_PUBLICATION = _descriptor.Descriptor(
+    name="Publication",
+    full_name="google.cloud.talent.v4beta1.Publication",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="authors",
+            full_name="google.cloud.talent.v4beta1.Publication.authors",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="title",
+            full_name="google.cloud.talent.v4beta1.Publication.title",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.talent.v4beta1.Publication.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="journal",
+            full_name="google.cloud.talent.v4beta1.Publication.journal",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="volume",
+            full_name="google.cloud.talent.v4beta1.Publication.volume",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publisher",
+            full_name="google.cloud.talent.v4beta1.Publication.publisher",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publication_date",
+            full_name="google.cloud.talent.v4beta1.Publication.publication_date",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="publication_type",
+            full_name="google.cloud.talent.v4beta1.Publication.publication_type",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="isbn",
+            full_name="google.cloud.talent.v4beta1.Publication.isbn",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4510,
+    serialized_end=4713,
+)
+
+
+_PATENT = _descriptor.Descriptor(
+    name="Patent",
+    full_name="google.cloud.talent.v4beta1.Patent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.talent.v4beta1.Patent.display_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="inventors",
+            full_name="google.cloud.talent.v4beta1.Patent.inventors",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patent_status",
+            full_name="google.cloud.talent.v4beta1.Patent.patent_status",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patent_status_date",
+            full_name="google.cloud.talent.v4beta1.Patent.patent_status_date",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patent_filing_date",
+            full_name="google.cloud.talent.v4beta1.Patent.patent_filing_date",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patent_office",
+            full_name="google.cloud.talent.v4beta1.Patent.patent_office",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patent_number",
+            full_name="google.cloud.talent.v4beta1.Patent.patent_number",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="patent_description",
+            full_name="google.cloud.talent.v4beta1.Patent.patent_description",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="skills_used",
+            full_name="google.cloud.talent.v4beta1.Patent.skills_used",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4716,
+    serialized_end=5013,
+)
+
+_PROFILE_CUSTOMATTRIBUTESENTRY.fields_by_name[
+    "value"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CUSTOMATTRIBUTE
+)
+_PROFILE_CUSTOMATTRIBUTESENTRY.containing_type = _PROFILE
+_PROFILE.fields_by_name[
+    "is_hirable"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_PROFILE.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PROFILE.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PROFILE.fields_by_name["resume"].message_type = _RESUME
+_PROFILE.fields_by_name["person_names"].message_type = _PERSONNAME
+_PROFILE.fields_by_name["addresses"].message_type = _ADDRESS
+_PROFILE.fields_by_name["email_addresses"].message_type = _EMAIL
+_PROFILE.fields_by_name["phone_numbers"].message_type = _PHONE
+_PROFILE.fields_by_name["personal_uris"].message_type = _PERSONALURI
+_PROFILE.fields_by_name["additional_contact_info"].message_type = _ADDITIONALCONTACTINFO
+_PROFILE.fields_by_name["employment_records"].message_type = _EMPLOYMENTRECORD
+_PROFILE.fields_by_name["education_records"].message_type = _EDUCATIONRECORD
+_PROFILE.fields_by_name[
+    "skills"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._SKILL
+_PROFILE.fields_by_name["activities"].message_type = _ACTIVITY
+_PROFILE.fields_by_name["publications"].message_type = _PUBLICATION
+_PROFILE.fields_by_name["patents"].message_type = _PATENT
+_PROFILE.fields_by_name[
+    "certifications"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CERTIFICATION
+)
+_PROFILE.fields_by_name[
+    "custom_attributes"
+].message_type = _PROFILE_CUSTOMATTRIBUTESENTRY
+_PROFILE.fields_by_name[
+    "derived_addresses"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._LOCATION
+)
+_RESUME.fields_by_name["resume_type"].enum_type = _RESUME_RESUMETYPE
+_RESUME_RESUMETYPE.containing_type = _RESUME
+_PERSONNAME_PERSONSTRUCTUREDNAME.containing_type = _PERSONNAME
+_PERSONNAME.fields_by_name[
+    "structured_name"
+].message_type = _PERSONNAME_PERSONSTRUCTUREDNAME
+_PERSONNAME.oneofs_by_name["person_name"].fields.append(
+    _PERSONNAME.fields_by_name["formatted_name"]
+)
+_PERSONNAME.fields_by_name[
+    "formatted_name"
+].containing_oneof = _PERSONNAME.oneofs_by_name["person_name"]
+_PERSONNAME.oneofs_by_name["person_name"].fields.append(
+    _PERSONNAME.fields_by_name["structured_name"]
+)
+_PERSONNAME.fields_by_name[
+    "structured_name"
+].containing_oneof = _PERSONNAME.oneofs_by_name["person_name"]
+_ADDRESS.fields_by_name[
+    "usage"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CONTACTINFOUSAGE
+)
+_ADDRESS.fields_by_name[
+    "structured_address"
+].message_type = google_dot_type_dot_postal__address__pb2._POSTALADDRESS
+_ADDRESS.fields_by_name[
+    "current"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_ADDRESS.oneofs_by_name["address"].fields.append(
+    _ADDRESS.fields_by_name["unstructured_address"]
+)
+_ADDRESS.fields_by_name[
+    "unstructured_address"
+].containing_oneof = _ADDRESS.oneofs_by_name["address"]
+_ADDRESS.oneofs_by_name["address"].fields.append(
+    _ADDRESS.fields_by_name["structured_address"]
+)
+_ADDRESS.fields_by_name[
+    "structured_address"
+].containing_oneof = _ADDRESS.oneofs_by_name["address"]
+_EMAIL.fields_by_name[
+    "usage"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CONTACTINFOUSAGE
+)
+_PHONE.fields_by_name[
+    "usage"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CONTACTINFOUSAGE
+)
+_PHONE.fields_by_name["type"].enum_type = _PHONE_PHONETYPE
+_PHONE_PHONETYPE.containing_type = _PHONE
+_ADDITIONALCONTACTINFO.fields_by_name[
+    "usage"
+].enum_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._CONTACTINFOUSAGE
+)
+_EMPLOYMENTRECORD.fields_by_name[
+    "start_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_EMPLOYMENTRECORD.fields_by_name[
+    "end_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_EMPLOYMENTRECORD.fields_by_name["address"].message_type = _ADDRESS
+_EMPLOYMENTRECORD.fields_by_name[
+    "is_supervisor"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_EMPLOYMENTRECORD.fields_by_name[
+    "is_self_employed"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_EMPLOYMENTRECORD.fields_by_name[
+    "is_current"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_EDUCATIONRECORD.fields_by_name[
+    "start_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_EDUCATIONRECORD.fields_by_name[
+    "end_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_EDUCATIONRECORD.fields_by_name[
+    "expected_graduation_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_EDUCATIONRECORD.fields_by_name["address"].message_type = _ADDRESS
+_EDUCATIONRECORD.fields_by_name["structured_degree"].message_type = _DEGREE
+_EDUCATIONRECORD.fields_by_name[
+    "is_current"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_EDUCATIONRECORD.oneofs_by_name["degree"].fields.append(
+    _EDUCATIONRECORD.fields_by_name["degree_description"]
+)
+_EDUCATIONRECORD.fields_by_name[
+    "degree_description"
+].containing_oneof = _EDUCATIONRECORD.oneofs_by_name["degree"]
+_EDUCATIONRECORD.oneofs_by_name["degree"].fields.append(
+    _EDUCATIONRECORD.fields_by_name["structured_degree"]
+)
+_EDUCATIONRECORD.fields_by_name[
+    "structured_degree"
+].containing_oneof = _EDUCATIONRECORD.oneofs_by_name["degree"]
+_DEGREE.fields_by_name[
+    "degree_type"
+].enum_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._DEGREETYPE
+_ACTIVITY.fields_by_name[
+    "create_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_ACTIVITY.fields_by_name[
+    "update_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_ACTIVITY.fields_by_name[
+    "skills_used"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._SKILL
+_PUBLICATION.fields_by_name[
+    "publication_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_PATENT.fields_by_name[
+    "patent_status_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_PATENT.fields_by_name[
+    "patent_filing_date"
+].message_type = google_dot_type_dot_date__pb2._DATE
+_PATENT.fields_by_name[
+    "skills_used"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._SKILL
+DESCRIPTOR.message_types_by_name["Profile"] = _PROFILE
+DESCRIPTOR.message_types_by_name["Resume"] = _RESUME
+DESCRIPTOR.message_types_by_name["PersonName"] = _PERSONNAME
+DESCRIPTOR.message_types_by_name["Address"] = _ADDRESS
+DESCRIPTOR.message_types_by_name["Email"] = _EMAIL
+DESCRIPTOR.message_types_by_name["Phone"] = _PHONE
+DESCRIPTOR.message_types_by_name["PersonalUri"] = _PERSONALURI
+DESCRIPTOR.message_types_by_name["AdditionalContactInfo"] = _ADDITIONALCONTACTINFO
+DESCRIPTOR.message_types_by_name["EmploymentRecord"] = _EMPLOYMENTRECORD
+DESCRIPTOR.message_types_by_name["EducationRecord"] = _EDUCATIONRECORD
+DESCRIPTOR.message_types_by_name["Degree"] = _DEGREE
+DESCRIPTOR.message_types_by_name["Activity"] = _ACTIVITY
+DESCRIPTOR.message_types_by_name["Publication"] = _PUBLICATION
+DESCRIPTOR.message_types_by_name["Patent"] = _PATENT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Profile = _reflection.GeneratedProtocolMessageType(
+    "Profile",
+    (_message.Message,),
+    dict(
+        CustomAttributesEntry=_reflection.GeneratedProtocolMessageType(
+            "CustomAttributesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PROFILE_CUSTOMATTRIBUTESENTRY,
+                __module__="google.cloud.talent_v4beta1.proto.profile_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Profile.CustomAttributesEntry)
+            ),
+        ),
+        DESCRIPTOR=_PROFILE,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""A resource that represents the profile for a job candidate (also
+  referred to as a "single-source profile").
+  
+  
+  Attributes:
+      name:
+          Required during profile update.  Resource name assigned to a
+          profile by the API.  The format is "projects/{project\_id}/ten
+          ants/{tenant\_id}/profiles/{profile\_id}", for example,
+          "projects/api-test-project/tenants/foo/profiles/bar".
+      external_id:
+          Optional. Profile's id in client system if available. This
+          value is not required to be unique to each profile. However,
+          providing unique values makes it easier to specify individual
+          profiles when filing support tickets.  The maximum number of
+          bytes allowed is 100.
+      source:
+          Optional. 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.  The maximum number of bytes allowed is 100.
+      uri:
+          Optional. The URI set by clients that links to this profile's
+          client-side copy.  The maximum number of bytes allowed is
+          4000.
+      group_id:
+          Optional. 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.  This is
+          used to link multiple profiles to the same candidate. For
+          example, 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.
+      is_hirable:
+          Optional. Indicates the hirable status of the candidate.
+      create_time:
+          Optional. The timestamp when the profile was first created at
+          this source.
+      update_time:
+          Optional. The timestamp when the profile was last updated at
+          this source.
+      resume:
+          Optional. The resume representing this profile.
+      person_names:
+          Optional. The names of the candidate this profile references.
+          Currently only one person name is supported.
+      addresses:
+          Optional. 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.
+      email_addresses:
+          Optional. The candidate's email addresses.
+      phone_numbers:
+          Optional. The candidate's phone number(s).
+      personal_uris:
+          Optional. The candidate's personal URIs.
+      additional_contact_info:
+          Optional. Available contact information besides
+          [addresses][google.cloud.talent.v4beta1.Profile.addresses], [e
+          mail\_addresses][google.cloud.talent.v4beta1.Profile.email\_ad
+          dresses], [phone\_numbers][google.cloud.talent.v4beta1.Profile
+          .phone\_numbers] and [personal\_uris][google.cloud.talent.v4be
+          ta1.Profile.personal\_uris]. For example, Hang-out, Skype.
+      employment_records:
+          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:  -  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\_cu
+          rrent]    for the current employment if possible. If not, it's
+          inferred from    user inputs.  The limitation for max number
+          of employment records is 100.
+      education_records:
+          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:  -  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.  The limitation for max number of
+          education records is 100.
+      skills:
+          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 limitation for max number of
+          skills is 500.
+      activities:
+          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\_reco
+          rds].  The limitation for max number of activities is 50.
+      publications:
+          Optional. The publications published by the candidate.  The
+          limitation for max number of publications is 50.
+      patents:
+          Optional. The patents acquired by the candidate.
+      certifications:
+          Optional. The certifications acquired by the candidate.
+      applications:
+          Output only. The resource names of the candidate's
+          applications.
+      assignments:
+          Output only. The resource names of the candidate's
+          assignments.
+      custom_attributes:
+          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.  At most 100 filterable and at most 100
+          unfilterable keys are supported. If limit is exceeded, an
+          error is thrown. Custom attributes are ``unfilterable`` by
+          default. These are filterable when the ``filterable`` flag is
+          set to ``true``.  Numeric custom attributes: each key can only
+          map to one numeric value, otherwise an error is thrown. Client
+          can also filter on numeric custom attributes using '>', '<' or
+          '=' operators.  String custom attributes: each key can map up
+          to 50 string values. For filterable string value, each value
+          has a byte size of no more than 256B. For unfilterable string
+          values, the maximum byte size of a single key is 64B. An error
+          is thrown for any request exceeding the limit. The maximum
+          total byte size is 10KB.
+      processed:
+          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.
+      keyword_snippet:
+          Output only. Keyword snippet shows how the search result is
+          related to a search query. This is only returned in [SearchPro
+          filesResponse][google.cloud.talent.v4beta1.SearchProfilesRespo
+          nse].
+      derived_addresses:
+          Output only. Derived locations of the profile, resolved from [
+          Profile.addresses][google.cloud.talent.v4beta1.Profile.address
+          es].  [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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Profile)
+    ),
+)
+_sym_db.RegisterMessage(Profile)
+_sym_db.RegisterMessage(Profile.CustomAttributesEntry)
+
+Resume = _reflection.GeneratedProtocolMessageType(
+    "Resume",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUME,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a resume.
+  
+  
+  Attributes:
+      structured_resume:
+          Optional. Users can create a profile with only this field
+          field, if [resume\_type][google.cloud.talent.v4beta1.Resume.re
+          sume\_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][googl
+          e.cloud.talent.v4beta1.EmploymentRecord], [EducationRecord][go
+          ogle.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.
+      resume_type:
+          Optional. The format of [structured\_resume][google.cloud.tale
+          nt.v4beta1.Resume.structured\_resume].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Resume)
+    ),
+)
+_sym_db.RegisterMessage(Resume)
+
+PersonName = _reflection.GeneratedProtocolMessageType(
+    "PersonName",
+    (_message.Message,),
+    dict(
+        PersonStructuredName=_reflection.GeneratedProtocolMessageType(
+            "PersonStructuredName",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PERSONNAME_PERSONSTRUCTUREDNAME,
+                __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+                __doc__="""Resource that represents a person's structured name.
+    
+    
+    Attributes:
+        given_name:
+            Optional. Given/first name.  It's derived from [formatted\_nam
+            e][google.cloud.talent.v4beta1.PersonName.formatted\_name] if
+            not provided.  Number of characters allowed is 100.
+        preferred_name:
+            Optional. Preferred given/first name or nickname.  Number of
+            characters allowed is 100.
+        middle_initial:
+            Optional. Middle initial.  It's derived from [formatted\_name]
+            [google.cloud.talent.v4beta1.PersonName.formatted\_name] if
+            not provided.  Number of characters allowed is 20.
+        family_name:
+            Optional. Family/last name.  It's derived from [formatted\_nam
+            e][google.cloud.talent.v4beta1.PersonName.formatted\_name] if
+            not provided.  Number of characters allowed is 100.
+        suffixes:
+            Optional. Suffixes.  Number of characters allowed is 20.
+        prefixes:
+            Optional. Prefixes.  Number of characters allowed is 20.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.PersonName.PersonStructuredName)
+            ),
+        ),
+        DESCRIPTOR=_PERSONNAME,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents the name of a person.
+  
+  
+  Attributes:
+      person_name:
+          The name of a person. It can be one of [formatted\_name][googl
+          e.cloud.talent.v4beta1.PersonName.formatted\_name] or [structu
+          red\_name][google.cloud.talent.v4beta1.PersonName.structured\_
+          name].
+      formatted_name:
+          Optional. A string represents a person's full name. For
+          example, "Dr. John Smith".  Number of characters allowed is
+          100.
+      structured_name:
+          Optional. A person's name in a structured way (last name,
+          first name, suffix, and so on.)
+      preferred_name:
+          Optional. Preferred name for the person. This field is ignored
+          if [structured\_name][google.cloud.talent.v4beta1.PersonName.s
+          tructured\_name] is provided.  Number of characters allowed is
+          100.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.PersonName)
+    ),
+)
+_sym_db.RegisterMessage(PersonName)
+_sym_db.RegisterMessage(PersonName.PersonStructuredName)
+
+Address = _reflection.GeneratedProtocolMessageType(
+    "Address",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDRESS,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a address.
+  
+  
+  Attributes:
+      usage:
+          Optional. The usage of the address. For example, SCHOOL, WORK,
+          PERSONAL.
+      address:
+          The address of a person. It can be one of [unstructured\_addre
+          ss][google.cloud.talent.v4beta1.Address.unstructured\_address]
+          or [structured\_address][google.cloud.talent.v4beta1.Address.s
+          tructured\_address].
+      unstructured_address:
+          Optional. Unstructured address.  For example, "1600
+          Amphitheatre Pkwy, Mountain View, CA 94043", "Sunnyvale,
+          California".  Number of characters allowed is 100.
+      structured_address:
+          Optional. Structured address that contains street address,
+          city, state, country, and so on.
+      current:
+          Optional. Indicates if it's the person's current address.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Address)
+    ),
+)
+_sym_db.RegisterMessage(Address)
+
+Email = _reflection.GeneratedProtocolMessageType(
+    "Email",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EMAIL,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a person's email address.
+  
+  
+  Attributes:
+      usage:
+          Optional. The usage of the email address. For example, SCHOOL,
+          WORK, PERSONAL.
+      email_address:
+          Optional. Email address.  Number of characters allowed is
+          4,000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Email)
+    ),
+)
+_sym_db.RegisterMessage(Email)
+
+Phone = _reflection.GeneratedProtocolMessageType(
+    "Phone",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PHONE,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a person's telephone number.
+  
+  
+  Attributes:
+      usage:
+          Optional. The usage of the phone. For example, SCHOOL, WORK,
+          PERSONAL.
+      type:
+          Optional. The phone type. For example, LANDLINE, MOBILE, FAX.
+      number:
+          Optional. 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 format of
+          "(xxx)xxx-xxxx", in profile searches the same phone format has
+          to be provided.  Number of characters allowed is 20.
+      when_available:
+          Optional. When this number is available. Any descriptive
+          string is expected.  Number of characters allowed is 100.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Phone)
+    ),
+)
+_sym_db.RegisterMessage(Phone)
+
+PersonalUri = _reflection.GeneratedProtocolMessageType(
+    "PersonalUri",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PERSONALURI,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a valid URI for a personal use.
+  
+  
+  Attributes:
+      uri:
+          Optional. The personal URI.  Number of characters allowed is
+          4,000.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.PersonalUri)
+    ),
+)
+_sym_db.RegisterMessage(PersonalUri)
+
+AdditionalContactInfo = _reflection.GeneratedProtocolMessageType(
+    "AdditionalContactInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDITIONALCONTACTINFO,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents contact information other than phone, email,
+  URI and addresses.
+  
+  
+  Attributes:
+      usage:
+          Optional. The usage of this contact method. For example,
+          SCHOOL, WORK, PERSONAL.
+      name:
+          Optional. The name of the contact method.  For example,
+          "hangout", "skype".  Number of characters allowed is 100.
+      contact_id:
+          Optional. The contact id.  Number of characters allowed is
+          100.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.AdditionalContactInfo)
+    ),
+)
+_sym_db.RegisterMessage(AdditionalContactInfo)
+
+EmploymentRecord = _reflection.GeneratedProtocolMessageType(
+    "EmploymentRecord",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EMPLOYMENTRECORD,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents an employment record of a candidate.
+  
+  
+  Attributes:
+      start_date:
+          Optional. Start date of the employment.
+      end_date:
+          Optional. End date of the employment.
+      employer_name:
+          Optional. The name of the employer company/organization.  For
+          example, "Google", "Alphabet", and so on.  Number of
+          characters allowed is 250.
+      division_name:
+          Optional. The division name of the employment.  For example,
+          division, department, client, and so on.  Number of characters
+          allowed is 100.
+      address:
+          Optional. The physical address of the employer.
+      job_title:
+          Optional. The job title of the employment.  For example,
+          "Software Engineer", "Data Scientist", and so on.  Number of
+          characters allowed is 250.
+      job_description:
+          Optional. The description of job content.  Number of
+          characters allowed is 100,000.
+      is_supervisor:
+          Optional. If the jobs is a supervisor position.
+      is_self_employed:
+          Optional. If this employment is self-employed.
+      is_current:
+          Optional. If this employment is current.
+      job_title_snippet:
+          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][goog
+          le.cloud.talent.v4beta1.EmploymentRecord.job\_title] isn't
+          related to the search query.
+      job_description_snippet:
+          Output only. The job description snippet shows how the [job\_d
+          escription][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.
+      employer_name_snippet:
+          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 [employ
+          er\_name][google.cloud.talent.v4beta1.EmploymentRecord.employe
+          r\_name] isn't related to the search query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.EmploymentRecord)
+    ),
+)
+_sym_db.RegisterMessage(EmploymentRecord)
+
+EducationRecord = _reflection.GeneratedProtocolMessageType(
+    "EducationRecord",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EDUCATIONRECORD,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents an education record of a candidate.
+  
+  
+  Attributes:
+      start_date:
+          Optional. The start date of the education.
+      end_date:
+          Optional. The end date of the education.
+      expected_graduation_date:
+          Optional. The expected graduation date if currently pursuing a
+          degree.
+      school_name:
+          Optional. The name of the school or institution.  For example,
+          "Stanford University", "UC Berkeley", and so on.  Number of
+          characters allowed is 250.
+      address:
+          Optional. The physical address of the education institution.
+      degree:
+          The degree information. It can be one of [degree\_description]
+          [google.cloud.talent.v4beta1.EducationRecord.degree\_descripti
+          on] or [structured\_degree][google.cloud.talent.v4beta1.Educat
+          ionRecord.structured\_degree].
+      degree_description:
+          Optional. The full description of the degree.  For example,
+          "Master of Science in Computer Science", "B.S in Math".
+          Number of characters allowed is 100.
+      structured_degree:
+          Optional. The structured notation of the degree.
+      description:
+          Optional. The description of the education.  Number of
+          characters allowed is 100,000.
+      is_current:
+          Optional. If this education is current.
+      school_name_snippet:
+          Output only. The school name snippet shows how the [school\_na
+          me][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.
+      degree_snippet:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.EducationRecord)
+    ),
+)
+_sym_db.RegisterMessage(EducationRecord)
+
+Degree = _reflection.GeneratedProtocolMessageType(
+    "Degree",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DEGREE,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a degree pursuing or acquired by a candidate.
+  
+  
+  Attributes:
+      degree_type:
+          Optional. ISCED degree type.
+      degree_name:
+          Optional. Full Degree name.  For example, "B.S.", "Master of
+          Arts", and so on.  Number of characters allowed is 100.
+      fields_of_study:
+          Optional. Fields of study for the degree.  For example,
+          "Computer science", "engineering".  Number of characters
+          allowed is 100.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Degree)
+    ),
+)
+_sym_db.RegisterMessage(Degree)
+
+Activity = _reflection.GeneratedProtocolMessageType(
+    "Activity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACTIVITY,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents an individual or collaborative activity
+  participated in by a candidate, for example, an open-source project, a
+  class assignment, and so on.
+  
+  
+  Attributes:
+      display_name:
+          Optional. Activity display name.  Number of characters allowed
+          is 100.
+      description:
+          Optional. Activity description.  Number of characters allowed
+          is 100,000.
+      uri:
+          Optional. Activity URI.  Number of characters allowed is
+          4,000.
+      create_date:
+          Optional. The first creation date of the activity.
+      update_date:
+          Optional. The last update date of the activity.
+      team_members:
+          Optional. 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.
+      skills_used:
+          Optional. A list of skills used in this activity.  The
+          limitation for max number of skills used is 50.
+      activity_name_snippet:
+          Output only. Activity name snippet shows how the [display\_nam
+          e][google.cloud.talent.v4beta1.Activity.display\_name] is
+          related to a search query. It's empty if the [display\_name][g
+          oogle.cloud.talent.v4beta1.Activity.display\_name] isn't
+          related to the search query.
+      activity_description_snippet:
+          Output only. Activity description snippet shows how the [descr
+          iption][google.cloud.talent.v4beta1.Activity.description] is
+          related to a search query. It's empty if the [description][goo
+          gle.cloud.talent.v4beta1.Activity.description] isn't related
+          to the search query.
+      skills_used_snippet:
+          Output only. Skill used snippet shows how the corresponding [s
+          kills\_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.Activ
+          ity.skills\_used] are not related to the search query.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Activity)
+    ),
+)
+_sym_db.RegisterMessage(Activity)
+
+Publication = _reflection.GeneratedProtocolMessageType(
+    "Publication",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PUBLICATION,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents a publication resource of a candidate.
+  
+  
+  Attributes:
+      authors:
+          Optional. A list of author names.  Number of characters
+          allowed is 100.
+      title:
+          Optional. The title of the publication.  Number of characters
+          allowed is 100.
+      description:
+          Optional. The description of the publication.  Number of
+          characters allowed is 100,000.
+      journal:
+          Optional. The journal name of the publication.  Number of
+          characters allowed is 100.
+      volume:
+          Optional. Volume number.  Number of characters allowed is 100.
+      publisher:
+          Optional. The publisher of the journal.  Number of characters
+          allowed is 100.
+      publication_date:
+          Optional. The publication date.
+      publication_type:
+          Optional. The publication type.  Number of characters allowed
+          is 100.
+      isbn:
+          Optional. ISBN number.  Number of characters allowed is 100.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Publication)
+    ),
+)
+_sym_db.RegisterMessage(Publication)
+
+Patent = _reflection.GeneratedProtocolMessageType(
+    "Patent",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PATENT,
+        __module__="google.cloud.talent_v4beta1.proto.profile_pb2",
+        __doc__="""Resource that represents the patent acquired by a candidate.
+  
+  
+  Attributes:
+      display_name:
+          Optional. Name of the patent.  Number of characters allowed is
+          100.
+      inventors:
+          Optional. A list of inventors' names.  Number of characters
+          allowed for each is 100.
+      patent_status:
+          Optional. The status of the patent.  Number of characters
+          allowed is 100.
+      patent_status_date:
+          Optional. The date the last time the status of the patent was
+          checked.
+      patent_filing_date:
+          Optional. The date that the patent was filed.
+      patent_office:
+          Optional. The name of the patent office.  Number of characters
+          allowed is 100.
+      patent_number:
+          Optional. The number of the patent.  Number of characters
+          allowed is 100.
+      patent_description:
+          Optional. The description of the patent.  Number of characters
+          allowed is 100,000.
+      skills_used:
+          Optional. The skills used in this patent.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Patent)
+    ),
+)
+_sym_db.RegisterMessage(Patent)
+
+
+DESCRIPTOR._options = None
+_PROFILE_CUSTOMATTRIBUTESENTRY._options = None
+_PROFILE.fields_by_name["derived_addresses"]._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/profile_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/profile_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/profile_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/profile_service.proto b/talent/google/cloud/talent_v4beta1/proto/profile_service.proto
new file mode 100644
index 000000000000..97cb9588f038
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/profile_service.proto
@@ -0,0 +1,502 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.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/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "ProfileServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service that handles profile management, including profile CRUD,
+// enumeration and search.
+service ProfileService {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Lists profiles by filter. The order is unspecified.
+  rpc ListProfiles(ListProfilesRequest) returns (ListProfilesResponse) {
+    option (google.api.http) = {
+      get: "/v4beta1/{parent=projects/*/tenants/*}/profiles"
+    };
+  }
+
+  // Creates and returns a new profile.
+  rpc CreateProfile(CreateProfileRequest) returns (Profile) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/profiles"
+      body: "*"
+    };
+  }
+
+  // Gets the specified profile.
+  rpc GetProfile(GetProfileRequest) returns (Profile) {
+    option (google.api.http) = {
+      get: "/v4beta1/{name=projects/*/tenants/*/profiles/*}"
+    };
+  }
+
+  // Updates the specified profile and returns the updated result.
+  rpc UpdateProfile(UpdateProfileRequest) returns (Profile) {
+    option (google.api.http) = {
+      patch: "/v4beta1/{profile.name=projects/*/tenants/*/profiles/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes the specified profile.
+  // Prerequisite: The profile has no associated applications or assignments
+  // associated.
+  rpc DeleteProfile(DeleteProfileRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v4beta1/{name=projects/*/tenants/*/profiles/*}"
+    };
+  }
+
+  // Searches for profiles within a tenant.
+  //
+  // 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.
+  rpc SearchProfiles(SearchProfilesRequest) returns (SearchProfilesResponse) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}:search"
+      body: "*"
+    };
+  }
+}
+
+// List profiles request.
+message ListProfilesRequest {
+  // 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;
+
+  // Optional. 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.
+  //
+  // 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.
+  //
+  // Valid values are:
+  //
+  // * name
+  google.protobuf.FieldMask read_mask = 4;
+}
+
+// The List profiles response object.
+message ListProfilesResponse {
+  // Profiles for the specific tenant.
+  repeated Profile profiles = 1;
+
+  // A token to retrieve the next page of results. This is empty if there are no
+  // more results.
+  string next_page_token = 2;
+}
+
+// Create profile request.
+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;
+
+  // Required. The profile to be created.
+  Profile profile = 2;
+}
+
+// Get profile request.
+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;
+}
+
+// Update profile request
+message UpdateProfileRequest {
+  // Required. Profile to be updated.
+  Profile profile = 1;
+
+  // Optional. 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
+  // * activities
+  // * publications
+  // * patents
+  // * certifications
+  // * recruiting_notes
+  // * custom_attributes
+  // * group_id
+  // * external_system
+  // * source_note
+  // * primary_responsibilities
+  // * citizenships
+  // * work_authorizations
+  // * employee_types
+  // * language_code
+  // * qualification_summary
+  // * allowed_contact_types
+  // * preferred_contact_types
+  // * contact_availability
+  // * language_fluencies
+  // * work_preference
+  // * industry_experiences
+  // * work_environment_experiences
+  // * work_availability
+  // * security_clearances
+  // * references
+  // * assessments
+  // * interviews
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Delete profile request.
+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;
+}
+
+// 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.
+  ProfileQuery profile_query = 3;
+
+  // Optional. 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.
+  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.
+  //
+  // The maximum allowed value is 5000. Otherwise an error is thrown.
+  //
+  // For example, 0 means to search from the first profile, and 10 means to
+  // search from the 11th profile. This can be used for pagination, for example
+  // 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
+  // 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.
+  // Defaults is "relevance desc" if no value is specified.
+  //
+  // Supported options are:
+  //
+  // * "relevance desc": By descending relevance, as determined by the API
+  //    algorithms.
+  // * "update_date desc": Sort by
+  // [Profile.update_time][google.cloud.talent.v4beta1.Profile.update_time] in
+  // descending order
+  //   (recently updated profiles first).
+  // * "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
+  //   ascending order.
+  // * "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
+  //   ascending order.
+  // * "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).
+  bool case_sensitive_sort = 9;
+
+  // Optional. 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.
+  //
+  // Function syntax: function_name(histogram_facet[, list of buckets])
+  //
+  // Data types:
+  //
+  // * Histogram facet: facet names with format [a-zA-Z][a-zA-Z0-9_]+.
+  // * String: string like "any string with backslash escape for quote(\")."
+  // * Number: whole number and floating point number like 10, -1 and -0.01.
+  // * List: list of elements with comma(,) separator surrounded by square
+  // brackets. For example, [1, 2, 3] and ["one", "two", "three"].
+  //
+  // Built-in constants:
+  //
+  // * MIN (minimum number similar to java Double.MIN_VALUE)
+  // * MAX (maximum number similar to java Double.MAX_VALUE)
+  //
+  // Built-in functions:
+  //
+  // * bucket(start, end[, label])
+  // Bucket build-in function creates a bucket with range of [start, end). Note
+  // that the end is exclusive.
+  // For example, bucket(1, MAX, "positive number") or bucket(1, 10).
+  //
+  // Histogram Facets:
+  //
+  // * admin1: Admin1 is a global placeholder for referring to state, province,
+  // or the particular term a country uses to define the geographic structure
+  // below the country level. Examples include states codes such as "CA", "IL",
+  // "NY", and provinces, such as "BC".
+  // * locality: Locality is a global placeholder for referring to city, town,
+  // or the particular term a country uses to define the geographic structure
+  // below the admin1 level. Examples include city names such as
+  // "Mountain View" and "New York".
+  // * extended_locality: Extended locality is concatenated version of admin1
+  // and locality with comma separator. For example, "Mountain View, CA" and
+  // "New York, NY".
+  // * postal_code: Postal code of profile which follows locale code.
+  // * country: Country code (ISO-3166-1 alpha-2 code) of profile, such as US,
+  //  JP, GB.
+  // * job_title: Normalized job titles specified in EmploymentHistory.
+  // * company_name: Normalized company name of profiles to match on.
+  // * institution: The school name. For example, "MIT",
+  // "University of California, Berkeley"
+  // * degree: Highest 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.
+  // * 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.
+  // * 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.
+  // * 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.
+  // * 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"].
+  // * numeric_custom_attribute: Numeric custom attributes. Values can be
+  // accessed via square bracket notation like numeric_custom_attribute["key1"].
+  //
+  // Example expressions:
+  //
+  // * count(admin1)
+  // * count(experience_in_months, [bucket(0, 12, "1 year"),
+  // bucket(12, 36, "1-3 years"), bucket(36, MAX, "3+ years")])
+  // * count(string_custom_attribute["assigned_recruiter"])
+  // * count(numeric_custom_attribute["favorite_number"],
+  // [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][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.
+  //
+  // 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][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;
+
+  // Optional. 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.
+message SearchProfilesResponse {
+  // An estimation of the number of profiles that match the specified query.
+  //
+  // This number isn't guaranteed to be accurate.
+  int64 estimated_total_size = 1;
+
+  // The spell checking result, and correction.
+  SpellingCorrection spell_correction = 2;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 3;
+
+  // A token to retrieve the next page of results. This is empty if there are no
+  // more results.
+  string next_page_token = 4;
+
+  // The histogram results that match with specified
+  // [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].
+  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.
+  string result_set_id = 7;
+}
+
+// Output only.
+//
+// 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].
+  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.
+  //
+  // 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
+  // "University of California at Berkeley" and the field study is "CS". The API
+  // merges these two inputs into one and selects one value for each field. For
+  // example, the school name in summary is set to "University of California at
+  // Berkeley" and the field of study is set to "Computer Science".
+  Profile summary = 2;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/profile_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/profile_service_pb2.py
new file mode 100644
index 000000000000..3d58e75fc6db
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/profile_service_pb2.py
@@ -0,0 +1,1425 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/profile_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    filters_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_filters__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    histogram_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    profile_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/profile_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\023ProfileServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/talent_v4beta1/proto/profile_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a/google/cloud/talent_v4beta1/proto/filters.proto\x1a\x31google/cloud/talent_v4beta1/proto/histogram.proto\x1a/google/cloud/talent_v4beta1/proto/profile.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"{\n\x13ListProfilesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12-\n\tread_mask\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"g\n\x14ListProfilesResponse\x12\x36\n\x08profiles\x18\x01 \x03(\x0b\x32$.google.cloud.talent.v4beta1.Profile\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"]\n\x14\x43reateProfileRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x35\n\x07profile\x18\x02 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Profile"!\n\x11GetProfileRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"~\n\x14UpdateProfileRequest\x12\x35\n\x07profile\x18\x01 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Profile\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteProfileRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\xb3\x03\n\x15SearchProfilesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x46\n\x10request_metadata\x18\x02 \x01(\x0b\x32,.google.cloud.talent.v4beta1.RequestMetadata\x12@\n\rprofile_query\x18\x03 \x01(\x0b\x32).google.cloud.talent.v4beta1.ProfileQuery\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t\x12\x0e\n\x06offset\x18\x06 \x01(\x05\x12\x1b\n\x13\x64isable_spell_check\x18\x07 \x01(\x08\x12\x10\n\x08order_by\x18\x08 \x01(\t\x12\x1b\n\x13\x63\x61se_sensitive_sort\x18\t \x01(\x08\x12\x46\n\x11histogram_queries\x18\n \x03(\x0b\x32+.google.cloud.talent.v4beta1.HistogramQuery\x12\x15\n\rresult_set_id\x18\x0c \x01(\t\x12\x1e\n\x16strict_keywords_search\x18\r \x01(\x08"\x93\x03\n\x16SearchProfilesResponse\x12\x1c\n\x14\x65stimated_total_size\x18\x01 \x01(\x03\x12I\n\x10spell_correction\x18\x02 \x01(\x0b\x32/.google.cloud.talent.v4beta1.SpellingCorrection\x12?\n\x08metadata\x18\x03 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata\x12\x17\n\x0fnext_page_token\x18\x04 \x01(\t\x12R\n\x17histogram_query_results\x18\x05 \x03(\x0b\x32\x31.google.cloud.talent.v4beta1.HistogramQueryResult\x12K\n\x13summarized_profiles\x18\x06 \x03(\x0b\x32..google.cloud.talent.v4beta1.SummarizedProfile\x12\x15\n\rresult_set_id\x18\x07 \x01(\t"\x82\x01\n\x11SummarizedProfile\x12\x36\n\x08profiles\x18\x01 \x03(\x0b\x32$.google.cloud.talent.v4beta1.Profile\x12\x35\n\x07summary\x18\x02 \x01(\x0b\x32$.google.cloud.talent.v4beta1.Profile2\xed\x08\n\x0eProfileService\x12\xac\x01\n\x0cListProfiles\x12\x30.google.cloud.talent.v4beta1.ListProfilesRequest\x1a\x31.google.cloud.talent.v4beta1.ListProfilesResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v4beta1/{parent=projects/*/tenants/*}/profiles\x12\xa4\x01\n\rCreateProfile\x12\x31.google.cloud.talent.v4beta1.CreateProfileRequest\x1a$.google.cloud.talent.v4beta1.Profile":\x82\xd3\xe4\x93\x02\x34"//v4beta1/{parent=projects/*/tenants/*}/profiles:\x01*\x12\x9b\x01\n\nGetProfile\x12..google.cloud.talent.v4beta1.GetProfileRequest\x1a$.google.cloud.talent.v4beta1.Profile"7\x82\xd3\xe4\x93\x02\x31\x12//v4beta1/{name=projects/*/tenants/*/profiles/*}\x12\xac\x01\n\rUpdateProfile\x12\x31.google.cloud.talent.v4beta1.UpdateProfileRequest\x1a$.google.cloud.talent.v4beta1.Profile"B\x82\xd3\xe4\x93\x02<27/v4beta1/{profile.name=projects/*/tenants/*/profiles/*}:\x01*\x12\x93\x01\n\rDeleteProfile\x12\x31.google.cloud.talent.v4beta1.DeleteProfileRequest\x1a\x16.google.protobuf.Empty"7\x82\xd3\xe4\x93\x02\x31*//v4beta1/{name=projects/*/tenants/*/profiles/*}\x12\xb3\x01\n\x0eSearchProfiles\x12\x32.google.cloud.talent.v4beta1.SearchProfilesRequest\x1a\x33.google.cloud.talent.v4beta1.SearchProfilesResponse"8\x82\xd3\xe4\x93\x02\x32"-/v4beta1/{parent=projects/*/tenants/*}:search:\x01*\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB\x81\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x13ProfileServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_filters__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTPROFILESREQUEST = _descriptor.Descriptor(
+    name="ListProfilesRequest",
+    full_name="google.cloud.talent.v4beta1.ListProfilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.ListProfilesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.ListProfilesRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.ListProfilesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="read_mask",
+            full_name="google.cloud.talent.v4beta1.ListProfilesRequest.read_mask",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=403,
+    serialized_end=526,
+)
+
+
+_LISTPROFILESRESPONSE = _descriptor.Descriptor(
+    name="ListProfilesResponse",
+    full_name="google.cloud.talent.v4beta1.ListProfilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="profiles",
+            full_name="google.cloud.talent.v4beta1.ListProfilesResponse.profiles",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.ListProfilesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=528,
+    serialized_end=631,
+)
+
+
+_CREATEPROFILEREQUEST = _descriptor.Descriptor(
+    name="CreateProfileRequest",
+    full_name="google.cloud.talent.v4beta1.CreateProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CreateProfileRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profile",
+            full_name="google.cloud.talent.v4beta1.CreateProfileRequest.profile",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=633,
+    serialized_end=726,
+)
+
+
+_GETPROFILEREQUEST = _descriptor.Descriptor(
+    name="GetProfileRequest",
+    full_name="google.cloud.talent.v4beta1.GetProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.GetProfileRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=728,
+    serialized_end=761,
+)
+
+
+_UPDATEPROFILEREQUEST = _descriptor.Descriptor(
+    name="UpdateProfileRequest",
+    full_name="google.cloud.talent.v4beta1.UpdateProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="profile",
+            full_name="google.cloud.talent.v4beta1.UpdateProfileRequest.profile",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.talent.v4beta1.UpdateProfileRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=763,
+    serialized_end=889,
+)
+
+
+_DELETEPROFILEREQUEST = _descriptor.Descriptor(
+    name="DeleteProfileRequest",
+    full_name="google.cloud.talent.v4beta1.DeleteProfileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.DeleteProfileRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=891,
+    serialized_end=927,
+)
+
+
+_SEARCHPROFILESREQUEST = _descriptor.Descriptor(
+    name="SearchProfilesRequest",
+    full_name="google.cloud.talent.v4beta1.SearchProfilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="request_metadata",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.request_metadata",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="profile_query",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.profile_query",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.page_token",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="offset",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.offset",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="disable_spell_check",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.disable_spell_check",
+            index=6,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.order_by",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="case_sensitive_sort",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.case_sensitive_sort",
+            index=8,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="histogram_queries",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result_set_id",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.result_set_id",
+            index=10,
+            number=12,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="strict_keywords_search",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesRequest.strict_keywords_search",
+            index=11,
+            number=13,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=930,
+    serialized_end=1365,
+)
+
+
+_SEARCHPROFILESRESPONSE = _descriptor.Descriptor(
+    name="SearchProfilesResponse",
+    full_name="google.cloud.talent.v4beta1.SearchProfilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="estimated_total_size",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.estimated_total_size",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spell_correction",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.spell_correction",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.next_page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="histogram_query_results",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.histogram_query_results",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="summarized_profiles",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.summarized_profiles",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result_set_id",
+            full_name="google.cloud.talent.v4beta1.SearchProfilesResponse.result_set_id",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1368,
+    serialized_end=1771,
+)
+
+
+_SUMMARIZEDPROFILE = _descriptor.Descriptor(
+    name="SummarizedProfile",
+    full_name="google.cloud.talent.v4beta1.SummarizedProfile",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="profiles",
+            full_name="google.cloud.talent.v4beta1.SummarizedProfile.profiles",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="summary",
+            full_name="google.cloud.talent.v4beta1.SummarizedProfile.summary",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1774,
+    serialized_end=1904,
+)
+
+_LISTPROFILESREQUEST.fields_by_name[
+    "read_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTPROFILESRESPONSE.fields_by_name[
+    "profiles"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE
+)
+_CREATEPROFILEREQUEST.fields_by_name[
+    "profile"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE
+)
+_UPDATEPROFILEREQUEST.fields_by_name[
+    "profile"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE
+)
+_UPDATEPROFILEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_SEARCHPROFILESREQUEST.fields_by_name[
+    "request_metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._REQUESTMETADATA
+)
+_SEARCHPROFILESREQUEST.fields_by_name[
+    "profile_query"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_filters__pb2._PROFILEQUERY
+)
+_SEARCHPROFILESREQUEST.fields_by_name[
+    "histogram_queries"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2._HISTOGRAMQUERY
+)
+_SEARCHPROFILESRESPONSE.fields_by_name[
+    "spell_correction"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._SPELLINGCORRECTION
+)
+_SEARCHPROFILESRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+_SEARCHPROFILESRESPONSE.fields_by_name[
+    "histogram_query_results"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_histogram__pb2._HISTOGRAMQUERYRESULT
+)
+_SEARCHPROFILESRESPONSE.fields_by_name[
+    "summarized_profiles"
+].message_type = _SUMMARIZEDPROFILE
+_SUMMARIZEDPROFILE.fields_by_name[
+    "profiles"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE
+)
+_SUMMARIZEDPROFILE.fields_by_name[
+    "summary"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE
+)
+DESCRIPTOR.message_types_by_name["ListProfilesRequest"] = _LISTPROFILESREQUEST
+DESCRIPTOR.message_types_by_name["ListProfilesResponse"] = _LISTPROFILESRESPONSE
+DESCRIPTOR.message_types_by_name["CreateProfileRequest"] = _CREATEPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["GetProfileRequest"] = _GETPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProfileRequest"] = _UPDATEPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProfileRequest"] = _DELETEPROFILEREQUEST
+DESCRIPTOR.message_types_by_name["SearchProfilesRequest"] = _SEARCHPROFILESREQUEST
+DESCRIPTOR.message_types_by_name["SearchProfilesResponse"] = _SEARCHPROFILESRESPONSE
+DESCRIPTOR.message_types_by_name["SummarizedProfile"] = _SUMMARIZEDPROFILE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListProfilesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProfilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPROFILESREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""List profiles request.
+  
+  
+  Attributes:
+      parent:
+          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".
+      page_token:
+          Optional. The token that specifies the current offset (that
+          is, starting result).  Please set the value to [ListProfilesRe
+          sponse.next\_page\_token][google.cloud.talent.v4beta1.ListProf
+          ilesResponse.next\_page\_token] to continue the list.
+      page_size:
+          Optional. The maximum number of profiles to be returned, at
+          most 100.  Default is 100 unless a positive number smaller
+          than 100 is specified.
+      read_mask:
+          Optional. A field mask to specify the profile fields to be
+          listed in response. All fields are listed if it is unset.
+          Valid values are:  -  name
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListProfilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProfilesRequest)
+
+ListProfilesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProfilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPROFILESRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""The List profiles response object.
+  
+  
+  Attributes:
+      profiles:
+          Profiles for the specific tenant.
+      next_page_token:
+          A token to retrieve the next page of results. This is empty if
+          there are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListProfilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProfilesResponse)
+
+CreateProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPROFILEREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""Create profile request.
+  
+  
+  Attributes:
+      parent:
+          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".
+      profile:
+          Required. The profile to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CreateProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProfileRequest)
+
+GetProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPROFILEREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""Get profile request.
+  
+  
+  Attributes:
+      name:
+          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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.GetProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProfileRequest)
+
+UpdateProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPROFILEREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""Update profile request
+  
+  
+  Attributes:
+      profile:
+          Required. Profile to be updated.
+      update_mask:
+          Optional. 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 -
+          activities -  publications -  patents -  certifications -
+          recruiting\_notes -  custom\_attributes -  group\_id -
+          external\_system -  source\_note -  primary\_responsibilities
+          -  citizenships -  work\_authorizations -  employee\_types -
+          language\_code -  qualification\_summary -
+          allowed\_contact\_types -  preferred\_contact\_types -
+          contact\_availability -  language\_fluencies -
+          work\_preference -  industry\_experiences -
+          work\_environment\_experiences -  work\_availability -
+          security\_clearances -  references -  assessments -
+          interviews
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.UpdateProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProfileRequest)
+
+DeleteProfileRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProfileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPROFILEREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""Delete profile request.
+  
+  
+  Attributes:
+      name:
+          Required. Resource name of the profile to be deleted.  The
+          format is "projects/{project\_id}/tenants/{tenant\_id}/profile
+          s/{profile\_id}", for example, "projects/api-test-
+          project/tenants/foo/profiles/bar".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.DeleteProfileRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProfileRequest)
+
+SearchProfilesRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchProfilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHPROFILESREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""The request body of the ``SearchProfiles`` call.
+  
+  
+  Attributes:
+      parent:
+          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".
+      request_metadata:
+          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.
+      profile_query:
+          Optional. Search query to execute. See
+          [ProfileQuery][google.cloud.talent.v4beta1.ProfileQuery] for
+          more details.
+      page_size:
+          Optional. 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.
+      page_token:
+          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.
+      offset:
+          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.Search
+          ProfilesRequest.page\_token] is unset.  The maximum allowed
+          value is 5000. Otherwise an error is thrown.  For example, 0
+          means to search from the first profile, and 10 means to search
+          from the 11th profile. This can be used for pagination, for
+          example pageSize = 10 and offset = 10 means to search from the
+          second page.
+      disable_spell_check:
+          Optional. This flag controls the spell-check feature. If
+          ``false``, the service attempts to correct a misspelled query.
+          For example, "enginee" is corrected to "engineer".
+      order_by:
+          Optional. 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\_date desc": Sort by    [Profile.update\_time][google.
+          cloud.talent.v4beta1.Profile.update\_time]    in descending
+          order (recently updated profiles first). -  "create\_date
+          desc": Sort by    [Profile.create\_time][google.cloud.talent.v
+          4beta1.Profile.create\_time]    in descending order (recently
+          created profiles first). -  "first\_name": Sort by    [PersonN
+          ame.PersonStructuredName.given\_name][google.cloud.talent.v4be
+          ta1.PersonName.PersonStructuredName.given\_name]    in
+          ascending order. -  "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.PersonStructure
+          dName.family\_name][google.cloud.talent.v4beta1.PersonName.Per
+          sonStructuredName.family\_name]    in ascending order. -
+          "last\_name desc": Sort by    [PersonName.PersonStructuredName
+          .family\_name][google.cloud.talent.v4beta1.PersonName.PersonSt
+          ructuredName.family\_name]    in ascending order.
+      case_sensitive_sort:
+          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).
+      histogram_queries:
+          Optional. A list of expressions specifies histogram requests
+          against matching profiles for [SearchProfilesRequest][google.c
+          loud.talent.v4beta1.SearchProfilesRequest].  The expression
+          syntax looks like a function definition with optional
+          parameters.  Function syntax:
+          function\_name(histogram\_facet[, list of buckets])  Data
+          types:  -  Histogram facet: facet names with format
+          [a-zA-Z][a-zA-Z0-9\_]+. -  String: string like "any string
+          with backslash escape for quote(")." -  Number: whole number
+          and floating point number like 10, -1 and -0.01. -  List: list
+          of elements with comma(,) separator surrounded by square
+          brackets. For example, [1, 2, 3] and ["one", "two", "three"].
+          Built-in constants:  -  MIN (minimum number similar to java
+          Double.MIN\_VALUE) -  MAX (maximum number similar to java
+          Double.MAX\_VALUE)  Built-in functions:  -  bucket(start,
+          end[, label]) Bucket build-in function creates a bucket
+          with range of [start, end). Note that the end is exclusive.
+          For    example, bucket(1, MAX, "positive number") or bucket(1,
+          10).  Histogram Facets:  -  admin1: Admin1 is a global
+          placeholder for referring to state,    province, or the
+          particular term a country uses to define the    geographic
+          structure below the country level. Examples include states
+          codes such as "CA", "IL", "NY", and provinces, such as "BC". -
+          locality: Locality is a global placeholder for referring to
+          city,    town, or the particular term a country uses to define
+          the geographic    structure below the admin1 level. Examples
+          include city names such as    "Mountain View" and "New York".
+          -  extended\_locality: Extended locality is concatenated
+          version of    admin1 and locality with comma separator. For
+          example, "Mountain    View, CA" and "New York, NY". -
+          postal\_code: Postal code of profile which follows locale
+          code. -  country: Country code (ISO-3166-1 alpha-2 code) of
+          profile, such as    US, JP, GB. -  job\_title: Normalized job
+          titles specified in EmploymentHistory. -  company\_name:
+          Normalized company name of profiles to match on. -
+          institution: The school name. For example, "MIT", "University
+          of    California, Berkeley" -  degree: Highest 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. -
+          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.Applicatio
+          nDateFilter]    for more details. -
+          application\_outcome\_notes: The application outcome reason
+          specifies    the reasons behind the outcome of the job
+          application. See    [ApplicationOutcomeNotesFilter][google.clo
+          ud.talent.v4beta1.ApplicationOutcomeNotesFilter]    for more
+          details. -  application\_job\_title: The application job title
+          specifies the job    applied for in the application. See    [A
+          pplicationJobFilter][google.cloud.talent.v4beta1.ApplicationJo
+          bFilter]    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"]. -
+          numeric\_custom\_attribute: Numeric custom attributes. Values
+          can be    accessed via square bracket notation like
+          numeric\_custom\_attribute["key1"].  Example expressions:  -
+          count(admin1) -  count(experience\_in\_months, [bucket(0, 12,
+          "1 year"), bucket(12,    36, "1-3 years"), bucket(36, MAX, "3+
+          years")]) -
+          count(string\_custom\_attribute["assigned\_recruiter"]) -
+          count(numeric\_custom\_attribute["favorite\_number"],
+          [bucket(MIN, 0,    "negative"), bucket(0, MAX, "non-
+          negative")])
+      result_set_id:
+          Optional. An id that uniquely identifies the result set of a [
+          SearchProfiles][google.cloud.talent.v4beta1.ProfileService.Sea
+          rchProfiles] call. The id should be retrieved from the [Search
+          ProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesRe
+          sponse] message returned from a previous invocation of [Search
+          Profiles][google.cloud.talent.v4beta1.ProfileService.SearchPro
+          files].  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.SearchProf
+          ilesRequest.profile\_query]. A new [result\_set\_id][google.cl
+          oud.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\_que
+          ry][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 [p
+          age\_token][google.cloud.talent.v4beta1.SearchProfilesRequest.
+          page\_token] or [offset][google.cloud.talent.v4beta1.SearchPro
+          filesRequest.offset] must be set.  A typical use case is to
+          invoke [SearchProfilesRequest][google.cloud.talent.v4beta1.Sea
+          rchProfilesRequest] without this field, then use the resulting
+          [result\_set\_id][google.cloud.talent.v4beta1.SearchProfilesRe
+          quest.result\_set\_id] in [SearchProfilesResponse][google.clou
+          d.talent.v4beta1.SearchProfilesResponse] to page through the
+          results.
+      strict_keywords_search:
+          Optional. 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchProfilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchProfilesRequest)
+
+SearchProfilesResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchProfilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHPROFILESRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""Response of SearchProfiles method.
+  
+  
+  Attributes:
+      estimated_total_size:
+          An estimation of the number of profiles that match the
+          specified query.  This number isn't guaranteed to be accurate.
+      spell_correction:
+          The spell checking result, and correction.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+      next_page_token:
+          A token to retrieve the next page of results. This is empty if
+          there are no more results.
+      histogram_query_results:
+          The histogram results that match with specified [SearchProfile
+          sRequest.histogram\_queries][google.cloud.talent.v4beta1.Searc
+          hProfilesRequest.histogram\_queries].
+      summarized_profiles:
+          The profile entities that match the specified [SearchProfilesR
+          equest][google.cloud.talent.v4beta1.SearchProfilesRequest].
+      result_set_id:
+          An id that uniquely identifies the result set of a [SearchProf
+          iles][google.cloud.talent.v4beta1.ProfileService.SearchProfile
+          s] call for consistent results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SearchProfilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchProfilesResponse)
+
+SummarizedProfile = _reflection.GeneratedProtocolMessageType(
+    "SummarizedProfile",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SUMMARIZEDPROFILE,
+        __module__="google.cloud.talent_v4beta1.proto.profile_service_pb2",
+        __doc__="""Output only.
+  
+  Profile entry with metadata inside
+  [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse].
+  
+  
+  Attributes:
+      profiles:
+          A list of profiles that are linked by [Profile.group\_id][goog
+          le.cloud.talent.v4beta1.Profile.group\_id].
+      summary:
+          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.  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 "University of California at Berkeley" and the
+          field study is "CS". The API merges these two inputs into one
+          and selects one value for each field. For example, the school
+          name in summary is set to "University of California at
+          Berkeley" and the field of study is set to "Computer Science".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.SummarizedProfile)
+    ),
+)
+_sym_db.RegisterMessage(SummarizedProfile)
+
+
+DESCRIPTOR._options = None
+
+_PROFILESERVICE = _descriptor.ServiceDescriptor(
+    name="ProfileService",
+    full_name="google.cloud.talent.v4beta1.ProfileService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=1907,
+    serialized_end=3040,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListProfiles",
+            full_name="google.cloud.talent.v4beta1.ProfileService.ListProfiles",
+            index=0,
+            containing_service=None,
+            input_type=_LISTPROFILESREQUEST,
+            output_type=_LISTPROFILESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v4beta1/{parent=projects/*/tenants/*}/profiles"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateProfile",
+            full_name="google.cloud.talent.v4beta1.ProfileService.CreateProfile",
+            index=1,
+            containing_service=None,
+            input_type=_CREATEPROFILEREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE,
+            serialized_options=_b(
+                '\202\323\344\223\0024"//v4beta1/{parent=projects/*/tenants/*}/profiles:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProfile",
+            full_name="google.cloud.talent.v4beta1.ProfileService.GetProfile",
+            index=2,
+            containing_service=None,
+            input_type=_GETPROFILEREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v4beta1/{name=projects/*/tenants/*/profiles/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProfile",
+            full_name="google.cloud.talent.v4beta1.ProfileService.UpdateProfile",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEPROFILEREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2._PROFILE,
+            serialized_options=_b(
+                "\202\323\344\223\002<27/v4beta1/{profile.name=projects/*/tenants/*/profiles/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProfile",
+            full_name="google.cloud.talent.v4beta1.ProfileService.DeleteProfile",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEPROFILEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v4beta1/{name=projects/*/tenants/*/profiles/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchProfiles",
+            full_name="google.cloud.talent.v4beta1.ProfileService.SearchProfiles",
+            index=5,
+            containing_service=None,
+            input_type=_SEARCHPROFILESREQUEST,
+            output_type=_SEARCHPROFILESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\0022"-/v4beta1/{parent=projects/*/tenants/*}:search:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PROFILESERVICE)
+
+DESCRIPTOR.services_by_name["ProfileService"] = _PROFILESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/profile_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/profile_service_pb2_grpc.py
new file mode 100644
index 000000000000..5ee6d37a02fb
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/profile_service_pb2_grpc.py
@@ -0,0 +1,149 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    profile_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    profile_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ProfileServiceStub(object):
+    """A service that handles profile management, including profile CRUD,
+  enumeration and search.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListProfiles = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ProfileService/ListProfiles",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.ListProfilesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.ListProfilesResponse.FromString,
+        )
+        self.CreateProfile = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ProfileService/CreateProfile",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.CreateProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.Profile.FromString,
+        )
+        self.GetProfile = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ProfileService/GetProfile",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.GetProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.Profile.FromString,
+        )
+        self.UpdateProfile = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ProfileService/UpdateProfile",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.UpdateProfileRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.Profile.FromString,
+        )
+        self.DeleteProfile = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ProfileService/DeleteProfile",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.DeleteProfileRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.SearchProfiles = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.ProfileService/SearchProfiles",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.SearchProfilesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.SearchProfilesResponse.FromString,
+        )
+
+
+class ProfileServiceServicer(object):
+    """A service that handles profile management, including profile CRUD,
+  enumeration and search.
+  """
+
+    def ListProfiles(self, request, context):
+        """Lists profiles by filter. The order is unspecified.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateProfile(self, request, context):
+        """Creates and returns a new profile.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProfile(self, request, context):
+        """Gets the specified profile.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProfile(self, request, context):
+        """Updates the specified profile and returns the updated result.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProfile(self, request, context):
+        """Deletes the specified profile.
+    Prerequisite: The profile has no associated applications or assignments
+    associated.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchProfiles(self, request, context):
+        """Searches for profiles within a tenant.
+
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ProfileServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListProfiles": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProfiles,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.ListProfilesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.ListProfilesResponse.SerializeToString,
+        ),
+        "CreateProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProfile,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.CreateProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.Profile.SerializeToString,
+        ),
+        "GetProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProfile,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.GetProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.Profile.SerializeToString,
+        ),
+        "UpdateProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProfile,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.UpdateProfileRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__pb2.Profile.SerializeToString,
+        ),
+        "DeleteProfile": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProfile,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.DeleteProfileRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "SearchProfiles": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchProfiles,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.SearchProfilesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_profile__service__pb2.SearchProfilesResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.ProfileService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant.proto b/talent/google/cloud/talent_v4beta1/proto/tenant.proto
new file mode 100644
index 000000000000..8715d201abb9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/tenant.proto
@@ -0,0 +1,79 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "TenantResourceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A Tenant resource represents a tenant in the service. A tenant is a group or
+// entity that shares common access with specific privileges for resources like
+// profiles. Customer may create multiple tenants to provide data isolation for
+// different groups.
+message Tenant {
+  // Enum that represents how user data owned by the tenant is used.
+  enum DataUsageType {
+    // Default value.
+    DATA_USAGE_TYPE_UNSPECIFIED = 0;
+
+    // Data owned by this tenant is used to improve search/recommendation
+    // quality across tenants.
+    AGGREGATED = 1;
+
+    // Data owned by this tenant is used to improve search/recommendation
+    // quality for this tenant only.
+    ISOLATED = 2;
+  }
+
+  // Required during tenant update.
+  //
+  // The resource name for a tenant. This is generated by the service when a
+  // tenant is created.
+  //
+  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
+  // "projects/api-test-project/tenants/foo".
+  string name = 1;
+
+  // Required. Client side tenant identifier, used to uniquely identify the
+  // tenant.
+  //
+  // The maximum number of allowed characters is 255.
+  string external_id = 2;
+
+  // Optional. 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.
+  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
+  // 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.
+  repeated string keyword_searchable_profile_custom_attributes = 4;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py b/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py
new file mode 100644
index 000000000000..338879d85eab
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/tenant_pb2.py
@@ -0,0 +1,209 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/tenant.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/tenant.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\023TenantResourceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n.google/cloud/talent_v4beta1/proto/tenant.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xf8\x01\n\x06Tenant\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x02 \x01(\t\x12\x45\n\nusage_type\x18\x03 \x01(\x0e\x32\x31.google.cloud.talent.v4beta1.Tenant.DataUsageType\x12\x34\n,keyword_searchable_profile_custom_attributes\x18\x04 \x03(\t"N\n\rDataUsageType\x12\x1f\n\x1b\x44\x41TA_USAGE_TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nAGGREGATED\x10\x01\x12\x0c\n\x08ISOLATED\x10\x02\x42\x81\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x13TenantResourceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TENANT_DATAUSAGETYPE = _descriptor.EnumDescriptor(
+    name="DataUsageType",
+    full_name="google.cloud.talent.v4beta1.Tenant.DataUsageType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="DATA_USAGE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AGGREGATED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ISOLATED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=313,
+    serialized_end=391,
+)
+_sym_db.RegisterEnumDescriptor(_TENANT_DATAUSAGETYPE)
+
+
+_TENANT = _descriptor.Descriptor(
+    name="Tenant",
+    full_name="google.cloud.talent.v4beta1.Tenant",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.Tenant.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="external_id",
+            full_name="google.cloud.talent.v4beta1.Tenant.external_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="usage_type",
+            full_name="google.cloud.talent.v4beta1.Tenant.usage_type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="keyword_searchable_profile_custom_attributes",
+            full_name="google.cloud.talent.v4beta1.Tenant.keyword_searchable_profile_custom_attributes",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TENANT_DATAUSAGETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=143,
+    serialized_end=391,
+)
+
+_TENANT.fields_by_name["usage_type"].enum_type = _TENANT_DATAUSAGETYPE
+_TENANT_DATAUSAGETYPE.containing_type = _TENANT
+DESCRIPTOR.message_types_by_name["Tenant"] = _TENANT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Tenant = _reflection.GeneratedProtocolMessageType(
+    "Tenant",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TENANT,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_pb2",
+        __doc__="""A Tenant resource represents a tenant in the service. A tenant is a
+  group or entity that shares common access with specific privileges for
+  resources like profiles. Customer may create multiple tenants to provide
+  data isolation for different groups.
+  
+  
+  Attributes:
+      name:
+          Required during tenant update.  The resource name for a
+          tenant. This is generated by the service when a tenant is
+          created.  The format is
+          "projects/{project\_id}/tenants/{tenant\_id}", for example,
+          "projects/api-test-project/tenants/foo".
+      external_id:
+          Required. Client side tenant identifier, used to uniquely
+          identify the tenant.  The maximum number of allowed characters
+          is 255.
+      usage_type:
+          Optional. Indicates whether data owned by this tenant may be
+          used to provide product improvements across other tenants.
+          Defaults behavior is [DataUsageType.ISOLATED][google.cloud.tal
+          ent.v4beta1.Tenant.DataUsageType.ISOLATED] if it's unset.
+      keyword_searchable_profile_custom_attributes:
+          Optional. A list of keys of filterable [Profile.custom\_attrib
+          utes][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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.Tenant)
+    ),
+)
+_sym_db.RegisterMessage(Tenant)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/tenant_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/tenant_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant_service.proto b/talent/google/cloud/talent_v4beta1/proto/tenant_service.proto
new file mode 100644
index 000000000000..33b7f53845e4
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/tenant_service.proto
@@ -0,0 +1,158 @@
+// 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.talent.v4beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/talent/v4beta1/common.proto";
+import "google/cloud/talent/v4beta1/tenant.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
+option java_multiple_files = true;
+option java_outer_classname = "TenantServiceProto";
+option java_package = "com.google.cloud.talent.v4beta1";
+option objc_class_prefix = "CTS";
+
+// A service that handles tenant management, including CRUD and enumeration.
+service TenantService {
+  option (google.api.default_host) = "jobs.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/jobs";
+
+  // Creates a new tenant entity.
+  rpc CreateTenant(CreateTenantRequest) returns (Tenant) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*}/tenants"
+      body: "*"
+    };
+  }
+
+  // Retrieves specified tenant.
+  rpc GetTenant(GetTenantRequest) returns (Tenant) {
+    option (google.api.http) = {
+      get: "/v4beta1/{name=projects/*/tenants/*}"
+    };
+  }
+
+  // Updates specified tenant.
+  rpc UpdateTenant(UpdateTenantRequest) returns (Tenant) {
+    option (google.api.http) = {
+      patch: "/v4beta1/{tenant.name=projects/*/tenants/*}"
+      body: "*"
+    };
+  }
+
+  // Deletes specified tenant.
+  rpc DeleteTenant(DeleteTenantRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v4beta1/{name=projects/*/tenants/*}"
+    };
+  }
+
+  // Lists all tenants associated with the project.
+  rpc ListTenants(ListTenantsRequest) returns (ListTenantsResponse) {
+    option (google.api.http) = {
+      get: "/v4beta1/{parent=projects/*}/tenants"
+    };
+  }
+}
+
+// The Request of the CreateTenant method.
+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;
+
+  // Required. The tenant to be created.
+  Tenant tenant = 2;
+}
+
+// Request for getting a tenant by name.
+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;
+}
+
+// Request for updating a specified tenant.
+message UpdateTenantRequest {
+  // Required. The tenant resource to replace the current resource in the
+  // system.
+  Tenant tenant = 1;
+
+  // Optional but 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.
+  //
+  // A field mask to specify the tenant fields to be updated. Only
+  // top level fields of [Tenant][google.cloud.talent.v4beta1.Tenant] are
+  // supported.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request to delete a tenant.
+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;
+}
+
+// List tenants for which the client has ACL visibility.
+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.
+  string page_token = 2;
+
+  // Optional. 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.
+  repeated Tenant tenants = 1;
+
+  // A token to retrieve the next page of results.
+  string next_page_token = 2;
+
+  // Additional information for the API invocation, such as the request
+  // tracking id.
+  ResponseMetadata metadata = 3;
+}
diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant_service_pb2.py b/talent/google/cloud/talent_v4beta1/proto/tenant_service_pb2.py
new file mode 100644
index 000000000000..abfe7fa50d0e
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/tenant_service_pb2.py
@@ -0,0 +1,632 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/talent_v4beta1/proto/tenant_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.talent_v4beta1.proto import (
+    common_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    tenant_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/talent_v4beta1/proto/tenant_service.proto",
+    package="google.cloud.talent.v4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\037com.google.cloud.talent.v4beta1B\022TenantServiceProtoP\001ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\242\002\003CTS"
+    ),
+    serialized_pb=_b(
+        '\n6google/cloud/talent_v4beta1/proto/tenant_service.proto\x12\x1bgoogle.cloud.talent.v4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a.google/cloud/talent_v4beta1/proto/common.proto\x1a.google/cloud/talent_v4beta1/proto/tenant.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"Z\n\x13\x43reateTenantRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x33\n\x06tenant\x18\x02 \x01(\x0b\x32#.google.cloud.talent.v4beta1.Tenant" \n\x10GetTenantRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"{\n\x13UpdateTenantRequest\x12\x33\n\x06tenant\x18\x01 \x01(\x0b\x32#.google.cloud.talent.v4beta1.Tenant\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"#\n\x13\x44\x65leteTenantRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"K\n\x12ListTenantsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"\xa5\x01\n\x13ListTenantsResponse\x12\x34\n\x07tenants\x18\x01 \x03(\x0b\x32#.google.cloud.talent.v4beta1.Tenant\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12?\n\x08metadata\x18\x03 \x01(\x0b\x32-.google.cloud.talent.v4beta1.ResponseMetadata2\xf0\x06\n\rTenantService\x12\x96\x01\n\x0c\x43reateTenant\x12\x30.google.cloud.talent.v4beta1.CreateTenantRequest\x1a#.google.cloud.talent.v4beta1.Tenant"/\x82\xd3\xe4\x93\x02)"$/v4beta1/{parent=projects/*}/tenants:\x01*\x12\x8d\x01\n\tGetTenant\x12-.google.cloud.talent.v4beta1.GetTenantRequest\x1a#.google.cloud.talent.v4beta1.Tenant",\x82\xd3\xe4\x93\x02&\x12$/v4beta1/{name=projects/*/tenants/*}\x12\x9d\x01\n\x0cUpdateTenant\x12\x30.google.cloud.talent.v4beta1.UpdateTenantRequest\x1a#.google.cloud.talent.v4beta1.Tenant"6\x82\xd3\xe4\x93\x02\x30\x32+/v4beta1/{tenant.name=projects/*/tenants/*}:\x01*\x12\x86\x01\n\x0c\x44\x65leteTenant\x12\x30.google.cloud.talent.v4beta1.DeleteTenantRequest\x1a\x16.google.protobuf.Empty",\x82\xd3\xe4\x93\x02&*$/v4beta1/{name=projects/*/tenants/*}\x12\x9e\x01\n\x0bListTenants\x12/.google.cloud.talent.v4beta1.ListTenantsRequest\x1a\x30.google.cloud.talent.v4beta1.ListTenantsResponse",\x82\xd3\xe4\x93\x02&\x12$/v4beta1/{parent=projects/*}/tenants\x1al\xca\x41\x13jobs.googleapis.com\xd2\x41Shttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobsB\x80\x01\n\x1f\x63om.google.cloud.talent.v4beta1B\x12TenantServiceProtoP\x01ZAgoogle.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent\xa2\x02\x03\x43TSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATETENANTREQUEST = _descriptor.Descriptor(
+    name="CreateTenantRequest",
+    full_name="google.cloud.talent.v4beta1.CreateTenantRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.CreateTenantRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tenant",
+            full_name="google.cloud.talent.v4beta1.CreateTenantRequest.tenant",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=301,
+    serialized_end=391,
+)
+
+
+_GETTENANTREQUEST = _descriptor.Descriptor(
+    name="GetTenantRequest",
+    full_name="google.cloud.talent.v4beta1.GetTenantRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.GetTenantRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=393,
+    serialized_end=425,
+)
+
+
+_UPDATETENANTREQUEST = _descriptor.Descriptor(
+    name="UpdateTenantRequest",
+    full_name="google.cloud.talent.v4beta1.UpdateTenantRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tenant",
+            full_name="google.cloud.talent.v4beta1.UpdateTenantRequest.tenant",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.talent.v4beta1.UpdateTenantRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=427,
+    serialized_end=550,
+)
+
+
+_DELETETENANTREQUEST = _descriptor.Descriptor(
+    name="DeleteTenantRequest",
+    full_name="google.cloud.talent.v4beta1.DeleteTenantRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.talent.v4beta1.DeleteTenantRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=552,
+    serialized_end=587,
+)
+
+
+_LISTTENANTSREQUEST = _descriptor.Descriptor(
+    name="ListTenantsRequest",
+    full_name="google.cloud.talent.v4beta1.ListTenantsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.talent.v4beta1.ListTenantsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.talent.v4beta1.ListTenantsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.talent.v4beta1.ListTenantsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=589,
+    serialized_end=664,
+)
+
+
+_LISTTENANTSRESPONSE = _descriptor.Descriptor(
+    name="ListTenantsResponse",
+    full_name="google.cloud.talent.v4beta1.ListTenantsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tenants",
+            full_name="google.cloud.talent.v4beta1.ListTenantsResponse.tenants",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.talent.v4beta1.ListTenantsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="metadata",
+            full_name="google.cloud.talent.v4beta1.ListTenantsResponse.metadata",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=667,
+    serialized_end=832,
+)
+
+_CREATETENANTREQUEST.fields_by_name[
+    "tenant"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2._TENANT
+_UPDATETENANTREQUEST.fields_by_name[
+    "tenant"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2._TENANT
+_UPDATETENANTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTENANTSRESPONSE.fields_by_name[
+    "tenants"
+].message_type = google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2._TENANT
+_LISTTENANTSRESPONSE.fields_by_name[
+    "metadata"
+].message_type = (
+    google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_common__pb2._RESPONSEMETADATA
+)
+DESCRIPTOR.message_types_by_name["CreateTenantRequest"] = _CREATETENANTREQUEST
+DESCRIPTOR.message_types_by_name["GetTenantRequest"] = _GETTENANTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateTenantRequest"] = _UPDATETENANTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTenantRequest"] = _DELETETENANTREQUEST
+DESCRIPTOR.message_types_by_name["ListTenantsRequest"] = _LISTTENANTSREQUEST
+DESCRIPTOR.message_types_by_name["ListTenantsResponse"] = _LISTTENANTSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateTenantRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTenantRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETENANTREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_service_pb2",
+        __doc__="""The Request of the CreateTenant method.
+  
+  
+  Attributes:
+      parent:
+          Required. Resource name of the project under which the tenant
+          is created.  The format is "projects/{project\_id}", for
+          example, "projects/api-test-project".
+      tenant:
+          Required. The tenant to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.CreateTenantRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTenantRequest)
+
+GetTenantRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTenantRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTENANTREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_service_pb2",
+        __doc__="""Request for getting a tenant by name.
+  
+  
+  Attributes:
+      name:
+          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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.GetTenantRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTenantRequest)
+
+UpdateTenantRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateTenantRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATETENANTREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_service_pb2",
+        __doc__="""Request for updating a specified tenant.
+  
+  
+  Attributes:
+      tenant:
+          Required. The tenant resource to replace the current resource
+          in the system.
+      update_mask:
+          Optional but strongly recommended for the best service
+          experience.  If [update\_mask][google.cloud.talent.v4beta1.Upd
+          ateTenantRequest.update\_mask] is provided, only the specified
+          fields in [tenant][google.cloud.talent.v4beta1.UpdateTenantReq
+          uest.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.UpdateTenantRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateTenantRequest)
+
+DeleteTenantRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTenantRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETENANTREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_service_pb2",
+        __doc__="""Request to delete a tenant.
+  
+  
+  Attributes:
+      name:
+          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".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.DeleteTenantRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTenantRequest)
+
+ListTenantsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTenantsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTENANTSREQUEST,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_service_pb2",
+        __doc__="""List tenants for which the client has ACL visibility.
+  
+  
+  Attributes:
+      parent:
+          Required. Resource name of the project under which the tenant
+          is created.  The format is "projects/{project\_id}", for
+          example, "projects/api-test-project".
+      page_token:
+          Optional. The starting indicator from which to return results.
+      page_size:
+          Optional. The maximum number of tenants to be returned, at
+          most 100. Default is 100 if a non-positive number is provided.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListTenantsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTenantsRequest)
+
+ListTenantsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTenantsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTENANTSRESPONSE,
+        __module__="google.cloud.talent_v4beta1.proto.tenant_service_pb2",
+        __doc__="""Output only.
+  
+  The List tenants response object.
+  
+  
+  Attributes:
+      tenants:
+          Tenants for the current client.
+      next_page_token:
+          A token to retrieve the next page of results.
+      metadata:
+          Additional information for the API invocation, such as the
+          request tracking id.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.talent.v4beta1.ListTenantsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTenantsResponse)
+
+
+DESCRIPTOR._options = None
+
+_TENANTSERVICE = _descriptor.ServiceDescriptor(
+    name="TenantService",
+    full_name="google.cloud.talent.v4beta1.TenantService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\023jobs.googleapis.com\322AShttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/jobs"
+    ),
+    serialized_start=835,
+    serialized_end=1715,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateTenant",
+            full_name="google.cloud.talent.v4beta1.TenantService.CreateTenant",
+            index=0,
+            containing_service=None,
+            input_type=_CREATETENANTREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2._TENANT,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v4beta1/{parent=projects/*}/tenants:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTenant",
+            full_name="google.cloud.talent.v4beta1.TenantService.GetTenant",
+            index=1,
+            containing_service=None,
+            input_type=_GETTENANTREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2._TENANT,
+            serialized_options=_b(
+                "\202\323\344\223\002&\022$/v4beta1/{name=projects/*/tenants/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateTenant",
+            full_name="google.cloud.talent.v4beta1.TenantService.UpdateTenant",
+            index=2,
+            containing_service=None,
+            input_type=_UPDATETENANTREQUEST,
+            output_type=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2._TENANT,
+            serialized_options=_b(
+                "\202\323\344\223\00202+/v4beta1/{tenant.name=projects/*/tenants/*}:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTenant",
+            full_name="google.cloud.talent.v4beta1.TenantService.DeleteTenant",
+            index=3,
+            containing_service=None,
+            input_type=_DELETETENANTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002&*$/v4beta1/{name=projects/*/tenants/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTenants",
+            full_name="google.cloud.talent.v4beta1.TenantService.ListTenants",
+            index=4,
+            containing_service=None,
+            input_type=_LISTTENANTSREQUEST,
+            output_type=_LISTTENANTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002&\022$/v4beta1/{parent=projects/*}/tenants"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_TENANTSERVICE)
+
+DESCRIPTOR.services_by_name["TenantService"] = _TENANTSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/talent/google/cloud/talent_v4beta1/proto/tenant_service_pb2_grpc.py b/talent/google/cloud/talent_v4beta1/proto/tenant_service_pb2_grpc.py
new file mode 100644
index 000000000000..48dd6dbb7a7b
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/proto/tenant_service_pb2_grpc.py
@@ -0,0 +1,121 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.talent_v4beta1.proto import (
+    tenant_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2,
+)
+from google.cloud.talent_v4beta1.proto import (
+    tenant_service_pb2 as google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class TenantServiceStub(object):
+    """A service that handles tenant management, including CRUD and enumeration.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateTenant = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.TenantService/CreateTenant",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.CreateTenantRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.Tenant.FromString,
+        )
+        self.GetTenant = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.TenantService/GetTenant",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.GetTenantRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.Tenant.FromString,
+        )
+        self.UpdateTenant = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.TenantService/UpdateTenant",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.UpdateTenantRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.Tenant.FromString,
+        )
+        self.DeleteTenant = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.TenantService/DeleteTenant",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.DeleteTenantRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListTenants = channel.unary_unary(
+            "/google.cloud.talent.v4beta1.TenantService/ListTenants",
+            request_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.ListTenantsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.ListTenantsResponse.FromString,
+        )
+
+
+class TenantServiceServicer(object):
+    """A service that handles tenant management, including CRUD and enumeration.
+  """
+
+    def CreateTenant(self, request, context):
+        """Creates a new tenant entity.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTenant(self, request, context):
+        """Retrieves specified tenant.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateTenant(self, request, context):
+        """Updates specified tenant.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTenant(self, request, context):
+        """Deletes specified tenant.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTenants(self, request, context):
+        """Lists all tenants associated with the project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_TenantServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateTenant": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTenant,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.CreateTenantRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.Tenant.SerializeToString,
+        ),
+        "GetTenant": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTenant,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.GetTenantRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.Tenant.SerializeToString,
+        ),
+        "UpdateTenant": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateTenant,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.UpdateTenantRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__pb2.Tenant.SerializeToString,
+        ),
+        "DeleteTenant": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTenant,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.DeleteTenantRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListTenants": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTenants,
+            request_deserializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.ListTenantsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_talent__v4beta1_dot_proto_dot_tenant__service__pb2.ListTenantsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.talent.v4beta1.TenantService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/talent/google/cloud/talent_v4beta1/types.py b/talent/google/cloud/talent_v4beta1/types.py
new file mode 100644
index 000000000000..82150c9e83c5
--- /dev/null
+++ b/talent/google/cloud/talent_v4beta1/types.py
@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.cloud.talent_v4beta1.proto import common_pb2
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+from google.cloud.talent_v4beta1.proto import event_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2
+from google.cloud.talent_v4beta1.proto import filters_pb2
+from google.cloud.talent_v4beta1.proto import histogram_pb2
+from google.cloud.talent_v4beta1.proto import job_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2
+from google.cloud.talent_v4beta1.proto import profile_pb2
+from google.cloud.talent_v4beta1.proto import profile_service_pb2
+from google.cloud.talent_v4beta1.proto import tenant_pb2
+from google.cloud.talent_v4beta1.proto import tenant_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import date_pb2
+from google.type import latlng_pb2
+from google.type import money_pb2
+from google.type import postal_address_pb2
+from google.type import timeofday_pb2
+
+
+_shared_modules = [
+    operations_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    date_pb2,
+    latlng_pb2,
+    money_pb2,
+    postal_address_pb2,
+    timeofday_pb2,
+]
+
+_local_modules = [
+    application_pb2,
+    application_service_pb2,
+    common_pb2,
+    company_pb2,
+    company_service_pb2,
+    completion_service_pb2,
+    event_pb2,
+    event_service_pb2,
+    filters_pb2,
+    histogram_pb2,
+    job_pb2,
+    job_service_pb2,
+    profile_pb2,
+    profile_service_pb2,
+    tenant_pb2,
+    tenant_service_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.talent_v4beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/talent/noxfile.py b/talent/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/talent/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/talent/setup.cfg b/talent/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/talent/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/talent/setup.py b/talent/setup.py
new file mode 100644
index 000000000000..0476b9315445
--- /dev/null
+++ b/talent/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-talent"
+description = "Google Cloud Talent Solution API client library"
+version = "0.3.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/talent/synth.metadata b/talent/synth.metadata
new file mode 100644
index 000000000000..1dcb16adea28
--- /dev/null
+++ b/talent/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-28T12:36:29.083499Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.35.1",
+        "dockerImage": "googleapis/artman@sha256:b11c7ea0d0831c54016fb50f4b796d24d1971439b30fbc32a369ba1ac887c384"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "dbd38035c35083507e2f0b839985cf17e212cb1c",
+        "internalRef": "265796259"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "talent",
+        "apiVersion": "v4beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/talent/artman_talent_v4beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/talent/synth.py b/talent/synth.py
new file mode 100644
index 000000000000..538917af1efb
--- /dev/null
+++ b/talent/synth.py
@@ -0,0 +1,40 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import re
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v4beta1"]
+
+excludes = ["setup.py", "nox*.py", "README.rst", "docs/conf.py", "docs/index.rst"]
+# ----------------------------------------------------------------------------
+# Generate speech GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+   library = gapic.py_library("talent", version, include_protos=True,)
+   s.move(library, excludes=excludes)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/talent/tests/unit/gapic/v4beta1/test_application_service_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_application_service_client_v4beta1.py
new file mode 100644
index 000000000000..837953109175
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_application_service_client_v4beta1.py
@@ -0,0 +1,314 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import application_pb2
+from google.cloud.talent_v4beta1.proto import application_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestApplicationServiceClient(object):
+    def test_create_application(self):
+        # Setup Expected Response
+        name = "name3373707"
+        external_id = "externalId-1153075697"
+        profile = "profile-309425751"
+        job = "job105405"
+        company = "company950484093"
+        outcome_notes = "outcomeNotes-355961964"
+        job_title_snippet = "jobTitleSnippet-1100512972"
+        expected_response = {
+            "name": name,
+            "external_id": external_id,
+            "profile": profile,
+            "job": job,
+            "company": company,
+            "outcome_notes": outcome_notes,
+            "job_title_snippet": job_title_snippet,
+        }
+        expected_response = application_pb2.Application(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup Request
+        parent = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+        application = {}
+
+        response = client.create_application(parent, application)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = application_service_pb2.CreateApplicationRequest(
+            parent=parent, application=application
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_application_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup request
+        parent = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+        application = {}
+
+        with pytest.raises(CustomException):
+            client.create_application(parent, application)
+
+    def test_get_application(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        external_id = "externalId-1153075697"
+        profile = "profile-309425751"
+        job = "job105405"
+        company = "company950484093"
+        outcome_notes = "outcomeNotes-355961964"
+        job_title_snippet = "jobTitleSnippet-1100512972"
+        expected_response = {
+            "name": name_2,
+            "external_id": external_id,
+            "profile": profile,
+            "job": job,
+            "company": company,
+            "outcome_notes": outcome_notes,
+            "job_title_snippet": job_title_snippet,
+        }
+        expected_response = application_pb2.Application(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup Request
+        name = client.application_path(
+            "[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]"
+        )
+
+        response = client.get_application(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = application_service_pb2.GetApplicationRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_application_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup request
+        name = client.application_path(
+            "[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_application(name)
+
+    def test_update_application(self):
+        # Setup Expected Response
+        name = "name3373707"
+        external_id = "externalId-1153075697"
+        profile = "profile-309425751"
+        job = "job105405"
+        company = "company950484093"
+        outcome_notes = "outcomeNotes-355961964"
+        job_title_snippet = "jobTitleSnippet-1100512972"
+        expected_response = {
+            "name": name,
+            "external_id": external_id,
+            "profile": profile,
+            "job": job,
+            "company": company,
+            "outcome_notes": outcome_notes,
+            "job_title_snippet": job_title_snippet,
+        }
+        expected_response = application_pb2.Application(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup Request
+        application = {}
+
+        response = client.update_application(application)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = application_service_pb2.UpdateApplicationRequest(
+            application=application
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_application_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup request
+        application = {}
+
+        with pytest.raises(CustomException):
+            client.update_application(application)
+
+    def test_delete_application(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup Request
+        name = client.application_path(
+            "[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]"
+        )
+
+        client.delete_application(name)
+
+        assert len(channel.requests) == 1
+        expected_request = application_service_pb2.DeleteApplicationRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_application_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup request
+        name = client.application_path(
+            "[PROJECT]", "[TENANT]", "[PROFILE]", "[APPLICATION]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_application(name)
+
+    def test_list_applications(self):
+        # Setup Expected Response
+        next_page_token = ""
+        applications_element = {}
+        applications = [applications_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "applications": applications,
+        }
+        expected_response = application_service_pb2.ListApplicationsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup Request
+        parent = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+
+        paged_list_response = client.list_applications(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.applications[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = application_service_pb2.ListApplicationsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_applications_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ApplicationServiceClient()
+
+        # Setup request
+        parent = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+
+        paged_list_response = client.list_applications(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/talent/tests/unit/gapic/v4beta1/test_company_service_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_company_service_client_v4beta1.py
new file mode 100644
index 000000000000..8fe5b4be5026
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_company_service_client_v4beta1.py
@@ -0,0 +1,317 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import company_pb2
+from google.cloud.talent_v4beta1.proto import company_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCompanyServiceClient(object):
+    def test_create_company(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        external_id = "externalId-1153075697"
+        headquarters_address = "headquartersAddress-1879520036"
+        hiring_agency = False
+        eeo_text = "eeoText-1652097123"
+        website_uri = "websiteUri-2118185016"
+        career_site_uri = "careerSiteUri1223331861"
+        image_uri = "imageUri-877823864"
+        suspended = False
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "external_id": external_id,
+            "headquarters_address": headquarters_address,
+            "hiring_agency": hiring_agency,
+            "eeo_text": eeo_text,
+            "website_uri": website_uri,
+            "career_site_uri": career_site_uri,
+            "image_uri": image_uri,
+            "suspended": suspended,
+        }
+        expected_response = company_pb2.Company(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        company = {}
+
+        response = client.create_company(parent, company)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = company_service_pb2.CreateCompanyRequest(
+            parent=parent, company=company
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_company_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        company = {}
+
+        with pytest.raises(CustomException):
+            client.create_company(parent, company)
+
+    def test_get_company(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        external_id = "externalId-1153075697"
+        headquarters_address = "headquartersAddress-1879520036"
+        hiring_agency = False
+        eeo_text = "eeoText-1652097123"
+        website_uri = "websiteUri-2118185016"
+        career_site_uri = "careerSiteUri1223331861"
+        image_uri = "imageUri-877823864"
+        suspended = False
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "external_id": external_id,
+            "headquarters_address": headquarters_address,
+            "hiring_agency": hiring_agency,
+            "eeo_text": eeo_text,
+            "website_uri": website_uri,
+            "career_site_uri": career_site_uri,
+            "image_uri": image_uri,
+            "suspended": suspended,
+        }
+        expected_response = company_pb2.Company(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup Request
+        name = client.company_path("[PROJECT]", "[TENANT]", "[COMPANY]")
+
+        response = client.get_company(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = company_service_pb2.GetCompanyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_company_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup request
+        name = client.company_path("[PROJECT]", "[TENANT]", "[COMPANY]")
+
+        with pytest.raises(CustomException):
+            client.get_company(name)
+
+    def test_update_company(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        external_id = "externalId-1153075697"
+        headquarters_address = "headquartersAddress-1879520036"
+        hiring_agency = False
+        eeo_text = "eeoText-1652097123"
+        website_uri = "websiteUri-2118185016"
+        career_site_uri = "careerSiteUri1223331861"
+        image_uri = "imageUri-877823864"
+        suspended = False
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "external_id": external_id,
+            "headquarters_address": headquarters_address,
+            "hiring_agency": hiring_agency,
+            "eeo_text": eeo_text,
+            "website_uri": website_uri,
+            "career_site_uri": career_site_uri,
+            "image_uri": image_uri,
+            "suspended": suspended,
+        }
+        expected_response = company_pb2.Company(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup Request
+        company = {}
+
+        response = client.update_company(company)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = company_service_pb2.UpdateCompanyRequest(company=company)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_company_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup request
+        company = {}
+
+        with pytest.raises(CustomException):
+            client.update_company(company)
+
+    def test_delete_company(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup Request
+        name = client.company_path("[PROJECT]", "[TENANT]", "[COMPANY]")
+
+        client.delete_company(name)
+
+        assert len(channel.requests) == 1
+        expected_request = company_service_pb2.DeleteCompanyRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_company_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup request
+        name = client.company_path("[PROJECT]", "[TENANT]", "[COMPANY]")
+
+        with pytest.raises(CustomException):
+            client.delete_company(name)
+
+    def test_list_companies(self):
+        # Setup Expected Response
+        next_page_token = ""
+        companies_element = {}
+        companies = [companies_element]
+        expected_response = {"next_page_token": next_page_token, "companies": companies}
+        expected_response = company_service_pb2.ListCompaniesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        paged_list_response = client.list_companies(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.companies[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = company_service_pb2.ListCompaniesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_companies_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompanyServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        paged_list_response = client.list_companies(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/talent/tests/unit/gapic/v4beta1/test_completion_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_completion_client_v4beta1.py
new file mode 100644
index 000000000000..8f6eef731c95
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_completion_client_v4beta1.py
@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import completion_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCompletionClient(object):
+    def test_complete_query(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = completion_service_pb2.CompleteQueryResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompletionClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        query = "query107944136"
+        page_size = 883849137
+
+        response = client.complete_query(parent, query, page_size)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = completion_service_pb2.CompleteQueryRequest(
+            parent=parent, query=query, page_size=page_size
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_complete_query_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.CompletionClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        query = "query107944136"
+        page_size = 883849137
+
+        with pytest.raises(CustomException):
+            client.complete_query(parent, query, page_size)
diff --git a/talent/tests/unit/gapic/v4beta1/test_event_service_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_event_service_client_v4beta1.py
new file mode 100644
index 000000000000..d6ab79e6be3f
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_event_service_client_v4beta1.py
@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import event_pb2
+from google.cloud.talent_v4beta1.proto import event_service_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestEventServiceClient(object):
+    def test_create_client_event(self):
+        # Setup Expected Response
+        request_id = "requestId37109963"
+        event_id = "eventId278118624"
+        event_notes = "eventNotes445073628"
+        expected_response = {
+            "request_id": request_id,
+            "event_id": event_id,
+            "event_notes": event_notes,
+        }
+        expected_response = event_pb2.ClientEvent(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.EventServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        client_event = {}
+
+        response = client.create_client_event(parent, client_event)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = event_service_pb2.CreateClientEventRequest(
+            parent=parent, client_event=client_event
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_client_event_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.EventServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        client_event = {}
+
+        with pytest.raises(CustomException):
+            client.create_client_event(parent, client_event)
diff --git a/talent/tests/unit/gapic/v4beta1/test_job_service_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_job_service_client_v4beta1.py
new file mode 100644
index 000000000000..050dec5f2125
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_job_service_client_v4beta1.py
@@ -0,0 +1,588 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import common_pb2
+from google.cloud.talent_v4beta1.proto import job_pb2
+from google.cloud.talent_v4beta1.proto import job_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestJobServiceClient(object):
+    def test_create_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        company = "company950484093"
+        requisition_id = "requisitionId980224926"
+        title = "title110371416"
+        description = "description-1724546052"
+        department = "department848184146"
+        incentives = "incentives-1262874520"
+        language_code = "languageCode-412800396"
+        promotion_value = 353413845
+        qualifications = "qualifications1903501412"
+        responsibilities = "responsibilities-926952660"
+        company_display_name = "companyDisplayName1982424170"
+        expected_response = {
+            "name": name,
+            "company": company,
+            "requisition_id": requisition_id,
+            "title": title,
+            "description": description,
+            "department": department,
+            "incentives": incentives,
+            "language_code": language_code,
+            "promotion_value": promotion_value,
+            "qualifications": qualifications,
+            "responsibilities": responsibilities,
+            "company_display_name": company_display_name,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        job = {}
+
+        response = client.create_job(parent, job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.CreateJobRequest(parent=parent, job=job)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.create_job(parent, job)
+
+    def test_get_job(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        company = "company950484093"
+        requisition_id = "requisitionId980224926"
+        title = "title110371416"
+        description = "description-1724546052"
+        department = "department848184146"
+        incentives = "incentives-1262874520"
+        language_code = "languageCode-412800396"
+        promotion_value = 353413845
+        qualifications = "qualifications1903501412"
+        responsibilities = "responsibilities-926952660"
+        company_display_name = "companyDisplayName1982424170"
+        expected_response = {
+            "name": name_2,
+            "company": company,
+            "requisition_id": requisition_id,
+            "title": title,
+            "description": description,
+            "department": department,
+            "incentives": incentives,
+            "language_code": language_code,
+            "promotion_value": promotion_value,
+            "qualifications": qualifications,
+            "responsibilities": responsibilities,
+            "company_display_name": company_display_name,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[TENANT]", "[JOBS]")
+
+        response = client.get_job(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.GetJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[TENANT]", "[JOBS]")
+
+        with pytest.raises(CustomException):
+            client.get_job(name)
+
+    def test_update_job(self):
+        # Setup Expected Response
+        name = "name3373707"
+        company = "company950484093"
+        requisition_id = "requisitionId980224926"
+        title = "title110371416"
+        description = "description-1724546052"
+        department = "department848184146"
+        incentives = "incentives-1262874520"
+        language_code = "languageCode-412800396"
+        promotion_value = 353413845
+        qualifications = "qualifications1903501412"
+        responsibilities = "responsibilities-926952660"
+        company_display_name = "companyDisplayName1982424170"
+        expected_response = {
+            "name": name,
+            "company": company,
+            "requisition_id": requisition_id,
+            "title": title,
+            "description": description,
+            "department": department,
+            "incentives": incentives,
+            "language_code": language_code,
+            "promotion_value": promotion_value,
+            "qualifications": qualifications,
+            "responsibilities": responsibilities,
+            "company_display_name": company_display_name,
+        }
+        expected_response = job_pb2.Job(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        job = {}
+
+        response = client.update_job(job)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.UpdateJobRequest(job=job)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        job = {}
+
+        with pytest.raises(CustomException):
+            client.update_job(job)
+
+    def test_delete_job(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        name = client.job_path("[PROJECT]", "[TENANT]", "[JOBS]")
+
+        client.delete_job(name)
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.DeleteJobRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_job_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        name = client.job_path("[PROJECT]", "[TENANT]", "[JOBS]")
+
+        with pytest.raises(CustomException):
+            client.delete_job(name)
+
+    def test_list_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        jobs_element = {}
+        jobs = [jobs_element]
+        expected_response = {"next_page_token": next_page_token, "jobs": jobs}
+        expected_response = job_service_pb2.ListJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_jobs(parent, filter_)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.ListJobsRequest(
+            parent=parent, filter=filter_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_jobs(parent, filter_)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_batch_delete_jobs(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        filter_ = "filter-1274492040"
+
+        client.batch_delete_jobs(parent, filter_)
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.BatchDeleteJobsRequest(
+            parent=parent, filter=filter_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_delete_jobs_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        filter_ = "filter-1274492040"
+
+        with pytest.raises(CustomException):
+            client.batch_delete_jobs(parent, filter_)
+
+    def test_search_jobs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        estimated_total_size = 1882144769
+        total_size = 705419236
+        broadened_query_jobs_count = 1432104658
+        matching_jobs_element = {}
+        matching_jobs = [matching_jobs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "estimated_total_size": estimated_total_size,
+            "total_size": total_size,
+            "broadened_query_jobs_count": broadened_query_jobs_count,
+            "matching_jobs": matching_jobs,
+        }
+        expected_response = job_service_pb2.SearchJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        request_metadata = {}
+
+        paged_list_response = client.search_jobs(parent, request_metadata)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.matching_jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.SearchJobsRequest(
+            parent=parent, request_metadata=request_metadata
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_jobs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        request_metadata = {}
+
+        paged_list_response = client.search_jobs(parent, request_metadata)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_search_jobs_for_alert(self):
+        # Setup Expected Response
+        next_page_token = ""
+        estimated_total_size = 1882144769
+        total_size = 705419236
+        broadened_query_jobs_count = 1432104658
+        matching_jobs_element = {}
+        matching_jobs = [matching_jobs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "estimated_total_size": estimated_total_size,
+            "total_size": total_size,
+            "broadened_query_jobs_count": broadened_query_jobs_count,
+            "matching_jobs": matching_jobs,
+        }
+        expected_response = job_service_pb2.SearchJobsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        request_metadata = {}
+
+        paged_list_response = client.search_jobs_for_alert(parent, request_metadata)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.matching_jobs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.SearchJobsRequest(
+            parent=parent, request_metadata=request_metadata
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_jobs_for_alert_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        request_metadata = {}
+
+        paged_list_response = client.search_jobs_for_alert(parent, request_metadata)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_batch_create_jobs(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = job_service_pb2.JobOperationResult(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_create_jobs", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        jobs = []
+
+        response = client.batch_create_jobs(parent, jobs)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.BatchCreateJobsRequest(
+            parent=parent, jobs=jobs
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_create_jobs_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_create_jobs_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        jobs = []
+
+        response = client.batch_create_jobs(parent, jobs)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_batch_update_jobs(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = job_service_pb2.JobOperationResult(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_update_jobs", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        jobs = []
+
+        response = client.batch_update_jobs(parent, jobs)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = job_service_pb2.BatchUpdateJobsRequest(
+            parent=parent, jobs=jobs
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_update_jobs_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_update_jobs_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.JobServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        jobs = []
+
+        response = client.batch_update_jobs(parent, jobs)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/talent/tests/unit/gapic/v4beta1/test_profile_service_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_profile_service_client_v4beta1.py
new file mode 100644
index 000000000000..7ca0a6d1b829
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_profile_service_client_v4beta1.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import common_pb2
+from google.cloud.talent_v4beta1.proto import profile_pb2
+from google.cloud.talent_v4beta1.proto import profile_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestProfileServiceClient(object):
+    def test_list_profiles(self):
+        # Setup Expected Response
+        next_page_token = ""
+        profiles_element = {}
+        profiles = [profiles_element]
+        expected_response = {"next_page_token": next_page_token, "profiles": profiles}
+        expected_response = profile_service_pb2.ListProfilesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        paged_list_response = client.list_profiles(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.profiles[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = profile_service_pb2.ListProfilesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_profiles_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        paged_list_response = client.list_profiles(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_create_profile(self):
+        # Setup Expected Response
+        name = "name3373707"
+        external_id = "externalId-1153075697"
+        source = "source-896505829"
+        uri = "uri116076"
+        group_id = "groupId506361563"
+        processed = True
+        keyword_snippet = "keywordSnippet1325317319"
+        expected_response = {
+            "name": name,
+            "external_id": external_id,
+            "source": source,
+            "uri": uri,
+            "group_id": group_id,
+            "processed": processed,
+            "keyword_snippet": keyword_snippet,
+        }
+        expected_response = profile_pb2.Profile(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        profile = {}
+
+        response = client.create_profile(parent, profile)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = profile_service_pb2.CreateProfileRequest(
+            parent=parent, profile=profile
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        profile = {}
+
+        with pytest.raises(CustomException):
+            client.create_profile(parent, profile)
+
+    def test_get_profile(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        external_id = "externalId-1153075697"
+        source = "source-896505829"
+        uri = "uri116076"
+        group_id = "groupId506361563"
+        processed = True
+        keyword_snippet = "keywordSnippet1325317319"
+        expected_response = {
+            "name": name_2,
+            "external_id": external_id,
+            "source": source,
+            "uri": uri,
+            "group_id": group_id,
+            "processed": processed,
+            "keyword_snippet": keyword_snippet,
+        }
+        expected_response = profile_pb2.Profile(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup Request
+        name = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+
+        response = client.get_profile(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = profile_service_pb2.GetProfileRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup request
+        name = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+
+        with pytest.raises(CustomException):
+            client.get_profile(name)
+
+    def test_update_profile(self):
+        # Setup Expected Response
+        name = "name3373707"
+        external_id = "externalId-1153075697"
+        source = "source-896505829"
+        uri = "uri116076"
+        group_id = "groupId506361563"
+        processed = True
+        keyword_snippet = "keywordSnippet1325317319"
+        expected_response = {
+            "name": name,
+            "external_id": external_id,
+            "source": source,
+            "uri": uri,
+            "group_id": group_id,
+            "processed": processed,
+            "keyword_snippet": keyword_snippet,
+        }
+        expected_response = profile_pb2.Profile(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup Request
+        profile = {}
+
+        response = client.update_profile(profile)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = profile_service_pb2.UpdateProfileRequest(profile=profile)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup request
+        profile = {}
+
+        with pytest.raises(CustomException):
+            client.update_profile(profile)
+
+    def test_delete_profile(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup Request
+        name = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+
+        client.delete_profile(name)
+
+        assert len(channel.requests) == 1
+        expected_request = profile_service_pb2.DeleteProfileRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_profile_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup request
+        name = client.profile_path("[PROJECT]", "[TENANT]", "[PROFILE]")
+
+        with pytest.raises(CustomException):
+            client.delete_profile(name)
+
+    def test_search_profiles(self):
+        # Setup Expected Response
+        estimated_total_size = 1882144769
+        next_page_token = ""
+        result_set_id = "resultSetId-770306950"
+        summarized_profiles_element = {}
+        summarized_profiles = [summarized_profiles_element]
+        expected_response = {
+            "estimated_total_size": estimated_total_size,
+            "next_page_token": next_page_token,
+            "result_set_id": result_set_id,
+            "summarized_profiles": summarized_profiles,
+        }
+        expected_response = profile_service_pb2.SearchProfilesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup Request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        request_metadata = {}
+
+        paged_list_response = client.search_profiles(parent, request_metadata)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.summarized_profiles[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = profile_service_pb2.SearchProfilesRequest(
+            parent=parent, request_metadata=request_metadata
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_profiles_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.ProfileServiceClient()
+
+        # Setup request
+        parent = client.tenant_path("[PROJECT]", "[TENANT]")
+        request_metadata = {}
+
+        paged_list_response = client.search_profiles(parent, request_metadata)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/talent/tests/unit/gapic/v4beta1/test_tenant_service_client_v4beta1.py b/talent/tests/unit/gapic/v4beta1/test_tenant_service_client_v4beta1.py
new file mode 100644
index 000000000000..76175f15383e
--- /dev/null
+++ b/talent/tests/unit/gapic/v4beta1/test_tenant_service_client_v4beta1.py
@@ -0,0 +1,258 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import talent_v4beta1
+from google.cloud.talent_v4beta1.proto import tenant_pb2
+from google.cloud.talent_v4beta1.proto import tenant_service_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestTenantServiceClient(object):
+    def test_create_tenant(self):
+        # Setup Expected Response
+        name = "name3373707"
+        external_id = "externalId-1153075697"
+        expected_response = {"name": name, "external_id": external_id}
+        expected_response = tenant_pb2.Tenant(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        tenant = {}
+
+        response = client.create_tenant(parent, tenant)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = tenant_service_pb2.CreateTenantRequest(
+            parent=parent, tenant=tenant
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_tenant_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        tenant = {}
+
+        with pytest.raises(CustomException):
+            client.create_tenant(parent, tenant)
+
+    def test_get_tenant(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        external_id = "externalId-1153075697"
+        expected_response = {"name": name_2, "external_id": external_id}
+        expected_response = tenant_pb2.Tenant(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup Request
+        name = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        response = client.get_tenant(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = tenant_service_pb2.GetTenantRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_tenant_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup request
+        name = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        with pytest.raises(CustomException):
+            client.get_tenant(name)
+
+    def test_update_tenant(self):
+        # Setup Expected Response
+        name = "name3373707"
+        external_id = "externalId-1153075697"
+        expected_response = {"name": name, "external_id": external_id}
+        expected_response = tenant_pb2.Tenant(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup Request
+        tenant = {}
+
+        response = client.update_tenant(tenant)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = tenant_service_pb2.UpdateTenantRequest(tenant=tenant)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_tenant_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup request
+        tenant = {}
+
+        with pytest.raises(CustomException):
+            client.update_tenant(tenant)
+
+    def test_delete_tenant(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup Request
+        name = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        client.delete_tenant(name)
+
+        assert len(channel.requests) == 1
+        expected_request = tenant_service_pb2.DeleteTenantRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_tenant_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup request
+        name = client.tenant_path("[PROJECT]", "[TENANT]")
+
+        with pytest.raises(CustomException):
+            client.delete_tenant(name)
+
+    def test_list_tenants(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tenants_element = {}
+        tenants = [tenants_element]
+        expected_response = {"next_page_token": next_page_token, "tenants": tenants}
+        expected_response = tenant_service_pb2.ListTenantsResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_tenants(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tenants[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = tenant_service_pb2.ListTenantsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tenants_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = talent_v4beta1.TenantServiceClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_tenants(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/tasks/.coveragerc b/tasks/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/tasks/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/tasks/.flake8 b/tasks/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/tasks/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/tasks/.repo-metadata.json b/tasks/.repo-metadata.json
new file mode 100644
index 000000000000..09c8b82ab1bd
--- /dev/null
+++ b/tasks/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudtasks",
+  "name_pretty": "Cloud Tasks",
+  "product_documentation": "https://cloud.google.com/tasks/docs/",
+  "client_documentation": "https://googleapis.dev/python/cloudtasks/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5433985",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-tasks",
+  "api_id": "cloudtasks.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/tasks/CHANGELOG.md b/tasks/CHANGELOG.md
new file mode 100644
index 000000000000..a910fc21f898
--- /dev/null
+++ b/tasks/CHANGELOG.md
@@ -0,0 +1,182 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-tasks/#history
+
+## 1.2.1
+
+08-12-2019 13:50 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8971](https://github.com/googleapis/google-cloud-python/pull/8971))
+
+### Documentation
+- Fix links to googleapis.dev ([#8998](https://github.com/googleapis/google-cloud-python/pull/8998))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 1.2.0
+
+07-24-2019 17:41 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8406](https://github.com/googleapis/google-cloud-python/pull/8406))
+
+### New Features
+- Add 'options_' argument to clients' 'get_iam_policy'; pin black version (via synth). ([#8660](https://github.com/googleapis/google-cloud-python/pull/8660))
+- Add 'client_options' support, update list method docstrings (via synth). ([#8524](https://github.com/googleapis/google-cloud-python/pull/8524))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+- Update pin for 'grpc-google-iam-v1' to 0.12.3+. ([#8647](https://github.com/googleapis/google-cloud-python/pull/8647))
+
+### Documentation
+
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Fix typo in README. ([#8606](https://github.com/googleapis/google-cloud-python/pull/8606))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8366](https://github.com/googleapis/google-cloud-python/pull/8366))
+- Add disclaimer to auto-generated template files (via synth).  ([#8330](https://github.com/googleapis/google-cloud-python/pull/8330))
+- Suppress checking 'cov-fail-under' in nox default session (via synth).  ([#8254](https://github.com/googleapis/google-cloud-python/pull/8254))
+- Fix coverage in 'types.py' (via synth). ([#8166](https://github.com/googleapis/google-cloud-python/pull/8166))
+- Blacken noxfile.py, setup.py (via synth). ([#8134](https://github.com/googleapis/google-cloud-python/pull/8134))
+- Add empty lines (via synth). ([#8074](https://github.com/googleapis/google-cloud-python/pull/8074))
+
+## 1.1.0
+
+05-14-2019 15:30 PDT
+
+### Implementation Changes
+- Remove log_sampling_ratio, add stackdriver_logging_config (via synth). ([#7950](https://github.com/googleapis/google-cloud-python/pull/7950))
+
+### Documentation
+- Update docstrings (via synth). ([#7963](https://github.com/googleapis/google-cloud-python/pull/7963))
+- Update docstrings (via synth). ([#7940](https://github.com/googleapis/google-cloud-python/pull/7940))
+
+### Internal / Testing Changes
+- Add nox session `docs`, reorder methods (via synth). ([#7783](https://github.com/googleapis/google-cloud-python/pull/7783))
+
+## 1.0.0
+
+04-29-2019 16:35 PDT
+
+### Documentation
+- Correct docs/index.rst. ([#7808](https://github.com/googleapis/google-cloud-python/pull/7808))
+
+### Internal / Testing Changes
+- Add smoke test. ([#7808](https://github.com/googleapis/google-cloud-python/pull/7808))
+
+## 0.7.0
+
+04-15-2019 10:21 PDT
+
+
+### New Features
+- Add auth and stackdriver logging configuration (via synth). ([#7666](https://github.com/googleapis/google-cloud-python/pull/7666))
+
+### Documentation
+- Tasks: Format docstrings for enums (via synth). ([#7601](https://github.com/googleapis/google-cloud-python/pull/7601))
+
+## 0.6.0
+
+03-26-2019 13:35 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Generate v2. ([#7547](https://github.com/googleapis/google-cloud-python/pull/7547))
+
+## 0.5.0
+
+03-06-2019 15:03 PST
+
+
+### Implementation Changes
+- Remove unused message exports (via synth). ([#7276](https://github.com/googleapis/google-cloud-python/pull/7276))
+- Protoc-generated serialization update. ([#7096](https://github.com/googleapis/google-cloud-python/pull/7096))
+
+### New Features
+- Add 'Task.http_request' and associated message type (via synth). ([#7432](https://github.com/googleapis/google-cloud-python/pull/7432))
+- Add 'Task.dispatch_deadline' via synth. ([#7211](https://github.com/googleapis/google-cloud-python/pull/7211))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+- Restore expanded example from PR [#7025](https://github.com/googleapis/google-cloud-python/pull/7025) after synth. ([#7062](https://github.com/googleapis/google-cloud-python/pull/7062))
+- Add working example for 'create_queue'. ([#7025](https://github.com/googleapis/google-cloud-python/pull/7025))
+- Pick up stub docstring fix in GAPIC generator. ([#6983](https://github.com/googleapis/google-cloud-python/pull/6983))
+
+### Internal / Testing Changes
+- Copy lintified proto files (via synth). ([#7471](https://github.com/googleapis/google-cloud-python/pull/7471))
+- Add clarifying comment to blacken nox target. ([#7405](https://github.com/googleapis/google-cloud-python/pull/7405))
+- Copy proto files alongside protoc versions
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.4.0
+
+12-18-2018 09:50 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up enum fixes in the GAPIC generator. ([#6616](https://github.com/googleapis/google-cloud-python/pull/6616))
+- Fix `client_info` bug, update docstrings and timeouts. ([#6422](https://github.com/googleapis/google-cloud-python/pull/6422))
+- Re-generate library using tasks/synth.py ([#5980](https://github.com/googleapis/google-cloud-python/pull/5980))
+
+### New Features
+- Pick up changes to GAPIC generator, drop 'Code' enum. ([#6509](https://github.com/googleapis/google-cloud-python/pull/6509))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Separate / distinguish API docs for different API versions. ([#6306](https://github.com/googleapis/google-cloud-python/pull/6306))
+- Docstring tweaks from protos. ([#6261](https://github.com/googleapis/google-cloud-python/pull/6261))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Remove autosynth / tweaks for 'README.rst' / 'setup.py'. ([#5957](https://github.com/googleapis/google-cloud-python/pull/5957))
+- Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Don't update nox in 'tasks/synth.py'. ([#6232](https://github.com/googleapis/google-cloud-python/pull/6232))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.3.0
+
+### Implementation Changes
+- Regenerate tasks to fix API enablement URL (#5579)
+
+### New Features
+- Tasks: Add v2beta3 endpoint (#5880)
+
+### Documentation
+- update Task library doc link (#5708)
+- tasks missing from docs (#5656)
+
+## 0.2.0
+
+### Implementation Changes
+- regenerate tasks v2beta2 (#5469)
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+
+## 0.1.0
+
+### New Features
+- Add v2beta2 endpoint for Tasks
+
diff --git a/tasks/LICENSE b/tasks/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/tasks/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/tasks/MANIFEST.in b/tasks/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/tasks/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/tasks/README.rst b/tasks/README.rst
new file mode 100644
index 000000000000..96328da5d937
--- /dev/null
+++ b/tasks/README.rst
@@ -0,0 +1,89 @@
+Python Client for Cloud Tasks API
+=================================
+
+|GA| |pypi| |versions| 
+
+`Cloud Tasks API`_: Manages the execution of large numbers of distributed
+requests.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-tasks.svg
+   :target: https://pypi.org/project/google-cloud-tasks/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-tasks.svg
+   :target: https://pypi.org/project/google-cloud-tasks/
+.. _Cloud Tasks API: https://cloud.google.com/tasks
+.. _Client Library Documentation: https://googleapis.dev/python/cloudtasks/latest
+.. _Product Documentation:  https://cloud.google.com/tasks
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Tasks API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Tasks API.:  https://console.cloud.google.com/apis/library/cloudtasks.googleapis.com
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-tasks
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-tasks
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Tasks API
+   to see other available methods on the client.
+-  Read the `Cloud Tasks API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+
+.. _Cloud Tasks API Product documentation:  https://cloud.google.com/tasks
diff --git a/tasks/docs/README.rst b/tasks/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/tasks/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/tasks/docs/changelog.md b/tasks/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/tasks/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/tasks/docs/conf.py b/tasks/docs/conf.py
new file mode 100644
index 000000000000..bac6547e691c
--- /dev/null
+++ b/tasks/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-tasks documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-tasks"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-tasks-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-tasks.tex",
+        u"google-cloud-tasks Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-tasks", u"google-cloud-tasks Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-tasks",
+        u"google-cloud-tasks Documentation",
+        author,
+        "google-cloud-tasks",
+        "GAPIC library for the {metadata.shortName} v2 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/tasks/docs/gapic/v2/api.rst b/tasks/docs/gapic/v2/api.rst
new file mode 100644
index 000000000000..229856fbde37
--- /dev/null
+++ b/tasks/docs/gapic/v2/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Tasks API
+==========================
+
+.. automodule:: google.cloud.tasks_v2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/tasks/docs/gapic/v2/types.rst b/tasks/docs/gapic/v2/types.rst
new file mode 100644
index 000000000000..8e518bb887dd
--- /dev/null
+++ b/tasks/docs/gapic/v2/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Tasks API Client
+================================
+
+.. automodule:: google.cloud.tasks_v2.types
+    :members:
\ No newline at end of file
diff --git a/tasks/docs/gapic/v2beta2/api.rst b/tasks/docs/gapic/v2beta2/api.rst
new file mode 100644
index 000000000000..80696d865a81
--- /dev/null
+++ b/tasks/docs/gapic/v2beta2/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Tasks API
+==========================
+
+.. automodule:: google.cloud.tasks_v2beta2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/tasks/docs/gapic/v2beta2/types.rst b/tasks/docs/gapic/v2beta2/types.rst
new file mode 100644
index 000000000000..375c1887069d
--- /dev/null
+++ b/tasks/docs/gapic/v2beta2/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Tasks API Client
+================================
+
+.. automodule:: google.cloud.tasks_v2beta2.types
+    :members:
\ No newline at end of file
diff --git a/tasks/docs/gapic/v2beta3/api.rst b/tasks/docs/gapic/v2beta3/api.rst
new file mode 100644
index 000000000000..17e911b7c38b
--- /dev/null
+++ b/tasks/docs/gapic/v2beta3/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Tasks API
+==========================
+
+.. automodule:: google.cloud.tasks_v2beta3
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/tasks/docs/gapic/v2beta3/types.rst b/tasks/docs/gapic/v2beta3/types.rst
new file mode 100644
index 000000000000..42bed0b59ae4
--- /dev/null
+++ b/tasks/docs/gapic/v2beta3/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Tasks API Client
+================================
+
+.. automodule:: google.cloud.tasks_v2beta3.types
+    :members:
\ No newline at end of file
diff --git a/tasks/docs/index.rst b/tasks/docs/index.rst
new file mode 100644
index 000000000000..03eab0c58f6c
--- /dev/null
+++ b/tasks/docs/index.rst
@@ -0,0 +1,45 @@
+.. include:: README.rst
+
+API Reference
+-------------
+
+This package includes clients for multiple versions of the Tasks
+API. By default, you will get ``v2``, the latest version.
+
+.. toctree::
+    :maxdepth: 2
+    
+    gapic/v2/api
+    gapic/v2/types
+
+
+The previous beta releases, spelled ``v2beta3`` and ``v2beta2``, are provided to continue to
+support code previously written against them. In order to use them, you
+will want to import from e.g.  ``google.cloud.tasks_v2beta3`` in lieu of
+``google.cloud.tasks`` (or the equivalent ``google.cloud.tasks_v2``).
+
+v2beta3:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v2beta3/api
+    gapic/v2beta3/types
+    
+v2beta2:
+
+.. toctree::
+    :maxdepth: 2
+    
+    gapic/v2beta2/api
+    gapic/v2beta2/types
+
+Changelog
+---------
+
+For a list of all `google-cloud-tasks` releases.
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/tasks/google/__init__.py b/tasks/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/tasks/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/tasks/google/cloud/__init__.py b/tasks/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/tasks/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/tasks/google/cloud/tasks.py b/tasks/google/cloud/tasks.py
new file mode 100644
index 000000000000..166c20fcfc20
--- /dev/null
+++ b/tasks/google/cloud/tasks.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.tasks_v2 import CloudTasksClient
+from google.cloud.tasks_v2 import enums
+from google.cloud.tasks_v2 import types
+
+
+__all__ = ("enums", "types", "CloudTasksClient")
diff --git a/tasks/google/cloud/tasks_v2/__init__.py b/tasks/google/cloud/tasks_v2/__init__.py
new file mode 100644
index 000000000000..1debd208992a
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.tasks_v2 import types
+from google.cloud.tasks_v2.gapic import cloud_tasks_client
+from google.cloud.tasks_v2.gapic import enums
+
+
+class CloudTasksClient(cloud_tasks_client.CloudTasksClient):
+    __doc__ = cloud_tasks_client.CloudTasksClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudTasksClient")
diff --git a/tasks/google/cloud/tasks_v2/gapic/__init__.py b/tasks/google/cloud/tasks_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py b/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py
new file mode 100644
index 000000000000..06e92dc49df5
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client.py
@@ -0,0 +1,1686 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.tasks.v2 CloudTasks API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.tasks_v2.gapic import cloud_tasks_client_config
+from google.cloud.tasks_v2.gapic import enums
+from google.cloud.tasks_v2.gapic.transports import cloud_tasks_grpc_transport
+from google.cloud.tasks_v2.proto import cloudtasks_pb2
+from google.cloud.tasks_v2.proto import cloudtasks_pb2_grpc
+from google.cloud.tasks_v2.proto import queue_pb2
+from google.cloud.tasks_v2.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks").version
+
+
+class CloudTasksClient(object):
+    """
+    Cloud Tasks allows developers to manage the execution of background
+    work in their applications.
+    """
+
+    SERVICE_ADDRESS = "cloudtasks.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.tasks.v2.CloudTasks"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudTasksClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def queue_path(cls, project, location, queue):
+        """Return a fully-qualified queue string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/queues/{queue}",
+            project=project,
+            location=location,
+            queue=queue,
+        )
+
+    @classmethod
+    def task_path(cls, project, location, queue, task):
+        """Return a fully-qualified task string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}",
+            project=project,
+            location=location,
+            queue=queue,
+            task=task,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudTasksGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudTasksGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_tasks_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_tasks_grpc_transport.CloudTasksGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_tasks_grpc_transport.CloudTasksGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_queues(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists queues.
+
+        Queues are returned in lexicographical order.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_queues(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_queues(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``
+            filter_ (str): ``filter`` can be used to specify a subset of queues. Any ``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 "state: PAUSED".
+
+                Note that using filters might cause fewer queues than the requested
+                page\_size to be returned.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.tasks_v2.types.Queue` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_queues" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_queues"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_queues,
+                default_retry=self._method_configs["ListQueues"].retry,
+                default_timeout=self._method_configs["ListQueues"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ListQueuesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_queues"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="queues",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a queue.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.get_queue(name)
+
+        Args:
+            name (str): Required. The resource name of the queue. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_queue,
+                default_retry=self._method_configs["GetQueue"].retry,
+                default_timeout=self._method_configs["GetQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.GetQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_queue(
+        self,
+        parent,
+        queue,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `queue`:
+            >>> queue = {}
+            >>>
+            >>> response = client.create_queue(parent, queue)
+
+        Args:
+            parent (str): 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``.
+            queue (Union[dict, ~google.cloud.tasks_v2.types.Queue]): Required. The queue to create.
+
+                ``Queue's name`` cannot be the same as an existing queue.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2.types.Queue`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_queue,
+                default_retry=self._method_configs["CreateQueue"].retry,
+                default_timeout=self._method_configs["CreateQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_queue(
+        self,
+        queue,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a queue.
+
+        This method creates the queue if it does not exist and updates 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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> # TODO: Initialize `queue`:
+            >>> queue = {}
+            >>>
+            >>> response = client.update_queue(queue)
+
+        Args:
+            queue (Union[dict, ~google.cloud.tasks_v2.types.Queue]): Required. The queue to create or update.
+
+                The queue's ``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``
+                cannot be changed.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2.types.Queue`
+            update_mask (Union[dict, ~google.cloud.tasks_v2.types.FieldMask]): A mask used to specify which fields of the queue are being updated.
+
+                If empty, then all fields will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_queue,
+                default_retry=self._method_configs["UpdateQueue"].retry,
+                default_timeout=self._method_configs["UpdateQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.UpdateQueueRequest(
+            queue=queue, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("queue.name", queue.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a queue.
+
+        This command will delete the queue even if it has tasks in it.
+
+        Note: If you delete a queue, a queue with the same name can't be created
+        for 7 days.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> client.delete_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_queue,
+                default_retry=self._method_configs["DeleteQueue"].retry,
+                default_timeout=self._method_configs["DeleteQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.DeleteQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def purge_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Purges a queue by deleting all of its tasks.
+
+        All tasks created before this method is called are permanently deleted.
+
+        Purge operations can take up to one minute to take effect. Tasks
+        might be dispatched before the purge takes effect. A purge is irreversible.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.purge_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "purge_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "purge_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.purge_queue,
+                default_retry=self._method_configs["PurgeQueue"].retry,
+                default_timeout=self._method_configs["PurgeQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.PurgeQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["purge_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pause_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pauses the queue.
+
+        If a queue is paused then the system will stop dispatching tasks until
+        the queue is resumed via ``ResumeQueue``. Tasks can still be added when
+        the queue is paused. A queue is paused if its ``state`` is ``PAUSED``.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.pause_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pause_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "pause_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pause_queue,
+                default_retry=self._method_configs["PauseQueue"].retry,
+                default_timeout=self._method_configs["PauseQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.PauseQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["pause_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def resume_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Resume a queue.
+
+        This method resumes a queue after it has been ``PAUSED`` or
+        ``DISABLED``. The state of a queue is stored in the queue's ``state``;
+        after calling this method it will be set to ``RUNNING``.
+
+        WARNING: Resuming many high-QPS queues at the same time can lead to
+        target overloading. If you are resuming high-QPS queues, follow the
+        500/50/5 pattern described in `Managing Cloud Tasks Scaling
+        Risks <https://cloud.google.com/tasks/docs/manage-cloud-task-scaling>`__.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.resume_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "resume_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "resume_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.resume_queue,
+                default_retry=self._method_configs["ResumeQueue"].retry,
+                default_timeout=self._method_configs["ResumeQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ResumeQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["resume_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a ``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``
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.tasks_v2.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy for a ``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.
+
+        Authorization requires the following `Google
+        IAM <https://cloud.google.com/iam>`__ permission on the specified
+        resource parent:
+
+        -  ``cloudtasks.queues.setIamPolicy``
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.tasks_v2.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns permissions that a caller has on a ``Queue``. 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.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_tasks(
+        self,
+        parent,
+        response_view=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the tasks in a queue.
+
+        By default, only the ``BASIC`` view is retrieved due to performance
+        considerations; ``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.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tasks(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tasks(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.tasks_v2.types.Task` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tasks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tasks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tasks,
+                default_retry=self._method_configs["ListTasks"].retry,
+                default_timeout=self._method_configs["ListTasks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ListTasksRequest(
+            parent=parent, response_view=response_view, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tasks"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tasks",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_task(
+        self,
+        name,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a task.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> response = client.get_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_task,
+                default_retry=self._method_configs["GetTask"].retry,
+                default_timeout=self._method_configs["GetTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_task(
+        self,
+        parent,
+        task,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a task and adds it to a queue.
+
+        Tasks cannot be updated after creation; there is no UpdateTask command.
+
+        -  The maximum task size is 100KB.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `task`:
+            >>> task = {}
+            >>>
+            >>> response = client.create_task(parent, task)
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+
+                The queue must already exist.
+            task (Union[dict, ~google.cloud.tasks_v2.types.Task]): 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``. 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``.
+
+                If ``schedule_time`` is not set or is in the past then Cloud Tasks will
+                set it to the current time.
+
+                Task De-duplication:
+
+                Explicitly specifying a task ID enables task de-duplication. If a task's
+                ID is identical to that of an existing task or a task that was deleted
+                or executed recently then the call will fail with ``ALREADY_EXISTS``. If
+                the task's queue was created using Cloud Tasks, then another task with
+                the same name can't be created for ~1hour after the original task was
+                deleted or executed. If the task's queue was created using queue.yaml or
+                queue.xml, then another task with the same name can't be created for
+                ~9days after the original task was deleted or executed.
+
+                Because there is an extra lookup cost to identify duplicate task names,
+                these ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2.types.Task`
+            response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_task,
+                default_retry=self._method_configs["CreateTask"].retry,
+                default_timeout=self._method_configs["CreateTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CreateTaskRequest(
+            parent=parent, task=task, response_view=response_view
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_task(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a task.
+
+        A task can be deleted if it is scheduled or dispatched. A task
+        cannot be deleted if it has executed successfully or permanently
+        failed.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> client.delete_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_task,
+                default_retry=self._method_configs["DeleteTask"].retry,
+                default_timeout=self._method_configs["DeleteTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.DeleteTaskRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_task(
+        self,
+        name,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` or
+        is ``PAUSED``.
+
+        This command is meant to be used for manual debugging. For example,
+        ``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`` 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``
+        will be reset to the time that ``RunTask`` was called plus the retry
+        delay specified in the queue's ``RetryConfig``.
+
+        ``RunTask`` returns ``NOT_FOUND`` when it is called on a task that has
+        already succeeded or permanently failed.
+
+        Example:
+            >>> from google.cloud import tasks_v2
+            >>>
+            >>> client = tasks_v2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> response = client.run_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            response_view (~google.cloud.tasks_v2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_task,
+                default_retry=self._method_configs["RunTask"].retry,
+                default_timeout=self._method_configs["RunTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py b/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py
new file mode 100644
index 000000000000..5c059c9429b0
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py
@@ -0,0 +1,103 @@
+config = {
+    "interfaces": {
+        "google.cloud.tasks.v2.CloudTasks": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListQueues": {
+                    "timeout_millis": 15000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PurgeQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "PauseQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ResumeQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTasks": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/tasks/google/cloud/tasks_v2/gapic/enums.py b/tasks/google/cloud/tasks_v2/gapic/enums.py
new file mode 100644
index 000000000000..e6faa33bf832
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/gapic/enums.py
@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class HttpMethod(enum.IntEnum):
+    """
+    The HTTP method used to deliver the task.
+
+    Attributes:
+      HTTP_METHOD_UNSPECIFIED (int): HTTP method unspecified
+      POST (int): HTTP POST
+      GET (int): HTTP GET
+      HEAD (int): HTTP HEAD
+      PUT (int): HTTP PUT
+      DELETE (int): HTTP DELETE
+      PATCH (int): HTTP PATCH
+      OPTIONS (int): HTTP OPTIONS
+    """
+
+    HTTP_METHOD_UNSPECIFIED = 0
+    POST = 1
+    GET = 2
+    HEAD = 3
+    PUT = 4
+    DELETE = 5
+    PATCH = 6
+    OPTIONS = 7
+
+
+class Queue(object):
+    class State(enum.IntEnum):
+        """
+        State of the queue.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          RUNNING (int): The queue is running. Tasks can be dispatched.
+
+          If the queue was created using Cloud Tasks and the queue has had no
+          activity (method calls or task dispatches) for 30 days, the queue may
+          take a few minutes to re-activate. Some method calls may return
+          ``NOT_FOUND`` and tasks may not be dispatched for a few minutes until
+          the queue has been re-activated.
+          PAUSED (int): 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.
+          DISABLED (int): The queue is disabled.
+
+          A queue becomes ``DISABLED`` when
+          `queue.yaml <https://cloud.google.com/appengine/docs/python/config/queueref>`__
+          or
+          `queue.xml <https://cloud.google.com/appengine/docs/standard/java/config/queueref>`__
+          is uploaded which does not contain the queue. You cannot directly
+          disable a queue.
+
+          When a queue is disabled, tasks can still be added to a queue but the
+          tasks are not dispatched.
+
+          To permanently delete this queue and all of its tasks, call
+          ``DeleteQueue``.
+        """
+
+        STATE_UNSPECIFIED = 0
+        RUNNING = 1
+        PAUSED = 2
+        DISABLED = 3
+
+
+class Task(object):
+    class View(enum.IntEnum):
+        """
+        The view specifies a subset of ``Task`` data.
+
+        When a task is returned in a response, 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.
+
+        Attributes:
+          VIEW_UNSPECIFIED (int): Unspecified. Defaults to BASIC.
+          BASIC (int): The basic view omits fields which can be large or can contain sensitive
+          data.
+
+          This view does not include the ``body in AppEngineHttpRequest``. Bodies
+          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.
+          FULL (int): All information is returned.
+
+          Authorization for ``FULL`` requires ``cloudtasks.tasks.fullView``
+          `Google IAM <https://cloud.google.com/iam/>`__ permission on the
+          ``Queue`` resource.
+        """
+
+        VIEW_UNSPECIFIED = 0
+        BASIC = 1
+        FULL = 2
diff --git a/tasks/google/cloud/tasks_v2/gapic/transports/__init__.py b/tasks/google/cloud/tasks_v2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py b/tasks/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py
new file mode 100644
index 000000000000..fe10581422be
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py
@@ -0,0 +1,426 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.tasks_v2.proto import cloudtasks_pb2_grpc
+
+
+class CloudTasksGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.tasks.v2 CloudTasks API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudtasks.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudtasks.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_queues(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.list_queues`.
+
+        Lists queues.
+
+        Queues are returned in lexicographical order.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ListQueues
+
+    @property
+    def get_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_queue`.
+
+        Gets a queue.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetQueue
+
+    @property
+    def create_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.create_queue`.
+
+        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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CreateQueue
+
+    @property
+    def update_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.update_queue`.
+
+        Updates a queue.
+
+        This method creates the queue if it does not exist and updates 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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].UpdateQueue
+
+    @property
+    def delete_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.delete_queue`.
+
+        Deletes a queue.
+
+        This command will delete the queue even if it has tasks in it.
+
+        Note: If you delete a queue, a queue with the same name can't be created
+        for 7 days.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].DeleteQueue
+
+    @property
+    def purge_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.purge_queue`.
+
+        Purges a queue by deleting all of its tasks.
+
+        All tasks created before this method is called are permanently deleted.
+
+        Purge operations can take up to one minute to take effect. Tasks
+        might be dispatched before the purge takes effect. A purge is irreversible.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].PurgeQueue
+
+    @property
+    def pause_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.pause_queue`.
+
+        Pauses the queue.
+
+        If a queue is paused then the system will stop dispatching tasks until
+        the queue is resumed via ``ResumeQueue``. Tasks can still be added when
+        the queue is paused. A queue is paused if its ``state`` is ``PAUSED``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].PauseQueue
+
+    @property
+    def resume_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.resume_queue`.
+
+        Resume a queue.
+
+        This method resumes a queue after it has been ``PAUSED`` or
+        ``DISABLED``. The state of a queue is stored in the queue's ``state``;
+        after calling this method it will be set to ``RUNNING``.
+
+        WARNING: Resuming many high-QPS queues at the same time can lead to
+        target overloading. If you are resuming high-QPS queues, follow the
+        500/50/5 pattern described in `Managing Cloud Tasks Scaling
+        Risks <https://cloud.google.com/tasks/docs/manage-cloud-task-scaling>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ResumeQueue
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_iam_policy`.
+
+        Gets the access control policy for a ``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``
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetIamPolicy
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.set_iam_policy`.
+
+        Sets the access control policy for a ``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.
+
+        Authorization requires the following `Google
+        IAM <https://cloud.google.com/iam>`__ permission on the specified
+        resource parent:
+
+        -  ``cloudtasks.queues.setIamPolicy``
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].SetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.test_iam_permissions`.
+
+        Returns permissions that a caller has on a ``Queue``. 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].TestIamPermissions
+
+    @property
+    def list_tasks(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.list_tasks`.
+
+        Lists the tasks in a queue.
+
+        By default, only the ``BASIC`` view is retrieved due to performance
+        considerations; ``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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ListTasks
+
+    @property
+    def get_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_task`.
+
+        Gets a task.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetTask
+
+    @property
+    def create_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.create_task`.
+
+        Creates a task and adds it to a queue.
+
+        Tasks cannot be updated after creation; there is no UpdateTask command.
+
+        -  The maximum task size is 100KB.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CreateTask
+
+    @property
+    def delete_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.delete_task`.
+
+        Deletes a task.
+
+        A task can be deleted if it is scheduled or dispatched. A task
+        cannot be deleted if it has executed successfully or permanently
+        failed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].DeleteTask
+
+    @property
+    def run_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.run_task`.
+
+        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`` or
+        is ``PAUSED``.
+
+        This command is meant to be used for manual debugging. For example,
+        ``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`` 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``
+        will be reset to the time that ``RunTask`` was called plus the retry
+        delay specified in the queue's ``RetryConfig``.
+
+        ``RunTask`` returns ``NOT_FOUND`` when it is called on a task that has
+        already succeeded or permanently failed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].RunTask
diff --git a/tasks/google/cloud/tasks_v2/proto/__init__.py b/tasks/google/cloud/tasks_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto b/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto
new file mode 100644
index 000000000000..f948426a3655
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/cloudtasks.proto
@@ -0,0 +1,655 @@
+// 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.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";
+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 go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
+option java_multiple_files = true;
+option java_outer_classname = "CloudTasksProto";
+option java_package = "com.google.cloud.tasks.v2";
+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.
+  rpc ListQueues(ListQueuesRequest) returns (ListQueuesResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/locations/*}/queues"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a queue.
+  rpc GetQueue(GetQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      get: "/v2/{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.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc CreateQueue(CreateQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/locations/*}/queues"
+      body: "queue"
+    };
+    option (google.api.method_signature) = "parent,queue";
+  }
+
+  // Updates a queue.
+  //
+  // This method creates the queue if it does not exist and updates
+  // 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.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc UpdateQueue(UpdateQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      patch: "/v2/{queue.name=projects/*/locations/*/queues/*}"
+      body: "queue"
+    };
+    option (google.api.method_signature) = "queue,update_mask";
+  }
+
+  // Deletes a queue.
+  //
+  // This command will delete the queue even if it has tasks in it.
+  //
+  // Note: If you delete a queue, a queue with the same name can't be created
+  // for 7 days.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc DeleteQueue(DeleteQueueRequest) returns (google.protobuf.Empty) {
+    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.
+  //
+  // All tasks created before this method is called are permanently deleted.
+  //
+  // Purge operations can take up to one minute to take effect. Tasks
+  // might be dispatched before the purge takes effect. A purge is irreversible.
+  rpc PurgeQueue(PurgeQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2/{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.v2.CloudTasks.ResumeQueue]. Tasks can still be added
+  // when the queue is paused. A queue is paused if its
+  // [state][google.cloud.tasks.v2.Queue.state] is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED].
+  rpc PauseQueue(PauseQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2/{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.v2.Queue.State.PAUSED] or
+  // [DISABLED][google.cloud.tasks.v2.Queue.State.DISABLED]. The state of a queue is stored
+  // in the queue's [state][google.cloud.tasks.v2.Queue.state]; after calling this method it
+  // will be set to [RUNNING][google.cloud.tasks.v2.Queue.State.RUNNING].
+  //
+  // WARNING: Resuming many high-QPS queues at the same time can
+  // lead to target overloading. If you are resuming high-QPS
+  // queues, follow the 500/50/5 pattern described in
+  // [Managing Cloud Tasks Scaling
+  // Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+  rpc ResumeQueue(ResumeQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      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].
+  // 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) {
+    option (google.api.http) = {
+      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
+  // policy.
+  //
+  // Note: The Cloud Console does not check queue-level IAM permissions yet.
+  // Project-level permissions are required to use the Cloud Console.
+  //
+  // Authorization requires the following
+  // [Google IAM](https://cloud.google.com/iam) permission on the specified
+  // resource parent:
+  //
+  // * `cloudtasks.queues.setIamPolicy`
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      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].
+  // 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) {
+    option (google.api.http) = {
+      post: "/v2/{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.v2.Task.View.BASIC] view is retrieved
+  // due to performance considerations;
+  // [response_view][google.cloud.tasks.v2.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.
+  rpc ListTasks(ListTasksRequest) returns (ListTasksResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=projects/*/locations/*/queues/*}/tasks"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a task.
+  rpc GetTask(GetTaskRequest) returns (Task) {
+    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.
+  //
+  // Tasks cannot be updated after creation; there is no UpdateTask command.
+  //
+  // * The maximum task size is 100KB.
+  rpc CreateTask(CreateTaskRequest) returns (Task) {
+    option (google.api.http) = {
+      post: "/v2/{parent=projects/*/locations/*/queues/*}/tasks"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,task";
+  }
+
+  // Deletes a task.
+  //
+  // A task can be deleted if it is scheduled or dispatched. A task
+  // cannot be deleted if it has executed successfully or permanently
+  // failed.
+  rpc DeleteTask(DeleteTaskRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // 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.v2.RateLimits] or
+  // is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED].
+  //
+  // This command is meant to be used for manual debugging. For
+  // example, [RunTask][google.cloud.tasks.v2.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][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.v2.Task.schedule_time] will be reset to the time that
+  // [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] was called plus the retry delay specified
+  // in the queue's [RetryConfig][google.cloud.tasks.v2.RetryConfig].
+  //
+  // [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] returns
+  // [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
+  // task that has already succeeded or permanently failed.
+  rpc RunTask(RunTaskRequest) returns (Task) {
+    option (google.api.http) = {
+      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.
+  // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // `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.
+  // 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 "state: PAUSED".
+  //
+  // Note that using filters might cause fewer queues than the
+  // requested page_size to be returned.
+  string filter = 2;
+
+  // Requested page size.
+  //
+  // 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.v2.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.v2.ListQueuesResponse.next_page_token] returned
+  // from the previous call to [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues]
+  // method. It is an error to switch the value of the
+  // [filter][google.cloud.tasks.v2.ListQueuesRequest.filter] while iterating through pages.
+  string page_token = 4;
+}
+
+// Response message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues].
+message ListQueuesResponse {
+  // The list of queues.
+  repeated Queue queues = 1;
+
+  // A token to retrieve next page of results.
+  //
+  // To return the next page of results, call
+  // [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues] with this value as the
+  // [page_token][google.cloud.tasks.v2.ListQueuesRequest.page_token].
+  //
+  // If the next_page_token is empty, there are no more results.
+  //
+  // The page token is valid for only 2 hours.
+  string next_page_token = 2;
+}
+
+// Request message for [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue].
+message GetQueueRequest {
+  // Required. The resource name of the queue. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  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.
+  // 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 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // 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 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue].
+message UpdateQueueRequest {
+  // 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 [(google.api.field_behavior) = REQUIRED];
+
+  // A mask used to specify which fields of the queue are being updated.
+  //
+  // If empty, then all fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue].
+message DeleteQueueRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be
+  // returned.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2.Task] resource.
+  Task.View response_view = 2;
+
+  // Maximum page size.
+  //
+  // Fewer tasks than requested might be returned, even if more tasks exist; use
+  // [next_page_token][google.cloud.tasks.v2.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 = 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.v2.ListTasksResponse.next_page_token] returned
+  // from the previous call to [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks]
+  // method.
+  //
+  // The page token is valid for only 2 hours.
+  string page_token = 4;
+}
+
+// Response message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks].
+message ListTasksResponse {
+  // The list of tasks.
+  repeated Task tasks = 1;
+
+  // A token to retrieve next page of results.
+  //
+  // To return the next page of results, call
+  // [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks] with this value as the
+  // [page_token][google.cloud.tasks.v2.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.v2.CloudTasks.GetTask].
+message GetTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2.Task] resource.
+  Task.View response_view = 2;
+}
+
+// Request message for [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask].
+message CreateTaskRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  //
+  // The queue must already exist.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // 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.v2.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.v2.Task.name].
+  //
+  // If [schedule_time][google.cloud.tasks.v2.Task.schedule_time] is not set or is in the
+  // past then Cloud Tasks will set it to the current time.
+  //
+  // Task De-duplication:
+  //
+  // Explicitly specifying a task ID enables task de-duplication.  If
+  // a task's ID is identical to that of an existing task or a task
+  // that was deleted or executed recently then the call will fail
+  // with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
+  // If the task's queue was created using Cloud Tasks, then another task with
+  // the same name can't be created for ~1hour after the original task was
+  // deleted or executed. If the task's queue was created using queue.yaml or
+  // queue.xml, then another task with the same name can't be created
+  // for ~9days after the original task was deleted or executed.
+  //
+  // Because there is an extra lookup cost to identify duplicate task
+  // names, these [CreateTask][google.cloud.tasks.v2.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 [(google.api.field_behavior) = REQUIRED];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be
+  // returned.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2.Task] resource.
+  Task.View response_view = 3;
+}
+
+// Request message for deleting a task using
+// [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask].
+message DeleteTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2.Task] resource.
+  Task.View response_view = 2;
+}
diff --git a/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py b/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py
new file mode 100644
index 000000000000..55beb9139d88
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2.py
@@ -0,0 +1,1629 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2/proto/cloudtasks.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2.proto import (
+    queue_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2,
+)
+from google.cloud.tasks_v2.proto import (
+    task_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2/proto/cloudtasks.proto",
+    package="google.cloud.tasks.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.tasks.v2B\017CloudTasksProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\242\002\005TASKS"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/tasks_v2/proto/cloudtasks.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\'google/cloud/tasks_v2/proto/queue.proto\x1a&google/cloud/tasks_v2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x85\x01\n\x11ListQueuesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"[\n\x12ListQueuesResponse\x12,\n\x06queues\x18\x01 \x03(\x0b\x32\x1c.google.cloud.tasks.v2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x81\x01\n\x12\x43reateQueueRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x30\n\x05queue\x18\x02 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02"w\n\x12UpdateQueueRequest\x12\x30\n\x05queue\x18\x01 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xab\x01\n\x10ListTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"X\n\x11ListTasksResponse\x12*\n\x05tasks\x18\x01 \x03(\x0b\x32\x1b.google.cloud.tasks.v2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x7f\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"\xb5\x01\n\x11\x43reateTaskRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12.\n\x04task\x18\x02 \x01(\x0b\x32\x1b.google.cloud.tasks.v2.TaskB\x03\xe0\x41\x02\x12\x37\n\rresponse_view\x18\x03 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x7f\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View2\xdd\x14\n\nCloudTasks\x12\x9e\x01\n\nListQueues\x12(.google.cloud.tasks.v2.ListQueuesRequest\x1a).google.cloud.tasks.v2.ListQueuesResponse";\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x8b\x01\n\x08GetQueue\x12&.google.cloud.tasks.v2.GetQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"9\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa0\x01\n\x0b\x43reateQueue\x12).google.cloud.tasks.v2.CreateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"H\x82\xd3\xe4\x93\x02\x33"*/v2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xab\x01\n\x0bUpdateQueue\x12).google.cloud.tasks.v2.UpdateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"S\x82\xd3\xe4\x93\x02\x39\x32\x30/v2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x8b\x01\n\x0b\x44\x65leteQueue\x12).google.cloud.tasks.v2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\x98\x01\n\nPurgeQueue\x12(.google.cloud.tasks.v2.PurgeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\x98\x01\n\nPauseQueue\x12(.google.cloud.tasks.v2.PauseQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\x9b\x01\n\x0bResumeQueue\x12).google.cloud.tasks.v2.ResumeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"C\x82\xd3\xe4\x93\x02\x36"1/v2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\x9c\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"Q\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa3\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"X\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xce\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"c\x82\xd3\xe4\x93\x02\x46"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xa3\x01\n\tListTasks\x12\'.google.cloud.tasks.v2.ListTasksRequest\x1a(.google.cloud.tasks.v2.ListTasksResponse"C\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x90\x01\n\x07GetTask\x12%.google.cloud.tasks.v2.GetTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"A\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa0\x01\n\nCreateTask\x12(.google.cloud.tasks.v2.CreateTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"K\x82\xd3\xe4\x93\x02\x37"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x91\x01\n\nDeleteTask\x12(.google.cloud.tasks.v2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02\x34*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\x97\x01\n\x07RunTask\x12%.google.cloud.tasks.v2.RunTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"H\x82\xd3\xe4\x93\x02;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBr\n\x19\x63om.google.cloud.tasks.v2B\x0f\x43loudTasksProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\xa2\x02\x05TASKSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTQUEUESREQUEST = _descriptor.Descriptor(
+    name="ListQueuesRequest",
+    full_name="google.cloud.tasks.v2.ListQueuesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2.ListQueuesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A#\022!locations.googleapis.com/Location"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.tasks.v2.ListQueuesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.tasks.v2.ListQueuesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.tasks.v2.ListQueuesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=391,
+    serialized_end=524,
+)
+
+
+_LISTQUEUESRESPONSE = _descriptor.Descriptor(
+    name="ListQueuesResponse",
+    full_name="google.cloud.tasks.v2.ListQueuesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queues",
+            full_name="google.cloud.tasks.v2.ListQueuesResponse.queues",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.tasks.v2.ListQueuesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=526,
+    serialized_end=617,
+)
+
+
+_GETQUEUEREQUEST = _descriptor.Descriptor(
+    name="GetQueueRequest",
+    full_name="google.cloud.tasks.v2.GetQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.GetQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=619,
+    serialized_end=691,
+)
+
+
+_CREATEQUEUEREQUEST = _descriptor.Descriptor(
+    name="CreateQueueRequest",
+    full_name="google.cloud.tasks.v2.CreateQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2.CreateQueueRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A#\022!locations.googleapis.com/Location"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="queue",
+            full_name="google.cloud.tasks.v2.CreateQueueRequest.queue",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=694,
+    serialized_end=823,
+)
+
+
+_UPDATEQUEUEREQUEST = _descriptor.Descriptor(
+    name="UpdateQueueRequest",
+    full_name="google.cloud.tasks.v2.UpdateQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queue",
+            full_name="google.cloud.tasks.v2.UpdateQueueRequest.queue",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.tasks.v2.UpdateQueueRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=825,
+    serialized_end=944,
+)
+
+
+_DELETEQUEUEREQUEST = _descriptor.Descriptor(
+    name="DeleteQueueRequest",
+    full_name="google.cloud.tasks.v2.DeleteQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.DeleteQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=946,
+    serialized_end=1021,
+)
+
+
+_PURGEQUEUEREQUEST = _descriptor.Descriptor(
+    name="PurgeQueueRequest",
+    full_name="google.cloud.tasks.v2.PurgeQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.PurgeQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1023,
+    serialized_end=1097,
+)
+
+
+_PAUSEQUEUEREQUEST = _descriptor.Descriptor(
+    name="PauseQueueRequest",
+    full_name="google.cloud.tasks.v2.PauseQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.PauseQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1099,
+    serialized_end=1173,
+)
+
+
+_RESUMEQUEUEREQUEST = _descriptor.Descriptor(
+    name="ResumeQueueRequest",
+    full_name="google.cloud.tasks.v2.ResumeQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.ResumeQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1175,
+    serialized_end=1250,
+)
+
+
+_LISTTASKSREQUEST = _descriptor.Descriptor(
+    name="ListTasksRequest",
+    full_name="google.cloud.tasks.v2.ListTasksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2.ListTasksRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2.ListTasksRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.tasks.v2.ListTasksRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.tasks.v2.ListTasksRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1253,
+    serialized_end=1424,
+)
+
+
+_LISTTASKSRESPONSE = _descriptor.Descriptor(
+    name="ListTasksResponse",
+    full_name="google.cloud.tasks.v2.ListTasksResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tasks",
+            full_name="google.cloud.tasks.v2.ListTasksResponse.tasks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.tasks.v2.ListTasksResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1426,
+    serialized_end=1514,
+)
+
+
+_GETTASKREQUEST = _descriptor.Descriptor(
+    name="GetTaskRequest",
+    full_name="google.cloud.tasks.v2.GetTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.GetTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2.GetTaskRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1516,
+    serialized_end=1643,
+)
+
+
+_CREATETASKREQUEST = _descriptor.Descriptor(
+    name="CreateTaskRequest",
+    full_name="google.cloud.tasks.v2.CreateTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2.CreateTaskRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="task",
+            full_name="google.cloud.tasks.v2.CreateTaskRequest.task",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2.CreateTaskRequest.response_view",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1646,
+    serialized_end=1827,
+)
+
+
+_DELETETASKREQUEST = _descriptor.Descriptor(
+    name="DeleteTaskRequest",
+    full_name="google.cloud.tasks.v2.DeleteTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.DeleteTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1829,
+    serialized_end=1902,
+)
+
+
+_RUNTASKREQUEST = _descriptor.Descriptor(
+    name="RunTaskRequest",
+    full_name="google.cloud.tasks.v2.RunTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.RunTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2.RunTaskRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1904,
+    serialized_end=2031,
+)
+
+_LISTQUEUESRESPONSE.fields_by_name[
+    "queues"
+].message_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE
+_CREATEQUEUEREQUEST.fields_by_name[
+    "queue"
+].message_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE
+_UPDATEQUEUEREQUEST.fields_by_name[
+    "queue"
+].message_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE
+_UPDATEQUEUEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTASKSREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK_VIEW
+_LISTTASKSRESPONSE.fields_by_name[
+    "tasks"
+].message_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK
+_GETTASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK_VIEW
+_CREATETASKREQUEST.fields_by_name[
+    "task"
+].message_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK
+_CREATETASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK_VIEW
+_RUNTASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK_VIEW
+DESCRIPTOR.message_types_by_name["ListQueuesRequest"] = _LISTQUEUESREQUEST
+DESCRIPTOR.message_types_by_name["ListQueuesResponse"] = _LISTQUEUESRESPONSE
+DESCRIPTOR.message_types_by_name["GetQueueRequest"] = _GETQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["CreateQueueRequest"] = _CREATEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateQueueRequest"] = _UPDATEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteQueueRequest"] = _DELETEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["PurgeQueueRequest"] = _PURGEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["PauseQueueRequest"] = _PAUSEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["ResumeQueueRequest"] = _RESUMEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["ListTasksRequest"] = _LISTTASKSREQUEST
+DESCRIPTOR.message_types_by_name["ListTasksResponse"] = _LISTTASKSRESPONSE
+DESCRIPTOR.message_types_by_name["GetTaskRequest"] = _GETTASKREQUEST
+DESCRIPTOR.message_types_by_name["CreateTaskRequest"] = _CREATETASKREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTaskRequest"] = _DELETETASKREQUEST
+DESCRIPTOR.message_types_by_name["RunTaskRequest"] = _RUNTASKREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListQueuesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListQueuesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTQUEUESREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues].
+  
+  
+  Attributes:
+      parent:
+          Required. The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``
+      filter:
+          ``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. For example: ``<=,
+          <, >=, >, !=, =, :``. The filter syntax is the same as
+          described in `Stackdriver's Advanced Logs Filters <https://clo
+          ud.google.com/logging/docs/view/advanced_filters>`_.  Sample
+          filter "state: PAUSED".  Note that using filters might cause
+          fewer queues than the requested page\_size to be returned.
+      page_size:
+          Requested page size.  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.v2.ListQueuesRe
+          sponse.next\_page\_token] in the response to determine if more
+          queues exist.
+      page_token:
+          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 [ne
+          xt\_page\_token][google.cloud.tasks.v2.ListQueuesResponse.next
+          \_page\_token] returned from the previous call to
+          [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues]
+          method. It is an error to switch the value of the
+          [filter][google.cloud.tasks.v2.ListQueuesRequest.filter] while
+          iterating through pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListQueuesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListQueuesRequest)
+
+ListQueuesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListQueuesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTQUEUESRESPONSE,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Response message for
+  [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues].
+  
+  
+  Attributes:
+      queues:
+          The list of queues.
+      next_page_token:
+          A token to retrieve next page of results.  To return the next
+          page of results, call
+          [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues] with
+          this value as the [page\_token][google.cloud.tasks.v2.ListQueu
+          esRequest.page\_token].  If the next\_page\_token is empty,
+          there are no more results.  The page token is valid for only 2
+          hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListQueuesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListQueuesResponse)
+
+GetQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "GetQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the queue. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.GetQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetQueueRequest)
+
+CreateQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue].
+  
+  
+  Attributes:
+      parent:
+          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.Locati
+          ons.ListLocations].
+      queue:
+          Required. The queue to create.  [Queue's
+          name][google.cloud.tasks.v2.Queue.name] cannot be the same as
+          an existing queue.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.CreateQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateQueueRequest)
+
+UpdateQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue].
+  
+  
+  Attributes:
+      queue:
+          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.
+      update_mask:
+          A mask used to specify which fields of the queue are being
+          updated.  If empty, then all fields will be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.UpdateQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateQueueRequest)
+
+DeleteQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.DeleteQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteQueueRequest)
+
+PurgeQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "PurgeQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PURGEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.PurgeQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(PurgeQueueRequest)
+
+PauseQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "PauseQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAUSEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.PauseQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(PauseQueueRequest)
+
+ResumeQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "ResumeQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUMEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ResumeQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(ResumeQueueRequest)
+
+ListTasksRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTasksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTASKSREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for listing tasks using
+  [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2.Task] resource.
+      page_size:
+          Maximum page size.  Fewer tasks than requested might be
+          returned, even if more tasks exist; use [next\_page\_token][go
+          ogle.cloud.tasks.v2.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.
+      page_token:
+          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 [ne
+          xt\_page\_token][google.cloud.tasks.v2.ListTasksResponse.next\
+          _page\_token] returned from the previous call to
+          [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks]
+          method.  The page token is valid for only 2 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListTasksRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTasksRequest)
+
+ListTasksResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTasksResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTASKSRESPONSE,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Response message for listing tasks using
+  [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks].
+  
+  
+  Attributes:
+      tasks:
+          The list of tasks.
+      next_page_token:
+          A token to retrieve next page of results.  To return the next
+          page of results, call
+          [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks] with
+          this value as the [page\_token][google.cloud.tasks.v2.ListTask
+          sRequest.page\_token].  If the next\_page\_token is empty,
+          there are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListTasksResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTasksResponse)
+
+GetTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTASKREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for getting a task using
+  [GetTask][google.cloud.tasks.v2.CloudTasks.GetTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2.Task] resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.GetTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTaskRequest)
+
+CreateTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETASKREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+          The queue must already exist.
+      task:
+          Required. The task to add.  Task names have the following
+          format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUE
+          UE_ID/tasks/TASK_ID``. The user can optionally specify a task
+          [name][google.cloud.tasks.v2.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.v2.Task.name].  If
+          [schedule\_time][google.cloud.tasks.v2.Task.schedule\_time] is
+          not set or is in the past then Cloud Tasks will set it to the
+          current time.  Task De-duplication:  Explicitly specifying a
+          task ID enables task de-duplication. If a task's ID is
+          identical to that of an existing task or a task that was
+          deleted or executed recently then the call will fail with
+          [ALREADY\_EXISTS][google.rpc.Code.ALREADY\_EXISTS]. If the
+          task's queue was created using Cloud Tasks, then another task
+          with the same name can't be created for ~1hour after the
+          original task was deleted or executed. If the task's queue was
+          created using queue.yaml or queue.xml, then another task with
+          the same name can't be created for ~9days after the original
+          task was deleted or executed.  Because there is an extra
+          lookup cost to identify duplicate task names, these
+          [CreateTask][google.cloud.tasks.v2.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.
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2.Task] resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.CreateTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTaskRequest)
+
+DeleteTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETASKREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for deleting a task using
+  [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.DeleteTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTaskRequest)
+
+RunTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "RunTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNTASKREQUEST,
+        __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2",
+        __doc__="""Request message for forcing a task to run now using
+  [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2.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.v2.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2.Task] resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.RunTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunTaskRequest)
+
+
+DESCRIPTOR._options = None
+_LISTQUEUESREQUEST.fields_by_name["parent"]._options = None
+_GETQUEUEREQUEST.fields_by_name["name"]._options = None
+_CREATEQUEUEREQUEST.fields_by_name["parent"]._options = None
+_CREATEQUEUEREQUEST.fields_by_name["queue"]._options = None
+_UPDATEQUEUEREQUEST.fields_by_name["queue"]._options = None
+_DELETEQUEUEREQUEST.fields_by_name["name"]._options = None
+_PURGEQUEUEREQUEST.fields_by_name["name"]._options = None
+_PAUSEQUEUEREQUEST.fields_by_name["name"]._options = None
+_RESUMEQUEUEREQUEST.fields_by_name["name"]._options = None
+_LISTTASKSREQUEST.fields_by_name["parent"]._options = None
+_GETTASKREQUEST.fields_by_name["name"]._options = None
+_CREATETASKREQUEST.fields_by_name["parent"]._options = None
+_CREATETASKREQUEST.fields_by_name["task"]._options = None
+_DELETETASKREQUEST.fields_by_name["name"]._options = None
+_RUNTASKREQUEST.fields_by_name["name"]._options = None
+
+_CLOUDTASKS = _descriptor.ServiceDescriptor(
+    name="CloudTasks",
+    full_name="google.cloud.tasks.v2.CloudTasks",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=2034,
+    serialized_end=4687,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListQueues",
+            full_name="google.cloud.tasks.v2.CloudTasks.ListQueues",
+            index=0,
+            containing_service=None,
+            input_type=_LISTQUEUESREQUEST,
+            output_type=_LISTQUEUESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v2/{parent=projects/*/locations/*}/queues\332A\006parent"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.GetQueue",
+            index=1,
+            containing_service=None,
+            input_type=_GETQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                "\202\323\344\223\002,\022*/v2/{name=projects/*/locations/*/queues/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.CreateQueue",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\0023"*/v2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.UpdateQueue",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                "\202\323\344\223\002920/v2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.DeleteQueue",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEQUEUEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002,**/v2/{name=projects/*/locations/*/queues/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PurgeQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.PurgeQueue",
+            index=5,
+            containing_service=None,
+            input_type=_PURGEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PauseQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.PauseQueue",
+            index=6,
+            containing_service=None,
+            input_type=_PAUSEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ResumeQueue",
+            full_name="google.cloud.tasks.v2.CloudTasks.ResumeQueue",
+            index=7,
+            containing_service=None,
+            input_type=_RESUMEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\0026"1/v2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.tasks.v2.CloudTasks.GetIamPolicy",
+            index=8,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.tasks.v2.CloudTasks.SetIamPolicy",
+            index=9,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.tasks.v2.CloudTasks.TestIamPermissions",
+            index=10,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002F"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTasks",
+            full_name="google.cloud.tasks.v2.CloudTasks.ListTasks",
+            index=11,
+            containing_service=None,
+            input_type=_LISTTASKSREQUEST,
+            output_type=_LISTTASKSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTask",
+            full_name="google.cloud.tasks.v2.CloudTasks.GetTask",
+            index=12,
+            containing_service=None,
+            input_type=_GETTASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTask",
+            full_name="google.cloud.tasks.v2.CloudTasks.CreateTask",
+            index=13,
+            containing_service=None,
+            input_type=_CREATETASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTask",
+            full_name="google.cloud.tasks.v2.CloudTasks.DeleteTask",
+            index=14,
+            containing_service=None,
+            input_type=_DELETETASKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0024*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunTask",
+            full_name="google.cloud.tasks.v2.CloudTasks.RunTask",
+            index=15,
+            containing_service=None,
+            input_type=_RUNTASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDTASKS)
+
+DESCRIPTOR.services_by_name["CloudTasks"] = _CLOUDTASKS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py b/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py
new file mode 100644
index 000000000000..0815f6605f4d
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py
@@ -0,0 +1,440 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.tasks_v2.proto import (
+    cloudtasks_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2,
+)
+from google.cloud.tasks_v2.proto import (
+    queue_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2,
+)
+from google.cloud.tasks_v2.proto import (
+    task_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class CloudTasksStub(object):
+    """Cloud Tasks allows developers to manage the execution of background
+  work in their applications.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListQueues = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/ListQueues",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.FromString,
+        )
+        self.GetQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/GetQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.CreateQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/CreateQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.UpdateQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/UpdateQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.DeleteQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/DeleteQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.PurgeQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/PurgeQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.PauseQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/PauseQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.ResumeQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/ResumeQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+        self.ListTasks = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/ListTasks",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.FromString,
+        )
+        self.GetTask = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/GetTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.CreateTask = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/CreateTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.DeleteTask = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/DeleteTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RunTask = channel.unary_unary(
+            "/google.cloud.tasks.v2.CloudTasks/RunTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+
+
+class CloudTasksServicer(object):
+    """Cloud Tasks allows developers to manage the execution of background
+  work in their applications.
+  """
+
+    def ListQueues(self, request, context):
+        """Lists queues.
+
+    Queues are returned in lexicographical order.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetQueue(self, request, context):
+        """Gets a queue.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateQueue(self, request, context):
+        """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.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateQueue(self, request, context):
+        """Updates a queue.
+
+    This method creates the queue if it does not exist and updates
+    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.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteQueue(self, request, context):
+        """Deletes a queue.
+
+    This command will delete the queue even if it has tasks in it.
+
+    Note: If you delete a queue, a queue with the same name can't be created
+    for 7 days.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PurgeQueue(self, request, context):
+        """Purges a queue by deleting all of its tasks.
+
+    All tasks created before this method is called are permanently deleted.
+
+    Purge operations can take up to one minute to take effect. Tasks
+    might be dispatched before the purge takes effect. A purge is irreversible.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PauseQueue(self, request, context):
+        """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.v2.CloudTasks.ResumeQueue]. Tasks can still be added
+    when the queue is paused. A queue is paused if its
+    [state][google.cloud.tasks.v2.Queue.state] is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ResumeQueue(self, request, context):
+        """Resume a queue.
+
+    This method resumes a queue after it has been
+    [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED] or
+    [DISABLED][google.cloud.tasks.v2.Queue.State.DISABLED]. The state of a queue is stored
+    in the queue's [state][google.cloud.tasks.v2.Queue.state]; after calling this method it
+    will be set to [RUNNING][google.cloud.tasks.v2.Queue.State.RUNNING].
+
+    WARNING: Resuming many high-QPS queues at the same time can
+    lead to target overloading. If you are resuming high-QPS
+    queues, follow the 500/50/5 pattern described in
+    [Managing Cloud Tasks Scaling
+    Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for a [Queue][google.cloud.tasks.v2.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`
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy for a [Queue][google.cloud.tasks.v2.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.
+
+    Authorization requires the following
+    [Google IAM](https://cloud.google.com/iam) permission on the specified
+    resource parent:
+
+    * `cloudtasks.queues.setIamPolicy`
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2.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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTasks(self, request, context):
+        """Lists the tasks in a queue.
+
+    By default, only the [BASIC][google.cloud.tasks.v2.Task.View.BASIC] view is retrieved
+    due to performance considerations;
+    [response_view][google.cloud.tasks.v2.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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTask(self, request, context):
+        """Gets a task.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTask(self, request, context):
+        """Creates a task and adds it to a queue.
+
+    Tasks cannot be updated after creation; there is no UpdateTask command.
+
+    * The maximum task size is 100KB.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTask(self, request, context):
+        """Deletes a task.
+
+    A task can be deleted if it is scheduled or dispatched. A task
+    cannot be deleted if it has executed successfully or permanently
+    failed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunTask(self, request, context):
+        """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.v2.RateLimits] or
+    is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED].
+
+    This command is meant to be used for manual debugging. For
+    example, [RunTask][google.cloud.tasks.v2.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][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.v2.Task.schedule_time] will be reset to the time that
+    [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] was called plus the retry delay specified
+    in the queue's [RetryConfig][google.cloud.tasks.v2.RetryConfig].
+
+    [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] returns
+    [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
+    task that has already succeeded or permanently failed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudTasksServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListQueues": grpc.unary_unary_rpc_method_handler(
+            servicer.ListQueues,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.SerializeToString,
+        ),
+        "GetQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.GetQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "CreateQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "UpdateQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "DeleteQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PurgeQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.PurgeQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "PauseQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.PauseQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "ResumeQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.ResumeQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "ListTasks": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTasks,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.SerializeToString,
+        ),
+        "GetTask": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "CreateTask": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "DeleteTask": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RunTask": grpc.unary_unary_rpc_method_handler(
+            servicer.RunTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.tasks.v2.CloudTasks", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/tasks/google/cloud/tasks_v2/proto/queue.proto b/tasks/google/cloud/tasks_v2/proto/queue.proto
new file mode 100644
index 000000000000..ce6a90244d7b
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/queue.proto
@@ -0,0 +1,345 @@
+// 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.tasks.v2;
+
+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;
+option java_outer_classname = "QueueProto";
+option java_package = "com.google.cloud.tasks.v2";
+
+// A queue is a container of related tasks. Queues are configured to manage
+// 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.
+    STATE_UNSPECIFIED = 0;
+
+    // The queue is running. Tasks can be dispatched.
+    //
+    // If the queue was created using Cloud Tasks and the queue has
+    // had no activity (method calls or task dispatches) for 30 days,
+    // the queue may take a few minutes to re-activate. Some method
+    // calls may return [NOT_FOUND][google.rpc.Code.NOT_FOUND] and
+    // tasks may not be dispatched for a few minutes until the queue
+    // has been re-activated.
+    RUNNING = 1;
+
+    // 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.
+    PAUSED = 2;
+
+    // The queue is disabled.
+    //
+    // A queue becomes `DISABLED` when
+    // [queue.yaml](https://cloud.google.com/appengine/docs/python/config/queueref)
+    // or
+    // [queue.xml](https://cloud.google.com/appengine/docs/standard/java/config/queueref)
+    // is uploaded which does not contain the queue. You cannot directly disable
+    // a queue.
+    //
+    // When a queue is disabled, tasks can still be added to a queue
+    // but the tasks are not dispatched.
+    //
+    // To permanently delete this queue and all of its tasks, call
+    // [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue].
+    DISABLED = 3;
+  }
+
+  // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue],
+  // after which it becomes output only.
+  //
+  // The queue name.
+  //
+  // The queue name must have the following format:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the queue's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+  //   hyphens (-). The maximum length is 100 characters.
+  string name = 1;
+
+  // Overrides for
+  // [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.
+  //
+  // 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
+  // setting is for the
+  // [task-level app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing].
+  AppEngineRouting app_engine_routing_override = 2;
+
+  // Rate limits for task dispatches.
+  //
+  // [rate_limits][google.cloud.tasks.v2.Queue.rate_limits] and [retry_config][google.cloud.tasks.v2.Queue.retry_config] are
+  // related because they both control task attempts. However they control task
+  // attempts in different ways:
+  //
+  // * [rate_limits][google.cloud.tasks.v2.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.v2.Queue.retry_config] controls what happens to
+  //   particular a task after its first attempt fails. That is,
+  //   [retry_config][google.cloud.tasks.v2.Queue.retry_config] controls task retries (the
+  //   second attempt, third attempt, etc).
+  //
+  // The queue's actual dispatch rate is the result of:
+  //
+  // * Number of tasks in the queue
+  // * User-specified throttling: [rate_limits][google.cloud.tasks.v2.Queue.rate_limits],
+  //   [retry_config][google.cloud.tasks.v2.Queue.retry_config], and the
+  //   [queue's state][google.cloud.tasks.v2.Queue.state].
+  // * System throttling due to `429` (Too Many Requests) or `503` (Service
+  //   Unavailable) responses from the worker, high error rates, or to smooth
+  //   sudden large traffic spikes.
+  RateLimits rate_limits = 3;
+
+  // Settings that determine the retry behavior.
+  //
+  // * For tasks created using Cloud Tasks: the queue-level retry settings
+  //   apply to all tasks in the queue that were created using Cloud Tasks.
+  //   Retry settings cannot be set on individual tasks.
+  // * For tasks created using the App Engine SDK: the queue-level retry
+  //   settings apply to all tasks in the queue which do not have retry settings
+  //   explicitly set on the task and were created by the App Engine SDK. See
+  //   [App Engine
+  //   documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
+  RetryConfig retry_config = 4;
+
+  // Output only. The state of the queue.
+  //
+  // `state` can only be changed by called
+  // [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue],
+  // [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue], or uploading
+  // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+  // [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue] cannot be used to change `state`.
+  State state = 5;
+
+  // Output only. The last time this queue was purged.
+  //
+  // All tasks that were [created][google.cloud.tasks.v2.Task.create_time] before this time
+  // were purged.
+  //
+  // A queue can be purged using [PurgeQueue][google.cloud.tasks.v2.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
+  // time will be unset if the queue has never been purged.
+  google.protobuf.Timestamp purge_time = 6;
+}
+
+// Rate limits.
+//
+// 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.v2.CloudTasks.RunTask], will run a task
+// even if the queue has reached its [RateLimits][google.cloud.tasks.v2.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.
+  //
+  // * The maximum allowed value is 500.
+  //
+  //
+  // This field has the same meaning as
+  // [rate in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
+  double max_dispatches_per_second = 1;
+
+  // Output only. The max burst size.
+  //
+  // Max burst size limits how fast tasks in queue are processed when
+  // many tasks are in the queue and the rate is high. This field
+  // allows the queue to have a high rate so processing starts shortly
+  // after a task is enqueued, but still limits resource usage when
+  // many tasks are enqueued in a short period of time.
+  //
+  // The [token bucket](https://wikipedia.org/wiki/Token_Bucket)
+  // algorithm is used to control the rate of task dispatches. Each
+  // queue has a token bucket that holds tokens, up to the maximum
+  // specified by `max_burst_size`. Each time a task is dispatched, a
+  // token is removed from the bucket. Tasks will be dispatched until
+  // the queue's bucket runs out of tokens. The bucket will be
+  // continuously refilled with new tokens based on
+  // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_second].
+  //
+  // Cloud Tasks will pick the value of `max_burst_size` based on the
+  // value of
+  // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_second].
+  //
+  // 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
+  // [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue] is called on a queue
+  // created by `queue.yaml/xml`, `max_burst_size` will be reset based
+  // on the value of
+  // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_second],
+  // regardless of whether
+  // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_second]
+  // is updated.
+  //
+  int32 max_burst_size = 2;
+
+  // The maximum number of concurrent tasks that Cloud Tasks allows
+  // to be dispatched for this queue. After this threshold has been
+  // reached, Cloud Tasks stops dispatching tasks until the number of
+  // concurrent requests decreases.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // The maximum allowed value is 5,000.
+  //
+  //
+  // This field has the same meaning as
+  // [max_concurrent_requests in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#max_concurrent_requests).
+  int32 max_concurrent_dispatches = 3;
+}
+
+// Retry config.
+//
+// These settings determine when a failed task attempt is retried.
+message RetryConfig {
+  // Number of attempts per task.
+  //
+  // Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+  // first attempt fails, then there will be `max_attempts - 1` retries). Must
+  // be >= -1.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  // -1 indicates unlimited attempts.
+  //
+  // This field has the same meaning as
+  // [task_retry_limit in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  int32 max_attempts = 1;
+
+  // 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.v2.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.
+  //
+  //
+  // `max_retry_duration` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [task_age_limit in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration max_retry_duration = 2;
+
+  // A task will be [scheduled][google.cloud.tasks.v2.Task.schedule_time] for retry between
+  // [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff] and
+  // [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] duration after it fails,
+  // if the queue's [RetryConfig][google.cloud.tasks.v2.RetryConfig] specifies that the task should be
+  // retried.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // `min_backoff` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [min_backoff_seconds in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration min_backoff = 3;
+
+  // A task will be [scheduled][google.cloud.tasks.v2.Task.schedule_time] for retry between
+  // [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff] and
+  // [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] duration after it fails,
+  // if the queue's [RetryConfig][google.cloud.tasks.v2.RetryConfig] specifies that the task should be
+  // retried.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // `max_backoff` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [max_backoff_seconds in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration max_backoff = 4;
+
+  // The time between retries will double `max_doublings` times.
+  //
+  // A task's retry interval starts at
+  // [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff], then doubles
+  // `max_doublings` times, then increases linearly, and finally
+  // retries retries at intervals of
+  // [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] up to
+  // [max_attempts][google.cloud.tasks.v2.RetryConfig.max_attempts] times.
+  //
+  // For example, if [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff] is 10s,
+  // [max_backoff][google.cloud.tasks.v2.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.v2.RetryConfig.max_backoff] until the
+  // task has been attempted [max_attempts][google.cloud.tasks.v2.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 has the same meaning as
+  // [max_doublings in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  int32 max_doublings = 5;
+}
diff --git a/tasks/google/cloud/tasks_v2/proto/queue_pb2.py b/tasks/google/cloud/tasks_v2/proto/queue_pb2.py
new file mode 100644
index 000000000000..e7ae7d7e2b16
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/queue_pb2.py
@@ -0,0 +1,689 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2/proto/queue.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2.proto import (
+    target_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2/proto/queue.proto",
+    package="google.cloud.tasks.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.tasks.v2B\nQueueProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks"
+    ),
+    serialized_pb=_b(
+        '\n\'google/cloud/tasks_v2/proto/queue.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xdd\x03\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x1b\x61pp_engine_routing_override\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x36\n\x0brate_limits\x18\x03 \x01(\x0b\x32!.google.cloud.tasks.v2.RateLimits\x12\x38\n\x0cretry_config\x18\x04 \x01(\x0b\x32".google.cloud.tasks.v2.RetryConfig\x12\x31\n\x05state\x18\x05 \x01(\x0e\x32".google.cloud.tasks.v2.Queue.State\x12.\n\npurge_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05\x42\x65\n\x19\x63om.google.cloud.tasks.v2B\nQueueProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_QUEUE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.tasks.v2.Queue.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=545,
+    serialized_end=614,
+)
+_sym_db.RegisterEnumDescriptor(_QUEUE_STATE)
+
+
+_QUEUE = _descriptor.Descriptor(
+    name="Queue",
+    full_name="google.cloud.tasks.v2.Queue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.Queue.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing_override",
+            full_name="google.cloud.tasks.v2.Queue.app_engine_routing_override",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rate_limits",
+            full_name="google.cloud.tasks.v2.Queue.rate_limits",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="retry_config",
+            full_name="google.cloud.tasks.v2.Queue.retry_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.tasks.v2.Queue.state",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="purge_time",
+            full_name="google.cloud.tasks.v2.Queue.purge_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_QUEUE_STATE],
+    serialized_options=_b(
+        "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}"
+    ),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=231,
+    serialized_end=708,
+)
+
+
+_RATELIMITS = _descriptor.Descriptor(
+    name="RateLimits",
+    full_name="google.cloud.tasks.v2.RateLimits",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_dispatches_per_second",
+            full_name="google.cloud.tasks.v2.RateLimits.max_dispatches_per_second",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_burst_size",
+            full_name="google.cloud.tasks.v2.RateLimits.max_burst_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_concurrent_dispatches",
+            full_name="google.cloud.tasks.v2.RateLimits.max_concurrent_dispatches",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=710,
+    serialized_end=816,
+)
+
+
+_RETRYCONFIG = _descriptor.Descriptor(
+    name="RetryConfig",
+    full_name="google.cloud.tasks.v2.RetryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_attempts",
+            full_name="google.cloud.tasks.v2.RetryConfig.max_attempts",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_retry_duration",
+            full_name="google.cloud.tasks.v2.RetryConfig.max_retry_duration",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_backoff",
+            full_name="google.cloud.tasks.v2.RetryConfig.min_backoff",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_backoff",
+            full_name="google.cloud.tasks.v2.RetryConfig.max_backoff",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_doublings",
+            full_name="google.cloud.tasks.v2.RetryConfig.max_doublings",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=819,
+    serialized_end=1028,
+)
+
+_QUEUE.fields_by_name[
+    "app_engine_routing_override"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2._APPENGINEROUTING
+)
+_QUEUE.fields_by_name["rate_limits"].message_type = _RATELIMITS
+_QUEUE.fields_by_name["retry_config"].message_type = _RETRYCONFIG
+_QUEUE.fields_by_name["state"].enum_type = _QUEUE_STATE
+_QUEUE.fields_by_name[
+    "purge_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_QUEUE_STATE.containing_type = _QUEUE
+_RETRYCONFIG.fields_by_name[
+    "max_retry_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "min_backoff"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "max_backoff"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["Queue"] = _QUEUE
+DESCRIPTOR.message_types_by_name["RateLimits"] = _RATELIMITS
+DESCRIPTOR.message_types_by_name["RetryConfig"] = _RETRYCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Queue = _reflection.GeneratedProtocolMessageType(
+    "Queue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUEUE,
+        __module__="google.cloud.tasks_v2.proto.queue_pb2",
+        __doc__="""A queue is a container of related tasks. Queues are configured to manage
+  how those tasks are dispatched. Configurable properties include rate
+  limits, retry options, queue types, and others.
+  
+  
+  Attributes:
+      name:
+          Caller-specified and required in
+          [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue],
+          after which it becomes output only.  The queue name.  The
+          queue name must have the following format:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+          -  ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`_ -  ``LOCATION_ID``
+          is the canonical ID for the queue's location. The    list of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``QUEUE_ID`` can
+          contain letters ([A-Za-z]), numbers ([0-9]), or    hyphens
+          (-). The maximum length is 100 characters.
+      app_engine_routing_override:
+          Overrides for [task-level app\_engine\_routing][google.cloud.t
+          asks.v2.AppEngineHttpRequest.app\_engine\_routing]. These
+          settings apply only to [App Engine
+          tasks][google.cloud.tasks.v2.AppEngineHttpRequest] in this
+          queue.  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 setting is for the [task-level app\_
+          engine\_routing][google.cloud.tasks.v2.AppEngineHttpRequest.ap
+          p\_engine\_routing].
+      rate_limits:
+          Rate limits for task dispatches.
+          [rate\_limits][google.cloud.tasks.v2.Queue.rate\_limits] and
+          [retry\_config][google.cloud.tasks.v2.Queue.retry\_config] are
+          related because they both control task attempts. However they
+          control task attempts in different ways:  -
+          [rate\_limits][google.cloud.tasks.v2.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.v2.Queue.retry\_config]
+          controls    what happens to particular a task after its first
+          attempt fails. That    is,
+          [retry\_config][google.cloud.tasks.v2.Queue.retry\_config]
+          controls task retries (the second attempt, third attempt,
+          etc).  The queue's actual dispatch rate is the result of:  -
+          Number of tasks in the queue -  User-specified throttling:
+          [rate\_limits][google.cloud.tasks.v2.Queue.rate\_limits],
+          [retry\_config][google.cloud.tasks.v2.Queue.retry\_config],
+          and the    [queue's state][google.cloud.tasks.v2.Queue.state].
+          -  System throttling due to ``429`` (Too Many Requests) or
+          ``503``    (Service Unavailable) responses from the worker,
+          high error rates, or    to smooth sudden large traffic spikes.
+      retry_config:
+          Settings that determine the retry behavior.  -  For tasks
+          created using Cloud Tasks: the queue-level retry settings
+          apply to all tasks in the queue that were created using Cloud
+          Tasks.    Retry settings cannot be set on individual tasks. -
+          For tasks created using the App Engine SDK: the queue-level
+          retry    settings apply to all tasks in the queue which do not
+          have retry    settings explicitly set on the task and were
+          created by the App    Engine SDK. See `App Engine
+          documentation <https://cloud.google.com/appengine/docs/standar
+          d/python/taskqueue/push/retrying-tasks>`_.
+      state:
+          Output only. The state of the queue.  ``state`` can only be
+          changed by called
+          [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue],
+          [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue],
+          or uploading `queue.yaml/xml <https://cloud.google.com/appengi
+          ne/docs/python/config/queueref>`_.
+          [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue]
+          cannot be used to change ``state``.
+      purge_time:
+          Output only. The last time this queue was purged.  All tasks
+          that were [created][google.cloud.tasks.v2.Task.create\_time]
+          before this time were purged.  A queue can be purged using
+          [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue], the
+          `App Engine Task Queue SDK, or the Cloud Console <https://clou
+          d.google.com/appengine/docs/standard/python/taskqueue/push/del
+          eting-tasks-and-queues#purging_all_tasks_from_a_queue>`_.
+          Purge time will be truncated to the nearest microsecond. Purge
+          time will be unset if the queue has never been purged.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.Queue)
+    ),
+)
+_sym_db.RegisterMessage(Queue)
+
+RateLimits = _reflection.GeneratedProtocolMessageType(
+    "RateLimits",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RATELIMITS,
+        __module__="google.cloud.tasks_v2.proto.queue_pb2",
+        __doc__="""Rate limits.
+  
+  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.v2.CloudTasks.RunTask], will run a task
+  even if the queue has reached its
+  [RateLimits][google.cloud.tasks.v2.RateLimits].
+  
+  
+  Attributes:
+      max_dispatches_per_second:
+          The maximum rate at which tasks are dispatched from this
+          queue.  If unspecified when the queue is created, Cloud Tasks
+          will pick the default.  -  The maximum allowed value is 500.
+          This field has the same meaning as `rate in queue.yaml/xml <ht
+          tps://cloud.google.com/appengine/docs/standard/python/config/q
+          ueueref#rate>`_.
+      max_burst_size:
+          Output only. The max burst size.  Max burst size limits how
+          fast tasks in queue are processed when many tasks are in the
+          queue and the rate is high. This field allows the queue to
+          have a high rate so processing starts shortly after a task is
+          enqueued, but still limits resource usage when many tasks are
+          enqueued in a short period of time.  The `token bucket
+          <https://wikipedia.org/wiki/Token_Bucket>`_ algorithm is used
+          to control the rate of task dispatches. Each queue has a token
+          bucket that holds tokens, up to the maximum specified by
+          ``max_burst_size``. Each time a task is dispatched, a token is
+          removed from the bucket. Tasks will be dispatched until the
+          queue's bucket runs out of tokens. The bucket will be
+          continuously refilled with new tokens based on [max\_dispatche
+          s\_per\_second][google.cloud.tasks.v2.RateLimits.max\_dispatch
+          es\_per\_second].  Cloud Tasks will pick the value of
+          ``max_burst_size`` based on the value of [max\_dispatches\_per
+          \_second][google.cloud.tasks.v2.RateLimits.max\_dispatches\_pe
+          r\_second].  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/standar
+          d/python/config/queueref#bucket_size>`_. Since
+          ``max_burst_size`` is output only, if
+          [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue] is
+          called on a queue created by ``queue.yaml/xml``,
+          ``max_burst_size`` will be reset based on the value of [max\_d
+          ispatches\_per\_second][google.cloud.tasks.v2.RateLimits.max\_
+          dispatches\_per\_second], regardless of whether [max\_dispatch
+          es\_per\_second][google.cloud.tasks.v2.RateLimits.max\_dispatc
+          hes\_per\_second] is updated.
+      max_concurrent_dispatches:
+          The maximum number of concurrent tasks that Cloud Tasks allows
+          to be dispatched for this queue. After this threshold has been
+          reached, Cloud Tasks stops dispatching tasks until the number
+          of concurrent requests decreases.  If unspecified when the
+          queue is created, Cloud Tasks will pick the default.  The
+          maximum allowed value is 5,000.  This field has the same
+          meaning as `max\_concurrent\_requests in queue.yaml/xml <https
+          ://cloud.google.com/appengine/docs/standard/python/config/queu
+          eref#max_concurrent_requests>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.RateLimits)
+    ),
+)
+_sym_db.RegisterMessage(RateLimits)
+
+RetryConfig = _reflection.GeneratedProtocolMessageType(
+    "RetryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RETRYCONFIG,
+        __module__="google.cloud.tasks_v2.proto.queue_pb2",
+        __doc__="""Retry config.
+  
+  These settings determine when a failed task attempt is retried.
+  
+  
+  Attributes:
+      max_attempts:
+          Number of attempts per task.  Cloud Tasks will attempt the
+          task ``max_attempts`` times (that is, if the first attempt
+          fails, then there will be ``max_attempts - 1`` retries). Must
+          be >= -1.  If unspecified when the queue is created, Cloud
+          Tasks will pick the default.  -1 indicates unlimited attempts.
+          This field has the same meaning as `task\_retry\_limit in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_retry_duration:
+          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.v2.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.
+          ``max_retry_duration`` will be truncated to the nearest
+          second.  This field has the same meaning as `task\_age\_limit
+          in queue.yaml/xml <https://cloud.google.com/appengine/docs/sta
+          ndard/python/config/queueref#retry_parameters>`_.
+      min_backoff:
+          A task will be
+          [scheduled][google.cloud.tasks.v2.Task.schedule\_time] for
+          retry between
+          [min\_backoff][google.cloud.tasks.v2.RetryConfig.min\_backoff]
+          and
+          [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff]
+          duration after it fails, if the queue's
+          [RetryConfig][google.cloud.tasks.v2.RetryConfig] specifies
+          that the task should be retried.  If unspecified when the
+          queue is created, Cloud Tasks will pick the default.
+          ``min_backoff`` will be truncated to the nearest second.  This
+          field has the same meaning as `min\_backoff\_seconds in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_backoff:
+          A task will be
+          [scheduled][google.cloud.tasks.v2.Task.schedule\_time] for
+          retry between
+          [min\_backoff][google.cloud.tasks.v2.RetryConfig.min\_backoff]
+          and
+          [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff]
+          duration after it fails, if the queue's
+          [RetryConfig][google.cloud.tasks.v2.RetryConfig] specifies
+          that the task should be retried.  If unspecified when the
+          queue is created, Cloud Tasks will pick the default.
+          ``max_backoff`` will be truncated to the nearest second.  This
+          field has the same meaning as `max\_backoff\_seconds in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_doublings:
+          The time between retries will double ``max_doublings`` times.
+          A task's retry interval starts at [min\_backoff][google.cloud.
+          tasks.v2.RetryConfig.min\_backoff], then doubles
+          ``max_doublings`` times, then increases linearly, and finally
+          retries retries at intervals of
+          [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff]
+          up to [max\_attempts][google.cloud.tasks.v2.RetryConfig.max\_a
+          ttempts] times.  For example, if
+          [min\_backoff][google.cloud.tasks.v2.RetryConfig.min\_backoff]
+          is 10s,
+          [max\_backoff][google.cloud.tasks.v2.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.v2.RetryConfig.max\_backoff]
+          until the task has been attempted [max\_attempts][google.cloud
+          .tasks.v2.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 has the same meaning as
+          `max\_doublings in queue.yaml/xml <https://cloud.google.com/ap
+          pengine/docs/standard/python/config/queueref#retry_parameters>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.RetryConfig)
+    ),
+)
+_sym_db.RegisterMessage(RetryConfig)
+
+
+DESCRIPTOR._options = None
+_QUEUE._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2/proto/queue_pb2_grpc.py b/tasks/google/cloud/tasks_v2/proto/queue_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/queue_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2/proto/target.proto b/tasks/google/cloud/tasks_v2/proto/target.proto
new file mode 100644
index 000000000000..acd38fedee3a
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/target.proto
@@ -0,0 +1,280 @@
+// 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.tasks.v2;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
+option java_multiple_files = true;
+option java_outer_classname = "TargetProto";
+option java_package = "com.google.cloud.tasks.v2";
+
+// App Engine HTTP request.
+//
+// The message defines the HTTP request that is sent to an App Engine app when
+// the task is dispatched.
+//
+// Using [AppEngineHttpRequest][google.cloud.tasks.v2.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:
+//
+// `https://www.googleapis.com/auth/cloud-platform`
+//
+// The task will be delivered to the App Engine app which belongs to the same
+// project as the queue. For more information, see
+// [How Requests are
+// Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+// 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.v2.AppEngineRouting] used to construct the URL that the task is
+// delivered to can be set at the queue-level or task-level:
+//
+// * 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:
+//
+// * `url =` [host][google.cloud.tasks.v2.AppEngineRouting.host] `+`
+//   [relative_uri][google.cloud.tasks.v2.AppEngineHttpRequest.relative_uri]
+//
+// 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][google.cloud.tasks.v2.Task.dispatch_deadline]. Failed
+// tasks will be retried according to the
+// [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
+// 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.
+  //
+  // The app's request handler for the task's target URL must be able to handle
+  // HTTP requests with this http_method, otherwise the task attempt will fail
+  // with error code 405 (Method Not Allowed). See
+  // [Writing a push task request
+  // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+  // and the documentation for the request handlers in the language your app is
+  // written in e.g.
+  // [Python Request
+  // Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+  HttpMethod http_method = 1;
+
+  // Task-level setting for 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.
+  //
+  // The relative URI must begin with "/" and must be a valid HTTP relative URI.
+  // It can contain a path and query string arguments.
+  // If the relative URI is empty, then the root path "/" will be used.
+  // No spaces are allowed, and the maximum length allowed is 2083 characters.
+  string relative_uri = 3;
+
+  // HTTP request headers.
+  //
+  // This map contains the header field names and values.
+  // Headers can be set when the
+  // [task is created][google.cloud.tasks.v2.CloudTasks.CreateTask].
+  // Repeated headers are not supported but a header value can contain commas.
+  //
+  // Cloud Tasks sets some headers to default values:
+  //
+  // * `User-Agent`: By default, this header is
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+  //   This header can be modified, but Cloud Tasks will append
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+  //   modified `User-Agent`.
+  //
+  // If the task has a [body][google.cloud.tasks.v2.AppEngineHttpRequest.body], Cloud
+  // Tasks sets the following headers:
+  //
+  // * `Content-Type`: By default, the `Content-Type` header is set to
+  //   `"application/octet-stream"`. The default can be overridden by explicitly
+  //   setting `Content-Type` to a particular media type when the
+  //   [task is created][google.cloud.tasks.v2.CloudTasks.CreateTask].
+  //   For example, `Content-Type` can be set to `"application/json"`.
+  // * `Content-Length`: This is computed by Cloud Tasks. This value is
+  //   output only.   It cannot be changed.
+  //
+  // The headers below cannot be set or overridden:
+  //
+  // * `Host`
+  // * `X-Google-*`
+  // * `X-AppEngine-*`
+  //
+  // 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).
+  // 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.
+  //
+  // 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.v2.Task]. For more
+  // information, see the [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask] documentation.
+  map<string, string> headers = 4;
+
+  // HTTP request body.
+  //
+  // A request body is allowed only if the HTTP method is POST or PUT. It is
+  // an error to set a body on a task with an incompatible [HttpMethod][google.cloud.tasks.v2.HttpMethod].
+  bytes body = 5;
+}
+
+// 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),
+// [Microservices Architecture on Google App
+// Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+// [App Engine Standard request
+// 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.
+  //
+  // By default, the task is sent to the service which is the default
+  // 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.v2.AppEngineRouting.host] is not parsable
+  // into [service][google.cloud.tasks.v2.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2.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.v2.AppEngineRouting.host] is not parsable, then
+  // [service][google.cloud.tasks.v2.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2.AppEngineRouting.instance] are the empty string.
+  string service = 1;
+
+  // App version.
+  //
+  // By default, the task is sent to the version which is the default
+  // 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.v2.AppEngineRouting.host] is not parsable
+  // into [service][google.cloud.tasks.v2.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2.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.v2.AppEngineRouting.host] is not parsable, then
+  // [service][google.cloud.tasks.v2.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2.AppEngineRouting.instance] are the empty string.
+  string version = 2;
+
+  // App instance.
+  //
+  // By default, the task is sent to an instance which is available when
+  // the task is attempted.
+  //
+  // Requests can only be sent to a specific instance if
+  // [manual scaling is used in App Engine
+  // Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+  // App Engine Flex does not support instances. For more information, see
+  // [App Engine Standard request
+  // 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).
+  string instance = 3;
+
+  // Output only. The host that the task is sent to.
+  //
+  // The host is constructed from the domain name of the app associated with
+  // the queue's project ID (for example <app-id>.appspot.com), and the
+  // [service][google.cloud.tasks.v2.AppEngineRouting.service], [version][google.cloud.tasks.v2.AppEngineRouting.version],
+  // and [instance][google.cloud.tasks.v2.AppEngineRouting.instance]. Tasks which were created using
+  // the App Engine SDK might have a custom domain name.
+  //
+  // For more information, see
+  // [How Requests are
+  // Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+  string host = 4;
+}
+
+// The HTTP method used to deliver the task.
+enum HttpMethod {
+  // HTTP method unspecified
+  HTTP_METHOD_UNSPECIFIED = 0;
+
+  // HTTP POST
+  POST = 1;
+
+  // HTTP GET
+  GET = 2;
+
+  // HTTP HEAD
+  HEAD = 3;
+
+  // HTTP PUT
+  PUT = 4;
+
+  // HTTP DELETE
+  DELETE = 5;
+
+  // HTTP PATCH
+  PATCH = 6;
+
+  // HTTP OPTIONS
+  OPTIONS = 7;
+}
diff --git a/tasks/google/cloud/tasks_v2/proto/target_pb2.py b/tasks/google/cloud/tasks_v2/proto/target_pb2.py
new file mode 100644
index 000000000000..0203f5333672
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/target_pb2.py
@@ -0,0 +1,611 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2/proto/target.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2/proto/target.proto",
+    package="google.cloud.tasks.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.tasks.v2B\013TargetProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks"
+    ),
+    serialized_pb=_b(
+        '\n(google/cloud/tasks_v2/proto/target.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto"\xb2\x02\n\x14\x41ppEngineHttpRequest\x12\x36\n\x0bhttp_method\x18\x01 \x01(\x0e\x32!.google.cloud.tasks.v2.HttpMethod\x12\x43\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12I\n\x07headers\x18\x04 \x03(\x0b\x32\x38.google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42\x66\n\x19\x63om.google.cloud.tasks.v2B\x0bTargetProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_HTTPMETHOD = _descriptor.EnumDescriptor(
+    name="HttpMethod",
+    full_name="google.cloud.tasks.v2.HttpMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GET", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEAD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PATCH", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OPTIONS", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=492,
+    serialized_end=607,
+)
+_sym_db.RegisterEnumDescriptor(_HTTPMETHOD)
+
+HttpMethod = enum_type_wrapper.EnumTypeWrapper(_HTTPMETHOD)
+HTTP_METHOD_UNSPECIFIED = 0
+POST = 1
+GET = 2
+HEAD = 3
+PUT = 4
+DELETE = 5
+PATCH = 6
+OPTIONS = 7
+
+
+_APPENGINEHTTPREQUEST_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=358,
+    serialized_end=404,
+)
+
+_APPENGINEHTTPREQUEST = _descriptor.Descriptor(
+    name="AppEngineHttpRequest",
+    full_name="google.cloud.tasks.v2.AppEngineHttpRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.http_method",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_uri",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.relative_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.headers",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.tasks.v2.AppEngineHttpRequest.body",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=98,
+    serialized_end=404,
+)
+
+
+_APPENGINEROUTING = _descriptor.Descriptor(
+    name="AppEngineRouting",
+    full_name="google.cloud.tasks.v2.AppEngineRouting",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.cloud.tasks.v2.AppEngineRouting.service",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.tasks.v2.AppEngineRouting.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.tasks.v2.AppEngineRouting.instance",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.tasks.v2.AppEngineRouting.host",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=406,
+    serialized_end=490,
+)
+
+_APPENGINEHTTPREQUEST_HEADERSENTRY.containing_type = _APPENGINEHTTPREQUEST
+_APPENGINEHTTPREQUEST.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_APPENGINEHTTPREQUEST.fields_by_name[
+    "app_engine_routing"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPREQUEST.fields_by_name[
+    "headers"
+].message_type = _APPENGINEHTTPREQUEST_HEADERSENTRY
+DESCRIPTOR.message_types_by_name["AppEngineHttpRequest"] = _APPENGINEHTTPREQUEST
+DESCRIPTOR.message_types_by_name["AppEngineRouting"] = _APPENGINEROUTING
+DESCRIPTOR.enum_types_by_name["HttpMethod"] = _HTTPMETHOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AppEngineHttpRequest = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpRequest",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPENGINEHTTPREQUEST_HEADERSENTRY,
+                __module__="google.cloud.tasks_v2.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_APPENGINEHTTPREQUEST,
+        __module__="google.cloud.tasks_v2.proto.target_pb2",
+        __doc__="""App Engine HTTP request.
+  
+  The message defines the HTTP request that is sent to an App Engine app
+  when the task is dispatched.
+  
+  Using [AppEngineHttpRequest][google.cloud.tasks.v2.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:
+  
+  ``https://www.googleapis.com/auth/cloud-platform``
+  
+  The task will be delivered to the App Engine app which belongs to the
+  same project as the queue. For more information, see `How Requests are
+  Routed <https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed>`_
+  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.v2.AppEngineRouting] used to
+  construct the URL that the task is delivered to can be set at the
+  queue-level or task-level:
+  
+  -  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:
+  
+  -  ``url =`` [host][google.cloud.tasks.v2.AppEngineRouting.host] ``+``
+     [relative\_uri][google.cloud.tasks.v2.AppEngineHttpRequest.relative\_uri]
+  
+  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][google.cloud.tasks.v2.Task.dispatch\_deadline]. Failed tasks
+  will be retried according to the [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 Requests) response from an
+  app handler does not cause traffic congestion control to throttle the
+  queue.
+  
+  
+  Attributes:
+      http_method:
+          The HTTP method to use for the request. The default is POST.
+          The app's request handler for the task's target URL must be
+          able to handle HTTP requests with this http\_method, otherwise
+          the task attempt will fail with error code 405 (Method Not
+          Allowed). See `Writing a push task request handler <https://cl
+          oud.google.com/appengine/docs/java/taskqueue/push/creating-
+          handlers#writing_a_push_task_request_handler>`_ and the
+          documentation for the request handlers in the language your
+          app is written in e.g. `Python Request Handler <https://cloud.
+          google.com/appengine/docs/python/tools/webapp/requesthandlercl
+          ass>`_.
+      app_engine_routing:
+          Task-level setting for 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][AppEngineHt
+          tpRequest.app\_engine\_routing].
+      relative_uri:
+          The relative URI.  The relative URI must begin with "/" and
+          must be a valid HTTP relative URI. It can contain a path and
+          query string arguments. If the relative URI is empty, then the
+          root path "/" will be used. No spaces are allowed, and the
+          maximum length allowed is 2083 characters.
+      headers:
+          HTTP request headers.  This map contains the header field
+          names and values. Headers can be set when the [task is
+          created][google.cloud.tasks.v2.CloudTasks.CreateTask].
+          Repeated headers are not supported but a header value can
+          contain commas.  Cloud Tasks sets some headers to default
+          values:  -  ``User-Agent``: By default, this header is
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"``.
+          This    header can be modified, but Cloud Tasks will append
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"`` to
+          the    modified ``User-Agent``.  If the task has a
+          [body][google.cloud.tasks.v2.AppEngineHttpRequest.body], Cloud
+          Tasks sets the following headers:  -  ``Content-Type``: By
+          default, the ``Content-Type`` header is set to
+          ``"application/octet-stream"``. The default can be overridden
+          by    explicitly setting ``Content-Type`` to a particular
+          media type when    the [task is
+          created][google.cloud.tasks.v2.CloudTasks.CreateTask].    For
+          example, ``Content-Type`` can be set to
+          ``"application/json"``. -  ``Content-Length``: This is
+          computed by Cloud Tasks. This value is    output only. It
+          cannot be changed.  The headers below cannot be set or
+          overridden:  -  ``Host`` -  ``X-Google-*`` -
+          ``X-AppEngine-*``  In addition, Cloud Tasks sets some headers
+          when the task is dispatched, such as headers containing
+          information about the task; see `request headers <https://clou
+          d.google.com/appengine/docs/python/taskqueue/push/creating-
+          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.  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.v2.Task]. For more information, see
+          the [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask]
+          documentation.
+      body:
+          HTTP request body.  A request body is allowed only if the HTTP
+          method is POST or PUT. It is an error to set a body on a task
+          with an incompatible
+          [HttpMethod][google.cloud.tasks.v2.HttpMethod].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.AppEngineHttpRequest)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpRequest)
+_sym_db.RegisterMessage(AppEngineHttpRequest.HeadersEntry)
+
+AppEngineRouting = _reflection.GeneratedProtocolMessageType(
+    "AppEngineRouting",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEROUTING,
+        __module__="google.cloud.tasks_v2.proto.target_pb2",
+        __doc__="""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>`_,
+  `Microservices Architecture on Google App
+  Engine <https://cloud.google.com/appengine/docs/python/microservices-on-app-engine>`_,
+  `App Engine Standard request
+  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``
+  
+  
+  Attributes:
+      service:
+          App service.  By default, the task is sent to the service
+          which is the default 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.v2.AppEngineRouting.host] is not
+          parsable into
+          [service][google.cloud.tasks.v2.AppEngineRouting.service],
+          [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+          [instance][google.cloud.tasks.v2.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.v2.AppEngineRouting.host] is not
+          parsable, then
+          [service][google.cloud.tasks.v2.AppEngineRouting.service],
+          [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+          [instance][google.cloud.tasks.v2.AppEngineRouting.instance]
+          are the empty string.
+      version:
+          App version.  By default, the task is sent to the version
+          which is the default 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.v2.AppEngineRouting.host] is not
+          parsable into
+          [service][google.cloud.tasks.v2.AppEngineRouting.service],
+          [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+          [instance][google.cloud.tasks.v2.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.v2.AppEngineRouting.host] is not
+          parsable, then
+          [service][google.cloud.tasks.v2.AppEngineRouting.service],
+          [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+          [instance][google.cloud.tasks.v2.AppEngineRouting.instance]
+          are the empty string.
+      instance:
+          App instance.  By default, the task is sent to an instance
+          which is available when the task is attempted.  Requests can
+          only be sent to a specific instance if `manual scaling is used
+          in App Engine Standard
+          <https://cloud.google.com/appengine/docs/python/an-overview-
+          of-app-engine?hl=en_US#scaling_types_and_instance_classes>`_.
+          App Engine Flex does not support instances. For more
+          information, see `App Engine Standard request 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>`_.
+      host:
+          Output only. The host that the task is sent to.  The host is
+          constructed from the domain name of the app associated with
+          the queue's project ID (for example .appspot.com), and the
+          [service][google.cloud.tasks.v2.AppEngineRouting.service],
+          [version][google.cloud.tasks.v2.AppEngineRouting.version], and
+          [instance][google.cloud.tasks.v2.AppEngineRouting.instance].
+          Tasks which were created using the App Engine SDK might have a
+          custom domain name.  For more information, see `How Requests
+          are Routed
+          <https://cloud.google.com/appengine/docs/standard/python/how-
+          requests-are-routed>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.AppEngineRouting)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineRouting)
+
+
+DESCRIPTOR._options = None
+_APPENGINEHTTPREQUEST_HEADERSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2/proto/target_pb2_grpc.py b/tasks/google/cloud/tasks_v2/proto/target_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/target_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2/proto/task.proto b/tasks/google/cloud/tasks_v2/proto/task.proto
new file mode 100644
index 000000000000..a555c2c19689
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/task.proto
@@ -0,0 +1,184 @@
+// 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.tasks.v2;
+
+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;
+option java_outer_classname = "TaskProto";
+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
+  // 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.
+  enum View {
+    // Unspecified. Defaults to BASIC.
+    VIEW_UNSPECIFIED = 0;
+
+    // The basic view omits fields which can be large or can contain
+    // sensitive data.
+    //
+    // This view does not include the
+    // [body in AppEngineHttpRequest][google.cloud.tasks.v2.AppEngineHttpRequest.body].
+    // Bodies 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.v2.Task.View.FULL] requires
+    // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+    // permission on the [Queue][google.cloud.tasks.v2.Queue] resource.
+    FULL = 2;
+  }
+
+  // Optionally caller-specified in [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask].
+  //
+  // The task name.
+  //
+  // The task name must have the following format:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the task's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+  //   hyphens (-). The maximum length is 100 characters.
+  // * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+  //   hyphens (-), or underscores (_). The maximum length is 500 characters.
+  string name = 1;
+
+  // Required. The message to send to the worker.
+  oneof message_type {
+    // HTTP request that is sent to the App Engine app handler.
+    //
+    // An App Engine task is a task that has [AppEngineHttpRequest][google.cloud.tasks.v2.AppEngineHttpRequest] set.
+    AppEngineHttpRequest app_engine_http_request = 2;
+  }
+
+  // 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;
+
+  // Output only. The time that the task was created.
+  //
+  // `create_time` will be truncated to the nearest second.
+  google.protobuf.Timestamp create_time = 5;
+
+  // The deadline for requests sent to the worker. If the worker does not
+  // respond by this deadline then the request is cancelled and the attempt
+  // is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+  // task according to the [RetryConfig][google.cloud.tasks.v2.RetryConfig].
+  //
+  // Note that when the request is cancelled, Cloud Tasks will stop listing for
+  // the response, but whether the worker stops processing depends on the
+  // worker. For example, if the worker is stuck, it may not react to cancelled
+  // requests.
+  //
+  // The default and maximum values depend on the type of request:
+  //
+  //
+  // * For [App Engine tasks][google.cloud.tasks.v2.AppEngineHttpRequest], 0 indicates that the
+  //   request has the default deadline. The default deadline depends on the
+  //   [scaling
+  //   type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+  //   of the service: 10 minutes for standard apps with automatic scaling, 24
+  //   hours for standard apps with manual and basic scaling, and 60 minutes for
+  //   flex apps. If the request deadline is set, it must be in the interval [15
+  //   seconds, 24 hours 15 seconds]. Regardless of the task's
+  //   `dispatch_deadline`, the app handler will not run for longer than than
+  //   the service's timeout. We recommend setting the `dispatch_deadline` to
+  //   at most a few seconds more than the app handler's timeout. For more
+  //   information see
+  //   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+  //
+  // `dispatch_deadline` will be truncated to the nearest millisecond. The
+  // deadline is an approximate deadline.
+  google.protobuf.Duration dispatch_deadline = 6;
+
+  // Output only. The number of attempts dispatched.
+  //
+  // This count includes attempts which have been dispatched but haven't
+  // received a response.
+  int32 dispatch_count = 7;
+
+  // Output only. The number of attempts which have received a response.
+  int32 response_count = 8;
+
+  // Output only. The status of the task's first attempt.
+  //
+  // Only [dispatch_time][google.cloud.tasks.v2.Attempt.dispatch_time] will be set.
+  // The other [Attempt][google.cloud.tasks.v2.Attempt] information is not retained by Cloud Tasks.
+  Attempt first_attempt = 9;
+
+  // Output only. The status of the task's last attempt.
+  Attempt last_attempt = 10;
+
+  // Output only. The view specifies which subset of the [Task][google.cloud.tasks.v2.Task] has
+  // been returned.
+  View view = 11;
+}
+
+// The status of a task attempt.
+message Attempt {
+  // Output only. The time that this attempt was scheduled.
+  //
+  // `schedule_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp schedule_time = 1;
+
+  // Output only. The time that this attempt was dispatched.
+  //
+  // `dispatch_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp dispatch_time = 2;
+
+  // Output only. The time that this attempt response was received.
+  //
+  // `response_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp response_time = 3;
+
+  // Output only. The response from the worker for this attempt.
+  //
+  // If `response_time` is unset, then the task has not been attempted or is
+  // currently running and the `response_status` field is meaningless.
+  google.rpc.Status response_status = 4;
+}
diff --git a/tasks/google/cloud/tasks_v2/proto/task_pb2.py b/tasks/google/cloud/tasks_v2/proto/task_pb2.py
new file mode 100644
index 000000000000..996e33c624ad
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/task_pb2.py
@@ -0,0 +1,552 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2/proto/task.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2.proto import (
+    target_pb2 as google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2/proto/task.proto",
+    package="google.cloud.tasks.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\031com.google.cloud.tasks.v2B\tTaskProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks"
+    ),
+    serialized_pb=_b(
+        '\n&google/cloud/tasks_v2/proto/task.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xf8\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x17\x61pp_engine_http_request\x18\x02 \x01(\x0b\x32+.google.cloud.tasks.v2.AppEngineHttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x07 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x08 \x01(\x05\x12\x35\n\rfirst_attempt\x18\t \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12\x34\n\x0clast_attempt\x18\n \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12.\n\x04view\x18\x0b \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cmessage_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBd\n\x19\x63om.google.cloud.tasks.v2B\tTaskProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TASK_VIEW = _descriptor.EnumDescriptor(
+    name="View",
+    full_name="google.cloud.tasks.v2.Task.View",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VIEW_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=716,
+    serialized_end=765,
+)
+_sym_db.RegisterEnumDescriptor(_TASK_VIEW)
+
+
+_TASK = _descriptor.Descriptor(
+    name="Task",
+    full_name="google.cloud.tasks.v2.Task",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2.Task.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_request",
+            full_name="google.cloud.tasks.v2.Task.app_engine_http_request",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2.Task.schedule_time",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.tasks.v2.Task.create_time",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_deadline",
+            full_name="google.cloud.tasks.v2.Task.dispatch_deadline",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_count",
+            full_name="google.cloud.tasks.v2.Task.dispatch_count",
+            index=5,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_count",
+            full_name="google.cloud.tasks.v2.Task.response_count",
+            index=6,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="first_attempt",
+            full_name="google.cloud.tasks.v2.Task.first_attempt",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_attempt",
+            full_name="google.cloud.tasks.v2.Task.last_attempt",
+            index=8,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.cloud.tasks.v2.Task.view",
+            index=9,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TASK_VIEW],
+    serialized_options=_b(
+        "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+    ),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="message_type",
+            full_name="google.cloud.tasks.v2.Task.message_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=255,
+    serialized_end=887,
+)
+
+
+_ATTEMPT = _descriptor.Descriptor(
+    name="Attempt",
+    full_name="google.cloud.tasks.v2.Attempt",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2.Attempt.schedule_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_time",
+            full_name="google.cloud.tasks.v2.Attempt.dispatch_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_time",
+            full_name="google.cloud.tasks.v2.Attempt.response_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_status",
+            full_name="google.cloud.tasks.v2.Attempt.response_status",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=890,
+    serialized_end=1097,
+)
+
+_TASK.fields_by_name[
+    "app_engine_http_request"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2._APPENGINEHTTPREQUEST
+)
+_TASK.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TASK.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TASK.fields_by_name[
+    "dispatch_deadline"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TASK.fields_by_name["first_attempt"].message_type = _ATTEMPT
+_TASK.fields_by_name["last_attempt"].message_type = _ATTEMPT
+_TASK.fields_by_name["view"].enum_type = _TASK_VIEW
+_TASK_VIEW.containing_type = _TASK
+_TASK.oneofs_by_name["message_type"].fields.append(
+    _TASK.fields_by_name["app_engine_http_request"]
+)
+_TASK.fields_by_name["app_engine_http_request"].containing_oneof = _TASK.oneofs_by_name[
+    "message_type"
+]
+_ATTEMPT.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "dispatch_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "response_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "response_status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+DESCRIPTOR.message_types_by_name["Task"] = _TASK
+DESCRIPTOR.message_types_by_name["Attempt"] = _ATTEMPT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Task = _reflection.GeneratedProtocolMessageType(
+    "Task",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TASK,
+        __module__="google.cloud.tasks_v2.proto.task_pb2",
+        __doc__="""A unit of scheduled work.
+  
+  
+  Attributes:
+      name:
+          Optionally caller-specified in
+          [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask].
+          The task name.  The task name must have the following format: 
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/ta
+          sks/TASK_ID``  -  ``PROJECT_ID`` can contain letters
+          ([A-Za-z]), numbers ([0-9]),    hyphens (-), colons (:), or
+          periods (.). For more information, see    `Identifying
+          projects <https://cloud.google.com/resource-
+          manager/docs/creating-managing-
+          projects#identifying_projects>`_ -  ``LOCATION_ID`` is the
+          canonical ID for the task's location. The list    of available
+          locations can be obtained by calling    [ListLocations][google
+          .cloud.location.Locations.ListLocations]. For    more
+          information, see https://cloud.google.com/about/locations/. -
+          ``QUEUE_ID`` can contain letters ([A-Za-z]), numbers ([0-9]),
+          or    hyphens (-). The maximum length is 100 characters. -
+          ``TASK_ID`` can contain only letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), or underscores (\_). The maximum
+          length is 500    characters.
+      message_type:
+          Required. The message to send to the worker.
+      app_engine_http_request:
+          HTTP request that is sent to the App Engine app handler.  An
+          App Engine task is a task that has [AppEngineHttpRequest][goog
+          le.cloud.tasks.v2.AppEngineHttpRequest] set.
+      schedule_time:
+          The time when the task is scheduled to be attempted or
+          retried.  ``schedule_time`` will be truncated to the nearest
+          microsecond.
+      create_time:
+          Output only. The time that the task was created.
+          ``create_time`` will be truncated to the nearest second.
+      dispatch_deadline:
+          The deadline for requests sent to the worker. If the worker
+          does not respond by this deadline then the request is
+          cancelled and the attempt is marked as a ``DEADLINE_EXCEEDED``
+          failure. Cloud Tasks will retry the task according to the
+          [RetryConfig][google.cloud.tasks.v2.RetryConfig].  Note that
+          when the request is cancelled, Cloud Tasks will stop listing
+          for the response, but whether the worker stops processing
+          depends on the worker. For example, if the worker is stuck, it
+          may not react to cancelled requests.  The default and maximum
+          values depend on the type of request:  -  For [App Engine
+          tasks][google.cloud.tasks.v2.AppEngineHttpRequest], 0
+          indicates that the request has the default deadline. The
+          default    deadline depends on the `scaling    type
+          <https://cloud.google.com/appengine/docs/standard/go/how-
+          instances-are-managed#instance_scaling>`_    of the service:
+          10 minutes for standard apps with automatic scaling,    24
+          hours for standard apps with manual and basic scaling, and 60
+          minutes for flex apps. If the request deadline is set, it must
+          be in    the interval [15 seconds, 24 hours 15 seconds].
+          Regardless of the    task's ``dispatch_deadline``, the app
+          handler will not run for longer    than than the service's
+          timeout. We recommend setting the    ``dispatch_deadline`` to
+          at most a few seconds more than the app    handler's timeout.
+          For more information see    `Timeouts
+          <https://cloud.google.com/tasks/docs/creating-appengine-
+          handlers#timeouts>`_.  ``dispatch_deadline`` will be
+          truncated to the nearest millisecond. The deadline is an
+          approximate deadline.
+      dispatch_count:
+          Output only. The number of attempts dispatched.  This count
+          includes attempts which have been dispatched but haven't
+          received a response.
+      response_count:
+          Output only. The number of attempts which have received a
+          response.
+      first_attempt:
+          Output only. The status of the task's first attempt.  Only
+          [dispatch\_time][google.cloud.tasks.v2.Attempt.dispatch\_time]
+          will be set. The other
+          [Attempt][google.cloud.tasks.v2.Attempt] information is not
+          retained by Cloud Tasks.
+      last_attempt:
+          Output only. The status of the task's last attempt.
+      view:
+          Output only. The view specifies which subset of the
+          [Task][google.cloud.tasks.v2.Task] has been returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.Task)
+    ),
+)
+_sym_db.RegisterMessage(Task)
+
+Attempt = _reflection.GeneratedProtocolMessageType(
+    "Attempt",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ATTEMPT,
+        __module__="google.cloud.tasks_v2.proto.task_pb2",
+        __doc__="""The status of a task attempt.
+  
+  
+  Attributes:
+      schedule_time:
+          Output only. The time that this attempt was scheduled.
+          ``schedule_time`` will be truncated to the nearest
+          microsecond.
+      dispatch_time:
+          Output only. The time that this attempt was dispatched.
+          ``dispatch_time`` will be truncated to the nearest
+          microsecond.
+      response_time:
+          Output only. The time that this attempt response was received.
+          ``response_time`` will be truncated to the nearest
+          microsecond.
+      response_status:
+          Output only. The response from the worker for this attempt.
+          If ``response_time`` is unset, then the task has not been
+          attempted or is currently running and the ``response_status``
+          field is meaningless.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.Attempt)
+    ),
+)
+_sym_db.RegisterMessage(Attempt)
+
+
+DESCRIPTOR._options = None
+_TASK._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2/proto/task_pb2_grpc.py b/tasks/google/cloud/tasks_v2/proto/task_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/proto/task_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2/types.py b/tasks/google/cloud/tasks_v2/types.py
new file mode 100644
index 000000000000..a77d90cdf1de
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2/types.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.tasks_v2.proto import cloudtasks_pb2
+from google.cloud.tasks_v2.proto import queue_pb2
+from google.cloud.tasks_v2.proto import target_pb2
+from google.cloud.tasks_v2.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [cloudtasks_pb2, queue_pb2, target_pb2, task_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.tasks_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/tasks/google/cloud/tasks_v2beta2/__init__.py b/tasks/google/cloud/tasks_v2beta2/__init__.py
new file mode 100644
index 000000000000..0581eef84df5
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.tasks_v2beta2 import types
+from google.cloud.tasks_v2beta2.gapic import cloud_tasks_client
+from google.cloud.tasks_v2beta2.gapic import enums
+
+
+class CloudTasksClient(cloud_tasks_client.CloudTasksClient):
+    __doc__ = cloud_tasks_client.CloudTasksClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudTasksClient")
diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/__init__.py b/tasks/google/cloud/tasks_v2beta2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py b/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py
new file mode 100644
index 000000000000..cdfdf40b3511
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py
@@ -0,0 +1,2151 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.tasks.v2beta2 CloudTasks API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.tasks_v2beta2.gapic import cloud_tasks_client_config
+from google.cloud.tasks_v2beta2.gapic import enums
+from google.cloud.tasks_v2beta2.gapic.transports import cloud_tasks_grpc_transport
+from google.cloud.tasks_v2beta2.proto import cloudtasks_pb2
+from google.cloud.tasks_v2beta2.proto import cloudtasks_pb2_grpc
+from google.cloud.tasks_v2beta2.proto import queue_pb2
+from google.cloud.tasks_v2beta2.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks").version
+
+
+class CloudTasksClient(object):
+    """
+    Cloud Tasks allows developers to manage the execution of background
+    work in their applications.
+    """
+
+    SERVICE_ADDRESS = "cloudtasks.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.tasks.v2beta2.CloudTasks"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudTasksClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def queue_path(cls, project, location, queue):
+        """Return a fully-qualified queue string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/queues/{queue}",
+            project=project,
+            location=location,
+            queue=queue,
+        )
+
+    @classmethod
+    def task_path(cls, project, location, queue, task):
+        """Return a fully-qualified task string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}",
+            project=project,
+            location=location,
+            queue=queue,
+            task=task,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudTasksGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudTasksGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_tasks_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_tasks_grpc_transport.CloudTasksGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_tasks_grpc_transport.CloudTasksGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_queues(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists queues.
+
+        Queues are returned in lexicographical order.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_queues(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_queues(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``
+            filter_ (str): ``filter`` can be used to specify a subset of queues. Any ``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: \*".
+
+                Note that using filters might cause fewer queues than the
+                requested\_page size to be returned.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.tasks_v2beta2.types.Queue` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_queues" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_queues"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_queues,
+                default_retry=self._method_configs["ListQueues"].retry,
+                default_timeout=self._method_configs["ListQueues"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ListQueuesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_queues"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="queues",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a queue.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.get_queue(name)
+
+        Args:
+            name (str): Required. The resource name of the queue. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_queue,
+                default_retry=self._method_configs["GetQueue"].retry,
+                default_timeout=self._method_configs["GetQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.GetQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_queue(
+        self,
+        parent,
+        queue,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `queue`:
+            >>> queue = {}
+            >>>
+            >>> response = client.create_queue(parent, queue)
+
+        Args:
+            parent (str): 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``.
+            queue (Union[dict, ~google.cloud.tasks_v2beta2.types.Queue]): Required. The queue to create.
+
+                ``Queue's name`` cannot be the same as an existing queue.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Queue`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_queue,
+                default_retry=self._method_configs["CreateQueue"].retry,
+                default_timeout=self._method_configs["CreateQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_queue(
+        self,
+        queue,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a queue.
+
+        This method creates the queue if it does not exist and updates 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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> # TODO: Initialize `queue`:
+            >>> queue = {}
+            >>>
+            >>> response = client.update_queue(queue)
+
+        Args:
+            queue (Union[dict, ~google.cloud.tasks_v2beta2.types.Queue]): Required. The queue to create or update.
+
+                The queue's ``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``
+                cannot be changed.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Queue`
+            update_mask (Union[dict, ~google.cloud.tasks_v2beta2.types.FieldMask]): A mask used to specify which fields of the queue are being updated.
+
+                If empty, then all fields will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_queue,
+                default_retry=self._method_configs["UpdateQueue"].retry,
+                default_timeout=self._method_configs["UpdateQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.UpdateQueueRequest(
+            queue=queue, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("queue.name", queue.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a queue.
+
+        This command will delete the queue even if it has tasks in it.
+
+        Note: If you delete a queue, a queue with the same name can't be created
+        for 7 days.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> client.delete_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_queue,
+                default_retry=self._method_configs["DeleteQueue"].retry,
+                default_timeout=self._method_configs["DeleteQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.DeleteQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def purge_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Purges a queue by deleting all of its tasks.
+
+        All tasks created before this method is called are permanently deleted.
+
+        Purge operations can take up to one minute to take effect. Tasks
+        might be dispatched before the purge takes effect. A purge is irreversible.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.purge_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "purge_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "purge_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.purge_queue,
+                default_retry=self._method_configs["PurgeQueue"].retry,
+                default_timeout=self._method_configs["PurgeQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.PurgeQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["purge_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pause_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pauses the queue.
+
+        If a queue is paused then the system will stop dispatching tasks until
+        the queue is resumed via ``ResumeQueue``. Tasks can still be added when
+        the queue is paused. A queue is paused if its ``state`` is ``PAUSED``.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.pause_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pause_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "pause_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pause_queue,
+                default_retry=self._method_configs["PauseQueue"].retry,
+                default_timeout=self._method_configs["PauseQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.PauseQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["pause_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def resume_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Resume a queue.
+
+        This method resumes a queue after it has been ``PAUSED`` or
+        ``DISABLED``. The state of a queue is stored in the queue's ``state``;
+        after calling this method it will be set to ``RUNNING``.
+
+        WARNING: Resuming many high-QPS queues at the same time can lead to
+        target overloading. If you are resuming high-QPS queues, follow the
+        500/50/5 pattern described in `Managing Cloud Tasks Scaling
+        Risks <https://cloud.google.com/tasks/docs/manage-cloud-task-scaling>`__.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.resume_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "resume_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "resume_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.resume_queue,
+                default_retry=self._method_configs["ResumeQueue"].retry,
+                default_timeout=self._method_configs["ResumeQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ResumeQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["resume_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a ``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``
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.tasks_v2beta2.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy for a ``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.
+
+        Authorization requires the following `Google
+        IAM <https://cloud.google.com/iam>`__ permission on the specified
+        resource parent:
+
+        -  ``cloudtasks.queues.setIamPolicy``
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.tasks_v2beta2.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns permissions that a caller has on a ``Queue``. 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.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_tasks(
+        self,
+        parent,
+        response_view=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the tasks in a queue.
+
+        By default, only the ``BASIC`` view is retrieved due to performance
+        considerations; ``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.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tasks(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tasks(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.tasks_v2beta2.types.Task` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tasks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tasks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tasks,
+                default_retry=self._method_configs["ListTasks"].retry,
+                default_timeout=self._method_configs["ListTasks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ListTasksRequest(
+            parent=parent, response_view=response_view, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tasks"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tasks",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_task(
+        self,
+        name,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a task.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> response = client.get_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_task,
+                default_retry=self._method_configs["GetTask"].retry,
+                default_timeout=self._method_configs["GetTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_task(
+        self,
+        parent,
+        task,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a task and adds it to a queue.
+
+        Tasks cannot be updated after creation; there is no UpdateTask command.
+
+        -  For ``App Engine queues``, the maximum task size is 100KB.
+        -  For ``pull queues``, the maximum task size is 1MB.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `task`:
+            >>> task = {}
+            >>>
+            >>> response = client.create_task(parent, task)
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+
+                The queue must already exist.
+            task (Union[dict, ~google.cloud.tasks_v2beta2.types.Task]): 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``. 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``.
+
+                If ``schedule_time`` is not set or is in the past then Cloud Tasks will
+                set it to the current time.
+
+                Task De-duplication:
+
+                Explicitly specifying a task ID enables task de-duplication. If a task's
+                ID is identical to that of an existing task or a task that was deleted
+                or completed recently then the call will fail with ``ALREADY_EXISTS``.
+                If the task's queue was created using Cloud Tasks, then another task
+                with the same name can't be created for ~1hour after the original task
+                was deleted or completed. If the task's queue was created using
+                queue.yaml or queue.xml, then another task with the same name can't be
+                created for ~9days after the original task was deleted or completed.
+
+                Because there is an extra lookup cost to identify duplicate task names,
+                these ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Task`
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_task,
+                default_retry=self._method_configs["CreateTask"].retry,
+                default_timeout=self._method_configs["CreateTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CreateTaskRequest(
+            parent=parent, task=task, response_view=response_view
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_task(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a task.
+
+        A task can be deleted if it is scheduled or dispatched. A task
+        cannot be deleted if it has completed successfully or permanently
+        failed.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> client.delete_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_task,
+                default_retry=self._method_configs["DeleteTask"].retry,
+                default_timeout=self._method_configs["DeleteTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.DeleteTaskRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def lease_tasks(
+        self,
+        parent,
+        lease_duration,
+        max_tasks=None,
+        response_view=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Leases tasks from a pull queue for ``lease_duration``.
+
+        This method is invoked by the worker to obtain a lease. The worker must
+        acknowledge the task via ``AcknowledgeTask`` after they have performed
+        the work associated with the task.
+
+        The ``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``, set ``response_view`` to ``FULL``.
+
+        A maximum of 10 qps of ``LeaseTasks`` requests are allowed per queue.
+        ``RESOURCE_EXHAUSTED`` is returned when this limit is exceeded.
+        ``RESOURCE_EXHAUSTED`` is also returned when
+        ``max_tasks_dispatched_per_second`` is exceeded.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `lease_duration`:
+            >>> lease_duration = {}
+            >>>
+            >>> response = client.lease_tasks(parent, lease_duration)
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            lease_duration (Union[dict, ~google.cloud.tasks_v2beta2.types.Duration]): Required. The duration of the lease.
+
+                Each task returned in the ``response`` will have its ``schedule_time``
+                set to the current time plus the ``lease_duration``. The task is leased
+                until its ``schedule_time``; thus, the task will not be returned to
+                another ``LeaseTasks`` call before its ``schedule_time``.
+
+                After the worker has successfully finished the work associated with the
+                task, the worker must call via ``AcknowledgeTask`` before the
+                ``schedule_time``. Otherwise the task will be returned to a later
+                ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Duration`
+            max_tasks (int): The maximum number of tasks to lease.
+
+                The system will make a best effort to return as close to as
+                ``max_tasks`` as possible.
+
+                The largest that ``max_tasks`` can be is 1000.
+
+                The maximum total size of a ``lease tasks response`` is 32 MB. If the
+                sum of all task sizes requested reaches this limit, fewer tasks than
+                requested are returned.
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            filter_ (str): ``filter`` can be used to specify a subset of tasks to lease.
+
+                When ``filter`` is set to ``tag=<my-tag>`` then the ``response`` will
+                contain only tasks whose ``tag`` is equal to ``<my-tag>``. ``<my-tag>``
+                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``
+                will be returned.
+
+                Grammar Syntax:
+
+                -  ``filter = "tag=" tag | "tag_function=" function``
+
+                -  ``tag = string``
+
+                -  ``function = "oldest_tag()"``
+
+                The ``oldest_tag()`` function returns tasks which have the same tag as
+                the oldest task (ordered by schedule time).
+
+                SDK compatibility: Although the SDK allows tags to be either string or
+                `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`` and the task's ``tag``
+                will be displayed as empty in Cloud Tasks.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.LeaseTasksResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "lease_tasks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "lease_tasks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.lease_tasks,
+                default_retry=self._method_configs["LeaseTasks"].retry,
+                default_timeout=self._method_configs["LeaseTasks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.LeaseTasksRequest(
+            parent=parent,
+            lease_duration=lease_duration,
+            max_tasks=max_tasks,
+            response_view=response_view,
+            filter=filter_,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["lease_tasks"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def acknowledge_task(
+        self,
+        name,
+        schedule_time,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Acknowledges a pull task.
+
+        The worker, that is, the entity that ``leased`` 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`` 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``, ``GetTask``, or ``ListTasks``.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> # TODO: Initialize `schedule_time`:
+            >>> schedule_time = {}
+            >>>
+            >>> client.acknowledge_task(name, schedule_time)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. The task's current schedule time, available in the
+                ``schedule_time`` returned by ``LeaseTasks`` response or ``RenewLease``
+                response. This restriction is to ensure that your worker currently holds
+                the lease.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Timestamp`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "acknowledge_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "acknowledge_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.acknowledge_task,
+                default_retry=self._method_configs["AcknowledgeTask"].retry,
+                default_timeout=self._method_configs["AcknowledgeTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.AcknowledgeTaskRequest(
+            name=name, schedule_time=schedule_time
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["acknowledge_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def renew_lease(
+        self,
+        name,
+        schedule_time,
+        lease_duration,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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``.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> # TODO: Initialize `schedule_time`:
+            >>> schedule_time = {}
+            >>>
+            >>> # TODO: Initialize `lease_duration`:
+            >>> lease_duration = {}
+            >>>
+            >>> response = client.renew_lease(name, schedule_time, lease_duration)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. The task's current schedule time, available in the
+                ``schedule_time`` returned by ``LeaseTasks`` response or ``RenewLease``
+                response. This restriction is to ensure that your worker currently holds
+                the lease.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Timestamp`
+            lease_duration (Union[dict, ~google.cloud.tasks_v2beta2.types.Duration]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Duration`
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "renew_lease" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "renew_lease"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.renew_lease,
+                default_retry=self._method_configs["RenewLease"].retry,
+                default_timeout=self._method_configs["RenewLease"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.RenewLeaseRequest(
+            name=name,
+            schedule_time=schedule_time,
+            lease_duration=lease_duration,
+            response_view=response_view,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["renew_lease"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def cancel_lease(
+        self,
+        name,
+        schedule_time,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Cancel a pull task's lease.
+
+        The worker can use this method to cancel a task's lease by setting its
+        ``schedule_time`` to now. This will make the task available to be leased
+        to the next caller of ``LeaseTasks``.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> # TODO: Initialize `schedule_time`:
+            >>> schedule_time = {}
+            >>>
+            >>> response = client.cancel_lease(name, schedule_time)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            schedule_time (Union[dict, ~google.cloud.tasks_v2beta2.types.Timestamp]): Required. The task's current schedule time, available in the
+                ``schedule_time`` returned by ``LeaseTasks`` response or ``RenewLease``
+                response. This restriction is to ensure that your worker currently holds
+                the lease.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta2.types.Timestamp`
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "cancel_lease" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "cancel_lease"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.cancel_lease,
+                default_retry=self._method_configs["CancelLease"].retry,
+                default_timeout=self._method_configs["CancelLease"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CancelLeaseRequest(
+            name=name, schedule_time=schedule_time, response_view=response_view
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["cancel_lease"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_task(
+        self,
+        name,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` or
+        is ``PAUSED``.
+
+        This command is meant to be used for manual debugging. For example,
+        ``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`` 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``
+        will be reset to the time that ``RunTask`` was called plus the retry
+        delay specified in the queue's ``RetryConfig``.
+
+        ``RunTask`` returns ``NOT_FOUND`` when it is called on a task that has
+        already succeeded or permanently failed.
+
+        ``RunTask`` cannot be called on a ``pull task``.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta2
+            >>>
+            >>> client = tasks_v2beta2.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> response = client.run_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            response_view (~google.cloud.tasks_v2beta2.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta2.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_task,
+                default_retry=self._method_configs["RunTask"].retry,
+                default_timeout=self._method_configs["RunTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py b/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py
new file mode 100644
index 000000000000..a04987764427
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py
@@ -0,0 +1,123 @@
+config = {
+    "interfaces": {
+        "google.cloud.tasks.v2beta2.CloudTasks": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListQueues": {
+                    "timeout_millis": 15000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PurgeQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "PauseQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ResumeQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTasks": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "LeaseTasks": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "AcknowledgeTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "RenewLease": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CancelLease": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/enums.py b/tasks/google/cloud/tasks_v2beta2/gapic/enums.py
new file mode 100644
index 000000000000..c0860d328498
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/gapic/enums.py
@@ -0,0 +1,112 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class HttpMethod(enum.IntEnum):
+    """
+    The HTTP method used to execute the task.
+
+    Attributes:
+      HTTP_METHOD_UNSPECIFIED (int): HTTP method unspecified
+      POST (int): HTTP POST
+      GET (int): HTTP GET
+      HEAD (int): HTTP HEAD
+      PUT (int): HTTP PUT
+      DELETE (int): HTTP DELETE
+    """
+
+    HTTP_METHOD_UNSPECIFIED = 0
+    POST = 1
+    GET = 2
+    HEAD = 3
+    PUT = 4
+    DELETE = 5
+
+
+class Queue(object):
+    class State(enum.IntEnum):
+        """
+        State of the queue.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          RUNNING (int): The queue is running. Tasks can be dispatched.
+
+          If the queue was created using Cloud Tasks and the queue has had no
+          activity (method calls or task dispatches) for 30 days, the queue may
+          take a few minutes to re-activate. Some method calls may return
+          ``NOT_FOUND`` and tasks may not be dispatched for a few minutes until
+          the queue has been re-activated.
+          PAUSED (int): 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`` calls
+          will return a ``FAILED_PRECONDITION``.
+          DISABLED (int): The queue is disabled.
+
+          A queue becomes ``DISABLED`` when
+          `queue.yaml <https://cloud.google.com/appengine/docs/python/config/queueref>`__
+          or
+          `queue.xml <https://cloud.google.com/appengine/docs/standard/java/config/queueref>`__
+          is uploaded which does not contain the queue. You cannot directly
+          disable a queue.
+
+          When a queue is disabled, tasks can still be added to a queue but the
+          tasks are not dispatched and ``LeaseTasks`` calls return a
+          ``FAILED_PRECONDITION`` error.
+
+          To permanently delete this queue and all of its tasks, call
+          ``DeleteQueue``.
+        """
+
+        STATE_UNSPECIFIED = 0
+        RUNNING = 1
+        PAUSED = 2
+        DISABLED = 3
+
+
+class Task(object):
+    class View(enum.IntEnum):
+        """
+        The view specifies a subset of ``Task`` data.
+
+        When a task is returned in a response, 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.
+
+        Attributes:
+          VIEW_UNSPECIFIED (int): Unspecified. Defaults to BASIC.
+          BASIC (int): The basic view omits fields which can be large or can contain sensitive
+          data.
+
+          This view does not include the (``payload in AppEngineHttpRequest`` and
+          ``payload in PullMessage``). 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.
+          FULL (int): All information is returned.
+
+          Authorization for ``FULL`` requires ``cloudtasks.tasks.fullView``
+          `Google IAM <https://cloud.google.com/iam/>`__ permission on the
+          ``Queue`` resource.
+        """
+
+        VIEW_UNSPECIFIED = 0
+        BASIC = 1
+        FULL = 2
diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/transports/__init__.py b/tasks/google/cloud/tasks_v2beta2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py b/tasks/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py
new file mode 100644
index 000000000000..d5f2cd7e04d3
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py
@@ -0,0 +1,510 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.tasks_v2beta2.proto import cloudtasks_pb2_grpc
+
+
+class CloudTasksGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.tasks.v2beta2 CloudTasks API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudtasks.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudtasks.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_queues(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.list_queues`.
+
+        Lists queues.
+
+        Queues are returned in lexicographical order.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ListQueues
+
+    @property
+    def get_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_queue`.
+
+        Gets a queue.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetQueue
+
+    @property
+    def create_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.create_queue`.
+
+        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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CreateQueue
+
+    @property
+    def update_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.update_queue`.
+
+        Updates a queue.
+
+        This method creates the queue if it does not exist and updates 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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].UpdateQueue
+
+    @property
+    def delete_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.delete_queue`.
+
+        Deletes a queue.
+
+        This command will delete the queue even if it has tasks in it.
+
+        Note: If you delete a queue, a queue with the same name can't be created
+        for 7 days.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].DeleteQueue
+
+    @property
+    def purge_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.purge_queue`.
+
+        Purges a queue by deleting all of its tasks.
+
+        All tasks created before this method is called are permanently deleted.
+
+        Purge operations can take up to one minute to take effect. Tasks
+        might be dispatched before the purge takes effect. A purge is irreversible.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].PurgeQueue
+
+    @property
+    def pause_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.pause_queue`.
+
+        Pauses the queue.
+
+        If a queue is paused then the system will stop dispatching tasks until
+        the queue is resumed via ``ResumeQueue``. Tasks can still be added when
+        the queue is paused. A queue is paused if its ``state`` is ``PAUSED``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].PauseQueue
+
+    @property
+    def resume_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.resume_queue`.
+
+        Resume a queue.
+
+        This method resumes a queue after it has been ``PAUSED`` or
+        ``DISABLED``. The state of a queue is stored in the queue's ``state``;
+        after calling this method it will be set to ``RUNNING``.
+
+        WARNING: Resuming many high-QPS queues at the same time can lead to
+        target overloading. If you are resuming high-QPS queues, follow the
+        500/50/5 pattern described in `Managing Cloud Tasks Scaling
+        Risks <https://cloud.google.com/tasks/docs/manage-cloud-task-scaling>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ResumeQueue
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_iam_policy`.
+
+        Gets the access control policy for a ``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``
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetIamPolicy
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.set_iam_policy`.
+
+        Sets the access control policy for a ``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.
+
+        Authorization requires the following `Google
+        IAM <https://cloud.google.com/iam>`__ permission on the specified
+        resource parent:
+
+        -  ``cloudtasks.queues.setIamPolicy``
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].SetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.test_iam_permissions`.
+
+        Returns permissions that a caller has on a ``Queue``. 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].TestIamPermissions
+
+    @property
+    def list_tasks(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.list_tasks`.
+
+        Lists the tasks in a queue.
+
+        By default, only the ``BASIC`` view is retrieved due to performance
+        considerations; ``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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ListTasks
+
+    @property
+    def get_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_task`.
+
+        Gets a task.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetTask
+
+    @property
+    def create_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.create_task`.
+
+        Creates a task and adds it to a queue.
+
+        Tasks cannot be updated after creation; there is no UpdateTask command.
+
+        -  For ``App Engine queues``, the maximum task size is 100KB.
+        -  For ``pull queues``, the maximum task size is 1MB.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CreateTask
+
+    @property
+    def delete_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.delete_task`.
+
+        Deletes a task.
+
+        A task can be deleted if it is scheduled or dispatched. A task
+        cannot be deleted if it has completed successfully or permanently
+        failed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].DeleteTask
+
+    @property
+    def lease_tasks(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.lease_tasks`.
+
+        Leases tasks from a pull queue for ``lease_duration``.
+
+        This method is invoked by the worker to obtain a lease. The worker must
+        acknowledge the task via ``AcknowledgeTask`` after they have performed
+        the work associated with the task.
+
+        The ``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``, set ``response_view`` to ``FULL``.
+
+        A maximum of 10 qps of ``LeaseTasks`` requests are allowed per queue.
+        ``RESOURCE_EXHAUSTED`` is returned when this limit is exceeded.
+        ``RESOURCE_EXHAUSTED`` is also returned when
+        ``max_tasks_dispatched_per_second`` is exceeded.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].LeaseTasks
+
+    @property
+    def acknowledge_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.acknowledge_task`.
+
+        Acknowledges a pull task.
+
+        The worker, that is, the entity that ``leased`` 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`` 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``, ``GetTask``, or ``ListTasks``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].AcknowledgeTask
+
+    @property
+    def renew_lease(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.renew_lease`.
+
+        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``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].RenewLease
+
+    @property
+    def cancel_lease(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.cancel_lease`.
+
+        Cancel a pull task's lease.
+
+        The worker can use this method to cancel a task's lease by setting its
+        ``schedule_time`` to now. This will make the task available to be leased
+        to the next caller of ``LeaseTasks``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CancelLease
+
+    @property
+    def run_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.run_task`.
+
+        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`` or
+        is ``PAUSED``.
+
+        This command is meant to be used for manual debugging. For example,
+        ``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`` 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``
+        will be reset to the time that ``RunTask`` was called plus the retry
+        delay specified in the queue's ``RetryConfig``.
+
+        ``RunTask`` returns ``NOT_FOUND`` when it is called on a task that has
+        already succeeded or permanently failed.
+
+        ``RunTask`` cannot be called on a ``pull task``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].RunTask
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/__init__.py b/tasks/google/cloud/tasks_v2beta2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto
new file mode 100644
index 000000000000..79274fc37291
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks.proto
@@ -0,0 +1,931 @@
+// 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.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";
+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";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks";
+option java_multiple_files = true;
+option java_outer_classname = "CloudTasksProto";
+option java_package = "com.google.cloud.tasks.v2beta2";
+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.
+  rpc ListQueues(ListQueuesRequest) returns (ListQueuesResponse) {
+    option (google.api.http) = {
+      get: "/v2beta2/{parent=projects/*/locations/*}/queues"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a queue.
+  rpc GetQueue(GetQueueRequest) returns (Queue) {
+    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.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc CreateQueue(CreateQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2beta2/{parent=projects/*/locations/*}/queues"
+      body: "queue"
+    };
+    option (google.api.method_signature) = "parent,queue";
+  }
+
+  // Updates a queue.
+  //
+  // This method creates the queue if it does not exist and updates
+  // 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.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc UpdateQueue(UpdateQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      patch: "/v2beta2/{queue.name=projects/*/locations/*/queues/*}"
+      body: "queue"
+    };
+    option (google.api.method_signature) = "queue,update_mask";
+  }
+
+  // Deletes a queue.
+  //
+  // This command will delete the queue even if it has tasks in it.
+  //
+  // Note: If you delete a queue, a queue with the same name can't be created
+  // for 7 days.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc DeleteQueue(DeleteQueueRequest) returns (google.protobuf.Empty) {
+    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.
+  //
+  // All tasks created before this method is called are permanently deleted.
+  //
+  // Purge operations can take up to one minute to take effect. Tasks
+  // might be dispatched before the purge takes effect. A purge is irreversible.
+  rpc PurgeQueue(PurgeQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      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].
+  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].
+  //
+  // WARNING: Resuming many high-QPS queues at the same time can
+  // lead to target overloading. If you are resuming high-QPS
+  // queues, follow the 500/50/5 pattern described in
+  // [Managing Cloud Tasks Scaling
+  // Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+  rpc ResumeQueue(ResumeQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      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.
+  //
+  // 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) {
+    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.
+  //
+  // Note: The Cloud Console does not check queue-level IAM permissions yet.
+  // Project-level permissions are required to use the Cloud Console.
+  //
+  // Authorization requires the following
+  // [Google IAM](https://cloud.google.com/iam) permission on the specified
+  // resource parent:
+  //
+  // * `cloudtasks.queues.setIamPolicy`
+  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.
+  //
+  // 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: "/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.
+  //
+  // The tasks may be returned in any order. The ordering may change at any
+  // time.
+  rpc ListTasks(ListTasksRequest) returns (ListTasksResponse) {
+    option (google.api.http) = {
+      get: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a task.
+  rpc GetTask(GetTaskRequest) returns (Task) {
+    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
+  //   100KB.
+  // * 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.
+  //
+  // A task can be deleted if it is scheduled or dispatched. A task
+  // cannot be deleted if it has completed successfully or permanently
+  // failed.
+  rpc DeleteTask(DeleteTaskRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Leases tasks from a pull queue for
+  // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration].
+  //
+  // 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]
+  // is returned when this limit is
+  // exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED]
+  // is also returned when
+  // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second]
+  // is exceeded.
+  rpc LeaseTasks(LeaseTasksRequest) returns (LeaseTasksResponse) {
+    option (google.api.http) = {
+      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.
+  //
+  // 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
+  // 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
+  // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
+  rpc AcknowledgeTask(AcknowledgeTaskRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      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].
+  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].
+  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].
+  //
+  // 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.
+  //
+  // 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.
+  //
+  // 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].
+  //
+  // [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].
+  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].
+message ListQueuesRequest {
+  // Required. The location name.
+  // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // `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: *".
+  //
+  // Note that using filters might cause fewer queues than the
+  // requested_page size to be returned.
+  string filter = 2;
+
+  // Requested page size.
+  //
+  // 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.
+  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.
+  string page_token = 4;
+}
+
+// Response message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
+message ListQueuesResponse {
+  // The list of queues.
+  repeated Queue queues = 1;
+
+  // 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
+  // [page_token][google.cloud.tasks.v2beta2.ListQueuesRequest.page_token].
+  //
+  // If the next_page_token is empty, there are no more results.
+  //
+  // The page token is valid for only 2 hours.
+  string next_page_token = 2;
+}
+
+// Request message for [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue].
+message GetQueueRequest {
+  // Required. The resource name of the queue. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  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].
+message CreateQueueRequest {
+  // 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 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The queue to create.
+  //
+  // [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].
+message UpdateQueueRequest {
+  // Required. The queue to create or update.
+  //
+  // 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 [(google.api.field_behavior) = REQUIRED];
+
+  // A mask used to specify which fields of the queue are being updated.
+  //
+  // If empty, then all fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue].
+message DeleteQueueRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  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].
+message PurgeQueueRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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].
+message PauseQueueRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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].
+message ResumeQueueRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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].
+message ListTasksRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // 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 = 2;
+
+  // Maximum page size.
+  //
+  // 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.
+  //
+  // 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].
+message ListTasksResponse {
+  // The list of tasks.
+  repeated Task tasks = 1;
+
+  // 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
+  // [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].
+message GetTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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.
+  //
+  // 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].
+message CreateTaskRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  //
+  // The queue must already exist.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // 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].
+  //
+  // 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:
+  //
+  // Explicitly specifying a task ID enables task de-duplication.  If
+  // a task's ID is identical to that of an existing task or a task
+  // that was deleted or completed recently then the call will fail
+  // with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
+  // If the task's queue was created using Cloud Tasks, then another task with
+  // the same name can't be created for ~1hour after the original task was
+  // deleted or completed. If the task's queue was created using queue.yaml or
+  // queue.xml, then another task with the same name can't be created
+  // 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
+  // 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 [(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 deleting a task using
+// [DeleteTask][google.cloud.tasks.v2beta2.CloudTasks.DeleteTask].
+message DeleteTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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].
+message LeaseTasksRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // The maximum number of tasks to lease.
+  //
+  // The system will make a best effort to return as close to as
+  // `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.
+  //
+  // The maximum lease duration is 1 week.
+  // `lease_duration` will be truncated to the nearest second.
+  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.
+  //
+  // 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 = 4;
+
+  // `filter` can be used to specify a subset of tasks to lease.
+  //
+  // When `filter` is set to `tag=<my-tag>` then the
+  // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will contain only tasks whose
+  // [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to `<my-tag>`. `<my-tag>` 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.
+  //
+  // Grammar Syntax:
+  //
+  // * `filter = "tag=" tag | "tag_function=" function`
+  //
+  // * `tag = string`
+  //
+  // * `function = "oldest_tag()"`
+  //
+  // The `oldest_tag()` function returns tasks which have the same tag as the
+  // oldest task (ordered by schedule time).
+  //
+  // SDK compatibility: Although the SDK allows tags to be either
+  // string or
+  // [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.
+  string filter = 5;
+}
+
+// Response message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
+message LeaseTasksResponse {
+  // The leased tasks.
+  repeated Task tasks = 1;
+}
+
+// Request message for acknowledging a task using
+// [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask].
+message AcknowledgeTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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 [(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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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 [(google.api.field_behavior) = REQUIRED];
+
+  // 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.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 = 4;
+}
+
+// Request message for canceling a lease using
+// [CancelLease][google.cloud.tasks.v2beta2.CloudTasks.CancelLease].
+message CancelLeaseRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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 [(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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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.
+  //
+  // 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/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py
new file mode 100644
index 000000000000..b071f420cb7f
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py
@@ -0,0 +1,2324 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta2/proto/cloudtasks.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2beta2.proto import (
+    queue_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2,
+)
+from google.cloud.tasks_v2beta2.proto import (
+    task_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta2/proto/cloudtasks.proto",
+    package="google.cloud.tasks.v2beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta2B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\242\002\005TASKS"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/tasks_v2beta2/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta2/proto/queue.proto\x1a+google/cloud/tasks_v2beta2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x85\x01\n\x11ListQueuesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x86\x01\n\x12\x43reateQueueRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xb0\x01\n\x10ListTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xbf\x01\n\x11\x43reateTaskRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta2.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\xe5\x01\n\x11LeaseTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x11\n\tmax_tasks\x18\x02 \x01(\x05\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t"E\n\x12LeaseTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task"\x86\x01\n\x16\x41\x63knowledgeTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02"\xf7\x01\n\x11RenewLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xc0\x01\n\x12\x43\x61ncelLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View2\xd4\x1c\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta2.ListQueuesRequest\x1a..google.cloud.tasks.v2beta2.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta2.GetQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta2.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta2.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta2.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta2.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta2.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta2.ListTasksRequest\x1a-.google.cloud.tasks.v2beta2.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta2.GetTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta2.CreateTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xcd\x01\n\nLeaseTasks\x12-.google.cloud.tasks.v2beta2.LeaseTasksRequest\x1a..google.cloud.tasks.v2beta2.LeaseTasksResponse"`\x82\xd3\xe4\x93\x02\x42"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\x01*\xda\x41\x15parent,lease_duration\x12\xc2\x01\n\x0f\x41\x63knowledgeTask\x12\x32.google.cloud.tasks.v2beta2.AcknowledgeTaskRequest\x1a\x16.google.protobuf.Empty"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\x01*\xda\x41\x12name,schedule_time\x12\xd0\x01\n\nRenewLease\x12-.google.cloud.tasks.v2beta2.RenewLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"q\x82\xd3\xe4\x93\x02G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\x01*\xda\x41!name,schedule_time,lease_duration\x12\xc4\x01\n\x0b\x43\x61ncelLease\x12..google.cloud.tasks.v2beta2.CancelLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\x01*\xda\x41\x12name,schedule_time\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta2.RunTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"M\x82\xd3\xe4\x93\x02@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\xa2\x02\x05TASKSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTQUEUESREQUEST = _descriptor.Descriptor(
+    name="ListQueuesRequest",
+    full_name="google.cloud.tasks.v2beta2.ListQueuesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta2.ListQueuesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A#\022!locations.googleapis.com/Location"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.tasks.v2beta2.ListQueuesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.tasks.v2beta2.ListQueuesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.tasks.v2beta2.ListQueuesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=476,
+    serialized_end=609,
+)
+
+
+_LISTQUEUESRESPONSE = _descriptor.Descriptor(
+    name="ListQueuesResponse",
+    full_name="google.cloud.tasks.v2beta2.ListQueuesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queues",
+            full_name="google.cloud.tasks.v2beta2.ListQueuesResponse.queues",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=611,
+    serialized_end=707,
+)
+
+
+_GETQUEUEREQUEST = _descriptor.Descriptor(
+    name="GetQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.GetQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.GetQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=709,
+    serialized_end=781,
+)
+
+
+_CREATEQUEUEREQUEST = _descriptor.Descriptor(
+    name="CreateQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.CreateQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta2.CreateQueueRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A#\022!locations.googleapis.com/Location"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="queue",
+            full_name="google.cloud.tasks.v2beta2.CreateQueueRequest.queue",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=784,
+    serialized_end=918,
+)
+
+
+_UPDATEQUEUEREQUEST = _descriptor.Descriptor(
+    name="UpdateQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.UpdateQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queue",
+            full_name="google.cloud.tasks.v2beta2.UpdateQueueRequest.queue",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.tasks.v2beta2.UpdateQueueRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=920,
+    serialized_end=1044,
+)
+
+
+_DELETEQUEUEREQUEST = _descriptor.Descriptor(
+    name="DeleteQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.DeleteQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.DeleteQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1046,
+    serialized_end=1121,
+)
+
+
+_PURGEQUEUEREQUEST = _descriptor.Descriptor(
+    name="PurgeQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.PurgeQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.PurgeQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1123,
+    serialized_end=1197,
+)
+
+
+_PAUSEQUEUEREQUEST = _descriptor.Descriptor(
+    name="PauseQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.PauseQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.PauseQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1199,
+    serialized_end=1273,
+)
+
+
+_RESUMEQUEUEREQUEST = _descriptor.Descriptor(
+    name="ResumeQueueRequest",
+    full_name="google.cloud.tasks.v2beta2.ResumeQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.ResumeQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1275,
+    serialized_end=1350,
+)
+
+
+_LISTTASKSREQUEST = _descriptor.Descriptor(
+    name="ListTasksRequest",
+    full_name="google.cloud.tasks.v2beta2.ListTasksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta2.ListTasksRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.ListTasksRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.tasks.v2beta2.ListTasksRequest.page_size",
+            index=2,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.tasks.v2beta2.ListTasksRequest.page_token",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1353,
+    serialized_end=1529,
+)
+
+
+_LISTTASKSRESPONSE = _descriptor.Descriptor(
+    name="ListTasksResponse",
+    full_name="google.cloud.tasks.v2beta2.ListTasksResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tasks",
+            full_name="google.cloud.tasks.v2beta2.ListTasksResponse.tasks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1531,
+    serialized_end=1624,
+)
+
+
+_GETTASKREQUEST = _descriptor.Descriptor(
+    name="GetTaskRequest",
+    full_name="google.cloud.tasks.v2beta2.GetTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.GetTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.GetTaskRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1627,
+    serialized_end=1759,
+)
+
+
+_CREATETASKREQUEST = _descriptor.Descriptor(
+    name="CreateTaskRequest",
+    full_name="google.cloud.tasks.v2beta2.CreateTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta2.CreateTaskRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="task",
+            full_name="google.cloud.tasks.v2beta2.CreateTaskRequest.task",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.CreateTaskRequest.response_view",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1762,
+    serialized_end=1953,
+)
+
+
+_DELETETASKREQUEST = _descriptor.Descriptor(
+    name="DeleteTaskRequest",
+    full_name="google.cloud.tasks.v2beta2.DeleteTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.DeleteTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1955,
+    serialized_end=2028,
+)
+
+
+_LEASETASKSREQUEST = _descriptor.Descriptor(
+    name="LeaseTasksRequest",
+    full_name="google.cloud.tasks.v2beta2.LeaseTasksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta2.LeaseTasksRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_tasks",
+            full_name="google.cloud.tasks.v2beta2.LeaseTasksRequest.max_tasks",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lease_duration",
+            full_name="google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.tasks.v2beta2.LeaseTasksRequest.filter",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2031,
+    serialized_end=2260,
+)
+
+
+_LEASETASKSRESPONSE = _descriptor.Descriptor(
+    name="LeaseTasksResponse",
+    full_name="google.cloud.tasks.v2beta2.LeaseTasksResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tasks",
+            full_name="google.cloud.tasks.v2beta2.LeaseTasksResponse.tasks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2262,
+    serialized_end=2331,
+)
+
+
+_ACKNOWLEDGETASKREQUEST = _descriptor.Descriptor(
+    name="AcknowledgeTaskRequest",
+    full_name="google.cloud.tasks.v2beta2.AcknowledgeTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.AcknowledgeTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta2.AcknowledgeTaskRequest.schedule_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2334,
+    serialized_end=2468,
+)
+
+
+_RENEWLEASEREQUEST = _descriptor.Descriptor(
+    name="RenewLeaseRequest",
+    full_name="google.cloud.tasks.v2beta2.RenewLeaseRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.RenewLeaseRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta2.RenewLeaseRequest.schedule_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="lease_duration",
+            full_name="google.cloud.tasks.v2beta2.RenewLeaseRequest.lease_duration",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.RenewLeaseRequest.response_view",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2471,
+    serialized_end=2718,
+)
+
+
+_CANCELLEASEREQUEST = _descriptor.Descriptor(
+    name="CancelLeaseRequest",
+    full_name="google.cloud.tasks.v2beta2.CancelLeaseRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.CancelLeaseRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta2.CancelLeaseRequest.schedule_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.CancelLeaseRequest.response_view",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2721,
+    serialized_end=2913,
+)
+
+
+_RUNTASKREQUEST = _descriptor.Descriptor(
+    name="RunTaskRequest",
+    full_name="google.cloud.tasks.v2beta2.RunTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.RunTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta2.RunTaskRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2916,
+    serialized_end=3048,
+)
+
+_LISTQUEUESRESPONSE.fields_by_name[
+    "queues"
+].message_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE
+_CREATEQUEUEREQUEST.fields_by_name[
+    "queue"
+].message_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE
+_UPDATEQUEUEREQUEST.fields_by_name[
+    "queue"
+].message_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE
+_UPDATEQUEUEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTASKSREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+_LISTTASKSRESPONSE.fields_by_name[
+    "tasks"
+].message_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK
+_GETTASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+_CREATETASKREQUEST.fields_by_name[
+    "task"
+].message_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK
+_CREATETASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+_LEASETASKSREQUEST.fields_by_name[
+    "lease_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LEASETASKSREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+_LEASETASKSRESPONSE.fields_by_name[
+    "tasks"
+].message_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK
+_ACKNOWLEDGETASKREQUEST.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_RENEWLEASEREQUEST.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_RENEWLEASEREQUEST.fields_by_name[
+    "lease_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RENEWLEASEREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+_CANCELLEASEREQUEST.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CANCELLEASEREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+_RUNTASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK_VIEW
+DESCRIPTOR.message_types_by_name["ListQueuesRequest"] = _LISTQUEUESREQUEST
+DESCRIPTOR.message_types_by_name["ListQueuesResponse"] = _LISTQUEUESRESPONSE
+DESCRIPTOR.message_types_by_name["GetQueueRequest"] = _GETQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["CreateQueueRequest"] = _CREATEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateQueueRequest"] = _UPDATEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteQueueRequest"] = _DELETEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["PurgeQueueRequest"] = _PURGEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["PauseQueueRequest"] = _PAUSEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["ResumeQueueRequest"] = _RESUMEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["ListTasksRequest"] = _LISTTASKSREQUEST
+DESCRIPTOR.message_types_by_name["ListTasksResponse"] = _LISTTASKSRESPONSE
+DESCRIPTOR.message_types_by_name["GetTaskRequest"] = _GETTASKREQUEST
+DESCRIPTOR.message_types_by_name["CreateTaskRequest"] = _CREATETASKREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTaskRequest"] = _DELETETASKREQUEST
+DESCRIPTOR.message_types_by_name["LeaseTasksRequest"] = _LEASETASKSREQUEST
+DESCRIPTOR.message_types_by_name["LeaseTasksResponse"] = _LEASETASKSRESPONSE
+DESCRIPTOR.message_types_by_name["AcknowledgeTaskRequest"] = _ACKNOWLEDGETASKREQUEST
+DESCRIPTOR.message_types_by_name["RenewLeaseRequest"] = _RENEWLEASEREQUEST
+DESCRIPTOR.message_types_by_name["CancelLeaseRequest"] = _CANCELLEASEREQUEST
+DESCRIPTOR.message_types_by_name["RunTaskRequest"] = _RUNTASKREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListQueuesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListQueuesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTQUEUESREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
+  
+  
+  Attributes:
+      parent:
+          Required. The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``
+      filter:
+          ``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://clo
+          ud.google.com/logging/docs/view/advanced_filters>`_.  Sample
+          filter "app\_engine\_http\_target: \*".  Note that using
+          filters might cause fewer queues than the requested\_page size
+          to be returned.
+      page_size:
+          Requested page size.  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.ListQue
+          uesResponse.next\_page\_token] in the response to determine if
+          more queues exist.
+      page_token:
+          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 [ne
+          xt\_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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListQueuesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListQueuesRequest)
+
+ListQueuesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListQueuesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTQUEUESRESPONSE,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Response message for
+  [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
+  
+  
+  Attributes:
+      queues:
+          The list of queues.
+      next_page_token:
+          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 [page\_token][google.cloud.tasks.v2beta
+          2.ListQueuesRequest.page\_token].  If the next\_page\_token is
+          empty, there are no more results.  The page token is valid for
+          only 2 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListQueuesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListQueuesResponse)
+
+GetQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "GetQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the queue. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.GetQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetQueueRequest)
+
+CreateQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue].
+  
+  
+  Attributes:
+      parent:
+          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.Locati
+          ons.ListLocations].
+      queue:
+          Required. The queue to create.  [Queue's
+          name][google.cloud.tasks.v2beta2.Queue.name] cannot be the
+          same as an existing queue.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.CreateQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateQueueRequest)
+
+UpdateQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue].
+  
+  
+  Attributes:
+      queue:
+          Required. The queue to create or update.  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.
+      update_mask:
+          A mask used to specify which fields of the queue are being
+          updated.  If empty, then all fields will be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.UpdateQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateQueueRequest)
+
+DeleteQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.DeleteQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteQueueRequest)
+
+PurgeQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "PurgeQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PURGEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PurgeQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(PurgeQueueRequest)
+
+PauseQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "PauseQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAUSEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PauseQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(PauseQueueRequest)
+
+ResumeQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "ResumeQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUMEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ResumeQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(ResumeQueueRequest)
+
+ListTasksRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTasksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTASKSREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for listing tasks using
+  [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+      response_view:
+          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.
+      page_size:
+          Maximum page size.  Fewer tasks than requested might be
+          returned, even if more tasks exist; use [next\_page\_token][go
+          ogle.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.
+      page_token:
+          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 [ne
+          xt\_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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListTasksRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTasksRequest)
+
+ListTasksResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTasksResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTASKSRESPONSE,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Response message for listing tasks using
+  [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
+  
+  
+  Attributes:
+      tasks:
+          The list of tasks.
+      next_page_token:
+          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 [page\_token][google.cloud.tasks.v2beta
+          2.ListTasksRequest.page\_token].  If the next\_page\_token is
+          empty, there are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListTasksResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTasksResponse)
+
+GetTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTASKREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for getting a task using
+  [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      response_view:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.GetTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTaskRequest)
+
+CreateTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETASKREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+          The queue must already exist.
+      task:
+          Required. The task to add.  Task names have the following
+          format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUE
+          UE_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].  If [schedul
+          e\_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:  Explicitly specifying a
+          task ID enables task de-duplication. If a task's ID is
+          identical to that of an existing task or a task that was
+          deleted or completed recently then the call will fail with
+          [ALREADY\_EXISTS][google.rpc.Code.ALREADY\_EXISTS]. If the
+          task's queue was created using Cloud Tasks, then another task
+          with the same name can't be created for ~1hour after the
+          original task was deleted or completed. If the task's queue
+          was created using queue.yaml or queue.xml, then another task
+          with the same name can't be created 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 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.
+      response_view:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.CreateTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTaskRequest)
+
+DeleteTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETASKREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for deleting a task using
+  [DeleteTask][google.cloud.tasks.v2beta2.CloudTasks.DeleteTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.DeleteTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTaskRequest)
+
+LeaseTasksRequest = _reflection.GeneratedProtocolMessageType(
+    "LeaseTasksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LEASETASKSREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for leasing tasks using
+  [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+      max_tasks:
+          The maximum number of tasks to lease.  The system will make a
+          best effort to return as close to as ``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.
+      lease_duration:
+          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\_ti
+          me][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.Ta
+          sk.schedule\_time].  After the worker has successfully
+          finished the work associated with the task, the worker must
+          call via [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTas
+          ks.AcknowledgeTask] before the [schedule\_time][google.cloud.t
+          asks.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.
+      response_view:
+          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.
+      filter:
+          ``filter`` can be used to specify a subset of tasks to lease.
+          When ``filter`` is set to ``tag=<my-tag>`` then the
+          [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will
+          contain only tasks whose
+          [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to
+          ``<my-tag>``. ``<my-tag>`` 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 [sch
+          edule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time]
+          will be returned.  Grammar Syntax:  -  ``filter = "tag=" tag |
+          "tag_function=" function``  -  ``tag = string``  -  ``function
+          = "oldest_tag()"``  The ``oldest_tag()`` function returns
+          tasks which have the same tag as the oldest task (ordered by
+          schedule time).  SDK compatibility: Although the SDK allows
+          tags to be either string or `bytes <https://cloud.google.com/a
+          ppengine/docs/standard/java/javadoc/com/google/appengine/api/t
+          askqueue/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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.LeaseTasksRequest)
+    ),
+)
+_sym_db.RegisterMessage(LeaseTasksRequest)
+
+LeaseTasksResponse = _reflection.GeneratedProtocolMessageType(
+    "LeaseTasksResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LEASETASKSRESPONSE,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Response message for leasing tasks using
+  [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
+  
+  
+  Attributes:
+      tasks:
+          The leased tasks.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.LeaseTasksResponse)
+    ),
+)
+_sym_db.RegisterMessage(LeaseTasksResponse)
+
+AcknowledgeTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "AcknowledgeTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ACKNOWLEDGETASKREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for acknowledging a task using
+  [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      schedule_time:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AcknowledgeTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(AcknowledgeTaskRequest)
+
+RenewLeaseRequest = _reflection.GeneratedProtocolMessageType(
+    "RenewLeaseRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RENEWLEASEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for renewing a lease using
+  [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      schedule_time:
+          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.
+      lease_duration:
+          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.
+      response_view:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RenewLeaseRequest)
+    ),
+)
+_sym_db.RegisterMessage(RenewLeaseRequest)
+
+CancelLeaseRequest = _reflection.GeneratedProtocolMessageType(
+    "CancelLeaseRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CANCELLEASEREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for canceling a lease using
+  [CancelLease][google.cloud.tasks.v2beta2.CloudTasks.CancelLease].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      schedule_time:
+          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.
+      response_view:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.CancelLeaseRequest)
+    ),
+)
+_sym_db.RegisterMessage(CancelLeaseRequest)
+
+RunTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "RunTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNTASKREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2",
+        __doc__="""Request message for forcing a task to run now using
+  [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      response_view:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RunTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunTaskRequest)
+
+
+DESCRIPTOR._options = None
+_LISTQUEUESREQUEST.fields_by_name["parent"]._options = None
+_GETQUEUEREQUEST.fields_by_name["name"]._options = None
+_CREATEQUEUEREQUEST.fields_by_name["parent"]._options = None
+_CREATEQUEUEREQUEST.fields_by_name["queue"]._options = None
+_UPDATEQUEUEREQUEST.fields_by_name["queue"]._options = None
+_DELETEQUEUEREQUEST.fields_by_name["name"]._options = None
+_PURGEQUEUEREQUEST.fields_by_name["name"]._options = None
+_PAUSEQUEUEREQUEST.fields_by_name["name"]._options = None
+_RESUMEQUEUEREQUEST.fields_by_name["name"]._options = None
+_LISTTASKSREQUEST.fields_by_name["parent"]._options = None
+_GETTASKREQUEST.fields_by_name["name"]._options = None
+_CREATETASKREQUEST.fields_by_name["parent"]._options = None
+_CREATETASKREQUEST.fields_by_name["task"]._options = None
+_DELETETASKREQUEST.fields_by_name["name"]._options = None
+_LEASETASKSREQUEST.fields_by_name["parent"]._options = None
+_LEASETASKSREQUEST.fields_by_name["lease_duration"]._options = None
+_ACKNOWLEDGETASKREQUEST.fields_by_name["name"]._options = None
+_ACKNOWLEDGETASKREQUEST.fields_by_name["schedule_time"]._options = None
+_RENEWLEASEREQUEST.fields_by_name["name"]._options = None
+_RENEWLEASEREQUEST.fields_by_name["schedule_time"]._options = None
+_RENEWLEASEREQUEST.fields_by_name["lease_duration"]._options = None
+_CANCELLEASEREQUEST.fields_by_name["name"]._options = None
+_CANCELLEASEREQUEST.fields_by_name["schedule_time"]._options = None
+_RUNTASKREQUEST.fields_by_name["name"]._options = None
+
+_CLOUDTASKS = _descriptor.ServiceDescriptor(
+    name="CloudTasks",
+    full_name="google.cloud.tasks.v2beta2.CloudTasks",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=3051,
+    serialized_end=6719,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListQueues",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.ListQueues",
+            index=0,
+            containing_service=None,
+            input_type=_LISTQUEUESREQUEST,
+            output_type=_LISTQUEUESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v2beta2/{parent=projects/*/locations/*}/queues\332A\006parent"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.GetQueue",
+            index=1,
+            containing_service=None,
+            input_type=_GETQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.CreateQueue",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\0028"//v2beta2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                "\202\323\344\223\002>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEQUEUEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PurgeQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue",
+            index=5,
+            containing_service=None,
+            input_type=_PURGEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PauseQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.PauseQueue",
+            index=6,
+            containing_service=None,
+            input_type=_PAUSEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ResumeQueue",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue",
+            index=7,
+            containing_service=None,
+            input_type=_RESUMEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.GetIamPolicy",
+            index=8,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.SetIamPolicy",
+            index=9,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.TestIamPermissions",
+            index=10,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTasks",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.ListTasks",
+            index=11,
+            containing_service=None,
+            input_type=_LISTTASKSREQUEST,
+            output_type=_LISTTASKSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0029\0227/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTask",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.GetTask",
+            index=12,
+            containing_service=None,
+            input_type=_GETTASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                "\202\323\344\223\0029\0227/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTask",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.CreateTask",
+            index=13,
+            containing_service=None,
+            input_type=_CREATETASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTask",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.DeleteTask",
+            index=14,
+            containing_service=None,
+            input_type=_DELETETASKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0029*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="LeaseTasks",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks",
+            index=15,
+            containing_service=None,
+            input_type=_LEASETASKSREQUEST,
+            output_type=_LEASETASKSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\001*\332A\025parent,lease_duration'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AcknowledgeTask",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask",
+            index=16,
+            containing_service=None,
+            input_type=_ACKNOWLEDGETASKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\001*\332A\022name,schedule_time'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RenewLease",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.RenewLease",
+            index=17,
+            containing_service=None,
+            input_type=_RENEWLEASEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\001*\332A!name,schedule_time,lease_duration'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CancelLease",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.CancelLease",
+            index=18,
+            containing_service=None,
+            input_type=_CANCELLEASEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\001*\332A\022name,schedule_time'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunTask",
+            full_name="google.cloud.tasks.v2beta2.CloudTasks.RunTask",
+            index=19,
+            containing_service=None,
+            input_type=_RUNTASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDTASKS)
+
+DESCRIPTOR.services_by_name["CloudTasks"] = _CLOUDTASKS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py
new file mode 100644
index 000000000000..040424a35c9e
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py
@@ -0,0 +1,555 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.tasks_v2beta2.proto import (
+    cloudtasks_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2,
+)
+from google.cloud.tasks_v2beta2.proto import (
+    queue_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2,
+)
+from google.cloud.tasks_v2beta2.proto import (
+    task_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class CloudTasksStub(object):
+    """Cloud Tasks allows developers to manage the execution of background
+  work in their applications.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListQueues = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/ListQueues",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.FromString,
+        )
+        self.GetQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/GetQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.CreateQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/CreateQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.UpdateQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/UpdateQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.DeleteQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/DeleteQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.PurgeQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/PurgeQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.PauseQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/PauseQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.ResumeQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/ResumeQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+        self.ListTasks = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/ListTasks",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.FromString,
+        )
+        self.GetTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/GetTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.CreateTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/CreateTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.DeleteTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/DeleteTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.LeaseTasks = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/LeaseTasks",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.LeaseTasksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.LeaseTasksResponse.FromString,
+        )
+        self.AcknowledgeTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/AcknowledgeTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.AcknowledgeTaskRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RenewLease = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/RenewLease",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.RenewLeaseRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.CancelLease = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/CancelLease",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CancelLeaseRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.RunTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta2.CloudTasks/RunTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString,
+        )
+
+
+class CloudTasksServicer(object):
+    """Cloud Tasks allows developers to manage the execution of background
+  work in their applications.
+  """
+
+    def ListQueues(self, request, context):
+        """Lists queues.
+
+    Queues are returned in lexicographical order.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetQueue(self, request, context):
+        """Gets a queue.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateQueue(self, request, context):
+        """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.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateQueue(self, request, context):
+        """Updates a queue.
+
+    This method creates the queue if it does not exist and updates
+    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.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteQueue(self, request, context):
+        """Deletes a queue.
+
+    This command will delete the queue even if it has tasks in it.
+
+    Note: If you delete a queue, a queue with the same name can't be created
+    for 7 days.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PurgeQueue(self, request, context):
+        """Purges a queue by deleting all of its tasks.
+
+    All tasks created before this method is called are permanently deleted.
+
+    Purge operations can take up to one minute to take effect. Tasks
+    might be dispatched before the purge takes effect. A purge is irreversible.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PauseQueue(self, request, context):
+        """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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ResumeQueue(self, request, context):
+        """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].
+
+    WARNING: Resuming many high-QPS queues at the same time can
+    lead to target overloading. If you are resuming high-QPS
+    queues, follow the 500/50/5 pattern described in
+    [Managing Cloud Tasks Scaling
+    Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """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`
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """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.
+
+    Authorization requires the following
+    [Google IAM](https://cloud.google.com/iam) permission on the specified
+    resource parent:
+
+    * `cloudtasks.queues.setIamPolicy`
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTasks(self, request, context):
+        """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.
+
+    The tasks may be returned in any order. The ordering may change at any
+    time.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTask(self, request, context):
+        """Gets a task.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTask(self, request, context):
+        """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
+    100KB.
+    * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum task size is 1MB.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTask(self, request, context):
+        """Deletes a task.
+
+    A task can be deleted if it is scheduled or dispatched. A task
+    cannot be deleted if it has completed successfully or permanently
+    failed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def LeaseTasks(self, request, context):
+        """Leases tasks from a pull queue for
+    [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration].
+
+    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]
+    is returned when this limit is
+    exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED]
+    is also returned when
+    [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second]
+    is exceeded.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AcknowledgeTask(self, request, context):
+        """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.
+
+    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
+    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
+    [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RenewLease(self, request, context):
+        """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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CancelLease(self, request, context):
+        """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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunTask(self, request, context):
+        """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].
+
+    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.
+
+    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.
+
+    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].
+
+    [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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudTasksServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListQueues": grpc.unary_unary_rpc_method_handler(
+            servicer.ListQueues,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.SerializeToString,
+        ),
+        "GetQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.GetQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "CreateQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "UpdateQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "DeleteQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PurgeQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.PurgeQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "PauseQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.PauseQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "ResumeQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.ResumeQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "ListTasks": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTasks,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.SerializeToString,
+        ),
+        "GetTask": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "CreateTask": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "DeleteTask": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "LeaseTasks": grpc.unary_unary_rpc_method_handler(
+            servicer.LeaseTasks,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.LeaseTasksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.LeaseTasksResponse.SerializeToString,
+        ),
+        "AcknowledgeTask": grpc.unary_unary_rpc_method_handler(
+            servicer.AcknowledgeTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.AcknowledgeTaskRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RenewLease": grpc.unary_unary_rpc_method_handler(
+            servicer.RenewLease,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.RenewLeaseRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "CancelLease": grpc.unary_unary_rpc_method_handler(
+            servicer.CancelLease,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CancelLeaseRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "RunTask": grpc.unary_unary_rpc_method_handler(
+            servicer.RunTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.tasks.v2beta2.CloudTasks", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/queue.proto b/tasks/google/cloud/tasks_v2beta2/proto/queue.proto
new file mode 100644
index 000000000000..212ab7384cc5
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/queue.proto
@@ -0,0 +1,370 @@
+// 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.tasks.v2beta2;
+
+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;
+option java_outer_classname = "QueueProto";
+option java_package = "com.google.cloud.tasks.v2beta2";
+
+// A queue is a container of related tasks. Queues are configured to manage
+// 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.
+    STATE_UNSPECIFIED = 0;
+
+    // The queue is running. Tasks can be dispatched.
+    //
+    // If the queue was created using Cloud Tasks and the queue has
+    // had no activity (method calls or task dispatches) for 30 days,
+    // the queue may take a few minutes to re-activate. Some method
+    // calls may return [NOT_FOUND][google.rpc.Code.NOT_FOUND] and
+    // tasks may not be dispatched for a few minutes until the queue
+    // has been re-activated.
+    RUNNING = 1;
+
+    // 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].
+    PAUSED = 2;
+
+    // The queue is disabled.
+    //
+    // A queue becomes `DISABLED` when
+    // [queue.yaml](https://cloud.google.com/appengine/docs/python/config/queueref)
+    // or
+    // [queue.xml](https://cloud.google.com/appengine/docs/standard/java/config/queueref)
+    // is uploaded which does not contain the queue. You cannot directly disable
+    // a 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.
+    //
+    // 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.
+  //
+  // The queue name.
+  //
+  // The queue name must have the following format:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the queue's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+  //   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.
+  //
+  // The queue's target.
+  //
+  // The target applies to all tasks in the queue.
+  oneof target_type {
+    // App Engine HTTP target.
+    //
+    // 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].
+    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
+  // attempted in different ways:
+  //
+  // * [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
+  //   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).
+  RateLimits rate_limits = 5;
+
+  // Settings that determine the retry behavior.
+  //
+  // * For tasks created using Cloud Tasks: the queue-level retry settings
+  //   apply to all tasks in the queue that were created using Cloud Tasks.
+  //   Retry settings cannot be set on individual tasks.
+  // * For tasks created using the App Engine SDK: the queue-level retry
+  //   settings apply to all tasks in the queue which do not have retry settings
+  //   explicitly set on the task and were created by the App Engine SDK. See
+  //   [App Engine
+  //   documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
+  RetryConfig retry_config = 6;
+
+  // Output only. The state of the queue.
+  //
+  // `state` can only be changed by called
+  // [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue],
+  // [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`.
+  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.
+  //
+  // 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
+  // time will be unset if the queue has never been purged.
+  google.protobuf.Timestamp purge_time = 8;
+}
+
+// Rate limits.
+//
+// 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].
+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
+  //   is 500.
+  // * 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.
+  //
+  //
+  // This field has the same meaning as
+  // [rate in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
+  double max_tasks_dispatched_per_second = 1;
+
+  // Output only. The max burst size.
+  //
+  // Max burst size limits how fast tasks in queue are processed when
+  // many tasks are in the queue and the rate is high. This field
+  // allows the queue to have a high rate so processing starts shortly
+  // after a task is enqueued, but still limits resource usage when
+  // many tasks are enqueued in a short period of time.
+  //
+  // The [token bucket](https://wikipedia.org/wiki/Token_Bucket)
+  // algorithm is used to control the rate of task dispatches. Each
+  // queue has a token bucket that holds tokens, up to the maximum
+  // specified by `max_burst_size`. Each time a task is dispatched, a
+  // token is removed from the bucket. Tasks will be dispatched until
+  // the queue's bucket runs out of tokens. The bucket will be
+  // continuously refilled with new tokens based on
+  // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second].
+  //
+  // Cloud Tasks will pick the value of `max_burst_size` based on the
+  // value of
+  // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second].
+  //
+  // For App Engine 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
+  // [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]
+  // is updated.
+  //
+  int32 max_burst_size = 2;
+
+  // The maximum number of concurrent tasks that Cloud Tasks allows
+  // to be dispatched for this queue. After this threshold has been
+  // reached, Cloud Tasks stops dispatching tasks until the number of
+  // concurrent requests decreases.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // 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.
+  //
+  //
+  // This field has the same meaning as
+  // [max_concurrent_requests in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#max_concurrent_requests).
+  int32 max_concurrent_tasks = 3;
+}
+
+// Retry config.
+//
+// These settings determine how a failed task attempt is retried.
+message RetryConfig {
+  // Number of attempts per task.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  //
+  // This field has the same meaning as
+  // [task_retry_limit in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  oneof num_attempts {
+    // The maximum number of attempts for a task.
+    //
+    // Cloud Tasks will attempt the task `max_attempts` times (that
+    // is, if the first attempt fails, then there will be
+    // `max_attempts - 1` retries).  Must be > 0.
+    int32 max_attempts = 1;
+
+    // If true, then the number of attempts is unlimited.
+    bool unlimited_attempts = 2;
+  }
+
+  // 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.
+  //
+  // 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].
+  //
+  //
+  // `max_retry_duration` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [task_age_limit in
+  // 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
+  // [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.
+  //
+  // 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].
+  //
+  //
+  // `min_backoff` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [min_backoff_seconds in
+  // 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
+  // [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.
+  //
+  // 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].
+  //
+  //
+  // `max_backoff` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [max_backoff_seconds in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration max_backoff = 5;
+
+  // 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
+  // [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, ....
+  //
+  // 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 has the same meaning as
+  // [max_doublings in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  int32 max_doublings = 6;
+}
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py
new file mode 100644
index 000000000000..5fd3fd185df3
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2.py
@@ -0,0 +1,782 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta2/proto/queue.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2beta2.proto import (
+    target_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta2/proto/queue.proto",
+    package="google.cloud.tasks.v2beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta2B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/tasks_v2beta2/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xbf\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Q\n\x16\x61pp_engine_http_target\x18\x03 \x01(\x0b\x32/.google.cloud.tasks.v2beta2.AppEngineHttpTargetH\x00\x12=\n\x0bpull_target\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.PullTargetH\x00\x12;\n\x0brate_limits\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.RateLimits\x12=\n\x0cretry_config\x18\x06 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.RetryConfig\x12\x36\n\x05state\x18\x07 \x01(\x0e\x32\'.google.cloud.tasks.v2beta2.Queue.State\x12.\n\npurge_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\r\n\x0btarget_type"k\n\nRateLimits\x12\'\n\x1fmax_tasks_dispatched_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12\x1c\n\x14max_concurrent_tasks\x18\x03 \x01(\x05"\x81\x02\n\x0bRetryConfig\x12\x16\n\x0cmax_attempts\x18\x01 \x01(\x05H\x00\x12\x1c\n\x12unlimited_attempts\x18\x02 \x01(\x08H\x00\x12\x35\n\x12max_retry_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x06 \x01(\x05\x42\x0e\n\x0cnum_attemptsBo\n\x1e\x63om.google.cloud.tasks.v2beta2B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_QUEUE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.tasks.v2beta2.Queue.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=643,
+    serialized_end=712,
+)
+_sym_db.RegisterEnumDescriptor(_QUEUE_STATE)
+
+
+_QUEUE = _descriptor.Descriptor(
+    name="Queue",
+    full_name="google.cloud.tasks.v2beta2.Queue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.Queue.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_target",
+            full_name="google.cloud.tasks.v2beta2.Queue.app_engine_http_target",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pull_target",
+            full_name="google.cloud.tasks.v2beta2.Queue.pull_target",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rate_limits",
+            full_name="google.cloud.tasks.v2beta2.Queue.rate_limits",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="retry_config",
+            full_name="google.cloud.tasks.v2beta2.Queue.retry_config",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.tasks.v2beta2.Queue.state",
+            index=5,
+            number=7,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="purge_time",
+            full_name="google.cloud.tasks.v2beta2.Queue.purge_time",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_QUEUE_STATE],
+    serialized_options=_b(
+        "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}"
+    ),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target_type",
+            full_name="google.cloud.tasks.v2beta2.Queue.target_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=246,
+    serialized_end=821,
+)
+
+
+_RATELIMITS = _descriptor.Descriptor(
+    name="RateLimits",
+    full_name="google.cloud.tasks.v2beta2.RateLimits",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_tasks_dispatched_per_second",
+            full_name="google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_burst_size",
+            full_name="google.cloud.tasks.v2beta2.RateLimits.max_burst_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_concurrent_tasks",
+            full_name="google.cloud.tasks.v2beta2.RateLimits.max_concurrent_tasks",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=823,
+    serialized_end=930,
+)
+
+
+_RETRYCONFIG = _descriptor.Descriptor(
+    name="RetryConfig",
+    full_name="google.cloud.tasks.v2beta2.RetryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_attempts",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.max_attempts",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="unlimited_attempts",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.unlimited_attempts",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_retry_duration",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.max_retry_duration",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_backoff",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.min_backoff",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_backoff",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.max_backoff",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_doublings",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.max_doublings",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="num_attempts",
+            full_name="google.cloud.tasks.v2beta2.RetryConfig.num_attempts",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=933,
+    serialized_end=1190,
+)
+
+_QUEUE.fields_by_name[
+    "app_engine_http_target"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2._APPENGINEHTTPTARGET
+)
+_QUEUE.fields_by_name[
+    "pull_target"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2._PULLTARGET
+)
+_QUEUE.fields_by_name["rate_limits"].message_type = _RATELIMITS
+_QUEUE.fields_by_name["retry_config"].message_type = _RETRYCONFIG
+_QUEUE.fields_by_name["state"].enum_type = _QUEUE_STATE
+_QUEUE.fields_by_name[
+    "purge_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_QUEUE_STATE.containing_type = _QUEUE
+_QUEUE.oneofs_by_name["target_type"].fields.append(
+    _QUEUE.fields_by_name["app_engine_http_target"]
+)
+_QUEUE.fields_by_name[
+    "app_engine_http_target"
+].containing_oneof = _QUEUE.oneofs_by_name["target_type"]
+_QUEUE.oneofs_by_name["target_type"].fields.append(_QUEUE.fields_by_name["pull_target"])
+_QUEUE.fields_by_name["pull_target"].containing_oneof = _QUEUE.oneofs_by_name[
+    "target_type"
+]
+_RETRYCONFIG.fields_by_name[
+    "max_retry_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "min_backoff"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "max_backoff"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.oneofs_by_name["num_attempts"].fields.append(
+    _RETRYCONFIG.fields_by_name["max_attempts"]
+)
+_RETRYCONFIG.fields_by_name[
+    "max_attempts"
+].containing_oneof = _RETRYCONFIG.oneofs_by_name["num_attempts"]
+_RETRYCONFIG.oneofs_by_name["num_attempts"].fields.append(
+    _RETRYCONFIG.fields_by_name["unlimited_attempts"]
+)
+_RETRYCONFIG.fields_by_name[
+    "unlimited_attempts"
+].containing_oneof = _RETRYCONFIG.oneofs_by_name["num_attempts"]
+DESCRIPTOR.message_types_by_name["Queue"] = _QUEUE
+DESCRIPTOR.message_types_by_name["RateLimits"] = _RATELIMITS
+DESCRIPTOR.message_types_by_name["RetryConfig"] = _RETRYCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Queue = _reflection.GeneratedProtocolMessageType(
+    "Queue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUEUE,
+        __module__="google.cloud.tasks_v2beta2.proto.queue_pb2",
+        __doc__="""A queue is a container of related tasks. Queues are configured to manage
+  how those tasks are dispatched. Configurable properties include rate
+  limits, retry options, target types, and others.
+  
+  
+  Attributes:
+      name:
+          Caller-specified and required in [CreateQueue][google.cloud.ta
+          sks.v2beta2.CloudTasks.CreateQueue], after which it becomes
+          output only.  The queue name.  The queue name must have the
+          following format:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+          -  ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`_ -  ``LOCATION_ID``
+          is the canonical ID for the queue's location. The    list of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``QUEUE_ID`` can
+          contain letters ([A-Za-z]), numbers ([0-9]), or    hyphens
+          (-). The maximum length is 100 characters.
+      target_type:
+          Caller-specified and required in [CreateQueue][google.cloud.ta
+          sks.v2beta2.CloudTasks.CreateQueue][], after which the queue
+          config type becomes output only, though fields within the
+          config are mutable.  The queue's target.  The target applies
+          to all tasks in the queue.
+      app_engine_http_target:
+          App Engine HTTP target.  An App Engine queue is a queue that
+          has an [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEng
+          ineHttpTarget].
+      pull_target:
+          Pull target.  A pull queue is a queue that has a
+          [PullTarget][google.cloud.tasks.v2beta2.PullTarget].
+      rate_limits:
+          Rate limits for task dispatches.
+          [rate\_limits][google.cloud.tasks.v2beta2.Queue.rate\_limits]
+          and [retry\_config][google.cloud.tasks.v2beta2.Queue.retry\_co
+          nfig] 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 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 particular a task after its first
+          attempt    fails. That is,    [retry\_config][google.cloud.tas
+          ks.v2beta2.Queue.retry\_config]    controls task retries (the
+          second attempt, third attempt, etc).
+      retry_config:
+          Settings that determine the retry behavior.  -  For tasks
+          created using Cloud Tasks: the queue-level retry settings
+          apply to all tasks in the queue that were created using Cloud
+          Tasks.    Retry settings cannot be set on individual tasks. -
+          For tasks created using the App Engine SDK: the queue-level
+          retry    settings apply to all tasks in the queue which do not
+          have retry    settings explicitly set on the task and were
+          created by the App    Engine SDK. See `App Engine
+          documentation <https://cloud.google.com/appengine/docs/standar
+          d/python/taskqueue/push/retrying-tasks>`_.
+      state:
+          Output only. The state of the queue.  ``state`` can only be
+          changed by called [PauseQueue][google.cloud.tasks.v2beta2.Clou
+          dTasks.PauseQueue], [ResumeQueue][google.cloud.tasks.v2beta2.C
+          loudTasks.ResumeQueue], or uploading `queue.yaml/xml <https://
+          cloud.google.com/appengine/docs/python/config/queueref>`_. [U
+          pdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue]
+          cannot be used to change ``state``.
+      purge_time:
+          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.  A queue can be purged using [PurgeQueu
+          e][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue], the `App
+          Engine Task Queue SDK, or the Cloud Console <https://cloud.goo
+          gle.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 time
+          will be unset if the queue has never been purged.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.Queue)
+    ),
+)
+_sym_db.RegisterMessage(Queue)
+
+RateLimits = _reflection.GeneratedProtocolMessageType(
+    "RateLimits",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RATELIMITS,
+        __module__="google.cloud.tasks_v2beta2.proto.queue_pb2",
+        __doc__="""Rate limits.
+  
+  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].
+  
+  
+  Attributes:
+      max_tasks_dispatched_per_second:
+          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 is 500. -  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.  This field has the same
+          meaning as `rate in queue.yaml/xml <https://cloud.google.com/a
+          ppengine/docs/standard/python/config/queueref#rate>`_.
+      max_burst_size:
+          Output only. The max burst size.  Max burst size limits how
+          fast tasks in queue are processed when many tasks are in the
+          queue and the rate is high. This field allows the queue to
+          have a high rate so processing starts shortly after a task is
+          enqueued, but still limits resource usage when many tasks are
+          enqueued in a short period of time.  The `token bucket
+          <https://wikipedia.org/wiki/Token_Bucket>`_ algorithm is used
+          to control the rate of task dispatches. Each queue has a token
+          bucket that holds tokens, up to the maximum specified by
+          ``max_burst_size``. Each time a task is dispatched, a token is
+          removed from the bucket. Tasks will be dispatched until the
+          queue's bucket runs out of tokens. The bucket will be
+          continuously refilled with new tokens based on [max\_tasks\_di
+          spatched\_per\_second][google.cloud.tasks.v2beta2.RateLimits.m
+          ax\_tasks\_dispatched\_per\_second].  Cloud Tasks will pick
+          the value of ``max_burst_size`` based on the value of [max\_ta
+          sks\_dispatched\_per\_second][google.cloud.tasks.v2beta2.RateL
+          imits.max\_tasks\_dispatched\_per\_second].  For App Engine
+          queues that were created or updated using ``queue.yaml/xml``,
+          ``max_burst_size`` is equal to `bucket\_size <https://cloud.go
+          ogle.com/appengine/docs/standard/python/config/queueref#bucket
+          _size>`_. Since ``max_burst_size`` is output only, if [Update
+          Queue][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\_t
+          asks\_dispatched\_per\_second][google.cloud.tasks.v2beta2.Rate
+          Limits.max\_tasks\_dispatched\_per\_second], regardless of
+          whether [max\_tasks\_dispatched\_per\_second][google.cloud.tas
+          ks.v2beta2.RateLimits.max\_tasks\_dispatched\_per\_second] is
+          updated.
+      max_concurrent_tasks:
+          The maximum number of concurrent tasks that Cloud Tasks allows
+          to be dispatched for this queue. After this threshold has been
+          reached, Cloud Tasks stops dispatching tasks until the number
+          of concurrent requests decreases.  If unspecified when the
+          queue is created, Cloud Tasks will pick the default.  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.  This field has the
+          same meaning as `max\_concurrent\_requests in queue.yaml/xml
+          <https://cloud.google.com/appengine/docs/standard/python/config
+          /queueref#max_concurrent_requests>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RateLimits)
+    ),
+)
+_sym_db.RegisterMessage(RateLimits)
+
+RetryConfig = _reflection.GeneratedProtocolMessageType(
+    "RetryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RETRYCONFIG,
+        __module__="google.cloud.tasks_v2beta2.proto.queue_pb2",
+        __doc__="""Retry config.
+  
+  These settings determine how a failed task attempt is retried.
+  
+  
+  Attributes:
+      num_attempts:
+          Number of attempts per task.  If unspecified when the queue is
+          created, Cloud Tasks will pick the default.  This field has
+          the same meaning as `task\_retry\_limit in queue.yaml/xml <htt
+          ps://cloud.google.com/appengine/docs/standard/python/config/qu
+          eueref#retry_parameters>`_.
+      max_attempts:
+          The maximum number of attempts for a task.  Cloud Tasks will
+          attempt the task ``max_attempts`` times (that is, if the first
+          attempt fails, then there will be ``max_attempts - 1``
+          retries). Must be > 0.
+      unlimited_attempts:
+          If true, then the number of attempts is unlimited.
+      max_retry_duration:
+          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.  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].
+          ``max_retry_duration`` will be truncated to the nearest
+          second.  This field has the same meaning as `task\_age\_limit
+          in queue.yaml/xml <https://cloud.google.com/appengine/docs/sta
+          ndard/python/config/queueref#retry_parameters>`_.
+      min_backoff:
+          A task will be
+          [scheduled][google.cloud.tasks.v2beta2.Task.schedule\_time]
+          for retry between [min\_backoff][google.cloud.tasks.v2beta2.Re
+          tryConfig.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.  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].
+          ``min_backoff`` will be truncated to the nearest second.  This
+          field has the same meaning as `min\_backoff\_seconds in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_backoff:
+          A task will be
+          [scheduled][google.cloud.tasks.v2beta2.Task.schedule\_time]
+          for retry between [min\_backoff][google.cloud.tasks.v2beta2.Re
+          tryConfig.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.  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].
+          ``max_backoff`` will be truncated to the nearest second.  This
+          field has the same meaning as `max\_backoff\_seconds in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_doublings:
+          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 [max\_backoff][google.cloud.ta
+          sks.v2beta2.RetryConfig.max\_backoff] up to [max\_attempts][go
+          ogle.cloud.tasks.v2beta2.RetryConfig.max\_attempts] times.
+          For example, if [min\_backoff][google.cloud.tasks.v2beta2.Retr
+          yConfig.min\_backoff] is 10s, [max\_backoff][google.cloud.task
+          s.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.Retr
+          yConfig.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
+          has the same meaning as `max\_doublings in queue.yaml/xml <htt
+          ps://cloud.google.com/appengine/docs/standard/python/config/qu
+          eueref#retry_parameters>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RetryConfig)
+    ),
+)
+_sym_db.RegisterMessage(RetryConfig)
+
+
+DESCRIPTOR._options = None
+_QUEUE._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/target.proto b/tasks/google/cloud/tasks_v2beta2/proto/target.proto
new file mode 100644
index 000000000000..decdbaf8b791
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/target.proto
@@ -0,0 +1,382 @@
+// 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.tasks.v2beta2;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks";
+option java_multiple_files = true;
+option java_outer_classname = "TargetProto";
+option java_package = "com.google.cloud.tasks.v2beta2";
+
+// Pull target.
+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.
+//
+// This proto can only be used for tasks in a queue which has
+// [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] set.
+message PullMessage {
+  // A data payload consumed by the worker to execute the task.
+  bytes payload = 1;
+
+  // The task's tag.
+  //
+  // 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.
+  //
+  // The task's tag can only be set when the
+  // [task is created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+  //
+  // The tag must be less than 500 characters.
+  //
+  // SDK compatibility: Although the SDK allows tags to be either
+  // string or
+  // [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. If a tag isn't UTF-8
+  // encoded, the tag will be empty when the task is returned by Cloud Tasks.
+  string tag = 2;
+}
+
+// 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.
+//
+// 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:
+//
+// `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].
+  //
+  // 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].
+  AppEngineRouting app_engine_routing_override = 1;
+}
+
+// App Engine HTTP request.
+//
+// The message defines the HTTP request that is sent to an App Engine app when
+// 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.
+//
+// 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:
+//
+// `https://www.googleapis.com/auth/cloud-platform`
+//
+// The task will be delivered to the App Engine app which belongs to the same
+// project as the queue. For more information, see
+// [How Requests are
+// Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+// 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:
+//
+// * 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].
+//
+//
+// The `url` that the task will be sent to is:
+//
+// * `url =` [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] `+`
+//   [relative_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.relative_url]
+//
+// 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.
+  //
+  // The app's request handler for the task's target URL must be able to handle
+  // HTTP requests with this http_method, otherwise the task attempt will fail
+  // with error code 405 (Method Not Allowed). See
+  // [Writing a push task request
+  // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+  // and the documentation for the request handlers in the language your app is
+  // written in e.g.
+  // [Python Request
+  // Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+  HttpMethod http_method = 1;
+
+  // Task-level setting for App Engine routing.
+  //
+  // 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].
+  AppEngineRouting app_engine_routing = 2;
+
+  // The relative URL.
+  //
+  // The relative URL must begin with "/" and must be a valid HTTP relative URL.
+  // It can contain a path and query string arguments.
+  // If the relative URL is empty, then the root path "/" will be used.
+  // No spaces are allowed, and the maximum length allowed is 2083 characters.
+  string relative_url = 3;
+
+  // HTTP request headers.
+  //
+  // This map contains the header field names and values.
+  // Headers can be set when the
+  // [task is created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+  // Repeated headers are not supported but a header value can contain commas.
+  //
+  // Cloud Tasks sets some headers to default values:
+  //
+  // * `User-Agent`: By default, this header is
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+  //   This header can be modified, but Cloud Tasks will append
+  //   `"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
+  // Tasks sets the following headers:
+  //
+  // * `Content-Type`: By default, the `Content-Type` header is set to
+  //   `"application/octet-stream"`. The default can be overridden by explicitly
+  //   setting `Content-Type` to a particular media type when the
+  //   [task is created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+  //   For example, `Content-Type` can be set to `"application/json"`.
+  // * `Content-Length`: This is computed by Cloud Tasks. This value is
+  //   output only.   It cannot be changed.
+  //
+  // The headers below cannot be set or overridden:
+  //
+  // * `Host`
+  // * `X-Google-*`
+  // * `X-AppEngine-*`
+  //
+  // 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).
+  // 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.
+  //
+  // 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.
+  map<string, string> headers = 4;
+
+  // Payload.
+  //
+  // The payload will be sent as the HTTP message body. A message
+  // body, and thus a payload, is allowed only if the HTTP method is
+  // POST or PUT. It is an error to set a data payload on a task with
+  // an incompatible [HttpMethod][google.cloud.tasks.v2beta2.HttpMethod].
+  bytes payload = 5;
+}
+
+// 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),
+// [Microservices Architecture on Google App
+// Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+// [App Engine Standard request
+// 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).
+message AppEngineRouting {
+  // App service.
+  //
+  // By default, the task is sent to the service which is the default
+  // 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],
+  // [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],
+  // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the empty string.
+  string service = 1;
+
+  // App version.
+  //
+  // By default, the task is sent to the version which is the default
+  // 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],
+  // [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],
+  // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the empty string.
+  string version = 2;
+
+  // App instance.
+  //
+  // By default, the task is sent to an instance which is available when
+  // the task is attempted.
+  //
+  // Requests can only be sent to a specific instance if
+  // [manual scaling is used in App Engine
+  // Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+  // App Engine Flex does not support instances. For more information, see
+  // [App Engine Standard request
+  // 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).
+  string instance = 3;
+
+  // Output only. The host that the task is sent to.
+  //
+  // For more information, see
+  // [How Requests are
+  // Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+  //
+  // The host is constructed as:
+  //
+  //
+  // * `host = [application_domain_name]`</br>
+  //   `| [service] + '.' + [application_domain_name]`</br>
+  //   `| [version] + '.' + [application_domain_name]`</br>
+  //   `| [version_dot_service]+ '.' + [application_domain_name]`</br>
+  //   `| [instance] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_service] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_version] + '.' + [application_domain_name]`</br>
+  //   `| [instance_dot_version_dot_service] + '.' + [application_domain_name]`
+  //
+  // * `application_domain_name` = The domain name of the app, for
+  //   example <app-id>.appspot.com, which is associated with the
+  //   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]
+  //
+  // * `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_dot_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_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]
+  //
+  // 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 [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.
+  string host = 4;
+}
+
+// The HTTP method used to execute the task.
+enum HttpMethod {
+  // HTTP method unspecified
+  HTTP_METHOD_UNSPECIFIED = 0;
+
+  // HTTP POST
+  POST = 1;
+
+  // HTTP GET
+  GET = 2;
+
+  // HTTP HEAD
+  HEAD = 3;
+
+  // HTTP PUT
+  PUT = 4;
+
+  // HTTP DELETE
+  DELETE = 5;
+}
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py
new file mode 100644
index 000000000000..85413eb533af
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/target_pb2.py
@@ -0,0 +1,856 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta2/proto/target.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta2/proto/target.proto",
+    package="google.cloud.tasks.v2beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta2B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/tasks_v2beta2/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto"\x0c\n\nPullTarget"+\n\x0bPullMessage\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x0b\n\x03tag\x18\x02 \x01(\t"h\n\x13\x41ppEngineHttpTarget\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting"\xc4\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta2.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting\x12\x14\n\x0crelative_url\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry\x12\x0f\n\x07payload\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t*[\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x42p\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_HTTPMETHOD = _descriptor.EnumDescriptor(
+    name="HttpMethod",
+    full_name="google.cloud.tasks.v2beta2.HttpMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GET", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEAD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=685,
+    serialized_end=776,
+)
+_sym_db.RegisterEnumDescriptor(_HTTPMETHOD)
+
+HttpMethod = enum_type_wrapper.EnumTypeWrapper(_HTTPMETHOD)
+HTTP_METHOD_UNSPECIFIED = 0
+POST = 1
+GET = 2
+HEAD = 3
+PUT = 4
+DELETE = 5
+
+
+_PULLTARGET = _descriptor.Descriptor(
+    name="PullTarget",
+    full_name="google.cloud.tasks.v2beta2.PullTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=107,
+    serialized_end=119,
+)
+
+
+_PULLMESSAGE = _descriptor.Descriptor(
+    name="PullMessage",
+    full_name="google.cloud.tasks.v2beta2.PullMessage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="payload",
+            full_name="google.cloud.tasks.v2beta2.PullMessage.payload",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tag",
+            full_name="google.cloud.tasks.v2beta2.PullMessage.tag",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=121,
+    serialized_end=164,
+)
+
+
+_APPENGINEHTTPTARGET = _descriptor.Descriptor(
+    name="AppEngineHttpTarget",
+    full_name="google.cloud.tasks.v2beta2.AppEngineHttpTarget",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing_override",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpTarget.app_engine_routing_override",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=166,
+    serialized_end=270,
+)
+
+
+_APPENGINEHTTPREQUEST_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=551,
+    serialized_end=597,
+)
+
+_APPENGINEHTTPREQUEST = _descriptor.Descriptor(
+    name="AppEngineHttpRequest",
+    full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.http_method",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_url",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.relative_url",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.headers",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="payload",
+            full_name="google.cloud.tasks.v2beta2.AppEngineHttpRequest.payload",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=273,
+    serialized_end=597,
+)
+
+
+_APPENGINEROUTING = _descriptor.Descriptor(
+    name="AppEngineRouting",
+    full_name="google.cloud.tasks.v2beta2.AppEngineRouting",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.cloud.tasks.v2beta2.AppEngineRouting.service",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.tasks.v2beta2.AppEngineRouting.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.tasks.v2beta2.AppEngineRouting.instance",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.tasks.v2beta2.AppEngineRouting.host",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=599,
+    serialized_end=683,
+)
+
+_APPENGINEHTTPTARGET.fields_by_name[
+    "app_engine_routing_override"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPREQUEST_HEADERSENTRY.containing_type = _APPENGINEHTTPREQUEST
+_APPENGINEHTTPREQUEST.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_APPENGINEHTTPREQUEST.fields_by_name[
+    "app_engine_routing"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPREQUEST.fields_by_name[
+    "headers"
+].message_type = _APPENGINEHTTPREQUEST_HEADERSENTRY
+DESCRIPTOR.message_types_by_name["PullTarget"] = _PULLTARGET
+DESCRIPTOR.message_types_by_name["PullMessage"] = _PULLMESSAGE
+DESCRIPTOR.message_types_by_name["AppEngineHttpTarget"] = _APPENGINEHTTPTARGET
+DESCRIPTOR.message_types_by_name["AppEngineHttpRequest"] = _APPENGINEHTTPREQUEST
+DESCRIPTOR.message_types_by_name["AppEngineRouting"] = _APPENGINEROUTING
+DESCRIPTOR.enum_types_by_name["HttpMethod"] = _HTTPMETHOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+PullTarget = _reflection.GeneratedProtocolMessageType(
+    "PullTarget",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PULLTARGET,
+        __module__="google.cloud.tasks_v2beta2.proto.target_pb2",
+        __doc__="""Pull target.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PullTarget)
+    ),
+)
+_sym_db.RegisterMessage(PullTarget)
+
+PullMessage = _reflection.GeneratedProtocolMessageType(
+    "PullMessage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PULLMESSAGE,
+        __module__="google.cloud.tasks_v2beta2.proto.target_pb2",
+        __doc__="""The pull message contains data that can be used by the caller of
+  [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.
+  
+  
+  Attributes:
+      payload:
+          A data payload consumed by the worker to execute the task.
+      tag:
+          The task's tag.  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.  The task's tag can only be set when the [task is
+          created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+          The tag must be less than 500 characters.  SDK compatibility:
+          Although the SDK allows tags to be either string or `bytes <ht
+          tps://cloud.google.com/appengine/docs/standard/java/javadoc/co
+          m/google/appengine/api/taskqueue/TaskOptions.html#tag-
+          byte:A->`_, only UTF-8 encoded tags can be used in Cloud
+          Tasks. If a tag isn't UTF-8 encoded, the tag will be empty
+          when the task is returned by Cloud Tasks.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PullMessage)
+    ),
+)
+_sym_db.RegisterMessage(PullMessage)
+
+AppEngineHttpTarget = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpTarget",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEHTTPTARGET,
+        __module__="google.cloud.tasks_v2beta2.proto.target_pb2",
+        __doc__="""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.
+  
+  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:
+  
+  ``https://www.googleapis.com/auth/cloud-platform``
+  
+  
+  Attributes:
+      app_engine_routing_override:
+          Overrides for the [task-level app\_engine\_routing][google.clo
+          ud.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.AppEngi
+          neHttpRequest.app\_engine\_routing].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineHttpTarget)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpTarget)
+
+AppEngineHttpRequest = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpRequest",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPENGINEHTTPREQUEST_HEADERSENTRY,
+                __module__="google.cloud.tasks_v2beta2.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_APPENGINEHTTPREQUEST,
+        __module__="google.cloud.tasks_v2beta2.proto.target_pb2",
+        __doc__="""App Engine HTTP request.
+  
+  The message defines the HTTP request that is sent to an App Engine app
+  when 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.
+  
+  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:
+  
+  ``https://www.googleapis.com/auth/cloud-platform``
+  
+  The task will be delivered to the App Engine app which belongs to the
+  same project as the queue. For more information, see `How Requests are
+  Routed <https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed>`_
+  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:
+  
+  -  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].
+  
+  The ``url`` that the task will be sent to is:
+  
+  -  ``url =`` [host][google.cloud.tasks.v2beta2.AppEngineRouting.host]
+     ``+``
+     [relative\_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.relative\_url]
+  
+  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.
+  
+  
+  Attributes:
+      http_method:
+          The HTTP method to use for the request. The default is POST.
+          The app's request handler for the task's target URL must be
+          able to handle HTTP requests with this http\_method, otherwise
+          the task attempt will fail with error code 405 (Method Not
+          Allowed). See `Writing a push task request handler <https://cl
+          oud.google.com/appengine/docs/java/taskqueue/push/creating-
+          handlers#writing_a_push_task_request_handler>`_ and the
+          documentation for the request handlers in the language your
+          app is written in e.g. `Python Request Handler <https://cloud.
+          google.com/appengine/docs/python/tools/webapp/requesthandlercl
+          ass>`_.
+      app_engine_routing:
+          Task-level setting for App Engine routing.  If set, [app\_engi
+          ne\_routing\_override][google.cloud.tasks.v2beta2.AppEngineHtt
+          pTarget.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.AppEngi
+          neHttpRequest.app\_engine\_routing].
+      relative_url:
+          The relative URL.  The relative URL must begin with "/" and
+          must be a valid HTTP relative URL. It can contain a path and
+          query string arguments. If the relative URL is empty, then the
+          root path "/" will be used. No spaces are allowed, and the
+          maximum length allowed is 2083 characters.
+      headers:
+          HTTP request headers.  This map contains the header field
+          names and values. Headers can be set when the [task is
+          created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+          Repeated headers are not supported but a header value can
+          contain commas.  Cloud Tasks sets some headers to default
+          values:  -  ``User-Agent``: By default, this header is
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"``.
+          This    header can be modified, but Cloud Tasks will append
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"`` to
+          the    modified ``User-Agent``.  If the task has a [payload][g
+          oogle.cloud.tasks.v2beta2.AppEngineHttpRequest.payload], Cloud
+          Tasks sets the following headers:  -  ``Content-Type``: By
+          default, the ``Content-Type`` header is set to
+          ``"application/octet-stream"``. The default can be overridden
+          by    explicitly setting ``Content-Type`` to a particular
+          media type when    the [task is
+          created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+          For    example, ``Content-Type`` can be set to
+          ``"application/json"``. -  ``Content-Length``: This is
+          computed by Cloud Tasks. This value is    output only. It
+          cannot be changed.  The headers below cannot be set or
+          overridden:  -  ``Host`` -  ``X-Google-*`` -
+          ``X-AppEngine-*``  In addition, Cloud Tasks sets some headers
+          when the task is dispatched, such as headers containing
+          information about the task; see `request headers <https://clou
+          d.google.com/appengine/docs/python/taskqueue/push/creating-
+          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.  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.
+      payload:
+          Payload.  The payload will be sent as the HTTP message body. A
+          message body, and thus a payload, is allowed only if the HTTP
+          method is POST or PUT. It is an error to set a data payload on
+          a task with an incompatible
+          [HttpMethod][google.cloud.tasks.v2beta2.HttpMethod].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineHttpRequest)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpRequest)
+_sym_db.RegisterMessage(AppEngineHttpRequest.HeadersEntry)
+
+AppEngineRouting = _reflection.GeneratedProtocolMessageType(
+    "AppEngineRouting",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEROUTING,
+        __module__="google.cloud.tasks_v2beta2.proto.target_pb2",
+        __doc__="""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>`_,
+  `Microservices Architecture on Google App
+  Engine <https://cloud.google.com/appengine/docs/python/microservices-on-app-engine>`_,
+  `App Engine Standard request
+  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>`_.
+  
+  
+  Attributes:
+      service:
+          App service.  By default, the task is sent to the service
+          which is the default 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.AppEngi
+          neRouting.service], [version][google.cloud.tasks.v2beta2.AppEn
+          gineRouting.version], and [instance][google.cloud.tasks.v2beta
+          2.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.AppEng
+          ineRouting.service], [version][google.cloud.tasks.v2beta2.AppE
+          ngineRouting.version], and [instance][google.cloud.tasks.v2bet
+          a2.AppEngineRouting.instance] are the empty string.
+      version:
+          App version.  By default, the task is sent to the version
+          which is the default 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.AppEngi
+          neRouting.service], [version][google.cloud.tasks.v2beta2.AppEn
+          gineRouting.version], and [instance][google.cloud.tasks.v2beta
+          2.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.AppEng
+          ineRouting.service], [version][google.cloud.tasks.v2beta2.AppE
+          ngineRouting.version], and [instance][google.cloud.tasks.v2bet
+          a2.AppEngineRouting.instance] are the empty string.
+      instance:
+          App instance.  By default, the task is sent to an instance
+          which is available when the task is attempted.  Requests can
+          only be sent to a specific instance if `manual scaling is used
+          in App Engine Standard
+          <https://cloud.google.com/appengine/docs/python/an-overview-
+          of-app-engine?hl=en_US#scaling_types_and_instance_classes>`_.
+          App Engine Flex does not support instances. For more
+          information, see `App Engine Standard request 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>`_.
+      host:
+          Output only. The host that the task is sent to.  For more
+          information, see `How Requests are Routed
+          <https://cloud.google.com/appengine/docs/standard/python/how-
+          requests-are-routed>`_.  The host is constructed as:  -
+          ``host = [application_domain_name]``\     ``| [service] + '.'
+          + [application_domain_name]``\     ``| [version] + '.' +
+          [application_domain_name]``\     ``| [version_dot_service]+
+          '.' + [application_domain_name]``\     ``| [instance] + '.' +
+          [application_domain_name]``\     ``| [instance_dot_service] +
+          '.' + [application_domain_name]``\     ``|
+          [instance_dot_version] + '.' + [application_domain_name]``\
+          ``| [instance_dot_version_dot_service] + '.' +
+          [application_domain_name]``  -  ``application_domain_name`` =
+          The domain name of the app, for example    .appspot.com, which
+          is associated with the 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]
+          -  ``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.App
+          EngineRouting.instance]  -  ``instance_dot_service =``    [ins
+          tance][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_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]
+          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 [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.clo
+          ud.tasks.v2beta2.AppEngineRouting.service], [version][google.c
+          loud.tasks.v2beta2.AppEngineRouting.version], or [instance][go
+          ogle.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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineRouting)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineRouting)
+
+
+DESCRIPTOR._options = None
+_APPENGINEHTTPREQUEST_HEADERSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/task.proto b/tasks/google/cloud/tasks_v2beta2/proto/task.proto
new file mode 100644
index 000000000000..9a927462c48c
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/task.proto
@@ -0,0 +1,184 @@
+// 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.tasks.v2beta2;
+
+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;
+option java_outer_classname = "TaskProto";
+option java_package = "com.google.cloud.tasks.v2beta2";
+
+// 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.v2beta2.Task] data.
+  //
+  // When a task is returned in a response, 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.
+  enum View {
+    // Unspecified. Defaults to BASIC.
+    VIEW_UNSPECIFIED = 0;
+
+    // The basic view omits fields which can be large or can contain
+    // 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.
+    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.
+    FULL = 2;
+  }
+
+  // Optionally caller-specified in [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+  //
+  // The task name.
+  //
+  // The task name must have the following format:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the task's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+  //   hyphens (-). The maximum length is 100 characters.
+  // * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+  //   hyphens (-), or underscores (_). The maximum length is 500 characters.
+  string name = 1;
+
+  // Required.
+  //
+  // The task's payload is used by the task's target to process the task.
+  // A payload is valid only if it is compatible with the queue's target.
+  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.
+    //
+    // 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.
+    //
+    // A pull task is a task that has [PullMessage][google.cloud.tasks.v2beta2.PullMessage] set.
+    PullMessage pull_message = 4;
+  }
+
+  // The time when the task is scheduled to be attempted.
+  //
+  // For App Engine queues, this is when the task will be attempted or retried.
+  //
+  // 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].
+  //
+  // `schedule_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp schedule_time = 5;
+
+  // Output only. The time that the task was created.
+  //
+  // `create_time` will be truncated to the nearest second.
+  google.protobuf.Timestamp create_time = 6;
+
+  // 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.
+  View view = 8;
+}
+
+// Status of the task.
+message TaskStatus {
+  // Output only. The number of attempts dispatched.
+  //
+  // 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].
+  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.
+  //
+  // 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].
+  AttemptStatus last_attempt_status = 4;
+}
+
+// The status of a task attempt.
+message AttemptStatus {
+  // Output only. The time that this attempt was scheduled.
+  //
+  // `schedule_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp schedule_time = 1;
+
+  // Output only. The time that this attempt was dispatched.
+  //
+  // `dispatch_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp dispatch_time = 2;
+
+  // Output only. The time that this attempt response was received.
+  //
+  // `response_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp response_time = 3;
+
+  // Output only. The response from the target for this attempt.
+  //
+  // If the task has not been attempted or the task is currently running
+  // then the response status is unset.
+  google.rpc.Status response_status = 4;
+}
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py b/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py
new file mode 100644
index 000000000000..903dd9b190e7
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/task_pb2.py
@@ -0,0 +1,606 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta2/proto/task.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2beta2.proto import (
+    target_pb2 as google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta2/proto/task.proto",
+    package="google.cloud.tasks.v2beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta2B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/tasks_v2beta2/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xa8\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta2.AppEngineHttpRequestH\x00\x12?\n\x0cpull_message\x18\x04 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.PullMessageH\x00\x12\x31\n\rschedule_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x06status\x18\x07 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.TaskStatus\x12\x33\n\x04view\x18\x08 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xdd\x01\n\nTaskStatus\x12\x1e\n\x16\x61ttempt_dispatch_count\x18\x01 \x01(\x05\x12\x1e\n\x16\x61ttempt_response_count\x18\x02 \x01(\x05\x12G\n\x14\x66irst_attempt_status\x18\x03 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus\x12\x46\n\x13last_attempt_status\x18\x04 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus"\xd5\x01\n\rAttemptStatus\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta2B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TASK_VIEW = _descriptor.EnumDescriptor(
+    name="View",
+    full_name="google.cloud.tasks.v2beta2.Task.View",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VIEW_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=619,
+    serialized_end=668,
+)
+_sym_db.RegisterEnumDescriptor(_TASK_VIEW)
+
+
+_TASK = _descriptor.Descriptor(
+    name="Task",
+    full_name="google.cloud.tasks.v2beta2.Task",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta2.Task.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_request",
+            full_name="google.cloud.tasks.v2beta2.Task.app_engine_http_request",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pull_message",
+            full_name="google.cloud.tasks.v2beta2.Task.pull_message",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta2.Task.schedule_time",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.tasks.v2beta2.Task.create_time",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.cloud.tasks.v2beta2.Task.status",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.cloud.tasks.v2beta2.Task.view",
+            index=6,
+            number=8,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TASK_VIEW],
+    serialized_options=_b(
+        "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+    ),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="payload_type",
+            full_name="google.cloud.tasks.v2beta2.Task.payload_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=238,
+    serialized_end=790,
+)
+
+
+_TASKSTATUS = _descriptor.Descriptor(
+    name="TaskStatus",
+    full_name="google.cloud.tasks.v2beta2.TaskStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="attempt_dispatch_count",
+            full_name="google.cloud.tasks.v2beta2.TaskStatus.attempt_dispatch_count",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attempt_response_count",
+            full_name="google.cloud.tasks.v2beta2.TaskStatus.attempt_response_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="first_attempt_status",
+            full_name="google.cloud.tasks.v2beta2.TaskStatus.first_attempt_status",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_attempt_status",
+            full_name="google.cloud.tasks.v2beta2.TaskStatus.last_attempt_status",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=793,
+    serialized_end=1014,
+)
+
+
+_ATTEMPTSTATUS = _descriptor.Descriptor(
+    name="AttemptStatus",
+    full_name="google.cloud.tasks.v2beta2.AttemptStatus",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta2.AttemptStatus.schedule_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_time",
+            full_name="google.cloud.tasks.v2beta2.AttemptStatus.dispatch_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_time",
+            full_name="google.cloud.tasks.v2beta2.AttemptStatus.response_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_status",
+            full_name="google.cloud.tasks.v2beta2.AttemptStatus.response_status",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1017,
+    serialized_end=1230,
+)
+
+_TASK.fields_by_name[
+    "app_engine_http_request"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2._APPENGINEHTTPREQUEST
+)
+_TASK.fields_by_name[
+    "pull_message"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2._PULLMESSAGE
+)
+_TASK.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TASK.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TASK.fields_by_name["status"].message_type = _TASKSTATUS
+_TASK.fields_by_name["view"].enum_type = _TASK_VIEW
+_TASK_VIEW.containing_type = _TASK
+_TASK.oneofs_by_name["payload_type"].fields.append(
+    _TASK.fields_by_name["app_engine_http_request"]
+)
+_TASK.fields_by_name["app_engine_http_request"].containing_oneof = _TASK.oneofs_by_name[
+    "payload_type"
+]
+_TASK.oneofs_by_name["payload_type"].fields.append(_TASK.fields_by_name["pull_message"])
+_TASK.fields_by_name["pull_message"].containing_oneof = _TASK.oneofs_by_name[
+    "payload_type"
+]
+_TASKSTATUS.fields_by_name["first_attempt_status"].message_type = _ATTEMPTSTATUS
+_TASKSTATUS.fields_by_name["last_attempt_status"].message_type = _ATTEMPTSTATUS
+_ATTEMPTSTATUS.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPTSTATUS.fields_by_name[
+    "dispatch_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPTSTATUS.fields_by_name[
+    "response_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPTSTATUS.fields_by_name[
+    "response_status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+DESCRIPTOR.message_types_by_name["Task"] = _TASK
+DESCRIPTOR.message_types_by_name["TaskStatus"] = _TASKSTATUS
+DESCRIPTOR.message_types_by_name["AttemptStatus"] = _ATTEMPTSTATUS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Task = _reflection.GeneratedProtocolMessageType(
+    "Task",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TASK,
+        __module__="google.cloud.tasks_v2beta2.proto.task_pb2",
+        __doc__="""A unit of scheduled work.
+  
+  
+  Attributes:
+      name:
+          Optionally caller-specified in [CreateTask][google.cloud.tasks
+          .v2beta2.CloudTasks.CreateTask].  The task name.  The task
+          name must have the following format: ``projects/PROJECT_ID/loc
+          ations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``  -
+          ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`_ -  ``LOCATION_ID``
+          is the canonical ID for the task's location. The list    of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``QUEUE_ID`` can
+          contain letters ([A-Za-z]), numbers ([0-9]), or    hyphens
+          (-). The maximum length is 100 characters. -  ``TASK_ID`` can
+          contain only letters ([A-Za-z]), numbers ([0-9]),    hyphens
+          (-), or underscores (\_). The maximum length is 500
+          characters.
+      payload_type:
+          Required.  The task's payload is used by the task's target to
+          process the task. A payload is valid only if it is compatible
+          with the queue's target.
+      app_engine_http_request:
+          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.
+          An App Engine task is a task that has [AppEngineHttpRequest][g
+          oogle.cloud.tasks.v2beta2.AppEngineHttpRequest] set.
+      pull_message:
+          [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.
+      schedule_time:
+          The time when the task is scheduled to be attempted.  For App
+          Engine queues, this is when the task will be attempted or
+          retried.  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.clo
+          ud.tasks.v2beta2.LeaseTasksRequest.lease\_duration].
+          ``schedule_time`` will be truncated to the nearest
+          microsecond.
+      create_time:
+          Output only. The time that the task was created.
+          ``create_time`` will be truncated to the nearest second.
+      status:
+          Output only. The task status.
+      view:
+          Output only. The view specifies which subset of the
+          [Task][google.cloud.tasks.v2beta2.Task] has been returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.Task)
+    ),
+)
+_sym_db.RegisterMessage(Task)
+
+TaskStatus = _reflection.GeneratedProtocolMessageType(
+    "TaskStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TASKSTATUS,
+        __module__="google.cloud.tasks_v2beta2.proto.task_pb2",
+        __doc__="""Status of the task.
+  
+  
+  Attributes:
+      attempt_dispatch_count:
+          Output only. The number of attempts dispatched.  This count
+          includes attempts which have been dispatched but haven't
+          received a response.
+      attempt_response_count:
+          Output only. The number of attempts which have received a
+          response.  This field is not calculated for [pull
+          tasks][google.cloud.tasks.v2beta2.PullMessage].
+      first_attempt_status:
+          Output only. The status of the task's first attempt.  Only [di
+          spatch\_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatc
+          h\_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].
+      last_attempt_status:
+          Output only. The status of the task's last attempt.  This
+          field is not calculated for [pull
+          tasks][google.cloud.tasks.v2beta2.PullMessage].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.TaskStatus)
+    ),
+)
+_sym_db.RegisterMessage(TaskStatus)
+
+AttemptStatus = _reflection.GeneratedProtocolMessageType(
+    "AttemptStatus",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ATTEMPTSTATUS,
+        __module__="google.cloud.tasks_v2beta2.proto.task_pb2",
+        __doc__="""The status of a task attempt.
+  
+  
+  Attributes:
+      schedule_time:
+          Output only. The time that this attempt was scheduled.
+          ``schedule_time`` will be truncated to the nearest
+          microsecond.
+      dispatch_time:
+          Output only. The time that this attempt was dispatched.
+          ``dispatch_time`` will be truncated to the nearest
+          microsecond.
+      response_time:
+          Output only. The time that this attempt response was received.
+          ``response_time`` will be truncated to the nearest
+          microsecond.
+      response_status:
+          Output only. The response from the target for this attempt.
+          If the task has not been attempted or the task is currently
+          running then the response status is unset.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AttemptStatus)
+    ),
+)
+_sym_db.RegisterMessage(AttemptStatus)
+
+
+DESCRIPTOR._options = None
+_TASK._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2beta2/types.py b/tasks/google/cloud/tasks_v2beta2/types.py
new file mode 100644
index 000000000000..28145a51c762
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta2/types.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.tasks_v2beta2.proto import cloudtasks_pb2
+from google.cloud.tasks_v2beta2.proto import queue_pb2
+from google.cloud.tasks_v2beta2.proto import target_pb2
+from google.cloud.tasks_v2beta2.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [cloudtasks_pb2, queue_pb2, target_pb2, task_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.tasks_v2beta2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/tasks/google/cloud/tasks_v2beta3/__init__.py b/tasks/google/cloud/tasks_v2beta3/__init__.py
new file mode 100644
index 000000000000..b9adad4606ac
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.tasks_v2beta3 import types
+from google.cloud.tasks_v2beta3.gapic import cloud_tasks_client
+from google.cloud.tasks_v2beta3.gapic import enums
+
+
+class CloudTasksClient(cloud_tasks_client.CloudTasksClient):
+    __doc__ = cloud_tasks_client.CloudTasksClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "CloudTasksClient")
diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/__init__.py b/tasks/google/cloud/tasks_v2beta3/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py b/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py
new file mode 100644
index 000000000000..33a080ad7459
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py
@@ -0,0 +1,1704 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.tasks.v2beta3 CloudTasks API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.tasks_v2beta3.gapic import cloud_tasks_client_config
+from google.cloud.tasks_v2beta3.gapic import enums
+from google.cloud.tasks_v2beta3.gapic.transports import cloud_tasks_grpc_transport
+from google.cloud.tasks_v2beta3.proto import cloudtasks_pb2
+from google.cloud.tasks_v2beta3.proto import cloudtasks_pb2_grpc
+from google.cloud.tasks_v2beta3.proto import queue_pb2
+from google.cloud.tasks_v2beta3.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks").version
+
+
+class CloudTasksClient(object):
+    """
+    Cloud Tasks allows developers to manage the execution of background
+    work in their applications.
+    """
+
+    SERVICE_ADDRESS = "cloudtasks.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.tasks.v2beta3.CloudTasks"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            CloudTasksClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def queue_path(cls, project, location, queue):
+        """Return a fully-qualified queue string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/queues/{queue}",
+            project=project,
+            location=location,
+            queue=queue,
+        )
+
+    @classmethod
+    def task_path(cls, project, location, queue, task):
+        """Return a fully-qualified task string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}",
+            project=project,
+            location=location,
+            queue=queue,
+            task=task,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.CloudTasksGrpcTransport,
+                    Callable[[~.Credentials, type], ~.CloudTasksGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = cloud_tasks_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=cloud_tasks_grpc_transport.CloudTasksGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = cloud_tasks_grpc_transport.CloudTasksGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_queues(
+        self,
+        parent,
+        filter_=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists queues.
+
+        Queues are returned in lexicographical order.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_queues(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_queues(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The location name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID``
+            filter_ (str): ``filter`` can be used to specify a subset of queues. Any ``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 "state: PAUSED".
+
+                Note that using filters might cause fewer queues than the requested
+                page\_size to be returned.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.tasks_v2beta3.types.Queue` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_queues" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_queues"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_queues,
+                default_retry=self._method_configs["ListQueues"].retry,
+                default_timeout=self._method_configs["ListQueues"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ListQueuesRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_queues"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="queues",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a queue.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.get_queue(name)
+
+        Args:
+            name (str): Required. The resource name of the queue. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_queue,
+                default_retry=self._method_configs["GetQueue"].retry,
+                default_timeout=self._method_configs["GetQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.GetQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_queue(
+        self,
+        parent,
+        queue,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Initialize `queue`:
+            >>> queue = {
+            ...     # The fully qualified path to the queue
+            ...     'name': client.queue_path('[PROJECT]', '[LOCATION]', '[NAME]'),
+            ...     'app_engine_http_queue': {
+            ...         'app_engine_routing_override': {
+            ...             # The App Engine service that will receive the tasks.
+            ...             'service': 'default',
+            ...         },
+            ...     },
+            ... }
+            >>>
+            >>> response = client.create_queue(parent, queue)
+
+        Args:
+            parent (str): 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``.
+            queue (Union[dict, ~google.cloud.tasks_v2beta3.types.Queue]): Required. The queue to create.
+
+                ``Queue's name`` cannot be the same as an existing queue.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta3.types.Queue`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_queue,
+                default_retry=self._method_configs["CreateQueue"].retry,
+                default_timeout=self._method_configs["CreateQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_queue(
+        self,
+        queue,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a queue.
+
+        This method creates the queue if it does not exist and updates 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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> # Initialize `queue`:
+            >>> queue = {
+            ...     # The fully qualified path to the queue
+            ...     'name': client.queue_path('[PROJECT]', '[LOCATION]', '[NAME]'),
+            ...     'app_engine_http_queue': {
+            ...         'app_engine_routing_override': {
+            ...             # The App Engine service that will receive the tasks.
+            ...             'service': 'default',
+            ...         },
+            ...     },
+            ... }
+            >>>
+            >>> response = client.update_queue(queue)
+
+        Args:
+            queue (Union[dict, ~google.cloud.tasks_v2beta3.types.Queue]): Required. The queue to create or update.
+
+                The queue's ``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``
+                cannot be changed.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta3.types.Queue`
+            update_mask (Union[dict, ~google.cloud.tasks_v2beta3.types.FieldMask]): A mask used to specify which fields of the queue are being updated.
+
+                If empty, then all fields will be updated.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta3.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_queue,
+                default_retry=self._method_configs["UpdateQueue"].retry,
+                default_timeout=self._method_configs["UpdateQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.UpdateQueueRequest(
+            queue=queue, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("queue.name", queue.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a queue.
+
+        This command will delete the queue even if it has tasks in it.
+
+        Note: If you delete a queue, a queue with the same name can't be created
+        for 7 days.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> client.delete_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_queue,
+                default_retry=self._method_configs["DeleteQueue"].retry,
+                default_timeout=self._method_configs["DeleteQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.DeleteQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def purge_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Purges a queue by deleting all of its tasks.
+
+        All tasks created before this method is called are permanently deleted.
+
+        Purge operations can take up to one minute to take effect. Tasks
+        might be dispatched before the purge takes effect. A purge is irreversible.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.purge_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "purge_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "purge_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.purge_queue,
+                default_retry=self._method_configs["PurgeQueue"].retry,
+                default_timeout=self._method_configs["PurgeQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.PurgeQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["purge_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def pause_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Pauses the queue.
+
+        If a queue is paused then the system will stop dispatching tasks until
+        the queue is resumed via ``ResumeQueue``. Tasks can still be added when
+        the queue is paused. A queue is paused if its ``state`` is ``PAUSED``.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.pause_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "pause_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "pause_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.pause_queue,
+                default_retry=self._method_configs["PauseQueue"].retry,
+                default_timeout=self._method_configs["PauseQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.PauseQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["pause_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def resume_queue(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Resume a queue.
+
+        This method resumes a queue after it has been ``PAUSED`` or
+        ``DISABLED``. The state of a queue is stored in the queue's ``state``;
+        after calling this method it will be set to ``RUNNING``.
+
+        WARNING: Resuming many high-QPS queues at the same time can lead to
+        target overloading. If you are resuming high-QPS queues, follow the
+        500/50/5 pattern described in `Managing Cloud Tasks Scaling
+        Risks <https://cloud.google.com/tasks/docs/manage-cloud-task-scaling>`__.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.resume_queue(name)
+
+        Args:
+            name (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Queue` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "resume_queue" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "resume_queue"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.resume_queue,
+                default_retry=self._method_configs["ResumeQueue"].retry,
+                default_timeout=self._method_configs["ResumeQueue"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ResumeQueueRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["resume_queue"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_iam_policy(
+        self,
+        resource,
+        options_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the access control policy for a ``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``
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> response = client.get_iam_policy(resource)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being requested.
+                See the operation documentation for the appropriate value for this field.
+            options_ (Union[dict, ~google.cloud.tasks_v2beta3.types.GetPolicyOptions]): OPTIONAL: A ``GetPolicyOptions`` object for specifying options to
+                ``GetIamPolicy``. This field is only used by Cloud IAM.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta3.types.GetPolicyOptions`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_iam_policy,
+                default_retry=self._method_configs["GetIamPolicy"].retry,
+                default_timeout=self._method_configs["GetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.GetIamPolicyRequest(
+            resource=resource, options=options_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def set_iam_policy(
+        self,
+        resource,
+        policy,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sets the access control policy for a ``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.
+
+        Authorization requires the following `Google
+        IAM <https://cloud.google.com/iam>`__ permission on the specified
+        resource parent:
+
+        -  ``cloudtasks.queues.setIamPolicy``
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `policy`:
+            >>> policy = {}
+            >>>
+            >>> response = client.set_iam_policy(resource, policy)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy is being specified.
+                See the operation documentation for the appropriate value for this field.
+            policy (Union[dict, ~google.cloud.tasks_v2beta3.types.Policy]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta3.types.Policy`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Policy` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "set_iam_policy" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "set_iam_policy"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.set_iam_policy,
+                default_retry=self._method_configs["SetIamPolicy"].retry,
+                default_timeout=self._method_configs["SetIamPolicy"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["set_iam_policy"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def test_iam_permissions(
+        self,
+        resource,
+        permissions,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns permissions that a caller has on a ``Queue``. 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.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> resource = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `permissions`:
+            >>> permissions = []
+            >>>
+            >>> response = client.test_iam_permissions(resource, permissions)
+
+        Args:
+            resource (str): REQUIRED: The resource for which the policy detail is being requested.
+                See the operation documentation for the appropriate value for this field.
+            permissions (list[str]): 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>`__.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.TestIamPermissionsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "test_iam_permissions" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "test_iam_permissions"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.test_iam_permissions,
+                default_retry=self._method_configs["TestIamPermissions"].retry,
+                default_timeout=self._method_configs["TestIamPermissions"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("resource", resource)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["test_iam_permissions"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_tasks(
+        self,
+        parent,
+        response_view=None,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the tasks in a queue.
+
+        By default, only the ``BASIC`` view is retrieved due to performance
+        considerations; ``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.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_tasks(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_tasks(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+            response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.tasks_v2beta3.types.Task` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_tasks" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_tasks"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_tasks,
+                default_retry=self._method_configs["ListTasks"].retry,
+                default_timeout=self._method_configs["ListTasks"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.ListTasksRequest(
+            parent=parent, response_view=response_view, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_tasks"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="tasks",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_task(
+        self,
+        name,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a task.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> response = client.get_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_task,
+                default_retry=self._method_configs["GetTask"].retry,
+                default_timeout=self._method_configs["GetTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_task(
+        self,
+        parent,
+        task,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a task and adds it to a queue.
+
+        Tasks cannot be updated after creation; there is no UpdateTask command.
+
+        -  The maximum task size is 100KB.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> parent = client.queue_path('[PROJECT]', '[LOCATION]', '[QUEUE]')
+            >>>
+            >>> # TODO: Initialize `task`:
+            >>> task = {}
+            >>>
+            >>> response = client.create_task(parent, task)
+
+        Args:
+            parent (str): Required. The queue name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+
+                The queue must already exist.
+            task (Union[dict, ~google.cloud.tasks_v2beta3.types.Task]): 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``. 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``.
+
+                If ``schedule_time`` is not set or is in the past then Cloud Tasks will
+                set it to the current time.
+
+                Task De-duplication:
+
+                Explicitly specifying a task ID enables task de-duplication. If a task's
+                ID is identical to that of an existing task or a task that was deleted
+                or executed recently then the call will fail with ``ALREADY_EXISTS``. If
+                the task's queue was created using Cloud Tasks, then another task with
+                the same name can't be created for ~1hour after the original task was
+                deleted or executed. If the task's queue was created using queue.yaml or
+                queue.xml, then another task with the same name can't be created for
+                ~9days after the original task was deleted or executed.
+
+                Because there is an extra lookup cost to identify duplicate task names,
+                these ``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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.tasks_v2beta3.types.Task`
+            response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_task,
+                default_retry=self._method_configs["CreateTask"].retry,
+                default_timeout=self._method_configs["CreateTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.CreateTaskRequest(
+            parent=parent, task=task, response_view=response_view
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_task(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a task.
+
+        A task can be deleted if it is scheduled or dispatched. A task
+        cannot be deleted if it has executed successfully or permanently
+        failed.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> client.delete_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_task,
+                default_retry=self._method_configs["DeleteTask"].retry,
+                default_timeout=self._method_configs["DeleteTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.DeleteTaskRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def run_task(
+        self,
+        name,
+        response_view=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` or
+        is ``PAUSED``.
+
+        This command is meant to be used for manual debugging. For example,
+        ``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`` 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``
+        will be reset to the time that ``RunTask`` was called plus the retry
+        delay specified in the queue's ``RetryConfig``.
+
+        ``RunTask`` returns ``NOT_FOUND`` when it is called on a task that has
+        already succeeded or permanently failed.
+
+        Example:
+            >>> from google.cloud import tasks_v2beta3
+            >>>
+            >>> client = tasks_v2beta3.CloudTasksClient()
+            >>>
+            >>> name = client.task_path('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]')
+            >>>
+            >>> response = client.run_task(name)
+
+        Args:
+            name (str): Required. The task name. For example:
+                ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+            response_view (~google.cloud.tasks_v2beta3.types.View): The response\_view specifies which subset of the ``Task`` will be
+                returned.
+
+                By default response\_view is ``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`` requires ``cloudtasks.tasks.fullView``
+                `Google IAM <https://cloud.google.com/iam/>`___ permission on the
+                ``Task`` resource.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.tasks_v2beta3.types.Task` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "run_task" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "run_task"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.run_task,
+                default_retry=self._method_configs["RunTask"].retry,
+                default_timeout=self._method_configs["RunTask"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["run_task"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py b/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py
new file mode 100644
index 000000000000..7773a64356c0
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py
@@ -0,0 +1,103 @@
+config = {
+    "interfaces": {
+        "google.cloud.tasks.v2beta3.CloudTasks": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListQueues": {
+                    "timeout_millis": 15000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "PurgeQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "PauseQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ResumeQueue": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetIamPolicy": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SetIamPolicy": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "TestIamPermissions": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTasks": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RunTask": {
+                    "timeout_millis": 10000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/enums.py b/tasks/google/cloud/tasks_v2beta3/gapic/enums.py
new file mode 100644
index 000000000000..d4b1d288a8f3
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/gapic/enums.py
@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class HttpMethod(enum.IntEnum):
+    """
+    The HTTP method used to execute the task.
+
+    Attributes:
+      HTTP_METHOD_UNSPECIFIED (int): HTTP method unspecified
+      POST (int): HTTP POST
+      GET (int): HTTP GET
+      HEAD (int): HTTP HEAD
+      PUT (int): HTTP PUT
+      DELETE (int): HTTP DELETE
+      PATCH (int): HTTP PATCH
+      OPTIONS (int): HTTP OPTIONS
+    """
+
+    HTTP_METHOD_UNSPECIFIED = 0
+    POST = 1
+    GET = 2
+    HEAD = 3
+    PUT = 4
+    DELETE = 5
+    PATCH = 6
+    OPTIONS = 7
+
+
+class Queue(object):
+    class State(enum.IntEnum):
+        """
+        State of the queue.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Unspecified state.
+          RUNNING (int): The queue is running. Tasks can be dispatched.
+
+          If the queue was created using Cloud Tasks and the queue has had no
+          activity (method calls or task dispatches) for 30 days, the queue may
+          take a few minutes to re-activate. Some method calls may return
+          ``NOT_FOUND`` and tasks may not be dispatched for a few minutes until
+          the queue has been re-activated.
+          PAUSED (int): 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.
+          DISABLED (int): The queue is disabled.
+
+          A queue becomes ``DISABLED`` when
+          `queue.yaml <https://cloud.google.com/appengine/docs/python/config/queueref>`__
+          or
+          `queue.xml <https://cloud.google.com/appengine/docs/standard/java/config/queueref>`__
+          is uploaded which does not contain the queue. You cannot directly
+          disable a queue.
+
+          When a queue is disabled, tasks can still be added to a queue but the
+          tasks are not dispatched.
+
+          To permanently delete this queue and all of its tasks, call
+          ``DeleteQueue``.
+        """
+
+        STATE_UNSPECIFIED = 0
+        RUNNING = 1
+        PAUSED = 2
+        DISABLED = 3
+
+
+class Task(object):
+    class View(enum.IntEnum):
+        """
+        The view specifies a subset of ``Task`` data.
+
+        When a task is returned in a response, 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.
+
+        Attributes:
+          VIEW_UNSPECIFIED (int): Unspecified. Defaults to BASIC.
+          BASIC (int): The basic view omits fields which can be large or can contain sensitive
+          data.
+
+          This view does not include the ``body in AppEngineHttpRequest``. Bodies
+          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.
+          FULL (int): All information is returned.
+
+          Authorization for ``FULL`` requires ``cloudtasks.tasks.fullView``
+          `Google IAM <https://cloud.google.com/iam/>`__ permission on the
+          ``Queue`` resource.
+        """
+
+        VIEW_UNSPECIFIED = 0
+        BASIC = 1
+        FULL = 2
diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/transports/__init__.py b/tasks/google/cloud/tasks_v2beta3/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py b/tasks/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py
new file mode 100644
index 000000000000..0bd4bb38b30a
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py
@@ -0,0 +1,426 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.tasks_v2beta3.proto import cloudtasks_pb2_grpc
+
+
+class CloudTasksGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.tasks.v2beta3 CloudTasks API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudtasks.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudtasks.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_queues(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.list_queues`.
+
+        Lists queues.
+
+        Queues are returned in lexicographical order.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ListQueues
+
+    @property
+    def get_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_queue`.
+
+        Gets a queue.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetQueue
+
+    @property
+    def create_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.create_queue`.
+
+        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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CreateQueue
+
+    @property
+    def update_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.update_queue`.
+
+        Updates a queue.
+
+        This method creates the queue if it does not exist and updates 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.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].UpdateQueue
+
+    @property
+    def delete_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.delete_queue`.
+
+        Deletes a queue.
+
+        This command will delete the queue even if it has tasks in it.
+
+        Note: If you delete a queue, a queue with the same name can't be created
+        for 7 days.
+
+        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. Read `Overview of Queue Management and
+        queue.yaml <https://cloud.google.com/tasks/docs/queue-yaml>`__ before
+        using this method.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].DeleteQueue
+
+    @property
+    def purge_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.purge_queue`.
+
+        Purges a queue by deleting all of its tasks.
+
+        All tasks created before this method is called are permanently deleted.
+
+        Purge operations can take up to one minute to take effect. Tasks
+        might be dispatched before the purge takes effect. A purge is irreversible.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].PurgeQueue
+
+    @property
+    def pause_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.pause_queue`.
+
+        Pauses the queue.
+
+        If a queue is paused then the system will stop dispatching tasks until
+        the queue is resumed via ``ResumeQueue``. Tasks can still be added when
+        the queue is paused. A queue is paused if its ``state`` is ``PAUSED``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].PauseQueue
+
+    @property
+    def resume_queue(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.resume_queue`.
+
+        Resume a queue.
+
+        This method resumes a queue after it has been ``PAUSED`` or
+        ``DISABLED``. The state of a queue is stored in the queue's ``state``;
+        after calling this method it will be set to ``RUNNING``.
+
+        WARNING: Resuming many high-QPS queues at the same time can lead to
+        target overloading. If you are resuming high-QPS queues, follow the
+        500/50/5 pattern described in `Managing Cloud Tasks Scaling
+        Risks <https://cloud.google.com/tasks/docs/manage-cloud-task-scaling>`__.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ResumeQueue
+
+    @property
+    def get_iam_policy(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_iam_policy`.
+
+        Gets the access control policy for a ``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``
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetIamPolicy
+
+    @property
+    def set_iam_policy(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.set_iam_policy`.
+
+        Sets the access control policy for a ``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.
+
+        Authorization requires the following `Google
+        IAM <https://cloud.google.com/iam>`__ permission on the specified
+        resource parent:
+
+        -  ``cloudtasks.queues.setIamPolicy``
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].SetIamPolicy
+
+    @property
+    def test_iam_permissions(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.test_iam_permissions`.
+
+        Returns permissions that a caller has on a ``Queue``. 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].TestIamPermissions
+
+    @property
+    def list_tasks(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.list_tasks`.
+
+        Lists the tasks in a queue.
+
+        By default, only the ``BASIC`` view is retrieved due to performance
+        considerations; ``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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].ListTasks
+
+    @property
+    def get_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.get_task`.
+
+        Gets a task.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].GetTask
+
+    @property
+    def create_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.create_task`.
+
+        Creates a task and adds it to a queue.
+
+        Tasks cannot be updated after creation; there is no UpdateTask command.
+
+        -  The maximum task size is 100KB.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].CreateTask
+
+    @property
+    def delete_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.delete_task`.
+
+        Deletes a task.
+
+        A task can be deleted if it is scheduled or dispatched. A task
+        cannot be deleted if it has executed successfully or permanently
+        failed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].DeleteTask
+
+    @property
+    def run_task(self):
+        """Return the gRPC stub for :meth:`CloudTasksClient.run_task`.
+
+        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`` or
+        is ``PAUSED``.
+
+        This command is meant to be used for manual debugging. For example,
+        ``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`` 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``
+        will be reset to the time that ``RunTask`` was called plus the retry
+        delay specified in the queue's ``RetryConfig``.
+
+        ``RunTask`` returns ``NOT_FOUND`` when it is called on a task that has
+        already succeeded or permanently failed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["cloud_tasks_stub"].RunTask
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/__init__.py b/tasks/google/cloud/tasks_v2beta3/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto
new file mode 100644
index 000000000000..431d5a73fc7a
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks.proto
@@ -0,0 +1,655 @@
+// 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.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";
+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 go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks";
+option java_multiple_files = true;
+option java_outer_classname = "CloudTasksProto";
+option java_package = "com.google.cloud.tasks.v2beta3";
+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.
+  rpc ListQueues(ListQueuesRequest) returns (ListQueuesResponse) {
+    option (google.api.http) = {
+      get: "/v2beta3/{parent=projects/*/locations/*}/queues"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a queue.
+  rpc GetQueue(GetQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      get: "/v2beta3/{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.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc CreateQueue(CreateQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2beta3/{parent=projects/*/locations/*}/queues"
+      body: "queue"
+    };
+    option (google.api.method_signature) = "parent,queue";
+  }
+
+  // Updates a queue.
+  //
+  // This method creates the queue if it does not exist and updates
+  // 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.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc UpdateQueue(UpdateQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      patch: "/v2beta3/{queue.name=projects/*/locations/*/queues/*}"
+      body: "queue"
+    };
+    option (google.api.method_signature) = "queue,update_mask";
+  }
+
+  // Deletes a queue.
+  //
+  // This command will delete the queue even if it has tasks in it.
+  //
+  // Note: If you delete a queue, a queue with the same name can't be created
+  // for 7 days.
+  //
+  // 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.
+  // Read
+  // [Overview of Queue Management and
+  // queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+  // this method.
+  rpc DeleteQueue(DeleteQueueRequest) returns (google.protobuf.Empty) {
+    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.
+  //
+  // All tasks created before this method is called are permanently deleted.
+  //
+  // Purge operations can take up to one minute to take effect. Tasks
+  // might be dispatched before the purge takes effect. A purge is irreversible.
+  rpc PurgeQueue(PurgeQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2beta3/{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.v2beta3.CloudTasks.ResumeQueue]. Tasks can still be added
+  // when the queue is paused. A queue is paused if its
+  // [state][google.cloud.tasks.v2beta3.Queue.state] is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED].
+  rpc PauseQueue(PauseQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      post: "/v2beta3/{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.v2beta3.Queue.State.PAUSED] or
+  // [DISABLED][google.cloud.tasks.v2beta3.Queue.State.DISABLED]. The state of a queue is stored
+  // in the queue's [state][google.cloud.tasks.v2beta3.Queue.state]; after calling this method it
+  // will be set to [RUNNING][google.cloud.tasks.v2beta3.Queue.State.RUNNING].
+  //
+  // WARNING: Resuming many high-QPS queues at the same time can
+  // lead to target overloading. If you are resuming high-QPS
+  // queues, follow the 500/50/5 pattern described in
+  // [Managing Cloud Tasks Scaling
+  // Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+  rpc ResumeQueue(ResumeQueueRequest) returns (Queue) {
+    option (google.api.http) = {
+      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].
+  // 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) {
+    option (google.api.http) = {
+      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
+  // policy.
+  //
+  // Note: The Cloud Console does not check queue-level IAM permissions yet.
+  // Project-level permissions are required to use the Cloud Console.
+  //
+  // Authorization requires the following
+  // [Google IAM](https://cloud.google.com/iam) permission on the specified
+  // resource parent:
+  //
+  // * `cloudtasks.queues.setIamPolicy`
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      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].
+  // 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) {
+    option (google.api.http) = {
+      post: "/v2beta3/{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.v2beta3.Task.View.BASIC] view is retrieved
+  // due to performance considerations;
+  // [response_view][google.cloud.tasks.v2beta3.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.
+  rpc ListTasks(ListTasksRequest) returns (ListTasksResponse) {
+    option (google.api.http) = {
+      get: "/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a task.
+  rpc GetTask(GetTaskRequest) returns (Task) {
+    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.
+  //
+  // Tasks cannot be updated after creation; there is no UpdateTask command.
+  //
+  // * The maximum task size is 100KB.
+  rpc CreateTask(CreateTaskRequest) returns (Task) {
+    option (google.api.http) = {
+      post: "/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,task";
+  }
+
+  // Deletes a task.
+  //
+  // A task can be deleted if it is scheduled or dispatched. A task
+  // cannot be deleted if it has executed successfully or permanently
+  // failed.
+  rpc DeleteTask(DeleteTaskRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // 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.v2beta3.RateLimits] or
+  // is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED].
+  //
+  // This command is meant to be used for manual debugging. For
+  // example, [RunTask][google.cloud.tasks.v2beta3.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][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.v2beta3.Task.schedule_time] will be reset to the time that
+  // [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] was called plus the retry delay specified
+  // in the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig].
+  //
+  // [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] returns
+  // [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
+  // task that has already succeeded or permanently failed.
+  rpc RunTask(RunTaskRequest) returns (Task) {
+    option (google.api.http) = {
+      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.
+  // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // `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.
+  // 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 "state: PAUSED".
+  //
+  // Note that using filters might cause fewer queues than the
+  // requested page_size to be returned.
+  string filter = 2;
+
+  // Requested page size.
+  //
+  // 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.v2beta3.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.v2beta3.ListQueuesResponse.next_page_token] returned
+  // from the previous call to [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]
+  // method. It is an error to switch the value of the
+  // [filter][google.cloud.tasks.v2beta3.ListQueuesRequest.filter] while iterating through pages.
+  string page_token = 4;
+}
+
+// Response message for [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues].
+message ListQueuesResponse {
+  // The list of queues.
+  repeated Queue queues = 1;
+
+  // A token to retrieve next page of results.
+  //
+  // To return the next page of results, call
+  // [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues] with this value as the
+  // [page_token][google.cloud.tasks.v2beta3.ListQueuesRequest.page_token].
+  //
+  // If the next_page_token is empty, there are no more results.
+  //
+  // The page token is valid for only 2 hours.
+  string next_page_token = 2;
+}
+
+// Request message for [GetQueue][google.cloud.tasks.v2beta3.CloudTasks.GetQueue].
+message GetQueueRequest {
+  // Required. The resource name of the queue. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  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.
+  // 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 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // 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 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue].
+message UpdateQueueRequest {
+  // 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 [(google.api.field_behavior) = REQUIRED];
+
+  // A mask used to specify which fields of the queue are being updated.
+  //
+  // If empty, then all fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue].
+message DeleteQueueRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+  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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be
+  // returned.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta3.Task] resource.
+  Task.View response_view = 2;
+
+  // Maximum page size.
+  //
+  // Fewer tasks than requested might be returned, even if more tasks exist; use
+  // [next_page_token][google.cloud.tasks.v2beta3.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 = 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.v2beta3.ListTasksResponse.next_page_token] returned
+  // from the previous call to [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]
+  // method.
+  //
+  // The page token is valid for only 2 hours.
+  string page_token = 4;
+}
+
+// Response message for listing tasks using [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks].
+message ListTasksResponse {
+  // The list of tasks.
+  repeated Task tasks = 1;
+
+  // A token to retrieve next page of results.
+  //
+  // To return the next page of results, call
+  // [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks] with this value as the
+  // [page_token][google.cloud.tasks.v2beta3.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.v2beta3.CloudTasks.GetTask].
+message GetTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta3.Task] resource.
+  Task.View response_view = 2;
+}
+
+// Request message for [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+message CreateTaskRequest {
+  // Required. The queue name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  //
+  // The queue must already exist.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // 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.v2beta3.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.v2beta3.Task.name].
+  //
+  // If [schedule_time][google.cloud.tasks.v2beta3.Task.schedule_time] is not set or is in the
+  // past then Cloud Tasks will set it to the current time.
+  //
+  // Task De-duplication:
+  //
+  // Explicitly specifying a task ID enables task de-duplication.  If
+  // a task's ID is identical to that of an existing task or a task
+  // that was deleted or executed recently then the call will fail
+  // with [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS].
+  // If the task's queue was created using Cloud Tasks, then another task with
+  // the same name can't be created for ~1hour after the original task was
+  // deleted or executed. If the task's queue was created using queue.yaml or
+  // queue.xml, then another task with the same name can't be created
+  // for ~9days after the original task was deleted or executed.
+  //
+  // Because there is an extra lookup cost to identify duplicate task
+  // names, these [CreateTask][google.cloud.tasks.v2beta3.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 [(google.api.field_behavior) = REQUIRED];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be
+  // returned.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta3.Task] resource.
+  Task.View response_view = 3;
+}
+
+// Request message for deleting a task using
+// [DeleteTask][google.cloud.tasks.v2beta3.CloudTasks.DeleteTask].
+message DeleteTaskRequest {
+  // Required. The task name. For example:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  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.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta3.Task] resource.
+  Task.View response_view = 2;
+}
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py
new file mode 100644
index 000000000000..45decbad7bfb
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py
@@ -0,0 +1,1630 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta3/proto/cloudtasks.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2beta3.proto import (
+    queue_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2,
+)
+from google.cloud.tasks_v2beta3.proto import (
+    task_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta3/proto/cloudtasks.proto",
+    package="google.cloud.tasks.v2beta3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta3B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\242\002\005TASKS"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/tasks_v2beta3/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta3/proto/queue.proto\x1a+google/cloud/tasks_v2beta3/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x85\x01\n\x11ListQueuesRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta3.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x86\x01\n\x12\x43reateQueueRequest\x12\x39\n\x06parent\x18\x01 \x01(\tB)\xe0\x41\x02\xfa\x41#\x12!locations.googleapis.com/Location\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xb0\x01\n\x10ListTasksRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta3.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"\xbf\x01\n\x11\x43reateTaskRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta3.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View2\xa5\x16\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta3.ListQueuesRequest\x1a..google.cloud.tasks.v2beta3.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta3.GetQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta3.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta3/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta3.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta3.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta3.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta3.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta3.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta3.ListTasksRequest\x1a-.google.cloud.tasks.v2beta3.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta3.GetTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta3.CreateTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta3.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta3.RunTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"M\x82\xd3\xe4\x93\x02@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\xa2\x02\x05TASKSb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,
+        google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_LISTQUEUESREQUEST = _descriptor.Descriptor(
+    name="ListQueuesRequest",
+    full_name="google.cloud.tasks.v2beta3.ListQueuesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta3.ListQueuesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A#\022!locations.googleapis.com/Location"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.tasks.v2beta3.ListQueuesRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.tasks.v2beta3.ListQueuesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.tasks.v2beta3.ListQueuesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=411,
+    serialized_end=544,
+)
+
+
+_LISTQUEUESRESPONSE = _descriptor.Descriptor(
+    name="ListQueuesResponse",
+    full_name="google.cloud.tasks.v2beta3.ListQueuesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queues",
+            full_name="google.cloud.tasks.v2beta3.ListQueuesResponse.queues",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.tasks.v2beta3.ListQueuesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=546,
+    serialized_end=642,
+)
+
+
+_GETQUEUEREQUEST = _descriptor.Descriptor(
+    name="GetQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.GetQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.GetQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=644,
+    serialized_end=716,
+)
+
+
+_CREATEQUEUEREQUEST = _descriptor.Descriptor(
+    name="CreateQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.CreateQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta3.CreateQueueRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A#\022!locations.googleapis.com/Location"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="queue",
+            full_name="google.cloud.tasks.v2beta3.CreateQueueRequest.queue",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=719,
+    serialized_end=853,
+)
+
+
+_UPDATEQUEUEREQUEST = _descriptor.Descriptor(
+    name="UpdateQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.UpdateQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="queue",
+            full_name="google.cloud.tasks.v2beta3.UpdateQueueRequest.queue",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.tasks.v2beta3.UpdateQueueRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=855,
+    serialized_end=979,
+)
+
+
+_DELETEQUEUEREQUEST = _descriptor.Descriptor(
+    name="DeleteQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.DeleteQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.DeleteQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=981,
+    serialized_end=1056,
+)
+
+
+_PURGEQUEUEREQUEST = _descriptor.Descriptor(
+    name="PurgeQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.PurgeQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.PurgeQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1058,
+    serialized_end=1132,
+)
+
+
+_PAUSEQUEUEREQUEST = _descriptor.Descriptor(
+    name="PauseQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.PauseQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.PauseQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1134,
+    serialized_end=1208,
+)
+
+
+_RESUMEQUEUEREQUEST = _descriptor.Descriptor(
+    name="ResumeQueueRequest",
+    full_name="google.cloud.tasks.v2beta3.ResumeQueueRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.ResumeQueueRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1210,
+    serialized_end=1285,
+)
+
+
+_LISTTASKSREQUEST = _descriptor.Descriptor(
+    name="ListTasksRequest",
+    full_name="google.cloud.tasks.v2beta3.ListTasksRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta3.ListTasksRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta3.ListTasksRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.tasks.v2beta3.ListTasksRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.tasks.v2beta3.ListTasksRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1288,
+    serialized_end=1464,
+)
+
+
+_LISTTASKSRESPONSE = _descriptor.Descriptor(
+    name="ListTasksResponse",
+    full_name="google.cloud.tasks.v2beta3.ListTasksResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="tasks",
+            full_name="google.cloud.tasks.v2beta3.ListTasksResponse.tasks",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.tasks.v2beta3.ListTasksResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1466,
+    serialized_end=1559,
+)
+
+
+_GETTASKREQUEST = _descriptor.Descriptor(
+    name="GetTaskRequest",
+    full_name="google.cloud.tasks.v2beta3.GetTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.GetTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta3.GetTaskRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1562,
+    serialized_end=1694,
+)
+
+
+_CREATETASKREQUEST = _descriptor.Descriptor(
+    name="CreateTaskRequest",
+    full_name="google.cloud.tasks.v2beta3.CreateTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.tasks.v2beta3.CreateTaskRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="task",
+            full_name="google.cloud.tasks.v2beta3.CreateTaskRequest.task",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\340A\002"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta3.CreateTaskRequest.response_view",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1697,
+    serialized_end=1888,
+)
+
+
+_DELETETASKREQUEST = _descriptor.Descriptor(
+    name="DeleteTaskRequest",
+    full_name="google.cloud.tasks.v2beta3.DeleteTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.DeleteTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1890,
+    serialized_end=1963,
+)
+
+
+_RUNTASKREQUEST = _descriptor.Descriptor(
+    name="RunTaskRequest",
+    full_name="google.cloud.tasks.v2beta3.RunTaskRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.RunTaskRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b(
+                "\340A\002\372A \n\036cloudtasks.googleapis.com/Task"
+            ),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_view",
+            full_name="google.cloud.tasks.v2beta3.RunTaskRequest.response_view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1966,
+    serialized_end=2098,
+)
+
+_LISTQUEUESRESPONSE.fields_by_name[
+    "queues"
+].message_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE
+_CREATEQUEUEREQUEST.fields_by_name[
+    "queue"
+].message_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE
+_UPDATEQUEUEREQUEST.fields_by_name[
+    "queue"
+].message_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE
+_UPDATEQUEUEREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTTASKSREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK_VIEW
+_LISTTASKSRESPONSE.fields_by_name[
+    "tasks"
+].message_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK
+_GETTASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK_VIEW
+_CREATETASKREQUEST.fields_by_name[
+    "task"
+].message_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK
+_CREATETASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK_VIEW
+_RUNTASKREQUEST.fields_by_name[
+    "response_view"
+].enum_type = google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK_VIEW
+DESCRIPTOR.message_types_by_name["ListQueuesRequest"] = _LISTQUEUESREQUEST
+DESCRIPTOR.message_types_by_name["ListQueuesResponse"] = _LISTQUEUESRESPONSE
+DESCRIPTOR.message_types_by_name["GetQueueRequest"] = _GETQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["CreateQueueRequest"] = _CREATEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["UpdateQueueRequest"] = _UPDATEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["DeleteQueueRequest"] = _DELETEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["PurgeQueueRequest"] = _PURGEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["PauseQueueRequest"] = _PAUSEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["ResumeQueueRequest"] = _RESUMEQUEUEREQUEST
+DESCRIPTOR.message_types_by_name["ListTasksRequest"] = _LISTTASKSREQUEST
+DESCRIPTOR.message_types_by_name["ListTasksResponse"] = _LISTTASKSRESPONSE
+DESCRIPTOR.message_types_by_name["GetTaskRequest"] = _GETTASKREQUEST
+DESCRIPTOR.message_types_by_name["CreateTaskRequest"] = _CREATETASKREQUEST
+DESCRIPTOR.message_types_by_name["DeleteTaskRequest"] = _DELETETASKREQUEST
+DESCRIPTOR.message_types_by_name["RunTaskRequest"] = _RUNTASKREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListQueuesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListQueuesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTQUEUESREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues].
+  
+  
+  Attributes:
+      parent:
+          Required. The location name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID``
+      filter:
+          ``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. For example:
+          ``<=, <, >=, >, !=, =, :``. The filter syntax is the same as
+          described in `Stackdriver's Advanced Logs Filters <https://clo
+          ud.google.com/logging/docs/view/advanced_filters>`_.  Sample
+          filter "state: PAUSED".  Note that using filters might cause
+          fewer queues than the requested page\_size to be returned.
+      page_size:
+          Requested page size.  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.v2beta3.ListQue
+          uesResponse.next\_page\_token] in the response to determine if
+          more queues exist.
+      page_token:
+          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 [ne
+          xt\_page\_token][google.cloud.tasks.v2beta3.ListQueuesResponse
+          .next\_page\_token] returned from the previous call to
+          [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]
+          method. It is an error to switch the value of the
+          [filter][google.cloud.tasks.v2beta3.ListQueuesRequest.filter]
+          while iterating through pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListQueuesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListQueuesRequest)
+
+ListQueuesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListQueuesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTQUEUESRESPONSE,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Response message for
+  [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues].
+  
+  
+  Attributes:
+      queues:
+          The list of queues.
+      next_page_token:
+          A token to retrieve next page of results.  To return the next
+          page of results, call
+          [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]
+          with this value as the [page\_token][google.cloud.tasks.v2beta
+          3.ListQueuesRequest.page\_token].  If the next\_page\_token is
+          empty, there are no more results.  The page token is valid for
+          only 2 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListQueuesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListQueuesResponse)
+
+GetQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "GetQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [GetQueue][google.cloud.tasks.v2beta3.CloudTasks.GetQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the queue. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.GetQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetQueueRequest)
+
+CreateQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue].
+  
+  
+  Attributes:
+      parent:
+          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.Locati
+          ons.ListLocations].
+      queue:
+          Required. The queue to create.  [Queue's
+          name][google.cloud.tasks.v2beta3.Queue.name] cannot be the
+          same as an existing queue.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.CreateQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateQueueRequest)
+
+UpdateQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue].
+  
+  
+  Attributes:
+      queue:
+          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.
+      update_mask:
+          A mask used to specify which fields of the queue are being
+          updated.  If empty, then all fields will be updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.UpdateQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateQueueRequest)
+
+DeleteQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.DeleteQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteQueueRequest)
+
+PurgeQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "PurgeQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PURGEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [PurgeQueue][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.PurgeQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(PurgeQueueRequest)
+
+PauseQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "PauseQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAUSEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [PauseQueue][google.cloud.tasks.v2beta3.CloudTasks.PauseQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.PauseQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(PauseQueueRequest)
+
+ResumeQueueRequest = _reflection.GeneratedProtocolMessageType(
+    "ResumeQueueRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RESUMEQUEUEREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue].
+  
+  
+  Attributes:
+      name:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ResumeQueueRequest)
+    ),
+)
+_sym_db.RegisterMessage(ResumeQueueRequest)
+
+ListTasksRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTasksRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTASKSREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for listing tasks using
+  [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2beta3.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2beta3.Task] resource.
+      page_size:
+          Maximum page size.  Fewer tasks than requested might be
+          returned, even if more tasks exist; use [next\_page\_token][go
+          ogle.cloud.tasks.v2beta3.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.
+      page_token:
+          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 [ne
+          xt\_page\_token][google.cloud.tasks.v2beta3.ListTasksResponse.
+          next\_page\_token] returned from the previous call to
+          [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]
+          method.  The page token is valid for only 2 hours.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListTasksRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTasksRequest)
+
+ListTasksResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTasksResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTASKSRESPONSE,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Response message for listing tasks using
+  [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks].
+  
+  
+  Attributes:
+      tasks:
+          The list of tasks.
+      next_page_token:
+          A token to retrieve next page of results.  To return the next
+          page of results, call
+          [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]
+          with this value as the [page\_token][google.cloud.tasks.v2beta
+          3.ListTasksRequest.page\_token].  If the next\_page\_token is
+          empty, there are no more results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListTasksResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTasksResponse)
+
+GetTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTASKREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for getting a task using
+  [GetTask][google.cloud.tasks.v2beta3.CloudTasks.GetTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2beta3.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2beta3.Task] resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.GetTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTaskRequest)
+
+CreateTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATETASKREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for
+  [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+  
+  
+  Attributes:
+      parent:
+          Required. The queue name. For example:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+          The queue must already exist.
+      task:
+          Required. The task to add.  Task names have the following
+          format: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUE
+          UE_ID/tasks/TASK_ID``. The user can optionally specify a task
+          [name][google.cloud.tasks.v2beta3.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.v2beta3.Task.name].  If [schedul
+          e\_time][google.cloud.tasks.v2beta3.Task.schedule\_time] is
+          not set or is in the past then Cloud Tasks will set it to the
+          current time.  Task De-duplication:  Explicitly specifying a
+          task ID enables task de-duplication. If a task's ID is
+          identical to that of an existing task or a task that was
+          deleted or executed recently then the call will fail with
+          [ALREADY\_EXISTS][google.rpc.Code.ALREADY\_EXISTS]. If the
+          task's queue was created using Cloud Tasks, then another task
+          with the same name can't be created for ~1hour after the
+          original task was deleted or executed. If the task's queue was
+          created using queue.yaml or queue.xml, then another task with
+          the same name can't be created for ~9days after the original
+          task was deleted or executed.  Because there is an extra
+          lookup cost to identify duplicate task names, these
+          [CreateTask][google.cloud.tasks.v2beta3.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.
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2beta3.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2beta3.Task] resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.CreateTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateTaskRequest)
+
+DeleteTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETETASKREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for deleting a task using
+  [DeleteTask][google.cloud.tasks.v2beta3.CloudTasks.DeleteTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.DeleteTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteTaskRequest)
+
+RunTaskRequest = _reflection.GeneratedProtocolMessageType(
+    "RunTaskRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RUNTASKREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2",
+        __doc__="""Request message for forcing a task to run now using
+  [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask].
+  
+  
+  Attributes:
+      name:
+          Required. The task name. For example: ``projects/PROJECT_ID/lo
+          cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``
+      response_view:
+          The response\_view specifies which subset of the
+          [Task][google.cloud.tasks.v2beta3.Task] will be returned.  By
+          default response\_view is
+          [BASIC][google.cloud.tasks.v2beta3.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.v2beta3.Task.View.FULL] requires
+          ``cloudtasks.tasks.fullView`` `Google IAM
+          <https://cloud.google.com/iam/>`_ permission on the
+          [Task][google.cloud.tasks.v2beta3.Task] resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.RunTaskRequest)
+    ),
+)
+_sym_db.RegisterMessage(RunTaskRequest)
+
+
+DESCRIPTOR._options = None
+_LISTQUEUESREQUEST.fields_by_name["parent"]._options = None
+_GETQUEUEREQUEST.fields_by_name["name"]._options = None
+_CREATEQUEUEREQUEST.fields_by_name["parent"]._options = None
+_CREATEQUEUEREQUEST.fields_by_name["queue"]._options = None
+_UPDATEQUEUEREQUEST.fields_by_name["queue"]._options = None
+_DELETEQUEUEREQUEST.fields_by_name["name"]._options = None
+_PURGEQUEUEREQUEST.fields_by_name["name"]._options = None
+_PAUSEQUEUEREQUEST.fields_by_name["name"]._options = None
+_RESUMEQUEUEREQUEST.fields_by_name["name"]._options = None
+_LISTTASKSREQUEST.fields_by_name["parent"]._options = None
+_GETTASKREQUEST.fields_by_name["name"]._options = None
+_CREATETASKREQUEST.fields_by_name["parent"]._options = None
+_CREATETASKREQUEST.fields_by_name["task"]._options = None
+_DELETETASKREQUEST.fields_by_name["name"]._options = None
+_RUNTASKREQUEST.fields_by_name["name"]._options = None
+
+_CLOUDTASKS = _descriptor.ServiceDescriptor(
+    name="CloudTasks",
+    full_name="google.cloud.tasks.v2beta3.CloudTasks",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=2101,
+    serialized_end=4954,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListQueues",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.ListQueues",
+            index=0,
+            containing_service=None,
+            input_type=_LISTQUEUESREQUEST,
+            output_type=_LISTQUEUESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v2beta3/{parent=projects/*/locations/*}/queues\332A\006parent"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.GetQueue",
+            index=1,
+            containing_service=None,
+            input_type=_GETQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.CreateQueue",
+            index=2,
+            containing_service=None,
+            input_type=_CREATEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\0028"//v2beta3/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                "\202\323\344\223\002>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEQUEUEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PurgeQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue",
+            index=5,
+            containing_service=None,
+            input_type=_PURGEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PauseQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.PauseQueue",
+            index=6,
+            containing_service=None,
+            input_type=_PAUSEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ResumeQueue",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue",
+            index=7,
+            containing_service=None,
+            input_type=_RESUMEQUEUEREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetIamPolicy",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.GetIamPolicy",
+            index=8,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SetIamPolicy",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.SetIamPolicy",
+            index=9,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY,
+            serialized_options=_b(
+                '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="TestIamPermissions",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.TestIamPermissions",
+            index=10,
+            containing_service=None,
+            input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST,
+            output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListTasks",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.ListTasks",
+            index=11,
+            containing_service=None,
+            input_type=_LISTTASKSREQUEST,
+            output_type=_LISTTASKSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0029\0227/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTask",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.GetTask",
+            index=12,
+            containing_service=None,
+            input_type=_GETTASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                "\202\323\344\223\0029\0227/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateTask",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.CreateTask",
+            index=13,
+            containing_service=None,
+            input_type=_CREATETASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteTask",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.DeleteTask",
+            index=14,
+            containing_service=None,
+            input_type=_DELETETASKREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0029*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RunTask",
+            full_name="google.cloud.tasks.v2beta3.CloudTasks.RunTask",
+            index=15,
+            containing_service=None,
+            input_type=_RUNTASKREQUEST,
+            output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_CLOUDTASKS)
+
+DESCRIPTOR.services_by_name["CloudTasks"] = _CLOUDTASKS
+
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py
new file mode 100644
index 000000000000..79dea089a796
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py
@@ -0,0 +1,440 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.tasks_v2beta3.proto import (
+    cloudtasks_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2,
+)
+from google.cloud.tasks_v2beta3.proto import (
+    queue_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2,
+)
+from google.cloud.tasks_v2beta3.proto import (
+    task_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2,
+)
+from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2
+from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class CloudTasksStub(object):
+    """Cloud Tasks allows developers to manage the execution of background
+  work in their applications.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListQueues = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/ListQueues",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.FromString,
+        )
+        self.GetQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/GetQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.CreateQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/CreateQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.UpdateQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/UpdateQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.DeleteQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/DeleteQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.PurgeQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/PurgeQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.PauseQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/PauseQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.ResumeQueue = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/ResumeQueue",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString,
+        )
+        self.GetIamPolicy = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/GetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.SetIamPolicy = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/SetIamPolicy",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString,
+        )
+        self.TestIamPermissions = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/TestIamPermissions",
+            request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString,
+            response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString,
+        )
+        self.ListTasks = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/ListTasks",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.FromString,
+        )
+        self.GetTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/GetTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.CreateTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/CreateTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.FromString,
+        )
+        self.DeleteTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/DeleteTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RunTask = channel.unary_unary(
+            "/google.cloud.tasks.v2beta3.CloudTasks/RunTask",
+            request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.FromString,
+        )
+
+
+class CloudTasksServicer(object):
+    """Cloud Tasks allows developers to manage the execution of background
+  work in their applications.
+  """
+
+    def ListQueues(self, request, context):
+        """Lists queues.
+
+    Queues are returned in lexicographical order.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetQueue(self, request, context):
+        """Gets a queue.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateQueue(self, request, context):
+        """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.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateQueue(self, request, context):
+        """Updates a queue.
+
+    This method creates the queue if it does not exist and updates
+    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.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteQueue(self, request, context):
+        """Deletes a queue.
+
+    This command will delete the queue even if it has tasks in it.
+
+    Note: If you delete a queue, a queue with the same name can't be created
+    for 7 days.
+
+    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.
+    Read
+    [Overview of Queue Management and
+    queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
+    this method.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PurgeQueue(self, request, context):
+        """Purges a queue by deleting all of its tasks.
+
+    All tasks created before this method is called are permanently deleted.
+
+    Purge operations can take up to one minute to take effect. Tasks
+    might be dispatched before the purge takes effect. A purge is irreversible.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PauseQueue(self, request, context):
+        """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.v2beta3.CloudTasks.ResumeQueue]. Tasks can still be added
+    when the queue is paused. A queue is paused if its
+    [state][google.cloud.tasks.v2beta3.Queue.state] is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ResumeQueue(self, request, context):
+        """Resume a queue.
+
+    This method resumes a queue after it has been
+    [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED] or
+    [DISABLED][google.cloud.tasks.v2beta3.Queue.State.DISABLED]. The state of a queue is stored
+    in the queue's [state][google.cloud.tasks.v2beta3.Queue.state]; after calling this method it
+    will be set to [RUNNING][google.cloud.tasks.v2beta3.Queue.State.RUNNING].
+
+    WARNING: Resuming many high-QPS queues at the same time can
+    lead to target overloading. If you are resuming high-QPS
+    queues, follow the 500/50/5 pattern described in
+    [Managing Cloud Tasks Scaling
+    Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetIamPolicy(self, request, context):
+        """Gets the access control policy for a [Queue][google.cloud.tasks.v2beta3.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`
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SetIamPolicy(self, request, context):
+        """Sets the access control policy for a [Queue][google.cloud.tasks.v2beta3.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.
+
+    Authorization requires the following
+    [Google IAM](https://cloud.google.com/iam) permission on the specified
+    resource parent:
+
+    * `cloudtasks.queues.setIamPolicy`
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def TestIamPermissions(self, request, context):
+        """Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta3.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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListTasks(self, request, context):
+        """Lists the tasks in a queue.
+
+    By default, only the [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC] view is retrieved
+    due to performance considerations;
+    [response_view][google.cloud.tasks.v2beta3.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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTask(self, request, context):
+        """Gets a task.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateTask(self, request, context):
+        """Creates a task and adds it to a queue.
+
+    Tasks cannot be updated after creation; there is no UpdateTask command.
+
+    * The maximum task size is 100KB.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteTask(self, request, context):
+        """Deletes a task.
+
+    A task can be deleted if it is scheduled or dispatched. A task
+    cannot be deleted if it has executed successfully or permanently
+    failed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RunTask(self, request, context):
+        """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.v2beta3.RateLimits] or
+    is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED].
+
+    This command is meant to be used for manual debugging. For
+    example, [RunTask][google.cloud.tasks.v2beta3.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][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.v2beta3.Task.schedule_time] will be reset to the time that
+    [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] was called plus the retry delay specified
+    in the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig].
+
+    [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] returns
+    [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
+    task that has already succeeded or permanently failed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_CloudTasksServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListQueues": grpc.unary_unary_rpc_method_handler(
+            servicer.ListQueues,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.SerializeToString,
+        ),
+        "GetQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.GetQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "CreateQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "UpdateQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "DeleteQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "PurgeQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.PurgeQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "PauseQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.PauseQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "ResumeQueue": grpc.unary_unary_rpc_method_handler(
+            servicer.ResumeQueue,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.SerializeToString,
+        ),
+        "GetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.GetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "SetIamPolicy": grpc.unary_unary_rpc_method_handler(
+            servicer.SetIamPolicy,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString,
+        ),
+        "TestIamPermissions": grpc.unary_unary_rpc_method_handler(
+            servicer.TestIamPermissions,
+            request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString,
+            response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString,
+        ),
+        "ListTasks": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTasks,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.SerializeToString,
+        ),
+        "GetTask": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "CreateTask": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+        "DeleteTask": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RunTask": grpc.unary_unary_rpc_method_handler(
+            servicer.RunTask,
+            request_deserializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.FromString,
+            response_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.tasks.v2beta3.CloudTasks", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/queue.proto b/tasks/google/cloud/tasks_v2beta3/proto/queue.proto
new file mode 100644
index 000000000000..777e9b8b4768
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/queue.proto
@@ -0,0 +1,357 @@
+// 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.tasks.v2beta3;
+
+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;
+option java_outer_classname = "QueueProto";
+option java_package = "com.google.cloud.tasks.v2beta3";
+
+// A queue is a container of related tasks. Queues are configured to manage
+// 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.
+    STATE_UNSPECIFIED = 0;
+
+    // The queue is running. Tasks can be dispatched.
+    //
+    // If the queue was created using Cloud Tasks and the queue has
+    // had no activity (method calls or task dispatches) for 30 days,
+    // the queue may take a few minutes to re-activate. Some method
+    // calls may return [NOT_FOUND][google.rpc.Code.NOT_FOUND] and
+    // tasks may not be dispatched for a few minutes until the queue
+    // has been re-activated.
+    RUNNING = 1;
+
+    // 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.
+    PAUSED = 2;
+
+    // The queue is disabled.
+    //
+    // A queue becomes `DISABLED` when
+    // [queue.yaml](https://cloud.google.com/appengine/docs/python/config/queueref)
+    // or
+    // [queue.xml](https://cloud.google.com/appengine/docs/standard/java/config/queueref)
+    // is uploaded which does not contain the queue. You cannot directly disable
+    // a queue.
+    //
+    // When a queue is disabled, tasks can still be added to a queue
+    // but the tasks are not dispatched.
+    //
+    // To permanently delete this queue and all of its tasks, call
+    // [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue].
+    DISABLED = 3;
+  }
+
+  // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue],
+  // after which it becomes output only.
+  //
+  // The queue name.
+  //
+  // The queue name must have the following format:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the queue's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+  //   hyphens (-). The maximum length is 100 characters.
+  string name = 1;
+
+  oneof queue_type {
+    // [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue] settings apply only to
+    // [App Engine tasks][google.cloud.tasks.v2beta3.AppEngineHttpRequest] in this queue.
+    // [Http tasks][google.cloud.tasks.v2beta3.HttpRequest] are not affected by this proto.
+    AppEngineHttpQueue app_engine_http_queue = 3;
+  }
+
+  // Rate limits for task dispatches.
+  //
+  // [rate_limits][google.cloud.tasks.v2beta3.Queue.rate_limits] and [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config] are
+  // related because they both control task attempts. However they control task
+  // attempts in different ways:
+  //
+  // * [rate_limits][google.cloud.tasks.v2beta3.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.v2beta3.Queue.retry_config] controls what happens to
+  //   particular a task after its first attempt fails. That is,
+  //   [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config] controls task retries (the
+  //   second attempt, third attempt, etc).
+  //
+  // The queue's actual dispatch rate is the result of:
+  //
+  // * Number of tasks in the queue
+  // * User-specified throttling: [rate_limits][google.cloud.tasks.v2beta3.Queue.rate_limits],
+  //   [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config], and the
+  //   [queue's state][google.cloud.tasks.v2beta3.Queue.state].
+  // * System throttling due to `429` (Too Many Requests) or `503` (Service
+  //   Unavailable) responses from the worker, high error rates, or to smooth
+  //   sudden large traffic spikes.
+  RateLimits rate_limits = 4;
+
+  // Settings that determine the retry behavior.
+  //
+  // * For tasks created using Cloud Tasks: the queue-level retry settings
+  //   apply to all tasks in the queue that were created using Cloud Tasks.
+  //   Retry settings cannot be set on individual tasks.
+  // * For tasks created using the App Engine SDK: the queue-level retry
+  //   settings apply to all tasks in the queue which do not have retry settings
+  //   explicitly set on the task and were created by the App Engine SDK. See
+  //   [App Engine
+  //   documentation](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/retrying-tasks).
+  RetryConfig retry_config = 5;
+
+  // Output only. The state of the queue.
+  //
+  // `state` can only be changed by called
+  // [PauseQueue][google.cloud.tasks.v2beta3.CloudTasks.PauseQueue],
+  // [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue], or uploading
+  // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
+  // [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue] cannot be used to change `state`.
+  State state = 6;
+
+  // Output only. The last time this queue was purged.
+  //
+  // All tasks that were [created][google.cloud.tasks.v2beta3.Task.create_time] before this time
+  // were purged.
+  //
+  // A queue can be purged using [PurgeQueue][google.cloud.tasks.v2beta3.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
+  // time will be unset if the queue has never been purged.
+  google.protobuf.Timestamp purge_time = 7;
+
+  // 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 = 10;
+}
+
+// Rate limits.
+//
+// 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.v2beta3.CloudTasks.RunTask], will run a task
+// even if the queue has reached its [RateLimits][google.cloud.tasks.v2beta3.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.v2beta3.AppEngineHttpQueue], the maximum allowed value
+  //   is 500.
+  //
+  //
+  // This field has the same meaning as
+  // [rate in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#rate).
+  double max_dispatches_per_second = 1;
+
+  // Output only. The max burst size.
+  //
+  // Max burst size limits how fast tasks in queue are processed when
+  // many tasks are in the queue and the rate is high. This field
+  // allows the queue to have a high rate so processing starts shortly
+  // after a task is enqueued, but still limits resource usage when
+  // many tasks are enqueued in a short period of time.
+  //
+  // The [token bucket](https://wikipedia.org/wiki/Token_Bucket)
+  // algorithm is used to control the rate of task dispatches. Each
+  // queue has a token bucket that holds tokens, up to the maximum
+  // specified by `max_burst_size`. Each time a task is dispatched, a
+  // token is removed from the bucket. Tasks will be dispatched until
+  // the queue's bucket runs out of tokens. The bucket will be
+  // continuously refilled with new tokens based on
+  // [max_dispatches_per_second][google.cloud.tasks.v2beta3.RateLimits.max_dispatches_per_second].
+  //
+  // Cloud Tasks will pick the value of `max_burst_size` based on the
+  // value of
+  // [max_dispatches_per_second][google.cloud.tasks.v2beta3.RateLimits.max_dispatches_per_second].
+  //
+  // For App Engine 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
+  // [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue] is called on a queue
+  // created by `queue.yaml/xml`, `max_burst_size` will be reset based
+  // on the value of
+  // [max_dispatches_per_second][google.cloud.tasks.v2beta3.RateLimits.max_dispatches_per_second],
+  // regardless of whether
+  // [max_dispatches_per_second][google.cloud.tasks.v2beta3.RateLimits.max_dispatches_per_second]
+  // is updated.
+  //
+  int32 max_burst_size = 2;
+
+  // The maximum number of concurrent tasks that Cloud Tasks allows
+  // to be dispatched for this queue. After this threshold has been
+  // reached, Cloud Tasks stops dispatching tasks until the number of
+  // concurrent requests decreases.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // The maximum allowed value is 5,000.
+  //
+  //
+  // This field has the same meaning as
+  // [max_concurrent_requests in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#max_concurrent_requests).
+  int32 max_concurrent_dispatches = 3;
+}
+
+// Retry config.
+//
+// These settings determine when a failed task attempt is retried.
+message RetryConfig {
+  // Number of attempts per task.
+  //
+  // Cloud Tasks will attempt the task `max_attempts` times (that is, if the
+  // first attempt fails, then there will be `max_attempts - 1` retries). Must
+  // be >= -1.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  // -1 indicates unlimited attempts.
+  //
+  // This field has the same meaning as
+  // [task_retry_limit in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  int32 max_attempts = 1;
+
+  // 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.v2beta3.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.
+  //
+  //
+  // `max_retry_duration` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [task_age_limit in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration max_retry_duration = 2;
+
+  // A task will be [scheduled][google.cloud.tasks.v2beta3.Task.schedule_time] for retry between
+  // [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff] and
+  // [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] duration after it fails,
+  // if the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] specifies that the task should be
+  // retried.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // `min_backoff` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [min_backoff_seconds in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration min_backoff = 3;
+
+  // A task will be [scheduled][google.cloud.tasks.v2beta3.Task.schedule_time] for retry between
+  // [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff] and
+  // [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] duration after it fails,
+  // if the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] specifies that the task should be
+  // retried.
+  //
+  // If unspecified when the queue is created, Cloud Tasks will pick the
+  // default.
+  //
+  //
+  // `max_backoff` will be truncated to the nearest second.
+  //
+  // This field has the same meaning as
+  // [max_backoff_seconds in
+  // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
+  google.protobuf.Duration max_backoff = 4;
+
+  // The time between retries will double `max_doublings` times.
+  //
+  // A task's retry interval starts at
+  // [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff], then doubles
+  // `max_doublings` times, then increases linearly, and finally
+  // retries retries at intervals of
+  // [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] up to
+  // [max_attempts][google.cloud.tasks.v2beta3.RetryConfig.max_attempts] times.
+  //
+  // For example, if [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff] is 10s,
+  // [max_backoff][google.cloud.tasks.v2beta3.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.v2beta3.RetryConfig.max_backoff] until the
+  // task has been attempted [max_attempts][google.cloud.tasks.v2beta3.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 has the same meaning as
+  // [max_doublings in
+  // 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/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py
new file mode 100644
index 000000000000..d1f26d01fd07
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2.py
@@ -0,0 +1,785 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta3/proto/queue.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2beta3.proto import (
+    target_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta3/proto/queue.proto",
+    package="google.cloud.tasks.v2beta3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta3B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks"
+    ),
+    serialized_pb=_b(
+        '\n,google/cloud/tasks_v2beta3/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xd7\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12O\n\x15\x61pp_engine_http_queue\x18\x03 \x01(\x0b\x32..google.cloud.tasks.v2beta3.AppEngineHttpQueueH\x00\x12;\n\x0brate_limits\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.RateLimits\x12=\n\x0cretry_config\x18\x05 \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.RetryConfig\x12\x36\n\x05state\x18\x06 \x01(\x0e\x32\'.google.cloud.tasks.v2beta3.Queue.State\x12.\n\npurge_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x1astackdriver_logging_config\x18\n \x01(\x0b\x32\x34.google.cloud.tasks.v2beta3.StackdriverLoggingConfig"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\x0c\n\nqueue_type"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42o\n\x1e\x63om.google.cloud.tasks.v2beta3B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_QUEUE_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.tasks.v2beta3.Queue.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PAUSED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=668,
+    serialized_end=737,
+)
+_sym_db.RegisterEnumDescriptor(_QUEUE_STATE)
+
+
+_QUEUE = _descriptor.Descriptor(
+    name="Queue",
+    full_name="google.cloud.tasks.v2beta3.Queue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.Queue.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_queue",
+            full_name="google.cloud.tasks.v2beta3.Queue.app_engine_http_queue",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rate_limits",
+            full_name="google.cloud.tasks.v2beta3.Queue.rate_limits",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="retry_config",
+            full_name="google.cloud.tasks.v2beta3.Queue.retry_config",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.tasks.v2beta3.Queue.state",
+            index=4,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="purge_time",
+            full_name="google.cloud.tasks.v2beta3.Queue.purge_time",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stackdriver_logging_config",
+            full_name="google.cloud.tasks.v2beta3.Queue.stackdriver_logging_config",
+            index=6,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_QUEUE_STATE],
+    serialized_options=_b(
+        "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}"
+    ),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="queue_type",
+            full_name="google.cloud.tasks.v2beta3.Queue.queue_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=246,
+    serialized_end=845,
+)
+
+
+_RATELIMITS = _descriptor.Descriptor(
+    name="RateLimits",
+    full_name="google.cloud.tasks.v2beta3.RateLimits",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_dispatches_per_second",
+            full_name="google.cloud.tasks.v2beta3.RateLimits.max_dispatches_per_second",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_burst_size",
+            full_name="google.cloud.tasks.v2beta3.RateLimits.max_burst_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_concurrent_dispatches",
+            full_name="google.cloud.tasks.v2beta3.RateLimits.max_concurrent_dispatches",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=847,
+    serialized_end=953,
+)
+
+
+_RETRYCONFIG = _descriptor.Descriptor(
+    name="RetryConfig",
+    full_name="google.cloud.tasks.v2beta3.RetryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_attempts",
+            full_name="google.cloud.tasks.v2beta3.RetryConfig.max_attempts",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_retry_duration",
+            full_name="google.cloud.tasks.v2beta3.RetryConfig.max_retry_duration",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="min_backoff",
+            full_name="google.cloud.tasks.v2beta3.RetryConfig.min_backoff",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_backoff",
+            full_name="google.cloud.tasks.v2beta3.RetryConfig.max_backoff",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_doublings",
+            full_name="google.cloud.tasks.v2beta3.RetryConfig.max_doublings",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=956,
+    serialized_end=1165,
+)
+
+
+_STACKDRIVERLOGGINGCONFIG = _descriptor.Descriptor(
+    name="StackdriverLoggingConfig",
+    full_name="google.cloud.tasks.v2beta3.StackdriverLoggingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sampling_ratio",
+            full_name="google.cloud.tasks.v2beta3.StackdriverLoggingConfig.sampling_ratio",
+            index=0,
+            number=1,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1167,
+    serialized_end=1217,
+)
+
+_QUEUE.fields_by_name[
+    "app_engine_http_queue"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2._APPENGINEHTTPQUEUE
+)
+_QUEUE.fields_by_name["rate_limits"].message_type = _RATELIMITS
+_QUEUE.fields_by_name["retry_config"].message_type = _RETRYCONFIG
+_QUEUE.fields_by_name["state"].enum_type = _QUEUE_STATE
+_QUEUE.fields_by_name[
+    "purge_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_QUEUE.fields_by_name[
+    "stackdriver_logging_config"
+].message_type = _STACKDRIVERLOGGINGCONFIG
+_QUEUE_STATE.containing_type = _QUEUE
+_QUEUE.oneofs_by_name["queue_type"].fields.append(
+    _QUEUE.fields_by_name["app_engine_http_queue"]
+)
+_QUEUE.fields_by_name["app_engine_http_queue"].containing_oneof = _QUEUE.oneofs_by_name[
+    "queue_type"
+]
+_RETRYCONFIG.fields_by_name[
+    "max_retry_duration"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "min_backoff"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_RETRYCONFIG.fields_by_name[
+    "max_backoff"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["Queue"] = _QUEUE
+DESCRIPTOR.message_types_by_name["RateLimits"] = _RATELIMITS
+DESCRIPTOR.message_types_by_name["RetryConfig"] = _RETRYCONFIG
+DESCRIPTOR.message_types_by_name["StackdriverLoggingConfig"] = _STACKDRIVERLOGGINGCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Queue = _reflection.GeneratedProtocolMessageType(
+    "Queue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_QUEUE,
+        __module__="google.cloud.tasks_v2beta3.proto.queue_pb2",
+        __doc__="""A queue is a container of related tasks. Queues are configured to manage
+  how those tasks are dispatched. Configurable properties include rate
+  limits, retry options, queue types, and others.
+  
+  
+  Attributes:
+      name:
+          Caller-specified and required in [CreateQueue][google.cloud.ta
+          sks.v2beta3.CloudTasks.CreateQueue], after which it becomes
+          output only.  The queue name.  The queue name must have the
+          following format:
+          ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID``
+          -  ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`_ -  ``LOCATION_ID``
+          is the canonical ID for the queue's location. The    list of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``QUEUE_ID`` can
+          contain letters ([A-Za-z]), numbers ([0-9]), or    hyphens
+          (-). The maximum length is 100 characters.
+      app_engine_http_queue:
+          [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQ
+          ueue] settings apply only to [App Engine
+          tasks][google.cloud.tasks.v2beta3.AppEngineHttpRequest] in
+          this queue. [Http
+          tasks][google.cloud.tasks.v2beta3.HttpRequest] are not
+          affected by this proto.
+      rate_limits:
+          Rate limits for task dispatches.
+          [rate\_limits][google.cloud.tasks.v2beta3.Queue.rate\_limits]
+          and [retry\_config][google.cloud.tasks.v2beta3.Queue.retry\_co
+          nfig] are related because they both control task attempts.
+          However they control task attempts in different ways:  -
+          [rate\_limits][google.cloud.tasks.v2beta3.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.v2beta3.Queue.retry\_config]
+          controls what happens to particular a task after its first
+          attempt    fails. That is,    [retry\_config][google.cloud.tas
+          ks.v2beta3.Queue.retry\_config]    controls task retries (the
+          second attempt, third attempt, etc).  The queue's actual
+          dispatch rate is the result of:  -  Number of tasks in the
+          queue -  User-specified throttling:
+          [rate\_limits][google.cloud.tasks.v2beta3.Queue.rate\_limits],
+          [retry\_config][google.cloud.tasks.v2beta3.Queue.retry\_config
+          ], and    the [queue's
+          state][google.cloud.tasks.v2beta3.Queue.state]. -  System
+          throttling due to ``429`` (Too Many Requests) or ``503``
+          (Service Unavailable) responses from the worker, high error
+          rates, or    to smooth sudden large traffic spikes.
+      retry_config:
+          Settings that determine the retry behavior.  -  For tasks
+          created using Cloud Tasks: the queue-level retry settings
+          apply to all tasks in the queue that were created using Cloud
+          Tasks.    Retry settings cannot be set on individual tasks. -
+          For tasks created using the App Engine SDK: the queue-level
+          retry    settings apply to all tasks in the queue which do not
+          have retry    settings explicitly set on the task and were
+          created by the App    Engine SDK. See `App Engine
+          documentation <https://cloud.google.com/appengine/docs/standar
+          d/python/taskqueue/push/retrying-tasks>`_.
+      state:
+          Output only. The state of the queue.  ``state`` can only be
+          changed by called [PauseQueue][google.cloud.tasks.v2beta3.Clou
+          dTasks.PauseQueue], [ResumeQueue][google.cloud.tasks.v2beta3.C
+          loudTasks.ResumeQueue], or uploading `queue.yaml/xml <https://
+          cloud.google.com/appengine/docs/python/config/queueref>`_. [U
+          pdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue]
+          cannot be used to change ``state``.
+      purge_time:
+          Output only. The last time this queue was purged.  All tasks
+          that were
+          [created][google.cloud.tasks.v2beta3.Task.create\_time] before
+          this time were purged.  A queue can be purged using [PurgeQueu
+          e][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue], the `App
+          Engine Task Queue SDK, or the Cloud Console <https://cloud.goo
+          gle.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 time
+          will be unset if the queue has never been purged.
+      stackdriver_logging_config:
+          Configuration options for writing logs to `Stackdriver Logging
+          <https://cloud.google.com/logging/docs/>`_. If this field is
+          unset, then no logs are written.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.Queue)
+    ),
+)
+_sym_db.RegisterMessage(Queue)
+
+RateLimits = _reflection.GeneratedProtocolMessageType(
+    "RateLimits",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RATELIMITS,
+        __module__="google.cloud.tasks_v2beta3.proto.queue_pb2",
+        __doc__="""Rate limits.
+  
+  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.v2beta3.CloudTasks.RunTask], will run a
+  task even if the queue has reached its
+  [RateLimits][google.cloud.tasks.v2beta3.RateLimits].
+  
+  
+  Attributes:
+      max_dispatches_per_second:
+          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.v2beta3.AppEngineHttpQueue], the
+          maximum    allowed value is 500.  This field has the same
+          meaning as `rate in queue.yaml/xml <https://cloud.google.com/a
+          ppengine/docs/standard/python/config/queueref#rate>`_.
+      max_burst_size:
+          Output only. The max burst size.  Max burst size limits how
+          fast tasks in queue are processed when many tasks are in the
+          queue and the rate is high. This field allows the queue to
+          have a high rate so processing starts shortly after a task is
+          enqueued, but still limits resource usage when many tasks are
+          enqueued in a short period of time.  The `token bucket
+          <https://wikipedia.org/wiki/Token_Bucket>`_ algorithm is used
+          to control the rate of task dispatches. Each queue has a token
+          bucket that holds tokens, up to the maximum specified by
+          ``max_burst_size``. Each time a task is dispatched, a token is
+          removed from the bucket. Tasks will be dispatched until the
+          queue's bucket runs out of tokens. The bucket will be
+          continuously refilled with new tokens based on [max\_dispatche
+          s\_per\_second][google.cloud.tasks.v2beta3.RateLimits.max\_dis
+          patches\_per\_second].  Cloud Tasks will pick the value of
+          ``max_burst_size`` based on the value of [max\_dispatches\_per
+          \_second][google.cloud.tasks.v2beta3.RateLimits.max\_dispatche
+          s\_per\_second].  For App Engine queues that were created or
+          updated using ``queue.yaml/xml``, ``max_burst_size`` is equal
+          to `bucket\_size <https://cloud.google.com/appengine/docs/stan
+          dard/python/config/queueref#bucket_size>`_. Since
+          ``max_burst_size`` is output only, if [UpdateQueue][google.clo
+          ud.tasks.v2beta3.CloudTasks.UpdateQueue] is called on a queue
+          created by ``queue.yaml/xml``, ``max_burst_size`` will be
+          reset based on the value of [max\_dispatches\_per\_second][goo
+          gle.cloud.tasks.v2beta3.RateLimits.max\_dispatches\_per\_secon
+          d], regardless of whether [max\_dispatches\_per\_second][googl
+          e.cloud.tasks.v2beta3.RateLimits.max\_dispatches\_per\_second]
+          is updated.
+      max_concurrent_dispatches:
+          The maximum number of concurrent tasks that Cloud Tasks allows
+          to be dispatched for this queue. After this threshold has been
+          reached, Cloud Tasks stops dispatching tasks until the number
+          of concurrent requests decreases.  If unspecified when the
+          queue is created, Cloud Tasks will pick the default.  The
+          maximum allowed value is 5,000.  This field has the same
+          meaning as `max\_concurrent\_requests in queue.yaml/xml <https
+          ://cloud.google.com/appengine/docs/standard/python/config/queu
+          eref#max_concurrent_requests>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.RateLimits)
+    ),
+)
+_sym_db.RegisterMessage(RateLimits)
+
+RetryConfig = _reflection.GeneratedProtocolMessageType(
+    "RetryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RETRYCONFIG,
+        __module__="google.cloud.tasks_v2beta3.proto.queue_pb2",
+        __doc__="""Retry config.
+  
+  These settings determine when a failed task attempt is retried.
+  
+  
+  Attributes:
+      max_attempts:
+          Number of attempts per task.  Cloud Tasks will attempt the
+          task ``max_attempts`` times (that is, if the first attempt
+          fails, then there will be ``max_attempts - 1`` retries). Must
+          be >= -1.  If unspecified when the queue is created, Cloud
+          Tasks will pick the default.  -1 indicates unlimited attempts.
+          This field has the same meaning as `task\_retry\_limit in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_retry_duration:
+          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.v2beta3.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.
+          ``max_retry_duration`` will be truncated to the nearest
+          second.  This field has the same meaning as `task\_age\_limit
+          in queue.yaml/xml <https://cloud.google.com/appengine/docs/sta
+          ndard/python/config/queueref#retry_parameters>`_.
+      min_backoff:
+          A task will be
+          [scheduled][google.cloud.tasks.v2beta3.Task.schedule\_time]
+          for retry between [min\_backoff][google.cloud.tasks.v2beta3.Re
+          tryConfig.min\_backoff] and [max\_backoff][google.cloud.tasks.
+          v2beta3.RetryConfig.max\_backoff] duration after it fails, if
+          the queue's
+          [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig]
+          specifies that the task should be retried.  If unspecified
+          when the queue is created, Cloud Tasks will pick the default.
+          ``min_backoff`` will be truncated to the nearest second.  This
+          field has the same meaning as `min\_backoff\_seconds in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_backoff:
+          A task will be
+          [scheduled][google.cloud.tasks.v2beta3.Task.schedule\_time]
+          for retry between [min\_backoff][google.cloud.tasks.v2beta3.Re
+          tryConfig.min\_backoff] and [max\_backoff][google.cloud.tasks.
+          v2beta3.RetryConfig.max\_backoff] duration after it fails, if
+          the queue's
+          [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig]
+          specifies that the task should be retried.  If unspecified
+          when the queue is created, Cloud Tasks will pick the default.
+          ``max_backoff`` will be truncated to the nearest second.  This
+          field has the same meaning as `max\_backoff\_seconds in
+          queue.yaml/xml <https://cloud.google.com/appengine/docs/standa
+          rd/python/config/queueref#retry_parameters>`_.
+      max_doublings:
+          The time between retries will double ``max_doublings`` times.
+          A task's retry interval starts at [min\_backoff][google.cloud.
+          tasks.v2beta3.RetryConfig.min\_backoff], then doubles
+          ``max_doublings`` times, then increases linearly, and finally
+          retries retries at intervals of [max\_backoff][google.cloud.ta
+          sks.v2beta3.RetryConfig.max\_backoff] up to [max\_attempts][go
+          ogle.cloud.tasks.v2beta3.RetryConfig.max\_attempts] times.
+          For example, if [min\_backoff][google.cloud.tasks.v2beta3.Retr
+          yConfig.min\_backoff] is 10s, [max\_backoff][google.cloud.task
+          s.v2beta3.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.v2beta3.Retr
+          yConfig.max\_backoff] until the task has been attempted [max\_
+          attempts][google.cloud.tasks.v2beta3.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 has
+          the same meaning as `max\_doublings in queue.yaml/xml <https:/
+          /cloud.google.com/appengine/docs/standard/python/config/queuer
+          ef#retry_parameters>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.RetryConfig)
+    ),
+)
+_sym_db.RegisterMessage(RetryConfig)
+
+StackdriverLoggingConfig = _reflection.GeneratedProtocolMessageType(
+    "StackdriverLoggingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STACKDRIVERLOGGINGCONFIG,
+        __module__="google.cloud.tasks_v2beta3.proto.queue_pb2",
+        __doc__="""Configuration options for writing logs to `Stackdriver
+  Logging <https://cloud.google.com/logging/docs/>`_.
+  
+  
+  Attributes:
+      sampling_ratio:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.StackdriverLoggingConfig)
+    ),
+)
+_sym_db.RegisterMessage(StackdriverLoggingConfig)
+
+
+DESCRIPTOR._options = None
+_QUEUE._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/target.proto b/tasks/google/cloud/tasks_v2beta3/proto/target.proto
new file mode 100644
index 000000000000..f3ef089f40c6
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/target.proto
@@ -0,0 +1,440 @@
+// 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.tasks.v2beta3;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks";
+option java_multiple_files = true;
+option java_outer_classname = "TargetProto";
+option java_package = "com.google.cloud.tasks.v2beta3";
+
+// 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 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.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
+//   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.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,
+//     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;
+
+  // 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.v2beta3.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<string, string> headers = 3;
+
+  // HTTP request body.
+  //
+  // A request body is allowed only if the
+  // [HTTP method][google.cloud.tasks.v2beta3.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.v2beta3.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.v2beta3.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 queue.
+//
+// The task will be delivered to the App Engine application hostname
+// specified by its [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue] and [AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpRequest].
+// The documentation for [AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpRequest] explains how the
+// task's host URL is constructed.
+//
+// Using [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue] 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 AppEngineHttpQueue {
+  // Overrides for the
+  // [task-level app_engine_routing][google.cloud.tasks.v2beta3.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.v2beta3.AppEngineHttpRequest.app_engine_routing].
+  AppEngineRouting app_engine_routing_override = 1;
+}
+
+// App Engine HTTP request.
+//
+// The message defines the HTTP request that is sent to an App Engine app when
+// the task is dispatched.
+//
+// Using [AppEngineHttpRequest][google.cloud.tasks.v2beta3.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:
+//
+// `https://www.googleapis.com/auth/cloud-platform`
+//
+// The task will be delivered to the App Engine app which belongs to the same
+// project as the queue. For more information, see
+// [How Requests are
+// Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+// 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.v2beta3.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.v2beta3.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.v2beta3.AppEngineHttpRequest.app_engine_routing].
+//
+//
+// The `url` that the task will be sent to is:
+//
+// * `url =` [host][google.cloud.tasks.v2beta3.AppEngineRouting.host] `+`
+//   [relative_uri][google.cloud.tasks.v2beta3.AppEngineHttpRequest.relative_uri]
+//
+// 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][google.cloud.tasks.v2beta3.Task.dispatch_deadline]. Failed
+// tasks will be retried according to the
+// [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
+// 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.
+  //
+  // The app's request handler for the task's target URL must be able to handle
+  // HTTP requests with this http_method, otherwise the task attempt will fail
+  // with error code 405 (Method Not Allowed). See
+  // [Writing a push task request
+  // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler)
+  // and the documentation for the request handlers in the language your app is
+  // written in e.g.
+  // [Python Request
+  // Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass).
+  HttpMethod http_method = 1;
+
+  // Task-level setting for App Engine routing.
+  //
+  // If set,
+  // [app_engine_routing_override][google.cloud.tasks.v2beta3.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.v2beta3.AppEngineHttpRequest.app_engine_routing].
+  AppEngineRouting app_engine_routing = 2;
+
+  // The relative URI.
+  //
+  // The relative URI must begin with "/" and must be a valid HTTP relative URI.
+  // It can contain a path and query string arguments.
+  // If the relative URI is empty, then the root path "/" will be used.
+  // No spaces are allowed, and the maximum length allowed is 2083 characters.
+  string relative_uri = 3;
+
+  // 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].
+  // Repeated headers are not supported but a header value can contain commas.
+  //
+  // Cloud Tasks sets some headers to default values:
+  //
+  // * `User-Agent`: By default, this header is
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+  //   This header can be modified, but Cloud Tasks will append
+  //   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+  //   modified `User-Agent`.
+  //
+  // If the task has a [body][google.cloud.tasks.v2beta3.AppEngineHttpRequest.body], Cloud
+  // Tasks sets the following headers:
+  //
+  // * `Content-Type`: By default, the `Content-Type` header is set to
+  //   `"application/octet-stream"`. The default can be overridden by explicitly
+  //   setting `Content-Type` to a particular media type when the
+  //   [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+  //   For example, `Content-Type` can be set to `"application/json"`.
+  // * `Content-Length`: This is computed by Cloud Tasks. This value is
+  //   output only.   It cannot be changed.
+  //
+  // The headers below cannot be set or overridden:
+  //
+  // * `Host`
+  // * `X-Google-*`
+  // * `X-AppEngine-*`
+  //
+  // 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).
+  // 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.
+  //
+  // 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.v2beta3.Task]. For more
+  // information, see the [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask] documentation.
+  map<string, string> headers = 4;
+
+  // HTTP request body.
+  //
+  // A request body is allowed only if the HTTP method is POST or PUT. It is
+  // an error to set a body on a task with an incompatible [HttpMethod][google.cloud.tasks.v2beta3.HttpMethod].
+  bytes body = 5;
+}
+
+// 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),
+// [Microservices Architecture on Google App
+// Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+// [App Engine Standard request
+// 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).
+message AppEngineRouting {
+  // App service.
+  //
+  // By default, the task is sent to the service which is the default
+  // 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.v2beta3.AppEngineRouting.host] is not parsable
+  // into [service][google.cloud.tasks.v2beta3.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2beta3.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2beta3.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.v2beta3.AppEngineRouting.host] is not parsable, then
+  // [service][google.cloud.tasks.v2beta3.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2beta3.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2beta3.AppEngineRouting.instance] are the empty string.
+  string service = 1;
+
+  // App version.
+  //
+  // By default, the task is sent to the version which is the default
+  // 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.v2beta3.AppEngineRouting.host] is not parsable
+  // into [service][google.cloud.tasks.v2beta3.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2beta3.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2beta3.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.v2beta3.AppEngineRouting.host] is not parsable, then
+  // [service][google.cloud.tasks.v2beta3.AppEngineRouting.service],
+  // [version][google.cloud.tasks.v2beta3.AppEngineRouting.version], and
+  // [instance][google.cloud.tasks.v2beta3.AppEngineRouting.instance] are the empty string.
+  string version = 2;
+
+  // App instance.
+  //
+  // By default, the task is sent to an instance which is available when
+  // the task is attempted.
+  //
+  // Requests can only be sent to a specific instance if
+  // [manual scaling is used in App Engine
+  // Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+  // App Engine Flex does not support instances. For more information, see
+  // [App Engine Standard request
+  // 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).
+  string instance = 3;
+
+  // Output only. The host that the task is sent to.
+  //
+  // The host is constructed from the domain name of the app associated with
+  // the queue's project ID (for example <app-id>.appspot.com), and the
+  // [service][google.cloud.tasks.v2beta3.AppEngineRouting.service], [version][google.cloud.tasks.v2beta3.AppEngineRouting.version],
+  // and [instance][google.cloud.tasks.v2beta3.AppEngineRouting.instance]. Tasks which were created using
+  // the App Engine SDK might have a custom domain name.
+  //
+  // For more information, see
+  // [How Requests are
+  // Routed](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+  string host = 4;
+}
+
+// The HTTP method used to execute the task.
+enum HttpMethod {
+  // HTTP method unspecified
+  HTTP_METHOD_UNSPECIFIED = 0;
+
+  // HTTP POST
+  POST = 1;
+
+  // HTTP GET
+  GET = 2;
+
+  // HTTP HEAD
+  HEAD = 3;
+
+  // HTTP PUT
+  PUT = 4;
+
+  // HTTP DELETE
+  DELETE = 5;
+
+  // HTTP PATCH
+  PATCH = 6;
+
+  // 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/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py
new file mode 100644
index 000000000000..100e2dbcd347
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/target_pb2.py
@@ -0,0 +1,1186 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta3/proto/target.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta3/proto/target.proto",
+    package="google.cloud.tasks.v2beta3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta3B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks"
+    ),
+    serialized_pb=_b(
+        '\n-google/cloud/tasks_v2beta3/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto"\xf0\x02\n\x0bHttpRequest\x12\x0b\n\x03url\x18\x01 \x01(\t\x12;\n\x0bhttp_method\x18\x02 \x01(\x0e\x32&.google.cloud.tasks.v2beta3.HttpMethod\x12\x45\n\x07headers\x18\x03 \x03(\x0b\x32\x34.google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12=\n\x0boauth_token\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.OAuthTokenH\x00\x12;\n\noidc_token\x18\x06 \x01(\x0b\x32%.google.cloud.tasks.v2beta3.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"g\n\x12\x41ppEngineHttpQueue\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta3.AppEngineRouting"\xc1\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta3.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta3.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42p\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_HTTPMETHOD = _descriptor.EnumDescriptor(
+    name="HttpMethod",
+    full_name="google.cloud.tasks.v2beta3.HttpMethod",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="HTTP_METHOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POST", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="GET", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HEAD", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PUT", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DELETE", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PATCH", index=6, number=6, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OPTIONS", index=7, number=7, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1115,
+    serialized_end=1230,
+)
+_sym_db.RegisterEnumDescriptor(_HTTPMETHOD)
+
+HttpMethod = enum_type_wrapper.EnumTypeWrapper(_HTTPMETHOD)
+HTTP_METHOD_UNSPECIFIED = 0
+POST = 1
+GET = 2
+HEAD = 3
+PUT = 4
+DELETE = 5
+PATCH = 6
+OPTIONS = 7
+
+
+_HTTPREQUEST_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=406,
+    serialized_end=452,
+)
+
+_HTTPREQUEST = _descriptor.Descriptor(
+    name="HttpRequest",
+    full_name="google.cloud.tasks.v2beta3.HttpRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.http_method",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.headers",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.body",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oauth_token",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.oauth_token",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="oidc_token",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.oidc_token",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_HTTPREQUEST_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="authorization_header",
+            full_name="google.cloud.tasks.v2beta3.HttpRequest.authorization_header",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=108,
+    serialized_end=476,
+)
+
+
+_APPENGINEHTTPQUEUE = _descriptor.Descriptor(
+    name="AppEngineHttpQueue",
+    full_name="google.cloud.tasks.v2beta3.AppEngineHttpQueue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing_override",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpQueue.app_engine_routing_override",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=478,
+    serialized_end=581,
+)
+
+
+_APPENGINEHTTPREQUEST_HEADERSENTRY = _descriptor.Descriptor(
+    name="HeadersEntry",
+    full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=406,
+    serialized_end=452,
+)
+
+_APPENGINEHTTPREQUEST = _descriptor.Descriptor(
+    name="AppEngineHttpRequest",
+    full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.http_method",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_routing",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.app_engine_routing",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="relative_uri",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.relative_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.headers",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.tasks.v2beta3.AppEngineHttpRequest.body",
+            index=4,
+            number=5,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=584,
+    serialized_end=905,
+)
+
+
+_APPENGINEROUTING = _descriptor.Descriptor(
+    name="AppEngineRouting",
+    full_name="google.cloud.tasks.v2beta3.AppEngineRouting",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service",
+            full_name="google.cloud.tasks.v2beta3.AppEngineRouting.service",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.tasks.v2beta3.AppEngineRouting.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="instance",
+            full_name="google.cloud.tasks.v2beta3.AppEngineRouting.instance",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="host",
+            full_name="google.cloud.tasks.v2beta3.AppEngineRouting.host",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=907,
+    serialized_end=991,
+)
+
+
+_OAUTHTOKEN = _descriptor.Descriptor(
+    name="OAuthToken",
+    full_name="google.cloud.tasks.v2beta3.OAuthToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.cloud.tasks.v2beta3.OAuthToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scope",
+            full_name="google.cloud.tasks.v2beta3.OAuthToken.scope",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=993,
+    serialized_end=1051,
+)
+
+
+_OIDCTOKEN = _descriptor.Descriptor(
+    name="OidcToken",
+    full_name="google.cloud.tasks.v2beta3.OidcToken",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="service_account_email",
+            full_name="google.cloud.tasks.v2beta3.OidcToken.service_account_email",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audience",
+            full_name="google.cloud.tasks.v2beta3.OidcToken.audience",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1053,
+    serialized_end=1113,
+)
+
+_HTTPREQUEST_HEADERSENTRY.containing_type = _HTTPREQUEST
+_HTTPREQUEST.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_HTTPREQUEST.fields_by_name["headers"].message_type = _HTTPREQUEST_HEADERSENTRY
+_HTTPREQUEST.fields_by_name["oauth_token"].message_type = _OAUTHTOKEN
+_HTTPREQUEST.fields_by_name["oidc_token"].message_type = _OIDCTOKEN
+_HTTPREQUEST.oneofs_by_name["authorization_header"].fields.append(
+    _HTTPREQUEST.fields_by_name["oauth_token"]
+)
+_HTTPREQUEST.fields_by_name[
+    "oauth_token"
+].containing_oneof = _HTTPREQUEST.oneofs_by_name["authorization_header"]
+_HTTPREQUEST.oneofs_by_name["authorization_header"].fields.append(
+    _HTTPREQUEST.fields_by_name["oidc_token"]
+)
+_HTTPREQUEST.fields_by_name[
+    "oidc_token"
+].containing_oneof = _HTTPREQUEST.oneofs_by_name["authorization_header"]
+_APPENGINEHTTPQUEUE.fields_by_name[
+    "app_engine_routing_override"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPREQUEST_HEADERSENTRY.containing_type = _APPENGINEHTTPREQUEST
+_APPENGINEHTTPREQUEST.fields_by_name["http_method"].enum_type = _HTTPMETHOD
+_APPENGINEHTTPREQUEST.fields_by_name[
+    "app_engine_routing"
+].message_type = _APPENGINEROUTING
+_APPENGINEHTTPREQUEST.fields_by_name[
+    "headers"
+].message_type = _APPENGINEHTTPREQUEST_HEADERSENTRY
+DESCRIPTOR.message_types_by_name["HttpRequest"] = _HTTPREQUEST
+DESCRIPTOR.message_types_by_name["AppEngineHttpQueue"] = _APPENGINEHTTPQUEUE
+DESCRIPTOR.message_types_by_name["AppEngineHttpRequest"] = _APPENGINEHTTPREQUEST
+DESCRIPTOR.message_types_by_name["AppEngineRouting"] = _APPENGINEROUTING
+DESCRIPTOR.message_types_by_name["OAuthToken"] = _OAUTHTOKEN
+DESCRIPTOR.message_types_by_name["OidcToken"] = _OIDCTOKEN
+DESCRIPTOR.enum_types_by_name["HttpMethod"] = _HTTPMETHOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+HttpRequest = _reflection.GeneratedProtocolMessageType(
+    "HttpRequest",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_HTTPREQUEST_HEADERSENTRY,
+                __module__="google.cloud.tasks_v2beta3.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_HTTPREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.target_pb2",
+        __doc__="""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 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.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 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.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,
+     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).
+  
+  
+  Attributes:
+      url:
+          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.
+      http_method:
+          The HTTP method to use for the request. The default is POST.
+      headers:
+          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.v2beta3.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.
+      body:
+          HTTP request body.  A request body is allowed only if the
+          [HTTP
+          method][google.cloud.tasks.v2beta3.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.v2beta3.HttpMethod].
+      authorization_header:
+          The mode for generating an ``Authorization`` header for HTTP
+          requests.  If specified, all ``Authorization`` headers in the 
+          [HttpRequest.headers][google.cloud.tasks.v2beta3.HttpRequest.h
+          eaders] field will be overridden.
+      oauth_token:
+          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.
+      oidc_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.HttpRequest)
+    ),
+)
+_sym_db.RegisterMessage(HttpRequest)
+_sym_db.RegisterMessage(HttpRequest.HeadersEntry)
+
+AppEngineHttpQueue = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpQueue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEHTTPQUEUE,
+        __module__="google.cloud.tasks_v2beta3.proto.target_pb2",
+        __doc__="""App Engine HTTP queue.
+  
+  The task will be delivered to the App Engine application hostname
+  specified by its
+  [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue] and
+  [AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpRequest].
+  The documentation for
+  [AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpRequest]
+  explains how the task's host URL is constructed.
+  
+  Using
+  [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue]
+  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``
+  
+  
+  Attributes:
+      app_engine_routing_override:
+          Overrides for the [task-level app\_engine\_routing][google.clo
+          ud.tasks.v2beta3.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.v2beta3.AppEngi
+          neHttpRequest.app\_engine\_routing].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineHttpQueue)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpQueue)
+
+AppEngineHttpRequest = _reflection.GeneratedProtocolMessageType(
+    "AppEngineHttpRequest",
+    (_message.Message,),
+    dict(
+        HeadersEntry=_reflection.GeneratedProtocolMessageType(
+            "HeadersEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_APPENGINEHTTPREQUEST_HEADERSENTRY,
+                __module__="google.cloud.tasks_v2beta3.proto.target_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry)
+            ),
+        ),
+        DESCRIPTOR=_APPENGINEHTTPREQUEST,
+        __module__="google.cloud.tasks_v2beta3.proto.target_pb2",
+        __doc__="""App Engine HTTP request.
+  
+  The message defines the HTTP request that is sent to an App Engine app
+  when the task is dispatched.
+  
+  Using
+  [AppEngineHttpRequest][google.cloud.tasks.v2beta3.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:
+  
+  ``https://www.googleapis.com/auth/cloud-platform``
+  
+  The task will be delivered to the App Engine app which belongs to the
+  same project as the queue. For more information, see `How Requests are
+  Routed <https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed>`_
+  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.v2beta3.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.v2beta3.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.v2beta3.AppEngineHttpRequest.app\_engine\_routing].
+  
+  The ``url`` that the task will be sent to is:
+  
+  -  ``url =`` [host][google.cloud.tasks.v2beta3.AppEngineRouting.host]
+     ``+``
+     [relative\_uri][google.cloud.tasks.v2beta3.AppEngineHttpRequest.relative\_uri]
+  
+  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][google.cloud.tasks.v2beta3.Task.dispatch\_deadline]. Failed
+  tasks will be retried according to the [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 Requests) response from an
+  app handler does not cause traffic congestion control to throttle the
+  queue.
+  
+  
+  Attributes:
+      http_method:
+          The HTTP method to use for the request. The default is POST.
+          The app's request handler for the task's target URL must be
+          able to handle HTTP requests with this http\_method, otherwise
+          the task attempt will fail with error code 405 (Method Not
+          Allowed). See `Writing a push task request handler <https://cl
+          oud.google.com/appengine/docs/java/taskqueue/push/creating-
+          handlers#writing_a_push_task_request_handler>`_ and the
+          documentation for the request handlers in the language your
+          app is written in e.g. `Python Request Handler <https://cloud.
+          google.com/appengine/docs/python/tools/webapp/requesthandlercl
+          ass>`_.
+      app_engine_routing:
+          Task-level setting for App Engine routing.  If set, [app\_engi
+          ne\_routing\_override][google.cloud.tasks.v2beta3.AppEngineHtt
+          pQueue.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.v2beta3.AppEngi
+          neHttpRequest.app\_engine\_routing].
+      relative_uri:
+          The relative URI.  The relative URI must begin with "/" and
+          must be a valid HTTP relative URI. It can contain a path and
+          query string arguments. If the relative URI is empty, then the
+          root path "/" will be used. No spaces are allowed, and the
+          maximum length allowed is 2083 characters.
+      headers:
+          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].
+          Repeated headers are not supported but a header value can
+          contain commas.  Cloud Tasks sets some headers to default
+          values:  -  ``User-Agent``: By default, this header is
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"``.
+          This    header can be modified, but Cloud Tasks will append
+          ``"AppEngine-Google; (+http://code.google.com/appengine)"`` to
+          the    modified ``User-Agent``.  If the task has a
+          [body][google.cloud.tasks.v2beta3.AppEngineHttpRequest.body],
+          Cloud Tasks sets the following headers:  -  ``Content-Type``:
+          By default, the ``Content-Type`` header is set to
+          ``"application/octet-stream"``. The default can be overridden
+          by    explicitly setting ``Content-Type`` to a particular
+          media type when    the [task is
+          created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+          For    example, ``Content-Type`` can be set to
+          ``"application/json"``. -  ``Content-Length``: This is
+          computed by Cloud Tasks. This value is    output only. It
+          cannot be changed.  The headers below cannot be set or
+          overridden:  -  ``Host`` -  ``X-Google-*`` -
+          ``X-AppEngine-*``  In addition, Cloud Tasks sets some headers
+          when the task is dispatched, such as headers containing
+          information about the task; see `request headers <https://clou
+          d.google.com/appengine/docs/python/taskqueue/push/creating-
+          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.  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.v2beta3.Task]. For more information,
+          see the
+          [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]
+          documentation.
+      body:
+          HTTP request body.  A request body is allowed only if the HTTP
+          method is POST or PUT. It is an error to set a body on a task
+          with an incompatible
+          [HttpMethod][google.cloud.tasks.v2beta3.HttpMethod].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineHttpRequest)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineHttpRequest)
+_sym_db.RegisterMessage(AppEngineHttpRequest.HeadersEntry)
+
+AppEngineRouting = _reflection.GeneratedProtocolMessageType(
+    "AppEngineRouting",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_APPENGINEROUTING,
+        __module__="google.cloud.tasks_v2beta3.proto.target_pb2",
+        __doc__="""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>`_,
+  `Microservices Architecture on Google App
+  Engine <https://cloud.google.com/appengine/docs/python/microservices-on-app-engine>`_,
+  `App Engine Standard request
+  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>`_.
+  
+  
+  Attributes:
+      service:
+          App service.  By default, the task is sent to the service
+          which is the default 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.v2beta3.AppEngineRouting.host] is
+          not parsable into [service][google.cloud.tasks.v2beta3.AppEngi
+          neRouting.service], [version][google.cloud.tasks.v2beta3.AppEn
+          gineRouting.version], and [instance][google.cloud.tasks.v2beta
+          3.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.v2beta3.AppEngineRouting.host] is
+          not parsable, then [service][google.cloud.tasks.v2beta3.AppEng
+          ineRouting.service], [version][google.cloud.tasks.v2beta3.AppE
+          ngineRouting.version], and [instance][google.cloud.tasks.v2bet
+          a3.AppEngineRouting.instance] are the empty string.
+      version:
+          App version.  By default, the task is sent to the version
+          which is the default 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.v2beta3.AppEngineRouting.host] is
+          not parsable into [service][google.cloud.tasks.v2beta3.AppEngi
+          neRouting.service], [version][google.cloud.tasks.v2beta3.AppEn
+          gineRouting.version], and [instance][google.cloud.tasks.v2beta
+          3.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.v2beta3.AppEngineRouting.host] is
+          not parsable, then [service][google.cloud.tasks.v2beta3.AppEng
+          ineRouting.service], [version][google.cloud.tasks.v2beta3.AppE
+          ngineRouting.version], and [instance][google.cloud.tasks.v2bet
+          a3.AppEngineRouting.instance] are the empty string.
+      instance:
+          App instance.  By default, the task is sent to an instance
+          which is available when the task is attempted.  Requests can
+          only be sent to a specific instance if `manual scaling is used
+          in App Engine Standard
+          <https://cloud.google.com/appengine/docs/python/an-overview-
+          of-app-engine?hl=en_US#scaling_types_and_instance_classes>`_.
+          App Engine Flex does not support instances. For more
+          information, see `App Engine Standard request 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>`_.
+      host:
+          Output only. The host that the task is sent to.  The host is
+          constructed from the domain name of the app associated with
+          the queue's project ID (for example .appspot.com), and the [se
+          rvice][google.cloud.tasks.v2beta3.AppEngineRouting.service], [
+          version][google.cloud.tasks.v2beta3.AppEngineRouting.version],
+          and [instance][google.cloud.tasks.v2beta3.AppEngineRouting.ins
+          tance]. Tasks which were created using the App Engine SDK
+          might have a custom domain name.  For more information, see
+          `How Requests are Routed
+          <https://cloud.google.com/appengine/docs/standard/python/how-
+          requests-are-routed>`_.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineRouting)
+    ),
+)
+_sym_db.RegisterMessage(AppEngineRouting)
+
+OAuthToken = _reflection.GeneratedProtocolMessageType(
+    "OAuthToken",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OAUTHTOKEN,
+        __module__="google.cloud.tasks_v2beta3.proto.target_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      service_account_email:
+          `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.
+      scope:
+          OAuth scope to be used for generating OAuth access token. If
+          not specified, "https://www.googleapis.com/auth/cloud-
+          platform" will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.OAuthToken)
+    ),
+)
+_sym_db.RegisterMessage(OAuthToken)
+
+OidcToken = _reflection.GeneratedProtocolMessageType(
+    "OidcToken",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OIDCTOKEN,
+        __module__="google.cloud.tasks_v2beta3.proto.target_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      service_account_email:
+          `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.
+      audience:
+          Audience to be used when generating OIDC token. If not
+          specified, the URI specified in target will be used.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.OidcToken)
+    ),
+)
+_sym_db.RegisterMessage(OidcToken)
+
+
+DESCRIPTOR._options = None
+_HTTPREQUEST_HEADERSENTRY._options = None
+_APPENGINEHTTPREQUEST_HEADERSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/task.proto b/tasks/google/cloud/tasks_v2beta3/proto/task.proto
new file mode 100644
index 000000000000..573cc85027c1
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/task.proto
@@ -0,0 +1,193 @@
+// 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.tasks.v2beta3;
+
+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;
+option java_outer_classname = "TaskProto";
+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
+  // 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.
+  enum View {
+    // Unspecified. Defaults to BASIC.
+    VIEW_UNSPECIFIED = 0;
+
+    // The basic view omits fields which can be large or can contain
+    // sensitive data.
+    //
+    // This view does not include the
+    // [body in AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpRequest.body].
+    // Bodies 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.v2beta3.Task.View.FULL] requires
+    // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+    // permission on the [Queue][google.cloud.tasks.v2beta3.Queue] resource.
+    FULL = 2;
+  }
+
+  // Optionally caller-specified in [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+  //
+  // The task name.
+  //
+  // The task name must have the following format:
+  // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+  //
+  // * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+  //    hyphens (-), colons (:), or periods (.).
+  //    For more information, see
+  //    [Identifying
+  //    projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+  // * `LOCATION_ID` is the canonical ID for the task's location.
+  //    The list of available locations can be obtained by calling
+  //    [ListLocations][google.cloud.location.Locations.ListLocations].
+  //    For more information, see https://cloud.google.com/about/locations/.
+  // * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
+  //   hyphens (-). The maximum length is 100 characters.
+  // * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+  //   hyphens (-), or underscores (_). The maximum length is 500 characters.
+  string name = 1;
+
+  // Required. The message to send to the worker.
+  oneof payload_type {
+    // HTTP request that is sent to the App Engine app handler.
+    //
+    // An App Engine task is a task that has [AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpRequest] set.
+    AppEngineHttpRequest app_engine_http_request = 3;
+
+    // HTTP request that is sent to the task's target.
+    //
+    // An HTTP task is a task that has [HttpRequest][google.cloud.tasks.v2beta3.HttpRequest] set.
+    HttpRequest http_request = 11;
+  }
+
+  // The time when the task is scheduled to be attempted.
+  //
+  // For App Engine queues, this is when the task will be attempted or retried.
+  //
+  // `schedule_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp schedule_time = 4;
+
+  // Output only. The time that the task was created.
+  //
+  // `create_time` will be truncated to the nearest second.
+  google.protobuf.Timestamp create_time = 5;
+
+  // The deadline for requests sent to the worker. If the worker does not
+  // respond by this deadline then the request is cancelled and the attempt
+  // is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the
+  // task according to the [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig].
+  //
+  // Note that when the request is cancelled, Cloud Tasks will stop listing for
+  // the response, but whether the worker stops processing depends on the
+  // worker. For example, if the worker is stuck, it may not react to cancelled
+  // requests.
+  //
+  // The default and maximum values depend on the type of request:
+  //
+  // * For [HTTP tasks][google.cloud.tasks.v2beta3.HttpRequest], the default is 10 minutes. The deadline
+  //   must be in the interval [15 seconds, 30 minutes].
+  //
+  // * For [App Engine tasks][google.cloud.tasks.v2beta3.AppEngineHttpRequest], 0 indicates that the
+  //   request has the default deadline. The default deadline depends on the
+  //   [scaling
+  //   type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling)
+  //   of the service: 10 minutes for standard apps with automatic scaling, 24
+  //   hours for standard apps with manual and basic scaling, and 60 minutes for
+  //   flex apps. If the request deadline is set, it must be in the interval [15
+  //   seconds, 24 hours 15 seconds]. Regardless of the task's
+  //   `dispatch_deadline`, the app handler will not run for longer than than
+  //   the service's timeout. We recommend setting the `dispatch_deadline` to
+  //   at most a few seconds more than the app handler's timeout. For more
+  //   information see
+  //   [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts).
+  //
+  // `dispatch_deadline` will be truncated to the nearest millisecond. The
+  // deadline is an approximate deadline.
+  google.protobuf.Duration dispatch_deadline = 12;
+
+  // Output only. The number of attempts dispatched.
+  //
+  // This count includes attempts which have been dispatched but haven't
+  // received a response.
+  int32 dispatch_count = 6;
+
+  // Output only. The number of attempts which have received a response.
+  int32 response_count = 7;
+
+  // Output only. The status of the task's first attempt.
+  //
+  // Only [dispatch_time][google.cloud.tasks.v2beta3.Attempt.dispatch_time] will be set.
+  // The other [Attempt][google.cloud.tasks.v2beta3.Attempt] information is not retained by Cloud Tasks.
+  Attempt first_attempt = 8;
+
+  // Output only. The status of the task's last attempt.
+  Attempt last_attempt = 9;
+
+  // Output only. The view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] has
+  // been returned.
+  View view = 10;
+}
+
+// The status of a task attempt.
+message Attempt {
+  // Output only. The time that this attempt was scheduled.
+  //
+  // `schedule_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp schedule_time = 1;
+
+  // Output only. The time that this attempt was dispatched.
+  //
+  // `dispatch_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp dispatch_time = 2;
+
+  // Output only. The time that this attempt response was received.
+  //
+  // `response_time` will be truncated to the nearest microsecond.
+  google.protobuf.Timestamp response_time = 3;
+
+  // Output only. The response from the worker for this attempt.
+  //
+  // If `response_time` is unset, then the task has not been attempted or is
+  // currently running and the `response_status` field is meaningless.
+  google.rpc.Status response_status = 4;
+}
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py b/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py
new file mode 100644
index 000000000000..7898b8fcf889
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/task_pb2.py
@@ -0,0 +1,587 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/tasks_v2beta3/proto/task.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.cloud.tasks_v2beta3.proto import (
+    target_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/tasks_v2beta3/proto/task.proto",
+    package="google.cloud.tasks.v2beta3",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\036com.google.cloud.tasks.v2beta3B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/tasks_v2beta3/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x05\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta3.AppEngineHttpRequestH\x00\x12?\n\x0chttp_request\x18\x0b \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x0c \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x06 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x07 \x01(\x05\x12:\n\rfirst_attempt\x18\x08 \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x39\n\x0clast_attempt\x18\t \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x33\n\x04view\x18\n \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta3B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TASK_VIEW = _descriptor.EnumDescriptor(
+    name="View",
+    full_name="google.cloud.tasks.v2beta3.Task.View",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VIEW_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BASIC", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=816,
+    serialized_end=865,
+)
+_sym_db.RegisterEnumDescriptor(_TASK_VIEW)
+
+
+_TASK = _descriptor.Descriptor(
+    name="Task",
+    full_name="google.cloud.tasks.v2beta3.Task",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.tasks.v2beta3.Task.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="app_engine_http_request",
+            full_name="google.cloud.tasks.v2beta3.Task.app_engine_http_request",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_request",
+            full_name="google.cloud.tasks.v2beta3.Task.http_request",
+            index=2,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta3.Task.schedule_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.tasks.v2beta3.Task.create_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_deadline",
+            full_name="google.cloud.tasks.v2beta3.Task.dispatch_deadline",
+            index=5,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_count",
+            full_name="google.cloud.tasks.v2beta3.Task.dispatch_count",
+            index=6,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_count",
+            full_name="google.cloud.tasks.v2beta3.Task.response_count",
+            index=7,
+            number=7,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="first_attempt",
+            full_name="google.cloud.tasks.v2beta3.Task.first_attempt",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="last_attempt",
+            full_name="google.cloud.tasks.v2beta3.Task.last_attempt",
+            index=9,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.cloud.tasks.v2beta3.Task.view",
+            index=10,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TASK_VIEW],
+    serialized_options=_b(
+        "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+    ),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="payload_type",
+            full_name="google.cloud.tasks.v2beta3.Task.payload_type",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=270,
+    serialized_end=987,
+)
+
+
+_ATTEMPT = _descriptor.Descriptor(
+    name="Attempt",
+    full_name="google.cloud.tasks.v2beta3.Attempt",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.tasks.v2beta3.Attempt.schedule_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dispatch_time",
+            full_name="google.cloud.tasks.v2beta3.Attempt.dispatch_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_time",
+            full_name="google.cloud.tasks.v2beta3.Attempt.response_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="response_status",
+            full_name="google.cloud.tasks.v2beta3.Attempt.response_status",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=990,
+    serialized_end=1197,
+)
+
+_TASK.fields_by_name[
+    "app_engine_http_request"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2._APPENGINEHTTPREQUEST
+)
+_TASK.fields_by_name[
+    "http_request"
+].message_type = (
+    google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2._HTTPREQUEST
+)
+_TASK.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TASK.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TASK.fields_by_name[
+    "dispatch_deadline"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TASK.fields_by_name["first_attempt"].message_type = _ATTEMPT
+_TASK.fields_by_name["last_attempt"].message_type = _ATTEMPT
+_TASK.fields_by_name["view"].enum_type = _TASK_VIEW
+_TASK_VIEW.containing_type = _TASK
+_TASK.oneofs_by_name["payload_type"].fields.append(
+    _TASK.fields_by_name["app_engine_http_request"]
+)
+_TASK.fields_by_name["app_engine_http_request"].containing_oneof = _TASK.oneofs_by_name[
+    "payload_type"
+]
+_TASK.oneofs_by_name["payload_type"].fields.append(_TASK.fields_by_name["http_request"])
+_TASK.fields_by_name["http_request"].containing_oneof = _TASK.oneofs_by_name[
+    "payload_type"
+]
+_ATTEMPT.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "dispatch_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "response_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ATTEMPT.fields_by_name[
+    "response_status"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+DESCRIPTOR.message_types_by_name["Task"] = _TASK
+DESCRIPTOR.message_types_by_name["Attempt"] = _ATTEMPT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Task = _reflection.GeneratedProtocolMessageType(
+    "Task",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TASK,
+        __module__="google.cloud.tasks_v2beta3.proto.task_pb2",
+        __doc__="""A unit of scheduled work.
+  
+  
+  Attributes:
+      name:
+          Optionally caller-specified in [CreateTask][google.cloud.tasks
+          .v2beta3.CloudTasks.CreateTask].  The task name.  The task
+          name must have the following format: ``projects/PROJECT_ID/loc
+          ations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID``  -
+          ``PROJECT_ID`` can contain letters ([A-Za-z]), numbers
+          ([0-9]),    hyphens (-), colons (:), or periods (.). For more
+          information, see    `Identifying    projects
+          <https://cloud.google.com/resource-manager/docs/creating-
+          managing-projects#identifying_projects>`_ -  ``LOCATION_ID``
+          is the canonical ID for the task's location. The list    of
+          available locations can be obtained by calling    [ListLocatio
+          ns][google.cloud.location.Locations.ListLocations]. For
+          more information, see
+          https://cloud.google.com/about/locations/. -  ``QUEUE_ID`` can
+          contain letters ([A-Za-z]), numbers ([0-9]), or    hyphens
+          (-). The maximum length is 100 characters. -  ``TASK_ID`` can
+          contain only letters ([A-Za-z]), numbers ([0-9]),    hyphens
+          (-), or underscores (\_). The maximum length is 500
+          characters.
+      payload_type:
+          Required. The message to send to the worker.
+      app_engine_http_request:
+          HTTP request that is sent to the App Engine app handler.  An
+          App Engine task is a task that has [AppEngineHttpRequest][goog
+          le.cloud.tasks.v2beta3.AppEngineHttpRequest] set.
+      http_request:
+          HTTP request that is sent to the task's target.  An HTTP task
+          is a task that has
+          [HttpRequest][google.cloud.tasks.v2beta3.HttpRequest] set.
+      schedule_time:
+          The time when the task is scheduled to be attempted.  For App
+          Engine queues, this is when the task will be attempted or
+          retried.  ``schedule_time`` will be truncated to the nearest
+          microsecond.
+      create_time:
+          Output only. The time that the task was created.
+          ``create_time`` will be truncated to the nearest second.
+      dispatch_deadline:
+          The deadline for requests sent to the worker. If the worker
+          does not respond by this deadline then the request is
+          cancelled and the attempt is marked as a ``DEADLINE_EXCEEDED``
+          failure. Cloud Tasks will retry the task according to the
+          [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig].  Note
+          that when the request is cancelled, Cloud Tasks will stop
+          listing for the response, but whether the worker stops
+          processing depends on the worker. For example, if the worker
+          is stuck, it may not react to cancelled requests.  The default
+          and maximum values depend on the type of request:  -  For
+          [HTTP tasks][google.cloud.tasks.v2beta3.HttpRequest], the
+          default    is 10 minutes. The deadline must be in the interval
+          [15 seconds, 30    minutes].  -  For [App Engine
+          tasks][google.cloud.tasks.v2beta3.AppEngineHttpRequest], 0
+          indicates    that the request has the default deadline. The
+          default deadline    depends on the `scaling    type
+          <https://cloud.google.com/appengine/docs/standard/go/how-
+          instances-are-managed#instance_scaling>`_    of the service:
+          10 minutes for standard apps with automatic scaling,    24
+          hours for standard apps with manual and basic scaling, and 60
+          minutes for flex apps. If the request deadline is set, it must
+          be in    the interval [15 seconds, 24 hours 15 seconds].
+          Regardless of the    task's ``dispatch_deadline``, the app
+          handler will not run for longer    than than the service's
+          timeout. We recommend setting the    ``dispatch_deadline`` to
+          at most a few seconds more than the app    handler's timeout.
+          For more information see    `Timeouts
+          <https://cloud.google.com/tasks/docs/creating-appengine-
+          handlers#timeouts>`_.  ``dispatch_deadline`` will be
+          truncated to the nearest millisecond. The deadline is an
+          approximate deadline.
+      dispatch_count:
+          Output only. The number of attempts dispatched.  This count
+          includes attempts which have been dispatched but haven't
+          received a response.
+      response_count:
+          Output only. The number of attempts which have received a
+          response.
+      first_attempt:
+          Output only. The status of the task's first attempt.  Only [di
+          spatch\_time][google.cloud.tasks.v2beta3.Attempt.dispatch\_tim
+          e] will be set. The other
+          [Attempt][google.cloud.tasks.v2beta3.Attempt] information is
+          not retained by Cloud Tasks.
+      last_attempt:
+          Output only. The status of the task's last attempt.
+      view:
+          Output only. The view specifies which subset of the
+          [Task][google.cloud.tasks.v2beta3.Task] has been returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.Task)
+    ),
+)
+_sym_db.RegisterMessage(Task)
+
+Attempt = _reflection.GeneratedProtocolMessageType(
+    "Attempt",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ATTEMPT,
+        __module__="google.cloud.tasks_v2beta3.proto.task_pb2",
+        __doc__="""The status of a task attempt.
+  
+  
+  Attributes:
+      schedule_time:
+          Output only. The time that this attempt was scheduled.
+          ``schedule_time`` will be truncated to the nearest
+          microsecond.
+      dispatch_time:
+          Output only. The time that this attempt was dispatched.
+          ``dispatch_time`` will be truncated to the nearest
+          microsecond.
+      response_time:
+          Output only. The time that this attempt response was received.
+          ``response_time`` will be truncated to the nearest
+          microsecond.
+      response_status:
+          Output only. The response from the worker for this attempt.
+          If ``response_time`` is unset, then the task has not been
+          attempted or is currently running and the ``response_status``
+          field is meaningless.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.Attempt)
+    ),
+)
+_sym_db.RegisterMessage(Attempt)
+
+
+DESCRIPTOR._options = None
+_TASK._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/tasks/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py b/tasks/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/tasks/google/cloud/tasks_v2beta3/types.py b/tasks/google/cloud/tasks_v2beta3/types.py
new file mode 100644
index 000000000000..cfd91ae49e5d
--- /dev/null
+++ b/tasks/google/cloud/tasks_v2beta3/types.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.tasks_v2beta3.proto import cloudtasks_pb2
+from google.cloud.tasks_v2beta3.proto import queue_pb2
+from google.cloud.tasks_v2beta3.proto import target_pb2
+from google.cloud.tasks_v2beta3.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import options_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+from google.type import expr_pb2
+
+
+_shared_modules = [
+    iam_policy_pb2,
+    options_pb2,
+    policy_pb2,
+    any_pb2,
+    duration_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    status_pb2,
+    expr_pb2,
+]
+
+_local_modules = [cloudtasks_pb2, queue_pb2, target_pb2, task_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.tasks_v2beta3.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/tasks/noxfile.py b/tasks/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/tasks/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/tasks/setup.cfg b/tasks/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/tasks/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/tasks/setup.py b/tasks/setup.py
new file mode 100644
index 000000000000..3b7afc41b737
--- /dev/null
+++ b/tasks/setup.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-tasks"
+description = "Cloud Tasks API API client library"
+version = "1.2.1"
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "grpc-google-iam-v1 >= 0.12.3, < 0.13dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/tasks/synth.metadata b/tasks/synth.metadata
new file mode 100644
index 000000000000..86ec1727e79d
--- /dev/null
+++ b/tasks/synth.metadata
@@ -0,0 +1,59 @@
+{
+  "updateTime": "2019-08-21T12:39:33.815307Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.34.0",
+        "dockerImage": "googleapis/artman@sha256:38a27ba6245f96c3e86df7acb2ebcc33b4f186d9e475efe2d64303aec3d4e0ea"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "11592a15391951348a64f5c303399733b1c5b3b2",
+        "internalRef": "264425502"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "tasks",
+        "apiVersion": "v2beta2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/tasks/artman_cloudtasks_v2beta2.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "tasks",
+        "apiVersion": "v2beta3",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/tasks/artman_cloudtasks_v2beta3.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "tasks",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/tasks/artman_cloudtasks_v2.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/tasks/synth.py b/tasks/synth.py
new file mode 100644
index 000000000000..a5eeca136543
--- /dev/null
+++ b/tasks/synth.py
@@ -0,0 +1,92 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+import logging
+
+logging.basicConfig(level=logging.DEBUG)
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+excludes = ["README.rst", "setup.py", "nox*.py", "docs/index.rst"]
+
+# ----------------------------------------------------------------------------
+# Generate tasks GAPIC layer
+# ----------------------------------------------------------------------------
+for version in ["v2beta2", "v2beta3", "v2"]:
+    library = gapic.py_library(
+        "tasks",
+        version,
+        config_path=f"artman_cloudtasks_{version}.yaml",
+        include_protos=True,
+    )
+
+    s.copy(library, excludes=excludes)
+
+    s.replace(
+        f"google/cloud/tasks_{version}/gapic/cloud_tasks_client.py",
+        "(Google IAM .*?_) ",
+        "\g<1>_ ",
+    )
+
+    # Issues with Anonymous ('__') links. Change to named.
+    s.replace(f"google/cloud/tasks_{version}/proto/*.py", ">`__", ">`_")
+
+# Wrapped link fails due to space in link (v2beta2)
+s.replace(
+    "google/cloud/tasks_v2beta2/proto/queue_pb2.py",
+    "(in queue.yaml/xml) <\n\s+",
+    "\g<1>\n          <",
+)
+
+# Wrapped link fails due to newline (v2)
+s.replace(
+    "google/cloud/tasks_v2/proto/queue_pb2.py",
+    """#retry_parameters>
+          `__\.""",
+    "#retry_parameters>`__.",
+)
+
+# Restore updated example from PR #7025.
+s.replace(
+    "google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py",
+    ">>> # TODO: Initialize `queue`:",
+    ">>> # Initialize `queue`:",
+)
+s.replace(
+    "google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py",
+    "^(\s+)>>> queue = {}\n",
+    "\g<1>>>> queue = {\n"
+    "\g<1>...     # The fully qualified path to the queue\n"
+    "\g<1>...     'name': client.queue_path('[PROJECT]', '[LOCATION]', '[NAME]'),\n"
+    "\g<1>...     'app_engine_http_queue': {\n"
+    "\g<1>...         'app_engine_routing_override': {\n"
+    "\g<1>...             # The App Engine service that will receive the tasks.\n"
+    "\g<1>...             'service': 'default',\n"
+    "\g<1>...         },\n"
+    "\g<1>...     },\n"
+    "\g<1>... }\n",
+)
+
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/tasks/tests/system/gapic/v2/test_system_tasks_v2.py b/tasks/tests/system/gapic/v2/test_system_tasks_v2.py
new file mode 100644
index 000000000000..ff6c8243f97c
--- /dev/null
+++ b/tasks/tests/system/gapic/v2/test_system_tasks_v2.py
@@ -0,0 +1,26 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from google.cloud import tasks_v2
+
+
+class TestSystemTasks(object):
+    def test_list_queues(self):
+        client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path(os.environ["PROJECT_ID"], "us-central1")
+        client.list_queues(parent)
diff --git a/tasks/tests/unit/gapic/v2/test_cloud_tasks_client_v2.py b/tasks/tests/unit/gapic/v2/test_cloud_tasks_client_v2.py
new file mode 100644
index 000000000000..884c07d8bc9f
--- /dev/null
+++ b/tasks/tests/unit/gapic/v2/test_cloud_tasks_client_v2.py
@@ -0,0 +1,703 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import tasks_v2
+from google.cloud.tasks_v2.proto import cloudtasks_pb2
+from google.cloud.tasks_v2.proto import queue_pb2
+from google.cloud.tasks_v2.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudTasksClient(object):
+    def test_list_queues(self):
+        # Setup Expected Response
+        next_page_token = ""
+        queues_element = {}
+        queues = [queues_element]
+        expected_response = {"next_page_token": next_page_token, "queues": queues}
+        expected_response = cloudtasks_pb2.ListQueuesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_queues(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.queues[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ListQueuesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_queues_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_queues(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.get_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.GetQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.get_queue(name)
+
+    def test_create_queue(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        queue = {}
+
+        response = client.create_queue(parent, queue)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        queue = {}
+
+        with pytest.raises(CustomException):
+            client.create_queue(parent, queue)
+
+    def test_update_queue(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        queue = {}
+
+        response = client.update_queue(queue)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.UpdateQueueRequest(queue=queue)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        queue = {}
+
+        with pytest.raises(CustomException):
+            client.update_queue(queue)
+
+    def test_delete_queue(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        client.delete_queue(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.DeleteQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.delete_queue(name)
+
+    def test_purge_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.purge_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.PurgeQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_purge_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.purge_queue(name)
+
+    def test_pause_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.pause_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.PauseQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pause_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.pause_queue(name)
+
+    def test_resume_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.resume_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ResumeQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_resume_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.resume_queue(name)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
+
+    def test_list_tasks(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tasks_element = {}
+        tasks = [tasks_element]
+        expected_response = {"next_page_token": next_page_token, "tasks": tasks}
+        expected_response = cloudtasks_pb2.ListTasksResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        paged_list_response = client.list_tasks(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tasks[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ListTasksRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tasks_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        paged_list_response = client.list_tasks(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_task(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        dispatch_count = 1217252086
+        response_count = 424727441
+        expected_response = {
+            "name": name_2,
+            "dispatch_count": dispatch_count,
+            "response_count": response_count,
+        }
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        response = client.get_task(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.GetTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.get_task(name)
+
+    def test_create_task(self):
+        # Setup Expected Response
+        name = "name3373707"
+        dispatch_count = 1217252086
+        response_count = 424727441
+        expected_response = {
+            "name": name,
+            "dispatch_count": dispatch_count,
+            "response_count": response_count,
+        }
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        task = {}
+
+        response = client.create_task(parent, task)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CreateTaskRequest(parent=parent, task=task)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        task = {}
+
+        with pytest.raises(CustomException):
+            client.create_task(parent, task)
+
+    def test_delete_task(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        client.delete_task(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.DeleteTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.delete_task(name)
+
+    def test_run_task(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        dispatch_count = 1217252086
+        response_count = 424727441
+        expected_response = {
+            "name": name_2,
+            "dispatch_count": dispatch_count,
+            "response_count": response_count,
+        }
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        response = client.run_task(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.RunTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.run_task(name)
diff --git a/tasks/tests/unit/gapic/v2beta2/test_cloud_tasks_client_v2beta2.py b/tasks/tests/unit/gapic/v2beta2/test_cloud_tasks_client_v2beta2.py
new file mode 100644
index 000000000000..7aa9d9033334
--- /dev/null
+++ b/tasks/tests/unit/gapic/v2beta2/test_cloud_tasks_client_v2beta2.py
@@ -0,0 +1,849 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import tasks_v2beta2
+from google.cloud.tasks_v2beta2.proto import cloudtasks_pb2
+from google.cloud.tasks_v2beta2.proto import queue_pb2
+from google.cloud.tasks_v2beta2.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudTasksClient(object):
+    def test_list_queues(self):
+        # Setup Expected Response
+        next_page_token = ""
+        queues_element = {}
+        queues = [queues_element]
+        expected_response = {"next_page_token": next_page_token, "queues": queues}
+        expected_response = cloudtasks_pb2.ListQueuesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_queues(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.queues[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ListQueuesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_queues_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_queues(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.get_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.GetQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.get_queue(name)
+
+    def test_create_queue(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        queue = {}
+
+        response = client.create_queue(parent, queue)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        queue = {}
+
+        with pytest.raises(CustomException):
+            client.create_queue(parent, queue)
+
+    def test_update_queue(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        queue = {}
+
+        response = client.update_queue(queue)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.UpdateQueueRequest(queue=queue)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        queue = {}
+
+        with pytest.raises(CustomException):
+            client.update_queue(queue)
+
+    def test_delete_queue(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        client.delete_queue(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.DeleteQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.delete_queue(name)
+
+    def test_purge_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.purge_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.PurgeQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_purge_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.purge_queue(name)
+
+    def test_pause_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.pause_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.PauseQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pause_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.pause_queue(name)
+
+    def test_resume_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.resume_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ResumeQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_resume_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.resume_queue(name)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
+
+    def test_list_tasks(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tasks_element = {}
+        tasks = [tasks_element]
+        expected_response = {"next_page_token": next_page_token, "tasks": tasks}
+        expected_response = cloudtasks_pb2.ListTasksResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        paged_list_response = client.list_tasks(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tasks[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ListTasksRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tasks_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        paged_list_response = client.list_tasks(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_task(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        response = client.get_task(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.GetTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.get_task(name)
+
+    def test_create_task(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        task = {}
+
+        response = client.create_task(parent, task)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CreateTaskRequest(parent=parent, task=task)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        task = {}
+
+        with pytest.raises(CustomException):
+            client.create_task(parent, task)
+
+    def test_delete_task(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        client.delete_task(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.DeleteTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.delete_task(name)
+
+    def test_lease_tasks(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloudtasks_pb2.LeaseTasksResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        lease_duration = {}
+
+        response = client.lease_tasks(parent, lease_duration)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.LeaseTasksRequest(
+            parent=parent, lease_duration=lease_duration
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_lease_tasks_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        lease_duration = {}
+
+        with pytest.raises(CustomException):
+            client.lease_tasks(parent, lease_duration)
+
+    def test_acknowledge_task(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+        schedule_time = {}
+
+        client.acknowledge_task(name, schedule_time)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.AcknowledgeTaskRequest(
+            name=name, schedule_time=schedule_time
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_acknowledge_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+        schedule_time = {}
+
+        with pytest.raises(CustomException):
+            client.acknowledge_task(name, schedule_time)
+
+    def test_renew_lease(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+        schedule_time = {}
+        lease_duration = {}
+
+        response = client.renew_lease(name, schedule_time, lease_duration)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.RenewLeaseRequest(
+            name=name, schedule_time=schedule_time, lease_duration=lease_duration
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_renew_lease_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+        schedule_time = {}
+        lease_duration = {}
+
+        with pytest.raises(CustomException):
+            client.renew_lease(name, schedule_time, lease_duration)
+
+    def test_cancel_lease(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+        schedule_time = {}
+
+        response = client.cancel_lease(name, schedule_time)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CancelLeaseRequest(
+            name=name, schedule_time=schedule_time
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_cancel_lease_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+        schedule_time = {}
+
+        with pytest.raises(CustomException):
+            client.cancel_lease(name, schedule_time)
+
+    def test_run_task(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        response = client.run_task(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.RunTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta2.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.run_task(name)
diff --git a/tasks/tests/unit/gapic/v2beta3/test_cloud_tasks_client_v2beta3.py b/tasks/tests/unit/gapic/v2beta3/test_cloud_tasks_client_v2beta3.py
new file mode 100644
index 000000000000..0e53b80bfa14
--- /dev/null
+++ b/tasks/tests/unit/gapic/v2beta3/test_cloud_tasks_client_v2beta3.py
@@ -0,0 +1,703 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import tasks_v2beta3
+from google.cloud.tasks_v2beta3.proto import cloudtasks_pb2
+from google.cloud.tasks_v2beta3.proto import queue_pb2
+from google.cloud.tasks_v2beta3.proto import task_pb2
+from google.iam.v1 import iam_policy_pb2
+from google.iam.v1 import policy_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestCloudTasksClient(object):
+    def test_list_queues(self):
+        # Setup Expected Response
+        next_page_token = ""
+        queues_element = {}
+        queues = [queues_element]
+        expected_response = {"next_page_token": next_page_token, "queues": queues}
+        expected_response = cloudtasks_pb2.ListQueuesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_queues(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.queues[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ListQueuesRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_queues_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_queues(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.get_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.GetQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.get_queue(name)
+
+    def test_create_queue(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        queue = {}
+
+        response = client.create_queue(parent, queue)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        queue = {}
+
+        with pytest.raises(CustomException):
+            client.create_queue(parent, queue)
+
+    def test_update_queue(self):
+        # Setup Expected Response
+        name = "name3373707"
+        expected_response = {"name": name}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        queue = {}
+
+        response = client.update_queue(queue)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.UpdateQueueRequest(queue=queue)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        queue = {}
+
+        with pytest.raises(CustomException):
+            client.update_queue(queue)
+
+    def test_delete_queue(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        client.delete_queue(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.DeleteQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.delete_queue(name)
+
+    def test_purge_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.purge_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.PurgeQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_purge_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.purge_queue(name)
+
+    def test_pause_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.pause_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.PauseQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_pause_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.pause_queue(name)
+
+    def test_resume_queue(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = queue_pb2.Queue(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.resume_queue(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ResumeQueueRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_resume_queue_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.resume_queue(name)
+
+    def test_get_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        response = client.get_iam_policy(resource)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.GetIamPolicyRequest(resource=resource)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        with pytest.raises(CustomException):
+            client.get_iam_policy(resource)
+
+    def test_set_iam_policy(self):
+        # Setup Expected Response
+        version = 351608024
+        etag = b"21"
+        expected_response = {"version": version, "etag": etag}
+        expected_response = policy_pb2.Policy(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        policy = {}
+
+        response = client.set_iam_policy(resource, policy)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.SetIamPolicyRequest(
+            resource=resource, policy=policy
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_set_iam_policy_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        policy = {}
+
+        with pytest.raises(CustomException):
+            client.set_iam_policy(resource, policy)
+
+    def test_test_iam_permissions(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = iam_policy_pb2.TestIamPermissionsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        permissions = []
+
+        response = client.test_iam_permissions(resource, permissions)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = iam_policy_pb2.TestIamPermissionsRequest(
+            resource=resource, permissions=permissions
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_test_iam_permissions_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        resource = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        permissions = []
+
+        with pytest.raises(CustomException):
+            client.test_iam_permissions(resource, permissions)
+
+    def test_list_tasks(self):
+        # Setup Expected Response
+        next_page_token = ""
+        tasks_element = {}
+        tasks = [tasks_element]
+        expected_response = {"next_page_token": next_page_token, "tasks": tasks}
+        expected_response = cloudtasks_pb2.ListTasksResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        paged_list_response = client.list_tasks(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.tasks[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.ListTasksRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_tasks_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+
+        paged_list_response = client.list_tasks(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_task(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        dispatch_count = 1217252086
+        response_count = 424727441
+        expected_response = {
+            "name": name_2,
+            "dispatch_count": dispatch_count,
+            "response_count": response_count,
+        }
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        response = client.get_task(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.GetTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.get_task(name)
+
+    def test_create_task(self):
+        # Setup Expected Response
+        name = "name3373707"
+        dispatch_count = 1217252086
+        response_count = 424727441
+        expected_response = {
+            "name": name,
+            "dispatch_count": dispatch_count,
+            "response_count": response_count,
+        }
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        task = {}
+
+        response = client.create_task(parent, task)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.CreateTaskRequest(parent=parent, task=task)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        parent = client.queue_path("[PROJECT]", "[LOCATION]", "[QUEUE]")
+        task = {}
+
+        with pytest.raises(CustomException):
+            client.create_task(parent, task)
+
+    def test_delete_task(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        client.delete_task(name)
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.DeleteTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.delete_task(name)
+
+    def test_run_task(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        dispatch_count = 1217252086
+        response_count = 424727441
+        expected_response = {
+            "name": name_2,
+            "dispatch_count": dispatch_count,
+            "response_count": response_count,
+        }
+        expected_response = task_pb2.Task(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup Request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        response = client.run_task(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloudtasks_pb2.RunTaskRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_run_task_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = tasks_v2beta3.CloudTasksClient()
+
+        # Setup request
+        name = client.task_path("[PROJECT]", "[LOCATION]", "[QUEUE]", "[TASK]")
+
+        with pytest.raises(CustomException):
+            client.run_task(name)
diff --git a/test_utils/credentials.json.enc b/test_utils/credentials.json.enc
new file mode 100644
index 000000000000..f073c7e4f774
--- /dev/null
+++ b/test_utils/credentials.json.enc
@@ -0,0 +1,49 @@
+U2FsdGVkX1/vVm/dOEg1DCACYbdOcL+ey6+64A+DZGZVgF8Z/3skK6rpPocu6GOA
+UZAqASsBH9QifDf8cKVXQXVYpYq6HSv2O0w7vOmVorZO9GYPo98s9/8XO+4ty/AU
+aB6TD68frBAYv4cT/l5m7aYdzfzMTy0EOXoleZT09JYP3B5FV3KCO114FzMXGwrj
+HXsR6E5SyUUlUnWPC3eD3aqmovay0gxOKYO3ZwjFK1nlbN/8q6/8nwBCf/Bg6SHV
+V93pNxdolRlJev9kgKz4RN1z4jGCy5PAndhSLE82NFIs9LoAiEOU5YeMlN+Ulqus
+J92nh+ptUe9a4pJGbAuveUWO7zdS1QyXvTMUcmmSfXCNm/eIQjNuu5+rHtIjWKh8
+Ilwj2w1aTfSptQEhk/kwRgFz/d11vfwJzvwTmCxO6zyOeL0VUWLqdCBGgG5As9He
+/RenF8PZ1O0WbTt7fns5oTlTk/MUo+0xJ1xqvu/y45LaqqcBAnEdrWKmtM3dJHWv
+ufQku+kD+83F/VwBnQdvgMHu6KZEs6LRrNo58r4QuK6fS7VCACdzxID1RM2cL7kT
+6BFRlyGj1aigmjne9g9M9Jx4R+mZDpPU1WDzzG71J4qCUwaX8Dfwutuv4uiFvzwq
+NUF0wLJJPtKWmtW+hnZ/fhHQGCRsOpZzFnqp6Zv7J7k6esqxMgIjfal7Djk5Acy8
+j3iVvm6CYmKMVqzL62JHYS9Ye83tzBCaR8hpnJQKgH3FSOFY8HSwrtQSIsl/hSeF
+41sgnz0Y+/gkzNeU18qFk+eCZmvljyu+JK0nPYUgpOCJYVBNQpNHz5PUyiAEKhtM
+IOSdjPRW1Y+Xf4RroJnLPoF24Ijwrow5LCm9hBRY6TPPMMmnIXCd23xcLJ1rMj6g
+x4ZikElans+cwuc9wtbb7w01DcpTwQ1+eIV1qV+KIgpnLjRGLhZD4etobBsrwYu/
+vnIwy2QHCKENPb8sbdgp7x2mF7VSX0/7tf+9+i70EBiMzpOKBkiZhtLzm6hOBkEy
+ODaWrx4lTTwbSw8Rmtf58APhPFMsjHoNsjiUoK249Y8Y2Ff4fMfqYsXu6VC1n/At
+CuWYHc3EfBwFcLJS+RQB9kFk/4FygFBWq4Kj0MqoRruLbKmoGeJKH9q35W0f0NCD
+j+iHt3014kMGiuyJe1UDQ6fvEihFFdHuDivFpPAXDt4PTY/WtpDhaGMx23kb54pK
+jkAuxpznAB1lK3u9bGRXDasGeHIrNtIlPvgkrWHXvoBVqM7zry8TGtoxp3E3I42Z
+cUfDWfB9GqVdrOwvrTzyZsl2uShRkAJaZFZj5aMyYxiptp4gM8CwWiNtOd2EwtRO
+LxZX4M02PQFIqXV3FSDA0q6EwglUrTZdAlYeOEkopaKCtG31dEPOSQG3NGJAEYso
+Cxm99H7970dp0OAgpNSgRbcWDbhVbQXnRzvFGqLeH6a9dQ/a8uD3s8Qm9Du/kB6d
+XxTRe2OGxzcD0AgI8GClE4rIZHCLbcwuJRp0EYcN+pgY80O4U98fZ5RYpU6OYbU/
+MEiaBYFKtZtGkV6AQD568V7hHJWqc5DDfVHUQ/aeQwnKi2vnU66u+nnV2rZxXxLP
++dqeLRpul+wKa5b/Z5SfQ14Ff8s7aVyxaogGpyggyPL1vyq4KWZ6Or/wEE5hgNO4
+kBh6ht0QT1Hti8XY2JK1M+Jgbjgcg4jkHBGVqegrG1Rvcc2A4TYKwx+QMSBhyxrU
+5qhROjS4lTcC42hQslMUkUwc4U/Y91XdFbOOnaAkwzI36NRYL0pmgZnYxGJZeRvr
+E5foOhnOEVSFGdOkLfFh+FkWZQf56Lmn8Gg2wHE3dZTxLHibiUYfkgOr1uEosq29
+D1NstvlJURPQ0Q+8QQNWcl9nEZHMAjOmnL1hbx+QfuC6seucp+sXGzdZByMLZbvT
+tG8KNL293CmyQowgf9MXToWYnwRkcvqfTaKyor2Ggze3JtoFW4t0j4DI1XPciZFX
+XmfApHrzdB/bZadzxyaZ2NE0CuH9zDelwI6rz38xsN5liYnp5qmNKVCZVOHccXa6
+J8x365m5/VaaA2RrtdPqKxn8VaKy7+T690QgMXVGM4PbzQzQxHuSleklocqlP+sB
+jSMXCZY+ng/i4UmRO9noiyW3UThYh0hIdMYs12EmmI9cnF/OuYZpl30fmqwV+VNM
+td5B2fYvAvvsjiX60SFCn3DATP1GrPMBlZSmhhP3GYS+xrWt3Xxta9qIX2BEF1Gg
+twnZZRjoULSRFUYPfJPEOfEH2UQwm84wxx/GezVE+S/RpBlatPOgCiLnNNaLfdTC
+mTG9qY9elJv3GGQO8Lqgf4i8blExs05lSPk1BDhzTB6H9TLz+Ge0/l1QxKf3gPXU
+aImK1azieXMXHECkdKxrzmehwu1dZ/oYOLc/OFQCETwSRoLPFOFpYUpizwmVVHR6
+uLSfRptte4ZOU3zHfpd/0+J4tkwHwEkGzsmMdqudlm7qME6upuIplyVBH8JiXzUK
+n1RIH/OPmVEluAnexWRLZNdk7MrakIO4XACVbICENiYQgAIErP568An6twWEGDbZ
+bEN64E3cVDTDRPRAunIhhsEaapcxpFEPWlHorxv36nMUt0R0h0bJlCu5QdzckfcX
+ZrRuu1kl76ZfbSE8T0G4/rBb9gsU4Gn3WyvLIO3MgFBuxR68ZwcR8LpEUd8qp38H
+NG4cxPmN1nGKo663Z+xI2Gt5up4gpl+fOt4mXqxY386rB7yHaOfElMG5TUYdrS9w
+1xbbCVgeJ6zxX+NFlndG33cSAPprhw+C18eUu6ZU63WZcYFo3GfK6rs3lvYtofvE
+8DxztdTidQedNVNE+63YCjhxd/cZUI5n/UpgYkr9owp7hNGJiR3tdoNLR2gcoGqL
+qWhH928k2aSgF2j97LZ2OqoPCp0tUB7ho4jD2u4Ik3GLVNlCc3dCvWRvpHtDTQDv
+tujESMfHUc9I2r4S/PD3bku/ABGwa977Yp1PjzJGr9RajA5is5n6GVpyynwjtKG4
+iyyITpdwpCgr8pueTBLwZnas3slmiMOog/E4PmPgctHzvC+vhQijhUtw5zSsmv0l
+bZlw/mVhp5Ta7dTcLBKR8DA3m3vTbaEGkz0xpfQr7GfiSMRbJyvIw88pDK0gyTMD
diff --git a/test_utils/scripts/circleci/get_tagged_package.py b/test_utils/scripts/circleci/get_tagged_package.py
new file mode 100644
index 000000000000..c148b9dc2370
--- /dev/null
+++ b/test_utils/scripts/circleci/get_tagged_package.py
@@ -0,0 +1,64 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helper to determine package from tag.
+Get the current package directory corresponding to the Circle Tag.
+"""
+
+from __future__ import print_function
+
+import os
+import re
+import sys
+
+
+TAG_RE = re.compile(r"""
+    ^
+    (?P<pkg>
+        (([a-z]+)[_-])*)  # pkg-name-with-hyphens-or-underscores (empty allowed)
+    ([0-9]+)\.([0-9]+)\.([0-9]+)  # Version x.y.z (x, y, z all ints)
+    $
+""", re.VERBOSE)
+TAG_ENV = 'CIRCLE_TAG'
+ERROR_MSG = '%s env. var. not set' % (TAG_ENV,)
+BAD_TAG_MSG = 'Invalid tag name: %s. Expected pkg-name-x.y.z'
+CIRCLE_CI_SCRIPTS_DIR = os.path.dirname(__file__)
+ROOT_DIR = os.path.realpath(
+    os.path.join(CIRCLE_CI_SCRIPTS_DIR, '..', '..', '..'))
+
+
+def main():
+    """Get the current package directory.
+    Prints the package directory out so callers can consume it.
+    """
+    if TAG_ENV not in os.environ:
+        print(ERROR_MSG, file=sys.stderr)
+        sys.exit(1)
+
+    tag_name = os.environ[TAG_ENV]
+    match = TAG_RE.match(tag_name)
+    if match is None:
+        print(BAD_TAG_MSG % (tag_name,), file=sys.stderr)
+        sys.exit(1)
+
+    pkg_name = match.group('pkg')
+    if pkg_name is None:
+        print(ROOT_DIR)
+    else:
+        pkg_dir = pkg_name.rstrip('-').replace('-', '_')
+        print(os.path.join(ROOT_DIR, pkg_dir))
+
+
+if __name__ == '__main__':
+    main()
diff --git a/test_utils/scripts/circleci/twine_upload.sh b/test_utils/scripts/circleci/twine_upload.sh
new file mode 100755
index 000000000000..23a4738e90b9
--- /dev/null
+++ b/test_utils/scripts/circleci/twine_upload.sh
@@ -0,0 +1,36 @@
+#!/bin/bash
+
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -ev
+
+# If this is not a CircleCI tag, no-op.
+if [[ -z "$CIRCLE_TAG" ]]; then
+  echo "This is not a release tag. Doing nothing."
+  exit 0
+fi
+
+# H/T: http://stackoverflow.com/a/246128/1068170
+SCRIPT="$(dirname "${BASH_SOURCE[0]}")/get_tagged_package.py"
+# Determine the package directory being deploying on this tag.
+PKG_DIR="$(python ${SCRIPT})"
+
+# Ensure that we have the latest versions of Twine, Wheel, and Setuptools.
+python3 -m pip install --upgrade twine wheel setuptools
+
+# Move into the package, build the distribution and upload.
+cd ${PKG_DIR}
+python3 setup.py sdist bdist_wheel
+twine upload dist/*
diff --git a/test_utils/scripts/get_target_packages.py b/test_utils/scripts/get_target_packages.py
new file mode 100644
index 000000000000..1d51830cc23a
--- /dev/null
+++ b/test_utils/scripts/get_target_packages.py
@@ -0,0 +1,268 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Print a list of packages which require testing."""
+
+import os
+import re
+import subprocess
+import warnings
+
+
+CURRENT_DIR = os.path.realpath(os.path.dirname(__file__))
+BASE_DIR = os.path.realpath(os.path.join(CURRENT_DIR, '..', '..'))
+GITHUB_REPO = os.environ.get('GITHUB_REPO', 'google-cloud-python')
+CI = os.environ.get('CI', '')
+CI_BRANCH = os.environ.get('CIRCLE_BRANCH')
+CI_PR = os.environ.get('CIRCLE_PR_NUMBER')
+CIRCLE_TAG = os.environ.get('CIRCLE_TAG')
+head_hash, head_name = subprocess.check_output(['git', 'show-ref', 'HEAD']
+).strip().decode('ascii').split()
+rev_parse = subprocess.check_output(
+    ['git', 'rev-parse', '--abbrev-ref', 'HEAD']
+).strip().decode('ascii')
+MAJOR_DIV = '#' * 78
+MINOR_DIV = '#' + '-' * 77
+
+# NOTE: This reg-ex is copied from ``get_tagged_packages``.
+TAG_RE = re.compile(r"""
+    ^
+    (?P<pkg>
+        (([a-z]+)-)*)            # pkg-name-with-hyphens- (empty allowed)
+    ([0-9]+)\.([0-9]+)\.([0-9]+)  # Version x.y.z (x, y, z all ints)
+    $
+""", re.VERBOSE)
+
+# This is the current set of dependencies by package.
+# As of this writing, the only "real" dependency is that of error_reporting
+# (on logging), the rest are just system test dependencies.
+PKG_DEPENDENCIES = {
+    'logging': {'pubsub'},
+}
+
+
+def get_baseline():
+    """Return the baseline commit.
+
+    On a pull request, or on a branch, return the common parent revision
+    with the master branch.
+
+    Locally, return a value pulled from environment variables, or None if
+    the environment variables are not set.
+
+    On a push to master, return None. This will effectively cause everything
+    to be considered to be affected.
+    """
+
+    # If this is a pull request or branch, return the tip for master.
+    # We will test only packages which have changed since that point.
+    ci_non_master = (CI == 'true') and any([CI_BRANCH != 'master', CI_PR])
+
+    if ci_non_master:
+
+        repo_url = 'git@github.com:GoogleCloudPlatform/{}'.format(GITHUB_REPO)
+        subprocess.run(['git', 'remote', 'add', 'baseline', repo_url],
+                        stderr=subprocess.DEVNULL)
+        subprocess.run(['git', 'pull', 'baseline'], stderr=subprocess.DEVNULL)
+
+        if CI_PR is None and CI_BRANCH is not None:
+            output = subprocess.check_output([
+                'git', 'merge-base', '--fork-point',
+                'baseline/master', CI_BRANCH])
+            return output.strip().decode('ascii')
+
+        return 'baseline/master'
+
+    # If environment variables are set identifying what the master tip is,
+    # use that.
+    if os.environ.get('GOOGLE_CLOUD_TESTING_REMOTE', ''):
+        remote = os.environ['GOOGLE_CLOUD_TESTING_REMOTE']
+        branch = os.environ.get('GOOGLE_CLOUD_TESTING_BRANCH', 'master')
+        return '%s/%s' % (remote, branch)
+
+    # If we are not in CI and we got this far, issue a warning.
+    if not CI:
+        warnings.warn('No baseline could be determined; this means tests '
+                      'will run for every package. If this is local '
+                      'development, set the $GOOGLE_CLOUD_TESTING_REMOTE '
+                      'environment variable.')
+
+    # That is all we can do; return None.
+    return None
+
+
+def get_changed_files():
+    """Return a list of files that have been changed since the baseline.
+
+    If there is no base, return None.
+    """
+    # Get the baseline, and fail quickly if there is no baseline.
+    baseline = get_baseline()
+    print('# Baseline commit: {}'.format(baseline))
+    if not baseline:
+        return None
+
+    # Return a list of altered files.
+    try:
+        return subprocess.check_output([
+            'git', 'diff', '--name-only', '{}..HEAD'.format(baseline),
+        ], stderr=subprocess.DEVNULL).decode('utf8').strip().split('\n')
+    except subprocess.CalledProcessError:
+        warnings.warn('Unable to perform git diff; falling back to assuming '
+                      'all packages have changed.')
+        return None
+
+
+def reverse_map(dict_of_sets):
+    """Reverse a map of one-to-many.
+
+    So the map::
+
+      {
+        'A': {'B', 'C'},
+        'B': {'C'},
+      }
+
+    becomes
+
+      {
+        'B': {'A'},
+        'C': {'A', 'B'},
+      }
+
+    Args:
+        dict_of_sets (dict[set]): A dictionary of sets, mapping
+            one value to many.
+
+    Returns:
+        dict[set]: The reversed map.
+    """
+    result = {}
+    for key, values in dict_of_sets.items():
+        for value in values:
+            result.setdefault(value, set()).add(key)
+
+    return result
+
+def get_changed_packages(file_list):
+    """Return a list of changed packages based on the provided file list.
+
+    If the file list is None, then all packages should be considered to be
+    altered.
+    """
+    # Determine a complete list of packages.
+    all_packages = set()
+    for file_ in os.listdir(BASE_DIR):
+        abs_file = os.path.realpath(os.path.join(BASE_DIR, file_))
+        nox_file = os.path.join(abs_file, 'nox.py')
+        if os.path.isdir(abs_file) and os.path.isfile(nox_file):
+            all_packages.add(file_)
+
+    # If ther is no file list, send down the full package set.
+    if file_list is None:
+        return all_packages
+
+    # Create a set based on the list of changed files.
+    answer = set()
+    reverse_deps = reverse_map(PKG_DEPENDENCIES)
+    for file_ in file_list:
+        # Ignore root directory changes (setup.py, .gitignore, etc.).
+        if os.path.sep not in file_:
+            continue
+
+        # Ignore changes that are not in a package (usually this will be docs).
+        package = file_.split(os.path.sep, 1)[0]
+        if package not in all_packages:
+            continue
+
+        # If there is a change in core, short-circuit now and return
+        # everything.
+        if package in ('core',):
+            return all_packages
+
+        # Add the package, as well as any dependencies this package has.
+        # NOTE: For now, dependencies only go down one level.
+        answer.add(package)
+        answer = answer.union(reverse_deps.get(package, set()))
+
+    # We got this far without being short-circuited; return the final answer.
+    return answer
+
+
+def get_tagged_package():
+    """Return the package corresponding to the current tag.
+
+    If there is not tag, will return :data:`None`.
+    """
+    if CIRCLE_TAG is None:
+        return
+
+    match = TAG_RE.match(CIRCLE_TAG)
+    if match is None:
+        return
+
+    pkg_name = match.group('pkg')
+    if pkg_name == '':
+        # NOTE: This corresponds to the "umbrella" tag.
+        return
+
+    return pkg_name.rstrip('-').replace('-', '_')
+
+
+def get_target_packages():
+    """Return a list of target packages to be run in the current build.
+
+    If in a tag build, will run only the package(s) that are tagged, otherwise
+    will run the packages that have file changes in them (or packages that
+    depend on those).
+    """
+    tagged_package = get_tagged_package()
+    if tagged_package is None:
+        file_list = get_changed_files()
+        print(MAJOR_DIV)
+        print('# Changed files:')
+        print(MINOR_DIV)
+        for file_ in file_list or ():
+            print('#  {}'.format(file_))
+        for package in sorted(get_changed_packages(file_list)):
+            yield package
+    else:
+        yield tagged_package
+
+
+def main():
+    print(MAJOR_DIV)
+    print('# Environment')
+    print(MINOR_DIV)
+    print('# CircleCI:        {}'.format(CI))
+    print('# CircleCI branch: {}'.format(CI_BRANCH))
+    print('# CircleCI pr:     {}'.format(CI_PR))
+    print('# CircleCI tag:    {}'.format(CIRCLE_TAG))
+    print('# HEAD ref:        {}'.format(head_hash))
+    print('#                  {}'.format(head_name))
+    print('# Git branch:      {}'.format(rev_parse))
+    print(MAJOR_DIV)
+
+    packages = list(get_target_packages())
+
+    print(MAJOR_DIV)
+    print('# Target packages:')
+    print(MINOR_DIV)
+    for package in packages:
+       print(package)
+    print(MAJOR_DIV)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/test_utils/scripts/get_target_packages_kokoro.py b/test_utils/scripts/get_target_packages_kokoro.py
new file mode 100644
index 000000000000..27d3a0c940ea
--- /dev/null
+++ b/test_utils/scripts/get_target_packages_kokoro.py
@@ -0,0 +1,98 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Print a list of packages which require testing."""
+
+import pathlib
+import subprocess
+
+import ci_diff_helper
+import requests
+
+
+def print_environment(environment):
+    print("-> CI environment:")
+    print('Branch', environment.branch)
+    print('PR', environment.pr)
+    print('In PR', environment.in_pr)
+    print('Repo URL', environment.repo_url)
+    if environment.in_pr:
+        print('PR Base', environment.base)
+
+
+def get_base(environment):
+    if environment.in_pr:
+        return environment.base
+    else:
+        # If we're not in a PR, just calculate the changes between this commit
+        # and its parent.
+        return 'HEAD~1'
+
+
+def get_changed_files_from_base(base):
+    return subprocess.check_output([
+        'git', 'diff', '--name-only', f'{base}..HEAD',
+    ], stderr=subprocess.DEVNULL).decode('utf8').strip().split('\n')
+
+
+_URL_TEMPLATE = (
+    'https://api.github.com/repos/googleapis/google-cloud-python/pulls/'
+    '{}/files'
+)
+
+
+def get_changed_files_from_pr(pr):
+    url = _URL_TEMPLATE.format(pr)
+    while url is not None:
+        response = requests.get(url)
+        for info in response.json():
+            yield info['filename']
+        url = response.links.get('next', {}).get('url')
+
+
+def determine_changed_packages(changed_files):
+    packages = [
+        path.parent for path in pathlib.Path('.').glob('*/noxfile.py')
+    ]
+
+    changed_packages = set()
+    for file in changed_files:
+        file = pathlib.Path(file)
+        for package in packages:
+            if package in file.parents:
+                changed_packages.add(package)
+
+    return changed_packages
+
+
+def main():
+    environment = ci_diff_helper.get_config()
+    print_environment(environment)
+    base = get_base(environment)
+
+    if environment.in_pr:
+        changed_files = list(get_changed_files_from_pr(environment.pr))
+    else:
+        changed_files = get_changed_files_from_base(base)
+
+    packages = determine_changed_packages(changed_files)
+
+    print(f"Comparing against {base}.")
+    print("-> Changed packages:")
+
+    for package in packages:
+        print(package)
+
+
+main()
diff --git a/system_tests/run_emulator.py b/test_utils/scripts/run_emulator.py
similarity index 99%
rename from system_tests/run_emulator.py
rename to test_utils/scripts/run_emulator.py
index 41a79bfb6b67..287b08640691 100644
--- a/system_tests/run_emulator.py
+++ b/test_utils/scripts/run_emulator.py
@@ -1,4 +1,4 @@
-# Copyright 2016 Google Inc. All rights reserved.
+# Copyright 2016 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/test_utils/scripts/update_docs.sh b/test_utils/scripts/update_docs.sh
new file mode 100755
index 000000000000..8cbab9f0dad0
--- /dev/null
+++ b/test_utils/scripts/update_docs.sh
@@ -0,0 +1,93 @@
+#!/bin/bash
+
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -ev
+
+GH_OWNER='GoogleCloudPlatform'
+GH_PROJECT_NAME='google-cloud-python'
+
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Function to build the docs.
+function build_docs {
+    rm -rf docs/_build/
+    rm -f docs/bigquery/generated/*.rst
+    # -W -> warnings as errors
+    # -T -> show full traceback on exception
+    # -N -> no color
+    sphinx-build \
+        -W -T -N \
+        -b html \
+        -d docs/_build/doctrees \
+        docs/ \
+        docs/_build/html/
+    return $?
+}
+
+# Only update docs if we are on CircleCI.
+if [[ "${CIRCLE_BRANCH}" == "master" ]] && [[ -z "${CIRCLE_PR_NUMBER}" ]]; then
+    echo "Building new docs on a merged commit."
+elif [[ "$1" == "kokoro" ]]; then
+    echo "Building and publishing docs on Kokoro."
+elif [[ -n "${CIRCLE_TAG}" ]]; then
+    echo "Building new docs on a tag (but will not deploy)."
+    build_docs
+    exit $?
+else
+    echo "Not on master nor a release tag."
+    echo "Building new docs for testing purposes, but not deploying."
+    build_docs
+    exit $?
+fi
+
+# Adding GitHub pages branch. `git submodule add` checks it
+# out at HEAD.
+GH_PAGES_DIR='ghpages'
+git submodule add -q -b gh-pages \
+    "git@github.com:${GH_OWNER}/${GH_PROJECT_NAME}" ${GH_PAGES_DIR}
+
+# Determine if we are building a new tag or are building docs
+# for master. Then build new docs in docs/_build from master.
+if [[ -n "${CIRCLE_TAG}" ]]; then
+    # Sphinx will use the package version by default.
+    build_docs
+else
+    SPHINX_RELEASE=$(git log -1 --pretty=%h) build_docs
+fi
+
+# Update gh-pages with the created docs.
+cd ${GH_PAGES_DIR}
+git rm -fr latest/
+cp -R ../docs/_build/html/ latest/
+
+# Update the files push to gh-pages.
+git add .
+git status
+
+# If there are no changes, just exit cleanly.
+if [[ -z "$(git status --porcelain)" ]]; then
+    echo "Nothing to commit. Exiting without pushing changes."
+    exit
+fi
+
+# Commit to gh-pages branch to apply changes.
+git config --global user.email "dpebot@google.com"
+git config --global user.name "dpebot"
+git commit -m "Update docs after merge to master."
+
+# NOTE: This may fail if two docs updates (on merges to master)
+#       happen in close proximity.
+git push -q origin HEAD:gh-pages
diff --git a/test_utils/setup.py b/test_utils/setup.py
new file mode 100644
index 000000000000..8e9222a7f862
--- /dev/null
+++ b/test_utils/setup.py
@@ -0,0 +1,64 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from setuptools import find_packages
+from setuptools import setup
+
+
+PACKAGE_ROOT = os.path.abspath(os.path.dirname(__file__))
+
+
+# NOTE: This is duplicated throughout and we should try to
+#       consolidate.
+SETUP_BASE = {
+    'author': 'Google Cloud Platform',
+    'author_email': 'googleapis-publisher@google.com',
+    'scripts': [],
+    'url': 'https://github.com/GoogleCloudPlatform/google-cloud-python',
+    'license': 'Apache 2.0',
+    'platforms': 'Posix; MacOS X; Windows',
+    'include_package_data': True,
+    'zip_safe': False,
+    'classifiers': [
+        'Development Status :: 4 - Beta',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Topic :: Internet',
+    ],
+}
+
+
+REQUIREMENTS = [
+    'google-auth >= 0.4.0',
+    'six',
+]
+
+setup(
+    name='google-cloud-testutils',
+    version='0.24.0',
+    description='System test utilities for google-cloud-python',
+    packages=find_packages(),
+    install_requires=REQUIREMENTS,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    **SETUP_BASE
+)
diff --git a/test_utils/test_utils/__init__.py b/test_utils/test_utils/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/test_utils/test_utils/imports.py b/test_utils/test_utils/imports.py
new file mode 100644
index 000000000000..5991af7fc465
--- /dev/null
+++ b/test_utils/test_utils/imports.py
@@ -0,0 +1,38 @@
+# 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.
+
+import mock
+import six
+
+
+def maybe_fail_import(predicate):
+    """Create and return a patcher that conditionally makes an import fail.
+
+    Args:
+        predicate (Callable[[...], bool]): A callable that, if it returns `True`,
+            triggers an `ImportError`. It must accept the same arguments as the
+            built-in `__import__` function.
+            https://docs.python.org/3/library/functions.html#__import__
+
+    Returns:
+        A mock patcher object that can be used to enable patched import behavior.
+    """
+    orig_import = six.moves.builtins.__import__
+
+    def custom_import(name, globals=None, locals=None, fromlist=(), level=0):
+        if predicate(name, globals, locals, fromlist, level):
+            raise ImportError
+        return orig_import(name, globals, locals, fromlist, level)
+
+    return mock.patch.object(six.moves.builtins, "__import__", new=custom_import)
diff --git a/test_utils/test_utils/retry.py b/test_utils/test_utils/retry.py
new file mode 100644
index 000000000000..e61c001a03e1
--- /dev/null
+++ b/test_utils/test_utils/retry.py
@@ -0,0 +1,207 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+from functools import wraps
+
+import six
+
+MAX_TRIES = 4
+DELAY = 1
+BACKOFF = 2
+
+
+def _retry_all(_):
+    """Retry all caught exceptions."""
+    return True
+
+
+class BackoffFailed(Exception):
+    """Retry w/ backoffs did not complete successfully."""
+
+
+class RetryBase(object):
+    """Base for retrying calling a decorated function w/ exponential backoff.
+
+    :type max_tries: int
+    :param max_tries: Number of times to try (not retry) before giving up.
+
+    :type delay: int
+    :param delay: Initial delay between retries in seconds.
+
+    :type backoff: int
+    :param backoff: Backoff multiplier e.g. value of 2 will double the
+                    delay each retry.
+
+    :type logger: logging.Logger instance
+    :param logger: Logger to use. If None, print.
+    """
+    def __init__(self, max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
+                 logger=None):
+        self.max_tries = max_tries
+        self.delay = delay
+        self.backoff = backoff
+        self.logger = logger.warning if logger else six.print_
+
+
+class RetryErrors(RetryBase):
+    """Decorator for retrying given exceptions in testing.
+
+    :type exception: Exception or tuple of Exceptions
+    :param exception: The exception to check or may be a tuple of
+                      exceptions to check.
+
+    :type error_predicate: function, takes caught exception, returns bool
+    :param error_predicate: Predicate evaluating whether to retry after a
+                            caught exception.
+
+    :type max_tries: int
+    :param max_tries: Number of times to try (not retry) before giving up.
+
+    :type delay: int
+    :param delay: Initial delay between retries in seconds.
+
+    :type backoff: int
+    :param backoff: Backoff multiplier e.g. value of 2 will double the
+                    delay each retry.
+
+    :type logger: logging.Logger instance
+    :param logger: Logger to use. If None, print.
+    """
+    def __init__(self, exception, error_predicate=_retry_all,
+                 max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
+                 logger=None):
+        super(RetryErrors, self).__init__(max_tries, delay, backoff, logger)
+        self.exception = exception
+        self.error_predicate = error_predicate
+
+    def __call__(self, to_wrap):
+        @wraps(to_wrap)
+        def wrapped_function(*args, **kwargs):
+            tries = 0
+            while tries < self.max_tries:
+                try:
+                    return to_wrap(*args, **kwargs)
+                except self.exception as caught_exception:
+
+                    if not self.error_predicate(caught_exception):
+                        raise
+
+                    delay = self.delay * self.backoff**tries
+                    msg = ("%s, Trying again in %d seconds..." %
+                           (caught_exception, delay))
+                    self.logger(msg)
+
+                    time.sleep(delay)
+                    tries += 1
+            return to_wrap(*args, **kwargs)
+
+        return wrapped_function
+
+
+class RetryResult(RetryBase):
+    """Decorator for retrying based on non-error result.
+
+    :type result_predicate: function, takes result, returns bool
+    :param result_predicate: Predicate evaluating whether to retry after a
+                             result is returned.
+
+    :type max_tries: int
+    :param max_tries: Number of times to try (not retry) before giving up.
+
+    :type delay: int
+    :param delay: Initial delay between retries in seconds.
+
+    :type backoff: int
+    :param backoff: Backoff multiplier e.g. value of 2 will double the
+                    delay each retry.
+
+    :type logger: logging.Logger instance
+    :param logger: Logger to use. If None, print.
+    """
+    def __init__(self, result_predicate,
+                 max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
+                 logger=None):
+        super(RetryResult, self).__init__(max_tries, delay, backoff, logger)
+        self.result_predicate = result_predicate
+
+    def __call__(self, to_wrap):
+        @wraps(to_wrap)
+        def wrapped_function(*args, **kwargs):
+            tries = 0
+            while tries < self.max_tries:
+                result = to_wrap(*args, **kwargs)
+                if self.result_predicate(result):
+                    return result
+
+                delay = self.delay * self.backoff**tries
+                msg = "%s. Trying again in %d seconds..." % (
+                    self.result_predicate.__name__, delay,)
+                self.logger(msg)
+
+                time.sleep(delay)
+                tries += 1
+            raise BackoffFailed()
+
+        return wrapped_function
+
+
+class RetryInstanceState(RetryBase):
+    """Decorator for retrying based on instance state.
+
+    :type instance_predicate: function, takes instance, returns bool
+    :param instance_predicate: Predicate evaluating whether to retry after an
+                               API-invoking method is called.
+
+    :type max_tries: int
+    :param max_tries: Number of times to try (not retry) before giving up.
+
+    :type delay: int
+    :param delay: Initial delay between retries in seconds.
+
+    :type backoff: int
+    :param backoff: Backoff multiplier e.g. value of 2 will double the
+                    delay each retry.
+
+    :type logger: logging.Logger instance
+    :param logger: Logger to use. If None, print.
+    """
+    def __init__(self, instance_predicate,
+                 max_tries=MAX_TRIES, delay=DELAY, backoff=BACKOFF,
+                 logger=None):
+        super(RetryInstanceState, self).__init__(
+            max_tries, delay, backoff, logger)
+        self.instance_predicate = instance_predicate
+
+    def __call__(self, to_wrap):
+        instance = to_wrap.__self__   # only instance methods allowed
+
+        @wraps(to_wrap)
+        def wrapped_function(*args, **kwargs):
+            tries = 0
+            while tries < self.max_tries:
+                result = to_wrap(*args, **kwargs)
+                if self.instance_predicate(instance):
+                    return result
+
+                delay = self.delay * self.backoff**tries
+                msg = "%s. Trying again in %d seconds..." % (
+                    self.instance_predicate.__name__, delay,)
+                self.logger(msg)
+
+                time.sleep(delay)
+                tries += 1
+            raise BackoffFailed()
+
+        return wrapped_function
diff --git a/test_utils/test_utils/system.py b/test_utils/test_utils/system.py
new file mode 100644
index 000000000000..590dc62a06e6
--- /dev/null
+++ b/test_utils/test_utils/system.py
@@ -0,0 +1,81 @@
+# Copyright 2014 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import print_function
+import os
+import sys
+import time
+
+import google.auth.credentials
+from google.auth.environment_vars import CREDENTIALS as TEST_CREDENTIALS
+
+
+# From shell environ. May be None.
+CREDENTIALS = os.getenv(TEST_CREDENTIALS)
+
+ENVIRON_ERROR_MSG = """\
+To run the system tests, you need to set some environment variables.
+Please check the CONTRIBUTING guide for instructions.
+"""
+
+
+class EmulatorCreds(google.auth.credentials.Credentials):
+    """A mock credential object.
+
+    Used to avoid unnecessary token refreshing or reliance on the network
+    while an emulator is running.
+    """
+
+    def __init__(self):  # pylint: disable=super-init-not-called
+        self.token = b'seekrit'
+        self.expiry = None
+
+    @property
+    def valid(self):
+        """Would-be validity check of the credentials.
+
+        Always is :data:`True`.
+        """
+        return True
+
+    def refresh(self, unused_request):  # pylint: disable=unused-argument
+        """Off-limits implementation for abstract method."""
+        raise RuntimeError('Should never be refreshed.')
+
+
+def check_environ():
+    err_msg = None
+    if CREDENTIALS is None:
+        err_msg = '\nMissing variables: ' + TEST_CREDENTIALS
+    elif not os.path.isfile(CREDENTIALS):
+        err_msg = '\nThe %s path %r is not a file.' % (TEST_CREDENTIALS,
+                                                       CREDENTIALS)
+
+    if err_msg is not None:
+        msg = ENVIRON_ERROR_MSG + err_msg
+        print(msg, file=sys.stderr)
+        sys.exit(1)
+
+
+def unique_resource_id(delimiter='_'):
+    """A unique identifier for a resource.
+
+    Intended to help locate resources created in particular
+    testing environments and at particular times.
+    """
+    build_id = os.getenv('CIRCLE_BUILD_NUM', '')
+    if build_id == '':
+        return '%s%d' % (delimiter, 1000 * time.time())
+    else:
+        return '%s%s%s%d' % (delimiter, build_id, delimiter, time.time())
diff --git a/texttospeech/.coveragerc b/texttospeech/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/texttospeech/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/texttospeech/.flake8 b/texttospeech/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/texttospeech/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/texttospeech/.repo-metadata.json b/texttospeech/.repo-metadata.json
new file mode 100644
index 000000000000..59cb59726877
--- /dev/null
+++ b/texttospeech/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "texttospeech",
+  "name_pretty": "Google Cloud Text-to-Speech",
+  "product_documentation": "https://cloud.google.com/text-to-speech",
+  "client_documentation": "https://googleapis.dev/python/texttospeech/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5235428",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-texttospeech",
+  "api_id": "texttospeech.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/texttospeech/CHANGELOG.md b/texttospeech/CHANGELOG.md
new file mode 100644
index 000000000000..2611568ea374
--- /dev/null
+++ b/texttospeech/CHANGELOG.md
@@ -0,0 +1,109 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-texttospeech/#history
+
+## 0.5.0
+
+07-24-2019 17:48 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8407](https://github.com/googleapis/google-cloud-python/pull/8407))
+- Reformat protos, update nox session docs (via synth). ([#7941](https://github.com/googleapis/google-cloud-python/pull/7941))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add 'client_options' support (via synth). ([#8525](https://github.com/googleapis/google-cloud-python/pull/8525))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+- Repair top-level API reference page. ([#8435](https://github.com/googleapis/google-cloud-python/pull/8435))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8599](https://github.com/googleapis/google-cloud-python/pull/8599))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8367](https://github.com/googleapis/google-cloud-python/pull/8367))
+- Add disclaimer to auto-generated template files (via synth).  ([#8331](https://github.com/googleapis/google-cloud-python/pull/8331))
+- Blacken (via synth). ([#8281](https://github.com/googleapis/google-cloud-python/pull/8281))
+
+## 0.4.0
+
+02-07-2019 15:21 PST
+
+
+### Implementation Changes
+- Pick up stub docstring fix in GAPIC generator. ([#6984](https://github.com/googleapis/google-cloud-python/pull/6984))
+
+### New Features
+- Protoc updates to include effects_profile_id. ([#7097](https://github.com/googleapis/google-cloud-python/pull/7097))
+
+### Documentation
+- Fix `Client Library Documentation` link ([#7109](https://github.com/googleapis/google-cloud-python/pull/7109))
+
+### Internal / Testing Changes
+- Copy proto files alongside protoc versions.
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers and docstring quoting
+
+## 0.3.0
+
+12-18-2018 09:54 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6510](https://github.com/googleapis/google-cloud-python/pull/6510))
+- Fix `client_info` bug, update docstrings. ([#6423](https://github.com/googleapis/google-cloud-python/pull/6423))
+- Re-generate library using texttospeech/synth.py ([#5981](https://github.com/googleapis/google-cloud-python/pull/5981))
+- Add gRPC Transport layer. ([#5959](https://github.com/googleapis/google-cloud-python/pull/5959))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Docs: Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+- Fix docs links for TTS. ([#5483](https://github.com/googleapis/google-cloud-python/pull/5483))
+
+### Internal / Testing Changes
+- Add synth.metadata. ([#6870](https://github.com/googleapis/google-cloud-python/pull/6870))
+- Update noxfile.
+- blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.2.0
+
+### New Features
+
+- Add the text-to-speech v1 API surface. (#5468)
+- Re-generate the text-to-speech v1beta1 API surface. (#5468)
+
+### Documentation
+
+- Rename releases to changelog and include from CHANGELOG.md (#5191)
+
+### Internal / Testing Changes
+
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+
+## 0.1.0
+
+### Interface additions
+
+- Added text-to-speech v1beta1. (#5049)
+
diff --git a/texttospeech/LICENSE b/texttospeech/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/texttospeech/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/texttospeech/MANIFEST.in b/texttospeech/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/texttospeech/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/texttospeech/README.rst b/texttospeech/README.rst
new file mode 100644
index 000000000000..7887b150fef2
--- /dev/null
+++ b/texttospeech/README.rst
@@ -0,0 +1,90 @@
+Python Client for Cloud Text-to-Speech API
+==========================================
+
+|alpha| |pypi| |versions| 
+
+`Cloud Text-to-Speech API`_: Synthesizes natural-sounding speech by applying
+powerful neural network models.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-texttospeech.svg
+   :target: https://pypi.org/project/google-cloud-texttospeech/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-texttospeech.svg
+   :target: https://pypi.org/project/google-cloud-texttospeech/
+.. _Cloud Text-to-Speech API: https://cloud.google.com/texttospeech
+.. _Client Library Documentation: https://googleapis.dev/python/texttospeech/latest
+.. _Product Documentation: https://cloud.google.com/texttospeech
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Cloud Text-to-Speech API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Cloud Text-to-Speech API.:  https://cloud.google.com/texttospeech
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-texttospeech
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-texttospeech
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Cloud Text-to-Speech API
+   API to see other available methods on the client.
+-  Read the `Cloud Text-to-Speech API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+   APIs that we cover.
+
+.. _Cloud Text-to-Speech API Product documentation:  https://cloud.google.com/texttospeech
diff --git a/texttospeech/docs/README.rst b/texttospeech/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/texttospeech/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/texttospeech/docs/api.rst b/texttospeech/docs/api.rst
new file mode 100644
index 000000000000..8dd5fb3fdda2
--- /dev/null
+++ b/texttospeech/docs/api.rst
@@ -0,0 +1,30 @@
+Text-to-Speech Client API Reference
+===================================
+
+This package includes clients for multiple versions of the Text-to-Speech
+API. By default, you will get ``v1``, the latest GA version.
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1/api
+  gapic/v1/types
+
+If you are interested in beta features ahead of the latest GA, you may
+opt-in to the v1.1 beta, which is spelled ``v1beta1``. In order to do this,
+you will want to import from ``google.cloud.texttospeech_v1beta1`` in lieu of
+``google.cloud.texttospeech``.
+
+An API and type reference is provided for the v1.1 beta also:
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1beta1/api
+  gapic/v1beta1/types
+
+.. note::
+
+  The client for the beta API is provided on a provisional basis. The API
+  surface is subject to change, and it is possible that this client will be
+  deprecated or removed after its features become GA.
diff --git a/texttospeech/docs/changelog.md b/texttospeech/docs/changelog.md
new file mode 120000
index 000000000000..d7f15f4c5706
--- /dev/null
+++ b/texttospeech/docs/changelog.md
@@ -0,0 +1 @@
+../../texttospeech/CHANGELOG.md
\ No newline at end of file
diff --git a/texttospeech/docs/conf.py b/texttospeech/docs/conf.py
new file mode 100644
index 000000000000..337c7da9b6fd
--- /dev/null
+++ b/texttospeech/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-texttospeech documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-texttospeech"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-texttospeech-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-texttospeech.tex",
+        u"google-cloud-texttospeech Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-texttospeech",
+        u"google-cloud-texttospeech Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-texttospeech",
+        u"google-cloud-texttospeech Documentation",
+        author,
+        "google-cloud-texttospeech",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/texttospeech/docs/gapic/v1/api.rst b/texttospeech/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..06d283f8de68
--- /dev/null
+++ b/texttospeech/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Text-to-Speech API
+===================================
+
+.. automodule:: google.cloud.texttospeech_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/texttospeech/docs/gapic/v1/types.rst b/texttospeech/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..4d23029781f1
--- /dev/null
+++ b/texttospeech/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Text-to-Speech API Client
+=========================================
+
+.. automodule:: google.cloud.texttospeech_v1.types
+    :members:
\ No newline at end of file
diff --git a/texttospeech/docs/gapic/v1beta1/api.rst b/texttospeech/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..f43d33839f8b
--- /dev/null
+++ b/texttospeech/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Text-to-Speech API
+===================================
+
+.. automodule:: google.cloud.texttospeech_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/texttospeech/docs/gapic/v1beta1/types.rst b/texttospeech/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..2cd731576213
--- /dev/null
+++ b/texttospeech/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Text-to-Speech API Client
+=========================================
+
+.. automodule:: google.cloud.texttospeech_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/texttospeech/docs/index.rst b/texttospeech/docs/index.rst
new file mode 100644
index 000000000000..54bbdd520430
--- /dev/null
+++ b/texttospeech/docs/index.rst
@@ -0,0 +1,22 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    api
+    gapic/v1/api
+    gapic/v1/types
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+
+Changelog
+---------
+
+For a list of all ``google-cloud-texttospeech`` releases.
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/texttospeech/google/__init__.py b/texttospeech/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/texttospeech/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/texttospeech/google/cloud/__init__.py b/texttospeech/google/cloud/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/texttospeech/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/texttospeech/google/cloud/texttospeech.py b/texttospeech/google/cloud/texttospeech.py
new file mode 100644
index 000000000000..8bcebe389896
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.texttospeech_v1 import TextToSpeechClient
+from google.cloud.texttospeech_v1 import enums
+from google.cloud.texttospeech_v1 import types
+
+
+__all__ = ("enums", "types", "TextToSpeechClient")
diff --git a/texttospeech/google/cloud/texttospeech_v1/__init__.py b/texttospeech/google/cloud/texttospeech_v1/__init__.py
new file mode 100644
index 000000000000..c82cac19cc16
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.texttospeech_v1 import types
+from google.cloud.texttospeech_v1.gapic import enums
+from google.cloud.texttospeech_v1.gapic import text_to_speech_client
+
+
+class TextToSpeechClient(text_to_speech_client.TextToSpeechClient):
+    __doc__ = text_to_speech_client.TextToSpeechClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "TextToSpeechClient")
diff --git a/texttospeech/google/cloud/texttospeech_v1/gapic/__init__.py b/texttospeech/google/cloud/texttospeech_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/texttospeech/google/cloud/texttospeech_v1/gapic/enums.py b/texttospeech/google/cloud/texttospeech_v1/gapic/enums.py
new file mode 100644
index 000000000000..97736e3a0080
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/gapic/enums.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class AudioEncoding(enum.IntEnum):
+    """
+    Configuration to set up audio encoder. The encoding determines the output
+    audio format that we'd like.
+
+    Attributes:
+      AUDIO_ENCODING_UNSPECIFIED (int): Not specified. Will return result ``google.rpc.Code.INVALID_ARGUMENT``.
+      LINEAR16 (int): Uncompressed 16-bit signed little-endian samples (Linear PCM).
+      Audio content returned as LINEAR16 also contains a WAV header.
+      MP3 (int): MP3 audio.
+      OGG_OPUS (int): 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.
+    """
+
+    AUDIO_ENCODING_UNSPECIFIED = 0
+    LINEAR16 = 1
+    MP3 = 2
+    OGG_OPUS = 3
+
+
+class SsmlVoiceGender(enum.IntEnum):
+    """
+    Gender of the voice as described in `SSML voice
+    element <https://www.w3.org/TR/speech-synthesis11/#edef_voice>`__.
+
+    Attributes:
+      SSML_VOICE_GENDER_UNSPECIFIED (int): 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.
+      MALE (int): A male voice.
+      FEMALE (int): A female voice.
+      NEUTRAL (int): A gender-neutral voice.
+    """
+
+    SSML_VOICE_GENDER_UNSPECIFIED = 0
+    MALE = 1
+    FEMALE = 2
+    NEUTRAL = 3
diff --git a/texttospeech/google/cloud/texttospeech_v1/gapic/text_to_speech_client.py b/texttospeech/google/cloud/texttospeech_v1/gapic/text_to_speech_client.py
new file mode 100644
index 000000000000..658ac0ec72d1
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/gapic/text_to_speech_client.py
@@ -0,0 +1,323 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.texttospeech.v1 TextToSpeech API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.texttospeech_v1.gapic import enums
+from google.cloud.texttospeech_v1.gapic import text_to_speech_client_config
+from google.cloud.texttospeech_v1.gapic.transports import text_to_speech_grpc_transport
+from google.cloud.texttospeech_v1.proto import cloud_tts_pb2
+from google.cloud.texttospeech_v1.proto import cloud_tts_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-texttospeech"
+).version
+
+
+class TextToSpeechClient(object):
+    """Service that implements Google Cloud Text-to-Speech API."""
+
+    SERVICE_ADDRESS = "texttospeech.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.texttospeech.v1.TextToSpeech"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            TextToSpeechClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.TextToSpeechGrpcTransport,
+                    Callable[[~.Credentials, type], ~.TextToSpeechGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = text_to_speech_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=text_to_speech_grpc_transport.TextToSpeechGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = text_to_speech_grpc_transport.TextToSpeechGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_voices(
+        self,
+        language_code=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of Voice supported for synthesis.
+
+        Example:
+            >>> from google.cloud import texttospeech_v1
+            >>>
+            >>> client = texttospeech_v1.TextToSpeechClient()
+            >>>
+            >>> response = client.list_voices()
+
+        Args:
+            language_code (str): Optional (but 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 supported "en-*" voices; when specifying "no", you will get
+                supported "no-*" (Norwegian) and "nb-*" (Norwegian Bokmal) voices;
+                specifying "zh" will also get supported "cmn-*" voices; specifying
+                "zh-hk" will also get supported "yue-\*" voices.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.texttospeech_v1.types.ListVoicesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_voices" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_voices"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_voices,
+                default_retry=self._method_configs["ListVoices"].retry,
+                default_timeout=self._method_configs["ListVoices"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_tts_pb2.ListVoicesRequest(language_code=language_code)
+        return self._inner_api_calls["list_voices"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def synthesize_speech(
+        self,
+        input_,
+        voice,
+        audio_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Synthesizes speech synchronously: receive results after all text input
+        has been processed.
+
+        Example:
+            >>> from google.cloud import texttospeech_v1
+            >>>
+            >>> client = texttospeech_v1.TextToSpeechClient()
+            >>>
+            >>> # TODO: Initialize `input_`:
+            >>> input_ = {}
+            >>>
+            >>> # TODO: Initialize `voice`:
+            >>> voice = {}
+            >>>
+            >>> # TODO: Initialize `audio_config`:
+            >>> audio_config = {}
+            >>>
+            >>> response = client.synthesize_speech(input_, voice, audio_config)
+
+        Args:
+            input_ (Union[dict, ~google.cloud.texttospeech_v1.types.SynthesisInput]): Required. The Synthesizer requires either plain text or SSML as input.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.texttospeech_v1.types.SynthesisInput`
+            voice (Union[dict, ~google.cloud.texttospeech_v1.types.VoiceSelectionParams]): Required. The desired voice of the synthesized audio.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.texttospeech_v1.types.VoiceSelectionParams`
+            audio_config (Union[dict, ~google.cloud.texttospeech_v1.types.AudioConfig]): Required. The configuration of the synthesized audio.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.texttospeech_v1.types.AudioConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.texttospeech_v1.types.SynthesizeSpeechResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "synthesize_speech" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "synthesize_speech"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.synthesize_speech,
+                default_retry=self._method_configs["SynthesizeSpeech"].retry,
+                default_timeout=self._method_configs["SynthesizeSpeech"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_tts_pb2.SynthesizeSpeechRequest(
+            input=input_, voice=voice, audio_config=audio_config
+        )
+        return self._inner_api_calls["synthesize_speech"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/texttospeech/google/cloud/texttospeech_v1/gapic/text_to_speech_client_config.py b/texttospeech/google/cloud/texttospeech_v1/gapic/text_to_speech_client_config.py
new file mode 100644
index 000000000000..91bb80823f63
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/gapic/text_to_speech_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.texttospeech.v1.TextToSpeech": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListVoices": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SynthesizeSpeech": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/texttospeech/google/cloud/texttospeech_v1/gapic/transports/__init__.py b/texttospeech/google/cloud/texttospeech_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/texttospeech/google/cloud/texttospeech_v1/gapic/transports/text_to_speech_grpc_transport.py b/texttospeech/google/cloud/texttospeech_v1/gapic/transports/text_to_speech_grpc_transport.py
new file mode 100644
index 000000000000..6b6558e315f1
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/gapic/transports/text_to_speech_grpc_transport.py
@@ -0,0 +1,135 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.texttospeech_v1.proto import cloud_tts_pb2_grpc
+
+
+class TextToSpeechGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.texttospeech.v1 TextToSpeech API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="texttospeech.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "text_to_speech_stub": cloud_tts_pb2_grpc.TextToSpeechStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="texttospeech.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_voices(self):
+        """Return the gRPC stub for :meth:`TextToSpeechClient.list_voices`.
+
+        Returns a list of Voice supported for synthesis.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["text_to_speech_stub"].ListVoices
+
+    @property
+    def synthesize_speech(self):
+        """Return the gRPC stub for :meth:`TextToSpeechClient.synthesize_speech`.
+
+        Synthesizes speech synchronously: receive results after all text input
+        has been processed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["text_to_speech_stub"].SynthesizeSpeech
diff --git a/texttospeech/google/cloud/texttospeech_v1/proto/__init__.py b/texttospeech/google/cloud/texttospeech_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts.proto b/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts.proto
new file mode 100644
index 000000000000..dd9fa6ce221a
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts.proto
@@ -0,0 +1,235 @@
+// 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.cloud.texttospeech.v1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.TextToSpeech.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/texttospeech/v1;texttospeech";
+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";
+
+// Service that implements Google Cloud Text-to-Speech API.
+service TextToSpeech {
+  // Returns a list of Voice supported for synthesis.
+  rpc ListVoices(ListVoicesRequest) returns (ListVoicesResponse) {
+    option (google.api.http) = {
+      get: "/v1/voices"
+    };
+  }
+
+  // Synthesizes speech synchronously: receive results after all text input
+  // has been processed.
+  rpc SynthesizeSpeech(SynthesizeSpeechRequest)
+      returns (SynthesizeSpeechResponse) {
+    option (google.api.http) = {
+      post: "/v1/text:synthesize"
+      body: "*"
+    };
+  }
+}
+
+// The top-level message sent by the client for the `ListVoices` method.
+message ListVoicesRequest {
+  // Optional (but 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
+  // supported "en-*" voices; when specifying "no", you will get supported
+  // "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;
+}
+
+// The message returned to the client by the `ListVoices` method.
+message ListVoicesResponse {
+  // The list of voices.
+  repeated Voice voices = 1;
+}
+
+// Description of a voice supported by the TTS service.
+message Voice {
+  // The languages that this voice supports, expressed as
+  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags (e.g.
+  // "en-US", "es-419", "cmn-tw").
+  repeated string language_codes = 1;
+
+  // The name of this voice.  Each distinct voice has a unique name.
+  string name = 2;
+
+  // The gender of this voice.
+  SsmlVoiceGender ssml_gender = 3;
+
+  // The natural sample rate (in hertz) for this voice.
+  int32 natural_sample_rate_hertz = 4;
+}
+
+// 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;
+
+  // Required. The desired voice of the synthesized audio.
+  VoiceSelectionParams voice = 2;
+
+  // Required. The configuration of the synthesized audio.
+  AudioConfig audio_config = 3;
+}
+
+// Contains text input to be synthesized. Either `text` or `ssml` must be
+// supplied. Supplying both or neither returns
+// [google.rpc.Code.INVALID_ARGUMENT][]. The input size is limited to 5000
+// characters.
+message SynthesisInput {
+  // The input source, which is either plain text or SSML.
+  oneof input_source {
+    // The raw text to be synthesized.
+    string text = 1;
+
+    // The SSML document to be synthesized. The SSML document must be valid
+    // and well-formed. Otherwise the RPC will fail and return
+    // [google.rpc.Code.INVALID_ARGUMENT][]. For more information, see
+    // [SSML](/speech/text-to-speech/docs/ssml).
+    string ssml = 2;
+  }
+}
+
+// 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
+  // [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
+  // "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
+  // the TTS service may choose a voice with a slightly different language code
+  // than the one selected; it may substitute a different region
+  // (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;
+
+  // The name of the voice. Optional; 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
+  // 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 = 3;
+}
+
+// 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;
+}
+
+// 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
+  // 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/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts_pb2.py b/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts_pb2.py
new file mode 100644
index 000000000000..1c8e163d5dc0
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts_pb2.py
@@ -0,0 +1,968 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/texttospeech_v1/proto/cloud_tts.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/texttospeech_v1/proto/cloud_tts.proto",
+    package="google.cloud.texttospeech.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n com.google.cloud.texttospeech.v1B\021TextToSpeechProtoP\001ZHgoogle.golang.org/genproto/googleapis/cloud/texttospeech/v1;texttospeech\370\001\001\252\002\034Google.Cloud.TextToSpeech.V1\312\002\034Google\\Cloud\\TextToSpeech\\V1"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/texttospeech_v1/proto/cloud_tts.proto\x12\x1cgoogle.cloud.texttospeech.v1\x1a\x1cgoogle/api/annotations.proto"*\n\x11ListVoicesRequest\x12\x15\n\rlanguage_code\x18\x01 \x01(\t"I\n\x12ListVoicesResponse\x12\x33\n\x06voices\x18\x01 \x03(\x0b\x32#.google.cloud.texttospeech.v1.Voice"\x94\x01\n\x05Voice\x12\x16\n\x0elanguage_codes\x18\x01 \x03(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x42\n\x0bssml_gender\x18\x03 \x01(\x0e\x32-.google.cloud.texttospeech.v1.SsmlVoiceGender\x12!\n\x19natural_sample_rate_hertz\x18\x04 \x01(\x05"\xda\x01\n\x17SynthesizeSpeechRequest\x12;\n\x05input\x18\x01 \x01(\x0b\x32,.google.cloud.texttospeech.v1.SynthesisInput\x12\x41\n\x05voice\x18\x02 \x01(\x0b\x32\x32.google.cloud.texttospeech.v1.VoiceSelectionParams\x12?\n\x0c\x61udio_config\x18\x03 \x01(\x0b\x32).google.cloud.texttospeech.v1.AudioConfig"@\n\x0eSynthesisInput\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\x0e\n\x04ssml\x18\x02 \x01(\tH\x00\x42\x0e\n\x0cinput_source"\x7f\n\x14VoiceSelectionParams\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x42\n\x0bssml_gender\x18\x03 \x01(\x0e\x32-.google.cloud.texttospeech.v1.SsmlVoiceGender"\xc7\x01\n\x0b\x41udioConfig\x12\x43\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32+.google.cloud.texttospeech.v1.AudioEncoding\x12\x15\n\rspeaking_rate\x18\x02 \x01(\x01\x12\r\n\x05pitch\x18\x03 \x01(\x01\x12\x16\n\x0evolume_gain_db\x18\x04 \x01(\x01\x12\x19\n\x11sample_rate_hertz\x18\x05 \x01(\x05\x12\x1a\n\x12\x65\x66\x66\x65\x63ts_profile_id\x18\x06 \x03(\t"1\n\x18SynthesizeSpeechResponse\x12\x15\n\raudio_content\x18\x01 \x01(\x0c*W\n\x0fSsmlVoiceGender\x12!\n\x1dSSML_VOICE_GENDER_UNSPECIFIED\x10\x00\x12\x08\n\x04MALE\x10\x01\x12\n\n\x06\x46\x45MALE\x10\x02\x12\x0b\n\x07NEUTRAL\x10\x03*T\n\rAudioEncoding\x12\x1e\n\x1a\x41UDIO_ENCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\x07\n\x03MP3\x10\x02\x12\x0c\n\x08OGG_OPUS\x10\x03\x32\xb8\x02\n\x0cTextToSpeech\x12\x83\x01\n\nListVoices\x12/.google.cloud.texttospeech.v1.ListVoicesRequest\x1a\x30.google.cloud.texttospeech.v1.ListVoicesResponse"\x12\x82\xd3\xe4\x93\x02\x0c\x12\n/v1/voices\x12\xa1\x01\n\x10SynthesizeSpeech\x12\x35.google.cloud.texttospeech.v1.SynthesizeSpeechRequest\x1a\x36.google.cloud.texttospeech.v1.SynthesizeSpeechResponse"\x1e\x82\xd3\xe4\x93\x02\x18"\x13/v1/text:synthesize:\x01*B\xc2\x01\n com.google.cloud.texttospeech.v1B\x11TextToSpeechProtoP\x01ZHgoogle.golang.org/genproto/googleapis/cloud/texttospeech/v1;texttospeech\xf8\x01\x01\xaa\x02\x1cGoogle.Cloud.TextToSpeech.V1\xca\x02\x1cGoogle\\Cloud\\TextToSpeech\\V1b\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_SSMLVOICEGENDER = _descriptor.EnumDescriptor(
+    name="SsmlVoiceGender",
+    full_name="google.cloud.texttospeech.v1.SsmlVoiceGender",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SSML_VOICE_GENDER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MALE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FEMALE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEUTRAL", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1053,
+    serialized_end=1140,
+)
+_sym_db.RegisterEnumDescriptor(_SSMLVOICEGENDER)
+
+SsmlVoiceGender = enum_type_wrapper.EnumTypeWrapper(_SSMLVOICEGENDER)
+_AUDIOENCODING = _descriptor.EnumDescriptor(
+    name="AudioEncoding",
+    full_name="google.cloud.texttospeech.v1.AudioEncoding",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="AUDIO_ENCODING_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINEAR16", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MP3", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OGG_OPUS", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1142,
+    serialized_end=1226,
+)
+_sym_db.RegisterEnumDescriptor(_AUDIOENCODING)
+
+AudioEncoding = enum_type_wrapper.EnumTypeWrapper(_AUDIOENCODING)
+SSML_VOICE_GENDER_UNSPECIFIED = 0
+MALE = 1
+FEMALE = 2
+NEUTRAL = 3
+AUDIO_ENCODING_UNSPECIFIED = 0
+LINEAR16 = 1
+MP3 = 2
+OGG_OPUS = 3
+
+
+_LISTVOICESREQUEST = _descriptor.Descriptor(
+    name="ListVoicesRequest",
+    full_name="google.cloud.texttospeech.v1.ListVoicesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.texttospeech.v1.ListVoicesRequest.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=114,
+    serialized_end=156,
+)
+
+
+_LISTVOICESRESPONSE = _descriptor.Descriptor(
+    name="ListVoicesResponse",
+    full_name="google.cloud.texttospeech.v1.ListVoicesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="voices",
+            full_name="google.cloud.texttospeech.v1.ListVoicesResponse.voices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=158,
+    serialized_end=231,
+)
+
+
+_VOICE = _descriptor.Descriptor(
+    name="Voice",
+    full_name="google.cloud.texttospeech.v1.Voice",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_codes",
+            full_name="google.cloud.texttospeech.v1.Voice.language_codes",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.texttospeech.v1.Voice.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssml_gender",
+            full_name="google.cloud.texttospeech.v1.Voice.ssml_gender",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="natural_sample_rate_hertz",
+            full_name="google.cloud.texttospeech.v1.Voice.natural_sample_rate_hertz",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=234,
+    serialized_end=382,
+)
+
+
+_SYNTHESIZESPEECHREQUEST = _descriptor.Descriptor(
+    name="SynthesizeSpeechRequest",
+    full_name="google.cloud.texttospeech.v1.SynthesizeSpeechRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input",
+            full_name="google.cloud.texttospeech.v1.SynthesizeSpeechRequest.input",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="voice",
+            full_name="google.cloud.texttospeech.v1.SynthesizeSpeechRequest.voice",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_config",
+            full_name="google.cloud.texttospeech.v1.SynthesizeSpeechRequest.audio_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=385,
+    serialized_end=603,
+)
+
+
+_SYNTHESISINPUT = _descriptor.Descriptor(
+    name="SynthesisInput",
+    full_name="google.cloud.texttospeech.v1.SynthesisInput",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.texttospeech.v1.SynthesisInput.text",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssml",
+            full_name="google.cloud.texttospeech.v1.SynthesisInput.ssml",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="input_source",
+            full_name="google.cloud.texttospeech.v1.SynthesisInput.input_source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=605,
+    serialized_end=669,
+)
+
+
+_VOICESELECTIONPARAMS = _descriptor.Descriptor(
+    name="VoiceSelectionParams",
+    full_name="google.cloud.texttospeech.v1.VoiceSelectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.texttospeech.v1.VoiceSelectionParams.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.texttospeech.v1.VoiceSelectionParams.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssml_gender",
+            full_name="google.cloud.texttospeech.v1.VoiceSelectionParams.ssml_gender",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=671,
+    serialized_end=798,
+)
+
+
+_AUDIOCONFIG = _descriptor.Descriptor(
+    name="AudioConfig",
+    full_name="google.cloud.texttospeech.v1.AudioConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="audio_encoding",
+            full_name="google.cloud.texttospeech.v1.AudioConfig.audio_encoding",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speaking_rate",
+            full_name="google.cloud.texttospeech.v1.AudioConfig.speaking_rate",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pitch",
+            full_name="google.cloud.texttospeech.v1.AudioConfig.pitch",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="volume_gain_db",
+            full_name="google.cloud.texttospeech.v1.AudioConfig.volume_gain_db",
+            index=3,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sample_rate_hertz",
+            full_name="google.cloud.texttospeech.v1.AudioConfig.sample_rate_hertz",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="effects_profile_id",
+            full_name="google.cloud.texttospeech.v1.AudioConfig.effects_profile_id",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=801,
+    serialized_end=1000,
+)
+
+
+_SYNTHESIZESPEECHRESPONSE = _descriptor.Descriptor(
+    name="SynthesizeSpeechResponse",
+    full_name="google.cloud.texttospeech.v1.SynthesizeSpeechResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="audio_content",
+            full_name="google.cloud.texttospeech.v1.SynthesizeSpeechResponse.audio_content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1002,
+    serialized_end=1051,
+)
+
+_LISTVOICESRESPONSE.fields_by_name["voices"].message_type = _VOICE
+_VOICE.fields_by_name["ssml_gender"].enum_type = _SSMLVOICEGENDER
+_SYNTHESIZESPEECHREQUEST.fields_by_name["input"].message_type = _SYNTHESISINPUT
+_SYNTHESIZESPEECHREQUEST.fields_by_name["voice"].message_type = _VOICESELECTIONPARAMS
+_SYNTHESIZESPEECHREQUEST.fields_by_name["audio_config"].message_type = _AUDIOCONFIG
+_SYNTHESISINPUT.oneofs_by_name["input_source"].fields.append(
+    _SYNTHESISINPUT.fields_by_name["text"]
+)
+_SYNTHESISINPUT.fields_by_name[
+    "text"
+].containing_oneof = _SYNTHESISINPUT.oneofs_by_name["input_source"]
+_SYNTHESISINPUT.oneofs_by_name["input_source"].fields.append(
+    _SYNTHESISINPUT.fields_by_name["ssml"]
+)
+_SYNTHESISINPUT.fields_by_name[
+    "ssml"
+].containing_oneof = _SYNTHESISINPUT.oneofs_by_name["input_source"]
+_VOICESELECTIONPARAMS.fields_by_name["ssml_gender"].enum_type = _SSMLVOICEGENDER
+_AUDIOCONFIG.fields_by_name["audio_encoding"].enum_type = _AUDIOENCODING
+DESCRIPTOR.message_types_by_name["ListVoicesRequest"] = _LISTVOICESREQUEST
+DESCRIPTOR.message_types_by_name["ListVoicesResponse"] = _LISTVOICESRESPONSE
+DESCRIPTOR.message_types_by_name["Voice"] = _VOICE
+DESCRIPTOR.message_types_by_name["SynthesizeSpeechRequest"] = _SYNTHESIZESPEECHREQUEST
+DESCRIPTOR.message_types_by_name["SynthesisInput"] = _SYNTHESISINPUT
+DESCRIPTOR.message_types_by_name["VoiceSelectionParams"] = _VOICESELECTIONPARAMS
+DESCRIPTOR.message_types_by_name["AudioConfig"] = _AUDIOCONFIG
+DESCRIPTOR.message_types_by_name["SynthesizeSpeechResponse"] = _SYNTHESIZESPEECHRESPONSE
+DESCRIPTOR.enum_types_by_name["SsmlVoiceGender"] = _SSMLVOICEGENDER
+DESCRIPTOR.enum_types_by_name["AudioEncoding"] = _AUDIOENCODING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListVoicesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListVoicesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTVOICESREQUEST,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""The top-level message sent by the client for the ``ListVoices`` method.
+  
+  
+  Attributes:
+      language_code:
+          Optional (but 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 supported "en-*" voices; when specifying
+          "no", you will get supported "no-*" (Norwegian) and "nb-*"
+          (Norwegian Bokmal) voices; specifying "zh" will also get
+          supported "cmn-*" voices; specifying "zh-hk" will also get
+          supported "yue-\*" voices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.ListVoicesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListVoicesRequest)
+
+ListVoicesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListVoicesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTVOICESRESPONSE,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""The message returned to the client by the ``ListVoices`` method.
+  
+  
+  Attributes:
+      voices:
+          The list of voices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.ListVoicesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListVoicesResponse)
+
+Voice = _reflection.GeneratedProtocolMessageType(
+    "Voice",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VOICE,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""Description of a voice supported by the TTS service.
+  
+  
+  Attributes:
+      language_codes:
+          The languages that this voice supports, expressed as `BCP-47
+          <https://www.rfc-editor.org/rfc/bcp/bcp47.txt>`__ language
+          tags (e.g. "en-US", "es-419", "cmn-tw").
+      name:
+          The name of this voice. Each distinct voice has a unique name.
+      ssml_gender:
+          The gender of this voice.
+      natural_sample_rate_hertz:
+          The natural sample rate (in hertz) for this voice.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.Voice)
+    ),
+)
+_sym_db.RegisterMessage(Voice)
+
+SynthesizeSpeechRequest = _reflection.GeneratedProtocolMessageType(
+    "SynthesizeSpeechRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNTHESIZESPEECHREQUEST,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""The top-level message sent by the client for the ``SynthesizeSpeech``
+  method.
+  
+  
+  Attributes:
+      input:
+          Required. The Synthesizer requires either plain text or SSML
+          as input.
+      voice:
+          Required. The desired voice of the synthesized audio.
+      audio_config:
+          Required. The configuration of the synthesized audio.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.SynthesizeSpeechRequest)
+    ),
+)
+_sym_db.RegisterMessage(SynthesizeSpeechRequest)
+
+SynthesisInput = _reflection.GeneratedProtocolMessageType(
+    "SynthesisInput",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNTHESISINPUT,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""Contains text input to be synthesized. Either ``text`` or ``ssml`` must
+  be supplied. Supplying both or neither returns
+  [google.rpc.Code.INVALID\_ARGUMENT][]. The input size is limited to 5000
+  characters.
+  
+  
+  Attributes:
+      input_source:
+          The input source, which is either plain text or SSML.
+      text:
+          The raw text to be synthesized.
+      ssml:
+          The SSML document to be synthesized. The SSML document must be
+          valid and well-formed. Otherwise the RPC will fail and return
+          [google.rpc.Code.INVALID\_ARGUMENT][]. For more information,
+          see `SSML </speech/text-to-speech/docs/ssml>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.SynthesisInput)
+    ),
+)
+_sym_db.RegisterMessage(SynthesisInput)
+
+VoiceSelectionParams = _reflection.GeneratedProtocolMessageType(
+    "VoiceSelectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VOICESELECTIONPARAMS,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""Description of which voice to use for a synthesis request.
+  
+  
+  Attributes:
+      language_code:
+          The language (and optionally 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 "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 the TTS service may choose a
+          voice with a slightly different language code than the one
+          selected; it may substitute a different region (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)".
+      name:
+          The name of the voice. Optional; if not set, the service will
+          choose a voice based on the other parameters such as
+          language\_code and gender.
+      ssml_gender:
+          The preferred gender of the voice. Optional; 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.VoiceSelectionParams)
+    ),
+)
+_sym_db.RegisterMessage(VoiceSelectionParams)
+
+AudioConfig = _reflection.GeneratedProtocolMessageType(
+    "AudioConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AUDIOCONFIG,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""Description of audio data to be synthesized.
+  
+  
+  Attributes:
+      audio_encoding:
+          Required. The format of the requested audio byte stream.
+      speaking_rate:
+          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.
+      pitch:
+          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.
+      volume_gain_db:
+          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.
+      sample_rate_hertz:
+          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][].
+      effects_profile_id:
+          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:%20//cloud.google.com/text-to-
+          speech/docs/audio-profiles>`__ for current supported profile
+          ids.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.AudioConfig)
+    ),
+)
+_sym_db.RegisterMessage(AudioConfig)
+
+SynthesizeSpeechResponse = _reflection.GeneratedProtocolMessageType(
+    "SynthesizeSpeechResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNTHESIZESPEECHRESPONSE,
+        __module__="google.cloud.texttospeech_v1.proto.cloud_tts_pb2",
+        __doc__="""The message returned to the client by the ``SynthesizeSpeech`` method.
+  
+  
+  Attributes:
+      audio_content:
+          The audio data bytes encoded as specified in the request,
+          including the header (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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1.SynthesizeSpeechResponse)
+    ),
+)
+_sym_db.RegisterMessage(SynthesizeSpeechResponse)
+
+
+DESCRIPTOR._options = None
+
+_TEXTTOSPEECH = _descriptor.ServiceDescriptor(
+    name="TextToSpeech",
+    full_name="google.cloud.texttospeech.v1.TextToSpeech",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1229,
+    serialized_end=1541,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListVoices",
+            full_name="google.cloud.texttospeech.v1.TextToSpeech.ListVoices",
+            index=0,
+            containing_service=None,
+            input_type=_LISTVOICESREQUEST,
+            output_type=_LISTVOICESRESPONSE,
+            serialized_options=_b("\202\323\344\223\002\014\022\n/v1/voices"),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SynthesizeSpeech",
+            full_name="google.cloud.texttospeech.v1.TextToSpeech.SynthesizeSpeech",
+            index=1,
+            containing_service=None,
+            input_type=_SYNTHESIZESPEECHREQUEST,
+            output_type=_SYNTHESIZESPEECHRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\030"\023/v1/text:synthesize:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_TEXTTOSPEECH)
+
+DESCRIPTOR.services_by_name["TextToSpeech"] = _TEXTTOSPEECH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts_pb2_grpc.py b/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts_pb2_grpc.py
new file mode 100644
index 000000000000..b1e7bfed73c8
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/proto/cloud_tts_pb2_grpc.py
@@ -0,0 +1,67 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.texttospeech_v1.proto import (
+    cloud_tts_pb2 as google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2,
+)
+
+
+class TextToSpeechStub(object):
+    """Service that implements Google Cloud Text-to-Speech API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListVoices = channel.unary_unary(
+            "/google.cloud.texttospeech.v1.TextToSpeech/ListVoices",
+            request_serializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.ListVoicesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.ListVoicesResponse.FromString,
+        )
+        self.SynthesizeSpeech = channel.unary_unary(
+            "/google.cloud.texttospeech.v1.TextToSpeech/SynthesizeSpeech",
+            request_serializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechResponse.FromString,
+        )
+
+
+class TextToSpeechServicer(object):
+    """Service that implements Google Cloud Text-to-Speech API.
+  """
+
+    def ListVoices(self, request, context):
+        """Returns a list of Voice supported for synthesis.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SynthesizeSpeech(self, request, context):
+        """Synthesizes speech synchronously: receive results after all text input
+    has been processed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_TextToSpeechServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListVoices": grpc.unary_unary_rpc_method_handler(
+            servicer.ListVoices,
+            request_deserializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.ListVoicesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.ListVoicesResponse.SerializeToString,
+        ),
+        "SynthesizeSpeech": grpc.unary_unary_rpc_method_handler(
+            servicer.SynthesizeSpeech,
+            request_deserializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechRequest.FromString,
+            response_serializer=google_dot_cloud_dot_texttospeech__v1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.texttospeech.v1.TextToSpeech", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/texttospeech/google/cloud/texttospeech_v1/types.py b/texttospeech/google/cloud/texttospeech_v1/types.py
new file mode 100644
index 000000000000..ce8dd0e87170
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1/types.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.texttospeech_v1.proto import cloud_tts_pb2
+
+
+_shared_modules = []
+
+_local_modules = [cloud_tts_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.texttospeech_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/__init__.py b/texttospeech/google/cloud/texttospeech_v1beta1/__init__.py
new file mode 100644
index 000000000000..c65453da7d8a
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.texttospeech_v1beta1 import types
+from google.cloud.texttospeech_v1beta1.gapic import enums
+from google.cloud.texttospeech_v1beta1.gapic import text_to_speech_client
+
+
+class TextToSpeechClient(text_to_speech_client.TextToSpeechClient):
+    __doc__ = text_to_speech_client.TextToSpeechClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "TextToSpeechClient")
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/gapic/__init__.py b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/gapic/enums.py b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..97736e3a0080
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/enums.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class AudioEncoding(enum.IntEnum):
+    """
+    Configuration to set up audio encoder. The encoding determines the output
+    audio format that we'd like.
+
+    Attributes:
+      AUDIO_ENCODING_UNSPECIFIED (int): Not specified. Will return result ``google.rpc.Code.INVALID_ARGUMENT``.
+      LINEAR16 (int): Uncompressed 16-bit signed little-endian samples (Linear PCM).
+      Audio content returned as LINEAR16 also contains a WAV header.
+      MP3 (int): MP3 audio.
+      OGG_OPUS (int): 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.
+    """
+
+    AUDIO_ENCODING_UNSPECIFIED = 0
+    LINEAR16 = 1
+    MP3 = 2
+    OGG_OPUS = 3
+
+
+class SsmlVoiceGender(enum.IntEnum):
+    """
+    Gender of the voice as described in `SSML voice
+    element <https://www.w3.org/TR/speech-synthesis11/#edef_voice>`__.
+
+    Attributes:
+      SSML_VOICE_GENDER_UNSPECIFIED (int): 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.
+      MALE (int): A male voice.
+      FEMALE (int): A female voice.
+      NEUTRAL (int): A gender-neutral voice.
+    """
+
+    SSML_VOICE_GENDER_UNSPECIFIED = 0
+    MALE = 1
+    FEMALE = 2
+    NEUTRAL = 3
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/gapic/text_to_speech_client.py b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/text_to_speech_client.py
new file mode 100644
index 000000000000..cf7b3e47dfe7
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/text_to_speech_client.py
@@ -0,0 +1,325 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.texttospeech.v1beta1 TextToSpeech API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.texttospeech_v1beta1.gapic import enums
+from google.cloud.texttospeech_v1beta1.gapic import text_to_speech_client_config
+from google.cloud.texttospeech_v1beta1.gapic.transports import (
+    text_to_speech_grpc_transport,
+)
+from google.cloud.texttospeech_v1beta1.proto import cloud_tts_pb2
+from google.cloud.texttospeech_v1beta1.proto import cloud_tts_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-texttospeech"
+).version
+
+
+class TextToSpeechClient(object):
+    """Service that implements Google Cloud Text-to-Speech API."""
+
+    SERVICE_ADDRESS = "texttospeech.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.texttospeech.v1beta1.TextToSpeech"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            TextToSpeechClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.TextToSpeechGrpcTransport,
+                    Callable[[~.Credentials, type], ~.TextToSpeechGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = text_to_speech_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=text_to_speech_grpc_transport.TextToSpeechGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = text_to_speech_grpc_transport.TextToSpeechGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def list_voices(
+        self,
+        language_code=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of ``Voice`` supported for synthesis.
+
+        Example:
+            >>> from google.cloud import texttospeech_v1beta1
+            >>>
+            >>> client = texttospeech_v1beta1.TextToSpeechClient()
+            >>>
+            >>> response = client.list_voices()
+
+        Args:
+            language_code (str): Optional (but 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 supported "en-*" voices; when specifying "no", you will get
+                supported "no-*" (Norwegian) and "nb-*" (Norwegian Bokmal) voices;
+                specifying "zh" will also get supported "cmn-*" voices; specifying
+                "zh-hk" will also get supported "yue-\*" voices.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.texttospeech_v1beta1.types.ListVoicesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_voices" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_voices"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_voices,
+                default_retry=self._method_configs["ListVoices"].retry,
+                default_timeout=self._method_configs["ListVoices"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_tts_pb2.ListVoicesRequest(language_code=language_code)
+        return self._inner_api_calls["list_voices"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def synthesize_speech(
+        self,
+        input_,
+        voice,
+        audio_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Synthesizes speech synchronously: receive results after all text input
+        has been processed.
+
+        Example:
+            >>> from google.cloud import texttospeech_v1beta1
+            >>>
+            >>> client = texttospeech_v1beta1.TextToSpeechClient()
+            >>>
+            >>> # TODO: Initialize `input_`:
+            >>> input_ = {}
+            >>>
+            >>> # TODO: Initialize `voice`:
+            >>> voice = {}
+            >>>
+            >>> # TODO: Initialize `audio_config`:
+            >>> audio_config = {}
+            >>>
+            >>> response = client.synthesize_speech(input_, voice, audio_config)
+
+        Args:
+            input_ (Union[dict, ~google.cloud.texttospeech_v1beta1.types.SynthesisInput]): Required. The Synthesizer requires either plain text or SSML as input.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.texttospeech_v1beta1.types.SynthesisInput`
+            voice (Union[dict, ~google.cloud.texttospeech_v1beta1.types.VoiceSelectionParams]): Required. The desired voice of the synthesized audio.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.texttospeech_v1beta1.types.VoiceSelectionParams`
+            audio_config (Union[dict, ~google.cloud.texttospeech_v1beta1.types.AudioConfig]): Required. The configuration of the synthesized audio.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.texttospeech_v1beta1.types.AudioConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.texttospeech_v1beta1.types.SynthesizeSpeechResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "synthesize_speech" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "synthesize_speech"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.synthesize_speech,
+                default_retry=self._method_configs["SynthesizeSpeech"].retry,
+                default_timeout=self._method_configs["SynthesizeSpeech"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = cloud_tts_pb2.SynthesizeSpeechRequest(
+            input=input_, voice=voice, audio_config=audio_config
+        )
+        return self._inner_api_calls["synthesize_speech"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/gapic/text_to_speech_client_config.py b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/text_to_speech_client_config.py
new file mode 100644
index 000000000000..bec87d4bd398
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/text_to_speech_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.texttospeech.v1beta1.TextToSpeech": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ListVoices": {
+                    "timeout_millis": 30000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SynthesizeSpeech": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/gapic/transports/__init__.py b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/gapic/transports/text_to_speech_grpc_transport.py b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/transports/text_to_speech_grpc_transport.py
new file mode 100644
index 000000000000..f2c95085735d
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/gapic/transports/text_to_speech_grpc_transport.py
@@ -0,0 +1,135 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.texttospeech_v1beta1.proto import cloud_tts_pb2_grpc
+
+
+class TextToSpeechGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.texttospeech.v1beta1 TextToSpeech API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="texttospeech.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "text_to_speech_stub": cloud_tts_pb2_grpc.TextToSpeechStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="texttospeech.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def list_voices(self):
+        """Return the gRPC stub for :meth:`TextToSpeechClient.list_voices`.
+
+        Returns a list of ``Voice`` supported for synthesis.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["text_to_speech_stub"].ListVoices
+
+    @property
+    def synthesize_speech(self):
+        """Return the gRPC stub for :meth:`TextToSpeechClient.synthesize_speech`.
+
+        Synthesizes speech synchronously: receive results after all text input
+        has been processed.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["text_to_speech_stub"].SynthesizeSpeech
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/proto/__init__.py b/texttospeech/google/cloud/texttospeech_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts.proto b/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts.proto
new file mode 100644
index 000000000000..791499c4dda0
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts.proto
@@ -0,0 +1,228 @@
+// 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.cloud.texttospeech.v1beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+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";
+
+// Service that implements Google Cloud Text-to-Speech API.
+service TextToSpeech {
+  // Returns a list of [Voice][google.cloud.texttospeech.v1beta1.Voice]
+  // supported for synthesis.
+  rpc ListVoices(ListVoicesRequest) returns (ListVoicesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/voices"
+    };
+  }
+
+  // Synthesizes speech synchronously: receive results after all text input
+  // has been processed.
+  rpc SynthesizeSpeech(SynthesizeSpeechRequest)
+      returns (SynthesizeSpeechResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/text:synthesize"
+      body: "*"
+    };
+  }
+}
+
+// The top-level message sent by the client for the `ListVoices` method.
+message ListVoicesRequest {
+  // Optional (but 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
+  // supported "en-*" voices; when specifying "no", you will get supported
+  // "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;
+}
+
+// The message returned to the client by the `ListVoices` method.
+message ListVoicesResponse {
+  // The list of voices.
+  repeated Voice voices = 1;
+}
+
+// Description of a voice supported by the TTS service.
+message Voice {
+  // The languages that this voice supports, expressed as
+  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags (e.g.
+  // "en-US", "es-419", "cmn-tw").
+  repeated string language_codes = 1;
+
+  // The name of this voice.  Each distinct voice has a unique name.
+  string name = 2;
+
+  // The gender of this voice.
+  SsmlVoiceGender ssml_gender = 3;
+
+  // The natural sample rate (in hertz) for this voice.
+  int32 natural_sample_rate_hertz = 4;
+}
+
+// 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;
+
+  // Required. The desired voice of the synthesized audio.
+  VoiceSelectionParams voice = 2;
+
+  // Required. The configuration of the synthesized audio.
+  AudioConfig audio_config = 3;
+}
+
+// Contains text input to be synthesized. Either `text` or `ssml` must be
+// supplied. Supplying both or neither returns
+// [google.rpc.Code.INVALID_ARGUMENT][]. The input size is limited to 5000
+// characters.
+message SynthesisInput {
+  // The input source, which is either plain text or SSML.
+  oneof input_source {
+    // The raw text to be synthesized.
+    string text = 1;
+
+    // The SSML document to be synthesized. The SSML document must be valid
+    // and well-formed. Otherwise the RPC will fail and return
+    // [google.rpc.Code.INVALID_ARGUMENT][]. For more information, see
+    // [SSML](/speech/text-to-speech/docs/ssml).
+    string ssml = 2;
+  }
+}
+
+// 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
+  // [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
+  // "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
+  // the TTS service may choose a voice with a slightly different language code
+  // than the one selected; it may substitute a different region
+  // (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;
+
+  // The name of the voice. Optional; 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
+  // 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 = 3;
+}
+
+// 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;
+}
+
+// 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
+  // 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/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts_pb2.py b/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts_pb2.py
new file mode 100644
index 000000000000..11080df95fbd
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts_pb2.py
@@ -0,0 +1,965 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/texttospeech_v1beta1/proto/cloud_tts.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/texttospeech_v1beta1/proto/cloud_tts.proto",
+    package="google.cloud.texttospeech.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.texttospeech.v1beta1B\021TextToSpeechProtoP\001ZMgoogle.golang.org/genproto/googleapis/cloud/texttospeech/v1beta1;texttospeech\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/texttospeech_v1beta1/proto/cloud_tts.proto\x12!google.cloud.texttospeech.v1beta1\x1a\x1cgoogle/api/annotations.proto"*\n\x11ListVoicesRequest\x12\x15\n\rlanguage_code\x18\x01 \x01(\t"N\n\x12ListVoicesResponse\x12\x38\n\x06voices\x18\x01 \x03(\x0b\x32(.google.cloud.texttospeech.v1beta1.Voice"\x99\x01\n\x05Voice\x12\x16\n\x0elanguage_codes\x18\x01 \x03(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12G\n\x0bssml_gender\x18\x03 \x01(\x0e\x32\x32.google.cloud.texttospeech.v1beta1.SsmlVoiceGender\x12!\n\x19natural_sample_rate_hertz\x18\x04 \x01(\x05"\xe9\x01\n\x17SynthesizeSpeechRequest\x12@\n\x05input\x18\x01 \x01(\x0b\x32\x31.google.cloud.texttospeech.v1beta1.SynthesisInput\x12\x46\n\x05voice\x18\x02 \x01(\x0b\x32\x37.google.cloud.texttospeech.v1beta1.VoiceSelectionParams\x12\x44\n\x0c\x61udio_config\x18\x03 \x01(\x0b\x32..google.cloud.texttospeech.v1beta1.AudioConfig"@\n\x0eSynthesisInput\x12\x0e\n\x04text\x18\x01 \x01(\tH\x00\x12\x0e\n\x04ssml\x18\x02 \x01(\tH\x00\x42\x0e\n\x0cinput_source"\x84\x01\n\x14VoiceSelectionParams\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12G\n\x0bssml_gender\x18\x03 \x01(\x0e\x32\x32.google.cloud.texttospeech.v1beta1.SsmlVoiceGender"\xcc\x01\n\x0b\x41udioConfig\x12H\n\x0e\x61udio_encoding\x18\x01 \x01(\x0e\x32\x30.google.cloud.texttospeech.v1beta1.AudioEncoding\x12\x15\n\rspeaking_rate\x18\x02 \x01(\x01\x12\r\n\x05pitch\x18\x03 \x01(\x01\x12\x16\n\x0evolume_gain_db\x18\x04 \x01(\x01\x12\x19\n\x11sample_rate_hertz\x18\x05 \x01(\x05\x12\x1a\n\x12\x65\x66\x66\x65\x63ts_profile_id\x18\x06 \x03(\t"1\n\x18SynthesizeSpeechResponse\x12\x15\n\raudio_content\x18\x01 \x01(\x0c*W\n\x0fSsmlVoiceGender\x12!\n\x1dSSML_VOICE_GENDER_UNSPECIFIED\x10\x00\x12\x08\n\x04MALE\x10\x01\x12\n\n\x06\x46\x45MALE\x10\x02\x12\x0b\n\x07NEUTRAL\x10\x03*T\n\rAudioEncoding\x12\x1e\n\x1a\x41UDIO_ENCODING_UNSPECIFIED\x10\x00\x12\x0c\n\x08LINEAR16\x10\x01\x12\x07\n\x03MP3\x10\x02\x12\x0c\n\x08OGG_OPUS\x10\x03\x32\xd6\x02\n\x0cTextToSpeech\x12\x92\x01\n\nListVoices\x12\x34.google.cloud.texttospeech.v1beta1.ListVoicesRequest\x1a\x35.google.cloud.texttospeech.v1beta1.ListVoicesResponse"\x17\x82\xd3\xe4\x93\x02\x11\x12\x0f/v1beta1/voices\x12\xb0\x01\n\x10SynthesizeSpeech\x12:.google.cloud.texttospeech.v1beta1.SynthesizeSpeechRequest\x1a;.google.cloud.texttospeech.v1beta1.SynthesizeSpeechResponse"#\x82\xd3\xe4\x93\x02\x1d"\x18/v1beta1/text:synthesize:\x01*B\x8e\x01\n%com.google.cloud.texttospeech.v1beta1B\x11TextToSpeechProtoP\x01ZMgoogle.golang.org/genproto/googleapis/cloud/texttospeech/v1beta1;texttospeech\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+_SSMLVOICEGENDER = _descriptor.EnumDescriptor(
+    name="SsmlVoiceGender",
+    full_name="google.cloud.texttospeech.v1beta1.SsmlVoiceGender",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SSML_VOICE_GENDER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MALE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FEMALE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NEUTRAL", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1099,
+    serialized_end=1186,
+)
+_sym_db.RegisterEnumDescriptor(_SSMLVOICEGENDER)
+
+SsmlVoiceGender = enum_type_wrapper.EnumTypeWrapper(_SSMLVOICEGENDER)
+_AUDIOENCODING = _descriptor.EnumDescriptor(
+    name="AudioEncoding",
+    full_name="google.cloud.texttospeech.v1beta1.AudioEncoding",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="AUDIO_ENCODING_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINEAR16", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MP3", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OGG_OPUS", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1188,
+    serialized_end=1272,
+)
+_sym_db.RegisterEnumDescriptor(_AUDIOENCODING)
+
+AudioEncoding = enum_type_wrapper.EnumTypeWrapper(_AUDIOENCODING)
+SSML_VOICE_GENDER_UNSPECIFIED = 0
+MALE = 1
+FEMALE = 2
+NEUTRAL = 3
+AUDIO_ENCODING_UNSPECIFIED = 0
+LINEAR16 = 1
+MP3 = 2
+OGG_OPUS = 3
+
+
+_LISTVOICESREQUEST = _descriptor.Descriptor(
+    name="ListVoicesRequest",
+    full_name="google.cloud.texttospeech.v1beta1.ListVoicesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.texttospeech.v1beta1.ListVoicesRequest.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=124,
+    serialized_end=166,
+)
+
+
+_LISTVOICESRESPONSE = _descriptor.Descriptor(
+    name="ListVoicesResponse",
+    full_name="google.cloud.texttospeech.v1beta1.ListVoicesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="voices",
+            full_name="google.cloud.texttospeech.v1beta1.ListVoicesResponse.voices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=168,
+    serialized_end=246,
+)
+
+
+_VOICE = _descriptor.Descriptor(
+    name="Voice",
+    full_name="google.cloud.texttospeech.v1beta1.Voice",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_codes",
+            full_name="google.cloud.texttospeech.v1beta1.Voice.language_codes",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.texttospeech.v1beta1.Voice.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssml_gender",
+            full_name="google.cloud.texttospeech.v1beta1.Voice.ssml_gender",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="natural_sample_rate_hertz",
+            full_name="google.cloud.texttospeech.v1beta1.Voice.natural_sample_rate_hertz",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=249,
+    serialized_end=402,
+)
+
+
+_SYNTHESIZESPEECHREQUEST = _descriptor.Descriptor(
+    name="SynthesizeSpeechRequest",
+    full_name="google.cloud.texttospeech.v1beta1.SynthesizeSpeechRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesizeSpeechRequest.input",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="voice",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesizeSpeechRequest.voice",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_config",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesizeSpeechRequest.audio_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=405,
+    serialized_end=638,
+)
+
+
+_SYNTHESISINPUT = _descriptor.Descriptor(
+    name="SynthesisInput",
+    full_name="google.cloud.texttospeech.v1beta1.SynthesisInput",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesisInput.text",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssml",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesisInput.ssml",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="input_source",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesisInput.input_source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=640,
+    serialized_end=704,
+)
+
+
+_VOICESELECTIONPARAMS = _descriptor.Descriptor(
+    name="VoiceSelectionParams",
+    full_name="google.cloud.texttospeech.v1beta1.VoiceSelectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.texttospeech.v1beta1.VoiceSelectionParams.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.texttospeech.v1beta1.VoiceSelectionParams.name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ssml_gender",
+            full_name="google.cloud.texttospeech.v1beta1.VoiceSelectionParams.ssml_gender",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=707,
+    serialized_end=839,
+)
+
+
+_AUDIOCONFIG = _descriptor.Descriptor(
+    name="AudioConfig",
+    full_name="google.cloud.texttospeech.v1beta1.AudioConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="audio_encoding",
+            full_name="google.cloud.texttospeech.v1beta1.AudioConfig.audio_encoding",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speaking_rate",
+            full_name="google.cloud.texttospeech.v1beta1.AudioConfig.speaking_rate",
+            index=1,
+            number=2,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pitch",
+            full_name="google.cloud.texttospeech.v1beta1.AudioConfig.pitch",
+            index=2,
+            number=3,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="volume_gain_db",
+            full_name="google.cloud.texttospeech.v1beta1.AudioConfig.volume_gain_db",
+            index=3,
+            number=4,
+            type=1,
+            cpp_type=5,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sample_rate_hertz",
+            full_name="google.cloud.texttospeech.v1beta1.AudioConfig.sample_rate_hertz",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="effects_profile_id",
+            full_name="google.cloud.texttospeech.v1beta1.AudioConfig.effects_profile_id",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=842,
+    serialized_end=1046,
+)
+
+
+_SYNTHESIZESPEECHRESPONSE = _descriptor.Descriptor(
+    name="SynthesizeSpeechResponse",
+    full_name="google.cloud.texttospeech.v1beta1.SynthesizeSpeechResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="audio_content",
+            full_name="google.cloud.texttospeech.v1beta1.SynthesizeSpeechResponse.audio_content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1048,
+    serialized_end=1097,
+)
+
+_LISTVOICESRESPONSE.fields_by_name["voices"].message_type = _VOICE
+_VOICE.fields_by_name["ssml_gender"].enum_type = _SSMLVOICEGENDER
+_SYNTHESIZESPEECHREQUEST.fields_by_name["input"].message_type = _SYNTHESISINPUT
+_SYNTHESIZESPEECHREQUEST.fields_by_name["voice"].message_type = _VOICESELECTIONPARAMS
+_SYNTHESIZESPEECHREQUEST.fields_by_name["audio_config"].message_type = _AUDIOCONFIG
+_SYNTHESISINPUT.oneofs_by_name["input_source"].fields.append(
+    _SYNTHESISINPUT.fields_by_name["text"]
+)
+_SYNTHESISINPUT.fields_by_name[
+    "text"
+].containing_oneof = _SYNTHESISINPUT.oneofs_by_name["input_source"]
+_SYNTHESISINPUT.oneofs_by_name["input_source"].fields.append(
+    _SYNTHESISINPUT.fields_by_name["ssml"]
+)
+_SYNTHESISINPUT.fields_by_name[
+    "ssml"
+].containing_oneof = _SYNTHESISINPUT.oneofs_by_name["input_source"]
+_VOICESELECTIONPARAMS.fields_by_name["ssml_gender"].enum_type = _SSMLVOICEGENDER
+_AUDIOCONFIG.fields_by_name["audio_encoding"].enum_type = _AUDIOENCODING
+DESCRIPTOR.message_types_by_name["ListVoicesRequest"] = _LISTVOICESREQUEST
+DESCRIPTOR.message_types_by_name["ListVoicesResponse"] = _LISTVOICESRESPONSE
+DESCRIPTOR.message_types_by_name["Voice"] = _VOICE
+DESCRIPTOR.message_types_by_name["SynthesizeSpeechRequest"] = _SYNTHESIZESPEECHREQUEST
+DESCRIPTOR.message_types_by_name["SynthesisInput"] = _SYNTHESISINPUT
+DESCRIPTOR.message_types_by_name["VoiceSelectionParams"] = _VOICESELECTIONPARAMS
+DESCRIPTOR.message_types_by_name["AudioConfig"] = _AUDIOCONFIG
+DESCRIPTOR.message_types_by_name["SynthesizeSpeechResponse"] = _SYNTHESIZESPEECHRESPONSE
+DESCRIPTOR.enum_types_by_name["SsmlVoiceGender"] = _SSMLVOICEGENDER
+DESCRIPTOR.enum_types_by_name["AudioEncoding"] = _AUDIOENCODING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ListVoicesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListVoicesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTVOICESREQUEST,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""The top-level message sent by the client for the ``ListVoices`` method.
+  
+  
+  Attributes:
+      language_code:
+          Optional (but 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 supported "en-*" voices; when specifying
+          "no", you will get supported "no-*" (Norwegian) and "nb-*"
+          (Norwegian Bokmal) voices; specifying "zh" will also get
+          supported "cmn-*" voices; specifying "zh-hk" will also get
+          supported "yue-\*" voices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.ListVoicesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListVoicesRequest)
+
+ListVoicesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListVoicesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTVOICESRESPONSE,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""The message returned to the client by the ``ListVoices`` method.
+  
+  
+  Attributes:
+      voices:
+          The list of voices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.ListVoicesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListVoicesResponse)
+
+Voice = _reflection.GeneratedProtocolMessageType(
+    "Voice",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VOICE,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""Description of a voice supported by the TTS service.
+  
+  
+  Attributes:
+      language_codes:
+          The languages that this voice supports, expressed as `BCP-47
+          <https://www.rfc-editor.org/rfc/bcp/bcp47.txt>`__ language
+          tags (e.g. "en-US", "es-419", "cmn-tw").
+      name:
+          The name of this voice. Each distinct voice has a unique name.
+      ssml_gender:
+          The gender of this voice.
+      natural_sample_rate_hertz:
+          The natural sample rate (in hertz) for this voice.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.Voice)
+    ),
+)
+_sym_db.RegisterMessage(Voice)
+
+SynthesizeSpeechRequest = _reflection.GeneratedProtocolMessageType(
+    "SynthesizeSpeechRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNTHESIZESPEECHREQUEST,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""The top-level message sent by the client for the ``SynthesizeSpeech``
+  method.
+  
+  
+  Attributes:
+      input:
+          Required. The Synthesizer requires either plain text or SSML
+          as input.
+      voice:
+          Required. The desired voice of the synthesized audio.
+      audio_config:
+          Required. The configuration of the synthesized audio.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.SynthesizeSpeechRequest)
+    ),
+)
+_sym_db.RegisterMessage(SynthesizeSpeechRequest)
+
+SynthesisInput = _reflection.GeneratedProtocolMessageType(
+    "SynthesisInput",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNTHESISINPUT,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""Contains text input to be synthesized. Either ``text`` or ``ssml`` must
+  be supplied. Supplying both or neither returns
+  [google.rpc.Code.INVALID\_ARGUMENT][]. The input size is limited to 5000
+  characters.
+  
+  
+  Attributes:
+      input_source:
+          The input source, which is either plain text or SSML.
+      text:
+          The raw text to be synthesized.
+      ssml:
+          The SSML document to be synthesized. The SSML document must be
+          valid and well-formed. Otherwise the RPC will fail and return
+          [google.rpc.Code.INVALID\_ARGUMENT][]. For more information,
+          see `SSML </speech/text-to-speech/docs/ssml>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.SynthesisInput)
+    ),
+)
+_sym_db.RegisterMessage(SynthesisInput)
+
+VoiceSelectionParams = _reflection.GeneratedProtocolMessageType(
+    "VoiceSelectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VOICESELECTIONPARAMS,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""Description of which voice to use for a synthesis request.
+  
+  
+  Attributes:
+      language_code:
+          The language (and optionally 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 "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 the TTS service may choose a
+          voice with a slightly different language code than the one
+          selected; it may substitute a different region (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)".
+      name:
+          The name of the voice. Optional; if not set, the service will
+          choose a voice based on the other parameters such as
+          language\_code and gender.
+      ssml_gender:
+          The preferred gender of the voice. Optional; 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.VoiceSelectionParams)
+    ),
+)
+_sym_db.RegisterMessage(VoiceSelectionParams)
+
+AudioConfig = _reflection.GeneratedProtocolMessageType(
+    "AudioConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_AUDIOCONFIG,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""Description of audio data to be synthesized.
+  
+  
+  Attributes:
+      audio_encoding:
+          Required. The format of the requested audio byte stream.
+      speaking_rate:
+          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.
+      pitch:
+          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.
+      volume_gain_db:
+          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.
+      sample_rate_hertz:
+          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][].
+      effects_profile_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.AudioConfig)
+    ),
+)
+_sym_db.RegisterMessage(AudioConfig)
+
+SynthesizeSpeechResponse = _reflection.GeneratedProtocolMessageType(
+    "SynthesizeSpeechResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYNTHESIZESPEECHRESPONSE,
+        __module__="google.cloud.texttospeech_v1beta1.proto.cloud_tts_pb2",
+        __doc__="""The message returned to the client by the ``SynthesizeSpeech`` method.
+  
+  
+  Attributes:
+      audio_content:
+          The audio data bytes encoded as specified in the request,
+          including the header (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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.texttospeech.v1beta1.SynthesizeSpeechResponse)
+    ),
+)
+_sym_db.RegisterMessage(SynthesizeSpeechResponse)
+
+
+DESCRIPTOR._options = None
+
+_TEXTTOSPEECH = _descriptor.ServiceDescriptor(
+    name="TextToSpeech",
+    full_name="google.cloud.texttospeech.v1beta1.TextToSpeech",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1275,
+    serialized_end=1617,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListVoices",
+            full_name="google.cloud.texttospeech.v1beta1.TextToSpeech.ListVoices",
+            index=0,
+            containing_service=None,
+            input_type=_LISTVOICESREQUEST,
+            output_type=_LISTVOICESRESPONSE,
+            serialized_options=_b("\202\323\344\223\002\021\022\017/v1beta1/voices"),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SynthesizeSpeech",
+            full_name="google.cloud.texttospeech.v1beta1.TextToSpeech.SynthesizeSpeech",
+            index=1,
+            containing_service=None,
+            input_type=_SYNTHESIZESPEECHREQUEST,
+            output_type=_SYNTHESIZESPEECHRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\035"\030/v1beta1/text:synthesize:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_TEXTTOSPEECH)
+
+DESCRIPTOR.services_by_name["TextToSpeech"] = _TEXTTOSPEECH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts_pb2_grpc.py b/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts_pb2_grpc.py
new file mode 100644
index 000000000000..3aaa81701692
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/proto/cloud_tts_pb2_grpc.py
@@ -0,0 +1,68 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.texttospeech_v1beta1.proto import (
+    cloud_tts_pb2 as google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2,
+)
+
+
+class TextToSpeechStub(object):
+    """Service that implements Google Cloud Text-to-Speech API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListVoices = channel.unary_unary(
+            "/google.cloud.texttospeech.v1beta1.TextToSpeech/ListVoices",
+            request_serializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.ListVoicesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.ListVoicesResponse.FromString,
+        )
+        self.SynthesizeSpeech = channel.unary_unary(
+            "/google.cloud.texttospeech.v1beta1.TextToSpeech/SynthesizeSpeech",
+            request_serializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechResponse.FromString,
+        )
+
+
+class TextToSpeechServicer(object):
+    """Service that implements Google Cloud Text-to-Speech API.
+  """
+
+    def ListVoices(self, request, context):
+        """Returns a list of [Voice][google.cloud.texttospeech.v1beta1.Voice]
+    supported for synthesis.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SynthesizeSpeech(self, request, context):
+        """Synthesizes speech synchronously: receive results after all text input
+    has been processed.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_TextToSpeechServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListVoices": grpc.unary_unary_rpc_method_handler(
+            servicer.ListVoices,
+            request_deserializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.ListVoicesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.ListVoicesResponse.SerializeToString,
+        ),
+        "SynthesizeSpeech": grpc.unary_unary_rpc_method_handler(
+            servicer.SynthesizeSpeech,
+            request_deserializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechRequest.FromString,
+            response_serializer=google_dot_cloud_dot_texttospeech__v1beta1_dot_proto_dot_cloud__tts__pb2.SynthesizeSpeechResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.texttospeech.v1beta1.TextToSpeech", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/texttospeech/google/cloud/texttospeech_v1beta1/types.py b/texttospeech/google/cloud/texttospeech_v1beta1/types.py
new file mode 100644
index 000000000000..745174ae83fe
--- /dev/null
+++ b/texttospeech/google/cloud/texttospeech_v1beta1/types.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.texttospeech_v1beta1.proto import cloud_tts_pb2
+
+
+_shared_modules = []
+
+_local_modules = [cloud_tts_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.texttospeech_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/texttospeech/noxfile.py b/texttospeech/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/texttospeech/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/texttospeech/setup.cfg b/texttospeech/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/texttospeech/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/texttospeech/setup.py b/texttospeech/setup.py
new file mode 100644
index 000000000000..bd3f306eb8a6
--- /dev/null
+++ b/texttospeech/setup.py
@@ -0,0 +1,99 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-texttospeech"
+description = "Google Cloud Text-to-Speech API client library"
+version = "0.5.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/texttospeech/synth.metadata b/texttospeech/synth.metadata
new file mode 100644
index 000000000000..55fda3f44d74
--- /dev/null
+++ b/texttospeech/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:43:45.265950Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "texttospeech",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/texttospeech/artman_texttospeech_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "texttospeech",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/texttospeech/artman_texttospeech_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/texttospeech/synth.py b/texttospeech/synth.py
new file mode 100644
index 000000000000..d03c792a0888
--- /dev/null
+++ b/texttospeech/synth.py
@@ -0,0 +1,46 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import re
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1", "v1"]
+
+# ----------------------------------------------------------------------------
+# Generate texttospeech GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("texttospeech", version, include_protos=True)
+    s.move(library / f"google/cloud/texttospeech_{version}")
+    s.move(library / f"tests/unit/gapic/{version}")
+    s.move(library / f"docs/gapic/{version}")
+
+# Use the highest version library to generate import alias.
+s.move(library / "google/cloud/texttospeech.py")
+
+# Fix bad docstrings.
+s.replace("**/gapic/*_client.py", r'\\"(.+?)-\*\\"', r'"\1-\\*"')
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/texttospeech/tests/unit/gapic/v1/test_text_to_speech_client_v1.py b/texttospeech/tests/unit/gapic/v1/test_text_to_speech_client_v1.py
new file mode 100644
index 000000000000..37f363b44904
--- /dev/null
+++ b/texttospeech/tests/unit/gapic/v1/test_text_to_speech_client_v1.py
@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import texttospeech_v1
+from google.cloud.texttospeech_v1.proto import cloud_tts_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestTextToSpeechClient(object):
+    def test_list_voices(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_tts_pb2.ListVoicesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1.TextToSpeechClient()
+
+        response = client.list_voices()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_tts_pb2.ListVoicesRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_voices_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1.TextToSpeechClient()
+
+        with pytest.raises(CustomException):
+            client.list_voices()
+
+    def test_synthesize_speech(self):
+        # Setup Expected Response
+        audio_content = b"16"
+        expected_response = {"audio_content": audio_content}
+        expected_response = cloud_tts_pb2.SynthesizeSpeechResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1.TextToSpeechClient()
+
+        # Setup Request
+        input_ = {}
+        voice = {}
+        audio_config = {}
+
+        response = client.synthesize_speech(input_, voice, audio_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_tts_pb2.SynthesizeSpeechRequest(
+            input=input_, voice=voice, audio_config=audio_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_synthesize_speech_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1.TextToSpeechClient()
+
+        # Setup request
+        input_ = {}
+        voice = {}
+        audio_config = {}
+
+        with pytest.raises(CustomException):
+            client.synthesize_speech(input_, voice, audio_config)
diff --git a/texttospeech/tests/unit/gapic/v1beta1/test_text_to_speech_client_v1beta1.py b/texttospeech/tests/unit/gapic/v1beta1/test_text_to_speech_client_v1beta1.py
new file mode 100644
index 000000000000..f0825c04c8c6
--- /dev/null
+++ b/texttospeech/tests/unit/gapic/v1beta1/test_text_to_speech_client_v1beta1.py
@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import texttospeech_v1beta1
+from google.cloud.texttospeech_v1beta1.proto import cloud_tts_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestTextToSpeechClient(object):
+    def test_list_voices(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = cloud_tts_pb2.ListVoicesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1beta1.TextToSpeechClient()
+
+        response = client.list_voices()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_tts_pb2.ListVoicesRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_voices_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1beta1.TextToSpeechClient()
+
+        with pytest.raises(CustomException):
+            client.list_voices()
+
+    def test_synthesize_speech(self):
+        # Setup Expected Response
+        audio_content = b"16"
+        expected_response = {"audio_content": audio_content}
+        expected_response = cloud_tts_pb2.SynthesizeSpeechResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1beta1.TextToSpeechClient()
+
+        # Setup Request
+        input_ = {}
+        voice = {}
+        audio_config = {}
+
+        response = client.synthesize_speech(input_, voice, audio_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = cloud_tts_pb2.SynthesizeSpeechRequest(
+            input=input_, voice=voice, audio_config=audio_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_synthesize_speech_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = texttospeech_v1beta1.TextToSpeechClient()
+
+        # Setup request
+        input_ = {}
+        voice = {}
+        audio_config = {}
+
+        with pytest.raises(CustomException):
+            client.synthesize_speech(input_, voice, audio_config)
diff --git a/third_party/sphinx/LICENSE b/third_party/sphinx/LICENSE
new file mode 100644
index 000000000000..09d3bd624f62
--- /dev/null
+++ b/third_party/sphinx/LICENSE
@@ -0,0 +1,280 @@
+License for Sphinx
+==================
+
+Copyright (c) 2007-2017 by the Sphinx team (see AUTHORS file).
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Licenses for incorporated software
+==================================
+
+The pgen2 package, included in this distribution under the name
+sphinx.pycode.pgen2, is available in the Python 2.6 distribution under
+the PSF license agreement for Python:
+
+----------------------------------------------------------------------
+Copyright © 2001-2008 Python Software Foundation; All Rights Reserved.
+
+PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+--------------------------------------------
+
+1. This LICENSE AGREEMENT is between the Python Software Foundation
+   ("PSF"), and the Individual or Organization ("Licensee") accessing
+   and otherwise using Python 2.6 software in source or binary form
+   and its associated documentation.
+
+2. Subject to the terms and conditions of this License Agreement, PSF
+   hereby grants Licensee a nonexclusive, royalty-free, world-wide
+   license to reproduce, analyze, test, perform and/or display
+   publicly, prepare derivative works, distribute, and otherwise use
+   Python 2.6 alone or in any derivative version, provided, however,
+   that PSF's License Agreement and PSF's notice of copyright, i.e.,
+   "Copyright © 2001-2008 Python Software Foundation; All Rights
+   Reserved" are retained in Python 2.6 alone or in any derivative
+   version prepared by Licensee.
+
+3. In the event Licensee prepares a derivative work that is based on
+   or incorporates Python 2.6 or any part thereof, and wants to make
+   the derivative work available to others as provided herein, then
+   Licensee hereby agrees to include in any such work a brief summary
+   of the changes made to Python 2.6.
+
+4. PSF is making Python 2.6 available to Licensee on an "AS IS" basis.
+   PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED.  BY
+   WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND DISCLAIMS ANY
+   REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY
+   PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 2.6 WILL NOT INFRINGE
+   ANY THIRD PARTY RIGHTS.
+
+5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
+   2.6 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
+   AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON
+   2.6, OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY
+   THEREOF.
+
+6. This License Agreement will automatically terminate upon a material
+   breach of its terms and conditions.
+
+7. Nothing in this License Agreement shall be deemed to create any
+   relationship of agency, partnership, or joint venture between PSF
+   and Licensee.  This License Agreement does not grant permission to
+   use PSF trademarks or trade name in a trademark sense to endorse or
+   promote products or services of Licensee, or any third party.
+
+8. By copying, installing or otherwise using Python 2.6, Licensee
+   agrees to be bound by the terms and conditions of this License
+   Agreement.
+----------------------------------------------------------------------
+
+The included smartypants module, included as sphinx.util.smartypants,
+is available under the following license:
+
+----------------------------------------------------------------------
+SmartyPants_ license::
+
+    Copyright (c) 2003 John Gruber
+    (http://daringfireball.net/)
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions
+    are met:
+
+    *   Redistributions of source code must retain the above copyright
+        notice, this list of conditions and the following disclaimer.
+
+    *   Redistributions in binary form must reproduce the above
+        copyright notice, this list of conditions and the following
+        disclaimer in the documentation and/or other materials
+        provided with the distribution.
+
+    *   Neither the name "SmartyPants" nor the names of its
+        contributors may be used to endorse or promote products
+        derived from this software without specific prior written
+        permission.
+
+    This software is provided by the copyright holders and
+    contributors "as is" and any express or implied warranties,
+    including, but not limited to, the implied warranties of
+    merchantability and fitness for a particular purpose are
+    disclaimed. In no event shall the copyright owner or contributors
+    be liable for any direct, indirect, incidental, special,
+    exemplary, or consequential damages (including, but not limited
+    to, procurement of substitute goods or services; loss of use,
+    data, or profits; or business interruption) however caused and on
+    any theory of liability, whether in contract, strict liability, or
+    tort (including negligence or otherwise) arising in any way out of
+    the use of this software, even if advised of the possibility of
+    such damage.
+
+
+smartypants.py license::
+
+    smartypants.py is a derivative work of SmartyPants.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions
+    are met:
+
+    *   Redistributions of source code must retain the above copyright
+        notice, this list of conditions and the following disclaimer.
+
+    *   Redistributions in binary form must reproduce the above
+        copyright notice, this list of conditions and the following
+        disclaimer in the documentation and/or other materials
+        provided with the distribution.
+
+    This software is provided by the copyright holders and
+    contributors "as is" and any express or implied warranties,
+    including, but not limited to, the implied warranties of
+    merchantability and fitness for a particular purpose are
+    disclaimed. In no event shall the copyright owner or contributors
+    be liable for any direct, indirect, incidental, special,
+    exemplary, or consequential damages (including, but not limited
+    to, procurement of substitute goods or services; loss of use,
+    data, or profits; or business interruption) however caused and on
+    any theory of liability, whether in contract, strict liability, or
+    tort (including negligence or otherwise) arising in any way out of
+    the use of this software, even if advised of the possibility of
+    such damage.
+----------------------------------------------------------------------
+
+The ElementTree package, included in this distribution in
+test/etree13, is available under the following license:
+
+----------------------------------------------------------------------
+The ElementTree toolkit is
+
+Copyright (c) 1999-2007 by Fredrik Lundh
+
+By obtaining, using, and/or copying this software and/or its
+associated documentation, you agree that you have read, understood,
+and will comply with the following terms and conditions:
+
+Permission to use, copy, modify, and distribute this software and its
+associated documentation for any purpose and without fee is hereby
+granted, provided that the above copyright notice appears in all
+copies, and that both that copyright notice and this permission notice
+appear in supporting documentation, and that the name of Secret Labs
+AB or the author not be used in advertising or publicity pertaining to
+distribution of the software without specific, written prior
+permission.
+
+SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO
+THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT- ABILITY
+AND FITNESS.  IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE
+FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+----------------------------------------------------------------------
+
+The included JQuery JavaScript library is available under the MIT
+license:
+
+----------------------------------------------------------------------
+Copyright (c) 2008 John Resig, http://jquery.com/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+----------------------------------------------------------------------
+
+The included Underscore JavaScript library is available under the MIT
+license:
+
+----------------------------------------------------------------------
+Copyright (c) 2009 Jeremy Ashkenas, DocumentCloud
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+-------------------------------------------------------------------------------
+
+The included implementation of NumpyDocstring._parse_numpydoc_see_also_section
+was derived from code under the following license:
+
+-------------------------------------------------------------------------------
+
+Copyright (C) 2008 Stefan van der Walt <stefan@mentat.za.net>, Pauli Virtanen <pav@iki.fi>
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ 1. Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+-------------------------------------------------------------------------------
diff --git a/third_party/sphinx/README.md b/third_party/sphinx/README.md
new file mode 100644
index 000000000000..f4b4700b0d95
--- /dev/null
+++ b/third_party/sphinx/README.md
@@ -0,0 +1,2 @@
+Subset of [Sphinx](https://github.com/sphinx-doc/sphinx) to override built-in
+templates.
diff --git a/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/class.rst b/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/class.rst
new file mode 100644
index 000000000000..31b00c6e9893
--- /dev/null
+++ b/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/class.rst
@@ -0,0 +1,38 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+{% block methods %}
+{% if methods %}
+.. rubric:: Methods
+
+.. autosummary::
+{% for item in methods %}
+   {% if item != '__init__' %}
+   ~{{ name }}.{{ item }}
+   {% endif %}
+{%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block attributes %}
+{% if attributes %}
+.. rubric:: Attributes
+
+.. autosummary::
+{% for item in attributes %}
+   ~{{ name }}.{{ item }}
+{%- endfor %}
+{% endif %}
+{% endblock %}
+
+.. raw:: html
+
+    <p>
+    <hr>
+    <p>
+
+.. autoclass:: {{ objname }}
+   :show-inheritance:
+   :inherited-members:
+   :members:
diff --git a/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/module.rst b/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/module.rst
new file mode 100644
index 000000000000..3abee6f3632a
--- /dev/null
+++ b/third_party/sphinx/sphinx/ext/autosummary/templates/autosummary/module.rst
@@ -0,0 +1,41 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+   {% block functions %}
+   {% if functions %}
+   .. rubric:: Functions
+
+   {# Customized from original by adding toctree. This generates docs for the
+   listed functions. #}
+   .. autosummary::
+      :toctree: .
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block classes %}
+   {% if classes %}
+   .. rubric:: Classes
+
+   .. autosummary::
+      :toctree: .
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block exceptions %}
+   {% if exceptions %}
+   .. rubric:: Exceptions
+
+   .. autosummary::
+      :toctree: .
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
diff --git a/tox.ini b/tox.ini
deleted file mode 100644
index d0cc47ded48d..000000000000
--- a/tox.ini
+++ /dev/null
@@ -1,145 +0,0 @@
-[tox]
-envlist =
-    py27,py34,py35,cover,docs,lint
-
-[testing]
-deps =
-    pytest
-covercmd =
-    py.test --quiet \
-      --cov=google.cloud \
-      --cov=unit_tests \
-      --cov-config {toxinidir}/.coveragerc \
-      unit_tests
-
-[testenv]
-commands =
-    py.test --quiet {posargs} unit_tests
-deps =
-    {[testing]deps}
-
-[testenv:py27-pandas]
-basepython =
-    python2.7
-deps =
-    {[testenv]deps}
-    pandas
-
-[testenv:cover]
-basepython =
-    python2.7
-commands =
-    {[testing]covercmd}
-deps =
-    {[testenv]deps}
-    coverage
-    pytest-cov
-
-[testenv:coveralls]
-basepython = {[testenv:cover]basepython}
-commands =
-    {[testing]covercmd}
-    coveralls
-ignore_errors = True
-deps =
-    {[testenv:cover]deps}
-    coveralls
-passenv = {[testenv:system-tests]passenv}
-
-[testenv:json-docs]
-basepython =
-    python2.7
-commands =
-    python -c \
-        "import shutil; shutil.rmtree('docs/_build/json', ignore_errors=True)"
-    {toxinidir}/scripts/update_json_docs.sh
-deps =
-    parinx
-    pdoc
-    Sphinx
-passenv =
-    TRAVIS_TAG
-    TRAVIS_BRANCH
-    TRAVIS_PULL_REQUEST
-    GH_OWNER
-    GH_OAUTH_TOKEN
-    GH_PROJECT_NAME
-
-[testenv:docs]
-basepython =
-    python2.7
-commands =
-    python -c \
-        "import shutil; shutil.rmtree('docs/_build', ignore_errors=True)"
-    sphinx-build -W -b html -d docs/_build/doctrees docs docs/_build/html
-    python {toxinidir}/scripts/verify_included_modules.py --build-root _build
-deps =
-    {[testenv]deps}
-    Sphinx
-    sphinx_rtd_theme
-passenv = {[testenv:system-tests]passenv} SPHINX_RELEASE READTHEDOCS
-
-[pep8]
-exclude =
-    docs/conf.py,
-    google/cloud/bigtable/_generated*/*,
-    google/cloud/datastore/_generated/*
-verbose = 1
-
-[testenv:lint]
-basepython =
-    python2.7
-commands =
-    python {toxinidir}/scripts/pycodestyle_on_repo.py
-    python {toxinidir}/scripts/run_pylint.py
-deps =
-    {[testenv]deps}
-    pycodestyle
-    pylint >= 1.6.4
-passenv = {[testenv:system-tests]passenv}
-
-[testenv:system-tests]
-basepython =
-    python2.7
-commands =
-    python {toxinidir}/system_tests/attempt_system_tests.py {posargs}
-passenv = GOOGLE_* GOOGLE_CLOUD_* TRAVIS* encrypted_*
-
-[testenv:system-tests3]
-basepython =
-    python3.4
-commands =
-    python {toxinidir}/system_tests/attempt_system_tests.py {posargs}
-passenv = {[testenv:system-tests]passenv}
-
-[emulator]
-deps =
-    {[testenv]deps}
-    psutil
-setenv =
-    GOOGLE_CLOUD_NO_PRINT=true
-passenv =
-    GOOGLE_CLOUD_DISABLE_GRPC
-emulatorcmd =
-    python {toxinidir}/system_tests/run_emulator.py
-
-[testenv:datastore-emulator]
-commands =
-    {[emulator]emulatorcmd} --package=datastore
-setenv = {[emulator]setenv}
-passenv = {[emulator]passenv}
-deps = {[emulator]deps}
-
-[testenv:pubsub-emulator]
-commands =
-    {[emulator]emulatorcmd} --package=pubsub
-setenv = {[emulator]setenv}
-passenv = {[emulator]passenv}
-deps = {[emulator]deps}
-
-[testenv:bigtable-emulator]
-commands =
-    {[emulator]emulatorcmd} --package=bigtable
-setenv = {[emulator]setenv}
-passenv = {[emulator]passenv}
-deps = {[emulator]deps}
diff --git a/trace/.coveragerc b/trace/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/trace/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/trace/.flake8 b/trace/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/trace/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/trace/.repo-metadata.json b/trace/.repo-metadata.json
new file mode 100644
index 000000000000..cd282113f47a
--- /dev/null
+++ b/trace/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "cloudtrace",
+  "name_pretty": "Stackdriver Trace",
+  "product_documentation": "https://cloud.google.com/trace/docs",
+  "client_documentation": "https://googleapis.dev/python/cloudtrace/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559776",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-trace",
+  "api_id": "cloudtrace.googleapis.com",
+  "requires_billing": false
+}
\ No newline at end of file
diff --git a/trace/CHANGELOG.md b/trace/CHANGELOG.md
new file mode 100644
index 000000000000..4c1344b4b03c
--- /dev/null
+++ b/trace/CHANGELOG.md
@@ -0,0 +1,169 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-trace/#history
+
+## 0.22.1
+
+08-12-2019 13:51 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8973](https://github.com/googleapis/google-cloud-python/pull/8973))
+
+### Documentation
+- Fix links to googleapis.dev ([#8998](https://github.com/googleapis/google-cloud-python/pull/8998))
+- Fix pip / usage examples in README.rst. ([#8833](https://github.com/googleapis/google-cloud-python/pull/8833))
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.22.0
+
+07-24-2019 17:50 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8408](https://github.com/googleapis/google-cloud-python/pull/8408))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8526](https://github.com/googleapis/google-cloud-python/pull/8526))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- All: Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8368](https://github.com/googleapis/google-cloud-python/pull/8368))
+- Add disclaimer to auto-generated template files (via synth). ([#8332](https://github.com/googleapis/google-cloud-python/pull/8332))
+- Fix coverage in 'types.py' (via synth). ([#8167](https://github.com/googleapis/google-cloud-python/pull/8167))
+- Add empty lines (via synth). ([#8075](https://github.com/googleapis/google-cloud-python/pull/8075))
+
+## 0.21.0
+
+05-16-2019 12:58 PDT
+
+
+### Implementation Changes
+- Add routing header to method metadata (via synth).  ([#7602](https://github.com/googleapis/google-cloud-python/pull/7602))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add `client_info` support to clients. ([#7899](https://github.com/googleapis/google-cloud-python/pull/7899))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Update docstring for `page_size` (via synth). ([#7688](https://github.com/googleapis/google-cloud-python/pull/7688))
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Pick up stub docstring fix in GAPIC generator. ([#6985](https://github.com/googleapis/google-cloud-python/pull/6985))
+
+### Internal / Testing Changes
+- Add nox session `docs`, reorder methods (via synth). ([#7783](https://github.com/googleapis/google-cloud-python/pull/7783)) and ([#7784](https://github.com/googleapis/google-cloud-python/pull/7784))
+- Copy lintified proto files (via synth). ([#7455](https://github.com/googleapis/google-cloud-python/pull/7455))
+- Add clarifying comment to blacken nox target. ([#7406](https://github.com/googleapis/google-cloud-python/pull/7406))
+- Remove unused message exports (via synth). ([#7278](https://github.com/googleapis/google-cloud-python/pull/7278))
+- Copy proto files alongside protoc versions ([#7254](https://github.com/googleapis/google-cloud-python/pull/7254))
+- Trivial gapic-generator change. ([#7236](https://github.com/googleapis/google-cloud-python/pull/7236))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+- Update copyright headers (via synth). ([#7161](https://github.com/googleapis/google-cloud-python/pull/7161))
+- Protoc-generated serialization update. ([#7098](https://github.com/googleapis/google-cloud-python/pull/7098))
+
+## 0.20.2
+
+12-17-2018 17:06 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+## 0.20.1
+
+12-07-2018 16:06 PST
+
+### Implementation Changes
+- Fix trace client memory leak ([#6856](https://github.com/googleapis/google-cloud-python/pull/6856))
+
+### Dependencies
+- Update version of google-cloud-core ([#6858](https://github.com/googleapis/google-cloud-python/pull/6858))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+
+## 0.20.0
+
+12-05-2018 13:16 PST
+
+
+### Implementation Changes
+- Use moved iam.policy now at google.api_core.iam.policy ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Pick up fixes to GAPIC generator. ([#6577](https://github.com/googleapis/google-cloud-python/pull/6577))
+- Fix client_info bug, update docstrings and timeouts. ([#6424](https://github.com/googleapis/google-cloud-python/pull/6424))
+- Pass credentials into TraceServiceClient ([#5596](https://github.com/googleapis/google-cloud-python/pull/5596))
+- Avoid overwriting '__module__' of messages from shared modules. ([#5364](https://github.com/googleapis/google-cloud-python/pull/5364))
+
+### New Features
+- Add 'synth.py'. ([#6083](https://github.com/googleapis/google-cloud-python/pull/6083))
+
+### Dependencies
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Add static HTML redirect page for 'trace/starting.html'. ([#6142](https://github.com/googleapis/google-cloud-python/pull/6142))
+- Prep docs for repo split. ([#6024](https://github.com/googleapis/google-cloud-python/pull/6024))
+- Replace links to '/stable/' with '/latest/'. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Updates to noxfile and other templates. Start Blackening. ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792)),
+  ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701)),
+  ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698)),
+  ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666)),
+  ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add kokoro for trace, remove trace from CircleCI ([#6112](https://github.com/googleapis/google-cloud-python/pull/6112))
+- Use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Fix bad trove classifier
+- Move unit test from gax to gapic ([#4988](https://github.com/googleapis/google-cloud-python/pull/4988))
+
+## 0.19.0
+
+### Dependencies
+
+- The minimum version for `google-api-core` has been updated to version 1.0.0. This may cause some incompatibility with older google-cloud libraries, you will need to update those libraries if you have a dependency conflict. (#4944, #4946)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+
+## 0.18.0
+
+### Breaking changes
+
+- The underlying autogenerated client library was re-generated to pick up new 
+  features and resolve bugs, this may change the exceptions raised from various
+  methods. (#4799)
+
+## 0.17.0
+
+### Notable Implementation Changes
+
+- Default to use Stackdriver Trace V2 API if calling `from google.cloud import trace`.
+  Using V1 API needs to be explicitly specified in the import.(#4437)
+
+PyPI: https://pypi.org/project/google-cloud-trace/0.17.0/
+
+## 0.16.0
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-trace/0.16.0/
diff --git a/trace/LICENSE b/trace/LICENSE
new file mode 100644
index 000000000000..724a8807144b
--- /dev/null
+++ b/trace/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/trace/MANIFEST.in b/trace/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/trace/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/trace/PUBLISHING.rst b/trace/PUBLISHING.rst
new file mode 100644
index 000000000000..a6d81225248b
--- /dev/null
+++ b/trace/PUBLISHING.rst
@@ -0,0 +1,46 @@
+PUBLISHING
+----------
+
+Note: This folder has been generated by the GAPIC code generator.
+
+The instructions assumes that no changes have been made to folder and its
+contents since it was created.
+
+PREREQUISITES
+-------------
+
+- Python must installed
+- [tox](https://testrun.org/tox/latest/) must be installed
+
+
+TO PUBLISH
+----------
+
+- Make sure you have `an account`_ on pypi_.
+- Publish your package using tox.
+- *tox must be used here or the uploaded package will be invalid!!*
+
+  ::
+
+    tox -e upload-package
+
+
+TO PUBLISH THE DOCS
+-------------------
+
+- Create the docs
+
+  ::
+
+    tox -e docs
+
+- Publish them to pythonhosted.org
+
+  ::
+
+    tox -e upload-docs
+
+
+_`Packaging and Distributing projects`: https://packaging.python.org/en/latest/distributing.html#uploading-your-project-to-pypi
+_`an account`: https://pypi.python.org/pypi?%3Aaction=register_form
+_pypi: http://pypi.python.org
diff --git a/trace/README.rst b/trace/README.rst
new file mode 100644
index 000000000000..71642c975dbf
--- /dev/null
+++ b/trace/README.rst
@@ -0,0 +1,112 @@
+Python Client for Stackdriver Trace API
+=======================================
+
+|alpha| |pypi| |versions| 
+
+The `Stackdriver Trace 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.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-trace.svg
+   :target: https://pypi.org/project/google-cloud-trace/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-trace.svg
+   :target: https://pypi.org/project/google-cloud-trace/
+.. _Stackdriver Trace API: https://cloud.google.com/trace
+.. _Client Library Documentation: https://googleapis.dev/python/cloudtrace/latest
+.. _Product Documentation:  https://cloud.google.com/trace
+
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable the trace API.`_
+3. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable the trace API.:  https://cloud.google.com/trace
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing
+system install permissions, and without clashing with the installed system
+dependencies.
+
+.. _virtualenv: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-trace
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-trace
+
+For more information on setting up your Python development environment,
+such as installing ``pip`` and ``virtualenv`` on your system, please refer
+to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
+
+.. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+  from google.cloud.trace import trace_service_client
+
+  client = trace_service_client.TraceServiceClient()
+  project_id = 'your-project-123'
+
+  # Iterate over all results
+  for element in client.list_traces(project_id):
+      # process element
+      pass
+
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Stackdriver Trace API
+   to see other available methods on the client.
+-  Read the `Product documentation`_ to learn more about the product and see
+   How-to Guides.
diff --git a/trace/docs/README.rst b/trace/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/trace/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/trace/docs/changelog.md b/trace/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/trace/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/trace/docs/conf.py b/trace/docs/conf.py
new file mode 100644
index 000000000000..8c915280dd6c
--- /dev/null
+++ b/trace/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-trace documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-trace"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-trace-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-trace.tex",
+        u"google-cloud-trace Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, "google-cloud-trace", u"google-cloud-trace Documentation", [author], 1)
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-trace",
+        u"google-cloud-trace Documentation",
+        author,
+        "google-cloud-trace",
+        "GAPIC library for the {metadata.shortName} v2 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/trace/docs/gapic/v1/api.rst b/trace/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..2de320c95966
--- /dev/null
+++ b/trace/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Stackdriver Trace API
+================================
+
+.. automodule:: google.cloud.trace_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/trace/docs/gapic/v1/types.rst b/trace/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..e2c1a9b972b5
--- /dev/null
+++ b/trace/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Stackdriver Trace API Client
+======================================
+
+.. automodule:: google.cloud.trace_v1.types
+    :members:
\ No newline at end of file
diff --git a/trace/docs/gapic/v2/api.rst b/trace/docs/gapic/v2/api.rst
new file mode 100644
index 000000000000..48f0d58d6308
--- /dev/null
+++ b/trace/docs/gapic/v2/api.rst
@@ -0,0 +1,6 @@
+Client for Stackdriver Trace API
+================================
+
+.. automodule:: google.cloud.trace_v2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/trace/docs/gapic/v2/types.rst b/trace/docs/gapic/v2/types.rst
new file mode 100644
index 000000000000..071d7a5ad279
--- /dev/null
+++ b/trace/docs/gapic/v2/types.rst
@@ -0,0 +1,5 @@
+Types for Stackdriver Trace API Client
+======================================
+
+.. automodule:: google.cloud.trace_v2.types
+    :members:
\ No newline at end of file
diff --git a/trace/docs/index.rst b/trace/docs/index.rst
new file mode 100644
index 000000000000..576afb6c154e
--- /dev/null
+++ b/trace/docs/index.rst
@@ -0,0 +1,34 @@
+.. include:: README.rst
+
+
+API Reference
+-------------
+
+The current version of the API is ``v2``:
+
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v2/api
+   gapic/v2/types
+
+Support for the previous API release, ``v1``, is provided for code previously
+written against it. In order to use this release, you will want to import from
+e.g.  ``google.cloud.trace_v1`` in lieu of ``google.cloud.trace_v2``.
+
+.. toctree::
+   :maxdepth: 2
+
+   gapic/v1/api
+   gapic/v1/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-trace`` releases:
+
+.. toctree::
+   :maxdepth: 2
+
+   changelog
diff --git a/trace/docs/starting.html b/trace/docs/starting.html
new file mode 100644
index 000000000000..9b81d6976cda
--- /dev/null
+++ b/trace/docs/starting.html
@@ -0,0 +1,8 @@
+<html>
+<head>
+ <meta http-equiv="refresh" content="1; url=./index.html:" />
+ <script>
+   window.location.href = "./index.html"
+ </script>
+</head>
+</html>
diff --git a/trace/google/__init__.py b/trace/google/__init__.py
new file mode 100644
index 000000000000..5284146ebf2b
--- /dev/null
+++ b/trace/google/__init__.py
@@ -0,0 +1 @@
+__import__("pkg_resources").declare_namespace(__name__)
diff --git a/trace/google/cloud/__init__.py b/trace/google/cloud/__init__.py
new file mode 100644
index 000000000000..5284146ebf2b
--- /dev/null
+++ b/trace/google/cloud/__init__.py
@@ -0,0 +1 @@
+__import__("pkg_resources").declare_namespace(__name__)
diff --git a/trace/google/cloud/trace.py b/trace/google/cloud/trace.py
new file mode 100644
index 000000000000..376119a3034a
--- /dev/null
+++ b/trace/google/cloud/trace.py
@@ -0,0 +1,21 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+from google.cloud.trace_v2 import TraceServiceClient
+from google.cloud.trace_v2 import enums
+from google.cloud.trace_v2 import types
+
+__all__ = ("enums", "types", "TraceServiceClient")
diff --git a/trace/google/cloud/trace/__init__.py b/trace/google/cloud/trace/__init__.py
new file mode 100644
index 000000000000..697ae1671777
--- /dev/null
+++ b/trace/google/cloud/trace/__init__.py
@@ -0,0 +1,34 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-trace").version
+
+from google.cloud.trace.client import Client
+from google.cloud.trace_v2 import types
+from google.cloud.trace_v2.gapic import enums
+from google.cloud.trace_v2.gapic import trace_service_client
+
+
+class TraceServiceClient(trace_service_client.TraceServiceClient):
+    __doc__ = trace_service_client.TraceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("__version__", "enums", "types", "TraceServiceClient", "Client", "SCOPE")
+
+SCOPE = Client.SCOPE
diff --git a/trace/google/cloud/trace/_gapic.py b/trace/google/cloud/trace/_gapic.py
new file mode 100644
index 000000000000..435d9fcc6c17
--- /dev/null
+++ b/trace/google/cloud/trace/_gapic.py
@@ -0,0 +1,319 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrapper for interacting with the Stackdriver Trace API."""
+
+from google.api_core.gapic_v1 import method
+from google.cloud._helpers import _datetime_to_pb_timestamp
+from google.cloud.trace_v2.gapic import trace_service_client
+from google.cloud.trace_v2.proto import trace_pb2
+from google.protobuf.json_format import ParseDict
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+
+
+class _TraceAPI(object):
+    """
+    Wrapper to help mapping trace-related APIs.
+
+    See
+    https://cloud.google.com/trace/docs/reference/v2/rpc/google.devtools.
+    cloudtrace.v2
+
+    Args:
+        gapic (~google.cloud.trace_v2.gapic.trace_service_client.
+            TraceServiceClient): Required. API object used to make RPCs.
+
+        client (~google.cloud.trace_v2.client.Client): Required. The
+            client that owns this API object.
+    """
+
+    def __init__(self, gapic_api, client):
+        self._gapic_api = gapic_api
+        self.client = client
+
+    def batch_write_spans(
+        self, name, spans, retry=method.DEFAULT, timeout=method.DEFAULT
+    ):
+        """
+        Sends new spans to Stackdriver Trace or updates existing traces. If the
+        name of a trace that you send matches that of an existing trace, new
+        spans are added to the existing trace. Attempt to update existing spans
+        results undefined behavior. If the name does not match, a new trace is
+        created with given set of spans.
+
+        Args:
+            name (str): Required. Name of the project where the spans belong.
+                The format is ``projects/PROJECT_ID``.
+            spans (list[Union[dict, ~google.cloud.trace_v2.types.Span]]): A
+                collection of spans. If a dict is provided, it must be of the
+                same form as the protobuf message
+                :class:`~google.cloud.trace_v2.types.Span`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        spans_pb_list = []
+
+        for span_mapping in spans["spans"]:
+            span_pb = _dict_mapping_to_pb(span_mapping, "Span")
+            spans_pb_list.append(span_pb)
+
+        self._gapic_api.batch_write_spans(
+            name=name, spans=spans_pb_list, retry=retry, timeout=timeout
+        )
+
+    def create_span(
+        self,
+        name,
+        span_id,
+        display_name,
+        start_time,
+        end_time,
+        parent_span_id=None,
+        attributes=None,
+        stack_trace=None,
+        time_events=None,
+        links=None,
+        status=None,
+        same_process_as_parent_span=None,
+        child_span_count=None,
+        retry=method.DEFAULT,
+        timeout=method.DEFAULT,
+    ):
+        """
+        Creates a new Span.
+
+        Example:
+            >>> from google.cloud import trace_v2
+            >>>
+            >>> client = trace_v2.TraceServiceClient()
+            >>>
+            >>> name = client.span_path('[PROJECT]', '[TRACE]', '[SPAN]')
+            >>> span_id = ''
+            >>> display_name = {}
+            >>> start_time = {}
+            >>> end_time = {}
+            >>>
+            >>> response = client.create_span(name, span_id, display_name,
+                                              start_time, end_time)
+
+        Args:
+            name (str): The resource name of the span in the following format:
+
+                ::
+
+                    projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+
+                [TRACE_ID] is a unique identifier for a trace within a project.
+                [SPAN_ID] is a unique identifier for a span within a trace,
+                assigned when the span is created.
+            span_id (str): The [SPAN_ID] portion of the span's resource name.
+                The ID is a 16-character hexadecimal encoding of an 8-byte
+                array.
+            display_name (dict): A description of the span's operation
+                (up to 128 bytes). Stackdriver Trace displays the description
+                in the {% dynamic print site_values.console_name %}.
+                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.
+                Contains two fields, value is the truncated name,
+                truncatedByteCount is the number of bytes removed from the
+                original string. If 0, then the string was not shortened.
+            start_time (:class:`~datetime.datetime`):
+                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.
+            end_time (:class:`~datetime.datetime`):
+                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.
+            parent_span_id (str): The [SPAN_ID] of this span's parent span.
+                If this is a root span, then this field must be empty.
+            attributes (dict): A set of attributes on the span. There is a
+                limit of 32 attributes per span.
+            stack_trace (dict):
+                Stack trace captured at the start of the span.
+                Contains two fields, stackFrames is a list of stack frames in
+                this call stack, a maximum of 128 frames are allowed per
+                StackFrame; stackTraceHashId is used to conserve network
+                bandwidth for duplicate stack traces within a single trace.
+            time_events (dict):
+                The included time events. There can be up to 32 annotations
+                and 128 message events per span.
+            links (dict): A maximum of 128 links are allowed per Span.
+            status (dict): An optional final status for this span.
+            same_process_as_parent_span (bool): A highly recommended but not
+                required flag that identifies when a trace crosses a process
+                boundary. True when the parent_span belongs to the same process
+                as the current span.
+            child_span_count (int): An optional number of child spans that were
+                generated while this span was active. If set, allows
+                implementation to detect missing child spans.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+
+        Returns:
+            A :class:`~google.cloud.trace_v2.types.Span` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Convert the dict type parameters to protobuf
+        display_name = _dict_mapping_to_pb(display_name, "TruncatableString")
+        start_time = _datetime_to_pb_timestamp(start_time)
+        end_time = _datetime_to_pb_timestamp(end_time)
+
+        if attributes is not None:
+            attributes = _span_attrs_to_pb(attributes, "Attributes")
+
+        if stack_trace is not None:
+            stack_trace = _dict_mapping_to_pb(stack_trace, "StackTrace")
+
+        if time_events is not None:
+            time_events = _span_attrs_to_pb(time_events, "TimeEvents")
+
+        if links is not None:
+            links = _span_attrs_to_pb(links, "Links")
+
+        if status is not None:
+            status = _status_mapping_to_pb(status)
+
+        if same_process_as_parent_span is not None:
+            same_process_as_parent_span = _value_to_pb(
+                same_process_as_parent_span, "BoolValue"
+            )
+
+        if child_span_count is not None:
+            child_span_count = _value_to_pb(child_span_count, "Int32Value")
+
+        return self._gapic_api.create_span(
+            name=name,
+            span_id=span_id,
+            display_name=display_name,
+            start_time=start_time,
+            end_time=end_time,
+            parent_span_id=parent_span_id,
+            attributes=attributes,
+            stack_trace=stack_trace,
+            time_events=time_events,
+            links=links,
+            status=status,
+            same_process_as_parent_span=same_process_as_parent_span,
+            child_span_count=child_span_count,
+        )
+
+
+def _dict_mapping_to_pb(mapping, proto_type):
+    """
+    Convert a dict to protobuf.
+
+    Args:
+        mapping (dict): A dict that needs to be converted to protobuf.
+        proto_type (str): The type of the Protobuf.
+
+    Returns:
+        An instance of the specified protobuf.
+    """
+    converted_pb = getattr(trace_pb2, proto_type)()
+    ParseDict(mapping, converted_pb)
+    return converted_pb
+
+
+def _span_attrs_to_pb(span_attr, proto_type):
+    """
+    Convert a span attribute dict to protobuf, including Links, Attributes,
+    TimeEvents.
+
+    Args:
+        span_attr (dict): A dict that needs to be converted to protobuf.
+        proto_type (str): The type of the Protobuf.
+
+    Returns:
+        An instance of the specified protobuf.
+    """
+    attr_pb = getattr(trace_pb2.Span, proto_type)()
+    ParseDict(span_attr, attr_pb)
+    return attr_pb
+
+
+def _status_mapping_to_pb(status):
+    """
+    Convert a status dict to protobuf.
+
+    Args:
+        status (dict): A status that needs to be converted to protobuf.
+
+    Returns:
+        An instance of the specified protobuf.
+    """
+    status_pb = google_dot_rpc_dot_status__pb2.Status()
+    ParseDict(status, status_pb)
+    return status_pb
+
+
+def _value_to_pb(value, proto_type):
+    """
+    Convert a value to protobuf. e.g. BoolValue, Int32Value.
+
+    Args:
+        value (dict): A dict that needs to be converted to protobuf.
+        proto_type (str): The type of the Protobuf.
+
+    Returns:
+        An instance of the specified protobuf.
+    """
+    data_type_pb = getattr(google_dot_protobuf_dot_wrappers__pb2, proto_type)()
+    ParseDict(value, data_type_pb)
+    return data_type_pb
+
+
+def make_trace_api(client):
+    """
+    Create an instance of the gapic Trace API.
+
+    Args:
+        client (:class:`~google.cloud.trace_v2.client.Client`): The client
+            that holds configuration details.
+
+    Returns:
+        A :class:`~google.cloud.trace_v2._gapic._TraceAPI` instance with the
+        proper configurations.
+    """
+    generated = trace_service_client.TraceServiceClient(
+        credentials=client._credentials, client_info=client._client_info
+    )
+    return _TraceAPI(generated, client)
diff --git a/trace/google/cloud/trace/client.py b/trace/google/cloud/trace/client.py
new file mode 100644
index 000000000000..c4c9d5dd6840
--- /dev/null
+++ b/trace/google/cloud/trace/client.py
@@ -0,0 +1,237 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Stackdriver Trace API."""
+
+from google.api_core.gapic_v1 import client_info
+from google.cloud.client import ClientWithProject
+from google.cloud.trace import __version__
+from google.cloud.trace._gapic import make_trace_api
+
+
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+
+
+class Client(ClientWithProject):
+    """
+    Client to bundle configuration needed for API requests.
+
+    Args:
+        project (str): The project which the client acts on behalf of.
+            If not passed, falls back to the default inferred from
+            the environment.
+        credentials (Optional[:class:`~google.auth.credentials.Credentials`]):
+            The OAuth2 Credentials to use for this client. If not passed,
+            falls back to the default inferred from the environment.
+        client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+            The client info used to send a user-agent string along with API
+            requests. If ``None``, then default info will be used. Generally,
+            you only need to set this if you're developing your own library
+            or partner tool.
+    """
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/trace.append",
+    )
+    """The scopes required for authenticating as a Trace consumer."""
+
+    _trace_api = None
+
+    def __init__(self, project=None, credentials=None, client_info=_CLIENT_INFO):
+        super(Client, self).__init__(project=project, credentials=credentials)
+        self._client_info = client_info
+
+    @property
+    def trace_api(self):
+        """
+        Helper for trace-related API calls.
+
+        See
+        https://cloud.google.com/trace/docs/reference/v2/rpc/google.devtools.
+        cloudtrace.v2
+        """
+        if self._trace_api is None:
+            self._trace_api = make_trace_api(self)
+        return self._trace_api
+
+    def batch_write_spans(self, name, spans, retry=None, timeout=None):
+        """
+        Sends new spans to Stackdriver Trace or updates existing traces. If the
+        name of a trace that you send matches that of an existing trace, new
+        spans are added to the existing trace. Attempt to update existing spans
+        results undefined behavior. If the name does not match, a new trace is
+        created with given set of spans.
+
+        Example:
+            >>> from google.cloud import trace_v2
+            >>>
+            >>> client = trace_v2.Client()
+            >>>
+            >>> name = 'projects/[PROJECT_ID]'
+            >>> spans = {'spans': [{'endTime': '2017-11-21T23:50:58.890768Z',
+                                    'spanId': [SPAN_ID],
+                                    'startTime': '2017-11-21T23:50:58.890763Z',
+                                    'name': 'projects/[PROJECT_ID]/traces/
+                                            [TRACE_ID]/spans/[SPAN_ID]',
+                                    'displayName': {'value': 'sample span'}}]}
+            >>>
+            >>> client.batch_write_spans(name, spans)
+
+        Args:
+            name (str): Optional. Name of the project where the spans belong.
+                The format is ``projects/PROJECT_ID``.
+            spans (dict): A collection of spans.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        self.trace_api.batch_write_spans(
+            name=name, spans=spans, retry=retry, timeout=timeout
+        )
+
+    def create_span(
+        self,
+        name,
+        span_id,
+        display_name,
+        start_time,
+        end_time,
+        parent_span_id=None,
+        attributes=None,
+        stack_trace=None,
+        time_events=None,
+        links=None,
+        status=None,
+        same_process_as_parent_span=None,
+        child_span_count=None,
+        retry=None,
+        timeout=None,
+    ):
+        """
+        Creates a new Span.
+
+        Example:
+            >>> from google.cloud import trace_v2
+            >>>
+            >>> client = trace_v2.Client()
+            >>>
+            >>> name = 'projects/{project}/traces/{trace_id}/spans/{span_id}'.
+                       format('[PROJECT]', '[TRACE_ID]', '[SPAN_ID]')
+            >>> span_id = '[SPAN_ID]'
+            >>> display_name = {}
+            >>> start_time = {}
+            >>> end_time = {}
+            >>>
+            >>> response = client.create_span(name, span_id, display_name,
+                                              start_time, end_time)
+
+        Args:
+            name (str): The resource name of the span in the following format:
+
+                ::
+
+                    projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+
+                [TRACE_ID] is a unique identifier for a trace within a project.
+                [SPAN_ID] is a unique identifier for a span within a trace,
+                assigned when the span is created.
+            span_id (str): The [SPAN_ID] portion of the span's resource name.
+                The ID is a 16-character hexadecimal encoding of an 8-byte
+                array.
+            display_name (dict): A description of the span's operation
+                (up to 128 bytes). Stackdriver Trace displays the description
+                in the {% dynamic print site_values.console_name %}.
+                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.
+                Contains two fields, value is the truncated name,
+                truncatedByteCount is the number of bytes removed from the
+                original string. If 0, then the string was not shortened.
+            start_time (:class:`~datetime.datetime`):
+                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.
+            end_time (:class:`~datetime.datetime`):
+                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.
+            parent_span_id (str): The [SPAN_ID] of this span's parent span.
+                If this is a root span, then this field must be empty.
+            attributes (dict): A set of attributes on the span. There is a
+                limit of 32 attributes per span.
+            stack_trace (dict):
+                Stack trace captured at the start of the span.
+                Contains two fields, stackFrames is a list of stack frames in
+                this call stack, a maximum of 128 frames are allowed per
+                StackFrame; stackTraceHashId is used to conserve network
+                bandwidth for duplicate stack traces within a single trace.
+            time_events (dict):
+                The included time events. There can be up to 32 annotations
+                and 128 message events per span.
+            links (dict): A maximum of 128 links are allowed per Span.
+            status (dict): An optional final status for this span.
+            same_process_as_parent_span (bool): A highly recommended but not
+                required flag that identifies when a trace crosses a process
+                boundary. True when the parent_span belongs to the same process
+                as the current span.
+            child_span_count (int): An optional number of child spans that were
+                generated while this span was active. If set, allows
+                implementation to detect missing child spans.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+
+        Returns:
+            A :class:`~google.cloud.trace_v2.types.Span` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        return self.trace_api.create_span(
+            name=name,
+            span_id=span_id,
+            display_name=display_name,
+            start_time=start_time,
+            end_time=end_time,
+            parent_span_id=parent_span_id,
+            attributes=attributes,
+            stack_trace=stack_trace,
+            time_events=time_events,
+            links=links,
+            status=status,
+            same_process_as_parent_span=same_process_as_parent_span,
+            child_span_count=child_span_count,
+        )
diff --git a/trace/google/cloud/trace/v1/__init__.py b/trace/google/cloud/trace/v1/__init__.py
new file mode 100644
index 000000000000..4c6bd18dd38a
--- /dev/null
+++ b/trace/google/cloud/trace/v1/__init__.py
@@ -0,0 +1,21 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.cloud.trace.v1.client import Client
+
+
+__all__ = ["Client", "SCOPE"]
+
+
+SCOPE = Client.SCOPE
diff --git a/trace/google/cloud/trace/v1/_gapic.py b/trace/google/cloud/trace/v1/_gapic.py
new file mode 100644
index 000000000000..365f535eba5c
--- /dev/null
+++ b/trace/google/cloud/trace/v1/_gapic.py
@@ -0,0 +1,198 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrapper for interacting with the Stackdriver Trace API."""
+
+from google.api_core.gapic_v1 import client_info
+from google.cloud.trace import __version__
+from google.cloud.trace_v1.gapic import trace_service_client
+from google.cloud.trace_v1.proto import trace_pb2
+from google.protobuf.json_format import MessageToDict
+from google.protobuf.json_format import ParseDict
+
+
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+
+
+class _TraceAPI(object):
+    """
+    Wrapper to help mapping trace-related APIs.
+
+    See
+    https://cloud.google.com/trace/docs/reference/v1/rpc/google.devtools.
+    cloudtrace.v1
+
+    Args:
+        gapic_api (~google.cloud.trace_v1.gapic.trace_service_client.
+            TraceServiceClient): Required. API object used to make RPCs.
+        client (~google.cloud.trace.client.Client): The client that owns this
+            API object.
+    """
+
+    def __init__(self, gapic_api, client):
+        self._gapic_api = gapic_api
+        self.client = client
+
+    def patch_traces(self, project_id, traces):
+        """
+        Sends new traces to Stackdriver Trace or updates existing traces.
+
+        Args:
+            project_id (Optional[str]): ID of the Cloud project where the trace
+                data is stored.
+            traces (dict): Required. The traces to be patched in the API call.
+        """
+        traces_pb = _traces_mapping_to_pb(traces)
+        self._gapic_api.patch_traces(project_id, traces_pb)
+
+    def get_trace(self, project_id, trace_id):
+        """
+        Gets a single trace by its ID.
+
+        Args:
+            trace_id (str): ID of the trace to return.
+            project_id (str): Required. ID of the Cloud project where the trace
+                data is stored.
+
+        Returns:
+            A Trace dict.
+        """
+        trace_pb = self._gapic_api.get_trace(project_id, trace_id)
+        trace_mapping = _parse_trace_pb(trace_pb)
+        return trace_mapping
+
+    def list_traces(
+        self,
+        project_id,
+        view=None,
+        page_size=None,
+        start_time=None,
+        end_time=None,
+        filter_=None,
+        order_by=None,
+        page_token=None,
+    ):
+        """
+        Returns of a list of traces that match the filter conditions.
+
+        Args:
+            project_id (Optional[str]): ID of the Cloud project where the trace
+                data is stored.
+
+            view (Optional[~google.cloud.trace_v1.gapic.enums.
+                ListTracesRequest.ViewType]): Type of data returned for traces
+                in the list. Default is ``MINIMAL``.
+
+            page_size (Optional[int]): 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.
+
+            start_time (Optional[~datetime.datetime]): Start of the time
+                interval (inclusive) during which the trace data was collected
+                from the application.
+
+            end_time (Optional[~datetime.datetime]): End of the time interval
+                (inclusive) during which the trace data was collected from the
+                application.
+
+            filter_ (Optional[str]): An optional filter for the request.
+
+            order_by (Optional[str]): Field used to sort the returned traces.
+
+            page_token (Optional[str]): opaque marker for the next "page" of
+                entries. If not passed, the API will return the first page of
+                entries.
+
+        Returns:
+            A  :class:`~google.api_core.page_iterator.Iterator` of traces that
+            match the specified filter conditions.
+        """
+        page_iter = self._gapic_api.list_traces(
+            project_id=project_id,
+            view=view,
+            page_size=page_size,
+            start_time=start_time,
+            end_time=end_time,
+            filter_=filter_,
+            order_by=order_by,
+        )
+        page_iter.item_to_value = _item_to_mapping
+        page_iter.next_page_token = page_token
+        return page_iter
+
+
+def _parse_trace_pb(trace_pb):
+    """
+    Parse a ``Trace`` protobuf to a dictionary.
+
+    Args:
+        trace_pb (~google.cloud.trace_v1.proto.trace_pb2.Trace): A trace
+            protobuf instance.
+
+    Returns:
+        The converted trace dict.
+    """
+    try:
+        return MessageToDict(trace_pb)
+    except TypeError:
+        raise
+
+
+def _item_to_mapping(iterator, trace_pb):
+    """
+    Helper callable function for the page iterator
+
+    Args:
+        iterator(~google.api_core.page_iterator.Iterator): The iterator that is
+            currently in use.
+
+        trace_pb(~google.cloud.trace_v1.proto.trace_pb2.Trace): A trace
+            protobuf instance.
+    """
+    mapping = _parse_trace_pb(trace_pb)
+    return mapping
+
+
+def make_trace_api(client):
+    """
+    Create an instance of the gapic Trace API.
+
+    Args:
+        client (~google.cloud.trace.client.Client): The client that holds
+            configuration details.
+
+    Returns:
+        A :class:`~google.cloud.trace._gapic._TraceAPI` instance with the
+        proper configurations.
+    """
+    generated = trace_service_client.TraceServiceClient(
+        credentials=client._credentials, client_info=client._client_info
+    )
+    return _TraceAPI(generated, client)
+
+
+def _traces_mapping_to_pb(traces_mapping):
+    """
+    Convert a trace dict to protobuf.
+
+    Args:
+        traces_mapping (dict): A trace mapping.
+
+    Returns:
+        The converted protobuf type traces.
+    """
+    traces_pb = trace_pb2.Traces()
+    ParseDict(traces_mapping, traces_pb)
+    return traces_pb
diff --git a/trace/google/cloud/trace/v1/client.py b/trace/google/cloud/trace/v1/client.py
new file mode 100644
index 000000000000..266158933294
--- /dev/null
+++ b/trace/google/cloud/trace/v1/client.py
@@ -0,0 +1,167 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Stackdriver Trace API."""
+
+from google.api_core.gapic_v1 import client_info
+from google.cloud._helpers import _datetime_to_pb_timestamp
+from google.cloud.client import ClientWithProject
+from google.cloud.trace import __version__
+from google.cloud.trace.v1._gapic import make_trace_api
+
+
+_CLIENT_INFO = client_info.ClientInfo(client_library_version=__version__)
+
+
+class Client(ClientWithProject):
+    """
+    Client to bundle configuration needed for API requests.
+
+    Args:
+        project (str): Required. The project which the client acts on behalf
+            of. If not passed, falls back to the default inferred
+            from the environment.
+        credentials (Optional[~google.auth.credentials.Credentials]):
+            The OAuth2 Credentials to use for this client. If not
+            passed, falls back to the default inferred from the
+            environment.
+        client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+            The client info used to send a user-agent string along with API
+            requests. If ``None``, then default info will be used. Generally,
+            you only need to set this if you're developing your own library
+            or partner tool.
+    """
+
+    SCOPE = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/trace.append",
+    )
+    """The scopes required for authenticating as a Trace consumer."""
+
+    _trace_api = None
+
+    def __init__(self, project=None, credentials=None, client_info=_CLIENT_INFO):
+        super(Client, self).__init__(project=project, credentials=credentials)
+        self._client_info = client_info
+
+    @property
+    def trace_api(self):
+        """Helper for trace-related API calls.
+
+        See
+        https://cloud.google.com/trace/docs/reference/v1/rpc/google.devtools.
+        cloudtrace.v1
+        """
+        if self._trace_api is None:
+            self._trace_api = make_trace_api(self)
+        return self._trace_api
+
+    def patch_traces(self, traces, project_id=None):
+        """Sends new traces to Stackdriver Trace or updates existing traces.
+
+        Args:
+            traces (dict): Required. The traces to be patched in the API call.
+
+            project_id (Optional[str]): ID of the Cloud project where the trace
+                data is stored.
+        """
+        if project_id is None:
+            project_id = self.project
+
+        self.trace_api.patch_traces(project_id=project_id, traces=traces)
+
+    def get_trace(self, trace_id, project_id=None):
+        """
+        Gets a single trace by its ID.
+
+        Args:
+            trace_id (str): ID of the trace to return.
+
+            project_id (str): Required. ID of the Cloud project where the trace
+                data is stored.
+
+        Returns:
+            A Trace dict.
+        """
+        if project_id is None:
+            project_id = self.project
+
+        return self.trace_api.get_trace(project_id=project_id, trace_id=trace_id)
+
+    def list_traces(
+        self,
+        project_id=None,
+        view=None,
+        page_size=None,
+        start_time=None,
+        end_time=None,
+        filter_=None,
+        order_by=None,
+        page_token=None,
+    ):
+        """
+        Returns of a list of traces that match the filter conditions.
+
+        Args:
+            project_id (Optional[str]): ID of the Cloud project where the trace
+                data is stored.
+
+            view (Optional[~google.cloud.trace_v1.gapic.enums.
+                ListTracesRequest.ViewType]): Type of data returned for traces
+                in the list. Default is ``MINIMAL``.
+
+            page_size (Optional[int]): 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.
+
+            start_time (Optional[~datetime.datetime]): Start of the time
+                interval (inclusive) during which the trace data was collected
+                from the application.
+
+            end_time (Optional[~datetime.datetime]): End of the time interval
+                (inclusive) during which the trace data was collected from the
+                application.
+
+            filter_ (Optional[str]): An optional filter for the request.
+
+            order_by (Optional[str]): Field used to sort the returned traces.
+
+            page_token (Optional[str]): opaque marker for the next "page" of
+                entries. If not passed, the API will return the first page of
+                entries.
+
+        Returns:
+            A  :class:`~google.api_core.page_iterator.Iterator` of traces that
+            match the specified filter conditions.
+        """
+        if project_id is None:
+            project_id = self.project
+
+        if start_time is not None:
+            start_time = _datetime_to_pb_timestamp(start_time)
+
+        if end_time is not None:
+            end_time = _datetime_to_pb_timestamp(end_time)
+
+        return self.trace_api.list_traces(
+            project_id=project_id,
+            view=view,
+            page_size=page_size,
+            start_time=start_time,
+            end_time=end_time,
+            filter_=filter_,
+            order_by=order_by,
+            page_token=page_token,
+        )
diff --git a/trace/google/cloud/trace_v1/__init__.py b/trace/google/cloud/trace_v1/__init__.py
new file mode 100644
index 000000000000..ce7863f3616b
--- /dev/null
+++ b/trace/google/cloud/trace_v1/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.trace_v1 import types
+from google.cloud.trace_v1.gapic import enums
+from google.cloud.trace_v1.gapic import trace_service_client
+
+
+class TraceServiceClient(trace_service_client.TraceServiceClient):
+    __doc__ = trace_service_client.TraceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "TraceServiceClient")
diff --git a/trace/google/cloud/trace_v1/gapic/__init__.py b/trace/google/cloud/trace_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/trace/google/cloud/trace_v1/gapic/enums.py b/trace/google/cloud/trace_v1/gapic/enums.py
new file mode 100644
index 000000000000..b5d2728f8869
--- /dev/null
+++ b/trace/google/cloud/trace_v1/gapic/enums.py
@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ListTracesRequest(object):
+    class ViewType(enum.IntEnum):
+        """
+        Type of data returned for traces in the list.
+
+        Attributes:
+          VIEW_TYPE_UNSPECIFIED (int): Default is ``MINIMAL`` if unspecified.
+          MINIMAL (int): Minimal view of the trace record that contains only the project
+          and trace IDs.
+          ROOTSPAN (int): Root span view of the trace record that returns the root spans along
+          with the minimal trace data.
+          COMPLETE (int): Complete view of the trace record that contains the actual trace data.
+          This is equivalent to calling the REST ``get`` or RPC ``GetTrace``
+          method using the ID of each listed trace.
+        """
+
+        VIEW_TYPE_UNSPECIFIED = 0
+        MINIMAL = 1
+        ROOTSPAN = 2
+        COMPLETE = 3
+
+
+class TraceSpan(object):
+    class SpanKind(enum.IntEnum):
+        """
+        Type of span. Can be used to specify additional relationships between spans
+        in addition to a parent/child relationship.
+
+        Attributes:
+          SPAN_KIND_UNSPECIFIED (int): Unspecified.
+          RPC_SERVER (int): Indicates that the span covers server-side handling of an RPC or other
+          remote network request.
+          RPC_CLIENT (int): Indicates that the span covers the client-side wrapper around an RPC or
+          other remote request.
+        """
+
+        SPAN_KIND_UNSPECIFIED = 0
+        RPC_SERVER = 1
+        RPC_CLIENT = 2
diff --git a/trace/google/cloud/trace_v1/gapic/trace_service_client.py b/trace/google/cloud/trace_v1/gapic/trace_service_client.py
new file mode 100644
index 000000000000..0e27928d6899
--- /dev/null
+++ b/trace/google/cloud/trace_v1/gapic/trace_service_client.py
@@ -0,0 +1,503 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.devtools.cloudtrace.v1 TraceService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import grpc
+
+from google.cloud.trace_v1.gapic import enums
+from google.cloud.trace_v1.gapic import trace_service_client_config
+from google.cloud.trace_v1.gapic.transports import trace_service_grpc_transport
+from google.cloud.trace_v1.proto import trace_pb2
+from google.cloud.trace_v1.proto import trace_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-trace").version
+
+
+class TraceServiceClient(object):
+    """
+    This file describes an API for collecting and viewing traces and spans
+    within a trace.  A Trace is a collection of spans corresponding to a single
+    operation or set of operations for an application. A span is an individual
+    timed event which forms a node of the trace tree. Spans for a single trace
+    may span multiple services.
+    """
+
+    SERVICE_ADDRESS = "cloudtrace.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.devtools.cloudtrace.v1.TraceService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            TraceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.TraceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.TraceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = trace_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=trace_service_grpc_transport.TraceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = trace_service_grpc_transport.TraceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def patch_traces(
+        self,
+        project_id,
+        traces,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sends new traces to Stackdriver Trace or updates existing traces. If the ID
+        of a trace that you send matches that of an existing trace, any fields
+        in the existing trace and its spans are overwritten by the provided values,
+        and any new fields provided are merged with the existing trace data. If the
+        ID does not match, a new trace is created.
+
+        Example:
+            >>> from google.cloud import trace_v1
+            >>>
+            >>> client = trace_v1.TraceServiceClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `traces`:
+            >>> traces = {}
+            >>>
+            >>> client.patch_traces(project_id, traces)
+
+        Args:
+            project_id (str): ID of the Cloud project where the trace data is stored.
+            traces (Union[dict, ~google.cloud.trace_v1.types.Traces]): The body of the message.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v1.types.Traces`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "patch_traces" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "patch_traces"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.patch_traces,
+                default_retry=self._method_configs["PatchTraces"].retry,
+                default_timeout=self._method_configs["PatchTraces"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = trace_pb2.PatchTracesRequest(project_id=project_id, traces=traces)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["patch_traces"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_trace(
+        self,
+        project_id,
+        trace_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a single trace by its ID.
+
+        Example:
+            >>> from google.cloud import trace_v1
+            >>>
+            >>> client = trace_v1.TraceServiceClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # TODO: Initialize `trace_id`:
+            >>> trace_id = ''
+            >>>
+            >>> response = client.get_trace(project_id, trace_id)
+
+        Args:
+            project_id (str): ID of the Cloud project where the trace data is stored.
+            trace_id (str): ID of the trace to return.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.trace_v1.types.Trace` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_trace" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_trace"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_trace,
+                default_retry=self._method_configs["GetTrace"].retry,
+                default_timeout=self._method_configs["GetTrace"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = trace_pb2.GetTraceRequest(project_id=project_id, trace_id=trace_id)
+        return self._inner_api_calls["get_trace"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_traces(
+        self,
+        project_id,
+        view=None,
+        page_size=None,
+        start_time=None,
+        end_time=None,
+        filter_=None,
+        order_by=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns of a list of traces that match the specified filter conditions.
+
+        Example:
+            >>> from google.cloud import trace_v1
+            >>>
+            >>> client = trace_v1.TraceServiceClient()
+            >>>
+            >>> # TODO: Initialize `project_id`:
+            >>> project_id = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_traces(project_id):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_traces(project_id).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            project_id (str): ID of the Cloud project where the trace data is stored.
+            view (~google.cloud.trace_v1.types.ViewType): Type of data returned for traces in the list. Optional. Default is
+                ``MINIMAL``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            start_time (Union[dict, ~google.cloud.trace_v1.types.Timestamp]): Start of the time interval (inclusive) during which the trace data was
+                collected from the application.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v1.types.Timestamp`
+            end_time (Union[dict, ~google.cloud.trace_v1.types.Timestamp]): End of the time interval (inclusive) during which the trace data was
+                collected from the application.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v1.types.Timestamp`
+            filter_ (str): An optional filter against labels for the request.
+
+                By default, searches use prefix matching. To specify exact match,
+                prepend a plus symbol (``+``) to the search term. Multiple terms are
+                ANDed. Syntax:
+
+                -  ``root:NAME_PREFIX`` or ``NAME_PREFIX``: Return traces where any root
+                   span starts with ``NAME_PREFIX``.
+                -  ``+root:NAME`` or ``+NAME``: Return traces where any root span's name
+                   is exactly ``NAME``.
+                -  ``span:NAME_PREFIX``: Return traces where any span starts with
+                   ``NAME_PREFIX``.
+                -  ``+span:NAME``: Return traces where any span's name is exactly
+                   ``NAME``.
+                -  ``latency:DURATION``: Return traces whose overall latency is greater
+                   or equal to than ``DURATION``. Accepted units are nanoseconds
+                   (``ns``), milliseconds (``ms``), and seconds (``s``). Default is
+                   ``ms``. For example, ``latency:24ms`` returns traces whose overall
+                   latency is greater than or equal to 24 milliseconds.
+                -  ``label:LABEL_KEY``: Return all traces containing the specified label
+                   key (exact match, case-sensitive) regardless of the key:value pair's
+                   value (including empty values).
+                -  ``LABEL_KEY:VALUE_PREFIX``: Return all traces containing the
+                   specified label key (exact match, case-sensitive) whose value starts
+                   with ``VALUE_PREFIX``. Both a key and a value must be specified.
+                -  ``+LABEL_KEY:VALUE``: Return all traces containing a key:value pair
+                   exactly matching the specified text. Both a key and a value must be
+                   specified.
+                -  ``method:VALUE``: Equivalent to ``/http/method:VALUE``.
+                -  ``url:VALUE``: Equivalent to ``/http/url:VALUE``.
+            order_by (str): Field used to sort the returned traces. Optional. Can be one of the
+                following:
+
+                -  ``trace_id``
+                -  ``name`` (``name`` field of root span in the trace)
+                -  ``duration`` (difference between ``end_time`` and ``start_time``
+                   fields of the root span)
+                -  ``start`` (``start_time`` field of the root span)
+
+                Descending order can be specified by appending ``desc`` to the sort
+                field (for example, ``name desc``).
+
+                Only one sort field is permitted.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.trace_v1.types.Trace` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_traces" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_traces"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_traces,
+                default_retry=self._method_configs["ListTraces"].retry,
+                default_timeout=self._method_configs["ListTraces"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = trace_pb2.ListTracesRequest(
+            project_id=project_id,
+            view=view,
+            page_size=page_size,
+            start_time=start_time,
+            end_time=end_time,
+            filter=filter_,
+            order_by=order_by,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("project_id", project_id)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_traces"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="traces",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
diff --git a/trace/google/cloud/trace_v1/gapic/trace_service_client_config.py b/trace/google/cloud/trace_v1/gapic/trace_service_client_config.py
new file mode 100644
index 000000000000..5982fcd7cbe8
--- /dev/null
+++ b/trace/google/cloud/trace_v1/gapic/trace_service_client_config.py
@@ -0,0 +1,38 @@
+config = {
+    "interfaces": {
+        "google.devtools.cloudtrace.v1.TraceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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": {
+                "PatchTraces": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetTrace": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListTraces": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/trace/google/cloud/trace_v1/gapic/transports/__init__.py b/trace/google/cloud/trace_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/trace/google/cloud/trace_v1/gapic/transports/trace_service_grpc_transport.py b/trace/google/cloud/trace_v1/gapic/transports/trace_service_grpc_transport.py
new file mode 100644
index 000000000000..ee3e1908808b
--- /dev/null
+++ b/trace/google/cloud/trace_v1/gapic/transports/trace_service_grpc_transport.py
@@ -0,0 +1,153 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.trace_v1.proto import trace_pb2_grpc
+
+
+class TraceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.devtools.cloudtrace.v1 TraceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/trace.append",
+        "https://www.googleapis.com/auth/trace.readonly",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudtrace.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"trace_service_stub": trace_pb2_grpc.TraceServiceStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudtrace.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def patch_traces(self):
+        """Return the gRPC stub for :meth:`TraceServiceClient.patch_traces`.
+
+        Sends new traces to Stackdriver Trace or updates existing traces. If the ID
+        of a trace that you send matches that of an existing trace, any fields
+        in the existing trace and its spans are overwritten by the provided values,
+        and any new fields provided are merged with the existing trace data. If the
+        ID does not match, a new trace is created.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["trace_service_stub"].PatchTraces
+
+    @property
+    def get_trace(self):
+        """Return the gRPC stub for :meth:`TraceServiceClient.get_trace`.
+
+        Gets a single trace by its ID.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["trace_service_stub"].GetTrace
+
+    @property
+    def list_traces(self):
+        """Return the gRPC stub for :meth:`TraceServiceClient.list_traces`.
+
+        Returns of a list of traces that match the specified filter conditions.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["trace_service_stub"].ListTraces
diff --git a/trace/google/cloud/trace_v1/proto/__init__.py b/trace/google/cloud/trace_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/trace/google/cloud/trace_v1/proto/trace.proto b/trace/google/cloud/trace_v1/proto/trace.proto
new file mode 100644
index 000000000000..16af3a6ecb6e
--- /dev/null
+++ b/trace/google/cloud/trace_v1/proto/trace.proto
@@ -0,0 +1,291 @@
+// 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.cloudtrace.v1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Trace.V1";
+option go_package = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v1;cloudtrace";
+option java_multiple_files = true;
+option java_outer_classname = "TraceProto";
+option java_package = "com.google.devtools.cloudtrace.v1";
+option php_namespace = "Google\\Cloud\\Trace\\V1";
+
+// This file describes an API for collecting and viewing traces and spans
+// within a trace.  A Trace is a collection of spans corresponding to a single
+// operation or set of operations for an application. A span is an individual
+// timed event which forms a node of the trace tree. Spans for a single trace
+// may span multiple services.
+service TraceService {
+  // 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"
+    };
+  }
+
+  // Gets a single trace by its ID.
+  rpc GetTrace(GetTraceRequest) returns (Trace) {
+    option (google.api.http) = {
+      get: "/v1/projects/{project_id}/traces/{trace_id}"
+    };
+  }
+
+  // Sends new traces to Stackdriver Trace or updates existing traces. If the ID
+  // of a trace that you send matches that of an existing trace, any fields
+  // in the existing trace and its spans are overwritten by the provided values,
+  // and any new fields provided are merged with the existing trace data. If the
+  // ID does not match, a new trace is created.
+  rpc PatchTraces(PatchTracesRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      patch: "/v1/projects/{project_id}/traces"
+      body: "traces"
+    };
+  }
+}
+
+// A trace describes how long it takes for an application to perform an
+// operation. It consists of a set of spans, each of which represent a single
+// timed event within the operation.
+message Trace {
+  // Project ID of the Cloud project where the trace data is stored.
+  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.
+  string trace_id = 2;
+
+  // Collection of spans in the trace.
+  repeated TraceSpan spans = 3;
+}
+
+// List of new or updated traces.
+message Traces {
+  // List of traces.
+  repeated Trace traces = 1;
+}
+
+// A span represents a single timed event within a trace. Spans can be nested
+// and form a trace tree. Often, a trace contains a root span that describes the
+// end-to-end latency of an operation and, optionally, one or more subspans for
+// its suboperations. Spans do not need to be contiguous. There may be gaps
+// between spans in a trace.
+message TraceSpan {
+  // Type of span. Can be used to specify additional relationships between spans
+  // in addition to a parent/child relationship.
+  enum SpanKind {
+    // Unspecified.
+    SPAN_KIND_UNSPECIFIED = 0;
+
+    // Indicates that the span covers server-side handling of an RPC or other
+    // remote network request.
+    RPC_SERVER = 1;
+
+    // Indicates that the span covers the client-side wrapper around an RPC or
+    // other remote request.
+    RPC_CLIENT = 2;
+  }
+
+  // Identifier for the span. Must be a 64-bit integer other than 0 and
+  // unique within a trace.
+  fixed64 span_id = 1;
+
+  // Distinguishes between spans generated in a particular context. For example,
+  // two spans with the same name may be distinguished using `RPC_CLIENT`
+  // and `RPC_SERVER` to identify queueing latency associated with the span.
+  SpanKind kind = 2;
+
+  // 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 %}.
+  // 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
+  // cross-trace spans.
+  string name = 3;
+
+  // Start time of the span in nanoseconds from the UNIX epoch.
+  google.protobuf.Timestamp start_time = 4;
+
+  // 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;
+
+  // 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
+  // `/stacktrace` values).
+  //
+  // Some predefined label keys exist, or you may create your own. When creating
+  // your own, we recommend the following formats:
+  //
+  // * `/category/product/key` for agents of well-known products (e.g.
+  //   `/db/mongodb/read_size`).
+  // * `short_host/path/key` for domain-specific keys (e.g.
+  //   `foo.com/myproduct/bar`)
+  //
+  // Predefined labels include:
+  //
+  // *   `/agent`
+  // *   `/component`
+  // *   `/error/message`
+  // *   `/error/name`
+  // *   `/http/client_city`
+  // *   `/http/client_country`
+  // *   `/http/client_protocol`
+  // *   `/http/client_region`
+  // *   `/http/host`
+  // *   `/http/method`
+  // *   `/http/path`
+  // *   `/http/redirected_url`
+  // *   `/http/request/size`
+  // *   `/http/response/size`
+  // *   `/http/route`
+  // *   `/http/status_code`
+  // *   `/http/url`
+  // *   `/http/user_agent`
+  // *   `/pid`
+  // *   `/stacktrace`
+  // *   `/tid`
+  map<string, string> labels = 7;
+}
+
+// The request message for the `ListTraces` method. All fields are required
+// unless specified.
+message ListTracesRequest {
+  // Type of data returned for traces in the list.
+  enum ViewType {
+    // Default is `MINIMAL` if unspecified.
+    VIEW_TYPE_UNSPECIFIED = 0;
+
+    // Minimal view of the trace record that contains only the project
+    // and trace IDs.
+    MINIMAL = 1;
+
+    // Root span view of the trace record that returns the root spans along
+    // with the minimal trace data.
+    ROOTSPAN = 2;
+
+    // Complete view of the trace record that contains the actual trace data.
+    // This is equivalent to calling the REST `get` or RPC `GetTrace` method
+    // using the ID of each listed trace.
+    COMPLETE = 3;
+  }
+
+  // ID of the Cloud project where the trace data is stored.
+  string project_id = 1;
+
+  // Type of data returned for traces in the list. Optional. Default is
+  // `MINIMAL`.
+  ViewType view = 2;
+
+  // 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;
+
+  // Token identifying the page of results to return. If provided, use the
+  // value of the `next_page_token` field from a previous request. Optional.
+  string page_token = 4;
+
+  // Start of the time interval (inclusive) during which the trace data was
+  // collected from the application.
+  google.protobuf.Timestamp start_time = 5;
+
+  // End of the time interval (inclusive) during which the trace data was
+  // collected from the application.
+  google.protobuf.Timestamp end_time = 6;
+
+  // An optional filter against labels for the request.
+  //
+  // By default, searches use prefix matching. To specify exact match, prepend
+  // a plus symbol (`+`) to the search term.
+  // Multiple terms are ANDed. Syntax:
+  //
+  // *   `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root
+  //     span starts with `NAME_PREFIX`.
+  // *   `+root:NAME` or `+NAME`: Return traces where any root span's name is
+  //     exactly `NAME`.
+  // *   `span:NAME_PREFIX`: Return traces where any span starts with
+  //     `NAME_PREFIX`.
+  // *   `+span:NAME`: Return traces where any span's name is exactly
+  //     `NAME`.
+  // *   `latency:DURATION`: Return traces whose overall latency is
+  //     greater or equal to than `DURATION`. Accepted units are nanoseconds
+  //     (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For
+  //     example, `latency:24ms` returns traces whose overall latency
+  //     is greater than or equal to 24 milliseconds.
+  // *   `label:LABEL_KEY`: Return all traces containing the specified
+  //     label key (exact match, case-sensitive) regardless of the key:value
+  //     pair's value (including empty values).
+  // *   `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified
+  //     label key (exact match, case-sensitive) whose value starts with
+  //     `VALUE_PREFIX`. Both a key and a value must be specified.
+  // *   `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair
+  //     exactly matching the specified text. Both a key and a value must be
+  //     specified.
+  // *   `method:VALUE`: Equivalent to `/http/method:VALUE`.
+  // *   `url:VALUE`: Equivalent to `/http/url:VALUE`.
+  string filter = 7;
+
+  // Field used to sort the returned traces. Optional.
+  // Can be one of the following:
+  //
+  // *   `trace_id`
+  // *   `name` (`name` field of root span in the trace)
+  // *   `duration` (difference between `end_time` and `start_time` fields of
+  //      the root span)
+  // *   `start` (`start_time` field of the root span)
+  //
+  // Descending order can be specified by appending `desc` to the sort field
+  // (for example, `name desc`).
+  //
+  // Only one sort field is permitted.
+  string order_by = 8;
+}
+
+// The response message for the `ListTraces` method.
+message ListTracesResponse {
+  // List of trace records returned.
+  repeated Trace traces = 1;
+
+  // If defined, indicates that there are more traces that match the request
+  // and that this value should be passed to the next request to continue
+  // retrieving additional traces.
+  string next_page_token = 2;
+}
+
+// The request message for the `GetTrace` method.
+message GetTraceRequest {
+  // ID of the Cloud project where the trace data is stored.
+  string project_id = 1;
+
+  // ID of the trace to return.
+  string trace_id = 2;
+}
+
+// The request message for the `PatchTraces` method.
+message PatchTracesRequest {
+  // ID of the Cloud project where the trace data is stored.
+  string project_id = 1;
+
+  // The body of the message.
+  Traces traces = 2;
+}
diff --git a/trace/google/cloud/trace_v1/proto/trace_pb2.py b/trace/google/cloud/trace_v1/proto/trace_pb2.py
new file mode 100644
index 000000000000..25ac2a5cf6d9
--- /dev/null
+++ b/trace/google/cloud/trace_v1/proto/trace_pb2.py
@@ -0,0 +1,1085 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/cloudtrace_v1/proto/trace.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/cloudtrace_v1/proto/trace.proto",
+    package="google.devtools.cloudtrace.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.devtools.cloudtrace.v1B\nTraceProtoP\001ZGgoogle.golang.org/genproto/googleapis/devtools/cloudtrace/v1;cloudtrace\252\002\025Google.Cloud.Trace.V1\312\002\025Google\\Cloud\\Trace\\V1"
+    ),
+    serialized_pb=_b(
+        '\n/google/devtools/cloudtrace_v1/proto/trace.proto\x12\x1dgoogle.devtools.cloudtrace.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"f\n\x05Trace\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x10\n\x08trace_id\x18\x02 \x01(\t\x12\x37\n\x05spans\x18\x03 \x03(\x0b\x32(.google.devtools.cloudtrace.v1.TraceSpan">\n\x06Traces\x12\x34\n\x06traces\x18\x01 \x03(\x0b\x32$.google.devtools.cloudtrace.v1.Trace"\x9d\x03\n\tTraceSpan\x12\x0f\n\x07span_id\x18\x01 \x01(\x06\x12?\n\x04kind\x18\x02 \x01(\x0e\x32\x31.google.devtools.cloudtrace.v1.TraceSpan.SpanKind\x12\x0c\n\x04name\x18\x03 \x01(\t\x12.\n\nstart_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x16\n\x0eparent_span_id\x18\x06 \x01(\x06\x12\x44\n\x06labels\x18\x07 \x03(\x0b\x32\x34.google.devtools.cloudtrace.v1.TraceSpan.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"E\n\x08SpanKind\x12\x19\n\x15SPAN_KIND_UNSPECIFIED\x10\x00\x12\x0e\n\nRPC_SERVER\x10\x01\x12\x0e\n\nRPC_CLIENT\x10\x02"\xe7\x02\n\x11ListTracesRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12G\n\x04view\x18\x02 \x01(\x0e\x32\x39.google.devtools.cloudtrace.v1.ListTracesRequest.ViewType\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t\x12.\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0e\n\x06\x66ilter\x18\x07 \x01(\t\x12\x10\n\x08order_by\x18\x08 \x01(\t"N\n\x08ViewType\x12\x19\n\x15VIEW_TYPE_UNSPECIFIED\x10\x00\x12\x0b\n\x07MINIMAL\x10\x01\x12\x0c\n\x08ROOTSPAN\x10\x02\x12\x0c\n\x08\x43OMPLETE\x10\x03"c\n\x12ListTracesResponse\x12\x34\n\x06traces\x18\x01 \x03(\x0b\x32$.google.devtools.cloudtrace.v1.Trace\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"7\n\x0fGetTraceRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x10\n\x08trace_id\x18\x02 \x01(\t"_\n\x12PatchTracesRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x35\n\x06traces\x18\x02 \x01(\x0b\x32%.google.devtools.cloudtrace.v1.Traces2\xd1\x03\n\x0cTraceService\x12\x9b\x01\n\nListTraces\x12\x30.google.devtools.cloudtrace.v1.ListTracesRequest\x1a\x31.google.devtools.cloudtrace.v1.ListTracesResponse"(\x82\xd3\xe4\x93\x02"\x12 /v1/projects/{project_id}/traces\x12\x95\x01\n\x08GetTrace\x12..google.devtools.cloudtrace.v1.GetTraceRequest\x1a$.google.devtools.cloudtrace.v1.Trace"3\x82\xd3\xe4\x93\x02-\x12+/v1/projects/{project_id}/traces/{trace_id}\x12\x8a\x01\n\x0bPatchTraces\x12\x31.google.devtools.cloudtrace.v1.PatchTracesRequest\x1a\x16.google.protobuf.Empty"0\x82\xd3\xe4\x93\x02*2 /v1/projects/{project_id}/traces:\x06tracesB\xaa\x01\n!com.google.devtools.cloudtrace.v1B\nTraceProtoP\x01ZGgoogle.golang.org/genproto/googleapis/devtools/cloudtrace/v1;cloudtrace\xaa\x02\x15Google.Cloud.Trace.V1\xca\x02\x15Google\\Cloud\\Trace\\V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TRACESPAN_SPANKIND = _descriptor.EnumDescriptor(
+    name="SpanKind",
+    full_name="google.devtools.cloudtrace.v1.TraceSpan.SpanKind",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="SPAN_KIND_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RPC_SERVER", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RPC_CLIENT", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=687,
+    serialized_end=756,
+)
+_sym_db.RegisterEnumDescriptor(_TRACESPAN_SPANKIND)
+
+_LISTTRACESREQUEST_VIEWTYPE = _descriptor.EnumDescriptor(
+    name="ViewType",
+    full_name="google.devtools.cloudtrace.v1.ListTracesRequest.ViewType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="VIEW_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MINIMAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ROOTSPAN", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPLETE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1040,
+    serialized_end=1118,
+)
+_sym_db.RegisterEnumDescriptor(_LISTTRACESREQUEST_VIEWTYPE)
+
+
+_TRACE = _descriptor.Descriptor(
+    name="Trace",
+    full_name="google.devtools.cloudtrace.v1.Trace",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.devtools.cloudtrace.v1.Trace.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trace_id",
+            full_name="google.devtools.cloudtrace.v1.Trace.trace_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spans",
+            full_name="google.devtools.cloudtrace.v1.Trace.spans",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=174,
+    serialized_end=276,
+)
+
+
+_TRACES = _descriptor.Descriptor(
+    name="Traces",
+    full_name="google.devtools.cloudtrace.v1.Traces",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="traces",
+            full_name="google.devtools.cloudtrace.v1.Traces.traces",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=278,
+    serialized_end=340,
+)
+
+
+_TRACESPAN_LABELSENTRY = _descriptor.Descriptor(
+    name="LabelsEntry",
+    full_name="google.devtools.cloudtrace.v1.TraceSpan.LabelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.LabelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.LabelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=640,
+    serialized_end=685,
+)
+
+_TRACESPAN = _descriptor.Descriptor(
+    name="TraceSpan",
+    full_name="google.devtools.cloudtrace.v1.TraceSpan",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="span_id",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.span_id",
+            index=0,
+            number=1,
+            type=6,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="kind",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.kind",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.start_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.end_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent_span_id",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.parent_span_id",
+            index=5,
+            number=6,
+            type=6,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="labels",
+            full_name="google.devtools.cloudtrace.v1.TraceSpan.labels",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_TRACESPAN_LABELSENTRY],
+    enum_types=[_TRACESPAN_SPANKIND],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=343,
+    serialized_end=756,
+)
+
+
+_LISTTRACESREQUEST = _descriptor.Descriptor(
+    name="ListTracesRequest",
+    full_name="google.devtools.cloudtrace.v1.ListTracesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.view",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.page_token",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.start_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.end_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.filter",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="order_by",
+            full_name="google.devtools.cloudtrace.v1.ListTracesRequest.order_by",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_LISTTRACESREQUEST_VIEWTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=759,
+    serialized_end=1118,
+)
+
+
+_LISTTRACESRESPONSE = _descriptor.Descriptor(
+    name="ListTracesResponse",
+    full_name="google.devtools.cloudtrace.v1.ListTracesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="traces",
+            full_name="google.devtools.cloudtrace.v1.ListTracesResponse.traces",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.devtools.cloudtrace.v1.ListTracesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1120,
+    serialized_end=1219,
+)
+
+
+_GETTRACEREQUEST = _descriptor.Descriptor(
+    name="GetTraceRequest",
+    full_name="google.devtools.cloudtrace.v1.GetTraceRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.devtools.cloudtrace.v1.GetTraceRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="trace_id",
+            full_name="google.devtools.cloudtrace.v1.GetTraceRequest.trace_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1221,
+    serialized_end=1276,
+)
+
+
+_PATCHTRACESREQUEST = _descriptor.Descriptor(
+    name="PatchTracesRequest",
+    full_name="google.devtools.cloudtrace.v1.PatchTracesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="project_id",
+            full_name="google.devtools.cloudtrace.v1.PatchTracesRequest.project_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="traces",
+            full_name="google.devtools.cloudtrace.v1.PatchTracesRequest.traces",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1278,
+    serialized_end=1373,
+)
+
+_TRACE.fields_by_name["spans"].message_type = _TRACESPAN
+_TRACES.fields_by_name["traces"].message_type = _TRACE
+_TRACESPAN_LABELSENTRY.containing_type = _TRACESPAN
+_TRACESPAN.fields_by_name["kind"].enum_type = _TRACESPAN_SPANKIND
+_TRACESPAN.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRACESPAN.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TRACESPAN.fields_by_name["labels"].message_type = _TRACESPAN_LABELSENTRY
+_TRACESPAN_SPANKIND.containing_type = _TRACESPAN
+_LISTTRACESREQUEST.fields_by_name["view"].enum_type = _LISTTRACESREQUEST_VIEWTYPE
+_LISTTRACESREQUEST.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTTRACESREQUEST.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_LISTTRACESREQUEST_VIEWTYPE.containing_type = _LISTTRACESREQUEST
+_LISTTRACESRESPONSE.fields_by_name["traces"].message_type = _TRACE
+_PATCHTRACESREQUEST.fields_by_name["traces"].message_type = _TRACES
+DESCRIPTOR.message_types_by_name["Trace"] = _TRACE
+DESCRIPTOR.message_types_by_name["Traces"] = _TRACES
+DESCRIPTOR.message_types_by_name["TraceSpan"] = _TRACESPAN
+DESCRIPTOR.message_types_by_name["ListTracesRequest"] = _LISTTRACESREQUEST
+DESCRIPTOR.message_types_by_name["ListTracesResponse"] = _LISTTRACESRESPONSE
+DESCRIPTOR.message_types_by_name["GetTraceRequest"] = _GETTRACEREQUEST
+DESCRIPTOR.message_types_by_name["PatchTracesRequest"] = _PATCHTRACESREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Trace = _reflection.GeneratedProtocolMessageType(
+    "Trace",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRACE,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""A trace describes how long it takes for an application to perform an
+  operation. It consists of a set of spans, each of which represent a
+  single timed event within the operation.
+  
+  
+  Attributes:
+      project_id:
+          Project ID of the Cloud project where the trace data is
+          stored.
+      trace_id:
+          Globally unique identifier for the trace. This identifier is a
+          128-bit numeric value formatted as a 32-byte hex string.
+      spans:
+          Collection of spans in the trace.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.Trace)
+    ),
+)
+_sym_db.RegisterMessage(Trace)
+
+Traces = _reflection.GeneratedProtocolMessageType(
+    "Traces",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRACES,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""List of new or updated traces.
+  
+  
+  Attributes:
+      traces:
+          List of traces.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.Traces)
+    ),
+)
+_sym_db.RegisterMessage(Traces)
+
+TraceSpan = _reflection.GeneratedProtocolMessageType(
+    "TraceSpan",
+    (_message.Message,),
+    dict(
+        LabelsEntry=_reflection.GeneratedProtocolMessageType(
+            "LabelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TRACESPAN_LABELSENTRY,
+                __module__="google.devtools.cloudtrace_v1.proto.trace_pb2"
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.TraceSpan.LabelsEntry)
+            ),
+        ),
+        DESCRIPTOR=_TRACESPAN,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""A span represents a single timed event within a trace. Spans can be
+  nested and form a trace tree. Often, a trace contains a root span that
+  describes the end-to-end latency of an operation and, optionally, one or
+  more subspans for its suboperations. Spans do not need to be contiguous.
+  There may be gaps between spans in a trace.
+  
+  
+  Attributes:
+      span_id:
+          Identifier for the span. Must be a 64-bit integer other than 0
+          and unique within a trace.
+      kind:
+          Distinguishes between spans generated in a particular context.
+          For example, two spans with the same name may be distinguished
+          using ``RPC_CLIENT`` and ``RPC_SERVER`` to identify queueing
+          latency associated with the span.
+      name:
+          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 %}. 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
+          cross-trace spans.
+      start_time:
+          Start time of the span in nanoseconds from the UNIX epoch.
+      end_time:
+          End time of the span in nanoseconds from the UNIX epoch.
+      parent_span_id:
+          ID of the parent span, if any. Optional.
+      labels:
+          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 ``/stacktrace`` values).  Some predefined
+          label keys exist, or you may create your own. When creating
+          your own, we recommend the following formats:  -
+          ``/category/product/key`` for agents of well-known products
+          (e.g.    ``/db/mongodb/read_size``). -
+          ``short_host/path/key`` for domain-specific keys (e.g.
+          ``foo.com/myproduct/bar``)  Predefined labels include:  -
+          ``/agent`` -  ``/component`` -  ``/error/message`` -
+          ``/error/name`` -  ``/http/client_city`` -
+          ``/http/client_country`` -  ``/http/client_protocol`` -
+          ``/http/client_region`` -  ``/http/host`` -  ``/http/method``
+          -  ``/http/path`` -  ``/http/redirected_url`` -
+          ``/http/request/size`` -  ``/http/response/size`` -
+          ``/http/route`` -  ``/http/status_code`` -  ``/http/url`` -
+          ``/http/user_agent`` -  ``/pid`` -  ``/stacktrace`` -
+          ``/tid``
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.TraceSpan)
+    ),
+)
+_sym_db.RegisterMessage(TraceSpan)
+_sym_db.RegisterMessage(TraceSpan.LabelsEntry)
+
+ListTracesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListTracesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRACESREQUEST,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""The request message for the ``ListTraces`` method. All fields are
+  required unless specified.
+  
+  
+  Attributes:
+      project_id:
+          ID of the Cloud project where the trace data is stored.
+      view:
+          Type of data returned for traces in the list. Optional.
+          Default is ``MINIMAL``.
+      page_size:
+          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.
+      page_token:
+          Token identifying the page of results to return. If provided,
+          use the value of the ``next_page_token`` field from a previous
+          request. Optional.
+      start_time:
+          Start of the time interval (inclusive) during which the trace
+          data was collected from the application.
+      end_time:
+          End of the time interval (inclusive) during which the trace
+          data was collected from the application.
+      filter:
+          An optional filter against labels for the request.  By
+          default, searches use prefix matching. To specify exact match,
+          prepend a plus symbol (``+``) to the search term. Multiple
+          terms are ANDed. Syntax:  -  ``root:NAME_PREFIX`` or
+          ``NAME_PREFIX``: Return traces where any root    span starts
+          with ``NAME_PREFIX``. -  ``+root:NAME`` or ``+NAME``: Return
+          traces where any root span's name    is exactly ``NAME``. -
+          ``span:NAME_PREFIX``: Return traces where any span starts with
+          ``NAME_PREFIX``. -  ``+span:NAME``: Return traces where any
+          span's name is exactly    ``NAME``. -  ``latency:DURATION``:
+          Return traces whose overall latency is greater    or equal to
+          than ``DURATION``. Accepted units are nanoseconds    (``ns``),
+          milliseconds (``ms``), and seconds (``s``). Default is
+          ``ms``. For example, ``latency:24ms`` returns traces whose
+          overall    latency is greater than or equal to 24
+          milliseconds. -  ``label:LABEL_KEY``: Return all traces
+          containing the specified label    key (exact match, case-
+          sensitive) regardless of the key:value pair's    value
+          (including empty values). -  ``LABEL_KEY:VALUE_PREFIX``:
+          Return all traces containing the    specified label key (exact
+          match, case-sensitive) whose value starts    with
+          ``VALUE_PREFIX``. Both a key and a value must be specified. -
+          ``+LABEL_KEY:VALUE``: Return all traces containing a key:value
+          pair    exactly matching the specified text. Both a key and a
+          value must be    specified. -  ``method:VALUE``: Equivalent to
+          ``/http/method:VALUE``. -  ``url:VALUE``: Equivalent to
+          ``/http/url:VALUE``.
+      order_by:
+          Field used to sort the returned traces. Optional. Can be one
+          of the following:  -  ``trace_id`` -  ``name`` (``name`` field
+          of root span in the trace) -  ``duration`` (difference between
+          ``end_time`` and ``start_time``    fields of the root span) -
+          ``start`` (``start_time`` field of the root span)  Descending
+          order can be specified by appending ``desc`` to the sort field
+          (for example, ``name desc``).  Only one sort field is
+          permitted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.ListTracesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListTracesRequest)
+
+ListTracesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListTracesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTTRACESRESPONSE,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""The response message for the ``ListTraces`` method.
+  
+  
+  Attributes:
+      traces:
+          List of trace records returned.
+      next_page_token:
+          If defined, indicates that there are more traces that match
+          the request and that this value should be passed to the next
+          request to continue retrieving additional traces.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.ListTracesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListTracesResponse)
+
+GetTraceRequest = _reflection.GeneratedProtocolMessageType(
+    "GetTraceRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETTRACEREQUEST,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""The request message for the ``GetTrace`` method.
+  
+  
+  Attributes:
+      project_id:
+          ID of the Cloud project where the trace data is stored.
+      trace_id:
+          ID of the trace to return.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.GetTraceRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetTraceRequest)
+
+PatchTracesRequest = _reflection.GeneratedProtocolMessageType(
+    "PatchTracesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PATCHTRACESREQUEST,
+        __module__="google.devtools.cloudtrace_v1.proto.trace_pb2",
+        __doc__="""The request message for the ``PatchTraces`` method.
+  
+  
+  Attributes:
+      project_id:
+          ID of the Cloud project where the trace data is stored.
+      traces:
+          The body of the message.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v1.PatchTracesRequest)
+    ),
+)
+_sym_db.RegisterMessage(PatchTracesRequest)
+
+
+DESCRIPTOR._options = None
+_TRACESPAN_LABELSENTRY._options = None
+
+_TRACESERVICE = _descriptor.ServiceDescriptor(
+    name="TraceService",
+    full_name="google.devtools.cloudtrace.v1.TraceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=1376,
+    serialized_end=1841,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ListTraces",
+            full_name="google.devtools.cloudtrace.v1.TraceService.ListTraces",
+            index=0,
+            containing_service=None,
+            input_type=_LISTTRACESREQUEST,
+            output_type=_LISTTRACESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002"\022 /v1/projects/{project_id}/traces'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetTrace",
+            full_name="google.devtools.cloudtrace.v1.TraceService.GetTrace",
+            index=1,
+            containing_service=None,
+            input_type=_GETTRACEREQUEST,
+            output_type=_TRACE,
+            serialized_options=_b(
+                "\202\323\344\223\002-\022+/v1/projects/{project_id}/traces/{trace_id}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PatchTraces",
+            full_name="google.devtools.cloudtrace.v1.TraceService.PatchTraces",
+            index=2,
+            containing_service=None,
+            input_type=_PATCHTRACESREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002*2 /v1/projects/{project_id}/traces:\006traces"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_TRACESERVICE)
+
+DESCRIPTOR.services_by_name["TraceService"] = _TRACESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/trace/google/cloud/trace_v1/proto/trace_pb2_grpc.py b/trace/google/cloud/trace_v1/proto/trace_pb2_grpc.py
new file mode 100644
index 000000000000..e15c63100fd0
--- /dev/null
+++ b/trace/google/cloud/trace_v1/proto/trace_pb2_grpc.py
@@ -0,0 +1,96 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.trace_v1.proto import (
+    trace_pb2 as google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class TraceServiceStub(object):
+    """This file describes an API for collecting and viewing traces and spans
+  within a trace.  A Trace is a collection of spans corresponding to a single
+  operation or set of operations for an application. A span is an individual
+  timed event which forms a node of the trace tree. Spans for a single trace
+  may span multiple services.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ListTraces = channel.unary_unary(
+            "/google.devtools.cloudtrace.v1.TraceService/ListTraces",
+            request_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesResponse.FromString,
+        )
+        self.GetTrace = channel.unary_unary(
+            "/google.devtools.cloudtrace.v1.TraceService/GetTrace",
+            request_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.GetTraceRequest.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.Trace.FromString,
+        )
+        self.PatchTraces = channel.unary_unary(
+            "/google.devtools.cloudtrace.v1.TraceService/PatchTraces",
+            request_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.PatchTracesRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+
+
+class TraceServiceServicer(object):
+    """This file describes an API for collecting and viewing traces and spans
+  within a trace.  A Trace is a collection of spans corresponding to a single
+  operation or set of operations for an application. A span is an individual
+  timed event which forms a node of the trace tree. Spans for a single trace
+  may span multiple services.
+  """
+
+    def ListTraces(self, request, context):
+        """Returns of a list of traces that match the specified filter conditions.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetTrace(self, request, context):
+        """Gets a single trace by its ID.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PatchTraces(self, request, context):
+        """Sends new traces to Stackdriver Trace or updates existing traces. If the ID
+    of a trace that you send matches that of an existing trace, any fields
+    in the existing trace and its spans are overwritten by the provided values,
+    and any new fields provided are merged with the existing trace data. If the
+    ID does not match, a new trace is created.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_TraceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ListTraces": grpc.unary_unary_rpc_method_handler(
+            servicer.ListTraces,
+            request_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesRequest.FromString,
+            response_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesResponse.SerializeToString,
+        ),
+        "GetTrace": grpc.unary_unary_rpc_method_handler(
+            servicer.GetTrace,
+            request_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.GetTraceRequest.FromString,
+            response_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.Trace.SerializeToString,
+        ),
+        "PatchTraces": grpc.unary_unary_rpc_method_handler(
+            servicer.PatchTraces,
+            request_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.PatchTracesRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.devtools.cloudtrace.v1.TraceService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/trace/google/cloud/trace_v1/proto/tracing.proto b/trace/google/cloud/trace_v1/proto/tracing.proto
new file mode 100644
index 000000000000..fd4f3e027771
--- /dev/null
+++ b/trace/google/cloud/trace_v1/proto/tracing.proto
@@ -0,0 +1,59 @@
+// 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.cloudtrace.v2;
+
+import "google/api/annotations.proto";
+import "google/devtools/cloudtrace/v2/trace.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Trace.V2";
+option go_package = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace";
+option java_multiple_files = true;
+option java_outer_classname = "TracingProto";
+option java_package = "com.google.devtools.cloudtrace.v2";
+option php_namespace = "Google\\Cloud\\Trace\\V2";
+
+
+// This file describes an API for collecting and viewing traces and spans
+// within a trace.  A Trace is a collection of spans corresponding to a single
+// operation or set of operations for an application. A span is an individual
+// timed event which forms a node of the trace tree. A single trace may
+// contain span(s) from multiple services.
+service TraceService {
+  // Sends new spans to new or existing traces. You cannot update
+  // existing spans.
+  rpc BatchWriteSpans(BatchWriteSpansRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { post: "/v2/{name=projects/*}/traces:batchWrite" body: "*" };
+  }
+
+  // Creates a new span.
+  rpc CreateSpan(Span) returns (Span) {
+    option (google.api.http) = { post: "/v2/{name=projects/*/traces/*}/spans" body: "*" };
+  }
+}
+
+// The request message for the `BatchWriteSpans` method.
+message BatchWriteSpansRequest {
+  // Required. The name of the project where the spans belong. The format is
+  // `projects/[PROJECT_ID]`.
+  string name = 1;
+
+  // A list of new spans. The span names must not match existing
+  // spans, or the results are undefined.
+  repeated Span spans = 2;
+}
diff --git a/trace/google/cloud/trace_v1/types.py b/trace/google/cloud/trace_v1/types.py
new file mode 100644
index 000000000000..058320e083da
--- /dev/null
+++ b/trace/google/cloud/trace_v1/types.py
@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.trace_v1.proto import trace_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [empty_pb2, timestamp_pb2]
+
+_local_modules = [trace_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.trace_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/trace/google/cloud/trace_v2/__init__.py b/trace/google/cloud/trace_v2/__init__.py
new file mode 100644
index 000000000000..c285c7cc0500
--- /dev/null
+++ b/trace/google/cloud/trace_v2/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.trace_v2 import types
+from google.cloud.trace_v2.gapic import enums
+from google.cloud.trace_v2.gapic import trace_service_client
+
+
+class TraceServiceClient(trace_service_client.TraceServiceClient):
+    __doc__ = trace_service_client.TraceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "TraceServiceClient")
diff --git a/trace/google/cloud/trace_v2/gapic/__init__.py b/trace/google/cloud/trace_v2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/trace/google/cloud/trace_v2/gapic/enums.py b/trace/google/cloud/trace_v2/gapic/enums.py
new file mode 100644
index 000000000000..cea4e1d732ff
--- /dev/null
+++ b/trace/google/cloud/trace_v2/gapic/enums.py
@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Span(object):
+    class TimeEvent(object):
+        class MessageEvent(object):
+            class Type(enum.IntEnum):
+                """
+                Indicates whether the message was sent or received.
+
+                Attributes:
+                  TYPE_UNSPECIFIED (int): Unknown event type.
+                  SENT (int): Indicates a sent message.
+                  RECEIVED (int): Indicates a received message.
+                """
+
+                TYPE_UNSPECIFIED = 0
+                SENT = 1
+                RECEIVED = 2
+
+    class Link(object):
+        class Type(enum.IntEnum):
+            """
+            The relationship of the current span relative to the linked span: child,
+            parent, or unspecified.
+
+            Attributes:
+              TYPE_UNSPECIFIED (int): The relationship of the two spans is unknown.
+              CHILD_LINKED_SPAN (int): The linked span is a child of the current span.
+              PARENT_LINKED_SPAN (int): The linked span is a parent of the current span.
+            """
+
+            TYPE_UNSPECIFIED = 0
+            CHILD_LINKED_SPAN = 1
+            PARENT_LINKED_SPAN = 2
diff --git a/trace/google/cloud/trace_v2/gapic/trace_service_client.py b/trace/google/cloud/trace_v2/gapic/trace_service_client.py
new file mode 100644
index 000000000000..ef489dc0d785
--- /dev/null
+++ b/trace/google/cloud/trace_v2/gapic/trace_service_client.py
@@ -0,0 +1,464 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.devtools.cloudtrace.v2 TraceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.path_template
+import grpc
+
+from google.cloud.trace_v2.gapic import enums
+from google.cloud.trace_v2.gapic import trace_service_client_config
+from google.cloud.trace_v2.gapic.transports import trace_service_grpc_transport
+from google.cloud.trace_v2.proto import trace_pb2
+from google.cloud.trace_v2.proto import tracing_pb2
+from google.cloud.trace_v2.proto import tracing_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-trace").version
+
+
+class TraceServiceClient(object):
+    """
+    This file describes an API for collecting and viewing traces and spans
+    within a trace.  A Trace is a collection of spans corresponding to a single
+    operation or set of operations for an application. A span is an individual
+    timed event which forms a node of the trace tree. A single trace may
+    contain span(s) from multiple services.
+    """
+
+    SERVICE_ADDRESS = "cloudtrace.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.devtools.cloudtrace.v2.TraceService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            TraceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def span_path(cls, project, trace, span):
+        """Return a fully-qualified span string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/traces/{trace}/spans/{span}",
+            project=project,
+            trace=trace,
+            span=span,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.TraceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.TraceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = trace_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=trace_service_grpc_transport.TraceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = trace_service_grpc_transport.TraceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def batch_write_spans(
+        self,
+        name,
+        spans,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Sends new spans to new or existing traces. You cannot update
+        existing spans.
+
+        Example:
+            >>> from google.cloud import trace_v2
+            >>>
+            >>> client = trace_v2.TraceServiceClient()
+            >>>
+            >>> name = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `spans`:
+            >>> spans = []
+            >>>
+            >>> client.batch_write_spans(name, spans)
+
+        Args:
+            name (str): Required. The name of the project where the spans belong. The format is
+                ``projects/[PROJECT_ID]``.
+            spans (list[Union[dict, ~google.cloud.trace_v2.types.Span]]): A list of new spans. The span names must not match existing
+                spans, or the results are undefined.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Span`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_write_spans" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_write_spans"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_write_spans,
+                default_retry=self._method_configs["BatchWriteSpans"].retry,
+                default_timeout=self._method_configs["BatchWriteSpans"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = tracing_pb2.BatchWriteSpansRequest(name=name, spans=spans)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["batch_write_spans"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_span(
+        self,
+        name,
+        span_id,
+        display_name,
+        start_time,
+        end_time,
+        parent_span_id=None,
+        attributes=None,
+        stack_trace=None,
+        time_events=None,
+        links=None,
+        status=None,
+        same_process_as_parent_span=None,
+        child_span_count=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new span.
+
+        Example:
+            >>> from google.cloud import trace_v2
+            >>>
+            >>> client = trace_v2.TraceServiceClient()
+            >>>
+            >>> name = client.span_path('[PROJECT]', '[TRACE]', '[SPAN]')
+            >>>
+            >>> # TODO: Initialize `span_id`:
+            >>> span_id = ''
+            >>>
+            >>> # TODO: Initialize `display_name`:
+            >>> display_name = {}
+            >>>
+            >>> # TODO: Initialize `start_time`:
+            >>> start_time = {}
+            >>>
+            >>> # TODO: Initialize `end_time`:
+            >>> end_time = {}
+            >>>
+            >>> response = client.create_span(name, span_id, display_name, start_time, end_time)
+
+        Args:
+            name (str): The resource name of the span in the following format:
+
+                ::
+
+                     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+
+                [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 is a
+                16-character hexadecimal encoding of an 8-byte array.
+            span_id (str): The [SPAN\_ID] portion of the span's resource name.
+            display_name (Union[dict, ~google.cloud.trace_v2.types.TruncatableString]): A description of the span's operation (up to 128 bytes). Stackdriver
+                Trace displays the description in the {% dynamic print
+                site\_values.console\_name %}. 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.TruncatableString`
+            start_time (Union[dict, ~google.cloud.trace_v2.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Timestamp`
+            end_time (Union[dict, ~google.cloud.trace_v2.types.Timestamp]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Timestamp`
+            parent_span_id (str): The [SPAN\_ID] of this span's parent span. If this is a root span, then
+                this field must be empty.
+            attributes (Union[dict, ~google.cloud.trace_v2.types.Attributes]): A set of attributes on the span. You can have up to 32 attributes per
+                span.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Attributes`
+            stack_trace (Union[dict, ~google.cloud.trace_v2.types.StackTrace]): Stack trace captured at the start of the span.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.StackTrace`
+            time_events (Union[dict, ~google.cloud.trace_v2.types.TimeEvents]): A set of time events. You can have up to 32 annotations and 128 message
+                events per span.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.TimeEvents`
+            links (Union[dict, ~google.cloud.trace_v2.types.Links]): Links associated with the span. You can have up to 128 links per Span.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Links`
+            status (Union[dict, ~google.cloud.trace_v2.types.Status]): An optional final status for this span.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Status`
+            same_process_as_parent_span (Union[dict, ~google.cloud.trace_v2.types.BoolValue]): (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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.BoolValue`
+            child_span_count (Union[dict, ~google.cloud.trace_v2.types.Int32Value]): An optional number of child spans that were generated while this span
+                was active. If set, allows implementation to detect missing child spans.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.trace_v2.types.Int32Value`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.trace_v2.types.Span` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_span" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_span"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_span,
+                default_retry=self._method_configs["CreateSpan"].retry,
+                default_timeout=self._method_configs["CreateSpan"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = trace_pb2.Span(
+            name=name,
+            span_id=span_id,
+            display_name=display_name,
+            start_time=start_time,
+            end_time=end_time,
+            parent_span_id=parent_span_id,
+            attributes=attributes,
+            stack_trace=stack_trace,
+            time_events=time_events,
+            links=links,
+            status=status,
+            same_process_as_parent_span=same_process_as_parent_span,
+            child_span_count=child_span_count,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_span"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/trace/google/cloud/trace_v2/gapic/trace_service_client_config.py b/trace/google/cloud/trace_v2/gapic/trace_service_client_config.py
new file mode 100644
index 000000000000..778912910db8
--- /dev/null
+++ b/trace/google/cloud/trace_v2/gapic/trace_service_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.devtools.cloudtrace.v2.TraceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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,
+                }
+            },
+            "methods": {
+                "BatchWriteSpans": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateSpan": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/trace/google/cloud/trace_v2/gapic/transports/__init__.py b/trace/google/cloud/trace_v2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/trace/google/cloud/trace_v2/gapic/transports/trace_service_grpc_transport.py b/trace/google/cloud/trace_v2/gapic/transports/trace_service_grpc_transport.py
new file mode 100644
index 000000000000..62e908229d96
--- /dev/null
+++ b/trace/google/cloud/trace_v2/gapic/transports/trace_service_grpc_transport.py
@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.trace_v2.proto import tracing_pb2_grpc
+
+
+class TraceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.devtools.cloudtrace.v2 TraceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/trace.append",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="cloudtrace.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {"trace_service_stub": tracing_pb2_grpc.TraceServiceStub(channel)}
+
+    @classmethod
+    def create_channel(
+        cls, address="cloudtrace.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def batch_write_spans(self):
+        """Return the gRPC stub for :meth:`TraceServiceClient.batch_write_spans`.
+
+        Sends new spans to new or existing traces. You cannot update
+        existing spans.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["trace_service_stub"].BatchWriteSpans
+
+    @property
+    def create_span(self):
+        """Return the gRPC stub for :meth:`TraceServiceClient.create_span`.
+
+        Creates a new span.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["trace_service_stub"].CreateSpan
diff --git a/trace/google/cloud/trace_v2/proto/__init__.py b/trace/google/cloud/trace_v2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/trace/google/cloud/trace_v2/proto/trace.proto b/trace/google/cloud/trace_v2/proto/trace.proto
new file mode 100644
index 000000000000..d9fbe663b38a
--- /dev/null
+++ b/trace/google/cloud/trace_v2/proto/trace.proto
@@ -0,0 +1,335 @@
+// 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.cloudtrace.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.Trace.V2";
+option go_package = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace";
+option java_multiple_files = true;
+option java_outer_classname = "TraceProto";
+option java_package = "com.google.devtools.cloudtrace.v2";
+option php_namespace = "Google\\Cloud\\Trace\\V2";
+
+// A span represents a single operation within a trace. Spans can be
+// nested to form a trace tree. Often, a trace contains a root span
+// that describes the end-to-end latency, and one or more subspans for
+// its sub-operations. A trace can also contain multiple root spans,
+// or none at all. Spans do not need to be contiguous&mdash;there may be
+// gaps or overlaps between spans in a trace.
+message 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:
+    //
+    //     "/instance_id": "my-instance"
+    //     "/http/user_agent": ""
+    //     "/http/request_bytes": 300
+    //     "abc.com/myattribute": true
+    map<string, AttributeValue> attribute_map = 1;
+
+    // The number of attributes that were discarded. Attributes can be discarded
+    // because their keys are too long or because there are too many attributes.
+    // If this value is 0 then all attributes are valid.
+    int32 dropped_attributes_count = 2;
+  }
+
+  // A time-stamped annotation or message event in the Span.
+  message TimeEvent {
+    // Text annotation with a set of attributes.
+    message Annotation {
+      // A user-supplied message describing the event. The maximum length for
+      // the description is 256 bytes.
+      TruncatableString description = 1;
+
+      // A set of attributes on the annotation. You can have up to 4 attributes
+      // per Annotation.
+      Attributes attributes = 2;
+    }
+
+    // An event describing a message sent/received between Spans.
+    message MessageEvent {
+      // Indicates whether the message was sent or received.
+      enum Type {
+        // Unknown event type.
+        TYPE_UNSPECIFIED = 0;
+
+        // Indicates a sent message.
+        SENT = 1;
+
+        // Indicates a received message.
+        RECEIVED = 2;
+      }
+
+      // Type of MessageEvent. Indicates whether the message was sent or
+      // received.
+      Type type = 1;
+
+      // An identifier for the MessageEvent's message that can be used to match
+      // SENT and RECEIVED MessageEvents. It is recommended to be unique within
+      // a Span.
+      int64 id = 2;
+
+      // The number of uncompressed bytes sent or received.
+      int64 uncompressed_size_bytes = 3;
+
+      // The number of compressed bytes sent or received. If missing assumed to
+      // be the same size as uncompressed.
+      int64 compressed_size_bytes = 4;
+    }
+
+    // The timestamp indicating the time the event occurred.
+    google.protobuf.Timestamp time = 1;
+
+    // A `TimeEvent` can contain either an `Annotation` object or a
+    // `MessageEvent` object, but not both.
+    oneof value {
+      // Text annotation with a set of attributes.
+      Annotation annotation = 2;
+
+      // An event describing a message sent/received between Spans.
+      MessageEvent message_event = 3;
+    }
+  }
+
+  // A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation
+  // on the span, consisting of either user-supplied key:value pairs, or
+  // details of a message sent/received between Spans.
+  message TimeEvents {
+    // A collection of `TimeEvent`s.
+    repeated TimeEvent time_event = 1;
+
+    // The number of dropped annotations in all the included time events.
+    // If the value is 0, then no annotations were dropped.
+    int32 dropped_annotations_count = 2;
+
+    // The number of dropped message events in all the included time events.
+    // If the value is 0, then no message events were dropped.
+    int32 dropped_message_events_count = 3;
+  }
+
+  // A pointer from the current span to another span in the same trace or in a
+  // different trace. For example, this can be used in batching operations,
+  // where a single batch handler processes multiple requests from different
+  // traces or when the handler receives a request from a different project.
+  message Link {
+    // The relationship of the current span relative to the linked span: child,
+    // parent, or unspecified.
+    enum Type {
+      // The relationship of the two spans is unknown.
+      TYPE_UNSPECIFIED = 0;
+
+      // The linked span is a child of the current span.
+      CHILD_LINKED_SPAN = 1;
+
+      // The linked span is a parent of the current span.
+      PARENT_LINKED_SPAN = 2;
+    }
+
+    // The [TRACE_ID] for a trace within a project.
+    string trace_id = 1;
+
+    // The [SPAN_ID] for a span within a trace.
+    string span_id = 2;
+
+    // The relationship of the current span relative to the linked span.
+    Type type = 3;
+
+    // A set of attributes on the link. You have have up to  32 attributes per
+    // link.
+    Attributes attributes = 4;
+  }
+
+  // A collection of links, which are references from this span to a span
+  // in the same or different trace.
+  message Links {
+    // A collection of links.
+    repeated Link link = 1;
+
+    // The number of dropped links after the maximum size was enforced. If
+    // this value is 0, then no links were dropped.
+    int32 dropped_links_count = 2;
+  }
+
+  // The resource name of the span in the following format:
+  //
+  //     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+  //
+  // [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
+  // is a 16-character hexadecimal encoding of an 8-byte array.
+  string name = 1;
+
+  // The [SPAN_ID] portion of the span's resource name.
+  string span_id = 2;
+
+  // The [SPAN_ID] of this span's parent span. If this is a root span,
+  // then this field must be empty.
+  string parent_span_id = 3;
+
+  // A description of the span's operation (up to 128 bytes).
+  // Stackdriver Trace displays the description in the
+  // {% dynamic print site_values.console_name %}.
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // A set of attributes on the span. You can have up to 32 attributes per
+  // span.
+  Attributes attributes = 7;
+
+  // Stack trace captured at the start of the span.
+  StackTrace stack_trace = 8;
+
+  // A set of time events. You can have up to 32 annotations and 128 message
+  // events per span.
+  TimeEvents time_events = 9;
+
+  // 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) 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;
+
+  // An optional 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;
+}
+
+// The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+message AttributeValue {
+  // The type of the value.
+  oneof value {
+    // A string up to 256 bytes long.
+    TruncatableString string_value = 1;
+
+    // A 64-bit signed integer.
+    int64 int_value = 2;
+
+    // A Boolean value represented by `true` or `false`.
+    bool bool_value = 3;
+  }
+}
+
+// A call stack appearing in a trace.
+message StackTrace {
+  // Represents a single stack frame in a stack trace.
+  message StackFrame {
+    // The fully-qualified name that uniquely identifies the function or
+    // method that is active in this frame (up to 1024 bytes).
+    TruncatableString function_name = 1;
+
+    // An un-mangled function name, if `function_name` is
+    // [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can
+    // be fully-qualified (up to 1024 bytes).
+    TruncatableString original_function_name = 2;
+
+    // The name of the source file where the function call appears (up to 256
+    // bytes).
+    TruncatableString file_name = 3;
+
+    // The line number in `file_name` where the function call appears.
+    int64 line_number = 4;
+
+    // The column number where the function call appears, if available.
+    // This is important in JavaScript because of its anonymous functions.
+    int64 column_number = 5;
+
+    // The binary module from where the code was loaded.
+    Module load_module = 6;
+
+    // The version of the deployed source code (up to 128 bytes).
+    TruncatableString source_version = 7;
+  }
+
+  // A collection of stack frames, which can be truncated.
+  message StackFrames {
+    // Stack frames in this call stack.
+    repeated StackFrame frame = 1;
+
+    // The number of stack frames that were dropped because there
+    // were too many stack frames.
+    // If this value is 0, then no stack frames were dropped.
+    int32 dropped_frames_count = 2;
+  }
+
+  // Stack frames in this stack trace. A maximum of 128 frames are allowed.
+  StackFrames stack_frames = 1;
+
+  // The hash ID is used to conserve network bandwidth for duplicate
+  // stack traces within a single trace.
+  //
+  // Often multiple spans will have identical stack traces.
+  // The first occurrence of a stack trace should contain both the
+  // `stackFrame` content and a value in `stackTraceHashId`.
+  //
+  // Subsequent spans within the same request can refer
+  // to that stack trace by only setting `stackTraceHashId`.
+  int64 stack_trace_hash_id = 2;
+}
+
+// Binary module.
+message Module {
+  // For example: main binary, kernel modules, and dynamic libraries
+  // such as libc.so, sharedlib.so (up to 256 bytes).
+  TruncatableString module = 1;
+
+  // A unique identifier for the module, usually a hash of its
+  // contents (up to 128 bytes).
+  TruncatableString build_id = 2;
+}
+
+// Represents a string that might be shortened to a specified length.
+message TruncatableString {
+  // The shortened string. For example, if the original string is 500
+  // bytes long and the limit of the string is 128 bytes, then
+  // `value` contains the first 128 bytes of the 500-byte string.
+  //
+  // Truncation always happens on a UTF8 character boundary. If there
+  // are multi-byte characters in the string, then the length of the
+  // shortened string might be less than the size limit.
+  string value = 1;
+
+  // The number of bytes removed from the original string. If this
+  // value is 0, then the string was not shortened.
+  int32 truncated_byte_count = 2;
+}
diff --git a/trace/google/cloud/trace_v2/proto/trace_pb2.py b/trace/google/cloud/trace_v2/proto/trace_pb2.py
new file mode 100644
index 000000000000..5298cb85dfe1
--- /dev/null
+++ b/trace/google/cloud/trace_v2/proto/trace_pb2.py
@@ -0,0 +1,1909 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/cloudtrace_v2/proto/trace.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/cloudtrace_v2/proto/trace.proto",
+    package="google.devtools.cloudtrace.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.devtools.cloudtrace.v2B\nTraceProtoP\001ZGgoogle.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace\252\002\025Google.Cloud.Trace.V2\312\002\025Google\\Cloud\\Trace\\V2"
+    ),
+    serialized_pb=_b(
+        '\n/google/devtools/cloudtrace_v2/proto/trace.proto\x12\x1dgoogle.devtools.cloudtrace.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto"\xc5\x0f\n\x04Span\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07span_id\x18\x02 \x01(\t\x12\x16\n\x0eparent_span_id\x18\x03 \x01(\t\x12\x46\n\x0c\x64isplay_name\x18\x04 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x12.\n\nstart_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x42\n\nattributes\x18\x07 \x01(\x0b\x32..google.devtools.cloudtrace.v2.Span.Attributes\x12>\n\x0bstack_trace\x18\x08 \x01(\x0b\x32).google.devtools.cloudtrace.v2.StackTrace\x12\x43\n\x0btime_events\x18\t \x01(\x0b\x32..google.devtools.cloudtrace.v2.Span.TimeEvents\x12\x38\n\x05links\x18\n \x01(\x0b\x32).google.devtools.cloudtrace.v2.Span.Links\x12"\n\x06status\x18\x0b \x01(\x0b\x32\x12.google.rpc.Status\x12?\n\x1bsame_process_as_parent_span\x18\x0c \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x35\n\x10\x63hild_span_count\x18\r \x01(\x0b\x32\x1b.google.protobuf.Int32Value\x1a\xeb\x01\n\nAttributes\x12W\n\rattribute_map\x18\x01 \x03(\x0b\x32@.google.devtools.cloudtrace.v2.Span.Attributes.AttributeMapEntry\x12 \n\x18\x64ropped_attributes_count\x18\x02 \x01(\x05\x1a\x62\n\x11\x41ttributeMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12<\n\x05value\x18\x02 \x01(\x0b\x32-.google.devtools.cloudtrace.v2.AttributeValue:\x02\x38\x01\x1a\xdf\x04\n\tTimeEvent\x12(\n\x04time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12N\n\nannotation\x18\x02 \x01(\x0b\x32\x38.google.devtools.cloudtrace.v2.Span.TimeEvent.AnnotationH\x00\x12S\n\rmessage_event\x18\x03 \x01(\x0b\x32:.google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEventH\x00\x1a\x97\x01\n\nAnnotation\x12\x45\n\x0b\x64\x65scription\x18\x01 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x12\x42\n\nattributes\x18\x02 \x01(\x0b\x32..google.devtools.cloudtrace.v2.Span.Attributes\x1a\xdf\x01\n\x0cMessageEvent\x12M\n\x04type\x18\x01 \x01(\x0e\x32?.google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.Type\x12\n\n\x02id\x18\x02 \x01(\x03\x12\x1f\n\x17uncompressed_size_bytes\x18\x03 \x01(\x03\x12\x1d\n\x15\x63ompressed_size_bytes\x18\x04 \x01(\x03"4\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04SENT\x10\x01\x12\x0c\n\x08RECEIVED\x10\x02\x42\x07\n\x05value\x1a\x98\x01\n\nTimeEvents\x12\x41\n\ntime_event\x18\x01 \x03(\x0b\x32-.google.devtools.cloudtrace.v2.Span.TimeEvent\x12!\n\x19\x64ropped_annotations_count\x18\x02 \x01(\x05\x12$\n\x1c\x64ropped_message_events_count\x18\x03 \x01(\x05\x1a\xf7\x01\n\x04Link\x12\x10\n\x08trace_id\x18\x01 \x01(\t\x12\x0f\n\x07span_id\x18\x02 \x01(\t\x12;\n\x04type\x18\x03 \x01(\x0e\x32-.google.devtools.cloudtrace.v2.Span.Link.Type\x12\x42\n\nattributes\x18\x04 \x01(\x0b\x32..google.devtools.cloudtrace.v2.Span.Attributes"K\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x15\n\x11\x43HILD_LINKED_SPAN\x10\x01\x12\x16\n\x12PARENT_LINKED_SPAN\x10\x02\x1a\\\n\x05Links\x12\x36\n\x04link\x18\x01 \x03(\x0b\x32(.google.devtools.cloudtrace.v2.Span.Link\x12\x1b\n\x13\x64ropped_links_count\x18\x02 \x01(\x05"\x8e\x01\n\x0e\x41ttributeValue\x12H\n\x0cstring_value\x18\x01 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableStringH\x00\x12\x13\n\tint_value\x18\x02 \x01(\x03H\x00\x12\x14\n\nbool_value\x18\x03 \x01(\x08H\x00\x42\x07\n\x05value"\x89\x05\n\nStackTrace\x12K\n\x0cstack_frames\x18\x01 \x01(\x0b\x32\x35.google.devtools.cloudtrace.v2.StackTrace.StackFrames\x12\x1b\n\x13stack_trace_hash_id\x18\x02 \x01(\x03\x1a\x9e\x03\n\nStackFrame\x12G\n\rfunction_name\x18\x01 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x12P\n\x16original_function_name\x18\x02 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x12\x43\n\tfile_name\x18\x03 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x12\x13\n\x0bline_number\x18\x04 \x01(\x03\x12\x15\n\rcolumn_number\x18\x05 \x01(\x03\x12:\n\x0bload_module\x18\x06 \x01(\x0b\x32%.google.devtools.cloudtrace.v2.Module\x12H\n\x0esource_version\x18\x07 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x1ap\n\x0bStackFrames\x12\x43\n\x05\x66rame\x18\x01 \x03(\x0b\x32\x34.google.devtools.cloudtrace.v2.StackTrace.StackFrame\x12\x1c\n\x14\x64ropped_frames_count\x18\x02 \x01(\x05"\x8e\x01\n\x06Module\x12@\n\x06module\x18\x01 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString\x12\x42\n\x08\x62uild_id\x18\x02 \x01(\x0b\x32\x30.google.devtools.cloudtrace.v2.TruncatableString"@\n\x11TruncatableString\x12\r\n\x05value\x18\x01 \x01(\t\x12\x1c\n\x14truncated_byte_count\x18\x02 \x01(\x05\x42\xaa\x01\n!com.google.devtools.cloudtrace.v2B\nTraceProtoP\x01ZGgoogle.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace\xaa\x02\x15Google.Cloud.Trace.V2\xca\x02\x15Google\\Cloud\\Trace\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_SPAN_TIMEEVENT_MESSAGEEVENT_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SENT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RECEIVED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1632,
+    serialized_end=1684,
+)
+_sym_db.RegisterEnumDescriptor(_SPAN_TIMEEVENT_MESSAGEEVENT_TYPE)
+
+_SPAN_LINK_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.devtools.cloudtrace.v2.Span.Link.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHILD_LINKED_SPAN",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PARENT_LINKED_SPAN",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2023,
+    serialized_end=2098,
+)
+_sym_db.RegisterEnumDescriptor(_SPAN_LINK_TYPE)
+
+
+_SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY = _descriptor.Descriptor(
+    name="AttributeMapEntry",
+    full_name="google.devtools.cloudtrace.v2.Span.Attributes.AttributeMapEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.devtools.cloudtrace.v2.Span.Attributes.AttributeMapEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.devtools.cloudtrace.v2.Span.Attributes.AttributeMapEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=985,
+    serialized_end=1083,
+)
+
+_SPAN_ATTRIBUTES = _descriptor.Descriptor(
+    name="Attributes",
+    full_name="google.devtools.cloudtrace.v2.Span.Attributes",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="attribute_map",
+            full_name="google.devtools.cloudtrace.v2.Span.Attributes.attribute_map",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dropped_attributes_count",
+            full_name="google.devtools.cloudtrace.v2.Span.Attributes.dropped_attributes_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=848,
+    serialized_end=1083,
+)
+
+_SPAN_TIMEEVENT_ANNOTATION = _descriptor.Descriptor(
+    name="Annotation",
+    full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.Annotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.Annotation.description",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.Annotation.attributes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1307,
+    serialized_end=1458,
+)
+
+_SPAN_TIMEEVENT_MESSAGEEVENT = _descriptor.Descriptor(
+    name="MessageEvent",
+    full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="id",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.id",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uncompressed_size_bytes",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.uncompressed_size_bytes",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="compressed_size_bytes",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent.compressed_size_bytes",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SPAN_TIMEEVENT_MESSAGEEVENT_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1461,
+    serialized_end=1684,
+)
+
+_SPAN_TIMEEVENT = _descriptor.Descriptor(
+    name="TimeEvent",
+    full_name="google.devtools.cloudtrace.v2.Span.TimeEvent",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.annotation",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="message_event",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.message_event",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SPAN_TIMEEVENT_ANNOTATION, _SPAN_TIMEEVENT_MESSAGEEVENT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvent.value",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1086,
+    serialized_end=1693,
+)
+
+_SPAN_TIMEEVENTS = _descriptor.Descriptor(
+    name="TimeEvents",
+    full_name="google.devtools.cloudtrace.v2.Span.TimeEvents",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_event",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvents.time_event",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dropped_annotations_count",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvents.dropped_annotations_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dropped_message_events_count",
+            full_name="google.devtools.cloudtrace.v2.Span.TimeEvents.dropped_message_events_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1696,
+    serialized_end=1848,
+)
+
+_SPAN_LINK = _descriptor.Descriptor(
+    name="Link",
+    full_name="google.devtools.cloudtrace.v2.Span.Link",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="trace_id",
+            full_name="google.devtools.cloudtrace.v2.Span.Link.trace_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="span_id",
+            full_name="google.devtools.cloudtrace.v2.Span.Link.span_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.devtools.cloudtrace.v2.Span.Link.type",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.devtools.cloudtrace.v2.Span.Link.attributes",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SPAN_LINK_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1851,
+    serialized_end=2098,
+)
+
+_SPAN_LINKS = _descriptor.Descriptor(
+    name="Links",
+    full_name="google.devtools.cloudtrace.v2.Span.Links",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="link",
+            full_name="google.devtools.cloudtrace.v2.Span.Links.link",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dropped_links_count",
+            full_name="google.devtools.cloudtrace.v2.Span.Links.dropped_links_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2100,
+    serialized_end=2192,
+)
+
+_SPAN = _descriptor.Descriptor(
+    name="Span",
+    full_name="google.devtools.cloudtrace.v2.Span",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.devtools.cloudtrace.v2.Span.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="span_id",
+            full_name="google.devtools.cloudtrace.v2.Span.span_id",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent_span_id",
+            full_name="google.devtools.cloudtrace.v2.Span.parent_span_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.devtools.cloudtrace.v2.Span.display_name",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.devtools.cloudtrace.v2.Span.start_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.devtools.cloudtrace.v2.Span.end_time",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.devtools.cloudtrace.v2.Span.attributes",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stack_trace",
+            full_name="google.devtools.cloudtrace.v2.Span.stack_trace",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_events",
+            full_name="google.devtools.cloudtrace.v2.Span.time_events",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="links",
+            full_name="google.devtools.cloudtrace.v2.Span.links",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="status",
+            full_name="google.devtools.cloudtrace.v2.Span.status",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="same_process_as_parent_span",
+            full_name="google.devtools.cloudtrace.v2.Span.same_process_as_parent_span",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="child_span_count",
+            full_name="google.devtools.cloudtrace.v2.Span.child_span_count",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _SPAN_ATTRIBUTES,
+        _SPAN_TIMEEVENT,
+        _SPAN_TIMEEVENTS,
+        _SPAN_LINK,
+        _SPAN_LINKS,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=203,
+    serialized_end=2192,
+)
+
+
+_ATTRIBUTEVALUE = _descriptor.Descriptor(
+    name="AttributeValue",
+    full_name="google.devtools.cloudtrace.v2.AttributeValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="string_value",
+            full_name="google.devtools.cloudtrace.v2.AttributeValue.string_value",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="int_value",
+            full_name="google.devtools.cloudtrace.v2.AttributeValue.int_value",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bool_value",
+            full_name="google.devtools.cloudtrace.v2.AttributeValue.bool_value",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="value",
+            full_name="google.devtools.cloudtrace.v2.AttributeValue.value",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2195,
+    serialized_end=2337,
+)
+
+
+_STACKTRACE_STACKFRAME = _descriptor.Descriptor(
+    name="StackFrame",
+    full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="function_name",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.function_name",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="original_function_name",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.original_function_name",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="file_name",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.file_name",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="line_number",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.line_number",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="column_number",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.column_number",
+            index=4,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="load_module",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.load_module",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_version",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrame.source_version",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2461,
+    serialized_end=2875,
+)
+
+_STACKTRACE_STACKFRAMES = _descriptor.Descriptor(
+    name="StackFrames",
+    full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrames",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="frame",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrames.frame",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="dropped_frames_count",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.StackFrames.dropped_frames_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2877,
+    serialized_end=2989,
+)
+
+_STACKTRACE = _descriptor.Descriptor(
+    name="StackTrace",
+    full_name="google.devtools.cloudtrace.v2.StackTrace",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stack_frames",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.stack_frames",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stack_trace_hash_id",
+            full_name="google.devtools.cloudtrace.v2.StackTrace.stack_trace_hash_id",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_STACKTRACE_STACKFRAME, _STACKTRACE_STACKFRAMES],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2340,
+    serialized_end=2989,
+)
+
+
+_MODULE = _descriptor.Descriptor(
+    name="Module",
+    full_name="google.devtools.cloudtrace.v2.Module",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="module",
+            full_name="google.devtools.cloudtrace.v2.Module.module",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="build_id",
+            full_name="google.devtools.cloudtrace.v2.Module.build_id",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2992,
+    serialized_end=3134,
+)
+
+
+_TRUNCATABLESTRING = _descriptor.Descriptor(
+    name="TruncatableString",
+    full_name="google.devtools.cloudtrace.v2.TruncatableString",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.devtools.cloudtrace.v2.TruncatableString.value",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="truncated_byte_count",
+            full_name="google.devtools.cloudtrace.v2.TruncatableString.truncated_byte_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3136,
+    serialized_end=3200,
+)
+
+_SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY.fields_by_name[
+    "value"
+].message_type = _ATTRIBUTEVALUE
+_SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY.containing_type = _SPAN_ATTRIBUTES
+_SPAN_ATTRIBUTES.fields_by_name[
+    "attribute_map"
+].message_type = _SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY
+_SPAN_ATTRIBUTES.containing_type = _SPAN
+_SPAN_TIMEEVENT_ANNOTATION.fields_by_name[
+    "description"
+].message_type = _TRUNCATABLESTRING
+_SPAN_TIMEEVENT_ANNOTATION.fields_by_name["attributes"].message_type = _SPAN_ATTRIBUTES
+_SPAN_TIMEEVENT_ANNOTATION.containing_type = _SPAN_TIMEEVENT
+_SPAN_TIMEEVENT_MESSAGEEVENT.fields_by_name[
+    "type"
+].enum_type = _SPAN_TIMEEVENT_MESSAGEEVENT_TYPE
+_SPAN_TIMEEVENT_MESSAGEEVENT.containing_type = _SPAN_TIMEEVENT
+_SPAN_TIMEEVENT_MESSAGEEVENT_TYPE.containing_type = _SPAN_TIMEEVENT_MESSAGEEVENT
+_SPAN_TIMEEVENT.fields_by_name[
+    "time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SPAN_TIMEEVENT.fields_by_name["annotation"].message_type = _SPAN_TIMEEVENT_ANNOTATION
+_SPAN_TIMEEVENT.fields_by_name[
+    "message_event"
+].message_type = _SPAN_TIMEEVENT_MESSAGEEVENT
+_SPAN_TIMEEVENT.containing_type = _SPAN
+_SPAN_TIMEEVENT.oneofs_by_name["value"].fields.append(
+    _SPAN_TIMEEVENT.fields_by_name["annotation"]
+)
+_SPAN_TIMEEVENT.fields_by_name[
+    "annotation"
+].containing_oneof = _SPAN_TIMEEVENT.oneofs_by_name["value"]
+_SPAN_TIMEEVENT.oneofs_by_name["value"].fields.append(
+    _SPAN_TIMEEVENT.fields_by_name["message_event"]
+)
+_SPAN_TIMEEVENT.fields_by_name[
+    "message_event"
+].containing_oneof = _SPAN_TIMEEVENT.oneofs_by_name["value"]
+_SPAN_TIMEEVENTS.fields_by_name["time_event"].message_type = _SPAN_TIMEEVENT
+_SPAN_TIMEEVENTS.containing_type = _SPAN
+_SPAN_LINK.fields_by_name["type"].enum_type = _SPAN_LINK_TYPE
+_SPAN_LINK.fields_by_name["attributes"].message_type = _SPAN_ATTRIBUTES
+_SPAN_LINK.containing_type = _SPAN
+_SPAN_LINK_TYPE.containing_type = _SPAN_LINK
+_SPAN_LINKS.fields_by_name["link"].message_type = _SPAN_LINK
+_SPAN_LINKS.containing_type = _SPAN
+_SPAN.fields_by_name["display_name"].message_type = _TRUNCATABLESTRING
+_SPAN.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SPAN.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SPAN.fields_by_name["attributes"].message_type = _SPAN_ATTRIBUTES
+_SPAN.fields_by_name["stack_trace"].message_type = _STACKTRACE
+_SPAN.fields_by_name["time_events"].message_type = _SPAN_TIMEEVENTS
+_SPAN.fields_by_name["links"].message_type = _SPAN_LINKS
+_SPAN.fields_by_name["status"].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_SPAN.fields_by_name[
+    "same_process_as_parent_span"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_SPAN.fields_by_name[
+    "child_span_count"
+].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_ATTRIBUTEVALUE.fields_by_name["string_value"].message_type = _TRUNCATABLESTRING
+_ATTRIBUTEVALUE.oneofs_by_name["value"].fields.append(
+    _ATTRIBUTEVALUE.fields_by_name["string_value"]
+)
+_ATTRIBUTEVALUE.fields_by_name[
+    "string_value"
+].containing_oneof = _ATTRIBUTEVALUE.oneofs_by_name["value"]
+_ATTRIBUTEVALUE.oneofs_by_name["value"].fields.append(
+    _ATTRIBUTEVALUE.fields_by_name["int_value"]
+)
+_ATTRIBUTEVALUE.fields_by_name[
+    "int_value"
+].containing_oneof = _ATTRIBUTEVALUE.oneofs_by_name["value"]
+_ATTRIBUTEVALUE.oneofs_by_name["value"].fields.append(
+    _ATTRIBUTEVALUE.fields_by_name["bool_value"]
+)
+_ATTRIBUTEVALUE.fields_by_name[
+    "bool_value"
+].containing_oneof = _ATTRIBUTEVALUE.oneofs_by_name["value"]
+_STACKTRACE_STACKFRAME.fields_by_name["function_name"].message_type = _TRUNCATABLESTRING
+_STACKTRACE_STACKFRAME.fields_by_name[
+    "original_function_name"
+].message_type = _TRUNCATABLESTRING
+_STACKTRACE_STACKFRAME.fields_by_name["file_name"].message_type = _TRUNCATABLESTRING
+_STACKTRACE_STACKFRAME.fields_by_name["load_module"].message_type = _MODULE
+_STACKTRACE_STACKFRAME.fields_by_name[
+    "source_version"
+].message_type = _TRUNCATABLESTRING
+_STACKTRACE_STACKFRAME.containing_type = _STACKTRACE
+_STACKTRACE_STACKFRAMES.fields_by_name["frame"].message_type = _STACKTRACE_STACKFRAME
+_STACKTRACE_STACKFRAMES.containing_type = _STACKTRACE
+_STACKTRACE.fields_by_name["stack_frames"].message_type = _STACKTRACE_STACKFRAMES
+_MODULE.fields_by_name["module"].message_type = _TRUNCATABLESTRING
+_MODULE.fields_by_name["build_id"].message_type = _TRUNCATABLESTRING
+DESCRIPTOR.message_types_by_name["Span"] = _SPAN
+DESCRIPTOR.message_types_by_name["AttributeValue"] = _ATTRIBUTEVALUE
+DESCRIPTOR.message_types_by_name["StackTrace"] = _STACKTRACE
+DESCRIPTOR.message_types_by_name["Module"] = _MODULE
+DESCRIPTOR.message_types_by_name["TruncatableString"] = _TRUNCATABLESTRING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Span = _reflection.GeneratedProtocolMessageType(
+    "Span",
+    (_message.Message,),
+    dict(
+        Attributes=_reflection.GeneratedProtocolMessageType(
+            "Attributes",
+            (_message.Message,),
+            dict(
+                AttributeMapEntry=_reflection.GeneratedProtocolMessageType(
+                    "AttributeMapEntry",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY,
+                        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2"
+                        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.Attributes.AttributeMapEntry)
+                    ),
+                ),
+                DESCRIPTOR=_SPAN_ATTRIBUTES,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""A set of attributes, each in the format ``[KEY]:[VALUE]``.
+    
+    
+    Attributes:
+        attribute_map:
+            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:  ::      "/instance_id": "my-instance"
+            "/http/user_agent": ""     "/http/request_bytes": 300
+            "abc.com/myattribute": true
+        dropped_attributes_count:
+            The number of attributes that were discarded. Attributes can
+            be discarded because their keys are too long or because there
+            are too many attributes. If this value is 0 then all
+            attributes are valid.
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.Attributes)
+            ),
+        ),
+        TimeEvent=_reflection.GeneratedProtocolMessageType(
+            "TimeEvent",
+            (_message.Message,),
+            dict(
+                Annotation=_reflection.GeneratedProtocolMessageType(
+                    "Annotation",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SPAN_TIMEEVENT_ANNOTATION,
+                        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                        __doc__="""Text annotation with a set of attributes.
+      
+      
+      Attributes:
+          description:
+              A user-supplied message describing the event. The maximum
+              length for the description is 256 bytes.
+          attributes:
+              A set of attributes on the annotation. You can have up to 4
+              attributes per Annotation.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.TimeEvent.Annotation)
+                    ),
+                ),
+                MessageEvent=_reflection.GeneratedProtocolMessageType(
+                    "MessageEvent",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SPAN_TIMEEVENT_MESSAGEEVENT,
+                        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                        __doc__="""An event describing a message sent/received between Spans.
+      
+      
+      Attributes:
+          type:
+              Type of MessageEvent. Indicates whether the message was sent
+              or received.
+          id:
+              An identifier for the MessageEvent's message that can be used
+              to match SENT and RECEIVED MessageEvents. It is recommended to
+              be unique within a Span.
+          uncompressed_size_bytes:
+              The number of uncompressed bytes sent or received.
+          compressed_size_bytes:
+              The number of compressed bytes sent or received. If missing
+              assumed to be the same size as uncompressed.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.TimeEvent.MessageEvent)
+                    ),
+                ),
+                DESCRIPTOR=_SPAN_TIMEEVENT,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""A time-stamped annotation or message event in the Span.
+    
+    
+    Attributes:
+        time:
+            The timestamp indicating the time the event occurred.
+        value:
+            A ``TimeEvent`` can contain either an ``Annotation`` object or
+            a ``MessageEvent`` object, but not both.
+        annotation:
+            Text annotation with a set of attributes.
+        message_event:
+            An event describing a message sent/received between Spans.
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.TimeEvent)
+            ),
+        ),
+        TimeEvents=_reflection.GeneratedProtocolMessageType(
+            "TimeEvents",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPAN_TIMEEVENTS,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""A collection of ``TimeEvent``\ s. A ``TimeEvent`` is a time-stamped
+    annotation on the span, consisting of either user-supplied key:value
+    pairs, or details of a message sent/received between Spans.
+    
+    
+    Attributes:
+        time_event:
+            A collection of ``TimeEvent``\ s.
+        dropped_annotations_count:
+            The number of dropped annotations in all the included time
+            events. If the value is 0, then no annotations were dropped.
+        dropped_message_events_count:
+            The number of dropped message events in all the included time
+            events. If the value is 0, then no message events were
+            dropped.
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.TimeEvents)
+            ),
+        ),
+        Link=_reflection.GeneratedProtocolMessageType(
+            "Link",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPAN_LINK,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""A pointer from the current span to another span in the same trace or in
+    a different trace. For example, this can be used in batching operations,
+    where a single batch handler processes multiple requests from different
+    traces or when the handler receives a request from a different project.
+    
+    
+    Attributes:
+        trace_id:
+            The [TRACE\_ID] for a trace within a project.
+        span_id:
+            The [SPAN\_ID] for a span within a trace.
+        type:
+            The relationship of the current span relative to the linked
+            span.
+        attributes:
+            A set of attributes on the link. You have have up to 32
+            attributes per link.
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.Link)
+            ),
+        ),
+        Links=_reflection.GeneratedProtocolMessageType(
+            "Links",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SPAN_LINKS,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""A collection of links, which are references from this span to a span in
+    the same or different trace.
+    
+    
+    Attributes:
+        link:
+            A collection of links.
+        dropped_links_count:
+            The number of dropped links after the maximum size was
+            enforced. If this value is 0, then no links were dropped.
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span.Links)
+            ),
+        ),
+        DESCRIPTOR=_SPAN,
+        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+        __doc__="""A span represents a single operation within a trace. Spans can be nested
+  to form a trace tree. Often, a trace contains a root span that describes
+  the end-to-end latency, and one or more subspans for its sub-operations.
+  A trace can also contain multiple root spans, or none at all. Spans do
+  not need to be contiguous—there may be gaps or overlaps between spans in
+  a trace.
+  
+  
+  Attributes:
+      name:
+          The resource name of the span in the following format:  ::
+          projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+          [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 is a 16-character hexadecimal encoding of
+          an 8-byte array.
+      span_id:
+          The [SPAN\_ID] portion of the span's resource name.
+      parent_span_id:
+          The [SPAN\_ID] of this span's parent span. If this is a root
+          span, then this field must be empty.
+      display_name:
+          A description of the span's operation (up to 128 bytes).
+          Stackdriver Trace displays the description in the {% dynamic
+          print site\_values.console\_name %}. 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.
+      start_time:
+          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.
+      end_time:
+          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.
+      attributes:
+          A set of attributes on the span. You can have up to 32
+          attributes per span.
+      stack_trace:
+          Stack trace captured at the start of the span.
+      time_events:
+          A set of time events. You can have up to 32 annotations and
+          128 message events per span.
+      links:
+          Links associated with the span. You can have up to 128 links
+          per Span.
+      status:
+          An optional final status for this span.
+      same_process_as_parent_span:
+          (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.
+      child_span_count:
+          An optional number of child spans that were generated while
+          this span was active. If set, allows implementation to detect
+          missing child spans.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Span)
+    ),
+)
+_sym_db.RegisterMessage(Span)
+_sym_db.RegisterMessage(Span.Attributes)
+_sym_db.RegisterMessage(Span.Attributes.AttributeMapEntry)
+_sym_db.RegisterMessage(Span.TimeEvent)
+_sym_db.RegisterMessage(Span.TimeEvent.Annotation)
+_sym_db.RegisterMessage(Span.TimeEvent.MessageEvent)
+_sym_db.RegisterMessage(Span.TimeEvents)
+_sym_db.RegisterMessage(Span.Link)
+_sym_db.RegisterMessage(Span.Links)
+
+AttributeValue = _reflection.GeneratedProtocolMessageType(
+    "AttributeValue",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ATTRIBUTEVALUE,
+        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+        __doc__="""The allowed types for [VALUE] in a ``[KEY]:[VALUE]`` attribute.
+  
+  
+  Attributes:
+      value:
+          The type of the value.
+      string_value:
+          A string up to 256 bytes long.
+      int_value:
+          A 64-bit signed integer.
+      bool_value:
+          A Boolean value represented by ``true`` or ``false``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.AttributeValue)
+    ),
+)
+_sym_db.RegisterMessage(AttributeValue)
+
+StackTrace = _reflection.GeneratedProtocolMessageType(
+    "StackTrace",
+    (_message.Message,),
+    dict(
+        StackFrame=_reflection.GeneratedProtocolMessageType(
+            "StackFrame",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STACKTRACE_STACKFRAME,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""Represents a single stack frame in a stack trace.
+    
+    
+    Attributes:
+        function_name:
+            The fully-qualified name that uniquely identifies the function
+            or method that is active in this frame (up to 1024 bytes).
+        original_function_name:
+            An un-mangled function name, if ``function_name`` is `mangled
+            <http://www.avabodh.com/cxxin/namemangling.html>`__. The name
+            can be fully-qualified (up to 1024 bytes).
+        file_name:
+            The name of the source file where the function call appears
+            (up to 256 bytes).
+        line_number:
+            The line number in ``file_name`` where the function call
+            appears.
+        column_number:
+            The column number where the function call appears, if
+            available. This is important in JavaScript because of its
+            anonymous functions.
+        load_module:
+            The binary module from where the code was loaded.
+        source_version:
+            The version of the deployed source code (up to 128 bytes).
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.StackTrace.StackFrame)
+            ),
+        ),
+        StackFrames=_reflection.GeneratedProtocolMessageType(
+            "StackFrames",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_STACKTRACE_STACKFRAMES,
+                __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+                __doc__="""A collection of stack frames, which can be truncated.
+    
+    
+    Attributes:
+        frame:
+            Stack frames in this call stack.
+        dropped_frames_count:
+            The number of stack frames that were dropped because there
+            were too many stack frames. If this value is 0, then no stack
+            frames were dropped.
+    """,
+                # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.StackTrace.StackFrames)
+            ),
+        ),
+        DESCRIPTOR=_STACKTRACE,
+        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+        __doc__="""A call stack appearing in a trace.
+  
+  
+  Attributes:
+      stack_frames:
+          Stack frames in this stack trace. A maximum of 128 frames are
+          allowed.
+      stack_trace_hash_id:
+          The hash ID is used to conserve network bandwidth for
+          duplicate stack traces within a single trace.  Often multiple
+          spans will have identical stack traces. The first occurrence
+          of a stack trace should contain both the ``stackFrame``
+          content and a value in ``stackTraceHashId``.  Subsequent spans
+          within the same request can refer to that stack trace by only
+          setting ``stackTraceHashId``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.StackTrace)
+    ),
+)
+_sym_db.RegisterMessage(StackTrace)
+_sym_db.RegisterMessage(StackTrace.StackFrame)
+_sym_db.RegisterMessage(StackTrace.StackFrames)
+
+Module = _reflection.GeneratedProtocolMessageType(
+    "Module",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_MODULE,
+        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+        __doc__="""Binary module.
+  
+  
+  Attributes:
+      module:
+          For example: main binary, kernel modules, and dynamic
+          libraries such as libc.so, sharedlib.so (up to 256 bytes).
+      build_id:
+          A unique identifier for the module, usually a hash of its
+          contents (up to 128 bytes).
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.Module)
+    ),
+)
+_sym_db.RegisterMessage(Module)
+
+TruncatableString = _reflection.GeneratedProtocolMessageType(
+    "TruncatableString",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRUNCATABLESTRING,
+        __module__="google.devtools.cloudtrace_v2.proto.trace_pb2",
+        __doc__="""Represents a string that might be shortened to a specified length.
+  
+  
+  Attributes:
+      value:
+          The shortened string. For example, if the original string is
+          500 bytes long and the limit of the string is 128 bytes, then
+          ``value`` contains the first 128 bytes of the 500-byte string.
+          Truncation always happens on a UTF8 character boundary. If
+          there are multi-byte characters in the string, then the length
+          of the shortened string might be less than the size limit.
+      truncated_byte_count:
+          The number of bytes removed from the original string. If this
+          value is 0, then the string was not shortened.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.TruncatableString)
+    ),
+)
+_sym_db.RegisterMessage(TruncatableString)
+
+
+DESCRIPTOR._options = None
+_SPAN_ATTRIBUTES_ATTRIBUTEMAPENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/trace/google/cloud/trace_v2/proto/trace_pb2_grpc.py b/trace/google/cloud/trace_v2/proto/trace_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/trace/google/cloud/trace_v2/proto/trace_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/trace/google/cloud/trace_v2/proto/tracing.proto b/trace/google/cloud/trace_v2/proto/tracing.proto
new file mode 100644
index 000000000000..2990d4606a6b
--- /dev/null
+++ b/trace/google/cloud/trace_v2/proto/tracing.proto
@@ -0,0 +1,64 @@
+// 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.cloudtrace.v2;
+
+import "google/api/annotations.proto";
+import "google/devtools/cloudtrace/v2/trace.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Trace.V2";
+option go_package = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace";
+option java_multiple_files = true;
+option java_outer_classname = "TracingProto";
+option java_package = "com.google.devtools.cloudtrace.v2";
+option php_namespace = "Google\\Cloud\\Trace\\V2";
+
+// This file describes an API for collecting and viewing traces and spans
+// within a trace.  A Trace is a collection of spans corresponding to a single
+// operation or set of operations for an application. A span is an individual
+// timed event which forms a node of the trace tree. A single trace may
+// contain span(s) from multiple services.
+service TraceService {
+  // Sends new spans to new or existing traces. You cannot update
+  // existing spans.
+  rpc BatchWriteSpans(BatchWriteSpansRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*}/traces:batchWrite"
+      body: "*"
+    };
+  }
+
+  // Creates a new span.
+  rpc CreateSpan(Span) returns (Span) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/traces/*}/spans"
+      body: "*"
+    };
+  }
+}
+
+// The request message for the `BatchWriteSpans` method.
+message BatchWriteSpansRequest {
+  // Required. The name of the project where the spans belong. The format is
+  // `projects/[PROJECT_ID]`.
+  string name = 1;
+
+  // A list of new spans. The span names must not match existing
+  // spans, or the results are undefined.
+  repeated Span spans = 2;
+}
diff --git a/trace/google/cloud/trace_v2/proto/tracing_pb2.py b/trace/google/cloud/trace_v2/proto/tracing_pb2.py
new file mode 100644
index 000000000000..fa3989d8f725
--- /dev/null
+++ b/trace/google/cloud/trace_v2/proto/tracing_pb2.py
@@ -0,0 +1,169 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/devtools/cloudtrace_v2/proto/tracing.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.trace_v2.proto import (
+    trace_pb2 as google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/devtools/cloudtrace_v2/proto/tracing.proto",
+    package="google.devtools.cloudtrace.v2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.devtools.cloudtrace.v2B\014TracingProtoP\001ZGgoogle.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace\252\002\025Google.Cloud.Trace.V2\312\002\025Google\\Cloud\\Trace\\V2"
+    ),
+    serialized_pb=_b(
+        '\n1google/devtools/cloudtrace_v2/proto/tracing.proto\x12\x1dgoogle.devtools.cloudtrace.v2\x1a\x1cgoogle/api/annotations.proto\x1a/google/devtools/cloudtrace_v2/proto/trace.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto"Z\n\x16\x42\x61tchWriteSpansRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x32\n\x05spans\x18\x02 \x03(\x0b\x32#.google.devtools.cloudtrace.v2.Span2\xaf\x02\n\x0cTraceService\x12\x94\x01\n\x0f\x42\x61tchWriteSpans\x12\x35.google.devtools.cloudtrace.v2.BatchWriteSpansRequest\x1a\x16.google.protobuf.Empty"2\x82\xd3\xe4\x93\x02,"\'/v2/{name=projects/*}/traces:batchWrite:\x01*\x12\x87\x01\n\nCreateSpan\x12#.google.devtools.cloudtrace.v2.Span\x1a#.google.devtools.cloudtrace.v2.Span"/\x82\xd3\xe4\x93\x02)"$/v2/{name=projects/*/traces/*}/spans:\x01*B\xac\x01\n!com.google.devtools.cloudtrace.v2B\x0cTracingProtoP\x01ZGgoogle.golang.org/genproto/googleapis/devtools/cloudtrace/v2;cloudtrace\xaa\x02\x15Google.Cloud.Trace.V2\xca\x02\x15Google\\Cloud\\Trace\\V2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_BATCHWRITESPANSREQUEST = _descriptor.Descriptor(
+    name="BatchWriteSpansRequest",
+    full_name="google.devtools.cloudtrace.v2.BatchWriteSpansRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.devtools.cloudtrace.v2.BatchWriteSpansRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spans",
+            full_name="google.devtools.cloudtrace.v2.BatchWriteSpansRequest.spans",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=225,
+    serialized_end=315,
+)
+
+_BATCHWRITESPANSREQUEST.fields_by_name[
+    "spans"
+].message_type = google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2._SPAN
+DESCRIPTOR.message_types_by_name["BatchWriteSpansRequest"] = _BATCHWRITESPANSREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+BatchWriteSpansRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchWriteSpansRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHWRITESPANSREQUEST,
+        __module__="google.devtools.cloudtrace_v2.proto.tracing_pb2",
+        __doc__="""The request message for the ``BatchWriteSpans`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The name of the project where the spans belong. The
+          format is ``projects/[PROJECT_ID]``.
+      spans:
+          A list of new spans. The span names must not match existing
+          spans, or the results are undefined.
+  """,
+        # @@protoc_insertion_point(class_scope:google.devtools.cloudtrace.v2.BatchWriteSpansRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchWriteSpansRequest)
+
+
+DESCRIPTOR._options = None
+
+_TRACESERVICE = _descriptor.ServiceDescriptor(
+    name="TraceService",
+    full_name="google.devtools.cloudtrace.v2.TraceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=318,
+    serialized_end=621,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="BatchWriteSpans",
+            full_name="google.devtools.cloudtrace.v2.TraceService.BatchWriteSpans",
+            index=0,
+            containing_service=None,
+            input_type=_BATCHWRITESPANSREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002,\"'/v2/{name=projects/*}/traces:batchWrite:\001*"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateSpan",
+            full_name="google.devtools.cloudtrace.v2.TraceService.CreateSpan",
+            index=1,
+            containing_service=None,
+            input_type=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2._SPAN,
+            output_type=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2._SPAN,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v2/{name=projects/*/traces/*}/spans:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_TRACESERVICE)
+
+DESCRIPTOR.services_by_name["TraceService"] = _TRACESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/trace/google/cloud/trace_v2/proto/tracing_pb2_grpc.py b/trace/google/cloud/trace_v2/proto/tracing_pb2_grpc.py
new file mode 100644
index 000000000000..dcc08852bd85
--- /dev/null
+++ b/trace/google/cloud/trace_v2/proto/tracing_pb2_grpc.py
@@ -0,0 +1,79 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.trace_v2.proto import (
+    trace_pb2 as google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2,
+)
+from google.cloud.trace_v2.proto import (
+    tracing_pb2 as google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_tracing__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class TraceServiceStub(object):
+    """This file describes an API for collecting and viewing traces and spans
+  within a trace.  A Trace is a collection of spans corresponding to a single
+  operation or set of operations for an application. A span is an individual
+  timed event which forms a node of the trace tree. A single trace may
+  contain span(s) from multiple services.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.BatchWriteSpans = channel.unary_unary(
+            "/google.devtools.cloudtrace.v2.TraceService/BatchWriteSpans",
+            request_serializer=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_tracing__pb2.BatchWriteSpansRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateSpan = channel.unary_unary(
+            "/google.devtools.cloudtrace.v2.TraceService/CreateSpan",
+            request_serializer=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2.Span.SerializeToString,
+            response_deserializer=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2.Span.FromString,
+        )
+
+
+class TraceServiceServicer(object):
+    """This file describes an API for collecting and viewing traces and spans
+  within a trace.  A Trace is a collection of spans corresponding to a single
+  operation or set of operations for an application. A span is an individual
+  timed event which forms a node of the trace tree. A single trace may
+  contain span(s) from multiple services.
+  """
+
+    def BatchWriteSpans(self, request, context):
+        """Sends new spans to new or existing traces. You cannot update
+    existing spans.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateSpan(self, request, context):
+        """Creates a new span.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_TraceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "BatchWriteSpans": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchWriteSpans,
+            request_deserializer=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_tracing__pb2.BatchWriteSpansRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateSpan": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateSpan,
+            request_deserializer=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2.Span.FromString,
+            response_serializer=google_dot_devtools_dot_cloudtrace__v2_dot_proto_dot_trace__pb2.Span.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.devtools.cloudtrace.v2.TraceService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/trace/google/cloud/trace_v2/types.py b/trace/google/cloud/trace_v2/types.py
new file mode 100644
index 000000000000..f6c6af03351e
--- /dev/null
+++ b/trace/google/cloud/trace_v2/types.py
@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.trace_v2.proto import trace_pb2
+from google.cloud.trace_v2.proto import tracing_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [any_pb2, empty_pb2, timestamp_pb2, wrappers_pb2, status_pb2]
+
+_local_modules = [trace_pb2, tracing_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.trace_v2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/trace/noxfile.py b/trace/noxfile.py
new file mode 100644
index 000000000000..b6423e7bf20f
--- /dev/null
+++ b/trace/noxfile.py
@@ -0,0 +1,168 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Additional setup for VPCSC system tests
+    env = {
+        "PROJECT_ID": os.environ.get(
+            "PROJECT_ID"
+        ),
+        "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT": "secure-gcp-test-project-4",
+    }
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, env=env, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, env=env, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install('-e', '.')
+    session.install('sphinx', 'alabaster', 'recommonmark')
+
+    shutil.rmtree(os.path.join('docs', '_build'), ignore_errors=True)
+    session.run(
+        'sphinx-build',
+        '-W',  # warnings as errors
+        '-T',  # show full traceback on exception
+        '-N',  # no colors
+        '-b', 'html',
+        '-d', os.path.join('docs', '_build', 'doctrees', ''),
+        os.path.join('docs', ''),
+        os.path.join('docs', '_build', 'html', ''),
+    )
diff --git a/trace/setup.cfg b/trace/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/trace/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/trace/setup.py b/trace/setup.py
new file mode 100644
index 000000000000..d9c84832df9b
--- /dev/null
+++ b/trace/setup.py
@@ -0,0 +1,90 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-trace'
+description = 'Stackdriver Trace API client library'
+version = '0.22.1'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    'google-api-core[grpc] >= 1.14.0, < 2.0.0dev',
+    "google-cloud-core >= 1.0.0, < 2.0dev",
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/trace/synth.metadata b/trace/synth.metadata
new file mode 100644
index 000000000000..c3bfe0244394
--- /dev/null
+++ b/trace/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:44:36.453837Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "trace",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/devtools/cloudtrace/artman_cloudtrace_v1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "trace",
+        "apiVersion": "v2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/devtools/cloudtrace/artman_cloudtrace_v2.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/trace/synth.py b/trace/synth.py
new file mode 100644
index 000000000000..7e6ec0478e42
--- /dev/null
+++ b/trace/synth.py
@@ -0,0 +1,54 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+import synthtool.gcp as gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Generate trace GAPIC layer
+# ----------------------------------------------------------------------------
+for version in ["v1", "v2"]:
+    library = gapic.py_library(
+        "trace",
+        version,
+        config_path=f"/google/devtools/cloudtrace" f"/artman_cloudtrace_{version}.yaml",
+        artman_output_name=f"trace-{version}",
+        include_protos=True,
+    )
+
+    s.move(library / f"google/cloud/trace_{version}")
+    s.move(library / f"tests/unit/gapic/{version}")
+
+    # Fix up imports
+    s.replace(
+        "google/**/*.py",
+        f"from google.devtools.cloudtrace_{version}.proto import ",
+        f"from google.cloud.trace_{version}.proto import ",
+    )
+
+# Copy docs configuration
+s.move(library / f"docs/conf.py")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files, excludes=["noxfile.py"])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/trace/tests/__init__.py b/trace/tests/__init__.py
new file mode 100644
index 000000000000..ab6729095248
--- /dev/null
+++ b/trace/tests/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/trace/tests/system/gapic/v1/test_system_trace_service_v1.py b/trace/tests/system/gapic/v1/test_system_trace_service_v1.py
new file mode 100644
index 000000000000..bfdba136f869
--- /dev/null
+++ b/trace/tests/system/gapic/v1/test_system_trace_service_v1.py
@@ -0,0 +1,30 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import trace_v1
+from google.cloud.trace_v1 import enums
+from google.cloud.trace_v1.proto import trace_pb2
+from google.protobuf import timestamp_pb2
+
+
+class TestSystemTraceService(object):
+    def test_list_traces(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = trace_v1.TraceServiceClient()
+        project_id_2 = project_id
+        response = client.list_traces(project_id_2)
diff --git a/trace/tests/system/gapic/v1/test_system_trace_service_v1_vpcsc.py b/trace/tests/system/gapic/v1/test_system_trace_service_v1_vpcsc.py
new file mode 100644
index 000000000000..d7dabcb24887
--- /dev/null
+++ b/trace/tests/system/gapic/v1/test_system_trace_service_v1_vpcsc.py
@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# flake8: noqa
+
+import os
+import pytest
+
+from google.api_core import exceptions
+from google.cloud import trace_v1
+
+PROJECT_INSIDE = os.environ.get("PROJECT_ID", None)
+PROJECT_OUTSIDE = os.environ.get(
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT", None
+)
+
+
+class TestVPCServiceControlV1(object):
+    @staticmethod
+    def _is_rejected(call):
+        try:
+            responses = call()
+        except exceptions.PermissionDenied as e:
+            return e.message == "Request is prohibited by organization's policy"
+        except:
+            return False
+        return False
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_list_traces(self):
+        client = trace_v1.TraceServiceClient()
+
+        list_inside = lambda: list(client.list_traces(PROJECT_INSIDE))
+        list_outside = lambda: list(client.list_traces(PROJECT_OUTSIDE))
+
+        assert not TestVPCServiceControlV1._is_rejected(list_inside)
+        assert TestVPCServiceControlV1._is_rejected(list_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_get_trace(self):
+        client = trace_v1.TraceServiceClient()
+
+        get_inside = lambda: client.get_trace(PROJECT_INSIDE, "")
+        get_outside = lambda: client.get_trace(PROJECT_OUTSIDE, "")
+
+        assert not TestVPCServiceControlV1._is_rejected(get_inside)
+        assert TestVPCServiceControlV1._is_rejected(get_outside)
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_patch_traces(self):
+        client = trace_v1.TraceServiceClient()
+
+        patch_inside = lambda: client.patch_traces(PROJECT_INSIDE, {})
+        patch_outside = lambda: client.patch_traces(PROJECT_OUTSIDE, {})
+
+        assert not TestVPCServiceControlV1._is_rejected(patch_inside)
+        assert TestVPCServiceControlV1._is_rejected(patch_outside)
diff --git a/trace/tests/system/gapic/v2/test_system_trace_service_v2.py b/trace/tests/system/gapic/v2/test_system_trace_service_v2.py
new file mode 100644
index 000000000000..fb42ca7ba46a
--- /dev/null
+++ b/trace/tests/system/gapic/v2/test_system_trace_service_v2.py
@@ -0,0 +1,30 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import time
+
+from google.cloud import trace_v2
+from google.cloud.trace_v2.proto import trace_pb2
+from google.cloud.trace_v2.proto import tracing_pb2
+
+
+class TestSystemTraceService(object):
+    def test_batch_write_spans(self):
+        project_id = os.environ["PROJECT_ID"]
+
+        client = trace_v2.TraceServiceClient()
+        name = client.project_path(project_id)
+        spans = []
+        client.batch_write_spans(name, spans)
diff --git a/trace/tests/system/gapic/v2/test_system_trace_service_v2_vpcsc.py b/trace/tests/system/gapic/v2/test_system_trace_service_v2_vpcsc.py
new file mode 100644
index 000000000000..2f34849c5929
--- /dev/null
+++ b/trace/tests/system/gapic/v2/test_system_trace_service_v2_vpcsc.py
@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# flake8: noqa
+
+import os
+import pytest
+
+from google.api_core import exceptions
+from google.cloud import trace_v2
+
+PROJECT_INSIDE = os.environ.get("PROJECT_ID", None)
+PROJECT_OUTSIDE = os.environ.get(
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT", None
+)
+
+
+class TestVPCServiceControlV2(object):
+    @staticmethod
+    def _is_rejected(call):
+        try:
+            responses = call()
+        except exceptions.PermissionDenied as e:
+            return e.message == "Request is prohibited by organization's policy"
+        except:
+            pass
+        return False
+
+    @pytest.mark.skipif(
+        PROJECT_INSIDE is None, reason="Missing environment variable: PROJECT_ID"
+    )
+    @pytest.mark.skipif(
+        PROJECT_OUTSIDE is None,
+        reason="Missing environment variable: GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT",
+    )
+    def test_batch_write_spans(self):
+        client = trace_v2.TraceServiceClient()
+
+        proejct_inside = client.project_path(PROJECT_INSIDE)
+        proejct_outside = client.project_path(PROJECT_OUTSIDE)
+        spans = []
+
+        write_inside = lambda: client.batch_write_spans(proejct_inside, spans)
+        write_outside = lambda: client.batch_write_spans(proejct_outside, spans)
+
+        assert not TestVPCServiceControlV2._is_rejected(write_inside)
+        assert TestVPCServiceControlV2._is_rejected(write_outside)
diff --git a/trace/tests/unit/gapic/v1/test_trace_service_client_v1.py b/trace/tests/unit/gapic/v1/test_trace_service_client_v1.py
new file mode 100644
index 000000000000..3bbef437e65b
--- /dev/null
+++ b/trace/tests/unit/gapic/v1/test_trace_service_client_v1.py
@@ -0,0 +1,183 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import trace_v1
+from google.cloud.trace_v1.proto import trace_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestTraceServiceClient(object):
+    def test_patch_traces(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v1.TraceServiceClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        traces = {}
+
+        client.patch_traces(project_id, traces)
+
+        assert len(channel.requests) == 1
+        expected_request = trace_pb2.PatchTracesRequest(
+            project_id=project_id, traces=traces
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_patch_traces_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v1.TraceServiceClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        traces = {}
+
+        with pytest.raises(CustomException):
+            client.patch_traces(project_id, traces)
+
+    def test_get_trace(self):
+        # Setup Expected Response
+        project_id_2 = "projectId2939242356"
+        trace_id_2 = "traceId2987826376"
+        expected_response = {"project_id": project_id_2, "trace_id": trace_id_2}
+        expected_response = trace_pb2.Trace(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v1.TraceServiceClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+        trace_id = "traceId1270300245"
+
+        response = client.get_trace(project_id, trace_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = trace_pb2.GetTraceRequest(
+            project_id=project_id, trace_id=trace_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_trace_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v1.TraceServiceClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+        trace_id = "traceId1270300245"
+
+        with pytest.raises(CustomException):
+            client.get_trace(project_id, trace_id)
+
+    def test_list_traces(self):
+        # Setup Expected Response
+        next_page_token = ""
+        traces_element = {}
+        traces = [traces_element]
+        expected_response = {"next_page_token": next_page_token, "traces": traces}
+        expected_response = trace_pb2.ListTracesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v1.TraceServiceClient()
+
+        # Setup Request
+        project_id = "projectId-1969970175"
+
+        paged_list_response = client.list_traces(project_id)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.traces[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = trace_pb2.ListTracesRequest(project_id=project_id)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_traces_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v1.TraceServiceClient()
+
+        # Setup request
+        project_id = "projectId-1969970175"
+
+        paged_list_response = client.list_traces(project_id)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
diff --git a/trace/tests/unit/gapic/v2/test_trace_service_client_v2.py b/trace/tests/unit/gapic/v2/test_trace_service_client_v2.py
new file mode 100644
index 000000000000..e8df09a8de37
--- /dev/null
+++ b/trace/tests/unit/gapic/v2/test_trace_service_client_v2.py
@@ -0,0 +1,155 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import trace_v2
+from google.cloud.trace_v2.proto import trace_pb2
+from google.cloud.trace_v2.proto import tracing_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import timestamp_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestTraceServiceClient(object):
+    def test_batch_write_spans(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v2.TraceServiceClient()
+
+        # Setup Request
+        name = client.project_path("[PROJECT]")
+        spans = []
+
+        client.batch_write_spans(name, spans)
+
+        assert len(channel.requests) == 1
+        expected_request = tracing_pb2.BatchWriteSpansRequest(name=name, spans=spans)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_write_spans_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v2.TraceServiceClient()
+
+        # Setup request
+        name = client.project_path("[PROJECT]")
+        spans = []
+
+        with pytest.raises(CustomException):
+            client.batch_write_spans(name, spans)
+
+    def test_create_span(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        span_id_2 = "spanId2-643891741"
+        parent_span_id = "parentSpanId-1757797477"
+        expected_response = {
+            "name": name_2,
+            "span_id": span_id_2,
+            "parent_span_id": parent_span_id,
+        }
+        expected_response = trace_pb2.Span(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v2.TraceServiceClient()
+
+        # Setup Request
+        name = client.span_path("[PROJECT]", "[TRACE]", "[SPAN]")
+        span_id = "spanId-2011840976"
+        display_name = {}
+        start_time = {}
+        end_time = {}
+
+        response = client.create_span(name, span_id, display_name, start_time, end_time)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = trace_pb2.Span(
+            name=name,
+            span_id=span_id,
+            display_name=display_name,
+            start_time=start_time,
+            end_time=end_time,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_span_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = trace_v2.TraceServiceClient()
+
+        # Setup request
+        name = client.span_path("[PROJECT]", "[TRACE]", "[SPAN]")
+        span_id = "spanId-2011840976"
+        display_name = {}
+        start_time = {}
+        end_time = {}
+
+        with pytest.raises(CustomException):
+            client.create_span(name, span_id, display_name, start_time, end_time)
diff --git a/trace/tests/unit/v1/test__gapic_v1.py b/trace/tests/unit/v1/test__gapic_v1.py
new file mode 100644
index 000000000000..bd21f026d056
--- /dev/null
+++ b/trace/tests/unit/v1/test__gapic_v1.py
@@ -0,0 +1,245 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import unittest
+
+import mock
+
+
+class Test__TraceAPI(unittest.TestCase):
+    project = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        return _TraceAPI
+
+    def _make_one(self, gapic_client=None, handwritten_client=None):
+        from google.cloud.trace_v1.gapic import trace_service_client
+
+        if gapic_client is None:
+            gapic_client = mock.create_autospec(trace_service_client.TraceServiceClient)
+        if handwritten_client is None:
+            handwritten_client = mock.Mock()
+        api = self._get_target_class()(gapic_client, handwritten_client)
+        return api
+
+    def test_constructor(self):
+        from google.cloud.trace_v1.gapic import trace_service_client
+
+        gapic_client = mock.create_autospec(trace_service_client.TraceServiceClient)
+        api = self._make_one(gapic_client, mock.sentinel.client)
+        self.assertIs(api._gapic_api, gapic_client)
+        self.assertIs(api.client, mock.sentinel.client)
+
+    def test_patch_traces(self):
+        from google.cloud.trace_v1.gapic import trace_service_client
+        from google.cloud.trace.v1._gapic import _traces_mapping_to_pb
+
+        trace_id = "test_trace_id"
+        span_id = 1234
+        span_name = "test_span_name"
+        start_time = datetime.datetime.utcnow()
+        end_time = datetime.datetime.utcnow()
+        traces = {
+            "traces": [
+                {
+                    "projectId": self.project,
+                    "traceId": trace_id,
+                    "spans": [
+                        {
+                            "spanId": span_id,
+                            "name": span_name,
+                            "startTime": start_time.isoformat() + "Z",
+                            "endTime": end_time.isoformat() + "Z",
+                        }
+                    ],
+                }
+            ]
+        }
+        traces_pb = _traces_mapping_to_pb(traces)
+        gapic_api = mock.create_autospec(trace_service_client.TraceServiceClient)
+        api = self._make_one(gapic_api, None)
+
+        api.patch_traces(project_id=self.project, traces=traces)
+
+        gapic_api.patch_traces.assert_called_once_with(self.project, traces_pb)
+
+    def test_get_trace(self):
+        from google.cloud.trace_v1.gapic import trace_service_client
+        from google.cloud.trace_v1.proto.trace_pb2 import Trace
+
+        trace_id = "test_trace_id"
+        trace_pb = Trace(project_id=self.project, trace_id=trace_id)
+
+        gapic_api = mock.create_autospec(trace_service_client.TraceServiceClient)
+        gapic_api.get_trace.return_value = trace_pb
+        api = self._make_one(gapic_api, None)
+
+        trace = api.get_trace(project_id=self.project, trace_id=trace_id)
+
+        expected_trace = {"projectId": self.project, "traceId": trace_id}
+        self.assertEqual(trace, expected_trace)
+
+        gapic_api.get_trace.assert_called_with(self.project, trace_id)
+
+    def test_list_traces(self):
+        from google.api_core.page_iterator import GRPCIterator
+        from google.cloud.trace_v1.gapic import trace_service_client
+        from google.cloud.trace_v1.gapic.enums import ListTracesRequest as Enum
+        from google.cloud.trace.v1._gapic import _item_to_mapping
+
+        page_size = 10
+        view_type = Enum.ViewType.COMPLETE
+        page_token = "TOKEN"
+        gapic_api = mock.create_autospec(trace_service_client.TraceServiceClient)
+        response_iter = mock.create_autospec(GRPCIterator)
+        gapic_api.list_traces.return_value = response_iter
+        api = self._make_one(gapic_api)
+
+        iterator = api.list_traces(
+            project_id=self.project,
+            view=view_type,
+            page_size=page_size,
+            page_token=page_token,
+        )
+
+        self.assertIs(iterator, response_iter)
+        self.assertIs(iterator.item_to_value, _item_to_mapping)
+        self.assertEqual(iterator.next_page_token, page_token)
+
+        gapic_api.list_traces.assert_called_once_with(
+            project_id=self.project,
+            view=view_type,
+            page_size=page_size,
+            start_time=None,
+            end_time=None,
+            filter_=None,
+            order_by=None,
+        )
+
+
+class _TracePbBase(object):
+    project = u"PROJECT"
+    trace_id = u"test_trace_id"
+    span_id = 1234
+    span_name = u"test_span_name"
+    start_time = "2017-06-24T00:12:50.369990Z"
+    end_time = "2017-06-24T00:13:39.633255Z"
+    start_seconds = 1498263170
+    start_nanos = 369990000
+    end_seconds = 1498263219
+    end_nanos = 633255000
+
+    @classmethod
+    def _make_trace_pb(cls):
+        from google.cloud.trace_v1.proto.trace_pb2 import Trace
+        from google.cloud.trace_v1.proto.trace_pb2 import TraceSpan
+        from google.protobuf.timestamp_pb2 import Timestamp
+
+        start_time_pb = Timestamp(seconds=cls.start_seconds, nanos=cls.start_nanos)
+        end_time_pb = Timestamp(seconds=cls.end_seconds, nanos=cls.end_nanos)
+
+        span_pb = TraceSpan(
+            span_id=cls.span_id,
+            name=cls.span_name,
+            start_time=start_time_pb,
+            end_time=end_time_pb,
+        )
+
+        return Trace(project_id=cls.project, trace_id=cls.trace_id, spans=[span_pb])
+
+    @classmethod
+    def _expected_json(cls):
+        return {
+            "projectId": cls.project,
+            "traceId": cls.trace_id,
+            "spans": [
+                {
+                    "spanId": str(cls.span_id),
+                    "name": cls.span_name,
+                    "startTime": cls.start_time,
+                    "endTime": cls.end_time,
+                }
+            ],
+        }
+
+
+class Test__item_to_mapping(unittest.TestCase, _TracePbBase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.trace.v1._gapic import _item_to_mapping
+
+        return _item_to_mapping(*args, **kwargs)
+
+    def test_registered_type(self):
+        iterator = object()
+        trace_pb = self._make_trace_pb()
+
+        parsed_json = self._call_fut(iterator, trace_pb)
+
+        expected_result = self._expected_json()
+        self.assertEqual(parsed_json, expected_result)
+
+
+class Test__parse_trace_pb(unittest.TestCase, _TracePbBase):
+    @staticmethod
+    def _call_fut(*args, **kwargs):
+        from google.cloud.trace.v1._gapic import _parse_trace_pb
+
+        return _parse_trace_pb(*args, **kwargs)
+
+    def test_registered_type(self):
+        trace_pb = self._make_trace_pb()
+
+        parsed_json = self._call_fut(trace_pb)
+
+        expected_result = self._expected_json()
+        self.assertEqual(parsed_json, expected_result)
+
+    @mock.patch("google.cloud.trace.v1._gapic.MessageToDict", side_effect=TypeError)
+    def test_unregistered_type(self, msg_to_dict_mock):
+        trace_pb = mock.Mock(spec=["HasField"])
+        trace_pb.HasField.return_value = False
+        with self.assertRaises(TypeError):
+            self._call_fut(trace_pb)
+
+
+class Test_make_trace_api(unittest.TestCase):
+    def _call_fut(self, client):
+        from google.cloud.trace.v1._gapic import make_trace_api
+
+        return make_trace_api(client)
+
+    def test_it(self):
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        client = mock.Mock(spec=["_credentials", "_client_info"])
+
+        patch_api = mock.patch(
+            "google.cloud.trace.v1._gapic.trace_service_client.TraceServiceClient"
+        )
+
+        with patch_api as patched:
+            trace_api = self._call_fut(client)
+
+        patched.assert_called_once_with(
+            credentials=client._credentials, client_info=client._client_info
+        )
+
+        self.assertIsInstance(trace_api, _TraceAPI)
+        self.assertIs(trace_api._gapic_api, patched.return_value)
+        self.assertIs(trace_api.client, client)
diff --git a/trace/tests/unit/v1/test_client_v1.py b/trace/tests/unit/v1/test_client_v1.py
new file mode 100644
index 000000000000..d3e1c391592a
--- /dev/null
+++ b/trace/tests/unit/v1/test_client_v1.py
@@ -0,0 +1,279 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+
+    project = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.trace.v1.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        from google.api_core.gapic_v1.client_info import ClientInfo
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        self.assertEqual(client.project, self.project)
+        self.assertIsInstance(client._client_info, ClientInfo)
+
+    def test_constructor_explicit(self):
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.project, credentials=credentials, client_info=client_info
+        )
+        self.assertEqual(client.project, self.project)
+        self.assertIs(client._client_info, client_info)
+
+    def test_trace_api(self):
+        clients = []
+        api_obj = object()
+
+        def make_api(client_obj):
+            clients.append(client_obj)
+            return api_obj
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+
+        patch = mock.patch("google.cloud.trace.v1.client.make_trace_api", new=make_api)
+
+        with patch:
+            api = client.trace_api
+
+        self.assertIs(api, api_obj)
+        self.assertEqual(clients, [client])
+
+    def test_trace_api_existing(self):
+        """Check that the client caches _trace_api."""
+        client = self._make_one(project=self.project, credentials=_make_credentials())
+        client._trace_api = mock.sentinel.trace_api
+        self.assertIs(client.trace_api, mock.sentinel.trace_api)
+
+    def test_patch_traces_default(self):
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        traces = "fake_traces_for_test"
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.patch_traces = mock.Mock()
+        patch = mock.patch(
+            "google.cloud.trace.v1.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            client.patch_traces(traces=traces)
+
+        mock_trace_api.patch_traces.assert_called_with(
+            project_id="PROJECT", traces="fake_traces_for_test"
+        )
+
+    def test_patch_traces_explicit(self):
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        traces = "fake_traces_for_test"
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.patch_traces = mock.Mock()
+        patch = mock.patch(
+            "google.cloud.trace.v1.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            client.patch_traces(project_id=self.project, traces=traces)
+
+        mock_trace_api.patch_traces.assert_called_with(
+            project_id="PROJECT", traces="fake_traces_for_test"
+        )
+
+    def test_get_trace_default(self):
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        def get_trace(trace_id, project_id=None, options=None):
+            _get_trace_called_with = (trace_id, project_id, options)
+            return _get_trace_called_with
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        trace_id = "5e6e73b4131303cb6f5c9dfbaf104e33"
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.get_trace = get_trace
+        patch = mock.patch(
+            "google.cloud.trace.v1.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            get_trace_called_with = client.get_trace(trace_id=trace_id)
+
+        self.assertEqual(get_trace_called_with, (trace_id, self.project, None))
+
+    def test_get_trace_explicit(self):
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        def get_trace(trace_id, project_id=None, options=None):
+            _get_trace_called_with = (trace_id, project_id, options)
+            return _get_trace_called_with
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        trace_id = "5e6e73b4131303cb6f5c9dfbaf104e33"
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.get_trace = get_trace
+        patch = mock.patch(
+            "google.cloud.trace.v1.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            get_trace_called_with = client.get_trace(
+                trace_id=trace_id, project_id=self.project
+            )
+
+        self.assertEqual(get_trace_called_with, (trace_id, self.project, None))
+
+    def test_list_traces_default(self):
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        def list_traces(
+            project_id,
+            view=None,
+            page_size=None,
+            start_time=None,
+            end_time=None,
+            filter_=None,
+            order_by=None,
+            page_token=None,
+        ):
+            _list_traces_called_with = (
+                project_id,
+                view,
+                page_size,
+                start_time,
+                end_time,
+                filter_,
+                order_by,
+                page_token,
+            )
+            return _list_traces_called_with
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.list_traces = list_traces
+        patch = mock.patch(
+            "google.cloud.trace.v1.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            list_traces_called_with = client.list_traces()
+
+        self.assertEqual(
+            list_traces_called_with,
+            (self.project, None, None, None, None, None, None, None),
+        )
+
+    def test_list_traces_explicit(self):
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.trace_v1.gapic.enums import ListTracesRequest as Enum
+        from google.cloud.trace.v1._gapic import _TraceAPI
+
+        from datetime import datetime
+
+        def list_traces(
+            project_id,
+            view=None,
+            page_size=None,
+            start_time=None,
+            end_time=None,
+            filter_=None,
+            order_by=None,
+            page_token=None,
+        ):
+            _list_traces_called_with = (
+                project_id,
+                view,
+                page_size,
+                start_time,
+                end_time,
+                filter_,
+                order_by,
+                page_token,
+            )
+            return _list_traces_called_with
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.list_traces = list_traces
+        patch = mock.patch(
+            "google.cloud.trace.v1.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        view = Enum.ViewType.COMPLETE
+        page_size = 10
+        start_time = datetime.utcnow()
+        end_time = datetime.utcnow()
+        filter_ = "+span:span1"
+        order_by = "traceId"
+        page_token = "TOKEN"
+
+        with patch:
+            list_traces_called_with = client.list_traces(
+                project_id=self.project,
+                view=view,
+                page_size=page_size,
+                start_time=start_time,
+                end_time=end_time,
+                filter_=filter_,
+                order_by=order_by,
+                page_token=page_token,
+            )
+
+        self.assertEqual(
+            list_traces_called_with,
+            (
+                self.project,
+                view,
+                page_size,
+                _datetime_to_pb_timestamp(start_time),
+                _datetime_to_pb_timestamp(end_time),
+                filter_,
+                order_by,
+                page_token,
+            ),
+        )
diff --git a/trace/tests/unit/v2/test__gapic_v2.py b/trace/tests/unit/v2/test__gapic_v2.py
new file mode 100644
index 000000000000..e6859b5964ef
--- /dev/null
+++ b/trace/tests/unit/v2/test__gapic_v2.py
@@ -0,0 +1,290 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import unittest
+
+import mock
+
+
+def _str_to_truncatablestr(str_to_convert):
+    result = {"value": str_to_convert, "truncated_byte_count": 0}
+    return result
+
+
+class _Base(object):
+    from google.cloud.trace_v2.gapic import enums
+
+    # Set the constants used for tests
+    project = "PROJECT"
+    trace_id = "c801e4119a064c659fe052d88f1d461b"
+    span_id = "1234123412341234"
+    parent_span_id = "1111000011110000"
+    span_name = "projects/{}/traces/{}/spans/{}".format(project, trace_id, span_id)
+    start_time = datetime.datetime.utcnow()
+    end_time = datetime.datetime.utcnow()
+    type = enums.Span.TimeEvent.MessageEvent.Type.SENT
+    display_name = "test display name"
+
+    attributes = {
+        "attributeMap": {
+            "test_int_key": {"int_value": 123},
+            "test_str_key": {"string_value": _str_to_truncatablestr("str_value")},
+            "test_bool_key": {"bool_value": True},
+        }
+    }
+
+    st_function_name = "test function name"
+    st_origin_name = "test original name"
+    st_file_name = "test file name"
+    st_line_number = 12
+    st_column_number = 2
+    st_test_module = "test module"
+    st_build_id = "test build id"
+    st_source_version = "test source version"
+    stack_trace = {
+        "stack_frames": {
+            "frame": [
+                {
+                    "function_name": _str_to_truncatablestr(st_function_name),
+                    "original_function_name": _str_to_truncatablestr(st_origin_name),
+                    "file_name": _str_to_truncatablestr(st_file_name),
+                    "line_number": st_line_number,
+                    "column_number": st_column_number,
+                    "load_module": {
+                        "module": _str_to_truncatablestr(st_test_module),
+                        "build_id": _str_to_truncatablestr(st_build_id),
+                    },
+                    "source_version": _str_to_truncatablestr(st_source_version),
+                }
+            ],
+            "dropped_frames_count": 0,
+        },
+        "stack_trace_hash_id": 1234,
+    }
+
+    te_time = datetime.datetime.utcnow().isoformat() + "Z"
+    te_description = "test description"
+    time_events = {
+        "time_event": [
+            {
+                "time": te_time,
+                "annotation": {
+                    "description": _str_to_truncatablestr(te_description),
+                    "attributes": attributes,
+                },  # TimeEvent can contain either annotation
+                # or message_event
+            }
+        ],
+        "dropped_annotations_count": 0,
+        "dropped_message_events_count": 0,
+    }
+
+    link_span_id = "1111222211112222"
+    links = {
+        "link": [
+            {
+                "trace_id": trace_id,
+                "span_id": link_span_id,
+                "type": type,
+                "attributes": attributes,
+            }
+        ],
+        "dropped_links_count": 0,
+    }
+
+    status_code = 888
+    status_message = "test status message"
+    status = {"code": status_code, "message": status_message, "details": []}
+
+    same_process_as_parent_span = True
+    child_span_count = 0
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+
+class Test__TraceAPI(_Base, unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.trace._gapic import _TraceAPI
+
+        return _TraceAPI
+
+    def test_constructor(self):
+        gapic_api = object()
+        client = object()
+        api = self._make_one(gapic_api, client)
+        self.assertIs(api._gapic_api, gapic_api)
+        self.assertIs(api.client, client)
+
+    def test_batch_write_spans(self):
+        from google.cloud.trace_v2.gapic import trace_service_client
+        from google.cloud.trace._gapic import _dict_mapping_to_pb
+
+        spans = {
+            "spans": [
+                {
+                    "name": self.span_name,
+                    "span_id": self.span_id,
+                    "parent_span_id": self.parent_span_id,
+                    "display_name": _str_to_truncatablestr(self.display_name),
+                    "start_time": self.start_time.isoformat() + "Z",
+                    "end_time": self.end_time.isoformat() + "Z",
+                    "attributes": self.attributes,
+                    "stack_trace": self.stack_trace,
+                    "time_events": self.time_events,
+                    "links": self.links,
+                    "status": self.status,
+                    "same_process_as_parent_span": self.same_process_as_parent_span,
+                    "child_span_count": self.child_span_count,
+                }
+            ]
+        }
+
+        spans_pb_list = [_dict_mapping_to_pb(spans["spans"][0], "Span")]
+        project_name = "projects/{}".format(self.project)
+
+        gapic_api = mock.Mock(spec=trace_service_client.TraceServiceClient)
+        api = self._make_one(gapic_api, None)
+        retry = mock.Mock()
+        timeout = mock.Mock()
+        api.batch_write_spans(project_name, spans, retry, timeout)
+
+        gapic_api.batch_write_spans.assert_called_with(
+            name=project_name, spans=spans_pb_list, retry=retry, timeout=timeout
+        )
+
+    def test_create_span_default(self):
+        from google.cloud.trace_v2.gapic import trace_service_client
+        from google.cloud.trace._gapic import _dict_mapping_to_pb
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+
+        gapic_api = mock.Mock(spec=trace_service_client.TraceServiceClient)
+        api = self._make_one(gapic_api, None)
+        api.create_span(
+            name=self.span_name,
+            span_id=self.span_id,
+            display_name=_str_to_truncatablestr(self.display_name),
+            start_time=self.start_time,
+            end_time=self.end_time,
+        )
+
+        display_name_pb = _dict_mapping_to_pb(
+            _str_to_truncatablestr(self.display_name), "TruncatableString"
+        )
+        start_time_pb = _datetime_to_pb_timestamp(self.start_time)
+        end_time_pb = _datetime_to_pb_timestamp(self.end_time)
+
+        gapic_api.create_span.assert_called_with(
+            name=self.span_name,
+            span_id=self.span_id,
+            display_name=display_name_pb,
+            start_time=start_time_pb,
+            end_time=end_time_pb,
+            parent_span_id=None,
+            attributes=None,
+            stack_trace=None,
+            time_events=None,
+            links=None,
+            status=None,
+            same_process_as_parent_span=None,
+            child_span_count=None,
+        )
+
+    def test_create_span_explicit(self):
+        from google.cloud._helpers import _datetime_to_pb_timestamp
+        from google.cloud.trace._gapic import (
+            _dict_mapping_to_pb,
+            _span_attrs_to_pb,
+            _status_mapping_to_pb,
+            _value_to_pb,
+        )
+        from google.cloud.trace_v2.gapic import trace_service_client
+
+        gapic_api = mock.Mock(spec=trace_service_client.TraceServiceClient)
+        api = self._make_one(gapic_api, None)
+        api.create_span(
+            name=self.span_name,
+            span_id=self.span_id,
+            display_name=_str_to_truncatablestr(self.display_name),
+            start_time=self.start_time,
+            end_time=self.end_time,
+            parent_span_id=self.parent_span_id,
+            attributes=self.attributes,
+            stack_trace=self.stack_trace,
+            time_events=self.time_events,
+            links=self.links,
+            status=self.status,
+            same_process_as_parent_span=self.same_process_as_parent_span,
+            child_span_count=self.child_span_count,
+        )
+
+        display_name_pb = _dict_mapping_to_pb(
+            _str_to_truncatablestr(self.display_name), "TruncatableString"
+        )
+        start_time_pb = _datetime_to_pb_timestamp(self.start_time)
+        end_time_pb = _datetime_to_pb_timestamp(self.end_time)
+        attributes_pb = _span_attrs_to_pb(self.attributes, "Attributes")
+        stack_trace_pb = _dict_mapping_to_pb(self.stack_trace, "StackTrace")
+        time_events_pb = _span_attrs_to_pb(self.time_events, "TimeEvents")
+        links_pb = _span_attrs_to_pb(self.links, "Links")
+        status_pb = _status_mapping_to_pb(self.status)
+        same_process_as_parent_span_pb = _value_to_pb(
+            self.same_process_as_parent_span, "BoolValue"
+        )
+        child_span_count_pb = _value_to_pb(self.child_span_count, "Int32Value")
+
+        gapic_api.create_span.assert_called_with(
+            name=self.span_name,
+            span_id=self.span_id,
+            display_name=display_name_pb,
+            start_time=start_time_pb,
+            end_time=end_time_pb,
+            parent_span_id=self.parent_span_id,
+            attributes=attributes_pb,
+            stack_trace=stack_trace_pb,
+            time_events=time_events_pb,
+            links=links_pb,
+            status=status_pb,
+            same_process_as_parent_span=same_process_as_parent_span_pb,
+            child_span_count=child_span_count_pb,
+        )
+
+
+class Test_make_trace_api(unittest.TestCase):
+    def _call_fut(self, client):
+        from google.cloud.trace._gapic import make_trace_api
+
+        return make_trace_api(client)
+
+    def test_it(self):
+        from google.cloud.trace._gapic import _TraceAPI
+
+        client = mock.Mock(spec=["_credentials", "_client_info"])
+
+        patch_api = mock.patch(
+            "google.cloud.trace._gapic.trace_service_client.TraceServiceClient"
+        )
+
+        with patch_api as patched:
+            trace_api = self._call_fut(client)
+
+        patched.assert_called_once_with(
+            credentials=client._credentials, client_info=client._client_info
+        )
+
+        self.assertIsInstance(trace_api, _TraceAPI)
+        self.assertIs(trace_api._gapic_api, patched.return_value)
+        self.assertIs(trace_api.client, client)
diff --git a/trace/tests/unit/v2/test_client_v2.py b/trace/tests/unit/v2/test_client_v2.py
new file mode 100644
index 000000000000..d5a14aeb6c92
--- /dev/null
+++ b/trace/tests/unit/v2/test_client_v2.py
@@ -0,0 +1,157 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+def _make_credentials():
+    import google.auth.credentials
+
+    return mock.Mock(spec=google.auth.credentials.Credentials)
+
+
+class TestClient(unittest.TestCase):
+
+    project = "PROJECT"
+
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.trace.client import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        from google.api_core.gapic_v1.client_info import ClientInfo
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        self.assertEqual(client.project, self.project)
+        self.assertIsInstance(client._client_info, ClientInfo)
+
+    def test_constructor_explicit(self):
+        credentials = _make_credentials()
+        client_info = mock.Mock()
+        client = self._make_one(
+            project=self.project, credentials=credentials, client_info=client_info
+        )
+        self.assertEqual(client.project, self.project)
+
+    def test_trace_api(self):
+        clients = []
+        api_obj = object()
+
+        def make_api(client_obj):
+            clients.append(client_obj)
+            return api_obj
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+
+        patch = mock.patch("google.cloud.trace.client.make_trace_api", new=make_api)
+
+        with patch:
+            api = client.trace_api
+
+        self.assertIs(api, api_obj)
+        self.assertEqual(clients, [client])
+
+    def test_trace_api_existing(self):
+        """Check that the client caches _trace_api."""
+        client = self._make_one(project=self.project, credentials=_make_credentials())
+        client._trace_api = mock.sentinel.trace_api
+        self.assertIs(client.trace_api, mock.sentinel.trace_api)
+
+    def test_batch_write_spans(self):
+        from google.cloud.trace._gapic import _TraceAPI
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        name = "projects/{}".format(self.project)
+        spans = "fake_spans_for_test"
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.patch_traces = mock.Mock()
+        patch = mock.patch(
+            "google.cloud.trace.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            client.batch_write_spans(name=name, spans=spans)
+
+        mock_trace_api.batch_write_spans.assert_called_with(
+            name=name, spans=spans, retry=None, timeout=None
+        )
+
+    def test_create_span(self):
+        from google.cloud.trace._gapic import _TraceAPI
+
+        credentials = _make_credentials()
+        client = self._make_one(project=self.project, credentials=credentials)
+        name = "projects/{}".format(self.project)
+        span_id = "1111"
+        display_name = "test display name"
+        start_time = "test start time"
+        end_time = "test end time"
+        parent_span_id = "test parent span id"
+        attributes = "test attributes"
+        stack_trace = "test stack trace"
+        time_events = "test time events"
+        links = "test links"
+        status = "test status"
+        same_process_as_parent_span = "test same process as parent span"
+        child_span_count = "test child span count"
+
+        mock_trace_api = mock.Mock(spec=_TraceAPI)
+        mock_trace_api.patch_traces = mock.Mock()
+        patch = mock.patch(
+            "google.cloud.trace.client.make_trace_api", return_value=mock_trace_api
+        )
+
+        with patch:
+            client.create_span(
+                name=name,
+                span_id=span_id,
+                display_name=display_name,
+                start_time=start_time,
+                end_time=end_time,
+                parent_span_id=parent_span_id,
+                attributes=attributes,
+                stack_trace=stack_trace,
+                time_events=time_events,
+                links=links,
+                status=status,
+                same_process_as_parent_span=same_process_as_parent_span,
+                child_span_count=child_span_count,
+            )
+
+        mock_trace_api.create_span.assert_called_with(
+            name=name,
+            span_id=span_id,
+            display_name=display_name,
+            start_time=start_time,
+            end_time=end_time,
+            parent_span_id=parent_span_id,
+            attributes=attributes,
+            stack_trace=stack_trace,
+            time_events=time_events,
+            links=links,
+            status=status,
+            same_process_as_parent_span=same_process_as_parent_span,
+            child_span_count=child_span_count,
+        )
diff --git a/translate/.coveragerc b/translate/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/translate/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/translate/.flake8 b/translate/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/translate/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/translate/.repo-metadata.json b/translate/.repo-metadata.json
new file mode 100644
index 000000000000..85f651a8088e
--- /dev/null
+++ b/translate/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "translation",
+  "name_pretty": "Cloud Translation",
+  "product_documentation": "https://cloud.google.com/translate/docs/",
+  "client_documentation": "https://googleapis.dev/python/translation/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559749",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-translate",
+  "api_id": "translation.googleapis.com",
+  "requires_billing": true
+}
diff --git a/translate/CHANGELOG.md b/translate/CHANGELOG.md
new file mode 100644
index 000000000000..7cdbb9408612
--- /dev/null
+++ b/translate/CHANGELOG.md
@@ -0,0 +1,143 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-translate/#history
+
+## 1.6.0
+
+07-09-2019 13:13 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8409](https://github.com/googleapis/google-cloud-python/pull/8409))
+- Update service descriptions and add additional rpc bindings for Translate ([#8267](https://github.com/googleapis/google-cloud-python/pull/8267))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8527](https://github.com/googleapis/google-cloud-python/pull/8527))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8600](https://github.com/googleapis/google-cloud-python/pull/8600))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth).  ([#8369](https://github.com/googleapis/google-cloud-python/pull/8369))
+- Add disclaimer to auto-generated template files (via synth).  ([#8333](https://github.com/googleapis/google-cloud-python/pull/8333))
+- Blacken (via synth). ([#8282](https://github.com/googleapis/google-cloud-python/pull/8282))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8255](https://github.com/googleapis/google-cloud-python/pull/8255))
+- Fix coverage in 'types.py' (via synth). ([#8168](https://github.com/googleapis/google-cloud-python/pull/8168))
+- Blacken noxfile.py, setup.py (via synth). ([#8135](https://github.com/googleapis/google-cloud-python/pull/8135))
+- Add empty lines (via synth). ([#8076](https://github.com/googleapis/google-cloud-python/pull/8076))
+
+## 1.5.0
+
+05-16-2019 13:05 PDT
+
+
+### Implementation Changes
+- Add routing header to method metadata, fix docstring (via synth). ([#7660](https://github.com/googleapis/google-cloud-python/pull/7660))
+
+### New Features
+- Add `client_info` support to client / connection. ([#7873](https://github.com/googleapis/google-cloud-python/pull/7873))
+
+### Dependencies
+- Pin `google-cloud-core >= 1.0.0, < 2.0dev`. ([#7993](https://github.com/googleapis/google-cloud-python/pull/7993))
+
+### Documentation
+- Add docs for v3beta1. ([#7681](https://github.com/googleapis/google-cloud-python/pull/7681))
+
+### Internal / Testing Changes
+- Harden system test against back-end changes. ([#7987](https://github.com/googleapis/google-cloud-python/pull/7987))
+- Exclude `docs/conf.py` in synth. ([#7943](https://github.com/googleapis/google-cloud-python/pull/7943))
+- Update `docs/conf.py` (via synth). ([#7837](https://github.com/googleapis/google-cloud-python/pull/7837))
+- Add nox session `docs`, reorder methods (via synth). ([#7785](https://github.com/googleapis/google-cloud-python/pull/7785))
+
+## 1.4.0
+
+04-02-2019 14:24 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add Translate v3 ([#7637](https://github.com/googleapis/google-cloud-python/pull/7637))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+
+## 1.3.3
+
+12-17-2018 17:07 PST
+
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+## 1.3.2
+
+12-10-2018 13:33 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Fix rtype for `Client.detect_language` for single values ([#5397](https://github.com/googleapis/google-cloud-python/pull/5397))
+
+### Dependencies
+- Update dependency to google-cloud-core ([#6835](https://github.com/googleapis/google-cloud-python/pull/6835))
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Fix installation package in README.rst ([#6426](https://github.com/googleapis/google-cloud-python/pull/6426))
+- Fix [#6321](https://github.com/googleapis/google-cloud-python/pull/6321) Update README service links in quickstart guides. ([#6322](https://github.com/googleapis/google-cloud-python/pull/6322))
+- Docs: normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Restore detailed usage docs. ([#5999](https://github.com/googleapis/google-cloud-python/pull/5999))
+- Redirect renamed 'usage.html'/'client.html' -> 'index.html'. ([#5996](https://github.com/googleapis/google-cloud-python/pull/5996))
+- Prep translate docs for repo split. ([#5941](https://github.com/googleapis/google-cloud-python/pull/5941))
+
+### Internal / Testing Changes
+- Add blacken to noxfile ([#6795](https://github.com/googleapis/google-cloud-python/pull/6795))
+- Blackening Continued... ([#6667](https://github.com/googleapis/google-cloud-python/pull/6667))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Adapt system test to updated back-end translation. ([#6427](https://github.com/googleapis/google-cloud-python/pull/6427))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Nox: use inplace installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Modify system tests to use prerelease versions of grpcio ([#5304](https://github.com/googleapis/google-cloud-python/pull/5304))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Fix bad trove classifier
+
+## 1.3.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Documentation
+
+- Fixing "Fore" -> "For" typo in README docs. (#4317)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Making a `nox -s default` session for all packages. (#4324)
+- Shorten test names (#4321)
+
+## 1.3.0
+
+### Notable Implementation Changes
+
+- Use POST (rather than GET) for API `translate` requests (#4095,
+  h/t to @Maerig)
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+- Fix example in `Config.get_variable()` (#3910)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+
+PyPI: https://pypi.org/project/google-cloud-translate/1.3.0/
diff --git a/translate/LICENSE b/translate/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/translate/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/translate/MANIFEST.in b/translate/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/translate/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/translate/README.rst b/translate/README.rst
new file mode 100644
index 000000000000..af398ee4e3a0
--- /dev/null
+++ b/translate/README.rst
@@ -0,0 +1,121 @@
+Python Client for Google Cloud Translation
+==========================================
+
+|GA| |pypi| |versions| 
+
+With `Google Cloud Translation`_, you can dynamically translate text between
+thousands of language pairs. The Google Cloud Translation API lets websites
+and programs integrate with Google Cloud Translation programmatically. Google
+Cloud Translation is available as a paid service. See the `Pricing`_ and
+`FAQ`_ pages for details.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-translate.svg
+   :target: https://pypi.org/project/google-cloud-translate/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-translate.svg
+   :target: https://pypi.org/project/google-cloud-translate/
+.. _Google Cloud Translation: https://cloud.google.com/translate/
+.. _Pricing: https://cloud.google.com/translate/pricing
+.. _FAQ: https://cloud.google.com/translate/faq
+.. _Client Library Documentation: https://googleapis.dev/python/translation/latest
+.. _Product Documentation: https://cloud.google.com/translate/docs
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Translate API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Translate API.:  https://cloud.google.com/translate
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-translate
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-translate
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+     >>> from google.cloud import translate
+     >>> client = translate.Client()
+     >>> client.get_languages()
+     [
+         {
+             'language': 'af',
+             'name': 'Afrikaans',
+         },
+          ...
+     ]
+     >>> client.detect_language(['Me llamo', 'I am'])
+     [
+         {
+             'confidence': 0.25830904,
+             'input': 'Me llamo',
+             'language': 'es',
+         }, {
+             'confidence': 0.17112699,
+             'input': 'I am',
+             'language': 'en',
+         },
+     ]
+     >>> from google.cloud import translate
+     >>> client = translate.Client()
+     >>> client.translate('koszula')
+     {
+         'translatedText': 'shirt',
+         'detectedSourceLanguage': 'pl',
+         'input': 'koszula',
+     }
diff --git a/translate/docs/README.rst b/translate/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/translate/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/translate/docs/changelog.md b/translate/docs/changelog.md
new file mode 120000
index 000000000000..77abd36fd533
--- /dev/null
+++ b/translate/docs/changelog.md
@@ -0,0 +1 @@
+../../translate/CHANGELOG.md
\ No newline at end of file
diff --git a/translate/docs/client.rst b/translate/docs/client.rst
new file mode 100644
index 000000000000..fbd7a4a18aeb
--- /dev/null
+++ b/translate/docs/client.rst
@@ -0,0 +1,7 @@
+Translation Client
+==================
+
+.. automodule:: google.cloud.translate_v2.client
+  :members:
+  :undoc-members:
+  :show-inheritance:
diff --git a/translate/docs/conf.py b/translate/docs/conf.py
new file mode 100644
index 000000000000..1e8b3b27ad70
--- /dev/null
+++ b/translate/docs/conf.py
@@ -0,0 +1,357 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-translate documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.doctest",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-translate"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-translate-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-translate.tex",
+        u"google-cloud-translate Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-translate",
+        u"google-cloud-translate Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-translate",
+        u"google-cloud-translate Documentation",
+        author,
+        "google-cloud-translate",
+        "GAPIC library for the {metadata.shortName} v3beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/translate/docs/gapic/v3beta1/api.rst b/translate/docs/gapic/v3beta1/api.rst
new file mode 100644
index 000000000000..4d46ad1362b4
--- /dev/null
+++ b/translate/docs/gapic/v3beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Translation API
+================================
+
+.. automodule:: google.cloud.translate_v3beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/translate/docs/gapic/v3beta1/types.rst b/translate/docs/gapic/v3beta1/types.rst
new file mode 100644
index 000000000000..8b9725da3b1d
--- /dev/null
+++ b/translate/docs/gapic/v3beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Translation API Client
+======================================
+
+.. automodule:: google.cloud.translate_v3beta1.types
+    :members:
\ No newline at end of file
diff --git a/translate/docs/index.rst b/translate/docs/index.rst
new file mode 100644
index 000000000000..8b370cfdae11
--- /dev/null
+++ b/translate/docs/index.rst
@@ -0,0 +1,40 @@
+.. include:: README.rst
+
+Detailed Usage Guide
+--------------------
+.. toctree::
+  :maxdepth: 2
+
+  usage
+
+API Reference
+-------------
+
+A new beta release, spelled ``v3beta1``, is provided to provide for preview
+of upcoming features. In order to use this, you will want to import from
+``google.cloud.translate_v3beta1`` in lieu of ``google.cloud.translate``.
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v3beta1/api
+  gapic/v3beta1/types
+
+An API and type reference is provided for v2:
+
+.. toctree::
+  :maxdepth: 2
+
+  client
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-translate`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
+
diff --git a/translate/docs/usage.rst b/translate/docs/usage.rst
new file mode 100644
index 000000000000..5fc2767c06e6
--- /dev/null
+++ b/translate/docs/usage.rst
@@ -0,0 +1,110 @@
+Using the Translate Client
+--------------------------
+
+To create a client:
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client()
+
+By default, the client targets English when doing detections
+and translations, but a non-default value can be used as
+well:
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client(target_language='es')
+
+The Google Cloud Translation API has three supported methods, and they
+map to three methods on a client:
+:meth:`~google.cloud.translate.client.Client.get_languages`,
+:meth:`~google.cloud.translate.client.Client.detect_language` and
+:meth:`~google.cloud.translate.client.Client.translate`.
+
+To get a list of languages supported by the Google Cloud Translation API
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client()
+   >>> client.get_languages()
+   [
+       {
+           'language': 'af',
+           'name': 'Afrikaans',
+       },
+        ...
+   ]
+
+To detect the language that some given text is written in:
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client()
+   >>> client.detect_language(['Me llamo', 'I am'])
+   [
+       {
+           'confidence': 0.25830904,
+           'input': 'Me llamo',
+           'language': 'es',
+       }, {
+           'confidence': 0.17112699,
+           'input': 'I am',
+           'language': 'en',
+       },
+   ]
+
+The `confidence`_ value is an optional floating point value between 0 and 1.
+The closer this value is to 1, the higher the confidence level for the
+language detection. This member is not always available.
+
+.. _confidence: https://cloud.google.com/translate/docs/detecting-language
+
+To translate text into the default destination language without knowing
+the source language:
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client()
+   >>> client.translate('koszula')
+   {
+       'translatedText': 'shirt',
+       'detectedSourceLanguage': 'pl',
+       'input': 'koszula',
+   }
+
+If the source language is known:
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client()
+   >>> client.translate('camisa', source_language='es')
+   {
+       'translatedText': 'shirt',
+       'input': 'camisa',
+   }
+
+or to use a non-default target language:
+
+.. doctest::
+
+   >>> from google.cloud import translate
+   >>> client = translate.Client()
+   >>> client.translate(['Me llamo Jeff', 'My name is Jeff'],
+   ...                  target_language='de')
+   [
+       {
+           'translatedText': 'Mein Name ist Jeff',
+           'detectedSourceLanguage': 'es',
+           'input': 'Me llamo Jeff',
+       }, {
+           'translatedText': 'Mein Name ist Jeff',
+           'detectedSourceLanguage': 'en',
+           'input': 'My name is Jeff',
+       },
+   ]
diff --git a/translate/google/__init__.py b/translate/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/translate/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/translate/google/cloud/__init__.py b/translate/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/translate/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/translate/google/cloud/translate.py b/translate/google/cloud/translate.py
new file mode 100644
index 000000000000..947f8c8ae093
--- /dev/null
+++ b/translate/google/cloud/translate.py
@@ -0,0 +1,27 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud Translation API wrapper."""
+
+
+from google.cloud.translate_v2 import __version__
+from google.cloud.translate_v2.client import Client
+
+# These constants are essentially deprecated; strings should be used instead.
+# They are imported here for backwards compatibility.
+from google.cloud.translate_v2.client import BASE
+from google.cloud.translate_v2.client import NMT
+
+
+__all__ = ("__version__", "BASE", "Client", "NMT")
diff --git a/translate/google/cloud/translate_v2/__init__.py b/translate/google/cloud/translate_v2/__init__.py
new file mode 100644
index 000000000000..ba2897afbd74
--- /dev/null
+++ b/translate/google/cloud/translate_v2/__init__.py
@@ -0,0 +1,25 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Cloud Translation API wrapper."""
+
+
+from pkg_resources import get_distribution
+
+__version__ = get_distribution("google-cloud-translate").version
+
+from google.cloud.translate_v2.client import Client
+
+
+__all__ = ("__version__", "Client")
diff --git a/translate/google/cloud/translate_v2/_http.py b/translate/google/cloud/translate_v2/_http.py
new file mode 100644
index 000000000000..d33647c757ab
--- /dev/null
+++ b/translate/google/cloud/translate_v2/_http.py
@@ -0,0 +1,44 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create / interact with Google Cloud Translation connections."""
+
+from google.cloud import _http
+
+from google.cloud.translate_v2 import __version__
+
+
+class Connection(_http.JSONConnection):
+    """A connection to Google Cloud Translation API via the JSON REST API.
+
+    :type client: :class:`~google.cloud.translate.client.Client`
+    :param client: The client that owns the current connection.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info: (Optional) instance used to generate user agent.
+    """
+
+    DEFAULT_API_ENDPOINT = "https://translation.googleapis.com"
+
+    def __init__(self, client, client_info=None, api_endpoint=DEFAULT_API_ENDPOINT):
+        super(Connection, self).__init__(client, client_info)
+        self.API_BASE_URL = api_endpoint
+        self._client_info.gapic_version = __version__
+        self._client_info.client_library_version = __version__
+
+    API_VERSION = "v2"
+    """The version of the API, used in building the API call's URL."""
+
+    API_URL_TEMPLATE = "{api_base_url}/language/translate/{api_version}{path}"
+    """A template for the URL of a particular API call."""
diff --git a/translate/google/cloud/translate_v2/client.py b/translate/google/cloud/translate_v2/client.py
new file mode 100644
index 000000000000..6c561675d25e
--- /dev/null
+++ b/translate/google/cloud/translate_v2/client.py
@@ -0,0 +1,281 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Client for interacting with the Google Cloud Translation API."""
+
+
+import six
+
+import google.api_core.client_options
+from google.cloud.client import Client as BaseClient
+
+from google.cloud.translate_v2._http import Connection
+
+
+ENGLISH_ISO_639 = "en"
+"""ISO 639-1 language code for English."""
+
+BASE = "base"
+"""Base translation model."""
+
+NMT = "nmt"
+"""Neural Machine Translation model."""
+
+
+class Client(BaseClient):
+    """Client to bundle configuration needed for API requests.
+
+    :type target_language: str
+    :param target_language: (Optional) The target language used for
+                            translations and language names. (Defaults to
+                            :data:`ENGLISH_ISO_639`.)
+
+    :type credentials: :class:`~google.auth.credentials.Credentials`
+    :param credentials: (Optional) The OAuth2 Credentials to use for this
+                        client. If not passed (and if no ``_http`` object is
+                        passed), falls back to the default inferred from the
+                        environment.
+
+    :type _http: :class:`~requests.Session`
+    :param _http: (Optional) HTTP object to make requests. Can be any object
+                  that defines ``request()`` with the same interface as
+                  :meth:`requests.Session.request`. If not passed, an
+                  ``_http`` object is created that is bound to the
+                  ``credentials`` for the current object.
+                  This parameter should be considered private, and could
+                  change in the future.
+
+    :type client_info: :class:`~google.api_core.client_info.ClientInfo`
+    :param client_info:
+        The client info used to send a user-agent string along with API
+        requests. If ``None``, then default info will be used. Generally,
+        you only need to set this if you're developing your own library
+        or partner tool.
+    :type client_options: :class:`~google.api_core.client_options.ClientOptions` or :class:`dict`
+    :param client_options: (Optional) Client options used to set user options on the client.
+        API Endpoint should be set through client_options.
+    """
+
+    SCOPE = ("https://www.googleapis.com/auth/cloud-platform",)
+    """The scopes required for authenticating."""
+
+    def __init__(
+        self,
+        target_language=ENGLISH_ISO_639,
+        credentials=None,
+        _http=None,
+        client_info=None,
+        client_options=None,
+    ):
+        self.target_language = target_language
+        super(Client, self).__init__(credentials=credentials, _http=_http)
+
+        kw_args = {"client_info": client_info}
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+                kw_args["api_endpoint"] = api_endpoint
+
+        self._connection = Connection(self, **kw_args)
+
+    def get_languages(self, target_language=None):
+        """Get list of supported languages for translation.
+
+        Response
+
+        See
+        https://cloud.google.com/translate/docs/discovering-supported-languages
+
+        :type target_language: str
+        :param target_language: (Optional) The language used to localize
+                                returned language names. Defaults to the
+                                target language on the current client.
+
+        :rtype: list
+        :returns: List of dictionaries. Each dictionary contains a supported
+                  ISO 639-1 language code (using the dictionary key
+                  ``language``). If ``target_language`` is passed, each
+                  dictionary will also contain the name of each supported
+                  language (localized to the target language).
+        """
+        query_params = {}
+        if target_language is None:
+            target_language = self.target_language
+        if target_language is not None:
+            query_params["target"] = target_language
+        response = self._connection.api_request(
+            method="GET", path="/languages", query_params=query_params
+        )
+        return response.get("data", {}).get("languages", ())
+
+    def detect_language(self, values):
+        """Detect the language of a string or list of strings.
+
+        See https://cloud.google.com/translate/docs/detecting-language
+
+        :type values: str or list
+        :param values: String or list of strings that will have
+                       language detected.
+
+        :rtype: dict or list
+        :returns: A list of dictionaries for each queried value. Each
+                  dictionary typically contains three keys
+
+                  * ``confidence``: The confidence in language detection, a
+                    float between 0 and 1.
+                  * ``input``: The corresponding input value.
+                  * ``language``: The detected language (as an ISO 639-1
+                    language code).
+
+                  though the key ``confidence`` may not always be present.
+
+                  If only a single value is passed, then only a single
+                  dictionary will be returned.
+        :raises: :class:`ValueError <exceptions.ValueError>` if the number of
+                 detections is not equal to the number of values.
+                 :class:`ValueError <exceptions.ValueError>` if a value
+                 produces a list of detections with 0 or multiple results
+                 in it.
+        """
+        single_value = False
+        if isinstance(values, six.string_types):
+            single_value = True
+            values = [values]
+
+        data = {"q": values}
+
+        response = self._connection.api_request(
+            method="POST", path="/detect", data=data
+        )
+
+        detections = response.get("data", {}).get("detections", ())
+
+        if len(values) != len(detections):
+            raise ValueError(
+                "Expected same number of values and detections", values, detections
+            )
+
+        for index, value in enumerate(values):
+            # Empirically, even clearly ambiguous text like "no" only returns
+            # a single detection, so we replace the list of detections with
+            # the single detection contained.
+            if len(detections[index]) == 1:
+                detections[index] = detections[index][0]
+            else:
+                message = (
+                    "Expected a single detection per value, API " "returned %d"
+                ) % (len(detections[index]),)
+                raise ValueError(message, value, detections[index])
+
+            detections[index]["input"] = value
+            # The ``isReliable`` field is deprecated.
+            detections[index].pop("isReliable", None)
+
+        if single_value:
+            return detections[0]
+        else:
+            return detections
+
+    def translate(
+        self,
+        values,
+        target_language=None,
+        format_=None,
+        source_language=None,
+        customization_ids=(),
+        model=None,
+    ):
+        """Translate a string or list of strings.
+
+        See https://cloud.google.com/translate/docs/translating-text
+
+        :type values: str or list
+        :param values: String or list of strings to translate.
+
+        :type target_language: str
+        :param target_language: The language to translate results into. This
+                                is required by the API and defaults to
+                                the target language of the current instance.
+
+        :type format_: str
+        :param format_: (Optional) One of ``text`` or ``html``, to specify
+                        if the input text is plain text or HTML.
+
+        :type source_language: str
+        :param source_language: (Optional) The language of the text to
+                                be translated.
+
+        :type customization_ids: str or list
+        :param customization_ids: (Optional) ID or list of customization IDs
+                                  for translation. Sets the ``cid`` parameter
+                                  in the query.
+
+        :type model: str
+        :param model: (Optional) The model used to translate the text, such
+                      as ``'base'`` or ``'nmt'``.
+
+        :rtype: str or list
+        :returns: A list of dictionaries for each queried value. Each
+                  dictionary typically contains three keys (though not
+                  all will be present in all cases)
+
+                  * ``detectedSourceLanguage``: The detected language (as an
+                    ISO 639-1 language code) of the text.
+                  * ``translatedText``: The translation of the text into the
+                    target language.
+                  * ``input``: The corresponding input value.
+                  * ``model``: The model used to translate the text.
+
+                  If only a single value is passed, then only a single
+                  dictionary will be returned.
+        :raises: :class:`~exceptions.ValueError` if the number of
+                 values and translations differ.
+        """
+        single_value = False
+        if isinstance(values, six.string_types):
+            single_value = True
+            values = [values]
+
+        if target_language is None:
+            target_language = self.target_language
+        if isinstance(customization_ids, six.string_types):
+            customization_ids = [customization_ids]
+
+        data = {
+            "target": target_language,
+            "q": values,
+            "cid": customization_ids,
+            "format": format_,
+            "source": source_language,
+            "model": model,
+        }
+
+        response = self._connection.api_request(method="POST", path="", data=data)
+
+        translations = response.get("data", {}).get("translations", ())
+        if len(values) != len(translations):
+            raise ValueError(
+                "Expected iterations to have same length", values, translations
+            )
+        for value, translation in six.moves.zip(values, translations):
+            translation["input"] = value
+
+        if single_value:
+            return translations[0]
+        else:
+            return translations
diff --git a/translate/google/cloud/translate_v3beta1/__init__.py b/translate/google/cloud/translate_v3beta1/__init__.py
new file mode 100644
index 000000000000..397226dd1df8
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/__init__.py
@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.translate_v3beta1 import types
+from google.cloud.translate_v3beta1.gapic import translation_service_client
+
+
+class TranslationServiceClient(translation_service_client.TranslationServiceClient):
+    __doc__ = translation_service_client.TranslationServiceClient.__doc__
+
+
+__all__ = ("types", "TranslationServiceClient")
diff --git a/translate/google/cloud/translate_v3beta1/gapic/__init__.py b/translate/google/cloud/translate_v3beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/translate/google/cloud/translate_v3beta1/gapic/translation_service_client.py b/translate/google/cloud/translate_v3beta1/gapic/translation_service_client.py
new file mode 100644
index 000000000000..b0feb083369d
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/gapic/translation_service_client.py
@@ -0,0 +1,1040 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.translation.v3beta1 TranslationService API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.translate_v3beta1.gapic import translation_service_client_config
+from google.cloud.translate_v3beta1.gapic.transports import (
+    translation_service_grpc_transport,
+)
+from google.cloud.translate_v3beta1.proto import translation_service_pb2
+from google.cloud.translate_v3beta1.proto import translation_service_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-translate"
+).version
+
+
+class TranslationServiceClient(object):
+    """Provides natural language translation operations."""
+
+    SERVICE_ADDRESS = "translate.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.translation.v3beta1.TranslationService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            TranslationServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def glossary_path(cls, project, location, glossary):
+        """Return a fully-qualified glossary string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/glossaries/{glossary}",
+            project=project,
+            location=location,
+            glossary=glossary,
+        )
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.TranslationServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.TranslationServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = translation_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=translation_service_grpc_transport.TranslationServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = translation_service_grpc_transport.TranslationServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def translate_text(
+        self,
+        contents,
+        target_language_code,
+        mime_type=None,
+        source_language_code=None,
+        parent=None,
+        model=None,
+        glossary_config=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Translates input text and returns translated text.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> # TODO: Initialize `contents`:
+            >>> contents = []
+            >>>
+            >>> # TODO: Initialize `target_language_code`:
+            >>> target_language_code = ''
+            >>>
+            >>> response = client.translate_text(contents, target_language_code)
+
+        Args:
+            contents (list[str]): Required. The content of the input in string format.
+                We recommend the total content be less than 30k codepoints.
+                Use BatchTranslateText for larger text.
+            target_language_code (str): 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.
+            mime_type (str): Optional. The format of the source text, for example, "text/html",
+                 "text/plain". If left blank, the MIME type defaults to "text/html".
+            source_language_code (str): 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.
+            parent (str): Required. Location to make a regional or global call.
+
+                Format: ``projects/{project-id}/locations/{location-id}``.
+
+                For global calls, use ``projects/{project-id}/locations/global``.
+
+                Models and glossaries must be within the same region (have same
+                location-id), otherwise an INVALID\_ARGUMENT (400) error is returned.
+            model (str): Optional. The ``model`` type requested for this translation.
+
+                The format depends on model type:
+
+                -  AutoML Translation models:
+                   ``projects/{project-id}/locations/{location-id}/models/{model-id}``
+
+                -  General (built-in) models:
+                   ``projects/{project-id}/locations/{location-id}/models/general/nmt``,
+                   ``projects/{project-id}/locations/{location-id}/models/general/base``
+
+                For global (non-regionalized) requests, use ``location-id`` ``global``.
+                For example,
+                ``projects/{project-id}/locations/global/models/general/nmt``.
+
+                If missing, the system decides which google base model to use.
+            glossary_config (Union[dict, ~google.cloud.translate_v3beta1.types.TranslateTextGlossaryConfig]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.translate_v3beta1.types.TranslateTextGlossaryConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types.TranslateTextResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "translate_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "translate_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.translate_text,
+                default_retry=self._method_configs["TranslateText"].retry,
+                default_timeout=self._method_configs["TranslateText"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.TranslateTextRequest(
+            contents=contents,
+            target_language_code=target_language_code,
+            mime_type=mime_type,
+            source_language_code=source_language_code,
+            parent=parent,
+            model=model,
+            glossary_config=glossary_config,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["translate_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def detect_language(
+        self,
+        parent=None,
+        model=None,
+        content=None,
+        mime_type=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Detects the language of text within a request.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> response = client.detect_language()
+
+        Args:
+            parent (str): Required. Location to make a regional or global call.
+
+                Format: ``projects/{project-id}/locations/{location-id}``.
+
+                For global calls, use ``projects/{project-id}/locations/global``.
+
+                Only models within the same region (has same location-id) can be used.
+                Otherwise an INVALID\_ARGUMENT (400) error is returned.
+            model (str): Optional. The language detection model to be used.
+
+                Format:
+                ``projects/{project-id}/locations/{location-id}/models/language-detection/{model-id}``
+
+                Only one language detection model is currently supported:
+                ``projects/{project-id}/locations/{location-id}/models/language-detection/default``.
+
+                If not specified, the default model is used.
+            content (str): The content of the input stored as a string.
+            mime_type (str): Optional. The format of the source text, for example, "text/html",
+                "text/plain". If left blank, the MIME type defaults to "text/html".
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types.DetectLanguageResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "detect_language" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "detect_language"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.detect_language,
+                default_retry=self._method_configs["DetectLanguage"].retry,
+                default_timeout=self._method_configs["DetectLanguage"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(content=content)
+
+        request = translation_service_pb2.DetectLanguageRequest(
+            parent=parent, model=model, content=content, mime_type=mime_type
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["detect_language"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_supported_languages(
+        self,
+        parent=None,
+        display_language_code=None,
+        model=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Returns a list of supported languages for translation.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> response = client.get_supported_languages()
+
+        Args:
+            parent (str): Required. Location to make a regional or global call.
+
+                Format: ``projects/{project-id}/locations/{location-id}``.
+
+                For global calls, use ``projects/{project-id}/locations/global``.
+
+                Only models within the same region (have same location-id) can be used,
+                otherwise an INVALID\_ARGUMENT (400) error is returned.
+            display_language_code (str): 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.
+            model (str): Optional. Get supported languages of this model.
+
+                The format depends on model type:
+
+                -  AutoML Translation models:
+                   ``projects/{project-id}/locations/{location-id}/models/{model-id}``
+
+                -  General (built-in) models:
+                   ``projects/{project-id}/locations/{location-id}/models/general/nmt``,
+                   ``projects/{project-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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types.SupportedLanguages` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_supported_languages" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_supported_languages"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_supported_languages,
+                default_retry=self._method_configs["GetSupportedLanguages"].retry,
+                default_timeout=self._method_configs["GetSupportedLanguages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.GetSupportedLanguagesRequest(
+            parent=parent, display_language_code=display_language_code, model=model
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_supported_languages"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_translate_text(
+        self,
+        source_language_code,
+        target_language_codes,
+        input_configs,
+        output_config,
+        parent=None,
+        models=None,
+        glossaries=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> # TODO: Initialize `source_language_code`:
+            >>> source_language_code = ''
+            >>>
+            >>> # TODO: Initialize `target_language_codes`:
+            >>> target_language_codes = []
+            >>>
+            >>> # TODO: Initialize `input_configs`:
+            >>> input_configs = []
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.batch_translate_text(source_language_code, target_language_codes, input_configs, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            source_language_code (str): Required. Source language code.
+            target_language_codes (list[str]): Required. Specify up to 10 language codes here.
+            input_configs (list[Union[dict, ~google.cloud.translate_v3beta1.types.InputConfig]]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.translate_v3beta1.types.InputConfig`
+            output_config (Union[dict, ~google.cloud.translate_v3beta1.types.OutputConfig]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.translate_v3beta1.types.OutputConfig`
+            parent (str): Required. Location to make a regional call.
+
+                Format: ``projects/{project-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.
+            models (dict[str -> str]): 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-id}/locations/{location-id}/models/{model-id}``
+
+                -  General (built-in) models:
+                   ``projects/{project-id}/locations/{location-id}/models/general/nmt``,
+                   ``projects/{project-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.
+            glossaries (dict[str -> Union[dict, ~google.cloud.translate_v3beta1.types.TranslateTextGlossaryConfig]]): Optional. Glossaries to be applied for translation.
+                It's keyed by target language code.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.translate_v3beta1.types.TranslateTextGlossaryConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_translate_text" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_translate_text"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_translate_text,
+                default_retry=self._method_configs["BatchTranslateText"].retry,
+                default_timeout=self._method_configs["BatchTranslateText"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.BatchTranslateTextRequest(
+            source_language_code=source_language_code,
+            target_language_codes=target_language_codes,
+            input_configs=input_configs,
+            output_config=output_config,
+            parent=parent,
+            models=models,
+            glossaries=glossaries,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["batch_translate_text"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            translation_service_pb2.BatchTranslateResponse,
+            metadata_type=translation_service_pb2.BatchTranslateMetadata,
+        )
+
+    def create_glossary(
+        self,
+        parent,
+        glossary,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a glossary and returns the long-running operation. Returns
+        NOT\_FOUND, if the project doesn't exist.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `glossary`:
+            >>> glossary = {}
+            >>>
+            >>> response = client.create_glossary(parent, glossary)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): Required. The project name.
+            glossary (Union[dict, ~google.cloud.translate_v3beta1.types.Glossary]): Required. The glossary to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.translate_v3beta1.types.Glossary`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_glossary" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_glossary"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_glossary,
+                default_retry=self._method_configs["CreateGlossary"].retry,
+                default_timeout=self._method_configs["CreateGlossary"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.CreateGlossaryRequest(
+            parent=parent, glossary=glossary
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["create_glossary"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            translation_service_pb2.Glossary,
+            metadata_type=translation_service_pb2.CreateGlossaryMetadata,
+        )
+
+    def list_glossaries(
+        self,
+        parent=None,
+        page_size=None,
+        filter_=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists glossaries in a project. Returns NOT\_FOUND, if the project
+        doesn't exist.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_glossaries():
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_glossaries().pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required. The name of the project from which to list all of the glossaries.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            filter_ (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.translate_v3beta1.types.Glossary` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_glossaries" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_glossaries"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_glossaries,
+                default_retry=self._method_configs["ListGlossaries"].retry,
+                default_timeout=self._method_configs["ListGlossaries"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.ListGlossariesRequest(
+            parent=parent, page_size=page_size, filter=filter_
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_glossaries"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="glossaries",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_glossary(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a glossary. Returns NOT\_FOUND, if the glossary doesn't exist.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> name = client.glossary_path('[PROJECT]', '[LOCATION]', '[GLOSSARY]')
+            >>>
+            >>> response = client.get_glossary(name)
+
+        Args:
+            name (str): Required. The name of the glossary to retrieve.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types.Glossary` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_glossary" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_glossary"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_glossary,
+                default_retry=self._method_configs["GetGlossary"].retry,
+                default_timeout=self._method_configs["GetGlossary"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.GetGlossaryRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_glossary"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_glossary(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes a glossary, or cancels glossary construction if the glossary
+        isn't created yet. Returns NOT\_FOUND, if the glossary doesn't exist.
+
+        Example:
+            >>> from google.cloud import translate_v3beta1
+            >>>
+            >>> client = translate_v3beta1.TranslationServiceClient()
+            >>>
+            >>> name = client.glossary_path('[PROJECT]', '[LOCATION]', '[GLOSSARY]')
+            >>>
+            >>> response = client.delete_glossary(name)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            name (str): Required. The name of the glossary to delete.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.translate_v3beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_glossary" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_glossary"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_glossary,
+                default_retry=self._method_configs["DeleteGlossary"].retry,
+                default_timeout=self._method_configs["DeleteGlossary"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = translation_service_pb2.DeleteGlossaryRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["delete_glossary"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            translation_service_pb2.DeleteGlossaryResponse,
+            metadata_type=translation_service_pb2.DeleteGlossaryMetadata,
+        )
diff --git a/translate/google/cloud/translate_v3beta1/gapic/translation_service_client_config.py b/translate/google/cloud/translate_v3beta1/gapic/translation_service_client_config.py
new file mode 100644
index 000000000000..21b7872180e8
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/gapic/translation_service_client_config.py
@@ -0,0 +1,63 @@
+config = {
+    "interfaces": {
+        "google.cloud.translation.v3beta1.TranslationService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "TranslateText": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DetectLanguage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetSupportedLanguages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchTranslateText": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateGlossary": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListGlossaries": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetGlossary": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteGlossary": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/translate/google/cloud/translate_v3beta1/gapic/transports/__init__.py b/translate/google/cloud/translate_v3beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/translate/google/cloud/translate_v3beta1/gapic/transports/translation_service_grpc_transport.py b/translate/google/cloud/translate_v3beta1/gapic/transports/translation_service_grpc_transport.py
new file mode 100644
index 000000000000..46f9c525ea6c
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/gapic/transports/translation_service_grpc_transport.py
@@ -0,0 +1,234 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.translate_v3beta1.proto import translation_service_pb2_grpc
+
+
+class TranslationServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.translation.v3beta1 TranslationService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-translation",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="translate.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "translation_service_stub": translation_service_pb2_grpc.TranslationServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="translate.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def translate_text(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.translate_text`.
+
+        Translates input text and returns translated text.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].TranslateText
+
+    @property
+    def detect_language(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.detect_language`.
+
+        Detects the language of text within a request.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].DetectLanguage
+
+    @property
+    def get_supported_languages(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.get_supported_languages`.
+
+        Returns a list of supported languages for translation.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].GetSupportedLanguages
+
+    @property
+    def batch_translate_text(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.batch_translate_text`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].BatchTranslateText
+
+    @property
+    def create_glossary(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.create_glossary`.
+
+        Creates a glossary and returns the long-running operation. Returns
+        NOT\_FOUND, if the project doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].CreateGlossary
+
+    @property
+    def list_glossaries(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.list_glossaries`.
+
+        Lists glossaries in a project. Returns NOT\_FOUND, if the project
+        doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].ListGlossaries
+
+    @property
+    def get_glossary(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.get_glossary`.
+
+        Gets a glossary. Returns NOT\_FOUND, if the glossary doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].GetGlossary
+
+    @property
+    def delete_glossary(self):
+        """Return the gRPC stub for :meth:`TranslationServiceClient.delete_glossary`.
+
+        Deletes a glossary, or cancels glossary construction if the glossary
+        isn't created yet. Returns NOT\_FOUND, if the glossary doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["translation_service_stub"].DeleteGlossary
diff --git a/translate/google/cloud/translate_v3beta1/proto/__init__.py b/translate/google/cloud/translate_v3beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/translate/google/cloud/translate_v3beta1/proto/translation_service.proto b/translate/google/cloud/translate_v3beta1/proto/translation_service.proto
new file mode 100644
index 000000000000..fa20f01693f2
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/proto/translation_service.proto
@@ -0,0 +1,790 @@
+// 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.v3beta1;
+
+import "google/api/annotations.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";
+option go_package = "google.golang.org/genproto/googleapis/cloud/translate/v3beta1;translate";
+option java_multiple_files = true;
+option java_outer_classname = "TranslationServiceProto";
+option java_package = "com.google.cloud.translate.v3beta1";
+option php_namespace = "Google\\Cloud\\Translate\\V3beta1";
+option ruby_package = "Google::Cloud::Translate::V3beta1";
+
+// Proto file for the Cloud Translation API (v3beta1).
+
+// Provides natural language translation operations.
+service TranslationService {
+  option (google.api.default_host) = "translation.googleapis.com";
+
+  // Translates input text and returns translated text.
+  rpc TranslateText(TranslateTextRequest) returns (TranslateTextResponse) {
+    option (google.api.http) = {
+      post: "/v3beta1/{parent=projects/*/locations/*}:translateText"
+      body: "*"
+      additional_bindings {
+        post: "/v3beta1/{parent=projects/*}:translateText"
+        body: "*"
+      }
+    };
+  }
+
+  // Detects the language of text within a request.
+  rpc DetectLanguage(DetectLanguageRequest) returns (DetectLanguageResponse) {
+    option (google.api.http) = {
+      post: "/v3beta1/{parent=projects/*/locations/*}:detectLanguage"
+      body: "*"
+      additional_bindings {
+        post: "/v3beta1/{parent=projects/*}:detectLanguage"
+        body: "*"
+      }
+    };
+  }
+
+  // Returns a list of supported languages for translation.
+  rpc GetSupportedLanguages(GetSupportedLanguagesRequest) returns (SupportedLanguages) {
+    option (google.api.http) = {
+      get: "/v3beta1/{parent=projects/*/locations/*}/supportedLanguages"
+      additional_bindings {
+        get: "/v3beta1/{parent=projects/*}/supportedLanguages"
+      }
+    };
+  }
+
+  // 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: "/v3beta1/{parent=projects/*/locations/*}:batchTranslateText"
+      body: "*"
+    };
+  }
+
+  // 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: "/v3beta1/{parent=projects/*/locations/*}/glossaries"
+      body: "glossary"
+    };
+  }
+
+  // Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't
+  // exist.
+  rpc ListGlossaries(ListGlossariesRequest) returns (ListGlossariesResponse) {
+    option (google.api.http) = {
+      get: "/v3beta1/{parent=projects/*/locations/*}/glossaries"
+    };
+  }
+
+  // Gets a glossary. Returns NOT_FOUND, if the glossary doesn't
+  // exist.
+  rpc GetGlossary(GetGlossaryRequest) returns (Glossary) {
+    option (google.api.http) = {
+      get: "/v3beta1/{name=projects/*/locations/*/glossaries/*}"
+    };
+  }
+
+  // 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: "/v3beta1/{name=projects/*/locations/*/glossaries/*}"
+    };
+  }
+}
+
+// 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;
+
+  // Optional. Indicates match is case-insensitive.
+  // Default value is false if missing.
+  bool ignore_case = 2;
+}
+
+// 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;
+
+  // 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;
+
+  // 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;
+
+  // 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;
+
+  // Required. Location to make a regional or global call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // For global calls, use `projects/{project-id}/locations/global`.
+  //
+  // Models and glossaries must be within the same region (have same
+  // location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
+  string parent = 8;
+
+  // Optional. The `model` type requested for this translation.
+  //
+  // The format depends on model type:
+  //
+  // - AutoML Translation models:
+  //   `projects/{project-id}/locations/{location-id}/models/{model-id}`
+  //
+  // - General (built-in) models:
+  //   `projects/{project-id}/locations/{location-id}/models/general/nmt`,
+  //   `projects/{project-id}/locations/{location-id}/models/general/base`
+  //
+  //
+  // For global (non-regionalized) requests, use `location-id` `global`.
+  // For example,
+  // `projects/{project-id}/locations/global/models/general/nmt`.
+  //
+  // If missing, the system decides which google base model to use.
+  string model = 6;
+
+  // 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;
+}
+
+message TranslateTextResponse {
+  // Text translation responses with no glossary applied.
+  // This field has the same length as
+  // [`contents`][google.cloud.translation.v3beta1.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.v3beta1.TranslateTextResponse.translations] if no terms apply.
+  // This field has the same length as
+  // [`contents`][google.cloud.translation.v3beta1.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.
+  // This is same as `model` provided in the request.
+  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. Location to make a regional or global call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // For global calls, use `projects/{project-id}/locations/global`.
+  //
+  // Only models within the same region (has same location-id) can be used.
+  // Otherwise an INVALID_ARGUMENT (400) error is returned.
+  string parent = 5;
+
+  // Optional. The language detection model to be used.
+  //
+  // Format:
+  // `projects/{project-id}/locations/{location-id}/models/language-detection/{model-id}`
+  //
+  // Only one language detection model is currently supported:
+  // `projects/{project-id}/locations/{location-id}/models/language-detection/default`.
+  //
+  // If not specified, the default model is used.
+  string model = 4;
+
+  // 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;
+}
+
+// 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. Location to make a regional or global call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // For global calls, use `projects/{project-id}/locations/global`.
+  //
+  // Only models within the same region (have same location-id) can be used,
+  // otherwise an INVALID_ARGUMENT (400) error is returned.
+  string parent = 3;
+
+  // 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;
+
+  // Optional. Get supported languages of this model.
+  //
+  // The format depends on model type:
+  //
+  // - AutoML Translation models:
+  //   `projects/{project-id}/locations/{location-id}/models/{model-id}`
+  //
+  // - General (built-in) models:
+  //   `projects/{project-id}/locations/{location-id}/models/general/nmt`,
+  //   `projects/{project-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;
+}
+
+// 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;
+
+  // 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 "/", 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 regional call.
+  //
+  // Format: `projects/{project-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;
+
+  // Required. Source language code.
+  string source_language_code = 2;
+
+  // Required. Specify up to 10 language codes here.
+  repeated string target_language_codes = 3;
+
+  // 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-id}/locations/{location-id}/models/{model-id}`
+  //
+  // - General (built-in) models:
+  //   `projects/{project-id}/locations/{location-id}/models/general/nmt`,
+  //   `projects/{project-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<string, string> models = 4;
+
+  // 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;
+
+  // 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;
+
+  // Optional. Glossaries to be applied for translation.
+  // It's keyed by target language code.
+  map<string, TranslateTextGlossaryConfig> glossaries = 7;
+}
+
+// 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 {
+  // 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-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;
+
+  // Output only. When CreateGlossary was called.
+  google.protobuf.Timestamp submit_time = 7;
+
+  // Output only. When the glossary creation was finished.
+  google.protobuf.Timestamp end_time = 8;
+}
+
+// Request message for CreateGlossary.
+message CreateGlossaryRequest {
+  // Required. The project name.
+  string parent = 1;
+
+  // Required. The glossary to create.
+  Glossary glossary = 2;
+}
+
+// Request message for GetGlossary.
+message GetGlossaryRequest {
+  // Required. The name of the glossary to retrieve.
+  string name = 1;
+}
+
+// Request message for DeleteGlossary.
+message DeleteGlossaryRequest {
+  // Required. The name of the glossary to delete.
+  string name = 1;
+}
+
+// Request message for ListGlossaries.
+message ListGlossariesRequest {
+  // Required. The name of the project from which to list all of the glossaries.
+  string parent = 1;
+
+  // Optional. Requested page size. The server may return fewer glossaries than
+  // requested. If unspecified, the server picks an appropriate default.
+  int32 page_size = 2;
+
+  // 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;
+
+  // 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;
+}
+
+// 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/translate/google/cloud/translate_v3beta1/proto/translation_service_pb2.py b/translate/google/cloud/translate_v3beta1/proto/translation_service_pb2.py
new file mode 100644
index 000000000000..60dfc368b645
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/proto/translation_service_pb2.py
@@ -0,0 +1,3528 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/translation_v3beta1/proto/translation_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import resource_pb2 as google_dot_api_dot_resource__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/translation_v3beta1/proto/translation_service.proto",
+    package="google.cloud.translation.v3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        '\n"com.google.cloud.translate.v3beta1B\027TranslationServiceProtoP\001ZGgoogle.golang.org/genproto/googleapis/cloud/translate/v3beta1;translate\370\001\001\252\002\036Google.Cloud.Translate.V3Beta1\312\002\036Google\\Cloud\\Translate\\V3beta1\352\002!Google::Cloud::Translate::V3beta1'
+    ),
+    serialized_pb=_b(
+        '\n@google/cloud/translation_v3beta1/proto/translation_service.proto\x12 google.cloud.translation.v3beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/api/client.proto"D\n\x1bTranslateTextGlossaryConfig\x12\x10\n\x08glossary\x18\x01 \x01(\t\x12\x13\n\x0bignore_case\x18\x02 \x01(\x08"\xee\x01\n\x14TranslateTextRequest\x12\x10\n\x08\x63ontents\x18\x01 \x03(\t\x12\x11\n\tmime_type\x18\x03 \x01(\t\x12\x1c\n\x14source_language_code\x18\x04 \x01(\t\x12\x1c\n\x14target_language_code\x18\x05 \x01(\t\x12\x0e\n\x06parent\x18\x08 \x01(\t\x12\r\n\x05model\x18\x06 \x01(\t\x12V\n\x0fglossary_config\x18\x07 \x01(\x0b\x32=.google.cloud.translation.v3beta1.TranslateTextGlossaryConfig"\xaa\x01\n\x15TranslateTextResponse\x12\x43\n\x0ctranslations\x18\x01 \x03(\x0b\x32-.google.cloud.translation.v3beta1.Translation\x12L\n\x15glossary_translations\x18\x03 \x03(\x0b\x32-.google.cloud.translation.v3beta1.Translation"\xad\x01\n\x0bTranslation\x12\x17\n\x0ftranslated_text\x18\x01 \x01(\t\x12\r\n\x05model\x18\x02 \x01(\t\x12\x1e\n\x16\x64\x65tected_language_code\x18\x04 \x01(\t\x12V\n\x0fglossary_config\x18\x03 \x01(\x0b\x32=.google.cloud.translation.v3beta1.TranslateTextGlossaryConfig"f\n\x15\x44\x65tectLanguageRequest\x12\x0e\n\x06parent\x18\x05 \x01(\t\x12\r\n\x05model\x18\x04 \x01(\t\x12\x11\n\x07\x63ontent\x18\x01 \x01(\tH\x00\x12\x11\n\tmime_type\x18\x03 \x01(\tB\x08\n\x06source"=\n\x10\x44\x65tectedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02"_\n\x16\x44\x65tectLanguageResponse\x12\x45\n\tlanguages\x18\x01 \x03(\x0b\x32\x32.google.cloud.translation.v3beta1.DetectedLanguage"\\\n\x1cGetSupportedLanguagesRequest\x12\x0e\n\x06parent\x18\x03 \x01(\t\x12\x1d\n\x15\x64isplay_language_code\x18\x01 \x01(\t\x12\r\n\x05model\x18\x02 \x01(\t"\\\n\x12SupportedLanguages\x12\x46\n\tlanguages\x18\x01 \x03(\x0b\x32\x33.google.cloud.translation.v3beta1.SupportedLanguage"p\n\x11SupportedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x16\n\x0esupport_source\x18\x03 \x01(\x08\x12\x16\n\x0esupport_target\x18\x04 \x01(\x08"\x1e\n\tGcsSource\x12\x11\n\tinput_uri\x18\x01 \x01(\t"m\n\x0bInputConfig\x12\x11\n\tmime_type\x18\x01 \x01(\t\x12\x41\n\ngcs_source\x18\x02 \x01(\x0b\x32+.google.cloud.translation.v3beta1.GcsSourceH\x00\x42\x08\n\x06source"+\n\x0eGcsDestination\x12\x19\n\x11output_uri_prefix\x18\x01 \x01(\t"j\n\x0cOutputConfig\x12K\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32\x30.google.cloud.translation.v3beta1.GcsDestinationH\x00\x42\r\n\x0b\x64\x65stination"\xd0\x04\n\x19\x42\x61tchTranslateTextRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x1c\n\x14source_language_code\x18\x02 \x01(\t\x12\x1d\n\x15target_language_codes\x18\x03 \x03(\t\x12W\n\x06models\x18\x04 \x03(\x0b\x32G.google.cloud.translation.v3beta1.BatchTranslateTextRequest.ModelsEntry\x12\x44\n\rinput_configs\x18\x05 \x03(\x0b\x32-.google.cloud.translation.v3beta1.InputConfig\x12\x45\n\routput_config\x18\x06 \x01(\x0b\x32..google.cloud.translation.v3beta1.OutputConfig\x12_\n\nglossaries\x18\x07 \x03(\x0b\x32K.google.cloud.translation.v3beta1.BatchTranslateTextRequest.GlossariesEntry\x1a-\n\x0bModelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x1ap\n\x0fGlossariesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12L\n\x05value\x18\x02 \x01(\x0b\x32=.google.cloud.translation.v3beta1.TranslateTextGlossaryConfig:\x02\x38\x01"\xd3\x02\n\x16\x42\x61tchTranslateMetadata\x12M\n\x05state\x18\x01 \x01(\x0e\x32>.google.cloud.translation.v3beta1.BatchTranslateMetadata.State\x12\x1d\n\x15translated_characters\x18\x02 \x01(\x03\x12\x19\n\x11\x66\x61iled_characters\x18\x03 \x01(\x03\x12\x18\n\x10total_characters\x18\x04 \x01(\x03\x12/\n\x0bsubmit_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"e\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\r\n\tSUCCEEDED\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\x0e\n\nCANCELLING\x10\x04\x12\r\n\tCANCELLED\x10\x05"\xcb\x01\n\x16\x42\x61tchTranslateResponse\x12\x18\n\x10total_characters\x18\x01 \x01(\x03\x12\x1d\n\x15translated_characters\x18\x02 \x01(\x03\x12\x19\n\x11\x66\x61iled_characters\x18\x03 \x01(\x03\x12/\n\x0bsubmit_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"b\n\x13GlossaryInputConfig\x12\x41\n\ngcs_source\x18\x01 \x01(\x0b\x32+.google.cloud.translation.v3beta1.GcsSourceH\x00\x42\x08\n\x06source"\x93\x04\n\x08Glossary\x12\x0c\n\x04name\x18\x01 \x01(\t\x12T\n\rlanguage_pair\x18\x03 \x01(\x0b\x32;.google.cloud.translation.v3beta1.Glossary.LanguageCodePairH\x00\x12Y\n\x12language_codes_set\x18\x04 \x01(\x0b\x32;.google.cloud.translation.v3beta1.Glossary.LanguageCodesSetH\x00\x12K\n\x0cinput_config\x18\x05 \x01(\x0b\x32\x35.google.cloud.translation.v3beta1.GlossaryInputConfig\x12\x13\n\x0b\x65ntry_count\x18\x06 \x01(\x05\x12/\n\x0bsubmit_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1aN\n\x10LanguageCodePair\x12\x1c\n\x14source_language_code\x18\x01 \x01(\t\x12\x1c\n\x14target_language_code\x18\x02 \x01(\t\x1a*\n\x10LanguageCodesSet\x12\x16\n\x0elanguage_codes\x18\x01 \x03(\tB\x0b\n\tlanguages"e\n\x15\x43reateGlossaryRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12<\n\x08glossary\x18\x02 \x01(\x0b\x32*.google.cloud.translation.v3beta1.Glossary""\n\x12GetGlossaryRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"%\n\x15\x44\x65leteGlossaryRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"^\n\x15ListGlossariesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"q\n\x16ListGlossariesResponse\x12>\n\nglossaries\x18\x01 \x03(\x0b\x32*.google.cloud.translation.v3beta1.Glossary\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8d\x02\n\x16\x43reateGlossaryMetadata\x12\x0c\n\x04name\x18\x01 \x01(\t\x12M\n\x05state\x18\x02 \x01(\x0e\x32>.google.cloud.translation.v3beta1.CreateGlossaryMetadata.State\x12/\n\x0bsubmit_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"e\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\r\n\tSUCCEEDED\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\x0e\n\nCANCELLING\x10\x04\x12\r\n\tCANCELLED\x10\x05"\x8d\x02\n\x16\x44\x65leteGlossaryMetadata\x12\x0c\n\x04name\x18\x01 \x01(\t\x12M\n\x05state\x18\x02 \x01(\x0e\x32>.google.cloud.translation.v3beta1.DeleteGlossaryMetadata.State\x12/\n\x0bsubmit_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"e\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\r\n\tSUCCEEDED\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\x0e\n\nCANCELLING\x10\x04\x12\r\n\tCANCELLED\x10\x05"\x85\x01\n\x16\x44\x65leteGlossaryResponse\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x0bsubmit_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xb5\r\n\x12TranslationService\x12\xf4\x01\n\rTranslateText\x12\x36.google.cloud.translation.v3beta1.TranslateTextRequest\x1a\x37.google.cloud.translation.v3beta1.TranslateTextResponse"r\x82\xd3\xe4\x93\x02l"6/v3beta1/{parent=projects/*/locations/*}:translateText:\x01*Z/"*/v3beta1/{parent=projects/*}:translateText:\x01*\x12\xf9\x01\n\x0e\x44\x65tectLanguage\x12\x37.google.cloud.translation.v3beta1.DetectLanguageRequest\x1a\x38.google.cloud.translation.v3beta1.DetectLanguageResponse"t\x82\xd3\xe4\x93\x02n"7/v3beta1/{parent=projects/*/locations/*}:detectLanguage:\x01*Z0"+/v3beta1/{parent=projects/*}:detectLanguage:\x01*\x12\x85\x02\n\x15GetSupportedLanguages\x12>.google.cloud.translation.v3beta1.GetSupportedLanguagesRequest\x1a\x34.google.cloud.translation.v3beta1.SupportedLanguages"v\x82\xd3\xe4\x93\x02p\x12;/v3beta1/{parent=projects/*/locations/*}/supportedLanguagesZ1\x12//v3beta1/{parent=projects/*}/supportedLanguages\x12\xb8\x01\n\x12\x42\x61tchTranslateText\x12;.google.cloud.translation.v3beta1.BatchTranslateTextRequest\x1a\x1d.google.longrunning.Operation"F\x82\xd3\xe4\x93\x02@";/v3beta1/{parent=projects/*/locations/*}:batchTranslateText:\x01*\x12\xaf\x01\n\x0e\x43reateGlossary\x12\x37.google.cloud.translation.v3beta1.CreateGlossaryRequest\x1a\x1d.google.longrunning.Operation"E\x82\xd3\xe4\x93\x02?"3/v3beta1/{parent=projects/*/locations/*}/glossaries:\x08glossary\x12\xc0\x01\n\x0eListGlossaries\x12\x37.google.cloud.translation.v3beta1.ListGlossariesRequest\x1a\x38.google.cloud.translation.v3beta1.ListGlossariesResponse";\x82\xd3\xe4\x93\x02\x35\x12\x33/v3beta1/{parent=projects/*/locations/*}/glossaries\x12\xac\x01\n\x0bGetGlossary\x12\x34.google.cloud.translation.v3beta1.GetGlossaryRequest\x1a*.google.cloud.translation.v3beta1.Glossary";\x82\xd3\xe4\x93\x02\x35\x12\x33/v3beta1/{name=projects/*/locations/*/glossaries/*}\x12\xa5\x01\n\x0e\x44\x65leteGlossary\x12\x37.google.cloud.translation.v3beta1.DeleteGlossaryRequest\x1a\x1d.google.longrunning.Operation";\x82\xd3\xe4\x93\x02\x35*3/v3beta1/{name=projects/*/locations/*/glossaries/*}\x1a\x1d\xca\x41\x1atranslation.googleapis.comB\xf1\x01\n"com.google.cloud.translate.v3beta1B\x17TranslationServiceProtoP\x01ZGgoogle.golang.org/genproto/googleapis/cloud/translate/v3beta1;translate\xf8\x01\x01\xaa\x02\x1eGoogle.Cloud.Translate.V3Beta1\xca\x02\x1eGoogle\\Cloud\\Translate\\V3beta1\xea\x02!Google::Cloud::Translate::V3beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_resource__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_BATCHTRANSLATEMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCEEDED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2610,
+    serialized_end=2711,
+)
+_sym_db.RegisterEnumDescriptor(_BATCHTRANSLATEMETADATA_STATE)
+
+_CREATEGLOSSARYMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.translation.v3beta1.CreateGlossaryMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCEEDED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2610,
+    serialized_end=2711,
+)
+_sym_db.RegisterEnumDescriptor(_CREATEGLOSSARYMETADATA_STATE)
+
+_DELETEGLOSSARYMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.translation.v3beta1.DeleteGlossaryMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCEEDED", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLING", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2610,
+    serialized_end=2711,
+)
+_sym_db.RegisterEnumDescriptor(_DELETEGLOSSARYMETADATA_STATE)
+
+
+_TRANSLATETEXTGLOSSARYCONFIG = _descriptor.Descriptor(
+    name="TranslateTextGlossaryConfig",
+    full_name="google.cloud.translation.v3beta1.TranslateTextGlossaryConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="glossary",
+            full_name="google.cloud.translation.v3beta1.TranslateTextGlossaryConfig.glossary",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="ignore_case",
+            full_name="google.cloud.translation.v3beta1.TranslateTextGlossaryConfig.ignore_case",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=254,
+    serialized_end=322,
+)
+
+
+_TRANSLATETEXTREQUEST = _descriptor.Descriptor(
+    name="TranslateTextRequest",
+    full_name="google.cloud.translation.v3beta1.TranslateTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="contents",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.contents",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.mime_type",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_language_code",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.source_language_code",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_language_code",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.target_language_code",
+            index=3,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.parent",
+            index=4,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.model",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="glossary_config",
+            full_name="google.cloud.translation.v3beta1.TranslateTextRequest.glossary_config",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=325,
+    serialized_end=563,
+)
+
+
+_TRANSLATETEXTRESPONSE = _descriptor.Descriptor(
+    name="TranslateTextResponse",
+    full_name="google.cloud.translation.v3beta1.TranslateTextResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="translations",
+            full_name="google.cloud.translation.v3beta1.TranslateTextResponse.translations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="glossary_translations",
+            full_name="google.cloud.translation.v3beta1.TranslateTextResponse.glossary_translations",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=566,
+    serialized_end=736,
+)
+
+
+_TRANSLATION = _descriptor.Descriptor(
+    name="Translation",
+    full_name="google.cloud.translation.v3beta1.Translation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="translated_text",
+            full_name="google.cloud.translation.v3beta1.Translation.translated_text",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.translation.v3beta1.Translation.model",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detected_language_code",
+            full_name="google.cloud.translation.v3beta1.Translation.detected_language_code",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="glossary_config",
+            full_name="google.cloud.translation.v3beta1.Translation.glossary_config",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=739,
+    serialized_end=912,
+)
+
+
+_DETECTLANGUAGEREQUEST = _descriptor.Descriptor(
+    name="DetectLanguageRequest",
+    full_name="google.cloud.translation.v3beta1.DetectLanguageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.translation.v3beta1.DetectLanguageRequest.parent",
+            index=0,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.translation.v3beta1.DetectLanguageRequest.model",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.translation.v3beta1.DetectLanguageRequest.content",
+            index=2,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.translation.v3beta1.DetectLanguageRequest.mime_type",
+            index=3,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.translation.v3beta1.DetectLanguageRequest.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=914,
+    serialized_end=1016,
+)
+
+
+_DETECTEDLANGUAGE = _descriptor.Descriptor(
+    name="DetectedLanguage",
+    full_name="google.cloud.translation.v3beta1.DetectedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.translation.v3beta1.DetectedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.translation.v3beta1.DetectedLanguage.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1018,
+    serialized_end=1079,
+)
+
+
+_DETECTLANGUAGERESPONSE = _descriptor.Descriptor(
+    name="DetectLanguageResponse",
+    full_name="google.cloud.translation.v3beta1.DetectLanguageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="languages",
+            full_name="google.cloud.translation.v3beta1.DetectLanguageResponse.languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1081,
+    serialized_end=1176,
+)
+
+
+_GETSUPPORTEDLANGUAGESREQUEST = _descriptor.Descriptor(
+    name="GetSupportedLanguagesRequest",
+    full_name="google.cloud.translation.v3beta1.GetSupportedLanguagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.translation.v3beta1.GetSupportedLanguagesRequest.parent",
+            index=0,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_language_code",
+            full_name="google.cloud.translation.v3beta1.GetSupportedLanguagesRequest.display_language_code",
+            index=1,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.translation.v3beta1.GetSupportedLanguagesRequest.model",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1178,
+    serialized_end=1270,
+)
+
+
+_SUPPORTEDLANGUAGES = _descriptor.Descriptor(
+    name="SupportedLanguages",
+    full_name="google.cloud.translation.v3beta1.SupportedLanguages",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="languages",
+            full_name="google.cloud.translation.v3beta1.SupportedLanguages.languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1272,
+    serialized_end=1364,
+)
+
+
+_SUPPORTEDLANGUAGE = _descriptor.Descriptor(
+    name="SupportedLanguage",
+    full_name="google.cloud.translation.v3beta1.SupportedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.translation.v3beta1.SupportedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.translation.v3beta1.SupportedLanguage.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="support_source",
+            full_name="google.cloud.translation.v3beta1.SupportedLanguage.support_source",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="support_target",
+            full_name="google.cloud.translation.v3beta1.SupportedLanguage.support_target",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1366,
+    serialized_end=1478,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.translation.v3beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.translation.v3beta1.GcsSource.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1480,
+    serialized_end=1510,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.translation.v3beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.translation.v3beta1.InputConfig.mime_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.translation.v3beta1.InputConfig.gcs_source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.translation.v3beta1.InputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1512,
+    serialized_end=1621,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.translation.v3beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_uri_prefix",
+            full_name="google.cloud.translation.v3beta1.GcsDestination.output_uri_prefix",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1623,
+    serialized_end=1666,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.translation.v3beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.translation.v3beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="destination",
+            full_name="google.cloud.translation.v3beta1.OutputConfig.destination",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=1668,
+    serialized_end=1774,
+)
+
+
+_BATCHTRANSLATETEXTREQUEST_MODELSENTRY = _descriptor.Descriptor(
+    name="ModelsEntry",
+    full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.ModelsEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.ModelsEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.ModelsEntry.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2210,
+    serialized_end=2255,
+)
+
+_BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY = _descriptor.Descriptor(
+    name="GlossariesEntry",
+    full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.GlossariesEntry",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.GlossariesEntry.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.GlossariesEntry.value",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=_b("8\001"),
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2257,
+    serialized_end=2369,
+)
+
+_BATCHTRANSLATETEXTREQUEST = _descriptor.Descriptor(
+    name="BatchTranslateTextRequest",
+    full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source_language_code",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.source_language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_language_codes",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.target_language_codes",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="models",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.models",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_configs",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.input_configs",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.output_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="glossaries",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateTextRequest.glossaries",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _BATCHTRANSLATETEXTREQUEST_MODELSENTRY,
+        _BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1777,
+    serialized_end=2369,
+)
+
+
+_BATCHTRANSLATEMETADATA = _descriptor.Descriptor(
+    name="BatchTranslateMetadata",
+    full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="translated_characters",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata.translated_characters",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="failed_characters",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata.failed_characters",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_characters",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata.total_characters",
+            index=3,
+            number=4,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateMetadata.submit_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BATCHTRANSLATEMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2372,
+    serialized_end=2711,
+)
+
+
+_BATCHTRANSLATERESPONSE = _descriptor.Descriptor(
+    name="BatchTranslateResponse",
+    full_name="google.cloud.translation.v3beta1.BatchTranslateResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="total_characters",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateResponse.total_characters",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="translated_characters",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateResponse.translated_characters",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="failed_characters",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateResponse.failed_characters",
+            index=2,
+            number=3,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateResponse.submit_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.translation.v3beta1.BatchTranslateResponse.end_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2714,
+    serialized_end=2917,
+)
+
+
+_GLOSSARYINPUTCONFIG = _descriptor.Descriptor(
+    name="GlossaryInputConfig",
+    full_name="google.cloud.translation.v3beta1.GlossaryInputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.translation.v3beta1.GlossaryInputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.translation.v3beta1.GlossaryInputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2919,
+    serialized_end=3017,
+)
+
+
+_GLOSSARY_LANGUAGECODEPAIR = _descriptor.Descriptor(
+    name="LanguageCodePair",
+    full_name="google.cloud.translation.v3beta1.Glossary.LanguageCodePair",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="source_language_code",
+            full_name="google.cloud.translation.v3beta1.Glossary.LanguageCodePair.source_language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_language_code",
+            full_name="google.cloud.translation.v3beta1.Glossary.LanguageCodePair.target_language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3416,
+    serialized_end=3494,
+)
+
+_GLOSSARY_LANGUAGECODESSET = _descriptor.Descriptor(
+    name="LanguageCodesSet",
+    full_name="google.cloud.translation.v3beta1.Glossary.LanguageCodesSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_codes",
+            full_name="google.cloud.translation.v3beta1.Glossary.LanguageCodesSet.language_codes",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3496,
+    serialized_end=3538,
+)
+
+_GLOSSARY = _descriptor.Descriptor(
+    name="Glossary",
+    full_name="google.cloud.translation.v3beta1.Glossary",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.translation.v3beta1.Glossary.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_pair",
+            full_name="google.cloud.translation.v3beta1.Glossary.language_pair",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_codes_set",
+            full_name="google.cloud.translation.v3beta1.Glossary.language_codes_set",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.translation.v3beta1.Glossary.input_config",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entry_count",
+            full_name="google.cloud.translation.v3beta1.Glossary.entry_count",
+            index=4,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.translation.v3beta1.Glossary.submit_time",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.translation.v3beta1.Glossary.end_time",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_GLOSSARY_LANGUAGECODEPAIR, _GLOSSARY_LANGUAGECODESSET],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="languages",
+            full_name="google.cloud.translation.v3beta1.Glossary.languages",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3020,
+    serialized_end=3551,
+)
+
+
+_CREATEGLOSSARYREQUEST = _descriptor.Descriptor(
+    name="CreateGlossaryRequest",
+    full_name="google.cloud.translation.v3beta1.CreateGlossaryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.translation.v3beta1.CreateGlossaryRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="glossary",
+            full_name="google.cloud.translation.v3beta1.CreateGlossaryRequest.glossary",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3553,
+    serialized_end=3654,
+)
+
+
+_GETGLOSSARYREQUEST = _descriptor.Descriptor(
+    name="GetGlossaryRequest",
+    full_name="google.cloud.translation.v3beta1.GetGlossaryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.translation.v3beta1.GetGlossaryRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3656,
+    serialized_end=3690,
+)
+
+
+_DELETEGLOSSARYREQUEST = _descriptor.Descriptor(
+    name="DeleteGlossaryRequest",
+    full_name="google.cloud.translation.v3beta1.DeleteGlossaryRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3692,
+    serialized_end=3729,
+)
+
+
+_LISTGLOSSARIESREQUEST = _descriptor.Descriptor(
+    name="ListGlossariesRequest",
+    full_name="google.cloud.translation.v3beta1.ListGlossariesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.translation.v3beta1.ListGlossariesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.translation.v3beta1.ListGlossariesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.translation.v3beta1.ListGlossariesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.translation.v3beta1.ListGlossariesRequest.filter",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3731,
+    serialized_end=3825,
+)
+
+
+_LISTGLOSSARIESRESPONSE = _descriptor.Descriptor(
+    name="ListGlossariesResponse",
+    full_name="google.cloud.translation.v3beta1.ListGlossariesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="glossaries",
+            full_name="google.cloud.translation.v3beta1.ListGlossariesResponse.glossaries",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.translation.v3beta1.ListGlossariesResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3827,
+    serialized_end=3940,
+)
+
+
+_CREATEGLOSSARYMETADATA = _descriptor.Descriptor(
+    name="CreateGlossaryMetadata",
+    full_name="google.cloud.translation.v3beta1.CreateGlossaryMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.translation.v3beta1.CreateGlossaryMetadata.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.translation.v3beta1.CreateGlossaryMetadata.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.translation.v3beta1.CreateGlossaryMetadata.submit_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_CREATEGLOSSARYMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3943,
+    serialized_end=4212,
+)
+
+
+_DELETEGLOSSARYMETADATA = _descriptor.Descriptor(
+    name="DeleteGlossaryMetadata",
+    full_name="google.cloud.translation.v3beta1.DeleteGlossaryMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryMetadata.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryMetadata.state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryMetadata.submit_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_DELETEGLOSSARYMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4215,
+    serialized_end=4484,
+)
+
+
+_DELETEGLOSSARYRESPONSE = _descriptor.Descriptor(
+    name="DeleteGlossaryResponse",
+    full_name="google.cloud.translation.v3beta1.DeleteGlossaryResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryResponse.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryResponse.submit_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.translation.v3beta1.DeleteGlossaryResponse.end_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4487,
+    serialized_end=4620,
+)
+
+_TRANSLATETEXTREQUEST.fields_by_name[
+    "glossary_config"
+].message_type = _TRANSLATETEXTGLOSSARYCONFIG
+_TRANSLATETEXTRESPONSE.fields_by_name["translations"].message_type = _TRANSLATION
+_TRANSLATETEXTRESPONSE.fields_by_name[
+    "glossary_translations"
+].message_type = _TRANSLATION
+_TRANSLATION.fields_by_name[
+    "glossary_config"
+].message_type = _TRANSLATETEXTGLOSSARYCONFIG
+_DETECTLANGUAGEREQUEST.oneofs_by_name["source"].fields.append(
+    _DETECTLANGUAGEREQUEST.fields_by_name["content"]
+)
+_DETECTLANGUAGEREQUEST.fields_by_name[
+    "content"
+].containing_oneof = _DETECTLANGUAGEREQUEST.oneofs_by_name["source"]
+_DETECTLANGUAGERESPONSE.fields_by_name["languages"].message_type = _DETECTEDLANGUAGE
+_SUPPORTEDLANGUAGES.fields_by_name["languages"].message_type = _SUPPORTEDLANGUAGE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_INPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _INPUTCONFIG.fields_by_name["gcs_source"]
+)
+_INPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _INPUTCONFIG.oneofs_by_name["source"]
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OUTPUTCONFIG.oneofs_by_name["destination"].fields.append(
+    _OUTPUTCONFIG.fields_by_name["gcs_destination"]
+)
+_OUTPUTCONFIG.fields_by_name[
+    "gcs_destination"
+].containing_oneof = _OUTPUTCONFIG.oneofs_by_name["destination"]
+_BATCHTRANSLATETEXTREQUEST_MODELSENTRY.containing_type = _BATCHTRANSLATETEXTREQUEST
+_BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY.fields_by_name[
+    "value"
+].message_type = _TRANSLATETEXTGLOSSARYCONFIG
+_BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY.containing_type = _BATCHTRANSLATETEXTREQUEST
+_BATCHTRANSLATETEXTREQUEST.fields_by_name[
+    "models"
+].message_type = _BATCHTRANSLATETEXTREQUEST_MODELSENTRY
+_BATCHTRANSLATETEXTREQUEST.fields_by_name["input_configs"].message_type = _INPUTCONFIG
+_BATCHTRANSLATETEXTREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_BATCHTRANSLATETEXTREQUEST.fields_by_name[
+    "glossaries"
+].message_type = _BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY
+_BATCHTRANSLATEMETADATA.fields_by_name[
+    "state"
+].enum_type = _BATCHTRANSLATEMETADATA_STATE
+_BATCHTRANSLATEMETADATA.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHTRANSLATEMETADATA_STATE.containing_type = _BATCHTRANSLATEMETADATA
+_BATCHTRANSLATERESPONSE.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHTRANSLATERESPONSE.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GLOSSARYINPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_GLOSSARYINPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _GLOSSARYINPUTCONFIG.fields_by_name["gcs_source"]
+)
+_GLOSSARYINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _GLOSSARYINPUTCONFIG.oneofs_by_name["source"]
+_GLOSSARY_LANGUAGECODEPAIR.containing_type = _GLOSSARY
+_GLOSSARY_LANGUAGECODESSET.containing_type = _GLOSSARY
+_GLOSSARY.fields_by_name["language_pair"].message_type = _GLOSSARY_LANGUAGECODEPAIR
+_GLOSSARY.fields_by_name["language_codes_set"].message_type = _GLOSSARY_LANGUAGECODESSET
+_GLOSSARY.fields_by_name["input_config"].message_type = _GLOSSARYINPUTCONFIG
+_GLOSSARY.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GLOSSARY.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_GLOSSARY.oneofs_by_name["languages"].fields.append(
+    _GLOSSARY.fields_by_name["language_pair"]
+)
+_GLOSSARY.fields_by_name["language_pair"].containing_oneof = _GLOSSARY.oneofs_by_name[
+    "languages"
+]
+_GLOSSARY.oneofs_by_name["languages"].fields.append(
+    _GLOSSARY.fields_by_name["language_codes_set"]
+)
+_GLOSSARY.fields_by_name[
+    "language_codes_set"
+].containing_oneof = _GLOSSARY.oneofs_by_name["languages"]
+_CREATEGLOSSARYREQUEST.fields_by_name["glossary"].message_type = _GLOSSARY
+_LISTGLOSSARIESRESPONSE.fields_by_name["glossaries"].message_type = _GLOSSARY
+_CREATEGLOSSARYMETADATA.fields_by_name[
+    "state"
+].enum_type = _CREATEGLOSSARYMETADATA_STATE
+_CREATEGLOSSARYMETADATA.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_CREATEGLOSSARYMETADATA_STATE.containing_type = _CREATEGLOSSARYMETADATA
+_DELETEGLOSSARYMETADATA.fields_by_name[
+    "state"
+].enum_type = _DELETEGLOSSARYMETADATA_STATE
+_DELETEGLOSSARYMETADATA.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DELETEGLOSSARYMETADATA_STATE.containing_type = _DELETEGLOSSARYMETADATA
+_DELETEGLOSSARYRESPONSE.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_DELETEGLOSSARYRESPONSE.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+DESCRIPTOR.message_types_by_name[
+    "TranslateTextGlossaryConfig"
+] = _TRANSLATETEXTGLOSSARYCONFIG
+DESCRIPTOR.message_types_by_name["TranslateTextRequest"] = _TRANSLATETEXTREQUEST
+DESCRIPTOR.message_types_by_name["TranslateTextResponse"] = _TRANSLATETEXTRESPONSE
+DESCRIPTOR.message_types_by_name["Translation"] = _TRANSLATION
+DESCRIPTOR.message_types_by_name["DetectLanguageRequest"] = _DETECTLANGUAGEREQUEST
+DESCRIPTOR.message_types_by_name["DetectedLanguage"] = _DETECTEDLANGUAGE
+DESCRIPTOR.message_types_by_name["DetectLanguageResponse"] = _DETECTLANGUAGERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "GetSupportedLanguagesRequest"
+] = _GETSUPPORTEDLANGUAGESREQUEST
+DESCRIPTOR.message_types_by_name["SupportedLanguages"] = _SUPPORTEDLANGUAGES
+DESCRIPTOR.message_types_by_name["SupportedLanguage"] = _SUPPORTEDLANGUAGE
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name[
+    "BatchTranslateTextRequest"
+] = _BATCHTRANSLATETEXTREQUEST
+DESCRIPTOR.message_types_by_name["BatchTranslateMetadata"] = _BATCHTRANSLATEMETADATA
+DESCRIPTOR.message_types_by_name["BatchTranslateResponse"] = _BATCHTRANSLATERESPONSE
+DESCRIPTOR.message_types_by_name["GlossaryInputConfig"] = _GLOSSARYINPUTCONFIG
+DESCRIPTOR.message_types_by_name["Glossary"] = _GLOSSARY
+DESCRIPTOR.message_types_by_name["CreateGlossaryRequest"] = _CREATEGLOSSARYREQUEST
+DESCRIPTOR.message_types_by_name["GetGlossaryRequest"] = _GETGLOSSARYREQUEST
+DESCRIPTOR.message_types_by_name["DeleteGlossaryRequest"] = _DELETEGLOSSARYREQUEST
+DESCRIPTOR.message_types_by_name["ListGlossariesRequest"] = _LISTGLOSSARIESREQUEST
+DESCRIPTOR.message_types_by_name["ListGlossariesResponse"] = _LISTGLOSSARIESRESPONSE
+DESCRIPTOR.message_types_by_name["CreateGlossaryMetadata"] = _CREATEGLOSSARYMETADATA
+DESCRIPTOR.message_types_by_name["DeleteGlossaryMetadata"] = _DELETEGLOSSARYMETADATA
+DESCRIPTOR.message_types_by_name["DeleteGlossaryResponse"] = _DELETEGLOSSARYRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TranslateTextGlossaryConfig = _reflection.GeneratedProtocolMessageType(
+    "TranslateTextGlossaryConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATETEXTGLOSSARYCONFIG,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Configures which glossary should be used for a specific target language,
+  and defines options for applying that glossary.
+  
+  
+  Attributes:
+      glossary:
+          Required. Specifies the glossary used for this translation.
+          Use this format: projects/\ */locations/*/glossaries/\*
+      ignore_case:
+          Optional. Indicates match is case-insensitive. Default value
+          is false if missing.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.TranslateTextGlossaryConfig)
+    ),
+)
+_sym_db.RegisterMessage(TranslateTextGlossaryConfig)
+
+TranslateTextRequest = _reflection.GeneratedProtocolMessageType(
+    "TranslateTextRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATETEXTREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The request message for synchronous translation.
+  
+  
+  Attributes:
+      contents:
+          Required. The content of the input in string format. We
+          recommend the total content be less than 30k codepoints. Use
+          BatchTranslateText for larger text.
+      mime_type:
+          Optional. The format of the source text, for example,
+          "text/html", "text/plain". If left blank, the MIME type
+          defaults to "text/html".
+      source_language_code:
+          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.
+      target_language_code:
+          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.
+      parent:
+          Required. Location to make a regional or global call.  Format:
+          ``projects/{project-id}/locations/{location-id}``.  For global
+          calls, use ``projects/{project-id}/locations/global``.  Models
+          and glossaries must be within the same region (have same
+          location-id), otherwise an INVALID\_ARGUMENT (400) error is
+          returned.
+      model:
+          Optional. The ``model`` type requested for this translation.
+          The format depends on model type:  -  AutoML Translation
+          models:    ``projects/{project-id}/locations/{location-
+          id}/models/{model-id}``  -  General (built-in) models:
+          ``projects/{project-id}/locations/{location-
+          id}/models/general/nmt``,    ``projects/{project-
+          id}/locations/{location-id}/models/general/base``  For global
+          (non-regionalized) requests, use ``location-id`` ``global``.
+          For example, ``projects/{project-
+          id}/locations/global/models/general/nmt``.  If missing, the
+          system decides which google base model to use.
+      glossary_config:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.TranslateTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(TranslateTextRequest)
+
+TranslateTextResponse = _reflection.GeneratedProtocolMessageType(
+    "TranslateTextResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATETEXTRESPONSE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""
+    Attributes:
+      translations:
+          Text translation responses with no glossary applied. This
+          field has the same length as [``contents``][google.cloud.trans
+          lation.v3beta1.TranslateTextRequest.contents].
+      glossary_translations:
+          Text translation responses if a glossary is provided in the
+          request. This can be the same as [``translations``][google.clo
+          ud.translation.v3beta1.TranslateTextResponse.translations] if
+          no terms apply. This field has the same length as [``contents``][google.cloud.translation.v3beta1.TranslateTextRequest.contents].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.TranslateTextResponse)
+    ),
+)
+_sym_db.RegisterMessage(TranslateTextResponse)
+
+Translation = _reflection.GeneratedProtocolMessageType(
+    "Translation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRANSLATION,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""A single translation response.
+  
+  
+  Attributes:
+      translated_text:
+          Text translated into the target language.
+      model:
+          Only present when ``model`` is present in the request. This is
+          same as ``model`` provided in the request.
+      detected_language_code:
+          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.
+      glossary_config:
+          The ``glossary_config`` used for this translation.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.Translation)
+    ),
+)
+_sym_db.RegisterMessage(Translation)
+
+DetectLanguageRequest = _reflection.GeneratedProtocolMessageType(
+    "DetectLanguageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DETECTLANGUAGEREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The request message for language detection.
+  
+  
+  Attributes:
+      parent:
+          Required. Location to make a regional or global call.  Format:
+          ``projects/{project-id}/locations/{location-id}``.  For global
+          calls, use ``projects/{project-id}/locations/global``.  Only
+          models within the same region (has same location-id) can be
+          used. Otherwise an INVALID\_ARGUMENT (400) error is returned.
+      model:
+          Optional. The language detection model to be used.  Format:
+          ``projects/{project-id}/locations/{location-
+          id}/models/language-detection/{model-id}``  Only one language
+          detection model is currently supported: ``projects/{project-
+          id}/locations/{location-id}/models/language-
+          detection/default``.  If not specified, the default model is
+          used.
+      source:
+          Required. The source of the document from which to detect the
+          language.
+      content:
+          The content of the input stored as a string.
+      mime_type:
+          Optional. The format of the source text, for example,
+          "text/html", "text/plain". If left blank, the MIME type
+          defaults to "text/html".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.DetectLanguageRequest)
+    ),
+)
+_sym_db.RegisterMessage(DetectLanguageRequest)
+
+DetectedLanguage = _reflection.GeneratedProtocolMessageType(
+    "DetectedLanguage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DETECTEDLANGUAGE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The response message for language detection.
+  
+  
+  Attributes:
+      language_code:
+          The BCP-47 language code of source content in the request,
+          detected automatically.
+      confidence:
+          The confidence of the detection result for this language.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.DetectedLanguage)
+    ),
+)
+_sym_db.RegisterMessage(DetectedLanguage)
+
+DetectLanguageResponse = _reflection.GeneratedProtocolMessageType(
+    "DetectLanguageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DETECTLANGUAGERESPONSE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The response message for language detection.
+  
+  
+  Attributes:
+      languages:
+          A list of detected languages sorted by detection confidence in
+          descending order. The most probable language first.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.DetectLanguageResponse)
+    ),
+)
+_sym_db.RegisterMessage(DetectLanguageResponse)
+
+GetSupportedLanguagesRequest = _reflection.GeneratedProtocolMessageType(
+    "GetSupportedLanguagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSUPPORTEDLANGUAGESREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The request message for discovering supported languages.
+  
+  
+  Attributes:
+      parent:
+          Required. Location to make a regional or global call.  Format:
+          ``projects/{project-id}/locations/{location-id}``.  For global
+          calls, use ``projects/{project-id}/locations/global``.  Only
+          models within the same region (have same location-id) can be
+          used, otherwise an INVALID\_ARGUMENT (400) error is returned.
+      display_language_code:
+          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.
+      model:
+          Optional. Get supported languages of this model.  The format
+          depends on model type:  -  AutoML Translation models:
+          ``projects/{project-id}/locations/{location-id}/models/{model-
+          id}``  -  General (built-in) models:    ``projects/{project-
+          id}/locations/{location-id}/models/general/nmt``,
+          ``projects/{project-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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.GetSupportedLanguagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetSupportedLanguagesRequest)
+
+SupportedLanguages = _reflection.GeneratedProtocolMessageType(
+    "SupportedLanguages",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SUPPORTEDLANGUAGES,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The response message for discovering supported languages.
+  
+  
+  Attributes:
+      languages:
+          A list of supported language responses. This list contains an
+          entry for each language the Translation API supports.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.SupportedLanguages)
+    ),
+)
+_sym_db.RegisterMessage(SupportedLanguages)
+
+SupportedLanguage = _reflection.GeneratedProtocolMessageType(
+    "SupportedLanguage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SUPPORTEDLANGUAGE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""A single supported language response corresponds to information related
+  to one supported language.
+  
+  
+  Attributes:
+      language_code:
+          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')
+      display_name:
+          Human readable name of the language localized in the display
+          language specified in the request.
+      support_source:
+          Can be used as source language.
+      support_target:
+          Can be used as target language.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.SupportedLanguage)
+    ),
+)
+_sym_db.RegisterMessage(SupportedLanguage)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The Google Cloud Storage location for the input content.
+  
+  
+  Attributes:
+      input_uri:
+          Required. Source data URI. For example,
+          ``gs://my_bucket/my_object``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Input configuration for BatchTranslateText request.
+  
+  
+  Attributes:
+      mime_type:
+          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.
+      source:
+          Required. Specify the input.
+      gcs_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=':raw-
+          latex:`\t`' your\_input\_file.tsv  The other supported file
+          extensions are ``.txt`` or ``.html``, which is treated as a
+          single large chunk of text.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The Google Cloud Storage location for the output content
+  
+  
+  Attributes:
+      output_uri_prefix:
+          Required. There must be no files under 'output\_uri\_prefix'.
+          'output\_uri\_prefix' must end with "/", otherwise an
+          INVALID\_ARGUMENT (400) error is returned..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Output configuration for BatchTranslateText request.
+  
+  
+  Attributes:
+      destination:
+          Required. The destination of output.
+      gcs_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\_t
+          est/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://transl
+          ation\_test/a\_b\_c\_'trg'\_glossary\_errors.[extension]
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+BatchTranslateTextRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchTranslateTextRequest",
+    (_message.Message,),
+    dict(
+        ModelsEntry=_reflection.GeneratedProtocolMessageType(
+            "ModelsEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BATCHTRANSLATETEXTREQUEST_MODELSENTRY,
+                __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.BatchTranslateTextRequest.ModelsEntry)
+            ),
+        ),
+        GlossariesEntry=_reflection.GeneratedProtocolMessageType(
+            "GlossariesEntry",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY,
+                __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2"
+                # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.BatchTranslateTextRequest.GlossariesEntry)
+            ),
+        ),
+        DESCRIPTOR=_BATCHTRANSLATETEXTREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""The batch translation request.
+  
+  
+  Attributes:
+      parent:
+          Required. Location to make a regional call.  Format:
+          ``projects/{project-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.
+      source_language_code:
+          Required. Source language code.
+      target_language_codes:
+          Required. Specify up to 10 language codes here.
+      models:
+          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-id}/locations/{location-
+          id}/models/{model-id}``  -  General (built-in) models:
+          ``projects/{project-id}/locations/{location-
+          id}/models/general/nmt``,    ``projects/{project-
+          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.
+      input_configs:
+          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.
+      output_config:
+          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.
+      glossaries:
+          Optional. Glossaries to be applied for translation. It's keyed
+          by target language code.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.BatchTranslateTextRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchTranslateTextRequest)
+_sym_db.RegisterMessage(BatchTranslateTextRequest.ModelsEntry)
+_sym_db.RegisterMessage(BatchTranslateTextRequest.GlossariesEntry)
+
+BatchTranslateMetadata = _reflection.GeneratedProtocolMessageType(
+    "BatchTranslateMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHTRANSLATEMETADATA,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""State metadata for the batch translation operation.
+  
+  
+  Attributes:
+      state:
+          The state of the operation.
+      translated_characters:
+          Number of successfully translated characters so far (Unicode
+          codepoints).
+      failed_characters:
+          Number of characters that have failed to process so far
+          (Unicode codepoints).
+      total_characters:
+          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.
+      submit_time:
+          Time when the operation was submitted.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.BatchTranslateMetadata)
+    ),
+)
+_sym_db.RegisterMessage(BatchTranslateMetadata)
+
+BatchTranslateResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchTranslateResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHTRANSLATERESPONSE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Stored in the
+  [google.longrunning.Operation.response][google.longrunning.Operation.response]
+  field returned by BatchTranslateText if at least one sentence is
+  translated successfully.
+  
+  
+  Attributes:
+      total_characters:
+          Total number of characters (Unicode codepoints).
+      translated_characters:
+          Number of successfully translated characters (Unicode
+          codepoints).
+      failed_characters:
+          Number of characters that have failed to process (Unicode
+          codepoints).
+      submit_time:
+          Time when the operation was submitted.
+      end_time:
+          The time when the operation is finished and [google.longrunnin
+          g.Operation.done][google.longrunning.Operation.done] is set to
+          true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.BatchTranslateResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchTranslateResponse)
+
+GlossaryInputConfig = _reflection.GeneratedProtocolMessageType(
+    "GlossaryInputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GLOSSARYINPUTCONFIG,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Input configuration for glossaries.
+  
+  
+  Attributes:
+      source:
+          Required. Specify the input.
+      gcs_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>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.GlossaryInputConfig)
+    ),
+)
+_sym_db.RegisterMessage(GlossaryInputConfig)
+
+Glossary = _reflection.GeneratedProtocolMessageType(
+    "Glossary",
+    (_message.Message,),
+    dict(
+        LanguageCodePair=_reflection.GeneratedProtocolMessageType(
+            "LanguageCodePair",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GLOSSARY_LANGUAGECODEPAIR,
+                __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+                __doc__="""Used with unidirectional glossaries.
+    
+    
+    Attributes:
+        source_language_code:
+            Required. The BCP-47 language code of the input text, for
+            example, "en-US". Expected to be an exact match for
+            GlossaryTerm.language\_code.
+        target_language_code:
+            Required. The BCP-47 language code for translation output, for
+            example, "zh-CN". Expected to be an exact match for
+            GlossaryTerm.language\_code.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.Glossary.LanguageCodePair)
+            ),
+        ),
+        LanguageCodesSet=_reflection.GeneratedProtocolMessageType(
+            "LanguageCodesSet",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_GLOSSARY_LANGUAGECODESSET,
+                __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+                __doc__="""Used with equivalent term set glossaries.
+    
+    
+    Attributes:
+        language_codes:
+            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.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.Glossary.LanguageCodesSet)
+            ),
+        ),
+        DESCRIPTOR=_GLOSSARY,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Represents a glossary built from user provided data.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the glossary. Glossary names
+          have the form ``projects/{project-id}/locations/{location-
+          id}/glossaries/{glossary-id}``.
+      languages:
+          Languages supported by the glossary.
+      language_pair:
+          Used with unidirectional glossaries.
+      language_codes_set:
+          Used with equivalent term set glossaries.
+      input_config:
+          Required. Provides examples to build the glossary from. Total
+          glossary must not exceed 10M Unicode codepoints.
+      entry_count:
+          Output only. The number of entries defined in the glossary.
+      submit_time:
+          Output only. When CreateGlossary was called.
+      end_time:
+          Output only. When the glossary creation was finished.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.Glossary)
+    ),
+)
+_sym_db.RegisterMessage(Glossary)
+_sym_db.RegisterMessage(Glossary.LanguageCodePair)
+_sym_db.RegisterMessage(Glossary.LanguageCodesSet)
+
+CreateGlossaryRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateGlossaryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEGLOSSARYREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Request message for CreateGlossary.
+  
+  
+  Attributes:
+      parent:
+          Required. The project name.
+      glossary:
+          Required. The glossary to create.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.CreateGlossaryRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateGlossaryRequest)
+
+GetGlossaryRequest = _reflection.GeneratedProtocolMessageType(
+    "GetGlossaryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETGLOSSARYREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Request message for GetGlossary.
+  
+  
+  Attributes:
+      name:
+          Required. The name of the glossary to retrieve.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.GetGlossaryRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetGlossaryRequest)
+
+DeleteGlossaryRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteGlossaryRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEGLOSSARYREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Request message for DeleteGlossary.
+  
+  
+  Attributes:
+      name:
+          Required. The name of the glossary to delete.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.DeleteGlossaryRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteGlossaryRequest)
+
+ListGlossariesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListGlossariesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGLOSSARIESREQUEST,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Request message for ListGlossaries.
+  
+  
+  Attributes:
+      parent:
+          Required. The name of the project from which to list all of
+          the glossaries.
+      page_size:
+          Optional. Requested page size. The server may return fewer
+          glossaries than requested. If unspecified, the server picks an
+          appropriate default.
+      page_token:
+          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.
+      filter:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.ListGlossariesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListGlossariesRequest)
+
+ListGlossariesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListGlossariesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTGLOSSARIESRESPONSE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Response message for ListGlossaries.
+  
+  
+  Attributes:
+      glossaries:
+          The list of glossaries for a project.
+      next_page_token:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.ListGlossariesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListGlossariesResponse)
+
+CreateGlossaryMetadata = _reflection.GeneratedProtocolMessageType(
+    "CreateGlossaryMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEGLOSSARYMETADATA,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Stored in the
+  [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata]
+  field returned by CreateGlossary.
+  
+  
+  Attributes:
+      name:
+          The name of the glossary that is being created.
+      state:
+          The current state of the glossary creation operation.
+      submit_time:
+          The time when the operation was submitted to the server.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.CreateGlossaryMetadata)
+    ),
+)
+_sym_db.RegisterMessage(CreateGlossaryMetadata)
+
+DeleteGlossaryMetadata = _reflection.GeneratedProtocolMessageType(
+    "DeleteGlossaryMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEGLOSSARYMETADATA,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Stored in the
+  [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata]
+  field returned by DeleteGlossary.
+  
+  
+  Attributes:
+      name:
+          The name of the glossary that is being deleted.
+      state:
+          The current state of the glossary deletion operation.
+      submit_time:
+          The time when the operation was submitted to the server.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.DeleteGlossaryMetadata)
+    ),
+)
+_sym_db.RegisterMessage(DeleteGlossaryMetadata)
+
+DeleteGlossaryResponse = _reflection.GeneratedProtocolMessageType(
+    "DeleteGlossaryResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEGLOSSARYRESPONSE,
+        __module__="google.cloud.translation_v3beta1.proto.translation_service_pb2",
+        __doc__="""Stored in the
+  [google.longrunning.Operation.response][google.longrunning.Operation.response]
+  field returned by DeleteGlossary.
+  
+  
+  Attributes:
+      name:
+          The name of the deleted glossary.
+      submit_time:
+          The time when the operation was submitted to the server.
+      end_time:
+          The time when the glossary deletion is finished and [google.lo
+          ngrunning.Operation.done][google.longrunning.Operation.done]
+          is set to true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.translation.v3beta1.DeleteGlossaryResponse)
+    ),
+)
+_sym_db.RegisterMessage(DeleteGlossaryResponse)
+
+
+DESCRIPTOR._options = None
+_BATCHTRANSLATETEXTREQUEST_MODELSENTRY._options = None
+_BATCHTRANSLATETEXTREQUEST_GLOSSARIESENTRY._options = None
+
+_TRANSLATIONSERVICE = _descriptor.ServiceDescriptor(
+    name="TranslationService",
+    full_name="google.cloud.translation.v3beta1.TranslationService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b("\312A\032translation.googleapis.com"),
+    serialized_start=4623,
+    serialized_end=6340,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="TranslateText",
+            full_name="google.cloud.translation.v3beta1.TranslationService.TranslateText",
+            index=0,
+            containing_service=None,
+            input_type=_TRANSLATETEXTREQUEST,
+            output_type=_TRANSLATETEXTRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002l"6/v3beta1/{parent=projects/*/locations/*}:translateText:\001*Z/"*/v3beta1/{parent=projects/*}:translateText:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DetectLanguage",
+            full_name="google.cloud.translation.v3beta1.TranslationService.DetectLanguage",
+            index=1,
+            containing_service=None,
+            input_type=_DETECTLANGUAGEREQUEST,
+            output_type=_DETECTLANGUAGERESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002n"7/v3beta1/{parent=projects/*/locations/*}:detectLanguage:\001*Z0"+/v3beta1/{parent=projects/*}:detectLanguage:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetSupportedLanguages",
+            full_name="google.cloud.translation.v3beta1.TranslationService.GetSupportedLanguages",
+            index=2,
+            containing_service=None,
+            input_type=_GETSUPPORTEDLANGUAGESREQUEST,
+            output_type=_SUPPORTEDLANGUAGES,
+            serialized_options=_b(
+                "\202\323\344\223\002p\022;/v3beta1/{parent=projects/*/locations/*}/supportedLanguagesZ1\022//v3beta1/{parent=projects/*}/supportedLanguages"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchTranslateText",
+            full_name="google.cloud.translation.v3beta1.TranslationService.BatchTranslateText",
+            index=3,
+            containing_service=None,
+            input_type=_BATCHTRANSLATETEXTREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002@";/v3beta1/{parent=projects/*/locations/*}:batchTranslateText:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateGlossary",
+            full_name="google.cloud.translation.v3beta1.TranslationService.CreateGlossary",
+            index=4,
+            containing_service=None,
+            input_type=_CREATEGLOSSARYREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002?"3/v3beta1/{parent=projects/*/locations/*}/glossaries:\010glossary'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListGlossaries",
+            full_name="google.cloud.translation.v3beta1.TranslationService.ListGlossaries",
+            index=5,
+            containing_service=None,
+            input_type=_LISTGLOSSARIESREQUEST,
+            output_type=_LISTGLOSSARIESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v3beta1/{parent=projects/*/locations/*}/glossaries"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetGlossary",
+            full_name="google.cloud.translation.v3beta1.TranslationService.GetGlossary",
+            index=6,
+            containing_service=None,
+            input_type=_GETGLOSSARYREQUEST,
+            output_type=_GLOSSARY,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v3beta1/{name=projects/*/locations/*/glossaries/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteGlossary",
+            full_name="google.cloud.translation.v3beta1.TranslationService.DeleteGlossary",
+            index=7,
+            containing_service=None,
+            input_type=_DELETEGLOSSARYREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                "\202\323\344\223\0025*3/v3beta1/{name=projects/*/locations/*/glossaries/*}"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_TRANSLATIONSERVICE)
+
+DESCRIPTOR.services_by_name["TranslationService"] = _TRANSLATIONSERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/translate/google/cloud/translate_v3beta1/proto/translation_service_pb2_grpc.py b/translate/google/cloud/translate_v3beta1/proto/translation_service_pb2_grpc.py
new file mode 100644
index 000000000000..695f79923a4a
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/proto/translation_service_pb2_grpc.py
@@ -0,0 +1,186 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.translate_v3beta1.proto import (
+    translation_service_pb2 as google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class TranslationServiceStub(object):
+    """Proto file for the Cloud Translation API (v3beta1).
+
+  Provides natural language translation operations.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.TranslateText = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/TranslateText",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.TranslateTextRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.TranslateTextResponse.FromString,
+        )
+        self.DetectLanguage = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/DetectLanguage",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.DetectLanguageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.DetectLanguageResponse.FromString,
+        )
+        self.GetSupportedLanguages = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/GetSupportedLanguages",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.GetSupportedLanguagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.SupportedLanguages.FromString,
+        )
+        self.BatchTranslateText = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/BatchTranslateText",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.BatchTranslateTextRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.CreateGlossary = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/CreateGlossary",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.CreateGlossaryRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.ListGlossaries = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/ListGlossaries",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.ListGlossariesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.ListGlossariesResponse.FromString,
+        )
+        self.GetGlossary = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/GetGlossary",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.GetGlossaryRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.Glossary.FromString,
+        )
+        self.DeleteGlossary = channel.unary_unary(
+            "/google.cloud.translation.v3beta1.TranslationService/DeleteGlossary",
+            request_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.DeleteGlossaryRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class TranslationServiceServicer(object):
+    """Proto file for the Cloud Translation API (v3beta1).
+
+  Provides natural language translation operations.
+  """
+
+    def TranslateText(self, request, context):
+        """Translates input text and returns translated text.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DetectLanguage(self, request, context):
+        """Detects the language of text within a request.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetSupportedLanguages(self, request, context):
+        """Returns a list of supported languages for translation.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchTranslateText(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateGlossary(self, request, context):
+        """Creates a glossary and returns the long-running operation. Returns
+    NOT_FOUND, if the project doesn't exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListGlossaries(self, request, context):
+        """Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't
+    exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetGlossary(self, request, context):
+        """Gets a glossary. Returns NOT_FOUND, if the glossary doesn't
+    exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteGlossary(self, request, context):
+        """Deletes a glossary, or cancels glossary construction
+    if the glossary isn't created yet.
+    Returns NOT_FOUND, if the glossary doesn't exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_TranslationServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "TranslateText": grpc.unary_unary_rpc_method_handler(
+            servicer.TranslateText,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.TranslateTextRequest.FromString,
+            response_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.TranslateTextResponse.SerializeToString,
+        ),
+        "DetectLanguage": grpc.unary_unary_rpc_method_handler(
+            servicer.DetectLanguage,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.DetectLanguageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.DetectLanguageResponse.SerializeToString,
+        ),
+        "GetSupportedLanguages": grpc.unary_unary_rpc_method_handler(
+            servicer.GetSupportedLanguages,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.GetSupportedLanguagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.SupportedLanguages.SerializeToString,
+        ),
+        "BatchTranslateText": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchTranslateText,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.BatchTranslateTextRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "CreateGlossary": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateGlossary,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.CreateGlossaryRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "ListGlossaries": grpc.unary_unary_rpc_method_handler(
+            servicer.ListGlossaries,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.ListGlossariesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.ListGlossariesResponse.SerializeToString,
+        ),
+        "GetGlossary": grpc.unary_unary_rpc_method_handler(
+            servicer.GetGlossary,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.GetGlossaryRequest.FromString,
+            response_serializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.Glossary.SerializeToString,
+        ),
+        "DeleteGlossary": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteGlossary,
+            request_deserializer=google_dot_cloud_dot_translation__v3beta1_dot_proto_dot_translation__service__pb2.DeleteGlossaryRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.translation.v3beta1.TranslationService", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/translate/google/cloud/translate_v3beta1/types.py b/translate/google/cloud/translate_v3beta1/types.py
new file mode 100644
index 000000000000..41868ccff503
--- /dev/null
+++ b/translate/google/cloud/translate_v3beta1/types.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.translate_v3beta1.proto import translation_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [translation_service_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.translate_v3beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/translate/noxfile.py b/translate/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/translate/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/translate/pylint.config.py b/translate/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/translate/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/translate/setup.cfg b/translate/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/translate/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/translate/setup.py b/translate/setup.py
new file mode 100644
index 000000000000..5bacdb534155
--- /dev/null
+++ b/translate/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-translate"
+description = "Google Cloud Translation API client library"
+version = "1.6.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    "google-cloud-core >= 1.0.3, < 2.0dev",
+]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/translate/synth.metadata b/translate/synth.metadata
new file mode 100644
index 000000000000..cd7d315b9cbf
--- /dev/null
+++ b/translate/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:45:19.878568Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "translate",
+        "apiVersion": "v3beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/translate/artman_translate_v3beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/translate/synth.py b/translate/synth.py
new file mode 100644
index 000000000000..dd81273af78b
--- /dev/null
+++ b/translate/synth.py
@@ -0,0 +1,82 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v3beta1"]
+
+excludes = [
+    "setup.py",
+    "nox*.py",
+    "README.rst",
+    "docs/conf.py",
+    "docs/index.rst",
+    "translation.py",
+]
+
+# ----------------------------------------------------------------------------
+# Generate asset GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("translate", version, include_protos=True)
+
+    # s.move(library / f'google/cloud/translation_{version}', f'google/cloud/translate_{version}', excludes=excludes)
+    s.move(library / f"google/cloud/translate_{version}", excludes=excludes)
+    s.move(library / "tests")
+    s.move(library / f"docs/gapic/{version}")
+
+# translation -> translate
+s.replace(
+    "google/**/translation_service_pb2_grpc.py",
+    "google.cloud.translation_v3beta1.proto",
+    "google.cloud.translate_v3beta1.proto",
+)
+
+s.replace(
+    "google/cloud/**/translation_service_pb2.py",
+    r"""record delimiters are ':raw-latex:`\\n`' instead of
+          ':raw-latex:`\\r`:raw-latex:`\\n`'.""",
+    r"""record delimiters are ``\\\\\\\\n`` instead of
+          ``\\\\\\\\r\\\\\\\\n``.""",
+)
+
+# Fix docstring issue for classes with no summary line
+s.replace(
+    "google/cloud/**/proto/*_pb2.py",
+    '''__doc__ = """Attributes:''',
+    '''__doc__ = """
+    Attributes:''',
+)
+
+# Fix wrapping for literal string
+s.replace(
+    "google/cloud/**/translation_service_pb2.py",
+    r"""This field has the same length as \[``contents`
+\s+`\]\[google\.cloud\.translation\.v3beta1\.TranslateTextRequest\.conte
+\s+nts\]\.""",
+    """This field has the same length as [``contents``][google.cloud.translation.v3beta1.TranslateTextRequest.contents].""",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = gcp.CommonTemplates().py_library(unit_cov_level=100, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/translate/tests/__init__.py b/translate/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/translate/tests/system.py b/translate/tests/system.py
new file mode 100644
index 000000000000..c586411b6111
--- /dev/null
+++ b/translate/tests/system.py
@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import unittest
+
+from google.cloud import translate
+
+
+class Config(object):
+    """Run-time configuration to be modified at set-up.
+
+    This is a mutable stand-in to allow test set-up to modify
+    global state.
+    """
+
+    CLIENT = None
+
+
+def setUpModule():
+    Config.CLIENT = translate.Client()
+
+
+class TestTranslate(unittest.TestCase):
+    def test_get_languages(self):
+        result = Config.CLIENT.get_languages()
+        # There are **many** more than 10 languages.
+        self.assertGreater(len(result), 10)
+
+        lang_map = {val["language"]: val["name"] for val in result}
+        self.assertEqual(lang_map["en"], "English")
+        self.assertEqual(lang_map["ja"], "Japanese")
+        self.assertEqual(lang_map["lv"], "Latvian")
+        self.assertEqual(lang_map["zu"], "Zulu")
+
+    def test_detect_language(self):
+        values = ["takoy", u"fa\xe7ade", "s'il vous plait"]
+        detections = Config.CLIENT.detect_language(values)
+        self.assertEqual(len(values), len(detections))
+        self.assertEqual(detections[0]["language"], "ru")
+        self.assertEqual(detections[1]["language"], "fr")
+        self.assertEqual(detections[2]["language"], "fr")
+
+    def test_translate(self):
+        values = ["petnaest", "dek kvin", "Me llamo Jeff", "My name is Jeff"]
+        translations = Config.CLIENT.translate(
+            values, target_language="de", model="nmt"
+        )
+        self.assertEqual(len(values), len(translations))
+
+        self.assertEqual(translations[0]["detectedSourceLanguage"].lower(), "hr")
+        self.assertEqual(translations[0]["translatedText"].lower(), u"fünfzehn")
+
+        self.assertEqual(translations[1]["detectedSourceLanguage"], "eo")
+        self.assertEqual(translations[1]["translatedText"].lower(), u"fünfzehn")
+
+        self.assertEqual(translations[2]["detectedSourceLanguage"], "es")
+        self.assertEqual(translations[2]["translatedText"].lower(), u"ich heiße jeff")
+
+        self.assertEqual(translations[3]["detectedSourceLanguage"], "en")
+        self.assertEqual(
+            translations[3]["translatedText"].lower(), "mein name ist jeff"
+        )
diff --git a/translate/tests/unit/__init__.py b/translate/tests/unit/__init__.py
new file mode 100644
index 000000000000..df379f1e9d88
--- /dev/null
+++ b/translate/tests/unit/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/translate/tests/unit/gapic/v3beta1/test_translation_service_client_v3beta1.py b/translate/tests/unit/gapic/v3beta1/test_translation_service_client_v3beta1.py
new file mode 100644
index 000000000000..c4d45f92c69f
--- /dev/null
+++ b/translate/tests/unit/gapic/v3beta1/test_translation_service_client_v3beta1.py
@@ -0,0 +1,437 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import translate_v3beta1
+from google.cloud.translate_v3beta1.proto import translation_service_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestTranslationServiceClient(object):
+    def test_translate_text(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = translation_service_pb2.TranslateTextResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        contents = []
+        target_language_code = "targetLanguageCode1323228230"
+
+        response = client.translate_text(contents, target_language_code)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.TranslateTextRequest(
+            contents=contents, target_language_code=target_language_code
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_translate_text_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup request
+        contents = []
+        target_language_code = "targetLanguageCode1323228230"
+
+        with pytest.raises(CustomException):
+            client.translate_text(contents, target_language_code)
+
+    def test_detect_language(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = translation_service_pb2.DetectLanguageResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        response = client.detect_language()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.DetectLanguageRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_detect_language_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        with pytest.raises(CustomException):
+            client.detect_language()
+
+    def test_get_supported_languages(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = translation_service_pb2.SupportedLanguages(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        response = client.get_supported_languages()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.GetSupportedLanguagesRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_supported_languages_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        with pytest.raises(CustomException):
+            client.get_supported_languages()
+
+    def test_batch_translate_text(self):
+        # Setup Expected Response
+        total_characters = 1368640955
+        translated_characters = 1337326221
+        failed_characters = 1723028396
+        expected_response = {
+            "total_characters": total_characters,
+            "translated_characters": translated_characters,
+            "failed_characters": failed_characters,
+        }
+        expected_response = translation_service_pb2.BatchTranslateResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_translate_text", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        source_language_code = "sourceLanguageCode1687263568"
+        target_language_codes = []
+        input_configs = []
+        output_config = {}
+
+        response = client.batch_translate_text(
+            source_language_code, target_language_codes, input_configs, output_config
+        )
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.BatchTranslateTextRequest(
+            source_language_code=source_language_code,
+            target_language_codes=target_language_codes,
+            input_configs=input_configs,
+            output_config=output_config,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_translate_text_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_batch_translate_text_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        source_language_code = "sourceLanguageCode1687263568"
+        target_language_codes = []
+        input_configs = []
+        output_config = {}
+
+        response = client.batch_translate_text(
+            source_language_code, target_language_codes, input_configs, output_config
+        )
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_create_glossary(self):
+        # Setup Expected Response
+        name = "name3373707"
+        entry_count = 811131134
+        expected_response = {"name": name, "entry_count": entry_count}
+        expected_response = translation_service_pb2.Glossary(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_create_glossary", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        glossary = {}
+
+        response = client.create_glossary(parent, glossary)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.CreateGlossaryRequest(
+            parent=parent, glossary=glossary
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_glossary_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_create_glossary_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        glossary = {}
+
+        response = client.create_glossary(parent, glossary)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_list_glossaries(self):
+        # Setup Expected Response
+        next_page_token = ""
+        glossaries_element = {}
+        glossaries = [glossaries_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "glossaries": glossaries,
+        }
+        expected_response = translation_service_pb2.ListGlossariesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        paged_list_response = client.list_glossaries()
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.glossaries[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.ListGlossariesRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_glossaries_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        paged_list_response = client.list_glossaries()
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_glossary(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        entry_count = 811131134
+        expected_response = {"name": name_2, "entry_count": entry_count}
+        expected_response = translation_service_pb2.Glossary(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        name = client.glossary_path("[PROJECT]", "[LOCATION]", "[GLOSSARY]")
+
+        response = client.get_glossary(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.GetGlossaryRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_glossary_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup request
+        name = client.glossary_path("[PROJECT]", "[LOCATION]", "[GLOSSARY]")
+
+        with pytest.raises(CustomException):
+            client.get_glossary(name)
+
+    def test_delete_glossary(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        expected_response = {"name": name_2}
+        expected_response = translation_service_pb2.DeleteGlossaryResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_glossary", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        name = client.glossary_path("[PROJECT]", "[LOCATION]", "[GLOSSARY]")
+
+        response = client.delete_glossary(name)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = translation_service_pb2.DeleteGlossaryRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_glossary_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_delete_glossary_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = translate_v3beta1.TranslationServiceClient()
+
+        # Setup Request
+        name = client.glossary_path("[PROJECT]", "[LOCATION]", "[GLOSSARY]")
+
+        response = client.delete_glossary(name)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/translate/tests/unit/test__http.py b/translate/tests/unit/test__http.py
new file mode 100644
index 000000000000..208f207c8380
--- /dev/null
+++ b/translate/tests/unit/test__http.py
@@ -0,0 +1,90 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+import mock
+
+
+class TestConnection(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.translate_v2._http import Connection
+
+        return Connection
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_build_api_url_no_extra_query_params(self):
+        conn = self._make_one(object())
+        URI = "/".join(
+            [
+                conn.DEFAULT_API_ENDPOINT,
+                "language",
+                "translate",
+                conn.API_VERSION,
+                "foo",
+            ]
+        )
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_custom_endpoint(self):
+        custom_endpoint = "https://foo-translation.googleapis.com"
+        conn = self._make_one(object(), api_endpoint=custom_endpoint)
+        URI = "/".join(
+            [custom_endpoint, "language", "translate", conn.API_VERSION, "foo"]
+        )
+        self.assertEqual(conn.build_api_url("/foo"), URI)
+
+    def test_build_api_url_w_extra_query_params(self):
+        from six.moves.urllib.parse import parse_qsl
+        from six.moves.urllib.parse import urlsplit
+
+        conn = self._make_one(object())
+        query_params = [("q", "val1"), ("q", "val2")]
+        uri = conn.build_api_url("/foo", query_params=query_params)
+        scheme, netloc, path, qs, _ = urlsplit(uri)
+        self.assertEqual("%s://%s" % (scheme, netloc), conn.API_BASE_URL)
+        expected_path = "/".join(["", "language", "translate", conn.API_VERSION, "foo"])
+        self.assertEqual(path, expected_path)
+        params = parse_qsl(qs)
+        self.assertEqual(params, query_params)
+
+    def test_extra_headers(self):
+        import requests
+        from google.cloud import _http as base_http
+
+        http = mock.create_autospec(requests.Session, instance=True)
+        response = requests.Response()
+        response.status_code = 200
+        data = b"brent-spiner"
+        response._content = data
+        http.request.return_value = response
+        client = mock.Mock(_http=http, spec=["_http"])
+
+        conn = self._make_one(client)
+        req_data = "req-data-boring"
+        result = conn.api_request("GET", "/rainbow", data=req_data, expect_json=False)
+        self.assertEqual(result, data)
+
+        expected_headers = {
+            "Accept-Encoding": "gzip",
+            base_http.CLIENT_INFO_HEADER: conn.user_agent,
+            "User-Agent": conn.user_agent,
+        }
+        expected_uri = conn.build_api_url("/rainbow")
+        http.request.assert_called_once_with(
+            data=req_data, headers=expected_headers, method="GET", url=expected_uri
+        )
diff --git a/translate/tests/unit/test_client.py b/translate/tests/unit/test_client.py
new file mode 100644
index 000000000000..dfbc5affaa73
--- /dev/null
+++ b/translate/tests/unit/test_client.py
@@ -0,0 +1,387 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+
+class TestClient(unittest.TestCase):
+    @staticmethod
+    def _get_target_class():
+        from google.cloud.translate import Client
+
+        return Client
+
+    def _make_one(self, *args, **kw):
+        return self._get_target_class()(*args, **kw)
+
+    def test_constructor_defaults(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.translate_v2._http import Connection
+        from google.cloud.translate_v2.client import ENGLISH_ISO_639
+
+        http = object()
+        client = self._make_one(_http=http)
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIsNone(client._connection.credentials)
+        self.assertIs(client._connection.http, http)
+        self.assertEqual(client.target_language, ENGLISH_ISO_639)
+        self.assertIsInstance(client._connection._client_info, ClientInfo)
+
+    def test_constructor_explicit(self):
+        from google.cloud._http import ClientInfo
+        from google.cloud.translate_v2._http import Connection
+
+        http = object()
+        target = "es"
+        client_info = ClientInfo()
+        client = self._make_one(
+            target_language=target,
+            _http=http,
+            client_info=client_info,
+            client_options={"api_endpoint": "https://foo-translation.googleapis.com"},
+        )
+        self.assertIsInstance(client._connection, Connection)
+        self.assertIsNone(client._connection.credentials)
+        self.assertIs(client._connection.http, http)
+        self.assertEqual(client.target_language, target)
+        self.assertIs(client._connection._client_info, client_info)
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://foo-translation.googleapis.com"
+        )
+
+    def test_constructor_w_empty_client_options(self):
+        from google.cloud._http import ClientInfo
+        from google.api_core.client_options import ClientOptions
+
+        http = object()
+        target = "es"
+        client_info = ClientInfo()
+        client_options = ClientOptions()
+        client = self._make_one(
+            target_language=target,
+            _http=http,
+            client_info=client_info,
+            client_options=client_options,
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, client._connection.DEFAULT_API_ENDPOINT
+        )
+
+    def test_constructor_w_client_options_object(self):
+        from google.cloud._http import ClientInfo
+        from google.api_core.client_options import ClientOptions
+
+        http = object()
+        target = "es"
+        client_info = ClientInfo()
+        client_options = ClientOptions(
+            api_endpoint="https://foo-translation.googleapis.com"
+        )
+        client = self._make_one(
+            target_language=target,
+            _http=http,
+            client_info=client_info,
+            client_options=client_options,
+        )
+        self.assertEqual(
+            client._connection.API_BASE_URL, "https://foo-translation.googleapis.com"
+        )
+
+    def test_get_languages(self):
+        from google.cloud.translate_v2.client import ENGLISH_ISO_639
+
+        client = self._make_one(_http=object())
+        supported = [
+            {"language": "en", "name": "English"},
+            {"language": "af", "name": "Afrikaans"},
+            {"language": "am", "name": "Amharic"},
+        ]
+        data = {"data": {"languages": supported}}
+        conn = client._connection = _Connection(data)
+
+        result = client.get_languages()
+        self.assertEqual(result, supported)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/languages")
+        self.assertEqual(req["query_params"], {"target": ENGLISH_ISO_639})
+
+    def test_get_languages_no_target(self):
+        client = self._make_one(target_language=None, _http=object())
+        supported = [{"language": "en"}, {"language": "af"}, {"language": "am"}]
+        data = {"data": {"languages": supported}}
+        conn = client._connection = _Connection(data)
+
+        result = client.get_languages()
+        self.assertEqual(result, supported)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(len(req), 3)
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/languages")
+        self.assertEqual(req["query_params"], {})
+
+    def test_get_languages_explicit_target(self):
+        client = self._make_one(_http=object())
+        target_language = "en"
+        supported = [
+            {"language": "en", "name": "Spanish"},
+            {"language": "af", "name": "Afrikaans"},
+            {"language": "am", "name": "Amharic"},
+        ]
+        data = {"data": {"languages": supported}}
+        conn = client._connection = _Connection(data)
+
+        result = client.get_languages(target_language)
+        self.assertEqual(result, supported)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "GET")
+        self.assertEqual(req["path"], "/languages")
+        self.assertEqual(req["query_params"], {"target": target_language})
+
+    def test_detect_language_bad_result(self):
+        client = self._make_one(_http=object())
+        value = "takoy"
+        conn = client._connection = _Connection({})
+
+        with self.assertRaises(ValueError):
+            client.detect_language(value)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/detect")
+        expected_data = {"q": [value]}
+        self.assertEqual(req["data"], expected_data)
+
+    def test_detect_language_single_value(self):
+        client = self._make_one(_http=object())
+        value = "takoy"
+        detection = {
+            "confidence": 1.0,
+            "input": value,
+            "language": "ru",
+            "isReliable": False,
+        }
+        data = {"data": {"detections": [[detection]]}}
+        conn = client._connection = _Connection(data)
+
+        result = client.detect_language(value)
+        self.assertEqual(result, detection)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/detect")
+        expected_data = {"q": [value]}
+        self.assertEqual(req["data"], expected_data)
+
+    def test_detect_language_multiple_values(self):
+        client = self._make_one(_http=object())
+        value1 = u"fa\xe7ade"  # facade (with a cedilla)
+        detection1 = {
+            "confidence": 0.6166008,
+            "input": value1,
+            "isReliable": False,
+            "language": "en",
+        }
+        value2 = "s'il vous plait"
+        detection2 = {
+            "confidence": 0.29728225,
+            "input": value2,
+            "isReliable": False,
+            "language": "fr",
+        }
+        data = {"data": {"detections": [[detection1], [detection2]]}}
+        conn = client._connection = _Connection(data)
+
+        result = client.detect_language([value1, value2])
+        self.assertEqual(result, [detection1, detection2])
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "/detect")
+        expected_data = {"q": [value1, value2]}
+        self.assertEqual(req["data"], expected_data)
+
+    def test_detect_language_multiple_results(self):
+        client = self._make_one(_http=object())
+        value = "soy"
+        detection1 = {
+            "confidence": 0.81496066,
+            "input": value,
+            "language": "es",
+            "isReliable": False,
+        }
+        detection2 = {
+            "confidence": 0.222,
+            "input": value,
+            "language": "en",
+            "isReliable": False,
+        }
+        data = {"data": {"detections": [[detection1, detection2]]}}
+        client._connection = _Connection(data)
+
+        with self.assertRaises(ValueError):
+            client.detect_language(value)
+
+    def test_translate_bad_result(self):
+        client = self._make_one(_http=object())
+        value = "hvala ti"
+        conn = client._connection = _Connection({})
+
+        with self.assertRaises(ValueError):
+            client.translate(value)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "")
+        expected_data = {
+            "target": "en",
+            "q": [value],
+            "cid": (),
+            "source": None,
+            "model": None,
+            "format": None,
+        }
+        self.assertEqual(req["data"], expected_data)
+
+    def test_translate_defaults(self):
+        client = self._make_one(_http=object())
+        value = "hvala ti"
+        translation = {
+            "detectedSourceLanguage": "hr",
+            "translatedText": "thank you",
+            "input": value,
+        }
+        data = {"data": {"translations": [translation]}}
+        conn = client._connection = _Connection(data)
+
+        result = client.translate(value)
+        self.assertEqual(result, translation)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "")
+
+        expected_data = {
+            "target": "en",
+            "q": [value],
+            "cid": (),
+            "source": None,
+            "model": None,
+            "format": None,
+        }
+        self.assertEqual(req["data"], expected_data)
+
+    def test_translate_multiple(self):
+        client = self._make_one(_http=object())
+        value1 = "hvala ti"
+        translation1 = {
+            "detectedSourceLanguage": "hr",
+            "translatedText": "thank you",
+            "input": value1,
+        }
+        value2 = "Dankon"
+        translation2 = {
+            "detectedSourceLanguage": "eo",
+            "translatedText": "thank you",
+            "input": value2,
+        }
+        data = {"data": {"translations": [translation1, translation2]}}
+        conn = client._connection = _Connection(data)
+
+        result = client.translate([value1, value2])
+        self.assertEqual(result, [translation1, translation2])
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "")
+
+        expected_data = {
+            "target": "en",
+            "q": [value1, value2],
+            "cid": (),
+            "source": None,
+            "model": None,
+            "format": None,
+        }
+        self.assertEqual(req["data"], expected_data)
+
+    def test_translate_explicit(self):
+        client = self._make_one(_http=object())
+        value = "thank you"
+        target_language = "eo"
+        source_language = "en"
+        translation = {"translatedText": "Dankon", "input": value}
+        data = {"data": {"translations": [translation]}}
+        conn = client._connection = _Connection(data)
+
+        cid = "123"
+        format_ = "text"
+        model = "nmt"
+        result = client.translate(
+            value,
+            target_language=target_language,
+            source_language=source_language,
+            format_=format_,
+            customization_ids=cid,
+            model=model,
+        )
+        self.assertEqual(result, translation)
+
+        # Verify requested.
+        self.assertEqual(len(conn._requested), 1)
+        req = conn._requested[0]
+        self.assertEqual(req["method"], "POST")
+        self.assertEqual(req["path"], "")
+
+        expected_data = {
+            "target": target_language,
+            "q": [value],
+            "cid": [cid],
+            "source": source_language,
+            "model": model,
+            "format": format_,
+        }
+        self.assertEqual(req["data"], expected_data)
+
+
+class _Connection(object):
+    def __init__(self, *responses):
+        self._responses = responses
+        self._requested = []
+
+    def api_request(self, **kw):
+        self._requested.append(kw)
+        response, self._responses = self._responses[0], self._responses[1:]
+        return response
diff --git a/unit_tests/__init__.py b/unit_tests/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/_testing.py b/unit_tests/_testing.py
deleted file mode 100644
index bc1f952a0ad9..000000000000
--- a/unit_tests/_testing.py
+++ /dev/null
@@ -1,89 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-"""Shared testing utilities."""
-
-
-class _Monkey(object):
-    # context-manager for replacing module names in the scope of a test.
-
-    def __init__(self, module, **kw):
-        self.module = module
-        if len(kw) == 0:  # pragma: NO COVER
-            raise ValueError('_Monkey was used with nothing to monkey-patch')
-        self.to_restore = {key: getattr(module, key) for key in kw}
-        for key, value in kw.items():
-            setattr(module, key, value)
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        for key, value in self.to_restore.items():
-            setattr(self.module, key, value)
-
-
-class _NamedTemporaryFile(object):
-
-    def __init__(self, suffix=''):
-        import os
-        import tempfile
-        filehandle, self.name = tempfile.mkstemp(suffix=suffix)
-        os.close(filehandle)
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        import os
-        os.remove(self.name)
-
-
-class _GAXBaseAPI(object):
-
-    _random_gax_error = False
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-    def _make_grpc_error(self, status_code=None):
-        from grpc._channel import _RPCState
-        from grpc import StatusCode
-        from google.cloud.exceptions import GrpcRendezvous
-
-        if status_code is None:
-            status_code = StatusCode.UNKNOWN
-
-        details = 'Some error details.'
-        exc_state = _RPCState((), None, None, status_code, details)
-        return GrpcRendezvous(exc_state, None, None, None)
-
-    def _make_grpc_not_found(self):
-        from grpc import StatusCode
-        return self._make_grpc_error(StatusCode.NOT_FOUND)
-
-    def _make_grpc_failed_precondition(self):
-        from grpc import StatusCode
-        return self._make_grpc_error(StatusCode.FAILED_PRECONDITION)
-
-
-class _GAXPageIterator(object):
-
-    def __init__(self, items, page_token):
-        self._items = items
-        self.page_token = page_token
-
-    def next(self):
-        items, self._items = self._items, None
-        return items
diff --git a/unit_tests/bigquery/__init__.py b/unit_tests/bigquery/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/bigquery/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/bigquery/test__helpers.py b/unit_tests/bigquery/test__helpers.py
deleted file mode 100644
index d86504feb372..000000000000
--- a/unit_tests/bigquery/test__helpers.py
+++ /dev/null
@@ -1,496 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class Test_not_null(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _not_null
-        return _not_null(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertFalse(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        self.assertTrue(self._callFUT(None, _Field('REQUIRED')))
-
-    def test_w_value(self):
-        self.assertTrue(self._callFUT(object(), object()))
-
-
-class Test_int_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _int_from_json
-        return _int_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        with self.assertRaises(TypeError):
-            self._callFUT(None, _Field('REQUIRED'))
-
-    def test_w_string_value(self):
-        coerced = self._callFUT('42', object())
-        self.assertEqual(coerced, 42)
-
-    def test_w_float_value(self):
-        coerced = self._callFUT(42, object())
-        self.assertEqual(coerced, 42)
-
-
-class Test_float_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _float_from_json
-        return _float_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        with self.assertRaises(TypeError):
-            self._callFUT(None, _Field('REQUIRED'))
-
-    def test_w_string_value(self):
-        coerced = self._callFUT('3.1415', object())
-        self.assertEqual(coerced, 3.1415)
-
-    def test_w_float_value(self):
-        coerced = self._callFUT(3.1415, object())
-        self.assertEqual(coerced, 3.1415)
-
-
-class Test_bool_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _bool_from_json
-        return _bool_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        with self.assertRaises(AttributeError):
-            self._callFUT(None, _Field('REQUIRED'))
-
-    def test_w_value_t(self):
-        coerced = self._callFUT('T', object())
-        self.assertTrue(coerced)
-
-    def test_w_value_true(self):
-        coerced = self._callFUT('True', object())
-        self.assertTrue(coerced)
-
-    def test_w_value_1(self):
-        coerced = self._callFUT('1', object())
-        self.assertTrue(coerced)
-
-    def test_w_value_other(self):
-        coerced = self._callFUT('f', object())
-        self.assertFalse(coerced)
-
-
-class Test_datetime_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _datetime_from_json
-        return _datetime_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        with self.assertRaises(TypeError):
-            self._callFUT(None, _Field('REQUIRED'))
-
-    def test_w_string_value(self):
-        import datetime
-        from google.cloud._helpers import _EPOCH
-        coerced = self._callFUT('1.234567', object())
-        self.assertEqual(
-            coerced,
-            _EPOCH + datetime.timedelta(seconds=1, microseconds=234567))
-
-    def test_w_float_value(self):
-        import datetime
-        from google.cloud._helpers import _EPOCH
-        coerced = self._callFUT(1.234567, object())
-        self.assertEqual(
-            coerced,
-            _EPOCH + datetime.timedelta(seconds=1, microseconds=234567))
-
-
-class Test_date_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _date_from_json
-        return _date_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        with self.assertRaises(TypeError):
-            self._callFUT(None, _Field('REQUIRED'))
-
-    def test_w_string_value(self):
-        import datetime
-        coerced = self._callFUT('1987-09-22', object())
-        self.assertEqual(
-            coerced,
-            datetime.date(1987, 9, 22))
-
-
-class Test_record_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _record_from_json
-        return _record_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        with self.assertRaises(TypeError):
-            self._callFUT(None, _Field('REQUIRED'))
-
-    def test_w_nullable_subfield_none(self):
-        subfield = _Field('NULLABLE', 'age', 'INTEGER')
-        field = _Field('REQUIRED', fields=[subfield])
-        value = {'f': [{'v': None}]}
-        coerced = self._callFUT(value, field)
-        self.assertEqual(coerced, {'age': None})
-
-    def test_w_scalar_subfield(self):
-        subfield = _Field('REQUIRED', 'age', 'INTEGER')
-        field = _Field('REQUIRED', fields=[subfield])
-        value = {'f': [{'v': 42}]}
-        coerced = self._callFUT(value, field)
-        self.assertEqual(coerced, {'age': 42})
-
-    def test_w_repeated_subfield(self):
-        subfield = _Field('REPEATED', 'color', 'STRING')
-        field = _Field('REQUIRED', fields=[subfield])
-        value = {'f': [{'v': ['red', 'yellow', 'blue']}]}
-        coerced = self._callFUT(value, field)
-        self.assertEqual(coerced, {'color': ['red', 'yellow', 'blue']})
-
-    def test_w_record_subfield(self):
-        full_name = _Field('REQUIRED', 'full_name', 'STRING')
-        area_code = _Field('REQUIRED', 'area_code', 'STRING')
-        local_number = _Field('REQUIRED', 'local_number', 'STRING')
-        rank = _Field('REQUIRED', 'rank', 'INTEGER')
-        phone = _Field('NULLABLE', 'phone', 'RECORD',
-                       fields=[area_code, local_number, rank])
-        person = _Field('REQUIRED', 'person', 'RECORD',
-                        fields=[full_name, phone])
-        value = {
-            'f': [
-                {'v': 'Phred Phlyntstone'},
-                {'v': {'f': [{'v': '800'}, {'v': '555-1212'}, {'v': 1}]}},
-            ],
-        }
-        expected = {
-            'full_name': 'Phred Phlyntstone',
-            'phone': {
-                'area_code': '800',
-                'local_number': '555-1212',
-                'rank': 1,
-            }
-        }
-        coerced = self._callFUT(value, person)
-        self.assertEqual(coerced, expected)
-
-
-class Test_string_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _string_from_json
-        return _string_from_json(value, field)
-
-    def test_w_none_nullable(self):
-        self.assertIsNone(self._callFUT(None, _Field('NULLABLE')))
-
-    def test_w_none_required(self):
-        self.assertIsNone(self._callFUT(None, _Field('RECORD')))
-
-    def test_w_string_value(self):
-        coerced = self._callFUT('Wonderful!', object())
-        self.assertEqual(coerced, 'Wonderful!')
-
-
-class Test_rows_from_json(unittest.TestCase):
-
-    def _callFUT(self, value, field):
-        from google.cloud.bigquery._helpers import _rows_from_json
-        return _rows_from_json(value, field)
-
-    def test_w_record_subfield(self):
-        full_name = _Field('REQUIRED', 'full_name', 'STRING')
-        area_code = _Field('REQUIRED', 'area_code', 'STRING')
-        local_number = _Field('REQUIRED', 'local_number', 'STRING')
-        rank = _Field('REQUIRED', 'rank', 'INTEGER')
-        phone = _Field('NULLABLE', 'phone', 'RECORD',
-                       fields=[area_code, local_number, rank])
-        color = _Field('REPEATED', 'color', 'STRING')
-        schema = [full_name, phone, color]
-        rows = [
-            {'f': [
-                {'v': 'Phred Phlyntstone'},
-                {'v': {'f': [{'v': '800'}, {'v': '555-1212'}, {'v': 1}]}},
-                {'v': ['orange', 'black']},
-            ]},
-            {'f': [
-                {'v': 'Bharney Rhubble'},
-                {'v': {'f': [{'v': '877'}, {'v': '768-5309'}, {'v': 2}]}},
-                {'v': ['brown']},
-            ]},
-            {'f': [
-                {'v': 'Wylma Phlyntstone'},
-                {'v': None},
-                {'v': []},
-            ]},
-        ]
-        phred_phone = {
-            'area_code': '800',
-            'local_number': '555-1212',
-            'rank': 1,
-        }
-        bharney_phone = {
-            'area_code': '877',
-            'local_number': '768-5309',
-            'rank': 2,
-        }
-        expected = [
-            ('Phred Phlyntstone', phred_phone, ['orange', 'black']),
-            ('Bharney Rhubble', bharney_phone, ['brown']),
-            ('Wylma Phlyntstone', None, []),
-        ]
-        coerced = self._callFUT(rows, schema)
-        self.assertEqual(coerced, expected)
-
-    def test_w_int64_float64(self):
-        # "Standard" SQL dialect uses 'INT64', 'FLOAT64'.
-        candidate = _Field('REQUIRED', 'candidate', 'STRING')
-        votes = _Field('REQUIRED', 'votes', 'INT64')
-        percentage = _Field('REQUIRED', 'percentage', 'FLOAT64')
-        schema = [candidate, votes, percentage]
-        rows = [
-            {'f': [
-                {'v': 'Phred Phlyntstone'},
-                {'v': 8},
-                {'v': 0.25},
-            ]},
-            {'f': [
-                {'v': 'Bharney Rhubble'},
-                {'v': 4},
-                {'v': 0.125},
-            ]},
-            {'f': [
-                {'v': 'Wylma Phlyntstone'},
-                {'v': 20},
-                {'v': 0.625},
-            ]},
-        ]
-        expected = [
-            ('Phred Phlyntstone', 8, 0.25),
-            ('Bharney Rhubble', 4, 0.125),
-            ('Wylma Phlyntstone', 20, 0.625),
-        ]
-        coerced = self._callFUT(rows, schema)
-        self.assertEqual(coerced, expected)
-
-
-class Test_ConfigurationProperty(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery._helpers import _ConfigurationProperty
-        return _ConfigurationProperty
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_it(self):
-
-        class Configuration(object):
-            _attr = None
-
-        class Wrapper(object):
-            attr = self._makeOne('attr')
-
-            def __init__(self):
-                self._configuration = Configuration()
-
-        self.assertEqual(Wrapper.attr.name, 'attr')
-
-        wrapper = Wrapper()
-        self.assertIsNone(wrapper.attr)
-
-        value = object()
-        wrapper.attr = value
-        self.assertIs(wrapper.attr, value)
-        self.assertIs(wrapper._configuration._attr, value)
-
-        del wrapper.attr
-        self.assertIsNone(wrapper.attr)
-        self.assertIsNone(wrapper._configuration._attr)
-
-
-class Test_TypedProperty(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery._helpers import _TypedProperty
-        return _TypedProperty
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_it(self):
-
-        class Configuration(object):
-            _attr = None
-
-        class Wrapper(object):
-            attr = self._makeOne('attr', int)
-
-            def __init__(self):
-                self._configuration = Configuration()
-
-        wrapper = Wrapper()
-        with self.assertRaises(ValueError):
-            wrapper.attr = 'BOGUS'
-
-        wrapper.attr = 42
-        self.assertEqual(wrapper.attr, 42)
-        self.assertEqual(wrapper._configuration._attr, 42)
-
-        del wrapper.attr
-        self.assertIsNone(wrapper.attr)
-        self.assertIsNone(wrapper._configuration._attr)
-
-
-class Test_EnumProperty(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery._helpers import _EnumProperty
-        return _EnumProperty
-
-    def test_it(self):
-
-        class Sub(self._getTargetClass()):
-            ALLOWED = ('FOO', 'BAR', 'BAZ')
-
-        class Configuration(object):
-            _attr = None
-
-        class Wrapper(object):
-            attr = Sub('attr')
-
-            def __init__(self):
-                self._configuration = Configuration()
-
-        wrapper = Wrapper()
-        with self.assertRaises(ValueError):
-            wrapper.attr = 'BOGUS'
-
-        wrapper.attr = 'FOO'
-        self.assertEqual(wrapper.attr, 'FOO')
-        self.assertEqual(wrapper._configuration._attr, 'FOO')
-
-        del wrapper.attr
-        self.assertIsNone(wrapper.attr)
-        self.assertIsNone(wrapper._configuration._attr)
-
-
-class Test_UDFResourcesProperty(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery._helpers import UDFResourcesProperty
-        return UDFResourcesProperty
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _descriptor_and_klass(self):
-        descriptor = self._makeOne()
-
-        class _Test(object):
-            _udf_resources = ()
-            udf_resources = descriptor
-
-        return descriptor, _Test
-
-    def test_class_getter(self):
-        descriptor, klass = self._descriptor_and_klass()
-        self.assertIs(klass.udf_resources, descriptor)
-
-    def test_instance_getter_empty(self):
-        _, klass = self._descriptor_and_klass()
-        instance = klass()
-        self.assertEqual(instance.udf_resources, [])
-
-    def test_instance_getter_w_non_empty_list(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        udf_resources = [UDFResource("resourceUri", RESOURCE_URI)]
-        _, klass = self._descriptor_and_klass()
-        instance = klass()
-        instance._udf_resources = tuple(udf_resources)
-
-        self.assertEqual(instance.udf_resources, udf_resources)
-
-    def test_instance_setter_w_empty_list(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        udf_resources = [UDFResource("resourceUri", RESOURCE_URI)]
-        _, klass = self._descriptor_and_klass()
-        instance = klass()
-        instance._udf_resources = udf_resources
-
-        instance.udf_resources = []
-
-        self.assertEqual(instance.udf_resources, [])
-
-    def test_instance_setter_w_valid_udf(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        udf_resources = [UDFResource("resourceUri", RESOURCE_URI)]
-        _, klass = self._descriptor_and_klass()
-        instance = klass()
-
-        instance.udf_resources = udf_resources
-
-        self.assertEqual(instance.udf_resources, udf_resources)
-
-    def test_instance_setter_w_bad_udfs(self):
-        _, klass = self._descriptor_and_klass()
-        instance = klass()
-
-        with self.assertRaises(ValueError):
-            instance.udf_resources = ["foo"]
-
-        self.assertEqual(instance.udf_resources, [])
-
-
-class _Field(object):
-
-    def __init__(self, mode, name='unknown', field_type='UNKNOWN', fields=()):
-        self.mode = mode
-        self.name = name
-        self.field_type = field_type
-        self.fields = fields
diff --git a/unit_tests/bigquery/test_client.py b/unit_tests/bigquery/test_client.py
deleted file mode 100644
index e599217b92e2..000000000000
--- a/unit_tests/bigquery/test_client.py
+++ /dev/null
@@ -1,492 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        from google.cloud.bigquery.connection import Connection
-        PROJECT = 'PROJECT'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertIs(client.connection.credentials, creds)
-        self.assertIs(client.connection.http, http)
-
-    def test_list_projects_defaults(self):
-        from google.cloud.bigquery.client import Project
-        PROJECT_1 = 'PROJECT_ONE'
-        PROJECT_2 = 'PROJECT_TWO'
-        PATH = 'projects'
-        TOKEN = 'TOKEN'
-        DATA = {
-            'nextPageToken': TOKEN,
-            'projects': [
-                {'kind': 'bigquery#project',
-                 'id': PROJECT_1,
-                 'numericId': 1,
-                 'projectReference': {'projectId': PROJECT_1},
-                 'friendlyName': 'One'},
-                {'kind': 'bigquery#project',
-                 'id': PROJECT_2,
-                 'numericId': 2,
-                 'projectReference': {'projectId': PROJECT_2},
-                 'friendlyName': 'Two'},
-            ]
-        }
-        creds = _Credentials()
-        client = self._makeOne(PROJECT_1, creds)
-        conn = client.connection = _Connection(DATA)
-
-        projects, token = client.list_projects()
-
-        self.assertEqual(len(projects), len(DATA['projects']))
-        for found, expected in zip(projects, DATA['projects']):
-            self.assertIsInstance(found, Project)
-            self.assertEqual(found.project_id, expected['id'])
-            self.assertEqual(found.numeric_id, expected['numericId'])
-            self.assertEqual(found.friendly_name, expected['friendlyName'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_projects_explicit_response_missing_projects_key(self):
-        PROJECT = 'PROJECT'
-        PATH = 'projects'
-        TOKEN = 'TOKEN'
-        DATA = {}
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        projects, token = client.list_projects(max_results=3, page_token=TOKEN)
-
-        self.assertEqual(len(projects), 0)
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': 3, 'pageToken': TOKEN})
-
-    def test_list_datasets_defaults(self):
-        from google.cloud.bigquery.dataset import Dataset
-        PROJECT = 'PROJECT'
-        DATASET_1 = 'dataset_one'
-        DATASET_2 = 'dataset_two'
-        PATH = 'projects/%s/datasets' % PROJECT
-        TOKEN = 'TOKEN'
-        DATA = {
-            'nextPageToken': TOKEN,
-            'datasets': [
-                {'kind': 'bigquery#dataset',
-                 'id': '%s:%s' % (PROJECT, DATASET_1),
-                 'datasetReference': {'datasetId': DATASET_1,
-                                      'projectId': PROJECT},
-                 'friendlyName': None},
-                {'kind': 'bigquery#dataset',
-                 'id': '%s:%s' % (PROJECT, DATASET_2),
-                 'datasetReference': {'datasetId': DATASET_2,
-                                      'projectId': PROJECT},
-                 'friendlyName': 'Two'},
-            ]
-        }
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        datasets, token = client.list_datasets()
-
-        self.assertEqual(len(datasets), len(DATA['datasets']))
-        for found, expected in zip(datasets, DATA['datasets']):
-            self.assertIsInstance(found, Dataset)
-            self.assertEqual(found.dataset_id, expected['id'])
-            self.assertEqual(found.friendly_name, expected['friendlyName'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_datasets_explicit_response_missing_datasets_key(self):
-        PROJECT = 'PROJECT'
-        PATH = 'projects/%s/datasets' % PROJECT
-        TOKEN = 'TOKEN'
-        DATA = {}
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        datasets, token = client.list_datasets(
-            include_all=True, max_results=3, page_token=TOKEN)
-
-        self.assertEqual(len(datasets), 0)
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'all': True, 'maxResults': 3, 'pageToken': TOKEN})
-
-    def test_dataset(self):
-        from google.cloud.bigquery.dataset import Dataset
-        PROJECT = 'PROJECT'
-        DATASET = 'dataset_name'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        dataset = client.dataset(DATASET)
-        self.assertIsInstance(dataset, Dataset)
-        self.assertEqual(dataset.name, DATASET)
-        self.assertIs(dataset._client, client)
-
-    def test_job_from_resource_unknown_type(self):
-        PROJECT = 'PROJECT'
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        with self.assertRaises(ValueError):
-            client.job_from_resource({'configuration': {'nonesuch': {}}})
-
-    def test_list_jobs_defaults(self):
-        from google.cloud.bigquery.job import LoadTableFromStorageJob
-        from google.cloud.bigquery.job import CopyJob
-        from google.cloud.bigquery.job import ExtractTableToStorageJob
-        from google.cloud.bigquery.job import QueryJob
-        PROJECT = 'PROJECT'
-        DATASET = 'test_dataset'
-        SOURCE_TABLE = 'source_table'
-        DESTINATION_TABLE = 'destination_table'
-        QUERY_DESTINATION_TABLE = 'query_destination_table'
-        SOURCE_URI = 'gs://test_bucket/src_object*'
-        DESTINATION_URI = 'gs://test_bucket/dst_object*'
-        JOB_TYPES = {
-            'load_job': LoadTableFromStorageJob,
-            'copy_job': CopyJob,
-            'extract_job': ExtractTableToStorageJob,
-            'query_job': QueryJob,
-        }
-        PATH = 'projects/%s/jobs' % PROJECT
-        TOKEN = 'TOKEN'
-        QUERY = 'SELECT * from test_dataset:test_table'
-        ASYNC_QUERY_DATA = {
-            'id': '%s:%s' % (PROJECT, 'query_job'),
-            'jobReference': {
-                'projectId': PROJECT,
-                'jobId': 'query_job',
-            },
-            'state': 'DONE',
-            'configuration': {
-                'query': {
-                    'query': QUERY,
-                    'destinationTable': {
-                        'projectId': PROJECT,
-                        'datasetId': DATASET,
-                        'tableId': QUERY_DESTINATION_TABLE,
-                    },
-                    'createDisposition': 'CREATE_IF_NEEDED',
-                    'writeDisposition': 'WRITE_TRUNCATE',
-                }
-            },
-        }
-        EXTRACT_DATA = {
-            'id': '%s:%s' % (PROJECT, 'extract_job'),
-            'jobReference': {
-                'projectId': PROJECT,
-                'jobId': 'extract_job',
-            },
-            'state': 'DONE',
-            'configuration': {
-                'extract': {
-                    'sourceTable': {
-                        'projectId': PROJECT,
-                        'datasetId': DATASET,
-                        'tableId': SOURCE_TABLE,
-                    },
-                    'destinationUris': [DESTINATION_URI],
-                }
-            },
-        }
-        COPY_DATA = {
-            'id': '%s:%s' % (PROJECT, 'copy_job'),
-            'jobReference': {
-                'projectId': PROJECT,
-                'jobId': 'copy_job',
-            },
-            'state': 'DONE',
-            'configuration': {
-                'copy': {
-                    'sourceTables': [{
-                        'projectId': PROJECT,
-                        'datasetId': DATASET,
-                        'tableId': SOURCE_TABLE,
-                    }],
-                    'destinationTable': {
-                        'projectId': PROJECT,
-                        'datasetId': DATASET,
-                        'tableId': DESTINATION_TABLE,
-                    },
-                }
-            },
-        }
-        LOAD_DATA = {
-            'id': '%s:%s' % (PROJECT, 'load_job'),
-            'jobReference': {
-                'projectId': PROJECT,
-                'jobId': 'load_job',
-            },
-            'state': 'DONE',
-            'configuration': {
-                'load': {
-                    'destinationTable': {
-                        'projectId': PROJECT,
-                        'datasetId': DATASET,
-                        'tableId': SOURCE_TABLE,
-                    },
-                    'sourceUris': [SOURCE_URI],
-                }
-            },
-        }
-        DATA = {
-            'nextPageToken': TOKEN,
-            'jobs': [
-                ASYNC_QUERY_DATA,
-                EXTRACT_DATA,
-                COPY_DATA,
-                LOAD_DATA,
-            ]
-        }
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        jobs, token = client.list_jobs()
-
-        self.assertEqual(len(jobs), len(DATA['jobs']))
-        for found, expected in zip(jobs, DATA['jobs']):
-            name = expected['jobReference']['jobId']
-            self.assertIsInstance(found, JOB_TYPES[name])
-            self.assertEqual(found.name, name)
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'projection': 'full'})
-
-    def test_list_jobs_load_job_wo_sourceUris(self):
-        from google.cloud.bigquery.job import LoadTableFromStorageJob
-        PROJECT = 'PROJECT'
-        DATASET = 'test_dataset'
-        SOURCE_TABLE = 'source_table'
-        JOB_TYPES = {
-            'load_job': LoadTableFromStorageJob,
-        }
-        PATH = 'projects/%s/jobs' % PROJECT
-        TOKEN = 'TOKEN'
-        LOAD_DATA = {
-            'id': '%s:%s' % (PROJECT, 'load_job'),
-            'jobReference': {
-                'projectId': PROJECT,
-                'jobId': 'load_job',
-            },
-            'state': 'DONE',
-            'configuration': {
-                'load': {
-                    'destinationTable': {
-                        'projectId': PROJECT,
-                        'datasetId': DATASET,
-                        'tableId': SOURCE_TABLE,
-                    },
-                }
-            },
-        }
-        DATA = {
-            'nextPageToken': TOKEN,
-            'jobs': [
-                LOAD_DATA,
-            ]
-        }
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        jobs, token = client.list_jobs()
-
-        self.assertEqual(len(jobs), len(DATA['jobs']))
-        for found, expected in zip(jobs, DATA['jobs']):
-            name = expected['jobReference']['jobId']
-            self.assertIsInstance(found, JOB_TYPES[name])
-            self.assertEqual(found.name, name)
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'projection': 'full'})
-
-    def test_list_jobs_explicit_missing(self):
-        PROJECT = 'PROJECT'
-        PATH = 'projects/%s/jobs' % PROJECT
-        DATA = {}
-        TOKEN = 'TOKEN'
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        jobs, token = client.list_jobs(max_results=1000, page_token=TOKEN,
-                                       all_users=True, state_filter='done')
-
-        self.assertEqual(len(jobs), 0)
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'projection': 'full',
-                          'maxResults': 1000,
-                          'pageToken': TOKEN,
-                          'allUsers': True,
-                          'stateFilter': 'done'})
-
-    def test_load_table_from_storage(self):
-        from google.cloud.bigquery.job import LoadTableFromStorageJob
-        PROJECT = 'PROJECT'
-        JOB = 'job_name'
-        DATASET = 'dataset_name'
-        DESTINATION = 'destination_table'
-        SOURCE_URI = 'http://example.com/source.csv'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        dataset = client.dataset(DATASET)
-        destination = dataset.table(DESTINATION)
-        job = client.load_table_from_storage(JOB, destination, SOURCE_URI)
-        self.assertIsInstance(job, LoadTableFromStorageJob)
-        self.assertIs(job._client, client)
-        self.assertEqual(job.name, JOB)
-        self.assertEqual(list(job.source_uris), [SOURCE_URI])
-        self.assertIs(job.destination, destination)
-
-    def test_copy_table(self):
-        from google.cloud.bigquery.job import CopyJob
-        PROJECT = 'PROJECT'
-        JOB = 'job_name'
-        DATASET = 'dataset_name'
-        SOURCE = 'source_table'
-        DESTINATION = 'destination_table'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        dataset = client.dataset(DATASET)
-        source = dataset.table(SOURCE)
-        destination = dataset.table(DESTINATION)
-        job = client.copy_table(JOB, destination, source)
-        self.assertIsInstance(job, CopyJob)
-        self.assertIs(job._client, client)
-        self.assertEqual(job.name, JOB)
-        self.assertEqual(list(job.sources), [source])
-        self.assertIs(job.destination, destination)
-
-    def test_extract_table_to_storage(self):
-        from google.cloud.bigquery.job import ExtractTableToStorageJob
-        PROJECT = 'PROJECT'
-        JOB = 'job_name'
-        DATASET = 'dataset_name'
-        SOURCE = 'source_table'
-        DESTINATION = 'gs://bucket_name/object_name'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        dataset = client.dataset(DATASET)
-        source = dataset.table(SOURCE)
-        job = client.extract_table_to_storage(JOB, source, DESTINATION)
-        self.assertIsInstance(job, ExtractTableToStorageJob)
-        self.assertIs(job._client, client)
-        self.assertEqual(job.name, JOB)
-        self.assertEqual(job.source, source)
-        self.assertEqual(list(job.destination_uris), [DESTINATION])
-
-    def test_run_async_query(self):
-        from google.cloud.bigquery.job import QueryJob
-        PROJECT = 'PROJECT'
-        JOB = 'job_name'
-        QUERY = 'select count(*) from persons'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        job = client.run_async_query(JOB, QUERY)
-        self.assertIsInstance(job, QueryJob)
-        self.assertIs(job._client, client)
-        self.assertEqual(job.name, JOB)
-        self.assertEqual(job.query, QUERY)
-
-    def test_run_sync_query(self):
-        from google.cloud.bigquery.query import QueryResults
-        PROJECT = 'PROJECT'
-        QUERY = 'select count(*) from persons'
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=PROJECT, credentials=creds, http=http)
-        job = client.run_sync_query(QUERY)
-        self.assertIsInstance(job, QueryResults)
-        self.assertIs(job._client, client)
-        self.assertIsNone(job.name)
-        self.assertEqual(job.query, QUERY)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/bigquery/test_connection.py b/unit_tests/bigquery/test_connection.py
deleted file mode 100644
index 4fd8cfc0ddaf..000000000000
--- a/unit_tests/bigquery/test_connection.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'bigquery',
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeOne()
-        uri = conn.build_api_url('/foo', {'bar': 'baz'})
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        self.assertEqual(path,
-                         '/'.join(['', 'bigquery', conn.API_VERSION, 'foo']))
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['bar'], 'baz')
diff --git a/unit_tests/bigquery/test_dataset.py b/unit_tests/bigquery/test_dataset.py
deleted file mode 100644
index 6d6c00df610c..000000000000
--- a/unit_tests/bigquery/test_dataset.py
+++ /dev/null
@@ -1,786 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestAccessGrant(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.dataset import AccessGrant
-        return AccessGrant
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        grant = self._makeOne('OWNER', 'userByEmail', 'phred@example.com')
-        self.assertEqual(grant.role, 'OWNER')
-        self.assertEqual(grant.entity_type, 'userByEmail')
-        self.assertEqual(grant.entity_id, 'phred@example.com')
-
-    def test_ctor_bad_entity_type(self):
-        with self.assertRaises(ValueError):
-            self._makeOne(None, 'unknown', None)
-
-    def test_ctor_view_with_role(self):
-        role = 'READER'
-        entity_type = 'view'
-        with self.assertRaises(ValueError):
-            self._makeOne(role, entity_type, None)
-
-    def test_ctor_view_success(self):
-        role = None
-        entity_type = 'view'
-        entity_id = object()
-        grant = self._makeOne(role, entity_type, entity_id)
-        self.assertEqual(grant.role, role)
-        self.assertEqual(grant.entity_type, entity_type)
-        self.assertEqual(grant.entity_id, entity_id)
-
-    def test_ctor_nonview_without_role(self):
-        role = None
-        entity_type = 'userByEmail'
-        with self.assertRaises(ValueError):
-            self._makeOne(role, entity_type, None)
-
-    def test___eq___role_mismatch(self):
-        grant = self._makeOne('OWNER', 'userByEmail', 'phred@example.com')
-        other = self._makeOne('WRITER', 'userByEmail', 'phred@example.com')
-        self.assertNotEqual(grant, other)
-
-    def test___eq___entity_type_mismatch(self):
-        grant = self._makeOne('OWNER', 'userByEmail', 'phred@example.com')
-        other = self._makeOne('OWNER', 'groupByEmail', 'phred@example.com')
-        self.assertNotEqual(grant, other)
-
-    def test___eq___entity_id_mismatch(self):
-        grant = self._makeOne('OWNER', 'userByEmail', 'phred@example.com')
-        other = self._makeOne('OWNER', 'userByEmail', 'bharney@example.com')
-        self.assertNotEqual(grant, other)
-
-    def test___eq___hit(self):
-        grant = self._makeOne('OWNER', 'userByEmail', 'phred@example.com')
-        other = self._makeOne('OWNER', 'userByEmail', 'phred@example.com')
-        self.assertEqual(grant, other)
-
-
-class TestDataset(unittest.TestCase):
-    PROJECT = 'project'
-    DS_NAME = 'dataset-name'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.dataset import Dataset
-        return Dataset
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _setUpConstants(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        self.WHEN_TS = 1437767599.006
-        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(
-            tzinfo=UTC)
-        self.ETAG = 'ETAG'
-        self.DS_ID = '%s:%s' % (self.PROJECT, self.DS_NAME)
-        self.RESOURCE_URL = 'http://example.com/path/to/resource'
-
-    def _makeResource(self):
-        self._setUpConstants()
-        USER_EMAIL = 'phred@example.com'
-        GROUP_EMAIL = 'group-name@lists.example.com'
-        return {
-            'creationTime': self.WHEN_TS * 1000,
-            'datasetReference':
-                {'projectId': self.PROJECT, 'datasetId': self.DS_NAME},
-            'etag': self.ETAG,
-            'id': self.DS_ID,
-            'lastModifiedTime': self.WHEN_TS * 1000,
-            'location': 'US',
-            'selfLink': self.RESOURCE_URL,
-            'access': [
-                {'role': 'OWNER', 'userByEmail': USER_EMAIL},
-                {'role': 'OWNER', 'groupByEmail': GROUP_EMAIL},
-                {'role': 'WRITER', 'specialGroup': 'projectWriters'},
-                {'role': 'READER', 'specialGroup': 'projectReaders'}],
-        }
-
-    def _verifyAccessGrants(self, access_grants, resource):
-        r_grants = []
-        for r_grant in resource['access']:
-            role = r_grant.pop('role')
-            for entity_type, entity_id in sorted(r_grant.items()):
-                r_grants.append({'role': role,
-                                 'entity_type': entity_type,
-                                 'entity_id': entity_id})
-
-        self.assertEqual(len(access_grants), len(r_grants))
-        for a_grant, r_grant in zip(access_grants, r_grants):
-            self.assertEqual(a_grant.role, r_grant['role'])
-            self.assertEqual(a_grant.entity_type, r_grant['entity_type'])
-            self.assertEqual(a_grant.entity_id, r_grant['entity_id'])
-
-    def _verifyReadonlyResourceProperties(self, dataset, resource):
-
-        self.assertEqual(dataset.dataset_id, self.DS_ID)
-
-        if 'creationTime' in resource:
-            self.assertEqual(dataset.created, self.WHEN)
-        else:
-            self.assertIsNone(dataset.created)
-        if 'etag' in resource:
-            self.assertEqual(dataset.etag, self.ETAG)
-        else:
-            self.assertIsNone(dataset.etag)
-        if 'lastModifiedTime' in resource:
-            self.assertEqual(dataset.modified, self.WHEN)
-        else:
-            self.assertIsNone(dataset.modified)
-        if 'selfLink' in resource:
-            self.assertEqual(dataset.self_link, self.RESOURCE_URL)
-        else:
-            self.assertIsNone(dataset.self_link)
-
-    def _verifyResourceProperties(self, dataset, resource):
-
-        self._verifyReadonlyResourceProperties(dataset, resource)
-
-        if 'defaultTableExpirationMs' in resource:
-            self.assertEqual(dataset.default_table_expiration_ms,
-                             int(resource.get('defaultTableExpirationMs')))
-        else:
-            self.assertIsNone(dataset.default_table_expiration_ms)
-        self.assertEqual(dataset.description, resource.get('description'))
-        self.assertEqual(dataset.friendly_name, resource.get('friendlyName'))
-        self.assertEqual(dataset.location, resource.get('location'))
-
-        if 'access' in resource:
-            self._verifyAccessGrants(dataset.access_grants, resource)
-        else:
-            self.assertEqual(dataset.access_grants, [])
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        self.assertEqual(dataset.name, self.DS_NAME)
-        self.assertIs(dataset._client, client)
-        self.assertEqual(dataset.project, client.project)
-        self.assertEqual(
-            dataset.path,
-            '/projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME))
-        self.assertEqual(dataset.access_grants, [])
-
-        self.assertIsNone(dataset.created)
-        self.assertIsNone(dataset.dataset_id)
-        self.assertIsNone(dataset.etag)
-        self.assertIsNone(dataset.modified)
-        self.assertIsNone(dataset.self_link)
-
-        self.assertIsNone(dataset.default_table_expiration_ms)
-        self.assertIsNone(dataset.description)
-        self.assertIsNone(dataset.friendly_name)
-        self.assertIsNone(dataset.location)
-
-    def test_access_roles_setter_non_list(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        with self.assertRaises(TypeError):
-            dataset.access_grants = object()
-
-    def test_access_roles_setter_invalid_field(self):
-        from google.cloud.bigquery.dataset import AccessGrant
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        phred = AccessGrant('OWNER', 'userByEmail', 'phred@example.com')
-        with self.assertRaises(ValueError):
-            dataset.access_grants = [phred, object()]
-
-    def test_access_roles_setter(self):
-        from google.cloud.bigquery.dataset import AccessGrant
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        phred = AccessGrant('OWNER', 'userByEmail', 'phred@example.com')
-        bharney = AccessGrant('OWNER', 'userByEmail', 'bharney@example.com')
-        dataset.access_grants = [phred, bharney]
-        self.assertEqual(dataset.access_grants, [phred, bharney])
-
-    def test_default_table_expiration_ms_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        with self.assertRaises(ValueError):
-            dataset.default_table_expiration_ms = 'bogus'
-
-    def test_default_table_expiration_ms_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        dataset.default_table_expiration_ms = 12345
-        self.assertEqual(dataset.default_table_expiration_ms, 12345)
-
-    def test_description_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        with self.assertRaises(ValueError):
-            dataset.description = 12345
-
-    def test_description_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        dataset.description = 'DESCRIPTION'
-        self.assertEqual(dataset.description, 'DESCRIPTION')
-
-    def test_friendly_name_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        with self.assertRaises(ValueError):
-            dataset.friendly_name = 12345
-
-    def test_friendly_name_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        dataset.friendly_name = 'FRIENDLY'
-        self.assertEqual(dataset.friendly_name, 'FRIENDLY')
-
-    def test_location_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        with self.assertRaises(ValueError):
-            dataset.location = 12345
-
-    def test_location_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client)
-        dataset.location = 'LOCATION'
-        self.assertEqual(dataset.location, 'LOCATION')
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': '%s:%s' % (self.PROJECT, self.DS_NAME),
-            'datasetReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-            }
-        }
-        klass = self._getTargetClass()
-        dataset = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(dataset._client, client)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        client = _Client(self.PROJECT)
-        RESOURCE = self._makeResource()
-        klass = self._getTargetClass()
-        dataset = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(dataset._client, client)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test__parse_access_grants_w_unknown_entity_type(self):
-        ACCESS = [
-            {'role': 'READER', 'unknown': 'UNKNOWN'},
-        ]
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-        with self.assertRaises(ValueError):
-            dataset._parse_access_grants(ACCESS)
-
-    def test__parse_access_grants_w_extra_keys(self):
-        USER_EMAIL = 'phred@example.com'
-        ACCESS = [
-            {
-                'role': 'READER',
-                'specialGroup': 'projectReaders',
-                'userByEmail': USER_EMAIL,
-            },
-        ]
-        client = _Client(self.PROJECT)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-        with self.assertRaises(ValueError):
-            dataset._parse_access_grants(ACCESS)
-
-    def test_create_w_bound_client(self):
-        PATH = 'projects/%s/datasets' % self.PROJECT
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        dataset.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'datasetReference':
-                {'projectId': self.PROJECT, 'datasetId': self.DS_NAME},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_create_w_alternate_client(self):
-        from google.cloud.bigquery.dataset import AccessGrant
-        PATH = 'projects/%s/datasets' % self.PROJECT
-        USER_EMAIL = 'phred@example.com'
-        GROUP_EMAIL = 'group-name@lists.example.com'
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        conn1 = _Connection()
-        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = self._makeOne(self.DS_NAME, client=CLIENT1)
-        dataset.friendly_name = TITLE
-        dataset.description = DESCRIPTION
-        VIEW = {
-            'projectId': 'my-proj',
-            'datasetId': 'starry-skies',
-            'tableId': 'northern-hemisphere',
-        }
-        dataset.access_grants = [
-            AccessGrant('OWNER', 'userByEmail', USER_EMAIL),
-            AccessGrant('OWNER', 'groupByEmail', GROUP_EMAIL),
-            AccessGrant('READER', 'domain', 'foo.com'),
-            AccessGrant('READER', 'specialGroup', 'projectReaders'),
-            AccessGrant('WRITER', 'specialGroup', 'projectWriters'),
-            AccessGrant(None, 'view', VIEW),
-        ]
-
-        dataset.create(client=CLIENT2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'datasetReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-            },
-            'description': DESCRIPTION,
-            'friendlyName': TITLE,
-            'access': [
-                {'role': 'OWNER', 'userByEmail': USER_EMAIL},
-                {'role': 'OWNER', 'groupByEmail': GROUP_EMAIL},
-                {'role': 'READER', 'domain': 'foo.com'},
-                {'role': 'READER', 'specialGroup': 'projectReaders'},
-                {'role': 'WRITER', 'specialGroup': 'projectWriters'},
-                {'view': VIEW},
-            ],
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_create_w_missing_output_properties(self):
-        # In the wild, the resource returned from 'dataset.create' sometimes
-        # lacks 'creationTime' / 'lastModifiedTime'
-        PATH = 'projects/%s/datasets' % (self.PROJECT,)
-        RESOURCE = self._makeResource()
-        del RESOURCE['creationTime']
-        del RESOURCE['lastModifiedTime']
-        self.WHEN = None
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        dataset.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'datasetReference':
-                {'projectId': self.PROJECT, 'datasetId': self.DS_NAME},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        self.assertFalse(dataset.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        conn1 = _Connection()
-        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = self._makeOne(self.DS_NAME, client=CLIENT1)
-
-        self.assertTrue(dataset.exists(client=CLIENT2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        dataset.reload()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = self._makeOne(self.DS_NAME, client=CLIENT1)
-
-        dataset.reload(client=CLIENT2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_patch_w_invalid_expiration(self):
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        with self.assertRaises(ValueError):
-            dataset.patch(default_table_expiration_ms='BOGUS')
-
-    def test_patch_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        dataset.patch(description=DESCRIPTION, friendly_name=TITLE)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'PATCH')
-        SENT = {
-            'description': DESCRIPTION,
-            'friendlyName': TITLE,
-        }
-        self.assertEqual(req['data'], SENT)
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_patch_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        DEF_TABLE_EXP = 12345
-        LOCATION = 'EU'
-        RESOURCE = self._makeResource()
-        RESOURCE['defaultTableExpirationMs'] = str(DEF_TABLE_EXP)
-        RESOURCE['location'] = LOCATION
-        conn1 = _Connection()
-        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = self._makeOne(self.DS_NAME, client=CLIENT1)
-
-        dataset.patch(client=CLIENT2,
-                      default_table_expiration_ms=DEF_TABLE_EXP,
-                      location=LOCATION)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'PATCH')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'defaultTableExpirationMs': DEF_TABLE_EXP,
-            'location': LOCATION,
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_update_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-        dataset.description = DESCRIPTION
-        dataset.friendly_name = TITLE
-
-        dataset.update()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'PUT')
-        SENT = {
-            'datasetReference':
-                {'projectId': self.PROJECT, 'datasetId': self.DS_NAME},
-            'description': DESCRIPTION,
-            'friendlyName': TITLE,
-        }
-        self.assertEqual(req['data'], SENT)
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_update_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        DEF_TABLE_EXP = 12345
-        LOCATION = 'EU'
-        RESOURCE = self._makeResource()
-        RESOURCE['defaultTableExpirationMs'] = 12345
-        RESOURCE['location'] = LOCATION
-        conn1 = _Connection()
-        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = self._makeOne(self.DS_NAME, client=CLIENT1)
-        dataset.default_table_expiration_ms = DEF_TABLE_EXP
-        dataset.location = LOCATION
-
-        dataset.update(client=CLIENT2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'PUT')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'datasetReference':
-                {'projectId': self.PROJECT, 'datasetId': self.DS_NAME},
-            'defaultTableExpirationMs': 12345,
-            'location': 'EU',
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_delete_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        dataset.delete()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'DELETE')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_delete_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s' % (self.PROJECT, self.DS_NAME)
-        conn1 = _Connection()
-        CLIENT1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        CLIENT2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = self._makeOne(self.DS_NAME, client=CLIENT1)
-
-        dataset.delete(client=CLIENT2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'DELETE')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_tables_empty(self):
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-        tables, token = dataset.list_tables()
-        self.assertEqual(tables, [])
-        self.assertIsNone(token)
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_tables_defaults(self):
-        from google.cloud.bigquery.table import Table
-
-        TABLE_1 = 'table_one'
-        TABLE_2 = 'table_two'
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        TOKEN = 'TOKEN'
-        DATA = {
-            'nextPageToken': TOKEN,
-            'tables': [
-                {'kind': 'bigquery#table',
-                 'id': '%s:%s.%s' % (self.PROJECT, self.DS_NAME, TABLE_1),
-                 'tableReference': {'tableId': TABLE_1,
-                                    'datasetId': self.DS_NAME,
-                                    'projectId': self.PROJECT},
-                 'type': 'TABLE'},
-                {'kind': 'bigquery#table',
-                 'id': '%s:%s.%s' % (self.PROJECT, self.DS_NAME, TABLE_2),
-                 'tableReference': {'tableId': TABLE_2,
-                                    'datasetId': self.DS_NAME,
-                                    'projectId': self.PROJECT},
-                 'type': 'TABLE'},
-            ]
-        }
-
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        tables, token = dataset.list_tables()
-
-        self.assertEqual(len(tables), len(DATA['tables']))
-        for found, expected in zip(tables, DATA['tables']):
-            self.assertIsInstance(found, Table)
-            self.assertEqual(found.table_id, expected['id'])
-            self.assertEqual(found.table_type, expected['type'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_tables_explicit(self):
-        from google.cloud.bigquery.table import Table
-
-        TABLE_1 = 'table_one'
-        TABLE_2 = 'table_two'
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        TOKEN = 'TOKEN'
-        DATA = {
-            'tables': [
-                {'kind': 'bigquery#dataset',
-                 'id': '%s:%s.%s' % (self.PROJECT, self.DS_NAME, TABLE_1),
-                 'tableReference': {'tableId': TABLE_1,
-                                    'datasetId': self.DS_NAME,
-                                    'projectId': self.PROJECT},
-                 'type': 'TABLE'},
-                {'kind': 'bigquery#dataset',
-                 'id': '%s:%s.%s' % (self.PROJECT, self.DS_NAME, TABLE_2),
-                 'tableReference': {'tableId': TABLE_2,
-                                    'datasetId': self.DS_NAME,
-                                    'projectId': self.PROJECT},
-                 'type': 'TABLE'},
-            ]
-        }
-
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-
-        tables, token = dataset.list_tables(max_results=3, page_token=TOKEN)
-
-        self.assertEqual(len(tables), len(DATA['tables']))
-        for found, expected in zip(tables, DATA['tables']):
-            self.assertIsInstance(found, Table)
-            self.assertEqual(found.table_id, expected['id'])
-            self.assertEqual(found.table_type, expected['type'])
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': 3, 'pageToken': TOKEN})
-
-    def test_table_wo_schema(self):
-        from google.cloud.bigquery.table import Table
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-        table = dataset.table('table_name')
-        self.assertIsInstance(table, Table)
-        self.assertEqual(table.name, 'table_name')
-        self.assertIs(table._dataset, dataset)
-        self.assertEqual(table.schema, [])
-
-    def test_table_w_schema(self):
-        from google.cloud.bigquery.schema import SchemaField
-        from google.cloud.bigquery.table import Table
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = self._makeOne(self.DS_NAME, client=client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = dataset.table('table_name', schema=[full_name, age])
-        self.assertIsInstance(table, Table)
-        self.assertEqual(table.name, 'table_name')
-        self.assertIs(table._dataset, dataset)
-        self.assertEqual(table.schema, [full_name, age])
-
-
-class _Client(object):
-
-    def __init__(self, project='project', connection=None):
-        self.project = project
-        self.connection = connection
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
diff --git a/unit_tests/bigquery/test_job.py b/unit_tests/bigquery/test_job.py
deleted file mode 100644
index 09ea4dbc2731..000000000000
--- a/unit_tests/bigquery/test_job.py
+++ /dev/null
@@ -1,1688 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class _Base(object):
-    PROJECT = 'project'
-    SOURCE1 = 'http://example.com/source1.csv'
-    DS_NAME = 'datset_name'
-    TABLE_NAME = 'table_name'
-    JOB_NAME = 'job_name'
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _setUpConstants(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        self.WHEN_TS = 1437767599.006
-        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(
-            tzinfo=UTC)
-        self.ETAG = 'ETAG'
-        self.JOB_ID = '%s:%s' % (self.PROJECT, self.JOB_NAME)
-        self.RESOURCE_URL = 'http://example.com/path/to/resource'
-        self.USER_EMAIL = 'phred@example.com'
-
-    def _makeResource(self, started=False, ended=False):
-        self._setUpConstants()
-        resource = {
-            'configuration': {
-                self.JOB_TYPE: {
-                },
-            },
-            'statistics': {
-                'creationTime': self.WHEN_TS * 1000,
-                self.JOB_TYPE: {
-                }
-            },
-            'etag': self.ETAG,
-            'id': self.JOB_ID,
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'selfLink': self.RESOURCE_URL,
-            'user_email': self.USER_EMAIL,
-        }
-
-        if started or ended:
-            resource['statistics']['startTime'] = self.WHEN_TS * 1000
-
-        if ended:
-            resource['statistics']['endTime'] = (self.WHEN_TS + 1000) * 1000
-
-        return resource
-
-    def _verifyInitialReadonlyProperties(self, job):
-        # root elements of resource
-        self.assertIsNone(job.etag)
-        self.assertIsNone(job.self_link)
-        self.assertIsNone(job.user_email)
-
-        # derived from resource['statistics']
-        self.assertIsNone(job.created)
-        self.assertIsNone(job.started)
-        self.assertIsNone(job.ended)
-
-        # derived from resource['status']
-        self.assertIsNone(job.error_result)
-        self.assertIsNone(job.errors)
-        self.assertIsNone(job.state)
-
-    def _verifyReadonlyResourceProperties(self, job, resource):
-        from datetime import timedelta
-
-        statistics = resource.get('statistics', {})
-
-        if 'creationTime' in statistics:
-            self.assertEqual(job.created, self.WHEN)
-        else:
-            self.assertIsNone(job.created)
-
-        if 'startTime' in statistics:
-            self.assertEqual(job.started, self.WHEN)
-        else:
-            self.assertIsNone(job.started)
-
-        if 'endTime' in statistics:
-            self.assertEqual(job.ended, self.WHEN + timedelta(seconds=1000))
-        else:
-            self.assertIsNone(job.ended)
-
-        if 'etag' in resource:
-            self.assertEqual(job.etag, self.ETAG)
-        else:
-            self.assertIsNone(job.etag)
-
-        if 'selfLink' in resource:
-            self.assertEqual(job.self_link, self.RESOURCE_URL)
-        else:
-            self.assertIsNone(job.self_link)
-
-        if 'user_email' in resource:
-            self.assertEqual(job.user_email, self.USER_EMAIL)
-        else:
-            self.assertIsNone(job.user_email)
-
-
-class TestLoadTableFromStorageJob(unittest.TestCase, _Base):
-    JOB_TYPE = 'load'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.job import LoadTableFromStorageJob
-        return LoadTableFromStorageJob
-
-    def _setUpConstants(self):
-        super(TestLoadTableFromStorageJob, self)._setUpConstants()
-        self.INPUT_FILES = 2
-        self.INPUT_BYTES = 12345
-        self.OUTPUT_BYTES = 23456
-        self.OUTPUT_ROWS = 345
-
-    def _makeResource(self, started=False, ended=False):
-        resource = super(TestLoadTableFromStorageJob, self)._makeResource(
-            started, ended)
-        config = resource['configuration']['load']
-        config['sourceUris'] = [self.SOURCE1]
-        config['destinationTable'] = {
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.TABLE_NAME,
-        }
-
-        if ended:
-            resource['statistics']['load']['inputFiles'] = self.INPUT_FILES
-            resource['statistics']['load']['inputFileBytes'] = self.INPUT_BYTES
-            resource['statistics']['load']['outputBytes'] = self.OUTPUT_BYTES
-            resource['statistics']['load']['outputRows'] = self.OUTPUT_ROWS
-
-        return resource
-
-    def _verifyBooleanConfigProperties(self, job, config):
-        if 'allowJaggedRows' in config:
-            self.assertEqual(job.allow_jagged_rows,
-                             config['allowJaggedRows'])
-        else:
-            self.assertIsNone(job.allow_jagged_rows)
-        if 'allowQuotedNewlines' in config:
-            self.assertEqual(job.allow_quoted_newlines,
-                             config['allowQuotedNewlines'])
-        else:
-            self.assertIsNone(job.allow_quoted_newlines)
-        if 'ignoreUnknownValues' in config:
-            self.assertEqual(job.ignore_unknown_values,
-                             config['ignoreUnknownValues'])
-        else:
-            self.assertIsNone(job.ignore_unknown_values)
-
-    def _verifyEnumConfigProperties(self, job, config):
-        if 'createDisposition' in config:
-            self.assertEqual(job.create_disposition,
-                             config['createDisposition'])
-        else:
-            self.assertIsNone(job.create_disposition)
-        if 'encoding' in config:
-            self.assertEqual(job.encoding,
-                             config['encoding'])
-        else:
-            self.assertIsNone(job.encoding)
-        if 'sourceFormat' in config:
-            self.assertEqual(job.source_format,
-                             config['sourceFormat'])
-        else:
-            self.assertIsNone(job.source_format)
-        if 'writeDisposition' in config:
-            self.assertEqual(job.write_disposition,
-                             config['writeDisposition'])
-        else:
-            self.assertIsNone(job.write_disposition)
-
-    def _verifyResourceProperties(self, job, resource):
-        self._verifyReadonlyResourceProperties(job, resource)
-
-        config = resource.get('configuration', {}).get('load')
-
-        self._verifyBooleanConfigProperties(job, config)
-        self._verifyEnumConfigProperties(job, config)
-
-        self.assertEqual(job.source_uris, config['sourceUris'])
-
-        table_ref = config['destinationTable']
-        self.assertEqual(job.destination.project, table_ref['projectId'])
-        self.assertEqual(job.destination.dataset_name, table_ref['datasetId'])
-        self.assertEqual(job.destination.name, table_ref['tableId'])
-
-        if 'fieldDelimiter' in config:
-            self.assertEqual(job.field_delimiter,
-                             config['fieldDelimiter'])
-        else:
-            self.assertIsNone(job.field_delimiter)
-        if 'maxBadRecords' in config:
-            self.assertEqual(job.max_bad_records,
-                             config['maxBadRecords'])
-        else:
-            self.assertIsNone(job.max_bad_records)
-        if 'quote' in config:
-            self.assertEqual(job.quote_character,
-                             config['quote'])
-        else:
-            self.assertIsNone(job.quote_character)
-        if 'skipLeadingRows' in config:
-            self.assertEqual(job.skip_leading_rows,
-                             config['skipLeadingRows'])
-        else:
-            self.assertIsNone(job.skip_leading_rows)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-        self.assertIs(job.destination, table)
-        self.assertEqual(list(job.source_uris), [self.SOURCE1])
-        self.assertIs(job._client, client)
-        self.assertEqual(job.job_type, self.JOB_TYPE)
-        self.assertEqual(
-            job.path,
-            '/projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME))
-        self.assertEqual(job.schema, [])
-
-        self._verifyInitialReadonlyProperties(job)
-
-        # derived from resource['statistics']['load']
-        self.assertIsNone(job.input_file_bytes)
-        self.assertIsNone(job.input_files)
-        self.assertIsNone(job.output_bytes)
-        self.assertIsNone(job.output_rows)
-
-        # set/read from resource['configuration']['load']
-        self.assertIsNone(job.allow_jagged_rows)
-        self.assertIsNone(job.allow_quoted_newlines)
-        self.assertIsNone(job.create_disposition)
-        self.assertIsNone(job.encoding)
-        self.assertIsNone(job.field_delimiter)
-        self.assertIsNone(job.ignore_unknown_values)
-        self.assertIsNone(job.max_bad_records)
-        self.assertIsNone(job.quote_character)
-        self.assertIsNone(job.skip_leading_rows)
-        self.assertIsNone(job.source_format)
-        self.assertIsNone(job.write_disposition)
-
-    def test_ctor_w_schema(self):
-        from google.cloud.bigquery.schema import SchemaField
-        client = _Client(self.PROJECT)
-        table = _Table()
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client,
-                            schema=[full_name, age])
-        self.assertEqual(job.schema, [full_name, age])
-
-    def test_schema_setter_non_list(self):
-        client = _Client(self.PROJECT)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-        with self.assertRaises(TypeError):
-            job.schema = object()
-
-    def test_schema_setter_invalid_field(self):
-        from google.cloud.bigquery.schema import SchemaField
-        client = _Client(self.PROJECT)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        with self.assertRaises(ValueError):
-            job.schema = [full_name, object()]
-
-    def test_schema_setter(self):
-        from google.cloud.bigquery.schema import SchemaField
-        client = _Client(self.PROJECT)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        job.schema = [full_name, age]
-        self.assertEqual(job.schema, [full_name, age])
-
-    def test_props_set_by_server(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _millis
-
-        CREATED = datetime.datetime(2015, 8, 11, 12, 13, 22, tzinfo=UTC)
-        STARTED = datetime.datetime(2015, 8, 11, 13, 47, 15, tzinfo=UTC)
-        ENDED = datetime.datetime(2015, 8, 11, 14, 47, 15, tzinfo=UTC)
-        JOB_ID = '%s:%s' % (self.PROJECT, self.JOB_NAME)
-        URL = 'http://example.com/projects/%s/jobs/%s' % (
-            self.PROJECT, self.JOB_NAME)
-        EMAIL = 'phred@example.com'
-        ERROR_RESULT = {'debugInfo': 'DEBUG',
-                        'location': 'LOCATION',
-                        'message': 'MESSAGE',
-                        'reason': 'REASON'}
-
-        client = _Client(self.PROJECT)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-        job._properties['etag'] = 'ETAG'
-        job._properties['id'] = JOB_ID
-        job._properties['selfLink'] = URL
-        job._properties['user_email'] = EMAIL
-
-        statistics = job._properties['statistics'] = {}
-        statistics['creationTime'] = _millis(CREATED)
-        statistics['startTime'] = _millis(STARTED)
-        statistics['endTime'] = _millis(ENDED)
-        load_stats = statistics['load'] = {}
-        load_stats['inputFileBytes'] = 12345
-        load_stats['inputFiles'] = 1
-        load_stats['outputBytes'] = 23456
-        load_stats['outputRows'] = 345
-
-        self.assertEqual(job.etag, 'ETAG')
-        self.assertEqual(job.self_link, URL)
-        self.assertEqual(job.user_email, EMAIL)
-
-        self.assertEqual(job.created, CREATED)
-        self.assertEqual(job.started, STARTED)
-        self.assertEqual(job.ended, ENDED)
-
-        self.assertEqual(job.input_file_bytes, 12345)
-        self.assertEqual(job.input_files, 1)
-        self.assertEqual(job.output_bytes, 23456)
-        self.assertEqual(job.output_rows, 345)
-
-        status = job._properties['status'] = {}
-
-        self.assertIsNone(job.error_result)
-        self.assertIsNone(job.errors)
-        self.assertIsNone(job.state)
-
-        status['errorResult'] = ERROR_RESULT
-        status['errors'] = [ERROR_RESULT]
-        status['state'] = 'STATE'
-
-        self.assertEqual(job.error_result, ERROR_RESULT)
-        self.assertEqual(job.errors, [ERROR_RESULT])
-        self.assertEqual(job.state, 'STATE')
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_missing_config(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': '%s:%s' % (self.PROJECT, self.DS_NAME),
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            }
-        }
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': self.JOB_ID,
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'load': {
-                    'sourceUris': [self.SOURCE1],
-                    'destinationTable': {
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.TABLE_NAME,
-                    },
-                }
-            },
-        }
-        klass = self._getTargetClass()
-        job = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(job._client, client)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        client = _Client(self.PROJECT)
-        RESOURCE = self._makeResource()
-        klass = self._getTargetClass()
-        dataset = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(dataset._client, client)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_begin_w_already_running(self):
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-        job._properties['status'] = {'state': 'RUNNING'}
-
-        with self.assertRaises(ValueError):
-            job.begin()
-
-    def test_begin_w_bound_client(self):
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource()
-        # Ensure None for missing server-set props
-        del RESOURCE['statistics']['creationTime']
-        del RESOURCE['etag']
-        del RESOURCE['selfLink']
-        del RESOURCE['user_email']
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-
-        job.begin()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'load': {
-                    'sourceUris': [self.SOURCE1],
-                    'destinationTable': {
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.TABLE_NAME,
-                    },
-                },
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_begin_w_alternate_client(self):
-        from google.cloud.bigquery.schema import SchemaField
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource(ended=True)
-        LOAD_CONFIGURATION = {
-            'sourceUris': [self.SOURCE1],
-            'destinationTable': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME,
-            },
-            'allowJaggedRows': True,
-            'allowQuotedNewlines': True,
-            'createDisposition': 'CREATE_NEVER',
-            'encoding': 'ISO-8559-1',
-            'fieldDelimiter': '|',
-            'ignoreUnknownValues': True,
-            'maxBadRecords': 100,
-            'quote': "'",
-            'skipLeadingRows': 1,
-            'sourceFormat': 'CSV',
-            'writeDisposition': 'WRITE_TRUNCATE',
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'},
-            ]}
-        }
-        RESOURCE['configuration']['load'] = LOAD_CONFIGURATION
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        table = _Table()
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client1,
-                            schema=[full_name, age])
-
-        job.allow_jagged_rows = True
-        job.allow_quoted_newlines = True
-        job.create_disposition = 'CREATE_NEVER'
-        job.encoding = 'ISO-8559-1'
-        job.field_delimiter = '|'
-        job.ignore_unknown_values = True
-        job.max_bad_records = 100
-        job.quote_character = "'"
-        job.skip_leading_rows = 1
-        job.source_format = 'CSV'
-        job.write_disposition = 'WRITE_TRUNCATE'
-
-        job.begin(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'load': LOAD_CONFIGURATION,
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-
-        self.assertFalse(job.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client1)
-
-        self.assertTrue(job.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-
-        job.reload()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client1)
-
-        job.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_cancel_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s/cancel' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource(ended=True)
-        RESPONSE = {'job': RESOURCE}
-        conn = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client)
-
-        job.cancel()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_cancel_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s/cancel' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource(ended=True)
-        RESPONSE = {'job': RESOURCE}
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESPONSE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        table = _Table()
-        job = self._makeOne(self.JOB_NAME, table, [self.SOURCE1], client1)
-
-        job.cancel(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-
-class TestCopyJob(unittest.TestCase, _Base):
-    JOB_TYPE = 'copy'
-    SOURCE_TABLE = 'source_table'
-    DESTINATION_TABLE = 'destination_table'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.job import CopyJob
-        return CopyJob
-
-    def _makeResource(self, started=False, ended=False):
-        resource = super(TestCopyJob, self)._makeResource(
-            started, ended)
-        config = resource['configuration']['copy']
-        config['sourceTables'] = [{
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.SOURCE_TABLE,
-        }]
-        config['destinationTable'] = {
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.DESTINATION_TABLE,
-        }
-
-        return resource
-
-    def _verifyResourceProperties(self, job, resource):
-        self._verifyReadonlyResourceProperties(job, resource)
-
-        config = resource.get('configuration', {}).get('copy')
-
-        table_ref = config['destinationTable']
-        self.assertEqual(job.destination.project, table_ref['projectId'])
-        self.assertEqual(job.destination.dataset_name, table_ref['datasetId'])
-        self.assertEqual(job.destination.name, table_ref['tableId'])
-
-        sources = config['sourceTables']
-        self.assertEqual(len(sources), len(job.sources))
-        for table_ref, table in zip(sources, job.sources):
-            self.assertEqual(table.project, table_ref['projectId'])
-            self.assertEqual(table.dataset_name, table_ref['datasetId'])
-            self.assertEqual(table.name, table_ref['tableId'])
-
-        if 'createDisposition' in config:
-            self.assertEqual(job.create_disposition,
-                             config['createDisposition'])
-        else:
-            self.assertIsNone(job.create_disposition)
-
-        if 'writeDisposition' in config:
-            self.assertEqual(job.write_disposition,
-                             config['writeDisposition'])
-        else:
-            self.assertIsNone(job.write_disposition)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client)
-        self.assertIs(job.destination, destination)
-        self.assertEqual(job.sources, [source])
-        self.assertIs(job._client, client)
-        self.assertEqual(job.job_type, self.JOB_TYPE)
-        self.assertEqual(
-            job.path,
-            '/projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME))
-
-        self._verifyInitialReadonlyProperties(job)
-
-        # set/read from resource['configuration']['copy']
-        self.assertIsNone(job.create_disposition)
-        self.assertIsNone(job.write_disposition)
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_missing_config(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': '%s:%s' % (self.PROJECT, self.DS_NAME),
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            }
-        }
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': self.JOB_ID,
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'copy': {
-                    'sourceTables': [{
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.SOURCE_TABLE,
-                    }],
-                    'destinationTable': {
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.DESTINATION_TABLE,
-                    },
-                }
-            },
-        }
-        klass = self._getTargetClass()
-        job = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(job._client, client)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        client = _Client(self.PROJECT)
-        RESOURCE = self._makeResource()
-        klass = self._getTargetClass()
-        dataset = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(dataset._client, client)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_begin_w_bound_client(self):
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource()
-        # Ensure None for missing server-set props
-        del RESOURCE['statistics']['creationTime']
-        del RESOURCE['etag']
-        del RESOURCE['selfLink']
-        del RESOURCE['user_email']
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client)
-
-        job.begin()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'copy': {
-                    'sourceTables': [{
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.SOURCE_TABLE
-                    }],
-                    'destinationTable': {
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.DESTINATION_TABLE,
-                    },
-                },
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_begin_w_alternate_client(self):
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource(ended=True)
-        COPY_CONFIGURATION = {
-            'sourceTables': [{
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.SOURCE_TABLE,
-            }],
-            'destinationTable': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.DESTINATION_TABLE,
-            },
-            'createDisposition': 'CREATE_NEVER',
-            'writeDisposition': 'WRITE_TRUNCATE',
-        }
-        RESOURCE['configuration']['copy'] = COPY_CONFIGURATION
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client1)
-
-        job.create_disposition = 'CREATE_NEVER'
-        job.write_disposition = 'WRITE_TRUNCATE'
-
-        job.begin(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'copy': COPY_CONFIGURATION,
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client)
-
-        self.assertFalse(job.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client1)
-
-        self.assertTrue(job.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client)
-
-        job.reload()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        source = _Table(self.SOURCE_TABLE)
-        destination = _Table(self.DESTINATION_TABLE)
-        job = self._makeOne(self.JOB_NAME, destination, [source], client1)
-
-        job.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-
-class TestExtractTableToStorageJob(unittest.TestCase, _Base):
-    JOB_TYPE = 'extract'
-    SOURCE_TABLE = 'source_table'
-    DESTINATION_URI = 'gs://bucket_name/object_name'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.job import ExtractTableToStorageJob
-        return ExtractTableToStorageJob
-
-    def _makeResource(self, started=False, ended=False):
-        resource = super(TestExtractTableToStorageJob, self)._makeResource(
-            started, ended)
-        config = resource['configuration']['extract']
-        config['sourceTable'] = {
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.SOURCE_TABLE,
-        }
-        config['destinationUris'] = [self.DESTINATION_URI]
-        return resource
-
-    def _verifyResourceProperties(self, job, resource):
-        self._verifyReadonlyResourceProperties(job, resource)
-
-        config = resource.get('configuration', {}).get('extract')
-
-        self.assertEqual(job.destination_uris, config['destinationUris'])
-
-        table_ref = config['sourceTable']
-        self.assertEqual(job.source.project, table_ref['projectId'])
-        self.assertEqual(job.source.dataset_name, table_ref['datasetId'])
-        self.assertEqual(job.source.name, table_ref['tableId'])
-
-        if 'compression' in config:
-            self.assertEqual(job.compression,
-                             config['compression'])
-        else:
-            self.assertIsNone(job.compression)
-
-        if 'destinationFormat' in config:
-            self.assertEqual(job.destination_format,
-                             config['destinationFormat'])
-        else:
-            self.assertIsNone(job.destination_format)
-
-        if 'fieldDelimiter' in config:
-            self.assertEqual(job.field_delimiter,
-                             config['fieldDelimiter'])
-        else:
-            self.assertIsNone(job.field_delimiter)
-
-        if 'printHeader' in config:
-            self.assertEqual(job.print_header,
-                             config['printHeader'])
-        else:
-            self.assertIsNone(job.print_header)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client)
-        self.assertEqual(job.source, source)
-        self.assertEqual(job.destination_uris, [self.DESTINATION_URI])
-        self.assertIs(job._client, client)
-        self.assertEqual(job.job_type, self.JOB_TYPE)
-        self.assertEqual(
-            job.path,
-            '/projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME))
-
-        self._verifyInitialReadonlyProperties(job)
-
-        # set/read from resource['configuration']['copy']
-        self.assertIsNone(job.compression)
-        self.assertIsNone(job.destination_format)
-        self.assertIsNone(job.field_delimiter)
-        self.assertIsNone(job.print_header)
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_missing_config(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': '%s:%s' % (self.PROJECT, self.DS_NAME),
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            }
-        }
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': self.JOB_ID,
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'extract': {
-                    'sourceTable': {
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.SOURCE_TABLE,
-                    },
-                    'destinationUris': [self.DESTINATION_URI],
-                }
-            },
-        }
-        klass = self._getTargetClass()
-        job = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(job._client, client)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        client = _Client(self.PROJECT)
-        RESOURCE = self._makeResource()
-        klass = self._getTargetClass()
-        dataset = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(dataset._client, client)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_begin_w_bound_client(self):
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource()
-        # Ensure None for missing server-set props
-        del RESOURCE['statistics']['creationTime']
-        del RESOURCE['etag']
-        del RESOURCE['selfLink']
-        del RESOURCE['user_email']
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client)
-
-        job.begin()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'extract': {
-                    'sourceTable': {
-                        'projectId': self.PROJECT,
-                        'datasetId': self.DS_NAME,
-                        'tableId': self.SOURCE_TABLE
-                    },
-                    'destinationUris': [self.DESTINATION_URI],
-                },
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_begin_w_alternate_client(self):
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource(ended=True)
-        EXTRACT_CONFIGURATION = {
-            'sourceTable': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.SOURCE_TABLE,
-            },
-            'destinationUris': [self.DESTINATION_URI],
-            'compression': 'GZIP',
-            'destinationFormat': 'NEWLINE_DELIMITED_JSON',
-            'fieldDelimiter': '|',
-            'printHeader': False,
-        }
-        RESOURCE['configuration']['extract'] = EXTRACT_CONFIGURATION
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client1)
-
-        job.compression = 'GZIP'
-        job.destination_format = 'NEWLINE_DELIMITED_JSON'
-        job.field_delimiter = '|'
-        job.print_header = False
-
-        job.begin(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'extract': EXTRACT_CONFIGURATION,
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client)
-
-        self.assertFalse(job.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client1)
-
-        self.assertTrue(job.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client)
-
-        job.reload()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        source = _Table(self.SOURCE_TABLE)
-        job = self._makeOne(self.JOB_NAME, source, [self.DESTINATION_URI],
-                            client1)
-
-        job.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-
-class TestQueryJob(unittest.TestCase, _Base):
-    JOB_TYPE = 'query'
-    QUERY = 'select count(*) from persons'
-    DESTINATION_TABLE = 'destination_table'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.job import QueryJob
-        return QueryJob
-
-    def _makeResource(self, started=False, ended=False):
-        resource = super(TestQueryJob, self)._makeResource(
-            started, ended)
-        config = resource['configuration']['query']
-        config['query'] = self.QUERY
-        return resource
-
-    def _verifyBooleanResourceProperties(self, job, config):
-
-        if 'allowLargeResults' in config:
-            self.assertEqual(job.allow_large_results,
-                             config['allowLargeResults'])
-        else:
-            self.assertIsNone(job.allow_large_results)
-        if 'flattenResults' in config:
-            self.assertEqual(job.flatten_results,
-                             config['flattenResults'])
-        else:
-            self.assertIsNone(job.flatten_results)
-        if 'useQueryCache' in config:
-            self.assertEqual(job.use_query_cache,
-                             config['useQueryCache'])
-        else:
-            self.assertIsNone(job.use_query_cache)
-        if 'useLegacySql' in config:
-            self.assertEqual(job.use_legacy_sql,
-                             config['useLegacySql'])
-        else:
-            self.assertIsNone(job.use_legacy_sql)
-        if 'dryRun' in config:
-            self.assertEqual(job.dry_run,
-                             config['dryRun'])
-        else:
-            self.assertIsNone(job.dry_run)
-
-    def _verifyIntegerResourceProperties(self, job, config):
-        if 'maximumBillingTier' in config:
-            self.assertEqual(job.maximum_billing_tier,
-                             config['maximumBillingTier'])
-        else:
-            self.assertIsNone(job.maximum_billing_tier)
-        if 'maximumBytesBilled' in config:
-            self.assertEqual(job.maximum_bytes_billed,
-                             config['maximumBytesBilled'])
-        else:
-            self.assertIsNone(job.maximum_bytes_billed)
-
-    def _verifyResourceProperties(self, job, resource):
-        self._verifyReadonlyResourceProperties(job, resource)
-
-        config = resource.get('configuration', {}).get('query')
-        self._verifyBooleanResourceProperties(job, config)
-        self._verifyIntegerResourceProperties(job, config)
-
-        if 'createDisposition' in config:
-            self.assertEqual(job.create_disposition,
-                             config['createDisposition'])
-        else:
-            self.assertIsNone(job.create_disposition)
-        if 'defaultDataset' in config:
-            dataset = job.default_dataset
-            ds_ref = {
-                'projectId': dataset.project,
-                'datasetId': dataset.name,
-            }
-            self.assertEqual(ds_ref, config['defaultDataset'])
-        else:
-            self.assertIsNone(job.default_dataset)
-        if 'destinationTable' in config:
-            table = job.destination
-            tb_ref = {
-                'projectId': table.project,
-                'datasetId': table.dataset_name,
-                'tableId': table.name
-            }
-            self.assertEqual(tb_ref, config['destinationTable'])
-        else:
-            self.assertIsNone(job.destination)
-        if 'priority' in config:
-            self.assertEqual(job.priority,
-                             config['priority'])
-        else:
-            self.assertIsNone(job.priority)
-        if 'writeDisposition' in config:
-            self.assertEqual(job.write_disposition,
-                             config['writeDisposition'])
-        else:
-            self.assertIsNone(job.write_disposition)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client)
-        self.assertEqual(job.query, self.QUERY)
-        self.assertIs(job._client, client)
-        self.assertEqual(job.job_type, self.JOB_TYPE)
-        self.assertEqual(
-            job.path,
-            '/projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME))
-
-        self._verifyInitialReadonlyProperties(job)
-
-        # set/read from resource['configuration']['copy']
-        self.assertIsNone(job.allow_large_results)
-        self.assertIsNone(job.create_disposition)
-        self.assertIsNone(job.default_dataset)
-        self.assertIsNone(job.destination)
-        self.assertIsNone(job.flatten_results)
-        self.assertIsNone(job.priority)
-        self.assertIsNone(job.use_query_cache)
-        self.assertIsNone(job.use_legacy_sql)
-        self.assertIsNone(job.dry_run)
-        self.assertIsNone(job.write_disposition)
-        self.assertIsNone(job.maximum_billing_tier)
-        self.assertIsNone(job.maximum_bytes_billed)
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_missing_config(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': '%s:%s' % (self.PROJECT, self.DS_NAME),
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            }
-        }
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'id': self.JOB_ID,
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'query': {'query': self.QUERY}
-            },
-        }
-        klass = self._getTargetClass()
-        job = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(job._client, client)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        client = _Client(self.PROJECT)
-        RESOURCE = self._makeResource()
-        RESOURCE['configuration']['query']['destinationTable'] = {
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.DESTINATION_TABLE,
-        }
-        klass = self._getTargetClass()
-        dataset = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(dataset._client, client)
-        self._verifyResourceProperties(dataset, RESOURCE)
-
-    def test_results(self):
-        from google.cloud.bigquery.query import QueryResults
-        client = _Client(self.PROJECT)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client)
-        results = job.results()
-        self.assertIsInstance(results, QueryResults)
-        self.assertIs(results._job, job)
-
-    def test_begin_w_bound_client(self):
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource()
-        # Ensure None for missing server-set props
-        del RESOURCE['statistics']['creationTime']
-        del RESOURCE['etag']
-        del RESOURCE['selfLink']
-        del RESOURCE['user_email']
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client)
-
-        job.begin()
-        self.assertEqual(job.udf_resources, [])
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'query': {
-                    'query': self.QUERY
-                },
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_begin_w_alternate_client(self):
-        from google.cloud.bigquery.dataset import Dataset
-        from google.cloud.bigquery.dataset import Table
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        TABLE = 'TABLE'
-        DS_NAME = 'DATASET'
-        RESOURCE = self._makeResource(ended=True)
-        QUERY_CONFIGURATION = {
-            'query': self.QUERY,
-            'allowLargeResults': True,
-            'createDisposition': 'CREATE_NEVER',
-            'defaultDataset': {
-                'projectId': self.PROJECT,
-                'datasetId': DS_NAME,
-            },
-            'destinationTable': {
-                'projectId': self.PROJECT,
-                'datasetId': DS_NAME,
-                'tableId': TABLE,
-            },
-            'flattenResults': True,
-            'priority': 'INTERACTIVE',
-            'useQueryCache': True,
-            'useLegacySql': True,
-            'dryRun': True,
-            'writeDisposition': 'WRITE_TRUNCATE',
-            'maximumBillingTier': 4,
-            'maximumBytesBilled': 123456
-        }
-        RESOURCE['configuration']['query'] = QUERY_CONFIGURATION
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client1)
-
-        dataset = Dataset(DS_NAME, client1)
-        table = Table(TABLE, dataset)
-
-        job.allow_large_results = True
-        job.create_disposition = 'CREATE_NEVER'
-        job.default_dataset = dataset
-        job.destination = table
-        job.flatten_results = True
-        job.priority = 'INTERACTIVE'
-        job.use_query_cache = True
-        job.use_legacy_sql = True
-        job.dry_run = True
-        job.write_disposition = 'WRITE_TRUNCATE'
-        job.maximum_billing_tier = 4
-        job.maximum_bytes_billed = 123456
-
-        job.begin(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'query': QUERY_CONFIGURATION,
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_begin_w_bound_client_and_udf(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        PATH = 'projects/%s/jobs' % self.PROJECT
-        RESOURCE = self._makeResource()
-        # Ensure None for missing server-set props
-        del RESOURCE['statistics']['creationTime']
-        del RESOURCE['etag']
-        del RESOURCE['selfLink']
-        del RESOURCE['user_email']
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client,
-                            udf_resources=[
-                                UDFResource("resourceUri", RESOURCE_URI)
-                            ])
-
-        job.begin()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(job.udf_resources,
-                         [UDFResource("resourceUri", RESOURCE_URI)])
-        SENT = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'configuration': {
-                'query': {
-                    'query': self.QUERY,
-                    'userDefinedFunctionResources':
-                        [{'resourceUri': RESOURCE_URI}]
-                },
-            },
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client)
-
-        self.assertFalse(job.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client1)
-
-        self.assertTrue(job.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        from google.cloud.bigquery.dataset import Dataset
-        from google.cloud.bigquery.dataset import Table
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        DS_NAME = 'DATASET'
-        DEST_TABLE = 'dest_table'
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client)
-
-        dataset = Dataset(DS_NAME, client)
-        table = Table(DEST_TABLE, dataset)
-        job.destination = table
-
-        job.reload()
-
-        self.assertIsNone(job.destination)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/jobs/%s' % (self.PROJECT, self.JOB_NAME)
-        DS_NAME = 'DATASET'
-        DEST_TABLE = 'dest_table'
-        RESOURCE = self._makeResource()
-        q_config = RESOURCE['configuration']['query']
-        q_config['destinationTable'] = {
-            'projectId': self.PROJECT,
-            'datasetId': DS_NAME,
-            'tableId': DEST_TABLE,
-        }
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        job = self._makeOne(self.JOB_NAME, self.QUERY, client1)
-
-        job.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(job, RESOURCE)
-
-
-class _Client(object):
-
-    def __init__(self, project='project', connection=None):
-        self.project = project
-        self.connection = connection
-
-    def dataset(self, name):
-        from google.cloud.bigquery.dataset import Dataset
-        return Dataset(name, client=self)
-
-
-class _Table(object):
-
-    def __init__(self, name=None):
-        self._name = name
-
-    @property
-    def name(self):
-        if self._name is not None:
-            return self._name
-        return TestLoadTableFromStorageJob.TABLE_NAME
-
-    @property
-    def project(self):
-        return TestLoadTableFromStorageJob.PROJECT
-
-    @property
-    def dataset_name(self):
-        return TestLoadTableFromStorageJob.DS_NAME
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
diff --git a/unit_tests/bigquery/test_query.py b/unit_tests/bigquery/test_query.py
deleted file mode 100644
index e791735316e8..000000000000
--- a/unit_tests/bigquery/test_query.py
+++ /dev/null
@@ -1,458 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestQueryResults(unittest.TestCase):
-    PROJECT = 'project'
-    JOB_NAME = 'job_name'
-    JOB_NAME = 'test-synchronous-query'
-    JOB_TYPE = 'query'
-    QUERY = 'select count(*) from persons'
-    TOKEN = 'TOKEN'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.query import QueryResults
-        return QueryResults
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _makeResource(self, complete=False):
-        resource = {
-            'jobReference': {
-                'projectId': self.PROJECT,
-                'jobId': self.JOB_NAME,
-            },
-            'jobComplete': complete,
-            'errors': [],
-            'schema': {
-                'fields': [
-                    {'name': 'full_name', 'type': 'STRING', 'mode': 'REQURED'},
-                    {'name': 'age', 'type': 'INTEGER', 'mode': 'REQURED'},
-                ],
-            },
-        }
-
-        if complete:
-            resource['totalRows'] = '1000'
-            resource['rows'] = [
-                {'f': [
-                    {'v': 'Phred Phlyntstone'},
-                    {'v': 32},
-                ]},
-                {'f': [
-                    {'v': 'Bharney Rhubble'},
-                    {'v': 33},
-                ]},
-                {'f': [
-                    {'v': 'Wylma Phlyntstone'},
-                    {'v': 29},
-                ]},
-                {'f': [
-                    {'v': 'Bhettye Rhubble'},
-                    {'v': 27},
-                ]},
-            ]
-            resource['pageToken'] = self.TOKEN
-            resource['totalBytesProcessed'] = 100000
-            resource['cacheHit'] = False
-
-        return resource
-
-    def _verifySchema(self, query, resource):
-        from google.cloud.bigquery.schema import SchemaField
-        if 'schema' in resource:
-            fields = resource['schema']['fields']
-            self.assertEqual(len(query.schema), len(fields))
-            for found, expected in zip(query.schema, fields):
-                self.assertIsInstance(found, SchemaField)
-                self.assertEqual(found.name, expected['name'])
-                self.assertEqual(found.field_type, expected['type'])
-                self.assertEqual(found.mode, expected['mode'])
-                self.assertEqual(found.description,
-                                 expected.get('description'))
-                self.assertEqual(found.fields, expected.get('fields'))
-        else:
-            self.assertIsNone(query.schema)
-
-    def _verifyRows(self, query, resource):
-        expected = resource.get('rows')
-        if expected is None:
-            self.assertEqual(query.rows, [])
-        else:
-            found = query.rows
-            self.assertEqual(len(found), len(expected))
-            for f_row, e_row in zip(found, expected):
-                self.assertEqual(f_row,
-                                 tuple([cell['v'] for cell in e_row['f']]))
-
-    def _verifyResourceProperties(self, query, resource):
-        self.assertEqual(query.cache_hit, resource.get('cacheHit'))
-        self.assertEqual(query.complete, resource.get('jobComplete'))
-        self.assertEqual(query.errors, resource.get('errors'))
-        self.assertEqual(query.page_token, resource.get('pageToken'))
-        self.assertEqual(query.total_rows, resource.get('totalRows'))
-        self.assertEqual(query.total_bytes_processed,
-                         resource.get('totalBytesProcessed'))
-
-        if 'jobReference' in resource:
-            self.assertEqual(query.name, resource['jobReference']['jobId'])
-        else:
-            self.assertIsNone(query.name)
-
-        self._verifySchema(query, resource)
-        self._verifyRows(query, resource)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        query = self._makeOne(self.QUERY, client)
-        self.assertEqual(query.query, self.QUERY)
-        self.assertIs(query._client, client)
-
-        self.assertIsNone(query.cache_hit)
-        self.assertIsNone(query.complete)
-        self.assertIsNone(query.errors)
-        self.assertIsNone(query.name)
-        self.assertIsNone(query.page_token)
-        self.assertEqual(query.rows, [])
-        self.assertIsNone(query.schema)
-        self.assertIsNone(query.total_rows)
-        self.assertIsNone(query.total_bytes_processed)
-
-        self.assertIsNone(query.default_dataset)
-        self.assertIsNone(query.max_results)
-        self.assertIsNone(query.preserve_nulls)
-        self.assertIsNone(query.use_query_cache)
-        self.assertIsNone(query.use_legacy_sql)
-
-    def test_from_query_job(self):
-        from google.cloud.bigquery.dataset import Dataset
-        from google.cloud.bigquery.job import QueryJob
-        from google.cloud.bigquery._helpers import UDFResource
-        DS_NAME = 'DATASET'
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        client = _Client(self.PROJECT)
-        job = QueryJob(
-            self.JOB_NAME, self.QUERY, client,
-            udf_resources=[UDFResource("resourceUri", RESOURCE_URI)])
-        dataset = job.default_dataset = Dataset(DS_NAME, client)
-        job.use_query_cache = True
-        job.use_legacy_sql = True
-        klass = self._getTargetClass()
-
-        query = klass.from_query_job(job)
-
-        self.assertEqual(query.name, self.JOB_NAME)
-        self.assertEqual(query.query, self.QUERY)
-        self.assertIs(query._client, client)
-        self.assertIs(query._job, job)
-        self.assertEqual(query.udf_resources, job.udf_resources)
-        self.assertIs(query.default_dataset, dataset)
-        self.assertTrue(query.use_query_cache)
-        self.assertTrue(query.use_legacy_sql)
-
-    def test_from_query_job_wo_default_dataset(self):
-        from google.cloud.bigquery.job import QueryJob
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        client = _Client(self.PROJECT)
-        job = QueryJob(
-            self.JOB_NAME, self.QUERY, client,
-            udf_resources=[UDFResource("resourceUri", RESOURCE_URI)])
-        klass = self._getTargetClass()
-
-        query = klass.from_query_job(job)
-
-        self.assertEqual(query.query, self.QUERY)
-        self.assertIs(query._client, client)
-        self.assertIs(query._job, job)
-        self.assertEqual(query.udf_resources, job.udf_resources)
-        self.assertIsNone(query.default_dataset)
-        self.assertIsNone(query.use_query_cache)
-        self.assertIsNone(query.use_legacy_sql)
-
-    def test_job_wo_jobid(self):
-        client = _Client(self.PROJECT)
-        query = self._makeOne(self.QUERY, client)
-        self.assertIsNone(query.job)
-
-    def test_job_w_jobid(self):
-        from google.cloud.bigquery.job import QueryJob
-        SERVER_GENERATED = 'SERVER_GENERATED'
-        client = _Client(self.PROJECT)
-        query = self._makeOne(self.QUERY, client)
-        query._properties['jobReference'] = {
-            'projectId': self.PROJECT,
-            'jobId': SERVER_GENERATED,
-        }
-        job = query.job
-        self.assertIsInstance(job, QueryJob)
-        self.assertEqual(job.query, self.QUERY)
-        self.assertIs(job._client, client)
-        self.assertEqual(job.name, SERVER_GENERATED)
-        fetched_later = query.job
-        self.assertIs(fetched_later, job)
-
-    def test_schema(self):
-        client = _Client(self.PROJECT)
-        query = self._makeOne(self.QUERY, client)
-        self._verifyResourceProperties(query, {})
-        resource = {
-            'schema': {
-                'fields': [
-                    {'name': 'full_name', 'type': 'STRING', 'mode': 'REQURED'},
-                    {'name': 'age', 'type': 'INTEGER', 'mode': 'REQURED'},
-                ],
-            },
-        }
-        query._set_properties(resource)
-        self._verifyResourceProperties(query, resource)
-
-    def test_run_w_already_has_job(self):
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        query._job = object()  # simulate already running
-        with self.assertRaises(ValueError):
-            query.run()
-
-    def test_run_w_bound_client(self):
-        PATH = 'projects/%s/queries' % self.PROJECT
-        RESOURCE = self._makeResource(complete=False)
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        self.assertEqual(query.udf_resources, [])
-        query.run()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {'query': self.QUERY}
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(query, RESOURCE)
-
-    def test_run_w_alternate_client(self):
-        PATH = 'projects/%s/queries' % self.PROJECT
-        RESOURCE = self._makeResource(complete=True)
-        DATASET = 'test_dataset'
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        query = self._makeOne(self.QUERY, client1)
-
-        query.default_dataset = client2.dataset(DATASET)
-        query.max_results = 100
-        query.preserve_nulls = True
-        query.timeout_ms = 20000
-        query.use_query_cache = False
-        query.use_legacy_sql = True
-        query.dry_run = True
-
-        query.run(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'query': self.QUERY,
-            'defaultDataset': {
-                'projectId': self.PROJECT,
-                'datasetId': DATASET,
-            },
-            'dryRun': True,
-            'maxResults': 100,
-            'preserveNulls': True,
-            'timeoutMs': 20000,
-            'useQueryCache': False,
-            'useLegacySql': True,
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(query, RESOURCE)
-
-    def test_run_w_inline_udf(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        INLINE_UDF_CODE = 'var someCode = "here";'
-        PATH = 'projects/%s/queries' % self.PROJECT
-        RESOURCE = self._makeResource(complete=False)
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        query.udf_resources = [UDFResource("inlineCode", INLINE_UDF_CODE)]
-
-        query.run()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {'query': self.QUERY,
-                'userDefinedFunctionResources':
-                [{'inlineCode': INLINE_UDF_CODE}]}
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(query, RESOURCE)
-
-    def test_run_w_udf_resource_uri(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        PATH = 'projects/%s/queries' % self.PROJECT
-        RESOURCE = self._makeResource(complete=False)
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        query.udf_resources = [UDFResource("resourceUri", RESOURCE_URI)]
-
-        query.run()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {'query': self.QUERY,
-                'userDefinedFunctionResources':
-                [{'resourceUri': RESOURCE_URI}]}
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(query, RESOURCE)
-
-    def test_run_w_mixed_udfs(self):
-        from google.cloud.bigquery._helpers import UDFResource
-        RESOURCE_URI = 'gs://some-bucket/js/lib.js'
-        INLINE_UDF_CODE = 'var someCode = "here";'
-        PATH = 'projects/%s/queries' % self.PROJECT
-        RESOURCE = self._makeResource(complete=False)
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        query.udf_resources = [UDFResource("resourceUri", RESOURCE_URI),
-                               UDFResource("inlineCode", INLINE_UDF_CODE)]
-
-        query.run()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(query.udf_resources,
-                         [UDFResource("resourceUri", RESOURCE_URI),
-                          UDFResource("inlineCode", INLINE_UDF_CODE)])
-        SENT = {'query': self.QUERY,
-                'userDefinedFunctionResources': [
-                    {'resourceUri': RESOURCE_URI},
-                    {"inlineCode": INLINE_UDF_CODE}]}
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(query, RESOURCE)
-
-    def test_fetch_data_query_not_yet_run(self):
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        self.assertRaises(ValueError, query.fetch_data)
-
-    def test_fetch_data_w_bound_client(self):
-        PATH = 'projects/%s/queries/%s' % (self.PROJECT, self.JOB_NAME)
-        BEFORE = self._makeResource(complete=False)
-        AFTER = self._makeResource(complete=True)
-        del AFTER['totalRows']
-
-        conn = _Connection(AFTER)
-        client = _Client(project=self.PROJECT, connection=conn)
-        query = self._makeOne(self.QUERY, client)
-        query._set_properties(BEFORE)
-        self.assertFalse(query.complete)
-
-        rows, total_rows, page_token = query.fetch_data()
-
-        self.assertTrue(query.complete)
-        self.assertEqual(len(rows), 4)
-        self.assertEqual(rows[0], ('Phred Phlyntstone', 32))
-        self.assertEqual(rows[1], ('Bharney Rhubble', 33))
-        self.assertEqual(rows[2], ('Wylma Phlyntstone', 29))
-        self.assertEqual(rows[3], ('Bhettye Rhubble', 27))
-        self.assertIsNone(total_rows)
-        self.assertEqual(page_token, AFTER['pageToken'])
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_fetch_data_w_alternate_client(self):
-        PATH = 'projects/%s/queries/%s' % (self.PROJECT, self.JOB_NAME)
-        MAX = 10
-        TOKEN = 'TOKEN'
-        START = 2257
-        TIMEOUT = 20000
-        BEFORE = self._makeResource(complete=False)
-        AFTER = self._makeResource(complete=True)
-
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(AFTER)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        query = self._makeOne(self.QUERY, client1)
-        query._set_properties(BEFORE)
-        self.assertFalse(query.complete)
-
-        rows, total_rows, page_token = query.fetch_data(
-            client=client2, max_results=MAX, page_token=TOKEN,
-            start_index=START, timeout_ms=TIMEOUT)
-
-        self.assertTrue(query.complete)
-        self.assertEqual(len(rows), 4)
-        self.assertEqual(rows[0], ('Phred Phlyntstone', 32))
-        self.assertEqual(rows[1], ('Bharney Rhubble', 33))
-        self.assertEqual(rows[2], ('Wylma Phlyntstone', 29))
-        self.assertEqual(rows[3], ('Bhettye Rhubble', 27))
-        self.assertEqual(total_rows, int(AFTER['totalRows']))
-        self.assertEqual(page_token, AFTER['pageToken'])
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': MAX,
-                          'pageToken': TOKEN,
-                          'startIndex': START,
-                          'timeoutMs': TIMEOUT})
-
-
-class _Client(object):
-
-    def __init__(self, project='project', connection=None):
-        self.project = project
-        self.connection = connection
-
-    def dataset(self, name):
-        from google.cloud.bigquery.dataset import Dataset
-        return Dataset(name, client=self)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/bigquery/test_schema.py b/unit_tests/bigquery/test_schema.py
deleted file mode 100644
index 0226de79a439..000000000000
--- a/unit_tests/bigquery/test_schema.py
+++ /dev/null
@@ -1,110 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestSchemaField(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.schema import SchemaField
-        return SchemaField
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        field = self._makeOne('test', 'STRING')
-        self.assertEqual(field.name, 'test')
-        self.assertEqual(field.field_type, 'STRING')
-        self.assertEqual(field.mode, 'NULLABLE')
-        self.assertIsNone(field.description)
-        self.assertIsNone(field.fields)
-
-    def test_ctor_explicit(self):
-        field = self._makeOne('test', 'STRING', mode='REQUIRED',
-                              description='Testing')
-        self.assertEqual(field.name, 'test')
-        self.assertEqual(field.field_type, 'STRING')
-        self.assertEqual(field.mode, 'REQUIRED')
-        self.assertEqual(field.description, 'Testing')
-        self.assertIsNone(field.fields)
-
-    def test_ctor_subfields(self):
-        field = self._makeOne('phone_number', 'RECORD',
-                              fields=[self._makeOne('area_code', 'STRING'),
-                                      self._makeOne('local_number', 'STRING')])
-        self.assertEqual(field.name, 'phone_number')
-        self.assertEqual(field.field_type, 'RECORD')
-        self.assertEqual(field.mode, 'NULLABLE')
-        self.assertIsNone(field.description)
-        self.assertEqual(len(field.fields), 2)
-        self.assertEqual(field.fields[0].name, 'area_code')
-        self.assertEqual(field.fields[0].field_type, 'STRING')
-        self.assertEqual(field.fields[0].mode, 'NULLABLE')
-        self.assertIsNone(field.fields[0].description)
-        self.assertIsNone(field.fields[0].fields)
-        self.assertEqual(field.fields[1].name, 'local_number')
-        self.assertEqual(field.fields[1].field_type, 'STRING')
-        self.assertEqual(field.fields[1].mode, 'NULLABLE')
-        self.assertIsNone(field.fields[1].description)
-        self.assertIsNone(field.fields[1].fields)
-
-    def test___eq___name_mismatch(self):
-        field = self._makeOne('test', 'STRING')
-        other = self._makeOne('other', 'STRING')
-        self.assertNotEqual(field, other)
-
-    def test___eq___field_type_mismatch(self):
-        field = self._makeOne('test', 'STRING')
-        other = self._makeOne('test', 'INTEGER')
-        self.assertNotEqual(field, other)
-
-    def test___eq___mode_mismatch(self):
-        field = self._makeOne('test', 'STRING', mode='REQUIRED')
-        other = self._makeOne('test', 'STRING', mode='NULLABLE')
-        self.assertNotEqual(field, other)
-
-    def test___eq___description_mismatch(self):
-        field = self._makeOne('test', 'STRING', description='Testing')
-        other = self._makeOne('test', 'STRING', description='Other')
-        self.assertNotEqual(field, other)
-
-    def test___eq___fields_mismatch(self):
-        sub1 = self._makeOne('sub1', 'STRING')
-        sub2 = self._makeOne('sub2', 'STRING')
-        field = self._makeOne('test', 'RECORD', fields=[sub1])
-        other = self._makeOne('test', 'RECORD', fields=[sub2])
-        self.assertNotEqual(field, other)
-
-    def test___eq___hit(self):
-        field = self._makeOne('test', 'STRING', mode='REQUIRED',
-                              description='Testing')
-        other = self._makeOne('test', 'STRING', mode='REQUIRED',
-                              description='Testing')
-        self.assertEqual(field, other)
-
-    def test___eq___hit_case_diff_on_type(self):
-        field = self._makeOne('test', 'STRING', mode='REQUIRED',
-                              description='Testing')
-        other = self._makeOne('test', 'string', mode='REQUIRED',
-                              description='Testing')
-        self.assertEqual(field, other)
-
-    def test___eq___hit_w_fields(self):
-        sub1 = self._makeOne('sub1', 'STRING')
-        sub2 = self._makeOne('sub2', 'STRING')
-        field = self._makeOne('test', 'RECORD', fields=[sub1, sub2])
-        other = self._makeOne('test', 'RECORD', fields=[sub1, sub2])
-        self.assertEqual(field, other)
diff --git a/unit_tests/bigquery/test_table.py b/unit_tests/bigquery/test_table.py
deleted file mode 100644
index 751c2f03852b..000000000000
--- a/unit_tests/bigquery/test_table.py
+++ /dev/null
@@ -1,1942 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class _SchemaBase(object):
-
-    def _verify_field(self, field, r_field):
-        self.assertEqual(field.name, r_field['name'])
-        self.assertEqual(field.field_type, r_field['type'])
-        self.assertEqual(field.mode, r_field.get('mode', 'NULLABLE'))
-
-    def _verifySchema(self, schema, resource):
-        r_fields = resource['schema']['fields']
-        self.assertEqual(len(schema), len(r_fields))
-
-        for field, r_field in zip(schema, r_fields):
-            self._verify_field(field, r_field)
-
-
-class TestTable(unittest.TestCase, _SchemaBase):
-    PROJECT = 'project'
-    DS_NAME = 'dataset-name'
-    TABLE_NAME = 'table-name'
-
-    def _getTargetClass(self):
-        from google.cloud.bigquery.table import Table
-        return Table
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _setUpConstants(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        self.WHEN_TS = 1437767599.006
-        self.WHEN = datetime.datetime.utcfromtimestamp(self.WHEN_TS).replace(
-            tzinfo=UTC)
-        self.ETAG = 'ETAG'
-        self.TABLE_ID = '%s:%s:%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        self.RESOURCE_URL = 'http://example.com/path/to/resource'
-        self.NUM_BYTES = 12345
-        self.NUM_ROWS = 67
-
-    def _makeResource(self):
-        self._setUpConstants()
-        return {
-            'creationTime': self.WHEN_TS * 1000,
-            'tableReference':
-                {'projectId': self.PROJECT,
-                 'datasetId': self.DS_NAME,
-                 'tableId': self.TABLE_NAME},
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'}]},
-            'etag': 'ETAG',
-            'id': self.TABLE_ID,
-            'lastModifiedTime': self.WHEN_TS * 1000,
-            'location': 'US',
-            'selfLink': self.RESOURCE_URL,
-            'numRows': self.NUM_ROWS,
-            'numBytes': self.NUM_BYTES,
-            'type': 'TABLE',
-        }
-
-    def _verifyReadonlyResourceProperties(self, table, resource):
-        if 'creationTime' in resource:
-            self.assertEqual(table.created, self.WHEN)
-        else:
-            self.assertIsNone(table.created)
-
-        if 'etag' in resource:
-            self.assertEqual(table.etag, self.ETAG)
-        else:
-            self.assertIsNone(table.etag)
-
-        if 'numRows' in resource:
-            self.assertEqual(table.num_rows, self.NUM_ROWS)
-        else:
-            self.assertIsNone(table.num_rows)
-
-        if 'numBytes' in resource:
-            self.assertEqual(table.num_bytes, self.NUM_BYTES)
-        else:
-            self.assertIsNone(table.num_bytes)
-
-        if 'selfLink' in resource:
-            self.assertEqual(table.self_link, self.RESOURCE_URL)
-        else:
-            self.assertIsNone(table.self_link)
-
-        self.assertEqual(table.table_id, self.TABLE_ID)
-        self.assertEqual(table.table_type,
-                         'TABLE' if 'view' not in resource else 'VIEW')
-
-    def _verifyResourceProperties(self, table, resource):
-
-        self._verifyReadonlyResourceProperties(table, resource)
-
-        if 'expirationTime' in resource:
-            self.assertEqual(table.expires, self.EXP_TIME)
-        else:
-            self.assertIsNone(table.expires)
-
-        self.assertEqual(table.description, resource.get('description'))
-        self.assertEqual(table.friendly_name, resource.get('friendlyName'))
-        self.assertEqual(table.location, resource.get('location'))
-
-        if 'view' in resource:
-            self.assertEqual(table.view_query, resource['view']['query'])
-        else:
-            self.assertIsNone(table.view_query)
-
-        if 'schema' in resource:
-            self._verifySchema(table.schema, resource)
-        else:
-            self.assertEqual(table.schema, [])
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        self.assertEqual(table.name, self.TABLE_NAME)
-        self.assertIs(table._dataset, dataset)
-        self.assertEqual(table.project, self.PROJECT)
-        self.assertEqual(table.dataset_name, self.DS_NAME)
-        self.assertEqual(
-            table.path,
-            '/projects/%s/datasets/%s/tables/%s' % (
-                self.PROJECT, self.DS_NAME, self.TABLE_NAME))
-        self.assertEqual(table.schema, [])
-
-        self.assertIsNone(table.created)
-        self.assertIsNone(table.etag)
-        self.assertIsNone(table.modified)
-        self.assertIsNone(table.num_bytes)
-        self.assertIsNone(table.num_rows)
-        self.assertIsNone(table.self_link)
-        self.assertIsNone(table.table_id)
-        self.assertIsNone(table.table_type)
-
-        self.assertIsNone(table.description)
-        self.assertIsNone(table.expires)
-        self.assertIsNone(table.friendly_name)
-        self.assertIsNone(table.location)
-        self.assertIsNone(table.view_query)
-
-    def test_ctor_w_schema(self):
-        from google.cloud.bigquery.table import SchemaField
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertEqual(table.schema, [full_name, age])
-
-    def test_num_bytes_getter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-
-        # Check with no value set.
-        self.assertIsNone(table.num_bytes)
-
-        num_bytes = 1337
-        # Check with integer value set.
-        table._properties = {'numBytes': num_bytes}
-        self.assertEqual(table.num_bytes, num_bytes)
-
-        # Check with a string value set.
-        table._properties = {'numBytes': str(num_bytes)}
-        self.assertEqual(table.num_bytes, num_bytes)
-
-        # Check with invalid int value.
-        table._properties = {'numBytes': 'x'}
-        with self.assertRaises(ValueError):
-            getattr(table, 'num_bytes')
-
-    def test_num_rows_getter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-
-        # Check with no value set.
-        self.assertIsNone(table.num_rows)
-
-        num_rows = 42
-        # Check with integer value set.
-        table._properties = {'numRows': num_rows}
-        self.assertEqual(table.num_rows, num_rows)
-
-        # Check with a string value set.
-        table._properties = {'numRows': str(num_rows)}
-        self.assertEqual(table.num_rows, num_rows)
-
-        # Check with invalid int value.
-        table._properties = {'numRows': 'x'}
-        with self.assertRaises(ValueError):
-            getattr(table, 'num_rows')
-
-    def test_schema_setter_non_list(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        with self.assertRaises(TypeError):
-            table.schema = object()
-
-    def test_schema_setter_invalid_field(self):
-        from google.cloud.bigquery.table import SchemaField
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        with self.assertRaises(ValueError):
-            table.schema = [full_name, object()]
-
-    def test_schema_setter(self):
-        from google.cloud.bigquery.table import SchemaField
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table.schema = [full_name, age]
-        self.assertEqual(table.schema, [full_name, age])
-
-    def test_props_set_by_server(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _millis
-
-        CREATED = datetime.datetime(2015, 7, 29, 12, 13, 22, tzinfo=UTC)
-        MODIFIED = datetime.datetime(2015, 7, 29, 14, 47, 15, tzinfo=UTC)
-        TABLE_ID = '%s:%s:%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        URL = 'http://example.com/projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table._properties['creationTime'] = _millis(CREATED)
-        table._properties['etag'] = 'ETAG'
-        table._properties['lastModifiedTime'] = _millis(MODIFIED)
-        table._properties['numBytes'] = 12345
-        table._properties['numRows'] = 66
-        table._properties['selfLink'] = URL
-        table._properties['id'] = TABLE_ID
-        table._properties['type'] = 'TABLE'
-
-        self.assertEqual(table.created, CREATED)
-        self.assertEqual(table.etag, 'ETAG')
-        self.assertEqual(table.modified, MODIFIED)
-        self.assertEqual(table.num_bytes, 12345)
-        self.assertEqual(table.num_rows, 66)
-        self.assertEqual(table.self_link, URL)
-        self.assertEqual(table.table_id, TABLE_ID)
-        self.assertEqual(table.table_type, 'TABLE')
-
-    def test_description_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        with self.assertRaises(ValueError):
-            table.description = 12345
-
-    def test_description_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table.description = 'DESCRIPTION'
-        self.assertEqual(table.description, 'DESCRIPTION')
-
-    def test_expires_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        with self.assertRaises(ValueError):
-            table.expires = object()
-
-    def test_expires_setter(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        WHEN = datetime.datetime(2015, 7, 28, 16, 39, tzinfo=UTC)
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table.expires = WHEN
-        self.assertEqual(table.expires, WHEN)
-
-    def test_friendly_name_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        with self.assertRaises(ValueError):
-            table.friendly_name = 12345
-
-    def test_friendly_name_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table.friendly_name = 'FRIENDLY'
-        self.assertEqual(table.friendly_name, 'FRIENDLY')
-
-    def test_location_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        with self.assertRaises(ValueError):
-            table.location = 12345
-
-    def test_location_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table.location = 'LOCATION'
-        self.assertEqual(table.location, 'LOCATION')
-
-    def test_view_query_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        with self.assertRaises(ValueError):
-            table.view_query = 12345
-
-    def test_view_query_setter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table.view_query = 'select * from foo'
-        self.assertEqual(table.view_query, 'select * from foo')
-
-    def test_view_query_deleter(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-        table.view_query = 'select * from foo'
-        del table.view_query
-        self.assertIsNone(table.view_query)
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, dataset)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        RESOURCE = {
-            'id': '%s:%s:%s' % (self.PROJECT, self.DS_NAME, self.TABLE_NAME),
-            'tableReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME,
-            },
-            'type': 'TABLE',
-        }
-        klass = self._getTargetClass()
-        table = klass.from_api_repr(RESOURCE, dataset)
-        self.assertEqual(table.name, self.TABLE_NAME)
-        self.assertIs(table._dataset, dataset)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        client = _Client(self.PROJECT)
-        dataset = _Dataset(client)
-        RESOURCE = self._makeResource()
-        klass = self._getTargetClass()
-        table = klass.from_api_repr(RESOURCE, dataset)
-        self.assertIs(table._dataset._client, client)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_create_no_view_query_no_schema(self):
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset)
-
-        with self.assertRaises(ValueError):
-            table.create()
-
-    def test_create_w_bound_client(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-
-        table.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'tableReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME},
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'}]},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_create_w_partition_no_expire(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-
-        self.assertIsNone(table.partitioning_type)
-        table.partitioning_type = "DAY"
-        self.assertEqual(table.partitioning_type, "DAY")
-        table.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'tableReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME},
-            'timePartitioning': {'type': 'DAY'},
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'}]},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_create_w_partition_and_expire(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertIsNone(table.partition_expiration)
-        table.partition_expiration = 100
-        self.assertEqual(table.partitioning_type, "DAY")
-        self.assertEqual(table.partition_expiration, 100)
-        table.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'tableReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME},
-            'timePartitioning': {'type': 'DAY', 'expirationMs': 100},
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'}]},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_partition_type_setter_bad_type(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        with self.assertRaises(ValueError):
-            table.partitioning_type = 123
-
-    def test_partition_type_setter_unknown_value(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        with self.assertRaises(ValueError):
-            table.partitioning_type = "HASH"
-
-    def test_partition_type_setter_w_known_value(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertIsNone(table.partitioning_type)
-        table.partitioning_type = 'DAY'
-        self.assertEqual(table.partitioning_type, 'DAY')
-
-    def test_partition_type_setter_w_none(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        table._properties['timePartitioning'] = {'type': 'DAY'}
-        table.partitioning_type = None
-        self.assertIsNone(table.partitioning_type)
-        self.assertFalse('timePartitioning' in table._properties)
-
-    def test_partition_experation_bad_type(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        with self.assertRaises(ValueError):
-            table.partition_expiration = "NEVER"
-
-    def test_partition_expiration_w_integer(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertIsNone(table.partition_expiration)
-        table.partition_expiration = 100
-        self.assertEqual(table.partitioning_type, "DAY")
-        self.assertEqual(table.partition_expiration, 100)
-
-    def test_partition_expiration_w_none(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertIsNone(table.partition_expiration)
-        table._properties['timePartitioning'] = {
-            'type': 'DAY',
-            'expirationMs': 100,
-        }
-        table.partition_expiration = None
-        self.assertEqual(table.partitioning_type, "DAY")
-        self.assertIsNone(table.partition_expiration)
-
-    def test_partition_expiration_w_none_no_partition_set(self):
-        from google.cloud.bigquery.table import SchemaField
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertIsNone(table.partition_expiration)
-        table.partition_expiration = None
-        self.assertIsNone(table.partitioning_type)
-        self.assertIsNone(table.partition_expiration)
-
-    def test_list_partitions(self):
-        from google.cloud.bigquery.table import SchemaField
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        client._query_results = [(20160804, None), (20160805, None)]
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-        self.assertEqual(table.list_partitions(), [20160804, 20160805])
-
-    def test_create_w_alternate_client(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _millis
-        from google.cloud.bigquery.table import SchemaField
-
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        QUERY = 'select fullname, age from person_ages'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        self.EXP_TIME = datetime.datetime(2015, 8, 1, 23, 59, 59,
-                                          tzinfo=UTC)
-        RESOURCE['expirationTime'] = _millis(self.EXP_TIME)
-        RESOURCE['view'] = {}
-        RESOURCE['view']['query'] = QUERY
-        RESOURCE['type'] = 'VIEW'
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client=client1)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age])
-        table.friendly_name = TITLE
-        table.description = DESCRIPTION
-        table.view_query = QUERY
-
-        table.create(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'tableReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME},
-            'description': DESCRIPTION,
-            'friendlyName': TITLE,
-            'view': {'query': QUERY},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_create_w_missing_output_properties(self):
-        # In the wild, the resource returned from 'dataset.create' sometimes
-        # lacks 'creationTime' / 'lastModifiedTime'
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables' % (self.PROJECT, self.DS_NAME)
-        RESOURCE = self._makeResource()
-        del RESOURCE['creationTime']
-        del RESOURCE['lastModifiedTime']
-        self.WHEN = None
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset,
-                              schema=[full_name, age])
-
-        table.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'tableReference': {
-                'projectId': self.PROJECT,
-                'datasetId': self.DS_NAME,
-                'tableId': self.TABLE_NAME},
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'}]},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        self.assertFalse(table.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        self.assertTrue(table.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        table.reload()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        table.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_patch_w_invalid_expiration(self):
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        with self.assertRaises(ValueError):
-            table.patch(expires='BOGUS')
-
-    def test_patch_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        table.patch(description=DESCRIPTION,
-                    friendly_name=TITLE,
-                    view_query=None)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'PATCH')
-        SENT = {
-            'description': DESCRIPTION,
-            'friendlyName': TITLE,
-            'view': None,
-        }
-        self.assertEqual(req['data'], SENT)
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_patch_w_alternate_client(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _millis
-        from google.cloud.bigquery.table import SchemaField
-
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        QUERY = 'select fullname, age from person_ages'
-        LOCATION = 'EU'
-        RESOURCE = self._makeResource()
-        RESOURCE['view'] = {'query': QUERY}
-        RESOURCE['type'] = 'VIEW'
-        RESOURCE['location'] = LOCATION
-        self.EXP_TIME = datetime.datetime(2015, 8, 1, 23, 59, 59,
-                                          tzinfo=UTC)
-        RESOURCE['expirationTime'] = _millis(self.EXP_TIME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='NULLABLE')
-
-        table.patch(client=client2, view_query=QUERY, location=LOCATION,
-                    expires=self.EXP_TIME, schema=[full_name, age])
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'PATCH')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'view': {'query': QUERY},
-            'location': LOCATION,
-            'expirationTime': _millis(self.EXP_TIME),
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'NULLABLE'}]},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_patch_w_schema_None(self):
-        # Simulate deleting schema:  not sure if back-end will actually
-        # allow this operation, but the spec says it is optional.
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        table.patch(schema=None)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'PATCH')
-        SENT = {'schema': None}
-        self.assertEqual(req['data'], SENT)
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_update_w_bound_client(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        TITLE = 'TITLE'
-        RESOURCE = self._makeResource()
-        RESOURCE['description'] = DESCRIPTION
-        RESOURCE['friendlyName'] = TITLE
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age])
-        table.description = DESCRIPTION
-        table.friendly_name = TITLE
-
-        table.update()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'PUT')
-        SENT = {
-            'tableReference':
-                {'projectId': self.PROJECT,
-                 'datasetId': self.DS_NAME,
-                 'tableId': self.TABLE_NAME},
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'}]},
-            'description': DESCRIPTION,
-            'friendlyName': TITLE,
-        }
-        self.assertEqual(req['data'], SENT)
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_update_w_alternate_client(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _millis
-
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        DEF_TABLE_EXP = 12345
-        LOCATION = 'EU'
-        QUERY = 'select fullname, age from person_ages'
-        RESOURCE = self._makeResource()
-        RESOURCE['defaultTableExpirationMs'] = 12345
-        RESOURCE['location'] = LOCATION
-        self.EXP_TIME = datetime.datetime(2015, 8, 1, 23, 59, 59,
-                                          tzinfo=UTC)
-        RESOURCE['expirationTime'] = _millis(self.EXP_TIME)
-        RESOURCE['view'] = {'query': QUERY}
-        RESOURCE['type'] = 'VIEW'
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-        table.default_table_expiration_ms = DEF_TABLE_EXP
-        table.location = LOCATION
-        table.expires = self.EXP_TIME
-        table.view_query = QUERY
-
-        table.update(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'PUT')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'tableReference':
-                {'projectId': self.PROJECT,
-                 'datasetId': self.DS_NAME,
-                 'tableId': self.TABLE_NAME},
-            'expirationTime': _millis(self.EXP_TIME),
-            'location': 'EU',
-            'view': {'query': QUERY},
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(table, RESOURCE)
-
-    def test_delete_w_bound_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        table.delete()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'DELETE')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_delete_w_alternate_client(self):
-        PATH = 'projects/%s/datasets/%s/tables/%s' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        table.delete(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'DELETE')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_fetch_data_w_bound_client(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud.bigquery.table import SchemaField
-
-        PATH = 'projects/%s/datasets/%s/tables/%s/data' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        WHEN_TS = 1437767599.006
-        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(
-            tzinfo=UTC)
-        WHEN_1 = WHEN + datetime.timedelta(seconds=1)
-        WHEN_2 = WHEN + datetime.timedelta(seconds=2)
-        ROWS = 1234
-        TOKEN = 'TOKEN'
-
-        def _bigquery_timestamp_float_repr(ts_float):
-            # Preserve microsecond precision for E+09 timestamps
-            return '%0.15E' % (ts_float,)
-
-        DATA = {
-            'totalRows': str(ROWS),
-            'pageToken': TOKEN,
-            'rows': [
-                {'f': [
-                    {'v': 'Phred Phlyntstone'},
-                    {'v': '32'},
-                    {'v': _bigquery_timestamp_float_repr(WHEN_TS)},
-                ]},
-                {'f': [
-                    {'v': 'Bharney Rhubble'},
-                    {'v': '33'},
-                    {'v': _bigquery_timestamp_float_repr(WHEN_TS + 1)},
-                ]},
-                {'f': [
-                    {'v': 'Wylma Phlyntstone'},
-                    {'v': '29'},
-                    {'v': _bigquery_timestamp_float_repr(WHEN_TS + 2)},
-                ]},
-                {'f': [
-                    {'v': 'Bhettye Rhubble'},
-                    {'v': None},
-                    {'v': None},
-                ]},
-            ]
-        }
-
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='NULLABLE')
-        joined = SchemaField('joined', 'TIMESTAMP', mode='NULLABLE')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age, joined])
-
-        rows, total_rows, page_token = table.fetch_data()
-
-        self.assertEqual(len(rows), 4)
-        self.assertEqual(rows[0], ('Phred Phlyntstone', 32, WHEN))
-        self.assertEqual(rows[1], ('Bharney Rhubble', 33, WHEN_1))
-        self.assertEqual(rows[2], ('Wylma Phlyntstone', 29, WHEN_2))
-        self.assertEqual(rows[3], ('Bhettye Rhubble', None, None))
-        self.assertEqual(total_rows, ROWS)
-        self.assertEqual(page_token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_fetch_data_w_alternate_client(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s/data' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        MAX = 10
-        TOKEN = 'TOKEN'
-        DATA = {
-            'rows': [
-                {'f': [
-                    {'v': 'Phred Phlyntstone'},
-                    {'v': '32'},
-                    {'v': 'true'},
-                    {'v': '3.1415926'},
-                ]},
-                {'f': [
-                    {'v': 'Bharney Rhubble'},
-                    {'v': '33'},
-                    {'v': 'false'},
-                    {'v': '1.414'},
-                ]},
-                {'f': [
-                    {'v': 'Wylma Phlyntstone'},
-                    {'v': '29'},
-                    {'v': 'true'},
-                    {'v': '2.71828'},
-                ]},
-                {'f': [
-                    {'v': 'Bhettye Rhubble'},
-                    {'v': '27'},
-                    {'v': None},
-                    {'v': None},
-                ]},
-            ]
-        }
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(DATA)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        voter = SchemaField('voter', 'BOOLEAN', mode='NULLABLE')
-        score = SchemaField('score', 'FLOAT', mode='NULLABLE')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age, voter, score])
-
-        rows, total_rows, page_token = table.fetch_data(client=client2,
-                                                        max_results=MAX,
-                                                        page_token=TOKEN)
-
-        self.assertEqual(len(rows), 4)
-        self.assertEqual(rows[0], ('Phred Phlyntstone', 32, True, 3.1415926))
-        self.assertEqual(rows[1], ('Bharney Rhubble', 33, False, 1.414))
-        self.assertEqual(rows[2], ('Wylma Phlyntstone', 29, True, 2.71828))
-        self.assertEqual(rows[3], ('Bhettye Rhubble', 27, None, None))
-        self.assertIsNone(total_rows)
-        self.assertIsNone(page_token)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': MAX, 'pageToken': TOKEN})
-
-    def test_fetch_data_w_repeated_fields(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s/data' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        ROWS = 1234
-        TOKEN = 'TOKEN'
-        DATA = {
-            'totalRows': ROWS,
-            'pageToken': TOKEN,
-            'rows': [
-                {'f': [
-                    {'v': ['red', 'green']},
-                    {'v': [{'f': [{'v': ['1', '2']},
-                                  {'v': ['3.1415', '1.414']}]}]},
-                ]},
-            ]
-        }
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('color', 'STRING', mode='REPEATED')
-        index = SchemaField('index', 'INTEGER', 'REPEATED')
-        score = SchemaField('score', 'FLOAT', 'REPEATED')
-        struct = SchemaField('struct', 'RECORD', mode='REPEATED',
-                             fields=[index, score])
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, struct])
-
-        rows, total_rows, page_token = table.fetch_data()
-
-        self.assertEqual(len(rows), 1)
-        self.assertEqual(rows[0][0], ['red', 'green'])
-        self.assertEqual(rows[0][1], [{'index': [1, 2],
-                                       'score': [3.1415, 1.414]}])
-        self.assertEqual(total_rows, ROWS)
-        self.assertEqual(page_token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_fetch_data_w_record_schema(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s/data' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        ROWS = 1234
-        TOKEN = 'TOKEN'
-        DATA = {
-            'totalRows': ROWS,
-            'pageToken': TOKEN,
-            'rows': [
-                {'f': [
-                    {'v': 'Phred Phlyntstone'},
-                    {'v': {'f': [{'v': '800'}, {'v': '555-1212'}, {'v': 1}]}},
-                ]},
-                {'f': [
-                    {'v': 'Bharney Rhubble'},
-                    {'v': {'f': [{'v': '877'}, {'v': '768-5309'}, {'v': 2}]}},
-                ]},
-                {'f': [
-                    {'v': 'Wylma Phlyntstone'},
-                    {'v': None},
-                ]},
-            ]
-        }
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        area_code = SchemaField('area_code', 'STRING', 'REQUIRED')
-        local_number = SchemaField('local_number', 'STRING', 'REQUIRED')
-        rank = SchemaField('rank', 'INTEGER', 'REQUIRED')
-        phone = SchemaField('phone', 'RECORD', mode='NULLABLE',
-                            fields=[area_code, local_number, rank])
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, phone])
-
-        rows, total_rows, page_token = table.fetch_data()
-
-        self.assertEqual(len(rows), 3)
-        self.assertEqual(rows[0][0], 'Phred Phlyntstone')
-        self.assertEqual(rows[0][1], {'area_code': '800',
-                                      'local_number': '555-1212',
-                                      'rank': 1})
-        self.assertEqual(rows[1][0], 'Bharney Rhubble')
-        self.assertEqual(rows[1][1], {'area_code': '877',
-                                      'local_number': '768-5309',
-                                      'rank': 2})
-        self.assertEqual(rows[2][0], 'Wylma Phlyntstone')
-        self.assertIsNone(rows[2][1])
-        self.assertEqual(total_rows, ROWS)
-        self.assertEqual(page_token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_insert_data_w_bound_client(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _microseconds_from_datetime
-        from google.cloud.bigquery.table import SchemaField
-
-        WHEN_TS = 1437767599.006
-        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(
-            tzinfo=UTC)
-        PATH = 'projects/%s/datasets/%s/tables/%s/insertAll' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        joined = SchemaField('joined', 'TIMESTAMP', mode='NULLABLE')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age, joined])
-        ROWS = [
-            ('Phred Phlyntstone', 32, WHEN),
-            ('Bharney Rhubble', 33, WHEN + datetime.timedelta(seconds=1)),
-            ('Wylma Phlyntstone', 29, WHEN + datetime.timedelta(seconds=2)),
-            ('Bhettye Rhubble', 27, None),
-        ]
-
-        def _row_data(row):
-            joined = None
-            if row[2] is not None:
-                joined = _microseconds_from_datetime(row[2]) * 1e-6
-            return {'full_name': row[0],
-                    'age': row[1],
-                    'joined': joined}
-
-        SENT = {
-            'rows': [{'json': _row_data(row)} for row in ROWS],
-        }
-
-        errors = table.insert_data(ROWS)
-
-        self.assertEqual(len(errors), 0)
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['data'], SENT)
-
-    def test_insert_data_w_alternate_client(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s/insertAll' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        RESPONSE = {
-            'insertErrors': [
-                {'index': 1,
-                 'errors': [
-                     {'reason': 'REASON',
-                      'location': 'LOCATION',
-                      'debugInfo': 'INFO',
-                      'message': 'MESSAGE'}
-                 ]},
-            ]}
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESPONSE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        dataset = _Dataset(client1)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        voter = SchemaField('voter', 'BOOLEAN', mode='NULLABLE')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age, voter])
-        ROWS = [
-            ('Phred Phlyntstone', 32, True),
-            ('Bharney Rhubble', 33, False),
-            ('Wylma Phlyntstone', 29, True),
-            ('Bhettye Rhubble', 27, True),
-        ]
-
-        def _row_data(row):
-            return {'full_name': row[0], 'age': row[1], 'voter': row[2]}
-
-        SENT = {
-            'skipInvalidRows': True,
-            'ignoreUnknownValues': True,
-            'templateSuffix': '20160303',
-            'rows': [{'insertId': index, 'json': _row_data(row)}
-                     for index, row in enumerate(ROWS)],
-        }
-
-        errors = table.insert_data(
-            client=client2,
-            rows=ROWS,
-            row_ids=[index for index, _ in enumerate(ROWS)],
-            skip_invalid_rows=True,
-            ignore_unknown_values=True,
-            template_suffix='20160303',
-        )
-
-        self.assertEqual(len(errors), 1)
-        self.assertEqual(errors[0]['index'], 1)
-        self.assertEqual(len(errors[0]['errors']), 1)
-        self.assertEqual(errors[0]['errors'][0],
-                         RESPONSE['insertErrors'][0]['errors'][0])
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['data'], SENT)
-
-    def test_insert_data_w_repeated_fields(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s/insertAll' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('color', 'STRING', mode='REPEATED')
-        index = SchemaField('index', 'INTEGER', 'REPEATED')
-        score = SchemaField('score', 'FLOAT', 'REPEATED')
-        struct = SchemaField('struct', 'RECORD', mode='REPEATED',
-                             fields=[index, score])
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, struct])
-        ROWS = [
-            (['red', 'green'], [{'index': [1, 2], 'score': [3.1415, 1.414]}]),
-        ]
-
-        def _row_data(row):
-            return {'color': row[0],
-                    'struct': row[1]}
-
-        SENT = {
-            'rows': [{'json': _row_data(row)} for row in ROWS],
-        }
-
-        errors = table.insert_data(ROWS)
-
-        self.assertEqual(len(errors), 0)
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['data'], SENT)
-
-    def test_insert_data_w_record_schema(self):
-        from google.cloud.bigquery.table import SchemaField
-        PATH = 'projects/%s/datasets/%s/tables/%s/insertAll' % (
-            self.PROJECT, self.DS_NAME, self.TABLE_NAME)
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        area_code = SchemaField('area_code', 'STRING', 'REQUIRED')
-        local_number = SchemaField('local_number', 'STRING', 'REQUIRED')
-        rank = SchemaField('rank', 'INTEGER', 'REQUIRED')
-        phone = SchemaField('phone', 'RECORD', mode='NULLABLE',
-                            fields=[area_code, local_number, rank])
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, phone])
-        ROWS = [
-            ('Phred Phlyntstone', {'area_code': '800',
-                                   'local_number': '555-1212',
-                                   'rank': 1}),
-            ('Bharney Rhubble', {'area_code': '877',
-                                 'local_number': '768-5309',
-                                 'rank': 2}),
-            ('Wylma Phlyntstone', None),
-        ]
-
-        def _row_data(row):
-            return {'full_name': row[0],
-                    'phone': row[1]}
-
-        SENT = {
-            'rows': [{'json': _row_data(row)} for row in ROWS],
-        }
-
-        errors = table.insert_data(ROWS)
-
-        self.assertEqual(len(errors), 0)
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['data'], SENT)
-
-    def test_upload_from_file_text_mode_file_failure(self):
-
-        class TextModeFile(object):
-            mode = 'r'
-
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        file_obj = TextModeFile()
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-        with self.assertRaises(ValueError):
-            table.upload_from_file(file_obj, 'CSV', size=1234)
-
-    def test_upload_from_file_binary_mode_no_failure(self):
-        self._upload_from_file_helper(input_file_mode='r+b')
-
-    def test_upload_from_file_size_failure(self):
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        file_obj = object()
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-        with self.assertRaises(ValueError):
-            table.upload_from_file(file_obj, 'CSV', size=None)
-
-    def test_upload_from_file_multipart_w_400(self):
-        import csv
-        import datetime
-        from six.moves.http_client import BAD_REQUEST
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud._helpers import UTC
-        from google.cloud.exceptions import BadRequest
-        WHEN_TS = 1437767599.006
-        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(
-            tzinfo=UTC)
-        response = {'status': BAD_REQUEST}
-        conn = _Connection(
-            (response, b'{}'),
-        )
-        client = _Client(project=self.PROJECT, connection=conn)
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        with _NamedTemporaryFile() as temp:
-            with open(temp.name, 'w') as file_obj:
-                writer = csv.writer(file_obj)
-                writer.writerow(('full_name', 'age', 'joined'))
-                writer.writerow(('Phred Phlyntstone', 32, WHEN))
-
-            with open(temp.name, 'rb') as file_obj:
-                with self.assertRaises(BadRequest):
-                    table.upload_from_file(
-                        file_obj, 'CSV', rewind=True)
-
-    def _upload_from_file_helper(self, **kw):
-        import csv
-        import datetime
-        from six.moves.http_client import OK
-        from google.cloud._helpers import UTC
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud.bigquery.table import SchemaField
-
-        WHEN_TS = 1437767599.006
-        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(
-            tzinfo=UTC)
-        PATH = 'projects/%s/jobs' % (self.PROJECT,)
-        response = {'status': OK}
-        conn = _Connection(
-            (response, b'{}'),
-        )
-        client = _Client(project=self.PROJECT, connection=conn)
-        expected_job = object()
-        if 'client' in kw:
-            kw['client']._job = expected_job
-        else:
-            client._job = expected_job
-        input_file_mode = kw.pop('input_file_mode', 'rb')
-        dataset = _Dataset(client)
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        joined = SchemaField('joined', 'TIMESTAMP', mode='NULLABLE')
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset,
-                              schema=[full_name, age, joined])
-        ROWS = [
-            ('Phred Phlyntstone', 32, WHEN),
-            ('Bharney Rhubble', 33, WHEN + datetime.timedelta(seconds=1)),
-            ('Wylma Phlyntstone', 29, WHEN + datetime.timedelta(seconds=2)),
-            ('Bhettye Rhubble', 27, None),
-        ]
-
-        with _NamedTemporaryFile() as temp:
-            with open(temp.name, 'w') as file_obj:
-                writer = csv.writer(file_obj)
-                writer.writerow(('full_name', 'age', 'joined'))
-                writer.writerows(ROWS)
-
-            with open(temp.name, input_file_mode) as file_obj:
-                BODY = file_obj.read()
-                explicit_size = kw.pop('_explicit_size', False)
-                if explicit_size:
-                    kw['size'] = len(BODY)
-                job = table.upload_from_file(
-                    file_obj, 'CSV', rewind=True, **kw)
-
-        self.assertIs(job, expected_job)
-        return conn.http._requested, PATH, BODY
-
-    def test_upload_from_file_w_bound_client_multipart(self):
-        import json
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from google.cloud._helpers import _to_bytes
-
-        requested, PATH, BODY = self._upload_from_file_helper()
-        parse_chunk = _email_chunk_parser()
-
-        self.assertEqual(len(requested), 1)
-        req = requested[0]
-        self.assertEqual(req['method'], 'POST')
-        uri = req['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/%s' % PATH)
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'multipart'})
-
-        ctype, boundary = [x.strip()
-                           for x in req['headers']['content-type'].split(';')]
-        self.assertEqual(ctype, 'multipart/related')
-        self.assertTrue(boundary.startswith('boundary="=='))
-        self.assertTrue(boundary.endswith('=="'))
-
-        divider = b'--' + _to_bytes(boundary[len('boundary="'):-1])
-        chunks = req['body'].split(divider)[1:-1]  # discard prolog / epilog
-        self.assertEqual(len(chunks), 2)
-
-        text_msg = parse_chunk(chunks[0].strip())
-        self.assertEqual(dict(text_msg._headers),
-                         {'Content-Type': 'application/json',
-                          'MIME-Version': '1.0'})
-        metadata = json.loads(text_msg._payload)
-        load_config = metadata['configuration']['load']
-        DESTINATION_TABLE = {
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.TABLE_NAME,
-        }
-        self.assertEqual(load_config['destinationTable'], DESTINATION_TABLE)
-        self.assertEqual(load_config['sourceFormat'], 'CSV')
-
-        app_msg = parse_chunk(chunks[1].strip())
-        self.assertEqual(dict(app_msg._headers),
-                         {'Content-Type': 'application/octet-stream',
-                          'Content-Transfer-Encoding': 'binary',
-                          'MIME-Version': '1.0'})
-        body = BODY.decode('ascii').rstrip()
-        body_lines = [line.strip() for line in body.splitlines()]
-        payload_lines = app_msg._payload.rstrip().splitlines()
-        self.assertEqual(payload_lines, body_lines)
-
-    def test_upload_from_file_resumable_with_400(self):
-        import csv
-        import datetime
-        from six.moves.http_client import BAD_REQUEST
-        from google.cloud.bigquery import table as MUT
-        from google.cloud.exceptions import BadRequest
-        from google.cloud._helpers import UTC
-        from unit_tests._testing import _Monkey
-        from unit_tests._testing import _NamedTemporaryFile
-        WHEN_TS = 1437767599.006
-        WHEN = datetime.datetime.utcfromtimestamp(WHEN_TS).replace(
-            tzinfo=UTC)
-        initial_response = {'status': BAD_REQUEST}
-        conn = _Connection(
-            (initial_response, b'{}'),
-        )
-        client = _Client(project=self.PROJECT, connection=conn)
-
-        class _UploadConfig(object):
-            accept = ['*/*']
-            max_size = None
-            resumable_multipart = True
-            resumable_path = u'/upload/bigquery/v2/projects/{project}/jobs'
-            simple_multipart = True
-            simple_path = u''  # force resumable
-        dataset = _Dataset(client)
-        table = self._makeOne(self.TABLE_NAME, dataset=dataset)
-
-        with _Monkey(MUT, _UploadConfig=_UploadConfig):
-            with _NamedTemporaryFile() as temp:
-                with open(temp.name, 'w') as file_obj:
-                    writer = csv.writer(file_obj)
-                    writer.writerow(('full_name', 'age', 'joined'))
-                    writer.writerow(('Phred Phlyntstone', 32, WHEN))
-
-                with open(temp.name, 'rb') as file_obj:
-                    with self.assertRaises(BadRequest):
-                        table.upload_from_file(
-                            file_obj, 'CSV', rewind=True)
-
-    # pylint: disable=too-many-statements
-    def test_upload_from_file_w_explicit_client_resumable(self):
-        import json
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigquery import table as MUT
-
-        UPLOAD_PATH = 'https://example.com/upload/test'
-        initial_response = {'status': OK, 'location': UPLOAD_PATH}
-        upload_response = {'status': OK}
-        conn = _Connection(
-            (initial_response, b'{}'),
-            (upload_response, b'{}'),
-        )
-        client = _Client(project=self.PROJECT, connection=conn)
-
-        class _UploadConfig(object):
-            accept = ['*/*']
-            max_size = None
-            resumable_multipart = True
-            resumable_path = u'/upload/bigquery/v2/projects/{project}/jobs'
-            simple_multipart = True
-            simple_path = u''  # force resumable
-
-        with _Monkey(MUT, _UploadConfig=_UploadConfig):
-            orig_requested, PATH, BODY = self._upload_from_file_helper(
-                allow_jagged_rows=False,
-                allow_quoted_newlines=False,
-                create_disposition='CREATE_IF_NEEDED',
-                encoding='utf8',
-                field_delimiter=',',
-                ignore_unknown_values=False,
-                max_bad_records=0,
-                quote_character='"',
-                skip_leading_rows=1,
-                write_disposition='WRITE_APPEND',
-                client=client,
-                _explicit_size=True)
-
-        self.assertEqual(len(orig_requested), 0)
-
-        requested = conn.http._requested
-        self.assertEqual(len(requested), 2)
-        req = requested[0]
-        self.assertEqual(req['method'], 'POST')
-        uri = req['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/%s' % PATH)
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'resumable'})
-
-        self.assertEqual(req['headers']['content-type'], 'application/json')
-        metadata = json.loads(req['body'])
-        load_config = metadata['configuration']['load']
-        DESTINATION_TABLE = {
-            'projectId': self.PROJECT,
-            'datasetId': self.DS_NAME,
-            'tableId': self.TABLE_NAME,
-        }
-        self.assertEqual(load_config['destinationTable'], DESTINATION_TABLE)
-        self.assertEqual(load_config['sourceFormat'], 'CSV')
-        self.assertEqual(load_config['allowJaggedRows'], False)
-        self.assertEqual(load_config['allowQuotedNewlines'], False)
-        self.assertEqual(load_config['createDisposition'], 'CREATE_IF_NEEDED')
-        self.assertEqual(load_config['encoding'], 'utf8')
-        self.assertEqual(load_config['fieldDelimiter'], ',')
-        self.assertEqual(load_config['ignoreUnknownValues'], False)
-        self.assertEqual(load_config['maxBadRecords'], 0)
-        self.assertEqual(load_config['quote'], '"')
-        self.assertEqual(load_config['skipLeadingRows'], 1)
-        self.assertEqual(load_config['writeDisposition'], 'WRITE_APPEND')
-
-        req = requested[1]
-        self.assertEqual(req['method'], 'PUT')
-        self.assertEqual(req['uri'], UPLOAD_PATH)
-        headers = req['headers']
-        length = len(BODY)
-        self.assertEqual(headers['Content-Type'], 'application/octet-stream')
-        self.assertEqual(headers['Content-Range'],
-                         'bytes 0-%d/%d' % (length - 1, length))
-        self.assertEqual(headers['content-length'], '%d' % (length,))
-        self.assertEqual(req['body'], BODY)
-    # pylint: enable=too-many-statements
-
-
-class Test_parse_schema_resource(unittest.TestCase, _SchemaBase):
-
-    def _callFUT(self, resource):
-        from google.cloud.bigquery.table import _parse_schema_resource
-        return _parse_schema_resource(resource)
-
-    def _makeResource(self):
-        return {
-            'schema': {'fields': [
-                {'name': 'full_name', 'type': 'STRING', 'mode': 'REQUIRED'},
-                {'name': 'age', 'type': 'INTEGER', 'mode': 'REQUIRED'},
-            ]},
-        }
-
-    def test__parse_schema_resource_defaults(self):
-        RESOURCE = self._makeResource()
-        schema = self._callFUT(RESOURCE['schema'])
-        self._verifySchema(schema, RESOURCE)
-
-    def test__parse_schema_resource_subfields(self):
-        RESOURCE = self._makeResource()
-        RESOURCE['schema']['fields'].append(
-            {'name': 'phone',
-             'type': 'RECORD',
-             'mode': 'REPEATABLE',
-             'fields': [{'name': 'type',
-                         'type': 'STRING',
-                         'mode': 'REQUIRED'},
-                        {'name': 'number',
-                         'type': 'STRING',
-                         'mode': 'REQUIRED'}]})
-        schema = self._callFUT(RESOURCE['schema'])
-        self._verifySchema(schema, RESOURCE)
-
-    def test__parse_schema_resource_fields_without_mode(self):
-        RESOURCE = self._makeResource()
-        RESOURCE['schema']['fields'].append(
-            {'name': 'phone',
-             'type': 'STRING'})
-
-        schema = self._callFUT(RESOURCE['schema'])
-        self._verifySchema(schema, RESOURCE)
-
-
-class Test_build_schema_resource(unittest.TestCase, _SchemaBase):
-
-    def _callFUT(self, resource):
-        from google.cloud.bigquery.table import _build_schema_resource
-        return _build_schema_resource(resource)
-
-    def test_defaults(self):
-        from google.cloud.bigquery.table import SchemaField
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        resource = self._callFUT([full_name, age])
-        self.assertEqual(len(resource), 2)
-        self.assertEqual(resource[0],
-                         {'name': 'full_name',
-                          'type': 'STRING',
-                          'mode': 'REQUIRED'})
-        self.assertEqual(resource[1],
-                         {'name': 'age',
-                          'type': 'INTEGER',
-                          'mode': 'REQUIRED'})
-
-    def test_w_description(self):
-        from google.cloud.bigquery.table import SchemaField
-        DESCRIPTION = 'DESCRIPTION'
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED',
-                                description=DESCRIPTION)
-        age = SchemaField('age', 'INTEGER', mode='REQUIRED')
-        resource = self._callFUT([full_name, age])
-        self.assertEqual(len(resource), 2)
-        self.assertEqual(resource[0],
-                         {'name': 'full_name',
-                          'type': 'STRING',
-                          'mode': 'REQUIRED',
-                          'description': DESCRIPTION})
-        self.assertEqual(resource[1],
-                         {'name': 'age',
-                          'type': 'INTEGER',
-                          'mode': 'REQUIRED'})
-
-    def test_w_subfields(self):
-        from google.cloud.bigquery.table import SchemaField
-        full_name = SchemaField('full_name', 'STRING', mode='REQUIRED')
-        ph_type = SchemaField('type', 'STRING', 'REQUIRED')
-        ph_num = SchemaField('number', 'STRING', 'REQUIRED')
-        phone = SchemaField('phone', 'RECORD', mode='REPEATABLE',
-                            fields=[ph_type, ph_num])
-        resource = self._callFUT([full_name, phone])
-        self.assertEqual(len(resource), 2)
-        self.assertEqual(resource[0],
-                         {'name': 'full_name',
-                          'type': 'STRING',
-                          'mode': 'REQUIRED'})
-        self.assertEqual(resource[1],
-                         {'name': 'phone',
-                          'type': 'RECORD',
-                          'mode': 'REPEATABLE',
-                          'fields': [{'name': 'type',
-                                      'type': 'STRING',
-                                      'mode': 'REQUIRED'},
-                                     {'name': 'number',
-                                      'type': 'STRING',
-                                      'mode': 'REQUIRED'}]})
-
-
-class _Client(object):
-
-    _query_results = ()
-
-    def __init__(self, project='project', connection=None):
-        self.project = project
-        self.connection = connection
-
-    def job_from_resource(self, resource):  # pylint: disable=unused-argument
-        return self._job
-
-    def run_sync_query(self, query):
-        return _Query(query, self)
-
-
-class _Query(object):
-
-    def __init__(self, query, client):
-        self.query = query
-        self.rows = []
-        self.client = client
-
-    def run(self):
-        self.rows = self.client._query_results
-
-
-class _Dataset(object):
-
-    def __init__(self, client, name=TestTable.DS_NAME):
-        self._client = client
-        self.name = name
-
-    @property
-    def path(self):
-        return '/projects/%s/datasets/%s' % (
-            self._client.project, self.name)
-
-    @property
-    def project(self):
-        return self._client.project
-
-
-class _Responder(object):
-
-    def __init__(self, *responses):
-        self._responses = responses[:]
-        self._requested = []
-
-    def _respond(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
-
-
-class _HTTP(_Responder):
-
-    connections = {}  # For google-apitools debugging.
-
-    def request(self, uri, method, headers, body, **kw):
-        if hasattr(body, 'read'):
-            body = body.read()
-        return self._respond(uri=uri, method=method, headers=headers,
-                             body=body, **kw)
-
-
-class _Connection(_Responder):
-
-    API_BASE_URL = 'http://example.com'
-    USER_AGENT = 'testing 1.2.3'
-
-    def __init__(self, *responses):
-        super(_Connection, self).__init__(*responses)
-        self.http = _HTTP(*responses)
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
-
-    def build_api_url(self, path, query_params=None,
-                      api_base_url=API_BASE_URL):
-        from six.moves.urllib.parse import urlencode
-        from six.moves.urllib.parse import urlsplit
-        from six.moves.urllib.parse import urlunsplit
-        # Mimic the build_api_url interface.
-        qs = urlencode(query_params or {})
-        scheme, netloc, _, _, _ = urlsplit(api_base_url)
-        return urlunsplit((scheme, netloc, path, qs, ''))
-
-
-def _email_chunk_parser():
-    import six
-    if six.PY3:  # pragma: NO COVER  Python3
-        from email.parser import BytesParser
-        parser = BytesParser()
-        return parser.parsebytes
-    else:
-        from email.parser import Parser
-        parser = Parser()
-        return parser.parsestr
diff --git a/unit_tests/bigtable/__init__.py b/unit_tests/bigtable/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/bigtable/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/bigtable/_testing.py b/unit_tests/bigtable/_testing.py
deleted file mode 100644
index 402a29ba92eb..000000000000
--- a/unit_tests/bigtable/_testing.py
+++ /dev/null
@@ -1,46 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-"""Mocks used to emulate gRPC generated objects."""
-
-
-class _FakeStub(object):
-    """Acts as a gPRC stub."""
-
-    def __init__(self, *results):
-        self.results = results
-        self.method_calls = []
-
-    def __getattr__(self, name):
-        # We need not worry about attributes set in constructor
-        # since __getattribute__ will handle them.
-        return _MethodMock(name, self)
-
-
-class _MethodMock(object):
-    """Mock for API method attached to a gRPC stub.
-
-    These are of type :class:`grpc._channel._UnaryUnaryMultiCallable`.
-    """
-
-    def __init__(self, name, stub):
-        self._name = name
-        self._stub = stub
-
-    def __call__(self, *args, **kwargs):
-        """Sync method meant to mock a gRPC stub request."""
-        self._stub.method_calls.append((self._name, args, kwargs))
-        curr_result, self._stub.results = (self._stub.results[0],
-                                           self._stub.results[1:])
-        return curr_result
diff --git a/unit_tests/bigtable/test_client.py b/unit_tests/bigtable/test_client.py
deleted file mode 100644
index 61d029db509c..000000000000
--- a/unit_tests/bigtable/test_client.py
+++ /dev/null
@@ -1,649 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-
-import unittest
-
-
-class Test__make_data_stub(unittest.TestCase):
-
-    def _callFUT(self, client):
-        from google.cloud.bigtable.client import _make_data_stub
-        return _make_data_stub(client)
-
-    def test_without_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        credentials = _Credentials()
-        user_agent = 'you-sir-age-int'
-        client = _Client(credentials, user_agent)
-
-        fake_stub = object()
-        make_secure_stub_args = []
-
-        def mock_make_secure_stub(*args):
-            make_secure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_secure_stub=mock_make_secure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_secure_stub_args, [
-            (
-                client.credentials,
-                client.user_agent,
-                MUT.bigtable_pb2.BigtableStub,
-                MUT.DATA_API_HOST,
-            ),
-        ])
-
-    def test_with_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        emulator_host = object()
-        client = _Client(None, None, emulator_host=emulator_host)
-
-        fake_stub = object()
-        make_insecure_stub_args = []
-
-        def mock_make_insecure_stub(*args):
-            make_insecure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_insecure_stub=mock_make_insecure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_insecure_stub_args, [
-            (
-                MUT.bigtable_pb2.BigtableStub,
-                emulator_host,
-            ),
-        ])
-
-
-class Test__make_instance_stub(unittest.TestCase):
-
-    def _callFUT(self, client):
-        from google.cloud.bigtable.client import _make_instance_stub
-        return _make_instance_stub(client)
-
-    def test_without_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        credentials = _Credentials()
-        user_agent = 'you-sir-age-int'
-        client = _Client(credentials, user_agent)
-
-        fake_stub = object()
-        make_secure_stub_args = []
-
-        def mock_make_secure_stub(*args):
-            make_secure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_secure_stub=mock_make_secure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_secure_stub_args, [
-            (
-                client.credentials,
-                client.user_agent,
-                MUT.bigtable_instance_admin_pb2.BigtableInstanceAdminStub,
-                MUT.INSTANCE_ADMIN_HOST,
-            ),
-        ])
-
-    def test_with_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        emulator_host = object()
-        client = _Client(None, None, emulator_host=emulator_host)
-
-        fake_stub = object()
-        make_insecure_stub_args = []
-
-        def mock_make_insecure_stub(*args):
-            make_insecure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_insecure_stub=mock_make_insecure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_insecure_stub_args, [
-            (
-                MUT.bigtable_instance_admin_pb2.BigtableInstanceAdminStub,
-                emulator_host,
-            ),
-        ])
-
-
-class Test__make_operations_stub(unittest.TestCase):
-
-    def _callFUT(self, client):
-        from google.cloud.bigtable.client import _make_operations_stub
-        return _make_operations_stub(client)
-
-    def test_without_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        credentials = _Credentials()
-        user_agent = 'you-sir-age-int'
-        client = _Client(credentials, user_agent)
-
-        fake_stub = object()
-        make_secure_stub_args = []
-
-        def mock_make_secure_stub(*args):
-            make_secure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_secure_stub=mock_make_secure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_secure_stub_args, [
-            (
-                client.credentials,
-                client.user_agent,
-                MUT.operations_grpc_pb2.OperationsStub,
-                MUT.OPERATIONS_API_HOST,
-            ),
-        ])
-
-    def test_with_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        emulator_host = object()
-        client = _Client(None, None, emulator_host=emulator_host)
-
-        fake_stub = object()
-        make_insecure_stub_args = []
-
-        def mock_make_insecure_stub(*args):
-            make_insecure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_insecure_stub=mock_make_insecure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_insecure_stub_args, [
-            (
-                MUT.operations_grpc_pb2.OperationsStub,
-                emulator_host,
-            ),
-        ])
-
-
-class Test__make_table_stub(unittest.TestCase):
-
-    def _callFUT(self, client):
-        from google.cloud.bigtable.client import _make_table_stub
-        return _make_table_stub(client)
-
-    def test_without_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        credentials = _Credentials()
-        user_agent = 'you-sir-age-int'
-        client = _Client(credentials, user_agent)
-
-        fake_stub = object()
-        make_secure_stub_args = []
-
-        def mock_make_secure_stub(*args):
-            make_secure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_secure_stub=mock_make_secure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_secure_stub_args, [
-            (
-                client.credentials,
-                client.user_agent,
-                MUT.bigtable_table_admin_pb2.BigtableTableAdminStub,
-                MUT.TABLE_ADMIN_HOST,
-            ),
-        ])
-
-    def test_with_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        emulator_host = object()
-        client = _Client(None, None, emulator_host=emulator_host)
-
-        fake_stub = object()
-        make_insecure_stub_args = []
-
-        def mock_make_insecure_stub(*args):
-            make_insecure_stub_args.append(args)
-            return fake_stub
-
-        with _Monkey(MUT, make_insecure_stub=mock_make_insecure_stub):
-            result = self._callFUT(client)
-
-        self.assertIs(result, fake_stub)
-        self.assertEqual(make_insecure_stub_args, [
-            (
-                MUT.bigtable_table_admin_pb2.BigtableTableAdminStub,
-                emulator_host,
-            ),
-        ])
-
-
-class TestClient(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-    INSTANCE_ID = 'instance-id'
-    DISPLAY_NAME = 'display-name'
-    USER_AGENT = 'you-sir-age-int'
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def _makeOneWithMocks(self, *args, **kwargs):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        mock_make_data_stub = _MakeStubMock()
-        mock_make_instance_stub = _MakeStubMock()
-        mock_make_operations_stub = _MakeStubMock()
-        mock_make_table_stub = _MakeStubMock()
-        with _Monkey(MUT, _make_data_stub=mock_make_data_stub,
-                     _make_instance_stub=mock_make_instance_stub,
-                     _make_operations_stub=mock_make_operations_stub,
-                     _make_table_stub=mock_make_table_stub):
-            return self._makeOne(*args, **kwargs)
-
-    def _constructor_test_helper(self, expected_scopes, creds,
-                                 read_only=False, admin=False,
-                                 user_agent=None, expected_creds=None):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        user_agent = user_agent or MUT.DEFAULT_USER_AGENT
-
-        mock_make_data_stub = _MakeStubMock()
-        mock_make_instance_stub = _MakeStubMock()
-        mock_make_operations_stub = _MakeStubMock()
-        mock_make_table_stub = _MakeStubMock()
-        with _Monkey(MUT, _make_data_stub=mock_make_data_stub,
-                     _make_instance_stub=mock_make_instance_stub,
-                     _make_operations_stub=mock_make_operations_stub,
-                     _make_table_stub=mock_make_table_stub):
-            client = self._makeOne(project=self.PROJECT, credentials=creds,
-                                   read_only=read_only, admin=admin,
-                                   user_agent=user_agent)
-
-        # Verify the mocks.
-        self.assertEqual(mock_make_data_stub.calls, [client])
-        if admin:
-            self.assertSequenceEqual(mock_make_instance_stub.calls, [client])
-            self.assertSequenceEqual(mock_make_operations_stub.calls, [client])
-            self.assertSequenceEqual(mock_make_table_stub.calls, [client])
-        else:
-            self.assertSequenceEqual(mock_make_instance_stub.calls, [])
-            self.assertSequenceEqual(mock_make_operations_stub.calls, [])
-            self.assertSequenceEqual(mock_make_table_stub.calls, [])
-
-        expected_creds = expected_creds or creds
-        self.assertIs(client._credentials, expected_creds)
-        if expected_scopes is not None:
-            self.assertEqual(client._credentials.scopes, expected_scopes)
-
-        self.assertEqual(client.project, self.PROJECT)
-        self.assertEqual(client.user_agent, user_agent)
-        # Check gRPC stubs (or mocks of them) are set
-        self.assertIs(client._data_stub, mock_make_data_stub.result)
-        if admin:
-            self.assertIs(client._instance_stub_internal,
-                          mock_make_instance_stub.result)
-            self.assertIs(client._operations_stub_internal,
-                          mock_make_operations_stub.result)
-            self.assertIs(client._table_stub_internal,
-                          mock_make_table_stub.result)
-        else:
-            self.assertIsNone(client._instance_stub_internal)
-            self.assertIsNone(client._operations_stub_internal)
-            self.assertIsNone(client._table_stub_internal)
-
-    def test_constructor_default_scopes(self):
-        from google.cloud.bigtable import client as MUT
-
-        expected_scopes = [MUT.DATA_SCOPE]
-        creds = _Credentials()
-        self._constructor_test_helper(expected_scopes, creds)
-
-    def test_constructor_custom_user_agent(self):
-        from google.cloud.bigtable import client as MUT
-
-        CUSTOM_USER_AGENT = 'custom-application'
-        expected_scopes = [MUT.DATA_SCOPE]
-        creds = _Credentials()
-        self._constructor_test_helper(expected_scopes, creds,
-                                      user_agent=CUSTOM_USER_AGENT)
-
-    def test_constructor_with_admin(self):
-        from google.cloud.bigtable import client as MUT
-
-        expected_scopes = [MUT.DATA_SCOPE, MUT.ADMIN_SCOPE]
-        creds = _Credentials()
-        self._constructor_test_helper(expected_scopes, creds, admin=True)
-
-    def test_constructor_with_read_only(self):
-        from google.cloud.bigtable import client as MUT
-
-        expected_scopes = [MUT.READ_ONLY_SCOPE]
-        creds = _Credentials()
-        self._constructor_test_helper(expected_scopes, creds, read_only=True)
-
-    def test_constructor_both_admin_and_read_only(self):
-        creds = _Credentials()
-        with self.assertRaises(ValueError):
-            self._constructor_test_helper([], creds, admin=True,
-                                          read_only=True)
-
-    def test_constructor_implicit_credentials(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        creds = _Credentials()
-        expected_scopes = [MUT.DATA_SCOPE]
-
-        def mock_get_credentials():
-            return creds
-
-        with _Monkey(MUT, get_credentials=mock_get_credentials):
-            self._constructor_test_helper(expected_scopes, None,
-                                          expected_creds=creds)
-
-    def test_constructor_credentials_wo_create_scoped(self):
-        creds = object()
-        expected_scopes = None
-        self._constructor_test_helper(expected_scopes, creds)
-
-    def _copy_test_helper(self, read_only=False, admin=False):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import client as MUT
-
-        credentials = _Credentials('value')
-        client = self._makeOneWithMocks(
-            project=self.PROJECT,
-            credentials=credentials,
-            read_only=read_only,
-            admin=admin,
-            user_agent=self.USER_AGENT)
-        # Put some fake stubs in place so that we can verify they don't
-        # get copied. In the admin=False case, only the data stub will
-        # not be None, so we over-ride all the internal values.
-        client._data_stub = object()
-        client._instance_stub_internal = object()
-        client._operations_stub_internal = object()
-        client._table_stub_internal = object()
-
-        mock_make_data_stub = _MakeStubMock()
-        mock_make_instance_stub = _MakeStubMock()
-        mock_make_operations_stub = _MakeStubMock()
-        mock_make_table_stub = _MakeStubMock()
-        with _Monkey(MUT, _make_data_stub=mock_make_data_stub,
-                     _make_instance_stub=mock_make_instance_stub,
-                     _make_operations_stub=mock_make_operations_stub,
-                     _make_table_stub=mock_make_table_stub):
-            new_client = client.copy()
-        self.assertEqual(new_client._admin, client._admin)
-        self.assertEqual(new_client._credentials, client._credentials)
-        self.assertEqual(new_client.project, client.project)
-        self.assertEqual(new_client.user_agent, client.user_agent)
-        # Make sure stubs are not preserved.
-        self.assertNotEqual(new_client._data_stub, client._data_stub)
-        self.assertNotEqual(new_client._instance_stub_internal,
-                            client._instance_stub_internal)
-        self.assertNotEqual(new_client._operations_stub_internal,
-                            client._operations_stub_internal)
-        self.assertNotEqual(new_client._table_stub_internal,
-                            client._table_stub_internal)
-
-    def test_copy(self):
-        self._copy_test_helper()
-
-    def test_copy_admin(self):
-        self._copy_test_helper(admin=True)
-
-    def test_copy_read_only(self):
-        self._copy_test_helper(read_only=True)
-
-    def test_credentials_getter(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials)
-        self.assertIs(client.credentials, credentials)
-
-    def test_project_name_property(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials)
-        project_name = 'projects/' + project
-        self.assertEqual(client.project_name, project_name)
-
-    def test_instance_stub_getter(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials, admin=True)
-        self.assertIs(client._instance_stub, client._instance_stub_internal)
-
-    def test_instance_stub_non_admin_failure(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials, admin=False)
-        with self.assertRaises(ValueError):
-            getattr(client, '_instance_stub')
-
-    def test_operations_stub_getter(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials, admin=True)
-        self.assertIs(client._operations_stub,
-                      client._operations_stub_internal)
-
-    def test_operations_stub_non_admin_failure(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials, admin=False)
-        with self.assertRaises(ValueError):
-            getattr(client, '_operations_stub')
-
-    def test_table_stub_getter(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials, admin=True)
-        self.assertIs(client._table_stub, client._table_stub_internal)
-
-    def test_table_stub_non_admin_failure(self):
-        credentials = _Credentials()
-        project = 'PROJECT'
-        client = self._makeOneWithMocks(project=project,
-                                        credentials=credentials, admin=False)
-        with self.assertRaises(ValueError):
-            getattr(client, '_table_stub')
-
-    def test_instance_factory_defaults(self):
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-        from google.cloud.bigtable.instance import Instance
-        from google.cloud.bigtable.instance import (
-            _EXISTING_INSTANCE_LOCATION_ID)
-
-        PROJECT = 'PROJECT'
-        INSTANCE_ID = 'instance-id'
-        DISPLAY_NAME = 'display-name'
-        credentials = _Credentials()
-        client = self._makeOneWithMocks(project=PROJECT,
-                                        credentials=credentials)
-
-        instance = client.instance(INSTANCE_ID, display_name=DISPLAY_NAME)
-
-        self.assertIsInstance(instance, Instance)
-        self.assertEqual(instance.instance_id, INSTANCE_ID)
-        self.assertEqual(instance.display_name, DISPLAY_NAME)
-        self.assertEqual(instance._cluster_location_id,
-                         _EXISTING_INSTANCE_LOCATION_ID)
-        self.assertEqual(instance._cluster_serve_nodes, DEFAULT_SERVE_NODES)
-        self.assertIs(instance._client, client)
-
-    def test_instance_factory_w_explicit_serve_nodes(self):
-        from google.cloud.bigtable.instance import Instance
-
-        PROJECT = 'PROJECT'
-        INSTANCE_ID = 'instance-id'
-        DISPLAY_NAME = 'display-name'
-        LOCATION_ID = 'locname'
-        SERVE_NODES = 5
-        credentials = _Credentials()
-        client = self._makeOneWithMocks(project=PROJECT,
-                                        credentials=credentials)
-
-        instance = client.instance(
-            INSTANCE_ID, display_name=DISPLAY_NAME,
-            location=LOCATION_ID, serve_nodes=SERVE_NODES)
-
-        self.assertIsInstance(instance, Instance)
-        self.assertEqual(instance.instance_id, INSTANCE_ID)
-        self.assertEqual(instance.display_name, DISPLAY_NAME)
-        self.assertEqual(instance._cluster_location_id, LOCATION_ID)
-        self.assertEqual(instance._cluster_serve_nodes, SERVE_NODES)
-        self.assertIs(instance._client, client)
-
-    def test_list_instances(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        LOCATION = 'projects/' + self.PROJECT + '/locations/locname'
-        FAILED_LOCATION = 'FAILED'
-        INSTANCE_ID1 = 'instance-id1'
-        INSTANCE_ID2 = 'instance-id2'
-        INSTANCE_NAME1 = (
-            'projects/' + self.PROJECT + '/instances/' + INSTANCE_ID1)
-        INSTANCE_NAME2 = (
-            'projects/' + self.PROJECT + '/instances/' + INSTANCE_ID2)
-
-        credentials = _Credentials()
-        client = self._makeOneWithMocks(
-            project=self.PROJECT,
-            credentials=credentials,
-            admin=True,
-        )
-
-        # Create request_pb
-        request_pb = messages_v2_pb2.ListInstancesRequest(
-            parent='projects/' + self.PROJECT,
-        )
-
-        # Create response_pb
-        response_pb = messages_v2_pb2.ListInstancesResponse(
-            failed_locations=[
-                FAILED_LOCATION,
-            ],
-            instances=[
-                data_v2_pb2.Instance(
-                    name=INSTANCE_NAME1,
-                    display_name=INSTANCE_NAME1,
-                ),
-                data_v2_pb2.Instance(
-                    name=INSTANCE_NAME2,
-                    display_name=INSTANCE_NAME2,
-                ),
-            ],
-        )
-
-        # Patch the stub used by the API method.
-        client._instance_stub_internal = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        failed_locations = [FAILED_LOCATION]
-        instances = [
-            client.instance(INSTANCE_ID1, LOCATION),
-            client.instance(INSTANCE_ID2, LOCATION),
-        ]
-        expected_result = (instances, failed_locations)
-
-        # Perform the method and check the result.
-        result = client.list_instances()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ListInstances',
-            (request_pb,),
-            {},
-        )])
-
-
-class _Credentials(object):
-
-    scopes = None
-
-    def __init__(self, access_token=None):
-        self._access_token = access_token
-        self._tokens = []
-
-    def create_scoped(self, scope):
-        self.scopes = scope
-        return self
-
-    def __eq__(self, other):
-        return self._access_token == other._access_token
-
-
-class _Client(object):
-
-    def __init__(self, credentials, user_agent, emulator_host=None):
-        self.credentials = credentials
-        self.user_agent = user_agent
-        self.emulator_host = emulator_host
-
-
-class _MakeStubMock(object):
-
-    def __init__(self):
-        self.result = object()
-        self.calls = []
-
-    def __call__(self, client):
-        self.calls.append(client)
-        return self.result
diff --git a/unit_tests/bigtable/test_cluster.py b/unit_tests/bigtable/test_cluster.py
deleted file mode 100644
index 8712abf52e99..000000000000
--- a/unit_tests/bigtable/test_cluster.py
+++ /dev/null
@@ -1,442 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-
-import unittest
-
-
-class TestCluster(unittest.TestCase):
-
-    PROJECT = 'project'
-    INSTANCE_ID = 'instance-id'
-    CLUSTER_ID = 'cluster-id'
-    CLUSTER_NAME = ('projects/' + PROJECT +
-                    '/instances/' + INSTANCE_ID +
-                    '/clusters/' + CLUSTER_ID)
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.cluster import Cluster
-        return Cluster
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor_defaults(self):
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        cluster = self._makeOne(self.CLUSTER_ID, instance)
-        self.assertEqual(cluster.cluster_id, self.CLUSTER_ID)
-        self.assertIs(cluster._instance, instance)
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-
-    def test_constructor_non_default(self):
-        SERVE_NODES = 8
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        cluster = self._makeOne(self.CLUSTER_ID, instance,
-                                serve_nodes=SERVE_NODES)
-        self.assertEqual(cluster.cluster_id, self.CLUSTER_ID)
-        self.assertIs(cluster._instance, instance)
-        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
-
-    def test_copy(self):
-        SERVE_NODES = 8
-
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster = self._makeOne(self.CLUSTER_ID, instance,
-                                serve_nodes=SERVE_NODES)
-        new_cluster = cluster.copy()
-
-        # Make sure the client copy succeeded.
-        self.assertIsNot(new_cluster._instance, instance)
-        self.assertEqual(new_cluster.serve_nodes, SERVE_NODES)
-        # Make sure the client got copied to a new instance.
-        self.assertIsNot(cluster, new_cluster)
-        self.assertEqual(cluster, new_cluster)
-
-    def test__update_from_pb_success(self):
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-
-        SERVE_NODES = 8
-        cluster_pb = _ClusterPB(
-            serve_nodes=SERVE_NODES,
-        )
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        cluster = self._makeOne(self.CLUSTER_ID, instance)
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-        cluster._update_from_pb(cluster_pb)
-        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
-
-    def test__update_from_pb_no_serve_nodes(self):
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-
-        cluster_pb = _ClusterPB()
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        cluster = self._makeOne(self.CLUSTER_ID, instance)
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-        with self.assertRaises(ValueError):
-            cluster._update_from_pb(cluster_pb)
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-
-    def test_from_pb_success(self):
-        SERVE_NODES = 331
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        cluster_pb = _ClusterPB(
-            name=self.CLUSTER_NAME,
-            serve_nodes=SERVE_NODES,
-        )
-
-        klass = self._getTargetClass()
-        cluster = klass.from_pb(cluster_pb, instance)
-        self.assertIsInstance(cluster, klass)
-        self.assertIs(cluster._instance, instance)
-        self.assertEqual(cluster.cluster_id, self.CLUSTER_ID)
-        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
-
-    def test_from_pb_bad_cluster_name(self):
-        BAD_CLUSTER_NAME = 'INCORRECT_FORMAT'
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster_pb = _ClusterPB(name=BAD_CLUSTER_NAME)
-
-        klass = self._getTargetClass()
-        with self.assertRaises(ValueError):
-            klass.from_pb(cluster_pb, instance)
-
-    def test_from_pb_project_mistmatch(self):
-        ALT_PROJECT = 'ALT_PROJECT'
-        client = _Client(ALT_PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        self.assertNotEqual(self.PROJECT, ALT_PROJECT)
-
-        cluster_pb = _ClusterPB(name=self.CLUSTER_NAME)
-
-        klass = self._getTargetClass()
-        with self.assertRaises(ValueError):
-            klass.from_pb(cluster_pb, instance)
-
-    def test_from_pb_instance_mistmatch(self):
-        ALT_INSTANCE_ID = 'ALT_INSTANCE_ID'
-        client = _Client(self.PROJECT)
-        instance = _Instance(ALT_INSTANCE_ID, client)
-
-        self.assertNotEqual(self.INSTANCE_ID, ALT_INSTANCE_ID)
-
-        cluster_pb = _ClusterPB(name=self.CLUSTER_NAME)
-
-        klass = self._getTargetClass()
-        with self.assertRaises(ValueError):
-            klass.from_pb(cluster_pb, instance)
-
-    def test_name_property(self):
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-
-        cluster = self._makeOne(self.CLUSTER_ID, instance)
-        self.assertEqual(cluster.name, self.CLUSTER_NAME)
-
-    def test___eq__(self):
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster1 = self._makeOne(self.CLUSTER_ID, instance)
-        cluster2 = self._makeOne(self.CLUSTER_ID, instance)
-        self.assertEqual(cluster1, cluster2)
-
-    def test___eq__type_differ(self):
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster1 = self._makeOne(self.CLUSTER_ID, instance)
-        cluster2 = object()
-        self.assertNotEqual(cluster1, cluster2)
-
-    def test___ne__same_value(self):
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster1 = self._makeOne(self.CLUSTER_ID, instance)
-        cluster2 = self._makeOne(self.CLUSTER_ID, instance)
-        comparison_val = (cluster1 != cluster2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster1 = self._makeOne('cluster_id1', instance)
-        cluster2 = self._makeOne('cluster_id2', instance)
-        self.assertNotEqual(cluster1, cluster2)
-
-    def test_reload(self):
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-
-        SERVE_NODES = 31
-        LOCATION = 'LOCATION'
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster = self._makeOne(self.CLUSTER_ID, instance)
-
-        # Create request_pb
-        request_pb = _GetClusterRequestPB(name=self.CLUSTER_NAME)
-
-        # Create response_pb
-        response_pb = _ClusterPB(
-            serve_nodes=SERVE_NODES,
-            location=LOCATION,
-        )
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # reload() has no return value.
-
-        # Check Cluster optional config values before.
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-
-        # Perform the method and check the result.
-        result = cluster.reload()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'GetCluster',
-            (request_pb,),
-            {},
-        )])
-
-        # Check Cluster optional config values before.
-        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
-        self.assertEqual(cluster.location, LOCATION)
-
-    def test_create(self):
-        from google.longrunning import operations_pb2
-        from google.cloud.operation import Operation
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        SERVE_NODES = 4
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster = self._makeOne(
-            self.CLUSTER_ID, instance, serve_nodes=SERVE_NODES)
-
-        # Create response_pb
-        OP_ID = 5678
-        OP_NAME = (
-            'operations/projects/%s/instances/%s/clusters/%s/operations/%d' %
-            (self.PROJECT, self.INSTANCE_ID, self.CLUSTER_ID, OP_ID))
-        response_pb = operations_pb2.Operation(name=OP_NAME)
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Perform the method and check the result.
-        result = cluster.create()
-
-        self.assertIsInstance(result, Operation)
-        self.assertEqual(result.name, OP_NAME)
-        self.assertIs(result.target, cluster)
-        self.assertIs(result.client, client)
-        self.assertIsNone(result.pb_metadata)
-        self.assertEqual(result.metadata, {'request_type': 'CreateCluster'})
-
-        self.assertEqual(len(stub.method_calls), 1)
-        api_name, args, kwargs = stub.method_calls[0]
-        self.assertEqual(api_name, 'CreateCluster')
-        request_pb, = args
-        self.assertIsInstance(request_pb,
-                              messages_v2_pb2.CreateClusterRequest)
-        self.assertEqual(request_pb.parent, instance.name)
-        self.assertEqual(request_pb.cluster_id, self.CLUSTER_ID)
-        self.assertEqual(request_pb.cluster.serve_nodes, SERVE_NODES)
-        self.assertEqual(kwargs, {})
-
-    def test_update(self):
-        import datetime
-        from google.longrunning import operations_pb2
-        from google.cloud.operation import Operation
-        from google.protobuf.any_pb2 import Any
-        from google.cloud._helpers import _datetime_to_pb_timestamp
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable.cluster import _UPDATE_CLUSTER_METADATA_URL
-
-        NOW = datetime.datetime.utcnow()
-        NOW_PB = _datetime_to_pb_timestamp(NOW)
-
-        SERVE_NODES = 81
-
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster = self._makeOne(self.CLUSTER_ID, instance,
-                                serve_nodes=SERVE_NODES)
-
-        # Create request_pb
-        request_pb = _ClusterPB(
-            name=self.CLUSTER_NAME,
-            serve_nodes=SERVE_NODES,
-        )
-
-        # Create response_pb
-        OP_ID = 5678
-        OP_NAME = (
-            'operations/projects/%s/instances/%s/clusters/%s/operations/%d' %
-            (self.PROJECT, self.INSTANCE_ID, self.CLUSTER_ID, OP_ID))
-        metadata = messages_v2_pb2.UpdateClusterMetadata(request_time=NOW_PB)
-        response_pb = operations_pb2.Operation(
-            name=OP_NAME,
-            metadata=Any(
-                type_url=_UPDATE_CLUSTER_METADATA_URL,
-                value=metadata.SerializeToString()
-            )
-        )
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        result = cluster.update()
-
-        self.assertIsInstance(result, Operation)
-        self.assertEqual(result.name, OP_NAME)
-        self.assertIs(result.target, cluster)
-        self.assertIs(result.client, client)
-        self.assertIsInstance(result.pb_metadata,
-                              messages_v2_pb2.UpdateClusterMetadata)
-        self.assertEqual(result.pb_metadata.request_time, NOW_PB)
-        self.assertEqual(result.metadata, {'request_type': 'UpdateCluster'})
-
-        self.assertEqual(len(stub.method_calls), 1)
-        api_name, args, kwargs = stub.method_calls[0]
-        self.assertEqual(api_name, 'UpdateCluster')
-        request_pb, = args
-        self.assertIsInstance(request_pb, data_v2_pb2.Cluster)
-        self.assertEqual(request_pb.name, self.CLUSTER_NAME)
-        self.assertEqual(request_pb.serve_nodes, SERVE_NODES)
-        self.assertEqual(kwargs, {})
-
-    def test_delete(self):
-        from google.protobuf import empty_pb2
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client(self.PROJECT)
-        instance = _Instance(self.INSTANCE_ID, client)
-        cluster = self._makeOne(self.CLUSTER_ID, instance)
-
-        # Create request_pb
-        request_pb = _DeleteClusterRequestPB(name=self.CLUSTER_NAME)
-
-        # Create response_pb
-        response_pb = empty_pb2.Empty()
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # delete() has no return value.
-
-        # Perform the method and check the result.
-        result = cluster.delete()
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'DeleteCluster',
-            (request_pb,),
-            {},
-        )])
-
-
-class Test__prepare_create_request(unittest.TestCase):
-
-    def _callFUT(self, cluster):
-        from google.cloud.bigtable.cluster import _prepare_create_request
-        return _prepare_create_request(cluster)
-
-    def test_it(self):
-        from google.cloud.bigtable.cluster import Cluster
-
-        PROJECT = 'PROJECT'
-        INSTANCE_ID = 'instance-id'
-        CLUSTER_ID = 'cluster-id'
-        SERVE_NODES = 8
-
-        client = _Client(PROJECT)
-        instance = _Instance(INSTANCE_ID, client)
-        cluster = Cluster(CLUSTER_ID, instance,
-                          serve_nodes=SERVE_NODES)
-
-        request_pb = self._callFUT(cluster)
-
-        self.assertEqual(request_pb.cluster_id, CLUSTER_ID)
-        self.assertEqual(request_pb.parent, instance.name)
-        self.assertEqual(request_pb.cluster.serve_nodes, SERVE_NODES)
-
-
-def _ClusterPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        instance_pb2 as instance_v2_pb2)
-    return instance_v2_pb2.Cluster(*args, **kw)
-
-
-def _DeleteClusterRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_instance_admin_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.DeleteClusterRequest(*args, **kw)
-
-
-def _GetClusterRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_instance_admin_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.GetClusterRequest(*args, **kw)
-
-
-class _Instance(object):
-
-    def __init__(self, instance_id, client):
-        self.instance_id = instance_id
-        self._client = client
-
-    @property
-    def name(self):
-        return 'projects/%s/instances/%s' % (
-            self._client.project, self.instance_id)
-
-    def copy(self):
-        return self.__class__(self.instance_id, self._client)
-
-    def __eq__(self, other):
-        return (other.instance_id == self.instance_id and
-                other._client == self._client)
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-        self.project_name = 'projects/' + self.project
-
-    def __eq__(self, other):
-        return (other.project == self.project and
-                other.project_name == self.project_name)
diff --git a/unit_tests/bigtable/test_column_family.py b/unit_tests/bigtable/test_column_family.py
deleted file mode 100644
index 91ce41d09abf..000000000000
--- a/unit_tests/bigtable/test_column_family.py
+++ /dev/null
@@ -1,682 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-
-import unittest
-
-
-class Test__timedelta_to_duration_pb(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.bigtable.column_family import (
-            _timedelta_to_duration_pb)
-        return _timedelta_to_duration_pb(*args, **kwargs)
-
-    def test_it(self):
-        import datetime
-        from google.protobuf import duration_pb2
-
-        seconds = microseconds = 1
-        timedelta_val = datetime.timedelta(seconds=seconds,
-                                           microseconds=microseconds)
-        result = self._callFUT(timedelta_val)
-        self.assertIsInstance(result, duration_pb2.Duration)
-        self.assertEqual(result.seconds, seconds)
-        self.assertEqual(result.nanos, 1000 * microseconds)
-
-    def test_with_negative_microseconds(self):
-        import datetime
-        from google.protobuf import duration_pb2
-
-        seconds = 1
-        microseconds = -5
-        timedelta_val = datetime.timedelta(seconds=seconds,
-                                           microseconds=microseconds)
-        result = self._callFUT(timedelta_val)
-        self.assertIsInstance(result, duration_pb2.Duration)
-        self.assertEqual(result.seconds, seconds - 1)
-        self.assertEqual(result.nanos, 10**9 + 1000 * microseconds)
-
-    def test_with_negative_seconds(self):
-        import datetime
-        from google.protobuf import duration_pb2
-
-        seconds = -1
-        microseconds = 5
-        timedelta_val = datetime.timedelta(seconds=seconds,
-                                           microseconds=microseconds)
-        result = self._callFUT(timedelta_val)
-        self.assertIsInstance(result, duration_pb2.Duration)
-        self.assertEqual(result.seconds, seconds + 1)
-        self.assertEqual(result.nanos, -(10**9 - 1000 * microseconds))
-
-
-class Test__duration_pb_to_timedelta(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.bigtable.column_family import (
-            _duration_pb_to_timedelta)
-        return _duration_pb_to_timedelta(*args, **kwargs)
-
-    def test_it(self):
-        import datetime
-        from google.protobuf import duration_pb2
-
-        seconds = microseconds = 1
-        duration_pb = duration_pb2.Duration(seconds=seconds,
-                                            nanos=1000 * microseconds)
-        timedelta_val = datetime.timedelta(seconds=seconds,
-                                           microseconds=microseconds)
-        result = self._callFUT(duration_pb)
-        self.assertIsInstance(result, datetime.timedelta)
-        self.assertEqual(result, timedelta_val)
-
-
-class TestMaxVersionsGCRule(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-        return MaxVersionsGCRule
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test___eq__type_differ(self):
-        gc_rule1 = self._makeOne(10)
-        gc_rule2 = object()
-        self.assertNotEqual(gc_rule1, gc_rule2)
-
-    def test___eq__same_value(self):
-        gc_rule1 = self._makeOne(2)
-        gc_rule2 = self._makeOne(2)
-        self.assertEqual(gc_rule1, gc_rule2)
-
-    def test___ne__same_value(self):
-        gc_rule1 = self._makeOne(99)
-        gc_rule2 = self._makeOne(99)
-        comparison_val = (gc_rule1 != gc_rule2)
-        self.assertFalse(comparison_val)
-
-    def test_to_pb(self):
-        max_num_versions = 1337
-        gc_rule = self._makeOne(max_num_versions=max_num_versions)
-        pb_val = gc_rule.to_pb()
-        expected = _GcRulePB(max_num_versions=max_num_versions)
-        self.assertEqual(pb_val, expected)
-
-
-class TestMaxAgeGCRule(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        return MaxAgeGCRule
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test___eq__type_differ(self):
-        max_age = object()
-        gc_rule1 = self._makeOne(max_age=max_age)
-        gc_rule2 = object()
-        self.assertNotEqual(gc_rule1, gc_rule2)
-
-    def test___eq__same_value(self):
-        max_age = object()
-        gc_rule1 = self._makeOne(max_age=max_age)
-        gc_rule2 = self._makeOne(max_age=max_age)
-        self.assertEqual(gc_rule1, gc_rule2)
-
-    def test___ne__same_value(self):
-        max_age = object()
-        gc_rule1 = self._makeOne(max_age=max_age)
-        gc_rule2 = self._makeOne(max_age=max_age)
-        comparison_val = (gc_rule1 != gc_rule2)
-        self.assertFalse(comparison_val)
-
-    def test_to_pb(self):
-        import datetime
-        from google.protobuf import duration_pb2
-
-        max_age = datetime.timedelta(seconds=1)
-        duration = duration_pb2.Duration(seconds=1)
-        gc_rule = self._makeOne(max_age=max_age)
-        pb_val = gc_rule.to_pb()
-        self.assertEqual(pb_val, _GcRulePB(max_age=duration))
-
-
-class TestGCRuleUnion(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.column_family import GCRuleUnion
-        return GCRuleUnion
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        rules = object()
-        rule_union = self._makeOne(rules)
-        self.assertIs(rule_union.rules, rules)
-
-    def test___eq__(self):
-        rules = object()
-        gc_rule1 = self._makeOne(rules)
-        gc_rule2 = self._makeOne(rules)
-        self.assertEqual(gc_rule1, gc_rule2)
-
-    def test___eq__type_differ(self):
-        rules = object()
-        gc_rule1 = self._makeOne(rules)
-        gc_rule2 = object()
-        self.assertNotEqual(gc_rule1, gc_rule2)
-
-    def test___ne__same_value(self):
-        rules = object()
-        gc_rule1 = self._makeOne(rules)
-        gc_rule2 = self._makeOne(rules)
-        comparison_val = (gc_rule1 != gc_rule2)
-        self.assertFalse(comparison_val)
-
-    def test_to_pb(self):
-        import datetime
-        from google.protobuf import duration_pb2
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        max_num_versions = 42
-        rule1 = MaxVersionsGCRule(max_num_versions)
-        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions)
-
-        max_age = datetime.timedelta(seconds=1)
-        rule2 = MaxAgeGCRule(max_age)
-        pb_rule2 = _GcRulePB(
-            max_age=duration_pb2.Duration(seconds=1))
-
-        rule3 = self._makeOne(rules=[rule1, rule2])
-        pb_rule3 = _GcRulePB(
-            union=_GcRuleUnionPB(rules=[pb_rule1, pb_rule2]))
-
-        gc_rule_pb = rule3.to_pb()
-        self.assertEqual(gc_rule_pb, pb_rule3)
-
-    def test_to_pb_nested(self):
-        import datetime
-        from google.protobuf import duration_pb2
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        max_num_versions1 = 42
-        rule1 = MaxVersionsGCRule(max_num_versions1)
-        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions1)
-
-        max_age = datetime.timedelta(seconds=1)
-        rule2 = MaxAgeGCRule(max_age)
-        pb_rule2 = _GcRulePB(
-            max_age=duration_pb2.Duration(seconds=1))
-
-        rule3 = self._makeOne(rules=[rule1, rule2])
-        pb_rule3 = _GcRulePB(
-            union=_GcRuleUnionPB(rules=[pb_rule1, pb_rule2]))
-
-        max_num_versions2 = 1337
-        rule4 = MaxVersionsGCRule(max_num_versions2)
-        pb_rule4 = _GcRulePB(max_num_versions=max_num_versions2)
-
-        rule5 = self._makeOne(rules=[rule3, rule4])
-        pb_rule5 = _GcRulePB(
-            union=_GcRuleUnionPB(rules=[pb_rule3, pb_rule4]))
-
-        gc_rule_pb = rule5.to_pb()
-        self.assertEqual(gc_rule_pb, pb_rule5)
-
-
-class TestGCRuleIntersection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.column_family import GCRuleIntersection
-        return GCRuleIntersection
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        rules = object()
-        rule_intersection = self._makeOne(rules)
-        self.assertIs(rule_intersection.rules, rules)
-
-    def test___eq__(self):
-        rules = object()
-        gc_rule1 = self._makeOne(rules)
-        gc_rule2 = self._makeOne(rules)
-        self.assertEqual(gc_rule1, gc_rule2)
-
-    def test___eq__type_differ(self):
-        rules = object()
-        gc_rule1 = self._makeOne(rules)
-        gc_rule2 = object()
-        self.assertNotEqual(gc_rule1, gc_rule2)
-
-    def test___ne__same_value(self):
-        rules = object()
-        gc_rule1 = self._makeOne(rules)
-        gc_rule2 = self._makeOne(rules)
-        comparison_val = (gc_rule1 != gc_rule2)
-        self.assertFalse(comparison_val)
-
-    def test_to_pb(self):
-        import datetime
-        from google.protobuf import duration_pb2
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        max_num_versions = 42
-        rule1 = MaxVersionsGCRule(max_num_versions)
-        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions)
-
-        max_age = datetime.timedelta(seconds=1)
-        rule2 = MaxAgeGCRule(max_age)
-        pb_rule2 = _GcRulePB(
-            max_age=duration_pb2.Duration(seconds=1))
-
-        rule3 = self._makeOne(rules=[rule1, rule2])
-        pb_rule3 = _GcRulePB(
-            intersection=_GcRuleIntersectionPB(
-                rules=[pb_rule1, pb_rule2]))
-
-        gc_rule_pb = rule3.to_pb()
-        self.assertEqual(gc_rule_pb, pb_rule3)
-
-    def test_to_pb_nested(self):
-        import datetime
-        from google.protobuf import duration_pb2
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        max_num_versions1 = 42
-        rule1 = MaxVersionsGCRule(max_num_versions1)
-        pb_rule1 = _GcRulePB(max_num_versions=max_num_versions1)
-
-        max_age = datetime.timedelta(seconds=1)
-        rule2 = MaxAgeGCRule(max_age)
-        pb_rule2 = _GcRulePB(
-            max_age=duration_pb2.Duration(seconds=1))
-
-        rule3 = self._makeOne(rules=[rule1, rule2])
-        pb_rule3 = _GcRulePB(
-            intersection=_GcRuleIntersectionPB(
-                rules=[pb_rule1, pb_rule2]))
-
-        max_num_versions2 = 1337
-        rule4 = MaxVersionsGCRule(max_num_versions2)
-        pb_rule4 = _GcRulePB(max_num_versions=max_num_versions2)
-
-        rule5 = self._makeOne(rules=[rule3, rule4])
-        pb_rule5 = _GcRulePB(
-            intersection=_GcRuleIntersectionPB(
-                rules=[pb_rule3, pb_rule4]))
-
-        gc_rule_pb = rule5.to_pb()
-        self.assertEqual(gc_rule_pb, pb_rule5)
-
-
-class TestColumnFamily(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.column_family import ColumnFamily
-        return ColumnFamily
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        column_family_id = u'column-family-id'
-        table = object()
-        gc_rule = object()
-        column_family = self._makeOne(
-            column_family_id, table, gc_rule=gc_rule)
-
-        self.assertEqual(column_family.column_family_id, column_family_id)
-        self.assertIs(column_family._table, table)
-        self.assertIs(column_family.gc_rule, gc_rule)
-
-    def test_name_property(self):
-        column_family_id = u'column-family-id'
-        table_name = 'table_name'
-        table = _Table(table_name)
-        column_family = self._makeOne(column_family_id, table)
-
-        expected_name = table_name + '/columnFamilies/' + column_family_id
-        self.assertEqual(column_family.name, expected_name)
-
-    def test___eq__(self):
-        column_family_id = 'column_family_id'
-        table = object()
-        gc_rule = object()
-        column_family1 = self._makeOne(column_family_id, table,
-                                       gc_rule=gc_rule)
-        column_family2 = self._makeOne(column_family_id, table,
-                                       gc_rule=gc_rule)
-        self.assertEqual(column_family1, column_family2)
-
-    def test___eq__type_differ(self):
-        column_family1 = self._makeOne('column_family_id', None)
-        column_family2 = object()
-        self.assertNotEqual(column_family1, column_family2)
-
-    def test___ne__same_value(self):
-        column_family_id = 'column_family_id'
-        table = object()
-        gc_rule = object()
-        column_family1 = self._makeOne(column_family_id, table,
-                                       gc_rule=gc_rule)
-        column_family2 = self._makeOne(column_family_id, table,
-                                       gc_rule=gc_rule)
-        comparison_val = (column_family1 != column_family2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        column_family1 = self._makeOne('column_family_id1', None)
-        column_family2 = self._makeOne('column_family_id2', None)
-        self.assertNotEqual(column_family1, column_family2)
-
-    def test_to_pb_no_rules(self):
-        column_family = self._makeOne('column_family_id', None)
-        pb_val = column_family.to_pb()
-        expected = _ColumnFamilyPB()
-        self.assertEqual(pb_val, expected)
-
-    def test_to_pb_with_rule(self):
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        gc_rule = MaxVersionsGCRule(1)
-        column_family = self._makeOne('column_family_id', None,
-                                      gc_rule=gc_rule)
-        pb_val = column_family.to_pb()
-        expected = _ColumnFamilyPB(gc_rule=gc_rule.to_pb())
-        self.assertEqual(pb_val, expected)
-
-    def _create_test_helper(self, gc_rule=None):
-        from google.cloud.bigtable._generated import (
-            bigtable_table_admin_pb2 as table_admin_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        project_id = 'project-id'
-        zone = 'zone'
-        cluster_id = 'cluster-id'
-        table_id = 'table-id'
-        column_family_id = 'column-family-id'
-        table_name = ('projects/' + project_id + '/zones/' + zone +
-                      '/clusters/' + cluster_id + '/tables/' + table_id)
-
-        client = _Client()
-        table = _Table(table_name, client=client)
-        column_family = self._makeOne(
-            column_family_id, table, gc_rule=gc_rule)
-
-        # Create request_pb
-        if gc_rule is None:
-            column_family_pb = _ColumnFamilyPB()
-        else:
-            column_family_pb = _ColumnFamilyPB(gc_rule=gc_rule.to_pb())
-        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(
-            name=table_name)
-        request_pb.modifications.add(
-            id=column_family_id,
-            create=column_family_pb,
-        )
-
-        # Create response_pb
-        response_pb = _ColumnFamilyPB()
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # create() has no return value.
-
-        # Perform the method and check the result.
-        self.assertEqual(stub.results, (response_pb,))
-        result = column_family.create()
-        self.assertEqual(stub.results, ())
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ModifyColumnFamilies',
-            (request_pb,),
-            {},
-        )])
-
-    def test_create(self):
-        self._create_test_helper(gc_rule=None)
-
-    def test_create_with_gc_rule(self):
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-        gc_rule = MaxVersionsGCRule(1337)
-        self._create_test_helper(gc_rule=gc_rule)
-
-    def _update_test_helper(self, gc_rule=None):
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable._generated import (
-            bigtable_table_admin_pb2 as table_admin_v2_pb2)
-
-        project_id = 'project-id'
-        zone = 'zone'
-        cluster_id = 'cluster-id'
-        table_id = 'table-id'
-        column_family_id = 'column-family-id'
-        table_name = ('projects/' + project_id + '/zones/' + zone +
-                      '/clusters/' + cluster_id + '/tables/' + table_id)
-
-        client = _Client()
-        table = _Table(table_name, client=client)
-        column_family = self._makeOne(
-            column_family_id, table, gc_rule=gc_rule)
-
-        # Create request_pb
-        if gc_rule is None:
-            column_family_pb = _ColumnFamilyPB()
-        else:
-            column_family_pb = _ColumnFamilyPB(gc_rule=gc_rule.to_pb())
-        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(
-            name=table_name)
-        request_pb.modifications.add(
-            id=column_family_id,
-            update=column_family_pb,
-        )
-
-        # Create response_pb
-        response_pb = _ColumnFamilyPB()
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # update() has no return value.
-
-        # Perform the method and check the result.
-        self.assertEqual(stub.results, (response_pb,))
-        result = column_family.update()
-        self.assertEqual(stub.results, ())
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ModifyColumnFamilies',
-            (request_pb,),
-            {},
-        )])
-
-    def test_update(self):
-        self._update_test_helper(gc_rule=None)
-
-    def test_update_with_gc_rule(self):
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-        gc_rule = MaxVersionsGCRule(1337)
-        self._update_test_helper(gc_rule=gc_rule)
-
-    def test_delete(self):
-        from google.protobuf import empty_pb2
-        from google.cloud.bigtable._generated import (
-            bigtable_table_admin_pb2 as table_admin_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        project_id = 'project-id'
-        zone = 'zone'
-        cluster_id = 'cluster-id'
-        table_id = 'table-id'
-        column_family_id = 'column-family-id'
-        table_name = ('projects/' + project_id + '/zones/' + zone +
-                      '/clusters/' + cluster_id + '/tables/' + table_id)
-
-        client = _Client()
-        table = _Table(table_name, client=client)
-        column_family = self._makeOne(column_family_id, table)
-
-        # Create request_pb
-        request_pb = table_admin_v2_pb2.ModifyColumnFamiliesRequest(
-            name=table_name)
-        request_pb.modifications.add(
-            id=column_family_id,
-            drop=True)
-
-        # Create response_pb
-        response_pb = empty_pb2.Empty()
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # delete() has no return value.
-
-        # Perform the method and check the result.
-        self.assertEqual(stub.results, (response_pb,))
-        result = column_family.delete()
-        self.assertEqual(stub.results, ())
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ModifyColumnFamilies',
-            (request_pb,),
-            {},
-        )])
-
-
-class Test__gc_rule_from_pb(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.bigtable.column_family import _gc_rule_from_pb
-        return _gc_rule_from_pb(*args, **kwargs)
-
-    def test_empty(self):
-
-        gc_rule_pb = _GcRulePB()
-        self.assertIsNone(self._callFUT(gc_rule_pb))
-
-    def test_max_num_versions(self):
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        orig_rule = MaxVersionsGCRule(1)
-        gc_rule_pb = orig_rule.to_pb()
-        result = self._callFUT(gc_rule_pb)
-        self.assertIsInstance(result, MaxVersionsGCRule)
-        self.assertEqual(result, orig_rule)
-
-    def test_max_age(self):
-        import datetime
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-
-        orig_rule = MaxAgeGCRule(datetime.timedelta(seconds=1))
-        gc_rule_pb = orig_rule.to_pb()
-        result = self._callFUT(gc_rule_pb)
-        self.assertIsInstance(result, MaxAgeGCRule)
-        self.assertEqual(result, orig_rule)
-
-    def test_union(self):
-        import datetime
-        from google.cloud.bigtable.column_family import GCRuleUnion
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        rule1 = MaxVersionsGCRule(1)
-        rule2 = MaxAgeGCRule(datetime.timedelta(seconds=1))
-        orig_rule = GCRuleUnion([rule1, rule2])
-        gc_rule_pb = orig_rule.to_pb()
-        result = self._callFUT(gc_rule_pb)
-        self.assertIsInstance(result, GCRuleUnion)
-        self.assertEqual(result, orig_rule)
-
-    def test_intersection(self):
-        import datetime
-        from google.cloud.bigtable.column_family import GCRuleIntersection
-        from google.cloud.bigtable.column_family import MaxAgeGCRule
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        rule1 = MaxVersionsGCRule(1)
-        rule2 = MaxAgeGCRule(datetime.timedelta(seconds=1))
-        orig_rule = GCRuleIntersection([rule1, rule2])
-        gc_rule_pb = orig_rule.to_pb()
-        result = self._callFUT(gc_rule_pb)
-        self.assertIsInstance(result, GCRuleIntersection)
-        self.assertEqual(result, orig_rule)
-
-    def test_unknown_field_name(self):
-        class MockProto(object):
-
-            names = []
-
-            @classmethod
-            def WhichOneof(cls, name):
-                cls.names.append(name)
-                return 'unknown'
-
-        self.assertEqual(MockProto.names, [])
-        self.assertRaises(ValueError, self._callFUT, MockProto)
-        self.assertEqual(MockProto.names, ['rule'])
-
-
-def _GcRulePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        table_pb2 as table_v2_pb2)
-    return table_v2_pb2.GcRule(*args, **kw)
-
-
-def _GcRuleIntersectionPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        table_pb2 as table_v2_pb2)
-    return table_v2_pb2.GcRule.Intersection(*args, **kw)
-
-
-def _GcRuleUnionPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        table_pb2 as table_v2_pb2)
-    return table_v2_pb2.GcRule.Union(*args, **kw)
-
-
-def _ColumnFamilyPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        table_pb2 as table_v2_pb2)
-    return table_v2_pb2.ColumnFamily(*args, **kw)
-
-
-class _Instance(object):
-
-    def __init__(self, client=None):
-        self._client = client
-
-
-class _Client(object):
-    pass
-
-
-class _Table(object):
-
-    def __init__(self, name, client=None):
-        self.name = name
-        self._instance = _Instance(client)
diff --git a/unit_tests/bigtable/test_instance.py b/unit_tests/bigtable/test_instance.py
deleted file mode 100644
index b6d001eff34a..000000000000
--- a/unit_tests/bigtable/test_instance.py
+++ /dev/null
@@ -1,587 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-
-import unittest
-
-
-class TestInstance(unittest.TestCase):
-
-    PROJECT = 'project'
-    INSTANCE_ID = 'instance-id'
-    INSTANCE_NAME = 'projects/' + PROJECT + '/instances/' + INSTANCE_ID
-    LOCATION_ID = 'locname'
-    LOCATION = 'projects/' + PROJECT + '/locations/' + LOCATION_ID
-    DISPLAY_NAME = 'display_name'
-    OP_ID = 8915
-    OP_NAME = ('operations/projects/%s/instances/%soperations/%d' %
-               (PROJECT, INSTANCE_ID, OP_ID))
-    TABLE_ID = 'table_id'
-    TABLE_NAME = INSTANCE_NAME + '/tables/' + TABLE_ID
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.instance import Instance
-        return Instance
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor_defaults(self):
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-
-        client = object()
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
-        self.assertEqual(instance.display_name, self.INSTANCE_ID)
-        self.assertIs(instance._client, client)
-        self.assertEqual(instance._cluster_location_id, self.LOCATION_ID)
-        self.assertEqual(instance._cluster_serve_nodes, DEFAULT_SERVE_NODES)
-
-    def test_constructor_non_default(self):
-        display_name = 'display_name'
-        client = object()
-
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID,
-                                 display_name=display_name)
-        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
-        self.assertEqual(instance.display_name, display_name)
-        self.assertIs(instance._client, client)
-
-    def test_copy(self):
-        display_name = 'display_name'
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID,
-                                 display_name=display_name)
-        new_instance = instance.copy()
-
-        # Make sure the client copy succeeded.
-        self.assertIsNot(new_instance._client, client)
-        self.assertEqual(new_instance._client, client)
-        # Make sure the client got copied to a new instance.
-        self.assertIsNot(instance, new_instance)
-        self.assertEqual(instance, new_instance)
-
-    def test_table_factory(self):
-        from google.cloud.bigtable.table import Table
-
-        instance = self._makeOne(self.INSTANCE_ID, None, self.LOCATION_ID)
-
-        table = instance.table(self.TABLE_ID)
-        self.assertIsInstance(table, Table)
-        self.assertEqual(table.table_id, self.TABLE_ID)
-        self.assertEqual(table._instance, instance)
-
-    def test__update_from_pb_success(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-
-        display_name = 'display_name'
-        instance_pb = data_v2_pb2.Instance(
-            display_name=display_name,
-        )
-
-        instance = self._makeOne(None, None, None, None)
-        self.assertIsNone(instance.display_name)
-        instance._update_from_pb(instance_pb)
-        self.assertEqual(instance.display_name, display_name)
-
-    def test__update_from_pb_no_display_name(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-
-        instance_pb = data_v2_pb2.Instance()
-        instance = self._makeOne(None, None, None, None)
-        self.assertIsNone(instance.display_name)
-        with self.assertRaises(ValueError):
-            instance._update_from_pb(instance_pb)
-        self.assertIsNone(instance.display_name)
-
-    def test_from_pb_success(self):
-        from google.cloud.bigtable.instance import (
-            _EXISTING_INSTANCE_LOCATION_ID)
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-
-        client = _Client(project=self.PROJECT)
-
-        instance_pb = data_v2_pb2.Instance(
-            name=self.INSTANCE_NAME,
-            display_name=self.INSTANCE_ID,
-        )
-
-        klass = self._getTargetClass()
-        instance = klass.from_pb(instance_pb, client)
-        self.assertIsInstance(instance, klass)
-        self.assertEqual(instance._client, client)
-        self.assertEqual(instance.instance_id, self.INSTANCE_ID)
-        self.assertEqual(instance._cluster_location_id,
-                         _EXISTING_INSTANCE_LOCATION_ID)
-
-    def test_from_pb_bad_instance_name(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-
-        instance_name = 'INCORRECT_FORMAT'
-        instance_pb = data_v2_pb2.Instance(name=instance_name)
-
-        klass = self._getTargetClass()
-        with self.assertRaises(ValueError):
-            klass.from_pb(instance_pb, None)
-
-    def test_from_pb_project_mistmatch(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-
-        ALT_PROJECT = 'ALT_PROJECT'
-        client = _Client(project=ALT_PROJECT)
-
-        self.assertNotEqual(self.PROJECT, ALT_PROJECT)
-
-        instance_pb = data_v2_pb2.Instance(name=self.INSTANCE_NAME)
-
-        klass = self._getTargetClass()
-        with self.assertRaises(ValueError):
-            klass.from_pb(instance_pb, client)
-
-    def test_name_property(self):
-        client = _Client(project=self.PROJECT)
-
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        self.assertEqual(instance.name, self.INSTANCE_NAME)
-
-    def test___eq__(self):
-        client = object()
-        instance1 = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        instance2 = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        self.assertEqual(instance1, instance2)
-
-    def test___eq__type_differ(self):
-        client = object()
-        instance1 = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        instance2 = object()
-        self.assertNotEqual(instance1, instance2)
-
-    def test___ne__same_value(self):
-        client = object()
-        instance1 = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        instance2 = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-        comparison_val = (instance1 != instance2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        instance1 = self._makeOne('instance_id1', 'client1', self.LOCATION_ID)
-        instance2 = self._makeOne('instance_id2', 'client2', self.LOCATION_ID)
-        self.assertNotEqual(instance1, instance2)
-
-    def test_reload(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-
-        # Create request_pb
-        request_pb = messages_v2_pb.GetInstanceRequest(
-            name=self.INSTANCE_NAME)
-
-        # Create response_pb
-        DISPLAY_NAME = u'hey-hi-hello'
-        response_pb = data_v2_pb2.Instance(
-            display_name=DISPLAY_NAME,
-        )
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # reload() has no return value.
-
-        # Check Instance optional config values before.
-        self.assertEqual(instance.display_name, self.INSTANCE_ID)
-
-        # Perform the method and check the result.
-        result = instance.reload()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'GetInstance',
-            (request_pb,),
-            {},
-        )])
-
-        # Check Instance optional config values before.
-        self.assertEqual(instance.display_name, DISPLAY_NAME)
-
-    def test_create(self):
-        import datetime
-        from google.longrunning import operations_pb2
-        from google.protobuf.any_pb2 import Any
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb2)
-        from google.cloud._helpers import _datetime_to_pb_timestamp
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.operation import Operation
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-        from google.cloud.bigtable.instance import (
-            _CREATE_INSTANCE_METADATA_URL)
-
-        NOW = datetime.datetime.utcnow()
-        NOW_PB = _datetime_to_pb_timestamp(NOW)
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID,
-                                 display_name=self.DISPLAY_NAME)
-
-        # Create response_pb
-        metadata = messages_v2_pb2.CreateInstanceMetadata(request_time=NOW_PB)
-        response_pb = operations_pb2.Operation(
-            name=self.OP_NAME,
-            metadata=Any(
-                type_url=_CREATE_INSTANCE_METADATA_URL,
-                value=metadata.SerializeToString(),
-                )
-            )
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Perform the method and check the result.
-        result = instance.create()
-
-        self.assertIsInstance(result, Operation)
-        self.assertEqual(result.name, self.OP_NAME)
-        self.assertIs(result.target, instance)
-        self.assertIs(result.client, client)
-        self.assertIsInstance(result.pb_metadata,
-                              messages_v2_pb2.CreateInstanceMetadata)
-        self.assertEqual(result.pb_metadata.request_time, NOW_PB)
-        self.assertEqual(result.metadata, {'request_type': 'CreateInstance'})
-
-        self.assertEqual(len(stub.method_calls), 1)
-        api_name, args, kwargs = stub.method_calls[0]
-        self.assertEqual(api_name, 'CreateInstance')
-        request_pb, = args
-        self.assertIsInstance(request_pb,
-                              messages_v2_pb2.CreateInstanceRequest)
-        self.assertEqual(request_pb.parent, 'projects/%s' % (self.PROJECT,))
-        self.assertEqual(request_pb.instance_id, self.INSTANCE_ID)
-        self.assertEqual(request_pb.instance.display_name, self.DISPLAY_NAME)
-        cluster = request_pb.clusters[self.INSTANCE_ID]
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-        self.assertEqual(kwargs, {})
-
-    def test_create_w_explicit_serve_nodes(self):
-        from google.longrunning import operations_pb2
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.operation import Operation
-
-        SERVE_NODES = 5
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID,
-                                 serve_nodes=SERVE_NODES)
-
-        # Create response_pb
-        response_pb = operations_pb2.Operation(name=self.OP_NAME)
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Perform the method and check the result.
-        result = instance.create()
-
-        self.assertIsInstance(result, Operation)
-        self.assertEqual(result.name, self.OP_NAME)
-        self.assertIs(result.target, instance)
-        self.assertIs(result.client, client)
-
-        self.assertEqual(len(stub.method_calls), 1)
-        api_name, args, kwargs = stub.method_calls[0]
-        self.assertEqual(api_name, 'CreateInstance')
-        request_pb, = args
-        self.assertIsInstance(request_pb,
-                              messages_v2_pb2.CreateInstanceRequest)
-        self.assertEqual(request_pb.parent, 'projects/%s' % (self.PROJECT,))
-        self.assertEqual(request_pb.instance_id, self.INSTANCE_ID)
-        self.assertEqual(request_pb.instance.display_name, self.INSTANCE_ID)
-        cluster = request_pb.clusters[self.INSTANCE_ID]
-        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
-        self.assertEqual(kwargs, {})
-
-    def test_update(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID,
-                                 display_name=self.DISPLAY_NAME)
-
-        # Create request_pb
-        request_pb = data_v2_pb2.Instance(
-            name=self.INSTANCE_NAME,
-            display_name=self.DISPLAY_NAME,
-        )
-
-        # Create response_pb
-        response_pb = data_v2_pb2.Instance()
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None
-
-        # Perform the method and check the result.
-        result = instance.update()
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'UpdateInstance',
-            (request_pb,),
-            {},
-        )])
-
-    def test_delete(self):
-        from google.protobuf import empty_pb2
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-
-        # Create request_pb
-        request_pb = messages_v2_pb.DeleteInstanceRequest(
-            name=self.INSTANCE_NAME)
-
-        # Create response_pb
-        response_pb = empty_pb2.Empty()
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # delete() has no return value.
-
-        # Perform the method and check the result.
-        result = instance.delete()
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'DeleteInstance',
-            (request_pb,),
-            {},
-        )])
-
-    def test_list_clusters(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as instance_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        FAILED_LOCATION = 'FAILED'
-        FAILED_LOCATIONS = [FAILED_LOCATION]
-        CLUSTER_ID1 = 'cluster-id1'
-        CLUSTER_ID2 = 'cluster-id2'
-        SERVE_NODES = 4
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-
-        CLUSTER_NAME1 = (instance.name + '/clusters/' + CLUSTER_ID1)
-        CLUSTER_NAME2 = (instance.name + '/clusters/' + CLUSTER_ID2)
-        # Create request_pb
-        request_pb = messages_v2_pb2.ListClustersRequest(
-            parent=instance.name,
-        )
-
-        # Create response_pb
-        response_pb = messages_v2_pb2.ListClustersResponse(
-            failed_locations=[FAILED_LOCATION],
-            clusters=[
-                instance_v2_pb2.Cluster(
-                    name=CLUSTER_NAME1,
-                    serve_nodes=SERVE_NODES,
-                ),
-                instance_v2_pb2.Cluster(
-                    name=CLUSTER_NAME2,
-                    serve_nodes=SERVE_NODES,
-                ),
-            ],
-        )
-
-        # Patch the stub used by the API method.
-        client._instance_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        clusters = [
-            instance.cluster(CLUSTER_ID1),
-            instance.cluster(CLUSTER_ID2),
-        ]
-        expected_result = (clusters, FAILED_LOCATIONS)
-
-        # Perform the method and check the result.
-        result = instance.list_clusters()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ListClusters',
-            (request_pb,),
-            {},
-        )])
-
-    def _list_tables_helper(self, table_name=None):
-        from google.cloud.bigtable._generated import (
-            table_pb2 as table_data_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_table_admin_pb2 as table_messages_v1_pb2)
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client(self.PROJECT)
-        instance = self._makeOne(self.INSTANCE_ID, client, self.LOCATION_ID)
-
-        # Create request_
-        request_pb = table_messages_v1_pb2.ListTablesRequest(
-            parent=self.INSTANCE_NAME)
-
-        # Create response_pb
-        if table_name is None:
-            table_name = self.TABLE_NAME
-
-        response_pb = table_messages_v1_pb2.ListTablesResponse(
-            tables=[
-                table_data_v2_pb2.Table(name=table_name),
-            ],
-        )
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_table = instance.table(self.TABLE_ID)
-        expected_result = [expected_table]
-
-        # Perform the method and check the result.
-        result = instance.list_tables()
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ListTables',
-            (request_pb,),
-            {},
-        )])
-
-    def test_list_tables(self):
-        self._list_tables_helper()
-
-    def test_list_tables_failure_bad_split(self):
-        with self.assertRaises(ValueError):
-            self._list_tables_helper(table_name='wrong-format')
-
-    def test_list_tables_failure_name_bad_before(self):
-        BAD_TABLE_NAME = ('nonempty-section-before' +
-                          'projects/' + self.PROJECT +
-                          '/instances/' + self.INSTANCE_ID +
-                          '/tables/' + self.TABLE_ID)
-        with self.assertRaises(ValueError):
-            self._list_tables_helper(table_name=BAD_TABLE_NAME)
-
-
-class Test__prepare_create_request(unittest.TestCase):
-    PROJECT = 'PROJECT'
-    PARENT = 'projects/' + PROJECT
-    LOCATION_ID = 'locname'
-    LOCATION_NAME = 'projects/' + PROJECT + '/locations/' + LOCATION_ID
-    INSTANCE_ID = 'instance-id'
-    INSTANCE_NAME = PARENT + '/instances/' + INSTANCE_ID
-    CLUSTER_NAME = INSTANCE_NAME + '/clusters/' + INSTANCE_ID
-
-    def _callFUT(self, instance, **kw):
-        from google.cloud.bigtable.instance import _prepare_create_request
-        return _prepare_create_request(instance, **kw)
-
-    def test_w_defaults(self):
-        from google.cloud.bigtable.cluster import DEFAULT_SERVE_NODES
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb)
-        from google.cloud.bigtable.instance import Instance
-
-        client = _Client(self.PROJECT)
-
-        instance = Instance(self.INSTANCE_ID, client, self.LOCATION_ID)
-        request_pb = self._callFUT(instance)
-        self.assertIsInstance(request_pb,
-                              messages_v2_pb.CreateInstanceRequest)
-        self.assertEqual(request_pb.instance_id, self.INSTANCE_ID)
-        self.assertEqual(request_pb.parent, self.PARENT)
-        self.assertIsInstance(request_pb.instance, data_v2_pb2.Instance)
-        self.assertEqual(request_pb.instance.name, u'')
-        self.assertEqual(request_pb.instance.display_name, self.INSTANCE_ID)
-
-        # An instance must also define a same-named cluster
-        cluster = request_pb.clusters[self.INSTANCE_ID]
-        self.assertIsInstance(cluster, data_v2_pb2.Cluster)
-        self.assertEqual(cluster.name, self.CLUSTER_NAME)
-        self.assertEqual(cluster.location, self.LOCATION_NAME)
-        self.assertEqual(cluster.serve_nodes, DEFAULT_SERVE_NODES)
-
-    def test_w_explicit_serve_nodes(self):
-        from google.cloud.bigtable._generated import (
-            instance_pb2 as data_v2_pb2)
-        from google.cloud.bigtable._generated import (
-            bigtable_instance_admin_pb2 as messages_v2_pb)
-        from google.cloud.bigtable.instance import Instance
-        DISPLAY_NAME = u'DISPLAY_NAME'
-        SERVE_NODES = 5
-        client = _Client(self.PROJECT)
-        instance = Instance(self.INSTANCE_ID, client, self.LOCATION_ID,
-                            display_name=DISPLAY_NAME,
-                            serve_nodes=SERVE_NODES)
-
-        request_pb = self._callFUT(instance)
-
-        self.assertIsInstance(request_pb,
-                              messages_v2_pb.CreateInstanceRequest)
-        self.assertEqual(request_pb.instance_id, self.INSTANCE_ID)
-        self.assertEqual(request_pb.parent,
-                         'projects/' + self.PROJECT)
-        self.assertIsInstance(request_pb.instance, data_v2_pb2.Instance)
-        self.assertEqual(request_pb.instance.display_name, DISPLAY_NAME)
-        # An instance must also define a same-named cluster
-        cluster = request_pb.clusters[self.INSTANCE_ID]
-        self.assertIsInstance(cluster, data_v2_pb2.Cluster)
-        self.assertEqual(cluster.location, self.LOCATION_NAME)
-        self.assertEqual(cluster.serve_nodes, SERVE_NODES)
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-        self.project_name = 'projects/' + self.project
-
-    def copy(self):
-        from copy import deepcopy
-        return deepcopy(self)
-
-    def __eq__(self, other):
-        return (other.project == self.project and
-                other.project_name == self.project_name)
diff --git a/unit_tests/bigtable/test_row.py b/unit_tests/bigtable/test_row.py
deleted file mode 100644
index cd950f33f898..000000000000
--- a/unit_tests/bigtable/test_row.py
+++ /dev/null
@@ -1,909 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-
-import unittest
-
-
-class Test_SetDeleteRow(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row import _SetDeleteRow
-        return _SetDeleteRow
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test__get_mutations_virtual(self):
-        row = self._makeOne(b'row-key', None)
-        with self.assertRaises(NotImplementedError):
-            row._get_mutations(None)
-
-
-class TestDirectRow(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row import DirectRow
-        return DirectRow
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        row_key = b'row_key'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._row_key, row_key)
-        self.assertIs(row._table, table)
-        self.assertEqual(row._pb_mutations, [])
-
-    def test_constructor_with_unicode(self):
-        row_key = u'row_key'
-        row_key_bytes = b'row_key'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._row_key, row_key_bytes)
-        self.assertIs(row._table, table)
-
-    def test_constructor_with_non_bytes(self):
-        row_key = object()
-        with self.assertRaises(TypeError):
-            self._makeOne(row_key, None)
-
-    def test__get_mutations(self):
-        row_key = b'row_key'
-        row = self._makeOne(row_key, None)
-
-        row._pb_mutations = mutations = object()
-        self.assertIs(mutations, row._get_mutations(None))
-
-    def _set_cell_helper(self, column=None, column_bytes=None,
-                         value=b'foobar', timestamp=None,
-                         timestamp_micros=-1):
-        import six
-        import struct
-        row_key = b'row_key'
-        column_family_id = u'column_family_id'
-        if column is None:
-            column = b'column'
-        table = object()
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._pb_mutations, [])
-        row.set_cell(column_family_id, column,
-                     value, timestamp=timestamp)
-
-        if isinstance(value, six.integer_types):
-            value = struct.pack('>q', value)
-        expected_pb = _MutationPB(
-            set_cell=_MutationSetCellPB(
-                family_name=column_family_id,
-                column_qualifier=column_bytes or column,
-                timestamp_micros=timestamp_micros,
-                value=value,
-            ),
-        )
-        self.assertEqual(row._pb_mutations, [expected_pb])
-
-    def test_set_cell(self):
-        self._set_cell_helper()
-
-    def test_set_cell_with_string_column(self):
-        column_bytes = b'column'
-        column_non_bytes = u'column'
-        self._set_cell_helper(column=column_non_bytes,
-                              column_bytes=column_bytes)
-
-    def test_set_cell_with_integer_value(self):
-        value = 1337
-        self._set_cell_helper(value=value)
-
-    def test_set_cell_with_non_bytes_value(self):
-        row_key = b'row_key'
-        column = b'column'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        value = object()  # Not bytes
-        with self.assertRaises(TypeError):
-            row.set_cell(column_family_id, column, value)
-
-    def test_set_cell_with_non_null_timestamp(self):
-        import datetime
-        from google.cloud._helpers import _EPOCH
-
-        microseconds = 898294371
-        millis_granularity = microseconds - (microseconds % 1000)
-        timestamp = _EPOCH + datetime.timedelta(microseconds=microseconds)
-        self._set_cell_helper(timestamp=timestamp,
-                              timestamp_micros=millis_granularity)
-
-    def test_delete(self):
-        row_key = b'row_key'
-        row = self._makeOne(row_key, object())
-        self.assertEqual(row._pb_mutations, [])
-        row.delete()
-
-        expected_pb = _MutationPB(
-            delete_from_row=_MutationDeleteFromRowPB(),
-        )
-        self.assertEqual(row._pb_mutations, [expected_pb])
-
-    def test_delete_cell(self):
-        klass = self._getTargetClass()
-
-        class MockRow(klass):
-
-            def __init__(self, *args, **kwargs):
-                super(MockRow, self).__init__(*args, **kwargs)
-                self._args = []
-                self._kwargs = []
-
-            # Replace the called method with one that logs arguments.
-            def _delete_cells(self, *args, **kwargs):
-                self._args.append(args)
-                self._kwargs.append(kwargs)
-
-        row_key = b'row_key'
-        column = b'column'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        mock_row = MockRow(row_key, table)
-        # Make sure no values are set before calling the method.
-        self.assertEqual(mock_row._pb_mutations, [])
-        self.assertEqual(mock_row._args, [])
-        self.assertEqual(mock_row._kwargs, [])
-
-        # Actually make the request against the mock class.
-        time_range = object()
-        mock_row.delete_cell(column_family_id, column, time_range=time_range)
-        self.assertEqual(mock_row._pb_mutations, [])
-        self.assertEqual(mock_row._args, [(column_family_id, [column])])
-        self.assertEqual(mock_row._kwargs, [{
-            'state': None,
-            'time_range': time_range,
-        }])
-
-    def test_delete_cells_non_iterable(self):
-        row_key = b'row_key'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        columns = object()  # Not iterable
-        with self.assertRaises(TypeError):
-            row.delete_cells(column_family_id, columns)
-
-    def test_delete_cells_all_columns(self):
-        row_key = b'row_key'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        klass = self._getTargetClass()
-        self.assertEqual(row._pb_mutations, [])
-        row.delete_cells(column_family_id, klass.ALL_COLUMNS)
-
-        expected_pb = _MutationPB(
-            delete_from_family=_MutationDeleteFromFamilyPB(
-                family_name=column_family_id,
-            ),
-        )
-        self.assertEqual(row._pb_mutations, [expected_pb])
-
-    def test_delete_cells_no_columns(self):
-        row_key = b'row_key'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        columns = []
-        self.assertEqual(row._pb_mutations, [])
-        row.delete_cells(column_family_id, columns)
-        self.assertEqual(row._pb_mutations, [])
-
-    def _delete_cells_helper(self, time_range=None):
-        row_key = b'row_key'
-        column = b'column'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        columns = [column]
-        self.assertEqual(row._pb_mutations, [])
-        row.delete_cells(column_family_id, columns, time_range=time_range)
-
-        expected_pb = _MutationPB(
-            delete_from_column=_MutationDeleteFromColumnPB(
-                family_name=column_family_id,
-                column_qualifier=column,
-            ),
-        )
-        if time_range is not None:
-            expected_pb.delete_from_column.time_range.CopyFrom(
-                time_range.to_pb())
-        self.assertEqual(row._pb_mutations, [expected_pb])
-
-    def test_delete_cells_no_time_range(self):
-        self._delete_cells_helper()
-
-    def test_delete_cells_with_time_range(self):
-        import datetime
-        from google.cloud._helpers import _EPOCH
-        from google.cloud.bigtable.row_filters import TimestampRange
-
-        microseconds = 30871000  # Makes sure already milliseconds granularity
-        start = _EPOCH + datetime.timedelta(microseconds=microseconds)
-        time_range = TimestampRange(start=start)
-        self._delete_cells_helper(time_range=time_range)
-
-    def test_delete_cells_with_bad_column(self):
-        # This makes sure a failure on one of the columns doesn't leave
-        # the row's mutations in a bad state.
-        row_key = b'row_key'
-        column = b'column'
-        column_family_id = u'column_family_id'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        columns = [column, object()]
-        self.assertEqual(row._pb_mutations, [])
-        with self.assertRaises(TypeError):
-            row.delete_cells(column_family_id, columns)
-        self.assertEqual(row._pb_mutations, [])
-
-    def test_delete_cells_with_string_columns(self):
-        row_key = b'row_key'
-        column_family_id = u'column_family_id'
-        column1 = u'column1'
-        column1_bytes = b'column1'
-        column2 = u'column2'
-        column2_bytes = b'column2'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        columns = [column1, column2]
-        self.assertEqual(row._pb_mutations, [])
-        row.delete_cells(column_family_id, columns)
-
-        expected_pb1 = _MutationPB(
-            delete_from_column=_MutationDeleteFromColumnPB(
-                family_name=column_family_id,
-                column_qualifier=column1_bytes,
-            ),
-        )
-        expected_pb2 = _MutationPB(
-            delete_from_column=_MutationDeleteFromColumnPB(
-                family_name=column_family_id,
-                column_qualifier=column2_bytes,
-            ),
-        )
-        self.assertEqual(row._pb_mutations, [expected_pb1, expected_pb2])
-
-    def test_commit(self):
-        from google.protobuf import empty_pb2
-        from unit_tests.bigtable._testing import _FakeStub
-
-        row_key = b'row_key'
-        table_name = 'projects/more-stuff'
-        column_family_id = u'column_family_id'
-        column = b'column'
-        client = _Client()
-        table = _Table(table_name, client=client)
-        row = self._makeOne(row_key, table)
-
-        # Create request_pb
-        value = b'bytes-value'
-        mutation = _MutationPB(
-            set_cell=_MutationSetCellPB(
-                family_name=column_family_id,
-                column_qualifier=column,
-                timestamp_micros=-1,  # Default value.
-                value=value,
-            ),
-        )
-        request_pb = _MutateRowRequestPB(
-            table_name=table_name,
-            row_key=row_key,
-            mutations=[mutation],
-        )
-
-        # Create response_pb
-        response_pb = empty_pb2.Empty()
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # commit() has no return value when no filter.
-
-        # Perform the method and check the result.
-        row.set_cell(column_family_id, column, value)
-        result = row.commit()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'MutateRow',
-            (request_pb,),
-            {},
-        )])
-        self.assertEqual(row._pb_mutations, [])
-
-    def test_commit_too_many_mutations(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import row as MUT
-
-        row_key = b'row_key'
-        table = object()
-        row = self._makeOne(row_key, table)
-        row._pb_mutations = [1, 2, 3]
-        num_mutations = len(row._pb_mutations)
-        with _Monkey(MUT, MAX_MUTATIONS=num_mutations - 1):
-            with self.assertRaises(ValueError):
-                row.commit()
-
-    def test_commit_no_mutations(self):
-        from unit_tests.bigtable._testing import _FakeStub
-
-        row_key = b'row_key'
-        client = _Client()
-        table = _Table(None, client=client)
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._pb_mutations, [])
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub()
-
-        # Perform the method and check the result.
-        result = row.commit()
-        self.assertIsNone(result)
-        # Make sure no request was sent.
-        self.assertEqual(stub.method_calls, [])
-
-
-class TestConditionalRow(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row import ConditionalRow
-        return ConditionalRow
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        row_key = b'row_key'
-        table = object()
-        filter_ = object()
-
-        row = self._makeOne(row_key, table, filter_=filter_)
-        self.assertEqual(row._row_key, row_key)
-        self.assertIs(row._table, table)
-        self.assertIs(row._filter, filter_)
-        self.assertEqual(row._true_pb_mutations, [])
-        self.assertEqual(row._false_pb_mutations, [])
-
-    def test__get_mutations(self):
-        row_key = b'row_key'
-        filter_ = object()
-        row = self._makeOne(row_key, None, filter_=filter_)
-
-        row._true_pb_mutations = true_mutations = object()
-        row._false_pb_mutations = false_mutations = object()
-        self.assertIs(true_mutations, row._get_mutations(True))
-        self.assertIs(false_mutations, row._get_mutations(False))
-        self.assertIs(false_mutations, row._get_mutations(None))
-
-    def test_commit(self):
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-
-        row_key = b'row_key'
-        table_name = 'projects/more-stuff'
-        column_family_id1 = u'column_family_id1'
-        column_family_id2 = u'column_family_id2'
-        column_family_id3 = u'column_family_id3'
-        column1 = b'column1'
-        column2 = b'column2'
-        client = _Client()
-        table = _Table(table_name, client=client)
-        row_filter = RowSampleFilter(0.33)
-        row = self._makeOne(row_key, table, filter_=row_filter)
-
-        # Create request_pb
-        value1 = b'bytes-value'
-        mutation1 = _MutationPB(
-            set_cell=_MutationSetCellPB(
-                family_name=column_family_id1,
-                column_qualifier=column1,
-                timestamp_micros=-1,  # Default value.
-                value=value1,
-            ),
-        )
-        mutation2 = _MutationPB(
-            delete_from_row=_MutationDeleteFromRowPB(),
-        )
-        mutation3 = _MutationPB(
-            delete_from_column=_MutationDeleteFromColumnPB(
-                family_name=column_family_id2,
-                column_qualifier=column2,
-            ),
-        )
-        mutation4 = _MutationPB(
-            delete_from_family=_MutationDeleteFromFamilyPB(
-                family_name=column_family_id3,
-            ),
-        )
-        request_pb = _CheckAndMutateRowRequestPB(
-            table_name=table_name,
-            row_key=row_key,
-            predicate_filter=row_filter.to_pb(),
-            true_mutations=[mutation1, mutation3, mutation4],
-            false_mutations=[mutation2],
-        )
-
-        # Create response_pb
-        predicate_matched = True
-        response_pb = _CheckAndMutateRowResponsePB(
-            predicate_matched=predicate_matched)
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = predicate_matched
-
-        # Perform the method and check the result.
-        row.set_cell(column_family_id1, column1, value1, state=True)
-        row.delete(state=False)
-        row.delete_cell(column_family_id2, column2, state=True)
-        row.delete_cells(column_family_id3, row.ALL_COLUMNS, state=True)
-        result = row.commit()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'CheckAndMutateRow',
-            (request_pb,),
-            {},
-        )])
-        self.assertEqual(row._true_pb_mutations, [])
-        self.assertEqual(row._false_pb_mutations, [])
-
-    def test_commit_too_many_mutations(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import row as MUT
-
-        row_key = b'row_key'
-        table = object()
-        filter_ = object()
-        row = self._makeOne(row_key, table, filter_=filter_)
-        row._true_pb_mutations = [1, 2, 3]
-        num_mutations = len(row._true_pb_mutations)
-        with _Monkey(MUT, MAX_MUTATIONS=num_mutations - 1):
-            with self.assertRaises(ValueError):
-                row.commit()
-
-    def test_commit_no_mutations(self):
-        from unit_tests.bigtable._testing import _FakeStub
-
-        row_key = b'row_key'
-        client = _Client()
-        table = _Table(None, client=client)
-        filter_ = object()
-        row = self._makeOne(row_key, table, filter_=filter_)
-        self.assertEqual(row._true_pb_mutations, [])
-        self.assertEqual(row._false_pb_mutations, [])
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub()
-
-        # Perform the method and check the result.
-        result = row.commit()
-        self.assertIsNone(result)
-        # Make sure no request was sent.
-        self.assertEqual(stub.method_calls, [])
-
-
-class TestAppendRow(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row import AppendRow
-        return AppendRow
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        row_key = b'row_key'
-        table = object()
-
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._row_key, row_key)
-        self.assertIs(row._table, table)
-        self.assertEqual(row._rule_pb_list, [])
-
-    def test_clear(self):
-        row_key = b'row_key'
-        table = object()
-        row = self._makeOne(row_key, table)
-        row._rule_pb_list = [1, 2, 3]
-        row.clear()
-        self.assertEqual(row._rule_pb_list, [])
-
-    def test_append_cell_value(self):
-        table = object()
-        row_key = b'row_key'
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._rule_pb_list, [])
-
-        column = b'column'
-        column_family_id = u'column_family_id'
-        value = b'bytes-val'
-        row.append_cell_value(column_family_id, column, value)
-        expected_pb = _ReadModifyWriteRulePB(
-            family_name=column_family_id, column_qualifier=column,
-            append_value=value)
-        self.assertEqual(row._rule_pb_list, [expected_pb])
-
-    def test_increment_cell_value(self):
-        table = object()
-        row_key = b'row_key'
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._rule_pb_list, [])
-
-        column = b'column'
-        column_family_id = u'column_family_id'
-        int_value = 281330
-        row.increment_cell_value(column_family_id, column, int_value)
-        expected_pb = _ReadModifyWriteRulePB(
-            family_name=column_family_id, column_qualifier=column,
-            increment_amount=int_value)
-        self.assertEqual(row._rule_pb_list, [expected_pb])
-
-    def test_commit(self):
-        from unit_tests._testing import _Monkey
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable import row as MUT
-
-        row_key = b'row_key'
-        table_name = 'projects/more-stuff'
-        column_family_id = u'column_family_id'
-        column = b'column'
-        client = _Client()
-        table = _Table(table_name, client=client)
-        row = self._makeOne(row_key, table)
-
-        # Create request_pb
-        value = b'bytes-value'
-        # We will call row.append_cell_value(COLUMN_FAMILY_ID, COLUMN, value).
-        request_pb = _ReadModifyWriteRowRequestPB(
-            table_name=table_name,
-            row_key=row_key,
-            rules=[
-                _ReadModifyWriteRulePB(
-                    family_name=column_family_id,
-                    column_qualifier=column,
-                    append_value=value,
-                ),
-            ],
-        )
-
-        # Create response_pb
-        response_pb = object()
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        row_responses = []
-        expected_result = object()
-
-        def mock_parse_rmw_row_response(row_response):
-            row_responses.append(row_response)
-            return expected_result
-
-        # Perform the method and check the result.
-        with _Monkey(MUT, _parse_rmw_row_response=mock_parse_rmw_row_response):
-            row.append_cell_value(column_family_id, column, value)
-            result = row.commit()
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ReadModifyWriteRow',
-            (request_pb,),
-            {},
-        )])
-        self.assertEqual(row_responses, [response_pb])
-        self.assertEqual(row._rule_pb_list, [])
-
-    def test_commit_no_rules(self):
-        from unit_tests.bigtable._testing import _FakeStub
-
-        row_key = b'row_key'
-        client = _Client()
-        table = _Table(None, client=client)
-        row = self._makeOne(row_key, table)
-        self.assertEqual(row._rule_pb_list, [])
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub()
-
-        # Perform the method and check the result.
-        result = row.commit()
-        self.assertEqual(result, {})
-        # Make sure no request was sent.
-        self.assertEqual(stub.method_calls, [])
-
-    def test_commit_too_many_mutations(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.bigtable import row as MUT
-
-        row_key = b'row_key'
-        table = object()
-        row = self._makeOne(row_key, table)
-        row._rule_pb_list = [1, 2, 3]
-        num_mutations = len(row._rule_pb_list)
-        with _Monkey(MUT, MAX_MUTATIONS=num_mutations - 1):
-            with self.assertRaises(ValueError):
-                row.commit()
-
-
-class Test__parse_rmw_row_response(unittest.TestCase):
-
-    def _callFUT(self, row_response):
-        from google.cloud.bigtable.row import _parse_rmw_row_response
-        return _parse_rmw_row_response(row_response)
-
-    def test_it(self):
-        from google.cloud._helpers import _datetime_from_microseconds
-        col_fam1 = u'col-fam-id'
-        col_fam2 = u'col-fam-id2'
-        col_name1 = b'col-name1'
-        col_name2 = b'col-name2'
-        col_name3 = b'col-name3-but-other-fam'
-        cell_val1 = b'cell-val'
-        cell_val2 = b'cell-val-newer'
-        cell_val3 = b'altcol-cell-val'
-        cell_val4 = b'foo'
-
-        microseconds = 1000871
-        timestamp = _datetime_from_microseconds(microseconds)
-        expected_output = {
-            col_fam1: {
-                col_name1: [
-                    (cell_val1, timestamp),
-                    (cell_val2, timestamp),
-                ],
-                col_name2: [
-                    (cell_val3, timestamp),
-                ],
-            },
-            col_fam2: {
-                col_name3: [
-                    (cell_val4, timestamp),
-                ],
-            },
-        }
-        response_row = _RowPB(
-            families=[
-                _FamilyPB(
-                    name=col_fam1,
-                    columns=[
-                        _ColumnPB(
-                            qualifier=col_name1,
-                            cells=[
-                                _CellPB(
-                                    value=cell_val1,
-                                    timestamp_micros=microseconds,
-                                ),
-                                _CellPB(
-                                    value=cell_val2,
-                                    timestamp_micros=microseconds,
-                                ),
-                            ],
-                        ),
-                        _ColumnPB(
-                            qualifier=col_name2,
-                            cells=[
-                                _CellPB(
-                                    value=cell_val3,
-                                    timestamp_micros=microseconds,
-                                ),
-                            ],
-                        ),
-                    ],
-                ),
-                _FamilyPB(
-                    name=col_fam2,
-                    columns=[
-                        _ColumnPB(
-                            qualifier=col_name3,
-                            cells=[
-                                _CellPB(
-                                    value=cell_val4,
-                                    timestamp_micros=microseconds,
-                                ),
-                            ],
-                        ),
-                    ],
-                ),
-            ],
-        )
-        sample_input = _ReadModifyWriteRowResponsePB(row=response_row)
-        self.assertEqual(expected_output, self._callFUT(sample_input))
-
-
-class Test__parse_family_pb(unittest.TestCase):
-
-    def _callFUT(self, family_pb):
-        from google.cloud.bigtable.row import _parse_family_pb
-        return _parse_family_pb(family_pb)
-
-    def test_it(self):
-        from google.cloud._helpers import _datetime_from_microseconds
-        col_fam1 = u'col-fam-id'
-        col_name1 = b'col-name1'
-        col_name2 = b'col-name2'
-        cell_val1 = b'cell-val'
-        cell_val2 = b'cell-val-newer'
-        cell_val3 = b'altcol-cell-val'
-
-        microseconds = 5554441037
-        timestamp = _datetime_from_microseconds(microseconds)
-        expected_dict = {
-            col_name1: [
-                (cell_val1, timestamp),
-                (cell_val2, timestamp),
-            ],
-            col_name2: [
-                (cell_val3, timestamp),
-            ],
-        }
-        expected_output = (col_fam1, expected_dict)
-        sample_input = _FamilyPB(
-            name=col_fam1,
-            columns=[
-                _ColumnPB(
-                    qualifier=col_name1,
-                    cells=[
-                        _CellPB(
-                            value=cell_val1,
-                            timestamp_micros=microseconds,
-                        ),
-                        _CellPB(
-                            value=cell_val2,
-                            timestamp_micros=microseconds,
-                        ),
-                    ],
-                ),
-                _ColumnPB(
-                    qualifier=col_name2,
-                    cells=[
-                        _CellPB(
-                            value=cell_val3,
-                            timestamp_micros=microseconds,
-                        ),
-                    ],
-                ),
-            ],
-        )
-        self.assertEqual(expected_output, self._callFUT(sample_input))
-
-
-def _CheckAndMutateRowRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.CheckAndMutateRowRequest(*args, **kw)
-
-
-def _CheckAndMutateRowResponsePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.CheckAndMutateRowResponse(*args, **kw)
-
-
-def _MutateRowRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.MutateRowRequest(*args, **kw)
-
-
-def _ReadModifyWriteRowRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.ReadModifyWriteRowRequest(*args, **kw)
-
-
-def _ReadModifyWriteRowResponsePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.ReadModifyWriteRowResponse(*args, **kw)
-
-
-def _CellPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Cell(*args, **kw)
-
-
-def _ColumnPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Column(*args, **kw)
-
-
-def _FamilyPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Family(*args, **kw)
-
-
-def _MutationPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Mutation(*args, **kw)
-
-
-def _MutationSetCellPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Mutation.SetCell(*args, **kw)
-
-
-def _MutationDeleteFromColumnPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Mutation.DeleteFromColumn(*args, **kw)
-
-
-def _MutationDeleteFromFamilyPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Mutation.DeleteFromFamily(*args, **kw)
-
-
-def _MutationDeleteFromRowPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Mutation.DeleteFromRow(*args, **kw)
-
-
-def _RowPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.Row(*args, **kw)
-
-
-def _ReadModifyWriteRulePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.ReadModifyWriteRule(*args, **kw)
-
-
-class _Client(object):
-
-    data_stub = None
-
-
-class _Instance(object):
-
-    def __init__(self, client=None):
-        self._client = client
-
-
-class _Table(object):
-
-    def __init__(self, name, client=None):
-        self.name = name
-        self._instance = _Instance(client)
diff --git a/unit_tests/bigtable/test_row_data.py b/unit_tests/bigtable/test_row_data.py
deleted file mode 100644
index 7c3867c4861f..000000000000
--- a/unit_tests/bigtable/test_row_data.py
+++ /dev/null
@@ -1,730 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-
-import unittest
-
-
-class TestCell(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_data import Cell
-        return Cell
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def _from_pb_test_helper(self, labels=None):
-        import datetime
-        from google.cloud._helpers import _EPOCH
-        from google.cloud.bigtable._generated import (
-            data_pb2 as data_v2_pb2)
-
-        timestamp_micros = 18738724000  # Make sure millis granularity
-        timestamp = _EPOCH + datetime.timedelta(microseconds=timestamp_micros)
-        value = b'value-bytes'
-
-        if labels is None:
-            cell_pb = data_v2_pb2.Cell(
-                value=value, timestamp_micros=timestamp_micros)
-            cell_expected = self._makeOne(value, timestamp)
-        else:
-            cell_pb = data_v2_pb2.Cell(
-                value=value, timestamp_micros=timestamp_micros, labels=labels)
-            cell_expected = self._makeOne(value, timestamp, labels=labels)
-
-        klass = self._getTargetClass()
-        result = klass.from_pb(cell_pb)
-        self.assertEqual(result, cell_expected)
-
-    def test_from_pb(self):
-        self._from_pb_test_helper()
-
-    def test_from_pb_with_labels(self):
-        labels = [u'label1', u'label2']
-        self._from_pb_test_helper(labels)
-
-    def test_constructor(self):
-        value = object()
-        timestamp = object()
-        cell = self._makeOne(value, timestamp)
-        self.assertEqual(cell.value, value)
-        self.assertEqual(cell.timestamp, timestamp)
-
-    def test___eq__(self):
-        value = object()
-        timestamp = object()
-        cell1 = self._makeOne(value, timestamp)
-        cell2 = self._makeOne(value, timestamp)
-        self.assertEqual(cell1, cell2)
-
-    def test___eq__type_differ(self):
-        cell1 = self._makeOne(None, None)
-        cell2 = object()
-        self.assertNotEqual(cell1, cell2)
-
-    def test___ne__same_value(self):
-        value = object()
-        timestamp = object()
-        cell1 = self._makeOne(value, timestamp)
-        cell2 = self._makeOne(value, timestamp)
-        comparison_val = (cell1 != cell2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        value1 = 'value1'
-        value2 = 'value2'
-        timestamp = object()
-        cell1 = self._makeOne(value1, timestamp)
-        cell2 = self._makeOne(value2, timestamp)
-        self.assertNotEqual(cell1, cell2)
-
-
-class TestPartialRowData(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_data import PartialRowData
-        return PartialRowData
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        row_key = object()
-        partial_row_data = self._makeOne(row_key)
-        self.assertIs(partial_row_data._row_key, row_key)
-        self.assertEqual(partial_row_data._cells, {})
-
-    def test___eq__(self):
-        row_key = object()
-        partial_row_data1 = self._makeOne(row_key)
-        partial_row_data2 = self._makeOne(row_key)
-        self.assertEqual(partial_row_data1, partial_row_data2)
-
-    def test___eq__type_differ(self):
-        partial_row_data1 = self._makeOne(None)
-        partial_row_data2 = object()
-        self.assertNotEqual(partial_row_data1, partial_row_data2)
-
-    def test___ne__same_value(self):
-        row_key = object()
-        partial_row_data1 = self._makeOne(row_key)
-        partial_row_data2 = self._makeOne(row_key)
-        comparison_val = (partial_row_data1 != partial_row_data2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        row_key1 = object()
-        partial_row_data1 = self._makeOne(row_key1)
-        row_key2 = object()
-        partial_row_data2 = self._makeOne(row_key2)
-        self.assertNotEqual(partial_row_data1, partial_row_data2)
-
-    def test___ne__cells(self):
-        row_key = object()
-        partial_row_data1 = self._makeOne(row_key)
-        partial_row_data1._cells = object()
-        partial_row_data2 = self._makeOne(row_key)
-        self.assertNotEqual(partial_row_data1, partial_row_data2)
-
-    def test_to_dict(self):
-        cell1 = object()
-        cell2 = object()
-        cell3 = object()
-
-        family_name1 = u'name1'
-        family_name2 = u'name2'
-        qual1 = b'col1'
-        qual2 = b'col2'
-        qual3 = b'col3'
-
-        partial_row_data = self._makeOne(None)
-        partial_row_data._cells = {
-            family_name1: {
-                qual1: cell1,
-                qual2: cell2,
-            },
-            family_name2: {
-                qual3: cell3,
-            },
-        }
-
-        result = partial_row_data.to_dict()
-        expected_result = {
-            b'name1:col1': cell1,
-            b'name1:col2': cell2,
-            b'name2:col3': cell3,
-        }
-        self.assertEqual(result, expected_result)
-
-    def test_cells_property(self):
-        partial_row_data = self._makeOne(None)
-        cells = {1: 2}
-        partial_row_data._cells = cells
-        # Make sure we get a copy, not the original.
-        self.assertIsNot(partial_row_data.cells, cells)
-        self.assertEqual(partial_row_data.cells, cells)
-
-    def test_row_key_getter(self):
-        row_key = object()
-        partial_row_data = self._makeOne(row_key)
-        self.assertIs(partial_row_data.row_key, row_key)
-
-
-class TestPartialRowsData(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_data import PartialRowsData
-        return PartialRowsData
-
-    def _getDoNothingClass(self):
-        klass = self._getTargetClass()
-
-        class FakePartialRowsData(klass):
-
-            def __init__(self, *args, **kwargs):
-                super(FakePartialRowsData, self).__init__(*args, **kwargs)
-                self._consumed = []
-
-            def consume_next(self):
-                value = self._response_iterator.next()
-                self._consumed.append(value)
-                return value
-
-        return FakePartialRowsData
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        response_iterator = object()
-        partial_rows_data = self._makeOne(response_iterator)
-        self.assertIs(partial_rows_data._response_iterator,
-                      response_iterator)
-        self.assertEqual(partial_rows_data._rows, {})
-
-    def test___eq__(self):
-        response_iterator = object()
-        partial_rows_data1 = self._makeOne(response_iterator)
-        partial_rows_data2 = self._makeOne(response_iterator)
-        self.assertEqual(partial_rows_data1, partial_rows_data2)
-
-    def test___eq__type_differ(self):
-        partial_rows_data1 = self._makeOne(None)
-        partial_rows_data2 = object()
-        self.assertNotEqual(partial_rows_data1, partial_rows_data2)
-
-    def test___ne__same_value(self):
-        response_iterator = object()
-        partial_rows_data1 = self._makeOne(response_iterator)
-        partial_rows_data2 = self._makeOne(response_iterator)
-        comparison_val = (partial_rows_data1 != partial_rows_data2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        response_iterator1 = object()
-        partial_rows_data1 = self._makeOne(response_iterator1)
-        response_iterator2 = object()
-        partial_rows_data2 = self._makeOne(response_iterator2)
-        self.assertNotEqual(partial_rows_data1, partial_rows_data2)
-
-    def test_state_start(self):
-        prd = self._makeOne([])
-        self.assertEqual(prd.state, prd.START)
-
-    def test_state_new_row_w_row(self):
-        prd = self._makeOne([])
-        prd._last_scanned_row_key = ''
-        prd._row = object()
-        self.assertEqual(prd.state, prd.NEW_ROW)
-
-    def test_rows_getter(self):
-        partial_rows_data = self._makeOne(None)
-        partial_rows_data._rows = value = object()
-        self.assertIs(partial_rows_data.rows, value)
-
-    def test_cancel(self):
-        response_iterator = _MockCancellableIterator()
-        partial_rows_data = self._makeOne(response_iterator)
-        self.assertEqual(response_iterator.cancel_calls, 0)
-        partial_rows_data.cancel()
-        self.assertEqual(response_iterator.cancel_calls, 1)
-
-    # 'consume_nest' tested via 'TestPartialRowsData_JSON_acceptance_tests'
-
-    def test_consume_all(self):
-        klass = self._getDoNothingClass()
-
-        value1, value2, value3 = object(), object(), object()
-        response_iterator = _MockCancellableIterator(value1, value2, value3)
-        partial_rows_data = klass(response_iterator)
-        self.assertEqual(partial_rows_data._consumed, [])
-        partial_rows_data.consume_all()
-        self.assertEqual(
-            partial_rows_data._consumed, [value1, value2, value3])
-
-    def test_consume_all_with_max_loops(self):
-        klass = self._getDoNothingClass()
-
-        value1, value2, value3 = object(), object(), object()
-        response_iterator = _MockCancellableIterator(value1, value2, value3)
-        partial_rows_data = klass(response_iterator)
-        self.assertEqual(partial_rows_data._consumed, [])
-        partial_rows_data.consume_all(max_loops=1)
-        self.assertEqual(partial_rows_data._consumed, [value1])
-        # Make sure the iterator still has the remaining values.
-        self.assertEqual(
-            list(response_iterator.iter_values), [value2, value3])
-
-    def test__copy_from_current_unset(self):
-        prd = self._makeOne([])
-        chunks = _generate_cell_chunks([''])
-        chunk = chunks[0]
-        prd._copy_from_current(chunk)
-        self.assertEqual(chunk.row_key, b'')
-        self.assertEqual(chunk.family_name.value, u'')
-        self.assertEqual(chunk.qualifier.value, b'')
-        self.assertEqual(chunk.timestamp_micros, 0)
-        self.assertEqual(chunk.labels, [])
-
-    def test__copy_from_current_blank(self):
-        ROW_KEY = b'RK'
-        FAMILY_NAME = u'A'
-        QUALIFIER = b'C'
-        TIMESTAMP_MICROS = 100
-        LABELS = ['L1', 'L2']
-        prd = self._makeOne([])
-        prd._cell = _PartialCellData()
-        chunks = _generate_cell_chunks([''])
-        chunk = chunks[0]
-        chunk.row_key = ROW_KEY
-        chunk.family_name.value = FAMILY_NAME
-        chunk.qualifier.value = QUALIFIER
-        chunk.timestamp_micros = TIMESTAMP_MICROS
-        chunk.labels.extend(LABELS)
-        prd._copy_from_current(chunk)
-        self.assertEqual(chunk.row_key, ROW_KEY)
-        self.assertEqual(chunk.family_name.value, FAMILY_NAME)
-        self.assertEqual(chunk.qualifier.value, QUALIFIER)
-        self.assertEqual(chunk.timestamp_micros, TIMESTAMP_MICROS)
-        self.assertEqual(chunk.labels, LABELS)
-
-    def test__copy_from_previous_unset(self):
-        prd = self._makeOne([])
-        cell = _PartialCellData()
-        prd._copy_from_previous(cell)
-        self.assertEqual(cell.row_key, '')
-        self.assertEqual(cell.family_name, u'')
-        self.assertEqual(cell.qualifier, b'')
-        self.assertEqual(cell.timestamp_micros, 0)
-        self.assertEqual(cell.labels, [])
-
-    def test__copy_from_previous_blank(self):
-        ROW_KEY = 'RK'
-        FAMILY_NAME = u'A'
-        QUALIFIER = b'C'
-        TIMESTAMP_MICROS = 100
-        LABELS = ['L1', 'L2']
-        prd = self._makeOne([])
-        cell = _PartialCellData(
-            row_key=ROW_KEY,
-            family_name=FAMILY_NAME,
-            qualifier=QUALIFIER,
-            timestamp_micros=TIMESTAMP_MICROS,
-            labels=LABELS,
-        )
-        prd._previous_cell = _PartialCellData()
-        prd._copy_from_previous(cell)
-        self.assertEqual(cell.row_key, ROW_KEY)
-        self.assertEqual(cell.family_name, FAMILY_NAME)
-        self.assertEqual(cell.qualifier, QUALIFIER)
-        self.assertEqual(cell.timestamp_micros, TIMESTAMP_MICROS)
-        self.assertEqual(cell.labels, LABELS)
-
-    def test__copy_from_previous_filled(self):
-        ROW_KEY = 'RK'
-        FAMILY_NAME = u'A'
-        QUALIFIER = b'C'
-        TIMESTAMP_MICROS = 100
-        LABELS = ['L1', 'L2']
-        prd = self._makeOne([])
-        prd._previous_cell = _PartialCellData(
-            row_key=ROW_KEY,
-            family_name=FAMILY_NAME,
-            qualifier=QUALIFIER,
-            timestamp_micros=TIMESTAMP_MICROS,
-            labels=LABELS,
-        )
-        cell = _PartialCellData()
-        prd._copy_from_previous(cell)
-        self.assertEqual(cell.row_key, ROW_KEY)
-        self.assertEqual(cell.family_name, FAMILY_NAME)
-        self.assertEqual(cell.qualifier, QUALIFIER)
-        self.assertEqual(cell.timestamp_micros, 0)
-        self.assertEqual(cell.labels, [])
-
-    def test__save_row_no_cell(self):
-        ROW_KEY = 'RK'
-        prd = self._makeOne([])
-        row = prd._row = _Dummy(row_key=ROW_KEY)
-        prd._cell = None
-        prd._save_current_row()
-        self.assertIs(prd._rows[ROW_KEY], row)
-
-    def test_invalid_last_scanned_row_key_on_start(self):
-        from google.cloud.bigtable.row_data import InvalidReadRowsResponse
-        response = _ReadRowsResponseV2(chunks=(), last_scanned_row_key='ABC')
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        with self.assertRaises(InvalidReadRowsResponse):
-            prd.consume_next()
-
-    def test_valid_last_scanned_row_key_on_start(self):
-        response = _ReadRowsResponseV2(
-            chunks=(), last_scanned_row_key='AFTER')
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        prd._last_scanned_row_key = 'BEFORE'
-        prd.consume_next()
-        self.assertEqual(prd._last_scanned_row_key, 'AFTER')
-
-    def test_invalid_empty_chunk(self):
-        from google.cloud.bigtable.row_data import InvalidChunk
-        chunks = _generate_cell_chunks([''])
-        response = _ReadRowsResponseV2(chunks)
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        with self.assertRaises(InvalidChunk):
-            prd.consume_next()
-
-    def test_invalid_empty_second_chunk(self):
-        from google.cloud.bigtable.row_data import InvalidChunk
-        chunks = _generate_cell_chunks(['', ''])
-        first = chunks[0]
-        first.row_key = b'RK'
-        first.family_name.value = 'A'
-        first.qualifier.value = b'C'
-        response = _ReadRowsResponseV2(chunks)
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        with self.assertRaises(InvalidChunk):
-            prd.consume_next()
-
-
-class TestPartialRowsData_JSON_acceptance_tests(unittest.TestCase):
-
-    _json_tests = None
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_data import PartialRowsData
-        return PartialRowsData
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def _load_json_test(self, test_name):
-        import os
-        if self.__class__._json_tests is None:
-            dirname = os.path.dirname(__file__)
-            filename = os.path.join(dirname, 'read-rows-acceptance-test.json')
-            raw = _parse_readrows_acceptance_tests(filename)
-            tests = self.__class__._json_tests = {}
-            for (name, chunks, results) in raw:
-                tests[name] = chunks, results
-        return self.__class__._json_tests[test_name]
-
-    # JSON Error cases:  invalid chunks
-
-    def _fail_during_consume(self, testcase_name):
-        from google.cloud.bigtable.row_data import InvalidChunk
-        chunks, results = self._load_json_test(testcase_name)
-        response = _ReadRowsResponseV2(chunks)
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        with self.assertRaises(InvalidChunk):
-            prd.consume_next()
-        expected_result = self._sort_flattend_cells(
-            [result for result in results if not result['error']])
-        flattened = self._sort_flattend_cells(_flatten_cells(prd))
-        self.assertEqual(flattened, expected_result)
-
-    def test_invalid_no_cell_key_before_commit(self):
-        self._fail_during_consume('invalid - no cell key before commit')
-
-    def test_invalid_no_cell_key_before_value(self):
-        self._fail_during_consume('invalid - no cell key before value')
-
-    def test_invalid_new_col_family_wo_qualifier(self):
-        self._fail_during_consume(
-            'invalid - new col family must specify qualifier')
-
-    def test_invalid_no_commit_between_rows(self):
-        self._fail_during_consume('invalid - no commit between rows')
-
-    def test_invalid_no_commit_after_first_row(self):
-        self._fail_during_consume('invalid - no commit after first row')
-
-    def test_invalid_duplicate_row_key(self):
-        self._fail_during_consume('invalid - duplicate row key')
-
-    def test_invalid_new_row_missing_row_key(self):
-        self._fail_during_consume('invalid - new row missing row key')
-
-    def test_invalid_bare_reset(self):
-        self._fail_during_consume('invalid - bare reset')
-
-    def test_invalid_bad_reset_no_commit(self):
-        self._fail_during_consume('invalid - bad reset, no commit')
-
-    def test_invalid_missing_key_after_reset(self):
-        self._fail_during_consume('invalid - missing key after reset')
-
-    def test_invalid_reset_with_chunk(self):
-        self._fail_during_consume('invalid - reset with chunk')
-
-    def test_invalid_commit_with_chunk(self):
-        self._fail_during_consume('invalid - commit with chunk')
-
-    # JSON Error cases:  incomplete final row
-
-    def _sort_flattend_cells(self, flattened):
-        import operator
-        key_func = operator.itemgetter('rk', 'fm', 'qual')
-        return sorted(flattened, key=key_func)
-
-    def _incomplete_final_row(self, testcase_name):
-        chunks, results = self._load_json_test(testcase_name)
-        response = _ReadRowsResponseV2(chunks)
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        prd.consume_next()
-        self.assertEqual(prd.state, prd.ROW_IN_PROGRESS)
-        expected_result = self._sort_flattend_cells(
-            [result for result in results if not result['error']])
-        flattened = self._sort_flattend_cells(_flatten_cells(prd))
-        self.assertEqual(flattened, expected_result)
-
-    def test_invalid_no_commit(self):
-        self._incomplete_final_row('invalid - no commit')
-
-    def test_invalid_last_row_missing_commit(self):
-        self._incomplete_final_row('invalid - last row missing commit')
-
-    # Non-error cases
-
-    _marker = object()
-
-    def _match_results(self, testcase_name, expected_result=_marker):
-        chunks, results = self._load_json_test(testcase_name)
-        response = _ReadRowsResponseV2(chunks)
-        iterator = _MockCancellableIterator(response)
-        prd = self._makeOne(iterator)
-        prd.consume_next()
-        flattened = self._sort_flattend_cells(_flatten_cells(prd))
-        if expected_result is self._marker:
-            expected_result = self._sort_flattend_cells(results)
-        self.assertEqual(flattened, expected_result)
-
-    def test_bare_commit_implies_ts_zero(self):
-        self._match_results('bare commit implies ts=0')
-
-    def test_simple_row_with_timestamp(self):
-        self._match_results('simple row with timestamp')
-
-    def test_missing_timestamp_implies_ts_zero(self):
-        self._match_results('missing timestamp, implied ts=0')
-
-    def test_empty_cell_value(self):
-        self._match_results('empty cell value')
-
-    def test_two_unsplit_cells(self):
-        self._match_results('two unsplit cells')
-
-    def test_two_qualifiers(self):
-        self._match_results('two qualifiers')
-
-    def test_two_families(self):
-        self._match_results('two families')
-
-    def test_with_labels(self):
-        self._match_results('with labels')
-
-    def test_split_cell_bare_commit(self):
-        self._match_results('split cell, bare commit')
-
-    def test_split_cell(self):
-        self._match_results('split cell')
-
-    def test_split_four_ways(self):
-        self._match_results('split four ways')
-
-    def test_two_split_cells(self):
-        self._match_results('two split cells')
-
-    def test_multi_qualifier_splits(self):
-        self._match_results('multi-qualifier splits')
-
-    def test_multi_qualifier_multi_split(self):
-        self._match_results('multi-qualifier multi-split')
-
-    def test_multi_family_split(self):
-        self._match_results('multi-family split')
-
-    def test_two_rows(self):
-        self._match_results('two rows')
-
-    def test_two_rows_implicit_timestamp(self):
-        self._match_results('two rows implicit timestamp')
-
-    def test_two_rows_empty_value(self):
-        self._match_results('two rows empty value')
-
-    def test_two_rows_one_with_multiple_cells(self):
-        self._match_results('two rows, one with multiple cells')
-
-    def test_two_rows_multiple_cells_multiple_families(self):
-        self._match_results('two rows, multiple cells, multiple families')
-
-    def test_two_rows_multiple_cells(self):
-        self._match_results('two rows, multiple cells')
-
-    def test_two_rows_four_cells_two_labels(self):
-        self._match_results('two rows, four cells, 2 labels')
-
-    def test_two_rows_with_splits_same_timestamp(self):
-        self._match_results('two rows with splits, same timestamp')
-
-    def test_no_data_after_reset(self):
-        # JSON testcase has `"results": null`
-        self._match_results('no data after reset', expected_result=[])
-
-    def test_simple_reset(self):
-        self._match_results('simple reset')
-
-    def test_reset_to_new_val(self):
-        self._match_results('reset to new val')
-
-    def test_reset_to_new_qual(self):
-        self._match_results('reset to new qual')
-
-    def test_reset_with_splits(self):
-        self._match_results('reset with splits')
-
-    def test_two_resets(self):
-        self._match_results('two resets')
-
-    def test_reset_to_new_row(self):
-        self._match_results('reset to new row')
-
-    def test_reset_in_between_chunks(self):
-        self._match_results('reset in between chunks')
-
-    def test_empty_cell_chunk(self):
-        self._match_results('empty cell chunk')
-
-
-def _flatten_cells(prd):
-    # Match results format from JSON testcases.
-    # Doesn't handle error cases.
-    from google.cloud._helpers import _bytes_to_unicode
-    from google.cloud._helpers import _microseconds_from_datetime
-    for row_key, row in prd.rows.items():
-        for family_name, family in row.cells.items():
-            for qualifier, column in family.items():
-                for cell in column:
-                    yield {
-                        u'rk': _bytes_to_unicode(row_key),
-                        u'fm': family_name,
-                        u'qual': _bytes_to_unicode(qualifier),
-                        u'ts': _microseconds_from_datetime(cell.timestamp),
-                        u'value': _bytes_to_unicode(cell.value),
-                        u'label': u' '.join(cell.labels),
-                        u'error': False,
-                    }
-
-
-class _MockCancellableIterator(object):
-
-    cancel_calls = 0
-
-    def __init__(self, *values):
-        self.iter_values = iter(values)
-
-    def cancel(self):
-        self.cancel_calls += 1
-
-    def next(self):
-        return next(self.iter_values)
-
-    def __next__(self):  # pragma: NO COVER Py3k
-        return self.next()
-
-
-class _Dummy(object):
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-
-class _PartialCellData(object):
-
-    row_key = ''
-    family_name = u''
-    qualifier = b''
-    timestamp_micros = 0
-
-    def __init__(self, **kw):
-        self.labels = kw.pop('labels', [])
-        self.__dict__.update(kw)
-
-
-class _ReadRowsResponseV2(object):
-
-    def __init__(self, chunks, last_scanned_row_key=''):
-        self.chunks = chunks
-        self.last_scanned_row_key = last_scanned_row_key
-
-
-def _generate_cell_chunks(chunk_text_pbs):
-    from google.protobuf.text_format import Merge
-    from google.cloud.bigtable._generated.bigtable_pb2 import ReadRowsResponse
-
-    chunks = []
-
-    for chunk_text_pb in chunk_text_pbs:
-        chunk = ReadRowsResponse.CellChunk()
-        chunks.append(Merge(chunk_text_pb, chunk))
-
-    return chunks
-
-
-def _parse_readrows_acceptance_tests(filename):
-    """Parse acceptance tests from JSON
-
-    See:
-    https://github.com/GoogleCloudPlatform/cloud-bigtable-client/blob/\
-    4d3185662ca61bc9fa1bdf1ec0166f6e5ecf86c6/bigtable-client-core/src/\
-    test/resources/com/google/cloud/bigtable/grpc/scanner/v2/
-    read-rows-acceptance-test.json
-    """
-    import json
-
-    with open(filename) as json_file:
-        test_json = json.load(json_file)
-
-    for test in test_json['tests']:
-        name = test['name']
-        chunks = _generate_cell_chunks(test['chunks'])
-        results = test['results']
-        yield name, chunks, results
diff --git a/unit_tests/bigtable/test_row_filters.py b/unit_tests/bigtable/test_row_filters.py
deleted file mode 100644
index f2533f34390d..000000000000
--- a/unit_tests/bigtable/test_row_filters.py
+++ /dev/null
@@ -1,1010 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-
-import unittest
-
-
-class Test_BoolFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import _BoolFilter
-        return _BoolFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        flag = object()
-        row_filter = self._makeOne(flag)
-        self.assertIs(row_filter.flag, flag)
-
-    def test___eq__type_differ(self):
-        flag = object()
-        row_filter1 = self._makeOne(flag)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test___eq__same_value(self):
-        flag = object()
-        row_filter1 = self._makeOne(flag)
-        row_filter2 = self._makeOne(flag)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test___ne__same_value(self):
-        flag = object()
-        row_filter1 = self._makeOne(flag)
-        row_filter2 = self._makeOne(flag)
-        comparison_val = (row_filter1 != row_filter2)
-        self.assertFalse(comparison_val)
-
-
-class TestSinkFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import SinkFilter
-        return SinkFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        flag = True
-        row_filter = self._makeOne(flag)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(sink=flag)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestPassAllFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import PassAllFilter
-        return PassAllFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        flag = True
-        row_filter = self._makeOne(flag)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(pass_all_filter=flag)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestBlockAllFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import BlockAllFilter
-        return BlockAllFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        flag = True
-        row_filter = self._makeOne(flag)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(block_all_filter=flag)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class Test_RegexFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import _RegexFilter
-        return _RegexFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        regex = b'abc'
-        row_filter = self._makeOne(regex)
-        self.assertIs(row_filter.regex, regex)
-
-    def test_constructor_non_bytes(self):
-        regex = u'abc'
-        row_filter = self._makeOne(regex)
-        self.assertEqual(row_filter.regex, b'abc')
-
-    def test___eq__type_differ(self):
-        regex = b'def-rgx'
-        row_filter1 = self._makeOne(regex)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test___eq__same_value(self):
-        regex = b'trex-regex'
-        row_filter1 = self._makeOne(regex)
-        row_filter2 = self._makeOne(regex)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test___ne__same_value(self):
-        regex = b'abc'
-        row_filter1 = self._makeOne(regex)
-        row_filter2 = self._makeOne(regex)
-        comparison_val = (row_filter1 != row_filter2)
-        self.assertFalse(comparison_val)
-
-
-class TestRowKeyRegexFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import RowKeyRegexFilter
-        return RowKeyRegexFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        regex = b'row-key-regex'
-        row_filter = self._makeOne(regex)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(row_key_regex_filter=regex)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestRowSampleFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        return RowSampleFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        sample = object()
-        row_filter = self._makeOne(sample)
-        self.assertIs(row_filter.sample, sample)
-
-    def test___eq__type_differ(self):
-        sample = object()
-        row_filter1 = self._makeOne(sample)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test___eq__same_value(self):
-        sample = object()
-        row_filter1 = self._makeOne(sample)
-        row_filter2 = self._makeOne(sample)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test_to_pb(self):
-        sample = 0.25
-        row_filter = self._makeOne(sample)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(row_sample_filter=sample)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestFamilyNameRegexFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import FamilyNameRegexFilter
-        return FamilyNameRegexFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        regex = u'family-regex'
-        row_filter = self._makeOne(regex)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(family_name_regex_filter=regex)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestColumnQualifierRegexFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import (
-            ColumnQualifierRegexFilter)
-        return ColumnQualifierRegexFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        regex = b'column-regex'
-        row_filter = self._makeOne(regex)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(
-            column_qualifier_regex_filter=regex)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestTimestampRange(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import TimestampRange
-        return TimestampRange
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        start = object()
-        end = object()
-        time_range = self._makeOne(start=start, end=end)
-        self.assertIs(time_range.start, start)
-        self.assertIs(time_range.end, end)
-
-    def test___eq__(self):
-        start = object()
-        end = object()
-        time_range1 = self._makeOne(start=start, end=end)
-        time_range2 = self._makeOne(start=start, end=end)
-        self.assertEqual(time_range1, time_range2)
-
-    def test___eq__type_differ(self):
-        start = object()
-        end = object()
-        time_range1 = self._makeOne(start=start, end=end)
-        time_range2 = object()
-        self.assertNotEqual(time_range1, time_range2)
-
-    def test___ne__same_value(self):
-        start = object()
-        end = object()
-        time_range1 = self._makeOne(start=start, end=end)
-        time_range2 = self._makeOne(start=start, end=end)
-        comparison_val = (time_range1 != time_range2)
-        self.assertFalse(comparison_val)
-
-    def _to_pb_helper(self, start_micros=None, end_micros=None):
-        import datetime
-        from google.cloud._helpers import _EPOCH
-        pb_kwargs = {}
-
-        start = None
-        if start_micros is not None:
-            start = _EPOCH + datetime.timedelta(microseconds=start_micros)
-            pb_kwargs['start_timestamp_micros'] = start_micros
-        end = None
-        if end_micros is not None:
-            end = _EPOCH + datetime.timedelta(microseconds=end_micros)
-            pb_kwargs['end_timestamp_micros'] = end_micros
-        time_range = self._makeOne(start=start, end=end)
-
-        expected_pb = _TimestampRangePB(**pb_kwargs)
-        self.assertEqual(time_range.to_pb(), expected_pb)
-
-    def test_to_pb(self):
-        # Makes sure already milliseconds granularity
-        start_micros = 30871000
-        end_micros = 12939371000
-        self._to_pb_helper(start_micros=start_micros,
-                           end_micros=end_micros)
-
-    def test_to_pb_start_only(self):
-        # Makes sure already milliseconds granularity
-        start_micros = 30871000
-        self._to_pb_helper(start_micros=start_micros)
-
-    def test_to_pb_end_only(self):
-        # Makes sure already milliseconds granularity
-        end_micros = 12939371000
-        self._to_pb_helper(end_micros=end_micros)
-
-
-class TestTimestampRangeFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import TimestampRangeFilter
-        return TimestampRangeFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        range_ = object()
-        row_filter = self._makeOne(range_)
-        self.assertIs(row_filter.range_, range_)
-
-    def test___eq__type_differ(self):
-        range_ = object()
-        row_filter1 = self._makeOne(range_)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test___eq__same_value(self):
-        range_ = object()
-        row_filter1 = self._makeOne(range_)
-        row_filter2 = self._makeOne(range_)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test_to_pb(self):
-        from google.cloud.bigtable.row_filters import TimestampRange
-
-        range_ = TimestampRange()
-        row_filter = self._makeOne(range_)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(
-            timestamp_range_filter=_TimestampRangePB())
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestColumnRangeFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import ColumnRangeFilter
-        return ColumnRangeFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor_defaults(self):
-        column_family_id = object()
-        row_filter = self._makeOne(column_family_id)
-        self.assertIs(row_filter.column_family_id, column_family_id)
-        self.assertIsNone(row_filter.start_column)
-        self.assertIsNone(row_filter.end_column)
-        self.assertTrue(row_filter.inclusive_start)
-        self.assertTrue(row_filter.inclusive_end)
-
-    def test_constructor_explicit(self):
-        column_family_id = object()
-        start_column = object()
-        end_column = object()
-        inclusive_start = object()
-        inclusive_end = object()
-        row_filter = self._makeOne(
-            column_family_id,
-            start_column=start_column,
-            end_column=end_column,
-            inclusive_start=inclusive_start,
-            inclusive_end=inclusive_end)
-        self.assertIs(row_filter.column_family_id, column_family_id)
-        self.assertIs(row_filter.start_column, start_column)
-        self.assertIs(row_filter.end_column, end_column)
-        self.assertIs(row_filter.inclusive_start, inclusive_start)
-        self.assertIs(row_filter.inclusive_end, inclusive_end)
-
-    def test_constructor_bad_start(self):
-        column_family_id = object()
-        self.assertRaises(ValueError, self._makeOne,
-                          column_family_id, inclusive_start=True)
-
-    def test_constructor_bad_end(self):
-        column_family_id = object()
-        self.assertRaises(ValueError, self._makeOne,
-                          column_family_id, inclusive_end=True)
-
-    def test___eq__(self):
-        column_family_id = object()
-        start_column = object()
-        end_column = object()
-        inclusive_start = object()
-        inclusive_end = object()
-        row_filter1 = self._makeOne(column_family_id,
-                                    start_column=start_column,
-                                    end_column=end_column,
-                                    inclusive_start=inclusive_start,
-                                    inclusive_end=inclusive_end)
-        row_filter2 = self._makeOne(column_family_id,
-                                    start_column=start_column,
-                                    end_column=end_column,
-                                    inclusive_start=inclusive_start,
-                                    inclusive_end=inclusive_end)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test___eq__type_differ(self):
-        column_family_id = object()
-        row_filter1 = self._makeOne(column_family_id)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test_to_pb(self):
-        column_family_id = u'column-family-id'
-        row_filter = self._makeOne(column_family_id)
-        col_range_pb = _ColumnRangePB(family_name=column_family_id)
-        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_inclusive_start(self):
-        column_family_id = u'column-family-id'
-        column = b'column'
-        row_filter = self._makeOne(column_family_id, start_column=column)
-        col_range_pb = _ColumnRangePB(
-            family_name=column_family_id,
-            start_qualifier_closed=column,
-        )
-        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_exclusive_start(self):
-        column_family_id = u'column-family-id'
-        column = b'column'
-        row_filter = self._makeOne(column_family_id, start_column=column,
-                                   inclusive_start=False)
-        col_range_pb = _ColumnRangePB(
-            family_name=column_family_id,
-            start_qualifier_open=column,
-        )
-        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_inclusive_end(self):
-        column_family_id = u'column-family-id'
-        column = b'column'
-        row_filter = self._makeOne(column_family_id, end_column=column)
-        col_range_pb = _ColumnRangePB(
-            family_name=column_family_id,
-            end_qualifier_closed=column,
-        )
-        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_exclusive_end(self):
-        column_family_id = u'column-family-id'
-        column = b'column'
-        row_filter = self._makeOne(column_family_id, end_column=column,
-                                   inclusive_end=False)
-        col_range_pb = _ColumnRangePB(
-            family_name=column_family_id,
-            end_qualifier_open=column,
-        )
-        expected_pb = _RowFilterPB(column_range_filter=col_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-
-class TestValueRegexFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import ValueRegexFilter
-        return ValueRegexFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        regex = b'value-regex'
-        row_filter = self._makeOne(regex)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(value_regex_filter=regex)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestValueRangeFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import ValueRangeFilter
-        return ValueRangeFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor_defaults(self):
-        row_filter = self._makeOne()
-        self.assertIsNone(row_filter.start_value)
-        self.assertIsNone(row_filter.end_value)
-        self.assertTrue(row_filter.inclusive_start)
-        self.assertTrue(row_filter.inclusive_end)
-
-    def test_constructor_explicit(self):
-        start_value = object()
-        end_value = object()
-        inclusive_start = object()
-        inclusive_end = object()
-        row_filter = self._makeOne(start_value=start_value,
-                                   end_value=end_value,
-                                   inclusive_start=inclusive_start,
-                                   inclusive_end=inclusive_end)
-        self.assertIs(row_filter.start_value, start_value)
-        self.assertIs(row_filter.end_value, end_value)
-        self.assertIs(row_filter.inclusive_start, inclusive_start)
-        self.assertIs(row_filter.inclusive_end, inclusive_end)
-
-    def test_constructor_bad_start(self):
-        self.assertRaises(ValueError, self._makeOne, inclusive_start=True)
-
-    def test_constructor_bad_end(self):
-        self.assertRaises(ValueError, self._makeOne, inclusive_end=True)
-
-    def test___eq__(self):
-        start_value = object()
-        end_value = object()
-        inclusive_start = object()
-        inclusive_end = object()
-        row_filter1 = self._makeOne(start_value=start_value,
-                                    end_value=end_value,
-                                    inclusive_start=inclusive_start,
-                                    inclusive_end=inclusive_end)
-        row_filter2 = self._makeOne(start_value=start_value,
-                                    end_value=end_value,
-                                    inclusive_start=inclusive_start,
-                                    inclusive_end=inclusive_end)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test___eq__type_differ(self):
-        row_filter1 = self._makeOne()
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test_to_pb(self):
-        row_filter = self._makeOne()
-        expected_pb = _RowFilterPB(
-            value_range_filter=_ValueRangePB())
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_inclusive_start(self):
-        value = b'some-value'
-        row_filter = self._makeOne(start_value=value)
-        val_range_pb = _ValueRangePB(start_value_closed=value)
-        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_exclusive_start(self):
-        value = b'some-value'
-        row_filter = self._makeOne(start_value=value, inclusive_start=False)
-        val_range_pb = _ValueRangePB(start_value_open=value)
-        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_inclusive_end(self):
-        value = b'some-value'
-        row_filter = self._makeOne(end_value=value)
-        val_range_pb = _ValueRangePB(end_value_closed=value)
-        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-    def test_to_pb_exclusive_end(self):
-        value = b'some-value'
-        row_filter = self._makeOne(end_value=value, inclusive_end=False)
-        val_range_pb = _ValueRangePB(end_value_open=value)
-        expected_pb = _RowFilterPB(value_range_filter=val_range_pb)
-        self.assertEqual(row_filter.to_pb(), expected_pb)
-
-
-class Test_CellCountFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import _CellCountFilter
-        return _CellCountFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        num_cells = object()
-        row_filter = self._makeOne(num_cells)
-        self.assertIs(row_filter.num_cells, num_cells)
-
-    def test___eq__type_differ(self):
-        num_cells = object()
-        row_filter1 = self._makeOne(num_cells)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test___eq__same_value(self):
-        num_cells = object()
-        row_filter1 = self._makeOne(num_cells)
-        row_filter2 = self._makeOne(num_cells)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test___ne__same_value(self):
-        num_cells = object()
-        row_filter1 = self._makeOne(num_cells)
-        row_filter2 = self._makeOne(num_cells)
-        comparison_val = (row_filter1 != row_filter2)
-        self.assertFalse(comparison_val)
-
-
-class TestCellsRowOffsetFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import CellsRowOffsetFilter
-        return CellsRowOffsetFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        num_cells = 76
-        row_filter = self._makeOne(num_cells)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(
-            cells_per_row_offset_filter=num_cells)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestCellsRowLimitFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import CellsRowLimitFilter
-        return CellsRowLimitFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        num_cells = 189
-        row_filter = self._makeOne(num_cells)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(
-            cells_per_row_limit_filter=num_cells)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestCellsColumnLimitFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import CellsColumnLimitFilter
-        return CellsColumnLimitFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        num_cells = 10
-        row_filter = self._makeOne(num_cells)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(
-            cells_per_column_limit_filter=num_cells)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestStripValueTransformerFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-        return StripValueTransformerFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        flag = True
-        row_filter = self._makeOne(flag)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(strip_value_transformer=flag)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class TestApplyLabelFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import ApplyLabelFilter
-        return ApplyLabelFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        label = object()
-        row_filter = self._makeOne(label)
-        self.assertIs(row_filter.label, label)
-
-    def test___eq__type_differ(self):
-        label = object()
-        row_filter1 = self._makeOne(label)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-    def test___eq__same_value(self):
-        label = object()
-        row_filter1 = self._makeOne(label)
-        row_filter2 = self._makeOne(label)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test_to_pb(self):
-        label = u'label'
-        row_filter = self._makeOne(label)
-        pb_val = row_filter.to_pb()
-        expected_pb = _RowFilterPB(apply_label_transformer=label)
-        self.assertEqual(pb_val, expected_pb)
-
-
-class Test_FilterCombination(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import _FilterCombination
-        return _FilterCombination
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor_defaults(self):
-        row_filter = self._makeOne()
-        self.assertEqual(row_filter.filters, [])
-
-    def test_constructor_explicit(self):
-        filters = object()
-        row_filter = self._makeOne(filters=filters)
-        self.assertIs(row_filter.filters, filters)
-
-    def test___eq__(self):
-        filters = object()
-        row_filter1 = self._makeOne(filters=filters)
-        row_filter2 = self._makeOne(filters=filters)
-        self.assertEqual(row_filter1, row_filter2)
-
-    def test___eq__type_differ(self):
-        filters = object()
-        row_filter1 = self._makeOne(filters=filters)
-        row_filter2 = object()
-        self.assertNotEqual(row_filter1, row_filter2)
-
-
-class TestRowFilterChain(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import RowFilterChain
-        return RowFilterChain
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter1_pb = row_filter1.to_pb()
-
-        row_filter2 = RowSampleFilter(0.25)
-        row_filter2_pb = row_filter2.to_pb()
-
-        row_filter3 = self._makeOne(filters=[row_filter1, row_filter2])
-        filter_pb = row_filter3.to_pb()
-
-        expected_pb = _RowFilterPB(
-            chain=_RowFilterChainPB(
-                filters=[row_filter1_pb, row_filter2_pb],
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-    def test_to_pb_nested(self):
-        from google.cloud.bigtable.row_filters import CellsRowLimitFilter
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter2 = RowSampleFilter(0.25)
-
-        row_filter3 = self._makeOne(filters=[row_filter1, row_filter2])
-        row_filter3_pb = row_filter3.to_pb()
-
-        row_filter4 = CellsRowLimitFilter(11)
-        row_filter4_pb = row_filter4.to_pb()
-
-        row_filter5 = self._makeOne(filters=[row_filter3, row_filter4])
-        filter_pb = row_filter5.to_pb()
-
-        expected_pb = _RowFilterPB(
-            chain=_RowFilterChainPB(
-                filters=[row_filter3_pb, row_filter4_pb],
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-
-class TestRowFilterUnion(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import RowFilterUnion
-        return RowFilterUnion
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_to_pb(self):
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter1_pb = row_filter1.to_pb()
-
-        row_filter2 = RowSampleFilter(0.25)
-        row_filter2_pb = row_filter2.to_pb()
-
-        row_filter3 = self._makeOne(filters=[row_filter1, row_filter2])
-        filter_pb = row_filter3.to_pb()
-
-        expected_pb = _RowFilterPB(
-            interleave=_RowFilterInterleavePB(
-                filters=[row_filter1_pb, row_filter2_pb],
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-    def test_to_pb_nested(self):
-        from google.cloud.bigtable.row_filters import CellsRowLimitFilter
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter2 = RowSampleFilter(0.25)
-
-        row_filter3 = self._makeOne(filters=[row_filter1, row_filter2])
-        row_filter3_pb = row_filter3.to_pb()
-
-        row_filter4 = CellsRowLimitFilter(11)
-        row_filter4_pb = row_filter4.to_pb()
-
-        row_filter5 = self._makeOne(filters=[row_filter3, row_filter4])
-        filter_pb = row_filter5.to_pb()
-
-        expected_pb = _RowFilterPB(
-            interleave=_RowFilterInterleavePB(
-                filters=[row_filter3_pb, row_filter4_pb],
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-
-class TestConditionalRowFilter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.row_filters import ConditionalRowFilter
-        return ConditionalRowFilter
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        base_filter = object()
-        true_filter = object()
-        false_filter = object()
-        cond_filter = self._makeOne(base_filter,
-                                    true_filter=true_filter,
-                                    false_filter=false_filter)
-        self.assertIs(cond_filter.base_filter, base_filter)
-        self.assertIs(cond_filter.true_filter, true_filter)
-        self.assertIs(cond_filter.false_filter, false_filter)
-
-    def test___eq__(self):
-        base_filter = object()
-        true_filter = object()
-        false_filter = object()
-        cond_filter1 = self._makeOne(base_filter,
-                                     true_filter=true_filter,
-                                     false_filter=false_filter)
-        cond_filter2 = self._makeOne(base_filter,
-                                     true_filter=true_filter,
-                                     false_filter=false_filter)
-        self.assertEqual(cond_filter1, cond_filter2)
-
-    def test___eq__type_differ(self):
-        base_filter = object()
-        true_filter = object()
-        false_filter = object()
-        cond_filter1 = self._makeOne(base_filter,
-                                     true_filter=true_filter,
-                                     false_filter=false_filter)
-        cond_filter2 = object()
-        self.assertNotEqual(cond_filter1, cond_filter2)
-
-    def test_to_pb(self):
-        from google.cloud.bigtable.row_filters import CellsRowOffsetFilter
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter1_pb = row_filter1.to_pb()
-
-        row_filter2 = RowSampleFilter(0.25)
-        row_filter2_pb = row_filter2.to_pb()
-
-        row_filter3 = CellsRowOffsetFilter(11)
-        row_filter3_pb = row_filter3.to_pb()
-
-        row_filter4 = self._makeOne(row_filter1, true_filter=row_filter2,
-                                    false_filter=row_filter3)
-        filter_pb = row_filter4.to_pb()
-
-        expected_pb = _RowFilterPB(
-            condition=_RowFilterConditionPB(
-                predicate_filter=row_filter1_pb,
-                true_filter=row_filter2_pb,
-                false_filter=row_filter3_pb,
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-    def test_to_pb_true_only(self):
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter1_pb = row_filter1.to_pb()
-
-        row_filter2 = RowSampleFilter(0.25)
-        row_filter2_pb = row_filter2.to_pb()
-
-        row_filter3 = self._makeOne(row_filter1, true_filter=row_filter2)
-        filter_pb = row_filter3.to_pb()
-
-        expected_pb = _RowFilterPB(
-            condition=_RowFilterConditionPB(
-                predicate_filter=row_filter1_pb,
-                true_filter=row_filter2_pb,
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-    def test_to_pb_false_only(self):
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        from google.cloud.bigtable.row_filters import (
-            StripValueTransformerFilter)
-
-        row_filter1 = StripValueTransformerFilter(True)
-        row_filter1_pb = row_filter1.to_pb()
-
-        row_filter2 = RowSampleFilter(0.25)
-        row_filter2_pb = row_filter2.to_pb()
-
-        row_filter3 = self._makeOne(row_filter1, false_filter=row_filter2)
-        filter_pb = row_filter3.to_pb()
-
-        expected_pb = _RowFilterPB(
-            condition=_RowFilterConditionPB(
-                predicate_filter=row_filter1_pb,
-                false_filter=row_filter2_pb,
-            ),
-        )
-        self.assertEqual(filter_pb, expected_pb)
-
-
-def _ColumnRangePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.ColumnRange(*args, **kw)
-
-
-def _RowFilterPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.RowFilter(*args, **kw)
-
-
-def _RowFilterChainPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.RowFilter.Chain(*args, **kw)
-
-
-def _RowFilterConditionPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.RowFilter.Condition(*args, **kw)
-
-
-def _RowFilterInterleavePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.RowFilter.Interleave(*args, **kw)
-
-
-def _TimestampRangePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.TimestampRange(*args, **kw)
-
-
-def _ValueRangePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        data_pb2 as data_v2_pb2)
-    return data_v2_pb2.ValueRange(*args, **kw)
diff --git a/unit_tests/bigtable/test_table.py b/unit_tests/bigtable/test_table.py
deleted file mode 100644
index a7d18fe630bc..000000000000
--- a/unit_tests/bigtable/test_table.py
+++ /dev/null
@@ -1,585 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-
-import unittest
-
-
-class TestTable(unittest.TestCase):
-
-    PROJECT_ID = 'project-id'
-    INSTANCE_ID = 'instance-id'
-    INSTANCE_NAME = ('projects/' + PROJECT_ID + '/instances/' + INSTANCE_ID)
-    TABLE_ID = 'table-id'
-    TABLE_NAME = INSTANCE_NAME + '/tables/' + TABLE_ID
-    ROW_KEY = b'row-key'
-    FAMILY_NAME = u'family'
-    QUALIFIER = b'qualifier'
-    TIMESTAMP_MICROS = 100
-    VALUE = b'value'
-
-    def _getTargetClass(self):
-        from google.cloud.bigtable.table import Table
-        return Table
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        table_id = 'table-id'
-        instance = object()
-
-        table = self._makeOne(table_id, instance)
-        self.assertEqual(table.table_id, table_id)
-        self.assertIs(table._instance, instance)
-
-    def test_name_property(self):
-        table_id = 'table-id'
-        instance_name = 'instance_name'
-
-        instance = _Instance(instance_name)
-        table = self._makeOne(table_id, instance)
-        expected_name = instance_name + '/tables/' + table_id
-        self.assertEqual(table.name, expected_name)
-
-    def test_column_family_factory(self):
-        from google.cloud.bigtable.column_family import ColumnFamily
-
-        table_id = 'table-id'
-        gc_rule = object()
-        table = self._makeOne(table_id, None)
-        column_family_id = 'column_family_id'
-        column_family = table.column_family(column_family_id, gc_rule=gc_rule)
-
-        self.assertIsInstance(column_family, ColumnFamily)
-        self.assertEqual(column_family.column_family_id, column_family_id)
-        self.assertIs(column_family.gc_rule, gc_rule)
-        self.assertEqual(column_family._table, table)
-
-    def test_row_factory_direct(self):
-        from google.cloud.bigtable.row import DirectRow
-
-        table_id = 'table-id'
-        table = self._makeOne(table_id, None)
-        row_key = b'row_key'
-        row = table.row(row_key)
-
-        self.assertIsInstance(row, DirectRow)
-        self.assertEqual(row._row_key, row_key)
-        self.assertEqual(row._table, table)
-
-    def test_row_factory_conditional(self):
-        from google.cloud.bigtable.row import ConditionalRow
-
-        table_id = 'table-id'
-        table = self._makeOne(table_id, None)
-        row_key = b'row_key'
-        filter_ = object()
-        row = table.row(row_key, filter_=filter_)
-
-        self.assertIsInstance(row, ConditionalRow)
-        self.assertEqual(row._row_key, row_key)
-        self.assertEqual(row._table, table)
-
-    def test_row_factory_append(self):
-        from google.cloud.bigtable.row import AppendRow
-
-        table_id = 'table-id'
-        table = self._makeOne(table_id, None)
-        row_key = b'row_key'
-        row = table.row(row_key, append=True)
-
-        self.assertIsInstance(row, AppendRow)
-        self.assertEqual(row._row_key, row_key)
-        self.assertEqual(row._table, table)
-
-    def test_row_factory_failure(self):
-        table = self._makeOne(self.TABLE_ID, None)
-        with self.assertRaises(ValueError):
-            table.row(b'row_key', filter_=object(), append=True)
-
-    def test___eq__(self):
-        instance = object()
-        table1 = self._makeOne(self.TABLE_ID, instance)
-        table2 = self._makeOne(self.TABLE_ID, instance)
-        self.assertEqual(table1, table2)
-
-    def test___eq__type_differ(self):
-        table1 = self._makeOne(self.TABLE_ID, None)
-        table2 = object()
-        self.assertNotEqual(table1, table2)
-
-    def test___ne__same_value(self):
-        instance = object()
-        table1 = self._makeOne(self.TABLE_ID, instance)
-        table2 = self._makeOne(self.TABLE_ID, instance)
-        comparison_val = (table1 != table2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        table1 = self._makeOne('table_id1', 'instance1')
-        table2 = self._makeOne('table_id2', 'instance2')
-        self.assertNotEqual(table1, table2)
-
-    def _create_test_helper(self, initial_split_keys, column_families=()):
-        from google.cloud._helpers import _to_bytes
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client()
-        instance = _Instance(self.INSTANCE_NAME, client=client)
-        table = self._makeOne(self.TABLE_ID, instance)
-
-        # Create request_pb
-        splits_pb = [
-            _CreateTableRequestSplitPB(key=_to_bytes(key))
-            for key in initial_split_keys or ()]
-        table_pb = None
-        if column_families:
-            table_pb = _TablePB()
-            for cf in column_families:
-                cf_pb = table_pb.column_families[cf.column_family_id]
-                if cf.gc_rule is not None:
-                    cf_pb.gc_rule.MergeFrom(cf.gc_rule.to_pb())
-        request_pb = _CreateTableRequestPB(
-            initial_splits=splits_pb,
-            parent=self.INSTANCE_NAME,
-            table_id=self.TABLE_ID,
-            table=table_pb,
-        )
-
-        # Create response_pb
-        response_pb = _TablePB()
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # create() has no return value.
-
-        # Perform the method and check the result.
-        result = table.create(initial_split_keys=initial_split_keys,
-                              column_families=column_families)
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'CreateTable',
-            (request_pb,),
-            {},
-        )])
-
-    def test_create(self):
-        initial_split_keys = None
-        self._create_test_helper(initial_split_keys)
-
-    def test_create_with_split_keys(self):
-        initial_split_keys = [b's1', b's2']
-        self._create_test_helper(initial_split_keys)
-
-    def test_create_with_column_families(self):
-        from google.cloud.bigtable.column_family import ColumnFamily
-        from google.cloud.bigtable.column_family import MaxVersionsGCRule
-
-        cf_id1 = 'col-fam-id1'
-        cf1 = ColumnFamily(cf_id1, None)
-        cf_id2 = 'col-fam-id2'
-        gc_rule = MaxVersionsGCRule(42)
-        cf2 = ColumnFamily(cf_id2, None, gc_rule=gc_rule)
-
-        initial_split_keys = None
-        column_families = [cf1, cf2]
-        self._create_test_helper(initial_split_keys,
-                                 column_families=column_families)
-
-    def _list_column_families_helper(self):
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client()
-        instance = _Instance(self.INSTANCE_NAME, client=client)
-        table = self._makeOne(self.TABLE_ID, instance)
-
-        # Create request_pb
-        request_pb = _GetTableRequestPB(name=self.TABLE_NAME)
-
-        # Create response_pb
-        COLUMN_FAMILY_ID = 'foo'
-        column_family = _ColumnFamilyPB()
-        response_pb = _TablePB(
-            column_families={COLUMN_FAMILY_ID: column_family},
-        )
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = {
-            COLUMN_FAMILY_ID: table.column_family(COLUMN_FAMILY_ID),
-        }
-
-        # Perform the method and check the result.
-        result = table.list_column_families()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'GetTable',
-            (request_pb,),
-            {},
-        )])
-
-    def test_list_column_families(self):
-        self._list_column_families_helper()
-
-    def test_delete(self):
-        from google.protobuf import empty_pb2
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client()
-        instance = _Instance(self.INSTANCE_NAME, client=client)
-        table = self._makeOne(self.TABLE_ID, instance)
-
-        # Create request_pb
-        request_pb = _DeleteTableRequestPB(name=self.TABLE_NAME)
-
-        # Create response_pb
-        response_pb = empty_pb2.Empty()
-
-        # Patch the stub used by the API method.
-        client._table_stub = stub = _FakeStub(response_pb)
-
-        # Create expected_result.
-        expected_result = None  # delete() has no return value.
-
-        # Perform the method and check the result.
-        result = table.delete()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'DeleteTable',
-            (request_pb,),
-            {},
-        )])
-
-    def _read_row_helper(self, chunks, expected_result):
-        from unit_tests._testing import _Monkey
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable import table as MUT
-
-        client = _Client()
-        instance = _Instance(self.INSTANCE_NAME, client=client)
-        table = self._makeOne(self.TABLE_ID, instance)
-
-        # Create request_pb
-        request_pb = object()  # Returned by our mock.
-        mock_created = []
-
-        def mock_create_row_request(table_name, row_key, filter_):
-            mock_created.append((table_name, row_key, filter_))
-            return request_pb
-
-        # Create response_iterator
-        if chunks is None:
-            response_iterator = iter(())  # no responses at all
-        else:
-            response_pb = _ReadRowsResponsePB(chunks=chunks)
-            response_iterator = iter([response_pb])
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub(response_iterator)
-
-        # Perform the method and check the result.
-        filter_obj = object()
-        with _Monkey(MUT, _create_row_request=mock_create_row_request):
-            result = table.read_row(self.ROW_KEY, filter_=filter_obj)
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ReadRows',
-            (request_pb,),
-            {},
-        )])
-        self.assertEqual(mock_created,
-                         [(table.name, self.ROW_KEY, filter_obj)])
-
-    def test_read_row_miss_no__responses(self):
-        self._read_row_helper(None, None)
-
-    def test_read_row_miss_no_chunks_in_response(self):
-        chunks = []
-        self._read_row_helper(chunks, None)
-
-    def test_read_row_complete(self):
-        from google.cloud.bigtable.row_data import Cell
-        from google.cloud.bigtable.row_data import PartialRowData
-
-        chunk = _ReadRowsResponseCellChunkPB(
-            row_key=self.ROW_KEY,
-            family_name=self.FAMILY_NAME,
-            qualifier=self.QUALIFIER,
-            timestamp_micros=self.TIMESTAMP_MICROS,
-            value=self.VALUE,
-            commit_row=True,
-        )
-        chunks = [chunk]
-        expected_result = PartialRowData(row_key=self.ROW_KEY)
-        family = expected_result._cells.setdefault(self.FAMILY_NAME, {})
-        column = family.setdefault(self.QUALIFIER, [])
-        column.append(Cell.from_pb(chunk))
-        self._read_row_helper(chunks, expected_result)
-
-    def test_read_row_still_partial(self):
-        chunk = _ReadRowsResponseCellChunkPB(
-            row_key=self.ROW_KEY,
-            family_name=self.FAMILY_NAME,
-            qualifier=self.QUALIFIER,
-            timestamp_micros=self.TIMESTAMP_MICROS,
-            value=self.VALUE,
-        )
-        # No "commit row".
-        chunks = [chunk]
-        with self.assertRaises(ValueError):
-            self._read_row_helper(chunks, None)
-
-    def test_read_rows(self):
-        from unit_tests._testing import _Monkey
-        from unit_tests.bigtable._testing import _FakeStub
-        from google.cloud.bigtable.row_data import PartialRowsData
-        from google.cloud.bigtable import table as MUT
-
-        client = _Client()
-        instance = _Instance(self.INSTANCE_NAME, client=client)
-        table = self._makeOne(self.TABLE_ID, instance)
-
-        # Create request_pb
-        request_pb = object()  # Returned by our mock.
-        mock_created = []
-
-        def mock_create_row_request(table_name, **kwargs):
-            mock_created.append((table_name, kwargs))
-            return request_pb
-
-        # Create response_iterator
-        response_iterator = object()
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub(response_iterator)
-
-        # Create expected_result.
-        expected_result = PartialRowsData(response_iterator)
-
-        # Perform the method and check the result.
-        start_key = b'start-key'
-        end_key = b'end-key'
-        filter_obj = object()
-        limit = 22
-        with _Monkey(MUT, _create_row_request=mock_create_row_request):
-            result = table.read_rows(
-                start_key=start_key, end_key=end_key, filter_=filter_obj,
-                limit=limit)
-
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'ReadRows',
-            (request_pb,),
-            {},
-        )])
-        created_kwargs = {
-            'start_key': start_key,
-            'end_key': end_key,
-            'filter_': filter_obj,
-            'limit': limit,
-        }
-        self.assertEqual(mock_created, [(table.name, created_kwargs)])
-
-    def test_sample_row_keys(self):
-        from unit_tests.bigtable._testing import _FakeStub
-
-        client = _Client()
-        instance = _Instance(self.INSTANCE_NAME, client=client)
-        table = self._makeOne(self.TABLE_ID, instance)
-
-        # Create request_pb
-        request_pb = _SampleRowKeysRequestPB(table_name=self.TABLE_NAME)
-
-        # Create response_iterator
-        response_iterator = object()  # Just passed to a mock.
-
-        # Patch the stub used by the API method.
-        client._data_stub = stub = _FakeStub(response_iterator)
-
-        # Create expected_result.
-        expected_result = response_iterator
-
-        # Perform the method and check the result.
-        result = table.sample_row_keys()
-        self.assertEqual(result, expected_result)
-        self.assertEqual(stub.method_calls, [(
-            'SampleRowKeys',
-            (request_pb,),
-            {},
-        )])
-
-
-class Test__create_row_request(unittest.TestCase):
-
-    def _callFUT(self, table_name, row_key=None, start_key=None, end_key=None,
-                 filter_=None, limit=None):
-        from google.cloud.bigtable.table import _create_row_request
-        return _create_row_request(
-            table_name, row_key=row_key, start_key=start_key, end_key=end_key,
-            filter_=filter_, limit=limit)
-
-    def test_table_name_only(self):
-        table_name = 'table_name'
-        result = self._callFUT(table_name)
-        expected_result = _ReadRowsRequestPB(
-            table_name=table_name)
-        self.assertEqual(result, expected_result)
-
-    def test_row_key_row_range_conflict(self):
-        with self.assertRaises(ValueError):
-            self._callFUT(None, row_key=object(), end_key=object())
-
-    def test_row_key(self):
-        table_name = 'table_name'
-        row_key = b'row_key'
-        result = self._callFUT(table_name, row_key=row_key)
-        expected_result = _ReadRowsRequestPB(
-            table_name=table_name,
-        )
-        expected_result.rows.row_keys.append(row_key)
-        self.assertEqual(result, expected_result)
-
-    def test_row_range_start_key(self):
-        table_name = 'table_name'
-        start_key = b'start_key'
-        result = self._callFUT(table_name, start_key=start_key)
-        expected_result = _ReadRowsRequestPB(table_name=table_name)
-        expected_result.rows.row_ranges.add(start_key_closed=start_key)
-        self.assertEqual(result, expected_result)
-
-    def test_row_range_end_key(self):
-        table_name = 'table_name'
-        end_key = b'end_key'
-        result = self._callFUT(table_name, end_key=end_key)
-        expected_result = _ReadRowsRequestPB(table_name=table_name)
-        expected_result.rows.row_ranges.add(end_key_open=end_key)
-        self.assertEqual(result, expected_result)
-
-    def test_row_range_both_keys(self):
-        table_name = 'table_name'
-        start_key = b'start_key'
-        end_key = b'end_key'
-        result = self._callFUT(table_name, start_key=start_key,
-                               end_key=end_key)
-        expected_result = _ReadRowsRequestPB(table_name=table_name)
-        expected_result.rows.row_ranges.add(
-            start_key_closed=start_key, end_key_open=end_key)
-        self.assertEqual(result, expected_result)
-
-    def test_with_filter(self):
-        from google.cloud.bigtable.row_filters import RowSampleFilter
-        table_name = 'table_name'
-        row_filter = RowSampleFilter(0.33)
-        result = self._callFUT(table_name, filter_=row_filter)
-        expected_result = _ReadRowsRequestPB(
-            table_name=table_name,
-            filter=row_filter.to_pb(),
-        )
-        self.assertEqual(result, expected_result)
-
-    def test_with_limit(self):
-        table_name = 'table_name'
-        limit = 1337
-        result = self._callFUT(table_name, limit=limit)
-        expected_result = _ReadRowsRequestPB(
-            table_name=table_name,
-            rows_limit=limit,
-        )
-        self.assertEqual(result, expected_result)
-
-
-def _CreateTableRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_table_admin_pb2 as table_admin_v2_pb2)
-    return table_admin_v2_pb2.CreateTableRequest(*args, **kw)
-
-
-def _CreateTableRequestSplitPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_table_admin_pb2 as table_admin_v2_pb2)
-    return table_admin_v2_pb2.CreateTableRequest.Split(*args, **kw)
-
-
-def _DeleteTableRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_table_admin_pb2 as table_admin_v2_pb2)
-    return table_admin_v2_pb2.DeleteTableRequest(*args, **kw)
-
-
-def _GetTableRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_table_admin_pb2 as table_admin_v2_pb2)
-    return table_admin_v2_pb2.GetTableRequest(*args, **kw)
-
-
-def _ReadRowsRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.ReadRowsRequest(*args, **kw)
-
-
-def _ReadRowsResponseCellChunkPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    family_name = kw.pop('family_name')
-    qualifier = kw.pop('qualifier')
-    message = messages_v2_pb2.ReadRowsResponse.CellChunk(*args, **kw)
-    message.family_name.value = family_name
-    message.qualifier.value = qualifier
-    return message
-
-
-def _ReadRowsResponsePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.ReadRowsResponse(*args, **kw)
-
-
-def _SampleRowKeysRequestPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        bigtable_pb2 as messages_v2_pb2)
-    return messages_v2_pb2.SampleRowKeysRequest(*args, **kw)
-
-
-def _TablePB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        table_pb2 as table_v2_pb2)
-    return table_v2_pb2.Table(*args, **kw)
-
-
-def _ColumnFamilyPB(*args, **kw):
-    from google.cloud.bigtable._generated import (
-        table_pb2 as table_v2_pb2)
-    return table_v2_pb2.ColumnFamily(*args, **kw)
-
-
-class _Client(object):
-
-    data_stub = None
-    instance_stub = None
-    operations_stub = None
-    table_stub = None
-
-
-class _Instance(object):
-
-    def __init__(self, name, client=None):
-        self.name = name
-        self._client = client
diff --git a/unit_tests/datastore/__init__.py b/unit_tests/datastore/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/datastore/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/datastore/test_batch.py b/unit_tests/datastore/test_batch.py
deleted file mode 100644
index a8999387ea40..000000000000
--- a/unit_tests/datastore/test_batch.py
+++ /dev/null
@@ -1,471 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestBatch(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.batch import Batch
-
-        return Batch
-
-    def _makeOne(self, client):
-        return self._getTargetClass()(client)
-
-    def test_ctor(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        _PROJECT = 'PROJECT'
-        _NAMESPACE = 'NAMESPACE'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection, _NAMESPACE)
-        batch = self._makeOne(client)
-
-        self.assertEqual(batch.project, _PROJECT)
-        self.assertEqual(batch.connection, connection)
-        self.assertEqual(batch.namespace, _NAMESPACE)
-        self.assertIsNone(batch._id)
-        self.assertEqual(batch._status, batch._INITIAL)
-        self.assertIsInstance(batch._commit_request,
-                              datastore_pb2.CommitRequest)
-        self.assertIs(batch.mutations, batch._commit_request.mutations)
-        self.assertEqual(batch._partial_key_entities, [])
-
-    def test_current(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch1 = self._makeOne(client)
-        batch2 = self._makeOne(client)
-        self.assertIsNone(batch1.current())
-        self.assertIsNone(batch2.current())
-        with batch1:
-            self.assertIs(batch1.current(), batch1)
-            self.assertIs(batch2.current(), batch1)
-            with batch2:
-                self.assertIs(batch1.current(), batch2)
-                self.assertIs(batch2.current(), batch2)
-            self.assertIs(batch1.current(), batch1)
-            self.assertIs(batch2.current(), batch1)
-        self.assertIsNone(batch1.current())
-        self.assertIsNone(batch2.current())
-
-    def test_put_entity_wo_key(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-
-        batch.begin()
-        self.assertRaises(ValueError, batch.put, _Entity())
-
-    def test_put_entity_wrong_status(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        entity = _Entity()
-        entity.key = _Key('OTHER')
-
-        self.assertEqual(batch._status, batch._INITIAL)
-        self.assertRaises(ValueError, batch.put, entity)
-
-    def test_put_entity_w_key_wrong_project(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        entity = _Entity()
-        entity.key = _Key('OTHER')
-
-        batch.begin()
-        self.assertRaises(ValueError, batch.put, entity)
-
-    def test_put_entity_w_partial_key(self):
-        _PROJECT = 'PROJECT'
-        _PROPERTIES = {'foo': 'bar'}
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        entity = _Entity(_PROPERTIES)
-        key = entity.key = _Key(_PROJECT)
-        key._id = None
-
-        batch.begin()
-        batch.put(entity)
-
-        mutated_entity = _mutated_pb(self, batch.mutations, 'insert')
-        self.assertEqual(mutated_entity.key, key._key)
-        self.assertEqual(batch._partial_key_entities, [entity])
-
-    def test_put_entity_w_completed_key(self):
-        from google.cloud.datastore.helpers import _property_tuples
-
-        _PROJECT = 'PROJECT'
-        _PROPERTIES = {
-            'foo': 'bar',
-            'baz': 'qux',
-            'spam': [1, 2, 3],
-            'frotz': [],  # will be ignored
-            }
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        entity = _Entity(_PROPERTIES)
-        entity.exclude_from_indexes = ('baz', 'spam')
-        key = entity.key = _Key(_PROJECT)
-
-        batch.begin()
-        batch.put(entity)
-
-        mutated_entity = _mutated_pb(self, batch.mutations, 'upsert')
-        self.assertEqual(mutated_entity.key, key._key)
-
-        prop_dict = dict(_property_tuples(mutated_entity))
-        self.assertEqual(len(prop_dict), 3)
-        self.assertFalse(prop_dict['foo'].exclude_from_indexes)
-        self.assertTrue(prop_dict['baz'].exclude_from_indexes)
-        self.assertFalse(prop_dict['spam'].exclude_from_indexes)
-        spam_values = prop_dict['spam'].array_value.values
-        self.assertTrue(spam_values[0].exclude_from_indexes)
-        self.assertTrue(spam_values[1].exclude_from_indexes)
-        self.assertTrue(spam_values[2].exclude_from_indexes)
-        self.assertFalse('frotz' in prop_dict)
-
-    def test_delete_wrong_status(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        key = _Key(_PROJECT)
-        key._id = None
-
-        self.assertEqual(batch._status, batch._INITIAL)
-        self.assertRaises(ValueError, batch.delete, key)
-
-    def test_delete_w_partial_key(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        key = _Key(_PROJECT)
-        key._id = None
-
-        batch.begin()
-        self.assertRaises(ValueError, batch.delete, key)
-
-    def test_delete_w_key_wrong_project(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        key = _Key('OTHER')
-
-        batch.begin()
-        self.assertRaises(ValueError, batch.delete, key)
-
-    def test_delete_w_completed_key(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        key = _Key(_PROJECT)
-
-        batch.begin()
-        batch.delete(key)
-
-        mutated_key = _mutated_pb(self, batch.mutations, 'delete')
-        self.assertEqual(mutated_key, key._key)
-
-    def test_begin(self):
-        _PROJECT = 'PROJECT'
-        client = _Client(_PROJECT, None)
-        batch = self._makeOne(client)
-        self.assertEqual(batch._status, batch._INITIAL)
-        batch.begin()
-        self.assertEqual(batch._status, batch._IN_PROGRESS)
-
-    def test_begin_fail(self):
-        _PROJECT = 'PROJECT'
-        client = _Client(_PROJECT, None)
-        batch = self._makeOne(client)
-        batch._status = batch._IN_PROGRESS
-        with self.assertRaises(ValueError):
-            batch.begin()
-
-    def test_rollback(self):
-        _PROJECT = 'PROJECT'
-        client = _Client(_PROJECT, None)
-        batch = self._makeOne(client)
-        batch.begin()
-        self.assertEqual(batch._status, batch._IN_PROGRESS)
-        batch.rollback()
-        self.assertEqual(batch._status, batch._ABORTED)
-
-    def test_rollback_wrong_status(self):
-        _PROJECT = 'PROJECT'
-        client = _Client(_PROJECT, None)
-        batch = self._makeOne(client)
-
-        self.assertEqual(batch._status, batch._INITIAL)
-        self.assertRaises(ValueError, batch.rollback)
-
-    def test_commit(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-
-        self.assertEqual(batch._status, batch._INITIAL)
-        batch.begin()
-        self.assertEqual(batch._status, batch._IN_PROGRESS)
-        batch.commit()
-        self.assertEqual(batch._status, batch._FINISHED)
-
-        self.assertEqual(connection._committed,
-                         [(_PROJECT, batch._commit_request, None)])
-
-    def test_commit_wrong_status(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-
-        self.assertEqual(batch._status, batch._INITIAL)
-        self.assertRaises(ValueError, batch.commit)
-
-    def test_commit_w_partial_key_entities(self):
-        _PROJECT = 'PROJECT'
-        _NEW_ID = 1234
-        connection = _Connection(_NEW_ID)
-        client = _Client(_PROJECT, connection)
-        batch = self._makeOne(client)
-        entity = _Entity({})
-        key = entity.key = _Key(_PROJECT)
-        key._id = None
-        batch._partial_key_entities.append(entity)
-
-        self.assertEqual(batch._status, batch._INITIAL)
-        batch.begin()
-        self.assertEqual(batch._status, batch._IN_PROGRESS)
-        batch.commit()
-        self.assertEqual(batch._status, batch._FINISHED)
-
-        self.assertEqual(connection._committed,
-                         [(_PROJECT, batch._commit_request, None)])
-        self.assertFalse(entity.key.is_partial)
-        self.assertEqual(entity.key._id, _NEW_ID)
-
-    def test_as_context_mgr_wo_error(self):
-        _PROJECT = 'PROJECT'
-        _PROPERTIES = {'foo': 'bar'}
-        connection = _Connection()
-        entity = _Entity(_PROPERTIES)
-        key = entity.key = _Key(_PROJECT)
-
-        client = _Client(_PROJECT, connection)
-        self.assertEqual(list(client._batches), [])
-
-        with self._makeOne(client) as batch:
-            self.assertEqual(list(client._batches), [batch])
-            batch.put(entity)
-
-        self.assertEqual(list(client._batches), [])
-
-        mutated_entity = _mutated_pb(self, batch.mutations, 'upsert')
-        self.assertEqual(mutated_entity.key, key._key)
-        self.assertEqual(connection._committed,
-                         [(_PROJECT, batch._commit_request, None)])
-
-    def test_as_context_mgr_nested(self):
-        _PROJECT = 'PROJECT'
-        _PROPERTIES = {'foo': 'bar'}
-        connection = _Connection()
-        entity1 = _Entity(_PROPERTIES)
-        key1 = entity1.key = _Key(_PROJECT)
-        entity2 = _Entity(_PROPERTIES)
-        key2 = entity2.key = _Key(_PROJECT)
-
-        client = _Client(_PROJECT, connection)
-        self.assertEqual(list(client._batches), [])
-
-        with self._makeOne(client) as batch1:
-            self.assertEqual(list(client._batches), [batch1])
-            batch1.put(entity1)
-            with self._makeOne(client) as batch2:
-                self.assertEqual(list(client._batches), [batch2, batch1])
-                batch2.put(entity2)
-
-            self.assertEqual(list(client._batches), [batch1])
-
-        self.assertEqual(list(client._batches), [])
-
-        mutated_entity1 = _mutated_pb(self, batch1.mutations, 'upsert')
-        self.assertEqual(mutated_entity1.key, key1._key)
-
-        mutated_entity2 = _mutated_pb(self, batch2.mutations, 'upsert')
-        self.assertEqual(mutated_entity2.key, key2._key)
-
-        self.assertEqual(connection._committed,
-                         [(_PROJECT, batch2._commit_request, None),
-                          (_PROJECT, batch1._commit_request, None)])
-
-    def test_as_context_mgr_w_error(self):
-        _PROJECT = 'PROJECT'
-        _PROPERTIES = {'foo': 'bar'}
-        connection = _Connection()
-        entity = _Entity(_PROPERTIES)
-        key = entity.key = _Key(_PROJECT)
-
-        client = _Client(_PROJECT, connection)
-        self.assertEqual(list(client._batches), [])
-
-        try:
-            with self._makeOne(client) as batch:
-                self.assertEqual(list(client._batches), [batch])
-                batch.put(entity)
-                raise ValueError("testing")
-        except ValueError:
-            pass
-
-        self.assertEqual(list(client._batches), [])
-
-        mutated_entity = _mutated_pb(self, batch.mutations, 'upsert')
-        self.assertEqual(mutated_entity.key, key._key)
-        self.assertEqual(connection._committed, [])
-
-    def test_as_context_mgr_enter_fails(self):
-        klass = self._getTargetClass()
-
-        class FailedBegin(klass):
-
-            def begin(self):
-                raise RuntimeError
-
-        client = _Client(None, None)
-        self.assertEqual(client._batches, [])
-
-        batch = FailedBegin(client)
-        with self.assertRaises(RuntimeError):
-            # The context manager will never be entered because
-            # of the failure.
-            with batch:  # pragma: NO COVER
-                pass
-        # Make sure no batch was added.
-        self.assertEqual(client._batches, [])
-
-
-class _PathElementPB(object):
-
-    def __init__(self, id_):
-        self.id = id_
-
-
-class _KeyPB(object):
-
-    def __init__(self, id_):
-        self.path = [_PathElementPB(id_)]
-
-
-class _Connection(object):
-    _marker = object()
-    _save_result = (False, None)
-
-    def __init__(self, *new_keys):
-        self._completed_keys = [_KeyPB(key) for key in new_keys]
-        self._committed = []
-        self._index_updates = 0
-
-    def commit(self, project, commit_request, transaction_id):
-        self._committed.append((project, commit_request, transaction_id))
-        return self._index_updates, self._completed_keys
-
-
-class _Entity(dict):
-    key = None
-    exclude_from_indexes = ()
-    _meanings = {}
-
-
-class _Key(object):
-    _MARKER = object()
-    _kind = 'KIND'
-    _key = 'KEY'
-    _path = None
-    _id = 1234
-    _stored = None
-
-    def __init__(self, project):
-        self.project = project
-
-    @property
-    def is_partial(self):
-        return self._id is None
-
-    def to_protobuf(self):
-        from google.cloud.datastore._generated import entity_pb2
-        key = self._key = entity_pb2.Key()
-        # Don't assign it, because it will just get ripped out
-        # key.partition_id.project_id = self.project
-
-        element = key.path.add()
-        element.kind = self._kind
-        if self._id is not None:
-            element.id = self._id
-
-        return key
-
-    def completed_key(self, new_id):
-        assert self.is_partial
-        new_key = self.__class__(self.project)
-        new_key._id = new_id
-        return new_key
-
-
-class _Client(object):
-
-    def __init__(self, project, connection, namespace=None):
-        self.project = project
-        self.connection = connection
-        self.namespace = namespace
-        self._batches = []
-
-    def _push_batch(self, batch):
-        self._batches.insert(0, batch)
-
-    def _pop_batch(self):
-        return self._batches.pop(0)
-
-    @property
-    def current_batch(self):
-        if self._batches:
-            return self._batches[0]
-
-
-def _assert_num_mutations(test_case, mutation_pb_list, num_mutations):
-    test_case.assertEqual(len(mutation_pb_list), num_mutations)
-
-
-def _mutated_pb(test_case, mutation_pb_list, mutation_type):
-    # Make sure there is only one mutation.
-    _assert_num_mutations(test_case, mutation_pb_list, 1)
-
-    # We grab the only mutation.
-    mutated_pb = mutation_pb_list[0]
-    # Then check if it is the correct type.
-    test_case.assertEqual(mutated_pb.WhichOneof('operation'),
-                          mutation_type)
-
-    return getattr(mutated_pb, mutation_type)
diff --git a/unit_tests/datastore/test_client.py b/unit_tests/datastore/test_client.py
deleted file mode 100644
index 6459493b4bbd..000000000000
--- a/unit_tests/datastore/test_client.py
+++ /dev/null
@@ -1,1058 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-def _make_entity_pb(project, kind, integer_id, name=None, str_val=None):
-    from google.cloud.datastore._generated import entity_pb2
-    from google.cloud.datastore.helpers import _new_value_pb
-
-    entity_pb = entity_pb2.Entity()
-    entity_pb.key.partition_id.project_id = project
-    path_element = entity_pb.key.path.add()
-    path_element.kind = kind
-    path_element.id = integer_id
-    if name is not None and str_val is not None:
-        value_pb = _new_value_pb(entity_pb, name)
-        value_pb.string_value = str_val
-
-    return entity_pb
-
-
-class Test__get_gcd_project(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud.datastore.client import _get_gcd_project
-        return _get_gcd_project()
-
-    def test_no_value(self):
-        import os
-        from unit_tests._testing import _Monkey
-
-        environ = {}
-        with _Monkey(os, getenv=environ.get):
-            project = self._callFUT()
-            self.assertIsNone(project)
-
-    def test_value_set(self):
-        import os
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore.client import GCD_DATASET
-
-        MOCK_PROJECT = object()
-        environ = {GCD_DATASET: MOCK_PROJECT}
-        with _Monkey(os, getenv=environ.get):
-            project = self._callFUT()
-            self.assertEqual(project, MOCK_PROJECT)
-
-
-class Test__determine_default_project(unittest.TestCase):
-
-    def _callFUT(self, project=None):
-        from google.cloud.datastore.client import (
-            _determine_default_project)
-        return _determine_default_project(project=project)
-
-    def _determine_default_helper(self, gcd=None, fallback=None,
-                                  project_called=None):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import client
-
-        _callers = []
-
-        def gcd_mock():
-            _callers.append('gcd_mock')
-            return gcd
-
-        def fallback_mock(project=None):
-            _callers.append(('fallback_mock', project))
-            return fallback
-
-        patched_methods = {
-            '_get_gcd_project': gcd_mock,
-            '_base_default_project': fallback_mock,
-        }
-
-        with _Monkey(client, **patched_methods):
-            returned_project = self._callFUT(project_called)
-
-        return returned_project, _callers
-
-    def test_no_value(self):
-        project, callers = self._determine_default_helper()
-        self.assertIsNone(project)
-        self.assertEqual(callers, ['gcd_mock', ('fallback_mock', None)])
-
-    def test_explicit(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(
-            project_called=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, [])
-
-    def test_gcd(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(gcd=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, ['gcd_mock'])
-
-    def test_fallback(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(fallback=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, ['gcd_mock', ('fallback_mock', None)])
-
-
-class TestClient(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-
-    def setUp(self):
-        KLASS = self._getTargetClass()
-        self.original_cnxn_class = KLASS._connection_class
-        KLASS._connection_class = _MockConnection
-
-    def tearDown(self):
-        KLASS = self._getTargetClass()
-        KLASS._connection_class = self.original_cnxn_class
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.client import Client
-        return Client
-
-    def _makeOne(self, project=PROJECT, namespace=None,
-                 credentials=None, http=None):
-        return self._getTargetClass()(project=project,
-                                      namespace=namespace,
-                                      credentials=credentials,
-                                      http=http)
-
-    def test_ctor_w_project_no_environ(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import client as _MUT
-
-        # Some environments (e.g. AppVeyor CI) run in GCE, so
-        # this test would fail artificially.
-        with _Monkey(_MUT, _base_default_project=lambda project: None):
-            self.assertRaises(EnvironmentError, self._makeOne, None)
-
-    def test_ctor_w_implicit_inputs(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import client as _MUT
-        from google.cloud import client as _base_client
-
-        OTHER = 'other'
-        creds = object()
-        default_called = []
-
-        def fallback_mock(project):
-            default_called.append(project)
-            return project or OTHER
-
-        klass = self._getTargetClass()
-        with _Monkey(_MUT,
-                     _determine_default_project=fallback_mock):
-            with _Monkey(_base_client,
-                         get_credentials=lambda: creds):
-                client = klass()
-        self.assertEqual(client.project, OTHER)
-        self.assertIsNone(client.namespace)
-        self.assertIsInstance(client.connection, _MockConnection)
-        self.assertIs(client.connection.credentials, creds)
-        self.assertIsNone(client.connection.http)
-        self.assertIsNone(client.current_batch)
-        self.assertIsNone(client.current_transaction)
-        self.assertEqual(default_called, [None])
-
-    def test_ctor_w_explicit_inputs(self):
-        OTHER = 'other'
-        NAMESPACE = 'namespace'
-        creds = object()
-        http = object()
-        client = self._makeOne(project=OTHER,
-                               namespace=NAMESPACE,
-                               credentials=creds,
-                               http=http)
-        self.assertEqual(client.project, OTHER)
-        self.assertEqual(client.namespace, NAMESPACE)
-        self.assertIsInstance(client.connection, _MockConnection)
-        self.assertIs(client.connection.credentials, creds)
-        self.assertIs(client.connection.http, http)
-        self.assertIsNone(client.current_batch)
-        self.assertEqual(list(client._batch_stack), [])
-
-    def test__push_batch_and__pop_batch(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        batch = client.batch()
-        xact = client.transaction()
-        client._push_batch(batch)
-        self.assertEqual(list(client._batch_stack), [batch])
-        self.assertIs(client.current_batch, batch)
-        self.assertIsNone(client.current_transaction)
-        client._push_batch(xact)
-        self.assertIs(client.current_batch, xact)
-        self.assertIs(client.current_transaction, xact)
-        # list(_LocalStack) returns in reverse order.
-        self.assertEqual(list(client._batch_stack), [xact, batch])
-        self.assertIs(client._pop_batch(), xact)
-        self.assertEqual(list(client._batch_stack), [batch])
-        self.assertIs(client._pop_batch(), batch)
-        self.assertEqual(list(client._batch_stack), [])
-
-    def test_get_miss(self):
-        _called_with = []
-
-        def _get_multi(*args, **kw):
-            _called_with.append((args, kw))
-            return []
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.get_multi = _get_multi
-
-        key = object()
-
-        self.assertIsNone(client.get(key))
-
-        self.assertEqual(_called_with[0][0], ())
-        self.assertEqual(_called_with[0][1]['keys'], [key])
-        self.assertIsNone(_called_with[0][1]['missing'])
-        self.assertIsNone(_called_with[0][1]['deferred'])
-        self.assertIsNone(_called_with[0][1]['transaction'])
-
-    def test_get_hit(self):
-        TXN_ID = '123'
-        _called_with = []
-        _entity = object()
-
-        def _get_multi(*args, **kw):
-            _called_with.append((args, kw))
-            return [_entity]
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.get_multi = _get_multi
-
-        key, missing, deferred = object(), [], []
-
-        self.assertIs(client.get(key, missing, deferred, TXN_ID), _entity)
-
-        self.assertEqual(_called_with[0][0], ())
-        self.assertEqual(_called_with[0][1]['keys'], [key])
-        self.assertIs(_called_with[0][1]['missing'], missing)
-        self.assertIs(_called_with[0][1]['deferred'], deferred)
-        self.assertEqual(_called_with[0][1]['transaction'], TXN_ID)
-
-    def test_get_multi_no_keys(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        results = client.get_multi([])
-        self.assertEqual(results, [])
-
-    def test_get_multi_miss(self):
-        from google.cloud.datastore.key import Key
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._add_lookup_result()
-        key = Key('Kind', 1234, project=self.PROJECT)
-        results = client.get_multi([key])
-        self.assertEqual(results, [])
-
-    def test_get_multi_miss_w_missing(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.key import Key
-
-        KIND = 'Kind'
-        ID = 1234
-
-        # Make a missing entity pb to be returned from mock backend.
-        missed = entity_pb2.Entity()
-        missed.key.partition_id.project_id = self.PROJECT
-        path_element = missed.key.path.add()
-        path_element.kind = KIND
-        path_element.id = ID
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        # Set missing entity on mock connection.
-        client.connection._add_lookup_result(missing=[missed])
-
-        key = Key(KIND, ID, project=self.PROJECT)
-        missing = []
-        entities = client.get_multi([key], missing=missing)
-        self.assertEqual(entities, [])
-        self.assertEqual([missed.key.to_protobuf() for missed in missing],
-                         [key.to_protobuf()])
-
-    def test_get_multi_w_missing_non_empty(self):
-        from google.cloud.datastore.key import Key
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        key = Key('Kind', 1234, project=self.PROJECT)
-
-        missing = ['this', 'list', 'is', 'not', 'empty']
-        self.assertRaises(ValueError, client.get_multi,
-                          [key], missing=missing)
-
-    def test_get_multi_w_deferred_non_empty(self):
-        from google.cloud.datastore.key import Key
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        key = Key('Kind', 1234, project=self.PROJECT)
-
-        deferred = ['this', 'list', 'is', 'not', 'empty']
-        self.assertRaises(ValueError, client.get_multi,
-                          [key], deferred=deferred)
-
-    def test_get_multi_miss_w_deferred(self):
-        from google.cloud.datastore.key import Key
-
-        key = Key('Kind', 1234, project=self.PROJECT)
-
-        # Set deferred entity on mock connection.
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._add_lookup_result(deferred=[key.to_protobuf()])
-
-        deferred = []
-        entities = client.get_multi([key], deferred=deferred)
-        self.assertEqual(entities, [])
-        self.assertEqual([def_key.to_protobuf() for def_key in deferred],
-                         [key.to_protobuf()])
-
-    def test_get_multi_w_deferred_from_backend_but_not_passed(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.key import Key
-
-        key1 = Key('Kind', project=self.PROJECT)
-        key1_pb = key1.to_protobuf()
-        key2 = Key('Kind', 2345, project=self.PROJECT)
-        key2_pb = key2.to_protobuf()
-
-        entity1_pb = entity_pb2.Entity()
-        entity1_pb.key.CopyFrom(key1_pb)
-        entity2_pb = entity_pb2.Entity()
-        entity2_pb.key.CopyFrom(key2_pb)
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        # mock up two separate requests
-        client.connection._add_lookup_result([entity1_pb], deferred=[key2_pb])
-        client.connection._add_lookup_result([entity2_pb])
-
-        missing = []
-        found = client.get_multi([key1, key2], missing=missing)
-        self.assertEqual(len(found), 2)
-        self.assertEqual(len(missing), 0)
-
-        # Check the actual contents on the response.
-        self.assertIsInstance(found[0], Entity)
-        self.assertEqual(found[0].key.path, key1.path)
-        self.assertEqual(found[0].key.project, key1.project)
-
-        self.assertIsInstance(found[1], Entity)
-        self.assertEqual(found[1].key.path, key2.path)
-        self.assertEqual(found[1].key.project, key2.project)
-
-        cw = client.connection._lookup_cw
-        self.assertEqual(len(cw), 2)
-
-        ds_id, k_pbs, eventual, tid = cw[0]
-        self.assertEqual(ds_id, self.PROJECT)
-        self.assertEqual(len(k_pbs), 2)
-        self.assertEqual(key1_pb, k_pbs[0])
-        self.assertEqual(key2_pb, k_pbs[1])
-        self.assertFalse(eventual)
-        self.assertIsNone(tid)
-
-        ds_id, k_pbs, eventual, tid = cw[1]
-        self.assertEqual(ds_id, self.PROJECT)
-        self.assertEqual(len(k_pbs), 1)
-        self.assertEqual(key2_pb, k_pbs[0])
-        self.assertFalse(eventual)
-        self.assertIsNone(tid)
-
-    def test_get_multi_hit(self):
-        from google.cloud.datastore.key import Key
-
-        KIND = 'Kind'
-        ID = 1234
-        PATH = [{'kind': KIND, 'id': ID}]
-
-        # Make a found entity pb to be returned from mock backend.
-        entity_pb = _make_entity_pb(self.PROJECT, KIND, ID, 'foo', 'Foo')
-
-        # Make a connection to return the entity pb.
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._add_lookup_result([entity_pb])
-
-        key = Key(KIND, ID, project=self.PROJECT)
-        result, = client.get_multi([key])
-        new_key = result.key
-
-        # Check the returned value is as expected.
-        self.assertIsNot(new_key, key)
-        self.assertEqual(new_key.project, self.PROJECT)
-        self.assertEqual(new_key.path, PATH)
-        self.assertEqual(list(result), ['foo'])
-        self.assertEqual(result['foo'], 'Foo')
-
-    def test_get_multi_hit_w_transaction(self):
-        from google.cloud.datastore.key import Key
-
-        TXN_ID = '123'
-        KIND = 'Kind'
-        ID = 1234
-        PATH = [{'kind': KIND, 'id': ID}]
-
-        # Make a found entity pb to be returned from mock backend.
-        entity_pb = _make_entity_pb(self.PROJECT, KIND, ID, 'foo', 'Foo')
-
-        # Make a connection to return the entity pb.
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._add_lookup_result([entity_pb])
-
-        key = Key(KIND, ID, project=self.PROJECT)
-        txn = client.transaction()
-        txn._id = TXN_ID
-        result, = client.get_multi([key], transaction=txn)
-        new_key = result.key
-
-        # Check the returned value is as expected.
-        self.assertIsNot(new_key, key)
-        self.assertEqual(new_key.project, self.PROJECT)
-        self.assertEqual(new_key.path, PATH)
-        self.assertEqual(list(result), ['foo'])
-        self.assertEqual(result['foo'], 'Foo')
-
-        cw = client.connection._lookup_cw
-        self.assertEqual(len(cw), 1)
-        _, _, _, transaction_id = cw[0]
-        self.assertEqual(transaction_id, TXN_ID)
-
-    def test_get_multi_hit_multiple_keys_same_project(self):
-        from google.cloud.datastore.key import Key
-
-        KIND = 'Kind'
-        ID1 = 1234
-        ID2 = 2345
-
-        # Make a found entity pb to be returned from mock backend.
-        entity_pb1 = _make_entity_pb(self.PROJECT, KIND, ID1)
-        entity_pb2 = _make_entity_pb(self.PROJECT, KIND, ID2)
-
-        # Make a connection to return the entity pbs.
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._add_lookup_result([entity_pb1, entity_pb2])
-
-        key1 = Key(KIND, ID1, project=self.PROJECT)
-        key2 = Key(KIND, ID2, project=self.PROJECT)
-        retrieved1, retrieved2 = client.get_multi([key1, key2])
-
-        # Check values match.
-        self.assertEqual(retrieved1.key.path, key1.path)
-        self.assertEqual(dict(retrieved1), {})
-        self.assertEqual(retrieved2.key.path, key2.path)
-        self.assertEqual(dict(retrieved2), {})
-
-    def test_get_multi_hit_multiple_keys_different_project(self):
-        from google.cloud.datastore.key import Key
-
-        PROJECT1 = 'PROJECT'
-        PROJECT2 = 'PROJECT-ALT'
-
-        # Make sure our IDs are actually different.
-        self.assertNotEqual(PROJECT1, PROJECT2)
-
-        key1 = Key('KIND', 1234, project=PROJECT1)
-        key2 = Key('KIND', 1234, project=PROJECT2)
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        with self.assertRaises(ValueError):
-            client.get_multi([key1, key2])
-
-    def test_get_multi_max_loops(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import client as _MUT
-        from google.cloud.datastore.key import Key
-
-        KIND = 'Kind'
-        ID = 1234
-
-        # Make a found entity pb to be returned from mock backend.
-        entity_pb = _make_entity_pb(self.PROJECT, KIND, ID, 'foo', 'Foo')
-
-        # Make a connection to return the entity pb.
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._add_lookup_result([entity_pb])
-
-        key = Key(KIND, ID, project=self.PROJECT)
-        deferred = []
-        missing = []
-        with _Monkey(_MUT, _MAX_LOOPS=-1):
-            result = client.get_multi([key], missing=missing,
-                                      deferred=deferred)
-
-        # Make sure we have no results, even though the connection has been
-        # set up as in `test_hit` to return a single result.
-        self.assertEqual(result, [])
-        self.assertEqual(missing, [])
-        self.assertEqual(deferred, [])
-
-    def test_put(self):
-        _called_with = []
-
-        def _put_multi(*args, **kw):
-            _called_with.append((args, kw))
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.put_multi = _put_multi
-        entity = object()
-
-        client.put(entity)
-
-        self.assertEqual(_called_with[0][0], ())
-        self.assertEqual(_called_with[0][1]['entities'], [entity])
-
-    def test_put_multi_no_entities(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        self.assertIsNone(client.put_multi([]))
-
-    def test_put_multi_w_single_empty_entity(self):
-        # https://github.com/GoogleCloudPlatform/google-cloud-python/issues/649
-        from google.cloud.datastore.entity import Entity
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        self.assertRaises(ValueError, client.put_multi, Entity())
-
-    def test_put_multi_no_batch_w_partial_key(self):
-        from google.cloud.datastore.helpers import _property_tuples
-
-        entity = _Entity(foo=u'bar')
-        key = entity.key = _Key(self.PROJECT)
-        key._id = None
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._commit.append([_KeyPB(key)])
-
-        result = client.put_multi([entity])
-        self.assertIsNone(result)
-
-        self.assertEqual(len(client.connection._commit_cw), 1)
-        (project,
-         commit_req, transaction_id) = client.connection._commit_cw[0]
-        self.assertEqual(project, self.PROJECT)
-
-        mutated_entity = _mutated_pb(self, commit_req.mutations, 'insert')
-        self.assertEqual(mutated_entity.key, key.to_protobuf())
-
-        prop_list = list(_property_tuples(mutated_entity))
-        self.assertTrue(len(prop_list), 1)
-        name, value_pb = prop_list[0]
-        self.assertEqual(name, 'foo')
-        self.assertEqual(value_pb.string_value, u'bar')
-
-        self.assertIsNone(transaction_id)
-
-    def test_put_multi_existing_batch_w_completed_key(self):
-        from google.cloud.datastore.helpers import _property_tuples
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        entity = _Entity(foo=u'bar')
-        key = entity.key = _Key(self.PROJECT)
-
-        with _NoCommitBatch(client) as CURR_BATCH:
-            result = client.put_multi([entity])
-
-        self.assertIsNone(result)
-        mutated_entity = _mutated_pb(self, CURR_BATCH.mutations, 'upsert')
-        self.assertEqual(mutated_entity.key, key.to_protobuf())
-
-        prop_list = list(_property_tuples(mutated_entity))
-        self.assertTrue(len(prop_list), 1)
-        name, value_pb = prop_list[0]
-        self.assertEqual(name, 'foo')
-        self.assertEqual(value_pb.string_value, u'bar')
-
-    def test_delete(self):
-        _called_with = []
-
-        def _delete_multi(*args, **kw):
-            _called_with.append((args, kw))
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.delete_multi = _delete_multi
-        key = object()
-
-        client.delete(key)
-
-        self.assertEqual(_called_with[0][0], ())
-        self.assertEqual(_called_with[0][1]['keys'], [key])
-
-    def test_delete_multi_no_keys(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        result = client.delete_multi([])
-        self.assertIsNone(result)
-        self.assertEqual(len(client.connection._commit_cw), 0)
-
-    def test_delete_multi_no_batch(self):
-        key = _Key(self.PROJECT)
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        client.connection._commit.append([])
-
-        result = client.delete_multi([key])
-        self.assertIsNone(result)
-        self.assertEqual(len(client.connection._commit_cw), 1)
-        (project,
-         commit_req, transaction_id) = client.connection._commit_cw[0]
-        self.assertEqual(project, self.PROJECT)
-
-        mutated_key = _mutated_pb(self, commit_req.mutations, 'delete')
-        self.assertEqual(mutated_key, key.to_protobuf())
-        self.assertIsNone(transaction_id)
-
-    def test_delete_multi_w_existing_batch(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        key = _Key(self.PROJECT)
-
-        with _NoCommitBatch(client) as CURR_BATCH:
-            result = client.delete_multi([key])
-
-        self.assertIsNone(result)
-        mutated_key = _mutated_pb(self, CURR_BATCH.mutations, 'delete')
-        self.assertEqual(mutated_key, key._key)
-        self.assertEqual(len(client.connection._commit_cw), 0)
-
-    def test_delete_multi_w_existing_transaction(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        key = _Key(self.PROJECT)
-
-        with _NoCommitTransaction(client) as CURR_XACT:
-            result = client.delete_multi([key])
-
-        self.assertIsNone(result)
-        mutated_key = _mutated_pb(self, CURR_XACT.mutations, 'delete')
-        self.assertEqual(mutated_key, key._key)
-        self.assertEqual(len(client.connection._commit_cw), 0)
-
-    def test_allocate_ids_w_partial_key(self):
-        NUM_IDS = 2
-
-        INCOMPLETE_KEY = _Key(self.PROJECT)
-        INCOMPLETE_KEY._id = None
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        result = client.allocate_ids(INCOMPLETE_KEY, NUM_IDS)
-
-        # Check the IDs returned.
-        self.assertEqual([key._id for key in result], list(range(NUM_IDS)))
-
-    def test_allocate_ids_with_completed_key(self):
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        COMPLETE_KEY = _Key(self.PROJECT)
-        self.assertRaises(ValueError, client.allocate_ids, COMPLETE_KEY, 2)
-
-    def test_key_w_project(self):
-        KIND = 'KIND'
-        ID = 1234
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        self.assertRaises(TypeError,
-                          client.key, KIND, ID, project=self.PROJECT)
-
-    def test_key_wo_project(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        KIND = 'KIND'
-        ID = 1234
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        with _Monkey(MUT, Key=_Dummy):
-            key = client.key(KIND, ID)
-
-        self.assertIsInstance(key, _Dummy)
-        self.assertEqual(key.args, (KIND, ID))
-        expected_kwargs = {
-            'project': self.PROJECT,
-            'namespace': None,
-        }
-        self.assertEqual(key.kwargs, expected_kwargs)
-
-    def test_key_w_namespace(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        KIND = 'KIND'
-        ID = 1234
-        NAMESPACE = object()
-
-        creds = object()
-        client = self._makeOne(namespace=NAMESPACE, credentials=creds)
-
-        with _Monkey(MUT, Key=_Dummy):
-            key = client.key(KIND, ID)
-
-        self.assertIsInstance(key, _Dummy)
-        expected_kwargs = {
-            'project': self.PROJECT,
-            'namespace': NAMESPACE,
-        }
-        self.assertEqual(key.kwargs, expected_kwargs)
-
-    def test_key_w_namespace_collision(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        KIND = 'KIND'
-        ID = 1234
-        NAMESPACE1 = object()
-        NAMESPACE2 = object()
-
-        creds = object()
-        client = self._makeOne(namespace=NAMESPACE1, credentials=creds)
-
-        with _Monkey(MUT, Key=_Dummy):
-            key = client.key(KIND, ID, namespace=NAMESPACE2)
-
-        self.assertIsInstance(key, _Dummy)
-        expected_kwargs = {
-            'project': self.PROJECT,
-            'namespace': NAMESPACE2,
-        }
-        self.assertEqual(key.kwargs, expected_kwargs)
-
-    def test_batch(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        with _Monkey(MUT, Batch=_Dummy):
-            batch = client.batch()
-
-        self.assertIsInstance(batch, _Dummy)
-        self.assertEqual(batch.args, (client,))
-        self.assertEqual(batch.kwargs, {})
-
-    def test_transaction_defaults(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        with _Monkey(MUT, Transaction=_Dummy):
-            xact = client.transaction()
-
-        self.assertIsInstance(xact, _Dummy)
-        self.assertEqual(xact.args, (client,))
-        self.assertEqual(xact.kwargs, {})
-
-    def test_query_w_client(self):
-        KIND = 'KIND'
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-        other = self._makeOne(credentials=object())
-
-        self.assertRaises(TypeError, client.query, kind=KIND, client=other)
-
-    def test_query_w_project(self):
-        KIND = 'KIND'
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        self.assertRaises(TypeError,
-                          client.query, kind=KIND, project=self.PROJECT)
-
-    def test_query_w_defaults(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        with _Monkey(MUT, Query=_Dummy):
-            query = client.query()
-
-        self.assertIsInstance(query, _Dummy)
-        self.assertEqual(query.args, (client,))
-        expected_kwargs = {
-            'project': self.PROJECT,
-            'namespace': None,
-        }
-        self.assertEqual(query.kwargs, expected_kwargs)
-
-    def test_query_explicit(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        KIND = 'KIND'
-        NAMESPACE = 'NAMESPACE'
-        ANCESTOR = object()
-        FILTERS = [('PROPERTY', '==', 'VALUE')]
-        PROJECTION = ['__key__']
-        ORDER = ['PROPERTY']
-        DISTINCT_ON = ['DISTINCT_ON']
-
-        creds = object()
-        client = self._makeOne(credentials=creds)
-
-        with _Monkey(MUT, Query=_Dummy):
-            query = client.query(
-                kind=KIND,
-                namespace=NAMESPACE,
-                ancestor=ANCESTOR,
-                filters=FILTERS,
-                projection=PROJECTION,
-                order=ORDER,
-                distinct_on=DISTINCT_ON,
-                )
-
-        self.assertIsInstance(query, _Dummy)
-        self.assertEqual(query.args, (client,))
-        kwargs = {
-            'project': self.PROJECT,
-            'kind': KIND,
-            'namespace': NAMESPACE,
-            'ancestor': ANCESTOR,
-            'filters': FILTERS,
-            'projection': PROJECTION,
-            'order': ORDER,
-            'distinct_on': DISTINCT_ON,
-        }
-        self.assertEqual(query.kwargs, kwargs)
-
-    def test_query_w_namespace(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        KIND = 'KIND'
-        NAMESPACE = object()
-
-        creds = object()
-        client = self._makeOne(namespace=NAMESPACE, credentials=creds)
-
-        with _Monkey(MUT, Query=_Dummy):
-            query = client.query(kind=KIND)
-
-        self.assertIsInstance(query, _Dummy)
-        self.assertEqual(query.args, (client,))
-        expected_kwargs = {
-            'project': self.PROJECT,
-            'namespace': NAMESPACE,
-            'kind': KIND,
-        }
-        self.assertEqual(query.kwargs, expected_kwargs)
-
-    def test_query_w_namespace_collision(self):
-        from google.cloud.datastore import client as MUT
-        from unit_tests._testing import _Monkey
-
-        KIND = 'KIND'
-        NAMESPACE1 = object()
-        NAMESPACE2 = object()
-
-        creds = object()
-        client = self._makeOne(namespace=NAMESPACE1, credentials=creds)
-
-        with _Monkey(MUT, Query=_Dummy):
-            query = client.query(kind=KIND, namespace=NAMESPACE2)
-
-        self.assertIsInstance(query, _Dummy)
-        self.assertEqual(query.args, (client,))
-        expected_kwargs = {
-            'project': self.PROJECT,
-            'namespace': NAMESPACE2,
-            'kind': KIND,
-        }
-        self.assertEqual(query.kwargs, expected_kwargs)
-
-
-class _Dummy(object):
-
-    def __init__(self, *args, **kwargs):
-        self.args = args
-        self.kwargs = kwargs
-
-
-class _MockConnection(object):
-
-    def __init__(self, credentials=None, http=None):
-        self.credentials = credentials
-        self.http = http
-        self._lookup_cw = []
-        self._lookup = []
-        self._commit_cw = []
-        self._commit = []
-        self._alloc_cw = []
-        self._alloc = []
-        self._index_updates = 0
-
-    def _add_lookup_result(self, results=(), missing=(), deferred=()):
-        self._lookup.append((list(results), list(missing), list(deferred)))
-
-    def lookup(self, project, key_pbs, eventual=False, transaction_id=None):
-        self._lookup_cw.append((project, key_pbs, eventual, transaction_id))
-        triple, self._lookup = self._lookup[0], self._lookup[1:]
-        results, missing, deferred = triple
-        return results, missing, deferred
-
-    def commit(self, project, commit_request, transaction_id):
-        self._commit_cw.append((project, commit_request, transaction_id))
-        response, self._commit = self._commit[0], self._commit[1:]
-        return self._index_updates, response
-
-    def allocate_ids(self, project, key_pbs):
-        self._alloc_cw.append((project, key_pbs))
-        num_pbs = len(key_pbs)
-        return [_KeyPB(i) for i in list(range(num_pbs))]
-
-
-class _NoCommitBatch(object):
-
-    def __init__(self, client):
-        from google.cloud.datastore.batch import Batch
-        self._client = client
-        self._batch = Batch(client)
-        self._batch.begin()
-
-    def __enter__(self):
-        self._client._push_batch(self._batch)
-        return self._batch
-
-    def __exit__(self, *args):
-        self._client._pop_batch()
-
-
-class _NoCommitTransaction(object):
-
-    def __init__(self, client, transaction_id='TRANSACTION'):
-        from google.cloud.datastore.batch import Batch
-        from google.cloud.datastore.transaction import Transaction
-        self._client = client
-        xact = self._transaction = Transaction(client)
-        xact._id = transaction_id
-        Batch.begin(xact)
-
-    def __enter__(self):
-        self._client._push_batch(self._transaction)
-        return self._transaction
-
-    def __exit__(self, *args):
-        self._client._pop_batch()
-
-
-class _Entity(dict):
-    key = None
-    exclude_from_indexes = ()
-    _meanings = {}
-
-
-class _Key(object):
-    _MARKER = object()
-    _kind = 'KIND'
-    _key = 'KEY'
-    _path = None
-    _id = 1234
-    _stored = None
-
-    def __init__(self, project):
-        self.project = project
-
-    @property
-    def is_partial(self):
-        return self._id is None
-
-    def to_protobuf(self):
-        from google.cloud.datastore._generated import entity_pb2
-        key = self._key = entity_pb2.Key()
-        # Don't assign it, because it will just get ripped out
-        # key.partition_id.project_id = self.project
-
-        element = key.path.add()
-        element.kind = self._kind
-        if self._id is not None:
-            element.id = self._id
-
-        return key
-
-    def completed_key(self, new_id):
-        assert self.is_partial
-        new_key = self.__class__(self.project)
-        new_key._id = new_id
-        return new_key
-
-
-class _PathElementPB(object):
-
-    def __init__(self, id_):
-        self.id = id_
-
-
-class _KeyPB(object):
-
-    def __init__(self, id_):
-        self.path = [_PathElementPB(id_)]
-
-
-def _assert_num_mutations(test_case, mutation_pb_list, num_mutations):
-    test_case.assertEqual(len(mutation_pb_list), num_mutations)
-
-
-def _mutated_pb(test_case, mutation_pb_list, mutation_type):
-    # Make sure there is only one mutation.
-    _assert_num_mutations(test_case, mutation_pb_list, 1)
-
-    # We grab the only mutation.
-    mutated_pb = mutation_pb_list[0]
-    # Then check if it is the correct type.
-    test_case.assertEqual(mutated_pb.WhichOneof('operation'),
-                          mutation_type)
-
-    return getattr(mutated_pb, mutation_type)
diff --git a/unit_tests/datastore/test_connection.py b/unit_tests/datastore/test_connection.py
deleted file mode 100644
index 5df1e08c762f..000000000000
--- a/unit_tests/datastore/test_connection.py
+++ /dev/null
@@ -1,1140 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-from google.cloud.datastore.connection import _HAVE_GRPC
-
-
-class Test_DatastoreAPIOverHttp(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.connection import _DatastoreAPIOverHttp
-        return _DatastoreAPIOverHttp
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test__rpc(self):
-        class ReqPB(object):
-
-            def SerializeToString(self):
-                return REQPB
-
-        class RspPB(object):
-
-            def __init__(self, pb):
-                self._pb = pb
-
-            @classmethod
-            def FromString(cls, pb):
-                return cls(pb)
-
-        REQPB = b'REQPB'
-        PROJECT = 'PROJECT'
-        METHOD = 'METHOD'
-        URI = 'http://api-url'
-        conn = _Connection(URI)
-        datastore_api = self._makeOne(conn)
-        http = conn.http = Http({'status': '200'}, 'CONTENT')
-        response = datastore_api._rpc(PROJECT, METHOD, ReqPB(), RspPB)
-        self.assertIsInstance(response, RspPB)
-        self.assertEqual(response._pb, 'CONTENT')
-        called_with = http._called_with
-        self.assertEqual(called_with['uri'], URI)
-        self.assertEqual(called_with['method'], 'POST')
-        self.assertEqual(called_with['headers']['Content-Type'],
-                         'application/x-protobuf')
-        self.assertEqual(called_with['headers']['User-Agent'],
-                         conn.USER_AGENT)
-        self.assertEqual(called_with['body'], REQPB)
-        self.assertEqual(conn.build_kwargs,
-                         [{'method': METHOD, 'project': PROJECT}])
-
-    def test__request_w_200(self):
-        PROJECT = 'PROJECT'
-        METHOD = 'METHOD'
-        DATA = b'DATA'
-        URI = 'http://api-url'
-        conn = _Connection(URI)
-        datastore_api = self._makeOne(conn)
-        http = conn.http = Http({'status': '200'}, 'CONTENT')
-        self.assertEqual(datastore_api._request(PROJECT, METHOD, DATA),
-                         'CONTENT')
-        called_with = http._called_with
-        self.assertEqual(called_with['uri'], URI)
-        self.assertEqual(called_with['method'], 'POST')
-        self.assertEqual(called_with['headers']['Content-Type'],
-                         'application/x-protobuf')
-        self.assertEqual(called_with['headers']['User-Agent'],
-                         conn.USER_AGENT)
-        self.assertEqual(called_with['body'], DATA)
-        self.assertEqual(conn.build_kwargs,
-                         [{'method': METHOD, 'project': PROJECT}])
-
-    def test__request_not_200(self):
-        from google.cloud.exceptions import BadRequest
-        from google.rpc import status_pb2
-
-        error = status_pb2.Status()
-        error.message = 'Entity value is indexed.'
-        error.code = 9  # FAILED_PRECONDITION
-
-        PROJECT = 'PROJECT'
-        METHOD = 'METHOD'
-        DATA = 'DATA'
-        URI = 'http://api-url'
-        conn = _Connection(URI)
-        datastore_api = self._makeOne(conn)
-        conn.http = Http({'status': '400'}, error.SerializeToString())
-        with self.assertRaises(BadRequest) as exc:
-            datastore_api._request(PROJECT, METHOD, DATA)
-        expected_message = '400 Entity value is indexed.'
-        self.assertEqual(str(exc.exception), expected_message)
-        self.assertEqual(conn.build_kwargs,
-                         [{'method': METHOD, 'project': PROJECT}])
-
-
-class Test_DatastoreAPIOverGRPC(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.connection import _DatastoreAPIOverGRPC
-        return _DatastoreAPIOverGRPC
-
-    def _makeOne(self, stub, connection=None, secure=True, mock_args=None):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import connection as MUT
-
-        if connection is None:
-            connection = _Connection(None)
-            connection.credentials = object()
-            connection.host = 'CURR_HOST'
-
-        if mock_args is None:
-            mock_args = []
-
-        def mock_make_stub(*args):
-            mock_args.append(args)
-            return stub
-
-        if secure:
-            to_monkey = {'make_secure_stub': mock_make_stub}
-        else:
-            to_monkey = {'make_insecure_stub': mock_make_stub}
-        with _Monkey(MUT, **to_monkey):
-            return self._getTargetClass()(connection, secure)
-
-    def test_constructor(self):
-        from google.cloud.datastore import connection as MUT
-
-        conn = _Connection(None)
-        conn.credentials = object()
-        conn.host = 'CURR_HOST'
-
-        stub = _GRPCStub()
-        mock_args = []
-        datastore_api = self._makeOne(stub, connection=conn,
-                                      mock_args=mock_args)
-        self.assertIs(datastore_api._stub, stub)
-
-        self.assertEqual(mock_args, [(
-            conn.credentials,
-            conn.USER_AGENT,
-            MUT.datastore_grpc_pb2.DatastoreStub,
-            conn.host,
-        )])
-
-    def test_constructor_insecure(self):
-        from google.cloud.datastore import connection as MUT
-
-        conn = _Connection(None)
-        conn.credentials = object()
-        conn.host = 'CURR_HOST:1234'
-
-        stub = _GRPCStub()
-        mock_args = []
-        datastore_api = self._makeOne(stub, connection=conn,
-                                      secure=False,
-                                      mock_args=mock_args)
-        self.assertIs(datastore_api._stub, stub)
-
-        self.assertEqual(mock_args, [(
-            MUT.datastore_grpc_pb2.DatastoreStub,
-            conn.host,
-        )])
-
-    def test_lookup(self):
-        return_val = object()
-        stub = _GRPCStub(return_val)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        result = datastore_api.lookup(project, request_pb)
-        self.assertIs(result, return_val)
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(stub.method_calls,
-                         [(request_pb, 'Lookup')])
-
-    def test_run_query(self):
-        return_val = object()
-        stub = _GRPCStub(return_val)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        result = datastore_api.run_query(project, request_pb)
-        self.assertIs(result, return_val)
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(stub.method_calls,
-                         [(request_pb, 'RunQuery')])
-
-    def test_begin_transaction(self):
-        return_val = object()
-        stub = _GRPCStub(return_val)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        result = datastore_api.begin_transaction(project, request_pb)
-        self.assertIs(result, return_val)
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(
-            stub.method_calls,
-            [(request_pb, 'BeginTransaction')])
-
-    def test_commit_success(self):
-        return_val = object()
-        stub = _GRPCStub(return_val)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        result = datastore_api.commit(project, request_pb)
-        self.assertIs(result, return_val)
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(stub.method_calls,
-                         [(request_pb, 'Commit')])
-
-    def _commit_failure_helper(self, exc, err_class):
-        stub = _GRPCStub(side_effect=exc)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        with self.assertRaises(err_class):
-            datastore_api.commit(project, request_pb)
-
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(stub.method_calls,
-                         [(request_pb, 'Commit')])
-
-    @unittest.skipUnless(_HAVE_GRPC, 'No gRPC')
-    def test_commit_failure_aborted(self):
-        from grpc import StatusCode
-        from grpc._channel import _RPCState
-        from google.cloud.exceptions import Conflict
-        from google.cloud.exceptions import GrpcRendezvous
-
-        details = 'Bad things.'
-        exc_state = _RPCState((), None, None, StatusCode.ABORTED, details)
-        exc = GrpcRendezvous(exc_state, None, None, None)
-        self._commit_failure_helper(exc, Conflict)
-
-    @unittest.skipUnless(_HAVE_GRPC, 'No gRPC')
-    def test_commit_failure_cancelled(self):
-        from grpc import StatusCode
-        from grpc._channel import _RPCState
-        from google.cloud.exceptions import GrpcRendezvous
-
-        exc_state = _RPCState((), None, None, StatusCode.CANCELLED, None)
-        exc = GrpcRendezvous(exc_state, None, None, None)
-        self._commit_failure_helper(exc, GrpcRendezvous)
-
-    @unittest.skipUnless(_HAVE_GRPC, 'No gRPC')
-    def test_commit_failure_non_grpc_err(self):
-        exc = RuntimeError('Not a gRPC error')
-        self._commit_failure_helper(exc, RuntimeError)
-
-    def test_rollback(self):
-        return_val = object()
-        stub = _GRPCStub(return_val)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        result = datastore_api.rollback(project, request_pb)
-        self.assertIs(result, return_val)
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(stub.method_calls,
-                         [(request_pb, 'Rollback')])
-
-    def test_allocate_ids(self):
-        return_val = object()
-        stub = _GRPCStub(return_val)
-        datastore_api = self._makeOne(stub=stub)
-
-        request_pb = _RequestPB()
-        project = 'PROJECT'
-        result = datastore_api.allocate_ids(project, request_pb)
-        self.assertIs(result, return_val)
-        self.assertEqual(request_pb.project_id, project)
-        self.assertEqual(
-            stub.method_calls,
-            [(request_pb, 'AllocateIds')])
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.connection import Connection
-
-        return Connection
-
-    def _make_key_pb(self, project, id_=1234):
-        from google.cloud.datastore.key import Key
-        path_args = ('Kind',)
-        if id_ is not None:
-            path_args += (id_,)
-        return Key(*path_args, project=project).to_protobuf()
-
-    def _make_query_pb(self, kind):
-        from google.cloud.datastore._generated import query_pb2
-        pb = query_pb2.Query()
-        pb.kind.add().name = kind
-        return pb
-
-    def _makeOne(self, credentials=None, http=None, use_grpc=False):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import connection as MUT
-        with _Monkey(MUT, _USE_GRPC=use_grpc):
-            return self._getTargetClass()(credentials=credentials, http=http)
-
-    def _verifyProtobufCall(self, called_with, URI, conn):
-        self.assertEqual(called_with['uri'], URI)
-        self.assertEqual(called_with['method'], 'POST')
-        self.assertEqual(called_with['headers']['Content-Type'],
-                         'application/x-protobuf')
-        self.assertEqual(called_with['headers']['User-Agent'],
-                         conn.USER_AGENT)
-
-    def test_default_url(self):
-        klass = self._getTargetClass()
-        conn = self._makeOne()
-        self.assertEqual(conn.api_base_url, klass.API_BASE_URL)
-
-    def test_custom_url_from_env(self):
-        import os
-        from unit_tests._testing import _Monkey
-        from google.cloud.connection import API_BASE_URL
-        from google.cloud.environment_vars import GCD_HOST
-
-        HOST = 'CURR_HOST'
-        fake_environ = {GCD_HOST: HOST}
-
-        with _Monkey(os, environ=fake_environ):
-            conn = self._makeOne()
-
-        self.assertNotEqual(conn.api_base_url, API_BASE_URL)
-        self.assertEqual(conn.api_base_url, 'http://' + HOST)
-
-    def test_ctor_defaults(self):
-        conn = self._makeOne()
-        self.assertIsNone(conn.credentials)
-
-    def test_ctor_without_grpc(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import connection as MUT
-
-        connections = []
-        return_val = object()
-
-        def mock_api(connection):
-            connections.append(connection)
-            return return_val
-
-        with _Monkey(MUT, _DatastoreAPIOverHttp=mock_api):
-            conn = self._makeOne(use_grpc=False)
-
-        self.assertIsNone(conn.credentials)
-        self.assertIs(conn._datastore_api, return_val)
-        self.assertEqual(connections, [conn])
-
-    def test_ctor_with_grpc(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore import connection as MUT
-
-        api_args = []
-        return_val = object()
-
-        def mock_api(connection, secure):
-            api_args.append((connection, secure))
-            return return_val
-
-        with _Monkey(MUT, _DatastoreAPIOverGRPC=mock_api):
-            conn = self._makeOne(use_grpc=True)
-
-        self.assertIsNone(conn.credentials)
-        self.assertIs(conn._datastore_api, return_val)
-        self.assertEqual(api_args, [(conn, True)])
-
-    def test_ctor_explicit(self):
-        class Creds(object):
-
-            def create_scoped_required(self):
-                return False
-
-        creds = Creds()
-        conn = self._makeOne(creds)
-        self.assertIs(conn.credentials, creds)
-
-    def test_http_w_existing(self):
-        conn = self._makeOne()
-        conn._http = http = object()
-        self.assertIs(conn.http, http)
-
-    def test_http_wo_creds(self):
-        import httplib2
-
-        conn = self._makeOne()
-        self.assertIsInstance(conn.http, httplib2.Http)
-
-    def test_http_w_creds(self):
-        import httplib2
-
-        authorized = object()
-
-        class Creds(object):
-
-            def authorize(self, http):
-                self._called_with = http
-                return authorized
-
-            def create_scoped_required(self):
-                return False
-
-        creds = Creds()
-        conn = self._makeOne(creds)
-        self.assertIs(conn.http, authorized)
-        self.assertIsInstance(creds._called_with, httplib2.Http)
-
-    def test_build_api_url_w_default_base_version(self):
-        PROJECT = 'PROJECT'
-        METHOD = 'METHOD'
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':' + METHOD,
-        ])
-        self.assertEqual(conn.build_api_url(PROJECT, METHOD), URI)
-
-    def test_build_api_url_w_explicit_base_version(self):
-        BASE = 'http://example.com/'
-        VER = '3.1415926'
-        PROJECT = 'PROJECT'
-        METHOD = 'METHOD'
-        conn = self._makeOne()
-        URI = '/'.join([
-            BASE,
-            VER,
-            'projects',
-            PROJECT + ':' + METHOD,
-        ])
-        self.assertEqual(conn.build_api_url(PROJECT, METHOD, BASE, VER),
-                         URI)
-
-    def test_lookup_single_key_empty_response(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        key_pb = self._make_key_pb(PROJECT)
-        rsp_pb = datastore_pb2.LookupResponse()
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        found, missing, deferred = conn.lookup(PROJECT, [key_pb])
-        self.assertEqual(len(found), 0)
-        self.assertEqual(len(missing), 0)
-        self.assertEqual(len(deferred), 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 1)
-        self.assertEqual(key_pb, keys[0])
-
-    def test_lookup_single_key_empty_response_w_eventual(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        key_pb = self._make_key_pb(PROJECT)
-        rsp_pb = datastore_pb2.LookupResponse()
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        found, missing, deferred = conn.lookup(PROJECT, [key_pb],
-                                               eventual=True)
-        self.assertEqual(len(found), 0)
-        self.assertEqual(len(missing), 0)
-        self.assertEqual(len(deferred), 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 1)
-        self.assertEqual(key_pb, keys[0])
-        self.assertEqual(request.read_options.read_consistency,
-                         datastore_pb2.ReadOptions.EVENTUAL)
-        self.assertEqual(request.read_options.transaction, b'')
-
-    def test_lookup_single_key_empty_response_w_eventual_and_transaction(self):
-        PROJECT = 'PROJECT'
-        TRANSACTION = b'TRANSACTION'
-        key_pb = self._make_key_pb(PROJECT)
-        conn = self._makeOne()
-        self.assertRaises(ValueError, conn.lookup, PROJECT, key_pb,
-                          eventual=True, transaction_id=TRANSACTION)
-
-    def test_lookup_single_key_empty_response_w_transaction(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        TRANSACTION = b'TRANSACTION'
-        key_pb = self._make_key_pb(PROJECT)
-        rsp_pb = datastore_pb2.LookupResponse()
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        found, missing, deferred = conn.lookup(PROJECT, [key_pb],
-                                               transaction_id=TRANSACTION)
-        self.assertEqual(len(found), 0)
-        self.assertEqual(len(missing), 0)
-        self.assertEqual(len(deferred), 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 1)
-        self.assertEqual(key_pb, keys[0])
-        self.assertEqual(request.read_options.transaction, TRANSACTION)
-
-    def test_lookup_single_key_nonempty_response(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import entity_pb2
-
-        PROJECT = 'PROJECT'
-        key_pb = self._make_key_pb(PROJECT)
-        rsp_pb = datastore_pb2.LookupResponse()
-        entity = entity_pb2.Entity()
-        entity.key.CopyFrom(key_pb)
-        rsp_pb.found.add(entity=entity)
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        (found,), missing, deferred = conn.lookup(PROJECT, [key_pb])
-        self.assertEqual(len(missing), 0)
-        self.assertEqual(len(deferred), 0)
-        self.assertEqual(found.key.path[0].kind, 'Kind')
-        self.assertEqual(found.key.path[0].id, 1234)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 1)
-        self.assertEqual(key_pb, keys[0])
-
-    def test_lookup_multiple_keys_empty_response(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        key_pb1 = self._make_key_pb(PROJECT)
-        key_pb2 = self._make_key_pb(PROJECT, id_=2345)
-        rsp_pb = datastore_pb2.LookupResponse()
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        found, missing, deferred = conn.lookup(PROJECT, [key_pb1, key_pb2])
-        self.assertEqual(len(found), 0)
-        self.assertEqual(len(missing), 0)
-        self.assertEqual(len(deferred), 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 2)
-        self.assertEqual(key_pb1, keys[0])
-        self.assertEqual(key_pb2, keys[1])
-
-    def test_lookup_multiple_keys_w_missing(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        key_pb1 = self._make_key_pb(PROJECT)
-        key_pb2 = self._make_key_pb(PROJECT, id_=2345)
-        rsp_pb = datastore_pb2.LookupResponse()
-        er_1 = rsp_pb.missing.add()
-        er_1.entity.key.CopyFrom(key_pb1)
-        er_2 = rsp_pb.missing.add()
-        er_2.entity.key.CopyFrom(key_pb2)
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        result, missing, deferred = conn.lookup(PROJECT, [key_pb1, key_pb2])
-        self.assertEqual(result, [])
-        self.assertEqual(len(deferred), 0)
-        self.assertEqual([missed.key for missed in missing],
-                         [key_pb1, key_pb2])
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 2)
-        self.assertEqual(key_pb1, keys[0])
-        self.assertEqual(key_pb2, keys[1])
-
-    def test_lookup_multiple_keys_w_deferred(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        key_pb1 = self._make_key_pb(PROJECT)
-        key_pb2 = self._make_key_pb(PROJECT, id_=2345)
-        rsp_pb = datastore_pb2.LookupResponse()
-        rsp_pb.deferred.add().CopyFrom(key_pb1)
-        rsp_pb.deferred.add().CopyFrom(key_pb2)
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':lookup',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        result, missing, deferred = conn.lookup(PROJECT, [key_pb1, key_pb2])
-        self.assertEqual(result, [])
-        self.assertEqual(len(missing), 0)
-        self.assertEqual([def_key for def_key in deferred], [key_pb1, key_pb2])
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        self.assertEqual(cw['uri'], URI)
-        self.assertEqual(cw['method'], 'POST')
-        self.assertEqual(cw['headers']['Content-Type'],
-                         'application/x-protobuf')
-        self.assertEqual(cw['headers']['User-Agent'], conn.USER_AGENT)
-        rq_class = datastore_pb2.LookupRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        keys = list(request.keys)
-        self.assertEqual(len(keys), 2)
-        self.assertEqual(key_pb1, keys[0])
-        self.assertEqual(key_pb2, keys[1])
-
-    def test_run_query_w_eventual_no_transaction(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import query_pb2
-
-        PROJECT = 'PROJECT'
-        KIND = 'Nonesuch'
-        CURSOR = b'\x00'
-        q_pb = self._make_query_pb(KIND)
-        rsp_pb = datastore_pb2.RunQueryResponse()
-        rsp_pb.batch.end_cursor = CURSOR
-        no_more = query_pb2.QueryResultBatch.NO_MORE_RESULTS
-        rsp_pb.batch.more_results = no_more
-        rsp_pb.batch.entity_result_type = query_pb2.EntityResult.FULL
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':runQuery',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        pbs, end, more, skipped = conn.run_query(PROJECT, q_pb,
-                                                 eventual=True)
-        self.assertEqual(pbs, [])
-        self.assertEqual(end, CURSOR)
-        self.assertTrue(more)
-        self.assertEqual(skipped, 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.RunQueryRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.partition_id.namespace_id, '')
-        self.assertEqual(request.query, q_pb)
-        self.assertEqual(request.read_options.read_consistency,
-                         datastore_pb2.ReadOptions.EVENTUAL)
-        self.assertEqual(request.read_options.transaction, b'')
-
-    def test_run_query_wo_eventual_w_transaction(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import query_pb2
-
-        PROJECT = 'PROJECT'
-        KIND = 'Nonesuch'
-        CURSOR = b'\x00'
-        TRANSACTION = b'TRANSACTION'
-        q_pb = self._make_query_pb(KIND)
-        rsp_pb = datastore_pb2.RunQueryResponse()
-        rsp_pb.batch.end_cursor = CURSOR
-        no_more = query_pb2.QueryResultBatch.NO_MORE_RESULTS
-        rsp_pb.batch.more_results = no_more
-        rsp_pb.batch.entity_result_type = query_pb2.EntityResult.FULL
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':runQuery',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        pbs, end, more, skipped = conn.run_query(
-            PROJECT, q_pb, transaction_id=TRANSACTION)
-        self.assertEqual(pbs, [])
-        self.assertEqual(end, CURSOR)
-        self.assertTrue(more)
-        self.assertEqual(skipped, 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.RunQueryRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.partition_id.namespace_id, '')
-        self.assertEqual(request.query, q_pb)
-        self.assertEqual(
-            request.read_options.read_consistency,
-            datastore_pb2.ReadOptions.READ_CONSISTENCY_UNSPECIFIED)
-        self.assertEqual(request.read_options.transaction, TRANSACTION)
-
-    def test_run_query_w_eventual_and_transaction(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import query_pb2
-
-        PROJECT = 'PROJECT'
-        KIND = 'Nonesuch'
-        CURSOR = b'\x00'
-        TRANSACTION = b'TRANSACTION'
-        q_pb = self._make_query_pb(KIND)
-        rsp_pb = datastore_pb2.RunQueryResponse()
-        rsp_pb.batch.end_cursor = CURSOR
-        no_more = query_pb2.QueryResultBatch.NO_MORE_RESULTS
-        rsp_pb.batch.more_results = no_more
-        rsp_pb.batch.entity_result_type = query_pb2.EntityResult.FULL
-        conn = self._makeOne()
-        self.assertRaises(ValueError, conn.run_query, PROJECT, q_pb,
-                          eventual=True, transaction_id=TRANSACTION)
-
-    def test_run_query_wo_namespace_empty_result(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import query_pb2
-
-        PROJECT = 'PROJECT'
-        KIND = 'Nonesuch'
-        CURSOR = b'\x00'
-        q_pb = self._make_query_pb(KIND)
-        rsp_pb = datastore_pb2.RunQueryResponse()
-        rsp_pb.batch.end_cursor = CURSOR
-        no_more = query_pb2.QueryResultBatch.NO_MORE_RESULTS
-        rsp_pb.batch.more_results = no_more
-        rsp_pb.batch.entity_result_type = query_pb2.EntityResult.FULL
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':runQuery',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        pbs, end, more, skipped = conn.run_query(PROJECT, q_pb)
-        self.assertEqual(pbs, [])
-        self.assertEqual(end, CURSOR)
-        self.assertTrue(more)
-        self.assertEqual(skipped, 0)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.RunQueryRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.partition_id.namespace_id, '')
-        self.assertEqual(request.query, q_pb)
-
-    def test_run_query_w_namespace_nonempty_result(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import entity_pb2
-
-        PROJECT = 'PROJECT'
-        KIND = 'Kind'
-        entity = entity_pb2.Entity()
-        q_pb = self._make_query_pb(KIND)
-        rsp_pb = datastore_pb2.RunQueryResponse()
-        rsp_pb.batch.entity_results.add(entity=entity)
-        rsp_pb.batch.entity_result_type = 1  # FULL
-        rsp_pb.batch.more_results = 3  # NO_MORE_RESULTS
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':runQuery',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        pbs = conn.run_query(PROJECT, q_pb, 'NS')[0]
-        self.assertEqual(len(pbs), 1)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.RunQueryRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.partition_id.namespace_id, 'NS')
-        self.assertEqual(request.query, q_pb)
-
-    def test_begin_transaction(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        TRANSACTION = b'TRANSACTION'
-        rsp_pb = datastore_pb2.BeginTransactionResponse()
-        rsp_pb.transaction = TRANSACTION
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':beginTransaction',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        self.assertEqual(conn.begin_transaction(PROJECT), TRANSACTION)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.BeginTransactionRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-
-    def test_commit_wo_transaction(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore import connection as MUT
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        PROJECT = 'PROJECT'
-        key_pb = self._make_key_pb(PROJECT)
-        rsp_pb = datastore_pb2.CommitResponse()
-        req_pb = datastore_pb2.CommitRequest()
-        mutation = req_pb.mutations.add()
-        insert = mutation.upsert
-        insert.key.CopyFrom(key_pb)
-        value_pb = _new_value_pb(insert, 'foo')
-        value_pb.string_value = u'Foo'
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':commit',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-
-        # Set up mock for parsing the response.
-        expected_result = object()
-        _parsed = []
-
-        def mock_parse(response):
-            _parsed.append(response)
-            return expected_result
-
-        with _Monkey(MUT, _parse_commit_response=mock_parse):
-            result = conn.commit(PROJECT, req_pb, None)
-
-        self.assertIs(result, expected_result)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.CommitRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.transaction, b'')
-        self.assertEqual(list(request.mutations), [mutation])
-        self.assertEqual(request.mode, rq_class.NON_TRANSACTIONAL)
-        self.assertEqual(_parsed, [rsp_pb])
-
-    def test_commit_w_transaction(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore import connection as MUT
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        PROJECT = 'PROJECT'
-        key_pb = self._make_key_pb(PROJECT)
-        rsp_pb = datastore_pb2.CommitResponse()
-        req_pb = datastore_pb2.CommitRequest()
-        mutation = req_pb.mutations.add()
-        insert = mutation.upsert
-        insert.key.CopyFrom(key_pb)
-        value_pb = _new_value_pb(insert, 'foo')
-        value_pb.string_value = u'Foo'
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':commit',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-
-        # Set up mock for parsing the response.
-        expected_result = object()
-        _parsed = []
-
-        def mock_parse(response):
-            _parsed.append(response)
-            return expected_result
-
-        with _Monkey(MUT, _parse_commit_response=mock_parse):
-            result = conn.commit(PROJECT, req_pb, b'xact')
-
-        self.assertIs(result, expected_result)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.CommitRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.transaction, b'xact')
-        self.assertEqual(list(request.mutations), [mutation])
-        self.assertEqual(request.mode, rq_class.TRANSACTIONAL)
-        self.assertEqual(_parsed, [rsp_pb])
-
-    def test_rollback_ok(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        PROJECT = 'PROJECT'
-        TRANSACTION = b'xact'
-
-        rsp_pb = datastore_pb2.RollbackResponse()
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':rollback',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        self.assertIsNone(conn.rollback(PROJECT, TRANSACTION))
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.RollbackRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(request.transaction, TRANSACTION)
-
-    def test_allocate_ids_empty(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        rsp_pb = datastore_pb2.AllocateIdsResponse()
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':allocateIds',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        self.assertEqual(conn.allocate_ids(PROJECT, []), [])
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.AllocateIdsRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(list(request.keys), [])
-
-    def test_allocate_ids_non_empty(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        PROJECT = 'PROJECT'
-        before_key_pbs = [
-            self._make_key_pb(PROJECT, id_=None),
-            self._make_key_pb(PROJECT, id_=None),
-            ]
-        after_key_pbs = [
-            self._make_key_pb(PROJECT),
-            self._make_key_pb(PROJECT, id_=2345),
-            ]
-        rsp_pb = datastore_pb2.AllocateIdsResponse()
-        rsp_pb.keys.add().CopyFrom(after_key_pbs[0])
-        rsp_pb.keys.add().CopyFrom(after_key_pbs[1])
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.api_base_url,
-            conn.API_VERSION,
-            'projects',
-            PROJECT + ':allocateIds',
-        ])
-        http = conn._http = Http({'status': '200'}, rsp_pb.SerializeToString())
-        self.assertEqual(conn.allocate_ids(PROJECT, before_key_pbs),
-                         after_key_pbs)
-        cw = http._called_with
-        self._verifyProtobufCall(cw, URI, conn)
-        rq_class = datastore_pb2.AllocateIdsRequest
-        request = rq_class()
-        request.ParseFromString(cw['body'])
-        self.assertEqual(len(request.keys), len(before_key_pbs))
-        for key_before, key_after in zip(before_key_pbs, request.keys):
-            self.assertEqual(key_before, key_after)
-
-
-class Test__parse_commit_response(unittest.TestCase):
-
-    def _callFUT(self, commit_response_pb):
-        from google.cloud.datastore.connection import _parse_commit_response
-        return _parse_commit_response(commit_response_pb)
-
-    def test_it(self):
-        from google.cloud.datastore._generated import datastore_pb2
-        from google.cloud.datastore._generated import entity_pb2
-
-        index_updates = 1337
-        keys = [
-            entity_pb2.Key(
-                path=[
-                    entity_pb2.Key.PathElement(
-                        kind='Foo',
-                        id=1234,
-                    ),
-                ],
-            ),
-            entity_pb2.Key(
-                path=[
-                    entity_pb2.Key.PathElement(
-                        kind='Bar',
-                        name='baz',
-                    ),
-                ],
-            ),
-        ]
-        response = datastore_pb2.CommitResponse(
-            mutation_results=[
-                datastore_pb2.MutationResult(key=key) for key in keys
-            ],
-            index_updates=index_updates,
-        )
-        result = self._callFUT(response)
-        self.assertEqual(result, (index_updates, keys))
-
-
-class Http(object):
-
-    _called_with = None
-
-    def __init__(self, headers, content):
-        from httplib2 import Response
-        self._response = Response(headers)
-        self._content = content
-
-    def request(self, **kw):
-        self._called_with = kw
-        return self._response, self._content
-
-
-class _Connection(object):
-
-    host = None
-    USER_AGENT = 'you-sir-age-int'
-
-    def __init__(self, api_url):
-        self.api_url = api_url
-        self.build_kwargs = []
-
-    def build_api_url(self, **kwargs):
-        self.build_kwargs.append(kwargs)
-        return self.api_url
-
-
-class _GRPCStub(object):
-
-    def __init__(self, return_val=None, side_effect=Exception):
-        self.return_val = return_val
-        self.side_effect = side_effect
-        self.method_calls = []
-
-    def _method(self, request_pb, name):
-        self.method_calls.append((request_pb, name))
-        return self.return_val
-
-    def Lookup(self, request_pb):
-        return self._method(request_pb, 'Lookup')
-
-    def RunQuery(self, request_pb):
-        return self._method(request_pb, 'RunQuery')
-
-    def BeginTransaction(self, request_pb):
-        return self._method(request_pb, 'BeginTransaction')
-
-    def Commit(self, request_pb):
-        result = self._method(request_pb, 'Commit')
-        if self.side_effect is Exception:
-            return result
-        else:
-            raise self.side_effect
-
-    def Rollback(self, request_pb):
-        return self._method(request_pb, 'Rollback')
-
-    def AllocateIds(self, request_pb):
-        return self._method(request_pb, 'AllocateIds')
-
-
-class _RequestPB(object):
-    project_id = None
diff --git a/unit_tests/datastore/test_entity.py b/unit_tests/datastore/test_entity.py
deleted file mode 100644
index 3091d28b721a..000000000000
--- a/unit_tests/datastore/test_entity.py
+++ /dev/null
@@ -1,211 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-_PROJECT = 'PROJECT'
-_KIND = 'KIND'
-_ID = 1234
-
-
-class TestEntity(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.entity import Entity
-        return Entity
-
-    def _makeOne(self, key=None, exclude_from_indexes=()):
-        klass = self._getTargetClass()
-        return klass(key=key, exclude_from_indexes=exclude_from_indexes)
-
-    def test_ctor_defaults(self):
-        klass = self._getTargetClass()
-        entity = klass()
-        self.assertIsNone(entity.key)
-        self.assertIsNone(entity.kind)
-        self.assertEqual(sorted(entity.exclude_from_indexes), [])
-
-    def test_ctor_explicit(self):
-        _EXCLUDE_FROM_INDEXES = ['foo', 'bar']
-        key = _Key()
-        entity = self._makeOne(
-            key=key, exclude_from_indexes=_EXCLUDE_FROM_INDEXES)
-        self.assertEqual(sorted(entity.exclude_from_indexes),
-                         sorted(_EXCLUDE_FROM_INDEXES))
-
-    def test_ctor_bad_exclude_from_indexes(self):
-        BAD_EXCLUDE_FROM_INDEXES = object()
-        key = _Key()
-        self.assertRaises(TypeError, self._makeOne, key=key,
-                          exclude_from_indexes=BAD_EXCLUDE_FROM_INDEXES)
-
-    def test___eq_____ne___w_non_entity(self):
-        from google.cloud.datastore.key import Key
-        key = Key(_KIND, _ID, project=_PROJECT)
-        entity = self._makeOne(key=key)
-        self.assertFalse(entity == object())
-        self.assertTrue(entity != object())
-
-    def test___eq_____ne___w_different_keys(self):
-        from google.cloud.datastore.key import Key
-        _ID1 = 1234
-        _ID2 = 2345
-        key1 = Key(_KIND, _ID1, project=_PROJECT)
-        entity1 = self._makeOne(key=key1)
-        key2 = Key(_KIND, _ID2, project=_PROJECT)
-        entity2 = self._makeOne(key=key2)
-        self.assertFalse(entity1 == entity2)
-        self.assertTrue(entity1 != entity2)
-
-    def test___eq_____ne___w_same_keys(self):
-        from google.cloud.datastore.key import Key
-
-        name = 'foo'
-        value = 42
-        meaning = 9
-
-        key1 = Key(_KIND, _ID, project=_PROJECT)
-        entity1 = self._makeOne(key=key1, exclude_from_indexes=(name,))
-        entity1[name] = value
-        entity1._meanings[name] = (meaning, value)
-
-        key2 = Key(_KIND, _ID, project=_PROJECT)
-        entity2 = self._makeOne(key=key2, exclude_from_indexes=(name,))
-        entity2[name] = value
-        entity2._meanings[name] = (meaning, value)
-
-        self.assertTrue(entity1 == entity2)
-        self.assertFalse(entity1 != entity2)
-
-    def test___eq_____ne___w_same_keys_different_props(self):
-        from google.cloud.datastore.key import Key
-        key1 = Key(_KIND, _ID, project=_PROJECT)
-        entity1 = self._makeOne(key=key1)
-        entity1['foo'] = 'Foo'
-        key2 = Key(_KIND, _ID, project=_PROJECT)
-        entity2 = self._makeOne(key=key2)
-        entity1['bar'] = 'Bar'
-        self.assertFalse(entity1 == entity2)
-        self.assertTrue(entity1 != entity2)
-
-    def test___eq_____ne___w_same_keys_props_w_equiv_keys_as_value(self):
-        from google.cloud.datastore.key import Key
-        key1 = Key(_KIND, _ID, project=_PROJECT)
-        key2 = Key(_KIND, _ID, project=_PROJECT)
-        entity1 = self._makeOne(key=key1)
-        entity1['some_key'] = key1
-        entity2 = self._makeOne(key=key1)
-        entity2['some_key'] = key2
-        self.assertTrue(entity1 == entity2)
-        self.assertFalse(entity1 != entity2)
-
-    def test___eq_____ne___w_same_keys_props_w_diff_keys_as_value(self):
-        from google.cloud.datastore.key import Key
-        _ID1 = 1234
-        _ID2 = 2345
-        key1 = Key(_KIND, _ID1, project=_PROJECT)
-        key2 = Key(_KIND, _ID2, project=_PROJECT)
-        entity1 = self._makeOne(key=key1)
-        entity1['some_key'] = key1
-        entity2 = self._makeOne(key=key1)
-        entity2['some_key'] = key2
-        self.assertFalse(entity1 == entity2)
-        self.assertTrue(entity1 != entity2)
-
-    def test___eq_____ne___w_same_keys_props_w_equiv_entities_as_value(self):
-        from google.cloud.datastore.key import Key
-        key = Key(_KIND, _ID, project=_PROJECT)
-        entity1 = self._makeOne(key=key)
-        sub1 = self._makeOne()
-        sub1.update({'foo': 'Foo'})
-        entity1['some_entity'] = sub1
-        entity2 = self._makeOne(key=key)
-        sub2 = self._makeOne()
-        sub2.update({'foo': 'Foo'})
-        entity2['some_entity'] = sub2
-        self.assertTrue(entity1 == entity2)
-        self.assertFalse(entity1 != entity2)
-
-    def test___eq_____ne___w_same_keys_props_w_diff_entities_as_value(self):
-        from google.cloud.datastore.key import Key
-        key = Key(_KIND, _ID, project=_PROJECT)
-        entity1 = self._makeOne(key=key)
-        sub1 = self._makeOne()
-        sub1.update({'foo': 'Foo'})
-        entity1['some_entity'] = sub1
-        entity2 = self._makeOne(key=key)
-        sub2 = self._makeOne()
-        sub2.update({'foo': 'Bar'})
-        entity2['some_entity'] = sub2
-        self.assertFalse(entity1 == entity2)
-        self.assertTrue(entity1 != entity2)
-
-    def test__eq__same_value_different_exclude(self):
-        from google.cloud.datastore.key import Key
-
-        name = 'foo'
-        value = 42
-        key = Key(_KIND, _ID, project=_PROJECT)
-
-        entity1 = self._makeOne(key=key, exclude_from_indexes=(name,))
-        entity1[name] = value
-
-        entity2 = self._makeOne(key=key, exclude_from_indexes=())
-        entity2[name] = value
-
-        self.assertFalse(entity1 == entity2)
-
-    def test__eq__same_value_different_meanings(self):
-        from google.cloud.datastore.key import Key
-
-        name = 'foo'
-        value = 42
-        meaning = 9
-        key = Key(_KIND, _ID, project=_PROJECT)
-
-        entity1 = self._makeOne(key=key, exclude_from_indexes=(name,))
-        entity1[name] = value
-
-        entity2 = self._makeOne(key=key, exclude_from_indexes=(name,))
-        entity2[name] = value
-        entity2._meanings[name] = (meaning, value)
-
-        self.assertFalse(entity1 == entity2)
-
-    def test___repr___no_key_empty(self):
-        entity = self._makeOne()
-        self.assertEqual(repr(entity), '<Entity {}>')
-
-    def test___repr___w_key_non_empty(self):
-        key = _Key()
-        key._path = '/bar/baz'
-        entity = self._makeOne(key=key)
-        entity['foo'] = 'Foo'
-        self.assertEqual(repr(entity), "<Entity/bar/baz {'foo': 'Foo'}>")
-
-
-class _Key(object):
-    _MARKER = object()
-    _key = 'KEY'
-    _partial = False
-    _path = None
-    _id = None
-    _stored = None
-
-    def __init__(self, project=_PROJECT):
-        self.project = project
-
-    @property
-    def path(self):
-        return self._path
diff --git a/unit_tests/datastore/test_helpers.py b/unit_tests/datastore/test_helpers.py
deleted file mode 100644
index 66811cfea0a8..000000000000
--- a/unit_tests/datastore/test_helpers.py
+++ /dev/null
@@ -1,926 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test__new_value_pb(unittest.TestCase):
-
-    def _callFUT(self, entity_pb, name):
-        from google.cloud.datastore.helpers import _new_value_pb
-        return _new_value_pb(entity_pb, name)
-
-    def test_it(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        entity_pb = entity_pb2.Entity()
-        name = 'foo'
-        result = self._callFUT(entity_pb, name)
-
-        self.assertIsInstance(result, entity_pb2.Value)
-        self.assertEqual(len(entity_pb.properties), 1)
-        self.assertEqual(entity_pb.properties[name], result)
-
-
-class Test__property_tuples(unittest.TestCase):
-
-    def _callFUT(self, entity_pb):
-        from google.cloud.datastore.helpers import _property_tuples
-        return _property_tuples(entity_pb)
-
-    def test_it(self):
-        import types
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        entity_pb = entity_pb2.Entity()
-        name1 = 'foo'
-        name2 = 'bar'
-        val_pb1 = _new_value_pb(entity_pb, name1)
-        val_pb2 = _new_value_pb(entity_pb, name2)
-
-        result = self._callFUT(entity_pb)
-        self.assertIsInstance(result, types.GeneratorType)
-        self.assertEqual(sorted(result),
-                         sorted([(name1, val_pb1), (name2, val_pb2)]))
-
-
-class Test_entity_from_protobuf(unittest.TestCase):
-
-    def _callFUT(self, val):
-        from google.cloud.datastore.helpers import entity_from_protobuf
-        return entity_from_protobuf(val)
-
-    def test_it(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 1234
-        entity_pb = entity_pb2.Entity()
-        entity_pb.key.partition_id.project_id = _PROJECT
-        entity_pb.key.path.add(kind=_KIND, id=_ID)
-
-        value_pb = _new_value_pb(entity_pb, 'foo')
-        value_pb.string_value = 'Foo'
-
-        unindexed_val_pb = _new_value_pb(entity_pb, 'bar')
-        unindexed_val_pb.integer_value = 10
-        unindexed_val_pb.exclude_from_indexes = True
-
-        array_val_pb1 = _new_value_pb(entity_pb, 'baz')
-        array_pb1 = array_val_pb1.array_value.values
-
-        unindexed_array_val_pb = array_pb1.add()
-        unindexed_array_val_pb.integer_value = 11
-        unindexed_array_val_pb.exclude_from_indexes = True
-
-        array_val_pb2 = _new_value_pb(entity_pb, 'qux')
-        array_pb2 = array_val_pb2.array_value.values
-
-        indexed_array_val_pb = array_pb2.add()
-        indexed_array_val_pb.integer_value = 12
-
-        entity = self._callFUT(entity_pb)
-        self.assertEqual(entity.kind, _KIND)
-        self.assertEqual(entity.exclude_from_indexes,
-                         frozenset(['bar', 'baz']))
-        entity_props = dict(entity)
-        self.assertEqual(entity_props,
-                         {'foo': 'Foo', 'bar': 10, 'baz': [11], 'qux': [12]})
-
-        # Also check the key.
-        key = entity.key
-        self.assertEqual(key.project, _PROJECT)
-        self.assertIsNone(key.namespace)
-        self.assertEqual(key.kind, _KIND)
-        self.assertEqual(key.id, _ID)
-
-    def test_mismatched_value_indexed(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 1234
-        entity_pb = entity_pb2.Entity()
-        entity_pb.key.partition_id.project_id = _PROJECT
-        entity_pb.key.path.add(kind=_KIND, id=_ID)
-
-        array_val_pb = _new_value_pb(entity_pb, 'baz')
-        array_pb = array_val_pb.array_value.values
-
-        unindexed_value_pb1 = array_pb.add()
-        unindexed_value_pb1.integer_value = 10
-        unindexed_value_pb1.exclude_from_indexes = True
-
-        unindexed_value_pb2 = array_pb.add()
-        unindexed_value_pb2.integer_value = 11
-
-        with self.assertRaises(ValueError):
-            self._callFUT(entity_pb)
-
-    def test_entity_no_key(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        entity_pb = entity_pb2.Entity()
-        entity = self._callFUT(entity_pb)
-
-        self.assertIsNone(entity.key)
-        self.assertEqual(dict(entity), {})
-
-    def test_entity_with_meaning(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        entity_pb = entity_pb2.Entity()
-        name = 'hello'
-        value_pb = _new_value_pb(entity_pb, name)
-        value_pb.meaning = meaning = 9
-        value_pb.string_value = val = u'something'
-
-        entity = self._callFUT(entity_pb)
-        self.assertIsNone(entity.key)
-        self.assertEqual(dict(entity), {name: val})
-        self.assertEqual(entity._meanings, {name: (meaning, val)})
-
-    def test_nested_entity_no_key(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        PROJECT = 'FOO'
-        KIND = 'KIND'
-        INSIDE_NAME = 'IFOO'
-        OUTSIDE_NAME = 'OBAR'
-        INSIDE_VALUE = 1337
-
-        entity_inside = entity_pb2.Entity()
-        inside_val_pb = _new_value_pb(entity_inside, INSIDE_NAME)
-        inside_val_pb.integer_value = INSIDE_VALUE
-
-        entity_pb = entity_pb2.Entity()
-        entity_pb.key.partition_id.project_id = PROJECT
-        element = entity_pb.key.path.add()
-        element.kind = KIND
-
-        outside_val_pb = _new_value_pb(entity_pb, OUTSIDE_NAME)
-        outside_val_pb.entity_value.CopyFrom(entity_inside)
-
-        entity = self._callFUT(entity_pb)
-        self.assertEqual(entity.key.project, PROJECT)
-        self.assertEqual(entity.key.flat_path, (KIND,))
-        self.assertEqual(len(entity), 1)
-
-        inside_entity = entity[OUTSIDE_NAME]
-        self.assertIsNone(inside_entity.key)
-        self.assertEqual(len(inside_entity), 1)
-        self.assertEqual(inside_entity[INSIDE_NAME], INSIDE_VALUE)
-
-
-class Test_entity_to_protobuf(unittest.TestCase):
-
-    def _callFUT(self, entity):
-        from google.cloud.datastore.helpers import entity_to_protobuf
-        return entity_to_protobuf(entity)
-
-    def _compareEntityProto(self, entity_pb1, entity_pb2):
-        from google.cloud.datastore.helpers import _property_tuples
-
-        self.assertEqual(entity_pb1.key, entity_pb2.key)
-        value_list1 = sorted(_property_tuples(entity_pb1))
-        value_list2 = sorted(_property_tuples(entity_pb2))
-        self.assertEqual(len(value_list1), len(value_list2))
-        for pair1, pair2 in zip(value_list1, value_list2):
-            name1, val1 = pair1
-            name2, val2 = pair2
-            self.assertEqual(name1, name2)
-            if val1.HasField('entity_value'):  # Message field (Entity)
-                self.assertEqual(val1.meaning, val2.meaning)
-                self._compareEntityProto(val1.entity_value,
-                                         val2.entity_value)
-            else:
-                self.assertEqual(val1, val2)
-
-    def test_empty(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-
-        entity = Entity()
-        entity_pb = self._callFUT(entity)
-        self._compareEntityProto(entity_pb, entity_pb2.Entity())
-
-    def test_key_only(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.key import Key
-
-        kind, name = 'PATH', 'NAME'
-        project = 'PROJECT'
-        key = Key(kind, name, project=project)
-        entity = Entity(key=key)
-        entity_pb = self._callFUT(entity)
-
-        expected_pb = entity_pb2.Entity()
-        expected_pb.key.partition_id.project_id = project
-        path_elt = expected_pb.key.path.add()
-        path_elt.kind = kind
-        path_elt.name = name
-
-        self._compareEntityProto(entity_pb, expected_pb)
-
-    def test_simple_fields(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        entity = Entity()
-        name1 = 'foo'
-        entity[name1] = value1 = 42
-        name2 = 'bar'
-        entity[name2] = value2 = u'some-string'
-        entity_pb = self._callFUT(entity)
-
-        expected_pb = entity_pb2.Entity()
-        val_pb1 = _new_value_pb(expected_pb, name1)
-        val_pb1.integer_value = value1
-        val_pb2 = _new_value_pb(expected_pb, name2)
-        val_pb2.string_value = value2
-
-        self._compareEntityProto(entity_pb, expected_pb)
-
-    def test_with_empty_list(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-
-        entity = Entity()
-        entity['foo'] = []
-        entity_pb = self._callFUT(entity)
-
-        self._compareEntityProto(entity_pb, entity_pb2.Entity())
-
-    def test_inverts_to_protobuf(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-        from google.cloud.datastore.helpers import entity_from_protobuf
-
-        original_pb = entity_pb2.Entity()
-        # Add a key.
-        original_pb.key.partition_id.project_id = project = 'PROJECT'
-        elem1 = original_pb.key.path.add()
-        elem1.kind = 'Family'
-        elem1.id = 1234
-        elem2 = original_pb.key.path.add()
-        elem2.kind = 'King'
-        elem2.name = 'Spades'
-
-        # Add an integer property.
-        val_pb1 = _new_value_pb(original_pb, 'foo')
-        val_pb1.integer_value = 1337
-        val_pb1.exclude_from_indexes = True
-        # Add a string property.
-        val_pb2 = _new_value_pb(original_pb, 'bar')
-        val_pb2.string_value = u'hello'
-
-        # Add a nested (entity) property.
-        val_pb3 = _new_value_pb(original_pb, 'entity-baz')
-        sub_pb = entity_pb2.Entity()
-        sub_val_pb1 = _new_value_pb(sub_pb, 'x')
-        sub_val_pb1.double_value = 3.14
-        sub_val_pb2 = _new_value_pb(sub_pb, 'y')
-        sub_val_pb2.double_value = 2.718281828
-        val_pb3.meaning = 9
-        val_pb3.entity_value.CopyFrom(sub_pb)
-
-        # Add a list property.
-        val_pb4 = _new_value_pb(original_pb, 'list-quux')
-        array_val1 = val_pb4.array_value.values.add()
-        array_val1.exclude_from_indexes = False
-        array_val1.meaning = meaning = 22
-        array_val1.blob_value = b'\xe2\x98\x83'
-        array_val2 = val_pb4.array_value.values.add()
-        array_val2.exclude_from_indexes = False
-        array_val2.meaning = meaning
-        array_val2.blob_value = b'\xe2\x98\x85'
-
-        # Convert to the user-space Entity.
-        entity = entity_from_protobuf(original_pb)
-        # Convert the user-space Entity back to a protobuf.
-        new_pb = self._callFUT(entity)
-
-        # NOTE: entity_to_protobuf() strips the project so we "cheat".
-        new_pb.key.partition_id.project_id = project
-        self._compareEntityProto(original_pb, new_pb)
-
-    def test_meaning_with_change(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        entity = Entity()
-        name = 'foo'
-        entity[name] = value = 42
-        entity._meanings[name] = (9, 1337)
-        entity_pb = self._callFUT(entity)
-
-        expected_pb = entity_pb2.Entity()
-        value_pb = _new_value_pb(expected_pb, name)
-        value_pb.integer_value = value
-        # NOTE: No meaning is used since the value differs from the
-        #       value stored.
-        self._compareEntityProto(entity_pb, expected_pb)
-
-    def test_variable_meanings(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        entity = Entity()
-        name = 'quux'
-        entity[name] = values = [1, 20, 300]
-        meaning = 9
-        entity._meanings[name] = ([None, meaning, None], values)
-        entity_pb = self._callFUT(entity)
-
-        # Construct the expected protobuf.
-        expected_pb = entity_pb2.Entity()
-        value_pb = _new_value_pb(expected_pb, name)
-        value0 = value_pb.array_value.values.add()
-        value0.integer_value = values[0]
-        # The only array entry with a meaning is the middle one.
-        value1 = value_pb.array_value.values.add()
-        value1.integer_value = values[1]
-        value1.meaning = meaning
-        value2 = value_pb.array_value.values.add()
-        value2.integer_value = values[2]
-
-        self._compareEntityProto(entity_pb, expected_pb)
-
-
-class Test_key_from_protobuf(unittest.TestCase):
-
-    def _callFUT(self, val):
-        from google.cloud.datastore.helpers import key_from_protobuf
-
-        return key_from_protobuf(val)
-
-    def _makePB(self, project=None, namespace=None, path=()):
-        from google.cloud.datastore._generated import entity_pb2
-        pb = entity_pb2.Key()
-        if project is not None:
-            pb.partition_id.project_id = project
-        if namespace is not None:
-            pb.partition_id.namespace_id = namespace
-        for elem in path:
-            added = pb.path.add()
-            added.kind = elem['kind']
-            if 'id' in elem:
-                added.id = elem['id']
-            if 'name' in elem:
-                added.name = elem['name']
-        return pb
-
-    def test_wo_namespace_in_pb(self):
-        _PROJECT = 'PROJECT'
-        pb = self._makePB(path=[{'kind': 'KIND'}], project=_PROJECT)
-        key = self._callFUT(pb)
-        self.assertEqual(key.project, _PROJECT)
-        self.assertIsNone(key.namespace)
-
-    def test_w_namespace_in_pb(self):
-        _PROJECT = 'PROJECT'
-        _NAMESPACE = 'NAMESPACE'
-        pb = self._makePB(path=[{'kind': 'KIND'}], namespace=_NAMESPACE,
-                          project=_PROJECT)
-        key = self._callFUT(pb)
-        self.assertEqual(key.project, _PROJECT)
-        self.assertEqual(key.namespace, _NAMESPACE)
-
-    def test_w_nested_path_in_pb(self):
-        _PATH = [
-            {'kind': 'PARENT', 'name': 'NAME'},
-            {'kind': 'CHILD', 'id': 1234},
-            {'kind': 'GRANDCHILD', 'id': 5678},
-        ]
-        pb = self._makePB(path=_PATH, project='PROJECT')
-        key = self._callFUT(pb)
-        self.assertEqual(key.path, _PATH)
-
-    def test_w_nothing_in_pb(self):
-        pb = self._makePB()
-        self.assertRaises(ValueError, self._callFUT, pb)
-
-
-class Test__pb_attr_value(unittest.TestCase):
-
-    def _callFUT(self, val):
-        from google.cloud.datastore.helpers import _pb_attr_value
-
-        return _pb_attr_value(val)
-
-    def test_datetime_naive(self):
-        import calendar
-        import datetime
-        from google.cloud._helpers import UTC
-
-        micros = 4375
-        naive = datetime.datetime(2014, 9, 16, 10, 19, 32, micros)  # No zone.
-        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
-        name, value = self._callFUT(naive)
-        self.assertEqual(name, 'timestamp_value')
-        self.assertEqual(value.seconds, calendar.timegm(utc.timetuple()))
-        self.assertEqual(value.nanos, 1000 * micros)
-
-    def test_datetime_w_zone(self):
-        import calendar
-        import datetime
-        from google.cloud._helpers import UTC
-
-        micros = 4375
-        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
-        name, value = self._callFUT(utc)
-        self.assertEqual(name, 'timestamp_value')
-        self.assertEqual(value.seconds, calendar.timegm(utc.timetuple()))
-        self.assertEqual(value.nanos, 1000 * micros)
-
-    def test_key(self):
-        from google.cloud.datastore.key import Key
-
-        key = Key('PATH', 1234, project='PROJECT')
-        name, value = self._callFUT(key)
-        self.assertEqual(name, 'key_value')
-        self.assertEqual(value, key.to_protobuf())
-
-    def test_bool(self):
-        name, value = self._callFUT(False)
-        self.assertEqual(name, 'boolean_value')
-        self.assertEqual(value, False)
-
-    def test_float(self):
-        name, value = self._callFUT(3.1415926)
-        self.assertEqual(name, 'double_value')
-        self.assertEqual(value, 3.1415926)
-
-    def test_int(self):
-        name, value = self._callFUT(42)
-        self.assertEqual(name, 'integer_value')
-        self.assertEqual(value, 42)
-
-    def test_long(self):
-        must_be_long = (1 << 63) - 1
-        name, value = self._callFUT(must_be_long)
-        self.assertEqual(name, 'integer_value')
-        self.assertEqual(value, must_be_long)
-
-    def test_native_str(self):
-        import six
-        name, value = self._callFUT('str')
-        if six.PY2:
-            self.assertEqual(name, 'blob_value')
-        else:  # pragma: NO COVER Python 3
-            self.assertEqual(name, 'string_value')
-        self.assertEqual(value, 'str')
-
-    def test_bytes(self):
-        name, value = self._callFUT(b'bytes')
-        self.assertEqual(name, 'blob_value')
-        self.assertEqual(value, b'bytes')
-
-    def test_unicode(self):
-        name, value = self._callFUT(u'str')
-        self.assertEqual(name, 'string_value')
-        self.assertEqual(value, u'str')
-
-    def test_entity(self):
-        from google.cloud.datastore.entity import Entity
-        entity = Entity()
-        name, value = self._callFUT(entity)
-        self.assertEqual(name, 'entity_value')
-        self.assertIs(value, entity)
-
-    def test_array(self):
-        values = ['a', 0, 3.14]
-        name, value = self._callFUT(values)
-        self.assertEqual(name, 'array_value')
-        self.assertIs(value, values)
-
-    def test_geo_point(self):
-        from google.type import latlng_pb2
-        from google.cloud.datastore.helpers import GeoPoint
-
-        lat = 42.42
-        lng = 99.0007
-        geo_pt = GeoPoint(latitude=lat, longitude=lng)
-        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
-        name, value = self._callFUT(geo_pt)
-        self.assertEqual(name, 'geo_point_value')
-        self.assertEqual(value, geo_pt_pb)
-
-    def test_null(self):
-        from google.protobuf import struct_pb2
-
-        name, value = self._callFUT(None)
-        self.assertEqual(name, 'null_value')
-        self.assertEqual(value, struct_pb2.NULL_VALUE)
-
-    def test_object(self):
-        self.assertRaises(ValueError, self._callFUT, object())
-
-
-class Test__get_value_from_value_pb(unittest.TestCase):
-
-    def _callFUT(self, pb):
-        from google.cloud.datastore.helpers import _get_value_from_value_pb
-
-        return _get_value_from_value_pb(pb)
-
-    def _makePB(self, attr_name, value):
-        from google.cloud.datastore._generated import entity_pb2
-
-        pb = entity_pb2.Value()
-        setattr(pb, attr_name, value)
-        return pb
-
-    def test_datetime(self):
-        import calendar
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud.datastore._generated import entity_pb2
-
-        micros = 4375
-        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
-        pb = entity_pb2.Value()
-        pb.timestamp_value.seconds = calendar.timegm(utc.timetuple())
-        pb.timestamp_value.nanos = 1000 * micros
-        self.assertEqual(self._callFUT(pb), utc)
-
-    def test_key(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.key import Key
-
-        pb = entity_pb2.Value()
-        expected = Key('KIND', 1234, project='PROJECT').to_protobuf()
-        pb.key_value.CopyFrom(expected)
-        found = self._callFUT(pb)
-        self.assertEqual(found.to_protobuf(), expected)
-
-    def test_bool(self):
-        pb = self._makePB('boolean_value', False)
-        self.assertEqual(self._callFUT(pb), False)
-
-    def test_float(self):
-        pb = self._makePB('double_value', 3.1415926)
-        self.assertEqual(self._callFUT(pb), 3.1415926)
-
-    def test_int(self):
-        pb = self._makePB('integer_value', 42)
-        self.assertEqual(self._callFUT(pb), 42)
-
-    def test_bytes(self):
-        pb = self._makePB('blob_value', b'str')
-        self.assertEqual(self._callFUT(pb), b'str')
-
-    def test_unicode(self):
-        pb = self._makePB('string_value', u'str')
-        self.assertEqual(self._callFUT(pb), u'str')
-
-    def test_entity(self):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        pb = entity_pb2.Value()
-        entity_pb = pb.entity_value
-        entity_pb.key.path.add(kind='KIND')
-        entity_pb.key.partition_id.project_id = 'PROJECT'
-
-        value_pb = _new_value_pb(entity_pb, 'foo')
-        value_pb.string_value = 'Foo'
-        entity = self._callFUT(pb)
-        self.assertIsInstance(entity, Entity)
-        self.assertEqual(entity['foo'], 'Foo')
-
-    def test_array(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        pb = entity_pb2.Value()
-        array_pb = pb.array_value.values
-        item_pb = array_pb.add()
-        item_pb.string_value = 'Foo'
-        item_pb = array_pb.add()
-        item_pb.string_value = 'Bar'
-        items = self._callFUT(pb)
-        self.assertEqual(items, ['Foo', 'Bar'])
-
-    def test_geo_point(self):
-        from google.type import latlng_pb2
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore.helpers import GeoPoint
-
-        lat = -3.14
-        lng = 13.37
-        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
-        pb = entity_pb2.Value(geo_point_value=geo_pt_pb)
-        result = self._callFUT(pb)
-        self.assertIsInstance(result, GeoPoint)
-        self.assertEqual(result.latitude, lat)
-        self.assertEqual(result.longitude, lng)
-
-    def test_null(self):
-        from google.protobuf import struct_pb2
-        from google.cloud.datastore._generated import entity_pb2
-
-        pb = entity_pb2.Value(null_value=struct_pb2.NULL_VALUE)
-        result = self._callFUT(pb)
-        self.assertIsNone(result)
-
-    def test_unknown(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        pb = entity_pb2.Value()
-        with self.assertRaises(ValueError):
-            self._callFUT(pb)
-
-
-class Test_set_protobuf_value(unittest.TestCase):
-
-    def _callFUT(self, value_pb, val):
-        from google.cloud.datastore.helpers import _set_protobuf_value
-
-        return _set_protobuf_value(value_pb, val)
-
-    def _makePB(self):
-        from google.cloud.datastore._generated import entity_pb2
-        return entity_pb2.Value()
-
-    def test_datetime(self):
-        import calendar
-        import datetime
-        from google.cloud._helpers import UTC
-
-        pb = self._makePB()
-        micros = 4375
-        utc = datetime.datetime(2014, 9, 16, 10, 19, 32, micros, UTC)
-        self._callFUT(pb, utc)
-        value = pb.timestamp_value
-        self.assertEqual(value.seconds, calendar.timegm(utc.timetuple()))
-        self.assertEqual(value.nanos, 1000 * micros)
-
-    def test_key(self):
-        from google.cloud.datastore.key import Key
-
-        pb = self._makePB()
-        key = Key('KIND', 1234, project='PROJECT')
-        self._callFUT(pb, key)
-        value = pb.key_value
-        self.assertEqual(value, key.to_protobuf())
-
-    def test_none(self):
-        pb = self._makePB()
-        self._callFUT(pb, None)
-        self.assertEqual(pb.WhichOneof('value_type'), 'null_value')
-
-    def test_bool(self):
-        pb = self._makePB()
-        self._callFUT(pb, False)
-        value = pb.boolean_value
-        self.assertEqual(value, False)
-
-    def test_float(self):
-        pb = self._makePB()
-        self._callFUT(pb, 3.1415926)
-        value = pb.double_value
-        self.assertEqual(value, 3.1415926)
-
-    def test_int(self):
-        pb = self._makePB()
-        self._callFUT(pb, 42)
-        value = pb.integer_value
-        self.assertEqual(value, 42)
-
-    def test_long(self):
-        pb = self._makePB()
-        must_be_long = (1 << 63) - 1
-        self._callFUT(pb, must_be_long)
-        value = pb.integer_value
-        self.assertEqual(value, must_be_long)
-
-    def test_native_str(self):
-        import six
-        pb = self._makePB()
-        self._callFUT(pb, 'str')
-        if six.PY2:
-            value = pb.blob_value
-        else:  # pragma: NO COVER Python 3
-            value = pb.string_value
-        self.assertEqual(value, 'str')
-
-    def test_bytes(self):
-        pb = self._makePB()
-        self._callFUT(pb, b'str')
-        value = pb.blob_value
-        self.assertEqual(value, b'str')
-
-    def test_unicode(self):
-        pb = self._makePB()
-        self._callFUT(pb, u'str')
-        value = pb.string_value
-        self.assertEqual(value, u'str')
-
-    def test_entity_empty_wo_key(self):
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.helpers import _property_tuples
-
-        pb = self._makePB()
-        entity = Entity()
-        self._callFUT(pb, entity)
-        value = pb.entity_value
-        self.assertEqual(value.key.SerializeToString(), b'')
-        self.assertEqual(len(list(_property_tuples(value))), 0)
-
-    def test_entity_w_key(self):
-        from google.cloud.datastore.entity import Entity
-        from google.cloud.datastore.helpers import _property_tuples
-        from google.cloud.datastore.key import Key
-
-        name = 'foo'
-        value = u'Foo'
-        pb = self._makePB()
-        key = Key('KIND', 123, project='PROJECT')
-        entity = Entity(key=key)
-        entity[name] = value
-        self._callFUT(pb, entity)
-        entity_pb = pb.entity_value
-        self.assertEqual(entity_pb.key, key.to_protobuf())
-
-        prop_dict = dict(_property_tuples(entity_pb))
-        self.assertEqual(len(prop_dict), 1)
-        self.assertEqual(list(prop_dict.keys()), [name])
-        self.assertEqual(prop_dict[name].string_value, value)
-
-    def test_array(self):
-        pb = self._makePB()
-        values = [u'a', 0, 3.14]
-        self._callFUT(pb, values)
-        marshalled = pb.array_value.values
-        self.assertEqual(len(marshalled), len(values))
-        self.assertEqual(marshalled[0].string_value, values[0])
-        self.assertEqual(marshalled[1].integer_value, values[1])
-        self.assertEqual(marshalled[2].double_value, values[2])
-
-    def test_geo_point(self):
-        from google.type import latlng_pb2
-        from google.cloud.datastore.helpers import GeoPoint
-
-        pb = self._makePB()
-        lat = 9.11
-        lng = 3.337
-        geo_pt = GeoPoint(latitude=lat, longitude=lng)
-        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
-        self._callFUT(pb, geo_pt)
-        self.assertEqual(pb.geo_point_value, geo_pt_pb)
-
-
-class Test__get_meaning(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.datastore.helpers import _get_meaning
-        return _get_meaning(*args, **kwargs)
-
-    def test_no_meaning(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        value_pb = entity_pb2.Value()
-        result = self._callFUT(value_pb)
-        self.assertIsNone(result)
-
-    def test_single(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        value_pb = entity_pb2.Value()
-        value_pb.meaning = meaning = 22
-        value_pb.string_value = u'hi'
-        result = self._callFUT(value_pb)
-        self.assertEqual(meaning, result)
-
-    def test_empty_array_value(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        value_pb = entity_pb2.Value()
-        value_pb.array_value.values.add()
-        value_pb.array_value.values.pop()
-
-        result = self._callFUT(value_pb, is_list=True)
-        self.assertEqual(None, result)
-
-    def test_array_value(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        value_pb = entity_pb2.Value()
-        meaning = 9
-        sub_value_pb1 = value_pb.array_value.values.add()
-        sub_value_pb2 = value_pb.array_value.values.add()
-
-        sub_value_pb1.meaning = sub_value_pb2.meaning = meaning
-        sub_value_pb1.string_value = u'hi'
-        sub_value_pb2.string_value = u'bye'
-
-        result = self._callFUT(value_pb, is_list=True)
-        self.assertEqual(meaning, result)
-
-    def test_array_value_multiple_meanings(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        value_pb = entity_pb2.Value()
-        meaning1 = 9
-        meaning2 = 10
-        sub_value_pb1 = value_pb.array_value.values.add()
-        sub_value_pb2 = value_pb.array_value.values.add()
-
-        sub_value_pb1.meaning = meaning1
-        sub_value_pb2.meaning = meaning2
-        sub_value_pb1.string_value = u'hi'
-        sub_value_pb2.string_value = u'bye'
-
-        result = self._callFUT(value_pb, is_list=True)
-        self.assertEqual(result, [meaning1, meaning2])
-
-    def test_array_value_meaning_partially_unset(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        value_pb = entity_pb2.Value()
-        meaning1 = 9
-        sub_value_pb1 = value_pb.array_value.values.add()
-        sub_value_pb2 = value_pb.array_value.values.add()
-
-        sub_value_pb1.meaning = meaning1
-        sub_value_pb1.string_value = u'hi'
-        sub_value_pb2.string_value = u'bye'
-
-        result = self._callFUT(value_pb, is_list=True)
-        self.assertEqual(result, [meaning1, None])
-
-
-class TestGeoPoint(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.helpers import GeoPoint
-        return GeoPoint
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        lat = 81.2
-        lng = 359.9999
-        geo_pt = self._makeOne(lat, lng)
-        self.assertEqual(geo_pt.latitude, lat)
-        self.assertEqual(geo_pt.longitude, lng)
-
-    def test_to_protobuf(self):
-        from google.type import latlng_pb2
-
-        lat = 0.0001
-        lng = 20.03
-        geo_pt = self._makeOne(lat, lng)
-        result = geo_pt.to_protobuf()
-        geo_pt_pb = latlng_pb2.LatLng(latitude=lat, longitude=lng)
-        self.assertEqual(result, geo_pt_pb)
-
-    def test___eq__(self):
-        lat = 0.0001
-        lng = 20.03
-        geo_pt1 = self._makeOne(lat, lng)
-        geo_pt2 = self._makeOne(lat, lng)
-        self.assertEqual(geo_pt1, geo_pt2)
-
-    def test___eq__type_differ(self):
-        lat = 0.0001
-        lng = 20.03
-        geo_pt1 = self._makeOne(lat, lng)
-        geo_pt2 = object()
-        self.assertNotEqual(geo_pt1, geo_pt2)
-
-    def test___ne__same_value(self):
-        lat = 0.0001
-        lng = 20.03
-        geo_pt1 = self._makeOne(lat, lng)
-        geo_pt2 = self._makeOne(lat, lng)
-        comparison_val = (geo_pt1 != geo_pt2)
-        self.assertFalse(comparison_val)
-
-    def test___ne__(self):
-        geo_pt1 = self._makeOne(0.0, 1.0)
-        geo_pt2 = self._makeOne(2.0, 3.0)
-        self.assertNotEqual(geo_pt1, geo_pt2)
diff --git a/unit_tests/datastore/test_key.py b/unit_tests/datastore/test_key.py
deleted file mode 100644
index d4d8bfc5e063..000000000000
--- a/unit_tests/datastore/test_key.py
+++ /dev/null
@@ -1,431 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestKey(unittest.TestCase):
-
-    _DEFAULT_PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.key import Key
-        return Key
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_ctor_empty(self):
-        self.assertRaises(ValueError, self._makeOne)
-
-    def test_ctor_no_project(self):
-        klass = self._getTargetClass()
-        self.assertRaises(ValueError, klass, 'KIND')
-
-    def test_ctor_w_explicit_project_empty_path(self):
-        _PROJECT = 'PROJECT'
-        self.assertRaises(ValueError, self._makeOne, project=_PROJECT)
-
-    def test_ctor_parent(self):
-        _PARENT_KIND = 'KIND1'
-        _PARENT_ID = 1234
-        _PARENT_PROJECT = 'PROJECT-ALT'
-        _PARENT_NAMESPACE = 'NAMESPACE'
-        _CHILD_KIND = 'KIND2'
-        _CHILD_ID = 2345
-        _PATH = [
-            {'kind': _PARENT_KIND, 'id': _PARENT_ID},
-            {'kind': _CHILD_KIND, 'id': _CHILD_ID},
-        ]
-        parent_key = self._makeOne(_PARENT_KIND, _PARENT_ID,
-                                   project=_PARENT_PROJECT,
-                                   namespace=_PARENT_NAMESPACE)
-        key = self._makeOne(_CHILD_KIND, _CHILD_ID, parent=parent_key)
-        self.assertEqual(key.project, parent_key.project)
-        self.assertEqual(key.namespace, parent_key.namespace)
-        self.assertEqual(key.kind, _CHILD_KIND)
-        self.assertEqual(key.path, _PATH)
-        self.assertIs(key.parent, parent_key)
-
-    def test_ctor_partial_parent(self):
-        parent_key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        with self.assertRaises(ValueError):
-            self._makeOne('KIND2', 1234, parent=parent_key)
-
-    def test_ctor_parent_bad_type(self):
-        with self.assertRaises(AttributeError):
-            self._makeOne('KIND2', 1234, parent=('KIND1', 1234),
-                          project=self._DEFAULT_PROJECT)
-
-    def test_ctor_parent_bad_namespace(self):
-        parent_key = self._makeOne('KIND', 1234, namespace='FOO',
-                                   project=self._DEFAULT_PROJECT)
-        with self.assertRaises(ValueError):
-            self._makeOne('KIND2', 1234, namespace='BAR', parent=parent_key,
-                          project=self._DEFAULT_PROJECT)
-
-    def test_ctor_parent_bad_project(self):
-        parent_key = self._makeOne('KIND', 1234, project='FOO')
-        with self.assertRaises(ValueError):
-            self._makeOne('KIND2', 1234, parent=parent_key,
-                          project='BAR')
-
-    def test_ctor_parent_empty_path(self):
-        parent_key = self._makeOne('KIND', 1234,
-                                   project=self._DEFAULT_PROJECT)
-        with self.assertRaises(ValueError):
-            self._makeOne(parent=parent_key)
-
-    def test_ctor_explicit(self):
-        _PROJECT = 'PROJECT-ALT'
-        _NAMESPACE = 'NAMESPACE'
-        _KIND = 'KIND'
-        _ID = 1234
-        _PATH = [{'kind': _KIND, 'id': _ID}]
-        key = self._makeOne(_KIND, _ID, namespace=_NAMESPACE,
-                            project=_PROJECT)
-        self.assertEqual(key.project, _PROJECT)
-        self.assertEqual(key.namespace, _NAMESPACE)
-        self.assertEqual(key.kind, _KIND)
-        self.assertEqual(key.path, _PATH)
-
-    def test_ctor_bad_kind(self):
-        self.assertRaises(ValueError, self._makeOne, object(),
-                          project=self._DEFAULT_PROJECT)
-
-    def test_ctor_bad_id_or_name(self):
-        self.assertRaises(ValueError, self._makeOne, 'KIND', object(),
-                          project=self._DEFAULT_PROJECT)
-        self.assertRaises(ValueError, self._makeOne, 'KIND', None,
-                          project=self._DEFAULT_PROJECT)
-        self.assertRaises(ValueError, self._makeOne, 'KIND', 10, 'KIND2', None,
-                          project=self._DEFAULT_PROJECT)
-
-    def test__clone(self):
-        _PROJECT = 'PROJECT-ALT'
-        _NAMESPACE = 'NAMESPACE'
-        _KIND = 'KIND'
-        _ID = 1234
-        _PATH = [{'kind': _KIND, 'id': _ID}]
-        key = self._makeOne(_KIND, _ID, namespace=_NAMESPACE,
-                            project=_PROJECT)
-        clone = key._clone()
-        self.assertEqual(clone.project, _PROJECT)
-        self.assertEqual(clone.namespace, _NAMESPACE)
-        self.assertEqual(clone.kind, _KIND)
-        self.assertEqual(clone.path, _PATH)
-
-    def test__clone_with_parent(self):
-        _PROJECT = 'PROJECT-ALT'
-        _NAMESPACE = 'NAMESPACE'
-        _KIND1 = 'PARENT'
-        _KIND2 = 'KIND'
-        _ID1 = 1234
-        _ID2 = 2345
-        _PATH = [{'kind': _KIND1, 'id': _ID1}, {'kind': _KIND2, 'id': _ID2}]
-
-        parent = self._makeOne(_KIND1, _ID1, namespace=_NAMESPACE,
-                               project=_PROJECT)
-        key = self._makeOne(_KIND2, _ID2, parent=parent)
-        self.assertIs(key.parent, parent)
-        clone = key._clone()
-        self.assertIs(clone.parent, key.parent)
-        self.assertEqual(clone.project, _PROJECT)
-        self.assertEqual(clone.namespace, _NAMESPACE)
-        self.assertEqual(clone.path, _PATH)
-
-    def test___eq_____ne___w_non_key(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _NAME = 'one'
-        key = self._makeOne(_KIND, _NAME, project=_PROJECT)
-        self.assertFalse(key == object())
-        self.assertTrue(key != object())
-
-    def test___eq_____ne___two_incomplete_keys_same_kind(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        key1 = self._makeOne(_KIND, project=_PROJECT)
-        key2 = self._makeOne(_KIND, project=_PROJECT)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___incomplete_key_w_complete_key_same_kind(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 1234
-        key1 = self._makeOne(_KIND, project=_PROJECT)
-        key2 = self._makeOne(_KIND, _ID, project=_PROJECT)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___complete_key_w_incomplete_key_same_kind(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 1234
-        key1 = self._makeOne(_KIND, _ID, project=_PROJECT)
-        key2 = self._makeOne(_KIND, project=_PROJECT)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___same_kind_different_ids(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID1 = 1234
-        _ID2 = 2345
-        key1 = self._makeOne(_KIND, _ID1, project=_PROJECT)
-        key2 = self._makeOne(_KIND, _ID2, project=_PROJECT)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___same_kind_and_id(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 1234
-        key1 = self._makeOne(_KIND, _ID, project=_PROJECT)
-        key2 = self._makeOne(_KIND, _ID, project=_PROJECT)
-        self.assertTrue(key1 == key2)
-        self.assertFalse(key1 != key2)
-
-    def test___eq_____ne___same_kind_and_id_different_project(self):
-        _PROJECT1 = 'PROJECT1'
-        _PROJECT2 = 'PROJECT2'
-        _KIND = 'KIND'
-        _ID = 1234
-        key1 = self._makeOne(_KIND, _ID, project=_PROJECT1)
-        key2 = self._makeOne(_KIND, _ID, project=_PROJECT2)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___same_kind_and_id_different_namespace(self):
-        _PROJECT = 'PROJECT'
-        _NAMESPACE1 = 'NAMESPACE1'
-        _NAMESPACE2 = 'NAMESPACE2'
-        _KIND = 'KIND'
-        _ID = 1234
-        key1 = self._makeOne(_KIND, _ID, project=_PROJECT,
-                             namespace=_NAMESPACE1)
-        key2 = self._makeOne(_KIND, _ID, project=_PROJECT,
-                             namespace=_NAMESPACE2)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___same_kind_different_names(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _NAME1 = 'one'
-        _NAME2 = 'two'
-        key1 = self._makeOne(_KIND, _NAME1, project=_PROJECT)
-        key2 = self._makeOne(_KIND, _NAME2, project=_PROJECT)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___same_kind_and_name(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _NAME = 'one'
-        key1 = self._makeOne(_KIND, _NAME, project=_PROJECT)
-        key2 = self._makeOne(_KIND, _NAME, project=_PROJECT)
-        self.assertTrue(key1 == key2)
-        self.assertFalse(key1 != key2)
-
-    def test___eq_____ne___same_kind_and_name_different_project(self):
-        _PROJECT1 = 'PROJECT1'
-        _PROJECT2 = 'PROJECT2'
-        _KIND = 'KIND'
-        _NAME = 'one'
-        key1 = self._makeOne(_KIND, _NAME, project=_PROJECT1)
-        key2 = self._makeOne(_KIND, _NAME, project=_PROJECT2)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___eq_____ne___same_kind_and_name_different_namespace(self):
-        _PROJECT = 'PROJECT'
-        _NAMESPACE1 = 'NAMESPACE1'
-        _NAMESPACE2 = 'NAMESPACE2'
-        _KIND = 'KIND'
-        _NAME = 'one'
-        key1 = self._makeOne(_KIND, _NAME, project=_PROJECT,
-                             namespace=_NAMESPACE1)
-        key2 = self._makeOne(_KIND, _NAME, project=_PROJECT,
-                             namespace=_NAMESPACE2)
-        self.assertFalse(key1 == key2)
-        self.assertTrue(key1 != key2)
-
-    def test___hash___incomplete(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        key = self._makeOne(_KIND, project=_PROJECT)
-        self.assertNotEqual(hash(key),
-                            hash(_KIND) + hash(_PROJECT) + hash(None))
-
-    def test___hash___completed_w_id(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 1234
-        key = self._makeOne(_KIND, _ID, project=_PROJECT)
-        self.assertNotEqual(hash(key),
-                            hash(_KIND) + hash(_ID) +
-                            hash(_PROJECT) + hash(None))
-
-    def test___hash___completed_w_name(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _NAME = 'NAME'
-        key = self._makeOne(_KIND, _NAME, project=_PROJECT)
-        self.assertNotEqual(hash(key),
-                            hash(_KIND) + hash(_NAME) +
-                            hash(_PROJECT) + hash(None))
-
-    def test_completed_key_on_partial_w_id(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        _ID = 1234
-        new_key = key.completed_key(_ID)
-        self.assertIsNot(key, new_key)
-        self.assertEqual(new_key.id, _ID)
-        self.assertIsNone(new_key.name)
-
-    def test_completed_key_on_partial_w_name(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        _NAME = 'NAME'
-        new_key = key.completed_key(_NAME)
-        self.assertIsNot(key, new_key)
-        self.assertIsNone(new_key.id)
-        self.assertEqual(new_key.name, _NAME)
-
-    def test_completed_key_on_partial_w_invalid(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        self.assertRaises(ValueError, key.completed_key, object())
-
-    def test_completed_key_on_complete(self):
-        key = self._makeOne('KIND', 1234, project=self._DEFAULT_PROJECT)
-        self.assertRaises(ValueError, key.completed_key, 5678)
-
-    def test_to_protobuf_defaults(self):
-        from google.cloud.datastore._generated import entity_pb2
-
-        _KIND = 'KIND'
-        key = self._makeOne(_KIND, project=self._DEFAULT_PROJECT)
-        pb = key.to_protobuf()
-        self.assertIsInstance(pb, entity_pb2.Key)
-
-        # Check partition ID.
-        self.assertEqual(pb.partition_id.project_id, self._DEFAULT_PROJECT)
-        # Unset values are False-y.
-        self.assertEqual(pb.partition_id.namespace_id, '')
-
-        # Check the element PB matches the partial key and kind.
-        elem, = list(pb.path)
-        self.assertEqual(elem.kind, _KIND)
-        # Unset values are False-y.
-        self.assertEqual(elem.name, '')
-        # Unset values are False-y.
-        self.assertEqual(elem.id, 0)
-
-    def test_to_protobuf_w_explicit_project(self):
-        _PROJECT = 'PROJECT-ALT'
-        key = self._makeOne('KIND', project=_PROJECT)
-        pb = key.to_protobuf()
-        self.assertEqual(pb.partition_id.project_id, _PROJECT)
-
-    def test_to_protobuf_w_explicit_namespace(self):
-        _NAMESPACE = 'NAMESPACE'
-        key = self._makeOne('KIND', namespace=_NAMESPACE,
-                            project=self._DEFAULT_PROJECT)
-        pb = key.to_protobuf()
-        self.assertEqual(pb.partition_id.namespace_id, _NAMESPACE)
-
-    def test_to_protobuf_w_explicit_path(self):
-        _PARENT = 'PARENT'
-        _CHILD = 'CHILD'
-        _ID = 1234
-        _NAME = 'NAME'
-        key = self._makeOne(_PARENT, _NAME, _CHILD, _ID,
-                            project=self._DEFAULT_PROJECT)
-        pb = key.to_protobuf()
-        elems = list(pb.path)
-        self.assertEqual(len(elems), 2)
-        self.assertEqual(elems[0].kind, _PARENT)
-        self.assertEqual(elems[0].name, _NAME)
-        self.assertEqual(elems[1].kind, _CHILD)
-        self.assertEqual(elems[1].id, _ID)
-
-    def test_to_protobuf_w_no_kind(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        # Force the 'kind' to be unset. Maybe `to_protobuf` should fail
-        # on this? The backend certainly will.
-        key._path[-1].pop('kind')
-        pb = key.to_protobuf()
-        # Unset values are False-y.
-        self.assertEqual(pb.path[0].kind, '')
-
-    def test_is_partial_no_name_or_id(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        self.assertTrue(key.is_partial)
-
-    def test_is_partial_w_id(self):
-        _ID = 1234
-        key = self._makeOne('KIND', _ID, project=self._DEFAULT_PROJECT)
-        self.assertFalse(key.is_partial)
-
-    def test_is_partial_w_name(self):
-        _NAME = 'NAME'
-        key = self._makeOne('KIND', _NAME, project=self._DEFAULT_PROJECT)
-        self.assertFalse(key.is_partial)
-
-    def test_id_or_name_no_name_or_id(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        self.assertIsNone(key.id_or_name)
-
-    def test_id_or_name_no_name_or_id_child(self):
-        key = self._makeOne('KIND1', 1234, 'KIND2',
-                            project=self._DEFAULT_PROJECT)
-        self.assertIsNone(key.id_or_name)
-
-    def test_id_or_name_w_id_only(self):
-        _ID = 1234
-        key = self._makeOne('KIND', _ID, project=self._DEFAULT_PROJECT)
-        self.assertEqual(key.id_or_name, _ID)
-
-    def test_id_or_name_w_name_only(self):
-        _NAME = 'NAME'
-        key = self._makeOne('KIND', _NAME, project=self._DEFAULT_PROJECT)
-        self.assertEqual(key.id_or_name, _NAME)
-
-    def test_parent_default(self):
-        key = self._makeOne('KIND', project=self._DEFAULT_PROJECT)
-        self.assertIsNone(key.parent)
-
-    def test_parent_explicit_top_level(self):
-        key = self._makeOne('KIND', 1234, project=self._DEFAULT_PROJECT)
-        self.assertIsNone(key.parent)
-
-    def test_parent_explicit_nested(self):
-        _PARENT_KIND = 'KIND1'
-        _PARENT_ID = 1234
-        _PARENT_PATH = [{'kind': _PARENT_KIND, 'id': _PARENT_ID}]
-        key = self._makeOne(_PARENT_KIND, _PARENT_ID, 'KIND2',
-                            project=self._DEFAULT_PROJECT)
-        self.assertEqual(key.parent.path, _PARENT_PATH)
-
-    def test_parent_multiple_calls(self):
-        _PARENT_KIND = 'KIND1'
-        _PARENT_ID = 1234
-        _PARENT_PATH = [{'kind': _PARENT_KIND, 'id': _PARENT_ID}]
-        key = self._makeOne(_PARENT_KIND, _PARENT_ID, 'KIND2',
-                            project=self._DEFAULT_PROJECT)
-        parent = key.parent
-        self.assertEqual(parent.path, _PARENT_PATH)
-        new_parent = key.parent
-        self.assertIs(parent, new_parent)
diff --git a/unit_tests/datastore/test_query.py b/unit_tests/datastore/test_query.py
deleted file mode 100644
index 0ae28e5a28c2..000000000000
--- a/unit_tests/datastore/test_query.py
+++ /dev/null
@@ -1,759 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestQuery(unittest.TestCase):
-
-    _PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.query import Query
-        return Query
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _makeClient(self, connection=None):
-        if connection is None:
-            connection = _Connection()
-        return _Client(self._PROJECT, connection)
-
-    def test_ctor_defaults(self):
-        client = self._makeClient()
-        query = self._makeOne(client)
-        self.assertIs(query._client, client)
-        self.assertEqual(query.project, client.project)
-        self.assertIsNone(query.kind)
-        self.assertEqual(query.namespace, client.namespace)
-        self.assertIsNone(query.ancestor)
-        self.assertEqual(query.filters, [])
-        self.assertEqual(query.projection, [])
-        self.assertEqual(query.order, [])
-        self.assertEqual(query.distinct_on, [])
-
-    def test_ctor_explicit(self):
-        from google.cloud.datastore.key import Key
-        _PROJECT = 'OTHER_PROJECT'
-        _KIND = 'KIND'
-        _NAMESPACE = 'OTHER_NAMESPACE'
-        client = self._makeClient()
-        ancestor = Key('ANCESTOR', 123, project=_PROJECT)
-        FILTERS = [('foo', '=', 'Qux'), ('bar', '<', 17)]
-        PROJECTION = ['foo', 'bar', 'baz']
-        ORDER = ['foo', 'bar']
-        DISTINCT_ON = ['foo']
-        query = self._makeOne(
-            client,
-            kind=_KIND,
-            project=_PROJECT,
-            namespace=_NAMESPACE,
-            ancestor=ancestor,
-            filters=FILTERS,
-            projection=PROJECTION,
-            order=ORDER,
-            distinct_on=DISTINCT_ON,
-            )
-        self.assertIs(query._client, client)
-        self.assertEqual(query.project, _PROJECT)
-        self.assertEqual(query.kind, _KIND)
-        self.assertEqual(query.namespace, _NAMESPACE)
-        self.assertEqual(query.ancestor.path, ancestor.path)
-        self.assertEqual(query.filters, FILTERS)
-        self.assertEqual(query.projection, PROJECTION)
-        self.assertEqual(query.order, ORDER)
-        self.assertEqual(query.distinct_on, DISTINCT_ON)
-
-    def test_ctor_bad_projection(self):
-        BAD_PROJECTION = object()
-        self.assertRaises(TypeError, self._makeOne, self._makeClient(),
-                          projection=BAD_PROJECTION)
-
-    def test_ctor_bad_order(self):
-        BAD_ORDER = object()
-        self.assertRaises(TypeError, self._makeOne, self._makeClient(),
-                          order=BAD_ORDER)
-
-    def test_ctor_bad_distinct_on(self):
-        BAD_DISTINCT_ON = object()
-        self.assertRaises(TypeError, self._makeOne, self._makeClient(),
-                          distinct_on=BAD_DISTINCT_ON)
-
-    def test_ctor_bad_filters(self):
-        FILTERS_CANT_UNPACK = [('one', 'two')]
-        self.assertRaises(ValueError, self._makeOne, self._makeClient(),
-                          filters=FILTERS_CANT_UNPACK)
-
-    def test_namespace_setter_w_non_string(self):
-        query = self._makeOne(self._makeClient())
-
-        def _assign(val):
-            query.namespace = val
-
-        self.assertRaises(ValueError, _assign, object())
-
-    def test_namespace_setter(self):
-        _NAMESPACE = 'OTHER_NAMESPACE'
-        query = self._makeOne(self._makeClient())
-        query.namespace = _NAMESPACE
-        self.assertEqual(query.namespace, _NAMESPACE)
-
-    def test_kind_setter_w_non_string(self):
-        query = self._makeOne(self._makeClient())
-
-        def _assign(val):
-            query.kind = val
-
-        self.assertRaises(TypeError, _assign, object())
-
-    def test_kind_setter_wo_existing(self):
-        _KIND = 'KIND'
-        query = self._makeOne(self._makeClient())
-        query.kind = _KIND
-        self.assertEqual(query.kind, _KIND)
-
-    def test_kind_setter_w_existing(self):
-        _KIND_BEFORE = 'KIND_BEFORE'
-        _KIND_AFTER = 'KIND_AFTER'
-        query = self._makeOne(self._makeClient(), kind=_KIND_BEFORE)
-        self.assertEqual(query.kind, _KIND_BEFORE)
-        query.kind = _KIND_AFTER
-        self.assertEqual(query.project, self._PROJECT)
-        self.assertEqual(query.kind, _KIND_AFTER)
-
-    def test_ancestor_setter_w_non_key(self):
-        query = self._makeOne(self._makeClient())
-
-        def _assign(val):
-            query.ancestor = val
-
-        self.assertRaises(TypeError, _assign, object())
-        self.assertRaises(TypeError, _assign, ['KIND', 'NAME'])
-
-    def test_ancestor_setter_w_key(self):
-        from google.cloud.datastore.key import Key
-        _NAME = u'NAME'
-        key = Key('KIND', 123, project=self._PROJECT)
-        query = self._makeOne(self._makeClient())
-        query.add_filter('name', '=', _NAME)
-        query.ancestor = key
-        self.assertEqual(query.ancestor.path, key.path)
-
-    def test_ancestor_deleter_w_key(self):
-        from google.cloud.datastore.key import Key
-        key = Key('KIND', 123, project=self._PROJECT)
-        query = self._makeOne(client=self._makeClient(), ancestor=key)
-        del query.ancestor
-        self.assertIsNone(query.ancestor)
-
-    def test_add_filter_setter_w_unknown_operator(self):
-        query = self._makeOne(self._makeClient())
-        self.assertRaises(ValueError, query.add_filter,
-                          'firstname', '~~', 'John')
-
-    def test_add_filter_w_known_operator(self):
-        query = self._makeOne(self._makeClient())
-        query.add_filter('firstname', '=', u'John')
-        self.assertEqual(query.filters, [('firstname', '=', u'John')])
-
-    def test_add_filter_w_all_operators(self):
-        query = self._makeOne(self._makeClient())
-        query.add_filter('leq_prop', '<=', u'val1')
-        query.add_filter('geq_prop', '>=', u'val2')
-        query.add_filter('lt_prop', '<', u'val3')
-        query.add_filter('gt_prop', '>', u'val4')
-        query.add_filter('eq_prop', '=', u'val5')
-        self.assertEqual(len(query.filters), 5)
-        self.assertEqual(query.filters[0], ('leq_prop', '<=', u'val1'))
-        self.assertEqual(query.filters[1], ('geq_prop', '>=', u'val2'))
-        self.assertEqual(query.filters[2], ('lt_prop', '<', u'val3'))
-        self.assertEqual(query.filters[3], ('gt_prop', '>', u'val4'))
-        self.assertEqual(query.filters[4], ('eq_prop', '=', u'val5'))
-
-    def test_add_filter_w_known_operator_and_entity(self):
-        from google.cloud.datastore.entity import Entity
-        query = self._makeOne(self._makeClient())
-        other = Entity()
-        other['firstname'] = u'John'
-        other['lastname'] = u'Smith'
-        query.add_filter('other', '=', other)
-        self.assertEqual(query.filters, [('other', '=', other)])
-
-    def test_add_filter_w_whitespace_property_name(self):
-        query = self._makeOne(self._makeClient())
-        PROPERTY_NAME = '  property with lots of space '
-        query.add_filter(PROPERTY_NAME, '=', u'John')
-        self.assertEqual(query.filters, [(PROPERTY_NAME, '=', u'John')])
-
-    def test_add_filter___key__valid_key(self):
-        from google.cloud.datastore.key import Key
-        query = self._makeOne(self._makeClient())
-        key = Key('Foo', project=self._PROJECT)
-        query.add_filter('__key__', '=', key)
-        self.assertEqual(query.filters, [('__key__', '=', key)])
-
-    def test_filter___key__not_equal_operator(self):
-        from google.cloud.datastore.key import Key
-        key = Key('Foo', project=self._PROJECT)
-        query = self._makeOne(self._makeClient())
-        query.add_filter('__key__', '<', key)
-        self.assertEqual(query.filters, [('__key__', '<', key)])
-
-    def test_filter___key__invalid_value(self):
-        query = self._makeOne(self._makeClient())
-        self.assertRaises(ValueError, query.add_filter, '__key__', '=', None)
-
-    def test_projection_setter_empty(self):
-        query = self._makeOne(self._makeClient())
-        query.projection = []
-        self.assertEqual(query.projection, [])
-
-    def test_projection_setter_string(self):
-        query = self._makeOne(self._makeClient())
-        query.projection = 'field1'
-        self.assertEqual(query.projection, ['field1'])
-
-    def test_projection_setter_non_empty(self):
-        query = self._makeOne(self._makeClient())
-        query.projection = ['field1', 'field2']
-        self.assertEqual(query.projection, ['field1', 'field2'])
-
-    def test_projection_setter_multiple_calls(self):
-        _PROJECTION1 = ['field1', 'field2']
-        _PROJECTION2 = ['field3']
-        query = self._makeOne(self._makeClient())
-        query.projection = _PROJECTION1
-        self.assertEqual(query.projection, _PROJECTION1)
-        query.projection = _PROJECTION2
-        self.assertEqual(query.projection, _PROJECTION2)
-
-    def test_keys_only(self):
-        query = self._makeOne(self._makeClient())
-        query.keys_only()
-        self.assertEqual(query.projection, ['__key__'])
-
-    def test_key_filter_defaults(self):
-        from google.cloud.datastore.key import Key
-
-        client = self._makeClient()
-        query = self._makeOne(client)
-        self.assertEqual(query.filters, [])
-        key = Key('Kind', 1234, project='project')
-        query.key_filter(key)
-        self.assertEqual(query.filters, [('__key__', '=', key)])
-
-    def test_key_filter_explicit(self):
-        from google.cloud.datastore.key import Key
-
-        client = self._makeClient()
-        query = self._makeOne(client)
-        self.assertEqual(query.filters, [])
-        key = Key('Kind', 1234, project='project')
-        query.key_filter(key, operator='>')
-        self.assertEqual(query.filters, [('__key__', '>', key)])
-
-    def test_order_setter_empty(self):
-        query = self._makeOne(self._makeClient(), order=['foo', '-bar'])
-        query.order = []
-        self.assertEqual(query.order, [])
-
-    def test_order_setter_string(self):
-        query = self._makeOne(self._makeClient())
-        query.order = 'field'
-        self.assertEqual(query.order, ['field'])
-
-    def test_order_setter_single_item_list_desc(self):
-        query = self._makeOne(self._makeClient())
-        query.order = ['-field']
-        self.assertEqual(query.order, ['-field'])
-
-    def test_order_setter_multiple(self):
-        query = self._makeOne(self._makeClient())
-        query.order = ['foo', '-bar']
-        self.assertEqual(query.order, ['foo', '-bar'])
-
-    def test_distinct_on_setter_empty(self):
-        query = self._makeOne(self._makeClient(), distinct_on=['foo', 'bar'])
-        query.distinct_on = []
-        self.assertEqual(query.distinct_on, [])
-
-    def test_distinct_on_setter_string(self):
-        query = self._makeOne(self._makeClient())
-        query.distinct_on = 'field1'
-        self.assertEqual(query.distinct_on, ['field1'])
-
-    def test_distinct_on_setter_non_empty(self):
-        query = self._makeOne(self._makeClient())
-        query.distinct_on = ['field1', 'field2']
-        self.assertEqual(query.distinct_on, ['field1', 'field2'])
-
-    def test_distinct_on_multiple_calls(self):
-        _DISTINCT_ON1 = ['field1', 'field2']
-        _DISTINCT_ON2 = ['field3']
-        query = self._makeOne(self._makeClient())
-        query.distinct_on = _DISTINCT_ON1
-        self.assertEqual(query.distinct_on, _DISTINCT_ON1)
-        query.distinct_on = _DISTINCT_ON2
-        self.assertEqual(query.distinct_on, _DISTINCT_ON2)
-
-    def test_fetch_defaults_w_client_attr(self):
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = self._makeOne(client)
-        iterator = query.fetch()
-        self.assertIs(iterator._query, query)
-        self.assertIs(iterator._client, client)
-        self.assertIsNone(iterator._limit)
-        self.assertEqual(iterator._offset, 0)
-
-    def test_fetch_w_explicit_client(self):
-        connection = _Connection()
-        client = self._makeClient(connection)
-        other_client = self._makeClient(connection)
-        query = self._makeOne(client)
-        iterator = query.fetch(limit=7, offset=8, client=other_client)
-        self.assertIs(iterator._query, query)
-        self.assertIs(iterator._client, other_client)
-        self.assertEqual(iterator._limit, 7)
-        self.assertEqual(iterator._offset, 8)
-
-
-class TestIterator(unittest.TestCase):
-    _PROJECT = 'PROJECT'
-    _NAMESPACE = 'NAMESPACE'
-    _KIND = 'KIND'
-    _ID = 123
-    _START = b'\x00'
-    _END = b'\xFF'
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.query import Iterator
-        return Iterator
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _addQueryResults(self, connection, cursor=_END, more=False,
-                         skipped_results=None, no_entity=False):
-        from google.cloud.datastore._generated import entity_pb2
-        from google.cloud.datastore._generated import query_pb2
-        from google.cloud.datastore.helpers import _new_value_pb
-
-        if more:
-            more_enum = query_pb2.QueryResultBatch.NOT_FINISHED
-        else:
-            more_enum = query_pb2.QueryResultBatch.MORE_RESULTS_AFTER_LIMIT
-        _ID = 123
-        if no_entity:
-            entities = []
-        else:
-            entity_pb = entity_pb2.Entity()
-            entity_pb.key.partition_id.project_id = self._PROJECT
-            path_element = entity_pb.key.path.add()
-            path_element.kind = self._KIND
-            path_element.id = _ID
-            value_pb = _new_value_pb(entity_pb, 'foo')
-            value_pb.string_value = u'Foo'
-            entities = [entity_pb]
-
-        connection._results.append(
-            (entities, cursor, more_enum, skipped_results))
-
-    def _makeClient(self, connection=None):
-        if connection is None:
-            connection = _Connection()
-        return _Client(self._PROJECT, connection)
-
-    def test_ctor_defaults(self):
-        connection = _Connection()
-        query = object()
-        iterator = self._makeOne(query, connection)
-        self.assertIs(iterator._query, query)
-        self.assertIsNone(iterator._limit)
-        self.assertIsNone(iterator._offset)
-        self.assertIsNone(iterator._skipped_results)
-
-    def test_ctor_explicit(self):
-        client = self._makeClient()
-        query = _Query(client)
-        iterator = self._makeOne(query, client, 13, 29)
-        self.assertIs(iterator._query, query)
-        self.assertEqual(iterator._limit, 13)
-        self.assertEqual(iterator._offset, 29)
-
-    def test_next_page_no_cursors_no_more(self):
-        from google.cloud.datastore.query import _pb_from_query
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        self._addQueryResults(connection, cursor=b'')
-        iterator = self._makeOne(query, client)
-        entities, more_results, cursor = iterator.next_page()
-        self.assertIsNone(iterator._skipped_results)
-
-        self.assertIsNone(cursor)
-        self.assertFalse(more_results)
-        self.assertFalse(iterator._more_results)
-        self.assertEqual(len(entities), 1)
-        self.assertEqual(entities[0].key.path,
-                         [{'kind': self._KIND, 'id': self._ID}])
-        self.assertEqual(entities[0]['foo'], u'Foo')
-        qpb = _pb_from_query(query)
-        qpb.offset = 0
-        EXPECTED = {
-            'project': self._PROJECT,
-            'query_pb': qpb,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        self.assertEqual(connection._called_with, [EXPECTED])
-
-    def test_next_page_no_cursors_no_more_w_offset_and_limit(self):
-        from google.cloud.datastore.query import _pb_from_query
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        skipped_results = object()
-        self._addQueryResults(connection, cursor=b'',
-                              skipped_results=skipped_results)
-        iterator = self._makeOne(query, client, 13, 29)
-        entities, more_results, cursor = iterator.next_page()
-
-        self.assertIsNone(cursor)
-        self.assertFalse(more_results)
-        self.assertFalse(iterator._more_results)
-        self.assertEqual(iterator._skipped_results, skipped_results)
-        self.assertEqual(len(entities), 1)
-        self.assertEqual(entities[0].key.path,
-                         [{'kind': self._KIND, 'id': self._ID}])
-        self.assertEqual(entities[0]['foo'], u'Foo')
-        qpb = _pb_from_query(query)
-        qpb.limit.value = 13
-        qpb.offset = 29
-        EXPECTED = {
-            'project': self._PROJECT,
-            'query_pb': qpb,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        self.assertEqual(connection._called_with, [EXPECTED])
-
-    def test_next_page_w_cursors_w_more(self):
-        from base64 import urlsafe_b64decode
-        from base64 import urlsafe_b64encode
-        from google.cloud.datastore.query import _pb_from_query
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        self._addQueryResults(connection, cursor=self._END, more=True)
-        iterator = self._makeOne(query, client)
-        iterator._start_cursor = self._START
-        iterator._end_cursor = self._END
-        entities, more_results, cursor = iterator.next_page()
-
-        self.assertEqual(cursor, urlsafe_b64encode(self._END))
-        self.assertTrue(more_results)
-        self.assertTrue(iterator._more_results)
-        self.assertIsNone(iterator._skipped_results)
-        self.assertIsNone(iterator._end_cursor)
-        self.assertEqual(urlsafe_b64decode(iterator._start_cursor), self._END)
-        self.assertEqual(len(entities), 1)
-        self.assertEqual(entities[0].key.path,
-                         [{'kind': self._KIND, 'id': self._ID}])
-        self.assertEqual(entities[0]['foo'], u'Foo')
-        qpb = _pb_from_query(query)
-        qpb.offset = 0
-        qpb.start_cursor = urlsafe_b64decode(self._START)
-        qpb.end_cursor = urlsafe_b64decode(self._END)
-        EXPECTED = {
-            'project': self._PROJECT,
-            'query_pb': qpb,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        self.assertEqual(connection._called_with, [EXPECTED])
-
-    def test_next_page_w_cursors_w_bogus_more(self):
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        self._addQueryResults(connection, cursor=self._END, more=True)
-        epb, cursor, _, _ = connection._results.pop()
-        connection._results.append((epb, cursor, 5, None))  # invalid enum
-        iterator = self._makeOne(query, client)
-        self.assertRaises(ValueError, iterator.next_page)
-
-    def test___iter___no_more(self):
-        from google.cloud.datastore.query import _pb_from_query
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        self._addQueryResults(connection)
-        iterator = self._makeOne(query, client)
-        entities = list(iterator)
-
-        self.assertFalse(iterator._more_results)
-        self.assertEqual(len(entities), 1)
-        self.assertEqual(entities[0].key.path,
-                         [{'kind': self._KIND, 'id': self._ID}])
-        self.assertEqual(entities[0]['foo'], u'Foo')
-        qpb = _pb_from_query(query)
-        qpb.offset = 0
-        EXPECTED = {
-            'project': self._PROJECT,
-            'query_pb': qpb,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        self.assertEqual(connection._called_with, [EXPECTED])
-
-    def test___iter___w_more(self):
-        from google.cloud.datastore.query import _pb_from_query
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        self._addQueryResults(connection, cursor=self._END, more=True)
-        self._addQueryResults(connection)
-        iterator = self._makeOne(query, client)
-        entities = list(iterator)
-
-        self.assertFalse(iterator._more_results)
-        self.assertEqual(len(entities), 2)
-        for entity in entities:
-            self.assertEqual(
-                entity.key.path,
-                [{'kind': self._KIND, 'id': self._ID}])
-            self.assertEqual(entities[1]['foo'], u'Foo')
-        qpb1 = _pb_from_query(query)
-        qpb2 = _pb_from_query(query)
-        qpb2.start_cursor = self._END
-        EXPECTED1 = {
-            'project': self._PROJECT,
-            'query_pb': qpb1,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        EXPECTED2 = {
-            'project': self._PROJECT,
-            'query_pb': qpb2,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        self.assertEqual(len(connection._called_with), 2)
-        self.assertEqual(connection._called_with[0], EXPECTED1)
-        self.assertEqual(connection._called_with[1], EXPECTED2)
-
-    def test___iter___w_limit(self):
-        from google.cloud.datastore.query import _pb_from_query
-
-        connection = _Connection()
-        client = self._makeClient(connection)
-        query = _Query(client, self._KIND, self._PROJECT, self._NAMESPACE)
-        skip1 = 4
-        skip2 = 9
-        self._addQueryResults(connection, more=True, skipped_results=skip1,
-                              no_entity=True)
-        self._addQueryResults(connection, more=True, skipped_results=skip2)
-        self._addQueryResults(connection)
-        offset = skip1 + skip2
-        iterator = self._makeOne(query, client, limit=2, offset=offset)
-        entities = list(iterator)
-
-        self.assertFalse(iterator._more_results)
-        self.assertEqual(len(entities), 2)
-        for entity in entities:
-            self.assertEqual(
-                entity.key.path,
-                [{'kind': self._KIND, 'id': self._ID}])
-        qpb1 = _pb_from_query(query)
-        qpb1.limit.value = 2
-        qpb1.offset = offset
-        qpb2 = _pb_from_query(query)
-        qpb2.start_cursor = self._END
-        qpb2.limit.value = 2
-        qpb2.offset = offset - skip1
-        qpb3 = _pb_from_query(query)
-        qpb3.start_cursor = self._END
-        qpb3.limit.value = 1
-        EXPECTED1 = {
-            'project': self._PROJECT,
-            'query_pb': qpb1,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        EXPECTED2 = {
-            'project': self._PROJECT,
-            'query_pb': qpb2,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        EXPECTED3 = {
-            'project': self._PROJECT,
-            'query_pb': qpb3,
-            'namespace': self._NAMESPACE,
-            'transaction_id': None,
-        }
-        self.assertEqual(len(connection._called_with), 3)
-        self.assertEqual(connection._called_with[0], EXPECTED1)
-        self.assertEqual(connection._called_with[1], EXPECTED2)
-        self.assertEqual(connection._called_with[2], EXPECTED3)
-
-
-class Test__pb_from_query(unittest.TestCase):
-
-    def _callFUT(self, query):
-        from google.cloud.datastore.query import _pb_from_query
-        return _pb_from_query(query)
-
-    def test_empty(self):
-        from google.cloud.datastore._generated import query_pb2
-
-        pb = self._callFUT(_Query())
-        self.assertEqual(list(pb.projection), [])
-        self.assertEqual(list(pb.kind), [])
-        self.assertEqual(list(pb.order), [])
-        self.assertEqual(list(pb.distinct_on), [])
-        self.assertEqual(pb.filter.property_filter.property.name, '')
-        cfilter = pb.filter.composite_filter
-        self.assertEqual(cfilter.op,
-                         query_pb2.CompositeFilter.OPERATOR_UNSPECIFIED)
-        self.assertEqual(list(cfilter.filters), [])
-        self.assertEqual(pb.start_cursor, b'')
-        self.assertEqual(pb.end_cursor, b'')
-        self.assertEqual(pb.limit.value, 0)
-        self.assertEqual(pb.offset, 0)
-
-    def test_projection(self):
-        pb = self._callFUT(_Query(projection=['a', 'b', 'c']))
-        self.assertEqual([item.property.name for item in pb.projection],
-                         ['a', 'b', 'c'])
-
-    def test_kind(self):
-        pb = self._callFUT(_Query(kind='KIND'))
-        self.assertEqual([item.name for item in pb.kind], ['KIND'])
-
-    def test_ancestor(self):
-        from google.cloud.datastore.key import Key
-        from google.cloud.datastore._generated import query_pb2
-
-        ancestor = Key('Ancestor', 123, project='PROJECT')
-        pb = self._callFUT(_Query(ancestor=ancestor))
-        cfilter = pb.filter.composite_filter
-        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.AND)
-        self.assertEqual(len(cfilter.filters), 1)
-        pfilter = cfilter.filters[0].property_filter
-        self.assertEqual(pfilter.property.name, '__key__')
-        ancestor_pb = ancestor.to_protobuf()
-        self.assertEqual(pfilter.value.key_value, ancestor_pb)
-
-    def test_filter(self):
-        from google.cloud.datastore._generated import query_pb2
-
-        query = _Query(filters=[('name', '=', u'John')])
-        query.OPERATORS = {
-            '=': query_pb2.PropertyFilter.EQUAL,
-        }
-        pb = self._callFUT(query)
-        cfilter = pb.filter.composite_filter
-        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.AND)
-        self.assertEqual(len(cfilter.filters), 1)
-        pfilter = cfilter.filters[0].property_filter
-        self.assertEqual(pfilter.property.name, 'name')
-        self.assertEqual(pfilter.value.string_value, u'John')
-
-    def test_filter_key(self):
-        from google.cloud.datastore.key import Key
-        from google.cloud.datastore._generated import query_pb2
-
-        key = Key('Kind', 123, project='PROJECT')
-        query = _Query(filters=[('__key__', '=', key)])
-        query.OPERATORS = {
-            '=': query_pb2.PropertyFilter.EQUAL,
-        }
-        pb = self._callFUT(query)
-        cfilter = pb.filter.composite_filter
-        self.assertEqual(cfilter.op, query_pb2.CompositeFilter.AND)
-        self.assertEqual(len(cfilter.filters), 1)
-        pfilter = cfilter.filters[0].property_filter
-        self.assertEqual(pfilter.property.name, '__key__')
-        key_pb = key.to_protobuf()
-        self.assertEqual(pfilter.value.key_value, key_pb)
-
-    def test_order(self):
-        from google.cloud.datastore._generated import query_pb2
-
-        pb = self._callFUT(_Query(order=['a', '-b', 'c']))
-        self.assertEqual([item.property.name for item in pb.order],
-                         ['a', 'b', 'c'])
-        self.assertEqual([item.direction for item in pb.order],
-                         [query_pb2.PropertyOrder.ASCENDING,
-                          query_pb2.PropertyOrder.DESCENDING,
-                          query_pb2.PropertyOrder.ASCENDING])
-
-    def test_distinct_on(self):
-        pb = self._callFUT(_Query(distinct_on=['a', 'b', 'c']))
-        self.assertEqual([item.name for item in pb.distinct_on],
-                         ['a', 'b', 'c'])
-
-
-class _Query(object):
-
-    def __init__(self,
-                 client=object(),
-                 kind=None,
-                 project=None,
-                 namespace=None,
-                 ancestor=None,
-                 filters=(),
-                 projection=(),
-                 order=(),
-                 distinct_on=()):
-        self._client = client
-        self.kind = kind
-        self.project = project
-        self.namespace = namespace
-        self.ancestor = ancestor
-        self.filters = filters
-        self.projection = projection
-        self.order = order
-        self.distinct_on = distinct_on
-
-
-class _Connection(object):
-
-    _called_with = None
-    _cursor = b'\x00'
-    _skipped = 0
-
-    def __init__(self):
-        self._results = []
-        self._called_with = []
-
-    def run_query(self, **kw):
-        self._called_with.append(kw)
-        result, self._results = self._results[0], self._results[1:]
-        return result
-
-
-class _Client(object):
-
-    def __init__(self, project, connection, namespace=None):
-        self.project = project
-        self.connection = connection
-        self.namespace = namespace
-
-    @property
-    def current_transaction(self):
-        pass
diff --git a/unit_tests/datastore/test_transaction.py b/unit_tests/datastore/test_transaction.py
deleted file mode 100644
index 5f2a841490f0..000000000000
--- a/unit_tests/datastore/test_transaction.py
+++ /dev/null
@@ -1,256 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestTransaction(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.datastore.transaction import Transaction
-        return Transaction
-
-    def _makeOne(self, client, **kw):
-        return self._getTargetClass()(client, **kw)
-
-    def test_ctor_defaults(self):
-        from google.cloud.datastore._generated import datastore_pb2
-
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        self.assertEqual(xact.project, _PROJECT)
-        self.assertEqual(xact.connection, connection)
-        self.assertIsNone(xact.id)
-        self.assertEqual(xact._status, self._getTargetClass()._INITIAL)
-        self.assertIsInstance(xact._commit_request,
-                              datastore_pb2.CommitRequest)
-        self.assertIs(xact.mutations, xact._commit_request.mutations)
-        self.assertEqual(len(xact._partial_key_entities), 0)
-
-    def test_current(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection()
-        client = _Client(_PROJECT, connection)
-        xact1 = self._makeOne(client)
-        xact2 = self._makeOne(client)
-        self.assertIsNone(xact1.current())
-        self.assertIsNone(xact2.current())
-        with xact1:
-            self.assertIs(xact1.current(), xact1)
-            self.assertIs(xact2.current(), xact1)
-            with _NoCommitBatch(client):
-                self.assertIsNone(xact1.current())
-                self.assertIsNone(xact2.current())
-            with xact2:
-                self.assertIs(xact1.current(), xact2)
-                self.assertIs(xact2.current(), xact2)
-                with _NoCommitBatch(client):
-                    self.assertIsNone(xact1.current())
-                    self.assertIsNone(xact2.current())
-            self.assertIs(xact1.current(), xact1)
-            self.assertIs(xact2.current(), xact1)
-        self.assertIsNone(xact1.current())
-        self.assertIsNone(xact2.current())
-
-    def test_begin(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact.begin()
-        self.assertEqual(xact.id, 234)
-        self.assertEqual(connection._begun, _PROJECT)
-
-    def test_begin_tombstoned(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact.begin()
-        self.assertEqual(xact.id, 234)
-        self.assertEqual(connection._begun, _PROJECT)
-
-        xact.rollback()
-        self.assertIsNone(xact.id)
-
-        self.assertRaises(ValueError, xact.begin)
-
-    def test_begin_w_begin_transaction_failure(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-
-        connection._side_effect = RuntimeError
-        with self.assertRaises(RuntimeError):
-            xact.begin()
-
-        self.assertIsNone(xact.id)
-        self.assertEqual(connection._begun, _PROJECT)
-
-    def test_rollback(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact.begin()
-        xact.rollback()
-        self.assertIsNone(xact.id)
-        self.assertEqual(connection._rolled_back, (_PROJECT, 234))
-
-    def test_commit_no_partial_keys(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact._commit_request = commit_request = object()
-        xact.begin()
-        xact.commit()
-        self.assertEqual(connection._committed,
-                         (_PROJECT, commit_request, 234))
-        self.assertIsNone(xact.id)
-
-    def test_commit_w_partial_keys(self):
-        _PROJECT = 'PROJECT'
-        _KIND = 'KIND'
-        _ID = 123
-        connection = _Connection(234)
-        connection._completed_keys = [_make_key(_KIND, _ID, _PROJECT)]
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact.begin()
-        entity = _Entity()
-        xact.put(entity)
-        xact._commit_request = commit_request = object()
-        xact.commit()
-        self.assertEqual(connection._committed,
-                         (_PROJECT, commit_request, 234))
-        self.assertIsNone(xact.id)
-        self.assertEqual(entity.key.path, [{'kind': _KIND, 'id': _ID}])
-
-    def test_context_manager_no_raise(self):
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact._commit_request = commit_request = object()
-        with xact:
-            self.assertEqual(xact.id, 234)
-            self.assertEqual(connection._begun, _PROJECT)
-        self.assertEqual(connection._committed,
-                         (_PROJECT, commit_request, 234))
-        self.assertIsNone(xact.id)
-
-    def test_context_manager_w_raise(self):
-
-        class Foo(Exception):
-            pass
-
-        _PROJECT = 'PROJECT'
-        connection = _Connection(234)
-        client = _Client(_PROJECT, connection)
-        xact = self._makeOne(client)
-        xact._mutation = object()
-        try:
-            with xact:
-                self.assertEqual(xact.id, 234)
-                self.assertEqual(connection._begun, _PROJECT)
-                raise Foo()
-        except Foo:
-            self.assertIsNone(xact.id)
-            self.assertEqual(connection._rolled_back, (_PROJECT, 234))
-        self.assertIsNone(connection._committed)
-        self.assertIsNone(xact.id)
-
-
-def _make_key(kind, id_, project):
-    from google.cloud.datastore._generated import entity_pb2
-
-    key = entity_pb2.Key()
-    key.partition_id.project_id = project
-    elem = key.path.add()
-    elem.kind = kind
-    elem.id = id_
-    return key
-
-
-class _Connection(object):
-    _marker = object()
-    _begun = None
-    _rolled_back = None
-    _committed = None
-    _side_effect = None
-
-    def __init__(self, xact_id=123):
-        self._xact_id = xact_id
-        self._completed_keys = []
-        self._index_updates = 0
-
-    def begin_transaction(self, project):
-        self._begun = project
-        if self._side_effect is None:
-            return self._xact_id
-        else:
-            raise self._side_effect
-
-    def rollback(self, project, transaction_id):
-        self._rolled_back = project, transaction_id
-
-    def commit(self, project, commit_request, transaction_id):
-        self._committed = (project, commit_request, transaction_id)
-        return self._index_updates, self._completed_keys
-
-
-class _Entity(dict):
-
-    def __init__(self):
-        super(_Entity, self).__init__()
-        from google.cloud.datastore.key import Key
-        self.key = Key('KIND', project='PROJECT')
-
-
-class _Client(object):
-
-    def __init__(self, project, connection, namespace=None):
-        self.project = project
-        self.connection = connection
-        self.namespace = namespace
-        self._batches = []
-
-    def _push_batch(self, batch):
-        self._batches.insert(0, batch)
-
-    def _pop_batch(self):
-        return self._batches.pop(0)
-
-    @property
-    def current_batch(self):
-        return self._batches and self._batches[0] or None
-
-
-class _NoCommitBatch(object):
-
-    def __init__(self, client):
-        from google.cloud.datastore.batch import Batch
-        self._client = client
-        self._batch = Batch(client)
-
-    def __enter__(self):
-        self._client._push_batch(self._batch)
-        return self._batch
-
-    def __exit__(self, *args):
-        self._client._pop_batch()
diff --git a/unit_tests/dns/__init__.py b/unit_tests/dns/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/dns/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/dns/test_changes.py b/unit_tests/dns/test_changes.py
deleted file mode 100644
index aec2f013c5b3..000000000000
--- a/unit_tests/dns/test_changes.py
+++ /dev/null
@@ -1,343 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestChanges(unittest.TestCase):
-    PROJECT = 'project'
-    ZONE_NAME = 'example.com'
-    CHANGES_NAME = 'changeset_id'
-
-    def _getTargetClass(self):
-        from google.cloud.dns.changes import Changes
-        return Changes
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _setUpConstants(self):
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _NOW
-        self.WHEN = _NOW().replace(tzinfo=UTC)
-
-    def _makeResource(self):
-        from google.cloud._helpers import _datetime_to_rfc3339
-        when_str = _datetime_to_rfc3339(self.WHEN)
-        return {
-            'kind': 'dns#change',
-            'id': self.CHANGES_NAME,
-            'startTime': when_str,
-            'status': 'done',
-            'additions': [
-                {'name': 'test.example.com',
-                 'type': 'CNAME',
-                 'ttl': '3600',
-                 'rrdatas': ['www.example.com']},
-            ],
-            'deletions': [
-                {'name': 'test.example.com',
-                 'type': 'CNAME',
-                 'ttl': '86400',
-                 'rrdatas': ['other.example.com']},
-            ],
-        }
-
-    def _verifyResourceProperties(self, changes, resource, zone):
-        from google.cloud._helpers import _rfc3339_to_datetime
-        self.assertEqual(changes.name, resource['id'])
-        started = _rfc3339_to_datetime(resource['startTime'])
-        self.assertEqual(changes.started, started)
-        self.assertEqual(changes.status, resource['status'])
-
-        r_additions = resource.get('additions', ())
-        self.assertEqual(len(changes.additions), len(r_additions))
-        for found, expected in zip(changes.additions, r_additions):
-            self.assertEqual(found.name, expected['name'])
-            self.assertEqual(found.record_type, expected['type'])
-            self.assertEqual(found.ttl, int(expected['ttl']))
-            self.assertEqual(found.rrdatas, expected['rrdatas'])
-            self.assertIs(found.zone, zone)
-
-        r_deletions = resource.get('deletions', ())
-        self.assertEqual(len(changes.deletions), len(r_deletions))
-        for found, expected in zip(changes.deletions, r_deletions):
-            self.assertEqual(found.name, expected['name'])
-            self.assertEqual(found.record_type, expected['type'])
-            self.assertEqual(found.ttl, int(expected['ttl']))
-            self.assertEqual(found.rrdatas, expected['rrdatas'])
-            self.assertIs(found.zone, zone)
-
-    def test_ctor(self):
-        zone = _Zone()
-
-        changes = self._makeOne(zone)
-
-        self.assertIs(changes.zone, zone)
-        self.assertIsNone(changes.name)
-        self.assertIsNone(changes.status)
-        self.assertIsNone(changes.started)
-        self.assertEqual(list(changes.additions), [])
-        self.assertEqual(list(changes.deletions), [])
-
-    def test_from_api_repr_missing_additions_deletions(self):
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        del RESOURCE['additions']
-        del RESOURCE['deletions']
-        zone = _Zone()
-        klass = self._getTargetClass()
-
-        changes = klass.from_api_repr(RESOURCE, zone=zone)
-
-        self._verifyResourceProperties(changes, RESOURCE, zone)
-
-    def test_from_api_repr(self):
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        zone = _Zone()
-        klass = self._getTargetClass()
-
-        changes = klass.from_api_repr(RESOURCE, zone=zone)
-
-        self._verifyResourceProperties(changes, RESOURCE, zone)
-
-    def test_name_setter_bad_value(self):
-        zone = _Zone()
-        changes = self._makeOne(zone)
-        with self.assertRaises(ValueError):
-            changes.name = 12345
-
-    def test_name_setter(self):
-        zone = _Zone()
-        changes = self._makeOne(zone)
-        changes.name = 'NAME'
-        self.assertEqual(changes.name, 'NAME')
-
-    def test_add_record_set_invalid_value(self):
-        zone = _Zone()
-        changes = self._makeOne(zone)
-
-        with self.assertRaises(ValueError):
-            changes.add_record_set(object())
-
-    def test_add_record_set(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        zone = _Zone()
-        changes = self._makeOne(zone)
-        rrs = ResourceRecordSet('test.example.com', 'CNAME', 3600,
-                                ['www.example.com'], zone)
-        changes.add_record_set(rrs)
-        self.assertEqual(list(changes.additions), [rrs])
-
-    def test_delete_record_set_invalid_value(self):
-        zone = _Zone()
-        changes = self._makeOne(zone)
-
-        with self.assertRaises(ValueError):
-            changes.delete_record_set(object())
-
-    def test_delete_record_set(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        zone = _Zone()
-        changes = self._makeOne(zone)
-        rrs = ResourceRecordSet('test.example.com', 'CNAME', 3600,
-                                ['www.example.com'], zone)
-        changes.delete_record_set(rrs)
-        self.assertEqual(list(changes.deletions), [rrs])
-
-    def test_create_wo_additions_or_deletions(self):
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = _Zone(client)
-        changes = self._makeOne(zone)
-
-        with self.assertRaises(ValueError):
-            changes.create()
-
-        self.assertEqual(len(conn._requested), 0)
-
-    def test_create_w_bound_client(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        PATH = 'projects/%s/managedZones/%s/changes' % (
-            self.PROJECT, self.ZONE_NAME)
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = _Zone(client)
-        changes = self._makeOne(zone)
-        changes.add_record_set(ResourceRecordSet(
-            'test.example.com', 'CNAME', 3600, ['www.example.com'], zone))
-        changes.delete_record_set(ResourceRecordSet(
-            'test.example.com', 'CNAME', 86400, ['other.example.com'], zone))
-
-        changes.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'additions': RESOURCE['additions'],
-            'deletions': RESOURCE['deletions'],
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(changes, RESOURCE, zone)
-
-    def test_create_w_alternate_client(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        PATH = 'projects/%s/managedZones/%s/changes' % (
-            self.PROJECT, self.ZONE_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = _Zone(client1)
-        changes = self._makeOne(zone)
-        changes.add_record_set(ResourceRecordSet(
-            'test.example.com', 'CNAME', 3600, ['www.example.com'], zone))
-        changes.delete_record_set(ResourceRecordSet(
-            'test.example.com', 'CNAME', 86400, ['other.example.com'], zone))
-
-        changes.create(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'additions': RESOURCE['additions'],
-            'deletions': RESOURCE['deletions'],
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(changes, RESOURCE, zone)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/managedZones/%s/changes/%s' % (
-            self.PROJECT, self.ZONE_NAME, self.CHANGES_NAME)
-        self._setUpConstants()
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = _Zone(client)
-        changes = self._makeOne(zone)
-        changes.name = self.CHANGES_NAME
-
-        self.assertFalse(changes.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/managedZones/%s/changes/%s' % (
-            self.PROJECT, self.ZONE_NAME, self.CHANGES_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = _Zone(client1)
-        changes = self._makeOne(zone)
-        changes.name = self.CHANGES_NAME
-
-        self.assertTrue(changes.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/managedZones/%s/changes/%s' % (
-            self.PROJECT, self.ZONE_NAME, self.CHANGES_NAME)
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = _Zone(client)
-        changes = self._makeOne(zone)
-        changes.name = self.CHANGES_NAME
-
-        changes.reload()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(changes, RESOURCE, zone)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/managedZones/%s/changes/%s' % (
-            self.PROJECT, self.ZONE_NAME, self.CHANGES_NAME)
-        self._setUpConstants()
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = _Zone(client1)
-        changes = self._makeOne(zone)
-        changes.name = self.CHANGES_NAME
-
-        changes.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(changes, RESOURCE, zone)
-
-
-class _Zone(object):
-
-    def __init__(self, client=None, project=TestChanges.PROJECT,
-                 name=TestChanges.ZONE_NAME):
-        self._client = client
-        self.project = project
-        self.name = name
-
-
-class _Client(object):
-
-    def __init__(self, project='project', connection=None):
-        self.project = project
-        self.connection = connection
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
diff --git a/unit_tests/dns/test_client.py b/unit_tests/dns/test_client.py
deleted file mode 100644
index d737d3540960..000000000000
--- a/unit_tests/dns/test_client.py
+++ /dev/null
@@ -1,252 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-    ZONE_NAME = 'zone-name'
-
-    def _getTargetClass(self):
-        from google.cloud.dns.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        from google.cloud.dns.connection import Connection
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(project=self.PROJECT, credentials=creds,
-                               http=http)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertIs(client.connection.credentials, creds)
-        self.assertIs(client.connection.http, http)
-
-    def test_quotas_defaults(self):
-        PATH = 'projects/%s' % (self.PROJECT,)
-        MANAGED_ZONES = 1234
-        RRS_PER_RRSET = 23
-        RRSETS_PER_ZONE = 345
-        RRSET_ADDITIONS = 456
-        RRSET_DELETIONS = 567
-        TOTAL_SIZE = 67890
-        DATA = {
-            'quota': {
-                'managedZones': str(MANAGED_ZONES),
-                'resourceRecordsPerRrset': str(RRS_PER_RRSET),
-                'rrsetsPerManagedZone': str(RRSETS_PER_ZONE),
-                'rrsetAdditionsPerChange': str(RRSET_ADDITIONS),
-                'rrsetDeletionsPerChange': str(RRSET_DELETIONS),
-                'totalRrdataSizePerChange': str(TOTAL_SIZE),
-            }
-        }
-        CONVERTED = {key: int(value)
-                     for key, value in DATA['quota'].items()}
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        quotas = client.quotas()
-
-        self.assertEqual(quotas, CONVERTED)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_quotas_w_kind_key(self):
-        PATH = 'projects/%s' % (self.PROJECT,)
-        MANAGED_ZONES = 1234
-        RRS_PER_RRSET = 23
-        RRSETS_PER_ZONE = 345
-        RRSET_ADDITIONS = 456
-        RRSET_DELETIONS = 567
-        TOTAL_SIZE = 67890
-        DATA = {
-            'quota': {
-                'managedZones': str(MANAGED_ZONES),
-                'resourceRecordsPerRrset': str(RRS_PER_RRSET),
-                'rrsetsPerManagedZone': str(RRSETS_PER_ZONE),
-                'rrsetAdditionsPerChange': str(RRSET_ADDITIONS),
-                'rrsetDeletionsPerChange': str(RRSET_DELETIONS),
-                'totalRrdataSizePerChange': str(TOTAL_SIZE),
-            }
-        }
-        CONVERTED = {key: int(value)
-                     for key, value in DATA['quota'].items()}
-        WITH_KIND = {'quota': DATA['quota'].copy()}
-        WITH_KIND['quota']['kind'] = 'dns#quota'
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        conn = client.connection = _Connection(WITH_KIND)
-
-        quotas = client.quotas()
-
-        self.assertEqual(quotas, CONVERTED)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_zones_defaults(self):
-        from google.cloud.dns.zone import ManagedZone
-        ID_1 = '123'
-        ZONE_1 = 'zone_one'
-        DNS_1 = 'one.example.com'
-        ID_2 = '234'
-        ZONE_2 = 'zone_two'
-        DNS_2 = 'two.example.com'
-        PATH = 'projects/%s/managedZones' % (self.PROJECT,)
-        TOKEN = 'TOKEN'
-        DATA = {
-            'nextPageToken': TOKEN,
-            'managedZones': [
-                {'kind': 'dns#managedZone',
-                 'id': ID_1,
-                 'name': ZONE_1,
-                 'dnsName': DNS_1},
-                {'kind': 'dns#managedZone',
-                 'id': ID_2,
-                 'name': ZONE_2,
-                 'dnsName': DNS_2},
-            ]
-        }
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        zones, token = client.list_zones()
-
-        self.assertEqual(len(zones), len(DATA['managedZones']))
-        for found, expected in zip(zones, DATA['managedZones']):
-            self.assertIsInstance(found, ManagedZone)
-            self.assertEqual(found.zone_id, expected['id'])
-            self.assertEqual(found.name, expected['name'])
-            self.assertEqual(found.dns_name, expected['dnsName'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_zones_explicit(self):
-        from google.cloud.dns.zone import ManagedZone
-        ID_1 = '123'
-        ZONE_1 = 'zone_one'
-        DNS_1 = 'one.example.com'
-        ID_2 = '234'
-        ZONE_2 = 'zone_two'
-        DNS_2 = 'two.example.com'
-        PATH = 'projects/%s/managedZones' % (self.PROJECT,)
-        TOKEN = 'TOKEN'
-        DATA = {
-            'managedZones': [
-                {'kind': 'dns#managedZone',
-                 'id': ID_1,
-                 'name': ZONE_1,
-                 'dnsName': DNS_1},
-                {'kind': 'dns#managedZone',
-                 'id': ID_2,
-                 'name': ZONE_2,
-                 'dnsName': DNS_2},
-            ]
-        }
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        conn = client.connection = _Connection(DATA)
-
-        zones, token = client.list_zones(max_results=3, page_token=TOKEN)
-
-        self.assertEqual(len(zones), len(DATA['managedZones']))
-        for found, expected in zip(zones, DATA['managedZones']):
-            self.assertIsInstance(found, ManagedZone)
-            self.assertEqual(found.zone_id, expected['id'])
-            self.assertEqual(found.name, expected['name'])
-            self.assertEqual(found.dns_name, expected['dnsName'])
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': 3, 'pageToken': TOKEN})
-
-    def test_zone_explicit(self):
-        from google.cloud.dns.zone import ManagedZone
-        DESCRIPTION = 'DESCRIPTION'
-        DNS_NAME = 'test.example.com'
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        zone = client.zone(self.ZONE_NAME, DNS_NAME, DESCRIPTION)
-        self.assertIsInstance(zone, ManagedZone)
-        self.assertEqual(zone.name, self.ZONE_NAME)
-        self.assertEqual(zone.dns_name, DNS_NAME)
-        self.assertEqual(zone.description, DESCRIPTION)
-        self.assertIs(zone._client, client)
-
-    def test_zone_w_dns_name_wo_description(self):
-        from google.cloud.dns.zone import ManagedZone
-        DNS_NAME = 'test.example.com'
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        zone = client.zone(self.ZONE_NAME, DNS_NAME)
-        self.assertIsInstance(zone, ManagedZone)
-        self.assertEqual(zone.name, self.ZONE_NAME)
-        self.assertEqual(zone.dns_name, DNS_NAME)
-        self.assertEqual(zone.description, DNS_NAME)
-        self.assertIs(zone._client, client)
-
-    def test_zone_wo_dns_name(self):
-        from google.cloud.dns.zone import ManagedZone
-        creds = _Credentials()
-        client = self._makeOne(self.PROJECT, creds)
-        zone = client.zone(self.ZONE_NAME)
-        self.assertIsInstance(zone, ManagedZone)
-        self.assertEqual(zone.name, self.ZONE_NAME)
-        self.assertIsNone(zone.dns_name)
-        self.assertIsNone(zone.description)
-        self.assertIs(zone._client, client)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/dns/test_connection.py b/unit_tests/dns/test_connection.py
deleted file mode 100644
index 80bbde5667da..000000000000
--- a/unit_tests/dns/test_connection.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.dns.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'dns',
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeOne()
-        uri = conn.build_api_url('/foo', {'bar': 'baz'})
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        self.assertEqual(path,
-                         '/'.join(['', 'dns', conn.API_VERSION, 'foo']))
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['bar'], 'baz')
diff --git a/unit_tests/dns/test_resource_record_set.py b/unit_tests/dns/test_resource_record_set.py
deleted file mode 100644
index 2adf35312d31..000000000000
--- a/unit_tests/dns/test_resource_record_set.py
+++ /dev/null
@@ -1,94 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestResourceRecordSet(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        return ResourceRecordSet
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        zone = _Zone()
-
-        rrs = self._makeOne('test.example.com', 'CNAME', 3600,
-                            ['www.example.com'], zone)
-
-        self.assertEqual(rrs.name, 'test.example.com')
-        self.assertEqual(rrs.record_type, 'CNAME')
-        self.assertEqual(rrs.ttl, 3600)
-        self.assertEqual(rrs.rrdatas, ['www.example.com'])
-        self.assertIs(rrs.zone, zone)
-
-    def test_from_api_repr_missing_rrdatas(self):
-        zone = _Zone()
-        klass = self._getTargetClass()
-
-        with self.assertRaises(KeyError):
-            klass.from_api_repr({'name': 'test.example.com',
-                                 'type': 'CNAME',
-                                 'ttl': 3600}, zone=zone)
-
-    def test_from_api_repr_missing_ttl(self):
-        zone = _Zone()
-        klass = self._getTargetClass()
-
-        with self.assertRaises(KeyError):
-            klass.from_api_repr({'name': 'test.example.com',
-                                 'type': 'CNAME',
-                                 'rrdatas': ['www.example.com']}, zone=zone)
-
-    def test_from_api_repr_missing_type(self):
-        zone = _Zone()
-        klass = self._getTargetClass()
-
-        with self.assertRaises(KeyError):
-            klass.from_api_repr({'name': 'test.example.com',
-                                 'ttl': 3600,
-                                 'rrdatas': ['www.example.com']}, zone=zone)
-
-    def test_from_api_repr_missing_name(self):
-        zone = _Zone()
-        klass = self._getTargetClass()
-
-        with self.assertRaises(KeyError):
-            klass.from_api_repr({'type': 'CNAME',
-                                 'ttl': 3600,
-                                 'rrdatas': ['www.example.com']}, zone=zone)
-
-    def test_from_api_repr_bare(self):
-        zone = _Zone()
-        RESOURCE = {
-            'kind': 'dns#resourceRecordSet',
-            'name': 'test.example.com',
-            'type': 'CNAME',
-            'ttl': '3600',
-            'rrdatas': ['www.example.com'],
-        }
-        klass = self._getTargetClass()
-        rrs = klass.from_api_repr(RESOURCE, zone=zone)
-        self.assertEqual(rrs.name, 'test.example.com')
-        self.assertEqual(rrs.record_type, 'CNAME')
-        self.assertEqual(rrs.ttl, 3600)
-        self.assertEqual(rrs.rrdatas, ['www.example.com'])
-        self.assertIs(rrs.zone, zone)
-
-
-class _Zone(object):
-    pass
diff --git a/unit_tests/dns/test_zone.py b/unit_tests/dns/test_zone.py
deleted file mode 100644
index 12b07f872854..000000000000
--- a/unit_tests/dns/test_zone.py
+++ /dev/null
@@ -1,692 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestManagedZone(unittest.TestCase):
-    PROJECT = 'project'
-    ZONE_NAME = 'zone-name'
-    DESCRIPTION = 'ZONE DESCRIPTION'
-    DNS_NAME = 'test.example.com'
-
-    def _getTargetClass(self):
-        from google.cloud.dns.zone import ManagedZone
-        return ManagedZone
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _setUpConstants(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        year = 2015
-        month = 7
-        day = 24
-        hour = 19
-        minute = 53
-        seconds = 19
-        micros = 6000
-
-        self.WHEN_STR = '%d-%02d-%02dT%02d:%02d:%02d.%06dZ' % (
-            year, month, day, hour, minute, seconds, micros)
-        self.WHEN = datetime.datetime(
-            year, month, day, hour, minute, seconds, micros, tzinfo=UTC)
-        self.ZONE_ID = 12345
-
-    def _makeResource(self):
-        self._setUpConstants()
-        return {
-            'name': self.ZONE_NAME,
-            'dnsName': self.DNS_NAME,
-            'description': self.DESCRIPTION,
-            'id': self.ZONE_ID,
-            'creationTime': self.WHEN_STR,
-            'nameServers': [
-                'ns-cloud1.googledomains.com',
-                'ns-cloud2.googledomains.com',
-            ],
-        }
-
-    def _verifyReadonlyResourceProperties(self, zone, resource):
-
-        self.assertEqual(zone.zone_id, resource.get('id'))
-
-        if 'creationTime' in resource:
-            self.assertEqual(zone.created, self.WHEN)
-        else:
-            self.assertIsNone(zone.created)
-
-        if 'nameServers' in resource:
-            self.assertEqual(zone.name_servers, resource['nameServers'])
-        else:
-            self.assertIsNone(zone.name_servers)
-
-    def _verifyResourceProperties(self, zone, resource):
-
-        self._verifyReadonlyResourceProperties(zone, resource)
-
-        self.assertEqual(zone.name, resource.get('name'))
-        self.assertEqual(zone.dns_name, resource.get('dnsName'))
-        self.assertEqual(zone.description, resource.get('description'))
-        self.assertEqual(zone.zone_id, resource.get('id'))
-        self.assertEqual(zone.name_server_set, resource.get('nameServerSet'))
-
-    def test_ctor_defaults(self):
-        zone = self._makeOne(self.ZONE_NAME)
-        self.assertEqual(zone.name, self.ZONE_NAME)
-        self.assertIsNone(zone.dns_name)
-        self.assertIsNone(zone._client)
-
-        with self.assertRaises(AttributeError):
-            _ = zone.project
-
-        with self.assertRaises(AttributeError):
-            _ = zone.path
-
-        self.assertIsNone(zone.zone_id)
-        self.assertIsNone(zone.created)
-        self.assertIsNone(zone.description)
-
-    def test_ctor_wo_description(self):
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        self.assertEqual(zone.name, self.ZONE_NAME)
-        self.assertEqual(zone.dns_name, self.DNS_NAME)
-        self.assertIs(zone._client, client)
-        self.assertEqual(zone.project, client.project)
-        self.assertEqual(
-            zone.path,
-            '/projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME))
-        self.assertIsNone(zone.zone_id)
-        self.assertIsNone(zone.created)
-        self.assertEqual(zone.description, self.DNS_NAME)
-
-    def test_ctor_explicit(self):
-        DESCRIPTION = 'DESCRIPTION'
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(
-            self.ZONE_NAME, self.DNS_NAME, client, DESCRIPTION)
-        self.assertEqual(zone.name, self.ZONE_NAME)
-        self.assertEqual(zone.dns_name, self.DNS_NAME)
-        self.assertIs(zone._client, client)
-        self.assertEqual(zone.project, client.project)
-        self.assertEqual(
-            zone.path,
-            '/projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME))
-        self.assertIsNone(zone.zone_id)
-        self.assertIsNone(zone.created)
-        self.assertEqual(zone.description, DESCRIPTION)
-
-    def test_from_api_repr_missing_identity(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {}
-        klass = self._getTargetClass()
-        with self.assertRaises(KeyError):
-            klass.from_api_repr(RESOURCE, client=client)
-
-    def test_from_api_repr_bare(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = {
-            'name': self.ZONE_NAME,
-            'dnsName': self.DNS_NAME,
-        }
-        klass = self._getTargetClass()
-        zone = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(zone._client, client)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_from_api_repr_w_properties(self):
-        self._setUpConstants()
-        client = _Client(self.PROJECT)
-        RESOURCE = self._makeResource()
-        klass = self._getTargetClass()
-        zone = klass.from_api_repr(RESOURCE, client=client)
-        self.assertIs(zone._client, client)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_description_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        with self.assertRaises(ValueError):
-            zone.description = 12345
-
-    def test_description_setter(self):
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        zone.description = 'DESCRIPTION'
-        self.assertEqual(zone.description, 'DESCRIPTION')
-
-    def test_name_server_set_setter_bad_value(self):
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        with self.assertRaises(ValueError):
-            zone.name_server_set = 12345
-
-    def test_name_server_set_setter(self):
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        zone.name_server_set = 'NAME_SERVER_SET'
-        self.assertEqual(zone.name_server_set, 'NAME_SERVER_SET')
-
-    def test_resource_record_set(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        RRS_NAME = 'other.example.com'
-        RRS_TYPE = 'CNAME'
-        TTL = 3600
-        RRDATAS = ['www.example.com']
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        rrs = zone.resource_record_set(RRS_NAME, RRS_TYPE, TTL, RRDATAS)
-        self.assertIsInstance(rrs, ResourceRecordSet)
-        self.assertEqual(rrs.name, RRS_NAME)
-        self.assertEqual(rrs.record_type, RRS_TYPE)
-        self.assertEqual(rrs.ttl, TTL)
-        self.assertEqual(rrs.rrdatas, RRDATAS)
-        self.assertIs(rrs.zone, zone)
-
-    def test_changes(self):
-        from google.cloud.dns.changes import Changes
-        client = _Client(self.PROJECT)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-        changes = zone.changes()
-        self.assertIsInstance(changes, Changes)
-        self.assertIs(changes.zone, zone)
-
-    def test_create_w_bound_client(self):
-        PATH = 'projects/%s/managedZones' % self.PROJECT
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-
-        zone.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'name': self.ZONE_NAME,
-            'dnsName': self.DNS_NAME,
-            'description': self.DNS_NAME,
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_create_w_alternate_client(self):
-        PATH = 'projects/%s/managedZones' % self.PROJECT
-        DESCRIPTION = 'DESCRIPTION'
-        NAME_SERVER_SET = 'NAME_SERVER_SET'
-        RESOURCE = self._makeResource()
-        RESOURCE['nameServerSet'] = NAME_SERVER_SET
-        RESOURCE['description'] = DESCRIPTION
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client1)
-        zone.name_server_set = NAME_SERVER_SET
-        zone.description = DESCRIPTION
-
-        zone.create(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'name': self.ZONE_NAME,
-            'dnsName': self.DNS_NAME,
-            'nameServerSet': NAME_SERVER_SET,
-            'description': DESCRIPTION,
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_create_wo_dns_name_or_description(self):
-        from google.cloud.exceptions import BadRequest
-        PATH = 'projects/%s/managedZones' % self.PROJECT
-
-        _requested = []
-
-        def _api_request(**kw):
-            _requested.append(kw)
-            raise BadRequest('missing dns_name / description')
-
-        conn = _Connection()
-        conn.api_request = _api_request
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, client=client)
-
-        with self.assertRaises(BadRequest):
-            zone.create()
-
-        self.assertEqual(len(_requested), 1)
-        req = _requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'name': self.ZONE_NAME,
-        }
-        self.assertEqual(req['data'], SENT)
-
-    def test_create_w_missing_output_properties(self):
-        # In the wild, the resource returned from 'zone.create' sometimes
-        # lacks 'creationTime' / 'lastModifiedTime'
-        PATH = 'projects/%s/managedZones' % (self.PROJECT,)
-        RESOURCE = self._makeResource()
-        del RESOURCE['creationTime']
-        del RESOURCE['id']
-        del RESOURCE['nameServers']
-        self.WHEN = None
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-
-        zone.create()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        SENT = {
-            'name': self.ZONE_NAME,
-            'dnsName': self.DNS_NAME,
-            'description': self.DNS_NAME,
-        }
-        self.assertEqual(req['data'], SENT)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_exists_miss_w_bound_client(self):
-        PATH = 'projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME)
-        conn = _Connection()
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-
-        self.assertFalse(zone.exists())
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_exists_hit_w_alternate_client(self):
-        PATH = 'projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client1)
-
-        self.assertTrue(zone.exists(client=client2))
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'], {'fields': 'id'})
-
-    def test_reload_w_bound_client(self):
-        PATH = 'projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME)
-        RESOURCE = self._makeResource()
-        conn = _Connection(RESOURCE)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, client=client)
-
-        zone.reload()
-
-        self.assertEqual(zone.dns_name, self.DNS_NAME)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_reload_w_alternate_client(self):
-        PATH = 'projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME)
-        RESOURCE = self._makeResource()
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(RESOURCE)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client1)
-
-        zone.reload(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self._verifyResourceProperties(zone, RESOURCE)
-
-    def test_delete_w_bound_client(self):
-        PATH = 'projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME)
-        conn = _Connection({})
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-
-        zone.delete()
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'DELETE')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_delete_w_alternate_client(self):
-        PATH = 'projects/%s/managedZones/%s' % (self.PROJECT, self.ZONE_NAME)
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection({})
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client1)
-
-        zone.delete(client=client2)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'DELETE')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_resource_record_sets_defaults(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        PATH = 'projects/%s/managedZones/%s/rrsets' % (
-            self.PROJECT, self.ZONE_NAME)
-        TOKEN = 'TOKEN'
-        NAME_1 = 'www.example.com'
-        TYPE_1 = 'A'
-        TTL_1 = '86400'
-        RRDATAS_1 = ['123.45.67.89']
-        NAME_2 = 'alias.example.com'
-        TYPE_2 = 'CNAME'
-        TTL_2 = '3600'
-        RRDATAS_2 = ['www.example.com']
-        DATA = {
-            'nextPageToken': TOKEN,
-            'rrsets': [
-                {'kind': 'dns#resourceRecordSet',
-                 'name': NAME_1,
-                 'type': TYPE_1,
-                 'ttl': TTL_1,
-                 'rrdatas': RRDATAS_1},
-                {'kind': 'dns#resourceRecordSet',
-                 'name': NAME_2,
-                 'type': TYPE_2,
-                 'ttl': TTL_2,
-                 'rrdatas': RRDATAS_2},
-            ]
-        }
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-
-        rrsets, token = zone.list_resource_record_sets()
-
-        self.assertEqual(len(rrsets), len(DATA['rrsets']))
-        for found, expected in zip(rrsets, DATA['rrsets']):
-            self.assertIsInstance(found, ResourceRecordSet)
-            self.assertEqual(found.name, expected['name'])
-            self.assertEqual(found.record_type, expected['type'])
-            self.assertEqual(found.ttl, int(expected['ttl']))
-            self.assertEqual(found.rrdatas, expected['rrdatas'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_resource_record_sets_explicit(self):
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        PATH = 'projects/%s/managedZones/%s/rrsets' % (
-            self.PROJECT, self.ZONE_NAME)
-        TOKEN = 'TOKEN'
-        NAME_1 = 'www.example.com'
-        TYPE_1 = 'A'
-        TTL_1 = '86400'
-        RRDATAS_1 = ['123.45.67.89']
-        NAME_2 = 'alias.example.com'
-        TYPE_2 = 'CNAME'
-        TTL_2 = '3600'
-        RRDATAS_2 = ['www.example.com']
-        DATA = {
-            'rrsets': [
-                {'kind': 'dns#resourceRecordSet',
-                 'name': NAME_1,
-                 'type': TYPE_1,
-                 'ttl': TTL_1,
-                 'rrdatas': RRDATAS_1},
-                {'kind': 'dns#resourceRecordSet',
-                 'name': NAME_2,
-                 'type': TYPE_2,
-                 'ttl': TTL_2,
-                 'rrdatas': RRDATAS_2},
-            ]
-        }
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(DATA)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client1)
-
-        rrsets, token = zone.list_resource_record_sets(
-            max_results=3, page_token=TOKEN, client=client2)
-
-        self.assertEqual(len(rrsets), len(DATA['rrsets']))
-        for found, expected in zip(rrsets, DATA['rrsets']):
-            self.assertIsInstance(found, ResourceRecordSet)
-            self.assertEqual(found.name, expected['name'])
-            self.assertEqual(found.record_type, expected['type'])
-            self.assertEqual(found.ttl, int(expected['ttl']))
-            self.assertEqual(found.rrdatas, expected['rrdatas'])
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': 3, 'pageToken': TOKEN})
-
-    def test_list_changes_defaults(self):
-        from google.cloud._helpers import _datetime_to_rfc3339
-        from google.cloud.dns.changes import Changes
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        self._setUpConstants()
-        PATH = 'projects/%s/managedZones/%s/changes' % (
-            self.PROJECT, self.ZONE_NAME)
-        TOKEN = 'TOKEN'
-        NAME_1 = 'www.example.com'
-        TYPE_1 = 'A'
-        TTL_1 = '86400'
-        RRDATAS_1 = ['123.45.67.89']
-        NAME_2 = 'alias.example.com'
-        TYPE_2 = 'CNAME'
-        TTL_2 = '3600'
-        RRDATAS_2 = ['www.example.com']
-        CHANGES_NAME = 'changeset_id'
-        DATA = {
-            'nextPageToken': TOKEN,
-            'changes': [{
-                'kind': 'dns#change',
-                'id': CHANGES_NAME,
-                'status': 'pending',
-                'startTime': _datetime_to_rfc3339(self.WHEN),
-                'additions': [
-                    {'kind': 'dns#resourceRecordSet',
-                     'name': NAME_1,
-                     'type': TYPE_1,
-                     'ttl': TTL_1,
-                     'rrdatas': RRDATAS_1}],
-                'deletions': [
-                    {'kind': 'dns#change',
-                     'name': NAME_2,
-                     'type': TYPE_2,
-                     'ttl': TTL_2,
-                     'rrdatas': RRDATAS_2}],
-            }]
-        }
-        conn = _Connection(DATA)
-        client = _Client(project=self.PROJECT, connection=conn)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client)
-
-        changes, token = zone.list_changes()
-
-        self.assertEqual(len(changes), len(DATA['changes']))
-        for found, expected in zip(changes, DATA['changes']):
-            self.assertIsInstance(found, Changes)
-            self.assertEqual(found.name, CHANGES_NAME)
-            self.assertEqual(found.status, 'pending')
-            self.assertEqual(found.started, self.WHEN)
-
-            self.assertEqual(len(found.additions), len(expected['additions']))
-            for found_rr, expected_rr in zip(found.additions,
-                                             expected['additions']):
-                self.assertIsInstance(found_rr, ResourceRecordSet)
-                self.assertEqual(found_rr.name, expected_rr['name'])
-                self.assertEqual(found_rr.record_type, expected_rr['type'])
-                self.assertEqual(found_rr.ttl, int(expected_rr['ttl']))
-                self.assertEqual(found_rr.rrdatas, expected_rr['rrdatas'])
-
-            self.assertEqual(len(found.deletions), len(expected['deletions']))
-            for found_rr, expected_rr in zip(found.deletions,
-                                             expected['deletions']):
-                self.assertIsInstance(found_rr, ResourceRecordSet)
-                self.assertEqual(found_rr.name, expected_rr['name'])
-                self.assertEqual(found_rr.record_type, expected_rr['type'])
-                self.assertEqual(found_rr.ttl, int(expected_rr['ttl']))
-                self.assertEqual(found_rr.rrdatas, expected_rr['rrdatas'])
-
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-
-    def test_list_changes_explicit(self):
-        from google.cloud._helpers import _datetime_to_rfc3339
-        from google.cloud.dns.changes import Changes
-        from google.cloud.dns.resource_record_set import ResourceRecordSet
-        self._setUpConstants()
-        PATH = 'projects/%s/managedZones/%s/changes' % (
-            self.PROJECT, self.ZONE_NAME)
-        TOKEN = 'TOKEN'
-        NAME_1 = 'www.example.com'
-        TYPE_1 = 'A'
-        TTL_1 = '86400'
-        RRDATAS_1 = ['123.45.67.89']
-        NAME_2 = 'alias.example.com'
-        TYPE_2 = 'CNAME'
-        TTL_2 = '3600'
-        RRDATAS_2 = ['www.example.com']
-        CHANGES_NAME = 'changeset_id'
-        DATA = {
-            'changes': [{
-                'kind': 'dns#change',
-                'id': CHANGES_NAME,
-                'status': 'pending',
-                'startTime': _datetime_to_rfc3339(self.WHEN),
-                'additions': [
-                    {'kind': 'dns#resourceRecordSet',
-                     'name': NAME_1,
-                     'type': TYPE_1,
-                     'ttl': TTL_1,
-                     'rrdatas': RRDATAS_1}],
-                'deletions': [
-                    {'kind': 'dns#change',
-                     'name': NAME_2,
-                     'type': TYPE_2,
-                     'ttl': TTL_2,
-                     'rrdatas': RRDATAS_2}],
-            }]
-        }
-        conn1 = _Connection()
-        client1 = _Client(project=self.PROJECT, connection=conn1)
-        conn2 = _Connection(DATA)
-        client2 = _Client(project=self.PROJECT, connection=conn2)
-        zone = self._makeOne(self.ZONE_NAME, self.DNS_NAME, client1)
-
-        changes, token = zone.list_changes(
-            max_results=3, page_token=TOKEN, client=client2)
-
-        self.assertEqual(len(changes), len(DATA['changes']))
-        for found, expected in zip(changes, DATA['changes']):
-            self.assertIsInstance(found, Changes)
-            self.assertEqual(found.name, CHANGES_NAME)
-            self.assertEqual(found.status, 'pending')
-            self.assertEqual(found.started, self.WHEN)
-
-            self.assertEqual(len(found.additions), len(expected['additions']))
-            for found_rr, expected_rr in zip(found.additions,
-                                             expected['additions']):
-                self.assertIsInstance(found_rr, ResourceRecordSet)
-                self.assertEqual(found_rr.name, expected_rr['name'])
-                self.assertEqual(found_rr.record_type, expected_rr['type'])
-                self.assertEqual(found_rr.ttl, int(expected_rr['ttl']))
-                self.assertEqual(found_rr.rrdatas, expected_rr['rrdatas'])
-
-            self.assertEqual(len(found.deletions), len(expected['deletions']))
-            for found_rr, expected_rr in zip(found.deletions,
-                                             expected['deletions']):
-                self.assertIsInstance(found_rr, ResourceRecordSet)
-                self.assertEqual(found_rr.name, expected_rr['name'])
-                self.assertEqual(found_rr.record_type, expected_rr['type'])
-                self.assertEqual(found_rr.ttl, int(expected_rr['ttl']))
-                self.assertEqual(found_rr.rrdatas, expected_rr['rrdatas'])
-
-        self.assertIsNone(token)
-
-        self.assertEqual(len(conn1._requested), 0)
-        self.assertEqual(len(conn2._requested), 1)
-        req = conn2._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/%s' % PATH)
-        self.assertEqual(req['query_params'],
-                         {'maxResults': 3, 'pageToken': TOKEN})
-
-
-class _Client(object):
-
-    def __init__(self, project='project', connection=None):
-        self.project = project
-        self.connection = connection
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
diff --git a/unit_tests/error_reporting/__init__.py b/unit_tests/error_reporting/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/error_reporting/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/error_reporting/test_client.py b/unit_tests/error_reporting/test_client.py
deleted file mode 100644
index f4ba0c9c46af..000000000000
--- a/unit_tests/error_reporting/test_client.py
+++ /dev/null
@@ -1,151 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.error_reporting.client import Client
-        return Client
-
-    def _getHttpContext(self):
-        from google.cloud.error_reporting.client import HTTPContext
-        return HTTPContext
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _makeHTTP(self, *args, **kw):
-        return self._getHttpContext()(*args, **kw)
-
-    PROJECT = 'PROJECT'
-    SERVICE = 'SERVICE'
-    VERSION = 'myversion'
-
-    def test_ctor_default(self):
-        CREDENTIALS = _Credentials()
-        target = self._makeOne(project=self.PROJECT,
-                               credentials=CREDENTIALS)
-        self.assertEquals(target.service, target.DEFAULT_SERVICE)
-        self.assertEquals(target.version, None)
-
-    def test_ctor_params(self):
-        CREDENTIALS = _Credentials()
-        target = self._makeOne(project=self.PROJECT,
-                               credentials=CREDENTIALS,
-                               service=self.SERVICE,
-                               version=self.VERSION)
-        self.assertEquals(target.service, self.SERVICE)
-        self.assertEquals(target.version, self.VERSION)
-
-    def test_report_exception(self):
-        CREDENTIALS = _Credentials()
-        target = self._makeOne(project=self.PROJECT,
-                               credentials=CREDENTIALS)
-
-        logger = _Logger()
-        target.logging_client.logger = lambda _: logger
-
-        try:
-            raise NameError
-        except NameError:
-            target.report_exception()
-
-        payload = logger.log_struct_called_with
-        self.assertEquals(payload['serviceContext'], {
-            'service': target.DEFAULT_SERVICE,
-        })
-        self.assertIn('test_report', payload['message'])
-        self.assertIn('test_client.py', payload['message'])
-
-    def test_report_exception_with_service_version_in_constructor(self):
-        CREDENTIALS = _Credentials()
-        SERVICE = "notdefault"
-        VERSION = "notdefaultversion"
-        target = self._makeOne(project=self.PROJECT,
-                               credentials=CREDENTIALS,
-                               service=SERVICE,
-                               version=VERSION)
-
-        logger = _Logger()
-        target.logging_client.logger = lambda _: logger
-
-        http_context = self._makeHTTP(method="GET", response_status_code=500)
-        USER = "user@gmail.com"
-
-        try:
-            raise NameError
-        except NameError:
-            target.report_exception(http_context=http_context, user=USER)
-
-        payload = logger.log_struct_called_with
-        self.assertEquals(payload['serviceContext'], {
-            'service': SERVICE,
-            'version': VERSION
-        })
-        self.assertIn(
-            'test_report_exception_with_service_version_in_constructor',
-            payload['message'])
-        self.assertIn('test_client.py', payload['message'])
-        self.assertEquals(
-            payload['context']['httpContext']['responseStatusCode'], 500)
-        self.assertEquals(
-            payload['context']['httpContext']['method'], 'GET')
-        self.assertEquals(payload['context']['user'], USER)
-
-    def test_report(self):
-        CREDENTIALS = _Credentials()
-        target = self._makeOne(project=self.PROJECT,
-                               credentials=CREDENTIALS)
-
-        logger = _Logger()
-        target.logging_client.logger = lambda _: logger
-
-        MESSAGE = 'this is an error'
-        target.report(MESSAGE)
-
-        payload = logger.log_struct_called_with
-        self.assertEquals(payload['message'], MESSAGE)
-        report_location = payload['context']['reportLocation']
-        self.assertIn('test_client.py', report_location['filePath'])
-        self.assertEqual(report_location['functionName'], 'test_report')
-        self.assertGreater(report_location['lineNumber'], 100)
-        self.assertLess(report_location['lineNumber'], 150)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Logger(object):
-
-    def log_struct(self, payload,  # pylint: disable=unused-argument
-                   client=None,  # pylint: disable=unused-argument
-                   labels=None,   # pylint: disable=unused-argument
-                   insert_id=None,   # pylint: disable=unused-argument
-                   severity=None,   # pylint: disable=unused-argument
-                   http_request=None):  # pylint: disable=unused-argument
-        self.log_struct_called_with = payload
diff --git a/unit_tests/language/__init__.py b/unit_tests/language/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/language/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/language/test_client.py b/unit_tests/language/test_client.py
deleted file mode 100644
index a502fce1ea9d..000000000000
--- a/unit_tests/language/test_client.py
+++ /dev/null
@@ -1,128 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        from google.cloud.language.connection import Connection
-
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(credentials=creds, http=http)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertIs(client.connection.credentials, creds)
-        self.assertIs(client.connection.http, http)
-
-    def test_document_from_text_factory(self):
-        from google.cloud.language.document import Document
-
-        creds = _Credentials()
-        client = self._makeOne(credentials=creds, http=object())
-
-        content = 'abc'
-        language = 'es'
-        document = client.document_from_text(content, language=language)
-        self.assertIsInstance(document, Document)
-        self.assertIs(document.client, client)
-        self.assertEqual(document.content, content)
-        # Test the default arg.
-        self.assertEqual(document.doc_type, Document.PLAIN_TEXT)
-        # Test the kwargs as well.
-        self.assertEqual(document.language, language)
-
-    def test_document_from_text_factory_failure(self):
-        creds = _Credentials()
-        client = self._makeOne(credentials=creds, http=object())
-
-        with self.assertRaises(TypeError):
-            client.document_from_text('abc', doc_type='foo')
-
-    def test_document_from_html_factory(self):
-        from google.cloud.language.document import Document
-
-        creds = _Credentials()
-        client = self._makeOne(credentials=creds, http=object())
-
-        content = '<html>abc</html>'
-        language = 'ja'
-        document = client.document_from_html(content, language=language)
-        self.assertIsInstance(document, Document)
-        self.assertIs(document.client, client)
-        self.assertEqual(document.content, content)
-        # Test the default arg.
-        self.assertEqual(document.doc_type, Document.HTML)
-        # Test the kwargs as well.
-        self.assertEqual(document.language, language)
-
-    def test_document_from_html_factory_failure(self):
-        creds = _Credentials()
-        client = self._makeOne(credentials=creds, http=object())
-
-        with self.assertRaises(TypeError):
-            client.document_from_html('abc', doc_type='foo')
-
-    def test_document_from_url_factory(self):
-        from google.cloud.language.document import Document
-
-        creds = _Credentials()
-        client = self._makeOne(credentials=creds, http=object())
-
-        gcs_url = 'gs://my-text-bucket/sentiment-me.txt'
-        document = client.document_from_url(gcs_url)
-        self.assertIsInstance(document, Document)
-        self.assertIs(document.client, client)
-        self.assertIsNone(document.content)
-        self.assertEqual(document.gcs_url, gcs_url)
-        self.assertEqual(document.doc_type, Document.PLAIN_TEXT)
-
-    def test_document_from_url_factory_explicit(self):
-        from google.cloud.language.document import Document
-        from google.cloud.language.document import Encoding
-
-        creds = _Credentials()
-        client = self._makeOne(credentials=creds, http=object())
-
-        encoding = Encoding.UTF32
-        gcs_url = 'gs://my-text-bucket/sentiment-me.txt'
-        document = client.document_from_url(gcs_url, doc_type=Document.HTML,
-                                            encoding=encoding)
-        self.assertIsInstance(document, Document)
-        self.assertIs(document.client, client)
-        self.assertIsNone(document.content)
-        self.assertEqual(document.gcs_url, gcs_url)
-        self.assertEqual(document.doc_type, Document.HTML)
-        self.assertEqual(document.encoding, encoding)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
diff --git a/unit_tests/language/test_connection.py b/unit_tests/language/test_connection.py
deleted file mode 100644
index 72666cdcf83d..000000000000
--- a/unit_tests/language/test_connection.py
+++ /dev/null
@@ -1,36 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url(self):
-        conn = self._makeOne()
-        uri = '/'.join([
-            conn.API_BASE_URL,
-            conn.API_VERSION,
-            'documents',
-        ])
-        method = 'annotateText'
-        uri += ':' + method
-        self.assertEqual(conn.build_api_url(method), uri)
diff --git a/unit_tests/language/test_document.py b/unit_tests/language/test_document.py
deleted file mode 100644
index 8a6b75becf46..000000000000
--- a/unit_tests/language/test_document.py
+++ /dev/null
@@ -1,392 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-ANNOTATE_NAME = 'Moon'
-ANNOTATE_CONTENT = 'A cow jumped over the %s.' % (ANNOTATE_NAME,)
-ANNOTATE_POLARITY = 1
-ANNOTATE_MAGNITUDE = 0.2
-ANNOTATE_SALIENCE = 0.11793101
-ANNOTATE_WIKI_URL = 'http://en.wikipedia.org/wiki/Natural_satellite'
-
-
-def _make_token_json(name, part_of_speech, head, edge_label):
-    token_dict = {
-        'text': {
-            'content': name,
-            'beginOffset': -1,
-        },
-        'partOfSpeech': {'tag': part_of_speech},
-        'dependencyEdge': {
-            'headTokenIndex': head,
-            'label': edge_label,
-        },
-        'lemma': name,
-    }
-    return token_dict
-
-
-def _get_token_and_sentences(include_syntax):
-    from google.cloud.language.syntax import PartOfSpeech
-
-    if include_syntax:
-        token_info = [
-            ('A', PartOfSpeech.DETERMINER, 1, 'DET'),
-            ('cow', PartOfSpeech.NOUN, 2, 'NSUBJ'),
-            ('jumped', PartOfSpeech.VERB, 2, 'ROOT'),
-            ('over', PartOfSpeech.ADPOSITION, 2, 'PREP'),
-            ('the', PartOfSpeech.DETERMINER, 5, 'DET'),
-            (ANNOTATE_NAME, PartOfSpeech.NOUN, 3, 'POBJ'),
-            ('.', PartOfSpeech.PUNCTUATION, 2, 'P'),
-        ]
-        sentences = [
-            {
-                'text': {
-                    'content': ANNOTATE_CONTENT,
-                    'beginOffset': -1,
-                },
-            },
-        ]
-    else:
-        token_info = []
-        sentences = []
-
-    return token_info, sentences
-
-
-def _get_entities(include_entities):
-    from google.cloud.language.entity import EntityType
-
-    if include_entities:
-        entities = [
-            {
-                'name': ANNOTATE_NAME,
-                'type': EntityType.LOCATION,
-                'metadata': {
-                    'wikipedia_url': ANNOTATE_WIKI_URL,
-                },
-                'salience': ANNOTATE_SALIENCE,
-                'mentions': [
-                    {
-                        'text': {
-                            'content': ANNOTATE_NAME,
-                            'beginOffset': -1
-                        }
-                    }
-                ]
-            },
-        ]
-    else:
-        entities = []
-
-    return entities
-
-
-class TestDocument(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.document import Document
-        return Document
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor_defaults(self):
-        import google.cloud.language.document as MUT
-
-        client = object()
-        content = 'abc'
-        document = self._makeOne(client, content)
-        self.assertIs(document.client, client)
-        self.assertEqual(document.content, content)
-        self.assertIsNone(document.gcs_url)
-        self.assertEqual(document.doc_type, MUT.Document.PLAIN_TEXT)
-        self.assertEqual(document.language, MUT.DEFAULT_LANGUAGE)
-        self.assertEqual(document.encoding, MUT.Encoding.UTF8)
-
-    def test_constructor_explicit(self):
-        import google.cloud.language.document as MUT
-
-        client = object()
-        gcs_url = 'gs://some-bucket/some-obj.html'
-        language = 'ja'
-        document = self._makeOne(client, gcs_url=gcs_url,
-                                 doc_type=MUT.Document.HTML,
-                                 language=language,
-                                 encoding=MUT.Encoding.UTF32)
-        self.assertIs(document.client, client)
-        self.assertIsNone(document.content)
-        self.assertEqual(document.gcs_url, gcs_url)
-        self.assertEqual(document.doc_type, MUT.Document.HTML)
-        self.assertEqual(document.language, language)
-        self.assertEqual(document.encoding, MUT.Encoding.UTF32)
-
-    def test_constructor_no_text(self):
-        with self.assertRaises(ValueError):
-            self._makeOne(None, content=None, gcs_url=None)
-
-    def test_constructor_text_and_gcs(self):
-        with self.assertRaises(ValueError):
-            self._makeOne(None, content='abc',
-                          gcs_url='gs://some-bucket/some-obj.txt')
-
-    def test__to_dict_with_content(self):
-        klass = self._getTargetClass()
-        content = 'Hello World'
-        document = self._makeOne(None, content=content)
-        info = document._to_dict()
-        self.assertEqual(info, {
-            'content': content,
-            'language': document.language,
-            'type': klass.PLAIN_TEXT,
-        })
-
-    def test__to_dict_with_gcs(self):
-        klass = self._getTargetClass()
-        gcs_url = 'gs://some-bucket/some-obj.html'
-        document = self._makeOne(None, gcs_url=gcs_url)
-        info = document._to_dict()
-        self.assertEqual(info, {
-            'gcsContentUri': gcs_url,
-            'language': document.language,
-            'type': klass.PLAIN_TEXT,
-        })
-
-    def test__to_dict_with_no_content(self):
-        klass = self._getTargetClass()
-        document = self._makeOne(None, content='')
-        document.content = None  # Manually unset the content.
-        info = document._to_dict()
-        self.assertEqual(info, {
-            'language': document.language,
-            'type': klass.PLAIN_TEXT,
-        })
-
-    def _verify_entity(self, entity, name, entity_type, wiki_url, salience):
-        from google.cloud.language.entity import Entity
-
-        self.assertIsInstance(entity, Entity)
-        self.assertEqual(entity.name, name)
-        self.assertEqual(entity.entity_type, entity_type)
-        self.assertEqual(entity.wikipedia_url, wiki_url)
-        self.assertEqual(entity.metadata, {})
-        self.assertEqual(entity.salience, salience)
-        self.assertEqual(entity.mentions, [name])
-
-    def test_analyze_entities(self):
-        from google.cloud.language.entity import EntityType
-
-        name1 = 'R-O-C-K'
-        name2 = 'USA'
-        content = name1 + ' in the ' + name2
-        wiki2 = 'http://en.wikipedia.org/wiki/United_States'
-        salience1 = 0.91391456
-        salience2 = 0.086085409
-        response = {
-            'entities': [
-                {
-                    'name': name1,
-                    'type': EntityType.OTHER,
-                    'metadata': {},
-                    'salience': salience1,
-                    'mentions': [
-                        {
-                            'text': {
-                                'content': name1,
-                                'beginOffset': -1
-                            }
-                        }
-                    ]
-                },
-                {
-                    'name': name2,
-                    'type': EntityType.LOCATION,
-                    'metadata': {'wikipedia_url': wiki2},
-                    'salience': salience2,
-                    'mentions': [
-                        {
-                            'text': {
-                                'content': name2,
-                                'beginOffset': -1,
-                            },
-                        },
-                    ],
-                },
-            ],
-            'language': 'en-US',
-        }
-        connection = _Connection(response)
-        client = _Client(connection=connection)
-        document = self._makeOne(client, content)
-
-        entities = document.analyze_entities()
-        self.assertEqual(len(entities), 2)
-        entity1 = entities[0]
-        self._verify_entity(entity1, name1, EntityType.OTHER,
-                            None, salience1)
-        entity2 = entities[1]
-        self._verify_entity(entity2, name2, EntityType.LOCATION,
-                            wiki2, salience2)
-
-        # Verify the request.
-        self.assertEqual(len(connection._requested), 1)
-        req = connection._requested[0]
-        self.assertEqual(req['path'], 'analyzeEntities')
-        self.assertEqual(req['method'], 'POST')
-
-    def _verify_sentiment(self, sentiment, polarity, magnitude):
-        from google.cloud.language.sentiment import Sentiment
-
-        self.assertIsInstance(sentiment, Sentiment)
-        self.assertEqual(sentiment.polarity, polarity)
-        self.assertEqual(sentiment.magnitude, magnitude)
-
-    def test_analyze_sentiment(self):
-        content = 'All the pretty horses.'
-        polarity = 1
-        magnitude = 0.6
-        response = {
-            'documentSentiment': {
-                'polarity': polarity,
-                'magnitude': magnitude,
-            },
-            'language': 'en-US',
-        }
-        connection = _Connection(response)
-        client = _Client(connection=connection)
-        document = self._makeOne(client, content)
-
-        sentiment = document.analyze_sentiment()
-        self._verify_sentiment(sentiment, polarity, magnitude)
-
-        # Verify the request.
-        self.assertEqual(len(connection._requested), 1)
-        req = connection._requested[0]
-        self.assertEqual(req['path'], 'analyzeSentiment')
-        self.assertEqual(req['method'], 'POST')
-
-    def _verify_sentences(self, include_syntax, annotations):
-        from google.cloud.language.syntax import Sentence
-
-        if include_syntax:
-            self.assertEqual(len(annotations.sentences), 1)
-            sentence = annotations.sentences[0]
-            self.assertIsInstance(sentence, Sentence)
-            self.assertEqual(sentence.content, ANNOTATE_CONTENT)
-            self.assertEqual(sentence.begin, -1)
-        else:
-            self.assertEqual(annotations.sentences, [])
-
-    def _verify_tokens(self, annotations, token_info):
-        from google.cloud.language.syntax import Token
-
-        self.assertEqual(len(annotations.tokens), len(token_info))
-        for token, info in zip(annotations.tokens, token_info):
-            self.assertIsInstance(token, Token)
-            self.assertEqual(token.text_content, info[0])
-            self.assertEqual(token.text_begin, -1)
-            self.assertEqual(token.part_of_speech, info[1])
-            self.assertEqual(token.edge_index, info[2])
-            self.assertEqual(token.edge_label, info[3])
-            self.assertEqual(token.lemma, info[0])
-
-    def _annotate_text_helper(self, include_sentiment,
-                              include_entities, include_syntax):
-        from google.cloud.language.document import Annotations
-        from google.cloud.language.entity import EntityType
-
-        token_info, sentences = _get_token_and_sentences(include_syntax)
-        entities = _get_entities(include_entities)
-        tokens = [_make_token_json(*info) for info in token_info]
-        response = {
-            'sentences': sentences,
-            'tokens': tokens,
-            'entities': entities,
-            'language': 'en-US',
-        }
-        if include_sentiment:
-            response['documentSentiment'] = {
-                'polarity': ANNOTATE_POLARITY,
-                'magnitude': ANNOTATE_MAGNITUDE,
-            }
-
-        connection = _Connection(response)
-        client = _Client(connection=connection)
-        document = self._makeOne(client, ANNOTATE_CONTENT)
-
-        annotations = document.annotate_text(
-            include_syntax=include_syntax, include_entities=include_entities,
-            include_sentiment=include_sentiment)
-        self.assertIsInstance(annotations, Annotations)
-        # Sentences
-        self._verify_sentences(include_syntax, annotations)
-        # Token
-        self._verify_tokens(annotations, token_info)
-        # Sentiment
-        if include_sentiment:
-            self._verify_sentiment(annotations.sentiment,
-                                   ANNOTATE_POLARITY, ANNOTATE_MAGNITUDE)
-        else:
-            self.assertIsNone(annotations.sentiment)
-        # Entity
-        if include_entities:
-            self.assertEqual(len(annotations.entities), 1)
-            entity = annotations.entities[0]
-            self._verify_entity(entity, ANNOTATE_NAME, EntityType.LOCATION,
-                                ANNOTATE_WIKI_URL, ANNOTATE_SALIENCE)
-        else:
-            self.assertEqual(annotations.entities, [])
-
-        # Verify the request.
-        self.assertEqual(len(connection._requested), 1)
-        req = connection._requested[0]
-        self.assertEqual(req['path'], 'annotateText')
-        self.assertEqual(req['method'], 'POST')
-        features = req['data']['features']
-        self.assertEqual(features.get('extractDocumentSentiment', False),
-                         include_sentiment)
-        self.assertEqual(features.get('extractEntities', False),
-                         include_entities)
-        self.assertEqual(features.get('extractSyntax', False), include_syntax)
-
-    def test_annotate_text(self):
-        self._annotate_text_helper(True, True, True)
-
-    def test_annotate_text_sentiment_only(self):
-        self._annotate_text_helper(True, False, False)
-
-    def test_annotate_text_entities_only(self):
-        self._annotate_text_helper(False, True, False)
-
-    def test_annotate_text_syntax_only(self):
-        self._annotate_text_helper(False, False, True)
-
-
-class _Connection(object):
-
-    def __init__(self, response):
-        self._response = response
-        self._requested = []
-
-    def api_request(self, **kwargs):
-        self._requested.append(kwargs)
-        return self._response
-
-
-class _Client(object):
-
-    def __init__(self, connection=None):
-        self.connection = connection
diff --git a/unit_tests/language/test_entity.py b/unit_tests/language/test_entity.py
deleted file mode 100644
index eb58f40d1f9d..000000000000
--- a/unit_tests/language/test_entity.py
+++ /dev/null
@@ -1,71 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestEntity(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.entity import Entity
-        return Entity
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor_defaults(self):
-        name = 'Italian'
-        entity_type = 'LOCATION'
-        wiki_url = 'http://en.wikipedia.org/wiki/Italy'
-        metadata = {'wikipedia_url': wiki_url}
-        base_metadata = {'foo': 'bar'}
-        metadata.update(base_metadata)
-        salience = 0.19960518
-        mentions = ['Italian']
-        entity = self._makeOne(name, entity_type, metadata,
-                               salience, mentions)
-        self.assertEqual(entity.name, name)
-        self.assertEqual(entity.entity_type, entity_type)
-        self.assertEqual(entity.wikipedia_url, wiki_url)
-        self.assertEqual(entity.metadata, base_metadata)
-        self.assertEqual(entity.salience, salience)
-        self.assertEqual(entity.mentions, mentions)
-
-    def test_from_api_repr(self):
-        klass = self._getTargetClass()
-        name = 'Italy'
-        entity_type = 'LOCATION'
-        salience = 0.223
-        wiki_url = 'http://en.wikipedia.org/wiki/Italy'
-        mention1 = 'Italy'
-        mention2 = 'To Italy'
-        mention3 = 'From Italy'
-        payload = {
-            'name': name,
-            'type': entity_type,
-            'salience': salience,
-            'metadata': {'wikipedia_url': wiki_url},
-            'mentions': [
-                {'text': {'content': mention1}},
-                {'text': {'content': mention2}},
-                {'text': {'content': mention3}},
-            ],
-        }
-        entity = klass.from_api_repr(payload)
-        self.assertEqual(entity.name, name)
-        self.assertEqual(entity.entity_type, entity_type)
-        self.assertEqual(entity.salience, salience)
-        self.assertEqual(entity.wikipedia_url, wiki_url)
-        self.assertEqual(entity.metadata, {})
-        self.assertEqual(entity.mentions, [mention1, mention2, mention3])
diff --git a/unit_tests/language/test_sentiment.py b/unit_tests/language/test_sentiment.py
deleted file mode 100644
index de24665cbf7b..000000000000
--- a/unit_tests/language/test_sentiment.py
+++ /dev/null
@@ -1,44 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestSentiment(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.sentiment import Sentiment
-        return Sentiment
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor(self):
-        polarity = 1
-        magnitude = 2.3
-        sentiment = self._makeOne(polarity, magnitude)
-        self.assertEqual(sentiment.polarity, polarity)
-        self.assertEqual(sentiment.magnitude, magnitude)
-
-    def test_from_api_repr(self):
-        klass = self._getTargetClass()
-        polarity = -1
-        magnitude = 5.55
-        payload = {
-            'polarity': polarity,
-            'magnitude': magnitude,
-        }
-        sentiment = klass.from_api_repr(payload)
-        self.assertEqual(sentiment.polarity, polarity)
-        self.assertEqual(sentiment.magnitude, magnitude)
diff --git a/unit_tests/language/test_syntax.py b/unit_tests/language/test_syntax.py
deleted file mode 100644
index 53718956581e..000000000000
--- a/unit_tests/language/test_syntax.py
+++ /dev/null
@@ -1,124 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestPartOfSpeech(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.syntax import PartOfSpeech
-        return PartOfSpeech
-
-    def test_reverse(self):
-        klass = self._getTargetClass()
-        for attr in dir(klass):
-            if attr.startswith('_'):
-                continue
-            if attr.islower():
-                continue
-            value = getattr(klass, attr)
-            result = klass.reverse(value)
-            self.assertEqual(result, attr)
-
-
-class TestToken(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.syntax import Token
-        return Token
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor(self):
-        from google.cloud.language.syntax import PartOfSpeech
-
-        text_content = 'All'
-        text_begin = -1
-        part_of_speech = PartOfSpeech.DETERMINER
-        edge_index = 3
-        edge_label = 'PREDET'
-        lemma = text_content
-        token = self._makeOne(text_content, text_begin, part_of_speech,
-                              edge_index, edge_label, lemma)
-        self.assertEqual(token.text_content, text_content)
-        self.assertEqual(token.text_begin, text_begin)
-        self.assertEqual(token.part_of_speech, part_of_speech)
-        self.assertEqual(token.edge_index, edge_index)
-        self.assertEqual(token.edge_label, edge_label)
-        self.assertEqual(token.lemma, lemma)
-
-    def test_from_api_repr(self):
-        from google.cloud.language.syntax import PartOfSpeech
-
-        klass = self._getTargetClass()
-        text_content = 'pretty'
-        text_begin = -1
-        part_of_speech = PartOfSpeech.ADJECTIVE
-        edge_index = 3
-        edge_label = 'AMOD'
-        lemma = text_content
-        payload = {
-            'text': {
-                'content': text_content,
-                'beginOffset': text_begin,
-            },
-            'partOfSpeech': {
-                'tag': part_of_speech,
-            },
-            'dependencyEdge': {
-                'headTokenIndex': edge_index,
-                'label': edge_label,
-            },
-            'lemma': lemma,
-        }
-        token = klass.from_api_repr(payload)
-        self.assertEqual(token.text_content, text_content)
-        self.assertEqual(token.text_begin, text_begin)
-        self.assertEqual(token.part_of_speech, part_of_speech)
-        self.assertEqual(token.edge_index, edge_index)
-        self.assertEqual(token.edge_label, edge_label)
-        self.assertEqual(token.lemma, lemma)
-
-
-class TestSentence(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.language.syntax import Sentence
-        return Sentence
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor(self):
-        content = "All the king's horses."
-        begin = 11
-        sentence = self._makeOne(content, begin)
-        self.assertEqual(sentence.content, content)
-        self.assertEqual(sentence.begin, begin)
-
-    def test_from_api_repr(self):
-        klass = self._getTargetClass()
-        content = 'All the pretty horses.'
-        begin = -1
-        payload = {
-            'text': {
-                'content': content,
-                'beginOffset': begin,
-            },
-        }
-        sentence = klass.from_api_repr(payload)
-        self.assertEqual(sentence.content, content)
-        self.assertEqual(sentence.begin, begin)
diff --git a/unit_tests/logging/__init__.py b/unit_tests/logging/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/logging/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/logging/handlers/__init__.py b/unit_tests/logging/handlers/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/logging/handlers/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/logging/handlers/test_handlers.py b/unit_tests/logging/handlers/test_handlers.py
deleted file mode 100644
index 6e7d807996e2..000000000000
--- a/unit_tests/logging/handlers/test_handlers.py
+++ /dev/null
@@ -1,122 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import logging
-import unittest
-
-
-class TestCloudLoggingHandler(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.handlers.handlers import CloudLoggingHandler
-        return CloudLoggingHandler
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        handler = self._makeOne(client, transport=_Transport)
-        self.assertEqual(handler.client, client)
-
-    def test_emit(self):
-        client = _Client(self.PROJECT)
-        handler = self._makeOne(client, transport=_Transport)
-        LOGNAME = 'loggername'
-        MESSAGE = 'hello world'
-        record = _Record(LOGNAME, logging.INFO, MESSAGE)
-        handler.emit(record)
-
-        self.assertEqual(handler.transport.send_called_with, (record, MESSAGE))
-
-
-class TestSetupLogging(unittest.TestCase):
-
-    def _callFUT(self, handler, excludes=None):
-        from google.cloud.logging.handlers.handlers import setup_logging
-        if excludes:
-            return setup_logging(handler, excluded_loggers=excludes)
-        else:
-            return setup_logging(handler)
-
-    def test_setup_logging(self):
-        handler = _Handler(logging.INFO)
-        self._callFUT(handler)
-
-        root_handlers = logging.getLogger().handlers
-        self.assertIn(handler, root_handlers)
-
-    def test_setup_logging_excludes(self):
-        INCLUDED_LOGGER_NAME = 'includeme'
-        EXCLUDED_LOGGER_NAME = 'excludeme'
-
-        handler = _Handler(logging.INFO)
-        self._callFUT(handler, (EXCLUDED_LOGGER_NAME,))
-
-        included_logger = logging.getLogger(INCLUDED_LOGGER_NAME)
-        self.assertTrue(included_logger.propagate)
-
-        excluded_logger = logging.getLogger(EXCLUDED_LOGGER_NAME)
-        self.assertNotIn(handler, excluded_logger.handlers)
-        self.assertFalse(excluded_logger.propagate)
-
-    def setUp(self):
-        self._handlers_cache = logging.getLogger().handlers[:]
-
-    def tearDown(self):
-        # cleanup handlers
-        logging.getLogger().handlers = self._handlers_cache[:]
-
-
-class _Handler(object):
-
-    def __init__(self, level):
-        self.level = level
-
-    def acquire(self):
-        pass  # pragma: NO COVER
-
-    def release(self):
-        pass  # pragma: NO COVER
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-
-
-class _Record(object):
-
-    def __init__(self, name, level, message):
-        self.name = name
-        self.levelname = level
-        self.message = message
-        self.exc_info = None
-        self.exc_text = None
-        self.stack_info = None
-
-    def getMessage(self):
-        return self.message
-
-
-class _Transport(object):
-
-    def __init__(self, client, name):
-        pass
-
-    def send(self, record, message):
-        self.send_called_with = (record, message)
diff --git a/unit_tests/logging/handlers/transports/__init__.py b/unit_tests/logging/handlers/transports/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/logging/handlers/transports/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/logging/handlers/transports/test_background_thread.py b/unit_tests/logging/handlers/transports/test_background_thread.py
deleted file mode 100644
index d74881c67b61..000000000000
--- a/unit_tests/logging/handlers/transports/test_background_thread.py
+++ /dev/null
@@ -1,193 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import logging
-import time
-import unittest
-
-
-class TestBackgroundThreadHandler(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.handlers.transports import (
-            BackgroundThreadTransport)
-        return BackgroundThreadTransport
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        NAME = 'python_logger'
-        transport = self._makeOne(client, NAME)
-        self.assertEquals(transport.worker.logger.name, NAME)
-
-    def test_send(self):
-        client = _Client(self.PROJECT)
-        NAME = 'python_logger'
-        transport = self._makeOne(client, NAME)
-        transport.worker.batch = client.logger(NAME).batch()
-
-        PYTHON_LOGGER_NAME = 'mylogger'
-        MESSAGE = 'hello world'
-        record = _Record(PYTHON_LOGGER_NAME, logging.INFO, MESSAGE)
-        transport.send(record, MESSAGE)
-
-        EXPECTED_STRUCT = {
-            'message': MESSAGE,
-            'python_logger': PYTHON_LOGGER_NAME
-        }
-        EXPECTED_SENT = (EXPECTED_STRUCT, logging.INFO)
-        self.assertEqual(transport.worker.batch.log_struct_called_with,
-                         EXPECTED_SENT)
-
-
-class TestWorker(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.logging.handlers.transports import background_thread
-        return background_thread._Worker
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        NAME = 'python_logger'
-        logger = _Logger(NAME)
-        worker = self._makeOne(logger)
-        self.assertEquals(worker.batch, logger._batch)
-
-    def test_run(self):
-        NAME = 'python_logger'
-        logger = _Logger(NAME)
-        worker = self._makeOne(logger)
-
-        PYTHON_LOGGER_NAME = 'mylogger'
-        MESSAGE = 'hello world'
-        record = _Record(PYTHON_LOGGER_NAME, logging.INFO, MESSAGE)
-
-        worker._start()
-
-        # first sleep is for branch coverage - ensure condition
-        # where queue is empty occurs
-        time.sleep(1)
-        # second polling is to avoid starting/stopping worker
-        # before anything ran
-        while not worker.started:
-            time.sleep(1)  # pragma: NO COVER
-
-        worker.enqueue(record, MESSAGE)
-        # Set timeout to none so worker thread finishes
-        worker._stop_timeout = None
-        worker._stop()
-        self.assertTrue(worker.batch.commit_called)
-
-    def test_run_after_stopped(self):
-        # No-op
-        NAME = 'python_logger'
-        logger = _Logger(NAME)
-        worker = self._makeOne(logger)
-
-        PYTHON_LOGGER_NAME = 'mylogger'
-        MESSAGE = 'hello world'
-        record = _Record(PYTHON_LOGGER_NAME, logging.INFO, MESSAGE)
-
-        worker._start()
-        while not worker.started:
-            time.sleep(1)  # pragma: NO COVER
-        worker._stop_timeout = None
-        worker._stop()
-        worker.enqueue(record, MESSAGE)
-        self.assertFalse(worker.batch.commit_called)
-        worker._stop()
-
-    def test_run_enqueue_early(self):
-        # No-op
-        NAME = 'python_logger'
-        logger = _Logger(NAME)
-        worker = self._makeOne(logger)
-
-        PYTHON_LOGGER_NAME = 'mylogger'
-        MESSAGE = 'hello world'
-        record = _Record(PYTHON_LOGGER_NAME, logging.INFO, MESSAGE)
-
-        worker.enqueue(record, MESSAGE)
-        worker._start()
-        while not worker.started:
-            time.sleep(1)  # pragma: NO COVER
-        worker._stop_timeout = None
-        worker._stop()
-        self.assertTrue(worker.stopped)
-
-
-class _Record(object):
-
-    def __init__(self, name, level, message):
-        self.name = name
-        self.levelname = level
-        self.message = message
-        self.exc_info = None
-        self.exc_text = None
-        self.stack_info = None
-
-
-class _Batch(object):
-
-    def __init__(self):
-        self.entries = []
-        self.commit_called = False
-
-    def log_struct(self, record, severity=logging.INFO):
-        self.log_struct_called_with = (record, severity)
-        self.entries.append(record)
-
-    def commit(self):
-        self.commit_called = True
-        del self.entries[:]
-
-
-class _Credentials(object):
-
-    def authorize(self, _):
-        pass
-
-
-class _Connection(object):
-
-    def __init__(self):
-        self.http = None
-        self.credentials = _Credentials()
-
-
-class _Logger(object):
-
-    def __init__(self, name):
-        self.name = name
-
-    def batch(self):
-        self._batch = _Batch()
-        return self._batch
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-        self.connection = _Connection()
-
-    def logger(self, name):  # pylint: disable=unused-argument
-        self._logger = _Logger(name)
-        return self._logger
diff --git a/unit_tests/logging/handlers/transports/test_base.py b/unit_tests/logging/handlers/transports/test_base.py
deleted file mode 100644
index 6aa2e47f84b6..000000000000
--- a/unit_tests/logging/handlers/transports/test_base.py
+++ /dev/null
@@ -1,32 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestBaseHandler(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.handlers.transports import Transport
-        return Transport
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_send_is_abstract(self):
-        target = self._makeOne()
-        with self.assertRaises(NotImplementedError):
-            target.send(None, None)
diff --git a/unit_tests/logging/handlers/transports/test_sync.py b/unit_tests/logging/handlers/transports/test_sync.py
deleted file mode 100644
index d99933c7efea..000000000000
--- a/unit_tests/logging/handlers/transports/test_sync.py
+++ /dev/null
@@ -1,93 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import logging
-import unittest
-
-
-class TestSyncHandler(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.handlers.transports import SyncTransport
-        return SyncTransport
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        client = _Client(self.PROJECT)
-        NAME = 'python_logger'
-        transport = self._makeOne(client, NAME)
-        self.assertEqual(transport.logger.name, 'python_logger')
-
-    def test_send(self):
-        client = _Client(self.PROJECT)
-        STACKDRIVER_LOGGER_NAME = 'python'
-        PYTHON_LOGGER_NAME = 'mylogger'
-        transport = self._makeOne(client, STACKDRIVER_LOGGER_NAME)
-        MESSAGE = 'hello world'
-        record = _Record(PYTHON_LOGGER_NAME, logging.INFO, MESSAGE)
-
-        transport.send(record, MESSAGE)
-        EXPECTED_STRUCT = {
-            'message': MESSAGE,
-            'python_logger': PYTHON_LOGGER_NAME
-        }
-        EXPECTED_SENT = (EXPECTED_STRUCT, logging.INFO)
-        self.assertEqual(
-            transport.logger.log_struct_called_with, EXPECTED_SENT)
-
-
-class _Record(object):
-
-    def __init__(self, name, level, message):
-        self.name = name
-        self.levelname = level
-        self.message = message
-        self.exc_info = None
-        self.exc_text = None
-        self.stack_info = None
-
-
-class _Logger(object):
-
-    def __init__(self, name):
-        self.name = name
-
-    def log_struct(self, message, severity=None):
-        self.log_struct_called_with = (message, severity)
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-
-    def logger(self, name):  # pylint: disable=unused-argument
-        self._logger = _Logger(name)
-        return self._logger
-
-
-class _Handler(object):
-
-    def __init__(self, level):
-        self.level = level  # pragma: NO COVER
-
-    def acquire(self):
-        pass  # pragma: NO COVER
-
-    def release(self):
-        pass  # pragma: NO COVER
diff --git a/unit_tests/logging/test__gax.py b/unit_tests/logging/test__gax.py
deleted file mode 100644
index 4fcd22f267d8..000000000000
--- a/unit_tests/logging/test__gax.py
+++ /dev/null
@@ -1,1104 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-try:
-    # pylint: disable=unused-import
-    import google.cloud.logging._gax
-    # pylint: enable=unused-import
-except ImportError:  # pragma: NO COVER
-    _HAVE_GAX = False
-else:
-    _HAVE_GAX = True
-
-from unit_tests._testing import _GAXBaseAPI
-
-
-class _Base(object):
-    PROJECT = 'PROJECT'
-    PROJECT_PATH = 'projects/%s' % (PROJECT,)
-    FILTER = 'logName:syslog AND severity>=ERROR'
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_LoggingAPI(_Base, unittest.TestCase):
-    LOG_NAME = 'log_name'
-
-    def _getTargetClass(self):
-        from google.cloud.logging._gax import _LoggingAPI
-        return _LoggingAPI
-
-    def test_ctor(self):
-        gax_api = _GAXLoggingAPI()
-        api = self._makeOne(gax_api)
-        self.assertIs(api._gax_api, gax_api)
-
-    def test_list_entries_no_paging(self):
-        from google.gax import INITIAL_PAGE
-        from google.cloud.logging import DESCENDING
-        from unit_tests._testing import _GAXPageIterator
-
-        TOKEN = 'TOKEN'
-        TEXT = 'TEXT'
-        response = _GAXPageIterator(
-            [_LogEntryPB(self.LOG_NAME, text_payload=TEXT)], TOKEN)
-        gax_api = _GAXLoggingAPI(_list_log_entries_response=response)
-        api = self._makeOne(gax_api)
-
-        entries, next_token = api.list_entries(
-            [self.PROJECT], self.FILTER, DESCENDING)
-
-        self.assertEqual(len(entries), 1)
-        entry = entries[0]
-        self.assertIsInstance(entry, dict)
-        self.assertEqual(entry['logName'], self.LOG_NAME)
-        self.assertEqual(entry['resource'], {'type': 'global'})
-        self.assertEqual(entry['textPayload'], TEXT)
-        self.assertEqual(next_token, TOKEN)
-
-        projects, filter_, order_by, page_size, options = (
-            gax_api._list_log_entries_called_with)
-        self.assertEqual(projects, [self.PROJECT])
-        self.assertEqual(filter_, self.FILTER)
-        self.assertEqual(order_by, DESCENDING)
-        self.assertEqual(page_size, 0)
-        self.assertIs(options.page_token, INITIAL_PAGE)
-
-    def test_list_entries_with_paging(self):
-        from google.protobuf.struct_pb2 import Value
-        from unit_tests._testing import _GAXPageIterator
-        SIZE = 23
-        TOKEN = 'TOKEN'
-        NEW_TOKEN = 'NEW_TOKEN'
-        PAYLOAD = {'message': 'MESSAGE', 'weather': 'sunny'}
-        struct_pb = _StructPB({
-            key: Value(string_value=value) for key, value in PAYLOAD.items()
-        })
-        response = _GAXPageIterator(
-            [_LogEntryPB(self.LOG_NAME, json_payload=struct_pb)], NEW_TOKEN)
-        gax_api = _GAXLoggingAPI(_list_log_entries_response=response)
-        api = self._makeOne(gax_api)
-
-        entries, next_token = api.list_entries(
-            [self.PROJECT], page_size=SIZE, page_token=TOKEN)
-
-        self.assertEqual(len(entries), 1)
-        entry = entries[0]
-        self.assertIsInstance(entry, dict)
-        self.assertEqual(entry['logName'], self.LOG_NAME)
-        self.assertEqual(entry['resource'], {'type': 'global'})
-        self.assertEqual(entry['jsonPayload'], PAYLOAD)
-        self.assertEqual(next_token, NEW_TOKEN)
-
-        projects, filter_, order_by, page_size, options = (
-            gax_api._list_log_entries_called_with)
-        self.assertEqual(projects, [self.PROJECT])
-        self.assertEqual(filter_, '')
-        self.assertEqual(order_by, '')
-        self.assertEqual(page_size, SIZE)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_list_entries_with_extra_properties(self):
-        from datetime import datetime
-        from google.logging.type.log_severity_pb2 import WARNING
-        from unit_tests._testing import _GAXPageIterator
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _datetime_to_rfc3339
-        from google.cloud._helpers import _datetime_to_pb_timestamp
-        NOW = datetime.utcnow().replace(tzinfo=UTC)
-        SIZE = 23
-        TOKEN = 'TOKEN'
-        NEW_TOKEN = 'NEW_TOKEN'
-        PAYLOAD = {'message': 'MESSAGE', 'weather': 'sunny'}
-        SEVERITY = 'WARNING'
-        LABELS = {
-            'foo': 'bar',
-        }
-        IID = 'IID'
-        request = _HTTPRequestPB()
-        operation = _LogEntryOperationPB()
-        EXTRAS = {
-            'severity': WARNING,
-            'labels': LABELS,
-            'insert_id': IID,
-            'http_request': request,
-            'operation': operation,
-        }
-        ENTRY = _LogEntryPB(self.LOG_NAME, proto_payload=PAYLOAD, **EXTRAS)
-        ENTRY.resource.labels['foo'] = 'bar'
-        ENTRY.timestamp = _datetime_to_pb_timestamp(NOW)
-        response = _GAXPageIterator([ENTRY], NEW_TOKEN)
-        gax_api = _GAXLoggingAPI(_list_log_entries_response=response)
-        api = self._makeOne(gax_api)
-
-        entries, next_token = api.list_entries(
-            [self.PROJECT], page_size=SIZE, page_token=TOKEN)
-
-        self.assertEqual(len(entries), 1)
-        entry = entries[0]
-        self.assertIsInstance(entry, dict)
-        self.assertEqual(entry['logName'], self.LOG_NAME)
-        self.assertEqual(entry['resource'],
-                         {'type': 'global', 'labels': {'foo': 'bar'}})
-        self.assertEqual(entry['protoPayload'], PAYLOAD)
-        self.assertEqual(entry['severity'], SEVERITY)
-        self.assertEqual(entry['labels'], LABELS)
-        self.assertEqual(entry['insertId'], IID)
-        self.assertEqual(entry['timestamp'], _datetime_to_rfc3339(NOW))
-        EXPECTED_REQUEST = {
-            'requestMethod': request.request_method,
-            'requestUrl': request.request_url,
-            'status': request.status,
-            'requestSize': request.request_size,
-            'responseSize': request.response_size,
-            'referer': request.referer,
-            'userAgent': request.user_agent,
-            'remoteIp': request.remote_ip,
-            'cacheHit': request.cache_hit,
-        }
-        self.assertEqual(entry['httpRequest'], EXPECTED_REQUEST)
-        EXPECTED_OPERATION = {
-            'producer': operation.producer,
-            'id': operation.id,
-            'first': operation.first,
-            'last': operation.last,
-        }
-        self.assertEqual(entry['operation'], EXPECTED_OPERATION)
-        self.assertEqual(next_token, NEW_TOKEN)
-
-        projects, filter_, order_by, page_size, options = (
-            gax_api._list_log_entries_called_with)
-        self.assertEqual(projects, [self.PROJECT])
-        self.assertEqual(filter_, '')
-        self.assertEqual(order_by, '')
-        self.assertEqual(page_size, SIZE)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_write_entries_single(self):
-        from google.logging.v2.log_entry_pb2 import LogEntry
-        TEXT = 'TEXT'
-        LOG_PATH = 'projects/%s/logs/%s' % (self.PROJECT, self.LOG_NAME)
-        ENTRY = {
-            'logName': LOG_PATH,
-            'resource': {'type': 'global'},
-            'textPayload': TEXT,
-        }
-        gax_api = _GAXLoggingAPI()
-        api = self._makeOne(gax_api)
-
-        api.write_entries([ENTRY])
-
-        entries, log_name, resource, labels, partial_success, options = (
-            gax_api._write_log_entries_called_with)
-        self.assertEqual(len(entries), 1)
-
-        entry = entries[0]
-        self.assertIsInstance(entry, LogEntry)
-        self.assertEqual(entry.log_name, LOG_PATH)
-        self.assertEqual(entry.resource.type, 'global')
-        self.assertEqual(entry.labels, {})
-        self.assertEqual(entry.text_payload, TEXT)
-
-        self.assertIsNone(log_name)
-        self.assertIsNone(resource)
-        self.assertIsNone(labels)
-        self.assertEqual(partial_success, False)
-        self.assertIsNone(options)
-
-    def test_write_entries_w_extra_properties(self):
-        # pylint: disable=too-many-statements
-        from datetime import datetime
-        from google.logging.type.log_severity_pb2 import WARNING
-        from google.logging.v2.log_entry_pb2 import LogEntry
-        from google.cloud._helpers import UTC, _pb_timestamp_to_datetime
-        NOW = datetime.utcnow().replace(tzinfo=UTC)
-        TEXT = 'TEXT'
-        LOG_PATH = 'projects/%s/logs/%s' % (self.PROJECT, self.LOG_NAME)
-        SEVERITY = 'WARNING'
-        LABELS = {
-            'foo': 'bar',
-        }
-        IID = 'IID'
-        REQUEST_METHOD = 'GET'
-        REQUEST_URL = 'http://example.com/requested'
-        STATUS = 200
-        REQUEST_SIZE = 256
-        RESPONSE_SIZE = 1024
-        REFERRER_URL = 'http://example.com/referer'
-        USER_AGENT = 'Agent/1.0'
-        REMOTE_IP = '1.2.3.4'
-        REQUEST = {
-            'requestMethod': REQUEST_METHOD,
-            'requestUrl': REQUEST_URL,
-            'status': STATUS,
-            'requestSize': REQUEST_SIZE,
-            'responseSize': RESPONSE_SIZE,
-            'referer': REFERRER_URL,
-            'userAgent': USER_AGENT,
-            'remoteIp': REMOTE_IP,
-            'cacheHit': False,
-        }
-        PRODUCER = 'PRODUCER'
-        OPID = 'OPID'
-        OPERATION = {
-            'producer': PRODUCER,
-            'id': OPID,
-            'first': False,
-            'last': True,
-        }
-        ENTRY = {
-            'logName': LOG_PATH,
-            'resource': {'type': 'global'},
-            'textPayload': TEXT,
-            'severity': SEVERITY,
-            'labels': LABELS,
-            'insertId': IID,
-            'timestamp': NOW,
-            'httpRequest': REQUEST,
-            'operation': OPERATION,
-        }
-        gax_api = _GAXLoggingAPI()
-        api = self._makeOne(gax_api)
-
-        api.write_entries([ENTRY])
-
-        entries, log_name, resource, labels, partial_success, options = (
-            gax_api._write_log_entries_called_with)
-        self.assertEqual(len(entries), 1)
-
-        entry = entries[0]
-        self.assertIsInstance(entry, LogEntry)
-        self.assertEqual(entry.log_name, LOG_PATH)
-        self.assertEqual(entry.resource.type, 'global')
-        self.assertEqual(entry.text_payload, TEXT)
-        self.assertEqual(entry.severity, WARNING)
-        self.assertEqual(entry.labels, LABELS)
-        self.assertEqual(entry.insert_id, IID)
-        stamp = _pb_timestamp_to_datetime(entry.timestamp)
-        self.assertEqual(stamp, NOW)
-
-        request = entry.http_request
-        self.assertEqual(request.request_method, REQUEST_METHOD)
-        self.assertEqual(request.request_url, REQUEST_URL)
-        self.assertEqual(request.status, STATUS)
-        self.assertEqual(request.request_size, REQUEST_SIZE)
-        self.assertEqual(request.response_size, RESPONSE_SIZE)
-        self.assertEqual(request.referer, REFERRER_URL)
-        self.assertEqual(request.user_agent, USER_AGENT)
-        self.assertEqual(request.remote_ip, REMOTE_IP)
-        self.assertEqual(request.cache_hit, False)
-
-        operation = entry.operation
-        self.assertEqual(operation.producer, PRODUCER)
-        self.assertEqual(operation.id, OPID)
-        self.assertFalse(operation.first)
-        self.assertTrue(operation.last)
-
-        self.assertIsNone(log_name)
-        self.assertIsNone(resource)
-        self.assertIsNone(labels)
-        self.assertEqual(partial_success, False)
-        self.assertIsNone(options)
-        # pylint: enable=too-many-statements
-
-    def test_write_entries_multiple(self):
-        # pylint: disable=too-many-statements
-        import datetime
-        from google.logging.type.log_severity_pb2 import WARNING
-        from google.logging.v2.log_entry_pb2 import LogEntry
-        from google.protobuf.any_pb2 import Any
-        from google.protobuf.struct_pb2 import Struct
-        from google.cloud._helpers import _datetime_to_rfc3339, UTC
-        TEXT = 'TEXT'
-        NOW = datetime.datetime.utcnow().replace(tzinfo=UTC)
-        TIMESTAMP_TYPE_URL = 'type.googleapis.com/google.protobuf.Timestamp'
-        JSON = {'payload': 'PAYLOAD', 'type': 'json'}
-        PROTO = {
-            '@type': TIMESTAMP_TYPE_URL,
-            'value': _datetime_to_rfc3339(NOW),
-        }
-        PRODUCER = 'PRODUCER'
-        OPID = 'OPID'
-        URL = 'http://example.com/'
-        ENTRIES = [
-            {'textPayload': TEXT,
-             'severity': WARNING},
-            {'jsonPayload': JSON,
-             'operation': {'producer': PRODUCER, 'id': OPID}},
-            {'protoPayload': PROTO,
-             'httpRequest': {'requestUrl': URL}},
-        ]
-        LOG_PATH = 'projects/%s/logs/%s' % (self.PROJECT, self.LOG_NAME)
-        RESOURCE = {
-            'type': 'global',
-        }
-        LABELS = {
-            'foo': 'bar',
-        }
-        gax_api = _GAXLoggingAPI()
-        api = self._makeOne(gax_api)
-
-        api.write_entries(ENTRIES, LOG_PATH, RESOURCE, LABELS)
-
-        entries, log_name, resource, labels, partial_success, options = (
-            gax_api._write_log_entries_called_with)
-        self.assertEqual(len(entries), len(ENTRIES))
-
-        entry = entries[0]
-        self.assertIsInstance(entry, LogEntry)
-        self.assertEqual(entry.log_name, '')
-        self.assertEqual(entry.resource.type, '')
-        self.assertEqual(entry.labels, {})
-        self.assertEqual(entry.text_payload, TEXT)
-        self.assertEqual(entry.severity, WARNING)
-
-        entry = entries[1]
-        self.assertIsInstance(entry, LogEntry)
-        self.assertEqual(entry.log_name, '')
-        self.assertEqual(entry.resource.type, '')
-        self.assertEqual(entry.labels, {})
-        json_struct = entry.json_payload
-        self.assertIsInstance(json_struct, Struct)
-        self.assertEqual(json_struct.fields['payload'].string_value,
-                         JSON['payload'])
-        operation = entry.operation
-        self.assertEqual(operation.producer, PRODUCER)
-        self.assertEqual(operation.id, OPID)
-
-        entry = entries[2]
-        self.assertIsInstance(entry, LogEntry)
-        self.assertEqual(entry.log_name, '')
-        self.assertEqual(entry.resource.type, '')
-        self.assertEqual(entry.labels, {})
-        proto = entry.proto_payload
-        self.assertIsInstance(proto, Any)
-        self.assertEqual(proto.type_url, TIMESTAMP_TYPE_URL)
-        request = entry.http_request
-        self.assertEqual(request.request_url, URL)
-
-        self.assertEqual(log_name, LOG_PATH)
-        self.assertEqual(resource, RESOURCE)
-        self.assertEqual(labels, LABELS)
-        self.assertEqual(partial_success, False)
-        self.assertIsNone(options)
-        # pylint: enable=too-many-statements
-
-    def test_logger_delete(self):
-        LOG_PATH = 'projects/%s/logs/%s' % (self.PROJECT, self.LOG_NAME)
-        gax_api = _GAXLoggingAPI()
-        api = self._makeOne(gax_api)
-
-        api.logger_delete(self.PROJECT, self.LOG_NAME)
-
-        log_name, options = gax_api._delete_log_called_with
-        self.assertEqual(log_name, LOG_PATH)
-        self.assertIsNone(options)
-
-    def test_logger_delete_not_found(self):
-        from google.cloud.exceptions import NotFound
-        LOG_PATH = 'projects/%s/logs/%s' % (self.PROJECT, self.LOG_NAME)
-        gax_api = _GAXLoggingAPI(_delete_not_found=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.logger_delete(self.PROJECT, self.LOG_NAME)
-
-        log_name, options = gax_api._delete_log_called_with
-        self.assertEqual(log_name, LOG_PATH)
-        self.assertIsNone(options)
-
-    def test_logger_delete_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        LOG_PATH = 'projects/%s/logs/%s' % (self.PROJECT, self.LOG_NAME)
-        gax_api = _GAXLoggingAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.logger_delete(self.PROJECT, self.LOG_NAME)
-
-        log_name, options = gax_api._delete_log_called_with
-        self.assertEqual(log_name, LOG_PATH)
-        self.assertIsNone(options)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_SinksAPI(_Base, unittest.TestCase):
-    SINK_NAME = 'sink_name'
-    SINK_PATH = 'projects/%s/sinks/%s' % (_Base.PROJECT, SINK_NAME)
-    DESTINATION_URI = 'faux.googleapis.com/destination'
-
-    def _getTargetClass(self):
-        from google.cloud.logging._gax import _SinksAPI
-        return _SinksAPI
-
-    def test_ctor(self):
-        gax_api = _GAXSinksAPI()
-        api = self._makeOne(gax_api)
-        self.assertIs(api._gax_api, gax_api)
-
-    def test_list_sinks_no_paging(self):
-        from google.gax import INITIAL_PAGE
-        from unit_tests._testing import _GAXPageIterator
-        TOKEN = 'TOKEN'
-        SINKS = [{
-            'name': self.SINK_PATH,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }]
-        response = _GAXPageIterator(
-            [_LogSinkPB(self.SINK_PATH, self.DESTINATION_URI, self.FILTER)],
-            TOKEN)
-        gax_api = _GAXSinksAPI(_list_sinks_response=response)
-        api = self._makeOne(gax_api)
-
-        sinks, token = api.list_sinks(self.PROJECT)
-
-        self.assertEqual(sinks, SINKS)
-        self.assertEqual(token, TOKEN)
-
-        project, page_size, options = gax_api._list_sinks_called_with
-        self.assertEqual(project, self.PROJECT_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertEqual(options.page_token, INITIAL_PAGE)
-
-    def test_list_sinks_w_paging(self):
-        from unit_tests._testing import _GAXPageIterator
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        SINKS = [{
-            'name': self.SINK_PATH,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }]
-        response = _GAXPageIterator(
-            [_LogSinkPB(self.SINK_PATH, self.DESTINATION_URI, self.FILTER)],
-            None)
-        gax_api = _GAXSinksAPI(_list_sinks_response=response)
-        api = self._makeOne(gax_api)
-
-        sinks, token = api.list_sinks(
-            self.PROJECT, page_size=PAGE_SIZE, page_token=TOKEN)
-
-        self.assertEqual(sinks, SINKS)
-        self.assertIsNone(token)
-
-        project, page_size, options = gax_api._list_sinks_called_with
-        self.assertEqual(project, self.PROJECT_PATH)
-        self.assertEqual(page_size, PAGE_SIZE)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_sink_create_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSinksAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.sink_create(
-                self.PROJECT, self.SINK_NAME, self.FILTER,
-                self.DESTINATION_URI)
-
-    def test_sink_create_conflict(self):
-        from google.cloud.exceptions import Conflict
-        gax_api = _GAXSinksAPI(_create_sink_conflict=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(Conflict):
-            api.sink_create(
-                self.PROJECT, self.SINK_NAME, self.FILTER,
-                self.DESTINATION_URI)
-
-    def test_sink_create_ok(self):
-        from google.logging.v2.logging_config_pb2 import LogSink
-        gax_api = _GAXSinksAPI()
-        api = self._makeOne(gax_api)
-
-        api.sink_create(
-            self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
-
-        parent, sink, options = (
-            gax_api._create_sink_called_with)
-        self.assertEqual(parent, self.PROJECT_PATH)
-        self.assertIsInstance(sink, LogSink)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertEqual(sink.filter, self.FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIsNone(options)
-
-    def test_sink_get_error(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSinksAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.sink_get(self.PROJECT, self.SINK_NAME)
-
-    def test_sink_get_miss(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSinksAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.sink_get(self.PROJECT, self.SINK_NAME)
-
-    def test_sink_get_hit(self):
-        RESPONSE = {
-            'name': self.SINK_PATH,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        sink_pb = _LogSinkPB(
-            self.SINK_PATH, self.DESTINATION_URI, self.FILTER)
-        gax_api = _GAXSinksAPI(_get_sink_response=sink_pb)
-        api = self._makeOne(gax_api)
-
-        response = api.sink_get(self.PROJECT, self.SINK_NAME)
-
-        self.assertEqual(response, RESPONSE)
-
-        sink_name, options = gax_api._get_sink_called_with
-        self.assertEqual(sink_name, self.SINK_PATH)
-        self.assertIsNone(options)
-
-    def test_sink_update_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSinksAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.sink_update(
-                self.PROJECT, self.SINK_NAME, self.FILTER,
-                self.DESTINATION_URI)
-
-    def test_sink_update_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSinksAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.sink_update(
-                self.PROJECT, self.SINK_NAME, self.FILTER,
-                self.DESTINATION_URI)
-
-    def test_sink_update_hit(self):
-        from google.logging.v2.logging_config_pb2 import LogSink
-        response = _LogSinkPB(
-            self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
-        gax_api = _GAXSinksAPI(_update_sink_response=response)
-        api = self._makeOne(gax_api)
-
-        api.sink_update(
-            self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
-
-        sink_name, sink, options = (
-            gax_api._update_sink_called_with)
-        self.assertEqual(sink_name, self.SINK_PATH)
-        self.assertIsInstance(sink, LogSink)
-        self.assertEqual(sink.name, self.SINK_PATH)
-        self.assertEqual(sink.filter, self.FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIsNone(options)
-
-    def test_sink_delete_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSinksAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.sink_delete(self.PROJECT, self.SINK_NAME)
-
-    def test_sink_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSinksAPI(_sink_not_found=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.sink_delete(self.PROJECT, self.SINK_NAME)
-
-    def test_sink_delete_hit(self):
-        gax_api = _GAXSinksAPI()
-        api = self._makeOne(gax_api)
-
-        api.sink_delete(self.PROJECT, self.SINK_NAME)
-
-        sink_name, options = gax_api._delete_sink_called_with
-        self.assertEqual(sink_name, self.SINK_PATH)
-        self.assertIsNone(options)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_MetricsAPI(_Base, unittest.TestCase):
-    METRIC_NAME = 'metric_name'
-    METRIC_PATH = 'projects/%s/metrics/%s' % (_Base.PROJECT, METRIC_NAME)
-    DESCRIPTION = 'Description'
-
-    def _getTargetClass(self):
-        from google.cloud.logging._gax import _MetricsAPI
-        return _MetricsAPI
-
-    def test_ctor(self):
-        gax_api = _GAXMetricsAPI()
-        api = self._makeOne(gax_api)
-        self.assertIs(api._gax_api, gax_api)
-
-    def test_list_metrics_no_paging(self):
-        from google.gax import INITIAL_PAGE
-        from unit_tests._testing import _GAXPageIterator
-        TOKEN = 'TOKEN'
-        METRICS = [{
-            'name': self.METRIC_PATH,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }]
-        response = _GAXPageIterator(
-            [_LogMetricPB(self.METRIC_PATH, self.DESCRIPTION, self.FILTER)],
-            TOKEN)
-        gax_api = _GAXMetricsAPI(_list_log_metrics_response=response)
-        api = self._makeOne(gax_api)
-
-        metrics, token = api.list_metrics(self.PROJECT)
-
-        self.assertEqual(metrics, METRICS)
-        self.assertEqual(token, TOKEN)
-
-        project, page_size, options = gax_api._list_log_metrics_called_with
-        self.assertEqual(project, self.PROJECT_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertEqual(options.page_token, INITIAL_PAGE)
-
-    def test_list_metrics_w_paging(self):
-        from unit_tests._testing import _GAXPageIterator
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        METRICS = [{
-            'name': self.METRIC_PATH,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }]
-        response = _GAXPageIterator(
-            [_LogMetricPB(self.METRIC_PATH, self.DESCRIPTION, self.FILTER)],
-            None)
-        gax_api = _GAXMetricsAPI(_list_log_metrics_response=response)
-        api = self._makeOne(gax_api)
-
-        metrics, token = api.list_metrics(
-            self.PROJECT, page_size=PAGE_SIZE, page_token=TOKEN)
-
-        self.assertEqual(metrics, METRICS)
-        self.assertIsNone(token)
-
-        project, page_size, options = gax_api._list_log_metrics_called_with
-        self.assertEqual(project, self.PROJECT_PATH)
-        self.assertEqual(page_size, PAGE_SIZE)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_metric_create_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXMetricsAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.metric_create(
-                self.PROJECT, self.METRIC_NAME, self.FILTER,
-                self.DESCRIPTION)
-
-    def test_metric_create_conflict(self):
-        from google.cloud.exceptions import Conflict
-        gax_api = _GAXMetricsAPI(_create_log_metric_conflict=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(Conflict):
-            api.metric_create(
-                self.PROJECT, self.METRIC_NAME, self.FILTER,
-                self.DESCRIPTION)
-
-    def test_metric_create_ok(self):
-        from google.logging.v2.logging_metrics_pb2 import LogMetric
-        gax_api = _GAXMetricsAPI()
-        api = self._makeOne(gax_api)
-
-        api.metric_create(
-            self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
-
-        parent, metric, options = (
-            gax_api._create_log_metric_called_with)
-        self.assertEqual(parent, self.PROJECT_PATH)
-        self.assertIsInstance(metric, LogMetric)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter, self.FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertIsNone(options)
-
-    def test_metric_get_error(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXMetricsAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.metric_get(self.PROJECT, self.METRIC_NAME)
-
-    def test_metric_get_miss(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXMetricsAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.metric_get(self.PROJECT, self.METRIC_NAME)
-
-    def test_metric_get_hit(self):
-        RESPONSE = {
-            'name': self.METRIC_PATH,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }
-        metric_pb = _LogMetricPB(
-            self.METRIC_PATH, self.DESCRIPTION, self.FILTER)
-        gax_api = _GAXMetricsAPI(_get_log_metric_response=metric_pb)
-        api = self._makeOne(gax_api)
-
-        response = api.metric_get(self.PROJECT, self.METRIC_NAME)
-
-        self.assertEqual(response, RESPONSE)
-
-        metric_name, options = gax_api._get_log_metric_called_with
-        self.assertEqual(metric_name, self.METRIC_PATH)
-        self.assertIsNone(options)
-
-    def test_metric_update_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXMetricsAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.metric_update(
-                self.PROJECT, self.METRIC_NAME, self.FILTER,
-                self.DESCRIPTION)
-
-    def test_metric_update_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXMetricsAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.metric_update(
-                self.PROJECT, self.METRIC_NAME, self.FILTER,
-                self.DESCRIPTION)
-
-    def test_metric_update_hit(self):
-        from google.logging.v2.logging_metrics_pb2 import LogMetric
-        response = _LogMetricPB(
-            self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
-        gax_api = _GAXMetricsAPI(_update_log_metric_response=response)
-        api = self._makeOne(gax_api)
-
-        api.metric_update(
-            self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
-
-        metric_name, metric, options = (
-            gax_api._update_log_metric_called_with)
-        self.assertEqual(metric_name, self.METRIC_PATH)
-        self.assertIsInstance(metric, LogMetric)
-        self.assertEqual(metric.name, self.METRIC_PATH)
-        self.assertEqual(metric.filter, self.FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertIsNone(options)
-
-    def test_metric_delete_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXMetricsAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.metric_delete(self.PROJECT, self.METRIC_NAME)
-
-    def test_metric_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXMetricsAPI(_log_metric_not_found=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.metric_delete(self.PROJECT, self.METRIC_NAME)
-
-    def test_metric_delete_hit(self):
-        gax_api = _GAXMetricsAPI()
-        api = self._makeOne(gax_api)
-
-        api.metric_delete(self.PROJECT, self.METRIC_NAME)
-
-        metric_name, options = gax_api._delete_log_metric_called_with
-        self.assertEqual(metric_name, self.METRIC_PATH)
-        self.assertIsNone(options)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_value_pb_to_value(_Base, unittest.TestCase):
-
-    def _callFUT(self, value_pb):
-        from google.cloud.logging._gax import _value_pb_to_value
-        return _value_pb_to_value(value_pb)
-
-    def test_w_null_values(self):
-        from google.protobuf.struct_pb2 import Value
-        value_pb = Value()
-        self.assertIsNone(self._callFUT(value_pb))
-        value_pb = Value(null_value=None)
-        self.assertIsNone(self._callFUT(value_pb))
-
-    def test_w_string_value(self):
-        from google.protobuf.struct_pb2 import Value
-        STRING = 'STRING'
-        value_pb = Value(string_value=STRING)
-        self.assertEqual(self._callFUT(value_pb), STRING)
-
-    def test_w_bool_values(self):
-        from google.protobuf.struct_pb2 import Value
-        true_value_pb = Value(bool_value=True)
-        self.assertIs(self._callFUT(true_value_pb), True)
-        false_value_pb = Value(bool_value=False)
-        self.assertIs(self._callFUT(false_value_pb), False)
-
-    def test_w_number_values(self):
-        from google.protobuf.struct_pb2 import Value
-        ANSWER = 42
-        PI = 3.1415926
-        int_value_pb = Value(number_value=ANSWER)
-        self.assertEqual(self._callFUT(int_value_pb), ANSWER)
-        float_value_pb = Value(number_value=PI)
-        self.assertEqual(self._callFUT(float_value_pb), PI)
-
-    def test_w_list_value(self):
-        from google.protobuf.struct_pb2 import Value
-        STRING = 'STRING'
-        PI = 3.1415926
-        value_pb = Value()
-        value_pb.list_value.values.add(string_value=STRING)
-        value_pb.list_value.values.add(bool_value=True)
-        value_pb.list_value.values.add(number_value=PI)
-        self.assertEqual(self._callFUT(value_pb), [STRING, True, PI])
-
-    def test_w_struct_value(self):
-        from google.protobuf.struct_pb2 import Value
-        STRING = 'STRING'
-        PI = 3.1415926
-        value_pb = Value()
-        value_pb.struct_value.fields['string'].string_value = STRING
-        value_pb.struct_value.fields['bool'].bool_value = True
-        value_pb.struct_value.fields['number'].number_value = PI
-        self.assertEqual(self._callFUT(value_pb),
-                         {'string': STRING, 'bool': True, 'number': PI})
-
-    def test_w_unknown_kind(self):
-
-        class _Value(object):
-
-            def WhichOneof(self, name):
-                assert name == 'kind'
-                return 'UNKNOWN'
-
-        with self.assertRaises(ValueError):
-            self._callFUT(_Value())
-
-
-class _GAXLoggingAPI(_GAXBaseAPI):
-
-    _delete_not_found = False
-
-    def list_log_entries(
-            self, projects, filter_, order_by, page_size, options):
-        self._list_log_entries_called_with = (
-            projects, filter_, order_by, page_size, options)
-        return self._list_log_entries_response
-
-    def write_log_entries(self, entries, log_name, resource, labels,
-                          partial_success, options):
-        self._write_log_entries_called_with = (
-            entries, log_name, resource, labels, partial_success, options)
-
-    def delete_log(self, log_name, options):
-        self._delete_log_called_with = log_name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._delete_not_found:
-            raise self._make_grpc_not_found()
-
-
-class _GAXSinksAPI(_GAXBaseAPI):
-
-    _create_sink_conflict = False
-    _sink_not_found = False
-
-    def list_sinks(self, parent, page_size, options):
-        self._list_sinks_called_with = parent, page_size, options
-        return self._list_sinks_response
-
-    def create_sink(self, parent, sink, options):
-        self._create_sink_called_with = parent, sink, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._create_sink_conflict:
-            raise self._make_grpc_failed_precondition()
-
-    def get_sink(self, sink_name, options):
-        self._get_sink_called_with = sink_name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._get_sink_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def update_sink(self, sink_name, sink, options=None):
-        self._update_sink_called_with = sink_name, sink, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._update_sink_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def delete_sink(self, sink_name, options=None):
-        self._delete_sink_called_with = sink_name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._sink_not_found:
-            raise self._make_grpc_not_found()
-
-
-class _GAXMetricsAPI(_GAXBaseAPI):
-
-    _create_log_metric_conflict = False
-    _log_metric_not_found = False
-
-    def list_log_metrics(self, parent, page_size, options):
-        self._list_log_metrics_called_with = parent, page_size, options
-        return self._list_log_metrics_response
-
-    def create_log_metric(self, parent, metric, options):
-        self._create_log_metric_called_with = parent, metric, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._create_log_metric_conflict:
-            raise self._make_grpc_failed_precondition()
-
-    def get_log_metric(self, metric_name, options):
-        self._get_log_metric_called_with = metric_name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._get_log_metric_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def update_log_metric(self, metric_name, metric, options=None):
-        self._update_log_metric_called_with = metric_name, metric, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._update_log_metric_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def delete_log_metric(self, metric_name, options=None):
-        self._delete_log_metric_called_with = metric_name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._log_metric_not_found:
-            raise self._make_grpc_not_found()
-
-
-class _HTTPRequestPB(object):
-
-    request_url = 'http://example.com/requested'
-    request_method = 'GET'
-    status = 200
-    referer = 'http://example.com/referer'
-    user_agent = 'AGENT'
-    cache_hit = False
-    request_size = 256
-    response_size = 1024
-    remote_ip = '1.2.3.4'
-
-
-class _LogEntryOperationPB(object):
-
-    producer = 'PRODUCER'
-    first = last = False
-    id = 'OPID'
-
-
-class _ResourcePB(object):
-
-    def __init__(self, type_='global', **labels):
-        self.type = type_
-        self.labels = labels
-
-
-class _StructPB(object):
-
-    def __init__(self, fields):
-        self.fields = fields
-
-
-class _LogEntryPB(object):
-
-    severity = 0
-    http_request = operation = insert_id = None
-    text_payload = json_payload = proto_payload = None
-
-    def __init__(self, log_name, **kw):
-        self.log_name = log_name
-        self.resource = _ResourcePB()
-        self.timestamp = self._make_timestamp()
-        self.labels = kw.pop('labels', {})
-        self.__dict__.update(kw)
-
-    def HasField(self, field_name):
-        return getattr(self, field_name, None) is not None
-
-    @staticmethod
-    def _make_timestamp():
-        from datetime import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _datetime_to_pb_timestamp
-        NOW = datetime.utcnow().replace(tzinfo=UTC)
-        return _datetime_to_pb_timestamp(NOW)
-
-
-class _LogSinkPB(object):
-
-    def __init__(self, name, destination, filter_):
-        self.name = name
-        self.destination = destination
-        self.filter = filter_
-
-
-class _LogMetricPB(object):
-
-    def __init__(self, name, description, filter_):
-        self.name = name
-        self.description = description
-        self.filter = filter_
diff --git a/unit_tests/logging/test_client.py b/unit_tests/logging/test_client.py
deleted file mode 100644
index a0e4b81e0db4..000000000000
--- a/unit_tests/logging/test_client.py
+++ /dev/null
@@ -1,496 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-    LOGGER_NAME = 'LOGGER_NAME'
-    SINK_NAME = 'SINK_NAME'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-    DESTINATION_URI = 'faux.googleapis.com/destination'
-    METRIC_NAME = 'metric_name'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-    DESCRIPTION = 'DESCRIPTION'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        self.assertEqual(client.project, self.PROJECT)
-
-    def test_logging_api_wo_gax(self):
-        from google.cloud.logging.connection import _LoggingAPI
-        from google.cloud.logging import client as MUT
-        from unit_tests._testing import _Monkey
-        client = self._makeOne(self.PROJECT, credentials=_Credentials())
-        conn = client.connection = object()
-
-        with _Monkey(MUT, _USE_GAX=False):
-            api = client.logging_api
-
-        self.assertIsInstance(api, _LoggingAPI)
-        self.assertIs(api._connection, conn)
-        # API instance is cached
-        again = client.logging_api
-        self.assertIs(again, api)
-
-    def test_logging_api_w_gax(self):
-        from google.cloud.logging import client as MUT
-        from unit_tests._testing import _Monkey
-
-        wrapped = object()
-        _called_with = []
-
-        def _generated_api(*args, **kw):
-            _called_with.append((args, kw))
-            return wrapped
-
-        class _GaxLoggingAPI(object):
-
-            def __init__(self, _wrapped):
-                self._wrapped = _wrapped
-
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-
-        with _Monkey(MUT,
-                     _USE_GAX=True,
-                     GeneratedLoggingAPI=_generated_api,
-                     GAXLoggingAPI=_GaxLoggingAPI):
-            api = client.logging_api
-
-        self.assertIsInstance(api, _GaxLoggingAPI)
-        self.assertIs(api._wrapped, wrapped)
-        # API instance is cached
-        again = client.logging_api
-        self.assertIs(again, api)
-
-    def test_sinks_api_wo_gax(self):
-        from google.cloud.logging.connection import _SinksAPI
-        from google.cloud.logging import client as MUT
-        from unit_tests._testing import _Monkey
-        client = self._makeOne(self.PROJECT, credentials=_Credentials())
-        conn = client.connection = object()
-
-        with _Monkey(MUT, _USE_GAX=False):
-            api = client.sinks_api
-
-        self.assertIsInstance(api, _SinksAPI)
-        self.assertIs(api._connection, conn)
-        # API instance is cached
-        again = client.sinks_api
-        self.assertIs(again, api)
-
-    def test_sinks_api_w_gax(self):
-        from google.cloud.logging import client as MUT
-        from unit_tests._testing import _Monkey
-
-        wrapped = object()
-        _called_with = []
-
-        def _generated_api(*args, **kw):
-            _called_with.append((args, kw))
-            return wrapped
-
-        class _GaxSinksAPI(object):
-
-            def __init__(self, _wrapped):
-                self._wrapped = _wrapped
-
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-
-        with _Monkey(MUT,
-                     _USE_GAX=True,
-                     GeneratedSinksAPI=_generated_api,
-                     GAXSinksAPI=_GaxSinksAPI):
-            api = client.sinks_api
-
-        self.assertIsInstance(api, _GaxSinksAPI)
-        self.assertIs(api._wrapped, wrapped)
-        # API instance is cached
-        again = client.sinks_api
-        self.assertIs(again, api)
-
-    def test_metrics_api_wo_gax(self):
-        from google.cloud.logging.connection import _MetricsAPI
-        from google.cloud.logging import client as MUT
-        from unit_tests._testing import _Monkey
-        client = self._makeOne(self.PROJECT, credentials=_Credentials())
-        conn = client.connection = object()
-
-        with _Monkey(MUT, _USE_GAX=False):
-            api = client.metrics_api
-
-        self.assertIsInstance(api, _MetricsAPI)
-        self.assertIs(api._connection, conn)
-        # API instance is cached
-        again = client.metrics_api
-        self.assertIs(again, api)
-
-    def test_metrics_api_w_gax(self):
-        from google.cloud.logging import client as MUT
-        from unit_tests._testing import _Monkey
-
-        wrapped = object()
-        _called_with = []
-
-        def _generated_api(*args, **kw):
-            _called_with.append((args, kw))
-            return wrapped
-
-        class _GaxMetricsAPI(object):
-
-            def __init__(self, _wrapped):
-                self._wrapped = _wrapped
-
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-
-        with _Monkey(MUT,
-                     _USE_GAX=True,
-                     GeneratedMetricsAPI=_generated_api,
-                     GAXMetricsAPI=_GaxMetricsAPI):
-            api = client.metrics_api
-
-        self.assertIsInstance(api, _GaxMetricsAPI)
-        self.assertIs(api._wrapped, wrapped)
-        # API instance is cached
-        again = client.metrics_api
-        self.assertIs(again, api)
-
-    def test_logger(self):
-        from google.cloud.logging.logger import Logger
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        logger = client.logger(self.LOGGER_NAME)
-        self.assertIsInstance(logger, Logger)
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.project, self.PROJECT)
-
-    def test__entry_from_resource_unknown_type(self):
-        PROJECT = 'PROJECT'
-        creds = _Credentials()
-        client = self._makeOne(PROJECT, creds)
-        loggers = {}
-        with self.assertRaises(ValueError):
-            client._entry_from_resource({'unknownPayload': {}}, loggers)
-
-    def test_list_entries_defaults(self):
-        from google.cloud.logging.entries import TextEntry
-        IID = 'IID'
-        TEXT = 'TEXT'
-        TOKEN = 'TOKEN'
-        ENTRIES = [{
-            'textPayload': TEXT,
-            'insertId': IID,
-            'resource': {
-                'type': 'global',
-            },
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-        }]
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        api = client._logging_api = _DummyLoggingAPI()
-        api._list_entries_response = ENTRIES, TOKEN
-
-        entries, token = client.list_entries()
-
-        self.assertEqual(len(entries), 1)
-        entry = entries[0]
-        self.assertIsInstance(entry, TextEntry)
-        self.assertEqual(entry.insert_id, IID)
-        self.assertEqual(entry.payload, TEXT)
-        logger = entry.logger
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.project, self.PROJECT)
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(
-            api._list_entries_called_with,
-            ([self.PROJECT], None, None, None, None))
-
-    def test_list_entries_explicit(self):
-        from google.cloud.logging import DESCENDING
-        from google.cloud.logging.entries import ProtobufEntry
-        from google.cloud.logging.entries import StructEntry
-        from google.cloud.logging.logger import Logger
-
-        PROJECT1 = 'PROJECT1'
-        PROJECT2 = 'PROJECT2'
-        FILTER = 'logName:LOGNAME'
-        IID1 = 'IID1'
-        IID2 = 'IID2'
-        PAYLOAD = {'message': 'MESSAGE', 'weather': 'partly cloudy'}
-        PROTO_PAYLOAD = PAYLOAD.copy()
-        PROTO_PAYLOAD['@type'] = 'type.googleapis.com/testing.example'
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        ENTRIES = [{
-            'jsonPayload': PAYLOAD,
-            'insertId': IID1,
-            'resource': {
-                'type': 'global',
-            },
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-        }, {
-            'protoPayload': PROTO_PAYLOAD,
-            'insertId': IID2,
-            'resource': {
-                'type': 'global',
-            },
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-        }]
-        client = self._makeOne(self.PROJECT, credentials=_Credentials())
-        api = client._logging_api = _DummyLoggingAPI()
-        api._list_entries_response = ENTRIES, None
-
-        entries, token = client.list_entries(
-            projects=[PROJECT1, PROJECT2], filter_=FILTER, order_by=DESCENDING,
-            page_size=PAGE_SIZE, page_token=TOKEN)
-        self.assertEqual(len(entries), 2)
-
-        entry = entries[0]
-        self.assertIsInstance(entry, StructEntry)
-        self.assertEqual(entry.insert_id, IID1)
-        self.assertEqual(entry.payload, PAYLOAD)
-        logger = entry.logger
-        self.assertIsInstance(logger, Logger)
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.project, self.PROJECT)
-
-        entry = entries[1]
-        self.assertIsInstance(entry, ProtobufEntry)
-        self.assertEqual(entry.insert_id, IID2)
-        self.assertEqual(entry.payload, PROTO_PAYLOAD)
-        logger = entry.logger
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.project, self.PROJECT)
-
-        self.assertIs(entries[0].logger, entries[1].logger)
-
-        self.assertIsNone(token)
-        self.assertEqual(
-            api._list_entries_called_with,
-            ([PROJECT1, PROJECT2], FILTER, DESCENDING, PAGE_SIZE, TOKEN))
-
-    def test_sink_defaults(self):
-        from google.cloud.logging.sink import Sink
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        sink = client.sink(self.SINK_NAME)
-        self.assertIsInstance(sink, Sink)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertIsNone(sink.filter_)
-        self.assertIsNone(sink.destination)
-        self.assertIs(sink.client, client)
-        self.assertEqual(sink.project, self.PROJECT)
-
-    def test_sink_explicit(self):
-        from google.cloud.logging.sink import Sink
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        sink = client.sink(self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
-        self.assertIsInstance(sink, Sink)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertEqual(sink.filter_, self.FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIs(sink.client, client)
-        self.assertEqual(sink.project, self.PROJECT)
-
-    def test_list_sinks_no_paging(self):
-        from google.cloud.logging.sink import Sink
-        PROJECT = 'PROJECT'
-        TOKEN = 'TOKEN'
-        SINK_NAME = 'sink_name'
-        FILTER = 'logName:syslog AND severity>=ERROR'
-        SINKS = [{
-            'name': SINK_NAME,
-            'filter': FILTER,
-            'destination': self.DESTINATION_URI,
-        }]
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        api = client._sinks_api = _DummySinksAPI()
-        api._list_sinks_response = SINKS, TOKEN
-
-        sinks, token = client.list_sinks()
-
-        self.assertEqual(len(sinks), 1)
-        sink = sinks[0]
-        self.assertIsInstance(sink, Sink)
-        self.assertEqual(sink.name, SINK_NAME)
-        self.assertEqual(sink.filter_, FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-
-        self.assertEqual(token, TOKEN)
-        self.assertEqual(api._list_sinks_called_with,
-                         (PROJECT, None, None))
-
-    def test_list_sinks_with_paging(self):
-        from google.cloud.logging.sink import Sink
-        PROJECT = 'PROJECT'
-        SINK_NAME = 'sink_name'
-        FILTER = 'logName:syslog AND severity>=ERROR'
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        SINKS = [{
-            'name': SINK_NAME,
-            'filter': FILTER,
-            'destination': self.DESTINATION_URI,
-        }]
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        api = client._sinks_api = _DummySinksAPI()
-        api._list_sinks_response = SINKS, None
-
-        sinks, token = client.list_sinks(PAGE_SIZE, TOKEN)
-
-        self.assertEqual(len(sinks), 1)
-        sink = sinks[0]
-        self.assertIsInstance(sink, Sink)
-        self.assertEqual(sink.name, SINK_NAME)
-        self.assertEqual(sink.filter_, FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIsNone(token)
-        self.assertEqual(api._list_sinks_called_with,
-                         (PROJECT, PAGE_SIZE, TOKEN))
-
-    def test_metric_defaults(self):
-        from google.cloud.logging.metric import Metric
-        creds = _Credentials()
-
-        client_obj = self._makeOne(project=self.PROJECT, credentials=creds)
-        metric = client_obj.metric(self.METRIC_NAME)
-        self.assertIsInstance(metric, Metric)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertIsNone(metric.filter_)
-        self.assertEqual(metric.description, '')
-        self.assertIs(metric.client, client_obj)
-        self.assertEqual(metric.project, self.PROJECT)
-
-    def test_metric_explicit(self):
-        from google.cloud.logging.metric import Metric
-        creds = _Credentials()
-
-        client_obj = self._makeOne(project=self.PROJECT, credentials=creds)
-        metric = client_obj.metric(self.METRIC_NAME, self.FILTER,
-                                   description=self.DESCRIPTION)
-        self.assertIsInstance(metric, Metric)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter_, self.FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertIs(metric.client, client_obj)
-        self.assertEqual(metric.project, self.PROJECT)
-
-    def test_list_metrics_no_paging(self):
-        from google.cloud.logging.metric import Metric
-        PROJECT = 'PROJECT'
-        TOKEN = 'TOKEN'
-        METRICS = [{
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }]
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        api = client._metrics_api = _DummyMetricsAPI()
-        api._list_metrics_response = METRICS, TOKEN
-
-        metrics, token = client.list_metrics()
-
-        self.assertEqual(len(metrics), 1)
-        metric = metrics[0]
-        self.assertIsInstance(metric, Metric)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter_, self.FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertEqual(token, TOKEN)
-        self.assertEqual(api._list_metrics_called_with,
-                         (PROJECT, None, None))
-
-    def test_list_metrics_with_paging(self):
-        from google.cloud.logging.metric import Metric
-        PROJECT = 'PROJECT'
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        METRICS = [{
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }]
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        api = client._metrics_api = _DummyMetricsAPI()
-        api._list_metrics_response = METRICS, None
-
-        # Execute request.
-        metrics, token = client.list_metrics(PAGE_SIZE, TOKEN)
-        # Test values are correct.
-        self.assertEqual(len(metrics), 1)
-        metric = metrics[0]
-        self.assertIsInstance(metric, Metric)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter_, self.FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertIsNone(token)
-        self.assertEqual(api._list_metrics_called_with,
-                         (PROJECT, PAGE_SIZE, TOKEN))
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _DummyLoggingAPI(object):
-
-    def list_entries(self, projects, filter_, order_by, page_size, page_token):
-        self._list_entries_called_with = (
-            projects, filter_, order_by, page_size, page_token)
-        return self._list_entries_response
-
-
-class _DummySinksAPI(object):
-
-    def list_sinks(self, project, page_size, page_token):
-        self._list_sinks_called_with = (project, page_size, page_token)
-        return self._list_sinks_response
-
-
-class _DummyMetricsAPI(object):
-
-    def list_metrics(self, project, page_size, page_token):
-        self._list_metrics_called_with = (project, page_size, page_token)
-        return self._list_metrics_response
diff --git a/unit_tests/logging/test_connection.py b/unit_tests/logging/test_connection.py
deleted file mode 100644
index f70df802de5d..000000000000
--- a/unit_tests/logging/test_connection.py
+++ /dev/null
@@ -1,640 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    PROJECT = 'project'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_default_url(self):
-        creds = _Credentials()
-        conn = self._makeOne(creds)
-        klass = self._getTargetClass()
-        self.assertEqual(conn.credentials._scopes, klass.SCOPE)
-
-
-class Test_LoggingAPI(unittest.TestCase):
-
-    PROJECT = 'project'
-    LIST_ENTRIES_PATH = 'entries:list'
-    WRITE_ENTRIES_PATH = 'entries:write'
-    LOGGER_NAME = 'LOGGER_NAME'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.connection import _LoggingAPI
-        return _LoggingAPI
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = object()
-        api = self._makeOne(connection)
-        self.assertIs(api._connection, connection)
-
-    @staticmethod
-    def _make_timestamp():
-        from datetime import datetime
-        from google.cloud._helpers import UTC
-
-        NOW = datetime.utcnow().replace(tzinfo=UTC)
-        return _datetime_to_rfc3339_w_nanos(NOW)
-
-    def test_list_entries_no_paging(self):
-        TIMESTAMP = self._make_timestamp()
-        IID = 'IID'
-        TEXT = 'TEXT'
-        SENT = {
-            'projectIds': [self.PROJECT],
-        }
-        TOKEN = 'TOKEN'
-        RETURNED = {
-            'entries': [{
-                'textPayload': TEXT,
-                'insertId': IID,
-                'resource': {
-                    'type': 'global',
-                },
-                'timestamp': TIMESTAMP,
-                'logName': 'projects/%s/logs/%s' % (
-                    self.PROJECT, self.LOGGER_NAME),
-            }],
-            'nextPageToken': TOKEN,
-        }
-        conn = _Connection(RETURNED)
-        api = self._makeOne(conn)
-
-        entries, token = api.list_entries([self.PROJECT])
-
-        self.assertEqual(entries, RETURNED['entries'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/%s' % self.LIST_ENTRIES_PATH
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_list_entries_w_paging(self):
-        from google.cloud.logging import DESCENDING
-
-        PROJECT1 = 'PROJECT1'
-        PROJECT2 = 'PROJECT2'
-        TIMESTAMP = self._make_timestamp()
-        IID1 = 'IID1'
-        IID2 = 'IID2'
-        PAYLOAD = {'message': 'MESSAGE', 'weather': 'partly cloudy'}
-        PROTO_PAYLOAD = PAYLOAD.copy()
-        PROTO_PAYLOAD['@type'] = 'type.googleapis.com/testing.example'
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        SENT = {
-            'projectIds': [PROJECT1, PROJECT2],
-            'filter': self.FILTER,
-            'orderBy': DESCENDING,
-            'pageSize': PAGE_SIZE,
-            'pageToken': TOKEN,
-        }
-        RETURNED = {
-            'entries': [{
-                'jsonPayload': PAYLOAD,
-                'insertId': IID1,
-                'resource': {
-                    'type': 'global',
-                },
-                'timestamp': TIMESTAMP,
-                'logName': 'projects/%s/logs/%s' % (
-                    self.PROJECT, self.LOGGER_NAME),
-            }, {
-                'protoPayload': PROTO_PAYLOAD,
-                'insertId': IID2,
-                'resource': {
-                    'type': 'global',
-                },
-                'timestamp': TIMESTAMP,
-                'logName': 'projects/%s/logs/%s' % (
-                    self.PROJECT, self.LOGGER_NAME),
-            }],
-        }
-        conn = _Connection(RETURNED)
-        api = self._makeOne(conn)
-
-        entries, token = api.list_entries(
-            projects=[PROJECT1, PROJECT2], filter_=self.FILTER,
-            order_by=DESCENDING, page_size=PAGE_SIZE, page_token=TOKEN)
-
-        self.assertEqual(entries, RETURNED['entries'])
-        self.assertIsNone(token)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/%s' % self.LIST_ENTRIES_PATH
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_write_entries_single(self):
-        TEXT = 'TEXT'
-        ENTRY = {
-            'textPayload': TEXT,
-            'resource': {
-                'type': 'global',
-            },
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-        }
-        SENT = {
-            'entries': [ENTRY],
-        }
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.write_entries([ENTRY])
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/%s' % self.WRITE_ENTRIES_PATH
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_write_entries_multiple(self):
-        TEXT = 'TEXT'
-        LOG_NAME = 'projects/%s/logs/%s' % (self.PROJECT, self.LOGGER_NAME)
-        RESOURCE = {
-            'type': 'global',
-        }
-        LABELS = {
-            'baz': 'qux',
-            'spam': 'eggs',
-        }
-        ENTRY1 = {
-            'textPayload': TEXT,
-        }
-        ENTRY2 = {
-            'jsonPayload': {'foo': 'bar'},
-        }
-        SENT = {
-            'logName': LOG_NAME,
-            'resource': RESOURCE,
-            'labels': LABELS,
-            'entries': [ENTRY1, ENTRY2],
-        }
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.write_entries([ENTRY1, ENTRY2], LOG_NAME, RESOURCE, LABELS)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/%s' % self.WRITE_ENTRIES_PATH
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_logger_delete(self):
-        path = '/projects/%s/logs/%s' % (self.PROJECT, self.LOGGER_NAME)
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.logger_delete(self.PROJECT, self.LOGGER_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'DELETE')
-        self.assertEqual(conn._called_with['path'], path)
-
-
-class Test_SinksAPI(unittest.TestCase):
-
-    PROJECT = 'project'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-    LIST_SINKS_PATH = 'projects/%s/sinks' % (PROJECT,)
-    SINK_NAME = 'sink_name'
-    SINK_PATH = 'projects/%s/sinks/%s' % (PROJECT, SINK_NAME)
-    DESTINATION_URI = 'faux.googleapis.com/destination'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.connection import _SinksAPI
-        return _SinksAPI
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = object()
-        api = self._makeOne(connection)
-        self.assertIs(api._connection, connection)
-
-    def test_list_sinks_no_paging(self):
-        TOKEN = 'TOKEN'
-        RETURNED = {
-            'sinks': [{
-                'name': self.SINK_PATH,
-                'filter': self.FILTER,
-                'destination': self.DESTINATION_URI,
-            }],
-            'nextPageToken': TOKEN,
-        }
-        conn = _Connection(RETURNED)
-        api = self._makeOne(conn)
-
-        sinks, token = api.list_sinks(self.PROJECT)
-
-        self.assertEqual(sinks, RETURNED['sinks'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_SINKS_PATH,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['query_params'], {})
-
-    def test_list_sinks_w_paging(self):
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        RETURNED = {
-            'sinks': [{
-                'name': self.SINK_PATH,
-                'filter': self.FILTER,
-                'destination': self.DESTINATION_URI,
-            }],
-        }
-        conn = _Connection(RETURNED)
-        api = self._makeOne(conn)
-
-        sinks, token = api.list_sinks(
-            self.PROJECT, page_size=PAGE_SIZE, page_token=TOKEN)
-
-        self.assertEqual(sinks, RETURNED['sinks'])
-        self.assertIsNone(token)
-
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_SINKS_PATH,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['query_params'],
-                         {'pageSize': PAGE_SIZE, 'pageToken': TOKEN})
-
-    def test_sink_create_conflict(self):
-        from google.cloud.exceptions import Conflict
-        SENT = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        conn = _Connection()
-        conn._raise_conflict = True
-        api = self._makeOne(conn)
-
-        with self.assertRaises(Conflict):
-            api.sink_create(
-                self.PROJECT, self.SINK_NAME, self.FILTER,
-                self.DESTINATION_URI)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/projects/%s/sinks' % (self.PROJECT,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_sink_create_ok(self):
-        SENT = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.sink_create(
-            self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/projects/%s/sinks' % (self.PROJECT,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_sink_get_miss(self):
-        from google.cloud.exceptions import NotFound
-        conn = _Connection()
-        api = self._makeOne(conn)
-
-        with self.assertRaises(NotFound):
-            api.sink_get(self.PROJECT, self.SINK_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_sink_get_hit(self):
-        RESPONSE = {
-            'name': self.SINK_PATH,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        conn = _Connection(RESPONSE)
-        api = self._makeOne(conn)
-
-        response = api.sink_get(self.PROJECT, self.SINK_NAME)
-
-        self.assertEqual(response, RESPONSE)
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_sink_update_miss(self):
-        from google.cloud.exceptions import NotFound
-        SENT = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        conn = _Connection()
-        api = self._makeOne(conn)
-
-        with self.assertRaises(NotFound):
-            api.sink_update(
-                self.PROJECT, self.SINK_NAME, self.FILTER,
-                self.DESTINATION_URI)
-
-        self.assertEqual(conn._called_with['method'], 'PUT')
-        path = '/projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_sink_update_hit(self):
-        SENT = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.sink_update(
-            self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI)
-
-        self.assertEqual(conn._called_with['method'], 'PUT')
-        path = '/projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_sink_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        conn = _Connection()
-        api = self._makeOne(conn)
-
-        with self.assertRaises(NotFound):
-            api.sink_delete(self.PROJECT, self.SINK_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'DELETE')
-        path = '/projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_sink_delete_hit(self):
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.sink_delete(self.PROJECT, self.SINK_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'DELETE')
-        path = '/projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-
-class Test_MetricsAPI(unittest.TestCase):
-
-    PROJECT = 'project'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-    LIST_METRICS_PATH = 'projects/%s/metrics' % (PROJECT,)
-    METRIC_NAME = 'metric_name'
-    METRIC_PATH = 'projects/%s/metrics/%s' % (PROJECT, METRIC_NAME)
-    DESCRIPTION = 'DESCRIPTION'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.connection import _MetricsAPI
-        return _MetricsAPI
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_list_metrics_no_paging(self):
-        TOKEN = 'TOKEN'
-        RETURNED = {
-            'metrics': [{
-                'name': self.METRIC_PATH,
-                'filter': self.FILTER,
-            }],
-            'nextPageToken': TOKEN,
-        }
-        conn = _Connection(RETURNED)
-        api = self._makeOne(conn)
-
-        metrics, token = api.list_metrics(self.PROJECT)
-
-        self.assertEqual(metrics, RETURNED['metrics'])
-        self.assertEqual(token, TOKEN)
-
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_METRICS_PATH,)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_list_metrics_w_paging(self):
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        RETURNED = {
-            'metrics': [{
-                'name': self.METRIC_PATH,
-                'filter': self.FILTER,
-            }],
-        }
-        conn = _Connection(RETURNED)
-        api = self._makeOne(conn)
-
-        metrics, token = api.list_metrics(
-            self.PROJECT, page_size=PAGE_SIZE, page_token=TOKEN)
-
-        self.assertEqual(metrics, RETURNED['metrics'])
-        self.assertIsNone(token)
-
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_METRICS_PATH,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['query_params'],
-                         {'pageSize': PAGE_SIZE, 'pageToken': TOKEN})
-
-    def test_metric_create_conflict(self):
-        from google.cloud.exceptions import Conflict
-        SENT = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }
-        conn = _Connection()
-        conn._raise_conflict = True
-        api = self._makeOne(conn)
-
-        with self.assertRaises(Conflict):
-            api.metric_create(
-                self.PROJECT, self.METRIC_NAME, self.FILTER,
-                self.DESCRIPTION)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/projects/%s/metrics' % (self.PROJECT,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_metric_create_ok(self):
-        SENT = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.metric_create(
-            self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
-
-        self.assertEqual(conn._called_with['method'], 'POST')
-        path = '/projects/%s/metrics' % (self.PROJECT,)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_metric_get_miss(self):
-        from google.cloud.exceptions import NotFound
-        conn = _Connection()
-        api = self._makeOne(conn)
-
-        with self.assertRaises(NotFound):
-            api.metric_get(self.PROJECT, self.METRIC_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_metric_get_hit(self):
-        RESPONSE = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }
-        conn = _Connection(RESPONSE)
-        api = self._makeOne(conn)
-
-        response = api.metric_get(self.PROJECT, self.METRIC_NAME)
-
-        self.assertEqual(response, RESPONSE)
-        self.assertEqual(conn._called_with['method'], 'GET')
-        path = '/projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_metric_update_miss(self):
-        from google.cloud.exceptions import NotFound
-        SENT = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }
-        conn = _Connection()
-        api = self._makeOne(conn)
-
-        with self.assertRaises(NotFound):
-            api.metric_update(
-                self.PROJECT, self.METRIC_NAME, self.FILTER,
-                self.DESCRIPTION)
-
-        self.assertEqual(conn._called_with['method'], 'PUT')
-        path = '/projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_metric_update_hit(self):
-        SENT = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': self.DESCRIPTION,
-        }
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.metric_update(
-            self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION)
-
-        self.assertEqual(conn._called_with['method'], 'PUT')
-        path = '/projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-        self.assertEqual(conn._called_with['data'], SENT)
-
-    def test_metric_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        conn = _Connection()
-        api = self._makeOne(conn)
-
-        with self.assertRaises(NotFound):
-            api.metric_delete(self.PROJECT, self.METRIC_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'DELETE')
-        path = '/projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-    def test_metric_delete_hit(self):
-        conn = _Connection({})
-        api = self._makeOne(conn)
-
-        api.metric_delete(self.PROJECT, self.METRIC_NAME)
-
-        self.assertEqual(conn._called_with['method'], 'DELETE')
-        path = '/projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        self.assertEqual(conn._called_with['path'], path)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    _called_with = None
-    _raise_conflict = False
-
-    def __init__(self, *responses):
-        self._responses = responses
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import Conflict
-        from google.cloud.exceptions import NotFound
-        self._called_with = kw
-        if self._raise_conflict:
-            raise Conflict('oops')
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except IndexError:
-            raise NotFound('miss')
-        return response
-
-
-def _datetime_to_rfc3339_w_nanos(value):
-    from google.cloud._helpers import _RFC3339_NO_FRACTION
-    no_fraction = value.strftime(_RFC3339_NO_FRACTION)
-    return '%s.%09dZ' % (no_fraction, value.microsecond * 1000)
diff --git a/unit_tests/logging/test_entries.py b/unit_tests/logging/test_entries.py
deleted file mode 100644
index 1cbd22c83769..000000000000
--- a/unit_tests/logging/test_entries.py
+++ /dev/null
@@ -1,235 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class Test_logger_name_from_path(unittest.TestCase):
-
-    def _callFUT(self, path):
-        from google.cloud.logging.entries import logger_name_from_path
-        return logger_name_from_path(path)
-
-    def test_w_simple_name(self):
-        LOGGER_NAME = 'LOGGER_NAME'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/logs/%s' % (PROJECT, LOGGER_NAME)
-        logger_name = self._callFUT(PATH)
-        self.assertEqual(logger_name, LOGGER_NAME)
-
-    def test_w_name_w_all_extras(self):
-        LOGGER_NAME = 'LOGGER_NAME-part.one~part.two%part-three'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/logs/%s' % (PROJECT, LOGGER_NAME)
-        logger_name = self._callFUT(PATH)
-        self.assertEqual(logger_name, LOGGER_NAME)
-
-
-class Test_BaseEntry(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-    LOGGER_NAME = 'LOGGER_NAME'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.entries import _BaseEntry
-
-        class _Dummy(_BaseEntry):
-            _PAYLOAD_KEY = 'dummyPayload'
-
-        return _Dummy
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        PAYLOAD = 'PAYLOAD'
-        logger = _Logger(self.LOGGER_NAME, self.PROJECT)
-        entry = self._makeOne(PAYLOAD, logger)
-        self.assertEqual(entry.payload, PAYLOAD)
-        self.assertIs(entry.logger, logger)
-        self.assertIsNone(entry.insert_id)
-        self.assertIsNone(entry.timestamp)
-        self.assertIsNone(entry.labels)
-        self.assertIsNone(entry.severity)
-        self.assertIsNone(entry.http_request)
-
-    def test_ctor_explicit(self):
-        import datetime
-        PAYLOAD = 'PAYLOAD'
-        IID = 'IID'
-        TIMESTAMP = datetime.datetime.now()
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        logger = _Logger(self.LOGGER_NAME, self.PROJECT)
-        entry = self._makeOne(PAYLOAD, logger,
-                              insert_id=IID,
-                              timestamp=TIMESTAMP,
-                              labels=LABELS,
-                              severity=SEVERITY,
-                              http_request=REQUEST)
-        self.assertEqual(entry.payload, PAYLOAD)
-        self.assertIs(entry.logger, logger)
-        self.assertEqual(entry.insert_id, IID)
-        self.assertEqual(entry.timestamp, TIMESTAMP)
-        self.assertEqual(entry.labels, LABELS)
-        self.assertEqual(entry.severity, SEVERITY)
-        self.assertEqual(entry.http_request['requestMethod'], METHOD)
-        self.assertEqual(entry.http_request['requestUrl'], URI)
-        self.assertEqual(entry.http_request['status'], STATUS)
-
-    def test_from_api_repr_missing_data_no_loggers(self):
-        client = _Client(self.PROJECT)
-        PAYLOAD = 'PAYLOAD'
-        LOG_NAME = 'projects/%s/logs/%s' % (self.PROJECT, self.LOGGER_NAME)
-        API_REPR = {
-            'dummyPayload': PAYLOAD,
-            'logName': LOG_NAME,
-        }
-        klass = self._getTargetClass()
-        entry = klass.from_api_repr(API_REPR, client)
-        self.assertEqual(entry.payload, PAYLOAD)
-        self.assertIsNone(entry.insert_id)
-        self.assertIsNone(entry.timestamp)
-        self.assertIsNone(entry.severity)
-        self.assertIsNone(entry.http_request)
-        logger = entry.logger
-        self.assertIsInstance(logger, _Logger)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-
-    def test_from_api_repr_w_loggers_no_logger_match(self):
-        from datetime import datetime
-        from google.cloud._helpers import UTC
-        klass = self._getTargetClass()
-        client = _Client(self.PROJECT)
-        PAYLOAD = 'PAYLOAD'
-        SEVERITY = 'CRITICAL'
-        IID = 'IID'
-        NOW = datetime.utcnow().replace(tzinfo=UTC)
-        TIMESTAMP = _datetime_to_rfc3339_w_nanos(NOW)
-        LOG_NAME = 'projects/%s/logs/%s' % (self.PROJECT, self.LOGGER_NAME)
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        API_REPR = {
-            'dummyPayload': PAYLOAD,
-            'logName': LOG_NAME,
-            'insertId': IID,
-            'timestamp': TIMESTAMP,
-            'labels': LABELS,
-            'severity': SEVERITY,
-            'httpRequest': {
-                'requestMethod': METHOD,
-                'requestUrl': URI,
-                'status': STATUS,
-            },
-        }
-        loggers = {}
-        entry = klass.from_api_repr(API_REPR, client, loggers=loggers)
-        self.assertEqual(entry.payload, PAYLOAD)
-        self.assertEqual(entry.insert_id, IID)
-        self.assertEqual(entry.timestamp, NOW)
-        self.assertEqual(entry.labels, LABELS)
-        self.assertEqual(entry.severity, SEVERITY)
-        self.assertEqual(entry.http_request['requestMethod'], METHOD)
-        self.assertEqual(entry.http_request['requestUrl'], URI)
-        self.assertEqual(entry.http_request['status'], STATUS)
-        logger = entry.logger
-        self.assertIsInstance(logger, _Logger)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertEqual(loggers, {LOG_NAME: logger})
-
-    def test_from_api_repr_w_loggers_w_logger_match(self):
-        from datetime import datetime
-        from google.cloud._helpers import UTC
-        client = _Client(self.PROJECT)
-        PAYLOAD = 'PAYLOAD'
-        IID = 'IID'
-        NOW = datetime.utcnow().replace(tzinfo=UTC)
-        TIMESTAMP = _datetime_to_rfc3339_w_nanos(NOW)
-        LOG_NAME = 'projects/%s/logs/%s' % (self.PROJECT, self.LOGGER_NAME)
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        API_REPR = {
-            'dummyPayload': PAYLOAD,
-            'logName': LOG_NAME,
-            'insertId': IID,
-            'timestamp': TIMESTAMP,
-            'labels': LABELS,
-        }
-        LOGGER = object()
-        loggers = {LOG_NAME: LOGGER}
-        klass = self._getTargetClass()
-        entry = klass.from_api_repr(API_REPR, client, loggers=loggers)
-        self.assertEqual(entry.payload, PAYLOAD)
-        self.assertEqual(entry.insert_id, IID)
-        self.assertEqual(entry.timestamp, NOW)
-        self.assertEqual(entry.labels, LABELS)
-        self.assertIs(entry.logger, LOGGER)
-
-
-class TestProtobufEntry(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-    LOGGER_NAME = 'LOGGER_NAME'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.entries import ProtobufEntry
-        return ProtobufEntry
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_parse_message(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        LOGGER = object()
-        message = Struct(fields={'foo': Value(bool_value=False)})
-        with_true = Struct(fields={'foo': Value(bool_value=True)})
-        PAYLOAD = json.loads(MessageToJson(with_true))
-        entry = self._makeOne(PAYLOAD, LOGGER)
-        entry.parse_message(message)
-        self.assertTrue(message.fields['foo'])
-
-
-def _datetime_to_rfc3339_w_nanos(value):
-    from google.cloud._helpers import _RFC3339_NO_FRACTION
-    no_fraction = value.strftime(_RFC3339_NO_FRACTION)
-    return '%s.%09dZ' % (no_fraction, value.microsecond * 1000)
-
-
-class _Logger(object):
-
-    def __init__(self, name, client):
-        self.name = name
-        self.client = client
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-
-    def logger(self, name):
-        return _Logger(name, self)
diff --git a/unit_tests/logging/test_logger.py b/unit_tests/logging/test_logger.py
deleted file mode 100644
index ff9a894890de..000000000000
--- a/unit_tests/logging/test_logger.py
+++ /dev/null
@@ -1,705 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestLogger(unittest.TestCase):
-
-    PROJECT = 'test-project'
-    LOGGER_NAME = 'logger-name'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.logger import Logger
-        return Logger
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        conn = object()
-        client = _Client(self.PROJECT, conn)
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.project, self.PROJECT)
-        self.assertEqual(logger.full_name, 'projects/%s/logs/%s'
-                         % (self.PROJECT, self.LOGGER_NAME))
-        self.assertEqual(logger.path, '/projects/%s/logs/%s'
-                         % (self.PROJECT, self.LOGGER_NAME))
-        self.assertIsNone(logger.labels)
-
-    def test_ctor_explicit(self):
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        conn = object()
-        client = _Client(self.PROJECT, conn)
-        logger = self._makeOne(self.LOGGER_NAME, client=client, labels=LABELS)
-        self.assertEqual(logger.name, self.LOGGER_NAME)
-        self.assertIs(logger.client, client)
-        self.assertEqual(logger.project, self.PROJECT)
-        self.assertEqual(logger.full_name, 'projects/%s/logs/%s'
-                         % (self.PROJECT, self.LOGGER_NAME))
-        self.assertEqual(logger.path, '/projects/%s/logs/%s'
-                         % (self.PROJECT, self.LOGGER_NAME))
-        self.assertEqual(logger.labels, LABELS)
-
-    def test_batch_w_bound_client(self):
-        from google.cloud.logging.logger import Batch
-        conn = object()
-        client = _Client(self.PROJECT, conn)
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-        batch = logger.batch()
-        self.assertIsInstance(batch, Batch)
-        self.assertIs(batch.logger, logger)
-        self.assertIs(batch.client, client)
-
-    def test_batch_w_alternate_client(self):
-        from google.cloud.logging.logger import Batch
-        conn1 = object()
-        conn2 = object()
-        client1 = _Client(self.PROJECT, conn1)
-        client2 = _Client(self.PROJECT, conn2)
-        logger = self._makeOne(self.LOGGER_NAME, client=client1)
-        batch = logger.batch(client2)
-        self.assertIsInstance(batch, Batch)
-        self.assertIs(batch.logger, logger)
-        self.assertIs(batch.client, client2)
-
-    def test_log_text_w_str_implicit_client(self):
-        TEXT = 'TEXT'
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'textPayload': TEXT,
-            'resource': {
-                'type': 'global',
-            },
-        }]
-        client = _Client(self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-
-        logger.log_text(TEXT)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_text_w_default_labels(self):
-        TEXT = 'TEXT'
-        DEFAULT_LABELS = {'foo': 'spam'}
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'textPayload': TEXT,
-            'resource': {
-                'type': 'global',
-            },
-            'labels': DEFAULT_LABELS,
-        }]
-        client = _Client(self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client,
-                               labels=DEFAULT_LABELS)
-
-        logger.log_text(TEXT)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_text_w_unicode_explicit_client_labels_severity_httpreq(self):
-        TEXT = u'TEXT'
-        DEFAULT_LABELS = {'foo': 'spam'}
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'textPayload': TEXT,
-            'resource': {
-                'type': 'global',
-            },
-            'labels': LABELS,
-            'insertId': IID,
-            'severity': SEVERITY,
-            'httpRequest': REQUEST,
-        }]
-        client1 = _Client(self.PROJECT)
-        client2 = _Client(self.PROJECT)
-        api = client2.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client1,
-                               labels=DEFAULT_LABELS)
-
-        logger.log_text(TEXT, client=client2, labels=LABELS,
-                        insert_id=IID, severity=SEVERITY, http_request=REQUEST)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_struct_w_implicit_client(self):
-        STRUCT = {'message': 'MESSAGE', 'weather': 'cloudy'}
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'jsonPayload': STRUCT,
-            'resource': {
-                'type': 'global',
-            },
-        }]
-        client = _Client(self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-
-        logger.log_struct(STRUCT)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_struct_w_default_labels(self):
-        STRUCT = {'message': 'MESSAGE', 'weather': 'cloudy'}
-        DEFAULT_LABELS = {'foo': 'spam'}
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'jsonPayload': STRUCT,
-            'resource': {
-                'type': 'global',
-            },
-            'labels': DEFAULT_LABELS,
-        }]
-        client = _Client(self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client,
-                               labels=DEFAULT_LABELS)
-
-        logger.log_struct(STRUCT)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_struct_w_explicit_client_labels_severity_httpreq(self):
-        STRUCT = {'message': 'MESSAGE', 'weather': 'cloudy'}
-        DEFAULT_LABELS = {'foo': 'spam'}
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'jsonPayload': STRUCT,
-            'resource': {
-                'type': 'global',
-            },
-            'labels': LABELS,
-            'insertId': IID,
-            'severity': SEVERITY,
-            'httpRequest': REQUEST,
-        }]
-        client1 = _Client(self.PROJECT)
-        client2 = _Client(self.PROJECT)
-        api = client2.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client1,
-                               labels=DEFAULT_LABELS)
-
-        logger.log_struct(STRUCT, client=client2, labels=LABELS,
-                          insert_id=IID, severity=SEVERITY,
-                          http_request=REQUEST)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_proto_w_implicit_client(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'protoPayload': json.loads(MessageToJson(message)),
-            'resource': {
-                'type': 'global',
-            },
-        }]
-        client = _Client(self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-
-        logger.log_proto(message)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_proto_w_default_labels(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        DEFAULT_LABELS = {'foo': 'spam'}
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'protoPayload': json.loads(MessageToJson(message)),
-            'resource': {
-                'type': 'global',
-            },
-            'labels': DEFAULT_LABELS,
-        }]
-        client = _Client(self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client,
-                               labels=DEFAULT_LABELS)
-
-        logger.log_proto(message)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_log_proto_w_explicit_client_labels_severity_httpreq(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        DEFAULT_LABELS = {'foo': 'spam'}
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        ENTRIES = [{
-            'logName': 'projects/%s/logs/%s' % (
-                self.PROJECT, self.LOGGER_NAME),
-            'protoPayload': json.loads(MessageToJson(message)),
-            'resource': {
-                'type': 'global',
-            },
-            'labels': LABELS,
-            'insertId': IID,
-            'severity': SEVERITY,
-            'httpRequest': REQUEST,
-        }]
-        client1 = _Client(self.PROJECT)
-        client2 = _Client(self.PROJECT)
-        api = client2.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client1,
-                               labels=DEFAULT_LABELS)
-
-        logger.log_proto(message, client=client2, labels=LABELS,
-                         insert_id=IID, severity=SEVERITY,
-                         http_request=REQUEST)
-
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, None, None, None))
-
-    def test_delete_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-
-        logger.delete()
-
-        self.assertEqual(api._logger_delete_called_with,
-                         (self.PROJECT, self.LOGGER_NAME))
-
-    def test_delete_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.logging_api = _DummyLoggingAPI()
-        logger = self._makeOne(self.LOGGER_NAME, client=client1)
-
-        logger.delete(client=client2)
-
-        self.assertEqual(api._logger_delete_called_with,
-                         (self.PROJECT, self.LOGGER_NAME))
-
-    def test_list_entries_defaults(self):
-        LISTED = {
-            'projects': None,
-            'filter_': 'logName=projects/%s/logs/%s' %
-                       (self.PROJECT, self.LOGGER_NAME),
-            'order_by': None,
-            'page_size': None,
-            'page_token': None,
-        }
-        TOKEN = 'TOKEN'
-        client = _Client(self.PROJECT)
-        client._token = TOKEN
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-        entries, token = logger.list_entries()
-        self.assertEqual(len(entries), 0)
-        self.assertEqual(token, TOKEN)
-        self.assertEqual(client._listed, LISTED)
-
-    def test_list_entries_explicit(self):
-        from google.cloud.logging import DESCENDING
-
-        PROJECT1 = 'PROJECT1'
-        PROJECT2 = 'PROJECT2'
-        FILTER = 'resource.type:global'
-        TOKEN = 'TOKEN'
-        PAGE_SIZE = 42
-        LISTED = {
-            'projects': ['PROJECT1', 'PROJECT2'],
-            'filter_': '%s AND logName=projects/%s/logs/%s' %
-                       (FILTER, self.PROJECT, self.LOGGER_NAME),
-            'order_by': DESCENDING,
-            'page_size': PAGE_SIZE,
-            'page_token': TOKEN,
-        }
-        client = _Client(self.PROJECT)
-        logger = self._makeOne(self.LOGGER_NAME, client=client)
-        entries, token = logger.list_entries(
-            projects=[PROJECT1, PROJECT2], filter_=FILTER, order_by=DESCENDING,
-            page_size=PAGE_SIZE, page_token=TOKEN)
-        self.assertEqual(len(entries), 0)
-        self.assertIsNone(token)
-        self.assertEqual(client._listed, LISTED)
-
-
-class TestBatch(unittest.TestCase):
-
-    PROJECT = 'test-project'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.logger import Batch
-        return Batch
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_ctor_defaults(self):
-        logger = _Logger()
-        client = _Client(project=self.PROJECT)
-        batch = self._makeOne(logger, client)
-        self.assertIs(batch.logger, logger)
-        self.assertIs(batch.client, client)
-        self.assertEqual(len(batch.entries), 0)
-
-    def test_log_text_defaults(self):
-        TEXT = 'This is the entry text'
-        client = _Client(project=self.PROJECT, connection=object())
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-        batch.log_text(TEXT)
-        self.assertEqual(batch.entries,
-                         [('text', TEXT, None, None, None, None)])
-
-    def test_log_text_explicit(self):
-        TEXT = 'This is the entry text'
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        client = _Client(project=self.PROJECT, connection=object())
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-        batch.log_text(TEXT, labels=LABELS, insert_id=IID, severity=SEVERITY,
-                       http_request=REQUEST)
-        self.assertEqual(batch.entries,
-                         [('text', TEXT, LABELS, IID, SEVERITY, REQUEST)])
-
-    def test_log_struct_defaults(self):
-        STRUCT = {'message': 'Message text', 'weather': 'partly cloudy'}
-        client = _Client(project=self.PROJECT, connection=object())
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-        batch.log_struct(STRUCT)
-        self.assertEqual(batch.entries,
-                         [('struct', STRUCT, None, None, None, None)])
-
-    def test_log_struct_explicit(self):
-        STRUCT = {'message': 'Message text', 'weather': 'partly cloudy'}
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        client = _Client(project=self.PROJECT, connection=object())
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-        batch.log_struct(STRUCT, labels=LABELS, insert_id=IID,
-                         severity=SEVERITY, http_request=REQUEST)
-        self.assertEqual(batch.entries,
-                         [('struct', STRUCT, LABELS, IID, SEVERITY, REQUEST)])
-
-    def test_log_proto_defaults(self):
-        from google.protobuf.struct_pb2 import Struct, Value
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        client = _Client(project=self.PROJECT, connection=object())
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-        batch.log_proto(message)
-        self.assertEqual(batch.entries,
-                         [('proto', message, None, None, None, None)])
-
-    def test_log_proto_explicit(self):
-        from google.protobuf.struct_pb2 import Struct, Value
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        client = _Client(project=self.PROJECT, connection=object())
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-        batch.log_proto(message, labels=LABELS, insert_id=IID,
-                        severity=SEVERITY, http_request=REQUEST)
-        self.assertEqual(batch.entries,
-                         [('proto', message, LABELS, IID, SEVERITY, REQUEST)])
-
-    def test_commit_w_invalid_entry_type(self):
-        logger = _Logger()
-        client = _Client(project=self.PROJECT, connection=object())
-        batch = self._makeOne(logger, client)
-        batch.entries.append(('bogus', 'BOGUS', None, None, None, None))
-        with self.assertRaises(ValueError):
-            batch.commit()
-
-    def test_commit_w_bound_client(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        TEXT = 'This is the entry text'
-        STRUCT = {'message': TEXT, 'weather': 'partly cloudy'}
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        IID1 = 'IID1'
-        IID2 = 'IID2'
-        IID3 = 'IID3'
-        RESOURCE = {
-            'type': 'global',
-        }
-        ENTRIES = [
-            {'textPayload': TEXT, 'insertId': IID1},
-            {'jsonPayload': STRUCT, 'insertId': IID2},
-            {'protoPayload': json.loads(MessageToJson(message)),
-             'insertId': IID3},
-        ]
-        client = _Client(project=self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = _Logger()
-        batch = self._makeOne(logger, client=client)
-
-        batch.log_text(TEXT, insert_id=IID1)
-        batch.log_struct(STRUCT, insert_id=IID2)
-        batch.log_proto(message, insert_id=IID3)
-        batch.commit()
-
-        self.assertEqual(list(batch.entries), [])
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, logger.full_name, RESOURCE, None))
-
-    def test_commit_w_alternate_client(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        from google.cloud.logging.logger import Logger
-        TEXT = 'This is the entry text'
-        STRUCT = {'message': TEXT, 'weather': 'partly cloudy'}
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        DEFAULT_LABELS = {'foo': 'spam'}
-        LABELS = {
-            'foo': 'bar',
-            'baz': 'qux',
-        }
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.logging_api = _DummyLoggingAPI()
-        logger = Logger('logger_name', client1, labels=DEFAULT_LABELS)
-        RESOURCE = {'type': 'global'}
-        ENTRIES = [
-            {'textPayload': TEXT, 'labels': LABELS},
-            {'jsonPayload': STRUCT, 'severity': SEVERITY},
-            {'protoPayload': json.loads(MessageToJson(message)),
-             'httpRequest': REQUEST},
-        ]
-        batch = self._makeOne(logger, client=client1)
-
-        batch.log_text(TEXT, labels=LABELS)
-        batch.log_struct(STRUCT, severity=SEVERITY)
-        batch.log_proto(message, http_request=REQUEST)
-        batch.commit(client=client2)
-
-        self.assertEqual(list(batch.entries), [])
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, logger.full_name, RESOURCE, DEFAULT_LABELS))
-
-    def test_context_mgr_success(self):
-        import json
-        from google.protobuf.json_format import MessageToJson
-        from google.protobuf.struct_pb2 import Struct, Value
-        from google.cloud.logging.logger import Logger
-        TEXT = 'This is the entry text'
-        STRUCT = {'message': TEXT, 'weather': 'partly cloudy'}
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        DEFAULT_LABELS = {'foo': 'spam'}
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        client = _Client(project=self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = Logger('logger_name', client, labels=DEFAULT_LABELS)
-        RESOURCE = {
-            'type': 'global',
-        }
-        ENTRIES = [
-            {'textPayload': TEXT, 'httpRequest': REQUEST},
-            {'jsonPayload': STRUCT, 'labels': LABELS},
-            {'protoPayload': json.loads(MessageToJson(message)),
-             'severity': SEVERITY},
-        ]
-        batch = self._makeOne(logger, client=client)
-
-        with batch as other:
-            other.log_text(TEXT, http_request=REQUEST)
-            other.log_struct(STRUCT, labels=LABELS)
-            other.log_proto(message, severity=SEVERITY)
-
-        self.assertEqual(list(batch.entries), [])
-        self.assertEqual(api._write_entries_called_with,
-                         (ENTRIES, logger.full_name, RESOURCE, DEFAULT_LABELS))
-
-    def test_context_mgr_failure(self):
-        from google.protobuf.struct_pb2 import Struct, Value
-        TEXT = 'This is the entry text'
-        STRUCT = {'message': TEXT, 'weather': 'partly cloudy'}
-        LABELS = {'foo': 'bar', 'baz': 'qux'}
-        IID = 'IID'
-        SEVERITY = 'CRITICAL'
-        METHOD = 'POST'
-        URI = 'https://api.example.com/endpoint'
-        STATUS = '500'
-        REQUEST = {
-            'requestMethod': METHOD,
-            'requestUrl': URI,
-            'status': STATUS,
-        }
-        message = Struct(fields={'foo': Value(bool_value=True)})
-        client = _Client(project=self.PROJECT)
-        api = client.logging_api = _DummyLoggingAPI()
-        logger = _Logger()
-        UNSENT = [
-            ('text', TEXT, None, IID, None, None),
-            ('struct', STRUCT, None, None, SEVERITY, None),
-            ('proto', message, LABELS, None, None, REQUEST),
-        ]
-        batch = self._makeOne(logger, client=client)
-
-        try:
-            with batch as other:
-                other.log_text(TEXT, insert_id=IID)
-                other.log_struct(STRUCT, severity=SEVERITY)
-                other.log_proto(message, labels=LABELS, http_request=REQUEST)
-                raise _Bugout()
-        except _Bugout:
-            pass
-
-        self.assertEqual(list(batch.entries), UNSENT)
-        self.assertIsNone(api._write_entries_called_with)
-
-
-class _Logger(object):
-
-    labels = None
-
-    def __init__(self, name='NAME', project='PROJECT'):
-        self.full_name = 'projects/%s/logs/%s' % (project, name)
-
-
-class _DummyLoggingAPI(object):
-
-    _write_entries_called_with = None
-
-    def write_entries(self, entries, logger_name=None, resource=None,
-                      labels=None):
-        self._write_entries_called_with = (
-            entries, logger_name, resource, labels)
-
-    def logger_delete(self, project, logger_name):
-        self._logger_delete_called_with = (project, logger_name)
-
-
-class _Client(object):
-
-    _listed = _token = None
-    _entries = ()
-
-    def __init__(self, project, connection=None):
-        self.project = project
-        self.connection = connection
-
-    def list_entries(self, **kw):
-        self._listed = kw
-        return self._entries, self._token
-
-
-class _Bugout(Exception):
-    pass
diff --git a/unit_tests/logging/test_metric.py b/unit_tests/logging/test_metric.py
deleted file mode 100644
index 7eb3b615034f..000000000000
--- a/unit_tests/logging/test_metric.py
+++ /dev/null
@@ -1,251 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestMetric(unittest.TestCase):
-
-    PROJECT = 'test-project'
-    METRIC_NAME = 'metric-name'
-    FILTER = 'logName:syslog AND severity>=ERROR'
-    DESCRIPTION = 'DESCRIPTION'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.metric import Metric
-        return Metric
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        FULL = 'projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        client = _Client(self.PROJECT)
-        metric = self._makeOne(self.METRIC_NAME, client=client)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertIsNone(metric.filter_)
-        self.assertEqual(metric.description, '')
-        self.assertIs(metric.client, client)
-        self.assertEqual(metric.project, self.PROJECT)
-        self.assertEqual(metric.full_name, FULL)
-        self.assertEqual(metric.path, '/%s' % (FULL,))
-
-    def test_ctor_explicit(self):
-        FULL = 'projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        client = _Client(self.PROJECT)
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER,
-                               client=client, description=self.DESCRIPTION)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter_, self.FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertIs(metric.client, client)
-        self.assertEqual(metric.project, self.PROJECT)
-        self.assertEqual(metric.full_name, FULL)
-        self.assertEqual(metric.path, '/%s' % (FULL,))
-
-    def test_from_api_repr_minimal(self):
-        client = _Client(project=self.PROJECT)
-        FULL = 'projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        RESOURCE = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-        }
-        klass = self._getTargetClass()
-        metric = klass.from_api_repr(RESOURCE, client=client)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter_, self.FILTER)
-        self.assertEqual(metric.description, '')
-        self.assertIs(metric._client, client)
-        self.assertEqual(metric.project, self.PROJECT)
-        self.assertEqual(metric.full_name, FULL)
-
-    def test_from_api_repr_w_description(self):
-        client = _Client(project=self.PROJECT)
-        FULL = 'projects/%s/metrics/%s' % (self.PROJECT, self.METRIC_NAME)
-        DESCRIPTION = 'DESCRIPTION'
-        RESOURCE = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-            'description': DESCRIPTION,
-        }
-        klass = self._getTargetClass()
-        metric = klass.from_api_repr(RESOURCE, client=client)
-        self.assertEqual(metric.name, self.METRIC_NAME)
-        self.assertEqual(metric.filter_, self.FILTER)
-        self.assertEqual(metric.description, DESCRIPTION)
-        self.assertIs(metric._client, client)
-        self.assertEqual(metric.project, self.PROJECT)
-        self.assertEqual(metric.full_name, FULL)
-
-    def test_create_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client)
-
-        metric.create()
-
-        self.assertEqual(
-            api._metric_create_called_with,
-            (self.PROJECT, self.METRIC_NAME, self.FILTER, ''))
-
-    def test_create_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client1,
-                               description=self.DESCRIPTION)
-
-        metric.create(client=client2)
-
-        self.assertEqual(
-            api._metric_create_called_with,
-            (self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION))
-
-    def test_exists_miss_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client)
-
-        self.assertFalse(metric.exists())
-
-        self.assertEqual(api._metric_get_called_with,
-                         (self.PROJECT, self.METRIC_NAME))
-
-    def test_exists_hit_w_alternate_client(self):
-        RESOURCE = {
-            'name': self.METRIC_NAME,
-            'filter': self.FILTER,
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.metrics_api = _DummyMetricsAPI()
-        api._metric_get_response = RESOURCE
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client1)
-
-        self.assertTrue(metric.exists(client=client2))
-
-        self.assertEqual(api._metric_get_called_with,
-                         (self.PROJECT, self.METRIC_NAME))
-
-    def test_reload_w_bound_client(self):
-        NEW_FILTER = 'logName:syslog AND severity>=INFO'
-        RESOURCE = {
-            'name': self.METRIC_NAME,
-            'filter': NEW_FILTER,
-        }
-        client = _Client(project=self.PROJECT)
-        api = client.metrics_api = _DummyMetricsAPI()
-        api._metric_get_response = RESOURCE
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client,
-                               description=self.DESCRIPTION)
-
-        metric.reload()
-
-        self.assertEqual(metric.filter_, NEW_FILTER)
-        self.assertEqual(metric.description, '')
-        self.assertEqual(api._metric_get_called_with,
-                         (self.PROJECT, self.METRIC_NAME))
-
-    def test_reload_w_alternate_client(self):
-        NEW_FILTER = 'logName:syslog AND severity>=INFO'
-        RESOURCE = {
-            'name': self.METRIC_NAME,
-            'description': self.DESCRIPTION,
-            'filter': NEW_FILTER,
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.metrics_api = _DummyMetricsAPI()
-        api._metric_get_response = RESOURCE
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client1)
-
-        metric.reload(client=client2)
-
-        self.assertEqual(metric.filter_, NEW_FILTER)
-        self.assertEqual(metric.description, self.DESCRIPTION)
-        self.assertEqual(api._metric_get_called_with,
-                         (self.PROJECT, self.METRIC_NAME))
-
-    def test_update_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client)
-
-        metric.update()
-
-        self.assertEqual(
-            api._metric_update_called_with,
-            (self.PROJECT, self.METRIC_NAME, self.FILTER, ''))
-
-    def test_update_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client1,
-                               description=self.DESCRIPTION)
-
-        metric.update(client=client2)
-
-        self.assertEqual(
-            api._metric_update_called_with,
-            (self.PROJECT, self.METRIC_NAME, self.FILTER, self.DESCRIPTION))
-
-    def test_delete_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client)
-
-        metric.delete()
-
-        self.assertEqual(api._metric_delete_called_with,
-                         (self.PROJECT, self.METRIC_NAME))
-
-    def test_delete_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.metrics_api = _DummyMetricsAPI()
-        metric = self._makeOne(self.METRIC_NAME, self.FILTER, client=client1)
-
-        metric.delete(client=client2)
-
-        self.assertEqual(api._metric_delete_called_with,
-                         (self.PROJECT, self.METRIC_NAME))
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-
-
-class _DummyMetricsAPI(object):
-
-    def metric_create(self, project, metric_name, filter_, description):
-        self._metric_create_called_with = (
-            project, metric_name, filter_, description)
-
-    def metric_get(self, project, metric_name):
-        from google.cloud.exceptions import NotFound
-        self._metric_get_called_with = (project, metric_name)
-        try:
-            return self._metric_get_response
-        except AttributeError:
-            raise NotFound('miss')
-
-    def metric_update(self, project, metric_name, filter_, description):
-        self._metric_update_called_with = (
-            project, metric_name, filter_, description)
-
-    def metric_delete(self, project, metric_name):
-        self._metric_delete_called_with = (project, metric_name)
diff --git a/unit_tests/logging/test_sink.py b/unit_tests/logging/test_sink.py
deleted file mode 100644
index 89459854fee5..000000000000
--- a/unit_tests/logging/test_sink.py
+++ /dev/null
@@ -1,262 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestSink(unittest.TestCase):
-
-    PROJECT = 'test-project'
-    SINK_NAME = 'sink-name'
-    FILTER = 'logName:syslog AND severity>=INFO'
-    DESTINATION_URI = 'faux.googleapis.com/destination'
-
-    def _getTargetClass(self):
-        from google.cloud.logging.sink import Sink
-        return Sink
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        FULL = 'projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        client = _Client(self.PROJECT)
-        sink = self._makeOne(self.SINK_NAME, client=client)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertIsNone(sink.filter_)
-        self.assertIsNone(sink.destination)
-        self.assertIs(sink.client, client)
-        self.assertEqual(sink.project, self.PROJECT)
-        self.assertEqual(sink.full_name, FULL)
-        self.assertEqual(sink.path, '/%s' % (FULL,))
-
-    def test_ctor_explicit(self):
-        FULL = 'projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        client = _Client(self.PROJECT)
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertEqual(sink.filter_, self.FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIs(sink.client, client)
-        self.assertEqual(sink.project, self.PROJECT)
-        self.assertEqual(sink.full_name, FULL)
-        self.assertEqual(sink.path, '/%s' % (FULL,))
-
-    def test_from_api_repr_minimal(self):
-        client = _Client(project=self.PROJECT)
-        FULL = 'projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        RESOURCE = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        klass = self._getTargetClass()
-        sink = klass.from_api_repr(RESOURCE, client=client)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertEqual(sink.filter_, self.FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIs(sink._client, client)
-        self.assertEqual(sink.project, self.PROJECT)
-        self.assertEqual(sink.full_name, FULL)
-
-    def test_from_api_repr_w_description(self):
-        client = _Client(project=self.PROJECT)
-        FULL = 'projects/%s/sinks/%s' % (self.PROJECT, self.SINK_NAME)
-        RESOURCE = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        klass = self._getTargetClass()
-        sink = klass.from_api_repr(RESOURCE, client=client)
-        self.assertEqual(sink.name, self.SINK_NAME)
-        self.assertEqual(sink.filter_, self.FILTER)
-        self.assertEqual(sink.destination, self.DESTINATION_URI)
-        self.assertIs(sink._client, client)
-        self.assertEqual(sink.project, self.PROJECT)
-        self.assertEqual(sink.full_name, FULL)
-
-    def test_create_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.sinks_api = _DummySinksAPI()
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client)
-
-        sink.create()
-
-        self.assertEqual(
-            api._sink_create_called_with,
-            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI))
-
-    def test_create_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client1)
-        api = client2.sinks_api = _DummySinksAPI()
-
-        sink.create(client=client2)
-
-        self.assertEqual(
-            api._sink_create_called_with,
-            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI))
-
-    def test_exists_miss_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.sinks_api = _DummySinksAPI()
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client)
-
-        self.assertFalse(sink.exists())
-
-        self.assertEqual(api._sink_get_called_with,
-                         (self.PROJECT, self.SINK_NAME))
-
-    def test_exists_hit_w_alternate_client(self):
-        RESOURCE = {
-            'name': self.SINK_NAME,
-            'filter': self.FILTER,
-            'destination': self.DESTINATION_URI,
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.sinks_api = _DummySinksAPI()
-        api._sink_get_response = RESOURCE
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client1)
-
-        self.assertTrue(sink.exists(client=client2))
-
-        self.assertEqual(api._sink_get_called_with,
-                         (self.PROJECT, self.SINK_NAME))
-
-    def test_reload_w_bound_client(self):
-        NEW_FILTER = 'logName:syslog AND severity>=INFO'
-        NEW_DESTINATION_URI = 'faux.googleapis.com/other'
-        RESOURCE = {
-            'name': self.SINK_NAME,
-            'filter': NEW_FILTER,
-            'destination': NEW_DESTINATION_URI,
-        }
-        client = _Client(project=self.PROJECT)
-        api = client.sinks_api = _DummySinksAPI()
-        api._sink_get_response = RESOURCE
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client)
-
-        sink.reload()
-
-        self.assertEqual(sink.filter_, NEW_FILTER)
-        self.assertEqual(sink.destination, NEW_DESTINATION_URI)
-        self.assertEqual(api._sink_get_called_with,
-                         (self.PROJECT, self.SINK_NAME))
-
-    def test_reload_w_alternate_client(self):
-        NEW_FILTER = 'logName:syslog AND severity>=INFO'
-        NEW_DESTINATION_URI = 'faux.googleapis.com/other'
-        RESOURCE = {
-            'name': self.SINK_NAME,
-            'filter': NEW_FILTER,
-            'destination': NEW_DESTINATION_URI,
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.sinks_api = _DummySinksAPI()
-        api._sink_get_response = RESOURCE
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client1)
-
-        sink.reload(client=client2)
-
-        self.assertEqual(sink.filter_, NEW_FILTER)
-        self.assertEqual(sink.destination, NEW_DESTINATION_URI)
-        self.assertEqual(api._sink_get_called_with,
-                         (self.PROJECT, self.SINK_NAME))
-
-    def test_update_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.sinks_api = _DummySinksAPI()
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client)
-
-        sink.update()
-
-        self.assertEqual(
-            api._sink_update_called_with,
-            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI))
-
-    def test_update_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.sinks_api = _DummySinksAPI()
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client1)
-
-        sink.update(client=client2)
-
-        self.assertEqual(
-            api._sink_update_called_with,
-            (self.PROJECT, self.SINK_NAME, self.FILTER, self.DESTINATION_URI))
-
-    def test_delete_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.sinks_api = _DummySinksAPI()
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client)
-
-        sink.delete()
-
-        self.assertEqual(api._sink_delete_called_with,
-                         (self.PROJECT, self.SINK_NAME))
-
-    def test_delete_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.sinks_api = _DummySinksAPI()
-        sink = self._makeOne(self.SINK_NAME, self.FILTER, self.DESTINATION_URI,
-                             client=client1)
-
-        sink.delete(client=client2)
-
-        self.assertEqual(api._sink_delete_called_with,
-                         (self.PROJECT, self.SINK_NAME))
-
-
-class _Client(object):
-
-    def __init__(self, project):
-        self.project = project
-
-
-class _DummySinksAPI(object):
-
-    def sink_create(self, project, sink_name, filter_, destination):
-        self._sink_create_called_with = (
-            project, sink_name, filter_, destination)
-
-    def sink_get(self, project, sink_name):
-        from google.cloud.exceptions import NotFound
-        self._sink_get_called_with = (project, sink_name)
-        try:
-            return self._sink_get_response
-        except AttributeError:
-            raise NotFound('miss')
-
-    def sink_update(self, project, sink_name, filter_, destination):
-        self._sink_update_called_with = (
-            project, sink_name, filter_, destination)
-
-    def sink_delete(self, project, sink_name):
-        self._sink_delete_called_with = (project, sink_name)
diff --git a/unit_tests/monitoring/__init__.py b/unit_tests/monitoring/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/monitoring/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/monitoring/test__dataframe.py b/unit_tests/monitoring/test__dataframe.py
deleted file mode 100644
index 3e9fd31d111e..000000000000
--- a/unit_tests/monitoring/test__dataframe.py
+++ /dev/null
@@ -1,226 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-try:
-    import pandas
-except ImportError:
-    HAVE_PANDAS = False
-else:
-    HAVE_PANDAS = True  # pragma: NO COVER
-
-import unittest
-
-
-PROJECT = 'my-project'
-
-INSTANCE_NAMES = ['instance-1', 'instance-2']
-INSTANCE_ZONES = ['us-east1-a', 'us-east1-b']
-INSTANCE_IDS = ['1234567890123456789', '9876543210987654321']
-
-METRIC_TYPE = 'compute.googleapis.com/instance/cpu/utilization'
-METRIC_LABELS = list({'instance_name': name} for name in INSTANCE_NAMES)
-
-RESOURCE_TYPE = 'gce_instance'
-RESOURCE_LABELS = list({
-    'project_id': PROJECT,
-    'zone': zone,
-    'instance_id': instance_id,
-} for zone, instance_id in zip(INSTANCE_ZONES, INSTANCE_IDS))
-
-METRIC_KIND = 'GAUGE'
-VALUE_TYPE = 'DOUBLE'
-
-TIMESTAMPS = [
-    '2016-04-06T22:05:00.042Z',
-    '2016-04-06T22:05:01.042Z',
-    '2016-04-06T22:05:02.042Z',
-]
-
-DIMENSIONS = len(TIMESTAMPS), len(INSTANCE_NAMES)
-VALUES = list(0.1 * i for i in range(DIMENSIONS[1]))
-ARRAY = [VALUES] * DIMENSIONS[0]
-
-
-def parse_timestamps():  # pragma: NO COVER
-    import datetime
-    from google.cloud._helpers import _RFC3339_MICROS
-    return [datetime.datetime.strptime(t, _RFC3339_MICROS)
-            for t in TIMESTAMPS]
-
-
-def generate_query_results():  # pragma: NO COVER
-    from google.cloud.monitoring.metric import Metric
-    from google.cloud.monitoring.resource import Resource
-    from google.cloud.monitoring.timeseries import Point
-    from google.cloud.monitoring.timeseries import TimeSeries
-
-    def P(timestamp, value):
-        return Point(
-            start_time=timestamp,
-            end_time=timestamp,
-            value=value,
-        )
-
-    for metric_labels, resource_labels, value in zip(
-            METRIC_LABELS, RESOURCE_LABELS, VALUES):
-        yield TimeSeries(
-            metric=Metric(type=METRIC_TYPE, labels=metric_labels),
-            resource=Resource(type=RESOURCE_TYPE, labels=resource_labels),
-            metric_kind=METRIC_KIND,
-            value_type=VALUE_TYPE,
-            points=[P(t, value) for t in TIMESTAMPS],
-        )
-
-
-@unittest.skipUnless(HAVE_PANDAS, 'No pandas')
-class Test__build_dataframe(unittest.TestCase):  # pragma: NO COVER
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.monitoring._dataframe import _build_dataframe
-        return _build_dataframe(*args, **kwargs)
-
-    def test_both_label_and_labels_illegal(self):
-        with self.assertRaises(ValueError):
-            self._callFUT([], label='instance_name', labels=['zone'])
-
-    def test_empty_labels_illegal(self):
-        with self.assertRaises(ValueError):
-            self._callFUT([], labels=[])
-
-    def test_simple_label(self):
-        iterable = generate_query_results()
-        dataframe = self._callFUT(iterable, label='instance_name')
-
-        self.assertEqual(dataframe.shape, DIMENSIONS)
-        self.assertEqual(dataframe.values.tolist(), ARRAY)
-
-        self.assertEqual(list(dataframe.columns), INSTANCE_NAMES)
-        self.assertIsNone(dataframe.columns.name)
-
-        self.assertEqual(list(dataframe.index), parse_timestamps())
-        self.assertIsNone(dataframe.index.name)
-
-    def test_multiple_labels(self):
-        NAMES = ['resource_type', 'instance_id']
-
-        iterable = generate_query_results()
-        dataframe = self._callFUT(iterable, labels=NAMES)
-
-        self.assertEqual(dataframe.shape, DIMENSIONS)
-        self.assertEqual(dataframe.values.tolist(), ARRAY)
-
-        expected_headers = [(RESOURCE_TYPE, instance_id)
-                            for instance_id in INSTANCE_IDS]
-        self.assertEqual(list(dataframe.columns), expected_headers)
-        self.assertEqual(dataframe.columns.names, NAMES)
-        self.assertIsNone(dataframe.columns.name)
-
-        self.assertEqual(list(dataframe.index), parse_timestamps())
-        self.assertIsNone(dataframe.index.name)
-
-    def test_multiple_labels_with_just_one(self):
-        NAME = 'instance_id'
-        NAMES = [NAME]
-
-        iterable = generate_query_results()
-        dataframe = self._callFUT(iterable, labels=NAMES)
-
-        self.assertEqual(dataframe.shape, DIMENSIONS)
-        self.assertEqual(dataframe.values.tolist(), ARRAY)
-
-        self.assertEqual(list(dataframe.columns), INSTANCE_IDS)
-        self.assertEqual(dataframe.columns.names, NAMES)
-        self.assertEqual(dataframe.columns.name, NAME)
-
-        self.assertEqual(list(dataframe.index), parse_timestamps())
-        self.assertIsNone(dataframe.index.name)
-
-    def test_smart_labels(self):
-        NAMES = ['resource_type', 'project_id',
-                 'zone', 'instance_id',
-                 'instance_name']
-
-        iterable = generate_query_results()
-        dataframe = self._callFUT(iterable)
-
-        self.assertEqual(dataframe.shape, DIMENSIONS)
-        self.assertEqual(dataframe.values.tolist(), ARRAY)
-
-        expected_headers = [
-            (RESOURCE_TYPE, PROJECT, zone, instance_id, instance_name)
-            for zone, instance_id, instance_name
-            in zip(INSTANCE_ZONES, INSTANCE_IDS, INSTANCE_NAMES)]
-        self.assertEqual(list(dataframe.columns), expected_headers)
-        self.assertEqual(dataframe.columns.names, NAMES)
-        self.assertIsNone(dataframe.columns.name)
-
-        self.assertEqual(list(dataframe.index), parse_timestamps())
-        self.assertIsNone(dataframe.index.name)
-
-    def test_empty_table_simple_label(self):
-        dataframe = self._callFUT([], label='instance_name')
-        self.assertEqual(dataframe.shape, (0, 0))
-        self.assertIsNone(dataframe.columns.name)
-        self.assertIsNone(dataframe.index.name)
-        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
-
-    def test_empty_table_multiple_labels(self):
-        NAMES = ['resource_type', 'instance_id']
-        dataframe = self._callFUT([], labels=NAMES)
-        self.assertEqual(dataframe.shape, (0, 0))
-        self.assertEqual(dataframe.columns.names, NAMES)
-        self.assertIsNone(dataframe.columns.name)
-        self.assertIsNone(dataframe.index.name)
-        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
-
-    def test_empty_table_multiple_labels_with_just_one(self):
-        NAME = 'instance_id'
-        NAMES = [NAME]
-        dataframe = self._callFUT([], labels=NAMES)
-        self.assertEqual(dataframe.shape, (0, 0))
-        self.assertEqual(dataframe.columns.names, NAMES)
-        self.assertEqual(dataframe.columns.name, NAME)
-        self.assertIsNone(dataframe.index.name)
-        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
-
-    def test_empty_table_smart_labels(self):
-        NAME = 'resource_type'
-        NAMES = [NAME]
-        dataframe = self._callFUT([])
-        self.assertEqual(dataframe.shape, (0, 0))
-        self.assertEqual(dataframe.columns.names, NAMES)
-        self.assertEqual(dataframe.columns.name, NAME)
-        self.assertIsNone(dataframe.index.name)
-        self.assertIsInstance(dataframe.index, pandas.DatetimeIndex)
-
-
-class Test__sorted_resource_labels(unittest.TestCase):
-
-    def _callFUT(self, labels):
-        from google.cloud.monitoring._dataframe import _sorted_resource_labels
-        return _sorted_resource_labels(labels)
-
-    def test_empty(self):
-        self.assertEqual(self._callFUT([]), [])
-
-    def test_sorted(self):
-        from google.cloud.monitoring._dataframe import TOP_RESOURCE_LABELS
-        EXPECTED = TOP_RESOURCE_LABELS + ('other-1', 'other-2')
-        self.assertSequenceEqual(self._callFUT(EXPECTED), EXPECTED)
-
-    def test_reversed(self):
-        from google.cloud.monitoring._dataframe import TOP_RESOURCE_LABELS
-        EXPECTED = TOP_RESOURCE_LABELS + ('other-1', 'other-2')
-        INPUT = list(reversed(EXPECTED))
-        self.assertSequenceEqual(self._callFUT(INPUT), EXPECTED)
diff --git a/unit_tests/monitoring/test_client.py b/unit_tests/monitoring/test_client.py
deleted file mode 100644
index 202b76f2f24e..000000000000
--- a/unit_tests/monitoring/test_client.py
+++ /dev/null
@@ -1,649 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-PROJECT = 'my-project'
-
-
-class TestClient(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_query(self):
-        import datetime
-        from google.cloud._helpers import _datetime_to_rfc3339
-        from google.cloud.exceptions import NotFound
-
-        START_TIME = datetime.datetime(2016, 4, 6, 22, 5, 0)
-        END_TIME = datetime.datetime(2016, 4, 6, 22, 10, 0)
-        MINUTES = 5
-
-        METRIC_TYPE = 'compute.googleapis.com/instance/cpu/utilization'
-        METRIC_LABELS = {'instance_name': 'instance-1'}
-        METRIC_LABELS2 = {'instance_name': 'instance-2'}
-
-        RESOURCE_TYPE = 'gce_instance'
-        RESOURCE_LABELS = {
-            'project_id': 'my-project',
-            'zone': 'us-east1-a',
-            'instance_id': '1234567890123456789',
-        }
-        RESOURCE_LABELS2 = {
-            'project_id': 'my-project',
-            'zone': 'us-east1-b',
-            'instance_id': '9876543210987654321',
-        }
-
-        METRIC_KIND = 'GAUGE'
-        VALUE_TYPE = 'DOUBLE'
-
-        TS1 = '2016-04-06T22:05:00.042Z'
-        TS2 = '2016-04-06T22:05:01.042Z'
-        TS3 = '2016-04-06T22:05:02.042Z'
-
-        VAL1 = 0.1
-        VAL2 = 0.2
-
-        def P(timestamp, value):
-            return {
-                'interval': {'startTime': timestamp, 'endTime': timestamp},
-                'value': {'doubleValue': value},
-            }
-
-        SERIES1 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [P(TS3, VAL1), P(TS2, VAL1), P(TS1, VAL1)],
-        }
-        SERIES2 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS2},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS2},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [P(TS3, VAL2), P(TS2, VAL2), P(TS1, VAL2)],
-        }
-
-        RESPONSE = {'timeSeries': [SERIES1, SERIES2]}
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(RESPONSE)
-
-        # A simple query. In practice, it can be very convenient to let the
-        # end time default to the start of the current minute.
-        query = client.query(METRIC_TYPE, end_time=END_TIME, minutes=MINUTES)
-        response = list(query)
-
-        self.assertEqual(len(response), 2)
-        series1, series2 = response
-
-        self.assertEqual(series1.metric.type, METRIC_TYPE)
-        self.assertEqual(series2.metric.type, METRIC_TYPE)
-        self.assertEqual(series1.metric.labels, METRIC_LABELS)
-        self.assertEqual(series2.metric.labels, METRIC_LABELS2)
-
-        self.assertEqual(series1.resource.type, RESOURCE_TYPE)
-        self.assertEqual(series2.resource.type, RESOURCE_TYPE)
-        self.assertEqual(series1.resource.labels, RESOURCE_LABELS)
-        self.assertEqual(series2.resource.labels, RESOURCE_LABELS2)
-
-        self.assertEqual(series1.metric_kind, METRIC_KIND)
-        self.assertEqual(series2.metric_kind, METRIC_KIND)
-        self.assertEqual(series1.value_type, VALUE_TYPE)
-        self.assertEqual(series2.value_type, VALUE_TYPE)
-
-        self.assertEqual([p.value for p in series1.points], [VAL1, VAL1, VAL1])
-        self.assertEqual([p.value for p in series2.points], [VAL2, VAL2, VAL2])
-        self.assertEqual([p.end_time for p in series1.points], [TS1, TS2, TS3])
-        self.assertEqual([p.end_time for p in series2.points], [TS1, TS2, TS3])
-
-        expected_request = {
-            'method': 'GET',
-            'path': '/projects/{project}/timeSeries/'.format(project=PROJECT),
-            'query_params': [
-                ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-                ('interval.endTime', _datetime_to_rfc3339(END_TIME)),
-                ('interval.startTime', _datetime_to_rfc3339(START_TIME)),
-            ],
-        }
-
-        request, = connection._requested
-        self.assertEqual(request, expected_request)
-
-        with self.assertRaises(NotFound):
-            list(query)
-
-    def test_metric_descriptor_factory(self):
-        TYPE = 'custom.googleapis.com/my_metric'
-        METRIC_KIND = 'GAUGE'
-        VALUE_TYPE = 'DOUBLE'
-        DESCRIPTION = 'This is my metric.'
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        client.connection = _Connection()   # For safety's sake.
-        descriptor = client.metric_descriptor(TYPE,
-                                              metric_kind=METRIC_KIND,
-                                              value_type=VALUE_TYPE,
-                                              description=DESCRIPTION)
-
-        self.assertIs(descriptor.client, client)
-
-        self.assertIsNone(descriptor.name)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.labels, ())
-
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-
-        self.assertEqual(descriptor.unit, '')
-        self.assertEqual(descriptor.description, DESCRIPTION)
-        self.assertEqual(descriptor.display_name, '')
-
-    def test_metric_factory(self):
-        TYPE = 'custom.googleapis.com/my_metric'
-        LABELS = {
-            'instance_name': 'my-instance'
-        }
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        client.connection = _Connection()   # For safety's sake.
-        metric = client.metric(TYPE, LABELS)
-        self.assertEqual(metric.type, TYPE)
-        self.assertEqual(metric.labels, LABELS)
-
-    def test_resource_factory(self):
-        TYPE = 'https://cloud.google.com/monitoring/api/resources'
-        LABELS = {
-            'instance_id': 'my-instance-id',
-            'zone': 'us-central1-f'
-        }
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        client.connection = _Connection()   # For safety's sake.
-        resource = client.resource(TYPE, LABELS)
-        self.assertEqual(resource.type, TYPE)
-        self.assertEqual(resource.labels, LABELS)
-
-    def test_timeseries_factory_gauge(self):
-        import datetime
-        from unit_tests._testing import _Monkey
-        import google.cloud.monitoring.client
-        from google.cloud._helpers import _datetime_to_rfc3339
-        METRIC_TYPE = 'custom.googleapis.com/my_metric'
-        METRIC_LABELS = {
-            'status': 'successful'
-        }
-
-        RESOURCE_TYPE = 'gce_instance'
-        RESOURCE_LABELS = {
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-f'
-        }
-
-        VALUE = 42
-        TIME1 = datetime.datetime.utcnow()
-        TIME1_STR = _datetime_to_rfc3339(TIME1, ignore_zone=False)
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        client.connection = _Connection()   # For safety's sake.
-        metric = client.metric(METRIC_TYPE, METRIC_LABELS)
-        resource = client.resource(RESOURCE_TYPE, RESOURCE_LABELS)
-
-        # Construct a time series assuming a gauge metric.
-        timeseries = client.time_series(metric, resource, VALUE,
-                                        end_time=TIME1)
-        self.assertEqual(timeseries.metric, metric)
-        self.assertEqual(timeseries.resource, resource)
-        self.assertEqual(len(timeseries.points), 1)
-        self.assertEqual(timeseries.points[0].value, VALUE)
-        self.assertIsNone(timeseries.points[0].start_time)
-        self.assertEqual(timeseries.points[0].end_time, TIME1_STR)
-
-        TIME2 = datetime.datetime.utcnow()
-        TIME2_STR = _datetime_to_rfc3339(TIME2, ignore_zone=False)
-        # Construct a time series assuming a gauge metric using the current
-        # time
-        with _Monkey(google.cloud.monitoring.client, _UTCNOW=lambda: TIME2):
-            timeseries_no_end = client.time_series(metric, resource, VALUE)
-
-        self.assertEqual(timeseries_no_end.points[0].end_time, TIME2_STR)
-        self.assertIsNone(timeseries_no_end.points[0].start_time)
-
-    def test_timeseries_factory_cumulative(self):
-        import datetime
-        from google.cloud._helpers import _datetime_to_rfc3339
-        MY_CUMULATIVE_METRIC = 'custom.googleapis.com/my_cumulative_metric'
-        METRIC_LABELS = {
-            'status': 'successful'
-        }
-
-        RESOURCE_TYPE = 'gce_instance'
-        RESOURCE_LABELS = {
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-f'
-        }
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        client.connection = _Connection()   # For safety's sake.
-        resource = client.resource(RESOURCE_TYPE, RESOURCE_LABELS)
-
-        VALUE = 42
-        VALUE2 = 43
-        RESET_TIME = datetime.datetime.utcnow()
-        TIME1 = datetime.datetime.utcnow()
-        TIME2 = datetime.datetime.utcnow()
-
-        # Construct a couple of time series assuming a cumulative metric.
-        cumulative_metric = client.metric(MY_CUMULATIVE_METRIC, METRIC_LABELS)
-        cumulative_timeseries = client.time_series(cumulative_metric,
-                                                   resource,
-                                                   VALUE,
-                                                   start_time=RESET_TIME,
-                                                   end_time=TIME1)
-
-        cumulative_timeseries2 = client.time_series(cumulative_metric,
-                                                    resource,
-                                                    VALUE2,
-                                                    start_time=RESET_TIME,
-                                                    end_time=TIME2)
-
-        RESET_TIME_STR = _datetime_to_rfc3339(RESET_TIME, ignore_zone=False)
-        TIME1_STR = _datetime_to_rfc3339(TIME1, ignore_zone=False)
-        TIME2_STR = _datetime_to_rfc3339(TIME2, ignore_zone=False)
-
-        self.assertEqual(cumulative_timeseries.points[0].start_time,
-                         RESET_TIME_STR)
-        self.assertEqual(cumulative_timeseries.points[0].end_time, TIME1_STR)
-        self.assertEqual(cumulative_timeseries.points[0].value, VALUE)
-        self.assertEqual(cumulative_timeseries2.points[0].start_time,
-                         RESET_TIME_STR)
-        self.assertEqual(cumulative_timeseries2.points[0].end_time,
-                         TIME2_STR)
-        self.assertEqual(cumulative_timeseries2.points[0].value, VALUE2)
-
-    def test_fetch_metric_descriptor(self):
-        TYPE = 'custom.googleapis.com/my_metric'
-        NAME = 'projects/{project}/metricDescriptors/{type}'.format(
-            project=PROJECT, type=TYPE)
-        DESCRIPTION = 'This is my metric.'
-
-        METRIC_DESCRIPTOR = {
-            'name': NAME,
-            'type': TYPE,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION,
-        }
-
-        # This test is identical to TestMetricDescriptor.test_fetch()
-        # except for the following three lines.
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(METRIC_DESCRIPTOR)
-        descriptor = client.fetch_metric_descriptor(TYPE)
-
-        self.assertIs(descriptor.client, client)
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_list_metric_descriptors(self):
-        PATH = 'projects/{project}/metricDescriptors/'.format(project=PROJECT)
-
-        TYPE1 = 'custom.googleapis.com/my_metric_1'
-        DESCRIPTION1 = 'This is my first metric.'
-        NAME1 = PATH + TYPE1
-        METRIC_DESCRIPTOR1 = {
-            'name': NAME1,
-            'type': TYPE1,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION1,
-        }
-
-        TYPE2 = 'custom.googleapis.com/my_metric_2'
-        DESCRIPTION2 = 'This is my second metric.'
-        NAME2 = PATH + TYPE2
-        METRIC_DESCRIPTOR2 = {
-            'name': NAME2,
-            'type': TYPE2,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION2,
-        }
-
-        RESPONSE = {
-            'metricDescriptors': [METRIC_DESCRIPTOR1, METRIC_DESCRIPTOR2],
-        }
-
-        # This test is identical to TestMetricDescriptor.test_list()
-        # except for the following three lines.
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(RESPONSE)
-        descriptors = client.list_metric_descriptors()
-
-        self.assertEqual(len(descriptors), 2)
-        descriptor1, descriptor2 = descriptors
-
-        self.assertIs(descriptor1.client, client)
-        self.assertEqual(descriptor1.name, NAME1)
-        self.assertEqual(descriptor1.type, TYPE1)
-        self.assertEqual(descriptor1.description, DESCRIPTION1)
-
-        self.assertIs(descriptor2.client, client)
-        self.assertEqual(descriptor2.name, NAME2)
-        self.assertEqual(descriptor2.type, TYPE2)
-        self.assertEqual(descriptor2.description, DESCRIPTION2)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {}}
-        self.assertEqual(request, expected_request)
-
-    def test_fetch_resource_descriptor(self):
-        TYPE = 'gce_instance'
-        NAME = 'projects/{project}/monitoredResourceDescriptors/{type}'.format(
-            project=PROJECT, type=TYPE)
-        DISPLAY_NAME = 'GCE Instance'
-        DESCRIPTION = 'A VM instance hosted in Google Compute Engine.'
-        LABEL1 = {'key': 'project_id', 'valueType': 'STRING',
-                  'description': 'The ID of the GCP project...'}
-        LABEL2 = {'key': 'instance_id', 'valueType': 'STRING',
-                  'description': 'The VM instance identifier...'}
-        LABEL3 = {'key': 'zone', 'valueType': 'STRING',
-                  'description': 'The GCE zone...'}
-
-        RESOURCE_DESCRIPTOR = {
-            'name': NAME,
-            'type': TYPE,
-            'displayName': DISPLAY_NAME,
-            'description': DESCRIPTION,
-            'labels': [LABEL1, LABEL2, LABEL3],
-        }
-
-        # This test is identical to TestResourceDescriptor.test_fetch()
-        # except for the following three lines.
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(RESOURCE_DESCRIPTOR)
-        descriptor = client.fetch_resource_descriptor(TYPE)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.display_name, DISPLAY_NAME)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-        self.assertEqual(len(descriptor.labels), 3)
-        label1, label2, label3 = descriptor.labels
-        self.assertEqual(label1.key, LABEL1['key'])
-        self.assertEqual(label2.key, LABEL2['key'])
-        self.assertEqual(label3.key, LABEL3['key'])
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_list_resource_descriptors(self):
-        PATH = 'projects/{project}/monitoredResourceDescriptors/'.format(
-            project=PROJECT)
-
-        TYPE1 = 'custom.googleapis.com/resource-1'
-        DESCRIPTION1 = 'This is the first resource.'
-        NAME1 = PATH + TYPE1
-        RESOURCE_DESCRIPTOR1 = {
-            'name': NAME1,
-            'type': TYPE1,
-            'description': DESCRIPTION1,
-        }
-
-        TYPE2 = 'custom.googleapis.com/resource-2'
-        DESCRIPTION2 = 'This is the second resource.'
-        NAME2 = PATH + TYPE2
-        RESOURCE_DESCRIPTOR2 = {
-            'name': NAME2,
-            'type': TYPE2,
-            'description': DESCRIPTION2,
-        }
-
-        RESPONSE = {
-            'resourceDescriptors':
-                [RESOURCE_DESCRIPTOR1, RESOURCE_DESCRIPTOR2],
-        }
-
-        # This test is identical to TestResourceDescriptor.test_list()
-        # except for the following three lines.
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(RESPONSE)
-        descriptors = client.list_resource_descriptors()
-
-        self.assertEqual(len(descriptors), 2)
-        descriptor1, descriptor2 = descriptors
-
-        self.assertEqual(descriptor1.name, NAME1)
-        self.assertEqual(descriptor1.type, TYPE1)
-        self.assertEqual(descriptor1.description, DESCRIPTION1)
-
-        self.assertEqual(descriptor2.name, NAME2)
-        self.assertEqual(descriptor2.type, TYPE2)
-        self.assertEqual(descriptor2.description, DESCRIPTION2)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {}}
-        self.assertEqual(request, expected_request)
-
-    def test_group(self):
-        GROUP_ID = 'GROUP_ID'
-        DISPLAY_NAME = 'My Group'
-        PARENT_ID = 'PARENT_ID'
-        FILTER = 'resource.type = "gce_instance"'
-        IS_CLUSTER = False
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        group = client.group(GROUP_ID, display_name=DISPLAY_NAME,
-                             parent_id=PARENT_ID, filter_string=FILTER,
-                             is_cluster=IS_CLUSTER)
-
-        self.assertEqual(group.id, GROUP_ID)
-        self.assertEqual(group.display_name, DISPLAY_NAME)
-        self.assertEqual(group.parent_id, PARENT_ID)
-        self.assertEqual(group.filter, FILTER)
-        self.assertEqual(group.is_cluster, IS_CLUSTER)
-
-    def test_group_defaults(self):
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        group = client.group()
-
-        self.assertIsNone(group.id)
-        self.assertIsNone(group.display_name)
-        self.assertIsNone(group.parent_id)
-        self.assertIsNone(group.filter)
-        self.assertFalse(group.is_cluster)
-
-    def test_fetch_group(self):
-        PATH = 'projects/{project}/groups/'.format(project=PROJECT)
-        GROUP_ID = 'GROUP_ID'
-        GROUP_NAME = PATH + GROUP_ID
-        DISPLAY_NAME = 'My Group'
-        PARENT_ID = 'PARENT_ID'
-        PARENT_NAME = PATH + PARENT_ID
-        FILTER = 'resource.type = "gce_instance"'
-        IS_CLUSTER = False
-
-        GROUP = {
-            'name': GROUP_NAME,
-            'displayName': DISPLAY_NAME,
-            'parentName': PARENT_NAME,
-            'filter': FILTER,
-            'isCluster': IS_CLUSTER
-        }
-
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(GROUP)
-        group = client.fetch_group(GROUP_ID)
-
-        self.assertEqual(group.id, GROUP_ID)
-        self.assertEqual(group.display_name, DISPLAY_NAME)
-        self.assertEqual(group.parent_id, PARENT_ID)
-        self.assertEqual(group.filter, FILTER)
-        self.assertEqual(group.is_cluster, IS_CLUSTER)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + GROUP_NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_list_groups(self):
-        PATH = 'projects/{project}/groups/'.format(project=PROJECT)
-        GROUP_NAME = PATH + 'GROUP_ID'
-        DISPLAY_NAME = 'My Group'
-        PARENT_NAME = PATH + 'PARENT_ID'
-        FILTER = 'resource.type = "gce_instance"'
-        IS_CLUSTER = False
-
-        GROUP = {
-            'name': GROUP_NAME,
-            'displayName': DISPLAY_NAME,
-            'parentName': PARENT_NAME,
-            'filter': FILTER,
-            'isCluster': IS_CLUSTER,
-        }
-
-        RESPONSE = {
-            'group': [GROUP],
-        }
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-        connection = client.connection = _Connection(RESPONSE)
-        groups = client.list_groups()
-
-        self.assertEqual(len(groups), 1)
-
-        group = groups[0]
-        self.assertEqual(group.name, GROUP_NAME)
-        self.assertEqual(group.display_name, DISPLAY_NAME)
-        self.assertEqual(group.parent_name, PARENT_NAME)
-        self.assertEqual(group.filter, FILTER)
-        self.assertEqual(group.is_cluster, IS_CLUSTER)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {}}
-        self.assertEqual(request, expected_request)
-
-    def test_write_time_series(self):
-        PATH = '/projects/{project}/timeSeries/'.format(project=PROJECT)
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-
-        RESOURCE_TYPE = 'gce_instance'
-        RESOURCE_LABELS = {
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-f'
-        }
-
-        METRIC_TYPE = 'custom.googleapis.com/my_metric'
-        METRIC_LABELS = {
-            'status': 'successful'
-        }
-        METRIC_TYPE2 = 'custom.googleapis.com/count_404s'
-        METRIC_LABELS2 = {
-            'request_ip': '127.0.0.1'
-        }
-
-        connection = client.connection = _Connection({})
-
-        METRIC = client.metric(METRIC_TYPE, METRIC_LABELS)
-        METRIC2 = client.metric(METRIC_TYPE2, METRIC_LABELS2)
-        RESOURCE = client.resource(RESOURCE_TYPE, RESOURCE_LABELS)
-
-        TIMESERIES1 = client.time_series(METRIC, RESOURCE, 3)
-        TIMESERIES2 = client.time_series(METRIC2, RESOURCE, 3.14)
-
-        expected_data = {
-            'timeSeries': [
-                TIMESERIES1._to_dict(),
-                TIMESERIES2._to_dict()
-            ]
-        }
-        expected_request = {'method': 'POST', 'path': PATH,
-                            'data': expected_data}
-
-        client.write_time_series([TIMESERIES1, TIMESERIES2])
-        request, = connection._requested
-        self.assertEqual(request, expected_request)
-
-    def test_write_point(self):
-        import datetime
-        PATH = '/projects/{project}/timeSeries/'.format(project=PROJECT)
-        client = self._makeOne(project=PROJECT, credentials=_Credentials())
-
-        RESOURCE_TYPE = 'gce_instance'
-        RESOURCE_LABELS = {
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-f'
-        }
-
-        METRIC_TYPE = 'custom.googleapis.com/my_metric'
-        METRIC_LABELS = {
-            'status': 'successful'
-        }
-
-        connection = client.connection = _Connection({})
-
-        METRIC = client.metric(METRIC_TYPE, METRIC_LABELS)
-        RESOURCE = client.resource(RESOURCE_TYPE, RESOURCE_LABELS)
-        VALUE = 3.14
-        TIMESTAMP = datetime.datetime.now()
-        TIMESERIES = client.time_series(METRIC, RESOURCE, VALUE, TIMESTAMP)
-
-        expected_request = {'method': 'POST', 'path': PATH,
-                            'data': {'timeSeries': [TIMESERIES._to_dict()]}}
-
-        client.write_point(METRIC, RESOURCE, VALUE, TIMESTAMP)
-        request, = connection._requested
-        self.assertEqual(request, expected_request)
-
-
-class _Credentials(object):
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = list(responses)
-        self._requested = []
-
-    def api_request(self, **kwargs):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kwargs)
-        try:
-            return self._responses.pop(0)
-        except IndexError:
-            raise NotFound('miss')
diff --git a/unit_tests/monitoring/test_connection.py b/unit_tests/monitoring/test_connection.py
deleted file mode 100644
index 3001f997b2c1..000000000000
--- a/unit_tests/monitoring/test_connection.py
+++ /dev/null
@@ -1,44 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        credentials = _Credentials()
-        connection = self._makeOne(credentials)
-        self.assertEqual(connection.credentials._scopes,
-                         self._getTargetClass().SCOPE)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
diff --git a/unit_tests/monitoring/test_group.py b/unit_tests/monitoring/test_group.py
deleted file mode 100644
index 5a26b102e73a..000000000000
--- a/unit_tests/monitoring/test_group.py
+++ /dev/null
@@ -1,547 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class Test_group_id_from_name(unittest.TestCase):
-
-    def _callFUT(self, path, project):
-        from google.cloud.monitoring.group import _group_id_from_name
-        return _group_id_from_name(path, project)
-
-    def test_w_empty_name(self):
-        PROJECT = 'my-project-1234'
-        PATH = ''
-        with self.assertRaises(ValueError):
-            self._callFUT(PATH, PROJECT)
-
-    def test_w_simple_name(self):
-        GROUP_ID = 'GROUP_ID'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/groups/%s' % (PROJECT, GROUP_ID)
-        group_id = self._callFUT(PATH, PROJECT)
-        self.assertEqual(group_id, GROUP_ID)
-
-    def test_w_name_w_all_extras(self):
-        GROUP_ID = 'GROUP_ID-part.one~part.two%part-three'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/groups/%s' % (PROJECT, GROUP_ID)
-        group_id = self._callFUT(PATH, PROJECT)
-        self.assertEqual(group_id, GROUP_ID)
-
-
-class TestGroup(unittest.TestCase):
-
-    def setUp(self):
-        self.PROJECT = 'PROJECT'
-        self.GROUP_ID = 'group_id'
-        self.PARENT_ID = 'parent_id'
-        self.DISPLAY_NAME = 'My Group'
-
-        self.PATH = 'projects/%s/groups/' % self.PROJECT
-        self.GROUP_NAME = self.PATH + self.GROUP_ID
-        self.PARENT_NAME = self.PATH + self.PARENT_ID
-
-        FILTER_TEMPLATE = 'resource.metadata.tag."color"="%s"'
-        self.FILTER = FILTER_TEMPLATE % ('blue',)
-
-        self.JSON_GROUP = {
-            'name': self.GROUP_NAME,
-            'displayName': self.DISPLAY_NAME,
-            'parentName': self.PARENT_NAME,
-            'filter': self.FILTER,
-            'isCluster': True,
-        }
-        self.JSON_PARENT = {
-            'name': self.PARENT_NAME,
-            'displayName': 'Parent group',
-            'filter': FILTER_TEMPLATE % 'red',
-            'isCluster': False,
-        }
-        self.JSON_SIBLING = {
-            'name': self.PATH + 'sibling_id',
-            'displayName': 'Sibling group',
-            'parentName': self.PARENT_NAME,
-            'filter': FILTER_TEMPLATE % 'orange',
-            'isCluster': True,
-        }
-        self.JSON_CHILD = {
-            'name': self.PATH + 'child_id',
-            'displayName': 'Child group',
-            'parentName': self.PARENT_NAME,
-            'filter': FILTER_TEMPLATE % 'purple',
-            'isCluster': False,
-        }
-
-    def _setUpResources(self):
-        from google.cloud.monitoring.resource import Resource
-        info1 = {
-            'type': 'gce_instance',
-            'labels': {
-                'project_id': 'my-project',
-                'instance_id': '1234567890123456788',
-                'zone': 'us-central1-a',
-            }
-        }
-        info2 = {
-            'type': 'gce_instance',
-            'labels': {
-                'project_id': 'my-project',
-                'instance_id': '1234567890123456789',
-                'zone': 'us-central1-a',
-            }
-        }
-        self.RESOURCE1 = Resource._from_dict(info1)
-        self.RESOURCE2 = Resource._from_dict(info2)
-        self.MEMBERS = [info1, info2]
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.group import Group
-        return Group
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def _makeOneFromJSON(self, info, client=None):
-        return self._getTargetClass()._from_dict(client=client, info=info)
-
-    def _validateGroup(self, actual_group, expected_group_json):
-        expected_group = self._makeOneFromJSON(expected_group_json)
-        self.assertEqual(actual_group.id, expected_group.id)
-        self.assertEqual(actual_group.display_name,
-                         expected_group.display_name)
-        self.assertEqual(actual_group.parent_id, expected_group.parent_id)
-        self.assertEqual(actual_group.filter, expected_group.filter)
-        self.assertEqual(actual_group.is_cluster, expected_group.is_cluster)
-
-    def _validateGroupList(self, client, actual_groups, expected_groups_json):
-        self.assertEqual(len(actual_groups), len(expected_groups_json))
-        for i, group in enumerate(actual_groups):
-            self.assertIs(group.client, client)
-            self._validateGroup(group, expected_groups_json[i])
-
-    def test_constructor(self):
-        client = _Client(project=self.PROJECT)
-        group = self._makeOne(
-            client=client,
-            group_id=self.GROUP_ID,
-            display_name=self.DISPLAY_NAME,
-            parent_id=self.PARENT_ID,
-            filter_string=self.FILTER,
-            is_cluster=True,
-        )
-
-        self.assertIs(group.client, client)
-
-        self.assertEqual(group.id, self.GROUP_ID)
-        self.assertEqual(group.name, self.GROUP_NAME)
-        self.assertEqual(group.display_name, self.DISPLAY_NAME)
-        self.assertEqual(group.parent_id, self.PARENT_ID)
-        self.assertEqual(group.parent_name, self.PARENT_NAME)
-        self.assertEqual(group.filter, self.FILTER)
-        self.assertTrue(group.is_cluster)
-
-    def test_constructor_defaults(self):
-        client = _Client(project=self.PROJECT)
-        group = self._makeOne(client=client)
-
-        self.assertIs(group.client, client)
-
-        self.assertIsNone(group.id)
-        self.assertIsNone(group.name)
-        self.assertIsNone(group.display_name)
-        self.assertIsNone(group.parent_id)
-        self.assertIsNone(group.parent_name)
-        self.assertIsNone(group.filter)
-        self.assertFalse(group.is_cluster)
-
-    def test_path_no_id(self):
-        group = self._makeOne(client=None)
-        self.assertRaises(ValueError, getattr, group, 'path')
-
-    def test_path_w_id(self):
-        client = _Client(project=self.PROJECT)
-        group = self._makeOne(client=client, group_id=self.GROUP_ID)
-        self.assertEqual(group.path, '/%s' % self.GROUP_NAME)
-
-    def test_from_dict(self):
-        client = _Client(project=self.PROJECT)
-        group = self._getTargetClass()._from_dict(client, self.JSON_GROUP)
-
-        self.assertIs(group.client, client)
-
-        self.assertEqual(group.name, self.GROUP_NAME)
-        self.assertEqual(group.display_name, self.DISPLAY_NAME)
-        self.assertEqual(group.parent_name, self.PARENT_NAME)
-        self.assertEqual(group.filter, self.FILTER)
-        self.assertTrue(group.is_cluster)
-
-    def test_from_dict_defaults(self):
-        client = _Client(project=self.PROJECT)
-        info = {
-            'name': self.GROUP_NAME,
-            'displayName': self.DISPLAY_NAME,
-            'filter': self.FILTER,
-        }
-        group = self._getTargetClass()._from_dict(client, info)
-
-        self.assertIs(group.client, client)
-
-        self.assertEqual(group.id, self.GROUP_ID)
-        self.assertEqual(group.display_name, self.DISPLAY_NAME)
-        self.assertIsNone(group.parent_id)
-        self.assertEqual(group.filter, self.FILTER)
-        self.assertFalse(group.is_cluster)
-
-    def test_to_dict(self):
-        client = _Client(project=self.PROJECT)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-        self.assertEqual(group._to_dict(), self.JSON_GROUP)
-
-    def test_to_dict_defaults(self):
-        client = _Client(project=self.PROJECT)
-        group = self._makeOne(
-            client=client, group_id=self.GROUP_ID,
-            display_name=self.DISPLAY_NAME,
-            filter_string=self.FILTER)
-        expected_dict = {
-            'name': self.GROUP_NAME,
-            'displayName': self.DISPLAY_NAME,
-            'filter': self.FILTER,
-            'isCluster': False,
-        }
-        self.assertEqual(group._to_dict(), expected_dict)
-
-    def test_create(self):
-        RESPONSE = self.JSON_GROUP
-
-        REQUEST = RESPONSE.copy()
-        REQUEST.pop('name')
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOne(
-            client=client,
-            display_name=self.DISPLAY_NAME,
-            parent_id=self.PARENT_ID,
-            filter_string=self.FILTER,
-            is_cluster=True
-        )
-        group.create()
-
-        self._validateGroup(group, RESPONSE)
-
-        request, = connection._requested
-        expected_request = {'method': 'POST', 'path': '/' + self.PATH,
-                            'data': REQUEST}
-        self.assertEqual(request, expected_request)
-
-    def test_exists_hit(self):
-        connection = _Connection(self.JSON_GROUP)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOne(client=client, group_id=self.GROUP_ID)
-
-        self.assertTrue(group.exists())
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + self.GROUP_NAME,
-                            'query_params': {'fields': 'name'}}
-        self.assertEqual(request, expected_request)
-
-    def test_exists_miss(self):
-        connection = _Connection()
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOne(client=client, group_id=self.GROUP_ID)
-
-        self.assertFalse(group.exists())
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + self.GROUP_NAME,
-                            'query_params': {'fields': 'name'}}
-        self.assertEqual(request, expected_request)
-
-    def test_reload(self):
-        connection = _Connection(self.JSON_GROUP)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOne(client, group_id=self.GROUP_ID)
-        group.reload()
-
-        self.assertIs(group.client, client)
-        self._validateGroup(group, self.JSON_GROUP)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + self.GROUP_NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_update(self):
-        REQUEST = self.JSON_GROUP
-        RESPONSE = REQUEST
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(REQUEST, client)
-        group.update()
-
-        self._validateGroup(group, RESPONSE)
-
-        request, = connection._requested
-        expected_request = {'method': 'PUT', 'path': '/' + self.GROUP_NAME,
-                            'data': REQUEST}
-        self.assertEqual(request, expected_request)
-
-    def test_delete(self):
-        connection = _Connection(self.JSON_GROUP)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-        group.delete()
-
-        request, = connection._requested
-        expected_request = {'method': 'DELETE', 'path': group.path}
-        self.assertEqual(request, expected_request)
-
-    def test_fetch_parent(self):
-        connection = _Connection(self.JSON_PARENT)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-
-        actual_parent = group.fetch_parent()
-
-        self.assertIs(actual_parent.client, client)
-        self._validateGroup(actual_parent, self.JSON_PARENT)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + self.PARENT_NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_fetch_parent_empty(self):
-        connection = _Connection()
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOne(client=client)
-        actual_parent = group.fetch_parent()
-
-        self.assertIsNone(actual_parent)
-        self.assertEqual(connection._requested, [])
-
-    def test_list(self):
-        LIST_OF_GROUPS = [self.JSON_GROUP, self.JSON_PARENT]
-        RESPONSE = {
-            'group': LIST_OF_GROUPS,
-        }
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        groups = self._getTargetClass()._list(client)
-        self._validateGroupList(client, groups, LIST_OF_GROUPS)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + self.PATH,
-                            'query_params': {}}
-        self.assertEqual(request, expected_request)
-
-    def test_list_paged(self):
-        from google.cloud.exceptions import NotFound
-
-        LIST_OF_GROUPS = [self.JSON_GROUP, self.JSON_PARENT]
-        TOKEN = 'second-page-please'
-        RESPONSE1 = {
-            'group': [LIST_OF_GROUPS[0]],
-            'nextPageToken': TOKEN,
-        }
-        RESPONSE2 = {
-            'group': [LIST_OF_GROUPS[1]],
-        }
-
-        connection = _Connection(RESPONSE1, RESPONSE2)
-        client = _Client(project=self.PROJECT, connection=connection)
-        groups = self._getTargetClass()._list(client)
-        self._validateGroupList(client, groups, LIST_OF_GROUPS)
-
-        request1, request2 = connection._requested
-        expected_request1 = {'method': 'GET', 'path': '/' + self.PATH,
-                             'query_params': {}}
-        expected_request2 = {'method': 'GET', 'path': '/' + self.PATH,
-                             'query_params': {'pageToken': TOKEN}}
-        self.assertEqual(request1, expected_request1)
-        self.assertEqual(request2, expected_request2)
-
-        with self.assertRaises(NotFound):
-            self._getTargetClass()._list(client)
-
-    def test_list_children(self):
-        CHILDREN = [self.JSON_GROUP, self.JSON_SIBLING]
-        RESPONSE = {
-            'group': CHILDREN,
-        }
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        parent_group = self._makeOneFromJSON(self.JSON_PARENT, client)
-        groups = parent_group.list_children()
-        self._validateGroupList(client, groups, CHILDREN)
-
-        request, = connection._requested
-        expected_request = {
-            'method': 'GET', 'path': '/' + self.PATH,
-            'query_params': {'childrenOfGroup': self.PARENT_NAME}
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_list_ancestors(self):
-        ANCESTORS = [self.JSON_GROUP, self.JSON_PARENT]
-        RESPONSE = {
-            'group': ANCESTORS,
-        }
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        child_group = self._makeOneFromJSON(self.JSON_CHILD, client)
-        groups = child_group.list_ancestors()
-        self._validateGroupList(client, groups, ANCESTORS)
-
-        request, = connection._requested
-        expected_request = {
-            'method': 'GET', 'path': '/' + self.PATH,
-            'query_params': {'ancestorsOfGroup': child_group.name}
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_list_descendants(self):
-        DESCENDANTS = [self.JSON_GROUP, self.JSON_SIBLING, self.JSON_CHILD]
-        RESPONSE = {
-            'group': DESCENDANTS,
-        }
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        parent_group = self._makeOneFromJSON(self.JSON_PARENT, client)
-        groups = parent_group.list_descendants()
-        self._validateGroupList(client, groups, DESCENDANTS)
-
-        request, = connection._requested
-        expected_request = {
-            'method': 'GET', 'path': '/' + self.PATH,
-            'query_params': {'descendantsOfGroup': self.PARENT_NAME}
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_list_members(self):
-        self._setUpResources()
-        RESPONSE = {
-            'members': self.MEMBERS,
-        }
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-        members = group.list_members()
-
-        self.assertEqual(members, [self.RESOURCE1, self.RESOURCE2])
-
-        request, = connection._requested
-        expected_request = {
-            'method': 'GET', 'path': '/%s/members' % self.GROUP_NAME,
-            'query_params': {},
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_list_members_paged(self):
-        self._setUpResources()
-        TOKEN = 'second-page-please'
-        RESPONSE1 = {
-            'members': [self.MEMBERS[0]],
-            'nextPageToken': TOKEN,
-        }
-        RESPONSE2 = {
-            'members': [self.MEMBERS[1]],
-        }
-
-        connection = _Connection(RESPONSE1, RESPONSE2)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-        members = group.list_members()
-
-        self.assertEqual(members, [self.RESOURCE1, self.RESOURCE2])
-
-        request1, request2 = connection._requested
-        expected_request1 = {
-            'method': 'GET', 'path': '/%s/members' % self.GROUP_NAME,
-            'query_params': {},
-        }
-        expected_request2 = {
-            'method': 'GET', 'path': '/%s/members' % self.GROUP_NAME,
-            'query_params': {'pageToken': TOKEN},
-        }
-        self.assertEqual(request1, expected_request1)
-        self.assertEqual(request2, expected_request2)
-
-    def test_list_members_w_all_arguments(self):
-        import datetime
-        from google.cloud._helpers import _datetime_to_rfc3339
-
-        self._setUpResources()
-
-        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
-        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
-        MEMBER_FILTER = 'resource.zone = "us-central1-a"'
-
-        RESPONSE = {
-            'members': self.MEMBERS,
-        }
-        connection = _Connection(RESPONSE)
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-        members = group.list_members(
-            start_time=T0, end_time=T1, filter_string=MEMBER_FILTER)
-
-        self.assertEqual(members, [self.RESOURCE1, self.RESOURCE2])
-
-        request, = connection._requested
-        expected_request = {
-            'method': 'GET', 'path': '/%s/members' % self.GROUP_NAME,
-            'query_params': {
-                'interval.startTime': _datetime_to_rfc3339(T0),
-                'interval.endTime': _datetime_to_rfc3339(T1),
-                'filter': MEMBER_FILTER,
-            },
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_list_members_w_missing_end_time(self):
-        import datetime
-
-        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
-
-        connection = _Connection()
-        client = _Client(project=self.PROJECT, connection=connection)
-        group = self._makeOneFromJSON(self.JSON_GROUP, client)
-        with self.assertRaises(ValueError):
-            group.list_members(start_time=T0)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = list(responses)
-        self._requested = []
-
-    def api_request(self, **kwargs):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kwargs)
-        try:
-            return self._responses.pop(0)
-        except IndexError:
-            raise NotFound('miss')
-
-
-class _Client(object):
-
-    def __init__(self, project, connection=None):
-        self.project = project
-        self.connection = connection
diff --git a/unit_tests/monitoring/test_label.py b/unit_tests/monitoring/test_label.py
deleted file mode 100644
index 8bfe6e8c4e49..000000000000
--- a/unit_tests/monitoring/test_label.py
+++ /dev/null
@@ -1,112 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestLabelValueType(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.label import LabelValueType
-        return LabelValueType
-
-    def test_one(self):
-        self.assertTrue(hasattr(self._getTargetClass(), 'STRING'))
-
-    def test_names(self):
-        for name in self._getTargetClass().__dict__:
-            if not name.startswith('_'):
-                self.assertEqual(getattr(self._getTargetClass(), name), name)
-
-
-class TestLabelDescriptor(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.label import LabelDescriptor
-        return LabelDescriptor
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        KEY = 'response_code'
-        VALUE_TYPE = 'INT64'
-        DESCRIPTION = 'HTTP status code for the request.'
-        descriptor = self._makeOne(key=KEY, value_type=VALUE_TYPE,
-                                   description=DESCRIPTION)
-        self.assertEqual(descriptor.key, KEY)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-    def test_constructor_defaults(self):
-        KEY = 'response_code'
-        descriptor = self._makeOne(key=KEY)
-        self.assertEqual(descriptor.key, KEY)
-        self.assertEqual(descriptor.value_type, 'STRING')
-        self.assertEqual(descriptor.description, '')
-
-    def test_from_dict(self):
-        KEY = 'response_code'
-        VALUE_TYPE = 'INT64'
-        DESCRIPTION = 'HTTP status code for the request.'
-        info = {
-            'key': KEY,
-            'valueType': VALUE_TYPE,
-            'description': DESCRIPTION,
-        }
-        descriptor = self._getTargetClass()._from_dict(info)
-        self.assertEqual(descriptor.key, KEY)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-    def test_from_dict_defaults(self):
-        KEY = 'response_code'
-        info = {'key': KEY}
-        descriptor = self._getTargetClass()._from_dict(info)
-        self.assertEqual(descriptor.key, KEY)
-        self.assertEqual(descriptor.value_type, 'STRING')
-        self.assertEqual(descriptor.description, '')
-
-    def test_to_dict(self):
-        KEY = 'response_code'
-        VALUE_TYPE = 'INT64'
-        DESCRIPTION = 'HTTP status code for the request.'
-        descriptor = self._makeOne(key=KEY, value_type=VALUE_TYPE,
-                                   description=DESCRIPTION)
-        expected = {
-            'key': KEY,
-            'valueType': VALUE_TYPE,
-            'description': DESCRIPTION,
-        }
-        self.assertEqual(descriptor._to_dict(), expected)
-
-    def test_to_dict_defaults(self):
-        KEY = 'response_code'
-        descriptor = self._makeOne(key=KEY)
-        expected = {
-            'key': KEY,
-            'valueType': 'STRING',
-        }
-        self.assertEqual(descriptor._to_dict(), expected)
-
-    def test_equality(self):
-        KEY = 'response_code'
-        VALUE_TYPE = 'INT64'
-        DESCRIPTION = 'HTTP status code for the request.'
-        descriptor1 = self._makeOne(key=KEY, value_type=VALUE_TYPE,
-                                    description=DESCRIPTION)
-        descriptor2 = self._makeOne(key=KEY, value_type=VALUE_TYPE,
-                                    description=DESCRIPTION)
-        self.assertTrue(descriptor1 == descriptor2)
-        self.assertFalse(descriptor1 != descriptor2)
diff --git a/unit_tests/monitoring/test_metric.py b/unit_tests/monitoring/test_metric.py
deleted file mode 100644
index 76f61c802577..000000000000
--- a/unit_tests/monitoring/test_metric.py
+++ /dev/null
@@ -1,564 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestMetricKind(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.metric import MetricKind
-        return MetricKind
-
-    def test_one(self):
-        self.assertTrue(hasattr(self._getTargetClass(), 'GAUGE'))
-
-    def test_names(self):
-        for name in self._getTargetClass().__dict__:
-            if not name.startswith('_'):
-                self.assertEqual(getattr(self._getTargetClass(), name), name)
-
-
-class TestValueType(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.metric import ValueType
-        return ValueType
-
-    def test_one(self):
-        self.assertTrue(hasattr(self._getTargetClass(), 'DISTRIBUTION'))
-
-    def test_names(self):
-        for name in self._getTargetClass().__dict__:
-            if not name.startswith('_'):
-                self.assertEqual(getattr(self._getTargetClass(), name), name)
-
-
-class TestMetricDescriptor(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.metric import MetricDescriptor
-        return MetricDescriptor
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        from google.cloud.monitoring.label import LabelDescriptor
-
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        NAME = 'projects/my-project/metricDescriptors/' + TYPE
-        LABELS = [
-            LabelDescriptor(key='loading', value_type='BOOL',
-                            description='Loaded a new instance?'),
-            LabelDescriptor(key='response_code', value_type='INT64',
-                            description='HTTP status code for the request.'),
-        ]
-
-        METRIC_KIND = 'DELTA'
-        VALUE_TYPE = 'INT64'
-
-        UNIT = '{responses}/s'
-        DESCRIPTION = 'Delta HTTP response count.'
-        DISPLAY_NAME = 'Response count'
-
-        client = object()
-        descriptor = self._makeOne(
-            client=client,
-            name=NAME,
-            type_=TYPE,
-            labels=LABELS,
-            metric_kind=METRIC_KIND,
-            value_type=VALUE_TYPE,
-            unit=UNIT,
-            description=DESCRIPTION,
-            display_name=DISPLAY_NAME,
-        )
-
-        self.assertIs(descriptor.client, client)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.labels, LABELS)
-
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-
-        self.assertEqual(descriptor.unit, UNIT)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-        self.assertEqual(descriptor.display_name, DISPLAY_NAME)
-
-    def test_constructor_defaults(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-
-        client = object()
-        descriptor = self._makeOne(client=client, type_=TYPE)
-
-        self.assertIs(descriptor.client, client)
-
-        self.assertIsNone(descriptor.name)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.labels, ())
-
-        self.assertEqual(descriptor.metric_kind, 'METRIC_KIND_UNSPECIFIED')
-        self.assertEqual(descriptor.value_type, 'VALUE_TYPE_UNSPECIFIED')
-
-        self.assertEqual(descriptor.unit, '')
-        self.assertEqual(descriptor.description, '')
-        self.assertEqual(descriptor.display_name, '')
-
-    def test_from_dict(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        NAME = 'projects/my-project/metricDescriptors/' + TYPE
-        LABEL1 = {'key': 'loading', 'valueType': 'BOOL',
-                  'description': 'Loaded a new instance?'}
-        LABEL2 = {'key': 'response_code', 'valueType': 'INT64',
-                  'description': 'HTTP status code for the request.'}
-
-        METRIC_KIND = 'DELTA'
-        VALUE_TYPE = 'INT64'
-
-        UNIT = '{responses}/s'
-        DESCRIPTION = 'Delta HTTP response count.'
-        DISPLAY_NAME = 'Response count'
-
-        info = {
-            'name': NAME,
-            'type': TYPE,
-            'labels': [LABEL1, LABEL2],
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'unit': UNIT,
-            'description': DESCRIPTION,
-            'displayName': DISPLAY_NAME,
-        }
-        client = object()
-        descriptor = self._getTargetClass()._from_dict(client, info)
-
-        self.assertIs(descriptor.client, client)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-
-        self.assertEqual(len(descriptor.labels), 2)
-        label1, label2 = descriptor.labels
-        self.assertEqual(label1.key, LABEL1['key'])
-        self.assertEqual(label2.key, LABEL2['key'])
-
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-
-        self.assertEqual(descriptor.unit, UNIT)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-        self.assertEqual(descriptor.display_name, DISPLAY_NAME)
-
-    def test_from_dict_defaults(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        NAME = 'projects/my-project/metricDescriptors/' + TYPE
-        METRIC_KIND = 'CUMULATIVE'
-        VALUE_TYPE = 'DOUBLE'
-
-        info = {
-            'name': NAME,
-            'type': TYPE,
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-        }
-        client = object()
-        descriptor = self._getTargetClass()._from_dict(client, info)
-
-        self.assertIs(descriptor.client, client)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.labels, ())
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-        self.assertEqual(descriptor.unit, '')
-        self.assertEqual(descriptor.description, '')
-        self.assertEqual(descriptor.display_name, '')
-
-    def test_to_dict(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        NAME = 'projects/my-project/metricDescriptors/' + TYPE
-        LABEL1 = {'key': 'loading', 'valueType': 'BOOL',
-                  'description': 'Loaded a new instance?'}
-        LABEL2 = {'key': 'response_code', 'valueType': 'INT64',
-                  'description': 'HTTP status code for the request.'}
-
-        METRIC_KIND = 'DELTA'
-        VALUE_TYPE = 'INT64'
-
-        UNIT = '{responses}/s'
-        DESCRIPTION = 'Delta HTTP response count.'
-        DISPLAY_NAME = 'Response count'
-
-        info = {
-            'name': NAME,
-            'type': TYPE,
-            'labels': [LABEL1, LABEL2],
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'unit': UNIT,
-            'description': DESCRIPTION,
-            'displayName': DISPLAY_NAME,
-        }
-        client = object()
-        descriptor = self._getTargetClass()._from_dict(client, info)
-
-        del info['name']
-        self.assertEqual(descriptor._to_dict(), info)
-
-    def test_to_dict_defaults(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        NAME = 'projects/my-project/metricDescriptors/' + TYPE
-        METRIC_KIND = 'DELTA'
-        VALUE_TYPE = 'INT64'
-
-        info = {
-            'name': NAME,
-            'type': TYPE,
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-        }
-        client = object()
-        descriptor = self._getTargetClass()._from_dict(client, info)
-
-        del info['name']
-        self.assertEqual(descriptor._to_dict(), info)
-
-    def test_create(self):
-        PROJECT = 'my-project'
-        TYPE = 'custom.googleapis.com/my_metric'
-        PATH = 'projects/{project}/metricDescriptors/'.format(project=PROJECT)
-        NAME = PATH + TYPE
-
-        METRIC_KIND = 'GAUGE'
-        VALUE_TYPE = 'DOUBLE'
-        DESCRIPTION = 'This is my metric.'
-
-        REQUEST = {
-            'type': TYPE,
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'description': DESCRIPTION,
-        }
-        RESPONSE = REQUEST.copy()
-        RESPONSE['name'] = NAME
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptor = self._makeOne(
-            client=client,
-            type_=TYPE,
-            metric_kind=METRIC_KIND,
-            value_type=VALUE_TYPE,
-            description=DESCRIPTION,
-        )
-        descriptor.create()
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.labels, ())
-
-        self.assertEqual(descriptor.metric_kind, METRIC_KIND)
-        self.assertEqual(descriptor.value_type, VALUE_TYPE)
-
-        self.assertEqual(descriptor.unit, '')
-        self.assertEqual(descriptor.description, DESCRIPTION)
-        self.assertEqual(descriptor.display_name, '')
-
-        request, = connection._requested
-        expected_request = {'method': 'POST', 'path': '/' + PATH,
-                            'data': REQUEST}
-        self.assertEqual(request, expected_request)
-
-    def test_delete(self):
-        PROJECT = 'my-project'
-        TYPE = 'custom.googleapis.com/my_metric'
-        NAME = 'projects/{project}/metricDescriptors/{type}'.format(
-            project=PROJECT, type=TYPE)
-
-        connection = _Connection({})
-        client = _Client(project=PROJECT, connection=connection)
-        descriptor = self._makeOne(
-            client=client,
-            type_=TYPE,
-            metric_kind='NOTUSED',
-            value_type='NOTUSED',
-        )
-        descriptor.delete()
-
-        request, = connection._requested
-        expected_request = {'method': 'DELETE', 'path': '/' + NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_fetch(self):
-        PROJECT = 'my-project'
-        TYPE = 'custom.googleapis.com/my_metric'
-        NAME = 'projects/{project}/metricDescriptors/{type}'.format(
-            project=PROJECT, type=TYPE)
-        DESCRIPTION = 'This is my metric.'
-
-        METRIC_DESCRIPTOR = {
-            'name': NAME,
-            'type': TYPE,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION,
-        }
-
-        connection = _Connection(METRIC_DESCRIPTOR)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptor = self._getTargetClass()._fetch(client, TYPE)
-
-        self.assertIs(descriptor.client, client)
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_list(self):
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/metricDescriptors/'.format(project=PROJECT)
-
-        TYPE1 = 'custom.googleapis.com/my_metric_1'
-        DESCRIPTION1 = 'This is my first metric.'
-        NAME1 = PATH + TYPE1
-        METRIC_DESCRIPTOR1 = {
-            'name': NAME1,
-            'type': TYPE1,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION1,
-        }
-
-        TYPE2 = 'custom.googleapis.com/my_metric_2'
-        DESCRIPTION2 = 'This is my second metric.'
-        NAME2 = PATH + TYPE2
-        METRIC_DESCRIPTOR2 = {
-            'name': NAME2,
-            'type': TYPE2,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION2,
-        }
-
-        RESPONSE = {
-            'metricDescriptors': [METRIC_DESCRIPTOR1, METRIC_DESCRIPTOR2],
-        }
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client)
-
-        self.assertEqual(len(descriptors), 2)
-        descriptor1, descriptor2 = descriptors
-
-        self.assertIs(descriptor1.client, client)
-        self.assertEqual(descriptor1.name, NAME1)
-        self.assertEqual(descriptor1.type, TYPE1)
-        self.assertEqual(descriptor1.description, DESCRIPTION1)
-
-        self.assertIs(descriptor2.client, client)
-        self.assertEqual(descriptor2.name, NAME2)
-        self.assertEqual(descriptor2.type, TYPE2)
-        self.assertEqual(descriptor2.description, DESCRIPTION2)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {}}
-        self.assertEqual(request, expected_request)
-
-    def test_list_paged(self):
-        from google.cloud.exceptions import NotFound
-
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/metricDescriptors/'.format(project=PROJECT)
-
-        TYPE1 = 'custom.googleapis.com/my_metric_1'
-        DESCRIPTION1 = 'This is my first metric.'
-        NAME1 = PATH + TYPE1
-        METRIC_DESCRIPTOR1 = {
-            'name': NAME1,
-            'type': TYPE1,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION1,
-        }
-
-        TYPE2 = 'custom.googleapis.com/my_metric_2'
-        DESCRIPTION2 = 'This is my second metric.'
-        NAME2 = PATH + TYPE2
-        METRIC_DESCRIPTOR2 = {
-            'name': NAME2,
-            'type': TYPE2,
-            'metricKind': 'GAUGE',
-            'valueType': 'DOUBLE',
-            'description': DESCRIPTION2,
-        }
-
-        TOKEN = 'second-page-please'
-        RESPONSE1 = {
-            'metricDescriptors': [METRIC_DESCRIPTOR1],
-            'nextPageToken': TOKEN,
-        }
-        RESPONSE2 = {
-            'metricDescriptors': [METRIC_DESCRIPTOR2],
-        }
-
-        connection = _Connection(RESPONSE1, RESPONSE2)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client)
-
-        self.assertEqual(len(descriptors), 2)
-        descriptor1, descriptor2 = descriptors
-
-        self.assertEqual(descriptor1.name, NAME1)
-        self.assertEqual(descriptor1.type, TYPE1)
-        self.assertEqual(descriptor1.description, DESCRIPTION1)
-
-        self.assertEqual(descriptor2.name, NAME2)
-        self.assertEqual(descriptor2.type, TYPE2)
-        self.assertEqual(descriptor2.description, DESCRIPTION2)
-
-        request1, request2 = connection._requested
-        expected_request1 = {'method': 'GET', 'path': '/' + PATH,
-                             'query_params': {}}
-        expected_request2 = {'method': 'GET', 'path': '/' + PATH,
-                             'query_params': {'pageToken': TOKEN}}
-        self.assertEqual(request1, expected_request1)
-        self.assertEqual(request2, expected_request2)
-
-        with self.assertRaises(NotFound):
-            self._getTargetClass()._list(client)
-
-    def test_list_filtered(self):
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/metricDescriptors/'.format(project=PROJECT)
-
-        # Request only custom metrics.
-        FILTER = 'metric.type = starts_with("custom.googleapis.com/")'
-
-        # But let's say there are no custom metrics.
-        RESPONSE = {'metricDescriptors': []}
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client, FILTER)
-
-        self.assertEqual(len(descriptors), 0)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {'filter': FILTER}}
-        self.assertEqual(request, expected_request)
-
-    def test_list_filtered_by_type_prefix(self):
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/metricDescriptors/'.format(project=PROJECT)
-
-        # Request only custom metrics.
-        PREFIX = 'custom.googleapis.com/'
-        FILTER = 'metric.type = starts_with("{prefix}")'.format(prefix=PREFIX)
-
-        # But let's say there are no custom metrics.
-        RESPONSE = {'metricDescriptors': []}
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client, type_prefix=PREFIX)
-
-        self.assertEqual(len(descriptors), 0)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {'filter': FILTER}}
-        self.assertEqual(request, expected_request)
-
-
-class TestMetric(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.metric import Metric
-        return Metric
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        LABELS = {
-            'response_code': 200,
-            'loading': False,
-        }
-        metric = self._makeOne(type=TYPE, labels=LABELS)
-        self.assertEqual(metric.type, TYPE)
-        self.assertEqual(metric.labels, LABELS)
-
-    def test_from_dict(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        LABELS = {
-            'response_code': 200,
-            'loading': False,
-        }
-        info = {
-            'type': TYPE,
-            'labels': LABELS,
-        }
-        metric = self._getTargetClass()._from_dict(info)
-        self.assertEqual(metric.type, TYPE)
-        self.assertEqual(metric.labels, LABELS)
-
-    def test_from_dict_defaults(self):
-        TYPE = 'appengine.googleapis.com/http/server/response_count'
-        info = {'type': TYPE}
-        metric = self._getTargetClass()._from_dict(info)
-        self.assertEqual(metric.type, TYPE)
-        self.assertEqual(metric.labels, {})
-
-    def test_to_dict(self):
-        TYPE = 'custom.googleapis.com/my_metric'
-        LABELS = {}
-        metric = self._makeOne(TYPE, LABELS)
-        expected_dict = {
-            'type': TYPE,
-            'labels': LABELS,
-        }
-        self.assertEquals(metric._to_dict(), expected_dict)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = list(responses)
-        self._requested = []
-
-    def api_request(self, **kwargs):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kwargs)
-        try:
-            return self._responses.pop(0)
-        except IndexError:
-            raise NotFound('miss')
-
-
-class _Client(object):
-
-    def __init__(self, project, connection):
-        self.project = project
-        self.connection = connection
diff --git a/unit_tests/monitoring/test_query.py b/unit_tests/monitoring/test_query.py
deleted file mode 100644
index 0b1a44370baa..000000000000
--- a/unit_tests/monitoring/test_query.py
+++ /dev/null
@@ -1,645 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-PROJECT = 'my-project'
-
-METRIC_TYPE = 'compute.googleapis.com/instance/uptime'
-METRIC_LABELS = {'instance_name': 'instance-1'}
-METRIC_LABELS2 = {'instance_name': 'instance-2'}
-
-RESOURCE_TYPE = 'gce_instance'
-RESOURCE_LABELS = {
-    'project_id': 'my-project',
-    'zone': 'us-east1-a',
-    'instance_id': '1234567890123456789',
-}
-RESOURCE_LABELS2 = {
-    'project_id': 'my-project',
-    'zone': 'us-east1-b',
-    'instance_id': '9876543210987654321',
-}
-
-METRIC_KIND = 'DELTA'
-VALUE_TYPE = 'DOUBLE'
-
-TS0 = '2016-04-06T22:05:00.042Z'
-TS1 = '2016-04-06T22:05:01.042Z'
-TS2 = '2016-04-06T22:05:02.042Z'
-
-
-class TestAligner(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.query import Aligner
-        return Aligner
-
-    def test_one(self):
-        self.assertTrue(hasattr(self._getTargetClass(), 'ALIGN_RATE'))
-
-    def test_names(self):
-        for name in self._getTargetClass().__dict__:
-            if not name.startswith('_'):
-                self.assertEqual(getattr(self._getTargetClass(), name), name)
-
-
-class TestReducer(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.query import Reducer
-        return Reducer
-
-    def test_one(self):
-        self.assertTrue(hasattr(self._getTargetClass(),
-                                'REDUCE_PERCENTILE_99'))
-
-    def test_names(self):
-        for name in self._getTargetClass().__dict__:
-            if not name.startswith('_'):
-                self.assertEqual(getattr(self._getTargetClass(), name), name)
-
-
-class TestQuery(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.query import Query
-        return Query
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    @staticmethod
-    def _make_timestamp(value):
-        from google.cloud._helpers import _datetime_to_rfc3339
-        return _datetime_to_rfc3339(value)
-
-    def test_constructor_minimal(self):
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client)
-
-        self.assertEqual(query._client, client)
-        self.assertEqual(query._filter.metric_type,
-                         self._getTargetClass().DEFAULT_METRIC_TYPE)
-
-        self.assertIsNone(query._start_time)
-        self.assertIsNone(query._end_time)
-
-        self.assertIsNone(query._per_series_aligner)
-        self.assertIsNone(query._alignment_period_seconds)
-        self.assertIsNone(query._cross_series_reducer)
-        self.assertEqual(query._group_by_fields, ())
-
-    def test_constructor_maximal(self):
-        import datetime
-
-        T1 = datetime.datetime(2016, 4, 7, 2, 30, 30)
-        DAYS, HOURS, MINUTES = 1, 2, 3
-        T0 = T1 - datetime.timedelta(days=DAYS, hours=HOURS, minutes=MINUTES)
-
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE,
-                              end_time=T1,
-                              days=DAYS, hours=HOURS, minutes=MINUTES)
-
-        self.assertEqual(query._client, client)
-        self.assertEqual(query._filter.metric_type, METRIC_TYPE)
-
-        self.assertEqual(query._start_time, T0)
-        self.assertEqual(query._end_time, T1)
-
-        self.assertIsNone(query._per_series_aligner)
-        self.assertIsNone(query._alignment_period_seconds)
-        self.assertIsNone(query._cross_series_reducer)
-        self.assertEqual(query._group_by_fields, ())
-
-    def test_constructor_default_end_time(self):
-        import datetime
-        from unit_tests._testing import _Monkey
-        from google.cloud.monitoring import query as MUT
-
-        MINUTES = 5
-        NOW, T0, T1 = [
-            datetime.datetime(2016, 4, 7, 2, 30, 30),
-            datetime.datetime(2016, 4, 7, 2, 25, 0),
-            datetime.datetime(2016, 4, 7, 2, 30, 0),
-        ]
-
-        client = _Client(project=PROJECT, connection=_Connection())
-        with _Monkey(MUT, _UTCNOW=lambda: NOW):
-            query = self._makeOne(client, METRIC_TYPE, minutes=MINUTES)
-
-        self.assertEqual(query._start_time, T0)
-        self.assertEqual(query._end_time, T1)
-
-    def test_constructor_nonzero_duration_illegal(self):
-        import datetime
-        T1 = datetime.datetime(2016, 4, 7, 2, 30, 30)
-        client = _Client(project=PROJECT, connection=_Connection())
-        with self.assertRaises(ValueError):
-            self._makeOne(client, METRIC_TYPE, end_time=T1)
-
-    def test_execution_without_interval_illegal(self):
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        with self.assertRaises(ValueError):
-            list(query)
-
-    def test_metric_type(self):
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        self.assertEqual(query.metric_type, METRIC_TYPE)
-
-    def test_filter(self):
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        expected = 'metric.type = "{type}"'.format(type=METRIC_TYPE)
-        self.assertEqual(query.filter, expected)
-
-    def test_filter_by_group(self):
-        GROUP = '1234567'
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_group(GROUP)
-        expected = (
-            'metric.type = "{type}"'
-            ' AND group.id = "{group}"'
-        ).format(type=METRIC_TYPE, group=GROUP)
-        self.assertEqual(query.filter, expected)
-
-    def test_filter_by_projects(self):
-        PROJECT1, PROJECT2 = 'project-1', 'project-2'
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_projects(PROJECT1, PROJECT2)
-        expected = (
-            'metric.type = "{type}"'
-            ' AND project = "{project1}" OR project = "{project2}"'
-        ).format(type=METRIC_TYPE, project1=PROJECT1, project2=PROJECT2)
-        self.assertEqual(query.filter, expected)
-
-    def test_filter_by_resources(self):
-        ZONE_PREFIX = 'europe-'
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_resources(zone_prefix=ZONE_PREFIX)
-        expected = (
-            'metric.type = "{type}"'
-            ' AND resource.label.zone = starts_with("{prefix}")'
-        ).format(type=METRIC_TYPE, prefix=ZONE_PREFIX)
-        self.assertEqual(query.filter, expected)
-
-    def test_filter_by_metrics(self):
-        INSTANCE = 'my-instance'
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_metrics(instance_name=INSTANCE)
-        expected = (
-            'metric.type = "{type}"'
-            ' AND metric.label.instance_name = "{instance}"'
-        ).format(type=METRIC_TYPE, instance=INSTANCE)
-        self.assertEqual(query.filter, expected)
-
-    def test_request_parameters_minimal(self):
-        import datetime
-
-        T1 = datetime.datetime(2016, 4, 7, 2, 30, 0)
-
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_interval(end_time=T1)
-        actual = list(query._build_query_params())
-        expected = [
-            ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-            ('interval.endTime', self._make_timestamp(T1)),
-        ]
-        self.assertEqual(actual, expected)
-
-    def test_request_parameters_maximal(self):
-        import datetime
-
-        T0 = datetime.datetime(2016, 4, 7, 2, 0, 0)
-        T1 = datetime.datetime(2016, 4, 7, 2, 30, 0)
-
-        ALIGNER = 'ALIGN_DELTA'
-        MINUTES, SECONDS, PERIOD = 1, 30, '90s'
-
-        REDUCER = 'REDUCE_MEAN'
-        FIELD1, FIELD2 = 'resource.zone', 'metric.instance_name'
-
-        PAGE_SIZE = 100
-        PAGE_TOKEN = 'second-page-please'
-
-        client = _Client(project=PROJECT, connection=_Connection())
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_interval(start_time=T0, end_time=T1)
-        query = query.align(ALIGNER, minutes=MINUTES, seconds=SECONDS)
-        query = query.reduce(REDUCER, FIELD1, FIELD2)
-        actual = list(query._build_query_params(headers_only=True,
-                                                page_size=PAGE_SIZE,
-                                                page_token=PAGE_TOKEN))
-        expected = [
-            ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-            ('interval.endTime', self._make_timestamp(T1)),
-            ('interval.startTime', self._make_timestamp(T0)),
-            ('aggregation.perSeriesAligner', ALIGNER),
-            ('aggregation.alignmentPeriod', PERIOD),
-            ('aggregation.crossSeriesReducer', REDUCER),
-            ('aggregation.groupByFields', FIELD1),
-            ('aggregation.groupByFields', FIELD2),
-            ('view', 'HEADERS'),
-            ('pageSize', PAGE_SIZE),
-            ('pageToken', PAGE_TOKEN),
-        ]
-        self.assertEqual(actual, expected)
-
-    def test_iteration(self):
-        import datetime
-
-        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
-        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
-
-        INTERVAL1 = {'startTime': TS0, 'endTime': TS1}
-        INTERVAL2 = {'startTime': TS1, 'endTime': TS2}
-
-        VALUE1 = 60  # seconds
-        VALUE2 = 60.001  # seconds
-
-        SERIES1 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [
-                {'interval': INTERVAL2, 'value': {'doubleValue': VALUE1}},
-                {'interval': INTERVAL1, 'value': {'doubleValue': VALUE1}},
-            ],
-        }
-        SERIES2 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS2},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS2},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [
-                {'interval': INTERVAL2, 'value': {'doubleValue': VALUE2}},
-                {'interval': INTERVAL1, 'value': {'doubleValue': VALUE2}},
-            ],
-        }
-
-        RESPONSE = {'timeSeries': [SERIES1, SERIES2]}
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_interval(start_time=T0, end_time=T1)
-        response = list(query)
-
-        self.assertEqual(len(response), 2)
-        series1, series2 = response
-
-        self.assertEqual(series1.metric.labels, METRIC_LABELS)
-        self.assertEqual(series2.metric.labels, METRIC_LABELS2)
-        self.assertEqual(series1.resource.labels, RESOURCE_LABELS)
-        self.assertEqual(series2.resource.labels, RESOURCE_LABELS2)
-
-        self.assertEqual([p.value for p in series1.points], [VALUE1, VALUE1])
-        self.assertEqual([p.value for p in series2.points], [VALUE2, VALUE2])
-        self.assertEqual([p.end_time for p in series1.points], [TS1, TS2])
-        self.assertEqual([p.end_time for p in series2.points], [TS1, TS2])
-
-        expected_request = {
-            'method': 'GET',
-            'path': '/projects/{project}/timeSeries/'.format(project=PROJECT),
-            'query_params': [
-                ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-                ('interval.endTime', self._make_timestamp(T1)),
-                ('interval.startTime', self._make_timestamp(T0)),
-            ],
-        }
-
-        request, = connection._requested
-        self.assertEqual(request, expected_request)
-
-    def test_iteration_paged(self):
-        import copy
-        import datetime
-        from google.cloud.exceptions import NotFound
-
-        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
-        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
-
-        INTERVAL1 = {'startTime': TS0, 'endTime': TS1}
-        INTERVAL2 = {'startTime': TS1, 'endTime': TS2}
-
-        VALUE1 = 60  # seconds
-        VALUE2 = 60.001  # seconds
-
-        SERIES1 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [
-                {'interval': INTERVAL2, 'value': {'doubleValue': VALUE1}},
-                {'interval': INTERVAL1, 'value': {'doubleValue': VALUE1}},
-            ],
-        }
-        SERIES2_PART1 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS2},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS2},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [
-                {'interval': INTERVAL2, 'value': {'doubleValue': VALUE2}},
-            ],
-        }
-        SERIES2_PART2 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS2},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS2},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [
-                {'interval': INTERVAL1, 'value': {'doubleValue': VALUE2}},
-            ],
-        }
-
-        TOKEN = 'second-page-please'
-        RESPONSE1 = {'timeSeries': [SERIES1, SERIES2_PART1],
-                     'nextPageToken': TOKEN}
-        RESPONSE2 = {'timeSeries': [SERIES2_PART2]}
-
-        connection = _Connection(RESPONSE1, RESPONSE2)
-        client = _Client(project=PROJECT, connection=connection)
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_interval(start_time=T0, end_time=T1)
-        response = list(query)
-
-        self.assertEqual(len(response), 2)
-        series1, series2 = response
-
-        self.assertEqual(series1.metric.labels, METRIC_LABELS)
-        self.assertEqual(series2.metric.labels, METRIC_LABELS2)
-        self.assertEqual(series1.resource.labels, RESOURCE_LABELS)
-        self.assertEqual(series2.resource.labels, RESOURCE_LABELS2)
-
-        self.assertEqual([p.value for p in series1.points], [VALUE1, VALUE1])
-        self.assertEqual([p.value for p in series2.points], [VALUE2, VALUE2])
-        self.assertEqual([p.end_time for p in series1.points], [TS1, TS2])
-        self.assertEqual([p.end_time for p in series2.points], [TS1, TS2])
-
-        expected_request1 = {
-            'method': 'GET',
-            'path': '/projects/{project}/timeSeries/'.format(project=PROJECT),
-            'query_params': [
-                ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-                ('interval.endTime', self._make_timestamp(T1)),
-                ('interval.startTime', self._make_timestamp(T0)),
-            ],
-        }
-
-        expected_request2 = copy.deepcopy(expected_request1)
-        expected_request2['query_params'].append(('pageToken', TOKEN))
-
-        request1, request2 = connection._requested
-        self.assertEqual(request1, expected_request1)
-        self.assertEqual(request2, expected_request2)
-
-        with self.assertRaises(NotFound):
-            list(query)
-
-    def test_iteration_empty(self):
-        import datetime
-
-        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
-        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
-
-        connection = _Connection({})
-        client = _Client(project=PROJECT, connection=connection)
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_interval(start_time=T0, end_time=T1)
-        response = list(query)
-
-        self.assertEqual(len(response), 0)
-
-        expected_request = {
-            'method': 'GET',
-            'path': '/projects/{project}/timeSeries/'.format(project=PROJECT),
-            'query_params': [
-                ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-                ('interval.endTime', self._make_timestamp(T1)),
-                ('interval.startTime', self._make_timestamp(T0)),
-            ],
-        }
-        request, = connection._requested
-        self.assertEqual(request, expected_request)
-
-    def test_iteration_headers_only(self):
-        import datetime
-
-        T0 = datetime.datetime(2016, 4, 6, 22, 5, 0)
-        T1 = datetime.datetime(2016, 4, 6, 22, 10, 0)
-
-        SERIES1 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-        }
-        SERIES2 = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS2},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS2},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-        }
-
-        RESPONSE = {'timeSeries': [SERIES1, SERIES2]}
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        query = self._makeOne(client, METRIC_TYPE)
-        query = query.select_interval(start_time=T0, end_time=T1)
-        response = list(query.iter(headers_only=True))
-
-        self.assertEqual(len(response), 2)
-        series1, series2 = response
-
-        self.assertEqual(series1.metric.labels, METRIC_LABELS)
-        self.assertEqual(series2.metric.labels, METRIC_LABELS2)
-        self.assertEqual(series1.resource.labels, RESOURCE_LABELS)
-        self.assertEqual(series2.resource.labels, RESOURCE_LABELS2)
-
-        self.assertEqual(series1.points, [])
-        self.assertEqual(series2.points, [])
-
-        expected_request = {
-            'method': 'GET',
-            'path': '/projects/{project}/timeSeries/'.format(project=PROJECT),
-            'query_params': [
-                ('filter', 'metric.type = "{type}"'.format(type=METRIC_TYPE)),
-                ('interval.endTime', self._make_timestamp(T1)),
-                ('interval.startTime', self._make_timestamp(T0)),
-                ('view', 'HEADERS'),
-            ],
-        }
-
-        request, = connection._requested
-        self.assertEqual(request, expected_request)
-
-
-class Test_Filter(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.query import _Filter
-        return _Filter
-
-    def _makeOne(self, metric_type):
-        return self._getTargetClass()(metric_type)
-
-    def test_minimal(self):
-        obj = self._makeOne(METRIC_TYPE)
-        expected = 'metric.type = "{type}"'.format(type=METRIC_TYPE)
-        self.assertEqual(str(obj), expected)
-
-    def test_maximal(self):
-        obj = self._makeOne(METRIC_TYPE)
-        obj.group_id = '1234567'
-        obj.projects = 'project-1', 'project-2'
-        obj.select_resources(resource_type='some-resource',
-                             resource_label='foo')
-        obj.select_metrics(metric_label_prefix='bar-')
-
-        expected = (
-            'metric.type = "{type}"'
-            ' AND group.id = "1234567"'
-            ' AND project = "project-1" OR project = "project-2"'
-            ' AND resource.label.resource_label = "foo"'
-            ' AND resource.type = "some-resource"'
-            ' AND metric.label.metric_label = starts_with("bar-")'
-        ).format(type=METRIC_TYPE)
-
-        self.assertEqual(str(obj), expected)
-
-
-class Test__build_label_filter(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.monitoring.query import _build_label_filter
-        return _build_label_filter(*args, **kwargs)
-
-    def test_no_labels(self):
-        self.assertEqual(self._callFUT('resource'), '')
-
-    def test_label_is_none(self):
-        self.assertEqual(self._callFUT('resource', foo=None), '')
-
-    def test_metric_labels(self):
-        actual = self._callFUT(
-            'metric',
-            alpha_prefix='a-',
-            beta_gamma_suffix='-b',
-            delta_epsilon='xyz',
-        )
-        expected = (
-            'metric.label.alpha = starts_with("a-")'
-            ' AND metric.label.beta_gamma = ends_with("-b")'
-            ' AND metric.label.delta_epsilon = "xyz"'
-        )
-        self.assertEqual(actual, expected)
-
-    def test_metric_label_response_code_greater_less(self):
-        actual = self._callFUT(
-            'metric',
-            response_code_greater=500,
-            response_code_less=600)
-        expected = (
-            'metric.label.response_code < 600'
-            ' AND metric.label.response_code > 500'
-        )
-        self.assertEqual(actual, expected)
-
-    def test_metric_label_response_code_greater_less_equal(self):
-        actual = self._callFUT(
-            'metric',
-            response_code_greaterequal=500,
-            response_code_lessequal=600)
-        expected = (
-            'metric.label.response_code <= 600'
-            ' AND metric.label.response_code >= 500'
-        )
-        self.assertEqual(actual, expected)
-
-    def test_resource_labels(self):
-        actual = self._callFUT(
-            'resource',
-            alpha_prefix='a-',
-            beta_gamma_suffix='-b',
-            delta_epsilon='xyz',
-        )
-        expected = (
-            'resource.label.alpha = starts_with("a-")'
-            ' AND resource.label.beta_gamma = ends_with("-b")'
-            ' AND resource.label.delta_epsilon = "xyz"'
-        )
-        self.assertEqual(actual, expected)
-
-    def test_raw_label_filters(self):
-        actual = self._callFUT(
-            'resource',
-            'resource.label.alpha = starts_with("a-")',
-            'resource.label.beta_gamma = ends_with("-b")',
-            'resource.label.delta_epsilon = "xyz"',
-        )
-        expected = (
-            'resource.label.alpha = starts_with("a-")'
-            ' AND resource.label.beta_gamma = ends_with("-b")'
-            ' AND resource.label.delta_epsilon = "xyz"'
-        )
-        self.assertEqual(actual, expected)
-
-    def test_resource_type(self):
-        actual = self._callFUT('resource', resource_type='foo')
-        expected = 'resource.type = "foo"'
-        self.assertEqual(actual, expected)
-
-    def test_resource_type_prefix(self):
-        actual = self._callFUT('resource', resource_type_prefix='foo-')
-        expected = 'resource.type = starts_with("foo-")'
-        self.assertEqual(actual, expected)
-
-    def test_resource_type_suffix(self):
-        actual = self._callFUT('resource', resource_type_suffix='-foo')
-        expected = 'resource.type = ends_with("-foo")'
-        self.assertEqual(actual, expected)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = list(responses)
-        self._requested = []
-
-    def api_request(self, **kwargs):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kwargs)
-        try:
-            return self._responses.pop(0)
-        except IndexError:
-            raise NotFound('miss')
-
-
-class _Client(object):
-
-    def __init__(self, project, connection):
-        self.project = project
-        self.connection = connection
diff --git a/unit_tests/monitoring/test_resource.py b/unit_tests/monitoring/test_resource.py
deleted file mode 100644
index 5e3cac503b01..000000000000
--- a/unit_tests/monitoring/test_resource.py
+++ /dev/null
@@ -1,352 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestResourceDescriptor(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.resource import ResourceDescriptor
-        return ResourceDescriptor
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        from google.cloud.monitoring.label import LabelDescriptor
-
-        TYPE = 'gce_instance'
-        NAME = 'projects/my-project/monitoredResourceDescriptors/' + TYPE
-        DISPLAY_NAME = 'GCE Instance'
-        DESCRIPTION = 'A VM instance hosted in Google Compute Engine.'
-        LABELS = [
-            LabelDescriptor(key='project_id', value_type='STRING',
-                            description='The ID of the GCP project...'),
-            LabelDescriptor(key='instance_id', value_type='STRING',
-                            description='The VM instance identifier...'),
-            LabelDescriptor(key='zone', value_type='STRING',
-                            description='The GCE zone...'),
-        ]
-
-        descriptor = self._makeOne(
-            name=NAME,
-            type_=TYPE,
-            display_name=DISPLAY_NAME,
-            description=DESCRIPTION,
-            labels=LABELS,
-        )
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.display_name, DISPLAY_NAME)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-        self.assertEqual(descriptor.labels, LABELS)
-
-    def test_from_dict(self):
-        TYPE = 'gce_instance'
-        NAME = 'projects/my-project/monitoredResourceDescriptors/' + TYPE
-        DISPLAY_NAME = 'GCE Instance'
-        DESCRIPTION = 'A VM instance hosted in Google Compute Engine.'
-        LABEL1 = {'key': 'project_id', 'valueType': 'STRING',
-                  'description': 'The ID of the GCP project...'}
-        LABEL2 = {'key': 'instance_id', 'valueType': 'STRING',
-                  'description': 'The VM instance identifier...'}
-        LABEL3 = {'key': 'zone', 'valueType': 'STRING',
-                  'description': 'The GCE zone...'}
-
-        info = {
-            'name': NAME,
-            'type': TYPE,
-            'displayName': DISPLAY_NAME,
-            'description': DESCRIPTION,
-            'labels': [LABEL1, LABEL2, LABEL3],
-        }
-        descriptor = self._getTargetClass()._from_dict(info)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.display_name, DISPLAY_NAME)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-        self.assertEqual(len(descriptor.labels), 3)
-        label1, label2, label3 = descriptor.labels
-        self.assertEqual(label1.key, LABEL1['key'])
-        self.assertEqual(label2.key, LABEL2['key'])
-        self.assertEqual(label3.key, LABEL3['key'])
-
-    def test_from_dict_defaults(self):
-        TYPE = 'gce_instance'
-        NAME = 'projects/my-project/monitoredResourceDescriptors/' + TYPE
-
-        info = {
-            'name': NAME,
-            'type': TYPE,
-        }
-        descriptor = self._getTargetClass()._from_dict(info)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.display_name, '')
-        self.assertEqual(descriptor.description, '')
-        self.assertEqual(descriptor.labels, ())
-
-    def test_fetch(self):
-        PROJECT = 'my-project'
-        TYPE = 'gce_instance'
-        NAME = 'projects/{project}/monitoredResourceDescriptors/{type}'.format(
-            project=PROJECT, type=TYPE)
-        DISPLAY_NAME = 'GCE Instance'
-        DESCRIPTION = 'A VM instance hosted in Google Compute Engine.'
-        LABEL1 = {'key': 'project_id', 'valueType': 'STRING',
-                  'description': 'The ID of the GCP project...'}
-        LABEL2 = {'key': 'instance_id', 'valueType': 'STRING',
-                  'description': 'The VM instance identifier...'}
-        LABEL3 = {'key': 'zone', 'valueType': 'STRING',
-                  'description': 'The GCE zone...'}
-
-        RESOURCE_DESCRIPTOR = {
-            'name': NAME,
-            'type': TYPE,
-            'displayName': DISPLAY_NAME,
-            'description': DESCRIPTION,
-            'labels': [LABEL1, LABEL2, LABEL3],
-        }
-
-        connection = _Connection(RESOURCE_DESCRIPTOR)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptor = self._getTargetClass()._fetch(client, TYPE)
-
-        self.assertEqual(descriptor.name, NAME)
-        self.assertEqual(descriptor.type, TYPE)
-        self.assertEqual(descriptor.display_name, DISPLAY_NAME)
-        self.assertEqual(descriptor.description, DESCRIPTION)
-
-        self.assertEqual(len(descriptor.labels), 3)
-        label1, label2, label3 = descriptor.labels
-        self.assertEqual(label1.key, LABEL1['key'])
-        self.assertEqual(label2.key, LABEL2['key'])
-        self.assertEqual(label3.key, LABEL3['key'])
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + NAME}
-        self.assertEqual(request, expected_request)
-
-    def test_list(self):
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/monitoredResourceDescriptors/'.format(
-            project=PROJECT)
-
-        TYPE1 = 'custom.googleapis.com/resource-1'
-        DESCRIPTION1 = 'This is the first resource.'
-        NAME1 = PATH + TYPE1
-        RESOURCE_DESCRIPTOR1 = {
-            'name': NAME1,
-            'type': TYPE1,
-            'description': DESCRIPTION1,
-        }
-
-        TYPE2 = 'custom.googleapis.com/resource-2'
-        DESCRIPTION2 = 'This is the second resource.'
-        NAME2 = PATH + TYPE2
-        RESOURCE_DESCRIPTOR2 = {
-            'name': NAME2,
-            'type': TYPE2,
-            'description': DESCRIPTION2,
-        }
-
-        RESPONSE = {
-            'resourceDescriptors':
-                [RESOURCE_DESCRIPTOR1, RESOURCE_DESCRIPTOR2],
-        }
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client)
-
-        self.assertEqual(len(descriptors), 2)
-        descriptor1, descriptor2 = descriptors
-
-        self.assertEqual(descriptor1.name, NAME1)
-        self.assertEqual(descriptor1.type, TYPE1)
-        self.assertEqual(descriptor1.description, DESCRIPTION1)
-
-        self.assertEqual(descriptor2.name, NAME2)
-        self.assertEqual(descriptor2.type, TYPE2)
-        self.assertEqual(descriptor2.description, DESCRIPTION2)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {}}
-        self.assertEqual(request, expected_request)
-
-    def test_list_paged(self):
-        from google.cloud.exceptions import NotFound
-
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/monitoredResourceDescriptors/'.format(
-            project=PROJECT)
-
-        TYPE1 = 'custom.googleapis.com/resource-1'
-        DESCRIPTION1 = 'This is the first resource.'
-        NAME1 = PATH + TYPE1
-        RESOURCE_DESCRIPTOR1 = {
-            'name': NAME1,
-            'type': TYPE1,
-            'description': DESCRIPTION1,
-        }
-
-        TYPE2 = 'custom.googleapis.com/resource-2'
-        DESCRIPTION2 = 'This is the second resource.'
-        NAME2 = PATH + TYPE2
-        RESOURCE_DESCRIPTOR2 = {
-            'name': NAME2,
-            'type': TYPE2,
-            'description': DESCRIPTION2,
-        }
-
-        TOKEN = 'second-page-please'
-        RESPONSE1 = {
-            'resourceDescriptors': [RESOURCE_DESCRIPTOR1],
-            'nextPageToken': TOKEN,
-        }
-        RESPONSE2 = {
-            'resourceDescriptors': [RESOURCE_DESCRIPTOR2],
-        }
-
-        connection = _Connection(RESPONSE1, RESPONSE2)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client)
-
-        self.assertEqual(len(descriptors), 2)
-        descriptor1, descriptor2 = descriptors
-
-        self.assertEqual(descriptor1.name, NAME1)
-        self.assertEqual(descriptor1.type, TYPE1)
-        self.assertEqual(descriptor1.description, DESCRIPTION1)
-
-        self.assertEqual(descriptor2.name, NAME2)
-        self.assertEqual(descriptor2.type, TYPE2)
-        self.assertEqual(descriptor2.description, DESCRIPTION2)
-
-        request1, request2 = connection._requested
-        expected_request1 = {'method': 'GET', 'path': '/' + PATH,
-                             'query_params': {}}
-        expected_request2 = {'method': 'GET', 'path': '/' + PATH,
-                             'query_params': {'pageToken': TOKEN}}
-        self.assertEqual(request1, expected_request1)
-        self.assertEqual(request2, expected_request2)
-
-        with self.assertRaises(NotFound):
-            self._getTargetClass()._list(client)
-
-    def test_list_filtered(self):
-        PROJECT = 'my-project'
-        PATH = 'projects/{project}/monitoredResourceDescriptors/'.format(
-            project=PROJECT)
-
-        # Request only resources with type names that start with "foobar_".
-        FILTER = 'resource.type = starts_with("foobar_")'
-
-        # But there are none.
-        RESPONSE = {'resourceDescriptors': []}
-
-        connection = _Connection(RESPONSE)
-        client = _Client(project=PROJECT, connection=connection)
-        descriptors = self._getTargetClass()._list(client, FILTER)
-
-        self.assertEqual(len(descriptors), 0)
-
-        request, = connection._requested
-        expected_request = {'method': 'GET', 'path': '/' + PATH,
-                            'query_params': {'filter': FILTER}}
-        self.assertEqual(request, expected_request)
-
-
-class TestResource(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.monitoring.resource import Resource
-        return Resource
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        TYPE = 'gce_instance'
-        LABELS = {
-            'project_id': 'my-project',
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-a',
-        }
-        resource = self._makeOne(type=TYPE, labels=LABELS)
-        self.assertEqual(resource.type, TYPE)
-        self.assertEqual(resource.labels, LABELS)
-
-    def test_from_dict(self):
-        TYPE = 'gce_instance'
-        LABELS = {
-            'project_id': 'my-project',
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-a',
-        }
-        info = {
-            'type': TYPE,
-            'labels': LABELS,
-        }
-        resource = self._getTargetClass()._from_dict(info)
-        self.assertEqual(resource.type, TYPE)
-        self.assertEqual(resource.labels, LABELS)
-
-    def test_from_dict_defaults(self):
-        TYPE = 'gce_instance'
-        info = {'type': TYPE}
-        resource = self._getTargetClass()._from_dict(info)
-        self.assertEqual(resource.type, TYPE)
-        self.assertEqual(resource.labels, {})
-
-    def test_to_dict(self):
-        TYPE = 'gce_instance'
-        LABELS = {
-            'instance_id': '1234567890123456789',
-            'zone': 'us-central1-a',
-        }
-        resource = self._makeOne(TYPE, LABELS)
-        expected_dict = {
-            'type': TYPE,
-            'labels': LABELS,
-        }
-        self.assertEquals(resource._to_dict(), expected_dict)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = list(responses)
-        self._requested = []
-
-    def api_request(self, **kwargs):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kwargs)
-        try:
-            return self._responses.pop(0)
-        except IndexError:
-            raise NotFound('miss')
-
-
-class _Client(object):
-
-    def __init__(self, project, connection):
-        self.project = project
-        self.connection = connection
diff --git a/unit_tests/monitoring/test_timeseries.py b/unit_tests/monitoring/test_timeseries.py
deleted file mode 100644
index ca724b6b197e..000000000000
--- a/unit_tests/monitoring/test_timeseries.py
+++ /dev/null
@@ -1,265 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-METRIC_TYPE = 'compute.googleapis.com/instance/uptime'
-METRIC_LABELS = {'instance_name': 'instance-1'}
-
-RESOURCE_TYPE = 'gce_instance'
-RESOURCE_LABELS = {
-    'project_id': 'my-project',
-    'zone': 'us-east1-a',
-    'instance_id': '1234567890123456789',
-}
-
-METRIC_KIND = 'DELTA'
-VALUE_TYPE = 'DOUBLE'
-
-TS0 = '2016-04-06T22:05:00.042Z'
-TS1 = '2016-04-06T22:05:01.042Z'
-TS2 = '2016-04-06T22:05:02.042Z'
-
-
-class TestTimeSeries(unittest.TestCase):
-    def _getTargetClass(self):
-        from google.cloud.monitoring.timeseries import TimeSeries
-        return TimeSeries
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        from google.cloud.monitoring.metric import Metric
-        from google.cloud.monitoring.resource import Resource
-        from google.cloud.monitoring.timeseries import Point
-
-        VALUE = 60  # seconds
-
-        METRIC = Metric(type=METRIC_TYPE, labels=METRIC_LABELS)
-        RESOURCE = Resource(type=RESOURCE_TYPE, labels=RESOURCE_LABELS)
-        POINTS = [
-            Point(start_time=TS0, end_time=TS1, value=VALUE),
-            Point(start_time=TS1, end_time=TS2, value=VALUE),
-        ]
-
-        series = self._makeOne(metric=METRIC,
-                               resource=RESOURCE,
-                               metric_kind=METRIC_KIND,
-                               value_type=VALUE_TYPE,
-                               points=POINTS)
-
-        self.assertEqual(series.metric, METRIC)
-        self.assertEqual(series.resource, RESOURCE)
-        self.assertEqual(series.metric_kind, METRIC_KIND)
-        self.assertEqual(series.value_type, VALUE_TYPE)
-        self.assertEqual(series.points, POINTS)
-
-    def test_from_dict(self):
-        VALUE = 60  # seconds
-
-        info = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-            'points': [
-                {
-                    'interval': {'startTime': TS0, 'endTime': TS1},
-                    'value': {'doubleValue': VALUE},
-                },
-                {
-                    'interval': {'startTime': TS1, 'endTime': TS2},
-                    'value': {'doubleValue': VALUE},
-                },
-            ],
-        }
-
-        series = self._getTargetClass()._from_dict(info)
-
-        self.assertEqual(series.metric.type, METRIC_TYPE)
-        self.assertEqual(series.metric.labels, METRIC_LABELS)
-        self.assertEqual(series.resource.type, RESOURCE_TYPE)
-        self.assertEqual(series.resource.labels, RESOURCE_LABELS)
-
-        self.assertEqual(series.metric_kind, METRIC_KIND)
-        self.assertEqual(series.value_type, VALUE_TYPE)
-
-        self.assertEqual(len(series.points), 2)
-        point1, point2 = series.points
-
-        self.assertEqual(point1.start_time, TS0)
-        self.assertEqual(point1.end_time, TS1)
-        self.assertEqual(point1.value, VALUE)
-
-        self.assertEqual(point2.start_time, TS1)
-        self.assertEqual(point2.end_time, TS2)
-        self.assertEqual(point2.value, VALUE)
-
-    def test_from_dict_no_points(self):
-        info = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-        }
-
-        series = self._getTargetClass()._from_dict(info)
-
-        self.assertEqual(series.metric.type, METRIC_TYPE)
-        self.assertEqual(series.metric.labels, METRIC_LABELS)
-        self.assertEqual(series.resource.type, RESOURCE_TYPE)
-        self.assertEqual(series.resource.labels, RESOURCE_LABELS)
-
-        self.assertEqual(series.metric_kind, METRIC_KIND)
-        self.assertEqual(series.value_type, VALUE_TYPE)
-
-        self.assertEqual(series.points, [])
-
-    def test_labels(self):
-        info = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'metricKind': METRIC_KIND,
-            'valueType': VALUE_TYPE,
-        }
-
-        series = self._getTargetClass()._from_dict(info)
-
-        labels = {'resource_type': RESOURCE_TYPE}
-        labels.update(RESOURCE_LABELS)
-        labels.update(METRIC_LABELS)
-
-        self.assertIsNone(series._labels)
-        self.assertEqual(series.labels, labels)
-        self.assertIsNotNone(series._labels)
-        self.assertEqual(series.labels, labels)
-
-    def test_to_dict(self):
-        import datetime
-        from google.cloud._helpers import _datetime_to_rfc3339
-
-        from google.cloud.monitoring.metric import Metric
-        from google.cloud.monitoring.resource import Resource
-        from google.cloud.monitoring.timeseries import Point
-
-        VALUE = 42
-        end_time = datetime.datetime.now()
-        end_time_str = _datetime_to_rfc3339(end_time, ignore_zone=False)
-
-        METRIC = Metric(type=METRIC_TYPE, labels=METRIC_LABELS)
-        RESOURCE = Resource(type=RESOURCE_TYPE, labels=RESOURCE_LABELS)
-        POINT = Point(start_time=None, end_time=end_time_str, value=VALUE)
-
-        info = {
-            'metric': {'type': METRIC_TYPE, 'labels': METRIC_LABELS},
-            'resource': {'type': RESOURCE_TYPE, 'labels': RESOURCE_LABELS},
-            'points': [{
-                'interval': {
-                    'endTime': end_time_str},
-                'value': {'int64Value': str(VALUE)},
-            }]
-        }
-
-        series = self._makeOne(metric=METRIC, resource=RESOURCE,
-                               metric_kind=None, value_type=None,
-                               points=[POINT])
-        series_dict = series._to_dict()
-        self.assertEqual(info, series_dict)
-
-
-class TestPoint(unittest.TestCase):
-    def _getTargetClass(self):
-        from google.cloud.monitoring.timeseries import Point
-        return Point
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        VALUE = 3.14
-        point = self._makeOne(start_time=TS0, end_time=TS1, value=VALUE)
-        self.assertEqual(point.start_time, TS0)
-        self.assertEqual(point.end_time, TS1)
-        self.assertEqual(point.value, VALUE)
-
-    def test_from_dict(self):
-        VALUE = 3.14
-        info = {
-            'interval': {'startTime': TS0, 'endTime': TS1},
-            'value': {'doubleValue': VALUE},
-        }
-        point = self._getTargetClass()._from_dict(info)
-        self.assertEqual(point.start_time, TS0)
-        self.assertEqual(point.end_time, TS1)
-        self.assertEqual(point.value, VALUE)
-
-    def test_from_dict_defaults(self):
-        VALUE = 3.14
-        info = {
-            'interval': {'endTime': TS1},
-            'value': {'doubleValue': VALUE},
-        }
-        point = self._getTargetClass()._from_dict(info)
-        self.assertIsNone(point.start_time)
-        self.assertEqual(point.end_time, TS1)
-        self.assertEqual(point.value, VALUE)
-
-    def test_from_dict_int64(self):
-        VALUE = 2 ** 63 - 1
-        info = {
-            'interval': {'endTime': TS1},
-            'value': {'int64Value': str(VALUE)},
-        }
-        point = self._getTargetClass()._from_dict(info)
-        self.assertIsNone(point.start_time)
-        self.assertEqual(point.end_time, TS1)
-        self.assertEqual(point.value, VALUE)
-
-    def test_to_dict_int64(self):
-        import datetime
-        from google.cloud._helpers import _datetime_to_rfc3339
-        VALUE = 42
-        end_time = datetime.datetime.now()
-        end_time_str = _datetime_to_rfc3339(end_time, ignore_zone=False)
-        point = self._makeOne(end_time=end_time_str, start_time=None,
-                              value=VALUE)
-        info = {
-            'interval': {'endTime': end_time_str},
-            'value': {'int64Value': str(VALUE)},
-        }
-
-        point_dict = point._to_dict()
-        self.assertEqual(info, point_dict)
-
-    def test_to_dict_float_with_start_time(self):
-        import datetime
-        from google.cloud._helpers import _datetime_to_rfc3339
-        VALUE = 1.6180339
-        start_time = datetime.datetime.now()
-        start_time_str = _datetime_to_rfc3339(start_time, ignore_zone=False)
-        end_time = datetime.datetime.now()
-        end_time_str = _datetime_to_rfc3339(end_time, ignore_zone=False)
-
-        point = self._makeOne(end_time=end_time_str, start_time=start_time_str,
-                              value=VALUE)
-        info = {
-            'interval': {
-                'startTime': start_time_str,
-                'endTime': end_time_str},
-            'value': {'doubleValue': VALUE},
-        }
-
-        point_dict = point._to_dict()
-        self.assertEqual(info, point_dict)
diff --git a/unit_tests/pubsub/__init__.py b/unit_tests/pubsub/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/pubsub/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/pubsub/test__gax.py b/unit_tests/pubsub/test__gax.py
deleted file mode 100644
index ad7752c17aa6..000000000000
--- a/unit_tests/pubsub/test__gax.py
+++ /dev/null
@@ -1,1045 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-try:
-    # pylint: disable=unused-import
-    import google.cloud.pubsub._gax
-    # pylint: enable=unused-import
-except ImportError:  # pragma: NO COVER
-    _HAVE_GAX = False
-else:
-    _HAVE_GAX = True
-
-from unit_tests._testing import _GAXBaseAPI
-
-
-class _Base(object):
-    PROJECT = 'PROJECT'
-    PROJECT_PATH = 'projects/%s' % (PROJECT,)
-    LIST_TOPICS_PATH = '%s/topics' % (PROJECT_PATH,)
-    TOPIC_NAME = 'topic_name'
-    TOPIC_PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-    LIST_TOPIC_SUBSCRIPTIONS_PATH = '%s/subscriptions' % (TOPIC_PATH,)
-    SUB_NAME = 'sub_name'
-    SUB_PATH = '%s/subscriptions/%s' % (TOPIC_PATH, SUB_NAME)
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_PublisherAPI(_Base, unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub._gax import _PublisherAPI
-        return _PublisherAPI
-
-    def test_ctor(self):
-        gax_api = _GAXPublisherAPI()
-        api = self._makeOne(gax_api)
-        self.assertIs(api._gax_api, gax_api)
-
-    def test_list_topics_no_paging(self):
-        from google.gax import INITIAL_PAGE
-        from unit_tests._testing import _GAXPageIterator
-        TOKEN = 'TOKEN'
-        response = _GAXPageIterator([_TopicPB(self.TOPIC_PATH)], TOKEN)
-        gax_api = _GAXPublisherAPI(_list_topics_response=response)
-        api = self._makeOne(gax_api)
-
-        topics, next_token = api.list_topics(self.PROJECT)
-
-        self.assertEqual(len(topics), 1)
-        topic = topics[0]
-        self.assertIsInstance(topic, dict)
-        self.assertEqual(topic['name'], self.TOPIC_PATH)
-        self.assertEqual(next_token, TOKEN)
-
-        name, page_size, options = gax_api._list_topics_called_with
-        self.assertEqual(name, self.PROJECT_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertIs(options.page_token, INITIAL_PAGE)
-
-    def test_list_topics_with_paging(self):
-        from unit_tests._testing import _GAXPageIterator
-        SIZE = 23
-        TOKEN = 'TOKEN'
-        NEW_TOKEN = 'NEW_TOKEN'
-        response = _GAXPageIterator(
-            [_TopicPB(self.TOPIC_PATH)], NEW_TOKEN)
-        gax_api = _GAXPublisherAPI(_list_topics_response=response)
-        api = self._makeOne(gax_api)
-
-        topics, next_token = api.list_topics(
-            self.PROJECT, page_size=SIZE, page_token=TOKEN)
-
-        self.assertEqual(len(topics), 1)
-        topic = topics[0]
-        self.assertIsInstance(topic, dict)
-        self.assertEqual(topic['name'], self.TOPIC_PATH)
-        self.assertEqual(next_token, NEW_TOKEN)
-
-        name, page_size, options = gax_api._list_topics_called_with
-        self.assertEqual(name, self.PROJECT_PATH)
-        self.assertEqual(page_size, SIZE)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_topic_create(self):
-        topic_pb = _TopicPB(self.TOPIC_PATH)
-        gax_api = _GAXPublisherAPI(_create_topic_response=topic_pb)
-        api = self._makeOne(gax_api)
-
-        resource = api.topic_create(self.TOPIC_PATH)
-
-        self.assertEqual(resource, {'name': self.TOPIC_PATH})
-        topic_path, options = gax_api._create_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_create_already_exists(self):
-        from google.cloud.exceptions import Conflict
-        gax_api = _GAXPublisherAPI(_create_topic_conflict=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(Conflict):
-            api.topic_create(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._create_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_create_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXPublisherAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.topic_create(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._create_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_get_hit(self):
-        topic_pb = _TopicPB(self.TOPIC_PATH)
-        gax_api = _GAXPublisherAPI(_get_topic_response=topic_pb)
-        api = self._makeOne(gax_api)
-
-        resource = api.topic_get(self.TOPIC_PATH)
-
-        self.assertEqual(resource, {'name': self.TOPIC_PATH})
-        topic_path, options = gax_api._get_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_get_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXPublisherAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.topic_get(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._get_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_get_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXPublisherAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.topic_get(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._get_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_delete_hit(self):
-        gax_api = _GAXPublisherAPI(_delete_topic_ok=True)
-        api = self._makeOne(gax_api)
-
-        api.topic_delete(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._delete_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXPublisherAPI(_delete_topic_ok=False)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.topic_delete(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._delete_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_delete_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXPublisherAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.topic_delete(self.TOPIC_PATH)
-
-        topic_path, options = gax_api._delete_topic_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_topic_publish_hit(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MSGID = 'DEADBEEF'
-        MESSAGE = {'data': B64, 'attributes': {}}
-        response = _PublishResponsePB([MSGID])
-        gax_api = _GAXPublisherAPI(_publish_response=response)
-        api = self._makeOne(gax_api)
-
-        resource = api.topic_publish(self.TOPIC_PATH, [MESSAGE])
-
-        self.assertEqual(resource, [MSGID])
-        topic_path, message_pbs, options = gax_api._publish_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        message_pb, = message_pbs
-        self.assertEqual(message_pb.data.decode('ascii'), B64)
-        self.assertEqual(message_pb.attributes, {})
-        self.assertEqual(options.is_bundling, False)
-
-    def test_topic_publish_miss_w_attrs_w_bytes_payload(self):
-        import base64
-        from google.cloud.exceptions import NotFound
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD)
-        MESSAGE = {'data': B64, 'attributes': {'foo': 'bar'}}
-        gax_api = _GAXPublisherAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.topic_publish(self.TOPIC_PATH, [MESSAGE])
-
-        topic_path, message_pbs, options = gax_api._publish_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        message_pb, = message_pbs
-        self.assertEqual(message_pb.data, B64)
-        self.assertEqual(message_pb.attributes, {'foo': 'bar'})
-        self.assertEqual(options.is_bundling, False)
-
-    def test_topic_publish_error(self):
-        import base64
-        from google.cloud.exceptions import GrpcRendezvous
-
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MESSAGE = {'data': B64, 'attributes': {}}
-        gax_api = _GAXPublisherAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.topic_publish(self.TOPIC_PATH, [MESSAGE])
-
-        topic_path, message_pbs, options = gax_api._publish_called_with
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        message_pb, = message_pbs
-        self.assertEqual(message_pb.data.decode('ascii'), B64)
-        self.assertEqual(message_pb.attributes, {})
-        self.assertEqual(options.is_bundling, False)
-
-    def test_topic_list_subscriptions_no_paging(self):
-        from google.gax import INITIAL_PAGE
-        from unit_tests._testing import _GAXPageIterator
-        response = _GAXPageIterator([
-            {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}], None)
-        gax_api = _GAXPublisherAPI(_list_topic_subscriptions_response=response)
-        api = self._makeOne(gax_api)
-
-        subscriptions, next_token = api.topic_list_subscriptions(
-            self.TOPIC_PATH)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertIsNone(next_token)
-
-        topic_path, page_size, options = (
-            gax_api._list_topic_subscriptions_called_with)
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertIs(options.page_token, INITIAL_PAGE)
-
-    def test_topic_list_subscriptions_with_paging(self):
-        from unit_tests._testing import _GAXPageIterator
-        SIZE = 23
-        TOKEN = 'TOKEN'
-        NEW_TOKEN = 'NEW_TOKEN'
-        response = _GAXPageIterator([
-            {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}], NEW_TOKEN)
-        gax_api = _GAXPublisherAPI(_list_topic_subscriptions_response=response)
-        api = self._makeOne(gax_api)
-
-        subscriptions, next_token = api.topic_list_subscriptions(
-            self.TOPIC_PATH, page_size=SIZE, page_token=TOKEN)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertEqual(next_token, NEW_TOKEN)
-
-        name, page_size, options = (
-            gax_api._list_topic_subscriptions_called_with)
-        self.assertEqual(name, self.TOPIC_PATH)
-        self.assertEqual(page_size, SIZE)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_topic_list_subscriptions_miss(self):
-        from google.gax import INITIAL_PAGE
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXPublisherAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.topic_list_subscriptions(self.TOPIC_PATH)
-
-        topic_path, page_size, options = (
-            gax_api._list_topic_subscriptions_called_with)
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertIs(options.page_token, INITIAL_PAGE)
-
-    def test_topic_list_subscriptions_error(self):
-        from google.gax import INITIAL_PAGE
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXPublisherAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.topic_list_subscriptions(self.TOPIC_PATH)
-
-        topic_path, page_size, options = (
-            gax_api._list_topic_subscriptions_called_with)
-        self.assertEqual(topic_path, self.TOPIC_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertIs(options.page_token, INITIAL_PAGE)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_SubscriberAPI(_Base, unittest.TestCase):
-
-    PUSH_ENDPOINT = 'https://api.example.com/push'
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub._gax import _SubscriberAPI
-        return _SubscriberAPI
-
-    def test_ctor(self):
-        gax_api = _GAXSubscriberAPI()
-        api = self._makeOne(gax_api)
-        self.assertIs(api._gax_api, gax_api)
-
-    def test_list_subscriptions_no_paging(self):
-        from google.gax import INITIAL_PAGE
-        from unit_tests._testing import _GAXPageIterator
-        response = _GAXPageIterator([_SubscriptionPB(
-            self.SUB_PATH, self.TOPIC_PATH, self.PUSH_ENDPOINT, 0)], None)
-        gax_api = _GAXSubscriberAPI(_list_subscriptions_response=response)
-        api = self._makeOne(gax_api)
-
-        subscriptions, next_token = api.list_subscriptions(self.PROJECT)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertEqual(subscription['pushConfig'],
-                         {'pushEndpoint': self.PUSH_ENDPOINT})
-        self.assertEqual(subscription['ackDeadlineSeconds'], 0)
-        self.assertIsNone(next_token)
-
-        name, page_size, options = gax_api._list_subscriptions_called_with
-        self.assertEqual(name, self.PROJECT_PATH)
-        self.assertEqual(page_size, 0)
-        self.assertIs(options.page_token, INITIAL_PAGE)
-
-    def test_list_subscriptions_with_paging(self):
-        from unit_tests._testing import _GAXPageIterator
-        SIZE = 23
-        TOKEN = 'TOKEN'
-        NEW_TOKEN = 'NEW_TOKEN'
-        response = _GAXPageIterator([_SubscriptionPB(
-            self.SUB_PATH, self.TOPIC_PATH, self.PUSH_ENDPOINT, 0)], NEW_TOKEN)
-        gax_api = _GAXSubscriberAPI(_list_subscriptions_response=response)
-        api = self._makeOne(gax_api)
-
-        subscriptions, next_token = api.list_subscriptions(
-            self.PROJECT, page_size=SIZE, page_token=TOKEN)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertEqual(subscription['pushConfig'],
-                         {'pushEndpoint': self.PUSH_ENDPOINT})
-        self.assertEqual(subscription['ackDeadlineSeconds'], 0)
-        self.assertEqual(next_token, NEW_TOKEN)
-
-        name, page_size, options = gax_api._list_subscriptions_called_with
-        self.assertEqual(name, self.PROJECT_PATH)
-        self.assertEqual(page_size, 23)
-        self.assertEqual(options.page_token, TOKEN)
-
-    def test_subscription_create(self):
-        sub_pb = _SubscriptionPB(self.SUB_PATH, self.TOPIC_PATH, '', 0)
-        gax_api = _GAXSubscriberAPI(_create_subscription_response=sub_pb)
-        api = self._makeOne(gax_api)
-
-        resource = api.subscription_create(self.SUB_PATH, self.TOPIC_PATH)
-
-        expected = {
-            'name': self.SUB_PATH,
-            'topic': self.TOPIC_PATH,
-            'ackDeadlineSeconds': 0,
-        }
-        self.assertEqual(resource, expected)
-        name, topic, push_config, ack_deadline, options = (
-            gax_api._create_subscription_called_with)
-        self.assertEqual(name, self.SUB_PATH)
-        self.assertEqual(topic, self.TOPIC_PATH)
-        self.assertIsNone(push_config)
-        self.assertEqual(ack_deadline, 0)
-        self.assertIsNone(options)
-
-    def test_subscription_create_already_exists(self):
-        from google.cloud.exceptions import Conflict
-        DEADLINE = 600
-        gax_api = _GAXSubscriberAPI(_create_subscription_conflict=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(Conflict):
-            api.subscription_create(
-                self.SUB_PATH, self.TOPIC_PATH, DEADLINE, self.PUSH_ENDPOINT)
-
-        name, topic, push_config, ack_deadline, options = (
-            gax_api._create_subscription_called_with)
-        self.assertEqual(name, self.SUB_PATH)
-        self.assertEqual(topic, self.TOPIC_PATH)
-        self.assertEqual(push_config.push_endpoint, self.PUSH_ENDPOINT)
-        self.assertEqual(ack_deadline, DEADLINE)
-        self.assertIsNone(options)
-
-    def test_subscription_create_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_create(self.SUB_PATH, self.TOPIC_PATH)
-
-        name, topic, push_config, ack_deadline, options = (
-            gax_api._create_subscription_called_with)
-        self.assertEqual(name, self.SUB_PATH)
-        self.assertEqual(topic, self.TOPIC_PATH)
-        self.assertIsNone(push_config)
-        self.assertEqual(ack_deadline, 0)
-        self.assertIsNone(options)
-
-    def test_subscription_get_hit(self):
-        sub_pb = _SubscriptionPB(
-            self.SUB_PATH, self.TOPIC_PATH, self.PUSH_ENDPOINT, 0)
-        gax_api = _GAXSubscriberAPI(_get_subscription_response=sub_pb)
-        api = self._makeOne(gax_api)
-
-        resource = api.subscription_get(self.SUB_PATH)
-
-        expected = {
-            'name': self.SUB_PATH,
-            'topic': self.TOPIC_PATH,
-            'ackDeadlineSeconds': 0,
-            'pushConfig': {
-                'pushEndpoint': self.PUSH_ENDPOINT,
-            },
-        }
-        self.assertEqual(resource, expected)
-        sub_path, options = gax_api._get_subscription_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertIsNone(options)
-
-    def test_subscription_get_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSubscriberAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.subscription_get(self.SUB_PATH)
-
-        sub_path, options = gax_api._get_subscription_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertIsNone(options)
-
-    def test_subscription_get_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_get(self.SUB_PATH)
-
-        sub_path, options = gax_api._get_subscription_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertIsNone(options)
-
-    def test_subscription_delete_hit(self):
-        gax_api = _GAXSubscriberAPI(_delete_subscription_ok=True)
-        api = self._makeOne(gax_api)
-
-        api.subscription_delete(self.TOPIC_PATH)
-
-        sub_path, options = gax_api._delete_subscription_called_with
-        self.assertEqual(sub_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_subscription_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSubscriberAPI(_delete_subscription_ok=False)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.subscription_delete(self.TOPIC_PATH)
-
-        sub_path, options = gax_api._delete_subscription_called_with
-        self.assertEqual(sub_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_subscription_delete_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_delete(self.TOPIC_PATH)
-
-        sub_path, options = gax_api._delete_subscription_called_with
-        self.assertEqual(sub_path, self.TOPIC_PATH)
-        self.assertIsNone(options)
-
-    def test_subscription_modify_push_config_hit(self):
-        gax_api = _GAXSubscriberAPI(_modify_push_config_ok=True)
-        api = self._makeOne(gax_api)
-
-        api.subscription_modify_push_config(self.SUB_PATH, self.PUSH_ENDPOINT)
-
-        sub_path, config, options = gax_api._modify_push_config_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(config.push_endpoint, self.PUSH_ENDPOINT)
-        self.assertIsNone(options)
-
-    def test_subscription_modify_push_config_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSubscriberAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.subscription_modify_push_config(
-                self.SUB_PATH, self.PUSH_ENDPOINT)
-
-        sub_path, config, options = gax_api._modify_push_config_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(config.push_endpoint, self.PUSH_ENDPOINT)
-        self.assertIsNone(options)
-
-    def test_subscription_modify_push_config_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_modify_push_config(
-                self.SUB_PATH, self.PUSH_ENDPOINT)
-
-        sub_path, config, options = gax_api._modify_push_config_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(config.push_endpoint, self.PUSH_ENDPOINT)
-        self.assertIsNone(options)
-
-    def test_subscription_pull_explicit(self):
-        import base64
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _datetime_to_pb_timestamp
-        from google.cloud._helpers import _datetime_to_rfc3339
-        NOW = datetime.datetime.utcnow().replace(tzinfo=UTC)
-        NOW_PB = _datetime_to_pb_timestamp(NOW)
-        NOW_RFC3339 = _datetime_to_rfc3339(NOW)
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        ACK_ID = 'DEADBEEF'
-        MSG_ID = 'BEADCAFE'
-        MESSAGE = {
-            'messageId': MSG_ID,
-            'data': B64,
-            'attributes': {'a': 'b'},
-            'publishTime': NOW_RFC3339,
-        }
-        RECEIVED = [{'ackId': ACK_ID, 'message': MESSAGE}]
-        message_pb = _PubsubMessagePB(MSG_ID, B64, {'a': 'b'}, NOW_PB)
-        response_pb = _PullResponsePB([_ReceivedMessagePB(ACK_ID, message_pb)])
-        gax_api = _GAXSubscriberAPI(_pull_response=response_pb)
-        api = self._makeOne(gax_api)
-        MAX_MESSAGES = 10
-
-        received = api.subscription_pull(
-            self.SUB_PATH, return_immediately=True, max_messages=MAX_MESSAGES)
-
-        self.assertEqual(received, RECEIVED)
-        sub_path, max_messages, return_immediately, options = (
-            gax_api._pull_called_with)
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(max_messages, MAX_MESSAGES)
-        self.assertTrue(return_immediately)
-        self.assertIsNone(options)
-
-    def test_subscription_pull_defaults_miss(self):
-        from google.cloud.exceptions import NotFound
-        gax_api = _GAXSubscriberAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.subscription_pull(self.SUB_PATH)
-
-        sub_path, max_messages, return_immediately, options = (
-            gax_api._pull_called_with)
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(max_messages, 1)
-        self.assertFalse(return_immediately)
-        self.assertIsNone(options)
-
-    def test_subscription_pull_defaults_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_pull(self.SUB_PATH)
-
-        sub_path, max_messages, return_immediately, options = (
-            gax_api._pull_called_with)
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(max_messages, 1)
-        self.assertFalse(return_immediately)
-        self.assertIsNone(options)
-
-    def test_subscription_acknowledge_hit(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        gax_api = _GAXSubscriberAPI(_acknowledge_ok=True)
-        api = self._makeOne(gax_api)
-
-        api.subscription_acknowledge(self.SUB_PATH, [ACK_ID1, ACK_ID2])
-
-        sub_path, ack_ids, options = gax_api._acknowledge_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(ack_ids, [ACK_ID1, ACK_ID2])
-        self.assertIsNone(options)
-
-    def test_subscription_acknowledge_miss(self):
-        from google.cloud.exceptions import NotFound
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        gax_api = _GAXSubscriberAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.subscription_acknowledge(self.SUB_PATH, [ACK_ID1, ACK_ID2])
-
-        sub_path, ack_ids, options = gax_api._acknowledge_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(ack_ids, [ACK_ID1, ACK_ID2])
-        self.assertIsNone(options)
-
-    def test_subscription_acknowledge_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_acknowledge(self.SUB_PATH, [ACK_ID1, ACK_ID2])
-
-        sub_path, ack_ids, options = gax_api._acknowledge_called_with
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(ack_ids, [ACK_ID1, ACK_ID2])
-        self.assertIsNone(options)
-
-    def test_subscription_modify_ack_deadline_hit(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        NEW_DEADLINE = 90
-        gax_api = _GAXSubscriberAPI(_modify_ack_deadline_ok=True)
-        api = self._makeOne(gax_api)
-
-        api.subscription_modify_ack_deadline(
-            self.SUB_PATH, [ACK_ID1, ACK_ID2], NEW_DEADLINE)
-
-        sub_path, ack_ids, deadline, options = (
-            gax_api._modify_ack_deadline_called_with)
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(ack_ids, [ACK_ID1, ACK_ID2])
-        self.assertEqual(deadline, NEW_DEADLINE)
-        self.assertIsNone(options)
-
-    def test_subscription_modify_ack_deadline_miss(self):
-        from google.cloud.exceptions import NotFound
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        NEW_DEADLINE = 90
-        gax_api = _GAXSubscriberAPI()
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(NotFound):
-            api.subscription_modify_ack_deadline(
-                self.SUB_PATH, [ACK_ID1, ACK_ID2], NEW_DEADLINE)
-
-        sub_path, ack_ids, deadline, options = (
-            gax_api._modify_ack_deadline_called_with)
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(ack_ids, [ACK_ID1, ACK_ID2])
-        self.assertEqual(deadline, NEW_DEADLINE)
-        self.assertIsNone(options)
-
-    def test_subscription_modify_ack_deadline_error(self):
-        from google.cloud.exceptions import GrpcRendezvous
-
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        NEW_DEADLINE = 90
-        gax_api = _GAXSubscriberAPI(_random_gax_error=True)
-        api = self._makeOne(gax_api)
-
-        with self.assertRaises(GrpcRendezvous):
-            api.subscription_modify_ack_deadline(
-                self.SUB_PATH, [ACK_ID1, ACK_ID2], NEW_DEADLINE)
-
-        sub_path, ack_ids, deadline, options = (
-            gax_api._modify_ack_deadline_called_with)
-        self.assertEqual(sub_path, self.SUB_PATH)
-        self.assertEqual(ack_ids, [ACK_ID1, ACK_ID2])
-        self.assertEqual(deadline, NEW_DEADLINE)
-        self.assertIsNone(options)
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_make_gax_publisher_api(_Base, unittest.TestCase):
-
-    def _callFUT(self, connection):
-        from google.cloud.pubsub._gax import make_gax_publisher_api
-        return make_gax_publisher_api(connection)
-
-    def test_live_api(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.pubsub import _gax as MUT
-
-        channels = []
-        mock_result = object()
-
-        def mock_publisher_api(channel):
-            channels.append(channel)
-            return mock_result
-
-        connection = _Connection(in_emulator=False)
-        with _Monkey(MUT, PublisherApi=mock_publisher_api):
-            result = self._callFUT(connection)
-
-        self.assertIs(result, mock_result)
-        self.assertEqual(channels, [None])
-
-    def test_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.pubsub import _gax as MUT
-
-        channels = []
-        mock_result = object()
-        insecure_args = []
-        mock_channel = object()
-
-        def mock_publisher_api(channel):
-            channels.append(channel)
-            return mock_result
-
-        def mock_insecure_channel(host):
-            insecure_args.append(host)
-            return mock_channel
-
-        host = 'CURR_HOST:1234'
-        connection = _Connection(in_emulator=True, host=host)
-        with _Monkey(MUT, PublisherApi=mock_publisher_api,
-                     insecure_channel=mock_insecure_channel):
-            result = self._callFUT(connection)
-
-        self.assertIs(result, mock_result)
-        self.assertEqual(channels, [mock_channel])
-        self.assertEqual(insecure_args, [host])
-
-
-@unittest.skipUnless(_HAVE_GAX, 'No gax-python')
-class Test_make_gax_subscriber_api(_Base, unittest.TestCase):
-
-    def _callFUT(self, connection):
-        from google.cloud.pubsub._gax import make_gax_subscriber_api
-        return make_gax_subscriber_api(connection)
-
-    def test_live_api(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.pubsub import _gax as MUT
-
-        channels = []
-        mock_result = object()
-
-        def mock_subscriber_api(channel):
-            channels.append(channel)
-            return mock_result
-
-        connection = _Connection(in_emulator=False)
-        with _Monkey(MUT, SubscriberApi=mock_subscriber_api):
-            result = self._callFUT(connection)
-
-        self.assertIs(result, mock_result)
-        self.assertEqual(channels, [None])
-
-    def test_emulator(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.pubsub import _gax as MUT
-
-        channels = []
-        mock_result = object()
-        insecure_args = []
-        mock_channel = object()
-
-        def mock_subscriber_api(channel):
-            channels.append(channel)
-            return mock_result
-
-        def mock_insecure_channel(host):
-            insecure_args.append(host)
-            return mock_channel
-
-        host = 'CURR_HOST:1234'
-        connection = _Connection(in_emulator=True, host=host)
-        with _Monkey(MUT, SubscriberApi=mock_subscriber_api,
-                     insecure_channel=mock_insecure_channel):
-            result = self._callFUT(connection)
-
-        self.assertIs(result, mock_result)
-        self.assertEqual(channels, [mock_channel])
-        self.assertEqual(insecure_args, [host])
-
-
-class _GAXPublisherAPI(_GAXBaseAPI):
-
-    _create_topic_conflict = False
-
-    def list_topics(self, name, page_size, options):
-        self._list_topics_called_with = name, page_size, options
-        return self._list_topics_response
-
-    def create_topic(self, name, options=None):
-        self._create_topic_called_with = name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._create_topic_conflict:
-            raise self._make_grpc_failed_precondition()
-        return self._create_topic_response
-
-    def get_topic(self, name, options=None):
-        self._get_topic_called_with = name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._get_topic_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def delete_topic(self, name, options=None):
-        self._delete_topic_called_with = name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if not self._delete_topic_ok:
-            raise self._make_grpc_not_found()
-
-    def publish(self, topic, messages, options=None):
-        self._publish_called_with = topic, messages, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._publish_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def list_topic_subscriptions(self, topic, page_size, options=None):
-        self._list_topic_subscriptions_called_with = topic, page_size, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._list_topic_subscriptions_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-
-class _GAXSubscriberAPI(_GAXBaseAPI):
-
-    _create_subscription_conflict = False
-    _modify_push_config_ok = False
-    _acknowledge_ok = False
-    _modify_ack_deadline_ok = False
-
-    def list_subscriptions(self, project, page_size, options=None):
-        self._list_subscriptions_called_with = (project, page_size, options)
-        return self._list_subscriptions_response
-
-    def create_subscription(self, name, topic,
-                            push_config, ack_deadline_seconds,
-                            options=None):
-        self._create_subscription_called_with = (
-            name, topic, push_config, ack_deadline_seconds, options)
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if self._create_subscription_conflict:
-            raise self._make_grpc_failed_precondition()
-        return self._create_subscription_response
-
-    def get_subscription(self, name, options=None):
-        self._get_subscription_called_with = name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._get_subscription_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def delete_subscription(self, name, options=None):
-        self._delete_subscription_called_with = name, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if not self._delete_subscription_ok:
-            raise self._make_grpc_not_found()
-
-    def modify_push_config(self, name, push_config, options=None):
-        self._modify_push_config_called_with = name, push_config, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if not self._modify_push_config_ok:
-            raise self._make_grpc_not_found()
-
-    def pull(self, name, max_messages, return_immediately, options=None):
-        self._pull_called_with = (
-            name, max_messages, return_immediately, options)
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        try:
-            return self._pull_response
-        except AttributeError:
-            raise self._make_grpc_not_found()
-
-    def acknowledge(self, name, ack_ids, options=None):
-        self._acknowledge_called_with = name, ack_ids, options
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if not self._acknowledge_ok:
-            raise self._make_grpc_not_found()
-
-    def modify_ack_deadline(self, name, ack_ids, deadline, options=None):
-        self._modify_ack_deadline_called_with = (
-            name, ack_ids, deadline, options)
-        if self._random_gax_error:
-            raise self._make_grpc_error()
-        if not self._modify_ack_deadline_ok:
-            raise self._make_grpc_not_found()
-
-
-class _TopicPB(object):
-
-    def __init__(self, name):
-        self.name = name
-
-
-class _PublishResponsePB(object):
-
-    def __init__(self, message_ids):
-        self.message_ids = message_ids
-
-
-class _PushConfigPB(object):
-
-    def __init__(self, push_endpoint):
-        self.push_endpoint = push_endpoint
-
-
-class _PubsubMessagePB(object):
-
-    def __init__(self, message_id, data, attributes, publish_time):
-        self.message_id = message_id
-        self.data = data
-        self.attributes = attributes
-        self.publish_time = publish_time
-
-
-class _ReceivedMessagePB(object):
-
-    def __init__(self, ack_id, message):
-        self.ack_id = ack_id
-        self.message = message
-
-
-class _PullResponsePB(object):
-
-    def __init__(self, received_messages):
-        self.received_messages = received_messages
-
-
-class _SubscriptionPB(object):
-
-    def __init__(self, name, topic, push_endpoint, ack_deadline_seconds):
-        self.name = name
-        self.topic = topic
-        self.push_config = _PushConfigPB(push_endpoint)
-        self.ack_deadline_seconds = ack_deadline_seconds
-
-
-class _Connection(object):
-
-    def __init__(self, in_emulator=False, host=None):
-        self.in_emulator = in_emulator
-        self.host = host
diff --git a/unit_tests/pubsub/test__helpers.py b/unit_tests/pubsub/test__helpers.py
deleted file mode 100644
index 646a73d978c0..000000000000
--- a/unit_tests/pubsub/test__helpers.py
+++ /dev/null
@@ -1,57 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class Test_topic_name_from_path(unittest.TestCase):
-
-    def _callFUT(self, path, project):
-        from google.cloud.pubsub._helpers import topic_name_from_path
-        return topic_name_from_path(path, project)
-
-    def test_w_simple_name(self):
-        TOPIC_NAME = 'TOPIC_NAME'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-        topic_name = self._callFUT(PATH, PROJECT)
-        self.assertEqual(topic_name, TOPIC_NAME)
-
-    def test_w_name_w_all_extras(self):
-        TOPIC_NAME = 'TOPIC_NAME-part.one~part.two%part-three'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-        topic_name = self._callFUT(PATH, PROJECT)
-        self.assertEqual(topic_name, TOPIC_NAME)
-
-
-class Test_subscription_name_from_path(unittest.TestCase):
-
-    def _callFUT(self, path, project):
-        from google.cloud.pubsub._helpers import subscription_name_from_path
-        return subscription_name_from_path(path, project)
-
-    def test_w_simple_name(self):
-        SUBSCRIPTION_NAME = 'SUBSCRIPTION_NAME'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/subscriptions/%s' % (PROJECT, SUBSCRIPTION_NAME)
-        subscription_name = self._callFUT(PATH, PROJECT)
-        self.assertEqual(subscription_name, SUBSCRIPTION_NAME)
-
-    def test_w_name_w_all_extras(self):
-        SUBSCRIPTION_NAME = 'SUBSCRIPTION_NAME-part.one~part.two%part-three'
-        PROJECT = 'my-project-1234'
-        PATH = 'projects/%s/subscriptions/%s' % (PROJECT, SUBSCRIPTION_NAME)
-        topic_name = self._callFUT(PATH, PROJECT)
-        self.assertEqual(topic_name, SUBSCRIPTION_NAME)
diff --git a/unit_tests/pubsub/test_client.py b/unit_tests/pubsub/test_client.py
deleted file mode 100644
index 05e301a676fa..000000000000
--- a/unit_tests/pubsub/test_client.py
+++ /dev/null
@@ -1,303 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-    PROJECT = 'PROJECT'
-    TOPIC_NAME = 'topic_name'
-    TOPIC_PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-    SUB_NAME = 'subscription_name'
-    SUB_PATH = 'projects/%s/subscriptions/%s' % (PROJECT, SUB_NAME)
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_publisher_api_wo_gax(self):
-        from google.cloud.pubsub.connection import _PublisherAPI
-        from google.cloud.pubsub import client as MUT
-        from unit_tests._testing import _Monkey
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        conn = client.connection = object()
-
-        with _Monkey(MUT, _USE_GAX=False):
-            api = client.publisher_api
-
-        self.assertIsInstance(api, _PublisherAPI)
-        self.assertIs(api._connection, conn)
-        # API instance is cached
-        again = client.publisher_api
-        self.assertIs(again, api)
-
-    def test_publisher_api_w_gax(self):
-        from google.cloud.pubsub import client as MUT
-        from unit_tests._testing import _Monkey
-
-        wrapped = object()
-        _called_with = []
-
-        def _generated_api(*args, **kw):
-            _called_with.append((args, kw))
-            return wrapped
-
-        class _GaxPublisherAPI(object):
-
-            def __init__(self, _wrapped):
-                self._wrapped = _wrapped
-
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-
-        with _Monkey(MUT,
-                     _USE_GAX=True,
-                     make_gax_publisher_api=_generated_api,
-                     GAXPublisherAPI=_GaxPublisherAPI):
-            api = client.publisher_api
-
-        self.assertIsInstance(api, _GaxPublisherAPI)
-        self.assertIs(api._wrapped, wrapped)
-        # API instance is cached
-        again = client.publisher_api
-        self.assertIs(again, api)
-        args = (client.connection,)
-        self.assertEqual(_called_with, [(args, {})])
-
-    def test_subscriber_api_wo_gax(self):
-        from google.cloud.pubsub.connection import _SubscriberAPI
-        from google.cloud.pubsub import client as MUT
-        from unit_tests._testing import _Monkey
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        conn = client.connection = object()
-
-        with _Monkey(MUT, _USE_GAX=False):
-            api = client.subscriber_api
-
-        self.assertIsInstance(api, _SubscriberAPI)
-        self.assertIs(api._connection, conn)
-        # API instance is cached
-        again = client.subscriber_api
-        self.assertIs(again, api)
-
-    def test_subscriber_api_w_gax(self):
-        from google.cloud.pubsub import client as MUT
-        from unit_tests._testing import _Monkey
-
-        wrapped = object()
-        _called_with = []
-
-        def _generated_api(*args, **kw):
-            _called_with.append((args, kw))
-            return wrapped
-
-        class _GaxSubscriberAPI(object):
-
-            def __init__(self, _wrapped):
-                self._wrapped = _wrapped
-
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-
-        with _Monkey(MUT,
-                     _USE_GAX=True,
-                     make_gax_subscriber_api=_generated_api,
-                     GAXSubscriberAPI=_GaxSubscriberAPI):
-            api = client.subscriber_api
-
-        self.assertIsInstance(api, _GaxSubscriberAPI)
-        self.assertIs(api._wrapped, wrapped)
-        # API instance is cached
-        again = client.subscriber_api
-        self.assertIs(again, api)
-        args = (client.connection,)
-        self.assertEqual(_called_with, [(args, {})])
-
-    def test_iam_policy_api(self):
-        from google.cloud.pubsub.connection import _IAMPolicyAPI
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        conn = client.connection = object()
-        api = client.iam_policy_api
-        self.assertIsInstance(api, _IAMPolicyAPI)
-        self.assertIs(api._connection, conn)
-        # API instance is cached
-        again = client.iam_policy_api
-        self.assertIs(again, api)
-
-    def test_list_topics_no_paging(self):
-        from google.cloud.pubsub.topic import Topic
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        client.connection = object()
-        api = client._publisher_api = _FauxPublisherAPI()
-        api._list_topics_response = [{'name': self.TOPIC_PATH}], None
-
-        topics, next_page_token = client.list_topics()
-
-        self.assertEqual(len(topics), 1)
-        self.assertIsInstance(topics[0], Topic)
-        self.assertEqual(topics[0].name, self.TOPIC_NAME)
-        self.assertIsNone(next_page_token)
-
-        self.assertEqual(api._listed_topics, (self.PROJECT, None, None))
-
-    def test_list_topics_with_paging(self):
-        from google.cloud.pubsub.topic import Topic
-        TOKEN1 = 'TOKEN1'
-        TOKEN2 = 'TOKEN2'
-        SIZE = 1
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        client.connection = object()
-        api = client._publisher_api = _FauxPublisherAPI()
-        api._list_topics_response = [{'name': self.TOPIC_PATH}], TOKEN2
-
-        topics, next_page_token = client.list_topics(SIZE, TOKEN1)
-
-        self.assertEqual(len(topics), 1)
-        self.assertIsInstance(topics[0], Topic)
-        self.assertEqual(topics[0].name, self.TOPIC_NAME)
-        self.assertEqual(next_page_token, TOKEN2)
-
-        self.assertEqual(api._listed_topics, (self.PROJECT, 1, TOKEN1))
-
-    def test_list_topics_missing_key(self):
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        client.connection = object()
-        api = client._publisher_api = _FauxPublisherAPI()
-        api._list_topics_response = (), None
-
-        topics, next_page_token = client.list_topics()
-
-        self.assertEqual(len(topics), 0)
-        self.assertIsNone(next_page_token)
-
-        self.assertEqual(api._listed_topics, (self.PROJECT, None, None))
-
-    def test_list_subscriptions_no_paging(self):
-        from google.cloud.pubsub.subscription import Subscription
-        SUB_INFO = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        client.connection = object()
-        api = client._subscriber_api = _FauxSubscriberAPI()
-        api._list_subscriptions_response = [SUB_INFO], None
-
-        subscriptions, next_page_token = client.list_subscriptions()
-
-        self.assertEqual(len(subscriptions), 1)
-        self.assertIsInstance(subscriptions[0], Subscription)
-        self.assertEqual(subscriptions[0].name, self.SUB_NAME)
-        self.assertEqual(subscriptions[0].topic.name, self.TOPIC_NAME)
-        self.assertIsNone(next_page_token)
-
-        self.assertEqual(api._listed_subscriptions,
-                         (self.PROJECT, None, None))
-
-    def test_list_subscriptions_with_paging(self):
-        from google.cloud.pubsub.subscription import Subscription
-        SUB_INFO = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        ACK_DEADLINE = 42
-        PUSH_ENDPOINT = 'https://push.example.com/endpoint'
-        SUB_INFO = {'name': self.SUB_PATH,
-                    'topic': self.TOPIC_PATH,
-                    'ackDeadlineSeconds': ACK_DEADLINE,
-                    'pushConfig': {'pushEndpoint': PUSH_ENDPOINT}}
-        TOKEN1 = 'TOKEN1'
-        TOKEN2 = 'TOKEN2'
-        SIZE = 1
-        client.connection = object()
-        api = client._subscriber_api = _FauxSubscriberAPI()
-        api._list_subscriptions_response = [SUB_INFO], TOKEN2
-
-        subscriptions, next_page_token = client.list_subscriptions(
-            SIZE, TOKEN1)
-
-        self.assertEqual(len(subscriptions), 1)
-        self.assertIsInstance(subscriptions[0], Subscription)
-        self.assertEqual(subscriptions[0].name, self.SUB_NAME)
-        self.assertEqual(subscriptions[0].topic.name, self.TOPIC_NAME)
-        self.assertEqual(subscriptions[0].ack_deadline, ACK_DEADLINE)
-        self.assertEqual(subscriptions[0].push_endpoint, PUSH_ENDPOINT)
-        self.assertEqual(next_page_token, TOKEN2)
-
-        self.assertEqual(api._listed_subscriptions,
-                         (self.PROJECT, SIZE, TOKEN1))
-
-    def test_list_subscriptions_w_missing_key(self):
-        PROJECT = 'PROJECT'
-        creds = _Credentials()
-
-        client = self._makeOne(project=PROJECT, credentials=creds)
-        client.connection = object()
-        api = client._subscriber_api = _FauxSubscriberAPI()
-        api._list_subscriptions_response = (), None
-
-        subscriptions, next_page_token = client.list_subscriptions()
-
-        self.assertEqual(len(subscriptions), 0)
-        self.assertIsNone(next_page_token)
-
-        self.assertEqual(api._listed_subscriptions,
-                         (self.PROJECT, None, None))
-
-    def test_topic(self):
-        PROJECT = 'PROJECT'
-        TOPIC_NAME = 'TOPIC_NAME'
-        creds = _Credentials()
-
-        client_obj = self._makeOne(project=PROJECT, credentials=creds)
-        new_topic = client_obj.topic(TOPIC_NAME)
-        self.assertEqual(new_topic.name, TOPIC_NAME)
-        self.assertIs(new_topic._client, client_obj)
-        self.assertEqual(new_topic.project, PROJECT)
-        self.assertEqual(new_topic.full_name,
-                         'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME))
-        self.assertFalse(new_topic.timestamp_messages)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _FauxPublisherAPI(object):
-
-    def list_topics(self, project, page_size, page_token):
-        self._listed_topics = (project, page_size, page_token)
-        return self._list_topics_response
-
-
-class _FauxSubscriberAPI(object):
-
-    def list_subscriptions(self, project, page_size, page_token):
-        self._listed_subscriptions = (project, page_size, page_token)
-        return self._list_subscriptions_response
diff --git a/unit_tests/pubsub/test_connection.py b/unit_tests/pubsub/test_connection.py
deleted file mode 100644
index 7e363ff3a3ea..000000000000
--- a/unit_tests/pubsub/test_connection.py
+++ /dev/null
@@ -1,737 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class _Base(unittest.TestCase):
-    PROJECT = 'PROJECT'
-    LIST_TOPICS_PATH = 'projects/%s/topics' % (PROJECT,)
-    LIST_SUBSCRIPTIONS_PATH = 'projects/%s/subscriptions' % (PROJECT,)
-    TOPIC_NAME = 'topic_name'
-    TOPIC_PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-    LIST_TOPIC_SUBSCRIPTIONS_PATH = '%s/subscriptions' % (TOPIC_PATH,)
-    SUB_NAME = 'subscription_name'
-    SUB_PATH = 'projects/%s/subscriptions/%s' % (PROJECT, SUB_NAME)
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-
-class TestConnection(_Base):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.connection import Connection
-        return Connection
-
-    def test_default_url(self):
-        conn = self._makeOne()
-        klass = self._getTargetClass()
-        self.assertEqual(conn.api_base_url, klass.API_BASE_URL)
-
-    def test_custom_url_from_env(self):
-        import os
-        from unit_tests._testing import _Monkey
-        from google.cloud.environment_vars import PUBSUB_EMULATOR
-
-        HOST = 'localhost:8187'
-        fake_environ = {PUBSUB_EMULATOR: HOST}
-
-        with _Monkey(os, getenv=fake_environ.get):
-            conn = self._makeOne()
-
-        klass = self._getTargetClass()
-        self.assertNotEqual(conn.api_base_url, klass.API_BASE_URL)
-        self.assertEqual(conn.api_base_url, 'http://' + HOST)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeOne()
-        uri = conn.build_api_url('/foo', {'bar': 'baz'})
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        self.assertEqual(path,
-                         '/'.join(['', conn.API_VERSION, 'foo']))
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['bar'], 'baz')
-
-    def test_build_api_url_w_base_url_override(self):
-        base_url1 = 'api-base-url1'
-        base_url2 = 'api-base-url2'
-        conn = self._makeOne()
-        conn.api_base_url = base_url1
-        URI = '/'.join([
-            base_url2,
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo', api_base_url=base_url2),
-                         URI)
-
-
-class Test_PublisherAPI(_Base):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.connection import _PublisherAPI
-        return _PublisherAPI
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = _Connection()
-        api = self._makeOne(connection)
-        self.assertIs(api._connection, connection)
-
-    def test_list_topics_no_paging(self):
-        RETURNED = {'topics': [{'name': self.TOPIC_PATH}]}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        topics, next_token = api.list_topics(self.PROJECT)
-
-        self.assertEqual(len(topics), 1)
-        topic = topics[0]
-        self.assertIsInstance(topic, dict)
-        self.assertEqual(topic['name'], self.TOPIC_PATH)
-        self.assertIsNone(next_token)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPICS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-    def test_list_topics_with_paging(self):
-        TOKEN1 = 'TOKEN1'
-        TOKEN2 = 'TOKEN2'
-        SIZE = 1
-        RETURNED = {
-            'topics': [{'name': self.TOPIC_PATH}],
-            'nextPageToken': 'TOKEN2',
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        topics, next_token = api.list_topics(
-            self.PROJECT, page_token=TOKEN1, page_size=SIZE)
-
-        self.assertEqual(len(topics), 1)
-        topic = topics[0]
-        self.assertIsInstance(topic, dict)
-        self.assertEqual(topic['name'], self.TOPIC_PATH)
-        self.assertEqual(next_token, TOKEN2)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPICS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'],
-                         {'pageToken': TOKEN1, 'pageSize': SIZE})
-
-    def test_list_topics_missing_key(self):
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        topics, next_token = api.list_topics(self.PROJECT)
-
-        self.assertEqual(len(topics), 0)
-        self.assertIsNone(next_token)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPICS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-    def test_topic_create(self):
-        RETURNED = {'name': self.TOPIC_PATH}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        resource = api.topic_create(self.TOPIC_PATH)
-
-        self.assertEqual(resource, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'PUT')
-        path = '/%s' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_topic_create_already_exists(self):
-        from google.cloud.exceptions import Conflict
-        connection = _Connection()
-        connection._no_response_error = Conflict
-        api = self._makeOne(connection)
-
-        with self.assertRaises(Conflict):
-            api.topic_create(self.TOPIC_PATH)
-
-        self.assertEqual(connection._called_with['method'], 'PUT')
-        path = '/%s' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_topic_get_hit(self):
-        RETURNED = {'name': self.TOPIC_PATH}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        resource = api.topic_get(self.TOPIC_PATH)
-
-        self.assertEqual(resource, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_topic_get_miss(self):
-        from google.cloud.exceptions import NotFound
-        connection = _Connection()
-        api = self._makeOne(connection)
-
-        with self.assertRaises(NotFound):
-            api.topic_get(self.TOPIC_PATH)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_topic_delete_hit(self):
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        api.topic_delete(self.TOPIC_PATH)
-
-        self.assertEqual(connection._called_with['method'], 'DELETE')
-        path = '/%s' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_topic_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        connection = _Connection()
-        api = self._makeOne(connection)
-
-        with self.assertRaises(NotFound):
-            api.topic_delete(self.TOPIC_PATH)
-
-        self.assertEqual(connection._called_with['method'], 'DELETE')
-        path = '/%s' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_topic_publish_hit(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MSGID = 'DEADBEEF'
-        MESSAGE = {'data': B64, 'attributes': {}}
-        RETURNED = {'messageIds': [MSGID]}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        resource = api.topic_publish(self.TOPIC_PATH, [MESSAGE])
-
-        self.assertEqual(resource, [MSGID])
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:publish' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'],
-                         {'messages': [MESSAGE]})
-
-    def test_topic_publish_miss(self):
-        import base64
-        from google.cloud.exceptions import NotFound
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MESSAGE = {'data': B64, 'attributes': {}}
-        connection = _Connection()
-        api = self._makeOne(connection)
-
-        with self.assertRaises(NotFound):
-            api.topic_publish(self.TOPIC_PATH, [MESSAGE])
-
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:publish' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'],
-                         {'messages': [MESSAGE]})
-
-    def test_topic_list_subscriptions_no_paging(self):
-        SUB_INFO = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        RETURNED = {'subscriptions': [SUB_INFO]}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        subscriptions, next_token = api.topic_list_subscriptions(
-            self.TOPIC_PATH)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertIsNone(next_token)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPIC_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-    def test_topic_list_subscriptions_with_paging(self):
-        TOKEN1 = 'TOKEN1'
-        TOKEN2 = 'TOKEN2'
-        SIZE = 1
-        SUB_INFO = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        RETURNED = {
-            'subscriptions': [SUB_INFO],
-            'nextPageToken': 'TOKEN2',
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        subscriptions, next_token = api.topic_list_subscriptions(
-            self.TOPIC_PATH, page_token=TOKEN1, page_size=SIZE)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertEqual(next_token, TOKEN2)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPIC_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'],
-                         {'pageToken': TOKEN1, 'pageSize': SIZE})
-
-    def test_topic_list_subscriptions_missing_key(self):
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        subscriptions, next_token = api.topic_list_subscriptions(
-            self.TOPIC_PATH)
-
-        self.assertEqual(len(subscriptions), 0)
-        self.assertIsNone(next_token)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPIC_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-    def test_topic_list_subscriptions_miss(self):
-        from google.cloud.exceptions import NotFound
-        connection = _Connection()
-        api = self._makeOne(connection)
-
-        with self.assertRaises(NotFound):
-            api.topic_list_subscriptions(self.TOPIC_PATH)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_TOPIC_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-
-class Test_SubscriberAPI(_Base):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.connection import _SubscriberAPI
-        return _SubscriberAPI
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = _Connection()
-        api = self._makeOne(connection)
-        self.assertIs(api._connection, connection)
-
-    def test_list_subscriptions_no_paging(self):
-        SUB_INFO = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        RETURNED = {'subscriptions': [SUB_INFO]}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        subscriptions, next_token = api.list_subscriptions(self.PROJECT)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertIsNone(next_token)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-    def test_list_subscriptions_with_paging(self):
-        TOKEN1 = 'TOKEN1'
-        TOKEN2 = 'TOKEN2'
-        SIZE = 1
-        SUB_INFO = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        RETURNED = {
-            'subscriptions': [SUB_INFO],
-            'nextPageToken': 'TOKEN2',
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        subscriptions, next_token = api.list_subscriptions(
-            self.PROJECT, page_token=TOKEN1, page_size=SIZE)
-
-        self.assertEqual(len(subscriptions), 1)
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, dict)
-        self.assertEqual(subscription['name'], self.SUB_PATH)
-        self.assertEqual(subscription['topic'], self.TOPIC_PATH)
-        self.assertEqual(next_token, TOKEN2)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'],
-                         {'pageToken': TOKEN1, 'pageSize': SIZE})
-
-    def test_list_subscriptions_missing_key(self):
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        subscriptions, next_token = api.list_subscriptions(self.PROJECT)
-
-        self.assertEqual(len(subscriptions), 0)
-        self.assertIsNone(next_token)
-
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.LIST_SUBSCRIPTIONS_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['query_params'], {})
-
-    def test_subscription_create_defaults(self):
-        RESOURCE = {'topic': self.TOPIC_PATH}
-        RETURNED = RESOURCE.copy()
-        RETURNED['name'] = self.SUB_PATH
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        resource = api.subscription_create(self.SUB_PATH, self.TOPIC_PATH)
-
-        self.assertEqual(resource, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'PUT')
-        path = '/%s' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], RESOURCE)
-
-    def test_subscription_create_explicit(self):
-        ACK_DEADLINE = 90
-        PUSH_ENDPOINT = 'https://api.example.com/push'
-        RESOURCE = {
-            'topic': self.TOPIC_PATH,
-            'ackDeadlineSeconds': ACK_DEADLINE,
-            'pushConfig': {
-                'pushEndpoint': PUSH_ENDPOINT,
-            },
-        }
-        RETURNED = RESOURCE.copy()
-        RETURNED['name'] = self.SUB_PATH
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        resource = api.subscription_create(
-            self.SUB_PATH, self.TOPIC_PATH,
-            ack_deadline=ACK_DEADLINE, push_endpoint=PUSH_ENDPOINT)
-
-        self.assertEqual(resource, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'PUT')
-        path = '/%s' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], RESOURCE)
-
-    def test_subscription_get(self):
-        ACK_DEADLINE = 90
-        PUSH_ENDPOINT = 'https://api.example.com/push'
-        RETURNED = {
-            'topic': self.TOPIC_PATH,
-            'name': self.SUB_PATH,
-            'ackDeadlineSeconds': ACK_DEADLINE,
-            'pushConfig': {'pushEndpoint': PUSH_ENDPOINT},
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        resource = api.subscription_get(self.SUB_PATH)
-
-        self.assertEqual(resource, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_subscription_delete(self):
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        api.subscription_delete(self.SUB_PATH)
-
-        self.assertEqual(connection._called_with['method'], 'DELETE')
-        path = '/%s' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_subscription_modify_push_config(self):
-        PUSH_ENDPOINT = 'https://api.example.com/push'
-        BODY = {
-            'pushConfig': {'pushEndpoint': PUSH_ENDPOINT},
-        }
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        api.subscription_modify_push_config(self.SUB_PATH, PUSH_ENDPOINT)
-
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:modifyPushConfig' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], BODY)
-
-    def test_subscription_pull_defaults(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        ACK_ID = 'DEADBEEF'
-        MSG_ID = 'BEADCAFE'
-        MESSAGE = {'messageId': MSG_ID, 'data': B64, 'attributes': {'a': 'b'}}
-        RETURNED = {
-            'receivedMessages': [{'ackId': ACK_ID, 'message': MESSAGE}],
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-        BODY = {
-            'returnImmediately': False,
-            'maxMessages': 1,
-        }
-
-        received = api.subscription_pull(self.SUB_PATH)
-
-        self.assertEqual(received, RETURNED['receivedMessages'])
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:pull' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], BODY)
-
-    def test_subscription_pull_explicit(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        ACK_ID = 'DEADBEEF'
-        MSG_ID = 'BEADCAFE'
-        MESSAGE = {'messageId': MSG_ID, 'data': B64, 'attributes': {'a': 'b'}}
-        RETURNED = {
-            'receivedMessages': [{'ackId': ACK_ID, 'message': MESSAGE}],
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-        MAX_MESSAGES = 10
-        BODY = {
-            'returnImmediately': True,
-            'maxMessages': MAX_MESSAGES,
-        }
-
-        received = api.subscription_pull(
-            self.SUB_PATH, return_immediately=True, max_messages=MAX_MESSAGES)
-
-        self.assertEqual(received, RETURNED['receivedMessages'])
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:pull' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], BODY)
-
-    def test_subscription_acknowledge(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        BODY = {
-            'ackIds': [ACK_ID1, ACK_ID2],
-        }
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        api.subscription_acknowledge(self.SUB_PATH, [ACK_ID1, ACK_ID2])
-
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:acknowledge' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], BODY)
-
-    def test_subscription_modify_ack_deadline(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        NEW_DEADLINE = 90
-        BODY = {
-            'ackIds': [ACK_ID1, ACK_ID2],
-            'ackDeadlineSeconds': NEW_DEADLINE,
-        }
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        api.subscription_modify_ack_deadline(
-            self.SUB_PATH, [ACK_ID1, ACK_ID2], NEW_DEADLINE)
-
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:modifyAckDeadline' % (self.SUB_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'], BODY)
-
-
-class Test_IAMPolicyAPI(_Base):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.connection import _IAMPolicyAPI
-        return _IAMPolicyAPI
-
-    def test_ctor(self):
-        connection = _Connection()
-        api = self._makeOne(connection)
-        self.assertIs(api._connection, connection)
-
-    def test_get_iam_policy(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        OWNER1 = 'user:phred@example.com'
-        OWNER2 = 'group:cloud-logs@google.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        RETURNED = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': OWNER_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-            ],
-        }
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        policy = api.get_iam_policy(self.TOPIC_PATH)
-
-        self.assertEqual(policy, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'GET')
-        path = '/%s:getIamPolicy' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-
-    def test_set_iam_policy(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        OWNER1 = 'user:phred@example.com'
-        OWNER2 = 'group:cloud-logs@google.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        POLICY = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': OWNER_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-            ],
-        }
-        RETURNED = POLICY.copy()
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        policy = api.set_iam_policy(self.TOPIC_PATH, POLICY)
-
-        self.assertEqual(policy, RETURNED)
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:setIamPolicy' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'],
-                         {'policy': POLICY})
-
-    def test_test_iam_permissions(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        ALL_ROLES = [OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE]
-        ALLOWED = ALL_ROLES[1:]
-        RETURNED = {'permissions': ALLOWED}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        allowed = api.test_iam_permissions(self.TOPIC_PATH, ALL_ROLES)
-
-        self.assertEqual(allowed, ALLOWED)
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:testIamPermissions' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'],
-                         {'permissions': ALL_ROLES})
-
-    def test_test_iam_permissions_missing_key(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        ALL_ROLES = [OWNER_ROLE, EDITOR_ROLE, VIEWER_ROLE]
-        RETURNED = {}
-        connection = _Connection(RETURNED)
-        api = self._makeOne(connection)
-
-        allowed = api.test_iam_permissions(self.TOPIC_PATH, ALL_ROLES)
-
-        self.assertEqual(allowed, [])
-        self.assertEqual(connection._called_with['method'], 'POST')
-        path = '/%s:testIamPermissions' % (self.TOPIC_PATH,)
-        self.assertEqual(connection._called_with['path'], path)
-        self.assertEqual(connection._called_with['data'],
-                         {'permissions': ALL_ROLES})
-
-
-class _Connection(object):
-
-    _called_with = None
-    _no_response_error = None
-
-    def __init__(self, *responses):
-        self._responses = responses
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._called_with = kw
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except IndexError:
-            err_class = self._no_response_error or NotFound
-            raise err_class('miss')
-        return response
diff --git a/unit_tests/pubsub/test_iam.py b/unit_tests/pubsub/test_iam.py
deleted file mode 100644
index 4b350864d02e..000000000000
--- a/unit_tests/pubsub/test_iam.py
+++ /dev/null
@@ -1,188 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestPolicy(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.iam import Policy
-        return Policy
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        policy = self._makeOne()
-        self.assertIsNone(policy.etag)
-        self.assertIsNone(policy.version)
-        self.assertEqual(list(policy.owners), [])
-        self.assertEqual(list(policy.editors), [])
-        self.assertEqual(list(policy.viewers), [])
-        self.assertEqual(list(policy.publishers), [])
-        self.assertEqual(list(policy.subscribers), [])
-
-    def test_ctor_explicit(self):
-        VERSION = 17
-        ETAG = 'ETAG'
-        policy = self._makeOne(ETAG, VERSION)
-        self.assertEqual(policy.etag, ETAG)
-        self.assertEqual(policy.version, VERSION)
-        self.assertEqual(list(policy.owners), [])
-        self.assertEqual(list(policy.editors), [])
-        self.assertEqual(list(policy.viewers), [])
-        self.assertEqual(list(policy.publishers), [])
-        self.assertEqual(list(policy.subscribers), [])
-
-    def test_user(self):
-        EMAIL = 'phred@example.com'
-        MEMBER = 'user:%s' % (EMAIL,)
-        policy = self._makeOne()
-        self.assertEqual(policy.user(EMAIL), MEMBER)
-
-    def test_service_account(self):
-        EMAIL = 'phred@example.com'
-        MEMBER = 'serviceAccount:%s' % (EMAIL,)
-        policy = self._makeOne()
-        self.assertEqual(policy.service_account(EMAIL), MEMBER)
-
-    def test_group(self):
-        EMAIL = 'phred@example.com'
-        MEMBER = 'group:%s' % (EMAIL,)
-        policy = self._makeOne()
-        self.assertEqual(policy.group(EMAIL), MEMBER)
-
-    def test_domain(self):
-        DOMAIN = 'example.com'
-        MEMBER = 'domain:%s' % (DOMAIN,)
-        policy = self._makeOne()
-        self.assertEqual(policy.domain(DOMAIN), MEMBER)
-
-    def test_all_users(self):
-        policy = self._makeOne()
-        self.assertEqual(policy.all_users(), 'allUsers')
-
-    def test_authenticated_users(self):
-        policy = self._makeOne()
-        self.assertEqual(policy.authenticated_users(), 'allAuthenticatedUsers')
-
-    def test_from_api_repr_only_etag(self):
-        RESOURCE = {
-            'etag': 'ACAB',
-        }
-        klass = self._getTargetClass()
-        policy = klass.from_api_repr(RESOURCE)
-        self.assertEqual(policy.etag, 'ACAB')
-        self.assertIsNone(policy.version)
-        self.assertEqual(list(policy.owners), [])
-        self.assertEqual(list(policy.editors), [])
-        self.assertEqual(list(policy.viewers), [])
-
-    def test_from_api_repr_complete(self):
-        from google.cloud.pubsub.iam import (
-            OWNER_ROLE,
-            EDITOR_ROLE,
-            VIEWER_ROLE,
-            PUBSUB_PUBLISHER_ROLE,
-            PUBSUB_SUBSCRIBER_ROLE,
-        )
-        OWNER1 = 'user:phred@example.com'
-        OWNER2 = 'group:cloud-logs@google.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        PUBLISHER = 'user:phred@example.com'
-        SUBSCRIBER = 'serviceAccount:1234-abcdef@service.example.com'
-        RESOURCE = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': OWNER_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-                {'role': PUBSUB_PUBLISHER_ROLE, 'members': [PUBLISHER]},
-                {'role': PUBSUB_SUBSCRIBER_ROLE, 'members': [SUBSCRIBER]},
-            ],
-        }
-        klass = self._getTargetClass()
-        policy = klass.from_api_repr(RESOURCE)
-        self.assertEqual(policy.etag, 'DEADBEEF')
-        self.assertEqual(policy.version, 17)
-        self.assertEqual(sorted(policy.owners), [OWNER2, OWNER1])
-        self.assertEqual(sorted(policy.editors), [EDITOR1, EDITOR2])
-        self.assertEqual(sorted(policy.viewers), [VIEWER1, VIEWER2])
-        self.assertEqual(sorted(policy.publishers), [PUBLISHER])
-        self.assertEqual(sorted(policy.subscribers), [SUBSCRIBER])
-
-    def test_from_api_repr_bad_role(self):
-        BOGUS1 = 'user:phred@example.com'
-        BOGUS2 = 'group:cloud-logs@google.com'
-        RESOURCE = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': 'nonesuch', 'members': [BOGUS1, BOGUS2]},
-            ],
-        }
-        klass = self._getTargetClass()
-        with self.assertRaises(ValueError):
-            klass.from_api_repr(RESOURCE)
-
-    def test_to_api_repr_defaults(self):
-        policy = self._makeOne()
-        self.assertEqual(policy.to_api_repr(), {})
-
-    def test_to_api_repr_only_etag(self):
-        policy = self._makeOne('DEADBEEF')
-        self.assertEqual(policy.to_api_repr(), {'etag': 'DEADBEEF'})
-
-    def test_to_api_repr_full(self):
-        from google.cloud.pubsub.iam import (
-            PUBSUB_ADMIN_ROLE,
-            PUBSUB_EDITOR_ROLE,
-            PUBSUB_VIEWER_ROLE,
-            PUBSUB_PUBLISHER_ROLE,
-            PUBSUB_SUBSCRIBER_ROLE,
-        )
-        OWNER1 = 'group:cloud-logs@google.com'
-        OWNER2 = 'user:phred@example.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        PUBLISHER = 'user:phred@example.com'
-        SUBSCRIBER = 'serviceAccount:1234-abcdef@service.example.com'
-        EXPECTED = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': PUBSUB_ADMIN_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': PUBSUB_EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': PUBSUB_VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-                {'role': PUBSUB_PUBLISHER_ROLE, 'members': [PUBLISHER]},
-                {'role': PUBSUB_SUBSCRIBER_ROLE, 'members': [SUBSCRIBER]},
-            ],
-        }
-        policy = self._makeOne('DEADBEEF', 17)
-        policy.owners.add(OWNER1)
-        policy.owners.add(OWNER2)
-        policy.editors.add(EDITOR1)
-        policy.editors.add(EDITOR2)
-        policy.viewers.add(VIEWER1)
-        policy.viewers.add(VIEWER2)
-        policy.publishers.add(PUBLISHER)
-        policy.subscribers.add(SUBSCRIBER)
-        self.assertEqual(policy.to_api_repr(), EXPECTED)
diff --git a/unit_tests/pubsub/test_message.py b/unit_tests/pubsub/test_message.py
deleted file mode 100644
index fe7cc5e43591..000000000000
--- a/unit_tests/pubsub/test_message.py
+++ /dev/null
@@ -1,126 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestMessage(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.message import Message
-        return Message
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_no_attributes(self):
-        DATA = b'DEADBEEF'
-        MESSAGE_ID = b'12345'
-        message = self._makeOne(data=DATA, message_id=MESSAGE_ID)
-        self.assertEqual(message.data, DATA)
-        self.assertEqual(message.message_id, MESSAGE_ID)
-        self.assertEqual(message.attributes, {})
-        self.assertIsNone(message.service_timestamp)
-
-    def test_ctor_w_attributes(self):
-        DATA = b'DEADBEEF'
-        MESSAGE_ID = b'12345'
-        ATTRS = {'a': 'b'}
-        message = self._makeOne(data=DATA, message_id=MESSAGE_ID,
-                                attributes=ATTRS)
-        self.assertEqual(message.data, DATA)
-        self.assertEqual(message.message_id, MESSAGE_ID)
-        self.assertEqual(message.attributes, ATTRS)
-        self.assertIsNone(message.service_timestamp)
-
-    def test_timestamp_no_attributes(self):
-        DATA = b'DEADBEEF'
-        MESSAGE_ID = b'12345'
-        message = self._makeOne(data=DATA, message_id=MESSAGE_ID)
-
-        def _to_fail():
-            return message.timestamp
-
-        self.assertRaises(ValueError, _to_fail)
-
-    def test_timestamp_wo_timestamp_in_attributes(self):
-        DATA = b'DEADBEEF'
-        MESSAGE_ID = b'12345'
-        ATTRS = {'a': 'b'}
-        message = self._makeOne(data=DATA, message_id=MESSAGE_ID,
-                                attributes=ATTRS)
-
-        def _to_fail():
-            return message.timestamp
-
-        self.assertRaises(ValueError, _to_fail)
-
-    def test_timestamp_w_timestamp_in_attributes(self):
-        from datetime import datetime
-        from google.cloud._helpers import _RFC3339_MICROS
-        from google.cloud._helpers import UTC
-        DATA = b'DEADBEEF'
-        MESSAGE_ID = b'12345'
-        TIMESTAMP = '2015-04-10T18:42:27.131956Z'
-        naive = datetime.strptime(TIMESTAMP, _RFC3339_MICROS)
-        timestamp = naive.replace(tzinfo=UTC)
-        ATTRS = {'timestamp': TIMESTAMP}
-        message = self._makeOne(data=DATA, message_id=MESSAGE_ID,
-                                attributes=ATTRS)
-        self.assertEqual(message.timestamp, timestamp)
-
-    def test_from_api_repr_missing_data(self):
-        MESSAGE_ID = '12345'
-        api_repr = {'messageId': MESSAGE_ID}
-        message = self._getTargetClass().from_api_repr(api_repr)
-        self.assertEqual(message.data, b'')
-        self.assertEqual(message.message_id, MESSAGE_ID)
-        self.assertEqual(message.attributes, {})
-        self.assertIsNone(message.service_timestamp)
-
-    def test_from_api_repr_no_attributes(self):
-        from base64 import b64encode as b64
-        DATA = b'DEADBEEF'
-        B64_DATA = b64(DATA)
-        MESSAGE_ID = '12345'
-        TIMESTAMP = '2016-03-18-19:38:22.001393427Z'
-        api_repr = {
-            'data': B64_DATA,
-            'messageId': MESSAGE_ID,
-            'publishTimestamp': TIMESTAMP,
-        }
-        message = self._getTargetClass().from_api_repr(api_repr)
-        self.assertEqual(message.data, DATA)
-        self.assertEqual(message.message_id, MESSAGE_ID)
-        self.assertEqual(message.attributes, {})
-        self.assertEqual(message.service_timestamp, TIMESTAMP)
-
-    def test_from_api_repr_w_attributes(self):
-        from base64 import b64encode as b64
-        DATA = b'DEADBEEF'
-        B64_DATA = b64(DATA)
-        MESSAGE_ID = '12345'
-        ATTRS = {'a': 'b'}
-        TIMESTAMP = '2016-03-18-19:38:22.001393427Z'
-        api_repr = {
-            'data': B64_DATA,
-            'messageId': MESSAGE_ID,
-            'publishTimestamp': TIMESTAMP,
-            'attributes': ATTRS,
-        }
-        message = self._getTargetClass().from_api_repr(api_repr)
-        self.assertEqual(message.data, DATA)
-        self.assertEqual(message.message_id, MESSAGE_ID)
-        self.assertEqual(message.service_timestamp, TIMESTAMP)
-        self.assertEqual(message.attributes, ATTRS)
diff --git a/unit_tests/pubsub/test_subscription.py b/unit_tests/pubsub/test_subscription.py
deleted file mode 100644
index f393656002c4..000000000000
--- a/unit_tests/pubsub/test_subscription.py
+++ /dev/null
@@ -1,811 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestSubscription(unittest.TestCase):
-    PROJECT = 'PROJECT'
-    TOPIC_NAME = 'topic_name'
-    TOPIC_PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-    SUB_NAME = 'sub_name'
-    SUB_PATH = 'projects/%s/subscriptions/%s' % (PROJECT, SUB_NAME)
-    DEADLINE = 42
-    ENDPOINT = 'https://api.example.com/push'
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.subscription import Subscription
-        return Subscription
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        client = _Client(project=self.PROJECT)
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        self.assertIs(subscription.topic, topic)
-        self.assertIsNone(subscription.ack_deadline)
-        self.assertIsNone(subscription.push_endpoint)
-
-    def test_ctor_explicit(self):
-        client = _Client(project=self.PROJECT)
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic,
-                                     self.DEADLINE, self.ENDPOINT)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        self.assertIs(subscription.topic, topic)
-        self.assertEqual(subscription.ack_deadline, self.DEADLINE)
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-
-    def test_ctor_w_client_wo_topic(self):
-        client = _Client(project=self.PROJECT)
-        subscription = self._makeOne(self.SUB_NAME, client=client)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        self.assertIsNone(subscription.topic)
-
-    def test_ctor_w_both_topic_and_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        with self.assertRaises(TypeError):
-            self._makeOne(self.SUB_NAME, topic, client=client2)
-
-    def test_ctor_w_neither_topic_nor_client(self):
-        with self.assertRaises(TypeError):
-            self._makeOne(self.SUB_NAME)
-
-    def test_from_api_repr_no_topics(self):
-        from google.cloud.pubsub.topic import Topic
-        resource = {'topic': self.TOPIC_PATH,
-                    'name': self.SUB_PATH,
-                    'ackDeadlineSeconds': self.DEADLINE,
-                    'pushConfig': {'pushEndpoint': self.ENDPOINT}}
-        klass = self._getTargetClass()
-        client = _Client(project=self.PROJECT)
-        subscription = klass.from_api_repr(resource, client)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        topic = subscription.topic
-        self.assertIsInstance(topic, Topic)
-        self.assertEqual(topic.name, self.TOPIC_NAME)
-        self.assertEqual(topic.project, self.PROJECT)
-        self.assertEqual(subscription.ack_deadline, self.DEADLINE)
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-
-    def test_from_api_repr_w_deleted_topic(self):
-        klass = self._getTargetClass()
-        resource = {'topic': klass._DELETED_TOPIC_PATH,
-                    'name': self.SUB_PATH,
-                    'ackDeadlineSeconds': self.DEADLINE,
-                    'pushConfig': {'pushEndpoint': self.ENDPOINT}}
-        klass = self._getTargetClass()
-        client = _Client(project=self.PROJECT)
-        subscription = klass.from_api_repr(resource, client)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        self.assertIsNone(subscription.topic)
-        self.assertEqual(subscription.ack_deadline, self.DEADLINE)
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-
-    def test_from_api_repr_w_topics_no_topic_match(self):
-        from google.cloud.pubsub.topic import Topic
-        resource = {'topic': self.TOPIC_PATH,
-                    'name': self.SUB_PATH,
-                    'ackDeadlineSeconds': self.DEADLINE,
-                    'pushConfig': {'pushEndpoint': self.ENDPOINT}}
-        topics = {}
-        klass = self._getTargetClass()
-        client = _Client(project=self.PROJECT)
-        subscription = klass.from_api_repr(resource, client, topics=topics)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        topic = subscription.topic
-        self.assertIsInstance(topic, Topic)
-        self.assertIs(topic, topics[self.TOPIC_PATH])
-        self.assertEqual(topic.name, self.TOPIC_NAME)
-        self.assertEqual(topic.project, self.PROJECT)
-        self.assertEqual(subscription.ack_deadline, self.DEADLINE)
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-
-    def test_from_api_repr_w_topics_w_topic_match(self):
-        resource = {'topic': self.TOPIC_PATH,
-                    'name': self.SUB_PATH,
-                    'ackDeadlineSeconds': self.DEADLINE,
-                    'pushConfig': {'pushEndpoint': self.ENDPOINT}}
-        client = _Client(project=self.PROJECT)
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        topics = {self.TOPIC_PATH: topic}
-        klass = self._getTargetClass()
-        subscription = klass.from_api_repr(resource, client, topics=topics)
-        self.assertEqual(subscription.name, self.SUB_NAME)
-        self.assertIs(subscription.topic, topic)
-        self.assertEqual(subscription.ack_deadline, self.DEADLINE)
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-
-    def test_full_name_and_path(self):
-        PROJECT = 'PROJECT'
-        SUB_FULL = 'projects/%s/subscriptions/%s' % (PROJECT, self.SUB_NAME)
-        SUB_PATH = '/%s' % (SUB_FULL,)
-        TOPIC_NAME = 'topic_name'
-        CLIENT = _Client(project=PROJECT)
-        topic = _Topic(TOPIC_NAME, client=CLIENT)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-        self.assertEqual(subscription.full_name, SUB_FULL)
-        self.assertEqual(subscription.path, SUB_PATH)
-
-    def test_autoack_defaults(self):
-        from google.cloud.pubsub.subscription import AutoAck
-        client = _Client(project=self.PROJECT)
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-        auto_ack = subscription.auto_ack()
-        self.assertIsInstance(auto_ack, AutoAck)
-        self.assertIs(auto_ack._subscription, subscription)
-        self.assertEqual(auto_ack._return_immediately, False)
-        self.assertEqual(auto_ack._max_messages, 1)
-        self.assertIsNone(auto_ack._client)
-
-    def test_autoack_explicit(self):
-        from google.cloud.pubsub.subscription import AutoAck
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-        auto_ack = subscription.auto_ack(True, 10, client2)
-        self.assertIsInstance(auto_ack, AutoAck)
-        self.assertIs(auto_ack._subscription, subscription)
-        self.assertEqual(auto_ack._return_immediately, True)
-        self.assertEqual(auto_ack._max_messages, 10)
-        self.assertIs(auto_ack._client, client2)
-
-    def test_create_pull_wo_ack_deadline_w_bound_client(self):
-        RESPONSE = {
-            'topic': self.TOPIC_PATH,
-            'name': self.SUB_PATH,
-        }
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_create_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.create()
-
-        self.assertEqual(api._subscription_created,
-                         (self.SUB_PATH, self.TOPIC_PATH, None, None))
-
-    def test_create_push_w_ack_deadline_w_alternate_client(self):
-        RESPONSE = {
-            'topic': self.TOPIC_PATH,
-            'name': self.SUB_PATH,
-            'ackDeadlineSeconds': self.DEADLINE,
-            'pushConfig': {'pushEndpoint': self.ENDPOINT}
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_create_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic,
-                                     self.DEADLINE, self.ENDPOINT)
-
-        subscription.create(client=client2)
-
-        self.assertEqual(
-            api._subscription_created,
-            (self.SUB_PATH, self.TOPIC_PATH, self.DEADLINE, self.ENDPOINT))
-
-    def test_exists_miss_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        self.assertFalse(subscription.exists())
-
-        self.assertEqual(api._subscription_got, self.SUB_PATH)
-
-    def test_exists_hit_w_alternate_client(self):
-        RESPONSE = {'name': self.SUB_PATH, 'topic': self.TOPIC_PATH}
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_get_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        self.assertTrue(subscription.exists(client=client2))
-
-        self.assertEqual(api._subscription_got, self.SUB_PATH)
-
-    def test_reload_w_bound_client(self):
-        RESPONSE = {
-            'name': self.SUB_PATH,
-            'topic': self.TOPIC_PATH,
-            'ackDeadlineSeconds': self.DEADLINE,
-            'pushConfig': {'pushEndpoint': self.ENDPOINT},
-        }
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_get_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.reload()
-
-        self.assertEqual(subscription.ack_deadline, self.DEADLINE)
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-        self.assertEqual(api._subscription_got, self.SUB_PATH)
-
-    def test_reload_w_alternate_client(self):
-        RESPONSE = {
-            'name': self.SUB_PATH,
-            'topic': self.TOPIC_PATH,
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_get_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic,
-                                     self.DEADLINE, self.ENDPOINT)
-
-        subscription.reload(client=client2)
-
-        self.assertIsNone(subscription.ack_deadline)
-        self.assertIsNone(subscription.push_endpoint)
-        self.assertEqual(api._subscription_got, self.SUB_PATH)
-
-    def test_delete_w_bound_client(self):
-        RESPONSE = {}
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_delete_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.delete()
-
-        self.assertEqual(api._subscription_deleted, self.SUB_PATH)
-
-    def test_delete_w_alternate_client(self):
-        RESPONSE = {}
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_delete_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic,
-                                     self.DEADLINE, self.ENDPOINT)
-
-        subscription.delete(client=client2)
-
-        self.assertEqual(api._subscription_deleted, self.SUB_PATH)
-
-    def test_modify_push_config_w_endpoint_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_modify_push_config_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.modify_push_configuration(push_endpoint=self.ENDPOINT)
-
-        self.assertEqual(subscription.push_endpoint, self.ENDPOINT)
-        self.assertEqual(api._subscription_modified_push_config,
-                         (self.SUB_PATH, self.ENDPOINT))
-
-    def test_modify_push_config_wo_endpoint_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_modify_push_config_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic,
-                                     push_endpoint=self.ENDPOINT)
-
-        subscription.modify_push_configuration(push_endpoint=None,
-                                               client=client2)
-
-        self.assertIsNone(subscription.push_endpoint)
-        self.assertEqual(api._subscription_modified_push_config,
-                         (self.SUB_PATH, None))
-
-    def test_pull_wo_return_immediately_max_messages_w_bound_client(self):
-        import base64
-        from google.cloud.pubsub.message import Message
-        ACK_ID = 'DEADBEEF'
-        MSG_ID = 'BEADCAFE'
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD)
-        MESSAGE = {'messageId': MSG_ID, 'data': B64}
-        REC_MESSAGE = {'ackId': ACK_ID, 'message': MESSAGE}
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_pull_response = [REC_MESSAGE]
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        pulled = subscription.pull()
-
-        self.assertEqual(len(pulled), 1)
-        ack_id, message = pulled[0]
-        self.assertEqual(ack_id, ACK_ID)
-        self.assertIsInstance(message, Message)
-        self.assertEqual(message.data, PAYLOAD)
-        self.assertEqual(message.message_id, MSG_ID)
-        self.assertEqual(message.attributes, {})
-        self.assertEqual(api._subscription_pulled,
-                         (self.SUB_PATH, False, 1))
-
-    def test_pull_w_return_immediately_w_max_messages_w_alt_client(self):
-        import base64
-        from google.cloud.pubsub.message import Message
-        ACK_ID = 'DEADBEEF'
-        MSG_ID = 'BEADCAFE'
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD)
-        MESSAGE = {'messageId': MSG_ID, 'data': B64, 'attributes': {'a': 'b'}}
-        REC_MESSAGE = {'ackId': ACK_ID, 'message': MESSAGE}
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_pull_response = [REC_MESSAGE]
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        pulled = subscription.pull(return_immediately=True, max_messages=3,
-                                   client=client2)
-
-        self.assertEqual(len(pulled), 1)
-        ack_id, message = pulled[0]
-        self.assertEqual(ack_id, ACK_ID)
-        self.assertIsInstance(message, Message)
-        self.assertEqual(message.data, PAYLOAD)
-        self.assertEqual(message.message_id, MSG_ID)
-        self.assertEqual(message.attributes, {'a': 'b'})
-        self.assertEqual(api._subscription_pulled,
-                         (self.SUB_PATH, True, 3))
-
-    def test_pull_wo_receivedMessages(self):
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_pull_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        pulled = subscription.pull(return_immediately=False)
-
-        self.assertEqual(len(pulled), 0)
-        self.assertEqual(api._subscription_pulled,
-                         (self.SUB_PATH, False, 1))
-
-    def test_acknowledge_w_bound_client(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_acknowlege_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.acknowledge([ACK_ID1, ACK_ID2])
-
-        self.assertEqual(api._subscription_acked,
-                         (self.SUB_PATH, [ACK_ID1, ACK_ID2]))
-
-    def test_acknowledge_w_alternate_client(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_acknowlege_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.acknowledge([ACK_ID1, ACK_ID2], client=client2)
-
-        self.assertEqual(api._subscription_acked,
-                         (self.SUB_PATH, [ACK_ID1, ACK_ID2]))
-
-    def test_modify_ack_deadline_w_bound_client(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        client = _Client(project=self.PROJECT)
-        api = client.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_modify_ack_deadline_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.modify_ack_deadline([ACK_ID1, ACK_ID2], self.DEADLINE)
-
-        self.assertEqual(api._subscription_modified_ack_deadline,
-                         (self.SUB_PATH, [ACK_ID1, ACK_ID2], self.DEADLINE))
-
-    def test_modify_ack_deadline_w_alternate_client(self):
-        ACK_ID1 = 'DEADBEEF'
-        ACK_ID2 = 'BEADCAFE'
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.subscriber_api = _FauxSubscribererAPI()
-        api._subscription_modify_ack_deadline_response = {}
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        subscription.modify_ack_deadline(
-            [ACK_ID1, ACK_ID2], self.DEADLINE, client=client2)
-
-        self.assertEqual(api._subscription_modified_ack_deadline,
-                         (self.SUB_PATH, [ACK_ID1, ACK_ID2], self.DEADLINE))
-
-    def test_get_iam_policy_w_bound_client(self):
-        from google.cloud.pubsub.iam import (
-            PUBSUB_ADMIN_ROLE,
-            PUBSUB_EDITOR_ROLE,
-            PUBSUB_VIEWER_ROLE,
-            PUBSUB_PUBLISHER_ROLE,
-            PUBSUB_SUBSCRIBER_ROLE,
-        )
-        OWNER1 = 'user:phred@example.com'
-        OWNER2 = 'group:cloud-logs@google.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        PUBLISHER = 'user:phred@example.com'
-        SUBSCRIBER = 'serviceAccount:1234-abcdef@service.example.com'
-        POLICY = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': PUBSUB_ADMIN_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': PUBSUB_EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': PUBSUB_VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-                {'role': PUBSUB_PUBLISHER_ROLE, 'members': [PUBLISHER]},
-                {'role': PUBSUB_SUBSCRIBER_ROLE, 'members': [SUBSCRIBER]},
-            ],
-        }
-        client = _Client(project=self.PROJECT)
-        api = client.iam_policy_api = _FauxIAMPolicy()
-        api._get_iam_policy_response = POLICY
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        policy = subscription.get_iam_policy()
-
-        self.assertEqual(policy.etag, 'DEADBEEF')
-        self.assertEqual(policy.version, 17)
-        self.assertEqual(sorted(policy.owners), [OWNER2, OWNER1])
-        self.assertEqual(sorted(policy.editors), [EDITOR1, EDITOR2])
-        self.assertEqual(sorted(policy.viewers), [VIEWER1, VIEWER2])
-        self.assertEqual(sorted(policy.publishers), [PUBLISHER])
-        self.assertEqual(sorted(policy.subscribers), [SUBSCRIBER])
-        self.assertEqual(api._got_iam_policy, self.SUB_PATH)
-
-    def test_get_iam_policy_w_alternate_client(self):
-        POLICY = {
-            'etag': 'ACAB',
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.iam_policy_api = _FauxIAMPolicy()
-        api._get_iam_policy_response = POLICY
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        policy = subscription.get_iam_policy(client=client2)
-
-        self.assertEqual(policy.etag, 'ACAB')
-        self.assertIsNone(policy.version)
-        self.assertEqual(sorted(policy.owners), [])
-        self.assertEqual(sorted(policy.editors), [])
-        self.assertEqual(sorted(policy.viewers), [])
-
-        self.assertEqual(api._got_iam_policy, self.SUB_PATH)
-
-    def test_set_iam_policy_w_bound_client(self):
-        from google.cloud.pubsub.iam import Policy
-        from google.cloud.pubsub.iam import (
-            PUBSUB_ADMIN_ROLE,
-            PUBSUB_EDITOR_ROLE,
-            PUBSUB_VIEWER_ROLE,
-            PUBSUB_PUBLISHER_ROLE,
-            PUBSUB_SUBSCRIBER_ROLE,
-        )
-        OWNER1 = 'group:cloud-logs@google.com'
-        OWNER2 = 'user:phred@example.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        PUBLISHER = 'user:phred@example.com'
-        SUBSCRIBER = 'serviceAccount:1234-abcdef@service.example.com'
-        POLICY = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': PUBSUB_ADMIN_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': PUBSUB_EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': PUBSUB_VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-                {'role': PUBSUB_PUBLISHER_ROLE, 'members': [PUBLISHER]},
-                {'role': PUBSUB_SUBSCRIBER_ROLE, 'members': [SUBSCRIBER]},
-            ],
-        }
-        RESPONSE = POLICY.copy()
-        RESPONSE['etag'] = 'ABACABAF'
-        RESPONSE['version'] = 18
-        client = _Client(project=self.PROJECT)
-        api = client.iam_policy_api = _FauxIAMPolicy()
-        api._set_iam_policy_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-        policy = Policy('DEADBEEF', 17)
-        policy.owners.add(OWNER1)
-        policy.owners.add(OWNER2)
-        policy.editors.add(EDITOR1)
-        policy.editors.add(EDITOR2)
-        policy.viewers.add(VIEWER1)
-        policy.viewers.add(VIEWER2)
-        policy.publishers.add(PUBLISHER)
-        policy.subscribers.add(SUBSCRIBER)
-
-        new_policy = subscription.set_iam_policy(policy)
-
-        self.assertEqual(new_policy.etag, 'ABACABAF')
-        self.assertEqual(new_policy.version, 18)
-        self.assertEqual(sorted(new_policy.owners), [OWNER1, OWNER2])
-        self.assertEqual(sorted(new_policy.editors), [EDITOR1, EDITOR2])
-        self.assertEqual(sorted(new_policy.viewers), [VIEWER1, VIEWER2])
-        self.assertEqual(sorted(new_policy.publishers), [PUBLISHER])
-        self.assertEqual(sorted(new_policy.subscribers), [SUBSCRIBER])
-        self.assertEqual(api._set_iam_policy, (self.SUB_PATH, POLICY))
-
-    def test_set_iam_policy_w_alternate_client(self):
-        from google.cloud.pubsub.iam import Policy
-        RESPONSE = {'etag': 'ACAB'}
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.iam_policy_api = _FauxIAMPolicy()
-        api._set_iam_policy_response = RESPONSE
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        policy = Policy()
-        new_policy = subscription.set_iam_policy(policy, client=client2)
-
-        self.assertEqual(new_policy.etag, 'ACAB')
-        self.assertIsNone(new_policy.version)
-        self.assertEqual(sorted(new_policy.owners), [])
-        self.assertEqual(sorted(new_policy.editors), [])
-        self.assertEqual(sorted(new_policy.viewers), [])
-        self.assertEqual(api._set_iam_policy, (self.SUB_PATH, {}))
-
-    def test_check_iam_permissions_w_bound_client(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        ROLES = [VIEWER_ROLE, EDITOR_ROLE, OWNER_ROLE]
-        client = _Client(project=self.PROJECT)
-        api = client.iam_policy_api = _FauxIAMPolicy()
-        api._test_iam_permissions_response = ROLES[:-1]
-        topic = _Topic(self.TOPIC_NAME, client=client)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        allowed = subscription.check_iam_permissions(ROLES)
-
-        self.assertEqual(allowed, ROLES[:-1])
-        self.assertEqual(api._tested_iam_permissions,
-                         (self.SUB_PATH, ROLES))
-
-    def test_check_iam_permissions_w_alternate_client(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        ROLES = [VIEWER_ROLE, EDITOR_ROLE, OWNER_ROLE]
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.iam_policy_api = _FauxIAMPolicy()
-        api._test_iam_permissions_response = []
-        topic = _Topic(self.TOPIC_NAME, client=client1)
-        subscription = self._makeOne(self.SUB_NAME, topic)
-
-        allowed = subscription.check_iam_permissions(ROLES, client=client2)
-
-        self.assertEqual(len(allowed), 0)
-        self.assertEqual(api._tested_iam_permissions,
-                         (self.SUB_PATH, ROLES))
-
-
-class _FauxSubscribererAPI(object):
-
-    def subscription_create(self, subscription_path, topic_path,
-                            ack_deadline=None, push_endpoint=None):
-        self._subscription_created = (
-            subscription_path, topic_path, ack_deadline, push_endpoint)
-        return self._subscription_create_response
-
-    def subscription_get(self, subscription_path):
-        from google.cloud.exceptions import NotFound
-        self._subscription_got = subscription_path
-        try:
-            return self._subscription_get_response
-        except AttributeError:
-            raise NotFound(subscription_path)
-
-    def subscription_delete(self, subscription_path):
-        self._subscription_deleted = subscription_path
-        return self._subscription_delete_response
-
-    def subscription_modify_push_config(
-            self, subscription_path, push_endpoint):
-        self._subscription_modified_push_config = (
-            subscription_path, push_endpoint)
-        return self._subscription_modify_push_config_response
-
-    def subscription_pull(self, subscription_path, return_immediately,
-                          max_messages):
-        self._subscription_pulled = (
-            subscription_path, return_immediately, max_messages)
-        return self._subscription_pull_response
-
-    def subscription_acknowledge(self, subscription_path, ack_ids):
-        self._subscription_acked = (subscription_path, ack_ids)
-        return self._subscription_acknowlege_response
-
-    def subscription_modify_ack_deadline(self, subscription_path, ack_ids,
-                                         ack_deadline):
-        self._subscription_modified_ack_deadline = (
-            subscription_path, ack_ids, ack_deadline)
-        return self._subscription_modify_ack_deadline_response
-
-
-class TestAutoAck(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.subscription import AutoAck
-        return AutoAck
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        subscription = _FauxSubscription(())
-        auto_ack = self._makeOne(subscription)
-        self.assertEqual(auto_ack._return_immediately, False)
-        self.assertEqual(auto_ack._max_messages, 1)
-        self.assertIsNone(auto_ack._client)
-
-    def test_ctor_explicit(self):
-        CLIENT = object()
-        subscription = _FauxSubscription(())
-        auto_ack = self._makeOne(
-            subscription, return_immediately=True, max_messages=10,
-            client=CLIENT)
-        self.assertIs(auto_ack._subscription, subscription)
-        self.assertEqual(auto_ack._return_immediately, True)
-        self.assertEqual(auto_ack._max_messages, 10)
-        self.assertIs(auto_ack._client, CLIENT)
-
-    def test___enter___w_defaults(self):
-        subscription = _FauxSubscription(())
-        auto_ack = self._makeOne(subscription)
-
-        with auto_ack as returned:
-            pass
-
-        self.assertIs(returned, auto_ack)
-        self.assertEqual(subscription._return_immediately, False)
-        self.assertEqual(subscription._max_messages, 1)
-        self.assertIsNone(subscription._client)
-
-    def test___enter___w_explicit(self):
-        CLIENT = object()
-        subscription = _FauxSubscription(())
-        auto_ack = self._makeOne(
-            subscription, return_immediately=True, max_messages=10,
-            client=CLIENT)
-
-        with auto_ack as returned:
-            pass
-
-        self.assertIs(returned, auto_ack)
-        self.assertEqual(subscription._return_immediately, True)
-        self.assertEqual(subscription._max_messages, 10)
-        self.assertIs(subscription._client, CLIENT)
-
-    def test___exit___(self):
-        CLIENT = object()
-        ACK_ID1, MESSAGE1 = 'ACK_ID1', _FallibleMessage()
-        ACK_ID2, MESSAGE2 = 'ACK_ID2', _FallibleMessage()
-        ACK_ID3, MESSAGE3 = 'ACK_ID3', _FallibleMessage(True)
-        ITEMS = [
-            (ACK_ID1, MESSAGE1),
-            (ACK_ID2, MESSAGE2),
-            (ACK_ID3, MESSAGE3),
-        ]
-        subscription = _FauxSubscription(ITEMS)
-        auto_ack = self._makeOne(subscription, client=CLIENT)
-        with auto_ack:
-            for ack_id, message in list(auto_ack.items()):
-                if message.fail:
-                    del auto_ack[ack_id]
-        self.assertEqual(sorted(subscription._acknowledged),
-                         [ACK_ID1, ACK_ID2])
-        self.assertIs(subscription._ack_client, CLIENT)
-
-
-class _FauxIAMPolicy(object):
-
-    def get_iam_policy(self, target_path):
-        self._got_iam_policy = target_path
-        return self._get_iam_policy_response
-
-    def set_iam_policy(self, target_path, policy):
-        self._set_iam_policy = target_path, policy
-        return self._set_iam_policy_response
-
-    def test_iam_permissions(self, target_path, permissions):
-        self._tested_iam_permissions = target_path, permissions
-        return self._test_iam_permissions_response
-
-
-class _Topic(object):
-
-    def __init__(self, name, client):
-        self.name = name
-        self._client = client
-        self.project = client.project
-        self.full_name = 'projects/%s/topics/%s' % (client.project, name)
-        self.path = '/projects/%s/topics/%s' % (client.project, name)
-
-
-class _Client(object):
-
-    connection = None
-
-    def __init__(self, project):
-        self.project = project
-
-    def topic(self, name, timestamp_messages=False):
-        from google.cloud.pubsub.topic import Topic
-        return Topic(name, client=self, timestamp_messages=timestamp_messages)
-
-
-class _FallibleMessage(object):
-
-    def __init__(self, fail=False):
-        self.fail = fail
-
-
-class _FauxSubscription(object):
-
-    def __init__(self, items):
-        self._items = items
-        self._mapping = dict(items)
-        self._acknowledged = set()
-
-    def pull(self, return_immediately=False, max_messages=1, client=None):
-        self._return_immediately = return_immediately
-        self._max_messages = max_messages
-        self._client = client
-        return self._items
-
-    def acknowledge(self, ack_ids, client=None):
-        self._ack_client = client
-        for ack_id in ack_ids:
-            message = self._mapping[ack_id]
-            assert not message.fail
-            self._acknowledged.add(ack_id)
diff --git a/unit_tests/pubsub/test_topic.py b/unit_tests/pubsub/test_topic.py
deleted file mode 100644
index 4e06dedf8346..000000000000
--- a/unit_tests/pubsub/test_topic.py
+++ /dev/null
@@ -1,803 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestTopic(unittest.TestCase):
-    PROJECT = 'PROJECT'
-    TOPIC_NAME = 'topic_name'
-    TOPIC_PATH = 'projects/%s/topics/%s' % (PROJECT, TOPIC_NAME)
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.topic import Topic
-        return Topic
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_w_explicit_timestamp(self):
-        client = _Client(project=self.PROJECT)
-        topic = self._makeOne(self.TOPIC_NAME,
-                              client=client,
-                              timestamp_messages=True)
-        self.assertEqual(topic.name, self.TOPIC_NAME)
-        self.assertEqual(topic.project, self.PROJECT)
-        self.assertEqual(topic.full_name, self.TOPIC_PATH)
-        self.assertTrue(topic.timestamp_messages)
-
-    def test_from_api_repr(self):
-        client = _Client(project=self.PROJECT)
-        resource = {'name': self.TOPIC_PATH}
-        klass = self._getTargetClass()
-        topic = klass.from_api_repr(resource, client=client)
-        self.assertEqual(topic.name, self.TOPIC_NAME)
-        self.assertIs(topic._client, client)
-        self.assertEqual(topic.project, self.PROJECT)
-        self.assertEqual(topic.full_name, self.TOPIC_PATH)
-
-    def test_from_api_repr_with_bad_client(self):
-        PROJECT1 = 'PROJECT1'
-        PROJECT2 = 'PROJECT2'
-        client = _Client(project=PROJECT1)
-        PATH = 'projects/%s/topics/%s' % (PROJECT2, self.TOPIC_NAME)
-        resource = {'name': PATH}
-        klass = self._getTargetClass()
-        self.assertRaises(ValueError, klass.from_api_repr,
-                          resource, client=client)
-
-    def test_create_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_create_response = {'name': self.TOPIC_PATH}
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        topic.create()
-
-        self.assertEqual(api._topic_created, self.TOPIC_PATH)
-
-    def test_create_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.publisher_api = _FauxPublisherAPI()
-        api._topic_create_response = {'name': self.TOPIC_PATH}
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        topic.create(client=client2)
-
-        self.assertEqual(api._topic_created, self.TOPIC_PATH)
-
-    def test_exists_miss_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        self.assertFalse(topic.exists())
-
-        self.assertEqual(api._topic_got, self.TOPIC_PATH)
-
-    def test_exists_hit_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.publisher_api = _FauxPublisherAPI()
-        api._topic_get_response = {'name': self.TOPIC_PATH}
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        self.assertTrue(topic.exists(client=client2))
-
-        self.assertEqual(api._topic_got, self.TOPIC_PATH)
-
-    def test_delete_w_bound_client(self):
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_delete_response = {}
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        topic.delete()
-
-        self.assertEqual(api._topic_deleted, self.TOPIC_PATH)
-
-    def test_delete_w_alternate_client(self):
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.publisher_api = _FauxPublisherAPI()
-        api._topic_delete_response = {}
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        topic.delete(client=client2)
-
-        self.assertEqual(api._topic_deleted, self.TOPIC_PATH)
-
-    def test_publish_single_bytes_wo_attrs_w_bound_client(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MSGID = 'DEADBEEF'
-        MESSAGE = {'data': B64, 'attributes': {}}
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID]
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        msgid = topic.publish(PAYLOAD)
-
-        self.assertEqual(msgid, MSGID)
-        self.assertEqual(api._topic_published, (self.TOPIC_PATH, [MESSAGE]))
-
-    def test_publish_single_bytes_wo_attrs_w_add_timestamp_alt_client(self):
-        import base64
-        import datetime
-        from google.cloud.pubsub import topic as MUT
-        from google.cloud._helpers import _RFC3339_MICROS
-        from unit_tests._testing import _Monkey
-        NOW = datetime.datetime.utcnow()
-
-        def _utcnow():
-            return NOW
-
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MSGID = 'DEADBEEF'
-        MESSAGE = {
-            'data': B64,
-            'attributes': {'timestamp': NOW.strftime(_RFC3339_MICROS)},
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID]
-
-        topic = self._makeOne(self.TOPIC_NAME, client=client1,
-                              timestamp_messages=True)
-        with _Monkey(MUT, _NOW=_utcnow):
-            msgid = topic.publish(PAYLOAD, client=client2)
-
-        self.assertEqual(msgid, MSGID)
-        self.assertEqual(api._topic_published, (self.TOPIC_PATH, [MESSAGE]))
-
-    def test_publish_single_bytes_w_add_timestamp_w_ts_in_attrs(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MSGID = 'DEADBEEF'
-        OVERRIDE = '2015-04-10T16:46:22.868399Z'
-        MESSAGE = {'data': B64,
-                   'attributes': {'timestamp': OVERRIDE}}
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID]
-        topic = self._makeOne(self.TOPIC_NAME, client=client,
-                              timestamp_messages=True)
-
-        msgid = topic.publish(PAYLOAD, timestamp=OVERRIDE)
-
-        self.assertEqual(msgid, MSGID)
-        self.assertEqual(api._topic_published, (self.TOPIC_PATH, [MESSAGE]))
-
-    def test_publish_single_w_attrs(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MSGID = 'DEADBEEF'
-        MESSAGE = {'data': B64,
-                   'attributes': {'attr1': 'value1', 'attr2': 'value2'}}
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID]
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        msgid = topic.publish(PAYLOAD, attr1='value1', attr2='value2')
-
-        self.assertEqual(msgid, MSGID)
-        self.assertEqual(api._topic_published, (self.TOPIC_PATH, [MESSAGE]))
-
-    def test_publish_multiple_w_bound_client(self):
-        import base64
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        B64_1 = base64.b64encode(PAYLOAD1)
-        B64_2 = base64.b64encode(PAYLOAD2)
-        MSGID1 = 'DEADBEEF'
-        MSGID2 = 'BEADCAFE'
-        MESSAGE1 = {'data': B64_1.decode('ascii'),
-                    'attributes': {}}
-        MESSAGE2 = {'data': B64_2.decode('ascii'),
-                    'attributes': {'attr1': 'value1', 'attr2': 'value2'}}
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID1, MSGID2]
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        with topic.batch() as batch:
-            batch.publish(PAYLOAD1)
-            batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-
-        self.assertEqual(list(batch), [MSGID1, MSGID2])
-        self.assertEqual(list(batch.messages), [])
-        self.assertEqual(api._topic_published,
-                         (self.TOPIC_PATH, [MESSAGE1, MESSAGE2]))
-
-    def test_publish_w_no_messages(self):
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = []
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        with topic.batch() as batch:
-            pass
-
-        self.assertEqual(list(batch.messages), [])
-        self.assertEqual(api._api_called, 0)
-
-    def test_publish_multiple_w_alternate_client(self):
-        import base64
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        B64_1 = base64.b64encode(PAYLOAD1)
-        B64_2 = base64.b64encode(PAYLOAD2)
-        MSGID1 = 'DEADBEEF'
-        MSGID2 = 'BEADCAFE'
-        MESSAGE1 = {'data': B64_1.decode('ascii'), 'attributes': {}}
-        MESSAGE2 = {
-            'data': B64_2.decode('ascii'),
-            'attributes': {'attr1': 'value1', 'attr2': 'value2'},
-        }
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID1, MSGID2]
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        with topic.batch(client=client2) as batch:
-            batch.publish(PAYLOAD1)
-            batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-
-        self.assertEqual(list(batch), [MSGID1, MSGID2])
-        self.assertEqual(list(batch.messages), [])
-        self.assertEqual(api._topic_published,
-                         (self.TOPIC_PATH, [MESSAGE1, MESSAGE2]))
-
-    def test_publish_multiple_error(self):
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        try:
-            with topic.batch() as batch:
-                batch.publish(PAYLOAD1)
-                batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-                raise _Bugout()
-        except _Bugout:
-            pass
-
-        self.assertEqual(list(batch), [])
-        self.assertEqual(getattr(api, '_topic_published', self), self)
-
-    def test_subscription(self):
-        from google.cloud.pubsub.subscription import Subscription
-        client = _Client(project=self.PROJECT)
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        SUBSCRIPTION_NAME = 'subscription_name'
-        subscription = topic.subscription(SUBSCRIPTION_NAME)
-        self.assertIsInstance(subscription, Subscription)
-        self.assertEqual(subscription.name, SUBSCRIPTION_NAME)
-        self.assertIs(subscription.topic, topic)
-
-    def test_list_subscriptions_no_paging(self):
-        from google.cloud.pubsub.subscription import Subscription
-        SUB_NAME_1 = 'subscription_1'
-        SUB_PATH_1 = 'projects/%s/subscriptions/%s' % (
-            self.PROJECT, SUB_NAME_1)
-        SUB_NAME_2 = 'subscription_2'
-        SUB_PATH_2 = 'projects/%s/subscriptions/%s' % (
-            self.PROJECT, SUB_NAME_2)
-        SUBS_LIST = [SUB_PATH_1, SUB_PATH_2]
-        TOKEN = 'TOKEN'
-
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_list_subscriptions_response = SUBS_LIST, TOKEN
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        subscriptions, next_page_token = topic.list_subscriptions()
-
-        self.assertEqual(len(subscriptions), 2)
-
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, Subscription)
-        self.assertEqual(subscriptions[0].name, SUB_NAME_1)
-        self.assertIs(subscription.topic, topic)
-
-        subscription = subscriptions[1]
-        self.assertIsInstance(subscription, Subscription)
-        self.assertEqual(subscriptions[1].name, SUB_NAME_2)
-        self.assertIs(subscription.topic, topic)
-
-        self.assertEqual(next_page_token, TOKEN)
-        self.assertEqual(api._topic_listed,
-                         (self.TOPIC_PATH, None, None))
-
-    def test_list_subscriptions_with_paging(self):
-        from google.cloud.pubsub.subscription import Subscription
-        SUB_NAME_1 = 'subscription_1'
-        SUB_PATH_1 = 'projects/%s/subscriptions/%s' % (
-            self.PROJECT, SUB_NAME_1)
-        SUB_NAME_2 = 'subscription_2'
-        SUB_PATH_2 = 'projects/%s/subscriptions/%s' % (
-            self.PROJECT, SUB_NAME_2)
-        SUBS_LIST = [SUB_PATH_1, SUB_PATH_2]
-        PAGE_SIZE = 10
-        TOKEN = 'TOKEN'
-
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_list_subscriptions_response = SUBS_LIST, None
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        subscriptions, next_page_token = topic.list_subscriptions(
-            page_size=PAGE_SIZE, page_token=TOKEN)
-
-        self.assertEqual(len(subscriptions), 2)
-
-        subscription = subscriptions[0]
-        self.assertIsInstance(subscription, Subscription)
-        self.assertEqual(subscriptions[0].name, SUB_NAME_1)
-        self.assertIs(subscription.topic, topic)
-
-        subscription = subscriptions[1]
-        self.assertIsInstance(subscription, Subscription)
-        self.assertEqual(subscriptions[1].name, SUB_NAME_2)
-        self.assertIs(subscription.topic, topic)
-
-        self.assertIsNone(next_page_token)
-        self.assertEqual(api._topic_listed,
-                         (self.TOPIC_PATH, PAGE_SIZE, TOKEN))
-
-    def test_list_subscriptions_missing_key(self):
-        client = _Client(project=self.PROJECT)
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_list_subscriptions_response = (), None
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        subscriptions, next_page_token = topic.list_subscriptions()
-
-        self.assertEqual(len(subscriptions), 0)
-        self.assertIsNone(next_page_token)
-
-        self.assertEqual(api._topic_listed,
-                         (self.TOPIC_PATH, None, None))
-
-    def test_get_iam_policy_w_bound_client(self):
-        from google.cloud.pubsub.iam import (
-            PUBSUB_ADMIN_ROLE,
-            PUBSUB_EDITOR_ROLE,
-            PUBSUB_VIEWER_ROLE,
-            PUBSUB_PUBLISHER_ROLE,
-            PUBSUB_SUBSCRIBER_ROLE,
-        )
-        OWNER1 = 'user:phred@example.com'
-        OWNER2 = 'group:cloud-logs@google.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        PUBLISHER = 'user:phred@example.com'
-        SUBSCRIBER = 'serviceAccount:1234-abcdef@service.example.com'
-        POLICY = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': PUBSUB_ADMIN_ROLE, 'members': [OWNER1, OWNER2]},
-                {'role': PUBSUB_EDITOR_ROLE, 'members': [EDITOR1, EDITOR2]},
-                {'role': PUBSUB_VIEWER_ROLE, 'members': [VIEWER1, VIEWER2]},
-                {'role': PUBSUB_PUBLISHER_ROLE, 'members': [PUBLISHER]},
-                {'role': PUBSUB_SUBSCRIBER_ROLE, 'members': [SUBSCRIBER]},
-            ],
-        }
-
-        client = _Client(project=self.PROJECT)
-        api = client.iam_policy_api = _FauxIAMPolicy()
-        api._get_iam_policy_response = POLICY
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        policy = topic.get_iam_policy()
-
-        self.assertEqual(policy.etag, 'DEADBEEF')
-        self.assertEqual(policy.version, 17)
-        self.assertEqual(sorted(policy.owners), [OWNER2, OWNER1])
-        self.assertEqual(sorted(policy.editors), [EDITOR1, EDITOR2])
-        self.assertEqual(sorted(policy.viewers), [VIEWER1, VIEWER2])
-        self.assertEqual(sorted(policy.publishers), [PUBLISHER])
-        self.assertEqual(sorted(policy.subscribers), [SUBSCRIBER])
-        self.assertEqual(api._got_iam_policy, self.TOPIC_PATH)
-
-    def test_get_iam_policy_w_alternate_client(self):
-        POLICY = {
-            'etag': 'ACAB',
-        }
-
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.iam_policy_api = _FauxIAMPolicy()
-        api._get_iam_policy_response = POLICY
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        policy = topic.get_iam_policy(client=client2)
-
-        self.assertEqual(policy.etag, 'ACAB')
-        self.assertIsNone(policy.version)
-        self.assertEqual(sorted(policy.owners), [])
-        self.assertEqual(sorted(policy.editors), [])
-        self.assertEqual(sorted(policy.viewers), [])
-
-        self.assertEqual(api._got_iam_policy, self.TOPIC_PATH)
-
-    def test_set_iam_policy_w_bound_client(self):
-        from google.cloud.pubsub.iam import Policy
-        from google.cloud.pubsub.iam import (
-            PUBSUB_ADMIN_ROLE,
-            PUBSUB_EDITOR_ROLE,
-            PUBSUB_VIEWER_ROLE,
-            PUBSUB_PUBLISHER_ROLE,
-            PUBSUB_SUBSCRIBER_ROLE,
-        )
-        OWNER1 = 'group:cloud-logs@google.com'
-        OWNER2 = 'user:phred@example.com'
-        EDITOR1 = 'domain:google.com'
-        EDITOR2 = 'user:phred@example.com'
-        VIEWER1 = 'serviceAccount:1234-abcdef@service.example.com'
-        VIEWER2 = 'user:phred@example.com'
-        PUBLISHER = 'user:phred@example.com'
-        SUBSCRIBER = 'serviceAccount:1234-abcdef@service.example.com'
-        POLICY = {
-            'etag': 'DEADBEEF',
-            'version': 17,
-            'bindings': [
-                {'role': PUBSUB_ADMIN_ROLE,
-                 'members': [OWNER1, OWNER2]},
-                {'role': PUBSUB_EDITOR_ROLE,
-                 'members': [EDITOR1, EDITOR2]},
-                {'role': PUBSUB_VIEWER_ROLE,
-                 'members': [VIEWER1, VIEWER2]},
-                {'role': PUBSUB_PUBLISHER_ROLE,
-                 'members': [PUBLISHER]},
-                {'role': PUBSUB_SUBSCRIBER_ROLE,
-                 'members': [SUBSCRIBER]},
-            ],
-        }
-        RESPONSE = POLICY.copy()
-        RESPONSE['etag'] = 'ABACABAF'
-        RESPONSE['version'] = 18
-
-        client = _Client(project=self.PROJECT)
-        api = client.iam_policy_api = _FauxIAMPolicy()
-        api._set_iam_policy_response = RESPONSE
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-        policy = Policy('DEADBEEF', 17)
-        policy.owners.add(OWNER1)
-        policy.owners.add(OWNER2)
-        policy.editors.add(EDITOR1)
-        policy.editors.add(EDITOR2)
-        policy.viewers.add(VIEWER1)
-        policy.viewers.add(VIEWER2)
-        policy.publishers.add(PUBLISHER)
-        policy.subscribers.add(SUBSCRIBER)
-
-        new_policy = topic.set_iam_policy(policy)
-
-        self.assertEqual(new_policy.etag, 'ABACABAF')
-        self.assertEqual(new_policy.version, 18)
-        self.assertEqual(sorted(new_policy.owners), [OWNER1, OWNER2])
-        self.assertEqual(sorted(new_policy.editors), [EDITOR1, EDITOR2])
-        self.assertEqual(sorted(new_policy.viewers), [VIEWER1, VIEWER2])
-        self.assertEqual(sorted(new_policy.publishers), [PUBLISHER])
-        self.assertEqual(sorted(new_policy.subscribers), [SUBSCRIBER])
-        self.assertEqual(api._set_iam_policy, (self.TOPIC_PATH, POLICY))
-
-    def test_set_iam_policy_w_alternate_client(self):
-        from google.cloud.pubsub.iam import Policy
-        RESPONSE = {'etag': 'ACAB'}
-
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.iam_policy_api = _FauxIAMPolicy()
-        api._set_iam_policy_response = RESPONSE
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        policy = Policy()
-        new_policy = topic.set_iam_policy(policy, client=client2)
-
-        self.assertEqual(new_policy.etag, 'ACAB')
-        self.assertIsNone(new_policy.version)
-        self.assertEqual(sorted(new_policy.owners), [])
-        self.assertEqual(sorted(new_policy.editors), [])
-        self.assertEqual(sorted(new_policy.viewers), [])
-
-        self.assertEqual(api._set_iam_policy, (self.TOPIC_PATH, {}))
-
-    def test_check_iam_permissions_w_bound_client(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        ROLES = [VIEWER_ROLE, EDITOR_ROLE, OWNER_ROLE]
-        client = _Client(project=self.PROJECT)
-        api = client.iam_policy_api = _FauxIAMPolicy()
-        api._test_iam_permissions_response = ROLES[:-1]
-        topic = self._makeOne(self.TOPIC_NAME, client=client)
-
-        allowed = topic.check_iam_permissions(ROLES)
-
-        self.assertEqual(allowed, ROLES[:-1])
-        self.assertEqual(api._tested_iam_permissions,
-                         (self.TOPIC_PATH, ROLES))
-
-    def test_check_iam_permissions_w_alternate_client(self):
-        from google.cloud.pubsub.iam import OWNER_ROLE
-        from google.cloud.pubsub.iam import EDITOR_ROLE
-        from google.cloud.pubsub.iam import VIEWER_ROLE
-
-        ROLES = [VIEWER_ROLE, EDITOR_ROLE, OWNER_ROLE]
-        client1 = _Client(project=self.PROJECT)
-        client2 = _Client(project=self.PROJECT)
-        api = client2.iam_policy_api = _FauxIAMPolicy()
-        api._test_iam_permissions_response = []
-        topic = self._makeOne(self.TOPIC_NAME, client=client1)
-
-        allowed = topic.check_iam_permissions(ROLES, client=client2)
-
-        self.assertEqual(len(allowed), 0)
-        self.assertEqual(api._tested_iam_permissions,
-                         (self.TOPIC_PATH, ROLES))
-
-
-class TestBatch(unittest.TestCase):
-    PROJECT = 'PROJECT'
-
-    def _getTargetClass(self):
-        from google.cloud.pubsub.topic import Batch
-        return Batch
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_ctor_defaults(self):
-        topic = _Topic()
-        client = _Client(project=self.PROJECT)
-        batch = self._makeOne(topic, client)
-        self.assertIs(batch.topic, topic)
-        self.assertIs(batch.client, client)
-        self.assertEqual(len(batch.messages), 0)
-        self.assertEqual(len(batch.message_ids), 0)
-
-    def test___iter___empty(self):
-        topic = _Topic()
-        client = object()
-        batch = self._makeOne(topic, client)
-        self.assertEqual(list(batch), [])
-
-    def test___iter___non_empty(self):
-        topic = _Topic()
-        client = object()
-        batch = self._makeOne(topic, client)
-        batch.message_ids[:] = ['ONE', 'TWO', 'THREE']
-        self.assertEqual(list(batch), ['ONE', 'TWO', 'THREE'])
-
-    def test_publish_bytes_wo_attrs(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MESSAGE = {'data': B64,
-                   'attributes': {}}
-        client = _Client(project=self.PROJECT)
-        topic = _Topic()
-        batch = self._makeOne(topic, client=client)
-        batch.publish(PAYLOAD)
-        self.assertEqual(batch.messages, [MESSAGE])
-
-    def test_publish_bytes_w_add_timestamp(self):
-        import base64
-        PAYLOAD = b'This is the message text'
-        B64 = base64.b64encode(PAYLOAD).decode('ascii')
-        MESSAGE = {'data': B64,
-                   'attributes': {'timestamp': 'TIMESTAMP'}}
-        client = _Client(project=self.PROJECT)
-        topic = _Topic(timestamp_messages=True)
-        batch = self._makeOne(topic, client=client)
-        batch.publish(PAYLOAD)
-        self.assertEqual(batch.messages, [MESSAGE])
-
-    def test_commit_w_bound_client(self):
-        import base64
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        B64_1 = base64.b64encode(PAYLOAD1)
-        B64_2 = base64.b64encode(PAYLOAD2)
-        MSGID1 = 'DEADBEEF'
-        MSGID2 = 'BEADCAFE'
-        MESSAGE1 = {'data': B64_1.decode('ascii'),
-                    'attributes': {}}
-        MESSAGE2 = {'data': B64_2.decode('ascii'),
-                    'attributes': {'attr1': 'value1', 'attr2': 'value2'}}
-        client = _Client(project='PROJECT')
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID1, MSGID2]
-        topic = _Topic()
-        batch = self._makeOne(topic, client=client)
-
-        batch.publish(PAYLOAD1)
-        batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-        batch.commit()
-
-        self.assertEqual(list(batch), [MSGID1, MSGID2])
-        self.assertEqual(list(batch.messages), [])
-        self.assertEqual(api._topic_published,
-                         (topic.full_name, [MESSAGE1, MESSAGE2]))
-
-    def test_commit_w_alternate_client(self):
-        import base64
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        B64_1 = base64.b64encode(PAYLOAD1)
-        B64_2 = base64.b64encode(PAYLOAD2)
-        MSGID1 = 'DEADBEEF'
-        MSGID2 = 'BEADCAFE'
-        MESSAGE1 = {'data': B64_1.decode('ascii'),
-                    'attributes': {}}
-        MESSAGE2 = {'data': B64_2.decode('ascii'),
-                    'attributes': {'attr1': 'value1', 'attr2': 'value2'}}
-        client1 = _Client(project='PROJECT')
-        client2 = _Client(project='PROJECT')
-        api = client2.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID1, MSGID2]
-        topic = _Topic()
-        batch = self._makeOne(topic, client=client1)
-
-        batch.publish(PAYLOAD1)
-        batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-        batch.commit(client=client2)
-
-        self.assertEqual(list(batch), [MSGID1, MSGID2])
-        self.assertEqual(list(batch.messages), [])
-        self.assertEqual(api._topic_published,
-                         (topic.full_name, [MESSAGE1, MESSAGE2]))
-
-    def test_context_mgr_success(self):
-        import base64
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        B64_1 = base64.b64encode(PAYLOAD1)
-        B64_2 = base64.b64encode(PAYLOAD2)
-        MSGID1 = 'DEADBEEF'
-        MSGID2 = 'BEADCAFE'
-        MESSAGE1 = {'data': B64_1.decode('ascii'),
-                    'attributes': {}}
-        MESSAGE2 = {'data': B64_2.decode('ascii'),
-                    'attributes': {'attr1': 'value1', 'attr2': 'value2'}}
-        client = _Client(project='PROJECT')
-        api = client.publisher_api = _FauxPublisherAPI()
-        api._topic_publish_response = [MSGID1, MSGID2]
-        topic = _Topic()
-        batch = self._makeOne(topic, client=client)
-
-        with batch as other:
-            batch.publish(PAYLOAD1)
-            batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-
-        self.assertIs(other, batch)
-        self.assertEqual(list(batch), [MSGID1, MSGID2])
-        self.assertEqual(list(batch.messages), [])
-        self.assertEqual(api._topic_published,
-                         (topic.full_name, [MESSAGE1, MESSAGE2]))
-
-    def test_context_mgr_failure(self):
-        import base64
-        PAYLOAD1 = b'This is the first message text'
-        PAYLOAD2 = b'This is the second message text'
-        B64_1 = base64.b64encode(PAYLOAD1)
-        B64_2 = base64.b64encode(PAYLOAD2)
-        MESSAGE1 = {'data': B64_1.decode('ascii'),
-                    'attributes': {}}
-        MESSAGE2 = {'data': B64_2.decode('ascii'),
-                    'attributes': {'attr1': 'value1', 'attr2': 'value2'}}
-        client = _Client(project='PROJECT')
-        api = client.publisher_api = _FauxPublisherAPI()
-        topic = _Topic()
-        batch = self._makeOne(topic, client=client)
-
-        try:
-            with batch as other:
-                batch.publish(PAYLOAD1)
-                batch.publish(PAYLOAD2, attr1='value1', attr2='value2')
-                raise _Bugout()
-        except _Bugout:
-            pass
-
-        self.assertIs(other, batch)
-        self.assertEqual(list(batch), [])
-        self.assertEqual(list(batch.messages), [MESSAGE1, MESSAGE2])
-        self.assertEqual(getattr(api, '_topic_published', self), self)
-
-
-class _FauxPublisherAPI(object):
-    _api_called = 0
-
-    def topic_create(self, topic_path):
-        self._topic_created = topic_path
-        return self._topic_create_response
-
-    def topic_get(self, topic_path):
-        from google.cloud.exceptions import NotFound
-        self._topic_got = topic_path
-        try:
-            return self._topic_get_response
-        except AttributeError:
-            raise NotFound(topic_path)
-
-    def topic_delete(self, topic_path):
-        self._topic_deleted = topic_path
-        return self._topic_delete_response
-
-    def topic_publish(self, topic_path, messages):
-        self._topic_published = topic_path, messages
-        self._api_called += 1
-        return self._topic_publish_response
-
-    def topic_list_subscriptions(self, topic_path, page_size=None,
-                                 page_token=None):
-        self._topic_listed = topic_path, page_size, page_token
-        return self._topic_list_subscriptions_response
-
-
-class _FauxIAMPolicy(object):
-
-    def get_iam_policy(self, target_path):
-        self._got_iam_policy = target_path
-        return self._get_iam_policy_response
-
-    def set_iam_policy(self, target_path, policy):
-        self._set_iam_policy = target_path, policy
-        return self._set_iam_policy_response
-
-    def test_iam_permissions(self, target_path, permissions):
-        self._tested_iam_permissions = target_path, permissions
-        return self._test_iam_permissions_response
-
-
-class _Topic(object):
-
-    def __init__(self, name="NAME", project="PROJECT",
-                 timestamp_messages=False):
-        self.full_name = 'projects/%s/topics/%s' % (project, name)
-        self.path = '/%s' % (self.full_name,)
-        self.timestamp_messages = timestamp_messages
-
-    def _timestamp_message(self, attrs):
-        if self.timestamp_messages:
-            attrs['timestamp'] = 'TIMESTAMP'
-
-
-class _Client(object):
-
-    connection = None
-
-    def __init__(self, project):
-        self.project = project
-
-
-class _Bugout(Exception):
-    pass
diff --git a/unit_tests/resource_manager/__init__.py b/unit_tests/resource_manager/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/resource_manager/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/resource_manager/test_client.py b/unit_tests/resource_manager/test_client.py
deleted file mode 100644
index 8c2ef35daa52..000000000000
--- a/unit_tests/resource_manager/test_client.py
+++ /dev/null
@@ -1,296 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class Test__ProjectIterator(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.resource_manager.client import _ProjectIterator
-        return _ProjectIterator
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor(self):
-        client = object()
-        iterator = self._makeOne(client)
-        self.assertEqual(iterator.path, '/projects')
-        self.assertEqual(iterator.page_number, 0)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertIs(iterator.client, client)
-        self.assertEqual(iterator.extra_params, {})
-
-    def test_get_items_from_response_empty(self):
-        client = object()
-        iterator = self._makeOne(client)
-        self.assertEqual(list(iterator.get_items_from_response({})), [])
-
-    def test_get_items_from_response_non_empty(self):
-        from google.cloud.resource_manager.project import Project
-
-        PROJECT_ID = 'project-id'
-        PROJECT_NAME = 'My Project Name'
-        PROJECT_NUMBER = 12345678
-        PROJECT_LABELS = {'env': 'prod'}
-        PROJECT_LIFECYCLE_STATE = 'ACTIVE'
-        API_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'name': PROJECT_NAME,
-            'projectNumber': PROJECT_NUMBER,
-            'labels': PROJECT_LABELS,
-            'lifecycleState': PROJECT_LIFECYCLE_STATE,
-        }
-        RESPONSE = {'projects': [API_RESOURCE]}
-
-        client = object()
-        iterator = self._makeOne(client)
-        projects = list(iterator.get_items_from_response(RESPONSE))
-
-        project, = projects
-        self.assertIsInstance(project, Project)
-        self.assertEqual(project.project_id, PROJECT_ID)
-        self.assertEqual(project._client, client)
-        self.assertEqual(project.name, PROJECT_NAME)
-        self.assertEqual(project.number, PROJECT_NUMBER)
-        self.assertEqual(project.labels, PROJECT_LABELS)
-        self.assertEqual(project.status, PROJECT_LIFECYCLE_STATE)
-
-
-class TestClient(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.resource_manager.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor(self):
-        from google.cloud.resource_manager.connection import Connection
-
-        http = object()
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials, http=http)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertEqual(client.connection._credentials, credentials)
-        self.assertEqual(client.connection._http, http)
-
-    def test_new_project_factory(self):
-        from google.cloud.resource_manager.project import Project
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-        project_id = 'project_id'
-        name = object()
-        labels = object()
-        project = client.new_project(project_id, name=name, labels=labels)
-
-        self.assertIsInstance(project, Project)
-        self.assertEqual(project._client, client)
-        self.assertEqual(project.project_id, project_id)
-        self.assertEqual(project.name, name)
-        self.assertEqual(project.labels, labels)
-
-    def test_fetch_project(self):
-        from google.cloud.resource_manager.project import Project
-
-        project_id = 'project-id'
-        project_number = 123
-        project_name = 'Project Name'
-        labels = {'env': 'prod'}
-        project_resource = {
-            'projectId': project_id,
-            'projectNumber': project_number,
-            'name': project_name,
-            'labels': labels,
-            'lifecycleState': 'ACTIVE',
-        }
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-        # Patch the connection with one we can easily control.
-        client.connection = _Connection(project_resource)
-
-        project = client.fetch_project(project_id)
-        self.assertIsInstance(project, Project)
-        self.assertEqual(project._client, client)
-        self.assertEqual(project.project_id, project_id)
-        self.assertEqual(project.name, project_name)
-        self.assertEqual(project.labels, labels)
-
-    def test_list_projects_return_type(self):
-        from google.cloud.resource_manager.client import _ProjectIterator
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-        # Patch the connection with one we can easily control.
-        client.connection = _Connection({})
-
-        results = client.list_projects()
-        self.assertIsInstance(results, _ProjectIterator)
-
-    def test_list_projects_no_paging(self):
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 1
-        STATUS = 'ACTIVE'
-        PROJECTS_RESOURCE = {
-            'projects': [
-                {
-                    'projectId': PROJECT_ID,
-                    'projectNumber': PROJECT_NUMBER,
-                    'lifecycleState': STATUS,
-                },
-            ],
-        }
-        # Patch the connection with one we can easily control.
-        client.connection = _Connection(PROJECTS_RESOURCE)
-        # Make sure there will be no paging.
-        self.assertFalse('nextPageToken' in PROJECTS_RESOURCE)
-
-        results = list(client.list_projects())
-
-        project, = results
-        self.assertEqual(project.project_id, PROJECT_ID)
-        self.assertEqual(project.number, PROJECT_NUMBER)
-        self.assertEqual(project.status, STATUS)
-
-    def test_list_projects_with_paging(self):
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        PROJECT_ID1 = 'project-id'
-        PROJECT_NUMBER1 = 1
-        STATUS = 'ACTIVE'
-        TOKEN = 'next-page-token'
-        FIRST_PROJECTS_RESOURCE = {
-            'projects': [
-                {
-                    'projectId': PROJECT_ID1,
-                    'projectNumber': PROJECT_NUMBER1,
-                    'lifecycleState': STATUS,
-                },
-            ],
-            'nextPageToken': TOKEN,
-        }
-        PROJECT_ID2 = 'project-id-2'
-        PROJECT_NUMBER2 = 42
-        SECOND_PROJECTS_RESOURCE = {
-            'projects': [
-                {
-                    'projectId': PROJECT_ID2,
-                    'projectNumber': PROJECT_NUMBER2,
-                    'lifecycleState': STATUS,
-                },
-            ],
-        }
-        # Patch the connection with one we can easily control.
-        client.connection = _Connection(FIRST_PROJECTS_RESOURCE,
-                                        SECOND_PROJECTS_RESOURCE)
-
-        # Page size = 1 with two response means we'll have two requests.
-        results = list(client.list_projects(page_size=1))
-
-        # Check that the results are as expected.
-        project1, project2 = results
-        self.assertEqual(project1.project_id, PROJECT_ID1)
-        self.assertEqual(project1.number, PROJECT_NUMBER1)
-        self.assertEqual(project1.status, STATUS)
-        self.assertEqual(project2.project_id, PROJECT_ID2)
-        self.assertEqual(project2.number, PROJECT_NUMBER2)
-        self.assertEqual(project2.status, STATUS)
-
-        # Check that two requests were required since page_size=1.
-        request1, request2 = client.connection._requested
-        self.assertEqual(request1, {
-            'path': '/projects',
-            'method': 'GET',
-            'query_params': {
-                'pageSize': 1,
-            },
-        })
-        self.assertEqual(request2, {
-            'path': '/projects',
-            'method': 'GET',
-            'query_params': {
-                'pageSize': 1,
-                'pageToken': TOKEN,
-            },
-        })
-
-    def test_list_projects_with_filter(self):
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 1
-        STATUS = 'ACTIVE'
-        PROJECTS_RESOURCE = {
-            'projects': [
-                {
-                    'projectId': PROJECT_ID,
-                    'projectNumber': PROJECT_NUMBER,
-                    'lifecycleState': STATUS,
-                },
-            ],
-        }
-        # Patch the connection with one we can easily control.
-        client.connection = _Connection(PROJECTS_RESOURCE)
-
-        FILTER_PARAMS = {'id': 'project-id'}
-        results = list(client.list_projects(filter_params=FILTER_PARAMS))
-
-        project, = results
-        self.assertEqual(project.project_id, PROJECT_ID)
-        self.assertEqual(project.number, PROJECT_NUMBER)
-        self.assertEqual(project.status, STATUS)
-
-        # Check that the filter made it in the request.
-        request, = client.connection._requested
-        self.assertEqual(request, {
-            'path': '/projects',
-            'method': 'GET',
-            'query_params': {
-                'filter': FILTER_PARAMS,
-            },
-        })
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/resource_manager/test_connection.py b/unit_tests/resource_manager/test_connection.py
deleted file mode 100644
index 48a47314517c..000000000000
--- a/unit_tests/resource_manager/test_connection.py
+++ /dev/null
@@ -1,46 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.resource_manager.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeOne()
-        uri = conn.build_api_url('/foo', {'bar': 'baz'})
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        self.assertEqual(path,
-                         '/'.join(['', conn.API_VERSION, 'foo']))
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['bar'], 'baz')
diff --git a/unit_tests/resource_manager/test_project.py b/unit_tests/resource_manager/test_project.py
deleted file mode 100644
index 65d6410733e0..000000000000
--- a/unit_tests/resource_manager/test_project.py
+++ /dev/null
@@ -1,340 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestProject(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.resource_manager.project import Project
-        return Project
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_constructor_defaults(self):
-        client = object()
-        PROJECT_ID = 'project-id'
-        project = self._makeOne(PROJECT_ID, client)
-        self.assertEqual(project.project_id, PROJECT_ID)
-        self.assertEqual(project._client, client)
-        self.assertIsNone(project.name)
-        self.assertIsNone(project.number)
-        self.assertEqual(project.labels, {})
-        self.assertIsNone(project.status)
-
-    def test_constructor_explicit(self):
-        client = object()
-        PROJECT_ID = 'project-id'
-        DISPLAY_NAME = 'name'
-        LABELS = {'foo': 'bar'}
-        project = self._makeOne(PROJECT_ID, client,
-                                name=DISPLAY_NAME, labels=LABELS)
-        self.assertEqual(project.project_id, PROJECT_ID)
-        self.assertEqual(project._client, client)
-        self.assertEqual(project.name, DISPLAY_NAME)
-        self.assertIsNone(project.number)
-        self.assertEqual(project.labels, LABELS)
-        self.assertIsNone(project.status)
-
-    def test_from_api_repr(self):
-        client = object()
-        PROJECT_ID = 'project-id'
-        PROJECT_NAME = 'My Project Name'
-        PROJECT_NUMBER = 12345678
-        PROJECT_LABELS = {'env': 'prod'}
-        PROJECT_LIFECYCLE_STATE = 'ACTIVE'
-        resource = {'projectId': PROJECT_ID,
-                    'name': PROJECT_NAME,
-                    'projectNumber': PROJECT_NUMBER,
-                    'labels': PROJECT_LABELS,
-                    'lifecycleState': PROJECT_LIFECYCLE_STATE}
-        project = self._getTargetClass().from_api_repr(resource, client)
-        self.assertEqual(project.project_id, PROJECT_ID)
-        self.assertEqual(project._client, client)
-        self.assertEqual(project.name, PROJECT_NAME)
-        self.assertEqual(project.number, PROJECT_NUMBER)
-        self.assertEqual(project.labels, PROJECT_LABELS)
-        self.assertEqual(project.status, PROJECT_LIFECYCLE_STATE)
-
-    def test_full_name(self):
-        PROJECT_ID = 'project-id'
-        project = self._makeOne(PROJECT_ID, None)
-        self.assertEqual('projects/%s' % PROJECT_ID, project.full_name)
-
-    def test_full_name_missing_id(self):
-        project = self._makeOne(None, None)
-        with self.assertRaises(ValueError):
-            self.assertIsNone(project.full_name)
-
-    def test_path(self):
-        PROJECT_ID = 'project-id'
-        project = self._makeOne(PROJECT_ID, None)
-        self.assertEqual('/projects/%s' % PROJECT_ID, project.path)
-
-    def test_create(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': 'Project Name',
-            'labels': {},
-            'lifecycleState': 'ACTIVE',
-        }
-        connection = _Connection(PROJECT_RESOURCE)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        self.assertIsNone(project.number)
-        project.create()
-        self.assertEqual(project.number, PROJECT_NUMBER)
-        request, = connection._requested
-
-        expected_request = {
-            'method': 'POST',
-            'data': {
-                'projectId': PROJECT_ID,
-                'labels': {},
-                'name': None,
-            },
-            'path': '/projects',
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_reload(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': 'Project Name',
-            'labels': {'env': 'prod'},
-            'lifecycleState': 'ACTIVE',
-        }
-        connection = _Connection(PROJECT_RESOURCE)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        self.assertIsNone(project.number)
-        self.assertIsNone(project.name)
-        self.assertEqual(project.labels, {})
-        self.assertIsNone(project.status)
-        project.reload()
-        self.assertEqual(project.name, PROJECT_RESOURCE['name'])
-        self.assertEqual(project.number, PROJECT_NUMBER)
-        self.assertEqual(project.labels, PROJECT_RESOURCE['labels'])
-        self.assertEqual(project.status, PROJECT_RESOURCE['lifecycleState'])
-
-        request, = connection._requested
-        # NOTE: data is not in the request since a GET request.
-        expected_request = {
-            'method': 'GET',
-            'path': project.path,
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_exists(self):
-        PROJECT_ID = 'project-id'
-        connection = _Connection({'projectId': PROJECT_ID})
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        self.assertTrue(project.exists())
-
-    def test_exists_with_explicitly_passed_client(self):
-        PROJECT_ID = 'project-id'
-        connection = _Connection({'projectId': PROJECT_ID})
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, None)
-        self.assertTrue(project.exists(client=client))
-
-    def test_exists_with_missing_client(self):
-        PROJECT_ID = 'project-id'
-        project = self._makeOne(PROJECT_ID, None)
-        with self.assertRaises(AttributeError):
-            project.exists()
-
-    def test_exists_not_found(self):
-        PROJECT_ID = 'project-id'
-        connection = _Connection()
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        self.assertFalse(project.exists())
-
-    def test_update(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_NAME = 'Project Name'
-        LABELS = {'env': 'prod'}
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': PROJECT_NAME,
-            'labels': LABELS,
-            'lifecycleState': 'ACTIVE',
-        }
-        connection = _Connection(PROJECT_RESOURCE)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        project.name = PROJECT_NAME
-        project.labels = LABELS
-        project.update()
-
-        request, = connection._requested
-        expected_request = {
-            'method': 'PUT',
-            'data': {
-                'name': PROJECT_NAME,
-                'labels': LABELS,
-            },
-            'path': project.path,
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_delete_without_reload_data(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': 'Project Name',
-            'labels': {'env': 'prod'},
-            'lifecycleState': 'ACTIVE',
-        }
-        connection = _Connection(PROJECT_RESOURCE)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        project.delete(reload_data=False)
-
-        request, = connection._requested
-        # NOTE: data is not in the request since a DELETE request.
-        expected_request = {
-            'method': 'DELETE',
-            'path': project.path,
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_delete_with_reload_data(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': 'Project Name',
-            'labels': {'env': 'prod'},
-            'lifecycleState': 'ACTIVE',
-        }
-        DELETING_PROJECT = PROJECT_RESOURCE.copy()
-        DELETING_PROJECT['lifecycleState'] = NEW_STATE = 'DELETE_REQUESTED'
-
-        connection = _Connection(PROJECT_RESOURCE, DELETING_PROJECT)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        project.delete(reload_data=True)
-        self.assertEqual(project.status, NEW_STATE)
-
-        delete_request, get_request = connection._requested
-        # NOTE: data is not in the request since a DELETE request.
-        expected_delete_request = {
-            'method': 'DELETE',
-            'path': project.path,
-        }
-        self.assertEqual(delete_request, expected_delete_request)
-
-        # NOTE: data is not in the request since a GET request.
-        expected_get_request = {
-            'method': 'GET',
-            'path': project.path,
-        }
-        self.assertEqual(get_request, expected_get_request)
-
-    def test_undelete_without_reload_data(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': 'Project Name',
-            'labels': {'env': 'prod'},
-            'lifecycleState': 'DELETE_REQUESTED',
-        }
-        connection = _Connection(PROJECT_RESOURCE)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        project.undelete(reload_data=False)
-
-        request, = connection._requested
-        # NOTE: data is not in the request, undelete doesn't need it.
-        expected_request = {
-            'method': 'POST',
-            'path': project.path + ':undelete',
-        }
-        self.assertEqual(request, expected_request)
-
-    def test_undelete_with_reload_data(self):
-        PROJECT_ID = 'project-id'
-        PROJECT_NUMBER = 123
-        PROJECT_RESOURCE = {
-            'projectId': PROJECT_ID,
-            'projectNumber': PROJECT_NUMBER,
-            'name': 'Project Name',
-            'labels': {'env': 'prod'},
-            'lifecycleState': 'DELETE_REQUESTED',
-        }
-        UNDELETED_PROJECT = PROJECT_RESOURCE.copy()
-        UNDELETED_PROJECT['lifecycleState'] = NEW_STATE = 'ACTIVE'
-
-        connection = _Connection(PROJECT_RESOURCE, UNDELETED_PROJECT)
-        client = _Client(connection=connection)
-        project = self._makeOne(PROJECT_ID, client)
-        project.undelete(reload_data=True)
-        self.assertEqual(project.status, NEW_STATE)
-
-        undelete_request, get_request = connection._requested
-        # NOTE: data is not in the request, undelete doesn't need it.
-        expected_undelete_request = {
-            'method': 'POST',
-            'path': project.path + ':undelete',
-        }
-        self.assertEqual(undelete_request, expected_undelete_request)
-
-        # NOTE: data is not in the request since a GET request.
-        expected_get_request = {
-            'method': 'GET',
-            'path': project.path,
-        }
-        self.assertEqual(get_request, expected_get_request)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
-
-
-class _Client(object):
-
-    def __init__(self, connection=None):
-        self.connection = connection
diff --git a/unit_tests/speech/__init__.py b/unit_tests/speech/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/speech/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/speech/_fixtures.py b/unit_tests/speech/_fixtures.py
deleted file mode 100644
index 63433cd66f1f..000000000000
--- a/unit_tests/speech/_fixtures.py
+++ /dev/null
@@ -1,30 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-SYNC_RECOGNIZE_RESPONSE = {
-    'results': [
-        {
-            'alternatives': [
-                {
-                    'transcript': 'hello',
-                    'confidence': 0.784919,
-                },
-            ],
-        },
-    ],
-}
-
-SYNC_RECOGNIZE_EMPTY_RESPONSE = {
-    'results': [],
-}
diff --git a/unit_tests/speech/test_client.py b/unit_tests/speech/test_client.py
deleted file mode 100644
index 77d76c9cc95b..000000000000
--- a/unit_tests/speech/test_client.py
+++ /dev/null
@@ -1,202 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-    SAMPLE_RATE = 16000
-    HINTS = ['hi']
-    AUDIO_SOURCE_URI = 'gs://sample-bucket/sample-recording.flac'
-
-    def _getTargetClass(self):
-        from google.cloud.speech.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        from google.cloud.speech.connection import Connection
-
-        creds = _Credentials()
-        http = object()
-        client = self._makeOne(credentials=creds, http=http)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertTrue(client.connection.credentials is creds)
-        self.assertTrue(client.connection.http is http)
-
-    def test_sync_recognize_content_with_optional_parameters(self):
-        import base64
-        from google.cloud._helpers import _to_bytes
-        from google.cloud.speech.client import Encoding
-        from unit_tests.speech._fixtures import SYNC_RECOGNIZE_RESPONSE
-
-        _AUDIO_CONTENT = _to_bytes('/9j/4QNURXhpZgAASUkq')
-        _B64_AUDIO_CONTENT = base64.b64encode(_AUDIO_CONTENT)
-        RETURNED = SYNC_RECOGNIZE_RESPONSE
-        REQUEST = {
-            'config': {
-                'encoding': 'FLAC',
-                'maxAlternatives': 2,
-                'sampleRate': 16000,
-                'speechContext': {
-                    'phrases': [
-                        'hi',
-                    ]
-                },
-                'languageCode': 'EN',
-                'profanityFilter': True,
-            },
-            'audio': {
-                'content': _B64_AUDIO_CONTENT,
-            }
-        }
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        encoding = Encoding.FLAC
-
-        response = client.sync_recognize(_AUDIO_CONTENT, None,
-                                         encoding,
-                                         self.SAMPLE_RATE,
-                                         language_code='EN',
-                                         max_alternatives=2,
-                                         profanity_filter=True,
-                                         speech_context=self.HINTS)
-
-        self.assertEqual(len(client.connection._requested), 1)
-        req = client.connection._requested[0]
-        self.assertEqual(len(req), 3)
-        self.assertEqual(req['data'], REQUEST)
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], 'syncrecognize')
-
-        expected = SYNC_RECOGNIZE_RESPONSE['results'][0]['alternatives']
-        self.assertEqual(response, expected)
-
-    def test_sync_recognize_source_uri_without_optional_parameters(self):
-        from google.cloud.speech.client import Encoding
-        from unit_tests.speech._fixtures import SYNC_RECOGNIZE_RESPONSE
-
-        RETURNED = SYNC_RECOGNIZE_RESPONSE
-        REQUEST = {
-            'config': {
-                'encoding': 'FLAC',
-                'sampleRate': 16000,
-            },
-            'audio': {
-                'uri': self.AUDIO_SOURCE_URI,
-            }
-        }
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        encoding = Encoding.FLAC
-
-        response = client.sync_recognize(None, self.AUDIO_SOURCE_URI,
-                                         encoding,
-                                         self.SAMPLE_RATE)
-
-        self.assertEqual(len(client.connection._requested), 1)
-        req = client.connection._requested[0]
-        self.assertEqual(len(req), 3)
-        self.assertEqual(req['data'], REQUEST)
-        self.assertEqual(req['method'], 'POST')
-        self.assertEqual(req['path'], 'syncrecognize')
-
-        expected = SYNC_RECOGNIZE_RESPONSE['results'][0]['alternatives']
-        self.assertEqual(response, expected)
-
-    def test_sync_recognize_without_content_or_source_uri(self):
-        from google.cloud.speech.client import Encoding
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        with self.assertRaises(ValueError):
-            client.sync_recognize(None, None, Encoding.FLAC, self.SAMPLE_RATE)
-
-    def test_sync_recognize_with_content_and_source_uri(self):
-        from google.cloud._helpers import _to_bytes
-        from google.cloud.speech.client import Encoding
-        _AUDIO_CONTENT = _to_bytes('/9j/4QNURXhpZgAASUkq')
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        with self.assertRaises(ValueError):
-            client.sync_recognize(_AUDIO_CONTENT, self.AUDIO_SOURCE_URI,
-                                  Encoding.FLAC, self.SAMPLE_RATE)
-
-    def test_sync_recognize_without_encoding(self):
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        with self.assertRaises(ValueError):
-            client.sync_recognize(None, self.AUDIO_SOURCE_URI, None,
-                                  self.SAMPLE_RATE)
-
-    def test_sync_recognize_without_samplerate(self):
-        from google.cloud.speech.client import Encoding
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-
-        with self.assertRaises(ValueError):
-            client.sync_recognize(None, self.AUDIO_SOURCE_URI, Encoding.FLAC,
-                                  None)
-
-    def test_sync_recognize_with_empty_results(self):
-        from google.cloud.speech.client import Encoding
-        from unit_tests.speech._fixtures import SYNC_RECOGNIZE_EMPTY_RESPONSE
-
-        credentials = _Credentials()
-        client = self._makeOne(credentials=credentials)
-        client.connection = _Connection(SYNC_RECOGNIZE_EMPTY_RESPONSE)
-
-        with self.assertRaises(ValueError):
-            client.sync_recognize(None, self.AUDIO_SOURCE_URI, Encoding.FLAC,
-                                  self.SAMPLE_RATE)
-
-
-class _Credentials(object):
-
-    _scopes = ('https://www.googleapis.com/auth/cloud-platform',)
-
-    def __init__(self, authorized=None):
-        self._authorized = authorized
-        self._create_scoped_calls = 0
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/speech/test_connection.py b/unit_tests/speech/test_connection.py
deleted file mode 100644
index 37aefe944427..000000000000
--- a/unit_tests/speech/test_connection.py
+++ /dev/null
@@ -1,36 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.speech.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url(self):
-        conn = self._makeOne()
-        uri = '/'.join([
-            conn.API_BASE_URL,
-            conn.API_VERSION,
-            'speech',
-        ])
-        method = 'syncrecognize'
-        uri += ':' + method
-        self.assertEqual(conn.build_api_url(method), uri)
diff --git a/unit_tests/storage/__init__.py b/unit_tests/storage/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/storage/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/storage/test__helpers.py b/unit_tests/storage/test__helpers.py
deleted file mode 100644
index ef46ecc5efb6..000000000000
--- a/unit_tests/storage/test__helpers.py
+++ /dev/null
@@ -1,223 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test_PropertyMixin(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage._helpers import _PropertyMixin
-        return _PropertyMixin
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _derivedClass(self, path=None):
-
-        class Derived(self._getTargetClass()):
-
-            client = None
-
-            @property
-            def path(self):
-                return path
-
-        return Derived
-
-    def test_path_is_abstract(self):
-        mixin = self._makeOne()
-        self.assertRaises(NotImplementedError, lambda: mixin.path)
-
-    def test_client_is_abstract(self):
-        mixin = self._makeOne()
-        self.assertRaises(NotImplementedError, lambda: mixin.client)
-
-    def test_reload(self):
-        connection = _Connection({'foo': 'Foo'})
-        client = _Client(connection)
-        derived = self._derivedClass('/path')()
-        # Make sure changes is not a set, so we can observe a change.
-        derived._changes = object()
-        derived.reload(client=client)
-        self.assertEqual(derived._properties, {'foo': 'Foo'})
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'GET')
-        self.assertEqual(kw[0]['path'], '/path')
-        self.assertEqual(kw[0]['query_params'], {'projection': 'noAcl'})
-        # Make sure changes get reset by reload.
-        self.assertEqual(derived._changes, set())
-
-    def test__set_properties(self):
-        mixin = self._makeOne()
-        self.assertEqual(mixin._properties, {})
-        VALUE = object()
-        mixin._set_properties(VALUE)
-        self.assertEqual(mixin._properties, VALUE)
-
-    def test__patch_property(self):
-        derived = self._derivedClass()()
-        derived._patch_property('foo', 'Foo')
-        self.assertEqual(derived._properties, {'foo': 'Foo'})
-
-    def test_patch(self):
-        connection = _Connection({'foo': 'Foo'})
-        client = _Client(connection)
-        derived = self._derivedClass('/path')()
-        # Make sure changes is non-empty, so we can observe a change.
-        BAR = object()
-        BAZ = object()
-        derived._properties = {'bar': BAR, 'baz': BAZ}
-        derived._changes = set(['bar'])  # Ignore baz.
-        derived.patch(client=client)
-        self.assertEqual(derived._properties, {'foo': 'Foo'})
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/path')
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-        # Since changes does not include `baz`, we don't see it sent.
-        self.assertEqual(kw[0]['data'], {'bar': BAR})
-        # Make sure changes get reset by patch().
-        self.assertEqual(derived._changes, set())
-
-
-class Test__scalar_property(unittest.TestCase):
-
-    def _callFUT(self, fieldName):
-        from google.cloud.storage._helpers import _scalar_property
-        return _scalar_property(fieldName)
-
-    def test_getter(self):
-
-        class Test(object):
-            def __init__(self, **kw):
-                self._properties = kw.copy()
-            do_re_mi = self._callFUT('solfege')
-
-        test = Test(solfege='Latido')
-        self.assertEqual(test.do_re_mi, 'Latido')
-
-    def test_setter(self):
-
-        class Test(object):
-            def _patch_property(self, name, value):
-                self._patched = (name, value)
-            do_re_mi = self._callFUT('solfege')
-
-        test = Test()
-        test.do_re_mi = 'Latido'
-        self.assertEqual(test._patched, ('solfege', 'Latido'))
-
-
-class Test__base64_md5hash(unittest.TestCase):
-
-    def _callFUT(self, bytes_to_sign):
-        from google.cloud.storage._helpers import _base64_md5hash
-        return _base64_md5hash(bytes_to_sign)
-
-    def test_it(self):
-        from io import BytesIO
-        BYTES_TO_SIGN = b'FOO'
-        BUFFER = BytesIO()
-        BUFFER.write(BYTES_TO_SIGN)
-        BUFFER.seek(0)
-
-        SIGNED_CONTENT = self._callFUT(BUFFER)
-        self.assertEqual(SIGNED_CONTENT, b'kBiQqOnIz21aGlQrIp/r/w==')
-
-    def test_it_with_stubs(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.storage import _helpers as MUT
-
-        class _Buffer(object):
-
-            def __init__(self, return_vals):
-                self.return_vals = return_vals
-                self._block_sizes = []
-
-            def read(self, block_size):
-                self._block_sizes.append(block_size)
-                return self.return_vals.pop()
-
-        BASE64 = _Base64()
-        DIGEST_VAL = object()
-        BYTES_TO_SIGN = b'BYTES_TO_SIGN'
-        BUFFER = _Buffer([b'', BYTES_TO_SIGN])
-        MD5 = _MD5(DIGEST_VAL)
-
-        with _Monkey(MUT, base64=BASE64, md5=MD5):
-            SIGNED_CONTENT = self._callFUT(BUFFER)
-
-        self.assertEqual(BUFFER._block_sizes, [8192, 8192])
-        self.assertIs(SIGNED_CONTENT, DIGEST_VAL)
-        self.assertEqual(BASE64._called_b64encode, [DIGEST_VAL])
-        self.assertEqual(MD5._called, [None])
-        self.assertEqual(MD5.hash_obj.num_digest_calls, 1)
-        self.assertEqual(MD5.hash_obj._blocks, [BYTES_TO_SIGN])
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
-
-
-class _MD5Hash(object):
-
-    def __init__(self, digest_val):
-        self.digest_val = digest_val
-        self.num_digest_calls = 0
-        self._blocks = []
-
-    def update(self, block):
-        self._blocks.append(block)
-
-    def digest(self):
-        self.num_digest_calls += 1
-        return self.digest_val
-
-
-class _MD5(object):
-
-    def __init__(self, digest_val):
-        self.hash_obj = _MD5Hash(digest_val)
-        self._called = []
-
-    def __call__(self, data=None):
-        self._called.append(data)
-        return self.hash_obj
-
-
-class _Base64(object):
-
-    def __init__(self):
-        self._called_b64encode = []
-
-    def b64encode(self, value):
-        self._called_b64encode.append(value)
-        return value
-
-
-class _Client(object):
-
-    def __init__(self, connection):
-        self.connection = connection
diff --git a/unit_tests/storage/test_acl.py b/unit_tests/storage/test_acl.py
deleted file mode 100644
index e1585bc26c39..000000000000
--- a/unit_tests/storage/test_acl.py
+++ /dev/null
@@ -1,811 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test_ACLEntity(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.acl import _ACLEntity
-        return _ACLEntity
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_default_identifier(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        self.assertEqual(entity.type, TYPE)
-        self.assertIsNone(entity.identifier)
-        self.assertEqual(entity.get_roles(), set())
-
-    def test_ctor_w_identifier(self):
-        TYPE = 'type'
-        ID = 'id'
-        entity = self._makeOne(TYPE, ID)
-        self.assertEqual(entity.type, TYPE)
-        self.assertEqual(entity.identifier, ID)
-        self.assertEqual(entity.get_roles(), set())
-
-    def test___str__no_identifier(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        self.assertEqual(str(entity), TYPE)
-
-    def test___str__w_identifier(self):
-        TYPE = 'type'
-        ID = 'id'
-        entity = self._makeOne(TYPE, ID)
-        self.assertEqual(str(entity), '%s-%s' % (TYPE, ID))
-
-    def test_grant_simple(self):
-        TYPE = 'type'
-        ROLE = 'role'
-        entity = self._makeOne(TYPE)
-        entity.grant(ROLE)
-        self.assertEqual(entity.get_roles(), set([ROLE]))
-
-    def test_grant_duplicate(self):
-        TYPE = 'type'
-        ROLE1 = 'role1'
-        ROLE2 = 'role2'
-        entity = self._makeOne(TYPE)
-        entity.grant(ROLE1)
-        entity.grant(ROLE2)
-        entity.grant(ROLE1)
-        self.assertEqual(entity.get_roles(), set([ROLE1, ROLE2]))
-
-    def test_revoke_miss(self):
-        TYPE = 'type'
-        ROLE = 'nonesuch'
-        entity = self._makeOne(TYPE)
-        entity.revoke(ROLE)
-        self.assertEqual(entity.get_roles(), set())
-
-    def test_revoke_hit(self):
-        TYPE = 'type'
-        ROLE1 = 'role1'
-        ROLE2 = 'role2'
-        entity = self._makeOne(TYPE)
-        entity.grant(ROLE1)
-        entity.grant(ROLE2)
-        entity.revoke(ROLE1)
-        self.assertEqual(entity.get_roles(), set([ROLE2]))
-
-    def test_grant_read(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        entity.grant_read()
-        self.assertEqual(entity.get_roles(), set([entity.READER_ROLE]))
-
-    def test_grant_write(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        entity.grant_write()
-        self.assertEqual(entity.get_roles(), set([entity.WRITER_ROLE]))
-
-    def test_grant_owner(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        entity.grant_owner()
-        self.assertEqual(entity.get_roles(), set([entity.OWNER_ROLE]))
-
-    def test_revoke_read(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        entity.grant(entity.READER_ROLE)
-        entity.revoke_read()
-        self.assertEqual(entity.get_roles(), set())
-
-    def test_revoke_write(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        entity.grant(entity.WRITER_ROLE)
-        entity.revoke_write()
-        self.assertEqual(entity.get_roles(), set())
-
-    def test_revoke_owner(self):
-        TYPE = 'type'
-        entity = self._makeOne(TYPE)
-        entity.grant(entity.OWNER_ROLE)
-        entity.revoke_owner()
-        self.assertEqual(entity.get_roles(), set())
-
-
-class Test_ACL(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.acl import ACL
-        return ACL
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        acl = self._makeOne()
-        self.assertEqual(acl.entities, {})
-        self.assertFalse(acl.loaded)
-
-    def test__ensure_loaded(self):
-        acl = self._makeOne()
-
-        def _reload():
-            acl._really_loaded = True
-
-        acl.reload = _reload
-        acl._ensure_loaded()
-        self.assertTrue(acl._really_loaded)
-
-    def test_client_is_abstract(self):
-        acl = self._makeOne()
-        self.assertRaises(NotImplementedError, lambda: acl.client)
-
-    def test_reset(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        acl.entity(TYPE, ID)
-        acl.reset()
-        self.assertEqual(acl.entities, {})
-        self.assertFalse(acl.loaded)
-
-    def test___iter___empty_eager(self):
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertEqual(list(acl), [])
-
-    def test___iter___empty_lazy(self):
-        acl = self._makeOne()
-
-        def _reload():
-            acl.loaded = True
-
-        acl.reload = _reload
-        self.assertEqual(list(acl), [])
-        self.assertTrue(acl.loaded)
-
-    def test___iter___non_empty_no_roles(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        acl.entity(TYPE, ID)
-        self.assertEqual(list(acl), [])
-
-    def test___iter___non_empty_w_roles(self):
-        TYPE = 'type'
-        ID = 'id'
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity(TYPE, ID)
-        entity.grant(ROLE)
-        self.assertEqual(list(acl),
-                         [{'entity': '%s-%s' % (TYPE, ID), 'role': ROLE}])
-
-    def test___iter___non_empty_w_empty_role(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity(TYPE, ID)
-        entity.grant('')
-        self.assertEqual(list(acl), [])
-
-    def test_entity_from_dict_allUsers_eager(self):
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity_from_dict({'entity': 'allUsers', 'role': ROLE})
-        self.assertEqual(entity.type, 'allUsers')
-        self.assertIsNone(entity.identifier)
-        self.assertEqual(entity.get_roles(), set([ROLE]))
-        self.assertEqual(list(acl),
-                         [{'entity': 'allUsers', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_entity_from_dict_allAuthenticatedUsers(self):
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity_from_dict({'entity': 'allAuthenticatedUsers',
-                                       'role': ROLE})
-        self.assertEqual(entity.type, 'allAuthenticatedUsers')
-        self.assertIsNone(entity.identifier)
-        self.assertEqual(entity.get_roles(), set([ROLE]))
-        self.assertEqual(list(acl),
-                         [{'entity': 'allAuthenticatedUsers', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_entity_from_dict_string_w_hyphen(self):
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity_from_dict({'entity': 'type-id', 'role': ROLE})
-        self.assertEqual(entity.type, 'type')
-        self.assertEqual(entity.identifier, 'id')
-        self.assertEqual(entity.get_roles(), set([ROLE]))
-        self.assertEqual(list(acl),
-                         [{'entity': 'type-id', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_entity_from_dict_string_wo_hyphen(self):
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertRaises(ValueError,
-                          acl.entity_from_dict,
-                          {'entity': 'bogus', 'role': ROLE})
-        self.assertEqual(list(acl.get_entities()), [])
-
-    def test_has_entity_miss_str_eager(self):
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertFalse(acl.has_entity('nonesuch'))
-
-    def test_has_entity_miss_str_lazy(self):
-        acl = self._makeOne()
-
-        def _reload():
-            acl.loaded = True
-
-        acl.reload = _reload
-        self.assertFalse(acl.has_entity('nonesuch'))
-        self.assertTrue(acl.loaded)
-
-    def test_has_entity_miss_entity(self):
-        from google.cloud.storage.acl import _ACLEntity
-        TYPE = 'type'
-        ID = 'id'
-        entity = _ACLEntity(TYPE, ID)
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertFalse(acl.has_entity(entity))
-
-    def test_has_entity_hit_str(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        acl.entity(TYPE, ID)
-        self.assertTrue(acl.has_entity('%s-%s' % (TYPE, ID)))
-
-    def test_has_entity_hit_entity(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity(TYPE, ID)
-        self.assertTrue(acl.has_entity(entity))
-
-    def test_get_entity_miss_str_no_default_eager(self):
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertIsNone(acl.get_entity('nonesuch'))
-
-    def test_get_entity_miss_str_no_default_lazy(self):
-        acl = self._makeOne()
-
-        def _reload():
-            acl.loaded = True
-
-        acl.reload = _reload
-        self.assertIsNone(acl.get_entity('nonesuch'))
-        self.assertTrue(acl.loaded)
-
-    def test_get_entity_miss_entity_no_default(self):
-        from google.cloud.storage.acl import _ACLEntity
-        TYPE = 'type'
-        ID = 'id'
-        entity = _ACLEntity(TYPE, ID)
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertIsNone(acl.get_entity(entity))
-
-    def test_get_entity_miss_str_w_default(self):
-        DEFAULT = object()
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertIs(acl.get_entity('nonesuch', DEFAULT), DEFAULT)
-
-    def test_get_entity_miss_entity_w_default(self):
-        from google.cloud.storage.acl import _ACLEntity
-        DEFAULT = object()
-        TYPE = 'type'
-        ID = 'id'
-        entity = _ACLEntity(TYPE, ID)
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertIs(acl.get_entity(entity, DEFAULT), DEFAULT)
-
-    def test_get_entity_hit_str(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        acl.entity(TYPE, ID)
-        self.assertTrue(acl.has_entity('%s-%s' % (TYPE, ID)))
-
-    def test_get_entity_hit_entity(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity(TYPE, ID)
-        self.assertTrue(acl.has_entity(entity))
-
-    def test_add_entity_miss_eager(self):
-        from google.cloud.storage.acl import _ACLEntity
-        TYPE = 'type'
-        ID = 'id'
-        ROLE = 'role'
-        entity = _ACLEntity(TYPE, ID)
-        entity.grant(ROLE)
-        acl = self._makeOne()
-        acl.loaded = True
-        acl.add_entity(entity)
-        self.assertTrue(acl.loaded)
-        self.assertEqual(list(acl),
-                         [{'entity': 'type-id', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_add_entity_miss_lazy(self):
-        from google.cloud.storage.acl import _ACLEntity
-        TYPE = 'type'
-        ID = 'id'
-        ROLE = 'role'
-        entity = _ACLEntity(TYPE, ID)
-        entity.grant(ROLE)
-        acl = self._makeOne()
-
-        def _reload():
-            acl.loaded = True
-
-        acl.reload = _reload
-        acl.add_entity(entity)
-        self.assertTrue(acl.loaded)
-        self.assertEqual(list(acl),
-                         [{'entity': 'type-id', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-        self.assertTrue(acl.loaded)
-
-    def test_add_entity_hit(self):
-        from google.cloud.storage.acl import _ACLEntity
-        TYPE = 'type'
-        ID = 'id'
-        ENTITY_VAL = '%s-%s' % (TYPE, ID)
-        ROLE = 'role'
-        entity = _ACLEntity(TYPE, ID)
-        entity.grant(ROLE)
-        acl = self._makeOne()
-        acl.loaded = True
-        before = acl.entity(TYPE, ID)
-        acl.add_entity(entity)
-        self.assertTrue(acl.loaded)
-        self.assertIsNot(acl.get_entity(ENTITY_VAL), before)
-        self.assertIs(acl.get_entity(ENTITY_VAL), entity)
-        self.assertEqual(list(acl),
-                         [{'entity': 'type-id', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_entity_miss(self):
-        TYPE = 'type'
-        ID = 'id'
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity(TYPE, ID)
-        self.assertTrue(acl.loaded)
-        entity.grant(ROLE)
-        self.assertEqual(list(acl),
-                         [{'entity': 'type-id', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_entity_hit(self):
-        TYPE = 'type'
-        ID = 'id'
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        before = acl.entity(TYPE, ID)
-        before.grant(ROLE)
-        entity = acl.entity(TYPE, ID)
-        self.assertIs(entity, before)
-        self.assertEqual(list(acl),
-                         [{'entity': 'type-id', 'role': ROLE}])
-        self.assertEqual(list(acl.get_entities()), [entity])
-
-    def test_user(self):
-        ID = 'id'
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.user(ID)
-        entity.grant(ROLE)
-        self.assertEqual(entity.type, 'user')
-        self.assertEqual(entity.identifier, ID)
-        self.assertEqual(list(acl),
-                         [{'entity': 'user-%s' % ID, 'role': ROLE}])
-
-    def test_group(self):
-        ID = 'id'
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.group(ID)
-        entity.grant(ROLE)
-        self.assertEqual(entity.type, 'group')
-        self.assertEqual(entity.identifier, ID)
-        self.assertEqual(list(acl),
-                         [{'entity': 'group-%s' % ID, 'role': ROLE}])
-
-    def test_domain(self):
-        ID = 'id'
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.domain(ID)
-        entity.grant(ROLE)
-        self.assertEqual(entity.type, 'domain')
-        self.assertEqual(entity.identifier, ID)
-        self.assertEqual(list(acl),
-                         [{'entity': 'domain-%s' % ID, 'role': ROLE}])
-
-    def test_all(self):
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.all()
-        entity.grant(ROLE)
-        self.assertEqual(entity.type, 'allUsers')
-        self.assertIsNone(entity.identifier)
-        self.assertEqual(list(acl),
-                         [{'entity': 'allUsers', 'role': ROLE}])
-
-    def test_all_authenticated(self):
-        ROLE = 'role'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.all_authenticated()
-        entity.grant(ROLE)
-        self.assertEqual(entity.type, 'allAuthenticatedUsers')
-        self.assertIsNone(entity.identifier)
-        self.assertEqual(list(acl),
-                         [{'entity': 'allAuthenticatedUsers', 'role': ROLE}])
-
-    def test_get_entities_empty_eager(self):
-        acl = self._makeOne()
-        acl.loaded = True
-        self.assertEqual(acl.get_entities(), [])
-
-    def test_get_entities_empty_lazy(self):
-        acl = self._makeOne()
-
-        def _reload():
-            acl.loaded = True
-
-        acl.reload = _reload
-        self.assertEqual(acl.get_entities(), [])
-        self.assertTrue(acl.loaded)
-
-    def test_get_entities_nonempty(self):
-        TYPE = 'type'
-        ID = 'id'
-        acl = self._makeOne()
-        acl.loaded = True
-        entity = acl.entity(TYPE, ID)
-        self.assertEqual(acl.get_entities(), [entity])
-
-    def test_reload_missing(self):
-        # https://github.com/GoogleCloudPlatform/google-cloud-python/issues/652
-        ROLE = 'role'
-        connection = _Connection({})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.reload_path = '/testing/acl'
-        acl.loaded = True
-        acl.entity('allUsers', ROLE)
-        acl.reload(client=client)
-        self.assertEqual(list(acl), [])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'GET')
-        self.assertEqual(kw[0]['path'], '/testing/acl')
-
-    def test_reload_empty_result_clears_local(self):
-        ROLE = 'role'
-        connection = _Connection({'items': []})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.reload_path = '/testing/acl'
-        acl.loaded = True
-        acl.entity('allUsers', ROLE)
-        acl.reload(client=client)
-        self.assertTrue(acl.loaded)
-        self.assertEqual(list(acl), [])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'GET')
-        self.assertEqual(kw[0]['path'], '/testing/acl')
-
-    def test_reload_nonempty_result(self):
-        ROLE = 'role'
-        connection = _Connection(
-            {'items': [{'entity': 'allUsers', 'role': ROLE}]})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.reload_path = '/testing/acl'
-        acl.loaded = True
-        acl.reload(client=client)
-        self.assertTrue(acl.loaded)
-        self.assertEqual(list(acl), [{'entity': 'allUsers', 'role': ROLE}])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'GET')
-        self.assertEqual(kw[0]['path'], '/testing/acl')
-
-    def test_save_none_set_none_passed(self):
-        connection = _Connection()
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.save(client=client)
-        kw = connection._requested
-        self.assertEqual(len(kw), 0)
-
-    def test_save_existing_missing_none_passed(self):
-        connection = _Connection({})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl.save(client=client)
-        self.assertEqual(list(acl), [])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': []})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-
-    def test_save_no_acl(self):
-        ROLE = 'role'
-        AFTER = [{'entity': 'allUsers', 'role': ROLE}]
-        connection = _Connection({'acl': AFTER})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl.entity('allUsers').grant(ROLE)
-        acl.save(client=client)
-        self.assertEqual(list(acl), AFTER)
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': AFTER})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-
-    def test_save_w_acl(self):
-        ROLE1 = 'role1'
-        ROLE2 = 'role2'
-        STICKY = {'entity': 'allUsers', 'role': ROLE2}
-        new_acl = [{'entity': 'allUsers', 'role': ROLE1}]
-        connection = _Connection({'acl': [STICKY] + new_acl})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl.save(new_acl, client=client)
-        entries = list(acl)
-        self.assertEqual(len(entries), 2)
-        self.assertTrue(STICKY in entries)
-        self.assertTrue(new_acl[0] in entries)
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': new_acl})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-
-    def test_save_prefefined_invalid(self):
-        connection = _Connection()
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        with self.assertRaises(ValueError):
-            acl.save_predefined('bogus', client=client)
-
-    def test_save_predefined_valid(self):
-        PREDEFINED = 'private'
-        connection = _Connection({'acl': []})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl.save_predefined(PREDEFINED, client=client)
-        entries = list(acl)
-        self.assertEqual(len(entries), 0)
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': []})
-        self.assertEqual(kw[0]['query_params'],
-                         {'projection': 'full', 'predefinedAcl': PREDEFINED})
-
-    def test_save_predefined_w_XML_alias(self):
-        PREDEFINED_XML = 'project-private'
-        PREDEFINED_JSON = 'projectPrivate'
-        connection = _Connection({'acl': []})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl.save_predefined(PREDEFINED_XML, client=client)
-        entries = list(acl)
-        self.assertEqual(len(entries), 0)
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': []})
-        self.assertEqual(kw[0]['query_params'],
-                         {'projection': 'full',
-                          'predefinedAcl': PREDEFINED_JSON})
-
-    def test_save_predefined_valid_w_alternate_query_param(self):
-        # Cover case where subclass overrides _PREDEFINED_QUERY_PARAM
-        PREDEFINED = 'publicRead'
-        connection = _Connection({'acl': []})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl._PREDEFINED_QUERY_PARAM = 'alternate'
-        acl.save_predefined(PREDEFINED, client=client)
-        entries = list(acl)
-        self.assertEqual(len(entries), 0)
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': []})
-        self.assertEqual(kw[0]['query_params'],
-                         {'projection': 'full', 'alternate': PREDEFINED})
-
-    def test_clear(self):
-        ROLE1 = 'role1'
-        ROLE2 = 'role2'
-        STICKY = {'entity': 'allUsers', 'role': ROLE2}
-        connection = _Connection({'acl': [STICKY]})
-        client = _Client(connection)
-        acl = self._makeOne()
-        acl.save_path = '/testing'
-        acl.loaded = True
-        acl.entity('allUsers', ROLE1)
-        acl.clear(client=client)
-        self.assertEqual(list(acl), [STICKY])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/testing')
-        self.assertEqual(kw[0]['data'], {'acl': []})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-
-
-class Test_BucketACL(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.acl import BucketACL
-        return BucketACL
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        NAME = 'name'
-        bucket = _Bucket(NAME)
-        acl = self._makeOne(bucket)
-        self.assertEqual(acl.entities, {})
-        self.assertFalse(acl.loaded)
-        self.assertIs(acl.bucket, bucket)
-        self.assertEqual(acl.reload_path, '/b/%s/acl' % NAME)
-        self.assertEqual(acl.save_path, '/b/%s' % NAME)
-
-
-class Test_DefaultObjectACL(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.acl import DefaultObjectACL
-        return DefaultObjectACL
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        NAME = 'name'
-        bucket = _Bucket(NAME)
-        acl = self._makeOne(bucket)
-        self.assertEqual(acl.entities, {})
-        self.assertFalse(acl.loaded)
-        self.assertIs(acl.bucket, bucket)
-        self.assertEqual(acl.reload_path, '/b/%s/defaultObjectAcl' % NAME)
-        self.assertEqual(acl.save_path, '/b/%s' % NAME)
-
-
-class Test_ObjectACL(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.acl import ObjectACL
-        return ObjectACL
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket(NAME)
-        blob = _Blob(bucket, BLOB_NAME)
-        acl = self._makeOne(blob)
-        self.assertEqual(acl.entities, {})
-        self.assertFalse(acl.loaded)
-        self.assertIs(acl.blob, blob)
-        self.assertEqual(acl.reload_path, '/b/%s/o/%s/acl' % (NAME, BLOB_NAME))
-        self.assertEqual(acl.save_path, '/b/%s/o/%s' % (NAME, BLOB_NAME))
-
-
-class _Blob(object):
-
-    def __init__(self, bucket, blob):
-        self.bucket = bucket
-        self.blob = blob
-
-    @property
-    def path(self):
-        return '%s/o/%s' % (self.bucket.path, self.blob)
-
-
-class _Bucket(object):
-
-    def __init__(self, name):
-        self.name = name
-
-    @property
-    def path(self):
-        return '/b/%s' % self.name
-
-
-class _Connection(object):
-    _delete_ok = False
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-        self._deleted = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
-
-
-class _Client(object):
-
-    def __init__(self, connection):
-        self.connection = connection
diff --git a/unit_tests/storage/test_batch.py b/unit_tests/storage/test_batch.py
deleted file mode 100644
index 37453f1582ce..000000000000
--- a/unit_tests/storage/test_batch.py
+++ /dev/null
@@ -1,612 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestMIMEApplicationHTTP(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.batch import MIMEApplicationHTTP
-        return MIMEApplicationHTTP
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_body_None(self):
-        METHOD = 'DELETE'
-        PATH = '/path/to/api'
-        LINES = [
-            "DELETE /path/to/api HTTP/1.1",
-            "",
-            ]
-        mah = self._makeOne(METHOD, PATH, {}, None)
-        self.assertEqual(mah.get_content_type(), 'application/http')
-        self.assertEqual(mah.get_payload().splitlines(), LINES)
-
-    def test_ctor_body_str(self):
-        METHOD = 'GET'
-        PATH = '/path/to/api'
-        BODY = 'ABC'
-        HEADERS = {'Content-Length': len(BODY), 'Content-Type': 'text/plain'}
-        LINES = [
-            "GET /path/to/api HTTP/1.1",
-            "Content-Length: 3",
-            "Content-Type: text/plain",
-            "",
-            "ABC",
-            ]
-        mah = self._makeOne(METHOD, PATH, HEADERS, BODY)
-        self.assertEqual(mah.get_payload().splitlines(), LINES)
-
-    def test_ctor_body_dict(self):
-        METHOD = 'GET'
-        PATH = '/path/to/api'
-        BODY = {'foo': 'bar'}
-        HEADERS = {}
-        LINES = [
-            'GET /path/to/api HTTP/1.1',
-            'Content-Length: 14',
-            'Content-Type: application/json',
-            '',
-            '{"foo": "bar"}',
-            ]
-        mah = self._makeOne(METHOD, PATH, HEADERS, BODY)
-        self.assertEqual(mah.get_payload().splitlines(), LINES)
-
-
-class TestBatch(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.batch import Batch
-        return Batch
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        http = _HTTP()
-        connection = _Connection(http=http)
-        client = _Client(connection)
-        batch = self._makeOne(client)
-        self.assertIs(batch._client, client)
-        self.assertEqual(len(batch._requests), 0)
-        self.assertEqual(len(batch._target_objects), 0)
-
-    def test_current(self):
-        from google.cloud.storage.client import Client
-        project = 'PROJECT'
-        credentials = _Credentials()
-        client = Client(project=project, credentials=credentials)
-        batch1 = self._makeOne(client)
-        self.assertIsNone(batch1.current())
-
-        client._push_batch(batch1)
-        self.assertIs(batch1.current(), batch1)
-
-        batch2 = self._makeOne(client)
-        client._push_batch(batch2)
-        self.assertIs(batch1.current(), batch2)
-
-    def test__make_request_GET_normal(self):
-        from google.cloud.storage.batch import _FutureDict
-        URL = 'http://example.com/api'
-        expected = _Response()
-        http = _HTTP((expected, ''))
-        connection = _Connection(http=http)
-        batch = self._makeOne(connection)
-        target = _MockObject()
-        response, content = batch._make_request('GET', URL,
-                                                target_object=target)
-        self.assertEqual(response.status, 204)
-        self.assertIsInstance(content, _FutureDict)
-        self.assertIs(target._properties, content)
-        self.assertEqual(http._requests, [])
-        EXPECTED_HEADERS = [
-            ('Accept-Encoding', 'gzip'),
-            ('Content-Length', '0'),
-        ]
-        solo_request, = batch._requests
-        self.assertEqual(solo_request[0], 'GET')
-        self.assertEqual(solo_request[1], URL)
-        headers = solo_request[2]
-        for key, value in EXPECTED_HEADERS:
-            self.assertEqual(headers[key], value)
-        self.assertIsNone(solo_request[3])
-
-    def test__make_request_POST_normal(self):
-        from google.cloud.storage.batch import _FutureDict
-        URL = 'http://example.com/api'
-        http = _HTTP()  # no requests expected
-        connection = _Connection(http=http)
-        batch = self._makeOne(connection)
-        target = _MockObject()
-        response, content = batch._make_request('POST', URL, data={'foo': 1},
-                                                target_object=target)
-        self.assertEqual(response.status, 204)
-        self.assertIsInstance(content, _FutureDict)
-        self.assertIs(target._properties, content)
-        self.assertEqual(http._requests, [])
-        EXPECTED_HEADERS = [
-            ('Accept-Encoding', 'gzip'),
-            ('Content-Length', '10'),
-        ]
-        solo_request, = batch._requests
-        self.assertEqual(solo_request[0], 'POST')
-        self.assertEqual(solo_request[1], URL)
-        headers = solo_request[2]
-        for key, value in EXPECTED_HEADERS:
-            self.assertEqual(headers[key], value)
-        self.assertEqual(solo_request[3], {'foo': 1})
-
-    def test__make_request_PATCH_normal(self):
-        from google.cloud.storage.batch import _FutureDict
-        URL = 'http://example.com/api'
-        http = _HTTP()  # no requests expected
-        connection = _Connection(http=http)
-        batch = self._makeOne(connection)
-        target = _MockObject()
-        response, content = batch._make_request('PATCH', URL, data={'foo': 1},
-                                                target_object=target)
-        self.assertEqual(response.status, 204)
-        self.assertIsInstance(content, _FutureDict)
-        self.assertIs(target._properties, content)
-        self.assertEqual(http._requests, [])
-        EXPECTED_HEADERS = [
-            ('Accept-Encoding', 'gzip'),
-            ('Content-Length', '10'),
-        ]
-        solo_request, = batch._requests
-        self.assertEqual(solo_request[0], 'PATCH')
-        self.assertEqual(solo_request[1], URL)
-        headers = solo_request[2]
-        for key, value in EXPECTED_HEADERS:
-            self.assertEqual(headers[key], value)
-        self.assertEqual(solo_request[3], {'foo': 1})
-
-    def test__make_request_DELETE_normal(self):
-        from google.cloud.storage.batch import _FutureDict
-        URL = 'http://example.com/api'
-        http = _HTTP()  # no requests expected
-        connection = _Connection(http=http)
-        batch = self._makeOne(connection)
-        target = _MockObject()
-        response, content = batch._make_request('DELETE', URL,
-                                                target_object=target)
-        self.assertEqual(response.status, 204)
-        self.assertIsInstance(content, _FutureDict)
-        self.assertIs(target._properties, content)
-        self.assertEqual(http._requests, [])
-        EXPECTED_HEADERS = [
-            ('Accept-Encoding', 'gzip'),
-            ('Content-Length', '0'),
-        ]
-        solo_request, = batch._requests
-        self.assertEqual(solo_request[0], 'DELETE')
-        self.assertEqual(solo_request[1], URL)
-        headers = solo_request[2]
-        for key, value in EXPECTED_HEADERS:
-            self.assertEqual(headers[key], value)
-        self.assertIsNone(solo_request[3])
-
-    def test__make_request_POST_too_many_requests(self):
-        URL = 'http://example.com/api'
-        http = _HTTP()  # no requests expected
-        connection = _Connection(http=http)
-        batch = self._makeOne(connection)
-        batch._MAX_BATCH_SIZE = 1
-        batch._requests.append(('POST', URL, {}, {'bar': 2}))
-        self.assertRaises(ValueError,
-                          batch._make_request, 'POST', URL, data={'foo': 1})
-        self.assertIs(connection.http, http)
-
-    def test_finish_empty(self):
-        http = _HTTP()  # no requests expected
-        connection = _Connection(http=http)
-        batch = self._makeOne(connection)
-        self.assertRaises(ValueError, batch.finish)
-        self.assertIs(connection.http, http)
-
-    def _check_subrequest_no_payload(self, chunk, method, url):
-        lines = chunk.splitlines()
-        # blank + 2 headers + blank + request + blank + blank
-        self.assertEqual(len(lines), 7)
-        self.assertEqual(lines[0], '')
-        self.assertEqual(lines[1], 'Content-Type: application/http')
-        self.assertEqual(lines[2], 'MIME-Version: 1.0')
-        self.assertEqual(lines[3], '')
-        self.assertEqual(lines[4], '%s %s HTTP/1.1' % (method, url))
-        self.assertEqual(lines[5], '')
-        self.assertEqual(lines[6], '')
-
-    def _check_subrequest_payload(self, chunk, method, url, payload):
-        import json
-        lines = chunk.splitlines()
-        # blank + 2 headers + blank + request + 2 headers + blank + body
-        payload_str = json.dumps(payload)
-        self.assertEqual(lines[0], '')
-        self.assertEqual(lines[1], 'Content-Type: application/http')
-        self.assertEqual(lines[2], 'MIME-Version: 1.0')
-        self.assertEqual(lines[3], '')
-        self.assertEqual(lines[4], '%s %s HTTP/1.1' % (method, url))
-        if method == 'GET':
-            self.assertEqual(len(lines), 7)
-            self.assertEqual(lines[5], '')
-            self.assertEqual(lines[6], '')
-        else:
-            self.assertEqual(len(lines), 9)
-            self.assertEqual(lines[5], 'Content-Length: %d' % len(payload_str))
-            self.assertEqual(lines[6], 'Content-Type: application/json')
-            self.assertEqual(lines[7], '')
-            self.assertEqual(json.loads(lines[8]), payload)
-
-    def test_finish_nonempty(self):
-        import httplib2
-        URL = 'http://api.example.com/other_api'
-        expected = _Response()
-        expected['content-type'] = 'multipart/mixed; boundary="DEADBEEF="'
-        http = _HTTP((expected, _THREE_PART_MIME_RESPONSE))
-        connection = _Connection(http=http)
-        client = _Client(connection)
-        batch = self._makeOne(client)
-        batch.API_BASE_URL = 'http://api.example.com'
-        batch._do_request('POST', URL, {}, {'foo': 1, 'bar': 2}, None)
-        batch._do_request('PATCH', URL, {}, {'bar': 3}, None)
-        batch._do_request('DELETE', URL, {}, None, None)
-        result = batch.finish()
-        self.assertEqual(len(result), len(batch._requests))
-        response0 = httplib2.Response({
-            'content-length': '20',
-            'content-type': 'application/json; charset=UTF-8',
-            'status': '200',
-        })
-        self.assertEqual(result[0], (response0, {'foo': 1, 'bar': 2}))
-        response1 = response0
-        self.assertEqual(result[1], (response1, {u'foo': 1, u'bar': 3}))
-        response2 = httplib2.Response({
-            'content-length': '0',
-            'status': '204',
-        })
-        self.assertEqual(result[2], (response2, ''))
-        self.assertEqual(len(http._requests), 1)
-        method, uri, headers, body = http._requests[0]
-        self.assertEqual(method, 'POST')
-        self.assertEqual(uri, 'http://api.example.com/batch')
-        self.assertEqual(len(headers), 2)
-        ctype, boundary = [x.strip()
-                           for x in headers['Content-Type'].split(';')]
-        self.assertEqual(ctype, 'multipart/mixed')
-        self.assertTrue(boundary.startswith('boundary="=='))
-        self.assertTrue(boundary.endswith('=="'))
-        self.assertEqual(headers['MIME-Version'], '1.0')
-
-        divider = '--' + boundary[len('boundary="'):-1]
-        chunks = body.split(divider)[1:-1]  # discard prolog / epilog
-        self.assertEqual(len(chunks), 3)
-
-        self._check_subrequest_payload(chunks[0], 'POST', URL,
-                                       {'foo': 1, 'bar': 2})
-
-        self._check_subrequest_payload(chunks[1], 'PATCH', URL, {'bar': 3})
-
-        self._check_subrequest_no_payload(chunks[2], 'DELETE', URL)
-
-    def test_finish_responses_mismatch(self):
-        URL = 'http://api.example.com/other_api'
-        expected = _Response()
-        expected['content-type'] = 'multipart/mixed; boundary="DEADBEEF="'
-        http = _HTTP((expected, _TWO_PART_MIME_RESPONSE_WITH_FAIL))
-        connection = _Connection(http=http)
-        client = _Client(connection)
-        batch = self._makeOne(client)
-        batch.API_BASE_URL = 'http://api.example.com'
-        batch._requests.append(('GET', URL, {}, None))
-        self.assertRaises(ValueError, batch.finish)
-
-    def test_finish_nonempty_with_status_failure(self):
-        from google.cloud.exceptions import NotFound
-        URL = 'http://api.example.com/other_api'
-        expected = _Response()
-        expected['content-type'] = 'multipart/mixed; boundary="DEADBEEF="'
-        http = _HTTP((expected, _TWO_PART_MIME_RESPONSE_WITH_FAIL))
-        connection = _Connection(http=http)
-        client = _Client(connection)
-        batch = self._makeOne(client)
-        batch.API_BASE_URL = 'http://api.example.com'
-        target1 = _MockObject()
-        target2 = _MockObject()
-        batch._do_request('GET', URL, {}, None, target1)
-        batch._do_request('GET', URL, {}, None, target2)
-        # Make sure futures are not populated.
-        self.assertEqual([future for future in batch._target_objects],
-                         [target1, target2])
-        target2_future_before = target2._properties
-        self.assertRaises(NotFound, batch.finish)
-        self.assertEqual(target1._properties,
-                         {'foo': 1, 'bar': 2})
-        self.assertIs(target2._properties, target2_future_before)
-
-        self.assertEqual(len(http._requests), 1)
-        method, uri, headers, body = http._requests[0]
-        self.assertEqual(method, 'POST')
-        self.assertEqual(uri, 'http://api.example.com/batch')
-        self.assertEqual(len(headers), 2)
-        ctype, boundary = [x.strip()
-                           for x in headers['Content-Type'].split(';')]
-        self.assertEqual(ctype, 'multipart/mixed')
-        self.assertTrue(boundary.startswith('boundary="=='))
-        self.assertTrue(boundary.endswith('=="'))
-        self.assertEqual(headers['MIME-Version'], '1.0')
-
-        divider = '--' + boundary[len('boundary="'):-1]
-        chunks = body.split(divider)[1:-1]  # discard prolog / epilog
-        self.assertEqual(len(chunks), 2)
-
-        self._check_subrequest_payload(chunks[0], 'GET', URL, {})
-        self._check_subrequest_payload(chunks[1], 'GET', URL, {})
-
-    def test_finish_nonempty_non_multipart_response(self):
-        URL = 'http://api.example.com/other_api'
-        expected = _Response()
-        expected['content-type'] = 'text/plain'
-        http = _HTTP((expected, 'NOT A MIME_RESPONSE'))
-        connection = _Connection(http=http)
-        client = _Client(connection)
-        batch = self._makeOne(client)
-        batch._requests.append(('POST', URL, {}, {'foo': 1, 'bar': 2}))
-        batch._requests.append(('PATCH', URL, {}, {'bar': 3}))
-        batch._requests.append(('DELETE', URL, {}, None))
-        self.assertRaises(ValueError, batch.finish)
-
-    def test_as_context_mgr_wo_error(self):
-        from google.cloud.storage.client import Client
-        URL = 'http://example.com/api'
-        expected = _Response()
-        expected['content-type'] = 'multipart/mixed; boundary="DEADBEEF="'
-        http = _HTTP((expected, _THREE_PART_MIME_RESPONSE))
-        project = 'PROJECT'
-        credentials = _Credentials()
-        client = Client(project=project, credentials=credentials)
-        client._connection._http = http
-
-        self.assertEqual(list(client._batch_stack), [])
-
-        target1 = _MockObject()
-        target2 = _MockObject()
-        target3 = _MockObject()
-        with self._makeOne(client) as batch:
-            self.assertEqual(list(client._batch_stack), [batch])
-            batch._make_request('POST', URL, {'foo': 1, 'bar': 2},
-                                target_object=target1)
-            batch._make_request('PATCH', URL, {'bar': 3},
-                                target_object=target2)
-            batch._make_request('DELETE', URL, target_object=target3)
-
-        self.assertEqual(list(client._batch_stack), [])
-        self.assertEqual(len(batch._requests), 3)
-        self.assertEqual(batch._requests[0][0], 'POST')
-        self.assertEqual(batch._requests[1][0], 'PATCH')
-        self.assertEqual(batch._requests[2][0], 'DELETE')
-        self.assertEqual(batch._target_objects, [target1, target2, target3])
-        self.assertEqual(target1._properties,
-                         {'foo': 1, 'bar': 2})
-        self.assertEqual(target2._properties,
-                         {'foo': 1, 'bar': 3})
-        self.assertEqual(target3._properties, '')
-
-    def test_as_context_mgr_w_error(self):
-        from google.cloud.storage.batch import _FutureDict
-        from google.cloud.storage.client import Client
-        URL = 'http://example.com/api'
-        http = _HTTP()
-        connection = _Connection(http=http)
-        project = 'PROJECT'
-        credentials = _Credentials()
-        client = Client(project=project, credentials=credentials)
-        client._connection = connection
-
-        self.assertEqual(list(client._batch_stack), [])
-
-        target1 = _MockObject()
-        target2 = _MockObject()
-        target3 = _MockObject()
-        try:
-            with self._makeOne(client) as batch:
-                self.assertEqual(list(client._batch_stack), [batch])
-                batch._make_request('POST', URL, {'foo': 1, 'bar': 2},
-                                    target_object=target1)
-                batch._make_request('PATCH', URL, {'bar': 3},
-                                    target_object=target2)
-                batch._make_request('DELETE', URL, target_object=target3)
-                raise ValueError()
-        except ValueError:
-            pass
-
-        self.assertEqual(list(client._batch_stack), [])
-        self.assertEqual(len(http._requests), 0)
-        self.assertEqual(len(batch._requests), 3)
-        self.assertEqual(batch._target_objects, [target1, target2, target3])
-        # Since the context manager fails, finish will not get called and
-        # the _properties will still be futures.
-        self.assertIsInstance(target1._properties, _FutureDict)
-        self.assertIsInstance(target2._properties, _FutureDict)
-        self.assertIsInstance(target3._properties, _FutureDict)
-
-
-class Test__unpack_batch_response(unittest.TestCase):
-
-    def _callFUT(self, response, content):
-        from google.cloud.storage.batch import _unpack_batch_response
-        return _unpack_batch_response(response, content)
-
-    def _unpack_helper(self, response, content):
-        import httplib2
-        result = list(self._callFUT(response, content))
-        self.assertEqual(len(result), 3)
-        response0 = httplib2.Response({
-            'content-length': '20',
-            'content-type': 'application/json; charset=UTF-8',
-            'status': '200',
-        })
-        self.assertEqual(result[0], (response0, {u'bar': 2, u'foo': 1}))
-        response1 = response0
-        self.assertEqual(result[1], (response1, {u'foo': 1, u'bar': 3}))
-        response2 = httplib2.Response({
-            'content-length': '0',
-            'status': '204',
-        })
-        self.assertEqual(result[2], (response2, ''))
-
-    def test_bytes(self):
-        RESPONSE = {'content-type': b'multipart/mixed; boundary="DEADBEEF="'}
-        CONTENT = _THREE_PART_MIME_RESPONSE
-        self._unpack_helper(RESPONSE, CONTENT)
-
-    def test_unicode(self):
-        RESPONSE = {'content-type': u'multipart/mixed; boundary="DEADBEEF="'}
-        CONTENT = _THREE_PART_MIME_RESPONSE.decode('utf-8')
-        self._unpack_helper(RESPONSE, CONTENT)
-
-
-_TWO_PART_MIME_RESPONSE_WITH_FAIL = b"""\
---DEADBEEF=
-Content-Type: application/http
-Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+1>
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=UTF-8
-Content-Length: 20
-
-{"foo": 1, "bar": 2}
-
---DEADBEEF=
-Content-Type: application/http
-Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+2>
-
-HTTP/1.1 404 Not Found
-Content-Type: application/json; charset=UTF-8
-Content-Length: 35
-
-{"error": {"message": "Not Found"}}
-
---DEADBEEF=--
-"""
-
-_THREE_PART_MIME_RESPONSE = b"""\
---DEADBEEF=
-Content-Type: application/http
-Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+1>
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=UTF-8
-Content-Length: 20
-
-{"foo": 1, "bar": 2}
-
---DEADBEEF=
-Content-Type: application/http
-Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+2>
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=UTF-8
-Content-Length: 20
-
-{"foo": 1, "bar": 3}
-
---DEADBEEF=
-Content-Type: application/http
-Content-ID: <response-8a09ca85-8d1d-4f45-9eb0-da8e8b07ec83+3>
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-
---DEADBEEF=--
-"""
-
-
-class Test__FutureDict(unittest.TestCase):
-
-    def _makeOne(self, *args, **kw):
-        from google.cloud.storage.batch import _FutureDict
-        return _FutureDict(*args, **kw)
-
-    def test_get(self):
-        future = self._makeOne()
-        self.assertRaises(KeyError, future.get, None)
-
-    def test___getitem__(self):
-        future = self._makeOne()
-        value = orig_value = object()
-        with self.assertRaises(KeyError):
-            value = future[None]
-        self.assertIs(value, orig_value)
-
-    def test___setitem__(self):
-        future = self._makeOne()
-        with self.assertRaises(KeyError):
-            future[None] = None
-
-
-class _Connection(object):
-
-    project = 'TESTING'
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-    def _make_request(self, method, url, data=None, headers=None):
-        return self.http.request(uri=url, method=method,
-                                 headers=headers, body=data)
-
-
-class _Response(dict):
-
-    def __init__(self, status=200, **kw):
-        self.status = status
-        super(_Response, self).__init__(**kw)
-
-
-class _HTTP(object):
-
-    def __init__(self, *responses):
-        self._requests = []
-        self._responses = list(responses)
-
-    def request(self, uri, method, headers, body):
-        self._requests.append((method, uri, headers, body))
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
-
-
-class _MockObject(object):
-    pass
-
-
-class _Client(object):
-
-    def __init__(self, connection):
-        self._connection = connection
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
diff --git a/unit_tests/storage/test_blob.py b/unit_tests/storage/test_blob.py
deleted file mode 100644
index 18aabbe42922..000000000000
--- a/unit_tests/storage/test_blob.py
+++ /dev/null
@@ -1,1514 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test_Blob(unittest.TestCase):
-
-    def _makeOne(self, *args, **kw):
-        from google.cloud.storage.blob import Blob
-        properties = kw.pop('properties', None)
-        blob = Blob(*args, **kw)
-        blob._properties = properties or {}
-        return blob
-
-    def test_ctor(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        properties = {'key': 'value'}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertIs(blob.bucket, bucket)
-        self.assertEqual(blob.name, BLOB_NAME)
-        self.assertEqual(blob._properties, properties)
-        self.assertFalse(blob._acl.loaded)
-        self.assertIs(blob._acl.blob, blob)
-
-    def test_chunk_size_ctor(self):
-        from google.cloud.storage.blob import Blob
-        BLOB_NAME = 'blob-name'
-        BUCKET = object()
-        chunk_size = 10 * Blob._CHUNK_SIZE_MULTIPLE
-        blob = self._makeOne(BLOB_NAME, bucket=BUCKET, chunk_size=chunk_size)
-        self.assertEqual(blob._chunk_size, chunk_size)
-
-    def test_chunk_size_getter(self):
-        BLOB_NAME = 'blob-name'
-        BUCKET = object()
-        blob = self._makeOne(BLOB_NAME, bucket=BUCKET)
-        self.assertIsNone(blob.chunk_size)
-        VALUE = object()
-        blob._chunk_size = VALUE
-        self.assertIs(blob.chunk_size, VALUE)
-
-    def test_chunk_size_setter(self):
-        BLOB_NAME = 'blob-name'
-        BUCKET = object()
-        blob = self._makeOne(BLOB_NAME, bucket=BUCKET)
-        self.assertIsNone(blob._chunk_size)
-        blob._CHUNK_SIZE_MULTIPLE = 10
-        blob.chunk_size = 20
-        self.assertEqual(blob._chunk_size, 20)
-
-    def test_chunk_size_setter_bad_value(self):
-        BLOB_NAME = 'blob-name'
-        BUCKET = object()
-        blob = self._makeOne(BLOB_NAME, bucket=BUCKET)
-        self.assertIsNone(blob._chunk_size)
-        blob._CHUNK_SIZE_MULTIPLE = 10
-        with self.assertRaises(ValueError):
-            blob.chunk_size = 11
-
-    def test_acl_property(self):
-        from google.cloud.storage.acl import ObjectACL
-        FAKE_BUCKET = _Bucket()
-        blob = self._makeOne(None, bucket=FAKE_BUCKET)
-        acl = blob.acl
-        self.assertIsInstance(acl, ObjectACL)
-        self.assertIs(acl, blob._acl)
-
-    def test_path_no_bucket(self):
-        FAKE_BUCKET = object()
-        NAME = 'blob-name'
-        blob = self._makeOne(NAME, bucket=FAKE_BUCKET)
-        self.assertRaises(AttributeError, getattr, blob, 'path')
-
-    def test_path_no_name(self):
-        bucket = _Bucket()
-        blob = self._makeOne(None, bucket=bucket)
-        self.assertRaises(ValueError, getattr, blob, 'path')
-
-    def test_path_normal(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertEqual(blob.path, '/b/name/o/%s' % BLOB_NAME)
-
-    def test_path_w_slash_in_name(self):
-        BLOB_NAME = 'parent/child'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertEqual(blob.path, '/b/name/o/parent%2Fchild')
-
-    def test_public_url(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertEqual(blob.public_url,
-                         'https://storage.googleapis.com/name/%s' %
-                         BLOB_NAME)
-
-    def test_public_url_w_slash_in_name(self):
-        BLOB_NAME = 'parent/child'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertEqual(
-            blob.public_url,
-            'https://storage.googleapis.com/name/parent%2Fchild')
-
-    def _basic_generate_signed_url_helper(self, credentials=None):
-        from unit_tests._testing import _Monkey
-        from google.cloud.storage import blob as MUT
-
-        BLOB_NAME = 'blob-name'
-        EXPIRATION = '2014-10-16T20:34:37.000Z'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        URI = ('http://example.com/abucket/a-blob-name?Signature=DEADBEEF'
-               '&Expiration=2014-10-16T20:34:37.000Z')
-
-        SIGNER = _Signer()
-        with _Monkey(MUT, generate_signed_url=SIGNER):
-            signed_uri = blob.generate_signed_url(EXPIRATION,
-                                                  credentials=credentials)
-            self.assertEqual(signed_uri, URI)
-
-        PATH = '/name/%s' % (BLOB_NAME,)
-        if credentials is None:
-            EXPECTED_ARGS = (_Connection.credentials,)
-        else:
-            EXPECTED_ARGS = (credentials,)
-        EXPECTED_KWARGS = {
-            'api_access_endpoint': 'https://storage.googleapis.com',
-            'expiration': EXPIRATION,
-            'method': 'GET',
-            'resource': PATH,
-            'content_type': None,
-            'response_type': None,
-            'response_disposition': None,
-            'generation': None,
-        }
-        self.assertEqual(SIGNER._signed, [(EXPECTED_ARGS, EXPECTED_KWARGS)])
-
-    def test_generate_signed_url_w_default_method(self):
-        self._basic_generate_signed_url_helper()
-
-    def test_generate_signed_url_w_content_type(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.storage import blob as MUT
-
-        BLOB_NAME = 'blob-name'
-        EXPIRATION = '2014-10-16T20:34:37.000Z'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        URI = ('http://example.com/abucket/a-blob-name?Signature=DEADBEEF'
-               '&Expiration=2014-10-16T20:34:37.000Z')
-
-        SIGNER = _Signer()
-        CONTENT_TYPE = "text/html"
-        with _Monkey(MUT, generate_signed_url=SIGNER):
-            signed_url = blob.generate_signed_url(EXPIRATION,
-                                                  content_type=CONTENT_TYPE)
-            self.assertEqual(signed_url, URI)
-
-        PATH = '/name/%s' % (BLOB_NAME,)
-        EXPECTED_ARGS = (_Connection.credentials,)
-        EXPECTED_KWARGS = {
-            'api_access_endpoint': 'https://storage.googleapis.com',
-            'expiration': EXPIRATION,
-            'method': 'GET',
-            'resource': PATH,
-            'content_type': CONTENT_TYPE,
-            'response_type': None,
-            'response_disposition': None,
-            'generation': None,
-        }
-        self.assertEqual(SIGNER._signed, [(EXPECTED_ARGS, EXPECTED_KWARGS)])
-
-    def test_generate_signed_url_w_credentials(self):
-        credentials = object()
-        self._basic_generate_signed_url_helper(credentials=credentials)
-
-    def test_generate_signed_url_w_slash_in_name(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.storage import blob as MUT
-
-        BLOB_NAME = 'parent/child'
-        EXPIRATION = '2014-10-16T20:34:37.000Z'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        URI = ('http://example.com/abucket/a-blob-name?Signature=DEADBEEF'
-               '&Expiration=2014-10-16T20:34:37.000Z')
-
-        SIGNER = _Signer()
-        with _Monkey(MUT, generate_signed_url=SIGNER):
-            signed_url = blob.generate_signed_url(EXPIRATION)
-            self.assertEqual(signed_url, URI)
-
-        EXPECTED_ARGS = (_Connection.credentials,)
-        EXPECTED_KWARGS = {
-            'api_access_endpoint': 'https://storage.googleapis.com',
-            'expiration': EXPIRATION,
-            'method': 'GET',
-            'resource': '/name/parent%2Fchild',
-            'content_type': None,
-            'response_type': None,
-            'response_disposition': None,
-            'generation': None,
-        }
-        self.assertEqual(SIGNER._signed, [(EXPECTED_ARGS, EXPECTED_KWARGS)])
-
-    def test_generate_signed_url_w_method_arg(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.storage import blob as MUT
-
-        BLOB_NAME = 'blob-name'
-        EXPIRATION = '2014-10-16T20:34:37.000Z'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        URI = ('http://example.com/abucket/a-blob-name?Signature=DEADBEEF'
-               '&Expiration=2014-10-16T20:34:37.000Z')
-
-        SIGNER = _Signer()
-        with _Monkey(MUT, generate_signed_url=SIGNER):
-            signed_uri = blob.generate_signed_url(EXPIRATION, method='POST')
-            self.assertEqual(signed_uri, URI)
-
-        PATH = '/name/%s' % (BLOB_NAME,)
-        EXPECTED_ARGS = (_Connection.credentials,)
-        EXPECTED_KWARGS = {
-            'api_access_endpoint': 'https://storage.googleapis.com',
-            'expiration': EXPIRATION,
-            'method': 'POST',
-            'resource': PATH,
-            'content_type': None,
-            'response_type': None,
-            'response_disposition': None,
-            'generation': None,
-        }
-        self.assertEqual(SIGNER._signed, [(EXPECTED_ARGS, EXPECTED_KWARGS)])
-
-    def test_exists_miss(self):
-        from six.moves.http_client import NOT_FOUND
-        NONESUCH = 'nonesuch'
-        not_found_response = ({'status': NOT_FOUND}, b'')
-        connection = _Connection(not_found_response)
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(NONESUCH, bucket=bucket)
-        self.assertFalse(blob.exists())
-
-    def test_exists_hit(self):
-        from six.moves.http_client import OK
-        BLOB_NAME = 'blob-name'
-        found_response = ({'status': OK}, b'')
-        connection = _Connection(found_response)
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        bucket._blobs[BLOB_NAME] = 1
-        self.assertTrue(blob.exists())
-
-    def test_delete(self):
-        from six.moves.http_client import NOT_FOUND
-        BLOB_NAME = 'blob-name'
-        not_found_response = ({'status': NOT_FOUND}, b'')
-        connection = _Connection(not_found_response)
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        bucket._blobs[BLOB_NAME] = 1
-        blob.delete()
-        self.assertFalse(blob.exists())
-        self.assertEqual(bucket._deleted, [(BLOB_NAME, None)])
-
-    def test_download_to_file_wo_media_link(self):
-        from six.moves.http_client import OK
-        from six.moves.http_client import PARTIAL_CONTENT
-        from io import BytesIO
-        BLOB_NAME = 'blob-name'
-        MEDIA_LINK = 'http://example.com/media/'
-        chunk1_response = {'status': PARTIAL_CONTENT,
-                           'content-range': 'bytes 0-2/6'}
-        chunk2_response = {'status': OK,
-                           'content-range': 'bytes 3-5/6'}
-        connection = _Connection(
-            (chunk1_response, b'abc'),
-            (chunk2_response, b'def'),
-        )
-        # Only the 'reload' request hits on this side:  the others are done
-        # through the 'http' object.
-        reload_response = {'status': OK, 'content-type': 'application/json'}
-        connection._responses = [(reload_response, {"mediaLink": MEDIA_LINK})]
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        fh = BytesIO()
-        blob.download_to_file(fh)
-        self.assertEqual(fh.getvalue(), b'abcdef')
-        self.assertEqual(blob.media_link, MEDIA_LINK)
-
-    def _download_to_file_helper(self, chunk_size=None):
-        from six.moves.http_client import OK
-        from six.moves.http_client import PARTIAL_CONTENT
-        from io import BytesIO
-        BLOB_NAME = 'blob-name'
-        chunk1_response = {'status': PARTIAL_CONTENT,
-                           'content-range': 'bytes 0-2/6'}
-        chunk2_response = {'status': OK,
-                           'content-range': 'bytes 3-5/6'}
-        connection = _Connection(
-            (chunk1_response, b'abc'),
-            (chunk2_response, b'def'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        MEDIA_LINK = 'http://example.com/media/'
-        properties = {'mediaLink': MEDIA_LINK}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        if chunk_size is not None:
-            blob._CHUNK_SIZE_MULTIPLE = 1
-            blob.chunk_size = chunk_size
-        fh = BytesIO()
-        blob.download_to_file(fh)
-        self.assertEqual(fh.getvalue(), b'abcdef')
-
-    def test_download_to_file_default(self):
-        self._download_to_file_helper()
-
-    def test_download_to_file_with_chunk_size(self):
-        self._download_to_file_helper(chunk_size=3)
-
-    def test_download_to_filename(self):
-        import os
-        import time
-        from six.moves.http_client import OK
-        from six.moves.http_client import PARTIAL_CONTENT
-        from unit_tests._testing import _NamedTemporaryFile
-
-        BLOB_NAME = 'blob-name'
-        chunk1_response = {'status': PARTIAL_CONTENT,
-                           'content-range': 'bytes 0-2/6'}
-        chunk2_response = {'status': OK,
-                           'content-range': 'bytes 3-5/6'}
-        connection = _Connection(
-            (chunk1_response, b'abc'),
-            (chunk2_response, b'def'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        MEDIA_LINK = 'http://example.com/media/'
-        properties = {'mediaLink': MEDIA_LINK,
-                      'updated': '2014-12-06T13:13:50.690Z'}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 3
-
-        with _NamedTemporaryFile() as temp:
-            blob.download_to_filename(temp.name)
-            with open(temp.name, 'rb') as file_obj:
-                wrote = file_obj.read()
-                mtime = os.path.getmtime(temp.name)
-                updatedTime = time.mktime(blob.updated.timetuple())
-
-        self.assertEqual(wrote, b'abcdef')
-        self.assertEqual(mtime, updatedTime)
-
-    def test_download_to_filename_w_key(self):
-        import os
-        import time
-        from six.moves.http_client import OK
-        from six.moves.http_client import PARTIAL_CONTENT
-        from unit_tests._testing import _NamedTemporaryFile
-
-        BLOB_NAME = 'blob-name'
-        KEY = 'aa426195405adee2c8081bb9e7e74b19'
-        HEADER_KEY_VALUE = 'YWE0MjYxOTU0MDVhZGVlMmM4MDgxYmI5ZTdlNzRiMTk='
-        HEADER_KEY_HASH_VALUE = 'V3Kwe46nKc3xLv96+iJ707YfZfFvlObta8TQcx2gpm0='
-        chunk1_response = {'status': PARTIAL_CONTENT,
-                           'content-range': 'bytes 0-2/6'}
-        chunk2_response = {'status': OK,
-                           'content-range': 'bytes 3-5/6'}
-        connection = _Connection(
-            (chunk1_response, b'abc'),
-            (chunk2_response, b'def'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        MEDIA_LINK = 'http://example.com/media/'
-        properties = {'mediaLink': MEDIA_LINK,
-                      'updated': '2014-12-06T13:13:50.690Z'}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 3
-
-        with _NamedTemporaryFile() as temp:
-            blob.download_to_filename(temp.name, encryption_key=KEY)
-            with open(temp.name, 'rb') as file_obj:
-                wrote = file_obj.read()
-                mtime = os.path.getmtime(temp.name)
-                updatedTime = time.mktime(blob.updated.timetuple())
-
-        rq = connection.http._requested
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['X-Goog-Encryption-Algorithm'], 'AES256')
-        self.assertEqual(headers['X-Goog-Encryption-Key'], HEADER_KEY_VALUE)
-        self.assertEqual(headers['X-Goog-Encryption-Key-Sha256'],
-                         HEADER_KEY_HASH_VALUE)
-        self.assertEqual(wrote, b'abcdef')
-        self.assertEqual(mtime, updatedTime)
-
-    def test_download_as_string(self):
-        from six.moves.http_client import OK
-        from six.moves.http_client import PARTIAL_CONTENT
-        BLOB_NAME = 'blob-name'
-        chunk1_response = {'status': PARTIAL_CONTENT,
-                           'content-range': 'bytes 0-2/6'}
-        chunk2_response = {'status': OK,
-                           'content-range': 'bytes 3-5/6'}
-        connection = _Connection(
-            (chunk1_response, b'abc'),
-            (chunk2_response, b'def'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        MEDIA_LINK = 'http://example.com/media/'
-        properties = {'mediaLink': MEDIA_LINK}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 3
-        fetched = blob.download_as_string()
-        self.assertEqual(fetched, b'abcdef')
-
-    def test_upload_from_file_size_failure(self):
-        BLOB_NAME = 'blob-name'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        file_obj = object()
-        with self.assertRaises(ValueError):
-            blob.upload_from_file(file_obj, size=None)
-
-    def _upload_from_file_simple_test_helper(self, properties=None,
-                                             content_type_arg=None,
-                                             expected_content_type=None,
-                                             chunk_size=5,
-                                             status=None):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _NamedTemporaryFile
-
-        BLOB_NAME = 'blob-name'
-        DATA = b'ABCDEF'
-        if status is None:
-            status = OK
-        response = {'status': status}
-        connection = _Connection(
-            (response, b'{}'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = chunk_size
-
-        with _NamedTemporaryFile() as temp:
-            with open(temp.name, 'wb') as file_obj:
-                file_obj.write(DATA)
-
-            with open(temp.name, 'rb') as file_obj:
-                blob.upload_from_file(file_obj, rewind=True,
-                                      content_type=content_type_arg)
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': BLOB_NAME})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['Content-Length'], '6')
-        self.assertEqual(headers['Content-Type'], expected_content_type)
-
-    def test_upload_from_file_stream(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from google.cloud.streaming import http_wrapper
-
-        BLOB_NAME = 'blob-name'
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = b'ABCDE'
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        # Need valid JSON on last response, since resumable.
-        connection = _Connection(
-            (loc_response, b''),
-            (chunk1_response, b''),
-            (chunk2_response, b'{}'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-
-        file_obj = _Stream(DATA)
-
-        # Mock stream closes at end of data, like a socket might
-        def is_stream_closed(stream):
-            if stream.tell() < len(DATA):
-                return stream._closed
-            else:
-                return stream.close() or True
-
-        _Stream.closed = property(is_stream_closed)
-
-        def fileno_mock():
-            from io import UnsupportedOperation
-            raise UnsupportedOperation()
-
-        file_obj.fileno = fileno_mock
-
-        blob.upload_from_file(file_obj)
-
-        # Remove the temp property
-        delattr(_Stream, "closed")
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 3)
-
-        # Requested[0]
-        headers = {
-            x.title(): str(y) for x, y in rq[0].pop('headers').items()}
-        self.assertEqual(headers['Content-Length'], '0')
-        self.assertEqual(headers['X-Upload-Content-Type'],
-                         'application/octet-stream')
-
-        uri = rq[0].pop('uri')
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'resumable', 'name': BLOB_NAME})
-        self.assertEqual(rq[0], {
-            'method': 'POST',
-            'body': '',
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-        # Requested[1]
-        headers = {
-            x.title(): str(y) for x, y in rq[1].pop('headers').items()}
-        self.assertEqual(headers['Content-Range'], 'bytes 0-4/*')
-        self.assertEqual(rq[1], {
-            'method': 'PUT',
-            'uri': UPLOAD_URL,
-            'body': DATA[:5],
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-        # Requested[2]
-        headers = {
-            x.title(): str(y) for x, y in rq[2].pop('headers').items()}
-        self.assertEqual(headers['Content-Range'], 'bytes */5')
-        self.assertEqual(rq[2], {
-            'method': 'PUT',
-            'uri': UPLOAD_URL,
-            'body': DATA[5:],
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-    def test_upload_from_file_simple(self):
-        self._upload_from_file_simple_test_helper(
-            expected_content_type='application/octet-stream')
-
-    def test_upload_from_file_simple_not_found(self):
-        from six.moves.http_client import NOT_FOUND
-        from google.cloud.exceptions import NotFound
-        with self.assertRaises(NotFound):
-            self._upload_from_file_simple_test_helper(status=NOT_FOUND)
-
-    def test_upload_from_file_simple_w_chunk_size_None(self):
-        self._upload_from_file_simple_test_helper(
-            expected_content_type='application/octet-stream',
-            chunk_size=None)
-
-    def test_upload_from_file_simple_with_content_type(self):
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        self._upload_from_file_simple_test_helper(
-            properties={'contentType': EXPECTED_CONTENT_TYPE},
-            expected_content_type=EXPECTED_CONTENT_TYPE)
-
-    def test_upload_from_file_simple_with_content_type_passed(self):
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        self._upload_from_file_simple_test_helper(
-            content_type_arg=EXPECTED_CONTENT_TYPE,
-            expected_content_type=EXPECTED_CONTENT_TYPE)
-
-    def test_upload_from_file_simple_both_content_type_sources(self):
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        ALT_CONTENT_TYPE = 'foo/baz'
-        self._upload_from_file_simple_test_helper(
-            properties={'contentType': ALT_CONTENT_TYPE},
-            content_type_arg=EXPECTED_CONTENT_TYPE,
-            expected_content_type=EXPECTED_CONTENT_TYPE)
-
-    def test_upload_from_file_resumable(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _Monkey
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud.streaming import http_wrapper
-        from google.cloud.streaming import transfer
-
-        BLOB_NAME = 'blob-name'
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = b'ABCDEF'
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        # Need valid JSON on last response, since resumable.
-        connection = _Connection(
-            (loc_response, b''),
-            (chunk1_response, b''),
-            (chunk2_response, b'{}'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-
-        # Set the threshhold low enough that we force a resumable uploada.
-        with _Monkey(transfer, RESUMABLE_UPLOAD_THRESHOLD=5):
-            with _NamedTemporaryFile() as temp:
-                with open(temp.name, 'wb') as file_obj:
-                    file_obj.write(DATA)
-                with open(temp.name, 'rb') as file_obj:
-                    blob.upload_from_file(file_obj, rewind=True)
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 3)
-
-        # Requested[0]
-        headers = {
-            x.title(): str(y) for x, y in rq[0].pop('headers').items()}
-        self.assertEqual(headers['X-Upload-Content-Length'], '6')
-        self.assertEqual(headers['X-Upload-Content-Type'],
-                         'application/octet-stream')
-
-        uri = rq[0].pop('uri')
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'resumable', 'name': BLOB_NAME})
-        self.assertEqual(rq[0], {
-            'method': 'POST',
-            'body': '',
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-        # Requested[1]
-        headers = {
-            x.title(): str(y) for x, y in rq[1].pop('headers').items()}
-        self.assertEqual(headers['Content-Range'], 'bytes 0-4/6')
-        self.assertEqual(rq[1], {
-            'method': 'PUT',
-            'uri': UPLOAD_URL,
-            'body': DATA[:5],
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-        # Requested[2]
-        headers = {
-            x.title(): str(y) for x, y in rq[2].pop('headers').items()}
-        self.assertEqual(headers['Content-Range'], 'bytes 5-5/6')
-        self.assertEqual(rq[2], {
-            'method': 'PUT',
-            'uri': UPLOAD_URL,
-            'body': DATA[5:],
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-    def test_upload_from_file_resumable_w_error(self):
-        from six.moves.http_client import NOT_FOUND
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _Monkey
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud.streaming import transfer
-        from google.cloud.streaming.exceptions import HttpError
-
-        BLOB_NAME = 'blob-name'
-        DATA = b'ABCDEF'
-        loc_response = {'status': NOT_FOUND}
-        connection = _Connection(
-            (loc_response, b'{"error": "no such bucket"}'),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-
-        # Set the threshhold low enough that we force a resumable uploada.
-        with _Monkey(transfer, RESUMABLE_UPLOAD_THRESHOLD=5):
-            with _NamedTemporaryFile() as temp:
-                with open(temp.name, 'wb') as file_obj:
-                    file_obj.write(DATA)
-                with open(temp.name, 'rb') as file_obj:
-                    with self.assertRaises(HttpError):
-                        blob.upload_from_file(file_obj, rewind=True)
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-
-        # Requested[0]
-        headers = {
-            x.title(): str(y) for x, y in rq[0].pop('headers').items()}
-        self.assertEqual(headers['X-Upload-Content-Length'], '6')
-        self.assertEqual(headers['X-Upload-Content-Type'],
-                         'application/octet-stream')
-
-        uri = rq[0].pop('uri')
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'resumable', 'name': BLOB_NAME})
-        self.assertEqual(rq[0], {
-            'method': 'POST',
-            'body': '',
-            'connection_type': None,
-            'redirections': 5,
-        })
-
-    def test_upload_from_file_w_slash_in_name(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud.streaming import http_wrapper
-
-        BLOB_NAME = 'parent/child'
-        UPLOAD_URL = 'http://example.com/upload/name/parent%2Fchild'
-        DATA = b'ABCDEF'
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        connection = _Connection(
-            (loc_response, '{}'),
-            (chunk1_response, ''),
-            (chunk2_response, ''),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-
-        with _NamedTemporaryFile() as temp:
-            with open(temp.name, 'wb') as file_obj:
-                file_obj.write(DATA)
-            with open(temp.name, 'rb') as file_obj:
-                blob.upload_from_file(file_obj, rewind=True)
-                self.assertEqual(file_obj.tell(), len(DATA))
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['redirections'], 5)
-        self.assertEqual(rq[0]['body'], DATA)
-        self.assertIsNone(rq[0]['connection_type'])
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': 'parent/child'})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['Content-Length'], '6')
-        self.assertEqual(headers['Content-Type'], 'application/octet-stream')
-
-    def test_upload_from_filename_w_key(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud.streaming import http_wrapper
-
-        BLOB_NAME = 'blob-name'
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = b'ABCDEF'
-        KEY = 'aa426195405adee2c8081bb9e7e74b19'
-        HEADER_KEY_VALUE = 'YWE0MjYxOTU0MDVhZGVlMmM4MDgxYmI5ZTdlNzRiMTk='
-        HEADER_KEY_HASH_VALUE = 'V3Kwe46nKc3xLv96+iJ707YfZfFvlObta8TQcx2gpm0='
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        properties = {'contentType': EXPECTED_CONTENT_TYPE}
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        connection = _Connection(
-            (loc_response, '{}'),
-            (chunk1_response, ''),
-            (chunk2_response, ''),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket,
-                             properties=properties)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-
-        with _NamedTemporaryFile(suffix='.jpeg') as temp:
-            with open(temp.name, 'wb') as file_obj:
-                file_obj.write(DATA)
-            blob.upload_from_filename(temp.name,
-                                      content_type=EXPECTED_CONTENT_TYPE,
-                                      encryption_key=KEY)
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': BLOB_NAME})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['X-Goog-Encryption-Algorithm'], 'AES256')
-        self.assertEqual(headers['X-Goog-Encryption-Key'], HEADER_KEY_VALUE)
-        self.assertEqual(headers['X-Goog-Encryption-Key-Sha256'],
-                         HEADER_KEY_HASH_VALUE)
-        self.assertEqual(headers['Content-Length'], '6')
-        self.assertEqual(headers['Content-Type'], 'foo/bar')
-
-    def _upload_from_filename_test_helper(self, properties=None,
-                                          content_type_arg=None,
-                                          expected_content_type=None):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _NamedTemporaryFile
-        from google.cloud.streaming import http_wrapper
-
-        BLOB_NAME = 'blob-name'
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = b'ABCDEF'
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        connection = _Connection(
-            (loc_response, '{}'),
-            (chunk1_response, ''),
-            (chunk2_response, ''),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket,
-                             properties=properties)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-
-        with _NamedTemporaryFile(suffix='.jpeg') as temp:
-            with open(temp.name, 'wb') as file_obj:
-                file_obj.write(DATA)
-            blob.upload_from_filename(temp.name,
-                                      content_type=content_type_arg)
-
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': BLOB_NAME})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['Content-Length'], '6')
-        self.assertEqual(headers['Content-Type'], expected_content_type)
-
-    def test_upload_from_filename(self):
-        self._upload_from_filename_test_helper(
-            expected_content_type='image/jpeg')
-
-    def test_upload_from_filename_with_content_type(self):
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        self._upload_from_filename_test_helper(
-            properties={'contentType': EXPECTED_CONTENT_TYPE},
-            expected_content_type=EXPECTED_CONTENT_TYPE)
-
-    def test_upload_from_filename_with_content_type_passed(self):
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        self._upload_from_filename_test_helper(
-            content_type_arg=EXPECTED_CONTENT_TYPE,
-            expected_content_type=EXPECTED_CONTENT_TYPE)
-
-    def test_upload_from_filename_both_content_type_sources(self):
-        EXPECTED_CONTENT_TYPE = 'foo/bar'
-        ALT_CONTENT_TYPE = 'foo/baz'
-        self._upload_from_filename_test_helper(
-            properties={'contentType': ALT_CONTENT_TYPE},
-            content_type_arg=EXPECTED_CONTENT_TYPE,
-            expected_content_type=EXPECTED_CONTENT_TYPE)
-
-    def test_upload_from_string_w_bytes(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from google.cloud.streaming import http_wrapper
-        BLOB_NAME = 'blob-name'
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = b'ABCDEF'
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        connection = _Connection(
-            (loc_response, '{}'),
-            (chunk1_response, ''),
-            (chunk2_response, ''),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-        blob.upload_from_string(DATA)
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': BLOB_NAME})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['Content-Length'], '6')
-        self.assertEqual(headers['Content-Type'], 'text/plain')
-        self.assertEqual(rq[0]['body'], DATA)
-
-    def test_upload_from_string_w_text(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from google.cloud.streaming import http_wrapper
-        BLOB_NAME = 'blob-name'
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = u'ABCDEF\u1234'
-        ENCODED = DATA.encode('utf-8')
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        connection = _Connection(
-            (loc_response, '{}'),
-            (chunk1_response, ''),
-            (chunk2_response, ''),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client=client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-        blob.upload_from_string(DATA)
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': BLOB_NAME})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-        self.assertEqual(headers['Content-Length'], str(len(ENCODED)))
-        self.assertEqual(headers['Content-Type'], 'text/plain')
-        self.assertEqual(rq[0]['body'], ENCODED)
-
-    def test_upload_from_string_text_w_key(self):
-        from six.moves.http_client import OK
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        from google.cloud.streaming import http_wrapper
-        BLOB_NAME = 'blob-name'
-        KEY = 'aa426195405adee2c8081bb9e7e74b19'
-        HEADER_KEY_VALUE = 'YWE0MjYxOTU0MDVhZGVlMmM4MDgxYmI5ZTdlNzRiMTk='
-        HEADER_KEY_HASH_VALUE = 'V3Kwe46nKc3xLv96+iJ707YfZfFvlObta8TQcx2gpm0='
-        UPLOAD_URL = 'http://example.com/upload/name/key'
-        DATA = u'ABCDEF\u1234'
-        ENCODED = DATA.encode('utf-8')
-        loc_response = {'status': OK, 'location': UPLOAD_URL}
-        chunk1_response = {'status': http_wrapper.RESUME_INCOMPLETE,
-                           'range': 'bytes 0-4'}
-        chunk2_response = {'status': OK}
-        connection = _Connection(
-            (loc_response, '{}'),
-            (chunk1_response, ''),
-            (chunk2_response, ''),
-        )
-        client = _Client(connection)
-        bucket = _Bucket(client=client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob._CHUNK_SIZE_MULTIPLE = 1
-        blob.chunk_size = 5
-        blob.upload_from_string(DATA, encryption_key=KEY)
-        rq = connection.http._requested
-        self.assertEqual(len(rq), 1)
-        self.assertEqual(rq[0]['method'], 'POST')
-        uri = rq[0]['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'example.com')
-        self.assertEqual(path, '/b/name/o')
-        self.assertEqual(dict(parse_qsl(qs)),
-                         {'uploadType': 'media', 'name': BLOB_NAME})
-        headers = {
-            x.title(): str(y) for x, y in rq[0]['headers'].items()}
-
-        self.assertEqual(headers['X-Goog-Encryption-Algorithm'], 'AES256')
-        self.assertEqual(headers['X-Goog-Encryption-Key'], HEADER_KEY_VALUE)
-        self.assertEqual(headers['X-Goog-Encryption-Key-Sha256'],
-                         HEADER_KEY_HASH_VALUE)
-        self.assertEqual(headers['Content-Length'], str(len(ENCODED)))
-        self.assertEqual(headers['Content-Type'], 'text/plain')
-        self.assertEqual(rq[0]['body'], ENCODED)
-
-    def test_make_public(self):
-        from six.moves.http_client import OK
-        from google.cloud.storage.acl import _ACLEntity
-        BLOB_NAME = 'blob-name'
-        permissive = [{'entity': 'allUsers', 'role': _ACLEntity.READER_ROLE}]
-        after = ({'status': OK}, {'acl': permissive})
-        connection = _Connection(after)
-        client = _Client(connection)
-        bucket = _Bucket(client=client)
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        blob.acl.loaded = True
-        blob.make_public()
-        self.assertEqual(list(blob.acl), permissive)
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/b/name/o/%s' % BLOB_NAME)
-        self.assertEqual(kw[0]['data'], {'acl': permissive})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-
-    def test_cache_control_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        CACHE_CONTROL = 'no-cache'
-        properties = {'cacheControl': CACHE_CONTROL}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.cache_control, CACHE_CONTROL)
-
-    def test_cache_control_setter(self):
-        BLOB_NAME = 'blob-name'
-        CACHE_CONTROL = 'no-cache'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.cache_control)
-        blob.cache_control = CACHE_CONTROL
-        self.assertEqual(blob.cache_control, CACHE_CONTROL)
-
-    def test_component_count(self):
-        BUCKET = object()
-        COMPONENT_COUNT = 42
-        blob = self._makeOne('blob-name', bucket=BUCKET,
-                             properties={'componentCount': COMPONENT_COUNT})
-        self.assertEqual(blob.component_count, COMPONENT_COUNT)
-
-    def test_component_count_unset(self):
-        BUCKET = object()
-        blob = self._makeOne('blob-name', bucket=BUCKET)
-        self.assertIsNone(blob.component_count)
-
-    def test_component_count_string_val(self):
-        BUCKET = object()
-        COMPONENT_COUNT = 42
-        blob = self._makeOne(
-            'blob-name', bucket=BUCKET,
-            properties={'componentCount': str(COMPONENT_COUNT)})
-        self.assertEqual(blob.component_count, COMPONENT_COUNT)
-
-    def test_content_disposition_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        CONTENT_DISPOSITION = 'Attachment; filename=example.jpg'
-        properties = {'contentDisposition': CONTENT_DISPOSITION}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.content_disposition, CONTENT_DISPOSITION)
-
-    def test_content_disposition_setter(self):
-        BLOB_NAME = 'blob-name'
-        CONTENT_DISPOSITION = 'Attachment; filename=example.jpg'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.content_disposition)
-        blob.content_disposition = CONTENT_DISPOSITION
-        self.assertEqual(blob.content_disposition, CONTENT_DISPOSITION)
-
-    def test_content_encoding_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        CONTENT_ENCODING = 'gzip'
-        properties = {'contentEncoding': CONTENT_ENCODING}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.content_encoding, CONTENT_ENCODING)
-
-    def test_content_encoding_setter(self):
-        BLOB_NAME = 'blob-name'
-        CONTENT_ENCODING = 'gzip'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.content_encoding)
-        blob.content_encoding = CONTENT_ENCODING
-        self.assertEqual(blob.content_encoding, CONTENT_ENCODING)
-
-    def test_content_language_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        CONTENT_LANGUAGE = 'pt-BR'
-        properties = {'contentLanguage': CONTENT_LANGUAGE}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.content_language, CONTENT_LANGUAGE)
-
-    def test_content_language_setter(self):
-        BLOB_NAME = 'blob-name'
-        CONTENT_LANGUAGE = 'pt-BR'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.content_language)
-        blob.content_language = CONTENT_LANGUAGE
-        self.assertEqual(blob.content_language, CONTENT_LANGUAGE)
-
-    def test_content_type_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        CONTENT_TYPE = 'image/jpeg'
-        properties = {'contentType': CONTENT_TYPE}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.content_type, CONTENT_TYPE)
-
-    def test_content_type_setter(self):
-        BLOB_NAME = 'blob-name'
-        CONTENT_TYPE = 'image/jpeg'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.content_type)
-        blob.content_type = CONTENT_TYPE
-        self.assertEqual(blob.content_type, CONTENT_TYPE)
-
-    def test_crc32c_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        CRC32C = 'DEADBEEF'
-        properties = {'crc32c': CRC32C}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.crc32c, CRC32C)
-
-    def test_crc32c_setter(self):
-        BLOB_NAME = 'blob-name'
-        CRC32C = 'DEADBEEF'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.crc32c)
-        blob.crc32c = CRC32C
-        self.assertEqual(blob.crc32c, CRC32C)
-
-    def test_etag(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        ETAG = 'ETAG'
-        properties = {'etag': ETAG}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.etag, ETAG)
-
-    def test_generation(self):
-        BUCKET = object()
-        GENERATION = 42
-        blob = self._makeOne('blob-name', bucket=BUCKET,
-                             properties={'generation': GENERATION})
-        self.assertEqual(blob.generation, GENERATION)
-
-    def test_generation_unset(self):
-        BUCKET = object()
-        blob = self._makeOne('blob-name', bucket=BUCKET)
-        self.assertIsNone(blob.generation)
-
-    def test_generation_string_val(self):
-        BUCKET = object()
-        GENERATION = 42
-        blob = self._makeOne('blob-name', bucket=BUCKET,
-                             properties={'generation': str(GENERATION)})
-        self.assertEqual(blob.generation, GENERATION)
-
-    def test_id(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        ID = 'ID'
-        properties = {'id': ID}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.id, ID)
-
-    def test_md5_hash_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        MD5_HASH = 'DEADBEEF'
-        properties = {'md5Hash': MD5_HASH}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.md5_hash, MD5_HASH)
-
-    def test_md5_hash_setter(self):
-        BLOB_NAME = 'blob-name'
-        MD5_HASH = 'DEADBEEF'
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.md5_hash)
-        blob.md5_hash = MD5_HASH
-        self.assertEqual(blob.md5_hash, MD5_HASH)
-
-    def test_media_link(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        MEDIA_LINK = 'http://example.com/media/'
-        properties = {'mediaLink': MEDIA_LINK}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.media_link, MEDIA_LINK)
-
-    def test_metadata_getter(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        METADATA = {'foo': 'Foo'}
-        properties = {'metadata': METADATA}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.metadata, METADATA)
-
-    def test_metadata_setter(self):
-        BLOB_NAME = 'blob-name'
-        METADATA = {'foo': 'Foo'}
-        bucket = _Bucket()
-        blob = self._makeOne(BLOB_NAME, bucket=bucket)
-        self.assertIsNone(blob.metadata)
-        blob.metadata = METADATA
-        self.assertEqual(blob.metadata, METADATA)
-
-    def test_metageneration(self):
-        BUCKET = object()
-        METAGENERATION = 42
-        blob = self._makeOne('blob-name', bucket=BUCKET,
-                             properties={'metageneration': METAGENERATION})
-        self.assertEqual(blob.metageneration, METAGENERATION)
-
-    def test_metageneration_unset(self):
-        BUCKET = object()
-        blob = self._makeOne('blob-name', bucket=BUCKET)
-        self.assertIsNone(blob.metageneration)
-
-    def test_metageneration_string_val(self):
-        BUCKET = object()
-        METAGENERATION = 42
-        blob = self._makeOne(
-            'blob-name', bucket=BUCKET,
-            properties={'metageneration': str(METAGENERATION)})
-        self.assertEqual(blob.metageneration, METAGENERATION)
-
-    def test_owner(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        OWNER = {'entity': 'project-owner-12345', 'entityId': '23456'}
-        properties = {'owner': OWNER}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        owner = blob.owner
-        self.assertEqual(owner['entity'], 'project-owner-12345')
-        self.assertEqual(owner['entityId'], '23456')
-
-    def test_self_link(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        SELF_LINK = 'http://example.com/self/'
-        properties = {'selfLink': SELF_LINK}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.self_link, SELF_LINK)
-
-    def test_size(self):
-        BUCKET = object()
-        SIZE = 42
-        blob = self._makeOne('blob-name', bucket=BUCKET,
-                             properties={'size': SIZE})
-        self.assertEqual(blob.size, SIZE)
-
-    def test_size_unset(self):
-        BUCKET = object()
-        blob = self._makeOne('blob-name', bucket=BUCKET)
-        self.assertIsNone(blob.size)
-
-    def test_size_string_val(self):
-        BUCKET = object()
-        SIZE = 42
-        blob = self._makeOne('blob-name', bucket=BUCKET,
-                             properties={'size': str(SIZE)})
-        self.assertEqual(blob.size, SIZE)
-
-    def test_storage_class(self):
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        STORAGE_CLASS = 'http://example.com/self/'
-        properties = {'storageClass': STORAGE_CLASS}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.storage_class, STORAGE_CLASS)
-
-    def test_time_deleted(self):
-        import datetime
-        from google.cloud._helpers import _RFC3339_MICROS
-        from google.cloud._helpers import UTC
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
-        TIME_DELETED = TIMESTAMP.strftime(_RFC3339_MICROS)
-        properties = {'timeDeleted': TIME_DELETED}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.time_deleted, TIMESTAMP)
-
-    def test_time_deleted_unset(self):
-        BUCKET = object()
-        blob = self._makeOne('blob-name', bucket=BUCKET)
-        self.assertIsNone(blob.time_deleted)
-
-    def test_updated(self):
-        import datetime
-        from google.cloud._helpers import _RFC3339_MICROS
-        from google.cloud._helpers import UTC
-        BLOB_NAME = 'blob-name'
-        bucket = _Bucket()
-        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
-        UPDATED = TIMESTAMP.strftime(_RFC3339_MICROS)
-        properties = {'updated': UPDATED}
-        blob = self._makeOne(BLOB_NAME, bucket=bucket, properties=properties)
-        self.assertEqual(blob.updated, TIMESTAMP)
-
-    def test_updated_unset(self):
-        BUCKET = object()
-        blob = self._makeOne('blob-name', bucket=BUCKET)
-        self.assertIsNone(blob.updated)
-
-
-class _Responder(object):
-
-    def __init__(self, *responses):
-        self._responses = responses[:]
-        self._requested = []
-
-    def _respond(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
-
-
-class _Connection(_Responder):
-
-    API_BASE_URL = 'http://example.com'
-    USER_AGENT = 'testing 1.2.3'
-    credentials = object()
-
-    def __init__(self, *responses):
-        super(_Connection, self).__init__(*responses)
-        self._signed = []
-        self.http = _HTTP(*responses)
-
-    def api_request(self, **kw):
-        from six.moves.http_client import NOT_FOUND
-        from google.cloud.exceptions import NotFound
-        info, content = self._respond(**kw)
-        if info.get('status') == NOT_FOUND:
-            raise NotFound(info)
-        return content
-
-    def build_api_url(self, path, query_params=None,
-                      api_base_url=API_BASE_URL):
-        from six.moves.urllib.parse import urlencode
-        from six.moves.urllib.parse import urlsplit
-        from six.moves.urllib.parse import urlunsplit
-        # Mimic the build_api_url interface.
-        qs = urlencode(query_params or {})
-        scheme, netloc, _, _, _ = urlsplit(api_base_url)
-        return urlunsplit((scheme, netloc, path, qs, ''))
-
-
-class _HTTP(_Responder):
-
-    connections = {}  # For google-apitools debugging.
-
-    def request(self, uri, method, headers, body, **kw):
-        if hasattr(body, 'read'):
-            body = body.read()
-        return self._respond(uri=uri, method=method, headers=headers,
-                             body=body, **kw)
-
-
-class _Bucket(object):
-    path = '/b/name'
-    name = 'name'
-
-    def __init__(self, client=None):
-        if client is None:
-            connection = _Connection()
-            client = _Client(connection)
-        self.client = client
-        self._blobs = {}
-        self._copied = []
-        self._deleted = []
-
-    def delete_blob(self, blob_name, client=None):
-        del self._blobs[blob_name]
-        self._deleted.append((blob_name, client))
-
-
-class _Signer(object):
-
-    def __init__(self):
-        self._signed = []
-
-    def __call__(self, *args, **kwargs):
-        self._signed.append((args, kwargs))
-        return ('http://example.com/abucket/a-blob-name?Signature=DEADBEEF'
-                '&Expiration=%s' % kwargs.get('expiration'))
-
-
-class _Client(object):
-
-    def __init__(self, connection):
-        self._connection = connection
-
-    @property
-    def connection(self):
-        return self._connection
-
-
-class _Stream(object):
-    _closed = False
-
-    def __init__(self, to_read=b''):
-        import io
-        self._written = []
-        self._to_read = io.BytesIO(to_read)
-
-    def seek(self, offset, whence=0):
-        self._to_read.seek(offset, whence)
-
-    def read(self, size):
-        return self._to_read.read(size)
-
-    def tell(self):
-        return self._to_read.tell()
-
-    def close(self):
-        self._closed = True
diff --git a/unit_tests/storage/test_bucket.py b/unit_tests/storage/test_bucket.py
deleted file mode 100644
index 258633c74ec7..000000000000
--- a/unit_tests/storage/test_bucket.py
+++ /dev/null
@@ -1,1039 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test__BlobIterator(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.bucket import _BlobIterator
-        return _BlobIterator
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket()
-        iterator = self._makeOne(bucket, client=client)
-        self.assertIs(iterator.bucket, bucket)
-        self.assertIs(iterator.client, client)
-        self.assertEqual(iterator.path, '%s/o' % bucket.path)
-        self.assertEqual(iterator.page_number, 0)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertEqual(iterator.prefixes, set())
-
-    def test_get_items_from_response_empty(self):
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket()
-        iterator = self._makeOne(bucket, client=client)
-        blobs = list(iterator.get_items_from_response({}))
-        self.assertEqual(blobs, [])
-        self.assertEqual(iterator.prefixes, set())
-
-    def test_get_items_from_response_non_empty(self):
-        from google.cloud.storage.blob import Blob
-        BLOB_NAME = 'blob-name'
-        response = {'items': [{'name': BLOB_NAME}], 'prefixes': ['foo']}
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket()
-        iterator = self._makeOne(bucket, client=client)
-        blobs = list(iterator.get_items_from_response(response))
-        self.assertEqual(len(blobs), 1)
-        blob = blobs[0]
-        self.assertIsInstance(blob, Blob)
-        self.assertEqual(blob.name, BLOB_NAME)
-        self.assertEqual(iterator.prefixes, set(['foo']))
-
-    def test_get_items_from_response_cumulative_prefixes(self):
-        from google.cloud.storage.blob import Blob
-        BLOB_NAME = 'blob-name1'
-        response1 = {'items': [{'name': BLOB_NAME}], 'prefixes': ['foo']}
-        response2 = {
-            'items': [],
-            'prefixes': ['foo', 'bar'],
-        }
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = _Bucket()
-        iterator = self._makeOne(bucket, client=client)
-        # Parse first response.
-        blobs = list(iterator.get_items_from_response(response1))
-        self.assertEqual(len(blobs), 1)
-        blob = blobs[0]
-        self.assertIsInstance(blob, Blob)
-        self.assertEqual(blob.name, BLOB_NAME)
-        self.assertEqual(iterator.prefixes, set(['foo']))
-        # Parse second response.
-        blobs = list(iterator.get_items_from_response(response2))
-        self.assertEqual(len(blobs), 0)
-        self.assertEqual(iterator.prefixes, set(['foo', 'bar']))
-
-
-class Test_Bucket(unittest.TestCase):
-
-    def _makeOne(self, client=None, name=None, properties=None):
-        from google.cloud.storage.bucket import Bucket
-        if client is None:
-            connection = _Connection()
-            client = _Client(connection)
-        bucket = Bucket(client, name=name)
-        bucket._properties = properties or {}
-        return bucket
-
-    def test_ctor(self):
-        NAME = 'name'
-        properties = {'key': 'value'}
-        bucket = self._makeOne(name=NAME, properties=properties)
-        self.assertEqual(bucket.name, NAME)
-        self.assertEqual(bucket._properties, properties)
-        self.assertFalse(bucket._acl.loaded)
-        self.assertIs(bucket._acl.bucket, bucket)
-        self.assertFalse(bucket._default_object_acl.loaded)
-        self.assertIs(bucket._default_object_acl.bucket, bucket)
-
-    def test_blob(self):
-        from google.cloud.storage.blob import Blob
-
-        BUCKET_NAME = 'BUCKET_NAME'
-        BLOB_NAME = 'BLOB_NAME'
-        CHUNK_SIZE = 1024 * 1024
-
-        bucket = self._makeOne(name=BUCKET_NAME)
-        blob = bucket.blob(BLOB_NAME, chunk_size=CHUNK_SIZE)
-        self.assertIsInstance(blob, Blob)
-        self.assertIs(blob.bucket, bucket)
-        self.assertIs(blob.client, bucket.client)
-        self.assertEqual(blob.name, BLOB_NAME)
-        self.assertEqual(blob.chunk_size, CHUNK_SIZE)
-
-    def test_exists_miss(self):
-        from google.cloud.exceptions import NotFound
-
-        class _FakeConnection(object):
-
-            _called_with = []
-
-            @classmethod
-            def api_request(cls, *args, **kwargs):
-                cls._called_with.append((args, kwargs))
-                raise NotFound(args)
-
-        BUCKET_NAME = 'bucket-name'
-        bucket = self._makeOne(name=BUCKET_NAME)
-        client = _Client(_FakeConnection)
-        self.assertFalse(bucket.exists(client=client))
-        expected_called_kwargs = {
-            'method': 'GET',
-            'path': bucket.path,
-            'query_params': {
-                'fields': 'name',
-            },
-            '_target_object': None,
-        }
-        expected_cw = [((), expected_called_kwargs)]
-        self.assertEqual(_FakeConnection._called_with, expected_cw)
-
-    def test_exists_hit(self):
-        class _FakeConnection(object):
-
-            _called_with = []
-
-            @classmethod
-            def api_request(cls, *args, **kwargs):
-                cls._called_with.append((args, kwargs))
-                # exists() does not use the return value
-                return object()
-
-        BUCKET_NAME = 'bucket-name'
-        bucket = self._makeOne(name=BUCKET_NAME)
-        client = _Client(_FakeConnection)
-        self.assertTrue(bucket.exists(client=client))
-        expected_called_kwargs = {
-            'method': 'GET',
-            'path': bucket.path,
-            'query_params': {
-                'fields': 'name',
-            },
-            '_target_object': None,
-        }
-        expected_cw = [((), expected_called_kwargs)]
-        self.assertEqual(_FakeConnection._called_with, expected_cw)
-
-    def test_create_hit(self):
-        BUCKET_NAME = 'bucket-name'
-        DATA = {'name': BUCKET_NAME}
-        connection = _Connection(DATA)
-        PROJECT = 'PROJECT'
-        client = _Client(connection, project=PROJECT)
-        bucket = self._makeOne(client=client, name=BUCKET_NAME)
-        bucket.create()
-
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'POST')
-        self.assertEqual(kw['path'], '/b')
-        self.assertEqual(kw['query_params'], {'project': PROJECT})
-        self.assertEqual(kw['data'], DATA)
-
-    def test_create_w_extra_properties(self):
-        BUCKET_NAME = 'bucket-name'
-        PROJECT = 'PROJECT'
-        CORS = [{
-            'maxAgeSeconds': 60,
-            'methods': ['*'],
-            'origin': ['https://example.com/frontend'],
-            'responseHeader': ['X-Custom-Header'],
-        }]
-        LIFECYCLE_RULES = [{
-            "action": {"type": "Delete"},
-            "condition": {"age": 365}
-        }]
-        LOCATION = 'eu'
-        STORAGE_CLASS = 'NEARLINE'
-        DATA = {
-            'name': BUCKET_NAME,
-            'cors': CORS,
-            'lifecycle': {'rule': LIFECYCLE_RULES},
-            'location': LOCATION,
-            'storageClass': STORAGE_CLASS,
-            'versioning': {'enabled': True},
-        }
-        connection = _Connection(DATA)
-        client = _Client(connection, project=PROJECT)
-        bucket = self._makeOne(client=client, name=BUCKET_NAME)
-        bucket.cors = CORS
-        bucket.lifecycle_rules = LIFECYCLE_RULES
-        bucket.location = LOCATION
-        bucket.storage_class = STORAGE_CLASS
-        bucket.versioning_enabled = True
-        bucket.create()
-
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'POST')
-        self.assertEqual(kw['path'], '/b')
-        self.assertEqual(kw['query_params'], {'project': PROJECT})
-        self.assertEqual(kw['data'], DATA)
-
-    def test_acl_property(self):
-        from google.cloud.storage.acl import BucketACL
-        bucket = self._makeOne()
-        acl = bucket.acl
-        self.assertIsInstance(acl, BucketACL)
-        self.assertIs(acl, bucket._acl)
-
-    def test_default_object_acl_property(self):
-        from google.cloud.storage.acl import DefaultObjectACL
-        bucket = self._makeOne()
-        acl = bucket.default_object_acl
-        self.assertIsInstance(acl, DefaultObjectACL)
-        self.assertIs(acl, bucket._default_object_acl)
-
-    def test_path_no_name(self):
-        bucket = self._makeOne()
-        self.assertRaises(ValueError, getattr, bucket, 'path')
-
-    def test_path_w_name(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        self.assertEqual(bucket.path, '/b/%s' % NAME)
-
-    def test_get_blob_miss(self):
-        NAME = 'name'
-        NONESUCH = 'nonesuch'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = self._makeOne(name=NAME)
-        result = bucket.get_blob(NONESUCH, client=client)
-        self.assertIsNone(result)
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], '/b/%s/o/%s' % (NAME, NONESUCH))
-
-    def test_get_blob_hit(self):
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        connection = _Connection({'name': BLOB_NAME})
-        client = _Client(connection)
-        bucket = self._makeOne(name=NAME)
-        blob = bucket.get_blob(BLOB_NAME, client=client)
-        self.assertIs(blob.bucket, bucket)
-        self.assertEqual(blob.name, BLOB_NAME)
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], '/b/%s/o/%s' % (NAME, BLOB_NAME))
-
-    def test_list_blobs_defaults(self):
-        NAME = 'name'
-        connection = _Connection({'items': []})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        iterator = bucket.list_blobs()
-        blobs = list(iterator)
-        self.assertEqual(blobs, [])
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], '/b/%s/o' % NAME)
-        self.assertEqual(kw['query_params'], {'projection': 'noAcl'})
-
-    def test_list_blobs_w_all_arguments(self):
-        NAME = 'name'
-        MAX_RESULTS = 10
-        PAGE_TOKEN = 'ABCD'
-        PREFIX = 'subfolder'
-        DELIMITER = '/'
-        VERSIONS = True
-        PROJECTION = 'full'
-        FIELDS = 'items/contentLanguage,nextPageToken'
-        EXPECTED = {
-            'maxResults': 10,
-            'pageToken': PAGE_TOKEN,
-            'prefix': PREFIX,
-            'delimiter': DELIMITER,
-            'versions': VERSIONS,
-            'projection': PROJECTION,
-            'fields': FIELDS,
-        }
-        connection = _Connection({'items': []})
-        client = _Client(connection)
-        bucket = self._makeOne(name=NAME)
-        iterator = bucket.list_blobs(
-            max_results=MAX_RESULTS,
-            page_token=PAGE_TOKEN,
-            prefix=PREFIX,
-            delimiter=DELIMITER,
-            versions=VERSIONS,
-            projection=PROJECTION,
-            fields=FIELDS,
-            client=client,
-        )
-        blobs = list(iterator)
-        self.assertEqual(blobs, [])
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], '/b/%s/o' % NAME)
-        self.assertEqual(kw['query_params'], EXPECTED)
-
-    def test_list_blobs(self):
-        NAME = 'name'
-        connection = _Connection({'items': []})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        iterator = bucket.list_blobs()
-        blobs = list(iterator)
-        self.assertEqual(blobs, [])
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], '/b/%s/o' % NAME)
-        self.assertEqual(kw['query_params'], {'projection': 'noAcl'})
-
-    def test_delete_miss(self):
-        from google.cloud.exceptions import NotFound
-        NAME = 'name'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        self.assertRaises(NotFound, bucket.delete)
-        expected_cw = [{
-            'method': 'DELETE',
-            'path': bucket.path,
-            '_target_object': None,
-        }]
-        self.assertEqual(connection._deleted_buckets, expected_cw)
-
-    def test_delete_hit(self):
-        NAME = 'name'
-        GET_BLOBS_RESP = {'items': []}
-        connection = _Connection(GET_BLOBS_RESP)
-        connection._delete_bucket = True
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        result = bucket.delete(force=True)
-        self.assertIsNone(result)
-        expected_cw = [{
-            'method': 'DELETE',
-            'path': bucket.path,
-            '_target_object': None,
-        }]
-        self.assertEqual(connection._deleted_buckets, expected_cw)
-
-    def test_delete_force_delete_blobs(self):
-        NAME = 'name'
-        BLOB_NAME1 = 'blob-name1'
-        BLOB_NAME2 = 'blob-name2'
-        GET_BLOBS_RESP = {
-            'items': [
-                {'name': BLOB_NAME1},
-                {'name': BLOB_NAME2},
-            ],
-        }
-        DELETE_BLOB1_RESP = DELETE_BLOB2_RESP = {}
-        connection = _Connection(GET_BLOBS_RESP, DELETE_BLOB1_RESP,
-                                 DELETE_BLOB2_RESP)
-        connection._delete_bucket = True
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        result = bucket.delete(force=True)
-        self.assertIsNone(result)
-        expected_cw = [{
-            'method': 'DELETE',
-            'path': bucket.path,
-            '_target_object': None,
-        }]
-        self.assertEqual(connection._deleted_buckets, expected_cw)
-
-    def test_delete_force_miss_blobs(self):
-        NAME = 'name'
-        BLOB_NAME = 'blob-name1'
-        GET_BLOBS_RESP = {'items': [{'name': BLOB_NAME}]}
-        # Note the connection does not have a response for the blob.
-        connection = _Connection(GET_BLOBS_RESP)
-        connection._delete_bucket = True
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        result = bucket.delete(force=True)
-        self.assertIsNone(result)
-        expected_cw = [{
-            'method': 'DELETE',
-            'path': bucket.path,
-            '_target_object': None,
-        }]
-        self.assertEqual(connection._deleted_buckets, expected_cw)
-
-    def test_delete_too_many(self):
-        NAME = 'name'
-        BLOB_NAME1 = 'blob-name1'
-        BLOB_NAME2 = 'blob-name2'
-        GET_BLOBS_RESP = {
-            'items': [
-                {'name': BLOB_NAME1},
-                {'name': BLOB_NAME2},
-            ],
-        }
-        connection = _Connection(GET_BLOBS_RESP)
-        connection._delete_bucket = True
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-
-        # Make the Bucket refuse to delete with 2 objects.
-        bucket._MAX_OBJECTS_FOR_ITERATION = 1
-        self.assertRaises(ValueError, bucket.delete, force=True)
-        self.assertEqual(connection._deleted_buckets, [])
-
-    def test_delete_blob_miss(self):
-        from google.cloud.exceptions import NotFound
-        NAME = 'name'
-        NONESUCH = 'nonesuch'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        self.assertRaises(NotFound, bucket.delete_blob, NONESUCH)
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'DELETE')
-        self.assertEqual(kw['path'], '/b/%s/o/%s' % (NAME, NONESUCH))
-
-    def test_delete_blob_hit(self):
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        connection = _Connection({})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        result = bucket.delete_blob(BLOB_NAME)
-        self.assertIsNone(result)
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'DELETE')
-        self.assertEqual(kw['path'], '/b/%s/o/%s' % (NAME, BLOB_NAME))
-
-    def test_delete_blobs_empty(self):
-        NAME = 'name'
-        connection = _Connection()
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        bucket.delete_blobs([])
-        self.assertEqual(connection._requested, [])
-
-    def test_delete_blobs_hit(self):
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        connection = _Connection({})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        bucket.delete_blobs([BLOB_NAME])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'DELETE')
-        self.assertEqual(kw[0]['path'], '/b/%s/o/%s' % (NAME, BLOB_NAME))
-
-    def test_delete_blobs_miss_no_on_error(self):
-        from google.cloud.exceptions import NotFound
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        NONESUCH = 'nonesuch'
-        connection = _Connection({})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        self.assertRaises(NotFound, bucket.delete_blobs, [BLOB_NAME, NONESUCH])
-        kw = connection._requested
-        self.assertEqual(len(kw), 2)
-        self.assertEqual(kw[0]['method'], 'DELETE')
-        self.assertEqual(kw[0]['path'], '/b/%s/o/%s' % (NAME, BLOB_NAME))
-        self.assertEqual(kw[1]['method'], 'DELETE')
-        self.assertEqual(kw[1]['path'], '/b/%s/o/%s' % (NAME, NONESUCH))
-
-    def test_delete_blobs_miss_w_on_error(self):
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        NONESUCH = 'nonesuch'
-        connection = _Connection({})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        errors = []
-        bucket.delete_blobs([BLOB_NAME, NONESUCH], errors.append)
-        self.assertEqual(errors, [NONESUCH])
-        kw = connection._requested
-        self.assertEqual(len(kw), 2)
-        self.assertEqual(kw[0]['method'], 'DELETE')
-        self.assertEqual(kw[0]['path'], '/b/%s/o/%s' % (NAME, BLOB_NAME))
-        self.assertEqual(kw[1]['method'], 'DELETE')
-        self.assertEqual(kw[1]['path'], '/b/%s/o/%s' % (NAME, NONESUCH))
-
-    def test_copy_blobs_wo_name(self):
-        SOURCE = 'source'
-        DEST = 'dest'
-        BLOB_NAME = 'blob-name'
-
-        class _Blob(object):
-            name = BLOB_NAME
-            path = '/b/%s/o/%s' % (SOURCE, BLOB_NAME)
-
-        connection = _Connection({})
-        client = _Client(connection)
-        source = self._makeOne(client=client, name=SOURCE)
-        dest = self._makeOne(client=client, name=DEST)
-        blob = _Blob()
-        new_blob = source.copy_blob(blob, dest)
-        self.assertIs(new_blob.bucket, dest)
-        self.assertEqual(new_blob.name, BLOB_NAME)
-        kw, = connection._requested
-        COPY_PATH = '/b/%s/o/%s/copyTo/b/%s/o/%s' % (SOURCE, BLOB_NAME,
-                                                     DEST, BLOB_NAME)
-        self.assertEqual(kw['method'], 'POST')
-        self.assertEqual(kw['path'], COPY_PATH)
-
-    def test_copy_blobs_w_name(self):
-        SOURCE = 'source'
-        DEST = 'dest'
-        BLOB_NAME = 'blob-name'
-        NEW_NAME = 'new_name'
-
-        class _Blob(object):
-            name = BLOB_NAME
-            path = '/b/%s/o/%s' % (SOURCE, BLOB_NAME)
-
-        connection = _Connection({})
-        client = _Client(connection)
-        source = self._makeOne(client=client, name=SOURCE)
-        dest = self._makeOne(client=client, name=DEST)
-        blob = _Blob()
-        new_blob = source.copy_blob(blob, dest, NEW_NAME)
-        self.assertIs(new_blob.bucket, dest)
-        self.assertEqual(new_blob.name, NEW_NAME)
-        kw, = connection._requested
-        COPY_PATH = '/b/%s/o/%s/copyTo/b/%s/o/%s' % (SOURCE, BLOB_NAME,
-                                                     DEST, NEW_NAME)
-        self.assertEqual(kw['method'], 'POST')
-        self.assertEqual(kw['path'], COPY_PATH)
-
-    def test_rename_blob(self):
-        BUCKET_NAME = 'BUCKET_NAME'
-        BLOB_NAME = 'blob-name'
-        NEW_BLOB_NAME = 'new-blob-name'
-
-        DATA = {'name': NEW_BLOB_NAME}
-        connection = _Connection(DATA)
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=BUCKET_NAME)
-
-        class _Blob(object):
-
-            def __init__(self, name, bucket_name):
-                self.name = name
-                self.path = '/b/%s/o/%s' % (bucket_name, name)
-                self._deleted = []
-
-            def delete(self, client=None):
-                self._deleted.append(client)
-
-        blob = _Blob(BLOB_NAME, BUCKET_NAME)
-        renamed_blob = bucket.rename_blob(blob, NEW_BLOB_NAME, client=client)
-        self.assertIs(renamed_blob.bucket, bucket)
-        self.assertEqual(renamed_blob.name, NEW_BLOB_NAME)
-        self.assertEqual(blob._deleted, [client])
-
-    def test_etag(self):
-        ETAG = 'ETAG'
-        properties = {'etag': ETAG}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.etag, ETAG)
-
-    def test_id(self):
-        ID = 'ID'
-        properties = {'id': ID}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.id, ID)
-
-    def test_location_getter(self):
-        NAME = 'name'
-        before = {'location': 'AS'}
-        bucket = self._makeOne(name=NAME, properties=before)
-        self.assertEqual(bucket.location, 'AS')
-
-    def test_location_setter(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        self.assertIsNone(bucket.location)
-        bucket.location = 'AS'
-        self.assertEqual(bucket.location, 'AS')
-        self.assertTrue('location' in bucket._changes)
-
-    def test_lifecycle_rules_getter(self):
-        NAME = 'name'
-        LC_RULE = {'action': {'type': 'Delete'}, 'condition': {'age': 42}}
-        rules = [LC_RULE]
-        properties = {'lifecycle': {'rule': rules}}
-        bucket = self._makeOne(name=NAME, properties=properties)
-        self.assertEqual(bucket.lifecycle_rules, rules)
-        # Make sure it's a copy
-        self.assertIsNot(bucket.lifecycle_rules, rules)
-
-    def test_lifecycle_rules_setter(self):
-        NAME = 'name'
-        LC_RULE = {'action': {'type': 'Delete'}, 'condition': {'age': 42}}
-        rules = [LC_RULE]
-        bucket = self._makeOne(name=NAME)
-        self.assertEqual(bucket.lifecycle_rules, [])
-        bucket.lifecycle_rules = rules
-        self.assertEqual(bucket.lifecycle_rules, rules)
-        self.assertTrue('lifecycle' in bucket._changes)
-
-    def test_cors_getter(self):
-        NAME = 'name'
-        CORS_ENTRY = {
-            'maxAgeSeconds': 1234,
-            'method': ['OPTIONS', 'GET'],
-            'origin': ['127.0.0.1'],
-            'responseHeader': ['Content-Type'],
-        }
-        properties = {'cors': [CORS_ENTRY, {}]}
-        bucket = self._makeOne(name=NAME, properties=properties)
-        entries = bucket.cors
-        self.assertEqual(len(entries), 2)
-        self.assertEqual(entries[0], CORS_ENTRY)
-        self.assertEqual(entries[1], {})
-        # Make sure it was a copy, not the same object.
-        self.assertIsNot(entries[0], CORS_ENTRY)
-
-    def test_cors_setter(self):
-        NAME = 'name'
-        CORS_ENTRY = {
-            'maxAgeSeconds': 1234,
-            'method': ['OPTIONS', 'GET'],
-            'origin': ['127.0.0.1'],
-            'responseHeader': ['Content-Type'],
-        }
-        bucket = self._makeOne(name=NAME)
-
-        self.assertEqual(bucket.cors, [])
-        bucket.cors = [CORS_ENTRY]
-        self.assertEqual(bucket.cors, [CORS_ENTRY])
-        self.assertTrue('cors' in bucket._changes)
-
-    def test_get_logging_w_prefix(self):
-        NAME = 'name'
-        LOG_BUCKET = 'logs'
-        LOG_PREFIX = 'pfx'
-        before = {
-            'logging': {
-                'logBucket': LOG_BUCKET,
-                'logObjectPrefix': LOG_PREFIX,
-            },
-        }
-        bucket = self._makeOne(name=NAME, properties=before)
-        info = bucket.get_logging()
-        self.assertEqual(info['logBucket'], LOG_BUCKET)
-        self.assertEqual(info['logObjectPrefix'], LOG_PREFIX)
-
-    def test_enable_logging_defaults(self):
-        NAME = 'name'
-        LOG_BUCKET = 'logs'
-        before = {'logging': None}
-        bucket = self._makeOne(name=NAME, properties=before)
-        self.assertIsNone(bucket.get_logging())
-        bucket.enable_logging(LOG_BUCKET)
-        info = bucket.get_logging()
-        self.assertEqual(info['logBucket'], LOG_BUCKET)
-        self.assertEqual(info['logObjectPrefix'], '')
-
-    def test_enable_logging(self):
-        NAME = 'name'
-        LOG_BUCKET = 'logs'
-        LOG_PFX = 'pfx'
-        before = {'logging': None}
-        bucket = self._makeOne(name=NAME, properties=before)
-        self.assertIsNone(bucket.get_logging())
-        bucket.enable_logging(LOG_BUCKET, LOG_PFX)
-        info = bucket.get_logging()
-        self.assertEqual(info['logBucket'], LOG_BUCKET)
-        self.assertEqual(info['logObjectPrefix'], LOG_PFX)
-
-    def test_disable_logging(self):
-        NAME = 'name'
-        before = {'logging': {'logBucket': 'logs', 'logObjectPrefix': 'pfx'}}
-        bucket = self._makeOne(name=NAME, properties=before)
-        self.assertIsNotNone(bucket.get_logging())
-        bucket.disable_logging()
-        self.assertIsNone(bucket.get_logging())
-
-    def test_metageneration(self):
-        METAGENERATION = 42
-        properties = {'metageneration': METAGENERATION}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.metageneration, METAGENERATION)
-
-    def test_metageneration_unset(self):
-        bucket = self._makeOne()
-        self.assertIsNone(bucket.metageneration)
-
-    def test_metageneration_string_val(self):
-        METAGENERATION = 42
-        properties = {'metageneration': str(METAGENERATION)}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.metageneration, METAGENERATION)
-
-    def test_owner(self):
-        OWNER = {'entity': 'project-owner-12345', 'entityId': '23456'}
-        properties = {'owner': OWNER}
-        bucket = self._makeOne(properties=properties)
-        owner = bucket.owner
-        self.assertEqual(owner['entity'], 'project-owner-12345')
-        self.assertEqual(owner['entityId'], '23456')
-
-    def test_project_number(self):
-        PROJECT_NUMBER = 12345
-        properties = {'projectNumber': PROJECT_NUMBER}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.project_number, PROJECT_NUMBER)
-
-    def test_project_number_unset(self):
-        bucket = self._makeOne()
-        self.assertIsNone(bucket.project_number)
-
-    def test_project_number_string_val(self):
-        PROJECT_NUMBER = 12345
-        properties = {'projectNumber': str(PROJECT_NUMBER)}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.project_number, PROJECT_NUMBER)
-
-    def test_self_link(self):
-        SELF_LINK = 'http://example.com/self/'
-        properties = {'selfLink': SELF_LINK}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.self_link, SELF_LINK)
-
-    def test_storage_class_getter(self):
-        STORAGE_CLASS = 'http://example.com/self/'
-        properties = {'storageClass': STORAGE_CLASS}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.storage_class, STORAGE_CLASS)
-
-    def test_storage_class_setter_invalid(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        with self.assertRaises(ValueError):
-            bucket.storage_class = 'BOGUS'
-        self.assertFalse('storageClass' in bucket._changes)
-
-    def test_storage_class_setter_STANDARD(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        bucket.storage_class = 'STANDARD'
-        self.assertEqual(bucket.storage_class, 'STANDARD')
-        self.assertTrue('storageClass' in bucket._changes)
-
-    def test_storage_class_setter_NEARLINE(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        bucket.storage_class = 'NEARLINE'
-        self.assertEqual(bucket.storage_class, 'NEARLINE')
-        self.assertTrue('storageClass' in bucket._changes)
-
-    def test_storage_class_setter_DURABLE_REDUCED_AVAILABILITY(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        bucket.storage_class = 'DURABLE_REDUCED_AVAILABILITY'
-        self.assertEqual(bucket.storage_class, 'DURABLE_REDUCED_AVAILABILITY')
-        self.assertTrue('storageClass' in bucket._changes)
-
-    def test_time_created(self):
-        import datetime
-        from google.cloud._helpers import _RFC3339_MICROS
-        from google.cloud._helpers import UTC
-        TIMESTAMP = datetime.datetime(2014, 11, 5, 20, 34, 37, tzinfo=UTC)
-        TIME_CREATED = TIMESTAMP.strftime(_RFC3339_MICROS)
-        properties = {'timeCreated': TIME_CREATED}
-        bucket = self._makeOne(properties=properties)
-        self.assertEqual(bucket.time_created, TIMESTAMP)
-
-    def test_time_created_unset(self):
-        bucket = self._makeOne()
-        self.assertIsNone(bucket.time_created)
-
-    def test_versioning_enabled_getter_missing(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        self.assertEqual(bucket.versioning_enabled, False)
-
-    def test_versioning_enabled_getter(self):
-        NAME = 'name'
-        before = {'versioning': {'enabled': True}}
-        bucket = self._makeOne(name=NAME, properties=before)
-        self.assertEqual(bucket.versioning_enabled, True)
-
-    def test_versioning_enabled_setter(self):
-        NAME = 'name'
-        bucket = self._makeOne(name=NAME)
-        self.assertFalse(bucket.versioning_enabled)
-        bucket.versioning_enabled = True
-        self.assertTrue(bucket.versioning_enabled)
-
-    def test_configure_website_defaults(self):
-        NAME = 'name'
-        UNSET = {'website': {'mainPageSuffix': None,
-                             'notFoundPage': None}}
-        bucket = self._makeOne(name=NAME)
-        bucket.configure_website()
-        self.assertEqual(bucket._properties, UNSET)
-
-    def test_configure_website(self):
-        NAME = 'name'
-        WEBSITE_VAL = {'website': {'mainPageSuffix': 'html',
-                                   'notFoundPage': '404.html'}}
-        bucket = self._makeOne(name=NAME)
-        bucket.configure_website('html', '404.html')
-        self.assertEqual(bucket._properties, WEBSITE_VAL)
-
-    def test_disable_website(self):
-        NAME = 'name'
-        UNSET = {'website': {'mainPageSuffix': None,
-                             'notFoundPage': None}}
-        bucket = self._makeOne(name=NAME)
-        bucket.disable_website()
-        self.assertEqual(bucket._properties, UNSET)
-
-    def test_make_public_defaults(self):
-        from google.cloud.storage.acl import _ACLEntity
-        NAME = 'name'
-        permissive = [{'entity': 'allUsers', 'role': _ACLEntity.READER_ROLE}]
-        after = {'acl': permissive, 'defaultObjectAcl': []}
-        connection = _Connection(after)
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        bucket.acl.loaded = True
-        bucket.default_object_acl.loaded = True
-        bucket.make_public()
-        self.assertEqual(list(bucket.acl), permissive)
-        self.assertEqual(list(bucket.default_object_acl), [])
-        kw = connection._requested
-        self.assertEqual(len(kw), 1)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/b/%s' % NAME)
-        self.assertEqual(kw[0]['data'], {'acl': after['acl']})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-
-    def _make_public_w_future_helper(self, default_object_acl_loaded=True):
-        from google.cloud.storage.acl import _ACLEntity
-        NAME = 'name'
-        permissive = [{'entity': 'allUsers', 'role': _ACLEntity.READER_ROLE}]
-        after1 = {'acl': permissive, 'defaultObjectAcl': []}
-        after2 = {'acl': permissive, 'defaultObjectAcl': permissive}
-        if default_object_acl_loaded:
-            num_requests = 2
-            connection = _Connection(after1, after2)
-        else:
-            num_requests = 3
-            # We return the same value for default_object_acl.reload()
-            # to consume.
-            connection = _Connection(after1, after1, after2)
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        bucket.acl.loaded = True
-        bucket.default_object_acl.loaded = default_object_acl_loaded
-        bucket.make_public(future=True)
-        self.assertEqual(list(bucket.acl), permissive)
-        self.assertEqual(list(bucket.default_object_acl), permissive)
-        kw = connection._requested
-        self.assertEqual(len(kw), num_requests)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/b/%s' % NAME)
-        self.assertEqual(kw[0]['data'], {'acl': permissive})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-        if not default_object_acl_loaded:
-            self.assertEqual(kw[1]['method'], 'GET')
-            self.assertEqual(kw[1]['path'], '/b/%s/defaultObjectAcl' % NAME)
-        # Last could be 1 or 2 depending on `default_object_acl_loaded`.
-        self.assertEqual(kw[-1]['method'], 'PATCH')
-        self.assertEqual(kw[-1]['path'], '/b/%s' % NAME)
-        self.assertEqual(kw[-1]['data'], {'defaultObjectAcl': permissive})
-        self.assertEqual(kw[-1]['query_params'], {'projection': 'full'})
-
-    def test_make_public_w_future(self):
-        self._make_public_w_future_helper(default_object_acl_loaded=True)
-
-    def test_make_public_w_future_reload_default(self):
-        self._make_public_w_future_helper(default_object_acl_loaded=False)
-
-    def test_make_public_recursive(self):
-        from google.cloud.storage.acl import _ACLEntity
-        from google.cloud.storage.bucket import _BlobIterator
-        _saved = []
-
-        class _Blob(object):
-            _granted = False
-
-            def __init__(self, bucket, name):
-                self._bucket = bucket
-                self._name = name
-
-            @property
-            def acl(self):
-                return self
-
-            # Faux ACL methods
-            def all(self):
-                return self
-
-            def grant_read(self):
-                self._granted = True
-
-            def save(self, client=None):
-                _saved.append(
-                    (self._bucket, self._name, self._granted, client))
-
-        class _Iterator(_BlobIterator):
-            def get_items_from_response(self, response):
-                for item in response.get('items', []):
-                    yield _Blob(self.bucket, item['name'])
-
-        NAME = 'name'
-        BLOB_NAME = 'blob-name'
-        permissive = [{'entity': 'allUsers', 'role': _ACLEntity.READER_ROLE}]
-        after = {'acl': permissive, 'defaultObjectAcl': []}
-        connection = _Connection(after, {'items': [{'name': BLOB_NAME}]})
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        bucket.acl.loaded = True
-        bucket.default_object_acl.loaded = True
-        bucket._iterator_class = _Iterator
-        bucket.make_public(recursive=True)
-        self.assertEqual(list(bucket.acl), permissive)
-        self.assertEqual(list(bucket.default_object_acl), [])
-        self.assertEqual(_saved, [(bucket, BLOB_NAME, True, None)])
-        kw = connection._requested
-        self.assertEqual(len(kw), 2)
-        self.assertEqual(kw[0]['method'], 'PATCH')
-        self.assertEqual(kw[0]['path'], '/b/%s' % NAME)
-        self.assertEqual(kw[0]['data'], {'acl': permissive})
-        self.assertEqual(kw[0]['query_params'], {'projection': 'full'})
-        self.assertEqual(kw[1]['method'], 'GET')
-        self.assertEqual(kw[1]['path'], '/b/%s/o' % NAME)
-        max_results = bucket._MAX_OBJECTS_FOR_ITERATION + 1
-        self.assertEqual(kw[1]['query_params'],
-                         {'maxResults': max_results, 'projection': 'full'})
-
-    def test_make_public_recursive_too_many(self):
-        from google.cloud.storage.acl import _ACLEntity
-
-        PERMISSIVE = [{'entity': 'allUsers', 'role': _ACLEntity.READER_ROLE}]
-        AFTER = {'acl': PERMISSIVE, 'defaultObjectAcl': []}
-
-        NAME = 'name'
-        BLOB_NAME1 = 'blob-name1'
-        BLOB_NAME2 = 'blob-name2'
-        GET_BLOBS_RESP = {
-            'items': [
-                {'name': BLOB_NAME1},
-                {'name': BLOB_NAME2},
-            ],
-        }
-        connection = _Connection(AFTER, GET_BLOBS_RESP)
-        client = _Client(connection)
-        bucket = self._makeOne(client=client, name=NAME)
-        bucket.acl.loaded = True
-        bucket.default_object_acl.loaded = True
-
-        # Make the Bucket refuse to make_public with 2 objects.
-        bucket._MAX_OBJECTS_FOR_ITERATION = 1
-        self.assertRaises(ValueError, bucket.make_public, recursive=True)
-
-
-class _Connection(object):
-    _delete_bucket = False
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-        self._deleted_buckets = []
-
-    @staticmethod
-    def _is_bucket_path(path):
-        # Now just ensure the path only has /b/ and one more segment.
-        return path.startswith('/b/') and path.count('/') == 2
-
-    def api_request(self, **kw):
-        from google.cloud.exceptions import NotFound
-        self._requested.append(kw)
-
-        method = kw.get('method')
-        path = kw.get('path', '')
-        if method == 'DELETE' and self._is_bucket_path(path):
-            self._deleted_buckets.append(kw)
-            if self._delete_bucket:
-                return
-            else:
-                raise NotFound('miss')
-
-        try:
-            response, self._responses = self._responses[0], self._responses[1:]
-        except:
-            raise NotFound('miss')
-        else:
-            return response
-
-
-class _Bucket(object):
-    path = '/b/name'
-    name = 'name'
-
-    def __init__(self, client=None):
-        self.client = client
-
-
-class _Client(object):
-
-    def __init__(self, connection, project=None):
-        self.connection = connection
-        self.project = project
diff --git a/unit_tests/storage/test_client.py b/unit_tests/storage/test_client.py
deleted file mode 100644
index d8a0d466166c..000000000000
--- a/unit_tests/storage/test_client.py
+++ /dev/null
@@ -1,441 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_connection_type(self):
-        from google.cloud.storage.connection import Connection
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        self.assertEqual(client.project, PROJECT)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertIs(client.connection.credentials, CREDENTIALS)
-        self.assertIsNone(client.current_batch)
-        self.assertEqual(list(client._batch_stack), [])
-
-    def test__push_batch_and__pop_batch(self):
-        from google.cloud.storage.batch import Batch
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        batch1 = Batch(client)
-        batch2 = Batch(client)
-        client._push_batch(batch1)
-        self.assertEqual(list(client._batch_stack), [batch1])
-        self.assertIs(client.current_batch, batch1)
-        client._push_batch(batch2)
-        self.assertIs(client.current_batch, batch2)
-        # list(_LocalStack) returns in reverse order.
-        self.assertEqual(list(client._batch_stack), [batch2, batch1])
-        self.assertIs(client._pop_batch(), batch2)
-        self.assertEqual(list(client._batch_stack), [batch1])
-        self.assertIs(client._pop_batch(), batch1)
-        self.assertEqual(list(client._batch_stack), [])
-
-    def test_connection_setter(self):
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        client._connection = None  # Unset the value from the constructor
-        client.connection = connection = object()
-        self.assertIs(client._connection, connection)
-
-    def test_connection_setter_when_set(self):
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        self.assertRaises(ValueError, setattr, client, 'connection', None)
-
-    def test_connection_getter_no_batch(self):
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        self.assertIs(client.connection, client._connection)
-        self.assertIsNone(client.current_batch)
-
-    def test_connection_getter_with_batch(self):
-        from google.cloud.storage.batch import Batch
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        batch = Batch(client)
-        client._push_batch(batch)
-        self.assertIsNot(client.connection, client._connection)
-        self.assertIs(client.connection, batch)
-        self.assertIs(client.current_batch, batch)
-
-    def test_bucket(self):
-        from google.cloud.storage.bucket import Bucket
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        BUCKET_NAME = 'BUCKET_NAME'
-
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        bucket = client.bucket(BUCKET_NAME)
-        self.assertIsInstance(bucket, Bucket)
-        self.assertIs(bucket.client, client)
-        self.assertEqual(bucket.name, BUCKET_NAME)
-
-    def test_batch(self):
-        from google.cloud.storage.batch import Batch
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-        batch = client.batch()
-        self.assertIsInstance(batch, Batch)
-        self.assertIs(batch._client, client)
-
-    def test_get_bucket_miss(self):
-        from google.cloud.exceptions import NotFound
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        NONESUCH = 'nonesuch'
-        URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b',
-            'nonesuch?projection=noAcl',
-        ])
-        http = client.connection._http = _Http(
-            {'status': '404', 'content-type': 'application/json'},
-            b'{}',
-        )
-        self.assertRaises(NotFound, client.get_bucket, NONESUCH)
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-
-    def test_get_bucket_hit(self):
-        from google.cloud.storage.bucket import Bucket
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        BLOB_NAME = 'blob-name'
-        URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b',
-            '%s?projection=noAcl' % (BLOB_NAME,),
-        ])
-        http = client.connection._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            '{{"name": "{0}"}}'.format(BLOB_NAME).encode('utf-8'),
-        )
-
-        bucket = client.get_bucket(BLOB_NAME)
-        self.assertIsInstance(bucket, Bucket)
-        self.assertEqual(bucket.name, BLOB_NAME)
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-
-    def test_lookup_bucket_miss(self):
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        NONESUCH = 'nonesuch'
-        URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b',
-            'nonesuch?projection=noAcl',
-        ])
-        http = client.connection._http = _Http(
-            {'status': '404', 'content-type': 'application/json'},
-            b'{}',
-        )
-        bucket = client.lookup_bucket(NONESUCH)
-        self.assertIsNone(bucket)
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-
-    def test_lookup_bucket_hit(self):
-        from google.cloud.storage.bucket import Bucket
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        BLOB_NAME = 'blob-name'
-        URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b',
-            '%s?projection=noAcl' % (BLOB_NAME,),
-        ])
-        http = client.connection._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            '{{"name": "{0}"}}'.format(BLOB_NAME).encode('utf-8'),
-        )
-
-        bucket = client.lookup_bucket(BLOB_NAME)
-        self.assertIsInstance(bucket, Bucket)
-        self.assertEqual(bucket.name, BLOB_NAME)
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-
-    def test_create_bucket_conflict(self):
-        from google.cloud.exceptions import Conflict
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        BLOB_NAME = 'blob-name'
-        URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b?project=%s' % (PROJECT,),
-        ])
-        http = client.connection._http = _Http(
-            {'status': '409', 'content-type': 'application/json'},
-            '{"error": {"message": "Conflict"}}',
-        )
-
-        self.assertRaises(Conflict, client.create_bucket, BLOB_NAME)
-        self.assertEqual(http._called_with['method'], 'POST')
-        self.assertEqual(http._called_with['uri'], URI)
-
-    def test_create_bucket_success(self):
-        from google.cloud.storage.bucket import Bucket
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        BLOB_NAME = 'blob-name'
-        URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b?project=%s' % (PROJECT,),
-        ])
-        http = client.connection._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            '{{"name": "{0}"}}'.format(BLOB_NAME).encode('utf-8'),
-        )
-
-        bucket = client.create_bucket(BLOB_NAME)
-        self.assertIsInstance(bucket, Bucket)
-        self.assertEqual(bucket.name, BLOB_NAME)
-        self.assertEqual(http._called_with['method'], 'POST')
-        self.assertEqual(http._called_with['uri'], URI)
-
-    def test_list_buckets_empty(self):
-        from six.moves.urllib.parse import parse_qs
-        from six.moves.urllib.parse import urlparse
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        EXPECTED_QUERY = {
-            'project': [PROJECT],
-            'projection': ['noAcl'],
-        }
-        http = client.connection._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            b'{}',
-        )
-        buckets = list(client.list_buckets())
-        self.assertEqual(len(buckets), 0)
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertIsNone(http._called_with['body'])
-
-        BASE_URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b',
-        ])
-        URI = http._called_with['uri']
-        self.assertTrue(URI.startswith(BASE_URI))
-        uri_parts = urlparse(URI)
-        self.assertEqual(parse_qs(uri_parts.query), EXPECTED_QUERY)
-
-    def test_list_buckets_non_empty(self):
-        from six.moves.urllib.parse import parse_qs
-        from six.moves.urllib.parse import urlencode
-        from six.moves.urllib.parse import urlparse
-        PROJECT = 'PROJECT'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        BUCKET_NAME = 'bucket-name'
-        query_params = urlencode({'project': PROJECT, 'projection': 'noAcl'})
-        BASE_URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-        ])
-        URI = '/'.join([BASE_URI, 'b?%s' % (query_params,)])
-        http = client.connection._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            '{{"items": [{{"name": "{0}"}}]}}'.format(BUCKET_NAME)
-            .encode('utf-8'),
-        )
-        buckets = list(client.list_buckets())
-        self.assertEqual(len(buckets), 1)
-        self.assertEqual(buckets[0].name, BUCKET_NAME)
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertTrue(http._called_with['uri'].startswith(BASE_URI))
-        self.assertEqual(parse_qs(urlparse(http._called_with['uri']).query),
-                         parse_qs(urlparse(URI).query))
-
-    def test_list_buckets_all_arguments(self):
-        from six.moves.urllib.parse import parse_qs
-        from six.moves.urllib.parse import urlparse
-
-        PROJECT = 'foo-bar'
-        CREDENTIALS = _Credentials()
-        client = self._makeOne(project=PROJECT, credentials=CREDENTIALS)
-
-        MAX_RESULTS = 10
-        PAGE_TOKEN = 'ABCD'
-        PREFIX = 'subfolder'
-        PROJECTION = 'full'
-        FIELDS = 'items/id,nextPageToken'
-        EXPECTED_QUERY = {
-            'project': [PROJECT],
-            'maxResults': [str(MAX_RESULTS)],
-            'pageToken': [PAGE_TOKEN],
-            'prefix': [PREFIX],
-            'projection': [PROJECTION],
-            'fields': [FIELDS],
-        }
-
-        http = client.connection._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            '{"items": []}',
-        )
-        iterator = client.list_buckets(
-            max_results=MAX_RESULTS,
-            page_token=PAGE_TOKEN,
-            prefix=PREFIX,
-            projection=PROJECTION,
-            fields=FIELDS,
-        )
-        buckets = list(iterator)
-        self.assertEqual(buckets, [])
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertIsNone(http._called_with['body'])
-
-        BASE_URI = '/'.join([
-            client.connection.API_BASE_URL,
-            'storage',
-            client.connection.API_VERSION,
-            'b'
-        ])
-        URI = http._called_with['uri']
-        self.assertTrue(URI.startswith(BASE_URI))
-        uri_parts = urlparse(URI)
-        self.assertEqual(parse_qs(uri_parts.query), EXPECTED_QUERY)
-
-
-class Test__BucketIterator(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.client import _BucketIterator
-        return _BucketIterator
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = object()
-        client = _Client(connection)
-        iterator = self._makeOne(client)
-        self.assertEqual(iterator.path, '/b')
-        self.assertEqual(iterator.page_number, 0)
-        self.assertIsNone(iterator.next_page_token)
-        self.assertIs(iterator.client, client)
-
-    def test_get_items_from_response_empty(self):
-        connection = object()
-        client = _Client(connection)
-        iterator = self._makeOne(client)
-        self.assertEqual(list(iterator.get_items_from_response({})), [])
-
-    def test_get_items_from_response_non_empty(self):
-        from google.cloud.storage.bucket import Bucket
-        BLOB_NAME = 'blob-name'
-        response = {'items': [{'name': BLOB_NAME}]}
-        connection = object()
-        client = _Client(connection)
-        iterator = self._makeOne(client)
-        buckets = list(iterator.get_items_from_response(response))
-        self.assertEqual(len(buckets), 1)
-        bucket = buckets[0]
-        self.assertIsInstance(bucket, Bucket)
-        self.assertEqual(bucket.name, BLOB_NAME)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Http(object):
-
-    _called_with = None
-
-    def __init__(self, headers, content):
-        from httplib2 import Response
-        self._response = Response(headers)
-        self._content = content
-
-    def request(self, **kw):
-        self._called_with = kw
-        return self._response, self._content
-
-
-class _Client(object):
-
-    def __init__(self, connection):
-        self.connection = connection
diff --git a/unit_tests/storage/test_connection.py b/unit_tests/storage/test_connection.py
deleted file mode 100644
index b5ed0303a3d0..000000000000
--- a/unit_tests/storage/test_connection.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.storage.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'storage',
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeOne()
-        uri = conn.build_api_url('/foo', {'bar': 'baz'})
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        self.assertEqual(path,
-                         '/'.join(['', 'storage', conn.API_VERSION, 'foo']))
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['bar'], 'baz')
diff --git a/unit_tests/streaming/__init__.py b/unit_tests/streaming/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/streaming/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/streaming/test_buffered_stream.py b/unit_tests/streaming/test_buffered_stream.py
deleted file mode 100644
index c56ce7a31faf..000000000000
--- a/unit_tests/streaming/test_buffered_stream.py
+++ /dev/null
@@ -1,103 +0,0 @@
-import unittest
-
-
-class Test_BufferedStream(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.buffered_stream import BufferedStream
-        return BufferedStream
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_start_zero_longer_than_buffer(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 0
-        BUFSIZE = 4
-        stream = BytesIO(CONTENT)
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        self.assertIs(bufstream._stream, stream)
-        self.assertEqual(bufstream._start_pos, START)
-        self.assertEqual(bufstream._buffer_pos, 0)
-        self.assertEqual(bufstream._buffered_data, CONTENT[:BUFSIZE])
-        self.assertEqual(len(bufstream), BUFSIZE)
-        self.assertFalse(bufstream.stream_exhausted)
-        self.assertEqual(bufstream.stream_end_position, BUFSIZE)
-
-    def test_ctor_start_nonzero_shorter_than_buffer(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 8
-        BUFSIZE = 10
-        stream = BytesIO(CONTENT)
-        stream.read(START)  # already consumed
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        self.assertIs(bufstream._stream, stream)
-        self.assertEqual(bufstream._start_pos, START)
-        self.assertEqual(bufstream._buffer_pos, 0)
-        self.assertEqual(bufstream._buffered_data, CONTENT[START:])
-        self.assertEqual(len(bufstream), len(CONTENT) - START)
-        self.assertTrue(bufstream.stream_exhausted)
-        self.assertEqual(bufstream.stream_end_position, len(CONTENT))
-
-    def test__bytes_remaining_start_zero_longer_than_buffer(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 0
-        BUFSIZE = 4
-        stream = BytesIO(CONTENT)
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        self.assertEqual(bufstream._bytes_remaining, BUFSIZE)
-
-    def test__bytes_remaining_start_zero_shorter_than_buffer(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 8
-        BUFSIZE = 10
-        stream = BytesIO(CONTENT)
-        stream.read(START)  # already consumed
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        self.assertEqual(bufstream._bytes_remaining, len(CONTENT) - START)
-
-    def test_read_w_none(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 0
-        BUFSIZE = 4
-        stream = BytesIO(CONTENT)
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        with self.assertRaises(ValueError):
-            bufstream.read(None)
-
-    def test_read_w_negative_size(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 0
-        BUFSIZE = 4
-        stream = BytesIO(CONTENT)
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        with self.assertRaises(ValueError):
-            bufstream.read(-2)
-
-    def test_read_from_start(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = 0
-        BUFSIZE = 4
-        stream = BytesIO(CONTENT)
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        self.assertEqual(bufstream.read(4), CONTENT[:4])
-
-    def test_read_exhausted(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        START = len(CONTENT)
-        BUFSIZE = 10
-        stream = BytesIO(CONTENT)
-        stream.read(START)  # already consumed
-        bufstream = self._makeOne(stream, START, BUFSIZE)
-        self.assertTrue(bufstream.stream_exhausted)
-        self.assertEqual(bufstream.stream_end_position, len(CONTENT))
-        self.assertEqual(bufstream._bytes_remaining, 0)
-        self.assertEqual(bufstream.read(10), b'')
diff --git a/unit_tests/streaming/test_exceptions.py b/unit_tests/streaming/test_exceptions.py
deleted file mode 100644
index a0e17447042f..000000000000
--- a/unit_tests/streaming/test_exceptions.py
+++ /dev/null
@@ -1,87 +0,0 @@
-import unittest
-
-
-class Test_HttpError(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.exceptions import HttpError
-        return HttpError
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        RESPONSE = {'status': '404'}
-        CONTENT = b'CONTENT'
-        URL = 'http://www.example.com'
-        exception = self._makeOne(RESPONSE, CONTENT, URL)
-        self.assertEqual(exception.response, RESPONSE)
-        self.assertEqual(exception.content, CONTENT)
-        self.assertEqual(exception.url, URL)
-        self.assertEqual(exception.status_code, 404)
-        self.assertEqual(
-            str(exception),
-            "HttpError accessing <http://www.example.com>: "
-            "response: <{'status': '404'}>, content <CONTENT>")
-
-    def test_from_response(self):
-        RESPONSE = {'status': '404'}
-        CONTENT = b'CONTENT'
-        URL = 'http://www.example.com'
-
-        class _Response(object):
-            info = RESPONSE
-            content = CONTENT
-            request_url = URL
-
-        klass = self._getTargetClass()
-        exception = klass.from_response(_Response())
-        self.assertIsInstance(exception, klass)
-        self.assertEqual(exception.response, RESPONSE)
-        self.assertEqual(exception.content, CONTENT)
-        self.assertEqual(exception.url, URL)
-
-
-class Test_RetryAfterError(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.exceptions import RetryAfterError
-        return RetryAfterError
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        RESPONSE = {'status': '404'}
-        CONTENT = b'CONTENT'
-        URL = 'http://www.example.com'
-        RETRY_AFTER = 60
-        exception = self._makeOne(RESPONSE, CONTENT, URL, RETRY_AFTER)
-        self.assertEqual(exception.response, RESPONSE)
-        self.assertEqual(exception.content, CONTENT)
-        self.assertEqual(exception.url, URL)
-        self.assertEqual(exception.retry_after, RETRY_AFTER)
-        self.assertEqual(
-            str(exception),
-            "HttpError accessing <http://www.example.com>: "
-            "response: <{'status': '404'}>, content <CONTENT>")
-
-    def test_from_response(self):
-        RESPONSE = {'status': '404'}
-        CONTENT = b'CONTENT'
-        URL = 'http://www.example.com'
-        RETRY_AFTER = 60
-
-        class _Response(object):
-            info = RESPONSE
-            content = CONTENT
-            request_url = URL
-            retry_after = RETRY_AFTER
-
-        klass = self._getTargetClass()
-        exception = klass.from_response(_Response())
-        self.assertIsInstance(exception, klass)
-        self.assertEqual(exception.response, RESPONSE)
-        self.assertEqual(exception.content, CONTENT)
-        self.assertEqual(exception.url, URL)
-        self.assertEqual(exception.retry_after, RETRY_AFTER)
diff --git a/unit_tests/streaming/test_http_wrapper.py b/unit_tests/streaming/test_http_wrapper.py
deleted file mode 100644
index fc971cbdf387..000000000000
--- a/unit_tests/streaming/test_http_wrapper.py
+++ /dev/null
@@ -1,468 +0,0 @@
-import unittest
-
-
-class Test__httplib2_debug_level(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.http_wrapper import _httplib2_debug_level
-        return _httplib2_debug_level
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_wo_loggable_body_wo_http(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-
-        request = _Request()
-        LEVEL = 1
-        _httplib2 = _Dummy(debuglevel=0)
-        with _Monkey(MUT, httplib2=_httplib2):
-            with self._makeOne(request, LEVEL):
-                self.assertEqual(_httplib2.debuglevel, 0)
-
-    def test_w_loggable_body_wo_http(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-
-        request = _Request(loggable_body=object())
-        LEVEL = 1
-        _httplib2 = _Dummy(debuglevel=0)
-        with _Monkey(MUT, httplib2=_httplib2):
-            with self._makeOne(request, LEVEL):
-                self.assertEqual(_httplib2.debuglevel, LEVEL)
-        self.assertEqual(_httplib2.debuglevel, 0)
-
-    def test_w_loggable_body_w_http(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-
-        class _Connection(object):
-            debuglevel = 0
-
-            def set_debuglevel(self, value):
-                self.debuglevel = value
-
-        request = _Request(loggable_body=object())
-        LEVEL = 1
-        _httplib2 = _Dummy(debuglevel=0)
-        update_me = _Connection()
-        skip_me = _Connection()
-        connections = {'update:me': update_me, 'skip_me': skip_me}
-        _http = _Dummy(connections=connections)
-        with _Monkey(MUT, httplib2=_httplib2):
-            with self._makeOne(request, LEVEL, _http):
-                self.assertEqual(_httplib2.debuglevel, LEVEL)
-                self.assertEqual(update_me.debuglevel, LEVEL)
-                self.assertEqual(skip_me.debuglevel, 0)
-        self.assertEqual(_httplib2.debuglevel, 0)
-        self.assertEqual(update_me.debuglevel, 0)
-        self.assertEqual(skip_me.debuglevel, 0)
-
-
-class Test_Request(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.http_wrapper import Request
-        return Request
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        request = self._makeOne()
-        self.assertEqual(request.url, '')
-        self.assertEqual(request.http_method, 'GET')
-        self.assertEqual(request.headers, {'content-length': '0'})
-        self.assertEqual(request.body, '')
-        self.assertIsNone(request.loggable_body)
-
-    def test_loggable_body_setter_w_body_None(self):
-        from google.cloud.streaming.exceptions import RequestError
-        request = self._makeOne(body=None)
-        with self.assertRaises(RequestError):
-            request.loggable_body = 'abc'
-
-    def test_body_setter_w_None(self):
-        request = self._makeOne()
-        request.loggable_body = 'abc'
-        request.body = None
-        self.assertEqual(request.headers, {})
-        self.assertIsNone(request.body)
-        self.assertEqual(request.loggable_body, 'abc')
-
-    def test_body_setter_w_non_string(self):
-        request = self._makeOne()
-        request.loggable_body = 'abc'
-        request.body = body = _Dummy(length=123)
-        self.assertEqual(request.headers, {'content-length': '123'})
-        self.assertIs(request.body, body)
-        self.assertEqual(request.loggable_body, '<media body>')
-
-
-class Test_Response(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.http_wrapper import Response
-        return Response
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        info = {'status': '200'}
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertEqual(len(response), len(CONTENT))
-        self.assertEqual(response.status_code, 200)
-        self.assertIsNone(response.retry_after)
-        self.assertFalse(response.is_redirect)
-
-    def test_length_w_content_encoding_w_content_range(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        RANGE = 'bytes 0-122/5678'
-        info = {
-            'status': '200',
-            'content-length': len(CONTENT),
-            'content-encoding': 'testing',
-            'content-range': RANGE,
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertEqual(len(response), 123)
-
-    def test_length_w_content_encoding_wo_content_range(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        info = {
-            'status': '200',
-            'content-length': len(CONTENT),
-            'content-encoding': 'testing',
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertEqual(len(response), len(CONTENT))
-
-    def test_length_w_content_length_w_content_range(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        RANGE = 'bytes 0-12/5678'
-        info = {
-            'status': '200',
-            'content-length': len(CONTENT) * 2,
-            'content-range': RANGE,
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertEqual(len(response), len(CONTENT) * 2)
-
-    def test_length_wo_content_length_w_content_range(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        RANGE = 'bytes 0-122/5678'
-        info = {
-            'status': '200',
-            'content-range': RANGE,
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertEqual(len(response), 123)
-
-    def test_retry_after_w_header(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        info = {
-            'status': '200',
-            'retry-after': '123',
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertEqual(response.retry_after, 123)
-
-    def test_is_redirect_w_code_wo_location(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        info = {
-            'status': '301',
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertFalse(response.is_redirect)
-
-    def test_is_redirect_w_code_w_location(self):
-        CONTENT = 'CONTENT'
-        URL = 'http://example.com/api'
-        info = {
-            'status': '301',
-            'location': 'http://example.com/other',
-        }
-        response = self._makeOne(info, CONTENT, URL)
-        self.assertTrue(response.is_redirect)
-
-
-class Test__check_response(unittest.TestCase):
-
-    def _callFUT(self, *args, **kw):
-        from google.cloud.streaming.http_wrapper import _check_response
-        return _check_response(*args, **kw)
-
-    def test_w_none(self):
-        from google.cloud.streaming.exceptions import RequestError
-        with self.assertRaises(RequestError):
-            self._callFUT(None)
-
-    def test_w_TOO_MANY_REQUESTS(self):
-        from google.cloud.streaming.exceptions import BadStatusCodeError
-        from google.cloud.streaming.http_wrapper import TOO_MANY_REQUESTS
-
-        with self.assertRaises(BadStatusCodeError):
-            self._callFUT(_Response(TOO_MANY_REQUESTS))
-
-    def test_w_50x(self):
-        from google.cloud.streaming.exceptions import BadStatusCodeError
-
-        with self.assertRaises(BadStatusCodeError):
-            self._callFUT(_Response(500))
-
-        with self.assertRaises(BadStatusCodeError):
-            self._callFUT(_Response(503))
-
-    def test_w_retry_after(self):
-        from google.cloud.streaming.exceptions import RetryAfterError
-
-        with self.assertRaises(RetryAfterError):
-            self._callFUT(_Response(200, 20))
-
-    def test_pass(self):
-        self._callFUT(_Response(200))
-
-
-class Test__reset_http_connections(unittest.TestCase):
-
-    def _callFUT(self, *args, **kw):
-        from google.cloud.streaming.http_wrapper import _reset_http_connections
-        return _reset_http_connections(*args, **kw)
-
-    def test_wo_connections(self):
-        http = object()
-        self._callFUT(http)
-
-    def test_w_connections(self):
-        connections = {'delete:me': object(), 'skip_me': object()}
-        http = _Dummy(connections=connections)
-        self._callFUT(http)
-        self.assertFalse('delete:me' in connections)
-        self.assertTrue('skip_me' in connections)
-
-
-class Test___make_api_request_no_retry(unittest.TestCase):
-
-    def _callFUT(self, *args, **kw):
-        from google.cloud.streaming.http_wrapper import (
-            _make_api_request_no_retry)
-        return _make_api_request_no_retry(*args, **kw)
-
-    def _verify_requested(self, http, request,
-                          redirections=5, connection_type=None):
-        self.assertEqual(len(http._requested), 1)
-        url, kw = http._requested[0]
-        self.assertEqual(url, request.url)
-        self.assertEqual(kw['method'], request.http_method)
-        self.assertEqual(kw['body'], request.body)
-        self.assertEqual(kw['headers'], request.headers)
-        self.assertEqual(kw['redirections'], redirections)
-        self.assertEqual(kw['connection_type'], connection_type)
-
-    def test_defaults_wo_connections(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-        INFO = {'status': '200'}
-        CONTENT = 'CONTENT'
-        _http = _Http((INFO, CONTENT))
-        _httplib2 = _Dummy(debuglevel=1)
-        _request = _Request()
-        _checked = []
-        with _Monkey(MUT, httplib2=_httplib2,
-                     _check_response=_checked.append):
-            response = self._callFUT(_http, _request)
-
-        self.assertIsInstance(response, MUT.Response)
-        self.assertEqual(response.info, INFO)
-        self.assertEqual(response.content, CONTENT)
-        self.assertEqual(response.request_url, _request.url)
-        self.assertEqual(_checked, [response])
-        self._verify_requested(_http, _request)
-
-    def test_w_http_connections_miss(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-        INFO = {'status': '200'}
-        CONTENT = 'CONTENT'
-        CONN_TYPE = object()
-        _http = _Http((INFO, CONTENT))
-        _http.connections = {'https': CONN_TYPE}
-        _httplib2 = _Dummy(debuglevel=1)
-        _request = _Request()
-        _checked = []
-        with _Monkey(MUT, httplib2=_httplib2,
-                     _check_response=_checked.append):
-            response = self._callFUT(_http, _request)
-
-        self.assertIsInstance(response, MUT.Response)
-        self.assertEqual(response.info, INFO)
-        self.assertEqual(response.content, CONTENT)
-        self.assertEqual(response.request_url, _request.url)
-        self.assertEqual(_checked, [response])
-        self._verify_requested(_http, _request)
-
-    def test_w_http_connections_hit(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-        INFO = {'status': '200'}
-        CONTENT = 'CONTENT'
-        CONN_TYPE = object()
-        _http = _Http((INFO, CONTENT))
-        _http.connections = {'http': CONN_TYPE}
-        _httplib2 = _Dummy(debuglevel=1)
-        _request = _Request()
-        _checked = []
-        with _Monkey(MUT, httplib2=_httplib2,
-                     _check_response=_checked.append):
-            response = self._callFUT(_http, _request)
-
-        self.assertIsInstance(response, MUT.Response)
-        self.assertEqual(response.info, INFO)
-        self.assertEqual(response.content, CONTENT)
-        self.assertEqual(response.request_url, _request.url)
-        self.assertEqual(_checked, [response])
-        self._verify_requested(_http, _request, connection_type=CONN_TYPE)
-
-    def test_w_request_returning_None(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-        from google.cloud.streaming.exceptions import RequestError
-        INFO = None
-        CONTENT = None
-        CONN_TYPE = object()
-        _http = _Http((INFO, CONTENT))
-        _http.connections = {'http': CONN_TYPE}
-        _httplib2 = _Dummy(debuglevel=1)
-        _request = _Request()
-        with _Monkey(MUT, httplib2=_httplib2):
-            with self.assertRaises(RequestError):
-                self._callFUT(_http, _request)
-        self._verify_requested(_http, _request, connection_type=CONN_TYPE)
-
-
-class Test_make_api_request(unittest.TestCase):
-
-    def _callFUT(self, *args, **kw):
-        from google.cloud.streaming.http_wrapper import make_api_request
-        return make_api_request(*args, **kw)
-
-    def test_wo_exception(self):
-        from google.cloud.streaming import http_wrapper as MUT
-        from unit_tests._testing import _Monkey
-
-        HTTP, REQUEST, RESPONSE = object(), object(), object()
-        _created, _checked = [], []
-
-        def _wo_exception(*args, **kw):
-            _created.append((args, kw))
-            return RESPONSE
-
-        with _Monkey(MUT, _make_api_request_no_retry=_wo_exception,
-                     _check_response=_checked.append):
-            response = self._callFUT(HTTP, REQUEST)
-
-        self.assertIs(response, RESPONSE)
-        expected_kw = {'redirections': MUT._REDIRECTIONS}
-        self.assertEqual(_created, [((HTTP, REQUEST), expected_kw)])
-        self.assertEqual(_checked, [])  # not called by '_wo_exception'
-
-    def test_w_exceptions_lt_max_retries(self):
-        from google.cloud.streaming.exceptions import RetryAfterError
-        from google.cloud.streaming import http_wrapper as MUT
-        from unit_tests._testing import _Monkey
-
-        HTTP, RESPONSE = object(), object()
-        REQUEST = _Request()
-        _created, _checked = [], []
-        _counter = [None] * 4
-
-        def _wo_exception(*args, **kw):
-            _created.append((args, kw))
-            if _counter:
-                _counter.pop()
-                raise RetryAfterError(RESPONSE, '', REQUEST.url, 0.1)
-            return RESPONSE
-
-        with _Monkey(MUT, _make_api_request_no_retry=_wo_exception,
-                     _check_response=_checked.append):
-            response = self._callFUT(HTTP, REQUEST, retries=5)
-
-        self.assertIs(response, RESPONSE)
-        self.assertEqual(len(_created), 5)
-        expected_kw = {'redirections': MUT._REDIRECTIONS}
-        for attempt in _created:
-            self.assertEqual(attempt, ((HTTP, REQUEST), expected_kw))
-        self.assertEqual(_checked, [])  # not called by '_wo_exception'
-
-    def test_w_exceptions_gt_max_retries(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import http_wrapper as MUT
-        HTTP = object()
-        REQUEST = _Request()
-        _created, _checked = [], []
-
-        def _wo_exception(*args, **kw):
-            _created.append((args, kw))
-            raise ValueError('Retryable')
-
-        with _Monkey(MUT, calculate_wait_for_retry=lambda *ignored: 0.1,
-                     _make_api_request_no_retry=_wo_exception,
-                     _check_response=_checked.append):
-            with self.assertRaises(ValueError):
-                self._callFUT(HTTP, REQUEST, retries=3)
-
-        self.assertEqual(len(_created), 3)
-        expected_kw = {'redirections': MUT._REDIRECTIONS}
-        for attempt in _created:
-            self.assertEqual(attempt, ((HTTP, REQUEST), expected_kw))
-        self.assertEqual(_checked, [])  # not called by '_wo_exception'
-
-
-class _Dummy(object):
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-
-class _Request(object):
-    __slots__ = ('url', 'http_method', 'body', 'headers', 'loggable_body',)
-    URL = 'http://example.com/api'
-
-    def __init__(self, url=URL, http_method='GET', body='',
-                 loggable_body=None):
-        self.url = url
-        self.http_method = http_method
-        self.body = body
-        self.headers = {}
-        self.loggable_body = loggable_body
-
-
-class _Response(object):
-    content = ''
-    request_url = _Request.URL
-
-    def __init__(self, status_code, retry_after=None):
-        self.info = {'status': status_code}
-        self.status_code = status_code
-        self.retry_after = retry_after
-
-
-class _Http(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def request(self, url, **kw):
-        self._requested.append((url, kw))
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/streaming/test_stream_slice.py b/unit_tests/streaming/test_stream_slice.py
deleted file mode 100644
index 8bbef61d5d15..000000000000
--- a/unit_tests/streaming/test_stream_slice.py
+++ /dev/null
@@ -1,68 +0,0 @@
-import unittest
-
-
-class Test_StreamSlice(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.stream_slice import StreamSlice
-        return StreamSlice
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        MAXSIZE = 4
-        stream = BytesIO(CONTENT)
-        stream_slice = self._makeOne(stream, MAXSIZE)
-        self.assertIs(stream_slice._stream, stream)
-        self.assertEqual(stream_slice._remaining_bytes, MAXSIZE)
-        self.assertEqual(stream_slice._max_bytes, MAXSIZE)
-        self.assertEqual(len(stream_slice), MAXSIZE)
-        self.assertEqual(stream_slice.length, MAXSIZE)
-
-    def test___nonzero___empty(self):
-        from io import BytesIO
-        CONTENT = b''
-        MAXSIZE = 0
-        stream = BytesIO(CONTENT)
-        stream_slice = self._makeOne(stream, MAXSIZE)
-        self.assertFalse(stream_slice)
-
-    def test___nonzero___nonempty(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        MAXSIZE = 4
-        stream = BytesIO(CONTENT)
-        stream_slice = self._makeOne(stream, MAXSIZE)
-        self.assertTrue(stream_slice)
-
-    def test_read_exhausted(self):
-        from io import BytesIO
-        from six.moves import http_client
-        CONTENT = b''
-        MAXSIZE = 4
-        stream = BytesIO(CONTENT)
-        stream_slice = self._makeOne(stream, MAXSIZE)
-        with self.assertRaises(http_client.IncompleteRead):
-            stream_slice.read()
-
-    def test_read_implicit_size(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        MAXSIZE = 4
-        stream = BytesIO(CONTENT)
-        stream_slice = self._makeOne(stream, MAXSIZE)
-        self.assertEqual(stream_slice.read(), CONTENT[:MAXSIZE])
-        self.assertEqual(stream_slice._remaining_bytes, 0)
-
-    def test_read_explicit_size(self):
-        from io import BytesIO
-        CONTENT = b'CONTENT GOES HERE'
-        MAXSIZE = 4
-        SIZE = 3
-        stream = BytesIO(CONTENT)
-        stream_slice = self._makeOne(stream, MAXSIZE)
-        self.assertEqual(stream_slice.read(SIZE), CONTENT[:SIZE])
-        self.assertEqual(stream_slice._remaining_bytes, MAXSIZE - SIZE)
diff --git a/unit_tests/streaming/test_transfer.py b/unit_tests/streaming/test_transfer.py
deleted file mode 100644
index 96426404b2c5..000000000000
--- a/unit_tests/streaming/test_transfer.py
+++ /dev/null
@@ -1,1942 +0,0 @@
-import unittest
-
-
-class Test__Transfer(unittest.TestCase):
-    URL = 'http://example.com/api'
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.transfer import _Transfer
-        return _Transfer
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        from google.cloud.streaming.transfer import _DEFAULT_CHUNKSIZE
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        self.assertIs(xfer.stream, stream)
-        self.assertFalse(xfer.close_stream)
-        self.assertEqual(xfer.chunksize, _DEFAULT_CHUNKSIZE)
-        self.assertTrue(xfer.auto_transfer)
-        self.assertIsNone(xfer.bytes_http)
-        self.assertIsNone(xfer.http)
-        self.assertEqual(xfer.num_retries, 5)
-        self.assertIsNone(xfer.url)
-        self.assertFalse(xfer.initialized)
-
-    def test_ctor_explicit(self):
-        stream = _Stream()
-        HTTP = object()
-        CHUNK_SIZE = 1 << 18
-        NUM_RETRIES = 8
-        xfer = self._makeOne(stream,
-                             close_stream=True,
-                             chunksize=CHUNK_SIZE,
-                             auto_transfer=False,
-                             http=HTTP,
-                             num_retries=NUM_RETRIES)
-        self.assertIs(xfer.stream, stream)
-        self.assertTrue(xfer.close_stream)
-        self.assertEqual(xfer.chunksize, CHUNK_SIZE)
-        self.assertFalse(xfer.auto_transfer)
-        self.assertIs(xfer.bytes_http, HTTP)
-        self.assertIs(xfer.http, HTTP)
-        self.assertEqual(xfer.num_retries, NUM_RETRIES)
-
-    def test_bytes_http_fallback_to_http(self):
-        stream = _Stream()
-        HTTP = object()
-        xfer = self._makeOne(stream, http=HTTP)
-        self.assertIs(xfer.bytes_http, HTTP)
-
-    def test_bytes_http_setter(self):
-        stream = _Stream()
-        HTTP = object()
-        BYTES_HTTP = object()
-        xfer = self._makeOne(stream, http=HTTP)
-        xfer.bytes_http = BYTES_HTTP
-        self.assertIs(xfer.bytes_http, BYTES_HTTP)
-
-    def test_num_retries_setter_invalid(self):
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        with self.assertRaises(ValueError):
-            xfer.num_retries = object()
-
-    def test_num_retries_setter_negative(self):
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        with self.assertRaises(ValueError):
-            xfer.num_retries = -1
-
-    def test__initialize_not_already_initialized_w_http(self):
-        HTTP = object()
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        xfer._initialize(HTTP, self.URL)
-        self.assertTrue(xfer.initialized)
-        self.assertIs(xfer.http, HTTP)
-        self.assertIs(xfer.url, self.URL)
-
-    def test__initialize_not_already_initialized_wo_http(self):
-        from httplib2 import Http
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        xfer._initialize(None, self.URL)
-        self.assertTrue(xfer.initialized)
-        self.assertIsInstance(xfer.http, Http)
-        self.assertIs(xfer.url, self.URL)
-
-    def test__initialize_w_existing_http(self):
-        HTTP_1, HTTP_2 = object(), object()
-        stream = _Stream()
-        xfer = self._makeOne(stream, http=HTTP_1)
-        xfer._initialize(HTTP_2, self.URL)
-        self.assertTrue(xfer.initialized)
-        self.assertIs(xfer.http, HTTP_1)
-        self.assertIs(xfer.url, self.URL)
-
-    def test__initialize_already_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        URL_2 = 'http://example.com/other'
-        HTTP_1, HTTP_2 = object(), object()
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        xfer._initialize(HTTP_1, self.URL)
-        with self.assertRaises(TransferInvalidError):
-            xfer._initialize(HTTP_2, URL_2)
-
-    def test__ensure_initialized_hit(self):
-        HTTP = object()
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        xfer._initialize(HTTP, self.URL)
-        xfer._ensure_initialized()  # no raise
-
-    def test__ensure_initialized_miss(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        with self.assertRaises(TransferInvalidError):
-            xfer._ensure_initialized()
-
-    def test__ensure_uninitialized_hit(self):
-        stream = _Stream()
-        xfer = self._makeOne(stream)
-        xfer._ensure_uninitialized()  # no raise
-
-    def test__ensure_uninitialized_miss(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        stream = _Stream()
-        HTTP = object()
-        xfer = self._makeOne(stream)
-        xfer._initialize(HTTP, self.URL)
-        with self.assertRaises(TransferInvalidError):
-            xfer._ensure_uninitialized()
-
-    def test___del___closes_stream(self):
-
-        stream = _Stream()
-        xfer = self._makeOne(stream, close_stream=True)
-
-        self.assertFalse(stream._closed)
-        del xfer
-        self.assertTrue(stream._closed)
-
-
-class Test_Download(unittest.TestCase):
-    URL = "http://example.com/api"
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.transfer import Download
-        return Download
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        stream = _Stream()
-        download = self._makeOne(stream)
-        self.assertIs(download.stream, stream)
-        self.assertIsNone(download._initial_response)
-        self.assertEqual(download.progress, 0)
-        self.assertIsNone(download.total_size)
-        self.assertIsNone(download.encoding)
-
-    def test_ctor_w_kwds(self):
-        stream = _Stream()
-        CHUNK_SIZE = 123
-        download = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        self.assertIs(download.stream, stream)
-        self.assertEqual(download.chunksize, CHUNK_SIZE)
-
-    def test_ctor_w_total_size(self):
-        stream = _Stream()
-        SIZE = 123
-        download = self._makeOne(stream, total_size=SIZE)
-        self.assertIs(download.stream, stream)
-        self.assertEqual(download.total_size, SIZE)
-
-    def test_from_file_w_existing_file_no_override(self):
-        import os
-        klass = self._getTargetClass()
-        with _tempdir() as tempdir:
-            filename = os.path.join(tempdir, 'file.out')
-            with open(filename, 'w') as fileobj:
-                fileobj.write('EXISTING FILE')
-            with self.assertRaises(ValueError):
-                klass.from_file(filename)
-
-    def test_from_file_w_existing_file_w_override_wo_auto_transfer(self):
-        import os
-        klass = self._getTargetClass()
-        with _tempdir() as tempdir:
-            filename = os.path.join(tempdir, 'file.out')
-            with open(filename, 'w') as fileobj:
-                fileobj.write('EXISTING FILE')
-            download = klass.from_file(filename, overwrite=True,
-                                       auto_transfer=False)
-            self.assertFalse(download.auto_transfer)
-            del download  # closes stream
-            with open(filename, 'rb') as fileobj:
-                self.assertEqual(fileobj.read(), b'')
-
-    def test_from_stream_defaults(self):
-        stream = _Stream()
-        klass = self._getTargetClass()
-        download = klass.from_stream(stream)
-        self.assertIs(download.stream, stream)
-        self.assertTrue(download.auto_transfer)
-        self.assertIsNone(download.total_size)
-
-    def test_from_stream_explicit(self):
-        CHUNK_SIZE = 1 << 18
-        SIZE = 123
-        stream = _Stream()
-        klass = self._getTargetClass()
-        download = klass.from_stream(stream, auto_transfer=False,
-                                     total_size=SIZE, chunksize=CHUNK_SIZE)
-        self.assertIs(download.stream, stream)
-        self.assertFalse(download.auto_transfer)
-        self.assertEqual(download.total_size, SIZE)
-        self.assertEqual(download.chunksize, CHUNK_SIZE)
-
-    def test_configure_request(self):
-        CHUNK_SIZE = 100
-        download = self._makeOne(_Stream(), chunksize=CHUNK_SIZE)
-        request = _Dummy(headers={})
-        url_builder = _Dummy(query_params={})
-        download.configure_request(request, url_builder)
-        self.assertEqual(request.headers, {'Range': 'bytes=0-99'})
-        self.assertEqual(url_builder.query_params, {'alt': 'media'})
-
-    def test__set_total_wo_content_range_wo_existing_total(self):
-        info = {}
-        download = self._makeOne(_Stream())
-        download._set_total(info)
-        self.assertEqual(download.total_size, 0)
-
-    def test__set_total_wo_content_range_w_existing_total(self):
-        SIZE = 123
-        info = {}
-        download = self._makeOne(_Stream(), total_size=SIZE)
-        download._set_total(info)
-        self.assertEqual(download.total_size, SIZE)
-
-    def test__set_total_w_content_range_w_existing_total(self):
-        SIZE = 123
-        info = {'content-range': 'bytes 123-234/4567'}
-        download = self._makeOne(_Stream(), total_size=SIZE)
-        download._set_total(info)
-        self.assertEqual(download.total_size, 4567)
-
-    def test__set_total_w_content_range_w_asterisk_total(self):
-        info = {'content-range': 'bytes 123-234/*'}
-        download = self._makeOne(_Stream())
-        download._set_total(info)
-        self.assertEqual(download.total_size, 0)
-
-    def test_initialize_download_already_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        request = _Request()
-        download = self._makeOne(_Stream())
-        download._initialize(None, self.URL)
-        with self.assertRaises(TransferInvalidError):
-            download.initialize_download(request, http=object())
-
-    def test_initialize_download_wo_autotransfer(self):
-        request = _Request()
-        http = object()
-        download = self._makeOne(_Stream(), auto_transfer=False)
-        download.initialize_download(request, http)
-        self.assertIs(download.http, http)
-        self.assertEqual(download.url, request.url)
-
-    def test_initialize_download_w_autotransfer_failing(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.exceptions import HttpError
-        request = _Request()
-        http = object()
-        download = self._makeOne(_Stream(), auto_transfer=True)
-
-        response = _makeResponse(http_client.BAD_REQUEST)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT, make_api_request=requester):
-            with self.assertRaises(HttpError):
-                download.initialize_download(request, http)
-
-        self.assertTrue(len(requester._requested), 1)
-        self.assertIs(requester._requested[0][0], request)
-
-    def test_initialize_download_w_autotransfer_w_content_location(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        REDIRECT_URL = 'http://example.com/other'
-        request = _Request()
-        http = object()
-        info = {'content-location': REDIRECT_URL}
-        download = self._makeOne(_Stream(), auto_transfer=True)
-
-        response = _makeResponse(http_client.NO_CONTENT, info)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT, make_api_request=requester):
-            download.initialize_download(request, http)
-
-        self.assertIsNone(download._initial_response)
-        self.assertEqual(download.total_size, 0)
-        self.assertIs(download.http, http)
-        self.assertEqual(download.url, REDIRECT_URL)
-        self.assertTrue(len(requester._requested), 1)
-        self.assertIs(requester._requested[0][0], request)
-
-    def test__normalize_start_end_w_end_w_start_lt_0(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        download = self._makeOne(_Stream())
-
-        with self.assertRaises(TransferInvalidError):
-            download._normalize_start_end(-1, 0)
-
-    def test__normalize_start_end_w_end_w_start_gt_total(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        download = self._makeOne(_Stream())
-        download._set_total({'content-range': 'bytes 0-1/2'})
-
-        with self.assertRaises(TransferInvalidError):
-            download._normalize_start_end(3, 0)
-
-    def test__normalize_start_end_w_end_lt_start(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        download = self._makeOne(_Stream())
-        download._set_total({'content-range': 'bytes 0-1/2'})
-
-        with self.assertRaises(TransferInvalidError):
-            download._normalize_start_end(1, 0)
-
-    def test__normalize_start_end_w_end_gt_start(self):
-        download = self._makeOne(_Stream())
-        download._set_total({'content-range': 'bytes 0-1/2'})
-        self.assertEqual(download._normalize_start_end(1, 2), (1, 1))
-
-    def test__normalize_start_end_wo_end_w_start_lt_0(self):
-        download = self._makeOne(_Stream())
-        download._set_total({'content-range': 'bytes 0-1/2'})
-        self.assertEqual(download._normalize_start_end(-2), (0, 1))
-        self.assertEqual(download._normalize_start_end(-1), (1, 1))
-
-    def test__normalize_start_end_wo_end_w_start_ge_0(self):
-        download = self._makeOne(_Stream())
-        download._set_total({'content-range': 'bytes 0-1/100'})
-        self.assertEqual(download._normalize_start_end(0), (0, 99))
-        self.assertEqual(download._normalize_start_end(1), (1, 99))
-
-    def test__set_range_header_w_start_lt_0(self):
-        request = _Request()
-        download = self._makeOne(_Stream())
-        download._set_range_header(request, -1)
-        self.assertEqual(request.headers['range'], 'bytes=-1')
-
-    def test__set_range_header_w_start_ge_0_wo_end(self):
-        request = _Request()
-        download = self._makeOne(_Stream())
-        download._set_range_header(request, 0)
-        self.assertEqual(request.headers['range'], 'bytes=0-')
-
-    def test__set_range_header_w_start_ge_0_w_end(self):
-        request = _Request()
-        download = self._makeOne(_Stream())
-        download._set_range_header(request, 0, 1)
-        self.assertEqual(request.headers['range'], 'bytes=0-1')
-
-    def test__compute_end_byte_w_start_lt_0_w_end(self):
-        download = self._makeOne(_Stream())
-        self.assertEqual(download._compute_end_byte(-1, 1), 1)
-
-    def test__compute_end_byte_w_start_ge_0_wo_end_w_use_chunks(self):
-        CHUNK_SIZE = 5
-        download = self._makeOne(_Stream(), chunksize=CHUNK_SIZE)
-        self.assertEqual(download._compute_end_byte(0, use_chunks=True), 4)
-
-    def test__compute_end_byte_w_start_ge_0_w_end_w_use_chunks(self):
-        CHUNK_SIZE = 5
-        download = self._makeOne(_Stream(), chunksize=CHUNK_SIZE)
-        self.assertEqual(download._compute_end_byte(0, 3, use_chunks=True), 3)
-        self.assertEqual(download._compute_end_byte(0, 5, use_chunks=True), 4)
-
-    def test__compute_end_byte_w_start_ge_0_w_end_w_total_size(self):
-        CHUNK_SIZE = 50
-        download = self._makeOne(_Stream(), chunksize=CHUNK_SIZE)
-        download._set_total({'content-range': 'bytes 0-1/10'})
-        self.assertEqual(download._compute_end_byte(0, 100, use_chunks=False),
-                         9)
-        self.assertEqual(download._compute_end_byte(0, 8, use_chunks=False), 8)
-
-    def test__compute_end_byte_w_start_ge_0_wo_end_w_total_size(self):
-        CHUNK_SIZE = 50
-        download = self._makeOne(_Stream(), chunksize=CHUNK_SIZE)
-        download._set_total({'content-range': 'bytes 0-1/10'})
-        self.assertEqual(download._compute_end_byte(0, use_chunks=False), 9)
-
-    def test__get_chunk_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        download = self._makeOne(_Stream())
-
-        with self.assertRaises(TransferInvalidError):
-            download._get_chunk(0, 10)
-
-    def test__get_chunk(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        http = object()
-        download = self._makeOne(_Stream())
-        download._initialize(http, self.URL)
-        response = _makeResponse(http_client.OK)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            found = download._get_chunk(0, 10)
-
-        self.assertIs(found, response)
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers['range'], 'bytes=0-10')
-
-    def test__process_response_w_FORBIDDEN(self):
-        from google.cloud.streaming.exceptions import HttpError
-        from six.moves import http_client
-        download = self._makeOne(_Stream())
-        response = _makeResponse(http_client.FORBIDDEN)
-        with self.assertRaises(HttpError):
-            download._process_response(response)
-
-    def test__process_response_w_NOT_FOUND(self):
-        from google.cloud.streaming.exceptions import HttpError
-        from six.moves import http_client
-        download = self._makeOne(_Stream())
-        response = _makeResponse(http_client.NOT_FOUND)
-        with self.assertRaises(HttpError):
-            download._process_response(response)
-
-    def test__process_response_w_other_error(self):
-        from google.cloud.streaming.exceptions import TransferRetryError
-        from six.moves import http_client
-        download = self._makeOne(_Stream())
-        response = _makeResponse(http_client.BAD_REQUEST)
-        with self.assertRaises(TransferRetryError):
-            download._process_response(response)
-
-    def test__process_response_w_OK_wo_encoding(self):
-        from six.moves import http_client
-        stream = _Stream()
-        download = self._makeOne(stream)
-        response = _makeResponse(http_client.OK, content='OK')
-        found = download._process_response(response)
-        self.assertIs(found, response)
-        self.assertEqual(stream._written, ['OK'])
-        self.assertEqual(download.progress, 2)
-        self.assertIsNone(download.encoding)
-
-    def test__process_response_w_PARTIAL_CONTENT_w_encoding(self):
-        from six.moves import http_client
-        stream = _Stream()
-        download = self._makeOne(stream)
-        info = {'content-encoding': 'blah'}
-        response = _makeResponse(http_client.OK, info, 'PARTIAL')
-        found = download._process_response(response)
-        self.assertIs(found, response)
-        self.assertEqual(stream._written, ['PARTIAL'])
-        self.assertEqual(download.progress, 7)
-        self.assertEqual(download.encoding, 'blah')
-
-    def test__process_response_w_REQUESTED_RANGE_NOT_SATISFIABLE(self):
-        from six.moves import http_client
-        stream = _Stream()
-        download = self._makeOne(stream)
-        response = _makeResponse(
-            http_client.REQUESTED_RANGE_NOT_SATISFIABLE)
-        found = download._process_response(response)
-        self.assertIs(found, response)
-        self.assertEqual(stream._written, [])
-        self.assertEqual(download.progress, 0)
-        self.assertIsNone(download.encoding)
-
-    def test__process_response_w_NO_CONTENT(self):
-        from six.moves import http_client
-        stream = _Stream()
-        download = self._makeOne(stream)
-        response = _makeResponse(status_code=http_client.NO_CONTENT)
-        found = download._process_response(response)
-        self.assertIs(found, response)
-        self.assertEqual(stream._written, [''])
-        self.assertEqual(download.progress, 0)
-        self.assertIsNone(download.encoding)
-
-    def test_get_range_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        download = self._makeOne(_Stream())
-        with self.assertRaises(TransferInvalidError):
-            download.get_range(0, 10)
-
-    def test_get_range_wo_total_size_complete(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        REQ_RANGE = 'bytes=0-%d' % (LEN,)
-        RESP_RANGE = 'bytes 0-%d/%d' % (LEN - 1, LEN)
-        http = object()
-        stream = _Stream()
-        download = self._makeOne(stream)
-        download._initialize(http, self.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info, CONTENT)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.get_range(0, LEN)
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE})
-        self.assertEqual(stream._written, [CONTENT])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_get_range_wo_total_size_wo_end(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        START = 5
-        CHUNK_SIZE = 123
-        REQ_RANGE = 'bytes=%d-%d' % (START, START + CHUNK_SIZE - 1,)
-        RESP_RANGE = 'bytes %d-%d/%d' % (START, LEN - 1, LEN)
-        http = object()
-        stream = _Stream()
-        download = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        download._initialize(http, self.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info, CONTENT[START:])
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.get_range(START)
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE})
-        self.assertEqual(stream._written, [CONTENT[START:]])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_get_range_w_total_size_partial(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        PARTIAL_LEN = 5
-        REQ_RANGE = 'bytes=0-%d' % (PARTIAL_LEN,)
-        RESP_RANGE = 'bytes 0-%d/%d' % (PARTIAL_LEN, LEN,)
-        http = object()
-        stream = _Stream()
-        download = self._makeOne(stream, total_size=LEN)
-        download._initialize(http, self.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info, CONTENT[:PARTIAL_LEN])
-        response.length = LEN
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.get_range(0, PARTIAL_LEN)
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE})
-        self.assertEqual(stream._written, [CONTENT[:PARTIAL_LEN]])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_get_range_w_empty_chunk(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.exceptions import TransferRetryError
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        START = 5
-        CHUNK_SIZE = 123
-        REQ_RANGE = 'bytes=%d-%d' % (START, START + CHUNK_SIZE - 1,)
-        RESP_RANGE = 'bytes %d-%d/%d' % (START, LEN - 1, LEN)
-        http = object()
-        stream = _Stream()
-        download = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        download._initialize(http, self.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            with self.assertRaises(TransferRetryError):
-                download.get_range(START)
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE})
-        self.assertEqual(stream._written, [''])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_get_range_w_total_size_wo_use_chunks(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        CHUNK_SIZE = 3
-        REQ_RANGE = 'bytes=0-%d' % (LEN - 1,)
-        RESP_RANGE = 'bytes 0-%d/%d' % (LEN - 1, LEN,)
-        http = object()
-        stream = _Stream()
-        download = self._makeOne(stream, total_size=LEN, chunksize=CHUNK_SIZE)
-        download._initialize(http, self.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info, CONTENT)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.get_range(0, use_chunks=False)
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE})
-        self.assertEqual(stream._written, [CONTENT])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_get_range_w_multiple_chunks(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CONTENT = b'ABCDE'
-        LEN = len(CONTENT)
-        CHUNK_SIZE = 3
-        REQ_RANGE_1 = 'bytes=0-%d' % (CHUNK_SIZE - 1,)
-        RESP_RANGE_1 = 'bytes 0-%d/%d' % (CHUNK_SIZE - 1, LEN)
-        REQ_RANGE_2 = 'bytes=%d-%d' % (CHUNK_SIZE, LEN - 1)
-        RESP_RANGE_2 = 'bytes %d-%d/%d' % (CHUNK_SIZE, LEN - 1, LEN)
-        http = object()
-        stream = _Stream()
-        download = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        download._initialize(http, self.URL)
-        info_1 = {'content-range': RESP_RANGE_1}
-        response_1 = _makeResponse(http_client.PARTIAL_CONTENT, info_1,
-                                   CONTENT[:CHUNK_SIZE])
-        info_2 = {'content-range': RESP_RANGE_2}
-        response_2 = _makeResponse(http_client.OK, info_2,
-                                   CONTENT[CHUNK_SIZE:])
-        requester = _MakeRequest(response_1, response_2)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.get_range(0)
-
-        self.assertTrue(len(requester._requested), 2)
-        request_1 = requester._requested[0][0]
-        self.assertEqual(request_1.headers, {'range': REQ_RANGE_1})
-        request_2 = requester._requested[1][0]
-        self.assertEqual(request_2.headers, {'range': REQ_RANGE_2})
-        self.assertEqual(stream._written, [b'ABC', b'DE'])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_stream_file_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        download = self._makeOne(_Stream())
-
-        with self.assertRaises(TransferInvalidError):
-            download.stream_file()
-
-    def test_stream_file_w_initial_response_complete(self):
-        from six.moves import http_client
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        RESP_RANGE = 'bytes 0-%d/%d' % (LEN - 1, LEN,)
-        stream = _Stream()
-        download = self._makeOne(stream, total_size=LEN)
-        info = {'content-range': RESP_RANGE}
-        download._initial_response = _makeResponse(
-            http_client.OK, info, CONTENT)
-        http = object()
-        download._initialize(http, _Request.URL)
-
-        download.stream_file()
-
-        self.assertEqual(stream._written, [CONTENT])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_stream_file_w_initial_response_incomplete(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CHUNK_SIZE = 3
-        CONTENT = b'ABCDEF'
-        LEN = len(CONTENT)
-        RESP_RANGE_1 = 'bytes 0-%d/%d' % (CHUNK_SIZE - 1, LEN,)
-        REQ_RANGE_2 = 'bytes=%d-%d' % (CHUNK_SIZE, LEN - 1)
-        RESP_RANGE_2 = 'bytes %d-%d/%d' % (CHUNK_SIZE, LEN - 1, LEN,)
-        stream = _Stream()
-        http = object()
-        download = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        info_1 = {'content-range': RESP_RANGE_1}
-        download._initial_response = _makeResponse(
-            http_client.PARTIAL_CONTENT, info_1, CONTENT[:CHUNK_SIZE])
-        info_2 = {'content-range': RESP_RANGE_2}
-        response_2 = _makeResponse(
-            http_client.OK, info_2, CONTENT[CHUNK_SIZE:])
-        requester = _MakeRequest(response_2)
-
-        download._initialize(http, _Request.URL)
-
-        request = _Request()
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.stream_file()
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE_2})
-        self.assertEqual(stream._written,
-                         [CONTENT[:CHUNK_SIZE], CONTENT[CHUNK_SIZE:]])
-        self.assertEqual(download.total_size, LEN)
-
-    def test_stream_file_wo_initial_response_wo_total_size(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        CHUNK_SIZE = 123
-        REQ_RANGE = 'bytes=0-%d' % (CHUNK_SIZE - 1)
-        RESP_RANGE = 'bytes 0-%d/%d' % (LEN - 1, LEN,)
-        stream = _Stream()
-        http = object()
-        download = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info, CONTENT)
-        requester = _MakeRequest(response)
-        download._initialize(http, _Request.URL)
-
-        request = _Request()
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            download.stream_file()
-
-        self.assertTrue(len(requester._requested), 1)
-        request = requester._requested[0][0]
-        self.assertEqual(request.headers, {'range': REQ_RANGE})
-        self.assertEqual(stream._written, [CONTENT])
-        self.assertEqual(download.total_size, LEN)
-
-
-class Test_Upload(unittest.TestCase):
-    URL = "http://example.com/api"
-    MIME_TYPE = 'application/octet-stream'
-    UPLOAD_URL = 'http://example.com/upload/id=foobar'
-
-    def _getTargetClass(self):
-        from google.cloud.streaming.transfer import Upload
-        return Upload
-
-    def _makeOne(self, stream, mime_type=MIME_TYPE, *args, **kw):
-        return self._getTargetClass()(stream, mime_type, *args, **kw)
-
-    def test_ctor_defaults(self):
-        from google.cloud.streaming.transfer import _DEFAULT_CHUNKSIZE
-        stream = _Stream()
-        upload = self._makeOne(stream)
-        self.assertIs(upload.stream, stream)
-        self.assertIsNone(upload._final_response)
-        self.assertIsNone(upload._server_chunk_granularity)
-        self.assertFalse(upload.complete)
-        self.assertEqual(upload.mime_type, self.MIME_TYPE)
-        self.assertEqual(upload.progress, 0)
-        self.assertIsNone(upload.strategy)
-        self.assertIsNone(upload.total_size)
-        self.assertEqual(upload.chunksize, _DEFAULT_CHUNKSIZE)
-
-    def test_ctor_w_kwds(self):
-        stream = _Stream()
-        CHUNK_SIZE = 123
-        upload = self._makeOne(stream, chunksize=CHUNK_SIZE)
-        self.assertIs(upload.stream, stream)
-        self.assertEqual(upload.mime_type, self.MIME_TYPE)
-        self.assertEqual(upload.chunksize, CHUNK_SIZE)
-
-    def test_from_file_w_nonesuch_file(self):
-        klass = self._getTargetClass()
-        filename = '~nosuchuser/file.txt'
-        with self.assertRaises(OSError):
-            klass.from_file(filename)
-
-    def test_from_file_wo_mimetype_w_unguessable_filename(self):
-        import os
-        klass = self._getTargetClass()
-        CONTENT = b'EXISTING FILE W/ UNGUESSABLE MIMETYPE'
-        with _tempdir() as tempdir:
-            filename = os.path.join(tempdir, 'file.unguessable')
-            with open(filename, 'wb') as fileobj:
-                fileobj.write(CONTENT)
-            with self.assertRaises(ValueError):
-                klass.from_file(filename)
-
-    def test_from_file_wo_mimetype_w_guessable_filename(self):
-        import os
-        klass = self._getTargetClass()
-        CONTENT = b'EXISTING FILE W/ GUESSABLE MIMETYPE'
-        with _tempdir() as tempdir:
-            filename = os.path.join(tempdir, 'file.txt')
-            with open(filename, 'wb') as fileobj:
-                fileobj.write(CONTENT)
-            upload = klass.from_file(filename)
-            self.assertEqual(upload.mime_type, 'text/plain')
-            self.assertTrue(upload.auto_transfer)
-            self.assertEqual(upload.total_size, len(CONTENT))
-            upload._stream.close()
-
-    def test_from_file_w_mimetype_w_auto_transfer_w_kwds(self):
-        import os
-        klass = self._getTargetClass()
-        CONTENT = b'EXISTING FILE W/ GUESSABLE MIMETYPE'
-        CHUNK_SIZE = 3
-        with _tempdir() as tempdir:
-            filename = os.path.join(tempdir, 'file.unguessable')
-            with open(filename, 'wb') as fileobj:
-                fileobj.write(CONTENT)
-            upload = klass.from_file(
-                filename,
-                mime_type=self.MIME_TYPE,
-                auto_transfer=False,
-                chunksize=CHUNK_SIZE)
-            self.assertEqual(upload.mime_type, self.MIME_TYPE)
-            self.assertFalse(upload.auto_transfer)
-            self.assertEqual(upload.total_size, len(CONTENT))
-            self.assertEqual(upload.chunksize, CHUNK_SIZE)
-            upload._stream.close()
-
-    def test_from_stream_wo_mimetype(self):
-        klass = self._getTargetClass()
-        stream = _Stream()
-        with self.assertRaises(ValueError):
-            klass.from_stream(stream, mime_type=None)
-
-    def test_from_stream_defaults(self):
-        klass = self._getTargetClass()
-        stream = _Stream()
-        upload = klass.from_stream(stream, mime_type=self.MIME_TYPE)
-        self.assertEqual(upload.mime_type, self.MIME_TYPE)
-        self.assertTrue(upload.auto_transfer)
-        self.assertIsNone(upload.total_size)
-
-    def test_from_stream_explicit(self):
-        klass = self._getTargetClass()
-        stream = _Stream()
-        SIZE = 10
-        CHUNK_SIZE = 3
-        upload = klass.from_stream(
-            stream,
-            mime_type=self.MIME_TYPE,
-            auto_transfer=False,
-            total_size=SIZE,
-            chunksize=CHUNK_SIZE)
-        self.assertEqual(upload.mime_type, self.MIME_TYPE)
-        self.assertFalse(upload.auto_transfer)
-        self.assertEqual(upload.total_size, SIZE)
-        self.assertEqual(upload.chunksize, CHUNK_SIZE)
-
-    def test_strategy_setter_invalid(self):
-        upload = self._makeOne(_Stream())
-        with self.assertRaises(ValueError):
-            upload.strategy = object()
-        with self.assertRaises(ValueError):
-            upload.strategy = 'unknown'
-
-    def test_strategy_setter_SIMPLE_UPLOAD(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        upload = self._makeOne(_Stream())
-        upload.strategy = SIMPLE_UPLOAD
-        self.assertEqual(upload.strategy, SIMPLE_UPLOAD)
-
-    def test_strategy_setter_RESUMABLE_UPLOAD(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        upload = self._makeOne(_Stream())
-        upload.strategy = RESUMABLE_UPLOAD
-        self.assertEqual(upload.strategy, RESUMABLE_UPLOAD)
-
-    def test_total_size_setter_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        SIZE = 123
-        upload = self._makeOne(_Stream)
-        http = object()
-        upload._initialize(http, _Request.URL)
-        with self.assertRaises(TransferInvalidError):
-            upload.total_size = SIZE
-
-    def test_total_size_setter_not_initialized(self):
-        SIZE = 123
-        upload = self._makeOne(_Stream)
-        upload.total_size = SIZE
-        self.assertEqual(upload.total_size, SIZE)
-
-    def test__set_default_strategy_w_existing_strategy(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        config = _Dummy(
-            resumable_path='/resumable/endpoint',
-            simple_multipart=True,
-            simple_path='/upload/endpoint',
-        )
-        request = _Request()
-        upload = self._makeOne(_Stream)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._set_default_strategy(config, request)
-        self.assertEqual(upload.strategy, RESUMABLE_UPLOAD)
-
-    def test__set_default_strategy_wo_resumable_path(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        config = _Dummy(
-            resumable_path=None,
-            simple_multipart=True,
-            simple_path='/upload/endpoint',
-        )
-        request = _Request()
-        upload = self._makeOne(_Stream())
-        upload._set_default_strategy(config, request)
-        self.assertEqual(upload.strategy, SIMPLE_UPLOAD)
-
-    def test__set_default_strategy_w_total_size_gt_threshhold(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD_THRESHOLD
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        config = _UploadConfig()
-        request = _Request()
-        upload = self._makeOne(
-            _Stream(), total_size=RESUMABLE_UPLOAD_THRESHOLD + 1)
-        upload._set_default_strategy(config, request)
-        self.assertEqual(upload.strategy, RESUMABLE_UPLOAD)
-
-    def test__set_default_strategy_w_body_wo_multipart(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        config = _UploadConfig()
-        config.simple_multipart = False
-        request = _Request(body=CONTENT)
-        upload = self._makeOne(_Stream(), total_size=len(CONTENT))
-        upload._set_default_strategy(config, request)
-        self.assertEqual(upload.strategy, RESUMABLE_UPLOAD)
-
-    def test__set_default_strategy_w_body_w_multipart_wo_simple_path(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        config = _UploadConfig()
-        config.simple_path = None
-        request = _Request(body=CONTENT)
-        upload = self._makeOne(_Stream(), total_size=len(CONTENT))
-        upload._set_default_strategy(config, request)
-        self.assertEqual(upload.strategy, RESUMABLE_UPLOAD)
-
-    def test__set_default_strategy_w_body_w_multipart_w_simple_path(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        config = _UploadConfig()
-        request = _Request(body=CONTENT)
-        upload = self._makeOne(_Stream(), total_size=len(CONTENT))
-        upload._set_default_strategy(config, request)
-        self.assertEqual(upload.strategy, SIMPLE_UPLOAD)
-
-    def test_configure_request_w_total_size_gt_max_size(self):
-        MAX_SIZE = 1000
-        config = _UploadConfig()
-        config.max_size = MAX_SIZE
-        request = _Request()
-        url_builder = _Dummy()
-        upload = self._makeOne(_Stream(), total_size=MAX_SIZE + 1)
-        with self.assertRaises(ValueError):
-            upload.configure_request(config, request, url_builder)
-
-    def test_configure_request_w_invalid_mimetype(self):
-        config = _UploadConfig()
-        config.accept = ('text/*',)
-        request = _Request()
-        url_builder = _Dummy()
-        upload = self._makeOne(_Stream())
-        with self.assertRaises(ValueError):
-            upload.configure_request(config, request, url_builder)
-
-    def test_configure_request_w_simple_wo_body(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        CONTENT = b'CONTENT'
-        config = _UploadConfig()
-        request = _Request()
-        url_builder = _Dummy(query_params={})
-        upload = self._makeOne(_Stream(CONTENT))
-        upload.strategy = SIMPLE_UPLOAD
-
-        upload.configure_request(config, request, url_builder)
-
-        self.assertEqual(url_builder.query_params, {'uploadType': 'media'})
-        self.assertEqual(url_builder.relative_path, config.simple_path)
-
-        self.assertEqual(request.headers, {'content-type': self.MIME_TYPE})
-        self.assertEqual(request.body, CONTENT)
-        self.assertEqual(request.loggable_body, '<media body>')
-
-    def test_configure_request_w_simple_w_body(self):
-        from google.cloud._helpers import _to_bytes
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        CONTENT = b'CONTENT'
-        BODY = b'BODY'
-        config = _UploadConfig()
-        request = _Request(body=BODY)
-        request.headers['content-type'] = 'text/plain'
-        url_builder = _Dummy(query_params={})
-        upload = self._makeOne(_Stream(CONTENT))
-        upload.strategy = SIMPLE_UPLOAD
-
-        upload.configure_request(config, request, url_builder)
-
-        self.assertEqual(url_builder.query_params, {'uploadType': 'multipart'})
-        self.assertEqual(url_builder.relative_path, config.simple_path)
-
-        self.assertEqual(list(request.headers), ['content-type'])
-        ctype, boundary = [x.strip()
-                           for x in request.headers['content-type'].split(';')]
-        self.assertEqual(ctype, 'multipart/related')
-        self.assertTrue(boundary.startswith('boundary="=='))
-        self.assertTrue(boundary.endswith('=="'))
-
-        divider = b'--' + _to_bytes(boundary[len('boundary="'):-1])
-        chunks = request.body.split(divider)[1:-1]  # discard prolog / epilog
-        self.assertEqual(len(chunks), 2)
-
-        parse_chunk = _email_chunk_parser()
-        text_msg = parse_chunk(chunks[0].strip())
-        self.assertEqual(dict(text_msg._headers),
-                         {'Content-Type': 'text/plain',
-                          'MIME-Version': '1.0'})
-        self.assertEqual(text_msg._payload, BODY.decode('ascii'))
-
-        app_msg = parse_chunk(chunks[1].strip())
-        self.assertEqual(dict(app_msg._headers),
-                         {'Content-Type': self.MIME_TYPE,
-                          'Content-Transfer-Encoding': 'binary',
-                          'MIME-Version': '1.0'})
-        self.assertEqual(app_msg._payload, CONTENT.decode('ascii'))
-        self.assertTrue(b'<media body>' in request.loggable_body)
-
-    def test_configure_request_w_resumable_wo_total_size(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'CONTENT'
-        config = _UploadConfig()
-        request = _Request()
-        url_builder = _Dummy(query_params={})
-        upload = self._makeOne(_Stream(CONTENT))
-        upload.strategy = RESUMABLE_UPLOAD
-
-        upload.configure_request(config, request, url_builder)
-
-        self.assertEqual(url_builder.query_params, {'uploadType': 'resumable'})
-        self.assertEqual(url_builder.relative_path, config.resumable_path)
-
-        self.assertEqual(request.headers,
-                         {'X-Upload-Content-Type': self.MIME_TYPE})
-
-    def test_configure_request_w_resumable_w_total_size(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'CONTENT'
-        LEN = len(CONTENT)
-        config = _UploadConfig()
-        request = _Request()
-        url_builder = _Dummy(query_params={})
-        upload = self._makeOne(_Stream(CONTENT))
-        upload.total_size = LEN
-        upload.strategy = RESUMABLE_UPLOAD
-
-        upload.configure_request(config, request, url_builder)
-
-        self.assertEqual(url_builder.query_params, {'uploadType': 'resumable'})
-        self.assertEqual(url_builder.relative_path, config.resumable_path)
-
-        self.assertEqual(request.headers,
-                         {'X-Upload-Content-Type': self.MIME_TYPE,
-                          'X-Upload-Content-Length': '%d' % (LEN,)})
-
-    def test_refresh_upload_state_w_simple_strategy(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        upload = self._makeOne(_Stream())
-        upload.strategy = SIMPLE_UPLOAD
-        upload.refresh_upload_state()  # no-op
-
-    def test_refresh_upload_state_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        upload = self._makeOne(_Stream())
-        upload.strategy = RESUMABLE_UPLOAD
-        with self.assertRaises(TransferInvalidError):
-            upload.refresh_upload_state()
-
-    def test_refresh_upload_state_w_OK(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        RESP_RANGE = 'bytes 0-%d/%d' % (LEN - 1, LEN,)
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=LEN)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(http, _Request.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.OK, info, CONTENT)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            upload.refresh_upload_state()
-
-        self.assertTrue(upload.complete)
-        self.assertEqual(upload.progress, LEN)
-        self.assertEqual(stream.tell(), LEN)
-        self.assertIs(upload._final_response, response)
-
-    def test_refresh_upload_state_w_CREATED(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        RESP_RANGE = 'bytes 0-%d/%d' % (LEN - 1, LEN,)
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=LEN)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(http, _Request.URL)
-        info = {'content-range': RESP_RANGE}
-        response = _makeResponse(http_client.CREATED, info, CONTENT)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            upload.refresh_upload_state()
-
-        self.assertTrue(upload.complete)
-        self.assertEqual(upload.progress, LEN)
-        self.assertEqual(stream.tell(), LEN)
-        self.assertIs(upload._final_response, response)
-
-    def test_refresh_upload_state_w_RESUME_INCOMPLETE_w_range(self):
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        LAST = 5
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=LEN)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(http, _Request.URL)
-        info = {'range': '0-%d' % (LAST - 1,)}
-        response = _makeResponse(RESUME_INCOMPLETE, info, CONTENT)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            upload.refresh_upload_state()
-
-        self.assertFalse(upload.complete)
-        self.assertEqual(upload.progress, LAST)
-        self.assertEqual(stream.tell(), LAST)
-        self.assertIsNot(upload._final_response, response)
-
-    def test_refresh_upload_state_w_RESUME_INCOMPLETE_wo_range(self):
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=LEN)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(http, _Request.URL)
-        response = _makeResponse(RESUME_INCOMPLETE, content=CONTENT)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            upload.refresh_upload_state()
-
-        self.assertFalse(upload.complete)
-        self.assertEqual(upload.progress, 0)
-        self.assertEqual(stream.tell(), 0)
-        self.assertIsNot(upload._final_response, response)
-
-    def test_refresh_upload_state_w_error(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.exceptions import HttpError
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        LEN = len(CONTENT)
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=LEN)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(http, _Request.URL)
-        response = _makeResponse(http_client.FORBIDDEN)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            with self.assertRaises(HttpError):
-                upload.refresh_upload_state()
-
-    def test__get_range_header_miss(self):
-        upload = self._makeOne(_Stream())
-        response = _makeResponse(None)
-        self.assertIsNone(upload._get_range_header(response))
-
-    def test__get_range_header_w_Range(self):
-        upload = self._makeOne(_Stream())
-        response = _makeResponse(None, {'Range': '123'})
-        self.assertEqual(upload._get_range_header(response), '123')
-
-    def test__get_range_header_w_range(self):
-        upload = self._makeOne(_Stream())
-        response = _makeResponse(None, {'range': '123'})
-        self.assertEqual(upload._get_range_header(response), '123')
-
-    def test_initialize_upload_no_strategy(self):
-        request = _Request()
-        upload = self._makeOne(_Stream())
-        with self.assertRaises(ValueError):
-            upload.initialize_upload(request, http=object())
-
-    def test_initialize_upload_simple_w_http(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        request = _Request()
-        upload = self._makeOne(_Stream())
-        upload.strategy = SIMPLE_UPLOAD
-        upload.initialize_upload(request, http=object())  # no-op
-
-    def test_initialize_upload_resumable_already_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        request = _Request()
-        upload = self._makeOne(_Stream())
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(None, self.URL)
-        with self.assertRaises(TransferInvalidError):
-            upload.initialize_upload(request, http=object())
-
-    def test_initialize_upload_w_http_resumable_not_initialized_w_error(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.exceptions import HttpError
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        request = _Request()
-        upload = self._makeOne(_Stream())
-        upload.strategy = RESUMABLE_UPLOAD
-        response = _makeResponse(http_client.FORBIDDEN)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT, make_api_request=requester):
-            with self.assertRaises(HttpError):
-                upload.initialize_upload(request, http=object())
-
-    def test_initialize_upload_w_http_wo_auto_transfer_w_OK(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        request = _Request()
-        upload = self._makeOne(_Stream(), auto_transfer=False)
-        upload.strategy = RESUMABLE_UPLOAD
-        info = {'location': self.UPLOAD_URL}
-        response = _makeResponse(http_client.OK, info)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT, make_api_request=requester):
-            upload.initialize_upload(request, http=object())
-
-        self.assertIsNone(upload._server_chunk_granularity)
-        self.assertEqual(upload.url, self.UPLOAD_URL)
-        self.assertEqual(requester._responses, [])
-        self.assertEqual(len(requester._requested), 1)
-        self.assertIs(requester._requested[0][0], request)
-
-    def test_initialize_upload_w_granularity_w_auto_transfer_w_OK(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        request = _Request()
-        upload = self._makeOne(_Stream(CONTENT), chunksize=1000)
-        upload.strategy = RESUMABLE_UPLOAD
-        info = {'X-Goog-Upload-Chunk-Granularity': '100',
-                'location': self.UPLOAD_URL}
-        response = _makeResponse(http_client.OK, info)
-        chunk_response = _makeResponse(http_client.OK)
-        requester = _MakeRequest(response, chunk_response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            upload.initialize_upload(request, http)
-
-        self.assertEqual(upload._server_chunk_granularity, 100)
-        self.assertEqual(upload.url, self.UPLOAD_URL)
-        self.assertEqual(requester._responses, [])
-        self.assertEqual(len(requester._requested), 2)
-        self.assertIs(requester._requested[0][0], request)
-        chunk_request = requester._requested[1][0]
-        self.assertIsInstance(chunk_request, _Request)
-        self.assertEqual(chunk_request.url, self.UPLOAD_URL)
-        self.assertEqual(chunk_request.http_method, 'PUT')
-        self.assertEqual(chunk_request.body, CONTENT)
-
-    def test__last_byte(self):
-        upload = self._makeOne(_Stream())
-        self.assertEqual(upload._last_byte('123-456'), 456)
-
-    def test__validate_chunksize_wo__server_chunk_granularity(self):
-        upload = self._makeOne(_Stream())
-        upload._validate_chunksize(123)  # no-op
-
-    def test__validate_chunksize_w__server_chunk_granularity_miss(self):
-        upload = self._makeOne(_Stream())
-        upload._server_chunk_granularity = 100
-        with self.assertRaises(ValueError):
-            upload._validate_chunksize(123)
-
-    def test__validate_chunksize_w__server_chunk_granularity_hit(self):
-        upload = self._makeOne(_Stream())
-        upload._server_chunk_granularity = 100
-        upload._validate_chunksize(400)
-
-    def test_stream_file_w_simple_strategy(self):
-        from google.cloud.streaming.transfer import SIMPLE_UPLOAD
-        upload = self._makeOne(_Stream())
-        upload.strategy = SIMPLE_UPLOAD
-        with self.assertRaises(ValueError):
-            upload.stream_file()
-
-    def test_stream_file_w_use_chunks_invalid_chunk_size(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        upload = self._makeOne(_Stream(), chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 100
-        with self.assertRaises(ValueError):
-            upload.stream_file(use_chunks=True)
-
-    def test_stream_file_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        upload = self._makeOne(_Stream(), chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 128
-        with self.assertRaises(TransferInvalidError):
-            upload.stream_file()
-
-    def test_stream_file_already_complete_w_unseekable_stream(self):
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        http = object()
-        stream = object()
-        response = object()
-        upload = self._makeOne(stream, chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 128
-        upload._initialize(http, _Request.URL)
-        upload._final_response = response
-        upload._complete = True
-        self.assertIs(upload.stream_file(), response)
-
-    def test_stream_file_already_complete_w_seekable_stream_unsynced(self):
-        from google.cloud.streaming.exceptions import CommunicationError
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        stream = _Stream(CONTENT)
-        response = object()
-        upload = self._makeOne(stream, chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 128
-        upload._initialize(http, _Request.URL)
-        upload._final_response = response
-        upload._complete = True
-        with self.assertRaises(CommunicationError):
-            upload.stream_file()
-
-    def test_stream_file_already_complete_wo_seekable_method_synced(self):
-        import os
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        stream = _Stream(CONTENT)
-        stream.seek(0, os.SEEK_END)
-        response = object()
-        upload = self._makeOne(stream, chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 128
-        upload._initialize(http, _Request.URL)
-        upload._final_response = response
-        upload._complete = True
-        self.assertIs(upload.stream_file(use_chunks=False), response)
-
-    def test_stream_file_already_complete_w_seekable_method_true_synced(self):
-        import os
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        stream = _StreamWithSeekableMethod(CONTENT, True)
-        stream.seek(0, os.SEEK_END)
-        response = object()
-        upload = self._makeOne(stream, chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 128
-        upload._initialize(http, _Request.URL)
-        upload._final_response = response
-        upload._complete = True
-        self.assertIs(upload.stream_file(use_chunks=False), response)
-
-    def test_stream_file_already_complete_w_seekable_method_false(self):
-        import os
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        stream = _StreamWithSeekableMethod(CONTENT, False)
-        stream.seek(0, os.SEEK_END)
-        response = object()
-        upload = self._makeOne(stream, chunksize=1024)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 128
-        upload._initialize(http, _Request.URL)
-        upload._final_response = response
-        upload._complete = True
-        self.assertIs(upload.stream_file(use_chunks=False), response)
-
-    def test_stream_file_incomplete(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        stream = _Stream(CONTENT)
-        upload = self._makeOne(stream, chunksize=6)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 6
-        upload._initialize(http, self.UPLOAD_URL)
-
-        info_1 = {'content-length': '0', 'range': 'bytes=0-5'}
-        response_1 = _makeResponse(RESUME_INCOMPLETE, info_1)
-        info_2 = {'content-length': '0', 'range': 'bytes=6-9'}
-        response_2 = _makeResponse(http_client.OK, info_2)
-        requester = _MakeRequest(response_1, response_2)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            response = upload.stream_file()
-
-        self.assertIs(response, response_2)
-        self.assertEqual(len(requester._responses), 0)
-        self.assertEqual(len(requester._requested), 2)
-
-        request_1 = requester._requested[0][0]
-        self.assertEqual(request_1.url, self.UPLOAD_URL)
-        self.assertEqual(request_1.http_method, 'PUT')
-        self.assertEqual(request_1.headers,
-                         {'Content-Range': 'bytes 0-5/*',
-                          'Content-Type': self.MIME_TYPE})
-        self.assertEqual(request_1.body, CONTENT[:6])
-
-        request_2 = requester._requested[1][0]
-        self.assertEqual(request_2.url, self.UPLOAD_URL)
-        self.assertEqual(request_2.http_method, 'PUT')
-        self.assertEqual(request_2.headers,
-                         {'Content-Range': 'bytes 6-9/10',
-                          'Content-Type': self.MIME_TYPE})
-        self.assertEqual(request_2.body, CONTENT[6:])
-
-    def test_stream_file_incomplete_w_transfer_error(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.exceptions import CommunicationError
-        from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        http = object()
-        stream = _Stream(CONTENT)
-        upload = self._makeOne(stream, chunksize=6)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._server_chunk_granularity = 6
-        upload._initialize(http, self.UPLOAD_URL)
-
-        info = {
-            'content-length': '0',
-            'range': 'bytes=0-4',  # simulate error, s.b. '0-5'
-        }
-        response = _makeResponse(RESUME_INCOMPLETE, info)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT,
-                     Request=_Request,
-                     make_api_request=requester):
-            with self.assertRaises(CommunicationError):
-                upload.stream_file()
-
-        self.assertEqual(len(requester._responses), 0)
-        self.assertEqual(len(requester._requested), 1)
-
-        request = requester._requested[0][0]
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        self.assertEqual(request.headers,
-                         {'Content-Range': 'bytes 0-5/*',
-                          'Content-Type': self.MIME_TYPE})
-        self.assertEqual(request.body, CONTENT[:6])
-
-    def test__send_media_request_wo_error(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-        CONTENT = b'ABCDEFGHIJ'
-        bytes_http = object()
-        stream = _Stream(CONTENT)
-        upload = self._makeOne(stream)
-        upload.bytes_http = bytes_http
-
-        headers = {'Content-Range': 'bytes 0-9/10',
-                   'Content-Type': self.MIME_TYPE}
-        request = _Request(self.UPLOAD_URL, 'PUT', CONTENT, headers)
-        info = {'content-length': '0', 'range': 'bytes=0-4'}
-        response = _makeResponse(RESUME_INCOMPLETE, info)
-        requester = _MakeRequest(response)
-
-        with _Monkey(MUT, make_api_request=requester):
-            upload._send_media_request(request, 9)
-
-        self.assertEqual(len(requester._responses), 0)
-        self.assertEqual(len(requester._requested), 1)
-        used_request, used_http, _ = requester._requested[0]
-        self.assertIs(used_request, request)
-        self.assertIs(used_http, bytes_http)
-        self.assertEqual(stream.tell(), 4)
-
-    def test__send_media_request_w_error(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud.streaming import transfer as MUT
-        from google.cloud.streaming.exceptions import HttpError
-        from google.cloud.streaming.http_wrapper import RESUME_INCOMPLETE
-        from google.cloud.streaming.transfer import RESUMABLE_UPLOAD
-        CONTENT = b'ABCDEFGHIJ'
-        bytes_http = object()
-        http = object()
-        stream = _Stream(CONTENT)
-        upload = self._makeOne(stream)
-        upload.strategy = RESUMABLE_UPLOAD
-        upload._initialize(http, self.UPLOAD_URL)
-        upload.bytes_http = bytes_http
-
-        headers = {'Content-Range': 'bytes 0-9/10',
-                   'Content-Type': self.MIME_TYPE}
-        request = _Request(self.UPLOAD_URL, 'PUT', CONTENT, headers)
-        info_1 = {'content-length': '0', 'range': 'bytes=0-4'}
-        response_1 = _makeResponse(http_client.FORBIDDEN, info_1)
-        info_2 = {'Content-Length': '0', 'Range': 'bytes=0-4'}
-        response_2 = _makeResponse(RESUME_INCOMPLETE, info_2)
-        requester = _MakeRequest(response_1, response_2)
-
-        with _Monkey(MUT, Request=_Request, make_api_request=requester):
-            with self.assertRaises(HttpError):
-                upload._send_media_request(request, 9)
-
-        self.assertEqual(len(requester._responses), 0)
-        self.assertEqual(len(requester._requested), 2)
-        first_request, first_http, _ = requester._requested[0]
-        self.assertIs(first_request, request)
-        self.assertIs(first_http, bytes_http)
-        second_request, second_http, _ = requester._requested[1]
-        self.assertEqual(second_request.url, self.UPLOAD_URL)
-        self.assertEqual(second_request.http_method, 'PUT')  # ACK!
-        self.assertEqual(second_request.headers,
-                         {'Content-Range': 'bytes */*'})
-        self.assertIs(second_http, http)
-
-    def test__send_media_body_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        upload = self._makeOne(_Stream())
-        with self.assertRaises(TransferInvalidError):
-            upload._send_media_body(0)
-
-    def test__send_media_body_wo_total_size(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        http = object()
-        upload = self._makeOne(_Stream())
-        upload._initialize(http, _Request.URL)
-        with self.assertRaises(TransferInvalidError):
-            upload._send_media_body(0)
-
-    def test__send_media_body_start_lt_total_size(self):
-        from google.cloud.streaming.stream_slice import StreamSlice
-        SIZE = 1234
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=SIZE)
-        upload._initialize(http, self.UPLOAD_URL)
-        response = object()
-        streamer = _MediaStreamer(response)
-        upload._send_media_request = streamer
-
-        found = upload._send_media_body(0)
-
-        self.assertIs(found, response)
-        request, end = streamer._called_with
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        body_stream = request.body
-        self.assertIsInstance(body_stream, StreamSlice)
-        self.assertIs(body_stream._stream, stream)
-        self.assertEqual(len(body_stream), SIZE)
-        self.assertEqual(request.headers,
-                         {'content-length': '%d' % (SIZE,),  # speling!
-                          'Content-Type': self.MIME_TYPE,
-                          'Content-Range': 'bytes 0-%d/%d' % (SIZE - 1, SIZE)})
-        self.assertEqual(end, SIZE)
-
-    def test__send_media_body_start_eq_total_size(self):
-        from google.cloud.streaming.stream_slice import StreamSlice
-        SIZE = 1234
-        http = object()
-        stream = _Stream()
-        upload = self._makeOne(stream, total_size=SIZE)
-        upload._initialize(http, self.UPLOAD_URL)
-        response = object()
-        streamer = _MediaStreamer(response)
-        upload._send_media_request = streamer
-
-        found = upload._send_media_body(SIZE)
-
-        self.assertIs(found, response)
-        request, end = streamer._called_with
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        body_stream = request.body
-        self.assertIsInstance(body_stream, StreamSlice)
-        self.assertIs(body_stream._stream, stream)
-        self.assertEqual(len(body_stream), 0)
-        self.assertEqual(request.headers,
-                         {'content-length': '0',  # speling!
-                          'Content-Type': self.MIME_TYPE,
-                          'Content-Range': 'bytes */%d' % (SIZE,)})
-        self.assertEqual(end, SIZE)
-
-    def test__send_chunk_not_initialized(self):
-        from google.cloud.streaming.exceptions import TransferInvalidError
-        upload = self._makeOne(_Stream())
-        with self.assertRaises(TransferInvalidError):
-            upload._send_chunk(0)
-
-    def test__send_chunk_wo_total_size_stream_exhausted(self):
-        CONTENT = b'ABCDEFGHIJ'
-        SIZE = len(CONTENT)
-        http = object()
-        upload = self._makeOne(_Stream(CONTENT), chunksize=1000)
-        upload._initialize(http, self.UPLOAD_URL)
-        response = object()
-        streamer = _MediaStreamer(response)
-        upload._send_media_request = streamer
-        self.assertIsNone(upload.total_size)
-
-        found = upload._send_chunk(0)
-
-        self.assertIs(found, response)
-        self.assertEqual(upload.total_size, SIZE)
-        request, end = streamer._called_with
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        self.assertEqual(request.body, CONTENT)
-        self.assertEqual(request.headers,
-                         {'content-length': '%d' % SIZE,  # speling!
-                          'Content-Type': self.MIME_TYPE,
-                          'Content-Range': 'bytes 0-%d/%d' % (SIZE - 1, SIZE)})
-        self.assertEqual(end, SIZE)
-
-    def test__send_chunk_wo_total_size_stream_not_exhausted(self):
-        CONTENT = b'ABCDEFGHIJ'
-        SIZE = len(CONTENT)
-        CHUNK_SIZE = SIZE - 5
-        http = object()
-        upload = self._makeOne(_Stream(CONTENT), chunksize=CHUNK_SIZE)
-        upload._initialize(http, self.UPLOAD_URL)
-        response = object()
-        streamer = _MediaStreamer(response)
-        upload._send_media_request = streamer
-        self.assertIsNone(upload.total_size)
-
-        found = upload._send_chunk(0)
-
-        self.assertIs(found, response)
-        self.assertIsNone(upload.total_size)
-        request, end = streamer._called_with
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        self.assertEqual(request.body, CONTENT[:CHUNK_SIZE])
-        expected_headers = {
-            'content-length': '%d' % CHUNK_SIZE,  # speling!
-            'Content-Type': self.MIME_TYPE,
-            'Content-Range': 'bytes 0-%d/*' % (CHUNK_SIZE - 1,),
-        }
-        self.assertEqual(request.headers, expected_headers)
-        self.assertEqual(end, CHUNK_SIZE)
-
-    def test__send_chunk_w_total_size_stream_not_exhausted(self):
-        from google.cloud.streaming.stream_slice import StreamSlice
-        CONTENT = b'ABCDEFGHIJ'
-        SIZE = len(CONTENT)
-        CHUNK_SIZE = SIZE - 5
-        http = object()
-        stream = _Stream(CONTENT)
-        upload = self._makeOne(stream, total_size=SIZE, chunksize=CHUNK_SIZE)
-        upload._initialize(http, self.UPLOAD_URL)
-        response = object()
-        streamer = _MediaStreamer(response)
-        upload._send_media_request = streamer
-
-        found = upload._send_chunk(0)
-
-        self.assertIs(found, response)
-        request, end = streamer._called_with
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        body_stream = request.body
-        self.assertIsInstance(body_stream, StreamSlice)
-        self.assertIs(body_stream._stream, stream)
-        self.assertEqual(len(body_stream), CHUNK_SIZE)
-        expected_headers = {
-            'content-length': '%d' % CHUNK_SIZE,  # speling!
-            'Content-Type': self.MIME_TYPE,
-            'Content-Range': 'bytes 0-%d/%d' % (CHUNK_SIZE - 1, SIZE),
-        }
-        self.assertEqual(request.headers, expected_headers)
-        self.assertEqual(end, CHUNK_SIZE)
-
-    def test__send_chunk_w_total_size_stream_exhausted(self):
-        from google.cloud.streaming.stream_slice import StreamSlice
-        CONTENT = b'ABCDEFGHIJ'
-        SIZE = len(CONTENT)
-        CHUNK_SIZE = 1000
-        http = object()
-        stream = _Stream(CONTENT)
-        upload = self._makeOne(stream, total_size=SIZE, chunksize=CHUNK_SIZE)
-        upload._initialize(http, self.UPLOAD_URL)
-        response = object()
-        streamer = _MediaStreamer(response)
-        upload._send_media_request = streamer
-
-        found = upload._send_chunk(SIZE)
-
-        self.assertIs(found, response)
-        request, end = streamer._called_with
-        self.assertEqual(request.url, self.UPLOAD_URL)
-        self.assertEqual(request.http_method, 'PUT')
-        body_stream = request.body
-        self.assertIsInstance(body_stream, StreamSlice)
-        self.assertIs(body_stream._stream, stream)
-        self.assertEqual(len(body_stream), 0)
-        self.assertEqual(request.headers,
-                         {'content-length': '0',  # speling!
-                          'Content-Type': self.MIME_TYPE,
-                          'Content-Range': 'bytes */%d' % (SIZE,)})
-        self.assertEqual(end, SIZE)
-
-
-def _email_chunk_parser():
-    import six
-    if six.PY3:  # pragma: NO COVER  Python3
-        from email.parser import BytesParser
-        parser = BytesParser()
-        return parser.parsebytes
-    else:
-        from email.parser import Parser
-        parser = Parser()
-        return parser.parsestr
-
-
-class _Dummy(object):
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-
-class _UploadConfig(object):
-    accept = ('*/*',)
-    max_size = None
-    resumable_path = '/resumable/endpoint'
-    simple_multipart = True
-    simple_path = '/upload/endpoint'
-
-
-class _Stream(object):
-    _closed = False
-
-    def __init__(self, to_read=b''):
-        import io
-        self._written = []
-        self._to_read = io.BytesIO(to_read)
-
-    def write(self, to_write):
-        self._written.append(to_write)
-
-    def seek(self, offset, whence=0):
-        self._to_read.seek(offset, whence)
-
-    def read(self, size=None):
-        if size is not None:
-            return self._to_read.read(size)
-        return self._to_read.read()
-
-    def tell(self):
-        return self._to_read.tell()
-
-    def close(self):
-        self._closed = True
-
-
-class _StreamWithSeekableMethod(_Stream):
-
-    def __init__(self, to_read=b'', seekable=True):
-        super(_StreamWithSeekableMethod, self).__init__(to_read)
-        self._seekable = seekable
-
-    def seekable(self):
-        return self._seekable
-
-
-class _Request(object):
-    __slots__ = ('url', 'http_method', 'body', 'headers', 'loggable_body')
-    URL = 'http://example.com/api'
-
-    def __init__(self, url=URL, http_method='GET', body='', headers=None):
-        self.url = url
-        self.http_method = http_method
-        self.body = self.loggable_body = body
-        if headers is None:
-            headers = {}
-        self.headers = headers
-
-
-class _MakeRequest(object):
-
-    def __init__(self, *responses):
-        self._responses = list(responses)
-        self._requested = []
-
-    def __call__(self, http, request, **kw):
-        self._requested.append((request, http, kw))
-        return self._responses.pop(0)
-
-
-def _makeResponse(status_code, info=None, content='',
-                  request_url=_Request.URL):
-    if info is None:
-        info = {}
-    return _Dummy(status_code=status_code,
-                  info=info,
-                  content=content,
-                  length=len(content),
-                  request_url=request_url)
-
-
-class _MediaStreamer(object):
-
-    _called_with = None
-
-    def __init__(self, response):
-        self._response = response
-
-    def __call__(self, request, end):
-        assert self._called_with is None
-        self._called_with = (request, end)
-        return self._response
-
-
-def _tempdir_maker():
-    import contextlib
-    import shutil
-    import tempfile
-
-    @contextlib.contextmanager
-    def _tempdir_mgr():
-        temp_dir = tempfile.mkdtemp()
-        yield temp_dir
-        shutil.rmtree(temp_dir)
-
-    return _tempdir_mgr
-
-_tempdir = _tempdir_maker()
-del _tempdir_maker
diff --git a/unit_tests/streaming/test_util.py b/unit_tests/streaming/test_util.py
deleted file mode 100644
index 6e72cfae07d2..000000000000
--- a/unit_tests/streaming/test_util.py
+++ /dev/null
@@ -1,48 +0,0 @@
-import unittest
-
-
-class Test_calculate_wait_for_retry(unittest.TestCase):
-
-    def _callFUT(self, *args, **kw):
-        from google.cloud.streaming.util import calculate_wait_for_retry
-        return calculate_wait_for_retry(*args, **kw)
-
-    def test_w_negative_jitter_lt_max_wait(self):
-        import random
-        from unit_tests._testing import _Monkey
-        with _Monkey(random, uniform=lambda lower, upper: lower):
-            self.assertEqual(self._callFUT(1), 1.5)
-
-    def test_w_positive_jitter_gt_max_wait(self):
-        import random
-        from unit_tests._testing import _Monkey
-        with _Monkey(random, uniform=lambda lower, upper: upper):
-            self.assertEqual(self._callFUT(4), 20)
-
-
-class Test_acceptable_mime_type(unittest.TestCase):
-
-    def _callFUT(self, *args, **kw):
-        from google.cloud.streaming.util import acceptable_mime_type
-        return acceptable_mime_type(*args, **kw)
-
-    def test_pattern_wo_slash(self):
-        with self.assertRaises(ValueError) as err:
-            self._callFUT(['text/*'], 'BOGUS')
-        self.assertEqual(
-            err.exception.args,
-            ('Invalid MIME type: "BOGUS"',))
-
-    def test_accept_pattern_w_semicolon(self):
-        with self.assertRaises(ValueError) as err:
-            self._callFUT(['text/*;charset=utf-8'], 'text/plain')
-        self.assertEqual(
-            err.exception.args,
-            ('MIME patterns with parameter unsupported: '
-             '"text/*;charset=utf-8"',))
-
-    def test_miss(self):
-        self.assertFalse(self._callFUT(['image/*'], 'text/plain'))
-
-    def test_hit(self):
-        self.assertTrue(self._callFUT(['text/*'], 'text/plain'))
diff --git a/unit_tests/test__helpers.py b/unit_tests/test__helpers.py
deleted file mode 100644
index 3a2950c42bbd..000000000000
--- a/unit_tests/test__helpers.py
+++ /dev/null
@@ -1,1093 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import os
-import unittest
-
-
-class Test__LocalStack(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud._helpers import _LocalStack
-
-        return _LocalStack
-
-    def _makeOne(self):
-        return self._getTargetClass()()
-
-    def test_it(self):
-        batch1, batch2 = object(), object()
-        batches = self._makeOne()
-        self.assertEqual(list(batches), [])
-        self.assertIsNone(batches.top)
-        batches.push(batch1)
-        self.assertIs(batches.top, batch1)
-        batches.push(batch2)
-        self.assertIs(batches.top, batch2)
-        popped = batches.pop()
-        self.assertIs(popped, batch2)
-        self.assertIs(batches.top, batch1)
-        self.assertEqual(list(batches), [batch1])
-        popped = batches.pop()
-        self.assertIsNone(batches.top)
-        self.assertEqual(list(batches), [])
-
-
-class Test__UTC(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud._helpers import _UTC
-        return _UTC
-
-    def _makeOne(self):
-        return self._getTargetClass()()
-
-    def test_module_property(self):
-        from google.cloud import _helpers as MUT
-        klass = self._getTargetClass()
-        try:
-            import pytz
-        except ImportError:
-            self.assertIsInstance(MUT.UTC, klass)
-        else:
-            self.assertIs(MUT.UTC, pytz.UTC)  # pragma: NO COVER
-
-    def test_dst(self):
-        import datetime
-
-        tz = self._makeOne()
-        self.assertEqual(tz.dst(None), datetime.timedelta(0))
-
-    def test_fromutc(self):
-        import datetime
-
-        naive_epoch = datetime.datetime.utcfromtimestamp(0)
-        self.assertIsNone(naive_epoch.tzinfo)
-        tz = self._makeOne()
-        epoch = tz.fromutc(naive_epoch)
-        self.assertEqual(epoch.tzinfo, tz)
-
-    def test_tzname(self):
-        tz = self._makeOne()
-        self.assertEqual(tz.tzname(None), 'UTC')
-
-    def test_utcoffset(self):
-        import datetime
-
-        tz = self._makeOne()
-        self.assertEqual(tz.utcoffset(None), datetime.timedelta(0))
-
-    def test___repr__(self):
-        tz = self._makeOne()
-        self.assertEqual(repr(tz), '<UTC>')
-
-    def test___str__(self):
-        tz = self._makeOne()
-        self.assertEqual(str(tz), 'UTC')
-
-
-class Test__ensure_tuple_or_list(unittest.TestCase):
-
-    def _callFUT(self, arg_name, tuple_or_list):
-        from google.cloud._helpers import _ensure_tuple_or_list
-        return _ensure_tuple_or_list(arg_name, tuple_or_list)
-
-    def test_valid_tuple(self):
-        valid_tuple_or_list = ('a', 'b', 'c', 'd')
-        result = self._callFUT('ARGNAME', valid_tuple_or_list)
-        self.assertEqual(result, ['a', 'b', 'c', 'd'])
-
-    def test_valid_list(self):
-        valid_tuple_or_list = ['a', 'b', 'c', 'd']
-        result = self._callFUT('ARGNAME', valid_tuple_or_list)
-        self.assertEqual(result, valid_tuple_or_list)
-
-    def test_invalid(self):
-        invalid_tuple_or_list = object()
-        with self.assertRaises(TypeError):
-            self._callFUT('ARGNAME', invalid_tuple_or_list)
-
-    def test_invalid_iterable(self):
-        invalid_tuple_or_list = 'FOO'
-        with self.assertRaises(TypeError):
-            self._callFUT('ARGNAME', invalid_tuple_or_list)
-
-
-class Test__app_engine_id(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud._helpers import _app_engine_id
-        return _app_engine_id()
-
-    def test_no_value(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import _helpers
-
-        with _Monkey(_helpers, app_identity=None):
-            dataset_id = self._callFUT()
-            self.assertIsNone(dataset_id)
-
-    def test_value_set(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import _helpers
-
-        APP_ENGINE_ID = object()
-        APP_IDENTITY = _AppIdentity(APP_ENGINE_ID)
-        with _Monkey(_helpers, app_identity=APP_IDENTITY):
-            dataset_id = self._callFUT()
-            self.assertEqual(dataset_id, APP_ENGINE_ID)
-
-
-class Test__file_project_id(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud._helpers import _file_project_id
-        return _file_project_id()
-
-    def test_success(self):
-        from google.cloud.environment_vars import CREDENTIALS
-        from unit_tests._testing import _Monkey
-        from unit_tests._testing import _NamedTemporaryFile
-
-        project_id = 'test-project-id'
-        payload = '{"%s":"%s"}' % ('project_id', project_id)
-        with _NamedTemporaryFile() as temp:
-            with open(temp.name, 'w') as creds_file:
-                creds_file.write(payload)
-
-            environ = {CREDENTIALS: temp.name}
-            with _Monkey(os, getenv=environ.get):
-                result = self._callFUT()
-
-            self.assertEqual(result, project_id)
-
-    def test_no_environment_variable_set(self):
-        from unit_tests._testing import _Monkey
-
-        environ = {}
-        with _Monkey(os, getenv=environ.get):
-            result = self._callFUT()
-
-        self.assertIsNone(result)
-
-
-class Test__get_nix_config_path(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud._helpers import _get_nix_config_path
-        return _get_nix_config_path()
-
-    def test_it(self):
-        from google.cloud import _helpers as MUT
-        from unit_tests._testing import _Monkey
-
-        user_root = 'a'
-        config_file = 'b'
-        with _Monkey(MUT, _USER_ROOT=user_root,
-                     _GCLOUD_CONFIG_FILE=config_file):
-            result = self._callFUT()
-
-        expected = os.path.join(user_root, '.config', config_file)
-        self.assertEqual(result, expected)
-
-
-class Test__get_windows_config_path(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud._helpers import _get_windows_config_path
-        return _get_windows_config_path()
-
-    def test_it(self):
-        from google.cloud import _helpers as MUT
-        from unit_tests._testing import _Monkey
-
-        appdata_dir = 'a'
-        environ = {'APPDATA': appdata_dir}
-        config_file = 'b'
-        with _Monkey(os, getenv=environ.get):
-            with _Monkey(MUT, _GCLOUD_CONFIG_FILE=config_file):
-                result = self._callFUT()
-
-        expected = os.path.join(appdata_dir, config_file)
-        self.assertEqual(result, expected)
-
-
-class Test__default_service_project_id(unittest.TestCase):
-
-    CONFIG_TEMPLATE = '[%s]\n%s = %s\n'
-
-    def _callFUT(self):
-        from google.cloud._helpers import _default_service_project_id
-        return _default_service_project_id()
-
-    def test_nix(self):
-        from google.cloud import _helpers as MUT
-        from unit_tests._testing import _Monkey
-        from unit_tests._testing import _NamedTemporaryFile
-
-        project_id = 'test-project-id'
-        with _NamedTemporaryFile() as temp:
-            config_value = self.CONFIG_TEMPLATE % (
-                MUT._GCLOUD_CONFIG_SECTION,
-                MUT._GCLOUD_CONFIG_KEY, project_id)
-            with open(temp.name, 'w') as config_file:
-                config_file.write(config_value)
-
-            def mock_get_path():
-                return temp.name
-
-            with _Monkey(os, name='not-nt'):
-                with _Monkey(MUT, _get_nix_config_path=mock_get_path,
-                             _USER_ROOT='not-None'):
-                    result = self._callFUT()
-
-            self.assertEqual(result, project_id)
-
-    def test_windows(self):
-        from google.cloud import _helpers as MUT
-        from unit_tests._testing import _Monkey
-        from unit_tests._testing import _NamedTemporaryFile
-
-        project_id = 'test-project-id'
-        with _NamedTemporaryFile() as temp:
-            config_value = self.CONFIG_TEMPLATE % (
-                MUT._GCLOUD_CONFIG_SECTION,
-                MUT._GCLOUD_CONFIG_KEY, project_id)
-            with open(temp.name, 'w') as config_file:
-                config_file.write(config_value)
-
-            def mock_get_path():
-                return temp.name
-
-            with _Monkey(os, name='nt'):
-                with _Monkey(MUT, _get_windows_config_path=mock_get_path,
-                             _USER_ROOT=None):
-                    result = self._callFUT()
-
-            self.assertEqual(result, project_id)
-
-    def test_gae(self):
-        from google.cloud import _helpers as MUT
-        from unit_tests._testing import _Monkey
-
-        with _Monkey(os, name='not-nt'):
-            with _Monkey(MUT, _USER_ROOT=None):
-                result = self._callFUT()
-
-        self.assertIsNone(result)
-
-
-class Test__compute_engine_id(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud._helpers import _compute_engine_id
-        return _compute_engine_id()
-
-    def _monkeyConnection(self, connection):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-
-        def _connection_factory(host, timeout):
-            connection.host = host
-            connection.timeout = timeout
-            return connection
-
-        return _Monkey(http_client, HTTPConnection=_connection_factory)
-
-    def test_bad_status(self):
-        connection = _HTTPConnection(404, None)
-        with self._monkeyConnection(connection):
-            dataset_id = self._callFUT()
-            self.assertIsNone(dataset_id)
-
-    def test_success(self):
-        COMPUTE_ENGINE_ID = object()
-        connection = _HTTPConnection(200, COMPUTE_ENGINE_ID)
-        with self._monkeyConnection(connection):
-            dataset_id = self._callFUT()
-            self.assertEqual(dataset_id, COMPUTE_ENGINE_ID)
-
-    def test_socket_raises(self):
-        connection = _TimeoutHTTPConnection()
-        with self._monkeyConnection(connection):
-            dataset_id = self._callFUT()
-            self.assertIsNone(dataset_id)
-
-
-class Test__get_production_project(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud._helpers import _get_production_project
-        return _get_production_project()
-
-    def test_no_value(self):
-        from unit_tests._testing import _Monkey
-
-        environ = {}
-        with _Monkey(os, getenv=environ.get):
-            project = self._callFUT()
-            self.assertIsNone(project)
-
-    def test_value_set(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud._helpers import PROJECT
-
-        MOCK_PROJECT = object()
-        environ = {PROJECT: MOCK_PROJECT}
-        with _Monkey(os, getenv=environ.get):
-            project = self._callFUT()
-            self.assertEqual(project, MOCK_PROJECT)
-
-
-class Test__determine_default_project(unittest.TestCase):
-
-    def _callFUT(self, project=None):
-        from google.cloud._helpers import _determine_default_project
-        return _determine_default_project(project=project)
-
-    def _determine_default_helper(self, prod=None, gae=None, gce=None,
-                                  file_id=None, srv_id=None, project=None):
-        from unit_tests._testing import _Monkey
-        from google.cloud import _helpers
-
-        _callers = []
-
-        def prod_mock():
-            _callers.append('prod_mock')
-            return prod
-
-        def file_id_mock():
-            _callers.append('file_id_mock')
-            return file_id
-
-        def srv_id_mock():
-            _callers.append('srv_id_mock')
-            return srv_id
-
-        def gae_mock():
-            _callers.append('gae_mock')
-            return gae
-
-        def gce_mock():
-            _callers.append('gce_mock')
-            return gce
-
-        patched_methods = {
-            '_get_production_project': prod_mock,
-            '_file_project_id': file_id_mock,
-            '_default_service_project_id': srv_id_mock,
-            '_app_engine_id': gae_mock,
-            '_compute_engine_id': gce_mock,
-        }
-
-        with _Monkey(_helpers, **patched_methods):
-            returned_project = self._callFUT(project)
-
-        return returned_project, _callers
-
-    def test_no_value(self):
-        project, callers = self._determine_default_helper()
-        self.assertIsNone(project)
-        self.assertEqual(callers, ['prod_mock', 'file_id_mock', 'srv_id_mock',
-                                   'gae_mock', 'gce_mock'])
-
-    def test_explicit(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(project=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, [])
-
-    def test_prod(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(prod=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, ['prod_mock'])
-
-    def test_gae(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(gae=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, ['prod_mock', 'file_id_mock',
-                                   'srv_id_mock', 'gae_mock'])
-
-    def test_gce(self):
-        PROJECT = object()
-        project, callers = self._determine_default_helper(gce=PROJECT)
-        self.assertEqual(project, PROJECT)
-        self.assertEqual(callers, ['prod_mock', 'file_id_mock', 'srv_id_mock',
-                                   'gae_mock', 'gce_mock'])
-
-
-class Test__millis(unittest.TestCase):
-
-    def _callFUT(self, value):
-        from google.cloud._helpers import _millis
-        return _millis(value)
-
-    def test_one_second_from_epoch(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        WHEN = datetime.datetime(1970, 1, 1, 0, 0, 1, tzinfo=UTC)
-        self.assertEqual(self._callFUT(WHEN), 1000)
-
-
-class Test__microseconds_from_datetime(unittest.TestCase):
-
-    def _callFUT(self, value):
-        from google.cloud._helpers import _microseconds_from_datetime
-        return _microseconds_from_datetime(value)
-
-    def test_it(self):
-        import datetime
-
-        microseconds = 314159
-        timestamp = datetime.datetime(1970, 1, 1, hour=0,
-                                      minute=0, second=0,
-                                      microsecond=microseconds)
-        result = self._callFUT(timestamp)
-        self.assertEqual(result, microseconds)
-
-
-class Test__millis_from_datetime(unittest.TestCase):
-
-    def _callFUT(self, value):
-        from google.cloud._helpers import _millis_from_datetime
-        return _millis_from_datetime(value)
-
-    def test_w_none(self):
-        self.assertIsNone(self._callFUT(None))
-
-    def test_w_utc_datetime(self):
-        import datetime
-        import six
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _microseconds_from_datetime
-
-        NOW = datetime.datetime.utcnow().replace(tzinfo=UTC)
-        NOW_MICROS = _microseconds_from_datetime(NOW)
-        MILLIS = NOW_MICROS // 1000
-        result = self._callFUT(NOW)
-        self.assertIsInstance(result, six.integer_types)
-        self.assertEqual(result, MILLIS)
-
-    def test_w_non_utc_datetime(self):
-        import datetime
-        import six
-        from google.cloud._helpers import _UTC
-        from google.cloud._helpers import _microseconds_from_datetime
-
-        class CET(_UTC):
-            _tzname = 'CET'
-            _utcoffset = datetime.timedelta(hours=-1)
-
-        zone = CET()
-        NOW = datetime.datetime(2015, 7, 28, 16, 34, 47, tzinfo=zone)
-        NOW_MICROS = _microseconds_from_datetime(NOW)
-        MILLIS = NOW_MICROS // 1000
-        result = self._callFUT(NOW)
-        self.assertIsInstance(result, six.integer_types)
-        self.assertEqual(result, MILLIS)
-
-    def test_w_naive_datetime(self):
-        import datetime
-        import six
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _microseconds_from_datetime
-
-        NOW = datetime.datetime.utcnow()
-        UTC_NOW = NOW.replace(tzinfo=UTC)
-        UTC_NOW_MICROS = _microseconds_from_datetime(UTC_NOW)
-        MILLIS = UTC_NOW_MICROS // 1000
-        result = self._callFUT(NOW)
-        self.assertIsInstance(result, six.integer_types)
-        self.assertEqual(result, MILLIS)
-
-
-class Test__datetime_from_microseconds(unittest.TestCase):
-
-    def _callFUT(self, value):
-        from google.cloud._helpers import _datetime_from_microseconds
-        return _datetime_from_microseconds(value)
-
-    def test_it(self):
-        import datetime
-        from google.cloud._helpers import UTC
-        from google.cloud._helpers import _microseconds_from_datetime
-
-        NOW = datetime.datetime(2015, 7, 29, 17, 45, 21, 123456,
-                                tzinfo=UTC)
-        NOW_MICROS = _microseconds_from_datetime(NOW)
-        self.assertEqual(self._callFUT(NOW_MICROS), NOW)
-
-
-class Test___date_from_iso8601_date(unittest.TestCase):
-
-    def _callFUT(self, value):
-        from google.cloud._helpers import _date_from_iso8601_date
-        return _date_from_iso8601_date(value)
-
-    def test_todays_date(self):
-        import datetime
-        TODAY = datetime.date.today()
-        self.assertEqual(self._callFUT(TODAY.strftime("%Y-%m-%d")), TODAY)
-
-
-class Test__rfc3339_to_datetime(unittest.TestCase):
-
-    def _callFUT(self, dt_str):
-        from google.cloud._helpers import _rfc3339_to_datetime
-        return _rfc3339_to_datetime(dt_str)
-
-    def test_w_bogus_zone(self):
-        year = 2009
-        month = 12
-        day = 17
-        hour = 12
-        minute = 44
-        seconds = 32
-        micros = 123456789
-
-        dt_str = '%d-%02d-%02dT%02d:%02d:%02d.%06dBOGUS' % (
-            year, month, day, hour, minute, seconds, micros)
-        with self.assertRaises(ValueError):
-            self._callFUT(dt_str)
-
-    def test_w_microseconds(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        year = 2009
-        month = 12
-        day = 17
-        hour = 12
-        minute = 44
-        seconds = 32
-        micros = 123456
-
-        dt_str = '%d-%02d-%02dT%02d:%02d:%02d.%06dZ' % (
-            year, month, day, hour, minute, seconds, micros)
-        result = self._callFUT(dt_str)
-        expected_result = datetime.datetime(
-            year, month, day, hour, minute, seconds, micros, UTC)
-        self.assertEqual(result, expected_result)
-
-    def test_w_naonseconds(self):
-        year = 2009
-        month = 12
-        day = 17
-        hour = 12
-        minute = 44
-        seconds = 32
-        nanos = 123456789
-
-        dt_str = '%d-%02d-%02dT%02d:%02d:%02d.%09dZ' % (
-            year, month, day, hour, minute, seconds, nanos)
-        with self.assertRaises(ValueError):
-            self._callFUT(dt_str)
-
-
-class Test__rfc3339_nanos_to_datetime(unittest.TestCase):
-
-    def _callFUT(self, dt_str):
-        from google.cloud._helpers import _rfc3339_nanos_to_datetime
-        return _rfc3339_nanos_to_datetime(dt_str)
-
-    def test_w_bogus_zone(self):
-        year = 2009
-        month = 12
-        day = 17
-        hour = 12
-        minute = 44
-        seconds = 32
-        micros = 123456789
-
-        dt_str = '%d-%02d-%02dT%02d:%02d:%02d.%06dBOGUS' % (
-            year, month, day, hour, minute, seconds, micros)
-        with self.assertRaises(ValueError):
-            self._callFUT(dt_str)
-
-    def test_w_truncated_nanos(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        year = 2009
-        month = 12
-        day = 17
-        hour = 12
-        minute = 44
-        seconds = 32
-        truncateds_and_micros = [
-            ('12345678', 123456),
-            ('1234567', 123456),
-            ('123456', 123456),
-            ('12345', 123450),
-            ('1234', 123400),
-            ('123', 123000),
-            ('12', 120000),
-            ('1', 100000),
-        ]
-
-        for truncated, micros in truncateds_and_micros:
-            dt_str = '%d-%02d-%02dT%02d:%02d:%02d.%sZ' % (
-                year, month, day, hour, minute, seconds, truncated)
-            result = self._callFUT(dt_str)
-            expected_result = datetime.datetime(
-                year, month, day, hour, minute, seconds, micros, UTC)
-            self.assertEqual(result, expected_result)
-
-    def test_w_naonseconds(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        year = 2009
-        month = 12
-        day = 17
-        hour = 12
-        minute = 44
-        seconds = 32
-        nanos = 123456789
-        micros = nanos // 1000
-
-        dt_str = '%d-%02d-%02dT%02d:%02d:%02d.%09dZ' % (
-            year, month, day, hour, minute, seconds, nanos)
-        result = self._callFUT(dt_str)
-        expected_result = datetime.datetime(
-            year, month, day, hour, minute, seconds, micros, UTC)
-        self.assertEqual(result, expected_result)
-
-
-class Test__datetime_to_rfc3339(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud._helpers import _datetime_to_rfc3339
-        return _datetime_to_rfc3339(*args, **kwargs)
-
-    @staticmethod
-    def _make_timezone(offset):
-        from google.cloud._helpers import _UTC
-
-        class CET(_UTC):
-            _tzname = 'CET'
-            _utcoffset = offset
-
-        return CET()
-
-    def test_w_utc_datetime(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=UTC)
-        result = self._callFUT(TIMESTAMP, ignore_zone=False)
-        self.assertEqual(result, '2016-04-05T13:30:00.000000Z')
-
-    def test_w_non_utc_datetime(self):
-        import datetime
-        from google.cloud._helpers import _UTC
-
-        zone = self._make_timezone(offset=datetime.timedelta(hours=-1))
-        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=zone)
-        result = self._callFUT(TIMESTAMP, ignore_zone=False)
-        self.assertEqual(result, '2016-04-05T14:30:00.000000Z')
-
-    def test_w_non_utc_datetime_and_ignore_zone(self):
-        import datetime
-        from google.cloud._helpers import _UTC
-
-        zone = self._make_timezone(offset=datetime.timedelta(hours=-1))
-        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0, tzinfo=zone)
-        result = self._callFUT(TIMESTAMP)
-        self.assertEqual(result, '2016-04-05T13:30:00.000000Z')
-
-    def test_w_naive_datetime(self):
-        import datetime
-
-        TIMESTAMP = datetime.datetime(2016, 4, 5, 13, 30, 0)
-        result = self._callFUT(TIMESTAMP)
-        self.assertEqual(result, '2016-04-05T13:30:00.000000Z')
-
-
-class Test__to_bytes(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud._helpers import _to_bytes
-        return _to_bytes(*args, **kwargs)
-
-    def test_with_bytes(self):
-        value = b'bytes-val'
-        self.assertEqual(self._callFUT(value), value)
-
-    def test_with_unicode(self):
-        value = u'string-val'
-        encoded_value = b'string-val'
-        self.assertEqual(self._callFUT(value), encoded_value)
-
-    def test_unicode_non_ascii(self):
-        value = u'\u2013'  # Long hyphen
-        encoded_value = b'\xe2\x80\x93'
-        self.assertRaises(UnicodeEncodeError, self._callFUT, value)
-        self.assertEqual(self._callFUT(value, encoding='utf-8'),
-                         encoded_value)
-
-    def test_with_nonstring_type(self):
-        value = object()
-        self.assertRaises(TypeError, self._callFUT, value)
-
-
-class Test__bytes_to_unicode(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud._helpers import _bytes_to_unicode
-        return _bytes_to_unicode(*args, **kwargs)
-
-    def test_with_bytes(self):
-        value = b'bytes-val'
-        encoded_value = 'bytes-val'
-        self.assertEqual(self._callFUT(value), encoded_value)
-
-    def test_with_unicode(self):
-        value = u'string-val'
-        encoded_value = 'string-val'
-        self.assertEqual(self._callFUT(value), encoded_value)
-
-    def test_with_nonstring_type(self):
-        value = object()
-        self.assertRaises(ValueError, self._callFUT, value)
-
-
-class Test__pb_timestamp_to_datetime(unittest.TestCase):
-
-    def _callFUT(self, timestamp):
-        from google.cloud._helpers import _pb_timestamp_to_datetime
-        return _pb_timestamp_to_datetime(timestamp)
-
-    def test_it(self):
-        import datetime
-        from google.protobuf.timestamp_pb2 import Timestamp
-        from google.cloud._helpers import UTC
-
-        # Epoch is midnight on January 1, 1970 ...
-        dt_stamp = datetime.datetime(1970, month=1, day=1, hour=0,
-                                     minute=1, second=1, microsecond=1234,
-                                     tzinfo=UTC)
-        # ... so 1 minute and 1 second after is 61 seconds and 1234
-        # microseconds is 1234000 nanoseconds.
-        timestamp = Timestamp(seconds=61, nanos=1234000)
-        self.assertEqual(self._callFUT(timestamp), dt_stamp)
-
-
-class Test__pb_timestamp_to_rfc3339(unittest.TestCase):
-
-    def _callFUT(self, timestamp):
-        from google.cloud._helpers import _pb_timestamp_to_rfc3339
-        return _pb_timestamp_to_rfc3339(timestamp)
-
-    def test_it(self):
-        from google.protobuf.timestamp_pb2 import Timestamp
-
-        # Epoch is midnight on January 1, 1970 ...
-        # ... so 1 minute and 1 second after is 61 seconds and 1234
-        # microseconds is 1234000 nanoseconds.
-        timestamp = Timestamp(seconds=61, nanos=1234000)
-        self.assertEqual(self._callFUT(timestamp),
-                         '1970-01-01T00:01:01.001234Z')
-
-
-class Test__datetime_to_pb_timestamp(unittest.TestCase):
-
-    def _callFUT(self, when):
-        from google.cloud._helpers import _datetime_to_pb_timestamp
-        return _datetime_to_pb_timestamp(when)
-
-    def test_it(self):
-        import datetime
-        from google.protobuf.timestamp_pb2 import Timestamp
-        from google.cloud._helpers import UTC
-
-        # Epoch is midnight on January 1, 1970 ...
-        dt_stamp = datetime.datetime(1970, month=1, day=1, hour=0,
-                                     minute=1, second=1, microsecond=1234,
-                                     tzinfo=UTC)
-        # ... so 1 minute and 1 second after is 61 seconds and 1234
-        # microseconds is 1234000 nanoseconds.
-        timestamp = Timestamp(seconds=61, nanos=1234000)
-        self.assertEqual(self._callFUT(dt_stamp), timestamp)
-
-
-class Test__name_from_project_path(unittest.TestCase):
-
-    PROJECT = 'PROJECT'
-    THING_NAME = 'THING_NAME'
-    TEMPLATE = r'projects/(?P<project>\w+)/things/(?P<name>\w+)'
-
-    def _callFUT(self, path, project, template):
-        from google.cloud._helpers import _name_from_project_path
-        return _name_from_project_path(path, project, template)
-
-    def test_w_invalid_path_length(self):
-        PATH = 'projects/foo'
-        with self.assertRaises(ValueError):
-            self._callFUT(PATH, None, self.TEMPLATE)
-
-    def test_w_invalid_path_segments(self):
-        PATH = 'foo/%s/bar/%s' % (self.PROJECT, self.THING_NAME)
-        with self.assertRaises(ValueError):
-            self._callFUT(PATH, self.PROJECT, self.TEMPLATE)
-
-    def test_w_mismatched_project(self):
-        PROJECT1 = 'PROJECT1'
-        PROJECT2 = 'PROJECT2'
-        PATH = 'projects/%s/things/%s' % (PROJECT1, self.THING_NAME)
-        with self.assertRaises(ValueError):
-            self._callFUT(PATH, PROJECT2, self.TEMPLATE)
-
-    def test_w_valid_data_w_compiled_regex(self):
-        import re
-        template = re.compile(self.TEMPLATE)
-        PATH = 'projects/%s/things/%s' % (self.PROJECT, self.THING_NAME)
-        name = self._callFUT(PATH, self.PROJECT, template)
-        self.assertEqual(name, self.THING_NAME)
-
-    def test_w_project_passed_as_none(self):
-        PROJECT1 = 'PROJECT1'
-        PATH = 'projects/%s/things/%s' % (PROJECT1, self.THING_NAME)
-        self._callFUT(PATH, None, self.TEMPLATE)
-        name = self._callFUT(PATH, None, self.TEMPLATE)
-        self.assertEqual(name, self.THING_NAME)
-
-
-class TestMetadataPlugin(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud._helpers import MetadataPlugin
-        return MetadataPlugin
-
-    def _makeOne(self, *args, **kwargs):
-        return self._getTargetClass()(*args, **kwargs)
-
-    def test_constructor(self):
-        credentials = object()
-        plugin = self._makeOne(credentials)
-        self.assertIs(plugin._credentials, credentials)
-
-    def test___call__(self):
-        access_token_expected = 'FOOBARBAZ'
-        credentials = _Credentials(access_token=access_token_expected)
-        callback_args = []
-
-        def callback(*args):
-            callback_args.append(args)
-
-        transformer = self._makeOne(credentials)
-        result = transformer(None, callback)
-        cb_headers = [
-            ('authorization', 'Bearer ' + access_token_expected),
-        ]
-        self.assertIsNone(result)
-        self.assertEqual(callback_args, [(cb_headers, None)])
-        self.assertEqual(len(credentials._tokens), 1)
-
-
-class Test_make_secure_stub(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud._helpers import make_secure_stub
-        return make_secure_stub(*args, **kwargs)
-
-    def test_it(self):
-        from six.moves import http_client
-        from unit_tests._testing import _Monkey
-        from google.cloud import _helpers as MUT
-
-        mock_result = object()
-        stub_inputs = []
-
-        SSL_CREDS = object()
-        METADATA_CREDS = object()
-        COMPOSITE_CREDS = object()
-        CHANNEL = object()
-
-        class _GRPCModule(object):
-
-            def __init__(self):
-                self.ssl_channel_credentials_args = None
-                self.metadata_call_credentials_args = None
-                self.composite_channel_credentials_args = None
-                self.secure_channel_args = None
-
-            def ssl_channel_credentials(self, *args):
-                self.ssl_channel_credentials_args = args
-                return SSL_CREDS
-
-            def metadata_call_credentials(self, *args, **kwargs):
-                self.metadata_call_credentials_args = (args, kwargs)
-                return METADATA_CREDS
-
-            def composite_channel_credentials(self, *args):
-                self.composite_channel_credentials_args = args
-                return COMPOSITE_CREDS
-
-            def secure_channel(self, *args, **kwargs):
-                self.secure_channel_args = (args, kwargs)
-                return CHANNEL
-
-        grpc_mod = _GRPCModule()
-
-        def mock_stub_class(channel):
-            stub_inputs.append(channel)
-            return mock_result
-
-        metadata_plugin = object()
-        plugin_args = []
-
-        def mock_plugin(*args):
-            plugin_args.append(args)
-            return metadata_plugin
-
-        host = 'HOST'
-        credentials = object()
-        user_agent = 'USER_AGENT'
-        with _Monkey(MUT, grpc=grpc_mod,
-                     MetadataPlugin=mock_plugin):
-            result = self._callFUT(credentials, user_agent,
-                                   mock_stub_class, host)
-
-        self.assertIs(result, mock_result)
-        self.assertEqual(stub_inputs, [CHANNEL])
-        self.assertEqual(plugin_args, [(credentials,)])
-        self.assertEqual(grpc_mod.ssl_channel_credentials_args, ())
-        self.assertEqual(grpc_mod.metadata_call_credentials_args,
-                         ((metadata_plugin,), {'name': 'google_creds'}))
-        self.assertEqual(
-            grpc_mod.composite_channel_credentials_args,
-            (SSL_CREDS, METADATA_CREDS))
-        target = '%s:%d' % (host, http_client.HTTPS_PORT)
-        secure_args = (target, COMPOSITE_CREDS)
-        secure_kwargs = {
-            'options': (('grpc.primary_user_agent', user_agent),)
-        }
-        self.assertEqual(grpc_mod.secure_channel_args,
-                         (secure_args, secure_kwargs))
-
-
-class Test_make_insecure_stub(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud._helpers import make_insecure_stub
-        return make_insecure_stub(*args, **kwargs)
-
-    def _helper(self, target, host, port=None):
-        from unit_tests._testing import _Monkey
-        from google.cloud import _helpers as MUT
-
-        mock_result = object()
-        stub_inputs = []
-        CHANNEL = object()
-
-        class _GRPCModule(object):
-
-            def insecure_channel(self, *args):
-                self.insecure_channel_args = args
-                return CHANNEL
-
-        grpc_mod = _GRPCModule()
-
-        def mock_stub_class(channel):
-            stub_inputs.append(channel)
-            return mock_result
-
-        with _Monkey(MUT, grpc=grpc_mod):
-            result = self._callFUT(mock_stub_class, host, port=port)
-
-        self.assertIs(result, mock_result)
-        self.assertEqual(stub_inputs, [CHANNEL])
-        self.assertEqual(grpc_mod.insecure_channel_args, (target,))
-
-    def test_with_port_argument(self):
-        host = 'HOST'
-        port = 1025
-        target = '%s:%d' % (host, port)
-        self._helper(target, host, port=port)
-
-    def test_without_port_argument(self):
-        host = 'HOST:1114'
-        self._helper(host, host)
-
-
-class _AppIdentity(object):
-
-    def __init__(self, app_id):
-        self.app_id = app_id
-
-    def get_application_id(self):
-        return self.app_id
-
-
-class _HTTPResponse(object):
-
-    def __init__(self, status, data):
-        self.status = status
-        self.data = data
-
-    def read(self):
-        return self.data
-
-
-class _BaseHTTPConnection(object):
-
-    host = timeout = None
-
-    def __init__(self):
-        self._close_count = 0
-        self._called_args = []
-        self._called_kwargs = []
-
-    def request(self, method, uri, **kwargs):
-        self._called_args.append((method, uri))
-        self._called_kwargs.append(kwargs)
-
-    def close(self):
-        self._close_count += 1
-
-
-class _HTTPConnection(_BaseHTTPConnection):
-
-    def __init__(self, status, project):
-        super(_HTTPConnection, self).__init__()
-        self.status = status
-        self.project = project
-
-    def getresponse(self):
-        return _HTTPResponse(self.status, self.project)
-
-
-class _TimeoutHTTPConnection(_BaseHTTPConnection):
-
-    def getresponse(self):
-        import socket
-        raise socket.timeout('timed out')
-
-
-class _Credentials(object):
-
-    def __init__(self, access_token=None):
-        self._access_token = access_token
-        self._tokens = []
-
-    def get_access_token(self):
-        from oauth2client.client import AccessTokenInfo
-        token = AccessTokenInfo(access_token=self._access_token,
-                                expires_in=None)
-        self._tokens.append(token)
-        return token
diff --git a/unit_tests/test_client.py b/unit_tests/test_client.py
deleted file mode 100644
index 52bfc4aede9c..000000000000
--- a/unit_tests/test_client.py
+++ /dev/null
@@ -1,228 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class Test_ClientFactoryMixin(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.client import _ClientFactoryMixin
-        return _ClientFactoryMixin
-
-    def test_virtual(self):
-        klass = self._getTargetClass()
-        self.assertFalse('__init__' in klass.__dict__)
-
-
-class TestClient(unittest.TestCase):
-
-    def setUp(self):
-        KLASS = self._getTargetClass()
-        self.original_cnxn_class = KLASS._connection_class
-        KLASS._connection_class = _MockConnection
-
-    def tearDown(self):
-        KLASS = self._getTargetClass()
-        KLASS._connection_class = self.original_cnxn_class
-
-    def _getTargetClass(self):
-        from google.cloud.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import client
-
-        CREDENTIALS = object()
-        FUNC_CALLS = []
-
-        def mock_get_credentials():
-            FUNC_CALLS.append('get_credentials')
-            return CREDENTIALS
-
-        with _Monkey(client, get_credentials=mock_get_credentials):
-            client_obj = self._makeOne()
-
-        self.assertIsInstance(client_obj.connection, _MockConnection)
-        self.assertIs(client_obj.connection.credentials, CREDENTIALS)
-        self.assertEqual(FUNC_CALLS, ['get_credentials'])
-
-    def test_ctor_explicit(self):
-        CREDENTIALS = object()
-        HTTP = object()
-        client_obj = self._makeOne(credentials=CREDENTIALS, http=HTTP)
-
-        self.assertIsInstance(client_obj.connection, _MockConnection)
-        self.assertIs(client_obj.connection.credentials, CREDENTIALS)
-        self.assertIs(client_obj.connection.http, HTTP)
-
-    def test_from_service_account_json(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import client
-
-        KLASS = self._getTargetClass()
-        MOCK_FILENAME = 'foo.path'
-        mock_creds = _MockServiceAccountCredentials()
-        with _Monkey(client, ServiceAccountCredentials=mock_creds):
-            client_obj = KLASS.from_service_account_json(MOCK_FILENAME)
-
-        self.assertIs(client_obj.connection.credentials, mock_creds._result)
-        self.assertEqual(mock_creds.json_called, [MOCK_FILENAME])
-
-    def test_from_service_account_json_fail(self):
-        KLASS = self._getTargetClass()
-        CREDENTIALS = object()
-        self.assertRaises(TypeError, KLASS.from_service_account_json, None,
-                          credentials=CREDENTIALS)
-
-    def test_from_service_account_p12(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import client
-
-        KLASS = self._getTargetClass()
-        CLIENT_EMAIL = 'phred@example.com'
-        MOCK_FILENAME = 'foo.path'
-        mock_creds = _MockServiceAccountCredentials()
-        with _Monkey(client, ServiceAccountCredentials=mock_creds):
-            client_obj = KLASS.from_service_account_p12(CLIENT_EMAIL,
-                                                        MOCK_FILENAME)
-
-        self.assertIs(client_obj.connection.credentials, mock_creds._result)
-        self.assertEqual(mock_creds.p12_called,
-                         [(CLIENT_EMAIL, MOCK_FILENAME)])
-
-    def test_from_service_account_p12_fail(self):
-        KLASS = self._getTargetClass()
-        CREDENTIALS = object()
-        self.assertRaises(TypeError, KLASS.from_service_account_p12, None,
-                          None, credentials=CREDENTIALS)
-
-
-class TestJSONClient(unittest.TestCase):
-
-    def setUp(self):
-        KLASS = self._getTargetClass()
-        self.original_cnxn_class = KLASS._connection_class
-        KLASS._connection_class = _MockConnection
-
-    def tearDown(self):
-        KLASS = self._getTargetClass()
-        KLASS._connection_class = self.original_cnxn_class
-
-    def _getTargetClass(self):
-        from google.cloud.client import JSONClient
-        return JSONClient
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import client
-
-        PROJECT = 'PROJECT'
-        CREDENTIALS = object()
-        FUNC_CALLS = []
-
-        def mock_determine_proj(project):
-            FUNC_CALLS.append((project, '_determine_default_project'))
-            return PROJECT
-
-        def mock_get_credentials():
-            FUNC_CALLS.append('get_credentials')
-            return CREDENTIALS
-
-        with _Monkey(client, get_credentials=mock_get_credentials,
-                     _determine_default_project=mock_determine_proj):
-            client_obj = self._makeOne()
-
-        self.assertEqual(client_obj.project, PROJECT)
-        self.assertIsInstance(client_obj.connection, _MockConnection)
-        self.assertIs(client_obj.connection.credentials, CREDENTIALS)
-        self.assertEqual(
-            FUNC_CALLS,
-            [(None, '_determine_default_project'), 'get_credentials'])
-
-    def test_ctor_missing_project(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import client
-
-        FUNC_CALLS = []
-
-        def mock_determine_proj(project):
-            FUNC_CALLS.append((project, '_determine_default_project'))
-            return None
-
-        with _Monkey(client, _determine_default_project=mock_determine_proj):
-            self.assertRaises(EnvironmentError, self._makeOne)
-
-        self.assertEqual(FUNC_CALLS, [(None, '_determine_default_project')])
-
-    def test_ctor_w_invalid_project(self):
-        CREDENTIALS = object()
-        HTTP = object()
-        with self.assertRaises(ValueError):
-            self._makeOne(project=object(), credentials=CREDENTIALS, http=HTTP)
-
-    def _explicit_ctor_helper(self, project):
-        import six
-
-        CREDENTIALS = object()
-        HTTP = object()
-
-        client_obj = self._makeOne(project=project, credentials=CREDENTIALS,
-                                   http=HTTP)
-
-        if isinstance(project, six.binary_type):
-            self.assertEqual(client_obj.project, project.decode('utf-8'))
-        else:
-            self.assertEqual(client_obj.project, project)
-        self.assertIsInstance(client_obj.connection, _MockConnection)
-        self.assertIs(client_obj.connection.credentials, CREDENTIALS)
-        self.assertIs(client_obj.connection.http, HTTP)
-
-    def test_ctor_explicit_bytes(self):
-        PROJECT = b'PROJECT'
-        self._explicit_ctor_helper(PROJECT)
-
-    def test_ctor_explicit_unicode(self):
-        PROJECT = u'PROJECT'
-        self._explicit_ctor_helper(PROJECT)
-
-
-class _MockConnection(object):
-
-    def __init__(self, credentials=None, http=None):
-        self.credentials = credentials
-        self.http = http
-
-
-class _MockServiceAccountCredentials(object):
-
-    def __init__(self):
-        self.p12_called = []
-        self.json_called = []
-        self._result = object()
-
-    def from_p12_keyfile(self, email, path):
-        self.p12_called.append((email, path))
-        return self._result
-
-    def from_json_keyfile_name(self, path):
-        self.json_called.append(path)
-        return self._result
diff --git a/unit_tests/test_connection.py b/unit_tests/test_connection.py
deleted file mode 100644
index fefdb00f9f1b..000000000000
--- a/unit_tests/test_connection.py
+++ /dev/null
@@ -1,390 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        conn = self._makeOne()
-        self.assertIsNone(conn.credentials)
-
-    def test_ctor_explicit(self):
-        credentials = _Credentials()
-        self.assertEqual(credentials._create_scoped_calls, 0)
-        conn = self._makeOne(credentials)
-        self.assertEqual(credentials._create_scoped_calls, 1)
-        self.assertIs(conn.credentials, credentials)
-        self.assertIsNone(conn._http)
-
-    def test_ctor_explicit_http(self):
-        http = object()
-        conn = self._makeOne(http=http)
-        self.assertIsNone(conn.credentials)
-        self.assertIs(conn.http, http)
-
-    def test_ctor_credentials_wo_create_scoped(self):
-        credentials = object()
-        conn = self._makeOne(credentials)
-        self.assertIs(conn.credentials, credentials)
-        self.assertIsNone(conn._http)
-
-    def test_http_w_existing(self):
-        conn = self._makeOne()
-        conn._http = http = object()
-        self.assertIs(conn.http, http)
-
-    def test_http_wo_creds(self):
-        import httplib2
-        conn = self._makeOne()
-        self.assertIsInstance(conn.http, httplib2.Http)
-
-    def test_http_w_creds(self):
-        import httplib2
-
-        authorized = object()
-        credentials = _Credentials(authorized)
-        conn = self._makeOne(credentials)
-        self.assertIs(conn.http, authorized)
-        self.assertIsInstance(credentials._called_with, httplib2.Http)
-
-    def test_user_agent_format(self):
-        from pkg_resources import get_distribution
-        expected_ua = 'gcloud-python/{0}'.format(
-            get_distribution('google-cloud').version)
-        conn = self._makeOne()
-        self.assertEqual(conn.USER_AGENT, expected_ua)
-
-
-class TestJSONConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.connection import JSONConnection
-        return JSONConnection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def _makeMockOne(self, *args, **kw):
-        class MockConnection(self._getTargetClass()):
-            API_URL_TEMPLATE = '{api_base_url}/mock/{api_version}{path}'
-            API_BASE_URL = 'http://mock'
-            API_VERSION = 'vMOCK'
-        return MockConnection(*args, **kw)
-
-    def test_class_defaults(self):
-        klass = self._getTargetClass()
-        self.assertIsNone(klass.API_URL_TEMPLATE)
-        self.assertIsNone(klass.API_BASE_URL)
-        self.assertIsNone(klass.API_VERSION)
-
-    def test_ctor_defaults(self):
-        conn = self._makeOne()
-        self.assertIsNone(conn.credentials)
-
-    def test_ctor_explicit(self):
-        credentials = _Credentials()
-        conn = self._makeOne(credentials)
-        self.assertIs(conn.credentials, credentials)
-
-    def test_http_w_existing(self):
-        conn = self._makeOne()
-        conn._http = http = object()
-        self.assertIs(conn.http, http)
-
-    def test_http_wo_creds(self):
-        import httplib2
-        conn = self._makeOne()
-        self.assertIsInstance(conn.http, httplib2.Http)
-
-    def test_http_w_creds(self):
-        import httplib2
-
-        authorized = object()
-        credentials = _Credentials(authorized)
-        conn = self._makeOne(credentials)
-        self.assertIs(conn.http, authorized)
-        self.assertIsInstance(credentials._called_with, httplib2.Http)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeMockOne()
-        # Intended to emulate self.mock_template
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'mock',
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeMockOne()
-        uri = conn.build_api_url('/foo', {'bar': 'baz'})
-
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        # Intended to emulate mock_template
-        PATH = '/'.join([
-            '',
-            'mock',
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(path, PATH)
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['bar'], 'baz')
-
-    def test__make_request_no_data_no_content_type_no_headers(self):
-        conn = self._makeOne()
-        URI = 'http://example.com/test'
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'text/plain'},
-            b'',
-        )
-        headers, content = conn._make_request('GET', URI)
-        self.assertEqual(headers['status'], '200')
-        self.assertEqual(headers['content-type'], 'text/plain')
-        self.assertEqual(content, b'')
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-        self.assertIsNone(http._called_with['body'])
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': '0',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-    def test__make_request_w_data_no_extra_headers(self):
-        conn = self._makeOne()
-        URI = 'http://example.com/test'
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'text/plain'},
-            b'',
-        )
-        conn._make_request('GET', URI, {}, 'application/json')
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-        self.assertEqual(http._called_with['body'], {})
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': '0',
-            'Content-Type': 'application/json',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-    def test__make_request_w_extra_headers(self):
-        conn = self._makeOne()
-        URI = 'http://example.com/test'
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'text/plain'},
-            b'',
-        )
-        conn._make_request('GET', URI, headers={'X-Foo': 'foo'})
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-        self.assertIsNone(http._called_with['body'])
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': '0',
-            'X-Foo': 'foo',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-    def test_api_request_defaults(self):
-        PATH = '/path/required'
-        conn = self._makeMockOne()
-        # Intended to emulate self.mock_template
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'mock',
-            '%s%s' % (conn.API_VERSION, PATH),
-        ])
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            b'{}',
-        )
-        self.assertEqual(conn.api_request('GET', PATH), {})
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-        self.assertIsNone(http._called_with['body'])
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': '0',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-    def test_api_request_w_non_json_response(self):
-        conn = self._makeMockOne()
-        conn._http = _Http(
-            {'status': '200', 'content-type': 'text/plain'},
-            b'CONTENT',
-        )
-
-        self.assertRaises(TypeError, conn.api_request, 'GET', '/')
-
-    def test_api_request_wo_json_expected(self):
-        conn = self._makeMockOne()
-        conn._http = _Http(
-            {'status': '200', 'content-type': 'text/plain'},
-            b'CONTENT',
-        )
-        self.assertEqual(conn.api_request('GET', '/', expect_json=False),
-                         b'CONTENT')
-
-    def test_api_request_w_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeMockOne()
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            b'{}',
-        )
-        self.assertEqual(conn.api_request('GET', '/', {'foo': 'bar'}), {})
-        self.assertEqual(http._called_with['method'], 'GET')
-        uri = http._called_with['uri']
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc), conn.API_BASE_URL)
-        # Intended to emulate self.mock_template
-        PATH = '/'.join([
-            '',
-            'mock',
-            conn.API_VERSION,
-            '',
-        ])
-        self.assertEqual(path, PATH)
-        parms = dict(parse_qsl(qs))
-        self.assertEqual(parms['foo'], 'bar')
-        self.assertIsNone(http._called_with['body'])
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': '0',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-    def test_api_request_w_data(self):
-        import json
-        DATA = {'foo': 'bar'}
-        DATAJ = json.dumps(DATA)
-        conn = self._makeMockOne()
-        # Intended to emulate self.mock_template
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'mock',
-            conn.API_VERSION,
-            '',
-        ])
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            b'{}',
-        )
-        self.assertEqual(conn.api_request('POST', '/', data=DATA), {})
-        self.assertEqual(http._called_with['method'], 'POST')
-        self.assertEqual(http._called_with['uri'], URI)
-        self.assertEqual(http._called_with['body'], DATAJ)
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': str(len(DATAJ)),
-            'Content-Type': 'application/json',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-    def test_api_request_w_404(self):
-        from google.cloud.exceptions import NotFound
-        conn = self._makeMockOne()
-        conn._http = _Http(
-            {'status': '404', 'content-type': 'text/plain'},
-            b'{}'
-        )
-        self.assertRaises(NotFound, conn.api_request, 'GET', '/')
-
-    def test_api_request_w_500(self):
-        from google.cloud.exceptions import InternalServerError
-        conn = self._makeMockOne()
-        conn._http = _Http(
-            {'status': '500', 'content-type': 'text/plain'},
-            b'{}',
-        )
-        self.assertRaises(InternalServerError, conn.api_request, 'GET', '/')
-
-    def test_api_request_non_binary_response(self):
-        conn = self._makeMockOne()
-        http = conn._http = _Http(
-            {'status': '200', 'content-type': 'application/json'},
-            u'{}',
-        )
-        result = conn.api_request('GET', '/')
-        # Intended to emulate self.mock_template
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'mock',
-            conn.API_VERSION,
-            '',
-        ])
-        self.assertEqual(result, {})
-        self.assertEqual(http._called_with['method'], 'GET')
-        self.assertEqual(http._called_with['uri'], URI)
-        self.assertIsNone(http._called_with['body'])
-        expected_headers = {
-            'Accept-Encoding': 'gzip',
-            'Content-Length': '0',
-            'User-Agent': conn.USER_AGENT,
-        }
-        self.assertEqual(http._called_with['headers'], expected_headers)
-
-
-class _Http(object):
-
-    _called_with = None
-
-    def __init__(self, headers, content):
-        from httplib2 import Response
-        self._response = Response(headers)
-        self._content = content
-
-    def request(self, **kw):
-        self._called_with = kw
-        return self._response, self._content
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    def __init__(self, authorized=None):
-        self._authorized = authorized
-        self._create_scoped_calls = 0
-
-    def authorize(self, http):
-        self._called_with = http
-        return self._authorized
-
-    def create_scoped_required(self):
-        self._create_scoped_calls += 1
-        return False
diff --git a/unit_tests/test_credentials.py b/unit_tests/test_credentials.py
deleted file mode 100644
index e5be1cfc9618..000000000000
--- a/unit_tests/test_credentials.py
+++ /dev/null
@@ -1,256 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test_get_credentials(unittest.TestCase):
-
-    def _callFUT(self):
-        from google.cloud import credentials
-        return credentials.get_credentials()
-
-    def test_it(self):
-        from unit_tests._testing import _Monkey
-        from google.cloud import credentials as MUT
-
-        client = _Client()
-        with _Monkey(MUT, client=client):
-            found = self._callFUT()
-        self.assertIsInstance(found, _Credentials)
-        self.assertIs(found, client._signed)
-        self.assertTrue(client._get_app_default_called)
-
-
-class Test_generate_signed_url(unittest.TestCase):
-
-    def _callFUT(self, *args, **kwargs):
-        from google.cloud.credentials import generate_signed_url
-        return generate_signed_url(*args, **kwargs)
-
-    def _generate_helper(self, response_type=None, response_disposition=None,
-                         generation=None):
-        import base64
-        from six.moves.urllib.parse import parse_qs
-        from six.moves.urllib.parse import urlsplit
-        from unit_tests._testing import _Monkey
-        from google.cloud import credentials as MUT
-
-        ENDPOINT = 'http://api.example.com'
-        RESOURCE = '/name/path'
-        SIGNED = base64.b64encode(b'DEADBEEF')
-        CREDENTIALS = _Credentials()
-
-        def _get_signed_query_params(*args):
-            credentials, expiration = args[:2]
-            return {
-                'GoogleAccessId': credentials.service_account_email,
-                'Expires': str(expiration),
-                'Signature': SIGNED,
-            }
-
-        with _Monkey(MUT, _get_signed_query_params=_get_signed_query_params):
-            url = self._callFUT(CREDENTIALS, RESOURCE, 1000,
-                                api_access_endpoint=ENDPOINT,
-                                response_type=response_type,
-                                response_disposition=response_disposition,
-                                generation=generation)
-
-        scheme, netloc, path, qs, frag = urlsplit(url)
-        self.assertEqual(scheme, 'http')
-        self.assertEqual(netloc, 'api.example.com')
-        self.assertEqual(path, RESOURCE)
-        params = parse_qs(qs)
-        # In Py3k, parse_qs gives us text values:
-        self.assertEqual(params.pop('Signature'), [SIGNED.decode('ascii')])
-        self.assertEqual(params.pop('Expires'), ['1000'])
-        self.assertEqual(params.pop('GoogleAccessId'),
-                         [CREDENTIALS.service_account_email])
-        if response_type is not None:
-            self.assertEqual(params.pop('response-content-type'),
-                             [response_type])
-        if response_disposition is not None:
-            self.assertEqual(params.pop('response-content-disposition'),
-                             [response_disposition])
-        if generation is not None:
-            self.assertEqual(params.pop('generation'), [generation])
-        # Make sure we have checked them all.
-        self.assertEqual(len(params), 0)
-        self.assertEqual(frag, '')
-
-    def test_w_expiration_int(self):
-        self._generate_helper()
-
-    def test_w_custom_fields(self):
-        response_type = 'text/plain'
-        response_disposition = 'attachment; filename=blob.png'
-        generation = '123'
-        self._generate_helper(response_type=response_type,
-                              response_disposition=response_disposition,
-                              generation=generation)
-
-
-class Test_generate_signed_url_exception(unittest.TestCase):
-    def test_with_google_credentials(self):
-        import time
-        from google.cloud.credentials import generate_signed_url
-        RESOURCE = '/name/path'
-
-        credentials = _GoogleCredentials()
-        expiration = int(time.time() + 5)
-        self.assertRaises(AttributeError, generate_signed_url, credentials,
-                          resource=RESOURCE, expiration=expiration)
-
-
-class Test__get_signed_query_params(unittest.TestCase):
-
-    def _callFUT(self, credentials, expiration, string_to_sign):
-        from google.cloud.credentials import _get_signed_query_params
-        return _get_signed_query_params(credentials, expiration,
-                                        string_to_sign)
-
-    def test_it(self):
-        import base64
-
-        SIG_BYTES = b'DEADBEEF'
-        ACCOUNT_NAME = object()
-        CREDENTIALS = _Credentials(sign_result=SIG_BYTES,
-                                   service_account_email=ACCOUNT_NAME)
-        EXPIRATION = 100
-        STRING_TO_SIGN = 'dummy_signature'
-        result = self._callFUT(CREDENTIALS, EXPIRATION,
-                               STRING_TO_SIGN)
-
-        self.assertEqual(result, {
-            'GoogleAccessId': ACCOUNT_NAME,
-            'Expires': str(EXPIRATION),
-            'Signature': base64.b64encode(b'DEADBEEF'),
-        })
-        self.assertEqual(CREDENTIALS._signed, [STRING_TO_SIGN])
-
-
-class Test__get_expiration_seconds(unittest.TestCase):
-
-    def _callFUT(self, expiration):
-        from google.cloud.credentials import _get_expiration_seconds
-        return _get_expiration_seconds(expiration)
-
-    def _utc_seconds(self, when):
-        import calendar
-        return int(calendar.timegm(when.timetuple()))
-
-    def test_w_invalid(self):
-        self.assertRaises(TypeError, self._callFUT, object())
-        self.assertRaises(TypeError, self._callFUT, None)
-
-    def test_w_int(self):
-        self.assertEqual(self._callFUT(123), 123)
-
-    def test_w_long(self):
-        try:
-            long
-        except NameError:  # pragma: NO COVER Py3K
-            pass
-        else:
-            self.assertEqual(self._callFUT(long(123)), 123)
-
-    def test_w_naive_datetime(self):
-        import datetime
-
-        expiration_no_tz = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
-        utc_seconds = self._utc_seconds(expiration_no_tz)
-        self.assertEqual(self._callFUT(expiration_no_tz), utc_seconds)
-
-    def test_w_utc_datetime(self):
-        import datetime
-        from google.cloud._helpers import UTC
-
-        expiration_utc = datetime.datetime(2004, 8, 19, 0, 0, 0, 0, UTC)
-        utc_seconds = self._utc_seconds(expiration_utc)
-        self.assertEqual(self._callFUT(expiration_utc), utc_seconds)
-
-    def test_w_other_zone_datetime(self):
-        import datetime
-        from google.cloud._helpers import _UTC
-
-        class CET(_UTC):
-            _tzname = 'CET'
-            _utcoffset = datetime.timedelta(hours=1)
-
-        zone = CET()
-        expiration_other = datetime.datetime(2004, 8, 19, 0, 0, 0, 0, zone)
-        utc_seconds = self._utc_seconds(expiration_other)
-        cet_seconds = utc_seconds - (60 * 60)  # CET one hour earlier than UTC
-        self.assertEqual(self._callFUT(expiration_other), cet_seconds)
-
-    def test_w_timedelta_seconds(self):
-        import datetime
-        from unit_tests._testing import _Monkey
-        from google.cloud import credentials as MUT
-
-        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
-        utc_seconds = self._utc_seconds(dummy_utcnow)
-        expiration_as_delta = datetime.timedelta(seconds=10)
-
-        with _Monkey(MUT, _NOW=lambda: dummy_utcnow):
-            result = self._callFUT(expiration_as_delta)
-
-        self.assertEqual(result, utc_seconds + 10)
-
-    def test_w_timedelta_days(self):
-        import datetime
-        from unit_tests._testing import _Monkey
-        from google.cloud import credentials as MUT
-
-        dummy_utcnow = datetime.datetime(2004, 8, 19, 0, 0, 0, 0)
-        utc_seconds = self._utc_seconds(dummy_utcnow)
-        expiration_as_delta = datetime.timedelta(days=1)
-
-        with _Monkey(MUT, _NOW=lambda: dummy_utcnow):
-            result = self._callFUT(expiration_as_delta)
-
-        self.assertEqual(result, utc_seconds + 86400)
-
-
-class _Credentials(object):
-
-    def __init__(self, service_account_email='testing@example.com',
-                 sign_result=''):
-        self.service_account_email = service_account_email
-        self._sign_result = sign_result
-        self._signed = []
-
-    def sign_blob(self, bytes_to_sign):
-        self._signed.append(bytes_to_sign)
-        return None, self._sign_result
-
-
-class _GoogleCredentials(object):
-
-    def __init__(self, service_account_email='testing@example.com'):
-        self.service_account_email = service_account_email
-
-
-class _Client(object):
-
-    def __init__(self):
-        self._signed = _Credentials()
-
-        class GoogleCredentials(object):
-            @staticmethod
-            def get_application_default():
-                self._get_app_default_called = True
-                return self._signed
-
-        self.GoogleCredentials = GoogleCredentials
diff --git a/unit_tests/test_exceptions.py b/unit_tests/test_exceptions.py
deleted file mode 100644
index 506d2f772aa1..000000000000
--- a/unit_tests/test_exceptions.py
+++ /dev/null
@@ -1,93 +0,0 @@
-# Copyright 2014 Google Inc. 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.
-
-import unittest
-
-
-class Test_GoogleCloudError(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.exceptions import GoogleCloudError
-        return GoogleCloudError
-
-    def _makeOne(self, message, errors=()):
-        return self._getTargetClass()(message, errors=errors)
-
-    def test_ctor_defaults(self):
-        e = self._makeOne('Testing')
-        e.code = 600
-        self.assertEqual(str(e), '600 Testing')
-        self.assertEqual(e.message, 'Testing')
-        self.assertEqual(list(e.errors), [])
-
-    def test_ctor_explicit(self):
-        ERROR = {
-            'domain': 'global',
-            'location': 'test',
-            'locationType': 'testing',
-            'message': 'Testing',
-            'reason': 'test',
-            }
-        e = self._makeOne('Testing', [ERROR])
-        e.code = 600
-        self.assertEqual(str(e), '600 Testing')
-        self.assertEqual(e.message, 'Testing')
-        self.assertEqual(list(e.errors), [ERROR])
-
-
-class Test_make_exception(unittest.TestCase):
-
-    def _callFUT(self, response, content, error_info=None, use_json=True):
-        from google.cloud.exceptions import make_exception
-        return make_exception(response, content, error_info=error_info,
-                              use_json=use_json)
-
-    def test_hit_w_content_as_str(self):
-        from google.cloud.exceptions import NotFound
-        response = _Response(404)
-        content = b'{"error": {"message": "Not Found"}}'
-        exception = self._callFUT(response, content)
-        self.assertIsInstance(exception, NotFound)
-        self.assertEqual(exception.message, 'Not Found')
-        self.assertEqual(list(exception.errors), [])
-
-    def test_miss_w_content_as_dict(self):
-        from google.cloud.exceptions import GoogleCloudError
-        ERROR = {
-            'domain': 'global',
-            'location': 'test',
-            'locationType': 'testing',
-            'message': 'Testing',
-            'reason': 'test',
-            }
-        response = _Response(600)
-        content = {"error": {"message": "Unknown Error", "errors": [ERROR]}}
-        exception = self._callFUT(response, content)
-        self.assertIsInstance(exception, GoogleCloudError)
-        self.assertEqual(exception.message, 'Unknown Error')
-        self.assertEqual(list(exception.errors), [ERROR])
-
-    def test_html_when_json_expected(self):
-        from google.cloud.exceptions import NotFound
-        response = _Response(NotFound.code)
-        content = '<html><body>404 Not Found</body></html>'
-        exception = self._callFUT(response, content, use_json=True)
-        self.assertIsInstance(exception, NotFound)
-        self.assertEqual(exception.message, content)
-        self.assertEqual(list(exception.errors), [])
-
-
-class _Response(object):
-    def __init__(self, status):
-        self.status = status
diff --git a/unit_tests/test_iterator.py b/unit_tests/test_iterator.py
deleted file mode 100644
index fb647ec7709b..000000000000
--- a/unit_tests/test_iterator.py
+++ /dev/null
@@ -1,278 +0,0 @@
-# Copyright 2015 Google Inc. 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.
-
-import unittest
-
-
-class TestIterator(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.iterator import Iterator
-        return Iterator
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        iterator = self._makeOne(client, PATH)
-        self.assertIs(iterator.client, client)
-        self.assertEqual(iterator.path, PATH)
-        self.assertEqual(iterator.page_number, 0)
-        self.assertIsNone(iterator.next_page_token)
-
-    def test___iter__(self):
-        PATH = '/foo'
-        KEY1 = 'key1'
-        KEY2 = 'key2'
-        ITEM1, ITEM2 = object(), object()
-        ITEMS = {KEY1: ITEM1, KEY2: ITEM2}
-
-        def _get_items(response):
-            for item in response.get('items', []):
-                yield ITEMS[item['name']]
-        connection = _Connection({'items': [{'name': KEY1}, {'name': KEY2}]})
-        client = _Client(connection)
-        iterator = self._makeOne(client, PATH)
-        iterator.get_items_from_response = _get_items
-        self.assertEqual(list(iterator), [ITEM1, ITEM2])
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], PATH)
-        self.assertEqual(kw['query_params'], {})
-
-    def test_has_next_page_new(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        iterator = self._makeOne(client, PATH)
-        self.assertTrue(iterator.has_next_page())
-
-    def test_has_next_page_w_number_no_token(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        iterator = self._makeOne(client, PATH)
-        iterator.page_number = 1
-        self.assertFalse(iterator.has_next_page())
-
-    def test_has_next_page_w_number_w_token(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        TOKEN = 'token'
-        iterator = self._makeOne(client, PATH)
-        iterator.page_number = 1
-        iterator.next_page_token = TOKEN
-        self.assertTrue(iterator.has_next_page())
-
-    def test_get_query_params_no_token(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        iterator = self._makeOne(client, PATH)
-        self.assertEqual(iterator.get_query_params(), {})
-
-    def test_get_query_params_w_token(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        TOKEN = 'token'
-        iterator = self._makeOne(client, PATH)
-        iterator.next_page_token = TOKEN
-        self.assertEqual(iterator.get_query_params(),
-                         {'pageToken': TOKEN})
-
-    def test_get_query_params_extra_params(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        extra_params = {'key': 'val'}
-        iterator = self._makeOne(client, PATH, extra_params=extra_params)
-        self.assertEqual(iterator.get_query_params(), extra_params)
-
-    def test_get_query_params_w_token_and_extra_params(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        TOKEN = 'token'
-        extra_params = {'key': 'val'}
-        iterator = self._makeOne(client, PATH, extra_params=extra_params)
-        iterator.next_page_token = TOKEN
-
-        expected_query = extra_params.copy()
-        expected_query.update({'pageToken': TOKEN})
-        self.assertEqual(iterator.get_query_params(), expected_query)
-
-    def test_get_query_params_w_token_collision(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        extra_params = {'pageToken': 'val'}
-        self.assertRaises(ValueError, self._makeOne, client, PATH,
-                          extra_params=extra_params)
-
-    def test_get_next_page_response_new_no_token_in_response(self):
-        PATH = '/foo'
-        TOKEN = 'token'
-        KEY1 = 'key1'
-        KEY2 = 'key2'
-        connection = _Connection({'items': [{'name': KEY1}, {'name': KEY2}],
-                                  'nextPageToken': TOKEN})
-        client = _Client(connection)
-        iterator = self._makeOne(client, PATH)
-        response = iterator.get_next_page_response()
-        self.assertEqual(response['items'], [{'name': KEY1}, {'name': KEY2}])
-        self.assertEqual(iterator.page_number, 1)
-        self.assertEqual(iterator.next_page_token, TOKEN)
-        kw, = connection._requested
-        self.assertEqual(kw['method'], 'GET')
-        self.assertEqual(kw['path'], PATH)
-        self.assertEqual(kw['query_params'], {})
-
-    def test_get_next_page_response_no_token(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        iterator = self._makeOne(client, PATH)
-        iterator.page_number = 1
-        self.assertRaises(RuntimeError, iterator.get_next_page_response)
-
-    def test_reset(self):
-        connection = _Connection()
-        client = _Client(connection)
-        PATH = '/foo'
-        TOKEN = 'token'
-        iterator = self._makeOne(client, PATH)
-        iterator.page_number = 1
-        iterator.next_page_token = TOKEN
-        iterator.reset()
-        self.assertEqual(iterator.page_number, 0)
-        self.assertIsNone(iterator.next_page_token)
-
-    def test_get_items_from_response_raises_NotImplementedError(self):
-        PATH = '/foo'
-        connection = _Connection()
-        client = _Client(connection)
-        iterator = self._makeOne(client, PATH)
-        self.assertRaises(NotImplementedError,
-                          iterator.get_items_from_response, object())
-
-
-class TestMethodIterator(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.iterator import MethodIterator
-        return MethodIterator
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        wlm = _WithListMethod()
-        iterator = self._makeOne(wlm.list_foo)
-        self.assertEqual(iterator._method, wlm.list_foo)
-        self.assertIsNone(iterator._token)
-        self.assertIsNone(iterator._page_size)
-        self.assertEqual(iterator._kw, {})
-        self.assertIsNone(iterator._max_calls)
-        self.assertEqual(iterator._page_num, 0)
-
-    def test_ctor_explicit(self):
-        wlm = _WithListMethod()
-        TOKEN = wlm._letters
-        SIZE = 4
-        CALLS = 2
-        iterator = self._makeOne(wlm.list_foo, TOKEN, SIZE, CALLS,
-                                 foo_type='Bar')
-        self.assertEqual(iterator._method, wlm.list_foo)
-        self.assertEqual(iterator._token, TOKEN)
-        self.assertEqual(iterator._page_size, SIZE)
-        self.assertEqual(iterator._kw, {'foo_type': 'Bar'})
-        self.assertEqual(iterator._max_calls, CALLS)
-        self.assertEqual(iterator._page_num, 0)
-
-    def test___iter___defaults(self):
-        import string
-        wlm = _WithListMethod()
-        iterator = self._makeOne(wlm.list_foo)
-        found = []
-        for char in iterator:
-            found.append(char)
-        self.assertEqual(found, list(string.printable))
-        self.assertEqual(len(wlm._called_with), len(found) // 10)
-        for i, (token, size, kw) in enumerate(wlm._called_with):
-            if i == 0:
-                self.assertIsNone(token)
-            else:
-                self.assertEqual(token, string.printable[i * 10:])
-            self.assertIsNone(size)
-            self.assertEqual(kw, {})
-
-    def test___iter___explicit_size_and_maxcalls_and_kw(self):
-        import string
-        wlm = _WithListMethod()
-        iterator = self._makeOne(wlm.list_foo, page_size=2, max_calls=3,
-                                 foo_type='Bar')
-        found = []
-        for char in iterator:
-            found.append(char)
-        self.assertEqual(found, list(string.printable[:2 * 3]))
-        self.assertEqual(len(wlm._called_with), len(found) // 2)
-        for i, (token, size, kw) in enumerate(wlm._called_with):
-            if i == 0:
-                self.assertIsNone(token)
-            else:
-                self.assertEqual(token, string.printable[i * 2:])
-            self.assertEqual(size, 2)
-            self.assertEqual(kw, {'foo_type': 'Bar'})
-
-
-class _WithListMethod(object):
-
-    def __init__(self):
-        import string
-        self._called_with = []
-        self._letters = string.printable
-
-    def list_foo(self, page_token, page_size, **kw):
-        if page_token is not None:
-            assert page_token == self._letters
-        self._called_with.append((page_token, page_size, kw))
-        if page_size is None:
-            page_size = 10
-        page, self._letters = (
-            self._letters[:page_size], self._letters[page_size:])
-        token = self._letters or None
-        return page, token
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
-
-
-class _Client(object):
-
-    def __init__(self, connection):
-        self.connection = connection
diff --git a/unit_tests/test_operation.py b/unit_tests/test_operation.py
deleted file mode 100644
index f9984f9ad43c..000000000000
--- a/unit_tests/test_operation.py
+++ /dev/null
@@ -1,244 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class Test__compute_type_url(unittest.TestCase):
-
-    def _callFUT(self, klass, prefix=None):
-        from google.cloud.operation import _compute_type_url
-        if prefix is None:
-            return _compute_type_url(klass)
-        return _compute_type_url(klass, prefix)
-
-    def test_wo_prefix(self):
-        from google.protobuf.struct_pb2 import Struct
-        from google.cloud.operation import _GOOGLE_APIS_PREFIX
-
-        type_url = self._callFUT(Struct)
-
-        self.assertEqual(
-            type_url,
-            '%s/%s' % (_GOOGLE_APIS_PREFIX, Struct.DESCRIPTOR.full_name))
-
-    def test_w_prefix(self):
-        from google.protobuf.struct_pb2 import Struct
-        PREFIX = 'test.google-cloud-python.com'
-
-        type_url = self._callFUT(Struct, PREFIX)
-
-        self.assertEqual(
-            type_url,
-            '%s/%s' % (PREFIX, Struct.DESCRIPTOR.full_name))
-
-
-class Test__register_type_url(unittest.TestCase):
-
-    def _callFUT(self, type_url, klass):
-        from google.cloud.operation import _register_type_url
-        _register_type_url(type_url, klass)
-
-    def test_simple(self):
-        from google.cloud import operation as MUT
-        from unit_tests._testing import _Monkey
-        TYPE_URI = 'testing.google-cloud-python.com/testing'
-        klass = object()
-        type_url_map = {}
-
-        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
-            self._callFUT(TYPE_URI, klass)
-
-        self.assertEqual(type_url_map, {TYPE_URI: klass})
-
-    def test_w_same_class(self):
-        from google.cloud import operation as MUT
-        from unit_tests._testing import _Monkey
-        TYPE_URI = 'testing.google-cloud-python.com/testing'
-        klass = object()
-        type_url_map = {TYPE_URI: klass}
-
-        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
-            self._callFUT(TYPE_URI, klass)
-
-        self.assertEqual(type_url_map, {TYPE_URI: klass})
-
-    def test_w_conflict(self):
-        from google.cloud import operation as MUT
-        from unit_tests._testing import _Monkey
-        TYPE_URI = 'testing.google-cloud-python.com/testing'
-        klass, other = object(), object()
-        type_url_map = {TYPE_URI: other}
-
-        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
-            with self.assertRaises(ValueError):
-                self._callFUT(TYPE_URI, klass)
-
-        self.assertEqual(type_url_map, {TYPE_URI: other})
-
-
-class OperationTests(unittest.TestCase):
-
-    OPERATION_NAME = 'operations/projects/foo/instances/bar/operations/123'
-
-    def _getTargetClass(self):
-        from google.cloud.operation import Operation
-        return Operation
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor_defaults(self):
-        client = _Client()
-        operation = self._makeOne(
-            self.OPERATION_NAME, client)
-        self.assertEqual(operation.name, self.OPERATION_NAME)
-        self.assertIs(operation.client, client)
-        self.assertIsNone(operation.target)
-        self.assertIsNone(operation.pb_metadata)
-        self.assertEqual(operation.metadata, {})
-
-    def test_ctor_explicit(self):
-        client = _Client()
-        pb_metadata = object()
-        operation = self._makeOne(
-            self.OPERATION_NAME, client, pb_metadata, foo='bar')
-        self.assertEqual(operation.name, self.OPERATION_NAME)
-        self.assertIs(operation.client, client)
-        self.assertIsNone(operation.target)
-        self.assertIs(operation.pb_metadata, pb_metadata)
-        self.assertEqual(operation.metadata, {'foo': 'bar'})
-
-    def test_from_pb_wo_metadata_or_kw(self):
-        from google.longrunning import operations_pb2
-        client = _Client()
-        operation_pb = operations_pb2.Operation(name=self.OPERATION_NAME)
-        klass = self._getTargetClass()
-
-        operation = klass.from_pb(operation_pb, client)
-
-        self.assertEqual(operation.name, self.OPERATION_NAME)
-        self.assertIs(operation.client, client)
-        self.assertIsNone(operation.pb_metadata)
-        self.assertEqual(operation.metadata, {})
-
-    def test_from_pb_w_unknown_metadata(self):
-        from google.longrunning import operations_pb2
-        from google.protobuf.any_pb2 import Any
-        from google.protobuf.struct_pb2 import Struct, Value
-        TYPE_URI = 'type.googleapis.com/%s' % (Struct.DESCRIPTOR.full_name,)
-
-        client = _Client()
-        meta = Struct(fields={'foo': Value(string_value=u'Bar')})
-        metadata_pb = Any(type_url=TYPE_URI, value=meta.SerializeToString())
-        operation_pb = operations_pb2.Operation(
-            name=self.OPERATION_NAME, metadata=metadata_pb)
-        klass = self._getTargetClass()
-
-        operation = klass.from_pb(operation_pb, client)
-
-        self.assertEqual(operation.name, self.OPERATION_NAME)
-        self.assertIs(operation.client, client)
-        self.assertIsNone(operation.pb_metadata)
-        self.assertEqual(operation.metadata, {})
-
-    def test_from_pb_w_metadata_and_kwargs(self):
-        from google.longrunning import operations_pb2
-        from google.protobuf.any_pb2 import Any
-        from google.protobuf.struct_pb2 import Struct, Value
-        from google.cloud import operation as MUT
-        from unit_tests._testing import _Monkey
-        TYPE_URI = 'type.googleapis.com/%s' % (Struct.DESCRIPTOR.full_name,)
-        type_url_map = {TYPE_URI: Struct}
-
-        client = _Client()
-        meta = Struct(fields={'foo': Value(string_value=u'Bar')})
-        metadata_pb = Any(type_url=TYPE_URI, value=meta.SerializeToString())
-        operation_pb = operations_pb2.Operation(
-            name=self.OPERATION_NAME, metadata=metadata_pb)
-        klass = self._getTargetClass()
-
-        with _Monkey(MUT, _TYPE_URL_MAP=type_url_map):
-            operation = klass.from_pb(operation_pb, client, baz='qux')
-
-        self.assertEqual(operation.name, self.OPERATION_NAME)
-        self.assertIs(operation.client, client)
-        pb_metadata = operation.pb_metadata
-        self.assertIsInstance(pb_metadata, Struct)
-        self.assertEqual(list(pb_metadata.fields), ['foo'])
-        self.assertEqual(pb_metadata.fields['foo'].string_value, 'Bar')
-        self.assertEqual(operation.metadata, {'baz': 'qux'})
-
-    def test_complete_property(self):
-        client = _Client()
-        operation = self._makeOne(self.OPERATION_NAME, client)
-        self.assertFalse(operation.complete)
-        operation._complete = True
-        self.assertTrue(operation.complete)
-        with self.assertRaises(AttributeError):
-            operation.complete = False
-
-    def test_poll_already_complete(self):
-        client = _Client()
-        operation = self._makeOne(self.OPERATION_NAME, client)
-        operation._complete = True
-
-        with self.assertRaises(ValueError):
-            operation.poll()
-
-    def test_poll_false(self):
-        from google.longrunning.operations_pb2 import GetOperationRequest
-        response_pb = _GetOperationResponse(False)
-        client = _Client()
-        stub = client._operations_stub
-        stub._get_operation_response = response_pb
-        operation = self._makeOne(self.OPERATION_NAME, client)
-
-        self.assertFalse(operation.poll())
-
-        request_pb = stub._get_operation_requested
-        self.assertIsInstance(request_pb, GetOperationRequest)
-        self.assertEqual(request_pb.name, self.OPERATION_NAME)
-
-    def test_poll_true(self):
-        from google.longrunning.operations_pb2 import GetOperationRequest
-        response_pb = _GetOperationResponse(True)
-        client = _Client()
-        stub = client._operations_stub
-        stub._get_operation_response = response_pb
-        operation = self._makeOne(self.OPERATION_NAME, client)
-
-        self.assertTrue(operation.poll())
-
-        request_pb = stub._get_operation_requested
-        self.assertIsInstance(request_pb, GetOperationRequest)
-        self.assertEqual(request_pb.name, self.OPERATION_NAME)
-
-
-class _GetOperationResponse(object):
-    def __init__(self, done):
-        self.done = done
-
-
-class _OperationsStub(object):
-
-    def GetOperation(self, request_pb):
-        self._get_operation_requested = request_pb
-        return self._get_operation_response
-
-
-class _Client(object):
-
-    def __init__(self):
-        self._operations_stub = _OperationsStub()
diff --git a/unit_tests/translate/__init__.py b/unit_tests/translate/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/translate/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/translate/test_client.py b/unit_tests/translate/test_client.py
deleted file mode 100644
index a32c74b6368b..000000000000
--- a/unit_tests/translate/test_client.py
+++ /dev/null
@@ -1,378 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestClient(unittest.TestCase):
-
-    KEY = 'abc-123-my-key'
-
-    def _getTargetClass(self):
-        from google.cloud.translate.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        from google.cloud.translate.connection import Connection
-        from google.cloud.translate.client import ENGLISH_ISO_639
-
-        http = object()
-        client = self._makeOne(self.KEY, http=http)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertIsNone(client.connection.credentials)
-        self.assertIs(client.connection.http, http)
-        self.assertEqual(client.target_language, ENGLISH_ISO_639)
-
-    def test_ctor_non_default(self):
-        from google.cloud.translate.connection import Connection
-
-        http = object()
-        target = 'es'
-        client = self._makeOne(self.KEY, http=http, target_language=target)
-        self.assertIsInstance(client.connection, Connection)
-        self.assertIsNone(client.connection.credentials)
-        self.assertIs(client.connection.http, http)
-        self.assertEqual(client.target_language, target)
-
-    def test_get_languages(self):
-        from google.cloud.translate.client import ENGLISH_ISO_639
-
-        client = self._makeOne(self.KEY)
-        supported = [
-            {'language': 'en', 'name': 'English'},
-            {'language': 'af', 'name': 'Afrikaans'},
-            {'language': 'am', 'name': 'Amharic'},
-        ]
-        data = {
-            'data': {
-                'languages': supported,
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.get_languages()
-        self.assertEqual(result, supported)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/languages')
-        self.assertEqual(req['query_params'],
-                         {'key': self.KEY, 'target': ENGLISH_ISO_639})
-
-    def test_get_languages_no_target(self):
-        client = self._makeOne(self.KEY, target_language=None)
-        supported = [
-            {'language': 'en'},
-            {'language': 'af'},
-            {'language': 'am'},
-        ]
-        data = {
-            'data': {
-                'languages': supported,
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.get_languages()
-        self.assertEqual(result, supported)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/languages')
-        self.assertEqual(req['query_params'], {'key': self.KEY})
-
-    def test_get_languages_explicit_target(self):
-        client = self._makeOne(self.KEY)
-        target_language = 'en'
-        supported = [
-            {'language': 'en', 'name': 'Spanish'},
-            {'language': 'af', 'name': 'Afrikaans'},
-            {'language': 'am', 'name': 'Amharic'},
-        ]
-        data = {
-            'data': {
-                'languages': supported,
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.get_languages(target_language)
-        self.assertEqual(result, supported)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/languages')
-        self.assertEqual(req['query_params'],
-                         {'key': self.KEY, 'target': target_language})
-
-    def test_detect_language_bad_result(self):
-        client = self._makeOne(self.KEY)
-        value = 'takoy'
-        conn = client.connection = _Connection({})
-
-        with self.assertRaises(ValueError):
-            client.detect_language(value)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/detect')
-        query_params = [
-            ('key', self.KEY),
-            ('q', value.encode('utf-8')),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-    def test_detect_language_single_value(self):
-        client = self._makeOne(self.KEY)
-        value = 'takoy'
-        detection = {
-            'confidence': 1.0,
-            'input': value,
-            'language': 'ru',
-            'isReliable': False,
-        }
-        data = {
-            'data': {
-                'detections': [[detection]],
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.detect_language(value)
-        self.assertEqual(result, detection)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/detect')
-        query_params = [
-            ('key', self.KEY),
-            ('q', value.encode('utf-8')),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-    def test_detect_language_multiple_values(self):
-        client = self._makeOne(self.KEY)
-        value1 = u'fa\xe7ade'  # facade (with a cedilla)
-        detection1 = {
-            'confidence': 0.6166008,
-            'input': value1,
-            'isReliable': False,
-            'language': 'en',
-        }
-        value2 = 's\'il vous plait'
-        detection2 = {
-            'confidence': 0.29728225,
-            'input': value2,
-            'isReliable': False,
-            'language': 'fr',
-        }
-        data = {
-            'data': {
-                'detections': [
-                    [detection1],
-                    [detection2],
-                ],
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.detect_language([value1, value2])
-        self.assertEqual(result, [detection1, detection2])
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '/detect')
-        query_params = [
-            ('key', self.KEY),
-            ('q', value1.encode('utf-8')),
-            ('q', value2.encode('utf-8')),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-    def test_detect_language_multiple_results(self):
-        client = self._makeOne(self.KEY)
-        value = 'soy'
-        detection1 = {
-            'confidence': 0.81496066,
-            'input': value,
-            'language': 'es',
-            'isReliable': False,
-        }
-        detection2 = {
-            'confidence': 0.222,
-            'input': value,
-            'language': 'en',
-            'isReliable': False,
-        }
-        data = {
-            'data': {
-                'detections': [[detection1, detection2]],
-            },
-        }
-        client.connection = _Connection(data)
-
-        with self.assertRaises(ValueError):
-            client.detect_language(value)
-
-    def test_translate_bad_result(self):
-        client = self._makeOne(self.KEY)
-        value = 'hvala ti'
-        conn = client.connection = _Connection({})
-
-        with self.assertRaises(ValueError):
-            client.translate(value)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '')
-        query_params = [
-            ('key', self.KEY),
-            ('target', 'en'),
-            ('q', value.encode('utf-8')),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-    def test_translate_defaults(self):
-        client = self._makeOne(self.KEY)
-        value = 'hvala ti'
-        translation = {
-            'detectedSourceLanguage': 'hr',
-            'translatedText': 'thank you',
-            'input': value,
-        }
-        data = {
-            'data': {
-                'translations': [translation],
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.translate(value)
-        self.assertEqual(result, translation)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '')
-        query_params = [
-            ('key', self.KEY),
-            ('target', 'en'),
-            ('q', value.encode('utf-8')),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-    def test_translate_multiple(self):
-        client = self._makeOne(self.KEY)
-        value1 = 'hvala ti'
-        translation1 = {
-            'detectedSourceLanguage': 'hr',
-            'translatedText': 'thank you',
-            'input': value1,
-        }
-        value2 = 'Dankon'
-        translation2 = {
-            'detectedSourceLanguage': 'eo',
-            'translatedText': 'thank you',
-            'input': value2,
-        }
-        data = {
-            'data': {
-                'translations': [translation1, translation2],
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        result = client.translate([value1, value2])
-        self.assertEqual(result, [translation1, translation2])
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '')
-        query_params = [
-            ('key', self.KEY),
-            ('target', 'en'),
-            ('q', value1.encode('utf-8')),
-            ('q', value2.encode('utf-8')),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-    def test_translate_explicit(self):
-        client = self._makeOne(self.KEY)
-        value = 'thank you'
-        target_language = 'eo'
-        source_language = 'en'
-        translation = {
-            'translatedText': 'Dankon',
-            'input': value,
-        }
-        data = {
-            'data': {
-                'translations': [translation],
-            },
-        }
-        conn = client.connection = _Connection(data)
-
-        cid = '123'
-        format_ = 'text'
-        result = client.translate(value, target_language=target_language,
-                                  source_language=source_language,
-                                  format_=format_, customization_ids=cid)
-        self.assertEqual(result, translation)
-
-        # Verify requested.
-        self.assertEqual(len(conn._requested), 1)
-        req = conn._requested[0]
-        self.assertEqual(req['method'], 'GET')
-        self.assertEqual(req['path'], '')
-        query_params = [
-            ('key', self.KEY),
-            ('target', target_language),
-            ('q', value.encode('utf-8')),
-            ('cid', cid),
-            ('format', format_),
-            ('source', source_language),
-        ]
-        self.assertEqual(req['query_params'], query_params)
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/translate/test_connection.py b/unit_tests/translate/test_connection.py
deleted file mode 100644
index b9a16e01f276..000000000000
--- a/unit_tests/translate/test_connection.py
+++ /dev/null
@@ -1,51 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.translate.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_build_api_url_no_extra_query_params(self):
-        conn = self._makeOne()
-        URI = '/'.join([
-            conn.API_BASE_URL,
-            'language',
-            'translate',
-            conn.API_VERSION,
-            'foo',
-        ])
-        self.assertEqual(conn.build_api_url('/foo'), URI)
-
-    def test_build_api_url_w_extra_query_params(self):
-        from six.moves.urllib.parse import parse_qsl
-        from six.moves.urllib.parse import urlsplit
-        conn = self._makeOne()
-        query_params = [('q', 'val1'), ('q', 'val2')]
-        uri = conn.build_api_url('/foo', query_params=query_params)
-        scheme, netloc, path, qs, _ = urlsplit(uri)
-        self.assertEqual('%s://%s' % (scheme, netloc),
-                         conn.API_BASE_URL)
-        expected_path = '/'.join(
-            ['', 'language', 'translate', conn.API_VERSION, 'foo'])
-        self.assertEqual(path, expected_path)
-        params = parse_qsl(qs)
-        self.assertEqual(params, query_params)
diff --git a/unit_tests/vision/__init__.py b/unit_tests/vision/__init__.py
deleted file mode 100644
index c098733431fd..000000000000
--- a/unit_tests/vision/__init__.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright 2016 Google Inc. 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.
diff --git a/unit_tests/vision/_fixtures.py b/unit_tests/vision/_fixtures.py
deleted file mode 100644
index f30b69a18a63..000000000000
--- a/unit_tests/vision/_fixtures.py
+++ /dev/null
@@ -1,1768 +0,0 @@
-IMAGE_PROPERTIES_RESPONSE = {
-    'responses': [
-        {
-            'imagePropertiesAnnotation': {
-                'dominantColors': {
-                    'colors': [
-                        {
-                            'color': {
-                                'red': 253,
-                                'green': 203,
-                                'blue': 65,
-                                'alpha': 0.0
-                            },
-                            'score': 0.42258179,
-                            'pixelFraction': 0.025376344
-                        },
-                        {
-                            'color': {
-                                'red': 216,
-                                'green': 69,
-                                'blue': 56
-                            },
-                            'score': 0.34945792,
-                            'pixelFraction': 0.026093191
-                        },
-                        {
-                            'color': {
-                                'red': 79,
-                                'green': 142,
-                                'blue': 245
-                            },
-                            'score': 0.050921876,
-                            'pixelFraction': 0.014193549
-                        },
-                        {
-                            'color': {
-                                'red': 249,
-                                'green': 246,
-                                'blue': 246
-                            },
-                            'score': 0.0059412993,
-                            'pixelFraction': 0.86896056
-                        },
-                        {
-                            'color': {
-                                'red': 222,
-                                'green': 119,
-                                'blue': 51
-                            },
-                            'score': 0.0043299114,
-                            'pixelFraction': 0.00021505376
-                        },
-                        {
-                            'color': {
-                                'red': 226,
-                                'green': 138,
-                                'blue': 130
-                            },
-                            'score': 0.0038594988,
-                            'pixelFraction': 0.00086021505
-                        },
-                        {
-                            'color': {
-                                'red': 165,
-                                'green': 194,
-                                'blue': 243
-                            },
-                            'score': 0.0029492097,
-                            'pixelFraction': 0.0015053763
-                        },
-                        {
-                            'color': {
-                                'red': 231,
-                                'green': 169,
-                                'blue': 164
-                            },
-                            'score': 0.0017002203,
-                            'pixelFraction': 0.00043010752
-                        },
-                        {
-                            'color': {
-                                'red': 137,
-                                'green': 98,
-                                'blue': 142
-                            },
-                            'score': 0.0013974205,
-                            'pixelFraction': 0.00071684585
-                        },
-                        {
-                            'color': {
-                                'red': 239,
-                                'green': 179,
-                                'blue': 56
-                            },
-                            'score': 0.050473157,
-                            'pixelFraction': 0.0022222223
-                        }
-                    ]
-                }
-            }
-        }
-    ]
-}
-
-LABEL_DETECTION_RESPONSE = {
-    'responses': [
-        {
-            'labelAnnotations': [
-                {
-                    'mid': '/m/0k4j',
-                    'description': 'automobile',
-                    'score': 0.9776855
-                },
-                {
-                    'mid': '/m/07yv9',
-                    'description': 'vehicle',
-                    'score': 0.947987
-                },
-                {
-                    'mid': '/m/07r04',
-                    'description': 'truck',
-                    'score': 0.88429511
-                }
-            ]
-        }
-    ]
-}
-
-
-LANDMARK_DETECTION_RESPONSE = {
-    'responses': [
-        {
-            'landmarkAnnotations': [
-                {
-                    'mid': '/m/04gdr',
-                    'description': 'Louvre',
-                    'score': 0.67257267,
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 1075,
-                                'y': 49
-                            },
-                            {
-                                'x': 1494,
-                                'y': 49
-                            },
-                            {
-                                'x': 1494,
-                                'y': 307
-                            },
-                            {
-                                'x': 1075,
-                                'y': 307
-                            }
-                        ]
-                    },
-                    'locations': [
-                        {
-                            'latLng': {
-                                'latitude': 48.861013,
-                                'longitude': 2.335818
-                            }
-                        }
-                    ]
-                },
-                {
-                    'mid': '/m/094llg',
-                    'description': 'Louvre Pyramid',
-                    'score': 0.53734678,
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 227,
-                                'y': 274
-                            },
-                            {
-                                'x': 1471,
-                                'y': 274
-                            },
-                            {
-                                'x': 1471,
-                                'y': 624
-                            },
-                            {
-                                'x': 227,
-                                'y': 624
-                            }
-                        ]
-                    },
-                    'locations': [
-                        {
-                            'latLng': {
-                                'latitude': 48.860749,
-                                'longitude': 2.336312
-                            }
-                        }
-                    ]
-                }
-            ]
-        }
-    ]
-}
-
-LOGO_DETECTION_RESPONSE = {
-    'responses': [
-        {
-            'logoAnnotations': [
-                {
-                    'mid': '/m/05b5c',
-                    'description': 'Brand1',
-                    'score': 0.63192177,
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 78,
-                                'y': 162
-                            },
-                            {
-                                'x': 282,
-                                'y': 162
-                            },
-                            {
-                                'x': 282,
-                                'y': 211
-                            },
-                            {
-                                'x': 78,
-                                'y': 211
-                            }
-                        ]
-                    }
-                },
-                {
-                    'mid': '/m/0fpzzp',
-                    'description': 'Brand2',
-                    'score': 0.5492993,
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 310,
-                                'y': 209
-                            },
-                            {
-                                'x': 477,
-                                'y': 209
-                            },
-                            {
-                                'x': 477,
-                                'y': 282
-                            },
-                            {
-                                'x': 310,
-                                'y': 282
-                            }
-                        ]
-                    }
-                }
-            ]
-        }
-    ]
-}
-
-FACE_DETECTION_RESPONSE = {
-    'responses': [{
-        'faceAnnotations': [{
-            'headwearLikelihood': 'VERY_UNLIKELY',
-            'panAngle': 6.027647,
-            'underExposedLikelihood': 'VERY_UNLIKELY',
-            'landmarkingConfidence': 0.54453093,
-            'detectionConfidence': 0.9863683,
-            'joyLikelihood': 'VERY_LIKELY',
-            'landmarks': [{
-                'position': {
-                    'y': 482.69385,
-                    'x': 1004.8003,
-                    'z': 0.0016593217
-                },
-                'type': 'LEFT_EYE'
-            }, {
-                'position': {
-                    'y': 470.90149,
-                    'x': 1218.9751,
-                    'z': 20.597967
-                },
-                'type': 'RIGHT_EYE'
-            }, {
-                'position': {
-                    'y': 441.46521,
-                    'x': 934.25629,
-                    'z': -1.1400928
-                },
-                'type': 'LEFT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 449.2872,
-                    'x': 1059.306,
-                    'z': -47.195843
-                },
-                'type': 'RIGHT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 446.05408,
-                    'x': 1163.678,
-                    'z': -37.211197
-                },
-                'type': 'LEFT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 424.18341,
-                    'x': 1285.0209,
-                    'z': 34.844131
-                },
-                'type': 'RIGHT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 485.18387,
-                    'x': 1113.4325,
-                    'z': -32.579361
-                },
-                'type': 'MIDPOINT_BETWEEN_EYES'
-            }, {
-                'position': {
-                    'y': 620.27032,
-                    'x': 1122.5671,
-                    'z': -51.019524
-                },
-                'type': 'NOSE_TIP'
-            }, {
-                'position': {
-                    'y': 674.32526,
-                    'x': 1117.0417,
-                    'z': 17.330631
-                },
-                'type': 'UPPER_LIP'
-            }, {
-                'position': {
-                    'y': 737.29736,
-                    'x': 1115.7112,
-                    'z': 54.076469
-                },
-                'type': 'LOWER_LIP'
-            }, {
-                'position': {
-                    'y': 680.62927,
-                    'x': 1017.0475,
-                    'z': 72.948006
-                },
-                'type': 'MOUTH_LEFT'
-            }, {
-                'position': {
-                    'y': 681.53552,
-                    'x': 1191.5186,
-                    'z': 87.198334
-                },
-                'type': 'MOUTH_RIGHT'
-            }, {
-                'position': {
-                    'y': 702.3808,
-                    'x': 1115.4193,
-                    'z': 42.56889
-                },
-                'type': 'MOUTH_CENTER'
-            }, {
-                'position': {
-                    'y': 606.68555,
-                    'x': 1169.0006,
-                    'z': 33.98217
-                },
-                'type': 'NOSE_BOTTOM_RIGHT'
-            }, {
-                'position': {
-                    'y': 612.71509,
-                    'x': 1053.9476,
-                    'z': 23.409685
-                },
-                'type': 'NOSE_BOTTOM_LEFT'
-            }, {
-                'position': {
-                    'y': 634.95532,
-                    'x': 1116.6818,
-                    'z': 3.386874
-                },
-                'type': 'NOSE_BOTTOM_CENTER'
-            }, {
-                'position': {
-                    'y': 476.70197,
-                    'x': 1009.2689,
-                    'z': -16.84004
-                },
-                'type': 'LEFT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 491.64874,
-                    'x': 1049.3926,
-                    'z': 7.0493474
-                },
-                'type': 'LEFT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 499.426,
-                    'x': 1003.9925,
-                    'z': 3.5417991
-                },
-                'type': 'LEFT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 482.37302,
-                    'x': 964.48242,
-                    'z': 14.96223
-                },
-                'type': 'LEFT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 487.90195,
-                    'x': 1005.3607,
-                    'z': -4.7375555
-                },
-                'type': 'LEFT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 468.33276,
-                    'x': 1212.7329,
-                    'z': 3.5585577
-                },
-                'type': 'RIGHT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 470.92487,
-                    'x': 1251.7043,
-                    'z': 43.794273
-                },
-                'type': 'RIGHT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 486.98676,
-                    'x': 1217.4629,
-                    'z': 23.580008
-                },
-                'type': 'RIGHT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 482.41071,
-                    'x': 1173.4624,
-                    'z': 18.852427
-                },
-                'type': 'RIGHT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 479.32739,
-                    'x': 1213.9757,
-                    'z': 16.041821
-                },
-                'type': 'RIGHT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 424.38797,
-                    'x': 1001.2206,
-                    'z': -46.463905
-                },
-                'type': 'LEFT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 415.33655,
-                    'x': 1221.9457,
-                    'z': -24.29454
-                },
-                'type': 'RIGHT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 506.88251,
-                    'x': 851.96124,
-                    'z': 257.9054
-                },
-                'type': 'LEFT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 487.9679,
-                    'x': 1313.8328,
-                    'z': 304.29816
-                },
-                'type': 'RIGHT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 447.98254,
-                    'x': 1114.1573,
-                    'z': -50.620598
-                },
-                'type': 'FOREHEAD_GLABELLA'
-            }, {
-                'position': {
-                    'y': 815.3302,
-                    'x': 1113.27,
-                    'z': 109.69422
-                },
-                'type': 'CHIN_GNATHION'
-            }, {
-                'position': {
-                    'y': 656.20123,
-                    'x': 884.34106,
-                    'z': 223.19124
-                },
-                'type': 'CHIN_LEFT_GONION'
-            }, {
-                'position': {
-                    'y': 639.291,
-                    'x': 1301.2404,
-                    'z': 265.00647
-                },
-                'type': 'CHIN_RIGHT_GONION'
-            }],
-            'sorrowLikelihood': 'VERY_UNLIKELY',
-            'surpriseLikelihood': 'VERY_UNLIKELY',
-            'tiltAngle': -18.412321,
-            'angerLikelihood': 'VERY_UNLIKELY',
-            'boundingPoly': {
-                'vertices': [{
-                    'y': 58,
-                    'x': 748
-                }, {
-                    'y': 58,
-                    'x': 1430
-                }, {
-                    'y': 851,
-                    'x': 1430
-                }, {
-                    'y': 851,
-                    'x': 748
-                }]
-            },
-            'rollAngle': -0.43419784,
-            'blurredLikelihood': 'VERY_UNLIKELY',
-            'fdBoundingPoly': {
-                'vertices': [{
-                    'y': 310,
-                    'x': 845
-                }, {
-                    'y': 310,
-                    'x': 1379
-                }, {
-                    'y': 844,
-                    'x': 1379
-                }, {
-                    'y': 844,
-                    'x': 845
-                }]
-            }
-        }, {
-            'headwearLikelihood': 'VERY_UNLIKELY',
-            'panAngle': -12.609346,
-            'underExposedLikelihood': 'VERY_UNLIKELY',
-            'landmarkingConfidence': 0.56890666,
-            'detectionConfidence': 0.96333671,
-            'joyLikelihood': 'VERY_LIKELY',
-            'landmarks': [{
-                'position': {
-                    'y': 604.24847,
-                    'x': 1655.8817,
-                    'z': -0.0023633335
-                },
-                'type': 'LEFT_EYE'
-            }, {
-                'position': {
-                    'y': 590.82428,
-                    'x': 1797.3677,
-                    'z': -30.984835
-                },
-                'type': 'RIGHT_EYE'
-            }, {
-                'position': {
-                    'y': 574.40173,
-                    'x': 1609.9617,
-                    'z': 14.634346
-                },
-                'type': 'LEFT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 576.57483,
-                    'x': 1682.0824,
-                    'z': -41.733879
-                },
-                'type': 'RIGHT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 571.701,
-                    'x': 1749.7633,
-                    'z': -56.105503
-                },
-                'type': 'LEFT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 556.67511,
-                    'x': 1837.4333,
-                    'z': -35.228374
-                },
-                'type': 'RIGHT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 600.41345,
-                    'x': 1720.1719,
-                    'z': -44.4393
-                },
-                'type': 'MIDPOINT_BETWEEN_EYES'
-            }, {
-                'position': {
-                    'y': 691.66907,
-                    'x': 1720.0095,
-                    'z': -63.878113
-                },
-                'type': 'NOSE_TIP'
-            }, {
-                'position': {
-                    'y': 731.63239,
-                    'x': 1733.2758,
-                    'z': -20.964622
-                },
-                'type': 'UPPER_LIP'
-            }, {
-                'position': {
-                    'y': 774.79138,
-                    'x': 1740.1494,
-                    'z': -0.038273316
-                },
-                'type': 'LOWER_LIP'
-            }, {
-                'position': {
-                    'y': 739.80981,
-                    'x': 1673.0156,
-                    'z': 35.655769
-                },
-                'type': 'MOUTH_LEFT'
-            }, {
-                'position': {
-                    'y': 728.8186,
-                    'x': 1808.8899,
-                    'z': 9.5512733
-                },
-                'type': 'MOUTH_RIGHT'
-            }, {
-                'position': {
-                    'y': 753.71118,
-                    'x': 1738.0863,
-                    'z': -5.2711153
-                },
-                'type': 'MOUTH_CENTER'
-            }, {
-                'position': {
-                    'y': 684.97522,
-                    'x': 1770.2415,
-                    'z': -18.243216
-                },
-                'type': 'NOSE_BOTTOM_RIGHT'
-            }, {
-                'position': {
-                    'y': 695.69922,
-                    'x': 1693.4669,
-                    'z': -0.6566487
-                },
-                'type': 'NOSE_BOTTOM_LEFT'
-            }, {
-                'position': {
-                    'y': 704.46063,
-                    'x': 1729.86,
-                    'z': -28.144602
-                },
-                'type': 'NOSE_BOTTOM_CENTER'
-            }, {
-                'position': {
-                    'y': 597.93713,
-                    'x': 1654.082,
-                    'z': -11.508363
-                },
-                'type': 'LEFT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 605.889,
-                    'x': 1684.0094,
-                    'z': -5.0379925
-                },
-                'type': 'LEFT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 614.40448,
-                    'x': 1656.4753,
-                    'z': 1.001922
-                },
-                'type': 'LEFT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 604.11292,
-                    'x': 1632.2733,
-                    'z': 18.163708
-                },
-                'type': 'LEFT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 606.02026,
-                    'x': 1654.1372,
-                    'z': -3.3510325
-                },
-                'type': 'LEFT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 588.00885,
-                    'x': 1790.3329,
-                    'z': -41.150127
-                },
-                'type': 'RIGHT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 590.46307,
-                    'x': 1824.5522,
-                    'z': -23.20849
-                },
-                'type': 'RIGHT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 601.75946,
-                    'x': 1797.9852,
-                    'z': -29.095766
-                },
-                'type': 'RIGHT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 598.66449,
-                    'x': 1768.7595,
-                    'z': -23.117319
-                },
-                'type': 'RIGHT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 595.84918,
-                    'x': 1794.0195,
-                    'z': -33.897068
-                },
-                'type': 'RIGHT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 561.08679,
-                    'x': 1641.9266,
-                    'z': -26.653444
-                },
-                'type': 'LEFT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 550.38129,
-                    'x': 1789.6267,
-                    'z': -58.874447
-                },
-                'type': 'RIGHT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 632.54456,
-                    'x': 1611.1659,
-                    'z': 198.83691
-                },
-                'type': 'LEFT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 610.1615,
-                    'x': 1920.511,
-                    'z': 131.28908
-                },
-                'type': 'RIGHT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 574.28448,
-                    'x': 1714.6324,
-                    'z': -54.497036
-                },
-                'type': 'FOREHEAD_GLABELLA'
-            }, {
-                'position': {
-                    'y': 830.93884,
-                    'x': 1752.2703,
-                    'z': 33.332912
-                },
-                'type': 'CHIN_GNATHION'
-            }, {
-                'position': {
-                    'y': 732.33936,
-                    'x': 1626.519,
-                    'z': 162.6319
-                },
-                'type': 'CHIN_LEFT_GONION'
-            }, {
-                'position': {
-                    'y': 712.21118,
-                    'x': 1905.7007,
-                    'z': 101.86344
-                },
-                'type': 'CHIN_RIGHT_GONION'
-            }],
-            'sorrowLikelihood': 'VERY_UNLIKELY',
-            'surpriseLikelihood': 'VERY_UNLIKELY',
-            'tiltAngle': -13.636207,
-            'angerLikelihood': 'VERY_UNLIKELY',
-            'boundingPoly': {
-                'vertices': [{
-                    'y': 319,
-                    'x': 1524
-                }, {
-                    'y': 319,
-                    'x': 1959
-                }, {
-                    'y': 859,
-                    'x': 1959
-                }, {
-                    'y': 859,
-                    'x': 1524
-                }]
-            },
-            'rollAngle': -7.1766233,
-            'blurredLikelihood': 'VERY_UNLIKELY',
-            'fdBoundingPoly': {
-                'vertices': [{
-                    'y': 485,
-                    'x': 1559
-                }, {
-                    'y': 485,
-                    'x': 1920
-                }, {
-                    'y': 846,
-                    'x': 1920
-                }, {
-                    'y': 846,
-                    'x': 1559
-                }]
-            }
-        }, {
-            'headwearLikelihood': 'VERY_UNLIKELY',
-            'panAngle': 8.7634687,
-            'underExposedLikelihood': 'VERY_UNLIKELY',
-            'landmarkingConfidence': 0.45491594,
-            'detectionConfidence': 0.98870116,
-            'joyLikelihood': 'VERY_LIKELY',
-            'landmarks': [{
-                'position': {
-                    'y': 678.57886,
-                    'x': 397.22269,
-                    'z': 0.00052442803
-                },
-                'type': 'LEFT_EYE'
-            }, {
-                'position': {
-                    'y': 671.90381,
-                    'x': 515.38159,
-                    'z': 17.843918
-                },
-                'type': 'RIGHT_EYE'
-            }, {
-                'position': {
-                    'y': 657.13904,
-                    'x': 361.41068,
-                    'z': 6.1270714
-                },
-                'type': 'LEFT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 649.82916,
-                    'x': 432.9726,
-                    'z': -16.12303
-                },
-                'type': 'RIGHT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 646.04272,
-                    'x': 487.78485,
-                    'z': -7.638854
-                },
-                'type': 'LEFT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 642.4032,
-                    'x': 549.46954,
-                    'z': 35.154259
-                },
-                'type': 'RIGHT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 672.44031,
-                    'x': 462.86993,
-                    'z': -14.413016
-                },
-                'type': 'MIDPOINT_BETWEEN_EYES'
-            }, {
-                'position': {
-                    'y': 736.5896,
-                    'x': 474.0661,
-                    'z': -50.206612
-                },
-                'type': 'NOSE_TIP'
-            }, {
-                'position': {
-                    'y': 775.34973,
-                    'x': 472.54224,
-                    'z': -25.24843
-                },
-                'type': 'UPPER_LIP'
-            }, {
-                'position': {
-                    'y': 820.41418,
-                    'x': 474.41162,
-                    'z': -18.226196
-                },
-                'type': 'LOWER_LIP'
-            }, {
-                'position': {
-                    'y': 797.35547,
-                    'x': 415.29095,
-                    'z': 0.069621459
-                },
-                'type': 'MOUTH_LEFT'
-            }, {
-                'position': {
-                    'y': 786.58917,
-                    'x': 519.26709,
-                    'z': 13.945135
-                },
-                'type': 'MOUTH_RIGHT'
-            }, {
-                'position': {
-                    'y': 798.462,
-                    'x': 472.48071,
-                    'z': -17.317541
-                },
-                'type': 'MOUTH_CENTER'
-            }, {
-                'position': {
-                    'y': 742.13464,
-                    'x': 498.90826,
-                    'z': -1.8338414
-                },
-                'type': 'NOSE_BOTTOM_RIGHT'
-            }, {
-                'position': {
-                    'y': 747.218,
-                    'x': 438.95078,
-                    'z': -11.851667
-                },
-                'type': 'NOSE_BOTTOM_LEFT'
-            }, {
-                'position': {
-                    'y': 754.20105,
-                    'x': 472.47375,
-                    'z': -24.760784
-                },
-                'type': 'NOSE_BOTTOM_CENTER'
-            }, {
-                'position': {
-                    'y': 672.1994,
-                    'x': 403.39957,
-                    'z': -6.9005938
-                },
-                'type': 'LEFT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 679.914,
-                    'x': 425.36029,
-                    'z': 4.3264537
-                },
-                'type': 'LEFT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 687.11792,
-                    'x': 401.66464,
-                    'z': -0.79697126
-                },
-                'type': 'LEFT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 682.9585,
-                    'x': 378.93005,
-                    'z': 7.3909378
-                },
-                'type': 'LEFT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 680.40326,
-                    'x': 401.7229,
-                    'z': -2.7444897
-                },
-                'type': 'LEFT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 663.39496,
-                    'x': 516.03217,
-                    'z': 10.454485
-                },
-                'type': 'RIGHT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 670.74463,
-                    'x': 536.45978,
-                    'z': 31.652559
-                },
-                'type': 'RIGHT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 679.21289,
-                    'x': 517.50879,
-                    'z': 16.653259
-                },
-                'type': 'RIGHT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 676.06976,
-                    'x': 495.27335,
-                    'z': 14.956539
-                },
-                'type': 'RIGHT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 671.41052,
-                    'x': 517.3429,
-                    'z': 15.007857
-                },
-                'type': 'RIGHT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 639.23633,
-                    'x': 396.8494,
-                    'z': -12.132922
-                },
-                'type': 'LEFT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 629.66724,
-                    'x': 518.96332,
-                    'z': 6.7055798
-                },
-                'type': 'RIGHT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 750.20837,
-                    'x': 313.60855,
-                    'z': 127.8474
-                },
-                'type': 'LEFT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 728.68243,
-                    'x': 570.95,
-                    'z': 166.43564
-                },
-                'type': 'RIGHT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 646.05042,
-                    'x': 460.94397,
-                    'z': -16.196959
-                },
-                'type': 'FOREHEAD_GLABELLA'
-            }, {
-                'position': {
-                    'y': 869.36255,
-                    'x': 476.69009,
-                    'z': -4.4716644
-                },
-                'type': 'CHIN_GNATHION'
-            }, {
-                'position': {
-                    'y': 818.48083,
-                    'x': 340.65454,
-                    'z': 80.163544
-                },
-                'type': 'CHIN_LEFT_GONION'
-            }, {
-                'position': {
-                    'y': 800.17029,
-                    'x': 571.60297,
-                    'z': 115.88489
-                },
-                'type': 'CHIN_RIGHT_GONION'
-            }],
-            'sorrowLikelihood': 'VERY_UNLIKELY',
-            'surpriseLikelihood': 'VERY_UNLIKELY',
-            'tiltAngle': 2.1818738,
-            'angerLikelihood': 'VERY_UNLIKELY',
-            'boundingPoly': {
-                'vertices': [{
-                    'y': 481,
-                    'x': 257
-                }, {
-                    'y': 481,
-                    'x': 636
-                }, {
-                    'y': 922,
-                    'x': 636
-                }, {
-                    'y': 922,
-                    'x': 257
-                }]
-            },
-            'rollAngle': -4.8415074,
-            'blurredLikelihood': 'VERY_UNLIKELY',
-            'fdBoundingPoly': {
-                'vertices': [{
-                    'y': 597,
-                    'x': 315
-                }, {
-                    'y': 597,
-                    'x': 593
-                }, {
-                    'y': 874,
-                    'x': 593
-                }, {
-                    'y': 874,
-                    'x': 315
-                }]
-            }
-        }, {
-            'headwearLikelihood': 'VERY_UNLIKELY',
-            'panAngle': 13.486016,
-            'underExposedLikelihood': 'VERY_UNLIKELY',
-            'landmarkingConfidence': 0.22890881,
-            'detectionConfidence': 0.91653949,
-            'joyLikelihood': 'LIKELY',
-            'landmarks': [{
-                'position': {
-                    'y': 549.30334,
-                    'x': 9.7225485,
-                    'z': 0.0014079071
-                },
-                'type': 'LEFT_EYE'
-            }, {
-                'position': {
-                    'y': 539.7489,
-                    'x': 128.87411,
-                    'z': 28.692257
-                },
-                'type': 'RIGHT_EYE'
-            }, {
-                'position': {
-                    'y': 523.62103,
-                    'x': -35.406662,
-                    'z': -0.67885911
-                },
-                'type': 'LEFT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 519.99487,
-                    'x': 42.973644,
-                    'z': -18.105515
-                },
-                'type': 'RIGHT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 514.23407,
-                    'x': 103.02193,
-                    'z': -4.1667485
-                },
-                'type': 'LEFT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 505.69614,
-                    'x': 165.63609,
-                    'z': 47.583176
-                },
-                'type': 'RIGHT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 540.9787,
-                    'x': 76.066139,
-                    'z': -11.183347
-                },
-                'type': 'MIDPOINT_BETWEEN_EYES'
-            }, {
-                'position': {
-                    'y': 615.48669,
-                    'x': 89.695564,
-                    'z': -41.252846
-                },
-                'type': 'NOSE_TIP'
-            }, {
-                'position': {
-                    'y': 658.39246,
-                    'x': 85.935593,
-                    'z': -9.70177
-                },
-                'type': 'UPPER_LIP'
-            }, {
-                'position': {
-                    'y': 703.04309,
-                    'x': 87.266853,
-                    'z': 2.6370313
-                },
-                'type': 'LOWER_LIP'
-            }, {
-                'position': {
-                    'y': 678.54712,
-                    'x': 31.584759,
-                    'z': 12.874522
-                },
-                'type': 'MOUTH_LEFT'
-            }, {
-                'position': {
-                    'y': 670.44092,
-                    'x': 126.54009,
-                    'z': 35.510525
-                },
-                'type': 'MOUTH_RIGHT'
-            }, {
-                'position': {
-                    'y': 677.92883,
-                    'x': 85.152267,
-                    'z': 0.89151889
-                },
-                'type': 'MOUTH_CENTER'
-            }, {
-                'position': {
-                    'y': 618.41052,
-                    'x': 112.767,
-                    'z': 14.021111
-                },
-                'type': 'NOSE_BOTTOM_RIGHT'
-            }, {
-                'position': {
-                    'y': 624.28644,
-                    'x': 45.776546,
-                    'z': -2.0218573
-                },
-                'type': 'NOSE_BOTTOM_LEFT'
-            }, {
-                'position': {
-                    'y': 632.9657,
-                    'x': 84.253586,
-                    'z': -12.025499
-                },
-                'type': 'NOSE_BOTTOM_CENTER'
-            }, {
-                'position': {
-                    'y': 541.79987,
-                    'x': 11.081995,
-                    'z': -8.7047234
-                },
-                'type': 'LEFT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 549.57306,
-                    'x': 35.396069,
-                    'z': 6.4817863
-                },
-                'type': 'LEFT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 557.55121,
-                    'x': 10.446005,
-                    'z': -0.37798333
-                },
-                'type': 'LEFT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 551.75134,
-                    'x': -16.862394,
-                    'z': 5.4017038
-                },
-                'type': 'LEFT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 550.14355,
-                    'x': 8.5758247,
-                    'z': -3.3803346
-                },
-                'type': 'LEFT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 531.02594,
-                    'x': 131.48265,
-                    'z': 20.201307
-                },
-                'type': 'RIGHT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 536.71674,
-                    'x': 151.31306,
-                    'z': 45.753532
-                },
-                'type': 'RIGHT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 547.00037,
-                    'x': 130.27722,
-                    'z': 28.447813
-                },
-                'type': 'RIGHT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 542.38531,
-                    'x': 106.59242,
-                    'z': 23.77187
-                },
-                'type': 'RIGHT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 539.12781,
-                    'x': 132.16141,
-                    'z': 26.180428
-                },
-                'type': 'RIGHT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 506.64093,
-                    'x': 4.8589344,
-                    'z': -18.679537
-                },
-                'type': 'LEFT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 494.94244,
-                    'x': 135.53185,
-                    'z': 12.703153
-                },
-                'type': 'RIGHT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 609.03503,
-                    'x': -98.89212,
-                    'z': 134.96341
-                },
-                'type': 'LEFT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 584.60681,
-                    'x': 174.55208,
-                    'z': 200.56409
-                },
-                'type': 'RIGHT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 514.88513,
-                    'x': 74.575394,
-                    'z': -15.91002
-                },
-                'type': 'FOREHEAD_GLABELLA'
-            }, {
-                'position': {
-                    'y': 755.372,
-                    'x': 86.603539,
-                    'z': 23.596317
-                },
-                'type': 'CHIN_GNATHION'
-            }, {
-                'position': {
-                    'y': 689.8385,
-                    'x': -67.949554,
-                    'z': 94.833694
-                },
-                'type': 'CHIN_LEFT_GONION'
-            }, {
-                'position': {
-                    'y': 667.89325,
-                    'x': 179.19363,
-                    'z': 154.18192
-                },
-                'type': 'CHIN_RIGHT_GONION'
-            }],
-            'sorrowLikelihood': 'VERY_UNLIKELY',
-            'surpriseLikelihood': 'VERY_UNLIKELY',
-            'tiltAngle': -4.1819687,
-            'angerLikelihood': 'VERY_UNLIKELY',
-            'boundingPoly': {
-                'vertices': [{
-                    'y': 322
-                }, {
-                    'y': 322,
-                    'x': 252
-                }, {
-                    'y': 800,
-                    'x': 252
-                }, {
-                    'y': 800
-                }]
-            },
-            'rollAngle': -4.1248608,
-            'blurredLikelihood': 'LIKELY',
-            'fdBoundingPoly': {
-                'vertices': [{
-                    'y': 450
-                }, {
-                    'y': 450,
-                    'x': 235
-                }, {
-                    'y': 745,
-                    'x': 235
-                }, {
-                    'y': 745
-                }]
-            }
-        }, {
-            'headwearLikelihood': 'VERY_UNLIKELY',
-            'panAngle': 4.0344138,
-            'underExposedLikelihood': 'VERY_UNLIKELY',
-            'landmarkingConfidence': 0.16798845,
-            'detectionConfidence': 0.7605139,
-            'joyLikelihood': 'VERY_LIKELY',
-            'landmarks': [{
-                'position': {
-                    'y': 637.85211,
-                    'x': 676.09375,
-                    'z': 4.3306696e-05
-                },
-                'type': 'LEFT_EYE'
-            }, {
-                'position': {
-                    'y': 637.43292,
-                    'x': 767.7132,
-                    'z': 6.4413033
-                },
-                'type': 'RIGHT_EYE'
-            }, {
-                'position': {
-                    'y': 614.27075,
-                    'x': 642.07782,
-                    'z': 3.731837
-                },
-                'type': 'LEFT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 617.27216,
-                    'x': 700.90112,
-                    'z': -19.774208
-                },
-                'type': 'RIGHT_OF_LEFT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 617.15649,
-                    'x': 747.60974,
-                    'z': -16.511871
-                },
-                'type': 'LEFT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 614.018,
-                    'x': 802.60638,
-                    'z': 14.954031
-                },
-                'type': 'RIGHT_OF_RIGHT_EYEBROW'
-            }, {
-                'position': {
-                    'y': 638.11755,
-                    'x': 724.42511,
-                    'z': -16.930967
-                },
-                'type': 'MIDPOINT_BETWEEN_EYES'
-            }, {
-                'position': {
-                    'y': 696.08392,
-                    'x': 725.82532,
-                    'z': -38.252609
-                },
-                'type': 'NOSE_TIP'
-            }, {
-                'position': {
-                    'y': 727.826,
-                    'x': 724.0116,
-                    'z': -11.615328
-                },
-                'type': 'UPPER_LIP'
-            }, {
-                'position': {
-                    'y': 760.22595,
-                    'x': 723.30157,
-                    'z': -0.454926
-                },
-                'type': 'LOWER_LIP'
-            }, {
-                'position': {
-                    'y': 738.67548,
-                    'x': 684.35724,
-                    'z': 13.192401
-                },
-                'type': 'MOUTH_LEFT'
-            }, {
-                'position': {
-                    'y': 738.53015,
-                    'x': 759.91022,
-                    'z': 18.485643
-                },
-                'type': 'MOUTH_RIGHT'
-            }, {
-                'position': {
-                    'y': 742.42737,
-                    'x': 723.45239,
-                    'z': -2.4991846
-                },
-                'type': 'MOUTH_CENTER'
-            }, {
-                'position': {
-                    'y': 698.4281,
-                    'x': 749.50385,
-                    'z': 1.1831931
-                },
-                'type': 'NOSE_BOTTOM_RIGHT'
-            }, {
-                'position': {
-                    'y': 698.48151,
-                    'x': 696.923,
-                    'z': -2.4809308
-                },
-                'type': 'NOSE_BOTTOM_LEFT'
-            }, {
-                'position': {
-                    'y': 708.10651,
-                    'x': 724.18506,
-                    'z': -14.418536
-                },
-                'type': 'NOSE_BOTTOM_CENTER'
-            }, {
-                'position': {
-                    'y': 632.12128,
-                    'x': 675.22388,
-                    'z': -7.2390652
-                },
-                'type': 'LEFT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 638.59021,
-                    'x': 694.03516,
-                    'z': 1.7715795
-                },
-                'type': 'LEFT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 644.33356,
-                    'x': 674.92206,
-                    'z': -0.037067439
-                },
-                'type': 'LEFT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 637.16479,
-                    'x': 655.035,
-                    'z': 7.4372306
-                },
-                'type': 'LEFT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 638.18683,
-                    'x': 673.39447,
-                    'z': -2.4558623
-                },
-                'type': 'LEFT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 631.96063,
-                    'x': 771.31744,
-                    'z': -0.51439536
-                },
-                'type': 'RIGHT_EYE_TOP_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 636.94287,
-                    'x': 789.29443,
-                    'z': 16.814001
-                },
-                'type': 'RIGHT_EYE_RIGHT_CORNER'
-            }, {
-                'position': {
-                    'y': 644.21619,
-                    'x': 770.13458,
-                    'z': 6.6525826
-                },
-                'type': 'RIGHT_EYE_BOTTOM_BOUNDARY'
-            }, {
-                'position': {
-                    'y': 638.75732,
-                    'x': 752.51831,
-                    'z': 5.8927159
-                },
-                'type': 'RIGHT_EYE_LEFT_CORNER'
-            }, {
-                'position': {
-                    'y': 638.06738,
-                    'x': 772.04718,
-                    'z': 4.350193
-                },
-                'type': 'RIGHT_EYE_PUPIL'
-            }, {
-                'position': {
-                    'y': 604.87769,
-                    'x': 671.68707,
-                    'z': -15.778968
-                },
-                'type': 'LEFT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 604.71191,
-                    'x': 775.98663,
-                    'z': -8.4828024
-                },
-                'type': 'RIGHT_EYEBROW_UPPER_MIDPOINT'
-            }, {
-                'position': {
-                    'y': 670.40063,
-                    'x': 605.07721,
-                    'z': 119.27386
-                },
-                'type': 'LEFT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 669.99823,
-                    'x': 823.42841,
-                    'z': 134.54482
-                },
-                'type': 'RIGHT_EAR_TRAGION'
-            }, {
-                'position': {
-                    'y': 616.47058,
-                    'x': 724.54547,
-                    'z': -21.861612
-                },
-                'type': 'FOREHEAD_GLABELLA'
-            }, {
-                'position': {
-                    'y': 801.31934,
-                    'x': 722.071,
-                    'z': 18.37034
-                },
-                'type': 'CHIN_GNATHION'
-            }, {
-                'position': {
-                    'y': 736.57159,
-                    'x': 617.91388,
-                    'z': 88.713562
-                },
-                'type': 'CHIN_LEFT_GONION'
-            }, {
-                'position': {
-                    'y': 736.21118,
-                    'x': 815.234,
-                    'z': 102.52047
-                },
-                'type': 'CHIN_RIGHT_GONION'
-            }],
-            'sorrowLikelihood': 'VERY_UNLIKELY',
-            'surpriseLikelihood': 'VERY_UNLIKELY',
-            'tiltAngle': -7.0173812,
-            'angerLikelihood': 'VERY_UNLIKELY',
-            'boundingPoly': {
-                'vertices': [{
-                    'y': 459,
-                    'x': 557
-                }, {
-                    'y': 459,
-                    'x': 875
-                }, {
-                    'y': 829,
-                    'x': 875
-                }, {
-                    'y': 829,
-                    'x': 557
-                }]
-            },
-            'rollAngle': 0.38634345,
-            'blurredLikelihood': 'LIKELY',
-            'fdBoundingPoly': {
-                'vertices': [{
-                    'y': 570,
-                    'x': 612
-                }, {
-                    'y': 570,
-                    'x': 837
-                }, {
-                    'y': 795,
-                    'x': 837
-                }, {
-                    'y': 795,
-                    'x': 612
-                }]
-            }
-        }]
-    }]
-}
-
-
-SAFE_SEARCH_DETECTION_RESPONSE = {
-    'responses': [
-        {
-            'safeSearchAnnotation': {
-                'adult': 'VERY_UNLIKELY',
-                'spoof': 'UNLIKELY',
-                'medical': 'POSSIBLE',
-                'violence': 'VERY_UNLIKELY'
-            }
-        }
-    ]
-}
-
-
-TEXT_DETECTION_RESPONSE = {
-    'responses': [
-        {
-            'textAnnotations': [
-                {
-                    'locale': 'en',
-                    'description': 'Google CloudPlatform\n',
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 129,
-                                'y': 694
-                            },
-                            {
-                                'x': 1375,
-                                'y': 694
-                            },
-                            {
-                                'x': 1375,
-                                'y': 835
-                            },
-                            {
-                                'x': 129,
-                                'y': 835
-                            }
-                        ]
-                    }
-                },
-                {
-                    'description': 'Google',
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 129,
-                                'y': 694
-                            },
-                            {
-                                'x': 535,
-                                'y': 694
-                            },
-                            {
-                                'x': 535,
-                                'y': 835
-                            },
-                            {
-                                'x': 129,
-                                'y': 835
-                            }
-                        ]
-                    }
-                },
-                {
-                    'description': 'CloudPlatform',
-                    'boundingPoly': {
-                        'vertices': [
-                            {
-                                'x': 567,
-                                'y': 694
-                            },
-                            {
-                                'x': 1375,
-                                'y': 694
-                            },
-                            {
-                                'x': 1375,
-                                'y': 835
-                            },
-                            {
-                                'x': 567,
-                                'y': 835
-                            }
-                        ]
-                    }
-                }
-            ]
-        }
-    ]
-}
diff --git a/unit_tests/vision/test_client.py b/unit_tests/vision/test_client.py
deleted file mode 100644
index 8e7a9685bef2..000000000000
--- a/unit_tests/vision/test_client.py
+++ /dev/null
@@ -1,320 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-
-import unittest
-
-from google.cloud._helpers import _to_bytes
-
-_IMAGE_CONTENT = _to_bytes('/9j/4QNURXhpZgAASUkq')
-_IMAGE_SOURCE = 'gs://some/image.jpg'
-
-
-class TestClient(unittest.TestCase):
-    import base64
-    PROJECT = 'PROJECT'
-    B64_IMAGE_CONTENT = base64.b64encode(_IMAGE_CONTENT)
-
-    def _getTargetClass(self):
-        from google.cloud.vision.client import Client
-        return Client
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_ctor(self):
-        creds = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=creds)
-        self.assertEqual(client.project, self.PROJECT)
-
-    def test_face_annotation(self):
-        from google.cloud.vision.feature import Feature, FeatureTypes
-        from unit_tests.vision._fixtures import FACE_DETECTION_RESPONSE
-
-        RETURNED = FACE_DETECTION_RESPONSE
-        REQUEST = {
-            "requests": [
-                {
-                    "image": {
-                        "content": self.B64_IMAGE_CONTENT
-                    },
-                    "features": [
-                        {
-                            "maxResults": 3,
-                            "type": "FACE_DETECTION"
-                        }
-                    ]
-                }
-            ]
-        }
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        features = [Feature(feature_type=FeatureTypes.FACE_DETECTION,
-                            max_results=3)]
-        image = client.image(content=_IMAGE_CONTENT)
-        response = client.annotate(image, features)
-
-        self.assertEqual(REQUEST,
-                         client.connection._requested[0]['data'])
-        self.assertTrue('faceAnnotations' in response)
-
-    def test_image_with_client(self):
-        from google.cloud.vision.image import Image
-
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT,
-                               credentials=credentials)
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        self.assertIsInstance(image, Image)
-
-    def test_face_detection_from_source(self):
-        from google.cloud.vision.face import Face
-        from unit_tests.vision._fixtures import FACE_DETECTION_RESPONSE
-        RETURNED = FACE_DETECTION_RESPONSE
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        faces = image.detect_faces(limit=3)
-        self.assertEqual(5, len(faces))
-        self.assertIsInstance(faces[0], Face)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual(3, image_request['features'][0]['maxResults'])
-
-    def test_face_detection_from_content(self):
-        from google.cloud.vision.face import Face
-        from unit_tests.vision._fixtures import FACE_DETECTION_RESPONSE
-        RETURNED = FACE_DETECTION_RESPONSE
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(content=_IMAGE_CONTENT)
-        faces = image.detect_faces(limit=5)
-        self.assertEqual(5, len(faces))
-        self.assertIsInstance(faces[0], Face)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(self.B64_IMAGE_CONTENT,
-                         image_request['image']['content'])
-        self.assertEqual(5, image_request['features'][0]['maxResults'])
-
-    def test_label_detection_from_source(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        from unit_tests.vision._fixtures import (LABEL_DETECTION_RESPONSE as
-                                                 RETURNED)
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        labels = image.detect_labels(limit=3)
-        self.assertEqual(3, len(labels))
-        self.assertIsInstance(labels[0], EntityAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual(3, image_request['features'][0]['maxResults'])
-        self.assertEqual('automobile', labels[0].description)
-        self.assertEqual('vehicle', labels[1].description)
-        self.assertEqual('/m/0k4j', labels[0].mid)
-        self.assertEqual('/m/07yv9', labels[1].mid)
-
-    def test_landmark_detection_from_source(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        from unit_tests.vision._fixtures import (LANDMARK_DETECTION_RESPONSE as
-                                                 RETURNED)
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        landmarks = image.detect_landmarks(limit=3)
-        self.assertEqual(2, len(landmarks))
-        self.assertIsInstance(landmarks[0], EntityAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual(3, image_request['features'][0]['maxResults'])
-        self.assertEqual(48.861013, landmarks[0].locations[0].latitude)
-        self.assertEqual(2.335818, landmarks[0].locations[0].longitude)
-        self.assertEqual('/m/04gdr', landmarks[0].mid)
-        self.assertEqual('/m/094llg', landmarks[1].mid)
-
-    def test_landmark_detection_from_content(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        from unit_tests.vision._fixtures import (LANDMARK_DETECTION_RESPONSE as
-                                                 RETURNED)
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(content=_IMAGE_CONTENT)
-        landmarks = image.detect_landmarks(limit=5)
-        self.assertEqual(2, len(landmarks))
-        self.assertIsInstance(landmarks[0], EntityAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(self.B64_IMAGE_CONTENT,
-                         image_request['image']['content'])
-        self.assertEqual(5, image_request['features'][0]['maxResults'])
-
-    def test_logo_detection_from_source(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        from unit_tests.vision._fixtures import LOGO_DETECTION_RESPONSE
-        RETURNED = LOGO_DETECTION_RESPONSE
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        logos = image.detect_logos(limit=3)
-        self.assertEqual(2, len(logos))
-        self.assertIsInstance(logos[0], EntityAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual(3, image_request['features'][0]['maxResults'])
-
-    def test_logo_detection_from_content(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        from unit_tests.vision._fixtures import LOGO_DETECTION_RESPONSE
-        RETURNED = LOGO_DETECTION_RESPONSE
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(content=_IMAGE_CONTENT)
-        logos = image.detect_logos(limit=5)
-        self.assertEqual(2, len(logos))
-        self.assertIsInstance(logos[0], EntityAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(self.B64_IMAGE_CONTENT,
-                         image_request['image']['content'])
-        self.assertEqual(5, image_request['features'][0]['maxResults'])
-
-    def test_text_detection_from_source(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        from unit_tests.vision._fixtures import (TEXT_DETECTION_RESPONSE as
-                                                 RETURNED)
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        text = image.detect_text(limit=3)
-        self.assertEqual(3, len(text))
-        self.assertIsInstance(text[0], EntityAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual(3, image_request['features'][0]['maxResults'])
-        self.assertEqual('en', text[0].locale)
-        self.assertEqual('Google CloudPlatform\n', text[0].description)
-        self.assertEqual('Google', text[1].description)
-        self.assertEqual(694, text[0].bounds.vertices[0].y_coordinate)
-
-    def test_safe_search_detection_from_source(self):
-        from google.cloud.vision.safe import SafeSearchAnnotation
-        from unit_tests.vision._fixtures import SAFE_SEARCH_DETECTION_RESPONSE
-
-        RETURNED = SAFE_SEARCH_DETECTION_RESPONSE
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        safe_search = image.detect_safe_search()
-        self.assertIsInstance(safe_search, SafeSearchAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual('VERY_UNLIKELY', safe_search.adult)
-        self.assertEqual('UNLIKELY', safe_search.spoof)
-        self.assertEqual('POSSIBLE', safe_search.medical)
-        self.assertEqual('VERY_UNLIKELY', safe_search.violence)
-
-    def test_image_properties_detection_from_source(self):
-        from google.cloud.vision.color import ImagePropertiesAnnotation
-        from unit_tests.vision._fixtures import IMAGE_PROPERTIES_RESPONSE
-
-        RETURNED = IMAGE_PROPERTIES_RESPONSE
-        credentials = _Credentials()
-        client = self._makeOne(project=self.PROJECT, credentials=credentials)
-        client.connection = _Connection(RETURNED)
-
-        image = client.image(source_uri=_IMAGE_SOURCE)
-        image_properties = image.detect_properties()
-        self.assertIsInstance(image_properties, ImagePropertiesAnnotation)
-        image_request = client.connection._requested[0]['data']['requests'][0]
-        self.assertEqual(_IMAGE_SOURCE,
-                         image_request['image']['source']['gcs_image_uri'])
-        self.assertEqual(0.42258179, image_properties.colors[0].score)
-        self.assertEqual(0.025376344,
-                         image_properties.colors[0].pixel_fraction)
-        self.assertEqual(253, image_properties.colors[0].color.red)
-        self.assertEqual(203, image_properties.colors[0].color.green)
-        self.assertEqual(65, image_properties.colors[0].color.blue)
-        self.assertEqual(0.0, image_properties.colors[0].color.alpha)
-
-
-class TestVisionRequest(unittest.TestCase):
-    def _getTargetClass(self):
-        from google.cloud.vision.client import VisionRequest
-        return VisionRequest
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_make_vision_request(self):
-        from google.cloud.vision.feature import Feature, FeatureTypes
-
-        feature = Feature(feature_type=FeatureTypes.FACE_DETECTION,
-                          max_results=3)
-        vision_request = self._makeOne(_IMAGE_CONTENT, feature)
-        self.assertEqual(_IMAGE_CONTENT, vision_request.image)
-        self.assertEqual(FeatureTypes.FACE_DETECTION,
-                         vision_request.features[0].feature_type)
-
-    def test_make_vision_request_with_bad_feature(self):
-        with self.assertRaises(TypeError):
-            self._makeOne(_IMAGE_CONTENT, 'nonsensefeature')
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
-
-
-class _Connection(object):
-
-    def __init__(self, *responses):
-        self._responses = responses
-        self._requested = []
-
-    def api_request(self, **kw):
-        self._requested.append(kw)
-        response, self._responses = self._responses[0], self._responses[1:]
-        return response
diff --git a/unit_tests/vision/test_connection.py b/unit_tests/vision/test_connection.py
deleted file mode 100644
index 95ce26f75fb7..000000000000
--- a/unit_tests/vision/test_connection.py
+++ /dev/null
@@ -1,44 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestConnection(unittest.TestCase):
-
-    def _getTargetClass(self):
-        from google.cloud.vision.connection import Connection
-        return Connection
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_default_url(self):
-        creds = _Credentials()
-        conn = self._makeOne(creds)
-        klass = self._getTargetClass()
-        self.assertEqual(conn.credentials._scopes, klass.SCOPE)
-
-
-class _Credentials(object):
-
-    _scopes = None
-
-    @staticmethod
-    def create_scoped_required():
-        return True
-
-    def create_scoped(self, scope):
-        self._scopes = scope
-        return self
diff --git a/unit_tests/vision/test_entity.py b/unit_tests/vision/test_entity.py
deleted file mode 100644
index 63e61ce7e546..000000000000
--- a/unit_tests/vision/test_entity.py
+++ /dev/null
@@ -1,33 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestEntityAnnotation(unittest.TestCase):
-    def _getTargetClass(self):
-        from google.cloud.vision.entity import EntityAnnotation
-        return EntityAnnotation
-
-    def test_logo_annotation(self):
-        from unit_tests.vision._fixtures import LOGO_DETECTION_RESPONSE
-
-        LOGO = LOGO_DETECTION_RESPONSE['responses'][0]['logoAnnotations'][0]
-        entity_class = self._getTargetClass()
-        logo = entity_class.from_api_repr(LOGO)
-
-        self.assertEqual('/m/05b5c', logo.mid)
-        self.assertEqual('Brand1', logo.description)
-        self.assertEqual(0.63192177, logo.score)
-        self.assertEqual(162, logo.bounds.vertices[0].y_coordinate)
diff --git a/unit_tests/vision/test_face.py b/unit_tests/vision/test_face.py
deleted file mode 100644
index f478382c28f3..000000000000
--- a/unit_tests/vision/test_face.py
+++ /dev/null
@@ -1,76 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestFace(unittest.TestCase):
-    def _getTargetClass(self):
-        from google.cloud.vision.face import Face
-        return Face
-
-    def setUp(self):
-        from unit_tests.vision._fixtures import FACE_DETECTION_RESPONSE
-        self.FACE_ANNOTATIONS = FACE_DETECTION_RESPONSE['responses'][0]
-        self.face_class = self._getTargetClass()
-        self.face = self.face_class.from_api_repr(
-            self.FACE_ANNOTATIONS['faceAnnotations'][0])
-
-    def test_face_landmarks(self):
-        self.assertEqual(0.54453093, self.face.landmarking_confidence)
-        self.assertEqual(0.9863683, self.face.detection_confidence)
-        self.assertTrue(hasattr(self.face.landmarks, 'left_eye'))
-        self.assertEqual(1004.8003,
-                         self.face.landmarks.left_eye.position.x_coordinate)
-        self.assertEqual(482.69385,
-                         self.face.landmarks.left_eye.position.y_coordinate)
-        self.assertEqual(0.0016593217,
-                         self.face.landmarks.left_eye.position.z_coordinate)
-        self.assertEqual('LEFT_EYE',
-                         self.face.landmarks.left_eye.landmark_type)
-
-    def test_facial_emotions(self):
-        from google.cloud.vision.face import Likelihood
-        self.assertEqual(Likelihood.VERY_LIKELY,
-                         self.face.emotions.joy_likelihood)
-        self.assertEqual(Likelihood.VERY_UNLIKELY,
-                         self.face.emotions.sorrow_likelihood)
-        self.assertEqual(Likelihood.VERY_UNLIKELY,
-                         self.face.emotions.surprise_likelihood)
-        self.assertEqual(Likelihood.VERY_UNLIKELY,
-                         self.face.emotions.anger_likelihood)
-
-    def test_faciale_angles(self):
-        self.assertEqual(-0.43419784, self.face.angles.roll)
-        self.assertEqual(6.027647, self.face.angles.pan)
-        self.assertEqual(-18.412321, self.face.angles.tilt)
-
-    def test_face_headware_and_blur_and_underexposed(self):
-        from google.cloud.vision.face import Likelihood
-        self.assertEqual(Likelihood.VERY_UNLIKELY,
-                         self.face.image_properties.blurred_likelihood)
-        self.assertEqual(Likelihood.VERY_UNLIKELY,
-                         self.face.headwear_likelihood)
-        self.assertEqual(Likelihood.VERY_UNLIKELY,
-                         self.face.image_properties.underexposed_likelihood)
-
-    def test_face_bounds(self):
-        self.assertEqual(4, len(self.face.bounds.vertices))
-        self.assertEqual(748, self.face.bounds.vertices[0].x_coordinate)
-        self.assertEqual(58, self.face.bounds.vertices[0].y_coordinate)
-
-    def test_facial_skin_bounds(self):
-        self.assertEqual(4, len(self.face.fd_bounds.vertices))
-        self.assertEqual(845, self.face.fd_bounds.vertices[0].x_coordinate)
-        self.assertEqual(310, self.face.fd_bounds.vertices[0].y_coordinate)
diff --git a/unit_tests/vision/test_feature.py b/unit_tests/vision/test_feature.py
deleted file mode 100644
index 224305cd71e3..000000000000
--- a/unit_tests/vision/test_feature.py
+++ /dev/null
@@ -1,48 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-
-
-class TestFeature(unittest.TestCase):
-    def _getTargetClass(self):
-        from google.cloud.vision.feature import Feature
-        return Feature
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_construct_feature(self):
-        from google.cloud.vision.feature import FeatureTypes
-        feature = self._makeOne(FeatureTypes.LABEL_DETECTION)
-        self.assertEqual(1, feature.max_results)
-        self.assertEqual('LABEL_DETECTION', feature.feature_type)
-
-        feature = self._makeOne(FeatureTypes.FACE_DETECTION, 3)
-        self.assertEqual(3, feature.max_results)
-        self.assertEqual('FACE_DETECTION', feature.feature_type)
-
-    def test_feature_as_dict(self):
-        from google.cloud.vision.feature import FeatureTypes
-        feature = self._makeOne(FeatureTypes.FACE_DETECTION, max_results=5)
-        EXPECTED = {
-            'type': 'FACE_DETECTION',
-            'maxResults': 5
-        }
-        self.assertEqual(EXPECTED, feature.as_dict())
-
-    def test_bad_feature_type(self):
-        with self.assertRaises(AttributeError):
-            self._makeOne('something_not_feature_type',
-                          max_results=5)
diff --git a/unit_tests/vision/test_image.py b/unit_tests/vision/test_image.py
deleted file mode 100644
index aa359b31a5dd..000000000000
--- a/unit_tests/vision/test_image.py
+++ /dev/null
@@ -1,68 +0,0 @@
-# Copyright 2016 Google Inc. 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.
-
-import unittest
-import base64
-
-from google.cloud._helpers import _to_bytes
-
-
-class TestVisionImage(unittest.TestCase):
-    _IMAGE_SOURCE = 'gs://some/image.jpg'
-    _IMAGE_CONTENT = _to_bytes('/9j/4QNURXhpZgAASUkq')
-    _B64_IMAGE_CONTENT = base64.b64encode(_IMAGE_CONTENT)
-    _CLIENT_MOCK = {'source': ''}
-
-    def _getTargetClass(self):
-        from google.cloud.vision.image import Image
-        return Image
-
-    def _makeOne(self, *args, **kw):
-        return self._getTargetClass()(*args, **kw)
-
-    def test_image_source_type_content(self):
-        image = self._makeOne(self._CLIENT_MOCK, content=self._IMAGE_CONTENT)
-
-        _AS_DICT = {
-            'content': self._B64_IMAGE_CONTENT
-        }
-
-        self.assertEqual(self._B64_IMAGE_CONTENT, image.content)
-        self.assertEqual(None, image.source)
-        self.assertEqual(_AS_DICT, image.as_dict())
-
-    def test_image_source_type_google_cloud_storage(self):
-        image = self._makeOne(self._CLIENT_MOCK, source_uri=self._IMAGE_SOURCE)
-
-        _AS_DICT = {
-            'source': {
-                'gcs_image_uri': self._IMAGE_SOURCE
-            }
-        }
-
-        self.assertEqual(self._IMAGE_SOURCE, image.source)
-        self.assertEqual(None, image.content)
-        self.assertEqual(_AS_DICT, image.as_dict())
-
-    def test_cannot_set_both_source_and_content(self):
-        image = self._makeOne(self._CLIENT_MOCK, content=self._IMAGE_CONTENT)
-
-        self.assertEqual(self._B64_IMAGE_CONTENT, image.content)
-        with self.assertRaises(AttributeError):
-            image.source = self._IMAGE_SOURCE
-
-        image = self._makeOne(self._CLIENT_MOCK, source_uri=self._IMAGE_SOURCE)
-        self.assertEqual(self._IMAGE_SOURCE, image.source)
-        with self.assertRaises(AttributeError):
-            image.content = self._IMAGE_CONTENT
diff --git a/videointelligence/.coveragerc b/videointelligence/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/videointelligence/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/videointelligence/.flake8 b/videointelligence/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/videointelligence/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/videointelligence/.repo-metadata.json b/videointelligence/.repo-metadata.json
new file mode 100644
index 000000000000..1861d3f653d9
--- /dev/null
+++ b/videointelligence/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "videointelligence",
+  "name_pretty": "Cloud Video Intelligence",
+  "product_documentation": "https://cloud.google.com/video-intelligence/docs/",
+  "client_documentation": "https://googleapis.dev/python/videointelligence/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/5084810",
+  "release_level": "ga",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-videointelligence",
+  "api_id": "videointelligence.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/videointelligence/CHANGELOG.md b/videointelligence/CHANGELOG.md
new file mode 100644
index 000000000000..daaafbfb41dd
--- /dev/null
+++ b/videointelligence/CHANGELOG.md
@@ -0,0 +1,241 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-videointelligence/#history
+
+## 1.11.0
+
+08-12-2019 14:00 PDT
+
+### New Features
+- Add segment / shot presence label annotations fields (via synth). ([#8987](https://github.com/googleapis/google-cloud-python/pull/8987))
+- Add V1 video segment / feature fields; remove send/recv msg size limit (via synth). ([#8975](https://github.com/googleapis/google-cloud-python/pull/8975))
+
+### Documentation
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 1.10.0
+
+07-24-2019 17:52 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8410](https://github.com/googleapis/google-cloud-python/pull/8410))
+
+### New Features
+- Add 'client_options' support (via synth). ([#8528](https://github.com/googleapis/google-cloud-python/pull/8528))
+- Add support for streaming classification / object tracking (via synth). ([#8427](https://github.com/googleapis/google-cloud-python/pull/8427))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Add VPC SC integration tests. ([#8607](https://github.com/googleapis/google-cloud-python/pull/8607))
+- Pin black version (via synth). ([#8601](https://github.com/googleapis/google-cloud-python/pull/8601))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Change test video URI, add disclaimer to auto-generated template files (via synth). ([#8334](https://github.com/googleapis/google-cloud-python/pull/8334))
+- Declare encoding as utf-8 in pb2 files (via synth).  ([#8370](https://github.com/googleapis/google-cloud-python/pull/8370))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8256](https://github.com/googleapis/google-cloud-python/pull/8256))
+
+## 1.9.0
+
+06-05-2019 10:42 PDT
+
+
+### Implementation Changes
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+
+### New Features
+- Add v1 object tracking support, v1p3b1 speech transcription / logo recognition support (via synth). ([#8221](https://github.com/googleapis/google-cloud-python/pull/8221))
+
+### Documentation
+- Change input_uri for sample video (via synth). ([#7944](https://github.com/googleapis/google-cloud-python/pull/7944))
+- Fix uri to video (via synth).  ([#7862](https://github.com/googleapis/google-cloud-python/pull/7862))
+
+### Internal / Testing Changes
+- Fix coverage in 'types.py' (via synth). ([#8169](https://github.com/googleapis/google-cloud-python/pull/8169))
+- Blacken noxfile.py, setup.py (via synth). ([#8136](https://github.com/googleapis/google-cloud-python/pull/8136))
+- Harden synth replacement against template changes. ([#8104](https://github.com/googleapis/google-cloud-python/pull/8104))
+- Update noxfile (via synth). ([#7838](https://github.com/googleapis/google-cloud-python/pull/7838))
+- Add nox session `docs` (via synth). ([#7786](https://github.com/googleapis/google-cloud-python/pull/7786))
+- Update docs build configuration.  ([#7603](https://github.com/googleapis/google-cloud-python/pull/7603))
+
+## 1.8.0
+
+03-06-2019 12:20 PST
+
+### New Features
+- Add videointelligence v1p3beta1 (Streaming API Support). ([#7490](https://github.com/googleapis/google-cloud-python/pull/7490))
+
+### Internal / Testing Changes
+- Copy lintified proto files (via synth). ([#7472](https://github.com/googleapis/google-cloud-python/pull/7472))
+
+## 1.7.0
+
+02-25-2019 12:25 PST
+
+
+### Implementation Changes
+- Remove unused message exports. ([#7279](https://github.com/googleapis/google-cloud-python/pull/7279))
+- Protoc-generated serialization update. ([#7099](https://github.com/googleapis/google-cloud-python/pull/7099))
+
+### New Features
+- Add text detection / object tracking feature support (via sync). ([#7415](https://github.com/googleapis/google-cloud-python/pull/7415))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers.
+- Pick up stub docstring fix in GAPIC generator. ([#6986](https://github.com/googleapis/google-cloud-python/pull/6986))
+
+### Internal / Testing Changes
+- Add clarifying comment to blacken nox target. ([#7407](https://github.com/googleapis/google-cloud-python/pull/7407))
+- Copy proto files alongside protoc versions.
+- Add protos as an artifact to library. ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 1.6.1
+
+12-17-2018 17:09 PST
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Fixes to GAPIC generator. ([#6578](https://github.com/googleapis/google-cloud-python/pull/6578))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+### Internal / Testing Changes
+- Add baseline for synth.metadata
+- Update noxfile.
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+
+## 1.6.0
+
+11-09-2018 13:36 PST
+
+
+### Implementation Changes
+- Add support for speech transcription. ([#6313](https://github.com/googleapis/google-cloud-python/pull/6313))
+- Fix client_info bug, update docstrings and timeouts. ([#6425](https://github.com/googleapis/google-cloud-python/pull/6425))
+
+### Dependencies
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+- Avoid broken 'google-common-apis 1.5.4' release. ([#6355](https://github.com/googleapis/google-cloud-python/pull/6355))
+
+### Documentation
+- normalize use of support level badges.([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+
+### Internal / Testing Changes
+- Add 'mock' to unit test dependencies for autogen libs. ([#6402](https://github.com/googleapis/google-cloud-python/pull/6402))
+
+## 1.5.0
+
+### New Features
+- Regenerate v2p2beta1 to add Object Tracking and Text Detection Beta ([#6225](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6225))
+
+### Documentation
+- Harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6002](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6002))
+- Correct text for the pip install command ([#6198](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6198))
+
+### Internal / Testing Changes
+- Use new Nox ([#6175](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6175))
+
+## 1.4.0
+
+### New Features
+- Add support for 'v1p2beta1' API version ([#6004](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/6004))
+
+### Implementation Changes
+- Re-generate library using videointelligence/synth.py ([#5982](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5982))
+- Re-generate library using videointelligence/synth.py ([#5954](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5954))
+
+## 1.3.0
+
+### Implementation Changes
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+
+### New Features
+- Regenerate Video Intelligence v1p1beta1 endpoint to add new features (#5617)
+
+### Internal / Testing Changes
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+
+## 1.2.0
+
+### New Features
+
+- Add v1p1beta1 version of videointelligence (#5165)
+
+### Internal / Testing Changes
+
+- Fix v1p1beta1 unit tests (#5064)
+
+## 1.1.0
+
+### Interface additions
+
+- Added video v1p1beta1 (#5048)
+
+## 1.0.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Normalize all setup.py files (#4909)
+
+## 1.0.0
+
+[![release level](https://img.shields.io/badge/release%20level-general%20availability%20%28GA%29-brightgreen.svg?style&#x3D;flat)](https://cloud.google.com/terms/launch-stages)
+
+### Features
+
+#### General Availability
+
+The `google-cloud-videointelligence` package is now supported at the
+**general availability** quality level. This means it is stable; the code
+and API surface will not change in backwards-incompatible ways unless
+absolutely necessary (e.g. because of critical security issues) or with an
+extensive deprecation period.
+
+One exception to this: We will remove beta endpoints (as a semver-minor update)
+at whatever point the underlying endpoints go away.
+
+#### v1 endpoint
+
+The underlying video intelligence API has also gone general availability, and
+this library by default now uses the `v1` endpoint (rather than `v1beta2`)
+unless you explicitly used something else. This is a backwards compatible
+change as the `v1` and `v1beta2` endpoints are identical. If you pinned to
+`v1beta2`, you are encouraged to move to `v1`.
+
+## 0.28.0
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+### Packaging
+
+- Change "Development Status" in package metadata from `3 - Alpha`
+  to `4 - Beta` (eb43849569556c6e47f11b8310864c5a280507f2)
+
+PyPI: https://pypi.org/project/google-cloud-videointelligence/0.28.0/
diff --git a/videointelligence/LICENSE b/videointelligence/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/videointelligence/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/videointelligence/MANIFEST.in b/videointelligence/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/videointelligence/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/videointelligence/README.rst b/videointelligence/README.rst
new file mode 100644
index 000000000000..944d96bad5ff
--- /dev/null
+++ b/videointelligence/README.rst
@@ -0,0 +1,106 @@
+Python Client for Google Cloud Video Intelligence
+=================================================
+
+|beta| |pypi| |versions| 
+
+`Google Cloud Video Intelligence`_ API makes videos searchable, and
+discoverable, by extracting metadata with an easy to use API.
+You can now search every moment of every video file in your catalog
+and find every occurrence as well as its significance. It quickly
+annotates videos stored in `Google Cloud Storage`_, and helps you
+identify key nouns entities of your video, and when they occur
+within the video. Separate signal from noise, by retrieving
+relevant information at the video, shot or per frame.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |beta| image:: https://img.shields.io/badge/support-beta-silver.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-videointelligence.svg
+   :target: https://pypi.org/project/google-cloud-videointelligence/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-videointelligence.svg
+   :target: https://pypi.org/project/google-cloud-videointelligence/
+.. _Google Cloud Video Intelligence: https://cloud.google.com/video-intelligence/
+.. _Google Cloud Storage: https://cloud.google.com/storage/
+.. _Client Library Documentation: https://googleapis.dev/python/videointelligence/latest
+.. _Product Documentation: https://cloud.google.com/video-intelligence/docs/
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Video Intelligence API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Video Intelligence API.:  https://cloud.google.com/datastore
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-videointelligence
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-videointelligence
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   from google.cloud import videointelligence
+   
+   client = videointelligence.VideoIntelligenceServiceClient()
+   job = client.annotate_video(
+       input_uri='gs://<bucket-name>/my_video.mp4',
+       features=['LABEL_DETECTION', 'SHOT_CHANGE_DETECTION'],
+   )
+   result = job.result()
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Video Intelligence 
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/videointelligence/docs/README.rst b/videointelligence/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/videointelligence/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/videointelligence/docs/changelog.md b/videointelligence/docs/changelog.md
new file mode 120000
index 000000000000..d383e581e198
--- /dev/null
+++ b/videointelligence/docs/changelog.md
@@ -0,0 +1 @@
+../../videointelligence/CHANGELOG.md
\ No newline at end of file
diff --git a/videointelligence/docs/conf.py b/videointelligence/docs/conf.py
new file mode 100644
index 000000000000..c9ea80a329f8
--- /dev/null
+++ b/videointelligence/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-video-intelligence documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-video-intelligence"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-video-intelligence-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-video-intelligence.tex",
+        u"google-cloud-video-intelligence Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-video-intelligence",
+        u"google-cloud-video-intelligence Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-video-intelligence",
+        u"google-cloud-video-intelligence Documentation",
+        author,
+        "google-cloud-video-intelligence",
+        "GAPIC library for the {metadata.shortName} v1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/videointelligence/docs/gapic/v1/api.rst b/videointelligence/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..cfc34f438f49
--- /dev/null
+++ b/videointelligence/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Video Intelligence API
+=======================================
+
+.. automodule:: google.cloud.videointelligence_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1/types.rst b/videointelligence/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..d8508c287842
--- /dev/null
+++ b/videointelligence/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Video Intelligence API Client
+=============================================
+
+.. automodule:: google.cloud.videointelligence_v1.types
+    :members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1beta1/api.rst b/videointelligence/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..2ec043d68788
--- /dev/null
+++ b/videointelligence/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Video Intelligence API
+==============================================
+
+.. automodule:: google.cloud.videointelligence_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1beta1/types.rst b/videointelligence/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..00374b5af4d5
--- /dev/null
+++ b/videointelligence/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Video Intelligence API Client
+====================================================
+
+.. automodule:: google.cloud.videointelligence_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1beta2/api.rst b/videointelligence/docs/gapic/v1beta2/api.rst
new file mode 100644
index 000000000000..006f41313e22
--- /dev/null
+++ b/videointelligence/docs/gapic/v1beta2/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Video Intelligence API
+==============================================
+
+.. automodule:: google.cloud.videointelligence_v1beta2
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1beta2/types.rst b/videointelligence/docs/gapic/v1beta2/types.rst
new file mode 100644
index 000000000000..f782d4c9faec
--- /dev/null
+++ b/videointelligence/docs/gapic/v1beta2/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Video Intelligence API Client
+====================================================
+
+.. automodule:: google.cloud.videointelligence_v1beta2.types
+    :members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1p1beta1/api.rst b/videointelligence/docs/gapic/v1p1beta1/api.rst
new file mode 100644
index 000000000000..5774850d626b
--- /dev/null
+++ b/videointelligence/docs/gapic/v1p1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Video Intelligence API
+=======================================
+
+.. automodule:: google.cloud.videointelligence_v1p1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1p1beta1/types.rst b/videointelligence/docs/gapic/v1p1beta1/types.rst
new file mode 100644
index 000000000000..fc72d7807e9b
--- /dev/null
+++ b/videointelligence/docs/gapic/v1p1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Video Intelligence API Client
+=============================================
+
+.. automodule:: google.cloud.videointelligence_v1p1beta1.types
+    :members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1p2beta1/api.rst b/videointelligence/docs/gapic/v1p2beta1/api.rst
new file mode 100644
index 000000000000..0dafdd894ab6
--- /dev/null
+++ b/videointelligence/docs/gapic/v1p2beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Video Intelligence API
+=======================================
+
+.. automodule:: google.cloud.videointelligence_v1p2beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1p2beta1/types.rst b/videointelligence/docs/gapic/v1p2beta1/types.rst
new file mode 100644
index 000000000000..4806fa77790e
--- /dev/null
+++ b/videointelligence/docs/gapic/v1p2beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Video Intelligence API Client
+=============================================
+
+.. automodule:: google.cloud.videointelligence_v1p2beta1.types
+    :members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1p3beta1/api.rst b/videointelligence/docs/gapic/v1p3beta1/api.rst
new file mode 100644
index 000000000000..570eaffa4dc3
--- /dev/null
+++ b/videointelligence/docs/gapic/v1p3beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Video Intelligence API
+=======================================
+
+.. automodule:: google.cloud.videointelligence_v1p3beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/videointelligence/docs/gapic/v1p3beta1/types.rst b/videointelligence/docs/gapic/v1p3beta1/types.rst
new file mode 100644
index 000000000000..9f86eee10bac
--- /dev/null
+++ b/videointelligence/docs/gapic/v1p3beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Video Intelligence API Client
+=============================================
+
+.. automodule:: google.cloud.videointelligence_v1p3beta1.types
+    :members:
\ No newline at end of file
diff --git a/videointelligence/docs/index.rst b/videointelligence/docs/index.rst
new file mode 100644
index 000000000000..868afa75297c
--- /dev/null
+++ b/videointelligence/docs/index.rst
@@ -0,0 +1,58 @@
+.. include:: README.rst
+
+API Reference
+-------------
+
+
+This package includes clients for multiple versions of the Video Intelligence
+API. By default, you will get ``v1``, the latest stable version.
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1/api
+    gapic/v1/types
+
+A new beta release with additional features over the current stable version,
+spelled ``v1p3beta1``, is provided to allow you to use these new features.
+These are expected to move into the stable release soon; until then, the
+usual beta admonishment (changes are possible, etc.) applies.
+
+An API and type reference is provided for this beta:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1p3beta1/api
+    gapic/v1p3beta1/types
+
+The previous beta releases, spelled ``v1p2beta1``, ``v1p1beta1``, ``v1beta1``, and
+``v1beta2``, are provided to continue to support code previously written
+against them. In order to use ththem, you will want to import from e.g.
+``google.cloud.videointelligence_v1beta2`` in lieu of
+``google.cloud.videointelligence_v1``.
+
+An API and type reference is provided the these betas also:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1p2beta1/api
+    gapic/v1p2beta1/types
+    gapic/v1p1beta1/api
+    gapic/v1p1beta1/types
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+    gapic/v1beta2/api
+    gapic/v1beta2/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-videointelligence`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/videointelligence/google/__init__.py b/videointelligence/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/videointelligence/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/videointelligence/google/cloud/__init__.py b/videointelligence/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/videointelligence/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/videointelligence/google/cloud/videointelligence.py b/videointelligence/google/cloud/videointelligence.py
new file mode 100644
index 000000000000..276a663b7ec4
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1 import VideoIntelligenceServiceClient
+from google.cloud.videointelligence_v1 import enums
+from google.cloud.videointelligence_v1 import types
+
+
+__all__ = ("enums", "types", "VideoIntelligenceServiceClient")
diff --git a/videointelligence/google/cloud/videointelligence_v1/__init__.py b/videointelligence/google/cloud/videointelligence_v1/__init__.py
new file mode 100644
index 000000000000..85cd704ad066
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/__init__.py
@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1 import types
+from google.cloud.videointelligence_v1.gapic import enums
+from google.cloud.videointelligence_v1.gapic import video_intelligence_service_client
+
+
+class VideoIntelligenceServiceClient(
+    video_intelligence_service_client.VideoIntelligenceServiceClient
+):
+    __doc__ = video_intelligence_service_client.VideoIntelligenceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "VideoIntelligenceServiceClient")
diff --git a/videointelligence/google/cloud/videointelligence_v1/gapic/__init__.py b/videointelligence/google/cloud/videointelligence_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1/gapic/enums.py b/videointelligence/google/cloud/videointelligence_v1/gapic/enums.py
new file mode 100644
index 000000000000..269d8829128a
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/gapic/enums.py
@@ -0,0 +1,82 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Feature(enum.IntEnum):
+    """
+    Video annotation feature.
+
+    Attributes:
+      FEATURE_UNSPECIFIED (int): Unspecified.
+      LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      SHOT_CHANGE_DETECTION (int): Shot change detection.
+      EXPLICIT_CONTENT_DETECTION (int): Explicit content detection.
+      FACE_DETECTION (int): Human face detection and tracking.
+      SPEECH_TRANSCRIPTION (int): Speech transcription.
+      TEXT_DETECTION (int): OCR text detection and tracking.
+      OBJECT_TRACKING (int): Object detection and tracking.
+    """
+
+    FEATURE_UNSPECIFIED = 0
+    LABEL_DETECTION = 1
+    SHOT_CHANGE_DETECTION = 2
+    EXPLICIT_CONTENT_DETECTION = 3
+    FACE_DETECTION = 4
+    SPEECH_TRANSCRIPTION = 6
+    TEXT_DETECTION = 7
+    OBJECT_TRACKING = 9
+
+
+class LabelDetectionMode(enum.IntEnum):
+    """
+    Label detection mode.
+
+    Attributes:
+      LABEL_DETECTION_MODE_UNSPECIFIED (int): Unspecified.
+      SHOT_MODE (int): Detect shot-level labels.
+      FRAME_MODE (int): Detect frame-level labels.
+      SHOT_AND_FRAME_MODE (int): Detect both shot-level and frame-level labels.
+    """
+
+    LABEL_DETECTION_MODE_UNSPECIFIED = 0
+    SHOT_MODE = 1
+    FRAME_MODE = 2
+    SHOT_AND_FRAME_MODE = 3
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Bucketized representation of likelihood.
+
+    Attributes:
+      LIKELIHOOD_UNSPECIFIED (int): Unspecified likelihood.
+      VERY_UNLIKELY (int): Very unlikely.
+      UNLIKELY (int): Unlikely.
+      POSSIBLE (int): Possible.
+      LIKELY (int): Likely.
+      VERY_LIKELY (int): Very likely.
+    """
+
+    LIKELIHOOD_UNSPECIFIED = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
diff --git a/videointelligence/google/cloud/videointelligence_v1/gapic/transports/__init__.py b/videointelligence/google/cloud/videointelligence_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1/gapic/transports/video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1/gapic/transports/video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..0a74daf4de6b
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/gapic/transports/video_intelligence_service_grpc_transport.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.videointelligence_v1.proto import video_intelligence_pb2_grpc
+
+
+class VideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1 VideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "video_intelligence_service_stub": video_intelligence_pb2_grpc.VideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def annotate_video(self):
+        """Return the gRPC stub for :meth:`VideoIntelligenceServiceClient.annotate_video`.
+
+        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).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["video_intelligence_service_stub"].AnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1/gapic/video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1/gapic/video_intelligence_service_client.py
new file mode 100644
index 000000000000..a9058fb38c33
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/gapic/video_intelligence_service_client.py
@@ -0,0 +1,306 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1 VideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import grpc
+
+from google.cloud.videointelligence_v1.gapic import enums
+from google.cloud.videointelligence_v1.gapic import (
+    video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1.gapic.transports import (
+    video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class VideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.videointelligence.v1.VideoIntelligenceService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            VideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.VideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.VideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def annotate_video(
+        self,
+        input_uri=None,
+        input_content=None,
+        features=None,
+        video_context=None,
+        output_uri=None,
+        location_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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).
+
+        Example:
+            >>> from google.cloud import videointelligence_v1
+            >>> from google.cloud.videointelligence_v1 import enums
+            >>>
+            >>> client = videointelligence_v1.VideoIntelligenceServiceClient()
+            >>>
+            >>> input_uri = 'gs://cloud-samples-data/video/cat.mp4'
+            >>> features_element = enums.Feature.LABEL_DETECTION
+            >>> features = [features_element]
+            >>>
+            >>> response = client.annotate_video(input_uri=input_uri, features=features)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            input_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/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.
+            input_content (bytes): The video data bytes. If unset, the input video(s) should be specified
+                via ``input_uri``. If set, ``input_uri`` should be unset.
+            features (list[~google.cloud.videointelligence_v1.types.Feature]): Requested video annotation features.
+            video_context (Union[dict, ~google.cloud.videointelligence_v1.types.VideoContext]): Additional video context and/or feature-specific parameters.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.videointelligence_v1.types.VideoContext`
+            output_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/storage/docs/reference-uris>`__.
+            location_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.videointelligence_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_video,
+                default_retry=self._method_configs["AnnotateVideo"].retry,
+                default_timeout=self._method_configs["AnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri,
+            input_content=input_content,
+            features=features,
+            video_context=video_context,
+            output_uri=output_uri,
+            location_id=location_id,
+        )
+        operation = self._inner_api_calls["annotate_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            video_intelligence_pb2.AnnotateVideoResponse,
+            metadata_type=video_intelligence_pb2.AnnotateVideoProgress,
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1/gapic/video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1/gapic/video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..b9eef5e2a6a7
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/gapic/video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1.VideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnnotateVideo": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1/proto/__init__.py b/videointelligence/google/cloud/videointelligence_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence.proto b/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence.proto
new file mode 100644
index 000000000000..4c7a0ad131a2
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence.proto
@@ -0,0 +1,738 @@
+// 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.videointelligence.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.VideoIntelligence.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1;videointelligence";
+option java_multiple_files = true;
+option java_outer_classname = "VideoIntelligenceServiceProto";
+option java_package = "com.google.cloud.videointelligence.v1";
+option php_namespace = "Google\\Cloud\\VideoIntelligence\\V1";
+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) {
+    option (google.api.http) = {
+      post: "/v1/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.
+  // If unset, the input video(s) should be specified via `input_uri`.
+  // If set, `input_uri` should be unset.
+  bytes 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;
+
+  // Config for LABEL_DETECTION.
+  LabelDetectionConfig label_detection_config = 2;
+
+  // Config for SHOT_CHANGE_DETECTION.
+  ShotChangeDetectionConfig shot_change_detection_config = 3;
+
+  // 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 OBJECT_TRACKING.
+  ObjectTrackingConfig object_tracking_config = 13;
+}
+
+// Config for LABEL_DETECTION.
+message LabelDetectionConfig {
+  // What labels should be detected with LABEL_DETECTION, in addition to
+  // video-level labels or segment-level labels.
+  // 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.
+  bool stationary_camera = 2;
+
+  // Model to use for label detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+
+  // The confidence threshold we perform filtering on the labels from
+  // 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
+  // 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
+  // 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
+  // the default threshold everytime when we release a new model.
+  float video_confidence_threshold = 5;
+}
+
+// Config for SHOT_CHANGE_DETECTION.
+message ShotChangeDetectionConfig {
+  // Model to use for shot change detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 1;
+}
+
+// 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;
+}
+
+// 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 be included in the face annotation output.
+  bool include_bounding_boxes = 2;
+}
+
+// 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;
+}
+
+// Config for TEXT_DETECTION.
+message TextDetectionConfig {
+  // Language hint can be specified if the language to be detected is known a
+  // priori. It can increase the accuracy of the detection. Language hint must
+  // be language code in BCP-47 format.
+  //
+  // Automatic language detection is performed if no hint is provided.
+  repeated string language_hints = 1;
+
+  // Model to use for text detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 2;
+}
+
+// Video segment.
+message VideoSegment {
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the start of the segment (inclusive).
+  google.protobuf.Duration start_time_offset = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the end of the segment (inclusive).
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video segment level annotation results for label detection.
+message LabelSegment {
+  // Video segment where a label was detected.
+  VideoSegment segment = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Video frame level annotation results for label detection.
+message LabelFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Detected entity from video analysis.
+message Entity {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string entity_id = 1;
+
+  // Textual description, e.g. `Fixed-gear bicycle`.
+  string description = 2;
+
+  // Language code for `description` in BCP-47 format.
+  string language_code = 3;
+}
+
+// Label annotation.
+message LabelAnnotation {
+  // Detected entity.
+  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`.
+  repeated Entity category_entities = 2;
+
+  // All video segments where a label was detected.
+  repeated LabelSegment segments = 3;
+
+  // All video frames where a label was detected.
+  repeated LabelFrame frames = 4;
+}
+
+// Video frame level annotation results for explicit content.
+message ExplicitContentFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Likelihood of the pornography content..
+  Likelihood pornography_likelihood = 2;
+}
+
+// Explicit content annotation (based on per-frame visual signals only).
+// If no explicit content has been detected in a frame, no annotations are
+// present for that frame.
+message ExplicitContentAnnotation {
+  // All video frames where explicit content was detected.
+  repeated ExplicitContentFrame frames = 1;
+}
+
+// Normalized bounding box.
+// The normalized vertex coordinates are relative to the original image.
+// Range: [0, 1].
+message NormalizedBoundingBox {
+  // Left X coordinate.
+  float left = 1;
+
+  // Top Y coordinate.
+  float top = 2;
+
+  // Right X coordinate.
+  float right = 3;
+
+  // Bottom Y coordinate.
+  float bottom = 4;
+}
+
+// Video segment level annotation results for face detection.
+message FaceSegment {
+  // Video segment where a face was detected.
+  VideoSegment segment = 1;
+}
+
+// Video frame level annotation results for face detection.
+message FaceFrame {
+  // Normalized Bounding boxes in a frame.
+  // There can be more than one boxes if the same face is detected in multiple
+  // locations within the current frame.
+  repeated NormalizedBoundingBox normalized_bounding_boxes = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the video frame for this location.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Face annotation.
+message FaceAnnotation {
+  // Thumbnail of a representative face view (in JPEG format).
+  bytes thumbnail = 1;
+
+  // All video segments where a face was detected.
+  repeated FaceSegment segments = 2;
+
+  // All video frames where a face was detected.
+  repeated FaceFrame frames = 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;
+
+  // 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;
+
+  // Presence label annotations on video level or user specified segment level.
+  // There is exactly one element for each unique label. This will eventually
+  // get publicly exposed and the restriction will be removed.
+  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. This will eventually get publicly exposed and the
+  // restriction will be removed.
+  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 annotations. There is exactly one element for each unique face.
+  repeated FaceAnnotation face_annotations = 5;
+
+  // Shot annotations. Each shot is represented as a video segment.
+  repeated VideoSegment shot_annotations = 6;
+
+  // Explicit content annotation.
+  ExplicitContentAnnotation explicit_annotation = 7;
+
+  // Speech transcription.
+  repeated SpeechTranscription speech_transcriptions = 11;
+
+  // OCR text detection and tracking.
+  // Annotations for list of detected text snippets. Each will have list of
+  // frame information associated with it.
+  repeated TextAnnotation text_annotations = 12;
+
+  // Annotations for list of objects detected and tracked in video.
+  repeated ObjectTrackingAnnotation object_annotations = 14;
+
+  // If set, indicates an error. Note that for a single `AnnotateVideoRequest`
+  // some videos may succeed and some may fail.
+  google.rpc.Status error = 9;
+}
+
+// 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;
+
+  // 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`
+// 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;
+}
+
+// Config for SPEECH_TRANSCRIPTION.
+message SpeechTranscriptionConfig {
+  // *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;
+
+  // *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;
+
+  // *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;
+
+  // *Optional* A means to provide context to assist the speech recognition.
+  repeated SpeechContext speech_contexts = 4;
+
+  // *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;
+
+  // *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;
+
+  // *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;
+
+  // *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 `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;
+}
+
+// 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
+  // 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;
+}
+
+// A speech recognition result corresponding to a portion of the audio.
+message SpeechTranscription {
+  // 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. 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;
+}
+
+// Alternative hypotheses (a.k.a. n-best list).
+message SpeechRecognitionAlternative {
+  // 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
+  // indicates an estimated greater likelihood that the recognized words are
+  // 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;
+
+  // 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;
+}
+
+// Word-specific information for recognized words. Word information is only
+// included in the response when certain request parameters are set, such
+// as `enable_word_time_offsets`.
+message WordInfo {
+  // 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. This is an
+  // experimental feature and the accuracy of the time offset can vary.
+  google.protobuf.Duration start_time = 1;
+
+  // 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. This is an
+  // experimental feature and the accuracy of the time offset can vary.
+  google.protobuf.Duration end_time = 2;
+
+  // 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
+  // indicates an estimated greater likelihood that the recognized words are
+  // 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 = 4;
+
+  // 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;
+}
+
+// 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;
+}
+
+// Normalized bounding polygon for text (that might not be aligned with axis).
+// Contains list of the corner points in clockwise order starting from
+// top-left corner. For example, for a rectangular bounding box:
+// When the text is horizontal it might look like:
+//         0----1
+//         |    |
+//         3----2
+//
+// When it's clockwise rotated 180 degrees around the top-left corner it
+// becomes:
+//         2----3
+//         |    |
+//         1----0
+//
+// and the vertex order will still be (0, 1, 2, 3). Note that values can be less
+// than 0, or greater than 1 due to trignometric calculations for location of
+// the box.
+message NormalizedBoundingPoly {
+  // Normalized vertices of the bounding polygon.
+  repeated NormalizedVertex vertices = 1;
+}
+
+// Video segment level annotation results for text detection.
+message TextSegment {
+  // Video segment where a text snippet was detected.
+  VideoSegment segment = 1;
+
+  // Confidence for the track of detected text. It is calculated as the highest
+  // over all frames where OCR detected text appears.
+  float confidence = 2;
+
+  // Information related to the frames where OCR detected text appears.
+  repeated TextFrame frames = 3;
+}
+
+// Video frame level annotation results for text annotation (OCR).
+// Contains information regarding timestamp and bounding box locations for the
+// frames containing detected OCR text snippets.
+message TextFrame {
+  // Bounding polygon of the detected text for this frame.
+  NormalizedBoundingPoly rotated_bounding_box = 1;
+
+  // Timestamp of this frame.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Annotations related to one detected OCR text snippet. This will contain the
+// corresponding text, confidence value, and frame level information for each
+// detection.
+message TextAnnotation {
+  // The detected text.
+  string text = 1;
+
+  // All video segments where OCR detected text appears.
+  repeated TextSegment segments = 2;
+}
+
+// Video frame level annotations for object detection and tracking. This field
+// stores per frame location, time offset, and confidence.
+message ObjectTrackingFrame {
+  // The normalized bounding box location of this object track for the frame.
+  NormalizedBoundingBox normalized_bounding_box = 1;
+
+  // The timestamp of the frame in microseconds.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Annotations corresponding to one tracked object.
+message ObjectTrackingAnnotation {
+  // 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.
+    // Instead, we provide a unique identifiable integer track_id so that
+    // the customers can correlate the results of the ongoing
+    // 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;
+}
+
+// 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;
+
+  // Likely.
+  LIKELY = 4;
+
+  // Very likely.
+  VERY_LIKELY = 5;
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence_pb2.py b/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence_pb2.py
new file mode 100644
index 000000000000..755f13437776
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence_pb2.py
@@ -0,0 +1,4156 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/videointelligence_v1/proto/video_intelligence.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/videointelligence_v1/proto/video_intelligence.proto",
+    package="google.cloud.videointelligence.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n%com.google.cloud.videointelligence.v1B\035VideoIntelligenceServiceProtoP\001ZRgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1;videointelligence\252\002!Google.Cloud.VideoIntelligence.V1\312\002!Google\\Cloud\\VideoIntelligence\\V1\352\002$Google::Cloud::VideoIntelligence::V1"
+    ),
+    serialized_pb=_b(
+        '\n@google/cloud/videointelligence_v1/proto/video_intelligence.proto\x12!google.cloud.videointelligence.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xef\x01\n\x14\x41nnotateVideoRequest\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x15\n\rinput_content\x18\x06 \x01(\x0c\x12<\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0e\x32*.google.cloud.videointelligence.v1.Feature\x12\x46\n\rvideo_context\x18\x03 \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoContext\x12\x12\n\noutput_uri\x18\x04 \x01(\t\x12\x13\n\x0blocation_id\x18\x05 \x01(\t"\xe6\x05\n\x0cVideoContext\x12\x41\n\x08segments\x18\x01 \x03(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment\x12W\n\x16label_detection_config\x18\x02 \x01(\x0b\x32\x37.google.cloud.videointelligence.v1.LabelDetectionConfig\x12\x62\n\x1cshot_change_detection_config\x18\x03 \x01(\x0b\x32<.google.cloud.videointelligence.v1.ShotChangeDetectionConfig\x12l\n!explicit_content_detection_config\x18\x04 \x01(\x0b\x32\x41.google.cloud.videointelligence.v1.ExplicitContentDetectionConfig\x12U\n\x15\x66\x61\x63\x65_detection_config\x18\x05 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1.FaceDetectionConfig\x12\x61\n\x1bspeech_transcription_config\x18\x06 \x01(\x0b\x32<.google.cloud.videointelligence.v1.SpeechTranscriptionConfig\x12U\n\x15text_detection_config\x18\x08 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1.TextDetectionConfig\x12W\n\x16object_tracking_config\x18\r \x01(\x0b\x32\x37.google.cloud.videointelligence.v1.ObjectTrackingConfig"\xdd\x01\n\x14LabelDetectionConfig\x12S\n\x14label_detection_mode\x18\x01 \x01(\x0e\x32\x35.google.cloud.videointelligence.v1.LabelDetectionMode\x12\x19\n\x11stationary_camera\x18\x02 \x01(\x08\x12\r\n\x05model\x18\x03 \x01(\t\x12"\n\x1a\x66rame_confidence_threshold\x18\x04 \x01(\x02\x12"\n\x1avideo_confidence_threshold\x18\x05 \x01(\x02"*\n\x19ShotChangeDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"/\n\x1e\x45xplicitContentDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"D\n\x13\x46\x61\x63\x65\x44\x65tectionConfig\x12\r\n\x05model\x18\x01 \x01(\t\x12\x1e\n\x16include_bounding_boxes\x18\x02 \x01(\x08"%\n\x14ObjectTrackingConfig\x12\r\n\x05model\x18\x01 \x01(\t"<\n\x13TextDetectionConfig\x12\x16\n\x0elanguage_hints\x18\x01 \x03(\t\x12\r\n\x05model\x18\x02 \x01(\t"x\n\x0cVideoSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"d\n\x0cLabelSegment\x12@\n\x07segment\x18\x01 \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02"P\n\nLabelFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nconfidence\x18\x02 \x01(\x02"G\n\x06\x45ntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t"\x94\x02\n\x0fLabelAnnotation\x12\x39\n\x06\x65ntity\x18\x01 \x01(\x0b\x32).google.cloud.videointelligence.v1.Entity\x12\x44\n\x11\x63\x61tegory_entities\x18\x02 \x03(\x0b\x32).google.cloud.videointelligence.v1.Entity\x12\x41\n\x08segments\x18\x03 \x03(\x0b\x32/.google.cloud.videointelligence.v1.LabelSegment\x12=\n\x06\x66rames\x18\x04 \x03(\x0b\x32-.google.cloud.videointelligence.v1.LabelFrame"\x95\x01\n\x14\x45xplicitContentFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12M\n\x16pornography_likelihood\x18\x02 \x01(\x0e\x32-.google.cloud.videointelligence.v1.Likelihood"d\n\x19\x45xplicitContentAnnotation\x12G\n\x06\x66rames\x18\x01 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1.ExplicitContentFrame"Q\n\x15NormalizedBoundingBox\x12\x0c\n\x04left\x18\x01 \x01(\x02\x12\x0b\n\x03top\x18\x02 \x01(\x02\x12\r\n\x05right\x18\x03 \x01(\x02\x12\x0e\n\x06\x62ottom\x18\x04 \x01(\x02"O\n\x0b\x46\x61\x63\x65Segment\x12@\n\x07segment\x18\x01 \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment"\x98\x01\n\tFaceFrame\x12[\n\x19normalized_bounding_boxes\x18\x01 \x03(\x0b\x32\x38.google.cloud.videointelligence.v1.NormalizedBoundingBox\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xa3\x01\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x11\n\tthumbnail\x18\x01 \x01(\x0c\x12@\n\x08segments\x18\x02 \x03(\x0b\x32..google.cloud.videointelligence.v1.FaceSegment\x12<\n\x06\x66rames\x18\x03 \x03(\x0b\x32,.google.cloud.videointelligence.v1.FaceFrame"\xbd\x08\n\x16VideoAnnotationResults\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12@\n\x07segment\x18\n \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment\x12U\n\x19segment_label_annotations\x18\x02 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1.LabelAnnotation\x12^\n"segment_presence_label_annotations\x18\x17 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1.LabelAnnotation\x12R\n\x16shot_label_annotations\x18\x03 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1.LabelAnnotation\x12[\n\x1fshot_presence_label_annotations\x18\x18 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1.LabelAnnotation\x12S\n\x17\x66rame_label_annotations\x18\x04 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1.LabelAnnotation\x12K\n\x10\x66\x61\x63\x65_annotations\x18\x05 \x03(\x0b\x32\x31.google.cloud.videointelligence.v1.FaceAnnotation\x12I\n\x10shot_annotations\x18\x06 \x03(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment\x12Y\n\x13\x65xplicit_annotation\x18\x07 \x01(\x0b\x32<.google.cloud.videointelligence.v1.ExplicitContentAnnotation\x12U\n\x15speech_transcriptions\x18\x0b \x03(\x0b\x32\x36.google.cloud.videointelligence.v1.SpeechTranscription\x12K\n\x10text_annotations\x18\x0c \x03(\x0b\x32\x31.google.cloud.videointelligence.v1.TextAnnotation\x12W\n\x12object_annotations\x18\x0e \x03(\x0b\x32;.google.cloud.videointelligence.v1.ObjectTrackingAnnotation\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status"n\n\x15\x41nnotateVideoResponse\x12U\n\x12\x61nnotation_results\x18\x01 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1.VideoAnnotationResults"\xa6\x02\n\x17VideoAnnotationProgress\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x18\n\x10progress_percent\x18\x02 \x01(\x05\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12;\n\x07\x66\x65\x61ture\x18\x05 \x01(\x0e\x32*.google.cloud.videointelligence.v1.Feature\x12@\n\x07segment\x18\x06 \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment"p\n\x15\x41nnotateVideoProgress\x12W\n\x13\x61nnotation_progress\x18\x01 \x03(\x0b\x32:.google.cloud.videointelligence.v1.VideoAnnotationProgress"\xd4\x02\n\x19SpeechTranscriptionConfig\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x18\n\x10max_alternatives\x18\x02 \x01(\x05\x12\x18\n\x10\x66ilter_profanity\x18\x03 \x01(\x08\x12I\n\x0fspeech_contexts\x18\x04 \x03(\x0b\x32\x30.google.cloud.videointelligence.v1.SpeechContext\x12$\n\x1c\x65nable_automatic_punctuation\x18\x05 \x01(\x08\x12\x14\n\x0c\x61udio_tracks\x18\x06 \x03(\x05\x12"\n\x1a\x65nable_speaker_diarization\x18\x07 \x01(\x08\x12!\n\x19\x64iarization_speaker_count\x18\x08 \x01(\x05\x12\x1e\n\x16\x65nable_word_confidence\x18\t \x01(\x08" \n\rSpeechContext\x12\x0f\n\x07phrases\x18\x01 \x03(\t"\x83\x01\n\x13SpeechTranscription\x12U\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32?.google.cloud.videointelligence.v1.SpeechRecognitionAlternative\x12\x15\n\rlanguage_code\x18\x02 \x01(\t"\x82\x01\n\x1cSpeechRecognitionAlternative\x12\x12\n\ntranscript\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12:\n\x05words\x18\x03 \x03(\x0b\x32+.google.cloud.videointelligence.v1.WordInfo"\x9d\x01\n\x08WordInfo\x12-\n\nstart_time\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12+\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x0c\n\x04word\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x12\x13\n\x0bspeaker_tag\x18\x05 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"_\n\x16NormalizedBoundingPoly\x12\x45\n\x08vertices\x18\x01 \x03(\x0b\x32\x33.google.cloud.videointelligence.v1.NormalizedVertex"\xa1\x01\n\x0bTextSegment\x12@\n\x07segment\x18\x01 \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12<\n\x06\x66rames\x18\x03 \x03(\x0b\x32,.google.cloud.videointelligence.v1.TextFrame"\x94\x01\n\tTextFrame\x12W\n\x14rotated_bounding_box\x18\x01 \x01(\x0b\x32\x39.google.cloud.videointelligence.v1.NormalizedBoundingPoly\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"`\n\x0eTextAnnotation\x12\x0c\n\x04text\x18\x01 \x01(\t\x12@\n\x08segments\x18\x02 \x03(\x0b\x32..google.cloud.videointelligence.v1.TextSegment"\xa0\x01\n\x13ObjectTrackingFrame\x12Y\n\x17normalized_bounding_box\x18\x01 \x01(\x0b\x32\x38.google.cloud.videointelligence.v1.NormalizedBoundingBox\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\x97\x02\n\x18ObjectTrackingAnnotation\x12\x42\n\x07segment\x18\x03 \x01(\x0b\x32/.google.cloud.videointelligence.v1.VideoSegmentH\x00\x12\x12\n\x08track_id\x18\x05 \x01(\x03H\x00\x12\x39\n\x06\x65ntity\x18\x01 \x01(\x0b\x32).google.cloud.videointelligence.v1.Entity\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x12\x46\n\x06\x66rames\x18\x02 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1.ObjectTrackingFrameB\x0c\n\ntrack_info*\xc9\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x13\n\x0fLABEL_DETECTION\x10\x01\x12\x19\n\x15SHOT_CHANGE_DETECTION\x10\x02\x12\x1e\n\x1a\x45XPLICIT_CONTENT_DETECTION\x10\x03\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x04\x12\x18\n\x14SPEECH_TRANSCRIPTION\x10\x06\x12\x12\n\x0eTEXT_DETECTION\x10\x07\x12\x13\n\x0fOBJECT_TRACKING\x10\t*r\n\x12LabelDetectionMode\x12$\n LABEL_DETECTION_MODE_UNSPECIFIED\x10\x00\x12\r\n\tSHOT_MODE\x10\x01\x12\x0e\n\nFRAME_MODE\x10\x02\x12\x17\n\x13SHOT_AND_FRAME_MODE\x10\x03*t\n\nLikelihood\x12\x1a\n\x16LIKELIHOOD_UNSPECIFIED\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xfa\x01\n\x18VideoIntelligenceService\x12\x87\x01\n\rAnnotateVideo\x12\x37.google.cloud.videointelligence.v1.AnnotateVideoRequest\x1a\x1d.google.longrunning.Operation"\x1e\x82\xd3\xe4\x93\x02\x18"\x13/v1/videos:annotate:\x01*\x1aT\xca\x41 videointelligence.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\x8b\x02\n%com.google.cloud.videointelligence.v1B\x1dVideoIntelligenceServiceProtoP\x01ZRgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1;videointelligence\xaa\x02!Google.Cloud.VideoIntelligence.V1\xca\x02!Google\\Cloud\\VideoIntelligence\\V1\xea\x02$Google::Cloud::VideoIntelligence::V1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.videointelligence.v1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_CHANGE_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPLICIT_CONTENT_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPEECH_TRANSCRIPTION",
+            index=5,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=6, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_TRACKING",
+            index=7,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6570,
+    serialized_end=6771,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE)
+
+Feature = enum_type_wrapper.EnumTypeWrapper(_FEATURE)
+_LABELDETECTIONMODE = _descriptor.EnumDescriptor(
+    name="LabelDetectionMode",
+    full_name="google.cloud.videointelligence.v1.LabelDetectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_MODE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_MODE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_AND_FRAME_MODE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6773,
+    serialized_end=6887,
+)
+_sym_db.RegisterEnumDescriptor(_LABELDETECTIONMODE)
+
+LabelDetectionMode = enum_type_wrapper.EnumTypeWrapper(_LABELDETECTIONMODE)
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.videointelligence.v1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LIKELIHOOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=6889,
+    serialized_end=7005,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+FEATURE_UNSPECIFIED = 0
+LABEL_DETECTION = 1
+SHOT_CHANGE_DETECTION = 2
+EXPLICIT_CONTENT_DETECTION = 3
+FACE_DETECTION = 4
+SPEECH_TRANSCRIPTION = 6
+TEXT_DETECTION = 7
+OBJECT_TRACKING = 9
+LABEL_DETECTION_MODE_UNSPECIFIED = 0
+SHOT_MODE = 1
+FRAME_MODE = 2
+SHOT_AND_FRAME_MODE = 3
+LIKELIHOOD_UNSPECIFIED = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_ANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="AnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest.input_content",
+            index=1,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest.features",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_context",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest.video_context",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest.output_uri",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoRequest.location_id",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=286,
+    serialized_end=525,
+)
+
+
+_VIDEOCONTEXT = _descriptor.Descriptor(
+    name="VideoContext",
+    full_name="google.cloud.videointelligence.v1.VideoContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1.VideoContext.segments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.label_detection_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.shot_change_detection_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_content_detection_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.explicit_content_detection_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="face_detection_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.face_detection_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_transcription_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.speech_transcription_config",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_detection_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.text_detection_config",
+            index=6,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_config",
+            full_name="google.cloud.videointelligence.v1.VideoContext.object_tracking_config",
+            index=7,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=528,
+    serialized_end=1270,
+)
+
+
+_LABELDETECTIONCONFIG = _descriptor.Descriptor(
+    name="LabelDetectionConfig",
+    full_name="google.cloud.videointelligence.v1.LabelDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label_detection_mode",
+            full_name="google.cloud.videointelligence.v1.LabelDetectionConfig.label_detection_mode",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1.LabelDetectionConfig.stationary_camera",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1.LabelDetectionConfig.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_confidence_threshold",
+            full_name="google.cloud.videointelligence.v1.LabelDetectionConfig.frame_confidence_threshold",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_confidence_threshold",
+            full_name="google.cloud.videointelligence.v1.LabelDetectionConfig.video_confidence_threshold",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1273,
+    serialized_end=1494,
+)
+
+
+_SHOTCHANGEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ShotChangeDetectionConfig",
+    full_name="google.cloud.videointelligence.v1.ShotChangeDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1.ShotChangeDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1496,
+    serialized_end=1538,
+)
+
+
+_EXPLICITCONTENTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ExplicitContentDetectionConfig",
+    full_name="google.cloud.videointelligence.v1.ExplicitContentDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1.ExplicitContentDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1540,
+    serialized_end=1587,
+)
+
+
+_FACEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="FaceDetectionConfig",
+    full_name="google.cloud.videointelligence.v1.FaceDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1.FaceDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_bounding_boxes",
+            full_name="google.cloud.videointelligence.v1.FaceDetectionConfig.include_bounding_boxes",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1589,
+    serialized_end=1657,
+)
+
+
+_OBJECTTRACKINGCONFIG = _descriptor.Descriptor(
+    name="ObjectTrackingConfig",
+    full_name="google.cloud.videointelligence.v1.ObjectTrackingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1659,
+    serialized_end=1696,
+)
+
+
+_TEXTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="TextDetectionConfig",
+    full_name="google.cloud.videointelligence.v1.TextDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.videointelligence.v1.TextDetectionConfig.language_hints",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1.TextDetectionConfig.model",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1698,
+    serialized_end=1758,
+)
+
+
+_VIDEOSEGMENT = _descriptor.Descriptor(
+    name="VideoSegment",
+    full_name="google.cloud.videointelligence.v1.VideoSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.videointelligence.v1.VideoSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.videointelligence.v1.VideoSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1760,
+    serialized_end=1880,
+)
+
+
+_LABELSEGMENT = _descriptor.Descriptor(
+    name="LabelSegment",
+    full_name="google.cloud.videointelligence.v1.LabelSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1.LabelSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1.LabelSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1882,
+    serialized_end=1982,
+)
+
+
+_LABELFRAME = _descriptor.Descriptor(
+    name="LabelFrame",
+    full_name="google.cloud.videointelligence.v1.LabelFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1.LabelFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1.LabelFrame.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1984,
+    serialized_end=2064,
+)
+
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.videointelligence.v1.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.videointelligence.v1.Entity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.videointelligence.v1.Entity.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1.Entity.language_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2066,
+    serialized_end=2137,
+)
+
+
+_LABELANNOTATION = _descriptor.Descriptor(
+    name="LabelAnnotation",
+    full_name="google.cloud.videointelligence.v1.LabelAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1.LabelAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category_entities",
+            full_name="google.cloud.videointelligence.v1.LabelAnnotation.category_entities",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1.LabelAnnotation.segments",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1.LabelAnnotation.frames",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2140,
+    serialized_end=2416,
+)
+
+
+_EXPLICITCONTENTFRAME = _descriptor.Descriptor(
+    name="ExplicitContentFrame",
+    full_name="google.cloud.videointelligence.v1.ExplicitContentFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1.ExplicitContentFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pornography_likelihood",
+            full_name="google.cloud.videointelligence.v1.ExplicitContentFrame.pornography_likelihood",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2419,
+    serialized_end=2568,
+)
+
+
+_EXPLICITCONTENTANNOTATION = _descriptor.Descriptor(
+    name="ExplicitContentAnnotation",
+    full_name="google.cloud.videointelligence.v1.ExplicitContentAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1.ExplicitContentAnnotation.frames",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2570,
+    serialized_end=2670,
+)
+
+
+_NORMALIZEDBOUNDINGBOX = _descriptor.Descriptor(
+    name="NormalizedBoundingBox",
+    full_name="google.cloud.videointelligence.v1.NormalizedBoundingBox",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="left",
+            full_name="google.cloud.videointelligence.v1.NormalizedBoundingBox.left",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top",
+            full_name="google.cloud.videointelligence.v1.NormalizedBoundingBox.top",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="right",
+            full_name="google.cloud.videointelligence.v1.NormalizedBoundingBox.right",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bottom",
+            full_name="google.cloud.videointelligence.v1.NormalizedBoundingBox.bottom",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2672,
+    serialized_end=2753,
+)
+
+
+_FACESEGMENT = _descriptor.Descriptor(
+    name="FaceSegment",
+    full_name="google.cloud.videointelligence.v1.FaceSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1.FaceSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2755,
+    serialized_end=2834,
+)
+
+
+_FACEFRAME = _descriptor.Descriptor(
+    name="FaceFrame",
+    full_name="google.cloud.videointelligence.v1.FaceFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_boxes",
+            full_name="google.cloud.videointelligence.v1.FaceFrame.normalized_bounding_boxes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1.FaceFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2837,
+    serialized_end=2989,
+)
+
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.videointelligence.v1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="thumbnail",
+            full_name="google.cloud.videointelligence.v1.FaceAnnotation.thumbnail",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1.FaceAnnotation.segments",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1.FaceAnnotation.frames",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2992,
+    serialized_end=3155,
+)
+
+
+_VIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="VideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1.VideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.segment",
+            index=1,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment_label_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.segment_label_annotations",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment_presence_label_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.segment_presence_label_annotations",
+            index=3,
+            number=23,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_label_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.shot_label_annotations",
+            index=4,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_presence_label_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.shot_presence_label_annotations",
+            index=5,
+            number=24,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_label_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.frame_label_annotations",
+            index=6,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.face_annotations",
+            index=7,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.shot_annotations",
+            index=8,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_annotation",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.explicit_annotation",
+            index=9,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_transcriptions",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.speech_transcriptions",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.text_annotations",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_annotations",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.object_annotations",
+            index=12,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationResults.error",
+            index=13,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3158,
+    serialized_end=4243,
+)
+
+
+_ANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="AnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1.AnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoResponse.annotation_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4245,
+    serialized_end=4355,
+)
+
+
+_VIDEOANNOTATIONPROGRESS = _descriptor.Descriptor(
+    name="VideoAnnotationProgress",
+    full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress.progress_percent",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="feature",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress.feature",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1.VideoAnnotationProgress.segment",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4358,
+    serialized_end=4652,
+)
+
+
+_ANNOTATEVIDEOPROGRESS = _descriptor.Descriptor(
+    name="AnnotateVideoProgress",
+    full_name="google.cloud.videointelligence.v1.AnnotateVideoProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_progress",
+            full_name="google.cloud.videointelligence.v1.AnnotateVideoProgress.annotation_progress",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4654,
+    serialized_end=4766,
+)
+
+
+_SPEECHTRANSCRIPTIONCONFIG = _descriptor.Descriptor(
+    name="SpeechTranscriptionConfig",
+    full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_alternatives",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.max_alternatives",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter_profanity",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.filter_profanity",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_contexts",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.speech_contexts",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_automatic_punctuation",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.enable_automatic_punctuation",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_tracks",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.audio_tracks",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_speaker_diarization",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.enable_speaker_diarization",
+            index=6,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="diarization_speaker_count",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.diarization_speaker_count",
+            index=7,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_word_confidence",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscriptionConfig.enable_word_confidence",
+            index=8,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4769,
+    serialized_end=5109,
+)
+
+
+_SPEECHCONTEXT = _descriptor.Descriptor(
+    name="SpeechContext",
+    full_name="google.cloud.videointelligence.v1.SpeechContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="phrases",
+            full_name="google.cloud.videointelligence.v1.SpeechContext.phrases",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5111,
+    serialized_end=5143,
+)
+
+
+_SPEECHTRANSCRIPTION = _descriptor.Descriptor(
+    name="SpeechTranscription",
+    full_name="google.cloud.videointelligence.v1.SpeechTranscription",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscription.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1.SpeechTranscription.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5146,
+    serialized_end=5277,
+)
+
+
+_SPEECHRECOGNITIONALTERNATIVE = _descriptor.Descriptor(
+    name="SpeechRecognitionAlternative",
+    full_name="google.cloud.videointelligence.v1.SpeechRecognitionAlternative",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transcript",
+            full_name="google.cloud.videointelligence.v1.SpeechRecognitionAlternative.transcript",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1.SpeechRecognitionAlternative.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.videointelligence.v1.SpeechRecognitionAlternative.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5280,
+    serialized_end=5410,
+)
+
+
+_WORDINFO = _descriptor.Descriptor(
+    name="WordInfo",
+    full_name="google.cloud.videointelligence.v1.WordInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1.WordInfo.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.videointelligence.v1.WordInfo.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="word",
+            full_name="google.cloud.videointelligence.v1.WordInfo.word",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1.WordInfo.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speaker_tag",
+            full_name="google.cloud.videointelligence.v1.WordInfo.speaker_tag",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5413,
+    serialized_end=5570,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.videointelligence.v1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.videointelligence.v1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.videointelligence.v1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5572,
+    serialized_end=5612,
+)
+
+
+_NORMALIZEDBOUNDINGPOLY = _descriptor.Descriptor(
+    name="NormalizedBoundingPoly",
+    full_name="google.cloud.videointelligence.v1.NormalizedBoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.videointelligence.v1.NormalizedBoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5614,
+    serialized_end=5709,
+)
+
+
+_TEXTSEGMENT = _descriptor.Descriptor(
+    name="TextSegment",
+    full_name="google.cloud.videointelligence.v1.TextSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1.TextSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1.TextSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1.TextSegment.frames",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5712,
+    serialized_end=5873,
+)
+
+
+_TEXTFRAME = _descriptor.Descriptor(
+    name="TextFrame",
+    full_name="google.cloud.videointelligence.v1.TextFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="rotated_bounding_box",
+            full_name="google.cloud.videointelligence.v1.TextFrame.rotated_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1.TextFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5876,
+    serialized_end=6024,
+)
+
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.videointelligence.v1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.videointelligence.v1.TextAnnotation.text",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1.TextAnnotation.segments",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6026,
+    serialized_end=6122,
+)
+
+
+_OBJECTTRACKINGFRAME = _descriptor.Descriptor(
+    name="ObjectTrackingFrame",
+    full_name="google.cloud.videointelligence.v1.ObjectTrackingFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_box",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingFrame.normalized_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6125,
+    serialized_end=6285,
+)
+
+
+_OBJECTTRACKINGANNOTATION = _descriptor.Descriptor(
+    name="ObjectTrackingAnnotation",
+    full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation.segment",
+            index=0,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="track_id",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation.track_id",
+            index=1,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation.entity",
+            index=2,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation.frames",
+            index=4,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="track_info",
+            full_name="google.cloud.videointelligence.v1.ObjectTrackingAnnotation.track_info",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=6288,
+    serialized_end=6567,
+)
+
+_ANNOTATEVIDEOREQUEST.fields_by_name["features"].enum_type = _FEATURE
+_ANNOTATEVIDEOREQUEST.fields_by_name["video_context"].message_type = _VIDEOCONTEXT
+_VIDEOCONTEXT.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_VIDEOCONTEXT.fields_by_name[
+    "label_detection_config"
+].message_type = _LABELDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "shot_change_detection_config"
+].message_type = _SHOTCHANGEDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "explicit_content_detection_config"
+].message_type = _EXPLICITCONTENTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "face_detection_config"
+].message_type = _FACEDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "speech_transcription_config"
+].message_type = _SPEECHTRANSCRIPTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "text_detection_config"
+].message_type = _TEXTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "object_tracking_config"
+].message_type = _OBJECTTRACKINGCONFIG
+_LABELDETECTIONCONFIG.fields_by_name[
+    "label_detection_mode"
+].enum_type = _LABELDETECTIONMODE
+_VIDEOSEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOSEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_LABELFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["category_entities"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["segments"].message_type = _LABELSEGMENT
+_LABELANNOTATION.fields_by_name["frames"].message_type = _LABELFRAME
+_EXPLICITCONTENTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_EXPLICITCONTENTFRAME.fields_by_name["pornography_likelihood"].enum_type = _LIKELIHOOD
+_EXPLICITCONTENTANNOTATION.fields_by_name["frames"].message_type = _EXPLICITCONTENTFRAME
+_FACESEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_FACEFRAME.fields_by_name[
+    "normalized_bounding_boxes"
+].message_type = _NORMALIZEDBOUNDINGBOX
+_FACEFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_FACEANNOTATION.fields_by_name["segments"].message_type = _FACESEGMENT
+_FACEANNOTATION.fields_by_name["frames"].message_type = _FACEFRAME
+_VIDEOANNOTATIONRESULTS.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "segment_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "segment_presence_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_presence_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "frame_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "face_annotations"
+].message_type = _FACEANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name["shot_annotations"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "explicit_annotation"
+].message_type = _EXPLICITCONTENTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "speech_transcriptions"
+].message_type = _SPEECHTRANSCRIPTION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "text_annotations"
+].message_type = _TEXTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "object_annotations"
+].message_type = _OBJECTTRACKINGANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _VIDEOANNOTATIONRESULTS
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name["feature"].enum_type = _FEATURE
+_VIDEOANNOTATIONPROGRESS.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_ANNOTATEVIDEOPROGRESS.fields_by_name[
+    "annotation_progress"
+].message_type = _VIDEOANNOTATIONPROGRESS
+_SPEECHTRANSCRIPTIONCONFIG.fields_by_name[
+    "speech_contexts"
+].message_type = _SPEECHCONTEXT
+_SPEECHTRANSCRIPTION.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_SPEECHRECOGNITIONALTERNATIVE.fields_by_name["words"].message_type = _WORDINFO
+_WORDINFO.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_WORDINFO.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_NORMALIZEDBOUNDINGPOLY.fields_by_name["vertices"].message_type = _NORMALIZEDVERTEX
+_TEXTSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_TEXTSEGMENT.fields_by_name["frames"].message_type = _TEXTFRAME
+_TEXTFRAME.fields_by_name["rotated_bounding_box"].message_type = _NORMALIZEDBOUNDINGPOLY
+_TEXTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TEXTANNOTATION.fields_by_name["segments"].message_type = _TEXTSEGMENT
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "normalized_bounding_box"
+].message_type = _NORMALIZEDBOUNDINGBOX
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_OBJECTTRACKINGANNOTATION.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_OBJECTTRACKINGANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_OBJECTTRACKINGANNOTATION.fields_by_name["frames"].message_type = _OBJECTTRACKINGFRAME
+_OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"].fields.append(
+    _OBJECTTRACKINGANNOTATION.fields_by_name["segment"]
+)
+_OBJECTTRACKINGANNOTATION.fields_by_name[
+    "segment"
+].containing_oneof = _OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"]
+_OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"].fields.append(
+    _OBJECTTRACKINGANNOTATION.fields_by_name["track_id"]
+)
+_OBJECTTRACKINGANNOTATION.fields_by_name[
+    "track_id"
+].containing_oneof = _OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"]
+DESCRIPTOR.message_types_by_name["AnnotateVideoRequest"] = _ANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["VideoContext"] = _VIDEOCONTEXT
+DESCRIPTOR.message_types_by_name["LabelDetectionConfig"] = _LABELDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ShotChangeDetectionConfig"
+] = _SHOTCHANGEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentDetectionConfig"
+] = _EXPLICITCONTENTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["FaceDetectionConfig"] = _FACEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["ObjectTrackingConfig"] = _OBJECTTRACKINGCONFIG
+DESCRIPTOR.message_types_by_name["TextDetectionConfig"] = _TEXTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["VideoSegment"] = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["LabelSegment"] = _LABELSEGMENT
+DESCRIPTOR.message_types_by_name["LabelFrame"] = _LABELFRAME
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["LabelAnnotation"] = _LABELANNOTATION
+DESCRIPTOR.message_types_by_name["ExplicitContentFrame"] = _EXPLICITCONTENTFRAME
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentAnnotation"
+] = _EXPLICITCONTENTANNOTATION
+DESCRIPTOR.message_types_by_name["NormalizedBoundingBox"] = _NORMALIZEDBOUNDINGBOX
+DESCRIPTOR.message_types_by_name["FaceSegment"] = _FACESEGMENT
+DESCRIPTOR.message_types_by_name["FaceFrame"] = _FACEFRAME
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["VideoAnnotationResults"] = _VIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["AnnotateVideoResponse"] = _ANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name["VideoAnnotationProgress"] = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoProgress"] = _ANNOTATEVIDEOPROGRESS
+DESCRIPTOR.message_types_by_name[
+    "SpeechTranscriptionConfig"
+] = _SPEECHTRANSCRIPTIONCONFIG
+DESCRIPTOR.message_types_by_name["SpeechContext"] = _SPEECHCONTEXT
+DESCRIPTOR.message_types_by_name["SpeechTranscription"] = _SPEECHTRANSCRIPTION
+DESCRIPTOR.message_types_by_name[
+    "SpeechRecognitionAlternative"
+] = _SPEECHRECOGNITIONALTERNATIVE
+DESCRIPTOR.message_types_by_name["WordInfo"] = _WORDINFO
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["NormalizedBoundingPoly"] = _NORMALIZEDBOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["TextSegment"] = _TEXTSEGMENT
+DESCRIPTOR.message_types_by_name["TextFrame"] = _TEXTFRAME
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["ObjectTrackingFrame"] = _OBJECTTRACKINGFRAME
+DESCRIPTOR.message_types_by_name["ObjectTrackingAnnotation"] = _OBJECTTRACKINGANNOTATION
+DESCRIPTOR.enum_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.enum_types_by_name["LabelDetectionMode"] = _LABELDETECTIONMODE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation request.
+  
+  
+  Attributes:
+      input_uri:
+          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.
+      input_content:
+          The video data bytes. If unset, the input video(s) should be
+          specified via ``input_uri``. If set, ``input_uri`` should be
+          unset.
+      features:
+          Requested video annotation features.
+      video_context:
+          Additional video context and/or feature-specific parameters.
+      output_uri:
+          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>`__.
+      location_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.AnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoRequest)
+
+VideoContext = _reflection.GeneratedProtocolMessageType(
+    "VideoContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCONTEXT,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      segments:
+          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.
+      label_detection_config:
+          Config for LABEL\_DETECTION.
+      shot_change_detection_config:
+          Config for SHOT\_CHANGE\_DETECTION.
+      explicit_content_detection_config:
+          Config for EXPLICIT\_CONTENT\_DETECTION.
+      face_detection_config:
+          Config for FACE\_DETECTION.
+      speech_transcription_config:
+          Config for SPEECH\_TRANSCRIPTION.
+      text_detection_config:
+          Config for TEXT\_DETECTION.
+      object_tracking_config:
+          Config for OBJECT\_TRACKING.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.VideoContext)
+    ),
+)
+_sym_db.RegisterMessage(VideoContext)
+
+LabelDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "LabelDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for LABEL\_DETECTION.
+  
+  
+  Attributes:
+      label_detection_mode:
+          What labels should be detected with LABEL\_DETECTION, in
+          addition to video-level labels or segment-level labels. If
+          unspecified, defaults to ``SHOT_MODE``.
+      stationary_camera:
+          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.
+      model:
+          Model to use for label detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+      frame_confidence_threshold:
+          The confidence threshold we perform filtering on the labels
+          from 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 the default threshold everytime when we release a new
+          model.
+      video_confidence_threshold:
+          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 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 the default threshold everytime when
+          we release a new model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.LabelDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(LabelDetectionConfig)
+
+ShotChangeDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ShotChangeDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SHOTCHANGEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for SHOT\_CHANGE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for shot change detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ShotChangeDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ShotChangeDetectionConfig)
+
+ExplicitContentDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for EXPLICIT\_CONTENT\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for explicit content detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ExplicitContentDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentDetectionConfig)
+
+FaceDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "FaceDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for FACE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for face detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+      include_bounding_boxes:
+          Whether bounding boxes be included in the face annotation
+          output.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.FaceDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(FaceDetectionConfig)
+
+ObjectTrackingConfig = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for OBJECT\_TRACKING.
+  
+  
+  Attributes:
+      model:
+          Model to use for object tracking. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ObjectTrackingConfig)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingConfig)
+
+TextDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "TextDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for TEXT\_DETECTION.
+  
+  
+  Attributes:
+      language_hints:
+          Language hint can be specified if the language to be detected
+          is known a priori. It can increase the accuracy of the
+          detection. Language hint must be language code in BCP-47
+          format.  Automatic language detection is performed if no hint
+          is provided.
+      model:
+          Model to use for text detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.TextDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(TextDetectionConfig)
+
+VideoSegment = _reflection.GeneratedProtocolMessageType(
+    "VideoSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOSEGMENT,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video segment.
+  
+  
+  Attributes:
+      start_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the start of the segment (inclusive).
+      end_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the end of the segment (inclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.VideoSegment)
+    ),
+)
+_sym_db.RegisterMessage(VideoSegment)
+
+LabelSegment = _reflection.GeneratedProtocolMessageType(
+    "LabelSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELSEGMENT,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for label detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a label was detected.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.LabelSegment)
+    ),
+)
+_sym_db.RegisterMessage(LabelSegment)
+
+LabelFrame = _reflection.GeneratedProtocolMessageType(
+    "LabelFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELFRAME,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for label detection.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.LabelFrame)
+    ),
+)
+_sym_db.RegisterMessage(LabelFrame)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Detected entity from video analysis.
+  
+  
+  Attributes:
+      entity_id:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      description:
+          Textual description, e.g. ``Fixed-gear bicycle``.
+      language_code:
+          Language code for ``description`` in BCP-47 format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+
+LabelAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LabelAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELANNOTATION,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Label annotation.
+  
+  
+  Attributes:
+      entity:
+          Detected entity.
+      category_entities:
+          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``.
+      segments:
+          All video segments where a label was detected.
+      frames:
+          All video frames where a label was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.LabelAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LabelAnnotation)
+
+ExplicitContentFrame = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTFRAME,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for explicit content.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      pornography_likelihood:
+          Likelihood of the pornography content..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ExplicitContentFrame)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentFrame)
+
+ExplicitContentAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTANNOTATION,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Explicit content annotation (based on per-frame visual signals only). If
+  no explicit content has been detected in a frame, no annotations are
+  present for that frame.
+  
+  
+  Attributes:
+      frames:
+          All video frames where explicit content was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ExplicitContentAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentAnnotation)
+
+NormalizedBoundingBox = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingBox",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGBOX,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding box. The normalized vertex coordinates are relative
+  to the original image. Range: [0, 1].
+  
+  
+  Attributes:
+      left:
+          Left X coordinate.
+      top:
+          Top Y coordinate.
+      right:
+          Right X coordinate.
+      bottom:
+          Bottom Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.NormalizedBoundingBox)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingBox)
+
+FaceSegment = _reflection.GeneratedProtocolMessageType(
+    "FaceSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACESEGMENT,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for face detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a face was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.FaceSegment)
+    ),
+)
+_sym_db.RegisterMessage(FaceSegment)
+
+FaceFrame = _reflection.GeneratedProtocolMessageType(
+    "FaceFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEFRAME,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for face detection.
+  
+  
+  Attributes:
+      normalized_bounding_boxes:
+          Normalized Bounding boxes in a frame. There can be more than
+          one boxes if the same face is detected in multiple locations
+          within the current frame.
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.FaceFrame)
+    ),
+)
+_sym_db.RegisterMessage(FaceFrame)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Face annotation.
+  
+  
+  Attributes:
+      thumbnail:
+          Thumbnail of a representative face view (in JPEG format).
+      segments:
+          All video segments where a face was detected.
+      frames:
+          All video frames where a face was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+
+VideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Annotation results for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      segment:
+          Video segment on which the annotation is run.
+      segment_label_annotations:
+          Topical label annotations on video level or user specified
+          segment level. There is exactly one element for each unique
+          label.
+      segment_presence_label_annotations:
+          Presence label annotations on video level or user specified
+          segment level. There is exactly one element for each unique
+          label. This will eventually get publicly exposed and the
+          restriction will be removed.
+      shot_label_annotations:
+          Topical label annotations on shot level. There is exactly one
+          element for each unique label.
+      shot_presence_label_annotations:
+          Presence label annotations on shot level. There is exactly one
+          element for each unique label. This will eventually get
+          publicly exposed and the restriction will be removed.
+      frame_label_annotations:
+          Label annotations on frame level. There is exactly one element
+          for each unique label.
+      face_annotations:
+          Face annotations. There is exactly one element for each unique
+          face.
+      shot_annotations:
+          Shot annotations. Each shot is represented as a video segment.
+      explicit_annotation:
+          Explicit content annotation.
+      speech_transcriptions:
+          Speech transcription.
+      text_annotations:
+          OCR text detection and tracking. Annotations for list of
+          detected text snippets. Each will have list of frame
+          information associated with it.
+      object_annotations:
+          Annotations for list of objects detected and tracked in video.
+      error:
+          If set, indicates an error. Note that for a single
+          ``AnnotateVideoRequest`` some videos may succeed and some may
+          fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.VideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationResults)
+
+AnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation response. Included in the ``response`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_results:
+          Annotation results for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.AnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoResponse)
+
+VideoAnnotationProgress = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONPROGRESS,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Annotation progress for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      progress_percent:
+          Approximate percentage processed thus far. Guaranteed to be
+          100 when fully processed.
+      start_time:
+          Time when the request was received.
+      update_time:
+          Time of the most recent update.
+      feature:
+          Specifies which feature is being tracked if the request
+          contains more than one features.
+      segment:
+          Specifies which segment is being tracked if the request
+          contains more than one segments.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.VideoAnnotationProgress)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationProgress)
+
+AnnotateVideoProgress = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOPROGRESS,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation progress. Included in the ``metadata`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_progress:
+          Progress metadata for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.AnnotateVideoProgress)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoProgress)
+
+SpeechTranscriptionConfig = _reflection.GeneratedProtocolMessageType(
+    "SpeechTranscriptionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHTRANSCRIPTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Config for SPEECH\_TRANSCRIPTION.
+  
+  
+  Attributes:
+      language_code:
+          *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.
+      max_alternatives:
+          *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.
+      filter_profanity:
+          *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.
+      speech_contexts:
+          *Optional* A means to provide context to assist the speech
+          recognition.
+      enable_automatic_punctuation:
+          *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."
+      audio_tracks:
+          *Optional* For file formats, such as MXF or MKV, supporting
+          multiple audio tracks, specify up to two tracks. Default:
+          track 0.
+      enable_speaker_diarization:
+          *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.
+      diarization_speaker_count:
+          *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.
+      enable_word_confidence:
+          *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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.SpeechTranscriptionConfig)
+    ),
+)
+_sym_db.RegisterMessage(SpeechTranscriptionConfig)
+
+SpeechContext = _reflection.GeneratedProtocolMessageType(
+    "SpeechContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHCONTEXT,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Provides "hints" to the speech recognizer to favor specific words and
+  phrases in the results.
+  
+  
+  Attributes:
+      phrases:
+          *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>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.SpeechContext)
+    ),
+)
+_sym_db.RegisterMessage(SpeechContext)
+
+SpeechTranscription = _reflection.GeneratedProtocolMessageType(
+    "SpeechTranscription",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHTRANSCRIPTION,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""A speech recognition result corresponding to a portion of the audio.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+      language_code:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.SpeechTranscription)
+    ),
+)
+_sym_db.RegisterMessage(SpeechTranscription)
+
+SpeechRecognitionAlternative = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionAlternative",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONALTERNATIVE,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Alternative hypotheses (a.k.a. n-best list).
+  
+  
+  Attributes:
+      transcript:
+          Transcript text representing the words that the user spoke.
+      confidence:
+          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 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.
+      words:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.SpeechRecognitionAlternative)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionAlternative)
+
+WordInfo = _reflection.GeneratedProtocolMessageType(
+    "WordInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORDINFO,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Word-specific information for recognized words. Word information is only
+  included in the response when certain request parameters are set, such
+  as ``enable_word_time_offsets``.
+  
+  
+  Attributes:
+      start_time:
+          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. This is an experimental feature and the
+          accuracy of the time offset can vary.
+      end_time:
+          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. This is an experimental feature and the
+          accuracy of the time offset can vary.
+      word:
+          The word corresponding to this set of information.
+      confidence:
+          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 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.
+      speaker_tag:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.WordInfo)
+    ),
+)
+_sym_db.RegisterMessage(WordInfo)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+NormalizedBoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGPOLY,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding polygon for text (that might not be aligned with
+  axis). Contains list of the corner points in clockwise order starting
+  from top-left corner. For example, for a rectangular bounding box: When
+  the text is horizontal it might look like: 0----1 \| \| 3----2
+  
+  When it's clockwise rotated 180 degrees around the top-left corner it
+  becomes: 2----3 \| \| 1----0
+  
+  and the vertex order will still be (0, 1, 2, 3). Note that values can be
+  less than 0, or greater than 1 due to trignometric calculations for
+  location of the box.
+  
+  
+  Attributes:
+      vertices:
+          Normalized vertices of the bounding polygon.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.NormalizedBoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingPoly)
+
+TextSegment = _reflection.GeneratedProtocolMessageType(
+    "TextSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSEGMENT,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for text detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a text snippet was detected.
+      confidence:
+          Confidence for the track of detected text. It is calculated as
+          the highest over all frames where OCR detected text appears.
+      frames:
+          Information related to the frames where OCR detected text
+          appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.TextSegment)
+    ),
+)
+_sym_db.RegisterMessage(TextSegment)
+
+TextFrame = _reflection.GeneratedProtocolMessageType(
+    "TextFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTFRAME,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for text annotation (OCR). Contains
+  information regarding timestamp and bounding box locations for the
+  frames containing detected OCR text snippets.
+  
+  
+  Attributes:
+      rotated_bounding_box:
+          Bounding polygon of the detected text for this frame.
+      time_offset:
+          Timestamp of this frame.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.TextFrame)
+    ),
+)
+_sym_db.RegisterMessage(TextFrame)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Annotations related to one detected OCR text snippet. This will contain
+  the corresponding text, confidence value, and frame level information
+  for each detection.
+  
+  
+  Attributes:
+      text:
+          The detected text.
+      segments:
+          All video segments where OCR detected text appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+
+ObjectTrackingFrame = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGFRAME,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotations for object detection and tracking. This
+  field stores per frame location, time offset, and confidence.
+  
+  
+  Attributes:
+      normalized_bounding_box:
+          The normalized bounding box location of this object track for
+          the frame.
+      time_offset:
+          The timestamp of the frame in microseconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ObjectTrackingFrame)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingFrame)
+
+ObjectTrackingAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGANNOTATION,
+        __module__="google.cloud.videointelligence_v1.proto.video_intelligence_pb2",
+        __doc__="""Annotations corresponding to one tracked object.
+  
+  
+  Attributes:
+      track_info:
+          Different representation of tracking info in non-streaming
+          batch and streaming modes.
+      segment:
+          Non-streaming batch mode ONLY. Each object track corresponds
+          to one video segment where it appears.
+      track_id:
+          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. Instead, we provide a unique
+          identifiable integer track\_id so that the customers can
+          correlate the results of the ongoing ObjectTrackAnnotation of
+          the same track\_id over time.
+      entity:
+          Entity to specify the object category that this track is
+          labeled as.
+      confidence:
+          Object category's labeling confidence of this track.
+      frames:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1.ObjectTrackingAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingAnnotation)
+
+
+DESCRIPTOR._options = None
+
+_VIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="VideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1.VideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A videointelligence.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform"
+    ),
+    serialized_start=7008,
+    serialized_end=7258,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnnotateVideo",
+            full_name="google.cloud.videointelligence.v1.VideoIntelligenceService.AnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_ANNOTATEVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\030"\023/v1/videos:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_VIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name["VideoIntelligenceService"] = _VIDEOINTELLIGENCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence_pb2_grpc.py b/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence_pb2_grpc.py
new file mode 100644
index 000000000000..672a18eb9f42
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/proto/video_intelligence_pb2_grpc.py
@@ -0,0 +1,56 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.videointelligence_v1.proto import (
+    video_intelligence_pb2 as google_dot_cloud_dot_videointelligence__v1_dot_proto_dot_video__intelligence__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class VideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnnotateVideo = channel.unary_unary(
+            "/google.cloud.videointelligence.v1.VideoIntelligenceService/AnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class VideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def AnnotateVideo(self, request, context):
+        """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).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_VideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnnotateVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1.VideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/videointelligence/google/cloud/videointelligence_v1/types.py b/videointelligence/google/cloud/videointelligence_v1/types.py
new file mode 100644
index 000000000000..6603682edcba
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.videointelligence_v1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [video_intelligence_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.videointelligence_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta1/__init__.py
new file mode 100644
index 000000000000..d71748798c3c
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1beta1 import types
+from google.cloud.videointelligence_v1beta1.gapic import enums
+from google.cloud.videointelligence_v1beta1.gapic import (
+    video_intelligence_service_client,
+)
+
+
+class VideoIntelligenceServiceClient(
+    video_intelligence_service_client.VideoIntelligenceServiceClient
+):
+    __doc__ = video_intelligence_service_client.VideoIntelligenceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "VideoIntelligenceServiceClient")
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/gapic/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/gapic/enums.py b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..7a13aca21272
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/enums.py
@@ -0,0 +1,96 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Feature(enum.IntEnum):
+    """
+    Video annotation feature.
+
+    Attributes:
+      FEATURE_UNSPECIFIED (int): Unspecified.
+      LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      FACE_DETECTION (int): Human face detection and tracking.
+      SHOT_CHANGE_DETECTION (int): Shot change detection.
+      SAFE_SEARCH_DETECTION (int): Safe search detection.
+    """
+
+    FEATURE_UNSPECIFIED = 0
+    LABEL_DETECTION = 1
+    FACE_DETECTION = 2
+    SHOT_CHANGE_DETECTION = 3
+    SAFE_SEARCH_DETECTION = 4
+
+
+class LabelDetectionMode(enum.IntEnum):
+    """
+    Label detection mode.
+
+    Attributes:
+      LABEL_DETECTION_MODE_UNSPECIFIED (int): Unspecified.
+      SHOT_MODE (int): Detect shot-level labels.
+      FRAME_MODE (int): Detect frame-level labels.
+      SHOT_AND_FRAME_MODE (int): Detect both shot-level and frame-level labels.
+    """
+
+    LABEL_DETECTION_MODE_UNSPECIFIED = 0
+    SHOT_MODE = 1
+    FRAME_MODE = 2
+    SHOT_AND_FRAME_MODE = 3
+
+
+class LabelLevel(enum.IntEnum):
+    """
+    Label level (scope).
+
+    Attributes:
+      LABEL_LEVEL_UNSPECIFIED (int): Unspecified.
+      VIDEO_LEVEL (int): Video-level. Corresponds to the whole video.
+      SEGMENT_LEVEL (int): Segment-level. Corresponds to one of ``AnnotateSpec.segments``.
+      SHOT_LEVEL (int): Shot-level. Corresponds to a single shot (i.e. a series of frames
+      without a major camera position or background change).
+      FRAME_LEVEL (int): Frame-level. Corresponds to a single video frame.
+    """
+
+    LABEL_LEVEL_UNSPECIFIED = 0
+    VIDEO_LEVEL = 1
+    SEGMENT_LEVEL = 2
+    SHOT_LEVEL = 3
+    FRAME_LEVEL = 4
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Bucketized representation of likelihood.
+
+    Attributes:
+      UNKNOWN (int): Unknown likelihood.
+      VERY_UNLIKELY (int): Very unlikely.
+      UNLIKELY (int): Unlikely.
+      POSSIBLE (int): Possible.
+      LIKELY (int): Likely.
+      VERY_LIKELY (int): Very likely.
+    """
+
+    UNKNOWN = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/gapic/transports/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/gapic/transports/video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/transports/video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..9eaba1a970b3
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/transports/video_intelligence_service_grpc_transport.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.videointelligence_v1beta1.proto import video_intelligence_pb2_grpc
+
+
+class VideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1beta1 VideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "video_intelligence_service_stub": video_intelligence_pb2_grpc.VideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def annotate_video(self):
+        """Return the gRPC stub for :meth:`VideoIntelligenceServiceClient.annotate_video`.
+
+        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).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["video_intelligence_service_stub"].AnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/gapic/video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/video_intelligence_service_client.py
new file mode 100644
index 000000000000..6a22632a434a
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/video_intelligence_service_client.py
@@ -0,0 +1,307 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1beta1 VideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import grpc
+
+from google.cloud.videointelligence_v1beta1.gapic import enums
+from google.cloud.videointelligence_v1beta1.gapic import (
+    video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1beta1.gapic.transports import (
+    video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1beta1.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1beta1.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class VideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.videointelligence.v1beta1.VideoIntelligenceService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            VideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.VideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.VideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def annotate_video(
+        self,
+        input_uri,
+        features,
+        input_content=None,
+        video_context=None,
+        output_uri=None,
+        location_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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).
+
+        Example:
+            >>> from google.cloud import videointelligence_v1beta1
+            >>> from google.cloud.videointelligence_v1beta1 import enums
+            >>>
+            >>> client = videointelligence_v1beta1.VideoIntelligenceServiceClient()
+            >>>
+            >>> input_uri = 'gs://cloud-samples-data/video/cat.mp4'
+            >>> features_element = enums.Feature.LABEL_DETECTION
+            >>> features = [features_element]
+            >>>
+            >>> response = client.annotate_video(input_uri, features)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            input_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/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.
+            features (list[~google.cloud.videointelligence_v1beta1.types.Feature]): Requested video annotation features.
+            input_content (str): 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.
+            video_context (Union[dict, ~google.cloud.videointelligence_v1beta1.types.VideoContext]): Additional video context and/or feature-specific parameters.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.videointelligence_v1beta1.types.VideoContext`
+            output_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/storage/docs/reference-uris>`__.
+            location_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.videointelligence_v1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_video,
+                default_retry=self._method_configs["AnnotateVideo"].retry,
+                default_timeout=self._method_configs["AnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri,
+            features=features,
+            input_content=input_content,
+            video_context=video_context,
+            output_uri=output_uri,
+            location_id=location_id,
+        )
+        operation = self._inner_api_calls["annotate_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            video_intelligence_pb2.AnnotateVideoResponse,
+            metadata_type=video_intelligence_pb2.AnnotateVideoProgress,
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/gapic/video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..fdf442f5c941
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/gapic/video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1beta1.VideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnnotateVideo": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/proto/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence.proto b/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence.proto
new file mode 100644
index 000000000000..430776bf0031
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence.proto
@@ -0,0 +1,345 @@
+// 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/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence_pb2.py b/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence_pb2.py
new file mode 100644
index 000000000000..df9be878c05e
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence_pb2.py
@@ -0,0 +1,1800 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/videointelligence_v1beta1/proto/video_intelligence.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/videointelligence_v1beta1/proto/video_intelligence.proto",
+    package="google.cloud.videointelligence.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.videointelligence.v1beta1B\035VideoIntelligenceServiceProtoP\001ZWgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1beta1;videointelligence\252\002&Google.Cloud.VideoIntelligence.V1Beta1\312\002&Google\\Cloud\\VideoIntelligence\\V1beta1\352\002)Google::Cloud::VideoIntelligence::V1beta1"
+    ),
+    serialized_pb=_b(
+        '\nEgoogle/cloud/videointelligence_v1beta1/proto/video_intelligence.proto\x12&google.cloud.videointelligence.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xf9\x01\n\x14\x41nnotateVideoRequest\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x15\n\rinput_content\x18\x06 \x01(\t\x12\x41\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0e\x32/.google.cloud.videointelligence.v1beta1.Feature\x12K\n\rvideo_context\x18\x03 \x01(\x0b\x32\x34.google.cloud.videointelligence.v1beta1.VideoContext\x12\x12\n\noutput_uri\x18\x04 \x01(\t\x12\x13\n\x0blocation_id\x18\x05 \x01(\t"\xd2\x02\n\x0cVideoContext\x12\x46\n\x08segments\x18\x01 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta1.VideoSegment\x12X\n\x14label_detection_mode\x18\x02 \x01(\x0e\x32:.google.cloud.videointelligence.v1beta1.LabelDetectionMode\x12\x19\n\x11stationary_camera\x18\x03 \x01(\x08\x12\x1d\n\x15label_detection_model\x18\x04 \x01(\t\x12\x1c\n\x14\x66\x61\x63\x65_detection_model\x18\x05 \x01(\t\x12#\n\x1bshot_change_detection_model\x18\x06 \x01(\t\x12#\n\x1bsafe_search_detection_model\x18\x07 \x01(\t"B\n\x0cVideoSegment\x12\x19\n\x11start_time_offset\x18\x01 \x01(\x03\x12\x17\n\x0f\x65nd_time_offset\x18\x02 \x01(\x03"\xad\x01\n\rLabelLocation\x12\x45\n\x07segment\x18\x01 \x01(\x0b\x32\x34.google.cloud.videointelligence.v1beta1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x41\n\x05level\x18\x03 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta1.LabelLevel"\x87\x01\n\x0fLabelAnnotation\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\t\x12H\n\tlocations\x18\x03 \x03(\x0b\x32\x35.google.cloud.videointelligence.v1beta1.LabelLocation"\xfd\x02\n\x14SafeSearchAnnotation\x12\x41\n\x05\x61\x64ult\x18\x01 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta1.Likelihood\x12\x41\n\x05spoof\x18\x02 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta1.Likelihood\x12\x43\n\x07medical\x18\x03 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta1.Likelihood\x12\x43\n\x07violent\x18\x04 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta1.Likelihood\x12@\n\x04racy\x18\x05 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta1.Likelihood\x12\x13\n\x0btime_offset\x18\x06 \x01(\x03"G\n\x0b\x42oundingBox\x12\x0c\n\x04left\x18\x01 \x01(\x05\x12\r\n\x05right\x18\x02 \x01(\x05\x12\x0e\n\x06\x62ottom\x18\x03 \x01(\x05\x12\x0b\n\x03top\x18\x04 \x01(\x05"n\n\x0c\x46\x61\x63\x65Location\x12I\n\x0c\x62ounding_box\x18\x01 \x01(\x0b\x32\x33.google.cloud.videointelligence.v1beta1.BoundingBox\x12\x13\n\x0btime_offset\x18\x02 \x01(\x03"\xb4\x01\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x11\n\tthumbnail\x18\x01 \x01(\t\x12\x46\n\x08segments\x18\x02 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta1.VideoSegment\x12G\n\tlocations\x18\x03 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta1.FaceLocation"\xa3\x03\n\x16VideoAnnotationResults\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12R\n\x11label_annotations\x18\x02 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1beta1.LabelAnnotation\x12P\n\x10\x66\x61\x63\x65_annotations\x18\x03 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1beta1.FaceAnnotation\x12N\n\x10shot_annotations\x18\x04 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta1.VideoSegment\x12]\n\x17safe_search_annotations\x18\x06 \x03(\x0b\x32<.google.cloud.videointelligence.v1beta1.SafeSearchAnnotation\x12!\n\x05\x65rror\x18\x05 \x01(\x0b\x32\x12.google.rpc.Status"s\n\x15\x41nnotateVideoResponse\x12Z\n\x12\x61nnotation_results\x18\x01 \x03(\x0b\x32>.google.cloud.videointelligence.v1beta1.VideoAnnotationResults"\xa7\x01\n\x17VideoAnnotationProgress\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x18\n\x10progress_percent\x18\x02 \x01(\x05\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"u\n\x15\x41nnotateVideoProgress\x12\\\n\x13\x61nnotation_progress\x18\x01 \x03(\x0b\x32?.google.cloud.videointelligence.v1beta1.VideoAnnotationProgress*\x81\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x13\n\x0fLABEL_DETECTION\x10\x01\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x02\x12\x19\n\x15SHOT_CHANGE_DETECTION\x10\x03\x12\x19\n\x15SAFE_SEARCH_DETECTION\x10\x04*n\n\nLabelLevel\x12\x1b\n\x17LABEL_LEVEL_UNSPECIFIED\x10\x00\x12\x0f\n\x0bVIDEO_LEVEL\x10\x01\x12\x11\n\rSEGMENT_LEVEL\x10\x02\x12\x0e\n\nSHOT_LEVEL\x10\x03\x12\x0f\n\x0b\x46RAME_LEVEL\x10\x04*r\n\x12LabelDetectionMode\x12$\n LABEL_DETECTION_MODE_UNSPECIFIED\x10\x00\x12\r\n\tSHOT_MODE\x10\x01\x12\x0e\n\nFRAME_MODE\x10\x02\x12\x17\n\x13SHOT_AND_FRAME_MODE\x10\x03*e\n\nLikelihood\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xae\x01\n\x18VideoIntelligenceService\x12\x91\x01\n\rAnnotateVideo\x12<.google.cloud.videointelligence.v1beta1.AnnotateVideoRequest\x1a\x1d.google.longrunning.Operation"#\x82\xd3\xe4\x93\x02\x1d"\x18/v1beta1/videos:annotate:\x01*B\xa4\x02\n*com.google.cloud.videointelligence.v1beta1B\x1dVideoIntelligenceServiceProtoP\x01ZWgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1beta1;videointelligence\xaa\x02&Google.Cloud.VideoIntelligence.V1Beta1\xca\x02&Google\\Cloud\\VideoIntelligence\\V1beta1\xea\x02)Google::Cloud::VideoIntelligence::V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.videointelligence.v1beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_CHANGE_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFE_SEARCH_DETECTION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2794,
+    serialized_end=2923,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE)
+
+Feature = enum_type_wrapper.EnumTypeWrapper(_FEATURE)
+_LABELLEVEL = _descriptor.EnumDescriptor(
+    name="LabelLevel",
+    full_name="google.cloud.videointelligence.v1beta1.LabelLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VIDEO_LEVEL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEGMENT_LEVEL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_LEVEL", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_LEVEL", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2925,
+    serialized_end=3035,
+)
+_sym_db.RegisterEnumDescriptor(_LABELLEVEL)
+
+LabelLevel = enum_type_wrapper.EnumTypeWrapper(_LABELLEVEL)
+_LABELDETECTIONMODE = _descriptor.EnumDescriptor(
+    name="LabelDetectionMode",
+    full_name="google.cloud.videointelligence.v1beta1.LabelDetectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_MODE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_MODE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_AND_FRAME_MODE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3037,
+    serialized_end=3151,
+)
+_sym_db.RegisterEnumDescriptor(_LABELDETECTIONMODE)
+
+LabelDetectionMode = enum_type_wrapper.EnumTypeWrapper(_LABELDETECTIONMODE)
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.videointelligence.v1beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3153,
+    serialized_end=3254,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+FEATURE_UNSPECIFIED = 0
+LABEL_DETECTION = 1
+FACE_DETECTION = 2
+SHOT_CHANGE_DETECTION = 3
+SAFE_SEARCH_DETECTION = 4
+LABEL_LEVEL_UNSPECIFIED = 0
+VIDEO_LEVEL = 1
+SEGMENT_LEVEL = 2
+SHOT_LEVEL = 3
+FRAME_LEVEL = 4
+LABEL_DETECTION_MODE_UNSPECIFIED = 0
+SHOT_MODE = 1
+FRAME_MODE = 2
+SHOT_AND_FRAME_MODE = 3
+UNKNOWN = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_ANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="AnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest.input_content",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest.features",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_context",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest.video_context",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest.output_uri",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoRequest.location_id",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=239,
+    serialized_end=488,
+)
+
+
+_VIDEOCONTEXT = _descriptor.Descriptor(
+    name="VideoContext",
+    full_name="google.cloud.videointelligence.v1beta1.VideoContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.segments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_mode",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.label_detection_mode",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.stationary_camera",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_model",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.label_detection_model",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="face_detection_model",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.face_detection_model",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_model",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.shot_change_detection_model",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_detection_model",
+            full_name="google.cloud.videointelligence.v1beta1.VideoContext.safe_search_detection_model",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=491,
+    serialized_end=829,
+)
+
+
+_VIDEOSEGMENT = _descriptor.Descriptor(
+    name="VideoSegment",
+    full_name="google.cloud.videointelligence.v1beta1.VideoSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.videointelligence.v1beta1.VideoSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.videointelligence.v1beta1.VideoSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=831,
+    serialized_end=897,
+)
+
+
+_LABELLOCATION = _descriptor.Descriptor(
+    name="LabelLocation",
+    full_name="google.cloud.videointelligence.v1beta1.LabelLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1beta1.LabelLocation.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1beta1.LabelLocation.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="level",
+            full_name="google.cloud.videointelligence.v1beta1.LabelLocation.level",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=900,
+    serialized_end=1073,
+)
+
+
+_LABELANNOTATION = _descriptor.Descriptor(
+    name="LabelAnnotation",
+    full_name="google.cloud.videointelligence.v1beta1.LabelAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.videointelligence.v1beta1.LabelAnnotation.description",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1beta1.LabelAnnotation.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.videointelligence.v1beta1.LabelAnnotation.locations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1076,
+    serialized_end=1211,
+)
+
+
+_SAFESEARCHANNOTATION = _descriptor.Descriptor(
+    name="SafeSearchAnnotation",
+    full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="adult",
+            full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation.adult",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spoof",
+            full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation.spoof",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="medical",
+            full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation.medical",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violent",
+            full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation.violent",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="racy",
+            full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation.racy",
+            index=4,
+            number=5,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1beta1.SafeSearchAnnotation.time_offset",
+            index=5,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1214,
+    serialized_end=1595,
+)
+
+
+_BOUNDINGBOX = _descriptor.Descriptor(
+    name="BoundingBox",
+    full_name="google.cloud.videointelligence.v1beta1.BoundingBox",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="left",
+            full_name="google.cloud.videointelligence.v1beta1.BoundingBox.left",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="right",
+            full_name="google.cloud.videointelligence.v1beta1.BoundingBox.right",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bottom",
+            full_name="google.cloud.videointelligence.v1beta1.BoundingBox.bottom",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top",
+            full_name="google.cloud.videointelligence.v1beta1.BoundingBox.top",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1597,
+    serialized_end=1668,
+)
+
+
+_FACELOCATION = _descriptor.Descriptor(
+    name="FaceLocation",
+    full_name="google.cloud.videointelligence.v1beta1.FaceLocation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.videointelligence.v1beta1.FaceLocation.bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1beta1.FaceLocation.time_offset",
+            index=1,
+            number=2,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1670,
+    serialized_end=1780,
+)
+
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.videointelligence.v1beta1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="thumbnail",
+            full_name="google.cloud.videointelligence.v1beta1.FaceAnnotation.thumbnail",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1beta1.FaceAnnotation.segments",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.videointelligence.v1beta1.FaceAnnotation.locations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1783,
+    serialized_end=1963,
+)
+
+
+_VIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="VideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults.label_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults.face_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults.shot_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_annotations",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults.safe_search_annotations",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationResults.error",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1966,
+    serialized_end=2385,
+)
+
+
+_ANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="AnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoResponse.annotation_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2387,
+    serialized_end=2502,
+)
+
+
+_VIDEOANNOTATIONPROGRESS = _descriptor.Descriptor(
+    name="VideoAnnotationProgress",
+    full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationProgress.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationProgress.progress_percent",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationProgress.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.videointelligence.v1beta1.VideoAnnotationProgress.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2505,
+    serialized_end=2672,
+)
+
+
+_ANNOTATEVIDEOPROGRESS = _descriptor.Descriptor(
+    name="AnnotateVideoProgress",
+    full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_progress",
+            full_name="google.cloud.videointelligence.v1beta1.AnnotateVideoProgress.annotation_progress",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2674,
+    serialized_end=2791,
+)
+
+_ANNOTATEVIDEOREQUEST.fields_by_name["features"].enum_type = _FEATURE
+_ANNOTATEVIDEOREQUEST.fields_by_name["video_context"].message_type = _VIDEOCONTEXT
+_VIDEOCONTEXT.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_VIDEOCONTEXT.fields_by_name["label_detection_mode"].enum_type = _LABELDETECTIONMODE
+_LABELLOCATION.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_LABELLOCATION.fields_by_name["level"].enum_type = _LABELLEVEL
+_LABELANNOTATION.fields_by_name["locations"].message_type = _LABELLOCATION
+_SAFESEARCHANNOTATION.fields_by_name["adult"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["spoof"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["medical"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["violent"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["racy"].enum_type = _LIKELIHOOD
+_FACELOCATION.fields_by_name["bounding_box"].message_type = _BOUNDINGBOX
+_FACEANNOTATION.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_FACEANNOTATION.fields_by_name["locations"].message_type = _FACELOCATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "face_annotations"
+].message_type = _FACEANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name["shot_annotations"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "safe_search_annotations"
+].message_type = _SAFESEARCHANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _VIDEOANNOTATIONRESULTS
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ANNOTATEVIDEOPROGRESS.fields_by_name[
+    "annotation_progress"
+].message_type = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoRequest"] = _ANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["VideoContext"] = _VIDEOCONTEXT
+DESCRIPTOR.message_types_by_name["VideoSegment"] = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["LabelLocation"] = _LABELLOCATION
+DESCRIPTOR.message_types_by_name["LabelAnnotation"] = _LABELANNOTATION
+DESCRIPTOR.message_types_by_name["SafeSearchAnnotation"] = _SAFESEARCHANNOTATION
+DESCRIPTOR.message_types_by_name["BoundingBox"] = _BOUNDINGBOX
+DESCRIPTOR.message_types_by_name["FaceLocation"] = _FACELOCATION
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["VideoAnnotationResults"] = _VIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["AnnotateVideoResponse"] = _ANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name["VideoAnnotationProgress"] = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoProgress"] = _ANNOTATEVIDEOPROGRESS
+DESCRIPTOR.enum_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.enum_types_by_name["LabelLevel"] = _LABELLEVEL
+DESCRIPTOR.enum_types_by_name["LabelDetectionMode"] = _LABELDETECTIONMODE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation request.
+  
+  
+  Attributes:
+      input_uri:
+          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.
+      input_content:
+          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.
+      features:
+          Requested video annotation features.
+      video_context:
+          Additional video context and/or feature-specific parameters.
+      output_uri:
+          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>`__.
+      location_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.AnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoRequest)
+
+VideoContext = _reflection.GeneratedProtocolMessageType(
+    "VideoContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCONTEXT,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      segments:
+          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.
+      label_detection_mode:
+          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``.
+      stationary_camera:
+          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.
+      label_detection_model:
+          Model to use for label detection. Supported values: "latest"
+          and "stable" (the default).
+      face_detection_model:
+          Model to use for face detection. Supported values: "latest"
+          and "stable" (the default).
+      shot_change_detection_model:
+          Model to use for shot change detection. Supported values:
+          "latest" and "stable" (the default).
+      safe_search_detection_model:
+          Model to use for safe search detection. Supported values:
+          "latest" and "stable" (the default).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.VideoContext)
+    ),
+)
+_sym_db.RegisterMessage(VideoContext)
+
+VideoSegment = _reflection.GeneratedProtocolMessageType(
+    "VideoSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOSEGMENT,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment.
+  
+  
+  Attributes:
+      start_time_offset:
+          Start offset in microseconds (inclusive). Unset means 0.
+      end_time_offset:
+          End offset in microseconds (inclusive). Unset means 0.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.VideoSegment)
+    ),
+)
+_sym_db.RegisterMessage(VideoSegment)
+
+LabelLocation = _reflection.GeneratedProtocolMessageType(
+    "LabelLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELLOCATION,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Label location.
+  
+  
+  Attributes:
+      segment:
+          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).
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+      level:
+          Label level.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.LabelLocation)
+    ),
+)
+_sym_db.RegisterMessage(LabelLocation)
+
+LabelAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LabelAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELANNOTATION,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Label annotation.
+  
+  
+  Attributes:
+      description:
+          Textual description, e.g. ``Fixed-gear bicycle``.
+      language_code:
+          Language code for ``description`` in BCP-47 format.
+      locations:
+          Where the label was detected and with what confidence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.LabelAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LabelAnnotation)
+
+SafeSearchAnnotation = _reflection.GeneratedProtocolMessageType(
+    "SafeSearchAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAFESEARCHANNOTATION,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      adult:
+          Likelihood of adult content.
+      spoof:
+          Likelihood that an obvious modification was made to the
+          original version to make it appear funny or offensive.
+      medical:
+          Likelihood of medical content.
+      violent:
+          Likelihood of violent content.
+      racy:
+          Likelihood of racy content.
+      time_offset:
+          Video time offset in microseconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.SafeSearchAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(SafeSearchAnnotation)
+
+BoundingBox = _reflection.GeneratedProtocolMessageType(
+    "BoundingBox",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGBOX,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Bounding box.
+  
+  
+  Attributes:
+      left:
+          Left X coordinate.
+      right:
+          Right X coordinate.
+      bottom:
+          Bottom Y coordinate.
+      top:
+          Top Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.BoundingBox)
+    ),
+)
+_sym_db.RegisterMessage(BoundingBox)
+
+FaceLocation = _reflection.GeneratedProtocolMessageType(
+    "FaceLocation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACELOCATION,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Face location.
+  
+  
+  Attributes:
+      bounding_box:
+          Bounding box in a frame.
+      time_offset:
+          Video time offset in microseconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.FaceLocation)
+    ),
+)
+_sym_db.RegisterMessage(FaceLocation)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Face annotation.
+  
+  
+  Attributes:
+      thumbnail:
+          Thumbnail of a representative face view (in JPEG format).
+          Encoding: base64.
+      segments:
+          All locations where a face was detected. Faces are detected
+          and tracked on a per-video basis (as opposed to across
+          multiple videos).
+      locations:
+          Face locations at one frame per second.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+
+VideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation results for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      label_annotations:
+          Label annotations. There is exactly one element for each
+          unique label.
+      face_annotations:
+          Face annotations. There is exactly one element for each unique
+          face.
+      shot_annotations:
+          Shot annotations. Each shot is represented as a video segment.
+      safe_search_annotations:
+          Safe search annotations.
+      error:
+          If set, indicates an error. Note that for a single
+          ``AnnotateVideoRequest`` some videos may succeed and some may
+          fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.VideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationResults)
+
+AnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation response. Included in the ``response`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_results:
+          Annotation results for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.AnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoResponse)
+
+VideoAnnotationProgress = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONPROGRESS,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation progress for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      progress_percent:
+          Approximate percentage processed thus far. Guaranteed to be
+          100 when fully processed.
+      start_time:
+          Time when the request was received.
+      update_time:
+          Time of the most recent update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.VideoAnnotationProgress)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationProgress)
+
+AnnotateVideoProgress = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOPROGRESS,
+        __module__="google.cloud.videointelligence_v1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation progress. Included in the ``metadata`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_progress:
+          Progress metadata for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta1.AnnotateVideoProgress)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoProgress)
+
+
+DESCRIPTOR._options = None
+
+_VIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="VideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1beta1.VideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=3257,
+    serialized_end=3431,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnnotateVideo",
+            full_name="google.cloud.videointelligence.v1beta1.VideoIntelligenceService.AnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_ANNOTATEVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\035"\030/v1beta1/videos:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_VIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name["VideoIntelligenceService"] = _VIDEOINTELLIGENCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence_pb2_grpc.py b/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence_pb2_grpc.py
new file mode 100644
index 000000000000..a8a8f1125e20
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/proto/video_intelligence_pb2_grpc.py
@@ -0,0 +1,56 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.videointelligence_v1beta1.proto import (
+    video_intelligence_pb2 as google_dot_cloud_dot_videointelligence__v1beta1_dot_proto_dot_video__intelligence__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class VideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnnotateVideo = channel.unary_unary(
+            "/google.cloud.videointelligence.v1beta1.VideoIntelligenceService/AnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class VideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def AnnotateVideo(self, request, context):
+        """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).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_VideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnnotateVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1beta1.VideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/videointelligence/google/cloud/videointelligence_v1beta1/types.py b/videointelligence/google/cloud/videointelligence_v1beta1/types.py
new file mode 100644
index 000000000000..f4b0fd1b0bde
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta1/types.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.videointelligence_v1beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [video_intelligence_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.videointelligence_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta2/__init__.py
new file mode 100644
index 000000000000..c180603ffc35
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1beta2 import types
+from google.cloud.videointelligence_v1beta2.gapic import enums
+from google.cloud.videointelligence_v1beta2.gapic import (
+    video_intelligence_service_client,
+)
+
+
+class VideoIntelligenceServiceClient(
+    video_intelligence_service_client.VideoIntelligenceServiceClient
+):
+    __doc__ = video_intelligence_service_client.VideoIntelligenceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "VideoIntelligenceServiceClient")
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/gapic/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/gapic/enums.py b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/enums.py
new file mode 100644
index 000000000000..57070f93e4bc
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/enums.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Feature(enum.IntEnum):
+    """
+    Video annotation feature.
+
+    Attributes:
+      FEATURE_UNSPECIFIED (int): Unspecified.
+      LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      SHOT_CHANGE_DETECTION (int): Shot change detection.
+      EXPLICIT_CONTENT_DETECTION (int): Explicit content detection.
+      FACE_DETECTION (int): Human face detection and tracking.
+    """
+
+    FEATURE_UNSPECIFIED = 0
+    LABEL_DETECTION = 1
+    SHOT_CHANGE_DETECTION = 2
+    EXPLICIT_CONTENT_DETECTION = 3
+    FACE_DETECTION = 4
+
+
+class LabelDetectionMode(enum.IntEnum):
+    """
+    Label detection mode.
+
+    Attributes:
+      LABEL_DETECTION_MODE_UNSPECIFIED (int): Unspecified.
+      SHOT_MODE (int): Detect shot-level labels.
+      FRAME_MODE (int): Detect frame-level labels.
+      SHOT_AND_FRAME_MODE (int): Detect both shot-level and frame-level labels.
+    """
+
+    LABEL_DETECTION_MODE_UNSPECIFIED = 0
+    SHOT_MODE = 1
+    FRAME_MODE = 2
+    SHOT_AND_FRAME_MODE = 3
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Bucketized representation of likelihood.
+
+    Attributes:
+      LIKELIHOOD_UNSPECIFIED (int): Unspecified likelihood.
+      VERY_UNLIKELY (int): Very unlikely.
+      UNLIKELY (int): Unlikely.
+      POSSIBLE (int): Possible.
+      LIKELY (int): Likely.
+      VERY_LIKELY (int): Very likely.
+    """
+
+    LIKELIHOOD_UNSPECIFIED = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/gapic/transports/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/gapic/transports/video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/transports/video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..0da1802284c3
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/transports/video_intelligence_service_grpc_transport.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.videointelligence_v1beta2.proto import video_intelligence_pb2_grpc
+
+
+class VideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1beta2 VideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "video_intelligence_service_stub": video_intelligence_pb2_grpc.VideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def annotate_video(self):
+        """Return the gRPC stub for :meth:`VideoIntelligenceServiceClient.annotate_video`.
+
+        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).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["video_intelligence_service_stub"].AnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/gapic/video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/video_intelligence_service_client.py
new file mode 100644
index 000000000000..1356475fea0a
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/video_intelligence_service_client.py
@@ -0,0 +1,306 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1beta2 VideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import grpc
+
+from google.cloud.videointelligence_v1beta2.gapic import enums
+from google.cloud.videointelligence_v1beta2.gapic import (
+    video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1beta2.gapic.transports import (
+    video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1beta2.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1beta2.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class VideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.videointelligence.v1beta2.VideoIntelligenceService"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            VideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.VideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.VideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def annotate_video(
+        self,
+        input_uri=None,
+        input_content=None,
+        features=None,
+        video_context=None,
+        output_uri=None,
+        location_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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).
+
+        Example:
+            >>> from google.cloud import videointelligence_v1beta2
+            >>> from google.cloud.videointelligence_v1beta2 import enums
+            >>>
+            >>> client = videointelligence_v1beta2.VideoIntelligenceServiceClient()
+            >>>
+            >>> input_uri = 'gs://cloud-samples-data/video/cat.mp4'
+            >>> features_element = enums.Feature.LABEL_DETECTION
+            >>> features = [features_element]
+            >>>
+            >>> response = client.annotate_video(input_uri=input_uri, features=features)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            input_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/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.
+            input_content (bytes): The video data bytes. If unset, the input video(s) should be specified
+                via ``input_uri``. If set, ``input_uri`` should be unset.
+            features (list[~google.cloud.videointelligence_v1beta2.types.Feature]): Requested video annotation features.
+            video_context (Union[dict, ~google.cloud.videointelligence_v1beta2.types.VideoContext]): Additional video context and/or feature-specific parameters.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.videointelligence_v1beta2.types.VideoContext`
+            output_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/storage/docs/reference-uris>`__.
+            location_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.videointelligence_v1beta2.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_video,
+                default_retry=self._method_configs["AnnotateVideo"].retry,
+                default_timeout=self._method_configs["AnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri,
+            input_content=input_content,
+            features=features,
+            video_context=video_context,
+            output_uri=output_uri,
+            location_id=location_id,
+        )
+        operation = self._inner_api_calls["annotate_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            video_intelligence_pb2.AnnotateVideoResponse,
+            metadata_type=video_intelligence_pb2.AnnotateVideoProgress,
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/gapic/video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..9bae7bc23bed
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/gapic/video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1beta2.VideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnnotateVideo": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/proto/__init__.py b/videointelligence/google/cloud/videointelligence_v1beta2/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence.proto b/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence.proto
new file mode 100644
index 000000000000..a69c25791e17
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence.proto
@@ -0,0 +1,396 @@
+// 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.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.VideoIntelligence.V1Beta2";
+option go_package = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1beta2;videointelligence";
+option java_multiple_files = true;
+option java_outer_classname = "VideoIntelligenceServiceProto";
+option java_package = "com.google.cloud.videointelligence.v1beta2";
+option php_namespace = "Google\\Cloud\\VideoIntelligence\\V1beta2";
+option ruby_package = "Google::Cloud::VideoIntelligence::V1beta2";
+
+// 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: "/v1beta2/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.
+  // If unset, the input video(s) should be specified via `input_uri`.
+  // If set, `input_uri` should be unset.
+  bytes 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;
+
+  // Config for LABEL_DETECTION.
+  LabelDetectionConfig label_detection_config = 2;
+
+  // Config for SHOT_CHANGE_DETECTION.
+  ShotChangeDetectionConfig shot_change_detection_config = 3;
+
+  // Config for EXPLICIT_CONTENT_DETECTION.
+  ExplicitContentDetectionConfig explicit_content_detection_config = 4;
+
+  // Config for FACE_DETECTION.
+  FaceDetectionConfig face_detection_config = 5;
+}
+
+// Config for LABEL_DETECTION.
+message LabelDetectionConfig {
+  // What labels should be detected with LABEL_DETECTION, in addition to
+  // video-level labels or segment-level labels.
+  // 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.
+  bool stationary_camera = 2;
+
+  // Model to use for label detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// Config for SHOT_CHANGE_DETECTION.
+message ShotChangeDetectionConfig {
+  // Model to use for shot change detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 1;
+}
+
+// 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;
+}
+
+// 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 be included in the face annotation output.
+  bool include_bounding_boxes = 2;
+}
+
+// Video segment.
+message VideoSegment {
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the start of the segment (inclusive).
+  google.protobuf.Duration start_time_offset = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the end of the segment (inclusive).
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video segment level annotation results for label detection.
+message LabelSegment {
+  // Video segment where a label was detected.
+  VideoSegment segment = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Video frame level annotation results for label detection.
+message LabelFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Detected entity from video analysis.
+message Entity {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string entity_id = 1;
+
+  // Textual description, e.g. `Fixed-gear bicycle`.
+  string description = 2;
+
+  // Language code for `description` in BCP-47 format.
+  string language_code = 3;
+}
+
+// Label annotation.
+message LabelAnnotation {
+  // Detected entity.
+  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`.
+  repeated Entity category_entities = 2;
+
+  // All video segments where a label was detected.
+  repeated LabelSegment segments = 3;
+
+  // All video frames where a label was detected.
+  repeated LabelFrame frames = 4;
+}
+
+// Video frame level annotation results for explicit content.
+message ExplicitContentFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Likelihood of the pornography content..
+  Likelihood pornography_likelihood = 2;
+}
+
+// Explicit content annotation (based on per-frame visual signals only).
+// If no explicit content has been detected in a frame, no annotations are
+// present for that frame.
+message ExplicitContentAnnotation {
+  // All video frames where explicit content was detected.
+  repeated ExplicitContentFrame frames = 1;
+}
+
+// Normalized bounding box.
+// The normalized vertex coordinates are relative to the original image.
+// Range: [0, 1].
+message NormalizedBoundingBox {
+  // Left X coordinate.
+  float left = 1;
+
+  // Top Y coordinate.
+  float top = 2;
+
+  // Right X coordinate.
+  float right = 3;
+
+  // Bottom Y coordinate.
+  float bottom = 4;
+}
+
+// Video segment level annotation results for face detection.
+message FaceSegment {
+  // Video segment where a face was detected.
+  VideoSegment segment = 1;
+}
+
+// Video frame level annotation results for face detection.
+message FaceFrame {
+  // Normalized Bounding boxes in a frame.
+  // There can be more than one boxes if the same face is detected in multiple
+  // locations within the current frame.
+  repeated NormalizedBoundingBox normalized_bounding_boxes = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the video frame for this location.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Face annotation.
+message FaceAnnotation {
+  // Thumbnail of a representative face view (in JPEG format).
+  bytes thumbnail = 1;
+
+  // All video segments where a face was detected.
+  repeated FaceSegment segments = 2;
+
+  // All video frames where a face was detected.
+  repeated FaceFrame frames = 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.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation segment_label_annotations = 2;
+
+  // Label annotations on shot level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation shot_label_annotations = 3;
+
+  // Label annotations on frame level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation frame_label_annotations = 4;
+
+  // Face annotations. There is exactly one element for each unique face.
+  repeated FaceAnnotation face_annotations = 5;
+
+  // Shot annotations. Each shot is represented as a video segment.
+  repeated VideoSegment shot_annotations = 6;
+
+  // Explicit content annotation.
+  ExplicitContentAnnotation explicit_annotation = 7;
+
+  // If set, indicates an error. Note that for a single `AnnotateVideoRequest`
+  // some videos may succeed and some may fail.
+  google.rpc.Status error = 9;
+}
+
+// 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;
+
+  // Shot change detection.
+  SHOT_CHANGE_DETECTION = 2;
+
+  // Explicit content detection.
+  EXPLICIT_CONTENT_DETECTION = 3;
+
+  // Human face detection and tracking.
+  FACE_DETECTION = 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 {
+  // Unspecified likelihood.
+  LIKELIHOOD_UNSPECIFIED = 0;
+
+  // Very unlikely.
+  VERY_UNLIKELY = 1;
+
+  // Unlikely.
+  UNLIKELY = 2;
+
+  // Possible.
+  POSSIBLE = 3;
+
+  // Likely.
+  LIKELY = 4;
+
+  // Very likely.
+  VERY_LIKELY = 5;
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence_pb2.py b/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence_pb2.py
new file mode 100644
index 000000000000..871a229e0460
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence_pb2.py
@@ -0,0 +1,2321 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/videointelligence_v1beta2/proto/video_intelligence.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/videointelligence_v1beta2/proto/video_intelligence.proto",
+    package="google.cloud.videointelligence.v1beta2",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.videointelligence.v1beta2B\035VideoIntelligenceServiceProtoP\001ZWgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1beta2;videointelligence\252\002&Google.Cloud.VideoIntelligence.V1Beta2\312\002&Google\\Cloud\\VideoIntelligence\\V1beta2\352\002)Google::Cloud::VideoIntelligence::V1beta2"
+    ),
+    serialized_pb=_b(
+        '\nEgoogle/cloud/videointelligence_v1beta2/proto/video_intelligence.proto\x12&google.cloud.videointelligence.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xf9\x01\n\x14\x41nnotateVideoRequest\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x15\n\rinput_content\x18\x06 \x01(\x0c\x12\x41\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0e\x32/.google.cloud.videointelligence.v1beta2.Feature\x12K\n\rvideo_context\x18\x03 \x01(\x0b\x32\x34.google.cloud.videointelligence.v1beta2.VideoContext\x12\x12\n\noutput_uri\x18\x04 \x01(\t\x12\x13\n\x0blocation_id\x18\x05 \x01(\t"\xec\x03\n\x0cVideoContext\x12\x46\n\x08segments\x18\x01 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta2.VideoSegment\x12\\\n\x16label_detection_config\x18\x02 \x01(\x0b\x32<.google.cloud.videointelligence.v1beta2.LabelDetectionConfig\x12g\n\x1cshot_change_detection_config\x18\x03 \x01(\x0b\x32\x41.google.cloud.videointelligence.v1beta2.ShotChangeDetectionConfig\x12q\n!explicit_content_detection_config\x18\x04 \x01(\x0b\x32\x46.google.cloud.videointelligence.v1beta2.ExplicitContentDetectionConfig\x12Z\n\x15\x66\x61\x63\x65_detection_config\x18\x05 \x01(\x0b\x32;.google.cloud.videointelligence.v1beta2.FaceDetectionConfig"\x9a\x01\n\x14LabelDetectionConfig\x12X\n\x14label_detection_mode\x18\x01 \x01(\x0e\x32:.google.cloud.videointelligence.v1beta2.LabelDetectionMode\x12\x19\n\x11stationary_camera\x18\x02 \x01(\x08\x12\r\n\x05model\x18\x03 \x01(\t"*\n\x19ShotChangeDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"/\n\x1e\x45xplicitContentDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"D\n\x13\x46\x61\x63\x65\x44\x65tectionConfig\x12\r\n\x05model\x18\x01 \x01(\t\x12\x1e\n\x16include_bounding_boxes\x18\x02 \x01(\x08"x\n\x0cVideoSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"i\n\x0cLabelSegment\x12\x45\n\x07segment\x18\x01 \x01(\x0b\x32\x34.google.cloud.videointelligence.v1beta2.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02"P\n\nLabelFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nconfidence\x18\x02 \x01(\x02"G\n\x06\x45ntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t"\xa8\x02\n\x0fLabelAnnotation\x12>\n\x06\x65ntity\x18\x01 \x01(\x0b\x32..google.cloud.videointelligence.v1beta2.Entity\x12I\n\x11\x63\x61tegory_entities\x18\x02 \x03(\x0b\x32..google.cloud.videointelligence.v1beta2.Entity\x12\x46\n\x08segments\x18\x03 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta2.LabelSegment\x12\x42\n\x06\x66rames\x18\x04 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1beta2.LabelFrame"\x9a\x01\n\x14\x45xplicitContentFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12R\n\x16pornography_likelihood\x18\x02 \x01(\x0e\x32\x32.google.cloud.videointelligence.v1beta2.Likelihood"i\n\x19\x45xplicitContentAnnotation\x12L\n\x06\x66rames\x18\x01 \x03(\x0b\x32<.google.cloud.videointelligence.v1beta2.ExplicitContentFrame"Q\n\x15NormalizedBoundingBox\x12\x0c\n\x04left\x18\x01 \x01(\x02\x12\x0b\n\x03top\x18\x02 \x01(\x02\x12\r\n\x05right\x18\x03 \x01(\x02\x12\x0e\n\x06\x62ottom\x18\x04 \x01(\x02"T\n\x0b\x46\x61\x63\x65Segment\x12\x45\n\x07segment\x18\x01 \x01(\x0b\x32\x34.google.cloud.videointelligence.v1beta2.VideoSegment"\x9d\x01\n\tFaceFrame\x12`\n\x19normalized_bounding_boxes\x18\x01 \x03(\x0b\x32=.google.cloud.videointelligence.v1beta2.NormalizedBoundingBox\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xad\x01\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x11\n\tthumbnail\x18\x01 \x01(\x0c\x12\x45\n\x08segments\x18\x02 \x03(\x0b\x32\x33.google.cloud.videointelligence.v1beta2.FaceSegment\x12\x41\n\x06\x66rames\x18\x03 \x03(\x0b\x32\x31.google.cloud.videointelligence.v1beta2.FaceFrame"\xdf\x04\n\x16VideoAnnotationResults\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12Z\n\x19segment_label_annotations\x18\x02 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1beta2.LabelAnnotation\x12W\n\x16shot_label_annotations\x18\x03 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1beta2.LabelAnnotation\x12X\n\x17\x66rame_label_annotations\x18\x04 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1beta2.LabelAnnotation\x12P\n\x10\x66\x61\x63\x65_annotations\x18\x05 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1beta2.FaceAnnotation\x12N\n\x10shot_annotations\x18\x06 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1beta2.VideoSegment\x12^\n\x13\x65xplicit_annotation\x18\x07 \x01(\x0b\x32\x41.google.cloud.videointelligence.v1beta2.ExplicitContentAnnotation\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status"s\n\x15\x41nnotateVideoResponse\x12Z\n\x12\x61nnotation_results\x18\x01 \x03(\x0b\x32>.google.cloud.videointelligence.v1beta2.VideoAnnotationResults"\xa7\x01\n\x17VideoAnnotationProgress\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x18\n\x10progress_percent\x18\x02 \x01(\x05\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"u\n\x15\x41nnotateVideoProgress\x12\\\n\x13\x61nnotation_progress\x18\x01 \x03(\x0b\x32?.google.cloud.videointelligence.v1beta2.VideoAnnotationProgress*\x86\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x13\n\x0fLABEL_DETECTION\x10\x01\x12\x19\n\x15SHOT_CHANGE_DETECTION\x10\x02\x12\x1e\n\x1a\x45XPLICIT_CONTENT_DETECTION\x10\x03\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x04*r\n\x12LabelDetectionMode\x12$\n LABEL_DETECTION_MODE_UNSPECIFIED\x10\x00\x12\r\n\tSHOT_MODE\x10\x01\x12\x0e\n\nFRAME_MODE\x10\x02\x12\x17\n\x13SHOT_AND_FRAME_MODE\x10\x03*t\n\nLikelihood\x12\x1a\n\x16LIKELIHOOD_UNSPECIFIED\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xae\x01\n\x18VideoIntelligenceService\x12\x91\x01\n\rAnnotateVideo\x12<.google.cloud.videointelligence.v1beta2.AnnotateVideoRequest\x1a\x1d.google.longrunning.Operation"#\x82\xd3\xe4\x93\x02\x1d"\x18/v1beta2/videos:annotate:\x01*B\xa4\x02\n*com.google.cloud.videointelligence.v1beta2B\x1dVideoIntelligenceServiceProtoP\x01ZWgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1beta2;videointelligence\xaa\x02&Google.Cloud.VideoIntelligence.V1Beta2\xca\x02&Google\\Cloud\\VideoIntelligence\\V1beta2\xea\x02)Google::Cloud::VideoIntelligence::V1beta2b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.videointelligence.v1beta2.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_CHANGE_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPLICIT_CONTENT_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3806,
+    serialized_end=3940,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE)
+
+Feature = enum_type_wrapper.EnumTypeWrapper(_FEATURE)
+_LABELDETECTIONMODE = _descriptor.EnumDescriptor(
+    name="LabelDetectionMode",
+    full_name="google.cloud.videointelligence.v1beta2.LabelDetectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_MODE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_MODE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_AND_FRAME_MODE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3942,
+    serialized_end=4056,
+)
+_sym_db.RegisterEnumDescriptor(_LABELDETECTIONMODE)
+
+LabelDetectionMode = enum_type_wrapper.EnumTypeWrapper(_LABELDETECTIONMODE)
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.videointelligence.v1beta2.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LIKELIHOOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4058,
+    serialized_end=4174,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+FEATURE_UNSPECIFIED = 0
+LABEL_DETECTION = 1
+SHOT_CHANGE_DETECTION = 2
+EXPLICIT_CONTENT_DETECTION = 3
+FACE_DETECTION = 4
+LABEL_DETECTION_MODE_UNSPECIFIED = 0
+SHOT_MODE = 1
+FRAME_MODE = 2
+SHOT_AND_FRAME_MODE = 3
+LIKELIHOOD_UNSPECIFIED = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_ANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="AnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.input_content",
+            index=1,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.features",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_context",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.video_context",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.output_uri",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoRequest.location_id",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=271,
+    serialized_end=520,
+)
+
+
+_VIDEOCONTEXT = _descriptor.Descriptor(
+    name="VideoContext",
+    full_name="google.cloud.videointelligence.v1beta2.VideoContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1beta2.VideoContext.segments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_config",
+            full_name="google.cloud.videointelligence.v1beta2.VideoContext.label_detection_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_config",
+            full_name="google.cloud.videointelligence.v1beta2.VideoContext.shot_change_detection_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_content_detection_config",
+            full_name="google.cloud.videointelligence.v1beta2.VideoContext.explicit_content_detection_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="face_detection_config",
+            full_name="google.cloud.videointelligence.v1beta2.VideoContext.face_detection_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=523,
+    serialized_end=1015,
+)
+
+
+_LABELDETECTIONCONFIG = _descriptor.Descriptor(
+    name="LabelDetectionConfig",
+    full_name="google.cloud.videointelligence.v1beta2.LabelDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label_detection_mode",
+            full_name="google.cloud.videointelligence.v1beta2.LabelDetectionConfig.label_detection_mode",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1beta2.LabelDetectionConfig.stationary_camera",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1beta2.LabelDetectionConfig.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1018,
+    serialized_end=1172,
+)
+
+
+_SHOTCHANGEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ShotChangeDetectionConfig",
+    full_name="google.cloud.videointelligence.v1beta2.ShotChangeDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1beta2.ShotChangeDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1174,
+    serialized_end=1216,
+)
+
+
+_EXPLICITCONTENTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ExplicitContentDetectionConfig",
+    full_name="google.cloud.videointelligence.v1beta2.ExplicitContentDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1beta2.ExplicitContentDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1218,
+    serialized_end=1265,
+)
+
+
+_FACEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="FaceDetectionConfig",
+    full_name="google.cloud.videointelligence.v1beta2.FaceDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1beta2.FaceDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="include_bounding_boxes",
+            full_name="google.cloud.videointelligence.v1beta2.FaceDetectionConfig.include_bounding_boxes",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1267,
+    serialized_end=1335,
+)
+
+
+_VIDEOSEGMENT = _descriptor.Descriptor(
+    name="VideoSegment",
+    full_name="google.cloud.videointelligence.v1beta2.VideoSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.videointelligence.v1beta2.VideoSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.videointelligence.v1beta2.VideoSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1337,
+    serialized_end=1457,
+)
+
+
+_LABELSEGMENT = _descriptor.Descriptor(
+    name="LabelSegment",
+    full_name="google.cloud.videointelligence.v1beta2.LabelSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1beta2.LabelSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1beta2.LabelSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1459,
+    serialized_end=1564,
+)
+
+
+_LABELFRAME = _descriptor.Descriptor(
+    name="LabelFrame",
+    full_name="google.cloud.videointelligence.v1beta2.LabelFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1beta2.LabelFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1beta2.LabelFrame.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1566,
+    serialized_end=1646,
+)
+
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.videointelligence.v1beta2.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.videointelligence.v1beta2.Entity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.videointelligence.v1beta2.Entity.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1beta2.Entity.language_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1648,
+    serialized_end=1719,
+)
+
+
+_LABELANNOTATION = _descriptor.Descriptor(
+    name="LabelAnnotation",
+    full_name="google.cloud.videointelligence.v1beta2.LabelAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1beta2.LabelAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category_entities",
+            full_name="google.cloud.videointelligence.v1beta2.LabelAnnotation.category_entities",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1beta2.LabelAnnotation.segments",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1beta2.LabelAnnotation.frames",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1722,
+    serialized_end=2018,
+)
+
+
+_EXPLICITCONTENTFRAME = _descriptor.Descriptor(
+    name="ExplicitContentFrame",
+    full_name="google.cloud.videointelligence.v1beta2.ExplicitContentFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1beta2.ExplicitContentFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pornography_likelihood",
+            full_name="google.cloud.videointelligence.v1beta2.ExplicitContentFrame.pornography_likelihood",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2021,
+    serialized_end=2175,
+)
+
+
+_EXPLICITCONTENTANNOTATION = _descriptor.Descriptor(
+    name="ExplicitContentAnnotation",
+    full_name="google.cloud.videointelligence.v1beta2.ExplicitContentAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1beta2.ExplicitContentAnnotation.frames",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2177,
+    serialized_end=2282,
+)
+
+
+_NORMALIZEDBOUNDINGBOX = _descriptor.Descriptor(
+    name="NormalizedBoundingBox",
+    full_name="google.cloud.videointelligence.v1beta2.NormalizedBoundingBox",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="left",
+            full_name="google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.left",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top",
+            full_name="google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.top",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="right",
+            full_name="google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.right",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bottom",
+            full_name="google.cloud.videointelligence.v1beta2.NormalizedBoundingBox.bottom",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2284,
+    serialized_end=2365,
+)
+
+
+_FACESEGMENT = _descriptor.Descriptor(
+    name="FaceSegment",
+    full_name="google.cloud.videointelligence.v1beta2.FaceSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1beta2.FaceSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2367,
+    serialized_end=2451,
+)
+
+
+_FACEFRAME = _descriptor.Descriptor(
+    name="FaceFrame",
+    full_name="google.cloud.videointelligence.v1beta2.FaceFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_boxes",
+            full_name="google.cloud.videointelligence.v1beta2.FaceFrame.normalized_bounding_boxes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1beta2.FaceFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2454,
+    serialized_end=2611,
+)
+
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.videointelligence.v1beta2.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="thumbnail",
+            full_name="google.cloud.videointelligence.v1beta2.FaceAnnotation.thumbnail",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1beta2.FaceAnnotation.segments",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1beta2.FaceAnnotation.frames",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2614,
+    serialized_end=2787,
+)
+
+
+_VIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="VideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment_label_annotations",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.segment_label_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_label_annotations",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.shot_label_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_label_annotations",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.frame_label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.face_annotations",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.shot_annotations",
+            index=5,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_annotation",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.explicit_annotation",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationResults.error",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2790,
+    serialized_end=3397,
+)
+
+
+_ANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="AnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoResponse.annotation_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3399,
+    serialized_end=3514,
+)
+
+
+_VIDEOANNOTATIONPROGRESS = _descriptor.Descriptor(
+    name="VideoAnnotationProgress",
+    full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.progress_percent",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.videointelligence.v1beta2.VideoAnnotationProgress.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3517,
+    serialized_end=3684,
+)
+
+
+_ANNOTATEVIDEOPROGRESS = _descriptor.Descriptor(
+    name="AnnotateVideoProgress",
+    full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_progress",
+            full_name="google.cloud.videointelligence.v1beta2.AnnotateVideoProgress.annotation_progress",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3686,
+    serialized_end=3803,
+)
+
+_ANNOTATEVIDEOREQUEST.fields_by_name["features"].enum_type = _FEATURE
+_ANNOTATEVIDEOREQUEST.fields_by_name["video_context"].message_type = _VIDEOCONTEXT
+_VIDEOCONTEXT.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_VIDEOCONTEXT.fields_by_name[
+    "label_detection_config"
+].message_type = _LABELDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "shot_change_detection_config"
+].message_type = _SHOTCHANGEDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "explicit_content_detection_config"
+].message_type = _EXPLICITCONTENTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "face_detection_config"
+].message_type = _FACEDETECTIONCONFIG
+_LABELDETECTIONCONFIG.fields_by_name[
+    "label_detection_mode"
+].enum_type = _LABELDETECTIONMODE
+_VIDEOSEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOSEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_LABELFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["category_entities"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["segments"].message_type = _LABELSEGMENT
+_LABELANNOTATION.fields_by_name["frames"].message_type = _LABELFRAME
+_EXPLICITCONTENTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_EXPLICITCONTENTFRAME.fields_by_name["pornography_likelihood"].enum_type = _LIKELIHOOD
+_EXPLICITCONTENTANNOTATION.fields_by_name["frames"].message_type = _EXPLICITCONTENTFRAME
+_FACESEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_FACEFRAME.fields_by_name[
+    "normalized_bounding_boxes"
+].message_type = _NORMALIZEDBOUNDINGBOX
+_FACEFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_FACEANNOTATION.fields_by_name["segments"].message_type = _FACESEGMENT
+_FACEANNOTATION.fields_by_name["frames"].message_type = _FACEFRAME
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "segment_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "frame_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "face_annotations"
+].message_type = _FACEANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name["shot_annotations"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "explicit_annotation"
+].message_type = _EXPLICITCONTENTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _VIDEOANNOTATIONRESULTS
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ANNOTATEVIDEOPROGRESS.fields_by_name[
+    "annotation_progress"
+].message_type = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoRequest"] = _ANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["VideoContext"] = _VIDEOCONTEXT
+DESCRIPTOR.message_types_by_name["LabelDetectionConfig"] = _LABELDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ShotChangeDetectionConfig"
+] = _SHOTCHANGEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentDetectionConfig"
+] = _EXPLICITCONTENTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["FaceDetectionConfig"] = _FACEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["VideoSegment"] = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["LabelSegment"] = _LABELSEGMENT
+DESCRIPTOR.message_types_by_name["LabelFrame"] = _LABELFRAME
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["LabelAnnotation"] = _LABELANNOTATION
+DESCRIPTOR.message_types_by_name["ExplicitContentFrame"] = _EXPLICITCONTENTFRAME
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentAnnotation"
+] = _EXPLICITCONTENTANNOTATION
+DESCRIPTOR.message_types_by_name["NormalizedBoundingBox"] = _NORMALIZEDBOUNDINGBOX
+DESCRIPTOR.message_types_by_name["FaceSegment"] = _FACESEGMENT
+DESCRIPTOR.message_types_by_name["FaceFrame"] = _FACEFRAME
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["VideoAnnotationResults"] = _VIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["AnnotateVideoResponse"] = _ANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name["VideoAnnotationProgress"] = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoProgress"] = _ANNOTATEVIDEOPROGRESS
+DESCRIPTOR.enum_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.enum_types_by_name["LabelDetectionMode"] = _LABELDETECTIONMODE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video annotation request.
+  
+  
+  Attributes:
+      input_uri:
+          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.
+      input_content:
+          The video data bytes. If unset, the input video(s) should be
+          specified via ``input_uri``. If set, ``input_uri`` should be
+          unset.
+      features:
+          Requested video annotation features.
+      video_context:
+          Additional video context and/or feature-specific parameters.
+      output_uri:
+          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>`__.
+      location_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.AnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoRequest)
+
+VideoContext = _reflection.GeneratedProtocolMessageType(
+    "VideoContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCONTEXT,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      segments:
+          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.
+      label_detection_config:
+          Config for LABEL\_DETECTION.
+      shot_change_detection_config:
+          Config for SHOT\_CHANGE\_DETECTION.
+      explicit_content_detection_config:
+          Config for EXPLICIT\_CONTENT\_DETECTION.
+      face_detection_config:
+          Config for FACE\_DETECTION.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.VideoContext)
+    ),
+)
+_sym_db.RegisterMessage(VideoContext)
+
+LabelDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "LabelDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Config for LABEL\_DETECTION.
+  
+  
+  Attributes:
+      label_detection_mode:
+          What labels should be detected with LABEL\_DETECTION, in
+          addition to video-level labels or segment-level labels. If
+          unspecified, defaults to ``SHOT_MODE``.
+      stationary_camera:
+          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.
+      model:
+          Model to use for label detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.LabelDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(LabelDetectionConfig)
+
+ShotChangeDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ShotChangeDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SHOTCHANGEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Config for SHOT\_CHANGE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for shot change detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.ShotChangeDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ShotChangeDetectionConfig)
+
+ExplicitContentDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Config for EXPLICIT\_CONTENT\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for explicit content detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.ExplicitContentDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentDetectionConfig)
+
+FaceDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "FaceDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Config for FACE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for face detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+      include_bounding_boxes:
+          Whether bounding boxes be included in the face annotation
+          output.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.FaceDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(FaceDetectionConfig)
+
+VideoSegment = _reflection.GeneratedProtocolMessageType(
+    "VideoSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOSEGMENT,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video segment.
+  
+  
+  Attributes:
+      start_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the start of the segment (inclusive).
+      end_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the end of the segment (inclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.VideoSegment)
+    ),
+)
+_sym_db.RegisterMessage(VideoSegment)
+
+LabelSegment = _reflection.GeneratedProtocolMessageType(
+    "LabelSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELSEGMENT,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for label detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a label was detected.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.LabelSegment)
+    ),
+)
+_sym_db.RegisterMessage(LabelSegment)
+
+LabelFrame = _reflection.GeneratedProtocolMessageType(
+    "LabelFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELFRAME,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for label detection.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.LabelFrame)
+    ),
+)
+_sym_db.RegisterMessage(LabelFrame)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Detected entity from video analysis.
+  
+  
+  Attributes:
+      entity_id:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      description:
+          Textual description, e.g. ``Fixed-gear bicycle``.
+      language_code:
+          Language code for ``description`` in BCP-47 format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+
+LabelAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LabelAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELANNOTATION,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Label annotation.
+  
+  
+  Attributes:
+      entity:
+          Detected entity.
+      category_entities:
+          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``.
+      segments:
+          All video segments where a label was detected.
+      frames:
+          All video frames where a label was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.LabelAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LabelAnnotation)
+
+ExplicitContentFrame = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTFRAME,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for explicit content.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      pornography_likelihood:
+          Likelihood of the pornography content..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.ExplicitContentFrame)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentFrame)
+
+ExplicitContentAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTANNOTATION,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Explicit content annotation (based on per-frame visual signals only). If
+  no explicit content has been detected in a frame, no annotations are
+  present for that frame.
+  
+  
+  Attributes:
+      frames:
+          All video frames where explicit content was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.ExplicitContentAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentAnnotation)
+
+NormalizedBoundingBox = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingBox",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGBOX,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding box. The normalized vertex coordinates are relative
+  to the original image. Range: [0, 1].
+  
+  
+  Attributes:
+      left:
+          Left X coordinate.
+      top:
+          Top Y coordinate.
+      right:
+          Right X coordinate.
+      bottom:
+          Bottom Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.NormalizedBoundingBox)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingBox)
+
+FaceSegment = _reflection.GeneratedProtocolMessageType(
+    "FaceSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACESEGMENT,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for face detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a face was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.FaceSegment)
+    ),
+)
+_sym_db.RegisterMessage(FaceSegment)
+
+FaceFrame = _reflection.GeneratedProtocolMessageType(
+    "FaceFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEFRAME,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for face detection.
+  
+  
+  Attributes:
+      normalized_bounding_boxes:
+          Normalized Bounding boxes in a frame. There can be more than
+          one boxes if the same face is detected in multiple locations
+          within the current frame.
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.FaceFrame)
+    ),
+)
+_sym_db.RegisterMessage(FaceFrame)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Face annotation.
+  
+  
+  Attributes:
+      thumbnail:
+          Thumbnail of a representative face view (in JPEG format).
+      segments:
+          All video segments where a face was detected.
+      frames:
+          All video frames where a face was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+
+VideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Annotation results for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      segment_label_annotations:
+          Label annotations on video level or user specified segment
+          level. There is exactly one element for each unique label.
+      shot_label_annotations:
+          Label annotations on shot level. There is exactly one element
+          for each unique label.
+      frame_label_annotations:
+          Label annotations on frame level. There is exactly one element
+          for each unique label.
+      face_annotations:
+          Face annotations. There is exactly one element for each unique
+          face.
+      shot_annotations:
+          Shot annotations. Each shot is represented as a video segment.
+      explicit_annotation:
+          Explicit content annotation.
+      error:
+          If set, indicates an error. Note that for a single
+          ``AnnotateVideoRequest`` some videos may succeed and some may
+          fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.VideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationResults)
+
+AnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video annotation response. Included in the ``response`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_results:
+          Annotation results for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.AnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoResponse)
+
+VideoAnnotationProgress = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONPROGRESS,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Annotation progress for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      progress_percent:
+          Approximate percentage processed thus far. Guaranteed to be
+          100 when fully processed.
+      start_time:
+          Time when the request was received.
+      update_time:
+          Time of the most recent update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.VideoAnnotationProgress)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationProgress)
+
+AnnotateVideoProgress = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOPROGRESS,
+        __module__="google.cloud.videointelligence_v1beta2.proto.video_intelligence_pb2",
+        __doc__="""Video annotation progress. Included in the ``metadata`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_progress:
+          Progress metadata for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1beta2.AnnotateVideoProgress)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoProgress)
+
+
+DESCRIPTOR._options = None
+
+_VIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="VideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1beta2.VideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4177,
+    serialized_end=4351,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnnotateVideo",
+            full_name="google.cloud.videointelligence.v1beta2.VideoIntelligenceService.AnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_ANNOTATEVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\035"\030/v1beta2/videos:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_VIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name["VideoIntelligenceService"] = _VIDEOINTELLIGENCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence_pb2_grpc.py b/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence_pb2_grpc.py
new file mode 100644
index 000000000000..f9df0b90a1da
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/proto/video_intelligence_pb2_grpc.py
@@ -0,0 +1,56 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.videointelligence_v1beta2.proto import (
+    video_intelligence_pb2 as google_dot_cloud_dot_videointelligence__v1beta2_dot_proto_dot_video__intelligence__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class VideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnnotateVideo = channel.unary_unary(
+            "/google.cloud.videointelligence.v1beta2.VideoIntelligenceService/AnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1beta2_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class VideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def AnnotateVideo(self, request, context):
+        """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).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_VideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnnotateVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1beta2_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1beta2.VideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/videointelligence/google/cloud/videointelligence_v1beta2/types.py b/videointelligence/google/cloud/videointelligence_v1beta2/types.py
new file mode 100644
index 000000000000..88b29b895b3c
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1beta2/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.videointelligence_v1beta2.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [video_intelligence_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.videointelligence_v1beta2.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/__init__.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/__init__.py
new file mode 100644
index 000000000000..f34c79eba8f2
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1p1beta1 import types
+from google.cloud.videointelligence_v1p1beta1.gapic import enums
+from google.cloud.videointelligence_v1p1beta1.gapic import (
+    video_intelligence_service_client,
+)
+
+
+class VideoIntelligenceServiceClient(
+    video_intelligence_service_client.VideoIntelligenceServiceClient
+):
+    __doc__ = video_intelligence_service_client.VideoIntelligenceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "VideoIntelligenceServiceClient")
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/__init__.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/enums.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/enums.py
new file mode 100644
index 000000000000..534d822ba120
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/enums.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Feature(enum.IntEnum):
+    """
+    Video annotation feature.
+
+    Attributes:
+      FEATURE_UNSPECIFIED (int): Unspecified.
+      LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      SHOT_CHANGE_DETECTION (int): Shot change detection.
+      EXPLICIT_CONTENT_DETECTION (int): Explicit content detection.
+      SPEECH_TRANSCRIPTION (int): Speech transcription.
+    """
+
+    FEATURE_UNSPECIFIED = 0
+    LABEL_DETECTION = 1
+    SHOT_CHANGE_DETECTION = 2
+    EXPLICIT_CONTENT_DETECTION = 3
+    SPEECH_TRANSCRIPTION = 6
+
+
+class LabelDetectionMode(enum.IntEnum):
+    """
+    Label detection mode.
+
+    Attributes:
+      LABEL_DETECTION_MODE_UNSPECIFIED (int): Unspecified.
+      SHOT_MODE (int): Detect shot-level labels.
+      FRAME_MODE (int): Detect frame-level labels.
+      SHOT_AND_FRAME_MODE (int): Detect both shot-level and frame-level labels.
+    """
+
+    LABEL_DETECTION_MODE_UNSPECIFIED = 0
+    SHOT_MODE = 1
+    FRAME_MODE = 2
+    SHOT_AND_FRAME_MODE = 3
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Bucketized representation of likelihood.
+
+    Attributes:
+      LIKELIHOOD_UNSPECIFIED (int): Unspecified likelihood.
+      VERY_UNLIKELY (int): Very unlikely.
+      UNLIKELY (int): Unlikely.
+      POSSIBLE (int): Possible.
+      LIKELY (int): Likely.
+      VERY_LIKELY (int): Very likely.
+    """
+
+    LIKELIHOOD_UNSPECIFIED = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/transports/__init__.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/transports/video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/transports/video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..00d033d62667
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/transports/video_intelligence_service_grpc_transport.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.videointelligence_v1p1beta1.proto import video_intelligence_pb2_grpc
+
+
+class VideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1p1beta1 VideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "video_intelligence_service_stub": video_intelligence_pb2_grpc.VideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def annotate_video(self):
+        """Return the gRPC stub for :meth:`VideoIntelligenceServiceClient.annotate_video`.
+
+        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).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["video_intelligence_service_stub"].AnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/video_intelligence_service_client.py
new file mode 100644
index 000000000000..0e6276d6df1f
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/video_intelligence_service_client.py
@@ -0,0 +1,308 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1p1beta1 VideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import grpc
+
+from google.cloud.videointelligence_v1p1beta1.gapic import enums
+from google.cloud.videointelligence_v1p1beta1.gapic import (
+    video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1p1beta1.gapic.transports import (
+    video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1p1beta1.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1p1beta1.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class VideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = (
+        "google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService"
+    )
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            VideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.VideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.VideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def annotate_video(
+        self,
+        input_uri=None,
+        input_content=None,
+        features=None,
+        video_context=None,
+        output_uri=None,
+        location_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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).
+
+        Example:
+            >>> from google.cloud import videointelligence_v1p1beta1
+            >>> from google.cloud.videointelligence_v1p1beta1 import enums
+            >>>
+            >>> client = videointelligence_v1p1beta1.VideoIntelligenceServiceClient()
+            >>>
+            >>> input_uri = 'gs://cloud-samples-data/video/cat.mp4'
+            >>> features_element = enums.Feature.LABEL_DETECTION
+            >>> features = [features_element]
+            >>>
+            >>> response = client.annotate_video(input_uri=input_uri, features=features)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            input_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/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.
+            input_content (bytes): The video data bytes. If unset, the input video(s) should be specified
+                via ``input_uri``. If set, ``input_uri`` should be unset.
+            features (list[~google.cloud.videointelligence_v1p1beta1.types.Feature]): Requested video annotation features.
+            video_context (Union[dict, ~google.cloud.videointelligence_v1p1beta1.types.VideoContext]): Additional video context and/or feature-specific parameters.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.videointelligence_v1p1beta1.types.VideoContext`
+            output_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/storage/docs/reference-uris>`__.
+            location_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.videointelligence_v1p1beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_video,
+                default_retry=self._method_configs["AnnotateVideo"].retry,
+                default_timeout=self._method_configs["AnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri,
+            input_content=input_content,
+            features=features,
+            video_context=video_context,
+            output_uri=output_uri,
+            location_id=location_id,
+        )
+        operation = self._inner_api_calls["annotate_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            video_intelligence_pb2.AnnotateVideoResponse,
+            metadata_type=video_intelligence_pb2.AnnotateVideoProgress,
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..ba29086dc464
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/gapic/video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnnotateVideo": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/__init__.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence.proto b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence.proto
new file mode 100644
index 000000000000..115f362beb69
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence.proto
@@ -0,0 +1,434 @@
+// 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.cloud.videointelligence.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.VideoIntelligence.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1p1beta1;videointelligence";
+option java_multiple_files = true;
+option java_outer_classname = "VideoIntelligenceServiceProto";
+option java_package = "com.google.cloud.videointelligence.v1p1beta1";
+option php_namespace = "Google\\Cloud\\VideoIntelligence\\V1p1beta1";
+option ruby_package = "Google::Cloud::VideoIntelligence::V1p1beta1";
+
+// 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: "/v1p1beta1/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.
+  // If unset, the input video(s) should be specified via `input_uri`.
+  // If set, `input_uri` should be unset.
+  bytes 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;
+
+  // Config for LABEL_DETECTION.
+  LabelDetectionConfig label_detection_config = 2;
+
+  // Config for SHOT_CHANGE_DETECTION.
+  ShotChangeDetectionConfig shot_change_detection_config = 3;
+
+  // Config for EXPLICIT_CONTENT_DETECTION.
+  ExplicitContentDetectionConfig explicit_content_detection_config = 4;
+
+  // Config for SPEECH_TRANSCRIPTION.
+  SpeechTranscriptionConfig speech_transcription_config = 6;
+}
+
+// Config for LABEL_DETECTION.
+message LabelDetectionConfig {
+  // What labels should be detected with LABEL_DETECTION, in addition to
+  // video-level labels or segment-level labels.
+  // 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.
+  bool stationary_camera = 2;
+
+  // Model to use for label detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// Config for SHOT_CHANGE_DETECTION.
+message ShotChangeDetectionConfig {
+  // Model to use for shot change detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 1;
+}
+
+// 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;
+}
+
+// Video segment.
+message VideoSegment {
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the start of the segment (inclusive).
+  google.protobuf.Duration start_time_offset = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the end of the segment (inclusive).
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video segment level annotation results for label detection.
+message LabelSegment {
+  // Video segment where a label was detected.
+  VideoSegment segment = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Video frame level annotation results for label detection.
+message LabelFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Detected entity from video analysis.
+message Entity {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string entity_id = 1;
+
+  // Textual description, e.g. `Fixed-gear bicycle`.
+  string description = 2;
+
+  // Language code for `description` in BCP-47 format.
+  string language_code = 3;
+}
+
+// Label annotation.
+message LabelAnnotation {
+  // Detected entity.
+  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`.
+  repeated Entity category_entities = 2;
+
+  // All video segments where a label was detected.
+  repeated LabelSegment segments = 3;
+
+  // All video frames where a label was detected.
+  repeated LabelFrame frames = 4;
+}
+
+// Video frame level annotation results for explicit content.
+message ExplicitContentFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Likelihood of the pornography content..
+  Likelihood pornography_likelihood = 2;
+}
+
+// Explicit content annotation (based on per-frame visual signals only).
+// If no explicit content has been detected in a frame, no annotations are
+// present for that frame.
+message ExplicitContentAnnotation {
+  // All video frames where explicit content was detected.
+  repeated ExplicitContentFrame frames = 1;
+}
+
+// Annotation results for a single video.
+message VideoAnnotationResults {
+  // Output only. 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.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation segment_label_annotations = 2;
+
+  // Label annotations on shot level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation shot_label_annotations = 3;
+
+  // Label annotations on frame level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation frame_label_annotations = 4;
+
+  // Shot annotations. Each shot is represented as a video segment.
+  repeated VideoSegment shot_annotations = 6;
+
+  // Explicit content annotation.
+  ExplicitContentAnnotation explicit_annotation = 7;
+
+  // Speech transcription.
+  repeated SpeechTranscription speech_transcriptions = 11;
+
+  // Output only. If set, indicates an error. Note that for a single
+  // `AnnotateVideoRequest` some videos may succeed and some may fail.
+  google.rpc.Status error = 9;
+}
+
+// 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 {
+  // Output only. Video file location in
+  // [Google Cloud Storage](https://cloud.google.com/storage/).
+  string input_uri = 1;
+
+  // Output only. Approximate percentage processed thus far. Guaranteed to be
+  // 100 when fully processed.
+  int32 progress_percent = 2;
+
+  // Output only. Time when the request was received.
+  google.protobuf.Timestamp start_time = 3;
+
+  // Output only. 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;
+}
+
+// Config for SPEECH_TRANSCRIPTION.
+message SpeechTranscriptionConfig {
+  // *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;
+
+  // *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
+  // `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;
+
+  // *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;
+
+  // *Optional* A means to provide context to assist the speech recognition.
+  repeated SpeechContext speech_contexts = 4;
+
+  // *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;
+
+  // *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;
+}
+
+// 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
+  // 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;
+}
+
+// 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.
+  repeated SpeechRecognitionAlternative alternatives = 1;
+}
+
+// Alternative hypotheses (a.k.a. n-best list).
+message SpeechRecognitionAlternative {
+  // Output only. 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
+  // 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.
+  // 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.
+  repeated WordInfo words = 3;
+}
+
+// Word-specific information for recognized words. Word information is only
+// included in the response when certain request parameters are set, such
+// as `enable_word_time_offsets`.
+message WordInfo {
+  // Output only. 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. This is an
+  // experimental feature and the accuracy of the time offset can vary.
+  google.protobuf.Duration start_time = 1;
+
+  // Output only. 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. This is an
+  // experimental feature and the accuracy of the time offset can vary.
+  google.protobuf.Duration end_time = 2;
+
+  // Output only. The word corresponding to this set of information.
+  string word = 3;
+}
+
+// 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;
+
+  // Speech transcription.
+  SPEECH_TRANSCRIPTION = 6;
+}
+
+// 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;
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence_pb2.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence_pb2.py
new file mode 100644
index 000000000000..52b380063359
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence_pb2.py
@@ -0,0 +1,2422 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/videointelligence_v1p1beta1/proto/video_intelligence.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/videointelligence_v1p1beta1/proto/video_intelligence.proto",
+    package="google.cloud.videointelligence.v1p1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n,com.google.cloud.videointelligence.v1p1beta1B\035VideoIntelligenceServiceProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1p1beta1;videointelligence\252\002(Google.Cloud.VideoIntelligence.V1P1Beta1\312\002(Google\\Cloud\\VideoIntelligence\\V1p1beta1\352\002+Google::Cloud::VideoIntelligence::V1p1beta1"
+    ),
+    serialized_pb=_b(
+        '\nGgoogle/cloud/videointelligence_v1p1beta1/proto/video_intelligence.proto\x12(google.cloud.videointelligence.v1p1beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xfd\x01\n\x14\x41nnotateVideoRequest\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x15\n\rinput_content\x18\x06 \x01(\x0c\x12\x43\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0e\x32\x31.google.cloud.videointelligence.v1p1beta1.Feature\x12M\n\rvideo_context\x18\x03 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p1beta1.VideoContext\x12\x12\n\noutput_uri\x18\x04 \x01(\t\x12\x13\n\x0blocation_id\x18\x05 \x01(\t"\x82\x04\n\x0cVideoContext\x12H\n\x08segments\x18\x01 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p1beta1.VideoSegment\x12^\n\x16label_detection_config\x18\x02 \x01(\x0b\x32>.google.cloud.videointelligence.v1p1beta1.LabelDetectionConfig\x12i\n\x1cshot_change_detection_config\x18\x03 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p1beta1.ShotChangeDetectionConfig\x12s\n!explicit_content_detection_config\x18\x04 \x01(\x0b\x32H.google.cloud.videointelligence.v1p1beta1.ExplicitContentDetectionConfig\x12h\n\x1bspeech_transcription_config\x18\x06 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig"\x9c\x01\n\x14LabelDetectionConfig\x12Z\n\x14label_detection_mode\x18\x01 \x01(\x0e\x32<.google.cloud.videointelligence.v1p1beta1.LabelDetectionMode\x12\x19\n\x11stationary_camera\x18\x02 \x01(\x08\x12\r\n\x05model\x18\x03 \x01(\t"*\n\x19ShotChangeDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"/\n\x1e\x45xplicitContentDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"x\n\x0cVideoSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"k\n\x0cLabelSegment\x12G\n\x07segment\x18\x01 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p1beta1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02"P\n\nLabelFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nconfidence\x18\x02 \x01(\x02"G\n\x06\x45ntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t"\xb0\x02\n\x0fLabelAnnotation\x12@\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x30.google.cloud.videointelligence.v1p1beta1.Entity\x12K\n\x11\x63\x61tegory_entities\x18\x02 \x03(\x0b\x32\x30.google.cloud.videointelligence.v1p1beta1.Entity\x12H\n\x08segments\x18\x03 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p1beta1.LabelSegment\x12\x44\n\x06\x66rames\x18\x04 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1p1beta1.LabelFrame"\x9c\x01\n\x14\x45xplicitContentFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12T\n\x16pornography_likelihood\x18\x02 \x01(\x0e\x32\x34.google.cloud.videointelligence.v1p1beta1.Likelihood"k\n\x19\x45xplicitContentAnnotation\x12N\n\x06\x66rames\x18\x01 \x03(\x0b\x32>.google.cloud.videointelligence.v1p1beta1.ExplicitContentFrame"\xf5\x04\n\x16VideoAnnotationResults\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\\\n\x19segment_label_annotations\x18\x02 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p1beta1.LabelAnnotation\x12Y\n\x16shot_label_annotations\x18\x03 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p1beta1.LabelAnnotation\x12Z\n\x17\x66rame_label_annotations\x18\x04 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p1beta1.LabelAnnotation\x12P\n\x10shot_annotations\x18\x06 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p1beta1.VideoSegment\x12`\n\x13\x65xplicit_annotation\x18\x07 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p1beta1.ExplicitContentAnnotation\x12\\\n\x15speech_transcriptions\x18\x0b \x03(\x0b\x32=.google.cloud.videointelligence.v1p1beta1.SpeechTranscription\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status"u\n\x15\x41nnotateVideoResponse\x12\\\n\x12\x61nnotation_results\x18\x01 \x03(\x0b\x32@.google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults"\xa7\x01\n\x17VideoAnnotationProgress\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x18\n\x10progress_percent\x18\x02 \x01(\x05\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"w\n\x15\x41nnotateVideoProgress\x12^\n\x13\x61nnotation_progress\x18\x01 \x03(\x0b\x32\x41.google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress"\xf4\x01\n\x19SpeechTranscriptionConfig\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x18\n\x10max_alternatives\x18\x02 \x01(\x05\x12\x18\n\x10\x66ilter_profanity\x18\x03 \x01(\x08\x12P\n\x0fspeech_contexts\x18\x04 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1p1beta1.SpeechContext\x12$\n\x1c\x65nable_automatic_punctuation\x18\x05 \x01(\x08\x12\x14\n\x0c\x61udio_tracks\x18\x06 \x03(\x05" \n\rSpeechContext\x12\x0f\n\x07phrases\x18\x01 \x03(\t"s\n\x13SpeechTranscription\x12\\\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32\x46.google.cloud.videointelligence.v1p1beta1.SpeechRecognitionAlternative"\x89\x01\n\x1cSpeechRecognitionAlternative\x12\x12\n\ntranscript\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x41\n\x05words\x18\x03 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1p1beta1.WordInfo"t\n\x08WordInfo\x12-\n\nstart_time\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12+\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x0c\n\x04word\x18\x03 \x01(\t*\x8c\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x13\n\x0fLABEL_DETECTION\x10\x01\x12\x19\n\x15SHOT_CHANGE_DETECTION\x10\x02\x12\x1e\n\x1a\x45XPLICIT_CONTENT_DETECTION\x10\x03\x12\x18\n\x14SPEECH_TRANSCRIPTION\x10\x06*r\n\x12LabelDetectionMode\x12$\n LABEL_DETECTION_MODE_UNSPECIFIED\x10\x00\x12\r\n\tSHOT_MODE\x10\x01\x12\x0e\n\nFRAME_MODE\x10\x02\x12\x17\n\x13SHOT_AND_FRAME_MODE\x10\x03*t\n\nLikelihood\x12\x1a\n\x16LIKELIHOOD_UNSPECIFIED\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xb2\x01\n\x18VideoIntelligenceService\x12\x95\x01\n\rAnnotateVideo\x12>.google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest\x1a\x1d.google.longrunning.Operation"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p1beta1/videos:annotate:\x01*B\xae\x02\n,com.google.cloud.videointelligence.v1p1beta1B\x1dVideoIntelligenceServiceProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1p1beta1;videointelligence\xaa\x02(Google.Cloud.VideoIntelligence.V1P1Beta1\xca\x02(Google\\Cloud\\VideoIntelligence\\V1p1beta1\xea\x02+Google::Cloud::VideoIntelligence::V1p1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.videointelligence.v1p1beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_CHANGE_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPLICIT_CONTENT_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPEECH_TRANSCRIPTION",
+            index=4,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3959,
+    serialized_end=4099,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE)
+
+Feature = enum_type_wrapper.EnumTypeWrapper(_FEATURE)
+_LABELDETECTIONMODE = _descriptor.EnumDescriptor(
+    name="LabelDetectionMode",
+    full_name="google.cloud.videointelligence.v1p1beta1.LabelDetectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_MODE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_MODE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_AND_FRAME_MODE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4101,
+    serialized_end=4215,
+)
+_sym_db.RegisterEnumDescriptor(_LABELDETECTIONMODE)
+
+LabelDetectionMode = enum_type_wrapper.EnumTypeWrapper(_LABELDETECTIONMODE)
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.videointelligence.v1p1beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LIKELIHOOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4217,
+    serialized_end=4333,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+FEATURE_UNSPECIFIED = 0
+LABEL_DETECTION = 1
+SHOT_CHANGE_DETECTION = 2
+EXPLICIT_CONTENT_DETECTION = 3
+SPEECH_TRANSCRIPTION = 6
+LABEL_DETECTION_MODE_UNSPECIFIED = 0
+SHOT_MODE = 1
+FRAME_MODE = 2
+SHOT_AND_FRAME_MODE = 3
+LIKELIHOOD_UNSPECIFIED = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_ANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="AnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest.input_content",
+            index=1,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest.features",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_context",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest.video_context",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest.output_uri",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest.location_id",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=275,
+    serialized_end=528,
+)
+
+
+_VIDEOCONTEXT = _descriptor.Descriptor(
+    name="VideoContext",
+    full_name="google.cloud.videointelligence.v1p1beta1.VideoContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoContext.segments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_config",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoContext.label_detection_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_config",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoContext.shot_change_detection_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_content_detection_config",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoContext.explicit_content_detection_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_transcription_config",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoContext.speech_transcription_config",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=531,
+    serialized_end=1045,
+)
+
+
+_LABELDETECTIONCONFIG = _descriptor.Descriptor(
+    name="LabelDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p1beta1.LabelDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label_detection_mode",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelDetectionConfig.label_detection_mode",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelDetectionConfig.stationary_camera",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelDetectionConfig.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1048,
+    serialized_end=1204,
+)
+
+
+_SHOTCHANGEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ShotChangeDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p1beta1.ShotChangeDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p1beta1.ShotChangeDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1206,
+    serialized_end=1248,
+)
+
+
+_EXPLICITCONTENTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ExplicitContentDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1250,
+    serialized_end=1297,
+)
+
+
+_VIDEOSEGMENT = _descriptor.Descriptor(
+    name="VideoSegment",
+    full_name="google.cloud.videointelligence.v1p1beta1.VideoSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1299,
+    serialized_end=1419,
+)
+
+
+_LABELSEGMENT = _descriptor.Descriptor(
+    name="LabelSegment",
+    full_name="google.cloud.videointelligence.v1p1beta1.LabelSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1421,
+    serialized_end=1528,
+)
+
+
+_LABELFRAME = _descriptor.Descriptor(
+    name="LabelFrame",
+    full_name="google.cloud.videointelligence.v1p1beta1.LabelFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelFrame.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1530,
+    serialized_end=1610,
+)
+
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.videointelligence.v1p1beta1.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.videointelligence.v1p1beta1.Entity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.videointelligence.v1p1beta1.Entity.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1p1beta1.Entity.language_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1612,
+    serialized_end=1683,
+)
+
+
+_LABELANNOTATION = _descriptor.Descriptor(
+    name="LabelAnnotation",
+    full_name="google.cloud.videointelligence.v1p1beta1.LabelAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category_entities",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelAnnotation.category_entities",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelAnnotation.segments",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p1beta1.LabelAnnotation.frames",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1686,
+    serialized_end=1990,
+)
+
+
+_EXPLICITCONTENTFRAME = _descriptor.Descriptor(
+    name="ExplicitContentFrame",
+    full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pornography_likelihood",
+            full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentFrame.pornography_likelihood",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1993,
+    serialized_end=2149,
+)
+
+
+_EXPLICITCONTENTANNOTATION = _descriptor.Descriptor(
+    name="ExplicitContentAnnotation",
+    full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p1beta1.ExplicitContentAnnotation.frames",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2151,
+    serialized_end=2258,
+)
+
+
+_VIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="VideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment_label_annotations",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.segment_label_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_label_annotations",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.shot_label_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_label_annotations",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.frame_label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.shot_annotations",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_annotation",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.explicit_annotation",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_transcriptions",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.speech_transcriptions",
+            index=6,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults.error",
+            index=7,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2261,
+    serialized_end=2890,
+)
+
+
+_ANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="AnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse.annotation_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2892,
+    serialized_end=3009,
+)
+
+
+_VIDEOANNOTATIONPROGRESS = _descriptor.Descriptor(
+    name="VideoAnnotationProgress",
+    full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress.progress_percent",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3012,
+    serialized_end=3179,
+)
+
+
+_ANNOTATEVIDEOPROGRESS = _descriptor.Descriptor(
+    name="AnnotateVideoProgress",
+    full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_progress",
+            full_name="google.cloud.videointelligence.v1p1beta1.AnnotateVideoProgress.annotation_progress",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3181,
+    serialized_end=3300,
+)
+
+
+_SPEECHTRANSCRIPTIONCONFIG = _descriptor.Descriptor(
+    name="SpeechTranscriptionConfig",
+    full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_alternatives",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig.max_alternatives",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter_profanity",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig.filter_profanity",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_contexts",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig.speech_contexts",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_automatic_punctuation",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig.enable_automatic_punctuation",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_tracks",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig.audio_tracks",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3303,
+    serialized_end=3547,
+)
+
+
+_SPEECHCONTEXT = _descriptor.Descriptor(
+    name="SpeechContext",
+    full_name="google.cloud.videointelligence.v1p1beta1.SpeechContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="phrases",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechContext.phrases",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3549,
+    serialized_end=3581,
+)
+
+
+_SPEECHTRANSCRIPTION = _descriptor.Descriptor(
+    name="SpeechTranscription",
+    full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscription",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechTranscription.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3583,
+    serialized_end=3698,
+)
+
+
+_SPEECHRECOGNITIONALTERNATIVE = _descriptor.Descriptor(
+    name="SpeechRecognitionAlternative",
+    full_name="google.cloud.videointelligence.v1p1beta1.SpeechRecognitionAlternative",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transcript",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechRecognitionAlternative.transcript",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechRecognitionAlternative.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.videointelligence.v1p1beta1.SpeechRecognitionAlternative.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3701,
+    serialized_end=3838,
+)
+
+
+_WORDINFO = _descriptor.Descriptor(
+    name="WordInfo",
+    full_name="google.cloud.videointelligence.v1p1beta1.WordInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1p1beta1.WordInfo.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.videointelligence.v1p1beta1.WordInfo.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="word",
+            full_name="google.cloud.videointelligence.v1p1beta1.WordInfo.word",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3840,
+    serialized_end=3956,
+)
+
+_ANNOTATEVIDEOREQUEST.fields_by_name["features"].enum_type = _FEATURE
+_ANNOTATEVIDEOREQUEST.fields_by_name["video_context"].message_type = _VIDEOCONTEXT
+_VIDEOCONTEXT.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_VIDEOCONTEXT.fields_by_name[
+    "label_detection_config"
+].message_type = _LABELDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "shot_change_detection_config"
+].message_type = _SHOTCHANGEDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "explicit_content_detection_config"
+].message_type = _EXPLICITCONTENTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "speech_transcription_config"
+].message_type = _SPEECHTRANSCRIPTIONCONFIG
+_LABELDETECTIONCONFIG.fields_by_name[
+    "label_detection_mode"
+].enum_type = _LABELDETECTIONMODE
+_VIDEOSEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOSEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_LABELFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["category_entities"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["segments"].message_type = _LABELSEGMENT
+_LABELANNOTATION.fields_by_name["frames"].message_type = _LABELFRAME
+_EXPLICITCONTENTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_EXPLICITCONTENTFRAME.fields_by_name["pornography_likelihood"].enum_type = _LIKELIHOOD
+_EXPLICITCONTENTANNOTATION.fields_by_name["frames"].message_type = _EXPLICITCONTENTFRAME
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "segment_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "frame_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name["shot_annotations"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "explicit_annotation"
+].message_type = _EXPLICITCONTENTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "speech_transcriptions"
+].message_type = _SPEECHTRANSCRIPTION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _VIDEOANNOTATIONRESULTS
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ANNOTATEVIDEOPROGRESS.fields_by_name[
+    "annotation_progress"
+].message_type = _VIDEOANNOTATIONPROGRESS
+_SPEECHTRANSCRIPTIONCONFIG.fields_by_name[
+    "speech_contexts"
+].message_type = _SPEECHCONTEXT
+_SPEECHTRANSCRIPTION.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_SPEECHRECOGNITIONALTERNATIVE.fields_by_name["words"].message_type = _WORDINFO
+_WORDINFO.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_WORDINFO.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+DESCRIPTOR.message_types_by_name["AnnotateVideoRequest"] = _ANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["VideoContext"] = _VIDEOCONTEXT
+DESCRIPTOR.message_types_by_name["LabelDetectionConfig"] = _LABELDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ShotChangeDetectionConfig"
+] = _SHOTCHANGEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentDetectionConfig"
+] = _EXPLICITCONTENTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["VideoSegment"] = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["LabelSegment"] = _LABELSEGMENT
+DESCRIPTOR.message_types_by_name["LabelFrame"] = _LABELFRAME
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["LabelAnnotation"] = _LABELANNOTATION
+DESCRIPTOR.message_types_by_name["ExplicitContentFrame"] = _EXPLICITCONTENTFRAME
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentAnnotation"
+] = _EXPLICITCONTENTANNOTATION
+DESCRIPTOR.message_types_by_name["VideoAnnotationResults"] = _VIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["AnnotateVideoResponse"] = _ANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name["VideoAnnotationProgress"] = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoProgress"] = _ANNOTATEVIDEOPROGRESS
+DESCRIPTOR.message_types_by_name[
+    "SpeechTranscriptionConfig"
+] = _SPEECHTRANSCRIPTIONCONFIG
+DESCRIPTOR.message_types_by_name["SpeechContext"] = _SPEECHCONTEXT
+DESCRIPTOR.message_types_by_name["SpeechTranscription"] = _SPEECHTRANSCRIPTION
+DESCRIPTOR.message_types_by_name[
+    "SpeechRecognitionAlternative"
+] = _SPEECHRECOGNITIONALTERNATIVE
+DESCRIPTOR.message_types_by_name["WordInfo"] = _WORDINFO
+DESCRIPTOR.enum_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.enum_types_by_name["LabelDetectionMode"] = _LABELDETECTIONMODE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation request.
+  
+  
+  Attributes:
+      input_uri:
+          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.
+      input_content:
+          The video data bytes. If unset, the input video(s) should be
+          specified via ``input_uri``. If set, ``input_uri`` should be
+          unset.
+      features:
+          Requested video annotation features.
+      video_context:
+          Additional video context and/or feature-specific parameters.
+      output_uri:
+          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>`__.
+      location_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.AnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoRequest)
+
+VideoContext = _reflection.GeneratedProtocolMessageType(
+    "VideoContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCONTEXT,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      segments:
+          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.
+      label_detection_config:
+          Config for LABEL\_DETECTION.
+      shot_change_detection_config:
+          Config for SHOT\_CHANGE\_DETECTION.
+      explicit_content_detection_config:
+          Config for EXPLICIT\_CONTENT\_DETECTION.
+      speech_transcription_config:
+          Config for SPEECH\_TRANSCRIPTION.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.VideoContext)
+    ),
+)
+_sym_db.RegisterMessage(VideoContext)
+
+LabelDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "LabelDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for LABEL\_DETECTION.
+  
+  
+  Attributes:
+      label_detection_mode:
+          What labels should be detected with LABEL\_DETECTION, in
+          addition to video-level labels or segment-level labels. If
+          unspecified, defaults to ``SHOT_MODE``.
+      stationary_camera:
+          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.
+      model:
+          Model to use for label detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.LabelDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(LabelDetectionConfig)
+
+ShotChangeDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ShotChangeDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SHOTCHANGEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for SHOT\_CHANGE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for shot change detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.ShotChangeDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ShotChangeDetectionConfig)
+
+ExplicitContentDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for EXPLICIT\_CONTENT\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for explicit content detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.ExplicitContentDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentDetectionConfig)
+
+VideoSegment = _reflection.GeneratedProtocolMessageType(
+    "VideoSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOSEGMENT,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment.
+  
+  
+  Attributes:
+      start_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the start of the segment (inclusive).
+      end_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the end of the segment (inclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.VideoSegment)
+    ),
+)
+_sym_db.RegisterMessage(VideoSegment)
+
+LabelSegment = _reflection.GeneratedProtocolMessageType(
+    "LabelSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELSEGMENT,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for label detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a label was detected.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.LabelSegment)
+    ),
+)
+_sym_db.RegisterMessage(LabelSegment)
+
+LabelFrame = _reflection.GeneratedProtocolMessageType(
+    "LabelFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELFRAME,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for label detection.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.LabelFrame)
+    ),
+)
+_sym_db.RegisterMessage(LabelFrame)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Detected entity from video analysis.
+  
+  
+  Attributes:
+      entity_id:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      description:
+          Textual description, e.g. ``Fixed-gear bicycle``.
+      language_code:
+          Language code for ``description`` in BCP-47 format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+
+LabelAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LabelAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELANNOTATION,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Label annotation.
+  
+  
+  Attributes:
+      entity:
+          Detected entity.
+      category_entities:
+          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``.
+      segments:
+          All video segments where a label was detected.
+      frames:
+          All video frames where a label was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.LabelAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LabelAnnotation)
+
+ExplicitContentFrame = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTFRAME,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for explicit content.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      pornography_likelihood:
+          Likelihood of the pornography content..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.ExplicitContentFrame)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentFrame)
+
+ExplicitContentAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTANNOTATION,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Explicit content annotation (based on per-frame visual signals only). If
+  no explicit content has been detected in a frame, no annotations are
+  present for that frame.
+  
+  
+  Attributes:
+      frames:
+          All video frames where explicit content was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.ExplicitContentAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentAnnotation)
+
+VideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation results for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Output only. Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      segment_label_annotations:
+          Label annotations on video level or user specified segment
+          level. There is exactly one element for each unique label.
+      shot_label_annotations:
+          Label annotations on shot level. There is exactly one element
+          for each unique label.
+      frame_label_annotations:
+          Label annotations on frame level. There is exactly one element
+          for each unique label.
+      shot_annotations:
+          Shot annotations. Each shot is represented as a video segment.
+      explicit_annotation:
+          Explicit content annotation.
+      speech_transcriptions:
+          Speech transcription.
+      error:
+          Output only. If set, indicates an error. Note that for a
+          single ``AnnotateVideoRequest`` some videos may succeed and
+          some may fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.VideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationResults)
+
+AnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation response. Included in the ``response`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_results:
+          Annotation results for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoResponse)
+
+VideoAnnotationProgress = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONPROGRESS,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation progress for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Output only. Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      progress_percent:
+          Output only. Approximate percentage processed thus far.
+          Guaranteed to be 100 when fully processed.
+      start_time:
+          Output only. Time when the request was received.
+      update_time:
+          Output only. Time of the most recent update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.VideoAnnotationProgress)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationProgress)
+
+AnnotateVideoProgress = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOPROGRESS,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation progress. Included in the ``metadata`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_progress:
+          Progress metadata for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.AnnotateVideoProgress)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoProgress)
+
+SpeechTranscriptionConfig = _reflection.GeneratedProtocolMessageType(
+    "SpeechTranscriptionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHTRANSCRIPTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for SPEECH\_TRANSCRIPTION.
+  
+  
+  Attributes:
+      language_code:
+          *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.
+      max_alternatives:
+          *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
+          ``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.
+      filter_profanity:
+          *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.
+      speech_contexts:
+          *Optional* A means to provide context to assist the speech
+          recognition.
+      enable_automatic_punctuation:
+          *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."
+      audio_tracks:
+          *Optional* For file formats, such as MXF or MKV, supporting
+          multiple audio tracks, specify up to two tracks. Default:
+          track 0.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.SpeechTranscriptionConfig)
+    ),
+)
+_sym_db.RegisterMessage(SpeechTranscriptionConfig)
+
+SpeechContext = _reflection.GeneratedProtocolMessageType(
+    "SpeechContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHCONTEXT,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Provides "hints" to the speech recognizer to favor specific words and
+  phrases in the results.
+  
+  
+  Attributes:
+      phrases:
+          *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>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.SpeechContext)
+    ),
+)
+_sym_db.RegisterMessage(SpeechContext)
+
+SpeechTranscription = _reflection.GeneratedProtocolMessageType(
+    "SpeechTranscription",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHTRANSCRIPTION,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""A speech recognition result corresponding to a portion of the audio.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.SpeechTranscription)
+    ),
+)
+_sym_db.RegisterMessage(SpeechTranscription)
+
+SpeechRecognitionAlternative = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionAlternative",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONALTERNATIVE,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Alternative hypotheses (a.k.a. n-best list).
+  
+  
+  Attributes:
+      transcript:
+          Output only. Transcript text representing the words that the
+          user spoke.
+      confidence:
+          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. The default of 0.0 is a sentinel value indicating
+          ``confidence`` was not set.
+      words:
+          Output only. A list of word-specific information for each
+          recognized word.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.SpeechRecognitionAlternative)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionAlternative)
+
+WordInfo = _reflection.GeneratedProtocolMessageType(
+    "WordInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORDINFO,
+        __module__="google.cloud.videointelligence_v1p1beta1.proto.video_intelligence_pb2",
+        __doc__="""Word-specific information for recognized words. Word information is only
+  included in the response when certain request parameters are set, such
+  as ``enable_word_time_offsets``.
+  
+  
+  Attributes:
+      start_time:
+          Output only. 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. This is an experimental feature
+          and the accuracy of the time offset can vary.
+      end_time:
+          Output only. 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. This is an experimental feature
+          and the accuracy of the time offset can vary.
+      word:
+          Output only. The word corresponding to this set of
+          information.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p1beta1.WordInfo)
+    ),
+)
+_sym_db.RegisterMessage(WordInfo)
+
+
+DESCRIPTOR._options = None
+
+_VIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="VideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4336,
+    serialized_end=4514,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnnotateVideo",
+            full_name="google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService.AnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_ANNOTATEVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p1beta1/videos:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_VIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name["VideoIntelligenceService"] = _VIDEOINTELLIGENCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence_pb2_grpc.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence_pb2_grpc.py
new file mode 100644
index 000000000000..91583de36852
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/proto/video_intelligence_pb2_grpc.py
@@ -0,0 +1,56 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.videointelligence_v1p1beta1.proto import (
+    video_intelligence_pb2 as google_dot_cloud_dot_videointelligence__v1p1beta1_dot_proto_dot_video__intelligence__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class VideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnnotateVideo = channel.unary_unary(
+            "/google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService/AnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1p1beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class VideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def AnnotateVideo(self, request, context):
+        """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).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_VideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnnotateVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1p1beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/videointelligence/google/cloud/videointelligence_v1p1beta1/types.py b/videointelligence/google/cloud/videointelligence_v1p1beta1/types.py
new file mode 100644
index 000000000000..a1ff8767be79
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p1beta1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.videointelligence_v1p1beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [video_intelligence_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.videointelligence_v1p1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/__init__.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/__init__.py
new file mode 100644
index 000000000000..bb08b22fa8fa
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1p2beta1 import types
+from google.cloud.videointelligence_v1p2beta1.gapic import enums
+from google.cloud.videointelligence_v1p2beta1.gapic import (
+    video_intelligence_service_client,
+)
+
+
+class VideoIntelligenceServiceClient(
+    video_intelligence_service_client.VideoIntelligenceServiceClient
+):
+    __doc__ = video_intelligence_service_client.VideoIntelligenceServiceClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "VideoIntelligenceServiceClient")
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/__init__.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/enums.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/enums.py
new file mode 100644
index 000000000000..4d0ad701bd40
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/enums.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Feature(enum.IntEnum):
+    """
+    Video annotation feature.
+
+    Attributes:
+      FEATURE_UNSPECIFIED (int): Unspecified.
+      LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      SHOT_CHANGE_DETECTION (int): Shot change detection.
+      EXPLICIT_CONTENT_DETECTION (int): Explicit content detection.
+      TEXT_DETECTION (int): OCR text detection and tracking.
+      OBJECT_TRACKING (int): Object detection and tracking.
+    """
+
+    FEATURE_UNSPECIFIED = 0
+    LABEL_DETECTION = 1
+    SHOT_CHANGE_DETECTION = 2
+    EXPLICIT_CONTENT_DETECTION = 3
+    TEXT_DETECTION = 7
+    OBJECT_TRACKING = 9
+
+
+class LabelDetectionMode(enum.IntEnum):
+    """
+    Label detection mode.
+
+    Attributes:
+      LABEL_DETECTION_MODE_UNSPECIFIED (int): Unspecified.
+      SHOT_MODE (int): Detect shot-level labels.
+      FRAME_MODE (int): Detect frame-level labels.
+      SHOT_AND_FRAME_MODE (int): Detect both shot-level and frame-level labels.
+    """
+
+    LABEL_DETECTION_MODE_UNSPECIFIED = 0
+    SHOT_MODE = 1
+    FRAME_MODE = 2
+    SHOT_AND_FRAME_MODE = 3
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Bucketized representation of likelihood.
+
+    Attributes:
+      LIKELIHOOD_UNSPECIFIED (int): Unspecified likelihood.
+      VERY_UNLIKELY (int): Very unlikely.
+      UNLIKELY (int): Unlikely.
+      POSSIBLE (int): Possible.
+      LIKELY (int): Likely.
+      VERY_LIKELY (int): Very likely.
+    """
+
+    LIKELIHOOD_UNSPECIFIED = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/transports/__init__.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/transports/video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/transports/video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..b8eb33c1e9c3
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/transports/video_intelligence_service_grpc_transport.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.videointelligence_v1p2beta1.proto import video_intelligence_pb2_grpc
+
+
+class VideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1p2beta1 VideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "video_intelligence_service_stub": video_intelligence_pb2_grpc.VideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def annotate_video(self):
+        """Return the gRPC stub for :meth:`VideoIntelligenceServiceClient.annotate_video`.
+
+        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).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["video_intelligence_service_stub"].AnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/video_intelligence_service_client.py
new file mode 100644
index 000000000000..323f959ab7af
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/video_intelligence_service_client.py
@@ -0,0 +1,308 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1p2beta1 VideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import grpc
+
+from google.cloud.videointelligence_v1p2beta1.gapic import enums
+from google.cloud.videointelligence_v1p2beta1.gapic import (
+    video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1p2beta1.gapic.transports import (
+    video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1p2beta1.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1p2beta1.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class VideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = (
+        "google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService"
+    )
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            VideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.VideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.VideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def annotate_video(
+        self,
+        input_uri=None,
+        input_content=None,
+        features=None,
+        video_context=None,
+        output_uri=None,
+        location_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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).
+
+        Example:
+            >>> from google.cloud import videointelligence_v1p2beta1
+            >>> from google.cloud.videointelligence_v1p2beta1 import enums
+            >>>
+            >>> client = videointelligence_v1p2beta1.VideoIntelligenceServiceClient()
+            >>>
+            >>> input_uri = 'gs://cloud-samples-data/video/cat.mp4'
+            >>> features_element = enums.Feature.LABEL_DETECTION
+            >>> features = [features_element]
+            >>>
+            >>> response = client.annotate_video(input_uri=input_uri, features=features)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            input_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/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.
+            input_content (bytes): The video data bytes. If unset, the input video(s) should be specified
+                via ``input_uri``. If set, ``input_uri`` should be unset.
+            features (list[~google.cloud.videointelligence_v1p2beta1.types.Feature]): Requested video annotation features.
+            video_context (Union[dict, ~google.cloud.videointelligence_v1p2beta1.types.VideoContext]): Additional video context and/or feature-specific parameters.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.videointelligence_v1p2beta1.types.VideoContext`
+            output_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/storage/docs/reference-uris>`__.
+            location_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.videointelligence_v1p2beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_video,
+                default_retry=self._method_configs["AnnotateVideo"].retry,
+                default_timeout=self._method_configs["AnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri,
+            input_content=input_content,
+            features=features,
+            video_context=video_context,
+            output_uri=output_uri,
+            location_id=location_id,
+        )
+        operation = self._inner_api_calls["annotate_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            video_intelligence_pb2.AnnotateVideoResponse,
+            metadata_type=video_intelligence_pb2.AnnotateVideoProgress,
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..4c0b9f3858b9
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/gapic/video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnnotateVideo": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/__init__.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence.proto b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence.proto
new file mode 100644
index 000000000000..0a16e7afd154
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence.proto
@@ -0,0 +1,467 @@
+// 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.cloud.videointelligence.v1p2beta1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.VideoIntelligence.V1P2Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1p2beta1;videointelligence";
+option java_multiple_files = true;
+option java_outer_classname = "VideoIntelligenceServiceProto";
+option java_package = "com.google.cloud.videointelligence.v1p2beta1";
+option php_namespace = "Google\\Cloud\\VideoIntelligence\\V1p2beta1";
+option ruby_package = "Google::Cloud::VideoIntelligence::V1p2beta1";
+
+// 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: "/v1p2beta1/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.
+  // If unset, the input video(s) should be specified via `input_uri`.
+  // If set, `input_uri` should be unset.
+  bytes 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;
+
+  // Config for LABEL_DETECTION.
+  LabelDetectionConfig label_detection_config = 2;
+
+  // Config for SHOT_CHANGE_DETECTION.
+  ShotChangeDetectionConfig shot_change_detection_config = 3;
+
+  // Config for EXPLICIT_CONTENT_DETECTION.
+  ExplicitContentDetectionConfig explicit_content_detection_config = 4;
+
+  // Config for TEXT_DETECTION.
+  TextDetectionConfig text_detection_config = 8;
+}
+
+// Config for LABEL_DETECTION.
+message LabelDetectionConfig {
+  // What labels should be detected with LABEL_DETECTION, in addition to
+  // video-level labels or segment-level labels.
+  // 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.
+  bool stationary_camera = 2;
+
+  // Model to use for label detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// Config for SHOT_CHANGE_DETECTION.
+message ShotChangeDetectionConfig {
+  // Model to use for shot change detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 1;
+}
+
+// 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;
+}
+
+// Config for TEXT_DETECTION.
+message TextDetectionConfig {
+  // Language hint can be specified if the language to be detected is known a
+  // priori. It can increase the accuracy of the detection. Language hint must
+  // be language code in BCP-47 format.
+  //
+  // Automatic language detection is performed if no hint is provided.
+  repeated string language_hints = 1;
+}
+
+// Video segment.
+message VideoSegment {
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the start of the segment (inclusive).
+  google.protobuf.Duration start_time_offset = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the end of the segment (inclusive).
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video segment level annotation results for label detection.
+message LabelSegment {
+  // Video segment where a label was detected.
+  VideoSegment segment = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Video frame level annotation results for label detection.
+message LabelFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Detected entity from video analysis.
+message Entity {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string entity_id = 1;
+
+  // Textual description, e.g. `Fixed-gear bicycle`.
+  string description = 2;
+
+  // Language code for `description` in BCP-47 format.
+  string language_code = 3;
+}
+
+// Label annotation.
+message LabelAnnotation {
+  // Detected entity.
+  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`.
+  repeated Entity category_entities = 2;
+
+  // All video segments where a label was detected.
+  repeated LabelSegment segments = 3;
+
+  // All video frames where a label was detected.
+  repeated LabelFrame frames = 4;
+}
+
+// Video frame level annotation results for explicit content.
+message ExplicitContentFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Likelihood of the pornography content..
+  Likelihood pornography_likelihood = 2;
+}
+
+// Explicit content annotation (based on per-frame visual signals only).
+// If no explicit content has been detected in a frame, no annotations are
+// present for that frame.
+message ExplicitContentAnnotation {
+  // All video frames where explicit content was detected.
+  repeated ExplicitContentFrame frames = 1;
+}
+
+// Normalized bounding box.
+// The normalized vertex coordinates are relative to the original image.
+// Range: [0, 1].
+message NormalizedBoundingBox {
+  // Left X coordinate.
+  float left = 1;
+
+  // Top Y coordinate.
+  float top = 2;
+
+  // Right X coordinate.
+  float right = 3;
+
+  // Bottom Y coordinate.
+  float bottom = 4;
+}
+
+// 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.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation segment_label_annotations = 2;
+
+  // Label annotations on shot level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation shot_label_annotations = 3;
+
+  // Label annotations on frame level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation frame_label_annotations = 4;
+
+  // Shot annotations. Each shot is represented as a video segment.
+  repeated VideoSegment shot_annotations = 6;
+
+  // Explicit content annotation.
+  ExplicitContentAnnotation explicit_annotation = 7;
+
+  // OCR text detection and tracking.
+  // Annotations for list of detected text snippets. Each will have list of
+  // frame information associated with it.
+  repeated TextAnnotation text_annotations = 12;
+
+  // Annotations for list of objects detected and tracked in video.
+  repeated ObjectTrackingAnnotation object_annotations = 14;
+
+  // If set, indicates an error. Note that for a single `AnnotateVideoRequest`
+  // some videos may succeed and some may fail.
+  google.rpc.Status error = 9;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// Normalized bounding polygon for text (that might not be aligned with axis).
+// Contains list of the corner points in clockwise order starting from
+// top-left corner. For example, for a rectangular bounding box:
+// When the text is horizontal it might look like:
+//         0----1
+//         |    |
+//         3----2
+//
+// When it's clockwise rotated 180 degrees around the top-left corner it
+// becomes:
+//         2----3
+//         |    |
+//         1----0
+//
+// and the vertex order will still be (0, 1, 2, 3). Note that values can be less
+// than 0, or greater than 1 due to trignometric calculations for location of
+// the box.
+message NormalizedBoundingPoly {
+  // Normalized vertices of the bounding polygon.
+  repeated NormalizedVertex vertices = 1;
+}
+
+// Video segment level annotation results for text detection.
+message TextSegment {
+  // Video segment where a text snippet was detected.
+  VideoSegment segment = 1;
+
+  // Confidence for the track of detected text. It is calculated as the highest
+  // over all frames where OCR detected text appears.
+  float confidence = 2;
+
+  // Information related to the frames where OCR detected text appears.
+  repeated TextFrame frames = 3;
+}
+
+// Video frame level annotation results for text annotation (OCR).
+// Contains information regarding timestamp and bounding box locations for the
+// frames containing detected OCR text snippets.
+message TextFrame {
+  // Bounding polygon of the detected text for this frame.
+  NormalizedBoundingPoly rotated_bounding_box = 1;
+
+  // Timestamp of this frame.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Annotations related to one detected OCR text snippet. This will contain the
+// corresponding text, confidence value, and frame level information for each
+// detection.
+message TextAnnotation {
+  // The detected text.
+  string text = 1;
+
+  // All video segments where OCR detected text appears.
+  repeated TextSegment segments = 2;
+}
+
+// Video frame level annotations for object detection and tracking. This field
+// stores per frame location, time offset, and confidence.
+message ObjectTrackingFrame {
+  // The normalized bounding box location of this object track for the frame.
+  NormalizedBoundingBox normalized_bounding_box = 1;
+
+  // The timestamp of the frame in microseconds.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// 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.
+  repeated ObjectTrackingFrame frames = 2;
+
+  // Each object track corresponds to one video segment where it appears.
+  VideoSegment segment = 3;
+}
+
+// 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;
+
+  // 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;
+
+  // Likely.
+  LIKELY = 4;
+
+  // Very likely.
+  VERY_LIKELY = 5;
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence_pb2.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence_pb2.py
new file mode 100644
index 000000000000..73e3c2d5cdba
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence_pb2.py
@@ -0,0 +1,2711 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/videointelligence_v1p2beta1/proto/video_intelligence.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/videointelligence_v1p2beta1/proto/video_intelligence.proto",
+    package="google.cloud.videointelligence.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n,com.google.cloud.videointelligence.v1p2beta1B\035VideoIntelligenceServiceProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1p2beta1;videointelligence\252\002(Google.Cloud.VideoIntelligence.V1P2Beta1\312\002(Google\\Cloud\\VideoIntelligence\\V1p2beta1\352\002+Google::Cloud::VideoIntelligence::V1p2beta1"
+    ),
+    serialized_pb=_b(
+        '\nGgoogle/cloud/videointelligence_v1p2beta1/proto/video_intelligence.proto\x12(google.cloud.videointelligence.v1p2beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xfd\x01\n\x14\x41nnotateVideoRequest\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x15\n\rinput_content\x18\x06 \x01(\x0c\x12\x43\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0e\x32\x31.google.cloud.videointelligence.v1p2beta1.Feature\x12M\n\rvideo_context\x18\x03 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.VideoContext\x12\x12\n\noutput_uri\x18\x04 \x01(\t\x12\x13\n\x0blocation_id\x18\x05 \x01(\t"\xf6\x03\n\x0cVideoContext\x12H\n\x08segments\x18\x01 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.VideoSegment\x12^\n\x16label_detection_config\x18\x02 \x01(\x0b\x32>.google.cloud.videointelligence.v1p2beta1.LabelDetectionConfig\x12i\n\x1cshot_change_detection_config\x18\x03 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p2beta1.ShotChangeDetectionConfig\x12s\n!explicit_content_detection_config\x18\x04 \x01(\x0b\x32H.google.cloud.videointelligence.v1p2beta1.ExplicitContentDetectionConfig\x12\\\n\x15text_detection_config\x18\x08 \x01(\x0b\x32=.google.cloud.videointelligence.v1p2beta1.TextDetectionConfig"\x9c\x01\n\x14LabelDetectionConfig\x12Z\n\x14label_detection_mode\x18\x01 \x01(\x0e\x32<.google.cloud.videointelligence.v1p2beta1.LabelDetectionMode\x12\x19\n\x11stationary_camera\x18\x02 \x01(\x08\x12\r\n\x05model\x18\x03 \x01(\t"*\n\x19ShotChangeDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"/\n\x1e\x45xplicitContentDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"-\n\x13TextDetectionConfig\x12\x16\n\x0elanguage_hints\x18\x01 \x03(\t"x\n\x0cVideoSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"k\n\x0cLabelSegment\x12G\n\x07segment\x18\x01 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02"P\n\nLabelFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nconfidence\x18\x02 \x01(\x02"G\n\x06\x45ntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t"\xb0\x02\n\x0fLabelAnnotation\x12@\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x30.google.cloud.videointelligence.v1p2beta1.Entity\x12K\n\x11\x63\x61tegory_entities\x18\x02 \x03(\x0b\x32\x30.google.cloud.videointelligence.v1p2beta1.Entity\x12H\n\x08segments\x18\x03 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.LabelSegment\x12\x44\n\x06\x66rames\x18\x04 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1p2beta1.LabelFrame"\x9c\x01\n\x14\x45xplicitContentFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12T\n\x16pornography_likelihood\x18\x02 \x01(\x0e\x32\x34.google.cloud.videointelligence.v1p2beta1.Likelihood"k\n\x19\x45xplicitContentAnnotation\x12N\n\x06\x66rames\x18\x01 \x03(\x0b\x32>.google.cloud.videointelligence.v1p2beta1.ExplicitContentFrame"Q\n\x15NormalizedBoundingBox\x12\x0c\n\x04left\x18\x01 \x01(\x02\x12\x0b\n\x03top\x18\x02 \x01(\x02\x12\r\n\x05right\x18\x03 \x01(\x02\x12\x0e\n\x06\x62ottom\x18\x04 \x01(\x02"\xcb\x05\n\x16VideoAnnotationResults\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\\\n\x19segment_label_annotations\x18\x02 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p2beta1.LabelAnnotation\x12Y\n\x16shot_label_annotations\x18\x03 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p2beta1.LabelAnnotation\x12Z\n\x17\x66rame_label_annotations\x18\x04 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p2beta1.LabelAnnotation\x12P\n\x10shot_annotations\x18\x06 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.VideoSegment\x12`\n\x13\x65xplicit_annotation\x18\x07 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p2beta1.ExplicitContentAnnotation\x12R\n\x10text_annotations\x18\x0c \x03(\x0b\x32\x38.google.cloud.videointelligence.v1p2beta1.TextAnnotation\x12^\n\x12object_annotations\x18\x0e \x03(\x0b\x32\x42.google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status"u\n\x15\x41nnotateVideoResponse\x12\\\n\x12\x61nnotation_results\x18\x01 \x03(\x0b\x32@.google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults"\xa7\x01\n\x17VideoAnnotationProgress\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x18\n\x10progress_percent\x18\x02 \x01(\x05\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"w\n\x15\x41nnotateVideoProgress\x12^\n\x13\x61nnotation_progress\x18\x01 \x03(\x0b\x32\x41.google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"f\n\x16NormalizedBoundingPoly\x12L\n\x08vertices\x18\x01 \x03(\x0b\x32:.google.cloud.videointelligence.v1p2beta1.NormalizedVertex"\xaf\x01\n\x0bTextSegment\x12G\n\x07segment\x18\x01 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x43\n\x06\x66rames\x18\x03 \x03(\x0b\x32\x33.google.cloud.videointelligence.v1p2beta1.TextFrame"\x9b\x01\n\tTextFrame\x12^\n\x14rotated_bounding_box\x18\x01 \x01(\x0b\x32@.google.cloud.videointelligence.v1p2beta1.NormalizedBoundingPoly\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"g\n\x0eTextAnnotation\x12\x0c\n\x04text\x18\x01 \x01(\t\x12G\n\x08segments\x18\x02 \x03(\x0b\x32\x35.google.cloud.videointelligence.v1p2beta1.TextSegment"\xa7\x01\n\x13ObjectTrackingFrame\x12`\n\x17normalized_bounding_box\x18\x01 \x01(\x0b\x32?.google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\x88\x02\n\x18ObjectTrackingAnnotation\x12@\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x30.google.cloud.videointelligence.v1p2beta1.Entity\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x12M\n\x06\x66rames\x18\x02 \x03(\x0b\x32=.google.cloud.videointelligence.v1p2beta1.ObjectTrackingFrame\x12G\n\x07segment\x18\x03 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p2beta1.VideoSegment*\x9b\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x13\n\x0fLABEL_DETECTION\x10\x01\x12\x19\n\x15SHOT_CHANGE_DETECTION\x10\x02\x12\x1e\n\x1a\x45XPLICIT_CONTENT_DETECTION\x10\x03\x12\x12\n\x0eTEXT_DETECTION\x10\x07\x12\x13\n\x0fOBJECT_TRACKING\x10\t*r\n\x12LabelDetectionMode\x12$\n LABEL_DETECTION_MODE_UNSPECIFIED\x10\x00\x12\r\n\tSHOT_MODE\x10\x01\x12\x0e\n\nFRAME_MODE\x10\x02\x12\x17\n\x13SHOT_AND_FRAME_MODE\x10\x03*t\n\nLikelihood\x12\x1a\n\x16LIKELIHOOD_UNSPECIFIED\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xb2\x01\n\x18VideoIntelligenceService\x12\x95\x01\n\rAnnotateVideo\x12>.google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest\x1a\x1d.google.longrunning.Operation"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p2beta1/videos:annotate:\x01*B\xae\x02\n,com.google.cloud.videointelligence.v1p2beta1B\x1dVideoIntelligenceServiceProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1p2beta1;videointelligence\xaa\x02(Google.Cloud.VideoIntelligence.V1P2Beta1\xca\x02(Google\\Cloud\\VideoIntelligence\\V1p2beta1\xea\x02+Google::Cloud::VideoIntelligence::V1p2beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.videointelligence.v1p2beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_CHANGE_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPLICIT_CONTENT_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=4, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_TRACKING",
+            index=5,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4531,
+    serialized_end=4686,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE)
+
+Feature = enum_type_wrapper.EnumTypeWrapper(_FEATURE)
+_LABELDETECTIONMODE = _descriptor.EnumDescriptor(
+    name="LabelDetectionMode",
+    full_name="google.cloud.videointelligence.v1p2beta1.LabelDetectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_MODE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_MODE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_AND_FRAME_MODE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4688,
+    serialized_end=4802,
+)
+_sym_db.RegisterEnumDescriptor(_LABELDETECTIONMODE)
+
+LabelDetectionMode = enum_type_wrapper.EnumTypeWrapper(_LABELDETECTIONMODE)
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.videointelligence.v1p2beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LIKELIHOOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=4804,
+    serialized_end=4920,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+FEATURE_UNSPECIFIED = 0
+LABEL_DETECTION = 1
+SHOT_CHANGE_DETECTION = 2
+EXPLICIT_CONTENT_DETECTION = 3
+TEXT_DETECTION = 7
+OBJECT_TRACKING = 9
+LABEL_DETECTION_MODE_UNSPECIFIED = 0
+SHOT_MODE = 1
+FRAME_MODE = 2
+SHOT_AND_FRAME_MODE = 3
+LIKELIHOOD_UNSPECIFIED = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_ANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="AnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest.input_content",
+            index=1,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest.features",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_context",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest.video_context",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest.output_uri",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest.location_id",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=275,
+    serialized_end=528,
+)
+
+
+_VIDEOCONTEXT = _descriptor.Descriptor(
+    name="VideoContext",
+    full_name="google.cloud.videointelligence.v1p2beta1.VideoContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoContext.segments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_config",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoContext.label_detection_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_config",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoContext.shot_change_detection_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_content_detection_config",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoContext.explicit_content_detection_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_detection_config",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoContext.text_detection_config",
+            index=4,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=531,
+    serialized_end=1033,
+)
+
+
+_LABELDETECTIONCONFIG = _descriptor.Descriptor(
+    name="LabelDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p2beta1.LabelDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label_detection_mode",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelDetectionConfig.label_detection_mode",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelDetectionConfig.stationary_camera",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelDetectionConfig.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1036,
+    serialized_end=1192,
+)
+
+
+_SHOTCHANGEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ShotChangeDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p2beta1.ShotChangeDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p2beta1.ShotChangeDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1194,
+    serialized_end=1236,
+)
+
+
+_EXPLICITCONTENTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ExplicitContentDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1238,
+    serialized_end=1285,
+)
+
+
+_TEXTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="TextDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p2beta1.TextDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextDetectionConfig.language_hints",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1287,
+    serialized_end=1332,
+)
+
+
+_VIDEOSEGMENT = _descriptor.Descriptor(
+    name="VideoSegment",
+    full_name="google.cloud.videointelligence.v1p2beta1.VideoSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1334,
+    serialized_end=1454,
+)
+
+
+_LABELSEGMENT = _descriptor.Descriptor(
+    name="LabelSegment",
+    full_name="google.cloud.videointelligence.v1p2beta1.LabelSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1456,
+    serialized_end=1563,
+)
+
+
+_LABELFRAME = _descriptor.Descriptor(
+    name="LabelFrame",
+    full_name="google.cloud.videointelligence.v1p2beta1.LabelFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelFrame.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1565,
+    serialized_end=1645,
+)
+
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.videointelligence.v1p2beta1.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.videointelligence.v1p2beta1.Entity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.videointelligence.v1p2beta1.Entity.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1p2beta1.Entity.language_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1647,
+    serialized_end=1718,
+)
+
+
+_LABELANNOTATION = _descriptor.Descriptor(
+    name="LabelAnnotation",
+    full_name="google.cloud.videointelligence.v1p2beta1.LabelAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category_entities",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelAnnotation.category_entities",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelAnnotation.segments",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p2beta1.LabelAnnotation.frames",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1721,
+    serialized_end=2025,
+)
+
+
+_EXPLICITCONTENTFRAME = _descriptor.Descriptor(
+    name="ExplicitContentFrame",
+    full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pornography_likelihood",
+            full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentFrame.pornography_likelihood",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2028,
+    serialized_end=2184,
+)
+
+
+_EXPLICITCONTENTANNOTATION = _descriptor.Descriptor(
+    name="ExplicitContentAnnotation",
+    full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p2beta1.ExplicitContentAnnotation.frames",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2186,
+    serialized_end=2293,
+)
+
+
+_NORMALIZEDBOUNDINGBOX = _descriptor.Descriptor(
+    name="NormalizedBoundingBox",
+    full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="left",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox.left",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox.top",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="right",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox.right",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bottom",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox.bottom",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2295,
+    serialized_end=2376,
+)
+
+
+_VIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="VideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment_label_annotations",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.segment_label_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_label_annotations",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.shot_label_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_label_annotations",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.frame_label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.shot_annotations",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_annotation",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.explicit_annotation",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.text_annotations",
+            index=6,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_annotations",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.object_annotations",
+            index=7,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults.error",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2379,
+    serialized_end=3094,
+)
+
+
+_ANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="AnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse.annotation_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3096,
+    serialized_end=3213,
+)
+
+
+_VIDEOANNOTATIONPROGRESS = _descriptor.Descriptor(
+    name="VideoAnnotationProgress",
+    full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress.progress_percent",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3216,
+    serialized_end=3383,
+)
+
+
+_ANNOTATEVIDEOPROGRESS = _descriptor.Descriptor(
+    name="AnnotateVideoProgress",
+    full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_progress",
+            full_name="google.cloud.videointelligence.v1p2beta1.AnnotateVideoProgress.annotation_progress",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3385,
+    serialized_end=3504,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.videointelligence.v1p2beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3506,
+    serialized_end=3546,
+)
+
+
+_NORMALIZEDBOUNDINGPOLY = _descriptor.Descriptor(
+    name="NormalizedBoundingPoly",
+    full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.videointelligence.v1p2beta1.NormalizedBoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3548,
+    serialized_end=3650,
+)
+
+
+_TEXTSEGMENT = _descriptor.Descriptor(
+    name="TextSegment",
+    full_name="google.cloud.videointelligence.v1p2beta1.TextSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextSegment.frames",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3653,
+    serialized_end=3828,
+)
+
+
+_TEXTFRAME = _descriptor.Descriptor(
+    name="TextFrame",
+    full_name="google.cloud.videointelligence.v1p2beta1.TextFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="rotated_bounding_box",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextFrame.rotated_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3831,
+    serialized_end=3986,
+)
+
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.videointelligence.v1p2beta1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextAnnotation.text",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p2beta1.TextAnnotation.segments",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3988,
+    serialized_end=4091,
+)
+
+
+_OBJECTTRACKINGFRAME = _descriptor.Descriptor(
+    name="ObjectTrackingFrame",
+    full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_box",
+            full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingFrame.normalized_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4094,
+    serialized_end=4261,
+)
+
+
+_OBJECTTRACKINGANNOTATION = _descriptor.Descriptor(
+    name="ObjectTrackingAnnotation",
+    full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation.confidence",
+            index=1,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation.frames",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation.segment",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4264,
+    serialized_end=4528,
+)
+
+_ANNOTATEVIDEOREQUEST.fields_by_name["features"].enum_type = _FEATURE
+_ANNOTATEVIDEOREQUEST.fields_by_name["video_context"].message_type = _VIDEOCONTEXT
+_VIDEOCONTEXT.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_VIDEOCONTEXT.fields_by_name[
+    "label_detection_config"
+].message_type = _LABELDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "shot_change_detection_config"
+].message_type = _SHOTCHANGEDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "explicit_content_detection_config"
+].message_type = _EXPLICITCONTENTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "text_detection_config"
+].message_type = _TEXTDETECTIONCONFIG
+_LABELDETECTIONCONFIG.fields_by_name[
+    "label_detection_mode"
+].enum_type = _LABELDETECTIONMODE
+_VIDEOSEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOSEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_LABELFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["category_entities"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["segments"].message_type = _LABELSEGMENT
+_LABELANNOTATION.fields_by_name["frames"].message_type = _LABELFRAME
+_EXPLICITCONTENTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_EXPLICITCONTENTFRAME.fields_by_name["pornography_likelihood"].enum_type = _LIKELIHOOD
+_EXPLICITCONTENTANNOTATION.fields_by_name["frames"].message_type = _EXPLICITCONTENTFRAME
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "segment_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "frame_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name["shot_annotations"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "explicit_annotation"
+].message_type = _EXPLICITCONTENTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "text_annotations"
+].message_type = _TEXTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "object_annotations"
+].message_type = _OBJECTTRACKINGANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _VIDEOANNOTATIONRESULTS
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ANNOTATEVIDEOPROGRESS.fields_by_name[
+    "annotation_progress"
+].message_type = _VIDEOANNOTATIONPROGRESS
+_NORMALIZEDBOUNDINGPOLY.fields_by_name["vertices"].message_type = _NORMALIZEDVERTEX
+_TEXTSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_TEXTSEGMENT.fields_by_name["frames"].message_type = _TEXTFRAME
+_TEXTFRAME.fields_by_name["rotated_bounding_box"].message_type = _NORMALIZEDBOUNDINGPOLY
+_TEXTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TEXTANNOTATION.fields_by_name["segments"].message_type = _TEXTSEGMENT
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "normalized_bounding_box"
+].message_type = _NORMALIZEDBOUNDINGBOX
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_OBJECTTRACKINGANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_OBJECTTRACKINGANNOTATION.fields_by_name["frames"].message_type = _OBJECTTRACKINGFRAME
+_OBJECTTRACKINGANNOTATION.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["AnnotateVideoRequest"] = _ANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["VideoContext"] = _VIDEOCONTEXT
+DESCRIPTOR.message_types_by_name["LabelDetectionConfig"] = _LABELDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ShotChangeDetectionConfig"
+] = _SHOTCHANGEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentDetectionConfig"
+] = _EXPLICITCONTENTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["TextDetectionConfig"] = _TEXTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["VideoSegment"] = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["LabelSegment"] = _LABELSEGMENT
+DESCRIPTOR.message_types_by_name["LabelFrame"] = _LABELFRAME
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["LabelAnnotation"] = _LABELANNOTATION
+DESCRIPTOR.message_types_by_name["ExplicitContentFrame"] = _EXPLICITCONTENTFRAME
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentAnnotation"
+] = _EXPLICITCONTENTANNOTATION
+DESCRIPTOR.message_types_by_name["NormalizedBoundingBox"] = _NORMALIZEDBOUNDINGBOX
+DESCRIPTOR.message_types_by_name["VideoAnnotationResults"] = _VIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["AnnotateVideoResponse"] = _ANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name["VideoAnnotationProgress"] = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoProgress"] = _ANNOTATEVIDEOPROGRESS
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["NormalizedBoundingPoly"] = _NORMALIZEDBOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["TextSegment"] = _TEXTSEGMENT
+DESCRIPTOR.message_types_by_name["TextFrame"] = _TEXTFRAME
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["ObjectTrackingFrame"] = _OBJECTTRACKINGFRAME
+DESCRIPTOR.message_types_by_name["ObjectTrackingAnnotation"] = _OBJECTTRACKINGANNOTATION
+DESCRIPTOR.enum_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.enum_types_by_name["LabelDetectionMode"] = _LABELDETECTIONMODE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation request.
+  
+  
+  Attributes:
+      input_uri:
+          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.
+      input_content:
+          The video data bytes. If unset, the input video(s) should be
+          specified via ``input_uri``. If set, ``input_uri`` should be
+          unset.
+      features:
+          Requested video annotation features.
+      video_context:
+          Additional video context and/or feature-specific parameters.
+      output_uri:
+          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>`__.
+      location_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.AnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoRequest)
+
+VideoContext = _reflection.GeneratedProtocolMessageType(
+    "VideoContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCONTEXT,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      segments:
+          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.
+      label_detection_config:
+          Config for LABEL\_DETECTION.
+      shot_change_detection_config:
+          Config for SHOT\_CHANGE\_DETECTION.
+      explicit_content_detection_config:
+          Config for EXPLICIT\_CONTENT\_DETECTION.
+      text_detection_config:
+          Config for TEXT\_DETECTION.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.VideoContext)
+    ),
+)
+_sym_db.RegisterMessage(VideoContext)
+
+LabelDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "LabelDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for LABEL\_DETECTION.
+  
+  
+  Attributes:
+      label_detection_mode:
+          What labels should be detected with LABEL\_DETECTION, in
+          addition to video-level labels or segment-level labels. If
+          unspecified, defaults to ``SHOT_MODE``.
+      stationary_camera:
+          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.
+      model:
+          Model to use for label detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.LabelDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(LabelDetectionConfig)
+
+ShotChangeDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ShotChangeDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SHOTCHANGEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for SHOT\_CHANGE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for shot change detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.ShotChangeDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ShotChangeDetectionConfig)
+
+ExplicitContentDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for EXPLICIT\_CONTENT\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for explicit content detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.ExplicitContentDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentDetectionConfig)
+
+TextDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "TextDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for TEXT\_DETECTION.
+  
+  
+  Attributes:
+      language_hints:
+          Language hint can be specified if the language to be detected
+          is known a priori. It can increase the accuracy of the
+          detection. Language hint must be language code in BCP-47
+          format.  Automatic language detection is performed if no hint
+          is provided.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.TextDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(TextDetectionConfig)
+
+VideoSegment = _reflection.GeneratedProtocolMessageType(
+    "VideoSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOSEGMENT,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment.
+  
+  
+  Attributes:
+      start_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the start of the segment (inclusive).
+      end_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the end of the segment (inclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.VideoSegment)
+    ),
+)
+_sym_db.RegisterMessage(VideoSegment)
+
+LabelSegment = _reflection.GeneratedProtocolMessageType(
+    "LabelSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELSEGMENT,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for label detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a label was detected.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.LabelSegment)
+    ),
+)
+_sym_db.RegisterMessage(LabelSegment)
+
+LabelFrame = _reflection.GeneratedProtocolMessageType(
+    "LabelFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELFRAME,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for label detection.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.LabelFrame)
+    ),
+)
+_sym_db.RegisterMessage(LabelFrame)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Detected entity from video analysis.
+  
+  
+  Attributes:
+      entity_id:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      description:
+          Textual description, e.g. ``Fixed-gear bicycle``.
+      language_code:
+          Language code for ``description`` in BCP-47 format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+
+LabelAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LabelAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELANNOTATION,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Label annotation.
+  
+  
+  Attributes:
+      entity:
+          Detected entity.
+      category_entities:
+          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``.
+      segments:
+          All video segments where a label was detected.
+      frames:
+          All video frames where a label was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.LabelAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LabelAnnotation)
+
+ExplicitContentFrame = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTFRAME,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for explicit content.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      pornography_likelihood:
+          Likelihood of the pornography content..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.ExplicitContentFrame)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentFrame)
+
+ExplicitContentAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTANNOTATION,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Explicit content annotation (based on per-frame visual signals only). If
+  no explicit content has been detected in a frame, no annotations are
+  present for that frame.
+  
+  
+  Attributes:
+      frames:
+          All video frames where explicit content was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.ExplicitContentAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentAnnotation)
+
+NormalizedBoundingBox = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingBox",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGBOX,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding box. The normalized vertex coordinates are relative
+  to the original image. Range: [0, 1].
+  
+  
+  Attributes:
+      left:
+          Left X coordinate.
+      top:
+          Top Y coordinate.
+      right:
+          Right X coordinate.
+      bottom:
+          Bottom Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.NormalizedBoundingBox)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingBox)
+
+VideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation results for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      segment_label_annotations:
+          Label annotations on video level or user specified segment
+          level. There is exactly one element for each unique label.
+      shot_label_annotations:
+          Label annotations on shot level. There is exactly one element
+          for each unique label.
+      frame_label_annotations:
+          Label annotations on frame level. There is exactly one element
+          for each unique label.
+      shot_annotations:
+          Shot annotations. Each shot is represented as a video segment.
+      explicit_annotation:
+          Explicit content annotation.
+      text_annotations:
+          OCR text detection and tracking. Annotations for list of
+          detected text snippets. Each will have list of frame
+          information associated with it.
+      object_annotations:
+          Annotations for list of objects detected and tracked in video.
+      error:
+          If set, indicates an error. Note that for a single
+          ``AnnotateVideoRequest`` some videos may succeed and some may
+          fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.VideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationResults)
+
+AnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation response. Included in the ``response`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_results:
+          Annotation results for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoResponse)
+
+VideoAnnotationProgress = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONPROGRESS,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation progress for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      progress_percent:
+          Approximate percentage processed thus far. Guaranteed to be
+          100 when fully processed.
+      start_time:
+          Time when the request was received.
+      update_time:
+          Time of the most recent update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.VideoAnnotationProgress)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationProgress)
+
+AnnotateVideoProgress = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOPROGRESS,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation progress. Included in the ``metadata`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_progress:
+          Progress metadata for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.AnnotateVideoProgress)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoProgress)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+NormalizedBoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGPOLY,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding polygon for text (that might not be aligned with
+  axis). Contains list of the corner points in clockwise order starting
+  from top-left corner. For example, for a rectangular bounding box: When
+  the text is horizontal it might look like: 0----1 \| \| 3----2
+  
+  When it's clockwise rotated 180 degrees around the top-left corner it
+  becomes: 2----3 \| \| 1----0
+  
+  and the vertex order will still be (0, 1, 2, 3). Note that values can be
+  less than 0, or greater than 1 due to trignometric calculations for
+  location of the box.
+  
+  
+  Attributes:
+      vertices:
+          Normalized vertices of the bounding polygon.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.NormalizedBoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingPoly)
+
+TextSegment = _reflection.GeneratedProtocolMessageType(
+    "TextSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSEGMENT,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for text detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a text snippet was detected.
+      confidence:
+          Confidence for the track of detected text. It is calculated as
+          the highest over all frames where OCR detected text appears.
+      frames:
+          Information related to the frames where OCR detected text
+          appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.TextSegment)
+    ),
+)
+_sym_db.RegisterMessage(TextSegment)
+
+TextFrame = _reflection.GeneratedProtocolMessageType(
+    "TextFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTFRAME,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for text annotation (OCR). Contains
+  information regarding timestamp and bounding box locations for the
+  frames containing detected OCR text snippets.
+  
+  
+  Attributes:
+      rotated_bounding_box:
+          Bounding polygon of the detected text for this frame.
+      time_offset:
+          Timestamp of this frame.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.TextFrame)
+    ),
+)
+_sym_db.RegisterMessage(TextFrame)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotations related to one detected OCR text snippet. This will contain
+  the corresponding text, confidence value, and frame level information
+  for each detection.
+  
+  
+  Attributes:
+      text:
+          The detected text.
+      segments:
+          All video segments where OCR detected text appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+
+ObjectTrackingFrame = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGFRAME,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotations for object detection and tracking. This
+  field stores per frame location, time offset, and confidence.
+  
+  
+  Attributes:
+      normalized_bounding_box:
+          The normalized bounding box location of this object track for
+          the frame.
+      time_offset:
+          The timestamp of the frame in microseconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.ObjectTrackingFrame)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingFrame)
+
+ObjectTrackingAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGANNOTATION,
+        __module__="google.cloud.videointelligence_v1p2beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotations corresponding to one tracked object.
+  
+  
+  Attributes:
+      entity:
+          Entity to specify the object category that this track is
+          labeled as.
+      confidence:
+          Object category's labeling confidence of this track.
+      frames:
+          Information corresponding to all frames where this object
+          track appears.
+      segment:
+          Each object track corresponds to one video segment where it
+          appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p2beta1.ObjectTrackingAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingAnnotation)
+
+
+DESCRIPTOR._options = None
+
+_VIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="VideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=4923,
+    serialized_end=5101,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnnotateVideo",
+            full_name="google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService.AnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_ANNOTATEVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p2beta1/videos:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_VIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name["VideoIntelligenceService"] = _VIDEOINTELLIGENCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence_pb2_grpc.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence_pb2_grpc.py
new file mode 100644
index 000000000000..72674da5e4ef
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/proto/video_intelligence_pb2_grpc.py
@@ -0,0 +1,56 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.videointelligence_v1p2beta1.proto import (
+    video_intelligence_pb2 as google_dot_cloud_dot_videointelligence__v1p2beta1_dot_proto_dot_video__intelligence__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class VideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnnotateVideo = channel.unary_unary(
+            "/google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService/AnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1p2beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class VideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def AnnotateVideo(self, request, context):
+        """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).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_VideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnnotateVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1p2beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/videointelligence/google/cloud/videointelligence_v1p2beta1/types.py b/videointelligence/google/cloud/videointelligence_v1p2beta1/types.py
new file mode 100644
index 000000000000..0b70adb8a73f
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p2beta1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.videointelligence_v1p2beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [video_intelligence_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.videointelligence_v1p2beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/__init__.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/__init__.py
new file mode 100644
index 000000000000..fd8f0071f62a
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/__init__.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.videointelligence_v1p3beta1 import types
+from google.cloud.videointelligence_v1p3beta1.gapic import enums
+from google.cloud.videointelligence_v1p3beta1.gapic import (
+    streaming_video_intelligence_service_client,
+)
+from google.cloud.videointelligence_v1p3beta1.gapic import (
+    video_intelligence_service_client,
+)
+
+
+class VideoIntelligenceServiceClient(
+    video_intelligence_service_client.VideoIntelligenceServiceClient
+):
+    __doc__ = video_intelligence_service_client.VideoIntelligenceServiceClient.__doc__
+    enums = enums
+
+
+class StreamingVideoIntelligenceServiceClient(
+    streaming_video_intelligence_service_client.StreamingVideoIntelligenceServiceClient
+):
+    __doc__ = (
+        streaming_video_intelligence_service_client.StreamingVideoIntelligenceServiceClient.__doc__
+    )
+    enums = enums
+
+
+__all__ = (
+    "enums",
+    "types",
+    "VideoIntelligenceServiceClient",
+    "StreamingVideoIntelligenceServiceClient",
+)
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/__init__.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/enums.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/enums.py
new file mode 100644
index 000000000000..a78df64dbbc3
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/enums.py
@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Feature(enum.IntEnum):
+    """
+    Video annotation feature.
+
+    Attributes:
+      FEATURE_UNSPECIFIED (int): Unspecified.
+      LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      SHOT_CHANGE_DETECTION (int): Shot change detection.
+      EXPLICIT_CONTENT_DETECTION (int): Explicit content detection.
+      SPEECH_TRANSCRIPTION (int): Speech transcription.
+      TEXT_DETECTION (int): OCR text detection and tracking.
+      OBJECT_TRACKING (int): Object detection and tracking.
+      LOGO_RECOGNITION (int): Logo detection, tracking, and recognition.
+    """
+
+    FEATURE_UNSPECIFIED = 0
+    LABEL_DETECTION = 1
+    SHOT_CHANGE_DETECTION = 2
+    EXPLICIT_CONTENT_DETECTION = 3
+    SPEECH_TRANSCRIPTION = 6
+    TEXT_DETECTION = 7
+    OBJECT_TRACKING = 9
+    LOGO_RECOGNITION = 12
+
+
+class LabelDetectionMode(enum.IntEnum):
+    """
+    Label detection mode.
+
+    Attributes:
+      LABEL_DETECTION_MODE_UNSPECIFIED (int): Unspecified.
+      SHOT_MODE (int): Detect shot-level labels.
+      FRAME_MODE (int): Detect frame-level labels.
+      SHOT_AND_FRAME_MODE (int): Detect both shot-level and frame-level labels.
+    """
+
+    LABEL_DETECTION_MODE_UNSPECIFIED = 0
+    SHOT_MODE = 1
+    FRAME_MODE = 2
+    SHOT_AND_FRAME_MODE = 3
+
+
+class Likelihood(enum.IntEnum):
+    """
+    Bucketized representation of likelihood.
+
+    Attributes:
+      LIKELIHOOD_UNSPECIFIED (int): Unspecified likelihood.
+      VERY_UNLIKELY (int): Very unlikely.
+      UNLIKELY (int): Unlikely.
+      POSSIBLE (int): Possible.
+      LIKELY (int): Likely.
+      VERY_LIKELY (int): Very likely.
+    """
+
+    LIKELIHOOD_UNSPECIFIED = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class StreamingFeature(enum.IntEnum):
+    """
+    Streaming video annotation feature.
+
+    Attributes:
+      STREAMING_FEATURE_UNSPECIFIED (int): Unspecified.
+      STREAMING_LABEL_DETECTION (int): Label detection. Detect objects, such as dog or flower.
+      STREAMING_SHOT_CHANGE_DETECTION (int): Shot change detection.
+      STREAMING_EXPLICIT_CONTENT_DETECTION (int): Explicit content detection.
+      STREAMING_OBJECT_TRACKING (int): Object detection and tracking.
+      STREAMING_AUTOML_CLASSIFICATION (int): Video classification based on AutoML model.
+      STREAMING_AUTOML_OBJECT_TRACKING (int): Object detection and tracking based on AutoML model.
+    """
+
+    STREAMING_FEATURE_UNSPECIFIED = 0
+    STREAMING_LABEL_DETECTION = 1
+    STREAMING_SHOT_CHANGE_DETECTION = 2
+    STREAMING_EXPLICIT_CONTENT_DETECTION = 3
+    STREAMING_OBJECT_TRACKING = 4
+    STREAMING_AUTOML_CLASSIFICATION = 21
+    STREAMING_AUTOML_OBJECT_TRACKING = 22
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/streaming_video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/streaming_video_intelligence_service_client.py
new file mode 100644
index 000000000000..2414631f29bd
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/streaming_video_intelligence_service_client.py
@@ -0,0 +1,254 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1p3beta1 StreamingVideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.videointelligence_v1p3beta1.gapic import enums
+from google.cloud.videointelligence_v1p3beta1.gapic import (
+    streaming_video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1p3beta1.gapic.transports import (
+    streaming_video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class StreamingVideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence Streaming API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = (
+        "google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService"
+    )
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            StreamingVideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.StreamingVideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.StreamingVideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = streaming_video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=streaming_video_intelligence_service_grpc_transport.StreamingVideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = streaming_video_intelligence_service_grpc_transport.StreamingVideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def streaming_annotate_video(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Performs video annotation with bidirectional streaming: emitting results
+        while sending video/audio bytes.
+        This method is only available via the gRPC API (not REST).
+
+        EXPERIMENTAL: This method interface might change in the future.
+
+        Example:
+            >>> from google.cloud import videointelligence_v1p3beta1
+            >>>
+            >>> client = videointelligence_v1p3beta1.StreamingVideoIntelligenceServiceClient()
+            >>>
+            >>> request = {}
+            >>>
+            >>> requests = [request]
+            >>> for element in client.streaming_annotate_video(requests):
+            ...     # process element
+            ...     pass
+
+        Args:
+            requests (iterator[dict|google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2.StreamingAnnotateVideoRequest]): The input objects. If a dict is provided, it must be of the
+                same form as the protobuf message :class:`~google.cloud.videointelligence_v1p3beta1.types.StreamingAnnotateVideoRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            Iterable[~google.cloud.videointelligence_v1p3beta1.types.StreamingAnnotateVideoResponse].
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "streaming_annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "streaming_annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.streaming_annotate_video,
+                default_retry=self._method_configs["StreamingAnnotateVideo"].retry,
+                default_timeout=self._method_configs["StreamingAnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        return self._inner_api_calls["streaming_annotate_video"](
+            requests, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/streaming_video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/streaming_video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..53bb98727164
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/streaming_video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 10800000,
+                    "total_timeout_millis": 10800000,
+                }
+            },
+            "methods": {
+                "StreamingAnnotateVideo": {
+                    "timeout_millis": 10800000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/__init__.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/streaming_video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/streaming_video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..d51a8f145472
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/streaming_video_intelligence_service_grpc_transport.py
@@ -0,0 +1,130 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2_grpc
+
+
+class StreamingVideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1p3beta1 StreamingVideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "streaming_video_intelligence_service_stub": video_intelligence_pb2_grpc.StreamingVideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def streaming_annotate_video(self):
+        """Return the gRPC stub for :meth:`StreamingVideoIntelligenceServiceClient.streaming_annotate_video`.
+
+        Performs video annotation with bidirectional streaming: emitting results
+        while sending video/audio bytes.
+        This method is only available via the gRPC API (not REST).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs[
+            "streaming_video_intelligence_service_stub"
+        ].StreamingAnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/video_intelligence_service_grpc_transport.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/video_intelligence_service_grpc_transport.py
new file mode 100644
index 000000000000..ecd2f03c054b
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/transports/video_intelligence_service_grpc_transport.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+import google.api_core.operations_v1
+
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2_grpc
+
+
+class VideoIntelligenceServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.videointelligence.v1p3beta1 VideoIntelligenceService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="videointelligence.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "video_intelligence_service_stub": video_intelligence_pb2_grpc.VideoIntelligenceServiceStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="videointelligence.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def annotate_video(self):
+        """Return the gRPC stub for :meth:`VideoIntelligenceServiceClient.annotate_video`.
+
+        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).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["video_intelligence_service_stub"].AnnotateVideo
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/video_intelligence_service_client.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/video_intelligence_service_client.py
new file mode 100644
index 000000000000..786984ce04da
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/video_intelligence_service_client.py
@@ -0,0 +1,308 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.videointelligence.v1p3beta1 VideoIntelligenceService API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+import google.api_core.operations_v1
+import grpc
+
+from google.cloud.videointelligence_v1p3beta1.gapic import enums
+from google.cloud.videointelligence_v1p3beta1.gapic import (
+    video_intelligence_service_client_config,
+)
+from google.cloud.videointelligence_v1p3beta1.gapic.transports import (
+    video_intelligence_service_grpc_transport,
+)
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-videointelligence"
+).version
+
+
+class VideoIntelligenceServiceClient(object):
+    """Service that implements Google Cloud Video Intelligence API."""
+
+    SERVICE_ADDRESS = "videointelligence.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = (
+        "google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService"
+    )
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            VideoIntelligenceServiceClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.VideoIntelligenceServiceGrpcTransport,
+                    Callable[[~.Credentials, type], ~.VideoIntelligenceServiceGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = video_intelligence_service_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = video_intelligence_service_grpc_transport.VideoIntelligenceServiceGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def annotate_video(
+        self,
+        input_uri=None,
+        input_content=None,
+        features=None,
+        video_context=None,
+        output_uri=None,
+        location_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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).
+
+        Example:
+            >>> from google.cloud import videointelligence_v1p3beta1
+            >>> from google.cloud.videointelligence_v1p3beta1 import enums
+            >>>
+            >>> client = videointelligence_v1p3beta1.VideoIntelligenceServiceClient()
+            >>>
+            >>> input_uri = 'gs://cloud-samples-data/video/cat.mp4'
+            >>> features_element = enums.Feature.LABEL_DETECTION
+            >>> features = [features_element]
+            >>>
+            >>> response = client.annotate_video(input_uri=input_uri, features=features)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            input_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/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.
+            input_content (bytes): The video data bytes. If unset, the input video(s) should be specified
+                via ``input_uri``. If set, ``input_uri`` should be unset.
+            features (list[~google.cloud.videointelligence_v1p3beta1.types.Feature]): Requested video annotation features.
+            video_context (Union[dict, ~google.cloud.videointelligence_v1p3beta1.types.VideoContext]): Additional video context and/or feature-specific parameters.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.videointelligence_v1p3beta1.types.VideoContext`
+            output_uri (str): 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``). For
+                more information, see `Request
+                URIs <https://cloud.google.com/storage/docs/reference-uris>`__.
+            location_id (str): 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.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.videointelligence_v1p3beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "annotate_video" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "annotate_video"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.annotate_video,
+                default_retry=self._method_configs["AnnotateVideo"].retry,
+                default_timeout=self._method_configs["AnnotateVideo"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri,
+            input_content=input_content,
+            features=features,
+            video_context=video_context,
+            output_uri=output_uri,
+            location_id=location_id,
+        )
+        operation = self._inner_api_calls["annotate_video"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            video_intelligence_pb2.AnnotateVideoResponse,
+            metadata_type=video_intelligence_pb2.AnnotateVideoProgress,
+        )
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/video_intelligence_service_client_config.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/video_intelligence_service_client_config.py
new file mode 100644
index 000000000000..c15923a1f64e
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/gapic/video_intelligence_service_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 120000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "AnnotateVideo": {
+                    "timeout_millis": 600000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/__init__.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence.proto b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence.proto
new file mode 100644
index 000000000000..e37726e0b1aa
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence.proto
@@ -0,0 +1,897 @@
+// 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.cloud.videointelligence.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+
+option csharp_namespace = "Google.Cloud.VideoIntelligence.V1P3Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1p3beta1;videointelligence";
+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 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: "/v1p3beta1/videos:annotate"
+      body: "*"
+    };
+  }
+}
+
+// Service that implements Google Cloud Video Intelligence Streaming API.
+service StreamingVideoIntelligenceService {
+  // 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);
+}
+
+// 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.
+  // If unset, the input video(s) should be specified via `input_uri`.
+  // If set, `input_uri` should be unset.
+  bytes 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;
+
+  // Config for LABEL_DETECTION.
+  LabelDetectionConfig label_detection_config = 2;
+
+  // Config for SHOT_CHANGE_DETECTION.
+  ShotChangeDetectionConfig shot_change_detection_config = 3;
+
+  // Config for EXPLICIT_CONTENT_DETECTION.
+  ExplicitContentDetectionConfig explicit_content_detection_config = 4;
+
+  // Config for SPEECH_TRANSCRIPTION.
+  SpeechTranscriptionConfig speech_transcription_config = 6;
+
+  // Config for TEXT_DETECTION.
+  TextDetectionConfig text_detection_config = 8;
+
+  // Config for OBJECT_TRACKING.
+  ObjectTrackingConfig object_tracking_config = 13;
+}
+
+// Config for LABEL_DETECTION.
+message LabelDetectionConfig {
+  // What labels should be detected with LABEL_DETECTION, in addition to
+  // video-level labels or segment-level labels.
+  // 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.
+  bool stationary_camera = 2;
+
+  // Model to use for label detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+
+  // The confidence threshold we perform filtering on the labels from
+  // 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
+  // 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
+  // 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
+  // the default threshold everytime when we release a new model.
+  float video_confidence_threshold = 5;
+}
+
+// Config for SHOT_CHANGE_DETECTION.
+message ShotChangeDetectionConfig {
+  // Model to use for shot change detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 1;
+}
+
+// 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;
+}
+
+// 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;
+}
+
+// Config for TEXT_DETECTION.
+message TextDetectionConfig {
+  // Language hint can be specified if the language to be detected is known a
+  // priori. It can increase the accuracy of the detection. Language hint must
+  // be language code in BCP-47 format.
+  //
+  // Automatic language detection is performed if no hint is provided.
+  repeated string language_hints = 1;
+
+  // Model to use for text detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 2;
+}
+
+// Video segment.
+message VideoSegment {
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the start of the segment (inclusive).
+  google.protobuf.Duration start_time_offset = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the end of the segment (inclusive).
+  google.protobuf.Duration end_time_offset = 2;
+}
+
+// Video segment level annotation results for label detection.
+message LabelSegment {
+  // Video segment where a label was detected.
+  VideoSegment segment = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Video frame level annotation results for label detection.
+message LabelFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Confidence that the label is accurate. Range: [0, 1].
+  float confidence = 2;
+}
+
+// Detected entity from video analysis.
+message Entity {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string entity_id = 1;
+
+  // Textual description, e.g. `Fixed-gear bicycle`.
+  string description = 2;
+
+  // Language code for `description` in BCP-47 format.
+  string language_code = 3;
+}
+
+// Label annotation.
+message LabelAnnotation {
+  // Detected entity.
+  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`.
+  repeated Entity category_entities = 2;
+
+  // All video segments where a label was detected.
+  repeated LabelSegment segments = 3;
+
+  // All video frames where a label was detected.
+  repeated LabelFrame frames = 4;
+}
+
+// Video frame level annotation results for explicit content.
+message ExplicitContentFrame {
+  // Time-offset, relative to the beginning of the video, corresponding to the
+  // video frame for this location.
+  google.protobuf.Duration time_offset = 1;
+
+  // Likelihood of the pornography content..
+  Likelihood pornography_likelihood = 2;
+}
+
+// Explicit content annotation (based on per-frame visual signals only).
+// If no explicit content has been detected in a frame, no annotations are
+// present for that frame.
+message ExplicitContentAnnotation {
+  // All video frames where explicit content was detected.
+  repeated ExplicitContentFrame frames = 1;
+}
+
+// Normalized bounding box.
+// The normalized vertex coordinates are relative to the original image.
+// Range: [0, 1].
+message NormalizedBoundingBox {
+  // Left X coordinate.
+  float left = 1;
+
+  // Top Y coordinate.
+  float top = 2;
+
+  // Right X coordinate.
+  float right = 3;
+
+  // Bottom Y coordinate.
+  float bottom = 4;
+}
+
+// For tracking related features, such as LOGO_RECOGNITION, FACE_DETECTION,
+// CELEBRITY_RECOGNITION, PERSON_DETECTION.
+// 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;
+}
+
+// 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;
+
+  // Optional. The confidence score of the tracked object.
+  float confidence = 4;
+}
+
+// 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;
+}
+
+// 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.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation segment_label_annotations = 2;
+
+  // Label annotations on shot level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation shot_label_annotations = 3;
+
+  // Label annotations on frame level.
+  // There is exactly one element for each unique label.
+  repeated LabelAnnotation frame_label_annotations = 4;
+
+  // Shot annotations. Each shot is represented as a video segment.
+  repeated VideoSegment shot_annotations = 6;
+
+  // Explicit content annotation.
+  ExplicitContentAnnotation explicit_annotation = 7;
+
+  // Speech transcription.
+  repeated SpeechTranscription speech_transcriptions = 11;
+
+  // OCR text detection and tracking.
+  // Annotations for list of detected text snippets. Each will have list of
+  // frame information associated with it.
+  repeated TextAnnotation text_annotations = 12;
+
+  // 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;
+}
+
+// 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;
+}
+
+// Config for SPEECH_TRANSCRIPTION.
+message SpeechTranscriptionConfig {
+  // *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;
+
+  // *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;
+
+  // *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;
+
+  // *Optional* A means to provide context to assist the speech recognition.
+  repeated SpeechContext speech_contexts = 4;
+
+  // *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;
+
+  // *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;
+
+  // *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;
+
+  // *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 `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;
+}
+
+// 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
+  // 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;
+}
+
+// A speech recognition result corresponding to a portion of the audio.
+message SpeechTranscription {
+  // 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. 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;
+}
+
+// Alternative hypotheses (a.k.a. n-best list).
+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
+  // 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.
+  // The default of 0.0 is a sentinel value indicating `confidence` was not set.
+  float confidence = 2;
+
+  // A list of word-specific information for each recognized word.
+  repeated WordInfo words = 3;
+}
+
+// Word-specific information for recognized words. Word information is only
+// included in the response when certain request parameters are set, such
+// as `enable_word_time_offsets`.
+message WordInfo {
+  // 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. This is an
+  // experimental feature and the accuracy of the time offset can vary.
+  google.protobuf.Duration start_time = 1;
+
+  // 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. This is an
+  // experimental feature and the accuracy of the time offset can vary.
+  google.protobuf.Duration end_time = 2;
+
+  // 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
+  // indicates an estimated greater likelihood that the recognized words are
+  // 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 = 4;
+
+  // 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;
+}
+
+// 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;
+}
+
+// Normalized bounding polygon for text (that might not be aligned with axis).
+// Contains list of the corner points in clockwise order starting from
+// top-left corner. For example, for a rectangular bounding box:
+// When the text is horizontal it might look like:
+//         0----1
+//         |    |
+//         3----2
+//
+// When it's clockwise rotated 180 degrees around the top-left corner it
+// becomes:
+//         2----3
+//         |    |
+//         1----0
+//
+// and the vertex order will still be (0, 1, 2, 3). Note that values can be less
+// than 0, or greater than 1 due to trignometric calculations for location of
+// the box.
+message NormalizedBoundingPoly {
+  // Normalized vertices of the bounding polygon.
+  repeated NormalizedVertex vertices = 1;
+}
+
+// Video segment level annotation results for text detection.
+message TextSegment {
+  // Video segment where a text snippet was detected.
+  VideoSegment segment = 1;
+
+  // Confidence for the track of detected text. It is calculated as the highest
+  // over all frames where OCR detected text appears.
+  float confidence = 2;
+
+  // Information related to the frames where OCR detected text appears.
+  repeated TextFrame frames = 3;
+}
+
+// Video frame level annotation results for text annotation (OCR).
+// Contains information regarding timestamp and bounding box locations for the
+// frames containing detected OCR text snippets.
+message TextFrame {
+  // Bounding polygon of the detected text for this frame.
+  NormalizedBoundingPoly rotated_bounding_box = 1;
+
+  // Timestamp of this frame.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// Annotations related to one detected OCR text snippet. This will contain the
+// corresponding text, confidence value, and frame level information for each
+// detection.
+message TextAnnotation {
+  // The detected text.
+  string text = 1;
+
+  // All video segments where OCR detected text appears.
+  repeated TextSegment segments = 2;
+}
+
+// Video frame level annotations for object detection and tracking. This field
+// stores per frame location, time offset, and confidence.
+message ObjectTrackingFrame {
+  // The normalized bounding box location of this object track for the frame.
+  NormalizedBoundingBox normalized_bounding_box = 1;
+
+  // The timestamp of the frame in microseconds.
+  google.protobuf.Duration time_offset = 2;
+}
+
+// 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.
+    // Instead, we provide a unique identifiable integer track_id so that
+    // the customers can correlate the results of the ongoing
+    // ObjectTrackAnnotation of the same track_id over time.
+    int64 track_id = 5;
+  }
+}
+
+// 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;
+
+  // All logo tracks where the recognized logo appears. Each track corresponds
+  // to one logo instance appearing in consecutive frames.
+  repeated Track tracks = 2;
+
+  // 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;
+}
+
+// The top-level message sent by the client for the `StreamingAnnotateVideo`
+// method. Multiple `StreamingAnnotateVideoRequest` messages are sent.
+// The first message must only contain a `StreamingVideoConfig` message.
+// All subsequent messages must only contain `input_content` data.
+message StreamingAnnotateVideoRequest {
+  // *Required* The streaming request, which is either a streaming config or
+  // video content.
+  oneof streaming_request {
+    // Provides information to the annotator, specifing how to process the
+    // request. The first `AnnotateStreamingVideoRequest` message must only
+    // contain a `video_config` message.
+    StreamingVideoConfig video_config = 1;
+
+    // The video data to be annotated. Chunks of video data are sequentially
+    // sent in `StreamingAnnotateVideoRequest` messages. Except the initial
+    // `StreamingAnnotateVideoRequest` message containing only
+    // `video_config`, all subsequent `AnnotateStreamingVideoRequest`
+    // messages must only contain `input_content` field.
+    // Note: as with all bytes fields, protobuffers use a pure binary
+    // representation (not base64).
+    bytes input_content = 2;
+  }
+}
+
+// `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.
+    StreamingShotChangeDetectionConfig shot_change_detection_config = 2;
+
+    // Config for STREAMING_LABEL_DETECTION.
+    StreamingLabelDetectionConfig label_detection_config = 3;
+
+    // Config for STREAMING_EXPLICIT_CONTENT_DETECTION.
+    StreamingExplicitContentDetectionConfig explicit_content_detection_config =
+        4;
+
+    // Config for STREAMING_OBJECT_TRACKING.
+    StreamingObjectTrackingConfig object_tracking_config = 5;
+
+    // Config for STREAMING_AUTOML_CLASSIFICATION.
+    StreamingAutomlClassificationConfig automl_classification_config = 21;
+
+    // Config for STREAMING_AUTOML_OBJECT_TRACKING.
+    StreamingAutomlObjectTrackingConfig automl_object_tracking_config = 22;
+  }
+
+  // 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;
+
+  // Shot change detection.
+  SHOT_CHANGE_DETECTION = 2;
+
+  // Explicit content detection.
+  EXPLICIT_CONTENT_DETECTION = 3;
+
+  // 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;
+}
+
+// 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;
+}
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence_pb2.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence_pb2.py
new file mode 100644
index 000000000000..517845e5a7c9
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence_pb2.py
@@ -0,0 +1,5249 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/videointelligence_v1p3beta1/proto/video_intelligence.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/videointelligence_v1p3beta1/proto/video_intelligence.proto",
+    package="google.cloud.videointelligence.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n,com.google.cloud.videointelligence.v1p3beta1B\035VideoIntelligenceServiceProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1p3beta1;videointelligence\252\002(Google.Cloud.VideoIntelligence.V1P3Beta1\312\002(Google\\Cloud\\VideoIntelligence\\V1p3beta1\352\002+Google::Cloud::VideoIntelligence::V1p3beta1"
+    ),
+    serialized_pb=_b(
+        '\nGgoogle/cloud/videointelligence_v1p3beta1/proto/video_intelligence.proto\x12(google.cloud.videointelligence.v1p3beta1\x1a\x1cgoogle/api/annotations.proto\x1a#google/longrunning/operations.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xfd\x01\n\x14\x41nnotateVideoRequest\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x15\n\rinput_content\x18\x06 \x01(\x0c\x12\x43\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0e\x32\x31.google.cloud.videointelligence.v1p3beta1.Feature\x12M\n\rvideo_context\x18\x03 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoContext\x12\x12\n\noutput_uri\x18\x04 \x01(\t\x12\x13\n\x0blocation_id\x18\x05 \x01(\t"\xc0\x05\n\x0cVideoContext\x12H\n\x08segments\x18\x01 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment\x12^\n\x16label_detection_config\x18\x02 \x01(\x0b\x32>.google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig\x12i\n\x1cshot_change_detection_config\x18\x03 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p3beta1.ShotChangeDetectionConfig\x12s\n!explicit_content_detection_config\x18\x04 \x01(\x0b\x32H.google.cloud.videointelligence.v1p3beta1.ExplicitContentDetectionConfig\x12h\n\x1bspeech_transcription_config\x18\x06 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig\x12\\\n\x15text_detection_config\x18\x08 \x01(\x0b\x32=.google.cloud.videointelligence.v1p3beta1.TextDetectionConfig\x12^\n\x16object_tracking_config\x18\r \x01(\x0b\x32>.google.cloud.videointelligence.v1p3beta1.ObjectTrackingConfig"\xe4\x01\n\x14LabelDetectionConfig\x12Z\n\x14label_detection_mode\x18\x01 \x01(\x0e\x32<.google.cloud.videointelligence.v1p3beta1.LabelDetectionMode\x12\x19\n\x11stationary_camera\x18\x02 \x01(\x08\x12\r\n\x05model\x18\x03 \x01(\t\x12"\n\x1a\x66rame_confidence_threshold\x18\x04 \x01(\x02\x12"\n\x1avideo_confidence_threshold\x18\x05 \x01(\x02"*\n\x19ShotChangeDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"%\n\x14ObjectTrackingConfig\x12\r\n\x05model\x18\x01 \x01(\t"/\n\x1e\x45xplicitContentDetectionConfig\x12\r\n\x05model\x18\x01 \x01(\t"<\n\x13TextDetectionConfig\x12\x16\n\x0elanguage_hints\x18\x01 \x03(\t\x12\r\n\x05model\x18\x02 \x01(\t"x\n\x0cVideoSegment\x12\x34\n\x11start_time_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x32\n\x0f\x65nd_time_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"k\n\x0cLabelSegment\x12G\n\x07segment\x18\x01 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02"P\n\nLabelFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x12\n\nconfidence\x18\x02 \x01(\x02"G\n\x06\x45ntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x15\n\rlanguage_code\x18\x03 \x01(\t"\xb0\x02\n\x0fLabelAnnotation\x12@\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x30.google.cloud.videointelligence.v1p3beta1.Entity\x12K\n\x11\x63\x61tegory_entities\x18\x02 \x03(\x0b\x32\x30.google.cloud.videointelligence.v1p3beta1.Entity\x12H\n\x08segments\x18\x03 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.LabelSegment\x12\x44\n\x06\x66rames\x18\x04 \x03(\x0b\x32\x34.google.cloud.videointelligence.v1p3beta1.LabelFrame"\x9c\x01\n\x14\x45xplicitContentFrame\x12.\n\x0btime_offset\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12T\n\x16pornography_likelihood\x18\x02 \x01(\x0e\x32\x34.google.cloud.videointelligence.v1p3beta1.Likelihood"k\n\x19\x45xplicitContentAnnotation\x12N\n\x06\x66rames\x18\x01 \x03(\x0b\x32>.google.cloud.videointelligence.v1p3beta1.ExplicitContentFrame"Q\n\x15NormalizedBoundingBox\x12\x0c\n\x04left\x18\x01 \x01(\x02\x12\x0b\n\x03top\x18\x02 \x01(\x02\x12\r\n\x05right\x18\x03 \x01(\x02\x12\x0e\n\x06\x62ottom\x18\x04 \x01(\x02"\xf6\x01\n\x11TimestampedObject\x12`\n\x17normalized_bounding_box\x18\x01 \x01(\x0b\x32?.google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12O\n\nattributes\x18\x03 \x03(\x0b\x32;.google.cloud.videointelligence.v1p3beta1.DetectedAttribute"\x8f\x02\n\x05Track\x12G\n\x07segment\x18\x01 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment\x12X\n\x13timestamped_objects\x18\x02 \x03(\x0b\x32;.google.cloud.videointelligence.v1p3beta1.TimestampedObject\x12O\n\nattributes\x18\x03 \x03(\x0b\x32;.google.cloud.videointelligence.v1p3beta1.DetectedAttribute\x12\x12\n\nconfidence\x18\x04 \x01(\x02"D\n\x11\x44\x65tectedAttribute\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\r\n\x05value\x18\x03 \x01(\t"\x94\x07\n\x16VideoAnnotationResults\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\\\n\x19segment_label_annotations\x18\x02 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p3beta1.LabelAnnotation\x12Y\n\x16shot_label_annotations\x18\x03 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p3beta1.LabelAnnotation\x12Z\n\x17\x66rame_label_annotations\x18\x04 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p3beta1.LabelAnnotation\x12P\n\x10shot_annotations\x18\x06 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment\x12`\n\x13\x65xplicit_annotation\x18\x07 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p3beta1.ExplicitContentAnnotation\x12\\\n\x15speech_transcriptions\x18\x0b \x03(\x0b\x32=.google.cloud.videointelligence.v1p3beta1.SpeechTranscription\x12R\n\x10text_annotations\x18\x0c \x03(\x0b\x32\x38.google.cloud.videointelligence.v1p3beta1.TextAnnotation\x12^\n\x12object_annotations\x18\x0e \x03(\x0b\x32\x42.google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation\x12i\n\x1clogo_recognition_annotations\x18\x13 \x03(\x0b\x32\x43.google.cloud.videointelligence.v1p3beta1.LogoRecognitionAnnotation\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status"u\n\x15\x41nnotateVideoResponse\x12\\\n\x12\x61nnotation_results\x18\x01 \x03(\x0b\x32@.google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults"\xa7\x01\n\x17VideoAnnotationProgress\x12\x11\n\tinput_uri\x18\x01 \x01(\t\x12\x18\n\x10progress_percent\x18\x02 \x01(\x05\x12.\n\nstart_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"w\n\x15\x41nnotateVideoProgress\x12^\n\x13\x61nnotation_progress\x18\x01 \x03(\x0b\x32\x41.google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress"\xdb\x02\n\x19SpeechTranscriptionConfig\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x18\n\x10max_alternatives\x18\x02 \x01(\x05\x12\x18\n\x10\x66ilter_profanity\x18\x03 \x01(\x08\x12P\n\x0fspeech_contexts\x18\x04 \x03(\x0b\x32\x37.google.cloud.videointelligence.v1p3beta1.SpeechContext\x12$\n\x1c\x65nable_automatic_punctuation\x18\x05 \x01(\x08\x12\x14\n\x0c\x61udio_tracks\x18\x06 \x03(\x05\x12"\n\x1a\x65nable_speaker_diarization\x18\x07 \x01(\x08\x12!\n\x19\x64iarization_speaker_count\x18\x08 \x01(\x05\x12\x1e\n\x16\x65nable_word_confidence\x18\t \x01(\x08" \n\rSpeechContext\x12\x0f\n\x07phrases\x18\x01 \x03(\t"\x8a\x01\n\x13SpeechTranscription\x12\\\n\x0c\x61lternatives\x18\x01 \x03(\x0b\x32\x46.google.cloud.videointelligence.v1p3beta1.SpeechRecognitionAlternative\x12\x15\n\rlanguage_code\x18\x02 \x01(\t"\x89\x01\n\x1cSpeechRecognitionAlternative\x12\x12\n\ntranscript\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x41\n\x05words\x18\x03 \x03(\x0b\x32\x32.google.cloud.videointelligence.v1p3beta1.WordInfo"\x9d\x01\n\x08WordInfo\x12-\n\nstart_time\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12+\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x0c\n\x04word\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x12\x13\n\x0bspeaker_tag\x18\x05 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"f\n\x16NormalizedBoundingPoly\x12L\n\x08vertices\x18\x01 \x03(\x0b\x32:.google.cloud.videointelligence.v1p3beta1.NormalizedVertex"\xaf\x01\n\x0bTextSegment\x12G\n\x07segment\x18\x01 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x43\n\x06\x66rames\x18\x03 \x03(\x0b\x32\x33.google.cloud.videointelligence.v1p3beta1.TextFrame"\x9b\x01\n\tTextFrame\x12^\n\x14rotated_bounding_box\x18\x01 \x01(\x0b\x32@.google.cloud.videointelligence.v1p3beta1.NormalizedBoundingPoly\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"g\n\x0eTextAnnotation\x12\x0c\n\x04text\x18\x01 \x01(\t\x12G\n\x08segments\x18\x02 \x03(\x0b\x32\x35.google.cloud.videointelligence.v1p3beta1.TextSegment"\xa7\x01\n\x13ObjectTrackingFrame\x12`\n\x17normalized_bounding_box\x18\x01 \x01(\x0b\x32?.google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox\x12.\n\x0btime_offset\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration"\xac\x02\n\x18ObjectTrackingAnnotation\x12@\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x30.google.cloud.videointelligence.v1p3beta1.Entity\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x12M\n\x06\x66rames\x18\x02 \x03(\x0b\x32=.google.cloud.videointelligence.v1p3beta1.ObjectTrackingFrame\x12I\n\x07segment\x18\x03 \x01(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegmentH\x00\x12\x12\n\x08track_id\x18\x05 \x01(\x03H\x00\x42\x0c\n\ntrack_info"\xe8\x01\n\x19LogoRecognitionAnnotation\x12@\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x30.google.cloud.videointelligence.v1p3beta1.Entity\x12?\n\x06tracks\x18\x02 \x03(\x0b\x32/.google.cloud.videointelligence.v1p3beta1.Track\x12H\n\x08segments\x18\x03 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment"\xa5\x01\n\x1dStreamingAnnotateVideoRequest\x12V\n\x0cvideo_config\x18\x01 \x01(\x0b\x32>.google.cloud.videointelligence.v1p3beta1.StreamingVideoConfigH\x00\x12\x17\n\rinput_content\x18\x02 \x01(\x0cH\x00\x42\x13\n\x11streaming_request"\xca\x01\n\x1eStreamingAnnotateVideoResponse\x12!\n\x05\x65rror\x18\x01 \x01(\x0b\x32\x12.google.rpc.Status\x12\x65\n\x12\x61nnotation_results\x18\x02 \x01(\x0b\x32I.google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults\x12\x1e\n\x16\x61nnotation_results_uri\x18\x03 \x01(\t"9\n#StreamingAutomlClassificationConfig\x12\x12\n\nmodel_name\x18\x01 \x01(\t"9\n#StreamingAutomlObjectTrackingConfig\x12\x12\n\nmodel_name\x18\x01 \x01(\t")\n\'StreamingExplicitContentDetectionConfig":\n\x1dStreamingLabelDetectionConfig\x12\x19\n\x11stationary_camera\x18\x01 \x01(\x08"\x1f\n\x1dStreamingObjectTrackingConfig"$\n"StreamingShotChangeDetectionConfig"o\n\x16StreamingStorageConfig\x12(\n enable_storage_annotation_result\x18\x01 \x01(\x08\x12+\n#annotation_result_storage_directory\x18\x03 \x01(\t"\x8b\x03\n\x1fStreamingVideoAnnotationResults\x12P\n\x10shot_annotations\x18\x01 \x03(\x0b\x32\x36.google.cloud.videointelligence.v1p3beta1.VideoSegment\x12T\n\x11label_annotations\x18\x02 \x03(\x0b\x32\x39.google.cloud.videointelligence.v1p3beta1.LabelAnnotation\x12`\n\x13\x65xplicit_annotation\x18\x03 \x01(\x0b\x32\x43.google.cloud.videointelligence.v1p3beta1.ExplicitContentAnnotation\x12^\n\x12object_annotations\x18\x04 \x03(\x0b\x32\x42.google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation"\x8c\x07\n\x14StreamingVideoConfig\x12K\n\x07\x66\x65\x61ture\x18\x01 \x01(\x0e\x32:.google.cloud.videointelligence.v1p3beta1.StreamingFeature\x12t\n\x1cshot_change_detection_config\x18\x02 \x01(\x0b\x32L.google.cloud.videointelligence.v1p3beta1.StreamingShotChangeDetectionConfigH\x00\x12i\n\x16label_detection_config\x18\x03 \x01(\x0b\x32G.google.cloud.videointelligence.v1p3beta1.StreamingLabelDetectionConfigH\x00\x12~\n!explicit_content_detection_config\x18\x04 \x01(\x0b\x32Q.google.cloud.videointelligence.v1p3beta1.StreamingExplicitContentDetectionConfigH\x00\x12i\n\x16object_tracking_config\x18\x05 \x01(\x0b\x32G.google.cloud.videointelligence.v1p3beta1.StreamingObjectTrackingConfigH\x00\x12u\n\x1c\x61utoml_classification_config\x18\x15 \x01(\x0b\x32M.google.cloud.videointelligence.v1p3beta1.StreamingAutomlClassificationConfigH\x00\x12v\n\x1d\x61utoml_object_tracking_config\x18\x16 \x01(\x0b\x32M.google.cloud.videointelligence.v1p3beta1.StreamingAutomlObjectTrackingConfigH\x00\x12X\n\x0estorage_config\x18\x1e \x01(\x0b\x32@.google.cloud.videointelligence.v1p3beta1.StreamingStorageConfigB\x12\n\x10streaming_config*\xcb\x01\n\x07\x46\x65\x61ture\x12\x17\n\x13\x46\x45\x41TURE_UNSPECIFIED\x10\x00\x12\x13\n\x0fLABEL_DETECTION\x10\x01\x12\x19\n\x15SHOT_CHANGE_DETECTION\x10\x02\x12\x1e\n\x1a\x45XPLICIT_CONTENT_DETECTION\x10\x03\x12\x18\n\x14SPEECH_TRANSCRIPTION\x10\x06\x12\x12\n\x0eTEXT_DETECTION\x10\x07\x12\x13\n\x0fOBJECT_TRACKING\x10\t\x12\x14\n\x10LOGO_RECOGNITION\x10\x0c*r\n\x12LabelDetectionMode\x12$\n LABEL_DETECTION_MODE_UNSPECIFIED\x10\x00\x12\r\n\tSHOT_MODE\x10\x01\x12\x0e\n\nFRAME_MODE\x10\x02\x12\x17\n\x13SHOT_AND_FRAME_MODE\x10\x03*t\n\nLikelihood\x12\x1a\n\x16LIKELIHOOD_UNSPECIFIED\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05*\x8d\x02\n\x10StreamingFeature\x12!\n\x1dSTREAMING_FEATURE_UNSPECIFIED\x10\x00\x12\x1d\n\x19STREAMING_LABEL_DETECTION\x10\x01\x12#\n\x1fSTREAMING_SHOT_CHANGE_DETECTION\x10\x02\x12(\n$STREAMING_EXPLICIT_CONTENT_DETECTION\x10\x03\x12\x1d\n\x19STREAMING_OBJECT_TRACKING\x10\x04\x12#\n\x1fSTREAMING_AUTOML_CLASSIFICATION\x10\x15\x12$\n STREAMING_AUTOML_OBJECT_TRACKING\x10\x16\x32\xb2\x01\n\x18VideoIntelligenceService\x12\x95\x01\n\rAnnotateVideo\x12>.google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest\x1a\x1d.google.longrunning.Operation"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p3beta1/videos:annotate:\x01*2\xd5\x01\n!StreamingVideoIntelligenceService\x12\xaf\x01\n\x16StreamingAnnotateVideo\x12G.google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoRequest\x1aH.google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse(\x01\x30\x01\x42\xae\x02\n,com.google.cloud.videointelligence.v1p3beta1B\x1dVideoIntelligenceServiceProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/videointelligence/v1p3beta1;videointelligence\xaa\x02(Google.Cloud.VideoIntelligence.V1P3Beta1\xca\x02(Google\\Cloud\\VideoIntelligence\\V1p3beta1\xea\x02+Google::Cloud::VideoIntelligence::V1p3beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+_FEATURE = _descriptor.EnumDescriptor(
+    name="Feature",
+    full_name="google.cloud.videointelligence.v1p3beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_CHANGE_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EXPLICIT_CONTENT_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPEECH_TRANSCRIPTION",
+            index=4,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=5, number=7, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_TRACKING",
+            index=6,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGO_RECOGNITION",
+            index=7,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=8836,
+    serialized_end=9039,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE)
+
+Feature = enum_type_wrapper.EnumTypeWrapper(_FEATURE)
+_LABELDETECTIONMODE = _descriptor.EnumDescriptor(
+    name="LabelDetectionMode",
+    full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionMode",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION_MODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_MODE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FRAME_MODE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOT_AND_FRAME_MODE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=9041,
+    serialized_end=9155,
+)
+_sym_db.RegisterEnumDescriptor(_LABELDETECTIONMODE)
+
+LabelDetectionMode = enum_type_wrapper.EnumTypeWrapper(_LABELDETECTIONMODE)
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.videointelligence.v1p3beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="LIKELIHOOD_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=9157,
+    serialized_end=9273,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+_STREAMINGFEATURE = _descriptor.EnumDescriptor(
+    name="StreamingFeature",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingFeature",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_FEATURE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_LABEL_DETECTION",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_SHOT_CHANGE_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_EXPLICIT_CONTENT_DETECTION",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_OBJECT_TRACKING",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_AUTOML_CLASSIFICATION",
+            index=5,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="STREAMING_AUTOML_OBJECT_TRACKING",
+            index=6,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=9276,
+    serialized_end=9545,
+)
+_sym_db.RegisterEnumDescriptor(_STREAMINGFEATURE)
+
+StreamingFeature = enum_type_wrapper.EnumTypeWrapper(_STREAMINGFEATURE)
+FEATURE_UNSPECIFIED = 0
+LABEL_DETECTION = 1
+SHOT_CHANGE_DETECTION = 2
+EXPLICIT_CONTENT_DETECTION = 3
+SPEECH_TRANSCRIPTION = 6
+TEXT_DETECTION = 7
+OBJECT_TRACKING = 9
+LOGO_RECOGNITION = 12
+LABEL_DETECTION_MODE_UNSPECIFIED = 0
+SHOT_MODE = 1
+FRAME_MODE = 2
+SHOT_AND_FRAME_MODE = 3
+LIKELIHOOD_UNSPECIFIED = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+STREAMING_FEATURE_UNSPECIFIED = 0
+STREAMING_LABEL_DETECTION = 1
+STREAMING_SHOT_CHANGE_DETECTION = 2
+STREAMING_EXPLICIT_CONTENT_DETECTION = 3
+STREAMING_OBJECT_TRACKING = 4
+STREAMING_AUTOML_CLASSIFICATION = 21
+STREAMING_AUTOML_OBJECT_TRACKING = 22
+
+
+_ANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="AnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest.input_content",
+            index=1,
+            number=6,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest.features",
+            index=2,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_context",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest.video_context",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_uri",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest.output_uri",
+            index=4,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="location_id",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest.location_id",
+            index=5,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=275,
+    serialized_end=528,
+)
+
+
+_VIDEOCONTEXT = _descriptor.Descriptor(
+    name="VideoContext",
+    full_name="google.cloud.videointelligence.v1p3beta1.VideoContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.segments",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.label_detection_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.shot_change_detection_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_content_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.explicit_content_detection_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_transcription_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.speech_transcription_config",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.text_detection_config",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoContext.object_tracking_config",
+            index=6,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=531,
+    serialized_end=1235,
+)
+
+
+_LABELDETECTIONCONFIG = _descriptor.Descriptor(
+    name="LabelDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label_detection_mode",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig.label_detection_mode",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig.stationary_camera",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_confidence_threshold",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig.frame_confidence_threshold",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="video_confidence_threshold",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig.video_confidence_threshold",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1238,
+    serialized_end=1466,
+)
+
+
+_SHOTCHANGEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ShotChangeDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.ShotChangeDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p3beta1.ShotChangeDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1468,
+    serialized_end=1510,
+)
+
+
+_OBJECTTRACKINGCONFIG = _descriptor.Descriptor(
+    name="ObjectTrackingConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1512,
+    serialized_end=1549,
+)
+
+
+_EXPLICITCONTENTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="ExplicitContentDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentDetectionConfig.model",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1551,
+    serialized_end=1598,
+)
+
+
+_TEXTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="TextDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.TextDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextDetectionConfig.language_hints",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextDetectionConfig.model",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1600,
+    serialized_end=1660,
+)
+
+
+_VIDEOSEGMENT = _descriptor.Descriptor(
+    name="VideoSegment",
+    full_name="google.cloud.videointelligence.v1p3beta1.VideoSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoSegment.start_time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoSegment.end_time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1662,
+    serialized_end=1782,
+)
+
+
+_LABELSEGMENT = _descriptor.Descriptor(
+    name="LabelSegment",
+    full_name="google.cloud.videointelligence.v1p3beta1.LabelSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1784,
+    serialized_end=1891,
+)
+
+
+_LABELFRAME = _descriptor.Descriptor(
+    name="LabelFrame",
+    full_name="google.cloud.videointelligence.v1p3beta1.LabelFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelFrame.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1893,
+    serialized_end=1973,
+)
+
+
+_ENTITY = _descriptor.Descriptor(
+    name="Entity",
+    full_name="google.cloud.videointelligence.v1p3beta1.Entity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.videointelligence.v1p3beta1.Entity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.videointelligence.v1p3beta1.Entity.description",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1p3beta1.Entity.language_code",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1975,
+    serialized_end=2046,
+)
+
+
+_LABELANNOTATION = _descriptor.Descriptor(
+    name="LabelAnnotation",
+    full_name="google.cloud.videointelligence.v1p3beta1.LabelAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category_entities",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelAnnotation.category_entities",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelAnnotation.segments",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p3beta1.LabelAnnotation.frames",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2049,
+    serialized_end=2353,
+)
+
+
+_EXPLICITCONTENTFRAME = _descriptor.Descriptor(
+    name="ExplicitContentFrame",
+    full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentFrame.time_offset",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pornography_likelihood",
+            full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentFrame.pornography_likelihood",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2356,
+    serialized_end=2512,
+)
+
+
+_EXPLICITCONTENTANNOTATION = _descriptor.Descriptor(
+    name="ExplicitContentAnnotation",
+    full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p3beta1.ExplicitContentAnnotation.frames",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2514,
+    serialized_end=2621,
+)
+
+
+_NORMALIZEDBOUNDINGBOX = _descriptor.Descriptor(
+    name="NormalizedBoundingBox",
+    full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="left",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox.left",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="top",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox.top",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="right",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox.right",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bottom",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox.bottom",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2623,
+    serialized_end=2704,
+)
+
+
+_TIMESTAMPEDOBJECT = _descriptor.Descriptor(
+    name="TimestampedObject",
+    full_name="google.cloud.videointelligence.v1p3beta1.TimestampedObject",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_box",
+            full_name="google.cloud.videointelligence.v1p3beta1.TimestampedObject.normalized_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.TimestampedObject.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.cloud.videointelligence.v1p3beta1.TimestampedObject.attributes",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2707,
+    serialized_end=2953,
+)
+
+
+_TRACK = _descriptor.Descriptor(
+    name="Track",
+    full_name="google.cloud.videointelligence.v1p3beta1.Track",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p3beta1.Track.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="timestamped_objects",
+            full_name="google.cloud.videointelligence.v1p3beta1.Track.timestamped_objects",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="attributes",
+            full_name="google.cloud.videointelligence.v1p3beta1.Track.attributes",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.Track.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2956,
+    serialized_end=3227,
+)
+
+
+_DETECTEDATTRIBUTE = _descriptor.Descriptor(
+    name="DetectedAttribute",
+    full_name="google.cloud.videointelligence.v1p3beta1.DetectedAttribute",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.videointelligence.v1p3beta1.DetectedAttribute.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.DetectedAttribute.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.videointelligence.v1p3beta1.DetectedAttribute.value",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3229,
+    serialized_end=3297,
+)
+
+
+_VIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="VideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment_label_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.segment_label_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_label_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.shot_label_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_label_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.frame_label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.shot_annotations",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_annotation",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.explicit_annotation",
+            index=5,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_transcriptions",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.speech_transcriptions",
+            index=6,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.text_annotations",
+            index=7,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.object_annotations",
+            index=8,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logo_recognition_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.logo_recognition_annotations",
+            index=9,
+            number=19,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults.error",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3300,
+    serialized_end=4216,
+)
+
+
+_ANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="AnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse.annotation_results",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4218,
+    serialized_end=4335,
+)
+
+
+_VIDEOANNOTATIONPROGRESS = _descriptor.Descriptor(
+    name="VideoAnnotationProgress",
+    full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_uri",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress.input_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress.progress_percent",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress.start_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress.update_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4338,
+    serialized_end=4505,
+)
+
+
+_ANNOTATEVIDEOPROGRESS = _descriptor.Descriptor(
+    name="AnnotateVideoProgress",
+    full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="annotation_progress",
+            full_name="google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress.annotation_progress",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4507,
+    serialized_end=4626,
+)
+
+
+_SPEECHTRANSCRIPTIONCONFIG = _descriptor.Descriptor(
+    name="SpeechTranscriptionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_alternatives",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.max_alternatives",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter_profanity",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.filter_profanity",
+            index=2,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speech_contexts",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.speech_contexts",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_automatic_punctuation",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.enable_automatic_punctuation",
+            index=4,
+            number=5,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="audio_tracks",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.audio_tracks",
+            index=5,
+            number=6,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_speaker_diarization",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.enable_speaker_diarization",
+            index=6,
+            number=7,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="diarization_speaker_count",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.diarization_speaker_count",
+            index=7,
+            number=8,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="enable_word_confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig.enable_word_confidence",
+            index=8,
+            number=9,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4629,
+    serialized_end=4976,
+)
+
+
+_SPEECHCONTEXT = _descriptor.Descriptor(
+    name="SpeechContext",
+    full_name="google.cloud.videointelligence.v1p3beta1.SpeechContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="phrases",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechContext.phrases",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4978,
+    serialized_end=5010,
+)
+
+
+_SPEECHTRANSCRIPTION = _descriptor.Descriptor(
+    name="SpeechTranscription",
+    full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscription",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="alternatives",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscription.alternatives",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechTranscription.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5013,
+    serialized_end=5151,
+)
+
+
+_SPEECHRECOGNITIONALTERNATIVE = _descriptor.Descriptor(
+    name="SpeechRecognitionAlternative",
+    full_name="google.cloud.videointelligence.v1p3beta1.SpeechRecognitionAlternative",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="transcript",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechRecognitionAlternative.transcript",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechRecognitionAlternative.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.videointelligence.v1p3beta1.SpeechRecognitionAlternative.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5154,
+    serialized_end=5291,
+)
+
+
+_WORDINFO = _descriptor.Descriptor(
+    name="WordInfo",
+    full_name="google.cloud.videointelligence.v1p3beta1.WordInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.videointelligence.v1p3beta1.WordInfo.start_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.videointelligence.v1p3beta1.WordInfo.end_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="word",
+            full_name="google.cloud.videointelligence.v1p3beta1.WordInfo.word",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.WordInfo.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="speaker_tag",
+            full_name="google.cloud.videointelligence.v1p3beta1.WordInfo.speaker_tag",
+            index=4,
+            number=5,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5294,
+    serialized_end=5451,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.videointelligence.v1p3beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5453,
+    serialized_end=5493,
+)
+
+
+_NORMALIZEDBOUNDINGPOLY = _descriptor.Descriptor(
+    name="NormalizedBoundingPoly",
+    full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.videointelligence.v1p3beta1.NormalizedBoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5495,
+    serialized_end=5597,
+)
+
+
+_TEXTSEGMENT = _descriptor.Descriptor(
+    name="TextSegment",
+    full_name="google.cloud.videointelligence.v1p3beta1.TextSegment",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextSegment.segment",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextSegment.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextSegment.frames",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5600,
+    serialized_end=5775,
+)
+
+
+_TEXTFRAME = _descriptor.Descriptor(
+    name="TextFrame",
+    full_name="google.cloud.videointelligence.v1p3beta1.TextFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="rotated_bounding_box",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextFrame.rotated_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5778,
+    serialized_end=5933,
+)
+
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.videointelligence.v1p3beta1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextAnnotation.text",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p3beta1.TextAnnotation.segments",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5935,
+    serialized_end=6038,
+)
+
+
+_OBJECTTRACKINGFRAME = _descriptor.Descriptor(
+    name="ObjectTrackingFrame",
+    full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingFrame",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_box",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingFrame.normalized_bounding_box",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="time_offset",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingFrame.time_offset",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6041,
+    serialized_end=6208,
+)
+
+
+_OBJECTTRACKINGANNOTATION = _descriptor.Descriptor(
+    name="ObjectTrackingAnnotation",
+    full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation.confidence",
+            index=1,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frames",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation.frames",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segment",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation.segment",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="track_id",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation.track_id",
+            index=4,
+            number=5,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="track_info",
+            full_name="google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation.track_info",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=6211,
+    serialized_end=6511,
+)
+
+
+_LOGORECOGNITIONANNOTATION = _descriptor.Descriptor(
+    name="LogoRecognitionAnnotation",
+    full_name="google.cloud.videointelligence.v1p3beta1.LogoRecognitionAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity",
+            full_name="google.cloud.videointelligence.v1p3beta1.LogoRecognitionAnnotation.entity",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tracks",
+            full_name="google.cloud.videointelligence.v1p3beta1.LogoRecognitionAnnotation.tracks",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="segments",
+            full_name="google.cloud.videointelligence.v1p3beta1.LogoRecognitionAnnotation.segments",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6514,
+    serialized_end=6746,
+)
+
+
+_STREAMINGANNOTATEVIDEOREQUEST = _descriptor.Descriptor(
+    name="StreamingAnnotateVideoRequest",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="video_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoRequest.video_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_content",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoRequest.input_content",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="streaming_request",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoRequest.streaming_request",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=6749,
+    serialized_end=6914,
+)
+
+
+_STREAMINGANNOTATEVIDEORESPONSE = _descriptor.Descriptor(
+    name="StreamingAnnotateVideoResponse",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse.error",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_results",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse.annotation_results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_results_uri",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse.annotation_results_uri",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6917,
+    serialized_end=7119,
+)
+
+
+_STREAMINGAUTOMLCLASSIFICATIONCONFIG = _descriptor.Descriptor(
+    name="StreamingAutomlClassificationConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingAutomlClassificationConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model_name",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAutomlClassificationConfig.model_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7121,
+    serialized_end=7178,
+)
+
+
+_STREAMINGAUTOMLOBJECTTRACKINGCONFIG = _descriptor.Descriptor(
+    name="StreamingAutomlObjectTrackingConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingAutomlObjectTrackingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="model_name",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingAutomlObjectTrackingConfig.model_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7180,
+    serialized_end=7237,
+)
+
+
+_STREAMINGEXPLICITCONTENTDETECTIONCONFIG = _descriptor.Descriptor(
+    name="StreamingExplicitContentDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingExplicitContentDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7239,
+    serialized_end=7280,
+)
+
+
+_STREAMINGLABELDETECTIONCONFIG = _descriptor.Descriptor(
+    name="StreamingLabelDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingLabelDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stationary_camera",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingLabelDetectionConfig.stationary_camera",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7282,
+    serialized_end=7340,
+)
+
+
+_STREAMINGOBJECTTRACKINGCONFIG = _descriptor.Descriptor(
+    name="StreamingObjectTrackingConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingObjectTrackingConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7342,
+    serialized_end=7373,
+)
+
+
+_STREAMINGSHOTCHANGEDETECTIONCONFIG = _descriptor.Descriptor(
+    name="StreamingShotChangeDetectionConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingShotChangeDetectionConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7375,
+    serialized_end=7411,
+)
+
+
+_STREAMINGSTORAGECONFIG = _descriptor.Descriptor(
+    name="StreamingStorageConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingStorageConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="enable_storage_annotation_result",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingStorageConfig.enable_storage_annotation_result",
+            index=0,
+            number=1,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="annotation_result_storage_directory",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingStorageConfig.annotation_result_storage_directory",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7413,
+    serialized_end=7524,
+)
+
+
+_STREAMINGVIDEOANNOTATIONRESULTS = _descriptor.Descriptor(
+    name="StreamingVideoAnnotationResults",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="shot_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults.shot_annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults.label_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_annotation",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults.explicit_annotation",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_annotations",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults.object_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7527,
+    serialized_end=7922,
+)
+
+
+_STREAMINGVIDEOCONFIG = _descriptor.Descriptor(
+    name="StreamingVideoConfig",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="feature",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.feature",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="shot_change_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.shot_change_detection_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.label_detection_config",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="explicit_content_detection_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.explicit_content_detection_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_tracking_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.object_tracking_config",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="automl_classification_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.automl_classification_config",
+            index=5,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="automl_object_tracking_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.automl_object_tracking_config",
+            index=6,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="storage_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.storage_config",
+            index=7,
+            number=30,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="streaming_config",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig.streaming_config",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=7925,
+    serialized_end=8833,
+)
+
+_ANNOTATEVIDEOREQUEST.fields_by_name["features"].enum_type = _FEATURE
+_ANNOTATEVIDEOREQUEST.fields_by_name["video_context"].message_type = _VIDEOCONTEXT
+_VIDEOCONTEXT.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_VIDEOCONTEXT.fields_by_name[
+    "label_detection_config"
+].message_type = _LABELDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "shot_change_detection_config"
+].message_type = _SHOTCHANGEDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "explicit_content_detection_config"
+].message_type = _EXPLICITCONTENTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "speech_transcription_config"
+].message_type = _SPEECHTRANSCRIPTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "text_detection_config"
+].message_type = _TEXTDETECTIONCONFIG
+_VIDEOCONTEXT.fields_by_name[
+    "object_tracking_config"
+].message_type = _OBJECTTRACKINGCONFIG
+_LABELDETECTIONCONFIG.fields_by_name[
+    "label_detection_mode"
+].enum_type = _LABELDETECTIONMODE
+_VIDEOSEGMENT.fields_by_name[
+    "start_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_VIDEOSEGMENT.fields_by_name[
+    "end_time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_LABELFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_LABELANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["category_entities"].message_type = _ENTITY
+_LABELANNOTATION.fields_by_name["segments"].message_type = _LABELSEGMENT
+_LABELANNOTATION.fields_by_name["frames"].message_type = _LABELFRAME
+_EXPLICITCONTENTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_EXPLICITCONTENTFRAME.fields_by_name["pornography_likelihood"].enum_type = _LIKELIHOOD
+_EXPLICITCONTENTANNOTATION.fields_by_name["frames"].message_type = _EXPLICITCONTENTFRAME
+_TIMESTAMPEDOBJECT.fields_by_name[
+    "normalized_bounding_box"
+].message_type = _NORMALIZEDBOUNDINGBOX
+_TIMESTAMPEDOBJECT.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TIMESTAMPEDOBJECT.fields_by_name["attributes"].message_type = _DETECTEDATTRIBUTE
+_TRACK.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_TRACK.fields_by_name["timestamped_objects"].message_type = _TIMESTAMPEDOBJECT
+_TRACK.fields_by_name["attributes"].message_type = _DETECTEDATTRIBUTE
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "segment_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "frame_label_annotations"
+].message_type = _LABELANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name["shot_annotations"].message_type = _VIDEOSEGMENT
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "explicit_annotation"
+].message_type = _EXPLICITCONTENTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "speech_transcriptions"
+].message_type = _SPEECHTRANSCRIPTION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "text_annotations"
+].message_type = _TEXTANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "object_annotations"
+].message_type = _OBJECTTRACKINGANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "logo_recognition_annotations"
+].message_type = _LOGORECOGNITIONANNOTATION
+_VIDEOANNOTATIONRESULTS.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _VIDEOANNOTATIONRESULTS
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_VIDEOANNOTATIONPROGRESS.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_ANNOTATEVIDEOPROGRESS.fields_by_name[
+    "annotation_progress"
+].message_type = _VIDEOANNOTATIONPROGRESS
+_SPEECHTRANSCRIPTIONCONFIG.fields_by_name[
+    "speech_contexts"
+].message_type = _SPEECHCONTEXT
+_SPEECHTRANSCRIPTION.fields_by_name[
+    "alternatives"
+].message_type = _SPEECHRECOGNITIONALTERNATIVE
+_SPEECHRECOGNITIONALTERNATIVE.fields_by_name["words"].message_type = _WORDINFO
+_WORDINFO.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_WORDINFO.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_NORMALIZEDBOUNDINGPOLY.fields_by_name["vertices"].message_type = _NORMALIZEDVERTEX
+_TEXTSEGMENT.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_TEXTSEGMENT.fields_by_name["frames"].message_type = _TEXTFRAME
+_TEXTFRAME.fields_by_name["rotated_bounding_box"].message_type = _NORMALIZEDBOUNDINGPOLY
+_TEXTFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TEXTANNOTATION.fields_by_name["segments"].message_type = _TEXTSEGMENT
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "normalized_bounding_box"
+].message_type = _NORMALIZEDBOUNDINGBOX
+_OBJECTTRACKINGFRAME.fields_by_name[
+    "time_offset"
+].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_OBJECTTRACKINGANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_OBJECTTRACKINGANNOTATION.fields_by_name["frames"].message_type = _OBJECTTRACKINGFRAME
+_OBJECTTRACKINGANNOTATION.fields_by_name["segment"].message_type = _VIDEOSEGMENT
+_OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"].fields.append(
+    _OBJECTTRACKINGANNOTATION.fields_by_name["segment"]
+)
+_OBJECTTRACKINGANNOTATION.fields_by_name[
+    "segment"
+].containing_oneof = _OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"]
+_OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"].fields.append(
+    _OBJECTTRACKINGANNOTATION.fields_by_name["track_id"]
+)
+_OBJECTTRACKINGANNOTATION.fields_by_name[
+    "track_id"
+].containing_oneof = _OBJECTTRACKINGANNOTATION.oneofs_by_name["track_info"]
+_LOGORECOGNITIONANNOTATION.fields_by_name["entity"].message_type = _ENTITY
+_LOGORECOGNITIONANNOTATION.fields_by_name["tracks"].message_type = _TRACK
+_LOGORECOGNITIONANNOTATION.fields_by_name["segments"].message_type = _VIDEOSEGMENT
+_STREAMINGANNOTATEVIDEOREQUEST.fields_by_name[
+    "video_config"
+].message_type = _STREAMINGVIDEOCONFIG
+_STREAMINGANNOTATEVIDEOREQUEST.oneofs_by_name["streaming_request"].fields.append(
+    _STREAMINGANNOTATEVIDEOREQUEST.fields_by_name["video_config"]
+)
+_STREAMINGANNOTATEVIDEOREQUEST.fields_by_name[
+    "video_config"
+].containing_oneof = _STREAMINGANNOTATEVIDEOREQUEST.oneofs_by_name["streaming_request"]
+_STREAMINGANNOTATEVIDEOREQUEST.oneofs_by_name["streaming_request"].fields.append(
+    _STREAMINGANNOTATEVIDEOREQUEST.fields_by_name["input_content"]
+)
+_STREAMINGANNOTATEVIDEOREQUEST.fields_by_name[
+    "input_content"
+].containing_oneof = _STREAMINGANNOTATEVIDEOREQUEST.oneofs_by_name["streaming_request"]
+_STREAMINGANNOTATEVIDEORESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_STREAMINGANNOTATEVIDEORESPONSE.fields_by_name[
+    "annotation_results"
+].message_type = _STREAMINGVIDEOANNOTATIONRESULTS
+_STREAMINGVIDEOANNOTATIONRESULTS.fields_by_name[
+    "shot_annotations"
+].message_type = _VIDEOSEGMENT
+_STREAMINGVIDEOANNOTATIONRESULTS.fields_by_name[
+    "label_annotations"
+].message_type = _LABELANNOTATION
+_STREAMINGVIDEOANNOTATIONRESULTS.fields_by_name[
+    "explicit_annotation"
+].message_type = _EXPLICITCONTENTANNOTATION
+_STREAMINGVIDEOANNOTATIONRESULTS.fields_by_name[
+    "object_annotations"
+].message_type = _OBJECTTRACKINGANNOTATION
+_STREAMINGVIDEOCONFIG.fields_by_name["feature"].enum_type = _STREAMINGFEATURE
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "shot_change_detection_config"
+].message_type = _STREAMINGSHOTCHANGEDETECTIONCONFIG
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "label_detection_config"
+].message_type = _STREAMINGLABELDETECTIONCONFIG
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "explicit_content_detection_config"
+].message_type = _STREAMINGEXPLICITCONTENTDETECTIONCONFIG
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "object_tracking_config"
+].message_type = _STREAMINGOBJECTTRACKINGCONFIG
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "automl_classification_config"
+].message_type = _STREAMINGAUTOMLCLASSIFICATIONCONFIG
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "automl_object_tracking_config"
+].message_type = _STREAMINGAUTOMLOBJECTTRACKINGCONFIG
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "storage_config"
+].message_type = _STREAMINGSTORAGECONFIG
+_STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"].fields.append(
+    _STREAMINGVIDEOCONFIG.fields_by_name["shot_change_detection_config"]
+)
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "shot_change_detection_config"
+].containing_oneof = _STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"]
+_STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"].fields.append(
+    _STREAMINGVIDEOCONFIG.fields_by_name["label_detection_config"]
+)
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "label_detection_config"
+].containing_oneof = _STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"]
+_STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"].fields.append(
+    _STREAMINGVIDEOCONFIG.fields_by_name["explicit_content_detection_config"]
+)
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "explicit_content_detection_config"
+].containing_oneof = _STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"]
+_STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"].fields.append(
+    _STREAMINGVIDEOCONFIG.fields_by_name["object_tracking_config"]
+)
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "object_tracking_config"
+].containing_oneof = _STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"]
+_STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"].fields.append(
+    _STREAMINGVIDEOCONFIG.fields_by_name["automl_classification_config"]
+)
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "automl_classification_config"
+].containing_oneof = _STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"]
+_STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"].fields.append(
+    _STREAMINGVIDEOCONFIG.fields_by_name["automl_object_tracking_config"]
+)
+_STREAMINGVIDEOCONFIG.fields_by_name[
+    "automl_object_tracking_config"
+].containing_oneof = _STREAMINGVIDEOCONFIG.oneofs_by_name["streaming_config"]
+DESCRIPTOR.message_types_by_name["AnnotateVideoRequest"] = _ANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name["VideoContext"] = _VIDEOCONTEXT
+DESCRIPTOR.message_types_by_name["LabelDetectionConfig"] = _LABELDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ShotChangeDetectionConfig"
+] = _SHOTCHANGEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["ObjectTrackingConfig"] = _OBJECTTRACKINGCONFIG
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentDetectionConfig"
+] = _EXPLICITCONTENTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["TextDetectionConfig"] = _TEXTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["VideoSegment"] = _VIDEOSEGMENT
+DESCRIPTOR.message_types_by_name["LabelSegment"] = _LABELSEGMENT
+DESCRIPTOR.message_types_by_name["LabelFrame"] = _LABELFRAME
+DESCRIPTOR.message_types_by_name["Entity"] = _ENTITY
+DESCRIPTOR.message_types_by_name["LabelAnnotation"] = _LABELANNOTATION
+DESCRIPTOR.message_types_by_name["ExplicitContentFrame"] = _EXPLICITCONTENTFRAME
+DESCRIPTOR.message_types_by_name[
+    "ExplicitContentAnnotation"
+] = _EXPLICITCONTENTANNOTATION
+DESCRIPTOR.message_types_by_name["NormalizedBoundingBox"] = _NORMALIZEDBOUNDINGBOX
+DESCRIPTOR.message_types_by_name["TimestampedObject"] = _TIMESTAMPEDOBJECT
+DESCRIPTOR.message_types_by_name["Track"] = _TRACK
+DESCRIPTOR.message_types_by_name["DetectedAttribute"] = _DETECTEDATTRIBUTE
+DESCRIPTOR.message_types_by_name["VideoAnnotationResults"] = _VIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["AnnotateVideoResponse"] = _ANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name["VideoAnnotationProgress"] = _VIDEOANNOTATIONPROGRESS
+DESCRIPTOR.message_types_by_name["AnnotateVideoProgress"] = _ANNOTATEVIDEOPROGRESS
+DESCRIPTOR.message_types_by_name[
+    "SpeechTranscriptionConfig"
+] = _SPEECHTRANSCRIPTIONCONFIG
+DESCRIPTOR.message_types_by_name["SpeechContext"] = _SPEECHCONTEXT
+DESCRIPTOR.message_types_by_name["SpeechTranscription"] = _SPEECHTRANSCRIPTION
+DESCRIPTOR.message_types_by_name[
+    "SpeechRecognitionAlternative"
+] = _SPEECHRECOGNITIONALTERNATIVE
+DESCRIPTOR.message_types_by_name["WordInfo"] = _WORDINFO
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["NormalizedBoundingPoly"] = _NORMALIZEDBOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["TextSegment"] = _TEXTSEGMENT
+DESCRIPTOR.message_types_by_name["TextFrame"] = _TEXTFRAME
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["ObjectTrackingFrame"] = _OBJECTTRACKINGFRAME
+DESCRIPTOR.message_types_by_name["ObjectTrackingAnnotation"] = _OBJECTTRACKINGANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "LogoRecognitionAnnotation"
+] = _LOGORECOGNITIONANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "StreamingAnnotateVideoRequest"
+] = _STREAMINGANNOTATEVIDEOREQUEST
+DESCRIPTOR.message_types_by_name[
+    "StreamingAnnotateVideoResponse"
+] = _STREAMINGANNOTATEVIDEORESPONSE
+DESCRIPTOR.message_types_by_name[
+    "StreamingAutomlClassificationConfig"
+] = _STREAMINGAUTOMLCLASSIFICATIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "StreamingAutomlObjectTrackingConfig"
+] = _STREAMINGAUTOMLOBJECTTRACKINGCONFIG
+DESCRIPTOR.message_types_by_name[
+    "StreamingExplicitContentDetectionConfig"
+] = _STREAMINGEXPLICITCONTENTDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "StreamingLabelDetectionConfig"
+] = _STREAMINGLABELDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name[
+    "StreamingObjectTrackingConfig"
+] = _STREAMINGOBJECTTRACKINGCONFIG
+DESCRIPTOR.message_types_by_name[
+    "StreamingShotChangeDetectionConfig"
+] = _STREAMINGSHOTCHANGEDETECTIONCONFIG
+DESCRIPTOR.message_types_by_name["StreamingStorageConfig"] = _STREAMINGSTORAGECONFIG
+DESCRIPTOR.message_types_by_name[
+    "StreamingVideoAnnotationResults"
+] = _STREAMINGVIDEOANNOTATIONRESULTS
+DESCRIPTOR.message_types_by_name["StreamingVideoConfig"] = _STREAMINGVIDEOCONFIG
+DESCRIPTOR.enum_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.enum_types_by_name["LabelDetectionMode"] = _LABELDETECTIONMODE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+DESCRIPTOR.enum_types_by_name["StreamingFeature"] = _STREAMINGFEATURE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+AnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation request.
+  
+  
+  Attributes:
+      input_uri:
+          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.
+      input_content:
+          The video data bytes. If unset, the input video(s) should be
+          specified via ``input_uri``. If set, ``input_uri`` should be
+          unset.
+      features:
+          Requested video annotation features.
+      video_context:
+          Additional video context and/or feature-specific parameters.
+      output_uri:
+          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>`__.
+      location_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.AnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoRequest)
+
+VideoContext = _reflection.GeneratedProtocolMessageType(
+    "VideoContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOCONTEXT,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      segments:
+          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.
+      label_detection_config:
+          Config for LABEL\_DETECTION.
+      shot_change_detection_config:
+          Config for SHOT\_CHANGE\_DETECTION.
+      explicit_content_detection_config:
+          Config for EXPLICIT\_CONTENT\_DETECTION.
+      speech_transcription_config:
+          Config for SPEECH\_TRANSCRIPTION.
+      text_detection_config:
+          Config for TEXT\_DETECTION.
+      object_tracking_config:
+          Config for OBJECT\_TRACKING.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.VideoContext)
+    ),
+)
+_sym_db.RegisterMessage(VideoContext)
+
+LabelDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "LabelDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for LABEL\_DETECTION.
+  
+  
+  Attributes:
+      label_detection_mode:
+          What labels should be detected with LABEL\_DETECTION, in
+          addition to video-level labels or segment-level labels. If
+          unspecified, defaults to ``SHOT_MODE``.
+      stationary_camera:
+          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.
+      model:
+          Model to use for label detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+      frame_confidence_threshold:
+          The confidence threshold we perform filtering on the labels
+          from 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 the default threshold everytime when we release a new
+          model.
+      video_confidence_threshold:
+          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 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 the default threshold everytime when
+          we release a new model.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.LabelDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(LabelDetectionConfig)
+
+ShotChangeDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ShotChangeDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SHOTCHANGEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for SHOT\_CHANGE\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for shot change detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ShotChangeDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ShotChangeDetectionConfig)
+
+ObjectTrackingConfig = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for OBJECT\_TRACKING.
+  
+  
+  Attributes:
+      model:
+          Model to use for object tracking. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ObjectTrackingConfig)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingConfig)
+
+ExplicitContentDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for EXPLICIT\_CONTENT\_DETECTION.
+  
+  
+  Attributes:
+      model:
+          Model to use for explicit content detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ExplicitContentDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentDetectionConfig)
+
+TextDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "TextDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for TEXT\_DETECTION.
+  
+  
+  Attributes:
+      language_hints:
+          Language hint can be specified if the language to be detected
+          is known a priori. It can increase the accuracy of the
+          detection. Language hint must be language code in BCP-47
+          format.  Automatic language detection is performed if no hint
+          is provided.
+      model:
+          Model to use for text detection. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.TextDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(TextDetectionConfig)
+
+VideoSegment = _reflection.GeneratedProtocolMessageType(
+    "VideoSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOSEGMENT,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment.
+  
+  
+  Attributes:
+      start_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the start of the segment (inclusive).
+      end_time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the end of the segment (inclusive).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.VideoSegment)
+    ),
+)
+_sym_db.RegisterMessage(VideoSegment)
+
+LabelSegment = _reflection.GeneratedProtocolMessageType(
+    "LabelSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELSEGMENT,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for label detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a label was detected.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.LabelSegment)
+    ),
+)
+_sym_db.RegisterMessage(LabelSegment)
+
+LabelFrame = _reflection.GeneratedProtocolMessageType(
+    "LabelFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELFRAME,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for label detection.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      confidence:
+          Confidence that the label is accurate. Range: [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.LabelFrame)
+    ),
+)
+_sym_db.RegisterMessage(LabelFrame)
+
+Entity = _reflection.GeneratedProtocolMessageType(
+    "Entity",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITY,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Detected entity from video analysis.
+  
+  
+  Attributes:
+      entity_id:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      description:
+          Textual description, e.g. ``Fixed-gear bicycle``.
+      language_code:
+          Language code for ``description`` in BCP-47 format.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.Entity)
+    ),
+)
+_sym_db.RegisterMessage(Entity)
+
+LabelAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LabelAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LABELANNOTATION,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Label annotation.
+  
+  
+  Attributes:
+      entity:
+          Detected entity.
+      category_entities:
+          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``.
+      segments:
+          All video segments where a label was detected.
+      frames:
+          All video frames where a label was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.LabelAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LabelAnnotation)
+
+ExplicitContentFrame = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTFRAME,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for explicit content.
+  
+  
+  Attributes:
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this location.
+      pornography_likelihood:
+          Likelihood of the pornography content..
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ExplicitContentFrame)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentFrame)
+
+ExplicitContentAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ExplicitContentAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_EXPLICITCONTENTANNOTATION,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Explicit content annotation (based on per-frame visual signals only). If
+  no explicit content has been detected in a frame, no annotations are
+  present for that frame.
+  
+  
+  Attributes:
+      frames:
+          All video frames where explicit content was detected.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ExplicitContentAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ExplicitContentAnnotation)
+
+NormalizedBoundingBox = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingBox",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGBOX,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding box. The normalized vertex coordinates are relative
+  to the original image. Range: [0, 1].
+  
+  
+  Attributes:
+      left:
+          Left X coordinate.
+      top:
+          Top Y coordinate.
+      right:
+          Right X coordinate.
+      bottom:
+          Bottom Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.NormalizedBoundingBox)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingBox)
+
+TimestampedObject = _reflection.GeneratedProtocolMessageType(
+    "TimestampedObject",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TIMESTAMPEDOBJECT,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""For tracking related features, such as LOGO\_RECOGNITION,
+  FACE\_DETECTION, CELEBRITY\_RECOGNITION, PERSON\_DETECTION. An object at
+  time\_offset with attributes, and located with
+  normalized\_bounding\_box.
+  
+  
+  Attributes:
+      normalized_bounding_box:
+          Normalized Bounding box in a frame, where the object is
+          located.
+      time_offset:
+          Time-offset, relative to the beginning of the video,
+          corresponding to the video frame for this object.
+      attributes:
+          Optional. The attributes of the object in the bounding box.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.TimestampedObject)
+    ),
+)
+_sym_db.RegisterMessage(TimestampedObject)
+
+Track = _reflection.GeneratedProtocolMessageType(
+    "Track",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TRACK,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""A track of an object instance.
+  
+  
+  Attributes:
+      segment:
+          Video segment of a track.
+      timestamped_objects:
+          The object with timestamp and attributes per frame in the
+          track.
+      attributes:
+          Optional. Attributes in the track level.
+      confidence:
+          Optional. The confidence score of the tracked object.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.Track)
+    ),
+)
+_sym_db.RegisterMessage(Track)
+
+DetectedAttribute = _reflection.GeneratedProtocolMessageType(
+    "DetectedAttribute",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DETECTEDATTRIBUTE,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""A generic detected attribute represented by name in string format.
+  
+  
+  Attributes:
+      name:
+          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.
+      confidence:
+          Detected attribute confidence. Range [0, 1].
+      value:
+          Text value of the detection result. For example, the value for
+          "HairColor" can be "black", "blonde", etc.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.DetectedAttribute)
+    ),
+)
+_sym_db.RegisterMessage(DetectedAttribute)
+
+VideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation results for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      segment_label_annotations:
+          Label annotations on video level or user specified segment
+          level. There is exactly one element for each unique label.
+      shot_label_annotations:
+          Label annotations on shot level. There is exactly one element
+          for each unique label.
+      frame_label_annotations:
+          Label annotations on frame level. There is exactly one element
+          for each unique label.
+      shot_annotations:
+          Shot annotations. Each shot is represented as a video segment.
+      explicit_annotation:
+          Explicit content annotation.
+      speech_transcriptions:
+          Speech transcription.
+      text_annotations:
+          OCR text detection and tracking. Annotations for list of
+          detected text snippets. Each will have list of frame
+          information associated with it.
+      object_annotations:
+          Annotations for list of objects detected and tracked in video.
+      logo_recognition_annotations:
+          Annotations for list of logos detected, tracked and recognized
+          in video.
+      error:
+          If set, indicates an error. Note that for a single
+          ``AnnotateVideoRequest`` some videos may succeed and some may
+          fail.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.VideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationResults)
+
+AnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation response. Included in the ``response`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_results:
+          Annotation results for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoResponse)
+
+VideoAnnotationProgress = _reflection.GeneratedProtocolMessageType(
+    "VideoAnnotationProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIDEOANNOTATIONPROGRESS,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation progress for a single video.
+  
+  
+  Attributes:
+      input_uri:
+          Video file location in `Google Cloud Storage
+          <https://cloud.google.com/storage/>`__.
+      progress_percent:
+          Approximate percentage processed thus far. Guaranteed to be
+          100 when fully processed.
+      start_time:
+          Time when the request was received.
+      update_time:
+          Time of the most recent update.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.VideoAnnotationProgress)
+    ),
+)
+_sym_db.RegisterMessage(VideoAnnotationProgress)
+
+AnnotateVideoProgress = _reflection.GeneratedProtocolMessageType(
+    "AnnotateVideoProgress",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEVIDEOPROGRESS,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video annotation progress. Included in the ``metadata`` field of the
+  ``Operation`` returned by the ``GetOperation`` call of the
+  ``google::longrunning::Operations`` service.
+  
+  
+  Attributes:
+      annotation_progress:
+          Progress metadata for all videos specified in
+          ``AnnotateVideoRequest``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateVideoProgress)
+
+SpeechTranscriptionConfig = _reflection.GeneratedProtocolMessageType(
+    "SpeechTranscriptionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHTRANSCRIPTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for SPEECH\_TRANSCRIPTION.
+  
+  
+  Attributes:
+      language_code:
+          *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.
+      max_alternatives:
+          *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.
+      filter_profanity:
+          *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.
+      speech_contexts:
+          *Optional* A means to provide context to assist the speech
+          recognition.
+      enable_automatic_punctuation:
+          *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."
+      audio_tracks:
+          *Optional* For file formats, such as MXF or MKV, supporting
+          multiple audio tracks, specify up to two tracks. Default:
+          track 0.
+      enable_speaker_diarization:
+          *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.
+      diarization_speaker_count:
+          *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.
+      enable_word_confidence:
+          *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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.SpeechTranscriptionConfig)
+    ),
+)
+_sym_db.RegisterMessage(SpeechTranscriptionConfig)
+
+SpeechContext = _reflection.GeneratedProtocolMessageType(
+    "SpeechContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHCONTEXT,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Provides "hints" to the speech recognizer to favor specific words and
+  phrases in the results.
+  
+  
+  Attributes:
+      phrases:
+          *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>`__.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.SpeechContext)
+    ),
+)
+_sym_db.RegisterMessage(SpeechContext)
+
+SpeechTranscription = _reflection.GeneratedProtocolMessageType(
+    "SpeechTranscription",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHTRANSCRIPTION,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""A speech recognition result corresponding to a portion of the audio.
+  
+  
+  Attributes:
+      alternatives:
+          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.
+      language_code:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.SpeechTranscription)
+    ),
+)
+_sym_db.RegisterMessage(SpeechTranscription)
+
+SpeechRecognitionAlternative = _reflection.GeneratedProtocolMessageType(
+    "SpeechRecognitionAlternative",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SPEECHRECOGNITIONALTERNATIVE,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Alternative hypotheses (a.k.a. n-best list).
+  
+  
+  Attributes:
+      transcript:
+          Transcript text representing the words that the user spoke.
+      confidence:
+          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. The default of
+          0.0 is a sentinel value indicating ``confidence`` was not set.
+      words:
+          A list of word-specific information for each recognized word.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.SpeechRecognitionAlternative)
+    ),
+)
+_sym_db.RegisterMessage(SpeechRecognitionAlternative)
+
+WordInfo = _reflection.GeneratedProtocolMessageType(
+    "WordInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORDINFO,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Word-specific information for recognized words. Word information is only
+  included in the response when certain request parameters are set, such
+  as ``enable_word_time_offsets``.
+  
+  
+  Attributes:
+      start_time:
+          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. This is an experimental feature and the
+          accuracy of the time offset can vary.
+      end_time:
+          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. This is an experimental feature and the
+          accuracy of the time offset can vary.
+      word:
+          The word corresponding to this set of information.
+      confidence:
+          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 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.
+      speaker_tag:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.WordInfo)
+    ),
+)
+_sym_db.RegisterMessage(WordInfo)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+NormalizedBoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGPOLY,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Normalized bounding polygon for text (that might not be aligned with
+  axis). Contains list of the corner points in clockwise order starting
+  from top-left corner. For example, for a rectangular bounding box: When
+  the text is horizontal it might look like: 0----1 \| \| 3----2
+  
+  When it's clockwise rotated 180 degrees around the top-left corner it
+  becomes: 2----3 \| \| 1----0
+  
+  and the vertex order will still be (0, 1, 2, 3). Note that values can be
+  less than 0, or greater than 1 due to trignometric calculations for
+  location of the box.
+  
+  
+  Attributes:
+      vertices:
+          Normalized vertices of the bounding polygon.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.NormalizedBoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingPoly)
+
+TextSegment = _reflection.GeneratedProtocolMessageType(
+    "TextSegment",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTSEGMENT,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video segment level annotation results for text detection.
+  
+  
+  Attributes:
+      segment:
+          Video segment where a text snippet was detected.
+      confidence:
+          Confidence for the track of detected text. It is calculated as
+          the highest over all frames where OCR detected text appears.
+      frames:
+          Information related to the frames where OCR detected text
+          appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.TextSegment)
+    ),
+)
+_sym_db.RegisterMessage(TextSegment)
+
+TextFrame = _reflection.GeneratedProtocolMessageType(
+    "TextFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTFRAME,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotation results for text annotation (OCR). Contains
+  information regarding timestamp and bounding box locations for the
+  frames containing detected OCR text snippets.
+  
+  
+  Attributes:
+      rotated_bounding_box:
+          Bounding polygon of the detected text for this frame.
+      time_offset:
+          Timestamp of this frame.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.TextFrame)
+    ),
+)
+_sym_db.RegisterMessage(TextFrame)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotations related to one detected OCR text snippet. This will contain
+  the corresponding text, confidence value, and frame level information
+  for each detection.
+  
+  
+  Attributes:
+      text:
+          The detected text.
+      segments:
+          All video segments where OCR detected text appears.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+
+ObjectTrackingFrame = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingFrame",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGFRAME,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Video frame level annotations for object detection and tracking. This
+  field stores per frame location, time offset, and confidence.
+  
+  
+  Attributes:
+      normalized_bounding_box:
+          The normalized bounding box location of this object track for
+          the frame.
+      time_offset:
+          The timestamp of the frame in microseconds.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ObjectTrackingFrame)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingFrame)
+
+ObjectTrackingAnnotation = _reflection.GeneratedProtocolMessageType(
+    "ObjectTrackingAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OBJECTTRACKINGANNOTATION,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotations corresponding to one tracked object.
+  
+  
+  Attributes:
+      entity:
+          Entity to specify the object category that this track is
+          labeled as.
+      confidence:
+          Object category's labeling confidence of this track.
+      frames:
+          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.
+      track_info:
+          Different representation of tracking info in non-streaming
+          batch and streaming modes.
+      segment:
+          Non-streaming batch mode ONLY. Each object track corresponds
+          to one video segment where it appears.
+      track_id:
+          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. Instead, we provide a unique
+          identifiable integer track\_id so that the customers can
+          correlate the results of the ongoing ObjectTrackAnnotation of
+          the same track\_id over time.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.ObjectTrackingAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(ObjectTrackingAnnotation)
+
+LogoRecognitionAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LogoRecognitionAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOGORECOGNITIONANNOTATION,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Annotation corresponding to one detected, tracked and recognized logo
+  class.
+  
+  
+  Attributes:
+      entity:
+          Entity category information to specify the logo class that all
+          the logo tracks within this LogoRecognitionAnnotation are
+          recognized as.
+      tracks:
+          All logo tracks where the recognized logo appears. Each track
+          corresponds to one logo instance appearing in consecutive
+          frames.
+      segments:
+          All video segments where the recognized logo appears. There
+          might be multiple instances of the same logo class appearing
+          in one VideoSegment.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.LogoRecognitionAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LogoRecognitionAnnotation)
+
+StreamingAnnotateVideoRequest = _reflection.GeneratedProtocolMessageType(
+    "StreamingAnnotateVideoRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGANNOTATEVIDEOREQUEST,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""The top-level message sent by the client for the
+  ``StreamingAnnotateVideo`` method. Multiple
+  ``StreamingAnnotateVideoRequest`` messages are sent. The first message
+  must only contain a ``StreamingVideoConfig`` message. All subsequent
+  messages must only contain ``input_content`` data.
+  
+  
+  Attributes:
+      streaming_request:
+          *Required* The streaming request, which is either a streaming
+          config or video content.
+      video_config:
+          Provides information to the annotator, specifing how to
+          process the request. The first
+          ``AnnotateStreamingVideoRequest`` message must only contain a
+          ``video_config`` message.
+      input_content:
+          The video data to be annotated. Chunks of video data are
+          sequentially sent in ``StreamingAnnotateVideoRequest``
+          messages. Except the initial ``StreamingAnnotateVideoRequest``
+          message containing only ``video_config``, all subsequent
+          ``AnnotateStreamingVideoRequest`` messages must only contain
+          ``input_content`` field. Note: as with all bytes fields,
+          protobuffers use a pure binary representation (not base64).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoRequest)
+    ),
+)
+_sym_db.RegisterMessage(StreamingAnnotateVideoRequest)
+
+StreamingAnnotateVideoResponse = _reflection.GeneratedProtocolMessageType(
+    "StreamingAnnotateVideoResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGANNOTATEVIDEORESPONSE,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""``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.
+  
+  
+  Attributes:
+      error:
+          If set, returns a [google.rpc.Status][google.rpc.Status]
+          message that specifies the error for the operation.
+      annotation_results:
+          Streaming annotation results.
+      annotation_results_uri:
+          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
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse)
+    ),
+)
+_sym_db.RegisterMessage(StreamingAnnotateVideoResponse)
+
+StreamingAutomlClassificationConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingAutomlClassificationConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGAUTOMLCLASSIFICATIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for AUTOML\_CLASSIFICATION in streaming mode.
+  
+  
+  Attributes:
+      model_name:
+          Resource name of AutoML model. Format: ``projects/{project_id}
+          /locations/{location_id}/models/{model_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingAutomlClassificationConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingAutomlClassificationConfig)
+
+StreamingAutomlObjectTrackingConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingAutomlObjectTrackingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGAUTOMLOBJECTTRACKINGCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for AUTOML\_OBJECT\_TRACKING in streaming mode.
+  
+  
+  Attributes:
+      model_name:
+          Resource name of AutoML model. Format: ``projects/{project_id}
+          /locations/{location_id}/models/{model_id}``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingAutomlObjectTrackingConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingAutomlObjectTrackingConfig)
+
+StreamingExplicitContentDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingExplicitContentDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGEXPLICITCONTENTDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for EXPLICIT\_CONTENT\_DETECTION in streaming mode.
+  
+  No customized config support.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingExplicitContentDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingExplicitContentDetectionConfig)
+
+StreamingLabelDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingLabelDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGLABELDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for LABEL\_DETECTION in streaming mode.
+  
+  
+  Attributes:
+      stationary_camera:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingLabelDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingLabelDetectionConfig)
+
+StreamingObjectTrackingConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingObjectTrackingConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGOBJECTTRACKINGCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for STREAMING\_OBJECT\_TRACKING.
+  
+  No customized config support.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingObjectTrackingConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingObjectTrackingConfig)
+
+StreamingShotChangeDetectionConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingShotChangeDetectionConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGSHOTCHANGEDETECTIONCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for SHOT\_CHANGE\_DETECTION in streaming mode.
+  
+  No customized config support.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingShotChangeDetectionConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingShotChangeDetectionConfig)
+
+StreamingStorageConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingStorageConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGSTORAGECONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Config for streaming storage option.
+  
+  
+  Attributes:
+      enable_storage_annotation_result:
+          Enable streaming storage. Default: false.
+      annotation_result_storage_directory:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingStorageConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingStorageConfig)
+
+StreamingVideoAnnotationResults = _reflection.GeneratedProtocolMessageType(
+    "StreamingVideoAnnotationResults",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGVIDEOANNOTATIONRESULTS,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Streaming annotation results corresponding to a portion of the video
+  that is currently being processed.
+  
+  
+  Attributes:
+      shot_annotations:
+          Shot annotation results. Each shot is represented as a video
+          segment.
+      label_annotations:
+          Label annotation results.
+      explicit_annotation:
+          Explicit content annotation results.
+      object_annotations:
+          Object tracking results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingVideoAnnotationResults)
+    ),
+)
+_sym_db.RegisterMessage(StreamingVideoAnnotationResults)
+
+StreamingVideoConfig = _reflection.GeneratedProtocolMessageType(
+    "StreamingVideoConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STREAMINGVIDEOCONFIG,
+        __module__="google.cloud.videointelligence_v1p3beta1.proto.video_intelligence_pb2",
+        __doc__="""Provides information to the annotator that specifies how to process the
+  request.
+  
+  
+  Attributes:
+      feature:
+          Requested annotation feature.
+      streaming_config:
+          Config for requested annotation feature.
+      shot_change_detection_config:
+          Config for STREAMING\_SHOT\_CHANGE\_DETECTION.
+      label_detection_config:
+          Config for STREAMING\_LABEL\_DETECTION.
+      explicit_content_detection_config:
+          Config for STREAMING\_EXPLICIT\_CONTENT\_DETECTION.
+      object_tracking_config:
+          Config for STREAMING\_OBJECT\_TRACKING.
+      automl_classification_config:
+          Config for STREAMING\_AUTOML\_CLASSIFICATION.
+      automl_object_tracking_config:
+          Config for STREAMING\_AUTOML\_OBJECT\_TRACKING.
+      storage_config:
+          Streaming storage option. By default: storage is disabled.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.videointelligence.v1p3beta1.StreamingVideoConfig)
+    ),
+)
+_sym_db.RegisterMessage(StreamingVideoConfig)
+
+
+DESCRIPTOR._options = None
+
+_VIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="VideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=9548,
+    serialized_end=9726,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="AnnotateVideo",
+            full_name="google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService.AnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_ANNOTATEVIDEOREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p3beta1/videos:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_VIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name["VideoIntelligenceService"] = _VIDEOINTELLIGENCESERVICE
+
+
+_STREAMINGVIDEOINTELLIGENCESERVICE = _descriptor.ServiceDescriptor(
+    name="StreamingVideoIntelligenceService",
+    full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService",
+    file=DESCRIPTOR,
+    index=1,
+    serialized_options=None,
+    serialized_start=9729,
+    serialized_end=9942,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="StreamingAnnotateVideo",
+            full_name="google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService.StreamingAnnotateVideo",
+            index=0,
+            containing_service=None,
+            input_type=_STREAMINGANNOTATEVIDEOREQUEST,
+            output_type=_STREAMINGANNOTATEVIDEORESPONSE,
+            serialized_options=None,
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_STREAMINGVIDEOINTELLIGENCESERVICE)
+
+DESCRIPTOR.services_by_name[
+    "StreamingVideoIntelligenceService"
+] = _STREAMINGVIDEOINTELLIGENCESERVICE
+
+# @@protoc_insertion_point(module_scope)
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence_pb2_grpc.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence_pb2_grpc.py
new file mode 100644
index 000000000000..d410892780b3
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/proto/video_intelligence_pb2_grpc.py
@@ -0,0 +1,102 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.videointelligence_v1p3beta1.proto import (
+    video_intelligence_pb2 as google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class VideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.AnnotateVideo = channel.unary_unary(
+            "/google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService/AnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class VideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence API.
+  """
+
+    def AnnotateVideo(self, request, context):
+        """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).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_VideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "AnnotateVideo": grpc.unary_unary_rpc_method_handler(
+            servicer.AnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2.AnnotateVideoRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
+
+
+class StreamingVideoIntelligenceServiceStub(object):
+    """Service that implements Google Cloud Video Intelligence Streaming API.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.StreamingAnnotateVideo = channel.stream_stream(
+            "/google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService/StreamingAnnotateVideo",
+            request_serializer=google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2.StreamingAnnotateVideoRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2.StreamingAnnotateVideoResponse.FromString,
+        )
+
+
+class StreamingVideoIntelligenceServiceServicer(object):
+    """Service that implements Google Cloud Video Intelligence Streaming API.
+  """
+
+    def StreamingAnnotateVideo(self, request_iterator, context):
+        """Performs video annotation with bidirectional streaming: emitting results
+    while sending video/audio bytes.
+    This method is only available via the gRPC API (not REST).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_StreamingVideoIntelligenceServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "StreamingAnnotateVideo": grpc.stream_stream_rpc_method_handler(
+            servicer.StreamingAnnotateVideo,
+            request_deserializer=google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2.StreamingAnnotateVideoRequest.FromString,
+            response_serializer=google_dot_cloud_dot_videointelligence__v1p3beta1_dot_proto_dot_video__intelligence__pb2.StreamingAnnotateVideoResponse.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/videointelligence/google/cloud/videointelligence_v1p3beta1/types.py b/videointelligence/google/cloud/videointelligence_v1p3beta1/types.py
new file mode 100644
index 000000000000..a56aaf9c8aa6
--- /dev/null
+++ b/videointelligence/google/cloud/videointelligence_v1p3beta1/types.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import duration_pb2
+from google.protobuf import timestamp_pb2
+from google.rpc import status_pb2
+
+
+_shared_modules = [operations_pb2, any_pb2, duration_pb2, timestamp_pb2, status_pb2]
+
+_local_modules = [video_intelligence_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.videointelligence_v1p3beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/videointelligence/noxfile.py b/videointelligence/noxfile.py
new file mode 100644
index 000000000000..9a0e46e83078
--- /dev/null
+++ b/videointelligence/noxfile.py
@@ -0,0 +1,168 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Additional set up for VPC SC.
+    env = {
+        "PROJECT_NUMBER": "570941833855",
+        "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_IP": "10.1.1.1",
+        "GOOGLE_CLOUD_TESTS_VPCSC_INSIDE_IP": "55.55.0.0",
+    }
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, env=env, *session.posargs)
+    if system_test_folder_exists:
+        session.run(
+            "py.test", "--quiet", system_test_folder_path, env=env * session.posargs
+        )
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/videointelligence/pylint.config.py b/videointelligence/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/videointelligence/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/videointelligence/setup.cfg b/videointelligence/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/videointelligence/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/videointelligence/setup.py b/videointelligence/setup.py
new file mode 100644
index 000000000000..ebd6cabf2c1a
--- /dev/null
+++ b/videointelligence/setup.py
@@ -0,0 +1,86 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-videointelligence"
+description = "Google Cloud Video Intelligence API client library"
+version = "1.11.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 5 - Production/Stable"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/videointelligence/synth.metadata b/videointelligence/synth.metadata
new file mode 100644
index 000000000000..1a3cca9bbf71
--- /dev/null
+++ b/videointelligence/synth.metadata
@@ -0,0 +1,89 @@
+{
+  "updateTime": "2019-08-07T12:41:23.743321Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "6d29882872298c8bfbaef33bd69bfca275c4d2eb",
+        "internalRef": "262019251"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "videointelligence",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/videointelligence/artman_videointelligence_v1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "videointelligence",
+        "apiVersion": "v1beta2",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/videointelligence/artman_videointelligence_v1beta2.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "videointelligence",
+        "apiVersion": "v1p1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/videointelligence/artman_videointelligence_v1p1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "videointelligence",
+        "apiVersion": "v1p2beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/videointelligence/artman_videointelligence_v1p2beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "videointelligence",
+        "apiVersion": "v1p3beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/videointelligence/artman_videointelligence_v1p3beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "videointelligence",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/videointelligence/artman_videointelligence_v1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/videointelligence/synth.py b/videointelligence/synth.py
new file mode 100644
index 000000000000..3e5d8389829c
--- /dev/null
+++ b/videointelligence/synth.py
@@ -0,0 +1,71 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1", "v1beta2", "v1p1beta1", "v1p2beta1", "v1p3beta1", "v1"]
+
+
+# ----------------------------------------------------------------------------
+# Generate videointelligence GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library(
+        "videointelligence",
+        version,
+        artman_output_name=f"video-intelligence-{version}",
+        include_protos=True,
+    )
+
+    # TODO: stop excluding tests and nox.py (excluded as we lack system tests)
+    s.move(
+        library,
+        excludes=[
+            "setup.py",
+            "nox*.py",
+            "README.rst",
+            "docs/index.rst",
+            f"tests/system/gapic/{version}/"
+            f"test_system_video_intelligence_service_{version}.py",
+            # f'tests/unit/gapic/{version}/'
+            # f'test_video_intelligence_service_client_{version}.py',
+        ],
+    )
+    s.replace(
+        f"google/cloud/videointelligence_{version}/gapic/"
+        f"*video_intelligence_service_client.py",
+        "google-cloud-video-intelligence",
+        "google-cloud-videointelligence",
+    )
+
+s.replace(
+    "tests/unit/gapic/**/test_video_intelligence_service_client_*.py",
+    "^(\s+)expected_request = video_intelligence_pb2.AnnotateVideoRequest\(\)",
+    "\g<1>expected_request = video_intelligence_pb2.AnnotateVideoRequest(\n"
+    "\g<1>    input_uri=input_uri, features=features)",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files, excludes="noxfile.py")
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/videointelligence/tests/system.py b/videointelligence/tests/system.py
new file mode 100644
index 000000000000..a8ad0a9b29bf
--- /dev/null
+++ b/videointelligence/tests/system.py
@@ -0,0 +1,133 @@
+# Copyright 2017, Google LLC 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.
+
+"""System tests for VideoIntelligence API."""
+
+import json
+import os
+import requests
+import time
+import unittest
+
+from google.cloud import videointelligence
+from google.cloud.videointelligence_v1 import enums
+
+PROJECT_NUMBER = os.environ.get("PROJECT_NUMBER")
+OUTSIDE_PROJECT_API_KEY = os.environ.get(
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT_API_KEY"
+)
+OUTSIDE_IP = os.environ.get("GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_IP")
+INSIDE_IP = os.environ.get("GOOGLE_CLOUD_TESTS_VPCSC_INSIDE_IP")
+
+
+class VideoIntelligenceSystemTestBase(unittest.TestCase):
+    client = None
+
+    def setUp(self):
+        self.input_uri = "gs://cloud-samples-data/video/cat.mp4"
+
+
+def setUpModule():
+    VideoIntelligenceSystemTestBase.client = (
+        videointelligence.VideoIntelligenceServiceClient()
+    )
+
+
+class TestVideoIntelligenceClient(VideoIntelligenceSystemTestBase):
+    def test_annotate_video(self):
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+        response = self.client.annotate_video(
+            input_uri=self.input_uri, features=features
+        )
+
+        # Wait for the operation to complete.
+        # Long timeout value warranted due to https://github.com/grpc/grpc/issues/19173
+        lro_timeout_seconds = 180
+        start_time = time.time()
+        cnt = 0
+        while not response.done() and (time.time() - start_time) < lro_timeout_seconds:
+            time.sleep(1)
+            cnt += 1
+        if not response.done():
+            self.fail(
+                "wait for operation timed out after {lro_timeout_seconds} seconds".format(
+                    lro_timeout_seconds=lro_timeout_seconds
+                )
+            )
+
+        result = response.result()
+        annotations = result.annotation_results[0]
+        assert len(annotations.segment_label_annotations) > 0
+
+
+@unittest.skipUnless(
+    OUTSIDE_PROJECT_API_KEY,
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT_API_KEY not set in environment.",
+)
+class TestVideoIntelligenceClientVpcSc(VideoIntelligenceSystemTestBase):
+    # Tests to verify VideoIntelligence service requests blocked when trying to access resources outside of a secure perimeter.
+    def setUp(self):
+        VideoIntelligenceSystemTestBase.setUp(self)
+        # api-endpoint
+        self.url = "https://videointelligence.googleapis.com/v1/videos:annotate?key={}".format(
+            OUTSIDE_PROJECT_API_KEY
+        )
+        self.body = {
+            "input_uri": self.input_uri,
+            "features": ["LABEL_DETECTION"],
+            "location_id": "us-west1",
+        }
+
+    @unittest.skipUnless(PROJECT_NUMBER, "PROJECT_NUMBER not set in environment.")
+    @unittest.skipUnless(
+        OUTSIDE_IP, "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_IP not set in environment."
+    )
+    def test_outside_ip_address_blocked(self):
+        headers = {
+            "Content-Type": "application/json",
+            "X-User-IP": OUTSIDE_IP,
+            "X-Google-GFE-Cloud-Client-Network-Project-Number": PROJECT_NUMBER,
+        }
+        r = requests.post(url=self.url, data=json.dumps(self.body), headers=headers)
+        outside_project_operation = json.loads(r.text)
+        print(outside_project_operation)
+        # Assert it returns permission denied from VPC SC
+        self.assertEqual(outside_project_operation["error"]["code"], 403)
+        self.assertEqual(
+            outside_project_operation["error"]["status"], "PERMISSION_DENIED"
+        )
+        self.assertEqual(
+            outside_project_operation["error"]["details"][0]["violations"][0]["type"],
+            "VPC_SERVICE_CONTROLS",
+        )
+        self.assertEqual(
+            outside_project_operation["error"]["message"],
+            "Request is prohibited by organization's policy",
+        )
+
+    @unittest.skipUnless(PROJECT_NUMBER, "PROJECT_NUMBER not set in environment.")
+    @unittest.skipUnless(
+        INSIDE_IP, "GOOGLE_CLOUD_TESTS_VPCSC_INSIDE_IP not set in environment."
+    )
+    def test_inside_ip_address_allowed(self):
+        headers = {
+            "Content-Type": "application/json",
+            "X-User-IP": INSIDE_IP,
+            "X-Google-GFE-Cloud-Client-Network-Project-Number": PROJECT_NUMBER,
+        }
+        r = requests.post(url=self.url, data=json.dumps(self.body), headers=headers)
+        operation = json.loads(r.text)
+        # Assert it returns non-empty operation name.
+        self.assertNotEqual(operation["name"], "")
diff --git a/videointelligence/tests/unit/gapic/v1/test_video_intelligence_service_client_v1.py b/videointelligence/tests/unit/gapic/v1/test_video_intelligence_service_client_v1.py
new file mode 100644
index 000000000000..fca6c1e165bd
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1/test_video_intelligence_service_client_v1.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import videointelligence_v1
+from google.cloud.videointelligence_v1 import enums
+from google.cloud.videointelligence_v1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestVideoIntelligenceServiceClient(object):
+    def test_annotate_video(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = video_intelligence_pb2.AnnotateVideoResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/videointelligence/tests/unit/gapic/v1beta1/test_video_intelligence_service_client_v1beta1.py b/videointelligence/tests/unit/gapic/v1beta1/test_video_intelligence_service_client_v1beta1.py
new file mode 100644
index 000000000000..27926f1cf767
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1beta1/test_video_intelligence_service_client_v1beta1.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import videointelligence_v1beta1
+from google.cloud.videointelligence_v1beta1 import enums
+from google.cloud.videointelligence_v1beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestVideoIntelligenceServiceClient(object):
+    def test_annotate_video(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = video_intelligence_pb2.AnnotateVideoResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri, features)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri, features)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/videointelligence/tests/unit/gapic/v1beta2/test_video_intelligence_service_client_v1beta2.py b/videointelligence/tests/unit/gapic/v1beta2/test_video_intelligence_service_client_v1beta2.py
new file mode 100644
index 000000000000..df1c2d2a7785
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1beta2/test_video_intelligence_service_client_v1beta2.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import videointelligence_v1beta2
+from google.cloud.videointelligence_v1beta2 import enums
+from google.cloud.videointelligence_v1beta2.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestVideoIntelligenceServiceClient(object):
+    def test_annotate_video(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = video_intelligence_pb2.AnnotateVideoResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1beta2.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1beta2.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/videointelligence/tests/unit/gapic/v1p1beta1/test_video_intelligence_service_client_v1p1beta1.py b/videointelligence/tests/unit/gapic/v1p1beta1/test_video_intelligence_service_client_v1p1beta1.py
new file mode 100644
index 000000000000..5d7ee10784e8
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1p1beta1/test_video_intelligence_service_client_v1p1beta1.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import videointelligence_v1p1beta1
+from google.cloud.videointelligence_v1p1beta1 import enums
+from google.cloud.videointelligence_v1p1beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestVideoIntelligenceServiceClient(object):
+    def test_annotate_video(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = video_intelligence_pb2.AnnotateVideoResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1p1beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1p1beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/videointelligence/tests/unit/gapic/v1p2beta1/test_video_intelligence_service_client_v1p2beta1.py b/videointelligence/tests/unit/gapic/v1p2beta1/test_video_intelligence_service_client_v1p2beta1.py
new file mode 100644
index 000000000000..5bc061fbd2e7
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1p2beta1/test_video_intelligence_service_client_v1p2beta1.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import videointelligence_v1p2beta1
+from google.cloud.videointelligence_v1p2beta1 import enums
+from google.cloud.videointelligence_v1p2beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestVideoIntelligenceServiceClient(object):
+    def test_annotate_video(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = video_intelligence_pb2.AnnotateVideoResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1p2beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1p2beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/videointelligence/tests/unit/gapic/v1p3beta1/test_streaming_video_intelligence_service_client_v1p3beta1.py b/videointelligence/tests/unit/gapic/v1p3beta1/test_streaming_video_intelligence_service_client_v1p3beta1.py
new file mode 100644
index 000000000000..0bc5741c22d5
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1p3beta1/test_streaming_video_intelligence_service_client_v1p3beta1.py
@@ -0,0 +1,115 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import videointelligence_v1p3beta1
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def stream_stream(
+        self, method, request_serializer=None, response_deserializer=None
+    ):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestStreamingVideoIntelligenceServiceClient(object):
+    def test_streaming_annotate_video(self):
+        # Setup Expected Response
+        annotation_results_uri = "annotationResultsUri-238075757"
+        expected_response = {"annotation_results_uri": annotation_results_uri}
+        expected_response = video_intelligence_pb2.StreamingAnnotateVideoResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[iter([expected_response])])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = (
+                videointelligence_v1p3beta1.StreamingVideoIntelligenceServiceClient()
+            )
+
+        # Setup Request
+        request = {}
+        request = video_intelligence_pb2.StreamingAnnotateVideoRequest(**request)
+        requests = [request]
+
+        response = client.streaming_annotate_video(requests)
+        resources = list(response)
+        assert len(resources) == 1
+        assert expected_response == resources[0]
+
+        assert len(channel.requests) == 1
+        actual_requests = channel.requests[0][1]
+        assert len(actual_requests) == 1
+        actual_request = list(actual_requests)[0]
+        assert request == actual_request
+
+    def test_streaming_annotate_video_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = (
+                videointelligence_v1p3beta1.StreamingVideoIntelligenceServiceClient()
+            )
+
+        # Setup request
+        request = {}
+
+        request = video_intelligence_pb2.StreamingAnnotateVideoRequest(**request)
+        requests = [request]
+
+        with pytest.raises(CustomException):
+            client.streaming_annotate_video(requests)
diff --git a/videointelligence/tests/unit/gapic/v1p3beta1/test_video_intelligence_service_client_v1p3beta1.py b/videointelligence/tests/unit/gapic/v1p3beta1/test_video_intelligence_service_client_v1p3beta1.py
new file mode 100644
index 000000000000..5fac526d8678
--- /dev/null
+++ b/videointelligence/tests/unit/gapic/v1p3beta1/test_video_intelligence_service_client_v1p3beta1.py
@@ -0,0 +1,123 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import videointelligence_v1p3beta1
+from google.cloud.videointelligence_v1p3beta1 import enums
+from google.cloud.videointelligence_v1p3beta1.proto import video_intelligence_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestVideoIntelligenceServiceClient(object):
+    def test_annotate_video(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = video_intelligence_pb2.AnnotateVideoResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1p3beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = video_intelligence_pb2.AnnotateVideoRequest(
+            input_uri=input_uri, features=features
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_annotate_video_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_annotate_video_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = videointelligence_v1p3beta1.VideoIntelligenceServiceClient()
+
+        # Setup Request
+        input_uri = "gs://cloud-samples-data/video/cat.mp4"
+        features_element = enums.Feature.LABEL_DETECTION
+        features = [features_element]
+
+        response = client.annotate_video(input_uri=input_uri, features=features)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/.coveragerc b/vision/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/vision/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/vision/.flake8 b/vision/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/vision/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/vision/.repo-metadata.json b/vision/.repo-metadata.json
new file mode 100644
index 000000000000..2916236c51d2
--- /dev/null
+++ b/vision/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "vision",
+  "name_pretty": "Cloud Vision",
+  "product_documentation": "https://cloud.google.com/vision/docs/",
+  "client_documentation": "https://googleapis.dev/python/vision/latest",
+  "issue_tracker": "https://issuetracker.google.com/issues?q=status:open%20componentid:187174",
+  "release_level": "beta",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-vision",
+  "api_id": "vision.googleapis.com",
+  "requires_billing": false
+}
\ No newline at end of file
diff --git a/vision/CHANGELOG.md b/vision/CHANGELOG.md
new file mode 100644
index 000000000000..fe4ee32e382c
--- /dev/null
+++ b/vision/CHANGELOG.md
@@ -0,0 +1,245 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-vision/#history
+
+## 0.39.0
+
+08-12-2019 13:57 PDT
+
+### Implementation Changes
+- Remove send/recv msg size limit (via synth). ([#8976](https://github.com/googleapis/google-cloud-python/pull/8976))
+
+### New Features
+- Add 'parent' argument to annotation requests; add 'ProductSearchClient.purge_products' method; add 'object_annotations' field to product search results (via synth). ([#8988](https://github.com/googleapis/google-cloud-python/pull/8988))
+
+### Documentation
+- Update intersphinx mapping for requests. ([#8805](https://github.com/googleapis/google-cloud-python/pull/8805))
+
+## 0.38.1
+
+07-24-2019 17:54 PDT
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+## 0.38.0
+
+07-09-2019 10:05 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8411](https://github.com/googleapis/google-cloud-python/pull/8411))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8529](https://github.com/googleapis/google-cloud-python/pull/8529))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8602](https://github.com/googleapis/google-cloud-python/pull/8602))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- All of the negative vision vpc sc tests should use the same file. ([#8439](https://github.com/googleapis/google-cloud-python/pull/8439))
+- In order to make sure access to the bucket is blocked by vpc sc, try to download any arbitrary file from the bucket. ([#8374](https://github.com/googleapis/google-cloud-python/pull/8374))
+- Add disclaimer to auto-generated template files (via synth). ([#8335](https://github.com/googleapis/google-cloud-python/pull/8335))
+- Add Vision API system tests to verify accessing a gcs bucket outside of a secure perimeter is blocked. ([#8276](https://github.com/googleapis/google-cloud-python/pull/8276))
+- Add Vision API Product Search tests to verify ProductSearch is blocked by VPC SC when trying to access a resource outside of a secure perimeter when run from within a secure perimeter. ([#8269](https://github.com/googleapis/google-cloud-python/pull/8269))
+- Add AsyncBatchAnnotateFiles system test ([#8260](https://github.com/googleapis/google-cloud-python/pull/8260))
+- Add ImportProductSets system test ([#8259](https://github.com/googleapis/google-cloud-python/pull/8259))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8257](https://github.com/googleapis/google-cloud-python/pull/8257))
+- Declare encoding as utf-8 in pb2 files (via synth).  ([#8371](https://github.com/googleapis/google-cloud-python/pull/8371))
+
+## 0.37.0
+
+05-30-2019 15:19 PDT
+
+### Implementation Changes
+- Add routing header to method metadata (via synth).  ([#7604](https://github.com/googleapis/google-cloud-python/pull/7604))
+
+### New Features
+- Add more categories to product search, update noxfile (via synth). ([#8170](https://github.com/googleapis/google-cloud-python/pull/8170))
+- Add batch annotation for images and files, reorder methods (via synth).  ([#7845](https://github.com/googleapis/google-cloud-python/pull/7845))
+- Vision: Add proto files for v1p4beta1
+
+### Internal / Testing Changes
+- Change docstrings (via synth). ([#7983](https://github.com/googleapis/google-cloud-python/pull/7983))
+- Add system tests for Vision Product Search. Test product set resource… ([#7913](https://github.com/googleapis/google-cloud-python/pull/7913))
+-  Update noxfile and docs configuration (via synth). ([#7839](https://github.com/googleapis/google-cloud-python/pull/7839))
+- Vision: Add nox session `docs`, reorder methods, modify samples in docstrings (via synth). ([#7787](https://github.com/googleapis/google-cloud-python/pull/7787))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Copy lintified proto files (via synth). ([#7473](https://github.com/googleapis/google-cloud-python/pull/7473))
+
+## 0.36.0
+
+02-25-2019 15:02 PST
+
+
+### Implementation Changes
+- Remove unused message exports. ([#7280](https://github.com/googleapis/google-cloud-python/pull/7280))
+- Protoc-generated serialization update. ([#7100](https://github.com/googleapis/google-cloud-python/pull/7100))
+- GAPIC generation fixes: ([#7058](https://github.com/googleapis/google-cloud-python/pull/7058))
+- Pick up order-of-enum fix from GAPIC generator. ([#6881](https://github.com/googleapis/google-cloud-python/pull/6881))
+
+### New Features
+- Add vision v1p4beta1. ([#7438](https://github.com/googleapis/google-cloud-python/pull/7438))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers.
+
+### Internal / Testing Changes
+- Add clarifying comment to blacken nox target. ([#7408](https://github.com/googleapis/google-cloud-python/pull/7408))
+- Copy proto files alongside protoc versions
+- Vision: get system logo tests healthy. ([#7245](https://github.com/googleapis/google-cloud-python/pull/7245))
+- Add protos as an artifact to library. ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.35.2
+
+12-17-2018 17:10 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+
+### Internal / Testing Changes
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+
+## 0.35.1
+
+11-21-2018 11:25 PST
+
+### Implementation Changes
+- Add ProductSearchClient to vision.py ([#6635](https://github.com/googleapis/google-cloud-python/pull/6635))
+
+### Internal / Testing Changes
+- Merge fixes to GAPIC generator. ([#6632](https://github.com/googleapis/google-cloud-python/pull/6632))
+
+## 0.35.0
+
+11-13-2018 09:55 PST
+
+
+### Implementation Changes
+- Fix client_info bug, update docstrings via synth. ([#6437](https://github.com/googleapis/google-cloud-python/pull/6437))
+
+### New Features
+- Add 'product_search_client' to 'vision_v1'. ([#6361](https://github.com/googleapis/google-cloud-python/pull/6361))
+
+### Dependencies
+- Bump minimum 'api_core' version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Fix GAX fossils. ([#6264](https://github.com/googleapis/google-cloud-python/pull/6264))
+- Normalize use of support level badges. ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Harmonize / DRY 'README.rst' / 'docs/index.rst'. ([#6003](https://github.com/googleapis/google-cloud-python/pull/6003))
+
+### Internal / Testing Changes
+- Use new Nox. ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+
+## 0.34.0
+
+### Implementation Changes
+
+- Clean up feature introspection. ([#5851](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5851))
+
+### New Features
+
+- Regenerate to pick up new features in the underlying API. ([#5854](https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5854))
+
+## 0.33.0
+
+### New Features
+- Add v1p3beta1 endpoint to vision client library (#5638)
+
+## 0.32.0
+
+### Implementation Changes
+- Avoid overwriting '__module__' of messages from shared modules. (#5364)
+- Regenerate underlying client library (#5467)
+
+### Internal / Testing Changes
+- Add Test runs for Python 3.7 and remove 3.4 (#5295)
+- Modify system tests to use prerelease versions of grpcio (#5304)
+
+## 0.31.1
+
+### Packaging
+- Update setuptools before packaging (#5265)
+
+## 0.31.0
+
+- Vision v1p2beta1: PDF/TIFF OCR (#5127)
+- Use `install_requires` for platform dependencies instead of `extras_require` (#4991)
+- Add vision v1p2beta1 (#4998)
+- Fix bad trove classifier
+- Add max results to feature (#4817)
+
+## 0.30.1
+
+### Dependencies
+
+- Update dependency range for api-core to include v1.0.0 releases (#4944)
+
+### Testing and internal changes
+
+- Install local dependencies when running lint (#4936)
+- Re-enable lint for tests, remove usage of pylint (#4921)
+- Normalize all setup.py files (#4909)
+- Fix coveragerc to correctly omit generated files (#4843)
+
+## 0.29.0
+
+### :warning: Breaking Changes
+
+- The HTTP/JSON based client that was deprecated in 0.25.0 is completely
+  removed.
+
+### Release Candidate
+
+- This is the (hopefully) final release candidate before declaring a stable
+  release.
+
+### Features
+
+- The `v1p1beta1` endpoint has been added. (#4493)
+
+  This is a superset of `v1` and includes features that are still in beta
+  on the API side. You can opt in to this endpoint by importing it explicitly:
+
+  ```python
+  from google.cloud import vision_v1p1beta1
+  client = vision_v1p1beta1.ImageAnnotatorClient()
+  ```
+
+PyPI: https://pypi.org/project/google-cloud-vision/0.29.0/
+
+
+## 0.28.0
+
+### Notable Implementation Changes
+
+- Update and re-organize autogenerated code (#3952)
+
+### Documentation
+
+- Added link to "Python Development Environment Setup Guide" in
+  project README (#4187, h/t to @michaelawyu)
+
+### Dependencies
+
+- Upgrading to `google-cloud-core >= 0.28.0` and adding dependency
+  on `google-api-core` (#4221, #4280)
+- Deferring to `google-api-core` for `grpcio` and
+  `googleapis-common-protos`dependencies (#4096, #4098)
+
+PyPI: https://pypi.org/project/google-cloud-vision/0.28.0/
diff --git a/vision/LICENSE b/vision/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/vision/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/vision/MANIFEST.in b/vision/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/vision/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/vision/README.rst b/vision/README.rst
new file mode 100644
index 000000000000..2b9672e62edf
--- /dev/null
+++ b/vision/README.rst
@@ -0,0 +1,112 @@
+Python Client for Google Cloud Vision
+=====================================
+
+|beta| |pypi| |versions| 
+
+The `Google Cloud Vision`_  API enables developers to
+understand the content of an image by encapsulating powerful machine
+learning models in an easy to use REST API. It quickly classifies images
+into thousands of categories (e.g., "sailboat", "lion", "Eiffel Tower"),
+detects individual objects and faces within images, and finds and reads
+printed words contained within images. You can build metadata on your
+image catalog, moderate offensive content, or enable new marketing
+scenarios through image sentiment analysis. Analyze images uploaded
+in the request or integrate with your image storage on Google Cloud
+Storage.
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |beta| image:: https://img.shields.io/badge/support-beta-silver.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-vision.svg
+   :target: https://pypi.org/project/google-cloud-vision/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-vision.svg
+   :target: https://pypi.org/project/google-cloud-vision/
+.. _Vision: https://cloud.google.com/vision/
+
+.. _Google Cloud Vision: https://cloud.google.com/vision/
+.. _Client Library Documentation: https://googleapis.dev/python/vision/latest
+.. _Product Documentation: https://cloud.google.com/vision/reference/rest/
+
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Google Cloud Vision API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Google Cloud Vision API.:  https://cloud.google.com/vision
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^
+Python >= 3.5
+
+Deprecated Python Versions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-vision
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-vision
+
+
+Example Usage
+~~~~~~~~~~~~~
+
+.. code-block:: python
+
+   from google.cloud import vision
+
+   client = vision.ImageAnnotatorClient()
+   response = client.annotate_image({
+     'image': {'source': {'image_uri': 'gs://my-test-bucket/image.jpg'}},
+     'features': [{'type': vision.enums.Feature.Type.FACE_DETECTION}],
+   })
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Google Cloud Vision API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/vision/docs/README.rst b/vision/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/vision/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/vision/docs/changelog.md b/vision/docs/changelog.md
new file mode 120000
index 000000000000..235fc031a209
--- /dev/null
+++ b/vision/docs/changelog.md
@@ -0,0 +1 @@
+../../vision/CHANGELOG.md
\ No newline at end of file
diff --git a/vision/docs/conf.py b/vision/docs/conf.py
new file mode 100644
index 000000000000..d175e41d7fc9
--- /dev/null
+++ b/vision/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-vision documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-vision"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-vision-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-vision.tex",
+        u"google-cloud-vision Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-vision",
+        u"google-cloud-vision Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-vision",
+        u"google-cloud-vision Documentation",
+        author,
+        "google-cloud-vision",
+        "GAPIC library for the {metadata.shortName} v1p4beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/vision/docs/gapic/v1/api.rst b/vision/docs/gapic/v1/api.rst
new file mode 100644
index 000000000000..85835a0fa34d
--- /dev/null
+++ b/vision/docs/gapic/v1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Vision API
+===========================
+
+.. automodule:: google.cloud.vision_v1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1/types.rst b/vision/docs/gapic/v1/types.rst
new file mode 100644
index 000000000000..9d8a9cce4bf2
--- /dev/null
+++ b/vision/docs/gapic/v1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Vision API Client
+=================================
+
+.. automodule:: google.cloud.vision_v1.types
+    :members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1p2beta1/api.rst b/vision/docs/gapic/v1p2beta1/api.rst
new file mode 100644
index 000000000000..1214abc971ff
--- /dev/null
+++ b/vision/docs/gapic/v1p2beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Google Cloud Vision API
+==================================
+
+.. automodule:: google.cloud.vision_v1p2beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1p2beta1/types.rst b/vision/docs/gapic/v1p2beta1/types.rst
new file mode 100644
index 000000000000..5099b68a3bc2
--- /dev/null
+++ b/vision/docs/gapic/v1p2beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Google Cloud Vision API Client
+========================================
+
+.. automodule:: google.cloud.vision_v1p2beta1.types
+    :members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1p3beta1/api.rst b/vision/docs/gapic/v1p3beta1/api.rst
new file mode 100644
index 000000000000..d04d9d99d949
--- /dev/null
+++ b/vision/docs/gapic/v1p3beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Vision API
+===========================
+
+.. automodule:: google.cloud.vision_v1p3beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1p3beta1/types.rst b/vision/docs/gapic/v1p3beta1/types.rst
new file mode 100644
index 000000000000..3658d2d46ad7
--- /dev/null
+++ b/vision/docs/gapic/v1p3beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Vision API Client
+=================================
+
+.. automodule:: google.cloud.vision_v1p3beta1.types
+    :members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1p4beta1/api.rst b/vision/docs/gapic/v1p4beta1/api.rst
new file mode 100644
index 000000000000..b04fc7eab60f
--- /dev/null
+++ b/vision/docs/gapic/v1p4beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Cloud Vision API
+===========================
+
+.. automodule:: google.cloud.vision_v1p4beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/vision/docs/gapic/v1p4beta1/types.rst b/vision/docs/gapic/v1p4beta1/types.rst
new file mode 100644
index 000000000000..43f20e9d297e
--- /dev/null
+++ b/vision/docs/gapic/v1p4beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Cloud Vision API Client
+=================================
+
+.. automodule:: google.cloud.vision_v1p4beta1.types
+    :members:
\ No newline at end of file
diff --git a/vision/docs/index.rst b/vision/docs/index.rst
new file mode 100644
index 000000000000..3bc60512c87d
--- /dev/null
+++ b/vision/docs/index.rst
@@ -0,0 +1,126 @@
+.. include:: README.rst
+
+Using the Library
+-----------------
+
+Annotate an Image
+~~~~~~~~~~~~~~~~~
+
+You can call the :meth:`annotate_image` method directly:
+
+.. code-block:: python
+
+    >>> from google.cloud import vision
+    >>> client = vision.ImageAnnotatorClient()
+    >>> response = client.annotate_image({
+    ...   'image': {'source': {'image_uri': 'gs://my-test-bucket/image.jpg'}},
+    ...   'features': [{'type': vision.enums.Feature.Type.FACE_DETECTION}],
+    ... })
+    >>> len(response.annotations)
+    2
+    >>> for face in response.annotations[0].faces:
+    ...     print(face.joy)
+    Likelihood.VERY_LIKELY
+    Likelihood.VERY_LIKELY
+    Likelihood.VERY_LIKELY
+    >>> for logo in response.annotations[0].logos:
+    ...     print(logo.description)
+    'google'
+    'github'
+
+
+Single-feature Shortcuts
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you are only requesting a single feature, you may find it easier to ask
+for it using our direct methods:
+
+.. code-block:: python
+
+    >>> from google.cloud import vision
+    >>> client = vision.ImageAnnotatorClient()
+    >>> response = client.face_detection({
+    ...   'source': {'image_uri': 'gs://my-test-bucket/image.jpg'},
+    ... })
+    >>> len(response.annotations)
+    1
+    >>> for face in response.annotations[0].faces:
+    ...     print(face.joy)
+    Likelihood.VERY_LIKELY
+    Likelihood.VERY_LIKELY
+    Likelihood.VERY_LIKELY
+
+
+No results found
+~~~~~~~~~~~~~~~~
+
+If no results for the detection performed can be extracted from the image, then
+an empty list is returned. This behavior is similar with all detection types.
+
+
+Example with :meth:`~google.cloud.vision.ImageAnnotatorClient.logo_detection`:
+
+.. code-block:: python
+
+    >>> from google.cloud import vision
+    >>> client = vision.ImageAnnotatorClient()
+    >>> with open('./image.jpg', 'rb') as image_file:
+    ...     content = image_file.read()
+    >>> response = client.logo_detection({
+    ...     'content': content,
+    ... })
+    >>> len(response.annotations)
+    0
+
+API Reference
+-------------
+
+This package includes clients for multiple versions of the Vision
+API. By default, you will get ``v1``, the latest stable version.
+
+.. toctree::
+  :maxdepth: 2
+
+  gapic/v1/api
+  gapic/v1/types
+
+
+A new beta release with additional features over the current stable version,
+spelled ``v1p4beta1``, is provided to allow you to use these new features.
+These are expected to move into the stable release soon; until then, the
+usual beta admonishment (changes are possible, etc.) applies.
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1p4beta1/api
+    gapic/v1p4beta1/types
+
+Previous beta releases ``v1p3beta1`` and ``v1p2beta1`` are provided as well.
+
+An API and type reference is provided for ``v1p3beta1``:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1p3beta1/api
+    gapic/v1p3beta1/types
+
+
+An API and type reference is provided for ``v1p2beta1``:
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1p2beta1/api
+    gapic/v1p2beta1/types
+
+Changelog
+---------
+
+For a list of all ``google-cloud-vision`` releases:
+
+.. toctree::
+  :maxdepth: 2
+
+  changelog
diff --git a/vision/google/__init__.py b/vision/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/vision/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/vision/google/cloud/__init__.py b/vision/google/cloud/__init__.py
new file mode 100644
index 000000000000..0e1bc5131ba6
--- /dev/null
+++ b/vision/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# Copyright 2016 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/vision/google/cloud/vision.py b/vision/google/cloud/vision.py
new file mode 100644
index 000000000000..99c0b460cecb
--- /dev/null
+++ b/vision/google/cloud/vision.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from google.cloud.vision_v1 import ImageAnnotatorClient
+from google.cloud.vision_v1 import ProductSearchClient
+from google.cloud.vision_v1 import enums
+from google.cloud.vision_v1 import types
+
+__all__ = ("enums", "types", "ImageAnnotatorClient", "ProductSearchClient")
diff --git a/vision/google/cloud/vision_helpers/__init__.py b/vision/google/cloud/vision_helpers/__init__.py
new file mode 100644
index 000000000000..b89166476b71
--- /dev/null
+++ b/vision/google/cloud/vision_helpers/__init__.py
@@ -0,0 +1,83 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+import io
+
+from google.api_core import protobuf_helpers as protobuf
+
+
+class VisionHelpers(object):
+    """A set of convenience methods to make the Vision GAPIC easier to use.
+
+    This class should be considered abstract; it is used as a superclass
+    in a multiple-inheritance construction alongside the applicable GAPIC.
+    See the :class:`~google.cloud.vision_v1.ImageAnnotatorClient`.
+    """
+
+    def annotate_image(self, request, retry=None, timeout=None):
+        """Run image detection and annotation for an image.
+
+        Example:
+            >>> from google.cloud.vision_v1 import ImageAnnotatorClient
+            >>> client = ImageAnnotatorClient()
+            >>> request = {
+            ...     'image': {
+            ...         'source': {'image_uri': 'https://foo.com/image.jpg'},
+            ...     },
+            ... }
+            >>> response = client.annotate_image(request)
+
+        Args:
+            request (:class:`~.vision_v1.types.AnnotateImageRequest`)
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will not
+                be retried.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+
+        Returns:
+            :class:`~.vision_v1.types.AnnotateImageResponse` The API response.
+        """
+        # If the image is a file handler, set the content.
+        image = protobuf.get(request, "image")
+        if hasattr(image, "read"):
+            img_bytes = image.read()
+            protobuf.set(request, "image", {})
+            protobuf.set(request, "image.content", img_bytes)
+            image = protobuf.get(request, "image")
+
+        # If a filename is provided, read the file.
+        filename = protobuf.get(image, "source.filename", default=None)
+        if filename:
+            with io.open(filename, "rb") as img_file:
+                protobuf.set(request, "image.content", img_file.read())
+                protobuf.set(request, "image.source", None)
+
+        # This method allows features not to be specified, and you get all
+        # of them.
+        protobuf.setdefault(request, "features", self._get_all_features())
+        r = self.batch_annotate_images([request], retry=retry, timeout=timeout)
+        return r.responses[0]
+
+    def _get_all_features(self):
+        """Return a list of all features.
+
+        Returns:
+            list: A list of all available features.
+        """
+        return [
+            {"type": feature} for feature in self.enums.Feature.Type if feature != 0
+        ]
diff --git a/vision/google/cloud/vision_helpers/decorators.py b/vision/google/cloud/vision_helpers/decorators.py
new file mode 100644
index 000000000000..804a171c74f5
--- /dev/null
+++ b/vision/google/cloud/vision_helpers/decorators.py
@@ -0,0 +1,109 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+
+
+def add_single_feature_methods(cls):
+    """Custom decorator intended for :class:`~vision.helpers.VisionHelpers`.
+
+    This metaclass adds a `{feature}` method for every feature
+    defined on the Feature enum.
+    """
+    # Sanity check: This only makes sense if we are building the GAPIC
+    # subclass and have enums already attached.
+    if not hasattr(cls, "enums"):
+        return cls
+
+    # Add each single-feature method to the class.
+    for feature in cls.enums.Feature.Type:
+        # Sanity check: Do not make a method for the falsy feature.
+        if feature.name == "TYPE_UNSPECIFIED":
+            continue
+
+        # Assign the appropriate metadata to the function.
+        detect = _create_single_feature_method(feature)
+
+        # Assign a qualified name to the function, and perform module
+        # replacement on the docstring.
+        detect.__qualname__ = "{cls}.{name}".format(
+            cls=cls.__name__, name=detect.__name__
+        )
+        detect.__doc__ = detect.__doc__.format(module=cls.__module__)
+
+        # Place the function on the class being created.
+        setattr(cls, detect.__name__, detect)
+
+    # Done; return the class.
+    return cls
+
+
+def _create_single_feature_method(feature):
+    """Return a function that will detect a single feature.
+
+    Args:
+        feature (enum): A specific feature defined as a member of
+            :class:`~enums.Feature.Type`.
+
+    Returns:
+        function: A helper function to detect just that feature.
+    """
+    # Define the function properties.
+    fx_name = feature.name.lower()
+    if "detection" in fx_name:
+        fx_doc = "Perform {0}.".format(fx_name.replace("_", " "))
+    else:
+        fx_doc = "Return {desc} information.".format(desc=fx_name.replace("_", " "))
+
+    # Provide a complete docstring with argument and return value
+    # information.
+    fx_doc += """
+
+    Args:
+        image (:class:`~.{module}.types.Image`): The image to analyze.
+        max_results (int):
+            Number of results to return, does not apply for
+            TEXT_DETECTION, DOCUMENT_TEXT_DETECTION, or CROP_HINTS.
+        retry (int): Number of retries to do before giving up.
+        timeout (int): Number of seconds before timing out.
+        kwargs (dict): Additional properties to be set on the
+            :class:`~.{module}.types.AnnotateImageRequest`.
+
+    Returns:
+        :class:`~.{module}.types.AnnotateImageResponse`: The API response.
+    """
+
+    # Get the actual feature value to send.
+    feature_value = {"type": feature}
+
+    # Define the function to be returned.
+    def inner(self, image, max_results=None, retry=None, timeout=None, **kwargs):
+        """Return a single feature annotation for the given image.
+
+        Intended for use with functools.partial, to create the particular
+        single-feature methods.
+        """
+        copied_features = feature_value.copy()
+        if max_results is not None:
+            copied_features["max_results"] = max_results
+        request = dict(image=image, features=[copied_features], **kwargs)
+        response = self.annotate_image(request, retry=retry, timeout=timeout)
+        return response
+
+    # Set the appropriate function metadata.
+    inner.__name__ = fx_name
+    inner.__doc__ = fx_doc
+
+    # Return the final function.
+    return inner
diff --git a/vision/google/cloud/vision_v1/__init__.py b/vision/google/cloud/vision_v1/__init__.py
new file mode 100644
index 000000000000..039c4eeb6bf2
--- /dev/null
+++ b/vision/google/cloud/vision_v1/__init__.py
@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.vision_helpers.decorators import add_single_feature_methods
+from google.cloud.vision_helpers import VisionHelpers
+
+from google.cloud.vision_v1 import types
+from google.cloud.vision_v1.gapic import enums
+from google.cloud.vision_v1.gapic import image_annotator_client as iac
+from google.cloud.vision_v1.gapic import product_search_client
+
+
+@add_single_feature_methods
+class ImageAnnotatorClient(VisionHelpers, iac.ImageAnnotatorClient):
+    __doc__ = iac.ImageAnnotatorClient.__doc__
+    enums = enums
+
+
+class ProductSearchClient(product_search_client.ProductSearchClient):
+    __doc__ = product_search_client.ProductSearchClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ImageAnnotatorClient", "ProductSearchClient")
diff --git a/vision/google/cloud/vision_v1/gapic/__init__.py b/vision/google/cloud/vision_v1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1/gapic/enums.py b/vision/google/cloud/vision_v1/gapic/enums.py
new file mode 100644
index 000000000000..76e1ae0dc9a7
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/enums.py
@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Likelihood(enum.IntEnum):
+    """
+    A bucketized representation of likelihood, which is intended to give clients
+    highly stable results across model upgrades.
+
+    Attributes:
+      UNKNOWN (int): Unknown likelihood.
+      VERY_UNLIKELY (int): It is very unlikely.
+      UNLIKELY (int): It is unlikely.
+      POSSIBLE (int): It is possible.
+      LIKELY (int): It is likely.
+      VERY_LIKELY (int): It is very likely.
+    """
+
+    UNKNOWN = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class BatchOperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Enumerates the possible states that the batch request can be in.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          PROCESSING (int): Request is actively being processed.
+          SUCCESSFUL (int): The request is done and at least one item has been successfully
+          processed.
+          FAILED (int): The request is done and no item has been successfully processed.
+          CANCELLED (int): The request is done after the longrunning.Operations.CancelOperation has
+          been called by the user.  Any records that were processed before the
+          cancel command are output as specified in the request.
+        """
+
+        STATE_UNSPECIFIED = 0
+        PROCESSING = 1
+        SUCCESSFUL = 2
+        FAILED = 3
+        CANCELLED = 4
+
+
+class Block(object):
+    class BlockType(enum.IntEnum):
+        """
+        Type of a block (text, image etc) as identified by OCR.
+
+        Attributes:
+          UNKNOWN (int): Unknown block type.
+          TEXT (int): Regular text block.
+          TABLE (int): Table block.
+          PICTURE (int): Image block.
+          RULER (int): Horizontal/vertical line box.
+          BARCODE (int): Barcode block.
+        """
+
+        UNKNOWN = 0
+        TEXT = 1
+        TABLE = 2
+        PICTURE = 3
+        RULER = 4
+        BARCODE = 5
+
+
+class FaceAnnotation(object):
+    class Landmark(object):
+        class Type(enum.IntEnum):
+            """
+            Face landmark (feature) type. Left and right are defined from the
+            vantage of the viewer of the image without considering mirror
+            projections typical of photos. So, ``LEFT_EYE``, typically, is the
+            person's right eye.
+
+            Attributes:
+              UNKNOWN_LANDMARK (int): Unknown face landmark detected. Should not be filled.
+              LEFT_EYE (int): Left eye.
+              RIGHT_EYE (int): Right eye.
+              LEFT_OF_LEFT_EYEBROW (int): Left of left eyebrow.
+              RIGHT_OF_LEFT_EYEBROW (int): Right of left eyebrow.
+              LEFT_OF_RIGHT_EYEBROW (int): Left of right eyebrow.
+              RIGHT_OF_RIGHT_EYEBROW (int): Right of right eyebrow.
+              MIDPOINT_BETWEEN_EYES (int): Midpoint between eyes.
+              NOSE_TIP (int): Nose tip.
+              UPPER_LIP (int): Upper lip.
+              LOWER_LIP (int): Lower lip.
+              MOUTH_LEFT (int): Mouth left.
+              MOUTH_RIGHT (int): Mouth right.
+              MOUTH_CENTER (int): Mouth center.
+              NOSE_BOTTOM_RIGHT (int): Nose, bottom right.
+              NOSE_BOTTOM_LEFT (int): Nose, bottom left.
+              NOSE_BOTTOM_CENTER (int): Nose, bottom center.
+              LEFT_EYE_TOP_BOUNDARY (int): Left eye, top boundary.
+              LEFT_EYE_RIGHT_CORNER (int): Left eye, right corner.
+              LEFT_EYE_BOTTOM_BOUNDARY (int): Left eye, bottom boundary.
+              LEFT_EYE_LEFT_CORNER (int): Left eye, left corner.
+              RIGHT_EYE_TOP_BOUNDARY (int): Right eye, top boundary.
+              RIGHT_EYE_RIGHT_CORNER (int): Right eye, right corner.
+              RIGHT_EYE_BOTTOM_BOUNDARY (int): Right eye, bottom boundary.
+              RIGHT_EYE_LEFT_CORNER (int): Right eye, left corner.
+              LEFT_EYEBROW_UPPER_MIDPOINT (int): Left eyebrow, upper midpoint.
+              RIGHT_EYEBROW_UPPER_MIDPOINT (int): Right eyebrow, upper midpoint.
+              LEFT_EAR_TRAGION (int): Left ear tragion.
+              RIGHT_EAR_TRAGION (int): Right ear tragion.
+              LEFT_EYE_PUPIL (int): Left eye pupil.
+              RIGHT_EYE_PUPIL (int): Right eye pupil.
+              FOREHEAD_GLABELLA (int): Forehead glabella.
+              CHIN_GNATHION (int): Chin gnathion.
+              CHIN_LEFT_GONION (int): Chin left gonion.
+              CHIN_RIGHT_GONION (int): Chin right gonion.
+            """
+
+            UNKNOWN_LANDMARK = 0
+            LEFT_EYE = 1
+            RIGHT_EYE = 2
+            LEFT_OF_LEFT_EYEBROW = 3
+            RIGHT_OF_LEFT_EYEBROW = 4
+            LEFT_OF_RIGHT_EYEBROW = 5
+            RIGHT_OF_RIGHT_EYEBROW = 6
+            MIDPOINT_BETWEEN_EYES = 7
+            NOSE_TIP = 8
+            UPPER_LIP = 9
+            LOWER_LIP = 10
+            MOUTH_LEFT = 11
+            MOUTH_RIGHT = 12
+            MOUTH_CENTER = 13
+            NOSE_BOTTOM_RIGHT = 14
+            NOSE_BOTTOM_LEFT = 15
+            NOSE_BOTTOM_CENTER = 16
+            LEFT_EYE_TOP_BOUNDARY = 17
+            LEFT_EYE_RIGHT_CORNER = 18
+            LEFT_EYE_BOTTOM_BOUNDARY = 19
+            LEFT_EYE_LEFT_CORNER = 20
+            RIGHT_EYE_TOP_BOUNDARY = 21
+            RIGHT_EYE_RIGHT_CORNER = 22
+            RIGHT_EYE_BOTTOM_BOUNDARY = 23
+            RIGHT_EYE_LEFT_CORNER = 24
+            LEFT_EYEBROW_UPPER_MIDPOINT = 25
+            RIGHT_EYEBROW_UPPER_MIDPOINT = 26
+            LEFT_EAR_TRAGION = 27
+            RIGHT_EAR_TRAGION = 28
+            LEFT_EYE_PUPIL = 29
+            RIGHT_EYE_PUPIL = 30
+            FOREHEAD_GLABELLA = 31
+            CHIN_GNATHION = 32
+            CHIN_LEFT_GONION = 33
+            CHIN_RIGHT_GONION = 34
+
+
+class Feature(object):
+    class Type(enum.IntEnum):
+        """
+        Type of Google Cloud Vision API feature to be extracted.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Unspecified feature type.
+          FACE_DETECTION (int): Run face detection.
+          LANDMARK_DETECTION (int): Run landmark detection.
+          LOGO_DETECTION (int): Run logo detection.
+          LABEL_DETECTION (int): Run label detection.
+          TEXT_DETECTION (int): Run text detection / optical character recognition (OCR). Text detection
+          is optimized for areas of text within a larger image; if the image is a
+          document, use ``DOCUMENT_TEXT_DETECTION`` instead.
+          DOCUMENT_TEXT_DETECTION (int): Run dense text document OCR. Takes precedence when both
+          ``DOCUMENT_TEXT_DETECTION`` and ``TEXT_DETECTION`` are present.
+          SAFE_SEARCH_DETECTION (int): Run Safe Search to detect potentially unsafe
+          or undesirable content.
+          IMAGE_PROPERTIES (int): Compute a set of image properties, such as the
+          image's dominant colors.
+          CROP_HINTS (int): Run crop hints.
+          WEB_DETECTION (int): Run web detection.
+          PRODUCT_SEARCH (int): Run Product Search.
+          OBJECT_LOCALIZATION (int): Run localizer for object detection.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        FACE_DETECTION = 1
+        LANDMARK_DETECTION = 2
+        LOGO_DETECTION = 3
+        LABEL_DETECTION = 4
+        TEXT_DETECTION = 5
+        DOCUMENT_TEXT_DETECTION = 11
+        SAFE_SEARCH_DETECTION = 6
+        IMAGE_PROPERTIES = 7
+        CROP_HINTS = 9
+        WEB_DETECTION = 10
+        PRODUCT_SEARCH = 12
+        OBJECT_LOCALIZATION = 19
+
+
+class OperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Batch operation states.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          CREATED (int): Request is received.
+          RUNNING (int): Request is actively being processed.
+          DONE (int): The batch processing is done.
+          CANCELLED (int): The batch processing was cancelled.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATED = 1
+        RUNNING = 2
+        DONE = 3
+        CANCELLED = 4
+
+
+class TextAnnotation(object):
+    class DetectedBreak(object):
+        class BreakType(enum.IntEnum):
+            """
+            Enum to denote the type of break found. New line, space etc.
+
+            Attributes:
+              UNKNOWN (int): Unknown break label type.
+              SPACE (int): Regular space.
+              SURE_SPACE (int): Sure space (very wide).
+              EOL_SURE_SPACE (int): Line-wrapping break.
+              HYPHEN (int): End-line hyphen that is not present in text; does not co-occur with
+              ``SPACE``, ``LEADER_SPACE``, or ``LINE_BREAK``.
+              LINE_BREAK (int): Line break that ends a paragraph.
+            """
+
+            UNKNOWN = 0
+            SPACE = 1
+            SURE_SPACE = 2
+            EOL_SURE_SPACE = 3
+            HYPHEN = 4
+            LINE_BREAK = 5
diff --git a/vision/google/cloud/vision_v1/gapic/image_annotator_client.py b/vision/google/cloud/vision_v1/gapic/image_annotator_client.py
new file mode 100644
index 000000000000..efe0924da129
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/image_annotator_client.py
@@ -0,0 +1,594 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1 ImageAnnotator API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import grpc
+
+from google.cloud.vision_v1.gapic import enums
+from google.cloud.vision_v1.gapic import image_annotator_client_config
+from google.cloud.vision_v1.gapic.transports import image_annotator_grpc_transport
+from google.cloud.vision_v1.proto import image_annotator_pb2
+from google.cloud.vision_v1.proto import image_annotator_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ImageAnnotatorClient(object):
+    """
+    Service that performs Google Cloud Vision API detection tasks over client
+    images, such as face, landmark, logo, label, and text detection. The
+    ImageAnnotator service returns detected entities from the images.
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1.ImageAnnotator"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ImageAnnotatorClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ImageAnnotatorGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ImageAnnotatorGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = image_annotator_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=image_annotator_grpc_transport.ImageAnnotatorGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = image_annotator_grpc_transport.ImageAnnotatorGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def batch_annotate_images(
+        self,
+        requests,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run image detection and annotation for a batch of images.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_images(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.AnnotateImageRequest`
+            parent (str): 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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.BatchAnnotateImagesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_images,
+                default_retry=self._method_configs["BatchAnnotateImages"].retry,
+                default_timeout=self._method_configs["BatchAnnotateImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateImagesRequest(
+            requests=requests, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_annotate_files(
+        self,
+        requests,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 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.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_files(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1.types.AnnotateFileRequest]]): The list of file annotation requests. Right now we support only one
+                AnnotateFileRequest in BatchAnnotateFilesRequest.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.AnnotateFileRequest`
+            parent (str): 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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.BatchAnnotateFilesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_files" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_files"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_files,
+                default_retry=self._method_configs["BatchAnnotateFiles"].retry,
+                default_timeout=self._method_configs["BatchAnnotateFiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateFilesRequest(
+            requests=requests, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["batch_annotate_files"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def async_batch_annotate_images(
+        self,
+        requests,
+        output_config,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run asynchronous image detection and annotation for a list of images.
+
+        Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateImagesResponse`` (results).
+
+        This service will write image annotation outputs to json files in
+        customer GCS bucket, each json file containing
+        BatchAnnotateImagesResponse proto.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.async_batch_annotate_images(requests, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.AnnotateImageRequest`
+            output_config (Union[dict, ~google.cloud.vision_v1.types.OutputConfig]): Required. The desired output location and metadata (e.g. format).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.OutputConfig`
+            parent (str): 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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "async_batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "async_batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.async_batch_annotate_images,
+                default_retry=self._method_configs["AsyncBatchAnnotateImages"].retry,
+                default_timeout=self._method_configs[
+                    "AsyncBatchAnnotateImages"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.AsyncBatchAnnotateImagesRequest(
+            requests=requests, output_config=output_config, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["async_batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            image_annotator_pb2.AsyncBatchAnnotateImagesResponse,
+            metadata_type=image_annotator_pb2.OperationMetadata,
+        )
+
+    def async_batch_annotate_files(
+        self,
+        requests,
+        parent=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run asynchronous image detection and annotation for a list of generic
+        files, such as PDF files, which may contain multiple pages and multiple
+        images per page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.async_batch_annotate_files(requests)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1.types.AsyncAnnotateFileRequest]]): Individual async file annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.AsyncAnnotateFileRequest`
+            parent (str): 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``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "async_batch_annotate_files" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "async_batch_annotate_files"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.async_batch_annotate_files,
+                default_retry=self._method_configs["AsyncBatchAnnotateFiles"].retry,
+                default_timeout=self._method_configs["AsyncBatchAnnotateFiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(
+            requests=requests, parent=parent
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["async_batch_annotate_files"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            image_annotator_pb2.AsyncBatchAnnotateFilesResponse,
+            metadata_type=image_annotator_pb2.OperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1/gapic/image_annotator_client_config.py b/vision/google/cloud/vision_v1/gapic/image_annotator_client_config.py
new file mode 100644
index 000000000000..f533bb7187f6
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/image_annotator_client_config.py
@@ -0,0 +1,43 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1.ImageAnnotator": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "BatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchAnnotateFiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AsyncBatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AsyncBatchAnnotateFiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1/gapic/product_search_client.py b/vision/google/cloud/vision_v1/gapic/product_search_client.py
new file mode 100644
index 000000000000..4849f0cd6c7f
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/product_search_client.py
@@ -0,0 +1,2021 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1 ProductSearch API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import google.api_core.protobuf_helpers
+import grpc
+
+from google.cloud.vision_v1.gapic import enums
+from google.cloud.vision_v1.gapic import product_search_client_config
+from google.cloud.vision_v1.gapic.transports import product_search_grpc_transport
+from google.cloud.vision_v1.proto import image_annotator_pb2
+from google.cloud.vision_v1.proto import image_annotator_pb2_grpc
+from google.cloud.vision_v1.proto import product_search_service_pb2
+from google.cloud.vision_v1.proto import product_search_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ProductSearchClient(object):
+    """
+    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`` 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`` resources, named
+       ``projects/*/locations/*/products/*``
+
+    -  Each ``Product`` has a collection of ``ReferenceImage`` resources,
+       named ``projects/*/locations/*/products/*/referenceImages/*``
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1.ProductSearch"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ProductSearchClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def product_path(cls, project, location, product):
+        """Return a fully-qualified product string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/products/{product}",
+            project=project,
+            location=location,
+            product=product,
+        )
+
+    @classmethod
+    def product_set_path(cls, project, location, product_set):
+        """Return a fully-qualified product_set string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/productSets/{product_set}",
+            project=project,
+            location=location,
+            product_set=product_set,
+        )
+
+    @classmethod
+    def reference_image_path(cls, project, location, product, reference_image):
+        """Return a fully-qualified reference_image string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}",
+            project=project,
+            location=location,
+            product=product,
+            reference_image=reference_image,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ProductSearchGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ProductSearchGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = product_search_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=product_search_grpc_transport.ProductSearchGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = product_search_grpc_transport.ProductSearchGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_product_set(
+        self,
+        parent,
+        product_set,
+        product_set_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new ProductSet resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing, or is longer
+           than 4096 characters.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `product_set`:
+            >>> product_set = {}
+            >>>
+            >>> response = client.create_product_set(parent, product_set)
+
+        Args:
+            parent (str): The project in which the ProductSet should be created.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product_set (Union[dict, ~google.cloud.vision_v1.types.ProductSet]): The ProductSet to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.ProductSet`
+            product_set_id (str): 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 error is returned with code ALREADY\_EXISTS. Must be at most 128
+                characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_product_set,
+                default_retry=self._method_configs["CreateProductSet"].retry,
+                default_timeout=self._method_configs["CreateProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateProductSetRequest(
+            parent=parent, product_set=product_set, product_set_id=product_set_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_product_sets(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ProductSets in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100, or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_product_sets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_product_sets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project from which ProductSets should be listed.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1.types.ProductSet` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_product_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_product_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_product_sets,
+                default_retry=self._method_configs["ListProductSets"].retry,
+                default_timeout=self._method_configs["ListProductSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductSetsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_product_sets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="product_sets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_product_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> response = client.get_product_set(name)
+
+        Args:
+            name (str): Resource name of the ProductSet to get.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_product_set,
+                default_retry=self._method_configs["GetProductSet"].retry,
+                default_timeout=self._method_configs["GetProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetProductSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_product_set(
+        self,
+        product_set,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Makes changes to a ProductSet resource. Only display\_name can be
+        updated currently.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but missing from the request or longer than 4096 characters.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> # TODO: Initialize `product_set`:
+            >>> product_set = {}
+            >>>
+            >>> response = client.update_product_set(product_set)
+
+        Args:
+            product_set (Union[dict, ~google.cloud.vision_v1.types.ProductSet]): The ProductSet resource which replaces the one on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.ProductSet`
+            update_mask (Union[dict, ~google.cloud.vision_v1.types.FieldMask]): The ``FieldMask`` that specifies which fields to update. If update\_mask
+                isn't specified, all mutable fields are to be updated. Valid mask path
+                is ``display_name``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_product_set,
+                default_retry=self._method_configs["UpdateProductSet"].retry,
+                default_timeout=self._method_configs["UpdateProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.UpdateProductSetRequest(
+            product_set=product_set, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("product_set.name", product_set.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_product_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a ProductSet. Products and ReferenceImages in the
+        ProductSet are not deleted.
+
+        The actual image files are not deleted from Google Cloud Storage.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> client.delete_product_set(name)
+
+        Args:
+            name (str): Resource name of the ProductSet to delete.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_product_set,
+                default_retry=self._method_configs["DeleteProductSet"].retry,
+                default_timeout=self._method_configs["DeleteProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteProductSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_product(
+        self,
+        parent,
+        product,
+        product_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new product resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is longer than 4096
+           characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is missing or invalid.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = {}
+            >>>
+            >>> response = client.create_product(parent, product)
+
+        Args:
+            parent (str): The project in which the Product should be created.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product (Union[dict, ~google.cloud.vision_v1.types.Product]): The product to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.Product`
+            product_id (str): 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 error is returned with code ALREADY\_EXISTS. Must be at most 128
+                characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_product,
+                default_retry=self._method_configs["CreateProduct"].retry,
+                default_timeout=self._method_configs["CreateProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateProductRequest(
+            parent=parent, product=product, product_id=product_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_products(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists products in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_products(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_products(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project OR ProductSet from which Products should be listed.
+
+                Format: ``projects/PROJECT_ID/locations/LOC_ID``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1.types.Product` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_products" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_products"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_products,
+                default_retry=self._method_configs["ListProducts"].retry,
+                default_timeout=self._method_configs["ListProducts"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_products"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="products",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_product(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a Product.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> response = client.get_product(name)
+
+        Args:
+            name (str): Resource name of the Product to get.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_product,
+                default_retry=self._method_configs["GetProduct"].retry,
+                default_timeout=self._method_configs["GetProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetProductRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_product(
+        self,
+        product,
+        update_mask=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Makes changes to a Product resource. Only the ``display_name``,
+        ``description``, and ``labels`` fields can be updated right now.
+
+        If labels are updated, the change will not be reflected in queries until
+        the next index time.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but is missing from the request or longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is present in update\_mask
+           but is longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is present in
+           update\_mask.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = {}
+            >>>
+            >>> response = client.update_product(product)
+
+        Args:
+            product (Union[dict, ~google.cloud.vision_v1.types.Product]): The Product resource which replaces the one on the server.
+                product.name is immutable.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.Product`
+            update_mask (Union[dict, ~google.cloud.vision_v1.types.FieldMask]): The ``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 ``description``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_product,
+                default_retry=self._method_configs["UpdateProduct"].retry,
+                default_timeout=self._method_configs["UpdateProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.UpdateProductRequest(
+            product=product, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("product.name", product.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_product(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a product and its reference images.
+
+        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.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> client.delete_product(name)
+
+        Args:
+            name (str): Resource name of product to delete.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_product,
+                default_retry=self._method_configs["DeleteProduct"].retry,
+                default_timeout=self._method_configs["DeleteProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteProductRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_reference_image(
+        self,
+        parent,
+        reference_image,
+        reference_image_id=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new ReferenceImage resource.
+
+        The ``bounding_poly`` field is optional. If ``bounding_poly`` is not
+        specified, the system will try to detect regions of interest in the
+        image that are compatible with the product\_category on the parent
+        product. If it is specified, detection is ALWAYS skipped. The system
+        converts polygons into non-rotated rectangles.
+
+        Note that the pipeline will resize the image if the image resolution is
+        too large to process (above 50MP).
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if the image\_uri is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if the product does not exist.
+        -  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.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> # TODO: Initialize `reference_image`:
+            >>> reference_image = {}
+            >>>
+            >>> response = client.create_reference_image(parent, reference_image)
+
+        Args:
+            parent (str): Resource name of the product in which to create the reference image.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+            reference_image (Union[dict, ~google.cloud.vision_v1.types.ReferenceImage]): The reference image to create.
+                If an image ID is specified, it is ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.ReferenceImage`
+            reference_image_id (str): 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
+                already in use, an error is returned with code ALREADY\_EXISTS. Must be
+                at most 128 characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.ReferenceImage` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_reference_image,
+                default_retry=self._method_configs["CreateReferenceImage"].retry,
+                default_timeout=self._method_configs["CreateReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateReferenceImageRequest(
+            parent=parent,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_reference_image(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a reference image.
+
+        The image metadata will be deleted right away, but search queries
+        against ProductSets containing the image may still work until all related
+        caches are refreshed.
+
+        The actual image files are not deleted from Google Cloud Storage.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.reference_image_path('[PROJECT]', '[LOCATION]', '[PRODUCT]', '[REFERENCE_IMAGE]')
+            >>>
+            >>> client.delete_reference_image(name)
+
+        Args:
+            name (str): The resource name of the reference image to delete.
+
+                Format is:
+
+                ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_reference_image,
+                default_retry=self._method_configs["DeleteReferenceImage"].retry,
+                default_timeout=self._method_configs["DeleteReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteReferenceImageRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_reference_images(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists reference images.
+
+        Possible errors:
+
+        -  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.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_reference_images(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_reference_images(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the product containing the reference images.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1.types.ReferenceImage` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_reference_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_reference_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_reference_images,
+                default_retry=self._method_configs["ListReferenceImages"].retry,
+                default_timeout=self._method_configs["ListReferenceImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListReferenceImagesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_reference_images"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="reference_images",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_reference_image(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a ReferenceImage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the specified image does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.reference_image_path('[PROJECT]', '[LOCATION]', '[PRODUCT]', '[REFERENCE_IMAGE]')
+            >>>
+            >>> response = client.get_reference_image(name)
+
+        Args:
+            name (str): The resource name of the ReferenceImage to get.
+
+                Format is:
+
+                ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types.ReferenceImage` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_reference_image,
+                default_retry=self._method_configs["GetReferenceImage"].retry,
+                default_timeout=self._method_configs["GetReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetReferenceImageRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def add_product_to_product_set(
+        self,
+        name,
+        product,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Adds a Product to the specified ProductSet. If the Product is already
+        present, no change is made.
+
+        One Product can be added to at most 100 ProductSets.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product or the ProductSet doesn't exist.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>> product = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> client.add_product_to_product_set(name, product)
+
+        Args:
+            name (str): The resource name for the ProductSet to modify.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            product (str): The resource name for the Product to be added to this ProductSet.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "add_product_to_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "add_product_to_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.add_product_to_product_set,
+                default_retry=self._method_configs["AddProductToProductSet"].retry,
+                default_timeout=self._method_configs["AddProductToProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.AddProductToProductSetRequest(
+            name=name, product=product
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["add_product_to_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def remove_product_from_product_set(
+        self,
+        name,
+        product,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Removes a Product from the specified ProductSet.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>> product = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> client.remove_product_from_product_set(name, product)
+
+        Args:
+            name (str): The resource name for the ProductSet to modify.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            product (str): The resource name for the Product to be removed from this ProductSet.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "remove_product_from_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "remove_product_from_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.remove_product_from_product_set,
+                default_retry=self._method_configs["RemoveProductFromProductSet"].retry,
+                default_timeout=self._method_configs[
+                    "RemoveProductFromProductSet"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.RemoveProductFromProductSetRequest(
+            name=name, product=product
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["remove_product_from_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_products_in_product_set(
+        self,
+        name,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the Products in a ProductSet, in an unspecified order. If the
+        ProductSet does not exist, the products field of the response will be
+        empty.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_products_in_product_set(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_products_in_product_set(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The ProductSet resource for which to retrieve Products.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1.types.Product` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_products_in_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_products_in_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_products_in_product_set,
+                default_retry=self._method_configs["ListProductsInProductSet"].retry,
+                default_timeout=self._method_configs[
+                    "ListProductsInProductSet"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductsInProductSetRequest(
+            name=name, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_products_in_product_set"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="products",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def import_product_sets(
+        self,
+        parent,
+        input_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Asynchronous API that imports a list of reference images to specified
+        product sets based on a list of image information.
+
+        The ``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``.
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_product_sets(parent, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The project in which the ProductSets should be imported.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            input_config (Union[dict, ~google.cloud.vision_v1.types.ImportProductSetsInputConfig]): The input content for the list of requests.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.ImportProductSetsInputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_product_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_product_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_product_sets,
+                default_retry=self._method_configs["ImportProductSets"].retry,
+                default_timeout=self._method_configs["ImportProductSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ImportProductSetsRequest(
+            parent=parent, input_config=input_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_product_sets"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            product_search_service_pb2.ImportProductSetsResponse,
+            metadata_type=product_search_service_pb2.BatchOperationMetadata,
+        )
+
+    def purge_products(
+        self,
+        parent,
+        product_set_purge_config=None,
+        delete_orphan_products=None,
+        force=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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`` API can be used to keep track of
+        the progress and results of the request. ``Operation.metadata`` contains
+        ``BatchOperationMetadata``. (progress)
+
+        Example:
+            >>> from google.cloud import vision_v1
+            >>>
+            >>> client = vision_v1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> response = client.purge_products(parent)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The project and location in which the Products should be deleted.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product_set_purge_config (Union[dict, ~google.cloud.vision_v1.types.ProductSetPurgeConfig]): Specify which ProductSet contains the Products to be deleted.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1.types.ProductSetPurgeConfig`
+            delete_orphan_products (bool): If delete\_orphan\_products is true, all Products that are not in any
+                ProductSet will be deleted.
+            force (bool): The default value is false. Override this value to true to actually perform
+                the purge.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "purge_products" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "purge_products"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.purge_products,
+                default_retry=self._method_configs["PurgeProducts"].retry,
+                default_timeout=self._method_configs["PurgeProducts"].timeout,
+                client_info=self._client_info,
+            )
+
+        # Sanity check: We have some fields which are mutually exclusive;
+        # raise ValueError if more than one is sent.
+        google.api_core.protobuf_helpers.check_oneof(
+            product_set_purge_config=product_set_purge_config,
+            delete_orphan_products=delete_orphan_products,
+        )
+
+        request = product_search_service_pb2.PurgeProductsRequest(
+            parent=parent,
+            product_set_purge_config=product_set_purge_config,
+            delete_orphan_products=delete_orphan_products,
+            force=force,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["purge_products"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            empty_pb2.Empty,
+            metadata_type=product_search_service_pb2.BatchOperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1/gapic/product_search_client_config.py b/vision/google/cloud/vision_v1/gapic/product_search_client_config.py
new file mode 100644
index 000000000000..8753ca190b14
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/product_search_client_config.py
@@ -0,0 +1,118 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1.ProductSearch": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProductSets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProducts": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListReferenceImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AddProductToProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "RemoveProductFromProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProductsInProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportProductSets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "PurgeProducts": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1/gapic/transports/__init__.py b/vision/google/cloud/vision_v1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1/gapic/transports/image_annotator_grpc_transport.py b/vision/google/cloud/vision_v1/gapic/transports/image_annotator_grpc_transport.py
new file mode 100644
index 000000000000..5bd4cfc030a4
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/transports/image_annotator_grpc_transport.py
@@ -0,0 +1,191 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1.proto import image_annotator_pb2_grpc
+
+
+class ImageAnnotatorGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1 ImageAnnotator API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "image_annotator_stub": image_annotator_pb2_grpc.ImageAnnotatorStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_images`.
+
+        Run image detection and annotation for a batch of images.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateImages
+
+    @property
+    def batch_annotate_files(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_files`.
+
+        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 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateFiles
+
+    @property
+    def async_batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.async_batch_annotate_images`.
+
+        Run asynchronous image detection and annotation for a list of images.
+
+        Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateImagesResponse`` (results).
+
+        This service will write image annotation outputs to json files in
+        customer GCS bucket, each json file containing
+        BatchAnnotateImagesResponse proto.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].AsyncBatchAnnotateImages
+
+    @property
+    def async_batch_annotate_files(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.async_batch_annotate_files`.
+
+        Run asynchronous image detection and annotation for a list of generic
+        files, such as PDF files, which may contain multiple pages and multiple
+        images per page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].AsyncBatchAnnotateFiles
diff --git a/vision/google/cloud/vision_v1/gapic/transports/product_search_grpc_transport.py b/vision/google/cloud/vision_v1/gapic/transports/product_search_grpc_transport.py
new file mode 100644
index 000000000000..4f042e41a29c
--- /dev/null
+++ b/vision/google/cloud/vision_v1/gapic/transports/product_search_grpc_transport.py
@@ -0,0 +1,510 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1.proto import product_search_service_pb2_grpc
+
+
+class ProductSearchGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1 ProductSearch API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "product_search_stub": product_search_service_pb2_grpc.ProductSearchStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_product_set`.
+
+        Creates and returns a new ProductSet resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing, or is longer
+           than 4096 characters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateProductSet
+
+    @property
+    def list_product_sets(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_product_sets`.
+
+        Lists ProductSets in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100, or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProductSets
+
+    @property
+    def get_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_product_set`.
+
+        Gets information associated with a ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetProductSet
+
+    @property
+    def update_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.update_product_set`.
+
+        Makes changes to a ProductSet resource. Only display\_name can be
+        updated currently.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but missing from the request or longer than 4096 characters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].UpdateProductSet
+
+    @property
+    def delete_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_product_set`.
+
+        Permanently deletes a ProductSet. Products and ReferenceImages in the
+        ProductSet are not deleted.
+
+        The actual image files are not deleted from Google Cloud Storage.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteProductSet
+
+    @property
+    def create_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_product`.
+
+        Creates and returns a new product resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is longer than 4096
+           characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is missing or invalid.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateProduct
+
+    @property
+    def list_products(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_products`.
+
+        Lists products in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProducts
+
+    @property
+    def get_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_product`.
+
+        Gets information associated with a Product.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetProduct
+
+    @property
+    def update_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.update_product`.
+
+        Makes changes to a Product resource. Only the ``display_name``,
+        ``description``, and ``labels`` fields can be updated right now.
+
+        If labels are updated, the change will not be reflected in queries until
+        the next index time.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but is missing from the request or longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is present in update\_mask
+           but is longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is present in
+           update\_mask.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].UpdateProduct
+
+    @property
+    def delete_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_product`.
+
+        Permanently deletes a product and its reference images.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteProduct
+
+    @property
+    def create_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_reference_image`.
+
+        Creates and returns a new ReferenceImage resource.
+
+        The ``bounding_poly`` field is optional. If ``bounding_poly`` is not
+        specified, the system will try to detect regions of interest in the
+        image that are compatible with the product\_category on the parent
+        product. If it is specified, detection is ALWAYS skipped. The system
+        converts polygons into non-rotated rectangles.
+
+        Note that the pipeline will resize the image if the image resolution is
+        too large to process (above 50MP).
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if the image\_uri is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if the product does not exist.
+        -  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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateReferenceImage
+
+    @property
+    def delete_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_reference_image`.
+
+        Permanently deletes a reference image.
+
+        The image metadata will be deleted right away, but search queries
+        against ProductSets containing the image may still work until all related
+        caches are refreshed.
+
+        The actual image files are not deleted from Google Cloud Storage.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteReferenceImage
+
+    @property
+    def list_reference_images(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_reference_images`.
+
+        Lists reference images.
+
+        Possible errors:
+
+        -  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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListReferenceImages
+
+    @property
+    def get_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_reference_image`.
+
+        Gets information associated with a ReferenceImage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the specified image does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetReferenceImage
+
+    @property
+    def add_product_to_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.add_product_to_product_set`.
+
+        Adds a Product to the specified ProductSet. If the Product is already
+        present, no change is made.
+
+        One Product can be added to at most 100 ProductSets.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product or the ProductSet doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].AddProductToProductSet
+
+    @property
+    def remove_product_from_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.remove_product_from_product_set`.
+
+        Removes a Product from the specified ProductSet.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].RemoveProductFromProductSet
+
+    @property
+    def list_products_in_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_products_in_product_set`.
+
+        Lists the Products in a ProductSet, in an unspecified order. If the
+        ProductSet does not exist, the products field of the response will be
+        empty.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProductsInProductSet
+
+    @property
+    def import_product_sets(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.import_product_sets`.
+
+        Asynchronous API that imports a list of reference images to specified
+        product sets based on a list of image information.
+
+        The ``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``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ImportProductSets
+
+    @property
+    def purge_products(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.purge_products`.
+
+        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`` API can be used to keep track of
+        the progress and results of the request. ``Operation.metadata`` contains
+        ``BatchOperationMetadata``. (progress)
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].PurgeProducts
diff --git a/vision/google/cloud/vision_v1/proto/__init__.py b/vision/google/cloud/vision_v1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1/proto/geometry.proto b/vision/google/cloud/vision_v1/proto/geometry.proto
new file mode 100644
index 000000000000..881c8f84edee
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/geometry.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.vision.v1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "GeometryProto";
+option java_package = "com.google.cloud.vision.v1";
+option objc_class_prefix = "GCVN";
+
+// 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;
+}
+
+// A 3D position in the image, used primarily for Face detection landmarks.
+// A valid Position must have both x and y coordinates.
+// The position coordinates are in the same scale as the original image.
+message Position {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+
+  // Z coordinate (or depth).
+  float z = 3;
+}
diff --git a/vision/google/cloud/vision_v1/proto/geometry_pb2.py b/vision/google/cloud/vision_v1/proto/geometry_pb2.py
new file mode 100644
index 000000000000..5a3416e358eb
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/geometry_pb2.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1/proto/geometry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1/proto/geometry.proto",
+    package="google.cloud.vision.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.vision.v1B\rGeometryProtoP\001Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n+google/cloud/vision_v1/proto/geometry.proto\x12\x16google.cloud.vision.v1\x1a\x1cgoogle/api/annotations.proto"\x1e\n\x06Vertex\x12\t\n\x01x\x18\x01 \x01(\x05\x12\t\n\x01y\x18\x02 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"\x87\x01\n\x0c\x42oundingPoly\x12\x30\n\x08vertices\x18\x01 \x03(\x0b\x32\x1e.google.cloud.vision.v1.Vertex\x12\x45\n\x13normalized_vertices\x18\x02 \x03(\x0b\x32(.google.cloud.vision.v1.NormalizedVertex"+\n\x08Position\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02\x12\t\n\x01z\x18\x03 \x01(\x02\x42u\n\x1a\x63om.google.cloud.vision.v1B\rGeometryProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_VERTEX = _descriptor.Descriptor(
+    name="Vertex",
+    full_name="google.cloud.vision.v1.Vertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1.Vertex.x",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1.Vertex.y",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=101,
+    serialized_end=131,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.vision.v1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=133,
+    serialized_end=173,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.vision.v1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.vision.v1.BoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.vision.v1.BoundingPoly.normalized_vertices",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=176,
+    serialized_end=311,
+)
+
+
+_POSITION = _descriptor.Descriptor(
+    name="Position",
+    full_name="google.cloud.vision.v1.Position",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1.Position.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1.Position.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="z",
+            full_name="google.cloud.vision.v1.Position.z",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=313,
+    serialized_end=356,
+)
+
+_BOUNDINGPOLY.fields_by_name["vertices"].message_type = _VERTEX
+_BOUNDINGPOLY.fields_by_name["normalized_vertices"].message_type = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["Vertex"] = _VERTEX
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["Position"] = _POSITION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Vertex = _reflection.GeneratedProtocolMessageType(
+    "Vertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTEX,
+        __module__="google.cloud.vision_v1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Vertex)
+    ),
+)
+_sym_db.RegisterMessage(Vertex)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.vision_v1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.vision_v1.proto.geometry_pb2",
+        __doc__="""A bounding polygon for the detected image annotation.
+  
+  
+  Attributes:
+      vertices:
+          The bounding polygon vertices.
+      normalized_vertices:
+          The bounding polygon normalized vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+Position = _reflection.GeneratedProtocolMessageType(
+    "Position",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSITION,
+        __module__="google.cloud.vision_v1.proto.geometry_pb2",
+        __doc__="""A 3D position in the image, used primarily for Face detection landmarks.
+  A valid Position must have both x and y coordinates. The position
+  coordinates are in the same scale as the original image.
+  
+  
+  Attributes:
+      x:
+          X coordinate.
+      y:
+          Y coordinate.
+      z:
+          Z coordinate (or depth).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Position)
+    ),
+)
+_sym_db.RegisterMessage(Position)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1/proto/geometry_pb2_grpc.py b/vision/google/cloud/vision_v1/proto/geometry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/geometry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1/proto/image_annotator.proto b/vision/google/cloud/vision_v1/proto/image_annotator.proto
new file mode 100644
index 000000000000..e4ca1539350a
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/image_annotator.proto
@@ -0,0 +1,1012 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/vision/v1/geometry.proto";
+import "google/cloud/vision/v1/product_search.proto";
+import "google/cloud/vision/v1/text_annotation.proto";
+import "google/cloud/vision/v1/web_detection.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+import "google/type/latlng.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ImageAnnotatorProto";
+option java_package = "com.google.cloud.vision.v1";
+option objc_class_prefix = "GCVN";
+
+// Service that performs Google Cloud Vision API detection tasks over client
+// 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) {
+    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: "*"
+      }
+    };
+  }
+
+  // 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 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: "/v1/files:annotate"
+      body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*}/files:annotate"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/files:annotate"
+        body: "*"
+      }
+    };
+  }
+
+  // Run asynchronous image detection and annotation for a list of images.
+  //
+  // Progress and results can be retrieved through the
+  // `google.longrunning.Operations` interface.
+  // `Operation.metadata` contains `OperationMetadata` (metadata).
+  // `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+  //
+  // 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) {
+    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: "*"
+      }
+    };
+  }
+
+  // Run asynchronous image detection and annotation for a list of generic
+  // files, such as PDF files, which may contain multiple pages and multiple
+  // images per page. Progress and results can be retrieved through the
+  // `google.longrunning.Operations` interface.
+  // `Operation.metadata` contains `OperationMetadata` (metadata).
+  // `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+  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: "*"
+      }
+    };
+  }
+}
+
+// The type of Google Cloud Vision API detection to perform, and the maximum
+// number of results to return for that type. Multiple `Feature` objects can
+// be specified in the `features` list.
+message Feature {
+  // Type of Google Cloud Vision API feature to be extracted.
+  enum Type {
+    // Unspecified feature type.
+    TYPE_UNSPECIFIED = 0;
+
+    // Run face detection.
+    FACE_DETECTION = 1;
+
+    // Run landmark detection.
+    LANDMARK_DETECTION = 2;
+
+    // Run logo detection.
+    LOGO_DETECTION = 3;
+
+    // Run label detection.
+    LABEL_DETECTION = 4;
+
+    // Run text detection / optical character recognition (OCR). Text detection
+    // is optimized for areas of text within a larger image; if the image is
+    // a document, use `DOCUMENT_TEXT_DETECTION` instead.
+    TEXT_DETECTION = 5;
+
+    // Run dense text document OCR. Takes precedence when both
+    // `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` are present.
+    DOCUMENT_TEXT_DETECTION = 11;
+
+    // Run Safe Search to detect potentially unsafe
+    // or undesirable content.
+    SAFE_SEARCH_DETECTION = 6;
+
+    // Compute a set of image properties, such as the
+    // image's dominant colors.
+    IMAGE_PROPERTIES = 7;
+
+    // Run crop hints.
+    CROP_HINTS = 9;
+
+    // Run web detection.
+    WEB_DETECTION = 10;
+
+    // Run Product Search.
+    PRODUCT_SEARCH = 12;
+
+    // Run localizer for object detection.
+    OBJECT_LOCALIZATION = 19;
+  }
+
+  // The feature type.
+  Type type = 1;
+
+  // Maximum number of results of this type. Does not apply to
+  // `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
+  int32 max_results = 2;
+
+  // Model to use for the feature.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  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.
+  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;
+}
+
+// External image source (Google Cloud Storage or web URL image location).
+message ImageSource {
+  // **Use `image_uri` instead.**
+  //
+  // The 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 gcs_image_uri = 1;
+
+  // The URI of the source image. Can be either:
+  //
+  // 1. A 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.
+  //
+  // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from
+  //    HTTP/HTTPS URLs, Google cannot guarantee that the request will be
+  //    completed. Your request may fail if the specified host denies the
+  //    request (e.g. due to request throttling or DOS prevention), or if Google
+  //    throttles requests to the site for abuse prevention. You should not
+  //    depend on externally-hosted images for production applications.
+  //
+  // When both `gcs_image_uri` and `image_uri` are specified, `image_uri` takes
+  // precedence.
+  string image_uri = 2;
+}
+
+// Client image to perform Google Cloud Vision API tasks over.
+message Image {
+  // 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 content = 1;
+
+  // Google Cloud Storage image location, or publicly-accessible image
+  // URL. If both `content` and `source` are provided for an image, `content`
+  // takes precedence and is used to perform the image annotation request.
+  ImageSource source = 2;
+}
+
+// A face annotation object contains the results of face detection.
+message FaceAnnotation {
+  // A face-specific landmark (for example, a face feature).
+  message Landmark {
+    // Face landmark (feature) type.
+    // Left and right are defined from the vantage of the viewer of the image
+    // without considering mirror projections typical of photos. So, `LEFT_EYE`,
+    // typically, is the person's right eye.
+    enum Type {
+      // Unknown face landmark detected. Should not be filled.
+      UNKNOWN_LANDMARK = 0;
+
+      // Left eye.
+      LEFT_EYE = 1;
+
+      // Right eye.
+      RIGHT_EYE = 2;
+
+      // Left of left eyebrow.
+      LEFT_OF_LEFT_EYEBROW = 3;
+
+      // Right of left eyebrow.
+      RIGHT_OF_LEFT_EYEBROW = 4;
+
+      // Left of right eyebrow.
+      LEFT_OF_RIGHT_EYEBROW = 5;
+
+      // Right of right eyebrow.
+      RIGHT_OF_RIGHT_EYEBROW = 6;
+
+      // Midpoint between eyes.
+      MIDPOINT_BETWEEN_EYES = 7;
+
+      // Nose tip.
+      NOSE_TIP = 8;
+
+      // Upper lip.
+      UPPER_LIP = 9;
+
+      // Lower lip.
+      LOWER_LIP = 10;
+
+      // Mouth left.
+      MOUTH_LEFT = 11;
+
+      // Mouth right.
+      MOUTH_RIGHT = 12;
+
+      // Mouth center.
+      MOUTH_CENTER = 13;
+
+      // Nose, bottom right.
+      NOSE_BOTTOM_RIGHT = 14;
+
+      // Nose, bottom left.
+      NOSE_BOTTOM_LEFT = 15;
+
+      // Nose, bottom center.
+      NOSE_BOTTOM_CENTER = 16;
+
+      // Left eye, top boundary.
+      LEFT_EYE_TOP_BOUNDARY = 17;
+
+      // Left eye, right corner.
+      LEFT_EYE_RIGHT_CORNER = 18;
+
+      // Left eye, bottom boundary.
+      LEFT_EYE_BOTTOM_BOUNDARY = 19;
+
+      // Left eye, left corner.
+      LEFT_EYE_LEFT_CORNER = 20;
+
+      // Right eye, top boundary.
+      RIGHT_EYE_TOP_BOUNDARY = 21;
+
+      // Right eye, right corner.
+      RIGHT_EYE_RIGHT_CORNER = 22;
+
+      // Right eye, bottom boundary.
+      RIGHT_EYE_BOTTOM_BOUNDARY = 23;
+
+      // Right eye, left corner.
+      RIGHT_EYE_LEFT_CORNER = 24;
+
+      // Left eyebrow, upper midpoint.
+      LEFT_EYEBROW_UPPER_MIDPOINT = 25;
+
+      // Right eyebrow, upper midpoint.
+      RIGHT_EYEBROW_UPPER_MIDPOINT = 26;
+
+      // Left ear tragion.
+      LEFT_EAR_TRAGION = 27;
+
+      // Right ear tragion.
+      RIGHT_EAR_TRAGION = 28;
+
+      // Left eye pupil.
+      LEFT_EYE_PUPIL = 29;
+
+      // Right eye pupil.
+      RIGHT_EYE_PUPIL = 30;
+
+      // Forehead glabella.
+      FOREHEAD_GLABELLA = 31;
+
+      // Chin gnathion.
+      CHIN_GNATHION = 32;
+
+      // Chin left gonion.
+      CHIN_LEFT_GONION = 33;
+
+      // Chin right gonion.
+      CHIN_RIGHT_GONION = 34;
+    }
+
+    // Face landmark type.
+    Type type = 3;
+
+    // Face landmark position.
+    Position position = 4;
+  }
+
+  // The bounding polygon around the face. The coordinates of the bounding box
+  // are in the original image's scale.
+  // The bounding box is computed to "frame" the face in accordance with human
+  // expectations. It is based on the landmarker results.
+  // Note that one or more x and/or y coordinates may not be generated in the
+  // `BoundingPoly` (the polygon will be unbounded) if only a partial face
+  // appears in the image to be annotated.
+  BoundingPoly bounding_poly = 1;
+
+  // The `fd_bounding_poly` bounding polygon is tighter than the
+  // `boundingPoly`, and encloses only the skin part of the face. Typically, it
+  // is used to eliminate the face from any image analysis that detects the
+  // "amount of skin" visible in an image. It is not based on the
+  // landmarker results, only on the initial face detection, hence
+  // the <code>fd</code> (face detection) prefix.
+  BoundingPoly fd_bounding_poly = 2;
+
+  // Detected face landmarks.
+  repeated Landmark landmarks = 3;
+
+  // Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
+  // of the face relative to the image vertical about the axis perpendicular to
+  // the face. Range [-180,180].
+  float roll_angle = 4;
+
+  // Yaw angle, which indicates the leftward/rightward angle that the face is
+  // pointing relative to the vertical plane perpendicular to the image. Range
+  // [-180,180].
+  float pan_angle = 5;
+
+  // Pitch angle, which indicates the upwards/downwards angle that the face is
+  // pointing relative to the image's horizontal plane. Range [-180,180].
+  float tilt_angle = 6;
+
+  // Detection confidence. Range [0, 1].
+  float detection_confidence = 7;
+
+  // Face landmarking confidence. Range [0, 1].
+  float landmarking_confidence = 8;
+
+  // Joy likelihood.
+  Likelihood joy_likelihood = 9;
+
+  // Sorrow likelihood.
+  Likelihood sorrow_likelihood = 10;
+
+  // Anger likelihood.
+  Likelihood anger_likelihood = 11;
+
+  // Surprise likelihood.
+  Likelihood surprise_likelihood = 12;
+
+  // Under-exposed likelihood.
+  Likelihood under_exposed_likelihood = 13;
+
+  // Blurred likelihood.
+  Likelihood blurred_likelihood = 14;
+
+  // Headwear likelihood.
+  Likelihood headwear_likelihood = 15;
+}
+
+// Detected entity location information.
+message LocationInfo {
+  // lat/long location coordinates.
+  google.type.LatLng lat_lng = 1;
+}
+
+// A `Property` consists of a user-supplied name/value pair.
+message Property {
+  // Name of the property.
+  string name = 1;
+
+  // Value of the property.
+  string value = 2;
+
+  // Value of numeric properties.
+  uint64 uint64_value = 3;
+}
+
+// Set of detected entity features.
+message EntityAnnotation {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string mid = 1;
+
+  // The language code for the locale in which the entity textual
+  // `description` is expressed.
+  string locale = 2;
+
+  // Entity textual description, expressed in its `locale` language.
+  string description = 3;
+
+  // Overall score of the result. Range [0, 1].
+  float score = 4;
+
+  // **Deprecated. Use `score` instead.**
+  // The accuracy of the entity detection in an image.
+  // For example, for an image in which the "Eiffel Tower" entity is detected,
+  // this field represents the confidence that there is a tower in the query
+  // image. Range [0, 1].
+  float confidence = 5 [deprecated = true];
+
+  // The relevancy of the ICA (Image Content Annotation) label to the
+  // image. For example, the relevancy of "tower" is likely higher to an image
+  // containing the detected "Eiffel Tower" than to an image containing a
+  // detected distant towering building, even though the confidence that
+  // there is a tower in each image may be the same. Range [0, 1].
+  float topicality = 6;
+
+  // Image region to which this entity belongs. Not produced
+  // for `LABEL_DETECTION` features.
+  BoundingPoly bounding_poly = 7;
+
+  // The location information for the detected entity. Multiple
+  // `LocationInfo` elements can be present because one location may
+  // indicate the location of the scene in the image, and another location
+  // may indicate the location of the place where the image was taken.
+  // Location information is usually present for landmarks.
+  repeated LocationInfo locations = 8;
+
+  // Some entities may have optional user-supplied `Property` (name/value)
+  // fields, such a score or string that qualifies the entity.
+  repeated Property properties = 9;
+}
+
+// Set of detected objects with bounding boxes.
+message LocalizedObjectAnnotation {
+  // 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;
+
+  // Image region to which this object belongs. This must be populated.
+  BoundingPoly bounding_poly = 5;
+}
+
+// Set of features pertaining to the image, computed by computer vision
+// methods over safe-search verticals (for example, adult, spoof, medical,
+// violence).
+message SafeSearchAnnotation {
+  // Represents the adult content likelihood for the image. Adult content may
+  // contain elements such as nudity, pornographic images or cartoons, or
+  // sexual activities.
+  Likelihood adult = 1;
+
+  // Spoof likelihood. The likelihood that an modification
+  // was made to the image's canonical version to make it appear
+  // funny or offensive.
+  Likelihood spoof = 2;
+
+  // Likelihood that this is a medical image.
+  Likelihood medical = 3;
+
+  // Likelihood that this image contains violent content.
+  Likelihood violence = 4;
+
+  // Likelihood that the request image contains racy content. Racy content may
+  // include (but is not limited to) skimpy or sheer clothing, strategically
+  // covered nudity, lewd or provocative poses, or close-ups of sensitive
+  // body areas.
+  Likelihood racy = 9;
+}
+
+// Rectangle determined by min and max `LatLng` pairs.
+message LatLongRect {
+  // Min lat/long pair.
+  google.type.LatLng min_lat_lng = 1;
+
+  // Max lat/long pair.
+  google.type.LatLng max_lat_lng = 2;
+}
+
+// Color information consists of RGB channels, score, and the fraction of
+// the image that the color occupies in the image.
+message ColorInfo {
+  // RGB components of the color.
+  google.type.Color color = 1;
+
+  // Image-specific score for this color. Value in range [0, 1].
+  float score = 2;
+
+  // The fraction of pixels the color occupies in the image.
+  // Value in range [0, 1].
+  float pixel_fraction = 3;
+}
+
+// Set of dominant colors and their corresponding scores.
+message DominantColorsAnnotation {
+  // RGB color values with their score and pixel fraction.
+  repeated ColorInfo colors = 1;
+}
+
+// Stores image properties, such as dominant colors.
+message ImageProperties {
+  // If present, dominant colors completed successfully.
+  DominantColorsAnnotation dominant_colors = 1;
+}
+
+// Single crop hint that is used to generate a new crop when serving an image.
+message CropHint {
+  // The bounding polygon for the crop region. The coordinates of the bounding
+  // box are in the original image's scale.
+  BoundingPoly bounding_poly = 1;
+
+  // Confidence of this being a salient region.  Range [0, 1].
+  float confidence = 2;
+
+  // Fraction of importance of this salient region with respect to the original
+  // image.
+  float importance_fraction = 3;
+}
+
+// Set of crop hints that are used to generate new crops when serving images.
+message CropHintsAnnotation {
+  // Crop hint results.
+  repeated CropHint crop_hints = 1;
+}
+
+// Parameters for crop hints annotation request.
+message CropHintsParams {
+  // Aspect ratios in floats, representing the ratio of the width to the height
+  // of the image. For example, if the desired aspect ratio is 4/3, the
+  // corresponding float value should be 1.33333.  If not specified, the
+  // best possible crop is returned. The number of provided aspect ratios is
+  // limited to a maximum of 16; any aspect ratios provided after the 16th are
+  // ignored.
+  repeated float aspect_ratios = 1;
+}
+
+// Parameters for web detection request.
+message WebDetectionParams {
+  // Whether to include results derived from the geo information in the image.
+  bool include_geo_results = 2;
+}
+
+// Image context and/or feature-specific parameters.
+message ImageContext {
+  // Not used.
+  LatLongRect lat_long_rect = 1;
+
+  // List of languages to use for TEXT_DETECTION. 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). Text detection returns an
+  // error if one or more of the specified languages is not one of the
+  // [supported languages](/vision/docs/languages).
+  repeated string language_hints = 2;
+
+  // Parameters for crop hints annotation request.
+  CropHintsParams crop_hints_params = 4;
+
+  // Parameters for product search.
+  ProductSearchParams product_search_params = 5;
+
+  // Parameters for web detection.
+  WebDetectionParams web_detection_params = 6;
+}
+
+// Request for performing Google Cloud Vision API tasks over a user-provided
+// image, with user-requested features, and with context information.
+message AnnotateImageRequest {
+  // The image to be processed.
+  Image image = 1;
+
+  // Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image.
+  ImageContext image_context = 3;
+}
+
+// If an image was produced from a file (e.g. a PDF), this message gives
+// information about the source of that image.
+message ImageAnnotationContext {
+  // The URI of the file used to produce the image.
+  string uri = 1;
+
+  // If the file was a PDF or TIFF, this field gives the page number within
+  // the file used to produce the image.
+  int32 page_number = 2;
+}
+
+// Response to an image annotation request.
+message AnnotateImageResponse {
+  // If present, face detection has completed successfully.
+  repeated FaceAnnotation face_annotations = 1;
+
+  // If present, landmark detection has completed successfully.
+  repeated EntityAnnotation landmark_annotations = 2;
+
+  // If present, logo detection has completed successfully.
+  repeated EntityAnnotation logo_annotations = 3;
+
+  // If present, label detection has completed successfully.
+  repeated EntityAnnotation label_annotations = 4;
+
+  // If present, localized object detection has completed successfully.
+  // This will be sorted descending by confidence score.
+  repeated LocalizedObjectAnnotation localized_object_annotations = 22;
+
+  // If present, text (OCR) detection has completed successfully.
+  repeated EntityAnnotation text_annotations = 5;
+
+  // If present, text (OCR) detection or document (OCR) text detection has
+  // completed successfully.
+  // This annotation provides the structural hierarchy for the OCR detected
+  // text.
+  TextAnnotation full_text_annotation = 12;
+
+  // If present, safe-search annotation has completed successfully.
+  SafeSearchAnnotation safe_search_annotation = 6;
+
+  // If present, image properties were extracted successfully.
+  ImageProperties image_properties_annotation = 8;
+
+  // If present, crop hints have completed successfully.
+  CropHintsAnnotation crop_hints_annotation = 11;
+
+  // If present, web detection has completed successfully.
+  WebDetection web_detection = 13;
+
+  // If present, product search has completed successfully.
+  ProductSearchResults product_search_results = 14;
+
+  // If set, represents the error message for the operation.
+  // Note that filled-in image annotations are guaranteed to be
+  // correct, even when `error` is set.
+  google.rpc.Status error = 9;
+
+  // If present, contextual information is needed to understand where this image
+  // comes from.
+  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. 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;
+}
+
+// Multiple image annotation requests are batched into a single service call.
+message BatchAnnotateImagesRequest {
+  // Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1;
+
+  // 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.
+message BatchAnnotateImagesResponse {
+  // Individual responses to image annotation requests within the batch.
+  repeated AnnotateImageResponse responses = 1;
+}
+
+// A request to annotate one single file, e.g. a PDF, TIFF or GIF file.
+message AnnotateFileRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1;
+
+  // Required. Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image(s) in the file.
+  ImageContext image_context = 3;
+
+  // Pages of the file to perform image annotation.
+  //
+  // Pages starts from 1, we assume the first page of the file is page 1.
+  // At most 5 pages are supported per request. Pages can be negative.
+  //
+  // Page 1 means the first page.
+  // Page 2 means the second page.
+  // Page -1 means the last page.
+  // Page -2 means the second to the last page.
+  //
+  // If the file is GIF instead of PDF or TIFF, page refers to GIF frames.
+  //
+  // If this field is empty, by default the service performs image annotation
+  // for the first 5 pages of the file.
+  repeated int32 pages = 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;
+
+  // 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.
+message BatchAnnotateFilesResponse {
+  // The list of file annotation responses, each response corresponding to each
+  // AnnotateFileRequest in BatchAnnotateFilesRequest.
+  repeated AnnotateFileResponse responses = 1;
+}
+
+// An offline file annotation request.
+message AsyncAnnotateFileRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1;
+
+  // Required. Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image(s) in the file.
+  ImageContext image_context = 3;
+
+  // Required. The desired output location and metadata (e.g. format).
+  OutputConfig output_config = 4;
+}
+
+// The response for a single offline file annotation request.
+message AsyncAnnotateFileResponse {
+  // The output location and metadata from AsyncAnnotateFileRequest.
+  OutputConfig output_config = 1;
+}
+
+// Request for async image annotation for a list of images.
+message AsyncBatchAnnotateImagesRequest {
+  // Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1;
+
+  // Required. The desired output location and metadata (e.g. format).
+  OutputConfig output_config = 2;
+
+  // 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.
+message AsyncBatchAnnotateImagesResponse {
+  // The output location and metadata from AsyncBatchAnnotateImagesRequest.
+  OutputConfig output_config = 1;
+}
+
+// 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;
+
+  // 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.
+message AsyncBatchAnnotateFilesResponse {
+  // The list of file annotation responses, one for each request in
+  // AsyncBatchAnnotateFilesRequest.
+  repeated AsyncAnnotateFileResponse responses = 1;
+}
+
+// The desired input location and metadata.
+message InputConfig {
+  // The Google Cloud Storage location to read the input from.
+  GcsSource gcs_source = 1;
+
+  // File content, represented as a stream of bytes.
+  // Note: As with all `bytes` fields, protobuffers use a pure binary
+  // representation, whereas JSON representations use base64.
+  //
+  // Currently, this field only works for BatchAnnotateFiles requests. It does
+  // not work for AsyncBatchAnnotateFiles requests.
+  bytes content = 3;
+
+  // The type of the file. Currently only "application/pdf", "image/tiff" and
+  // "image/gif" are supported. Wildcards are not supported.
+  string mime_type = 2;
+}
+
+// The desired output location and metadata.
+message OutputConfig {
+  // The Google Cloud Storage location to write the output(s) to.
+  GcsDestination gcs_destination = 1;
+
+  // The max number of response protos to put into each output JSON file 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 response protos will
+  // be generated. If `batch_size` = 20, then 5 json files each
+  // containing 20 response protos will be written under the prefix
+  // `gcs_destination`.`uri`.
+  //
+  // Currently, batch_size only applies to GcsDestination, with potential future
+  // support for other output configurations.
+  int32 batch_size = 2;
+}
+
+// The Google Cloud Storage location where the input will be read from.
+message GcsSource {
+  // Google Cloud Storage URI for the input file. This must only be a
+  // Google Cloud Storage object. Wildcards are not currently supported.
+  string uri = 1;
+}
+
+// The Google Cloud Storage location where the output will be written to.
+message GcsDestination {
+  // 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 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.
+  // Multiple outputs can happen if, for example, the output JSON is too large
+  // and overflows into multiple sharded files.
+  string uri = 1;
+}
+
+// Contains metadata for the BatchAnnotateImages operation.
+message OperationMetadata {
+  // Batch operation states.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is received.
+    CREATED = 1;
+
+    // Request is actively being processed.
+    RUNNING = 2;
+
+    // The batch processing is done.
+    DONE = 3;
+
+    // The batch processing was cancelled.
+    CANCELLED = 4;
+  }
+
+  // Current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was received.
+  google.protobuf.Timestamp create_time = 5;
+
+  // The time when the operation result was last updated.
+  google.protobuf.Timestamp update_time = 6;
+}
diff --git a/vision/google/cloud/vision_v1/proto/image_annotator_pb2.py b/vision/google/cloud/vision_v1/proto/image_annotator_pb2.py
new file mode 100644
index 000000000000..1ea8f0ff05e7
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/image_annotator_pb2.py
@@ -0,0 +1,4786 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1/proto/image_annotator.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.vision_v1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1.proto import (
+    product_search_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__pb2,
+)
+from google.cloud.vision_v1.proto import (
+    text_annotation_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_text__annotation__pb2,
+)
+from google.cloud.vision_v1.proto import (
+    web_detection_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_web__detection__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.type import color_pb2 as google_dot_type_dot_color__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1/proto/image_annotator.proto",
+    package="google.cloud.vision.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.vision.v1B\023ImageAnnotatorProtoP\001Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/vision_v1/proto/image_annotator.proto\x12\x16google.cloud.vision.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a+google/cloud/vision_v1/proto/geometry.proto\x1a\x31google/cloud/vision_v1/proto/product_search.proto\x1a\x32google/cloud/vision_v1/proto/text_annotation.proto\x1a\x30google/cloud/vision_v1/proto/web_detection.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x17google/type/color.proto\x1a\x18google/type/latlng.proto"\x87\x03\n\x07\x46\x65\x61ture\x12\x32\n\x04type\x18\x01 \x01(\x0e\x32$.google.cloud.vision.v1.Feature.Type\x12\x13\n\x0bmax_results\x18\x02 \x01(\x05\x12\r\n\x05model\x18\x03 \x01(\t"\xa3\x02\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x01\x12\x16\n\x12LANDMARK_DETECTION\x10\x02\x12\x12\n\x0eLOGO_DETECTION\x10\x03\x12\x13\n\x0fLABEL_DETECTION\x10\x04\x12\x12\n\x0eTEXT_DETECTION\x10\x05\x12\x1b\n\x17\x44OCUMENT_TEXT_DETECTION\x10\x0b\x12\x19\n\x15SAFE_SEARCH_DETECTION\x10\x06\x12\x14\n\x10IMAGE_PROPERTIES\x10\x07\x12\x0e\n\nCROP_HINTS\x10\t\x12\x11\n\rWEB_DETECTION\x10\n\x12\x12\n\x0ePRODUCT_SEARCH\x10\x0c\x12\x17\n\x13OBJECT_LOCALIZATION\x10\x13"7\n\x0bImageSource\x12\x15\n\rgcs_image_uri\x18\x01 \x01(\t\x12\x11\n\timage_uri\x18\x02 \x01(\t"M\n\x05Image\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\x0c\x12\x33\n\x06source\x18\x02 \x01(\x0b\x32#.google.cloud.vision.v1.ImageSource"\xc7\r\n\x0e\x46\x61\x63\x65\x41nnotation\x12;\n\rbounding_poly\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12>\n\x10\x66\x64_bounding_poly\x18\x02 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x42\n\tlandmarks\x18\x03 \x03(\x0b\x32/.google.cloud.vision.v1.FaceAnnotation.Landmark\x12\x12\n\nroll_angle\x18\x04 \x01(\x02\x12\x11\n\tpan_angle\x18\x05 \x01(\x02\x12\x12\n\ntilt_angle\x18\x06 \x01(\x02\x12\x1c\n\x14\x64\x65tection_confidence\x18\x07 \x01(\x02\x12\x1e\n\x16landmarking_confidence\x18\x08 \x01(\x02\x12:\n\x0ejoy_likelihood\x18\t \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12=\n\x11sorrow_likelihood\x18\n \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12<\n\x10\x61nger_likelihood\x18\x0b \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12?\n\x13surprise_likelihood\x18\x0c \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12\x44\n\x18under_exposed_likelihood\x18\r \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12>\n\x12\x62lurred_likelihood\x18\x0e \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12?\n\x13headwear_likelihood\x18\x0f \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x1a\xb9\x07\n\x08Landmark\x12\x42\n\x04type\x18\x03 \x01(\x0e\x32\x34.google.cloud.vision.v1.FaceAnnotation.Landmark.Type\x12\x32\n\x08position\x18\x04 \x01(\x0b\x32 .google.cloud.vision.v1.Position"\xb4\x06\n\x04Type\x12\x14\n\x10UNKNOWN_LANDMARK\x10\x00\x12\x0c\n\x08LEFT_EYE\x10\x01\x12\r\n\tRIGHT_EYE\x10\x02\x12\x18\n\x14LEFT_OF_LEFT_EYEBROW\x10\x03\x12\x19\n\x15RIGHT_OF_LEFT_EYEBROW\x10\x04\x12\x19\n\x15LEFT_OF_RIGHT_EYEBROW\x10\x05\x12\x1a\n\x16RIGHT_OF_RIGHT_EYEBROW\x10\x06\x12\x19\n\x15MIDPOINT_BETWEEN_EYES\x10\x07\x12\x0c\n\x08NOSE_TIP\x10\x08\x12\r\n\tUPPER_LIP\x10\t\x12\r\n\tLOWER_LIP\x10\n\x12\x0e\n\nMOUTH_LEFT\x10\x0b\x12\x0f\n\x0bMOUTH_RIGHT\x10\x0c\x12\x10\n\x0cMOUTH_CENTER\x10\r\x12\x15\n\x11NOSE_BOTTOM_RIGHT\x10\x0e\x12\x14\n\x10NOSE_BOTTOM_LEFT\x10\x0f\x12\x16\n\x12NOSE_BOTTOM_CENTER\x10\x10\x12\x19\n\x15LEFT_EYE_TOP_BOUNDARY\x10\x11\x12\x19\n\x15LEFT_EYE_RIGHT_CORNER\x10\x12\x12\x1c\n\x18LEFT_EYE_BOTTOM_BOUNDARY\x10\x13\x12\x18\n\x14LEFT_EYE_LEFT_CORNER\x10\x14\x12\x1a\n\x16RIGHT_EYE_TOP_BOUNDARY\x10\x15\x12\x1a\n\x16RIGHT_EYE_RIGHT_CORNER\x10\x16\x12\x1d\n\x19RIGHT_EYE_BOTTOM_BOUNDARY\x10\x17\x12\x19\n\x15RIGHT_EYE_LEFT_CORNER\x10\x18\x12\x1f\n\x1bLEFT_EYEBROW_UPPER_MIDPOINT\x10\x19\x12 \n\x1cRIGHT_EYEBROW_UPPER_MIDPOINT\x10\x1a\x12\x14\n\x10LEFT_EAR_TRAGION\x10\x1b\x12\x15\n\x11RIGHT_EAR_TRAGION\x10\x1c\x12\x12\n\x0eLEFT_EYE_PUPIL\x10\x1d\x12\x13\n\x0fRIGHT_EYE_PUPIL\x10\x1e\x12\x15\n\x11\x46OREHEAD_GLABELLA\x10\x1f\x12\x11\n\rCHIN_GNATHION\x10 \x12\x14\n\x10\x43HIN_LEFT_GONION\x10!\x12\x15\n\x11\x43HIN_RIGHT_GONION\x10""4\n\x0cLocationInfo\x12$\n\x07lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng"=\n\x08Property\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12\x14\n\x0cuint64_value\x18\x03 \x01(\x04"\xab\x02\n\x10\x45ntityAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x0e\n\x06locale\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x16\n\nconfidence\x18\x05 \x01(\x02\x42\x02\x18\x01\x12\x12\n\ntopicality\x18\x06 \x01(\x02\x12;\n\rbounding_poly\x18\x07 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x37\n\tlocations\x18\x08 \x03(\x0b\x32$.google.cloud.vision.v1.LocationInfo\x12\x34\n\nproperties\x18\t \x03(\x0b\x32 .google.cloud.vision.v1.Property"\x99\x01\n\x19LocalizedObjectAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12;\n\rbounding_poly\x18\x05 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly"\x99\x02\n\x14SafeSearchAnnotation\x12\x31\n\x05\x61\x64ult\x18\x01 \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12\x31\n\x05spoof\x18\x02 \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12\x33\n\x07medical\x18\x03 \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12\x34\n\x08violence\x18\x04 \x01(\x0e\x32".google.cloud.vision.v1.Likelihood\x12\x30\n\x04racy\x18\t \x01(\x0e\x32".google.cloud.vision.v1.Likelihood"a\n\x0bLatLongRect\x12(\n\x0bmin_lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng\x12(\n\x0bmax_lat_lng\x18\x02 \x01(\x0b\x32\x13.google.type.LatLng"U\n\tColorInfo\x12!\n\x05\x63olor\x18\x01 \x01(\x0b\x32\x12.google.type.Color\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x16\n\x0epixel_fraction\x18\x03 \x01(\x02"M\n\x18\x44ominantColorsAnnotation\x12\x31\n\x06\x63olors\x18\x01 \x03(\x0b\x32!.google.cloud.vision.v1.ColorInfo"\\\n\x0fImageProperties\x12I\n\x0f\x64ominant_colors\x18\x01 \x01(\x0b\x32\x30.google.cloud.vision.v1.DominantColorsAnnotation"x\n\x08\x43ropHint\x12;\n\rbounding_poly\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x1b\n\x13importance_fraction\x18\x03 \x01(\x02"K\n\x13\x43ropHintsAnnotation\x12\x34\n\ncrop_hints\x18\x01 \x03(\x0b\x32 .google.cloud.vision.v1.CropHint"(\n\x0f\x43ropHintsParams\x12\x15\n\raspect_ratios\x18\x01 \x03(\x02"1\n\x12WebDetectionParams\x12\x1b\n\x13include_geo_results\x18\x02 \x01(\x08"\xbc\x02\n\x0cImageContext\x12:\n\rlat_long_rect\x18\x01 \x01(\x0b\x32#.google.cloud.vision.v1.LatLongRect\x12\x16\n\x0elanguage_hints\x18\x02 \x03(\t\x12\x42\n\x11\x63rop_hints_params\x18\x04 \x01(\x0b\x32\'.google.cloud.vision.v1.CropHintsParams\x12J\n\x15product_search_params\x18\x05 \x01(\x0b\x32+.google.cloud.vision.v1.ProductSearchParams\x12H\n\x14web_detection_params\x18\x06 \x01(\x0b\x32*.google.cloud.vision.v1.WebDetectionParams"\xb4\x01\n\x14\x41nnotateImageRequest\x12,\n\x05image\x18\x01 \x01(\x0b\x32\x1d.google.cloud.vision.v1.Image\x12\x31\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32\x1f.google.cloud.vision.v1.Feature\x12;\n\rimage_context\x18\x03 \x01(\x0b\x32$.google.cloud.vision.v1.ImageContext":\n\x16ImageAnnotationContext\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\x13\n\x0bpage_number\x18\x02 \x01(\x05"\xe4\x07\n\x15\x41nnotateImageResponse\x12@\n\x10\x66\x61\x63\x65_annotations\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1.FaceAnnotation\x12\x46\n\x14landmark_annotations\x18\x02 \x03(\x0b\x32(.google.cloud.vision.v1.EntityAnnotation\x12\x42\n\x10logo_annotations\x18\x03 \x03(\x0b\x32(.google.cloud.vision.v1.EntityAnnotation\x12\x43\n\x11label_annotations\x18\x04 \x03(\x0b\x32(.google.cloud.vision.v1.EntityAnnotation\x12W\n\x1clocalized_object_annotations\x18\x16 \x03(\x0b\x32\x31.google.cloud.vision.v1.LocalizedObjectAnnotation\x12\x42\n\x10text_annotations\x18\x05 \x03(\x0b\x32(.google.cloud.vision.v1.EntityAnnotation\x12\x44\n\x14\x66ull_text_annotation\x18\x0c \x01(\x0b\x32&.google.cloud.vision.v1.TextAnnotation\x12L\n\x16safe_search_annotation\x18\x06 \x01(\x0b\x32,.google.cloud.vision.v1.SafeSearchAnnotation\x12L\n\x1bimage_properties_annotation\x18\x08 \x01(\x0b\x32\'.google.cloud.vision.v1.ImageProperties\x12J\n\x15\x63rop_hints_annotation\x18\x0b \x01(\x0b\x32+.google.cloud.vision.v1.CropHintsAnnotation\x12;\n\rweb_detection\x18\r \x01(\x0b\x32$.google.cloud.vision.v1.WebDetection\x12L\n\x16product_search_results\x18\x0e \x01(\x0b\x32,.google.cloud.vision.v1.ProductSearchResults\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status\x12?\n\x07\x63ontext\x18\x15 \x01(\x0b\x32..google.cloud.vision.v1.ImageAnnotationContext"\xcb\x01\n\x14\x41nnotateFileResponse\x12\x39\n\x0cinput_config\x18\x01 \x01(\x0b\x32#.google.cloud.vision.v1.InputConfig\x12@\n\tresponses\x18\x02 \x03(\x0b\x32-.google.cloud.vision.v1.AnnotateImageResponse\x12\x13\n\x0btotal_pages\x18\x03 \x01(\x05\x12!\n\x05\x65rror\x18\x04 \x01(\x0b\x32\x12.google.rpc.Status"l\n\x1a\x42\x61tchAnnotateImagesRequest\x12>\n\x08requests\x18\x01 \x03(\x0b\x32,.google.cloud.vision.v1.AnnotateImageRequest\x12\x0e\n\x06parent\x18\x04 \x01(\t"_\n\x1b\x42\x61tchAnnotateImagesResponse\x12@\n\tresponses\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1.AnnotateImageResponse"\xcf\x01\n\x13\x41nnotateFileRequest\x12\x39\n\x0cinput_config\x18\x01 \x01(\x0b\x32#.google.cloud.vision.v1.InputConfig\x12\x31\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32\x1f.google.cloud.vision.v1.Feature\x12;\n\rimage_context\x18\x03 \x01(\x0b\x32$.google.cloud.vision.v1.ImageContext\x12\r\n\x05pages\x18\x04 \x03(\x05"j\n\x19\x42\x61tchAnnotateFilesRequest\x12=\n\x08requests\x18\x01 \x03(\x0b\x32+.google.cloud.vision.v1.AnnotateFileRequest\x12\x0e\n\x06parent\x18\x03 \x01(\t"]\n\x1a\x42\x61tchAnnotateFilesResponse\x12?\n\tresponses\x18\x01 \x03(\x0b\x32,.google.cloud.vision.v1.AnnotateFileResponse"\x82\x02\n\x18\x41syncAnnotateFileRequest\x12\x39\n\x0cinput_config\x18\x01 \x01(\x0b\x32#.google.cloud.vision.v1.InputConfig\x12\x31\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32\x1f.google.cloud.vision.v1.Feature\x12;\n\rimage_context\x18\x03 \x01(\x0b\x32$.google.cloud.vision.v1.ImageContext\x12;\n\routput_config\x18\x04 \x01(\x0b\x32$.google.cloud.vision.v1.OutputConfig"X\n\x19\x41syncAnnotateFileResponse\x12;\n\routput_config\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1.OutputConfig"\xae\x01\n\x1f\x41syncBatchAnnotateImagesRequest\x12>\n\x08requests\x18\x01 \x03(\x0b\x32,.google.cloud.vision.v1.AnnotateImageRequest\x12;\n\routput_config\x18\x02 \x01(\x0b\x32$.google.cloud.vision.v1.OutputConfig\x12\x0e\n\x06parent\x18\x04 \x01(\t"_\n AsyncBatchAnnotateImagesResponse\x12;\n\routput_config\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1.OutputConfig"t\n\x1e\x41syncBatchAnnotateFilesRequest\x12\x42\n\x08requests\x18\x01 \x03(\x0b\x32\x30.google.cloud.vision.v1.AsyncAnnotateFileRequest\x12\x0e\n\x06parent\x18\x04 \x01(\t"g\n\x1f\x41syncBatchAnnotateFilesResponse\x12\x44\n\tresponses\x18\x01 \x03(\x0b\x32\x31.google.cloud.vision.v1.AsyncAnnotateFileResponse"h\n\x0bInputConfig\x12\x35\n\ngcs_source\x18\x01 \x01(\x0b\x32!.google.cloud.vision.v1.GcsSource\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tmime_type\x18\x02 \x01(\t"c\n\x0cOutputConfig\x12?\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32&.google.cloud.vision.v1.GcsDestination\x12\x12\n\nbatch_size\x18\x02 \x01(\x05"\x18\n\tGcsSource\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x1d\n\x0eGcsDestination\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x88\x02\n\x11OperationMetadata\x12>\n\x05state\x18\x01 \x01(\x0e\x32/.google.cloud.vision.v1.OperationMetadata.State\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Q\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x43REATED\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\r\n\tCANCELLED\x10\x04*e\n\nLikelihood\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xcc\t\n\x0eImageAnnotator\x12\x88\x02\n\x13\x42\x61tchAnnotateImages\x12\x32.google.cloud.vision.v1.BatchAnnotateImagesRequest\x1a\x33.google.cloud.vision.v1.BatchAnnotateImagesResponse"\x87\x01\x82\xd3\xe4\x93\x02\x80\x01"\x13/v1/images:annotate:\x01*Z8"3/v1/{parent=projects/*/locations/*}/images:annotate:\x01*Z,"\'/v1/{parent=projects/*}/images:annotate:\x01*\x12\x81\x02\n\x12\x42\x61tchAnnotateFiles\x12\x31.google.cloud.vision.v1.BatchAnnotateFilesRequest\x1a\x32.google.cloud.vision.v1.BatchAnnotateFilesResponse"\x83\x01\x82\xd3\xe4\x93\x02}"\x12/v1/files:annotate:\x01*Z7"2/v1/{parent=projects/*/locations/*}/files:annotate:\x01*Z+"&/v1/{parent=projects/*}/files:annotate:\x01*\x12\x9a\x02\n\x18\x41syncBatchAnnotateImages\x12\x37.google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest\x1a\x1d.google.longrunning.Operation"\xa5\x01\x82\xd3\xe4\x93\x02\x9e\x01"\x1d/v1/images:asyncBatchAnnotate:\x01*ZB"=/v1/{parent=projects/*/locations/*}/images:asyncBatchAnnotate:\x01*Z6"1/v1/{parent=projects/*}/images:asyncBatchAnnotate:\x01*\x12\x95\x02\n\x17\x41syncBatchAnnotateFiles\x12\x36.google.cloud.vision.v1.AsyncBatchAnnotateFilesRequest\x1a\x1d.google.longrunning.Operation"\xa2\x01\x82\xd3\xe4\x93\x02\x9b\x01"\x1c/v1/files:asyncBatchAnnotate:\x01*ZA"</v1/{parent=projects/*/locations/*}/files:asyncBatchAnnotate:\x01*Z5"0/v1/{parent=projects/*}/files:asyncBatchAnnotate:\x01*\x1av\xca\x41\x15vision.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-visionB{\n\x1a\x63om.google.cloud.vision.v1B\x13ImageAnnotatorProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_text__annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_web__detection__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_type_dot_color__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.vision.v1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=8055,
+    serialized_end=8156,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+UNKNOWN = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_FEATURE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1.Feature.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LANDMARK_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGO_DETECTION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOCUMENT_TEXT_DETECTION",
+            index=6,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFE_SEARCH_DETECTION",
+            index=7,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_PROPERTIES",
+            index=8,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CROP_HINTS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEB_DETECTION",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRODUCT_SEARCH",
+            index=11,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_LOCALIZATION",
+            index=12,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=612,
+    serialized_end=903,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE_TYPE)
+
+_FACEANNOTATION_LANDMARK_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1.FaceAnnotation.Landmark.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN_LANDMARK",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_LEFT_EYEBROW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_LEFT_EYEBROW",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_RIGHT_EYEBROW",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_RIGHT_EYEBROW",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDPOINT_BETWEEN_EYES",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_TIP", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_LIP", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOWER_LIP", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_LEFT", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_RIGHT", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_CENTER", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_RIGHT",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_LEFT",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_CENTER",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_TOP_BOUNDARY",
+            index=17,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_RIGHT_CORNER",
+            index=18,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_BOTTOM_BOUNDARY",
+            index=19,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_LEFT_CORNER",
+            index=20,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_TOP_BOUNDARY",
+            index=21,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_RIGHT_CORNER",
+            index=22,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_BOTTOM_BOUNDARY",
+            index=23,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_LEFT_CORNER",
+            index=24,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYEBROW_UPPER_MIDPOINT",
+            index=25,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYEBROW_UPPER_MIDPOINT",
+            index=26,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EAR_TRAGION",
+            index=27,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EAR_TRAGION",
+            index=28,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_PUPIL",
+            index=29,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_PUPIL",
+            index=30,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREHEAD_GLABELLA",
+            index=31,
+            number=31,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_GNATHION",
+            index=32,
+            number=32,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_LEFT_GONION",
+            index=33,
+            number=33,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_RIGHT_GONION",
+            index=34,
+            number=34,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1957,
+    serialized_end=2777,
+)
+_sym_db.RegisterEnumDescriptor(_FACEANNOTATION_LANDMARK_TYPE)
+
+_OPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1.OperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7972,
+    serialized_end=8053,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATIONMETADATA_STATE)
+
+
+_FEATURE = _descriptor.Descriptor(
+    name="Feature",
+    full_name="google.cloud.vision.v1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1.Feature.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_results",
+            full_name="google.cloud.vision.v1.Feature.max_results",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.vision.v1.Feature.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FEATURE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=512,
+    serialized_end=903,
+)
+
+
+_IMAGESOURCE = _descriptor.Descriptor(
+    name="ImageSource",
+    full_name="google.cloud.vision.v1.ImageSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_image_uri",
+            full_name="google.cloud.vision.v1.ImageSource.gcs_image_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.vision.v1.ImageSource.image_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=905,
+    serialized_end=960,
+)
+
+
+_IMAGE = _descriptor.Descriptor(
+    name="Image",
+    full_name="google.cloud.vision.v1.Image",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1.Image.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1.Image.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=962,
+    serialized_end=1039,
+)
+
+
+_FACEANNOTATION_LANDMARK = _descriptor.Descriptor(
+    name="Landmark",
+    full_name="google.cloud.vision.v1.FaceAnnotation.Landmark",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1.FaceAnnotation.Landmark.type",
+            index=0,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="position",
+            full_name="google.cloud.vision.v1.FaceAnnotation.Landmark.position",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FACEANNOTATION_LANDMARK_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1824,
+    serialized_end=2777,
+)
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.vision.v1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1.FaceAnnotation.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fd_bounding_poly",
+            full_name="google.cloud.vision.v1.FaceAnnotation.fd_bounding_poly",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarks",
+            full_name="google.cloud.vision.v1.FaceAnnotation.landmarks",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roll_angle",
+            full_name="google.cloud.vision.v1.FaceAnnotation.roll_angle",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pan_angle",
+            full_name="google.cloud.vision.v1.FaceAnnotation.pan_angle",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tilt_angle",
+            full_name="google.cloud.vision.v1.FaceAnnotation.tilt_angle",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detection_confidence",
+            full_name="google.cloud.vision.v1.FaceAnnotation.detection_confidence",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarking_confidence",
+            full_name="google.cloud.vision.v1.FaceAnnotation.landmarking_confidence",
+            index=7,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="joy_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.joy_likelihood",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sorrow_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.sorrow_likelihood",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="anger_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.anger_likelihood",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surprise_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.surprise_likelihood",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="under_exposed_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.under_exposed_likelihood",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blurred_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.blurred_likelihood",
+            index=13,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headwear_likelihood",
+            full_name="google.cloud.vision.v1.FaceAnnotation.headwear_likelihood",
+            index=14,
+            number=15,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FACEANNOTATION_LANDMARK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1042,
+    serialized_end=2777,
+)
+
+
+_LOCATIONINFO = _descriptor.Descriptor(
+    name="LocationInfo",
+    full_name="google.cloud.vision.v1.LocationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.vision.v1.LocationInfo.lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2779,
+    serialized_end=2831,
+)
+
+
+_PROPERTY = _descriptor.Descriptor(
+    name="Property",
+    full_name="google.cloud.vision.v1.Property",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.Property.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1.Property.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uint64_value",
+            full_name="google.cloud.vision.v1.Property.uint64_value",
+            index=2,
+            number=3,
+            type=4,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2833,
+    serialized_end=2894,
+)
+
+
+_ENTITYANNOTATION = _descriptor.Descriptor(
+    name="EntityAnnotation",
+    full_name="google.cloud.vision.v1.EntityAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1.EntityAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locale",
+            full_name="google.cloud.vision.v1.EntityAnnotation.locale",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1.EntityAnnotation.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.EntityAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.EntityAnnotation.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topicality",
+            full_name="google.cloud.vision.v1.EntityAnnotation.topicality",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1.EntityAnnotation.bounding_poly",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.vision.v1.EntityAnnotation.locations",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.vision.v1.EntityAnnotation.properties",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2897,
+    serialized_end=3196,
+)
+
+
+_LOCALIZEDOBJECTANNOTATION = _descriptor.Descriptor(
+    name="LocalizedObjectAnnotation",
+    full_name="google.cloud.vision.v1.LocalizedObjectAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1.LocalizedObjectAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1.LocalizedObjectAnnotation.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.LocalizedObjectAnnotation.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.LocalizedObjectAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1.LocalizedObjectAnnotation.bounding_poly",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3199,
+    serialized_end=3352,
+)
+
+
+_SAFESEARCHANNOTATION = _descriptor.Descriptor(
+    name="SafeSearchAnnotation",
+    full_name="google.cloud.vision.v1.SafeSearchAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="adult",
+            full_name="google.cloud.vision.v1.SafeSearchAnnotation.adult",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spoof",
+            full_name="google.cloud.vision.v1.SafeSearchAnnotation.spoof",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="medical",
+            full_name="google.cloud.vision.v1.SafeSearchAnnotation.medical",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violence",
+            full_name="google.cloud.vision.v1.SafeSearchAnnotation.violence",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="racy",
+            full_name="google.cloud.vision.v1.SafeSearchAnnotation.racy",
+            index=4,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3355,
+    serialized_end=3636,
+)
+
+
+_LATLONGRECT = _descriptor.Descriptor(
+    name="LatLongRect",
+    full_name="google.cloud.vision.v1.LatLongRect",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_lat_lng",
+            full_name="google.cloud.vision.v1.LatLongRect.min_lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_lat_lng",
+            full_name="google.cloud.vision.v1.LatLongRect.max_lat_lng",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3638,
+    serialized_end=3735,
+)
+
+
+_COLORINFO = _descriptor.Descriptor(
+    name="ColorInfo",
+    full_name="google.cloud.vision.v1.ColorInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="color",
+            full_name="google.cloud.vision.v1.ColorInfo.color",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.ColorInfo.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pixel_fraction",
+            full_name="google.cloud.vision.v1.ColorInfo.pixel_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3737,
+    serialized_end=3822,
+)
+
+
+_DOMINANTCOLORSANNOTATION = _descriptor.Descriptor(
+    name="DominantColorsAnnotation",
+    full_name="google.cloud.vision.v1.DominantColorsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="colors",
+            full_name="google.cloud.vision.v1.DominantColorsAnnotation.colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3824,
+    serialized_end=3901,
+)
+
+
+_IMAGEPROPERTIES = _descriptor.Descriptor(
+    name="ImageProperties",
+    full_name="google.cloud.vision.v1.ImageProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dominant_colors",
+            full_name="google.cloud.vision.v1.ImageProperties.dominant_colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3903,
+    serialized_end=3995,
+)
+
+
+_CROPHINT = _descriptor.Descriptor(
+    name="CropHint",
+    full_name="google.cloud.vision.v1.CropHint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1.CropHint.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.CropHint.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="importance_fraction",
+            full_name="google.cloud.vision.v1.CropHint.importance_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3997,
+    serialized_end=4117,
+)
+
+
+_CROPHINTSANNOTATION = _descriptor.Descriptor(
+    name="CropHintsAnnotation",
+    full_name="google.cloud.vision.v1.CropHintsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crop_hints",
+            full_name="google.cloud.vision.v1.CropHintsAnnotation.crop_hints",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4119,
+    serialized_end=4194,
+)
+
+
+_CROPHINTSPARAMS = _descriptor.Descriptor(
+    name="CropHintsParams",
+    full_name="google.cloud.vision.v1.CropHintsParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aspect_ratios",
+            full_name="google.cloud.vision.v1.CropHintsParams.aspect_ratios",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4196,
+    serialized_end=4236,
+)
+
+
+_WEBDETECTIONPARAMS = _descriptor.Descriptor(
+    name="WebDetectionParams",
+    full_name="google.cloud.vision.v1.WebDetectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="include_geo_results",
+            full_name="google.cloud.vision.v1.WebDetectionParams.include_geo_results",
+            index=0,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4238,
+    serialized_end=4287,
+)
+
+
+_IMAGECONTEXT = _descriptor.Descriptor(
+    name="ImageContext",
+    full_name="google.cloud.vision.v1.ImageContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_long_rect",
+            full_name="google.cloud.vision.v1.ImageContext.lat_long_rect",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.vision.v1.ImageContext.language_hints",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_params",
+            full_name="google.cloud.vision.v1.ImageContext.crop_hints_params",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_search_params",
+            full_name="google.cloud.vision.v1.ImageContext.product_search_params",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection_params",
+            full_name="google.cloud.vision.v1.ImageContext.web_detection_params",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4290,
+    serialized_end=4606,
+)
+
+
+_ANNOTATEIMAGEREQUEST = _descriptor.Descriptor(
+    name="AnnotateImageRequest",
+    full_name="google.cloud.vision.v1.AnnotateImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1.AnnotateImageRequest.image",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1.AnnotateImageRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1.AnnotateImageRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4609,
+    serialized_end=4789,
+)
+
+
+_IMAGEANNOTATIONCONTEXT = _descriptor.Descriptor(
+    name="ImageAnnotationContext",
+    full_name="google.cloud.vision.v1.ImageAnnotationContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1.ImageAnnotationContext.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_number",
+            full_name="google.cloud.vision.v1.ImageAnnotationContext.page_number",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4791,
+    serialized_end=4849,
+)
+
+
+_ANNOTATEIMAGERESPONSE = _descriptor.Descriptor(
+    name="AnnotateImageResponse",
+    full_name="google.cloud.vision.v1.AnnotateImageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.face_annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmark_annotations",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.landmark_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logo_annotations",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.logo_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="localized_object_annotations",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.localized_object_annotations",
+            index=4,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.text_annotations",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_text_annotation",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.full_text_annotation",
+            index=6,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_annotation",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.safe_search_annotation",
+            index=7,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_properties_annotation",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.image_properties_annotation",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_annotation",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.crop_hints_annotation",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.web_detection",
+            index=10,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_search_results",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.product_search_results",
+            index=11,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.error",
+            index=12,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.cloud.vision.v1.AnnotateImageResponse.context",
+            index=13,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4852,
+    serialized_end=5848,
+)
+
+
+_ANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AnnotateFileResponse",
+    full_name="google.cloud.vision.v1.AnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1.AnnotateFileResponse.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1.AnnotateFileResponse.responses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_pages",
+            full_name="google.cloud.vision.v1.AnnotateFileResponse.total_pages",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.vision.v1.AnnotateFileResponse.error",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5851,
+    serialized_end=6054,
+)
+
+
+_BATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1.BatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1.BatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.BatchAnnotateImagesRequest.parent",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6056,
+    serialized_end=6164,
+)
+
+
+_BATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1.BatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1.BatchAnnotateImagesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6166,
+    serialized_end=6261,
+)
+
+
+_ANNOTATEFILEREQUEST = _descriptor.Descriptor(
+    name="AnnotateFileRequest",
+    full_name="google.cloud.vision.v1.AnnotateFileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1.AnnotateFileRequest.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1.AnnotateFileRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1.AnnotateFileRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1.AnnotateFileRequest.pages",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6264,
+    serialized_end=6471,
+)
+
+
+_BATCHANNOTATEFILESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateFilesRequest",
+    full_name="google.cloud.vision.v1.BatchAnnotateFilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1.BatchAnnotateFilesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.BatchAnnotateFilesRequest.parent",
+            index=1,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6473,
+    serialized_end=6579,
+)
+
+
+_BATCHANNOTATEFILESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateFilesResponse",
+    full_name="google.cloud.vision.v1.BatchAnnotateFilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1.BatchAnnotateFilesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6581,
+    serialized_end=6674,
+)
+
+
+_ASYNCANNOTATEFILEREQUEST = _descriptor.Descriptor(
+    name="AsyncAnnotateFileRequest",
+    full_name="google.cloud.vision.v1.AsyncAnnotateFileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1.AsyncAnnotateFileRequest.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1.AsyncAnnotateFileRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1.AsyncAnnotateFileRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1.AsyncAnnotateFileRequest.output_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6677,
+    serialized_end=6935,
+)
+
+
+_ASYNCANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AsyncAnnotateFileResponse",
+    full_name="google.cloud.vision.v1.AsyncAnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1.AsyncAnnotateFileResponse.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6937,
+    serialized_end=7025,
+)
+
+
+_ASYNCBATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest.output_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest.parent",
+            index=2,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7028,
+    serialized_end=7202,
+)
+
+
+_ASYNCBATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1.AsyncBatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateImagesResponse.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7204,
+    serialized_end=7299,
+)
+
+
+_ASYNCBATCHANNOTATEFILESREQUEST = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesRequest",
+    full_name="google.cloud.vision.v1.AsyncBatchAnnotateFilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateFilesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateFilesRequest.parent",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7301,
+    serialized_end=7417,
+)
+
+
+_ASYNCBATCHANNOTATEFILESRESPONSE = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesResponse",
+    full_name="google.cloud.vision.v1.AsyncBatchAnnotateFilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1.AsyncBatchAnnotateFilesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7419,
+    serialized_end=7522,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.vision.v1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1.InputConfig.content",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.vision.v1.InputConfig.mime_type",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7524,
+    serialized_end=7628,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.vision.v1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.vision.v1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="batch_size",
+            full_name="google.cloud.vision.v1.OutputConfig.batch_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7630,
+    serialized_end=7729,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.vision.v1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1.GcsSource.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7731,
+    serialized_end=7755,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.vision.v1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7757,
+    serialized_end=7786,
+)
+
+
+_OPERATIONMETADATA = _descriptor.Descriptor(
+    name="OperationMetadata",
+    full_name="google.cloud.vision.v1.OperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1.OperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.vision.v1.OperationMetadata.create_time",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.vision.v1.OperationMetadata.update_time",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7789,
+    serialized_end=8053,
+)
+
+_FEATURE.fields_by_name["type"].enum_type = _FEATURE_TYPE
+_FEATURE_TYPE.containing_type = _FEATURE
+_IMAGE.fields_by_name["source"].message_type = _IMAGESOURCE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "type"
+].enum_type = _FACEANNOTATION_LANDMARK_TYPE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "position"
+].message_type = google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._POSITION
+_FACEANNOTATION_LANDMARK.containing_type = _FACEANNOTATION
+_FACEANNOTATION_LANDMARK_TYPE.containing_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name[
+    "fd_bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name["landmarks"].message_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name["joy_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["sorrow_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["anger_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["surprise_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["under_exposed_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["blurred_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["headwear_likelihood"].enum_type = _LIKELIHOOD
+_LOCATIONINFO.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_ENTITYANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_ENTITYANNOTATION.fields_by_name["locations"].message_type = _LOCATIONINFO
+_ENTITYANNOTATION.fields_by_name["properties"].message_type = _PROPERTY
+_LOCALIZEDOBJECTANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_SAFESEARCHANNOTATION.fields_by_name["adult"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["spoof"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["medical"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["violence"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["racy"].enum_type = _LIKELIHOOD
+_LATLONGRECT.fields_by_name[
+    "min_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LATLONGRECT.fields_by_name[
+    "max_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_COLORINFO.fields_by_name["color"].message_type = google_dot_type_dot_color__pb2._COLOR
+_DOMINANTCOLORSANNOTATION.fields_by_name["colors"].message_type = _COLORINFO
+_IMAGEPROPERTIES.fields_by_name[
+    "dominant_colors"
+].message_type = _DOMINANTCOLORSANNOTATION
+_CROPHINT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CROPHINTSANNOTATION.fields_by_name["crop_hints"].message_type = _CROPHINT
+_IMAGECONTEXT.fields_by_name["lat_long_rect"].message_type = _LATLONGRECT
+_IMAGECONTEXT.fields_by_name["crop_hints_params"].message_type = _CROPHINTSPARAMS
+_IMAGECONTEXT.fields_by_name[
+    "product_search_params"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__pb2._PRODUCTSEARCHPARAMS
+)
+_IMAGECONTEXT.fields_by_name["web_detection_params"].message_type = _WEBDETECTIONPARAMS
+_ANNOTATEIMAGEREQUEST.fields_by_name["image"].message_type = _IMAGE
+_ANNOTATEIMAGEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEIMAGEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ANNOTATEIMAGERESPONSE.fields_by_name["face_annotations"].message_type = _FACEANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "landmark_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "logo_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "label_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "localized_object_annotations"
+].message_type = _LOCALIZEDOBJECTANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "text_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "full_text_annotation"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_text__annotation__pb2._TEXTANNOTATION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "safe_search_annotation"
+].message_type = _SAFESEARCHANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "image_properties_annotation"
+].message_type = _IMAGEPROPERTIES
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "crop_hints_annotation"
+].message_type = _CROPHINTSANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "web_detection"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_web__detection__pb2._WEBDETECTION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "product_search_results"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__pb2._PRODUCTSEARCHRESULTS
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEIMAGERESPONSE.fields_by_name["context"].message_type = _IMAGEANNOTATIONCONTEXT
+_ANNOTATEFILERESPONSE.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ANNOTATEFILERESPONSE.fields_by_name["responses"].message_type = _ANNOTATEIMAGERESPONSE
+_ANNOTATEFILERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_BATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_BATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEIMAGERESPONSE
+_ANNOTATEFILEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ANNOTATEFILEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEFILEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_BATCHANNOTATEFILESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEFILEREQUEST
+_BATCHANNOTATEFILESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEFILERESPONSE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCANNOTATEFILERESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_ASYNCBATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "output_config"
+].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "output_config"
+].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEFILESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ASYNCANNOTATEFILEREQUEST
+_ASYNCBATCHANNOTATEFILESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ASYNCANNOTATEFILERESPONSE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OPERATIONMETADATA.fields_by_name["state"].enum_type = _OPERATIONMETADATA_STATE
+_OPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA_STATE.containing_type = _OPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.message_types_by_name["ImageSource"] = _IMAGESOURCE
+DESCRIPTOR.message_types_by_name["Image"] = _IMAGE
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["LocationInfo"] = _LOCATIONINFO
+DESCRIPTOR.message_types_by_name["Property"] = _PROPERTY
+DESCRIPTOR.message_types_by_name["EntityAnnotation"] = _ENTITYANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "LocalizedObjectAnnotation"
+] = _LOCALIZEDOBJECTANNOTATION
+DESCRIPTOR.message_types_by_name["SafeSearchAnnotation"] = _SAFESEARCHANNOTATION
+DESCRIPTOR.message_types_by_name["LatLongRect"] = _LATLONGRECT
+DESCRIPTOR.message_types_by_name["ColorInfo"] = _COLORINFO
+DESCRIPTOR.message_types_by_name["DominantColorsAnnotation"] = _DOMINANTCOLORSANNOTATION
+DESCRIPTOR.message_types_by_name["ImageProperties"] = _IMAGEPROPERTIES
+DESCRIPTOR.message_types_by_name["CropHint"] = _CROPHINT
+DESCRIPTOR.message_types_by_name["CropHintsAnnotation"] = _CROPHINTSANNOTATION
+DESCRIPTOR.message_types_by_name["CropHintsParams"] = _CROPHINTSPARAMS
+DESCRIPTOR.message_types_by_name["WebDetectionParams"] = _WEBDETECTIONPARAMS
+DESCRIPTOR.message_types_by_name["ImageContext"] = _IMAGECONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageRequest"] = _ANNOTATEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["ImageAnnotationContext"] = _IMAGEANNOTATIONCONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageResponse"] = _ANNOTATEIMAGERESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateFileResponse"] = _ANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesRequest"
+] = _BATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesResponse"
+] = _BATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateFileRequest"] = _ANNOTATEFILEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateFilesRequest"
+] = _BATCHANNOTATEFILESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateFilesResponse"
+] = _BATCHANNOTATEFILESRESPONSE
+DESCRIPTOR.message_types_by_name["AsyncAnnotateFileRequest"] = _ASYNCANNOTATEFILEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncAnnotateFileResponse"
+] = _ASYNCANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateImagesRequest"
+] = _ASYNCBATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateImagesResponse"
+] = _ASYNCBATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesRequest"
+] = _ASYNCBATCHANNOTATEFILESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesResponse"
+] = _ASYNCBATCHANNOTATEFILESRESPONSE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OperationMetadata"] = _OPERATIONMETADATA
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Feature = _reflection.GeneratedProtocolMessageType(
+    "Feature",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEATURE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""The type of Google Cloud Vision API detection to perform, and the
+  maximum number of results to return for that type. Multiple ``Feature``
+  objects can be specified in the ``features`` list.
+  
+  
+  Attributes:
+      type:
+          The feature type.
+      max_results:
+          Maximum number of results of this type. Does not apply to
+          ``TEXT_DETECTION``, ``DOCUMENT_TEXT_DETECTION``, or
+          ``CROP_HINTS``.
+      model:
+          Model to use for the feature. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Feature)
+    ),
+)
+_sym_db.RegisterMessage(Feature)
+
+ImageSource = _reflection.GeneratedProtocolMessageType(
+    "ImageSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGESOURCE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""External image source (Google Cloud Storage or web URL image location).
+  
+  
+  Attributes:
+      gcs_image_uri:
+          **Use ``image_uri`` instead.**  The 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.
+      image_uri:
+          The URI of the source image. Can be either:  1. A 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.  2. A publicly-accessible image HTTP/HTTPS URL.
+          When fetching images from    HTTP/HTTPS URLs, Google cannot
+          guarantee that the request will be    completed. Your request
+          may fail if the specified host denies the    request (e.g. due
+          to request throttling or DOS prevention), or if    Google
+          throttles requests to the site for abuse prevention. You
+          should not depend on externally-hosted images for production
+          applications.  When both ``gcs_image_uri`` and ``image_uri``
+          are specified, ``image_uri`` takes precedence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImageSource)
+    ),
+)
+_sym_db.RegisterMessage(ImageSource)
+
+Image = _reflection.GeneratedProtocolMessageType(
+    "Image",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Client image to perform Google Cloud Vision API tasks over.
+  
+  
+  Attributes:
+      content:
+          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.
+      source:
+          Google Cloud Storage image location, or publicly-accessible
+          image URL. If both ``content`` and ``source`` are provided for
+          an image, ``content`` takes precedence and is used to perform
+          the image annotation request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Image)
+    ),
+)
+_sym_db.RegisterMessage(Image)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        Landmark=_reflection.GeneratedProtocolMessageType(
+            "Landmark",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FACEANNOTATION_LANDMARK,
+                __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+                __doc__="""A face-specific landmark (for example, a face feature).
+    
+    
+    Attributes:
+        type:
+            Face landmark type.
+        position:
+            Face landmark position.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.FaceAnnotation.Landmark)
+            ),
+        ),
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""A face annotation object contains the results of face detection.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the face. The coordinates of the
+          bounding box are in the original image's scale. The bounding
+          box is computed to "frame" the face in accordance with human
+          expectations. It is based on the landmarker results. Note that
+          one or more x and/or y coordinates may not be generated in the
+          ``BoundingPoly`` (the polygon will be unbounded) if only a
+          partial face appears in the image to be annotated.
+      fd_bounding_poly:
+          The ``fd_bounding_poly`` bounding polygon is tighter than the
+          ``boundingPoly``, and encloses only the skin part of the face.
+          Typically, it is used to eliminate the face from any image
+          analysis that detects the "amount of skin" visible in an
+          image. It is not based on the landmarker results, only on the
+          initial face detection, hence the fd (face detection) prefix.
+      landmarks:
+          Detected face landmarks.
+      roll_angle:
+          Roll angle, which indicates the amount of clockwise/anti-
+          clockwise rotation of the face relative to the image vertical
+          about the axis perpendicular to the face. Range [-180,180].
+      pan_angle:
+          Yaw angle, which indicates the leftward/rightward angle that
+          the face is pointing relative to the vertical plane
+          perpendicular to the image. Range [-180,180].
+      tilt_angle:
+          Pitch angle, which indicates the upwards/downwards angle that
+          the face is pointing relative to the image's horizontal plane.
+          Range [-180,180].
+      detection_confidence:
+          Detection confidence. Range [0, 1].
+      landmarking_confidence:
+          Face landmarking confidence. Range [0, 1].
+      joy_likelihood:
+          Joy likelihood.
+      sorrow_likelihood:
+          Sorrow likelihood.
+      anger_likelihood:
+          Anger likelihood.
+      surprise_likelihood:
+          Surprise likelihood.
+      under_exposed_likelihood:
+          Under-exposed likelihood.
+      blurred_likelihood:
+          Blurred likelihood.
+      headwear_likelihood:
+          Headwear likelihood.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+_sym_db.RegisterMessage(FaceAnnotation.Landmark)
+
+LocationInfo = _reflection.GeneratedProtocolMessageType(
+    "LocationInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONINFO,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Detected entity location information.
+  
+  
+  Attributes:
+      lat_lng:
+          lat/long location coordinates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.LocationInfo)
+    ),
+)
+_sym_db.RegisterMessage(LocationInfo)
+
+Property = _reflection.GeneratedProtocolMessageType(
+    "Property",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTY,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""A ``Property`` consists of a user-supplied name/value pair.
+  
+  
+  Attributes:
+      name:
+          Name of the property.
+      value:
+          Value of the property.
+      uint64_value:
+          Value of numeric properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Property)
+    ),
+)
+_sym_db.RegisterMessage(Property)
+
+EntityAnnotation = _reflection.GeneratedProtocolMessageType(
+    "EntityAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYANNOTATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Set of detected entity features.
+  
+  
+  Attributes:
+      mid:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      locale:
+          The language code for the locale in which the entity textual
+          ``description`` is expressed.
+      description:
+          Entity textual description, expressed in its ``locale``
+          language.
+      score:
+          Overall score of the result. Range [0, 1].
+      confidence:
+          **Deprecated. Use ``score`` instead.** The accuracy of the
+          entity detection in an image. For example, for an image in
+          which the "Eiffel Tower" entity is detected, this field
+          represents the confidence that there is a tower in the query
+          image. Range [0, 1].
+      topicality:
+          The relevancy of the ICA (Image Content Annotation) label to
+          the image. For example, the relevancy of "tower" is likely
+          higher to an image containing the detected "Eiffel Tower" than
+          to an image containing a detected distant towering building,
+          even though the confidence that there is a tower in each image
+          may be the same. Range [0, 1].
+      bounding_poly:
+          Image region to which this entity belongs. Not produced for
+          ``LABEL_DETECTION`` features.
+      locations:
+          The location information for the detected entity. Multiple
+          ``LocationInfo`` elements can be present because one location
+          may indicate the location of the scene in the image, and
+          another location may indicate the location of the place where
+          the image was taken. Location information is usually present
+          for landmarks.
+      properties:
+          Some entities may have optional user-supplied ``Property``
+          (name/value) fields, such a score or string that qualifies the
+          entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.EntityAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(EntityAnnotation)
+
+LocalizedObjectAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LocalizedObjectAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCALIZEDOBJECTANNOTATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Set of detected objects with bounding boxes.
+  
+  
+  Attributes:
+      mid:
+          Object ID that should align with EntityAnnotation mid.
+      language_code:
+          The BCP-47 language code, such as "en-US" or "sr-Latn". For
+          more information, see http://www.unicode.org/reports/tr35/#Uni
+          code\_locale\_identifier.
+      name:
+          Object name, expressed in its ``language_code`` language.
+      score:
+          Score of the result. Range [0, 1].
+      bounding_poly:
+          Image region to which this object belongs. This must be
+          populated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.LocalizedObjectAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LocalizedObjectAnnotation)
+
+SafeSearchAnnotation = _reflection.GeneratedProtocolMessageType(
+    "SafeSearchAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAFESEARCHANNOTATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Set of features pertaining to the image, computed by computer vision
+  methods over safe-search verticals (for example, adult, spoof, medical,
+  violence).
+  
+  
+  Attributes:
+      adult:
+          Represents the adult content likelihood for the image. Adult
+          content may contain elements such as nudity, pornographic
+          images or cartoons, or sexual activities.
+      spoof:
+          Spoof likelihood. The likelihood that an modification was made
+          to the image's canonical version to make it appear funny or
+          offensive.
+      medical:
+          Likelihood that this is a medical image.
+      violence:
+          Likelihood that this image contains violent content.
+      racy:
+          Likelihood that the request image contains racy content. Racy
+          content may include (but is not limited to) skimpy or sheer
+          clothing, strategically covered nudity, lewd or provocative
+          poses, or close-ups of sensitive body areas.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.SafeSearchAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(SafeSearchAnnotation)
+
+LatLongRect = _reflection.GeneratedProtocolMessageType(
+    "LatLongRect",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LATLONGRECT,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Rectangle determined by min and max ``LatLng`` pairs.
+  
+  
+  Attributes:
+      min_lat_lng:
+          Min lat/long pair.
+      max_lat_lng:
+          Max lat/long pair.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.LatLongRect)
+    ),
+)
+_sym_db.RegisterMessage(LatLongRect)
+
+ColorInfo = _reflection.GeneratedProtocolMessageType(
+    "ColorInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLORINFO,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Color information consists of RGB channels, score, and the fraction of
+  the image that the color occupies in the image.
+  
+  
+  Attributes:
+      color:
+          RGB components of the color.
+      score:
+          Image-specific score for this color. Value in range [0, 1].
+      pixel_fraction:
+          The fraction of pixels the color occupies in the image. Value
+          in range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ColorInfo)
+    ),
+)
+_sym_db.RegisterMessage(ColorInfo)
+
+DominantColorsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "DominantColorsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOMINANTCOLORSANNOTATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Set of dominant colors and their corresponding scores.
+  
+  
+  Attributes:
+      colors:
+          RGB color values with their score and pixel fraction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.DominantColorsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(DominantColorsAnnotation)
+
+ImageProperties = _reflection.GeneratedProtocolMessageType(
+    "ImageProperties",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPROPERTIES,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Stores image properties, such as dominant colors.
+  
+  
+  Attributes:
+      dominant_colors:
+          If present, dominant colors completed successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImageProperties)
+    ),
+)
+_sym_db.RegisterMessage(ImageProperties)
+
+CropHint = _reflection.GeneratedProtocolMessageType(
+    "CropHint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINT,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Single crop hint that is used to generate a new crop when serving an
+  image.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon for the crop region. The coordinates of
+          the bounding box are in the original image's scale.
+      confidence:
+          Confidence of this being a salient region. Range [0, 1].
+      importance_fraction:
+          Fraction of importance of this salient region with respect to
+          the original image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.CropHint)
+    ),
+)
+_sym_db.RegisterMessage(CropHint)
+
+CropHintsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "CropHintsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSANNOTATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Set of crop hints that are used to generate new crops when serving
+  images.
+  
+  
+  Attributes:
+      crop_hints:
+          Crop hint results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.CropHintsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsAnnotation)
+
+CropHintsParams = _reflection.GeneratedProtocolMessageType(
+    "CropHintsParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSPARAMS,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Parameters for crop hints annotation request.
+  
+  
+  Attributes:
+      aspect_ratios:
+          Aspect ratios in floats, representing the ratio of the width
+          to the height of the image. For example, if the desired aspect
+          ratio is 4/3, the corresponding float value should be 1.33333.
+          If not specified, the best possible crop is returned. The
+          number of provided aspect ratios is limited to a maximum of
+          16; any aspect ratios provided after the 16th are ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.CropHintsParams)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsParams)
+
+WebDetectionParams = _reflection.GeneratedProtocolMessageType(
+    "WebDetectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WEBDETECTIONPARAMS,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Parameters for web detection request.
+  
+  
+  Attributes:
+      include_geo_results:
+          Whether to include results derived from the geo information in
+          the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.WebDetectionParams)
+    ),
+)
+_sym_db.RegisterMessage(WebDetectionParams)
+
+ImageContext = _reflection.GeneratedProtocolMessageType(
+    "ImageContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECONTEXT,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Image context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      lat_long_rect:
+          Not used.
+      language_hints:
+          List of languages to use for TEXT\_DETECTION. 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). Text
+          detection returns an error if one or more of the specified
+          languages is not one of the `supported languages
+          </vision/docs/languages>`__.
+      crop_hints_params:
+          Parameters for crop hints annotation request.
+      product_search_params:
+          Parameters for product search.
+      web_detection_params:
+          Parameters for web detection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImageContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageContext)
+
+AnnotateImageRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Request for performing Google Cloud Vision API tasks over a
+  user-provided image, with user-requested features, and with context
+  information.
+  
+  
+  Attributes:
+      image:
+          The image to be processed.
+      features:
+          Requested features.
+      image_context:
+          Additional context that may accompany the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AnnotateImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageRequest)
+
+ImageAnnotationContext = _reflection.GeneratedProtocolMessageType(
+    "ImageAnnotationContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEANNOTATIONCONTEXT,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""If an image was produced from a file (e.g. a PDF), this message gives
+  information about the source of that image.
+  
+  
+  Attributes:
+      uri:
+          The URI of the file used to produce the image.
+      page_number:
+          If the file was a PDF or TIFF, this field gives the page
+          number within the file used to produce the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImageAnnotationContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageAnnotationContext)
+
+AnnotateImageResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGERESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Response to an image annotation request.
+  
+  
+  Attributes:
+      face_annotations:
+          If present, face detection has completed successfully.
+      landmark_annotations:
+          If present, landmark detection has completed successfully.
+      logo_annotations:
+          If present, logo detection has completed successfully.
+      label_annotations:
+          If present, label detection has completed successfully.
+      localized_object_annotations:
+          If present, localized object detection has completed
+          successfully. This will be sorted descending by confidence
+          score.
+      text_annotations:
+          If present, text (OCR) detection has completed successfully.
+      full_text_annotation:
+          If present, text (OCR) detection or document (OCR) text
+          detection has completed successfully. This annotation provides
+          the structural hierarchy for the OCR detected text.
+      safe_search_annotation:
+          If present, safe-search annotation has completed successfully.
+      image_properties_annotation:
+          If present, image properties were extracted successfully.
+      crop_hints_annotation:
+          If present, crop hints have completed successfully.
+      web_detection:
+          If present, web detection has completed successfully.
+      product_search_results:
+          If present, product search has completed successfully.
+      error:
+          If set, represents the error message for the operation. Note
+          that filled-in image annotations are guaranteed to be correct,
+          even when ``error`` is set.
+      context:
+          If present, contextual information is needed to understand
+          where this image comes from.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AnnotateImageResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageResponse)
+
+AnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Response to a single file annotation request. A file may contain one or
+  more images, which individually have their own responses.
+  
+  
+  Attributes:
+      input_config:
+          Information about the file for which this response is
+          generated.
+      responses:
+          Individual responses to images found within the file. This
+          field will be empty if the ``error`` field is set.
+      total_pages:
+          This field gives the total number of pages in the file.
+      error:
+          If set, represents the error message for the failed request.
+          The ``responses`` field will not be set in this case.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateFileResponse)
+
+BatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Multiple image annotation requests are batched into a single service
+  call.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+      parent:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.BatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesRequest)
+
+BatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Response to a batch image annotation request.
+  
+  
+  Attributes:
+      responses:
+          Individual responses to image annotation requests within the
+          batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.BatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesResponse)
+
+AnnotateFileRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateFileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEFILEREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""A request to annotate one single file, e.g. a PDF, TIFF or GIF file.
+  
+  
+  Attributes:
+      input_config:
+          Required. Information about the input file.
+      features:
+          Required. Requested features.
+      image_context:
+          Additional context that may accompany the image(s) in the
+          file.
+      pages:
+          Pages of the file to perform image annotation.  Pages starts
+          from 1, we assume the first page of the file is page 1. At
+          most 5 pages are supported per request. Pages can be negative.
+          Page 1 means the first page. Page 2 means the second page.
+          Page -1 means the last page. Page -2 means the second to the
+          last page.  If the file is GIF instead of PDF or TIFF, page
+          refers to GIF frames.  If this field is empty, by default the
+          service performs image annotation for the first 5 pages of the
+          file.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AnnotateFileRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateFileRequest)
+
+BatchAnnotateFilesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateFilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEFILESREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""A list of requests to annotate files using the BatchAnnotateFiles API.
+  
+  
+  Attributes:
+      requests:
+          The list of file annotation requests. Right now we support
+          only one AnnotateFileRequest in BatchAnnotateFilesRequest.
+      parent:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.BatchAnnotateFilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateFilesRequest)
+
+BatchAnnotateFilesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateFilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEFILESRESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""A list of file annotation responses.
+  
+  
+  Attributes:
+      responses:
+          The list of file annotation responses, each response
+          corresponding to each AnnotateFileRequest in
+          BatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.BatchAnnotateFilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateFilesResponse)
+
+AsyncAnnotateFileRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILEREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""An offline file annotation request.
+  
+  
+  Attributes:
+      input_config:
+          Required. Information about the input file.
+      features:
+          Required. Requested features.
+      image_context:
+          Additional context that may accompany the image(s) in the
+          file.
+      output_config:
+          Required. The desired output location and metadata (e.g.
+          format).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AsyncAnnotateFileRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileRequest)
+
+AsyncAnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""The response for a single offline file annotation request.
+  
+  
+  Attributes:
+      output_config:
+          The output location and metadata from
+          AsyncAnnotateFileRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AsyncAnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileResponse)
+
+AsyncBatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Request for async image annotation for a list of images.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+      output_config:
+          Required. The desired output location and metadata (e.g.
+          format).
+      parent:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AsyncBatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateImagesRequest)
+
+AsyncBatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Response to an async batch image annotation request.
+  
+  
+  Attributes:
+      output_config:
+          The output location and metadata from
+          AsyncBatchAnnotateImagesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AsyncBatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateImagesResponse)
+
+AsyncBatchAnnotateFilesRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESREQUEST,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Multiple async file annotation requests are batched into a single
+  service call.
+  
+  
+  Attributes:
+      requests:
+          Individual async file annotation requests for this batch.
+      parent:
+          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``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AsyncBatchAnnotateFilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesRequest)
+
+AsyncBatchAnnotateFilesResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESRESPONSE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Response to an async batch file annotation request.
+  
+  
+  Attributes:
+      responses:
+          The list of file annotation responses, one for each request in
+          AsyncBatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AsyncBatchAnnotateFilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesResponse)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""The desired input location and metadata.
+  
+  
+  Attributes:
+      gcs_source:
+          The Google Cloud Storage location to read the input from.
+      content:
+          File content, represented as a stream of bytes. Note: As with
+          all ``bytes`` fields, protobuffers use a pure binary
+          representation, whereas JSON representations use base64.
+          Currently, this field only works for BatchAnnotateFiles
+          requests. It does not work for AsyncBatchAnnotateFiles
+          requests.
+      mime_type:
+          The type of the file. Currently only "application/pdf",
+          "image/tiff" and "image/gif" are supported. Wildcards are not
+          supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""The desired output location and metadata.
+  
+  
+  Attributes:
+      gcs_destination:
+          The Google Cloud Storage location to write the output(s) to.
+      batch_size:
+          The max number of response protos to put into each output JSON
+          file 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 response protos will be
+          generated. If ``batch_size`` = 20, then 5 json files each
+          containing 20 response protos will be written under the prefix
+          ``gcs_destination``.\ ``uri``.  Currently, batch\_size only
+          applies to GcsDestination, with potential future support for
+          other output configurations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the input will be read from.
+  
+  
+  Attributes:
+      uri:
+          Google Cloud Storage URI for the input file. This must only be
+          a Google Cloud Storage object. Wildcards are not currently
+          supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the output will be written to.
+  
+  
+  Attributes:
+      uri:
+          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 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. Multiple outputs can happen if, for
+          example, the output JSON is too large and overflows into
+          multiple sharded files.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATIONMETADATA,
+        __module__="google.cloud.vision_v1.proto.image_annotator_pb2",
+        __doc__="""Contains metadata for the BatchAnnotateImages operation.
+  
+  
+  Attributes:
+      state:
+          Current state of the batch operation.
+      create_time:
+          The time when the batch request was received.
+      update_time:
+          The time when the operation result was last updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.OperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperationMetadata)
+
+
+DESCRIPTOR._options = None
+_ENTITYANNOTATION.fields_by_name["confidence"]._options = None
+
+_IMAGEANNOTATOR = _descriptor.ServiceDescriptor(
+    name="ImageAnnotator",
+    full_name="google.cloud.vision.v1.ImageAnnotator",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\025vision.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-vision"
+    ),
+    serialized_start=8159,
+    serialized_end=9387,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateImages",
+            full_name="google.cloud.vision.v1.ImageAnnotator.BatchAnnotateImages",
+            index=0,
+            containing_service=None,
+            input_type=_BATCHANNOTATEIMAGESREQUEST,
+            output_type=_BATCHANNOTATEIMAGESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\200\001"\023/v1/images:annotate:\001*Z8"3/v1/{parent=projects/*/locations/*}/images:annotate:\001*Z,"\'/v1/{parent=projects/*}/images:annotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateFiles",
+            full_name="google.cloud.vision.v1.ImageAnnotator.BatchAnnotateFiles",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHANNOTATEFILESREQUEST,
+            output_type=_BATCHANNOTATEFILESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002}"\022/v1/files:annotate:\001*Z7"2/v1/{parent=projects/*/locations/*}/files:annotate:\001*Z+"&/v1/{parent=projects/*}/files:annotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsyncBatchAnnotateImages",
+            full_name="google.cloud.vision.v1.ImageAnnotator.AsyncBatchAnnotateImages",
+            index=2,
+            containing_service=None,
+            input_type=_ASYNCBATCHANNOTATEIMAGESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\236\001"\035/v1/images:asyncBatchAnnotate:\001*ZB"=/v1/{parent=projects/*/locations/*}/images:asyncBatchAnnotate:\001*Z6"1/v1/{parent=projects/*}/images:asyncBatchAnnotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsyncBatchAnnotateFiles",
+            full_name="google.cloud.vision.v1.ImageAnnotator.AsyncBatchAnnotateFiles",
+            index=3,
+            containing_service=None,
+            input_type=_ASYNCBATCHANNOTATEFILESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002\233\001"\034/v1/files:asyncBatchAnnotate:\001*ZA"</v1/{parent=projects/*/locations/*}/files:asyncBatchAnnotate:\001*Z5"0/v1/{parent=projects/*}/files:asyncBatchAnnotate:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_IMAGEANNOTATOR)
+
+DESCRIPTOR.services_by_name["ImageAnnotator"] = _IMAGEANNOTATOR
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1/proto/image_annotator_pb2_grpc.py b/vision/google/cloud/vision_v1/proto/image_annotator_pb2_grpc.py
new file mode 100644
index 000000000000..01068cb9485a
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/image_annotator_pb2_grpc.py
@@ -0,0 +1,126 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1.proto import (
+    image_annotator_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class ImageAnnotatorStub(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.BatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1.ImageAnnotator/BatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.FromString,
+        )
+        self.BatchAnnotateFiles = channel.unary_unary(
+            "/google.cloud.vision.v1.ImageAnnotator/BatchAnnotateFiles",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesResponse.FromString,
+        )
+        self.AsyncBatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1.ImageAnnotator/AsyncBatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.AsyncBatchAnnotateFiles = channel.unary_unary(
+            "/google.cloud.vision.v1.ImageAnnotator/AsyncBatchAnnotateFiles",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ImageAnnotatorServicer(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def BatchAnnotateImages(self, request, context):
+        """Run image detection and annotation for a batch of images.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchAnnotateFiles(self, request, context):
+        """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 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsyncBatchAnnotateImages(self, request, context):
+        """Run asynchronous image detection and annotation for a list of images.
+
+    Progress and results can be retrieved through the
+    `google.longrunning.Operations` interface.
+    `Operation.metadata` contains `OperationMetadata` (metadata).
+    `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+
+    This service will write image annotation outputs to json files in customer
+    GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsyncBatchAnnotateFiles(self, request, context):
+        """Run asynchronous image detection and annotation for a list of generic
+    files, such as PDF files, which may contain multiple pages and multiple
+    images per page. Progress and results can be retrieved through the
+    `google.longrunning.Operations` interface.
+    `Operation.metadata` contains `OperationMetadata` (metadata).
+    `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ImageAnnotatorServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "BatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.SerializeToString,
+        ),
+        "BatchAnnotateFiles": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateFiles,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesResponse.SerializeToString,
+        ),
+        "AsyncBatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.AsyncBatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "AsyncBatchAnnotateFiles": grpc.unary_unary_rpc_method_handler(
+            servicer.AsyncBatchAnnotateFiles,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1.ImageAnnotator", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1/proto/product_search.proto b/vision/google/cloud/vision_v1/proto/product_search.proto
new file mode 100644
index 000000000000..065e3d54c2c5
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/product_search.proto
@@ -0,0 +1,124 @@
+// 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.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";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchProto";
+option java_package = "com.google.cloud.vision.v1";
+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.
+  BoundingPoly bounding_poly = 9;
+
+  // 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;
+
+  // 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.
+  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. An
+  // '=' should be used to connect the key and value.
+  //
+  // For example, "(color = red OR color = blue) AND brand = Google" is
+  // 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;
+}
+
+// Results for a product search request.
+message ProductSearchResults {
+  // Information about a product.
+  message Result {
+    // The Product.
+    Product product = 1;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    float score = 2;
+
+    // The resource name of the image from the product that is the closest match
+    // to the query.
+    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 {
+    // The bounding polygon around the product detected in the query image.
+    BoundingPoly bounding_poly = 1;
+
+    // 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
+  // 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.
+  repeated Result results = 5;
+
+  // List of results grouped by products detected in the query image. Each entry
+  // corresponds to one bounding polygon in the query image, and contains the
+  // matching products specific to that region. There may be duplicate product
+  // matches in the union of all the per-product results.
+  repeated GroupedResult product_grouped_results = 6;
+}
diff --git a/vision/google/cloud/vision_v1/proto/product_search_pb2.py b/vision/google/cloud/vision_v1/proto/product_search_pb2.py
new file mode 100644
index 000000000000..b94ce1d7c04e
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/product_search_pb2.py
@@ -0,0 +1,640 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1/proto/product_search.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1.proto import (
+    product_search_service_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1/proto/product_search.proto",
+    package="google.cloud.vision.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.vision.v1B\022ProductSearchProtoP\001Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n1google/cloud/vision_v1/proto/product_search.proto\x12\x16google.cloud.vision.v1\x1a\x1cgoogle/api/annotations.proto\x1a+google/cloud/vision_v1/proto/geometry.proto\x1a\x39google/cloud/vision_v1/proto/product_search_service.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x93\x01\n\x13ProductSearchParams\x12;\n\rbounding_poly\x18\t \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x13\n\x0bproduct_set\x18\x06 \x01(\t\x12\x1a\n\x12product_categories\x18\x07 \x03(\t\x12\x0e\n\x06\x66ilter\x18\x08 \x01(\t"\x88\x05\n\x14ProductSearchResults\x12.\n\nindex_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x44\n\x07results\x18\x05 \x03(\x0b\x32\x33.google.cloud.vision.v1.ProductSearchResults.Result\x12[\n\x17product_grouped_results\x18\x06 \x03(\x0b\x32:.google.cloud.vision.v1.ProductSearchResults.GroupedResult\x1aX\n\x06Result\x12\x30\n\x07product\x18\x01 \x01(\x0b\x32\x1f.google.cloud.vision.v1.Product\x12\r\n\x05score\x18\x02 \x01(\x02\x12\r\n\x05image\x18\x03 \x01(\t\x1aS\n\x10ObjectAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x1a\xed\x01\n\rGroupedResult\x12;\n\rbounding_poly\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x44\n\x07results\x18\x02 \x03(\x0b\x32\x33.google.cloud.vision.v1.ProductSearchResults.Result\x12Y\n\x12object_annotations\x18\x03 \x03(\x0b\x32=.google.cloud.vision.v1.ProductSearchResults.ObjectAnnotationBz\n\x1a\x63om.google.cloud.vision.v1B\x12ProductSearchProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_PRODUCTSEARCHPARAMS = _descriptor.Descriptor(
+    name="ProductSearchParams",
+    full_name="google.cloud.vision.v1.ProductSearchParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1.ProductSearchParams.bounding_poly",
+            index=0,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1.ProductSearchParams.product_set",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_categories",
+            full_name="google.cloud.vision.v1.ProductSearchParams.product_categories",
+            index=2,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.vision.v1.ProductSearchParams.filter",
+            index=3,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=245,
+    serialized_end=392,
+)
+
+
+_PRODUCTSEARCHRESULTS_RESULT = _descriptor.Descriptor(
+    name="Result",
+    full_name="google.cloud.vision.v1.ProductSearchResults.Result",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1.ProductSearchResults.Result.product",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.ProductSearchResults.Result.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1.ProductSearchResults.Result.image",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=630,
+    serialized_end=718,
+)
+
+_PRODUCTSEARCHRESULTS_OBJECTANNOTATION = _descriptor.Descriptor(
+    name="ObjectAnnotation",
+    full_name="google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=720,
+    serialized_end=803,
+)
+
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT = _descriptor.Descriptor(
+    name="GroupedResult",
+    full_name="google.cloud.vision.v1.ProductSearchResults.GroupedResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1.ProductSearchResults.GroupedResult.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.vision.v1.ProductSearchResults.GroupedResult.results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="object_annotations",
+            full_name="google.cloud.vision.v1.ProductSearchResults.GroupedResult.object_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=806,
+    serialized_end=1043,
+)
+
+_PRODUCTSEARCHRESULTS = _descriptor.Descriptor(
+    name="ProductSearchResults",
+    full_name="google.cloud.vision.v1.ProductSearchResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="index_time",
+            full_name="google.cloud.vision.v1.ProductSearchResults.index_time",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.vision.v1.ProductSearchResults.results",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_grouped_results",
+            full_name="google.cloud.vision.v1.ProductSearchResults.product_grouped_results",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _PRODUCTSEARCHRESULTS_RESULT,
+        _PRODUCTSEARCHRESULTS_OBJECTANNOTATION,
+        _PRODUCTSEARCHRESULTS_GROUPEDRESULT,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=395,
+    serialized_end=1043,
+)
+
+_PRODUCTSEARCHPARAMS.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PRODUCTSEARCHRESULTS_RESULT.fields_by_name[
+    "product"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2._PRODUCT
+)
+_PRODUCTSEARCHRESULTS_RESULT.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS_OBJECTANNOTATION.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.fields_by_name[
+    "results"
+].message_type = _PRODUCTSEARCHRESULTS_RESULT
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.fields_by_name[
+    "object_annotations"
+].message_type = _PRODUCTSEARCHRESULTS_OBJECTANNOTATION
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "index_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "results"
+].message_type = _PRODUCTSEARCHRESULTS_RESULT
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "product_grouped_results"
+].message_type = _PRODUCTSEARCHRESULTS_GROUPEDRESULT
+DESCRIPTOR.message_types_by_name["ProductSearchParams"] = _PRODUCTSEARCHPARAMS
+DESCRIPTOR.message_types_by_name["ProductSearchResults"] = _PRODUCTSEARCHRESULTS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ProductSearchParams = _reflection.GeneratedProtocolMessageType(
+    "ProductSearchParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSEARCHPARAMS,
+        __module__="google.cloud.vision_v1.proto.product_search_pb2",
+        __doc__="""Parameters for a product search request.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the area of interest in the image.
+          Optional. If it is not specified, system discretion will be
+          applied.
+      product_set:
+          The resource name of a
+          [ProductSet][google.cloud.vision.v1.ProductSet] to be searched
+          for similar images.  Format is: ``projects/PROJECT_ID/location
+          s/LOC_ID/productSets/PRODUCT_SET_ID``.
+      product_categories:
+          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.
+      filter:
+          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. An '=' should be used to connect
+          the key and value.  For example, "(color = red OR color =
+          blue) AND brand = Google" is acceptable, but "(color = red OR
+          brand = Google)" is not acceptable. "color: red" is not
+          acceptable because it uses a ':' instead of an '='.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSearchParams)
+    ),
+)
+_sym_db.RegisterMessage(ProductSearchParams)
+
+ProductSearchResults = _reflection.GeneratedProtocolMessageType(
+    "ProductSearchResults",
+    (_message.Message,),
+    dict(
+        Result=_reflection.GeneratedProtocolMessageType(
+            "Result",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_RESULT,
+                __module__="google.cloud.vision_v1.proto.product_search_pb2",
+                __doc__="""Information about a product.
+    
+    
+    Attributes:
+        product:
+            The Product.
+        score:
+            A confidence level on the match, ranging from 0 (no
+            confidence) to 1 (full confidence).
+        image:
+            The resource name of the image from the product that is the
+            closest match to the query.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSearchResults.Result)
+            ),
+        ),
+        ObjectAnnotation=_reflection.GeneratedProtocolMessageType(
+            "ObjectAnnotation",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_OBJECTANNOTATION,
+                __module__="google.cloud.vision_v1.proto.product_search_pb2",
+                __doc__="""Prediction for what the object in the bounding box is.
+    
+    
+    Attributes:
+        mid:
+            Object ID that should align with EntityAnnotation mid.
+        language_code:
+            The BCP-47 language code, such as "en-US" or "sr-Latn". For
+            more information, see http://www.unicode.org/reports/tr35/#Uni
+            code\_locale\_identifier.
+        name:
+            Object name, expressed in its ``language_code`` language.
+        score:
+            Score of the result. Range [0, 1].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSearchResults.ObjectAnnotation)
+            ),
+        ),
+        GroupedResult=_reflection.GeneratedProtocolMessageType(
+            "GroupedResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_GROUPEDRESULT,
+                __module__="google.cloud.vision_v1.proto.product_search_pb2",
+                __doc__="""Information about the products similar to a single product in a query
+    image.
+    
+    
+    Attributes:
+        bounding_poly:
+            The bounding polygon around the product detected in the query
+            image.
+        results:
+            List of results, one for each product match.
+        object_annotations:
+            List of generic predictions for the object in the bounding
+            box.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSearchResults.GroupedResult)
+            ),
+        ),
+        DESCRIPTOR=_PRODUCTSEARCHRESULTS,
+        __module__="google.cloud.vision_v1.proto.product_search_pb2",
+        __doc__="""Results for a product search request.
+  
+  
+  Attributes:
+      index_time:
+          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.
+      results:
+          List of results, one for each product match.
+      product_grouped_results:
+          List of results grouped by products detected in the query
+          image. Each entry corresponds to one bounding polygon in the
+          query image, and contains the matching products specific to
+          that region. There may be duplicate product matches in the
+          union of all the per-product results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSearchResults)
+    ),
+)
+_sym_db.RegisterMessage(ProductSearchResults)
+_sym_db.RegisterMessage(ProductSearchResults.Result)
+_sym_db.RegisterMessage(ProductSearchResults.ObjectAnnotation)
+_sym_db.RegisterMessage(ProductSearchResults.GroupedResult)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1/proto/product_search_pb2_grpc.py b/vision/google/cloud/vision_v1/proto/product_search_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/product_search_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1/proto/product_search_service.proto b/vision/google/cloud/vision_v1/proto/product_search_service.proto
new file mode 100644
index 000000000000..0fae1f80a658
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/product_search_service.proto
@@ -0,0 +1,908 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/vision/v1/geometry.proto";
+import "google/longrunning/operations.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;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchServiceProto";
+option java_package = "com.google.cloud.vision.v1";
+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.
+//
+// In parallel,
+//
+// - 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
+//   `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:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+  //   4096 characters.
+  rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/productSets"
+      body: "product_set"
+    };
+  }
+
+  // Lists ProductSets in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+  //   than 1.
+  rpc ListProductSets(ListProductSetsRequest)
+      returns (ListProductSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/productSets"
+    };
+  }
+
+  // Gets information associated with a ProductSet.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  rpc GetProductSet(GetProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Makes changes to a ProductSet resource.
+  // Only display_name can be updated currently.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+  //   missing from the request or longer than 4096 characters.
+  rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      patch: "/v1/{product_set.name=projects/*/locations/*/productSets/*}"
+      body: "product_set"
+    };
+  }
+
+  // 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) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Creates and returns a new product resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+  rpc CreateProduct(CreateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/products"
+      body: "product"
+    };
+  }
+
+  // Lists products in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*}/products"
+    };
+  }
+
+  // Gets information associated with a Product.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  rpc GetProduct(GetProductRequest) returns (Product) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Makes changes to a Product resource.
+  // Only the `display_name`, `description`, and `labels` fields can be updated
+  // right now.
+  //
+  // If labels are updated, the change will not be reflected in queries until
+  // the next index time.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+  //   missing from the request or longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if description is present in update_mask but is
+  //   longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+  rpc UpdateProduct(UpdateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      patch: "/v1/{product.name=projects/*/locations/*/products/*}"
+      body: "product"
+    };
+  }
+
+  // Permanently deletes a product and its reference images.
+  //
+  // 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.
+  rpc DeleteProduct(DeleteProductRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Creates and returns a new ReferenceImage resource.
+  //
+  // The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+  // the system will try to detect regions of interest in the image that are
+  // compatible with the product_category on the parent product. If it is
+  // specified, detection is ALWAYS skipped. The system converts polygons into
+  // non-rotated rectangles.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 50MP).
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if the product does not exist.
+  // * 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) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/products/*}/referenceImages"
+      body: "reference_image"
+    };
+  }
+
+  // Permanently deletes a reference image.
+  //
+  // The image metadata will be deleted right away, but search queries
+  // against ProductSets containing the image may still work until all related
+  // caches are refreshed.
+  //
+  // The actual image files are not deleted from Google Cloud Storage.
+  rpc DeleteReferenceImage(DeleteReferenceImageRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Lists reference images.
+  //
+  // Possible errors:
+  //
+  // * 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) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/products/*}/referenceImages"
+    };
+  }
+
+  // Gets information associated with a ReferenceImage.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the specified image does not exist.
+  rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Adds a Product to the specified ProductSet. If the Product is already
+  // present, no change is made.
+  //
+  // One Product can be added to at most 100 ProductSets.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+  rpc AddProductToProductSet(AddProductToProductSetRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/productSets/*}:addProduct"
+      body: "*"
+    };
+  }
+
+  // Removes a Product from the specified ProductSet.
+  rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/productSets/*}:removeProduct"
+      body: "*"
+    };
+  }
+
+  // Lists the Products in a ProductSet, in an unspecified order. If the
+  // ProductSet does not exist, the products field of the response will be
+  // empty.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProductsInProductSet(ListProductsInProductSetRequest)
+      returns (ListProductsInProductSetResponse) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/productSets/*}/products"
+    };
+  }
+
+  // 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.
+  // `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) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/productSets:import"
+      body: "*"
+    };
+  }
+
+  // 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: "*"
+    };
+  }
+}
+
+// A Product contains ReferenceImages.
+message 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
+    // exceed 128 bytes.
+    string key = 1;
+
+    // The value of the label attached to the product. Cannot be empty and
+    // cannot exceed 128 bytes.
+    string value = 2;
+  }
+
+  // The resource name of the product.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  //
+  // This field is ignored when creating a product.
+  string name = 1;
+
+  // The user-provided name for this Product. Must not be empty. Must be at most
+  // 4096 characters long.
+  string display_name = 2;
+
+  // User-provided metadata to be stored with this product. Must be at most 4096
+  // characters long.
+  string description = 3;
+
+  // 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.
+  //
+  // This field is immutable.
+  string product_category = 4;
+
+  // Key-value pairs that can be attached to a product. At query time,
+  // constraints can be specified based on the product_labels.
+  //
+  // Note that integer values can be provided as strings, e.g. "1199". Only
+  // strings with integer values can match a range-based restriction which is
+  // to be supported soon.
+  //
+  // Multiple values can be assigned to the same key. One product may have up to
+  // 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;
+}
+
+// A ProductSet contains Products. A ProductSet can contain a maximum of 1
+// million reference images. If the limit is exceeded, periodic indexing will
+// fail.
+message ProductSet {
+  // The resource name of the ProductSet.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  //
+  // This field is ignored when creating a ProductSet.
+  string name = 1;
+
+  // The user-provided name for this ProductSet. Must not be empty. Must be at
+  // most 4096 characters long.
+  string display_name = 2;
+
+  // Output only. The time at which this ProductSet was last indexed. Query
+  // results will reflect all updates before this time. If this ProductSet has
+  // never been indexed, this timestamp is the default value
+  // "1970-01-01T00:00:00Z".
+  //
+  // This field is ignored when creating a ProductSet.
+  google.protobuf.Timestamp index_time = 3;
+
+  // 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;
+}
+
+// A `ReferenceImage` represents a product image and its associated metadata,
+// such as bounding boxes.
+message ReferenceImage {
+  // The resource name of the reference image.
+  //
+  // Format is:
+  //
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
+  //
+  // This field is ignored when creating a reference image.
+  string name = 1;
+
+  // The Google Cloud Storage URI of the reference image.
+  //
+  // The URI must start with `gs://`.
+  //
+  // Required.
+  string uri = 2;
+
+  // 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
+  // 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;
+}
+
+// Request message for the `CreateProduct` method.
+message CreateProductRequest {
+  // The project in which the Product should be created.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The product to create.
+  Product product = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_id = 3;
+}
+
+// Request message for the `ListProducts` method.
+message ListProductsRequest {
+  // The project OR ProductSet from which Products should be listed.
+  //
+  // Format:
+  // `projects/PROJECT_ID/locations/LOC_ID`
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProducts` method.
+message ListProductsResponse {
+  // List of products.
+  repeated Product products = 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 message for the `GetProduct` method.
+message GetProductRequest {
+  // Resource name of the Product to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProduct` method.
+message UpdateProductRequest {
+  // The Product resource which replaces the one on the server.
+  // product.name is immutable.
+  Product product = 1;
+
+  // 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
+  // `description`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProduct` method.
+message DeleteProductRequest {
+  // Resource name of product to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateProductSet` method.
+message CreateProductSetRequest {
+  // The project in which the ProductSet should be created.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The ProductSet to create.
+  ProductSet product_set = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_set_id = 3;
+}
+
+// Request message for the `ListProductSets` method.
+message ListProductSetsRequest {
+  // The project from which ProductSets should be listed.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductSets` method.
+message ListProductSetsResponse {
+  // List of ProductSets.
+  repeated ProductSet product_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;
+}
+
+// Request message for the `GetProductSet` method.
+message GetProductSetRequest {
+  // Resource name of the ProductSet to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProductSet` method.
+message UpdateProductSetRequest {
+  // The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1;
+
+  // 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 path is `display_name`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProductSet` method.
+message DeleteProductSetRequest {
+  // Resource name of the ProductSet to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateReferenceImage` method.
+message CreateReferenceImageRequest {
+  // 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.
+  // If an image ID is specified, it is ignored.
+  ReferenceImage reference_image = 2;
+
+  // 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
+  // already in use, an error is returned with code ALREADY_EXISTS. Must be at
+  // most 128 characters long. It cannot contain the character `/`.
+  string reference_image_id = 3;
+}
+
+// Request message for the `ListReferenceImages` method.
+message ListReferenceImagesRequest {
+  // Resource name of the product containing the reference images.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // A token identifying a page of results to be returned. This is the value
+  // of `nextPageToken` returned in a previous reference image list request.
+  //
+  // Defaults to the first page if not specified.
+  string page_token = 3;
+}
+
+// Response message for the `ListReferenceImages` method.
+message ListReferenceImagesResponse {
+  // The list of reference images.
+  repeated ReferenceImage reference_images = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string next_page_token = 3;
+}
+
+// Request message for the `GetReferenceImage` method.
+message GetReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `DeleteReferenceImage` method.
+message DeleteReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `AddProductToProductSet` method.
+message AddProductToProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `RemoveProductFromProductSet` method.
+message RemoveProductFromProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetRequest {
+  // The ProductSet resource for which to retrieve Products.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetResponse {
+  // The list of Products.
+  repeated Product products = 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 Google Cloud Storage location for a csv file which preserves a list of
+// ImportProductSetRequests in each line.
+message ImportProductSetsGcsSource {
+  // The Google Cloud Storage URI of the input csv file.
+  //
+  // The URI must start with `gs://`.
+  //
+  // The format of the input csv file should be one image per line.
+  // In each line, there are 8 columns.
+  //
+  // 1.  image-uri
+  // 2.  image-id
+  // 3.  product-set-id
+  // 4.  product-id
+  // 5.  product-category
+  // 6.  product-display-name
+  // 7.  labels
+  // 8.  bounding-poly
+  //
+  // The `image-uri`, `product-set-id`, `product-id`, and `product-category`
+  // columns are required. All other columns are optional.
+  //
+  // If the `ProductSet` or `Product` specified by the `product-set-id` and
+  // `product-id` values does not exist, then the system will create a new
+  // `ProductSet` or `Product` for the image. In this case, the
+  // `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].
+  //
+  // 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.
+  //
+  // If a `Product` with the specified `product-id` already exists, then the
+  // system ignores the `product-display-name`, `product-category`, and `labels`
+  // columns.
+  //
+  // The `labels` column (optional) is a line containing a list of
+  // comma-separated key-value pairs, in the following format:
+  //
+  //     "key_1=value_1,key_2=value_2,...,key_n=value_n"
+  //
+  // The `bounding-poly` column (optional) identifies one region of
+  // interest from the image in the same manner as `CreateReferenceImage`. If
+  // you do not specify the `bounding-poly` column, then the system will try to
+  // detect regions of interest automatically.
+  //
+  // At most one `bounding-poly` column is allowed per line. If the image
+  // contains multiple regions of interest, add a line to the CSV file that
+  // includes the same product information, and the `bounding-poly` values for
+  // each region of interest.
+  //
+  // The `bounding-poly` column must contain an even number of comma-separated
+  // numbers, in the format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Use
+  // non-negative integers for absolute bounding polygons, and float values
+  // in [0, 1] for normalized bounding polygons.
+  //
+  // The system will resize the image if the image resolution is too
+  // large to process (larger than 20MP).
+  string csv_file_uri = 1;
+}
+
+// The input content for the `ImportProductSets` method.
+message ImportProductSetsInputConfig {
+  // The source of the input.
+  oneof source {
+    // The Google Cloud Storage location for a csv file which preserves a list
+    // of ImportProductSetRequests in each line.
+    ImportProductSetsGcsSource gcs_source = 1;
+  }
+}
+
+// Request message for the `ImportProductSets` method.
+message ImportProductSetsRequest {
+  // 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;
+}
+
+// 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.
+message ImportProductSetsResponse {
+  // The list of reference_images that are imported successfully.
+  repeated ReferenceImage reference_images = 1;
+
+  // The rpc status for each ImportProductSet request, including both successes
+  // and errors.
+  //
+  // The number of statuses here matches the number of lines in the csv file,
+  // and statuses[i] stores the success or failure status of processing the i-th
+  // line of the csv, starting from line 0.
+  repeated google.rpc.Status statuses = 2;
+}
+
+// Metadata for the batch operations such as the current state.
+//
+// This is included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message BatchOperationMetadata {
+  // Enumerates the possible states that the batch request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is actively being processed.
+    PROCESSING = 1;
+
+    // The request is done and at least one item has been successfully
+    // processed.
+    SUCCESSFUL = 2;
+
+    // The request is done and no item has been successfully processed.
+    FAILED = 3;
+
+    // The request is done after the longrunning.Operations.CancelOperation has
+    // been called by the user.  Any records that were processed before the
+    // cancel command are output as specified in the request.
+    CANCELLED = 4;
+  }
+
+  // The current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was submitted to the server.
+  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.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;
+  }
+
+  // The project and location in which the Products should be deleted.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The default value is false. Override this value to true to actually perform
+  // the purge.
+  bool force = 4;
+}
diff --git a/vision/google/cloud/vision_v1/proto/product_search_service_pb2.py b/vision/google/cloud/vision_v1/proto/product_search_service_pb2.py
new file mode 100644
index 000000000000..85b4b8dccb99
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/product_search_service_pb2.py
@@ -0,0 +1,3260 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1/proto/product_search_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.api import client_pb2 as google_dot_api_dot_client__pb2
+from google.cloud.vision_v1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1/proto/product_search_service.proto",
+    package="google.cloud.vision.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.vision.v1B\031ProductSearchServiceProtoP\001Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1/proto/product_search_service.proto\x12\x16google.cloud.vision.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a+google/cloud/vision_v1/proto/geometry.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xc6\x01\n\x07Product\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x18\n\x10product_category\x18\x04 \x01(\t\x12@\n\x0eproduct_labels\x18\x05 \x03(\x0b\x32(.google.cloud.vision.v1.Product.KeyValue\x1a&\n\x08KeyValue\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t"\x89\x01\n\nProductSet\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12.\n\nindex_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\'\n\x0bindex_error\x18\x04 \x01(\x0b\x32\x12.google.rpc.Status"i\n\x0eReferenceImage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12<\n\x0e\x62ounding_polys\x18\x03 \x03(\x0b\x32$.google.cloud.vision.v1.BoundingPoly"l\n\x14\x43reateProductRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x30\n\x07product\x18\x02 \x01(\x0b\x32\x1f.google.cloud.vision.v1.Product\x12\x12\n\nproduct_id\x18\x03 \x01(\t"L\n\x13ListProductsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"b\n\x14ListProductsResponse\x12\x31\n\x08products\x18\x01 \x03(\x0b\x32\x1f.google.cloud.vision.v1.Product\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"!\n\x11GetProductRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"y\n\x14UpdateProductRequest\x12\x30\n\x07product\x18\x01 \x01(\x0b\x32\x1f.google.cloud.vision.v1.Product\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteProductRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"z\n\x17\x43reateProductSetRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x37\n\x0bproduct_set\x18\x02 \x01(\x0b\x32".google.cloud.vision.v1.ProductSet\x12\x16\n\x0eproduct_set_id\x18\x03 \x01(\t"O\n\x16ListProductSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"l\n\x17ListProductSetsResponse\x12\x38\n\x0cproduct_sets\x18\x01 \x03(\x0b\x32".google.cloud.vision.v1.ProductSet\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"$\n\x14GetProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x83\x01\n\x17UpdateProductSetRequest\x12\x37\n\x0bproduct_set\x18\x01 \x01(\x0b\x32".google.cloud.vision.v1.ProductSet\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\'\n\x17\x44\x65leteProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8a\x01\n\x1b\x43reateReferenceImageRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12?\n\x0freference_image\x18\x02 \x01(\x0b\x32&.google.cloud.vision.v1.ReferenceImage\x12\x1a\n\x12reference_image_id\x18\x03 \x01(\t"S\n\x1aListReferenceImagesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x8b\x01\n\x1bListReferenceImagesResponse\x12@\n\x10reference_images\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1.ReferenceImage\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"(\n\x18GetReferenceImageRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"+\n\x1b\x44\x65leteReferenceImageRequest\x12\x0c\n\x04name\x18\x01 \x01(\t">\n\x1d\x41\x64\x64ProductToProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07product\x18\x02 \x01(\t"C\n"RemoveProductFromProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07product\x18\x02 \x01(\t"V\n\x1fListProductsInProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"n\n ListProductsInProductSetResponse\x12\x31\n\x08products\x18\x01 \x03(\x0b\x32\x1f.google.cloud.vision.v1.Product\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"2\n\x1aImportProductSetsGcsSource\x12\x14\n\x0c\x63sv_file_uri\x18\x01 \x01(\t"r\n\x1cImportProductSetsInputConfig\x12H\n\ngcs_source\x18\x01 \x01(\x0b\x32\x32.google.cloud.vision.v1.ImportProductSetsGcsSourceH\x00\x42\x08\n\x06source"v\n\x18ImportProductSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12J\n\x0cinput_config\x18\x02 \x01(\x0b\x32\x34.google.cloud.vision.v1.ImportProductSetsInputConfig"\x83\x01\n\x19ImportProductSetsResponse\x12@\n\x10reference_images\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1.ReferenceImage\x12$\n\x08statuses\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status"\x97\x02\n\x16\x42\x61tchOperationMetadata\x12\x43\n\x05state\x18\x01 \x01(\x0e\x32\x34.google.cloud.vision.v1.BatchOperationMetadata.State\x12/\n\x0bsubmit_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Y\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0e\n\nPROCESSING\x10\x01\x12\x0e\n\nSUCCESSFUL\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\r\n\tCANCELLED\x10\x04"/\n\x15ProductSetPurgeConfig\x12\x16\n\x0eproduct_set_id\x18\x01 \x01(\t"\xb4\x01\n\x14PurgeProductsRequest\x12Q\n\x18product_set_purge_config\x18\x02 \x01(\x0b\x32-.google.cloud.vision.v1.ProductSetPurgeConfigH\x00\x12 \n\x16\x64\x65lete_orphan_products\x18\x03 \x01(\x08H\x00\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\r\n\x05\x66orce\x18\x04 \x01(\x08\x42\x08\n\x06target2\xe5\x1a\n\rProductSearch\x12\xad\x01\n\x10\x43reateProductSet\x12/.google.cloud.vision.v1.CreateProductSetRequest\x1a".google.cloud.vision.v1.ProductSet"D\x82\xd3\xe4\x93\x02>"//v1/{parent=projects/*/locations/*}/productSets:\x0bproduct_set\x12\xab\x01\n\x0fListProductSets\x12..google.cloud.vision.v1.ListProductSetsRequest\x1a/.google.cloud.vision.v1.ListProductSetsResponse"7\x82\xd3\xe4\x93\x02\x31\x12//v1/{parent=projects/*/locations/*}/productSets\x12\x9a\x01\n\rGetProductSet\x12,.google.cloud.vision.v1.GetProductSetRequest\x1a".google.cloud.vision.v1.ProductSet"7\x82\xd3\xe4\x93\x02\x31\x12//v1/{name=projects/*/locations/*/productSets/*}\x12\xb9\x01\n\x10UpdateProductSet\x12/.google.cloud.vision.v1.UpdateProductSetRequest\x1a".google.cloud.vision.v1.ProductSet"P\x82\xd3\xe4\x93\x02J2;/v1/{product_set.name=projects/*/locations/*/productSets/*}:\x0bproduct_set\x12\x94\x01\n\x10\x44\x65leteProductSet\x12/.google.cloud.vision.v1.DeleteProductSetRequest\x1a\x16.google.protobuf.Empty"7\x82\xd3\xe4\x93\x02\x31*//v1/{name=projects/*/locations/*/productSets/*}\x12\x9d\x01\n\rCreateProduct\x12,.google.cloud.vision.v1.CreateProductRequest\x1a\x1f.google.cloud.vision.v1.Product"=\x82\xd3\xe4\x93\x02\x37",/v1/{parent=projects/*/locations/*}/products:\x07product\x12\x9f\x01\n\x0cListProducts\x12+.google.cloud.vision.v1.ListProductsRequest\x1a,.google.cloud.vision.v1.ListProductsResponse"4\x82\xd3\xe4\x93\x02.\x12,/v1/{parent=projects/*/locations/*}/products\x12\x8e\x01\n\nGetProduct\x12).google.cloud.vision.v1.GetProductRequest\x1a\x1f.google.cloud.vision.v1.Product"4\x82\xd3\xe4\x93\x02.\x12,/v1/{name=projects/*/locations/*/products/*}\x12\xa5\x01\n\rUpdateProduct\x12,.google.cloud.vision.v1.UpdateProductRequest\x1a\x1f.google.cloud.vision.v1.Product"E\x82\xd3\xe4\x93\x02?24/v1/{product.name=projects/*/locations/*/products/*}:\x07product\x12\x8b\x01\n\rDeleteProduct\x12,.google.cloud.vision.v1.DeleteProductRequest\x1a\x16.google.protobuf.Empty"4\x82\xd3\xe4\x93\x02.*,/v1/{name=projects/*/locations/*/products/*}\x12\xcc\x01\n\x14\x43reateReferenceImage\x12\x33.google.cloud.vision.v1.CreateReferenceImageRequest\x1a&.google.cloud.vision.v1.ReferenceImage"W\x82\xd3\xe4\x93\x02Q">/v1/{parent=projects/*/locations/*/products/*}/referenceImages:\x0freference_image\x12\xab\x01\n\x14\x44\x65leteReferenceImage\x12\x33.google.cloud.vision.v1.DeleteReferenceImageRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02@*>/v1/{name=projects/*/locations/*/products/*/referenceImages/*}\x12\xc6\x01\n\x13ListReferenceImages\x12\x32.google.cloud.vision.v1.ListReferenceImagesRequest\x1a\x33.google.cloud.vision.v1.ListReferenceImagesResponse"F\x82\xd3\xe4\x93\x02@\x12>/v1/{parent=projects/*/locations/*/products/*}/referenceImages\x12\xb5\x01\n\x11GetReferenceImage\x12\x30.google.cloud.vision.v1.GetReferenceImageRequest\x1a&.google.cloud.vision.v1.ReferenceImage"F\x82\xd3\xe4\x93\x02@\x12>/v1/{name=projects/*/locations/*/products/*/referenceImages/*}\x12\xae\x01\n\x16\x41\x64\x64ProductToProductSet\x12\x35.google.cloud.vision.v1.AddProductToProductSetRequest\x1a\x16.google.protobuf.Empty"E\x82\xd3\xe4\x93\x02?":/v1/{name=projects/*/locations/*/productSets/*}:addProduct:\x01*\x12\xbb\x01\n\x1bRemoveProductFromProductSet\x12:.google.cloud.vision.v1.RemoveProductFromProductSetRequest\x1a\x16.google.protobuf.Empty"H\x82\xd3\xe4\x93\x02\x42"=/v1/{name=projects/*/locations/*/productSets/*}:removeProduct:\x01*\x12\xcf\x01\n\x18ListProductsInProductSet\x12\x37.google.cloud.vision.v1.ListProductsInProductSetRequest\x1a\x38.google.cloud.vision.v1.ListProductsInProductSetResponse"@\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/locations/*/productSets/*}/products\x12\xa7\x01\n\x11ImportProductSets\x12\x30.google.cloud.vision.v1.ImportProductSetsRequest\x1a\x1d.google.longrunning.Operation"A\x82\xd3\xe4\x93\x02;"6/v1/{parent=projects/*/locations/*}/productSets:import:\x01*\x12\x9b\x01\n\rPurgeProducts\x12,.google.cloud.vision.v1.PurgeProductsRequest\x1a\x1d.google.longrunning.Operation"=\x82\xd3\xe4\x93\x02\x37"2/v1/{parent=projects/*/locations/*}/products:purge:\x01*\x1av\xca\x41\x15vision.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-visionB\x81\x01\n\x1a\x63om.google.cloud.vision.v1B\x19ProductSearchServiceProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_api_dot_client__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_BATCHOPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1.BatchOperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROCESSING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESSFUL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3204,
+    serialized_end=3293,
+)
+_sym_db.RegisterEnumDescriptor(_BATCHOPERATIONMETADATA_STATE)
+
+
+_PRODUCT_KEYVALUE = _descriptor.Descriptor(
+    name="KeyValue",
+    full_name="google.cloud.vision.v1.Product.KeyValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.vision.v1.Product.KeyValue.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1.Product.KeyValue.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=504,
+    serialized_end=542,
+)
+
+_PRODUCT = _descriptor.Descriptor(
+    name="Product",
+    full_name="google.cloud.vision.v1.Product",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.Product.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.vision.v1.Product.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1.Product.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_category",
+            full_name="google.cloud.vision.v1.Product.product_category",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_labels",
+            full_name="google.cloud.vision.v1.Product.product_labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRODUCT_KEYVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=344,
+    serialized_end=542,
+)
+
+
+_PRODUCTSET = _descriptor.Descriptor(
+    name="ProductSet",
+    full_name="google.cloud.vision.v1.ProductSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.ProductSet.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.vision.v1.ProductSet.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_time",
+            full_name="google.cloud.vision.v1.ProductSet.index_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_error",
+            full_name="google.cloud.vision.v1.ProductSet.index_error",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=545,
+    serialized_end=682,
+)
+
+
+_REFERENCEIMAGE = _descriptor.Descriptor(
+    name="ReferenceImage",
+    full_name="google.cloud.vision.v1.ReferenceImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.ReferenceImage.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1.ReferenceImage.uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_polys",
+            full_name="google.cloud.vision.v1.ReferenceImage.bounding_polys",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=684,
+    serialized_end=789,
+)
+
+
+_CREATEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="CreateProductRequest",
+    full_name="google.cloud.vision.v1.CreateProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.CreateProductRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1.CreateProductRequest.product",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_id",
+            full_name="google.cloud.vision.v1.CreateProductRequest.product_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=791,
+    serialized_end=899,
+)
+
+
+_LISTPRODUCTSREQUEST = _descriptor.Descriptor(
+    name="ListProductsRequest",
+    full_name="google.cloud.vision.v1.ListProductsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.ListProductsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1.ListProductsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1.ListProductsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=901,
+    serialized_end=977,
+)
+
+
+_LISTPRODUCTSRESPONSE = _descriptor.Descriptor(
+    name="ListProductsResponse",
+    full_name="google.cloud.vision.v1.ListProductsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1.ListProductsResponse.products",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1.ListProductsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=979,
+    serialized_end=1077,
+)
+
+
+_GETPRODUCTREQUEST = _descriptor.Descriptor(
+    name="GetProductRequest",
+    full_name="google.cloud.vision.v1.GetProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.GetProductRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1079,
+    serialized_end=1112,
+)
+
+
+_UPDATEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="UpdateProductRequest",
+    full_name="google.cloud.vision.v1.UpdateProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1.UpdateProductRequest.product",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.vision.v1.UpdateProductRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1114,
+    serialized_end=1235,
+)
+
+
+_DELETEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="DeleteProductRequest",
+    full_name="google.cloud.vision.v1.DeleteProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.DeleteProductRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1237,
+    serialized_end=1273,
+)
+
+
+_CREATEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="CreateProductSetRequest",
+    full_name="google.cloud.vision.v1.CreateProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.CreateProductSetRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1.CreateProductSetRequest.product_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set_id",
+            full_name="google.cloud.vision.v1.CreateProductSetRequest.product_set_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1275,
+    serialized_end=1397,
+)
+
+
+_LISTPRODUCTSETSREQUEST = _descriptor.Descriptor(
+    name="ListProductSetsRequest",
+    full_name="google.cloud.vision.v1.ListProductSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.ListProductSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1.ListProductSetsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1.ListProductSetsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1399,
+    serialized_end=1478,
+)
+
+
+_LISTPRODUCTSETSRESPONSE = _descriptor.Descriptor(
+    name="ListProductSetsResponse",
+    full_name="google.cloud.vision.v1.ListProductSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_sets",
+            full_name="google.cloud.vision.v1.ListProductSetsResponse.product_sets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1.ListProductSetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1480,
+    serialized_end=1588,
+)
+
+
+_GETPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="GetProductSetRequest",
+    full_name="google.cloud.vision.v1.GetProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.GetProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1590,
+    serialized_end=1626,
+)
+
+
+_UPDATEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="UpdateProductSetRequest",
+    full_name="google.cloud.vision.v1.UpdateProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1.UpdateProductSetRequest.product_set",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.vision.v1.UpdateProductSetRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1629,
+    serialized_end=1760,
+)
+
+
+_DELETEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="DeleteProductSetRequest",
+    full_name="google.cloud.vision.v1.DeleteProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.DeleteProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1762,
+    serialized_end=1801,
+)
+
+
+_CREATEREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="CreateReferenceImageRequest",
+    full_name="google.cloud.vision.v1.CreateReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.CreateReferenceImageRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_image",
+            full_name="google.cloud.vision.v1.CreateReferenceImageRequest.reference_image",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_image_id",
+            full_name="google.cloud.vision.v1.CreateReferenceImageRequest.reference_image_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1804,
+    serialized_end=1942,
+)
+
+
+_LISTREFERENCEIMAGESREQUEST = _descriptor.Descriptor(
+    name="ListReferenceImagesRequest",
+    full_name="google.cloud.vision.v1.ListReferenceImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.ListReferenceImagesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1.ListReferenceImagesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1.ListReferenceImagesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1944,
+    serialized_end=2027,
+)
+
+
+_LISTREFERENCEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="ListReferenceImagesResponse",
+    full_name="google.cloud.vision.v1.ListReferenceImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference_images",
+            full_name="google.cloud.vision.v1.ListReferenceImagesResponse.reference_images",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1.ListReferenceImagesResponse.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1.ListReferenceImagesResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2030,
+    serialized_end=2169,
+)
+
+
+_GETREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="GetReferenceImageRequest",
+    full_name="google.cloud.vision.v1.GetReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.GetReferenceImageRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2171,
+    serialized_end=2211,
+)
+
+
+_DELETEREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="DeleteReferenceImageRequest",
+    full_name="google.cloud.vision.v1.DeleteReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.DeleteReferenceImageRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2213,
+    serialized_end=2256,
+)
+
+
+_ADDPRODUCTTOPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="AddProductToProductSetRequest",
+    full_name="google.cloud.vision.v1.AddProductToProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.AddProductToProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1.AddProductToProductSetRequest.product",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2258,
+    serialized_end=2320,
+)
+
+
+_REMOVEPRODUCTFROMPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="RemoveProductFromProductSetRequest",
+    full_name="google.cloud.vision.v1.RemoveProductFromProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.RemoveProductFromProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1.RemoveProductFromProductSetRequest.product",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2322,
+    serialized_end=2389,
+)
+
+
+_LISTPRODUCTSINPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="ListProductsInProductSetRequest",
+    full_name="google.cloud.vision.v1.ListProductsInProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1.ListProductsInProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1.ListProductsInProductSetRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1.ListProductsInProductSetRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2391,
+    serialized_end=2477,
+)
+
+
+_LISTPRODUCTSINPRODUCTSETRESPONSE = _descriptor.Descriptor(
+    name="ListProductsInProductSetResponse",
+    full_name="google.cloud.vision.v1.ListProductsInProductSetResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1.ListProductsInProductSetResponse.products",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1.ListProductsInProductSetResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2479,
+    serialized_end=2589,
+)
+
+
+_IMPORTPRODUCTSETSGCSSOURCE = _descriptor.Descriptor(
+    name="ImportProductSetsGcsSource",
+    full_name="google.cloud.vision.v1.ImportProductSetsGcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="csv_file_uri",
+            full_name="google.cloud.vision.v1.ImportProductSetsGcsSource.csv_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2591,
+    serialized_end=2641,
+)
+
+
+_IMPORTPRODUCTSETSINPUTCONFIG = _descriptor.Descriptor(
+    name="ImportProductSetsInputConfig",
+    full_name="google.cloud.vision.v1.ImportProductSetsInputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1.ImportProductSetsInputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1.ImportProductSetsInputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2643,
+    serialized_end=2757,
+)
+
+
+_IMPORTPRODUCTSETSREQUEST = _descriptor.Descriptor(
+    name="ImportProductSetsRequest",
+    full_name="google.cloud.vision.v1.ImportProductSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.ImportProductSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1.ImportProductSetsRequest.input_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2759,
+    serialized_end=2877,
+)
+
+
+_IMPORTPRODUCTSETSRESPONSE = _descriptor.Descriptor(
+    name="ImportProductSetsResponse",
+    full_name="google.cloud.vision.v1.ImportProductSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference_images",
+            full_name="google.cloud.vision.v1.ImportProductSetsResponse.reference_images",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="statuses",
+            full_name="google.cloud.vision.v1.ImportProductSetsResponse.statuses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2880,
+    serialized_end=3011,
+)
+
+
+_BATCHOPERATIONMETADATA = _descriptor.Descriptor(
+    name="BatchOperationMetadata",
+    full_name="google.cloud.vision.v1.BatchOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1.BatchOperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.vision.v1.BatchOperationMetadata.submit_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.vision.v1.BatchOperationMetadata.end_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BATCHOPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3014,
+    serialized_end=3293,
+)
+
+
+_PRODUCTSETPURGECONFIG = _descriptor.Descriptor(
+    name="ProductSetPurgeConfig",
+    full_name="google.cloud.vision.v1.ProductSetPurgeConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_set_id",
+            full_name="google.cloud.vision.v1.ProductSetPurgeConfig.product_set_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3295,
+    serialized_end=3342,
+)
+
+
+_PURGEPRODUCTSREQUEST = _descriptor.Descriptor(
+    name="PurgeProductsRequest",
+    full_name="google.cloud.vision.v1.PurgeProductsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_set_purge_config",
+            full_name="google.cloud.vision.v1.PurgeProductsRequest.product_set_purge_config",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="delete_orphan_products",
+            full_name="google.cloud.vision.v1.PurgeProductsRequest.delete_orphan_products",
+            index=1,
+            number=3,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1.PurgeProductsRequest.parent",
+            index=2,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="force",
+            full_name="google.cloud.vision.v1.PurgeProductsRequest.force",
+            index=3,
+            number=4,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="target",
+            full_name="google.cloud.vision.v1.PurgeProductsRequest.target",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=3345,
+    serialized_end=3525,
+)
+
+_PRODUCT_KEYVALUE.containing_type = _PRODUCT
+_PRODUCT.fields_by_name["product_labels"].message_type = _PRODUCT_KEYVALUE
+_PRODUCTSET.fields_by_name[
+    "index_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRODUCTSET.fields_by_name[
+    "index_error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_REFERENCEIMAGE.fields_by_name[
+    "bounding_polys"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CREATEPRODUCTREQUEST.fields_by_name["product"].message_type = _PRODUCT
+_LISTPRODUCTSRESPONSE.fields_by_name["products"].message_type = _PRODUCT
+_UPDATEPRODUCTREQUEST.fields_by_name["product"].message_type = _PRODUCT
+_UPDATEPRODUCTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEPRODUCTSETREQUEST.fields_by_name["product_set"].message_type = _PRODUCTSET
+_LISTPRODUCTSETSRESPONSE.fields_by_name["product_sets"].message_type = _PRODUCTSET
+_UPDATEPRODUCTSETREQUEST.fields_by_name["product_set"].message_type = _PRODUCTSET
+_UPDATEPRODUCTSETREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEREFERENCEIMAGEREQUEST.fields_by_name[
+    "reference_image"
+].message_type = _REFERENCEIMAGE
+_LISTREFERENCEIMAGESRESPONSE.fields_by_name[
+    "reference_images"
+].message_type = _REFERENCEIMAGE
+_LISTPRODUCTSINPRODUCTSETRESPONSE.fields_by_name["products"].message_type = _PRODUCT
+_IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].message_type = _IMPORTPRODUCTSETSGCSSOURCE
+_IMPORTPRODUCTSETSINPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name["gcs_source"]
+)
+_IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _IMPORTPRODUCTSETSINPUTCONFIG.oneofs_by_name["source"]
+_IMPORTPRODUCTSETSREQUEST.fields_by_name[
+    "input_config"
+].message_type = _IMPORTPRODUCTSETSINPUTCONFIG
+_IMPORTPRODUCTSETSRESPONSE.fields_by_name[
+    "reference_images"
+].message_type = _REFERENCEIMAGE
+_IMPORTPRODUCTSETSRESPONSE.fields_by_name[
+    "statuses"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "state"
+].enum_type = _BATCHOPERATIONMETADATA_STATE
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA_STATE.containing_type = _BATCHOPERATIONMETADATA
+_PURGEPRODUCTSREQUEST.fields_by_name[
+    "product_set_purge_config"
+].message_type = _PRODUCTSETPURGECONFIG
+_PURGEPRODUCTSREQUEST.oneofs_by_name["target"].fields.append(
+    _PURGEPRODUCTSREQUEST.fields_by_name["product_set_purge_config"]
+)
+_PURGEPRODUCTSREQUEST.fields_by_name[
+    "product_set_purge_config"
+].containing_oneof = _PURGEPRODUCTSREQUEST.oneofs_by_name["target"]
+_PURGEPRODUCTSREQUEST.oneofs_by_name["target"].fields.append(
+    _PURGEPRODUCTSREQUEST.fields_by_name["delete_orphan_products"]
+)
+_PURGEPRODUCTSREQUEST.fields_by_name[
+    "delete_orphan_products"
+].containing_oneof = _PURGEPRODUCTSREQUEST.oneofs_by_name["target"]
+DESCRIPTOR.message_types_by_name["Product"] = _PRODUCT
+DESCRIPTOR.message_types_by_name["ProductSet"] = _PRODUCTSET
+DESCRIPTOR.message_types_by_name["ReferenceImage"] = _REFERENCEIMAGE
+DESCRIPTOR.message_types_by_name["CreateProductRequest"] = _CREATEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["ListProductsRequest"] = _LISTPRODUCTSREQUEST
+DESCRIPTOR.message_types_by_name["ListProductsResponse"] = _LISTPRODUCTSRESPONSE
+DESCRIPTOR.message_types_by_name["GetProductRequest"] = _GETPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProductRequest"] = _UPDATEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProductRequest"] = _DELETEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["CreateProductSetRequest"] = _CREATEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["ListProductSetsRequest"] = _LISTPRODUCTSETSREQUEST
+DESCRIPTOR.message_types_by_name["ListProductSetsResponse"] = _LISTPRODUCTSETSRESPONSE
+DESCRIPTOR.message_types_by_name["GetProductSetRequest"] = _GETPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProductSetRequest"] = _UPDATEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProductSetRequest"] = _DELETEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateReferenceImageRequest"
+] = _CREATEREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListReferenceImagesRequest"
+] = _LISTREFERENCEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListReferenceImagesResponse"
+] = _LISTREFERENCEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["GetReferenceImageRequest"] = _GETREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteReferenceImageRequest"
+] = _DELETEREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AddProductToProductSetRequest"
+] = _ADDPRODUCTTOPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RemoveProductFromProductSetRequest"
+] = _REMOVEPRODUCTFROMPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListProductsInProductSetRequest"
+] = _LISTPRODUCTSINPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListProductsInProductSetResponse"
+] = _LISTPRODUCTSINPRODUCTSETRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsGcsSource"
+] = _IMPORTPRODUCTSETSGCSSOURCE
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsInputConfig"
+] = _IMPORTPRODUCTSETSINPUTCONFIG
+DESCRIPTOR.message_types_by_name["ImportProductSetsRequest"] = _IMPORTPRODUCTSETSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsResponse"
+] = _IMPORTPRODUCTSETSRESPONSE
+DESCRIPTOR.message_types_by_name["BatchOperationMetadata"] = _BATCHOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["ProductSetPurgeConfig"] = _PRODUCTSETPURGECONFIG
+DESCRIPTOR.message_types_by_name["PurgeProductsRequest"] = _PURGEPRODUCTSREQUEST
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Product = _reflection.GeneratedProtocolMessageType(
+    "Product",
+    (_message.Message,),
+    dict(
+        KeyValue=_reflection.GeneratedProtocolMessageType(
+            "KeyValue",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCT_KEYVALUE,
+                __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+                __doc__="""A product label represented as a key-value pair.
+    
+    
+    Attributes:
+        key:
+            The key of the label attached to the product. Cannot be empty
+            and cannot exceed 128 bytes.
+        value:
+            The value of the label attached to the product. Cannot be
+            empty and cannot exceed 128 bytes.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Product.KeyValue)
+            ),
+        ),
+        DESCRIPTOR=_PRODUCT,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""A Product contains ReferenceImages.
+  
+  
+  Attributes:
+      name:
+          The resource name of the product.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+          This field is ignored when creating a product.
+      display_name:
+          The user-provided name for this Product. Must not be empty.
+          Must be at most 4096 characters long.
+      description:
+          User-provided metadata to be stored with this product. Must be
+          at most 4096 characters long.
+      product_category:
+          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.  This field is immutable.
+      product_labels:
+          Key-value pairs that can be attached to a product. At query
+          time, constraints can be specified based on the
+          product\_labels.  Note that integer values can be provided as
+          strings, e.g. "1199". Only strings with integer values can
+          match a range-based restriction which is to be supported soon.
+          Multiple values can be assigned to the same key. One product
+          may have up to 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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Product)
+    ),
+)
+_sym_db.RegisterMessage(Product)
+_sym_db.RegisterMessage(Product.KeyValue)
+
+ProductSet = _reflection.GeneratedProtocolMessageType(
+    "ProductSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSET,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""A ProductSet contains Products. A ProductSet can contain a maximum of 1
+  million reference images. If the limit is exceeded, periodic indexing
+  will fail.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ProductSet.  Format is: ``projects/PR
+          OJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``.  This
+          field is ignored when creating a ProductSet.
+      display_name:
+          The user-provided name for this ProductSet. Must not be empty.
+          Must be at most 4096 characters long.
+      index_time:
+          Output only. The time at which this ProductSet was last
+          indexed. Query results will reflect all updates before this
+          time. If this ProductSet has never been indexed, this
+          timestamp is the default value "1970-01-01T00:00:00Z".  This
+          field is ignored when creating a ProductSet.
+      index_error:
+          Output only. If there was an error with indexing the product
+          set, the field is populated.  This field is ignored when
+          creating a ProductSet.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSet)
+    ),
+)
+_sym_db.RegisterMessage(ProductSet)
+
+ReferenceImage = _reflection.GeneratedProtocolMessageType(
+    "ReferenceImage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REFERENCEIMAGE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""A ``ReferenceImage`` represents a product image and its associated
+  metadata, such as bounding boxes.
+  
+  
+  Attributes:
+      name:
+          The resource name of the reference image.  Format is:  ``proje
+          cts/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
+          mages/IMAGE_ID``.  This field is ignored when creating a
+          reference image.
+      uri:
+          The Google Cloud Storage URI of the reference image.  The URI
+          must start with ``gs://``.  Required.
+      bounding_polys:
+          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 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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ReferenceImage)
+    ),
+)
+_sym_db.RegisterMessage(ReferenceImage)
+
+CreateProductRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateProduct`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the Product should be created.  Format is
+          ``projects/PROJECT_ID/locations/LOC_ID``.
+      product:
+          The product to create.
+      product_id:
+          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 error is returned with code
+          ALREADY\_EXISTS. Must be at most 128 characters long. It
+          cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.CreateProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProductRequest)
+
+ListProductsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProducts`` method.
+  
+  
+  Attributes:
+      parent:
+          The project OR ProductSet from which Products should be
+          listed.  Format: ``projects/PROJECT_ID/locations/LOC_ID``
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListProductsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsRequest)
+
+ListProductsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSRESPONSE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProducts`` method.
+  
+  
+  Attributes:
+      products:
+          List of products.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListProductsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsResponse)
+
+GetProductRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetProduct`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the Product to get.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.GetProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProductRequest)
+
+UpdateProductRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``UpdateProduct`` method.
+  
+  
+  Attributes:
+      product:
+          The Product resource which replaces the one on the server.
+          product.name is immutable.
+      update_mask:
+          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 ``description``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.UpdateProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProductRequest)
+
+DeleteProductRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteProduct`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of product to delete.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.DeleteProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProductRequest)
+
+CreateProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateProductSet`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the ProductSet should be created.  Format
+          is ``projects/PROJECT_ID/locations/LOC_ID``.
+      product_set:
+          The ProductSet to create.
+      product_set_id:
+          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 error is returned with code
+          ALREADY\_EXISTS. Must be at most 128 characters long. It
+          cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.CreateProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProductSetRequest)
+
+ListProductSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSETSREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProductSets`` method.
+  
+  
+  Attributes:
+      parent:
+          The project from which ProductSets should be listed.  Format
+          is ``projects/PROJECT_ID/locations/LOC_ID``.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListProductSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductSetsRequest)
+
+ListProductSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSETSRESPONSE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProductSets`` method.
+  
+  
+  Attributes:
+      product_sets:
+          List of ProductSets.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListProductSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductSetsResponse)
+
+GetProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the ProductSet to get.  Format is: ``projects
+          /PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.GetProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProductSetRequest)
+
+UpdateProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``UpdateProductSet`` method.
+  
+  
+  Attributes:
+      product_set:
+          The ProductSet resource which replaces the one on the server.
+      update_mask:
+          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 path is
+          ``display_name``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.UpdateProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProductSetRequest)
+
+DeleteProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the ProductSet to delete.  Format is: ``proje
+          cts/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.DeleteProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProductSetRequest)
+
+CreateReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateReferenceImage`` method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the product in which to create the reference
+          image.  Format is
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+      reference_image:
+          The reference image to create. If an image ID is specified, it
+          is ignored.
+      reference_image_id:
+          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 already in use, an error is returned
+          with code ALREADY\_EXISTS. Must be at most 128 characters
+          long. It cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.CreateReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateReferenceImageRequest)
+
+ListReferenceImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListReferenceImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTREFERENCEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListReferenceImages`` method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the product containing the reference images.
+          Format is
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          A token identifying a page of results to be returned. This is
+          the value of ``nextPageToken`` returned in a previous
+          reference image list request.  Defaults to the first page if
+          not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListReferenceImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListReferenceImagesRequest)
+
+ListReferenceImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListReferenceImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTREFERENCEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListReferenceImages`` method.
+  
+  
+  Attributes:
+      reference_images:
+          The list of reference images.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      next_page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListReferenceImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListReferenceImagesResponse)
+
+GetReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "GetReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetReferenceImage`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ReferenceImage to get.  Format is:  `
+          `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/refe
+          renceImages/IMAGE_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.GetReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetReferenceImageRequest)
+
+DeleteReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteReferenceImage`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name of the reference image to delete.  Format
+          is:  ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_I
+          D/referenceImages/IMAGE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.DeleteReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteReferenceImageRequest)
+
+AddProductToProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "AddProductToProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDPRODUCTTOPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``AddProductToProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name for the ProductSet to modify.  Format is: ``
+          projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_I
+          D``
+      product:
+          The resource name for the Product to be added to this
+          ProductSet.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.AddProductToProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(AddProductToProductSetRequest)
+
+RemoveProductFromProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "RemoveProductFromProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REMOVEPRODUCTFROMPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``RemoveProductFromProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name for the ProductSet to modify.  Format is: ``
+          projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_I
+          D``
+      product:
+          The resource name for the Product to be removed from this
+          ProductSet.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.RemoveProductFromProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(RemoveProductFromProductSetRequest)
+
+ListProductsInProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductsInProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSINPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProductsInProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The ProductSet resource for which to retrieve Products.
+          Format is: ``projects/PROJECT_ID/locations/LOC_ID/productSets/
+          PRODUCT_SET_ID``
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListProductsInProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsInProductSetRequest)
+
+ListProductsInProductSetResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductsInProductSetResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSINPRODUCTSETRESPONSE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProductsInProductSet`` method.
+  
+  
+  Attributes:
+      products:
+          The list of Products.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ListProductsInProductSetResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsInProductSetResponse)
+
+ImportProductSetsGcsSource = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsGcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSGCSSOURCE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""The Google Cloud Storage location for a csv file which preserves a list
+  of ImportProductSetRequests in each line.
+  
+  
+  Attributes:
+      csv_file_uri:
+          The Google Cloud Storage URI of the input csv file.  The URI
+          must start with ``gs://``.  The format of the input csv file
+          should be one image per line. In each line, there are 8
+          columns.  1. image-uri 2. image-id 3. product-set-id 4.
+          product-id 5. product-category 6. product-display-name 7.
+          labels 8. bounding-poly  The ``image-uri``, ``product-set-
+          id``, ``product-id``, and ``product-category`` columns are
+          required. All other columns are optional.  If the
+          ``ProductSet`` or ``Product`` specified by the ``product-set-
+          id`` and ``product-id`` values does not exist, then the system
+          will create a new ``ProductSet`` or ``Product`` for the image.
+          In this case, the ``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.vis
+          ion.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.  If a ``Product``
+          with the specified ``product-id`` already exists, then the
+          system ignores the ``product-display-name``, ``product-
+          category``, and ``labels`` columns.  The ``labels`` column
+          (optional) is a line containing a list of comma-separated key-
+          value pairs, in the following format:  ::
+          "key_1=value_1,key_2=value_2,...,key_n=value_n"  The
+          ``bounding-poly`` column (optional) identifies one region of
+          interest from the image in the same manner as
+          ``CreateReferenceImage``. If you do not specify the
+          ``bounding-poly`` column, then the system will try to detect
+          regions of interest automatically.  At most one ``bounding-
+          poly`` column is allowed per line. If the image contains
+          multiple regions of interest, add a line to the CSV file that
+          includes the same product information, and the ``bounding-
+          poly`` values for each region of interest.  The ``bounding-
+          poly`` column must contain an even number of comma-separated
+          numbers, in the format
+          "p1\_x,p1\_y,p2\_x,p2\_y,...,pn\_x,pn\_y". Use non-negative
+          integers for absolute bounding polygons, and float values in
+          [0, 1] for normalized bounding polygons.  The system will
+          resize the image if the image resolution is too large to
+          process (larger than 20MP).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImportProductSetsGcsSource)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsGcsSource)
+
+ImportProductSetsInputConfig = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsInputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSINPUTCONFIG,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""The input content for the ``ImportProductSets`` method.
+  
+  
+  Attributes:
+      source:
+          The source of the input.
+      gcs_source:
+          The Google Cloud Storage location for a csv file which
+          preserves a list of ImportProductSetRequests in each line.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImportProductSetsInputConfig)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsInputConfig)
+
+ImportProductSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ImportProductSets`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the ProductSets should be imported.
+          Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+      input_config:
+          The input content for the list of requests.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImportProductSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsRequest)
+
+ImportProductSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSRESPONSE,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      reference_images:
+          The list of reference\_images that are imported successfully.
+      statuses:
+          The rpc status for each ImportProductSet request, including
+          both successes and errors.  The number of statuses here
+          matches the number of lines in the csv file, and statuses[i]
+          stores the success or failure status of processing the i-th
+          line of the csv, starting from line 0.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ImportProductSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsResponse)
+
+BatchOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "BatchOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHOPERATIONMETADATA,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Metadata for the batch operations such as the current state.
+  
+  This is included in the ``metadata`` field of the ``Operation`` returned
+  by the ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      state:
+          The current state of the batch operation.
+      submit_time:
+          The time when the batch request was submitted to the server.
+      end_time:
+          The time when the batch request is finished and [google.longru
+          nning.Operation.done][google.longrunning.Operation.done] is
+          set to true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.BatchOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(BatchOperationMetadata)
+
+ProductSetPurgeConfig = _reflection.GeneratedProtocolMessageType(
+    "ProductSetPurgeConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSETPURGECONFIG,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Config to control which ProductSet contains the Products to be deleted.
+  
+  
+  Attributes:
+      product_set_id:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.ProductSetPurgeConfig)
+    ),
+)
+_sym_db.RegisterMessage(ProductSetPurgeConfig)
+
+PurgeProductsRequest = _reflection.GeneratedProtocolMessageType(
+    "PurgeProductsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PURGEPRODUCTSREQUEST,
+        __module__="google.cloud.vision_v1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``PurgeProducts`` method.
+  
+  
+  Attributes:
+      target:
+          The Products to delete.
+      product_set_purge_config:
+          Specify which ProductSet contains the Products to be deleted.
+      delete_orphan_products:
+          If delete\_orphan\_products is true, all Products that are not
+          in any ProductSet will be deleted.
+      parent:
+          The project and location in which the Products should be
+          deleted.  Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+      force:
+          The default value is false. Override this value to true to
+          actually perform the purge.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.PurgeProductsRequest)
+    ),
+)
+_sym_db.RegisterMessage(PurgeProductsRequest)
+
+
+DESCRIPTOR._options = None
+
+_PRODUCTSEARCH = _descriptor.ServiceDescriptor(
+    name="ProductSearch",
+    full_name="google.cloud.vision.v1.ProductSearch",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=_b(
+        "\312A\025vision.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/cloud-vision"
+    ),
+    serialized_start=3528,
+    serialized_end=6957,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.CreateProductSet",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002>"//v1/{parent=projects/*/locations/*}/productSets:\013product_set'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProductSets",
+            full_name="google.cloud.vision.v1.ProductSearch.ListProductSets",
+            index=1,
+            containing_service=None,
+            input_type=_LISTPRODUCTSETSREQUEST,
+            output_type=_LISTPRODUCTSETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1/{parent=projects/*/locations/*}/productSets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.GetProductSet",
+            index=2,
+            containing_service=None,
+            input_type=_GETPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                "\202\323\344\223\0021\022//v1/{name=projects/*/locations/*/productSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.UpdateProductSet",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                "\202\323\344\223\002J2;/v1/{product_set.name=projects/*/locations/*/productSets/*}:\013product_set"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.DeleteProductSet",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0021*//v1/{name=projects/*/locations/*/productSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateProduct",
+            full_name="google.cloud.vision.v1.ProductSearch.CreateProduct",
+            index=5,
+            containing_service=None,
+            input_type=_CREATEPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                '\202\323\344\223\0027",/v1/{parent=projects/*/locations/*}/products:\007product'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProducts",
+            full_name="google.cloud.vision.v1.ProductSearch.ListProducts",
+            index=6,
+            containing_service=None,
+            input_type=_LISTPRODUCTSREQUEST,
+            output_type=_LISTPRODUCTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v1/{parent=projects/*/locations/*}/products"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProduct",
+            full_name="google.cloud.vision.v1.ProductSearch.GetProduct",
+            index=7,
+            containing_service=None,
+            input_type=_GETPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                "\202\323\344\223\002.\022,/v1/{name=projects/*/locations/*/products/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProduct",
+            full_name="google.cloud.vision.v1.ProductSearch.UpdateProduct",
+            index=8,
+            containing_service=None,
+            input_type=_UPDATEPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                "\202\323\344\223\002?24/v1/{product.name=projects/*/locations/*/products/*}:\007product"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProduct",
+            full_name="google.cloud.vision.v1.ProductSearch.DeleteProduct",
+            index=9,
+            containing_service=None,
+            input_type=_DELETEPRODUCTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002.*,/v1/{name=projects/*/locations/*/products/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateReferenceImage",
+            full_name="google.cloud.vision.v1.ProductSearch.CreateReferenceImage",
+            index=10,
+            containing_service=None,
+            input_type=_CREATEREFERENCEIMAGEREQUEST,
+            output_type=_REFERENCEIMAGE,
+            serialized_options=_b(
+                '\202\323\344\223\002Q">/v1/{parent=projects/*/locations/*/products/*}/referenceImages:\017reference_image'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteReferenceImage",
+            full_name="google.cloud.vision.v1.ProductSearch.DeleteReferenceImage",
+            index=11,
+            containing_service=None,
+            input_type=_DELETEREFERENCEIMAGEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002@*>/v1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListReferenceImages",
+            full_name="google.cloud.vision.v1.ProductSearch.ListReferenceImages",
+            index=12,
+            containing_service=None,
+            input_type=_LISTREFERENCEIMAGESREQUEST,
+            output_type=_LISTREFERENCEIMAGESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1/{parent=projects/*/locations/*/products/*}/referenceImages"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetReferenceImage",
+            full_name="google.cloud.vision.v1.ProductSearch.GetReferenceImage",
+            index=13,
+            containing_service=None,
+            input_type=_GETREFERENCEIMAGEREQUEST,
+            output_type=_REFERENCEIMAGE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AddProductToProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.AddProductToProductSet",
+            index=14,
+            containing_service=None,
+            input_type=_ADDPRODUCTTOPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002?":/v1/{name=projects/*/locations/*/productSets/*}:addProduct:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RemoveProductFromProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.RemoveProductFromProductSet",
+            index=15,
+            containing_service=None,
+            input_type=_REMOVEPRODUCTFROMPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v1/{name=projects/*/locations/*/productSets/*}:removeProduct:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProductsInProductSet",
+            full_name="google.cloud.vision.v1.ProductSearch.ListProductsInProductSet",
+            index=16,
+            containing_service=None,
+            input_type=_LISTPRODUCTSINPRODUCTSETREQUEST,
+            output_type=_LISTPRODUCTSINPRODUCTSETRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002:\0228/v1/{name=projects/*/locations/*/productSets/*}/products"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportProductSets",
+            full_name="google.cloud.vision.v1.ProductSearch.ImportProductSets",
+            index=17,
+            containing_service=None,
+            input_type=_IMPORTPRODUCTSETSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002;"6/v1/{parent=projects/*/locations/*}/productSets:import:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="PurgeProducts",
+            full_name="google.cloud.vision.v1.ProductSearch.PurgeProducts",
+            index=18,
+            containing_service=None,
+            input_type=_PURGEPRODUCTSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\0027"2/v1/{parent=projects/*/locations/*}/products:purge:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PRODUCTSEARCH)
+
+DESCRIPTOR.services_by_name["ProductSearch"] = _PRODUCTSEARCH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1/proto/product_search_service_pb2_grpc.py b/vision/google/cloud/vision_v1/proto/product_search_service_pb2_grpc.py
new file mode 100644
index 000000000000..447fbf5c7313
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/product_search_service_pb2_grpc.py
@@ -0,0 +1,526 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1.proto import (
+    product_search_service_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ProductSearchStub(object):
+    """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.
+
+  In parallel,
+
+  - 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
+  `projects/*/locations/*/products/*/referenceImages/*`
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/CreateProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.CreateProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.ListProductSets = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/ListProductSets",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductSetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductSetsResponse.FromString,
+        )
+        self.GetProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/GetProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.GetProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.UpdateProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/UpdateProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.UpdateProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.DeleteProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/DeleteProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DeleteProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateProduct = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/CreateProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.CreateProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.ListProducts = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/ListProducts",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsResponse.FromString,
+        )
+        self.GetProduct = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/GetProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.GetProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.UpdateProduct = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/UpdateProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.UpdateProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.DeleteProduct = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/DeleteProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DeleteProductRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/CreateReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.CreateReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ReferenceImage.FromString,
+        )
+        self.DeleteReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/DeleteReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DeleteReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListReferenceImages = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/ListReferenceImages",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesResponse.FromString,
+        )
+        self.GetReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/GetReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.GetReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ReferenceImage.FromString,
+        )
+        self.AddProductToProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/AddProductToProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.AddProductToProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RemoveProductFromProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/RemoveProductFromProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.RemoveProductFromProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListProductsInProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/ListProductsInProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetResponse.FromString,
+        )
+        self.ImportProductSets = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/ImportProductSets",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ImportProductSetsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.PurgeProducts = channel.unary_unary(
+            "/google.cloud.vision.v1.ProductSearch/PurgeProducts",
+            request_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.PurgeProductsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ProductSearchServicer(object):
+    """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.
+
+  In parallel,
+
+  - 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
+  `projects/*/locations/*/products/*/referenceImages/*`
+  """
+
+    def CreateProductSet(self, request, context):
+        """Creates and returns a new ProductSet resource.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+    4096 characters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProductSets(self, request, context):
+        """Lists ProductSets in an unspecified order.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+    than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProductSet(self, request, context):
+        """Gets information associated with a ProductSet.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProductSet(self, request, context):
+        """Makes changes to a ProductSet resource.
+    Only display_name can be updated currently.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+    missing from the request or longer than 4096 characters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProductSet(self, request, context):
+        """Permanently deletes a ProductSet. Products and ReferenceImages in the
+    ProductSet are not deleted.
+
+    The actual image files are not deleted from Google Cloud Storage.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateProduct(self, request, context):
+        """Creates and returns a new product resource.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+    characters.
+    * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProducts(self, request, context):
+        """Lists products in an unspecified order.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProduct(self, request, context):
+        """Gets information associated with a Product.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProduct(self, request, context):
+        """Makes changes to a Product resource.
+    Only the `display_name`, `description`, and `labels` fields can be updated
+    right now.
+
+    If labels are updated, the change will not be reflected in queries until
+    the next index time.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product does not exist.
+    * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+    missing from the request or longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if description is present in update_mask but is
+    longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProduct(self, request, context):
+        """Permanently deletes a product and its reference images.
+
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateReferenceImage(self, request, context):
+        """Creates and returns a new ReferenceImage resource.
+
+    The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+    the system will try to detect regions of interest in the image that are
+    compatible with the product_category on the parent product. If it is
+    specified, detection is ALWAYS skipped. The system converts polygons into
+    non-rotated rectangles.
+
+    Note that the pipeline will resize the image if the image resolution is too
+    large to process (above 50MP).
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+    characters.
+    * Returns INVALID_ARGUMENT if the product does not exist.
+    * 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteReferenceImage(self, request, context):
+        """Permanently deletes a reference image.
+
+    The image metadata will be deleted right away, but search queries
+    against ProductSets containing the image may still work until all related
+    caches are refreshed.
+
+    The actual image files are not deleted from Google Cloud Storage.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListReferenceImages(self, request, context):
+        """Lists reference images.
+
+    Possible errors:
+
+    * 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetReferenceImage(self, request, context):
+        """Gets information associated with a ReferenceImage.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the specified image does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AddProductToProductSet(self, request, context):
+        """Adds a Product to the specified ProductSet. If the Product is already
+    present, no change is made.
+
+    One Product can be added to at most 100 ProductSets.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RemoveProductFromProductSet(self, request, context):
+        """Removes a Product from the specified ProductSet.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProductsInProductSet(self, request, context):
+        """Lists the Products in a ProductSet, in an unspecified order. If the
+    ProductSet does not exist, the products field of the response will be
+    empty.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportProductSets(self, request, context):
+        """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.
+    `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].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def PurgeProducts(self, request, context):
+        """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)
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ProductSearchServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.CreateProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "ListProductSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProductSets,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductSetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductSetsResponse.SerializeToString,
+        ),
+        "GetProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.GetProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "UpdateProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.UpdateProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "DeleteProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DeleteProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.CreateProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "ListProducts": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProducts,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsResponse.SerializeToString,
+        ),
+        "GetProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.GetProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "UpdateProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.UpdateProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "DeleteProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DeleteProductRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.CreateReferenceImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ReferenceImage.SerializeToString,
+        ),
+        "DeleteReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.DeleteReferenceImageRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListReferenceImages": grpc.unary_unary_rpc_method_handler(
+            servicer.ListReferenceImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesResponse.SerializeToString,
+        ),
+        "GetReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.GetReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.GetReferenceImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ReferenceImage.SerializeToString,
+        ),
+        "AddProductToProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.AddProductToProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.AddProductToProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RemoveProductFromProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.RemoveProductFromProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.RemoveProductFromProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListProductsInProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProductsInProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetResponse.SerializeToString,
+        ),
+        "ImportProductSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportProductSets,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.ImportProductSetsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "PurgeProducts": grpc.unary_unary_rpc_method_handler(
+            servicer.PurgeProducts,
+            request_deserializer=google_dot_cloud_dot_vision__v1_dot_proto_dot_product__search__service__pb2.PurgeProductsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1.ProductSearch", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1/proto/text_annotation.proto b/vision/google/cloud/vision_v1/proto/text_annotation.proto
new file mode 100644
index 000000000000..09459b90e69d
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/text_annotation.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.vision.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1/geometry.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "TextAnnotationProto";
+option java_package = "com.google.cloud.vision.v1";
+option objc_class_prefix = "GCVN";
+
+// TextAnnotation contains a structured representation of OCR extracted text.
+// The hierarchy of an OCR extracted text structure is like this:
+//     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.
+message TextAnnotation {
+  // 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;
+  }
+
+  // Detected start or end of a structural component.
+  message DetectedBreak {
+    // Enum to denote the type of break found. New line, space etc.
+    enum BreakType {
+      // Unknown break label type.
+      UNKNOWN = 0;
+
+      // Regular space.
+      SPACE = 1;
+
+      // Sure space (very wide).
+      SURE_SPACE = 2;
+
+      // Line-wrapping break.
+      EOL_SURE_SPACE = 3;
+
+      // End-line hyphen that is not present in text; does not co-occur with
+      // `SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.
+      HYPHEN = 4;
+
+      // Line break that ends a paragraph.
+      LINE_BREAK = 5;
+    }
+
+    // Detected break type.
+    BreakType type = 1;
+
+    // True if break prepends the element.
+    bool is_prefix = 2;
+  }
+
+  // Additional information detected on the structural component.
+  message TextProperty {
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 1;
+
+    // Detected start or end of a text segment.
+    DetectedBreak detected_break = 2;
+  }
+
+  // List of pages detected by OCR.
+  repeated Page pages = 1;
+
+  // UTF-8 text detected on the pages.
+  string text = 2;
+}
+
+// Detected page from OCR.
+message Page {
+  // Additional information detected on the page.
+  TextAnnotation.TextProperty property = 1;
+
+  // Page width. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 width = 2;
+
+  // Page height. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 height = 3;
+
+  // List of blocks of text, images etc on this page.
+  repeated Block blocks = 4;
+
+  // Confidence of the OCR results on the page. Range [0, 1].
+  float confidence = 5;
+}
+
+// Logical element on the page.
+message Block {
+  // Type of a block (text, image etc) as identified by OCR.
+  enum BlockType {
+    // Unknown block type.
+    UNKNOWN = 0;
+
+    // Regular text block.
+    TEXT = 1;
+
+    // Table block.
+    TABLE = 2;
+
+    // Image block.
+    PICTURE = 3;
+
+    // Horizontal/vertical line box.
+    RULER = 4;
+
+    // Barcode block.
+    BARCODE = 5;
+  }
+
+  // Additional information detected for the block.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the block.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //
+  // * when the text is horizontal it might look like:
+  //
+  //         0----1
+  //         |    |
+  //         3----2
+  //
+  // * when it's rotated 180 degrees around the top-left corner it becomes:
+  //
+  //         2----3
+  //         |    |
+  //         1----0
+  //
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of paragraphs in this block (if this blocks is of type text).
+  repeated Paragraph paragraphs = 3;
+
+  // Detected block type (text, image etc) for this block.
+  BlockType block_type = 4;
+
+  // Confidence of the OCR results on the block. Range [0, 1].
+  float confidence = 5;
+}
+
+// Structural unit of text representing a number of words in certain order.
+message Paragraph {
+  // Additional information detected for the paragraph.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the paragraph.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of all words in this paragraph.
+  repeated Word words = 3;
+
+  // Confidence of the OCR results for the paragraph. Range [0, 1].
+  float confidence = 4;
+}
+
+// A word representation.
+message Word {
+  // Additional information detected for the word.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the word.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of symbols in the word.
+  // The order of the symbols follows the natural reading order.
+  repeated Symbol symbols = 3;
+
+  // Confidence of the OCR results for the word. Range [0, 1].
+  float confidence = 4;
+}
+
+// A single symbol representation.
+message Symbol {
+  // Additional information detected for the symbol.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the symbol.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // The actual UTF-8 representation of the symbol.
+  string text = 3;
+
+  // Confidence of the OCR results for the symbol. Range [0, 1].
+  float confidence = 4;
+}
diff --git a/vision/google/cloud/vision_v1/proto/text_annotation_pb2.py b/vision/google/cloud/vision_v1/proto/text_annotation_pb2.py
new file mode 100644
index 000000000000..c5af2e0bbead
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/text_annotation_pb2.py
@@ -0,0 +1,1137 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1/proto/text_annotation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1/proto/text_annotation.proto",
+    package="google.cloud.vision.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.vision.v1B\023TextAnnotationProtoP\001Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/vision_v1/proto/text_annotation.proto\x12\x16google.cloud.vision.v1\x1a\x1cgoogle/api/annotations.proto\x1a+google/cloud/vision_v1/proto/geometry.proto"\x96\x04\n\x0eTextAnnotation\x12+\n\x05pages\x18\x01 \x03(\x0b\x32\x1c.google.cloud.vision.v1.Page\x12\x0c\n\x04text\x18\x02 \x01(\t\x1a=\n\x10\x44\x65tectedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x1a\xd5\x01\n\rDetectedBreak\x12L\n\x04type\x18\x01 \x01(\x0e\x32>.google.cloud.vision.v1.TextAnnotation.DetectedBreak.BreakType\x12\x11\n\tis_prefix\x18\x02 \x01(\x08"c\n\tBreakType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\t\n\x05SPACE\x10\x01\x12\x0e\n\nSURE_SPACE\x10\x02\x12\x12\n\x0e\x45OL_SURE_SPACE\x10\x03\x12\n\n\x06HYPHEN\x10\x04\x12\x0e\n\nLINE_BREAK\x10\x05\x1a\xb1\x01\n\x0cTextProperty\x12S\n\x12\x64\x65tected_languages\x18\x01 \x03(\x0b\x32\x37.google.cloud.vision.v1.TextAnnotation.DetectedLanguage\x12L\n\x0e\x64\x65tected_break\x18\x02 \x01(\x0b\x32\x34.google.cloud.vision.v1.TextAnnotation.DetectedBreak"\xaf\x01\n\x04Page\x12\x45\n\x08property\x18\x01 \x01(\x0b\x32\x33.google.cloud.vision.v1.TextAnnotation.TextProperty\x12\r\n\x05width\x18\x02 \x01(\x05\x12\x0e\n\x06height\x18\x03 \x01(\x05\x12-\n\x06\x62locks\x18\x04 \x03(\x0b\x32\x1d.google.cloud.vision.v1.Block\x12\x12\n\nconfidence\x18\x05 \x01(\x02"\xe6\x02\n\x05\x42lock\x12\x45\n\x08property\x18\x01 \x01(\x0b\x32\x33.google.cloud.vision.v1.TextAnnotation.TextProperty\x12:\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x35\n\nparagraphs\x18\x03 \x03(\x0b\x32!.google.cloud.vision.v1.Paragraph\x12;\n\nblock_type\x18\x04 \x01(\x0e\x32\'.google.cloud.vision.v1.Block.BlockType\x12\x12\n\nconfidence\x18\x05 \x01(\x02"R\n\tBlockType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x08\n\x04TEXT\x10\x01\x12\t\n\x05TABLE\x10\x02\x12\x0b\n\x07PICTURE\x10\x03\x12\t\n\x05RULER\x10\x04\x12\x0b\n\x07\x42\x41RCODE\x10\x05"\xcf\x01\n\tParagraph\x12\x45\n\x08property\x18\x01 \x01(\x0b\x32\x33.google.cloud.vision.v1.TextAnnotation.TextProperty\x12:\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12+\n\x05words\x18\x03 \x03(\x0b\x32\x1c.google.cloud.vision.v1.Word\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xce\x01\n\x04Word\x12\x45\n\x08property\x18\x01 \x01(\x0b\x32\x33.google.cloud.vision.v1.TextAnnotation.TextProperty\x12:\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12/\n\x07symbols\x18\x03 \x03(\x0b\x32\x1e.google.cloud.vision.v1.Symbol\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xad\x01\n\x06Symbol\x12\x45\n\x08property\x18\x01 \x01(\x0b\x32\x33.google.cloud.vision.v1.TextAnnotation.TextProperty\x12:\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32$.google.cloud.vision.v1.BoundingPoly\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x42{\n\x1a\x63om.google.cloud.vision.v1B\x13TextAnnotationProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE = _descriptor.EnumDescriptor(
+    name="BreakType",
+    full_name="google.cloud.vision.v1.TextAnnotation.DetectedBreak.BreakType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPACE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SURE_SPACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EOL_SURE_SPACE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HYPHEN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINE_BREAK", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=409,
+    serialized_end=508,
+)
+_sym_db.RegisterEnumDescriptor(_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE)
+
+_BLOCK_BLOCKTYPE = _descriptor.EnumDescriptor(
+    name="BlockType",
+    full_name="google.cloud.vision.v1.Block.BlockType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PICTURE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RULER", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BARCODE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1145,
+    serialized_end=1227,
+)
+_sym_db.RegisterEnumDescriptor(_BLOCK_BLOCKTYPE)
+
+
+_TEXTANNOTATION_DETECTEDLANGUAGE = _descriptor.Descriptor(
+    name="DetectedLanguage",
+    full_name="google.cloud.vision.v1.TextAnnotation.DetectedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1.TextAnnotation.DetectedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.TextAnnotation.DetectedLanguage.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=231,
+    serialized_end=292,
+)
+
+_TEXTANNOTATION_DETECTEDBREAK = _descriptor.Descriptor(
+    name="DetectedBreak",
+    full_name="google.cloud.vision.v1.TextAnnotation.DetectedBreak",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1.TextAnnotation.DetectedBreak.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_prefix",
+            full_name="google.cloud.vision.v1.TextAnnotation.DetectedBreak.is_prefix",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=295,
+    serialized_end=508,
+)
+
+_TEXTANNOTATION_TEXTPROPERTY = _descriptor.Descriptor(
+    name="TextProperty",
+    full_name="google.cloud.vision.v1.TextAnnotation.TextProperty",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="detected_languages",
+            full_name="google.cloud.vision.v1.TextAnnotation.TextProperty.detected_languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detected_break",
+            full_name="google.cloud.vision.v1.TextAnnotation.TextProperty.detected_break",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=511,
+    serialized_end=688,
+)
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.vision.v1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1.TextAnnotation.pages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1.TextAnnotation.text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TEXTANNOTATION_DETECTEDLANGUAGE,
+        _TEXTANNOTATION_DETECTEDBREAK,
+        _TEXTANNOTATION_TEXTPROPERTY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=154,
+    serialized_end=688,
+)
+
+
+_PAGE = _descriptor.Descriptor(
+    name="Page",
+    full_name="google.cloud.vision.v1.Page",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1.Page.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.cloud.vision.v1.Page.width",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.cloud.vision.v1.Page.height",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocks",
+            full_name="google.cloud.vision.v1.Page.blocks",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.Page.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=691,
+    serialized_end=866,
+)
+
+
+_BLOCK = _descriptor.Descriptor(
+    name="Block",
+    full_name="google.cloud.vision.v1.Block",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1.Block.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1.Block.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="paragraphs",
+            full_name="google.cloud.vision.v1.Block.paragraphs",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="block_type",
+            full_name="google.cloud.vision.v1.Block.block_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.Block.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BLOCK_BLOCKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=869,
+    serialized_end=1227,
+)
+
+
+_PARAGRAPH = _descriptor.Descriptor(
+    name="Paragraph",
+    full_name="google.cloud.vision.v1.Paragraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1.Paragraph.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1.Paragraph.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.vision.v1.Paragraph.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.Paragraph.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1230,
+    serialized_end=1437,
+)
+
+
+_WORD = _descriptor.Descriptor(
+    name="Word",
+    full_name="google.cloud.vision.v1.Word",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1.Word.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1.Word.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="symbols",
+            full_name="google.cloud.vision.v1.Word.symbols",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.Word.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1440,
+    serialized_end=1646,
+)
+
+
+_SYMBOL = _descriptor.Descriptor(
+    name="Symbol",
+    full_name="google.cloud.vision.v1.Symbol",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1.Symbol.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1.Symbol.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1.Symbol.text",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1.Symbol.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1649,
+    serialized_end=1822,
+)
+
+_TEXTANNOTATION_DETECTEDLANGUAGE.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK.fields_by_name[
+    "type"
+].enum_type = _TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE
+_TEXTANNOTATION_DETECTEDBREAK.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE.containing_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_languages"
+].message_type = _TEXTANNOTATION_DETECTEDLANGUAGE
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_break"
+].message_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION.fields_by_name["pages"].message_type = _PAGE
+_PAGE.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PAGE.fields_by_name["blocks"].message_type = _BLOCK
+_BLOCK.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_BLOCK.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_BLOCK.fields_by_name["paragraphs"].message_type = _PARAGRAPH
+_BLOCK.fields_by_name["block_type"].enum_type = _BLOCK_BLOCKTYPE
+_BLOCK_BLOCKTYPE.containing_type = _BLOCK
+_PARAGRAPH.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PARAGRAPH.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PARAGRAPH.fields_by_name["words"].message_type = _WORD
+_WORD.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_WORD.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_WORD.fields_by_name["symbols"].message_type = _SYMBOL
+_SYMBOL.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_SYMBOL.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["Page"] = _PAGE
+DESCRIPTOR.message_types_by_name["Block"] = _BLOCK
+DESCRIPTOR.message_types_by_name["Paragraph"] = _PARAGRAPH
+DESCRIPTOR.message_types_by_name["Word"] = _WORD
+DESCRIPTOR.message_types_by_name["Symbol"] = _SYMBOL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DetectedLanguage=_reflection.GeneratedProtocolMessageType(
+            "DetectedLanguage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDLANGUAGE,
+                __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+                __doc__="""Detected language for a structural component.
+    
+    
+    Attributes:
+        language_code:
+            The BCP-47 language code, such as "en-US" or "sr-Latn". For
+            more information, see http://www.unicode.org/reports/tr35/#Uni
+            code\_locale\_identifier.
+        confidence:
+            Confidence of detected language. Range [0, 1].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.TextAnnotation.DetectedLanguage)
+            ),
+        ),
+        DetectedBreak=_reflection.GeneratedProtocolMessageType(
+            "DetectedBreak",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDBREAK,
+                __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+                __doc__="""Detected start or end of a structural component.
+    
+    
+    Attributes:
+        type:
+            Detected break type.
+        is_prefix:
+            True if break prepends the element.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.TextAnnotation.DetectedBreak)
+            ),
+        ),
+        TextProperty=_reflection.GeneratedProtocolMessageType(
+            "TextProperty",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_TEXTPROPERTY,
+                __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+                __doc__="""Additional information detected on the structural component.
+    
+    
+    Attributes:
+        detected_languages:
+            A list of detected languages together with confidence.
+        detected_break:
+            Detected start or end of a text segment.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.TextAnnotation.TextProperty)
+            ),
+        ),
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+        __doc__="""TextAnnotation contains a structured representation of OCR extracted
+  text. The hierarchy of an OCR extracted text structure is like this:
+  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.
+  
+  
+  Attributes:
+      pages:
+          List of pages detected by OCR.
+      text:
+          UTF-8 text detected on the pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+_sym_db.RegisterMessage(TextAnnotation.DetectedLanguage)
+_sym_db.RegisterMessage(TextAnnotation.DetectedBreak)
+_sym_db.RegisterMessage(TextAnnotation.TextProperty)
+
+Page = _reflection.GeneratedProtocolMessageType(
+    "Page",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAGE,
+        __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+        __doc__="""Detected page from OCR.
+  
+  
+  Attributes:
+      property:
+          Additional information detected on the page.
+      width:
+          Page width. For PDFs the unit is points. For images (including
+          TIFFs) the unit is pixels.
+      height:
+          Page height. For PDFs the unit is points. For images
+          (including TIFFs) the unit is pixels.
+      blocks:
+          List of blocks of text, images etc on this page.
+      confidence:
+          Confidence of the OCR results on the page. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Page)
+    ),
+)
+_sym_db.RegisterMessage(Page)
+
+Block = _reflection.GeneratedProtocolMessageType(
+    "Block",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BLOCK,
+        __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+        __doc__="""Logical element on the page.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the block.
+      bounding_box:
+          The bounding box for the block. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example:  -
+          when the text is horizontal it might look like:     ::
+          0----1        |    |        3----2  -  when it's rotated 180
+          degrees around the top-left corner it becomes:     ::
+          2----3        |    |        1----0  and the vertex order will
+          still be (0, 1, 2, 3).
+      paragraphs:
+          List of paragraphs in this block (if this blocks is of type
+          text).
+      block_type:
+          Detected block type (text, image etc) for this block.
+      confidence:
+          Confidence of the OCR results on the block. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Block)
+    ),
+)
+_sym_db.RegisterMessage(Block)
+
+Paragraph = _reflection.GeneratedProtocolMessageType(
+    "Paragraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAGRAPH,
+        __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+        __doc__="""Structural unit of text representing a number of words in certain order.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the paragraph.
+      bounding_box:
+          The bounding box for the paragraph. The vertices are in the
+          order of top-left, top-right, bottom-right, bottom-left. When
+          a rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertex order
+          will still be (0, 1, 2, 3).
+      words:
+          List of all words in this paragraph.
+      confidence:
+          Confidence of the OCR results for the paragraph. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Paragraph)
+    ),
+)
+_sym_db.RegisterMessage(Paragraph)
+
+Word = _reflection.GeneratedProtocolMessageType(
+    "Word",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORD,
+        __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+        __doc__="""A word representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the word.
+      bounding_box:
+          The bounding box for the word. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertex order
+          will still be (0, 1, 2, 3).
+      symbols:
+          List of symbols in the word. The order of the symbols follows
+          the natural reading order.
+      confidence:
+          Confidence of the OCR results for the word. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Word)
+    ),
+)
+_sym_db.RegisterMessage(Word)
+
+Symbol = _reflection.GeneratedProtocolMessageType(
+    "Symbol",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYMBOL,
+        __module__="google.cloud.vision_v1.proto.text_annotation_pb2",
+        __doc__="""A single symbol representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the symbol.
+      bounding_box:
+          The bounding box for the symbol. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertex order
+          will still be (0, 1, 2, 3).
+      text:
+          The actual UTF-8 representation of the symbol.
+      confidence:
+          Confidence of the OCR results for the symbol. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.Symbol)
+    ),
+)
+_sym_db.RegisterMessage(Symbol)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1/proto/text_annotation_pb2_grpc.py b/vision/google/cloud/vision_v1/proto/text_annotation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/text_annotation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1/proto/web_detection.proto b/vision/google/cloud/vision_v1/proto/web_detection.proto
new file mode 100644
index 000000000000..5ba8640382f1
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/web_detection.proto
@@ -0,0 +1,107 @@
+// 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.v1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "WebDetectionProto";
+option java_package = "com.google.cloud.vision.v1";
+option objc_class_prefix = "GCVN";
+
+// Relevant information for the image from the Internet.
+message WebDetection {
+  // Entity deduced from similar images on the Internet.
+  message WebEntity {
+    // Opaque entity ID.
+    string entity_id = 1;
+
+    // Overall relevancy score for the entity.
+    // Not normalized and not comparable across different image queries.
+    float score = 2;
+
+    // Canonical description of the entity, in English.
+    string description = 3;
+  }
+
+  // Metadata for online images.
+  message WebImage {
+    // The result image URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the image.
+    float score = 2;
+  }
+
+  // Metadata for web pages.
+  message WebPage {
+    // The result web page URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the web page.
+    float score = 2;
+
+    // Title for the web page, may contain HTML markups.
+    string page_title = 3;
+
+    // Fully matching images on the page.
+    // Can include resized copies of the query image.
+    repeated WebImage full_matching_images = 4;
+
+    // Partial matching images on the page.
+    // Those images are similar enough to share some key-point features. For
+    // example an original image will likely have partial matching for its
+    // crops.
+    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;
+
+  // Fully matching images from the Internet.
+  // Can include resized copies of the query image.
+  repeated WebImage full_matching_images = 2;
+
+  // Partial matching images from the Internet.
+  // Those images are similar enough to share some key-point features. For
+  // example an original image will likely have partial matching for its crops.
+  repeated WebImage partial_matching_images = 3;
+
+  // Web pages containing the matching images from the Internet.
+  repeated WebPage pages_with_matching_images = 4;
+
+  // The visually similar image results.
+  repeated WebImage visually_similar_images = 6;
+
+  // The service's best guess as to the topic of the request image.
+  // Inferred from similar images on the open web.
+  repeated WebLabel best_guess_labels = 8;
+}
diff --git a/vision/google/cloud/vision_v1/proto/web_detection_pb2.py b/vision/google/cloud/vision_v1/proto/web_detection_pb2.py
new file mode 100644
index 000000000000..f1f80fd34eed
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/web_detection_pb2.py
@@ -0,0 +1,617 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1/proto/web_detection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1/proto/web_detection.proto",
+    package="google.cloud.vision.v1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.cloud.vision.v1B\021WebDetectionProtoP\001Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/vision_v1/proto/web_detection.proto\x12\x16google.cloud.vision.v1\x1a\x1cgoogle/api/annotations.proto"\xd4\x06\n\x0cWebDetection\x12\x44\n\x0cweb_entities\x18\x01 \x03(\x0b\x32..google.cloud.vision.v1.WebDetection.WebEntity\x12K\n\x14\x66ull_matching_images\x18\x02 \x03(\x0b\x32-.google.cloud.vision.v1.WebDetection.WebImage\x12N\n\x17partial_matching_images\x18\x03 \x03(\x0b\x32-.google.cloud.vision.v1.WebDetection.WebImage\x12P\n\x1apages_with_matching_images\x18\x04 \x03(\x0b\x32,.google.cloud.vision.v1.WebDetection.WebPage\x12N\n\x17visually_similar_images\x18\x06 \x03(\x0b\x32-.google.cloud.vision.v1.WebDetection.WebImage\x12H\n\x11\x62\x65st_guess_labels\x18\x08 \x03(\x0b\x32-.google.cloud.vision.v1.WebDetection.WebLabel\x1a\x42\n\tWebEntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x1a&\n\x08WebImage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x1a\xd6\x01\n\x07WebPage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x12\n\npage_title\x18\x03 \x01(\t\x12K\n\x14\x66ull_matching_images\x18\x04 \x03(\x0b\x32-.google.cloud.vision.v1.WebDetection.WebImage\x12N\n\x17partial_matching_images\x18\x05 \x03(\x0b\x32-.google.cloud.vision.v1.WebDetection.WebImage\x1a\x30\n\x08WebLabel\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\tBy\n\x1a\x63om.google.cloud.vision.v1B\x11WebDetectionProtoP\x01Z<google.golang.org/genproto/googleapis/cloud/vision/v1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_WEBDETECTION_WEBENTITY = _descriptor.Descriptor(
+    name="WebEntity",
+    full_name="google.cloud.vision.v1.WebDetection.WebEntity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.vision.v1.WebDetection.WebEntity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.WebDetection.WebEntity.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1.WebDetection.WebEntity.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=586,
+    serialized_end=652,
+)
+
+_WEBDETECTION_WEBIMAGE = _descriptor.Descriptor(
+    name="WebImage",
+    full_name="google.cloud.vision.v1.WebDetection.WebImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1.WebDetection.WebImage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.WebDetection.WebImage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=654,
+    serialized_end=692,
+)
+
+_WEBDETECTION_WEBPAGE = _descriptor.Descriptor(
+    name="WebPage",
+    full_name="google.cloud.vision.v1.WebDetection.WebPage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1.WebDetection.WebPage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1.WebDetection.WebPage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_title",
+            full_name="google.cloud.vision.v1.WebDetection.WebPage.page_title",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1.WebDetection.WebPage.full_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1.WebDetection.WebPage.partial_matching_images",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=695,
+    serialized_end=909,
+)
+
+_WEBDETECTION_WEBLABEL = _descriptor.Descriptor(
+    name="WebLabel",
+    full_name="google.cloud.vision.v1.WebDetection.WebLabel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.vision.v1.WebDetection.WebLabel.label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1.WebDetection.WebLabel.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=911,
+    serialized_end=959,
+)
+
+_WEBDETECTION = _descriptor.Descriptor(
+    name="WebDetection",
+    full_name="google.cloud.vision.v1.WebDetection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="web_entities",
+            full_name="google.cloud.vision.v1.WebDetection.web_entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1.WebDetection.full_matching_images",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1.WebDetection.partial_matching_images",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages_with_matching_images",
+            full_name="google.cloud.vision.v1.WebDetection.pages_with_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="visually_similar_images",
+            full_name="google.cloud.vision.v1.WebDetection.visually_similar_images",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="best_guess_labels",
+            full_name="google.cloud.vision.v1.WebDetection.best_guess_labels",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _WEBDETECTION_WEBENTITY,
+        _WEBDETECTION_WEBIMAGE,
+        _WEBDETECTION_WEBPAGE,
+        _WEBDETECTION_WEBLABEL,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=107,
+    serialized_end=959,
+)
+
+_WEBDETECTION_WEBENTITY.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBIMAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBLABEL.containing_type = _WEBDETECTION
+_WEBDETECTION.fields_by_name["web_entities"].message_type = _WEBDETECTION_WEBENTITY
+_WEBDETECTION.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "pages_with_matching_images"
+].message_type = _WEBDETECTION_WEBPAGE
+_WEBDETECTION.fields_by_name[
+    "visually_similar_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name["best_guess_labels"].message_type = _WEBDETECTION_WEBLABEL
+DESCRIPTOR.message_types_by_name["WebDetection"] = _WEBDETECTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WebDetection = _reflection.GeneratedProtocolMessageType(
+    "WebDetection",
+    (_message.Message,),
+    dict(
+        WebEntity=_reflection.GeneratedProtocolMessageType(
+            "WebEntity",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBENTITY,
+                __module__="google.cloud.vision_v1.proto.web_detection_pb2",
+                __doc__="""Entity deduced from similar images on the Internet.
+    
+    
+    Attributes:
+        entity_id:
+            Opaque entity ID.
+        score:
+            Overall relevancy score for the entity. Not normalized and not
+            comparable across different image queries.
+        description:
+            Canonical description of the entity, in English.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.WebDetection.WebEntity)
+            ),
+        ),
+        WebImage=_reflection.GeneratedProtocolMessageType(
+            "WebImage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBIMAGE,
+                __module__="google.cloud.vision_v1.proto.web_detection_pb2",
+                __doc__="""Metadata for online images.
+    
+    
+    Attributes:
+        url:
+            The result image URL.
+        score:
+            (Deprecated) Overall relevancy score for the image.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.WebDetection.WebImage)
+            ),
+        ),
+        WebPage=_reflection.GeneratedProtocolMessageType(
+            "WebPage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBPAGE,
+                __module__="google.cloud.vision_v1.proto.web_detection_pb2",
+                __doc__="""Metadata for web pages.
+    
+    
+    Attributes:
+        url:
+            The result web page URL.
+        score:
+            (Deprecated) Overall relevancy score for the web page.
+        page_title:
+            Title for the web page, may contain HTML markups.
+        full_matching_images:
+            Fully matching images on the page. Can include resized copies
+            of the query image.
+        partial_matching_images:
+            Partial matching images on the page. Those images are similar
+            enough to share some key-point features. For example an
+            original image will likely have partial matching for its
+            crops.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.WebDetection.WebPage)
+            ),
+        ),
+        WebLabel=_reflection.GeneratedProtocolMessageType(
+            "WebLabel",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBLABEL,
+                __module__="google.cloud.vision_v1.proto.web_detection_pb2",
+                __doc__="""Label to provide extra metadata for the web detection.
+    
+    
+    Attributes:
+        label:
+            Label for extra metadata.
+        language_code:
+            The BCP-47 language code for ``label``, such as "en-US" or
+            "sr-Latn". For more information, see http://www.unicode.org/re
+            ports/tr35/#Unicode\_locale\_identifier.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.WebDetection.WebLabel)
+            ),
+        ),
+        DESCRIPTOR=_WEBDETECTION,
+        __module__="google.cloud.vision_v1.proto.web_detection_pb2",
+        __doc__="""Relevant information for the image from the Internet.
+  
+  
+  Attributes:
+      web_entities:
+          Deduced entities from similar images on the Internet.
+      full_matching_images:
+          Fully matching images from the Internet. Can include resized
+          copies of the query image.
+      partial_matching_images:
+          Partial matching images from the Internet. Those images are
+          similar enough to share some key-point features. For example
+          an original image will likely have partial matching for its
+          crops.
+      pages_with_matching_images:
+          Web pages containing the matching images from the Internet.
+      visually_similar_images:
+          The visually similar image results.
+      best_guess_labels:
+          The service's best guess as to the topic of the request image.
+          Inferred from similar images on the open web.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1.WebDetection)
+    ),
+)
+_sym_db.RegisterMessage(WebDetection)
+_sym_db.RegisterMessage(WebDetection.WebEntity)
+_sym_db.RegisterMessage(WebDetection.WebImage)
+_sym_db.RegisterMessage(WebDetection.WebPage)
+_sym_db.RegisterMessage(WebDetection.WebLabel)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1/proto/web_detection_pb2_grpc.py b/vision/google/cloud/vision_v1/proto/web_detection_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1/proto/web_detection_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1/types.py b/vision/google/cloud/vision_v1/types.py
new file mode 100644
index 000000000000..0eb8c5778579
--- /dev/null
+++ b/vision/google/cloud/vision_v1/types.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.vision_v1.proto import geometry_pb2
+from google.cloud.vision_v1.proto import image_annotator_pb2
+from google.cloud.vision_v1.proto import product_search_pb2
+from google.cloud.vision_v1.proto import product_search_service_pb2
+from google.cloud.vision_v1.proto import text_annotation_pb2
+from google.cloud.vision_v1.proto import web_detection_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import color_pb2
+from google.type import latlng_pb2
+
+
+_shared_modules = [
+    operations_pb2,
+    any_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    color_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [
+    geometry_pb2,
+    image_annotator_pb2,
+    product_search_pb2,
+    product_search_service_pb2,
+    text_annotation_pb2,
+    web_detection_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.vision_v1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/vision/google/cloud/vision_v1p1beta1/__init__.py b/vision/google/cloud/vision_v1p1beta1/__init__.py
new file mode 100644
index 000000000000..560b03a88b6f
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.vision_helpers.decorators import add_single_feature_methods
+from google.cloud.vision_helpers import VisionHelpers
+
+from google.cloud.vision_v1p1beta1 import types
+from google.cloud.vision_v1p1beta1.gapic import enums
+from google.cloud.vision_v1p1beta1.gapic import image_annotator_client as iac
+
+
+@add_single_feature_methods
+class ImageAnnotatorClient(VisionHelpers, iac.ImageAnnotatorClient):
+    __doc__ = iac.ImageAnnotatorClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ImageAnnotatorClient")
diff --git a/vision/google/cloud/vision_v1p1beta1/gapic/__init__.py b/vision/google/cloud/vision_v1p1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p1beta1/gapic/enums.py b/vision/google/cloud/vision_v1p1beta1/gapic/enums.py
new file mode 100644
index 000000000000..caf4d634339e
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/gapic/enums.py
@@ -0,0 +1,204 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Likelihood(enum.IntEnum):
+    """
+    A bucketized representation of likelihood, which is intended to give clients
+    highly stable results across model upgrades.
+
+    Attributes:
+      UNKNOWN (int): Unknown likelihood.
+      VERY_UNLIKELY (int): It is very unlikely that the image belongs to the specified vertical.
+      UNLIKELY (int): It is unlikely that the image belongs to the specified vertical.
+      POSSIBLE (int): It is possible that the image belongs to the specified vertical.
+      LIKELY (int): It is likely that the image belongs to the specified vertical.
+      VERY_LIKELY (int): It is very likely that the image belongs to the specified vertical.
+    """
+
+    UNKNOWN = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class Block(object):
+    class BlockType(enum.IntEnum):
+        """
+        Type of a block (text, image etc) as identified by OCR.
+
+        Attributes:
+          UNKNOWN (int): Unknown block type.
+          TEXT (int): Regular text block.
+          TABLE (int): Table block.
+          PICTURE (int): Image block.
+          RULER (int): Horizontal/vertical line box.
+          BARCODE (int): Barcode block.
+        """
+
+        UNKNOWN = 0
+        TEXT = 1
+        TABLE = 2
+        PICTURE = 3
+        RULER = 4
+        BARCODE = 5
+
+
+class FaceAnnotation(object):
+    class Landmark(object):
+        class Type(enum.IntEnum):
+            """
+            Face landmark (feature) type. Left and right are defined from the
+            vantage of the viewer of the image without considering mirror
+            projections typical of photos. So, ``LEFT_EYE``, typically, is the
+            person's right eye.
+
+            Attributes:
+              UNKNOWN_LANDMARK (int): Unknown face landmark detected. Should not be filled.
+              LEFT_EYE (int): Left eye.
+              RIGHT_EYE (int): Right eye.
+              LEFT_OF_LEFT_EYEBROW (int): Left of left eyebrow.
+              RIGHT_OF_LEFT_EYEBROW (int): Right of left eyebrow.
+              LEFT_OF_RIGHT_EYEBROW (int): Left of right eyebrow.
+              RIGHT_OF_RIGHT_EYEBROW (int): Right of right eyebrow.
+              MIDPOINT_BETWEEN_EYES (int): Midpoint between eyes.
+              NOSE_TIP (int): Nose tip.
+              UPPER_LIP (int): Upper lip.
+              LOWER_LIP (int): Lower lip.
+              MOUTH_LEFT (int): Mouth left.
+              MOUTH_RIGHT (int): Mouth right.
+              MOUTH_CENTER (int): Mouth center.
+              NOSE_BOTTOM_RIGHT (int): Nose, bottom right.
+              NOSE_BOTTOM_LEFT (int): Nose, bottom left.
+              NOSE_BOTTOM_CENTER (int): Nose, bottom center.
+              LEFT_EYE_TOP_BOUNDARY (int): Left eye, top boundary.
+              LEFT_EYE_RIGHT_CORNER (int): Left eye, right corner.
+              LEFT_EYE_BOTTOM_BOUNDARY (int): Left eye, bottom boundary.
+              LEFT_EYE_LEFT_CORNER (int): Left eye, left corner.
+              RIGHT_EYE_TOP_BOUNDARY (int): Right eye, top boundary.
+              RIGHT_EYE_RIGHT_CORNER (int): Right eye, right corner.
+              RIGHT_EYE_BOTTOM_BOUNDARY (int): Right eye, bottom boundary.
+              RIGHT_EYE_LEFT_CORNER (int): Right eye, left corner.
+              LEFT_EYEBROW_UPPER_MIDPOINT (int): Left eyebrow, upper midpoint.
+              RIGHT_EYEBROW_UPPER_MIDPOINT (int): Right eyebrow, upper midpoint.
+              LEFT_EAR_TRAGION (int): Left ear tragion.
+              RIGHT_EAR_TRAGION (int): Right ear tragion.
+              LEFT_EYE_PUPIL (int): Left eye pupil.
+              RIGHT_EYE_PUPIL (int): Right eye pupil.
+              FOREHEAD_GLABELLA (int): Forehead glabella.
+              CHIN_GNATHION (int): Chin gnathion.
+              CHIN_LEFT_GONION (int): Chin left gonion.
+              CHIN_RIGHT_GONION (int): Chin right gonion.
+            """
+
+            UNKNOWN_LANDMARK = 0
+            LEFT_EYE = 1
+            RIGHT_EYE = 2
+            LEFT_OF_LEFT_EYEBROW = 3
+            RIGHT_OF_LEFT_EYEBROW = 4
+            LEFT_OF_RIGHT_EYEBROW = 5
+            RIGHT_OF_RIGHT_EYEBROW = 6
+            MIDPOINT_BETWEEN_EYES = 7
+            NOSE_TIP = 8
+            UPPER_LIP = 9
+            LOWER_LIP = 10
+            MOUTH_LEFT = 11
+            MOUTH_RIGHT = 12
+            MOUTH_CENTER = 13
+            NOSE_BOTTOM_RIGHT = 14
+            NOSE_BOTTOM_LEFT = 15
+            NOSE_BOTTOM_CENTER = 16
+            LEFT_EYE_TOP_BOUNDARY = 17
+            LEFT_EYE_RIGHT_CORNER = 18
+            LEFT_EYE_BOTTOM_BOUNDARY = 19
+            LEFT_EYE_LEFT_CORNER = 20
+            RIGHT_EYE_TOP_BOUNDARY = 21
+            RIGHT_EYE_RIGHT_CORNER = 22
+            RIGHT_EYE_BOTTOM_BOUNDARY = 23
+            RIGHT_EYE_LEFT_CORNER = 24
+            LEFT_EYEBROW_UPPER_MIDPOINT = 25
+            RIGHT_EYEBROW_UPPER_MIDPOINT = 26
+            LEFT_EAR_TRAGION = 27
+            RIGHT_EAR_TRAGION = 28
+            LEFT_EYE_PUPIL = 29
+            RIGHT_EYE_PUPIL = 30
+            FOREHEAD_GLABELLA = 31
+            CHIN_GNATHION = 32
+            CHIN_LEFT_GONION = 33
+            CHIN_RIGHT_GONION = 34
+
+
+class Feature(object):
+    class Type(enum.IntEnum):
+        """
+        Type of image feature.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Unspecified feature type.
+          FACE_DETECTION (int): Run face detection.
+          LANDMARK_DETECTION (int): Run landmark detection.
+          LOGO_DETECTION (int): Run logo detection.
+          LABEL_DETECTION (int): Run label detection.
+          TEXT_DETECTION (int): Run OCR.
+          DOCUMENT_TEXT_DETECTION (int): Run dense text document OCR. Takes precedence when both
+          DOCUMENT\_TEXT\_DETECTION and TEXT\_DETECTION are present.
+          SAFE_SEARCH_DETECTION (int): Run computer vision models to compute image safe-search properties.
+          IMAGE_PROPERTIES (int): Compute a set of image properties, such as the image's dominant colors.
+          CROP_HINTS (int): Run crop hints.
+          WEB_DETECTION (int): Run web detection.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        FACE_DETECTION = 1
+        LANDMARK_DETECTION = 2
+        LOGO_DETECTION = 3
+        LABEL_DETECTION = 4
+        TEXT_DETECTION = 5
+        DOCUMENT_TEXT_DETECTION = 11
+        SAFE_SEARCH_DETECTION = 6
+        IMAGE_PROPERTIES = 7
+        CROP_HINTS = 9
+        WEB_DETECTION = 10
+
+
+class TextAnnotation(object):
+    class DetectedBreak(object):
+        class BreakType(enum.IntEnum):
+            """
+            Enum to denote the type of break found. New line, space etc.
+
+            Attributes:
+              UNKNOWN (int): Unknown break label type.
+              SPACE (int): Regular space.
+              SURE_SPACE (int): Sure space (very wide).
+              EOL_SURE_SPACE (int): Line-wrapping break.
+              HYPHEN (int): End-line hyphen that is not present in text; does not co-occur with
+              ``SPACE``, ``LEADER_SPACE``, or ``LINE_BREAK``.
+              LINE_BREAK (int): Line break that ends a paragraph.
+            """
+
+            UNKNOWN = 0
+            SPACE = 1
+            SURE_SPACE = 2
+            EOL_SURE_SPACE = 3
+            HYPHEN = 4
+            LINE_BREAK = 5
diff --git a/vision/google/cloud/vision_v1p1beta1/gapic/image_annotator_client.py b/vision/google/cloud/vision_v1p1beta1/gapic/image_annotator_client.py
new file mode 100644
index 000000000000..2032a08944f4
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/gapic/image_annotator_client.py
@@ -0,0 +1,247 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1p1beta1 ImageAnnotator API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.vision_v1p1beta1.gapic import enums
+from google.cloud.vision_v1p1beta1.gapic import image_annotator_client_config
+from google.cloud.vision_v1p1beta1.gapic.transports import (
+    image_annotator_grpc_transport,
+)
+from google.cloud.vision_v1p1beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p1beta1.proto import image_annotator_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ImageAnnotatorClient(object):
+    """
+    Service that performs Google Cloud Vision API detection tasks over client
+    images, such as face, landmark, logo, label, and text detection. The
+    ImageAnnotator service returns detected entities from the images.
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1p1beta1.ImageAnnotator"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ImageAnnotatorClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ImageAnnotatorGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ImageAnnotatorGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = image_annotator_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=image_annotator_grpc_transport.ImageAnnotatorGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = image_annotator_grpc_transport.ImageAnnotatorGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def batch_annotate_images(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run image detection and annotation for a batch of images.
+
+        Example:
+            >>> from google.cloud import vision_v1p1beta1
+            >>>
+            >>> client = vision_v1p1beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_images(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p1beta1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p1beta1.types.AnnotateImageRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p1beta1.types.BatchAnnotateImagesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_images,
+                default_retry=self._method_configs["BatchAnnotateImages"].retry,
+                default_timeout=self._method_configs["BatchAnnotateImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateImagesRequest(requests=requests)
+        return self._inner_api_calls["batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/vision/google/cloud/vision_v1p1beta1/gapic/image_annotator_client_config.py b/vision/google/cloud/vision_v1p1beta1/gapic/image_annotator_client_config.py
new file mode 100644
index 000000000000..956b15714108
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/gapic/image_annotator_client_config.py
@@ -0,0 +1,28 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1p1beta1.ImageAnnotator": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "BatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                }
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/gapic/transports/__init__.py b/vision/google/cloud/vision_v1p1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p1beta1/gapic/transports/image_annotator_grpc_transport.py b/vision/google/cloud/vision_v1p1beta1/gapic/transports/image_annotator_grpc_transport.py
new file mode 100644
index 000000000000..f5100d6fe59e
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/gapic/transports/image_annotator_grpc_transport.py
@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.vision_v1p1beta1.proto import image_annotator_pb2_grpc
+
+
+class ImageAnnotatorGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1p1beta1 ImageAnnotator API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "image_annotator_stub": image_annotator_pb2_grpc.ImageAnnotatorStub(channel)
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_images`.
+
+        Run image detection and annotation for a batch of images.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateImages
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/__init__.py b/vision/google/cloud/vision_v1p1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/geometry.proto b/vision/google/cloud/vision_v1p1beta1/proto/geometry.proto
new file mode 100644
index 000000000000..6d46d9c342ec
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/geometry.proto
@@ -0,0 +1,53 @@
+// 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.vision.v1p1beta1;
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "GeometryProto";
+option java_package = "com.google.cloud.vision.v1p1beta1";
+
+// 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 bounding polygon for the detected image annotation.
+message BoundingPoly {
+  // The bounding polygon vertices.
+  repeated Vertex vertices = 1;
+}
+
+// A 3D position in the image, used primarily for Face detection landmarks.
+// A valid Position must have both x and y coordinates.
+// The position coordinates are in the same scale as the original image.
+message Position {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+
+  // Z coordinate (or depth).
+  float z = 3;
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/geometry_pb2.py b/vision/google/cloud/vision_v1p1beta1/proto/geometry_pb2.py
new file mode 100644
index 000000000000..1539aac05d00
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/geometry_pb2.py
@@ -0,0 +1,269 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p1beta1/proto/geometry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p1beta1/proto/geometry.proto",
+    package="google.cloud.vision.v1p1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p1beta1B\rGeometryProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/vision_v1p1beta1/proto/geometry.proto\x12\x1dgoogle.cloud.vision.v1p1beta1"\x1e\n\x06Vertex\x12\t\n\x01x\x18\x01 \x01(\x05\x12\t\n\x01y\x18\x02 \x01(\x05"G\n\x0c\x42oundingPoly\x12\x37\n\x08vertices\x18\x01 \x03(\x0b\x32%.google.cloud.vision.v1p1beta1.Vertex"+\n\x08Position\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02\x12\t\n\x01z\x18\x03 \x01(\x02\x42|\n!com.google.cloud.vision.v1p1beta1B\rGeometryProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+)
+
+
+_VERTEX = _descriptor.Descriptor(
+    name="Vertex",
+    full_name="google.cloud.vision.v1p1beta1.Vertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p1beta1.Vertex.x",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p1beta1.Vertex.y",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=85,
+    serialized_end=115,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.vision.v1p1beta1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.vision.v1p1beta1.BoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=117,
+    serialized_end=188,
+)
+
+
+_POSITION = _descriptor.Descriptor(
+    name="Position",
+    full_name="google.cloud.vision.v1p1beta1.Position",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p1beta1.Position.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p1beta1.Position.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="z",
+            full_name="google.cloud.vision.v1p1beta1.Position.z",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=190,
+    serialized_end=233,
+)
+
+_BOUNDINGPOLY.fields_by_name["vertices"].message_type = _VERTEX
+DESCRIPTOR.message_types_by_name["Vertex"] = _VERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["Position"] = _POSITION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Vertex = _reflection.GeneratedProtocolMessageType(
+    "Vertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTEX,
+        __module__="google.cloud.vision_v1p1beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Vertex)
+    ),
+)
+_sym_db.RegisterMessage(Vertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.vision_v1p1beta1.proto.geometry_pb2",
+        __doc__="""A bounding polygon for the detected image annotation.
+  
+  
+  Attributes:
+      vertices:
+          The bounding polygon vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+Position = _reflection.GeneratedProtocolMessageType(
+    "Position",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSITION,
+        __module__="google.cloud.vision_v1p1beta1.proto.geometry_pb2",
+        __doc__="""A 3D position in the image, used primarily for Face detection landmarks.
+  A valid Position must have both x and y coordinates. The position
+  coordinates are in the same scale as the original image.
+  
+  
+  Attributes:
+      x:
+          X coordinate.
+      y:
+          Y coordinate.
+      z:
+          Z coordinate (or depth).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Position)
+    ),
+)
+_sym_db.RegisterMessage(Position)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/geometry_pb2_grpc.py b/vision/google/cloud/vision_v1p1beta1/proto/geometry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/geometry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/image_annotator.proto b/vision/google/cloud/vision_v1p1beta1/proto/image_annotator.proto
new file mode 100644
index 000000000000..4869a3311730
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/image_annotator.proto
@@ -0,0 +1,592 @@
+// 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.vision.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p1beta1/geometry.proto";
+import "google/cloud/vision/v1p1beta1/text_annotation.proto";
+import "google/cloud/vision/v1p1beta1/web_detection.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+import "google/type/latlng.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ImageAnnotatorProto";
+option java_package = "com.google.cloud.vision.v1p1beta1";
+
+// Service that performs Google Cloud Vision API detection tasks over client
+// images, such as face, landmark, logo, label, and text detection. The
+// ImageAnnotator service returns detected entities from the images.
+service ImageAnnotator {
+  // Run image detection and annotation for a batch of images.
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
+      returns (BatchAnnotateImagesResponse) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/images:annotate"
+      body: "*"
+    };
+  }
+}
+
+// Users describe the type of Google Cloud Vision API tasks to perform over
+// images by using *Feature*s. Each Feature indicates a type of image
+// detection task to perform. Features encode the Cloud Vision API
+// vertical to operate on and the number of top-scoring results to return.
+message Feature {
+  // Type of image feature.
+  enum Type {
+    // Unspecified feature type.
+    TYPE_UNSPECIFIED = 0;
+
+    // Run face detection.
+    FACE_DETECTION = 1;
+
+    // Run landmark detection.
+    LANDMARK_DETECTION = 2;
+
+    // Run logo detection.
+    LOGO_DETECTION = 3;
+
+    // Run label detection.
+    LABEL_DETECTION = 4;
+
+    // Run OCR.
+    TEXT_DETECTION = 5;
+
+    // Run dense text document OCR. Takes precedence when both
+    // DOCUMENT_TEXT_DETECTION and TEXT_DETECTION are present.
+    DOCUMENT_TEXT_DETECTION = 11;
+
+    // Run computer vision models to compute image safe-search properties.
+    SAFE_SEARCH_DETECTION = 6;
+
+    // Compute a set of image properties, such as the image's dominant colors.
+    IMAGE_PROPERTIES = 7;
+
+    // Run crop hints.
+    CROP_HINTS = 9;
+
+    // Run web detection.
+    WEB_DETECTION = 10;
+  }
+
+  // The feature type.
+  Type type = 1;
+
+  // Maximum number of results of this type.
+  int32 max_results = 2;
+
+  // Model to use for the feature.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// External image source (Google Cloud Storage image location).
+message ImageSource {
+  // NOTE: For new code `image_uri` below is preferred.
+  // Google Cloud Storage image URI, which must be in the following form:
+  // `gs://bucket_name/object_name` (for details, see
+  // [Google Cloud Storage Request
+  // URIs](https://cloud.google.com/storage/docs/reference-uris)).
+  // NOTE: Cloud Storage object versioning is not supported.
+  string gcs_image_uri = 1;
+
+  // Image URI which supports:
+  // 1) Google Cloud Storage image URI, which must be in the following form:
+  // `gs://bucket_name/object_name` (for details, see
+  // [Google Cloud Storage Request
+  // URIs](https://cloud.google.com/storage/docs/reference-uris)).
+  // NOTE: Cloud Storage object versioning is not supported.
+  // 2) Publicly accessible image HTTP/HTTPS URL.
+  // This is preferred over the legacy `gcs_image_uri` above. When both
+  // `gcs_image_uri` and `image_uri` are specified, `image_uri` takes
+  // precedence.
+  string image_uri = 2;
+}
+
+// Client image to perform Google Cloud Vision API tasks over.
+message Image {
+  // 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 content = 1;
+
+  // Google Cloud Storage image location. If both `content` and `source`
+  // are provided for an image, `content` takes precedence and is
+  // used to perform the image annotation request.
+  ImageSource source = 2;
+}
+
+// A face annotation object contains the results of face detection.
+message FaceAnnotation {
+  // A face-specific landmark (for example, a face feature).
+  message Landmark {
+    // Face landmark (feature) type.
+    // Left and right are defined from the vantage of the viewer of the image
+    // without considering mirror projections typical of photos. So, `LEFT_EYE`,
+    // typically, is the person's right eye.
+    enum Type {
+      // Unknown face landmark detected. Should not be filled.
+      UNKNOWN_LANDMARK = 0;
+
+      // Left eye.
+      LEFT_EYE = 1;
+
+      // Right eye.
+      RIGHT_EYE = 2;
+
+      // Left of left eyebrow.
+      LEFT_OF_LEFT_EYEBROW = 3;
+
+      // Right of left eyebrow.
+      RIGHT_OF_LEFT_EYEBROW = 4;
+
+      // Left of right eyebrow.
+      LEFT_OF_RIGHT_EYEBROW = 5;
+
+      // Right of right eyebrow.
+      RIGHT_OF_RIGHT_EYEBROW = 6;
+
+      // Midpoint between eyes.
+      MIDPOINT_BETWEEN_EYES = 7;
+
+      // Nose tip.
+      NOSE_TIP = 8;
+
+      // Upper lip.
+      UPPER_LIP = 9;
+
+      // Lower lip.
+      LOWER_LIP = 10;
+
+      // Mouth left.
+      MOUTH_LEFT = 11;
+
+      // Mouth right.
+      MOUTH_RIGHT = 12;
+
+      // Mouth center.
+      MOUTH_CENTER = 13;
+
+      // Nose, bottom right.
+      NOSE_BOTTOM_RIGHT = 14;
+
+      // Nose, bottom left.
+      NOSE_BOTTOM_LEFT = 15;
+
+      // Nose, bottom center.
+      NOSE_BOTTOM_CENTER = 16;
+
+      // Left eye, top boundary.
+      LEFT_EYE_TOP_BOUNDARY = 17;
+
+      // Left eye, right corner.
+      LEFT_EYE_RIGHT_CORNER = 18;
+
+      // Left eye, bottom boundary.
+      LEFT_EYE_BOTTOM_BOUNDARY = 19;
+
+      // Left eye, left corner.
+      LEFT_EYE_LEFT_CORNER = 20;
+
+      // Right eye, top boundary.
+      RIGHT_EYE_TOP_BOUNDARY = 21;
+
+      // Right eye, right corner.
+      RIGHT_EYE_RIGHT_CORNER = 22;
+
+      // Right eye, bottom boundary.
+      RIGHT_EYE_BOTTOM_BOUNDARY = 23;
+
+      // Right eye, left corner.
+      RIGHT_EYE_LEFT_CORNER = 24;
+
+      // Left eyebrow, upper midpoint.
+      LEFT_EYEBROW_UPPER_MIDPOINT = 25;
+
+      // Right eyebrow, upper midpoint.
+      RIGHT_EYEBROW_UPPER_MIDPOINT = 26;
+
+      // Left ear tragion.
+      LEFT_EAR_TRAGION = 27;
+
+      // Right ear tragion.
+      RIGHT_EAR_TRAGION = 28;
+
+      // Left eye pupil.
+      LEFT_EYE_PUPIL = 29;
+
+      // Right eye pupil.
+      RIGHT_EYE_PUPIL = 30;
+
+      // Forehead glabella.
+      FOREHEAD_GLABELLA = 31;
+
+      // Chin gnathion.
+      CHIN_GNATHION = 32;
+
+      // Chin left gonion.
+      CHIN_LEFT_GONION = 33;
+
+      // Chin right gonion.
+      CHIN_RIGHT_GONION = 34;
+    }
+
+    // Face landmark type.
+    Type type = 3;
+
+    // Face landmark position.
+    Position position = 4;
+  }
+
+  // The bounding polygon around the face. The coordinates of the bounding box
+  // are in the original image's scale, as returned in `ImageParams`.
+  // The bounding box is computed to "frame" the face in accordance with human
+  // expectations. It is based on the landmarker results.
+  // Note that one or more x and/or y coordinates may not be generated in the
+  // `BoundingPoly` (the polygon will be unbounded) if only a partial face
+  // appears in the image to be annotated.
+  BoundingPoly bounding_poly = 1;
+
+  // The `fd_bounding_poly` bounding polygon is tighter than the
+  // `boundingPoly`, and encloses only the skin part of the face. Typically, it
+  // is used to eliminate the face from any image analysis that detects the
+  // "amount of skin" visible in an image. It is not based on the
+  // landmarker results, only on the initial face detection, hence
+  // the <code>fd</code> (face detection) prefix.
+  BoundingPoly fd_bounding_poly = 2;
+
+  // Detected face landmarks.
+  repeated Landmark landmarks = 3;
+
+  // Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
+  // of the face relative to the image vertical about the axis perpendicular to
+  // the face. Range [-180,180].
+  float roll_angle = 4;
+
+  // Yaw angle, which indicates the leftward/rightward angle that the face is
+  // pointing relative to the vertical plane perpendicular to the image. Range
+  // [-180,180].
+  float pan_angle = 5;
+
+  // Pitch angle, which indicates the upwards/downwards angle that the face is
+  // pointing relative to the image's horizontal plane. Range [-180,180].
+  float tilt_angle = 6;
+
+  // Detection confidence. Range [0, 1].
+  float detection_confidence = 7;
+
+  // Face landmarking confidence. Range [0, 1].
+  float landmarking_confidence = 8;
+
+  // Joy likelihood.
+  Likelihood joy_likelihood = 9;
+
+  // Sorrow likelihood.
+  Likelihood sorrow_likelihood = 10;
+
+  // Anger likelihood.
+  Likelihood anger_likelihood = 11;
+
+  // Surprise likelihood.
+  Likelihood surprise_likelihood = 12;
+
+  // Under-exposed likelihood.
+  Likelihood under_exposed_likelihood = 13;
+
+  // Blurred likelihood.
+  Likelihood blurred_likelihood = 14;
+
+  // Headwear likelihood.
+  Likelihood headwear_likelihood = 15;
+}
+
+// Detected entity location information.
+message LocationInfo {
+  // lat/long location coordinates.
+  google.type.LatLng lat_lng = 1;
+}
+
+// A `Property` consists of a user-supplied name/value pair.
+message Property {
+  // Name of the property.
+  string name = 1;
+
+  // Value of the property.
+  string value = 2;
+
+  // Value of numeric properties.
+  uint64 uint64_value = 3;
+}
+
+// Set of detected entity features.
+message EntityAnnotation {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string mid = 1;
+
+  // The language code for the locale in which the entity textual
+  // `description` is expressed.
+  string locale = 2;
+
+  // Entity textual description, expressed in its `locale` language.
+  string description = 3;
+
+  // Overall score of the result. Range [0, 1].
+  float score = 4;
+
+  // The accuracy of the entity detection in an image.
+  // For example, for an image in which the "Eiffel Tower" entity is detected,
+  // this field represents the confidence that there is a tower in the query
+  // image. Range [0, 1].
+  float confidence = 5;
+
+  // The relevancy of the ICA (Image Content Annotation) label to the
+  // image. For example, the relevancy of "tower" is likely higher to an image
+  // containing the detected "Eiffel Tower" than to an image containing a
+  // detected distant towering building, even though the confidence that
+  // there is a tower in each image may be the same. Range [0, 1].
+  float topicality = 6;
+
+  // Image region to which this entity belongs. Not produced
+  // for `LABEL_DETECTION` features.
+  BoundingPoly bounding_poly = 7;
+
+  // The location information for the detected entity. Multiple
+  // `LocationInfo` elements can be present because one location may
+  // indicate the location of the scene in the image, and another location
+  // may indicate the location of the place where the image was taken.
+  // Location information is usually present for landmarks.
+  repeated LocationInfo locations = 8;
+
+  // Some entities may have optional user-supplied `Property` (name/value)
+  // fields, such a score or string that qualifies the entity.
+  repeated Property properties = 9;
+}
+
+// Set of features pertaining to the image, computed by computer vision
+// methods over safe-search verticals (for example, adult, spoof, medical,
+// violence).
+message SafeSearchAnnotation {
+  // Represents the adult content likelihood for the image. Adult content may
+  // contain elements such as nudity, pornographic images or cartoons, or
+  // sexual activities.
+  Likelihood adult = 1;
+
+  // Spoof likelihood. The likelihood that an modification
+  // was made to the image's canonical version to make it appear
+  // funny or offensive.
+  Likelihood spoof = 2;
+
+  // Likelihood that this is a medical image.
+  Likelihood medical = 3;
+
+  // Likelihood that this image contains violent content.
+  Likelihood violence = 4;
+
+  // Likelihood that the request image contains racy content. Racy content may
+  // include (but is not limited to) skimpy or sheer clothing, strategically
+  // covered nudity, lewd or provocative poses, or close-ups of sensitive
+  // body areas.
+  Likelihood racy = 9;
+}
+
+// Rectangle determined by min and max `LatLng` pairs.
+message LatLongRect {
+  // Min lat/long pair.
+  google.type.LatLng min_lat_lng = 1;
+
+  // Max lat/long pair.
+  google.type.LatLng max_lat_lng = 2;
+}
+
+// Color information consists of RGB channels, score, and the fraction of
+// the image that the color occupies in the image.
+message ColorInfo {
+  // RGB components of the color.
+  google.type.Color color = 1;
+
+  // Image-specific score for this color. Value in range [0, 1].
+  float score = 2;
+
+  // The fraction of pixels the color occupies in the image.
+  // Value in range [0, 1].
+  float pixel_fraction = 3;
+}
+
+// Set of dominant colors and their corresponding scores.
+message DominantColorsAnnotation {
+  // RGB color values with their score and pixel fraction.
+  repeated ColorInfo colors = 1;
+}
+
+// Stores image properties, such as dominant colors.
+message ImageProperties {
+  // If present, dominant colors completed successfully.
+  DominantColorsAnnotation dominant_colors = 1;
+}
+
+// Single crop hint that is used to generate a new crop when serving an image.
+message CropHint {
+  // The bounding polygon for the crop region. The coordinates of the bounding
+  // box are in the original image's scale, as returned in `ImageParams`.
+  BoundingPoly bounding_poly = 1;
+
+  // Confidence of this being a salient region.  Range [0, 1].
+  float confidence = 2;
+
+  // Fraction of importance of this salient region with respect to the original
+  // image.
+  float importance_fraction = 3;
+}
+
+// Set of crop hints that are used to generate new crops when serving images.
+message CropHintsAnnotation {
+  // Crop hint results.
+  repeated CropHint crop_hints = 1;
+}
+
+// Parameters for crop hints annotation request.
+message CropHintsParams {
+  // Aspect ratios in floats, representing the ratio of the width to the height
+  // of the image. For example, if the desired aspect ratio is 4/3, the
+  // corresponding float value should be 1.33333.  If not specified, the
+  // best possible crop is returned. The number of provided aspect ratios is
+  // limited to a maximum of 16; any aspect ratios provided after the 16th are
+  // ignored.
+  repeated float aspect_ratios = 1;
+}
+
+// Parameters for web detection request.
+message WebDetectionParams {
+  // Whether to include results derived from the geo information in the image.
+  bool include_geo_results = 2;
+}
+
+// Image context and/or feature-specific parameters.
+message ImageContext {
+  // lat/long rectangle that specifies the location of the image.
+  LatLongRect lat_long_rect = 1;
+
+  // List of languages to use for TEXT_DETECTION. 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). Text detection returns an
+  // error if one or more of the specified languages is not one of the
+  // [supported languages](/vision/docs/languages).
+  repeated string language_hints = 2;
+
+  // Parameters for crop hints annotation request.
+  CropHintsParams crop_hints_params = 4;
+
+  // Parameters for web detection.
+  WebDetectionParams web_detection_params = 6;
+}
+
+// Request for performing Google Cloud Vision API tasks over a user-provided
+// image, with user-requested features.
+message AnnotateImageRequest {
+  // The image to be processed.
+  Image image = 1;
+
+  // Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image.
+  ImageContext image_context = 3;
+}
+
+// Response to an image annotation request.
+message AnnotateImageResponse {
+  // If present, face detection has completed successfully.
+  repeated FaceAnnotation face_annotations = 1;
+
+  // If present, landmark detection has completed successfully.
+  repeated EntityAnnotation landmark_annotations = 2;
+
+  // If present, logo detection has completed successfully.
+  repeated EntityAnnotation logo_annotations = 3;
+
+  // If present, label detection has completed successfully.
+  repeated EntityAnnotation label_annotations = 4;
+
+  // If present, text (OCR) detection has completed successfully.
+  repeated EntityAnnotation text_annotations = 5;
+
+  // If present, text (OCR) detection or document (OCR) text detection has
+  // completed successfully.
+  // This annotation provides the structural hierarchy for the OCR detected
+  // text.
+  TextAnnotation full_text_annotation = 12;
+
+  // If present, safe-search annotation has completed successfully.
+  SafeSearchAnnotation safe_search_annotation = 6;
+
+  // If present, image properties were extracted successfully.
+  ImageProperties image_properties_annotation = 8;
+
+  // If present, crop hints have completed successfully.
+  CropHintsAnnotation crop_hints_annotation = 11;
+
+  // If present, web detection has completed successfully.
+  WebDetection web_detection = 13;
+
+  // If set, represents the error message for the operation.
+  // Note that filled-in image annotations are guaranteed to be
+  // correct, even when `error` is set.
+  google.rpc.Status error = 9;
+}
+
+// Multiple image annotation requests are batched into a single service call.
+message BatchAnnotateImagesRequest {
+  // Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1;
+}
+
+// Response to a batch image annotation request.
+message BatchAnnotateImagesResponse {
+  // Individual responses to image annotation requests within the batch.
+  repeated AnnotateImageResponse responses = 1;
+}
+
+// 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;
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/image_annotator_pb2.py b/vision/google/cloud/vision_v1p1beta1/proto/image_annotator_pb2.py
new file mode 100644
index 000000000000..cf3f4d75611a
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/image_annotator_pb2.py
@@ -0,0 +1,2976 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p1beta1/proto/image_annotator.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p1beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1p1beta1.proto import (
+    text_annotation_pb2 as google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_text__annotation__pb2,
+)
+from google.cloud.vision_v1p1beta1.proto import (
+    web_detection_pb2 as google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_web__detection__pb2,
+)
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.type import color_pb2 as google_dot_type_dot_color__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p1beta1/proto/image_annotator.proto",
+    package="google.cloud.vision.v1p1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p1beta1B\023ImageAnnotatorProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p1beta1/proto/image_annotator.proto\x12\x1dgoogle.cloud.vision.v1p1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p1beta1/proto/geometry.proto\x1a\x39google/cloud/vision_v1p1beta1/proto/text_annotation.proto\x1a\x37google/cloud/vision_v1p1beta1/proto/web_detection.proto\x1a\x17google/rpc/status.proto\x1a\x17google/type/color.proto\x1a\x18google/type/latlng.proto"\xe1\x02\n\x07\x46\x65\x61ture\x12\x39\n\x04type\x18\x01 \x01(\x0e\x32+.google.cloud.vision.v1p1beta1.Feature.Type\x12\x13\n\x0bmax_results\x18\x02 \x01(\x05\x12\r\n\x05model\x18\x03 \x01(\t"\xf6\x01\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x01\x12\x16\n\x12LANDMARK_DETECTION\x10\x02\x12\x12\n\x0eLOGO_DETECTION\x10\x03\x12\x13\n\x0fLABEL_DETECTION\x10\x04\x12\x12\n\x0eTEXT_DETECTION\x10\x05\x12\x1b\n\x17\x44OCUMENT_TEXT_DETECTION\x10\x0b\x12\x19\n\x15SAFE_SEARCH_DETECTION\x10\x06\x12\x14\n\x10IMAGE_PROPERTIES\x10\x07\x12\x0e\n\nCROP_HINTS\x10\t\x12\x11\n\rWEB_DETECTION\x10\n"7\n\x0bImageSource\x12\x15\n\rgcs_image_uri\x18\x01 \x01(\t\x12\x11\n\timage_uri\x18\x02 \x01(\t"T\n\x05Image\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\x0c\x12:\n\x06source\x18\x02 \x01(\x0b\x32*.google.cloud.vision.v1p1beta1.ImageSource"\x9b\x0e\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12\x45\n\x10\x66\x64_bounding_poly\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12I\n\tlandmarks\x18\x03 \x03(\x0b\x32\x36.google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark\x12\x12\n\nroll_angle\x18\x04 \x01(\x02\x12\x11\n\tpan_angle\x18\x05 \x01(\x02\x12\x12\n\ntilt_angle\x18\x06 \x01(\x02\x12\x1c\n\x14\x64\x65tection_confidence\x18\x07 \x01(\x02\x12\x1e\n\x16landmarking_confidence\x18\x08 \x01(\x02\x12\x41\n\x0ejoy_likelihood\x18\t \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x44\n\x11sorrow_likelihood\x18\n \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x43\n\x10\x61nger_likelihood\x18\x0b \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x46\n\x13surprise_likelihood\x18\x0c \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12K\n\x18under_exposed_likelihood\x18\r \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x45\n\x12\x62lurred_likelihood\x18\x0e \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x46\n\x13headwear_likelihood\x18\x0f \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x1a\xc7\x07\n\x08Landmark\x12I\n\x04type\x18\x03 \x01(\x0e\x32;.google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark.Type\x12\x39\n\x08position\x18\x04 \x01(\x0b\x32\'.google.cloud.vision.v1p1beta1.Position"\xb4\x06\n\x04Type\x12\x14\n\x10UNKNOWN_LANDMARK\x10\x00\x12\x0c\n\x08LEFT_EYE\x10\x01\x12\r\n\tRIGHT_EYE\x10\x02\x12\x18\n\x14LEFT_OF_LEFT_EYEBROW\x10\x03\x12\x19\n\x15RIGHT_OF_LEFT_EYEBROW\x10\x04\x12\x19\n\x15LEFT_OF_RIGHT_EYEBROW\x10\x05\x12\x1a\n\x16RIGHT_OF_RIGHT_EYEBROW\x10\x06\x12\x19\n\x15MIDPOINT_BETWEEN_EYES\x10\x07\x12\x0c\n\x08NOSE_TIP\x10\x08\x12\r\n\tUPPER_LIP\x10\t\x12\r\n\tLOWER_LIP\x10\n\x12\x0e\n\nMOUTH_LEFT\x10\x0b\x12\x0f\n\x0bMOUTH_RIGHT\x10\x0c\x12\x10\n\x0cMOUTH_CENTER\x10\r\x12\x15\n\x11NOSE_BOTTOM_RIGHT\x10\x0e\x12\x14\n\x10NOSE_BOTTOM_LEFT\x10\x0f\x12\x16\n\x12NOSE_BOTTOM_CENTER\x10\x10\x12\x19\n\x15LEFT_EYE_TOP_BOUNDARY\x10\x11\x12\x19\n\x15LEFT_EYE_RIGHT_CORNER\x10\x12\x12\x1c\n\x18LEFT_EYE_BOTTOM_BOUNDARY\x10\x13\x12\x18\n\x14LEFT_EYE_LEFT_CORNER\x10\x14\x12\x1a\n\x16RIGHT_EYE_TOP_BOUNDARY\x10\x15\x12\x1a\n\x16RIGHT_EYE_RIGHT_CORNER\x10\x16\x12\x1d\n\x19RIGHT_EYE_BOTTOM_BOUNDARY\x10\x17\x12\x19\n\x15RIGHT_EYE_LEFT_CORNER\x10\x18\x12\x1f\n\x1bLEFT_EYEBROW_UPPER_MIDPOINT\x10\x19\x12 \n\x1cRIGHT_EYEBROW_UPPER_MIDPOINT\x10\x1a\x12\x14\n\x10LEFT_EAR_TRAGION\x10\x1b\x12\x15\n\x11RIGHT_EAR_TRAGION\x10\x1c\x12\x12\n\x0eLEFT_EYE_PUPIL\x10\x1d\x12\x13\n\x0fRIGHT_EYE_PUPIL\x10\x1e\x12\x15\n\x11\x46OREHEAD_GLABELLA\x10\x1f\x12\x11\n\rCHIN_GNATHION\x10 \x12\x14\n\x10\x43HIN_LEFT_GONION\x10!\x12\x15\n\x11\x43HIN_RIGHT_GONION\x10""4\n\x0cLocationInfo\x12$\n\x07lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng"=\n\x08Property\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12\x14\n\x0cuint64_value\x18\x03 \x01(\x04"\xbc\x02\n\x10\x45ntityAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x0e\n\x06locale\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x12\n\nconfidence\x18\x05 \x01(\x02\x12\x12\n\ntopicality\x18\x06 \x01(\x02\x12\x42\n\rbounding_poly\x18\x07 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12>\n\tlocations\x18\x08 \x03(\x0b\x32+.google.cloud.vision.v1p1beta1.LocationInfo\x12;\n\nproperties\x18\t \x03(\x0b\x32\'.google.cloud.vision.v1p1beta1.Property"\xbc\x02\n\x14SafeSearchAnnotation\x12\x38\n\x05\x61\x64ult\x18\x01 \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x38\n\x05spoof\x18\x02 \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12:\n\x07medical\x18\x03 \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12;\n\x08violence\x18\x04 \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood\x12\x37\n\x04racy\x18\t \x01(\x0e\x32).google.cloud.vision.v1p1beta1.Likelihood"a\n\x0bLatLongRect\x12(\n\x0bmin_lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng\x12(\n\x0bmax_lat_lng\x18\x02 \x01(\x0b\x32\x13.google.type.LatLng"U\n\tColorInfo\x12!\n\x05\x63olor\x18\x01 \x01(\x0b\x32\x12.google.type.Color\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x16\n\x0epixel_fraction\x18\x03 \x01(\x02"T\n\x18\x44ominantColorsAnnotation\x12\x38\n\x06\x63olors\x18\x01 \x03(\x0b\x32(.google.cloud.vision.v1p1beta1.ColorInfo"c\n\x0fImageProperties\x12P\n\x0f\x64ominant_colors\x18\x01 \x01(\x0b\x32\x37.google.cloud.vision.v1p1beta1.DominantColorsAnnotation"\x7f\n\x08\x43ropHint\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x1b\n\x13importance_fraction\x18\x03 \x01(\x02"R\n\x13\x43ropHintsAnnotation\x12;\n\ncrop_hints\x18\x01 \x03(\x0b\x32\'.google.cloud.vision.v1p1beta1.CropHint"(\n\x0f\x43ropHintsParams\x12\x15\n\raspect_ratios\x18\x01 \x03(\x02"1\n\x12WebDetectionParams\x12\x1b\n\x13include_geo_results\x18\x02 \x01(\x08"\x85\x02\n\x0cImageContext\x12\x41\n\rlat_long_rect\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p1beta1.LatLongRect\x12\x16\n\x0elanguage_hints\x18\x02 \x03(\t\x12I\n\x11\x63rop_hints_params\x18\x04 \x01(\x0b\x32..google.cloud.vision.v1p1beta1.CropHintsParams\x12O\n\x14web_detection_params\x18\x06 \x01(\x0b\x32\x31.google.cloud.vision.v1p1beta1.WebDetectionParams"\xc9\x01\n\x14\x41nnotateImageRequest\x12\x33\n\x05image\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1p1beta1.Image\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p1beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.ImageContext"\xc2\x06\n\x15\x41nnotateImageResponse\x12G\n\x10\x66\x61\x63\x65_annotations\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p1beta1.FaceAnnotation\x12M\n\x14landmark_annotations\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p1beta1.EntityAnnotation\x12I\n\x10logo_annotations\x18\x03 \x03(\x0b\x32/.google.cloud.vision.v1p1beta1.EntityAnnotation\x12J\n\x11label_annotations\x18\x04 \x03(\x0b\x32/.google.cloud.vision.v1p1beta1.EntityAnnotation\x12I\n\x10text_annotations\x18\x05 \x03(\x0b\x32/.google.cloud.vision.v1p1beta1.EntityAnnotation\x12K\n\x14\x66ull_text_annotation\x18\x0c \x01(\x0b\x32-.google.cloud.vision.v1p1beta1.TextAnnotation\x12S\n\x16safe_search_annotation\x18\x06 \x01(\x0b\x32\x33.google.cloud.vision.v1p1beta1.SafeSearchAnnotation\x12S\n\x1bimage_properties_annotation\x18\x08 \x01(\x0b\x32..google.cloud.vision.v1p1beta1.ImageProperties\x12Q\n\x15\x63rop_hints_annotation\x18\x0b \x01(\x0b\x32\x32.google.cloud.vision.v1p1beta1.CropHintsAnnotation\x12\x42\n\rweb_detection\x18\r \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.WebDetection\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status"c\n\x1a\x42\x61tchAnnotateImagesRequest\x12\x45\n\x08requests\x18\x01 \x03(\x0b\x32\x33.google.cloud.vision.v1p1beta1.AnnotateImageRequest"f\n\x1b\x42\x61tchAnnotateImagesResponse\x12G\n\tresponses\x18\x01 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.AnnotateImageResponse*e\n\nLikelihood\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xc6\x01\n\x0eImageAnnotator\x12\xb3\x01\n\x13\x42\x61tchAnnotateImages\x12\x39.google.cloud.vision.v1p1beta1.BatchAnnotateImagesRequest\x1a:.google.cloud.vision.v1p1beta1.BatchAnnotateImagesResponse"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p1beta1/images:annotate:\x01*B\x82\x01\n!com.google.cloud.vision.v1p1beta1B\x13ImageAnnotatorProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_text__annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_web__detection__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_type_dot_color__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.vision.v1p1beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=5631,
+    serialized_end=5732,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+UNKNOWN = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_FEATURE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p1beta1.Feature.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LANDMARK_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGO_DETECTION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOCUMENT_TEXT_DETECTION",
+            index=6,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFE_SEARCH_DETECTION",
+            index=7,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_PROPERTIES",
+            index=8,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CROP_HINTS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEB_DETECTION",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=474,
+    serialized_end=720,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE_TYPE)
+
+_FACEANNOTATION_LANDMARK_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN_LANDMARK",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_LEFT_EYEBROW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_LEFT_EYEBROW",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_RIGHT_EYEBROW",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_RIGHT_EYEBROW",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDPOINT_BETWEEN_EYES",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_TIP", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_LIP", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOWER_LIP", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_LEFT", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_RIGHT", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_CENTER", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_RIGHT",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_LEFT",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_CENTER",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_TOP_BOUNDARY",
+            index=17,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_RIGHT_CORNER",
+            index=18,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_BOTTOM_BOUNDARY",
+            index=19,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_LEFT_CORNER",
+            index=20,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_TOP_BOUNDARY",
+            index=21,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_RIGHT_CORNER",
+            index=22,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_BOTTOM_BOUNDARY",
+            index=23,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_LEFT_CORNER",
+            index=24,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYEBROW_UPPER_MIDPOINT",
+            index=25,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYEBROW_UPPER_MIDPOINT",
+            index=26,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EAR_TRAGION",
+            index=27,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EAR_TRAGION",
+            index=28,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_PUPIL",
+            index=29,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_PUPIL",
+            index=30,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREHEAD_GLABELLA",
+            index=31,
+            number=31,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_GNATHION",
+            index=32,
+            number=32,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_LEFT_GONION",
+            index=33,
+            number=33,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_RIGHT_GONION",
+            index=34,
+            number=34,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1865,
+    serialized_end=2685,
+)
+_sym_db.RegisterEnumDescriptor(_FACEANNOTATION_LANDMARK_TYPE)
+
+
+_FEATURE = _descriptor.Descriptor(
+    name="Feature",
+    full_name="google.cloud.vision.v1p1beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p1beta1.Feature.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_results",
+            full_name="google.cloud.vision.v1p1beta1.Feature.max_results",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.vision.v1p1beta1.Feature.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FEATURE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=367,
+    serialized_end=720,
+)
+
+
+_IMAGESOURCE = _descriptor.Descriptor(
+    name="ImageSource",
+    full_name="google.cloud.vision.v1p1beta1.ImageSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_image_uri",
+            full_name="google.cloud.vision.v1p1beta1.ImageSource.gcs_image_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.vision.v1p1beta1.ImageSource.image_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=722,
+    serialized_end=777,
+)
+
+
+_IMAGE = _descriptor.Descriptor(
+    name="Image",
+    full_name="google.cloud.vision.v1p1beta1.Image",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1p1beta1.Image.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1p1beta1.Image.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=779,
+    serialized_end=863,
+)
+
+
+_FACEANNOTATION_LANDMARK = _descriptor.Descriptor(
+    name="Landmark",
+    full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark.type",
+            index=0,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="position",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark.position",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FACEANNOTATION_LANDMARK_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1718,
+    serialized_end=2685,
+)
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.vision.v1p1beta1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fd_bounding_poly",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.fd_bounding_poly",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarks",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.landmarks",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roll_angle",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.roll_angle",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pan_angle",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.pan_angle",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tilt_angle",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.tilt_angle",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detection_confidence",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.detection_confidence",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarking_confidence",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.landmarking_confidence",
+            index=7,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="joy_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.joy_likelihood",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sorrow_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.sorrow_likelihood",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="anger_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.anger_likelihood",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surprise_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.surprise_likelihood",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="under_exposed_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.under_exposed_likelihood",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blurred_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.blurred_likelihood",
+            index=13,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headwear_likelihood",
+            full_name="google.cloud.vision.v1p1beta1.FaceAnnotation.headwear_likelihood",
+            index=14,
+            number=15,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FACEANNOTATION_LANDMARK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=866,
+    serialized_end=2685,
+)
+
+
+_LOCATIONINFO = _descriptor.Descriptor(
+    name="LocationInfo",
+    full_name="google.cloud.vision.v1p1beta1.LocationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.vision.v1p1beta1.LocationInfo.lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2687,
+    serialized_end=2739,
+)
+
+
+_PROPERTY = _descriptor.Descriptor(
+    name="Property",
+    full_name="google.cloud.vision.v1p1beta1.Property",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p1beta1.Property.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1p1beta1.Property.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uint64_value",
+            full_name="google.cloud.vision.v1p1beta1.Property.uint64_value",
+            index=2,
+            number=3,
+            type=4,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2741,
+    serialized_end=2802,
+)
+
+
+_ENTITYANNOTATION = _descriptor.Descriptor(
+    name="EntityAnnotation",
+    full_name="google.cloud.vision.v1p1beta1.EntityAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locale",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.locale",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topicality",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.topicality",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.bounding_poly",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.locations",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.vision.v1p1beta1.EntityAnnotation.properties",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2805,
+    serialized_end=3121,
+)
+
+
+_SAFESEARCHANNOTATION = _descriptor.Descriptor(
+    name="SafeSearchAnnotation",
+    full_name="google.cloud.vision.v1p1beta1.SafeSearchAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="adult",
+            full_name="google.cloud.vision.v1p1beta1.SafeSearchAnnotation.adult",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spoof",
+            full_name="google.cloud.vision.v1p1beta1.SafeSearchAnnotation.spoof",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="medical",
+            full_name="google.cloud.vision.v1p1beta1.SafeSearchAnnotation.medical",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violence",
+            full_name="google.cloud.vision.v1p1beta1.SafeSearchAnnotation.violence",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="racy",
+            full_name="google.cloud.vision.v1p1beta1.SafeSearchAnnotation.racy",
+            index=4,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3124,
+    serialized_end=3440,
+)
+
+
+_LATLONGRECT = _descriptor.Descriptor(
+    name="LatLongRect",
+    full_name="google.cloud.vision.v1p1beta1.LatLongRect",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_lat_lng",
+            full_name="google.cloud.vision.v1p1beta1.LatLongRect.min_lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_lat_lng",
+            full_name="google.cloud.vision.v1p1beta1.LatLongRect.max_lat_lng",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3442,
+    serialized_end=3539,
+)
+
+
+_COLORINFO = _descriptor.Descriptor(
+    name="ColorInfo",
+    full_name="google.cloud.vision.v1p1beta1.ColorInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="color",
+            full_name="google.cloud.vision.v1p1beta1.ColorInfo.color",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p1beta1.ColorInfo.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pixel_fraction",
+            full_name="google.cloud.vision.v1p1beta1.ColorInfo.pixel_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3541,
+    serialized_end=3626,
+)
+
+
+_DOMINANTCOLORSANNOTATION = _descriptor.Descriptor(
+    name="DominantColorsAnnotation",
+    full_name="google.cloud.vision.v1p1beta1.DominantColorsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="colors",
+            full_name="google.cloud.vision.v1p1beta1.DominantColorsAnnotation.colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3628,
+    serialized_end=3712,
+)
+
+
+_IMAGEPROPERTIES = _descriptor.Descriptor(
+    name="ImageProperties",
+    full_name="google.cloud.vision.v1p1beta1.ImageProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dominant_colors",
+            full_name="google.cloud.vision.v1p1beta1.ImageProperties.dominant_colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3714,
+    serialized_end=3813,
+)
+
+
+_CROPHINT = _descriptor.Descriptor(
+    name="CropHint",
+    full_name="google.cloud.vision.v1p1beta1.CropHint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p1beta1.CropHint.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.CropHint.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="importance_fraction",
+            full_name="google.cloud.vision.v1p1beta1.CropHint.importance_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3815,
+    serialized_end=3942,
+)
+
+
+_CROPHINTSANNOTATION = _descriptor.Descriptor(
+    name="CropHintsAnnotation",
+    full_name="google.cloud.vision.v1p1beta1.CropHintsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crop_hints",
+            full_name="google.cloud.vision.v1p1beta1.CropHintsAnnotation.crop_hints",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3944,
+    serialized_end=4026,
+)
+
+
+_CROPHINTSPARAMS = _descriptor.Descriptor(
+    name="CropHintsParams",
+    full_name="google.cloud.vision.v1p1beta1.CropHintsParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aspect_ratios",
+            full_name="google.cloud.vision.v1p1beta1.CropHintsParams.aspect_ratios",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4028,
+    serialized_end=4068,
+)
+
+
+_WEBDETECTIONPARAMS = _descriptor.Descriptor(
+    name="WebDetectionParams",
+    full_name="google.cloud.vision.v1p1beta1.WebDetectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="include_geo_results",
+            full_name="google.cloud.vision.v1p1beta1.WebDetectionParams.include_geo_results",
+            index=0,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4070,
+    serialized_end=4119,
+)
+
+
+_IMAGECONTEXT = _descriptor.Descriptor(
+    name="ImageContext",
+    full_name="google.cloud.vision.v1p1beta1.ImageContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_long_rect",
+            full_name="google.cloud.vision.v1p1beta1.ImageContext.lat_long_rect",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.vision.v1p1beta1.ImageContext.language_hints",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_params",
+            full_name="google.cloud.vision.v1p1beta1.ImageContext.crop_hints_params",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection_params",
+            full_name="google.cloud.vision.v1p1beta1.ImageContext.web_detection_params",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4122,
+    serialized_end=4383,
+)
+
+
+_ANNOTATEIMAGEREQUEST = _descriptor.Descriptor(
+    name="AnnotateImageRequest",
+    full_name="google.cloud.vision.v1p1beta1.AnnotateImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageRequest.image",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4386,
+    serialized_end=4587,
+)
+
+
+_ANNOTATEIMAGERESPONSE = _descriptor.Descriptor(
+    name="AnnotateImageResponse",
+    full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.face_annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmark_annotations",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.landmark_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logo_annotations",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.logo_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.text_annotations",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_text_annotation",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.full_text_annotation",
+            index=5,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_annotation",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.safe_search_annotation",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_properties_annotation",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.image_properties_annotation",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_annotation",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.crop_hints_annotation",
+            index=8,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.web_detection",
+            index=9,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.vision.v1p1beta1.AnnotateImageResponse.error",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4590,
+    serialized_end=5424,
+)
+
+
+_BATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1p1beta1.BatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p1beta1.BatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5426,
+    serialized_end=5525,
+)
+
+
+_BATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1p1beta1.BatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p1beta1.BatchAnnotateImagesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5527,
+    serialized_end=5629,
+)
+
+_FEATURE.fields_by_name["type"].enum_type = _FEATURE_TYPE
+_FEATURE_TYPE.containing_type = _FEATURE
+_IMAGE.fields_by_name["source"].message_type = _IMAGESOURCE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "type"
+].enum_type = _FACEANNOTATION_LANDMARK_TYPE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "position"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._POSITION
+)
+_FACEANNOTATION_LANDMARK.containing_type = _FACEANNOTATION
+_FACEANNOTATION_LANDMARK_TYPE.containing_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name[
+    "fd_bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name["landmarks"].message_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name["joy_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["sorrow_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["anger_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["surprise_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["under_exposed_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["blurred_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["headwear_likelihood"].enum_type = _LIKELIHOOD
+_LOCATIONINFO.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_ENTITYANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_ENTITYANNOTATION.fields_by_name["locations"].message_type = _LOCATIONINFO
+_ENTITYANNOTATION.fields_by_name["properties"].message_type = _PROPERTY
+_SAFESEARCHANNOTATION.fields_by_name["adult"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["spoof"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["medical"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["violence"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["racy"].enum_type = _LIKELIHOOD
+_LATLONGRECT.fields_by_name[
+    "min_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LATLONGRECT.fields_by_name[
+    "max_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_COLORINFO.fields_by_name["color"].message_type = google_dot_type_dot_color__pb2._COLOR
+_DOMINANTCOLORSANNOTATION.fields_by_name["colors"].message_type = _COLORINFO
+_IMAGEPROPERTIES.fields_by_name[
+    "dominant_colors"
+].message_type = _DOMINANTCOLORSANNOTATION
+_CROPHINT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CROPHINTSANNOTATION.fields_by_name["crop_hints"].message_type = _CROPHINT
+_IMAGECONTEXT.fields_by_name["lat_long_rect"].message_type = _LATLONGRECT
+_IMAGECONTEXT.fields_by_name["crop_hints_params"].message_type = _CROPHINTSPARAMS
+_IMAGECONTEXT.fields_by_name["web_detection_params"].message_type = _WEBDETECTIONPARAMS
+_ANNOTATEIMAGEREQUEST.fields_by_name["image"].message_type = _IMAGE
+_ANNOTATEIMAGEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEIMAGEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ANNOTATEIMAGERESPONSE.fields_by_name["face_annotations"].message_type = _FACEANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "landmark_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "logo_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "label_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "text_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "full_text_annotation"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_text__annotation__pb2._TEXTANNOTATION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "safe_search_annotation"
+].message_type = _SAFESEARCHANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "image_properties_annotation"
+].message_type = _IMAGEPROPERTIES
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "crop_hints_annotation"
+].message_type = _CROPHINTSANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "web_detection"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_web__detection__pb2._WEBDETECTION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_BATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_BATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEIMAGERESPONSE
+DESCRIPTOR.message_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.message_types_by_name["ImageSource"] = _IMAGESOURCE
+DESCRIPTOR.message_types_by_name["Image"] = _IMAGE
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["LocationInfo"] = _LOCATIONINFO
+DESCRIPTOR.message_types_by_name["Property"] = _PROPERTY
+DESCRIPTOR.message_types_by_name["EntityAnnotation"] = _ENTITYANNOTATION
+DESCRIPTOR.message_types_by_name["SafeSearchAnnotation"] = _SAFESEARCHANNOTATION
+DESCRIPTOR.message_types_by_name["LatLongRect"] = _LATLONGRECT
+DESCRIPTOR.message_types_by_name["ColorInfo"] = _COLORINFO
+DESCRIPTOR.message_types_by_name["DominantColorsAnnotation"] = _DOMINANTCOLORSANNOTATION
+DESCRIPTOR.message_types_by_name["ImageProperties"] = _IMAGEPROPERTIES
+DESCRIPTOR.message_types_by_name["CropHint"] = _CROPHINT
+DESCRIPTOR.message_types_by_name["CropHintsAnnotation"] = _CROPHINTSANNOTATION
+DESCRIPTOR.message_types_by_name["CropHintsParams"] = _CROPHINTSPARAMS
+DESCRIPTOR.message_types_by_name["WebDetectionParams"] = _WEBDETECTIONPARAMS
+DESCRIPTOR.message_types_by_name["ImageContext"] = _IMAGECONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageRequest"] = _ANNOTATEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["AnnotateImageResponse"] = _ANNOTATEIMAGERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesRequest"
+] = _BATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesResponse"
+] = _BATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Feature = _reflection.GeneratedProtocolMessageType(
+    "Feature",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEATURE,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Users describe the type of Google Cloud Vision API tasks to perform over
+  images by using *Feature*\ s. Each Feature indicates a type of image
+  detection task to perform. Features encode the Cloud Vision API vertical
+  to operate on and the number of top-scoring results to return.
+  
+  
+  Attributes:
+      type:
+          The feature type.
+      max_results:
+          Maximum number of results of this type.
+      model:
+          Model to use for the feature. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Feature)
+    ),
+)
+_sym_db.RegisterMessage(Feature)
+
+ImageSource = _reflection.GeneratedProtocolMessageType(
+    "ImageSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGESOURCE,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""External image source (Google Cloud Storage image location).
+  
+  
+  Attributes:
+      gcs_image_uri:
+          NOTE: For new code ``image_uri`` below is preferred. Google
+          Cloud Storage image URI, which must be in the following form:
+          ``gs://bucket_name/object_name`` (for details, see `Google
+          Cloud Storage Request URIs
+          <https://cloud.google.com/storage/docs/reference-uris>`__).
+          NOTE: Cloud Storage object versioning is not supported.
+      image_uri:
+          Image URI which supports: 1) Google Cloud Storage image URI,
+          which must be in the following form:
+          ``gs://bucket_name/object_name`` (for details, see `Google
+          Cloud Storage Request URIs
+          <https://cloud.google.com/storage/docs/reference-uris>`__).
+          NOTE: Cloud Storage object versioning is not supported. 2)
+          Publicly accessible image HTTP/HTTPS URL. This is preferred
+          over the legacy ``gcs_image_uri`` above. When both
+          ``gcs_image_uri`` and ``image_uri`` are specified,
+          ``image_uri`` takes precedence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.ImageSource)
+    ),
+)
+_sym_db.RegisterMessage(ImageSource)
+
+Image = _reflection.GeneratedProtocolMessageType(
+    "Image",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGE,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Client image to perform Google Cloud Vision API tasks over.
+  
+  
+  Attributes:
+      content:
+          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.
+      source:
+          Google Cloud Storage image location. If both ``content`` and
+          ``source`` are provided for an image, ``content`` takes
+          precedence and is used to perform the image annotation
+          request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Image)
+    ),
+)
+_sym_db.RegisterMessage(Image)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        Landmark=_reflection.GeneratedProtocolMessageType(
+            "Landmark",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FACEANNOTATION_LANDMARK,
+                __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+                __doc__="""A face-specific landmark (for example, a face feature).
+    
+    
+    Attributes:
+        type:
+            Face landmark type.
+        position:
+            Face landmark position.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.FaceAnnotation.Landmark)
+            ),
+        ),
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""A face annotation object contains the results of face detection.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the face. The coordinates of the
+          bounding box are in the original image's scale, as returned in
+          ``ImageParams``. The bounding box is computed to "frame" the
+          face in accordance with human expectations. It is based on the
+          landmarker results. Note that one or more x and/or y
+          coordinates may not be generated in the ``BoundingPoly`` (the
+          polygon will be unbounded) if only a partial face appears in
+          the image to be annotated.
+      fd_bounding_poly:
+          The ``fd_bounding_poly`` bounding polygon is tighter than the
+          ``boundingPoly``, and encloses only the skin part of the face.
+          Typically, it is used to eliminate the face from any image
+          analysis that detects the "amount of skin" visible in an
+          image. It is not based on the landmarker results, only on the
+          initial face detection, hence the fd (face detection) prefix.
+      landmarks:
+          Detected face landmarks.
+      roll_angle:
+          Roll angle, which indicates the amount of clockwise/anti-
+          clockwise rotation of the face relative to the image vertical
+          about the axis perpendicular to the face. Range [-180,180].
+      pan_angle:
+          Yaw angle, which indicates the leftward/rightward angle that
+          the face is pointing relative to the vertical plane
+          perpendicular to the image. Range [-180,180].
+      tilt_angle:
+          Pitch angle, which indicates the upwards/downwards angle that
+          the face is pointing relative to the image's horizontal plane.
+          Range [-180,180].
+      detection_confidence:
+          Detection confidence. Range [0, 1].
+      landmarking_confidence:
+          Face landmarking confidence. Range [0, 1].
+      joy_likelihood:
+          Joy likelihood.
+      sorrow_likelihood:
+          Sorrow likelihood.
+      anger_likelihood:
+          Anger likelihood.
+      surprise_likelihood:
+          Surprise likelihood.
+      under_exposed_likelihood:
+          Under-exposed likelihood.
+      blurred_likelihood:
+          Blurred likelihood.
+      headwear_likelihood:
+          Headwear likelihood.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+_sym_db.RegisterMessage(FaceAnnotation.Landmark)
+
+LocationInfo = _reflection.GeneratedProtocolMessageType(
+    "LocationInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONINFO,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Detected entity location information.
+  
+  
+  Attributes:
+      lat_lng:
+          lat/long location coordinates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.LocationInfo)
+    ),
+)
+_sym_db.RegisterMessage(LocationInfo)
+
+Property = _reflection.GeneratedProtocolMessageType(
+    "Property",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTY,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""A ``Property`` consists of a user-supplied name/value pair.
+  
+  
+  Attributes:
+      name:
+          Name of the property.
+      value:
+          Value of the property.
+      uint64_value:
+          Value of numeric properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Property)
+    ),
+)
+_sym_db.RegisterMessage(Property)
+
+EntityAnnotation = _reflection.GeneratedProtocolMessageType(
+    "EntityAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYANNOTATION,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Set of detected entity features.
+  
+  
+  Attributes:
+      mid:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      locale:
+          The language code for the locale in which the entity textual
+          ``description`` is expressed.
+      description:
+          Entity textual description, expressed in its ``locale``
+          language.
+      score:
+          Overall score of the result. Range [0, 1].
+      confidence:
+          The accuracy of the entity detection in an image. For example,
+          for an image in which the "Eiffel Tower" entity is detected,
+          this field represents the confidence that there is a tower in
+          the query image. Range [0, 1].
+      topicality:
+          The relevancy of the ICA (Image Content Annotation) label to
+          the image. For example, the relevancy of "tower" is likely
+          higher to an image containing the detected "Eiffel Tower" than
+          to an image containing a detected distant towering building,
+          even though the confidence that there is a tower in each image
+          may be the same. Range [0, 1].
+      bounding_poly:
+          Image region to which this entity belongs. Not produced for
+          ``LABEL_DETECTION`` features.
+      locations:
+          The location information for the detected entity. Multiple
+          ``LocationInfo`` elements can be present because one location
+          may indicate the location of the scene in the image, and
+          another location may indicate the location of the place where
+          the image was taken. Location information is usually present
+          for landmarks.
+      properties:
+          Some entities may have optional user-supplied ``Property``
+          (name/value) fields, such a score or string that qualifies the
+          entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.EntityAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(EntityAnnotation)
+
+SafeSearchAnnotation = _reflection.GeneratedProtocolMessageType(
+    "SafeSearchAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAFESEARCHANNOTATION,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Set of features pertaining to the image, computed by computer vision
+  methods over safe-search verticals (for example, adult, spoof, medical,
+  violence).
+  
+  
+  Attributes:
+      adult:
+          Represents the adult content likelihood for the image. Adult
+          content may contain elements such as nudity, pornographic
+          images or cartoons, or sexual activities.
+      spoof:
+          Spoof likelihood. The likelihood that an modification was made
+          to the image's canonical version to make it appear funny or
+          offensive.
+      medical:
+          Likelihood that this is a medical image.
+      violence:
+          Likelihood that this image contains violent content.
+      racy:
+          Likelihood that the request image contains racy content. Racy
+          content may include (but is not limited to) skimpy or sheer
+          clothing, strategically covered nudity, lewd or provocative
+          poses, or close-ups of sensitive body areas.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.SafeSearchAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(SafeSearchAnnotation)
+
+LatLongRect = _reflection.GeneratedProtocolMessageType(
+    "LatLongRect",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LATLONGRECT,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Rectangle determined by min and max ``LatLng`` pairs.
+  
+  
+  Attributes:
+      min_lat_lng:
+          Min lat/long pair.
+      max_lat_lng:
+          Max lat/long pair.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.LatLongRect)
+    ),
+)
+_sym_db.RegisterMessage(LatLongRect)
+
+ColorInfo = _reflection.GeneratedProtocolMessageType(
+    "ColorInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLORINFO,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Color information consists of RGB channels, score, and the fraction of
+  the image that the color occupies in the image.
+  
+  
+  Attributes:
+      color:
+          RGB components of the color.
+      score:
+          Image-specific score for this color. Value in range [0, 1].
+      pixel_fraction:
+          The fraction of pixels the color occupies in the image. Value
+          in range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.ColorInfo)
+    ),
+)
+_sym_db.RegisterMessage(ColorInfo)
+
+DominantColorsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "DominantColorsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOMINANTCOLORSANNOTATION,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Set of dominant colors and their corresponding scores.
+  
+  
+  Attributes:
+      colors:
+          RGB color values with their score and pixel fraction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.DominantColorsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(DominantColorsAnnotation)
+
+ImageProperties = _reflection.GeneratedProtocolMessageType(
+    "ImageProperties",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPROPERTIES,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Stores image properties, such as dominant colors.
+  
+  
+  Attributes:
+      dominant_colors:
+          If present, dominant colors completed successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.ImageProperties)
+    ),
+)
+_sym_db.RegisterMessage(ImageProperties)
+
+CropHint = _reflection.GeneratedProtocolMessageType(
+    "CropHint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINT,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Single crop hint that is used to generate a new crop when serving an
+  image.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon for the crop region. The coordinates of
+          the bounding box are in the original image's scale, as
+          returned in ``ImageParams``.
+      confidence:
+          Confidence of this being a salient region. Range [0, 1].
+      importance_fraction:
+          Fraction of importance of this salient region with respect to
+          the original image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.CropHint)
+    ),
+)
+_sym_db.RegisterMessage(CropHint)
+
+CropHintsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "CropHintsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSANNOTATION,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Set of crop hints that are used to generate new crops when serving
+  images.
+  
+  
+  Attributes:
+      crop_hints:
+          Crop hint results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.CropHintsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsAnnotation)
+
+CropHintsParams = _reflection.GeneratedProtocolMessageType(
+    "CropHintsParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSPARAMS,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for crop hints annotation request.
+  
+  
+  Attributes:
+      aspect_ratios:
+          Aspect ratios in floats, representing the ratio of the width
+          to the height of the image. For example, if the desired aspect
+          ratio is 4/3, the corresponding float value should be 1.33333.
+          If not specified, the best possible crop is returned. The
+          number of provided aspect ratios is limited to a maximum of
+          16; any aspect ratios provided after the 16th are ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.CropHintsParams)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsParams)
+
+WebDetectionParams = _reflection.GeneratedProtocolMessageType(
+    "WebDetectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WEBDETECTIONPARAMS,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for web detection request.
+  
+  
+  Attributes:
+      include_geo_results:
+          Whether to include results derived from the geo information in
+          the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.WebDetectionParams)
+    ),
+)
+_sym_db.RegisterMessage(WebDetectionParams)
+
+ImageContext = _reflection.GeneratedProtocolMessageType(
+    "ImageContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECONTEXT,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Image context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      lat_long_rect:
+          lat/long rectangle that specifies the location of the image.
+      language_hints:
+          List of languages to use for TEXT\_DETECTION. 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). Text
+          detection returns an error if one or more of the specified
+          languages is not one of the `supported languages
+          </vision/docs/languages>`__.
+      crop_hints_params:
+          Parameters for crop hints annotation request.
+      web_detection_params:
+          Parameters for web detection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.ImageContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageContext)
+
+AnnotateImageRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Request for performing Google Cloud Vision API tasks over a
+  user-provided image, with user-requested features.
+  
+  
+  Attributes:
+      image:
+          The image to be processed.
+      features:
+          Requested features.
+      image_context:
+          Additional context that may accompany the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.AnnotateImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageRequest)
+
+AnnotateImageResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGERESPONSE,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an image annotation request.
+  
+  
+  Attributes:
+      face_annotations:
+          If present, face detection has completed successfully.
+      landmark_annotations:
+          If present, landmark detection has completed successfully.
+      logo_annotations:
+          If present, logo detection has completed successfully.
+      label_annotations:
+          If present, label detection has completed successfully.
+      text_annotations:
+          If present, text (OCR) detection has completed successfully.
+      full_text_annotation:
+          If present, text (OCR) detection or document (OCR) text
+          detection has completed successfully. This annotation provides
+          the structural hierarchy for the OCR detected text.
+      safe_search_annotation:
+          If present, safe-search annotation has completed successfully.
+      image_properties_annotation:
+          If present, image properties were extracted successfully.
+      crop_hints_annotation:
+          If present, crop hints have completed successfully.
+      web_detection:
+          If present, web detection has completed successfully.
+      error:
+          If set, represents the error message for the operation. Note
+          that filled-in image annotations are guaranteed to be correct,
+          even when ``error`` is set.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.AnnotateImageResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageResponse)
+
+BatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple image annotation requests are batched into a single service
+  call.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.BatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesRequest)
+
+BatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p1beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a batch image annotation request.
+  
+  
+  Attributes:
+      responses:
+          Individual responses to image annotation requests within the
+          batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.BatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesResponse)
+
+
+DESCRIPTOR._options = None
+
+_IMAGEANNOTATOR = _descriptor.ServiceDescriptor(
+    name="ImageAnnotator",
+    full_name="google.cloud.vision.v1p1beta1.ImageAnnotator",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=5735,
+    serialized_end=5933,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateImages",
+            full_name="google.cloud.vision.v1p1beta1.ImageAnnotator.BatchAnnotateImages",
+            index=0,
+            containing_service=None,
+            input_type=_BATCHANNOTATEIMAGESREQUEST,
+            output_type=_BATCHANNOTATEIMAGESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p1beta1/images:annotate:\001*'
+            ),
+        )
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_IMAGEANNOTATOR)
+
+DESCRIPTOR.services_by_name["ImageAnnotator"] = _IMAGEANNOTATOR
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/image_annotator_pb2_grpc.py b/vision/google/cloud/vision_v1p1beta1/proto/image_annotator_pb2_grpc.py
new file mode 100644
index 000000000000..f945f4db9c14
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/image_annotator_pb2_grpc.py
@@ -0,0 +1,53 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1p1beta1.proto import (
+    image_annotator_pb2 as google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_image__annotator__pb2,
+)
+
+
+class ImageAnnotatorStub(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.BatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1p1beta1.ImageAnnotator/BatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.FromString,
+        )
+
+
+class ImageAnnotatorServicer(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def BatchAnnotateImages(self, request, context):
+        """Run image detection and annotation for a batch of images.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ImageAnnotatorServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "BatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.SerializeToString,
+        )
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1p1beta1.ImageAnnotator", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/product_search.proto b/vision/google/cloud/vision_v1p1beta1/proto/product_search.proto
new file mode 100644
index 000000000000..85e4e0784e1c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/product_search.proto
@@ -0,0 +1,161 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/cloud/vision/v1p3beta1/product_search_service.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+
+// Parameters for a product search request.
+message ProductSearchParams {
+  // The resource name of the catalog to search.
+  //
+  // Format is: `productSearch/catalogs/CATALOG_NAME`.
+  string catalog_name = 1;
+
+  // The category to search in.
+  // Optional. It is inferred by the system if it is not specified.
+  // [Deprecated] Use `product_category`.
+  ProductSearchCategory category = 2;
+
+  // The product category to search in.
+  // Optional. It is inferred by the system if it is not specified.
+  // Supported values are `bag`, `shoe`, `sunglasses`, `dress`, `outerwear`,
+  // `skirt`, `top`, `shorts`, and `pants`.
+  string product_category = 5;
+
+  // The bounding polygon around the area of interest in the image.
+  // Optional. If it is not specified, system discretion will be applied.
+  // [Deprecated] Use `bounding_poly`.
+  NormalizedBoundingPoly normalized_bounding_poly = 3;
+
+  // The bounding polygon around the area of interest in the image.
+  // Optional. If it is not specified, system discretion will be applied.
+  BoundingPoly bounding_poly = 9;
+
+  // Specifies the verbosity of the  product search results.
+  // Optional. Defaults to `BASIC`.
+  ProductSearchResultsView view = 4;
+
+  // The resource name of a [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] to be searched for similar images.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  string product_set = 6;
+
+  // The list of product categories to search in. Currently, we only consider
+  // the first category, and either "homegoods" or "apparel" should be
+  // specified.
+  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.
+  //
+  // For example, "(color = red OR color = blue) AND brand = Google" is
+  // acceptable, but not "(color = red OR brand = Google)" or "color: red".
+  string filter = 8;
+}
+
+// Results for a product search request.
+message ProductSearchResults {
+  // Information about a product.
+  message ProductInfo {
+    // Product ID.
+    string product_id = 1;
+
+    // The URI of the image which matched the query image.
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    string image_uri = 2;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    float score = 3;
+  }
+
+  // Information about a product.
+  message Result {
+    // The Product.
+    Product product = 1;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    float score = 2;
+
+    // The resource name of the image from the product that is the closest match
+    // to the query.
+    string image = 3;
+  }
+
+  // Product category.
+  // [Deprecated] Use `product_category`.
+  ProductSearchCategory category = 1;
+
+  // Product category.
+  // Supported values are `bag` and `shoe`.
+  // [Deprecated] `product_category` is provided in each Product.
+  string product_category = 4;
+
+  // Timestamp of the index which provided these results. Changes made after
+  // this time are not reflected in the current results.
+  google.protobuf.Timestamp index_time = 2;
+
+  // List of detected products.
+  repeated ProductInfo products = 3;
+
+  // List of results, one for each product match.
+  repeated Result results = 5;
+}
+
+// Supported product search categories.
+enum ProductSearchCategory {
+  // Default value used when a category is not specified.
+  PRODUCT_SEARCH_CATEGORY_UNSPECIFIED = 0;
+
+  // Shoes category.
+  SHOES = 1;
+
+  // Bags category.
+  BAGS = 2;
+}
+
+// Specifies the fields to include in product search results.
+enum ProductSearchResultsView {
+  // Product search results contain only `product_category` and `product_id`.
+  // Default value.
+  BASIC = 0;
+
+  // Product search results contain `product_category`, `product_id`,
+  // `image_uri`, and `score`.
+  FULL = 1;
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/product_search_service.proto b/vision/google/cloud/vision_v1p1beta1/proto/product_search_service.proto
new file mode 100644
index 000000000000..90388e36e228
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/product_search_service.proto
@@ -0,0 +1,825 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/longrunning/operations.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;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchServiceProto";
+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
+// `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
+//   `projects/*/locations/*/products/*`
+//
+// - 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 {
+  // Creates and returns a new ProductSet resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+  //   4096 characters.
+  rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+      body: "product_set"
+    };
+  }
+
+  // Lists ProductSets in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+  //   than 1.
+  rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+    };
+  }
+
+  // Gets information associated with a ProductSet.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  rpc GetProductSet(GetProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Makes changes to a ProductSet resource.
+  // Only display_name can be updated currently.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+  //   missing from the request or longer than 4096 characters.
+  rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      patch: "/v1p3beta1/{product_set.name=projects/*/locations/*/productSets/*}"
+      body: "product_set"
+    };
+  }
+
+  // Permanently deletes a ProductSet. All Products and ReferenceImages in the
+  // ProductSet will be 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: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Creates and returns a new product resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+  rpc CreateProduct(CreateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/products"
+      body: "product"
+    };
+  }
+
+  // Lists products in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*}/products"
+    };
+  }
+
+  // Gets information associated with a Product.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  rpc GetProduct(GetProductRequest) returns (Product) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Makes changes to a Product resource.
+  // Only display_name, description and labels can be updated right now.
+  //
+  // If labels are updated, the change will not be reflected in queries until
+  // the next index time.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+  //   missing from the request or longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if description is present in update_mask but is
+  //   longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+  rpc UpdateProduct(UpdateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      patch: "/v1p3beta1/{product.name=projects/*/locations/*/products/*}"
+      body: "product"
+    };
+  }
+
+  // Permanently deletes a product and its reference images.
+  //
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Creates and returns a new ReferenceImage resource.
+  //
+  // The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+  // the system will try to detect regions of interest in the image that are
+  // compatible with the product_category on the parent product. If it is
+  // specified, detection is ALWAYS skipped. The system converts polygons into
+  // non-rotated rectangles.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 50MP).
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if the product does not exist.
+  // * 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) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+      body: "reference_image"
+    };
+  }
+
+  // Permanently deletes a reference image.
+  //
+  // The image metadata will be deleted right away, but search queries
+  // against ProductSets containing the image may still work until all related
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Lists reference images.
+  //
+  // Possible errors:
+  //
+  // * 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) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+    };
+  }
+
+  // Gets information associated with a ReferenceImage.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the specified image does not exist.
+  rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Adds a Product to the specified ProductSet. If the Product is already
+  // present, no change is made.
+  //
+  // One Product can be added to at most 100 ProductSets.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+  rpc AddProductToProductSet(AddProductToProductSetRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:addProduct"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:removeProduct"
+      body: "*"
+    };
+  }
+
+  // Lists the Products in a ProductSet, in an unspecified order. If the
+  // ProductSet does not exist, the products field of the response will be
+  // empty.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProductsInProductSet(ListProductsInProductSetRequest) returns (ListProductsInProductSetResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}/products"
+    };
+  }
+
+  // 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.
+  // `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.v1p3beta1.ImportProductSetsGcsSource.csv_file_uri].
+  rpc ImportProductSets(ImportProductSetsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets:import"
+      body: "*"
+    };
+  }
+}
+
+// A Product contains ReferenceImages.
+message 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
+    // exceed 128 bytes.
+    string key = 1;
+
+    // The value of the label attached to the product. Cannot be empty and
+    // cannot exceed 128 bytes.
+    string value = 2;
+  }
+
+  // The resource name of the product.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  //
+  // This field is ignored when creating a product.
+  string name = 1;
+
+  // The user-provided name for this Product. Must not be empty. Must be at most
+  // 4096 characters long.
+  string display_name = 2;
+
+  // User-provided metadata to be stored with this product. Must be at most 4096
+  // 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;
+
+  // Key-value pairs that can be attached to a product. At query time,
+  // constraints can be specified based on the product_labels.
+  //
+  // Note that integer values can be provided as strings, e.g. "1199". Only
+  // strings with integer values can match a range-based restriction which is
+  // to be supported soon.
+  //
+  // Multiple values can be assigned to the same key. One product may have up to
+  // 100 product_labels.
+  repeated KeyValue product_labels = 5;
+}
+
+// A ProductSet contains Products. A ProductSet can contain a maximum of 1
+// million reference images. If the limit is exceeded, periodic indexing will
+// fail.
+message ProductSet {
+  // The resource name of the ProductSet.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  //
+  // This field is ignored when creating a ProductSet.
+  string name = 1;
+
+  // The user-provided name for this ProductSet. Must not be empty. Must be at
+  // most 4096 characters long.
+  string display_name = 2;
+
+  // Output only. The time at which this ProductSet was last indexed. Query
+  // results will reflect all updates before this time. If this ProductSet has
+  // never been indexed, this field is 0.
+  //
+  // This field is ignored when creating a ProductSet.
+  google.protobuf.Timestamp index_time = 3;
+
+  // 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;
+}
+
+// A `ReferenceImage` represents a product image and its associated metadata,
+// such as bounding boxes.
+message ReferenceImage {
+  // The resource name of the reference image.
+  //
+  // Format is:
+  //
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
+  //
+  // This field is ignored when creating a reference image.
+  string name = 1;
+
+  // The Google Cloud Storage URI of the reference image.
+  //
+  // The URI must start with `gs://`.
+  //
+  // Required.
+  string uri = 2;
+
+  // 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
+  // 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;
+}
+
+// Request message for the `CreateProduct` method.
+message CreateProductRequest {
+  // The project in which the Product should be created.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The product to create.
+  Product product = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_id = 3;
+}
+
+// Request message for the `ListProducts` method.
+message ListProductsRequest {
+  // The project OR ProductSet from which Products should be listed.
+  //
+  // Format:
+  // `projects/PROJECT_ID/locations/LOC_ID`
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProducts` method.
+message ListProductsResponse {
+  // List of products.
+  repeated Product products = 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 message for the `GetProduct` method.
+message GetProductRequest {
+  // Resource name of the Product to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProduct` method.
+message UpdateProductRequest {
+  // The Product resource which replaces the one on the server.
+  // product.name is immutable.
+  Product product = 1;
+
+  // 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
+  // `description`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProduct` method.
+message DeleteProductRequest {
+  // Resource name of product to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateProductSet` method.
+message CreateProductSetRequest {
+  // The project in which the ProductSet should be created.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The ProductSet to create.
+  ProductSet product_set = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_set_id = 3;
+}
+
+// Request message for the `ListProductSets` method.
+message ListProductSetsRequest {
+  // The project from which ProductSets should be listed.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductSets` method.
+message ListProductSetsResponse {
+  // List of ProductSets.
+  repeated ProductSet product_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;
+}
+
+// Request message for the `GetProductSet` method.
+message GetProductSetRequest {
+  // Resource name of the ProductSet to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProductSet` method.
+message UpdateProductSetRequest {
+  // The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1;
+
+  // 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 path is `display_name`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProductSet` method.
+message DeleteProductSetRequest {
+  // Resource name of the ProductSet to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateReferenceImage` method.
+message CreateReferenceImageRequest {
+  // 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.
+  // If an image ID is specified, it is ignored.
+  ReferenceImage reference_image = 2;
+
+  // 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
+  // already in use, an error is returned with code ALREADY_EXISTS. Must be at
+  // most 128 characters long. It cannot contain the character `/`.
+  string reference_image_id = 3;
+}
+
+// Request message for the `ListReferenceImages` method.
+message ListReferenceImagesRequest {
+  // Resource name of the product containing the reference images.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // A token identifying a page of results to be returned. This is the value
+  // of `nextPageToken` returned in a previous reference image list request.
+  //
+  // Defaults to the first page if not specified.
+  string page_token = 3;
+}
+
+// Response message for the `ListReferenceImages` method.
+message ListReferenceImagesResponse {
+  // The list of reference images.
+  repeated ReferenceImage reference_images = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string next_page_token = 3;
+}
+
+// Request message for the `GetReferenceImage` method.
+message GetReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `DeleteReferenceImage` method.
+message DeleteReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `AddProductToProductSet` method.
+message AddProductToProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `RemoveProductFromProductSet` method.
+message RemoveProductFromProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetRequest {
+  // The ProductSet resource for which to retrieve Products.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetResponse {
+  // The list of Products.
+  repeated Product products = 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 Google Cloud Storage location for a csv file which preserves a list of
+// ImportProductSetRequests in each line.
+message ImportProductSetsGcsSource {
+  // The Google Cloud Storage URI of the input csv file.
+  //
+  // 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.
+  // 1. image_uri
+  // 2, image_id
+  // 3. product_set_id
+  // 4. product_id
+  // 5, product_category
+  // 6, product_display_name
+  // 7, labels
+  // 8. bounding_poly
+  //
+  // Columns 1, 3, 4, and 5 are required, other columns are optional. A new
+  // ProductSet/Product with the same id will be created on the fly
+  // if the ProductSet/Product specified by product_set_id/product_id does not
+  // exist.
+  //
+  // The image_id field is optional but has to be unique if provided. If it is
+  // empty, we will automatically assign an unique id to the image.
+  //
+  // The product_display_name field is optional. If it is empty, a space (" ")
+  // is used as the place holder for the product display_name, which can
+  // be updated later through the realtime API.
+  //
+  // If the Product with product_id already exists, the fields
+  // product_display_name, product_category and labels are ignored.
+  //
+  // If a Product doesn't exist and needs to be created on the fly, the
+  // product_display_name field refers to [Product.display_name][google.cloud.vision.v1p3beta1.Product.display_name], the
+  // product_category field refers to [Product.product_category][google.cloud.vision.v1p3beta1.Product.product_category], and the
+  // labels field refers to [Product.labels][].
+  //
+  // Labels (optional) should be a line containing a list of comma-separated
+  // key-value pairs, with the format
+  //     "key_1=value_1,key_2=value_2,...,key_n=value_n".
+  //
+  // The bounding_poly (optional) field is used to identify one region of
+  // interest from the image in the same manner as CreateReferenceImage. If no
+  // bounding_poly is specified, the system will try to detect regions of
+  // interest automatically.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 20MP).
+  //
+  // Also note that at most one bounding_poly is allowed per line. If the image
+  // contains multiple regions of interest, the csv should contain one line per
+  // region of interest.
+  //
+  // The bounding_poly column should contain an even number of comma-separated
+  // numbers, with the format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Nonnegative
+  // integers should be used for absolute bounding polygons, and float values
+  // in [0, 1] should be used for normalized bounding polygons.
+  string csv_file_uri = 1;
+}
+
+// The input content for the `ImportProductSets` method.
+message ImportProductSetsInputConfig {
+  // The source of the input.
+  oneof source {
+    // The Google Cloud Storage location for a csv file which preserves a list
+    // of ImportProductSetRequests in each line.
+    ImportProductSetsGcsSource gcs_source = 1;
+  }
+}
+
+// Request message for the `ImportProductSets` method.
+message ImportProductSetsRequest {
+  // 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;
+}
+
+// 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.
+message ImportProductSetsResponse {
+  // The list of reference_images that are imported successfully.
+  repeated ReferenceImage reference_images = 1;
+
+  // The rpc status for each ImportProductSet request, including both successes
+  // and errors.
+  //
+  // The number of statuses here matches the number of lines in the csv file,
+  // and statuses[i] stores the success or failure status of processing the i-th
+  // line of the csv, starting from line 0.
+  repeated google.rpc.Status statuses = 2;
+}
+
+// Metadata for the batch operations such as the current state.
+//
+// This is included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message BatchOperationMetadata {
+  // Enumerates the possible states that the batch request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is actively being processed.
+    PROCESSING = 1;
+
+    // The request is done and at least one item has been successfully
+    // processed.
+    SUCCESSFUL = 2;
+
+    // The request is done and no item has been successfully processed.
+    FAILED = 3;
+
+    // The request is done after the longrunning.Operations.CancelOperation has
+    // been called by the user.  Any records that were processed before the
+    // cancel command are output as specified in the request.
+    CANCELLED = 4;
+  }
+
+  // The current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was submitted to the server.
+  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.protobuf.Timestamp end_time = 3;
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/text_annotation.proto b/vision/google/cloud/vision_v1p1beta1/proto/text_annotation.proto
new file mode 100644
index 000000000000..928e6e88bb07
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/text_annotation.proto
@@ -0,0 +1,252 @@
+// 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.vision.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p1beta1/geometry.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "TextAnnotationProto";
+option java_package = "com.google.cloud.vision.v1p1beta1";
+
+// TextAnnotation contains a structured representation of OCR extracted text.
+// The hierarchy of an OCR extracted text structure is like this:
+//     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.v1p1beta1.TextAnnotation.TextProperty]
+// message definition below for more detail.
+message TextAnnotation {
+  // 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;
+  }
+
+  // Detected start or end of a structural component.
+  message DetectedBreak {
+    // Enum to denote the type of break found. New line, space etc.
+    enum BreakType {
+      // Unknown break label type.
+      UNKNOWN = 0;
+
+      // Regular space.
+      SPACE = 1;
+
+      // Sure space (very wide).
+      SURE_SPACE = 2;
+
+      // Line-wrapping break.
+      EOL_SURE_SPACE = 3;
+
+      // End-line hyphen that is not present in text; does not co-occur with
+      // `SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.
+      HYPHEN = 4;
+
+      // Line break that ends a paragraph.
+      LINE_BREAK = 5;
+    }
+
+    // Detected break type.
+    BreakType type = 1;
+
+    // True if break prepends the element.
+    bool is_prefix = 2;
+  }
+
+  // Additional information detected on the structural component.
+  message TextProperty {
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 1;
+
+    // Detected start or end of a text segment.
+    DetectedBreak detected_break = 2;
+  }
+
+  // List of pages detected by OCR.
+  repeated Page pages = 1;
+
+  // UTF-8 text detected on the pages.
+  string text = 2;
+}
+
+// Detected page from OCR.
+message Page {
+  // Additional information detected on the page.
+  TextAnnotation.TextProperty property = 1;
+
+  // Page width in pixels.
+  int32 width = 2;
+
+  // Page height in pixels.
+  int32 height = 3;
+
+  // List of blocks of text, images etc on this page.
+  repeated Block blocks = 4;
+
+  // Confidence of the OCR results on the page. Range [0, 1].
+  float confidence = 5;
+}
+
+// Logical element on the page.
+message Block {
+  // Type of a block (text, image etc) as identified by OCR.
+  enum BlockType {
+    // Unknown block type.
+    UNKNOWN = 0;
+
+    // Regular text block.
+    TEXT = 1;
+
+    // Table block.
+    TABLE = 2;
+
+    // Image block.
+    PICTURE = 3;
+
+    // Horizontal/vertical line box.
+    RULER = 4;
+
+    // Barcode block.
+    BARCODE = 5;
+  }
+
+  // Additional information detected for the block.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the block.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of paragraphs in this block (if this blocks is of type text).
+  repeated Paragraph paragraphs = 3;
+
+  // Detected block type (text, image etc) for this block.
+  BlockType block_type = 4;
+
+  // Confidence of the OCR results on the block. Range [0, 1].
+  float confidence = 5;
+}
+
+// Structural unit of text representing a number of words in certain order.
+message Paragraph {
+  // Additional information detected for the paragraph.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the paragraph.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of words in this paragraph.
+  repeated Word words = 3;
+
+  // Confidence of the OCR results for the paragraph. Range [0, 1].
+  float confidence = 4;
+}
+
+// A word representation.
+message Word {
+  // Additional information detected for the word.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the word.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of symbols in the word.
+  // The order of the symbols follows the natural reading order.
+  repeated Symbol symbols = 3;
+
+  // Confidence of the OCR results for the word. Range [0, 1].
+  float confidence = 4;
+}
+
+// A single symbol representation.
+message Symbol {
+  // Additional information detected for the symbol.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the symbol.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // The actual UTF-8 representation of the symbol.
+  string text = 3;
+
+  // Confidence of the OCR results for the symbol. Range [0, 1].
+  float confidence = 4;
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/text_annotation_pb2.py b/vision/google/cloud/vision_v1p1beta1/proto/text_annotation_pb2.py
new file mode 100644
index 000000000000..79a8e2cc50cd
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/text_annotation_pb2.py
@@ -0,0 +1,1134 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p1beta1/proto/text_annotation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p1beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p1beta1/proto/text_annotation.proto",
+    package="google.cloud.vision.v1p1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p1beta1B\023TextAnnotationProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p1beta1/proto/text_annotation.proto\x12\x1dgoogle.cloud.vision.v1p1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p1beta1/proto/geometry.proto"\xb2\x04\n\x0eTextAnnotation\x12\x32\n\x05pages\x18\x01 \x03(\x0b\x32#.google.cloud.vision.v1p1beta1.Page\x12\x0c\n\x04text\x18\x02 \x01(\t\x1a=\n\x10\x44\x65tectedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x1a\xdc\x01\n\rDetectedBreak\x12S\n\x04type\x18\x01 \x01(\x0e\x32\x45.google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak.BreakType\x12\x11\n\tis_prefix\x18\x02 \x01(\x08"c\n\tBreakType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\t\n\x05SPACE\x10\x01\x12\x0e\n\nSURE_SPACE\x10\x02\x12\x12\n\x0e\x45OL_SURE_SPACE\x10\x03\x12\n\n\x06HYPHEN\x10\x04\x12\x0e\n\nLINE_BREAK\x10\x05\x1a\xbf\x01\n\x0cTextProperty\x12Z\n\x12\x64\x65tected_languages\x18\x01 \x03(\x0b\x32>.google.cloud.vision.v1p1beta1.TextAnnotation.DetectedLanguage\x12S\n\x0e\x64\x65tected_break\x18\x02 \x01(\x0b\x32;.google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak"\xbd\x01\n\x04Page\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty\x12\r\n\x05width\x18\x02 \x01(\x05\x12\x0e\n\x06height\x18\x03 \x01(\x05\x12\x34\n\x06\x62locks\x18\x04 \x03(\x0b\x32$.google.cloud.vision.v1p1beta1.Block\x12\x12\n\nconfidence\x18\x05 \x01(\x02"\x82\x03\n\x05\x42lock\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12<\n\nparagraphs\x18\x03 \x03(\x0b\x32(.google.cloud.vision.v1p1beta1.Paragraph\x12\x42\n\nblock_type\x18\x04 \x01(\x0e\x32..google.cloud.vision.v1p1beta1.Block.BlockType\x12\x12\n\nconfidence\x18\x05 \x01(\x02"R\n\tBlockType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x08\n\x04TEXT\x10\x01\x12\t\n\x05TABLE\x10\x02\x12\x0b\n\x07PICTURE\x10\x03\x12\t\n\x05RULER\x10\x04\x12\x0b\n\x07\x42\x41RCODE\x10\x05"\xe4\x01\n\tParagraph\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12\x32\n\x05words\x18\x03 \x03(\x0b\x32#.google.cloud.vision.v1p1beta1.Word\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xe3\x01\n\x04Word\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12\x36\n\x07symbols\x18\x03 \x03(\x0b\x32%.google.cloud.vision.v1p1beta1.Symbol\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xbb\x01\n\x06Symbol\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p1beta1.BoundingPoly\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x42\x82\x01\n!com.google.cloud.vision.v1p1beta1B\x13TextAnnotationProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE = _descriptor.EnumDescriptor(
+    name="BreakType",
+    full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak.BreakType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPACE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SURE_SPACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EOL_SURE_SPACE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HYPHEN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINE_BREAK", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=444,
+    serialized_end=543,
+)
+_sym_db.RegisterEnumDescriptor(_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE)
+
+_BLOCK_BLOCKTYPE = _descriptor.EnumDescriptor(
+    name="BlockType",
+    full_name="google.cloud.vision.v1p1beta1.Block.BlockType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PICTURE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RULER", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BARCODE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1236,
+    serialized_end=1318,
+)
+_sym_db.RegisterEnumDescriptor(_BLOCK_BLOCKTYPE)
+
+
+_TEXTANNOTATION_DETECTEDLANGUAGE = _descriptor.Descriptor(
+    name="DetectedLanguage",
+    full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedLanguage.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=259,
+    serialized_end=320,
+)
+
+_TEXTANNOTATION_DETECTEDBREAK = _descriptor.Descriptor(
+    name="DetectedBreak",
+    full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_prefix",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak.is_prefix",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=323,
+    serialized_end=543,
+)
+
+_TEXTANNOTATION_TEXTPROPERTY = _descriptor.Descriptor(
+    name="TextProperty",
+    full_name="google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="detected_languages",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty.detected_languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detected_break",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty.detected_break",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=546,
+    serialized_end=737,
+)
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.vision.v1p1beta1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.pages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p1beta1.TextAnnotation.text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TEXTANNOTATION_DETECTEDLANGUAGE,
+        _TEXTANNOTATION_DETECTEDBREAK,
+        _TEXTANNOTATION_TEXTPROPERTY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=175,
+    serialized_end=737,
+)
+
+
+_PAGE = _descriptor.Descriptor(
+    name="Page",
+    full_name="google.cloud.vision.v1p1beta1.Page",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p1beta1.Page.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.cloud.vision.v1p1beta1.Page.width",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.cloud.vision.v1p1beta1.Page.height",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocks",
+            full_name="google.cloud.vision.v1p1beta1.Page.blocks",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.Page.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=740,
+    serialized_end=929,
+)
+
+
+_BLOCK = _descriptor.Descriptor(
+    name="Block",
+    full_name="google.cloud.vision.v1p1beta1.Block",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p1beta1.Block.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p1beta1.Block.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="paragraphs",
+            full_name="google.cloud.vision.v1p1beta1.Block.paragraphs",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="block_type",
+            full_name="google.cloud.vision.v1p1beta1.Block.block_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.Block.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BLOCK_BLOCKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=932,
+    serialized_end=1318,
+)
+
+
+_PARAGRAPH = _descriptor.Descriptor(
+    name="Paragraph",
+    full_name="google.cloud.vision.v1p1beta1.Paragraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p1beta1.Paragraph.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p1beta1.Paragraph.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.vision.v1p1beta1.Paragraph.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.Paragraph.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1321,
+    serialized_end=1549,
+)
+
+
+_WORD = _descriptor.Descriptor(
+    name="Word",
+    full_name="google.cloud.vision.v1p1beta1.Word",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p1beta1.Word.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p1beta1.Word.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="symbols",
+            full_name="google.cloud.vision.v1p1beta1.Word.symbols",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.Word.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1552,
+    serialized_end=1779,
+)
+
+
+_SYMBOL = _descriptor.Descriptor(
+    name="Symbol",
+    full_name="google.cloud.vision.v1p1beta1.Symbol",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p1beta1.Symbol.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p1beta1.Symbol.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p1beta1.Symbol.text",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p1beta1.Symbol.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1782,
+    serialized_end=1969,
+)
+
+_TEXTANNOTATION_DETECTEDLANGUAGE.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK.fields_by_name[
+    "type"
+].enum_type = _TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE
+_TEXTANNOTATION_DETECTEDBREAK.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE.containing_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_languages"
+].message_type = _TEXTANNOTATION_DETECTEDLANGUAGE
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_break"
+].message_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION.fields_by_name["pages"].message_type = _PAGE
+_PAGE.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PAGE.fields_by_name["blocks"].message_type = _BLOCK
+_BLOCK.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_BLOCK.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_BLOCK.fields_by_name["paragraphs"].message_type = _PARAGRAPH
+_BLOCK.fields_by_name["block_type"].enum_type = _BLOCK_BLOCKTYPE
+_BLOCK_BLOCKTYPE.containing_type = _BLOCK
+_PARAGRAPH.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PARAGRAPH.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PARAGRAPH.fields_by_name["words"].message_type = _WORD
+_WORD.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_WORD.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_WORD.fields_by_name["symbols"].message_type = _SYMBOL
+_SYMBOL.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_SYMBOL.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p1beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["Page"] = _PAGE
+DESCRIPTOR.message_types_by_name["Block"] = _BLOCK
+DESCRIPTOR.message_types_by_name["Paragraph"] = _PARAGRAPH
+DESCRIPTOR.message_types_by_name["Word"] = _WORD
+DESCRIPTOR.message_types_by_name["Symbol"] = _SYMBOL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DetectedLanguage=_reflection.GeneratedProtocolMessageType(
+            "DetectedLanguage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDLANGUAGE,
+                __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+                __doc__="""Detected language for a structural component.
+    
+    
+    Attributes:
+        language_code:
+            The BCP-47 language code, such as "en-US" or "sr-Latn". For
+            more information, see http://www.unicode.org/reports/tr35/#Uni
+            code\_locale\_identifier.
+        confidence:
+            Confidence of detected language. Range [0, 1].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.TextAnnotation.DetectedLanguage)
+            ),
+        ),
+        DetectedBreak=_reflection.GeneratedProtocolMessageType(
+            "DetectedBreak",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDBREAK,
+                __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+                __doc__="""Detected start or end of a structural component.
+    
+    
+    Attributes:
+        type:
+            Detected break type.
+        is_prefix:
+            True if break prepends the element.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.TextAnnotation.DetectedBreak)
+            ),
+        ),
+        TextProperty=_reflection.GeneratedProtocolMessageType(
+            "TextProperty",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_TEXTPROPERTY,
+                __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+                __doc__="""Additional information detected on the structural component.
+    
+    
+    Attributes:
+        detected_languages:
+            A list of detected languages together with confidence.
+        detected_break:
+            Detected start or end of a text segment.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.TextAnnotation.TextProperty)
+            ),
+        ),
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+        __doc__="""TextAnnotation contains a structured representation of OCR extracted
+  text. The hierarchy of an OCR extracted text structure is like this:
+  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.v1p1beta1.TextAnnotation.TextProperty]
+  message definition below for more detail.
+  
+  
+  Attributes:
+      pages:
+          List of pages detected by OCR.
+      text:
+          UTF-8 text detected on the pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+_sym_db.RegisterMessage(TextAnnotation.DetectedLanguage)
+_sym_db.RegisterMessage(TextAnnotation.DetectedBreak)
+_sym_db.RegisterMessage(TextAnnotation.TextProperty)
+
+Page = _reflection.GeneratedProtocolMessageType(
+    "Page",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAGE,
+        __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+        __doc__="""Detected page from OCR.
+  
+  
+  Attributes:
+      property:
+          Additional information detected on the page.
+      width:
+          Page width in pixels.
+      height:
+          Page height in pixels.
+      blocks:
+          List of blocks of text, images etc on this page.
+      confidence:
+          Confidence of the OCR results on the page. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Page)
+    ),
+)
+_sym_db.RegisterMessage(Page)
+
+Block = _reflection.GeneratedProtocolMessageType(
+    "Block",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BLOCK,
+        __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+        __doc__="""Logical element on the page.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the block.
+      bounding_box:
+          The bounding box for the block. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      paragraphs:
+          List of paragraphs in this block (if this blocks is of type
+          text).
+      block_type:
+          Detected block type (text, image etc) for this block.
+      confidence:
+          Confidence of the OCR results on the block. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Block)
+    ),
+)
+_sym_db.RegisterMessage(Block)
+
+Paragraph = _reflection.GeneratedProtocolMessageType(
+    "Paragraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAGRAPH,
+        __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+        __doc__="""Structural unit of text representing a number of words in certain order.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the paragraph.
+      bounding_box:
+          The bounding box for the paragraph. The vertices are in the
+          order of top-left, top-right, bottom-right, bottom-left. When
+          a rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      words:
+          List of words in this paragraph.
+      confidence:
+          Confidence of the OCR results for the paragraph. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Paragraph)
+    ),
+)
+_sym_db.RegisterMessage(Paragraph)
+
+Word = _reflection.GeneratedProtocolMessageType(
+    "Word",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORD,
+        __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+        __doc__="""A word representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the word.
+      bounding_box:
+          The bounding box for the word. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      symbols:
+          List of symbols in the word. The order of the symbols follows
+          the natural reading order.
+      confidence:
+          Confidence of the OCR results for the word. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Word)
+    ),
+)
+_sym_db.RegisterMessage(Word)
+
+Symbol = _reflection.GeneratedProtocolMessageType(
+    "Symbol",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYMBOL,
+        __module__="google.cloud.vision_v1p1beta1.proto.text_annotation_pb2",
+        __doc__="""A single symbol representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the symbol.
+      bounding_box:
+          The bounding box for the symbol. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      text:
+          The actual UTF-8 representation of the symbol.
+      confidence:
+          Confidence of the OCR results for the symbol. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.Symbol)
+    ),
+)
+_sym_db.RegisterMessage(Symbol)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/text_annotation_pb2_grpc.py b/vision/google/cloud/vision_v1p1beta1/proto/text_annotation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/text_annotation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/web_detection.proto b/vision/google/cloud/vision_v1p1beta1/proto/web_detection.proto
new file mode 100644
index 000000000000..28249cbdec22
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/web_detection.proto
@@ -0,0 +1,104 @@
+// 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.vision.v1p1beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "WebDetectionProto";
+option java_package = "com.google.cloud.vision.v1p1beta1";
+
+// Relevant information for the image from the Internet.
+message WebDetection {
+  // Entity deduced from similar images on the Internet.
+  message WebEntity {
+    // Opaque entity ID.
+    string entity_id = 1;
+
+    // Overall relevancy score for the entity.
+    // Not normalized and not comparable across different image queries.
+    float score = 2;
+
+    // Canonical description of the entity, in English.
+    string description = 3;
+  }
+
+  // Metadata for online images.
+  message WebImage {
+    // The result image URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the image.
+    float score = 2;
+  }
+
+  // Metadata for web pages.
+  message WebPage {
+    // The result web page URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the web page.
+    float score = 2;
+
+    // Title for the web page, may contain HTML markups.
+    string page_title = 3;
+
+    // Fully matching images on the page.
+    // Can include resized copies of the query image.
+    repeated WebImage full_matching_images = 4;
+
+    // Partial matching images on the page.
+    // Those images are similar enough to share some key-point features. For
+    // example an original image will likely have partial matching for its
+    // crops.
+    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;
+
+  // Fully matching images from the Internet.
+  // Can include resized copies of the query image.
+  repeated WebImage full_matching_images = 2;
+
+  // Partial matching images from the Internet.
+  // Those images are similar enough to share some key-point features. For
+  // example an original image will likely have partial matching for its crops.
+  repeated WebImage partial_matching_images = 3;
+
+  // Web pages containing the matching images from the Internet.
+  repeated WebPage pages_with_matching_images = 4;
+
+  // The visually similar image results.
+  repeated WebImage visually_similar_images = 6;
+
+  // Best guess text labels for the request image.
+  repeated WebLabel best_guess_labels = 8;
+}
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/web_detection_pb2.py b/vision/google/cloud/vision_v1p1beta1/proto/web_detection_pb2.py
new file mode 100644
index 000000000000..8a0c17869494
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/web_detection_pb2.py
@@ -0,0 +1,616 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p1beta1/proto/web_detection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p1beta1/proto/web_detection.proto",
+    package="google.cloud.vision.v1p1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p1beta1B\021WebDetectionProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/vision_v1p1beta1/proto/web_detection.proto\x12\x1dgoogle.cloud.vision.v1p1beta1\x1a\x1cgoogle/api/annotations.proto"\x8c\x07\n\x0cWebDetection\x12K\n\x0cweb_entities\x18\x01 \x03(\x0b\x32\x35.google.cloud.vision.v1p1beta1.WebDetection.WebEntity\x12R\n\x14\x66ull_matching_images\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x03 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.WebDetection.WebImage\x12W\n\x1apages_with_matching_images\x18\x04 \x03(\x0b\x32\x33.google.cloud.vision.v1p1beta1.WebDetection.WebPage\x12U\n\x17visually_similar_images\x18\x06 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.WebDetection.WebImage\x12O\n\x11\x62\x65st_guess_labels\x18\x08 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.WebDetection.WebLabel\x1a\x42\n\tWebEntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x1a&\n\x08WebImage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x1a\xe4\x01\n\x07WebPage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x12\n\npage_title\x18\x03 \x01(\t\x12R\n\x14\x66ull_matching_images\x18\x04 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x05 \x03(\x0b\x32\x34.google.cloud.vision.v1p1beta1.WebDetection.WebImage\x1a\x30\n\x08WebLabel\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\tB\x80\x01\n!com.google.cloud.vision.v1p1beta1B\x11WebDetectionProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p1beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_WEBDETECTION_WEBENTITY = _descriptor.Descriptor(
+    name="WebEntity",
+    full_name="google.cloud.vision.v1p1beta1.WebDetection.WebEntity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebEntity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebEntity.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebEntity.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=642,
+    serialized_end=708,
+)
+
+_WEBDETECTION_WEBIMAGE = _descriptor.Descriptor(
+    name="WebImage",
+    full_name="google.cloud.vision.v1p1beta1.WebDetection.WebImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebImage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebImage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=710,
+    serialized_end=748,
+)
+
+_WEBDETECTION_WEBPAGE = _descriptor.Descriptor(
+    name="WebPage",
+    full_name="google.cloud.vision.v1p1beta1.WebDetection.WebPage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebPage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebPage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_title",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebPage.page_title",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebPage.full_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebPage.partial_matching_images",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=751,
+    serialized_end=979,
+)
+
+_WEBDETECTION_WEBLABEL = _descriptor.Descriptor(
+    name="WebLabel",
+    full_name="google.cloud.vision.v1p1beta1.WebDetection.WebLabel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebLabel.label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.WebLabel.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=981,
+    serialized_end=1029,
+)
+
+_WEBDETECTION = _descriptor.Descriptor(
+    name="WebDetection",
+    full_name="google.cloud.vision.v1p1beta1.WebDetection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="web_entities",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.web_entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.full_matching_images",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.partial_matching_images",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages_with_matching_images",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.pages_with_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="visually_similar_images",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.visually_similar_images",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="best_guess_labels",
+            full_name="google.cloud.vision.v1p1beta1.WebDetection.best_guess_labels",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _WEBDETECTION_WEBENTITY,
+        _WEBDETECTION_WEBIMAGE,
+        _WEBDETECTION_WEBPAGE,
+        _WEBDETECTION_WEBLABEL,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=121,
+    serialized_end=1029,
+)
+
+_WEBDETECTION_WEBENTITY.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBIMAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBLABEL.containing_type = _WEBDETECTION
+_WEBDETECTION.fields_by_name["web_entities"].message_type = _WEBDETECTION_WEBENTITY
+_WEBDETECTION.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "pages_with_matching_images"
+].message_type = _WEBDETECTION_WEBPAGE
+_WEBDETECTION.fields_by_name[
+    "visually_similar_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name["best_guess_labels"].message_type = _WEBDETECTION_WEBLABEL
+DESCRIPTOR.message_types_by_name["WebDetection"] = _WEBDETECTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WebDetection = _reflection.GeneratedProtocolMessageType(
+    "WebDetection",
+    (_message.Message,),
+    dict(
+        WebEntity=_reflection.GeneratedProtocolMessageType(
+            "WebEntity",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBENTITY,
+                __module__="google.cloud.vision_v1p1beta1.proto.web_detection_pb2",
+                __doc__="""Entity deduced from similar images on the Internet.
+    
+    
+    Attributes:
+        entity_id:
+            Opaque entity ID.
+        score:
+            Overall relevancy score for the entity. Not normalized and not
+            comparable across different image queries.
+        description:
+            Canonical description of the entity, in English.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.WebDetection.WebEntity)
+            ),
+        ),
+        WebImage=_reflection.GeneratedProtocolMessageType(
+            "WebImage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBIMAGE,
+                __module__="google.cloud.vision_v1p1beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for online images.
+    
+    
+    Attributes:
+        url:
+            The result image URL.
+        score:
+            (Deprecated) Overall relevancy score for the image.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.WebDetection.WebImage)
+            ),
+        ),
+        WebPage=_reflection.GeneratedProtocolMessageType(
+            "WebPage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBPAGE,
+                __module__="google.cloud.vision_v1p1beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for web pages.
+    
+    
+    Attributes:
+        url:
+            The result web page URL.
+        score:
+            (Deprecated) Overall relevancy score for the web page.
+        page_title:
+            Title for the web page, may contain HTML markups.
+        full_matching_images:
+            Fully matching images on the page. Can include resized copies
+            of the query image.
+        partial_matching_images:
+            Partial matching images on the page. Those images are similar
+            enough to share some key-point features. For example an
+            original image will likely have partial matching for its
+            crops.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.WebDetection.WebPage)
+            ),
+        ),
+        WebLabel=_reflection.GeneratedProtocolMessageType(
+            "WebLabel",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBLABEL,
+                __module__="google.cloud.vision_v1p1beta1.proto.web_detection_pb2",
+                __doc__="""Label to provide extra metadata for the web detection.
+    
+    
+    Attributes:
+        label:
+            Label for extra metadata.
+        language_code:
+            The BCP-47 language code for ``label``, such as "en-US" or
+            "sr-Latn". For more information, see http://www.unicode.org/re
+            ports/tr35/#Unicode\_locale\_identifier.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.WebDetection.WebLabel)
+            ),
+        ),
+        DESCRIPTOR=_WEBDETECTION,
+        __module__="google.cloud.vision_v1p1beta1.proto.web_detection_pb2",
+        __doc__="""Relevant information for the image from the Internet.
+  
+  
+  Attributes:
+      web_entities:
+          Deduced entities from similar images on the Internet.
+      full_matching_images:
+          Fully matching images from the Internet. Can include resized
+          copies of the query image.
+      partial_matching_images:
+          Partial matching images from the Internet. Those images are
+          similar enough to share some key-point features. For example
+          an original image will likely have partial matching for its
+          crops.
+      pages_with_matching_images:
+          Web pages containing the matching images from the Internet.
+      visually_similar_images:
+          The visually similar image results.
+      best_guess_labels:
+          Best guess text labels for the request image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p1beta1.WebDetection)
+    ),
+)
+_sym_db.RegisterMessage(WebDetection)
+_sym_db.RegisterMessage(WebDetection.WebEntity)
+_sym_db.RegisterMessage(WebDetection.WebImage)
+_sym_db.RegisterMessage(WebDetection.WebPage)
+_sym_db.RegisterMessage(WebDetection.WebLabel)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p1beta1/proto/web_detection_pb2_grpc.py b/vision/google/cloud/vision_v1p1beta1/proto/web_detection_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/proto/web_detection_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p1beta1/types.py b/vision/google/cloud/vision_v1p1beta1/types.py
new file mode 100644
index 000000000000..b66ea7ef6a38
--- /dev/null
+++ b/vision/google/cloud/vision_v1p1beta1/types.py
@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.vision_v1p1beta1.proto import geometry_pb2
+from google.cloud.vision_v1p1beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p1beta1.proto import text_annotation_pb2
+from google.cloud.vision_v1p1beta1.proto import web_detection_pb2
+from google.protobuf import any_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import color_pb2
+from google.type import latlng_pb2
+
+
+_shared_modules = [any_pb2, wrappers_pb2, status_pb2, color_pb2, latlng_pb2]
+
+_local_modules = [
+    geometry_pb2,
+    image_annotator_pb2,
+    text_annotation_pb2,
+    web_detection_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.vision_v1p1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/vision/google/cloud/vision_v1p2beta1/__init__.py b/vision/google/cloud/vision_v1p2beta1/__init__.py
new file mode 100644
index 000000000000..894e287414ff
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.vision_helpers.decorators import add_single_feature_methods
+from google.cloud.vision_helpers import VisionHelpers
+
+from google.cloud.vision_v1p2beta1 import types
+from google.cloud.vision_v1p2beta1.gapic import enums
+from google.cloud.vision_v1p2beta1.gapic import image_annotator_client as iac
+
+
+@add_single_feature_methods
+class ImageAnnotatorClient(VisionHelpers, iac.ImageAnnotatorClient):
+    __doc__ = iac.ImageAnnotatorClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ImageAnnotatorClient")
diff --git a/vision/google/cloud/vision_v1p2beta1/gapic/__init__.py b/vision/google/cloud/vision_v1p2beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p2beta1/gapic/enums.py b/vision/google/cloud/vision_v1p2beta1/gapic/enums.py
new file mode 100644
index 000000000000..bb6c189a8281
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/gapic/enums.py
@@ -0,0 +1,228 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Likelihood(enum.IntEnum):
+    """
+    A bucketized representation of likelihood, which is intended to give clients
+    highly stable results across model upgrades.
+
+    Attributes:
+      UNKNOWN (int): Unknown likelihood.
+      VERY_UNLIKELY (int): It is very unlikely that the image belongs to the specified vertical.
+      UNLIKELY (int): It is unlikely that the image belongs to the specified vertical.
+      POSSIBLE (int): It is possible that the image belongs to the specified vertical.
+      LIKELY (int): It is likely that the image belongs to the specified vertical.
+      VERY_LIKELY (int): It is very likely that the image belongs to the specified vertical.
+    """
+
+    UNKNOWN = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class Block(object):
+    class BlockType(enum.IntEnum):
+        """
+        Type of a block (text, image etc) as identified by OCR.
+
+        Attributes:
+          UNKNOWN (int): Unknown block type.
+          TEXT (int): Regular text block.
+          TABLE (int): Table block.
+          PICTURE (int): Image block.
+          RULER (int): Horizontal/vertical line box.
+          BARCODE (int): Barcode block.
+        """
+
+        UNKNOWN = 0
+        TEXT = 1
+        TABLE = 2
+        PICTURE = 3
+        RULER = 4
+        BARCODE = 5
+
+
+class FaceAnnotation(object):
+    class Landmark(object):
+        class Type(enum.IntEnum):
+            """
+            Face landmark (feature) type. Left and right are defined from the
+            vantage of the viewer of the image without considering mirror
+            projections typical of photos. So, ``LEFT_EYE``, typically, is the
+            person's right eye.
+
+            Attributes:
+              UNKNOWN_LANDMARK (int): Unknown face landmark detected. Should not be filled.
+              LEFT_EYE (int): Left eye.
+              RIGHT_EYE (int): Right eye.
+              LEFT_OF_LEFT_EYEBROW (int): Left of left eyebrow.
+              RIGHT_OF_LEFT_EYEBROW (int): Right of left eyebrow.
+              LEFT_OF_RIGHT_EYEBROW (int): Left of right eyebrow.
+              RIGHT_OF_RIGHT_EYEBROW (int): Right of right eyebrow.
+              MIDPOINT_BETWEEN_EYES (int): Midpoint between eyes.
+              NOSE_TIP (int): Nose tip.
+              UPPER_LIP (int): Upper lip.
+              LOWER_LIP (int): Lower lip.
+              MOUTH_LEFT (int): Mouth left.
+              MOUTH_RIGHT (int): Mouth right.
+              MOUTH_CENTER (int): Mouth center.
+              NOSE_BOTTOM_RIGHT (int): Nose, bottom right.
+              NOSE_BOTTOM_LEFT (int): Nose, bottom left.
+              NOSE_BOTTOM_CENTER (int): Nose, bottom center.
+              LEFT_EYE_TOP_BOUNDARY (int): Left eye, top boundary.
+              LEFT_EYE_RIGHT_CORNER (int): Left eye, right corner.
+              LEFT_EYE_BOTTOM_BOUNDARY (int): Left eye, bottom boundary.
+              LEFT_EYE_LEFT_CORNER (int): Left eye, left corner.
+              RIGHT_EYE_TOP_BOUNDARY (int): Right eye, top boundary.
+              RIGHT_EYE_RIGHT_CORNER (int): Right eye, right corner.
+              RIGHT_EYE_BOTTOM_BOUNDARY (int): Right eye, bottom boundary.
+              RIGHT_EYE_LEFT_CORNER (int): Right eye, left corner.
+              LEFT_EYEBROW_UPPER_MIDPOINT (int): Left eyebrow, upper midpoint.
+              RIGHT_EYEBROW_UPPER_MIDPOINT (int): Right eyebrow, upper midpoint.
+              LEFT_EAR_TRAGION (int): Left ear tragion.
+              RIGHT_EAR_TRAGION (int): Right ear tragion.
+              LEFT_EYE_PUPIL (int): Left eye pupil.
+              RIGHT_EYE_PUPIL (int): Right eye pupil.
+              FOREHEAD_GLABELLA (int): Forehead glabella.
+              CHIN_GNATHION (int): Chin gnathion.
+              CHIN_LEFT_GONION (int): Chin left gonion.
+              CHIN_RIGHT_GONION (int): Chin right gonion.
+            """
+
+            UNKNOWN_LANDMARK = 0
+            LEFT_EYE = 1
+            RIGHT_EYE = 2
+            LEFT_OF_LEFT_EYEBROW = 3
+            RIGHT_OF_LEFT_EYEBROW = 4
+            LEFT_OF_RIGHT_EYEBROW = 5
+            RIGHT_OF_RIGHT_EYEBROW = 6
+            MIDPOINT_BETWEEN_EYES = 7
+            NOSE_TIP = 8
+            UPPER_LIP = 9
+            LOWER_LIP = 10
+            MOUTH_LEFT = 11
+            MOUTH_RIGHT = 12
+            MOUTH_CENTER = 13
+            NOSE_BOTTOM_RIGHT = 14
+            NOSE_BOTTOM_LEFT = 15
+            NOSE_BOTTOM_CENTER = 16
+            LEFT_EYE_TOP_BOUNDARY = 17
+            LEFT_EYE_RIGHT_CORNER = 18
+            LEFT_EYE_BOTTOM_BOUNDARY = 19
+            LEFT_EYE_LEFT_CORNER = 20
+            RIGHT_EYE_TOP_BOUNDARY = 21
+            RIGHT_EYE_RIGHT_CORNER = 22
+            RIGHT_EYE_BOTTOM_BOUNDARY = 23
+            RIGHT_EYE_LEFT_CORNER = 24
+            LEFT_EYEBROW_UPPER_MIDPOINT = 25
+            RIGHT_EYEBROW_UPPER_MIDPOINT = 26
+            LEFT_EAR_TRAGION = 27
+            RIGHT_EAR_TRAGION = 28
+            LEFT_EYE_PUPIL = 29
+            RIGHT_EYE_PUPIL = 30
+            FOREHEAD_GLABELLA = 31
+            CHIN_GNATHION = 32
+            CHIN_LEFT_GONION = 33
+            CHIN_RIGHT_GONION = 34
+
+
+class Feature(object):
+    class Type(enum.IntEnum):
+        """
+        Type of Google Cloud Vision API feature to be extracted.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Unspecified feature type.
+          FACE_DETECTION (int): Run face detection.
+          LANDMARK_DETECTION (int): Run landmark detection.
+          LOGO_DETECTION (int): Run logo detection.
+          LABEL_DETECTION (int): Run label detection.
+          TEXT_DETECTION (int): Run text detection / optical character recognition (OCR). Text detection
+          is optimized for areas of text within a larger image; if the image is a
+          document, use ``DOCUMENT_TEXT_DETECTION`` instead.
+          DOCUMENT_TEXT_DETECTION (int): Run dense text document OCR. Takes precedence when both
+          ``DOCUMENT_TEXT_DETECTION`` and ``TEXT_DETECTION`` are present.
+          SAFE_SEARCH_DETECTION (int): Run Safe Search to detect potentially unsafe
+          or undesirable content.
+          IMAGE_PROPERTIES (int): Compute a set of image properties, such as the
+          image's dominant colors.
+          CROP_HINTS (int): Run crop hints.
+          WEB_DETECTION (int): Run web detection.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        FACE_DETECTION = 1
+        LANDMARK_DETECTION = 2
+        LOGO_DETECTION = 3
+        LABEL_DETECTION = 4
+        TEXT_DETECTION = 5
+        DOCUMENT_TEXT_DETECTION = 11
+        SAFE_SEARCH_DETECTION = 6
+        IMAGE_PROPERTIES = 7
+        CROP_HINTS = 9
+        WEB_DETECTION = 10
+
+
+class OperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Batch operation states.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          CREATED (int): Request is received.
+          RUNNING (int): Request is actively being processed.
+          DONE (int): The batch processing is done.
+          CANCELLED (int): The batch processing was cancelled.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATED = 1
+        RUNNING = 2
+        DONE = 3
+        CANCELLED = 4
+
+
+class TextAnnotation(object):
+    class DetectedBreak(object):
+        class BreakType(enum.IntEnum):
+            """
+            Enum to denote the type of break found. New line, space etc.
+
+            Attributes:
+              UNKNOWN (int): Unknown break label type.
+              SPACE (int): Regular space.
+              SURE_SPACE (int): Sure space (very wide).
+              EOL_SURE_SPACE (int): Line-wrapping break.
+              HYPHEN (int): End-line hyphen that is not present in text; does not co-occur with
+              ``SPACE``, ``LEADER_SPACE``, or ``LINE_BREAK``.
+              LINE_BREAK (int): Line break that ends a paragraph.
+            """
+
+            UNKNOWN = 0
+            SPACE = 1
+            SURE_SPACE = 2
+            EOL_SURE_SPACE = 3
+            HYPHEN = 4
+            LINE_BREAK = 5
diff --git a/vision/google/cloud/vision_v1p2beta1/gapic/image_annotator_client.py b/vision/google/cloud/vision_v1p2beta1/gapic/image_annotator_client.py
new file mode 100644
index 000000000000..742ce5ff0565
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/gapic/image_annotator_client.py
@@ -0,0 +1,330 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1p2beta1 ImageAnnotator API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import grpc
+
+from google.cloud.vision_v1p2beta1.gapic import enums
+from google.cloud.vision_v1p2beta1.gapic import image_annotator_client_config
+from google.cloud.vision_v1p2beta1.gapic.transports import (
+    image_annotator_grpc_transport,
+)
+from google.cloud.vision_v1p2beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p2beta1.proto import image_annotator_pb2_grpc
+from google.longrunning import operations_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ImageAnnotatorClient(object):
+    """
+    Service that performs Google Cloud Vision API detection tasks over client
+    images, such as face, landmark, logo, label, and text detection. The
+    ImageAnnotator service returns detected entities from the images.
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1p2beta1.ImageAnnotator"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ImageAnnotatorClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ImageAnnotatorGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ImageAnnotatorGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = image_annotator_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=image_annotator_grpc_transport.ImageAnnotatorGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = image_annotator_grpc_transport.ImageAnnotatorGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def batch_annotate_images(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run image detection and annotation for a batch of images.
+
+        Example:
+            >>> from google.cloud import vision_v1p2beta1
+            >>>
+            >>> client = vision_v1p2beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_images(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p2beta1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p2beta1.types.AnnotateImageRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p2beta1.types.BatchAnnotateImagesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_images,
+                default_retry=self._method_configs["BatchAnnotateImages"].retry,
+                default_timeout=self._method_configs["BatchAnnotateImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateImagesRequest(requests=requests)
+        return self._inner_api_calls["batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def async_batch_annotate_files(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run async image detection and annotation for a list of generic files
+        (e.g. PDF) which may contain multiple pages and multiple images per
+        page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Example:
+            >>> from google.cloud import vision_v1p2beta1
+            >>>
+            >>> client = vision_v1p2beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.async_batch_annotate_files(requests)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p2beta1.types.AsyncAnnotateFileRequest]]): Individual async file annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p2beta1.types.AsyncAnnotateFileRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p2beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "async_batch_annotate_files" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "async_batch_annotate_files"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.async_batch_annotate_files,
+                default_retry=self._method_configs["AsyncBatchAnnotateFiles"].retry,
+                default_timeout=self._method_configs["AsyncBatchAnnotateFiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(requests=requests)
+        operation = self._inner_api_calls["async_batch_annotate_files"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            image_annotator_pb2.AsyncBatchAnnotateFilesResponse,
+            metadata_type=image_annotator_pb2.OperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1p2beta1/gapic/image_annotator_client_config.py b/vision/google/cloud/vision_v1p2beta1/gapic/image_annotator_client_config.py
new file mode 100644
index 000000000000..9ed71995d165
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/gapic/image_annotator_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1p2beta1.ImageAnnotator": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "BatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AsyncBatchAnnotateFiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/gapic/transports/__init__.py b/vision/google/cloud/vision_v1p2beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p2beta1/gapic/transports/image_annotator_grpc_transport.py b/vision/google/cloud/vision_v1p2beta1/gapic/transports/image_annotator_grpc_transport.py
new file mode 100644
index 000000000000..2b469eed0d82
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/gapic/transports/image_annotator_grpc_transport.py
@@ -0,0 +1,150 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1p2beta1.proto import image_annotator_pb2_grpc
+
+
+class ImageAnnotatorGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1p2beta1 ImageAnnotator API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "image_annotator_stub": image_annotator_pb2_grpc.ImageAnnotatorStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_images`.
+
+        Run image detection and annotation for a batch of images.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateImages
+
+    @property
+    def async_batch_annotate_files(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.async_batch_annotate_files`.
+
+        Run async image detection and annotation for a list of generic files
+        (e.g. PDF) which may contain multiple pages and multiple images per
+        page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].AsyncBatchAnnotateFiles
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/__init__.py b/vision/google/cloud/vision_v1p2beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/geometry.proto b/vision/google/cloud/vision_v1p2beta1/proto/geometry.proto
new file mode 100644
index 000000000000..e9fec20bda76
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/geometry.proto
@@ -0,0 +1,67 @@
+// 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.cloud.vision.v1p2beta1;
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "GeometryProto";
+option java_package = "com.google.cloud.vision.v1p2beta1";
+
+// 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;
+}
+
+// A 3D position in the image, used primarily for Face detection landmarks.
+// A valid Position must have both x and y coordinates.
+// The position coordinates are in the same scale as the original image.
+message Position {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+
+  // Z coordinate (or depth).
+  float z = 3;
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/geometry_pb2.py b/vision/google/cloud/vision_v1p2beta1/proto/geometry_pb2.py
new file mode 100644
index 000000000000..969d95d19b1a
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/geometry_pb2.py
@@ -0,0 +1,366 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p2beta1/proto/geometry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p2beta1/proto/geometry.proto",
+    package="google.cloud.vision.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p2beta1B\rGeometryProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/vision_v1p2beta1/proto/geometry.proto\x12\x1dgoogle.cloud.vision.v1p2beta1"\x1e\n\x06Vertex\x12\t\n\x01x\x18\x01 \x01(\x05\x12\t\n\x01y\x18\x02 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"\x95\x01\n\x0c\x42oundingPoly\x12\x37\n\x08vertices\x18\x01 \x03(\x0b\x32%.google.cloud.vision.v1p2beta1.Vertex\x12L\n\x13normalized_vertices\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p2beta1.NormalizedVertex"+\n\x08Position\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02\x12\t\n\x01z\x18\x03 \x01(\x02\x42|\n!com.google.cloud.vision.v1p2beta1B\rGeometryProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+)
+
+
+_VERTEX = _descriptor.Descriptor(
+    name="Vertex",
+    full_name="google.cloud.vision.v1p2beta1.Vertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p2beta1.Vertex.x",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p2beta1.Vertex.y",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=85,
+    serialized_end=115,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.vision.v1p2beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p2beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p2beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=117,
+    serialized_end=157,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.vision.v1p2beta1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.vision.v1p2beta1.BoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.vision.v1p2beta1.BoundingPoly.normalized_vertices",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=160,
+    serialized_end=309,
+)
+
+
+_POSITION = _descriptor.Descriptor(
+    name="Position",
+    full_name="google.cloud.vision.v1p2beta1.Position",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p2beta1.Position.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p2beta1.Position.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="z",
+            full_name="google.cloud.vision.v1p2beta1.Position.z",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=311,
+    serialized_end=354,
+)
+
+_BOUNDINGPOLY.fields_by_name["vertices"].message_type = _VERTEX
+_BOUNDINGPOLY.fields_by_name["normalized_vertices"].message_type = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["Vertex"] = _VERTEX
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["Position"] = _POSITION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Vertex = _reflection.GeneratedProtocolMessageType(
+    "Vertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTEX,
+        __module__="google.cloud.vision_v1p2beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Vertex)
+    ),
+)
+_sym_db.RegisterMessage(Vertex)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.vision_v1p2beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.vision_v1p2beta1.proto.geometry_pb2",
+        __doc__="""A bounding polygon for the detected image annotation.
+  
+  
+  Attributes:
+      vertices:
+          The bounding polygon vertices.
+      normalized_vertices:
+          The bounding polygon normalized vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+Position = _reflection.GeneratedProtocolMessageType(
+    "Position",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSITION,
+        __module__="google.cloud.vision_v1p2beta1.proto.geometry_pb2",
+        __doc__="""A 3D position in the image, used primarily for Face detection landmarks.
+  A valid Position must have both x and y coordinates. The position
+  coordinates are in the same scale as the original image.
+  
+  
+  Attributes:
+      x:
+          X coordinate.
+      y:
+          Y coordinate.
+      z:
+          Z coordinate (or depth).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Position)
+    ),
+)
+_sym_db.RegisterMessage(Position)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/geometry_pb2_grpc.py b/vision/google/cloud/vision_v1p2beta1/proto/geometry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/geometry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/image_annotator.proto b/vision/google/cloud/vision_v1p2beta1/proto/image_annotator.proto
new file mode 100644
index 000000000000..c5fce50f9baa
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/image_annotator.proto
@@ -0,0 +1,765 @@
+// 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.cloud.vision.v1p2beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p2beta1/geometry.proto";
+import "google/cloud/vision/v1p2beta1/text_annotation.proto";
+import "google/cloud/vision/v1p2beta1/web_detection.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+import "google/type/latlng.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ImageAnnotatorProto";
+option java_package = "com.google.cloud.vision.v1p2beta1";
+
+// Service that performs Google Cloud Vision API detection tasks over client
+// images, such as face, landmark, logo, label, and text detection. The
+// ImageAnnotator service returns detected entities from the images.
+service ImageAnnotator {
+  // Run image detection and annotation for a batch of images.
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
+      returns (BatchAnnotateImagesResponse) {
+    option (google.api.http) = {
+      post: "/v1p2beta1/images:annotate"
+      body: "*"
+    };
+  }
+
+  // Run async image detection and annotation for a list of generic files (e.g.
+  // PDF) which may contain multiple pages and multiple images per page.
+  // Progress and results can be retrieved through the
+  // `google.longrunning.Operations` interface.
+  // `Operation.metadata` contains `OperationMetadata` (metadata).
+  // `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p2beta1/files:asyncBatchAnnotate"
+      body: "*"
+    };
+  }
+}
+
+// The type of Google Cloud Vision API detection to perform, and the maximum
+// number of results to return for that type. Multiple `Feature` objects can
+// be specified in the `features` list.
+message Feature {
+  // Type of Google Cloud Vision API feature to be extracted.
+  enum Type {
+    // Unspecified feature type.
+    TYPE_UNSPECIFIED = 0;
+
+    // Run face detection.
+    FACE_DETECTION = 1;
+
+    // Run landmark detection.
+    LANDMARK_DETECTION = 2;
+
+    // Run logo detection.
+    LOGO_DETECTION = 3;
+
+    // Run label detection.
+    LABEL_DETECTION = 4;
+
+    // Run text detection / optical character recognition (OCR). Text detection
+    // is optimized for areas of text within a larger image; if the image is
+    // a document, use `DOCUMENT_TEXT_DETECTION` instead.
+    TEXT_DETECTION = 5;
+
+    // Run dense text document OCR. Takes precedence when both
+    // `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` are present.
+    DOCUMENT_TEXT_DETECTION = 11;
+
+    // Run Safe Search to detect potentially unsafe
+    // or undesirable content.
+    SAFE_SEARCH_DETECTION = 6;
+
+    // Compute a set of image properties, such as the
+    // image's dominant colors.
+    IMAGE_PROPERTIES = 7;
+
+    // Run crop hints.
+    CROP_HINTS = 9;
+
+    // Run web detection.
+    WEB_DETECTION = 10;
+  }
+
+  // The feature type.
+  Type type = 1;
+
+  // Maximum number of results of this type. Does not apply to
+  // `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
+  int32 max_results = 2;
+
+  // Model to use for the feature.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// External image source (Google Cloud Storage or web URL image location).
+message ImageSource {
+  // **Use `image_uri` instead.**
+  //
+  // The 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 gcs_image_uri = 1;
+
+  // The URI of the source image. Can be either:
+  //
+  // 1. A 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.
+  //
+  // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from
+  //    HTTP/HTTPS URLs, Google cannot guarantee that the request will be
+  //    completed. Your request may fail if the specified host denies the
+  //    request (e.g. due to request throttling or DOS prevention), or if Google
+  //    throttles requests to the site for abuse prevention. You should not
+  //    depend on externally-hosted images for production applications.
+  //
+  // When both `gcs_image_uri` and `image_uri` are specified, `image_uri` takes
+  // precedence.
+  string image_uri = 2;
+}
+
+// Client image to perform Google Cloud Vision API tasks over.
+message Image {
+  // 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 content = 1;
+
+  // Google Cloud Storage image location, or publicly-accessible image
+  // URL. If both `content` and `source` are provided for an image, `content`
+  // takes precedence and is used to perform the image annotation request.
+  ImageSource source = 2;
+}
+
+// A face annotation object contains the results of face detection.
+message FaceAnnotation {
+  // A face-specific landmark (for example, a face feature).
+  message Landmark {
+    // Face landmark (feature) type.
+    // Left and right are defined from the vantage of the viewer of the image
+    // without considering mirror projections typical of photos. So, `LEFT_EYE`,
+    // typically, is the person's right eye.
+    enum Type {
+      // Unknown face landmark detected. Should not be filled.
+      UNKNOWN_LANDMARK = 0;
+
+      // Left eye.
+      LEFT_EYE = 1;
+
+      // Right eye.
+      RIGHT_EYE = 2;
+
+      // Left of left eyebrow.
+      LEFT_OF_LEFT_EYEBROW = 3;
+
+      // Right of left eyebrow.
+      RIGHT_OF_LEFT_EYEBROW = 4;
+
+      // Left of right eyebrow.
+      LEFT_OF_RIGHT_EYEBROW = 5;
+
+      // Right of right eyebrow.
+      RIGHT_OF_RIGHT_EYEBROW = 6;
+
+      // Midpoint between eyes.
+      MIDPOINT_BETWEEN_EYES = 7;
+
+      // Nose tip.
+      NOSE_TIP = 8;
+
+      // Upper lip.
+      UPPER_LIP = 9;
+
+      // Lower lip.
+      LOWER_LIP = 10;
+
+      // Mouth left.
+      MOUTH_LEFT = 11;
+
+      // Mouth right.
+      MOUTH_RIGHT = 12;
+
+      // Mouth center.
+      MOUTH_CENTER = 13;
+
+      // Nose, bottom right.
+      NOSE_BOTTOM_RIGHT = 14;
+
+      // Nose, bottom left.
+      NOSE_BOTTOM_LEFT = 15;
+
+      // Nose, bottom center.
+      NOSE_BOTTOM_CENTER = 16;
+
+      // Left eye, top boundary.
+      LEFT_EYE_TOP_BOUNDARY = 17;
+
+      // Left eye, right corner.
+      LEFT_EYE_RIGHT_CORNER = 18;
+
+      // Left eye, bottom boundary.
+      LEFT_EYE_BOTTOM_BOUNDARY = 19;
+
+      // Left eye, left corner.
+      LEFT_EYE_LEFT_CORNER = 20;
+
+      // Right eye, top boundary.
+      RIGHT_EYE_TOP_BOUNDARY = 21;
+
+      // Right eye, right corner.
+      RIGHT_EYE_RIGHT_CORNER = 22;
+
+      // Right eye, bottom boundary.
+      RIGHT_EYE_BOTTOM_BOUNDARY = 23;
+
+      // Right eye, left corner.
+      RIGHT_EYE_LEFT_CORNER = 24;
+
+      // Left eyebrow, upper midpoint.
+      LEFT_EYEBROW_UPPER_MIDPOINT = 25;
+
+      // Right eyebrow, upper midpoint.
+      RIGHT_EYEBROW_UPPER_MIDPOINT = 26;
+
+      // Left ear tragion.
+      LEFT_EAR_TRAGION = 27;
+
+      // Right ear tragion.
+      RIGHT_EAR_TRAGION = 28;
+
+      // Left eye pupil.
+      LEFT_EYE_PUPIL = 29;
+
+      // Right eye pupil.
+      RIGHT_EYE_PUPIL = 30;
+
+      // Forehead glabella.
+      FOREHEAD_GLABELLA = 31;
+
+      // Chin gnathion.
+      CHIN_GNATHION = 32;
+
+      // Chin left gonion.
+      CHIN_LEFT_GONION = 33;
+
+      // Chin right gonion.
+      CHIN_RIGHT_GONION = 34;
+    }
+
+    // Face landmark type.
+    Type type = 3;
+
+    // Face landmark position.
+    Position position = 4;
+  }
+
+  // The bounding polygon around the face. The coordinates of the bounding box
+  // are in the original image's scale, as returned in `ImageParams`.
+  // The bounding box is computed to "frame" the face in accordance with human
+  // expectations. It is based on the landmarker results.
+  // Note that one or more x and/or y coordinates may not be generated in the
+  // `BoundingPoly` (the polygon will be unbounded) if only a partial face
+  // appears in the image to be annotated.
+  BoundingPoly bounding_poly = 1;
+
+  // The `fd_bounding_poly` bounding polygon is tighter than the
+  // `boundingPoly`, and encloses only the skin part of the face. Typically, it
+  // is used to eliminate the face from any image analysis that detects the
+  // "amount of skin" visible in an image. It is not based on the
+  // landmarker results, only on the initial face detection, hence
+  // the <code>fd</code> (face detection) prefix.
+  BoundingPoly fd_bounding_poly = 2;
+
+  // Detected face landmarks.
+  repeated Landmark landmarks = 3;
+
+  // Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
+  // of the face relative to the image vertical about the axis perpendicular to
+  // the face. Range [-180,180].
+  float roll_angle = 4;
+
+  // Yaw angle, which indicates the leftward/rightward angle that the face is
+  // pointing relative to the vertical plane perpendicular to the image. Range
+  // [-180,180].
+  float pan_angle = 5;
+
+  // Pitch angle, which indicates the upwards/downwards angle that the face is
+  // pointing relative to the image's horizontal plane. Range [-180,180].
+  float tilt_angle = 6;
+
+  // Detection confidence. Range [0, 1].
+  float detection_confidence = 7;
+
+  // Face landmarking confidence. Range [0, 1].
+  float landmarking_confidence = 8;
+
+  // Joy likelihood.
+  Likelihood joy_likelihood = 9;
+
+  // Sorrow likelihood.
+  Likelihood sorrow_likelihood = 10;
+
+  // Anger likelihood.
+  Likelihood anger_likelihood = 11;
+
+  // Surprise likelihood.
+  Likelihood surprise_likelihood = 12;
+
+  // Under-exposed likelihood.
+  Likelihood under_exposed_likelihood = 13;
+
+  // Blurred likelihood.
+  Likelihood blurred_likelihood = 14;
+
+  // Headwear likelihood.
+  Likelihood headwear_likelihood = 15;
+}
+
+// Detected entity location information.
+message LocationInfo {
+  // lat/long location coordinates.
+  google.type.LatLng lat_lng = 1;
+}
+
+// A `Property` consists of a user-supplied name/value pair.
+message Property {
+  // Name of the property.
+  string name = 1;
+
+  // Value of the property.
+  string value = 2;
+
+  // Value of numeric properties.
+  uint64 uint64_value = 3;
+}
+
+// Set of detected entity features.
+message EntityAnnotation {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string mid = 1;
+
+  // The language code for the locale in which the entity textual
+  // `description` is expressed.
+  string locale = 2;
+
+  // Entity textual description, expressed in its `locale` language.
+  string description = 3;
+
+  // Overall score of the result. Range [0, 1].
+  float score = 4;
+
+  // **Deprecated. Use `score` instead.**
+  // The accuracy of the entity detection in an image.
+  // For example, for an image in which the "Eiffel Tower" entity is detected,
+  // this field represents the confidence that there is a tower in the query
+  // image. Range [0, 1].
+  float confidence = 5;
+
+  // The relevancy of the ICA (Image Content Annotation) label to the
+  // image. For example, the relevancy of "tower" is likely higher to an image
+  // containing the detected "Eiffel Tower" than to an image containing a
+  // detected distant towering building, even though the confidence that
+  // there is a tower in each image may be the same. Range [0, 1].
+  float topicality = 6;
+
+  // Image region to which this entity belongs. Not produced
+  // for `LABEL_DETECTION` features.
+  BoundingPoly bounding_poly = 7;
+
+  // The location information for the detected entity. Multiple
+  // `LocationInfo` elements can be present because one location may
+  // indicate the location of the scene in the image, and another location
+  // may indicate the location of the place where the image was taken.
+  // Location information is usually present for landmarks.
+  repeated LocationInfo locations = 8;
+
+  // Some entities may have optional user-supplied `Property` (name/value)
+  // fields, such a score or string that qualifies the entity.
+  repeated Property properties = 9;
+}
+
+// Set of features pertaining to the image, computed by computer vision
+// methods over safe-search verticals (for example, adult, spoof, medical,
+// violence).
+message SafeSearchAnnotation {
+  // Represents the adult content likelihood for the image. Adult content may
+  // contain elements such as nudity, pornographic images or cartoons, or
+  // sexual activities.
+  Likelihood adult = 1;
+
+  // Spoof likelihood. The likelihood that an modification
+  // was made to the image's canonical version to make it appear
+  // funny or offensive.
+  Likelihood spoof = 2;
+
+  // Likelihood that this is a medical image.
+  Likelihood medical = 3;
+
+  // Likelihood that this image contains violent content.
+  Likelihood violence = 4;
+
+  // Likelihood that the request image contains racy content. Racy content may
+  // include (but is not limited to) skimpy or sheer clothing, strategically
+  // covered nudity, lewd or provocative poses, or close-ups of sensitive
+  // body areas.
+  Likelihood racy = 9;
+}
+
+// Rectangle determined by min and max `LatLng` pairs.
+message LatLongRect {
+  // Min lat/long pair.
+  google.type.LatLng min_lat_lng = 1;
+
+  // Max lat/long pair.
+  google.type.LatLng max_lat_lng = 2;
+}
+
+// Color information consists of RGB channels, score, and the fraction of
+// the image that the color occupies in the image.
+message ColorInfo {
+  // RGB components of the color.
+  google.type.Color color = 1;
+
+  // Image-specific score for this color. Value in range [0, 1].
+  float score = 2;
+
+  // The fraction of pixels the color occupies in the image.
+  // Value in range [0, 1].
+  float pixel_fraction = 3;
+}
+
+// Set of dominant colors and their corresponding scores.
+message DominantColorsAnnotation {
+  // RGB color values with their score and pixel fraction.
+  repeated ColorInfo colors = 1;
+}
+
+// Stores image properties, such as dominant colors.
+message ImageProperties {
+  // If present, dominant colors completed successfully.
+  DominantColorsAnnotation dominant_colors = 1;
+}
+
+// Single crop hint that is used to generate a new crop when serving an image.
+message CropHint {
+  // The bounding polygon for the crop region. The coordinates of the bounding
+  // box are in the original image's scale, as returned in `ImageParams`.
+  BoundingPoly bounding_poly = 1;
+
+  // Confidence of this being a salient region.  Range [0, 1].
+  float confidence = 2;
+
+  // Fraction of importance of this salient region with respect to the original
+  // image.
+  float importance_fraction = 3;
+}
+
+// Set of crop hints that are used to generate new crops when serving images.
+message CropHintsAnnotation {
+  // Crop hint results.
+  repeated CropHint crop_hints = 1;
+}
+
+// Parameters for crop hints annotation request.
+message CropHintsParams {
+  // Aspect ratios in floats, representing the ratio of the width to the height
+  // of the image. For example, if the desired aspect ratio is 4/3, the
+  // corresponding float value should be 1.33333.  If not specified, the
+  // best possible crop is returned. The number of provided aspect ratios is
+  // limited to a maximum of 16; any aspect ratios provided after the 16th are
+  // ignored.
+  repeated float aspect_ratios = 1;
+}
+
+// Parameters for web detection request.
+message WebDetectionParams {
+  // Whether to include results derived from the geo information in the image.
+  bool include_geo_results = 2;
+}
+
+// Image context and/or feature-specific parameters.
+message ImageContext {
+  // Not used.
+  LatLongRect lat_long_rect = 1;
+
+  // List of languages to use for TEXT_DETECTION. 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). Text detection returns an
+  // error if one or more of the specified languages is not one of the
+  // [supported languages](/vision/docs/languages).
+  repeated string language_hints = 2;
+
+  // Parameters for crop hints annotation request.
+  CropHintsParams crop_hints_params = 4;
+
+  // Parameters for web detection.
+  WebDetectionParams web_detection_params = 6;
+}
+
+// Request for performing Google Cloud Vision API tasks over a user-provided
+// image, with user-requested features.
+message AnnotateImageRequest {
+  // The image to be processed.
+  Image image = 1;
+
+  // Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image.
+  ImageContext image_context = 3;
+}
+
+// If an image was produced from a file (e.g. a PDF), this message gives
+// information about the source of that image.
+message ImageAnnotationContext {
+  // The URI of the file used to produce the image.
+  string uri = 1;
+
+  // If the file was a PDF or TIFF, this field gives the page number within
+  // the file used to produce the image.
+  int32 page_number = 2;
+}
+
+// Response to an image annotation request.
+message AnnotateImageResponse {
+  // If present, face detection has completed successfully.
+  repeated FaceAnnotation face_annotations = 1;
+
+  // If present, landmark detection has completed successfully.
+  repeated EntityAnnotation landmark_annotations = 2;
+
+  // If present, logo detection has completed successfully.
+  repeated EntityAnnotation logo_annotations = 3;
+
+  // If present, label detection has completed successfully.
+  repeated EntityAnnotation label_annotations = 4;
+
+  // If present, text (OCR) detection has completed successfully.
+  repeated EntityAnnotation text_annotations = 5;
+
+  // If present, text (OCR) detection or document (OCR) text detection has
+  // completed successfully.
+  // This annotation provides the structural hierarchy for the OCR detected
+  // text.
+  TextAnnotation full_text_annotation = 12;
+
+  // If present, safe-search annotation has completed successfully.
+  SafeSearchAnnotation safe_search_annotation = 6;
+
+  // If present, image properties were extracted successfully.
+  ImageProperties image_properties_annotation = 8;
+
+  // If present, crop hints have completed successfully.
+  CropHintsAnnotation crop_hints_annotation = 11;
+
+  // If present, web detection has completed successfully.
+  WebDetection web_detection = 13;
+
+  // If set, represents the error message for the operation.
+  // Note that filled-in image annotations are guaranteed to be
+  // correct, even when `error` is set.
+  google.rpc.Status error = 9;
+
+  // If present, contextual information is needed to understand where this image
+  // comes from.
+  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;
+}
+
+// Multiple image annotation requests are batched into a single service call.
+message BatchAnnotateImagesRequest {
+  // Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1;
+}
+
+// Response to a batch image annotation request.
+message BatchAnnotateImagesResponse {
+  // Individual responses to image annotation requests within the batch.
+  repeated AnnotateImageResponse responses = 1;
+}
+
+// An offline file annotation request.
+message AsyncAnnotateFileRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1;
+
+  // Required. Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image(s) in the file.
+  ImageContext image_context = 3;
+
+  // Required. The desired output location and metadata (e.g. format).
+  OutputConfig output_config = 4;
+}
+
+// The response for a single offline file annotation request.
+message AsyncAnnotateFileResponse {
+  // The output location and metadata from AsyncAnnotateFileRequest.
+  OutputConfig output_config = 1;
+}
+
+// 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;
+}
+
+// Response to an async batch file annotation request.
+message AsyncBatchAnnotateFilesResponse {
+  // The list of file annotation responses, one for each request in
+  // AsyncBatchAnnotateFilesRequest.
+  repeated AsyncAnnotateFileResponse responses = 1;
+}
+
+// The desired input location and metadata.
+message InputConfig {
+  // The Google Cloud Storage location to read the input from.
+  GcsSource gcs_source = 1;
+
+  // The type of the file. Currently only "application/pdf" and "image/tiff"
+  // are supported. Wildcards are not supported.
+  string mime_type = 2;
+}
+
+// The desired output location and metadata.
+message OutputConfig {
+  // The Google Cloud Storage location to write the output(s) to.
+  GcsDestination gcs_destination = 1;
+
+  // The max number of response protos to put into each output JSON file on GCS.
+  // The valid range is [1, 100]. If not specified, the default value is 20.
+  //
+  // For example, for one pdf file with 100 pages, 100 response protos will
+  // be generated. If `batch_size` = 20, then 5 json files each
+  // containing 20 response protos will be written under the prefix
+  // `gcs_destination`.`uri`.
+  //
+  // Currently, batch_size only applies to GcsDestination, with potential future
+  // support for other output configurations.
+  int32 batch_size = 2;
+}
+
+// The Google Cloud Storage location where the input will be read from.
+message GcsSource {
+  // Google Cloud Storage URI for the input file. This must only be a GCS
+  // object. Wildcards are not currently supported.
+  string uri = 1;
+}
+
+// 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 `/`.
+  //
+  // Examples:
+  //
+  // *    File: gs://bucket-name/filename.json
+  // *    Prefix: gs://bucket-name/prefix/here/
+  // *    File: gs://bucket-name/prefix/here
+  //
+  // If multiple outputs, each response is still AnnotateFileResponse, each of
+  // which contains some subset of the full list of AnnotateImageResponse.
+  // Multiple outputs can happen if, for example, the output JSON is too large
+  // and overflows into multiple sharded files.
+  string uri = 1;
+}
+
+// Contains metadata for the BatchAnnotateImages operation.
+message OperationMetadata {
+  // Batch operation states.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is received.
+    CREATED = 1;
+
+    // Request is actively being processed.
+    RUNNING = 2;
+
+    // The batch processing is done.
+    DONE = 3;
+
+    // The batch processing was cancelled.
+    CANCELLED = 4;
+  }
+
+  // Current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was received.
+  google.protobuf.Timestamp create_time = 5;
+
+  // The time when the operation result was last updated.
+  google.protobuf.Timestamp update_time = 6;
+}
+
+// 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;
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/image_annotator_pb2.py b/vision/google/cloud/vision_v1p2beta1/proto/image_annotator_pb2.py
new file mode 100644
index 000000000000..234e46f03634
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/image_annotator_pb2.py
@@ -0,0 +1,3929 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p2beta1/proto/image_annotator.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p2beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1p2beta1.proto import (
+    text_annotation_pb2 as google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_text__annotation__pb2,
+)
+from google.cloud.vision_v1p2beta1.proto import (
+    web_detection_pb2 as google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_web__detection__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.type import color_pb2 as google_dot_type_dot_color__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p2beta1/proto/image_annotator.proto",
+    package="google.cloud.vision.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p2beta1B\023ImageAnnotatorProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p2beta1/proto/image_annotator.proto\x12\x1dgoogle.cloud.vision.v1p2beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p2beta1/proto/geometry.proto\x1a\x39google/cloud/vision_v1p2beta1/proto/text_annotation.proto\x1a\x37google/cloud/vision_v1p2beta1/proto/web_detection.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x17google/type/color.proto\x1a\x18google/type/latlng.proto"\xe1\x02\n\x07\x46\x65\x61ture\x12\x39\n\x04type\x18\x01 \x01(\x0e\x32+.google.cloud.vision.v1p2beta1.Feature.Type\x12\x13\n\x0bmax_results\x18\x02 \x01(\x05\x12\r\n\x05model\x18\x03 \x01(\t"\xf6\x01\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x01\x12\x16\n\x12LANDMARK_DETECTION\x10\x02\x12\x12\n\x0eLOGO_DETECTION\x10\x03\x12\x13\n\x0fLABEL_DETECTION\x10\x04\x12\x12\n\x0eTEXT_DETECTION\x10\x05\x12\x1b\n\x17\x44OCUMENT_TEXT_DETECTION\x10\x0b\x12\x19\n\x15SAFE_SEARCH_DETECTION\x10\x06\x12\x14\n\x10IMAGE_PROPERTIES\x10\x07\x12\x0e\n\nCROP_HINTS\x10\t\x12\x11\n\rWEB_DETECTION\x10\n"7\n\x0bImageSource\x12\x15\n\rgcs_image_uri\x18\x01 \x01(\t\x12\x11\n\timage_uri\x18\x02 \x01(\t"T\n\x05Image\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\x0c\x12:\n\x06source\x18\x02 \x01(\x0b\x32*.google.cloud.vision.v1p2beta1.ImageSource"\x9b\x0e\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12\x45\n\x10\x66\x64_bounding_poly\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12I\n\tlandmarks\x18\x03 \x03(\x0b\x32\x36.google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark\x12\x12\n\nroll_angle\x18\x04 \x01(\x02\x12\x11\n\tpan_angle\x18\x05 \x01(\x02\x12\x12\n\ntilt_angle\x18\x06 \x01(\x02\x12\x1c\n\x14\x64\x65tection_confidence\x18\x07 \x01(\x02\x12\x1e\n\x16landmarking_confidence\x18\x08 \x01(\x02\x12\x41\n\x0ejoy_likelihood\x18\t \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x44\n\x11sorrow_likelihood\x18\n \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x43\n\x10\x61nger_likelihood\x18\x0b \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x46\n\x13surprise_likelihood\x18\x0c \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12K\n\x18under_exposed_likelihood\x18\r \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x45\n\x12\x62lurred_likelihood\x18\x0e \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x46\n\x13headwear_likelihood\x18\x0f \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x1a\xc7\x07\n\x08Landmark\x12I\n\x04type\x18\x03 \x01(\x0e\x32;.google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark.Type\x12\x39\n\x08position\x18\x04 \x01(\x0b\x32\'.google.cloud.vision.v1p2beta1.Position"\xb4\x06\n\x04Type\x12\x14\n\x10UNKNOWN_LANDMARK\x10\x00\x12\x0c\n\x08LEFT_EYE\x10\x01\x12\r\n\tRIGHT_EYE\x10\x02\x12\x18\n\x14LEFT_OF_LEFT_EYEBROW\x10\x03\x12\x19\n\x15RIGHT_OF_LEFT_EYEBROW\x10\x04\x12\x19\n\x15LEFT_OF_RIGHT_EYEBROW\x10\x05\x12\x1a\n\x16RIGHT_OF_RIGHT_EYEBROW\x10\x06\x12\x19\n\x15MIDPOINT_BETWEEN_EYES\x10\x07\x12\x0c\n\x08NOSE_TIP\x10\x08\x12\r\n\tUPPER_LIP\x10\t\x12\r\n\tLOWER_LIP\x10\n\x12\x0e\n\nMOUTH_LEFT\x10\x0b\x12\x0f\n\x0bMOUTH_RIGHT\x10\x0c\x12\x10\n\x0cMOUTH_CENTER\x10\r\x12\x15\n\x11NOSE_BOTTOM_RIGHT\x10\x0e\x12\x14\n\x10NOSE_BOTTOM_LEFT\x10\x0f\x12\x16\n\x12NOSE_BOTTOM_CENTER\x10\x10\x12\x19\n\x15LEFT_EYE_TOP_BOUNDARY\x10\x11\x12\x19\n\x15LEFT_EYE_RIGHT_CORNER\x10\x12\x12\x1c\n\x18LEFT_EYE_BOTTOM_BOUNDARY\x10\x13\x12\x18\n\x14LEFT_EYE_LEFT_CORNER\x10\x14\x12\x1a\n\x16RIGHT_EYE_TOP_BOUNDARY\x10\x15\x12\x1a\n\x16RIGHT_EYE_RIGHT_CORNER\x10\x16\x12\x1d\n\x19RIGHT_EYE_BOTTOM_BOUNDARY\x10\x17\x12\x19\n\x15RIGHT_EYE_LEFT_CORNER\x10\x18\x12\x1f\n\x1bLEFT_EYEBROW_UPPER_MIDPOINT\x10\x19\x12 \n\x1cRIGHT_EYEBROW_UPPER_MIDPOINT\x10\x1a\x12\x14\n\x10LEFT_EAR_TRAGION\x10\x1b\x12\x15\n\x11RIGHT_EAR_TRAGION\x10\x1c\x12\x12\n\x0eLEFT_EYE_PUPIL\x10\x1d\x12\x13\n\x0fRIGHT_EYE_PUPIL\x10\x1e\x12\x15\n\x11\x46OREHEAD_GLABELLA\x10\x1f\x12\x11\n\rCHIN_GNATHION\x10 \x12\x14\n\x10\x43HIN_LEFT_GONION\x10!\x12\x15\n\x11\x43HIN_RIGHT_GONION\x10""4\n\x0cLocationInfo\x12$\n\x07lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng"=\n\x08Property\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12\x14\n\x0cuint64_value\x18\x03 \x01(\x04"\xbc\x02\n\x10\x45ntityAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x0e\n\x06locale\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x12\n\nconfidence\x18\x05 \x01(\x02\x12\x12\n\ntopicality\x18\x06 \x01(\x02\x12\x42\n\rbounding_poly\x18\x07 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12>\n\tlocations\x18\x08 \x03(\x0b\x32+.google.cloud.vision.v1p2beta1.LocationInfo\x12;\n\nproperties\x18\t \x03(\x0b\x32\'.google.cloud.vision.v1p2beta1.Property"\xbc\x02\n\x14SafeSearchAnnotation\x12\x38\n\x05\x61\x64ult\x18\x01 \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x38\n\x05spoof\x18\x02 \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12:\n\x07medical\x18\x03 \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12;\n\x08violence\x18\x04 \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood\x12\x37\n\x04racy\x18\t \x01(\x0e\x32).google.cloud.vision.v1p2beta1.Likelihood"a\n\x0bLatLongRect\x12(\n\x0bmin_lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng\x12(\n\x0bmax_lat_lng\x18\x02 \x01(\x0b\x32\x13.google.type.LatLng"U\n\tColorInfo\x12!\n\x05\x63olor\x18\x01 \x01(\x0b\x32\x12.google.type.Color\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x16\n\x0epixel_fraction\x18\x03 \x01(\x02"T\n\x18\x44ominantColorsAnnotation\x12\x38\n\x06\x63olors\x18\x01 \x03(\x0b\x32(.google.cloud.vision.v1p2beta1.ColorInfo"c\n\x0fImageProperties\x12P\n\x0f\x64ominant_colors\x18\x01 \x01(\x0b\x32\x37.google.cloud.vision.v1p2beta1.DominantColorsAnnotation"\x7f\n\x08\x43ropHint\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x1b\n\x13importance_fraction\x18\x03 \x01(\x02"R\n\x13\x43ropHintsAnnotation\x12;\n\ncrop_hints\x18\x01 \x03(\x0b\x32\'.google.cloud.vision.v1p2beta1.CropHint"(\n\x0f\x43ropHintsParams\x12\x15\n\raspect_ratios\x18\x01 \x03(\x02"1\n\x12WebDetectionParams\x12\x1b\n\x13include_geo_results\x18\x02 \x01(\x08"\x85\x02\n\x0cImageContext\x12\x41\n\rlat_long_rect\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p2beta1.LatLongRect\x12\x16\n\x0elanguage_hints\x18\x02 \x03(\t\x12I\n\x11\x63rop_hints_params\x18\x04 \x01(\x0b\x32..google.cloud.vision.v1p2beta1.CropHintsParams\x12O\n\x14web_detection_params\x18\x06 \x01(\x0b\x32\x31.google.cloud.vision.v1p2beta1.WebDetectionParams"\xc9\x01\n\x14\x41nnotateImageRequest\x12\x33\n\x05image\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1p2beta1.Image\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p2beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.ImageContext":\n\x16ImageAnnotationContext\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\x13\n\x0bpage_number\x18\x02 \x01(\x05"\x8a\x07\n\x15\x41nnotateImageResponse\x12G\n\x10\x66\x61\x63\x65_annotations\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p2beta1.FaceAnnotation\x12M\n\x14landmark_annotations\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p2beta1.EntityAnnotation\x12I\n\x10logo_annotations\x18\x03 \x03(\x0b\x32/.google.cloud.vision.v1p2beta1.EntityAnnotation\x12J\n\x11label_annotations\x18\x04 \x03(\x0b\x32/.google.cloud.vision.v1p2beta1.EntityAnnotation\x12I\n\x10text_annotations\x18\x05 \x03(\x0b\x32/.google.cloud.vision.v1p2beta1.EntityAnnotation\x12K\n\x14\x66ull_text_annotation\x18\x0c \x01(\x0b\x32-.google.cloud.vision.v1p2beta1.TextAnnotation\x12S\n\x16safe_search_annotation\x18\x06 \x01(\x0b\x32\x33.google.cloud.vision.v1p2beta1.SafeSearchAnnotation\x12S\n\x1bimage_properties_annotation\x18\x08 \x01(\x0b\x32..google.cloud.vision.v1p2beta1.ImageProperties\x12Q\n\x15\x63rop_hints_annotation\x18\x0b \x01(\x0b\x32\x32.google.cloud.vision.v1p2beta1.CropHintsAnnotation\x12\x42\n\rweb_detection\x18\r \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.WebDetection\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status\x12\x46\n\x07\x63ontext\x18\x15 \x01(\x0b\x32\x35.google.cloud.vision.v1p2beta1.ImageAnnotationContext"\xa1\x01\n\x14\x41nnotateFileResponse\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p2beta1.InputConfig\x12G\n\tresponses\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.AnnotateImageResponse"c\n\x1a\x42\x61tchAnnotateImagesRequest\x12\x45\n\x08requests\x18\x01 \x03(\x0b\x32\x33.google.cloud.vision.v1p2beta1.AnnotateImageRequest"f\n\x1b\x42\x61tchAnnotateImagesResponse\x12G\n\tresponses\x18\x01 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.AnnotateImageResponse"\x9e\x02\n\x18\x41syncAnnotateFileRequest\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p2beta1.InputConfig\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p2beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.ImageContext\x12\x42\n\routput_config\x18\x04 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.OutputConfig"_\n\x19\x41syncAnnotateFileResponse\x12\x42\n\routput_config\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.OutputConfig"k\n\x1e\x41syncBatchAnnotateFilesRequest\x12I\n\x08requests\x18\x01 \x03(\x0b\x32\x37.google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest"n\n\x1f\x41syncBatchAnnotateFilesResponse\x12K\n\tresponses\x18\x01 \x03(\x0b\x32\x38.google.cloud.vision.v1p2beta1.AsyncAnnotateFileResponse"^\n\x0bInputConfig\x12<\n\ngcs_source\x18\x01 \x01(\x0b\x32(.google.cloud.vision.v1p2beta1.GcsSource\x12\x11\n\tmime_type\x18\x02 \x01(\t"j\n\x0cOutputConfig\x12\x46\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32-.google.cloud.vision.v1p2beta1.GcsDestination\x12\x12\n\nbatch_size\x18\x02 \x01(\x05"\x18\n\tGcsSource\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x1d\n\x0eGcsDestination\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x8f\x02\n\x11OperationMetadata\x12\x45\n\x05state\x18\x01 \x01(\x0e\x32\x36.google.cloud.vision.v1p2beta1.OperationMetadata.State\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Q\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x43REATED\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\r\n\tCANCELLED\x10\x04*e\n\nLikelihood\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xf0\x02\n\x0eImageAnnotator\x12\xb3\x01\n\x13\x42\x61tchAnnotateImages\x12\x39.google.cloud.vision.v1p2beta1.BatchAnnotateImagesRequest\x1a:.google.cloud.vision.v1p2beta1.BatchAnnotateImagesResponse"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p2beta1/images:annotate:\x01*\x12\xa7\x01\n\x17\x41syncBatchAnnotateFiles\x12=.google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesRequest\x1a\x1d.google.longrunning.Operation".\x82\xd3\xe4\x93\x02("#/v1p2beta1/files:asyncBatchAnnotate:\x01*B\x82\x01\n!com.google.cloud.vision.v1p2beta1B\x13ImageAnnotatorProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_text__annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_web__detection__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_type_dot_color__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.vision.v1p2beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7139,
+    serialized_end=7240,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+UNKNOWN = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_FEATURE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p2beta1.Feature.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LANDMARK_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGO_DETECTION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOCUMENT_TEXT_DETECTION",
+            index=6,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFE_SEARCH_DETECTION",
+            index=7,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_PROPERTIES",
+            index=8,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CROP_HINTS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEB_DETECTION",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=544,
+    serialized_end=790,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE_TYPE)
+
+_FACEANNOTATION_LANDMARK_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN_LANDMARK",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_LEFT_EYEBROW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_LEFT_EYEBROW",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_RIGHT_EYEBROW",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_RIGHT_EYEBROW",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDPOINT_BETWEEN_EYES",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_TIP", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_LIP", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOWER_LIP", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_LEFT", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_RIGHT", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_CENTER", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_RIGHT",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_LEFT",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_CENTER",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_TOP_BOUNDARY",
+            index=17,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_RIGHT_CORNER",
+            index=18,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_BOTTOM_BOUNDARY",
+            index=19,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_LEFT_CORNER",
+            index=20,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_TOP_BOUNDARY",
+            index=21,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_RIGHT_CORNER",
+            index=22,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_BOTTOM_BOUNDARY",
+            index=23,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_LEFT_CORNER",
+            index=24,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYEBROW_UPPER_MIDPOINT",
+            index=25,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYEBROW_UPPER_MIDPOINT",
+            index=26,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EAR_TRAGION",
+            index=27,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EAR_TRAGION",
+            index=28,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_PUPIL",
+            index=29,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_PUPIL",
+            index=30,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREHEAD_GLABELLA",
+            index=31,
+            number=31,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_GNATHION",
+            index=32,
+            number=32,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_LEFT_GONION",
+            index=33,
+            number=33,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_RIGHT_GONION",
+            index=34,
+            number=34,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1935,
+    serialized_end=2755,
+)
+_sym_db.RegisterEnumDescriptor(_FACEANNOTATION_LANDMARK_TYPE)
+
+_OPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1p2beta1.OperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7056,
+    serialized_end=7137,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATIONMETADATA_STATE)
+
+
+_FEATURE = _descriptor.Descriptor(
+    name="Feature",
+    full_name="google.cloud.vision.v1p2beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p2beta1.Feature.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_results",
+            full_name="google.cloud.vision.v1p2beta1.Feature.max_results",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.vision.v1p2beta1.Feature.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FEATURE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=437,
+    serialized_end=790,
+)
+
+
+_IMAGESOURCE = _descriptor.Descriptor(
+    name="ImageSource",
+    full_name="google.cloud.vision.v1p2beta1.ImageSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_image_uri",
+            full_name="google.cloud.vision.v1p2beta1.ImageSource.gcs_image_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.vision.v1p2beta1.ImageSource.image_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=792,
+    serialized_end=847,
+)
+
+
+_IMAGE = _descriptor.Descriptor(
+    name="Image",
+    full_name="google.cloud.vision.v1p2beta1.Image",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1p2beta1.Image.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1p2beta1.Image.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=849,
+    serialized_end=933,
+)
+
+
+_FACEANNOTATION_LANDMARK = _descriptor.Descriptor(
+    name="Landmark",
+    full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark.type",
+            index=0,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="position",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark.position",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FACEANNOTATION_LANDMARK_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1788,
+    serialized_end=2755,
+)
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.vision.v1p2beta1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fd_bounding_poly",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.fd_bounding_poly",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarks",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.landmarks",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roll_angle",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.roll_angle",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pan_angle",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.pan_angle",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tilt_angle",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.tilt_angle",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detection_confidence",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.detection_confidence",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarking_confidence",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.landmarking_confidence",
+            index=7,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="joy_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.joy_likelihood",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sorrow_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.sorrow_likelihood",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="anger_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.anger_likelihood",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surprise_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.surprise_likelihood",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="under_exposed_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.under_exposed_likelihood",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blurred_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.blurred_likelihood",
+            index=13,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headwear_likelihood",
+            full_name="google.cloud.vision.v1p2beta1.FaceAnnotation.headwear_likelihood",
+            index=14,
+            number=15,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FACEANNOTATION_LANDMARK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=936,
+    serialized_end=2755,
+)
+
+
+_LOCATIONINFO = _descriptor.Descriptor(
+    name="LocationInfo",
+    full_name="google.cloud.vision.v1p2beta1.LocationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.vision.v1p2beta1.LocationInfo.lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2757,
+    serialized_end=2809,
+)
+
+
+_PROPERTY = _descriptor.Descriptor(
+    name="Property",
+    full_name="google.cloud.vision.v1p2beta1.Property",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p2beta1.Property.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1p2beta1.Property.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uint64_value",
+            full_name="google.cloud.vision.v1p2beta1.Property.uint64_value",
+            index=2,
+            number=3,
+            type=4,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2811,
+    serialized_end=2872,
+)
+
+
+_ENTITYANNOTATION = _descriptor.Descriptor(
+    name="EntityAnnotation",
+    full_name="google.cloud.vision.v1p2beta1.EntityAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locale",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.locale",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topicality",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.topicality",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.bounding_poly",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.locations",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.vision.v1p2beta1.EntityAnnotation.properties",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2875,
+    serialized_end=3191,
+)
+
+
+_SAFESEARCHANNOTATION = _descriptor.Descriptor(
+    name="SafeSearchAnnotation",
+    full_name="google.cloud.vision.v1p2beta1.SafeSearchAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="adult",
+            full_name="google.cloud.vision.v1p2beta1.SafeSearchAnnotation.adult",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spoof",
+            full_name="google.cloud.vision.v1p2beta1.SafeSearchAnnotation.spoof",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="medical",
+            full_name="google.cloud.vision.v1p2beta1.SafeSearchAnnotation.medical",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violence",
+            full_name="google.cloud.vision.v1p2beta1.SafeSearchAnnotation.violence",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="racy",
+            full_name="google.cloud.vision.v1p2beta1.SafeSearchAnnotation.racy",
+            index=4,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3194,
+    serialized_end=3510,
+)
+
+
+_LATLONGRECT = _descriptor.Descriptor(
+    name="LatLongRect",
+    full_name="google.cloud.vision.v1p2beta1.LatLongRect",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_lat_lng",
+            full_name="google.cloud.vision.v1p2beta1.LatLongRect.min_lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_lat_lng",
+            full_name="google.cloud.vision.v1p2beta1.LatLongRect.max_lat_lng",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3512,
+    serialized_end=3609,
+)
+
+
+_COLORINFO = _descriptor.Descriptor(
+    name="ColorInfo",
+    full_name="google.cloud.vision.v1p2beta1.ColorInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="color",
+            full_name="google.cloud.vision.v1p2beta1.ColorInfo.color",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p2beta1.ColorInfo.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pixel_fraction",
+            full_name="google.cloud.vision.v1p2beta1.ColorInfo.pixel_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3611,
+    serialized_end=3696,
+)
+
+
+_DOMINANTCOLORSANNOTATION = _descriptor.Descriptor(
+    name="DominantColorsAnnotation",
+    full_name="google.cloud.vision.v1p2beta1.DominantColorsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="colors",
+            full_name="google.cloud.vision.v1p2beta1.DominantColorsAnnotation.colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3698,
+    serialized_end=3782,
+)
+
+
+_IMAGEPROPERTIES = _descriptor.Descriptor(
+    name="ImageProperties",
+    full_name="google.cloud.vision.v1p2beta1.ImageProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dominant_colors",
+            full_name="google.cloud.vision.v1p2beta1.ImageProperties.dominant_colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3784,
+    serialized_end=3883,
+)
+
+
+_CROPHINT = _descriptor.Descriptor(
+    name="CropHint",
+    full_name="google.cloud.vision.v1p2beta1.CropHint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p2beta1.CropHint.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.CropHint.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="importance_fraction",
+            full_name="google.cloud.vision.v1p2beta1.CropHint.importance_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3885,
+    serialized_end=4012,
+)
+
+
+_CROPHINTSANNOTATION = _descriptor.Descriptor(
+    name="CropHintsAnnotation",
+    full_name="google.cloud.vision.v1p2beta1.CropHintsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crop_hints",
+            full_name="google.cloud.vision.v1p2beta1.CropHintsAnnotation.crop_hints",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4014,
+    serialized_end=4096,
+)
+
+
+_CROPHINTSPARAMS = _descriptor.Descriptor(
+    name="CropHintsParams",
+    full_name="google.cloud.vision.v1p2beta1.CropHintsParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aspect_ratios",
+            full_name="google.cloud.vision.v1p2beta1.CropHintsParams.aspect_ratios",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4098,
+    serialized_end=4138,
+)
+
+
+_WEBDETECTIONPARAMS = _descriptor.Descriptor(
+    name="WebDetectionParams",
+    full_name="google.cloud.vision.v1p2beta1.WebDetectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="include_geo_results",
+            full_name="google.cloud.vision.v1p2beta1.WebDetectionParams.include_geo_results",
+            index=0,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4140,
+    serialized_end=4189,
+)
+
+
+_IMAGECONTEXT = _descriptor.Descriptor(
+    name="ImageContext",
+    full_name="google.cloud.vision.v1p2beta1.ImageContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_long_rect",
+            full_name="google.cloud.vision.v1p2beta1.ImageContext.lat_long_rect",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.vision.v1p2beta1.ImageContext.language_hints",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_params",
+            full_name="google.cloud.vision.v1p2beta1.ImageContext.crop_hints_params",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection_params",
+            full_name="google.cloud.vision.v1p2beta1.ImageContext.web_detection_params",
+            index=3,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4192,
+    serialized_end=4453,
+)
+
+
+_ANNOTATEIMAGEREQUEST = _descriptor.Descriptor(
+    name="AnnotateImageRequest",
+    full_name="google.cloud.vision.v1p2beta1.AnnotateImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageRequest.image",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4456,
+    serialized_end=4657,
+)
+
+
+_IMAGEANNOTATIONCONTEXT = _descriptor.Descriptor(
+    name="ImageAnnotationContext",
+    full_name="google.cloud.vision.v1p2beta1.ImageAnnotationContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p2beta1.ImageAnnotationContext.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_number",
+            full_name="google.cloud.vision.v1p2beta1.ImageAnnotationContext.page_number",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4659,
+    serialized_end=4717,
+)
+
+
+_ANNOTATEIMAGERESPONSE = _descriptor.Descriptor(
+    name="AnnotateImageResponse",
+    full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.face_annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmark_annotations",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.landmark_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logo_annotations",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.logo_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.text_annotations",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_text_annotation",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.full_text_annotation",
+            index=5,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_annotation",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.safe_search_annotation",
+            index=6,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_properties_annotation",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.image_properties_annotation",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_annotation",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.crop_hints_annotation",
+            index=8,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.web_detection",
+            index=9,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.error",
+            index=10,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateImageResponse.context",
+            index=11,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4720,
+    serialized_end=5626,
+)
+
+
+_ANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AnnotateFileResponse",
+    full_name="google.cloud.vision.v1p2beta1.AnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateFileResponse.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p2beta1.AnnotateFileResponse.responses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5629,
+    serialized_end=5790,
+)
+
+
+_BATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1p2beta1.BatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p2beta1.BatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5792,
+    serialized_end=5891,
+)
+
+
+_BATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1p2beta1.BatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p2beta1.BatchAnnotateImagesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5893,
+    serialized_end=5995,
+)
+
+
+_ASYNCANNOTATEFILEREQUEST = _descriptor.Descriptor(
+    name="AsyncAnnotateFileRequest",
+    full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest.output_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5998,
+    serialized_end=6284,
+)
+
+
+_ASYNCANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AsyncAnnotateFileResponse",
+    full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p2beta1.AsyncAnnotateFileResponse.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6286,
+    serialized_end=6381,
+)
+
+
+_ASYNCBATCHANNOTATEFILESREQUEST = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesRequest",
+    full_name="google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6383,
+    serialized_end=6490,
+)
+
+
+_ASYNCBATCHANNOTATEFILESRESPONSE = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesResponse",
+    full_name="google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6492,
+    serialized_end=6602,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.vision.v1p2beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1p2beta1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.vision.v1p2beta1.InputConfig.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6604,
+    serialized_end=6698,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.vision.v1p2beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.vision.v1p2beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="batch_size",
+            full_name="google.cloud.vision.v1p2beta1.OutputConfig.batch_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6700,
+    serialized_end=6806,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.vision.v1p2beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p2beta1.GcsSource.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6808,
+    serialized_end=6832,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.vision.v1p2beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p2beta1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6834,
+    serialized_end=6863,
+)
+
+
+_OPERATIONMETADATA = _descriptor.Descriptor(
+    name="OperationMetadata",
+    full_name="google.cloud.vision.v1p2beta1.OperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1p2beta1.OperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.vision.v1p2beta1.OperationMetadata.create_time",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.vision.v1p2beta1.OperationMetadata.update_time",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6866,
+    serialized_end=7137,
+)
+
+_FEATURE.fields_by_name["type"].enum_type = _FEATURE_TYPE
+_FEATURE_TYPE.containing_type = _FEATURE
+_IMAGE.fields_by_name["source"].message_type = _IMAGESOURCE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "type"
+].enum_type = _FACEANNOTATION_LANDMARK_TYPE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "position"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._POSITION
+)
+_FACEANNOTATION_LANDMARK.containing_type = _FACEANNOTATION
+_FACEANNOTATION_LANDMARK_TYPE.containing_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name[
+    "fd_bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name["landmarks"].message_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name["joy_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["sorrow_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["anger_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["surprise_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["under_exposed_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["blurred_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["headwear_likelihood"].enum_type = _LIKELIHOOD
+_LOCATIONINFO.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_ENTITYANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_ENTITYANNOTATION.fields_by_name["locations"].message_type = _LOCATIONINFO
+_ENTITYANNOTATION.fields_by_name["properties"].message_type = _PROPERTY
+_SAFESEARCHANNOTATION.fields_by_name["adult"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["spoof"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["medical"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["violence"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["racy"].enum_type = _LIKELIHOOD
+_LATLONGRECT.fields_by_name[
+    "min_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LATLONGRECT.fields_by_name[
+    "max_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_COLORINFO.fields_by_name["color"].message_type = google_dot_type_dot_color__pb2._COLOR
+_DOMINANTCOLORSANNOTATION.fields_by_name["colors"].message_type = _COLORINFO
+_IMAGEPROPERTIES.fields_by_name[
+    "dominant_colors"
+].message_type = _DOMINANTCOLORSANNOTATION
+_CROPHINT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CROPHINTSANNOTATION.fields_by_name["crop_hints"].message_type = _CROPHINT
+_IMAGECONTEXT.fields_by_name["lat_long_rect"].message_type = _LATLONGRECT
+_IMAGECONTEXT.fields_by_name["crop_hints_params"].message_type = _CROPHINTSPARAMS
+_IMAGECONTEXT.fields_by_name["web_detection_params"].message_type = _WEBDETECTIONPARAMS
+_ANNOTATEIMAGEREQUEST.fields_by_name["image"].message_type = _IMAGE
+_ANNOTATEIMAGEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEIMAGEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ANNOTATEIMAGERESPONSE.fields_by_name["face_annotations"].message_type = _FACEANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "landmark_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "logo_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "label_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "text_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "full_text_annotation"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_text__annotation__pb2._TEXTANNOTATION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "safe_search_annotation"
+].message_type = _SAFESEARCHANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "image_properties_annotation"
+].message_type = _IMAGEPROPERTIES
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "crop_hints_annotation"
+].message_type = _CROPHINTSANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "web_detection"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_web__detection__pb2._WEBDETECTION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEIMAGERESPONSE.fields_by_name["context"].message_type = _IMAGEANNOTATIONCONTEXT
+_ANNOTATEFILERESPONSE.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ANNOTATEFILERESPONSE.fields_by_name["responses"].message_type = _ANNOTATEIMAGERESPONSE
+_BATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_BATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEIMAGERESPONSE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCANNOTATEFILERESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEFILESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ASYNCANNOTATEFILEREQUEST
+_ASYNCBATCHANNOTATEFILESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ASYNCANNOTATEFILERESPONSE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OPERATIONMETADATA.fields_by_name["state"].enum_type = _OPERATIONMETADATA_STATE
+_OPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA_STATE.containing_type = _OPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.message_types_by_name["ImageSource"] = _IMAGESOURCE
+DESCRIPTOR.message_types_by_name["Image"] = _IMAGE
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["LocationInfo"] = _LOCATIONINFO
+DESCRIPTOR.message_types_by_name["Property"] = _PROPERTY
+DESCRIPTOR.message_types_by_name["EntityAnnotation"] = _ENTITYANNOTATION
+DESCRIPTOR.message_types_by_name["SafeSearchAnnotation"] = _SAFESEARCHANNOTATION
+DESCRIPTOR.message_types_by_name["LatLongRect"] = _LATLONGRECT
+DESCRIPTOR.message_types_by_name["ColorInfo"] = _COLORINFO
+DESCRIPTOR.message_types_by_name["DominantColorsAnnotation"] = _DOMINANTCOLORSANNOTATION
+DESCRIPTOR.message_types_by_name["ImageProperties"] = _IMAGEPROPERTIES
+DESCRIPTOR.message_types_by_name["CropHint"] = _CROPHINT
+DESCRIPTOR.message_types_by_name["CropHintsAnnotation"] = _CROPHINTSANNOTATION
+DESCRIPTOR.message_types_by_name["CropHintsParams"] = _CROPHINTSPARAMS
+DESCRIPTOR.message_types_by_name["WebDetectionParams"] = _WEBDETECTIONPARAMS
+DESCRIPTOR.message_types_by_name["ImageContext"] = _IMAGECONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageRequest"] = _ANNOTATEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["ImageAnnotationContext"] = _IMAGEANNOTATIONCONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageResponse"] = _ANNOTATEIMAGERESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateFileResponse"] = _ANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesRequest"
+] = _BATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesResponse"
+] = _BATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["AsyncAnnotateFileRequest"] = _ASYNCANNOTATEFILEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncAnnotateFileResponse"
+] = _ASYNCANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesRequest"
+] = _ASYNCBATCHANNOTATEFILESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesResponse"
+] = _ASYNCBATCHANNOTATEFILESRESPONSE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OperationMetadata"] = _OPERATIONMETADATA
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Feature = _reflection.GeneratedProtocolMessageType(
+    "Feature",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEATURE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""The type of Google Cloud Vision API detection to perform, and the
+  maximum number of results to return for that type. Multiple ``Feature``
+  objects can be specified in the ``features`` list.
+  
+  
+  Attributes:
+      type:
+          The feature type.
+      max_results:
+          Maximum number of results of this type. Does not apply to
+          ``TEXT_DETECTION``, ``DOCUMENT_TEXT_DETECTION``, or
+          ``CROP_HINTS``.
+      model:
+          Model to use for the feature. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Feature)
+    ),
+)
+_sym_db.RegisterMessage(Feature)
+
+ImageSource = _reflection.GeneratedProtocolMessageType(
+    "ImageSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGESOURCE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""External image source (Google Cloud Storage or web URL image location).
+  
+  
+  Attributes:
+      gcs_image_uri:
+          **Use ``image_uri`` instead.**  The 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.
+      image_uri:
+          The URI of the source image. Can be either:  1. A 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.  2. A publicly-accessible image HTTP/HTTPS URL.
+          When fetching images from    HTTP/HTTPS URLs, Google cannot
+          guarantee that the request will be    completed. Your request
+          may fail if the specified host denies the    request (e.g. due
+          to request throttling or DOS prevention), or if    Google
+          throttles requests to the site for abuse prevention. You
+          should not depend on externally-hosted images for production
+          applications.  When both ``gcs_image_uri`` and ``image_uri``
+          are specified, ``image_uri`` takes precedence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.ImageSource)
+    ),
+)
+_sym_db.RegisterMessage(ImageSource)
+
+Image = _reflection.GeneratedProtocolMessageType(
+    "Image",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Client image to perform Google Cloud Vision API tasks over.
+  
+  
+  Attributes:
+      content:
+          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.
+      source:
+          Google Cloud Storage image location, or publicly-accessible
+          image URL. If both ``content`` and ``source`` are provided for
+          an image, ``content`` takes precedence and is used to perform
+          the image annotation request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Image)
+    ),
+)
+_sym_db.RegisterMessage(Image)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        Landmark=_reflection.GeneratedProtocolMessageType(
+            "Landmark",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FACEANNOTATION_LANDMARK,
+                __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+                __doc__="""A face-specific landmark (for example, a face feature).
+    
+    
+    Attributes:
+        type:
+            Face landmark type.
+        position:
+            Face landmark position.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.FaceAnnotation.Landmark)
+            ),
+        ),
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""A face annotation object contains the results of face detection.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the face. The coordinates of the
+          bounding box are in the original image's scale, as returned in
+          ``ImageParams``. The bounding box is computed to "frame" the
+          face in accordance with human expectations. It is based on the
+          landmarker results. Note that one or more x and/or y
+          coordinates may not be generated in the ``BoundingPoly`` (the
+          polygon will be unbounded) if only a partial face appears in
+          the image to be annotated.
+      fd_bounding_poly:
+          The ``fd_bounding_poly`` bounding polygon is tighter than the
+          ``boundingPoly``, and encloses only the skin part of the face.
+          Typically, it is used to eliminate the face from any image
+          analysis that detects the "amount of skin" visible in an
+          image. It is not based on the landmarker results, only on the
+          initial face detection, hence the fd (face detection) prefix.
+      landmarks:
+          Detected face landmarks.
+      roll_angle:
+          Roll angle, which indicates the amount of clockwise/anti-
+          clockwise rotation of the face relative to the image vertical
+          about the axis perpendicular to the face. Range [-180,180].
+      pan_angle:
+          Yaw angle, which indicates the leftward/rightward angle that
+          the face is pointing relative to the vertical plane
+          perpendicular to the image. Range [-180,180].
+      tilt_angle:
+          Pitch angle, which indicates the upwards/downwards angle that
+          the face is pointing relative to the image's horizontal plane.
+          Range [-180,180].
+      detection_confidence:
+          Detection confidence. Range [0, 1].
+      landmarking_confidence:
+          Face landmarking confidence. Range [0, 1].
+      joy_likelihood:
+          Joy likelihood.
+      sorrow_likelihood:
+          Sorrow likelihood.
+      anger_likelihood:
+          Anger likelihood.
+      surprise_likelihood:
+          Surprise likelihood.
+      under_exposed_likelihood:
+          Under-exposed likelihood.
+      blurred_likelihood:
+          Blurred likelihood.
+      headwear_likelihood:
+          Headwear likelihood.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+_sym_db.RegisterMessage(FaceAnnotation.Landmark)
+
+LocationInfo = _reflection.GeneratedProtocolMessageType(
+    "LocationInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONINFO,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Detected entity location information.
+  
+  
+  Attributes:
+      lat_lng:
+          lat/long location coordinates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.LocationInfo)
+    ),
+)
+_sym_db.RegisterMessage(LocationInfo)
+
+Property = _reflection.GeneratedProtocolMessageType(
+    "Property",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTY,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""A ``Property`` consists of a user-supplied name/value pair.
+  
+  
+  Attributes:
+      name:
+          Name of the property.
+      value:
+          Value of the property.
+      uint64_value:
+          Value of numeric properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Property)
+    ),
+)
+_sym_db.RegisterMessage(Property)
+
+EntityAnnotation = _reflection.GeneratedProtocolMessageType(
+    "EntityAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYANNOTATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Set of detected entity features.
+  
+  
+  Attributes:
+      mid:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      locale:
+          The language code for the locale in which the entity textual
+          ``description`` is expressed.
+      description:
+          Entity textual description, expressed in its ``locale``
+          language.
+      score:
+          Overall score of the result. Range [0, 1].
+      confidence:
+          **Deprecated. Use ``score`` instead.** The accuracy of the
+          entity detection in an image. For example, for an image in
+          which the "Eiffel Tower" entity is detected, this field
+          represents the confidence that there is a tower in the query
+          image. Range [0, 1].
+      topicality:
+          The relevancy of the ICA (Image Content Annotation) label to
+          the image. For example, the relevancy of "tower" is likely
+          higher to an image containing the detected "Eiffel Tower" than
+          to an image containing a detected distant towering building,
+          even though the confidence that there is a tower in each image
+          may be the same. Range [0, 1].
+      bounding_poly:
+          Image region to which this entity belongs. Not produced for
+          ``LABEL_DETECTION`` features.
+      locations:
+          The location information for the detected entity. Multiple
+          ``LocationInfo`` elements can be present because one location
+          may indicate the location of the scene in the image, and
+          another location may indicate the location of the place where
+          the image was taken. Location information is usually present
+          for landmarks.
+      properties:
+          Some entities may have optional user-supplied ``Property``
+          (name/value) fields, such a score or string that qualifies the
+          entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.EntityAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(EntityAnnotation)
+
+SafeSearchAnnotation = _reflection.GeneratedProtocolMessageType(
+    "SafeSearchAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAFESEARCHANNOTATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Set of features pertaining to the image, computed by computer vision
+  methods over safe-search verticals (for example, adult, spoof, medical,
+  violence).
+  
+  
+  Attributes:
+      adult:
+          Represents the adult content likelihood for the image. Adult
+          content may contain elements such as nudity, pornographic
+          images or cartoons, or sexual activities.
+      spoof:
+          Spoof likelihood. The likelihood that an modification was made
+          to the image's canonical version to make it appear funny or
+          offensive.
+      medical:
+          Likelihood that this is a medical image.
+      violence:
+          Likelihood that this image contains violent content.
+      racy:
+          Likelihood that the request image contains racy content. Racy
+          content may include (but is not limited to) skimpy or sheer
+          clothing, strategically covered nudity, lewd or provocative
+          poses, or close-ups of sensitive body areas.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.SafeSearchAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(SafeSearchAnnotation)
+
+LatLongRect = _reflection.GeneratedProtocolMessageType(
+    "LatLongRect",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LATLONGRECT,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Rectangle determined by min and max ``LatLng`` pairs.
+  
+  
+  Attributes:
+      min_lat_lng:
+          Min lat/long pair.
+      max_lat_lng:
+          Max lat/long pair.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.LatLongRect)
+    ),
+)
+_sym_db.RegisterMessage(LatLongRect)
+
+ColorInfo = _reflection.GeneratedProtocolMessageType(
+    "ColorInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLORINFO,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Color information consists of RGB channels, score, and the fraction of
+  the image that the color occupies in the image.
+  
+  
+  Attributes:
+      color:
+          RGB components of the color.
+      score:
+          Image-specific score for this color. Value in range [0, 1].
+      pixel_fraction:
+          The fraction of pixels the color occupies in the image. Value
+          in range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.ColorInfo)
+    ),
+)
+_sym_db.RegisterMessage(ColorInfo)
+
+DominantColorsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "DominantColorsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOMINANTCOLORSANNOTATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Set of dominant colors and their corresponding scores.
+  
+  
+  Attributes:
+      colors:
+          RGB color values with their score and pixel fraction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.DominantColorsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(DominantColorsAnnotation)
+
+ImageProperties = _reflection.GeneratedProtocolMessageType(
+    "ImageProperties",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPROPERTIES,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Stores image properties, such as dominant colors.
+  
+  
+  Attributes:
+      dominant_colors:
+          If present, dominant colors completed successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.ImageProperties)
+    ),
+)
+_sym_db.RegisterMessage(ImageProperties)
+
+CropHint = _reflection.GeneratedProtocolMessageType(
+    "CropHint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINT,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Single crop hint that is used to generate a new crop when serving an
+  image.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon for the crop region. The coordinates of
+          the bounding box are in the original image's scale, as
+          returned in ``ImageParams``.
+      confidence:
+          Confidence of this being a salient region. Range [0, 1].
+      importance_fraction:
+          Fraction of importance of this salient region with respect to
+          the original image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.CropHint)
+    ),
+)
+_sym_db.RegisterMessage(CropHint)
+
+CropHintsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "CropHintsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSANNOTATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Set of crop hints that are used to generate new crops when serving
+  images.
+  
+  
+  Attributes:
+      crop_hints:
+          Crop hint results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.CropHintsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsAnnotation)
+
+CropHintsParams = _reflection.GeneratedProtocolMessageType(
+    "CropHintsParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSPARAMS,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for crop hints annotation request.
+  
+  
+  Attributes:
+      aspect_ratios:
+          Aspect ratios in floats, representing the ratio of the width
+          to the height of the image. For example, if the desired aspect
+          ratio is 4/3, the corresponding float value should be 1.33333.
+          If not specified, the best possible crop is returned. The
+          number of provided aspect ratios is limited to a maximum of
+          16; any aspect ratios provided after the 16th are ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.CropHintsParams)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsParams)
+
+WebDetectionParams = _reflection.GeneratedProtocolMessageType(
+    "WebDetectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WEBDETECTIONPARAMS,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for web detection request.
+  
+  
+  Attributes:
+      include_geo_results:
+          Whether to include results derived from the geo information in
+          the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.WebDetectionParams)
+    ),
+)
+_sym_db.RegisterMessage(WebDetectionParams)
+
+ImageContext = _reflection.GeneratedProtocolMessageType(
+    "ImageContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECONTEXT,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Image context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      lat_long_rect:
+          Not used.
+      language_hints:
+          List of languages to use for TEXT\_DETECTION. 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). Text
+          detection returns an error if one or more of the specified
+          languages is not one of the `supported languages
+          </vision/docs/languages>`__.
+      crop_hints_params:
+          Parameters for crop hints annotation request.
+      web_detection_params:
+          Parameters for web detection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.ImageContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageContext)
+
+AnnotateImageRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Request for performing Google Cloud Vision API tasks over a
+  user-provided image, with user-requested features.
+  
+  
+  Attributes:
+      image:
+          The image to be processed.
+      features:
+          Requested features.
+      image_context:
+          Additional context that may accompany the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AnnotateImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageRequest)
+
+ImageAnnotationContext = _reflection.GeneratedProtocolMessageType(
+    "ImageAnnotationContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEANNOTATIONCONTEXT,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""If an image was produced from a file (e.g. a PDF), this message gives
+  information about the source of that image.
+  
+  
+  Attributes:
+      uri:
+          The URI of the file used to produce the image.
+      page_number:
+          If the file was a PDF or TIFF, this field gives the page
+          number within the file used to produce the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.ImageAnnotationContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageAnnotationContext)
+
+AnnotateImageResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGERESPONSE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an image annotation request.
+  
+  
+  Attributes:
+      face_annotations:
+          If present, face detection has completed successfully.
+      landmark_annotations:
+          If present, landmark detection has completed successfully.
+      logo_annotations:
+          If present, logo detection has completed successfully.
+      label_annotations:
+          If present, label detection has completed successfully.
+      text_annotations:
+          If present, text (OCR) detection has completed successfully.
+      full_text_annotation:
+          If present, text (OCR) detection or document (OCR) text
+          detection has completed successfully. This annotation provides
+          the structural hierarchy for the OCR detected text.
+      safe_search_annotation:
+          If present, safe-search annotation has completed successfully.
+      image_properties_annotation:
+          If present, image properties were extracted successfully.
+      crop_hints_annotation:
+          If present, crop hints have completed successfully.
+      web_detection:
+          If present, web detection has completed successfully.
+      error:
+          If set, represents the error message for the operation. Note
+          that filled-in image annotations are guaranteed to be correct,
+          even when ``error`` is set.
+      context:
+          If present, contextual information is needed to understand
+          where this image comes from.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AnnotateImageResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageResponse)
+
+AnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a single file annotation request. A file may contain one or
+  more images, which individually have their own responses.
+  
+  
+  Attributes:
+      input_config:
+          Information about the file for which this response is
+          generated.
+      responses:
+          Individual responses to images found within the file.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateFileResponse)
+
+BatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple image annotation requests are batched into a single service
+  call.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.BatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesRequest)
+
+BatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a batch image annotation request.
+  
+  
+  Attributes:
+      responses:
+          Individual responses to image annotation requests within the
+          batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.BatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesResponse)
+
+AsyncAnnotateFileRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILEREQUEST,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""An offline file annotation request.
+  
+  
+  Attributes:
+      input_config:
+          Required. Information about the input file.
+      features:
+          Required. Requested features.
+      image_context:
+          Additional context that may accompany the image(s) in the
+          file.
+      output_config:
+          Required. The desired output location and metadata (e.g.
+          format).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AsyncAnnotateFileRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileRequest)
+
+AsyncAnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""The response for a single offline file annotation request.
+  
+  
+  Attributes:
+      output_config:
+          The output location and metadata from
+          AsyncAnnotateFileRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AsyncAnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileResponse)
+
+AsyncBatchAnnotateFilesRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESREQUEST,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple async file annotation requests are batched into a single
+  service call.
+  
+  
+  Attributes:
+      requests:
+          Individual async file annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesRequest)
+
+AsyncBatchAnnotateFilesResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESRESPONSE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an async batch file annotation request.
+  
+  
+  Attributes:
+      responses:
+          The list of file annotation responses, one for each request in
+          AsyncBatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesResponse)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""The desired input location and metadata.
+  
+  
+  Attributes:
+      gcs_source:
+          The Google Cloud Storage location to read the input from.
+      mime_type:
+          The type of the file. Currently only "application/pdf" and
+          "image/tiff" are supported. Wildcards are not supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""The desired output location and metadata.
+  
+  
+  Attributes:
+      gcs_destination:
+          The Google Cloud Storage location to write the output(s) to.
+      batch_size:
+          The max number of response protos to put into each output JSON
+          file on GCS. The valid range is [1, 100]. If not specified,
+          the default value is 20.  For example, for one pdf file with
+          100 pages, 100 response protos will be generated. If
+          ``batch_size`` = 20, then 5 json files each containing 20
+          response protos will be written under the prefix
+          ``gcs_destination``.\ ``uri``.  Currently, batch\_size only
+          applies to GcsDestination, with potential future support for
+          other output configurations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the input will be read from.
+  
+  
+  Attributes:
+      uri:
+          Google Cloud Storage URI for the input file. This must only be
+          a GCS object. Wildcards are not currently supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the output will be written to.
+  
+  
+  Attributes:
+      uri:
+          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 ``/``.  Examples:  -  File: gs://bucket-
+          name/filename.json -  Prefix: gs://bucket-name/prefix/here/ -
+          File: gs://bucket-name/prefix/here  If multiple outputs, each
+          response is still AnnotateFileResponse, each of which contains
+          some subset of the full list of AnnotateImageResponse.
+          Multiple outputs can happen if, for example, the output JSON
+          is too large and overflows into multiple sharded files.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATIONMETADATA,
+        __module__="google.cloud.vision_v1p2beta1.proto.image_annotator_pb2",
+        __doc__="""Contains metadata for the BatchAnnotateImages operation.
+  
+  
+  Attributes:
+      state:
+          Current state of the batch operation.
+      create_time:
+          The time when the batch request was received.
+      update_time:
+          The time when the operation result was last updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.OperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperationMetadata)
+
+
+DESCRIPTOR._options = None
+
+_IMAGEANNOTATOR = _descriptor.ServiceDescriptor(
+    name="ImageAnnotator",
+    full_name="google.cloud.vision.v1p2beta1.ImageAnnotator",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=7243,
+    serialized_end=7611,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateImages",
+            full_name="google.cloud.vision.v1p2beta1.ImageAnnotator.BatchAnnotateImages",
+            index=0,
+            containing_service=None,
+            input_type=_BATCHANNOTATEIMAGESREQUEST,
+            output_type=_BATCHANNOTATEIMAGESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p2beta1/images:annotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsyncBatchAnnotateFiles",
+            full_name="google.cloud.vision.v1p2beta1.ImageAnnotator.AsyncBatchAnnotateFiles",
+            index=1,
+            containing_service=None,
+            input_type=_ASYNCBATCHANNOTATEFILESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002("#/v1p2beta1/files:asyncBatchAnnotate:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_IMAGEANNOTATOR)
+
+DESCRIPTOR.services_by_name["ImageAnnotator"] = _IMAGEANNOTATOR
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/image_annotator_pb2_grpc.py b/vision/google/cloud/vision_v1p2beta1/proto/image_annotator_pb2_grpc.py
new file mode 100644
index 000000000000..9fb214587c2a
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/image_annotator_pb2_grpc.py
@@ -0,0 +1,78 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1p2beta1.proto import (
+    image_annotator_pb2 as google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class ImageAnnotatorStub(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.BatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1p2beta1.ImageAnnotator/BatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.FromString,
+        )
+        self.AsyncBatchAnnotateFiles = channel.unary_unary(
+            "/google.cloud.vision.v1p2beta1.ImageAnnotator/AsyncBatchAnnotateFiles",
+            request_serializer=google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ImageAnnotatorServicer(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def BatchAnnotateImages(self, request, context):
+        """Run image detection and annotation for a batch of images.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsyncBatchAnnotateFiles(self, request, context):
+        """Run async image detection and annotation for a list of generic files (e.g.
+    PDF) which may contain multiple pages and multiple images per page.
+    Progress and results can be retrieved through the
+    `google.longrunning.Operations` interface.
+    `Operation.metadata` contains `OperationMetadata` (metadata).
+    `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ImageAnnotatorServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "BatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.SerializeToString,
+        ),
+        "AsyncBatchAnnotateFiles": grpc.unary_unary_rpc_method_handler(
+            servicer.AsyncBatchAnnotateFiles,
+            request_deserializer=google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1p2beta1.ImageAnnotator", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/product_search.proto b/vision/google/cloud/vision_v1p2beta1/proto/product_search.proto
new file mode 100644
index 000000000000..85e4e0784e1c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/product_search.proto
@@ -0,0 +1,161 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/cloud/vision/v1p3beta1/product_search_service.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+
+// Parameters for a product search request.
+message ProductSearchParams {
+  // The resource name of the catalog to search.
+  //
+  // Format is: `productSearch/catalogs/CATALOG_NAME`.
+  string catalog_name = 1;
+
+  // The category to search in.
+  // Optional. It is inferred by the system if it is not specified.
+  // [Deprecated] Use `product_category`.
+  ProductSearchCategory category = 2;
+
+  // The product category to search in.
+  // Optional. It is inferred by the system if it is not specified.
+  // Supported values are `bag`, `shoe`, `sunglasses`, `dress`, `outerwear`,
+  // `skirt`, `top`, `shorts`, and `pants`.
+  string product_category = 5;
+
+  // The bounding polygon around the area of interest in the image.
+  // Optional. If it is not specified, system discretion will be applied.
+  // [Deprecated] Use `bounding_poly`.
+  NormalizedBoundingPoly normalized_bounding_poly = 3;
+
+  // The bounding polygon around the area of interest in the image.
+  // Optional. If it is not specified, system discretion will be applied.
+  BoundingPoly bounding_poly = 9;
+
+  // Specifies the verbosity of the  product search results.
+  // Optional. Defaults to `BASIC`.
+  ProductSearchResultsView view = 4;
+
+  // The resource name of a [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] to be searched for similar images.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  string product_set = 6;
+
+  // The list of product categories to search in. Currently, we only consider
+  // the first category, and either "homegoods" or "apparel" should be
+  // specified.
+  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.
+  //
+  // For example, "(color = red OR color = blue) AND brand = Google" is
+  // acceptable, but not "(color = red OR brand = Google)" or "color: red".
+  string filter = 8;
+}
+
+// Results for a product search request.
+message ProductSearchResults {
+  // Information about a product.
+  message ProductInfo {
+    // Product ID.
+    string product_id = 1;
+
+    // The URI of the image which matched the query image.
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    string image_uri = 2;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    float score = 3;
+  }
+
+  // Information about a product.
+  message Result {
+    // The Product.
+    Product product = 1;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    float score = 2;
+
+    // The resource name of the image from the product that is the closest match
+    // to the query.
+    string image = 3;
+  }
+
+  // Product category.
+  // [Deprecated] Use `product_category`.
+  ProductSearchCategory category = 1;
+
+  // Product category.
+  // Supported values are `bag` and `shoe`.
+  // [Deprecated] `product_category` is provided in each Product.
+  string product_category = 4;
+
+  // Timestamp of the index which provided these results. Changes made after
+  // this time are not reflected in the current results.
+  google.protobuf.Timestamp index_time = 2;
+
+  // List of detected products.
+  repeated ProductInfo products = 3;
+
+  // List of results, one for each product match.
+  repeated Result results = 5;
+}
+
+// Supported product search categories.
+enum ProductSearchCategory {
+  // Default value used when a category is not specified.
+  PRODUCT_SEARCH_CATEGORY_UNSPECIFIED = 0;
+
+  // Shoes category.
+  SHOES = 1;
+
+  // Bags category.
+  BAGS = 2;
+}
+
+// Specifies the fields to include in product search results.
+enum ProductSearchResultsView {
+  // Product search results contain only `product_category` and `product_id`.
+  // Default value.
+  BASIC = 0;
+
+  // Product search results contain `product_category`, `product_id`,
+  // `image_uri`, and `score`.
+  FULL = 1;
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/product_search_service.proto b/vision/google/cloud/vision_v1p2beta1/proto/product_search_service.proto
new file mode 100644
index 000000000000..90388e36e228
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/product_search_service.proto
@@ -0,0 +1,825 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/longrunning/operations.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;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchServiceProto";
+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
+// `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
+//   `projects/*/locations/*/products/*`
+//
+// - 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 {
+  // Creates and returns a new ProductSet resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+  //   4096 characters.
+  rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+      body: "product_set"
+    };
+  }
+
+  // Lists ProductSets in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+  //   than 1.
+  rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+    };
+  }
+
+  // Gets information associated with a ProductSet.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  rpc GetProductSet(GetProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Makes changes to a ProductSet resource.
+  // Only display_name can be updated currently.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+  //   missing from the request or longer than 4096 characters.
+  rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      patch: "/v1p3beta1/{product_set.name=projects/*/locations/*/productSets/*}"
+      body: "product_set"
+    };
+  }
+
+  // Permanently deletes a ProductSet. All Products and ReferenceImages in the
+  // ProductSet will be 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: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Creates and returns a new product resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+  rpc CreateProduct(CreateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/products"
+      body: "product"
+    };
+  }
+
+  // Lists products in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*}/products"
+    };
+  }
+
+  // Gets information associated with a Product.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  rpc GetProduct(GetProductRequest) returns (Product) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Makes changes to a Product resource.
+  // Only display_name, description and labels can be updated right now.
+  //
+  // If labels are updated, the change will not be reflected in queries until
+  // the next index time.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+  //   missing from the request or longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if description is present in update_mask but is
+  //   longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+  rpc UpdateProduct(UpdateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      patch: "/v1p3beta1/{product.name=projects/*/locations/*/products/*}"
+      body: "product"
+    };
+  }
+
+  // Permanently deletes a product and its reference images.
+  //
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Creates and returns a new ReferenceImage resource.
+  //
+  // The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+  // the system will try to detect regions of interest in the image that are
+  // compatible with the product_category on the parent product. If it is
+  // specified, detection is ALWAYS skipped. The system converts polygons into
+  // non-rotated rectangles.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 50MP).
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if the product does not exist.
+  // * 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) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+      body: "reference_image"
+    };
+  }
+
+  // Permanently deletes a reference image.
+  //
+  // The image metadata will be deleted right away, but search queries
+  // against ProductSets containing the image may still work until all related
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Lists reference images.
+  //
+  // Possible errors:
+  //
+  // * 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) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+    };
+  }
+
+  // Gets information associated with a ReferenceImage.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the specified image does not exist.
+  rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Adds a Product to the specified ProductSet. If the Product is already
+  // present, no change is made.
+  //
+  // One Product can be added to at most 100 ProductSets.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+  rpc AddProductToProductSet(AddProductToProductSetRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:addProduct"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:removeProduct"
+      body: "*"
+    };
+  }
+
+  // Lists the Products in a ProductSet, in an unspecified order. If the
+  // ProductSet does not exist, the products field of the response will be
+  // empty.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProductsInProductSet(ListProductsInProductSetRequest) returns (ListProductsInProductSetResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}/products"
+    };
+  }
+
+  // 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.
+  // `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.v1p3beta1.ImportProductSetsGcsSource.csv_file_uri].
+  rpc ImportProductSets(ImportProductSetsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets:import"
+      body: "*"
+    };
+  }
+}
+
+// A Product contains ReferenceImages.
+message 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
+    // exceed 128 bytes.
+    string key = 1;
+
+    // The value of the label attached to the product. Cannot be empty and
+    // cannot exceed 128 bytes.
+    string value = 2;
+  }
+
+  // The resource name of the product.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  //
+  // This field is ignored when creating a product.
+  string name = 1;
+
+  // The user-provided name for this Product. Must not be empty. Must be at most
+  // 4096 characters long.
+  string display_name = 2;
+
+  // User-provided metadata to be stored with this product. Must be at most 4096
+  // 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;
+
+  // Key-value pairs that can be attached to a product. At query time,
+  // constraints can be specified based on the product_labels.
+  //
+  // Note that integer values can be provided as strings, e.g. "1199". Only
+  // strings with integer values can match a range-based restriction which is
+  // to be supported soon.
+  //
+  // Multiple values can be assigned to the same key. One product may have up to
+  // 100 product_labels.
+  repeated KeyValue product_labels = 5;
+}
+
+// A ProductSet contains Products. A ProductSet can contain a maximum of 1
+// million reference images. If the limit is exceeded, periodic indexing will
+// fail.
+message ProductSet {
+  // The resource name of the ProductSet.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  //
+  // This field is ignored when creating a ProductSet.
+  string name = 1;
+
+  // The user-provided name for this ProductSet. Must not be empty. Must be at
+  // most 4096 characters long.
+  string display_name = 2;
+
+  // Output only. The time at which this ProductSet was last indexed. Query
+  // results will reflect all updates before this time. If this ProductSet has
+  // never been indexed, this field is 0.
+  //
+  // This field is ignored when creating a ProductSet.
+  google.protobuf.Timestamp index_time = 3;
+
+  // 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;
+}
+
+// A `ReferenceImage` represents a product image and its associated metadata,
+// such as bounding boxes.
+message ReferenceImage {
+  // The resource name of the reference image.
+  //
+  // Format is:
+  //
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
+  //
+  // This field is ignored when creating a reference image.
+  string name = 1;
+
+  // The Google Cloud Storage URI of the reference image.
+  //
+  // The URI must start with `gs://`.
+  //
+  // Required.
+  string uri = 2;
+
+  // 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
+  // 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;
+}
+
+// Request message for the `CreateProduct` method.
+message CreateProductRequest {
+  // The project in which the Product should be created.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The product to create.
+  Product product = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_id = 3;
+}
+
+// Request message for the `ListProducts` method.
+message ListProductsRequest {
+  // The project OR ProductSet from which Products should be listed.
+  //
+  // Format:
+  // `projects/PROJECT_ID/locations/LOC_ID`
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProducts` method.
+message ListProductsResponse {
+  // List of products.
+  repeated Product products = 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 message for the `GetProduct` method.
+message GetProductRequest {
+  // Resource name of the Product to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProduct` method.
+message UpdateProductRequest {
+  // The Product resource which replaces the one on the server.
+  // product.name is immutable.
+  Product product = 1;
+
+  // 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
+  // `description`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProduct` method.
+message DeleteProductRequest {
+  // Resource name of product to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateProductSet` method.
+message CreateProductSetRequest {
+  // The project in which the ProductSet should be created.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The ProductSet to create.
+  ProductSet product_set = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_set_id = 3;
+}
+
+// Request message for the `ListProductSets` method.
+message ListProductSetsRequest {
+  // The project from which ProductSets should be listed.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductSets` method.
+message ListProductSetsResponse {
+  // List of ProductSets.
+  repeated ProductSet product_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;
+}
+
+// Request message for the `GetProductSet` method.
+message GetProductSetRequest {
+  // Resource name of the ProductSet to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProductSet` method.
+message UpdateProductSetRequest {
+  // The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1;
+
+  // 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 path is `display_name`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProductSet` method.
+message DeleteProductSetRequest {
+  // Resource name of the ProductSet to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateReferenceImage` method.
+message CreateReferenceImageRequest {
+  // 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.
+  // If an image ID is specified, it is ignored.
+  ReferenceImage reference_image = 2;
+
+  // 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
+  // already in use, an error is returned with code ALREADY_EXISTS. Must be at
+  // most 128 characters long. It cannot contain the character `/`.
+  string reference_image_id = 3;
+}
+
+// Request message for the `ListReferenceImages` method.
+message ListReferenceImagesRequest {
+  // Resource name of the product containing the reference images.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // A token identifying a page of results to be returned. This is the value
+  // of `nextPageToken` returned in a previous reference image list request.
+  //
+  // Defaults to the first page if not specified.
+  string page_token = 3;
+}
+
+// Response message for the `ListReferenceImages` method.
+message ListReferenceImagesResponse {
+  // The list of reference images.
+  repeated ReferenceImage reference_images = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string next_page_token = 3;
+}
+
+// Request message for the `GetReferenceImage` method.
+message GetReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `DeleteReferenceImage` method.
+message DeleteReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `AddProductToProductSet` method.
+message AddProductToProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `RemoveProductFromProductSet` method.
+message RemoveProductFromProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetRequest {
+  // The ProductSet resource for which to retrieve Products.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetResponse {
+  // The list of Products.
+  repeated Product products = 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 Google Cloud Storage location for a csv file which preserves a list of
+// ImportProductSetRequests in each line.
+message ImportProductSetsGcsSource {
+  // The Google Cloud Storage URI of the input csv file.
+  //
+  // 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.
+  // 1. image_uri
+  // 2, image_id
+  // 3. product_set_id
+  // 4. product_id
+  // 5, product_category
+  // 6, product_display_name
+  // 7, labels
+  // 8. bounding_poly
+  //
+  // Columns 1, 3, 4, and 5 are required, other columns are optional. A new
+  // ProductSet/Product with the same id will be created on the fly
+  // if the ProductSet/Product specified by product_set_id/product_id does not
+  // exist.
+  //
+  // The image_id field is optional but has to be unique if provided. If it is
+  // empty, we will automatically assign an unique id to the image.
+  //
+  // The product_display_name field is optional. If it is empty, a space (" ")
+  // is used as the place holder for the product display_name, which can
+  // be updated later through the realtime API.
+  //
+  // If the Product with product_id already exists, the fields
+  // product_display_name, product_category and labels are ignored.
+  //
+  // If a Product doesn't exist and needs to be created on the fly, the
+  // product_display_name field refers to [Product.display_name][google.cloud.vision.v1p3beta1.Product.display_name], the
+  // product_category field refers to [Product.product_category][google.cloud.vision.v1p3beta1.Product.product_category], and the
+  // labels field refers to [Product.labels][].
+  //
+  // Labels (optional) should be a line containing a list of comma-separated
+  // key-value pairs, with the format
+  //     "key_1=value_1,key_2=value_2,...,key_n=value_n".
+  //
+  // The bounding_poly (optional) field is used to identify one region of
+  // interest from the image in the same manner as CreateReferenceImage. If no
+  // bounding_poly is specified, the system will try to detect regions of
+  // interest automatically.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 20MP).
+  //
+  // Also note that at most one bounding_poly is allowed per line. If the image
+  // contains multiple regions of interest, the csv should contain one line per
+  // region of interest.
+  //
+  // The bounding_poly column should contain an even number of comma-separated
+  // numbers, with the format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Nonnegative
+  // integers should be used for absolute bounding polygons, and float values
+  // in [0, 1] should be used for normalized bounding polygons.
+  string csv_file_uri = 1;
+}
+
+// The input content for the `ImportProductSets` method.
+message ImportProductSetsInputConfig {
+  // The source of the input.
+  oneof source {
+    // The Google Cloud Storage location for a csv file which preserves a list
+    // of ImportProductSetRequests in each line.
+    ImportProductSetsGcsSource gcs_source = 1;
+  }
+}
+
+// Request message for the `ImportProductSets` method.
+message ImportProductSetsRequest {
+  // 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;
+}
+
+// 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.
+message ImportProductSetsResponse {
+  // The list of reference_images that are imported successfully.
+  repeated ReferenceImage reference_images = 1;
+
+  // The rpc status for each ImportProductSet request, including both successes
+  // and errors.
+  //
+  // The number of statuses here matches the number of lines in the csv file,
+  // and statuses[i] stores the success or failure status of processing the i-th
+  // line of the csv, starting from line 0.
+  repeated google.rpc.Status statuses = 2;
+}
+
+// Metadata for the batch operations such as the current state.
+//
+// This is included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message BatchOperationMetadata {
+  // Enumerates the possible states that the batch request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is actively being processed.
+    PROCESSING = 1;
+
+    // The request is done and at least one item has been successfully
+    // processed.
+    SUCCESSFUL = 2;
+
+    // The request is done and no item has been successfully processed.
+    FAILED = 3;
+
+    // The request is done after the longrunning.Operations.CancelOperation has
+    // been called by the user.  Any records that were processed before the
+    // cancel command are output as specified in the request.
+    CANCELLED = 4;
+  }
+
+  // The current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was submitted to the server.
+  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.protobuf.Timestamp end_time = 3;
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/text_annotation.proto b/vision/google/cloud/vision_v1p2beta1/proto/text_annotation.proto
new file mode 100644
index 000000000000..b35eb47e8e45
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/text_annotation.proto
@@ -0,0 +1,259 @@
+// 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.cloud.vision.v1p2beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p2beta1/geometry.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "TextAnnotationProto";
+option java_package = "com.google.cloud.vision.v1p2beta1";
+
+// TextAnnotation contains a structured representation of OCR extracted text.
+// The hierarchy of an OCR extracted text structure is like this:
+//     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.v1p2beta1.TextAnnotation.TextProperty]
+// message definition below for more detail.
+message TextAnnotation {
+  // 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;
+  }
+
+  // Detected start or end of a structural component.
+  message DetectedBreak {
+    // Enum to denote the type of break found. New line, space etc.
+    enum BreakType {
+      // Unknown break label type.
+      UNKNOWN = 0;
+
+      // Regular space.
+      SPACE = 1;
+
+      // Sure space (very wide).
+      SURE_SPACE = 2;
+
+      // Line-wrapping break.
+      EOL_SURE_SPACE = 3;
+
+      // End-line hyphen that is not present in text; does not co-occur with
+      // `SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.
+      HYPHEN = 4;
+
+      // Line break that ends a paragraph.
+      LINE_BREAK = 5;
+    }
+
+    // Detected break type.
+    BreakType type = 1;
+
+    // True if break prepends the element.
+    bool is_prefix = 2;
+  }
+
+  // Additional information detected on the structural component.
+  message TextProperty {
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 1;
+
+    // Detected start or end of a text segment.
+    DetectedBreak detected_break = 2;
+  }
+
+  // List of pages detected by OCR.
+  repeated Page pages = 1;
+
+  // UTF-8 text detected on the pages.
+  string text = 2;
+}
+
+// Detected page from OCR.
+message Page {
+  // Additional information detected on the page.
+  TextAnnotation.TextProperty property = 1;
+
+  // Page width. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 width = 2;
+
+  // Page height. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 height = 3;
+
+  // List of blocks of text, images etc on this page.
+  repeated Block blocks = 4;
+
+  // Confidence of the OCR results on the page. Range [0, 1].
+  float confidence = 5;
+}
+
+// Logical element on the page.
+message Block {
+  // Type of a block (text, image etc) as identified by OCR.
+  enum BlockType {
+    // Unknown block type.
+    UNKNOWN = 0;
+
+    // Regular text block.
+    TEXT = 1;
+
+    // Table block.
+    TABLE = 2;
+
+    // Image block.
+    PICTURE = 3;
+
+    // Horizontal/vertical line box.
+    RULER = 4;
+
+    // Barcode block.
+    BARCODE = 5;
+  }
+
+  // Additional information detected for the block.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the block.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //
+  // * when the text is horizontal it might look like:
+  //
+  //         0----1
+  //         |    |
+  //         3----2
+  //
+  // * when it's rotated 180 degrees around the top-left corner it becomes:
+  //
+  //         2----3
+  //         |    |
+  //         1----0
+  //
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of paragraphs in this block (if this blocks is of type text).
+  repeated Paragraph paragraphs = 3;
+
+  // Detected block type (text, image etc) for this block.
+  BlockType block_type = 4;
+
+  // Confidence of the OCR results on the block. Range [0, 1].
+  float confidence = 5;
+}
+
+// Structural unit of text representing a number of words in certain order.
+message Paragraph {
+  // Additional information detected for the paragraph.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the paragraph.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of words in this paragraph.
+  repeated Word words = 3;
+
+  // Confidence of the OCR results for the paragraph. Range [0, 1].
+  float confidence = 4;
+}
+
+// A word representation.
+message Word {
+  // Additional information detected for the word.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the word.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of symbols in the word.
+  // The order of the symbols follows the natural reading order.
+  repeated Symbol symbols = 3;
+
+  // Confidence of the OCR results for the word. Range [0, 1].
+  float confidence = 4;
+}
+
+// A single symbol representation.
+message Symbol {
+  // Additional information detected for the symbol.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the symbol.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // The actual UTF-8 representation of the symbol.
+  string text = 3;
+
+  // Confidence of the OCR results for the symbol. Range [0, 1].
+  float confidence = 4;
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/text_annotation_pb2.py b/vision/google/cloud/vision_v1p2beta1/proto/text_annotation_pb2.py
new file mode 100644
index 000000000000..fe004b8335b2
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/text_annotation_pb2.py
@@ -0,0 +1,1137 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p2beta1/proto/text_annotation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p2beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p2beta1/proto/text_annotation.proto",
+    package="google.cloud.vision.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p2beta1B\023TextAnnotationProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p2beta1/proto/text_annotation.proto\x12\x1dgoogle.cloud.vision.v1p2beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p2beta1/proto/geometry.proto"\xb2\x04\n\x0eTextAnnotation\x12\x32\n\x05pages\x18\x01 \x03(\x0b\x32#.google.cloud.vision.v1p2beta1.Page\x12\x0c\n\x04text\x18\x02 \x01(\t\x1a=\n\x10\x44\x65tectedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x1a\xdc\x01\n\rDetectedBreak\x12S\n\x04type\x18\x01 \x01(\x0e\x32\x45.google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak.BreakType\x12\x11\n\tis_prefix\x18\x02 \x01(\x08"c\n\tBreakType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\t\n\x05SPACE\x10\x01\x12\x0e\n\nSURE_SPACE\x10\x02\x12\x12\n\x0e\x45OL_SURE_SPACE\x10\x03\x12\n\n\x06HYPHEN\x10\x04\x12\x0e\n\nLINE_BREAK\x10\x05\x1a\xbf\x01\n\x0cTextProperty\x12Z\n\x12\x64\x65tected_languages\x18\x01 \x03(\x0b\x32>.google.cloud.vision.v1p2beta1.TextAnnotation.DetectedLanguage\x12S\n\x0e\x64\x65tected_break\x18\x02 \x01(\x0b\x32;.google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak"\xbd\x01\n\x04Page\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty\x12\r\n\x05width\x18\x02 \x01(\x05\x12\x0e\n\x06height\x18\x03 \x01(\x05\x12\x34\n\x06\x62locks\x18\x04 \x03(\x0b\x32$.google.cloud.vision.v1p2beta1.Block\x12\x12\n\nconfidence\x18\x05 \x01(\x02"\x82\x03\n\x05\x42lock\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12<\n\nparagraphs\x18\x03 \x03(\x0b\x32(.google.cloud.vision.v1p2beta1.Paragraph\x12\x42\n\nblock_type\x18\x04 \x01(\x0e\x32..google.cloud.vision.v1p2beta1.Block.BlockType\x12\x12\n\nconfidence\x18\x05 \x01(\x02"R\n\tBlockType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x08\n\x04TEXT\x10\x01\x12\t\n\x05TABLE\x10\x02\x12\x0b\n\x07PICTURE\x10\x03\x12\t\n\x05RULER\x10\x04\x12\x0b\n\x07\x42\x41RCODE\x10\x05"\xe4\x01\n\tParagraph\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12\x32\n\x05words\x18\x03 \x03(\x0b\x32#.google.cloud.vision.v1p2beta1.Word\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xe3\x01\n\x04Word\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12\x36\n\x07symbols\x18\x03 \x03(\x0b\x32%.google.cloud.vision.v1p2beta1.Symbol\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xbb\x01\n\x06Symbol\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p2beta1.BoundingPoly\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x42\x82\x01\n!com.google.cloud.vision.v1p2beta1B\x13TextAnnotationProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE = _descriptor.EnumDescriptor(
+    name="BreakType",
+    full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak.BreakType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPACE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SURE_SPACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EOL_SURE_SPACE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HYPHEN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINE_BREAK", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=444,
+    serialized_end=543,
+)
+_sym_db.RegisterEnumDescriptor(_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE)
+
+_BLOCK_BLOCKTYPE = _descriptor.EnumDescriptor(
+    name="BlockType",
+    full_name="google.cloud.vision.v1p2beta1.Block.BlockType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PICTURE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RULER", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BARCODE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1236,
+    serialized_end=1318,
+)
+_sym_db.RegisterEnumDescriptor(_BLOCK_BLOCKTYPE)
+
+
+_TEXTANNOTATION_DETECTEDLANGUAGE = _descriptor.Descriptor(
+    name="DetectedLanguage",
+    full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedLanguage.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=259,
+    serialized_end=320,
+)
+
+_TEXTANNOTATION_DETECTEDBREAK = _descriptor.Descriptor(
+    name="DetectedBreak",
+    full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_prefix",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak.is_prefix",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=323,
+    serialized_end=543,
+)
+
+_TEXTANNOTATION_TEXTPROPERTY = _descriptor.Descriptor(
+    name="TextProperty",
+    full_name="google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="detected_languages",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty.detected_languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detected_break",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty.detected_break",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=546,
+    serialized_end=737,
+)
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.vision.v1p2beta1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.pages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p2beta1.TextAnnotation.text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TEXTANNOTATION_DETECTEDLANGUAGE,
+        _TEXTANNOTATION_DETECTEDBREAK,
+        _TEXTANNOTATION_TEXTPROPERTY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=175,
+    serialized_end=737,
+)
+
+
+_PAGE = _descriptor.Descriptor(
+    name="Page",
+    full_name="google.cloud.vision.v1p2beta1.Page",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p2beta1.Page.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.cloud.vision.v1p2beta1.Page.width",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.cloud.vision.v1p2beta1.Page.height",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocks",
+            full_name="google.cloud.vision.v1p2beta1.Page.blocks",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.Page.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=740,
+    serialized_end=929,
+)
+
+
+_BLOCK = _descriptor.Descriptor(
+    name="Block",
+    full_name="google.cloud.vision.v1p2beta1.Block",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p2beta1.Block.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p2beta1.Block.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="paragraphs",
+            full_name="google.cloud.vision.v1p2beta1.Block.paragraphs",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="block_type",
+            full_name="google.cloud.vision.v1p2beta1.Block.block_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.Block.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BLOCK_BLOCKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=932,
+    serialized_end=1318,
+)
+
+
+_PARAGRAPH = _descriptor.Descriptor(
+    name="Paragraph",
+    full_name="google.cloud.vision.v1p2beta1.Paragraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p2beta1.Paragraph.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p2beta1.Paragraph.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.vision.v1p2beta1.Paragraph.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.Paragraph.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1321,
+    serialized_end=1549,
+)
+
+
+_WORD = _descriptor.Descriptor(
+    name="Word",
+    full_name="google.cloud.vision.v1p2beta1.Word",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p2beta1.Word.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p2beta1.Word.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="symbols",
+            full_name="google.cloud.vision.v1p2beta1.Word.symbols",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.Word.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1552,
+    serialized_end=1779,
+)
+
+
+_SYMBOL = _descriptor.Descriptor(
+    name="Symbol",
+    full_name="google.cloud.vision.v1p2beta1.Symbol",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p2beta1.Symbol.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p2beta1.Symbol.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p2beta1.Symbol.text",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p2beta1.Symbol.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1782,
+    serialized_end=1969,
+)
+
+_TEXTANNOTATION_DETECTEDLANGUAGE.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK.fields_by_name[
+    "type"
+].enum_type = _TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE
+_TEXTANNOTATION_DETECTEDBREAK.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE.containing_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_languages"
+].message_type = _TEXTANNOTATION_DETECTEDLANGUAGE
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_break"
+].message_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION.fields_by_name["pages"].message_type = _PAGE
+_PAGE.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PAGE.fields_by_name["blocks"].message_type = _BLOCK
+_BLOCK.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_BLOCK.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_BLOCK.fields_by_name["paragraphs"].message_type = _PARAGRAPH
+_BLOCK.fields_by_name["block_type"].enum_type = _BLOCK_BLOCKTYPE
+_BLOCK_BLOCKTYPE.containing_type = _BLOCK
+_PARAGRAPH.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PARAGRAPH.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PARAGRAPH.fields_by_name["words"].message_type = _WORD
+_WORD.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_WORD.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_WORD.fields_by_name["symbols"].message_type = _SYMBOL
+_SYMBOL.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_SYMBOL.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p2beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["Page"] = _PAGE
+DESCRIPTOR.message_types_by_name["Block"] = _BLOCK
+DESCRIPTOR.message_types_by_name["Paragraph"] = _PARAGRAPH
+DESCRIPTOR.message_types_by_name["Word"] = _WORD
+DESCRIPTOR.message_types_by_name["Symbol"] = _SYMBOL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DetectedLanguage=_reflection.GeneratedProtocolMessageType(
+            "DetectedLanguage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDLANGUAGE,
+                __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+                __doc__="""Detected language for a structural component.
+    
+    
+    Attributes:
+        language_code:
+            The BCP-47 language code, such as "en-US" or "sr-Latn". For
+            more information, see http://www.unicode.org/reports/tr35/#Uni
+            code\_locale\_identifier.
+        confidence:
+            Confidence of detected language. Range [0, 1].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.TextAnnotation.DetectedLanguage)
+            ),
+        ),
+        DetectedBreak=_reflection.GeneratedProtocolMessageType(
+            "DetectedBreak",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDBREAK,
+                __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+                __doc__="""Detected start or end of a structural component.
+    
+    
+    Attributes:
+        type:
+            Detected break type.
+        is_prefix:
+            True if break prepends the element.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.TextAnnotation.DetectedBreak)
+            ),
+        ),
+        TextProperty=_reflection.GeneratedProtocolMessageType(
+            "TextProperty",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_TEXTPROPERTY,
+                __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+                __doc__="""Additional information detected on the structural component.
+    
+    
+    Attributes:
+        detected_languages:
+            A list of detected languages together with confidence.
+        detected_break:
+            Detected start or end of a text segment.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.TextAnnotation.TextProperty)
+            ),
+        ),
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+        __doc__="""TextAnnotation contains a structured representation of OCR extracted
+  text. The hierarchy of an OCR extracted text structure is like this:
+  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.v1p2beta1.TextAnnotation.TextProperty]
+  message definition below for more detail.
+  
+  
+  Attributes:
+      pages:
+          List of pages detected by OCR.
+      text:
+          UTF-8 text detected on the pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+_sym_db.RegisterMessage(TextAnnotation.DetectedLanguage)
+_sym_db.RegisterMessage(TextAnnotation.DetectedBreak)
+_sym_db.RegisterMessage(TextAnnotation.TextProperty)
+
+Page = _reflection.GeneratedProtocolMessageType(
+    "Page",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAGE,
+        __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+        __doc__="""Detected page from OCR.
+  
+  
+  Attributes:
+      property:
+          Additional information detected on the page.
+      width:
+          Page width. For PDFs the unit is points. For images (including
+          TIFFs) the unit is pixels.
+      height:
+          Page height. For PDFs the unit is points. For images
+          (including TIFFs) the unit is pixels.
+      blocks:
+          List of blocks of text, images etc on this page.
+      confidence:
+          Confidence of the OCR results on the page. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Page)
+    ),
+)
+_sym_db.RegisterMessage(Page)
+
+Block = _reflection.GeneratedProtocolMessageType(
+    "Block",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BLOCK,
+        __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+        __doc__="""Logical element on the page.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the block.
+      bounding_box:
+          The bounding box for the block. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example:  -
+          when the text is horizontal it might look like:     ::
+          0----1        |    |        3----2  -  when it's rotated 180
+          degrees around the top-left corner it becomes:     ::
+          2----3        |    |        1----0  and the vertice order will
+          still be (0, 1, 2, 3).
+      paragraphs:
+          List of paragraphs in this block (if this blocks is of type
+          text).
+      block_type:
+          Detected block type (text, image etc) for this block.
+      confidence:
+          Confidence of the OCR results on the block. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Block)
+    ),
+)
+_sym_db.RegisterMessage(Block)
+
+Paragraph = _reflection.GeneratedProtocolMessageType(
+    "Paragraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAGRAPH,
+        __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+        __doc__="""Structural unit of text representing a number of words in certain order.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the paragraph.
+      bounding_box:
+          The bounding box for the paragraph. The vertices are in the
+          order of top-left, top-right, bottom-right, bottom-left. When
+          a rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      words:
+          List of words in this paragraph.
+      confidence:
+          Confidence of the OCR results for the paragraph. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Paragraph)
+    ),
+)
+_sym_db.RegisterMessage(Paragraph)
+
+Word = _reflection.GeneratedProtocolMessageType(
+    "Word",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORD,
+        __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+        __doc__="""A word representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the word.
+      bounding_box:
+          The bounding box for the word. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      symbols:
+          List of symbols in the word. The order of the symbols follows
+          the natural reading order.
+      confidence:
+          Confidence of the OCR results for the word. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Word)
+    ),
+)
+_sym_db.RegisterMessage(Word)
+
+Symbol = _reflection.GeneratedProtocolMessageType(
+    "Symbol",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYMBOL,
+        __module__="google.cloud.vision_v1p2beta1.proto.text_annotation_pb2",
+        __doc__="""A single symbol representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the symbol.
+      bounding_box:
+          The bounding box for the symbol. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      text:
+          The actual UTF-8 representation of the symbol.
+      confidence:
+          Confidence of the OCR results for the symbol. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.Symbol)
+    ),
+)
+_sym_db.RegisterMessage(Symbol)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/text_annotation_pb2_grpc.py b/vision/google/cloud/vision_v1p2beta1/proto/text_annotation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/text_annotation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/web_detection.proto b/vision/google/cloud/vision_v1p2beta1/proto/web_detection.proto
new file mode 100644
index 000000000000..f2b9dfef00dc
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/web_detection.proto
@@ -0,0 +1,104 @@
+// 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.cloud.vision.v1p2beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "WebDetectionProto";
+option java_package = "com.google.cloud.vision.v1p2beta1";
+
+// Relevant information for the image from the Internet.
+message WebDetection {
+  // Entity deduced from similar images on the Internet.
+  message WebEntity {
+    // Opaque entity ID.
+    string entity_id = 1;
+
+    // Overall relevancy score for the entity.
+    // Not normalized and not comparable across different image queries.
+    float score = 2;
+
+    // Canonical description of the entity, in English.
+    string description = 3;
+  }
+
+  // Metadata for online images.
+  message WebImage {
+    // The result image URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the image.
+    float score = 2;
+  }
+
+  // Metadata for web pages.
+  message WebPage {
+    // The result web page URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the web page.
+    float score = 2;
+
+    // Title for the web page, may contain HTML markups.
+    string page_title = 3;
+
+    // Fully matching images on the page.
+    // Can include resized copies of the query image.
+    repeated WebImage full_matching_images = 4;
+
+    // Partial matching images on the page.
+    // Those images are similar enough to share some key-point features. For
+    // example an original image will likely have partial matching for its
+    // crops.
+    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;
+
+  // Fully matching images from the Internet.
+  // Can include resized copies of the query image.
+  repeated WebImage full_matching_images = 2;
+
+  // Partial matching images from the Internet.
+  // Those images are similar enough to share some key-point features. For
+  // example an original image will likely have partial matching for its crops.
+  repeated WebImage partial_matching_images = 3;
+
+  // Web pages containing the matching images from the Internet.
+  repeated WebPage pages_with_matching_images = 4;
+
+  // The visually similar image results.
+  repeated WebImage visually_similar_images = 6;
+
+  // Best guess text labels for the request image.
+  repeated WebLabel best_guess_labels = 8;
+}
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/web_detection_pb2.py b/vision/google/cloud/vision_v1p2beta1/proto/web_detection_pb2.py
new file mode 100644
index 000000000000..41b604642a4c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/web_detection_pb2.py
@@ -0,0 +1,616 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p2beta1/proto/web_detection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p2beta1/proto/web_detection.proto",
+    package="google.cloud.vision.v1p2beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p2beta1B\021WebDetectionProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/vision_v1p2beta1/proto/web_detection.proto\x12\x1dgoogle.cloud.vision.v1p2beta1\x1a\x1cgoogle/api/annotations.proto"\x8c\x07\n\x0cWebDetection\x12K\n\x0cweb_entities\x18\x01 \x03(\x0b\x32\x35.google.cloud.vision.v1p2beta1.WebDetection.WebEntity\x12R\n\x14\x66ull_matching_images\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x03 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.WebDetection.WebImage\x12W\n\x1apages_with_matching_images\x18\x04 \x03(\x0b\x32\x33.google.cloud.vision.v1p2beta1.WebDetection.WebPage\x12U\n\x17visually_similar_images\x18\x06 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.WebDetection.WebImage\x12O\n\x11\x62\x65st_guess_labels\x18\x08 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.WebDetection.WebLabel\x1a\x42\n\tWebEntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x1a&\n\x08WebImage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x1a\xe4\x01\n\x07WebPage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x12\n\npage_title\x18\x03 \x01(\t\x12R\n\x14\x66ull_matching_images\x18\x04 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x05 \x03(\x0b\x32\x34.google.cloud.vision.v1p2beta1.WebDetection.WebImage\x1a\x30\n\x08WebLabel\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\tB\x80\x01\n!com.google.cloud.vision.v1p2beta1B\x11WebDetectionProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p2beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_WEBDETECTION_WEBENTITY = _descriptor.Descriptor(
+    name="WebEntity",
+    full_name="google.cloud.vision.v1p2beta1.WebDetection.WebEntity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebEntity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebEntity.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebEntity.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=642,
+    serialized_end=708,
+)
+
+_WEBDETECTION_WEBIMAGE = _descriptor.Descriptor(
+    name="WebImage",
+    full_name="google.cloud.vision.v1p2beta1.WebDetection.WebImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebImage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebImage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=710,
+    serialized_end=748,
+)
+
+_WEBDETECTION_WEBPAGE = _descriptor.Descriptor(
+    name="WebPage",
+    full_name="google.cloud.vision.v1p2beta1.WebDetection.WebPage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebPage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebPage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_title",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebPage.page_title",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebPage.full_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebPage.partial_matching_images",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=751,
+    serialized_end=979,
+)
+
+_WEBDETECTION_WEBLABEL = _descriptor.Descriptor(
+    name="WebLabel",
+    full_name="google.cloud.vision.v1p2beta1.WebDetection.WebLabel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebLabel.label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.WebLabel.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=981,
+    serialized_end=1029,
+)
+
+_WEBDETECTION = _descriptor.Descriptor(
+    name="WebDetection",
+    full_name="google.cloud.vision.v1p2beta1.WebDetection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="web_entities",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.web_entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.full_matching_images",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.partial_matching_images",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages_with_matching_images",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.pages_with_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="visually_similar_images",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.visually_similar_images",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="best_guess_labels",
+            full_name="google.cloud.vision.v1p2beta1.WebDetection.best_guess_labels",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _WEBDETECTION_WEBENTITY,
+        _WEBDETECTION_WEBIMAGE,
+        _WEBDETECTION_WEBPAGE,
+        _WEBDETECTION_WEBLABEL,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=121,
+    serialized_end=1029,
+)
+
+_WEBDETECTION_WEBENTITY.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBIMAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBLABEL.containing_type = _WEBDETECTION
+_WEBDETECTION.fields_by_name["web_entities"].message_type = _WEBDETECTION_WEBENTITY
+_WEBDETECTION.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "pages_with_matching_images"
+].message_type = _WEBDETECTION_WEBPAGE
+_WEBDETECTION.fields_by_name[
+    "visually_similar_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name["best_guess_labels"].message_type = _WEBDETECTION_WEBLABEL
+DESCRIPTOR.message_types_by_name["WebDetection"] = _WEBDETECTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WebDetection = _reflection.GeneratedProtocolMessageType(
+    "WebDetection",
+    (_message.Message,),
+    dict(
+        WebEntity=_reflection.GeneratedProtocolMessageType(
+            "WebEntity",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBENTITY,
+                __module__="google.cloud.vision_v1p2beta1.proto.web_detection_pb2",
+                __doc__="""Entity deduced from similar images on the Internet.
+    
+    
+    Attributes:
+        entity_id:
+            Opaque entity ID.
+        score:
+            Overall relevancy score for the entity. Not normalized and not
+            comparable across different image queries.
+        description:
+            Canonical description of the entity, in English.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.WebDetection.WebEntity)
+            ),
+        ),
+        WebImage=_reflection.GeneratedProtocolMessageType(
+            "WebImage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBIMAGE,
+                __module__="google.cloud.vision_v1p2beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for online images.
+    
+    
+    Attributes:
+        url:
+            The result image URL.
+        score:
+            (Deprecated) Overall relevancy score for the image.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.WebDetection.WebImage)
+            ),
+        ),
+        WebPage=_reflection.GeneratedProtocolMessageType(
+            "WebPage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBPAGE,
+                __module__="google.cloud.vision_v1p2beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for web pages.
+    
+    
+    Attributes:
+        url:
+            The result web page URL.
+        score:
+            (Deprecated) Overall relevancy score for the web page.
+        page_title:
+            Title for the web page, may contain HTML markups.
+        full_matching_images:
+            Fully matching images on the page. Can include resized copies
+            of the query image.
+        partial_matching_images:
+            Partial matching images on the page. Those images are similar
+            enough to share some key-point features. For example an
+            original image will likely have partial matching for its
+            crops.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.WebDetection.WebPage)
+            ),
+        ),
+        WebLabel=_reflection.GeneratedProtocolMessageType(
+            "WebLabel",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBLABEL,
+                __module__="google.cloud.vision_v1p2beta1.proto.web_detection_pb2",
+                __doc__="""Label to provide extra metadata for the web detection.
+    
+    
+    Attributes:
+        label:
+            Label for extra metadata.
+        language_code:
+            The BCP-47 language code for ``label``, such as "en-US" or
+            "sr-Latn". For more information, see http://www.unicode.org/re
+            ports/tr35/#Unicode\_locale\_identifier.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.WebDetection.WebLabel)
+            ),
+        ),
+        DESCRIPTOR=_WEBDETECTION,
+        __module__="google.cloud.vision_v1p2beta1.proto.web_detection_pb2",
+        __doc__="""Relevant information for the image from the Internet.
+  
+  
+  Attributes:
+      web_entities:
+          Deduced entities from similar images on the Internet.
+      full_matching_images:
+          Fully matching images from the Internet. Can include resized
+          copies of the query image.
+      partial_matching_images:
+          Partial matching images from the Internet. Those images are
+          similar enough to share some key-point features. For example
+          an original image will likely have partial matching for its
+          crops.
+      pages_with_matching_images:
+          Web pages containing the matching images from the Internet.
+      visually_similar_images:
+          The visually similar image results.
+      best_guess_labels:
+          Best guess text labels for the request image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p2beta1.WebDetection)
+    ),
+)
+_sym_db.RegisterMessage(WebDetection)
+_sym_db.RegisterMessage(WebDetection.WebEntity)
+_sym_db.RegisterMessage(WebDetection.WebImage)
+_sym_db.RegisterMessage(WebDetection.WebPage)
+_sym_db.RegisterMessage(WebDetection.WebLabel)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p2beta1/proto/web_detection_pb2_grpc.py b/vision/google/cloud/vision_v1p2beta1/proto/web_detection_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/proto/web_detection_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p2beta1/types.py b/vision/google/cloud/vision_v1p2beta1/types.py
new file mode 100644
index 000000000000..250cb6f5b6df
--- /dev/null
+++ b/vision/google/cloud/vision_v1p2beta1/types.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.vision_v1p2beta1.proto import geometry_pb2
+from google.cloud.vision_v1p2beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p2beta1.proto import text_annotation_pb2
+from google.cloud.vision_v1p2beta1.proto import web_detection_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import color_pb2
+from google.type import latlng_pb2
+
+
+_shared_modules = [
+    operations_pb2,
+    any_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    color_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [
+    geometry_pb2,
+    image_annotator_pb2,
+    text_annotation_pb2,
+    web_detection_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.vision_v1p2beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/vision/google/cloud/vision_v1p3beta1/__init__.py b/vision/google/cloud/vision_v1p3beta1/__init__.py
new file mode 100644
index 000000000000..6217dd7db3d2
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/__init__.py
@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.vision_helpers.decorators import add_single_feature_methods
+from google.cloud.vision_helpers import VisionHelpers
+
+from google.cloud.vision_v1p3beta1 import types
+from google.cloud.vision_v1p3beta1.gapic import enums
+from google.cloud.vision_v1p3beta1.gapic import image_annotator_client as iac
+from google.cloud.vision_v1p3beta1.gapic import product_search_client
+
+
+class ProductSearchClient(product_search_client.ProductSearchClient):
+    __doc__ = product_search_client.ProductSearchClient.__doc__
+    enums = enums
+
+
+@add_single_feature_methods
+class ImageAnnotatorClient(VisionHelpers, iac.ImageAnnotatorClient):
+    __doc__ = iac.ImageAnnotatorClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ProductSearchClient", "ImageAnnotatorClient")
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/__init__.py b/vision/google/cloud/vision_v1p3beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/enums.py b/vision/google/cloud/vision_v1p3beta1/gapic/enums.py
new file mode 100644
index 000000000000..e48d6ff446da
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/enums.py
@@ -0,0 +1,285 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Likelihood(enum.IntEnum):
+    """
+    A bucketized representation of likelihood, which is intended to give clients
+    highly stable results across model upgrades.
+
+    Attributes:
+      UNKNOWN (int): Unknown likelihood.
+      VERY_UNLIKELY (int): It is very unlikely that the image belongs to the specified vertical.
+      UNLIKELY (int): It is unlikely that the image belongs to the specified vertical.
+      POSSIBLE (int): It is possible that the image belongs to the specified vertical.
+      LIKELY (int): It is likely that the image belongs to the specified vertical.
+      VERY_LIKELY (int): It is very likely that the image belongs to the specified vertical.
+    """
+
+    UNKNOWN = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class ProductSearchCategory(enum.IntEnum):
+    """
+    Supported product search categories.
+
+    Attributes:
+      PRODUCT_SEARCH_CATEGORY_UNSPECIFIED (int): Default value used when a category is not specified.
+      SHOES (int): Shoes category.
+      BAGS (int): Bags category.
+    """
+
+    PRODUCT_SEARCH_CATEGORY_UNSPECIFIED = 0
+    SHOES = 1
+    BAGS = 2
+
+
+class ProductSearchResultsView(enum.IntEnum):
+    """
+    Specifies the fields to include in product search results.
+
+    Attributes:
+      BASIC (int): Product search results contain only ``product_category`` and
+      ``product_id``. Default value.
+      FULL (int): Product search results contain ``product_category``, ``product_id``,
+      ``image_uri``, and ``score``.
+    """
+
+    BASIC = 0
+    FULL = 1
+
+
+class BatchOperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Enumerates the possible states that the batch request can be in.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          PROCESSING (int): Request is actively being processed.
+          SUCCESSFUL (int): The request is done and at least one item has been successfully
+          processed.
+          FAILED (int): The request is done and no item has been successfully processed.
+          CANCELLED (int): The request is done after the longrunning.Operations.CancelOperation has
+          been called by the user.  Any records that were processed before the
+          cancel command are output as specified in the request.
+        """
+
+        STATE_UNSPECIFIED = 0
+        PROCESSING = 1
+        SUCCESSFUL = 2
+        FAILED = 3
+        CANCELLED = 4
+
+
+class Block(object):
+    class BlockType(enum.IntEnum):
+        """
+        Type of a block (text, image etc) as identified by OCR.
+
+        Attributes:
+          UNKNOWN (int): Unknown block type.
+          TEXT (int): Regular text block.
+          TABLE (int): Table block.
+          PICTURE (int): Image block.
+          RULER (int): Horizontal/vertical line box.
+          BARCODE (int): Barcode block.
+        """
+
+        UNKNOWN = 0
+        TEXT = 1
+        TABLE = 2
+        PICTURE = 3
+        RULER = 4
+        BARCODE = 5
+
+
+class FaceAnnotation(object):
+    class Landmark(object):
+        class Type(enum.IntEnum):
+            """
+            Face landmark (feature) type. Left and right are defined from the
+            vantage of the viewer of the image without considering mirror
+            projections typical of photos. So, ``LEFT_EYE``, typically, is the
+            person's right eye.
+
+            Attributes:
+              UNKNOWN_LANDMARK (int): Unknown face landmark detected. Should not be filled.
+              LEFT_EYE (int): Left eye.
+              RIGHT_EYE (int): Right eye.
+              LEFT_OF_LEFT_EYEBROW (int): Left of left eyebrow.
+              RIGHT_OF_LEFT_EYEBROW (int): Right of left eyebrow.
+              LEFT_OF_RIGHT_EYEBROW (int): Left of right eyebrow.
+              RIGHT_OF_RIGHT_EYEBROW (int): Right of right eyebrow.
+              MIDPOINT_BETWEEN_EYES (int): Midpoint between eyes.
+              NOSE_TIP (int): Nose tip.
+              UPPER_LIP (int): Upper lip.
+              LOWER_LIP (int): Lower lip.
+              MOUTH_LEFT (int): Mouth left.
+              MOUTH_RIGHT (int): Mouth right.
+              MOUTH_CENTER (int): Mouth center.
+              NOSE_BOTTOM_RIGHT (int): Nose, bottom right.
+              NOSE_BOTTOM_LEFT (int): Nose, bottom left.
+              NOSE_BOTTOM_CENTER (int): Nose, bottom center.
+              LEFT_EYE_TOP_BOUNDARY (int): Left eye, top boundary.
+              LEFT_EYE_RIGHT_CORNER (int): Left eye, right corner.
+              LEFT_EYE_BOTTOM_BOUNDARY (int): Left eye, bottom boundary.
+              LEFT_EYE_LEFT_CORNER (int): Left eye, left corner.
+              RIGHT_EYE_TOP_BOUNDARY (int): Right eye, top boundary.
+              RIGHT_EYE_RIGHT_CORNER (int): Right eye, right corner.
+              RIGHT_EYE_BOTTOM_BOUNDARY (int): Right eye, bottom boundary.
+              RIGHT_EYE_LEFT_CORNER (int): Right eye, left corner.
+              LEFT_EYEBROW_UPPER_MIDPOINT (int): Left eyebrow, upper midpoint.
+              RIGHT_EYEBROW_UPPER_MIDPOINT (int): Right eyebrow, upper midpoint.
+              LEFT_EAR_TRAGION (int): Left ear tragion.
+              RIGHT_EAR_TRAGION (int): Right ear tragion.
+              LEFT_EYE_PUPIL (int): Left eye pupil.
+              RIGHT_EYE_PUPIL (int): Right eye pupil.
+              FOREHEAD_GLABELLA (int): Forehead glabella.
+              CHIN_GNATHION (int): Chin gnathion.
+              CHIN_LEFT_GONION (int): Chin left gonion.
+              CHIN_RIGHT_GONION (int): Chin right gonion.
+            """
+
+            UNKNOWN_LANDMARK = 0
+            LEFT_EYE = 1
+            RIGHT_EYE = 2
+            LEFT_OF_LEFT_EYEBROW = 3
+            RIGHT_OF_LEFT_EYEBROW = 4
+            LEFT_OF_RIGHT_EYEBROW = 5
+            RIGHT_OF_RIGHT_EYEBROW = 6
+            MIDPOINT_BETWEEN_EYES = 7
+            NOSE_TIP = 8
+            UPPER_LIP = 9
+            LOWER_LIP = 10
+            MOUTH_LEFT = 11
+            MOUTH_RIGHT = 12
+            MOUTH_CENTER = 13
+            NOSE_BOTTOM_RIGHT = 14
+            NOSE_BOTTOM_LEFT = 15
+            NOSE_BOTTOM_CENTER = 16
+            LEFT_EYE_TOP_BOUNDARY = 17
+            LEFT_EYE_RIGHT_CORNER = 18
+            LEFT_EYE_BOTTOM_BOUNDARY = 19
+            LEFT_EYE_LEFT_CORNER = 20
+            RIGHT_EYE_TOP_BOUNDARY = 21
+            RIGHT_EYE_RIGHT_CORNER = 22
+            RIGHT_EYE_BOTTOM_BOUNDARY = 23
+            RIGHT_EYE_LEFT_CORNER = 24
+            LEFT_EYEBROW_UPPER_MIDPOINT = 25
+            RIGHT_EYEBROW_UPPER_MIDPOINT = 26
+            LEFT_EAR_TRAGION = 27
+            RIGHT_EAR_TRAGION = 28
+            LEFT_EYE_PUPIL = 29
+            RIGHT_EYE_PUPIL = 30
+            FOREHEAD_GLABELLA = 31
+            CHIN_GNATHION = 32
+            CHIN_LEFT_GONION = 33
+            CHIN_RIGHT_GONION = 34
+
+
+class Feature(object):
+    class Type(enum.IntEnum):
+        """
+        Type of Google Cloud Vision API feature to be extracted.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Unspecified feature type.
+          FACE_DETECTION (int): Run face detection.
+          LANDMARK_DETECTION (int): Run landmark detection.
+          LOGO_DETECTION (int): Run logo detection.
+          LABEL_DETECTION (int): Run label detection.
+          TEXT_DETECTION (int): Run text detection / optical character recognition (OCR). Text detection
+          is optimized for areas of text within a larger image; if the image is a
+          document, use ``DOCUMENT_TEXT_DETECTION`` instead.
+          DOCUMENT_TEXT_DETECTION (int): Run dense text document OCR. Takes precedence when both
+          ``DOCUMENT_TEXT_DETECTION`` and ``TEXT_DETECTION`` are present.
+          SAFE_SEARCH_DETECTION (int): Run Safe Search to detect potentially unsafe
+          or undesirable content.
+          IMAGE_PROPERTIES (int): Compute a set of image properties, such as the
+          image's dominant colors.
+          CROP_HINTS (int): Run crop hints.
+          WEB_DETECTION (int): Run web detection.
+          PRODUCT_SEARCH (int): Run Product Search.
+          OBJECT_LOCALIZATION (int): Run localizer for object detection.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        FACE_DETECTION = 1
+        LANDMARK_DETECTION = 2
+        LOGO_DETECTION = 3
+        LABEL_DETECTION = 4
+        TEXT_DETECTION = 5
+        DOCUMENT_TEXT_DETECTION = 11
+        SAFE_SEARCH_DETECTION = 6
+        IMAGE_PROPERTIES = 7
+        CROP_HINTS = 9
+        WEB_DETECTION = 10
+        PRODUCT_SEARCH = 12
+        OBJECT_LOCALIZATION = 19
+
+
+class OperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Batch operation states.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          CREATED (int): Request is received.
+          RUNNING (int): Request is actively being processed.
+          DONE (int): The batch processing is done.
+          CANCELLED (int): The batch processing was cancelled.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATED = 1
+        RUNNING = 2
+        DONE = 3
+        CANCELLED = 4
+
+
+class TextAnnotation(object):
+    class DetectedBreak(object):
+        class BreakType(enum.IntEnum):
+            """
+            Enum to denote the type of break found. New line, space etc.
+
+            Attributes:
+              UNKNOWN (int): Unknown break label type.
+              SPACE (int): Regular space.
+              SURE_SPACE (int): Sure space (very wide).
+              EOL_SURE_SPACE (int): Line-wrapping break.
+              HYPHEN (int): End-line hyphen that is not present in text; does not co-occur with
+              ``SPACE``, ``LEADER_SPACE``, or ``LINE_BREAK``.
+              LINE_BREAK (int): Line break that ends a paragraph.
+            """
+
+            UNKNOWN = 0
+            SPACE = 1
+            SURE_SPACE = 2
+            EOL_SURE_SPACE = 3
+            HYPHEN = 4
+            LINE_BREAK = 5
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/image_annotator_client.py b/vision/google/cloud/vision_v1p3beta1/gapic/image_annotator_client.py
new file mode 100644
index 000000000000..945213e8caf3
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/image_annotator_client.py
@@ -0,0 +1,334 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1p3beta1 ImageAnnotator API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import grpc
+
+from google.cloud.vision_v1p3beta1.gapic import enums
+from google.cloud.vision_v1p3beta1.gapic import image_annotator_client_config
+from google.cloud.vision_v1p3beta1.gapic.transports import (
+    image_annotator_grpc_transport,
+)
+from google.cloud.vision_v1p3beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p3beta1.proto import image_annotator_pb2_grpc
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ImageAnnotatorClient(object):
+    """
+    Service that performs Google Cloud Vision API detection tasks over client
+    images, such as face, landmark, logo, label, and text detection. The
+    ImageAnnotator service returns detected entities from the images.
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1p3beta1.ImageAnnotator"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ImageAnnotatorClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ImageAnnotatorGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ImageAnnotatorGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = image_annotator_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=image_annotator_grpc_transport.ImageAnnotatorGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = image_annotator_grpc_transport.ImageAnnotatorGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def batch_annotate_images(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run image detection and annotation for a batch of images.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_images(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p3beta1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.AnnotateImageRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.BatchAnnotateImagesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_images,
+                default_retry=self._method_configs["BatchAnnotateImages"].retry,
+                default_timeout=self._method_configs["BatchAnnotateImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateImagesRequest(requests=requests)
+        return self._inner_api_calls["batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def async_batch_annotate_files(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run asynchronous image detection and annotation for a list of generic
+        files, such as PDF files, which may contain multiple pages and multiple
+        images per page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.async_batch_annotate_files(requests)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p3beta1.types.AsyncAnnotateFileRequest]]): Individual async file annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.AsyncAnnotateFileRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "async_batch_annotate_files" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "async_batch_annotate_files"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.async_batch_annotate_files,
+                default_retry=self._method_configs["AsyncBatchAnnotateFiles"].retry,
+                default_timeout=self._method_configs["AsyncBatchAnnotateFiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(requests=requests)
+        operation = self._inner_api_calls["async_batch_annotate_files"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            image_annotator_pb2.AsyncBatchAnnotateFilesResponse,
+            metadata_type=image_annotator_pb2.OperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/image_annotator_client_config.py b/vision/google/cloud/vision_v1p3beta1/gapic/image_annotator_client_config.py
new file mode 100644
index 000000000000..41adece1cb2a
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/image_annotator_client_config.py
@@ -0,0 +1,33 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1p3beta1.ImageAnnotator": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "BatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AsyncBatchAnnotateFiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/product_search_client.py b/vision/google/cloud/vision_v1p3beta1/gapic/product_search_client.py
new file mode 100644
index 000000000000..7970722ee257
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/product_search_client.py
@@ -0,0 +1,1921 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1p3beta1 ProductSearch API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.vision_v1p3beta1.gapic import enums
+from google.cloud.vision_v1p3beta1.gapic import product_search_client_config
+from google.cloud.vision_v1p3beta1.gapic.transports import product_search_grpc_transport
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ProductSearchClient(object):
+    """
+    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`` 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`` resources, named
+       ``projects/*/locations/*/products/*``
+
+    -  Each ``Product`` has a collection of ``ReferenceImage`` resources,
+       named ``projects/*/locations/*/products/*/referenceImages/*``
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1p3beta1.ProductSearch"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ProductSearchClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def product_path(cls, project, location, product):
+        """Return a fully-qualified product string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/products/{product}",
+            project=project,
+            location=location,
+            product=product,
+        )
+
+    @classmethod
+    def product_set_path(cls, project, location, product_set):
+        """Return a fully-qualified product_set string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/productSets/{product_set}",
+            project=project,
+            location=location,
+            product_set=product_set,
+        )
+
+    @classmethod
+    def reference_image_path(cls, project, location, product, reference_image):
+        """Return a fully-qualified reference_image string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}",
+            project=project,
+            location=location,
+            product=product,
+            reference_image=reference_image,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ProductSearchGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ProductSearchGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = product_search_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=product_search_grpc_transport.ProductSearchGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = product_search_grpc_transport.ProductSearchGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_product_set(
+        self,
+        parent,
+        product_set,
+        product_set_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new ProductSet resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing, or is longer
+           than 4096 characters.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `product_set`:
+            >>> product_set = {}
+            >>>
+            >>> # TODO: Initialize `product_set_id`:
+            >>> product_set_id = ''
+            >>>
+            >>> response = client.create_product_set(parent, product_set, product_set_id)
+
+        Args:
+            parent (str): The project in which the ProductSet should be created.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product_set (Union[dict, ~google.cloud.vision_v1p3beta1.types.ProductSet]): The ProductSet to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.ProductSet`
+            product_set_id (str): 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 error is returned with code ALREADY\_EXISTS. Must be at most 128
+                characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_product_set,
+                default_retry=self._method_configs["CreateProductSet"].retry,
+                default_timeout=self._method_configs["CreateProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateProductSetRequest(
+            parent=parent, product_set=product_set, product_set_id=product_set_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_product_sets(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ProductSets in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100, or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_product_sets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_product_sets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project from which ProductSets should be listed.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p3beta1.types.ProductSet` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_product_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_product_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_product_sets,
+                default_retry=self._method_configs["ListProductSets"].retry,
+                default_timeout=self._method_configs["ListProductSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductSetsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_product_sets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="product_sets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_product_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> response = client.get_product_set(name)
+
+        Args:
+            name (str): Resource name of the ProductSet to get.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_product_set,
+                default_retry=self._method_configs["GetProductSet"].retry,
+                default_timeout=self._method_configs["GetProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetProductSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_product_set(
+        self,
+        product_set,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Makes changes to a ProductSet resource. Only display\_name can be
+        updated currently.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but missing from the request or longer than 4096 characters.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> # TODO: Initialize `product_set`:
+            >>> product_set = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_product_set(product_set, update_mask)
+
+        Args:
+            product_set (Union[dict, ~google.cloud.vision_v1p3beta1.types.ProductSet]): The ProductSet resource which replaces the one on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.ProductSet`
+            update_mask (Union[dict, ~google.cloud.vision_v1p3beta1.types.FieldMask]): The ``FieldMask`` that specifies which fields to update. If update\_mask
+                isn't specified, all mutable fields are to be updated. Valid mask path
+                is ``display_name``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_product_set,
+                default_retry=self._method_configs["UpdateProductSet"].retry,
+                default_timeout=self._method_configs["UpdateProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.UpdateProductSetRequest(
+            product_set=product_set, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("product_set.name", product_set.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_product_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a ProductSet. All Products and ReferenceImages in
+        the ProductSet will be deleted.
+
+        The actual image files are not deleted from Google Cloud Storage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> client.delete_product_set(name)
+
+        Args:
+            name (str): Resource name of the ProductSet to delete.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_product_set,
+                default_retry=self._method_configs["DeleteProductSet"].retry,
+                default_timeout=self._method_configs["DeleteProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteProductSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_product(
+        self,
+        parent,
+        product,
+        product_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new product resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is longer than 4096
+           characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is missing or invalid.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = {}
+            >>>
+            >>> # TODO: Initialize `product_id`:
+            >>> product_id = ''
+            >>>
+            >>> response = client.create_product(parent, product, product_id)
+
+        Args:
+            parent (str): The project in which the Product should be created.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product (Union[dict, ~google.cloud.vision_v1p3beta1.types.Product]): The product to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.Product`
+            product_id (str): 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 error is returned with code ALREADY\_EXISTS. Must be at most 128
+                characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_product,
+                default_retry=self._method_configs["CreateProduct"].retry,
+                default_timeout=self._method_configs["CreateProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateProductRequest(
+            parent=parent, product=product, product_id=product_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_products(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists products in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_products(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_products(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project OR ProductSet from which Products should be listed.
+
+                Format: ``projects/PROJECT_ID/locations/LOC_ID``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p3beta1.types.Product` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_products" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_products"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_products,
+                default_retry=self._method_configs["ListProducts"].retry,
+                default_timeout=self._method_configs["ListProducts"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_products"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="products",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_product(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a Product.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> response = client.get_product(name)
+
+        Args:
+            name (str): Resource name of the Product to get.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_product,
+                default_retry=self._method_configs["GetProduct"].retry,
+                default_timeout=self._method_configs["GetProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetProductRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_product(
+        self,
+        product,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Makes changes to a Product resource. Only display\_name, description and
+        labels can be updated right now.
+
+        If labels are updated, the change will not be reflected in queries until
+        the next index time.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but is missing from the request or longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is present in update\_mask
+           but is longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is present in
+           update\_mask.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_product(product, update_mask)
+
+        Args:
+            product (Union[dict, ~google.cloud.vision_v1p3beta1.types.Product]): The Product resource which replaces the one on the server.
+                product.name is immutable.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.Product`
+            update_mask (Union[dict, ~google.cloud.vision_v1p3beta1.types.FieldMask]): The ``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 ``description``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_product,
+                default_retry=self._method_configs["UpdateProduct"].retry,
+                default_timeout=self._method_configs["UpdateProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.UpdateProductRequest(
+            product=product, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("product.name", product.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_product(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a product and its reference images.
+
+        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.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> client.delete_product(name)
+
+        Args:
+            name (str): Resource name of product to delete.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_product,
+                default_retry=self._method_configs["DeleteProduct"].retry,
+                default_timeout=self._method_configs["DeleteProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteProductRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_reference_image(
+        self,
+        parent,
+        reference_image,
+        reference_image_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new ReferenceImage resource.
+
+        The ``bounding_poly`` field is optional. If ``bounding_poly`` is not
+        specified, the system will try to detect regions of interest in the
+        image that are compatible with the product\_category on the parent
+        product. If it is specified, detection is ALWAYS skipped. The system
+        converts polygons into non-rotated rectangles.
+
+        Note that the pipeline will resize the image if the image resolution is
+        too large to process (above 50MP).
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if the image\_uri is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if the product does not exist.
+        -  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.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> # TODO: Initialize `reference_image`:
+            >>> reference_image = {}
+            >>>
+            >>> # TODO: Initialize `reference_image_id`:
+            >>> reference_image_id = ''
+            >>>
+            >>> response = client.create_reference_image(parent, reference_image, reference_image_id)
+
+        Args:
+            parent (str): Resource name of the product in which to create the reference image.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+            reference_image (Union[dict, ~google.cloud.vision_v1p3beta1.types.ReferenceImage]): The reference image to create.
+                If an image ID is specified, it is ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.ReferenceImage`
+            reference_image_id (str): 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
+                already in use, an error is returned with code ALREADY\_EXISTS. Must be
+                at most 128 characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.ReferenceImage` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_reference_image,
+                default_retry=self._method_configs["CreateReferenceImage"].retry,
+                default_timeout=self._method_configs["CreateReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateReferenceImageRequest(
+            parent=parent,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_reference_image(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a reference image.
+
+        The image metadata will be deleted right away, but search queries
+        against ProductSets containing the image may still work until all
+        related 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.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.reference_image_path('[PROJECT]', '[LOCATION]', '[PRODUCT]', '[REFERENCE_IMAGE]')
+            >>>
+            >>> client.delete_reference_image(name)
+
+        Args:
+            name (str): The resource name of the reference image to delete.
+
+                Format is:
+
+                ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_reference_image,
+                default_retry=self._method_configs["DeleteReferenceImage"].retry,
+                default_timeout=self._method_configs["DeleteReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteReferenceImageRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_reference_images(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists reference images.
+
+        Possible errors:
+
+        -  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.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_reference_images(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_reference_images(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the product containing the reference images.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p3beta1.types.ReferenceImage` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_reference_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_reference_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_reference_images,
+                default_retry=self._method_configs["ListReferenceImages"].retry,
+                default_timeout=self._method_configs["ListReferenceImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListReferenceImagesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_reference_images"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="reference_images",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_reference_image(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a ReferenceImage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the specified image does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.reference_image_path('[PROJECT]', '[LOCATION]', '[PRODUCT]', '[REFERENCE_IMAGE]')
+            >>>
+            >>> response = client.get_reference_image(name)
+
+        Args:
+            name (str): The resource name of the ReferenceImage to get.
+
+                Format is:
+
+                ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types.ReferenceImage` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_reference_image,
+                default_retry=self._method_configs["GetReferenceImage"].retry,
+                default_timeout=self._method_configs["GetReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetReferenceImageRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def add_product_to_product_set(
+        self,
+        name,
+        product,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Adds a Product to the specified ProductSet. If the Product is already
+        present, no change is made.
+
+        One Product can be added to at most 100 ProductSets.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product or the ProductSet doesn't exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = ''
+            >>>
+            >>> client.add_product_to_product_set(name, product)
+
+        Args:
+            name (str): The resource name for the ProductSet to modify.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            product (str): The resource name for the Product to be added to this ProductSet.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "add_product_to_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "add_product_to_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.add_product_to_product_set,
+                default_retry=self._method_configs["AddProductToProductSet"].retry,
+                default_timeout=self._method_configs["AddProductToProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.AddProductToProductSetRequest(
+            name=name, product=product
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["add_product_to_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def remove_product_from_product_set(
+        self,
+        name,
+        product,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Removes a Product from the specified ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND If the Product is not found under the ProductSet.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = ''
+            >>>
+            >>> client.remove_product_from_product_set(name, product)
+
+        Args:
+            name (str): The resource name for the ProductSet to modify.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            product (str): The resource name for the Product to be removed from this ProductSet.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "remove_product_from_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "remove_product_from_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.remove_product_from_product_set,
+                default_retry=self._method_configs["RemoveProductFromProductSet"].retry,
+                default_timeout=self._method_configs[
+                    "RemoveProductFromProductSet"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.RemoveProductFromProductSetRequest(
+            name=name, product=product
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["remove_product_from_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_products_in_product_set(
+        self,
+        name,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the Products in a ProductSet, in an unspecified order. If the
+        ProductSet does not exist, the products field of the response will be
+        empty.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_products_in_product_set(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_products_in_product_set(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The ProductSet resource for which to retrieve Products.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p3beta1.types.Product` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_products_in_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_products_in_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_products_in_product_set,
+                default_retry=self._method_configs["ListProductsInProductSet"].retry,
+                default_timeout=self._method_configs[
+                    "ListProductsInProductSet"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductsInProductSetRequest(
+            name=name, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_products_in_product_set"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="products",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def import_product_sets(
+        self,
+        parent,
+        input_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Asynchronous API that imports a list of reference images to specified
+        product sets based on a list of image information.
+
+        The ``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``.
+
+        Example:
+            >>> from google.cloud import vision_v1p3beta1
+            >>>
+            >>> client = vision_v1p3beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_product_sets(parent, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The project in which the ProductSets should be imported.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            input_config (Union[dict, ~google.cloud.vision_v1p3beta1.types.ImportProductSetsInputConfig]): The input content for the list of requests.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p3beta1.types.ImportProductSetsInputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p3beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_product_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_product_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_product_sets,
+                default_retry=self._method_configs["ImportProductSets"].retry,
+                default_timeout=self._method_configs["ImportProductSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ImportProductSetsRequest(
+            parent=parent, input_config=input_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_product_sets"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            product_search_service_pb2.ImportProductSetsResponse,
+            metadata_type=product_search_service_pb2.BatchOperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/product_search_client_config.py b/vision/google/cloud/vision_v1p3beta1/gapic/product_search_client_config.py
new file mode 100644
index 000000000000..9c732f9258fc
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/product_search_client_config.py
@@ -0,0 +1,113 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1p3beta1.ProductSearch": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProductSets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProducts": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListReferenceImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AddProductToProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "RemoveProductFromProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProductsInProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportProductSets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/transports/__init__.py b/vision/google/cloud/vision_v1p3beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/transports/image_annotator_grpc_transport.py b/vision/google/cloud/vision_v1p3beta1/gapic/transports/image_annotator_grpc_transport.py
new file mode 100644
index 000000000000..538ff7dc2843
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/transports/image_annotator_grpc_transport.py
@@ -0,0 +1,150 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1p3beta1.proto import image_annotator_pb2_grpc
+
+
+class ImageAnnotatorGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1p3beta1 ImageAnnotator API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "image_annotator_stub": image_annotator_pb2_grpc.ImageAnnotatorStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_images`.
+
+        Run image detection and annotation for a batch of images.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateImages
+
+    @property
+    def async_batch_annotate_files(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.async_batch_annotate_files`.
+
+        Run asynchronous image detection and annotation for a list of generic
+        files, such as PDF files, which may contain multiple pages and multiple
+        images per page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].AsyncBatchAnnotateFiles
diff --git a/vision/google/cloud/vision_v1p3beta1/gapic/transports/product_search_grpc_transport.py b/vision/google/cloud/vision_v1p3beta1/gapic/transports/product_search_grpc_transport.py
new file mode 100644
index 000000000000..b2654635ea7d
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/gapic/transports/product_search_grpc_transport.py
@@ -0,0 +1,490 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2_grpc
+
+
+class ProductSearchGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1p3beta1 ProductSearch API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "product_search_stub": product_search_service_pb2_grpc.ProductSearchStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_product_set`.
+
+        Creates and returns a new ProductSet resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing, or is longer
+           than 4096 characters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateProductSet
+
+    @property
+    def list_product_sets(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_product_sets`.
+
+        Lists ProductSets in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100, or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProductSets
+
+    @property
+    def get_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_product_set`.
+
+        Gets information associated with a ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetProductSet
+
+    @property
+    def update_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.update_product_set`.
+
+        Makes changes to a ProductSet resource. Only display\_name can be
+        updated currently.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but missing from the request or longer than 4096 characters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].UpdateProductSet
+
+    @property
+    def delete_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_product_set`.
+
+        Permanently deletes a ProductSet. All Products and ReferenceImages in
+        the ProductSet will be deleted.
+
+        The actual image files are not deleted from Google Cloud Storage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteProductSet
+
+    @property
+    def create_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_product`.
+
+        Creates and returns a new product resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is longer than 4096
+           characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is missing or invalid.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateProduct
+
+    @property
+    def list_products(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_products`.
+
+        Lists products in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProducts
+
+    @property
+    def get_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_product`.
+
+        Gets information associated with a Product.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetProduct
+
+    @property
+    def update_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.update_product`.
+
+        Makes changes to a Product resource. Only display\_name, description and
+        labels can be updated right now.
+
+        If labels are updated, the change will not be reflected in queries until
+        the next index time.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but is missing from the request or longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is present in update\_mask
+           but is longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is present in
+           update\_mask.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].UpdateProduct
+
+    @property
+    def delete_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_product`.
+
+        Permanently deletes a product and its reference images.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteProduct
+
+    @property
+    def create_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_reference_image`.
+
+        Creates and returns a new ReferenceImage resource.
+
+        The ``bounding_poly`` field is optional. If ``bounding_poly`` is not
+        specified, the system will try to detect regions of interest in the
+        image that are compatible with the product\_category on the parent
+        product. If it is specified, detection is ALWAYS skipped. The system
+        converts polygons into non-rotated rectangles.
+
+        Note that the pipeline will resize the image if the image resolution is
+        too large to process (above 50MP).
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if the image\_uri is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if the product does not exist.
+        -  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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateReferenceImage
+
+    @property
+    def delete_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_reference_image`.
+
+        Permanently deletes a reference image.
+
+        The image metadata will be deleted right away, but search queries
+        against ProductSets containing the image may still work until all
+        related 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteReferenceImage
+
+    @property
+    def list_reference_images(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_reference_images`.
+
+        Lists reference images.
+
+        Possible errors:
+
+        -  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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListReferenceImages
+
+    @property
+    def get_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_reference_image`.
+
+        Gets information associated with a ReferenceImage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the specified image does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetReferenceImage
+
+    @property
+    def add_product_to_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.add_product_to_product_set`.
+
+        Adds a Product to the specified ProductSet. If the Product is already
+        present, no change is made.
+
+        One Product can be added to at most 100 ProductSets.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product or the ProductSet doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].AddProductToProductSet
+
+    @property
+    def remove_product_from_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.remove_product_from_product_set`.
+
+        Removes a Product from the specified ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND If the Product is not found under the ProductSet.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].RemoveProductFromProductSet
+
+    @property
+    def list_products_in_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_products_in_product_set`.
+
+        Lists the Products in a ProductSet, in an unspecified order. If the
+        ProductSet does not exist, the products field of the response will be
+        empty.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProductsInProductSet
+
+    @property
+    def import_product_sets(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.import_product_sets`.
+
+        Asynchronous API that imports a list of reference images to specified
+        product sets based on a list of image information.
+
+        The ``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``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ImportProductSets
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/__init__.py b/vision/google/cloud/vision_v1p3beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/geometry.proto b/vision/google/cloud/vision_v1p3beta1/proto/geometry.proto
new file mode 100644
index 000000000000..28b768eaa792
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/geometry.proto
@@ -0,0 +1,75 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "GeometryProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+// 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;
+}
+
+// A normalized bounding polygon around a portion of an image.
+message NormalizedBoundingPoly {
+  // Normalized vertices of the bounding polygon.
+  repeated NormalizedVertex vertices = 1;
+}
+
+// A 3D position in the image, used primarily for Face detection landmarks.
+// A valid Position must have both x and y coordinates.
+// The position coordinates are in the same scale as the original image.
+message Position {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+
+  // Z coordinate (or depth).
+  float z = 3;
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/geometry_pb2.py b/vision/google/cloud/vision_v1p3beta1/proto/geometry_pb2.py
new file mode 100644
index 000000000000..f2ba67341ed1
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/geometry_pb2.py
@@ -0,0 +1,429 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p3beta1/proto/geometry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p3beta1/proto/geometry.proto",
+    package="google.cloud.vision.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p3beta1B\rGeometryProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/vision_v1p3beta1/proto/geometry.proto\x12\x1dgoogle.cloud.vision.v1p3beta1\x1a\x1cgoogle/api/annotations.proto"\x1e\n\x06Vertex\x12\t\n\x01x\x18\x01 \x01(\x05\x12\t\n\x01y\x18\x02 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"\x95\x01\n\x0c\x42oundingPoly\x12\x37\n\x08vertices\x18\x01 \x03(\x0b\x32%.google.cloud.vision.v1p3beta1.Vertex\x12L\n\x13normalized_vertices\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.NormalizedVertex"[\n\x16NormalizedBoundingPoly\x12\x41\n\x08vertices\x18\x01 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.NormalizedVertex"+\n\x08Position\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02\x12\t\n\x01z\x18\x03 \x01(\x02\x42|\n!com.google.cloud.vision.v1p3beta1B\rGeometryProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_VERTEX = _descriptor.Descriptor(
+    name="Vertex",
+    full_name="google.cloud.vision.v1p3beta1.Vertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p3beta1.Vertex.x",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p3beta1.Vertex.y",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=115,
+    serialized_end=145,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.vision.v1p3beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p3beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p3beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=147,
+    serialized_end=187,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.vision.v1p3beta1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.vision.v1p3beta1.BoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.vision.v1p3beta1.BoundingPoly.normalized_vertices",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=190,
+    serialized_end=339,
+)
+
+
+_NORMALIZEDBOUNDINGPOLY = _descriptor.Descriptor(
+    name="NormalizedBoundingPoly",
+    full_name="google.cloud.vision.v1p3beta1.NormalizedBoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.vision.v1p3beta1.NormalizedBoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=341,
+    serialized_end=432,
+)
+
+
+_POSITION = _descriptor.Descriptor(
+    name="Position",
+    full_name="google.cloud.vision.v1p3beta1.Position",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p3beta1.Position.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p3beta1.Position.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="z",
+            full_name="google.cloud.vision.v1p3beta1.Position.z",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=434,
+    serialized_end=477,
+)
+
+_BOUNDINGPOLY.fields_by_name["vertices"].message_type = _VERTEX
+_BOUNDINGPOLY.fields_by_name["normalized_vertices"].message_type = _NORMALIZEDVERTEX
+_NORMALIZEDBOUNDINGPOLY.fields_by_name["vertices"].message_type = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["Vertex"] = _VERTEX
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["NormalizedBoundingPoly"] = _NORMALIZEDBOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["Position"] = _POSITION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Vertex = _reflection.GeneratedProtocolMessageType(
+    "Vertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTEX,
+        __module__="google.cloud.vision_v1p3beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Vertex)
+    ),
+)
+_sym_db.RegisterMessage(Vertex)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.vision_v1p3beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.vision_v1p3beta1.proto.geometry_pb2",
+        __doc__="""A bounding polygon for the detected image annotation.
+  
+  
+  Attributes:
+      vertices:
+          The bounding polygon vertices.
+      normalized_vertices:
+          The bounding polygon normalized vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+NormalizedBoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "NormalizedBoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDBOUNDINGPOLY,
+        __module__="google.cloud.vision_v1p3beta1.proto.geometry_pb2",
+        __doc__="""A normalized bounding polygon around a portion of an image.
+  
+  
+  Attributes:
+      vertices:
+          Normalized vertices of the bounding polygon.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.NormalizedBoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedBoundingPoly)
+
+Position = _reflection.GeneratedProtocolMessageType(
+    "Position",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSITION,
+        __module__="google.cloud.vision_v1p3beta1.proto.geometry_pb2",
+        __doc__="""A 3D position in the image, used primarily for Face detection landmarks.
+  A valid Position must have both x and y coordinates. The position
+  coordinates are in the same scale as the original image.
+  
+  
+  Attributes:
+      x:
+          X coordinate.
+      y:
+          Y coordinate.
+      z:
+          Z coordinate (or depth).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Position)
+    ),
+)
+_sym_db.RegisterMessage(Position)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/geometry_pb2_grpc.py b/vision/google/cloud/vision_v1p3beta1/proto/geometry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/geometry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/image_annotator.proto b/vision/google/cloud/vision_v1p3beta1/proto/image_annotator.proto
new file mode 100644
index 000000000000..2ac3ddb8b21c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/image_annotator.proto
@@ -0,0 +1,803 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/cloud/vision/v1p3beta1/product_search.proto";
+import "google/cloud/vision/v1p3beta1/text_annotation.proto";
+import "google/cloud/vision/v1p3beta1/web_detection.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+import "google/type/latlng.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ImageAnnotatorProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+// Service that performs Google Cloud Vision API detection tasks over client
+// images, such as face, landmark, logo, label, and text detection. The
+// ImageAnnotator service returns detected entities from the images.
+service ImageAnnotator {
+  // Run image detection and annotation for a batch of images.
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
+      returns (BatchAnnotateImagesResponse) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/images:annotate"
+      body: "*"
+    };
+  }
+
+  // Run asynchronous image detection and annotation for a list of generic
+  // files, such as PDF files, which may contain multiple pages and multiple
+  // images per page. Progress and results can be retrieved through the
+  // `google.longrunning.Operations` interface.
+  // `Operation.metadata` contains `OperationMetadata` (metadata).
+  // `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/files:asyncBatchAnnotate"
+      body: "*"
+    };
+  }
+}
+
+// The type of Google Cloud Vision API detection to perform, and the maximum
+// number of results to return for that type. Multiple `Feature` objects can
+// be specified in the `features` list.
+message Feature {
+  // Type of Google Cloud Vision API feature to be extracted.
+  enum Type {
+    // Unspecified feature type.
+    TYPE_UNSPECIFIED = 0;
+
+    // Run face detection.
+    FACE_DETECTION = 1;
+
+    // Run landmark detection.
+    LANDMARK_DETECTION = 2;
+
+    // Run logo detection.
+    LOGO_DETECTION = 3;
+
+    // Run label detection.
+    LABEL_DETECTION = 4;
+
+    // Run text detection / optical character recognition (OCR). Text detection
+    // is optimized for areas of text within a larger image; if the image is
+    // a document, use `DOCUMENT_TEXT_DETECTION` instead.
+    TEXT_DETECTION = 5;
+
+    // Run dense text document OCR. Takes precedence when both
+    // `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` are present.
+    DOCUMENT_TEXT_DETECTION = 11;
+
+    // Run Safe Search to detect potentially unsafe
+    // or undesirable content.
+    SAFE_SEARCH_DETECTION = 6;
+
+    // Compute a set of image properties, such as the
+    // image's dominant colors.
+    IMAGE_PROPERTIES = 7;
+
+    // Run crop hints.
+    CROP_HINTS = 9;
+
+    // Run web detection.
+    WEB_DETECTION = 10;
+
+    // Run Product Search.
+    PRODUCT_SEARCH = 12;
+
+    // Run localizer for object detection.
+    OBJECT_LOCALIZATION = 19;
+  }
+
+  // The feature type.
+  Type type = 1;
+
+  // Maximum number of results of this type. Does not apply to
+  // `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
+  int32 max_results = 2;
+
+  // Model to use for the feature.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// External image source (Google Cloud Storage or web URL image location).
+message ImageSource {
+  // **Use `image_uri` instead.**
+  //
+  // The 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 gcs_image_uri = 1;
+
+  // The URI of the source image. Can be either:
+  //
+  // 1. A 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.
+  //
+  // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from
+  //    HTTP/HTTPS URLs, Google cannot guarantee that the request will be
+  //    completed. Your request may fail if the specified host denies the
+  //    request (e.g. due to request throttling or DOS prevention), or if Google
+  //    throttles requests to the site for abuse prevention. You should not
+  //    depend on externally-hosted images for production applications.
+  //
+  // When both `gcs_image_uri` and `image_uri` are specified, `image_uri` takes
+  // precedence.
+  string image_uri = 2;
+}
+
+// Client image to perform Google Cloud Vision API tasks over.
+message Image {
+  // 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 content = 1;
+
+  // Google Cloud Storage image location, or publicly-accessible image
+  // URL. If both `content` and `source` are provided for an image, `content`
+  // takes precedence and is used to perform the image annotation request.
+  ImageSource source = 2;
+}
+
+// A face annotation object contains the results of face detection.
+message FaceAnnotation {
+  // A face-specific landmark (for example, a face feature).
+  message Landmark {
+    // Face landmark (feature) type.
+    // Left and right are defined from the vantage of the viewer of the image
+    // without considering mirror projections typical of photos. So, `LEFT_EYE`,
+    // typically, is the person's right eye.
+    enum Type {
+      // Unknown face landmark detected. Should not be filled.
+      UNKNOWN_LANDMARK = 0;
+
+      // Left eye.
+      LEFT_EYE = 1;
+
+      // Right eye.
+      RIGHT_EYE = 2;
+
+      // Left of left eyebrow.
+      LEFT_OF_LEFT_EYEBROW = 3;
+
+      // Right of left eyebrow.
+      RIGHT_OF_LEFT_EYEBROW = 4;
+
+      // Left of right eyebrow.
+      LEFT_OF_RIGHT_EYEBROW = 5;
+
+      // Right of right eyebrow.
+      RIGHT_OF_RIGHT_EYEBROW = 6;
+
+      // Midpoint between eyes.
+      MIDPOINT_BETWEEN_EYES = 7;
+
+      // Nose tip.
+      NOSE_TIP = 8;
+
+      // Upper lip.
+      UPPER_LIP = 9;
+
+      // Lower lip.
+      LOWER_LIP = 10;
+
+      // Mouth left.
+      MOUTH_LEFT = 11;
+
+      // Mouth right.
+      MOUTH_RIGHT = 12;
+
+      // Mouth center.
+      MOUTH_CENTER = 13;
+
+      // Nose, bottom right.
+      NOSE_BOTTOM_RIGHT = 14;
+
+      // Nose, bottom left.
+      NOSE_BOTTOM_LEFT = 15;
+
+      // Nose, bottom center.
+      NOSE_BOTTOM_CENTER = 16;
+
+      // Left eye, top boundary.
+      LEFT_EYE_TOP_BOUNDARY = 17;
+
+      // Left eye, right corner.
+      LEFT_EYE_RIGHT_CORNER = 18;
+
+      // Left eye, bottom boundary.
+      LEFT_EYE_BOTTOM_BOUNDARY = 19;
+
+      // Left eye, left corner.
+      LEFT_EYE_LEFT_CORNER = 20;
+
+      // Right eye, top boundary.
+      RIGHT_EYE_TOP_BOUNDARY = 21;
+
+      // Right eye, right corner.
+      RIGHT_EYE_RIGHT_CORNER = 22;
+
+      // Right eye, bottom boundary.
+      RIGHT_EYE_BOTTOM_BOUNDARY = 23;
+
+      // Right eye, left corner.
+      RIGHT_EYE_LEFT_CORNER = 24;
+
+      // Left eyebrow, upper midpoint.
+      LEFT_EYEBROW_UPPER_MIDPOINT = 25;
+
+      // Right eyebrow, upper midpoint.
+      RIGHT_EYEBROW_UPPER_MIDPOINT = 26;
+
+      // Left ear tragion.
+      LEFT_EAR_TRAGION = 27;
+
+      // Right ear tragion.
+      RIGHT_EAR_TRAGION = 28;
+
+      // Left eye pupil.
+      LEFT_EYE_PUPIL = 29;
+
+      // Right eye pupil.
+      RIGHT_EYE_PUPIL = 30;
+
+      // Forehead glabella.
+      FOREHEAD_GLABELLA = 31;
+
+      // Chin gnathion.
+      CHIN_GNATHION = 32;
+
+      // Chin left gonion.
+      CHIN_LEFT_GONION = 33;
+
+      // Chin right gonion.
+      CHIN_RIGHT_GONION = 34;
+    }
+
+    // Face landmark type.
+    Type type = 3;
+
+    // Face landmark position.
+    Position position = 4;
+  }
+
+  // The bounding polygon around the face. The coordinates of the bounding box
+  // are in the original image's scale, as returned in `ImageParams`.
+  // The bounding box is computed to "frame" the face in accordance with human
+  // expectations. It is based on the landmarker results.
+  // Note that one or more x and/or y coordinates may not be generated in the
+  // `BoundingPoly` (the polygon will be unbounded) if only a partial face
+  // appears in the image to be annotated.
+  BoundingPoly bounding_poly = 1;
+
+  // The `fd_bounding_poly` bounding polygon is tighter than the
+  // `boundingPoly`, and encloses only the skin part of the face. Typically, it
+  // is used to eliminate the face from any image analysis that detects the
+  // "amount of skin" visible in an image. It is not based on the
+  // landmarker results, only on the initial face detection, hence
+  // the <code>fd</code> (face detection) prefix.
+  BoundingPoly fd_bounding_poly = 2;
+
+  // Detected face landmarks.
+  repeated Landmark landmarks = 3;
+
+  // Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
+  // of the face relative to the image vertical about the axis perpendicular to
+  // the face. Range [-180,180].
+  float roll_angle = 4;
+
+  // Yaw angle, which indicates the leftward/rightward angle that the face is
+  // pointing relative to the vertical plane perpendicular to the image. Range
+  // [-180,180].
+  float pan_angle = 5;
+
+  // Pitch angle, which indicates the upwards/downwards angle that the face is
+  // pointing relative to the image's horizontal plane. Range [-180,180].
+  float tilt_angle = 6;
+
+  // Detection confidence. Range [0, 1].
+  float detection_confidence = 7;
+
+  // Face landmarking confidence. Range [0, 1].
+  float landmarking_confidence = 8;
+
+  // Joy likelihood.
+  Likelihood joy_likelihood = 9;
+
+  // Sorrow likelihood.
+  Likelihood sorrow_likelihood = 10;
+
+  // Anger likelihood.
+  Likelihood anger_likelihood = 11;
+
+  // Surprise likelihood.
+  Likelihood surprise_likelihood = 12;
+
+  // Under-exposed likelihood.
+  Likelihood under_exposed_likelihood = 13;
+
+  // Blurred likelihood.
+  Likelihood blurred_likelihood = 14;
+
+  // Headwear likelihood.
+  Likelihood headwear_likelihood = 15;
+}
+
+// Detected entity location information.
+message LocationInfo {
+  // lat/long location coordinates.
+  google.type.LatLng lat_lng = 1;
+}
+
+// A `Property` consists of a user-supplied name/value pair.
+message Property {
+  // Name of the property.
+  string name = 1;
+
+  // Value of the property.
+  string value = 2;
+
+  // Value of numeric properties.
+  uint64 uint64_value = 3;
+}
+
+// Set of detected entity features.
+message EntityAnnotation {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string mid = 1;
+
+  // The language code for the locale in which the entity textual
+  // `description` is expressed.
+  string locale = 2;
+
+  // Entity textual description, expressed in its `locale` language.
+  string description = 3;
+
+  // Overall score of the result. Range [0, 1].
+  float score = 4;
+
+  // **Deprecated. Use `score` instead.**
+  // The accuracy of the entity detection in an image.
+  // For example, for an image in which the "Eiffel Tower" entity is detected,
+  // this field represents the confidence that there is a tower in the query
+  // image. Range [0, 1].
+  float confidence = 5;
+
+  // The relevancy of the ICA (Image Content Annotation) label to the
+  // image. For example, the relevancy of "tower" is likely higher to an image
+  // containing the detected "Eiffel Tower" than to an image containing a
+  // detected distant towering building, even though the confidence that
+  // there is a tower in each image may be the same. Range [0, 1].
+  float topicality = 6;
+
+  // Image region to which this entity belongs. Not produced
+  // for `LABEL_DETECTION` features.
+  BoundingPoly bounding_poly = 7;
+
+  // The location information for the detected entity. Multiple
+  // `LocationInfo` elements can be present because one location may
+  // indicate the location of the scene in the image, and another location
+  // may indicate the location of the place where the image was taken.
+  // Location information is usually present for landmarks.
+  repeated LocationInfo locations = 8;
+
+  // Some entities may have optional user-supplied `Property` (name/value)
+  // fields, such a score or string that qualifies the entity.
+  repeated Property properties = 9;
+}
+
+// Set of detected objects with bounding boxes.
+message LocalizedObjectAnnotation {
+  // 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;
+
+  // Image region to which this object belongs. This must be populated.
+  BoundingPoly bounding_poly = 5;
+}
+
+// Set of features pertaining to the image, computed by computer vision
+// methods over safe-search verticals (for example, adult, spoof, medical,
+// violence).
+message SafeSearchAnnotation {
+  // Represents the adult content likelihood for the image. Adult content may
+  // contain elements such as nudity, pornographic images or cartoons, or
+  // sexual activities.
+  Likelihood adult = 1;
+
+  // Spoof likelihood. The likelihood that an modification
+  // was made to the image's canonical version to make it appear
+  // funny or offensive.
+  Likelihood spoof = 2;
+
+  // Likelihood that this is a medical image.
+  Likelihood medical = 3;
+
+  // Likelihood that this image contains violent content.
+  Likelihood violence = 4;
+
+  // Likelihood that the request image contains racy content. Racy content may
+  // include (but is not limited to) skimpy or sheer clothing, strategically
+  // covered nudity, lewd or provocative poses, or close-ups of sensitive
+  // body areas.
+  Likelihood racy = 9;
+}
+
+// Rectangle determined by min and max `LatLng` pairs.
+message LatLongRect {
+  // Min lat/long pair.
+  google.type.LatLng min_lat_lng = 1;
+
+  // Max lat/long pair.
+  google.type.LatLng max_lat_lng = 2;
+}
+
+// Color information consists of RGB channels, score, and the fraction of
+// the image that the color occupies in the image.
+message ColorInfo {
+  // RGB components of the color.
+  google.type.Color color = 1;
+
+  // Image-specific score for this color. Value in range [0, 1].
+  float score = 2;
+
+  // The fraction of pixels the color occupies in the image.
+  // Value in range [0, 1].
+  float pixel_fraction = 3;
+}
+
+// Set of dominant colors and their corresponding scores.
+message DominantColorsAnnotation {
+  // RGB color values with their score and pixel fraction.
+  repeated ColorInfo colors = 1;
+}
+
+// Stores image properties, such as dominant colors.
+message ImageProperties {
+  // If present, dominant colors completed successfully.
+  DominantColorsAnnotation dominant_colors = 1;
+}
+
+// Single crop hint that is used to generate a new crop when serving an image.
+message CropHint {
+  // The bounding polygon for the crop region. The coordinates of the bounding
+  // box are in the original image's scale, as returned in `ImageParams`.
+  BoundingPoly bounding_poly = 1;
+
+  // Confidence of this being a salient region.  Range [0, 1].
+  float confidence = 2;
+
+  // Fraction of importance of this salient region with respect to the original
+  // image.
+  float importance_fraction = 3;
+}
+
+// Set of crop hints that are used to generate new crops when serving images.
+message CropHintsAnnotation {
+  // Crop hint results.
+  repeated CropHint crop_hints = 1;
+}
+
+// Parameters for crop hints annotation request.
+message CropHintsParams {
+  // Aspect ratios in floats, representing the ratio of the width to the height
+  // of the image. For example, if the desired aspect ratio is 4/3, the
+  // corresponding float value should be 1.33333.  If not specified, the
+  // best possible crop is returned. The number of provided aspect ratios is
+  // limited to a maximum of 16; any aspect ratios provided after the 16th are
+  // ignored.
+  repeated float aspect_ratios = 1;
+}
+
+// Parameters for web detection request.
+message WebDetectionParams {
+  // Whether to include results derived from the geo information in the image.
+  bool include_geo_results = 2;
+}
+
+// Image context and/or feature-specific parameters.
+message ImageContext {
+  // Not used.
+  LatLongRect lat_long_rect = 1;
+
+  // List of languages to use for TEXT_DETECTION. 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). Text detection returns an
+  // error if one or more of the specified languages is not one of the
+  // [supported languages](/vision/docs/languages).
+  repeated string language_hints = 2;
+
+  // Parameters for crop hints annotation request.
+  CropHintsParams crop_hints_params = 4;
+
+  // Parameters for product search.
+  google.cloud.vision.v1p3beta1.ProductSearchParams product_search_params = 5;
+
+  // Parameters for web detection.
+  WebDetectionParams web_detection_params = 6;
+}
+
+// Request for performing Google Cloud Vision API tasks over a user-provided
+// image, with user-requested features.
+message AnnotateImageRequest {
+  // The image to be processed.
+  Image image = 1;
+
+  // Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image.
+  ImageContext image_context = 3;
+}
+
+// If an image was produced from a file (e.g. a PDF), this message gives
+// information about the source of that image.
+message ImageAnnotationContext {
+  // The URI of the file used to produce the image.
+  string uri = 1;
+
+  // If the file was a PDF or TIFF, this field gives the page number within
+  // the file used to produce the image.
+  int32 page_number = 2;
+}
+
+// Response to an image annotation request.
+message AnnotateImageResponse {
+  // If present, face detection has completed successfully.
+  repeated FaceAnnotation face_annotations = 1;
+
+  // If present, landmark detection has completed successfully.
+  repeated EntityAnnotation landmark_annotations = 2;
+
+  // If present, logo detection has completed successfully.
+  repeated EntityAnnotation logo_annotations = 3;
+
+  // If present, label detection has completed successfully.
+  repeated EntityAnnotation label_annotations = 4;
+
+  // If present, localized object detection has completed successfully.
+  // This will be sorted descending by confidence score.
+  repeated LocalizedObjectAnnotation localized_object_annotations = 22;
+
+  // If present, text (OCR) detection has completed successfully.
+  repeated EntityAnnotation text_annotations = 5;
+
+  // If present, text (OCR) detection or document (OCR) text detection has
+  // completed successfully.
+  // This annotation provides the structural hierarchy for the OCR detected
+  // text.
+  TextAnnotation full_text_annotation = 12;
+
+  // If present, safe-search annotation has completed successfully.
+  SafeSearchAnnotation safe_search_annotation = 6;
+
+  // If present, image properties were extracted successfully.
+  ImageProperties image_properties_annotation = 8;
+
+  // If present, crop hints have completed successfully.
+  CropHintsAnnotation crop_hints_annotation = 11;
+
+  // If present, web detection has completed successfully.
+  WebDetection web_detection = 13;
+
+  // If present, product search has completed successfully.
+  google.cloud.vision.v1p3beta1.ProductSearchResults product_search_results =
+      14;
+
+  // If set, represents the error message for the operation.
+  // Note that filled-in image annotations are guaranteed to be
+  // correct, even when `error` is set.
+  google.rpc.Status error = 9;
+
+  // If present, contextual information is needed to understand where this image
+  // comes from.
+  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;
+}
+
+// Multiple image annotation requests are batched into a single service call.
+message BatchAnnotateImagesRequest {
+  // Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1;
+}
+
+// Response to a batch image annotation request.
+message BatchAnnotateImagesResponse {
+  // Individual responses to image annotation requests within the batch.
+  repeated AnnotateImageResponse responses = 1;
+}
+
+// An offline file annotation request.
+message AsyncAnnotateFileRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1;
+
+  // Required. Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image(s) in the file.
+  ImageContext image_context = 3;
+
+  // Required. The desired output location and metadata (e.g. format).
+  OutputConfig output_config = 4;
+}
+
+// The response for a single offline file annotation request.
+message AsyncAnnotateFileResponse {
+  // The output location and metadata from AsyncAnnotateFileRequest.
+  OutputConfig output_config = 1;
+}
+
+// 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;
+}
+
+// Response to an async batch file annotation request.
+message AsyncBatchAnnotateFilesResponse {
+  // The list of file annotation responses, one for each request in
+  // AsyncBatchAnnotateFilesRequest.
+  repeated AsyncAnnotateFileResponse responses = 1;
+}
+
+// The desired input location and metadata.
+message InputConfig {
+  // The Google Cloud Storage location to read the input from.
+  GcsSource gcs_source = 1;
+
+  // The type of the file. Currently only "application/pdf" and "image/tiff"
+  // are supported. Wildcards are not supported.
+  string mime_type = 2;
+}
+
+// The desired output location and metadata.
+message OutputConfig {
+  // The Google Cloud Storage location to write the output(s) to.
+  GcsDestination gcs_destination = 1;
+
+  // The max number of response protos to put into each output JSON file 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 response protos will
+  // be generated. If `batch_size` = 20, then 5 json files each
+  // containing 20 response protos will be written under the prefix
+  // `gcs_destination`.`uri`.
+  //
+  // Currently, batch_size only applies to GcsDestination, with potential future
+  // support for other output configurations.
+  int32 batch_size = 2;
+}
+
+// The Google Cloud Storage location where the input will be read from.
+message GcsSource {
+  // Google Cloud Storage URI for the input file. This must only be a
+  // Google Cloud Storage object. Wildcards are not currently supported.
+  string uri = 1;
+}
+
+// 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 `/`.
+  //
+  // Examples:
+  //
+  // *    File: gs://bucket-name/filename.json
+  // *    Prefix: gs://bucket-name/prefix/here/
+  // *    File: gs://bucket-name/prefix/here
+  //
+  // If multiple outputs, each response is still AnnotateFileResponse, each of
+  // which contains some subset of the full list of AnnotateImageResponse.
+  // Multiple outputs can happen if, for example, the output JSON is too large
+  // and overflows into multiple sharded files.
+  string uri = 1;
+}
+
+// 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;
+}
+
+// Contains metadata for the BatchAnnotateImages operation.
+message OperationMetadata {
+  // Batch operation states.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is received.
+    CREATED = 1;
+
+    // Request is actively being processed.
+    RUNNING = 2;
+
+    // The batch processing is done.
+    DONE = 3;
+
+    // The batch processing was cancelled.
+    CANCELLED = 4;
+  }
+  // Current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was received.
+  google.protobuf.Timestamp create_time = 5;
+
+  // The time when the operation result was last updated.
+  google.protobuf.Timestamp update_time = 6;
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/image_annotator_pb2.py b/vision/google/cloud/vision_v1p3beta1/proto/image_annotator_pb2.py
new file mode 100644
index 000000000000..93adcbe6cf16
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/image_annotator_pb2.py
@@ -0,0 +1,4171 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p3beta1/proto/image_annotator.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p3beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1p3beta1.proto import (
+    product_search_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__pb2,
+)
+from google.cloud.vision_v1p3beta1.proto import (
+    text_annotation_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_text__annotation__pb2,
+)
+from google.cloud.vision_v1p3beta1.proto import (
+    web_detection_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_web__detection__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.type import color_pb2 as google_dot_type_dot_color__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p3beta1/proto/image_annotator.proto",
+    package="google.cloud.vision.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p3beta1B\023ImageAnnotatorProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p3beta1/proto/image_annotator.proto\x12\x1dgoogle.cloud.vision.v1p3beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p3beta1/proto/geometry.proto\x1a\x38google/cloud/vision_v1p3beta1/proto/product_search.proto\x1a\x39google/cloud/vision_v1p3beta1/proto/text_annotation.proto\x1a\x37google/cloud/vision_v1p3beta1/proto/web_detection.proto\x1a#google/longrunning/operations.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x17google/type/color.proto\x1a\x18google/type/latlng.proto"\x8e\x03\n\x07\x46\x65\x61ture\x12\x39\n\x04type\x18\x01 \x01(\x0e\x32+.google.cloud.vision.v1p3beta1.Feature.Type\x12\x13\n\x0bmax_results\x18\x02 \x01(\x05\x12\r\n\x05model\x18\x03 \x01(\t"\xa3\x02\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x01\x12\x16\n\x12LANDMARK_DETECTION\x10\x02\x12\x12\n\x0eLOGO_DETECTION\x10\x03\x12\x13\n\x0fLABEL_DETECTION\x10\x04\x12\x12\n\x0eTEXT_DETECTION\x10\x05\x12\x1b\n\x17\x44OCUMENT_TEXT_DETECTION\x10\x0b\x12\x19\n\x15SAFE_SEARCH_DETECTION\x10\x06\x12\x14\n\x10IMAGE_PROPERTIES\x10\x07\x12\x0e\n\nCROP_HINTS\x10\t\x12\x11\n\rWEB_DETECTION\x10\n\x12\x12\n\x0ePRODUCT_SEARCH\x10\x0c\x12\x17\n\x13OBJECT_LOCALIZATION\x10\x13"7\n\x0bImageSource\x12\x15\n\rgcs_image_uri\x18\x01 \x01(\t\x12\x11\n\timage_uri\x18\x02 \x01(\t"T\n\x05Image\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\x0c\x12:\n\x06source\x18\x02 \x01(\x0b\x32*.google.cloud.vision.v1p3beta1.ImageSource"\x9b\x0e\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12\x45\n\x10\x66\x64_bounding_poly\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12I\n\tlandmarks\x18\x03 \x03(\x0b\x32\x36.google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark\x12\x12\n\nroll_angle\x18\x04 \x01(\x02\x12\x11\n\tpan_angle\x18\x05 \x01(\x02\x12\x12\n\ntilt_angle\x18\x06 \x01(\x02\x12\x1c\n\x14\x64\x65tection_confidence\x18\x07 \x01(\x02\x12\x1e\n\x16landmarking_confidence\x18\x08 \x01(\x02\x12\x41\n\x0ejoy_likelihood\x18\t \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x44\n\x11sorrow_likelihood\x18\n \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x43\n\x10\x61nger_likelihood\x18\x0b \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x46\n\x13surprise_likelihood\x18\x0c \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12K\n\x18under_exposed_likelihood\x18\r \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x45\n\x12\x62lurred_likelihood\x18\x0e \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x46\n\x13headwear_likelihood\x18\x0f \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x1a\xc7\x07\n\x08Landmark\x12I\n\x04type\x18\x03 \x01(\x0e\x32;.google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark.Type\x12\x39\n\x08position\x18\x04 \x01(\x0b\x32\'.google.cloud.vision.v1p3beta1.Position"\xb4\x06\n\x04Type\x12\x14\n\x10UNKNOWN_LANDMARK\x10\x00\x12\x0c\n\x08LEFT_EYE\x10\x01\x12\r\n\tRIGHT_EYE\x10\x02\x12\x18\n\x14LEFT_OF_LEFT_EYEBROW\x10\x03\x12\x19\n\x15RIGHT_OF_LEFT_EYEBROW\x10\x04\x12\x19\n\x15LEFT_OF_RIGHT_EYEBROW\x10\x05\x12\x1a\n\x16RIGHT_OF_RIGHT_EYEBROW\x10\x06\x12\x19\n\x15MIDPOINT_BETWEEN_EYES\x10\x07\x12\x0c\n\x08NOSE_TIP\x10\x08\x12\r\n\tUPPER_LIP\x10\t\x12\r\n\tLOWER_LIP\x10\n\x12\x0e\n\nMOUTH_LEFT\x10\x0b\x12\x0f\n\x0bMOUTH_RIGHT\x10\x0c\x12\x10\n\x0cMOUTH_CENTER\x10\r\x12\x15\n\x11NOSE_BOTTOM_RIGHT\x10\x0e\x12\x14\n\x10NOSE_BOTTOM_LEFT\x10\x0f\x12\x16\n\x12NOSE_BOTTOM_CENTER\x10\x10\x12\x19\n\x15LEFT_EYE_TOP_BOUNDARY\x10\x11\x12\x19\n\x15LEFT_EYE_RIGHT_CORNER\x10\x12\x12\x1c\n\x18LEFT_EYE_BOTTOM_BOUNDARY\x10\x13\x12\x18\n\x14LEFT_EYE_LEFT_CORNER\x10\x14\x12\x1a\n\x16RIGHT_EYE_TOP_BOUNDARY\x10\x15\x12\x1a\n\x16RIGHT_EYE_RIGHT_CORNER\x10\x16\x12\x1d\n\x19RIGHT_EYE_BOTTOM_BOUNDARY\x10\x17\x12\x19\n\x15RIGHT_EYE_LEFT_CORNER\x10\x18\x12\x1f\n\x1bLEFT_EYEBROW_UPPER_MIDPOINT\x10\x19\x12 \n\x1cRIGHT_EYEBROW_UPPER_MIDPOINT\x10\x1a\x12\x14\n\x10LEFT_EAR_TRAGION\x10\x1b\x12\x15\n\x11RIGHT_EAR_TRAGION\x10\x1c\x12\x12\n\x0eLEFT_EYE_PUPIL\x10\x1d\x12\x13\n\x0fRIGHT_EYE_PUPIL\x10\x1e\x12\x15\n\x11\x46OREHEAD_GLABELLA\x10\x1f\x12\x11\n\rCHIN_GNATHION\x10 \x12\x14\n\x10\x43HIN_LEFT_GONION\x10!\x12\x15\n\x11\x43HIN_RIGHT_GONION\x10""4\n\x0cLocationInfo\x12$\n\x07lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng"=\n\x08Property\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12\x14\n\x0cuint64_value\x18\x03 \x01(\x04"\xbc\x02\n\x10\x45ntityAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x0e\n\x06locale\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x12\n\nconfidence\x18\x05 \x01(\x02\x12\x12\n\ntopicality\x18\x06 \x01(\x02\x12\x42\n\rbounding_poly\x18\x07 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12>\n\tlocations\x18\x08 \x03(\x0b\x32+.google.cloud.vision.v1p3beta1.LocationInfo\x12;\n\nproperties\x18\t \x03(\x0b\x32\'.google.cloud.vision.v1p3beta1.Property"\xa0\x01\n\x19LocalizedObjectAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x42\n\rbounding_poly\x18\x05 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly"\xbc\x02\n\x14SafeSearchAnnotation\x12\x38\n\x05\x61\x64ult\x18\x01 \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x38\n\x05spoof\x18\x02 \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12:\n\x07medical\x18\x03 \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12;\n\x08violence\x18\x04 \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood\x12\x37\n\x04racy\x18\t \x01(\x0e\x32).google.cloud.vision.v1p3beta1.Likelihood"a\n\x0bLatLongRect\x12(\n\x0bmin_lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng\x12(\n\x0bmax_lat_lng\x18\x02 \x01(\x0b\x32\x13.google.type.LatLng"U\n\tColorInfo\x12!\n\x05\x63olor\x18\x01 \x01(\x0b\x32\x12.google.type.Color\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x16\n\x0epixel_fraction\x18\x03 \x01(\x02"T\n\x18\x44ominantColorsAnnotation\x12\x38\n\x06\x63olors\x18\x01 \x03(\x0b\x32(.google.cloud.vision.v1p3beta1.ColorInfo"c\n\x0fImageProperties\x12P\n\x0f\x64ominant_colors\x18\x01 \x01(\x0b\x32\x37.google.cloud.vision.v1p3beta1.DominantColorsAnnotation"\x7f\n\x08\x43ropHint\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x1b\n\x13importance_fraction\x18\x03 \x01(\x02"R\n\x13\x43ropHintsAnnotation\x12;\n\ncrop_hints\x18\x01 \x03(\x0b\x32\'.google.cloud.vision.v1p3beta1.CropHint"(\n\x0f\x43ropHintsParams\x12\x15\n\raspect_ratios\x18\x01 \x03(\x02"1\n\x12WebDetectionParams\x12\x1b\n\x13include_geo_results\x18\x02 \x01(\x08"\xd8\x02\n\x0cImageContext\x12\x41\n\rlat_long_rect\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p3beta1.LatLongRect\x12\x16\n\x0elanguage_hints\x18\x02 \x03(\t\x12I\n\x11\x63rop_hints_params\x18\x04 \x01(\x0b\x32..google.cloud.vision.v1p3beta1.CropHintsParams\x12Q\n\x15product_search_params\x18\x05 \x01(\x0b\x32\x32.google.cloud.vision.v1p3beta1.ProductSearchParams\x12O\n\x14web_detection_params\x18\x06 \x01(\x0b\x32\x31.google.cloud.vision.v1p3beta1.WebDetectionParams"\xc9\x01\n\x14\x41nnotateImageRequest\x12\x33\n\x05image\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1p3beta1.Image\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p3beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.ImageContext":\n\x16ImageAnnotationContext\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\x13\n\x0bpage_number\x18\x02 \x01(\x05"\xbf\x08\n\x15\x41nnotateImageResponse\x12G\n\x10\x66\x61\x63\x65_annotations\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p3beta1.FaceAnnotation\x12M\n\x14landmark_annotations\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.EntityAnnotation\x12I\n\x10logo_annotations\x18\x03 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.EntityAnnotation\x12J\n\x11label_annotations\x18\x04 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.EntityAnnotation\x12^\n\x1clocalized_object_annotations\x18\x16 \x03(\x0b\x32\x38.google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation\x12I\n\x10text_annotations\x18\x05 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.EntityAnnotation\x12K\n\x14\x66ull_text_annotation\x18\x0c \x01(\x0b\x32-.google.cloud.vision.v1p3beta1.TextAnnotation\x12S\n\x16safe_search_annotation\x18\x06 \x01(\x0b\x32\x33.google.cloud.vision.v1p3beta1.SafeSearchAnnotation\x12S\n\x1bimage_properties_annotation\x18\x08 \x01(\x0b\x32..google.cloud.vision.v1p3beta1.ImageProperties\x12Q\n\x15\x63rop_hints_annotation\x18\x0b \x01(\x0b\x32\x32.google.cloud.vision.v1p3beta1.CropHintsAnnotation\x12\x42\n\rweb_detection\x18\r \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.WebDetection\x12S\n\x16product_search_results\x18\x0e \x01(\x0b\x32\x33.google.cloud.vision.v1p3beta1.ProductSearchResults\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status\x12\x46\n\x07\x63ontext\x18\x15 \x01(\x0b\x32\x35.google.cloud.vision.v1p3beta1.ImageAnnotationContext"\xa1\x01\n\x14\x41nnotateFileResponse\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p3beta1.InputConfig\x12G\n\tresponses\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.AnnotateImageResponse"c\n\x1a\x42\x61tchAnnotateImagesRequest\x12\x45\n\x08requests\x18\x01 \x03(\x0b\x32\x33.google.cloud.vision.v1p3beta1.AnnotateImageRequest"f\n\x1b\x42\x61tchAnnotateImagesResponse\x12G\n\tresponses\x18\x01 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.AnnotateImageResponse"\x9e\x02\n\x18\x41syncAnnotateFileRequest\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p3beta1.InputConfig\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p3beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.ImageContext\x12\x42\n\routput_config\x18\x04 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.OutputConfig"_\n\x19\x41syncAnnotateFileResponse\x12\x42\n\routput_config\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.OutputConfig"k\n\x1e\x41syncBatchAnnotateFilesRequest\x12I\n\x08requests\x18\x01 \x03(\x0b\x32\x37.google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest"n\n\x1f\x41syncBatchAnnotateFilesResponse\x12K\n\tresponses\x18\x01 \x03(\x0b\x32\x38.google.cloud.vision.v1p3beta1.AsyncAnnotateFileResponse"^\n\x0bInputConfig\x12<\n\ngcs_source\x18\x01 \x01(\x0b\x32(.google.cloud.vision.v1p3beta1.GcsSource\x12\x11\n\tmime_type\x18\x02 \x01(\t"j\n\x0cOutputConfig\x12\x46\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32-.google.cloud.vision.v1p3beta1.GcsDestination\x12\x12\n\nbatch_size\x18\x02 \x01(\x05"\x18\n\tGcsSource\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x1d\n\x0eGcsDestination\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x8f\x02\n\x11OperationMetadata\x12\x45\n\x05state\x18\x01 \x01(\x0e\x32\x36.google.cloud.vision.v1p3beta1.OperationMetadata.State\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Q\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x43REATED\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\r\n\tCANCELLED\x10\x04*e\n\nLikelihood\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xf0\x02\n\x0eImageAnnotator\x12\xb3\x01\n\x13\x42\x61tchAnnotateImages\x12\x39.google.cloud.vision.v1p3beta1.BatchAnnotateImagesRequest\x1a:.google.cloud.vision.v1p3beta1.BatchAnnotateImagesResponse"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p3beta1/images:annotate:\x01*\x12\xa7\x01\n\x17\x41syncBatchAnnotateFiles\x12=.google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesRequest\x1a\x1d.google.longrunning.Operation".\x82\xd3\xe4\x93\x02("#/v1p3beta1/files:asyncBatchAnnotate:\x01*B\x82\x01\n!com.google.cloud.vision.v1p3beta1B\x13ImageAnnotatorProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_text__annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_web__detection__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_type_dot_color__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.vision.v1p3beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7669,
+    serialized_end=7770,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+UNKNOWN = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_FEATURE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p3beta1.Feature.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LANDMARK_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGO_DETECTION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOCUMENT_TEXT_DETECTION",
+            index=6,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFE_SEARCH_DETECTION",
+            index=7,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_PROPERTIES",
+            index=8,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CROP_HINTS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEB_DETECTION",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRODUCT_SEARCH",
+            index=11,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_LOCALIZATION",
+            index=12,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=602,
+    serialized_end=893,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE_TYPE)
+
+_FACEANNOTATION_LANDMARK_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN_LANDMARK",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_LEFT_EYEBROW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_LEFT_EYEBROW",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_RIGHT_EYEBROW",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_RIGHT_EYEBROW",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDPOINT_BETWEEN_EYES",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_TIP", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_LIP", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOWER_LIP", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_LEFT", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_RIGHT", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_CENTER", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_RIGHT",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_LEFT",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_CENTER",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_TOP_BOUNDARY",
+            index=17,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_RIGHT_CORNER",
+            index=18,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_BOTTOM_BOUNDARY",
+            index=19,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_LEFT_CORNER",
+            index=20,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_TOP_BOUNDARY",
+            index=21,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_RIGHT_CORNER",
+            index=22,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_BOTTOM_BOUNDARY",
+            index=23,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_LEFT_CORNER",
+            index=24,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYEBROW_UPPER_MIDPOINT",
+            index=25,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYEBROW_UPPER_MIDPOINT",
+            index=26,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EAR_TRAGION",
+            index=27,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EAR_TRAGION",
+            index=28,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_PUPIL",
+            index=29,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_PUPIL",
+            index=30,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREHEAD_GLABELLA",
+            index=31,
+            number=31,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_GNATHION",
+            index=32,
+            number=32,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_LEFT_GONION",
+            index=33,
+            number=33,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_RIGHT_GONION",
+            index=34,
+            number=34,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2038,
+    serialized_end=2858,
+)
+_sym_db.RegisterEnumDescriptor(_FACEANNOTATION_LANDMARK_TYPE)
+
+_OPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1p3beta1.OperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=7586,
+    serialized_end=7667,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATIONMETADATA_STATE)
+
+
+_FEATURE = _descriptor.Descriptor(
+    name="Feature",
+    full_name="google.cloud.vision.v1p3beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p3beta1.Feature.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_results",
+            full_name="google.cloud.vision.v1p3beta1.Feature.max_results",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.vision.v1p3beta1.Feature.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FEATURE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=495,
+    serialized_end=893,
+)
+
+
+_IMAGESOURCE = _descriptor.Descriptor(
+    name="ImageSource",
+    full_name="google.cloud.vision.v1p3beta1.ImageSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_image_uri",
+            full_name="google.cloud.vision.v1p3beta1.ImageSource.gcs_image_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.vision.v1p3beta1.ImageSource.image_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=895,
+    serialized_end=950,
+)
+
+
+_IMAGE = _descriptor.Descriptor(
+    name="Image",
+    full_name="google.cloud.vision.v1p3beta1.Image",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1p3beta1.Image.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1p3beta1.Image.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=952,
+    serialized_end=1036,
+)
+
+
+_FACEANNOTATION_LANDMARK = _descriptor.Descriptor(
+    name="Landmark",
+    full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark.type",
+            index=0,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="position",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark.position",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FACEANNOTATION_LANDMARK_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1891,
+    serialized_end=2858,
+)
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fd_bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.fd_bounding_poly",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarks",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.landmarks",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roll_angle",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.roll_angle",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pan_angle",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.pan_angle",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tilt_angle",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.tilt_angle",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detection_confidence",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.detection_confidence",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarking_confidence",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.landmarking_confidence",
+            index=7,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="joy_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.joy_likelihood",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sorrow_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.sorrow_likelihood",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="anger_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.anger_likelihood",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surprise_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.surprise_likelihood",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="under_exposed_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.under_exposed_likelihood",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blurred_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.blurred_likelihood",
+            index=13,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headwear_likelihood",
+            full_name="google.cloud.vision.v1p3beta1.FaceAnnotation.headwear_likelihood",
+            index=14,
+            number=15,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FACEANNOTATION_LANDMARK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1039,
+    serialized_end=2858,
+)
+
+
+_LOCATIONINFO = _descriptor.Descriptor(
+    name="LocationInfo",
+    full_name="google.cloud.vision.v1p3beta1.LocationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.vision.v1p3beta1.LocationInfo.lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2860,
+    serialized_end=2912,
+)
+
+
+_PROPERTY = _descriptor.Descriptor(
+    name="Property",
+    full_name="google.cloud.vision.v1p3beta1.Property",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.Property.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1p3beta1.Property.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uint64_value",
+            full_name="google.cloud.vision.v1p3beta1.Property.uint64_value",
+            index=2,
+            number=3,
+            type=4,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2914,
+    serialized_end=2975,
+)
+
+
+_ENTITYANNOTATION = _descriptor.Descriptor(
+    name="EntityAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.EntityAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locale",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.locale",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topicality",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.topicality",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.bounding_poly",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.locations",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.vision.v1p3beta1.EntityAnnotation.properties",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2978,
+    serialized_end=3294,
+)
+
+
+_LOCALIZEDOBJECTANNOTATION = _descriptor.Descriptor(
+    name="LocalizedObjectAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation.bounding_poly",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3297,
+    serialized_end=3457,
+)
+
+
+_SAFESEARCHANNOTATION = _descriptor.Descriptor(
+    name="SafeSearchAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.SafeSearchAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="adult",
+            full_name="google.cloud.vision.v1p3beta1.SafeSearchAnnotation.adult",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spoof",
+            full_name="google.cloud.vision.v1p3beta1.SafeSearchAnnotation.spoof",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="medical",
+            full_name="google.cloud.vision.v1p3beta1.SafeSearchAnnotation.medical",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violence",
+            full_name="google.cloud.vision.v1p3beta1.SafeSearchAnnotation.violence",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="racy",
+            full_name="google.cloud.vision.v1p3beta1.SafeSearchAnnotation.racy",
+            index=4,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3460,
+    serialized_end=3776,
+)
+
+
+_LATLONGRECT = _descriptor.Descriptor(
+    name="LatLongRect",
+    full_name="google.cloud.vision.v1p3beta1.LatLongRect",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_lat_lng",
+            full_name="google.cloud.vision.v1p3beta1.LatLongRect.min_lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_lat_lng",
+            full_name="google.cloud.vision.v1p3beta1.LatLongRect.max_lat_lng",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3778,
+    serialized_end=3875,
+)
+
+
+_COLORINFO = _descriptor.Descriptor(
+    name="ColorInfo",
+    full_name="google.cloud.vision.v1p3beta1.ColorInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="color",
+            full_name="google.cloud.vision.v1p3beta1.ColorInfo.color",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.ColorInfo.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pixel_fraction",
+            full_name="google.cloud.vision.v1p3beta1.ColorInfo.pixel_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3877,
+    serialized_end=3962,
+)
+
+
+_DOMINANTCOLORSANNOTATION = _descriptor.Descriptor(
+    name="DominantColorsAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.DominantColorsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="colors",
+            full_name="google.cloud.vision.v1p3beta1.DominantColorsAnnotation.colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3964,
+    serialized_end=4048,
+)
+
+
+_IMAGEPROPERTIES = _descriptor.Descriptor(
+    name="ImageProperties",
+    full_name="google.cloud.vision.v1p3beta1.ImageProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dominant_colors",
+            full_name="google.cloud.vision.v1p3beta1.ImageProperties.dominant_colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4050,
+    serialized_end=4149,
+)
+
+
+_CROPHINT = _descriptor.Descriptor(
+    name="CropHint",
+    full_name="google.cloud.vision.v1p3beta1.CropHint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.CropHint.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.CropHint.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="importance_fraction",
+            full_name="google.cloud.vision.v1p3beta1.CropHint.importance_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4151,
+    serialized_end=4278,
+)
+
+
+_CROPHINTSANNOTATION = _descriptor.Descriptor(
+    name="CropHintsAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.CropHintsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crop_hints",
+            full_name="google.cloud.vision.v1p3beta1.CropHintsAnnotation.crop_hints",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4280,
+    serialized_end=4362,
+)
+
+
+_CROPHINTSPARAMS = _descriptor.Descriptor(
+    name="CropHintsParams",
+    full_name="google.cloud.vision.v1p3beta1.CropHintsParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aspect_ratios",
+            full_name="google.cloud.vision.v1p3beta1.CropHintsParams.aspect_ratios",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4364,
+    serialized_end=4404,
+)
+
+
+_WEBDETECTIONPARAMS = _descriptor.Descriptor(
+    name="WebDetectionParams",
+    full_name="google.cloud.vision.v1p3beta1.WebDetectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="include_geo_results",
+            full_name="google.cloud.vision.v1p3beta1.WebDetectionParams.include_geo_results",
+            index=0,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4406,
+    serialized_end=4455,
+)
+
+
+_IMAGECONTEXT = _descriptor.Descriptor(
+    name="ImageContext",
+    full_name="google.cloud.vision.v1p3beta1.ImageContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_long_rect",
+            full_name="google.cloud.vision.v1p3beta1.ImageContext.lat_long_rect",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.vision.v1p3beta1.ImageContext.language_hints",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_params",
+            full_name="google.cloud.vision.v1p3beta1.ImageContext.crop_hints_params",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_search_params",
+            full_name="google.cloud.vision.v1p3beta1.ImageContext.product_search_params",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection_params",
+            full_name="google.cloud.vision.v1p3beta1.ImageContext.web_detection_params",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4458,
+    serialized_end=4802,
+)
+
+
+_ANNOTATEIMAGEREQUEST = _descriptor.Descriptor(
+    name="AnnotateImageRequest",
+    full_name="google.cloud.vision.v1p3beta1.AnnotateImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageRequest.image",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4805,
+    serialized_end=5006,
+)
+
+
+_IMAGEANNOTATIONCONTEXT = _descriptor.Descriptor(
+    name="ImageAnnotationContext",
+    full_name="google.cloud.vision.v1p3beta1.ImageAnnotationContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p3beta1.ImageAnnotationContext.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_number",
+            full_name="google.cloud.vision.v1p3beta1.ImageAnnotationContext.page_number",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5008,
+    serialized_end=5066,
+)
+
+
+_ANNOTATEIMAGERESPONSE = _descriptor.Descriptor(
+    name="AnnotateImageResponse",
+    full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.face_annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmark_annotations",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.landmark_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logo_annotations",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.logo_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="localized_object_annotations",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.localized_object_annotations",
+            index=4,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.text_annotations",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_text_annotation",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.full_text_annotation",
+            index=6,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_annotation",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.safe_search_annotation",
+            index=7,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_properties_annotation",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.image_properties_annotation",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_annotation",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.crop_hints_annotation",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.web_detection",
+            index=10,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_search_results",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.product_search_results",
+            index=11,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.error",
+            index=12,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateImageResponse.context",
+            index=13,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5069,
+    serialized_end=6156,
+)
+
+
+_ANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AnnotateFileResponse",
+    full_name="google.cloud.vision.v1p3beta1.AnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateFileResponse.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p3beta1.AnnotateFileResponse.responses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6159,
+    serialized_end=6320,
+)
+
+
+_BATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1p3beta1.BatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p3beta1.BatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6322,
+    serialized_end=6421,
+)
+
+
+_BATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1p3beta1.BatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p3beta1.BatchAnnotateImagesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6423,
+    serialized_end=6525,
+)
+
+
+_ASYNCANNOTATEFILEREQUEST = _descriptor.Descriptor(
+    name="AsyncAnnotateFileRequest",
+    full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest.output_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6528,
+    serialized_end=6814,
+)
+
+
+_ASYNCANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AsyncAnnotateFileResponse",
+    full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p3beta1.AsyncAnnotateFileResponse.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6816,
+    serialized_end=6911,
+)
+
+
+_ASYNCBATCHANNOTATEFILESREQUEST = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesRequest",
+    full_name="google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6913,
+    serialized_end=7020,
+)
+
+
+_ASYNCBATCHANNOTATEFILESRESPONSE = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesResponse",
+    full_name="google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7022,
+    serialized_end=7132,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.vision.v1p3beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1p3beta1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.vision.v1p3beta1.InputConfig.mime_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7134,
+    serialized_end=7228,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.vision.v1p3beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.vision.v1p3beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="batch_size",
+            full_name="google.cloud.vision.v1p3beta1.OutputConfig.batch_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7230,
+    serialized_end=7336,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.vision.v1p3beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p3beta1.GcsSource.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7338,
+    serialized_end=7362,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.vision.v1p3beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p3beta1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7364,
+    serialized_end=7393,
+)
+
+
+_OPERATIONMETADATA = _descriptor.Descriptor(
+    name="OperationMetadata",
+    full_name="google.cloud.vision.v1p3beta1.OperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1p3beta1.OperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.vision.v1p3beta1.OperationMetadata.create_time",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.vision.v1p3beta1.OperationMetadata.update_time",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7396,
+    serialized_end=7667,
+)
+
+_FEATURE.fields_by_name["type"].enum_type = _FEATURE_TYPE
+_FEATURE_TYPE.containing_type = _FEATURE
+_IMAGE.fields_by_name["source"].message_type = _IMAGESOURCE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "type"
+].enum_type = _FACEANNOTATION_LANDMARK_TYPE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "position"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._POSITION
+)
+_FACEANNOTATION_LANDMARK.containing_type = _FACEANNOTATION
+_FACEANNOTATION_LANDMARK_TYPE.containing_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name[
+    "fd_bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name["landmarks"].message_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name["joy_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["sorrow_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["anger_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["surprise_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["under_exposed_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["blurred_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["headwear_likelihood"].enum_type = _LIKELIHOOD
+_LOCATIONINFO.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_ENTITYANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_ENTITYANNOTATION.fields_by_name["locations"].message_type = _LOCATIONINFO
+_ENTITYANNOTATION.fields_by_name["properties"].message_type = _PROPERTY
+_LOCALIZEDOBJECTANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_SAFESEARCHANNOTATION.fields_by_name["adult"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["spoof"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["medical"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["violence"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["racy"].enum_type = _LIKELIHOOD
+_LATLONGRECT.fields_by_name[
+    "min_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LATLONGRECT.fields_by_name[
+    "max_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_COLORINFO.fields_by_name["color"].message_type = google_dot_type_dot_color__pb2._COLOR
+_DOMINANTCOLORSANNOTATION.fields_by_name["colors"].message_type = _COLORINFO
+_IMAGEPROPERTIES.fields_by_name[
+    "dominant_colors"
+].message_type = _DOMINANTCOLORSANNOTATION
+_CROPHINT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CROPHINTSANNOTATION.fields_by_name["crop_hints"].message_type = _CROPHINT
+_IMAGECONTEXT.fields_by_name["lat_long_rect"].message_type = _LATLONGRECT
+_IMAGECONTEXT.fields_by_name["crop_hints_params"].message_type = _CROPHINTSPARAMS
+_IMAGECONTEXT.fields_by_name[
+    "product_search_params"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__pb2._PRODUCTSEARCHPARAMS
+)
+_IMAGECONTEXT.fields_by_name["web_detection_params"].message_type = _WEBDETECTIONPARAMS
+_ANNOTATEIMAGEREQUEST.fields_by_name["image"].message_type = _IMAGE
+_ANNOTATEIMAGEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEIMAGEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ANNOTATEIMAGERESPONSE.fields_by_name["face_annotations"].message_type = _FACEANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "landmark_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "logo_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "label_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "localized_object_annotations"
+].message_type = _LOCALIZEDOBJECTANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "text_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "full_text_annotation"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_text__annotation__pb2._TEXTANNOTATION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "safe_search_annotation"
+].message_type = _SAFESEARCHANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "image_properties_annotation"
+].message_type = _IMAGEPROPERTIES
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "crop_hints_annotation"
+].message_type = _CROPHINTSANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "web_detection"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_web__detection__pb2._WEBDETECTION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "product_search_results"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__pb2._PRODUCTSEARCHRESULTS
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEIMAGERESPONSE.fields_by_name["context"].message_type = _IMAGEANNOTATIONCONTEXT
+_ANNOTATEFILERESPONSE.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ANNOTATEFILERESPONSE.fields_by_name["responses"].message_type = _ANNOTATEIMAGERESPONSE
+_BATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_BATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEIMAGERESPONSE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCANNOTATEFILERESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEFILESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ASYNCANNOTATEFILEREQUEST
+_ASYNCBATCHANNOTATEFILESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ASYNCANNOTATEFILERESPONSE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OPERATIONMETADATA.fields_by_name["state"].enum_type = _OPERATIONMETADATA_STATE
+_OPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA_STATE.containing_type = _OPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.message_types_by_name["ImageSource"] = _IMAGESOURCE
+DESCRIPTOR.message_types_by_name["Image"] = _IMAGE
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["LocationInfo"] = _LOCATIONINFO
+DESCRIPTOR.message_types_by_name["Property"] = _PROPERTY
+DESCRIPTOR.message_types_by_name["EntityAnnotation"] = _ENTITYANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "LocalizedObjectAnnotation"
+] = _LOCALIZEDOBJECTANNOTATION
+DESCRIPTOR.message_types_by_name["SafeSearchAnnotation"] = _SAFESEARCHANNOTATION
+DESCRIPTOR.message_types_by_name["LatLongRect"] = _LATLONGRECT
+DESCRIPTOR.message_types_by_name["ColorInfo"] = _COLORINFO
+DESCRIPTOR.message_types_by_name["DominantColorsAnnotation"] = _DOMINANTCOLORSANNOTATION
+DESCRIPTOR.message_types_by_name["ImageProperties"] = _IMAGEPROPERTIES
+DESCRIPTOR.message_types_by_name["CropHint"] = _CROPHINT
+DESCRIPTOR.message_types_by_name["CropHintsAnnotation"] = _CROPHINTSANNOTATION
+DESCRIPTOR.message_types_by_name["CropHintsParams"] = _CROPHINTSPARAMS
+DESCRIPTOR.message_types_by_name["WebDetectionParams"] = _WEBDETECTIONPARAMS
+DESCRIPTOR.message_types_by_name["ImageContext"] = _IMAGECONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageRequest"] = _ANNOTATEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["ImageAnnotationContext"] = _IMAGEANNOTATIONCONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageResponse"] = _ANNOTATEIMAGERESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateFileResponse"] = _ANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesRequest"
+] = _BATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesResponse"
+] = _BATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["AsyncAnnotateFileRequest"] = _ASYNCANNOTATEFILEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncAnnotateFileResponse"
+] = _ASYNCANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesRequest"
+] = _ASYNCBATCHANNOTATEFILESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesResponse"
+] = _ASYNCBATCHANNOTATEFILESRESPONSE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OperationMetadata"] = _OPERATIONMETADATA
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Feature = _reflection.GeneratedProtocolMessageType(
+    "Feature",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEATURE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""The type of Google Cloud Vision API detection to perform, and the
+  maximum number of results to return for that type. Multiple ``Feature``
+  objects can be specified in the ``features`` list.
+  
+  
+  Attributes:
+      type:
+          The feature type.
+      max_results:
+          Maximum number of results of this type. Does not apply to
+          ``TEXT_DETECTION``, ``DOCUMENT_TEXT_DETECTION``, or
+          ``CROP_HINTS``.
+      model:
+          Model to use for the feature. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Feature)
+    ),
+)
+_sym_db.RegisterMessage(Feature)
+
+ImageSource = _reflection.GeneratedProtocolMessageType(
+    "ImageSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGESOURCE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""External image source (Google Cloud Storage or web URL image location).
+  
+  
+  Attributes:
+      gcs_image_uri:
+          **Use ``image_uri`` instead.**  The 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.
+      image_uri:
+          The URI of the source image. Can be either:  1. A 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.  2. A publicly-accessible image HTTP/HTTPS URL.
+          When fetching images from    HTTP/HTTPS URLs, Google cannot
+          guarantee that the request will be    completed. Your request
+          may fail if the specified host denies the    request (e.g. due
+          to request throttling or DOS prevention), or if    Google
+          throttles requests to the site for abuse prevention. You
+          should not depend on externally-hosted images for production
+          applications.  When both ``gcs_image_uri`` and ``image_uri``
+          are specified, ``image_uri`` takes precedence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImageSource)
+    ),
+)
+_sym_db.RegisterMessage(ImageSource)
+
+Image = _reflection.GeneratedProtocolMessageType(
+    "Image",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Client image to perform Google Cloud Vision API tasks over.
+  
+  
+  Attributes:
+      content:
+          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.
+      source:
+          Google Cloud Storage image location, or publicly-accessible
+          image URL. If both ``content`` and ``source`` are provided for
+          an image, ``content`` takes precedence and is used to perform
+          the image annotation request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Image)
+    ),
+)
+_sym_db.RegisterMessage(Image)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        Landmark=_reflection.GeneratedProtocolMessageType(
+            "Landmark",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FACEANNOTATION_LANDMARK,
+                __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+                __doc__="""A face-specific landmark (for example, a face feature).
+    
+    
+    Attributes:
+        type:
+            Face landmark type.
+        position:
+            Face landmark position.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.FaceAnnotation.Landmark)
+            ),
+        ),
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""A face annotation object contains the results of face detection.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the face. The coordinates of the
+          bounding box are in the original image's scale, as returned in
+          ``ImageParams``. The bounding box is computed to "frame" the
+          face in accordance with human expectations. It is based on the
+          landmarker results. Note that one or more x and/or y
+          coordinates may not be generated in the ``BoundingPoly`` (the
+          polygon will be unbounded) if only a partial face appears in
+          the image to be annotated.
+      fd_bounding_poly:
+          The ``fd_bounding_poly`` bounding polygon is tighter than the
+          ``boundingPoly``, and encloses only the skin part of the face.
+          Typically, it is used to eliminate the face from any image
+          analysis that detects the "amount of skin" visible in an
+          image. It is not based on the landmarker results, only on the
+          initial face detection, hence the fd (face detection) prefix.
+      landmarks:
+          Detected face landmarks.
+      roll_angle:
+          Roll angle, which indicates the amount of clockwise/anti-
+          clockwise rotation of the face relative to the image vertical
+          about the axis perpendicular to the face. Range [-180,180].
+      pan_angle:
+          Yaw angle, which indicates the leftward/rightward angle that
+          the face is pointing relative to the vertical plane
+          perpendicular to the image. Range [-180,180].
+      tilt_angle:
+          Pitch angle, which indicates the upwards/downwards angle that
+          the face is pointing relative to the image's horizontal plane.
+          Range [-180,180].
+      detection_confidence:
+          Detection confidence. Range [0, 1].
+      landmarking_confidence:
+          Face landmarking confidence. Range [0, 1].
+      joy_likelihood:
+          Joy likelihood.
+      sorrow_likelihood:
+          Sorrow likelihood.
+      anger_likelihood:
+          Anger likelihood.
+      surprise_likelihood:
+          Surprise likelihood.
+      under_exposed_likelihood:
+          Under-exposed likelihood.
+      blurred_likelihood:
+          Blurred likelihood.
+      headwear_likelihood:
+          Headwear likelihood.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+_sym_db.RegisterMessage(FaceAnnotation.Landmark)
+
+LocationInfo = _reflection.GeneratedProtocolMessageType(
+    "LocationInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONINFO,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Detected entity location information.
+  
+  
+  Attributes:
+      lat_lng:
+          lat/long location coordinates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.LocationInfo)
+    ),
+)
+_sym_db.RegisterMessage(LocationInfo)
+
+Property = _reflection.GeneratedProtocolMessageType(
+    "Property",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTY,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""A ``Property`` consists of a user-supplied name/value pair.
+  
+  
+  Attributes:
+      name:
+          Name of the property.
+      value:
+          Value of the property.
+      uint64_value:
+          Value of numeric properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Property)
+    ),
+)
+_sym_db.RegisterMessage(Property)
+
+EntityAnnotation = _reflection.GeneratedProtocolMessageType(
+    "EntityAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Set of detected entity features.
+  
+  
+  Attributes:
+      mid:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      locale:
+          The language code for the locale in which the entity textual
+          ``description`` is expressed.
+      description:
+          Entity textual description, expressed in its ``locale``
+          language.
+      score:
+          Overall score of the result. Range [0, 1].
+      confidence:
+          **Deprecated. Use ``score`` instead.** The accuracy of the
+          entity detection in an image. For example, for an image in
+          which the "Eiffel Tower" entity is detected, this field
+          represents the confidence that there is a tower in the query
+          image. Range [0, 1].
+      topicality:
+          The relevancy of the ICA (Image Content Annotation) label to
+          the image. For example, the relevancy of "tower" is likely
+          higher to an image containing the detected "Eiffel Tower" than
+          to an image containing a detected distant towering building,
+          even though the confidence that there is a tower in each image
+          may be the same. Range [0, 1].
+      bounding_poly:
+          Image region to which this entity belongs. Not produced for
+          ``LABEL_DETECTION`` features.
+      locations:
+          The location information for the detected entity. Multiple
+          ``LocationInfo`` elements can be present because one location
+          may indicate the location of the scene in the image, and
+          another location may indicate the location of the place where
+          the image was taken. Location information is usually present
+          for landmarks.
+      properties:
+          Some entities may have optional user-supplied ``Property``
+          (name/value) fields, such a score or string that qualifies the
+          entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.EntityAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(EntityAnnotation)
+
+LocalizedObjectAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LocalizedObjectAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCALIZEDOBJECTANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Set of detected objects with bounding boxes.
+  
+  
+  Attributes:
+      mid:
+          Object ID that should align with EntityAnnotation mid.
+      language_code:
+          The BCP-47 language code, such as "en-US" or "sr-Latn". For
+          more information, see http://www.unicode.org/reports/tr35/#Uni
+          code\_locale\_identifier.
+      name:
+          Object name, expressed in its ``language_code`` language.
+      score:
+          Score of the result. Range [0, 1].
+      bounding_poly:
+          Image region to which this object belongs. This must be
+          populated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.LocalizedObjectAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LocalizedObjectAnnotation)
+
+SafeSearchAnnotation = _reflection.GeneratedProtocolMessageType(
+    "SafeSearchAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAFESEARCHANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Set of features pertaining to the image, computed by computer vision
+  methods over safe-search verticals (for example, adult, spoof, medical,
+  violence).
+  
+  
+  Attributes:
+      adult:
+          Represents the adult content likelihood for the image. Adult
+          content may contain elements such as nudity, pornographic
+          images or cartoons, or sexual activities.
+      spoof:
+          Spoof likelihood. The likelihood that an modification was made
+          to the image's canonical version to make it appear funny or
+          offensive.
+      medical:
+          Likelihood that this is a medical image.
+      violence:
+          Likelihood that this image contains violent content.
+      racy:
+          Likelihood that the request image contains racy content. Racy
+          content may include (but is not limited to) skimpy or sheer
+          clothing, strategically covered nudity, lewd or provocative
+          poses, or close-ups of sensitive body areas.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.SafeSearchAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(SafeSearchAnnotation)
+
+LatLongRect = _reflection.GeneratedProtocolMessageType(
+    "LatLongRect",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LATLONGRECT,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Rectangle determined by min and max ``LatLng`` pairs.
+  
+  
+  Attributes:
+      min_lat_lng:
+          Min lat/long pair.
+      max_lat_lng:
+          Max lat/long pair.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.LatLongRect)
+    ),
+)
+_sym_db.RegisterMessage(LatLongRect)
+
+ColorInfo = _reflection.GeneratedProtocolMessageType(
+    "ColorInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLORINFO,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Color information consists of RGB channels, score, and the fraction of
+  the image that the color occupies in the image.
+  
+  
+  Attributes:
+      color:
+          RGB components of the color.
+      score:
+          Image-specific score for this color. Value in range [0, 1].
+      pixel_fraction:
+          The fraction of pixels the color occupies in the image. Value
+          in range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ColorInfo)
+    ),
+)
+_sym_db.RegisterMessage(ColorInfo)
+
+DominantColorsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "DominantColorsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOMINANTCOLORSANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Set of dominant colors and their corresponding scores.
+  
+  
+  Attributes:
+      colors:
+          RGB color values with their score and pixel fraction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.DominantColorsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(DominantColorsAnnotation)
+
+ImageProperties = _reflection.GeneratedProtocolMessageType(
+    "ImageProperties",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPROPERTIES,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Stores image properties, such as dominant colors.
+  
+  
+  Attributes:
+      dominant_colors:
+          If present, dominant colors completed successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImageProperties)
+    ),
+)
+_sym_db.RegisterMessage(ImageProperties)
+
+CropHint = _reflection.GeneratedProtocolMessageType(
+    "CropHint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINT,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Single crop hint that is used to generate a new crop when serving an
+  image.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon for the crop region. The coordinates of
+          the bounding box are in the original image's scale, as
+          returned in ``ImageParams``.
+      confidence:
+          Confidence of this being a salient region. Range [0, 1].
+      importance_fraction:
+          Fraction of importance of this salient region with respect to
+          the original image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.CropHint)
+    ),
+)
+_sym_db.RegisterMessage(CropHint)
+
+CropHintsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "CropHintsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Set of crop hints that are used to generate new crops when serving
+  images.
+  
+  
+  Attributes:
+      crop_hints:
+          Crop hint results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.CropHintsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsAnnotation)
+
+CropHintsParams = _reflection.GeneratedProtocolMessageType(
+    "CropHintsParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSPARAMS,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for crop hints annotation request.
+  
+  
+  Attributes:
+      aspect_ratios:
+          Aspect ratios in floats, representing the ratio of the width
+          to the height of the image. For example, if the desired aspect
+          ratio is 4/3, the corresponding float value should be 1.33333.
+          If not specified, the best possible crop is returned. The
+          number of provided aspect ratios is limited to a maximum of
+          16; any aspect ratios provided after the 16th are ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.CropHintsParams)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsParams)
+
+WebDetectionParams = _reflection.GeneratedProtocolMessageType(
+    "WebDetectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WEBDETECTIONPARAMS,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for web detection request.
+  
+  
+  Attributes:
+      include_geo_results:
+          Whether to include results derived from the geo information in
+          the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.WebDetectionParams)
+    ),
+)
+_sym_db.RegisterMessage(WebDetectionParams)
+
+ImageContext = _reflection.GeneratedProtocolMessageType(
+    "ImageContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECONTEXT,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Image context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      lat_long_rect:
+          Not used.
+      language_hints:
+          List of languages to use for TEXT\_DETECTION. 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). Text
+          detection returns an error if one or more of the specified
+          languages is not one of the `supported languages
+          </vision/docs/languages>`__.
+      crop_hints_params:
+          Parameters for crop hints annotation request.
+      product_search_params:
+          Parameters for product search.
+      web_detection_params:
+          Parameters for web detection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImageContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageContext)
+
+AnnotateImageRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Request for performing Google Cloud Vision API tasks over a
+  user-provided image, with user-requested features.
+  
+  
+  Attributes:
+      image:
+          The image to be processed.
+      features:
+          Requested features.
+      image_context:
+          Additional context that may accompany the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AnnotateImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageRequest)
+
+ImageAnnotationContext = _reflection.GeneratedProtocolMessageType(
+    "ImageAnnotationContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEANNOTATIONCONTEXT,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""If an image was produced from a file (e.g. a PDF), this message gives
+  information about the source of that image.
+  
+  
+  Attributes:
+      uri:
+          The URI of the file used to produce the image.
+      page_number:
+          If the file was a PDF or TIFF, this field gives the page
+          number within the file used to produce the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImageAnnotationContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageAnnotationContext)
+
+AnnotateImageResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGERESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an image annotation request.
+  
+  
+  Attributes:
+      face_annotations:
+          If present, face detection has completed successfully.
+      landmark_annotations:
+          If present, landmark detection has completed successfully.
+      logo_annotations:
+          If present, logo detection has completed successfully.
+      label_annotations:
+          If present, label detection has completed successfully.
+      localized_object_annotations:
+          If present, localized object detection has completed
+          successfully. This will be sorted descending by confidence
+          score.
+      text_annotations:
+          If present, text (OCR) detection has completed successfully.
+      full_text_annotation:
+          If present, text (OCR) detection or document (OCR) text
+          detection has completed successfully. This annotation provides
+          the structural hierarchy for the OCR detected text.
+      safe_search_annotation:
+          If present, safe-search annotation has completed successfully.
+      image_properties_annotation:
+          If present, image properties were extracted successfully.
+      crop_hints_annotation:
+          If present, crop hints have completed successfully.
+      web_detection:
+          If present, web detection has completed successfully.
+      product_search_results:
+          If present, product search has completed successfully.
+      error:
+          If set, represents the error message for the operation. Note
+          that filled-in image annotations are guaranteed to be correct,
+          even when ``error`` is set.
+      context:
+          If present, contextual information is needed to understand
+          where this image comes from.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AnnotateImageResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageResponse)
+
+AnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a single file annotation request. A file may contain one or
+  more images, which individually have their own responses.
+  
+  
+  Attributes:
+      input_config:
+          Information about the file for which this response is
+          generated.
+      responses:
+          Individual responses to images found within the file.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateFileResponse)
+
+BatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple image annotation requests are batched into a single service
+  call.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.BatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesRequest)
+
+BatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a batch image annotation request.
+  
+  
+  Attributes:
+      responses:
+          Individual responses to image annotation requests within the
+          batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.BatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesResponse)
+
+AsyncAnnotateFileRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILEREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""An offline file annotation request.
+  
+  
+  Attributes:
+      input_config:
+          Required. Information about the input file.
+      features:
+          Required. Requested features.
+      image_context:
+          Additional context that may accompany the image(s) in the
+          file.
+      output_config:
+          Required. The desired output location and metadata (e.g.
+          format).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AsyncAnnotateFileRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileRequest)
+
+AsyncAnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""The response for a single offline file annotation request.
+  
+  
+  Attributes:
+      output_config:
+          The output location and metadata from
+          AsyncAnnotateFileRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AsyncAnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileResponse)
+
+AsyncBatchAnnotateFilesRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple async file annotation requests are batched into a single
+  service call.
+  
+  
+  Attributes:
+      requests:
+          Individual async file annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesRequest)
+
+AsyncBatchAnnotateFilesResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an async batch file annotation request.
+  
+  
+  Attributes:
+      responses:
+          The list of file annotation responses, one for each request in
+          AsyncBatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesResponse)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""The desired input location and metadata.
+  
+  
+  Attributes:
+      gcs_source:
+          The Google Cloud Storage location to read the input from.
+      mime_type:
+          The type of the file. Currently only "application/pdf" and
+          "image/tiff" are supported. Wildcards are not supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""The desired output location and metadata.
+  
+  
+  Attributes:
+      gcs_destination:
+          The Google Cloud Storage location to write the output(s) to.
+      batch_size:
+          The max number of response protos to put into each output JSON
+          file 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 response protos will be
+          generated. If ``batch_size`` = 20, then 5 json files each
+          containing 20 response protos will be written under the prefix
+          ``gcs_destination``.\ ``uri``.  Currently, batch\_size only
+          applies to GcsDestination, with potential future support for
+          other output configurations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the input will be read from.
+  
+  
+  Attributes:
+      uri:
+          Google Cloud Storage URI for the input file. This must only be
+          a Google Cloud Storage object. Wildcards are not currently
+          supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the output will be written to.
+  
+  
+  Attributes:
+      uri:
+          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 ``/``.  Examples:  -  File: gs://bucket-
+          name/filename.json -  Prefix: gs://bucket-name/prefix/here/ -
+          File: gs://bucket-name/prefix/here  If multiple outputs, each
+          response is still AnnotateFileResponse, each of which contains
+          some subset of the full list of AnnotateImageResponse.
+          Multiple outputs can happen if, for example, the output JSON
+          is too large and overflows into multiple sharded files.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATIONMETADATA,
+        __module__="google.cloud.vision_v1p3beta1.proto.image_annotator_pb2",
+        __doc__="""Contains metadata for the BatchAnnotateImages operation.
+  
+  
+  Attributes:
+      state:
+          Current state of the batch operation.
+      create_time:
+          The time when the batch request was received.
+      update_time:
+          The time when the operation result was last updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.OperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperationMetadata)
+
+
+DESCRIPTOR._options = None
+
+_IMAGEANNOTATOR = _descriptor.ServiceDescriptor(
+    name="ImageAnnotator",
+    full_name="google.cloud.vision.v1p3beta1.ImageAnnotator",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=7773,
+    serialized_end=8141,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateImages",
+            full_name="google.cloud.vision.v1p3beta1.ImageAnnotator.BatchAnnotateImages",
+            index=0,
+            containing_service=None,
+            input_type=_BATCHANNOTATEIMAGESREQUEST,
+            output_type=_BATCHANNOTATEIMAGESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p3beta1/images:annotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsyncBatchAnnotateFiles",
+            full_name="google.cloud.vision.v1p3beta1.ImageAnnotator.AsyncBatchAnnotateFiles",
+            index=1,
+            containing_service=None,
+            input_type=_ASYNCBATCHANNOTATEFILESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002("#/v1p3beta1/files:asyncBatchAnnotate:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_IMAGEANNOTATOR)
+
+DESCRIPTOR.services_by_name["ImageAnnotator"] = _IMAGEANNOTATOR
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/image_annotator_pb2_grpc.py b/vision/google/cloud/vision_v1p3beta1/proto/image_annotator_pb2_grpc.py
new file mode 100644
index 000000000000..4d5a8fdb6fa2
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/image_annotator_pb2_grpc.py
@@ -0,0 +1,78 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1p3beta1.proto import (
+    image_annotator_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class ImageAnnotatorStub(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.BatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ImageAnnotator/BatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.FromString,
+        )
+        self.AsyncBatchAnnotateFiles = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ImageAnnotator/AsyncBatchAnnotateFiles",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ImageAnnotatorServicer(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def BatchAnnotateImages(self, request, context):
+        """Run image detection and annotation for a batch of images.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsyncBatchAnnotateFiles(self, request, context):
+        """Run asynchronous image detection and annotation for a list of generic
+    files, such as PDF files, which may contain multiple pages and multiple
+    images per page. Progress and results can be retrieved through the
+    `google.longrunning.Operations` interface.
+    `Operation.metadata` contains `OperationMetadata` (metadata).
+    `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ImageAnnotatorServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "BatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.SerializeToString,
+        ),
+        "AsyncBatchAnnotateFiles": grpc.unary_unary_rpc_method_handler(
+            servicer.AsyncBatchAnnotateFiles,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1p3beta1.ImageAnnotator", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/product_search.proto b/vision/google/cloud/vision_v1p3beta1/proto/product_search.proto
new file mode 100644
index 000000000000..6a30c08759d5
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/product_search.proto
@@ -0,0 +1,162 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/cloud/vision/v1p3beta1/product_search_service.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+// Parameters for a product search request.
+message ProductSearchParams {
+  // The resource name of the catalog to search.
+  //
+  // Format is: `productSearch/catalogs/CATALOG_NAME`.
+  string catalog_name = 1;
+
+  // The category to search in.
+  // Optional. It is inferred by the system if it is not specified.
+  // [Deprecated] Use `product_category`.
+  ProductSearchCategory category = 2;
+
+  // The product category to search in.
+  // Optional. It is inferred by the system if it is not specified.
+  // Supported values are `bag`, `shoe`, `sunglasses`, `dress`, `outerwear`,
+  // `skirt`, `top`, `shorts`, and `pants`.
+  string product_category = 5;
+
+  // The bounding polygon around the area of interest in the image.
+  // Optional. If it is not specified, system discretion will be applied.
+  // [Deprecated] Use `bounding_poly`.
+  NormalizedBoundingPoly normalized_bounding_poly = 3;
+
+  // The bounding polygon around the area of interest in the image.
+  // Optional. If it is not specified, system discretion will be applied.
+  BoundingPoly bounding_poly = 9;
+
+  // Specifies the verbosity of the  product search results.
+  // Optional. Defaults to `BASIC`.
+  ProductSearchResultsView view = 4;
+
+  // The resource name of a
+  // [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] to be searched for
+  // similar images.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  string product_set = 6;
+
+  // The list of product categories to search in. Currently, we only consider
+  // the first category, and either "homegoods" or "apparel" should be
+  // specified.
+  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.
+  //
+  // For example, "(color = red OR color = blue) AND brand = Google" is
+  // acceptable, but not "(color = red OR brand = Google)" or "color: red".
+  string filter = 8;
+}
+
+// Results for a product search request.
+message ProductSearchResults {
+  // Information about a product.
+  message ProductInfo {
+    // Product ID.
+    string product_id = 1;
+
+    // The URI of the image which matched the query image.
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    string image_uri = 2;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    float score = 3;
+  }
+
+  // Information about a product.
+  message Result {
+    // The Product.
+    Product product = 1;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    //
+    // This field is returned only if `view` is set to `FULL` in
+    // the request.
+    float score = 2;
+
+    // The resource name of the image from the product that is the closest match
+    // to the query.
+    string image = 3;
+  }
+
+  // Product category.
+  // [Deprecated] Use `product_category`.
+  ProductSearchCategory category = 1;
+
+  // Product category.
+  // Supported values are `bag` and `shoe`.
+  // [Deprecated] `product_category` is provided in each Product.
+  string product_category = 4;
+
+  // Timestamp of the index which provided these results. Changes made after
+  // this time are not reflected in the current results.
+  google.protobuf.Timestamp index_time = 2;
+
+  // List of detected products.
+  repeated ProductInfo products = 3;
+
+  // List of results, one for each product match.
+  repeated Result results = 5;
+}
+
+// Supported product search categories.
+enum ProductSearchCategory {
+  // Default value used when a category is not specified.
+  PRODUCT_SEARCH_CATEGORY_UNSPECIFIED = 0;
+
+  // Shoes category.
+  SHOES = 1;
+
+  // Bags category.
+  BAGS = 2;
+}
+
+// Specifies the fields to include in product search results.
+enum ProductSearchResultsView {
+  // Product search results contain only `product_category` and `product_id`.
+  // Default value.
+  BASIC = 0;
+
+  // Product search results contain `product_category`, `product_id`,
+  // `image_uri`, and `score`.
+  FULL = 1;
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/product_search_pb2.py b/vision/google/cloud/vision_v1p3beta1/proto/product_search_pb2.py
new file mode 100644
index 000000000000..4053ea657115
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/product_search_pb2.py
@@ -0,0 +1,713 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p3beta1/proto/product_search.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p3beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1p3beta1.proto import (
+    product_search_service_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p3beta1/proto/product_search.proto",
+    package="google.cloud.vision.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p3beta1B\022ProductSearchProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/vision_v1p3beta1/proto/product_search.proto\x12\x1dgoogle.cloud.vision.v1p3beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p3beta1/proto/geometry.proto\x1a@google/cloud/vision_v1p3beta1/proto/product_search_service.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xb2\x03\n\x13ProductSearchParams\x12\x14\n\x0c\x63\x61talog_name\x18\x01 \x01(\t\x12\x46\n\x08\x63\x61tegory\x18\x02 \x01(\x0e\x32\x34.google.cloud.vision.v1p3beta1.ProductSearchCategory\x12\x18\n\x10product_category\x18\x05 \x01(\t\x12W\n\x18normalized_bounding_poly\x18\x03 \x01(\x0b\x32\x35.google.cloud.vision.v1p3beta1.NormalizedBoundingPoly\x12\x42\n\rbounding_poly\x18\t \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12\x45\n\x04view\x18\x04 \x01(\x0e\x32\x37.google.cloud.vision.v1p3beta1.ProductSearchResultsView\x12\x13\n\x0bproduct_set\x18\x06 \x01(\t\x12\x1a\n\x12product_categories\x18\x07 \x03(\t\x12\x0e\n\x06\x66ilter\x18\x08 \x01(\t"\xee\x03\n\x14ProductSearchResults\x12\x46\n\x08\x63\x61tegory\x18\x01 \x01(\x0e\x32\x34.google.cloud.vision.v1p3beta1.ProductSearchCategory\x12\x18\n\x10product_category\x18\x04 \x01(\t\x12.\n\nindex_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12Q\n\x08products\x18\x03 \x03(\x0b\x32?.google.cloud.vision.v1p3beta1.ProductSearchResults.ProductInfo\x12K\n\x07results\x18\x05 \x03(\x0b\x32:.google.cloud.vision.v1p3beta1.ProductSearchResults.Result\x1a\x43\n\x0bProductInfo\x12\x12\n\nproduct_id\x18\x01 \x01(\t\x12\x11\n\timage_uri\x18\x02 \x01(\t\x12\r\n\x05score\x18\x03 \x01(\x02\x1a_\n\x06Result\x12\x37\n\x07product\x18\x01 \x01(\x0b\x32&.google.cloud.vision.v1p3beta1.Product\x12\r\n\x05score\x18\x02 \x01(\x02\x12\r\n\x05image\x18\x03 \x01(\t*U\n\x15ProductSearchCategory\x12\'\n#PRODUCT_SEARCH_CATEGORY_UNSPECIFIED\x10\x00\x12\t\n\x05SHOES\x10\x01\x12\x08\n\x04\x42\x41GS\x10\x02*/\n\x18ProductSearchResultsView\x12\t\n\x05\x42\x41SIC\x10\x00\x12\x08\n\x04\x46ULL\x10\x01\x42\x81\x01\n!com.google.cloud.vision.v1p3beta1B\x12ProductSearchProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_PRODUCTSEARCHCATEGORY = _descriptor.EnumDescriptor(
+    name="ProductSearchCategory",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearchCategory",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="PRODUCT_SEARCH_CATEGORY_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SHOES", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BAGS", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1206,
+    serialized_end=1291,
+)
+_sym_db.RegisterEnumDescriptor(_PRODUCTSEARCHCATEGORY)
+
+ProductSearchCategory = enum_type_wrapper.EnumTypeWrapper(_PRODUCTSEARCHCATEGORY)
+_PRODUCTSEARCHRESULTSVIEW = _descriptor.EnumDescriptor(
+    name="ProductSearchResultsView",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearchResultsView",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="BASIC", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FULL", index=1, number=1, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1293,
+    serialized_end=1340,
+)
+_sym_db.RegisterEnumDescriptor(_PRODUCTSEARCHRESULTSVIEW)
+
+ProductSearchResultsView = enum_type_wrapper.EnumTypeWrapper(_PRODUCTSEARCHRESULTSVIEW)
+PRODUCT_SEARCH_CATEGORY_UNSPECIFIED = 0
+SHOES = 1
+BAGS = 2
+BASIC = 0
+FULL = 1
+
+
+_PRODUCTSEARCHPARAMS = _descriptor.Descriptor(
+    name="ProductSearchParams",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearchParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="catalog_name",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.catalog_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="category",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.category",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_category",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.product_category",
+            index=2,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.normalized_bounding_poly",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.bounding_poly",
+            index=4,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="view",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.view",
+            index=5,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.product_set",
+            index=6,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_categories",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.product_categories",
+            index=7,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchParams.filter",
+            index=8,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=273,
+    serialized_end=707,
+)
+
+
+_PRODUCTSEARCHRESULTS_PRODUCTINFO = _descriptor.Descriptor(
+    name="ProductInfo",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.ProductInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_id",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.ProductInfo.product_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.ProductInfo.image_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.ProductInfo.score",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1040,
+    serialized_end=1107,
+)
+
+_PRODUCTSEARCHRESULTS_RESULT = _descriptor.Descriptor(
+    name="Result",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.Result",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.Result.product",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.Result.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.Result.image",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1109,
+    serialized_end=1204,
+)
+
+_PRODUCTSEARCHRESULTS = _descriptor.Descriptor(
+    name="ProductSearchResults",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearchResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="category",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.category",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_category",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.product_category",
+            index=1,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_time",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.index_time",
+            index=2,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.products",
+            index=3,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearchResults.results",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRODUCTSEARCHRESULTS_PRODUCTINFO, _PRODUCTSEARCHRESULTS_RESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=710,
+    serialized_end=1204,
+)
+
+_PRODUCTSEARCHPARAMS.fields_by_name["category"].enum_type = _PRODUCTSEARCHCATEGORY
+_PRODUCTSEARCHPARAMS.fields_by_name[
+    "normalized_bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._NORMALIZEDBOUNDINGPOLY
+)
+_PRODUCTSEARCHPARAMS.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PRODUCTSEARCHPARAMS.fields_by_name["view"].enum_type = _PRODUCTSEARCHRESULTSVIEW
+_PRODUCTSEARCHRESULTS_PRODUCTINFO.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS_RESULT.fields_by_name[
+    "product"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2._PRODUCT
+)
+_PRODUCTSEARCHRESULTS_RESULT.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS.fields_by_name["category"].enum_type = _PRODUCTSEARCHCATEGORY
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "index_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "products"
+].message_type = _PRODUCTSEARCHRESULTS_PRODUCTINFO
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "results"
+].message_type = _PRODUCTSEARCHRESULTS_RESULT
+DESCRIPTOR.message_types_by_name["ProductSearchParams"] = _PRODUCTSEARCHPARAMS
+DESCRIPTOR.message_types_by_name["ProductSearchResults"] = _PRODUCTSEARCHRESULTS
+DESCRIPTOR.enum_types_by_name["ProductSearchCategory"] = _PRODUCTSEARCHCATEGORY
+DESCRIPTOR.enum_types_by_name["ProductSearchResultsView"] = _PRODUCTSEARCHRESULTSVIEW
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ProductSearchParams = _reflection.GeneratedProtocolMessageType(
+    "ProductSearchParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSEARCHPARAMS,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_pb2",
+        __doc__="""Parameters for a product search request.
+  
+  
+  Attributes:
+      catalog_name:
+          The resource name of the catalog to search.  Format is:
+          ``productSearch/catalogs/CATALOG_NAME``.
+      category:
+          The category to search in. Optional. It is inferred by the
+          system if it is not specified. [Deprecated] Use
+          ``product_category``.
+      product_category:
+          The product category to search in. Optional. It is inferred by
+          the system if it is not specified. Supported values are
+          ``bag``, ``shoe``, ``sunglasses``, ``dress``, ``outerwear``,
+          ``skirt``, ``top``, ``shorts``, and ``pants``.
+      normalized_bounding_poly:
+          The bounding polygon around the area of interest in the image.
+          Optional. If it is not specified, system discretion will be
+          applied. [Deprecated] Use ``bounding_poly``.
+      bounding_poly:
+          The bounding polygon around the area of interest in the image.
+          Optional. If it is not specified, system discretion will be
+          applied.
+      view:
+          Specifies the verbosity of the product search results.
+          Optional. Defaults to ``BASIC``.
+      product_set:
+          The resource name of a
+          [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] to be
+          searched for similar images.  Format is: ``projects/PROJECT_ID
+          /locations/LOC_ID/productSets/PRODUCT_SET_ID``.
+      product_categories:
+          The list of product categories to search in. Currently, we
+          only consider the first category, and either "homegoods" or
+          "apparel" should be specified.
+      filter:
+          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.  For example, "(color = red OR
+          color = blue) AND brand = Google" is acceptable, but not
+          "(color = red OR brand = Google)" or "color: red".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ProductSearchParams)
+    ),
+)
+_sym_db.RegisterMessage(ProductSearchParams)
+
+ProductSearchResults = _reflection.GeneratedProtocolMessageType(
+    "ProductSearchResults",
+    (_message.Message,),
+    dict(
+        ProductInfo=_reflection.GeneratedProtocolMessageType(
+            "ProductInfo",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_PRODUCTINFO,
+                __module__="google.cloud.vision_v1p3beta1.proto.product_search_pb2",
+                __doc__="""Information about a product.
+    
+    
+    Attributes:
+        product_id:
+            Product ID.
+        image_uri:
+            The URI of the image which matched the query image.  This
+            field is returned only if ``view`` is set to ``FULL`` in the
+            request.
+        score:
+            A confidence level on the match, ranging from 0 (no
+            confidence) to 1 (full confidence).  This field is returned
+            only if ``view`` is set to ``FULL`` in the request.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ProductSearchResults.ProductInfo)
+            ),
+        ),
+        Result=_reflection.GeneratedProtocolMessageType(
+            "Result",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_RESULT,
+                __module__="google.cloud.vision_v1p3beta1.proto.product_search_pb2",
+                __doc__="""Information about a product.
+    
+    
+    Attributes:
+        product:
+            The Product.
+        score:
+            A confidence level on the match, ranging from 0 (no
+            confidence) to 1 (full confidence).  This field is returned
+            only if ``view`` is set to ``FULL`` in the request.
+        image:
+            The resource name of the image from the product that is the
+            closest match to the query.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ProductSearchResults.Result)
+            ),
+        ),
+        DESCRIPTOR=_PRODUCTSEARCHRESULTS,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_pb2",
+        __doc__="""Results for a product search request.
+  
+  
+  Attributes:
+      category:
+          Product category. [Deprecated] Use ``product_category``.
+      product_category:
+          Product category. Supported values are ``bag`` and ``shoe``.
+          [Deprecated] ``product_category`` is provided in each Product.
+      index_time:
+          Timestamp of the index which provided these results. Changes
+          made after this time are not reflected in the current results.
+      products:
+          List of detected products.
+      results:
+          List of results, one for each product match.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ProductSearchResults)
+    ),
+)
+_sym_db.RegisterMessage(ProductSearchResults)
+_sym_db.RegisterMessage(ProductSearchResults.ProductInfo)
+_sym_db.RegisterMessage(ProductSearchResults.Result)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/product_search_pb2_grpc.py b/vision/google/cloud/vision_v1p3beta1/proto/product_search_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/product_search_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/product_search_service.proto b/vision/google/cloud/vision_v1p3beta1/proto/product_search_service.proto
new file mode 100644
index 000000000000..23919ee7e844
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/product_search_service.proto
@@ -0,0 +1,842 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+import "google/longrunning/operations.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;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchServiceProto";
+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
+// `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
+//   `projects/*/locations/*/products/*`
+//
+// - 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 {
+  // Creates and returns a new ProductSet resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+  //   4096 characters.
+  rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+      body: "product_set"
+    };
+  }
+
+  // Lists ProductSets in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+  //   than 1.
+  rpc ListProductSets(ListProductSetsRequest)
+      returns (ListProductSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+    };
+  }
+
+  // Gets information associated with a ProductSet.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  rpc GetProductSet(GetProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Makes changes to a ProductSet resource.
+  // Only display_name can be updated currently.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+  //   missing from the request or longer than 4096 characters.
+  rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      patch: "/v1p3beta1/{product_set.name=projects/*/locations/*/productSets/*}"
+      body: "product_set"
+    };
+  }
+
+  // Permanently deletes a ProductSet. All Products and ReferenceImages in the
+  // ProductSet will be 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: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Creates and returns a new product resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+  rpc CreateProduct(CreateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/products"
+      body: "product"
+    };
+  }
+
+  // Lists products in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*}/products"
+    };
+  }
+
+  // Gets information associated with a Product.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  rpc GetProduct(GetProductRequest) returns (Product) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Makes changes to a Product resource.
+  // Only display_name, description and labels can be updated right now.
+  //
+  // If labels are updated, the change will not be reflected in queries until
+  // the next index time.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+  //   missing from the request or longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if description is present in update_mask but is
+  //   longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+  rpc UpdateProduct(UpdateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      patch: "/v1p3beta1/{product.name=projects/*/locations/*/products/*}"
+      body: "product"
+    };
+  }
+
+  // Permanently deletes a product and its reference images.
+  //
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Creates and returns a new ReferenceImage resource.
+  //
+  // The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+  // the system will try to detect regions of interest in the image that are
+  // compatible with the product_category on the parent product. If it is
+  // specified, detection is ALWAYS skipped. The system converts polygons into
+  // non-rotated rectangles.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 50MP).
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if the product does not exist.
+  // * 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) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+      body: "reference_image"
+    };
+  }
+
+  // Permanently deletes a reference image.
+  //
+  // The image metadata will be deleted right away, but search queries
+  // against ProductSets containing the image may still work until all related
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Lists reference images.
+  //
+  // Possible errors:
+  //
+  // * 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) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+    };
+  }
+
+  // Gets information associated with a ReferenceImage.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the specified image does not exist.
+  rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Adds a Product to the specified ProductSet. If the Product is already
+  // present, no change is made.
+  //
+  // One Product can be added to at most 100 ProductSets.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+  rpc AddProductToProductSet(AddProductToProductSetRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:addProduct"
+      body: "*"
+    };
+  }
+
+  // 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: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:removeProduct"
+      body: "*"
+    };
+  }
+
+  // Lists the Products in a ProductSet, in an unspecified order. If the
+  // ProductSet does not exist, the products field of the response will be
+  // empty.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProductsInProductSet(ListProductsInProductSetRequest)
+      returns (ListProductsInProductSetResponse) {
+    option (google.api.http) = {
+      get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}/products"
+    };
+  }
+
+  // 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.
+  // `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.v1p3beta1.ImportProductSetsGcsSource.csv_file_uri].
+  rpc ImportProductSets(ImportProductSetsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets:import"
+      body: "*"
+    };
+  }
+}
+
+// A Product contains ReferenceImages.
+message 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
+    // exceed 128 bytes.
+    string key = 1;
+
+    // The value of the label attached to the product. Cannot be empty and
+    // cannot exceed 128 bytes.
+    string value = 2;
+  }
+
+  // The resource name of the product.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  //
+  // This field is ignored when creating a product.
+  string name = 1;
+
+  // The user-provided name for this Product. Must not be empty. Must be at most
+  // 4096 characters long.
+  string display_name = 2;
+
+  // User-provided metadata to be stored with this product. Must be at most 4096
+  // 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;
+
+  // Key-value pairs that can be attached to a product. At query time,
+  // constraints can be specified based on the product_labels.
+  //
+  // Note that integer values can be provided as strings, e.g. "1199". Only
+  // strings with integer values can match a range-based restriction which is
+  // to be supported soon.
+  //
+  // Multiple values can be assigned to the same key. One product may have up to
+  // 100 product_labels.
+  repeated KeyValue product_labels = 5;
+}
+
+// A ProductSet contains Products. A ProductSet can contain a maximum of 1
+// million reference images. If the limit is exceeded, periodic indexing will
+// fail.
+message ProductSet {
+  // The resource name of the ProductSet.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  //
+  // This field is ignored when creating a ProductSet.
+  string name = 1;
+
+  // The user-provided name for this ProductSet. Must not be empty. Must be at
+  // most 4096 characters long.
+  string display_name = 2;
+
+  // Output only. The time at which this ProductSet was last indexed. Query
+  // results will reflect all updates before this time. If this ProductSet has
+  // never been indexed, this field is 0.
+  //
+  // This field is ignored when creating a ProductSet.
+  google.protobuf.Timestamp index_time = 3;
+
+  // 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;
+}
+
+// A `ReferenceImage` represents a product image and its associated metadata,
+// such as bounding boxes.
+message ReferenceImage {
+  // The resource name of the reference image.
+  //
+  // Format is:
+  //
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
+  //
+  // This field is ignored when creating a reference image.
+  string name = 1;
+
+  // The Google Cloud Storage URI of the reference image.
+  //
+  // The URI must start with `gs://`.
+  //
+  // Required.
+  string uri = 2;
+
+  // 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
+  // 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;
+}
+
+// Request message for the `CreateProduct` method.
+message CreateProductRequest {
+  // The project in which the Product should be created.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The product to create.
+  Product product = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_id = 3;
+}
+
+// Request message for the `ListProducts` method.
+message ListProductsRequest {
+  // The project OR ProductSet from which Products should be listed.
+  //
+  // Format:
+  // `projects/PROJECT_ID/locations/LOC_ID`
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProducts` method.
+message ListProductsResponse {
+  // List of products.
+  repeated Product products = 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 message for the `GetProduct` method.
+message GetProductRequest {
+  // Resource name of the Product to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProduct` method.
+message UpdateProductRequest {
+  // The Product resource which replaces the one on the server.
+  // product.name is immutable.
+  Product product = 1;
+
+  // 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
+  // `description`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProduct` method.
+message DeleteProductRequest {
+  // Resource name of product to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateProductSet` method.
+message CreateProductSetRequest {
+  // The project in which the ProductSet should be created.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The ProductSet to create.
+  ProductSet product_set = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_set_id = 3;
+}
+
+// Request message for the `ListProductSets` method.
+message ListProductSetsRequest {
+  // The project from which ProductSets should be listed.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductSets` method.
+message ListProductSetsResponse {
+  // List of ProductSets.
+  repeated ProductSet product_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;
+}
+
+// Request message for the `GetProductSet` method.
+message GetProductSetRequest {
+  // Resource name of the ProductSet to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProductSet` method.
+message UpdateProductSetRequest {
+  // The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1;
+
+  // 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 path is `display_name`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProductSet` method.
+message DeleteProductSetRequest {
+  // Resource name of the ProductSet to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateReferenceImage` method.
+message CreateReferenceImageRequest {
+  // 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.
+  // If an image ID is specified, it is ignored.
+  ReferenceImage reference_image = 2;
+
+  // 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
+  // already in use, an error is returned with code ALREADY_EXISTS. Must be at
+  // most 128 characters long. It cannot contain the character `/`.
+  string reference_image_id = 3;
+}
+
+// Request message for the `ListReferenceImages` method.
+message ListReferenceImagesRequest {
+  // Resource name of the product containing the reference images.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // A token identifying a page of results to be returned. This is the value
+  // of `nextPageToken` returned in a previous reference image list request.
+  //
+  // Defaults to the first page if not specified.
+  string page_token = 3;
+}
+
+// Response message for the `ListReferenceImages` method.
+message ListReferenceImagesResponse {
+  // The list of reference images.
+  repeated ReferenceImage reference_images = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string next_page_token = 3;
+}
+
+// Request message for the `GetReferenceImage` method.
+message GetReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `DeleteReferenceImage` method.
+message DeleteReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `AddProductToProductSet` method.
+message AddProductToProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `RemoveProductFromProductSet` method.
+message RemoveProductFromProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetRequest {
+  // The ProductSet resource for which to retrieve Products.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetResponse {
+  // The list of Products.
+  repeated Product products = 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 Google Cloud Storage location for a csv file which preserves a list of
+// ImportProductSetRequests in each line.
+message ImportProductSetsGcsSource {
+  // The Google Cloud Storage URI of the input csv file.
+  //
+  // 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.
+  // 1. image_uri
+  // 2, image_id
+  // 3. product_set_id
+  // 4. product_id
+  // 5, product_category
+  // 6, product_display_name
+  // 7, labels
+  // 8. bounding_poly
+  //
+  // Columns 1, 3, 4, and 5 are required, other columns are optional. A new
+  // ProductSet/Product with the same id will be created on the fly
+  // if the ProductSet/Product specified by product_set_id/product_id does not
+  // exist.
+  //
+  // The image_id field is optional but has to be unique if provided. If it is
+  // empty, we will automatically assign an unique id to the image.
+  //
+  // The product_display_name field is optional. If it is empty, a space (" ")
+  // is used as the place holder for the product display_name, which can
+  // be updated later through the realtime API.
+  //
+  // If the Product with product_id already exists, the fields
+  // product_display_name, product_category and labels are ignored.
+  //
+  // If a Product doesn't exist and needs to be created on the fly, the
+  // product_display_name field refers to
+  // [Product.display_name][google.cloud.vision.v1p3beta1.Product.display_name],
+  // the product_category field refers to
+  // [Product.product_category][google.cloud.vision.v1p3beta1.Product.product_category],
+  // and the labels field refers to [Product.labels][].
+  //
+  // Labels (optional) should be a line containing a list of comma-separated
+  // key-value pairs, with the format
+  //     "key_1=value_1,key_2=value_2,...,key_n=value_n".
+  //
+  // The bounding_poly (optional) field is used to identify one region of
+  // interest from the image in the same manner as CreateReferenceImage. If no
+  // bounding_poly is specified, the system will try to detect regions of
+  // interest automatically.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 20MP).
+  //
+  // Also note that at most one bounding_poly is allowed per line. If the image
+  // contains multiple regions of interest, the csv should contain one line per
+  // region of interest.
+  //
+  // The bounding_poly column should contain an even number of comma-separated
+  // numbers, with the format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Nonnegative
+  // integers should be used for absolute bounding polygons, and float values
+  // in [0, 1] should be used for normalized bounding polygons.
+  string csv_file_uri = 1;
+}
+
+// The input content for the `ImportProductSets` method.
+message ImportProductSetsInputConfig {
+  // The source of the input.
+  oneof source {
+    // The Google Cloud Storage location for a csv file which preserves a list
+    // of ImportProductSetRequests in each line.
+    ImportProductSetsGcsSource gcs_source = 1;
+  }
+}
+
+// Request message for the `ImportProductSets` method.
+message ImportProductSetsRequest {
+  // 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;
+}
+
+// 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.
+message ImportProductSetsResponse {
+  // The list of reference_images that are imported successfully.
+  repeated ReferenceImage reference_images = 1;
+
+  // The rpc status for each ImportProductSet request, including both successes
+  // and errors.
+  //
+  // The number of statuses here matches the number of lines in the csv file,
+  // and statuses[i] stores the success or failure status of processing the i-th
+  // line of the csv, starting from line 0.
+  repeated google.rpc.Status statuses = 2;
+}
+
+// Metadata for the batch operations such as the current state.
+//
+// This is included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message BatchOperationMetadata {
+  // Enumerates the possible states that the batch request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is actively being processed.
+    PROCESSING = 1;
+
+    // The request is done and at least one item has been successfully
+    // processed.
+    SUCCESSFUL = 2;
+
+    // The request is done and no item has been successfully processed.
+    FAILED = 3;
+
+    // The request is done after the longrunning.Operations.CancelOperation has
+    // been called by the user.  Any records that were processed before the
+    // cancel command are output as specified in the request.
+    CANCELLED = 4;
+  }
+
+  // The current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was submitted to the server.
+  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.protobuf.Timestamp end_time = 3;
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/product_search_service_pb2.py b/vision/google/cloud/vision_v1p3beta1/proto/product_search_service_pb2.py
new file mode 100644
index 000000000000..74ec13d18a5e
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/product_search_service_pb2.py
@@ -0,0 +1,3027 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p3beta1/proto/product_search_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p3beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p3beta1/proto/product_search_service.proto",
+    package="google.cloud.vision.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p3beta1B\031ProductSearchServiceProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n@google/cloud/vision_v1p3beta1/proto/product_search_service.proto\x12\x1dgoogle.cloud.vision.v1p3beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p3beta1/proto/geometry.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xcd\x01\n\x07Product\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x18\n\x10product_category\x18\x04 \x01(\t\x12G\n\x0eproduct_labels\x18\x05 \x03(\x0b\x32/.google.cloud.vision.v1p3beta1.Product.KeyValue\x1a&\n\x08KeyValue\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t"\x89\x01\n\nProductSet\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12.\n\nindex_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\'\n\x0bindex_error\x18\x04 \x01(\x0b\x32\x12.google.rpc.Status"p\n\x0eReferenceImage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\x43\n\x0e\x62ounding_polys\x18\x03 \x03(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly"s\n\x14\x43reateProductRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x37\n\x07product\x18\x02 \x01(\x0b\x32&.google.cloud.vision.v1p3beta1.Product\x12\x12\n\nproduct_id\x18\x03 \x01(\t"L\n\x13ListProductsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"i\n\x14ListProductsResponse\x12\x38\n\x08products\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1p3beta1.Product\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"!\n\x11GetProductRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x80\x01\n\x14UpdateProductRequest\x12\x37\n\x07product\x18\x01 \x01(\x0b\x32&.google.cloud.vision.v1p3beta1.Product\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteProductRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x81\x01\n\x17\x43reateProductSetRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12>\n\x0bproduct_set\x18\x02 \x01(\x0b\x32).google.cloud.vision.v1p3beta1.ProductSet\x12\x16\n\x0eproduct_set_id\x18\x03 \x01(\t"O\n\x16ListProductSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"s\n\x17ListProductSetsResponse\x12?\n\x0cproduct_sets\x18\x01 \x03(\x0b\x32).google.cloud.vision.v1p3beta1.ProductSet\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"$\n\x14GetProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8a\x01\n\x17UpdateProductSetRequest\x12>\n\x0bproduct_set\x18\x01 \x01(\x0b\x32).google.cloud.vision.v1p3beta1.ProductSet\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\'\n\x17\x44\x65leteProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x91\x01\n\x1b\x43reateReferenceImageRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x46\n\x0freference_image\x18\x02 \x01(\x0b\x32-.google.cloud.vision.v1p3beta1.ReferenceImage\x12\x1a\n\x12reference_image_id\x18\x03 \x01(\t"S\n\x1aListReferenceImagesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x92\x01\n\x1bListReferenceImagesResponse\x12G\n\x10reference_images\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p3beta1.ReferenceImage\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"(\n\x18GetReferenceImageRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"+\n\x1b\x44\x65leteReferenceImageRequest\x12\x0c\n\x04name\x18\x01 \x01(\t">\n\x1d\x41\x64\x64ProductToProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07product\x18\x02 \x01(\t"C\n"RemoveProductFromProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07product\x18\x02 \x01(\t"V\n\x1fListProductsInProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"u\n ListProductsInProductSetResponse\x12\x38\n\x08products\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1p3beta1.Product\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"2\n\x1aImportProductSetsGcsSource\x12\x14\n\x0c\x63sv_file_uri\x18\x01 \x01(\t"y\n\x1cImportProductSetsInputConfig\x12O\n\ngcs_source\x18\x01 \x01(\x0b\x32\x39.google.cloud.vision.v1p3beta1.ImportProductSetsGcsSourceH\x00\x42\x08\n\x06source"}\n\x18ImportProductSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12Q\n\x0cinput_config\x18\x02 \x01(\x0b\x32;.google.cloud.vision.v1p3beta1.ImportProductSetsInputConfig"\x8a\x01\n\x19ImportProductSetsResponse\x12G\n\x10reference_images\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p3beta1.ReferenceImage\x12$\n\x08statuses\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status"\x9e\x02\n\x16\x42\x61tchOperationMetadata\x12J\n\x05state\x18\x01 \x01(\x0e\x32;.google.cloud.vision.v1p3beta1.BatchOperationMetadata.State\x12/\n\x0bsubmit_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Y\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0e\n\nPROCESSING\x10\x01\x12\x0e\n\nSUCCESSFUL\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\r\n\tCANCELLED\x10\x04\x32\x9f\x1b\n\rProductSearch\x12\xc2\x01\n\x10\x43reateProductSet\x12\x36.google.cloud.vision.v1p3beta1.CreateProductSetRequest\x1a).google.cloud.vision.v1p3beta1.ProductSet"K\x82\xd3\xe4\x93\x02\x45"6/v1p3beta1/{parent=projects/*/locations/*}/productSets:\x0bproduct_set\x12\xc0\x01\n\x0fListProductSets\x12\x35.google.cloud.vision.v1p3beta1.ListProductSetsRequest\x1a\x36.google.cloud.vision.v1p3beta1.ListProductSetsResponse">\x82\xd3\xe4\x93\x02\x38\x12\x36/v1p3beta1/{parent=projects/*/locations/*}/productSets\x12\xaf\x01\n\rGetProductSet\x12\x33.google.cloud.vision.v1p3beta1.GetProductSetRequest\x1a).google.cloud.vision.v1p3beta1.ProductSet">\x82\xd3\xe4\x93\x02\x38\x12\x36/v1p3beta1/{name=projects/*/locations/*/productSets/*}\x12\xce\x01\n\x10UpdateProductSet\x12\x36.google.cloud.vision.v1p3beta1.UpdateProductSetRequest\x1a).google.cloud.vision.v1p3beta1.ProductSet"W\x82\xd3\xe4\x93\x02Q2B/v1p3beta1/{product_set.name=projects/*/locations/*/productSets/*}:\x0bproduct_set\x12\xa2\x01\n\x10\x44\x65leteProductSet\x12\x36.google.cloud.vision.v1p3beta1.DeleteProductSetRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x38*6/v1p3beta1/{name=projects/*/locations/*/productSets/*}\x12\xb2\x01\n\rCreateProduct\x12\x33.google.cloud.vision.v1p3beta1.CreateProductRequest\x1a&.google.cloud.vision.v1p3beta1.Product"D\x82\xd3\xe4\x93\x02>"3/v1p3beta1/{parent=projects/*/locations/*}/products:\x07product\x12\xb4\x01\n\x0cListProducts\x12\x32.google.cloud.vision.v1p3beta1.ListProductsRequest\x1a\x33.google.cloud.vision.v1p3beta1.ListProductsResponse";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1p3beta1/{parent=projects/*/locations/*}/products\x12\xa3\x01\n\nGetProduct\x12\x30.google.cloud.vision.v1p3beta1.GetProductRequest\x1a&.google.cloud.vision.v1p3beta1.Product";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1p3beta1/{name=projects/*/locations/*/products/*}\x12\xba\x01\n\rUpdateProduct\x12\x33.google.cloud.vision.v1p3beta1.UpdateProductRequest\x1a&.google.cloud.vision.v1p3beta1.Product"L\x82\xd3\xe4\x93\x02\x46\x32;/v1p3beta1/{product.name=projects/*/locations/*/products/*}:\x07product\x12\x99\x01\n\rDeleteProduct\x12\x33.google.cloud.vision.v1p3beta1.DeleteProductRequest\x1a\x16.google.protobuf.Empty";\x82\xd3\xe4\x93\x02\x35*3/v1p3beta1/{name=projects/*/locations/*/products/*}\x12\xe1\x01\n\x14\x43reateReferenceImage\x12:.google.cloud.vision.v1p3beta1.CreateReferenceImageRequest\x1a-.google.cloud.vision.v1p3beta1.ReferenceImage"^\x82\xd3\xe4\x93\x02X"E/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages:\x0freference_image\x12\xb9\x01\n\x14\x44\x65leteReferenceImage\x12:.google.cloud.vision.v1p3beta1.DeleteReferenceImageRequest\x1a\x16.google.protobuf.Empty"M\x82\xd3\xe4\x93\x02G*E/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}\x12\xdb\x01\n\x13ListReferenceImages\x12\x39.google.cloud.vision.v1p3beta1.ListReferenceImagesRequest\x1a:.google.cloud.vision.v1p3beta1.ListReferenceImagesResponse"M\x82\xd3\xe4\x93\x02G\x12\x45/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages\x12\xca\x01\n\x11GetReferenceImage\x12\x37.google.cloud.vision.v1p3beta1.GetReferenceImageRequest\x1a-.google.cloud.vision.v1p3beta1.ReferenceImage"M\x82\xd3\xe4\x93\x02G\x12\x45/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}\x12\xbc\x01\n\x16\x41\x64\x64ProductToProductSet\x12<.google.cloud.vision.v1p3beta1.AddProductToProductSetRequest\x1a\x16.google.protobuf.Empty"L\x82\xd3\xe4\x93\x02\x46"A/v1p3beta1/{name=projects/*/locations/*/productSets/*}:addProduct:\x01*\x12\xc9\x01\n\x1bRemoveProductFromProductSet\x12\x41.google.cloud.vision.v1p3beta1.RemoveProductFromProductSetRequest\x1a\x16.google.protobuf.Empty"O\x82\xd3\xe4\x93\x02I"D/v1p3beta1/{name=projects/*/locations/*/productSets/*}:removeProduct:\x01*\x12\xe4\x01\n\x18ListProductsInProductSet\x12>.google.cloud.vision.v1p3beta1.ListProductsInProductSetRequest\x1a?.google.cloud.vision.v1p3beta1.ListProductsInProductSetResponse"G\x82\xd3\xe4\x93\x02\x41\x12?/v1p3beta1/{name=projects/*/locations/*/productSets/*}/products\x12\xb5\x01\n\x11ImportProductSets\x12\x37.google.cloud.vision.v1p3beta1.ImportProductSetsRequest\x1a\x1d.google.longrunning.Operation"H\x82\xd3\xe4\x93\x02\x42"=/v1p3beta1/{parent=projects/*/locations/*}/productSets:import:\x01*B\x88\x01\n!com.google.cloud.vision.v1p3beta1B\x19ProductSearchServiceProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_BATCHOPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1p3beta1.BatchOperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROCESSING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESSFUL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3307,
+    serialized_end=3396,
+)
+_sym_db.RegisterEnumDescriptor(_BATCHOPERATIONMETADATA_STATE)
+
+
+_PRODUCT_KEYVALUE = _descriptor.Descriptor(
+    name="KeyValue",
+    full_name="google.cloud.vision.v1p3beta1.Product.KeyValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.vision.v1p3beta1.Product.KeyValue.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1p3beta1.Product.KeyValue.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=507,
+    serialized_end=545,
+)
+
+_PRODUCT = _descriptor.Descriptor(
+    name="Product",
+    full_name="google.cloud.vision.v1p3beta1.Product",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.Product.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.vision.v1p3beta1.Product.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p3beta1.Product.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_category",
+            full_name="google.cloud.vision.v1p3beta1.Product.product_category",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_labels",
+            full_name="google.cloud.vision.v1p3beta1.Product.product_labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRODUCT_KEYVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=340,
+    serialized_end=545,
+)
+
+
+_PRODUCTSET = _descriptor.Descriptor(
+    name="ProductSet",
+    full_name="google.cloud.vision.v1p3beta1.ProductSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.ProductSet.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.vision.v1p3beta1.ProductSet.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_time",
+            full_name="google.cloud.vision.v1p3beta1.ProductSet.index_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_error",
+            full_name="google.cloud.vision.v1p3beta1.ProductSet.index_error",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=548,
+    serialized_end=685,
+)
+
+
+_REFERENCEIMAGE = _descriptor.Descriptor(
+    name="ReferenceImage",
+    full_name="google.cloud.vision.v1p3beta1.ReferenceImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.ReferenceImage.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p3beta1.ReferenceImage.uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_polys",
+            full_name="google.cloud.vision.v1p3beta1.ReferenceImage.bounding_polys",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=687,
+    serialized_end=799,
+)
+
+
+_CREATEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="CreateProductRequest",
+    full_name="google.cloud.vision.v1p3beta1.CreateProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.CreateProductRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p3beta1.CreateProductRequest.product",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_id",
+            full_name="google.cloud.vision.v1p3beta1.CreateProductRequest.product_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=801,
+    serialized_end=916,
+)
+
+
+_LISTPRODUCTSREQUEST = _descriptor.Descriptor(
+    name="ListProductsRequest",
+    full_name="google.cloud.vision.v1p3beta1.ListProductsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=918,
+    serialized_end=994,
+)
+
+
+_LISTPRODUCTSRESPONSE = _descriptor.Descriptor(
+    name="ListProductsResponse",
+    full_name="google.cloud.vision.v1p3beta1.ListProductsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsResponse.products",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=996,
+    serialized_end=1101,
+)
+
+
+_GETPRODUCTREQUEST = _descriptor.Descriptor(
+    name="GetProductRequest",
+    full_name="google.cloud.vision.v1p3beta1.GetProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.GetProductRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1103,
+    serialized_end=1136,
+)
+
+
+_UPDATEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="UpdateProductRequest",
+    full_name="google.cloud.vision.v1p3beta1.UpdateProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p3beta1.UpdateProductRequest.product",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.vision.v1p3beta1.UpdateProductRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1139,
+    serialized_end=1267,
+)
+
+
+_DELETEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="DeleteProductRequest",
+    full_name="google.cloud.vision.v1p3beta1.DeleteProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.DeleteProductRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1269,
+    serialized_end=1305,
+)
+
+
+_CREATEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="CreateProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.CreateProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.CreateProductSetRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1p3beta1.CreateProductSetRequest.product_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set_id",
+            full_name="google.cloud.vision.v1p3beta1.CreateProductSetRequest.product_set_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1308,
+    serialized_end=1437,
+)
+
+
+_LISTPRODUCTSETSREQUEST = _descriptor.Descriptor(
+    name="ListProductSetsRequest",
+    full_name="google.cloud.vision.v1p3beta1.ListProductSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.ListProductSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p3beta1.ListProductSetsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListProductSetsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1439,
+    serialized_end=1518,
+)
+
+
+_LISTPRODUCTSETSRESPONSE = _descriptor.Descriptor(
+    name="ListProductSetsResponse",
+    full_name="google.cloud.vision.v1p3beta1.ListProductSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_sets",
+            full_name="google.cloud.vision.v1p3beta1.ListProductSetsResponse.product_sets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListProductSetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1520,
+    serialized_end=1635,
+)
+
+
+_GETPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="GetProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.GetProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.GetProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1637,
+    serialized_end=1673,
+)
+
+
+_UPDATEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="UpdateProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.UpdateProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1p3beta1.UpdateProductSetRequest.product_set",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.vision.v1p3beta1.UpdateProductSetRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1676,
+    serialized_end=1814,
+)
+
+
+_DELETEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="DeleteProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.DeleteProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.DeleteProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1816,
+    serialized_end=1855,
+)
+
+
+_CREATEREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="CreateReferenceImageRequest",
+    full_name="google.cloud.vision.v1p3beta1.CreateReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.CreateReferenceImageRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_image",
+            full_name="google.cloud.vision.v1p3beta1.CreateReferenceImageRequest.reference_image",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_image_id",
+            full_name="google.cloud.vision.v1p3beta1.CreateReferenceImageRequest.reference_image_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1858,
+    serialized_end=2003,
+)
+
+
+_LISTREFERENCEIMAGESREQUEST = _descriptor.Descriptor(
+    name="ListReferenceImagesRequest",
+    full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2005,
+    serialized_end=2088,
+)
+
+
+_LISTREFERENCEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="ListReferenceImagesResponse",
+    full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference_images",
+            full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesResponse.reference_images",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesResponse.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListReferenceImagesResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2091,
+    serialized_end=2237,
+)
+
+
+_GETREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="GetReferenceImageRequest",
+    full_name="google.cloud.vision.v1p3beta1.GetReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.GetReferenceImageRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2239,
+    serialized_end=2279,
+)
+
+
+_DELETEREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="DeleteReferenceImageRequest",
+    full_name="google.cloud.vision.v1p3beta1.DeleteReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.DeleteReferenceImageRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2281,
+    serialized_end=2324,
+)
+
+
+_ADDPRODUCTTOPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="AddProductToProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.AddProductToProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.AddProductToProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p3beta1.AddProductToProductSetRequest.product",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2326,
+    serialized_end=2388,
+)
+
+
+_REMOVEPRODUCTFROMPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="RemoveProductFromProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.RemoveProductFromProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.RemoveProductFromProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p3beta1.RemoveProductFromProductSetRequest.product",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2390,
+    serialized_end=2457,
+)
+
+
+_LISTPRODUCTSINPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="ListProductsInProductSetRequest",
+    full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2459,
+    serialized_end=2545,
+)
+
+
+_LISTPRODUCTSINPRODUCTSETRESPONSE = _descriptor.Descriptor(
+    name="ListProductsInProductSetResponse",
+    full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetResponse.products",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p3beta1.ListProductsInProductSetResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2547,
+    serialized_end=2664,
+)
+
+
+_IMPORTPRODUCTSETSGCSSOURCE = _descriptor.Descriptor(
+    name="ImportProductSetsGcsSource",
+    full_name="google.cloud.vision.v1p3beta1.ImportProductSetsGcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="csv_file_uri",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsGcsSource.csv_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2666,
+    serialized_end=2716,
+)
+
+
+_IMPORTPRODUCTSETSINPUTCONFIG = _descriptor.Descriptor(
+    name="ImportProductSetsInputConfig",
+    full_name="google.cloud.vision.v1p3beta1.ImportProductSetsInputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsInputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsInputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2718,
+    serialized_end=2839,
+)
+
+
+_IMPORTPRODUCTSETSREQUEST = _descriptor.Descriptor(
+    name="ImportProductSetsRequest",
+    full_name="google.cloud.vision.v1p3beta1.ImportProductSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsRequest.input_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2841,
+    serialized_end=2966,
+)
+
+
+_IMPORTPRODUCTSETSRESPONSE = _descriptor.Descriptor(
+    name="ImportProductSetsResponse",
+    full_name="google.cloud.vision.v1p3beta1.ImportProductSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference_images",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsResponse.reference_images",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="statuses",
+            full_name="google.cloud.vision.v1p3beta1.ImportProductSetsResponse.statuses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2969,
+    serialized_end=3107,
+)
+
+
+_BATCHOPERATIONMETADATA = _descriptor.Descriptor(
+    name="BatchOperationMetadata",
+    full_name="google.cloud.vision.v1p3beta1.BatchOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1p3beta1.BatchOperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.vision.v1p3beta1.BatchOperationMetadata.submit_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.vision.v1p3beta1.BatchOperationMetadata.end_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BATCHOPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3110,
+    serialized_end=3396,
+)
+
+_PRODUCT_KEYVALUE.containing_type = _PRODUCT
+_PRODUCT.fields_by_name["product_labels"].message_type = _PRODUCT_KEYVALUE
+_PRODUCTSET.fields_by_name[
+    "index_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRODUCTSET.fields_by_name[
+    "index_error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_REFERENCEIMAGE.fields_by_name[
+    "bounding_polys"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CREATEPRODUCTREQUEST.fields_by_name["product"].message_type = _PRODUCT
+_LISTPRODUCTSRESPONSE.fields_by_name["products"].message_type = _PRODUCT
+_UPDATEPRODUCTREQUEST.fields_by_name["product"].message_type = _PRODUCT
+_UPDATEPRODUCTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEPRODUCTSETREQUEST.fields_by_name["product_set"].message_type = _PRODUCTSET
+_LISTPRODUCTSETSRESPONSE.fields_by_name["product_sets"].message_type = _PRODUCTSET
+_UPDATEPRODUCTSETREQUEST.fields_by_name["product_set"].message_type = _PRODUCTSET
+_UPDATEPRODUCTSETREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEREFERENCEIMAGEREQUEST.fields_by_name[
+    "reference_image"
+].message_type = _REFERENCEIMAGE
+_LISTREFERENCEIMAGESRESPONSE.fields_by_name[
+    "reference_images"
+].message_type = _REFERENCEIMAGE
+_LISTPRODUCTSINPRODUCTSETRESPONSE.fields_by_name["products"].message_type = _PRODUCT
+_IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].message_type = _IMPORTPRODUCTSETSGCSSOURCE
+_IMPORTPRODUCTSETSINPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name["gcs_source"]
+)
+_IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _IMPORTPRODUCTSETSINPUTCONFIG.oneofs_by_name["source"]
+_IMPORTPRODUCTSETSREQUEST.fields_by_name[
+    "input_config"
+].message_type = _IMPORTPRODUCTSETSINPUTCONFIG
+_IMPORTPRODUCTSETSRESPONSE.fields_by_name[
+    "reference_images"
+].message_type = _REFERENCEIMAGE
+_IMPORTPRODUCTSETSRESPONSE.fields_by_name[
+    "statuses"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "state"
+].enum_type = _BATCHOPERATIONMETADATA_STATE
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA_STATE.containing_type = _BATCHOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Product"] = _PRODUCT
+DESCRIPTOR.message_types_by_name["ProductSet"] = _PRODUCTSET
+DESCRIPTOR.message_types_by_name["ReferenceImage"] = _REFERENCEIMAGE
+DESCRIPTOR.message_types_by_name["CreateProductRequest"] = _CREATEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["ListProductsRequest"] = _LISTPRODUCTSREQUEST
+DESCRIPTOR.message_types_by_name["ListProductsResponse"] = _LISTPRODUCTSRESPONSE
+DESCRIPTOR.message_types_by_name["GetProductRequest"] = _GETPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProductRequest"] = _UPDATEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProductRequest"] = _DELETEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["CreateProductSetRequest"] = _CREATEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["ListProductSetsRequest"] = _LISTPRODUCTSETSREQUEST
+DESCRIPTOR.message_types_by_name["ListProductSetsResponse"] = _LISTPRODUCTSETSRESPONSE
+DESCRIPTOR.message_types_by_name["GetProductSetRequest"] = _GETPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProductSetRequest"] = _UPDATEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProductSetRequest"] = _DELETEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateReferenceImageRequest"
+] = _CREATEREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListReferenceImagesRequest"
+] = _LISTREFERENCEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListReferenceImagesResponse"
+] = _LISTREFERENCEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["GetReferenceImageRequest"] = _GETREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteReferenceImageRequest"
+] = _DELETEREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AddProductToProductSetRequest"
+] = _ADDPRODUCTTOPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RemoveProductFromProductSetRequest"
+] = _REMOVEPRODUCTFROMPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListProductsInProductSetRequest"
+] = _LISTPRODUCTSINPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListProductsInProductSetResponse"
+] = _LISTPRODUCTSINPRODUCTSETRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsGcsSource"
+] = _IMPORTPRODUCTSETSGCSSOURCE
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsInputConfig"
+] = _IMPORTPRODUCTSETSINPUTCONFIG
+DESCRIPTOR.message_types_by_name["ImportProductSetsRequest"] = _IMPORTPRODUCTSETSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsResponse"
+] = _IMPORTPRODUCTSETSRESPONSE
+DESCRIPTOR.message_types_by_name["BatchOperationMetadata"] = _BATCHOPERATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Product = _reflection.GeneratedProtocolMessageType(
+    "Product",
+    (_message.Message,),
+    dict(
+        KeyValue=_reflection.GeneratedProtocolMessageType(
+            "KeyValue",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCT_KEYVALUE,
+                __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+                __doc__="""A product label represented as a key-value pair.
+    
+    
+    Attributes:
+        key:
+            The key of the label attached to the product. Cannot be empty
+            and cannot exceed 128 bytes.
+        value:
+            The value of the label attached to the product. Cannot be
+            empty and cannot exceed 128 bytes.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Product.KeyValue)
+            ),
+        ),
+        DESCRIPTOR=_PRODUCT,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""A Product contains ReferenceImages.
+  
+  
+  Attributes:
+      name:
+          The resource name of the product.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+          This field is ignored when creating a product.
+      display_name:
+          The user-provided name for this Product. Must not be empty.
+          Must be at most 4096 characters long.
+      description:
+          User-provided metadata to be stored with this product. Must be
+          at most 4096 characters long.
+      product_category:
+          The category for the product identified by the reference
+          image. This should be either "homegoods" or "apparel".  This
+          field is immutable.
+      product_labels:
+          Key-value pairs that can be attached to a product. At query
+          time, constraints can be specified based on the
+          product\_labels.  Note that integer values can be provided as
+          strings, e.g. "1199". Only strings with integer values can
+          match a range-based restriction which is to be supported soon.
+          Multiple values can be assigned to the same key. One product
+          may have up to 100 product\_labels.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Product)
+    ),
+)
+_sym_db.RegisterMessage(Product)
+_sym_db.RegisterMessage(Product.KeyValue)
+
+ProductSet = _reflection.GeneratedProtocolMessageType(
+    "ProductSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSET,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""A ProductSet contains Products. A ProductSet can contain a maximum of 1
+  million reference images. If the limit is exceeded, periodic indexing
+  will fail.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ProductSet.  Format is: ``projects/PR
+          OJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``.  This
+          field is ignored when creating a ProductSet.
+      display_name:
+          The user-provided name for this ProductSet. Must not be empty.
+          Must be at most 4096 characters long.
+      index_time:
+          Output only. The time at which this ProductSet was last
+          indexed. Query results will reflect all updates before this
+          time. If this ProductSet has never been indexed, this field is
+          0.  This field is ignored when creating a ProductSet.
+      index_error:
+          Output only. If there was an error with indexing the product
+          set, the field is populated.  This field is ignored when
+          creating a ProductSet.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ProductSet)
+    ),
+)
+_sym_db.RegisterMessage(ProductSet)
+
+ReferenceImage = _reflection.GeneratedProtocolMessageType(
+    "ReferenceImage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REFERENCEIMAGE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""A ``ReferenceImage`` represents a product image and its associated
+  metadata, such as bounding boxes.
+  
+  
+  Attributes:
+      name:
+          The resource name of the reference image.  Format is:  ``proje
+          cts/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
+          mages/IMAGE_ID``.  This field is ignored when creating a
+          reference image.
+      uri:
+          The Google Cloud Storage URI of the reference image.  The URI
+          must start with ``gs://``.  Required.
+      bounding_polys:
+          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 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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ReferenceImage)
+    ),
+)
+_sym_db.RegisterMessage(ReferenceImage)
+
+CreateProductRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateProduct`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the Product should be created.  Format is
+          ``projects/PROJECT_ID/locations/LOC_ID``.
+      product:
+          The product to create.
+      product_id:
+          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 error is returned with code
+          ALREADY\_EXISTS. Must be at most 128 characters long. It
+          cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.CreateProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProductRequest)
+
+ListProductsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProducts`` method.
+  
+  
+  Attributes:
+      parent:
+          The project OR ProductSet from which Products should be
+          listed.  Format: ``projects/PROJECT_ID/locations/LOC_ID``
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListProductsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsRequest)
+
+ListProductsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProducts`` method.
+  
+  
+  Attributes:
+      products:
+          List of products.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListProductsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsResponse)
+
+GetProductRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetProduct`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the Product to get.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.GetProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProductRequest)
+
+UpdateProductRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``UpdateProduct`` method.
+  
+  
+  Attributes:
+      product:
+          The Product resource which replaces the one on the server.
+          product.name is immutable.
+      update_mask:
+          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 ``description``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.UpdateProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProductRequest)
+
+DeleteProductRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteProduct`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of product to delete.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.DeleteProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProductRequest)
+
+CreateProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateProductSet`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the ProductSet should be created.  Format
+          is ``projects/PROJECT_ID/locations/LOC_ID``.
+      product_set:
+          The ProductSet to create.
+      product_set_id:
+          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 error is returned with code
+          ALREADY\_EXISTS. Must be at most 128 characters long. It
+          cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.CreateProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProductSetRequest)
+
+ListProductSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSETSREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProductSets`` method.
+  
+  
+  Attributes:
+      parent:
+          The project from which ProductSets should be listed.  Format
+          is ``projects/PROJECT_ID/locations/LOC_ID``.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListProductSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductSetsRequest)
+
+ListProductSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSETSRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProductSets`` method.
+  
+  
+  Attributes:
+      product_sets:
+          List of ProductSets.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListProductSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductSetsResponse)
+
+GetProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the ProductSet to get.  Format is: ``projects
+          /PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.GetProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProductSetRequest)
+
+UpdateProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``UpdateProductSet`` method.
+  
+  
+  Attributes:
+      product_set:
+          The ProductSet resource which replaces the one on the server.
+      update_mask:
+          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 path is
+          ``display_name``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.UpdateProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProductSetRequest)
+
+DeleteProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the ProductSet to delete.  Format is: ``proje
+          cts/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.DeleteProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProductSetRequest)
+
+CreateReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateReferenceImage`` method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the product in which to create the reference
+          image.  Format is
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+      reference_image:
+          The reference image to create. If an image ID is specified, it
+          is ignored.
+      reference_image_id:
+          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 already in use, an error is returned
+          with code ALREADY\_EXISTS. Must be at most 128 characters
+          long. It cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.CreateReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateReferenceImageRequest)
+
+ListReferenceImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListReferenceImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTREFERENCEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListReferenceImages`` method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the product containing the reference images.
+          Format is
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          A token identifying a page of results to be returned. This is
+          the value of ``nextPageToken`` returned in a previous
+          reference image list request.  Defaults to the first page if
+          not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListReferenceImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListReferenceImagesRequest)
+
+ListReferenceImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListReferenceImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTREFERENCEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListReferenceImages`` method.
+  
+  
+  Attributes:
+      reference_images:
+          The list of reference images.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      next_page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListReferenceImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListReferenceImagesResponse)
+
+GetReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "GetReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetReferenceImage`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ReferenceImage to get.  Format is:  `
+          `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/refe
+          renceImages/IMAGE_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.GetReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetReferenceImageRequest)
+
+DeleteReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteReferenceImage`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name of the reference image to delete.  Format
+          is:  ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_I
+          D/referenceImages/IMAGE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.DeleteReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteReferenceImageRequest)
+
+AddProductToProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "AddProductToProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDPRODUCTTOPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``AddProductToProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name for the ProductSet to modify.  Format is: ``
+          projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_I
+          D``
+      product:
+          The resource name for the Product to be added to this
+          ProductSet.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.AddProductToProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(AddProductToProductSetRequest)
+
+RemoveProductFromProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "RemoveProductFromProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REMOVEPRODUCTFROMPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``RemoveProductFromProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name for the ProductSet to modify.  Format is: ``
+          projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_I
+          D``
+      product:
+          The resource name for the Product to be removed from this
+          ProductSet.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.RemoveProductFromProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(RemoveProductFromProductSetRequest)
+
+ListProductsInProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductsInProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSINPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProductsInProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The ProductSet resource for which to retrieve Products.
+          Format is: ``projects/PROJECT_ID/locations/LOC_ID/productSets/
+          PRODUCT_SET_ID``
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListProductsInProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsInProductSetRequest)
+
+ListProductsInProductSetResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductsInProductSetResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSINPRODUCTSETRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProductsInProductSet`` method.
+  
+  
+  Attributes:
+      products:
+          The list of Products.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ListProductsInProductSetResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsInProductSetResponse)
+
+ImportProductSetsGcsSource = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsGcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSGCSSOURCE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""The Google Cloud Storage location for a csv file which preserves a list
+  of ImportProductSetRequests in each line.
+  
+  
+  Attributes:
+      csv_file_uri:
+          The Google Cloud Storage URI of the input csv file.  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. 1.
+          image\_uri 2, image\_id 3. product\_set\_id 4. product\_id 5,
+          product\_category 6, product\_display\_name 7, labels 8.
+          bounding\_poly  Columns 1, 3, 4, and 5 are required, other
+          columns are optional. A new ProductSet/Product with the same
+          id will be created on the fly if the ProductSet/Product
+          specified by product\_set\_id/product\_id does not exist.  The
+          image\_id field is optional but has to be unique if provided.
+          If it is empty, we will automatically assign an unique id to
+          the image.  The product\_display\_name field is optional. If
+          it is empty, a space (" ") is used as the place holder for the
+          product display\_name, which can be updated later through the
+          realtime API.  If the Product with product\_id already exists,
+          the fields product\_display\_name, product\_category and
+          labels are ignored.  If a Product doesn't exist and needs to
+          be created on the fly, the product\_display\_name field refers
+          to [Product.display\_name][google.cloud.vision.v1p3beta1.Produ
+          ct.display\_name], the product\_category field refers to [Prod
+          uct.product\_category][google.cloud.vision.v1p3beta1.Product.p
+          roduct\_category], and the labels field refers to
+          [Product.labels][].  Labels (optional) should be a line
+          containing a list of comma-separated key-value pairs, with the
+          format "key\_1=value\_1,key\_2=value\_2,...,key\_n=value\_n".
+          The bounding\_poly (optional) field is used to identify one
+          region of interest from the image in the same manner as
+          CreateReferenceImage. If no bounding\_poly is specified, the
+          system will try to detect regions of interest automatically.
+          Note that the pipeline will resize the image if the image
+          resolution is too large to process (above 20MP).  Also note
+          that at most one bounding\_poly is allowed per line. If the
+          image contains multiple regions of interest, the csv should
+          contain one line per region of interest.  The bounding\_poly
+          column should contain an even number of comma-separated
+          numbers, with the format
+          "p1\_x,p1\_y,p2\_x,p2\_y,...,pn\_x,pn\_y". Nonnegative
+          integers should be used for absolute bounding polygons, and
+          float values in [0, 1] should be used for normalized bounding
+          polygons.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImportProductSetsGcsSource)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsGcsSource)
+
+ImportProductSetsInputConfig = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsInputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSINPUTCONFIG,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""The input content for the ``ImportProductSets`` method.
+  
+  
+  Attributes:
+      source:
+          The source of the input.
+      gcs_source:
+          The Google Cloud Storage location for a csv file which
+          preserves a list of ImportProductSetRequests in each line.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImportProductSetsInputConfig)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsInputConfig)
+
+ImportProductSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSREQUEST,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ImportProductSets`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the ProductSets should be imported.
+          Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+      input_config:
+          The input content for the list of requests.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImportProductSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsRequest)
+
+ImportProductSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSRESPONSE,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      reference_images:
+          The list of reference\_images that are imported successfully.
+      statuses:
+          The rpc status for each ImportProductSet request, including
+          both successes and errors.  The number of statuses here
+          matches the number of lines in the csv file, and statuses[i]
+          stores the success or failure status of processing the i-th
+          line of the csv, starting from line 0.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.ImportProductSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsResponse)
+
+BatchOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "BatchOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHOPERATIONMETADATA,
+        __module__="google.cloud.vision_v1p3beta1.proto.product_search_service_pb2",
+        __doc__="""Metadata for the batch operations such as the current state.
+  
+  This is included in the ``metadata`` field of the ``Operation`` returned
+  by the ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      state:
+          The current state of the batch operation.
+      submit_time:
+          The time when the batch request was submitted to the server.
+      end_time:
+          The time when the batch request is finished and [google.longru
+          nning.Operation.done][google.longrunning.Operation.done] is
+          set to true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.BatchOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(BatchOperationMetadata)
+
+
+DESCRIPTOR._options = None
+
+_PRODUCTSEARCH = _descriptor.ServiceDescriptor(
+    name="ProductSearch",
+    full_name="google.cloud.vision.v1p3beta1.ProductSearch",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=3399,
+    serialized_end=6886,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.CreateProductSet",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002E"6/v1p3beta1/{parent=projects/*/locations/*}/productSets:\013product_set'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProductSets",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.ListProductSets",
+            index=1,
+            containing_service=None,
+            input_type=_LISTPRODUCTSETSREQUEST,
+            output_type=_LISTPRODUCTSETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0028\0226/v1p3beta1/{parent=projects/*/locations/*}/productSets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.GetProductSet",
+            index=2,
+            containing_service=None,
+            input_type=_GETPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                "\202\323\344\223\0028\0226/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.UpdateProductSet",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                "\202\323\344\223\002Q2B/v1p3beta1/{product_set.name=projects/*/locations/*/productSets/*}:\013product_set"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.DeleteProductSet",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0028*6/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateProduct",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.CreateProduct",
+            index=5,
+            containing_service=None,
+            input_type=_CREATEPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                '\202\323\344\223\002>"3/v1p3beta1/{parent=projects/*/locations/*}/products:\007product'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProducts",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.ListProducts",
+            index=6,
+            containing_service=None,
+            input_type=_LISTPRODUCTSREQUEST,
+            output_type=_LISTPRODUCTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1p3beta1/{parent=projects/*/locations/*}/products"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProduct",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.GetProduct",
+            index=7,
+            containing_service=None,
+            input_type=_GETPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1p3beta1/{name=projects/*/locations/*/products/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProduct",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.UpdateProduct",
+            index=8,
+            containing_service=None,
+            input_type=_UPDATEPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                "\202\323\344\223\002F2;/v1p3beta1/{product.name=projects/*/locations/*/products/*}:\007product"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProduct",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.DeleteProduct",
+            index=9,
+            containing_service=None,
+            input_type=_DELETEPRODUCTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0025*3/v1p3beta1/{name=projects/*/locations/*/products/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateReferenceImage",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.CreateReferenceImage",
+            index=10,
+            containing_service=None,
+            input_type=_CREATEREFERENCEIMAGEREQUEST,
+            output_type=_REFERENCEIMAGE,
+            serialized_options=_b(
+                '\202\323\344\223\002X"E/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages:\017reference_image'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteReferenceImage",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.DeleteReferenceImage",
+            index=11,
+            containing_service=None,
+            input_type=_DELETEREFERENCEIMAGEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002G*E/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListReferenceImages",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.ListReferenceImages",
+            index=12,
+            containing_service=None,
+            input_type=_LISTREFERENCEIMAGESREQUEST,
+            output_type=_LISTREFERENCEIMAGESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002G\022E/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetReferenceImage",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.GetReferenceImage",
+            index=13,
+            containing_service=None,
+            input_type=_GETREFERENCEIMAGEREQUEST,
+            output_type=_REFERENCEIMAGE,
+            serialized_options=_b(
+                "\202\323\344\223\002G\022E/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AddProductToProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.AddProductToProductSet",
+            index=14,
+            containing_service=None,
+            input_type=_ADDPRODUCTTOPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002F"A/v1p3beta1/{name=projects/*/locations/*/productSets/*}:addProduct:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RemoveProductFromProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.RemoveProductFromProductSet",
+            index=15,
+            containing_service=None,
+            input_type=_REMOVEPRODUCTFROMPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002I"D/v1p3beta1/{name=projects/*/locations/*/productSets/*}:removeProduct:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProductsInProductSet",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.ListProductsInProductSet",
+            index=16,
+            containing_service=None,
+            input_type=_LISTPRODUCTSINPRODUCTSETREQUEST,
+            output_type=_LISTPRODUCTSINPRODUCTSETRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002A\022?/v1p3beta1/{name=projects/*/locations/*/productSets/*}/products"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportProductSets",
+            full_name="google.cloud.vision.v1p3beta1.ProductSearch.ImportProductSets",
+            index=17,
+            containing_service=None,
+            input_type=_IMPORTPRODUCTSETSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v1p3beta1/{parent=projects/*/locations/*}/productSets:import:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PRODUCTSEARCH)
+
+DESCRIPTOR.services_by_name["ProductSearch"] = _PRODUCTSEARCH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/product_search_service_pb2_grpc.py b/vision/google/cloud/vision_v1p3beta1/proto/product_search_service_pb2_grpc.py
new file mode 100644
index 000000000000..95c62612d0b8
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/product_search_service_pb2_grpc.py
@@ -0,0 +1,505 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1p3beta1.proto import (
+    product_search_service_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ProductSearchStub(object):
+    """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
+  `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
+  `projects/*/locations/*/products/*`
+
+  - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
+  [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
+  named
+  `projects/*/locations/*/products/*/referenceImages/*`
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/CreateProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.CreateProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.ListProductSets = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/ListProductSets",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsResponse.FromString,
+        )
+        self.GetProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/GetProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.GetProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.UpdateProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/UpdateProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.UpdateProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.DeleteProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/DeleteProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DeleteProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/CreateProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.CreateProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.ListProducts = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/ListProducts",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsResponse.FromString,
+        )
+        self.GetProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/GetProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.GetProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.UpdateProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/UpdateProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.UpdateProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.DeleteProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/DeleteProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DeleteProductRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/CreateReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.CreateReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.FromString,
+        )
+        self.DeleteReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/DeleteReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DeleteReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListReferenceImages = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/ListReferenceImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesResponse.FromString,
+        )
+        self.GetReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/GetReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.GetReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.FromString,
+        )
+        self.AddProductToProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/AddProductToProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.AddProductToProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RemoveProductFromProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/RemoveProductFromProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.RemoveProductFromProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListProductsInProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/ListProductsInProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetResponse.FromString,
+        )
+        self.ImportProductSets = channel.unary_unary(
+            "/google.cloud.vision.v1p3beta1.ProductSearch/ImportProductSets",
+            request_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ImportProductSetsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ProductSearchServicer(object):
+    """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
+  `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
+  `projects/*/locations/*/products/*`
+
+  - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
+  [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
+  named
+  `projects/*/locations/*/products/*/referenceImages/*`
+  """
+
+    def CreateProductSet(self, request, context):
+        """Creates and returns a new ProductSet resource.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+    4096 characters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProductSets(self, request, context):
+        """Lists ProductSets in an unspecified order.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+    than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProductSet(self, request, context):
+        """Gets information associated with a ProductSet.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProductSet(self, request, context):
+        """Makes changes to a ProductSet resource.
+    Only display_name can be updated currently.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+    missing from the request or longer than 4096 characters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProductSet(self, request, context):
+        """Permanently deletes a ProductSet. All Products and ReferenceImages in the
+    ProductSet will be deleted.
+
+    The actual image files are not deleted from Google Cloud Storage.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateProduct(self, request, context):
+        """Creates and returns a new product resource.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+    characters.
+    * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProducts(self, request, context):
+        """Lists products in an unspecified order.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProduct(self, request, context):
+        """Gets information associated with a Product.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProduct(self, request, context):
+        """Makes changes to a Product resource.
+    Only display_name, description and labels can be updated right now.
+
+    If labels are updated, the change will not be reflected in queries until
+    the next index time.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product does not exist.
+    * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+    missing from the request or longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if description is present in update_mask but is
+    longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProduct(self, request, context):
+        """Permanently deletes a product and its reference images.
+
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateReferenceImage(self, request, context):
+        """Creates and returns a new ReferenceImage resource.
+
+    The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+    the system will try to detect regions of interest in the image that are
+    compatible with the product_category on the parent product. If it is
+    specified, detection is ALWAYS skipped. The system converts polygons into
+    non-rotated rectangles.
+
+    Note that the pipeline will resize the image if the image resolution is too
+    large to process (above 50MP).
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+    characters.
+    * Returns INVALID_ARGUMENT if the product does not exist.
+    * 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteReferenceImage(self, request, context):
+        """Permanently deletes a reference image.
+
+    The image metadata will be deleted right away, but search queries
+    against ProductSets containing the image may still work until all related
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListReferenceImages(self, request, context):
+        """Lists reference images.
+
+    Possible errors:
+
+    * 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetReferenceImage(self, request, context):
+        """Gets information associated with a ReferenceImage.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the specified image does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AddProductToProductSet(self, request, context):
+        """Adds a Product to the specified ProductSet. If the Product is already
+    present, no change is made.
+
+    One Product can be added to at most 100 ProductSets.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RemoveProductFromProductSet(self, request, context):
+        """Removes a Product from the specified ProductSet.
+
+    Possible errors:
+
+    * Returns NOT_FOUND If the Product is not found under the ProductSet.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProductsInProductSet(self, request, context):
+        """Lists the Products in a ProductSet, in an unspecified order. If the
+    ProductSet does not exist, the products field of the response will be
+    empty.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportProductSets(self, request, context):
+        """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.
+    `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.v1p3beta1.ImportProductSetsGcsSource.csv_file_uri].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ProductSearchServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.CreateProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "ListProductSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProductSets,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsResponse.SerializeToString,
+        ),
+        "GetProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.GetProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "UpdateProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.UpdateProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "DeleteProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DeleteProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.CreateProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "ListProducts": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProducts,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsResponse.SerializeToString,
+        ),
+        "GetProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.GetProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "UpdateProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.UpdateProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "DeleteProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DeleteProductRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.CreateReferenceImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.SerializeToString,
+        ),
+        "DeleteReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.DeleteReferenceImageRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListReferenceImages": grpc.unary_unary_rpc_method_handler(
+            servicer.ListReferenceImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesResponse.SerializeToString,
+        ),
+        "GetReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.GetReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.GetReferenceImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.SerializeToString,
+        ),
+        "AddProductToProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.AddProductToProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.AddProductToProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RemoveProductFromProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.RemoveProductFromProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.RemoveProductFromProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListProductsInProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProductsInProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetResponse.SerializeToString,
+        ),
+        "ImportProductSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportProductSets,
+            request_deserializer=google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_product__search__service__pb2.ImportProductSetsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1p3beta1.ProductSearch", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/text_annotation.proto b/vision/google/cloud/vision_v1p3beta1/proto/text_annotation.proto
new file mode 100644
index 000000000000..3c256c5773c9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/text_annotation.proto
@@ -0,0 +1,259 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p3beta1/geometry.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "TextAnnotationProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+// TextAnnotation contains a structured representation of OCR extracted text.
+// The hierarchy of an OCR extracted text structure is like this:
+//     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.v1p3beta1.TextAnnotation.TextProperty]
+// message definition below for more detail.
+message TextAnnotation {
+  // 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;
+  }
+
+  // Detected start or end of a structural component.
+  message DetectedBreak {
+    // Enum to denote the type of break found. New line, space etc.
+    enum BreakType {
+      // Unknown break label type.
+      UNKNOWN = 0;
+
+      // Regular space.
+      SPACE = 1;
+
+      // Sure space (very wide).
+      SURE_SPACE = 2;
+
+      // Line-wrapping break.
+      EOL_SURE_SPACE = 3;
+
+      // End-line hyphen that is not present in text; does not co-occur with
+      // `SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.
+      HYPHEN = 4;
+
+      // Line break that ends a paragraph.
+      LINE_BREAK = 5;
+    }
+
+    // Detected break type.
+    BreakType type = 1;
+
+    // True if break prepends the element.
+    bool is_prefix = 2;
+  }
+
+  // Additional information detected on the structural component.
+  message TextProperty {
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 1;
+
+    // Detected start or end of a text segment.
+    DetectedBreak detected_break = 2;
+  }
+
+  // List of pages detected by OCR.
+  repeated Page pages = 1;
+
+  // UTF-8 text detected on the pages.
+  string text = 2;
+}
+
+// Detected page from OCR.
+message Page {
+  // Additional information detected on the page.
+  TextAnnotation.TextProperty property = 1;
+
+  // Page width. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 width = 2;
+
+  // Page height. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 height = 3;
+
+  // List of blocks of text, images etc on this page.
+  repeated Block blocks = 4;
+
+  // Confidence of the OCR results on the page. Range [0, 1].
+  float confidence = 5;
+}
+
+// Logical element on the page.
+message Block {
+  // Type of a block (text, image etc) as identified by OCR.
+  enum BlockType {
+    // Unknown block type.
+    UNKNOWN = 0;
+
+    // Regular text block.
+    TEXT = 1;
+
+    // Table block.
+    TABLE = 2;
+
+    // Image block.
+    PICTURE = 3;
+
+    // Horizontal/vertical line box.
+    RULER = 4;
+
+    // Barcode block.
+    BARCODE = 5;
+  }
+
+  // Additional information detected for the block.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the block.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //
+  // * when the text is horizontal it might look like:
+  //
+  //         0----1
+  //         |    |
+  //         3----2
+  //
+  // * when it's rotated 180 degrees around the top-left corner it becomes:
+  //
+  //         2----3
+  //         |    |
+  //         1----0
+  //
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of paragraphs in this block (if this blocks is of type text).
+  repeated Paragraph paragraphs = 3;
+
+  // Detected block type (text, image etc) for this block.
+  BlockType block_type = 4;
+
+  // Confidence of the OCR results on the block. Range [0, 1].
+  float confidence = 5;
+}
+
+// Structural unit of text representing a number of words in certain order.
+message Paragraph {
+  // Additional information detected for the paragraph.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the paragraph.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of words in this paragraph.
+  repeated Word words = 3;
+
+  // Confidence of the OCR results for the paragraph. Range [0, 1].
+  float confidence = 4;
+}
+
+// A word representation.
+message Word {
+  // Additional information detected for the word.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the word.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of symbols in the word.
+  // The order of the symbols follows the natural reading order.
+  repeated Symbol symbols = 3;
+
+  // Confidence of the OCR results for the word. Range [0, 1].
+  float confidence = 4;
+}
+
+// A single symbol representation.
+message Symbol {
+  // Additional information detected for the symbol.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the symbol.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // The actual UTF-8 representation of the symbol.
+  string text = 3;
+
+  // Confidence of the OCR results for the symbol. Range [0, 1].
+  float confidence = 4;
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/text_annotation_pb2.py b/vision/google/cloud/vision_v1p3beta1/proto/text_annotation_pb2.py
new file mode 100644
index 000000000000..af714dd094c1
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/text_annotation_pb2.py
@@ -0,0 +1,1137 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p3beta1/proto/text_annotation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p3beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p3beta1/proto/text_annotation.proto",
+    package="google.cloud.vision.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p3beta1B\023TextAnnotationProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p3beta1/proto/text_annotation.proto\x12\x1dgoogle.cloud.vision.v1p3beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p3beta1/proto/geometry.proto"\xb2\x04\n\x0eTextAnnotation\x12\x32\n\x05pages\x18\x01 \x03(\x0b\x32#.google.cloud.vision.v1p3beta1.Page\x12\x0c\n\x04text\x18\x02 \x01(\t\x1a=\n\x10\x44\x65tectedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x1a\xdc\x01\n\rDetectedBreak\x12S\n\x04type\x18\x01 \x01(\x0e\x32\x45.google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.BreakType\x12\x11\n\tis_prefix\x18\x02 \x01(\x08"c\n\tBreakType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\t\n\x05SPACE\x10\x01\x12\x0e\n\nSURE_SPACE\x10\x02\x12\x12\n\x0e\x45OL_SURE_SPACE\x10\x03\x12\n\n\x06HYPHEN\x10\x04\x12\x0e\n\nLINE_BREAK\x10\x05\x1a\xbf\x01\n\x0cTextProperty\x12Z\n\x12\x64\x65tected_languages\x18\x01 \x03(\x0b\x32>.google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage\x12S\n\x0e\x64\x65tected_break\x18\x02 \x01(\x0b\x32;.google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak"\xbd\x01\n\x04Page\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty\x12\r\n\x05width\x18\x02 \x01(\x05\x12\x0e\n\x06height\x18\x03 \x01(\x05\x12\x34\n\x06\x62locks\x18\x04 \x03(\x0b\x32$.google.cloud.vision.v1p3beta1.Block\x12\x12\n\nconfidence\x18\x05 \x01(\x02"\x82\x03\n\x05\x42lock\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12<\n\nparagraphs\x18\x03 \x03(\x0b\x32(.google.cloud.vision.v1p3beta1.Paragraph\x12\x42\n\nblock_type\x18\x04 \x01(\x0e\x32..google.cloud.vision.v1p3beta1.Block.BlockType\x12\x12\n\nconfidence\x18\x05 \x01(\x02"R\n\tBlockType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x08\n\x04TEXT\x10\x01\x12\t\n\x05TABLE\x10\x02\x12\x0b\n\x07PICTURE\x10\x03\x12\t\n\x05RULER\x10\x04\x12\x0b\n\x07\x42\x41RCODE\x10\x05"\xe4\x01\n\tParagraph\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12\x32\n\x05words\x18\x03 \x03(\x0b\x32#.google.cloud.vision.v1p3beta1.Word\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xe3\x01\n\x04Word\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12\x36\n\x07symbols\x18\x03 \x03(\x0b\x32%.google.cloud.vision.v1p3beta1.Symbol\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xbb\x01\n\x06Symbol\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p3beta1.BoundingPoly\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x42\x82\x01\n!com.google.cloud.vision.v1p3beta1B\x13TextAnnotationProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE = _descriptor.EnumDescriptor(
+    name="BreakType",
+    full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.BreakType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPACE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SURE_SPACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EOL_SURE_SPACE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HYPHEN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINE_BREAK", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=444,
+    serialized_end=543,
+)
+_sym_db.RegisterEnumDescriptor(_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE)
+
+_BLOCK_BLOCKTYPE = _descriptor.EnumDescriptor(
+    name="BlockType",
+    full_name="google.cloud.vision.v1p3beta1.Block.BlockType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PICTURE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RULER", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BARCODE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1236,
+    serialized_end=1318,
+)
+_sym_db.RegisterEnumDescriptor(_BLOCK_BLOCKTYPE)
+
+
+_TEXTANNOTATION_DETECTEDLANGUAGE = _descriptor.Descriptor(
+    name="DetectedLanguage",
+    full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=259,
+    serialized_end=320,
+)
+
+_TEXTANNOTATION_DETECTEDBREAK = _descriptor.Descriptor(
+    name="DetectedBreak",
+    full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_prefix",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak.is_prefix",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=323,
+    serialized_end=543,
+)
+
+_TEXTANNOTATION_TEXTPROPERTY = _descriptor.Descriptor(
+    name="TextProperty",
+    full_name="google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="detected_languages",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty.detected_languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detected_break",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty.detected_break",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=546,
+    serialized_end=737,
+)
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.vision.v1p3beta1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.pages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p3beta1.TextAnnotation.text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TEXTANNOTATION_DETECTEDLANGUAGE,
+        _TEXTANNOTATION_DETECTEDBREAK,
+        _TEXTANNOTATION_TEXTPROPERTY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=175,
+    serialized_end=737,
+)
+
+
+_PAGE = _descriptor.Descriptor(
+    name="Page",
+    full_name="google.cloud.vision.v1p3beta1.Page",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p3beta1.Page.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.cloud.vision.v1p3beta1.Page.width",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.cloud.vision.v1p3beta1.Page.height",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocks",
+            full_name="google.cloud.vision.v1p3beta1.Page.blocks",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.Page.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=740,
+    serialized_end=929,
+)
+
+
+_BLOCK = _descriptor.Descriptor(
+    name="Block",
+    full_name="google.cloud.vision.v1p3beta1.Block",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p3beta1.Block.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p3beta1.Block.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="paragraphs",
+            full_name="google.cloud.vision.v1p3beta1.Block.paragraphs",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="block_type",
+            full_name="google.cloud.vision.v1p3beta1.Block.block_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.Block.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BLOCK_BLOCKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=932,
+    serialized_end=1318,
+)
+
+
+_PARAGRAPH = _descriptor.Descriptor(
+    name="Paragraph",
+    full_name="google.cloud.vision.v1p3beta1.Paragraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p3beta1.Paragraph.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p3beta1.Paragraph.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.vision.v1p3beta1.Paragraph.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.Paragraph.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1321,
+    serialized_end=1549,
+)
+
+
+_WORD = _descriptor.Descriptor(
+    name="Word",
+    full_name="google.cloud.vision.v1p3beta1.Word",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p3beta1.Word.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p3beta1.Word.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="symbols",
+            full_name="google.cloud.vision.v1p3beta1.Word.symbols",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.Word.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1552,
+    serialized_end=1779,
+)
+
+
+_SYMBOL = _descriptor.Descriptor(
+    name="Symbol",
+    full_name="google.cloud.vision.v1p3beta1.Symbol",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p3beta1.Symbol.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p3beta1.Symbol.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p3beta1.Symbol.text",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p3beta1.Symbol.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1782,
+    serialized_end=1969,
+)
+
+_TEXTANNOTATION_DETECTEDLANGUAGE.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK.fields_by_name[
+    "type"
+].enum_type = _TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE
+_TEXTANNOTATION_DETECTEDBREAK.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE.containing_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_languages"
+].message_type = _TEXTANNOTATION_DETECTEDLANGUAGE
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_break"
+].message_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION.fields_by_name["pages"].message_type = _PAGE
+_PAGE.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PAGE.fields_by_name["blocks"].message_type = _BLOCK
+_BLOCK.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_BLOCK.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_BLOCK.fields_by_name["paragraphs"].message_type = _PARAGRAPH
+_BLOCK.fields_by_name["block_type"].enum_type = _BLOCK_BLOCKTYPE
+_BLOCK_BLOCKTYPE.containing_type = _BLOCK
+_PARAGRAPH.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PARAGRAPH.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PARAGRAPH.fields_by_name["words"].message_type = _WORD
+_WORD.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_WORD.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_WORD.fields_by_name["symbols"].message_type = _SYMBOL
+_SYMBOL.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_SYMBOL.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p3beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["Page"] = _PAGE
+DESCRIPTOR.message_types_by_name["Block"] = _BLOCK
+DESCRIPTOR.message_types_by_name["Paragraph"] = _PARAGRAPH
+DESCRIPTOR.message_types_by_name["Word"] = _WORD
+DESCRIPTOR.message_types_by_name["Symbol"] = _SYMBOL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DetectedLanguage=_reflection.GeneratedProtocolMessageType(
+            "DetectedLanguage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDLANGUAGE,
+                __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+                __doc__="""Detected language for a structural component.
+    
+    
+    Attributes:
+        language_code:
+            The BCP-47 language code, such as "en-US" or "sr-Latn". For
+            more information, see http://www.unicode.org/reports/tr35/#Uni
+            code\_locale\_identifier.
+        confidence:
+            Confidence of detected language. Range [0, 1].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.TextAnnotation.DetectedLanguage)
+            ),
+        ),
+        DetectedBreak=_reflection.GeneratedProtocolMessageType(
+            "DetectedBreak",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDBREAK,
+                __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+                __doc__="""Detected start or end of a structural component.
+    
+    
+    Attributes:
+        type:
+            Detected break type.
+        is_prefix:
+            True if break prepends the element.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.TextAnnotation.DetectedBreak)
+            ),
+        ),
+        TextProperty=_reflection.GeneratedProtocolMessageType(
+            "TextProperty",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_TEXTPROPERTY,
+                __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+                __doc__="""Additional information detected on the structural component.
+    
+    
+    Attributes:
+        detected_languages:
+            A list of detected languages together with confidence.
+        detected_break:
+            Detected start or end of a text segment.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.TextAnnotation.TextProperty)
+            ),
+        ),
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+        __doc__="""TextAnnotation contains a structured representation of OCR extracted
+  text. The hierarchy of an OCR extracted text structure is like this:
+  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.v1p3beta1.TextAnnotation.TextProperty]
+  message definition below for more detail.
+  
+  
+  Attributes:
+      pages:
+          List of pages detected by OCR.
+      text:
+          UTF-8 text detected on the pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+_sym_db.RegisterMessage(TextAnnotation.DetectedLanguage)
+_sym_db.RegisterMessage(TextAnnotation.DetectedBreak)
+_sym_db.RegisterMessage(TextAnnotation.TextProperty)
+
+Page = _reflection.GeneratedProtocolMessageType(
+    "Page",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAGE,
+        __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+        __doc__="""Detected page from OCR.
+  
+  
+  Attributes:
+      property:
+          Additional information detected on the page.
+      width:
+          Page width. For PDFs the unit is points. For images (including
+          TIFFs) the unit is pixels.
+      height:
+          Page height. For PDFs the unit is points. For images
+          (including TIFFs) the unit is pixels.
+      blocks:
+          List of blocks of text, images etc on this page.
+      confidence:
+          Confidence of the OCR results on the page. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Page)
+    ),
+)
+_sym_db.RegisterMessage(Page)
+
+Block = _reflection.GeneratedProtocolMessageType(
+    "Block",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BLOCK,
+        __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+        __doc__="""Logical element on the page.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the block.
+      bounding_box:
+          The bounding box for the block. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example:  -
+          when the text is horizontal it might look like:     ::
+          0----1        |    |        3----2  -  when it's rotated 180
+          degrees around the top-left corner it becomes:     ::
+          2----3        |    |        1----0  and the vertice order will
+          still be (0, 1, 2, 3).
+      paragraphs:
+          List of paragraphs in this block (if this blocks is of type
+          text).
+      block_type:
+          Detected block type (text, image etc) for this block.
+      confidence:
+          Confidence of the OCR results on the block. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Block)
+    ),
+)
+_sym_db.RegisterMessage(Block)
+
+Paragraph = _reflection.GeneratedProtocolMessageType(
+    "Paragraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAGRAPH,
+        __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+        __doc__="""Structural unit of text representing a number of words in certain order.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the paragraph.
+      bounding_box:
+          The bounding box for the paragraph. The vertices are in the
+          order of top-left, top-right, bottom-right, bottom-left. When
+          a rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      words:
+          List of words in this paragraph.
+      confidence:
+          Confidence of the OCR results for the paragraph. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Paragraph)
+    ),
+)
+_sym_db.RegisterMessage(Paragraph)
+
+Word = _reflection.GeneratedProtocolMessageType(
+    "Word",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORD,
+        __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+        __doc__="""A word representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the word.
+      bounding_box:
+          The bounding box for the word. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      symbols:
+          List of symbols in the word. The order of the symbols follows
+          the natural reading order.
+      confidence:
+          Confidence of the OCR results for the word. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Word)
+    ),
+)
+_sym_db.RegisterMessage(Word)
+
+Symbol = _reflection.GeneratedProtocolMessageType(
+    "Symbol",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYMBOL,
+        __module__="google.cloud.vision_v1p3beta1.proto.text_annotation_pb2",
+        __doc__="""A single symbol representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the symbol.
+      bounding_box:
+          The bounding box for the symbol. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      text:
+          The actual UTF-8 representation of the symbol.
+      confidence:
+          Confidence of the OCR results for the symbol. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.Symbol)
+    ),
+)
+_sym_db.RegisterMessage(Symbol)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/text_annotation_pb2_grpc.py b/vision/google/cloud/vision_v1p3beta1/proto/text_annotation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/text_annotation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/web_detection.proto b/vision/google/cloud/vision_v1p3beta1/proto/web_detection.proto
new file mode 100644
index 000000000000..cf9a22612a74
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/web_detection.proto
@@ -0,0 +1,104 @@
+// 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.cloud.vision.v1p3beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "WebDetectionProto";
+option java_package = "com.google.cloud.vision.v1p3beta1";
+
+// Relevant information for the image from the Internet.
+message WebDetection {
+  // Entity deduced from similar images on the Internet.
+  message WebEntity {
+    // Opaque entity ID.
+    string entity_id = 1;
+
+    // Overall relevancy score for the entity.
+    // Not normalized and not comparable across different image queries.
+    float score = 2;
+
+    // Canonical description of the entity, in English.
+    string description = 3;
+  }
+
+  // Metadata for online images.
+  message WebImage {
+    // The result image URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the image.
+    float score = 2;
+  }
+
+  // Metadata for web pages.
+  message WebPage {
+    // The result web page URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the web page.
+    float score = 2;
+
+    // Title for the web page, may contain HTML markups.
+    string page_title = 3;
+
+    // Fully matching images on the page.
+    // Can include resized copies of the query image.
+    repeated WebImage full_matching_images = 4;
+
+    // Partial matching images on the page.
+    // Those images are similar enough to share some key-point features. For
+    // example an original image will likely have partial matching for its
+    // crops.
+    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;
+
+  // Fully matching images from the Internet.
+  // Can include resized copies of the query image.
+  repeated WebImage full_matching_images = 2;
+
+  // Partial matching images from the Internet.
+  // Those images are similar enough to share some key-point features. For
+  // example an original image will likely have partial matching for its crops.
+  repeated WebImage partial_matching_images = 3;
+
+  // Web pages containing the matching images from the Internet.
+  repeated WebPage pages_with_matching_images = 4;
+
+  // The visually similar image results.
+  repeated WebImage visually_similar_images = 6;
+
+  // Best guess text labels for the request image.
+  repeated WebLabel best_guess_labels = 8;
+}
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/web_detection_pb2.py b/vision/google/cloud/vision_v1p3beta1/proto/web_detection_pb2.py
new file mode 100644
index 000000000000..b5d3fbac95fd
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/web_detection_pb2.py
@@ -0,0 +1,616 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p3beta1/proto/web_detection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p3beta1/proto/web_detection.proto",
+    package="google.cloud.vision.v1p3beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p3beta1B\021WebDetectionProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\370\001\001"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/vision_v1p3beta1/proto/web_detection.proto\x12\x1dgoogle.cloud.vision.v1p3beta1\x1a\x1cgoogle/api/annotations.proto"\x8c\x07\n\x0cWebDetection\x12K\n\x0cweb_entities\x18\x01 \x03(\x0b\x32\x35.google.cloud.vision.v1p3beta1.WebDetection.WebEntity\x12R\n\x14\x66ull_matching_images\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x03 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.WebDetection.WebImage\x12W\n\x1apages_with_matching_images\x18\x04 \x03(\x0b\x32\x33.google.cloud.vision.v1p3beta1.WebDetection.WebPage\x12U\n\x17visually_similar_images\x18\x06 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.WebDetection.WebImage\x12O\n\x11\x62\x65st_guess_labels\x18\x08 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.WebDetection.WebLabel\x1a\x42\n\tWebEntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x1a&\n\x08WebImage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x1a\xe4\x01\n\x07WebPage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x12\n\npage_title\x18\x03 \x01(\t\x12R\n\x14\x66ull_matching_images\x18\x04 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x05 \x03(\x0b\x32\x34.google.cloud.vision.v1p3beta1.WebDetection.WebImage\x1a\x30\n\x08WebLabel\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\tB\x80\x01\n!com.google.cloud.vision.v1p3beta1B\x11WebDetectionProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p3beta1;vision\xf8\x01\x01\x62\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_WEBDETECTION_WEBENTITY = _descriptor.Descriptor(
+    name="WebEntity",
+    full_name="google.cloud.vision.v1p3beta1.WebDetection.WebEntity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebEntity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebEntity.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebEntity.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=642,
+    serialized_end=708,
+)
+
+_WEBDETECTION_WEBIMAGE = _descriptor.Descriptor(
+    name="WebImage",
+    full_name="google.cloud.vision.v1p3beta1.WebDetection.WebImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebImage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebImage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=710,
+    serialized_end=748,
+)
+
+_WEBDETECTION_WEBPAGE = _descriptor.Descriptor(
+    name="WebPage",
+    full_name="google.cloud.vision.v1p3beta1.WebDetection.WebPage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebPage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebPage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_title",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebPage.page_title",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebPage.full_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebPage.partial_matching_images",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=751,
+    serialized_end=979,
+)
+
+_WEBDETECTION_WEBLABEL = _descriptor.Descriptor(
+    name="WebLabel",
+    full_name="google.cloud.vision.v1p3beta1.WebDetection.WebLabel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebLabel.label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.WebLabel.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=981,
+    serialized_end=1029,
+)
+
+_WEBDETECTION = _descriptor.Descriptor(
+    name="WebDetection",
+    full_name="google.cloud.vision.v1p3beta1.WebDetection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="web_entities",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.web_entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.full_matching_images",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.partial_matching_images",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages_with_matching_images",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.pages_with_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="visually_similar_images",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.visually_similar_images",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="best_guess_labels",
+            full_name="google.cloud.vision.v1p3beta1.WebDetection.best_guess_labels",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _WEBDETECTION_WEBENTITY,
+        _WEBDETECTION_WEBIMAGE,
+        _WEBDETECTION_WEBPAGE,
+        _WEBDETECTION_WEBLABEL,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=121,
+    serialized_end=1029,
+)
+
+_WEBDETECTION_WEBENTITY.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBIMAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBLABEL.containing_type = _WEBDETECTION
+_WEBDETECTION.fields_by_name["web_entities"].message_type = _WEBDETECTION_WEBENTITY
+_WEBDETECTION.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "pages_with_matching_images"
+].message_type = _WEBDETECTION_WEBPAGE
+_WEBDETECTION.fields_by_name[
+    "visually_similar_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name["best_guess_labels"].message_type = _WEBDETECTION_WEBLABEL
+DESCRIPTOR.message_types_by_name["WebDetection"] = _WEBDETECTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WebDetection = _reflection.GeneratedProtocolMessageType(
+    "WebDetection",
+    (_message.Message,),
+    dict(
+        WebEntity=_reflection.GeneratedProtocolMessageType(
+            "WebEntity",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBENTITY,
+                __module__="google.cloud.vision_v1p3beta1.proto.web_detection_pb2",
+                __doc__="""Entity deduced from similar images on the Internet.
+    
+    
+    Attributes:
+        entity_id:
+            Opaque entity ID.
+        score:
+            Overall relevancy score for the entity. Not normalized and not
+            comparable across different image queries.
+        description:
+            Canonical description of the entity, in English.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.WebDetection.WebEntity)
+            ),
+        ),
+        WebImage=_reflection.GeneratedProtocolMessageType(
+            "WebImage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBIMAGE,
+                __module__="google.cloud.vision_v1p3beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for online images.
+    
+    
+    Attributes:
+        url:
+            The result image URL.
+        score:
+            (Deprecated) Overall relevancy score for the image.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.WebDetection.WebImage)
+            ),
+        ),
+        WebPage=_reflection.GeneratedProtocolMessageType(
+            "WebPage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBPAGE,
+                __module__="google.cloud.vision_v1p3beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for web pages.
+    
+    
+    Attributes:
+        url:
+            The result web page URL.
+        score:
+            (Deprecated) Overall relevancy score for the web page.
+        page_title:
+            Title for the web page, may contain HTML markups.
+        full_matching_images:
+            Fully matching images on the page. Can include resized copies
+            of the query image.
+        partial_matching_images:
+            Partial matching images on the page. Those images are similar
+            enough to share some key-point features. For example an
+            original image will likely have partial matching for its
+            crops.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.WebDetection.WebPage)
+            ),
+        ),
+        WebLabel=_reflection.GeneratedProtocolMessageType(
+            "WebLabel",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBLABEL,
+                __module__="google.cloud.vision_v1p3beta1.proto.web_detection_pb2",
+                __doc__="""Label to provide extra metadata for the web detection.
+    
+    
+    Attributes:
+        label:
+            Label for extra metadata.
+        language_code:
+            The BCP-47 language code for ``label``, such as "en-US" or
+            "sr-Latn". For more information, see http://www.unicode.org/re
+            ports/tr35/#Unicode\_locale\_identifier.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.WebDetection.WebLabel)
+            ),
+        ),
+        DESCRIPTOR=_WEBDETECTION,
+        __module__="google.cloud.vision_v1p3beta1.proto.web_detection_pb2",
+        __doc__="""Relevant information for the image from the Internet.
+  
+  
+  Attributes:
+      web_entities:
+          Deduced entities from similar images on the Internet.
+      full_matching_images:
+          Fully matching images from the Internet. Can include resized
+          copies of the query image.
+      partial_matching_images:
+          Partial matching images from the Internet. Those images are
+          similar enough to share some key-point features. For example
+          an original image will likely have partial matching for its
+          crops.
+      pages_with_matching_images:
+          Web pages containing the matching images from the Internet.
+      visually_similar_images:
+          The visually similar image results.
+      best_guess_labels:
+          Best guess text labels for the request image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p3beta1.WebDetection)
+    ),
+)
+_sym_db.RegisterMessage(WebDetection)
+_sym_db.RegisterMessage(WebDetection.WebEntity)
+_sym_db.RegisterMessage(WebDetection.WebImage)
+_sym_db.RegisterMessage(WebDetection.WebPage)
+_sym_db.RegisterMessage(WebDetection.WebLabel)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p3beta1/proto/web_detection_pb2_grpc.py b/vision/google/cloud/vision_v1p3beta1/proto/web_detection_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/proto/web_detection_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p3beta1/types.py b/vision/google/cloud/vision_v1p3beta1/types.py
new file mode 100644
index 000000000000..c075adb06aa4
--- /dev/null
+++ b/vision/google/cloud/vision_v1p3beta1/types.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.vision_v1p3beta1.proto import geometry_pb2
+from google.cloud.vision_v1p3beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p3beta1.proto import product_search_pb2
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2
+from google.cloud.vision_v1p3beta1.proto import text_annotation_pb2
+from google.cloud.vision_v1p3beta1.proto import web_detection_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import color_pb2
+from google.type import latlng_pb2
+
+
+_shared_modules = [
+    operations_pb2,
+    any_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    color_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [
+    geometry_pb2,
+    image_annotator_pb2,
+    product_search_pb2,
+    product_search_service_pb2,
+    text_annotation_pb2,
+    web_detection_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.vision_v1p3beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/vision/google/cloud/vision_v1p4beta1/__init__.py b/vision/google/cloud/vision_v1p4beta1/__init__.py
new file mode 100644
index 000000000000..4c838743e09f
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/__init__.py
@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.vision_helpers.decorators import add_single_feature_methods
+from google.cloud.vision_helpers import VisionHelpers
+
+from google.cloud.vision_v1p4beta1 import types
+from google.cloud.vision_v1p4beta1.gapic import enums
+from google.cloud.vision_v1p4beta1.gapic import image_annotator_client as iac
+from google.cloud.vision_v1p4beta1.gapic import product_search_client
+
+
+class ProductSearchClient(product_search_client.ProductSearchClient):
+    __doc__ = product_search_client.ProductSearchClient.__doc__
+    enums = enums
+
+
+@add_single_feature_methods
+class ImageAnnotatorClient(VisionHelpers, iac.ImageAnnotatorClient):
+    __doc__ = iac.ImageAnnotatorClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "ProductSearchClient", "ImageAnnotatorClient")
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/__init__.py b/vision/google/cloud/vision_v1p4beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/enums.py b/vision/google/cloud/vision_v1p4beta1/gapic/enums.py
new file mode 100644
index 000000000000..59f1ccc8e81f
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/enums.py
@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Likelihood(enum.IntEnum):
+    """
+    A bucketized representation of likelihood, which is intended to give clients
+    highly stable results across model upgrades.
+
+    Attributes:
+      UNKNOWN (int): Unknown likelihood.
+      VERY_UNLIKELY (int): It is very unlikely that the image belongs to the specified vertical.
+      UNLIKELY (int): It is unlikely that the image belongs to the specified vertical.
+      POSSIBLE (int): It is possible that the image belongs to the specified vertical.
+      LIKELY (int): It is likely that the image belongs to the specified vertical.
+      VERY_LIKELY (int): It is very likely that the image belongs to the specified vertical.
+    """
+
+    UNKNOWN = 0
+    VERY_UNLIKELY = 1
+    UNLIKELY = 2
+    POSSIBLE = 3
+    LIKELY = 4
+    VERY_LIKELY = 5
+
+
+class BatchOperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Enumerates the possible states that the batch request can be in.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          PROCESSING (int): Request is actively being processed.
+          SUCCESSFUL (int): The request is done and at least one item has been successfully
+          processed.
+          FAILED (int): The request is done and no item has been successfully processed.
+          CANCELLED (int): The request is done after the longrunning.Operations.CancelOperation has
+          been called by the user.  Any records that were processed before the
+          cancel command are output as specified in the request.
+        """
+
+        STATE_UNSPECIFIED = 0
+        PROCESSING = 1
+        SUCCESSFUL = 2
+        FAILED = 3
+        CANCELLED = 4
+
+
+class Block(object):
+    class BlockType(enum.IntEnum):
+        """
+        Type of a block (text, image etc) as identified by OCR.
+
+        Attributes:
+          UNKNOWN (int): Unknown block type.
+          TEXT (int): Regular text block.
+          TABLE (int): Table block.
+          PICTURE (int): Image block.
+          RULER (int): Horizontal/vertical line box.
+          BARCODE (int): Barcode block.
+        """
+
+        UNKNOWN = 0
+        TEXT = 1
+        TABLE = 2
+        PICTURE = 3
+        RULER = 4
+        BARCODE = 5
+
+
+class FaceAnnotation(object):
+    class Landmark(object):
+        class Type(enum.IntEnum):
+            """
+            Face landmark (feature) type. Left and right are defined from the
+            vantage of the viewer of the image without considering mirror
+            projections typical of photos. So, ``LEFT_EYE``, typically, is the
+            person's right eye.
+
+            Attributes:
+              UNKNOWN_LANDMARK (int): Unknown face landmark detected. Should not be filled.
+              LEFT_EYE (int): Left eye.
+              RIGHT_EYE (int): Right eye.
+              LEFT_OF_LEFT_EYEBROW (int): Left of left eyebrow.
+              RIGHT_OF_LEFT_EYEBROW (int): Right of left eyebrow.
+              LEFT_OF_RIGHT_EYEBROW (int): Left of right eyebrow.
+              RIGHT_OF_RIGHT_EYEBROW (int): Right of right eyebrow.
+              MIDPOINT_BETWEEN_EYES (int): Midpoint between eyes.
+              NOSE_TIP (int): Nose tip.
+              UPPER_LIP (int): Upper lip.
+              LOWER_LIP (int): Lower lip.
+              MOUTH_LEFT (int): Mouth left.
+              MOUTH_RIGHT (int): Mouth right.
+              MOUTH_CENTER (int): Mouth center.
+              NOSE_BOTTOM_RIGHT (int): Nose, bottom right.
+              NOSE_BOTTOM_LEFT (int): Nose, bottom left.
+              NOSE_BOTTOM_CENTER (int): Nose, bottom center.
+              LEFT_EYE_TOP_BOUNDARY (int): Left eye, top boundary.
+              LEFT_EYE_RIGHT_CORNER (int): Left eye, right corner.
+              LEFT_EYE_BOTTOM_BOUNDARY (int): Left eye, bottom boundary.
+              LEFT_EYE_LEFT_CORNER (int): Left eye, left corner.
+              RIGHT_EYE_TOP_BOUNDARY (int): Right eye, top boundary.
+              RIGHT_EYE_RIGHT_CORNER (int): Right eye, right corner.
+              RIGHT_EYE_BOTTOM_BOUNDARY (int): Right eye, bottom boundary.
+              RIGHT_EYE_LEFT_CORNER (int): Right eye, left corner.
+              LEFT_EYEBROW_UPPER_MIDPOINT (int): Left eyebrow, upper midpoint.
+              RIGHT_EYEBROW_UPPER_MIDPOINT (int): Right eyebrow, upper midpoint.
+              LEFT_EAR_TRAGION (int): Left ear tragion.
+              RIGHT_EAR_TRAGION (int): Right ear tragion.
+              LEFT_EYE_PUPIL (int): Left eye pupil.
+              RIGHT_EYE_PUPIL (int): Right eye pupil.
+              FOREHEAD_GLABELLA (int): Forehead glabella.
+              CHIN_GNATHION (int): Chin gnathion.
+              CHIN_LEFT_GONION (int): Chin left gonion.
+              CHIN_RIGHT_GONION (int): Chin right gonion.
+            """
+
+            UNKNOWN_LANDMARK = 0
+            LEFT_EYE = 1
+            RIGHT_EYE = 2
+            LEFT_OF_LEFT_EYEBROW = 3
+            RIGHT_OF_LEFT_EYEBROW = 4
+            LEFT_OF_RIGHT_EYEBROW = 5
+            RIGHT_OF_RIGHT_EYEBROW = 6
+            MIDPOINT_BETWEEN_EYES = 7
+            NOSE_TIP = 8
+            UPPER_LIP = 9
+            LOWER_LIP = 10
+            MOUTH_LEFT = 11
+            MOUTH_RIGHT = 12
+            MOUTH_CENTER = 13
+            NOSE_BOTTOM_RIGHT = 14
+            NOSE_BOTTOM_LEFT = 15
+            NOSE_BOTTOM_CENTER = 16
+            LEFT_EYE_TOP_BOUNDARY = 17
+            LEFT_EYE_RIGHT_CORNER = 18
+            LEFT_EYE_BOTTOM_BOUNDARY = 19
+            LEFT_EYE_LEFT_CORNER = 20
+            RIGHT_EYE_TOP_BOUNDARY = 21
+            RIGHT_EYE_RIGHT_CORNER = 22
+            RIGHT_EYE_BOTTOM_BOUNDARY = 23
+            RIGHT_EYE_LEFT_CORNER = 24
+            LEFT_EYEBROW_UPPER_MIDPOINT = 25
+            RIGHT_EYEBROW_UPPER_MIDPOINT = 26
+            LEFT_EAR_TRAGION = 27
+            RIGHT_EAR_TRAGION = 28
+            LEFT_EYE_PUPIL = 29
+            RIGHT_EYE_PUPIL = 30
+            FOREHEAD_GLABELLA = 31
+            CHIN_GNATHION = 32
+            CHIN_LEFT_GONION = 33
+            CHIN_RIGHT_GONION = 34
+
+
+class Feature(object):
+    class Type(enum.IntEnum):
+        """
+        Type of Google Cloud Vision API feature to be extracted.
+
+        Attributes:
+          TYPE_UNSPECIFIED (int): Unspecified feature type.
+          FACE_DETECTION (int): Run face detection.
+          LANDMARK_DETECTION (int): Run landmark detection.
+          LOGO_DETECTION (int): Run logo detection.
+          LABEL_DETECTION (int): Run label detection.
+          TEXT_DETECTION (int): Run text detection / optical character recognition (OCR). Text detection
+          is optimized for areas of text within a larger image; if the image is a
+          document, use ``DOCUMENT_TEXT_DETECTION`` instead.
+          DOCUMENT_TEXT_DETECTION (int): Run dense text document OCR. Takes precedence when both
+          ``DOCUMENT_TEXT_DETECTION`` and ``TEXT_DETECTION`` are present.
+          SAFE_SEARCH_DETECTION (int): Run Safe Search to detect potentially unsafe
+          or undesirable content.
+          IMAGE_PROPERTIES (int): Compute a set of image properties, such as the
+          image's dominant colors.
+          CROP_HINTS (int): Run crop hints.
+          WEB_DETECTION (int): Run web detection.
+          PRODUCT_SEARCH (int): Run Product Search.
+          OBJECT_LOCALIZATION (int): Run localizer for object detection.
+        """
+
+        TYPE_UNSPECIFIED = 0
+        FACE_DETECTION = 1
+        LANDMARK_DETECTION = 2
+        LOGO_DETECTION = 3
+        LABEL_DETECTION = 4
+        TEXT_DETECTION = 5
+        DOCUMENT_TEXT_DETECTION = 11
+        SAFE_SEARCH_DETECTION = 6
+        IMAGE_PROPERTIES = 7
+        CROP_HINTS = 9
+        WEB_DETECTION = 10
+        PRODUCT_SEARCH = 12
+        OBJECT_LOCALIZATION = 19
+
+
+class OperationMetadata(object):
+    class State(enum.IntEnum):
+        """
+        Batch operation states.
+
+        Attributes:
+          STATE_UNSPECIFIED (int): Invalid.
+          CREATED (int): Request is received.
+          RUNNING (int): Request is actively being processed.
+          DONE (int): The batch processing is done.
+          CANCELLED (int): The batch processing was cancelled.
+        """
+
+        STATE_UNSPECIFIED = 0
+        CREATED = 1
+        RUNNING = 2
+        DONE = 3
+        CANCELLED = 4
+
+
+class TextAnnotation(object):
+    class DetectedBreak(object):
+        class BreakType(enum.IntEnum):
+            """
+            Enum to denote the type of break found. New line, space etc.
+
+            Attributes:
+              UNKNOWN (int): Unknown break label type.
+              SPACE (int): Regular space.
+              SURE_SPACE (int): Sure space (very wide).
+              EOL_SURE_SPACE (int): Line-wrapping break.
+              HYPHEN (int): End-line hyphen that is not present in text; does not co-occur with
+              ``SPACE``, ``LEADER_SPACE``, or ``LINE_BREAK``.
+              LINE_BREAK (int): Line break that ends a paragraph.
+            """
+
+            UNKNOWN = 0
+            SPACE = 1
+            SURE_SPACE = 2
+            EOL_SURE_SPACE = 3
+            HYPHEN = 4
+            LINE_BREAK = 5
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/image_annotator_client.py b/vision/google/cloud/vision_v1p4beta1/gapic/image_annotator_client.py
new file mode 100644
index 000000000000..bd176adf4a7c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/image_annotator_client.py
@@ -0,0 +1,497 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1p4beta1 ImageAnnotator API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import grpc
+
+from google.cloud.vision_v1p4beta1.gapic import enums
+from google.cloud.vision_v1p4beta1.gapic import image_annotator_client_config
+from google.cloud.vision_v1p4beta1.gapic.transports import (
+    image_annotator_grpc_transport,
+)
+from google.cloud.vision_v1p4beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p4beta1.proto import image_annotator_pb2_grpc
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ImageAnnotatorClient(object):
+    """
+    Service that performs Google Cloud Vision API detection tasks over client
+    images, such as face, landmark, logo, label, and text detection. The
+    ImageAnnotator service returns detected entities from the images.
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1p4beta1.ImageAnnotator"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ImageAnnotatorClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ImageAnnotatorGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ImageAnnotatorGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = image_annotator_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=image_annotator_grpc_transport.ImageAnnotatorGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = image_annotator_grpc_transport.ImageAnnotatorGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def batch_annotate_images(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run image detection and annotation for a batch of images.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_images(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p4beta1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.AnnotateImageRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.BatchAnnotateImagesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_images,
+                default_retry=self._method_configs["BatchAnnotateImages"].retry,
+                default_timeout=self._method_configs["BatchAnnotateImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateImagesRequest(requests=requests)
+        return self._inner_api_calls["batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def batch_annotate_files(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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 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.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.batch_annotate_files(requests)
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p4beta1.types.AnnotateFileRequest]]): The list of file annotation requests. Right now we support only one
+                AnnotateFileRequest in BatchAnnotateFilesRequest.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.AnnotateFileRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.BatchAnnotateFilesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "batch_annotate_files" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "batch_annotate_files"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.batch_annotate_files,
+                default_retry=self._method_configs["BatchAnnotateFiles"].retry,
+                default_timeout=self._method_configs["BatchAnnotateFiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.BatchAnnotateFilesRequest(requests=requests)
+        return self._inner_api_calls["batch_annotate_files"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def async_batch_annotate_images(
+        self,
+        requests,
+        output_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run asynchronous image detection and annotation for a list of images.
+
+        Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateImagesResponse`` (results).
+
+        This service will write image annotation outputs to json files in
+        customer GCS bucket, each json file containing
+        BatchAnnotateImagesResponse proto.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> # TODO: Initialize `output_config`:
+            >>> output_config = {}
+            >>>
+            >>> response = client.async_batch_annotate_images(requests, output_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p4beta1.types.AnnotateImageRequest]]): Individual image annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.AnnotateImageRequest`
+            output_config (Union[dict, ~google.cloud.vision_v1p4beta1.types.OutputConfig]): Required. The desired output location and metadata (e.g. format).
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.OutputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "async_batch_annotate_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "async_batch_annotate_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.async_batch_annotate_images,
+                default_retry=self._method_configs["AsyncBatchAnnotateImages"].retry,
+                default_timeout=self._method_configs[
+                    "AsyncBatchAnnotateImages"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.AsyncBatchAnnotateImagesRequest(
+            requests=requests, output_config=output_config
+        )
+        operation = self._inner_api_calls["async_batch_annotate_images"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            image_annotator_pb2.AsyncBatchAnnotateImagesResponse,
+            metadata_type=image_annotator_pb2.OperationMetadata,
+        )
+
+    def async_batch_annotate_files(
+        self,
+        requests,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Run asynchronous image detection and annotation for a list of generic
+        files, such as PDF files, which may contain multiple pages and multiple
+        images per page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ImageAnnotatorClient()
+            >>>
+            >>> # TODO: Initialize `requests`:
+            >>> requests = []
+            >>>
+            >>> response = client.async_batch_annotate_files(requests)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            requests (list[Union[dict, ~google.cloud.vision_v1p4beta1.types.AsyncAnnotateFileRequest]]): Individual async file annotation requests for this batch.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.AsyncAnnotateFileRequest`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "async_batch_annotate_files" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "async_batch_annotate_files"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.async_batch_annotate_files,
+                default_retry=self._method_configs["AsyncBatchAnnotateFiles"].retry,
+                default_timeout=self._method_configs["AsyncBatchAnnotateFiles"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(requests=requests)
+        operation = self._inner_api_calls["async_batch_annotate_files"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            image_annotator_pb2.AsyncBatchAnnotateFilesResponse,
+            metadata_type=image_annotator_pb2.OperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/image_annotator_client_config.py b/vision/google/cloud/vision_v1p4beta1/gapic/image_annotator_client_config.py
new file mode 100644
index 000000000000..18493e802ad2
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/image_annotator_client_config.py
@@ -0,0 +1,43 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1p4beta1.ImageAnnotator": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 60000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "BatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "BatchAnnotateFiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "AsyncBatchAnnotateImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "AsyncBatchAnnotateFiles": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/product_search_client.py b/vision/google/cloud/vision_v1p4beta1/gapic/product_search_client.py
new file mode 100644
index 000000000000..f9543abd2de5
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/product_search_client.py
@@ -0,0 +1,1921 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.vision.v1p4beta1 ProductSearch API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.operation
+from google.api_core import operations_v1
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.vision_v1p4beta1.gapic import enums
+from google.cloud.vision_v1p4beta1.gapic import product_search_client_config
+from google.cloud.vision_v1p4beta1.gapic.transports import product_search_grpc_transport
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2_grpc
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-vision").version
+
+
+class ProductSearchClient(object):
+    """
+    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`` 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`` resources, named
+       ``projects/*/locations/*/products/*``
+
+    -  Each ``Product`` has a collection of ``ReferenceImage`` resources,
+       named ``projects/*/locations/*/products/*/referenceImages/*``
+    """
+
+    SERVICE_ADDRESS = "vision.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.vision.v1p4beta1.ProductSearch"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            ProductSearchClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}",
+            project=project,
+            location=location,
+        )
+
+    @classmethod
+    def product_path(cls, project, location, product):
+        """Return a fully-qualified product string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/products/{product}",
+            project=project,
+            location=location,
+            product=product,
+        )
+
+    @classmethod
+    def product_set_path(cls, project, location, product_set):
+        """Return a fully-qualified product_set string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/productSets/{product_set}",
+            project=project,
+            location=location,
+            product_set=product_set,
+        )
+
+    @classmethod
+    def reference_image_path(cls, project, location, product, reference_image):
+        """Return a fully-qualified reference_image string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}",
+            project=project,
+            location=location,
+            product=product,
+            reference_image=reference_image,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.ProductSearchGrpcTransport,
+                    Callable[[~.Credentials, type], ~.ProductSearchGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = product_search_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=product_search_grpc_transport.ProductSearchGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = product_search_grpc_transport.ProductSearchGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_product_set(
+        self,
+        parent,
+        product_set,
+        product_set_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new ProductSet resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing, or is longer
+           than 4096 characters.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `product_set`:
+            >>> product_set = {}
+            >>>
+            >>> # TODO: Initialize `product_set_id`:
+            >>> product_set_id = ''
+            >>>
+            >>> response = client.create_product_set(parent, product_set, product_set_id)
+
+        Args:
+            parent (str): The project in which the ProductSet should be created.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product_set (Union[dict, ~google.cloud.vision_v1p4beta1.types.ProductSet]): The ProductSet to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.ProductSet`
+            product_set_id (str): 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 error is returned with code ALREADY\_EXISTS. Must be at most 128
+                characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_product_set,
+                default_retry=self._method_configs["CreateProductSet"].retry,
+                default_timeout=self._method_configs["CreateProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateProductSetRequest(
+            parent=parent, product_set=product_set, product_set_id=product_set_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_product_sets(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ProductSets in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100, or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_product_sets(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_product_sets(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project from which ProductSets should be listed.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p4beta1.types.ProductSet` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_product_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_product_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_product_sets,
+                default_retry=self._method_configs["ListProductSets"].retry,
+                default_timeout=self._method_configs["ListProductSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductSetsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_product_sets"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="product_sets",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_product_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> response = client.get_product_set(name)
+
+        Args:
+            name (str): Resource name of the ProductSet to get.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_product_set,
+                default_retry=self._method_configs["GetProductSet"].retry,
+                default_timeout=self._method_configs["GetProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetProductSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_product_set(
+        self,
+        product_set,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Makes changes to a ProductSet resource. Only display\_name can be
+        updated currently.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but missing from the request or longer than 4096 characters.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> # TODO: Initialize `product_set`:
+            >>> product_set = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_product_set(product_set, update_mask)
+
+        Args:
+            product_set (Union[dict, ~google.cloud.vision_v1p4beta1.types.ProductSet]): The ProductSet resource which replaces the one on the server.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.ProductSet`
+            update_mask (Union[dict, ~google.cloud.vision_v1p4beta1.types.FieldMask]): The ``FieldMask`` that specifies which fields to update. If update\_mask
+                isn't specified, all mutable fields are to be updated. Valid mask path
+                is ``display_name``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.ProductSet` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_product_set,
+                default_retry=self._method_configs["UpdateProductSet"].retry,
+                default_timeout=self._method_configs["UpdateProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.UpdateProductSetRequest(
+            product_set=product_set, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("product_set.name", product_set.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_product_set(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> client.delete_product_set(name)
+
+        Args:
+            name (str): Resource name of the ProductSet to delete.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_product_set,
+                default_retry=self._method_configs["DeleteProductSet"].retry,
+                default_timeout=self._method_configs["DeleteProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteProductSetRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_product(
+        self,
+        parent,
+        product,
+        product_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new product resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is longer than 4096
+           characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is missing or invalid.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = {}
+            >>>
+            >>> # TODO: Initialize `product_id`:
+            >>> product_id = ''
+            >>>
+            >>> response = client.create_product(parent, product, product_id)
+
+        Args:
+            parent (str): The project in which the Product should be created.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            product (Union[dict, ~google.cloud.vision_v1p4beta1.types.Product]): The product to create.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.Product`
+            product_id (str): 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 error is returned with code ALREADY\_EXISTS. Must be at most 128
+                characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_product,
+                default_retry=self._method_configs["CreateProduct"].retry,
+                default_timeout=self._method_configs["CreateProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateProductRequest(
+            parent=parent, product=product, product_id=product_id
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_products(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists products in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_products(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_products(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): The project OR ProductSet from which Products should be listed.
+
+                Format: ``projects/PROJECT_ID/locations/LOC_ID``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p4beta1.types.Product` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_products" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_products"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_products,
+                default_retry=self._method_configs["ListProducts"].retry,
+                default_timeout=self._method_configs["ListProducts"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_products"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="products",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_product(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a Product.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> response = client.get_product(name)
+
+        Args:
+            name (str): Resource name of the Product to get.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_product,
+                default_retry=self._method_configs["GetProduct"].retry,
+                default_timeout=self._method_configs["GetProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetProductRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def update_product(
+        self,
+        product,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Makes changes to a Product resource. Only the ``display_name``,
+        ``description``, and ``labels`` fields can be updated right now.
+
+        If labels are updated, the change will not be reflected in queries until
+        the next index time.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but is missing from the request or longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is present in update\_mask
+           but is longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is present in
+           update\_mask.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_product(product, update_mask)
+
+        Args:
+            product (Union[dict, ~google.cloud.vision_v1p4beta1.types.Product]): The Product resource which replaces the one on the server.
+                product.name is immutable.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.Product`
+            update_mask (Union[dict, ~google.cloud.vision_v1p4beta1.types.FieldMask]): The ``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 ``description``.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.Product` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_product,
+                default_retry=self._method_configs["UpdateProduct"].retry,
+                default_timeout=self._method_configs["UpdateProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.UpdateProductRequest(
+            product=product, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("product.name", product.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_product(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a product and its reference images.
+
+        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.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> client.delete_product(name)
+
+        Args:
+            name (str): Resource name of product to delete.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_product" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_product"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_product,
+                default_retry=self._method_configs["DeleteProduct"].retry,
+                default_timeout=self._method_configs["DeleteProduct"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteProductRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_product"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def create_reference_image(
+        self,
+        parent,
+        reference_image,
+        reference_image_id,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates and returns a new ReferenceImage resource.
+
+        The ``bounding_poly`` field is optional. If ``bounding_poly`` is not
+        specified, the system will try to detect regions of interest in the
+        image that are compatible with the product\_category on the parent
+        product. If it is specified, detection is ALWAYS skipped. The system
+        converts polygons into non-rotated rectangles.
+
+        Note that the pipeline will resize the image if the image resolution is
+        too large to process (above 50MP).
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if the image\_uri is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if the product does not exist.
+        -  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.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> # TODO: Initialize `reference_image`:
+            >>> reference_image = {}
+            >>>
+            >>> # TODO: Initialize `reference_image_id`:
+            >>> reference_image_id = ''
+            >>>
+            >>> response = client.create_reference_image(parent, reference_image, reference_image_id)
+
+        Args:
+            parent (str): Resource name of the product in which to create the reference image.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+            reference_image (Union[dict, ~google.cloud.vision_v1p4beta1.types.ReferenceImage]): The reference image to create.
+                If an image ID is specified, it is ignored.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.ReferenceImage`
+            reference_image_id (str): 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
+                already in use, an error is returned with code ALREADY\_EXISTS. Must be
+                at most 128 characters long. It cannot contain the character ``/``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.ReferenceImage` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_reference_image,
+                default_retry=self._method_configs["CreateReferenceImage"].retry,
+                default_timeout=self._method_configs["CreateReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.CreateReferenceImageRequest(
+            parent=parent,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_reference_image(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Permanently deletes a reference image.
+
+        The image metadata will be deleted right away, but search queries
+        against ProductSets containing the image may still work until all
+        related 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.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.reference_image_path('[PROJECT]', '[LOCATION]', '[PRODUCT]', '[REFERENCE_IMAGE]')
+            >>>
+            >>> client.delete_reference_image(name)
+
+        Args:
+            name (str): The resource name of the reference image to delete.
+
+                Format is:
+
+                ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_reference_image,
+                default_retry=self._method_configs["DeleteReferenceImage"].retry,
+                default_timeout=self._method_configs["DeleteReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.DeleteReferenceImageRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_reference_images(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists reference images.
+
+        Possible errors:
+
+        -  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.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.product_path('[PROJECT]', '[LOCATION]', '[PRODUCT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_reference_images(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_reference_images(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Resource name of the product containing the reference images.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p4beta1.types.ReferenceImage` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_reference_images" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_reference_images"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_reference_images,
+                default_retry=self._method_configs["ListReferenceImages"].retry,
+                default_timeout=self._method_configs["ListReferenceImages"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListReferenceImagesRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_reference_images"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="reference_images",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_reference_image(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets information associated with a ReferenceImage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the specified image does not exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.reference_image_path('[PROJECT]', '[LOCATION]', '[PRODUCT]', '[REFERENCE_IMAGE]')
+            >>>
+            >>> response = client.get_reference_image(name)
+
+        Args:
+            name (str): The resource name of the ReferenceImage to get.
+
+                Format is:
+
+                ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID``.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types.ReferenceImage` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_reference_image" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_reference_image"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_reference_image,
+                default_retry=self._method_configs["GetReferenceImage"].retry,
+                default_timeout=self._method_configs["GetReferenceImage"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.GetReferenceImageRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_reference_image"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def add_product_to_product_set(
+        self,
+        name,
+        product,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Adds a Product to the specified ProductSet. If the Product is already
+        present, no change is made.
+
+        One Product can be added to at most 100 ProductSets.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product or the ProductSet doesn't exist.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = ''
+            >>>
+            >>> client.add_product_to_product_set(name, product)
+
+        Args:
+            name (str): The resource name for the ProductSet to modify.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            product (str): The resource name for the Product to be added to this ProductSet.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "add_product_to_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "add_product_to_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.add_product_to_product_set,
+                default_retry=self._method_configs["AddProductToProductSet"].retry,
+                default_timeout=self._method_configs["AddProductToProductSet"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.AddProductToProductSetRequest(
+            name=name, product=product
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["add_product_to_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def remove_product_from_product_set(
+        self,
+        name,
+        product,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Removes a Product from the specified ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND If the Product is not found under the ProductSet.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # TODO: Initialize `product`:
+            >>> product = ''
+            >>>
+            >>> client.remove_product_from_product_set(name, product)
+
+        Args:
+            name (str): The resource name for the ProductSet to modify.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            product (str): The resource name for the Product to be removed from this ProductSet.
+
+                Format is: ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "remove_product_from_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "remove_product_from_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.remove_product_from_product_set,
+                default_retry=self._method_configs["RemoveProductFromProductSet"].retry,
+                default_timeout=self._method_configs[
+                    "RemoveProductFromProductSet"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.RemoveProductFromProductSetRequest(
+            name=name, product=product
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["remove_product_from_product_set"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_products_in_product_set(
+        self,
+        name,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists the Products in a ProductSet, in an unspecified order. If the
+        ProductSet does not exist, the products field of the response will be
+        empty.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> name = client.product_set_path('[PROJECT]', '[LOCATION]', '[PRODUCT_SET]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_products_in_product_set(name):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_products_in_product_set(name).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            name (str): The ProductSet resource for which to retrieve Products.
+
+                Format is:
+                ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.vision_v1p4beta1.types.Product` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_products_in_product_set" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_products_in_product_set"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_products_in_product_set,
+                default_retry=self._method_configs["ListProductsInProductSet"].retry,
+                default_timeout=self._method_configs[
+                    "ListProductsInProductSet"
+                ].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ListProductsInProductSetRequest(
+            name=name, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_products_in_product_set"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="products",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def import_product_sets(
+        self,
+        parent,
+        input_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Asynchronous API that imports a list of reference images to specified
+        product sets based on a list of image information.
+
+        The ``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``.
+
+        Example:
+            >>> from google.cloud import vision_v1p4beta1
+            >>>
+            >>> client = vision_v1p4beta1.ProductSearchClient()
+            >>>
+            >>> parent = client.location_path('[PROJECT]', '[LOCATION]')
+            >>>
+            >>> # TODO: Initialize `input_config`:
+            >>> input_config = {}
+            >>>
+            >>> response = client.import_product_sets(parent, input_config)
+            >>>
+            >>> def callback(operation_future):
+            ...     # Handle result.
+            ...     result = operation_future.result()
+            >>>
+            >>> response.add_done_callback(callback)
+            >>>
+            >>> # Handle metadata.
+            >>> metadata = response.metadata()
+
+        Args:
+            parent (str): The project in which the ProductSets should be imported.
+
+                Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+            input_config (Union[dict, ~google.cloud.vision_v1p4beta1.types.ImportProductSetsInputConfig]): The input content for the list of requests.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.vision_v1p4beta1.types.ImportProductSetsInputConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.vision_v1p4beta1.types._OperationFuture` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "import_product_sets" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "import_product_sets"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.import_product_sets,
+                default_retry=self._method_configs["ImportProductSets"].retry,
+                default_timeout=self._method_configs["ImportProductSets"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = product_search_service_pb2.ImportProductSetsRequest(
+            parent=parent, input_config=input_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        operation = self._inner_api_calls["import_product_sets"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+        return google.api_core.operation.from_gapic(
+            operation,
+            self.transport._operations_client,
+            product_search_service_pb2.ImportProductSetsResponse,
+            metadata_type=product_search_service_pb2.BatchOperationMetadata,
+        )
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/product_search_client_config.py b/vision/google/cloud/vision_v1p4beta1/gapic/product_search_client_config.py
new file mode 100644
index 000000000000..97a89304553b
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/product_search_client_config.py
@@ -0,0 +1,113 @@
+config = {
+    "interfaces": {
+        "google.cloud.vision.v1p4beta1.ProductSearch": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProductSets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProducts": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteProduct": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "CreateReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListReferenceImages": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetReferenceImage": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "AddProductToProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "RemoveProductFromProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListProductsInProductSet": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ImportProductSets": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/transports/__init__.py b/vision/google/cloud/vision_v1p4beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/transports/image_annotator_grpc_transport.py b/vision/google/cloud/vision_v1p4beta1/gapic/transports/image_annotator_grpc_transport.py
new file mode 100644
index 000000000000..7d832e49eda1
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/transports/image_annotator_grpc_transport.py
@@ -0,0 +1,191 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1p4beta1.proto import image_annotator_pb2_grpc
+
+
+class ImageAnnotatorGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1p4beta1 ImageAnnotator API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "image_annotator_stub": image_annotator_pb2_grpc.ImageAnnotatorStub(channel)
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_images`.
+
+        Run image detection and annotation for a batch of images.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateImages
+
+    @property
+    def batch_annotate_files(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.batch_annotate_files`.
+
+        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 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].BatchAnnotateFiles
+
+    @property
+    def async_batch_annotate_images(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.async_batch_annotate_images`.
+
+        Run asynchronous image detection and annotation for a list of images.
+
+        Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateImagesResponse`` (results).
+
+        This service will write image annotation outputs to json files in
+        customer GCS bucket, each json file containing
+        BatchAnnotateImagesResponse proto.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].AsyncBatchAnnotateImages
+
+    @property
+    def async_batch_annotate_files(self):
+        """Return the gRPC stub for :meth:`ImageAnnotatorClient.async_batch_annotate_files`.
+
+        Run asynchronous image detection and annotation for a list of generic
+        files, such as PDF files, which may contain multiple pages and multiple
+        images per page. Progress and results can be retrieved through the
+        ``google.longrunning.Operations`` interface. ``Operation.metadata``
+        contains ``OperationMetadata`` (metadata). ``Operation.response``
+        contains ``AsyncBatchAnnotateFilesResponse`` (results).
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["image_annotator_stub"].AsyncBatchAnnotateFiles
diff --git a/vision/google/cloud/vision_v1p4beta1/gapic/transports/product_search_grpc_transport.py b/vision/google/cloud/vision_v1p4beta1/gapic/transports/product_search_grpc_transport.py
new file mode 100644
index 000000000000..cd645bf50e0c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/gapic/transports/product_search_grpc_transport.py
@@ -0,0 +1,490 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+from google.api_core import operations_v1
+
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2_grpc
+
+
+class ProductSearchGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.vision.v1p4beta1 ProductSearch API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        "https://www.googleapis.com/auth/cloud-platform",
+        "https://www.googleapis.com/auth/cloud-vision",
+    )
+
+    def __init__(
+        self, channel=None, credentials=None, address="vision.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "product_search_stub": product_search_service_pb2_grpc.ProductSearchStub(
+                channel
+            )
+        }
+
+        # Because this API includes a method that returns a
+        # long-running operation (proto: google.longrunning.Operation),
+        # instantiate an LRO client.
+        self._operations_client = google.api_core.operations_v1.OperationsClient(
+            channel
+        )
+
+    @classmethod
+    def create_channel(
+        cls, address="vision.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_product_set`.
+
+        Creates and returns a new ProductSet resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing, or is longer
+           than 4096 characters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateProductSet
+
+    @property
+    def list_product_sets(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_product_sets`.
+
+        Lists ProductSets in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100, or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProductSets
+
+    @property
+    def get_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_product_set`.
+
+        Gets information associated with a ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetProductSet
+
+    @property
+    def update_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.update_product_set`.
+
+        Makes changes to a ProductSet resource. Only display\_name can be
+        updated currently.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the ProductSet does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but missing from the request or longer than 4096 characters.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].UpdateProductSet
+
+    @property
+    def delete_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_product_set`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteProductSet
+
+    @property
+    def create_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_product`.
+
+        Creates and returns a new product resource.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if display\_name is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is longer than 4096
+           characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is missing or invalid.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateProduct
+
+    @property
+    def list_products(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_products`.
+
+        Lists products in an unspecified order.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProducts
+
+    @property
+    def get_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_product`.
+
+        Gets information associated with a Product.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetProduct
+
+    @property
+    def update_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.update_product`.
+
+        Makes changes to a Product resource. Only the ``display_name``,
+        ``description``, and ``labels`` fields can be updated right now.
+
+        If labels are updated, the change will not be reflected in queries until
+        the next index time.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product does not exist.
+        -  Returns INVALID\_ARGUMENT if display\_name is present in update\_mask
+           but is missing from the request or longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if description is present in update\_mask
+           but is longer than 4096 characters.
+        -  Returns INVALID\_ARGUMENT if product\_category is present in
+           update\_mask.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].UpdateProduct
+
+    @property
+    def delete_product(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_product`.
+
+        Permanently deletes a product and its reference images.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteProduct
+
+    @property
+    def create_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.create_reference_image`.
+
+        Creates and returns a new ReferenceImage resource.
+
+        The ``bounding_poly`` field is optional. If ``bounding_poly`` is not
+        specified, the system will try to detect regions of interest in the
+        image that are compatible with the product\_category on the parent
+        product. If it is specified, detection is ALWAYS skipped. The system
+        converts polygons into non-rotated rectangles.
+
+        Note that the pipeline will resize the image if the image resolution is
+        too large to process (above 50MP).
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if the image\_uri is missing or longer than
+           4096 characters.
+        -  Returns INVALID\_ARGUMENT if the product does not exist.
+        -  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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].CreateReferenceImage
+
+    @property
+    def delete_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.delete_reference_image`.
+
+        Permanently deletes a reference image.
+
+        The image metadata will be deleted right away, but search queries
+        against ProductSets containing the image may still work until all
+        related 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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].DeleteReferenceImage
+
+    @property
+    def list_reference_images(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_reference_images`.
+
+        Lists reference images.
+
+        Possible errors:
+
+        -  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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListReferenceImages
+
+    @property
+    def get_reference_image(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.get_reference_image`.
+
+        Gets information associated with a ReferenceImage.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the specified image does not exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].GetReferenceImage
+
+    @property
+    def add_product_to_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.add_product_to_product_set`.
+
+        Adds a Product to the specified ProductSet. If the Product is already
+        present, no change is made.
+
+        One Product can be added to at most 100 ProductSets.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND if the Product or the ProductSet doesn't exist.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].AddProductToProductSet
+
+    @property
+    def remove_product_from_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.remove_product_from_product_set`.
+
+        Removes a Product from the specified ProductSet.
+
+        Possible errors:
+
+        -  Returns NOT\_FOUND If the Product is not found under the ProductSet.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].RemoveProductFromProductSet
+
+    @property
+    def list_products_in_product_set(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.list_products_in_product_set`.
+
+        Lists the Products in a ProductSet, in an unspecified order. If the
+        ProductSet does not exist, the products field of the response will be
+        empty.
+
+        Possible errors:
+
+        -  Returns INVALID\_ARGUMENT if page\_size is greater than 100 or less
+           than 1.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ListProductsInProductSet
+
+    @property
+    def import_product_sets(self):
+        """Return the gRPC stub for :meth:`ProductSearchClient.import_product_sets`.
+
+        Asynchronous API that imports a list of reference images to specified
+        product sets based on a list of image information.
+
+        The ``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``.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["product_search_stub"].ImportProductSets
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/__init__.py b/vision/google/cloud/vision_v1p4beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/geometry.proto b/vision/google/cloud/vision_v1p4beta1/proto/geometry.proto
new file mode 100644
index 000000000000..b0abd329c026
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/geometry.proto
@@ -0,0 +1,71 @@
+// 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.cloud.vision.v1p4beta1;
+
+import "google/api/annotations.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 = "GeometryProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+option objc_class_prefix = "GCVN";
+
+// 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;
+}
+
+// A 3D position in the image, used primarily for Face detection landmarks.
+// A valid Position must have both x and y coordinates.
+// The position coordinates are in the same scale as the original image.
+message Position {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+
+  // Z coordinate (or depth).
+  float z = 3;
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/geometry_pb2.py b/vision/google/cloud/vision_v1p4beta1/proto/geometry_pb2.py
new file mode 100644
index 000000000000..ca52470e9704
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/geometry_pb2.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p4beta1/proto/geometry.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p4beta1/proto/geometry.proto",
+    package="google.cloud.vision.v1p4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p4beta1B\rGeometryProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n2google/cloud/vision_v1p4beta1/proto/geometry.proto\x12\x1dgoogle.cloud.vision.v1p4beta1\x1a\x1cgoogle/api/annotations.proto"\x1e\n\x06Vertex\x12\t\n\x01x\x18\x01 \x01(\x05\x12\t\n\x01y\x18\x02 \x01(\x05"(\n\x10NormalizedVertex\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02"\x95\x01\n\x0c\x42oundingPoly\x12\x37\n\x08vertices\x18\x01 \x03(\x0b\x32%.google.cloud.vision.v1p4beta1.Vertex\x12L\n\x13normalized_vertices\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p4beta1.NormalizedVertex"+\n\x08Position\x12\t\n\x01x\x18\x01 \x01(\x02\x12\t\n\x01y\x18\x02 \x01(\x02\x12\t\n\x01z\x18\x03 \x01(\x02\x42\x83\x01\n!com.google.cloud.vision.v1p4beta1B\rGeometryProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_VERTEX = _descriptor.Descriptor(
+    name="Vertex",
+    full_name="google.cloud.vision.v1p4beta1.Vertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p4beta1.Vertex.x",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p4beta1.Vertex.y",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=115,
+    serialized_end=145,
+)
+
+
+_NORMALIZEDVERTEX = _descriptor.Descriptor(
+    name="NormalizedVertex",
+    full_name="google.cloud.vision.v1p4beta1.NormalizedVertex",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p4beta1.NormalizedVertex.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p4beta1.NormalizedVertex.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=147,
+    serialized_end=187,
+)
+
+
+_BOUNDINGPOLY = _descriptor.Descriptor(
+    name="BoundingPoly",
+    full_name="google.cloud.vision.v1p4beta1.BoundingPoly",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="vertices",
+            full_name="google.cloud.vision.v1p4beta1.BoundingPoly.vertices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="normalized_vertices",
+            full_name="google.cloud.vision.v1p4beta1.BoundingPoly.normalized_vertices",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=190,
+    serialized_end=339,
+)
+
+
+_POSITION = _descriptor.Descriptor(
+    name="Position",
+    full_name="google.cloud.vision.v1p4beta1.Position",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="x",
+            full_name="google.cloud.vision.v1p4beta1.Position.x",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="y",
+            full_name="google.cloud.vision.v1p4beta1.Position.y",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="z",
+            full_name="google.cloud.vision.v1p4beta1.Position.z",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=341,
+    serialized_end=384,
+)
+
+_BOUNDINGPOLY.fields_by_name["vertices"].message_type = _VERTEX
+_BOUNDINGPOLY.fields_by_name["normalized_vertices"].message_type = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["Vertex"] = _VERTEX
+DESCRIPTOR.message_types_by_name["NormalizedVertex"] = _NORMALIZEDVERTEX
+DESCRIPTOR.message_types_by_name["BoundingPoly"] = _BOUNDINGPOLY
+DESCRIPTOR.message_types_by_name["Position"] = _POSITION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Vertex = _reflection.GeneratedProtocolMessageType(
+    "Vertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VERTEX,
+        __module__="google.cloud.vision_v1p4beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Vertex)
+    ),
+)
+_sym_db.RegisterMessage(Vertex)
+
+NormalizedVertex = _reflection.GeneratedProtocolMessageType(
+    "NormalizedVertex",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_NORMALIZEDVERTEX,
+        __module__="google.cloud.vision_v1p4beta1.proto.geometry_pb2",
+        __doc__="""X coordinate.
+  
+  
+  Attributes:
+      y:
+          Y coordinate.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.NormalizedVertex)
+    ),
+)
+_sym_db.RegisterMessage(NormalizedVertex)
+
+BoundingPoly = _reflection.GeneratedProtocolMessageType(
+    "BoundingPoly",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BOUNDINGPOLY,
+        __module__="google.cloud.vision_v1p4beta1.proto.geometry_pb2",
+        __doc__="""A bounding polygon for the detected image annotation.
+  
+  
+  Attributes:
+      vertices:
+          The bounding polygon vertices.
+      normalized_vertices:
+          The bounding polygon normalized vertices.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.BoundingPoly)
+    ),
+)
+_sym_db.RegisterMessage(BoundingPoly)
+
+Position = _reflection.GeneratedProtocolMessageType(
+    "Position",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_POSITION,
+        __module__="google.cloud.vision_v1p4beta1.proto.geometry_pb2",
+        __doc__="""A 3D position in the image, used primarily for Face detection landmarks.
+  A valid Position must have both x and y coordinates. The position
+  coordinates are in the same scale as the original image.
+  
+  
+  Attributes:
+      x:
+          X coordinate.
+      y:
+          Y coordinate.
+      z:
+          Z coordinate (or depth).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Position)
+    ),
+)
+_sym_db.RegisterMessage(Position)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/geometry_pb2_grpc.py b/vision/google/cloud/vision_v1p4beta1/proto/geometry_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/geometry_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/image_annotator.proto b/vision/google/cloud/vision_v1p4beta1/proto/image_annotator.proto
new file mode 100644
index 000000000000..30318044a676
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/image_annotator.proto
@@ -0,0 +1,906 @@
+// 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.cloud.vision.v1p4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p4beta1/geometry.proto";
+import "google/cloud/vision/v1p4beta1/product_search.proto";
+import "google/cloud/vision/v1p4beta1/text_annotation.proto";
+import "google/cloud/vision/v1p4beta1/web_detection.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+import "google/type/latlng.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 = "ImageAnnotatorProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+option objc_class_prefix = "GCVN";
+
+// Service that performs Google Cloud Vision API detection tasks over client
+// images, such as face, landmark, logo, label, and text detection. The
+// ImageAnnotator service returns detected entities from the images.
+service ImageAnnotator {
+  // Run image detection and annotation for a batch of images.
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
+      returns (BatchAnnotateImagesResponse) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/images:annotate"
+      body: "*"
+    };
+  }
+
+  // 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 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: "*"
+    };
+  }
+
+  // Run asynchronous image detection and annotation for a list of images.
+  //
+  // Progress and results can be retrieved through the
+  // `google.longrunning.Operations` interface.
+  // `Operation.metadata` contains `OperationMetadata` (metadata).
+  // `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+  //
+  // 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) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/images:asyncBatchAnnotate"
+      body: "*"
+    };
+  }
+
+  // Run asynchronous image detection and annotation for a list of generic
+  // files, such as PDF files, which may contain multiple pages and multiple
+  // images per page. Progress and results can be retrieved through the
+  // `google.longrunning.Operations` interface.
+  // `Operation.metadata` contains `OperationMetadata` (metadata).
+  // `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/files:asyncBatchAnnotate"
+      body: "*"
+    };
+  }
+}
+
+// The type of Google Cloud Vision API detection to perform, and the maximum
+// number of results to return for that type. Multiple `Feature` objects can
+// be specified in the `features` list.
+message Feature {
+  // Type of Google Cloud Vision API feature to be extracted.
+  enum Type {
+    // Unspecified feature type.
+    TYPE_UNSPECIFIED = 0;
+
+    // Run face detection.
+    FACE_DETECTION = 1;
+
+    // Run landmark detection.
+    LANDMARK_DETECTION = 2;
+
+    // Run logo detection.
+    LOGO_DETECTION = 3;
+
+    // Run label detection.
+    LABEL_DETECTION = 4;
+
+    // Run text detection / optical character recognition (OCR). Text detection
+    // is optimized for areas of text within a larger image; if the image is
+    // a document, use `DOCUMENT_TEXT_DETECTION` instead.
+    TEXT_DETECTION = 5;
+
+    // Run dense text document OCR. Takes precedence when both
+    // `DOCUMENT_TEXT_DETECTION` and `TEXT_DETECTION` are present.
+    DOCUMENT_TEXT_DETECTION = 11;
+
+    // Run Safe Search to detect potentially unsafe
+    // or undesirable content.
+    SAFE_SEARCH_DETECTION = 6;
+
+    // Compute a set of image properties, such as the
+    // image's dominant colors.
+    IMAGE_PROPERTIES = 7;
+
+    // Run crop hints.
+    CROP_HINTS = 9;
+
+    // Run web detection.
+    WEB_DETECTION = 10;
+
+    // Run Product Search.
+    PRODUCT_SEARCH = 12;
+
+    // Run localizer for object detection.
+    OBJECT_LOCALIZATION = 19;
+  }
+
+  // The feature type.
+  Type type = 1;
+
+  // Maximum number of results of this type. Does not apply to
+  // `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
+  int32 max_results = 2;
+
+  // Model to use for the feature.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 3;
+}
+
+// External image source (Google Cloud Storage or web URL image location).
+message ImageSource {
+  // **Use `image_uri` instead.**
+  //
+  // The 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 gcs_image_uri = 1;
+
+  // The URI of the source image. Can be either:
+  //
+  // 1. A 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.
+  //
+  // 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from
+  //    HTTP/HTTPS URLs, Google cannot guarantee that the request will be
+  //    completed. Your request may fail if the specified host denies the
+  //    request (e.g. due to request throttling or DOS prevention), or if Google
+  //    throttles requests to the site for abuse prevention. You should not
+  //    depend on externally-hosted images for production applications.
+  //
+  // When both `gcs_image_uri` and `image_uri` are specified, `image_uri` takes
+  // precedence.
+  string image_uri = 2;
+}
+
+// Client image to perform Google Cloud Vision API tasks over.
+message Image {
+  // 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 content = 1;
+
+  // Google Cloud Storage image location, or publicly-accessible image
+  // URL. If both `content` and `source` are provided for an image, `content`
+  // takes precedence and is used to perform the image annotation request.
+  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 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;
+}
+
+// A face annotation object contains the results of face detection.
+message FaceAnnotation {
+  // A face-specific landmark (for example, a face feature).
+  message Landmark {
+    // Face landmark (feature) type.
+    // Left and right are defined from the vantage of the viewer of the image
+    // without considering mirror projections typical of photos. So, `LEFT_EYE`,
+    // typically, is the person's right eye.
+    enum Type {
+      // Unknown face landmark detected. Should not be filled.
+      UNKNOWN_LANDMARK = 0;
+
+      // Left eye.
+      LEFT_EYE = 1;
+
+      // Right eye.
+      RIGHT_EYE = 2;
+
+      // Left of left eyebrow.
+      LEFT_OF_LEFT_EYEBROW = 3;
+
+      // Right of left eyebrow.
+      RIGHT_OF_LEFT_EYEBROW = 4;
+
+      // Left of right eyebrow.
+      LEFT_OF_RIGHT_EYEBROW = 5;
+
+      // Right of right eyebrow.
+      RIGHT_OF_RIGHT_EYEBROW = 6;
+
+      // Midpoint between eyes.
+      MIDPOINT_BETWEEN_EYES = 7;
+
+      // Nose tip.
+      NOSE_TIP = 8;
+
+      // Upper lip.
+      UPPER_LIP = 9;
+
+      // Lower lip.
+      LOWER_LIP = 10;
+
+      // Mouth left.
+      MOUTH_LEFT = 11;
+
+      // Mouth right.
+      MOUTH_RIGHT = 12;
+
+      // Mouth center.
+      MOUTH_CENTER = 13;
+
+      // Nose, bottom right.
+      NOSE_BOTTOM_RIGHT = 14;
+
+      // Nose, bottom left.
+      NOSE_BOTTOM_LEFT = 15;
+
+      // Nose, bottom center.
+      NOSE_BOTTOM_CENTER = 16;
+
+      // Left eye, top boundary.
+      LEFT_EYE_TOP_BOUNDARY = 17;
+
+      // Left eye, right corner.
+      LEFT_EYE_RIGHT_CORNER = 18;
+
+      // Left eye, bottom boundary.
+      LEFT_EYE_BOTTOM_BOUNDARY = 19;
+
+      // Left eye, left corner.
+      LEFT_EYE_LEFT_CORNER = 20;
+
+      // Right eye, top boundary.
+      RIGHT_EYE_TOP_BOUNDARY = 21;
+
+      // Right eye, right corner.
+      RIGHT_EYE_RIGHT_CORNER = 22;
+
+      // Right eye, bottom boundary.
+      RIGHT_EYE_BOTTOM_BOUNDARY = 23;
+
+      // Right eye, left corner.
+      RIGHT_EYE_LEFT_CORNER = 24;
+
+      // Left eyebrow, upper midpoint.
+      LEFT_EYEBROW_UPPER_MIDPOINT = 25;
+
+      // Right eyebrow, upper midpoint.
+      RIGHT_EYEBROW_UPPER_MIDPOINT = 26;
+
+      // Left ear tragion.
+      LEFT_EAR_TRAGION = 27;
+
+      // Right ear tragion.
+      RIGHT_EAR_TRAGION = 28;
+
+      // Left eye pupil.
+      LEFT_EYE_PUPIL = 29;
+
+      // Right eye pupil.
+      RIGHT_EYE_PUPIL = 30;
+
+      // Forehead glabella.
+      FOREHEAD_GLABELLA = 31;
+
+      // Chin gnathion.
+      CHIN_GNATHION = 32;
+
+      // Chin left gonion.
+      CHIN_LEFT_GONION = 33;
+
+      // Chin right gonion.
+      CHIN_RIGHT_GONION = 34;
+    }
+
+    // Face landmark type.
+    Type type = 3;
+
+    // Face landmark position.
+    Position position = 4;
+  }
+
+  // The bounding polygon around the face. The coordinates of the bounding box
+  // are in the original image's scale.
+  // The bounding box is computed to "frame" the face in accordance with human
+  // expectations. It is based on the landmarker results.
+  // Note that one or more x and/or y coordinates may not be generated in the
+  // `BoundingPoly` (the polygon will be unbounded) if only a partial face
+  // appears in the image to be annotated.
+  BoundingPoly bounding_poly = 1;
+
+  // The `fd_bounding_poly` bounding polygon is tighter than the
+  // `boundingPoly`, and encloses only the skin part of the face. Typically, it
+  // is used to eliminate the face from any image analysis that detects the
+  // "amount of skin" visible in an image. It is not based on the
+  // landmarker results, only on the initial face detection, hence
+  // the <code>fd</code> (face detection) prefix.
+  BoundingPoly fd_bounding_poly = 2;
+
+  // Detected face landmarks.
+  repeated Landmark landmarks = 3;
+
+  // Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
+  // of the face relative to the image vertical about the axis perpendicular to
+  // the face. Range [-180,180].
+  float roll_angle = 4;
+
+  // Yaw angle, which indicates the leftward/rightward angle that the face is
+  // pointing relative to the vertical plane perpendicular to the image. Range
+  // [-180,180].
+  float pan_angle = 5;
+
+  // Pitch angle, which indicates the upwards/downwards angle that the face is
+  // pointing relative to the image's horizontal plane. Range [-180,180].
+  float tilt_angle = 6;
+
+  // Detection confidence. Range [0, 1].
+  float detection_confidence = 7;
+
+  // Face landmarking confidence. Range [0, 1].
+  float landmarking_confidence = 8;
+
+  // Joy likelihood.
+  Likelihood joy_likelihood = 9;
+
+  // Sorrow likelihood.
+  Likelihood sorrow_likelihood = 10;
+
+  // Anger likelihood.
+  Likelihood anger_likelihood = 11;
+
+  // Surprise likelihood.
+  Likelihood surprise_likelihood = 12;
+
+  // Under-exposed likelihood.
+  Likelihood under_exposed_likelihood = 13;
+
+  // Blurred likelihood.
+  Likelihood blurred_likelihood = 14;
+
+  // Headwear likelihood.
+  Likelihood headwear_likelihood = 15;
+}
+
+// Detected entity location information.
+message LocationInfo {
+  // lat/long location coordinates.
+  google.type.LatLng lat_lng = 1;
+}
+
+// A `Property` consists of a user-supplied name/value pair.
+message Property {
+  // Name of the property.
+  string name = 1;
+
+  // Value of the property.
+  string value = 2;
+
+  // Value of numeric properties.
+  uint64 uint64_value = 3;
+}
+
+// Set of detected entity features.
+message EntityAnnotation {
+  // Opaque entity ID. Some IDs may be available in
+  // [Google Knowledge Graph Search
+  // API](https://developers.google.com/knowledge-graph/).
+  string mid = 1;
+
+  // The language code for the locale in which the entity textual
+  // `description` is expressed.
+  string locale = 2;
+
+  // Entity textual description, expressed in its `locale` language.
+  string description = 3;
+
+  // Overall score of the result. Range [0, 1].
+  float score = 4;
+
+  // **Deprecated. Use `score` instead.**
+  // The accuracy of the entity detection in an image.
+  // For example, for an image in which the "Eiffel Tower" entity is detected,
+  // this field represents the confidence that there is a tower in the query
+  // image. Range [0, 1].
+  float confidence = 5 [deprecated = true];
+
+  // The relevancy of the ICA (Image Content Annotation) label to the
+  // image. For example, the relevancy of "tower" is likely higher to an image
+  // containing the detected "Eiffel Tower" than to an image containing a
+  // detected distant towering building, even though the confidence that
+  // there is a tower in each image may be the same. Range [0, 1].
+  float topicality = 6;
+
+  // Image region to which this entity belongs. Not produced
+  // for `LABEL_DETECTION` features.
+  BoundingPoly bounding_poly = 7;
+
+  // The location information for the detected entity. Multiple
+  // `LocationInfo` elements can be present because one location may
+  // indicate the location of the scene in the image, and another location
+  // may indicate the location of the place where the image was taken.
+  // Location information is usually present for landmarks.
+  repeated LocationInfo locations = 8;
+
+  // Some entities may have optional user-supplied `Property` (name/value)
+  // fields, such a score or string that qualifies the entity.
+  repeated Property properties = 9;
+}
+
+// Set of detected objects with bounding boxes.
+message LocalizedObjectAnnotation {
+  // 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;
+
+  // Image region to which this object belongs. This must be populated.
+  BoundingPoly bounding_poly = 5;
+}
+
+// Set of features pertaining to the image, computed by computer vision
+// methods over safe-search verticals (for example, adult, spoof, medical,
+// violence).
+message SafeSearchAnnotation {
+  // Represents the adult content likelihood for the image. Adult content may
+  // contain elements such as nudity, pornographic images or cartoons, or
+  // sexual activities.
+  Likelihood adult = 1;
+
+  // Spoof likelihood. The likelihood that an modification
+  // was made to the image's canonical version to make it appear
+  // funny or offensive.
+  Likelihood spoof = 2;
+
+  // Likelihood that this is a medical image.
+  Likelihood medical = 3;
+
+  // Likelihood that this image contains violent content.
+  Likelihood violence = 4;
+
+  // Likelihood that the request image contains racy content. Racy content may
+  // include (but is not limited to) skimpy or sheer clothing, strategically
+  // covered nudity, lewd or provocative poses, or close-ups of sensitive
+  // body areas.
+  Likelihood racy = 9;
+}
+
+// Rectangle determined by min and max `LatLng` pairs.
+message LatLongRect {
+  // Min lat/long pair.
+  google.type.LatLng min_lat_lng = 1;
+
+  // Max lat/long pair.
+  google.type.LatLng max_lat_lng = 2;
+}
+
+// Color information consists of RGB channels, score, and the fraction of
+// the image that the color occupies in the image.
+message ColorInfo {
+  // RGB components of the color.
+  google.type.Color color = 1;
+
+  // Image-specific score for this color. Value in range [0, 1].
+  float score = 2;
+
+  // The fraction of pixels the color occupies in the image.
+  // Value in range [0, 1].
+  float pixel_fraction = 3;
+}
+
+// Set of dominant colors and their corresponding scores.
+message DominantColorsAnnotation {
+  // RGB color values with their score and pixel fraction.
+  repeated ColorInfo colors = 1;
+}
+
+// Stores image properties, such as dominant colors.
+message ImageProperties {
+  // If present, dominant colors completed successfully.
+  DominantColorsAnnotation dominant_colors = 1;
+}
+
+// Single crop hint that is used to generate a new crop when serving an image.
+message CropHint {
+  // The bounding polygon for the crop region. The coordinates of the bounding
+  // box are in the original image's scale.
+  BoundingPoly bounding_poly = 1;
+
+  // Confidence of this being a salient region.  Range [0, 1].
+  float confidence = 2;
+
+  // Fraction of importance of this salient region with respect to the original
+  // image.
+  float importance_fraction = 3;
+}
+
+// Set of crop hints that are used to generate new crops when serving images.
+message CropHintsAnnotation {
+  // Crop hint results.
+  repeated CropHint crop_hints = 1;
+}
+
+// Parameters for crop hints annotation request.
+message CropHintsParams {
+  // Aspect ratios in floats, representing the ratio of the width to the height
+  // of the image. For example, if the desired aspect ratio is 4/3, the
+  // corresponding float value should be 1.33333.  If not specified, the
+  // best possible crop is returned. The number of provided aspect ratios is
+  // limited to a maximum of 16; any aspect ratios provided after the 16th are
+  // ignored.
+  repeated float aspect_ratios = 1;
+}
+
+// Parameters for web detection request.
+message WebDetectionParams {
+  // Whether to include results derived from the geo information in the image.
+  bool include_geo_results = 2;
+}
+
+// Image context and/or feature-specific parameters.
+message ImageContext {
+  // Not used.
+  LatLongRect lat_long_rect = 1;
+
+  // List of languages to use for TEXT_DETECTION. 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). Text detection returns an
+  // error if one or more of the specified languages is not one of the
+  // [supported languages](/vision/docs/languages).
+  repeated string language_hints = 2;
+
+  // Parameters for crop hints annotation request.
+  CropHintsParams crop_hints_params = 4;
+
+  // Parameters for product search.
+  ProductSearchParams product_search_params = 5;
+
+  // Parameters for web detection.
+  WebDetectionParams web_detection_params = 6;
+}
+
+// Request for performing Google Cloud Vision API tasks over a user-provided
+// image, with user-requested features, and with context information.
+message AnnotateImageRequest {
+  // The image to be processed.
+  Image image = 1;
+
+  // Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image.
+  ImageContext image_context = 3;
+}
+
+// If an image was produced from a file (e.g. a PDF), this message gives
+// information about the source of that image.
+message ImageAnnotationContext {
+  // The URI of the file used to produce the image.
+  string uri = 1;
+
+  // If the file was a PDF or TIFF, this field gives the page number within
+  // the file used to produce the image.
+  int32 page_number = 2;
+}
+
+// Response to an image annotation request.
+message AnnotateImageResponse {
+  // If present, face detection has completed successfully.
+  repeated FaceAnnotation face_annotations = 1;
+
+  // If present, landmark detection has completed successfully.
+  repeated EntityAnnotation landmark_annotations = 2;
+
+  // If present, logo detection has completed successfully.
+  repeated EntityAnnotation logo_annotations = 3;
+
+  // If present, label detection has completed successfully.
+  repeated EntityAnnotation label_annotations = 4;
+
+  // If present, localized object detection has completed successfully.
+  // This will be sorted descending by confidence score.
+  repeated LocalizedObjectAnnotation localized_object_annotations = 22;
+
+  // If present, text (OCR) detection has completed successfully.
+  repeated EntityAnnotation text_annotations = 5;
+
+  // If present, text (OCR) detection or document (OCR) text detection has
+  // completed successfully.
+  // This annotation provides the structural hierarchy for the OCR detected
+  // text.
+  TextAnnotation full_text_annotation = 12;
+
+  // If present, safe-search annotation has completed successfully.
+  SafeSearchAnnotation safe_search_annotation = 6;
+
+  // If present, image properties were extracted successfully.
+  ImageProperties image_properties_annotation = 8;
+
+  // If present, crop hints have completed successfully.
+  CropHintsAnnotation crop_hints_annotation = 11;
+
+  // If present, web detection has completed successfully.
+  WebDetection web_detection = 13;
+
+  // If present, product search has completed successfully.
+  ProductSearchResults product_search_results = 14;
+
+  // If set, represents the error message for the operation.
+  // Note that filled-in image annotations are guaranteed to be
+  // correct, even when `error` is set.
+  google.rpc.Status error = 9;
+
+  // If present, contextual information is needed to understand where this image
+  // comes from.
+  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;
+}
+
+// Response to a batch image annotation request.
+message BatchAnnotateImagesResponse {
+  // Individual responses to image annotation requests within the batch.
+  repeated AnnotateImageResponse responses = 1;
+}
+
+// A request to annotate one single file, e.g. a PDF, TIFF or GIF file.
+message AnnotateFileRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1;
+
+  // Required. Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image(s) in the file.
+  ImageContext image_context = 3;
+
+  // Pages of the file to perform image annotation.
+  //
+  // Pages starts from 1, we assume the first page of the file is page 1.
+  // At most 5 pages are supported per request. Pages can be negative.
+  //
+  // Page 1 means the first page.
+  // Page 2 means the second page.
+  // Page -1 means the last page.
+  // Page -2 means the second to the last page.
+  //
+  // If the file is GIF instead of PDF or TIFF, page refers to GIF frames.
+  //
+  // If this field is empty, by default the service performs image annotation
+  // for the first 5 pages of the file.
+  repeated int32 pages = 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;
+}
+
+// A list of file annotation responses.
+message BatchAnnotateFilesResponse {
+  // The list of file annotation responses, each response corresponding to each
+  // AnnotateFileRequest in BatchAnnotateFilesRequest.
+  repeated AnnotateFileResponse responses = 1;
+}
+
+// An offline file annotation request.
+message AsyncAnnotateFileRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1;
+
+  // Required. Requested features.
+  repeated Feature features = 2;
+
+  // Additional context that may accompany the image(s) in the file.
+  ImageContext image_context = 3;
+
+  // Required. The desired output location and metadata (e.g. format).
+  OutputConfig output_config = 4;
+}
+
+// The response for a single offline file annotation request.
+message AsyncAnnotateFileResponse {
+  // The output location and metadata from AsyncAnnotateFileRequest.
+  OutputConfig output_config = 1;
+}
+
+// Request for async image annotation for a list of images.
+message AsyncBatchAnnotateImagesRequest {
+  // Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1;
+
+  // Required. The desired output location and metadata (e.g. format).
+  OutputConfig output_config = 2;
+}
+
+// Response to an async batch image annotation request.
+message AsyncBatchAnnotateImagesResponse {
+  // The output location and metadata from AsyncBatchAnnotateImagesRequest.
+  OutputConfig output_config = 1;
+}
+
+// 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;
+}
+
+// Response to an async batch file annotation request.
+message AsyncBatchAnnotateFilesResponse {
+  // The list of file annotation responses, one for each request in
+  // AsyncBatchAnnotateFilesRequest.
+  repeated AsyncAnnotateFileResponse responses = 1;
+}
+
+// The desired input location and metadata.
+message InputConfig {
+  // The Google Cloud Storage location to read the input from.
+  GcsSource gcs_source = 1;
+
+  // File content, represented as a stream of bytes.
+  // Note: As with all `bytes` fields, protobuffers use a pure binary
+  // representation, whereas JSON representations use base64.
+  //
+  // Currently, this field only works for BatchAnnotateFiles requests. It does
+  // 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.
+  string mime_type = 2;
+}
+
+// The desired output location and metadata.
+message OutputConfig {
+  // The Google Cloud Storage location to write the output(s) to.
+  GcsDestination gcs_destination = 1;
+
+  // The max number of response protos to put into each output JSON file 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 response protos will
+  // be generated. If `batch_size` = 20, then 5 json files each
+  // containing 20 response protos will be written under the prefix
+  // `gcs_destination`.`uri`.
+  //
+  // Currently, batch_size only applies to GcsDestination, with potential future
+  // support for other output configurations.
+  int32 batch_size = 2;
+}
+
+// The Google Cloud Storage location where the input will be read from.
+message GcsSource {
+  // Google Cloud Storage URI for the input file. This must only be a
+  // Google Cloud Storage object. Wildcards are not currently supported.
+  string uri = 1;
+}
+
+// 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 `/`.
+  //
+  // Examples:
+  //
+  // *    File: gs://bucket-name/filename.json
+  // *    Prefix: gs://bucket-name/prefix/here/
+  // *    File: gs://bucket-name/prefix/here
+  //
+  // If multiple outputs, each response is still AnnotateFileResponse, each of
+  // which contains some subset of the full list of AnnotateImageResponse.
+  // Multiple outputs can happen if, for example, the output JSON is too large
+  // and overflows into multiple sharded files.
+  string uri = 1;
+}
+
+// Contains metadata for the BatchAnnotateImages operation.
+message OperationMetadata {
+  // Batch operation states.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is received.
+    CREATED = 1;
+
+    // Request is actively being processed.
+    RUNNING = 2;
+
+    // The batch processing is done.
+    DONE = 3;
+
+    // The batch processing was cancelled.
+    CANCELLED = 4;
+  }
+
+  // Current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was received.
+  google.protobuf.Timestamp create_time = 5;
+
+  // The time when the operation result was last updated.
+  google.protobuf.Timestamp update_time = 6;
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/image_annotator_pb2.py b/vision/google/cloud/vision_v1p4beta1/proto/image_annotator_pb2.py
new file mode 100644
index 000000000000..a162a9f4d9d6
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/image_annotator_pb2.py
@@ -0,0 +1,4650 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p4beta1/proto/image_annotator.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p4beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1p4beta1.proto import (
+    product_search_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__pb2,
+)
+from google.cloud.vision_v1p4beta1.proto import (
+    text_annotation_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_text__annotation__pb2,
+)
+from google.cloud.vision_v1p4beta1.proto import (
+    web_detection_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_web__detection__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+from google.type import color_pb2 as google_dot_type_dot_color__pb2
+from google.type import latlng_pb2 as google_dot_type_dot_latlng__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p4beta1/proto/image_annotator.proto",
+    package="google.cloud.vision.v1p4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p4beta1B\023ImageAnnotatorProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p4beta1/proto/image_annotator.proto\x12\x1dgoogle.cloud.vision.v1p4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p4beta1/proto/geometry.proto\x1a\x38google/cloud/vision_v1p4beta1/proto/product_search.proto\x1a\x39google/cloud/vision_v1p4beta1/proto/text_annotation.proto\x1a\x37google/cloud/vision_v1p4beta1/proto/web_detection.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x17google/type/color.proto\x1a\x18google/type/latlng.proto"\x8e\x03\n\x07\x46\x65\x61ture\x12\x39\n\x04type\x18\x01 \x01(\x0e\x32+.google.cloud.vision.v1p4beta1.Feature.Type\x12\x13\n\x0bmax_results\x18\x02 \x01(\x05\x12\r\n\x05model\x18\x03 \x01(\t"\xa3\x02\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x12\n\x0e\x46\x41\x43\x45_DETECTION\x10\x01\x12\x16\n\x12LANDMARK_DETECTION\x10\x02\x12\x12\n\x0eLOGO_DETECTION\x10\x03\x12\x13\n\x0fLABEL_DETECTION\x10\x04\x12\x12\n\x0eTEXT_DETECTION\x10\x05\x12\x1b\n\x17\x44OCUMENT_TEXT_DETECTION\x10\x0b\x12\x19\n\x15SAFE_SEARCH_DETECTION\x10\x06\x12\x14\n\x10IMAGE_PROPERTIES\x10\x07\x12\x0e\n\nCROP_HINTS\x10\t\x12\x11\n\rWEB_DETECTION\x10\n\x12\x12\n\x0ePRODUCT_SEARCH\x10\x0c\x12\x17\n\x13OBJECT_LOCALIZATION\x10\x13"7\n\x0bImageSource\x12\x15\n\rgcs_image_uri\x18\x01 \x01(\t\x12\x11\n\timage_uri\x18\x02 \x01(\t"T\n\x05Image\x12\x0f\n\x07\x63ontent\x18\x01 \x01(\x0c\x12:\n\x06source\x18\x02 \x01(\x0b\x32*.google.cloud.vision.v1p4beta1.ImageSource"\x9b\x0e\n\x0e\x46\x61\x63\x65\x41nnotation\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12\x45\n\x10\x66\x64_bounding_poly\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12I\n\tlandmarks\x18\x03 \x03(\x0b\x32\x36.google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark\x12\x12\n\nroll_angle\x18\x04 \x01(\x02\x12\x11\n\tpan_angle\x18\x05 \x01(\x02\x12\x12\n\ntilt_angle\x18\x06 \x01(\x02\x12\x1c\n\x14\x64\x65tection_confidence\x18\x07 \x01(\x02\x12\x1e\n\x16landmarking_confidence\x18\x08 \x01(\x02\x12\x41\n\x0ejoy_likelihood\x18\t \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x44\n\x11sorrow_likelihood\x18\n \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x43\n\x10\x61nger_likelihood\x18\x0b \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x46\n\x13surprise_likelihood\x18\x0c \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12K\n\x18under_exposed_likelihood\x18\r \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x45\n\x12\x62lurred_likelihood\x18\x0e \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x46\n\x13headwear_likelihood\x18\x0f \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x1a\xc7\x07\n\x08Landmark\x12I\n\x04type\x18\x03 \x01(\x0e\x32;.google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark.Type\x12\x39\n\x08position\x18\x04 \x01(\x0b\x32\'.google.cloud.vision.v1p4beta1.Position"\xb4\x06\n\x04Type\x12\x14\n\x10UNKNOWN_LANDMARK\x10\x00\x12\x0c\n\x08LEFT_EYE\x10\x01\x12\r\n\tRIGHT_EYE\x10\x02\x12\x18\n\x14LEFT_OF_LEFT_EYEBROW\x10\x03\x12\x19\n\x15RIGHT_OF_LEFT_EYEBROW\x10\x04\x12\x19\n\x15LEFT_OF_RIGHT_EYEBROW\x10\x05\x12\x1a\n\x16RIGHT_OF_RIGHT_EYEBROW\x10\x06\x12\x19\n\x15MIDPOINT_BETWEEN_EYES\x10\x07\x12\x0c\n\x08NOSE_TIP\x10\x08\x12\r\n\tUPPER_LIP\x10\t\x12\r\n\tLOWER_LIP\x10\n\x12\x0e\n\nMOUTH_LEFT\x10\x0b\x12\x0f\n\x0bMOUTH_RIGHT\x10\x0c\x12\x10\n\x0cMOUTH_CENTER\x10\r\x12\x15\n\x11NOSE_BOTTOM_RIGHT\x10\x0e\x12\x14\n\x10NOSE_BOTTOM_LEFT\x10\x0f\x12\x16\n\x12NOSE_BOTTOM_CENTER\x10\x10\x12\x19\n\x15LEFT_EYE_TOP_BOUNDARY\x10\x11\x12\x19\n\x15LEFT_EYE_RIGHT_CORNER\x10\x12\x12\x1c\n\x18LEFT_EYE_BOTTOM_BOUNDARY\x10\x13\x12\x18\n\x14LEFT_EYE_LEFT_CORNER\x10\x14\x12\x1a\n\x16RIGHT_EYE_TOP_BOUNDARY\x10\x15\x12\x1a\n\x16RIGHT_EYE_RIGHT_CORNER\x10\x16\x12\x1d\n\x19RIGHT_EYE_BOTTOM_BOUNDARY\x10\x17\x12\x19\n\x15RIGHT_EYE_LEFT_CORNER\x10\x18\x12\x1f\n\x1bLEFT_EYEBROW_UPPER_MIDPOINT\x10\x19\x12 \n\x1cRIGHT_EYEBROW_UPPER_MIDPOINT\x10\x1a\x12\x14\n\x10LEFT_EAR_TRAGION\x10\x1b\x12\x15\n\x11RIGHT_EAR_TRAGION\x10\x1c\x12\x12\n\x0eLEFT_EYE_PUPIL\x10\x1d\x12\x13\n\x0fRIGHT_EYE_PUPIL\x10\x1e\x12\x15\n\x11\x46OREHEAD_GLABELLA\x10\x1f\x12\x11\n\rCHIN_GNATHION\x10 \x12\x14\n\x10\x43HIN_LEFT_GONION\x10!\x12\x15\n\x11\x43HIN_RIGHT_GONION\x10""4\n\x0cLocationInfo\x12$\n\x07lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng"=\n\x08Property\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t\x12\x14\n\x0cuint64_value\x18\x03 \x01(\x04"\xc0\x02\n\x10\x45ntityAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x0e\n\x06locale\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x16\n\nconfidence\x18\x05 \x01(\x02\x42\x02\x18\x01\x12\x12\n\ntopicality\x18\x06 \x01(\x02\x12\x42\n\rbounding_poly\x18\x07 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12>\n\tlocations\x18\x08 \x03(\x0b\x32+.google.cloud.vision.v1p4beta1.LocationInfo\x12;\n\nproperties\x18\t \x03(\x0b\x32\'.google.cloud.vision.v1p4beta1.Property"\xa0\x01\n\x19LocalizedObjectAnnotation\x12\x0b\n\x03mid\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\r\n\x05score\x18\x04 \x01(\x02\x12\x42\n\rbounding_poly\x18\x05 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly"\xbc\x02\n\x14SafeSearchAnnotation\x12\x38\n\x05\x61\x64ult\x18\x01 \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x38\n\x05spoof\x18\x02 \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12:\n\x07medical\x18\x03 \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12;\n\x08violence\x18\x04 \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood\x12\x37\n\x04racy\x18\t \x01(\x0e\x32).google.cloud.vision.v1p4beta1.Likelihood"a\n\x0bLatLongRect\x12(\n\x0bmin_lat_lng\x18\x01 \x01(\x0b\x32\x13.google.type.LatLng\x12(\n\x0bmax_lat_lng\x18\x02 \x01(\x0b\x32\x13.google.type.LatLng"U\n\tColorInfo\x12!\n\x05\x63olor\x18\x01 \x01(\x0b\x32\x12.google.type.Color\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x16\n\x0epixel_fraction\x18\x03 \x01(\x02"T\n\x18\x44ominantColorsAnnotation\x12\x38\n\x06\x63olors\x18\x01 \x03(\x0b\x32(.google.cloud.vision.v1p4beta1.ColorInfo"c\n\x0fImageProperties\x12P\n\x0f\x64ominant_colors\x18\x01 \x01(\x0b\x32\x37.google.cloud.vision.v1p4beta1.DominantColorsAnnotation"\x7f\n\x08\x43ropHint\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x12\x1b\n\x13importance_fraction\x18\x03 \x01(\x02"R\n\x13\x43ropHintsAnnotation\x12;\n\ncrop_hints\x18\x01 \x03(\x0b\x32\'.google.cloud.vision.v1p4beta1.CropHint"(\n\x0f\x43ropHintsParams\x12\x15\n\raspect_ratios\x18\x01 \x03(\x02"1\n\x12WebDetectionParams\x12\x1b\n\x13include_geo_results\x18\x02 \x01(\x08"\xd8\x02\n\x0cImageContext\x12\x41\n\rlat_long_rect\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p4beta1.LatLongRect\x12\x16\n\x0elanguage_hints\x18\x02 \x03(\t\x12I\n\x11\x63rop_hints_params\x18\x04 \x01(\x0b\x32..google.cloud.vision.v1p4beta1.CropHintsParams\x12Q\n\x15product_search_params\x18\x05 \x01(\x0b\x32\x32.google.cloud.vision.v1p4beta1.ProductSearchParams\x12O\n\x14web_detection_params\x18\x06 \x01(\x0b\x32\x31.google.cloud.vision.v1p4beta1.WebDetectionParams"\xc9\x01\n\x14\x41nnotateImageRequest\x12\x33\n\x05image\x18\x01 \x01(\x0b\x32$.google.cloud.vision.v1p4beta1.Image\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p4beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.ImageContext":\n\x16ImageAnnotationContext\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12\x13\n\x0bpage_number\x18\x02 \x01(\x05"\xbf\x08\n\x15\x41nnotateImageResponse\x12G\n\x10\x66\x61\x63\x65_annotations\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p4beta1.FaceAnnotation\x12M\n\x14landmark_annotations\x18\x02 \x03(\x0b\x32/.google.cloud.vision.v1p4beta1.EntityAnnotation\x12I\n\x10logo_annotations\x18\x03 \x03(\x0b\x32/.google.cloud.vision.v1p4beta1.EntityAnnotation\x12J\n\x11label_annotations\x18\x04 \x03(\x0b\x32/.google.cloud.vision.v1p4beta1.EntityAnnotation\x12^\n\x1clocalized_object_annotations\x18\x16 \x03(\x0b\x32\x38.google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation\x12I\n\x10text_annotations\x18\x05 \x03(\x0b\x32/.google.cloud.vision.v1p4beta1.EntityAnnotation\x12K\n\x14\x66ull_text_annotation\x18\x0c \x01(\x0b\x32-.google.cloud.vision.v1p4beta1.TextAnnotation\x12S\n\x16safe_search_annotation\x18\x06 \x01(\x0b\x32\x33.google.cloud.vision.v1p4beta1.SafeSearchAnnotation\x12S\n\x1bimage_properties_annotation\x18\x08 \x01(\x0b\x32..google.cloud.vision.v1p4beta1.ImageProperties\x12Q\n\x15\x63rop_hints_annotation\x18\x0b \x01(\x0b\x32\x32.google.cloud.vision.v1p4beta1.CropHintsAnnotation\x12\x42\n\rweb_detection\x18\r \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.WebDetection\x12S\n\x16product_search_results\x18\x0e \x01(\x0b\x32\x33.google.cloud.vision.v1p4beta1.ProductSearchResults\x12!\n\x05\x65rror\x18\t \x01(\x0b\x32\x12.google.rpc.Status\x12\x46\n\x07\x63ontext\x18\x15 \x01(\x0b\x32\x35.google.cloud.vision.v1p4beta1.ImageAnnotationContext"\xb6\x01\n\x14\x41nnotateFileResponse\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p4beta1.InputConfig\x12G\n\tresponses\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.AnnotateImageResponse\x12\x13\n\x0btotal_pages\x18\x03 \x01(\x05"c\n\x1a\x42\x61tchAnnotateImagesRequest\x12\x45\n\x08requests\x18\x01 \x03(\x0b\x32\x33.google.cloud.vision.v1p4beta1.AnnotateImageRequest"f\n\x1b\x42\x61tchAnnotateImagesResponse\x12G\n\tresponses\x18\x01 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.AnnotateImageResponse"\xe4\x01\n\x13\x41nnotateFileRequest\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p4beta1.InputConfig\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p4beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.ImageContext\x12\r\n\x05pages\x18\x04 \x03(\x05"a\n\x19\x42\x61tchAnnotateFilesRequest\x12\x44\n\x08requests\x18\x01 \x03(\x0b\x32\x32.google.cloud.vision.v1p4beta1.AnnotateFileRequest"d\n\x1a\x42\x61tchAnnotateFilesResponse\x12\x46\n\tresponses\x18\x01 \x03(\x0b\x32\x33.google.cloud.vision.v1p4beta1.AnnotateFileResponse"\x9e\x02\n\x18\x41syncAnnotateFileRequest\x12@\n\x0cinput_config\x18\x01 \x01(\x0b\x32*.google.cloud.vision.v1p4beta1.InputConfig\x12\x38\n\x08\x66\x65\x61tures\x18\x02 \x03(\x0b\x32&.google.cloud.vision.v1p4beta1.Feature\x12\x42\n\rimage_context\x18\x03 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.ImageContext\x12\x42\n\routput_config\x18\x04 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.OutputConfig"_\n\x19\x41syncAnnotateFileResponse\x12\x42\n\routput_config\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.OutputConfig"\xac\x01\n\x1f\x41syncBatchAnnotateImagesRequest\x12\x45\n\x08requests\x18\x01 \x03(\x0b\x32\x33.google.cloud.vision.v1p4beta1.AnnotateImageRequest\x12\x42\n\routput_config\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.OutputConfig"f\n AsyncBatchAnnotateImagesResponse\x12\x42\n\routput_config\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.OutputConfig"k\n\x1e\x41syncBatchAnnotateFilesRequest\x12I\n\x08requests\x18\x01 \x03(\x0b\x32\x37.google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest"n\n\x1f\x41syncBatchAnnotateFilesResponse\x12K\n\tresponses\x18\x01 \x03(\x0b\x32\x38.google.cloud.vision.v1p4beta1.AsyncAnnotateFileResponse"o\n\x0bInputConfig\x12<\n\ngcs_source\x18\x01 \x01(\x0b\x32(.google.cloud.vision.v1p4beta1.GcsSource\x12\x0f\n\x07\x63ontent\x18\x03 \x01(\x0c\x12\x11\n\tmime_type\x18\x02 \x01(\t"j\n\x0cOutputConfig\x12\x46\n\x0fgcs_destination\x18\x01 \x01(\x0b\x32-.google.cloud.vision.v1p4beta1.GcsDestination\x12\x12\n\nbatch_size\x18\x02 \x01(\x05"\x18\n\tGcsSource\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x1d\n\x0eGcsDestination\x12\x0b\n\x03uri\x18\x01 \x01(\t"\x8f\x02\n\x11OperationMetadata\x12\x45\n\x05state\x18\x01 \x01(\x0e\x32\x36.google.cloud.vision.v1p4beta1.OperationMetadata.State\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Q\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x43REATED\x10\x01\x12\x0b\n\x07RUNNING\x10\x02\x12\x08\n\x04\x44ONE\x10\x03\x12\r\n\tCANCELLED\x10\x04*e\n\nLikelihood\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x11\n\rVERY_UNLIKELY\x10\x01\x12\x0c\n\x08UNLIKELY\x10\x02\x12\x0c\n\x08POSSIBLE\x10\x03\x12\n\n\x06LIKELY\x10\x04\x12\x0f\n\x0bVERY_LIKELY\x10\x05\x32\xcf\x05\n\x0eImageAnnotator\x12\xb3\x01\n\x13\x42\x61tchAnnotateImages\x12\x39.google.cloud.vision.v1p4beta1.BatchAnnotateImagesRequest\x1a:.google.cloud.vision.v1p4beta1.BatchAnnotateImagesResponse"%\x82\xd3\xe4\x93\x02\x1f"\x1a/v1p4beta1/images:annotate:\x01*\x12\xaf\x01\n\x12\x42\x61tchAnnotateFiles\x12\x38.google.cloud.vision.v1p4beta1.BatchAnnotateFilesRequest\x1a\x39.google.cloud.vision.v1p4beta1.BatchAnnotateFilesResponse"$\x82\xd3\xe4\x93\x02\x1e"\x19/v1p4beta1/files:annotate:\x01*\x12\xaa\x01\n\x18\x41syncBatchAnnotateImages\x12>.google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesRequest\x1a\x1d.google.longrunning.Operation"/\x82\xd3\xe4\x93\x02)"$/v1p4beta1/images:asyncBatchAnnotate:\x01*\x12\xa7\x01\n\x17\x41syncBatchAnnotateFiles\x12=.google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesRequest\x1a\x1d.google.longrunning.Operation".\x82\xd3\xe4\x93\x02("#/v1p4beta1/files:asyncBatchAnnotate:\x01*B\x89\x01\n!com.google.cloud.vision.v1p4beta1B\x13ImageAnnotatorProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_text__annotation__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_web__detection__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+        google_dot_type_dot_color__pb2.DESCRIPTOR,
+        google_dot_type_dot_latlng__pb2.DESCRIPTOR,
+    ],
+)
+
+_LIKELIHOOD = _descriptor.EnumDescriptor(
+    name="Likelihood",
+    full_name="google.cloud.vision.v1p4beta1.Likelihood",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_UNLIKELY", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNLIKELY", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="POSSIBLE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LIKELY", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="VERY_LIKELY", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=8456,
+    serialized_end=8557,
+)
+_sym_db.RegisterEnumDescriptor(_LIKELIHOOD)
+
+Likelihood = enum_type_wrapper.EnumTypeWrapper(_LIKELIHOOD)
+UNKNOWN = 0
+VERY_UNLIKELY = 1
+UNLIKELY = 2
+POSSIBLE = 3
+LIKELY = 4
+VERY_LIKELY = 5
+
+
+_FEATURE_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p4beta1.Feature.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FACE_DETECTION", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LANDMARK_DETECTION",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOGO_DETECTION", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LABEL_DETECTION",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT_DETECTION", index=5, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DOCUMENT_TEXT_DETECTION",
+            index=6,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFE_SEARCH_DETECTION",
+            index=7,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="IMAGE_PROPERTIES",
+            index=8,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CROP_HINTS", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="WEB_DETECTION",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PRODUCT_SEARCH",
+            index=11,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OBJECT_LOCALIZATION",
+            index=12,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=636,
+    serialized_end=927,
+)
+_sym_db.RegisterEnumDescriptor(_FEATURE_TYPE)
+
+_FACEANNOTATION_LANDMARK_TYPE = _descriptor.EnumDescriptor(
+    name="Type",
+    full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark.Type",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN_LANDMARK",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_LEFT_EYEBROW",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_LEFT_EYEBROW",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_OF_RIGHT_EYEBROW",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_OF_RIGHT_EYEBROW",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIDPOINT_BETWEEN_EYES",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_TIP", index=8, number=8, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UPPER_LIP", index=9, number=9, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOWER_LIP", index=10, number=10, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_LEFT", index=11, number=11, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_RIGHT", index=12, number=12, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MOUTH_CENTER", index=13, number=13, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_RIGHT",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_LEFT",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NOSE_BOTTOM_CENTER",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_TOP_BOUNDARY",
+            index=17,
+            number=17,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_RIGHT_CORNER",
+            index=18,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_BOTTOM_BOUNDARY",
+            index=19,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_LEFT_CORNER",
+            index=20,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_TOP_BOUNDARY",
+            index=21,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_RIGHT_CORNER",
+            index=22,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_BOTTOM_BOUNDARY",
+            index=23,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_LEFT_CORNER",
+            index=24,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYEBROW_UPPER_MIDPOINT",
+            index=25,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYEBROW_UPPER_MIDPOINT",
+            index=26,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EAR_TRAGION",
+            index=27,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EAR_TRAGION",
+            index=28,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LEFT_EYE_PUPIL",
+            index=29,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RIGHT_EYE_PUPIL",
+            index=30,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FOREHEAD_GLABELLA",
+            index=31,
+            number=31,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_GNATHION",
+            index=32,
+            number=32,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_LEFT_GONION",
+            index=33,
+            number=33,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHIN_RIGHT_GONION",
+            index=34,
+            number=34,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2072,
+    serialized_end=2892,
+)
+_sym_db.RegisterEnumDescriptor(_FACEANNOTATION_LANDMARK_TYPE)
+
+_OPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1p4beta1.OperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CREATED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RUNNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DONE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=8373,
+    serialized_end=8454,
+)
+_sym_db.RegisterEnumDescriptor(_OPERATIONMETADATA_STATE)
+
+
+_FEATURE = _descriptor.Descriptor(
+    name="Feature",
+    full_name="google.cloud.vision.v1p4beta1.Feature",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p4beta1.Feature.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_results",
+            full_name="google.cloud.vision.v1p4beta1.Feature.max_results",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="model",
+            full_name="google.cloud.vision.v1p4beta1.Feature.model",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FEATURE_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=529,
+    serialized_end=927,
+)
+
+
+_IMAGESOURCE = _descriptor.Descriptor(
+    name="ImageSource",
+    full_name="google.cloud.vision.v1p4beta1.ImageSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_image_uri",
+            full_name="google.cloud.vision.v1p4beta1.ImageSource.gcs_image_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_uri",
+            full_name="google.cloud.vision.v1p4beta1.ImageSource.image_uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=929,
+    serialized_end=984,
+)
+
+
+_IMAGE = _descriptor.Descriptor(
+    name="Image",
+    full_name="google.cloud.vision.v1p4beta1.Image",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1p4beta1.Image.content",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1p4beta1.Image.source",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=986,
+    serialized_end=1070,
+)
+
+
+_FACEANNOTATION_LANDMARK = _descriptor.Descriptor(
+    name="Landmark",
+    full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark.type",
+            index=0,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="position",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark.position",
+            index=1,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FACEANNOTATION_LANDMARK_TYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1925,
+    serialized_end=2892,
+)
+
+_FACEANNOTATION = _descriptor.Descriptor(
+    name="FaceAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.FaceAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fd_bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.fd_bounding_poly",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarks",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.landmarks",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="roll_angle",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.roll_angle",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pan_angle",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.pan_angle",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tilt_angle",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.tilt_angle",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detection_confidence",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.detection_confidence",
+            index=6,
+            number=7,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmarking_confidence",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.landmarking_confidence",
+            index=7,
+            number=8,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="joy_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.joy_likelihood",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="sorrow_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.sorrow_likelihood",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="anger_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.anger_likelihood",
+            index=10,
+            number=11,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="surprise_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.surprise_likelihood",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="under_exposed_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.under_exposed_likelihood",
+            index=12,
+            number=13,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blurred_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.blurred_likelihood",
+            index=13,
+            number=14,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="headwear_likelihood",
+            full_name="google.cloud.vision.v1p4beta1.FaceAnnotation.headwear_likelihood",
+            index=14,
+            number=15,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_FACEANNOTATION_LANDMARK],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1073,
+    serialized_end=2892,
+)
+
+
+_LOCATIONINFO = _descriptor.Descriptor(
+    name="LocationInfo",
+    full_name="google.cloud.vision.v1p4beta1.LocationInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_lng",
+            full_name="google.cloud.vision.v1p4beta1.LocationInfo.lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2894,
+    serialized_end=2946,
+)
+
+
+_PROPERTY = _descriptor.Descriptor(
+    name="Property",
+    full_name="google.cloud.vision.v1p4beta1.Property",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.Property.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1p4beta1.Property.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uint64_value",
+            full_name="google.cloud.vision.v1p4beta1.Property.uint64_value",
+            index=2,
+            number=3,
+            type=4,
+            cpp_type=4,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2948,
+    serialized_end=3009,
+)
+
+
+_ENTITYANNOTATION = _descriptor.Descriptor(
+    name="EntityAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.EntityAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locale",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.locale",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=_b("\030\001"),
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="topicality",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.topicality",
+            index=5,
+            number=6,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.bounding_poly",
+            index=6,
+            number=7,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="locations",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.locations",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="properties",
+            full_name="google.cloud.vision.v1p4beta1.EntityAnnotation.properties",
+            index=8,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3012,
+    serialized_end=3332,
+)
+
+
+_LOCALIZEDOBJECTANNOTATION = _descriptor.Descriptor(
+    name="LocalizedObjectAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="mid",
+            full_name="google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation.mid",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation.name",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation.score",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation.bounding_poly",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3335,
+    serialized_end=3495,
+)
+
+
+_SAFESEARCHANNOTATION = _descriptor.Descriptor(
+    name="SafeSearchAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.SafeSearchAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="adult",
+            full_name="google.cloud.vision.v1p4beta1.SafeSearchAnnotation.adult",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="spoof",
+            full_name="google.cloud.vision.v1p4beta1.SafeSearchAnnotation.spoof",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="medical",
+            full_name="google.cloud.vision.v1p4beta1.SafeSearchAnnotation.medical",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violence",
+            full_name="google.cloud.vision.v1p4beta1.SafeSearchAnnotation.violence",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="racy",
+            full_name="google.cloud.vision.v1p4beta1.SafeSearchAnnotation.racy",
+            index=4,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3498,
+    serialized_end=3814,
+)
+
+
+_LATLONGRECT = _descriptor.Descriptor(
+    name="LatLongRect",
+    full_name="google.cloud.vision.v1p4beta1.LatLongRect",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="min_lat_lng",
+            full_name="google.cloud.vision.v1p4beta1.LatLongRect.min_lat_lng",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_lat_lng",
+            full_name="google.cloud.vision.v1p4beta1.LatLongRect.max_lat_lng",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3816,
+    serialized_end=3913,
+)
+
+
+_COLORINFO = _descriptor.Descriptor(
+    name="ColorInfo",
+    full_name="google.cloud.vision.v1p4beta1.ColorInfo",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="color",
+            full_name="google.cloud.vision.v1p4beta1.ColorInfo.color",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.ColorInfo.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pixel_fraction",
+            full_name="google.cloud.vision.v1p4beta1.ColorInfo.pixel_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3915,
+    serialized_end=4000,
+)
+
+
+_DOMINANTCOLORSANNOTATION = _descriptor.Descriptor(
+    name="DominantColorsAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.DominantColorsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="colors",
+            full_name="google.cloud.vision.v1p4beta1.DominantColorsAnnotation.colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4002,
+    serialized_end=4086,
+)
+
+
+_IMAGEPROPERTIES = _descriptor.Descriptor(
+    name="ImageProperties",
+    full_name="google.cloud.vision.v1p4beta1.ImageProperties",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="dominant_colors",
+            full_name="google.cloud.vision.v1p4beta1.ImageProperties.dominant_colors",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4088,
+    serialized_end=4187,
+)
+
+
+_CROPHINT = _descriptor.Descriptor(
+    name="CropHint",
+    full_name="google.cloud.vision.v1p4beta1.CropHint",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.CropHint.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.CropHint.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="importance_fraction",
+            full_name="google.cloud.vision.v1p4beta1.CropHint.importance_fraction",
+            index=2,
+            number=3,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4189,
+    serialized_end=4316,
+)
+
+
+_CROPHINTSANNOTATION = _descriptor.Descriptor(
+    name="CropHintsAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.CropHintsAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crop_hints",
+            full_name="google.cloud.vision.v1p4beta1.CropHintsAnnotation.crop_hints",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4318,
+    serialized_end=4400,
+)
+
+
+_CROPHINTSPARAMS = _descriptor.Descriptor(
+    name="CropHintsParams",
+    full_name="google.cloud.vision.v1p4beta1.CropHintsParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="aspect_ratios",
+            full_name="google.cloud.vision.v1p4beta1.CropHintsParams.aspect_ratios",
+            index=0,
+            number=1,
+            type=2,
+            cpp_type=6,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4402,
+    serialized_end=4442,
+)
+
+
+_WEBDETECTIONPARAMS = _descriptor.Descriptor(
+    name="WebDetectionParams",
+    full_name="google.cloud.vision.v1p4beta1.WebDetectionParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="include_geo_results",
+            full_name="google.cloud.vision.v1p4beta1.WebDetectionParams.include_geo_results",
+            index=0,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4444,
+    serialized_end=4493,
+)
+
+
+_IMAGECONTEXT = _descriptor.Descriptor(
+    name="ImageContext",
+    full_name="google.cloud.vision.v1p4beta1.ImageContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="lat_long_rect",
+            full_name="google.cloud.vision.v1p4beta1.ImageContext.lat_long_rect",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_hints",
+            full_name="google.cloud.vision.v1p4beta1.ImageContext.language_hints",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_params",
+            full_name="google.cloud.vision.v1p4beta1.ImageContext.crop_hints_params",
+            index=2,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_search_params",
+            full_name="google.cloud.vision.v1p4beta1.ImageContext.product_search_params",
+            index=3,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection_params",
+            full_name="google.cloud.vision.v1p4beta1.ImageContext.web_detection_params",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4496,
+    serialized_end=4840,
+)
+
+
+_ANNOTATEIMAGEREQUEST = _descriptor.Descriptor(
+    name="AnnotateImageRequest",
+    full_name="google.cloud.vision.v1p4beta1.AnnotateImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageRequest.image",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=4843,
+    serialized_end=5044,
+)
+
+
+_IMAGEANNOTATIONCONTEXT = _descriptor.Descriptor(
+    name="ImageAnnotationContext",
+    full_name="google.cloud.vision.v1p4beta1.ImageAnnotationContext",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p4beta1.ImageAnnotationContext.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_number",
+            full_name="google.cloud.vision.v1p4beta1.ImageAnnotationContext.page_number",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5046,
+    serialized_end=5104,
+)
+
+
+_ANNOTATEIMAGERESPONSE = _descriptor.Descriptor(
+    name="AnnotateImageResponse",
+    full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="face_annotations",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.face_annotations",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="landmark_annotations",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.landmark_annotations",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="logo_annotations",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.logo_annotations",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="label_annotations",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.label_annotations",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="localized_object_annotations",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.localized_object_annotations",
+            index=4,
+            number=22,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text_annotations",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.text_annotations",
+            index=5,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_text_annotation",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.full_text_annotation",
+            index=6,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="safe_search_annotation",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.safe_search_annotation",
+            index=7,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_properties_annotation",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.image_properties_annotation",
+            index=8,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="crop_hints_annotation",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.crop_hints_annotation",
+            index=9,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="web_detection",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.web_detection",
+            index=10,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_search_results",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.product_search_results",
+            index=11,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.error",
+            index=12,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="context",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateImageResponse.context",
+            index=13,
+            number=21,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=5107,
+    serialized_end=6194,
+)
+
+
+_ANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AnnotateFileResponse",
+    full_name="google.cloud.vision.v1p4beta1.AnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileResponse.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileResponse.responses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="total_pages",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileResponse.total_pages",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6197,
+    serialized_end=6379,
+)
+
+
+_BATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1p4beta1.BatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p4beta1.BatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6381,
+    serialized_end=6480,
+)
+
+
+_BATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1p4beta1.BatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p4beta1.BatchAnnotateImagesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6482,
+    serialized_end=6584,
+)
+
+
+_ANNOTATEFILEREQUEST = _descriptor.Descriptor(
+    name="AnnotateFileRequest",
+    full_name="google.cloud.vision.v1p4beta1.AnnotateFileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileRequest.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1p4beta1.AnnotateFileRequest.pages",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6587,
+    serialized_end=6815,
+)
+
+
+_BATCHANNOTATEFILESREQUEST = _descriptor.Descriptor(
+    name="BatchAnnotateFilesRequest",
+    full_name="google.cloud.vision.v1p4beta1.BatchAnnotateFilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p4beta1.BatchAnnotateFilesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6817,
+    serialized_end=6914,
+)
+
+
+_BATCHANNOTATEFILESRESPONSE = _descriptor.Descriptor(
+    name="BatchAnnotateFilesResponse",
+    full_name="google.cloud.vision.v1p4beta1.BatchAnnotateFilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p4beta1.BatchAnnotateFilesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=6916,
+    serialized_end=7016,
+)
+
+
+_ASYNCANNOTATEFILEREQUEST = _descriptor.Descriptor(
+    name="AsyncAnnotateFileRequest",
+    full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest.input_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="features",
+            full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest.features",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image_context",
+            full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest.image_context",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest.output_config",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7019,
+    serialized_end=7305,
+)
+
+
+_ASYNCANNOTATEFILERESPONSE = _descriptor.Descriptor(
+    name="AsyncAnnotateFileResponse",
+    full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p4beta1.AsyncAnnotateFileResponse.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7307,
+    serialized_end=7402,
+)
+
+
+_ASYNCBATCHANNOTATEIMAGESREQUEST = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateImagesRequest",
+    full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesRequest.output_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7405,
+    serialized_end=7577,
+)
+
+
+_ASYNCBATCHANNOTATEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateImagesResponse",
+    full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="output_config",
+            full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesResponse.output_config",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7579,
+    serialized_end=7681,
+)
+
+
+_ASYNCBATCHANNOTATEFILESREQUEST = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesRequest",
+    full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="requests",
+            full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesRequest.requests",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7683,
+    serialized_end=7790,
+)
+
+
+_ASYNCBATCHANNOTATEFILESRESPONSE = _descriptor.Descriptor(
+    name="AsyncBatchAnnotateFilesResponse",
+    full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="responses",
+            full_name="google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesResponse.responses",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7792,
+    serialized_end=7902,
+)
+
+
+_INPUTCONFIG = _descriptor.Descriptor(
+    name="InputConfig",
+    full_name="google.cloud.vision.v1p4beta1.InputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1p4beta1.InputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="content",
+            full_name="google.cloud.vision.v1p4beta1.InputConfig.content",
+            index=1,
+            number=3,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="mime_type",
+            full_name="google.cloud.vision.v1p4beta1.InputConfig.mime_type",
+            index=2,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=7904,
+    serialized_end=8015,
+)
+
+
+_OUTPUTCONFIG = _descriptor.Descriptor(
+    name="OutputConfig",
+    full_name="google.cloud.vision.v1p4beta1.OutputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_destination",
+            full_name="google.cloud.vision.v1p4beta1.OutputConfig.gcs_destination",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="batch_size",
+            full_name="google.cloud.vision.v1p4beta1.OutputConfig.batch_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8017,
+    serialized_end=8123,
+)
+
+
+_GCSSOURCE = _descriptor.Descriptor(
+    name="GcsSource",
+    full_name="google.cloud.vision.v1p4beta1.GcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p4beta1.GcsSource.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8125,
+    serialized_end=8149,
+)
+
+
+_GCSDESTINATION = _descriptor.Descriptor(
+    name="GcsDestination",
+    full_name="google.cloud.vision.v1p4beta1.GcsDestination",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p4beta1.GcsDestination.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8151,
+    serialized_end=8180,
+)
+
+
+_OPERATIONMETADATA = _descriptor.Descriptor(
+    name="OperationMetadata",
+    full_name="google.cloud.vision.v1p4beta1.OperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1p4beta1.OperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="create_time",
+            full_name="google.cloud.vision.v1p4beta1.OperationMetadata.create_time",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_time",
+            full_name="google.cloud.vision.v1p4beta1.OperationMetadata.update_time",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_OPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=8183,
+    serialized_end=8454,
+)
+
+_FEATURE.fields_by_name["type"].enum_type = _FEATURE_TYPE
+_FEATURE_TYPE.containing_type = _FEATURE
+_IMAGE.fields_by_name["source"].message_type = _IMAGESOURCE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "type"
+].enum_type = _FACEANNOTATION_LANDMARK_TYPE
+_FACEANNOTATION_LANDMARK.fields_by_name[
+    "position"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._POSITION
+)
+_FACEANNOTATION_LANDMARK.containing_type = _FACEANNOTATION
+_FACEANNOTATION_LANDMARK_TYPE.containing_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name[
+    "fd_bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_FACEANNOTATION.fields_by_name["landmarks"].message_type = _FACEANNOTATION_LANDMARK
+_FACEANNOTATION.fields_by_name["joy_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["sorrow_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["anger_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["surprise_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["under_exposed_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["blurred_likelihood"].enum_type = _LIKELIHOOD
+_FACEANNOTATION.fields_by_name["headwear_likelihood"].enum_type = _LIKELIHOOD
+_LOCATIONINFO.fields_by_name[
+    "lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_ENTITYANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_ENTITYANNOTATION.fields_by_name["locations"].message_type = _LOCATIONINFO
+_ENTITYANNOTATION.fields_by_name["properties"].message_type = _PROPERTY
+_LOCALIZEDOBJECTANNOTATION.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_SAFESEARCHANNOTATION.fields_by_name["adult"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["spoof"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["medical"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["violence"].enum_type = _LIKELIHOOD
+_SAFESEARCHANNOTATION.fields_by_name["racy"].enum_type = _LIKELIHOOD
+_LATLONGRECT.fields_by_name[
+    "min_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_LATLONGRECT.fields_by_name[
+    "max_lat_lng"
+].message_type = google_dot_type_dot_latlng__pb2._LATLNG
+_COLORINFO.fields_by_name["color"].message_type = google_dot_type_dot_color__pb2._COLOR
+_DOMINANTCOLORSANNOTATION.fields_by_name["colors"].message_type = _COLORINFO
+_IMAGEPROPERTIES.fields_by_name[
+    "dominant_colors"
+].message_type = _DOMINANTCOLORSANNOTATION
+_CROPHINT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CROPHINTSANNOTATION.fields_by_name["crop_hints"].message_type = _CROPHINT
+_IMAGECONTEXT.fields_by_name["lat_long_rect"].message_type = _LATLONGRECT
+_IMAGECONTEXT.fields_by_name["crop_hints_params"].message_type = _CROPHINTSPARAMS
+_IMAGECONTEXT.fields_by_name[
+    "product_search_params"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__pb2._PRODUCTSEARCHPARAMS
+)
+_IMAGECONTEXT.fields_by_name["web_detection_params"].message_type = _WEBDETECTIONPARAMS
+_ANNOTATEIMAGEREQUEST.fields_by_name["image"].message_type = _IMAGE
+_ANNOTATEIMAGEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEIMAGEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ANNOTATEIMAGERESPONSE.fields_by_name["face_annotations"].message_type = _FACEANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "landmark_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "logo_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "label_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "localized_object_annotations"
+].message_type = _LOCALIZEDOBJECTANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "text_annotations"
+].message_type = _ENTITYANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "full_text_annotation"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_text__annotation__pb2._TEXTANNOTATION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "safe_search_annotation"
+].message_type = _SAFESEARCHANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "image_properties_annotation"
+].message_type = _IMAGEPROPERTIES
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "crop_hints_annotation"
+].message_type = _CROPHINTSANNOTATION
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "web_detection"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_web__detection__pb2._WEBDETECTION
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "product_search_results"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__pb2._PRODUCTSEARCHRESULTS
+)
+_ANNOTATEIMAGERESPONSE.fields_by_name[
+    "error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_ANNOTATEIMAGERESPONSE.fields_by_name["context"].message_type = _IMAGEANNOTATIONCONTEXT
+_ANNOTATEFILERESPONSE.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ANNOTATEFILERESPONSE.fields_by_name["responses"].message_type = _ANNOTATEIMAGERESPONSE
+_BATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_BATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEIMAGERESPONSE
+_ANNOTATEFILEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ANNOTATEFILEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ANNOTATEFILEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_BATCHANNOTATEFILESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEFILEREQUEST
+_BATCHANNOTATEFILESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ANNOTATEFILERESPONSE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["input_config"].message_type = _INPUTCONFIG
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["features"].message_type = _FEATURE
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["image_context"].message_type = _IMAGECONTEXT
+_ASYNCANNOTATEFILEREQUEST.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCANNOTATEFILERESPONSE.fields_by_name["output_config"].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ANNOTATEIMAGEREQUEST
+_ASYNCBATCHANNOTATEIMAGESREQUEST.fields_by_name[
+    "output_config"
+].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEIMAGESRESPONSE.fields_by_name[
+    "output_config"
+].message_type = _OUTPUTCONFIG
+_ASYNCBATCHANNOTATEFILESREQUEST.fields_by_name[
+    "requests"
+].message_type = _ASYNCANNOTATEFILEREQUEST
+_ASYNCBATCHANNOTATEFILESRESPONSE.fields_by_name[
+    "responses"
+].message_type = _ASYNCANNOTATEFILERESPONSE
+_INPUTCONFIG.fields_by_name["gcs_source"].message_type = _GCSSOURCE
+_OUTPUTCONFIG.fields_by_name["gcs_destination"].message_type = _GCSDESTINATION
+_OPERATIONMETADATA.fields_by_name["state"].enum_type = _OPERATIONMETADATA_STATE
+_OPERATIONMETADATA.fields_by_name[
+    "create_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA.fields_by_name[
+    "update_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_OPERATIONMETADATA_STATE.containing_type = _OPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Feature"] = _FEATURE
+DESCRIPTOR.message_types_by_name["ImageSource"] = _IMAGESOURCE
+DESCRIPTOR.message_types_by_name["Image"] = _IMAGE
+DESCRIPTOR.message_types_by_name["FaceAnnotation"] = _FACEANNOTATION
+DESCRIPTOR.message_types_by_name["LocationInfo"] = _LOCATIONINFO
+DESCRIPTOR.message_types_by_name["Property"] = _PROPERTY
+DESCRIPTOR.message_types_by_name["EntityAnnotation"] = _ENTITYANNOTATION
+DESCRIPTOR.message_types_by_name[
+    "LocalizedObjectAnnotation"
+] = _LOCALIZEDOBJECTANNOTATION
+DESCRIPTOR.message_types_by_name["SafeSearchAnnotation"] = _SAFESEARCHANNOTATION
+DESCRIPTOR.message_types_by_name["LatLongRect"] = _LATLONGRECT
+DESCRIPTOR.message_types_by_name["ColorInfo"] = _COLORINFO
+DESCRIPTOR.message_types_by_name["DominantColorsAnnotation"] = _DOMINANTCOLORSANNOTATION
+DESCRIPTOR.message_types_by_name["ImageProperties"] = _IMAGEPROPERTIES
+DESCRIPTOR.message_types_by_name["CropHint"] = _CROPHINT
+DESCRIPTOR.message_types_by_name["CropHintsAnnotation"] = _CROPHINTSANNOTATION
+DESCRIPTOR.message_types_by_name["CropHintsParams"] = _CROPHINTSPARAMS
+DESCRIPTOR.message_types_by_name["WebDetectionParams"] = _WEBDETECTIONPARAMS
+DESCRIPTOR.message_types_by_name["ImageContext"] = _IMAGECONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageRequest"] = _ANNOTATEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name["ImageAnnotationContext"] = _IMAGEANNOTATIONCONTEXT
+DESCRIPTOR.message_types_by_name["AnnotateImageResponse"] = _ANNOTATEIMAGERESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateFileResponse"] = _ANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesRequest"
+] = _BATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateImagesResponse"
+] = _BATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["AnnotateFileRequest"] = _ANNOTATEFILEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateFilesRequest"
+] = _BATCHANNOTATEFILESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "BatchAnnotateFilesResponse"
+] = _BATCHANNOTATEFILESRESPONSE
+DESCRIPTOR.message_types_by_name["AsyncAnnotateFileRequest"] = _ASYNCANNOTATEFILEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncAnnotateFileResponse"
+] = _ASYNCANNOTATEFILERESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateImagesRequest"
+] = _ASYNCBATCHANNOTATEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateImagesResponse"
+] = _ASYNCBATCHANNOTATEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesRequest"
+] = _ASYNCBATCHANNOTATEFILESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AsyncBatchAnnotateFilesResponse"
+] = _ASYNCBATCHANNOTATEFILESRESPONSE
+DESCRIPTOR.message_types_by_name["InputConfig"] = _INPUTCONFIG
+DESCRIPTOR.message_types_by_name["OutputConfig"] = _OUTPUTCONFIG
+DESCRIPTOR.message_types_by_name["GcsSource"] = _GCSSOURCE
+DESCRIPTOR.message_types_by_name["GcsDestination"] = _GCSDESTINATION
+DESCRIPTOR.message_types_by_name["OperationMetadata"] = _OPERATIONMETADATA
+DESCRIPTOR.enum_types_by_name["Likelihood"] = _LIKELIHOOD
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Feature = _reflection.GeneratedProtocolMessageType(
+    "Feature",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FEATURE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""The type of Google Cloud Vision API detection to perform, and the
+  maximum number of results to return for that type. Multiple ``Feature``
+  objects can be specified in the ``features`` list.
+  
+  
+  Attributes:
+      type:
+          The feature type.
+      max_results:
+          Maximum number of results of this type. Does not apply to
+          ``TEXT_DETECTION``, ``DOCUMENT_TEXT_DETECTION``, or
+          ``CROP_HINTS``.
+      model:
+          Model to use for the feature. Supported values:
+          "builtin/stable" (the default if unset) and "builtin/latest".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Feature)
+    ),
+)
+_sym_db.RegisterMessage(Feature)
+
+ImageSource = _reflection.GeneratedProtocolMessageType(
+    "ImageSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGESOURCE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""External image source (Google Cloud Storage or web URL image location).
+  
+  
+  Attributes:
+      gcs_image_uri:
+          **Use ``image_uri`` instead.**  The 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.
+      image_uri:
+          The URI of the source image. Can be either:  1. A 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.  2. A publicly-accessible image HTTP/HTTPS URL.
+          When fetching images from    HTTP/HTTPS URLs, Google cannot
+          guarantee that the request will be    completed. Your request
+          may fail if the specified host denies the    request (e.g. due
+          to request throttling or DOS prevention), or if    Google
+          throttles requests to the site for abuse prevention. You
+          should not depend on externally-hosted images for production
+          applications.  When both ``gcs_image_uri`` and ``image_uri``
+          are specified, ``image_uri`` takes precedence.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImageSource)
+    ),
+)
+_sym_db.RegisterMessage(ImageSource)
+
+Image = _reflection.GeneratedProtocolMessageType(
+    "Image",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Client image to perform Google Cloud Vision API tasks over.
+  
+  
+  Attributes:
+      content:
+          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.
+      source:
+          Google Cloud Storage image location, or publicly-accessible
+          image URL. If both ``content`` and ``source`` are provided for
+          an image, ``content`` takes precedence and is used to perform
+          the image annotation request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Image)
+    ),
+)
+_sym_db.RegisterMessage(Image)
+
+FaceAnnotation = _reflection.GeneratedProtocolMessageType(
+    "FaceAnnotation",
+    (_message.Message,),
+    dict(
+        Landmark=_reflection.GeneratedProtocolMessageType(
+            "Landmark",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_FACEANNOTATION_LANDMARK,
+                __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+                __doc__="""A face-specific landmark (for example, a face feature).
+    
+    
+    Attributes:
+        type:
+            Face landmark type.
+        position:
+            Face landmark position.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.FaceAnnotation.Landmark)
+            ),
+        ),
+        DESCRIPTOR=_FACEANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""A face annotation object contains the results of face detection.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the face. The coordinates of the
+          bounding box are in the original image's scale. The bounding
+          box is computed to "frame" the face in accordance with human
+          expectations. It is based on the landmarker results. Note that
+          one or more x and/or y coordinates may not be generated in the
+          ``BoundingPoly`` (the polygon will be unbounded) if only a
+          partial face appears in the image to be annotated.
+      fd_bounding_poly:
+          The ``fd_bounding_poly`` bounding polygon is tighter than the
+          ``boundingPoly``, and encloses only the skin part of the face.
+          Typically, it is used to eliminate the face from any image
+          analysis that detects the "amount of skin" visible in an
+          image. It is not based on the landmarker results, only on the
+          initial face detection, hence the fd (face detection) prefix.
+      landmarks:
+          Detected face landmarks.
+      roll_angle:
+          Roll angle, which indicates the amount of clockwise/anti-
+          clockwise rotation of the face relative to the image vertical
+          about the axis perpendicular to the face. Range [-180,180].
+      pan_angle:
+          Yaw angle, which indicates the leftward/rightward angle that
+          the face is pointing relative to the vertical plane
+          perpendicular to the image. Range [-180,180].
+      tilt_angle:
+          Pitch angle, which indicates the upwards/downwards angle that
+          the face is pointing relative to the image's horizontal plane.
+          Range [-180,180].
+      detection_confidence:
+          Detection confidence. Range [0, 1].
+      landmarking_confidence:
+          Face landmarking confidence. Range [0, 1].
+      joy_likelihood:
+          Joy likelihood.
+      sorrow_likelihood:
+          Sorrow likelihood.
+      anger_likelihood:
+          Anger likelihood.
+      surprise_likelihood:
+          Surprise likelihood.
+      under_exposed_likelihood:
+          Under-exposed likelihood.
+      blurred_likelihood:
+          Blurred likelihood.
+      headwear_likelihood:
+          Headwear likelihood.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.FaceAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(FaceAnnotation)
+_sym_db.RegisterMessage(FaceAnnotation.Landmark)
+
+LocationInfo = _reflection.GeneratedProtocolMessageType(
+    "LocationInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCATIONINFO,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Detected entity location information.
+  
+  
+  Attributes:
+      lat_lng:
+          lat/long location coordinates.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.LocationInfo)
+    ),
+)
+_sym_db.RegisterMessage(LocationInfo)
+
+Property = _reflection.GeneratedProtocolMessageType(
+    "Property",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PROPERTY,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""A ``Property`` consists of a user-supplied name/value pair.
+  
+  
+  Attributes:
+      name:
+          Name of the property.
+      value:
+          Value of the property.
+      uint64_value:
+          Value of numeric properties.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Property)
+    ),
+)
+_sym_db.RegisterMessage(Property)
+
+EntityAnnotation = _reflection.GeneratedProtocolMessageType(
+    "EntityAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ENTITYANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Set of detected entity features.
+  
+  
+  Attributes:
+      mid:
+          Opaque entity ID. Some IDs may be available in `Google
+          Knowledge Graph Search API
+          <https://developers.google.com/knowledge-graph/>`__.
+      locale:
+          The language code for the locale in which the entity textual
+          ``description`` is expressed.
+      description:
+          Entity textual description, expressed in its ``locale``
+          language.
+      score:
+          Overall score of the result. Range [0, 1].
+      confidence:
+          **Deprecated. Use ``score`` instead.** The accuracy of the
+          entity detection in an image. For example, for an image in
+          which the "Eiffel Tower" entity is detected, this field
+          represents the confidence that there is a tower in the query
+          image. Range [0, 1].
+      topicality:
+          The relevancy of the ICA (Image Content Annotation) label to
+          the image. For example, the relevancy of "tower" is likely
+          higher to an image containing the detected "Eiffel Tower" than
+          to an image containing a detected distant towering building,
+          even though the confidence that there is a tower in each image
+          may be the same. Range [0, 1].
+      bounding_poly:
+          Image region to which this entity belongs. Not produced for
+          ``LABEL_DETECTION`` features.
+      locations:
+          The location information for the detected entity. Multiple
+          ``LocationInfo`` elements can be present because one location
+          may indicate the location of the scene in the image, and
+          another location may indicate the location of the place where
+          the image was taken. Location information is usually present
+          for landmarks.
+      properties:
+          Some entities may have optional user-supplied ``Property``
+          (name/value) fields, such a score or string that qualifies the
+          entity.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.EntityAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(EntityAnnotation)
+
+LocalizedObjectAnnotation = _reflection.GeneratedProtocolMessageType(
+    "LocalizedObjectAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LOCALIZEDOBJECTANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Set of detected objects with bounding boxes.
+  
+  
+  Attributes:
+      mid:
+          Object ID that should align with EntityAnnotation mid.
+      language_code:
+          The BCP-47 language code, such as "en-US" or "sr-Latn". For
+          more information, see http://www.unicode.org/reports/tr35/#Uni
+          code\_locale\_identifier.
+      name:
+          Object name, expressed in its ``language_code`` language.
+      score:
+          Score of the result. Range [0, 1].
+      bounding_poly:
+          Image region to which this object belongs. This must be
+          populated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.LocalizedObjectAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(LocalizedObjectAnnotation)
+
+SafeSearchAnnotation = _reflection.GeneratedProtocolMessageType(
+    "SafeSearchAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SAFESEARCHANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Set of features pertaining to the image, computed by computer vision
+  methods over safe-search verticals (for example, adult, spoof, medical,
+  violence).
+  
+  
+  Attributes:
+      adult:
+          Represents the adult content likelihood for the image. Adult
+          content may contain elements such as nudity, pornographic
+          images or cartoons, or sexual activities.
+      spoof:
+          Spoof likelihood. The likelihood that an modification was made
+          to the image's canonical version to make it appear funny or
+          offensive.
+      medical:
+          Likelihood that this is a medical image.
+      violence:
+          Likelihood that this image contains violent content.
+      racy:
+          Likelihood that the request image contains racy content. Racy
+          content may include (but is not limited to) skimpy or sheer
+          clothing, strategically covered nudity, lewd or provocative
+          poses, or close-ups of sensitive body areas.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.SafeSearchAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(SafeSearchAnnotation)
+
+LatLongRect = _reflection.GeneratedProtocolMessageType(
+    "LatLongRect",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LATLONGRECT,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Rectangle determined by min and max ``LatLng`` pairs.
+  
+  
+  Attributes:
+      min_lat_lng:
+          Min lat/long pair.
+      max_lat_lng:
+          Max lat/long pair.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.LatLongRect)
+    ),
+)
+_sym_db.RegisterMessage(LatLongRect)
+
+ColorInfo = _reflection.GeneratedProtocolMessageType(
+    "ColorInfo",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_COLORINFO,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Color information consists of RGB channels, score, and the fraction of
+  the image that the color occupies in the image.
+  
+  
+  Attributes:
+      color:
+          RGB components of the color.
+      score:
+          Image-specific score for this color. Value in range [0, 1].
+      pixel_fraction:
+          The fraction of pixels the color occupies in the image. Value
+          in range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ColorInfo)
+    ),
+)
+_sym_db.RegisterMessage(ColorInfo)
+
+DominantColorsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "DominantColorsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DOMINANTCOLORSANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Set of dominant colors and their corresponding scores.
+  
+  
+  Attributes:
+      colors:
+          RGB color values with their score and pixel fraction.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.DominantColorsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(DominantColorsAnnotation)
+
+ImageProperties = _reflection.GeneratedProtocolMessageType(
+    "ImageProperties",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEPROPERTIES,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Stores image properties, such as dominant colors.
+  
+  
+  Attributes:
+      dominant_colors:
+          If present, dominant colors completed successfully.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImageProperties)
+    ),
+)
+_sym_db.RegisterMessage(ImageProperties)
+
+CropHint = _reflection.GeneratedProtocolMessageType(
+    "CropHint",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINT,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Single crop hint that is used to generate a new crop when serving an
+  image.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon for the crop region. The coordinates of
+          the bounding box are in the original image's scale.
+      confidence:
+          Confidence of this being a salient region. Range [0, 1].
+      importance_fraction:
+          Fraction of importance of this salient region with respect to
+          the original image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.CropHint)
+    ),
+)
+_sym_db.RegisterMessage(CropHint)
+
+CropHintsAnnotation = _reflection.GeneratedProtocolMessageType(
+    "CropHintsAnnotation",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Set of crop hints that are used to generate new crops when serving
+  images.
+  
+  
+  Attributes:
+      crop_hints:
+          Crop hint results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.CropHintsAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsAnnotation)
+
+CropHintsParams = _reflection.GeneratedProtocolMessageType(
+    "CropHintsParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CROPHINTSPARAMS,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for crop hints annotation request.
+  
+  
+  Attributes:
+      aspect_ratios:
+          Aspect ratios in floats, representing the ratio of the width
+          to the height of the image. For example, if the desired aspect
+          ratio is 4/3, the corresponding float value should be 1.33333.
+          If not specified, the best possible crop is returned. The
+          number of provided aspect ratios is limited to a maximum of
+          16; any aspect ratios provided after the 16th are ignored.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.CropHintsParams)
+    ),
+)
+_sym_db.RegisterMessage(CropHintsParams)
+
+WebDetectionParams = _reflection.GeneratedProtocolMessageType(
+    "WebDetectionParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WEBDETECTIONPARAMS,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Parameters for web detection request.
+  
+  
+  Attributes:
+      include_geo_results:
+          Whether to include results derived from the geo information in
+          the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.WebDetectionParams)
+    ),
+)
+_sym_db.RegisterMessage(WebDetectionParams)
+
+ImageContext = _reflection.GeneratedProtocolMessageType(
+    "ImageContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGECONTEXT,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Image context and/or feature-specific parameters.
+  
+  
+  Attributes:
+      lat_long_rect:
+          Not used.
+      language_hints:
+          List of languages to use for TEXT\_DETECTION. 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). Text
+          detection returns an error if one or more of the specified
+          languages is not one of the `supported languages
+          </vision/docs/languages>`__.
+      crop_hints_params:
+          Parameters for crop hints annotation request.
+      product_search_params:
+          Parameters for product search.
+      web_detection_params:
+          Parameters for web detection.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImageContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageContext)
+
+AnnotateImageRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Request for performing Google Cloud Vision API tasks over a
+  user-provided image, with user-requested features, and with context
+  information.
+  
+  
+  Attributes:
+      image:
+          The image to be processed.
+      features:
+          Requested features.
+      image_context:
+          Additional context that may accompany the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AnnotateImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageRequest)
+
+ImageAnnotationContext = _reflection.GeneratedProtocolMessageType(
+    "ImageAnnotationContext",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMAGEANNOTATIONCONTEXT,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""If an image was produced from a file (e.g. a PDF), this message gives
+  information about the source of that image.
+  
+  
+  Attributes:
+      uri:
+          The URI of the file used to produce the image.
+      page_number:
+          If the file was a PDF or TIFF, this field gives the page
+          number within the file used to produce the image.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImageAnnotationContext)
+    ),
+)
+_sym_db.RegisterMessage(ImageAnnotationContext)
+
+AnnotateImageResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateImageResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEIMAGERESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an image annotation request.
+  
+  
+  Attributes:
+      face_annotations:
+          If present, face detection has completed successfully.
+      landmark_annotations:
+          If present, landmark detection has completed successfully.
+      logo_annotations:
+          If present, logo detection has completed successfully.
+      label_annotations:
+          If present, label detection has completed successfully.
+      localized_object_annotations:
+          If present, localized object detection has completed
+          successfully. This will be sorted descending by confidence
+          score.
+      text_annotations:
+          If present, text (OCR) detection has completed successfully.
+      full_text_annotation:
+          If present, text (OCR) detection or document (OCR) text
+          detection has completed successfully. This annotation provides
+          the structural hierarchy for the OCR detected text.
+      safe_search_annotation:
+          If present, safe-search annotation has completed successfully.
+      image_properties_annotation:
+          If present, image properties were extracted successfully.
+      crop_hints_annotation:
+          If present, crop hints have completed successfully.
+      web_detection:
+          If present, web detection has completed successfully.
+      product_search_results:
+          If present, product search has completed successfully.
+      error:
+          If set, represents the error message for the operation. Note
+          that filled-in image annotations are guaranteed to be correct,
+          even when ``error`` is set.
+      context:
+          If present, contextual information is needed to understand
+          where this image comes from.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AnnotateImageResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateImageResponse)
+
+AnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a single file annotation request. A file may contain one or
+  more images, which individually have their own responses.
+  
+  
+  Attributes:
+      input_config:
+          Information about the file for which this response is
+          generated.
+      responses:
+          Individual responses to images found within the file.
+      total_pages:
+          This field gives the total number of pages in the file.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateFileResponse)
+
+BatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple image annotation requests are batched into a single service
+  call.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.BatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesRequest)
+
+BatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Response to a batch image annotation request.
+  
+  
+  Attributes:
+      responses:
+          Individual responses to image annotation requests within the
+          batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.BatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateImagesResponse)
+
+AnnotateFileRequest = _reflection.GeneratedProtocolMessageType(
+    "AnnotateFileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ANNOTATEFILEREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""A request to annotate one single file, e.g. a PDF, TIFF or GIF file.
+  
+  
+  Attributes:
+      input_config:
+          Required. Information about the input file.
+      features:
+          Required. Requested features.
+      image_context:
+          Additional context that may accompany the image(s) in the
+          file.
+      pages:
+          Pages of the file to perform image annotation.  Pages starts
+          from 1, we assume the first page of the file is page 1. At
+          most 5 pages are supported per request. Pages can be negative.
+          Page 1 means the first page. Page 2 means the second page.
+          Page -1 means the last page. Page -2 means the second to the
+          last page.  If the file is GIF instead of PDF or TIFF, page
+          refers to GIF frames.  If this field is empty, by default the
+          service performs image annotation for the first 5 pages of the
+          file.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AnnotateFileRequest)
+    ),
+)
+_sym_db.RegisterMessage(AnnotateFileRequest)
+
+BatchAnnotateFilesRequest = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateFilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEFILESREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""A list of requests to annotate files using the BatchAnnotateFiles API.
+  
+  
+  Attributes:
+      requests:
+          The list of file annotation requests. Right now we support
+          only one AnnotateFileRequest in BatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.BatchAnnotateFilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateFilesRequest)
+
+BatchAnnotateFilesResponse = _reflection.GeneratedProtocolMessageType(
+    "BatchAnnotateFilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHANNOTATEFILESRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""A list of file annotation responses.
+  
+  
+  Attributes:
+      responses:
+          The list of file annotation responses, each response
+          corresponding to each AnnotateFileRequest in
+          BatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.BatchAnnotateFilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(BatchAnnotateFilesResponse)
+
+AsyncAnnotateFileRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILEREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""An offline file annotation request.
+  
+  
+  Attributes:
+      input_config:
+          Required. Information about the input file.
+      features:
+          Required. Requested features.
+      image_context:
+          Additional context that may accompany the image(s) in the
+          file.
+      output_config:
+          Required. The desired output location and metadata (e.g.
+          format).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AsyncAnnotateFileRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileRequest)
+
+AsyncAnnotateFileResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncAnnotateFileResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCANNOTATEFILERESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""The response for a single offline file annotation request.
+  
+  
+  Attributes:
+      output_config:
+          The output location and metadata from
+          AsyncAnnotateFileRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AsyncAnnotateFileResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncAnnotateFileResponse)
+
+AsyncBatchAnnotateImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Request for async image annotation for a list of images.
+  
+  
+  Attributes:
+      requests:
+          Individual image annotation requests for this batch.
+      output_config:
+          Required. The desired output location and metadata (e.g.
+          format).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateImagesRequest)
+
+AsyncBatchAnnotateImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an async batch image annotation request.
+  
+  
+  Attributes:
+      output_config:
+          The output location and metadata from
+          AsyncBatchAnnotateImagesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateImagesResponse)
+
+AsyncBatchAnnotateFilesRequest = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Multiple async file annotation requests are batched into a single
+  service call.
+  
+  
+  Attributes:
+      requests:
+          Individual async file annotation requests for this batch.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesRequest)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesRequest)
+
+AsyncBatchAnnotateFilesResponse = _reflection.GeneratedProtocolMessageType(
+    "AsyncBatchAnnotateFilesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ASYNCBATCHANNOTATEFILESRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Response to an async batch file annotation request.
+  
+  
+  Attributes:
+      responses:
+          The list of file annotation responses, one for each request in
+          AsyncBatchAnnotateFilesRequest.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesResponse)
+    ),
+)
+_sym_db.RegisterMessage(AsyncBatchAnnotateFilesResponse)
+
+InputConfig = _reflection.GeneratedProtocolMessageType(
+    "InputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_INPUTCONFIG,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""The desired input location and metadata.
+  
+  
+  Attributes:
+      gcs_source:
+          The Google Cloud Storage location to read the input from.
+      content:
+          File content, represented as a stream of bytes. Note: As with
+          all ``bytes`` fields, protobuffers use a pure binary
+          representation, whereas JSON representations use base64.
+          Currently, this field only works for BatchAnnotateFiles
+          requests. It does not work for AsyncBatchAnnotateFiles
+          requests.
+      mime_type:
+          The type of the file. Currently only "application/pdf" and
+          "image/tiff" are supported. Wildcards are not supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.InputConfig)
+    ),
+)
+_sym_db.RegisterMessage(InputConfig)
+
+OutputConfig = _reflection.GeneratedProtocolMessageType(
+    "OutputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTPUTCONFIG,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""The desired output location and metadata.
+  
+  
+  Attributes:
+      gcs_destination:
+          The Google Cloud Storage location to write the output(s) to.
+      batch_size:
+          The max number of response protos to put into each output JSON
+          file 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 response protos will be
+          generated. If ``batch_size`` = 20, then 5 json files each
+          containing 20 response protos will be written under the prefix
+          ``gcs_destination``.\ ``uri``.  Currently, batch\_size only
+          applies to GcsDestination, with potential future support for
+          other output configurations.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.OutputConfig)
+    ),
+)
+_sym_db.RegisterMessage(OutputConfig)
+
+GcsSource = _reflection.GeneratedProtocolMessageType(
+    "GcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSSOURCE,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the input will be read from.
+  
+  
+  Attributes:
+      uri:
+          Google Cloud Storage URI for the input file. This must only be
+          a Google Cloud Storage object. Wildcards are not currently
+          supported.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.GcsSource)
+    ),
+)
+_sym_db.RegisterMessage(GcsSource)
+
+GcsDestination = _reflection.GeneratedProtocolMessageType(
+    "GcsDestination",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GCSDESTINATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""The Google Cloud Storage location where the output will be written to.
+  
+  
+  Attributes:
+      uri:
+          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 ``/``.  Examples:  -  File: gs://bucket-
+          name/filename.json -  Prefix: gs://bucket-name/prefix/here/ -
+          File: gs://bucket-name/prefix/here  If multiple outputs, each
+          response is still AnnotateFileResponse, each of which contains
+          some subset of the full list of AnnotateImageResponse.
+          Multiple outputs can happen if, for example, the output JSON
+          is too large and overflows into multiple sharded files.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.GcsDestination)
+    ),
+)
+_sym_db.RegisterMessage(GcsDestination)
+
+OperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "OperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OPERATIONMETADATA,
+        __module__="google.cloud.vision_v1p4beta1.proto.image_annotator_pb2",
+        __doc__="""Contains metadata for the BatchAnnotateImages operation.
+  
+  
+  Attributes:
+      state:
+          Current state of the batch operation.
+      create_time:
+          The time when the batch request was received.
+      update_time:
+          The time when the operation result was last updated.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.OperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(OperationMetadata)
+
+
+DESCRIPTOR._options = None
+_ENTITYANNOTATION.fields_by_name["confidence"]._options = None
+
+_IMAGEANNOTATOR = _descriptor.ServiceDescriptor(
+    name="ImageAnnotator",
+    full_name="google.cloud.vision.v1p4beta1.ImageAnnotator",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=8560,
+    serialized_end=9279,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateImages",
+            full_name="google.cloud.vision.v1p4beta1.ImageAnnotator.BatchAnnotateImages",
+            index=0,
+            containing_service=None,
+            input_type=_BATCHANNOTATEIMAGESREQUEST,
+            output_type=_BATCHANNOTATEIMAGESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\037"\032/v1p4beta1/images:annotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="BatchAnnotateFiles",
+            full_name="google.cloud.vision.v1p4beta1.ImageAnnotator.BatchAnnotateFiles",
+            index=1,
+            containing_service=None,
+            input_type=_BATCHANNOTATEFILESREQUEST,
+            output_type=_BATCHANNOTATEFILESRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002\036"\031/v1p4beta1/files:annotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsyncBatchAnnotateImages",
+            full_name="google.cloud.vision.v1p4beta1.ImageAnnotator.AsyncBatchAnnotateImages",
+            index=2,
+            containing_service=None,
+            input_type=_ASYNCBATCHANNOTATEIMAGESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002)"$/v1p4beta1/images:asyncBatchAnnotate:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AsyncBatchAnnotateFiles",
+            full_name="google.cloud.vision.v1p4beta1.ImageAnnotator.AsyncBatchAnnotateFiles",
+            index=3,
+            containing_service=None,
+            input_type=_ASYNCBATCHANNOTATEFILESREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002("#/v1p4beta1/files:asyncBatchAnnotate:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_IMAGEANNOTATOR)
+
+DESCRIPTOR.services_by_name["ImageAnnotator"] = _IMAGEANNOTATOR
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/image_annotator_pb2_grpc.py b/vision/google/cloud/vision_v1p4beta1/proto/image_annotator_pb2_grpc.py
new file mode 100644
index 000000000000..380e78b07975
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/image_annotator_pb2_grpc.py
@@ -0,0 +1,126 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1p4beta1.proto import (
+    image_annotator_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+
+
+class ImageAnnotatorStub(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.BatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ImageAnnotator/BatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.FromString,
+        )
+        self.BatchAnnotateFiles = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ImageAnnotator/BatchAnnotateFiles",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesResponse.FromString,
+        )
+        self.AsyncBatchAnnotateImages = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ImageAnnotator/AsyncBatchAnnotateImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateImagesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+        self.AsyncBatchAnnotateFiles = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ImageAnnotator/AsyncBatchAnnotateFiles",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ImageAnnotatorServicer(object):
+    """Service that performs Google Cloud Vision API detection tasks over client
+  images, such as face, landmark, logo, label, and text detection. The
+  ImageAnnotator service returns detected entities from the images.
+  """
+
+    def BatchAnnotateImages(self, request, context):
+        """Run image detection and annotation for a batch of images.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def BatchAnnotateFiles(self, request, context):
+        """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 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsyncBatchAnnotateImages(self, request, context):
+        """Run asynchronous image detection and annotation for a list of images.
+
+    Progress and results can be retrieved through the
+    `google.longrunning.Operations` interface.
+    `Operation.metadata` contains `OperationMetadata` (metadata).
+    `Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).
+
+    This service will write image annotation outputs to json files in customer
+    GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AsyncBatchAnnotateFiles(self, request, context):
+        """Run asynchronous image detection and annotation for a list of generic
+    files, such as PDF files, which may contain multiple pages and multiple
+    images per page. Progress and results can be retrieved through the
+    `google.longrunning.Operations` interface.
+    `Operation.metadata` contains `OperationMetadata` (metadata).
+    `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ImageAnnotatorServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "BatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateImagesResponse.SerializeToString,
+        ),
+        "BatchAnnotateFiles": grpc.unary_unary_rpc_method_handler(
+            servicer.BatchAnnotateFiles,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.BatchAnnotateFilesResponse.SerializeToString,
+        ),
+        "AsyncBatchAnnotateImages": grpc.unary_unary_rpc_method_handler(
+            servicer.AsyncBatchAnnotateImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateImagesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+        "AsyncBatchAnnotateFiles": grpc.unary_unary_rpc_method_handler(
+            servicer.AsyncBatchAnnotateFiles,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_image__annotator__pb2.AsyncBatchAnnotateFilesRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1p4beta1.ImageAnnotator", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/product_search.proto b/vision/google/cloud/vision_v1p4beta1/proto/product_search.proto
new file mode 100644
index 000000000000..1caf30194f5b
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/product_search.proto
@@ -0,0 +1,102 @@
+// 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.cloud.vision.v1p4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p4beta1/geometry.proto";
+import "google/cloud/vision/v1p4beta1/product_search_service.proto";
+import "google/protobuf/timestamp.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 = "ProductSearchProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+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.
+  BoundingPoly bounding_poly = 9;
+
+  // The resource name of a
+  // [ProductSet][google.cloud.vision.v1p4beta1.ProductSet] to be searched for
+  // similar images.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  string product_set = 6;
+
+  // 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.
+  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.
+  //
+  // For example, "(color = red OR color = blue) AND brand = Google" is
+  // acceptable, but not "(color = red OR brand = Google)" or "color: red".
+  string filter = 8;
+}
+
+// Results for a product search request.
+message ProductSearchResults {
+  // Information about a product.
+  message Result {
+    // The Product.
+    Product product = 1;
+
+    // A confidence level on the match, ranging from 0 (no confidence) to
+    // 1 (full confidence).
+    float score = 2;
+
+    // The resource name of the image from the product that is the closest match
+    // to the query.
+    string image = 3;
+  }
+
+  // Information about the products similar to a single product in a query
+  // image.
+  message GroupedResult {
+    // The bounding polygon around the product detected in the query image.
+    BoundingPoly bounding_poly = 1;
+
+    // List of results, one for each product match.
+    repeated Result results = 2;
+  }
+
+  // Timestamp of the index which provided these results. Changes made after
+  // this time are not reflected in the current results.
+  google.protobuf.Timestamp index_time = 2;
+
+  // List of results, one for each product match.
+  repeated Result results = 5;
+
+  // List of results grouped by products detected in the query image. Each entry
+  // corresponds to one bounding polygon in the query image, and contains the
+  // matching products specific to that region. There may be duplicate product
+  // matches in the union of all the per-product results.
+  repeated GroupedResult product_grouped_results = 6;
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/product_search_pb2.py b/vision/google/cloud/vision_v1p4beta1/proto/product_search_pb2.py
new file mode 100644
index 000000000000..16c545c28b97
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/product_search_pb2.py
@@ -0,0 +1,492 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p4beta1/proto/product_search.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p4beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2,
+)
+from google.cloud.vision_v1p4beta1.proto import (
+    product_search_service_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p4beta1/proto/product_search.proto",
+    package="google.cloud.vision.v1p4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p4beta1B\022ProductSearchProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n8google/cloud/vision_v1p4beta1/proto/product_search.proto\x12\x1dgoogle.cloud.vision.v1p4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p4beta1/proto/geometry.proto\x1a@google/cloud/vision_v1p4beta1/proto/product_search_service.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x9a\x01\n\x13ProductSearchParams\x12\x42\n\rbounding_poly\x18\t \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12\x13\n\x0bproduct_set\x18\x06 \x01(\t\x12\x1a\n\x12product_categories\x18\x07 \x03(\t\x12\x0e\n\x06\x66ilter\x18\x08 \x01(\t"\xfb\x03\n\x14ProductSearchResults\x12.\n\nindex_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12K\n\x07results\x18\x05 \x03(\x0b\x32:.google.cloud.vision.v1p4beta1.ProductSearchResults.Result\x12\x62\n\x17product_grouped_results\x18\x06 \x03(\x0b\x32\x41.google.cloud.vision.v1p4beta1.ProductSearchResults.GroupedResult\x1a_\n\x06Result\x12\x37\n\x07product\x18\x01 \x01(\x0b\x32&.google.cloud.vision.v1p4beta1.Product\x12\r\n\x05score\x18\x02 \x01(\x02\x12\r\n\x05image\x18\x03 \x01(\t\x1a\xa0\x01\n\rGroupedResult\x12\x42\n\rbounding_poly\x18\x01 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12K\n\x07results\x18\x02 \x03(\x0b\x32:.google.cloud.vision.v1p4beta1.ProductSearchResults.ResultB\x88\x01\n!com.google.cloud.vision.v1p4beta1B\x12ProductSearchProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_PRODUCTSEARCHPARAMS = _descriptor.Descriptor(
+    name="ProductSearchParams",
+    full_name="google.cloud.vision.v1p4beta1.ProductSearchParams",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchParams.bounding_poly",
+            index=0,
+            number=9,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchParams.product_set",
+            index=1,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_categories",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchParams.product_categories",
+            index=2,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchParams.filter",
+            index=3,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=273,
+    serialized_end=427,
+)
+
+
+_PRODUCTSEARCHRESULTS_RESULT = _descriptor.Descriptor(
+    name="Result",
+    full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.Result",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.Result.product",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.Result.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="image",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.Result.image",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=679,
+    serialized_end=774,
+)
+
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT = _descriptor.Descriptor(
+    name="GroupedResult",
+    full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.GroupedResult",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="bounding_poly",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.GroupedResult.bounding_poly",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.GroupedResult.results",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=777,
+    serialized_end=937,
+)
+
+_PRODUCTSEARCHRESULTS = _descriptor.Descriptor(
+    name="ProductSearchResults",
+    full_name="google.cloud.vision.v1p4beta1.ProductSearchResults",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="index_time",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.index_time",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="results",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.results",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_grouped_results",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearchResults.product_grouped_results",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRODUCTSEARCHRESULTS_RESULT, _PRODUCTSEARCHRESULTS_GROUPEDRESULT],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=430,
+    serialized_end=937,
+)
+
+_PRODUCTSEARCHPARAMS.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PRODUCTSEARCHRESULTS_RESULT.fields_by_name[
+    "product"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2._PRODUCT
+)
+_PRODUCTSEARCHRESULTS_RESULT.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.fields_by_name[
+    "bounding_poly"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.fields_by_name[
+    "results"
+].message_type = _PRODUCTSEARCHRESULTS_RESULT
+_PRODUCTSEARCHRESULTS_GROUPEDRESULT.containing_type = _PRODUCTSEARCHRESULTS
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "index_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "results"
+].message_type = _PRODUCTSEARCHRESULTS_RESULT
+_PRODUCTSEARCHRESULTS.fields_by_name[
+    "product_grouped_results"
+].message_type = _PRODUCTSEARCHRESULTS_GROUPEDRESULT
+DESCRIPTOR.message_types_by_name["ProductSearchParams"] = _PRODUCTSEARCHPARAMS
+DESCRIPTOR.message_types_by_name["ProductSearchResults"] = _PRODUCTSEARCHRESULTS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ProductSearchParams = _reflection.GeneratedProtocolMessageType(
+    "ProductSearchParams",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSEARCHPARAMS,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_pb2",
+        __doc__="""Parameters for a product search request.
+  
+  
+  Attributes:
+      bounding_poly:
+          The bounding polygon around the area of interest in the image.
+          Optional. If it is not specified, system discretion will be
+          applied.
+      product_set:
+          The resource name of a
+          [ProductSet][google.cloud.vision.v1p4beta1.ProductSet] to be
+          searched for similar images.  Format is: ``projects/PROJECT_ID
+          /locations/LOC_ID/productSets/PRODUCT_SET_ID``.
+      product_categories:
+          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.
+      filter:
+          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.  For example, "(color = red OR
+          color = blue) AND brand = Google" is acceptable, but not
+          "(color = red OR brand = Google)" or "color: red".
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ProductSearchParams)
+    ),
+)
+_sym_db.RegisterMessage(ProductSearchParams)
+
+ProductSearchResults = _reflection.GeneratedProtocolMessageType(
+    "ProductSearchResults",
+    (_message.Message,),
+    dict(
+        Result=_reflection.GeneratedProtocolMessageType(
+            "Result",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_RESULT,
+                __module__="google.cloud.vision_v1p4beta1.proto.product_search_pb2",
+                __doc__="""Information about a product.
+    
+    
+    Attributes:
+        product:
+            The Product.
+        score:
+            A confidence level on the match, ranging from 0 (no
+            confidence) to 1 (full confidence).
+        image:
+            The resource name of the image from the product that is the
+            closest match to the query.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ProductSearchResults.Result)
+            ),
+        ),
+        GroupedResult=_reflection.GeneratedProtocolMessageType(
+            "GroupedResult",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCTSEARCHRESULTS_GROUPEDRESULT,
+                __module__="google.cloud.vision_v1p4beta1.proto.product_search_pb2",
+                __doc__="""Information about the products similar to a single product in a query
+    image.
+    
+    
+    Attributes:
+        bounding_poly:
+            The bounding polygon around the product detected in the query
+            image.
+        results:
+            List of results, one for each product match.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ProductSearchResults.GroupedResult)
+            ),
+        ),
+        DESCRIPTOR=_PRODUCTSEARCHRESULTS,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_pb2",
+        __doc__="""Results for a product search request.
+  
+  
+  Attributes:
+      index_time:
+          Timestamp of the index which provided these results. Changes
+          made after this time are not reflected in the current results.
+      results:
+          List of results, one for each product match.
+      product_grouped_results:
+          List of results grouped by products detected in the query
+          image. Each entry corresponds to one bounding polygon in the
+          query image, and contains the matching products specific to
+          that region. There may be duplicate product matches in the
+          union of all the per-product results.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ProductSearchResults)
+    ),
+)
+_sym_db.RegisterMessage(ProductSearchResults)
+_sym_db.RegisterMessage(ProductSearchResults.Result)
+_sym_db.RegisterMessage(ProductSearchResults.GroupedResult)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/product_search_pb2_grpc.py b/vision/google/cloud/vision_v1p4beta1/proto/product_search_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/product_search_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/product_search_service.proto b/vision/google/cloud/vision_v1p4beta1/proto/product_search_service.proto
new file mode 100644
index 000000000000..3cbc53573f15
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/product_search_service.proto
@@ -0,0 +1,857 @@
+// 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.cloud.vision.v1p4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p4beta1/geometry.proto";
+import "google/longrunning/operations.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;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "ProductSearchServiceProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+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.v1p4beta1.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.v1p4beta1.Product] resources, named
+//   `projects/*/locations/*/products/*`
+//
+// - Each [Product][google.cloud.vision.v1p4beta1.Product] has a collection of
+// [ReferenceImage][google.cloud.vision.v1p4beta1.ReferenceImage] resources,
+// named
+//   `projects/*/locations/*/products/*/referenceImages/*`
+service ProductSearch {
+  // Creates and returns a new ProductSet resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+  //   4096 characters.
+  rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/{parent=projects/*/locations/*}/productSets"
+      body: "product_set"
+    };
+  }
+
+  // Lists ProductSets in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+  //   than 1.
+  rpc ListProductSets(ListProductSetsRequest)
+      returns (ListProductSetsResponse) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{parent=projects/*/locations/*}/productSets"
+    };
+  }
+
+  // Gets information associated with a ProductSet.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  rpc GetProductSet(GetProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}"
+    };
+  }
+
+  // Makes changes to a ProductSet resource.
+  // Only display_name can be updated currently.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the ProductSet does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+  //   missing from the request or longer than 4096 characters.
+  rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet) {
+    option (google.api.http) = {
+      patch: "/v1p4beta1/{product_set.name=projects/*/locations/*/productSets/*}"
+      body: "product_set"
+    };
+  }
+
+  // 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/*}"
+    };
+  }
+
+  // Creates and returns a new product resource.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+  rpc CreateProduct(CreateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/{parent=projects/*/locations/*}/products"
+      body: "product"
+    };
+  }
+
+  // Lists products in an unspecified order.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{parent=projects/*/locations/*}/products"
+    };
+  }
+
+  // Gets information associated with a Product.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  rpc GetProduct(GetProductRequest) returns (Product) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{name=projects/*/locations/*/products/*}"
+    };
+  }
+
+  // Makes changes to a Product resource.
+  // Only the `display_name`, `description`, and `labels` fields can be updated
+  // right now.
+  //
+  // If labels are updated, the change will not be reflected in queries until
+  // the next index time.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product does not exist.
+  // * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+  //   missing from the request or longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if description is present in update_mask but is
+  //   longer than 4096 characters.
+  // * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+  rpc UpdateProduct(UpdateProductRequest) returns (Product) {
+    option (google.api.http) = {
+      patch: "/v1p4beta1/{product.name=projects/*/locations/*/products/*}"
+      body: "product"
+    };
+  }
+
+  // Permanently deletes a product and its reference images.
+  //
+  // 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/*}"
+    };
+  }
+
+  // Creates and returns a new ReferenceImage resource.
+  //
+  // The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+  // the system will try to detect regions of interest in the image that are
+  // compatible with the product_category on the parent product. If it is
+  // specified, detection is ALWAYS skipped. The system converts polygons into
+  // non-rotated rectangles.
+  //
+  // Note that the pipeline will resize the image if the image resolution is too
+  // large to process (above 50MP).
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+  //   characters.
+  // * Returns INVALID_ARGUMENT if the product does not exist.
+  // * 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) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+      body: "reference_image"
+    };
+  }
+
+  // Permanently deletes a reference image.
+  //
+  // The image metadata will be deleted right away, but search queries
+  // against ProductSets containing the image may still work until all related
+  // 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/*}"
+    };
+  }
+
+  // Lists reference images.
+  //
+  // Possible errors:
+  //
+  // * 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) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+    };
+  }
+
+  // Gets information associated with a ReferenceImage.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the specified image does not exist.
+  rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+    };
+  }
+
+  // Adds a Product to the specified ProductSet. If the Product is already
+  // present, no change is made.
+  //
+  // One Product can be added to at most 100 ProductSets.
+  //
+  // Possible errors:
+  //
+  // * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+  rpc AddProductToProductSet(AddProductToProductSetRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}:addProduct"
+      body: "*"
+    };
+  }
+
+  // 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: "*"
+    };
+  }
+
+  // Lists the Products in a ProductSet, in an unspecified order. If the
+  // ProductSet does not exist, the products field of the response will be
+  // empty.
+  //
+  // Possible errors:
+  //
+  // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+  rpc ListProductsInProductSet(ListProductsInProductSetRequest)
+      returns (ListProductsInProductSetResponse) {
+    option (google.api.http) = {
+      get: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}/products"
+    };
+  }
+
+  // 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.
+  // `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.v1p4beta1.ImportProductSetsGcsSource.csv_file_uri].
+  rpc ImportProductSets(ImportProductSetsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/{parent=projects/*/locations/*}/productSets:import"
+      body: "*"
+    };
+  }
+}
+
+// A Product contains ReferenceImages.
+message 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
+    // exceed 128 bytes.
+    string key = 1;
+
+    // The value of the label attached to the product. Cannot be empty and
+    // cannot exceed 128 bytes.
+    string value = 2;
+  }
+
+  // The resource name of the product.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  //
+  // This field is ignored when creating a product.
+  string name = 1;
+
+  // The user-provided name for this Product. Must not be empty. Must be at most
+  // 4096 characters long.
+  string display_name = 2;
+
+  // User-provided metadata to be stored with this product. Must be at most 4096
+  // 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;
+
+  // Key-value pairs that can be attached to a product. At query time,
+  // constraints can be specified based on the product_labels.
+  //
+  // Note that integer values can be provided as strings, e.g. "1199". Only
+  // strings with integer values can match a range-based restriction which is
+  // to be supported soon.
+  //
+  // Multiple values can be assigned to the same key. One product may have up to
+  // 100 product_labels.
+  repeated KeyValue product_labels = 5;
+}
+
+// A ProductSet contains Products. A ProductSet can contain a maximum of 1
+// million reference images. If the limit is exceeded, periodic indexing will
+// fail.
+message ProductSet {
+  // The resource name of the ProductSet.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
+  //
+  // This field is ignored when creating a ProductSet.
+  string name = 1;
+
+  // The user-provided name for this ProductSet. Must not be empty. Must be at
+  // most 4096 characters long.
+  string display_name = 2;
+
+  // Output only. The time at which this ProductSet was last indexed. Query
+  // results will reflect all updates before this time. If this ProductSet has
+  // never been indexed, this timestamp is the default value
+  // "1970-01-01T00:00:00Z".
+  //
+  // This field is ignored when creating a ProductSet.
+  google.protobuf.Timestamp index_time = 3;
+
+  // 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;
+}
+
+// A `ReferenceImage` represents a product image and its associated metadata,
+// such as bounding boxes.
+message ReferenceImage {
+  // The resource name of the reference image.
+  //
+  // Format is:
+  //
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
+  //
+  // This field is ignored when creating a reference image.
+  string name = 1;
+
+  // The Google Cloud Storage URI of the reference image.
+  //
+  // The URI must start with `gs://`.
+  //
+  // Required.
+  string uri = 2;
+
+  // 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
+  // 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;
+}
+
+// Request message for the `CreateProduct` method.
+message CreateProductRequest {
+  // The project in which the Product should be created.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The product to create.
+  Product product = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_id = 3;
+}
+
+// Request message for the `ListProducts` method.
+message ListProductsRequest {
+  // The project OR ProductSet from which Products should be listed.
+  //
+  // Format:
+  // `projects/PROJECT_ID/locations/LOC_ID`
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProducts` method.
+message ListProductsResponse {
+  // List of products.
+  repeated Product products = 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 message for the `GetProduct` method.
+message GetProductRequest {
+  // Resource name of the Product to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProduct` method.
+message UpdateProductRequest {
+  // The Product resource which replaces the one on the server.
+  // product.name is immutable.
+  Product product = 1;
+
+  // 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
+  // `description`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProduct` method.
+message DeleteProductRequest {
+  // Resource name of product to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateProductSet` method.
+message CreateProductSetRequest {
+  // The project in which the ProductSet should be created.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The ProductSet to create.
+  ProductSet product_set = 2;
+
+  // 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
+  // error is returned with code ALREADY_EXISTS. Must be at most 128 characters
+  // long. It cannot contain the character `/`.
+  string product_set_id = 3;
+}
+
+// Request message for the `ListProductSets` method.
+message ListProductSetsRequest {
+  // The project from which ProductSets should be listed.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductSets` method.
+message ListProductSetsResponse {
+  // List of ProductSets.
+  repeated ProductSet product_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;
+}
+
+// Request message for the `GetProductSet` method.
+message GetProductSetRequest {
+  // Resource name of the ProductSet to get.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `UpdateProductSet` method.
+message UpdateProductSetRequest {
+  // The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1;
+
+  // 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 path is `display_name`.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for the `DeleteProductSet` method.
+message DeleteProductSetRequest {
+  // Resource name of the ProductSet to delete.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+}
+
+// Request message for the `CreateReferenceImage` method.
+message CreateReferenceImageRequest {
+  // 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.
+  // If an image ID is specified, it is ignored.
+  ReferenceImage reference_image = 2;
+
+  // 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
+  // already in use, an error is returned with code ALREADY_EXISTS. Must be at
+  // most 128 characters long. It cannot contain the character `/`.
+  string reference_image_id = 3;
+}
+
+// Request message for the `ListReferenceImages` method.
+message ListReferenceImagesRequest {
+  // Resource name of the product containing the reference images.
+  //
+  // Format is
+  // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
+  string parent = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // A token identifying a page of results to be returned. This is the value
+  // of `nextPageToken` returned in a previous reference image list request.
+  //
+  // Defaults to the first page if not specified.
+  string page_token = 3;
+}
+
+// Response message for the `ListReferenceImages` method.
+message ListReferenceImagesResponse {
+  // The list of reference images.
+  repeated ReferenceImage reference_images = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string next_page_token = 3;
+}
+
+// Request message for the `GetReferenceImage` method.
+message GetReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `DeleteReferenceImage` method.
+message DeleteReferenceImageRequest {
+  // 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;
+}
+
+// Request message for the `AddProductToProductSet` method.
+message AddProductToProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `RemoveProductFromProductSet` method.
+message RemoveProductFromProductSetRequest {
+  // The resource name for the ProductSet to modify.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // 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;
+}
+
+// Request message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetRequest {
+  // The ProductSet resource for which to retrieve Products.
+  //
+  // Format is:
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1;
+
+  // The maximum number of items to return. Default 10, maximum 100.
+  int32 page_size = 2;
+
+  // The next_page_token returned from a previous List request, if any.
+  string page_token = 3;
+}
+
+// Response message for the `ListProductsInProductSet` method.
+message ListProductsInProductSetResponse {
+  // The list of Products.
+  repeated Product products = 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 Google Cloud Storage location for a csv file which preserves a list of
+// ImportProductSetRequests in each line.
+message ImportProductSetsGcsSource {
+  // The Google Cloud Storage URI of the input csv file.
+  //
+  // The URI must start with `gs://`.
+  //
+  // The format of the input csv file should be one image per line.
+  // In each line, there are 8 columns.
+  //
+  // 1.  image-uri
+  // 2.  image-id
+  // 3.  product-set-id
+  // 4.  product-id
+  // 5.  product-category
+  // 6.  product-display-name
+  // 7.  labels
+  // 8.  bounding-poly
+  //
+  // The `image-uri`, `product-set-id`, `product-id`, and `product-category`
+  // columns are required. All other columns are optional.
+  //
+  // If the `ProductSet` or `Product` specified by the `product-set-id` and
+  // `product-id` values does not exist, then the system will create a new
+  // `ProductSet` or `Product` for the image. In this case, the
+  // `product-display-name` column refers to
+  // [display_name][google.cloud.vision.v1p4beta1.Product.display_name], the
+  // `product-category` column refers to
+  // [product_category][google.cloud.vision.v1p4beta1.Product.product_category],
+  // and the `labels` column refers to
+  // [product_labels][google.cloud.vision.v1p4beta1.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.v1p4beta1.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`
+  // columns.
+  //
+  // The `labels` column (optional) is a line containing a list of
+  // comma-separated key-value pairs, in the following format:
+  //
+  //     "key_1=value_1,key_2=value_2,...,key_n=value_n"
+  //
+  // The `bounding-poly` column (optional) identifies one region of
+  // interest from the image in the same manner as `CreateReferenceImage`. If
+  // you do not specify the `bounding-poly` column, then the system will try to
+  // detect regions of interest automatically.
+  //
+  // At most one `bounding-poly` column is allowed per line. If the image
+  // contains multiple regions of interest, add a line to the CSV file that
+  // includes the same product information, and the `bounding-poly` values for
+  // each region of interest.
+  //
+  // The `bounding-poly` column must contain an even number of comma-separated
+  // numbers, in the format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Use
+  // non-negative integers for absolute bounding polygons, and float values
+  // in [0, 1] for normalized bounding polygons.
+  //
+  // The system will resize the image if the image resolution is too
+  // large to process (larger than 20MP).
+  string csv_file_uri = 1;
+}
+
+// The input content for the `ImportProductSets` method.
+message ImportProductSetsInputConfig {
+  // The source of the input.
+  oneof source {
+    // The Google Cloud Storage location for a csv file which preserves a list
+    // of ImportProductSetRequests in each line.
+    ImportProductSetsGcsSource gcs_source = 1;
+  }
+}
+
+// Request message for the `ImportProductSets` method.
+message ImportProductSetsRequest {
+  // 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;
+}
+
+// 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.
+message ImportProductSetsResponse {
+  // The list of reference_images that are imported successfully.
+  repeated ReferenceImage reference_images = 1;
+
+  // The rpc status for each ImportProductSet request, including both successes
+  // and errors.
+  //
+  // The number of statuses here matches the number of lines in the csv file,
+  // and statuses[i] stores the success or failure status of processing the i-th
+  // line of the csv, starting from line 0.
+  repeated google.rpc.Status statuses = 2;
+}
+
+// Metadata for the batch operations such as the current state.
+//
+// This is included in the `metadata` field of the `Operation` returned by the
+// `GetOperation` call of the `google::longrunning::Operations` service.
+message BatchOperationMetadata {
+  // Enumerates the possible states that the batch request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is actively being processed.
+    PROCESSING = 1;
+
+    // The request is done and at least one item has been successfully
+    // processed.
+    SUCCESSFUL = 2;
+
+    // The request is done and no item has been successfully processed.
+    FAILED = 3;
+
+    // The request is done after the longrunning.Operations.CancelOperation has
+    // been called by the user.  Any records that were processed before the
+    // cancel command are output as specified in the request.
+    CANCELLED = 4;
+  }
+
+  // The current state of the batch operation.
+  State state = 1;
+
+  // The time when the batch request was submitted to the server.
+  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.protobuf.Timestamp end_time = 3;
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/product_search_service_pb2.py b/vision/google/cloud/vision_v1p4beta1/proto/product_search_service_pb2.py
new file mode 100644
index 000000000000..d3be79d27c5c
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/product_search_service_pb2.py
@@ -0,0 +1,3040 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p4beta1/proto/product_search_service.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p4beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p4beta1/proto/product_search_service.proto",
+    package="google.cloud.vision.v1p4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p4beta1B\031ProductSearchServiceProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n@google/cloud/vision_v1p4beta1/proto/product_search_service.proto\x12\x1dgoogle.cloud.vision.v1p4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p4beta1/proto/geometry.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto"\xcd\x01\n\x07Product\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x18\n\x10product_category\x18\x04 \x01(\t\x12G\n\x0eproduct_labels\x18\x05 \x03(\x0b\x32/.google.cloud.vision.v1p4beta1.Product.KeyValue\x1a&\n\x08KeyValue\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t"\x89\x01\n\nProductSet\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12.\n\nindex_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\'\n\x0bindex_error\x18\x04 \x01(\x0b\x32\x12.google.rpc.Status"p\n\x0eReferenceImage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0b\n\x03uri\x18\x02 \x01(\t\x12\x43\n\x0e\x62ounding_polys\x18\x03 \x03(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly"s\n\x14\x43reateProductRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x37\n\x07product\x18\x02 \x01(\x0b\x32&.google.cloud.vision.v1p4beta1.Product\x12\x12\n\nproduct_id\x18\x03 \x01(\t"L\n\x13ListProductsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"i\n\x14ListProductsResponse\x12\x38\n\x08products\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1p4beta1.Product\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"!\n\x11GetProductRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x80\x01\n\x14UpdateProductRequest\x12\x37\n\x07product\x18\x01 \x01(\x0b\x32&.google.cloud.vision.v1p4beta1.Product\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"$\n\x14\x44\x65leteProductRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x81\x01\n\x17\x43reateProductSetRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12>\n\x0bproduct_set\x18\x02 \x01(\x0b\x32).google.cloud.vision.v1p4beta1.ProductSet\x12\x16\n\x0eproduct_set_id\x18\x03 \x01(\t"O\n\x16ListProductSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"s\n\x17ListProductSetsResponse\x12?\n\x0cproduct_sets\x18\x01 \x03(\x0b\x32).google.cloud.vision.v1p4beta1.ProductSet\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"$\n\x14GetProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x8a\x01\n\x17UpdateProductSetRequest\x12>\n\x0bproduct_set\x18\x01 \x01(\x0b\x32).google.cloud.vision.v1p4beta1.ProductSet\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\'\n\x17\x44\x65leteProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\x91\x01\n\x1b\x43reateReferenceImageRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x46\n\x0freference_image\x18\x02 \x01(\x0b\x32-.google.cloud.vision.v1p4beta1.ReferenceImage\x12\x1a\n\x12reference_image_id\x18\x03 \x01(\t"S\n\x1aListReferenceImagesRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x92\x01\n\x1bListReferenceImagesResponse\x12G\n\x10reference_images\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p4beta1.ReferenceImage\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x17\n\x0fnext_page_token\x18\x03 \x01(\t"(\n\x18GetReferenceImageRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"+\n\x1b\x44\x65leteReferenceImageRequest\x12\x0c\n\x04name\x18\x01 \x01(\t">\n\x1d\x41\x64\x64ProductToProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07product\x18\x02 \x01(\t"C\n"RemoveProductFromProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07product\x18\x02 \x01(\t"V\n\x1fListProductsInProductSetRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"u\n ListProductsInProductSetResponse\x12\x38\n\x08products\x18\x01 \x03(\x0b\x32&.google.cloud.vision.v1p4beta1.Product\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"2\n\x1aImportProductSetsGcsSource\x12\x14\n\x0c\x63sv_file_uri\x18\x01 \x01(\t"y\n\x1cImportProductSetsInputConfig\x12O\n\ngcs_source\x18\x01 \x01(\x0b\x32\x39.google.cloud.vision.v1p4beta1.ImportProductSetsGcsSourceH\x00\x42\x08\n\x06source"}\n\x18ImportProductSetsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12Q\n\x0cinput_config\x18\x02 \x01(\x0b\x32;.google.cloud.vision.v1p4beta1.ImportProductSetsInputConfig"\x8a\x01\n\x19ImportProductSetsResponse\x12G\n\x10reference_images\x18\x01 \x03(\x0b\x32-.google.cloud.vision.v1p4beta1.ReferenceImage\x12$\n\x08statuses\x18\x02 \x03(\x0b\x32\x12.google.rpc.Status"\x9e\x02\n\x16\x42\x61tchOperationMetadata\x12J\n\x05state\x18\x01 \x01(\x0e\x32;.google.cloud.vision.v1p4beta1.BatchOperationMetadata.State\x12/\n\x0bsubmit_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"Y\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0e\n\nPROCESSING\x10\x01\x12\x0e\n\nSUCCESSFUL\x10\x02\x12\n\n\x06\x46\x41ILED\x10\x03\x12\r\n\tCANCELLED\x10\x04\x32\x9f\x1b\n\rProductSearch\x12\xc2\x01\n\x10\x43reateProductSet\x12\x36.google.cloud.vision.v1p4beta1.CreateProductSetRequest\x1a).google.cloud.vision.v1p4beta1.ProductSet"K\x82\xd3\xe4\x93\x02\x45"6/v1p4beta1/{parent=projects/*/locations/*}/productSets:\x0bproduct_set\x12\xc0\x01\n\x0fListProductSets\x12\x35.google.cloud.vision.v1p4beta1.ListProductSetsRequest\x1a\x36.google.cloud.vision.v1p4beta1.ListProductSetsResponse">\x82\xd3\xe4\x93\x02\x38\x12\x36/v1p4beta1/{parent=projects/*/locations/*}/productSets\x12\xaf\x01\n\rGetProductSet\x12\x33.google.cloud.vision.v1p4beta1.GetProductSetRequest\x1a).google.cloud.vision.v1p4beta1.ProductSet">\x82\xd3\xe4\x93\x02\x38\x12\x36/v1p4beta1/{name=projects/*/locations/*/productSets/*}\x12\xce\x01\n\x10UpdateProductSet\x12\x36.google.cloud.vision.v1p4beta1.UpdateProductSetRequest\x1a).google.cloud.vision.v1p4beta1.ProductSet"W\x82\xd3\xe4\x93\x02Q2B/v1p4beta1/{product_set.name=projects/*/locations/*/productSets/*}:\x0bproduct_set\x12\xa2\x01\n\x10\x44\x65leteProductSet\x12\x36.google.cloud.vision.v1p4beta1.DeleteProductSetRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x38*6/v1p4beta1/{name=projects/*/locations/*/productSets/*}\x12\xb2\x01\n\rCreateProduct\x12\x33.google.cloud.vision.v1p4beta1.CreateProductRequest\x1a&.google.cloud.vision.v1p4beta1.Product"D\x82\xd3\xe4\x93\x02>"3/v1p4beta1/{parent=projects/*/locations/*}/products:\x07product\x12\xb4\x01\n\x0cListProducts\x12\x32.google.cloud.vision.v1p4beta1.ListProductsRequest\x1a\x33.google.cloud.vision.v1p4beta1.ListProductsResponse";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1p4beta1/{parent=projects/*/locations/*}/products\x12\xa3\x01\n\nGetProduct\x12\x30.google.cloud.vision.v1p4beta1.GetProductRequest\x1a&.google.cloud.vision.v1p4beta1.Product";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1p4beta1/{name=projects/*/locations/*/products/*}\x12\xba\x01\n\rUpdateProduct\x12\x33.google.cloud.vision.v1p4beta1.UpdateProductRequest\x1a&.google.cloud.vision.v1p4beta1.Product"L\x82\xd3\xe4\x93\x02\x46\x32;/v1p4beta1/{product.name=projects/*/locations/*/products/*}:\x07product\x12\x99\x01\n\rDeleteProduct\x12\x33.google.cloud.vision.v1p4beta1.DeleteProductRequest\x1a\x16.google.protobuf.Empty";\x82\xd3\xe4\x93\x02\x35*3/v1p4beta1/{name=projects/*/locations/*/products/*}\x12\xe1\x01\n\x14\x43reateReferenceImage\x12:.google.cloud.vision.v1p4beta1.CreateReferenceImageRequest\x1a-.google.cloud.vision.v1p4beta1.ReferenceImage"^\x82\xd3\xe4\x93\x02X"E/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages:\x0freference_image\x12\xb9\x01\n\x14\x44\x65leteReferenceImage\x12:.google.cloud.vision.v1p4beta1.DeleteReferenceImageRequest\x1a\x16.google.protobuf.Empty"M\x82\xd3\xe4\x93\x02G*E/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}\x12\xdb\x01\n\x13ListReferenceImages\x12\x39.google.cloud.vision.v1p4beta1.ListReferenceImagesRequest\x1a:.google.cloud.vision.v1p4beta1.ListReferenceImagesResponse"M\x82\xd3\xe4\x93\x02G\x12\x45/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages\x12\xca\x01\n\x11GetReferenceImage\x12\x37.google.cloud.vision.v1p4beta1.GetReferenceImageRequest\x1a-.google.cloud.vision.v1p4beta1.ReferenceImage"M\x82\xd3\xe4\x93\x02G\x12\x45/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}\x12\xbc\x01\n\x16\x41\x64\x64ProductToProductSet\x12<.google.cloud.vision.v1p4beta1.AddProductToProductSetRequest\x1a\x16.google.protobuf.Empty"L\x82\xd3\xe4\x93\x02\x46"A/v1p4beta1/{name=projects/*/locations/*/productSets/*}:addProduct:\x01*\x12\xc9\x01\n\x1bRemoveProductFromProductSet\x12\x41.google.cloud.vision.v1p4beta1.RemoveProductFromProductSetRequest\x1a\x16.google.protobuf.Empty"O\x82\xd3\xe4\x93\x02I"D/v1p4beta1/{name=projects/*/locations/*/productSets/*}:removeProduct:\x01*\x12\xe4\x01\n\x18ListProductsInProductSet\x12>.google.cloud.vision.v1p4beta1.ListProductsInProductSetRequest\x1a?.google.cloud.vision.v1p4beta1.ListProductsInProductSetResponse"G\x82\xd3\xe4\x93\x02\x41\x12?/v1p4beta1/{name=projects/*/locations/*/productSets/*}/products\x12\xb5\x01\n\x11ImportProductSets\x12\x37.google.cloud.vision.v1p4beta1.ImportProductSetsRequest\x1a\x1d.google.longrunning.Operation"H\x82\xd3\xe4\x93\x02\x42"=/v1p4beta1/{parent=projects/*/locations/*}/productSets:import:\x01*B\x8f\x01\n!com.google.cloud.vision.v1p4beta1B\x19ProductSearchServiceProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+        google_dot_longrunning_dot_operations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+        google_dot_rpc_dot_status__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_BATCHOPERATIONMETADATA_STATE = _descriptor.EnumDescriptor(
+    name="State",
+    full_name="google.cloud.vision.v1p4beta1.BatchOperationMetadata.State",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROCESSING", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESSFUL", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANCELLED", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=3307,
+    serialized_end=3396,
+)
+_sym_db.RegisterEnumDescriptor(_BATCHOPERATIONMETADATA_STATE)
+
+
+_PRODUCT_KEYVALUE = _descriptor.Descriptor(
+    name="KeyValue",
+    full_name="google.cloud.vision.v1p4beta1.Product.KeyValue",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="key",
+            full_name="google.cloud.vision.v1p4beta1.Product.KeyValue.key",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.vision.v1p4beta1.Product.KeyValue.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=507,
+    serialized_end=545,
+)
+
+_PRODUCT = _descriptor.Descriptor(
+    name="Product",
+    full_name="google.cloud.vision.v1p4beta1.Product",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.Product.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.vision.v1p4beta1.Product.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p4beta1.Product.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_category",
+            full_name="google.cloud.vision.v1p4beta1.Product.product_category",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_labels",
+            full_name="google.cloud.vision.v1p4beta1.Product.product_labels",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_PRODUCT_KEYVALUE],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=340,
+    serialized_end=545,
+)
+
+
+_PRODUCTSET = _descriptor.Descriptor(
+    name="ProductSet",
+    full_name="google.cloud.vision.v1p4beta1.ProductSet",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.ProductSet.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.vision.v1p4beta1.ProductSet.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_time",
+            full_name="google.cloud.vision.v1p4beta1.ProductSet.index_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="index_error",
+            full_name="google.cloud.vision.v1p4beta1.ProductSet.index_error",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=548,
+    serialized_end=685,
+)
+
+
+_REFERENCEIMAGE = _descriptor.Descriptor(
+    name="ReferenceImage",
+    full_name="google.cloud.vision.v1p4beta1.ReferenceImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.ReferenceImage.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.vision.v1p4beta1.ReferenceImage.uri",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_polys",
+            full_name="google.cloud.vision.v1p4beta1.ReferenceImage.bounding_polys",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=687,
+    serialized_end=799,
+)
+
+
+_CREATEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="CreateProductRequest",
+    full_name="google.cloud.vision.v1p4beta1.CreateProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.CreateProductRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p4beta1.CreateProductRequest.product",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_id",
+            full_name="google.cloud.vision.v1p4beta1.CreateProductRequest.product_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=801,
+    serialized_end=916,
+)
+
+
+_LISTPRODUCTSREQUEST = _descriptor.Descriptor(
+    name="ListProductsRequest",
+    full_name="google.cloud.vision.v1p4beta1.ListProductsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=918,
+    serialized_end=994,
+)
+
+
+_LISTPRODUCTSRESPONSE = _descriptor.Descriptor(
+    name="ListProductsResponse",
+    full_name="google.cloud.vision.v1p4beta1.ListProductsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsResponse.products",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=996,
+    serialized_end=1101,
+)
+
+
+_GETPRODUCTREQUEST = _descriptor.Descriptor(
+    name="GetProductRequest",
+    full_name="google.cloud.vision.v1p4beta1.GetProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.GetProductRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1103,
+    serialized_end=1136,
+)
+
+
+_UPDATEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="UpdateProductRequest",
+    full_name="google.cloud.vision.v1p4beta1.UpdateProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p4beta1.UpdateProductRequest.product",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.vision.v1p4beta1.UpdateProductRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1139,
+    serialized_end=1267,
+)
+
+
+_DELETEPRODUCTREQUEST = _descriptor.Descriptor(
+    name="DeleteProductRequest",
+    full_name="google.cloud.vision.v1p4beta1.DeleteProductRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.DeleteProductRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1269,
+    serialized_end=1305,
+)
+
+
+_CREATEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="CreateProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.CreateProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.CreateProductSetRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1p4beta1.CreateProductSetRequest.product_set",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product_set_id",
+            full_name="google.cloud.vision.v1p4beta1.CreateProductSetRequest.product_set_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1308,
+    serialized_end=1437,
+)
+
+
+_LISTPRODUCTSETSREQUEST = _descriptor.Descriptor(
+    name="ListProductSetsRequest",
+    full_name="google.cloud.vision.v1p4beta1.ListProductSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.ListProductSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p4beta1.ListProductSetsRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListProductSetsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1439,
+    serialized_end=1518,
+)
+
+
+_LISTPRODUCTSETSRESPONSE = _descriptor.Descriptor(
+    name="ListProductSetsResponse",
+    full_name="google.cloud.vision.v1p4beta1.ListProductSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_sets",
+            full_name="google.cloud.vision.v1p4beta1.ListProductSetsResponse.product_sets",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListProductSetsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1520,
+    serialized_end=1635,
+)
+
+
+_GETPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="GetProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.GetProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.GetProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1637,
+    serialized_end=1673,
+)
+
+
+_UPDATEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="UpdateProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.UpdateProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="product_set",
+            full_name="google.cloud.vision.v1p4beta1.UpdateProductSetRequest.product_set",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.vision.v1p4beta1.UpdateProductSetRequest.update_mask",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1676,
+    serialized_end=1814,
+)
+
+
+_DELETEPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="DeleteProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.DeleteProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.DeleteProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1816,
+    serialized_end=1855,
+)
+
+
+_CREATEREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="CreateReferenceImageRequest",
+    full_name="google.cloud.vision.v1p4beta1.CreateReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.CreateReferenceImageRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_image",
+            full_name="google.cloud.vision.v1p4beta1.CreateReferenceImageRequest.reference_image",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reference_image_id",
+            full_name="google.cloud.vision.v1p4beta1.CreateReferenceImageRequest.reference_image_id",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1858,
+    serialized_end=2003,
+)
+
+
+_LISTREFERENCEIMAGESREQUEST = _descriptor.Descriptor(
+    name="ListReferenceImagesRequest",
+    full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2005,
+    serialized_end=2088,
+)
+
+
+_LISTREFERENCEIMAGESRESPONSE = _descriptor.Descriptor(
+    name="ListReferenceImagesResponse",
+    full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference_images",
+            full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesResponse.reference_images",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesResponse.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListReferenceImagesResponse.next_page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2091,
+    serialized_end=2237,
+)
+
+
+_GETREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="GetReferenceImageRequest",
+    full_name="google.cloud.vision.v1p4beta1.GetReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.GetReferenceImageRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2239,
+    serialized_end=2279,
+)
+
+
+_DELETEREFERENCEIMAGEREQUEST = _descriptor.Descriptor(
+    name="DeleteReferenceImageRequest",
+    full_name="google.cloud.vision.v1p4beta1.DeleteReferenceImageRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.DeleteReferenceImageRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2281,
+    serialized_end=2324,
+)
+
+
+_ADDPRODUCTTOPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="AddProductToProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.AddProductToProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.AddProductToProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p4beta1.AddProductToProductSetRequest.product",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2326,
+    serialized_end=2388,
+)
+
+
+_REMOVEPRODUCTFROMPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="RemoveProductFromProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.RemoveProductFromProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.RemoveProductFromProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="product",
+            full_name="google.cloud.vision.v1p4beta1.RemoveProductFromProductSetRequest.product",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2390,
+    serialized_end=2457,
+)
+
+
+_LISTPRODUCTSINPRODUCTSETREQUEST = _descriptor.Descriptor(
+    name="ListProductsInProductSetRequest",
+    full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetRequest.page_size",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2459,
+    serialized_end=2545,
+)
+
+
+_LISTPRODUCTSINPRODUCTSETRESPONSE = _descriptor.Descriptor(
+    name="ListProductsInProductSetResponse",
+    full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="products",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetResponse.products",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.vision.v1p4beta1.ListProductsInProductSetResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2547,
+    serialized_end=2664,
+)
+
+
+_IMPORTPRODUCTSETSGCSSOURCE = _descriptor.Descriptor(
+    name="ImportProductSetsGcsSource",
+    full_name="google.cloud.vision.v1p4beta1.ImportProductSetsGcsSource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="csv_file_uri",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsGcsSource.csv_file_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2666,
+    serialized_end=2716,
+)
+
+
+_IMPORTPRODUCTSETSINPUTCONFIG = _descriptor.Descriptor(
+    name="ImportProductSetsInputConfig",
+    full_name="google.cloud.vision.v1p4beta1.ImportProductSetsInputConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="gcs_source",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsInputConfig.gcs_source",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="source",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsInputConfig.source",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=2718,
+    serialized_end=2839,
+)
+
+
+_IMPORTPRODUCTSETSREQUEST = _descriptor.Descriptor(
+    name="ImportProductSetsRequest",
+    full_name="google.cloud.vision.v1p4beta1.ImportProductSetsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="input_config",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsRequest.input_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2841,
+    serialized_end=2966,
+)
+
+
+_IMPORTPRODUCTSETSRESPONSE = _descriptor.Descriptor(
+    name="ImportProductSetsResponse",
+    full_name="google.cloud.vision.v1p4beta1.ImportProductSetsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="reference_images",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsResponse.reference_images",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="statuses",
+            full_name="google.cloud.vision.v1p4beta1.ImportProductSetsResponse.statuses",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2969,
+    serialized_end=3107,
+)
+
+
+_BATCHOPERATIONMETADATA = _descriptor.Descriptor(
+    name="BatchOperationMetadata",
+    full_name="google.cloud.vision.v1p4beta1.BatchOperationMetadata",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="state",
+            full_name="google.cloud.vision.v1p4beta1.BatchOperationMetadata.state",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="submit_time",
+            full_name="google.cloud.vision.v1p4beta1.BatchOperationMetadata.submit_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.vision.v1p4beta1.BatchOperationMetadata.end_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BATCHOPERATIONMETADATA_STATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=3110,
+    serialized_end=3396,
+)
+
+_PRODUCT_KEYVALUE.containing_type = _PRODUCT
+_PRODUCT.fields_by_name["product_labels"].message_type = _PRODUCT_KEYVALUE
+_PRODUCTSET.fields_by_name[
+    "index_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_PRODUCTSET.fields_by_name[
+    "index_error"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_REFERENCEIMAGE.fields_by_name[
+    "bounding_polys"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_CREATEPRODUCTREQUEST.fields_by_name["product"].message_type = _PRODUCT
+_LISTPRODUCTSRESPONSE.fields_by_name["products"].message_type = _PRODUCT
+_UPDATEPRODUCTREQUEST.fields_by_name["product"].message_type = _PRODUCT
+_UPDATEPRODUCTREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEPRODUCTSETREQUEST.fields_by_name["product_set"].message_type = _PRODUCTSET
+_LISTPRODUCTSETSRESPONSE.fields_by_name["product_sets"].message_type = _PRODUCTSET
+_UPDATEPRODUCTSETREQUEST.fields_by_name["product_set"].message_type = _PRODUCTSET
+_UPDATEPRODUCTSETREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_CREATEREFERENCEIMAGEREQUEST.fields_by_name[
+    "reference_image"
+].message_type = _REFERENCEIMAGE
+_LISTREFERENCEIMAGESRESPONSE.fields_by_name[
+    "reference_images"
+].message_type = _REFERENCEIMAGE
+_LISTPRODUCTSINPRODUCTSETRESPONSE.fields_by_name["products"].message_type = _PRODUCT
+_IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].message_type = _IMPORTPRODUCTSETSGCSSOURCE
+_IMPORTPRODUCTSETSINPUTCONFIG.oneofs_by_name["source"].fields.append(
+    _IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name["gcs_source"]
+)
+_IMPORTPRODUCTSETSINPUTCONFIG.fields_by_name[
+    "gcs_source"
+].containing_oneof = _IMPORTPRODUCTSETSINPUTCONFIG.oneofs_by_name["source"]
+_IMPORTPRODUCTSETSREQUEST.fields_by_name[
+    "input_config"
+].message_type = _IMPORTPRODUCTSETSINPUTCONFIG
+_IMPORTPRODUCTSETSRESPONSE.fields_by_name[
+    "reference_images"
+].message_type = _REFERENCEIMAGE
+_IMPORTPRODUCTSETSRESPONSE.fields_by_name[
+    "statuses"
+].message_type = google_dot_rpc_dot_status__pb2._STATUS
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "state"
+].enum_type = _BATCHOPERATIONMETADATA_STATE
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "submit_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_BATCHOPERATIONMETADATA_STATE.containing_type = _BATCHOPERATIONMETADATA
+DESCRIPTOR.message_types_by_name["Product"] = _PRODUCT
+DESCRIPTOR.message_types_by_name["ProductSet"] = _PRODUCTSET
+DESCRIPTOR.message_types_by_name["ReferenceImage"] = _REFERENCEIMAGE
+DESCRIPTOR.message_types_by_name["CreateProductRequest"] = _CREATEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["ListProductsRequest"] = _LISTPRODUCTSREQUEST
+DESCRIPTOR.message_types_by_name["ListProductsResponse"] = _LISTPRODUCTSRESPONSE
+DESCRIPTOR.message_types_by_name["GetProductRequest"] = _GETPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProductRequest"] = _UPDATEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProductRequest"] = _DELETEPRODUCTREQUEST
+DESCRIPTOR.message_types_by_name["CreateProductSetRequest"] = _CREATEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["ListProductSetsRequest"] = _LISTPRODUCTSETSREQUEST
+DESCRIPTOR.message_types_by_name["ListProductSetsResponse"] = _LISTPRODUCTSETSRESPONSE
+DESCRIPTOR.message_types_by_name["GetProductSetRequest"] = _GETPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["UpdateProductSetRequest"] = _UPDATEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name["DeleteProductSetRequest"] = _DELETEPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "CreateReferenceImageRequest"
+] = _CREATEREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListReferenceImagesRequest"
+] = _LISTREFERENCEIMAGESREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListReferenceImagesResponse"
+] = _LISTREFERENCEIMAGESRESPONSE
+DESCRIPTOR.message_types_by_name["GetReferenceImageRequest"] = _GETREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "DeleteReferenceImageRequest"
+] = _DELETEREFERENCEIMAGEREQUEST
+DESCRIPTOR.message_types_by_name[
+    "AddProductToProductSetRequest"
+] = _ADDPRODUCTTOPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "RemoveProductFromProductSetRequest"
+] = _REMOVEPRODUCTFROMPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListProductsInProductSetRequest"
+] = _LISTPRODUCTSINPRODUCTSETREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListProductsInProductSetResponse"
+] = _LISTPRODUCTSINPRODUCTSETRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsGcsSource"
+] = _IMPORTPRODUCTSETSGCSSOURCE
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsInputConfig"
+] = _IMPORTPRODUCTSETSINPUTCONFIG
+DESCRIPTOR.message_types_by_name["ImportProductSetsRequest"] = _IMPORTPRODUCTSETSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ImportProductSetsResponse"
+] = _IMPORTPRODUCTSETSRESPONSE
+DESCRIPTOR.message_types_by_name["BatchOperationMetadata"] = _BATCHOPERATIONMETADATA
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Product = _reflection.GeneratedProtocolMessageType(
+    "Product",
+    (_message.Message,),
+    dict(
+        KeyValue=_reflection.GeneratedProtocolMessageType(
+            "KeyValue",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_PRODUCT_KEYVALUE,
+                __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+                __doc__="""A product label represented as a key-value pair.
+    
+    
+    Attributes:
+        key:
+            The key of the label attached to the product. Cannot be empty
+            and cannot exceed 128 bytes.
+        value:
+            The value of the label attached to the product. Cannot be
+            empty and cannot exceed 128 bytes.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Product.KeyValue)
+            ),
+        ),
+        DESCRIPTOR=_PRODUCT,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""A Product contains ReferenceImages.
+  
+  
+  Attributes:
+      name:
+          The resource name of the product.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+          This field is ignored when creating a product.
+      display_name:
+          The user-provided name for this Product. Must not be empty.
+          Must be at most 4096 characters long.
+      description:
+          User-provided metadata to be stored with this product. Must be
+          at most 4096 characters long.
+      product_category:
+          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.
+      product_labels:
+          Key-value pairs that can be attached to a product. At query
+          time, constraints can be specified based on the
+          product\_labels.  Note that integer values can be provided as
+          strings, e.g. "1199". Only strings with integer values can
+          match a range-based restriction which is to be supported soon.
+          Multiple values can be assigned to the same key. One product
+          may have up to 100 product\_labels.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Product)
+    ),
+)
+_sym_db.RegisterMessage(Product)
+_sym_db.RegisterMessage(Product.KeyValue)
+
+ProductSet = _reflection.GeneratedProtocolMessageType(
+    "ProductSet",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PRODUCTSET,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""A ProductSet contains Products. A ProductSet can contain a maximum of 1
+  million reference images. If the limit is exceeded, periodic indexing
+  will fail.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ProductSet.  Format is: ``projects/PR
+          OJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``.  This
+          field is ignored when creating a ProductSet.
+      display_name:
+          The user-provided name for this ProductSet. Must not be empty.
+          Must be at most 4096 characters long.
+      index_time:
+          Output only. The time at which this ProductSet was last
+          indexed. Query results will reflect all updates before this
+          time. If this ProductSet has never been indexed, this
+          timestamp is the default value "1970-01-01T00:00:00Z".  This
+          field is ignored when creating a ProductSet.
+      index_error:
+          Output only. If there was an error with indexing the product
+          set, the field is populated.  This field is ignored when
+          creating a ProductSet.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ProductSet)
+    ),
+)
+_sym_db.RegisterMessage(ProductSet)
+
+ReferenceImage = _reflection.GeneratedProtocolMessageType(
+    "ReferenceImage",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REFERENCEIMAGE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""A ``ReferenceImage`` represents a product image and its associated
+  metadata, such as bounding boxes.
+  
+  
+  Attributes:
+      name:
+          The resource name of the reference image.  Format is:  ``proje
+          cts/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceI
+          mages/IMAGE_ID``.  This field is ignored when creating a
+          reference image.
+      uri:
+          The Google Cloud Storage URI of the reference image.  The URI
+          must start with ``gs://``.  Required.
+      bounding_polys:
+          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 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).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ReferenceImage)
+    ),
+)
+_sym_db.RegisterMessage(ReferenceImage)
+
+CreateProductRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateProduct`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the Product should be created.  Format is
+          ``projects/PROJECT_ID/locations/LOC_ID``.
+      product:
+          The product to create.
+      product_id:
+          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 error is returned with code
+          ALREADY\_EXISTS. Must be at most 128 characters long. It
+          cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.CreateProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProductRequest)
+
+ListProductsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProducts`` method.
+  
+  
+  Attributes:
+      parent:
+          The project OR ProductSet from which Products should be
+          listed.  Format: ``projects/PROJECT_ID/locations/LOC_ID``
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListProductsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsRequest)
+
+ListProductsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProducts`` method.
+  
+  
+  Attributes:
+      products:
+          List of products.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListProductsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsResponse)
+
+GetProductRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetProduct`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the Product to get.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.GetProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProductRequest)
+
+UpdateProductRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``UpdateProduct`` method.
+  
+  
+  Attributes:
+      product:
+          The Product resource which replaces the one on the server.
+          product.name is immutable.
+      update_mask:
+          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 ``description``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.UpdateProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProductRequest)
+
+DeleteProductRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProductRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPRODUCTREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteProduct`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of product to delete.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.DeleteProductRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProductRequest)
+
+CreateProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateProductSet`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the ProductSet should be created.  Format
+          is ``projects/PROJECT_ID/locations/LOC_ID``.
+      product_set:
+          The ProductSet to create.
+      product_set_id:
+          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 error is returned with code
+          ALREADY\_EXISTS. Must be at most 128 characters long. It
+          cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.CreateProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateProductSetRequest)
+
+ListProductSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSETSREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProductSets`` method.
+  
+  
+  Attributes:
+      parent:
+          The project from which ProductSets should be listed.  Format
+          is ``projects/PROJECT_ID/locations/LOC_ID``.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListProductSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductSetsRequest)
+
+ListProductSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSETSRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProductSets`` method.
+  
+  
+  Attributes:
+      product_sets:
+          List of ProductSets.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListProductSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductSetsResponse)
+
+GetProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "GetProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the ProductSet to get.  Format is: ``projects
+          /PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.GetProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetProductSetRequest)
+
+UpdateProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``UpdateProductSet`` method.
+  
+  
+  Attributes:
+      product_set:
+          The ProductSet resource which replaces the one on the server.
+      update_mask:
+          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 path is
+          ``display_name``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.UpdateProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateProductSetRequest)
+
+DeleteProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          Resource name of the ProductSet to delete.  Format is: ``proje
+          cts/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.DeleteProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteProductSetRequest)
+
+CreateReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATEREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``CreateReferenceImage`` method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the product in which to create the reference
+          image.  Format is
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+      reference_image:
+          The reference image to create. If an image ID is specified, it
+          is ignored.
+      reference_image_id:
+          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 already in use, an error is returned
+          with code ALREADY\_EXISTS. Must be at most 128 characters
+          long. It cannot contain the character ``/``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.CreateReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateReferenceImageRequest)
+
+ListReferenceImagesRequest = _reflection.GeneratedProtocolMessageType(
+    "ListReferenceImagesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTREFERENCEIMAGESREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListReferenceImages`` method.
+  
+  
+  Attributes:
+      parent:
+          Resource name of the product containing the reference images.
+          Format is
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          A token identifying a page of results to be returned. This is
+          the value of ``nextPageToken`` returned in a previous
+          reference image list request.  Defaults to the first page if
+          not specified.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListReferenceImagesRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListReferenceImagesRequest)
+
+ListReferenceImagesResponse = _reflection.GeneratedProtocolMessageType(
+    "ListReferenceImagesResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTREFERENCEIMAGESRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListReferenceImages`` method.
+  
+  
+  Attributes:
+      reference_images:
+          The list of reference images.
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      next_page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListReferenceImagesResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListReferenceImagesResponse)
+
+GetReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "GetReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``GetReferenceImage`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ReferenceImage to get.  Format is:  `
+          `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/refe
+          renceImages/IMAGE_ID``.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.GetReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetReferenceImageRequest)
+
+DeleteReferenceImageRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteReferenceImageRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETEREFERENCEIMAGEREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``DeleteReferenceImage`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name of the reference image to delete.  Format
+          is:  ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_I
+          D/referenceImages/IMAGE_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.DeleteReferenceImageRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteReferenceImageRequest)
+
+AddProductToProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "AddProductToProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_ADDPRODUCTTOPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``AddProductToProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name for the ProductSet to modify.  Format is: ``
+          projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_I
+          D``
+      product:
+          The resource name for the Product to be added to this
+          ProductSet.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.AddProductToProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(AddProductToProductSetRequest)
+
+RemoveProductFromProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "RemoveProductFromProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_REMOVEPRODUCTFROMPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``RemoveProductFromProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The resource name for the ProductSet to modify.  Format is: ``
+          projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_I
+          D``
+      product:
+          The resource name for the Product to be removed from this
+          ProductSet.  Format is:
+          ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID``
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.RemoveProductFromProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(RemoveProductFromProductSetRequest)
+
+ListProductsInProductSetRequest = _reflection.GeneratedProtocolMessageType(
+    "ListProductsInProductSetRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSINPRODUCTSETREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ListProductsInProductSet`` method.
+  
+  
+  Attributes:
+      name:
+          The ProductSet resource for which to retrieve Products.
+          Format is: ``projects/PROJECT_ID/locations/LOC_ID/productSets/
+          PRODUCT_SET_ID``
+      page_size:
+          The maximum number of items to return. Default 10, maximum
+          100.
+      page_token:
+          The next\_page\_token returned from a previous List request,
+          if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListProductsInProductSetRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsInProductSetRequest)
+
+ListProductsInProductSetResponse = _reflection.GeneratedProtocolMessageType(
+    "ListProductsInProductSetResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTPRODUCTSINPRODUCTSETRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Response message for the ``ListProductsInProductSet`` method.
+  
+  
+  Attributes:
+      products:
+          The list of Products.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ListProductsInProductSetResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListProductsInProductSetResponse)
+
+ImportProductSetsGcsSource = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsGcsSource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSGCSSOURCE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""The Google Cloud Storage location for a csv file which preserves a list
+  of ImportProductSetRequests in each line.
+  
+  
+  Attributes:
+      csv_file_uri:
+          The Google Cloud Storage URI of the input csv file.  The URI
+          must start with ``gs://``.  The format of the input csv file
+          should be one image per line. In each line, there are 8
+          columns.  1. image-uri 2. image-id 3. product-set-id 4.
+          product-id 5. product-category 6. product-display-name 7.
+          labels 8. bounding-poly  The ``image-uri``, ``product-set-
+          id``, ``product-id``, and ``product-category`` columns are
+          required. All other columns are optional.  If the
+          ``ProductSet`` or ``Product`` specified by the ``product-set-
+          id`` and ``product-id`` values does not exist, then the system
+          will create a new ``ProductSet`` or ``Product`` for the image.
+          In this case, the ``product-display-name`` column refers to [d
+          isplay\_name][google.cloud.vision.v1p4beta1.Product.display\_n
+          ame], the ``product-category`` column refers to [product\_cate
+          gory][google.cloud.vision.v1p4beta1.Product.product\_category]
+          , and the ``labels`` column refers to [product\_labels][google
+          .cloud.vision.v1p4beta1.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\_nam
+          e][google.cloud.vision.v1p4beta1.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`` columns.  The ``labels`` column
+          (optional) is a line containing a list of comma-separated key-
+          value pairs, in the following format:  ::
+          "key_1=value_1,key_2=value_2,...,key_n=value_n"  The
+          ``bounding-poly`` column (optional) identifies one region of
+          interest from the image in the same manner as
+          ``CreateReferenceImage``. If you do not specify the
+          ``bounding-poly`` column, then the system will try to detect
+          regions of interest automatically.  At most one ``bounding-
+          poly`` column is allowed per line. If the image contains
+          multiple regions of interest, add a line to the CSV file that
+          includes the same product information, and the ``bounding-
+          poly`` values for each region of interest.  The ``bounding-
+          poly`` column must contain an even number of comma-separated
+          numbers, in the format
+          "p1\_x,p1\_y,p2\_x,p2\_y,...,pn\_x,pn\_y". Use non-negative
+          integers for absolute bounding polygons, and float values in
+          [0, 1] for normalized bounding polygons.  The system will
+          resize the image if the image resolution is too large to
+          process (larger than 20MP).
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImportProductSetsGcsSource)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsGcsSource)
+
+ImportProductSetsInputConfig = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsInputConfig",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSINPUTCONFIG,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""The input content for the ``ImportProductSets`` method.
+  
+  
+  Attributes:
+      source:
+          The source of the input.
+      gcs_source:
+          The Google Cloud Storage location for a csv file which
+          preserves a list of ImportProductSetRequests in each line.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImportProductSetsInputConfig)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsInputConfig)
+
+ImportProductSetsRequest = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSREQUEST,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Request message for the ``ImportProductSets`` method.
+  
+  
+  Attributes:
+      parent:
+          The project in which the ProductSets should be imported.
+          Format is ``projects/PROJECT_ID/locations/LOC_ID``.
+      input_config:
+          The input content for the list of requests.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImportProductSetsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsRequest)
+
+ImportProductSetsResponse = _reflection.GeneratedProtocolMessageType(
+    "ImportProductSetsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_IMPORTPRODUCTSETSRESPONSE,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      reference_images:
+          The list of reference\_images that are imported successfully.
+      statuses:
+          The rpc status for each ImportProductSet request, including
+          both successes and errors.  The number of statuses here
+          matches the number of lines in the csv file, and statuses[i]
+          stores the success or failure status of processing the i-th
+          line of the csv, starting from line 0.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.ImportProductSetsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ImportProductSetsResponse)
+
+BatchOperationMetadata = _reflection.GeneratedProtocolMessageType(
+    "BatchOperationMetadata",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BATCHOPERATIONMETADATA,
+        __module__="google.cloud.vision_v1p4beta1.proto.product_search_service_pb2",
+        __doc__="""Metadata for the batch operations such as the current state.
+  
+  This is included in the ``metadata`` field of the ``Operation`` returned
+  by the ``GetOperation`` call of the ``google::longrunning::Operations``
+  service.
+  
+  
+  Attributes:
+      state:
+          The current state of the batch operation.
+      submit_time:
+          The time when the batch request was submitted to the server.
+      end_time:
+          The time when the batch request is finished and [google.longru
+          nning.Operation.done][google.longrunning.Operation.done] is
+          set to true.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.BatchOperationMetadata)
+    ),
+)
+_sym_db.RegisterMessage(BatchOperationMetadata)
+
+
+DESCRIPTOR._options = None
+
+_PRODUCTSEARCH = _descriptor.ServiceDescriptor(
+    name="ProductSearch",
+    full_name="google.cloud.vision.v1p4beta1.ProductSearch",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=3399,
+    serialized_end=6886,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.CreateProductSet",
+            index=0,
+            containing_service=None,
+            input_type=_CREATEPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                '\202\323\344\223\002E"6/v1p4beta1/{parent=projects/*/locations/*}/productSets:\013product_set'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProductSets",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.ListProductSets",
+            index=1,
+            containing_service=None,
+            input_type=_LISTPRODUCTSETSREQUEST,
+            output_type=_LISTPRODUCTSETSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0028\0226/v1p4beta1/{parent=projects/*/locations/*}/productSets"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.GetProductSet",
+            index=2,
+            containing_service=None,
+            input_type=_GETPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                "\202\323\344\223\0028\0226/v1p4beta1/{name=projects/*/locations/*/productSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.UpdateProductSet",
+            index=3,
+            containing_service=None,
+            input_type=_UPDATEPRODUCTSETREQUEST,
+            output_type=_PRODUCTSET,
+            serialized_options=_b(
+                "\202\323\344\223\002Q2B/v1p4beta1/{product_set.name=projects/*/locations/*/productSets/*}:\013product_set"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.DeleteProductSet",
+            index=4,
+            containing_service=None,
+            input_type=_DELETEPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0028*6/v1p4beta1/{name=projects/*/locations/*/productSets/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateProduct",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.CreateProduct",
+            index=5,
+            containing_service=None,
+            input_type=_CREATEPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                '\202\323\344\223\002>"3/v1p4beta1/{parent=projects/*/locations/*}/products:\007product'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProducts",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.ListProducts",
+            index=6,
+            containing_service=None,
+            input_type=_LISTPRODUCTSREQUEST,
+            output_type=_LISTPRODUCTSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1p4beta1/{parent=projects/*/locations/*}/products"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetProduct",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.GetProduct",
+            index=7,
+            containing_service=None,
+            input_type=_GETPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1p4beta1/{name=projects/*/locations/*/products/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateProduct",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.UpdateProduct",
+            index=8,
+            containing_service=None,
+            input_type=_UPDATEPRODUCTREQUEST,
+            output_type=_PRODUCT,
+            serialized_options=_b(
+                "\202\323\344\223\002F2;/v1p4beta1/{product.name=projects/*/locations/*/products/*}:\007product"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteProduct",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.DeleteProduct",
+            index=9,
+            containing_service=None,
+            input_type=_DELETEPRODUCTREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\0025*3/v1p4beta1/{name=projects/*/locations/*/products/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="CreateReferenceImage",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.CreateReferenceImage",
+            index=10,
+            containing_service=None,
+            input_type=_CREATEREFERENCEIMAGEREQUEST,
+            output_type=_REFERENCEIMAGE,
+            serialized_options=_b(
+                '\202\323\344\223\002X"E/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages:\017reference_image'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteReferenceImage",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.DeleteReferenceImage",
+            index=11,
+            containing_service=None,
+            input_type=_DELETEREFERENCEIMAGEREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002G*E/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListReferenceImages",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.ListReferenceImages",
+            index=12,
+            containing_service=None,
+            input_type=_LISTREFERENCEIMAGESREQUEST,
+            output_type=_LISTREFERENCEIMAGESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002G\022E/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetReferenceImage",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.GetReferenceImage",
+            index=13,
+            containing_service=None,
+            input_type=_GETREFERENCEIMAGEREQUEST,
+            output_type=_REFERENCEIMAGE,
+            serialized_options=_b(
+                "\202\323\344\223\002G\022E/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="AddProductToProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.AddProductToProductSet",
+            index=14,
+            containing_service=None,
+            input_type=_ADDPRODUCTTOPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002F"A/v1p4beta1/{name=projects/*/locations/*/productSets/*}:addProduct:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="RemoveProductFromProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.RemoveProductFromProductSet",
+            index=15,
+            containing_service=None,
+            input_type=_REMOVEPRODUCTFROMPRODUCTSETREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                '\202\323\344\223\002I"D/v1p4beta1/{name=projects/*/locations/*/productSets/*}:removeProduct:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListProductsInProductSet",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.ListProductsInProductSet",
+            index=16,
+            containing_service=None,
+            input_type=_LISTPRODUCTSINPRODUCTSETREQUEST,
+            output_type=_LISTPRODUCTSINPRODUCTSETRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002A\022?/v1p4beta1/{name=projects/*/locations/*/productSets/*}/products"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ImportProductSets",
+            full_name="google.cloud.vision.v1p4beta1.ProductSearch.ImportProductSets",
+            index=17,
+            containing_service=None,
+            input_type=_IMPORTPRODUCTSETSREQUEST,
+            output_type=google_dot_longrunning_dot_operations__pb2._OPERATION,
+            serialized_options=_b(
+                '\202\323\344\223\002B"=/v1p4beta1/{parent=projects/*/locations/*}/productSets:import:\001*'
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_PRODUCTSEARCH)
+
+DESCRIPTOR.services_by_name["ProductSearch"] = _PRODUCTSEARCH
+
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/product_search_service_pb2_grpc.py b/vision/google/cloud/vision_v1p4beta1/proto/product_search_service_pb2_grpc.py
new file mode 100644
index 000000000000..de2ba5996cb5
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/product_search_service_pb2_grpc.py
@@ -0,0 +1,506 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.vision_v1p4beta1.proto import (
+    product_search_service_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2,
+)
+from google.longrunning import (
+    operations_pb2 as google_dot_longrunning_dot_operations__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class ProductSearchStub(object):
+    """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.v1p4beta1.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.v1p4beta1.Product] resources, named
+  `projects/*/locations/*/products/*`
+
+  - Each [Product][google.cloud.vision.v1p4beta1.Product] has a collection of
+  [ReferenceImage][google.cloud.vision.v1p4beta1.ReferenceImage] resources,
+  named
+  `projects/*/locations/*/products/*/referenceImages/*`
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/CreateProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.CreateProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.ListProductSets = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/ListProductSets",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsResponse.FromString,
+        )
+        self.GetProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/GetProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.GetProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.UpdateProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/UpdateProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.UpdateProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ProductSet.FromString,
+        )
+        self.DeleteProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/DeleteProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DeleteProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/CreateProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.CreateProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.ListProducts = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/ListProducts",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsResponse.FromString,
+        )
+        self.GetProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/GetProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.GetProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.UpdateProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/UpdateProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.UpdateProductRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.Product.FromString,
+        )
+        self.DeleteProduct = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/DeleteProduct",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DeleteProductRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.CreateReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/CreateReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.CreateReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.FromString,
+        )
+        self.DeleteReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/DeleteReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DeleteReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListReferenceImages = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/ListReferenceImages",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesResponse.FromString,
+        )
+        self.GetReferenceImage = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/GetReferenceImage",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.GetReferenceImageRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.FromString,
+        )
+        self.AddProductToProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/AddProductToProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.AddProductToProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.RemoveProductFromProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/RemoveProductFromProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.RemoveProductFromProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.ListProductsInProductSet = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/ListProductsInProductSet",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetResponse.FromString,
+        )
+        self.ImportProductSets = channel.unary_unary(
+            "/google.cloud.vision.v1p4beta1.ProductSearch/ImportProductSets",
+            request_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ImportProductSetsRequest.SerializeToString,
+            response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString,
+        )
+
+
+class ProductSearchServicer(object):
+    """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.v1p4beta1.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.v1p4beta1.Product] resources, named
+  `projects/*/locations/*/products/*`
+
+  - Each [Product][google.cloud.vision.v1p4beta1.Product] has a collection of
+  [ReferenceImage][google.cloud.vision.v1p4beta1.ReferenceImage] resources,
+  named
+  `projects/*/locations/*/products/*/referenceImages/*`
+  """
+
+    def CreateProductSet(self, request, context):
+        """Creates and returns a new ProductSet resource.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if display_name is missing, or is longer than
+    4096 characters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProductSets(self, request, context):
+        """Lists ProductSets in an unspecified order.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
+    than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProductSet(self, request, context):
+        """Gets information associated with a ProductSet.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProductSet(self, request, context):
+        """Makes changes to a ProductSet resource.
+    Only display_name can be updated currently.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the ProductSet does not exist.
+    * Returns INVALID_ARGUMENT if display_name is present in update_mask but
+    missing from the request or longer than 4096 characters.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProductSet(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateProduct(self, request, context):
+        """Creates and returns a new product resource.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096
+    characters.
+    * Returns INVALID_ARGUMENT if description is longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if product_category is missing or invalid.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProducts(self, request, context):
+        """Lists products in an unspecified order.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetProduct(self, request, context):
+        """Gets information associated with a Product.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateProduct(self, request, context):
+        """Makes changes to a Product resource.
+    Only the `display_name`, `description`, and `labels` fields can be updated
+    right now.
+
+    If labels are updated, the change will not be reflected in queries until
+    the next index time.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product does not exist.
+    * Returns INVALID_ARGUMENT if display_name is present in update_mask but is
+    missing from the request or longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if description is present in update_mask but is
+    longer than 4096 characters.
+    * Returns INVALID_ARGUMENT if product_category is present in update_mask.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteProduct(self, request, context):
+        """Permanently deletes a product and its reference images.
+
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def CreateReferenceImage(self, request, context):
+        """Creates and returns a new ReferenceImage resource.
+
+    The `bounding_poly` field is optional. If `bounding_poly` is not specified,
+    the system will try to detect regions of interest in the image that are
+    compatible with the product_category on the parent product. If it is
+    specified, detection is ALWAYS skipped. The system converts polygons into
+    non-rotated rectangles.
+
+    Note that the pipeline will resize the image if the image resolution is too
+    large to process (above 50MP).
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if the image_uri is missing or longer than 4096
+    characters.
+    * Returns INVALID_ARGUMENT if the product does not exist.
+    * 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteReferenceImage(self, request, context):
+        """Permanently deletes a reference image.
+
+    The image metadata will be deleted right away, but search queries
+    against ProductSets containing the image may still work until all related
+    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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListReferenceImages(self, request, context):
+        """Lists reference images.
+
+    Possible errors:
+
+    * 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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetReferenceImage(self, request, context):
+        """Gets information associated with a ReferenceImage.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the specified image does not exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def AddProductToProductSet(self, request, context):
+        """Adds a Product to the specified ProductSet. If the Product is already
+    present, no change is made.
+
+    One Product can be added to at most 100 ProductSets.
+
+    Possible errors:
+
+    * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def RemoveProductFromProductSet(self, request, context):
+        """Removes a Product from the specified ProductSet.
+
+    Possible errors:
+
+    * Returns NOT_FOUND If the Product is not found under the ProductSet.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListProductsInProductSet(self, request, context):
+        """Lists the Products in a ProductSet, in an unspecified order. If the
+    ProductSet does not exist, the products field of the response will be
+    empty.
+
+    Possible errors:
+
+    * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ImportProductSets(self, request, context):
+        """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.
+    `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.v1p4beta1.ImportProductSetsGcsSource.csv_file_uri].
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_ProductSearchServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.CreateProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "ListProductSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProductSets,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductSetsResponse.SerializeToString,
+        ),
+        "GetProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.GetProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "UpdateProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.UpdateProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ProductSet.SerializeToString,
+        ),
+        "DeleteProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DeleteProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.CreateProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "ListProducts": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProducts,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsResponse.SerializeToString,
+        ),
+        "GetProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.GetProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.GetProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "UpdateProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.UpdateProductRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.Product.SerializeToString,
+        ),
+        "DeleteProduct": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteProduct,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DeleteProductRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "CreateReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.CreateReferenceImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.SerializeToString,
+        ),
+        "DeleteReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.DeleteReferenceImageRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListReferenceImages": grpc.unary_unary_rpc_method_handler(
+            servicer.ListReferenceImages,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListReferenceImagesResponse.SerializeToString,
+        ),
+        "GetReferenceImage": grpc.unary_unary_rpc_method_handler(
+            servicer.GetReferenceImage,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.GetReferenceImageRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ReferenceImage.SerializeToString,
+        ),
+        "AddProductToProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.AddProductToProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.AddProductToProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "RemoveProductFromProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.RemoveProductFromProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.RemoveProductFromProductSetRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "ListProductsInProductSet": grpc.unary_unary_rpc_method_handler(
+            servicer.ListProductsInProductSet,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetRequest.FromString,
+            response_serializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ListProductsInProductSetResponse.SerializeToString,
+        ),
+        "ImportProductSets": grpc.unary_unary_rpc_method_handler(
+            servicer.ImportProductSets,
+            request_deserializer=google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_product__search__service__pb2.ImportProductSetsRequest.FromString,
+            response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.vision.v1p4beta1.ProductSearch", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/text_annotation.proto b/vision/google/cloud/vision_v1p4beta1/proto/text_annotation.proto
new file mode 100644
index 000000000000..542677f271e3
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/text_annotation.proto
@@ -0,0 +1,261 @@
+// 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.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 = "TextAnnotationProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+option objc_class_prefix = "GCVN";
+
+// TextAnnotation contains a structured representation of OCR extracted text.
+// The hierarchy of an OCR extracted text structure is like this:
+//     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.v1p4beta1.TextAnnotation.TextProperty]
+// message definition below for more detail.
+message TextAnnotation {
+  // 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;
+  }
+
+  // Detected start or end of a structural component.
+  message DetectedBreak {
+    // Enum to denote the type of break found. New line, space etc.
+    enum BreakType {
+      // Unknown break label type.
+      UNKNOWN = 0;
+
+      // Regular space.
+      SPACE = 1;
+
+      // Sure space (very wide).
+      SURE_SPACE = 2;
+
+      // Line-wrapping break.
+      EOL_SURE_SPACE = 3;
+
+      // End-line hyphen that is not present in text; does not co-occur with
+      // `SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.
+      HYPHEN = 4;
+
+      // Line break that ends a paragraph.
+      LINE_BREAK = 5;
+    }
+
+    // Detected break type.
+    BreakType type = 1;
+
+    // True if break prepends the element.
+    bool is_prefix = 2;
+  }
+
+  // Additional information detected on the structural component.
+  message TextProperty {
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 1;
+
+    // Detected start or end of a text segment.
+    DetectedBreak detected_break = 2;
+  }
+
+  // List of pages detected by OCR.
+  repeated Page pages = 1;
+
+  // UTF-8 text detected on the pages.
+  string text = 2;
+}
+
+// Detected page from OCR.
+message Page {
+  // Additional information detected on the page.
+  TextAnnotation.TextProperty property = 1;
+
+  // Page width. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 width = 2;
+
+  // Page height. For PDFs the unit is points. For images (including
+  // TIFFs) the unit is pixels.
+  int32 height = 3;
+
+  // List of blocks of text, images etc on this page.
+  repeated Block blocks = 4;
+
+  // Confidence of the OCR results on the page. Range [0, 1].
+  float confidence = 5;
+}
+
+// Logical element on the page.
+message Block {
+  // Type of a block (text, image etc) as identified by OCR.
+  enum BlockType {
+    // Unknown block type.
+    UNKNOWN = 0;
+
+    // Regular text block.
+    TEXT = 1;
+
+    // Table block.
+    TABLE = 2;
+
+    // Image block.
+    PICTURE = 3;
+
+    // Horizontal/vertical line box.
+    RULER = 4;
+
+    // Barcode block.
+    BARCODE = 5;
+  }
+
+  // Additional information detected for the block.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the block.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //
+  // * when the text is horizontal it might look like:
+  //
+  //         0----1
+  //         |    |
+  //         3----2
+  //
+  // * when it's rotated 180 degrees around the top-left corner it becomes:
+  //
+  //         2----3
+  //         |    |
+  //         1----0
+  //
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of paragraphs in this block (if this blocks is of type text).
+  repeated Paragraph paragraphs = 3;
+
+  // Detected block type (text, image etc) for this block.
+  BlockType block_type = 4;
+
+  // Confidence of the OCR results on the block. Range [0, 1].
+  float confidence = 5;
+}
+
+// Structural unit of text representing a number of words in certain order.
+message Paragraph {
+  // Additional information detected for the paragraph.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the paragraph.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of words in this paragraph.
+  repeated Word words = 3;
+
+  // Confidence of the OCR results for the paragraph. Range [0, 1].
+  float confidence = 4;
+}
+
+// A word representation.
+message Word {
+  // Additional information detected for the word.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the word.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertex order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // List of symbols in the word.
+  // The order of the symbols follows the natural reading order.
+  repeated Symbol symbols = 3;
+
+  // Confidence of the OCR results for the word. Range [0, 1].
+  float confidence = 4;
+}
+
+// A single symbol representation.
+message Symbol {
+  // Additional information detected for the symbol.
+  TextAnnotation.TextProperty property = 1;
+
+  // The bounding box for the symbol.
+  // The vertices are in the order of top-left, top-right, bottom-right,
+  // bottom-left. When a rotation of the bounding box is detected the rotation
+  // is represented as around the top-left corner as defined when the text is
+  // read in the 'natural' orientation.
+  // For example:
+  //   * when the text is horizontal it might look like:
+  //      0----1
+  //      |    |
+  //      3----2
+  //   * when it's rotated 180 degrees around the top-left corner it becomes:
+  //      2----3
+  //      |    |
+  //      1----0
+  //   and the vertice order will still be (0, 1, 2, 3).
+  BoundingPoly bounding_box = 2;
+
+  // The actual UTF-8 representation of the symbol.
+  string text = 3;
+
+  // Confidence of the OCR results for the symbol. Range [0, 1].
+  float confidence = 4;
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/text_annotation_pb2.py b/vision/google/cloud/vision_v1p4beta1/proto/text_annotation_pb2.py
new file mode 100644
index 000000000000..5eef841be026
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/text_annotation_pb2.py
@@ -0,0 +1,1137 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p4beta1/proto/text_annotation.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.vision_v1p4beta1.proto import (
+    geometry_pb2 as google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p4beta1/proto/text_annotation.proto",
+    package="google.cloud.vision.v1p4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p4beta1B\023TextAnnotationProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n9google/cloud/vision_v1p4beta1/proto/text_annotation.proto\x12\x1dgoogle.cloud.vision.v1p4beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x32google/cloud/vision_v1p4beta1/proto/geometry.proto"\xb2\x04\n\x0eTextAnnotation\x12\x32\n\x05pages\x18\x01 \x03(\x0b\x32#.google.cloud.vision.v1p4beta1.Page\x12\x0c\n\x04text\x18\x02 \x01(\t\x1a=\n\x10\x44\x65tectedLanguage\x12\x15\n\rlanguage_code\x18\x01 \x01(\t\x12\x12\n\nconfidence\x18\x02 \x01(\x02\x1a\xdc\x01\n\rDetectedBreak\x12S\n\x04type\x18\x01 \x01(\x0e\x32\x45.google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak.BreakType\x12\x11\n\tis_prefix\x18\x02 \x01(\x08"c\n\tBreakType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\t\n\x05SPACE\x10\x01\x12\x0e\n\nSURE_SPACE\x10\x02\x12\x12\n\x0e\x45OL_SURE_SPACE\x10\x03\x12\n\n\x06HYPHEN\x10\x04\x12\x0e\n\nLINE_BREAK\x10\x05\x1a\xbf\x01\n\x0cTextProperty\x12Z\n\x12\x64\x65tected_languages\x18\x01 \x03(\x0b\x32>.google.cloud.vision.v1p4beta1.TextAnnotation.DetectedLanguage\x12S\n\x0e\x64\x65tected_break\x18\x02 \x01(\x0b\x32;.google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak"\xbd\x01\n\x04Page\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty\x12\r\n\x05width\x18\x02 \x01(\x05\x12\x0e\n\x06height\x18\x03 \x01(\x05\x12\x34\n\x06\x62locks\x18\x04 \x03(\x0b\x32$.google.cloud.vision.v1p4beta1.Block\x12\x12\n\nconfidence\x18\x05 \x01(\x02"\x82\x03\n\x05\x42lock\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12<\n\nparagraphs\x18\x03 \x03(\x0b\x32(.google.cloud.vision.v1p4beta1.Paragraph\x12\x42\n\nblock_type\x18\x04 \x01(\x0e\x32..google.cloud.vision.v1p4beta1.Block.BlockType\x12\x12\n\nconfidence\x18\x05 \x01(\x02"R\n\tBlockType\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x08\n\x04TEXT\x10\x01\x12\t\n\x05TABLE\x10\x02\x12\x0b\n\x07PICTURE\x10\x03\x12\t\n\x05RULER\x10\x04\x12\x0b\n\x07\x42\x41RCODE\x10\x05"\xe4\x01\n\tParagraph\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12\x32\n\x05words\x18\x03 \x03(\x0b\x32#.google.cloud.vision.v1p4beta1.Word\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xe3\x01\n\x04Word\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12\x36\n\x07symbols\x18\x03 \x03(\x0b\x32%.google.cloud.vision.v1p4beta1.Symbol\x12\x12\n\nconfidence\x18\x04 \x01(\x02"\xbb\x01\n\x06Symbol\x12L\n\x08property\x18\x01 \x01(\x0b\x32:.google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty\x12\x41\n\x0c\x62ounding_box\x18\x02 \x01(\x0b\x32+.google.cloud.vision.v1p4beta1.BoundingPoly\x12\x0c\n\x04text\x18\x03 \x01(\t\x12\x12\n\nconfidence\x18\x04 \x01(\x02\x42\x89\x01\n!com.google.cloud.vision.v1p4beta1B\x13TextAnnotationProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE = _descriptor.EnumDescriptor(
+    name="BreakType",
+    full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak.BreakType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SPACE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SURE_SPACE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="EOL_SURE_SPACE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="HYPHEN", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LINE_BREAK", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=444,
+    serialized_end=543,
+)
+_sym_db.RegisterEnumDescriptor(_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE)
+
+_BLOCK_BLOCKTYPE = _descriptor.EnumDescriptor(
+    name="BlockType",
+    full_name="google.cloud.vision.v1p4beta1.Block.BlockType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="UNKNOWN", index=0, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TEXT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TABLE", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PICTURE", index=3, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RULER", index=4, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BARCODE", index=5, number=5, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1236,
+    serialized_end=1318,
+)
+_sym_db.RegisterEnumDescriptor(_BLOCK_BLOCKTYPE)
+
+
+_TEXTANNOTATION_DETECTEDLANGUAGE = _descriptor.Descriptor(
+    name="DetectedLanguage",
+    full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedLanguage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedLanguage.language_code",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedLanguage.confidence",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=259,
+    serialized_end=320,
+)
+
+_TEXTANNOTATION_DETECTEDBREAK = _descriptor.Descriptor(
+    name="DetectedBreak",
+    full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="type",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak.type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="is_prefix",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak.is_prefix",
+            index=1,
+            number=2,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=323,
+    serialized_end=543,
+)
+
+_TEXTANNOTATION_TEXTPROPERTY = _descriptor.Descriptor(
+    name="TextProperty",
+    full_name="google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="detected_languages",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty.detected_languages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="detected_break",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty.detected_break",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=546,
+    serialized_end=737,
+)
+
+_TEXTANNOTATION = _descriptor.Descriptor(
+    name="TextAnnotation",
+    full_name="google.cloud.vision.v1p4beta1.TextAnnotation",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="pages",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.pages",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p4beta1.TextAnnotation.text",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _TEXTANNOTATION_DETECTEDLANGUAGE,
+        _TEXTANNOTATION_DETECTEDBREAK,
+        _TEXTANNOTATION_TEXTPROPERTY,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=175,
+    serialized_end=737,
+)
+
+
+_PAGE = _descriptor.Descriptor(
+    name="Page",
+    full_name="google.cloud.vision.v1p4beta1.Page",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p4beta1.Page.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="width",
+            full_name="google.cloud.vision.v1p4beta1.Page.width",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="height",
+            full_name="google.cloud.vision.v1p4beta1.Page.height",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blocks",
+            full_name="google.cloud.vision.v1p4beta1.Page.blocks",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.Page.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=740,
+    serialized_end=929,
+)
+
+
+_BLOCK = _descriptor.Descriptor(
+    name="Block",
+    full_name="google.cloud.vision.v1p4beta1.Block",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p4beta1.Block.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p4beta1.Block.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="paragraphs",
+            full_name="google.cloud.vision.v1p4beta1.Block.paragraphs",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="block_type",
+            full_name="google.cloud.vision.v1p4beta1.Block.block_type",
+            index=3,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.Block.confidence",
+            index=4,
+            number=5,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_BLOCK_BLOCKTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=932,
+    serialized_end=1318,
+)
+
+
+_PARAGRAPH = _descriptor.Descriptor(
+    name="Paragraph",
+    full_name="google.cloud.vision.v1p4beta1.Paragraph",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p4beta1.Paragraph.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p4beta1.Paragraph.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="words",
+            full_name="google.cloud.vision.v1p4beta1.Paragraph.words",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.Paragraph.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1321,
+    serialized_end=1549,
+)
+
+
+_WORD = _descriptor.Descriptor(
+    name="Word",
+    full_name="google.cloud.vision.v1p4beta1.Word",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p4beta1.Word.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p4beta1.Word.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="symbols",
+            full_name="google.cloud.vision.v1p4beta1.Word.symbols",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.Word.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1552,
+    serialized_end=1779,
+)
+
+
+_SYMBOL = _descriptor.Descriptor(
+    name="Symbol",
+    full_name="google.cloud.vision.v1p4beta1.Symbol",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="property",
+            full_name="google.cloud.vision.v1p4beta1.Symbol.property",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="bounding_box",
+            full_name="google.cloud.vision.v1p4beta1.Symbol.bounding_box",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="text",
+            full_name="google.cloud.vision.v1p4beta1.Symbol.text",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="confidence",
+            full_name="google.cloud.vision.v1p4beta1.Symbol.confidence",
+            index=3,
+            number=4,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1782,
+    serialized_end=1969,
+)
+
+_TEXTANNOTATION_DETECTEDLANGUAGE.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK.fields_by_name[
+    "type"
+].enum_type = _TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE
+_TEXTANNOTATION_DETECTEDBREAK.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION_DETECTEDBREAK_BREAKTYPE.containing_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_languages"
+].message_type = _TEXTANNOTATION_DETECTEDLANGUAGE
+_TEXTANNOTATION_TEXTPROPERTY.fields_by_name[
+    "detected_break"
+].message_type = _TEXTANNOTATION_DETECTEDBREAK
+_TEXTANNOTATION_TEXTPROPERTY.containing_type = _TEXTANNOTATION
+_TEXTANNOTATION.fields_by_name["pages"].message_type = _PAGE
+_PAGE.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PAGE.fields_by_name["blocks"].message_type = _BLOCK
+_BLOCK.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_BLOCK.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_BLOCK.fields_by_name["paragraphs"].message_type = _PARAGRAPH
+_BLOCK.fields_by_name["block_type"].enum_type = _BLOCK_BLOCKTYPE
+_BLOCK_BLOCKTYPE.containing_type = _BLOCK
+_PARAGRAPH.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_PARAGRAPH.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_PARAGRAPH.fields_by_name["words"].message_type = _WORD
+_WORD.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_WORD.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+_WORD.fields_by_name["symbols"].message_type = _SYMBOL
+_SYMBOL.fields_by_name["property"].message_type = _TEXTANNOTATION_TEXTPROPERTY
+_SYMBOL.fields_by_name[
+    "bounding_box"
+].message_type = (
+    google_dot_cloud_dot_vision__v1p4beta1_dot_proto_dot_geometry__pb2._BOUNDINGPOLY
+)
+DESCRIPTOR.message_types_by_name["TextAnnotation"] = _TEXTANNOTATION
+DESCRIPTOR.message_types_by_name["Page"] = _PAGE
+DESCRIPTOR.message_types_by_name["Block"] = _BLOCK
+DESCRIPTOR.message_types_by_name["Paragraph"] = _PARAGRAPH
+DESCRIPTOR.message_types_by_name["Word"] = _WORD
+DESCRIPTOR.message_types_by_name["Symbol"] = _SYMBOL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TextAnnotation = _reflection.GeneratedProtocolMessageType(
+    "TextAnnotation",
+    (_message.Message,),
+    dict(
+        DetectedLanguage=_reflection.GeneratedProtocolMessageType(
+            "DetectedLanguage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDLANGUAGE,
+                __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+                __doc__="""Detected language for a structural component.
+    
+    
+    Attributes:
+        language_code:
+            The BCP-47 language code, such as "en-US" or "sr-Latn". For
+            more information, see http://www.unicode.org/reports/tr35/#Uni
+            code\_locale\_identifier.
+        confidence:
+            Confidence of detected language. Range [0, 1].
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.TextAnnotation.DetectedLanguage)
+            ),
+        ),
+        DetectedBreak=_reflection.GeneratedProtocolMessageType(
+            "DetectedBreak",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_DETECTEDBREAK,
+                __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+                __doc__="""Detected start or end of a structural component.
+    
+    
+    Attributes:
+        type:
+            Detected break type.
+        is_prefix:
+            True if break prepends the element.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.TextAnnotation.DetectedBreak)
+            ),
+        ),
+        TextProperty=_reflection.GeneratedProtocolMessageType(
+            "TextProperty",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_TEXTANNOTATION_TEXTPROPERTY,
+                __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+                __doc__="""Additional information detected on the structural component.
+    
+    
+    Attributes:
+        detected_languages:
+            A list of detected languages together with confidence.
+        detected_break:
+            Detected start or end of a text segment.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.TextAnnotation.TextProperty)
+            ),
+        ),
+        DESCRIPTOR=_TEXTANNOTATION,
+        __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+        __doc__="""TextAnnotation contains a structured representation of OCR extracted
+  text. The hierarchy of an OCR extracted text structure is like this:
+  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.v1p4beta1.TextAnnotation.TextProperty]
+  message definition below for more detail.
+  
+  
+  Attributes:
+      pages:
+          List of pages detected by OCR.
+      text:
+          UTF-8 text detected on the pages.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.TextAnnotation)
+    ),
+)
+_sym_db.RegisterMessage(TextAnnotation)
+_sym_db.RegisterMessage(TextAnnotation.DetectedLanguage)
+_sym_db.RegisterMessage(TextAnnotation.DetectedBreak)
+_sym_db.RegisterMessage(TextAnnotation.TextProperty)
+
+Page = _reflection.GeneratedProtocolMessageType(
+    "Page",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PAGE,
+        __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+        __doc__="""Detected page from OCR.
+  
+  
+  Attributes:
+      property:
+          Additional information detected on the page.
+      width:
+          Page width. For PDFs the unit is points. For images (including
+          TIFFs) the unit is pixels.
+      height:
+          Page height. For PDFs the unit is points. For images
+          (including TIFFs) the unit is pixels.
+      blocks:
+          List of blocks of text, images etc on this page.
+      confidence:
+          Confidence of the OCR results on the page. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Page)
+    ),
+)
+_sym_db.RegisterMessage(Page)
+
+Block = _reflection.GeneratedProtocolMessageType(
+    "Block",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_BLOCK,
+        __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+        __doc__="""Logical element on the page.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the block.
+      bounding_box:
+          The bounding box for the block. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example:  -
+          when the text is horizontal it might look like:     ::
+          0----1        |    |        3----2  -  when it's rotated 180
+          degrees around the top-left corner it becomes:     ::
+          2----3        |    |        1----0  and the vertex order will
+          still be (0, 1, 2, 3).
+      paragraphs:
+          List of paragraphs in this block (if this blocks is of type
+          text).
+      block_type:
+          Detected block type (text, image etc) for this block.
+      confidence:
+          Confidence of the OCR results on the block. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Block)
+    ),
+)
+_sym_db.RegisterMessage(Block)
+
+Paragraph = _reflection.GeneratedProtocolMessageType(
+    "Paragraph",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_PARAGRAPH,
+        __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+        __doc__="""Structural unit of text representing a number of words in certain order.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the paragraph.
+      bounding_box:
+          The bounding box for the paragraph. The vertices are in the
+          order of top-left, top-right, bottom-right, bottom-left. When
+          a rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertex order
+          will still be (0, 1, 2, 3).
+      words:
+          List of words in this paragraph.
+      confidence:
+          Confidence of the OCR results for the paragraph. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Paragraph)
+    ),
+)
+_sym_db.RegisterMessage(Paragraph)
+
+Word = _reflection.GeneratedProtocolMessageType(
+    "Word",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_WORD,
+        __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+        __doc__="""A word representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the word.
+      bounding_box:
+          The bounding box for the word. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertex order
+          will still be (0, 1, 2, 3).
+      symbols:
+          List of symbols in the word. The order of the symbols follows
+          the natural reading order.
+      confidence:
+          Confidence of the OCR results for the word. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Word)
+    ),
+)
+_sym_db.RegisterMessage(Word)
+
+Symbol = _reflection.GeneratedProtocolMessageType(
+    "Symbol",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SYMBOL,
+        __module__="google.cloud.vision_v1p4beta1.proto.text_annotation_pb2",
+        __doc__="""A single symbol representation.
+  
+  
+  Attributes:
+      property:
+          Additional information detected for the symbol.
+      bounding_box:
+          The bounding box for the symbol. The vertices are in the order
+          of top-left, top-right, bottom-right, bottom-left. When a
+          rotation of the bounding box is detected the rotation is
+          represented as around the top-left corner as defined when the
+          text is read in the 'natural' orientation. For example: \*
+          when the text is horizontal it might look like: 0----1 \| \| 3
+          ----2 \* when it's rotated 180 degrees around the top-left
+          corner it becomes: 2----3 \| \| 1----0 and the vertice order
+          will still be (0, 1, 2, 3).
+      text:
+          The actual UTF-8 representation of the symbol.
+      confidence:
+          Confidence of the OCR results for the symbol. Range [0, 1].
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.Symbol)
+    ),
+)
+_sym_db.RegisterMessage(Symbol)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/text_annotation_pb2_grpc.py b/vision/google/cloud/vision_v1p4beta1/proto/text_annotation_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/text_annotation_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/web_detection.proto b/vision/google/cloud/vision_v1p4beta1/proto/web_detection.proto
new file mode 100644
index 000000000000..15822563b847
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/web_detection.proto
@@ -0,0 +1,107 @@
+// 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.cloud.vision.v1p4beta1;
+
+import "google/api/annotations.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 = "WebDetectionProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+option objc_class_prefix = "GCVN";
+
+// Relevant information for the image from the Internet.
+message WebDetection {
+  // Entity deduced from similar images on the Internet.
+  message WebEntity {
+    // Opaque entity ID.
+    string entity_id = 1;
+
+    // Overall relevancy score for the entity.
+    // Not normalized and not comparable across different image queries.
+    float score = 2;
+
+    // Canonical description of the entity, in English.
+    string description = 3;
+  }
+
+  // Metadata for online images.
+  message WebImage {
+    // The result image URL.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the image.
+    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.
+    string url = 1;
+
+    // (Deprecated) Overall relevancy score for the web page.
+    float score = 2;
+
+    // Title for the web page, may contain HTML markups.
+    string page_title = 3;
+
+    // Fully matching images on the page.
+    // Can include resized copies of the query image.
+    repeated WebImage full_matching_images = 4;
+
+    // Partial matching images on the page.
+    // Those images are similar enough to share some key-point features. For
+    // example an original image will likely have partial matching for its
+    // crops.
+    repeated WebImage partial_matching_images = 5;
+  }
+
+  // Deduced entities from similar images on the Internet.
+  repeated WebEntity web_entities = 1;
+
+  // Fully matching images from the Internet.
+  // Can include resized copies of the query image.
+  repeated WebImage full_matching_images = 2;
+
+  // Partial matching images from the Internet.
+  // Those images are similar enough to share some key-point features. For
+  // example an original image will likely have partial matching for its crops.
+  repeated WebImage partial_matching_images = 3;
+
+  // Web pages containing the matching images from the Internet.
+  repeated WebPage pages_with_matching_images = 4;
+
+  // The visually similar image results.
+  repeated WebImage visually_similar_images = 6;
+
+  // The service's best guess as to the topic of the request image.
+  // Inferred from similar images on the open web.
+  repeated WebLabel best_guess_labels = 8;
+}
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/web_detection_pb2.py b/vision/google/cloud/vision_v1p4beta1/proto/web_detection_pb2.py
new file mode 100644
index 000000000000..5a318c648b4d
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/web_detection_pb2.py
@@ -0,0 +1,617 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/vision_v1p4beta1/proto/web_detection.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/vision_v1p4beta1/proto/web_detection.proto",
+    package="google.cloud.vision.v1p4beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n!com.google.cloud.vision.v1p4beta1B\021WebDetectionProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\370\001\001\242\002\004GCVN"
+    ),
+    serialized_pb=_b(
+        '\n7google/cloud/vision_v1p4beta1/proto/web_detection.proto\x12\x1dgoogle.cloud.vision.v1p4beta1\x1a\x1cgoogle/api/annotations.proto"\x8c\x07\n\x0cWebDetection\x12K\n\x0cweb_entities\x18\x01 \x03(\x0b\x32\x35.google.cloud.vision.v1p4beta1.WebDetection.WebEntity\x12R\n\x14\x66ull_matching_images\x18\x02 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x03 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.WebDetection.WebImage\x12W\n\x1apages_with_matching_images\x18\x04 \x03(\x0b\x32\x33.google.cloud.vision.v1p4beta1.WebDetection.WebPage\x12U\n\x17visually_similar_images\x18\x06 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.WebDetection.WebImage\x12O\n\x11\x62\x65st_guess_labels\x18\x08 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.WebDetection.WebLabel\x1a\x42\n\tWebEntity\x12\x11\n\tentity_id\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x1a&\n\x08WebImage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x1a\x30\n\x08WebLabel\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\rlanguage_code\x18\x02 \x01(\t\x1a\xe4\x01\n\x07WebPage\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\r\n\x05score\x18\x02 \x01(\x02\x12\x12\n\npage_title\x18\x03 \x01(\t\x12R\n\x14\x66ull_matching_images\x18\x04 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.WebDetection.WebImage\x12U\n\x17partial_matching_images\x18\x05 \x03(\x0b\x32\x34.google.cloud.vision.v1p4beta1.WebDetection.WebImageB\x87\x01\n!com.google.cloud.vision.v1p4beta1B\x11WebDetectionProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision\xf8\x01\x01\xa2\x02\x04GCVNb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_WEBDETECTION_WEBENTITY = _descriptor.Descriptor(
+    name="WebEntity",
+    full_name="google.cloud.vision.v1p4beta1.WebDetection.WebEntity",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="entity_id",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebEntity.entity_id",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebEntity.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebEntity.description",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=642,
+    serialized_end=708,
+)
+
+_WEBDETECTION_WEBIMAGE = _descriptor.Descriptor(
+    name="WebImage",
+    full_name="google.cloud.vision.v1p4beta1.WebDetection.WebImage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebImage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebImage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=710,
+    serialized_end=748,
+)
+
+_WEBDETECTION_WEBLABEL = _descriptor.Descriptor(
+    name="WebLabel",
+    full_name="google.cloud.vision.v1p4beta1.WebDetection.WebLabel",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="label",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebLabel.label",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="language_code",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebLabel.language_code",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=750,
+    serialized_end=798,
+)
+
+_WEBDETECTION_WEBPAGE = _descriptor.Descriptor(
+    name="WebPage",
+    full_name="google.cloud.vision.v1p4beta1.WebDetection.WebPage",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebPage.url",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="score",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebPage.score",
+            index=1,
+            number=2,
+            type=2,
+            cpp_type=6,
+            label=1,
+            has_default_value=False,
+            default_value=float(0),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_title",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebPage.page_title",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebPage.full_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.WebPage.partial_matching_images",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=801,
+    serialized_end=1029,
+)
+
+_WEBDETECTION = _descriptor.Descriptor(
+    name="WebDetection",
+    full_name="google.cloud.vision.v1p4beta1.WebDetection",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="web_entities",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.web_entities",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="full_matching_images",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.full_matching_images",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="partial_matching_images",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.partial_matching_images",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="pages_with_matching_images",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.pages_with_matching_images",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="visually_similar_images",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.visually_similar_images",
+            index=4,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="best_guess_labels",
+            full_name="google.cloud.vision.v1p4beta1.WebDetection.best_guess_labels",
+            index=5,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _WEBDETECTION_WEBENTITY,
+        _WEBDETECTION_WEBIMAGE,
+        _WEBDETECTION_WEBLABEL,
+        _WEBDETECTION_WEBPAGE,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=121,
+    serialized_end=1029,
+)
+
+_WEBDETECTION_WEBENTITY.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBIMAGE.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBLABEL.containing_type = _WEBDETECTION
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION_WEBPAGE.containing_type = _WEBDETECTION
+_WEBDETECTION.fields_by_name["web_entities"].message_type = _WEBDETECTION_WEBENTITY
+_WEBDETECTION.fields_by_name[
+    "full_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "partial_matching_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name[
+    "pages_with_matching_images"
+].message_type = _WEBDETECTION_WEBPAGE
+_WEBDETECTION.fields_by_name[
+    "visually_similar_images"
+].message_type = _WEBDETECTION_WEBIMAGE
+_WEBDETECTION.fields_by_name["best_guess_labels"].message_type = _WEBDETECTION_WEBLABEL
+DESCRIPTOR.message_types_by_name["WebDetection"] = _WEBDETECTION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+WebDetection = _reflection.GeneratedProtocolMessageType(
+    "WebDetection",
+    (_message.Message,),
+    dict(
+        WebEntity=_reflection.GeneratedProtocolMessageType(
+            "WebEntity",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBENTITY,
+                __module__="google.cloud.vision_v1p4beta1.proto.web_detection_pb2",
+                __doc__="""Entity deduced from similar images on the Internet.
+    
+    
+    Attributes:
+        entity_id:
+            Opaque entity ID.
+        score:
+            Overall relevancy score for the entity. Not normalized and not
+            comparable across different image queries.
+        description:
+            Canonical description of the entity, in English.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.WebDetection.WebEntity)
+            ),
+        ),
+        WebImage=_reflection.GeneratedProtocolMessageType(
+            "WebImage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBIMAGE,
+                __module__="google.cloud.vision_v1p4beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for online images.
+    
+    
+    Attributes:
+        url:
+            The result image URL.
+        score:
+            (Deprecated) Overall relevancy score for the image.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.WebDetection.WebImage)
+            ),
+        ),
+        WebLabel=_reflection.GeneratedProtocolMessageType(
+            "WebLabel",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBLABEL,
+                __module__="google.cloud.vision_v1p4beta1.proto.web_detection_pb2",
+                __doc__="""Label to provide extra metadata for the web detection.
+    
+    
+    Attributes:
+        label:
+            Label for extra metadata.
+        language_code:
+            The BCP-47 language code for ``label``, such as "en-US" or
+            "sr-Latn". For more information, see http://www.unicode.org/re
+            ports/tr35/#Unicode\_locale\_identifier.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.WebDetection.WebLabel)
+            ),
+        ),
+        WebPage=_reflection.GeneratedProtocolMessageType(
+            "WebPage",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_WEBDETECTION_WEBPAGE,
+                __module__="google.cloud.vision_v1p4beta1.proto.web_detection_pb2",
+                __doc__="""Metadata for web pages.
+    
+    
+    Attributes:
+        url:
+            The result web page URL.
+        score:
+            (Deprecated) Overall relevancy score for the web page.
+        page_title:
+            Title for the web page, may contain HTML markups.
+        full_matching_images:
+            Fully matching images on the page. Can include resized copies
+            of the query image.
+        partial_matching_images:
+            Partial matching images on the page. Those images are similar
+            enough to share some key-point features. For example an
+            original image will likely have partial matching for its
+            crops.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.WebDetection.WebPage)
+            ),
+        ),
+        DESCRIPTOR=_WEBDETECTION,
+        __module__="google.cloud.vision_v1p4beta1.proto.web_detection_pb2",
+        __doc__="""Relevant information for the image from the Internet.
+  
+  
+  Attributes:
+      web_entities:
+          Deduced entities from similar images on the Internet.
+      full_matching_images:
+          Fully matching images from the Internet. Can include resized
+          copies of the query image.
+      partial_matching_images:
+          Partial matching images from the Internet. Those images are
+          similar enough to share some key-point features. For example
+          an original image will likely have partial matching for its
+          crops.
+      pages_with_matching_images:
+          Web pages containing the matching images from the Internet.
+      visually_similar_images:
+          The visually similar image results.
+      best_guess_labels:
+          The service's best guess as to the topic of the request image.
+          Inferred from similar images on the open web.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.vision.v1p4beta1.WebDetection)
+    ),
+)
+_sym_db.RegisterMessage(WebDetection)
+_sym_db.RegisterMessage(WebDetection.WebEntity)
+_sym_db.RegisterMessage(WebDetection.WebImage)
+_sym_db.RegisterMessage(WebDetection.WebLabel)
+_sym_db.RegisterMessage(WebDetection.WebPage)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/vision/google/cloud/vision_v1p4beta1/proto/web_detection_pb2_grpc.py b/vision/google/cloud/vision_v1p4beta1/proto/web_detection_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/proto/web_detection_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/vision/google/cloud/vision_v1p4beta1/types.py b/vision/google/cloud/vision_v1p4beta1/types.py
new file mode 100644
index 000000000000..6949fdf83948
--- /dev/null
+++ b/vision/google/cloud/vision_v1p4beta1/types.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.vision_v1p4beta1.proto import geometry_pb2
+from google.cloud.vision_v1p4beta1.proto import image_annotator_pb2
+from google.cloud.vision_v1p4beta1.proto import product_search_pb2
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2
+from google.cloud.vision_v1p4beta1.proto import text_annotation_pb2
+from google.cloud.vision_v1p4beta1.proto import web_detection_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import any_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+from google.protobuf import wrappers_pb2
+from google.rpc import status_pb2
+from google.type import color_pb2
+from google.type import latlng_pb2
+
+
+_shared_modules = [
+    operations_pb2,
+    any_pb2,
+    empty_pb2,
+    field_mask_pb2,
+    timestamp_pb2,
+    wrappers_pb2,
+    status_pb2,
+    color_pb2,
+    latlng_pb2,
+]
+
+_local_modules = [
+    geometry_pb2,
+    image_annotator_pb2,
+    product_search_pb2,
+    product_search_service_pb2,
+    text_annotation_pb2,
+    web_detection_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.vision_v1p4beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/vision/noxfile.py b/vision/noxfile.py
new file mode 100644
index 000000000000..8a65ddbccdc5
--- /dev/null
+++ b/vision/noxfile.py
@@ -0,0 +1,161 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", "../storage")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/vision/pylint.config.py b/vision/pylint.config.py
new file mode 100644
index 000000000000..5d64b9d2f256
--- /dev/null
+++ b/vision/pylint.config.py
@@ -0,0 +1,25 @@
+# Copyright 2017 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT 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 module is used to configure gcp-devrel-py-tools run-pylint."""
+
+# Library configuration
+
+# library_additions = {}
+# library_replacements = {}
+
+# Test configuration
+
+# test_additions = copy.deepcopy(library_additions)
+# test_replacements = copy.deepcopy(library_replacements)
diff --git a/vision/setup.cfg b/vision/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/vision/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/vision/setup.py b/vision/setup.py
new file mode 100644
index 000000000000..6173acb0c533
--- /dev/null
+++ b/vision/setup.py
@@ -0,0 +1,73 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+name = "google-cloud-vision"
+description = "Cloud Vision API API client library"
+version = "0.39.0"
+release_status = "Development Status :: 4 - Beta"
+dependencies = [
+    "google-api-core[grpc] >= 1.14.0, < 2.0.0dev",
+    'enum34; python_version < "3.4"',
+]
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Operating System :: OS Independent",
+        "Topic :: Internet",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/vision/synth.metadata b/vision/synth.metadata
new file mode 100644
index 000000000000..e33b7b952bad
--- /dev/null
+++ b/vision/synth.metadata
@@ -0,0 +1,79 @@
+{
+  "updateTime": "2019-08-16T12:45:12.445594Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.33.0",
+        "dockerImage": "googleapis/artman@sha256:c6231efb525569736226b1f7af7565dbc84248efafb3692a5bb1d2d8a7975d53"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "2a02e33c79cbf23d316c57e1c78f915e1d905eee",
+        "internalRef": "263682410"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "vision",
+        "apiVersion": "v1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/vision/artman_vision_v1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "vision",
+        "apiVersion": "v1p1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/vision/artman_vision_v1p1beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "vision",
+        "apiVersion": "v1p2beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/vision/artman_vision_v1p2beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "vision",
+        "apiVersion": "v1p3beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/vision/artman_vision_v1p3beta1.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "vision",
+        "apiVersion": "v1p4beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/vision/artman_vision_v1p4beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/vision/synth.py b/vision/synth.py
new file mode 100644
index 000000000000..1872b7a850bc
--- /dev/null
+++ b/vision/synth.py
@@ -0,0 +1,87 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1", "v1p1beta1", "v1p2beta1", "v1p3beta1", "v1p4beta1"]
+
+
+# ----------------------------------------------------------------------------
+# Generate vision GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("vision", version, include_protos=True)
+
+    s.move(library / f"google/cloud/vision_{version}/gapic")
+    s.move(library / f"google/cloud/vision_{version}/__init__.py")
+    s.move(library / f"google/cloud/vision_{version}/types.py")
+    s.move(library / f"google/cloud/vision_{version}/proto")
+    s.move(library / f"tests/unit/gapic/{version}")
+    # don't publish docs for these versions
+    if version not in ["v1p1beta1"]:
+        s.move(library / f"docs/gapic/{version}")
+
+    # Add vision helpers to each version
+    s.replace(
+        f"google/cloud/vision_{version}/__init__.py",
+        f"from __future__ import absolute_import",
+        f"\g<0>\n\n"
+        f"from google.cloud.vision_helpers.decorators import "
+        f"add_single_feature_methods\n"
+        f"from google.cloud.vision_helpers import VisionHelpers",
+    )
+
+    s.replace(
+        f"google/cloud/vision_{version}/__init__.py", f"image_annotator_client", f"iac"
+    )
+
+    s.replace(
+        f"google/cloud/vision_{version}/__init__.py",
+        f"from google.cloud.vision_{version}.gapic import iac",
+        f"from google.cloud.vision_{version}.gapic import "
+        f"image_annotator_client as iac",
+    )
+
+    s.replace(
+        f"google/cloud/vision_{version}/__init__.py",
+        f"class ImageAnnotatorClient\(iac.ImageAnnotatorClient\):",
+        f"@add_single_feature_methods\n"
+        f"class ImageAnnotatorClient(VisionHelpers, iac.ImageAnnotatorClient):",
+    )
+
+# Move docs configuration
+s.move(library / f"docs/conf.py")
+
+# Fix import of operations
+targets = ["google/cloud/vision_*/**/*.py", "tests/system/gapic/*/**/*.py"]
+s.replace(
+    targets,
+    "import google.api_core.operations_v1",
+    "from google.api_core import operations_v1",
+)
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(
+    unit_cov_level=97, cov_level=100, system_test_dependencies=["../storage"]
+)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/vision/tests/__init__.py b/vision/tests/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/tests/data/faces.jpg b/vision/tests/data/faces.jpg
new file mode 100644
index 000000000000..af26c6e3f334
Binary files /dev/null and b/vision/tests/data/faces.jpg differ
diff --git a/vision/tests/data/logo.png b/vision/tests/data/logo.png
new file mode 100644
index 000000000000..5538eaed2bdf
Binary files /dev/null and b/vision/tests/data/logo.png differ
diff --git a/vision/tests/data/pdf_test.pdf b/vision/tests/data/pdf_test.pdf
new file mode 100644
index 000000000000..bca60f549b9b
Binary files /dev/null and b/vision/tests/data/pdf_test.pdf differ
diff --git a/vision/tests/system.py b/vision/tests/system.py
new file mode 100644
index 000000000000..ad34c47b6575
--- /dev/null
+++ b/vision/tests/system.py
@@ -0,0 +1,1030 @@
+# Copyright 2017, Google LLC 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.
+
+"""System tests for Vision API."""
+
+import grpc
+import io
+import json
+import os
+import time
+import unittest
+
+import google.api_core.exceptions
+from google.cloud import exceptions
+from google.cloud import storage
+from google.cloud import vision
+
+from test_utils.retry import RetryErrors
+from test_utils.system import unique_resource_id
+
+
+_SYS_TESTS_DIR = os.path.realpath(os.path.dirname(__file__))
+FACE_FILE = os.path.join(_SYS_TESTS_DIR, "data", "faces.jpg")
+LOGO_FILE = os.path.join(_SYS_TESTS_DIR, "data", "logo.png")
+PDF_FILE = os.path.join(_SYS_TESTS_DIR, "data", "pdf_test.pdf")
+PROJECT_ID = os.environ.get("PROJECT_ID")
+PROJECT_OUTSIDE = os.environ.get("GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT")
+BUCKET_OUTSIDE = os.environ.get("GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_BUCKET")
+
+
+class VisionSystemTestBase(unittest.TestCase):
+    client = None
+    test_bucket = None
+
+    def setUp(self):
+        self.to_delete_by_case = []
+
+    def tearDown(self):
+        for value in self.to_delete_by_case:
+            value.delete()
+
+
+def setUpModule():
+    VisionSystemTestBase.client = vision.ImageAnnotatorClient()
+    VisionSystemTestBase.ps_client = vision.ProductSearchClient()
+    storage_client = storage.Client()
+    bucket_name = "new" + unique_resource_id()
+    VisionSystemTestBase.test_bucket = storage_client.bucket(bucket_name)
+
+    # 429 Too Many Requests in case API requests rate-limited.
+    retry_429 = RetryErrors(exceptions.TooManyRequests)
+    retry_429(VisionSystemTestBase.test_bucket.create)()
+
+
+def tearDownModule():
+    # 409 Conflict if the bucket is full.
+    # 429 Too Many Requests in case API requests rate-limited.
+    bucket_retry = RetryErrors((exceptions.TooManyRequests, exceptions.Conflict))
+    bucket_retry(VisionSystemTestBase.test_bucket.delete)(force=True)
+
+
+class TestVisionClientLogo(VisionSystemTestBase):
+    def test_detect_logos_content(self):
+        # Read the file.
+        with io.open(LOGO_FILE, "rb") as image_file:
+            content = image_file.read()
+
+        # Make the request.
+        response = self.client.logo_detection({"content": content})
+
+        # Check to ensure we got what we expect.
+        assert len(response.logo_annotations) == 1
+        assert response.logo_annotations[0].description == "google"
+
+    def test_detect_logos_file_handler(self):
+        # Get a file handler, and make the request using it.
+        with io.open(LOGO_FILE, "rb") as image_file:
+            response = self.client.logo_detection(image_file)
+
+        # Check to ensure we got what we expect.
+        assert len(response.logo_annotations) == 1
+        assert response.logo_annotations[0].description == "google"
+
+    def test_detect_logos_filename(self):
+        # Make the request with the filename directly.
+        response = self.client.logo_detection({"source": {"filename": LOGO_FILE}})
+
+        # Check to ensure we got what we expect.
+        assert len(response.logo_annotations) == 1
+        assert response.logo_annotations[0].description == "google"
+
+    def test_detect_logos_gcs(self):
+        # Upload the image to Google Cloud Storage.
+        blob_name = "logo.png"
+        blob = self.test_bucket.blob(blob_name)
+        self.to_delete_by_case.append(blob)
+        with io.open(LOGO_FILE, "rb") as image_file:
+            blob.upload_from_file(image_file)
+
+        # Make the request.
+        response = self.client.logo_detection(
+            {
+                "source": {
+                    "image_uri": "gs://{bucket}/{blob}".format(
+                        bucket=self.test_bucket.name, blob=blob_name
+                    )
+                }
+            }
+        )
+
+        # Check the response.
+        assert len(response.logo_annotations) == 1
+        assert response.logo_annotations[0].description == "google"
+
+    def test_detect_logos_async(self):
+        # Upload the image to Google Cloud Storage.
+        blob_name = "logo_async.png"
+        blob = self.test_bucket.blob(blob_name)
+        self.to_delete_by_case.append(blob)
+        with io.open(LOGO_FILE, "rb") as image_file:
+            blob.upload_from_file(image_file)
+
+        # Make the request.
+        request = {
+            "image": {
+                "source": {
+                    "image_uri": "gs://{bucket}/{blob}".format(
+                        bucket=self.test_bucket.name, blob=blob_name
+                    )
+                }
+            },
+            "features": [{"type": vision.enums.Feature.Type.LOGO_DETECTION}],
+        }
+        method_name = "test_detect_logos_async"
+        output_gcs_uri_prefix = "gs://{bucket}/{method_name}".format(
+            bucket=self.test_bucket.name, method_name=method_name
+        )
+        output_config = {"gcs_destination": {"uri": output_gcs_uri_prefix}}
+        response = self.client.async_batch_annotate_images([request], output_config)
+
+        # Wait for the operation to complete.
+        lro_waiting_seconds = 90
+        start_time = time.time()
+        while not response.done() and (time.time() - start_time) < lro_waiting_seconds:
+            time.sleep(1)
+
+        if not response.done():
+            self.fail(
+                "{method_name} timed out after {lro_waiting_seconds} seconds".format(
+                    method_name=method_name, lro_waiting_seconds=lro_waiting_seconds
+                )
+            )
+
+        # Make sure getting the result is not an error.
+        response.result()
+
+        # There should be exactly 1 output file in gcs at the prefix output_gcs_uri_prefix.
+        blobs = list(self.test_bucket.list_blobs(prefix=method_name))
+        assert len(blobs) == 1
+        blob = blobs[0]
+
+        # Download the output file and verify the result
+        result_str = blob.download_as_string().decode("utf8")
+        result = json.loads(result_str)
+        responses = result["responses"]
+        assert len(responses) == 1
+        logo_annotations = responses[0]["logoAnnotations"]
+        assert len(logo_annotations) == 1
+        assert logo_annotations[0]["description"] == "google"
+
+
+class TestVisionClientFiles(VisionSystemTestBase):
+    def test_async_batch_annotate_files(self):
+        # Upload the image to Google Cloud Storage.
+        blob_name = "async_batch_annotate_files.pdf"
+        blob = self.test_bucket.blob(blob_name)
+        self.to_delete_by_case.append(blob)
+        with io.open(PDF_FILE, "rb") as image_file:
+            blob.upload_from_file(image_file)
+
+        # Make the request.
+        method_name = "test_async_batch_annotate_files"
+        output_gcs_uri_prefix = "gs://{bucket}/{method_name}".format(
+            bucket=self.test_bucket.name, method_name=method_name
+        )
+        request = {
+            "input_config": {
+                "gcs_source": {
+                    "uri": "gs://{bucket}/{blob}".format(
+                        bucket=self.test_bucket.name, blob=blob_name
+                    )
+                },
+                "mime_type": "application/pdf",
+            },
+            "features": [{"type": vision.enums.Feature.Type.DOCUMENT_TEXT_DETECTION}],
+            "output_config": {"gcs_destination": {"uri": output_gcs_uri_prefix}},
+        }
+        response = self.client.async_batch_annotate_files([request])
+
+        # Wait for the operation to complete.
+        lro_waiting_seconds = 90
+        start_time = time.time()
+        while not response.done() and (time.time() - start_time) < lro_waiting_seconds:
+            time.sleep(1)
+
+        if not response.done():
+            self.fail(
+                "{method_name} timed out after {lro_waiting_seconds} seconds".format(
+                    method_name=method_name, lro_waiting_seconds=lro_waiting_seconds
+                )
+            )
+
+        # Make sure getting the result is not an error.
+        response.result()
+
+        # There should be exactly 1 output file in gcs at the prefix output_gcs_uri_prefix.
+        blobs = list(self.test_bucket.list_blobs(prefix=method_name))
+        assert len(blobs) == 1
+        blob = blobs[0]
+
+        # Download the output file and verify the result
+        result_str = blob.download_as_string().decode("utf8")
+        result = json.loads(result_str)
+        responses = result["responses"]
+        assert len(responses) == 1
+        text = responses[0]["fullTextAnnotation"]["text"]
+        expected_text = "test text"
+        self.assertTrue(
+            expected_text in text,
+            "'{expected_text}' not in '{text}'".format(
+                expected_text=expected_text, text=text
+            ),
+        )
+
+
+@unittest.skipUnless(PROJECT_ID, "PROJECT_ID not set in environment.")
+class TestVisionClientProductSearch(VisionSystemTestBase):
+    def setUp(self):
+        VisionSystemTestBase.setUp(self)
+        self.reference_images_to_delete = []
+        self.products_to_delete = []
+        self.product_sets_to_delete = []
+        self.location = "us-west1"
+        self.location_path = self.ps_client.location_path(
+            project=PROJECT_ID, location=self.location
+        )
+
+    def tearDown(self):
+        VisionSystemTestBase.tearDown(self)
+        for reference_image in self.reference_images_to_delete:
+            self.ps_client.delete_reference_image(name=reference_image)
+        for product in self.products_to_delete:
+            self.ps_client.delete_product(name=product)
+        for product_set in self.product_sets_to_delete:
+            self.ps_client.delete_product_set(name=product_set)
+
+    def _upload_image(self, image_name):
+        blob = self.test_bucket.blob(image_name)
+        self.to_delete_by_case.append(blob)
+        with io.open(FACE_FILE, "rb") as image_file:
+            blob.upload_from_file(image_file)
+        return "gs://{bucket}/{blob}".format(
+            bucket=self.test_bucket.name, blob=image_name
+        )
+
+    def test_create_product_set(self):
+        # Create a ProductSet.
+        product_set = vision.types.ProductSet(display_name="display name")
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_ID, location=self.location, product_set=product_set_id
+        )
+        response = self.ps_client.create_product_set(
+            parent=self.location_path,
+            product_set=product_set,
+            product_set_id=product_set_id,
+        )
+        self.product_sets_to_delete.append(response.name)
+        # Verify the ProductSet was successfully created.
+        self.assertEqual(response.name, product_set_path)
+
+    def test_get_product_set(self):
+        # Create a ProductSet.
+        product_set = vision.types.ProductSet(display_name="display name")
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_ID, location=self.location, product_set=product_set_id
+        )
+        response = self.ps_client.create_product_set(
+            parent=self.location_path,
+            product_set=product_set,
+            product_set_id=product_set_id,
+        )
+        self.product_sets_to_delete.append(response.name)
+        self.assertEqual(response.name, product_set_path)
+        # Get the ProductSet.
+        get_response = self.ps_client.get_product_set(name=product_set_path)
+        self.assertEqual(get_response.name, product_set_path)
+
+    def test_list_product_sets(self):
+        # Create a ProductSet.
+        product_set = vision.types.ProductSet(display_name="display name")
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_ID, location=self.location, product_set=product_set_id
+        )
+        response = self.ps_client.create_product_set(
+            parent=self.location_path,
+            product_set=product_set,
+            product_set_id=product_set_id,
+        )
+        self.product_sets_to_delete.append(response.name)
+        self.assertEqual(response.name, product_set_path)
+        # Verify ProductSets can be listed.
+        product_sets_iterator = self.ps_client.list_product_sets(
+            parent=self.location_path
+        )
+        product_sets_exist = False
+        for product_set in product_sets_iterator:
+            product_sets_exist = True
+            break
+        self.assertTrue(product_sets_exist)
+
+    def test_update_product_set(self):
+        # Create a ProductSet.
+        product_set = vision.types.ProductSet(display_name="display name")
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_ID, location=self.location, product_set=product_set_id
+        )
+        response = self.ps_client.create_product_set(
+            parent=self.location_path,
+            product_set=product_set,
+            product_set_id=product_set_id,
+        )
+        self.product_sets_to_delete.append(response.name)
+        self.assertEqual(response.name, product_set_path)
+        # Update the ProductSet.
+        new_display_name = "updated name"
+        updated_product_set_request = vision.types.ProductSet(
+            name=product_set_path, display_name=new_display_name
+        )
+        update_mask = vision.types.FieldMask(paths=["display_name"])
+        updated_product_set = self.ps_client.update_product_set(
+            product_set=updated_product_set_request, update_mask=update_mask
+        )
+        self.assertEqual(updated_product_set.display_name, new_display_name)
+
+    def test_create_product(self):
+        # Create a Product.
+        product = vision.types.Product(
+            display_name="product display name", product_category="apparel"
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        response = self.ps_client.create_product(
+            parent=self.location_path, product=product, product_id=product_id
+        )
+        self.products_to_delete.append(response.name)
+        # Verify the Product was successfully created.
+        self.assertEqual(response.name, product_path)
+
+    def test_get_product(self):
+        # Create a Product.
+        product = vision.types.Product(
+            display_name="product display name", product_category="apparel"
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        response = self.ps_client.create_product(
+            parent=self.location_path, product=product, product_id=product_id
+        )
+        self.products_to_delete.append(response.name)
+        self.assertEqual(response.name, product_path)
+        # Get the Product.
+        get_response = self.ps_client.get_product(name=product_path)
+        self.assertEqual(get_response.name, product_path)
+
+    def test_update_product(self):
+        # Create a Product.
+        product = vision.types.Product(
+            display_name="product display name", product_category="apparel"
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        response = self.ps_client.create_product(
+            parent=self.location_path, product=product, product_id=product_id
+        )
+        self.products_to_delete.append(response.name)
+        self.assertEqual(response.name, product_path)
+        # Update the Product.
+        new_display_name = "updated product name"
+        updated_product_request = vision.types.Product(
+            name=product_path, display_name=new_display_name
+        )
+        update_mask = vision.types.FieldMask(paths=["display_name"])
+        updated_product = self.ps_client.update_product(
+            product=updated_product_request, update_mask=update_mask
+        )
+        self.assertEqual(updated_product.display_name, new_display_name)
+
+    def test_list_products(self):
+        # Create a Product.
+        product = vision.types.Product(
+            display_name="product display name", product_category="apparel"
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        response = self.ps_client.create_product(
+            parent=self.location_path, product=product, product_id=product_id
+        )
+        self.products_to_delete.append(response.name)
+        self.assertEqual(response.name, product_path)
+        # Verify Products can be listed.
+        products_iterator = self.ps_client.list_products(parent=self.location_path)
+        products_exist = False
+        for product in products_iterator:
+            products_exist = True
+            break
+        self.assertTrue(products_exist)
+
+    def test_list_products_in_product_set(self):
+        # Create a ProductSet.
+        product_set = vision.types.ProductSet(display_name="display name")
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_ID, location=self.location, product_set=product_set_id
+        )
+        response = self.ps_client.create_product_set(
+            parent=self.location_path,
+            product_set=product_set,
+            product_set_id=product_set_id,
+        )
+        self.product_sets_to_delete.append(response.name)
+        self.assertEqual(response.name, product_set_path)
+        # Create a Product.
+        product = vision.types.Product(
+            display_name="product display name", product_category="apparel"
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        response = self.ps_client.create_product(
+            parent=self.location_path, product=product, product_id=product_id
+        )
+        self.products_to_delete.append(response.name)
+        self.assertEqual(response.name, product_path)
+        # Add the Product to the ProductSet.
+        self.ps_client.add_product_to_product_set(
+            name=product_set_path, product=product_path
+        )
+        # List the Products in the ProductSet.
+        listed_products = list(
+            self.ps_client.list_products_in_product_set(name=product_set_path)
+        )
+        self.assertEqual(len(listed_products), 1)
+        self.assertEqual(listed_products[0].name, product_path)
+        # Remove the Product from the ProductSet.
+        self.ps_client.remove_product_from_product_set(
+            name=product_set_path, product=product_path
+        )
+
+    def test_reference_image(self):
+        # Create a Product.
+        product = vision.types.Product(
+            display_name="product display name", product_category="apparel"
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        response = self.ps_client.create_product(
+            parent=self.location_path, product=product, product_id=product_id
+        )
+        self.products_to_delete.append(response.name)
+        self.assertEqual(response.name, product_path)
+
+        # Upload image to gcs.
+        gcs_uri = self._upload_image("reference_image_test.jpg")
+
+        # Create a ReferenceImage.
+        reference_image_id = "reference_image" + unique_resource_id()
+        reference_image_path = self.ps_client.reference_image_path(
+            project=PROJECT_ID,
+            location=self.location,
+            product=product_id,
+            reference_image=reference_image_id,
+        )
+        reference_image = vision.types.ReferenceImage(uri=gcs_uri)
+        response = self.ps_client.create_reference_image(
+            parent=product_path,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
+        )
+        self.reference_images_to_delete.append(response.name)
+        self.assertEqual(response.name, reference_image_path)
+
+        # Get the ReferenceImage.
+        get_response = self.ps_client.get_reference_image(name=reference_image_path)
+        self.assertEqual(get_response.name, reference_image_path)
+
+        # List the ReferenceImages in the Product.
+        listed_reference_images = list(
+            self.ps_client.list_reference_images(parent=product_path)
+        )
+        self.assertEqual(len(listed_reference_images), 1)
+        self.assertEqual(listed_reference_images[0].name, reference_image_path)
+
+    def _build_csv_line(
+        self, gcs_uri_image, reference_image_id, product_set_id, product_id
+    ):
+        return ",".join(
+            [
+                gcs_uri_image,
+                reference_image_id,
+                product_set_id,
+                product_id,
+                "apparel",
+                "display name",
+                '"color=black,style=formal"',
+                "",
+            ]
+        )
+
+    def test_import_product_sets(self):
+        # Generate the ids that will be used in the import.
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_ID, location=self.location, product_set=product_set_id
+        )
+        self.product_sets_to_delete.append(product_set_path)
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_ID, location=self.location, product=product_id
+        )
+        self.products_to_delete.append(product_path)
+        reference_image_id_1 = "reference_image_1" + unique_resource_id()
+        reference_image_path = self.ps_client.reference_image_path(
+            project=PROJECT_ID,
+            location=self.location,
+            product=product_id,
+            reference_image=reference_image_id_1,
+        )
+        self.reference_images_to_delete.append(reference_image_path)
+        reference_image_id_2 = "reference_image_2" + unique_resource_id()
+        reference_image_path = self.ps_client.reference_image_path(
+            project=PROJECT_ID,
+            location=self.location,
+            product=product_id,
+            reference_image=reference_image_id_2,
+        )
+        self.reference_images_to_delete.append(reference_image_path)
+
+        # Upload images to gcs.
+        gcs_uri_image_1 = self._upload_image("import_sets_image_1.jpg")
+        gcs_uri_image_2 = self._upload_image("import_sets_image_2.jpg")
+
+        # Build the string that will be uploaded to gcs as a csv file.
+        csv_data = "\n".join(
+            [
+                self._build_csv_line(
+                    gcs_uri_image_1, reference_image_id_1, product_set_id, product_id
+                ),
+                self._build_csv_line(
+                    gcs_uri_image_2, reference_image_id_2, product_set_id, product_id
+                ),
+            ]
+        )
+
+        # Upload a csv file to gcs.
+        csv_filename = "import_sets.csv"
+        blob = self.test_bucket.blob(csv_filename)
+        self.to_delete_by_case.append(blob)
+        blob.upload_from_string(csv_data)
+
+        # Make the import_product_sets request.
+        gcs_source = vision.types.ImportProductSetsGcsSource(
+            csv_file_uri="gs://{bucket}/{blob}".format(
+                bucket=self.test_bucket.name, blob=csv_filename
+            )
+        )
+        input_config = vision.types.ImportProductSetsInputConfig(gcs_source=gcs_source)
+        response = self.ps_client.import_product_sets(
+            parent=self.location_path, input_config=input_config
+        )
+
+        # Verify the result.
+        image_prefix = "import_sets_image_"
+        for ref_image in response.result().reference_images:
+            self.assertTrue(
+                image_prefix in ref_image.uri,
+                "'{image_prefix}' not in '{uri}'".format(
+                    image_prefix=image_prefix, uri=ref_image.uri
+                ),
+            )
+        for status in response.result().statuses:
+            self.assertEqual(status.code, grpc.StatusCode.OK.value[0])
+
+
+@unittest.skipUnless(
+    PROJECT_OUTSIDE,
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_PROJECT not set in environment.",
+)
+class TestVisionClientProductSearchVpcsc(VisionSystemTestBase):
+    # Tests to verify ProductSearch is blocked by VPC SC when trying to access a resource outside of a secure perimeter.
+    def setUp(self):
+        VisionSystemTestBase.setUp(self)
+        self.location = "us-west1"
+        self.location_path = self.ps_client.location_path(
+            project=PROJECT_OUTSIDE, location=self.location
+        )
+
+    def _verify_vpc_sc_error(self, call):
+        # Verifies that a VPC SC 403 error is raised.
+        try:
+            # call() should raise a PermissionDenied exception.
+            results = call()
+            # Some of the tests get a GRPCIterator object, which won't raise an exception until iteration starts.
+            for result in results:
+                break
+        except google.api_core.exceptions.PermissionDenied as e:
+            # Verify the PermissionDenied exception was due to VPC SC.
+            self.assertEqual(
+                e.message, "Request is prohibited by organization's policy"
+            )
+            return
+        except Exception as e:
+            self.fail("Unexpected exception raised: {}".format(e))
+        self.fail("No exception raised.")
+
+    def test_create_product_set_blocked(self):
+        product_set_id = "set" + unique_resource_id()
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.create_product_set(
+                parent=self.location_path, product_set={}, product_set_id=product_set_id
+            )
+        )
+
+    def test_get_product_set_blocked(self):
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_OUTSIDE, location=self.location, product_set=product_set_id
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.get_product_set(name=product_set_path)
+        )
+
+    def test_delete_product_set_blocked(self):
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_OUTSIDE, location=self.location, product_set=product_set_id
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.delete_product_set(name=product_set_path)
+        )
+
+    def test_list_product_sets_blocked(self):
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.list_product_sets(parent=self.location_path)
+        )
+
+    def test_update_product_set_blocked(self):
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_OUTSIDE, location=self.location, product_set=product_set_id
+        )
+        product_set = vision.types.ProductSet(name=product_set_path)
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.update_product_set(product_set=product_set)
+        )
+
+    def test_create_product_blocked(self):
+        product_id = "product" + unique_resource_id()
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.create_product(
+                parent=self.location_path, product={}, product_id=product_id
+            )
+        )
+
+    def test_get_product_blocked(self):
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_OUTSIDE, location=self.location, product=product_id
+        )
+        self._verify_vpc_sc_error(lambda: self.ps_client.get_product(name=product_path))
+
+    def test_delete_product_blocked(self):
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_OUTSIDE, location=self.location, product=product_id
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.delete_product(name=product_path)
+        )
+
+    def test_update_product_blocked(self):
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_OUTSIDE, location=self.location, product=product_id
+        )
+        product = vision.types.Product(name=product_path)
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.update_product(product=product)
+        )
+
+    def test_list_products_blocked(self):
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.list_products(parent=self.location_path)
+        )
+
+    def test_list_products_in_product_set_blocked(self):
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_OUTSIDE, location=self.location, product_set=product_set_id
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.list_products_in_product_set(name=product_set_path)
+        )
+
+    def test_add_remove_product_blocked(self):
+        product_set_id = "set" + unique_resource_id()
+        product_set_path = self.ps_client.product_set_path(
+            project=PROJECT_OUTSIDE, location=self.location, product_set=product_set_id
+        )
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_OUTSIDE, location=self.location, product=product_id
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.add_product_to_product_set(
+                name=product_set_path, product=product_path
+            )
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.remove_product_from_product_set(
+                name=product_set_path, product=product_path
+            )
+        )
+
+    def test_create_reference_image_blocked(self):
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_OUTSIDE, location=self.location, product=product_id
+        )
+        reference_image_id = "reference_image" + unique_resource_id()
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.create_reference_image(
+                parent=product_path,
+                reference_image={},
+                reference_image_id=reference_image_id,
+            )
+        )
+
+    def test_get_reference_image_blocked(self):
+        product_id = "product" + unique_resource_id()
+        reference_image_id = "reference_image" + unique_resource_id()
+        reference_image_path = self.ps_client.reference_image_path(
+            project=PROJECT_OUTSIDE,
+            location=self.location,
+            product=product_id,
+            reference_image=reference_image_id,
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.get_reference_image(name=reference_image_path)
+        )
+
+    def test_delete_reference_image_blocked(self):
+        product_id = "product" + unique_resource_id()
+        reference_image_id = "reference_image" + unique_resource_id()
+        reference_image_path = self.ps_client.reference_image_path(
+            project=PROJECT_OUTSIDE,
+            location=self.location,
+            product=product_id,
+            reference_image=reference_image_id,
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.delete_reference_image(name=reference_image_path)
+        )
+
+    def test_list_reference_images_blocked(self):
+        product_id = "product" + unique_resource_id()
+        product_path = self.ps_client.product_path(
+            project=PROJECT_OUTSIDE, location=self.location, product=product_id
+        )
+        self._verify_vpc_sc_error(
+            lambda: self.ps_client.list_reference_images(parent=product_path)
+        )
+
+
+@unittest.skipUnless(
+    BUCKET_OUTSIDE,
+    "GOOGLE_CLOUD_TESTS_VPCSC_OUTSIDE_PERIMETER_BUCKET not set in environment.",
+)
+class TestVisionClientVpcsc(VisionSystemTestBase):
+    # Tests to verify Vision API methods are blocked by VPC SC when trying to access a gcs resource outside of a secure perimeter.
+    def setUp(self):
+        VisionSystemTestBase.setUp(self)
+        self.blocked_file = "LC08/01_$folder$"
+        self.gcs_uri_blocked_file = "gs://{bucket}/{file}".format(
+            bucket=BUCKET_OUTSIDE, file=self.blocked_file
+        )
+        self._verify_vpc_sc_blocks_gcs_bucket()
+        self.gcs_read_error_message = "Error opening file: gs://"
+        self.gcs_write_error_message = "Error writing final output to: gs://"
+
+    def _verify_vpc_sc_blocks_gcs_bucket(self):
+        # Verifies that a VPC SC 403 error is raised when trying to access a bucket in gcs that is outside the perimeter.
+        try:
+            storage_client = storage.Client()
+            outside_bucket = storage_client.get_bucket(BUCKET_OUTSIDE)
+            blob = outside_bucket.blob(self.blocked_file)
+            blob.download_as_string()
+        except google.api_core.exceptions.Forbidden as e:
+            # Verify the Forbidden exception was due to VPC SC.
+            vpc_sc_error_message = "Request violates VPC Service Controls."
+            self.assertTrue(
+                vpc_sc_error_message in e.message,
+                "'{}' not in '{}'".format(vpc_sc_error_message, e.message),
+            )
+            return
+        except Exception as e:
+            self.fail(
+                "Unexpected exception raised while accessing gcs bucket: {}".format(e)
+            )
+        self.fail(
+            "No exception raised when accessing gcs bucket: {}".format(
+                self.gcs_uri_blocked_file
+            )
+        )
+
+    @unittest.skipUnless(PROJECT_ID, "PROJECT_ID not set in environment.")
+    def test_import_product_sets_blocked(self):
+        # The csv file is outside the secure perimeter.
+        gcs_source = vision.types.ImportProductSetsGcsSource(
+            csv_file_uri=self.gcs_uri_blocked_file
+        )
+        input_config = vision.types.ImportProductSetsInputConfig(gcs_source=gcs_source)
+        # Use a valid Project ID.
+        location_path = self.ps_client.location_path(
+            project=PROJECT_ID, location="us-west1"
+        )
+        try:
+            # A 403 exception should be raised because the csv file is not accessible due to VPC SC.
+            self.ps_client.import_product_sets(
+                parent=location_path, input_config=input_config
+            )
+        except google.api_core.exceptions.Forbidden as e:
+            # Verify the 403 error was due to reading the file in gcs.
+            self.assertTrue(
+                self.gcs_read_error_message in e.message,
+                "'{}' not in '{}'".format(self.gcs_read_error_message, e.message),
+            )
+            return
+        except Exception as e:
+            self.fail("Unexpected exception raised: {}".format(e))
+        self.fail("No exception raised.")
+
+    def test_async_batch_annotate_files_read_blocked(self):
+        # Make the request.
+        method_name = "test_async_batch_annotate_files_read_blocked"
+        output_gcs_uri_prefix = "gs://{bucket}/{method_name}".format(
+            bucket=self.test_bucket.name, method_name=method_name
+        )
+        # The input file is in a gcs bucket that is outside of the secure perimeter.
+        request = {
+            "input_config": {
+                "gcs_source": {"uri": self.gcs_uri_blocked_file},
+                "mime_type": "application/pdf",
+            },
+            "features": [{"type": vision.enums.Feature.Type.DOCUMENT_TEXT_DETECTION}],
+            "output_config": {"gcs_destination": {"uri": output_gcs_uri_prefix}},
+        }
+        try:
+            # A 403 exception should be raised.
+            self.client.async_batch_annotate_files([request])
+        except google.api_core.exceptions.Forbidden as e:
+            # Verify the 403 error was due to reading the file in gcs.
+            self.assertTrue(
+                self.gcs_read_error_message in e.message,
+                "'{}' not in '{}'".format(self.gcs_read_error_message, e.message),
+            )
+            return
+        except Exception as e:
+            self.fail("Unexpected exception raised: {}".format(e))
+        self.fail("No exception raised.")
+
+    def test_async_batch_annotate_files_write_blocked(self):
+        # Upload the image to Google Cloud Storage.
+        blob_name = "async_batch_annotate_files_write_blocked.pdf"
+        blob = self.test_bucket.blob(blob_name)
+        self.to_delete_by_case.append(blob)
+        with io.open(PDF_FILE, "rb") as image_file:
+            blob.upload_from_file(image_file)
+        method_name = "test_async_batch_annotate_files_write_blocked"
+        # Write the result to a bucket outside of the secure perimeter.
+        output_gcs_uri_prefix = "gs://{bucket}/{method_name}".format(
+            bucket=BUCKET_OUTSIDE, method_name=method_name
+        )
+        request = {
+            "input_config": {
+                "gcs_source": {
+                    "uri": "gs://{bucket}/{blob}".format(
+                        bucket=self.test_bucket.name, blob=blob_name
+                    )
+                },
+                "mime_type": "application/pdf",
+            },
+            "features": [{"type": vision.enums.Feature.Type.DOCUMENT_TEXT_DETECTION}],
+            "output_config": {"gcs_destination": {"uri": output_gcs_uri_prefix}},
+        }
+        response = self.client.async_batch_annotate_files([request])
+        # Wait for the operation to complete.
+        lro_waiting_seconds = 90
+        start_time = time.time()
+        while not response.done() and (time.time() - start_time) < lro_waiting_seconds:
+            time.sleep(1)
+        if not response.done():
+            self.fail(
+                "{method_name} timed out after {lro_waiting_seconds} seconds".format(
+                    method_name=method_name, lro_waiting_seconds=lro_waiting_seconds
+                )
+            )
+        # Verify there was an error writing to the output bucket.
+        error = response.operation.error
+        assert error.code == 7
+        assert self.gcs_write_error_message in error.message, "'{}' not in '{}'".format(
+            self.gcs_write_error_message, error.message
+        )
+
+    def test_async_batch_annotate_images_read_blocked(self):
+        # Make the request. The input file is in a gcs bucket that is outside of the secure perimeter.
+        request = {
+            "image": {"source": {"image_uri": self.gcs_uri_blocked_file}},
+            "features": [{"type": vision.enums.Feature.Type.LOGO_DETECTION}],
+        }
+        method_name = "test_async_batch_annotate_images_read_blocked"
+        output_gcs_uri_prefix = "gs://{bucket}/{method_name}".format(
+            bucket=self.test_bucket.name, method_name=method_name
+        )
+        output_config = {"gcs_destination": {"uri": output_gcs_uri_prefix}}
+        response = self.client.async_batch_annotate_images([request], output_config)
+        # Wait for the operation to complete.
+        lro_waiting_seconds = 90
+        start_time = time.time()
+        while not response.done() and (time.time() - start_time) < lro_waiting_seconds:
+            time.sleep(1)
+        if not response.done():
+            self.fail(
+                "{method_name} timed out after {lro_waiting_seconds} seconds".format(
+                    method_name=method_name, lro_waiting_seconds=lro_waiting_seconds
+                )
+            )
+        # Make sure getting the result is not an error.
+        response.result()
+        # There should be exactly 1 output file in gcs at the prefix output_gcs_uri_prefix.
+        blobs = list(self.test_bucket.list_blobs(prefix=method_name))
+        assert len(blobs) == 1
+        blob = blobs[0]
+        # Download the output file.
+        result_str = blob.download_as_string().decode("utf8")
+        result = json.loads(result_str)
+        responses = result["responses"]
+        assert len(responses) == 1
+        # Verify the read error.
+        error = responses[0]["error"]
+        assert error["code"] == 7
+        assert (
+            self.gcs_read_error_message in error["message"]
+        ), "'{}' not in '{}'".format(self.gcs_read_error_message, error["message"])
+
+    def test_async_batch_annotate_images_write_blocked(self):
+        # Make the request.
+        request = {
+            "image": {"source": {"image_uri": self.gcs_uri_blocked_file}},
+            "features": [{"type": vision.enums.Feature.Type.LOGO_DETECTION}],
+        }
+        method_name = "test_async_batch_annotate_images_write_blocked"
+        # Write the result to a bucket outside of the secure perimeter.
+        output_gcs_uri_prefix = "gs://{bucket}/{method_name}".format(
+            bucket=BUCKET_OUTSIDE, method_name=method_name
+        )
+        output_config = {"gcs_destination": {"uri": output_gcs_uri_prefix}}
+        response = self.client.async_batch_annotate_images([request], output_config)
+        # Wait for the operation to complete.
+        lro_waiting_seconds = 90
+        start_time = time.time()
+        while not response.done() and (time.time() - start_time) < lro_waiting_seconds:
+            time.sleep(1)
+        if not response.done():
+            self.fail(
+                "{method_name} timed out after {lro_waiting_seconds} seconds".format(
+                    method_name=method_name, lro_waiting_seconds=lro_waiting_seconds
+                )
+            )
+        # Verify there was an error writing to the output bucket.
+        error = response.operation.error
+        assert error.code == 7
+        assert self.gcs_write_error_message in error.message, "'{}' not in '{}'".format(
+            self.gcs_write_error_message, error.message
+        )
+
+    def test_batch_annotate_images_read_blocked(self):
+        response = self.client.logo_detection(
+            {"source": {"image_uri": self.gcs_uri_blocked_file}}
+        )
+        error = response.error
+        assert error.code == 7
+        assert self.gcs_read_error_message in error.message, "'{}' not in '{}'".format(
+            self.gcs_read_error_message, error.message
+        )
diff --git a/vision/tests/unit/__init__.py b/vision/tests/unit/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/vision/tests/unit/gapic/v1/test_image_annotator_client_v1.py b/vision/tests/unit/gapic/v1/test_image_annotator_client_v1.py
new file mode 100644
index 000000000000..870f259efe58
--- /dev/null
+++ b/vision/tests/unit/gapic/v1/test_image_annotator_client_v1.py
@@ -0,0 +1,256 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1
+from google.cloud.vision_v1.proto import image_annotator_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestImageAnnotatorClient(object):
+    def test_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_images(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateImagesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_images_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_images(requests)
+
+    def test_batch_annotate_files(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateFilesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_files(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateFilesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_files_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_files(requests)
+
+    def test_async_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.AsyncBatchAnnotateImagesResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_images", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+        output_config = {}
+
+        response = client.async_batch_annotate_images(requests, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.AsyncBatchAnnotateImagesRequest(
+            requests=requests, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_async_batch_annotate_images_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_images_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+        output_config = {}
+
+        response = client.async_batch_annotate_images(requests, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_async_batch_annotate_files(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.AsyncBatchAnnotateFilesResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_async_batch_annotate_files_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/gapic/v1/test_product_search_client_v1.py b/vision/tests/unit/gapic/v1/test_product_search_client_v1.py
new file mode 100644
index 000000000000..3c89b92f5e15
--- /dev/null
+++ b/vision/tests/unit/gapic/v1/test_product_search_client_v1.py
@@ -0,0 +1,895 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1
+from google.cloud.vision_v1.proto import product_search_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestProductSearchClient(object):
+    def test_create_product_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product_set = {}
+
+        response = client.create_product_set(parent, product_set)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateProductSetRequest(
+            parent=parent, product_set=product_set
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product_set = {}
+
+        with pytest.raises(CustomException):
+            client.create_product_set(parent, product_set)
+
+    def test_list_product_sets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        product_sets_element = {}
+        product_sets = [product_sets_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "product_sets": product_sets,
+        }
+        expected_response = product_search_service_pb2.ListProductSetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_product_sets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.product_sets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductSetsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_product_sets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_product_sets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_product_set(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        response = client.get_product_set(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetProductSetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        with pytest.raises(CustomException):
+            client.get_product_set(name)
+
+    def test_update_product_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        product_set = {}
+
+        response = client.update_product_set(product_set)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.UpdateProductSetRequest(
+            product_set=product_set
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        product_set = {}
+
+        with pytest.raises(CustomException):
+            client.update_product_set(product_set)
+
+    def test_delete_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        client.delete_product_set(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteProductSetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        with pytest.raises(CustomException):
+            client.delete_product_set(name)
+
+    def test_create_product(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product = {}
+
+        response = client.create_product(parent, product)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateProductRequest(
+            parent=parent, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product = {}
+
+        with pytest.raises(CustomException):
+            client.create_product(parent, product)
+
+    def test_list_products(self):
+        # Setup Expected Response
+        next_page_token = ""
+        products_element = {}
+        products = [products_element]
+        expected_response = {"next_page_token": next_page_token, "products": products}
+        expected_response = product_search_service_pb2.ListProductsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_products(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.products[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_products_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_products(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_product(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        response = client.get_product(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetProductRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.get_product(name)
+
+    def test_update_product(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        product = {}
+
+        response = client.update_product(product)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.UpdateProductRequest(
+            product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        product = {}
+
+        with pytest.raises(CustomException):
+            client.update_product(product)
+
+    def test_delete_product(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        client.delete_product(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteProductRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.delete_product(name)
+
+    def test_create_reference_image(self):
+        # Setup Expected Response
+        name = "name3373707"
+        uri = "uri116076"
+        expected_response = {"name": name, "uri": uri}
+        expected_response = product_search_service_pb2.ReferenceImage(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+        reference_image = {}
+
+        response = client.create_reference_image(parent, reference_image)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateReferenceImageRequest(
+            parent=parent, reference_image=reference_image
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+        reference_image = {}
+
+        with pytest.raises(CustomException):
+            client.create_reference_image(parent, reference_image)
+
+    def test_delete_reference_image(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        client.delete_reference_image(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteReferenceImageRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_reference_image(name)
+
+    def test_list_reference_images(self):
+        # Setup Expected Response
+        page_size = 883849137
+        next_page_token = ""
+        reference_images_element = {}
+        reference_images = [reference_images_element]
+        expected_response = {
+            "page_size": page_size,
+            "next_page_token": next_page_token,
+            "reference_images": reference_images,
+        }
+        expected_response = product_search_service_pb2.ListReferenceImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        paged_list_response = client.list_reference_images(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.reference_images[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListReferenceImagesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_reference_images_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        paged_list_response = client.list_reference_images(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_reference_image(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        uri = "uri116076"
+        expected_response = {"name": name_2, "uri": uri}
+        expected_response = product_search_service_pb2.ReferenceImage(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        response = client.get_reference_image(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetReferenceImageRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_reference_image(name)
+
+    def test_add_product_to_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        client.add_product_to_product_set(name, product)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.AddProductToProductSetRequest(
+            name=name, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_add_product_to_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.add_product_to_product_set(name, product)
+
+    def test_remove_product_from_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        client.remove_product_from_product_set(name, product)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.RemoveProductFromProductSetRequest(
+            name=name, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_remove_product_from_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.remove_product_from_product_set(name, product)
+
+    def test_list_products_in_product_set(self):
+        # Setup Expected Response
+        next_page_token = ""
+        products_element = {}
+        products = [products_element]
+        expected_response = {"next_page_token": next_page_token, "products": products}
+        expected_response = product_search_service_pb2.ListProductsInProductSetResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        paged_list_response = client.list_products_in_product_set(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.products[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductsInProductSetRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_products_in_product_set_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        paged_list_response = client.list_products_in_product_set(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_import_product_sets(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = product_search_service_pb2.ImportProductSetsResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_import_product_sets", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        input_config = {}
+
+        response = client.import_product_sets(parent, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ImportProductSetsRequest(
+            parent=parent, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_product_sets_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_import_product_sets_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        input_config = {}
+
+        response = client.import_product_sets(parent, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_purge_products(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = empty_pb2.Empty(**expected_response)
+        operation = operations_pb2.Operation(
+            name="operations/test_purge_products", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        response = client.purge_products(parent)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.PurgeProductsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_purge_products_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_purge_products_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        response = client.purge_products(parent)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/gapic/v1p1beta1/test_image_annotator_client_v1p1beta1.py b/vision/tests/unit/gapic/v1p1beta1/test_image_annotator_client_v1p1beta1.py
new file mode 100644
index 000000000000..6c9e250a6dac
--- /dev/null
+++ b/vision/tests/unit/gapic/v1p1beta1/test_image_annotator_client_v1p1beta1.py
@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import vision_v1p1beta1
+from google.cloud.vision_v1p1beta1.proto import image_annotator_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestImageAnnotatorClient(object):
+    def test_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p1beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_images(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateImagesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_images_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p1beta1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_images(requests)
diff --git a/vision/tests/unit/gapic/v1p2beta1/test_image_annotator_client_v1p2beta1.py b/vision/tests/unit/gapic/v1p2beta1/test_image_annotator_client_v1p2beta1.py
new file mode 100644
index 000000000000..1b769a29d18a
--- /dev/null
+++ b/vision/tests/unit/gapic/v1p2beta1/test_image_annotator_client_v1p2beta1.py
@@ -0,0 +1,159 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1p2beta1
+from google.cloud.vision_v1p2beta1.proto import image_annotator_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestImageAnnotatorClient(object):
+    def test_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p2beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_images(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateImagesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_images_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p2beta1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_images(requests)
+
+    def test_async_batch_annotate_files(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.AsyncBatchAnnotateFilesResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p2beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_async_batch_annotate_files_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p2beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/gapic/v1p3beta1/test_image_annotator_client_v1p3beta1.py b/vision/tests/unit/gapic/v1p3beta1/test_image_annotator_client_v1p3beta1.py
new file mode 100644
index 000000000000..eb2212b1a1be
--- /dev/null
+++ b/vision/tests/unit/gapic/v1p3beta1/test_image_annotator_client_v1p3beta1.py
@@ -0,0 +1,159 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1p3beta1
+from google.cloud.vision_v1p3beta1.proto import image_annotator_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestImageAnnotatorClient(object):
+    def test_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_images(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateImagesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_images_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_images(requests)
+
+    def test_async_batch_annotate_files(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.AsyncBatchAnnotateFilesResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_async_batch_annotate_files_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/gapic/v1p3beta1/test_product_search_client_v1p3beta1.py b/vision/tests/unit/gapic/v1p3beta1/test_product_search_client_v1p3beta1.py
new file mode 100644
index 000000000000..a97208f7115b
--- /dev/null
+++ b/vision/tests/unit/gapic/v1p3beta1/test_product_search_client_v1p3beta1.py
@@ -0,0 +1,858 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1p3beta1
+from google.cloud.vision_v1p3beta1.proto import product_search_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestProductSearchClient(object):
+    def test_create_product_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product_set = {}
+        product_set_id = "productSetId4216680"
+
+        response = client.create_product_set(parent, product_set, product_set_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateProductSetRequest(
+            parent=parent, product_set=product_set, product_set_id=product_set_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product_set = {}
+        product_set_id = "productSetId4216680"
+
+        with pytest.raises(CustomException):
+            client.create_product_set(parent, product_set, product_set_id)
+
+    def test_list_product_sets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        product_sets_element = {}
+        product_sets = [product_sets_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "product_sets": product_sets,
+        }
+        expected_response = product_search_service_pb2.ListProductSetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_product_sets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.product_sets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductSetsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_product_sets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_product_sets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_product_set(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        response = client.get_product_set(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetProductSetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        with pytest.raises(CustomException):
+            client.get_product_set(name)
+
+    def test_update_product_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        product_set = {}
+        update_mask = {}
+
+        response = client.update_product_set(product_set, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.UpdateProductSetRequest(
+            product_set=product_set, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        product_set = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_product_set(product_set, update_mask)
+
+    def test_delete_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        client.delete_product_set(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteProductSetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        with pytest.raises(CustomException):
+            client.delete_product_set(name)
+
+    def test_create_product(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product = {}
+        product_id = "productId1753008747"
+
+        response = client.create_product(parent, product, product_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateProductRequest(
+            parent=parent, product=product, product_id=product_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product = {}
+        product_id = "productId1753008747"
+
+        with pytest.raises(CustomException):
+            client.create_product(parent, product, product_id)
+
+    def test_list_products(self):
+        # Setup Expected Response
+        next_page_token = ""
+        products_element = {}
+        products = [products_element]
+        expected_response = {"next_page_token": next_page_token, "products": products}
+        expected_response = product_search_service_pb2.ListProductsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_products(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.products[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_products_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_products(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_product(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        response = client.get_product(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetProductRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.get_product(name)
+
+    def test_update_product(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        product = {}
+        update_mask = {}
+
+        response = client.update_product(product, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.UpdateProductRequest(
+            product=product, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        product = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_product(product, update_mask)
+
+    def test_delete_product(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        client.delete_product(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteProductRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.delete_product(name)
+
+    def test_create_reference_image(self):
+        # Setup Expected Response
+        name = "name3373707"
+        uri = "uri116076"
+        expected_response = {"name": name, "uri": uri}
+        expected_response = product_search_service_pb2.ReferenceImage(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+        reference_image = {}
+        reference_image_id = "referenceImageId1946713331"
+
+        response = client.create_reference_image(
+            parent, reference_image, reference_image_id
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateReferenceImageRequest(
+            parent=parent,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+        reference_image = {}
+        reference_image_id = "referenceImageId1946713331"
+
+        with pytest.raises(CustomException):
+            client.create_reference_image(parent, reference_image, reference_image_id)
+
+    def test_delete_reference_image(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        client.delete_reference_image(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteReferenceImageRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_reference_image(name)
+
+    def test_list_reference_images(self):
+        # Setup Expected Response
+        page_size = 883849137
+        next_page_token = ""
+        reference_images_element = {}
+        reference_images = [reference_images_element]
+        expected_response = {
+            "page_size": page_size,
+            "next_page_token": next_page_token,
+            "reference_images": reference_images,
+        }
+        expected_response = product_search_service_pb2.ListReferenceImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        paged_list_response = client.list_reference_images(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.reference_images[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListReferenceImagesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_reference_images_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        paged_list_response = client.list_reference_images(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_reference_image(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        uri = "uri116076"
+        expected_response = {"name": name_2, "uri": uri}
+        expected_response = product_search_service_pb2.ReferenceImage(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        response = client.get_reference_image(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetReferenceImageRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_reference_image(name)
+
+    def test_add_product_to_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        client.add_product_to_product_set(name, product)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.AddProductToProductSetRequest(
+            name=name, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_add_product_to_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        with pytest.raises(CustomException):
+            client.add_product_to_product_set(name, product)
+
+    def test_remove_product_from_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        client.remove_product_from_product_set(name, product)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.RemoveProductFromProductSetRequest(
+            name=name, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_remove_product_from_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        with pytest.raises(CustomException):
+            client.remove_product_from_product_set(name, product)
+
+    def test_list_products_in_product_set(self):
+        # Setup Expected Response
+        next_page_token = ""
+        products_element = {}
+        products = [products_element]
+        expected_response = {"next_page_token": next_page_token, "products": products}
+        expected_response = product_search_service_pb2.ListProductsInProductSetResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        paged_list_response = client.list_products_in_product_set(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.products[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductsInProductSetRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_products_in_product_set_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        paged_list_response = client.list_products_in_product_set(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_import_product_sets(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = product_search_service_pb2.ImportProductSetsResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_import_product_sets", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        input_config = {}
+
+        response = client.import_product_sets(parent, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ImportProductSetsRequest(
+            parent=parent, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_product_sets_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_import_product_sets_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p3beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        input_config = {}
+
+        response = client.import_product_sets(parent, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/gapic/v1p4beta1/test_image_annotator_client_v1p4beta1.py b/vision/tests/unit/gapic/v1p4beta1/test_image_annotator_client_v1p4beta1.py
new file mode 100644
index 000000000000..11a1005b0a4a
--- /dev/null
+++ b/vision/tests/unit/gapic/v1p4beta1/test_image_annotator_client_v1p4beta1.py
@@ -0,0 +1,256 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1p4beta1
+from google.cloud.vision_v1p4beta1.proto import image_annotator_pb2
+from google.longrunning import operations_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestImageAnnotatorClient(object):
+    def test_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_images(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateImagesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_images_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_images(requests)
+
+    def test_batch_annotate_files(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.BatchAnnotateFilesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.batch_annotate_files(requests)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.BatchAnnotateFilesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_batch_annotate_files_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup request
+        requests = []
+
+        with pytest.raises(CustomException):
+            client.batch_annotate_files(requests)
+
+    def test_async_batch_annotate_images(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.AsyncBatchAnnotateImagesResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_images", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+        output_config = {}
+
+        response = client.async_batch_annotate_images(requests, output_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.AsyncBatchAnnotateImagesRequest(
+            requests=requests, output_config=output_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_async_batch_annotate_images_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_images_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+        output_config = {}
+
+        response = client.async_batch_annotate_images(requests, output_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
+
+    def test_async_batch_annotate_files(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = image_annotator_pb2.AsyncBatchAnnotateFilesResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = image_annotator_pb2.AsyncBatchAnnotateFilesRequest(
+            requests=requests
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_async_batch_annotate_files_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_async_batch_annotate_files_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ImageAnnotatorClient()
+
+        # Setup Request
+        requests = []
+
+        response = client.async_batch_annotate_files(requests)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/gapic/v1p4beta1/test_product_search_client_v1p4beta1.py b/vision/tests/unit/gapic/v1p4beta1/test_product_search_client_v1p4beta1.py
new file mode 100644
index 000000000000..1846fe24822b
--- /dev/null
+++ b/vision/tests/unit/gapic/v1p4beta1/test_product_search_client_v1p4beta1.py
@@ -0,0 +1,858 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.rpc import status_pb2
+
+from google.cloud import vision_v1p4beta1
+from google.cloud.vision_v1p4beta1.proto import product_search_service_pb2
+from google.longrunning import operations_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestProductSearchClient(object):
+    def test_create_product_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product_set = {}
+        product_set_id = "productSetId4216680"
+
+        response = client.create_product_set(parent, product_set, product_set_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateProductSetRequest(
+            parent=parent, product_set=product_set, product_set_id=product_set_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product_set = {}
+        product_set_id = "productSetId4216680"
+
+        with pytest.raises(CustomException):
+            client.create_product_set(parent, product_set, product_set_id)
+
+    def test_list_product_sets(self):
+        # Setup Expected Response
+        next_page_token = ""
+        product_sets_element = {}
+        product_sets = [product_sets_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "product_sets": product_sets,
+        }
+        expected_response = product_search_service_pb2.ListProductSetsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_product_sets(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.product_sets[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductSetsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_product_sets_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_product_sets(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_product_set(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name_2, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        response = client.get_product_set(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetProductSetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        with pytest.raises(CustomException):
+            client.get_product_set(name)
+
+    def test_update_product_set(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        expected_response = {"name": name, "display_name": display_name}
+        expected_response = product_search_service_pb2.ProductSet(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        product_set = {}
+        update_mask = {}
+
+        response = client.update_product_set(product_set, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.UpdateProductSetRequest(
+            product_set=product_set, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        product_set = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_product_set(product_set, update_mask)
+
+    def test_delete_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        client.delete_product_set(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteProductSetRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        with pytest.raises(CustomException):
+            client.delete_product_set(name)
+
+    def test_create_product(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product = {}
+        product_id = "productId1753008747"
+
+        response = client.create_product(parent, product, product_id)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateProductRequest(
+            parent=parent, product=product, product_id=product_id
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        product = {}
+        product_id = "productId1753008747"
+
+        with pytest.raises(CustomException):
+            client.create_product(parent, product, product_id)
+
+    def test_list_products(self):
+        # Setup Expected Response
+        next_page_token = ""
+        products_element = {}
+        products = [products_element]
+        expected_response = {"next_page_token": next_page_token, "products": products}
+        expected_response = product_search_service_pb2.ListProductsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_products(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.products[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_products_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+
+        paged_list_response = client.list_products(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_product(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        response = client.get_product(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetProductRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.get_product(name)
+
+    def test_update_product(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        description = "description-1724546052"
+        product_category = "productCategory-1607451058"
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "description": description,
+            "product_category": product_category,
+        }
+        expected_response = product_search_service_pb2.Product(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        product = {}
+        update_mask = {}
+
+        response = client.update_product(product, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.UpdateProductRequest(
+            product=product, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        product = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_product(product, update_mask)
+
+    def test_delete_product(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        client.delete_product(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteProductRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_product_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        with pytest.raises(CustomException):
+            client.delete_product(name)
+
+    def test_create_reference_image(self):
+        # Setup Expected Response
+        name = "name3373707"
+        uri = "uri116076"
+        expected_response = {"name": name, "uri": uri}
+        expected_response = product_search_service_pb2.ReferenceImage(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+        reference_image = {}
+        reference_image_id = "referenceImageId1946713331"
+
+        response = client.create_reference_image(
+            parent, reference_image, reference_image_id
+        )
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.CreateReferenceImageRequest(
+            parent=parent,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+        reference_image = {}
+        reference_image_id = "referenceImageId1946713331"
+
+        with pytest.raises(CustomException):
+            client.create_reference_image(parent, reference_image, reference_image_id)
+
+    def test_delete_reference_image(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        client.delete_reference_image(name)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.DeleteReferenceImageRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.delete_reference_image(name)
+
+    def test_list_reference_images(self):
+        # Setup Expected Response
+        page_size = 883849137
+        next_page_token = ""
+        reference_images_element = {}
+        reference_images = [reference_images_element]
+        expected_response = {
+            "page_size": page_size,
+            "next_page_token": next_page_token,
+            "reference_images": reference_images,
+        }
+        expected_response = product_search_service_pb2.ListReferenceImagesResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        paged_list_response = client.list_reference_images(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.reference_images[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListReferenceImagesRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_reference_images_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        parent = client.product_path("[PROJECT]", "[LOCATION]", "[PRODUCT]")
+
+        paged_list_response = client.list_reference_images(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_reference_image(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        uri = "uri116076"
+        expected_response = {"name": name_2, "uri": uri}
+        expected_response = product_search_service_pb2.ReferenceImage(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        response = client.get_reference_image(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.GetReferenceImageRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_reference_image_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.reference_image_path(
+            "[PROJECT]", "[LOCATION]", "[PRODUCT]", "[REFERENCE_IMAGE]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_reference_image(name)
+
+    def test_add_product_to_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        client.add_product_to_product_set(name, product)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.AddProductToProductSetRequest(
+            name=name, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_add_product_to_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        with pytest.raises(CustomException):
+            client.add_product_to_product_set(name, product)
+
+    def test_remove_product_from_product_set(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        client.remove_product_from_product_set(name, product)
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.RemoveProductFromProductSetRequest(
+            name=name, product=product
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_remove_product_from_product_set_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+        product = "product-309474065"
+
+        with pytest.raises(CustomException):
+            client.remove_product_from_product_set(name, product)
+
+    def test_list_products_in_product_set(self):
+        # Setup Expected Response
+        next_page_token = ""
+        products_element = {}
+        products = [products_element]
+        expected_response = {"next_page_token": next_page_token, "products": products}
+        expected_response = product_search_service_pb2.ListProductsInProductSetResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        paged_list_response = client.list_products_in_product_set(name)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.products[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ListProductsInProductSetRequest(
+            name=name
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_products_in_product_set_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup request
+        name = client.product_set_path("[PROJECT]", "[LOCATION]", "[PRODUCT_SET]")
+
+        paged_list_response = client.list_products_in_product_set(name)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_import_product_sets(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = product_search_service_pb2.ImportProductSetsResponse(
+            **expected_response
+        )
+        operation = operations_pb2.Operation(
+            name="operations/test_import_product_sets", done=True
+        )
+        operation.response.Pack(expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        input_config = {}
+
+        response = client.import_product_sets(parent, input_config)
+        result = response.result()
+        assert expected_response == result
+
+        assert len(channel.requests) == 1
+        expected_request = product_search_service_pb2.ImportProductSetsRequest(
+            parent=parent, input_config=input_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_import_product_sets_exception(self):
+        # Setup Response
+        error = status_pb2.Status()
+        operation = operations_pb2.Operation(
+            name="operations/test_import_product_sets_exception", done=True
+        )
+        operation.error.CopyFrom(error)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[operation])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = vision_v1p4beta1.ProductSearchClient()
+
+        # Setup Request
+        parent = client.location_path("[PROJECT]", "[LOCATION]")
+        input_config = {}
+
+        response = client.import_product_sets(parent, input_config)
+        exception = response.exception()
+        assert exception.errors[0] == error
diff --git a/vision/tests/unit/test_decorators.py b/vision/tests/unit/test_decorators.py
new file mode 100644
index 000000000000..c78707b29829
--- /dev/null
+++ b/vision/tests/unit/test_decorators.py
@@ -0,0 +1,112 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+import unittest
+
+import mock
+
+from google.auth.credentials import Credentials
+from google.cloud import vision
+from google.cloud import vision_helpers
+
+
+class DecoratorTests(unittest.TestCase):
+    def test_noop_without_enums(self):
+        class A(object):
+            pass
+
+        APrime = vision_helpers.decorators.add_single_feature_methods(A)
+
+        # It should be the same class object.
+        assert A is APrime
+
+        # Nothing should have been added.
+        assert not hasattr(A, "face_detection")
+        assert not hasattr(A, "logo_detection")
+
+    def test_with_enums(self):
+        class A(object):
+            enums = vision.enums
+
+        # There should not be detection methods yet.
+        assert not hasattr(A, "face_detection")
+
+        # Add the detection methods.
+        APrime = vision_helpers.decorators.add_single_feature_methods(A)
+        assert A is APrime
+
+        # There should be detection methods now.
+        assert hasattr(A, "face_detection")
+        assert callable(A.face_detection)
+
+
+class SingleFeatureMethodTests(unittest.TestCase):
+    @mock.patch.object(vision.ImageAnnotatorClient, "annotate_image")
+    def test_runs_generic_single_image(self, ai):
+        ai.return_value = vision.types.AnnotateImageResponse()
+
+        # Prove that other aspects of the AnnotateImageRequest, such as the
+        # image context, will be preserved.
+        SENTINEL = mock.sentinel.image_context
+
+        # Make a face detection request.
+        client = vision.ImageAnnotatorClient(credentials=mock.Mock(spec=Credentials))
+        image = {"source": {"image_uri": "gs://my-test-bucket/image.jpg"}}
+        max_results = 50
+        response = client.face_detection(
+            image, image_context=SENTINEL, max_results=max_results
+        )
+        assert isinstance(response, vision.types.AnnotateImageResponse)
+
+        # Assert that the single-image method was called as expected.
+        ai.assert_called_once_with(
+            {
+                "features": [
+                    {
+                        "type": vision.enums.Feature.Type.FACE_DETECTION,
+                        "max_results": max_results,
+                    }
+                ],
+                "image": image,
+                "image_context": SENTINEL,
+            },
+            retry=None,
+            timeout=None,
+        )
+
+    @mock.patch.object(vision.ImageAnnotatorClient, "annotate_image")
+    def test_runs_generic_single_image_without_max_results(self, ai):
+        ai.return_value = vision.types.AnnotateImageResponse()
+
+        # Prove that other aspects of the AnnotateImageRequest, such as the
+        # image context, will be preserved.
+        SENTINEL = mock.sentinel.image_context
+
+        # Make a face detection request.
+        client = vision.ImageAnnotatorClient(credentials=mock.Mock(spec=Credentials))
+        image = {"source": {"image_uri": "gs://my-test-bucket/image.jpg"}}
+        response = client.face_detection(image, image_context=SENTINEL)
+        assert isinstance(response, vision.types.AnnotateImageResponse)
+
+        # Assert that the single-image method was called as expected.
+        ai.assert_called_once_with(
+            {
+                "features": [{"type": vision.enums.Feature.Type.FACE_DETECTION}],
+                "image": image,
+                "image_context": SENTINEL,
+            },
+            retry=None,
+            timeout=None,
+        )
diff --git a/vision/tests/unit/test_helpers.py b/vision/tests/unit/test_helpers.py
new file mode 100644
index 000000000000..97239a140d28
--- /dev/null
+++ b/vision/tests/unit/test_helpers.py
@@ -0,0 +1,129 @@
+# Copyright 2017, Google LLC 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.
+
+from __future__ import absolute_import
+import io
+import unittest
+
+import mock
+
+from google.auth.credentials import Credentials
+
+from google.cloud.vision_v1 import ImageAnnotatorClient
+from google.cloud.vision_v1 import types
+
+
+class TestSingleImageHelper(unittest.TestCase):
+    def setUp(self):
+        credentials = mock.Mock(spec=Credentials)
+        self.client = ImageAnnotatorClient(credentials=credentials)
+
+    @mock.patch.object(ImageAnnotatorClient, "batch_annotate_images")
+    def test_all_features_default(self, batch_annotate):
+        # Set up an image annotation request with no features.
+        image = types.Image(source={"image_uri": "http://foo.com/img.jpg"})
+        request = types.AnnotateImageRequest(image=image)
+        assert not request.features
+
+        # Perform the single image request.
+        self.client.annotate_image(request)
+
+        # Evalute the argument sent to batch_annotate_images.
+        assert batch_annotate.call_count == 1
+        _, args, kwargs = batch_annotate.mock_calls[0]
+
+        # Only a single request object should be sent.
+        assert len(args[0]) == 1
+
+        # Evalute the request object to ensure it looks correct.
+        request_sent = args[0][0]
+        all_features = self.client._get_all_features()
+        assert request_sent.image is request.image
+        assert len(request_sent.features) == len(all_features)
+
+    @mock.patch.object(ImageAnnotatorClient, "batch_annotate_images")
+    def test_explicit_features(self, batch_annotate):
+        # Set up an image annotation request with no features.
+        image = types.Image(source={"image_uri": "http://foo.com/img.jpg"})
+        request = types.AnnotateImageRequest(
+            image=image,
+            features=[
+                types.Feature(type=1),
+                types.Feature(type=2),
+                types.Feature(type=3),
+            ],
+        )
+
+        # Perform the single image request.
+        self.client.annotate_image(request)
+
+        # Evalute the argument sent to batch_annotate_images.
+        assert batch_annotate.call_count == 1
+        _, args, kwargs = batch_annotate.mock_calls[0]
+
+        # Only a single request object should be sent.
+        assert len(args[0]) == 1
+
+        # Evalute the request object to ensure it looks correct.
+        request_sent = args[0][0]
+        assert request_sent.image is request.image
+        assert len(request_sent.features) == 3
+        for feature, i in zip(request_sent.features, range(1, 4)):
+            assert feature.type == i
+            assert feature.max_results == 0
+
+    @mock.patch.object(ImageAnnotatorClient, "batch_annotate_images")
+    def test_image_file_handler(self, batch_annotate):
+        # Set up a file handler.
+        file_ = io.BytesIO(b"bogus==")
+
+        # Perform the single image request.
+        self.client.annotate_image({"image": file_})
+
+        # Evaluate the argument sent to batch_annotate_images.
+        assert batch_annotate.call_count == 1
+        _, args, kwargs = batch_annotate.mock_calls[0]
+
+        # Only a single request object should be sent.
+        assert len(args[0]) == 1
+
+        # Evalute the request object to ensure it looks correct.
+        request_sent = args[0][0]
+        assert request_sent["image"]["content"] == b"bogus=="
+
+    @mock.patch.object(ImageAnnotatorClient, "batch_annotate_images")
+    @mock.patch.object(io, "open")
+    def test_image_filename(self, io_open, batch_annotate):
+        # Make io.open send back a mock with a read method.
+        file_ = mock.MagicMock(spec=io.BytesIO)
+        io_open.return_value = file_
+        file_.__enter__.return_value = file_
+        file_.read.return_value = b"imagefile=="
+
+        # Perform the single image request using a filename.
+        self.client.annotate_image({"image": {"source": {"filename": "image.jpeg"}}})
+
+        # Establish that my file was opened.
+        io_open.assert_called_once_with("image.jpeg", "rb")
+
+        # Evalute the argument sent to batch_annotate_images.
+        assert batch_annotate.call_count == 1
+        _, args, kwargs = batch_annotate.mock_calls[0]
+
+        # Only a single request object should be sent.
+        assert len(args[0]) == 1
+
+        # Evalute the request object to ensure it looks correct.
+        request_sent = args[0][0]
+        assert request_sent["image"]["content"] == b"imagefile=="
diff --git a/webrisk/.coveragerc b/webrisk/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/webrisk/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/webrisk/.flake8 b/webrisk/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/webrisk/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/webrisk/.repo-metadata.json b/webrisk/.repo-metadata.json
new file mode 100644
index 000000000000..f240f01bfb68
--- /dev/null
+++ b/webrisk/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "webrisk",
+  "name_pretty": "Web Risk",
+  "product_documentation": "https://cloud.google.com/web-risk/docs/",
+  "client_documentation": "https://googleapis.dev/python/webrisk/latest",
+  "issue_tracker": "",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-webrisk",
+  "api_id": "webrisk.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/webrisk/CHANGELOG.md b/webrisk/CHANGELOG.md
new file mode 100644
index 000000000000..c7e7c14b5c76
--- /dev/null
+++ b/webrisk/CHANGELOG.md
@@ -0,0 +1,41 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-webrisk/#history
+## 0.2.0
+
+07-24-2019 17:55 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8412](https://github.com/googleapis/google-cloud-python/pull/8412))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8530](https://github.com/googleapis/google-cloud-python/pull/8530))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth). ([#8372](https://github.com/googleapis/google-cloud-python/pull/8372))
+- Add disclaimer to auto-generated template files. ([#8336](https://github.com/googleapis/google-cloud-python/pull/8336))
+- Fix coverage in 'types.py' (via synth). ([#8171](https://github.com/googleapis/google-cloud-python/pull/8171))
+- Add empty lines (via synth). ([#8078](https://github.com/googleapis/google-cloud-python/pull/8078))
+
+## 0.1.0
+
+04-16-2019 17:09 PDT
+
+
+### New Features
+- Initial release of Web Risk. ([#7651](https://github.com/googleapis/google-cloud-python/pull/7651))
+
+### Documentation
+- Add whitelist info to README. ([#7717](https://github.com/googleapis/google-cloud-python/pull/7717))
+
diff --git a/webrisk/LICENSE b/webrisk/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/webrisk/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/webrisk/MANIFEST.in b/webrisk/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/webrisk/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/webrisk/README.rst b/webrisk/README.rst
new file mode 100644
index 000000000000..a54f28e0f3a9
--- /dev/null
+++ b/webrisk/README.rst
@@ -0,0 +1,81 @@
+Python Client for Web Risk API (`Alpha`_)
+=========================================
+
+
+
+**Note:** Cloud Web Risk is not yet publicly available. You must be whitelisted in order to gain access. See `Setting up the Web Risk API`_ in the product documentation for a link to the sign-up form.
+
+.. _Setting up the Web Risk API:
+
+`Web Risk API`: https://cloud.google.com/web-risk/docs/quickstart
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. _Alpha: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
+.. _Web Risk API: https://cloud.google.com/webrisk
+.. _Client Library Documentation: https://googleapis.dev/python/webrisk/latest
+.. _Product Documentation:  https://cloud.google.com/webrisk
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Web Risk API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Web Risk API.:  https://cloud.google.com/webrisk
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-webrisk
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-webrisk
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Web Risk API
+   API to see other available methods on the client.
+-  Read the `Web Risk API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
+
+.. _Web Risk API Product documentation:  https://cloud.google.com/webrisk
+.. _repository’s main README: https://github.com/googleapis/google-cloud-python/blob/master/README.rst
diff --git a/webrisk/docs/README.rst b/webrisk/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/webrisk/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/webrisk/docs/changelog.md b/webrisk/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/webrisk/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/webrisk/docs/conf.py b/webrisk/docs/conf.py
new file mode 100644
index 000000000000..928f5b98c6bf
--- /dev/null
+++ b/webrisk/docs/conf.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-webrisk documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-webrisk"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-webrisk-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-webrisk.tex",
+        u"google-cloud-webrisk Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-webrisk",
+        u"google-cloud-webrisk Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-webrisk",
+        u"google-cloud-webrisk Documentation",
+        author,
+        "google-cloud-webrisk",
+        "GAPIC library for the {metadata.shortName} v1beta1 service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/webrisk/docs/gapic/v1beta1/api.rst b/webrisk/docs/gapic/v1beta1/api.rst
new file mode 100644
index 000000000000..d939a64ab665
--- /dev/null
+++ b/webrisk/docs/gapic/v1beta1/api.rst
@@ -0,0 +1,6 @@
+Client for Web Risk API
+=======================
+
+.. automodule:: google.cloud.webrisk_v1beta1
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/webrisk/docs/gapic/v1beta1/types.rst b/webrisk/docs/gapic/v1beta1/types.rst
new file mode 100644
index 000000000000..e3d2bc86bb51
--- /dev/null
+++ b/webrisk/docs/gapic/v1beta1/types.rst
@@ -0,0 +1,5 @@
+Types for Web Risk API Client
+=============================
+
+.. automodule:: google.cloud.webrisk_v1beta1.types
+    :members:
\ No newline at end of file
diff --git a/webrisk/docs/index.rst b/webrisk/docs/index.rst
new file mode 100644
index 000000000000..0df8ada047ca
--- /dev/null
+++ b/webrisk/docs/index.rst
@@ -0,0 +1,10 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta1/api
+    gapic/v1beta1/types
+    changelog
\ No newline at end of file
diff --git a/webrisk/google/__init__.py b/webrisk/google/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/webrisk/google/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/webrisk/google/cloud/__init__.py b/webrisk/google/cloud/__init__.py
new file mode 100644
index 000000000000..8fcc60e2b9c6
--- /dev/null
+++ b/webrisk/google/cloud/__init__.py
@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/webrisk/google/cloud/webrisk.py b/webrisk/google/cloud/webrisk.py
new file mode 100644
index 000000000000..6b9be6efb038
--- /dev/null
+++ b/webrisk/google/cloud/webrisk.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.webrisk_v1beta1 import WebRiskServiceV1Beta1Client
+from google.cloud.webrisk_v1beta1 import enums
+from google.cloud.webrisk_v1beta1 import types
+
+
+__all__ = ("enums", "types", "WebRiskServiceV1Beta1Client")
diff --git a/webrisk/google/cloud/webrisk_v1beta1/__init__.py b/webrisk/google/cloud/webrisk_v1beta1/__init__.py
new file mode 100644
index 000000000000..a02bc357affc
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/__init__.py
@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.webrisk_v1beta1 import types
+from google.cloud.webrisk_v1beta1.gapic import enums
+from google.cloud.webrisk_v1beta1.gapic import web_risk_service_v1_beta1_client
+
+
+class WebRiskServiceV1Beta1Client(
+    web_risk_service_v1_beta1_client.WebRiskServiceV1Beta1Client
+):
+    __doc__ = web_risk_service_v1_beta1_client.WebRiskServiceV1Beta1Client.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "WebRiskServiceV1Beta1Client")
diff --git a/webrisk/google/cloud/webrisk_v1beta1/gapic/__init__.py b/webrisk/google/cloud/webrisk_v1beta1/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/webrisk/google/cloud/webrisk_v1beta1/gapic/enums.py b/webrisk/google/cloud/webrisk_v1beta1/gapic/enums.py
new file mode 100644
index 000000000000..07580b04e6bf
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/gapic/enums.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class CompressionType(enum.IntEnum):
+    """
+    The ways in which threat entry sets can be compressed.
+
+    Attributes:
+      COMPRESSION_TYPE_UNSPECIFIED (int): Unknown.
+      RAW (int): Raw, uncompressed data.
+      RICE (int): Rice-Golomb encoded data.
+    """
+
+    COMPRESSION_TYPE_UNSPECIFIED = 0
+    RAW = 1
+    RICE = 2
+
+
+class ThreatType(enum.IntEnum):
+    """
+    The type of threat. This maps dirrectly to the threat list a threat may
+    belong to.
+
+    Attributes:
+      THREAT_TYPE_UNSPECIFIED (int): Unknown.
+      MALWARE (int): Malware targeting any platform.
+      SOCIAL_ENGINEERING (int): Social engineering targeting any platform.
+      UNWANTED_SOFTWARE (int): Unwanted software targeting any platform.
+    """
+
+    THREAT_TYPE_UNSPECIFIED = 0
+    MALWARE = 1
+    SOCIAL_ENGINEERING = 2
+    UNWANTED_SOFTWARE = 3
+
+
+class ComputeThreatListDiffResponse(object):
+    class ResponseType(enum.IntEnum):
+        """
+        The type of response sent to the client.
+
+        Attributes:
+          RESPONSE_TYPE_UNSPECIFIED (int): Unknown.
+          DIFF (int): Partial updates are applied to the client's existing local database.
+          RESET (int): 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.
+        """
+
+        RESPONSE_TYPE_UNSPECIFIED = 0
+        DIFF = 1
+        RESET = 2
diff --git a/webrisk/google/cloud/webrisk_v1beta1/gapic/transports/__init__.py b/webrisk/google/cloud/webrisk_v1beta1/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/webrisk/google/cloud/webrisk_v1beta1/gapic/transports/web_risk_service_v1_beta1_grpc_transport.py b/webrisk/google/cloud/webrisk_v1beta1/gapic/transports/web_risk_service_v1_beta1_grpc_transport.py
new file mode 100644
index 000000000000..773c0afc9601
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/gapic/transports/web_risk_service_v1_beta1_grpc_transport.py
@@ -0,0 +1,153 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.webrisk_v1beta1.proto import webrisk_pb2_grpc
+
+
+class WebRiskServiceV1Beta1GrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.webrisk.v1beta1 WebRiskServiceV1Beta1 API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self, channel=None, credentials=None, address="webrisk.googleapis.com:443"
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "web_risk_service_v1_beta1_stub": webrisk_pb2_grpc.WebRiskServiceV1Beta1Stub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="webrisk.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def compute_threat_list_diff(self):
+        """Return the gRPC stub for :meth:`WebRiskServiceV1Beta1Client.compute_threat_list_diff`.
+
+        Gets the most recent threat list diffs.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_risk_service_v1_beta1_stub"].ComputeThreatListDiff
+
+    @property
+    def search_uris(self):
+        """Return the gRPC stub for :meth:`WebRiskServiceV1Beta1Client.search_uris`.
+
+        This method is used to check whether a URI is on a given threatList.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_risk_service_v1_beta1_stub"].SearchUris
+
+    @property
+    def search_hashes(self):
+        """Return the gRPC stub for :meth:`WebRiskServiceV1Beta1Client.search_hashes`.
+
+        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.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_risk_service_v1_beta1_stub"].SearchHashes
diff --git a/webrisk/google/cloud/webrisk_v1beta1/gapic/web_risk_service_v1_beta1_client.py b/webrisk/google/cloud/webrisk_v1beta1/gapic/web_risk_service_v1_beta1_client.py
new file mode 100644
index 000000000000..93cefba2b5d1
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/gapic/web_risk_service_v1_beta1_client.py
@@ -0,0 +1,385 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.webrisk.v1beta1 WebRiskServiceV1Beta1 API."""
+
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.grpc_helpers
+import grpc
+
+from google.cloud.webrisk_v1beta1.gapic import enums
+from google.cloud.webrisk_v1beta1.gapic import web_risk_service_v1_beta1_client_config
+from google.cloud.webrisk_v1beta1.gapic.transports import (
+    web_risk_service_v1_beta1_grpc_transport,
+)
+from google.cloud.webrisk_v1beta1.proto import webrisk_pb2
+from google.cloud.webrisk_v1beta1.proto import webrisk_pb2_grpc
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-webrisk").version
+
+
+class WebRiskServiceV1Beta1Client(object):
+    """
+    Web Risk v1beta1 API defines an interface to detect malicious URLs on your
+    website and in client applications.
+    """
+
+    SERVICE_ADDRESS = "webrisk.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            WebRiskServiceV1Beta1Client: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.WebRiskServiceV1Beta1GrpcTransport,
+                    Callable[[~.Credentials, type], ~.WebRiskServiceV1Beta1GrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = web_risk_service_v1_beta1_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=web_risk_service_v1_beta1_grpc_transport.WebRiskServiceV1Beta1GrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = web_risk_service_v1_beta1_grpc_transport.WebRiskServiceV1Beta1GrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def compute_threat_list_diff(
+        self,
+        threat_type,
+        constraints,
+        version_token=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets the most recent threat list diffs.
+
+        Example:
+            >>> from google.cloud import webrisk_v1beta1
+            >>> from google.cloud.webrisk_v1beta1 import enums
+            >>>
+            >>> client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+            >>>
+            >>> # TODO: Initialize `threat_type`:
+            >>> threat_type = enums.ThreatType.THREAT_TYPE_UNSPECIFIED
+            >>>
+            >>> # TODO: Initialize `constraints`:
+            >>> constraints = {}
+            >>>
+            >>> response = client.compute_threat_list_diff(threat_type, constraints)
+
+        Args:
+            threat_type (~google.cloud.webrisk_v1beta1.types.ThreatType): Required. The ThreatList to update.
+            constraints (Union[dict, ~google.cloud.webrisk_v1beta1.types.Constraints]): The constraints associated with this request.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.webrisk_v1beta1.types.Constraints`
+            version_token (bytes): The current version token of the client for the requested list (the
+                client version that was received from the last successful diff).
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.webrisk_v1beta1.types.ComputeThreatListDiffResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "compute_threat_list_diff" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "compute_threat_list_diff"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.compute_threat_list_diff,
+                default_retry=self._method_configs["ComputeThreatListDiff"].retry,
+                default_timeout=self._method_configs["ComputeThreatListDiff"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = webrisk_pb2.ComputeThreatListDiffRequest(
+            threat_type=threat_type,
+            constraints=constraints,
+            version_token=version_token,
+        )
+        return self._inner_api_calls["compute_threat_list_diff"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_uris(
+        self,
+        uri,
+        threat_types,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        This method is used to check whether a URI is on a given threatList.
+
+        Example:
+            >>> from google.cloud import webrisk_v1beta1
+            >>> from google.cloud.webrisk_v1beta1 import enums
+            >>>
+            >>> client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+            >>>
+            >>> # TODO: Initialize `uri`:
+            >>> uri = ''
+            >>>
+            >>> # TODO: Initialize `threat_types`:
+            >>> threat_types = []
+            >>>
+            >>> response = client.search_uris(uri, threat_types)
+
+        Args:
+            uri (str): The URI to be checked for matches.
+            threat_types (list[~google.cloud.webrisk_v1beta1.types.ThreatType]): Required. The ThreatLists to search in.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.webrisk_v1beta1.types.SearchUrisResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_uris" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_uris"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_uris,
+                default_retry=self._method_configs["SearchUris"].retry,
+                default_timeout=self._method_configs["SearchUris"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = webrisk_pb2.SearchUrisRequest(uri=uri, threat_types=threat_types)
+        return self._inner_api_calls["search_uris"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def search_hashes(
+        self,
+        hash_prefix=None,
+        threat_types=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        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.
+
+        Example:
+            >>> from google.cloud import webrisk_v1beta1
+            >>>
+            >>> client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+            >>>
+            >>> response = client.search_hashes()
+
+        Args:
+            hash_prefix (bytes): A hash prefix, consisting of the most significant 4-32 bytes of a SHA256
+                hash. For JSON requests, this field is base64-encoded.
+            threat_types (list[~google.cloud.webrisk_v1beta1.types.ThreatType]): Required. The ThreatLists to search in.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.webrisk_v1beta1.types.SearchHashesResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "search_hashes" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "search_hashes"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.search_hashes,
+                default_retry=self._method_configs["SearchHashes"].retry,
+                default_timeout=self._method_configs["SearchHashes"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = webrisk_pb2.SearchHashesRequest(
+            hash_prefix=hash_prefix, threat_types=threat_types
+        )
+        return self._inner_api_calls["search_hashes"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/webrisk/google/cloud/webrisk_v1beta1/gapic/web_risk_service_v1_beta1_client_config.py b/webrisk/google/cloud/webrisk_v1beta1/gapic/web_risk_service_v1_beta1_client_config.py
new file mode 100644
index 000000000000..dd153e419c12
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/gapic/web_risk_service_v1_beta1_client_config.py
@@ -0,0 +1,38 @@
+config = {
+    "interfaces": {
+        "google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "ComputeThreatListDiff": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchUris": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "SearchHashes": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/webrisk/google/cloud/webrisk_v1beta1/proto/__init__.py b/webrisk/google/cloud/webrisk_v1beta1/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk.proto b/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk.proto
new file mode 100644
index 000000000000..c6b5f7c90ce8
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk.proto
@@ -0,0 +1,295 @@
+// 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.webrisk.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.WebRisk.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/webrisk/v1beta1;webrisk";
+option java_multiple_files = true;
+option java_outer_classname = "WebRiskProto";
+option java_package = "com.google.webrisk.v1beta1";
+option objc_class_prefix = "GCWR";
+option php_namespace = "Google\\Cloud\\WebRisk\\V1beta1";
+
+// Web Risk v1beta1 API defines an interface to detect malicious URLs on your
+// website and in client applications.
+service WebRiskServiceV1Beta1 {
+  // Gets the most recent threat list diffs.
+  rpc ComputeThreatListDiff(ComputeThreatListDiffRequest)
+      returns (ComputeThreatListDiffResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/threatLists:computeDiff"
+    };
+  }
+
+  // This method is used to check whether a URI is on a given threatList.
+  rpc SearchUris(SearchUrisRequest) returns (SearchUrisResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/uris:search"
+    };
+  }
+
+  // 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: "/v1beta1/hashes:search"
+    };
+  }
+}
+
+// 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 ThreatList to update.
+  ThreatType threat_type = 1;
+
+  // 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;
+}
+
+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 is required 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.
+  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
+  // disregard 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 {
+  // The URI to be checked for matches.
+  string uri = 1;
+
+  // Required. The ThreatLists to search in.
+  repeated ThreatType threat_types = 2;
+}
+
+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.
+  repeated ThreatType threat_types = 2;
+}
+
+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).
+  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;
+}
diff --git a/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk_pb2.py b/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk_pb2.py
new file mode 100644
index 000000000000..7b61ac5aa53a
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk_pb2.py
@@ -0,0 +1,1585 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/webrisk_v1beta1/proto/webrisk.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/webrisk_v1beta1/proto/webrisk.proto",
+    package="google.cloud.webrisk.v1beta1",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n\032com.google.webrisk.v1beta1B\014WebRiskProtoP\001ZCgoogle.golang.org/genproto/googleapis/cloud/webrisk/v1beta1;webrisk\242\002\004GCWR\252\002\034Google.Cloud.WebRisk.V1Beta1\312\002\034Google\\Cloud\\WebRisk\\V1beta1"
+    ),
+    serialized_pb=_b(
+        '\n0google/cloud/webrisk_v1beta1/proto/webrisk.proto\x12\x1cgoogle.cloud.webrisk.v1beta1\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xe8\x02\n\x1c\x43omputeThreatListDiffRequest\x12=\n\x0bthreat_type\x18\x01 \x01(\x0e\x32(.google.cloud.webrisk.v1beta1.ThreatType\x12\x15\n\rversion_token\x18\x02 \x01(\x0c\x12[\n\x0b\x63onstraints\x18\x03 \x01(\x0b\x32\x46.google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.Constraints\x1a\x94\x01\n\x0b\x43onstraints\x12\x18\n\x10max_diff_entries\x18\x01 \x01(\x05\x12\x1c\n\x14max_database_entries\x18\x02 \x01(\x05\x12M\n\x16supported_compressions\x18\x03 \x03(\x0e\x32-.google.cloud.webrisk.v1beta1.CompressionType"\x9a\x04\n\x1d\x43omputeThreatListDiffResponse\x12_\n\rresponse_type\x18\x04 \x01(\x0e\x32H.google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.ResponseType\x12\x45\n\tadditions\x18\x05 \x01(\x0b\x32\x32.google.cloud.webrisk.v1beta1.ThreatEntryAdditions\x12\x43\n\x08removals\x18\x06 \x01(\x0b\x32\x31.google.cloud.webrisk.v1beta1.ThreatEntryRemovals\x12\x19\n\x11new_version_token\x18\x07 \x01(\x0c\x12V\n\x08\x63hecksum\x18\x08 \x01(\x0b\x32\x44.google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.Checksum\x12\x39\n\x15recommended_next_diff\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a\x1a\n\x08\x43hecksum\x12\x0e\n\x06sha256\x18\x01 \x01(\x0c"B\n\x0cResponseType\x12\x1d\n\x19RESPONSE_TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x44IFF\x10\x01\x12\t\n\x05RESET\x10\x02"`\n\x11SearchUrisRequest\x12\x0b\n\x03uri\x18\x01 \x01(\t\x12>\n\x0cthreat_types\x18\x02 \x03(\x0e\x32(.google.cloud.webrisk.v1beta1.ThreatType"\xde\x01\n\x12SearchUrisResponse\x12J\n\x06threat\x18\x01 \x01(\x0b\x32:.google.cloud.webrisk.v1beta1.SearchUrisResponse.ThreatUri\x1a|\n\tThreatUri\x12>\n\x0cthreat_types\x18\x01 \x03(\x0e\x32(.google.cloud.webrisk.v1beta1.ThreatType\x12/\n\x0b\x65xpire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"j\n\x13SearchHashesRequest\x12\x13\n\x0bhash_prefix\x18\x01 \x01(\x0c\x12>\n\x0cthreat_types\x18\x02 \x03(\x0e\x32(.google.cloud.webrisk.v1beta1.ThreatType"\xae\x02\n\x14SearchHashesResponse\x12N\n\x07threats\x18\x01 \x03(\x0b\x32=.google.cloud.webrisk.v1beta1.SearchHashesResponse.ThreatHash\x12\x38\n\x14negative_expire_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a\x8b\x01\n\nThreatHash\x12>\n\x0cthreat_types\x18\x01 \x03(\x0e\x32(.google.cloud.webrisk.v1beta1.ThreatType\x12\x0c\n\x04hash\x18\x02 \x01(\x0c\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x99\x01\n\x14ThreatEntryAdditions\x12;\n\nraw_hashes\x18\x01 \x03(\x0b\x32\'.google.cloud.webrisk.v1beta1.RawHashes\x12\x44\n\x0brice_hashes\x18\x02 \x01(\x0b\x32/.google.cloud.webrisk.v1beta1.RiceDeltaEncoding"\x9b\x01\n\x13ThreatEntryRemovals\x12=\n\x0braw_indices\x18\x01 \x01(\x0b\x32(.google.cloud.webrisk.v1beta1.RawIndices\x12\x45\n\x0crice_indices\x18\x02 \x01(\x0b\x32/.google.cloud.webrisk.v1beta1.RiceDeltaEncoding"\x1d\n\nRawIndices\x12\x0f\n\x07indices\x18\x01 \x03(\x05"4\n\tRawHashes\x12\x13\n\x0bprefix_size\x18\x01 \x01(\x05\x12\x12\n\nraw_hashes\x18\x02 \x01(\x0c"k\n\x11RiceDeltaEncoding\x12\x13\n\x0b\x66irst_value\x18\x01 \x01(\x03\x12\x16\n\x0erice_parameter\x18\x02 \x01(\x05\x12\x13\n\x0b\x65ntry_count\x18\x03 \x01(\x05\x12\x14\n\x0c\x65ncoded_data\x18\x04 \x01(\x0c*e\n\nThreatType\x12\x1b\n\x17THREAT_TYPE_UNSPECIFIED\x10\x00\x12\x0b\n\x07MALWARE\x10\x01\x12\x16\n\x12SOCIAL_ENGINEERING\x10\x02\x12\x15\n\x11UNWANTED_SOFTWARE\x10\x03*F\n\x0f\x43ompressionType\x12 \n\x1c\x43OMPRESSION_TYPE_UNSPECIFIED\x10\x00\x12\x07\n\x03RAW\x10\x01\x12\x08\n\x04RICE\x10\x02\x32\xfc\x03\n\x15WebRiskServiceV1Beta1\x12\xba\x01\n\x15\x43omputeThreatListDiff\x12:.google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest\x1a;.google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse"(\x82\xd3\xe4\x93\x02"\x12 /v1beta1/threatLists:computeDiff\x12\x8d\x01\n\nSearchUris\x12/.google.cloud.webrisk.v1beta1.SearchUrisRequest\x1a\x30.google.cloud.webrisk.v1beta1.SearchUrisResponse"\x1c\x82\xd3\xe4\x93\x02\x16\x12\x14/v1beta1/uris:search\x12\x95\x01\n\x0cSearchHashes\x12\x31.google.cloud.webrisk.v1beta1.SearchHashesRequest\x1a\x32.google.cloud.webrisk.v1beta1.SearchHashesResponse"\x1e\x82\xd3\xe4\x93\x02\x18\x12\x16/v1beta1/hashes:searchB\xb6\x01\n\x1a\x63om.google.webrisk.v1beta1B\x0cWebRiskProtoP\x01ZCgoogle.golang.org/genproto/googleapis/cloud/webrisk/v1beta1;webrisk\xa2\x02\x04GCWR\xaa\x02\x1cGoogle.Cloud.WebRisk.V1Beta1\xca\x02\x1cGoogle\\Cloud\\WebRisk\\V1beta1b\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+_THREATTYPE = _descriptor.EnumDescriptor(
+    name="ThreatType",
+    full_name="google.cloud.webrisk.v1beta1.ThreatType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="THREAT_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MALWARE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SOCIAL_ENGINEERING",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNWANTED_SOFTWARE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2293,
+    serialized_end=2394,
+)
+_sym_db.RegisterEnumDescriptor(_THREATTYPE)
+
+ThreatType = enum_type_wrapper.EnumTypeWrapper(_THREATTYPE)
+_COMPRESSIONTYPE = _descriptor.EnumDescriptor(
+    name="CompressionType",
+    full_name="google.cloud.webrisk.v1beta1.CompressionType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="COMPRESSION_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RAW", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RICE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=2396,
+    serialized_end=2466,
+)
+_sym_db.RegisterEnumDescriptor(_COMPRESSIONTYPE)
+
+CompressionType = enum_type_wrapper.EnumTypeWrapper(_COMPRESSIONTYPE)
+THREAT_TYPE_UNSPECIFIED = 0
+MALWARE = 1
+SOCIAL_ENGINEERING = 2
+UNWANTED_SOFTWARE = 3
+COMPRESSION_TYPE_UNSPECIFIED = 0
+RAW = 1
+RICE = 2
+
+
+_COMPUTETHREATLISTDIFFRESPONSE_RESPONSETYPE = _descriptor.EnumDescriptor(
+    name="ResponseType",
+    full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.ResponseType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RESPONSE_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DIFF", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESET", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=981,
+    serialized_end=1047,
+)
+_sym_db.RegisterEnumDescriptor(_COMPUTETHREATLISTDIFFRESPONSE_RESPONSETYPE)
+
+
+_COMPUTETHREATLISTDIFFREQUEST_CONSTRAINTS = _descriptor.Descriptor(
+    name="Constraints",
+    full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.Constraints",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="max_diff_entries",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.Constraints.max_diff_entries",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_database_entries",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.Constraints.max_database_entries",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="supported_compressions",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.Constraints.supported_compressions",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=358,
+    serialized_end=506,
+)
+
+_COMPUTETHREATLISTDIFFREQUEST = _descriptor.Descriptor(
+    name="ComputeThreatListDiffRequest",
+    full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="threat_type",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.threat_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version_token",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.version_token",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="constraints",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.constraints",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_COMPUTETHREATLISTDIFFREQUEST_CONSTRAINTS],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=146,
+    serialized_end=506,
+)
+
+
+_COMPUTETHREATLISTDIFFRESPONSE_CHECKSUM = _descriptor.Descriptor(
+    name="Checksum",
+    full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.Checksum",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="sha256",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.Checksum.sha256",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=953,
+    serialized_end=979,
+)
+
+_COMPUTETHREATLISTDIFFRESPONSE = _descriptor.Descriptor(
+    name="ComputeThreatListDiffResponse",
+    full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="response_type",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.response_type",
+            index=0,
+            number=4,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="additions",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.additions",
+            index=1,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="removals",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.removals",
+            index=2,
+            number=6,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="new_version_token",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.new_version_token",
+            index=3,
+            number=7,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="checksum",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.checksum",
+            index=4,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="recommended_next_diff",
+            full_name="google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.recommended_next_diff",
+            index=5,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_COMPUTETHREATLISTDIFFRESPONSE_CHECKSUM],
+    enum_types=[_COMPUTETHREATLISTDIFFRESPONSE_RESPONSETYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=509,
+    serialized_end=1047,
+)
+
+
+_SEARCHURISREQUEST = _descriptor.Descriptor(
+    name="SearchUrisRequest",
+    full_name="google.cloud.webrisk.v1beta1.SearchUrisRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="uri",
+            full_name="google.cloud.webrisk.v1beta1.SearchUrisRequest.uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="threat_types",
+            full_name="google.cloud.webrisk.v1beta1.SearchUrisRequest.threat_types",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1049,
+    serialized_end=1145,
+)
+
+
+_SEARCHURISRESPONSE_THREATURI = _descriptor.Descriptor(
+    name="ThreatUri",
+    full_name="google.cloud.webrisk.v1beta1.SearchUrisResponse.ThreatUri",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="threat_types",
+            full_name="google.cloud.webrisk.v1beta1.SearchUrisResponse.ThreatUri.threat_types",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.cloud.webrisk.v1beta1.SearchUrisResponse.ThreatUri.expire_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1246,
+    serialized_end=1370,
+)
+
+_SEARCHURISRESPONSE = _descriptor.Descriptor(
+    name="SearchUrisResponse",
+    full_name="google.cloud.webrisk.v1beta1.SearchUrisResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="threat",
+            full_name="google.cloud.webrisk.v1beta1.SearchUrisResponse.threat",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[_SEARCHURISRESPONSE_THREATURI],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1148,
+    serialized_end=1370,
+)
+
+
+_SEARCHHASHESREQUEST = _descriptor.Descriptor(
+    name="SearchHashesRequest",
+    full_name="google.cloud.webrisk.v1beta1.SearchHashesRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="hash_prefix",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesRequest.hash_prefix",
+            index=0,
+            number=1,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="threat_types",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesRequest.threat_types",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1372,
+    serialized_end=1478,
+)
+
+
+_SEARCHHASHESRESPONSE_THREATHASH = _descriptor.Descriptor(
+    name="ThreatHash",
+    full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse.ThreatHash",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="threat_types",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse.ThreatHash.threat_types",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="hash",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse.ThreatHash.hash",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="expire_time",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse.ThreatHash.expire_time",
+            index=2,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1644,
+    serialized_end=1783,
+)
+
+_SEARCHHASHESRESPONSE = _descriptor.Descriptor(
+    name="SearchHashesResponse",
+    full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="threats",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse.threats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="negative_expire_time",
+            full_name="google.cloud.webrisk.v1beta1.SearchHashesResponse.negative_expire_time",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SEARCHHASHESRESPONSE_THREATHASH],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1481,
+    serialized_end=1783,
+)
+
+
+_THREATENTRYADDITIONS = _descriptor.Descriptor(
+    name="ThreatEntryAdditions",
+    full_name="google.cloud.webrisk.v1beta1.ThreatEntryAdditions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="raw_hashes",
+            full_name="google.cloud.webrisk.v1beta1.ThreatEntryAdditions.raw_hashes",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rice_hashes",
+            full_name="google.cloud.webrisk.v1beta1.ThreatEntryAdditions.rice_hashes",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1786,
+    serialized_end=1939,
+)
+
+
+_THREATENTRYREMOVALS = _descriptor.Descriptor(
+    name="ThreatEntryRemovals",
+    full_name="google.cloud.webrisk.v1beta1.ThreatEntryRemovals",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="raw_indices",
+            full_name="google.cloud.webrisk.v1beta1.ThreatEntryRemovals.raw_indices",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rice_indices",
+            full_name="google.cloud.webrisk.v1beta1.ThreatEntryRemovals.rice_indices",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1942,
+    serialized_end=2097,
+)
+
+
+_RAWINDICES = _descriptor.Descriptor(
+    name="RawIndices",
+    full_name="google.cloud.webrisk.v1beta1.RawIndices",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="indices",
+            full_name="google.cloud.webrisk.v1beta1.RawIndices.indices",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2099,
+    serialized_end=2128,
+)
+
+
+_RAWHASHES = _descriptor.Descriptor(
+    name="RawHashes",
+    full_name="google.cloud.webrisk.v1beta1.RawHashes",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="prefix_size",
+            full_name="google.cloud.webrisk.v1beta1.RawHashes.prefix_size",
+            index=0,
+            number=1,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="raw_hashes",
+            full_name="google.cloud.webrisk.v1beta1.RawHashes.raw_hashes",
+            index=1,
+            number=2,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2130,
+    serialized_end=2182,
+)
+
+
+_RICEDELTAENCODING = _descriptor.Descriptor(
+    name="RiceDeltaEncoding",
+    full_name="google.cloud.webrisk.v1beta1.RiceDeltaEncoding",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="first_value",
+            full_name="google.cloud.webrisk.v1beta1.RiceDeltaEncoding.first_value",
+            index=0,
+            number=1,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="rice_parameter",
+            full_name="google.cloud.webrisk.v1beta1.RiceDeltaEncoding.rice_parameter",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="entry_count",
+            full_name="google.cloud.webrisk.v1beta1.RiceDeltaEncoding.entry_count",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="encoded_data",
+            full_name="google.cloud.webrisk.v1beta1.RiceDeltaEncoding.encoded_data",
+            index=3,
+            number=4,
+            type=12,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b(""),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2184,
+    serialized_end=2291,
+)
+
+_COMPUTETHREATLISTDIFFREQUEST_CONSTRAINTS.fields_by_name[
+    "supported_compressions"
+].enum_type = _COMPRESSIONTYPE
+_COMPUTETHREATLISTDIFFREQUEST_CONSTRAINTS.containing_type = (
+    _COMPUTETHREATLISTDIFFREQUEST
+)
+_COMPUTETHREATLISTDIFFREQUEST.fields_by_name["threat_type"].enum_type = _THREATTYPE
+_COMPUTETHREATLISTDIFFREQUEST.fields_by_name[
+    "constraints"
+].message_type = _COMPUTETHREATLISTDIFFREQUEST_CONSTRAINTS
+_COMPUTETHREATLISTDIFFRESPONSE_CHECKSUM.containing_type = _COMPUTETHREATLISTDIFFRESPONSE
+_COMPUTETHREATLISTDIFFRESPONSE.fields_by_name[
+    "response_type"
+].enum_type = _COMPUTETHREATLISTDIFFRESPONSE_RESPONSETYPE
+_COMPUTETHREATLISTDIFFRESPONSE.fields_by_name[
+    "additions"
+].message_type = _THREATENTRYADDITIONS
+_COMPUTETHREATLISTDIFFRESPONSE.fields_by_name[
+    "removals"
+].message_type = _THREATENTRYREMOVALS
+_COMPUTETHREATLISTDIFFRESPONSE.fields_by_name[
+    "checksum"
+].message_type = _COMPUTETHREATLISTDIFFRESPONSE_CHECKSUM
+_COMPUTETHREATLISTDIFFRESPONSE.fields_by_name[
+    "recommended_next_diff"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_COMPUTETHREATLISTDIFFRESPONSE_RESPONSETYPE.containing_type = (
+    _COMPUTETHREATLISTDIFFRESPONSE
+)
+_SEARCHURISREQUEST.fields_by_name["threat_types"].enum_type = _THREATTYPE
+_SEARCHURISRESPONSE_THREATURI.fields_by_name["threat_types"].enum_type = _THREATTYPE
+_SEARCHURISRESPONSE_THREATURI.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SEARCHURISRESPONSE_THREATURI.containing_type = _SEARCHURISRESPONSE
+_SEARCHURISRESPONSE.fields_by_name[
+    "threat"
+].message_type = _SEARCHURISRESPONSE_THREATURI
+_SEARCHHASHESREQUEST.fields_by_name["threat_types"].enum_type = _THREATTYPE
+_SEARCHHASHESRESPONSE_THREATHASH.fields_by_name["threat_types"].enum_type = _THREATTYPE
+_SEARCHHASHESRESPONSE_THREATHASH.fields_by_name[
+    "expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SEARCHHASHESRESPONSE_THREATHASH.containing_type = _SEARCHHASHESRESPONSE
+_SEARCHHASHESRESPONSE.fields_by_name[
+    "threats"
+].message_type = _SEARCHHASHESRESPONSE_THREATHASH
+_SEARCHHASHESRESPONSE.fields_by_name[
+    "negative_expire_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_THREATENTRYADDITIONS.fields_by_name["raw_hashes"].message_type = _RAWHASHES
+_THREATENTRYADDITIONS.fields_by_name["rice_hashes"].message_type = _RICEDELTAENCODING
+_THREATENTRYREMOVALS.fields_by_name["raw_indices"].message_type = _RAWINDICES
+_THREATENTRYREMOVALS.fields_by_name["rice_indices"].message_type = _RICEDELTAENCODING
+DESCRIPTOR.message_types_by_name[
+    "ComputeThreatListDiffRequest"
+] = _COMPUTETHREATLISTDIFFREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ComputeThreatListDiffResponse"
+] = _COMPUTETHREATLISTDIFFRESPONSE
+DESCRIPTOR.message_types_by_name["SearchUrisRequest"] = _SEARCHURISREQUEST
+DESCRIPTOR.message_types_by_name["SearchUrisResponse"] = _SEARCHURISRESPONSE
+DESCRIPTOR.message_types_by_name["SearchHashesRequest"] = _SEARCHHASHESREQUEST
+DESCRIPTOR.message_types_by_name["SearchHashesResponse"] = _SEARCHHASHESRESPONSE
+DESCRIPTOR.message_types_by_name["ThreatEntryAdditions"] = _THREATENTRYADDITIONS
+DESCRIPTOR.message_types_by_name["ThreatEntryRemovals"] = _THREATENTRYREMOVALS
+DESCRIPTOR.message_types_by_name["RawIndices"] = _RAWINDICES
+DESCRIPTOR.message_types_by_name["RawHashes"] = _RAWHASHES
+DESCRIPTOR.message_types_by_name["RiceDeltaEncoding"] = _RICEDELTAENCODING
+DESCRIPTOR.enum_types_by_name["ThreatType"] = _THREATTYPE
+DESCRIPTOR.enum_types_by_name["CompressionType"] = _COMPRESSIONTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ComputeThreatListDiffRequest = _reflection.GeneratedProtocolMessageType(
+    "ComputeThreatListDiffRequest",
+    (_message.Message,),
+    dict(
+        Constraints=_reflection.GeneratedProtocolMessageType(
+            "Constraints",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMPUTETHREATLISTDIFFREQUEST_CONSTRAINTS,
+                __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+                __doc__="""The constraints for this diff.
+    
+    
+    Attributes:
+        max_diff_entries:
+            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.
+        max_database_entries:
+            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.
+        supported_compressions:
+            The compression types supported by the client.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest.Constraints)
+            ),
+        ),
+        DESCRIPTOR=_COMPUTETHREATLISTDIFFREQUEST,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""Describes an API diff request.
+  
+  
+  Attributes:
+      threat_type:
+          Required. The ThreatList to update.
+      version_token:
+          The current version token of the client for the requested list
+          (the client version that was received from the last successful
+          diff).
+      constraints:
+          The constraints associated with this request.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.ComputeThreatListDiffRequest)
+    ),
+)
+_sym_db.RegisterMessage(ComputeThreatListDiffRequest)
+_sym_db.RegisterMessage(ComputeThreatListDiffRequest.Constraints)
+
+ComputeThreatListDiffResponse = _reflection.GeneratedProtocolMessageType(
+    "ComputeThreatListDiffResponse",
+    (_message.Message,),
+    dict(
+        Checksum=_reflection.GeneratedProtocolMessageType(
+            "Checksum",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_COMPUTETHREATLISTDIFFRESPONSE_CHECKSUM,
+                __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+                __doc__="""The expected state of a client's local database.
+    
+    
+    Attributes:
+        sha256:
+            The SHA256 hash of the client state; that is, of the sorted
+            list of all hashes present in the database.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse.Checksum)
+            ),
+        ),
+        DESCRIPTOR=_COMPUTETHREATLISTDIFFRESPONSE,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""
+    Attributes:
+      response_type:
+          The type of response. This may indicate that an action is
+          required by the client when the response is received.
+      additions:
+          A set of entries to add to a local threat type's list.
+      removals:
+          A set of entries to remove from a local threat type's list.
+          This field may be empty.
+      new_version_token:
+          The new opaque client version token.
+      checksum:
+          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 disregard this diff and
+          retry later.
+      recommended_next_diff:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.ComputeThreatListDiffResponse)
+    ),
+)
+_sym_db.RegisterMessage(ComputeThreatListDiffResponse)
+_sym_db.RegisterMessage(ComputeThreatListDiffResponse.Checksum)
+
+SearchUrisRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchUrisRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHURISREQUEST,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""Request to check URI entries against threatLists.
+  
+  
+  Attributes:
+      uri:
+          The URI to be checked for matches.
+      threat_types:
+          Required. The ThreatLists to search in.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.SearchUrisRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchUrisRequest)
+
+SearchUrisResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchUrisResponse",
+    (_message.Message,),
+    dict(
+        ThreatUri=_reflection.GeneratedProtocolMessageType(
+            "ThreatUri",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHURISRESPONSE_THREATURI,
+                __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+                __doc__="""Contains threat information on a matching uri.
+    
+    
+    Attributes:
+        threat_types:
+            The ThreatList this threat belongs to.
+        expire_time:
+            The cache lifetime for the returned match. Clients must not
+            cache this response past this timestamp to avoid false
+            positives.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.SearchUrisResponse.ThreatUri)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHURISRESPONSE,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""
+    Attributes:
+      threat:
+          The threat list matches. This may be empty if the URI is on no
+          list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.SearchUrisResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchUrisResponse)
+_sym_db.RegisterMessage(SearchUrisResponse.ThreatUri)
+
+SearchHashesRequest = _reflection.GeneratedProtocolMessageType(
+    "SearchHashesRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SEARCHHASHESREQUEST,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""Request to return full hashes matched by the provided hash prefixes.
+  
+  
+  Attributes:
+      hash_prefix:
+          A hash prefix, consisting of the most significant 4-32 bytes
+          of a SHA256 hash. For JSON requests, this field is
+          base64-encoded.
+      threat_types:
+          Required. The ThreatLists to search in.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.SearchHashesRequest)
+    ),
+)
+_sym_db.RegisterMessage(SearchHashesRequest)
+
+SearchHashesResponse = _reflection.GeneratedProtocolMessageType(
+    "SearchHashesResponse",
+    (_message.Message,),
+    dict(
+        ThreatHash=_reflection.GeneratedProtocolMessageType(
+            "ThreatHash",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SEARCHHASHESRESPONSE_THREATHASH,
+                __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+                __doc__="""Contains threat information on a matching hash.
+    
+    
+    Attributes:
+        threat_types:
+            The ThreatList this threat belongs to. This must contain at
+            least one entry.
+        hash:
+            A 32 byte SHA256 hash. This field is in binary format. For
+            JSON requests, hashes are base64-encoded.
+        expire_time:
+            The cache lifetime for the returned match. Clients must not
+            cache this response past this timestamp to avoid false
+            positives.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.SearchHashesResponse.ThreatHash)
+            ),
+        ),
+        DESCRIPTOR=_SEARCHHASHESRESPONSE,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""
+    Attributes:
+      threats:
+          The full hashes that matched the requested prefixes. The hash
+          will be populated in the key.
+      negative_expire_time:
+          For requested entities that did not match the threat list, how
+          long to cache the response until.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.SearchHashesResponse)
+    ),
+)
+_sym_db.RegisterMessage(SearchHashesResponse)
+_sym_db.RegisterMessage(SearchHashesResponse.ThreatHash)
+
+ThreatEntryAdditions = _reflection.GeneratedProtocolMessageType(
+    "ThreatEntryAdditions",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_THREATENTRYADDITIONS,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""Contains the set of entries to add to a local database. May contain a
+  combination of compressed and raw data in a single response.
+  
+  
+  Attributes:
+      raw_hashes:
+          The raw SHA256-formatted entries. Repeated to allow returning
+          sets of hashes with different prefix sizes.
+      rice_hashes:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.ThreatEntryAdditions)
+    ),
+)
+_sym_db.RegisterMessage(ThreatEntryAdditions)
+
+ThreatEntryRemovals = _reflection.GeneratedProtocolMessageType(
+    "ThreatEntryRemovals",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_THREATENTRYREMOVALS,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""Contains the set of entries to remove from a local database.
+  
+  
+  Attributes:
+      raw_indices:
+          The raw removal indices for a local list.
+      rice_indices:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.ThreatEntryRemovals)
+    ),
+)
+_sym_db.RegisterMessage(ThreatEntryRemovals)
+
+RawIndices = _reflection.GeneratedProtocolMessageType(
+    "RawIndices",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RAWINDICES,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""A set of raw indices to remove from a local list.
+  
+  
+  Attributes:
+      indices:
+          The indices to remove from a lexicographically-sorted local
+          list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.RawIndices)
+    ),
+)
+_sym_db.RegisterMessage(RawIndices)
+
+RawHashes = _reflection.GeneratedProtocolMessageType(
+    "RawHashes",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RAWHASHES,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      prefix_size:
+          The number of bytes for each prefix encoded below. This field
+          can be anywhere from 4 (shortest prefix) to 32 (full SHA256
+          hash).
+      raw_hashes:
+          The hashes, in binary format, concatenated into one long
+          string. Hashes are sorted in lexicographic order. For JSON API
+          users, hashes are base64-encoded.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.RawHashes)
+    ),
+)
+_sym_db.RegisterMessage(RawHashes)
+
+RiceDeltaEncoding = _reflection.GeneratedProtocolMessageType(
+    "RiceDeltaEncoding",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_RICEDELTAENCODING,
+        __module__="google.cloud.webrisk_v1beta1.proto.webrisk_pb2",
+        __doc__="""The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes
+  or compressed removal indices.
+  
+  
+  Attributes:
+      first_value:
+          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.
+      rice_parameter:
+          The Golomb-Rice parameter, which is a number between 2 and 28.
+          This field is missing (that is, zero) if ``num_entries`` is
+          zero.
+      entry_count:
+          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``.
+      encoded_data:
+          The encoded deltas that are encoded using the Golomb-Rice
+          coder.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.webrisk.v1beta1.RiceDeltaEncoding)
+    ),
+)
+_sym_db.RegisterMessage(RiceDeltaEncoding)
+
+
+DESCRIPTOR._options = None
+
+_WEBRISKSERVICEV1BETA1 = _descriptor.ServiceDescriptor(
+    name="WebRiskServiceV1Beta1",
+    full_name="google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2469,
+    serialized_end=2977,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="ComputeThreatListDiff",
+            full_name="google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1.ComputeThreatListDiff",
+            index=0,
+            containing_service=None,
+            input_type=_COMPUTETHREATLISTDIFFREQUEST,
+            output_type=_COMPUTETHREATLISTDIFFRESPONSE,
+            serialized_options=_b(
+                '\202\323\344\223\002"\022 /v1beta1/threatLists:computeDiff'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchUris",
+            full_name="google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1.SearchUris",
+            index=1,
+            containing_service=None,
+            input_type=_SEARCHURISREQUEST,
+            output_type=_SEARCHURISRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\026\022\024/v1beta1/uris:search"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="SearchHashes",
+            full_name="google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1.SearchHashes",
+            index=2,
+            containing_service=None,
+            input_type=_SEARCHHASHESREQUEST,
+            output_type=_SEARCHHASHESRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002\030\022\026/v1beta1/hashes:search"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_WEBRISKSERVICEV1BETA1)
+
+DESCRIPTOR.services_by_name["WebRiskServiceV1Beta1"] = _WEBRISKSERVICEV1BETA1
+
+# @@protoc_insertion_point(module_scope)
diff --git a/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk_pb2_grpc.py b/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk_pb2_grpc.py
new file mode 100644
index 000000000000..be5a84477268
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/proto/webrisk_pb2_grpc.py
@@ -0,0 +1,89 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.webrisk_v1beta1.proto import (
+    webrisk_pb2 as google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2,
+)
+
+
+class WebRiskServiceV1Beta1Stub(object):
+    """Web Risk v1beta1 API defines an interface to detect malicious URLs on your
+  website and in client applications.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.ComputeThreatListDiff = channel.unary_unary(
+            "/google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1/ComputeThreatListDiff",
+            request_serializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.ComputeThreatListDiffRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.ComputeThreatListDiffResponse.FromString,
+        )
+        self.SearchUris = channel.unary_unary(
+            "/google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1/SearchUris",
+            request_serializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchUrisRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchUrisResponse.FromString,
+        )
+        self.SearchHashes = channel.unary_unary(
+            "/google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1/SearchHashes",
+            request_serializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchHashesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchHashesResponse.FromString,
+        )
+
+
+class WebRiskServiceV1Beta1Servicer(object):
+    """Web Risk v1beta1 API defines an interface to detect malicious URLs on your
+  website and in client applications.
+  """
+
+    def ComputeThreatListDiff(self, request, context):
+        """Gets the most recent threat list diffs.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchUris(self, request, context):
+        """This method is used to check whether a URI is on a given threatList.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def SearchHashes(self, request, context):
+        """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.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_WebRiskServiceV1Beta1Servicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "ComputeThreatListDiff": grpc.unary_unary_rpc_method_handler(
+            servicer.ComputeThreatListDiff,
+            request_deserializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.ComputeThreatListDiffRequest.FromString,
+            response_serializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.ComputeThreatListDiffResponse.SerializeToString,
+        ),
+        "SearchUris": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchUris,
+            request_deserializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchUrisRequest.FromString,
+            response_serializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchUrisResponse.SerializeToString,
+        ),
+        "SearchHashes": grpc.unary_unary_rpc_method_handler(
+            servicer.SearchHashes,
+            request_deserializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchHashesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_webrisk__v1beta1_dot_proto_dot_webrisk__pb2.SearchHashesResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/webrisk/google/cloud/webrisk_v1beta1/types.py b/webrisk/google/cloud/webrisk_v1beta1/types.py
new file mode 100644
index 000000000000..81d2da5f6dd6
--- /dev/null
+++ b/webrisk/google/cloud/webrisk_v1beta1/types.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.webrisk_v1beta1.proto import webrisk_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [timestamp_pb2]
+
+_local_modules = [webrisk_pb2]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.webrisk_v1beta1.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/webrisk/noxfile.py b/webrisk/noxfile.py
new file mode 100644
index 000000000000..9fedd1bae939
--- /dev/null
+++ b/webrisk/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", "black", *LOCAL_DEPS)
+    session.run(
+        "black",
+        "--check",
+        "google",
+        "tests",
+        "docs",
+    )
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+    
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install("black")
+    session.run(
+        "black",
+        "google",
+        "tests",
+        "docs",
+    )
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=97",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+@nox.session(python='3.6')
+def docs(session):
+    """Build the docs."""
+
+    session.install('sphinx', 'alabaster', 'recommonmark')
+    session.install('-e', '.')
+
+    shutil.rmtree(os.path.join('docs', '_build'), ignore_errors=True)
+    session.run(
+        'sphinx-build',
+        '-W',  # warnings as errors
+        '-T',  # show full traceback on exception
+        '-N',  # no colors
+        '-b', 'html',
+        '-d', os.path.join('docs', '_build', 'doctrees', ''),
+        os.path.join('docs', ''),
+        os.path.join('docs', '_build', 'html', ''),
+    )
diff --git a/webrisk/setup.cfg b/webrisk/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/webrisk/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/webrisk/setup.py b/webrisk/setup.py
new file mode 100644
index 000000000000..b3bab8c38394
--- /dev/null
+++ b/webrisk/setup.py
@@ -0,0 +1,89 @@
+# 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.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = 'google-cloud-webrisk'
+description = 'Google Cloud Web Risk API client library'
+version = '0.2.0'
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = 'Development Status :: 3 - Alpha'
+dependencies = [
+    'google-api-core[grpc] >= 1.14.0, < 2.0.0dev',
+]
+extras = {
+}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, 'README.rst')
+with io.open(readme_filename, encoding='utf-8') as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages()
+    if package.startswith('google')]
+
+# Determine which namespaces are needed.
+namespaces = ['google']
+if 'google.cloud' in packages:
+    namespaces.append('google.cloud')
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author='Google LLC',
+    author_email='googleapis-packages@google.com',
+    license='Apache 2.0',
+    url='https://github.com/GoogleCloudPlatform/google-cloud-python',
+    classifiers=[
+        release_status,
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Programming Language :: Python',
+        'Programming Language :: Python :: 2',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Operating System :: OS Independent',
+        'Topic :: Internet',
+    ],
+    platforms='Posix; MacOS X; Windows',
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/webrisk/synth.metadata b/webrisk/synth.metadata
new file mode 100644
index 000000000000..c5119433795c
--- /dev/null
+++ b/webrisk/synth.metadata
@@ -0,0 +1,39 @@
+{
+  "updateTime": "2019-08-06T12:51:28.182890Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "webrisk",
+        "apiVersion": "v1beta1",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/webrisk/artman_webrisk_v1beta1.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/webrisk/synth.py b/webrisk/synth.py
new file mode 100644
index 000000000000..ee6878a072db
--- /dev/null
+++ b/webrisk/synth.py
@@ -0,0 +1,49 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import re
+
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+versions = ["v1beta1"]
+
+# ----------------------------------------------------------------------------
+# Generate webrisk GAPIC layer
+# ----------------------------------------------------------------------------
+for version in versions:
+    library = gapic.py_library("webrisk", version, include_protos=True)
+    s.copy(library, excludes=["docs/index.rst", "nox.py", "README.rst", "setup.py"])
+
+
+# Fix docstring issue for classes with no summary line
+s.replace(
+    "google/cloud/**/proto/webrisk_pb2.py",
+    '''__doc__ = """Attributes:''',
+    '''__doc__ = """
+    Attributes:''',
+)
+
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files, excludes=["noxfile.py"])
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/webrisk/tests/unit/gapic/v1beta1/test_web_risk_service_v1_beta1_client_v1beta1.py b/webrisk/tests/unit/gapic/v1beta1/test_web_risk_service_v1_beta1_client_v1beta1.py
new file mode 100644
index 000000000000..c44043698f86
--- /dev/null
+++ b/webrisk/tests/unit/gapic/v1beta1/test_web_risk_service_v1_beta1_client_v1beta1.py
@@ -0,0 +1,178 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import webrisk_v1beta1
+from google.cloud.webrisk_v1beta1 import enums
+from google.cloud.webrisk_v1beta1.proto import webrisk_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestWebRiskServiceV1Beta1Client(object):
+    def test_compute_threat_list_diff(self):
+        # Setup Expected Response
+        new_version_token = b"115"
+        expected_response = {"new_version_token": new_version_token}
+        expected_response = webrisk_pb2.ComputeThreatListDiffResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+
+        # Setup Request
+        threat_type = enums.ThreatType.THREAT_TYPE_UNSPECIFIED
+        constraints = {}
+
+        response = client.compute_threat_list_diff(threat_type, constraints)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = webrisk_pb2.ComputeThreatListDiffRequest(
+            threat_type=threat_type, constraints=constraints
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_compute_threat_list_diff_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+
+        # Setup request
+        threat_type = enums.ThreatType.THREAT_TYPE_UNSPECIFIED
+        constraints = {}
+
+        with pytest.raises(CustomException):
+            client.compute_threat_list_diff(threat_type, constraints)
+
+    def test_search_uris(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = webrisk_pb2.SearchUrisResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+
+        # Setup Request
+        uri = "uri116076"
+        threat_types = []
+
+        response = client.search_uris(uri, threat_types)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = webrisk_pb2.SearchUrisRequest(
+            uri=uri, threat_types=threat_types
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_uris_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+
+        # Setup request
+        uri = "uri116076"
+        threat_types = []
+
+        with pytest.raises(CustomException):
+            client.search_uris(uri, threat_types)
+
+    def test_search_hashes(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = webrisk_pb2.SearchHashesResponse(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+
+        response = client.search_hashes()
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = webrisk_pb2.SearchHashesRequest()
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_search_hashes_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = webrisk_v1beta1.WebRiskServiceV1Beta1Client()
+
+        with pytest.raises(CustomException):
+            client.search_hashes()
diff --git a/websecurityscanner/.coveragerc b/websecurityscanner/.coveragerc
new file mode 100644
index 000000000000..b178b094aa1d
--- /dev/null
+++ b/websecurityscanner/.coveragerc
@@ -0,0 +1,19 @@
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
\ No newline at end of file
diff --git a/websecurityscanner/.flake8 b/websecurityscanner/.flake8
new file mode 100644
index 000000000000..0268ecc9c55c
--- /dev/null
+++ b/websecurityscanner/.flake8
@@ -0,0 +1,14 @@
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py
diff --git a/websecurityscanner/.repo-metadata.json b/websecurityscanner/.repo-metadata.json
new file mode 100644
index 000000000000..faf8a58cda54
--- /dev/null
+++ b/websecurityscanner/.repo-metadata.json
@@ -0,0 +1,13 @@
+{
+  "name": "websecurityscanner",
+  "name_pretty": "Cloud Security Scanner",
+  "product_documentation": "https://cloud.google.com/security-scanner/docs/",
+  "client_documentation": "https://googleapis.dev/python/websecurityscanner/latest",
+  "issue_tracker": "https://issuetracker.google.com/savedsearches/559748",
+  "release_level": "alpha",
+  "language": "python",
+  "repo": "googleapis/google-cloud-python",
+  "distribution_name": "google-cloud-websecurityscanner",
+  "api_id": "websecurityscanner.googleapis.com",
+  "requires_billing": true
+}
\ No newline at end of file
diff --git a/websecurityscanner/CHANGELOG.md b/websecurityscanner/CHANGELOG.md
new file mode 100644
index 000000000000..689540703819
--- /dev/null
+++ b/websecurityscanner/CHANGELOG.md
@@ -0,0 +1,94 @@
+# Changelog
+
+[PyPI History][1]
+
+[1]: https://pypi.org/project/google-cloud-websecurityscanner/#history
+
+## 0.3.0
+
+07-24-2019 17:56 PDT
+
+
+### Implementation Changes
+- Allow kwargs to be passed to create_channel (via synth). ([#8413](https://github.com/googleapis/google-cloud-python/pull/8413))
+- Retry code 'idempotent' for ListCrawledUrls, add empty lines (via synth). ([#8079](https://github.com/googleapis/google-cloud-python/pull/8079))
+
+### New Features
+- Add 'client_options' support, update list method docstrings (via synth). ([#8531](https://github.com/googleapis/google-cloud-python/pull/8531))
+
+### Dependencies
+- Bump minimum version for google-api-core to 1.14.0. ([#8709](https://github.com/googleapis/google-cloud-python/pull/8709))
+
+### Documentation
+- Link to googleapis.dev documentation in READMEs. ([#8705](https://github.com/googleapis/google-cloud-python/pull/8705))
+- Add compatibility check badges to READMEs. ([#8288](https://github.com/googleapis/google-cloud-python/pull/8288))
+
+### Internal / Testing Changes
+- Pin black version (via synth). ([#8603](https://github.com/googleapis/google-cloud-python/pull/8603))
+- Add docs job to publish to googleapis.dev. ([#8464](https://github.com/googleapis/google-cloud-python/pull/8464))
+- Declare encoding as utf-8 in pb2 files (via synth).  ([#8373](https://github.com/googleapis/google-cloud-python/pull/8373))
+- Add disclaimer to auto-generated template files. ([#8337](https://github.com/googleapis/google-cloud-python/pull/8337))
+- Suppress checking 'cov-fail-under' in nox default session (via synth). ([#8258](https://github.com/googleapis/google-cloud-python/pull/8258))
+- Fix coverage in 'types.py' (via synth). ([#8172](https://github.com/googleapis/google-cloud-python/pull/8172))
+
+## 0.2.0
+
+05-15-2019 15:20 PDT
+
+
+### Implementation Changes
+- Add routing header to method metadata (via synth).  ([#7605](https://github.com/googleapis/google-cloud-python/pull/7605))
+- Remove classifier for Python 3.4 for end-of-life. ([#7535](https://github.com/googleapis/google-cloud-python/pull/7535))
+- Protoc-generated serialization update. ([#7101](https://github.com/googleapis/google-cloud-python/pull/7101))
+- GAPIC generation fixes. ([#7059](https://github.com/googleapis/google-cloud-python/pull/7059))
+- Pick up order-of-enum fix from GAPIC generator. ([#6882](https://github.com/googleapis/google-cloud-python/pull/6882))
+
+### New Features
+- Generate v1beta. ([#7992](https://github.com/googleapis/google-cloud-python/pull/7992))
+
+### Documentation
+- Updated client library documentation URLs. ([#7307](https://github.com/googleapis/google-cloud-python/pull/7307))
+- Update copyright headers
+
+### Internal / Testing Changes
+- Update noxfile (via synth). ([#7803](https://github.com/googleapis/google-cloud-python/pull/7803))
+- Fix 'docs' session in nox. ([#7788](https://github.com/googleapis/google-cloud-python/pull/7788))
+- Add nox session 'docs' (via synth). ([#7747](https://github.com/googleapis/google-cloud-python/pull/7747))
+- Copy lintified proto files (via synth). ([#7474](https://github.com/googleapis/google-cloud-python/pull/7474))
+- Add clarifying comment to blacken nox target. ([#7409](https://github.com/googleapis/google-cloud-python/pull/7409))
+- Add protos as an artifact to library ([#7205](https://github.com/googleapis/google-cloud-python/pull/7205))
+
+## 0.1.1
+
+12-18-2018 10:45 PST
+
+
+### Implementation Changes
+- Import `iam.policy` from `google.api_core`. ([#6741](https://github.com/googleapis/google-cloud-python/pull/6741))
+- Avoid overwriting `__module__` of messages from shared modules. ([#5364](https://github.com/googleapis/google-cloud-python/pull/5364))
+
+### Dependencies
+- Bump minimum `api_core` version for all GAPIC libs to 1.4.1. ([#6391](https://github.com/googleapis/google-cloud-python/pull/6391))
+
+### Documentation
+- Document Python 2 deprecation ([#6910](https://github.com/googleapis/google-cloud-python/pull/6910))
+- Normalize use of support level badges ([#6159](https://github.com/googleapis/google-cloud-python/pull/6159))
+- Replace links to `/stable/` with `/latest/`. ([#5901](https://github.com/googleapis/google-cloud-python/pull/5901))
+
+### Internal / Testing Changes
+- Blacken all gen'd libs ([#6792](https://github.com/googleapis/google-cloud-python/pull/6792))
+- Omit local deps ([#6701](https://github.com/googleapis/google-cloud-python/pull/6701))
+- Run black at end of synth.py ([#6698](https://github.com/googleapis/google-cloud-python/pull/6698))
+- Run Black on Generated libraries ([#6666](https://github.com/googleapis/google-cloud-python/pull/6666))
+- Add templates for flake8, coveragerc, noxfile, and black. ([#6642](https://github.com/googleapis/google-cloud-python/pull/6642))
+- Add / fix badges for PyPI / versions. ([#6158](https://github.com/googleapis/google-cloud-python/pull/6158))
+- Use new Nox ([#6175](https://github.com/googleapis/google-cloud-python/pull/6175))
+- Add 'synth.py'. ([#6087](https://github.com/googleapis/google-cloud-python/pull/6087))
+- Use inplace nox installs ([#5865](https://github.com/googleapis/google-cloud-python/pull/5865))
+- Add Test runs for Python 3.7 and remove 3.4 ([#5295](https://github.com/googleapis/google-cloud-python/pull/5295))
+- Add dot files for websecurityscanner ([#5286](https://github.com/googleapis/google-cloud-python/pull/5286))
+
+## 0.1.0
+
+### New Features
+- Add v1alpha1 websecurityscanner endpoint
diff --git a/websecurityscanner/LICENSE b/websecurityscanner/LICENSE
new file mode 100644
index 000000000000..a8ee855de2aa
--- /dev/null
+++ b/websecurityscanner/LICENSE
@@ -0,0 +1,201 @@
+                            Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/websecurityscanner/MANIFEST.in b/websecurityscanner/MANIFEST.in
new file mode 100644
index 000000000000..9cbf175afe6b
--- /dev/null
+++ b/websecurityscanner/MANIFEST.in
@@ -0,0 +1,5 @@
+include README.rst LICENSE
+recursive-include google *.json *.proto
+recursive-include tests *
+global-exclude *.py[co]
+global-exclude __pycache__
diff --git a/websecurityscanner/README.rst b/websecurityscanner/README.rst
new file mode 100644
index 000000000000..63868b85244f
--- /dev/null
+++ b/websecurityscanner/README.rst
@@ -0,0 +1,86 @@
+Python Client for Web Security Scanner API
+==========================================
+
+|alpha| |pypi| |versions| 
+
+`Web Security Scanner API`_: Web Security Scanner API (under development).
+
+- `Client Library Documentation`_
+- `Product Documentation`_
+
+.. |alpha| image:: https://img.shields.io/badge/support-alpha-orange.svg
+   :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#alpha-support
+.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-websecurityscanner.svg
+   :target: https://pypi.org/project/google-cloud-websecurityscanner/
+.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-websecurityscanner.svg
+   :target: https://pypi.org/project/google-cloud-websecurityscanner/
+.. _Web Security Scanner API: https://cloud.google.com/security-scanner
+.. _Client Library Documentation: https://googleapis.dev/python/websecurityscanner/latest
+.. _Product Documentation:  https://cloud.google.com/security-scanner
+
+Quick Start
+-----------
+
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Web Security Scanner API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Web Security Scanner API.:  https://cloud.google.com/security-scanner
+.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+
+Installation
+~~~~~~~~~~~~
+
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
+
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
+
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+
+
+Supported Python Versions
+~~~~~~~~~~~~~~~~~~~~~~~~~
+Python >= 3.5
+
+Deprecated Python Versions
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+Python == 2.7. Python 2.7 support will be removed on January 1, 2020.
+
+
+Mac/Linux
+^^^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-websecurityscanner
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-websecurityscanner
+
+Next Steps
+~~~~~~~~~~
+
+-  Read the `Client Library Documentation`_ for Web Security Scanner API
+   API to see other available methods on the client.
+-  Read the `Product documentation`_ to learn
+   more about the product and see How-to Guides.
diff --git a/websecurityscanner/docs/README.rst b/websecurityscanner/docs/README.rst
new file mode 120000
index 000000000000..89a0106941ff
--- /dev/null
+++ b/websecurityscanner/docs/README.rst
@@ -0,0 +1 @@
+../README.rst
\ No newline at end of file
diff --git a/websecurityscanner/docs/changelog.md b/websecurityscanner/docs/changelog.md
new file mode 120000
index 000000000000..04c99a55caae
--- /dev/null
+++ b/websecurityscanner/docs/changelog.md
@@ -0,0 +1 @@
+../CHANGELOG.md
\ No newline at end of file
diff --git a/websecurityscanner/docs/conf.py b/websecurityscanner/docs/conf.py
new file mode 100644
index 000000000000..17adef53a653
--- /dev/null
+++ b/websecurityscanner/docs/conf.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# google-cloud-websecurityscanner documentation build configuration file
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+import shlex
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath(".."))
+
+__version__ = "0.1.0"
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+needs_sphinx = "1.6.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.coverage",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
+    "sphinx.ext.viewcode",
+]
+
+# autodoc/autosummary flags
+autoclass_content = "both"
+autodoc_default_flags = ["members"]
+autosummary_generate = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# Allow markdown includes (so releases.md can include CHANGLEOG.md)
+# http://www.sphinx-doc.org/en/master/markdown.html
+source_parsers = {".md": "recommonmark.parser.CommonMarkParser"}
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+# source_suffix = ['.rst', '.md']
+source_suffix = [".rst", ".md"]
+
+# The encoding of source files.
+# source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = u"google-cloud-websecurityscanner"
+copyright = u"2017, Google"
+author = u"Google APIs"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The full version, including alpha/beta/rc tags.
+release = __version__
+# The short X.Y version.
+version = ".".join(release.split(".")[0:2])
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+# today = ''
+# Else, today_fmt is used as the format for a strftime call.
+# today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ["_build"]
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+# default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+# add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+# add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+# show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = "sphinx"
+
+# A list of ignored prefixes for module index sorting.
+# modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+# keep_warnings = False
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = "alabaster"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "description": "Google Cloud Client Libraries for Python",
+    "github_user": "googleapis",
+    "github_repo": "google-cloud-python",
+    "github_banner": True,
+    "font_family": "'Roboto', Georgia, sans",
+    "head_font_family": "'Roboto', Georgia, serif",
+    "code_font_family": "'Roboto Mono', 'Consolas', monospace",
+}
+
+# Add any paths that contain custom themes here, relative to this directory.
+# html_theme_path = []
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+# html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+# html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+# html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+# html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = []
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+# html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+# html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+# html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+# html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+# html_additional_pages = {}
+
+# If false, no module index is generated.
+# html_domain_indices = True
+
+# If false, no index is generated.
+# html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+# html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+# html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+# html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+# html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+# html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+# html_file_suffix = None
+
+# Language to be used for generating the HTML full-text search index.
+# Sphinx supports the following languages:
+#   'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
+#   'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
+# html_search_language = 'en'
+
+# A dictionary with options for the search language support, empty by default.
+# Now only 'ja' uses this config value
+# html_search_options = {'type': 'default'}
+
+# The name of a javascript file (relative to the configuration directory) that
+# implements a search results scorer. If empty, the default will be used.
+# html_search_scorer = 'scorer.js'
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "google-cloud-websecurityscanner-doc"
+
+# -- Options for warnings ------------------------------------------------------
+
+suppress_warnings = [
+    # Temporarily suppress this to avoid "more than one target found for
+    # cross-reference" warning, which are intractable for us to avoid while in
+    # a mono-repo.
+    # See https://github.com/sphinx-doc/sphinx/blob
+    # /2a65ffeef5c107c19084fabdd706cdff3f52d93c/sphinx/domains/python.py#L843
+    "ref.python"
+]
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #'preamble': '',
+    # Latex figure (float) alignment
+    #'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "google-cloud-websecurityscanner.tex",
+        u"google-cloud-websecurityscanner Documentation",
+        author,
+        "manual",
+    )
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+# latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+# latex_use_parts = False
+
+# If true, show page references after internal links.
+# latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+# latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+# latex_appendices = []
+
+# If false, no module index is generated.
+# latex_domain_indices = True
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (
+        master_doc,
+        "google-cloud-websecurityscanner",
+        u"google-cloud-websecurityscanner Documentation",
+        [author],
+        1,
+    )
+]
+
+# If true, show URL addresses after external links.
+# man_show_urls = False
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "google-cloud-websecurityscanner",
+        u"google-cloud-websecurityscanner Documentation",
+        author,
+        "google-cloud-websecurityscanner",
+        "GAPIC library for the {metadata.shortName} v1alpha service",
+        "APIs",
+    )
+]
+
+# Documents to append as an appendix to all manuals.
+# texinfo_appendices = []
+
+# If false, no module index is generated.
+# texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+# texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+# texinfo_no_detailmenu = False
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("http://python.readthedocs.org/en/latest/", None),
+    "gax": ("https://gax-python.readthedocs.org/en/latest/", None),
+    "google-auth": ("https://google-auth.readthedocs.io/en/stable", None),
+    "google-gax": ("https://gax-python.readthedocs.io/en/latest/", None),
+    "google.api_core": ("https://googleapis.dev/python/google-api-core/latest", None),
+    "grpc": ("https://grpc.io/grpc/python/", None),
+    "requests": ("https://2.python-requests.org/en/master/", None),
+    "fastavro": ("https://fastavro.readthedocs.io/en/stable/", None),
+    "pandas": ("https://pandas.pydata.org/pandas-docs/stable/", None),
+}
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_rtype = True
diff --git a/websecurityscanner/docs/gapic/v1alpha/api.rst b/websecurityscanner/docs/gapic/v1alpha/api.rst
new file mode 100644
index 000000000000..fd817f98c216
--- /dev/null
+++ b/websecurityscanner/docs/gapic/v1alpha/api.rst
@@ -0,0 +1,6 @@
+Client for Web Security Scanner API
+===================================
+
+.. automodule:: google.cloud.websecurityscanner_v1alpha
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/websecurityscanner/docs/gapic/v1alpha/types.rst b/websecurityscanner/docs/gapic/v1alpha/types.rst
new file mode 100644
index 000000000000..47a13937375a
--- /dev/null
+++ b/websecurityscanner/docs/gapic/v1alpha/types.rst
@@ -0,0 +1,5 @@
+Types for Web Security Scanner API Client
+=========================================
+
+.. automodule:: google.cloud.websecurityscanner_v1alpha.types
+    :members:
\ No newline at end of file
diff --git a/websecurityscanner/docs/gapic/v1beta/api.rst b/websecurityscanner/docs/gapic/v1beta/api.rst
new file mode 100644
index 000000000000..68a9c24f712b
--- /dev/null
+++ b/websecurityscanner/docs/gapic/v1beta/api.rst
@@ -0,0 +1,6 @@
+Client for Web Security Scanner API
+===================================
+
+.. automodule:: google.cloud.websecurityscanner_v1beta
+    :members:
+    :inherited-members:
\ No newline at end of file
diff --git a/websecurityscanner/docs/gapic/v1beta/types.rst b/websecurityscanner/docs/gapic/v1beta/types.rst
new file mode 100644
index 000000000000..f0f68e067fa1
--- /dev/null
+++ b/websecurityscanner/docs/gapic/v1beta/types.rst
@@ -0,0 +1,5 @@
+Types for Web Security Scanner API Client
+=========================================
+
+.. automodule:: google.cloud.websecurityscanner_v1beta.types
+    :members:
\ No newline at end of file
diff --git a/websecurityscanner/docs/index.rst b/websecurityscanner/docs/index.rst
new file mode 100644
index 000000000000..980ca1ff82ac
--- /dev/null
+++ b/websecurityscanner/docs/index.rst
@@ -0,0 +1,32 @@
+.. include:: README.rst
+
+Api Reference
+-------------
+This package includes clients for multiple versions of the Web Security Scanner API. By default, you will get ``v1beta``, the latest version.
+
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1beta/api
+    gapic/v1beta/types
+
+The previous alpha release, spelled ``v1alpha`` is provided to continue to support code previously written against it. In order to use it, you will want to import from it e.g., ``google.cloud.websecurityscanner_v1alpha`` in lieu of ``google.cloud.websecurityscanner`` (or the equivalent ``google.cloud.websecurityscanner_v1beta``).
+
+v1alpha
+~~~~~~~
+.. toctree::
+    :maxdepth: 2
+
+    gapic/v1alpha/api
+    gapic/v1alpha/types
+
+
+Changelog
+---------
+
+For a list of all ``google-cloud-websecurityscanner`` releases.
+
+.. toctree::
+    :maxdepth: 2
+
+    changelog
\ No newline at end of file
diff --git a/websecurityscanner/google/__init__.py b/websecurityscanner/google/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/websecurityscanner/google/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/websecurityscanner/google/cloud/__init__.py b/websecurityscanner/google/cloud/__init__.py
new file mode 100644
index 000000000000..dd3a9f485275
--- /dev/null
+++ b/websecurityscanner/google/cloud/__init__.py
@@ -0,0 +1,22 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+try:
+    import pkg_resources
+
+    pkg_resources.declare_namespace(__name__)
+except ImportError:
+    import pkgutil
+
+    __path__ = pkgutil.extend_path(__path__, __name__)
diff --git a/websecurityscanner/google/cloud/websecurityscanner.py b/websecurityscanner/google/cloud/websecurityscanner.py
new file mode 100644
index 000000000000..a41ca5e6e822
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner.py
@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.websecurityscanner_v1beta import WebSecurityScannerClient
+from google.cloud.websecurityscanner_v1beta import enums
+from google.cloud.websecurityscanner_v1beta import types
+
+
+__all__ = ("enums", "types", "WebSecurityScannerClient")
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/__init__.py
new file mode 100644
index 000000000000..6040cb603d19
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.websecurityscanner_v1alpha import types
+from google.cloud.websecurityscanner_v1alpha.gapic import enums
+from google.cloud.websecurityscanner_v1alpha.gapic import web_security_scanner_client
+
+
+class WebSecurityScannerClient(web_security_scanner_client.WebSecurityScannerClient):
+    __doc__ = web_security_scanner_client.WebSecurityScannerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "WebSecurityScannerClient")
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/enums.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/enums.py
new file mode 100644
index 000000000000..9765b3b06ce8
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/enums.py
@@ -0,0 +1,134 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class Finding(object):
+    class FindingType(enum.IntEnum):
+        """
+        Types of Findings.
+
+        Attributes:
+          FINDING_TYPE_UNSPECIFIED (int): The invalid finding type.
+          MIXED_CONTENT (int): A page that was served over HTTPS also resources over HTTP. A
+          man-in-the-middle attacker could tamper with the HTTP resource and gain
+          full access to the website that loads the resource or to monitor the
+          actions taken by the user.
+          OUTDATED_LIBRARY (int): The version of an included library is known to contain a security issue.
+          The scanner checks the version of library in use against a known list of
+          vulnerable libraries. False positives are possible if the version
+          detection fails or if the library has been manually patched.
+          ROSETTA_FLASH (int): This type of vulnerability occurs when the value of a request parameter
+          is reflected at the beginning of the response, for example, in requests
+          using JSONP. Under certain circumstances, an attacker may be able to
+          supply an alphanumeric-only Flash file in the vulnerable parameter
+          causing the browser to execute the Flash file as if it originated on the
+          vulnerable server.
+          XSS_CALLBACK (int): A cross-site scripting (XSS) bug is found via JavaScript callback. For
+          detailed explanations on XSS, see
+          https://www.google.com/about/appsecurity/learning/xss/.
+          XSS_ERROR (int): A potential cross-site scripting (XSS) bug due to JavaScript breakage.
+          In some circumstances, the application under test might modify the test
+          string before it is parsed by the browser. When the browser attempts to
+          runs this modified test string, it will likely break and throw a
+          JavaScript execution error, thus an injection issue is occurring.
+          However, it may not be exploitable. Manual verification is needed to see
+          if the test string modifications can be evaded and confirm that the issue
+          is in fact an XSS vulnerability. For detailed explanations on XSS, see
+          https://www.google.com/about/appsecurity/learning/xss/.
+          CLEAR_TEXT_PASSWORD (int): An application appears to be transmitting a password field in clear text.
+          An attacker can eavesdrop network traffic and sniff the password field.
+        """
+
+        FINDING_TYPE_UNSPECIFIED = 0
+        MIXED_CONTENT = 1
+        OUTDATED_LIBRARY = 2
+        ROSETTA_FLASH = 5
+        XSS_CALLBACK = 3
+        XSS_ERROR = 4
+        CLEAR_TEXT_PASSWORD = 6
+
+
+class ScanConfig(object):
+    class TargetPlatform(enum.IntEnum):
+        """
+        Cloud platforms supported by Cloud Web Security Scanner.
+
+        Attributes:
+          TARGET_PLATFORM_UNSPECIFIED (int): The target platform is unknown. Requests with this enum value will be
+          rejected with INVALID\_ARGUMENT error.
+          APP_ENGINE (int): Google App Engine service.
+          COMPUTE (int): Google Compute Engine service.
+        """
+
+        TARGET_PLATFORM_UNSPECIFIED = 0
+        APP_ENGINE = 1
+        COMPUTE = 2
+
+    class UserAgent(enum.IntEnum):
+        """
+        Type of user agents used for scanning.
+
+        Attributes:
+          USER_AGENT_UNSPECIFIED (int): The user agent is unknown. Service will default to CHROME\_LINUX.
+          CHROME_LINUX (int): Chrome on Linux. This is the service default if unspecified.
+          CHROME_ANDROID (int): Chrome on Android.
+          SAFARI_IPHONE (int): Safari on IPhone.
+        """
+
+        USER_AGENT_UNSPECIFIED = 0
+        CHROME_LINUX = 1
+        CHROME_ANDROID = 2
+        SAFARI_IPHONE = 3
+
+
+class ScanRun(object):
+    class ExecutionState(enum.IntEnum):
+        """
+        Types of ScanRun execution state.
+
+        Attributes:
+          EXECUTION_STATE_UNSPECIFIED (int): Represents an invalid state caused by internal server error. This value
+          should never be returned.
+          QUEUED (int): The scan is waiting in the queue.
+          SCANNING (int): The scan is in progress.
+          FINISHED (int): The scan is either finished or stopped by user.
+        """
+
+        EXECUTION_STATE_UNSPECIFIED = 0
+        QUEUED = 1
+        SCANNING = 2
+        FINISHED = 3
+
+    class ResultState(enum.IntEnum):
+        """
+        Types of ScanRun result state.
+
+        Attributes:
+          RESULT_STATE_UNSPECIFIED (int): Default value. This value is returned when the ScanRun is not yet
+          finished.
+          SUCCESS (int): The scan finished without errors.
+          ERROR (int): The scan finished with errors.
+          KILLED (int): The scan was terminated by user.
+        """
+
+        RESULT_STATE_UNSPECIFIED = 0
+        SUCCESS = 1
+        ERROR = 2
+        KILLED = 3
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/transports/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/transports/web_security_scanner_grpc_transport.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/transports/web_security_scanner_grpc_transport.py
new file mode 100644
index 000000000000..b2b1e7014a1c
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/transports/web_security_scanner_grpc_transport.py
@@ -0,0 +1,283 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.websecurityscanner_v1alpha.proto import web_security_scanner_pb2_grpc
+
+
+class WebSecurityScannerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.websecurityscanner.v1alpha WebSecurityScanner API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="websecurityscanner.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "web_security_scanner_stub": web_security_scanner_pb2_grpc.WebSecurityScannerStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="websecurityscanner.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.create_scan_config`.
+
+        Creates a new ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].CreateScanConfig
+
+    @property
+    def delete_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.delete_scan_config`.
+
+        Deletes an existing ScanConfig and its child resources.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].DeleteScanConfig
+
+    @property
+    def get_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.get_scan_config`.
+
+        Gets a ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].GetScanConfig
+
+    @property
+    def list_scan_configs(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_scan_configs`.
+
+        Lists ScanConfigs under a given project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListScanConfigs
+
+    @property
+    def update_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.update_scan_config`.
+
+        Updates a ScanConfig. This method support partial update of a ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].UpdateScanConfig
+
+    @property
+    def start_scan_run(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.start_scan_run`.
+
+        Start a ScanRun according to the given ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].StartScanRun
+
+    @property
+    def get_scan_run(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.get_scan_run`.
+
+        Gets a ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].GetScanRun
+
+    @property
+    def list_scan_runs(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_scan_runs`.
+
+        Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+        stop time.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListScanRuns
+
+    @property
+    def stop_scan_run(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.stop_scan_run`.
+
+        Stops a ScanRun. The stopped ScanRun is returned.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].StopScanRun
+
+    @property
+    def list_crawled_urls(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_crawled_urls`.
+
+        List CrawledUrls under a given ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListCrawledUrls
+
+    @property
+    def get_finding(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.get_finding`.
+
+        Gets a Finding.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].GetFinding
+
+    @property
+    def list_findings(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_findings`.
+
+        List Findings under a given ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListFindings
+
+    @property
+    def list_finding_type_stats(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_finding_type_stats`.
+
+        List all FindingTypeStats under a given ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListFindingTypeStats
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/web_security_scanner_client.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/web_security_scanner_client.py
new file mode 100644
index 000000000000..03e217725ffa
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/web_security_scanner_client.py
@@ -0,0 +1,1334 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.websecurityscanner.v1alpha WebSecurityScanner API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.websecurityscanner_v1alpha.gapic import enums
+from google.cloud.websecurityscanner_v1alpha.gapic import (
+    web_security_scanner_client_config,
+)
+from google.cloud.websecurityscanner_v1alpha.gapic.transports import (
+    web_security_scanner_grpc_transport,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import finding_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import scan_config_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import scan_run_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import web_security_scanner_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import web_security_scanner_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-websecurityscanner"
+).version
+
+
+class WebSecurityScannerClient(object):
+    """
+    Cloud Web Security Scanner Service identifies security vulnerabilities in web
+    applications hosted on Google Cloud Platform. It crawls your application, and
+    attempts to exercise as many user inputs and event handlers as possible.
+    """
+
+    SERVICE_ADDRESS = "websecurityscanner.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            WebSecurityScannerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def finding_path(cls, project, scan_config, scan_run, finding):
+        """Return a fully-qualified finding string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}",
+            project=project,
+            scan_config=scan_config,
+            scan_run=scan_run,
+            finding=finding,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def scan_config_path(cls, project, scan_config):
+        """Return a fully-qualified scan_config string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/scanConfigs/{scan_config}",
+            project=project,
+            scan_config=scan_config,
+        )
+
+    @classmethod
+    def scan_run_path(cls, project, scan_config, scan_run):
+        """Return a fully-qualified scan_run string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}",
+            project=project,
+            scan_config=scan_config,
+            scan_run=scan_run,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.WebSecurityScannerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.WebSecurityScannerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = web_security_scanner_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=web_security_scanner_grpc_transport.WebSecurityScannerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = web_security_scanner_grpc_transport.WebSecurityScannerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_scan_config(
+        self,
+        parent,
+        scan_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `scan_config`:
+            >>> scan_config = {}
+            >>>
+            >>> response = client.create_scan_config(parent, scan_config)
+
+        Args:
+            parent (str): Required.
+                The parent resource name where the scan is created, which should be a
+                project resource name in the format 'projects/{projectId}'.
+            scan_config (Union[dict, ~google.cloud.websecurityscanner_v1alpha.types.ScanConfig]): Required.
+                The ScanConfig to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_scan_config,
+                default_retry=self._method_configs["CreateScanConfig"].retry,
+                default_timeout=self._method_configs["CreateScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.CreateScanConfigRequest(
+            parent=parent, scan_config=scan_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_scan_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing ScanConfig and its child resources.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> client.delete_scan_config(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanConfig to be deleted. The name follows the
+                format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_scan_config,
+                default_retry=self._method_configs["DeleteScanConfig"].retry,
+                default_timeout=self._method_configs["DeleteScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.DeleteScanConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_scan_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> response = client.get_scan_config(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanConfig to be returned. The name follows the
+                format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_scan_config,
+                default_retry=self._method_configs["GetScanConfig"].retry,
+                default_timeout=self._method_configs["GetScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.GetScanConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_scan_configs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ScanConfigs under a given project.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_scan_configs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_scan_configs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a project resource name in the
+                format 'projects/{projectId}'.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanConfig` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_scan_configs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_scan_configs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_scan_configs,
+                default_retry=self._method_configs["ListScanConfigs"].retry,
+                default_timeout=self._method_configs["ListScanConfigs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListScanConfigsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_scan_configs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="scan_configs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_scan_config(
+        self,
+        scan_config,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a ScanConfig. This method support partial update of a ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> # TODO: Initialize `scan_config`:
+            >>> scan_config = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_scan_config(scan_config, update_mask)
+
+        Args:
+            scan_config (Union[dict, ~google.cloud.websecurityscanner_v1alpha.types.ScanConfig]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanConfig`
+            update_mask (Union[dict, ~google.cloud.websecurityscanner_v1alpha.types.FieldMask]): Required. The update mask applies to the resource. For the ``FieldMask``
+                definition, see
+                https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.websecurityscanner_v1alpha.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_scan_config,
+                default_retry=self._method_configs["UpdateScanConfig"].retry,
+                default_timeout=self._method_configs["UpdateScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.UpdateScanConfigRequest(
+            scan_config=scan_config, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("scan_config.name", scan_config.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def start_scan_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Start a ScanRun according to the given ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> response = client.start_scan_run(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanConfig to be used. The name follows the
+                format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "start_scan_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "start_scan_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.start_scan_run,
+                default_retry=self._method_configs["StartScanRun"].retry,
+                default_timeout=self._method_configs["StartScanRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.StartScanRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["start_scan_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_scan_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> response = client.get_scan_run(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanRun to be returned. The name follows the
+                format of
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_scan_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_scan_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_scan_run,
+                default_retry=self._method_configs["GetScanRun"].retry,
+                default_timeout=self._method_configs["GetScanRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.GetScanRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_scan_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_scan_runs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+        stop time.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_scan_runs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_scan_runs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan resource name in the
+                format 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanRun` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_scan_runs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_scan_runs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_scan_runs,
+                default_retry=self._method_configs["ListScanRuns"].retry,
+                default_timeout=self._method_configs["ListScanRuns"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListScanRunsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_scan_runs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="scan_runs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def stop_scan_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Stops a ScanRun. The stopped ScanRun is returned.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> response = client.stop_scan_run(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanRun to be stopped. The name follows the
+                format of
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ScanRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "stop_scan_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "stop_scan_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.stop_scan_run,
+                default_retry=self._method_configs["StopScanRun"].retry,
+                default_timeout=self._method_configs["StopScanRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.StopScanRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["stop_scan_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_crawled_urls(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List CrawledUrls under a given ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_crawled_urls(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_crawled_urls(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan run resource name in the
+                format
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1alpha.types.CrawledUrl` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_crawled_urls" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_crawled_urls"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_crawled_urls,
+                default_retry=self._method_configs["ListCrawledUrls"].retry,
+                default_timeout=self._method_configs["ListCrawledUrls"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListCrawledUrlsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_crawled_urls"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="crawled_urls",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_finding(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a Finding.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> name = client.finding_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]', '[FINDING]')
+            >>>
+            >>> response = client.get_finding(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the Finding to be returned. The name follows the
+                format of
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_finding" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_finding"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_finding,
+                default_retry=self._method_configs["GetFinding"].retry,
+                default_timeout=self._method_configs["GetFinding"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.GetFindingRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_finding"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_findings(
+        self,
+        parent,
+        filter_,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List Findings under a given ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_findings(parent, filter_):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_findings(parent, filter_).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan run resource name in the
+                format
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            filter_ (str): The filter expression. The expression must be in the format: . Supported
+                field: 'finding\_type'. Supported operator: '='.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1alpha.types.Finding` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_findings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_findings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_findings,
+                default_retry=self._method_configs["ListFindings"].retry,
+                default_timeout=self._method_configs["ListFindings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListFindingsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_findings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="findings",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_finding_type_stats(
+        self,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List all FindingTypeStats under a given ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1alpha
+            >>>
+            >>> client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> response = client.list_finding_type_stats(parent)
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan run resource name in the
+                format
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1alpha.types.ListFindingTypeStatsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_finding_type_stats" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_finding_type_stats"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_finding_type_stats,
+                default_retry=self._method_configs["ListFindingTypeStats"].retry,
+                default_timeout=self._method_configs["ListFindingTypeStats"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListFindingTypeStatsRequest(parent=parent)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_finding_type_stats"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/web_security_scanner_client_config.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/web_security_scanner_client_config.py
new file mode 100644
index 000000000000..e1550155721e
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/gapic/web_security_scanner_client_config.py
@@ -0,0 +1,88 @@
+config = {
+    "interfaces": {
+        "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListScanConfigs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "StartScanRun": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetScanRun": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListScanRuns": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "StopScanRun": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListCrawledUrls": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetFinding": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFindings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFindingTypeStats": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto
new file mode 100644
index 000000000000..d4c40eae86dd
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto
@@ -0,0 +1,42 @@
+// 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.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";
+option java_package = "com.google.cloud.websecurityscanner.v1alpha";
+
+// 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/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url_pb2.py
new file mode 100644
index 000000000000..8c6f9e9551b9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url_pb2.py
@@ -0,0 +1,141 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\017CrawledUrlProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        "\n?google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto\x12'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto\"<\n\nCrawledUrl\x12\x13\n\x0bhttp_method\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x0c\n\x04\x62ody\x18\x03 \x01(\tB\x9b\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x0f\x43rawledUrlProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3"
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_CRAWLEDURL = _descriptor.Descriptor(
+    name="CrawledUrl",
+    full_name="google.cloud.websecurityscanner.v1alpha.CrawledUrl",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.websecurityscanner.v1alpha.CrawledUrl.http_method",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.websecurityscanner.v1alpha.CrawledUrl.url",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.websecurityscanner.v1alpha.CrawledUrl.body",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=138,
+    serialized_end=198,
+)
+
+DESCRIPTOR.message_types_by_name["CrawledUrl"] = _CRAWLEDURL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CrawledUrl = _reflection.GeneratedProtocolMessageType(
+    "CrawledUrl",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRAWLEDURL,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.crawled_url_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      http_method:
+          Output only. The http method of the request that was used to
+          visit the URL, in uppercase.
+      url:
+          Output only. The URL that was crawled.
+      body:
+          Output only. The body of the request that was used to visit
+          the URL.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.CrawledUrl)
+    ),
+)
+_sym_db.RegisterMessage(CrawledUrl)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/crawled_url_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding.proto
new file mode 100644
index 000000000000..07140e276510
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding.proto
@@ -0,0 +1,140 @@
+// 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.cloud.websecurityscanner.v1alpha;
+
+import "google/api/annotations.proto";
+import "google/cloud/websecurityscanner/v1alpha/finding_addon.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "FindingProto";
+option java_package = "com.google.cloud.websecurityscanner.v1alpha";
+
+// A Finding resource represents a vulnerability instance identified during a
+// ScanRun.
+message Finding {
+  // Types of Findings.
+  enum FindingType {
+    // The invalid finding type.
+    FINDING_TYPE_UNSPECIFIED = 0;
+
+    // A page that was served over HTTPS also resources over HTTP. A
+    // man-in-the-middle attacker could tamper with the HTTP resource and gain
+    // full access to the website that loads the resource or to monitor the
+    // actions taken by the user.
+    MIXED_CONTENT = 1;
+
+    // The version of an included library is known to contain a security issue.
+    // The scanner checks the version of library in use against a known list of
+    // vulnerable libraries. False positives are possible if the version
+    // detection fails or if the library has been manually patched.
+    OUTDATED_LIBRARY = 2;
+
+    // This type of vulnerability occurs when the value of a request parameter
+    // is reflected at the beginning of the response, for example, in requests
+    // using JSONP. Under certain circumstances, an attacker may be able to
+    // supply an alphanumeric-only Flash file in the vulnerable parameter
+    // causing the browser to execute the Flash file as if it originated on the
+    // vulnerable server.
+    ROSETTA_FLASH = 5;
+
+    // A cross-site scripting (XSS) bug is found via JavaScript callback. For
+    // detailed explanations on XSS, see
+    // https://www.google.com/about/appsecurity/learning/xss/.
+    XSS_CALLBACK = 3;
+
+    // A potential cross-site scripting (XSS) bug due to JavaScript breakage.
+    // In some circumstances, the application under test might modify the test
+    // string before it is parsed by the browser. When the browser attempts to
+    // runs this modified test string, it will likely break and throw a
+    // JavaScript execution error, thus an injection issue is occurring.
+    // However, it may not be exploitable. Manual verification is needed to see
+    // if the test string modifications can be evaded and confirm that the issue
+    // is in fact an XSS vulnerability. For detailed explanations on XSS, see
+    // https://www.google.com/about/appsecurity/learning/xss/.
+    XSS_ERROR = 4;
+
+    // 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;
+  }
+
+  // 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 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/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto
new file mode 100644
index 000000000000..a7d344b84bc6
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto
@@ -0,0 +1,61 @@
+// 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.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";
+option java_package = "com.google.cloud.websecurityscanner.v1alpha";
+
+// 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 reported for an XSS.
+message Xss {
+  // 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;
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon_pb2.py
new file mode 100644
index 000000000000..fa01f56ca8a0
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon_pb2.py
@@ -0,0 +1,352 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\021FindingAddonProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        '\nAgoogle/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto\x12\'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto"Q\n\x0fOutdatedLibrary\x12\x14\n\x0clibrary_name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x17\n\x0flearn_more_urls\x18\x03 \x03(\t"?\n\x11ViolatingResource\x12\x14\n\x0c\x63ontent_type\x18\x01 \x01(\t\x12\x14\n\x0cresource_url\x18\x02 \x01(\t"/\n\x14VulnerableParameters\x12\x17\n\x0fparameter_names\x18\x01 \x03(\t"2\n\x03Xss\x12\x14\n\x0cstack_traces\x18\x01 \x03(\t\x12\x15\n\rerror_message\x18\x02 \x01(\tB\x9d\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x11\x46indingAddonProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_OUTDATEDLIBRARY = _descriptor.Descriptor(
+    name="OutdatedLibrary",
+    full_name="google.cloud.websecurityscanner.v1alpha.OutdatedLibrary",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="library_name",
+            full_name="google.cloud.websecurityscanner.v1alpha.OutdatedLibrary.library_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.websecurityscanner.v1alpha.OutdatedLibrary.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="learn_more_urls",
+            full_name="google.cloud.websecurityscanner.v1alpha.OutdatedLibrary.learn_more_urls",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=140,
+    serialized_end=221,
+)
+
+
+_VIOLATINGRESOURCE = _descriptor.Descriptor(
+    name="ViolatingResource",
+    full_name="google.cloud.websecurityscanner.v1alpha.ViolatingResource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.websecurityscanner.v1alpha.ViolatingResource.content_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_url",
+            full_name="google.cloud.websecurityscanner.v1alpha.ViolatingResource.resource_url",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=223,
+    serialized_end=286,
+)
+
+
+_VULNERABLEPARAMETERS = _descriptor.Descriptor(
+    name="VulnerableParameters",
+    full_name="google.cloud.websecurityscanner.v1alpha.VulnerableParameters",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parameter_names",
+            full_name="google.cloud.websecurityscanner.v1alpha.VulnerableParameters.parameter_names",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=288,
+    serialized_end=335,
+)
+
+
+_XSS = _descriptor.Descriptor(
+    name="Xss",
+    full_name="google.cloud.websecurityscanner.v1alpha.Xss",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stack_traces",
+            full_name="google.cloud.websecurityscanner.v1alpha.Xss.stack_traces",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error_message",
+            full_name="google.cloud.websecurityscanner.v1alpha.Xss.error_message",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=337,
+    serialized_end=387,
+)
+
+DESCRIPTOR.message_types_by_name["OutdatedLibrary"] = _OUTDATEDLIBRARY
+DESCRIPTOR.message_types_by_name["ViolatingResource"] = _VIOLATINGRESOURCE
+DESCRIPTOR.message_types_by_name["VulnerableParameters"] = _VULNERABLEPARAMETERS
+DESCRIPTOR.message_types_by_name["Xss"] = _XSS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+OutdatedLibrary = _reflection.GeneratedProtocolMessageType(
+    "OutdatedLibrary",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTDATEDLIBRARY,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.finding_addon_pb2",
+        __doc__="""Information reported for an outdated library.
+  
+  
+  Attributes:
+      library_name:
+          The name of the outdated library.
+      version:
+          The version number.
+      learn_more_urls:
+          URLs to learn more information about the vulnerabilities in
+          the library.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.OutdatedLibrary)
+    ),
+)
+_sym_db.RegisterMessage(OutdatedLibrary)
+
+ViolatingResource = _reflection.GeneratedProtocolMessageType(
+    "ViolatingResource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIOLATINGRESOURCE,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.finding_addon_pb2",
+        __doc__="""Information regarding any resource causing the vulnerability such as
+  JavaScript sources, image, audio files, etc.
+  
+  
+  Attributes:
+      content_type:
+          The MIME type of this resource.
+      resource_url:
+          URL of this violating resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ViolatingResource)
+    ),
+)
+_sym_db.RegisterMessage(ViolatingResource)
+
+VulnerableParameters = _reflection.GeneratedProtocolMessageType(
+    "VulnerableParameters",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VULNERABLEPARAMETERS,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.finding_addon_pb2",
+        __doc__="""Information about vulnerable request parameters.
+  
+  
+  Attributes:
+      parameter_names:
+          The vulnerable parameter names.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.VulnerableParameters)
+    ),
+)
+_sym_db.RegisterMessage(VulnerableParameters)
+
+Xss = _reflection.GeneratedProtocolMessageType(
+    "Xss",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_XSS,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.finding_addon_pb2",
+        __doc__="""Information reported for an XSS.
+  
+  
+  Attributes:
+      stack_traces:
+          Stack traces leading to the point where the XSS occurred.
+      error_message:
+          An error message generated by a javascript breakage.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.Xss)
+    ),
+)
+_sym_db.RegisterMessage(Xss)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_addon_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_pb2.py
new file mode 100644
index 000000000000..da3678c40687
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_pb2.py
@@ -0,0 +1,448 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/finding.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    finding_addon_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__addon__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/finding.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\014FindingProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        '\n;google/cloud/websecurityscanner_v1alpha/proto/finding.proto\x12\'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a\x41google/cloud/websecurityscanner_v1alpha/proto/finding_addon.proto"\xf5\x05\n\x07\x46inding\x12\x0c\n\x04name\x18\x01 \x01(\t\x12R\n\x0c\x66inding_type\x18\x02 \x01(\x0e\x32<.google.cloud.websecurityscanner.v1alpha.Finding.FindingType\x12\x13\n\x0bhttp_method\x18\x03 \x01(\t\x12\x12\n\nfuzzed_url\x18\x04 \x01(\t\x12\x0c\n\x04\x62ody\x18\x05 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x06 \x01(\t\x12\x18\n\x10reproduction_url\x18\x07 \x01(\t\x12\x11\n\tframe_url\x18\x08 \x01(\t\x12\x11\n\tfinal_url\x18\t \x01(\t\x12\x13\n\x0btracking_id\x18\n \x01(\t\x12R\n\x10outdated_library\x18\x0b \x01(\x0b\x32\x38.google.cloud.websecurityscanner.v1alpha.OutdatedLibrary\x12V\n\x12violating_resource\x18\x0c \x01(\x0b\x32:.google.cloud.websecurityscanner.v1alpha.ViolatingResource\x12\\\n\x15vulnerable_parameters\x18\r \x01(\x0b\x32=.google.cloud.websecurityscanner.v1alpha.VulnerableParameters\x12\x39\n\x03xss\x18\x0e \x01(\x0b\x32,.google.cloud.websecurityscanner.v1alpha.Xss"\xa1\x01\n\x0b\x46indingType\x12\x1c\n\x18\x46INDING_TYPE_UNSPECIFIED\x10\x00\x12\x11\n\rMIXED_CONTENT\x10\x01\x12\x14\n\x10OUTDATED_LIBRARY\x10\x02\x12\x11\n\rROSETTA_FLASH\x10\x05\x12\x10\n\x0cXSS_CALLBACK\x10\x03\x12\r\n\tXSS_ERROR\x10\x04\x12\x17\n\x13\x43LEAR_TEXT_PASSWORD\x10\x06\x42\x98\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x0c\x46indingProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__addon__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_FINDING_FINDINGTYPE = _descriptor.EnumDescriptor(
+    name="FindingType",
+    full_name="google.cloud.websecurityscanner.v1alpha.Finding.FindingType",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="FINDING_TYPE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MIXED_CONTENT", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OUTDATED_LIBRARY",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ROSETTA_FLASH", index=3, number=5, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="XSS_CALLBACK", index=4, number=3, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="XSS_ERROR", index=5, number=4, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CLEAR_TEXT_PASSWORD",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=798,
+    serialized_end=959,
+)
+_sym_db.RegisterEnumDescriptor(_FINDING_FINDINGTYPE)
+
+
+_FINDING = _descriptor.Descriptor(
+    name="Finding",
+    full_name="google.cloud.websecurityscanner.v1alpha.Finding",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding_type",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.finding_type",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.http_method",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fuzzed_url",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.fuzzed_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.body",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.description",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reproduction_url",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.reproduction_url",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_url",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.frame_url",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="final_url",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.final_url",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tracking_id",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.tracking_id",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="outdated_library",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.outdated_library",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violating_resource",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.violating_resource",
+            index=11,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="vulnerable_parameters",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.vulnerable_parameters",
+            index=12,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="xss",
+            full_name="google.cloud.websecurityscanner.v1alpha.Finding.xss",
+            index=13,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_FINDING_FINDINGTYPE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=202,
+    serialized_end=959,
+)
+
+_FINDING.fields_by_name["finding_type"].enum_type = _FINDING_FINDINGTYPE
+_FINDING.fields_by_name[
+    "outdated_library"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__addon__pb2._OUTDATEDLIBRARY
+)
+_FINDING.fields_by_name[
+    "violating_resource"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__addon__pb2._VIOLATINGRESOURCE
+)
+_FINDING.fields_by_name[
+    "vulnerable_parameters"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__addon__pb2._VULNERABLEPARAMETERS
+)
+_FINDING.fields_by_name[
+    "xss"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__addon__pb2._XSS
+)
+_FINDING_FINDINGTYPE.containing_type = _FINDING
+DESCRIPTOR.message_types_by_name["Finding"] = _FINDING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Finding = _reflection.GeneratedProtocolMessageType(
+    "Finding",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINDING,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.finding_pb2",
+        __doc__="""A Finding resource represents a vulnerability instance identified during
+  a ScanRun.
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name of the Finding. The name
+          follows the format of 'projects/{projectId}/scanConfigs/{scanC
+          onfigId}/scanruns/{scanRunId}/findings/{findingId}'. The
+          finding IDs are generated by the system.
+      finding_type:
+          Output only. The type of the Finding.
+      http_method:
+          Output only. The http method of the request that triggered the
+          vulnerability, in uppercase.
+      fuzzed_url:
+          Output only. The URL produced by the server-side fuzzer and
+          used in the request that triggered the vulnerability.
+      body:
+          Output only. The body of the request that triggered the
+          vulnerability.
+      description:
+          Output only. The description of the vulnerability.
+      reproduction_url:
+          Output only. The URL containing human-readable payload that
+          user can leverage to reproduce the vulnerability.
+      frame_url:
+          Output only. If the vulnerability was originated from nested
+          IFrame, the immediate parent IFrame is reported.
+      final_url:
+          Output only. The URL where the browser lands when the
+          vulnerability is detected.
+      tracking_id:
+          Output only. The tracking ID uniquely identifies a
+          vulnerability instance across multiple ScanRuns.
+      outdated_library:
+          Output only. An addon containing information about outdated
+          libraries.
+      violating_resource:
+          Output only. An addon containing detailed information
+          regarding any resource causing the vulnerability such as
+          JavaScript sources, image, audio files, etc.
+      vulnerable_parameters:
+          Output only. An addon containing information about request
+          parameters which were found to be vulnerable.
+      xss:
+          Output only. An addon containing information reported for an
+          XSS, if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.Finding)
+    ),
+)
+_sym_db.RegisterMessage(Finding)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto
new file mode 100644
index 000000000000..73115667f418
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto
@@ -0,0 +1,37 @@
+// 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.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";
+option java_multiple_files = true;
+option java_outer_classname = "FindingTypeStatsProto";
+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/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats_pb2.py
new file mode 100644
index 000000000000..a3e68d8e4184
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats_pb2.py
@@ -0,0 +1,129 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    finding_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\025FindingTypeStatsProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        "\nFgoogle/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto\x12'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a;google/cloud/websecurityscanner_v1alpha/proto/finding.proto\"}\n\x10\x46indingTypeStats\x12R\n\x0c\x66inding_type\x18\x01 \x01(\x0e\x32<.google.cloud.websecurityscanner.v1alpha.Finding.FindingType\x12\x15\n\rfinding_count\x18\x02 \x01(\x05\x42\xa1\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x15\x46indingTypeStatsProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3"
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_FINDINGTYPESTATS = _descriptor.Descriptor(
+    name="FindingTypeStats",
+    full_name="google.cloud.websecurityscanner.v1alpha.FindingTypeStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding_type",
+            full_name="google.cloud.websecurityscanner.v1alpha.FindingTypeStats.finding_type",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding_count",
+            full_name="google.cloud.websecurityscanner.v1alpha.FindingTypeStats.finding_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=206,
+    serialized_end=331,
+)
+
+_FINDINGTYPESTATS.fields_by_name[
+    "finding_type"
+].enum_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2._FINDING_FINDINGTYPE
+)
+DESCRIPTOR.message_types_by_name["FindingTypeStats"] = _FINDINGTYPESTATS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+FindingTypeStats = _reflection.GeneratedProtocolMessageType(
+    "FindingTypeStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINDINGTYPESTATS,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.finding_type_stats_pb2",
+        __doc__="""A FindingTypeStats resource represents stats regarding a specific
+  FindingType of Findings under a given ScanRun.
+  
+  
+  Attributes:
+      finding_type:
+          Output only. The finding type associated with the stats.
+      finding_count:
+          Output only. The count of findings belonging to this finding
+          type.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.FindingTypeStats)
+    ),
+)
+_sym_db.RegisterMessage(FindingTypeStats)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto
new file mode 100644
index 000000000000..144f7f2b5e4c
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto
@@ -0,0 +1,149 @@
+// 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.cloud.websecurityscanner.v1alpha;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanConfigProto";
+option java_package = "com.google.cloud.websecurityscanner.v1alpha";
+
+// 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;
+
+      // Input only.
+      // Required.
+      // The password of the Google account. The credential is stored encrypted
+      // and not returned in any response.
+      string password = 2;
+    }
+
+    // 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.
+    // Authentication configuration
+    oneof authentication {
+      // Authentication using a Google account.
+      GoogleAccount google_account = 1;
+
+      // Authentication using a custom account.
+      CustomAccount custom_account = 2;
+    }
+  }
+
+  // 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;
+  }
+
+  // Cloud platforms supported by Cloud Web Security Scanner.
+  enum TargetPlatform {
+    // The target platform is unknown. Requests with this enum value will be
+    // rejected with INVALID_ARGUMENT error.
+    TARGET_PLATFORM_UNSPECIFIED = 0;
+
+    // Google App Engine service.
+    APP_ENGINE = 1;
+
+    // Google Compute Engine service.
+    COMPUTE = 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 blacklist URL patterns as described in
+  // https://cloud.google.com/security-scanner/docs/excluded-urls
+  repeated string blacklist_patterns = 7;
+
+  // The schedule of the ScanConfig.
+  Schedule schedule = 8;
+
+  // Set of Cloud Platforms targeted by the scan. If empty, APP_ENGINE will be
+  // used as a default.
+  repeated TargetPlatform target_platforms = 9;
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config_pb2.py
new file mode 100644
index 000000000000..71de8f3294cf
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config_pb2.py
@@ -0,0 +1,698 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\017ScanConfigProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        '\n?google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto\x12\'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xdc\x08\n\nScanConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x0f\n\x07max_qps\x18\x03 \x01(\x05\x12\x15\n\rstarting_urls\x18\x04 \x03(\t\x12Z\n\x0e\x61uthentication\x18\x05 \x01(\x0b\x32\x42.google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication\x12Q\n\nuser_agent\x18\x06 \x01(\x0e\x32=.google.cloud.websecurityscanner.v1alpha.ScanConfig.UserAgent\x12\x1a\n\x12\x62lacklist_patterns\x18\x07 \x03(\t\x12N\n\x08schedule\x18\x08 \x01(\x0b\x32<.google.cloud.websecurityscanner.v1alpha.ScanConfig.Schedule\x12\\\n\x10target_platforms\x18\t \x03(\x0e\x32\x42.google.cloud.websecurityscanner.v1alpha.ScanConfig.TargetPlatform\x1a\xf7\x02\n\x0e\x41uthentication\x12j\n\x0egoogle_account\x18\x01 \x01(\x0b\x32P.google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.GoogleAccountH\x00\x12j\n\x0e\x63ustom_account\x18\x02 \x01(\x0b\x32P.google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.CustomAccountH\x00\x1a\x33\n\rGoogleAccount\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x1a\x46\n\rCustomAccount\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x12\x11\n\tlogin_url\x18\x03 \x01(\tB\x10\n\x0e\x61uthentication\x1a]\n\x08Schedule\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1e\n\x16interval_duration_days\x18\x02 \x01(\x05"`\n\tUserAgent\x12\x1a\n\x16USER_AGENT_UNSPECIFIED\x10\x00\x12\x10\n\x0c\x43HROME_LINUX\x10\x01\x12\x12\n\x0e\x43HROME_ANDROID\x10\x02\x12\x11\n\rSAFARI_IPHONE\x10\x03"N\n\x0eTargetPlatform\x12\x1f\n\x1bTARGET_PLATFORM_UNSPECIFIED\x10\x00\x12\x0e\n\nAPP_ENGINE\x10\x01\x12\x0b\n\x07\x43OMPUTE\x10\x02\x42\x9b\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x0fScanConfigProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_SCANCONFIG_USERAGENT = _descriptor.EnumDescriptor(
+    name="UserAgent",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.UserAgent",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="USER_AGENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHROME_LINUX", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHROME_ANDROID", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFARI_IPHONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1112,
+    serialized_end=1208,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIG_USERAGENT)
+
+_SCANCONFIG_TARGETPLATFORM = _descriptor.EnumDescriptor(
+    name="TargetPlatform",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.TargetPlatform",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TARGET_PLATFORM_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APP_ENGINE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPUTE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1210,
+    serialized_end=1288,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIG_TARGETPLATFORM)
+
+
+_SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT = _descriptor.Descriptor(
+    name="GoogleAccount",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.GoogleAccount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.GoogleAccount.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.GoogleAccount.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=874,
+    serialized_end=925,
+)
+
+_SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT = _descriptor.Descriptor(
+    name="CustomAccount",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.CustomAccount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.CustomAccount.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.CustomAccount.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="login_url",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.CustomAccount.login_url",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=927,
+    serialized_end=997,
+)
+
+_SCANCONFIG_AUTHENTICATION = _descriptor.Descriptor(
+    name="Authentication",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="google_account",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.google_account",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_account",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.custom_account",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT,
+        _SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="authentication",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.authentication",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=640,
+    serialized_end=1015,
+)
+
+_SCANCONFIG_SCHEDULE = _descriptor.Descriptor(
+    name="Schedule",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Schedule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Schedule.schedule_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interval_duration_days",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.Schedule.interval_duration_days",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1017,
+    serialized_end=1110,
+)
+
+_SCANCONFIG = _descriptor.Descriptor(
+    name="ScanConfig",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_qps",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.max_qps",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="starting_urls",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.starting_urls",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authentication",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.authentication",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_agent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.user_agent",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blacklist_patterns",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.blacklist_patterns",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.schedule",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_platforms",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanConfig.target_platforms",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SCANCONFIG_AUTHENTICATION, _SCANCONFIG_SCHEDULE],
+    enum_types=[_SCANCONFIG_USERAGENT, _SCANCONFIG_TARGETPLATFORM],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=172,
+    serialized_end=1288,
+)
+
+_SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT.containing_type = _SCANCONFIG_AUTHENTICATION
+_SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT.containing_type = _SCANCONFIG_AUTHENTICATION
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "google_account"
+].message_type = _SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "custom_account"
+].message_type = _SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT
+_SCANCONFIG_AUTHENTICATION.containing_type = _SCANCONFIG
+_SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"].fields.append(
+    _SCANCONFIG_AUTHENTICATION.fields_by_name["google_account"]
+)
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "google_account"
+].containing_oneof = _SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"]
+_SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"].fields.append(
+    _SCANCONFIG_AUTHENTICATION.fields_by_name["custom_account"]
+)
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "custom_account"
+].containing_oneof = _SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"]
+_SCANCONFIG_SCHEDULE.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCANCONFIG_SCHEDULE.containing_type = _SCANCONFIG
+_SCANCONFIG.fields_by_name["authentication"].message_type = _SCANCONFIG_AUTHENTICATION
+_SCANCONFIG.fields_by_name["user_agent"].enum_type = _SCANCONFIG_USERAGENT
+_SCANCONFIG.fields_by_name["schedule"].message_type = _SCANCONFIG_SCHEDULE
+_SCANCONFIG.fields_by_name["target_platforms"].enum_type = _SCANCONFIG_TARGETPLATFORM
+_SCANCONFIG_USERAGENT.containing_type = _SCANCONFIG
+_SCANCONFIG_TARGETPLATFORM.containing_type = _SCANCONFIG
+DESCRIPTOR.message_types_by_name["ScanConfig"] = _SCANCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanConfig = _reflection.GeneratedProtocolMessageType(
+    "ScanConfig",
+    (_message.Message,),
+    dict(
+        Authentication=_reflection.GeneratedProtocolMessageType(
+            "Authentication",
+            (_message.Message,),
+            dict(
+                GoogleAccount=_reflection.GeneratedProtocolMessageType(
+                    "GoogleAccount",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT,
+                        __module__="google.cloud.websecurityscanner_v1alpha.proto.scan_config_pb2",
+                        __doc__="""Describes authentication configuration that uses a Google account.
+      
+      
+      Attributes:
+          username:
+              Required. The user name of the Google account.
+          password:
+              Input only. Required. The password of the Google account. The
+              credential is stored encrypted and not returned in any
+              response.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.GoogleAccount)
+                    ),
+                ),
+                CustomAccount=_reflection.GeneratedProtocolMessageType(
+                    "CustomAccount",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT,
+                        __module__="google.cloud.websecurityscanner_v1alpha.proto.scan_config_pb2",
+                        __doc__="""Describes authentication configuration that uses a custom account.
+      
+      
+      Attributes:
+          username:
+              Required. The user name of the custom account.
+          password:
+              Input only. Required. The password of the custom account. The
+              credential is stored encrypted and not returned in any
+              response.
+          login_url:
+              Required. The login form URL of the website.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication.CustomAccount)
+                    ),
+                ),
+                DESCRIPTOR=_SCANCONFIG_AUTHENTICATION,
+                __module__="google.cloud.websecurityscanner_v1alpha.proto.scan_config_pb2",
+                __doc__="""Scan authentication configuration.
+    
+    
+    Attributes:
+        authentication:
+            Required. Authentication configuration
+        google_account:
+            Authentication using a Google account.
+        custom_account:
+            Authentication using a custom account.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ScanConfig.Authentication)
+            ),
+        ),
+        Schedule=_reflection.GeneratedProtocolMessageType(
+            "Schedule",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SCANCONFIG_SCHEDULE,
+                __module__="google.cloud.websecurityscanner_v1alpha.proto.scan_config_pb2",
+                __doc__="""Scan schedule configuration.
+    
+    
+    Attributes:
+        schedule_time:
+            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.
+        interval_duration_days:
+            Required. The duration of time between executions in days.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ScanConfig.Schedule)
+            ),
+        ),
+        DESCRIPTOR=_SCANCONFIG,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.scan_config_pb2",
+        __doc__="""A ScanConfig resource contains the configurations to launch a scan.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ScanConfig. The name follows the
+          format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+          The ScanConfig IDs are generated by the system.
+      display_name:
+          Required. The user provided display name of the ScanConfig.
+      max_qps:
+          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.
+      starting_urls:
+          Required. The starting URLs from which the scanner finds site
+          pages.
+      authentication:
+          The authentication configuration. If specified, service will
+          use the authentication configuration during scanning.
+      user_agent:
+          The user agent used during scanning.
+      blacklist_patterns:
+          The blacklist URL patterns as described in
+          https://cloud.google.com/security-scanner/docs/excluded-urls
+      schedule:
+          The schedule of the ScanConfig.
+      target_platforms:
+          Set of Cloud Platforms targeted by the scan. If empty,
+          APP\_ENGINE will be used as a default.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ScanConfig)
+    ),
+)
+_sym_db.RegisterMessage(ScanConfig)
+_sym_db.RegisterMessage(ScanConfig.Authentication)
+_sym_db.RegisterMessage(ScanConfig.Authentication.GoogleAccount)
+_sym_db.RegisterMessage(ScanConfig.Authentication.CustomAccount)
+_sym_db.RegisterMessage(ScanConfig.Schedule)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_config_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto
new file mode 100644
index 000000000000..36e2d0925244
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto
@@ -0,0 +1,107 @@
+// 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.cloud.websecurityscanner.v1alpha;
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunProto";
+option java_package = "com.google.cloud.websecurityscanner.v1alpha";
+
+// A ScanRun is a output-only resource representing an actual run of the scan.
+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;
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run_pb2.py
new file mode 100644
index 000000000000..678080701f15
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run_pb2.py
@@ -0,0 +1,348 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\014ScanRunProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        '\n<google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto\x12\'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xbd\x04\n\x07ScanRun\x12\x0c\n\x04name\x18\x01 \x01(\t\x12X\n\x0f\x65xecution_state\x18\x02 \x01(\x0e\x32?.google.cloud.websecurityscanner.v1alpha.ScanRun.ExecutionState\x12R\n\x0cresult_state\x18\x03 \x01(\x0e\x32<.google.cloud.websecurityscanner.v1alpha.ScanRun.ResultState\x12.\n\nstart_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1a\n\x12urls_crawled_count\x18\x06 \x01(\x03\x12\x19\n\x11urls_tested_count\x18\x07 \x01(\x03\x12\x1b\n\x13has_vulnerabilities\x18\x08 \x01(\x08\x12\x18\n\x10progress_percent\x18\t \x01(\x05"Y\n\x0e\x45xecutionState\x12\x1f\n\x1b\x45XECUTION_STATE_UNSPECIFIED\x10\x00\x12\n\n\x06QUEUED\x10\x01\x12\x0c\n\x08SCANNING\x10\x02\x12\x0c\n\x08\x46INISHED\x10\x03"O\n\x0bResultState\x12\x1c\n\x18RESULT_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07SUCCESS\x10\x01\x12\t\n\x05\x45RROR\x10\x02\x12\n\n\x06KILLED\x10\x03\x42\x98\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x0cScanRunProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_SCANRUN_EXECUTIONSTATE = _descriptor.EnumDescriptor(
+    name="ExecutionState",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.ExecutionState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EXECUTION_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="QUEUED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCANNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=572,
+    serialized_end=661,
+)
+_sym_db.RegisterEnumDescriptor(_SCANRUN_EXECUTIONSTATE)
+
+_SCANRUN_RESULTSTATE = _descriptor.EnumDescriptor(
+    name="ResultState",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.ResultState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RESULT_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESS", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KILLED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=663,
+    serialized_end=742,
+)
+_sym_db.RegisterEnumDescriptor(_SCANRUN_RESULTSTATE)
+
+
+_SCANRUN = _descriptor.Descriptor(
+    name="ScanRun",
+    full_name="google.cloud.websecurityscanner.v1alpha.ScanRun",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="execution_state",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.execution_state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result_state",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.result_state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.start_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.end_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="urls_crawled_count",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.urls_crawled_count",
+            index=5,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="urls_tested_count",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.urls_tested_count",
+            index=6,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="has_vulnerabilities",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.has_vulnerabilities",
+            index=7,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ScanRun.progress_percent",
+            index=8,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SCANRUN_EXECUTIONSTATE, _SCANRUN_RESULTSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=169,
+    serialized_end=742,
+)
+
+_SCANRUN.fields_by_name["execution_state"].enum_type = _SCANRUN_EXECUTIONSTATE
+_SCANRUN.fields_by_name["result_state"].enum_type = _SCANRUN_RESULTSTATE
+_SCANRUN.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCANRUN.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCANRUN_EXECUTIONSTATE.containing_type = _SCANRUN
+_SCANRUN_RESULTSTATE.containing_type = _SCANRUN
+DESCRIPTOR.message_types_by_name["ScanRun"] = _SCANRUN
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanRun = _reflection.GeneratedProtocolMessageType(
+    "ScanRun",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCANRUN,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.scan_run_pb2",
+        __doc__="""A ScanRun is a output-only resource representing an actual run of the
+  scan.
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name of the ScanRun. The name
+          follows the format of 'projects/{projectId}/scanConfigs/{scanC
+          onfigId}/scanRuns/{scanRunId}'. The ScanRun IDs are generated
+          by the system.
+      execution_state:
+          Output only. The execution state of the ScanRun.
+      result_state:
+          Output only. The result state of the ScanRun. This field is
+          only available after the execution state reaches "FINISHED".
+      start_time:
+          Output only. The time at which the ScanRun started.
+      end_time:
+          Output only. The time at which the ScanRun reached termination
+          state - that the ScanRun is either finished or stopped by
+          user.
+      urls_crawled_count:
+          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.
+      urls_tested_count:
+          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.
+      has_vulnerabilities:
+          Output only. Whether the scan run has found any
+          vulnerabilities.
+      progress_percent:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ScanRun)
+    ),
+)
+_sym_db.RegisterMessage(ScanRun)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/scan_run_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner.proto b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner.proto
new file mode 100644
index 000000000000..b07516aaf4d0
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner.proto
@@ -0,0 +1,349 @@
+// 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.cloud.websecurityscanner.v1alpha;
+
+import "google/api/annotations.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";
+import "google/cloud/websecurityscanner/v1alpha/scan_config.proto";
+import "google/cloud/websecurityscanner/v1alpha/scan_run.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "WebSecurityScannerProto";
+option java_package = "com.google.cloud.websecurityscanner.v1alpha";
+
+// Cloud Web Security Scanner Service identifies security vulnerabilities in web
+// 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 {
+  // Creates a new ScanConfig.
+  rpc CreateScanConfig(CreateScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      post: "/v1alpha/{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: "/v1alpha/{name=projects/*/scanConfigs/*}"
+    };
+  }
+
+  // Gets a ScanConfig.
+  rpc GetScanConfig(GetScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      get: "/v1alpha/{name=projects/*/scanConfigs/*}"
+    };
+  }
+
+  // Lists ScanConfigs under a given project.
+  rpc ListScanConfigs(ListScanConfigsRequest)
+      returns (ListScanConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha/{parent=projects/*}/scanConfigs"
+    };
+  }
+
+  // Updates a ScanConfig. This method support partial update of a ScanConfig.
+  rpc UpdateScanConfig(UpdateScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      patch: "/v1alpha/{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: "/v1alpha/{name=projects/*/scanConfigs/*}:start"
+      body: "*"
+    };
+  }
+
+  // Gets a ScanRun.
+  rpc GetScanRun(GetScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      get: "/v1alpha/{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: "/v1alpha/{parent=projects/*/scanConfigs/*}/scanRuns"
+    };
+  }
+
+  // Stops a ScanRun. The stopped ScanRun is returned.
+  rpc StopScanRun(StopScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      post: "/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}:stop"
+      body: "*"
+    };
+  }
+
+  // List CrawledUrls under a given ScanRun.
+  rpc ListCrawledUrls(ListCrawledUrlsRequest)
+      returns (ListCrawledUrlsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
+    };
+  }
+
+  // Gets a Finding.
+  rpc GetFinding(GetFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      get: "/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
+    };
+  }
+
+  // List Findings under a given ScanRun.
+  rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
+    };
+  }
+
+  // List all FindingTypeStats under a given ScanRun.
+  rpc ListFindingTypeStats(ListFindingTypeStatsRequest)
+      returns (ListFindingTypeStatsResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha/{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: <field>
+  // <operator> <value>.
+  // 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/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner_pb2.py
new file mode 100644
index 000000000000..6cdfadd707ce
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner_pb2.py
@@ -0,0 +1,1662 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    crawled_url_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_crawled__url__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    finding_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    finding_type_stats_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__type__stats__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    scan_config_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    scan_run_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner.proto",
+    package="google.cloud.websecurityscanner.v1alpha",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n+com.google.cloud.websecurityscanner.v1alphaB\027WebSecurityScannerProtoP\001ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner"
+    ),
+    serialized_pb=_b(
+        '\nHgoogle/cloud/websecurityscanner_v1alpha/proto/web_security_scanner.proto\x12\'google.cloud.websecurityscanner.v1alpha\x1a\x1cgoogle/api/annotations.proto\x1a?google/cloud/websecurityscanner_v1alpha/proto/crawled_url.proto\x1a;google/cloud/websecurityscanner_v1alpha/proto/finding.proto\x1a\x46google/cloud/websecurityscanner_v1alpha/proto/finding_type_stats.proto\x1a?google/cloud/websecurityscanner_v1alpha/proto/scan_config.proto\x1a<google/cloud/websecurityscanner_v1alpha/proto/scan_run.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"s\n\x17\x43reateScanConfigRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12H\n\x0bscan_config\x18\x02 \x01(\x0b\x32\x33.google.cloud.websecurityscanner.v1alpha.ScanConfig"\'\n\x17\x44\x65leteScanConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"$\n\x14GetScanConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x16ListScanConfigsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"\x94\x01\n\x17UpdateScanConfigRequest\x12H\n\x0bscan_config\x18\x02 \x01(\x0b\x32\x33.google.cloud.websecurityscanner.v1alpha.ScanConfig\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"}\n\x17ListScanConfigsResponse\x12I\n\x0cscan_configs\x18\x01 \x03(\x0b\x32\x33.google.cloud.websecurityscanner.v1alpha.ScanConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"#\n\x13StartScanRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11GetScanRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"L\n\x13ListScanRunsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"t\n\x14ListScanRunsResponse\x12\x43\n\tscan_runs\x18\x01 \x03(\x0b\x32\x30.google.cloud.websecurityscanner.v1alpha.ScanRun\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t""\n\x12StopScanRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x16ListCrawledUrlsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"}\n\x17ListCrawledUrlsResponse\x12I\n\x0c\x63rawled_urls\x18\x01 \x03(\x0b\x32\x33.google.cloud.websecurityscanner.v1alpha.CrawledUrl\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"!\n\x11GetFindingRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x13ListFindingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05"s\n\x14ListFindingsResponse\x12\x42\n\x08\x66indings\x18\x01 \x03(\x0b\x32\x30.google.cloud.websecurityscanner.v1alpha.Finding\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"-\n\x1bListFindingTypeStatsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t"u\n\x1cListFindingTypeStatsResponse\x12U\n\x12\x66inding_type_stats\x18\x01 \x03(\x0b\x32\x39.google.cloud.websecurityscanner.v1alpha.FindingTypeStats2\xd0\x14\n\x12WebSecurityScanner\x12\xc8\x01\n\x10\x43reateScanConfig\x12@.google.cloud.websecurityscanner.v1alpha.CreateScanConfigRequest\x1a\x33.google.cloud.websecurityscanner.v1alpha.ScanConfig"=\x82\xd3\xe4\x93\x02\x37"(/v1alpha/{parent=projects/*}/scanConfigs:\x0bscan_config\x12\x9e\x01\n\x10\x44\x65leteScanConfig\x12@.google.cloud.websecurityscanner.v1alpha.DeleteScanConfigRequest\x1a\x16.google.protobuf.Empty"0\x82\xd3\xe4\x93\x02**(/v1alpha/{name=projects/*/scanConfigs/*}\x12\xb5\x01\n\rGetScanConfig\x12=.google.cloud.websecurityscanner.v1alpha.GetScanConfigRequest\x1a\x33.google.cloud.websecurityscanner.v1alpha.ScanConfig"0\x82\xd3\xe4\x93\x02*\x12(/v1alpha/{name=projects/*/scanConfigs/*}\x12\xc6\x01\n\x0fListScanConfigs\x12?.google.cloud.websecurityscanner.v1alpha.ListScanConfigsRequest\x1a@.google.cloud.websecurityscanner.v1alpha.ListScanConfigsResponse"0\x82\xd3\xe4\x93\x02*\x12(/v1alpha/{parent=projects/*}/scanConfigs\x12\xd4\x01\n\x10UpdateScanConfig\x12@.google.cloud.websecurityscanner.v1alpha.UpdateScanConfigRequest\x1a\x33.google.cloud.websecurityscanner.v1alpha.ScanConfig"I\x82\xd3\xe4\x93\x02\x43\x32\x34/v1alpha/{scan_config.name=projects/*/scanConfigs/*}:\x0bscan_config\x12\xb9\x01\n\x0cStartScanRun\x12<.google.cloud.websecurityscanner.v1alpha.StartScanRunRequest\x1a\x30.google.cloud.websecurityscanner.v1alpha.ScanRun"9\x82\xd3\xe4\x93\x02\x33"./v1alpha/{name=projects/*/scanConfigs/*}:start:\x01*\x12\xb7\x01\n\nGetScanRun\x12:.google.cloud.websecurityscanner.v1alpha.GetScanRunRequest\x1a\x30.google.cloud.websecurityscanner.v1alpha.ScanRun";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}\x12\xc8\x01\n\x0cListScanRuns\x12<.google.cloud.websecurityscanner.v1alpha.ListScanRunsRequest\x1a=.google.cloud.websecurityscanner.v1alpha.ListScanRunsResponse";\x82\xd3\xe4\x93\x02\x35\x12\x33/v1alpha/{parent=projects/*/scanConfigs/*}/scanRuns\x12\xc1\x01\n\x0bStopScanRun\x12;.google.cloud.websecurityscanner.v1alpha.StopScanRunRequest\x1a\x30.google.cloud.websecurityscanner.v1alpha.ScanRun"C\x82\xd3\xe4\x93\x02="8/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}:stop:\x01*\x12\xdf\x01\n\x0fListCrawledUrls\x12?.google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsRequest\x1a@.google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsResponse"I\x82\xd3\xe4\x93\x02\x43\x12\x41/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls\x12\xc2\x01\n\nGetFinding\x12:.google.cloud.websecurityscanner.v1alpha.GetFindingRequest\x1a\x30.google.cloud.websecurityscanner.v1alpha.Finding"F\x82\xd3\xe4\x93\x02@\x12>/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}\x12\xd3\x01\n\x0cListFindings\x12<.google.cloud.websecurityscanner.v1alpha.ListFindingsRequest\x1a=.google.cloud.websecurityscanner.v1alpha.ListFindingsResponse"F\x82\xd3\xe4\x93\x02@\x12>/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings\x12\xf3\x01\n\x14ListFindingTypeStats\x12\x44.google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsRequest\x1a\x45.google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsResponse"N\x82\xd3\xe4\x93\x02H\x12\x46/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStatsB\xa3\x01\n+com.google.cloud.websecurityscanner.v1alphaB\x17WebSecurityScannerProtoP\x01ZYgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscannerb\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_crawled__url__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__type__stats__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATESCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="CreateScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.CreateScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1alpha.CreateScanConfigRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scan_config",
+            full_name="google.cloud.websecurityscanner.v1alpha.CreateScanConfigRequest.scan_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=535,
+    serialized_end=650,
+)
+
+
+_DELETESCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="DeleteScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.DeleteScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.DeleteScanConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=652,
+    serialized_end=691,
+)
+
+
+_GETSCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="GetScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.GetScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.GetScanConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=693,
+    serialized_end=729,
+)
+
+
+_LISTSCANCONFIGSREQUEST = _descriptor.Descriptor(
+    name="ListScanConfigsRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=731,
+    serialized_end=810,
+)
+
+
+_UPDATESCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="UpdateScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.UpdateScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scan_config",
+            full_name="google.cloud.websecurityscanner.v1alpha.UpdateScanConfigRequest.scan_config",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.websecurityscanner.v1alpha.UpdateScanConfigRequest.update_mask",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=813,
+    serialized_end=961,
+)
+
+
+_LISTSCANCONFIGSRESPONSE = _descriptor.Descriptor(
+    name="ListScanConfigsResponse",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scan_configs",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsResponse.scan_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanConfigsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=963,
+    serialized_end=1088,
+)
+
+
+_STARTSCANRUNREQUEST = _descriptor.Descriptor(
+    name="StartScanRunRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.StartScanRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.StartScanRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1090,
+    serialized_end=1125,
+)
+
+
+_GETSCANRUNREQUEST = _descriptor.Descriptor(
+    name="GetScanRunRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.GetScanRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.GetScanRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1127,
+    serialized_end=1160,
+)
+
+
+_LISTSCANRUNSREQUEST = _descriptor.Descriptor(
+    name="ListScanRunsRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1162,
+    serialized_end=1238,
+)
+
+
+_LISTSCANRUNSRESPONSE = _descriptor.Descriptor(
+    name="ListScanRunsResponse",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scan_runs",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsResponse.scan_runs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListScanRunsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1240,
+    serialized_end=1356,
+)
+
+
+_STOPSCANRUNREQUEST = _descriptor.Descriptor(
+    name="StopScanRunRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.StopScanRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.StopScanRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1358,
+    serialized_end=1392,
+)
+
+
+_LISTCRAWLEDURLSREQUEST = _descriptor.Descriptor(
+    name="ListCrawledUrlsRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1394,
+    serialized_end=1473,
+)
+
+
+_LISTCRAWLEDURLSRESPONSE = _descriptor.Descriptor(
+    name="ListCrawledUrlsResponse",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crawled_urls",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsResponse.crawled_urls",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1475,
+    serialized_end=1600,
+)
+
+
+_GETFINDINGREQUEST = _descriptor.Descriptor(
+    name="GetFindingRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.GetFindingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1alpha.GetFindingRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1602,
+    serialized_end=1635,
+)
+
+
+_LISTFINDINGSREQUEST = _descriptor.Descriptor(
+    name="ListFindingsRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1637,
+    serialized_end=1729,
+)
+
+
+_LISTFINDINGSRESPONSE = _descriptor.Descriptor(
+    name="ListFindingsResponse",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="findings",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsResponse.findings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1731,
+    serialized_end=1846,
+)
+
+
+_LISTFINDINGTYPESTATSREQUEST = _descriptor.Descriptor(
+    name="ListFindingTypeStatsRequest",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1848,
+    serialized_end=1893,
+)
+
+
+_LISTFINDINGTYPESTATSRESPONSE = _descriptor.Descriptor(
+    name="ListFindingTypeStatsResponse",
+    full_name="google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding_type_stats",
+            full_name="google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsResponse.finding_type_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1895,
+    serialized_end=2012,
+)
+
+_CREATESCANCONFIGREQUEST.fields_by_name[
+    "scan_config"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2._SCANCONFIG
+)
+_UPDATESCANCONFIGREQUEST.fields_by_name[
+    "scan_config"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2._SCANCONFIG
+)
+_UPDATESCANCONFIGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTSCANCONFIGSRESPONSE.fields_by_name[
+    "scan_configs"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2._SCANCONFIG
+)
+_LISTSCANRUNSRESPONSE.fields_by_name[
+    "scan_runs"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2._SCANRUN
+)
+_LISTCRAWLEDURLSRESPONSE.fields_by_name[
+    "crawled_urls"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_crawled__url__pb2._CRAWLEDURL
+)
+_LISTFINDINGSRESPONSE.fields_by_name[
+    "findings"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2._FINDING
+)
+_LISTFINDINGTYPESTATSRESPONSE.fields_by_name[
+    "finding_type_stats"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__type__stats__pb2._FINDINGTYPESTATS
+)
+DESCRIPTOR.message_types_by_name["CreateScanConfigRequest"] = _CREATESCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["DeleteScanConfigRequest"] = _DELETESCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["GetScanConfigRequest"] = _GETSCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["ListScanConfigsRequest"] = _LISTSCANCONFIGSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateScanConfigRequest"] = _UPDATESCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["ListScanConfigsResponse"] = _LISTSCANCONFIGSRESPONSE
+DESCRIPTOR.message_types_by_name["StartScanRunRequest"] = _STARTSCANRUNREQUEST
+DESCRIPTOR.message_types_by_name["GetScanRunRequest"] = _GETSCANRUNREQUEST
+DESCRIPTOR.message_types_by_name["ListScanRunsRequest"] = _LISTSCANRUNSREQUEST
+DESCRIPTOR.message_types_by_name["ListScanRunsResponse"] = _LISTSCANRUNSRESPONSE
+DESCRIPTOR.message_types_by_name["StopScanRunRequest"] = _STOPSCANRUNREQUEST
+DESCRIPTOR.message_types_by_name["ListCrawledUrlsRequest"] = _LISTCRAWLEDURLSREQUEST
+DESCRIPTOR.message_types_by_name["ListCrawledUrlsResponse"] = _LISTCRAWLEDURLSRESPONSE
+DESCRIPTOR.message_types_by_name["GetFindingRequest"] = _GETFINDINGREQUEST
+DESCRIPTOR.message_types_by_name["ListFindingsRequest"] = _LISTFINDINGSREQUEST
+DESCRIPTOR.message_types_by_name["ListFindingsResponse"] = _LISTFINDINGSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ListFindingTypeStatsRequest"
+] = _LISTFINDINGTYPESTATSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListFindingTypeStatsResponse"
+] = _LISTFINDINGTYPESTATSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``CreateScanConfig`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name where the scan is created,
+          which should be a project resource name in the format
+          'projects/{projectId}'.
+      scan_config:
+          Required. The ScanConfig to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.CreateScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateScanConfigRequest)
+
+DeleteScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``DeleteScanConfig`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanConfig to be deleted.
+          The name follows the format of
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.DeleteScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteScanConfigRequest)
+
+GetScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``GetScanConfig`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanConfig to be returned.
+          The name follows the format of
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.GetScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetScanConfigRequest)
+
+ListScanConfigsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListScanConfigsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANCONFIGSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListScanConfigs`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a project
+          resource name in the format 'projects/{projectId}'.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListScanConfigsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListScanConfigsRequest)
+
+UpdateScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``UpdateScanConfigRequest`` method.
+  
+  
+  Attributes:
+      scan_config:
+          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.
+      update_mask:
+          Required. The update mask applies to the resource. For the
+          ``FieldMask`` definition, see
+          https://developers.google.com/protocol-
+          buffers/docs/reference/google.protobuf#fieldmask
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.UpdateScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateScanConfigRequest)
+
+ListScanConfigsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListScanConfigsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANCONFIGSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListScanConfigs`` method.
+  
+  
+  Attributes:
+      scan_configs:
+          The list of ScanConfigs returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListScanConfigsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListScanConfigsResponse)
+
+StartScanRunRequest = _reflection.GeneratedProtocolMessageType(
+    "StartScanRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STARTSCANRUNREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``StartScanRun`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanConfig to be used. The
+          name follows the format of
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.StartScanRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(StartScanRunRequest)
+
+GetScanRunRequest = _reflection.GeneratedProtocolMessageType(
+    "GetScanRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSCANRUNREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``GetScanRun`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanRun to be returned. The
+          name follows the format of 'projects/{projectId}/scanConfigs/{
+          scanConfigId}/scanRuns/{scanRunId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.GetScanRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetScanRunRequest)
+
+ListScanRunsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListScanRunsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANRUNSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListScanRuns`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan
+          resource name in the format
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListScanRunsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListScanRunsRequest)
+
+ListScanRunsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListScanRunsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANRUNSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListScanRuns`` method.
+  
+  
+  Attributes:
+      scan_runs:
+          The list of ScanRuns returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListScanRunsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListScanRunsResponse)
+
+StopScanRunRequest = _reflection.GeneratedProtocolMessageType(
+    "StopScanRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOPSCANRUNREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``StopScanRun`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanRun to be stopped. The
+          name follows the format of 'projects/{projectId}/scanConfigs/{
+          scanConfigId}/scanRuns/{scanRunId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.StopScanRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(StopScanRunRequest)
+
+ListCrawledUrlsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCrawledUrlsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRAWLEDURLSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListCrawledUrls`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan run
+          resource name in the format 'projects/{projectId}/scanConfigs/
+          {scanConfigId}/scanRuns/{scanRunId}'.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCrawledUrlsRequest)
+
+ListCrawledUrlsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCrawledUrlsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRAWLEDURLSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListCrawledUrls`` method.
+  
+  
+  Attributes:
+      crawled_urls:
+          The list of CrawledUrls returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListCrawledUrlsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCrawledUrlsResponse)
+
+GetFindingRequest = _reflection.GeneratedProtocolMessageType(
+    "GetFindingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETFINDINGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``GetFinding`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the Finding to be returned. The
+          name follows the format of 'projects/{projectId}/scanConfigs/{
+          scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.GetFindingRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetFindingRequest)
+
+ListFindingsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListFindings`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan run
+          resource name in the format 'projects/{projectId}/scanConfigs/
+          {scanConfigId}/scanRuns/{scanRunId}'.
+      filter:
+          The filter expression. The expression must be in the format: .
+          Supported field: 'finding\_type'. Supported operator: '='.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListFindingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsRequest)
+
+ListFindingsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListFindings`` method.
+  
+  
+  Attributes:
+      findings:
+          The list of Findings returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListFindingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsResponse)
+
+ListFindingTypeStatsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFindingTypeStatsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGTYPESTATSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListFindingTypeStats`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan run
+          resource name in the format 'projects/{projectId}/scanConfigs/
+          {scanConfigId}/scanRuns/{scanRunId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingTypeStatsRequest)
+
+ListFindingTypeStatsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFindingTypeStatsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGTYPESTATSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1alpha.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListFindingTypeStats`` method.
+  
+  
+  Attributes:
+      finding_type_stats:
+          The list of FindingTypeStats returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1alpha.ListFindingTypeStatsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingTypeStatsResponse)
+
+
+DESCRIPTOR._options = None
+
+_WEBSECURITYSCANNER = _descriptor.ServiceDescriptor(
+    name="WebSecurityScanner",
+    full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2015,
+    serialized_end=4655,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateScanConfig",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.CreateScanConfig",
+            index=0,
+            containing_service=None,
+            input_type=_CREATESCANCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2._SCANCONFIG,
+            serialized_options=_b(
+                '\202\323\344\223\0027"(/v1alpha/{parent=projects/*}/scanConfigs:\013scan_config'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteScanConfig",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.DeleteScanConfig",
+            index=1,
+            containing_service=None,
+            input_type=_DELETESCANCONFIGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002**(/v1alpha/{name=projects/*/scanConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetScanConfig",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.GetScanConfig",
+            index=2,
+            containing_service=None,
+            input_type=_GETSCANCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2._SCANCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002*\022(/v1alpha/{name=projects/*/scanConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListScanConfigs",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.ListScanConfigs",
+            index=3,
+            containing_service=None,
+            input_type=_LISTSCANCONFIGSREQUEST,
+            output_type=_LISTSCANCONFIGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002*\022(/v1alpha/{parent=projects/*}/scanConfigs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateScanConfig",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.UpdateScanConfig",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATESCANCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2._SCANCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002C24/v1alpha/{scan_config.name=projects/*/scanConfigs/*}:\013scan_config"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StartScanRun",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.StartScanRun",
+            index=5,
+            containing_service=None,
+            input_type=_STARTSCANRUNREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2._SCANRUN,
+            serialized_options=_b(
+                '\202\323\344\223\0023"./v1alpha/{name=projects/*/scanConfigs/*}:start:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetScanRun",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.GetScanRun",
+            index=6,
+            containing_service=None,
+            input_type=_GETSCANRUNREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2._SCANRUN,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListScanRuns",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.ListScanRuns",
+            index=7,
+            containing_service=None,
+            input_type=_LISTSCANRUNSREQUEST,
+            output_type=_LISTSCANRUNSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0025\0223/v1alpha/{parent=projects/*/scanConfigs/*}/scanRuns"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StopScanRun",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.StopScanRun",
+            index=8,
+            containing_service=None,
+            input_type=_STOPSCANRUNREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2._SCANRUN,
+            serialized_options=_b(
+                '\202\323\344\223\002="8/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}:stop:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCrawledUrls",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.ListCrawledUrls",
+            index=9,
+            containing_service=None,
+            input_type=_LISTCRAWLEDURLSREQUEST,
+            output_type=_LISTCRAWLEDURLSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002C\022A/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetFinding",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.GetFinding",
+            index=10,
+            containing_service=None,
+            input_type=_GETFINDINGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFindings",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.ListFindings",
+            index=11,
+            containing_service=None,
+            input_type=_LISTFINDINGSREQUEST,
+            output_type=_LISTFINDINGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002@\022>/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFindingTypeStats",
+            full_name="google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.ListFindingTypeStats",
+            index=12,
+            containing_service=None,
+            input_type=_LISTFINDINGTYPESTATSREQUEST,
+            output_type=_LISTFINDINGTYPESTATSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002H\022F/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStats"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_WEBSECURITYSCANNER)
+
+DESCRIPTOR.services_by_name["WebSecurityScanner"] = _WEBSECURITYSCANNER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner_pb2_grpc.py
new file mode 100644
index 000000000000..c50069030d88
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/proto/web_security_scanner_pb2_grpc.py
@@ -0,0 +1,269 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    finding_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    scan_config_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    scan_run_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2,
+)
+from google.cloud.websecurityscanner_v1alpha.proto import (
+    web_security_scanner_pb2 as google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class WebSecurityScannerStub(object):
+    """Cloud Web Security Scanner Service identifies security vulnerabilities in web
+  applications hosted on Google Cloud Platform. It crawls your application, and
+  attempts to exercise as many user inputs and event handlers as possible.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/CreateScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.CreateScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.ScanConfig.FromString,
+        )
+        self.DeleteScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/DeleteScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.DeleteScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/GetScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.GetScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.ScanConfig.FromString,
+        )
+        self.ListScanConfigs = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/ListScanConfigs",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsResponse.FromString,
+        )
+        self.UpdateScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/UpdateScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.UpdateScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.ScanConfig.FromString,
+        )
+        self.StartScanRun = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/StartScanRun",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.StartScanRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.ScanRun.FromString,
+        )
+        self.GetScanRun = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/GetScanRun",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.GetScanRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.ScanRun.FromString,
+        )
+        self.ListScanRuns = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/ListScanRuns",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanRunsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanRunsResponse.FromString,
+        )
+        self.StopScanRun = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/StopScanRun",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.StopScanRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.ScanRun.FromString,
+        )
+        self.ListCrawledUrls = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/ListCrawledUrls",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsResponse.FromString,
+        )
+        self.GetFinding = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/GetFinding",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.GetFindingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.ListFindings = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/ListFindings",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingsResponse.FromString,
+        )
+        self.ListFindingTypeStats = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1alpha.WebSecurityScanner/ListFindingTypeStats",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsResponse.FromString,
+        )
+
+
+class WebSecurityScannerServicer(object):
+    """Cloud Web Security Scanner Service identifies security vulnerabilities in web
+  applications hosted on Google Cloud Platform. It crawls your application, and
+  attempts to exercise as many user inputs and event handlers as possible.
+  """
+
+    def CreateScanConfig(self, request, context):
+        """Creates a new ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteScanConfig(self, request, context):
+        """Deletes an existing ScanConfig and its child resources.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetScanConfig(self, request, context):
+        """Gets a ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListScanConfigs(self, request, context):
+        """Lists ScanConfigs under a given project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateScanConfig(self, request, context):
+        """Updates a ScanConfig. This method support partial update of a ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StartScanRun(self, request, context):
+        """Start a ScanRun according to the given ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetScanRun(self, request, context):
+        """Gets a ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListScanRuns(self, request, context):
+        """Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+    stop time.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StopScanRun(self, request, context):
+        """Stops a ScanRun. The stopped ScanRun is returned.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCrawledUrls(self, request, context):
+        """List CrawledUrls under a given ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetFinding(self, request, context):
+        """Gets a Finding.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFindings(self, request, context):
+        """List Findings under a given ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFindingTypeStats(self, request, context):
+        """List all FindingTypeStats under a given ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_WebSecurityScannerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.CreateScanConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.ScanConfig.SerializeToString,
+        ),
+        "DeleteScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.DeleteScanConfigRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.GetScanConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.ScanConfig.SerializeToString,
+        ),
+        "ListScanConfigs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListScanConfigs,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsResponse.SerializeToString,
+        ),
+        "UpdateScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.UpdateScanConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__config__pb2.ScanConfig.SerializeToString,
+        ),
+        "StartScanRun": grpc.unary_unary_rpc_method_handler(
+            servicer.StartScanRun,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.StartScanRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.ScanRun.SerializeToString,
+        ),
+        "GetScanRun": grpc.unary_unary_rpc_method_handler(
+            servicer.GetScanRun,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.GetScanRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.ScanRun.SerializeToString,
+        ),
+        "ListScanRuns": grpc.unary_unary_rpc_method_handler(
+            servicer.ListScanRuns,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanRunsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListScanRunsResponse.SerializeToString,
+        ),
+        "StopScanRun": grpc.unary_unary_rpc_method_handler(
+            servicer.StopScanRun,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.StopScanRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_scan__run__pb2.ScanRun.SerializeToString,
+        ),
+        "ListCrawledUrls": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCrawledUrls,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsResponse.SerializeToString,
+        ),
+        "GetFinding": grpc.unary_unary_rpc_method_handler(
+            servicer.GetFinding,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.GetFindingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "ListFindings": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFindings,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingsResponse.SerializeToString,
+        ),
+        "ListFindingTypeStats": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFindingTypeStats,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1alpha_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+        rpc_method_handlers,
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1alpha/types.py b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/types.py
new file mode 100644
index 000000000000..317e75863a0d
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1alpha/types.py
@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.websecurityscanner_v1alpha.proto import crawled_url_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import finding_addon_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import finding_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import finding_type_stats_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import scan_config_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import scan_run_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import web_security_scanner_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [empty_pb2, field_mask_pb2, timestamp_pb2]
+
+_local_modules = [
+    crawled_url_pb2,
+    finding_addon_pb2,
+    finding_pb2,
+    finding_type_stats_pb2,
+    scan_config_pb2,
+    scan_run_pb2,
+    web_security_scanner_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.websecurityscanner_v1alpha.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/__init__.py
new file mode 100644
index 000000000000..0e06a70a1ad6
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/__init__.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+
+from google.cloud.websecurityscanner_v1beta import types
+from google.cloud.websecurityscanner_v1beta.gapic import enums
+from google.cloud.websecurityscanner_v1beta.gapic import web_security_scanner_client
+
+
+class WebSecurityScannerClient(web_security_scanner_client.WebSecurityScannerClient):
+    __doc__ = web_security_scanner_client.WebSecurityScannerClient.__doc__
+    enums = enums
+
+
+__all__ = ("enums", "types", "WebSecurityScannerClient")
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/enums.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/enums.py
new file mode 100644
index 000000000000..38dde89453e2
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/enums.py
@@ -0,0 +1,287 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Wrappers for protocol buffer enum types."""
+
+import enum
+
+
+class ScanConfig(object):
+    class ExportToSecurityCommandCenter(enum.IntEnum):
+        """
+        Controls export of scan configurations and results to Cloud Security
+        Command Center.
+
+        Attributes:
+          EXPORT_TO_SECURITY_COMMAND_CENTER_UNSPECIFIED (int): Use default, which is ENABLED.
+          ENABLED (int): Export results of this scan to Cloud Security Command Center.
+          DISABLED (int): Do not export results of this scan to Cloud Security Command Center.
+        """
+
+        EXPORT_TO_SECURITY_COMMAND_CENTER_UNSPECIFIED = 0
+        ENABLED = 1
+        DISABLED = 2
+
+    class RiskLevel(enum.IntEnum):
+        """
+        Scan risk levels supported by Cloud 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.
+
+        Attributes:
+          RISK_LEVEL_UNSPECIFIED (int): Use default, which is NORMAL.
+          NORMAL (int): Normal scanning (Recommended)
+          LOW (int): Lower impact scanning
+        """
+
+        RISK_LEVEL_UNSPECIFIED = 0
+        NORMAL = 1
+        LOW = 2
+
+    class TargetPlatform(enum.IntEnum):
+        """
+        Cloud platforms supported by Cloud Web Security Scanner.
+
+        Attributes:
+          TARGET_PLATFORM_UNSPECIFIED (int): The target platform is unknown. Requests with this enum value will be
+          rejected with INVALID\_ARGUMENT error.
+          APP_ENGINE (int): Google App Engine service.
+          COMPUTE (int): Google Compute Engine service.
+        """
+
+        TARGET_PLATFORM_UNSPECIFIED = 0
+        APP_ENGINE = 1
+        COMPUTE = 2
+
+    class UserAgent(enum.IntEnum):
+        """
+        Type of user agents used for scanning.
+
+        Attributes:
+          USER_AGENT_UNSPECIFIED (int): The user agent is unknown. Service will default to CHROME\_LINUX.
+          CHROME_LINUX (int): Chrome on Linux. This is the service default if unspecified.
+          CHROME_ANDROID (int): Chrome on Android.
+          SAFARI_IPHONE (int): Safari on IPhone.
+        """
+
+        USER_AGENT_UNSPECIFIED = 0
+        CHROME_LINUX = 1
+        CHROME_ANDROID = 2
+        SAFARI_IPHONE = 3
+
+
+class ScanConfigError(object):
+    class Code(enum.IntEnum):
+        """
+        Output only.
+        Defines an error reason code.
+        Next id: 43
+
+        Attributes:
+          CODE_UNSPECIFIED (int): There is no error.
+          OK (int): There is no error.
+          INTERNAL_ERROR (int): Indicates an internal server error.
+          Please DO NOT USE THIS ERROR CODE unless the root cause is truly unknown.
+          APPENGINE_API_BACKEND_ERROR (int): 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_NOT_ACCESSIBLE (int): One of the seed URLs is an App Engine URL but we cannot access the
+          App Engine API to validate scan settings.
+          APPENGINE_DEFAULT_HOST_MISSING (int): One of the seed URLs is an App Engine URL but the Default Host of the
+          App Engine is not set.
+          CANNOT_USE_GOOGLE_COM_ACCOUNT (int): Google corporate accounts can not be used for scanning.
+          CANNOT_USE_OWNER_ACCOUNT (int): The account of the scan creator can not be used for scanning.
+          COMPUTE_API_BACKEND_ERROR (int): This scan targets Compute Engine, but we cannot validate scan settings
+          due to a Compute Engine API backend error.
+          COMPUTE_API_NOT_ACCESSIBLE (int): This scan targets Compute Engine, but we cannot access the Compute Engine
+          API to validate the scan settings.
+          CUSTOM_LOGIN_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT (int): The Custom Login URL does not belong to the current project.
+          CUSTOM_LOGIN_URL_MALFORMED (int): The Custom Login URL is malformed (can not be parsed).
+          CUSTOM_LOGIN_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS (int): The Custom Login URL is mapped to a non-routable IP address in DNS.
+          CUSTOM_LOGIN_URL_MAPPED_TO_UNRESERVED_ADDRESS (int): The Custom Login URL is mapped to an IP address which is not reserved for
+          the current project.
+          CUSTOM_LOGIN_URL_HAS_NON_ROUTABLE_IP_ADDRESS (int): The Custom Login URL has a non-routable IP address.
+          CUSTOM_LOGIN_URL_HAS_UNRESERVED_IP_ADDRESS (int): The Custom Login URL has an IP address which is not reserved for the
+          current project.
+          DUPLICATE_SCAN_NAME (int): Another scan with the same name (case-sensitive) already exists.
+          INVALID_FIELD_VALUE (int): A field is set to an invalid value.
+          FAILED_TO_AUTHENTICATE_TO_TARGET (int): There was an error trying to authenticate to the scan target.
+          FINDING_TYPE_UNSPECIFIED (int): Finding type value is not specified in the list findings request.
+          FORBIDDEN_TO_SCAN_COMPUTE (int): Scan targets Compute Engine, yet current project was not whitelisted for
+          Google Compute Engine Scanning Alpha access.
+          MALFORMED_FILTER (int): 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_RESOURCE_NAME (int): The supplied resource name is malformed (can not be parsed).
+          PROJECT_INACTIVE (int): The current project is not in an active state.
+          REQUIRED_FIELD (int): A required field is not set.
+          RESOURCE_NAME_INCONSISTENT (int): Project id, scanconfig id, scanrun id, or finding id are not consistent
+          with each other in resource name.
+          SCAN_ALREADY_RUNNING (int): The scan being requested to start is already running.
+          SCAN_NOT_RUNNING (int): The scan that was requested to be stopped is not running.
+          SEED_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT (int): One of the seed URLs does not belong to the current project.
+          SEED_URL_MALFORMED (int): One of the seed URLs is malformed (can not be parsed).
+          SEED_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS (int): One of the seed URLs is mapped to a non-routable IP address in DNS.
+          SEED_URL_MAPPED_TO_UNRESERVED_ADDRESS (int): One of the seed URLs is mapped to an IP address which is not reserved
+          for the current project.
+          SEED_URL_HAS_NON_ROUTABLE_IP_ADDRESS (int): One of the seed URLs has on-routable IP address.
+          SEED_URL_HAS_UNRESERVED_IP_ADDRESS (int): One of the seed URLs has an IP address that is not reserved
+          for the current project.
+          SERVICE_ACCOUNT_NOT_CONFIGURED (int): The Cloud Security Scanner service account is not configured under the
+          project.
+          TOO_MANY_SCANS (int): A project has reached the maximum number of scans.
+          UNABLE_TO_RESOLVE_PROJECT_INFO (int): Resolving the details of the current project fails.
+          UNSUPPORTED_BLACKLIST_PATTERN_FORMAT (int): One or more blacklist patterns were in the wrong format.
+          UNSUPPORTED_FILTER (int): The supplied filter is not supported.
+          UNSUPPORTED_FINDING_TYPE (int): The supplied finding type is not supported. For example, we do not
+          provide findings of the given finding type.
+          UNSUPPORTED_URL_SCHEME (int): The URL scheme of one or more of the supplied URLs is not supported.
+        """
+
+        CODE_UNSPECIFIED = 0
+        OK = 0
+        INTERNAL_ERROR = 1
+        APPENGINE_API_BACKEND_ERROR = 2
+        APPENGINE_API_NOT_ACCESSIBLE = 3
+        APPENGINE_DEFAULT_HOST_MISSING = 4
+        CANNOT_USE_GOOGLE_COM_ACCOUNT = 6
+        CANNOT_USE_OWNER_ACCOUNT = 7
+        COMPUTE_API_BACKEND_ERROR = 8
+        COMPUTE_API_NOT_ACCESSIBLE = 9
+        CUSTOM_LOGIN_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT = 10
+        CUSTOM_LOGIN_URL_MALFORMED = 11
+        CUSTOM_LOGIN_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS = 12
+        CUSTOM_LOGIN_URL_MAPPED_TO_UNRESERVED_ADDRESS = 13
+        CUSTOM_LOGIN_URL_HAS_NON_ROUTABLE_IP_ADDRESS = 14
+        CUSTOM_LOGIN_URL_HAS_UNRESERVED_IP_ADDRESS = 15
+        DUPLICATE_SCAN_NAME = 16
+        INVALID_FIELD_VALUE = 18
+        FAILED_TO_AUTHENTICATE_TO_TARGET = 19
+        FINDING_TYPE_UNSPECIFIED = 20
+        FORBIDDEN_TO_SCAN_COMPUTE = 21
+        MALFORMED_FILTER = 22
+        MALFORMED_RESOURCE_NAME = 23
+        PROJECT_INACTIVE = 24
+        REQUIRED_FIELD = 25
+        RESOURCE_NAME_INCONSISTENT = 26
+        SCAN_ALREADY_RUNNING = 27
+        SCAN_NOT_RUNNING = 28
+        SEED_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT = 29
+        SEED_URL_MALFORMED = 30
+        SEED_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS = 31
+        SEED_URL_MAPPED_TO_UNRESERVED_ADDRESS = 32
+        SEED_URL_HAS_NON_ROUTABLE_IP_ADDRESS = 33
+        SEED_URL_HAS_UNRESERVED_IP_ADDRESS = 35
+        SERVICE_ACCOUNT_NOT_CONFIGURED = 36
+        TOO_MANY_SCANS = 37
+        UNABLE_TO_RESOLVE_PROJECT_INFO = 38
+        UNSUPPORTED_BLACKLIST_PATTERN_FORMAT = 39
+        UNSUPPORTED_FILTER = 40
+        UNSUPPORTED_FINDING_TYPE = 41
+        UNSUPPORTED_URL_SCHEME = 42
+
+
+class ScanRun(object):
+    class ExecutionState(enum.IntEnum):
+        """
+        Types of ScanRun execution state.
+
+        Attributes:
+          EXECUTION_STATE_UNSPECIFIED (int): Represents an invalid state caused by internal server error. This value
+          should never be returned.
+          QUEUED (int): The scan is waiting in the queue.
+          SCANNING (int): The scan is in progress.
+          FINISHED (int): The scan is either finished or stopped by user.
+        """
+
+        EXECUTION_STATE_UNSPECIFIED = 0
+        QUEUED = 1
+        SCANNING = 2
+        FINISHED = 3
+
+    class ResultState(enum.IntEnum):
+        """
+        Types of ScanRun result state.
+
+        Attributes:
+          RESULT_STATE_UNSPECIFIED (int): Default value. This value is returned when the ScanRun is not yet
+          finished.
+          SUCCESS (int): The scan finished without errors.
+          ERROR (int): The scan finished with errors.
+          KILLED (int): The scan was terminated by user.
+        """
+
+        RESULT_STATE_UNSPECIFIED = 0
+        SUCCESS = 1
+        ERROR = 2
+        KILLED = 3
+
+
+class ScanRunErrorTrace(object):
+    class Code(enum.IntEnum):
+        """
+        Output only.
+        Defines an error reason code.
+        Next id: 7
+
+        Attributes:
+          CODE_UNSPECIFIED (int): Default value is never used.
+          INTERNAL_ERROR (int): Indicates that the scan run failed due to an internal server error.
+          SCAN_CONFIG_ISSUE (int): Indicates a scan configuration error, usually due to outdated ScanConfig
+          settings, such as starting\_urls or the DNS configuration.
+          AUTHENTICATION_CONFIG_ISSUE (int): Indicates an authentication error, usually due to outdated ScanConfig
+          authentication settings.
+          TIMED_OUT_WHILE_SCANNING (int): Indicates a scan operation timeout, usually caused by a very large site.
+          TOO_MANY_REDIRECTS (int): Indicates that a scan encountered excessive redirects, either to
+          authentication or some other page outside of the scan scope.
+          TOO_MANY_HTTP_ERRORS (int): 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.
+        """
+
+        CODE_UNSPECIFIED = 0
+        INTERNAL_ERROR = 1
+        SCAN_CONFIG_ISSUE = 2
+        AUTHENTICATION_CONFIG_ISSUE = 3
+        TIMED_OUT_WHILE_SCANNING = 4
+        TOO_MANY_REDIRECTS = 5
+        TOO_MANY_HTTP_ERRORS = 6
+
+
+class ScanRunWarningTrace(object):
+    class Code(enum.IntEnum):
+        """
+        Output only.
+        Defines a warning message code.
+        Next id: 5
+
+        Attributes:
+          CODE_UNSPECIFIED (int): Default value is never used.
+          INSUFFICIENT_CRAWL_RESULTS (int): 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.
+          TOO_MANY_CRAWL_RESULTS (int): Indicates that a scan discovered too many URLs to test, or excessive
+          redundant URLs.
+          TOO_MANY_FUZZ_TASKS (int): 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.
+          BLOCKED_BY_IAP (int): Indicates that a scan is blocked by IAP.
+        """
+
+        CODE_UNSPECIFIED = 0
+        INSUFFICIENT_CRAWL_RESULTS = 1
+        TOO_MANY_CRAWL_RESULTS = 2
+        TOO_MANY_FUZZ_TASKS = 3
+        BLOCKED_BY_IAP = 4
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/transports/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/transports/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/transports/web_security_scanner_grpc_transport.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/transports/web_security_scanner_grpc_transport.py
new file mode 100644
index 000000000000..727a5dfb21f6
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/transports/web_security_scanner_grpc_transport.py
@@ -0,0 +1,283 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import google.api_core.grpc_helpers
+
+from google.cloud.websecurityscanner_v1beta.proto import web_security_scanner_pb2_grpc
+
+
+class WebSecurityScannerGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.websecurityscanner.v1beta WebSecurityScanner API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    def __init__(
+        self,
+        channel=None,
+        credentials=None,
+        address="websecurityscanner.googleapis.com:443",
+    ):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                "The `channel` and `credentials` arguments are mutually " "exclusive."
+            )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+                options={
+                    "grpc.max_send_message_length": -1,
+                    "grpc.max_receive_message_length": -1,
+                }.items(),
+            )
+
+        self._channel = channel
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            "web_security_scanner_stub": web_security_scanner_pb2_grpc.WebSecurityScannerStub(
+                channel
+            )
+        }
+
+    @classmethod
+    def create_channel(
+        cls, address="websecurityscanner.googleapis.com:443", credentials=None, **kwargs
+    ):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+            kwargs (dict): Keyword arguments, which are passed to the
+                channel creation.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs
+        )
+
+    @property
+    def channel(self):
+        """The gRPC channel used by the transport.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return self._channel
+
+    @property
+    def create_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.create_scan_config`.
+
+        Creates a new ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].CreateScanConfig
+
+    @property
+    def delete_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.delete_scan_config`.
+
+        Deletes an existing ScanConfig and its child resources.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].DeleteScanConfig
+
+    @property
+    def get_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.get_scan_config`.
+
+        Gets a ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].GetScanConfig
+
+    @property
+    def list_scan_configs(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_scan_configs`.
+
+        Lists ScanConfigs under a given project.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListScanConfigs
+
+    @property
+    def update_scan_config(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.update_scan_config`.
+
+        Updates a ScanConfig. This method support partial update of a ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].UpdateScanConfig
+
+    @property
+    def start_scan_run(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.start_scan_run`.
+
+        Start a ScanRun according to the given ScanConfig.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].StartScanRun
+
+    @property
+    def get_scan_run(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.get_scan_run`.
+
+        Gets a ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].GetScanRun
+
+    @property
+    def list_scan_runs(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_scan_runs`.
+
+        Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+        stop time.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListScanRuns
+
+    @property
+    def stop_scan_run(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.stop_scan_run`.
+
+        Stops a ScanRun. The stopped ScanRun is returned.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].StopScanRun
+
+    @property
+    def list_crawled_urls(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_crawled_urls`.
+
+        List CrawledUrls under a given ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListCrawledUrls
+
+    @property
+    def get_finding(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.get_finding`.
+
+        Gets a Finding.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].GetFinding
+
+    @property
+    def list_findings(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_findings`.
+
+        List Findings under a given ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListFindings
+
+    @property
+    def list_finding_type_stats(self):
+        """Return the gRPC stub for :meth:`WebSecurityScannerClient.list_finding_type_stats`.
+
+        List all FindingTypeStats under a given ScanRun.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs["web_security_scanner_stub"].ListFindingTypeStats
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/web_security_scanner_client.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/web_security_scanner_client.py
new file mode 100644
index 000000000000..fc1dc384dd9b
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/web_security_scanner_client.py
@@ -0,0 +1,1334 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Accesses the google.cloud.websecurityscanner.v1beta WebSecurityScanner API."""
+
+import functools
+import pkg_resources
+import warnings
+
+from google.oauth2 import service_account
+import google.api_core.client_options
+import google.api_core.gapic_v1.client_info
+import google.api_core.gapic_v1.config
+import google.api_core.gapic_v1.method
+import google.api_core.gapic_v1.routing_header
+import google.api_core.grpc_helpers
+import google.api_core.page_iterator
+import google.api_core.path_template
+import grpc
+
+from google.cloud.websecurityscanner_v1beta.gapic import enums
+from google.cloud.websecurityscanner_v1beta.gapic import (
+    web_security_scanner_client_config,
+)
+from google.cloud.websecurityscanner_v1beta.gapic.transports import (
+    web_security_scanner_grpc_transport,
+)
+from google.cloud.websecurityscanner_v1beta.proto import finding_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_config_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_run_pb2
+from google.cloud.websecurityscanner_v1beta.proto import web_security_scanner_pb2
+from google.cloud.websecurityscanner_v1beta.proto import web_security_scanner_pb2_grpc
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution(
+    "google-cloud-websecurityscanner"
+).version
+
+
+class WebSecurityScannerClient(object):
+    """
+    Cloud Web Security Scanner Service identifies security vulnerabilities in web
+    applications hosted on Google Cloud Platform. It crawls your application, and
+    attempts to exercise as many user inputs and event handlers as possible.
+    """
+
+    SERVICE_ADDRESS = "websecurityscanner.googleapis.com:443"
+    """The default address of the service."""
+
+    # The name of the interface for this client. This is the key used to
+    # find the method configuration in the client_config dictionary.
+    _INTERFACE_NAME = "google.cloud.websecurityscanner.v1beta.WebSecurityScanner"
+
+    @classmethod
+    def from_service_account_file(cls, filename, *args, **kwargs):
+        """Creates an instance of this client using the provided credentials
+        file.
+
+        Args:
+            filename (str): The path to the service account private key json
+                file.
+            args: Additional arguments to pass to the constructor.
+            kwargs: Additional arguments to pass to the constructor.
+
+        Returns:
+            WebSecurityScannerClient: The constructed client.
+        """
+        credentials = service_account.Credentials.from_service_account_file(filename)
+        kwargs["credentials"] = credentials
+        return cls(*args, **kwargs)
+
+    from_service_account_json = from_service_account_file
+
+    @classmethod
+    def finding_path(cls, project, scan_config, scan_run, finding):
+        """Return a fully-qualified finding string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}",
+            project=project,
+            scan_config=scan_config,
+            scan_run=scan_run,
+            finding=finding,
+        )
+
+    @classmethod
+    def project_path(cls, project):
+        """Return a fully-qualified project string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}", project=project
+        )
+
+    @classmethod
+    def scan_config_path(cls, project, scan_config):
+        """Return a fully-qualified scan_config string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/scanConfigs/{scan_config}",
+            project=project,
+            scan_config=scan_config,
+        )
+
+    @classmethod
+    def scan_run_path(cls, project, scan_config, scan_run):
+        """Return a fully-qualified scan_run string."""
+        return google.api_core.path_template.expand(
+            "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}",
+            project=project,
+            scan_config=scan_config,
+            scan_run=scan_run,
+        )
+
+    def __init__(
+        self,
+        transport=None,
+        channel=None,
+        credentials=None,
+        client_config=None,
+        client_info=None,
+        client_options=None,
+    ):
+        """Constructor.
+
+        Args:
+            transport (Union[~.WebSecurityScannerGrpcTransport,
+                    Callable[[~.Credentials, type], ~.WebSecurityScannerGrpcTransport]): A transport
+                instance, responsible for actually making the API calls.
+                The default transport uses the gRPC protocol.
+                This argument may also be a callable which returns a
+                transport instance. Callables will be sent the credentials
+                as the first argument and the default transport class as
+                the second argument.
+            channel (grpc.Channel): DEPRECATED. A ``Channel`` instance
+                through which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+                This argument is mutually exclusive with providing a
+                transport instance to ``transport``; doing so will raise
+                an exception.
+            client_config (dict): DEPRECATED. A dictionary of call options for
+                each method. If not specified, the default configuration is used.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            client_options (Union[dict, google.api_core.client_options.ClientOptions]):
+                Client options used to set user options on the client. API Endpoint
+                should be set through client_options.
+        """
+        # Raise deprecation warnings for things we want to go away.
+        if client_config is not None:
+            warnings.warn(
+                "The `client_config` argument is deprecated.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+        else:
+            client_config = web_security_scanner_client_config.config
+
+        if channel:
+            warnings.warn(
+                "The `channel` argument is deprecated; use " "`transport` instead.",
+                PendingDeprecationWarning,
+                stacklevel=2,
+            )
+
+        api_endpoint = self.SERVICE_ADDRESS
+        if client_options:
+            if type(client_options) == dict:
+                client_options = google.api_core.client_options.from_dict(
+                    client_options
+                )
+            if client_options.api_endpoint:
+                api_endpoint = client_options.api_endpoint
+
+        # Instantiate the transport.
+        # The transport is responsible for handling serialization and
+        # deserialization and actually sending data to the service.
+        if transport:
+            if callable(transport):
+                self.transport = transport(
+                    credentials=credentials,
+                    default_class=web_security_scanner_grpc_transport.WebSecurityScannerGrpcTransport,
+                    address=api_endpoint,
+                )
+            else:
+                if credentials:
+                    raise ValueError(
+                        "Received both a transport instance and "
+                        "credentials; these are mutually exclusive."
+                    )
+                self.transport = transport
+        else:
+            self.transport = web_security_scanner_grpc_transport.WebSecurityScannerGrpcTransport(
+                address=api_endpoint, channel=channel, credentials=credentials
+            )
+
+        if client_info is None:
+            client_info = google.api_core.gapic_v1.client_info.ClientInfo(
+                gapic_version=_GAPIC_LIBRARY_VERSION
+            )
+        else:
+            client_info.gapic_version = _GAPIC_LIBRARY_VERSION
+        self._client_info = client_info
+
+        # Parse out the default settings for retry and timeout for each RPC
+        # from the client configuration.
+        # (Ordinarily, these are the defaults specified in the `*_config.py`
+        # file next to this one.)
+        self._method_configs = google.api_core.gapic_v1.config.parse_method_configs(
+            client_config["interfaces"][self._INTERFACE_NAME]
+        )
+
+        # Save a dictionary of cached API call functions.
+        # These are the actual callables which invoke the proper
+        # transport methods, wrapped with `wrap_method` to add retry,
+        # timeout, and the like.
+        self._inner_api_calls = {}
+
+    # Service calls
+    def create_scan_config(
+        self,
+        parent,
+        scan_config,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Creates a new ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # TODO: Initialize `scan_config`:
+            >>> scan_config = {}
+            >>>
+            >>> response = client.create_scan_config(parent, scan_config)
+
+        Args:
+            parent (str): Required.
+                The parent resource name where the scan is created, which should be a
+                project resource name in the format 'projects/{projectId}'.
+            scan_config (Union[dict, ~google.cloud.websecurityscanner_v1beta.types.ScanConfig]): Required.
+                The ScanConfig to be created.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.websecurityscanner_v1beta.types.ScanConfig`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ScanConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "create_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "create_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.create_scan_config,
+                default_retry=self._method_configs["CreateScanConfig"].retry,
+                default_timeout=self._method_configs["CreateScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.CreateScanConfigRequest(
+            parent=parent, scan_config=scan_config
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["create_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def delete_scan_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Deletes an existing ScanConfig and its child resources.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> client.delete_scan_config(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanConfig to be deleted. The name follows the
+                format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "delete_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "delete_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.delete_scan_config,
+                default_retry=self._method_configs["DeleteScanConfig"].retry,
+                default_timeout=self._method_configs["DeleteScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.DeleteScanConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        self._inner_api_calls["delete_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_scan_config(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> response = client.get_scan_config(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanConfig to be returned. The name follows the
+                format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ScanConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_scan_config,
+                default_retry=self._method_configs["GetScanConfig"].retry,
+                default_timeout=self._method_configs["GetScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.GetScanConfigRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_scan_configs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ScanConfigs under a given project.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.project_path('[PROJECT]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_scan_configs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_scan_configs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a project resource name in the
+                format 'projects/{projectId}'.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1beta.types.ScanConfig` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_scan_configs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_scan_configs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_scan_configs,
+                default_retry=self._method_configs["ListScanConfigs"].retry,
+                default_timeout=self._method_configs["ListScanConfigs"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListScanConfigsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_scan_configs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="scan_configs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def update_scan_config(
+        self,
+        scan_config,
+        update_mask,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Updates a ScanConfig. This method support partial update of a ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> # TODO: Initialize `scan_config`:
+            >>> scan_config = {}
+            >>>
+            >>> # TODO: Initialize `update_mask`:
+            >>> update_mask = {}
+            >>>
+            >>> response = client.update_scan_config(scan_config, update_mask)
+
+        Args:
+            scan_config (Union[dict, ~google.cloud.websecurityscanner_v1beta.types.ScanConfig]): 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.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.websecurityscanner_v1beta.types.ScanConfig`
+            update_mask (Union[dict, ~google.cloud.websecurityscanner_v1beta.types.FieldMask]): Required. The update mask applies to the resource. For the ``FieldMask``
+                definition, see
+                https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.websecurityscanner_v1beta.types.FieldMask`
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ScanConfig` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "update_scan_config" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "update_scan_config"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.update_scan_config,
+                default_retry=self._method_configs["UpdateScanConfig"].retry,
+                default_timeout=self._method_configs["UpdateScanConfig"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.UpdateScanConfigRequest(
+            scan_config=scan_config, update_mask=update_mask
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("scan_config.name", scan_config.name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["update_scan_config"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def start_scan_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Start a ScanRun according to the given ScanConfig.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> response = client.start_scan_run(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanConfig to be used. The name follows the
+                format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ScanRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "start_scan_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "start_scan_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.start_scan_run,
+                default_retry=self._method_configs["StartScanRun"].retry,
+                default_timeout=self._method_configs["StartScanRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.StartScanRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["start_scan_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def get_scan_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> response = client.get_scan_run(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanRun to be returned. The name follows the
+                format of
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ScanRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_scan_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_scan_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_scan_run,
+                default_retry=self._method_configs["GetScanRun"].retry,
+                default_timeout=self._method_configs["GetScanRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.GetScanRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_scan_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_scan_runs(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+        stop time.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_config_path('[PROJECT]', '[SCAN_CONFIG]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_scan_runs(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_scan_runs(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan resource name in the
+                format 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1beta.types.ScanRun` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_scan_runs" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_scan_runs"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_scan_runs,
+                default_retry=self._method_configs["ListScanRuns"].retry,
+                default_timeout=self._method_configs["ListScanRuns"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListScanRunsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_scan_runs"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="scan_runs",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def stop_scan_run(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Stops a ScanRun. The stopped ScanRun is returned.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> name = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> response = client.stop_scan_run(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the ScanRun to be stopped. The name follows the
+                format of
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ScanRun` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "stop_scan_run" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "stop_scan_run"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.stop_scan_run,
+                default_retry=self._method_configs["StopScanRun"].retry,
+                default_timeout=self._method_configs["StopScanRun"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.StopScanRunRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["stop_scan_run"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_crawled_urls(
+        self,
+        parent,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List CrawledUrls under a given ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_crawled_urls(parent):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_crawled_urls(parent).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan run resource name in the
+                format
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1beta.types.CrawledUrl` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_crawled_urls" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_crawled_urls"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_crawled_urls,
+                default_retry=self._method_configs["ListCrawledUrls"].retry,
+                default_timeout=self._method_configs["ListCrawledUrls"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListCrawledUrlsRequest(
+            parent=parent, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_crawled_urls"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="crawled_urls",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def get_finding(
+        self,
+        name,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        Gets a Finding.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> name = client.finding_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]', '[FINDING]')
+            >>>
+            >>> response = client.get_finding(name)
+
+        Args:
+            name (str): Required.
+                The resource name of the Finding to be returned. The name follows the
+                format of
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.Finding` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "get_finding" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "get_finding"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.get_finding,
+                default_retry=self._method_configs["GetFinding"].retry,
+                default_timeout=self._method_configs["GetFinding"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.GetFindingRequest(name=name)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("name", name)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["get_finding"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    def list_findings(
+        self,
+        parent,
+        filter_,
+        page_size=None,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List Findings under a given ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> # TODO: Initialize `filter_`:
+            >>> filter_ = ''
+            >>>
+            >>> # Iterate over all results
+            >>> for element in client.list_findings(parent, filter_):
+            ...     # process element
+            ...     pass
+            >>>
+            >>>
+            >>> # Alternatively:
+            >>>
+            >>> # Iterate over results one page at a time
+            >>> for page in client.list_findings(parent, filter_).pages:
+            ...     for element in page:
+            ...         # process element
+            ...         pass
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan run resource name in the
+                format
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            filter_ (str): The filter expression. The expression must be in the format: . Supported
+                field: 'finding\_type'. Supported operator: '='.
+            page_size (int): The maximum number of resources contained in the
+                underlying API response. If page streaming is performed per-
+                resource, this parameter does not affect the return value. If page
+                streaming is performed per-page, this determines the maximum number
+                of resources in a page.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.api_core.page_iterator.PageIterator` instance.
+            An iterable of :class:`~google.cloud.websecurityscanner_v1beta.types.Finding` instances.
+            You can also iterate over the pages of the response
+            using its `pages` property.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_findings" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_findings"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_findings,
+                default_retry=self._method_configs["ListFindings"].retry,
+                default_timeout=self._method_configs["ListFindings"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListFindingsRequest(
+            parent=parent, filter=filter_, page_size=page_size
+        )
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        iterator = google.api_core.page_iterator.GRPCIterator(
+            client=None,
+            method=functools.partial(
+                self._inner_api_calls["list_findings"],
+                retry=retry,
+                timeout=timeout,
+                metadata=metadata,
+            ),
+            request=request,
+            items_field="findings",
+            request_token_field="page_token",
+            response_token_field="next_page_token",
+        )
+        return iterator
+
+    def list_finding_type_stats(
+        self,
+        parent,
+        retry=google.api_core.gapic_v1.method.DEFAULT,
+        timeout=google.api_core.gapic_v1.method.DEFAULT,
+        metadata=None,
+    ):
+        """
+        List all FindingTypeStats under a given ScanRun.
+
+        Example:
+            >>> from google.cloud import websecurityscanner_v1beta
+            >>>
+            >>> client = websecurityscanner_v1beta.WebSecurityScannerClient()
+            >>>
+            >>> parent = client.scan_run_path('[PROJECT]', '[SCAN_CONFIG]', '[SCAN_RUN]')
+            >>>
+            >>> response = client.list_finding_type_stats(parent)
+
+        Args:
+            parent (str): Required.
+                The parent resource name, which should be a scan run resource name in the
+                format
+                'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+                to retry requests. If ``None`` is specified, requests will
+                be retried using a default configuration.
+            timeout (Optional[float]): The amount of time, in seconds, to wait
+                for the request to complete. Note that if ``retry`` is
+                specified, the timeout applies to each individual attempt.
+            metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata
+                that is provided to the method.
+
+        Returns:
+            A :class:`~google.cloud.websecurityscanner_v1beta.types.ListFindingTypeStatsResponse` instance.
+
+        Raises:
+            google.api_core.exceptions.GoogleAPICallError: If the request
+                    failed for any reason.
+            google.api_core.exceptions.RetryError: If the request failed due
+                    to a retryable error and retry attempts failed.
+            ValueError: If the parameters are invalid.
+        """
+        # Wrap the transport method to add retry and timeout logic.
+        if "list_finding_type_stats" not in self._inner_api_calls:
+            self._inner_api_calls[
+                "list_finding_type_stats"
+            ] = google.api_core.gapic_v1.method.wrap_method(
+                self.transport.list_finding_type_stats,
+                default_retry=self._method_configs["ListFindingTypeStats"].retry,
+                default_timeout=self._method_configs["ListFindingTypeStats"].timeout,
+                client_info=self._client_info,
+            )
+
+        request = web_security_scanner_pb2.ListFindingTypeStatsRequest(parent=parent)
+        if metadata is None:
+            metadata = []
+        metadata = list(metadata)
+        try:
+            routing_header = [("parent", parent)]
+        except AttributeError:
+            pass
+        else:
+            routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(
+                routing_header
+            )
+            metadata.append(routing_metadata)
+
+        return self._inner_api_calls["list_finding_type_stats"](
+            request, retry=retry, timeout=timeout, metadata=metadata
+        )
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/web_security_scanner_client_config.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/web_security_scanner_client_config.py
new file mode 100644
index 000000000000..d447761e5f4c
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/gapic/web_security_scanner_client_config.py
@@ -0,0 +1,88 @@
+config = {
+    "interfaces": {
+        "google.cloud.websecurityscanner.v1beta.WebSecurityScanner": {
+            "retry_codes": {
+                "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"],
+                "non_idempotent": [],
+            },
+            "retry_params": {
+                "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.0,
+                    "max_rpc_timeout_millis": 20000,
+                    "total_timeout_millis": 600000,
+                }
+            },
+            "methods": {
+                "CreateScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "DeleteScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListScanConfigs": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "UpdateScanConfig": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "StartScanRun": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetScanRun": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListScanRuns": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "StopScanRun": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListCrawledUrls": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "GetFinding": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFindings": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+                "ListFindingTypeStats": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "idempotent",
+                    "retry_params_name": "default",
+                },
+            },
+        }
+    }
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/__init__.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/__init__.py
new file mode 100644
index 000000000000..e69de29bb2d1
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto
new file mode 100644
index 000000000000..92a0dc663856
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto
@@ -0,0 +1,44 @@
+// 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.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";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// 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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url_pb2.py
new file mode 100644
index 000000000000..4fd988ae3ec1
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url_pb2.py
@@ -0,0 +1,141 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\017CrawledUrlProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\n>google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto"<\n\nCrawledUrl\x12\x13\n\x0bhttp_method\x18\x01 \x01(\t\x12\x0b\n\x03url\x18\x02 \x01(\t\x12\x0c\n\x04\x62ody\x18\x03 \x01(\tB\xc2\x01\n*com.google.cloud.websecurityscanner.v1betaB\x0f\x43rawledUrlProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_CRAWLEDURL = _descriptor.Descriptor(
+    name="CrawledUrl",
+    full_name="google.cloud.websecurityscanner.v1beta.CrawledUrl",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.websecurityscanner.v1beta.CrawledUrl.http_method",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="url",
+            full_name="google.cloud.websecurityscanner.v1beta.CrawledUrl.url",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.websecurityscanner.v1beta.CrawledUrl.body",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=136,
+    serialized_end=196,
+)
+
+DESCRIPTOR.message_types_by_name["CrawledUrl"] = _CRAWLEDURL
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CrawledUrl = _reflection.GeneratedProtocolMessageType(
+    "CrawledUrl",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CRAWLEDURL,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.crawled_url_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      http_method:
+          Output only. The http method of the request that was used to
+          visit the URL, in uppercase.
+      url:
+          Output only. The URL that was crawled.
+      body:
+          Output only. The body of the request that was used to visit
+          the URL.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.CrawledUrl)
+    ),
+)
+_sym_db.RegisterMessage(CrawledUrl)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/crawled_url_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding.proto
new file mode 100644
index 000000000000..5e25abb5d061
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding.proto
@@ -0,0 +1,107 @@
+// 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.websecurityscanner.v1beta;
+
+import "google/api/annotations.proto";
+import "google/cloud/websecurityscanner/v1beta/finding_addon.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "FindingProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// A Finding resource represents a vulnerability instance identified during a
+// ScanRun.
+message Finding {
+  // 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-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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto
new file mode 100644
index 000000000000..d2759b831909
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto
@@ -0,0 +1,90 @@
+// 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.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";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// ! 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 {
+  // 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;
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon_pb2.py
new file mode 100644
index 000000000000..c029fbb15ca3
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon_pb2.py
@@ -0,0 +1,588 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\021FindingAddonProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\n@google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto"*\n\x04\x46orm\x12\x12\n\naction_uri\x18\x01 \x01(\t\x12\x0e\n\x06\x66ields\x18\x02 \x03(\t"Q\n\x0fOutdatedLibrary\x12\x14\n\x0clibrary_name\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x17\n\x0flearn_more_urls\x18\x03 \x03(\t"?\n\x11ViolatingResource\x12\x14\n\x0c\x63ontent_type\x18\x01 \x01(\t\x12\x14\n\x0cresource_url\x18\x02 \x01(\t"/\n\x14VulnerableParameters\x12\x17\n\x0fparameter_names\x18\x01 \x03(\t"\xe8\x01\n\x11VulnerableHeaders\x12Q\n\x07headers\x18\x01 \x03(\x0b\x32@.google.cloud.websecurityscanner.v1beta.VulnerableHeaders.Header\x12Y\n\x0fmissing_headers\x18\x02 \x03(\x0b\x32@.google.cloud.websecurityscanner.v1beta.VulnerableHeaders.Header\x1a%\n\x06Header\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t"2\n\x03Xss\x12\x14\n\x0cstack_traces\x18\x01 \x03(\t\x12\x15\n\rerror_message\x18\x02 \x01(\tB\xc4\x01\n*com.google.cloud.websecurityscanner.v1betaB\x11\x46indingAddonProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_FORM = _descriptor.Descriptor(
+    name="Form",
+    full_name="google.cloud.websecurityscanner.v1beta.Form",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="action_uri",
+            full_name="google.cloud.websecurityscanner.v1beta.Form.action_uri",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fields",
+            full_name="google.cloud.websecurityscanner.v1beta.Form.fields",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=138,
+    serialized_end=180,
+)
+
+
+_OUTDATEDLIBRARY = _descriptor.Descriptor(
+    name="OutdatedLibrary",
+    full_name="google.cloud.websecurityscanner.v1beta.OutdatedLibrary",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="library_name",
+            full_name="google.cloud.websecurityscanner.v1beta.OutdatedLibrary.library_name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="version",
+            full_name="google.cloud.websecurityscanner.v1beta.OutdatedLibrary.version",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="learn_more_urls",
+            full_name="google.cloud.websecurityscanner.v1beta.OutdatedLibrary.learn_more_urls",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=182,
+    serialized_end=263,
+)
+
+
+_VIOLATINGRESOURCE = _descriptor.Descriptor(
+    name="ViolatingResource",
+    full_name="google.cloud.websecurityscanner.v1beta.ViolatingResource",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="content_type",
+            full_name="google.cloud.websecurityscanner.v1beta.ViolatingResource.content_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="resource_url",
+            full_name="google.cloud.websecurityscanner.v1beta.ViolatingResource.resource_url",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=265,
+    serialized_end=328,
+)
+
+
+_VULNERABLEPARAMETERS = _descriptor.Descriptor(
+    name="VulnerableParameters",
+    full_name="google.cloud.websecurityscanner.v1beta.VulnerableParameters",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parameter_names",
+            full_name="google.cloud.websecurityscanner.v1beta.VulnerableParameters.parameter_names",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=330,
+    serialized_end=377,
+)
+
+
+_VULNERABLEHEADERS_HEADER = _descriptor.Descriptor(
+    name="Header",
+    full_name="google.cloud.websecurityscanner.v1beta.VulnerableHeaders.Header",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.VulnerableHeaders.Header.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="value",
+            full_name="google.cloud.websecurityscanner.v1beta.VulnerableHeaders.Header.value",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=575,
+    serialized_end=612,
+)
+
+_VULNERABLEHEADERS = _descriptor.Descriptor(
+    name="VulnerableHeaders",
+    full_name="google.cloud.websecurityscanner.v1beta.VulnerableHeaders",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="headers",
+            full_name="google.cloud.websecurityscanner.v1beta.VulnerableHeaders.headers",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="missing_headers",
+            full_name="google.cloud.websecurityscanner.v1beta.VulnerableHeaders.missing_headers",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_VULNERABLEHEADERS_HEADER],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=380,
+    serialized_end=612,
+)
+
+
+_XSS = _descriptor.Descriptor(
+    name="Xss",
+    full_name="google.cloud.websecurityscanner.v1beta.Xss",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="stack_traces",
+            full_name="google.cloud.websecurityscanner.v1beta.Xss.stack_traces",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error_message",
+            full_name="google.cloud.websecurityscanner.v1beta.Xss.error_message",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=614,
+    serialized_end=664,
+)
+
+_VULNERABLEHEADERS_HEADER.containing_type = _VULNERABLEHEADERS
+_VULNERABLEHEADERS.fields_by_name["headers"].message_type = _VULNERABLEHEADERS_HEADER
+_VULNERABLEHEADERS.fields_by_name[
+    "missing_headers"
+].message_type = _VULNERABLEHEADERS_HEADER
+DESCRIPTOR.message_types_by_name["Form"] = _FORM
+DESCRIPTOR.message_types_by_name["OutdatedLibrary"] = _OUTDATEDLIBRARY
+DESCRIPTOR.message_types_by_name["ViolatingResource"] = _VIOLATINGRESOURCE
+DESCRIPTOR.message_types_by_name["VulnerableParameters"] = _VULNERABLEPARAMETERS
+DESCRIPTOR.message_types_by_name["VulnerableHeaders"] = _VULNERABLEHEADERS
+DESCRIPTOR.message_types_by_name["Xss"] = _XSS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Form = _reflection.GeneratedProtocolMessageType(
+    "Form",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FORM,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+        __doc__="""! Information about a vulnerability with an HTML.
+  
+  
+  Attributes:
+      action_uri:
+          ! The URI where to send the form when it's submitted.
+      fields:
+          ! The names of form fields related to the vulnerability.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.Form)
+    ),
+)
+_sym_db.RegisterMessage(Form)
+
+OutdatedLibrary = _reflection.GeneratedProtocolMessageType(
+    "OutdatedLibrary",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_OUTDATEDLIBRARY,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+        __doc__="""Information reported for an outdated library.
+  
+  
+  Attributes:
+      library_name:
+          The name of the outdated library.
+      version:
+          The version number.
+      learn_more_urls:
+          URLs to learn more information about the vulnerabilities in
+          the library.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.OutdatedLibrary)
+    ),
+)
+_sym_db.RegisterMessage(OutdatedLibrary)
+
+ViolatingResource = _reflection.GeneratedProtocolMessageType(
+    "ViolatingResource",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VIOLATINGRESOURCE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+        __doc__="""Information regarding any resource causing the vulnerability such as
+  JavaScript sources, image, audio files, etc.
+  
+  
+  Attributes:
+      content_type:
+          The MIME type of this resource.
+      resource_url:
+          URL of this violating resource.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ViolatingResource)
+    ),
+)
+_sym_db.RegisterMessage(ViolatingResource)
+
+VulnerableParameters = _reflection.GeneratedProtocolMessageType(
+    "VulnerableParameters",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_VULNERABLEPARAMETERS,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+        __doc__="""Information about vulnerable request parameters.
+  
+  
+  Attributes:
+      parameter_names:
+          The vulnerable parameter names.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.VulnerableParameters)
+    ),
+)
+_sym_db.RegisterMessage(VulnerableParameters)
+
+VulnerableHeaders = _reflection.GeneratedProtocolMessageType(
+    "VulnerableHeaders",
+    (_message.Message,),
+    dict(
+        Header=_reflection.GeneratedProtocolMessageType(
+            "Header",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_VULNERABLEHEADERS_HEADER,
+                __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+                __doc__="""Describes a HTTP Header.
+    
+    
+    Attributes:
+        name:
+            Header name.
+        value:
+            Header value.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.VulnerableHeaders.Header)
+            ),
+        ),
+        DESCRIPTOR=_VULNERABLEHEADERS,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+        __doc__="""Information about vulnerable or missing HTTP Headers.
+  
+  
+  Attributes:
+      headers:
+          List of vulnerable headers.
+      missing_headers:
+          List of missing headers.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.VulnerableHeaders)
+    ),
+)
+_sym_db.RegisterMessage(VulnerableHeaders)
+_sym_db.RegisterMessage(VulnerableHeaders.Header)
+
+Xss = _reflection.GeneratedProtocolMessageType(
+    "Xss",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_XSS,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_addon_pb2",
+        __doc__="""Information reported for an XSS.
+  
+  
+  Attributes:
+      stack_traces:
+          Stack traces leading to the point where the XSS occurred.
+      error_message:
+          An error message generated by a javascript breakage.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.Xss)
+    ),
+)
+_sym_db.RegisterMessage(Xss)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_addon_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_pb2.py
new file mode 100644
index 000000000000..385aac2919bb
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_pb2.py
@@ -0,0 +1,453 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/finding.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1beta.proto import (
+    finding_addon_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/finding.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\014FindingProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\n:google/cloud/websecurityscanner_v1beta/proto/finding.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a@google/cloud/websecurityscanner_v1beta/proto/finding_addon.proto"\xa2\x05\n\x07\x46inding\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x66inding_type\x18\x02 \x01(\t\x12\x13\n\x0bhttp_method\x18\x03 \x01(\t\x12\x12\n\nfuzzed_url\x18\x04 \x01(\t\x12\x0c\n\x04\x62ody\x18\x05 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x06 \x01(\t\x12\x18\n\x10reproduction_url\x18\x07 \x01(\t\x12\x11\n\tframe_url\x18\x08 \x01(\t\x12\x11\n\tfinal_url\x18\t \x01(\t\x12\x13\n\x0btracking_id\x18\n \x01(\t\x12:\n\x04\x66orm\x18\x10 \x01(\x0b\x32,.google.cloud.websecurityscanner.v1beta.Form\x12Q\n\x10outdated_library\x18\x0b \x01(\x0b\x32\x37.google.cloud.websecurityscanner.v1beta.OutdatedLibrary\x12U\n\x12violating_resource\x18\x0c \x01(\x0b\x32\x39.google.cloud.websecurityscanner.v1beta.ViolatingResource\x12U\n\x12vulnerable_headers\x18\x0f \x01(\x0b\x32\x39.google.cloud.websecurityscanner.v1beta.VulnerableHeaders\x12[\n\x15vulnerable_parameters\x18\r \x01(\x0b\x32<.google.cloud.websecurityscanner.v1beta.VulnerableParameters\x12\x38\n\x03xss\x18\x0e \x01(\x0b\x32+.google.cloud.websecurityscanner.v1beta.XssB\xbf\x01\n*com.google.cloud.websecurityscanner.v1betaB\x0c\x46indingProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_FINDING = _descriptor.Descriptor(
+    name="Finding",
+    full_name="google.cloud.websecurityscanner.v1beta.Finding",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding_type",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.finding_type",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="http_method",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.http_method",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="fuzzed_url",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.fuzzed_url",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="body",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.body",
+            index=4,
+            number=5,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="description",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.description",
+            index=5,
+            number=6,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="reproduction_url",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.reproduction_url",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="frame_url",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.frame_url",
+            index=7,
+            number=8,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="final_url",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.final_url",
+            index=8,
+            number=9,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="tracking_id",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.tracking_id",
+            index=9,
+            number=10,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="form",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.form",
+            index=10,
+            number=16,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="outdated_library",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.outdated_library",
+            index=11,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="violating_resource",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.violating_resource",
+            index=12,
+            number=12,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="vulnerable_headers",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.vulnerable_headers",
+            index=13,
+            number=15,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="vulnerable_parameters",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.vulnerable_parameters",
+            index=14,
+            number=13,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="xss",
+            full_name="google.cloud.websecurityscanner.v1beta.Finding.xss",
+            index=15,
+            number=14,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=199,
+    serialized_end=873,
+)
+
+_FINDING.fields_by_name[
+    "form"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2._FORM
+)
+_FINDING.fields_by_name[
+    "outdated_library"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2._OUTDATEDLIBRARY
+)
+_FINDING.fields_by_name[
+    "violating_resource"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2._VIOLATINGRESOURCE
+)
+_FINDING.fields_by_name[
+    "vulnerable_headers"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2._VULNERABLEHEADERS
+)
+_FINDING.fields_by_name[
+    "vulnerable_parameters"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2._VULNERABLEPARAMETERS
+)
+_FINDING.fields_by_name[
+    "xss"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__addon__pb2._XSS
+)
+DESCRIPTOR.message_types_by_name["Finding"] = _FINDING
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Finding = _reflection.GeneratedProtocolMessageType(
+    "Finding",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINDING,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_pb2",
+        __doc__="""A Finding resource represents a vulnerability instance identified during
+  a ScanRun.
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name of the Finding. The name
+          follows the format of 'projects/{projectId}/scanConfigs/{scanC
+          onfigId}/scanruns/{scanRunId}/findings/{findingId}'. The
+          finding IDs are generated by the system.
+      finding_type:
+          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
+      http_method:
+          Output only. The http method of the request that triggered the
+          vulnerability, in uppercase.
+      fuzzed_url:
+          Output only. The URL produced by the server-side fuzzer and
+          used in the request that triggered the vulnerability.
+      body:
+          Output only. The body of the request that triggered the
+          vulnerability.
+      description:
+          Output only. The description of the vulnerability.
+      reproduction_url:
+          Output only. The URL containing human-readable payload that
+          user can leverage to reproduce the vulnerability.
+      frame_url:
+          Output only. If the vulnerability was originated from nested
+          IFrame, the immediate parent IFrame is reported.
+      final_url:
+          Output only. The URL where the browser lands when the
+          vulnerability is detected.
+      tracking_id:
+          Output only. The tracking ID uniquely identifies a
+          vulnerability instance across multiple ScanRuns.
+      form:
+          Output only. An addon containing information reported for a
+          vulnerability with an HTML form, if any.
+      outdated_library:
+          Output only. An addon containing information about outdated
+          libraries.
+      violating_resource:
+          Output only. An addon containing detailed information
+          regarding any resource causing the vulnerability such as
+          JavaScript sources, image, audio files, etc.
+      vulnerable_headers:
+          Output only. An addon containing information about vulnerable
+          or missing HTTP headers.
+      vulnerable_parameters:
+          Output only. An addon containing information about request
+          parameters which were found to be vulnerable.
+      xss:
+          Output only. An addon containing information reported for an
+          XSS, if any.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.Finding)
+    ),
+)
+_sym_db.RegisterMessage(Finding)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto
new file mode 100644
index 000000000000..cbace23d3433
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto
@@ -0,0 +1,38 @@
+// 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.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";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats_pb2.py
new file mode 100644
index 000000000000..3fa52a7f3321
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats_pb2.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\025FindingTypeStatsProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\nEgoogle/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto"?\n\x10\x46indingTypeStats\x12\x14\n\x0c\x66inding_type\x18\x01 \x01(\t\x12\x15\n\rfinding_count\x18\x02 \x01(\x05\x42\xc8\x01\n*com.google.cloud.websecurityscanner.v1betaB\x15\x46indingTypeStatsProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR],
+)
+
+
+_FINDINGTYPESTATS = _descriptor.Descriptor(
+    name="FindingTypeStats",
+    full_name="google.cloud.websecurityscanner.v1beta.FindingTypeStats",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding_type",
+            full_name="google.cloud.websecurityscanner.v1beta.FindingTypeStats.finding_type",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="finding_count",
+            full_name="google.cloud.websecurityscanner.v1beta.FindingTypeStats.finding_count",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=143,
+    serialized_end=206,
+)
+
+DESCRIPTOR.message_types_by_name["FindingTypeStats"] = _FINDINGTYPESTATS
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+FindingTypeStats = _reflection.GeneratedProtocolMessageType(
+    "FindingTypeStats",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_FINDINGTYPESTATS,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.finding_type_stats_pb2",
+        __doc__="""A FindingTypeStats resource represents stats regarding a specific
+  FindingType of Findings under a given ScanRun.
+  
+  
+  Attributes:
+      finding_type:
+          Output only. The finding type associated with the stats.
+      finding_count:
+          Output only. The count of findings belonging to this finding
+          type.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.FindingTypeStats)
+    ),
+)
+_sym_db.RegisterMessage(FindingTypeStats)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/finding_type_stats_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config.proto
new file mode 100644
index 000000000000..d698bb4f886e
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config.proto
@@ -0,0 +1,189 @@
+// 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.websecurityscanner.v1beta;
+
+import "google/api/annotations.proto";
+import "google/cloud/websecurityscanner/v1beta/scan_run.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanConfigProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// 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;
+
+      // Input only.
+      // Required.
+      // 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;
+
+      // Input only.
+      // Required.
+      // 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;
+    }
+
+    // Required.
+    // Authentication configuration
+    oneof authentication {
+      // Authentication using a Google account.
+      GoogleAccount google_account = 1;
+
+      // Authentication using a custom account.
+      CustomAccount custom_account = 2;
+    }
+  }
+
+  // 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;
+  }
+
+  // Cloud platforms supported by Cloud Web Security Scanner.
+  enum TargetPlatform {
+    // The target platform is unknown. Requests with this enum value will be
+    // rejected with INVALID_ARGUMENT error.
+    TARGET_PLATFORM_UNSPECIFIED = 0;
+
+    // Google App Engine service.
+    APP_ENGINE = 1;
+
+    // Google Compute Engine service.
+    COMPUTE = 2;
+  }
+
+  // Scan risk levels supported by Cloud 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 Cloud Security
+  // Command Center.
+  enum ExportToSecurityCommandCenter {
+    // Use default, which is ENABLED.
+    EXPORT_TO_SECURITY_COMMAND_CENTER_UNSPECIFIED = 0;
+
+    // Export results of this scan to Cloud Security Command Center.
+    ENABLED = 1;
+
+    // Do not export results of this scan to Cloud 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 blacklist URL patterns as described in
+  // https://cloud.google.com/security-scanner/docs/excluded-urls
+  repeated string blacklist_patterns = 7;
+
+  // The schedule of the ScanConfig.
+  Schedule schedule = 8;
+
+  // Set of Cloud Platforms targeted by the scan. If empty, APP_ENGINE will be
+  // used as a default.
+  repeated TargetPlatform target_platforms = 9;
+
+  // Controls export of scan configurations and results to Cloud Security
+  // Command Center.
+  ExportToSecurityCommandCenter export_to_security_command_center = 10;
+
+  // Latest ScanRun if available.
+  ScanRun latest_run = 11;
+
+  // The risk level selected for the scan
+  RiskLevel risk_level = 12;
+}
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto
new file mode 100644
index 000000000000..c55c744c6272
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto
@@ -0,0 +1,187 @@
+// 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.websecurityscanner.v1beta;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanConfigErrorProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// 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: 43
+  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;
+
+    // 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 Cloud 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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error_pb2.py
new file mode 100644
index 000000000000..03dfa6cae009
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error_pb2.py
@@ -0,0 +1,416 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\024ScanConfigErrorProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\nDgoogle/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto\x12&google.cloud.websecurityscanner.v1beta"\xc7\x0b\n\x0fScanConfigError\x12J\n\x04\x63ode\x18\x01 \x01(\x0e\x32<.google.cloud.websecurityscanner.v1beta.ScanConfigError.Code\x12\x12\n\nfield_name\x18\x02 \x01(\t"\xd3\n\n\x04\x43ode\x12\x14\n\x10\x43ODE_UNSPECIFIED\x10\x00\x12\x06\n\x02OK\x10\x00\x12\x12\n\x0eINTERNAL_ERROR\x10\x01\x12\x1f\n\x1b\x41PPENGINE_API_BACKEND_ERROR\x10\x02\x12 \n\x1c\x41PPENGINE_API_NOT_ACCESSIBLE\x10\x03\x12"\n\x1e\x41PPENGINE_DEFAULT_HOST_MISSING\x10\x04\x12!\n\x1d\x43\x41NNOT_USE_GOOGLE_COM_ACCOUNT\x10\x06\x12\x1c\n\x18\x43\x41NNOT_USE_OWNER_ACCOUNT\x10\x07\x12\x1d\n\x19\x43OMPUTE_API_BACKEND_ERROR\x10\x08\x12\x1e\n\x1a\x43OMPUTE_API_NOT_ACCESSIBLE\x10\t\x12\x37\n3CUSTOM_LOGIN_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT\x10\n\x12\x1e\n\x1a\x43USTOM_LOGIN_URL_MALFORMED\x10\x0b\x12\x33\n/CUSTOM_LOGIN_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS\x10\x0c\x12\x31\n-CUSTOM_LOGIN_URL_MAPPED_TO_UNRESERVED_ADDRESS\x10\r\x12\x30\n,CUSTOM_LOGIN_URL_HAS_NON_ROUTABLE_IP_ADDRESS\x10\x0e\x12.\n*CUSTOM_LOGIN_URL_HAS_UNRESERVED_IP_ADDRESS\x10\x0f\x12\x17\n\x13\x44UPLICATE_SCAN_NAME\x10\x10\x12\x17\n\x13INVALID_FIELD_VALUE\x10\x12\x12$\n FAILED_TO_AUTHENTICATE_TO_TARGET\x10\x13\x12\x1c\n\x18\x46INDING_TYPE_UNSPECIFIED\x10\x14\x12\x1d\n\x19\x46ORBIDDEN_TO_SCAN_COMPUTE\x10\x15\x12\x14\n\x10MALFORMED_FILTER\x10\x16\x12\x1b\n\x17MALFORMED_RESOURCE_NAME\x10\x17\x12\x14\n\x10PROJECT_INACTIVE\x10\x18\x12\x12\n\x0eREQUIRED_FIELD\x10\x19\x12\x1e\n\x1aRESOURCE_NAME_INCONSISTENT\x10\x1a\x12\x18\n\x14SCAN_ALREADY_RUNNING\x10\x1b\x12\x14\n\x10SCAN_NOT_RUNNING\x10\x1c\x12/\n+SEED_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT\x10\x1d\x12\x16\n\x12SEED_URL_MALFORMED\x10\x1e\x12+\n\'SEED_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS\x10\x1f\x12)\n%SEED_URL_MAPPED_TO_UNRESERVED_ADDRESS\x10 \x12(\n$SEED_URL_HAS_NON_ROUTABLE_IP_ADDRESS\x10!\x12&\n"SEED_URL_HAS_UNRESERVED_IP_ADDRESS\x10#\x12"\n\x1eSERVICE_ACCOUNT_NOT_CONFIGURED\x10$\x12\x12\n\x0eTOO_MANY_SCANS\x10%\x12"\n\x1eUNABLE_TO_RESOLVE_PROJECT_INFO\x10&\x12(\n$UNSUPPORTED_BLACKLIST_PATTERN_FORMAT\x10\'\x12\x16\n\x12UNSUPPORTED_FILTER\x10(\x12\x1c\n\x18UNSUPPORTED_FINDING_TYPE\x10)\x12\x1a\n\x16UNSUPPORTED_URL_SCHEME\x10*\x1a\x02\x10\x01\x42\xc7\x01\n*com.google.cloud.websecurityscanner.v1betaB\x14ScanConfigErrorProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+)
+
+
+_SCANCONFIGERROR_CODE = _descriptor.EnumDescriptor(
+    name="Code",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfigError.Code",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="OK", index=1, number=0, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERNAL_ERROR", index=2, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPENGINE_API_BACKEND_ERROR",
+            index=3,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPENGINE_API_NOT_ACCESSIBLE",
+            index=4,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APPENGINE_DEFAULT_HOST_MISSING",
+            index=5,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANNOT_USE_GOOGLE_COM_ACCOUNT",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CANNOT_USE_OWNER_ACCOUNT",
+            index=7,
+            number=7,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPUTE_API_BACKEND_ERROR",
+            index=8,
+            number=8,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPUTE_API_NOT_ACCESSIBLE",
+            index=9,
+            number=9,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_LOGIN_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT",
+            index=10,
+            number=10,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_LOGIN_URL_MALFORMED",
+            index=11,
+            number=11,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_LOGIN_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS",
+            index=12,
+            number=12,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_LOGIN_URL_MAPPED_TO_UNRESERVED_ADDRESS",
+            index=13,
+            number=13,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_LOGIN_URL_HAS_NON_ROUTABLE_IP_ADDRESS",
+            index=14,
+            number=14,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CUSTOM_LOGIN_URL_HAS_UNRESERVED_IP_ADDRESS",
+            index=15,
+            number=15,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DUPLICATE_SCAN_NAME",
+            index=16,
+            number=16,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INVALID_FIELD_VALUE",
+            index=17,
+            number=18,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FAILED_TO_AUTHENTICATE_TO_TARGET",
+            index=18,
+            number=19,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINDING_TYPE_UNSPECIFIED",
+            index=19,
+            number=20,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FORBIDDEN_TO_SCAN_COMPUTE",
+            index=20,
+            number=21,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MALFORMED_FILTER",
+            index=21,
+            number=22,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="MALFORMED_RESOURCE_NAME",
+            index=22,
+            number=23,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="PROJECT_INACTIVE",
+            index=23,
+            number=24,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="REQUIRED_FIELD",
+            index=24,
+            number=25,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="RESOURCE_NAME_INCONSISTENT",
+            index=25,
+            number=26,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCAN_ALREADY_RUNNING",
+            index=26,
+            number=27,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCAN_NOT_RUNNING",
+            index=27,
+            number=28,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEED_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT",
+            index=28,
+            number=29,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEED_URL_MALFORMED",
+            index=29,
+            number=30,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEED_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS",
+            index=30,
+            number=31,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEED_URL_MAPPED_TO_UNRESERVED_ADDRESS",
+            index=31,
+            number=32,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEED_URL_HAS_NON_ROUTABLE_IP_ADDRESS",
+            index=32,
+            number=33,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SEED_URL_HAS_UNRESERVED_IP_ADDRESS",
+            index=33,
+            number=35,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SERVICE_ACCOUNT_NOT_CONFIGURED",
+            index=34,
+            number=36,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOO_MANY_SCANS",
+            index=35,
+            number=37,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNABLE_TO_RESOLVE_PROJECT_INFO",
+            index=36,
+            number=38,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNSUPPORTED_BLACKLIST_PATTERN_FORMAT",
+            index=37,
+            number=39,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNSUPPORTED_FILTER",
+            index=38,
+            number=40,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNSUPPORTED_FINDING_TYPE",
+            index=39,
+            number=41,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="UNSUPPORTED_URL_SCHEME",
+            index=40,
+            number=42,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=_b("\020\001"),
+    serialized_start=229,
+    serialized_end=1592,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIGERROR_CODE)
+
+
+_SCANCONFIGERROR = _descriptor.Descriptor(
+    name="ScanConfigError",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfigError",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfigError.code",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="field_name",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfigError.field_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SCANCONFIGERROR_CODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=113,
+    serialized_end=1592,
+)
+
+_SCANCONFIGERROR.fields_by_name["code"].enum_type = _SCANCONFIGERROR_CODE
+_SCANCONFIGERROR_CODE.containing_type = _SCANCONFIGERROR
+DESCRIPTOR.message_types_by_name["ScanConfigError"] = _SCANCONFIGERROR
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanConfigError = _reflection.GeneratedProtocolMessageType(
+    "ScanConfigError",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCANCONFIGERROR,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_config_error_pb2",
+        __doc__="""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.
+  
+  
+  Attributes:
+      code:
+          Output only. Indicates the reason code for a configuration
+          failure.
+      field_name:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanConfigError)
+    ),
+)
+_sym_db.RegisterMessage(ScanConfigError)
+
+
+DESCRIPTOR._options = None
+_SCANCONFIGERROR_CODE._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_error_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_pb2.py
new file mode 100644
index 000000000000..79752f0de426
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_pb2.py
@@ -0,0 +1,833 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/scan_config.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_run_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/scan_config.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\017ScanConfigProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\n>google/cloud/websecurityscanner_v1beta/proto/scan_config.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a;google/cloud/websecurityscanner_v1beta/proto/scan_run.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x97\x0c\n\nScanConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12\x0f\n\x07max_qps\x18\x03 \x01(\x05\x12\x15\n\rstarting_urls\x18\x04 \x03(\t\x12Y\n\x0e\x61uthentication\x18\x05 \x01(\x0b\x32\x41.google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication\x12P\n\nuser_agent\x18\x06 \x01(\x0e\x32<.google.cloud.websecurityscanner.v1beta.ScanConfig.UserAgent\x12\x1a\n\x12\x62lacklist_patterns\x18\x07 \x03(\t\x12M\n\x08schedule\x18\x08 \x01(\x0b\x32;.google.cloud.websecurityscanner.v1beta.ScanConfig.Schedule\x12[\n\x10target_platforms\x18\t \x03(\x0e\x32\x41.google.cloud.websecurityscanner.v1beta.ScanConfig.TargetPlatform\x12{\n!export_to_security_command_center\x18\n \x01(\x0e\x32P.google.cloud.websecurityscanner.v1beta.ScanConfig.ExportToSecurityCommandCenter\x12\x43\n\nlatest_run\x18\x0b \x01(\x0b\x32/.google.cloud.websecurityscanner.v1beta.ScanRun\x12P\n\nrisk_level\x18\x0c \x01(\x0e\x32<.google.cloud.websecurityscanner.v1beta.ScanConfig.RiskLevel\x1a\xf5\x02\n\x0e\x41uthentication\x12i\n\x0egoogle_account\x18\x01 \x01(\x0b\x32O.google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.GoogleAccountH\x00\x12i\n\x0e\x63ustom_account\x18\x02 \x01(\x0b\x32O.google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.CustomAccountH\x00\x1a\x33\n\rGoogleAccount\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x1a\x46\n\rCustomAccount\x12\x10\n\x08username\x18\x01 \x01(\t\x12\x10\n\x08password\x18\x02 \x01(\t\x12\x11\n\tlogin_url\x18\x03 \x01(\tB\x10\n\x0e\x61uthentication\x1a]\n\x08Schedule\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1e\n\x16interval_duration_days\x18\x02 \x01(\x05"`\n\tUserAgent\x12\x1a\n\x16USER_AGENT_UNSPECIFIED\x10\x00\x12\x10\n\x0c\x43HROME_LINUX\x10\x01\x12\x12\n\x0e\x43HROME_ANDROID\x10\x02\x12\x11\n\rSAFARI_IPHONE\x10\x03"N\n\x0eTargetPlatform\x12\x1f\n\x1bTARGET_PLATFORM_UNSPECIFIED\x10\x00\x12\x0e\n\nAPP_ENGINE\x10\x01\x12\x0b\n\x07\x43OMPUTE\x10\x02"<\n\tRiskLevel\x12\x1a\n\x16RISK_LEVEL_UNSPECIFIED\x10\x00\x12\n\n\x06NORMAL\x10\x01\x12\x07\n\x03LOW\x10\x02"m\n\x1d\x45xportToSecurityCommandCenter\x12\x31\n-EXPORT_TO_SECURITY_COMMAND_CENTER_UNSPECIFIED\x10\x00\x12\x0b\n\x07\x45NABLED\x10\x01\x12\x0c\n\x08\x44ISABLED\x10\x02\x42\xc2\x01\n*com.google.cloud.websecurityscanner.v1betaB\x0fScanConfigProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_SCANCONFIG_USERAGENT = _descriptor.EnumDescriptor(
+    name="UserAgent",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.UserAgent",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="USER_AGENT_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHROME_LINUX", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="CHROME_ANDROID", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SAFARI_IPHONE", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1441,
+    serialized_end=1537,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIG_USERAGENT)
+
+_SCANCONFIG_TARGETPLATFORM = _descriptor.EnumDescriptor(
+    name="TargetPlatform",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.TargetPlatform",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="TARGET_PLATFORM_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="APP_ENGINE", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="COMPUTE", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1539,
+    serialized_end=1617,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIG_TARGETPLATFORM)
+
+_SCANCONFIG_RISKLEVEL = _descriptor.EnumDescriptor(
+    name="RiskLevel",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.RiskLevel",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RISK_LEVEL_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="NORMAL", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="LOW", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1619,
+    serialized_end=1679,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIG_RISKLEVEL)
+
+_SCANCONFIG_EXPORTTOSECURITYCOMMANDCENTER = _descriptor.EnumDescriptor(
+    name="ExportToSecurityCommandCenter",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.ExportToSecurityCommandCenter",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EXPORT_TO_SECURITY_COMMAND_CENTER_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ENABLED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="DISABLED", index=2, number=2, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=1681,
+    serialized_end=1790,
+)
+_sym_db.RegisterEnumDescriptor(_SCANCONFIG_EXPORTTOSECURITYCOMMANDCENTER)
+
+
+_SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT = _descriptor.Descriptor(
+    name="GoogleAccount",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.GoogleAccount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.GoogleAccount.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.GoogleAccount.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1203,
+    serialized_end=1254,
+)
+
+_SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT = _descriptor.Descriptor(
+    name="CustomAccount",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.CustomAccount",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="username",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.CustomAccount.username",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="password",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.CustomAccount.password",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="login_url",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.CustomAccount.login_url",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1256,
+    serialized_end=1326,
+)
+
+_SCANCONFIG_AUTHENTICATION = _descriptor.Descriptor(
+    name="Authentication",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="google_account",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.google_account",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="custom_account",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.custom_account",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[
+        _SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT,
+        _SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT,
+    ],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[
+        _descriptor.OneofDescriptor(
+            name="authentication",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.authentication",
+            index=0,
+            containing_type=None,
+            fields=[],
+        )
+    ],
+    serialized_start=971,
+    serialized_end=1344,
+)
+
+_SCANCONFIG_SCHEDULE = _descriptor.Descriptor(
+    name="Schedule",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Schedule",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="schedule_time",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Schedule.schedule_time",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="interval_duration_days",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.Schedule.interval_duration_days",
+            index=1,
+            number=2,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1346,
+    serialized_end=1439,
+)
+
+_SCANCONFIG = _descriptor.Descriptor(
+    name="ScanConfig",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanConfig",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="display_name",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.display_name",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="max_qps",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.max_qps",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="starting_urls",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.starting_urls",
+            index=3,
+            number=4,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="authentication",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.authentication",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="user_agent",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.user_agent",
+            index=5,
+            number=6,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="blacklist_patterns",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.blacklist_patterns",
+            index=6,
+            number=7,
+            type=9,
+            cpp_type=9,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="schedule",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.schedule",
+            index=7,
+            number=8,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="target_platforms",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.target_platforms",
+            index=8,
+            number=9,
+            type=14,
+            cpp_type=8,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="export_to_security_command_center",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.export_to_security_command_center",
+            index=9,
+            number=10,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="latest_run",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.latest_run",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="risk_level",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanConfig.risk_level",
+            index=11,
+            number=12,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[_SCANCONFIG_AUTHENTICATION, _SCANCONFIG_SCHEDULE],
+    enum_types=[
+        _SCANCONFIG_USERAGENT,
+        _SCANCONFIG_TARGETPLATFORM,
+        _SCANCONFIG_RISKLEVEL,
+        _SCANCONFIG_EXPORTTOSECURITYCOMMANDCENTER,
+    ],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=231,
+    serialized_end=1790,
+)
+
+_SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT.containing_type = _SCANCONFIG_AUTHENTICATION
+_SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT.containing_type = _SCANCONFIG_AUTHENTICATION
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "google_account"
+].message_type = _SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "custom_account"
+].message_type = _SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT
+_SCANCONFIG_AUTHENTICATION.containing_type = _SCANCONFIG
+_SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"].fields.append(
+    _SCANCONFIG_AUTHENTICATION.fields_by_name["google_account"]
+)
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "google_account"
+].containing_oneof = _SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"]
+_SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"].fields.append(
+    _SCANCONFIG_AUTHENTICATION.fields_by_name["custom_account"]
+)
+_SCANCONFIG_AUTHENTICATION.fields_by_name[
+    "custom_account"
+].containing_oneof = _SCANCONFIG_AUTHENTICATION.oneofs_by_name["authentication"]
+_SCANCONFIG_SCHEDULE.fields_by_name[
+    "schedule_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCANCONFIG_SCHEDULE.containing_type = _SCANCONFIG
+_SCANCONFIG.fields_by_name["authentication"].message_type = _SCANCONFIG_AUTHENTICATION
+_SCANCONFIG.fields_by_name["user_agent"].enum_type = _SCANCONFIG_USERAGENT
+_SCANCONFIG.fields_by_name["schedule"].message_type = _SCANCONFIG_SCHEDULE
+_SCANCONFIG.fields_by_name["target_platforms"].enum_type = _SCANCONFIG_TARGETPLATFORM
+_SCANCONFIG.fields_by_name[
+    "export_to_security_command_center"
+].enum_type = _SCANCONFIG_EXPORTTOSECURITYCOMMANDCENTER
+_SCANCONFIG.fields_by_name[
+    "latest_run"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2._SCANRUN
+)
+_SCANCONFIG.fields_by_name["risk_level"].enum_type = _SCANCONFIG_RISKLEVEL
+_SCANCONFIG_USERAGENT.containing_type = _SCANCONFIG
+_SCANCONFIG_TARGETPLATFORM.containing_type = _SCANCONFIG
+_SCANCONFIG_RISKLEVEL.containing_type = _SCANCONFIG
+_SCANCONFIG_EXPORTTOSECURITYCOMMANDCENTER.containing_type = _SCANCONFIG
+DESCRIPTOR.message_types_by_name["ScanConfig"] = _SCANCONFIG
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanConfig = _reflection.GeneratedProtocolMessageType(
+    "ScanConfig",
+    (_message.Message,),
+    dict(
+        Authentication=_reflection.GeneratedProtocolMessageType(
+            "Authentication",
+            (_message.Message,),
+            dict(
+                GoogleAccount=_reflection.GeneratedProtocolMessageType(
+                    "GoogleAccount",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SCANCONFIG_AUTHENTICATION_GOOGLEACCOUNT,
+                        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_config_pb2",
+                        __doc__="""Describes authentication configuration that uses a Google account.
+      
+      
+      Attributes:
+          username:
+              Required. The user name of the Google account.
+          password:
+              Input only. Required. The password of the Google account. The
+              credential is stored encrypted and not returned in any
+              response nor included in audit logs.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.GoogleAccount)
+                    ),
+                ),
+                CustomAccount=_reflection.GeneratedProtocolMessageType(
+                    "CustomAccount",
+                    (_message.Message,),
+                    dict(
+                        DESCRIPTOR=_SCANCONFIG_AUTHENTICATION_CUSTOMACCOUNT,
+                        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_config_pb2",
+                        __doc__="""Describes authentication configuration that uses a custom account.
+      
+      
+      Attributes:
+          username:
+              Required. The user name of the custom account.
+          password:
+              Input only. Required. The password of the custom account. The
+              credential is stored encrypted and not returned in any
+              response nor included in audit logs.
+          login_url:
+              Required. The login form URL of the website.
+      """,
+                        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication.CustomAccount)
+                    ),
+                ),
+                DESCRIPTOR=_SCANCONFIG_AUTHENTICATION,
+                __module__="google.cloud.websecurityscanner_v1beta.proto.scan_config_pb2",
+                __doc__="""Scan authentication configuration.
+    
+    
+    Attributes:
+        authentication:
+            Required. Authentication configuration
+        google_account:
+            Authentication using a Google account.
+        custom_account:
+            Authentication using a custom account.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanConfig.Authentication)
+            ),
+        ),
+        Schedule=_reflection.GeneratedProtocolMessageType(
+            "Schedule",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_SCANCONFIG_SCHEDULE,
+                __module__="google.cloud.websecurityscanner_v1beta.proto.scan_config_pb2",
+                __doc__="""Scan schedule configuration.
+    
+    
+    Attributes:
+        schedule_time:
+            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.
+        interval_duration_days:
+            Required. The duration of time between executions in days.
+    """,
+                # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanConfig.Schedule)
+            ),
+        ),
+        DESCRIPTOR=_SCANCONFIG,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_config_pb2",
+        __doc__="""A ScanConfig resource contains the configurations to launch a scan.
+  
+  
+  Attributes:
+      name:
+          The resource name of the ScanConfig. The name follows the
+          format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+          The ScanConfig IDs are generated by the system.
+      display_name:
+          Required. The user provided display name of the ScanConfig.
+      max_qps:
+          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.
+      starting_urls:
+          Required. The starting URLs from which the scanner finds site
+          pages.
+      authentication:
+          The authentication configuration. If specified, service will
+          use the authentication configuration during scanning.
+      user_agent:
+          The user agent used during scanning.
+      blacklist_patterns:
+          The blacklist URL patterns as described in
+          https://cloud.google.com/security-scanner/docs/excluded-urls
+      schedule:
+          The schedule of the ScanConfig.
+      target_platforms:
+          Set of Cloud Platforms targeted by the scan. If empty,
+          APP\_ENGINE will be used as a default.
+      export_to_security_command_center:
+          Controls export of scan configurations and results to Cloud
+          Security Command Center.
+      latest_run:
+          Latest ScanRun if available.
+      risk_level:
+          The risk level selected for the scan
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanConfig)
+    ),
+)
+_sym_db.RegisterMessage(ScanConfig)
+_sym_db.RegisterMessage(ScanConfig.Authentication)
+_sym_db.RegisterMessage(ScanConfig.Authentication.GoogleAccount)
+_sym_db.RegisterMessage(ScanConfig.Authentication.CustomAccount)
+_sym_db.RegisterMessage(ScanConfig.Schedule)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_config_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run.proto
new file mode 100644
index 000000000000..497edc39bd1b
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run.proto
@@ -0,0 +1,121 @@
+// 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.websecurityscanner.v1beta;
+
+import "google/api/annotations.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";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+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 {
+  // 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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto
new file mode 100644
index 000000000000..3d1a391dc6da
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto
@@ -0,0 +1,77 @@
+// 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.websecurityscanner.v1beta;
+
+import "google/cloud/websecurityscanner/v1beta/scan_config_error.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunErrorTraceProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// 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
+    // 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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace_pb2.py
new file mode 100644
index 000000000000..9d928fa70de8
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace_pb2.py
@@ -0,0 +1,213 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_config_error_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__error__pb2,
+)
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\026ScanRunErrorTraceProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\nGgoogle/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x44google/cloud/websecurityscanner_v1beta/proto/scan_config_error.proto"\x95\x03\n\x11ScanRunErrorTrace\x12L\n\x04\x63ode\x18\x01 \x01(\x0e\x32>.google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace.Code\x12R\n\x11scan_config_error\x18\x02 \x01(\x0b\x32\x37.google.cloud.websecurityscanner.v1beta.ScanConfigError\x12#\n\x1bmost_common_http_error_code\x18\x03 \x01(\x05"\xb8\x01\n\x04\x43ode\x12\x14\n\x10\x43ODE_UNSPECIFIED\x10\x00\x12\x12\n\x0eINTERNAL_ERROR\x10\x01\x12\x15\n\x11SCAN_CONFIG_ISSUE\x10\x02\x12\x1f\n\x1b\x41UTHENTICATION_CONFIG_ISSUE\x10\x03\x12\x1c\n\x18TIMED_OUT_WHILE_SCANNING\x10\x04\x12\x16\n\x12TOO_MANY_REDIRECTS\x10\x05\x12\x18\n\x14TOO_MANY_HTTP_ERRORS\x10\x06\x42\xc9\x01\n*com.google.cloud.websecurityscanner.v1betaB\x16ScanRunErrorTraceProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__error__pb2.DESCRIPTOR
+    ],
+)
+
+
+_SCANRUNERRORTRACE_CODE = _descriptor.EnumDescriptor(
+    name="Code",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace.Code",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INTERNAL_ERROR", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCAN_CONFIG_ISSUE",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="AUTHENTICATION_CONFIG_ISSUE",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TIMED_OUT_WHILE_SCANNING",
+            index=4,
+            number=4,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOO_MANY_REDIRECTS",
+            index=5,
+            number=5,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOO_MANY_HTTP_ERRORS",
+            index=6,
+            number=6,
+            serialized_options=None,
+            type=None,
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=407,
+    serialized_end=591,
+)
+_sym_db.RegisterEnumDescriptor(_SCANRUNERRORTRACE_CODE)
+
+
+_SCANRUNERRORTRACE = _descriptor.Descriptor(
+    name="ScanRunErrorTrace",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace.code",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scan_config_error",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace.scan_config_error",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="most_common_http_error_code",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace.most_common_http_error_code",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SCANRUNERRORTRACE_CODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=186,
+    serialized_end=591,
+)
+
+_SCANRUNERRORTRACE.fields_by_name["code"].enum_type = _SCANRUNERRORTRACE_CODE
+_SCANRUNERRORTRACE.fields_by_name[
+    "scan_config_error"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__error__pb2._SCANCONFIGERROR
+)
+_SCANRUNERRORTRACE_CODE.containing_type = _SCANRUNERRORTRACE
+DESCRIPTOR.message_types_by_name["ScanRunErrorTrace"] = _SCANRUNERRORTRACE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanRunErrorTrace = _reflection.GeneratedProtocolMessageType(
+    "ScanRunErrorTrace",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCANRUNERRORTRACE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_run_error_trace_pb2",
+        __doc__="""Output only. Defines an error trace message for a ScanRun.
+  
+  
+  Attributes:
+      code:
+          Output only. Indicates the error reason code.
+      scan_config_error:
+          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.
+      most_common_http_error_code:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace)
+    ),
+)
+_sym_db.RegisterMessage(ScanRunErrorTrace)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_pb2.py
new file mode 100644
index 000000000000..eb528ae4ff57
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_pb2.py
@@ -0,0 +1,409 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/scan_run.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_run_error_trace_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__error__trace__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_run_warning_trace_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__warning__trace__pb2,
+)
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/scan_run.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\014ScanRunProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\n;google/cloud/websecurityscanner_v1beta/proto/scan_run.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto\x1aGgoogle/cloud/websecurityscanner_v1beta/proto/scan_run_error_trace.proto\x1aIgoogle/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xe0\x05\n\x07ScanRun\x12\x0c\n\x04name\x18\x01 \x01(\t\x12W\n\x0f\x65xecution_state\x18\x02 \x01(\x0e\x32>.google.cloud.websecurityscanner.v1beta.ScanRun.ExecutionState\x12Q\n\x0cresult_state\x18\x03 \x01(\x0e\x32;.google.cloud.websecurityscanner.v1beta.ScanRun.ResultState\x12.\n\nstart_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x1a\n\x12urls_crawled_count\x18\x06 \x01(\x03\x12\x19\n\x11urls_tested_count\x18\x07 \x01(\x03\x12\x1b\n\x13has_vulnerabilities\x18\x08 \x01(\x08\x12\x18\n\x10progress_percent\x18\t \x01(\x05\x12N\n\x0b\x65rror_trace\x18\n \x01(\x0b\x32\x39.google.cloud.websecurityscanner.v1beta.ScanRunErrorTrace\x12S\n\x0ewarning_traces\x18\x0b \x03(\x0b\x32;.google.cloud.websecurityscanner.v1beta.ScanRunWarningTrace"Y\n\x0e\x45xecutionState\x12\x1f\n\x1b\x45XECUTION_STATE_UNSPECIFIED\x10\x00\x12\n\n\x06QUEUED\x10\x01\x12\x0c\n\x08SCANNING\x10\x02\x12\x0c\n\x08\x46INISHED\x10\x03"O\n\x0bResultState\x12\x1c\n\x18RESULT_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07SUCCESS\x10\x01\x12\t\n\x05\x45RROR\x10\x02\x12\n\n\x06KILLED\x10\x03\x42\xbf\x01\n*com.google.cloud.websecurityscanner.v1betaB\x0cScanRunProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__error__trace__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__warning__trace__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_SCANRUN_EXECUTIONSTATE = _descriptor.EnumDescriptor(
+    name="ExecutionState",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRun.ExecutionState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="EXECUTION_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="QUEUED", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SCANNING", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="FINISHED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=881,
+    serialized_end=970,
+)
+_sym_db.RegisterEnumDescriptor(_SCANRUN_EXECUTIONSTATE)
+
+_SCANRUN_RESULTSTATE = _descriptor.EnumDescriptor(
+    name="ResultState",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRun.ResultState",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="RESULT_STATE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="SUCCESS", index=1, number=1, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="ERROR", index=2, number=2, serialized_options=None, type=None
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="KILLED", index=3, number=3, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=972,
+    serialized_end=1051,
+)
+_sym_db.RegisterEnumDescriptor(_SCANRUN_RESULTSTATE)
+
+
+_SCANRUN = _descriptor.Descriptor(
+    name="ScanRun",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRun",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="execution_state",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.execution_state",
+            index=1,
+            number=2,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="result_state",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.result_state",
+            index=2,
+            number=3,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="start_time",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.start_time",
+            index=3,
+            number=4,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="end_time",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.end_time",
+            index=4,
+            number=5,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="urls_crawled_count",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.urls_crawled_count",
+            index=5,
+            number=6,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="urls_tested_count",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.urls_tested_count",
+            index=6,
+            number=7,
+            type=3,
+            cpp_type=2,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="has_vulnerabilities",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.has_vulnerabilities",
+            index=7,
+            number=8,
+            type=8,
+            cpp_type=7,
+            label=1,
+            has_default_value=False,
+            default_value=False,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="progress_percent",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.progress_percent",
+            index=8,
+            number=9,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="error_trace",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.error_trace",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="warning_traces",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRun.warning_traces",
+            index=10,
+            number=11,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SCANRUN_EXECUTIONSTATE, _SCANRUN_RESULTSTATE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=315,
+    serialized_end=1051,
+)
+
+_SCANRUN.fields_by_name["execution_state"].enum_type = _SCANRUN_EXECUTIONSTATE
+_SCANRUN.fields_by_name["result_state"].enum_type = _SCANRUN_RESULTSTATE
+_SCANRUN.fields_by_name[
+    "start_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCANRUN.fields_by_name[
+    "end_time"
+].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_SCANRUN.fields_by_name[
+    "error_trace"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__error__trace__pb2._SCANRUNERRORTRACE
+)
+_SCANRUN.fields_by_name[
+    "warning_traces"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__warning__trace__pb2._SCANRUNWARNINGTRACE
+)
+_SCANRUN_EXECUTIONSTATE.containing_type = _SCANRUN
+_SCANRUN_RESULTSTATE.containing_type = _SCANRUN
+DESCRIPTOR.message_types_by_name["ScanRun"] = _SCANRUN
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanRun = _reflection.GeneratedProtocolMessageType(
+    "ScanRun",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCANRUN,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_run_pb2",
+        __doc__="""A ScanRun is a output-only resource representing an actual run of the
+  scan. Next id: 12
+  
+  
+  Attributes:
+      name:
+          Output only. The resource name of the ScanRun. The name
+          follows the format of 'projects/{projectId}/scanConfigs/{scanC
+          onfigId}/scanRuns/{scanRunId}'. The ScanRun IDs are generated
+          by the system.
+      execution_state:
+          Output only. The execution state of the ScanRun.
+      result_state:
+          Output only. The result state of the ScanRun. This field is
+          only available after the execution state reaches "FINISHED".
+      start_time:
+          Output only. The time at which the ScanRun started.
+      end_time:
+          Output only. The time at which the ScanRun reached termination
+          state - that the ScanRun is either finished or stopped by
+          user.
+      urls_crawled_count:
+          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.
+      urls_tested_count:
+          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.
+      has_vulnerabilities:
+          Output only. Whether the scan run has found any
+          vulnerabilities.
+      progress_percent:
+          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.
+      error_trace:
+          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.
+      warning_traces:
+          Output only. A list of warnings, if such are encountered
+          during this scan run.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanRun)
+    ),
+)
+_sym_db.RegisterMessage(ScanRun)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.proto
new file mode 100644
index 000000000000..e461ad0b55b3
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.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.websecurityscanner.v1beta;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunWarningTraceProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// 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: 5
+  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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace_pb2.py
new file mode 100644
index 000000000000..f03a9418a590
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace_pb2.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\030ScanRunWarningTraceProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\nIgoogle/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace.proto\x12&google.cloud.websecurityscanner.v1beta"\xed\x01\n\x13ScanRunWarningTrace\x12N\n\x04\x63ode\x18\x01 \x01(\x0e\x32@.google.cloud.websecurityscanner.v1beta.ScanRunWarningTrace.Code"\x85\x01\n\x04\x43ode\x12\x14\n\x10\x43ODE_UNSPECIFIED\x10\x00\x12\x1e\n\x1aINSUFFICIENT_CRAWL_RESULTS\x10\x01\x12\x1a\n\x16TOO_MANY_CRAWL_RESULTS\x10\x02\x12\x17\n\x13TOO_MANY_FUZZ_TASKS\x10\x03\x12\x12\n\x0e\x42LOCKED_BY_IAP\x10\x04\x42\xcb\x01\n*com.google.cloud.websecurityscanner.v1betaB\x18ScanRunWarningTraceProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+)
+
+
+_SCANRUNWARNINGTRACE_CODE = _descriptor.EnumDescriptor(
+    name="Code",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRunWarningTrace.Code",
+    filename=None,
+    file=DESCRIPTOR,
+    values=[
+        _descriptor.EnumValueDescriptor(
+            name="CODE_UNSPECIFIED",
+            index=0,
+            number=0,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="INSUFFICIENT_CRAWL_RESULTS",
+            index=1,
+            number=1,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOO_MANY_CRAWL_RESULTS",
+            index=2,
+            number=2,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="TOO_MANY_FUZZ_TASKS",
+            index=3,
+            number=3,
+            serialized_options=None,
+            type=None,
+        ),
+        _descriptor.EnumValueDescriptor(
+            name="BLOCKED_BY_IAP", index=4, number=4, serialized_options=None, type=None
+        ),
+    ],
+    containing_type=None,
+    serialized_options=None,
+    serialized_start=222,
+    serialized_end=355,
+)
+_sym_db.RegisterEnumDescriptor(_SCANRUNWARNINGTRACE_CODE)
+
+
+_SCANRUNWARNINGTRACE = _descriptor.Descriptor(
+    name="ScanRunWarningTrace",
+    full_name="google.cloud.websecurityscanner.v1beta.ScanRunWarningTrace",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="code",
+            full_name="google.cloud.websecurityscanner.v1beta.ScanRunWarningTrace.code",
+            index=0,
+            number=1,
+            type=14,
+            cpp_type=8,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[_SCANRUNWARNINGTRACE_CODE],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=118,
+    serialized_end=355,
+)
+
+_SCANRUNWARNINGTRACE.fields_by_name["code"].enum_type = _SCANRUNWARNINGTRACE_CODE
+_SCANRUNWARNINGTRACE_CODE.containing_type = _SCANRUNWARNINGTRACE
+DESCRIPTOR.message_types_by_name["ScanRunWarningTrace"] = _SCANRUNWARNINGTRACE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+ScanRunWarningTrace = _reflection.GeneratedProtocolMessageType(
+    "ScanRunWarningTrace",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_SCANRUNWARNINGTRACE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.scan_run_warning_trace_pb2",
+        __doc__="""Output only. Defines a warning trace message for ScanRun. Warning traces
+  provide customers with useful information that helps make the scanning
+  process more effective.
+  
+  
+  Attributes:
+      code:
+          Output only. Indicates the warning code.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ScanRunWarningTrace)
+    ),
+)
+_sym_db.RegisterMessage(ScanRunWarningTrace)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace_pb2_grpc.py
new file mode 100644
index 000000000000..07cb78fe03a9
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/scan_run_warning_trace_pb2_grpc.py
@@ -0,0 +1,2 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner.proto b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner.proto
new file mode 100644
index 000000000000..d328a2860214
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner.proto
@@ -0,0 +1,347 @@
+// 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.websecurityscanner.v1beta;
+
+import "google/api/annotations.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";
+import "google/cloud/websecurityscanner/v1beta/scan_config.proto";
+import "google/cloud/websecurityscanner/v1beta/scan_run.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "WebSecurityScannerProto";
+option java_package = "com.google.cloud.websecurityscanner.v1beta";
+option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
+
+// Cloud Web Security Scanner Service identifies security vulnerabilities in web
+// 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 {
+  // Creates a new ScanConfig.
+  rpc CreateScanConfig(CreateScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      post: "/v1beta/{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: "/v1beta/{name=projects/*/scanConfigs/*}"
+    };
+  }
+
+  // Gets a ScanConfig.
+  rpc GetScanConfig(GetScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/scanConfigs/*}"
+    };
+  }
+
+  // Lists ScanConfigs under a given project.
+  rpc ListScanConfigs(ListScanConfigsRequest) returns (ListScanConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*}/scanConfigs"
+    };
+  }
+
+  // Updates a ScanConfig. This method support partial update of a ScanConfig.
+  rpc UpdateScanConfig(UpdateScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      patch: "/v1beta/{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: "/v1beta/{name=projects/*/scanConfigs/*}:start"
+      body: "*"
+    };
+  }
+
+  // Gets a ScanRun.
+  rpc GetScanRun(GetScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      get: "/v1beta/{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: "/v1beta/{parent=projects/*/scanConfigs/*}/scanRuns"
+    };
+  }
+
+  // Stops a ScanRun. The stopped ScanRun is returned.
+  rpc StopScanRun(StopScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      post: "/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}:stop"
+      body: "*"
+    };
+  }
+
+  // List CrawledUrls under a given ScanRun.
+  rpc ListCrawledUrls(ListCrawledUrlsRequest) returns (ListCrawledUrlsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
+    };
+  }
+
+  // Gets a Finding.
+  rpc GetFinding(GetFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
+    };
+  }
+
+  // List Findings under a given ScanRun.
+  rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
+    };
+  }
+
+  // List all FindingTypeStats under a given ScanRun.
+  rpc ListFindingTypeStats(ListFindingTypeStatsRequest) returns (ListFindingTypeStatsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{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: <field>
+  // <operator> <value>.
+  // 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/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner_pb2.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner_pb2.py
new file mode 100644
index 000000000000..d1a34a30f035
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner_pb2.py
@@ -0,0 +1,1662 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/websecurityscanner_v1beta/proto/web_security_scanner.proto
+
+import sys
+
+_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1"))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2
+from google.cloud.websecurityscanner_v1beta.proto import (
+    crawled_url_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_crawled__url__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    finding_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    finding_type_stats_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__type__stats__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_config_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_run_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+    name="google/cloud/websecurityscanner_v1beta/proto/web_security_scanner.proto",
+    package="google.cloud.websecurityscanner.v1beta",
+    syntax="proto3",
+    serialized_options=_b(
+        "\n*com.google.cloud.websecurityscanner.v1betaB\027WebSecurityScannerProtoP\001ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\312\002&Google\\Cloud\\WebSecurityScanner\\V1beta"
+    ),
+    serialized_pb=_b(
+        '\nGgoogle/cloud/websecurityscanner_v1beta/proto/web_security_scanner.proto\x12&google.cloud.websecurityscanner.v1beta\x1a\x1cgoogle/api/annotations.proto\x1a>google/cloud/websecurityscanner_v1beta/proto/crawled_url.proto\x1a:google/cloud/websecurityscanner_v1beta/proto/finding.proto\x1a\x45google/cloud/websecurityscanner_v1beta/proto/finding_type_stats.proto\x1a>google/cloud/websecurityscanner_v1beta/proto/scan_config.proto\x1a;google/cloud/websecurityscanner_v1beta/proto/scan_run.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"r\n\x17\x43reateScanConfigRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12G\n\x0bscan_config\x18\x02 \x01(\x0b\x32\x32.google.cloud.websecurityscanner.v1beta.ScanConfig"\'\n\x17\x44\x65leteScanConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"$\n\x14GetScanConfigRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x16ListScanConfigsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"\x93\x01\n\x17UpdateScanConfigRequest\x12G\n\x0bscan_config\x18\x02 \x01(\x0b\x32\x32.google.cloud.websecurityscanner.v1beta.ScanConfig\x12/\n\x0bupdate_mask\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"|\n\x17ListScanConfigsResponse\x12H\n\x0cscan_configs\x18\x01 \x03(\x0b\x32\x32.google.cloud.websecurityscanner.v1beta.ScanConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"#\n\x13StartScanRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"!\n\x11GetScanRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"L\n\x13ListScanRunsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"s\n\x14ListScanRunsResponse\x12\x42\n\tscan_runs\x18\x01 \x03(\x0b\x32/.google.cloud.websecurityscanner.v1beta.ScanRun\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t""\n\x12StopScanRunRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"O\n\x16ListCrawledUrlsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x12\n\npage_token\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05"|\n\x17ListCrawledUrlsResponse\x12H\n\x0c\x63rawled_urls\x18\x01 \x03(\x0b\x32\x32.google.cloud.websecurityscanner.v1beta.CrawledUrl\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"!\n\x11GetFindingRequest\x12\x0c\n\x04name\x18\x01 \x01(\t"\\\n\x13ListFindingsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x11\n\tpage_size\x18\x04 \x01(\x05"r\n\x14ListFindingsResponse\x12\x41\n\x08\x66indings\x18\x01 \x03(\x0b\x32/.google.cloud.websecurityscanner.v1beta.Finding\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"-\n\x1bListFindingTypeStatsRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t"t\n\x1cListFindingTypeStatsResponse\x12T\n\x12\x66inding_type_stats\x18\x01 \x03(\x0b\x32\x38.google.cloud.websecurityscanner.v1beta.FindingTypeStats2\xaa\x14\n\x12WebSecurityScanner\x12\xc5\x01\n\x10\x43reateScanConfig\x12?.google.cloud.websecurityscanner.v1beta.CreateScanConfigRequest\x1a\x32.google.cloud.websecurityscanner.v1beta.ScanConfig"<\x82\xd3\xe4\x93\x02\x36"\'/v1beta/{parent=projects/*}/scanConfigs:\x0bscan_config\x12\x9c\x01\n\x10\x44\x65leteScanConfig\x12?.google.cloud.websecurityscanner.v1beta.DeleteScanConfigRequest\x1a\x16.google.protobuf.Empty"/\x82\xd3\xe4\x93\x02)*\'/v1beta/{name=projects/*/scanConfigs/*}\x12\xb2\x01\n\rGetScanConfig\x12<.google.cloud.websecurityscanner.v1beta.GetScanConfigRequest\x1a\x32.google.cloud.websecurityscanner.v1beta.ScanConfig"/\x82\xd3\xe4\x93\x02)\x12\'/v1beta/{name=projects/*/scanConfigs/*}\x12\xc3\x01\n\x0fListScanConfigs\x12>.google.cloud.websecurityscanner.v1beta.ListScanConfigsRequest\x1a?.google.cloud.websecurityscanner.v1beta.ListScanConfigsResponse"/\x82\xd3\xe4\x93\x02)\x12\'/v1beta/{parent=projects/*}/scanConfigs\x12\xd1\x01\n\x10UpdateScanConfig\x12?.google.cloud.websecurityscanner.v1beta.UpdateScanConfigRequest\x1a\x32.google.cloud.websecurityscanner.v1beta.ScanConfig"H\x82\xd3\xe4\x93\x02\x42\x32\x33/v1beta/{scan_config.name=projects/*/scanConfigs/*}:\x0bscan_config\x12\xb6\x01\n\x0cStartScanRun\x12;.google.cloud.websecurityscanner.v1beta.StartScanRunRequest\x1a/.google.cloud.websecurityscanner.v1beta.ScanRun"8\x82\xd3\xe4\x93\x02\x32"-/v1beta/{name=projects/*/scanConfigs/*}:start:\x01*\x12\xb4\x01\n\nGetScanRun\x12\x39.google.cloud.websecurityscanner.v1beta.GetScanRunRequest\x1a/.google.cloud.websecurityscanner.v1beta.ScanRun":\x82\xd3\xe4\x93\x02\x34\x12\x32/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}\x12\xc5\x01\n\x0cListScanRuns\x12;.google.cloud.websecurityscanner.v1beta.ListScanRunsRequest\x1a<.google.cloud.websecurityscanner.v1beta.ListScanRunsResponse":\x82\xd3\xe4\x93\x02\x34\x12\x32/v1beta/{parent=projects/*/scanConfigs/*}/scanRuns\x12\xbe\x01\n\x0bStopScanRun\x12:.google.cloud.websecurityscanner.v1beta.StopScanRunRequest\x1a/.google.cloud.websecurityscanner.v1beta.ScanRun"B\x82\xd3\xe4\x93\x02<"7/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}:stop:\x01*\x12\xdc\x01\n\x0fListCrawledUrls\x12>.google.cloud.websecurityscanner.v1beta.ListCrawledUrlsRequest\x1a?.google.cloud.websecurityscanner.v1beta.ListCrawledUrlsResponse"H\x82\xd3\xe4\x93\x02\x42\x12@/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls\x12\xbf\x01\n\nGetFinding\x12\x39.google.cloud.websecurityscanner.v1beta.GetFindingRequest\x1a/.google.cloud.websecurityscanner.v1beta.Finding"E\x82\xd3\xe4\x93\x02?\x12=/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}\x12\xd0\x01\n\x0cListFindings\x12;.google.cloud.websecurityscanner.v1beta.ListFindingsRequest\x1a<.google.cloud.websecurityscanner.v1beta.ListFindingsResponse"E\x82\xd3\xe4\x93\x02?\x12=/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings\x12\xf0\x01\n\x14ListFindingTypeStats\x12\x43.google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsRequest\x1a\x44.google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsResponse"M\x82\xd3\xe4\x93\x02G\x12\x45/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStatsB\xca\x01\n*com.google.cloud.websecurityscanner.v1betaB\x17WebSecurityScannerProtoP\x01ZXgoogle.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner\xca\x02&Google\\Cloud\\WebSecurityScanner\\V1betab\x06proto3'
+    ),
+    dependencies=[
+        google_dot_api_dot_annotations__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_crawled__url__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__type__stats__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.DESCRIPTOR,
+        google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_empty__pb2.DESCRIPTOR,
+        google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,
+    ],
+)
+
+
+_CREATESCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="CreateScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.CreateScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1beta.CreateScanConfigRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="scan_config",
+            full_name="google.cloud.websecurityscanner.v1beta.CreateScanConfigRequest.scan_config",
+            index=1,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=528,
+    serialized_end=642,
+)
+
+
+_DELETESCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="DeleteScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.DeleteScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.DeleteScanConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=644,
+    serialized_end=683,
+)
+
+
+_GETSCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="GetScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.GetScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.GetScanConfigRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=685,
+    serialized_end=721,
+)
+
+
+_LISTSCANCONFIGSREQUEST = _descriptor.Descriptor(
+    name="ListScanConfigsRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=723,
+    serialized_end=802,
+)
+
+
+_UPDATESCANCONFIGREQUEST = _descriptor.Descriptor(
+    name="UpdateScanConfigRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.UpdateScanConfigRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scan_config",
+            full_name="google.cloud.websecurityscanner.v1beta.UpdateScanConfigRequest.scan_config",
+            index=0,
+            number=2,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="update_mask",
+            full_name="google.cloud.websecurityscanner.v1beta.UpdateScanConfigRequest.update_mask",
+            index=1,
+            number=3,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=805,
+    serialized_end=952,
+)
+
+
+_LISTSCANCONFIGSRESPONSE = _descriptor.Descriptor(
+    name="ListScanConfigsResponse",
+    full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scan_configs",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsResponse.scan_configs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanConfigsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=954,
+    serialized_end=1078,
+)
+
+
+_STARTSCANRUNREQUEST = _descriptor.Descriptor(
+    name="StartScanRunRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.StartScanRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.StartScanRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1080,
+    serialized_end=1115,
+)
+
+
+_GETSCANRUNREQUEST = _descriptor.Descriptor(
+    name="GetScanRunRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.GetScanRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.GetScanRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1117,
+    serialized_end=1150,
+)
+
+
+_LISTSCANRUNSREQUEST = _descriptor.Descriptor(
+    name="ListScanRunsRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1152,
+    serialized_end=1228,
+)
+
+
+_LISTSCANRUNSRESPONSE = _descriptor.Descriptor(
+    name="ListScanRunsResponse",
+    full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="scan_runs",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsResponse.scan_runs",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListScanRunsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1230,
+    serialized_end=1345,
+)
+
+
+_STOPSCANRUNREQUEST = _descriptor.Descriptor(
+    name="StopScanRunRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.StopScanRunRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.StopScanRunRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1347,
+    serialized_end=1381,
+)
+
+
+_LISTCRAWLEDURLSREQUEST = _descriptor.Descriptor(
+    name="ListCrawledUrlsRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsRequest.page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsRequest.page_size",
+            index=2,
+            number=3,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1383,
+    serialized_end=1462,
+)
+
+
+_LISTCRAWLEDURLSRESPONSE = _descriptor.Descriptor(
+    name="ListCrawledUrlsResponse",
+    full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="crawled_urls",
+            full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsResponse.crawled_urls",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListCrawledUrlsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1464,
+    serialized_end=1588,
+)
+
+
+_GETFINDINGREQUEST = _descriptor.Descriptor(
+    name="GetFindingRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.GetFindingRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="name",
+            full_name="google.cloud.websecurityscanner.v1beta.GetFindingRequest.name",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1590,
+    serialized_end=1623,
+)
+
+
+_LISTFINDINGSREQUEST = _descriptor.Descriptor(
+    name="ListFindingsRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.ListFindingsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="filter",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingsRequest.filter",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingsRequest.page_token",
+            index=2,
+            number=3,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="page_size",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingsRequest.page_size",
+            index=3,
+            number=4,
+            type=5,
+            cpp_type=1,
+            label=1,
+            has_default_value=False,
+            default_value=0,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1625,
+    serialized_end=1717,
+)
+
+
+_LISTFINDINGSRESPONSE = _descriptor.Descriptor(
+    name="ListFindingsResponse",
+    full_name="google.cloud.websecurityscanner.v1beta.ListFindingsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="findings",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingsResponse.findings",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+        _descriptor.FieldDescriptor(
+            name="next_page_token",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingsResponse.next_page_token",
+            index=1,
+            number=2,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1719,
+    serialized_end=1833,
+)
+
+
+_LISTFINDINGTYPESTATSREQUEST = _descriptor.Descriptor(
+    name="ListFindingTypeStatsRequest",
+    full_name="google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsRequest",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="parent",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsRequest.parent",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1835,
+    serialized_end=1880,
+)
+
+
+_LISTFINDINGTYPESTATSRESPONSE = _descriptor.Descriptor(
+    name="ListFindingTypeStatsResponse",
+    full_name="google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsResponse",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="finding_type_stats",
+            full_name="google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsResponse.finding_type_stats",
+            index=0,
+            number=1,
+            type=11,
+            cpp_type=10,
+            label=3,
+            has_default_value=False,
+            default_value=[],
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=1882,
+    serialized_end=1998,
+)
+
+_CREATESCANCONFIGREQUEST.fields_by_name[
+    "scan_config"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2._SCANCONFIG
+)
+_UPDATESCANCONFIGREQUEST.fields_by_name[
+    "scan_config"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2._SCANCONFIG
+)
+_UPDATESCANCONFIGREQUEST.fields_by_name[
+    "update_mask"
+].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_LISTSCANCONFIGSRESPONSE.fields_by_name[
+    "scan_configs"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2._SCANCONFIG
+)
+_LISTSCANRUNSRESPONSE.fields_by_name[
+    "scan_runs"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2._SCANRUN
+)
+_LISTCRAWLEDURLSRESPONSE.fields_by_name[
+    "crawled_urls"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_crawled__url__pb2._CRAWLEDURL
+)
+_LISTFINDINGSRESPONSE.fields_by_name[
+    "findings"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2._FINDING
+)
+_LISTFINDINGTYPESTATSRESPONSE.fields_by_name[
+    "finding_type_stats"
+].message_type = (
+    google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__type__stats__pb2._FINDINGTYPESTATS
+)
+DESCRIPTOR.message_types_by_name["CreateScanConfigRequest"] = _CREATESCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["DeleteScanConfigRequest"] = _DELETESCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["GetScanConfigRequest"] = _GETSCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["ListScanConfigsRequest"] = _LISTSCANCONFIGSREQUEST
+DESCRIPTOR.message_types_by_name["UpdateScanConfigRequest"] = _UPDATESCANCONFIGREQUEST
+DESCRIPTOR.message_types_by_name["ListScanConfigsResponse"] = _LISTSCANCONFIGSRESPONSE
+DESCRIPTOR.message_types_by_name["StartScanRunRequest"] = _STARTSCANRUNREQUEST
+DESCRIPTOR.message_types_by_name["GetScanRunRequest"] = _GETSCANRUNREQUEST
+DESCRIPTOR.message_types_by_name["ListScanRunsRequest"] = _LISTSCANRUNSREQUEST
+DESCRIPTOR.message_types_by_name["ListScanRunsResponse"] = _LISTSCANRUNSRESPONSE
+DESCRIPTOR.message_types_by_name["StopScanRunRequest"] = _STOPSCANRUNREQUEST
+DESCRIPTOR.message_types_by_name["ListCrawledUrlsRequest"] = _LISTCRAWLEDURLSREQUEST
+DESCRIPTOR.message_types_by_name["ListCrawledUrlsResponse"] = _LISTCRAWLEDURLSRESPONSE
+DESCRIPTOR.message_types_by_name["GetFindingRequest"] = _GETFINDINGREQUEST
+DESCRIPTOR.message_types_by_name["ListFindingsRequest"] = _LISTFINDINGSREQUEST
+DESCRIPTOR.message_types_by_name["ListFindingsResponse"] = _LISTFINDINGSRESPONSE
+DESCRIPTOR.message_types_by_name[
+    "ListFindingTypeStatsRequest"
+] = _LISTFINDINGTYPESTATSREQUEST
+DESCRIPTOR.message_types_by_name[
+    "ListFindingTypeStatsResponse"
+] = _LISTFINDINGTYPESTATSRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+CreateScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "CreateScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_CREATESCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``CreateScanConfig`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name where the scan is created,
+          which should be a project resource name in the format
+          'projects/{projectId}'.
+      scan_config:
+          Required. The ScanConfig to be created.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.CreateScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(CreateScanConfigRequest)
+
+DeleteScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "DeleteScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_DELETESCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``DeleteScanConfig`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanConfig to be deleted.
+          The name follows the format of
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.DeleteScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(DeleteScanConfigRequest)
+
+GetScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "GetScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``GetScanConfig`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanConfig to be returned.
+          The name follows the format of
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.GetScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetScanConfigRequest)
+
+ListScanConfigsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListScanConfigsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANCONFIGSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListScanConfigs`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a project
+          resource name in the format 'projects/{projectId}'.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListScanConfigsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListScanConfigsRequest)
+
+UpdateScanConfigRequest = _reflection.GeneratedProtocolMessageType(
+    "UpdateScanConfigRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_UPDATESCANCONFIGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``UpdateScanConfigRequest`` method.
+  
+  
+  Attributes:
+      scan_config:
+          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.
+      update_mask:
+          Required. The update mask applies to the resource. For the
+          ``FieldMask`` definition, see
+          https://developers.google.com/protocol-
+          buffers/docs/reference/google.protobuf#fieldmask
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.UpdateScanConfigRequest)
+    ),
+)
+_sym_db.RegisterMessage(UpdateScanConfigRequest)
+
+ListScanConfigsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListScanConfigsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANCONFIGSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListScanConfigs`` method.
+  
+  
+  Attributes:
+      scan_configs:
+          The list of ScanConfigs returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListScanConfigsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListScanConfigsResponse)
+
+StartScanRunRequest = _reflection.GeneratedProtocolMessageType(
+    "StartScanRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STARTSCANRUNREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``StartScanRun`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanConfig to be used. The
+          name follows the format of
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.StartScanRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(StartScanRunRequest)
+
+GetScanRunRequest = _reflection.GeneratedProtocolMessageType(
+    "GetScanRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETSCANRUNREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``GetScanRun`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanRun to be returned. The
+          name follows the format of 'projects/{projectId}/scanConfigs/{
+          scanConfigId}/scanRuns/{scanRunId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.GetScanRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetScanRunRequest)
+
+ListScanRunsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListScanRunsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANRUNSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListScanRuns`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan
+          resource name in the format
+          'projects/{projectId}/scanConfigs/{scanConfigId}'.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListScanRunsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListScanRunsRequest)
+
+ListScanRunsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListScanRunsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTSCANRUNSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListScanRuns`` method.
+  
+  
+  Attributes:
+      scan_runs:
+          The list of ScanRuns returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListScanRunsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListScanRunsResponse)
+
+StopScanRunRequest = _reflection.GeneratedProtocolMessageType(
+    "StopScanRunRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_STOPSCANRUNREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``StopScanRun`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the ScanRun to be stopped. The
+          name follows the format of 'projects/{projectId}/scanConfigs/{
+          scanConfigId}/scanRuns/{scanRunId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.StopScanRunRequest)
+    ),
+)
+_sym_db.RegisterMessage(StopScanRunRequest)
+
+ListCrawledUrlsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListCrawledUrlsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRAWLEDURLSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListCrawledUrls`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan run
+          resource name in the format 'projects/{projectId}/scanConfigs/
+          {scanConfigId}/scanRuns/{scanRunId}'.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListCrawledUrlsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListCrawledUrlsRequest)
+
+ListCrawledUrlsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListCrawledUrlsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTCRAWLEDURLSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListCrawledUrls`` method.
+  
+  
+  Attributes:
+      crawled_urls:
+          The list of CrawledUrls returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListCrawledUrlsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListCrawledUrlsResponse)
+
+GetFindingRequest = _reflection.GeneratedProtocolMessageType(
+    "GetFindingRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_GETFINDINGREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``GetFinding`` method.
+  
+  
+  Attributes:
+      name:
+          Required. The resource name of the Finding to be returned. The
+          name follows the format of 'projects/{projectId}/scanConfigs/{
+          scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.GetFindingRequest)
+    ),
+)
+_sym_db.RegisterMessage(GetFindingRequest)
+
+ListFindingsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListFindings`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan run
+          resource name in the format 'projects/{projectId}/scanConfigs/
+          {scanConfigId}/scanRuns/{scanRunId}'.
+      filter:
+          The filter expression. The expression must be in the format: .
+          Supported field: 'finding\_type'. Supported operator: '='.
+      page_token:
+          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.
+      page_size:
+          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.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListFindingsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsRequest)
+
+ListFindingsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFindingsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListFindings`` method.
+  
+  
+  Attributes:
+      findings:
+          The list of Findings returned.
+      next_page_token:
+          Token to retrieve the next page of results, or empty if there
+          are no more results in the list.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListFindingsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingsResponse)
+
+ListFindingTypeStatsRequest = _reflection.GeneratedProtocolMessageType(
+    "ListFindingTypeStatsRequest",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGTYPESTATSREQUEST,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Request for the ``ListFindingTypeStats`` method.
+  
+  
+  Attributes:
+      parent:
+          Required. The parent resource name, which should be a scan run
+          resource name in the format 'projects/{projectId}/scanConfigs/
+          {scanConfigId}/scanRuns/{scanRunId}'.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsRequest)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingTypeStatsRequest)
+
+ListFindingTypeStatsResponse = _reflection.GeneratedProtocolMessageType(
+    "ListFindingTypeStatsResponse",
+    (_message.Message,),
+    dict(
+        DESCRIPTOR=_LISTFINDINGTYPESTATSRESPONSE,
+        __module__="google.cloud.websecurityscanner_v1beta.proto.web_security_scanner_pb2",
+        __doc__="""Response for the ``ListFindingTypeStats`` method.
+  
+  
+  Attributes:
+      finding_type_stats:
+          The list of FindingTypeStats returned.
+  """,
+        # @@protoc_insertion_point(class_scope:google.cloud.websecurityscanner.v1beta.ListFindingTypeStatsResponse)
+    ),
+)
+_sym_db.RegisterMessage(ListFindingTypeStatsResponse)
+
+
+DESCRIPTOR._options = None
+
+_WEBSECURITYSCANNER = _descriptor.ServiceDescriptor(
+    name="WebSecurityScanner",
+    full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+    file=DESCRIPTOR,
+    index=0,
+    serialized_options=None,
+    serialized_start=2001,
+    serialized_end=4603,
+    methods=[
+        _descriptor.MethodDescriptor(
+            name="CreateScanConfig",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.CreateScanConfig",
+            index=0,
+            containing_service=None,
+            input_type=_CREATESCANCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2._SCANCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\0026\"'/v1beta/{parent=projects/*}/scanConfigs:\013scan_config"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="DeleteScanConfig",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.DeleteScanConfig",
+            index=1,
+            containing_service=None,
+            input_type=_DELETESCANCONFIGREQUEST,
+            output_type=google_dot_protobuf_dot_empty__pb2._EMPTY,
+            serialized_options=_b(
+                "\202\323\344\223\002)*'/v1beta/{name=projects/*/scanConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetScanConfig",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.GetScanConfig",
+            index=2,
+            containing_service=None,
+            input_type=_GETSCANCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2._SCANCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002)\022'/v1beta/{name=projects/*/scanConfigs/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListScanConfigs",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.ListScanConfigs",
+            index=3,
+            containing_service=None,
+            input_type=_LISTSCANCONFIGSREQUEST,
+            output_type=_LISTSCANCONFIGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002)\022'/v1beta/{parent=projects/*}/scanConfigs"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="UpdateScanConfig",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.UpdateScanConfig",
+            index=4,
+            containing_service=None,
+            input_type=_UPDATESCANCONFIGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2._SCANCONFIG,
+            serialized_options=_b(
+                "\202\323\344\223\002B23/v1beta/{scan_config.name=projects/*/scanConfigs/*}:\013scan_config"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StartScanRun",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.StartScanRun",
+            index=5,
+            containing_service=None,
+            input_type=_STARTSCANRUNREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2._SCANRUN,
+            serialized_options=_b(
+                '\202\323\344\223\0022"-/v1beta/{name=projects/*/scanConfigs/*}:start:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetScanRun",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.GetScanRun",
+            index=6,
+            containing_service=None,
+            input_type=_GETSCANRUNREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2._SCANRUN,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListScanRuns",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.ListScanRuns",
+            index=7,
+            containing_service=None,
+            input_type=_LISTSCANRUNSREQUEST,
+            output_type=_LISTSCANRUNSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\0024\0222/v1beta/{parent=projects/*/scanConfigs/*}/scanRuns"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="StopScanRun",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.StopScanRun",
+            index=8,
+            containing_service=None,
+            input_type=_STOPSCANRUNREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2._SCANRUN,
+            serialized_options=_b(
+                '\202\323\344\223\002<"7/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}:stop:\001*'
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListCrawledUrls",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.ListCrawledUrls",
+            index=9,
+            containing_service=None,
+            input_type=_LISTCRAWLEDURLSREQUEST,
+            output_type=_LISTCRAWLEDURLSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002B\022@/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="GetFinding",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.GetFinding",
+            index=10,
+            containing_service=None,
+            input_type=_GETFINDINGREQUEST,
+            output_type=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2._FINDING,
+            serialized_options=_b(
+                "\202\323\344\223\002?\022=/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFindings",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.ListFindings",
+            index=11,
+            containing_service=None,
+            input_type=_LISTFINDINGSREQUEST,
+            output_type=_LISTFINDINGSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002?\022=/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
+            ),
+        ),
+        _descriptor.MethodDescriptor(
+            name="ListFindingTypeStats",
+            full_name="google.cloud.websecurityscanner.v1beta.WebSecurityScanner.ListFindingTypeStats",
+            index=12,
+            containing_service=None,
+            input_type=_LISTFINDINGTYPESTATSREQUEST,
+            output_type=_LISTFINDINGTYPESTATSRESPONSE,
+            serialized_options=_b(
+                "\202\323\344\223\002G\022E/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStats"
+            ),
+        ),
+    ],
+)
+_sym_db.RegisterServiceDescriptor(_WEBSECURITYSCANNER)
+
+DESCRIPTOR.services_by_name["WebSecurityScanner"] = _WEBSECURITYSCANNER
+
+# @@protoc_insertion_point(module_scope)
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner_pb2_grpc.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner_pb2_grpc.py
new file mode 100644
index 000000000000..172dfb8bd526
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/proto/web_security_scanner_pb2_grpc.py
@@ -0,0 +1,268 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+import grpc
+
+from google.cloud.websecurityscanner_v1beta.proto import (
+    finding_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_config_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    scan_run_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2,
+)
+from google.cloud.websecurityscanner_v1beta.proto import (
+    web_security_scanner_pb2 as google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2,
+)
+from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
+
+
+class WebSecurityScannerStub(object):
+    """Cloud Web Security Scanner Service identifies security vulnerabilities in web
+  applications hosted on Google Cloud Platform. It crawls your application, and
+  attempts to exercise as many user inputs and event handlers as possible.
+  """
+
+    def __init__(self, channel):
+        """Constructor.
+
+    Args:
+      channel: A grpc.Channel.
+    """
+        self.CreateScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/CreateScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.CreateScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.ScanConfig.FromString,
+        )
+        self.DeleteScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/DeleteScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.DeleteScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
+        )
+        self.GetScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/GetScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.GetScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.ScanConfig.FromString,
+        )
+        self.ListScanConfigs = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/ListScanConfigs",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsResponse.FromString,
+        )
+        self.UpdateScanConfig = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/UpdateScanConfig",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.UpdateScanConfigRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.ScanConfig.FromString,
+        )
+        self.StartScanRun = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/StartScanRun",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.StartScanRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.ScanRun.FromString,
+        )
+        self.GetScanRun = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/GetScanRun",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.GetScanRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.ScanRun.FromString,
+        )
+        self.ListScanRuns = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/ListScanRuns",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanRunsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanRunsResponse.FromString,
+        )
+        self.StopScanRun = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/StopScanRun",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.StopScanRunRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.ScanRun.FromString,
+        )
+        self.ListCrawledUrls = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/ListCrawledUrls",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsResponse.FromString,
+        )
+        self.GetFinding = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/GetFinding",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.GetFindingRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2.Finding.FromString,
+        )
+        self.ListFindings = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/ListFindings",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingsResponse.FromString,
+        )
+        self.ListFindingTypeStats = channel.unary_unary(
+            "/google.cloud.websecurityscanner.v1beta.WebSecurityScanner/ListFindingTypeStats",
+            request_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsResponse.FromString,
+        )
+
+
+class WebSecurityScannerServicer(object):
+    """Cloud Web Security Scanner Service identifies security vulnerabilities in web
+  applications hosted on Google Cloud Platform. It crawls your application, and
+  attempts to exercise as many user inputs and event handlers as possible.
+  """
+
+    def CreateScanConfig(self, request, context):
+        """Creates a new ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def DeleteScanConfig(self, request, context):
+        """Deletes an existing ScanConfig and its child resources.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetScanConfig(self, request, context):
+        """Gets a ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListScanConfigs(self, request, context):
+        """Lists ScanConfigs under a given project.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def UpdateScanConfig(self, request, context):
+        """Updates a ScanConfig. This method support partial update of a ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StartScanRun(self, request, context):
+        """Start a ScanRun according to the given ScanConfig.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetScanRun(self, request, context):
+        """Gets a ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListScanRuns(self, request, context):
+        """Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+    stop time.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def StopScanRun(self, request, context):
+        """Stops a ScanRun. The stopped ScanRun is returned.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListCrawledUrls(self, request, context):
+        """List CrawledUrls under a given ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def GetFinding(self, request, context):
+        """Gets a Finding.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFindings(self, request, context):
+        """List Findings under a given ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+    def ListFindingTypeStats(self, request, context):
+        """List all FindingTypeStats under a given ScanRun.
+    """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details("Method not implemented!")
+        raise NotImplementedError("Method not implemented!")
+
+
+def add_WebSecurityScannerServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+        "CreateScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.CreateScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.CreateScanConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.ScanConfig.SerializeToString,
+        ),
+        "DeleteScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.DeleteScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.DeleteScanConfigRequest.FromString,
+            response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
+        ),
+        "GetScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.GetScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.GetScanConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.ScanConfig.SerializeToString,
+        ),
+        "ListScanConfigs": grpc.unary_unary_rpc_method_handler(
+            servicer.ListScanConfigs,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanConfigsResponse.SerializeToString,
+        ),
+        "UpdateScanConfig": grpc.unary_unary_rpc_method_handler(
+            servicer.UpdateScanConfig,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.UpdateScanConfigRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__config__pb2.ScanConfig.SerializeToString,
+        ),
+        "StartScanRun": grpc.unary_unary_rpc_method_handler(
+            servicer.StartScanRun,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.StartScanRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.ScanRun.SerializeToString,
+        ),
+        "GetScanRun": grpc.unary_unary_rpc_method_handler(
+            servicer.GetScanRun,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.GetScanRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.ScanRun.SerializeToString,
+        ),
+        "ListScanRuns": grpc.unary_unary_rpc_method_handler(
+            servicer.ListScanRuns,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanRunsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListScanRunsResponse.SerializeToString,
+        ),
+        "StopScanRun": grpc.unary_unary_rpc_method_handler(
+            servicer.StopScanRun,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.StopScanRunRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_scan__run__pb2.ScanRun.SerializeToString,
+        ),
+        "ListCrawledUrls": grpc.unary_unary_rpc_method_handler(
+            servicer.ListCrawledUrls,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListCrawledUrlsResponse.SerializeToString,
+        ),
+        "GetFinding": grpc.unary_unary_rpc_method_handler(
+            servicer.GetFinding,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.GetFindingRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_finding__pb2.Finding.SerializeToString,
+        ),
+        "ListFindings": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFindings,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingsResponse.SerializeToString,
+        ),
+        "ListFindingTypeStats": grpc.unary_unary_rpc_method_handler(
+            servicer.ListFindingTypeStats,
+            request_deserializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsRequest.FromString,
+            response_serializer=google_dot_cloud_dot_websecurityscanner__v1beta_dot_proto_dot_web__security__scanner__pb2.ListFindingTypeStatsResponse.SerializeToString,
+        ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+        "google.cloud.websecurityscanner.v1beta.WebSecurityScanner", rpc_method_handlers
+    )
+    server.add_generic_rpc_handlers((generic_handler,))
diff --git a/websecurityscanner/google/cloud/websecurityscanner_v1beta/types.py b/websecurityscanner/google/cloud/websecurityscanner_v1beta/types.py
new file mode 100644
index 000000000000..b265e69bdda7
--- /dev/null
+++ b/websecurityscanner/google/cloud/websecurityscanner_v1beta/types.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from __future__ import absolute_import
+import sys
+
+from google.api_core.protobuf_helpers import get_messages
+
+from google.cloud.websecurityscanner_v1beta.proto import crawled_url_pb2
+from google.cloud.websecurityscanner_v1beta.proto import finding_addon_pb2
+from google.cloud.websecurityscanner_v1beta.proto import finding_pb2
+from google.cloud.websecurityscanner_v1beta.proto import finding_type_stats_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_config_error_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_config_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_run_error_trace_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_run_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_run_warning_trace_pb2
+from google.cloud.websecurityscanner_v1beta.proto import web_security_scanner_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+from google.protobuf import timestamp_pb2
+
+
+_shared_modules = [empty_pb2, field_mask_pb2, timestamp_pb2]
+
+_local_modules = [
+    crawled_url_pb2,
+    finding_addon_pb2,
+    finding_pb2,
+    finding_type_stats_pb2,
+    scan_config_error_pb2,
+    scan_config_pb2,
+    scan_run_error_trace_pb2,
+    scan_run_pb2,
+    scan_run_warning_trace_pb2,
+    web_security_scanner_pb2,
+]
+
+names = []
+
+for module in _shared_modules:  # pragma: NO COVER
+    for name, message in get_messages(module).items():
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+for module in _local_modules:
+    for name, message in get_messages(module).items():
+        message.__module__ = "google.cloud.websecurityscanner_v1beta.types"
+        setattr(sys.modules[__name__], name, message)
+        names.append(name)
+
+
+__all__ = tuple(sorted(names))
diff --git a/websecurityscanner/noxfile.py b/websecurityscanner/noxfile.py
new file mode 100644
index 000000000000..a2eefbb6765f
--- /dev/null
+++ b/websecurityscanner/noxfile.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Generated by synthtool. DO NOT EDIT!
+
+from __future__ import absolute_import
+import os
+import shutil
+
+import nox
+
+
+LOCAL_DEPS = (os.path.join("..", "api_core"), os.path.join("..", "core"))
+BLACK_VERSION = "black==19.3b0"
+BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"]
+
+if os.path.exists("samples"):
+    BLACK_PATHS.append("samples")
+
+
+@nox.session(python="3.7")
+def lint(session):
+    """Run linters.
+
+    Returns a failure if the linters find linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.install("flake8", BLACK_VERSION, *LOCAL_DEPS)
+    session.run("black", "--check", *BLACK_PATHS)
+    session.run("flake8", "google", "tests")
+
+
+@nox.session(python="3.6")
+def blacken(session):
+    """Run black.
+
+    Format code to uniform standard.
+
+    This currently uses Python 3.6 due to the automated Kokoro run of synthtool.
+    That run uses an image that doesn't have 3.6 installed. Before updating this
+    check the state of the `gcp_ubuntu_config` we use for that Kokoro run.
+    """
+    session.install(BLACK_VERSION)
+    session.run("black", *BLACK_PATHS)
+
+
+@nox.session(python="3.7")
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.install("docutils", "pygments")
+    session.run("python", "setup.py", "check", "--restructuredtext", "--strict")
+
+
+def default(session):
+    # Install all test dependencies, then install this package in-place.
+    session.install("mock", "pytest", "pytest-cov")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", ".")
+
+    # Run py.test against the unit tests.
+    session.run(
+        "py.test",
+        "--quiet",
+        "--cov=google.cloud",
+        "--cov=tests.unit",
+        "--cov-append",
+        "--cov-config=.coveragerc",
+        "--cov-report=",
+        "--cov-fail-under=0",
+        os.path.join("tests", "unit"),
+        *session.posargs,
+    )
+
+
+@nox.session(python=["2.7", "3.5", "3.6", "3.7"])
+def unit(session):
+    """Run the unit test suite."""
+    default(session)
+
+
+@nox.session(python=["2.7", "3.7"])
+def system(session):
+    """Run the system test suite."""
+    system_test_path = os.path.join("tests", "system.py")
+    system_test_folder_path = os.path.join("tests", "system")
+    # Sanity check: Only run tests if the environment variable is set.
+    if not os.environ.get("GOOGLE_APPLICATION_CREDENTIALS", ""):
+        session.skip("Credentials must be set via environment variable")
+
+    system_test_exists = os.path.exists(system_test_path)
+    system_test_folder_exists = os.path.exists(system_test_folder_path)
+    # Sanity check: only run tests if found.
+    if not system_test_exists and not system_test_folder_exists:
+        session.skip("System tests were not found")
+
+    # Use pre-release gRPC for system tests.
+    session.install("--pre", "grpcio")
+
+    # Install all test dependencies, then install this package into the
+    # virtualenv's dist-packages.
+    session.install("mock", "pytest")
+    for local_dep in LOCAL_DEPS:
+        session.install("-e", local_dep)
+    session.install("-e", "../test_utils/")
+    session.install("-e", ".")
+
+    # Run py.test against the system tests.
+    if system_test_exists:
+        session.run("py.test", "--quiet", system_test_path, *session.posargs)
+    if system_test_folder_exists:
+        session.run("py.test", "--quiet", system_test_folder_path, *session.posargs)
+
+
+@nox.session(python="3.7")
+def cover(session):
+    """Run the final coverage report.
+
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.install("coverage", "pytest-cov")
+    session.run("coverage", "report", "--show-missing", "--fail-under=100")
+
+    session.run("coverage", "erase")
+
+
+@nox.session(python="3.7")
+def docs(session):
+    """Build the docs for this library."""
+
+    session.install("-e", ".")
+    session.install("sphinx", "alabaster", "recommonmark")
+
+    shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
+    session.run(
+        "sphinx-build",
+        "-W",  # warnings as errors
+        "-T",  # show full traceback on exception
+        "-N",  # no colors
+        "-b",
+        "html",
+        "-d",
+        os.path.join("docs", "_build", "doctrees", ""),
+        os.path.join("docs", ""),
+        os.path.join("docs", "_build", "html", ""),
+    )
diff --git a/websecurityscanner/setup.cfg b/websecurityscanner/setup.cfg
new file mode 100644
index 000000000000..3bd555500e37
--- /dev/null
+++ b/websecurityscanner/setup.cfg
@@ -0,0 +1,3 @@
+# Generated by synthtool. DO NOT EDIT!
+[bdist_wheel]
+universal = 1
diff --git a/websecurityscanner/setup.py b/websecurityscanner/setup.py
new file mode 100644
index 000000000000..c218c522f91c
--- /dev/null
+++ b/websecurityscanner/setup.py
@@ -0,0 +1,87 @@
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+import setuptools
+
+
+# Package metadata.
+
+name = "google-cloud-websecurityscanner"
+description = ("Google Cloud Web Security Scanner API client library",)
+version = "0.3.0"
+# Should be one of:
+# 'Development Status :: 3 - Alpha'
+# 'Development Status :: 4 - Beta'
+# 'Development Status :: 5 - Production/Stable'
+release_status = "Development Status :: 3 - Alpha"
+dependencies = ["google-api-core[grpc] >= 1.14.0, < 2.0.0dev"]
+
+extras = {}
+
+
+# Setup boilerplate below this line.
+
+package_root = os.path.abspath(os.path.dirname(__file__))
+
+readme_filename = os.path.join(package_root, "README.rst")
+with io.open(readme_filename, encoding="utf-8") as readme_file:
+    readme = readme_file.read()
+
+# Only include packages under the 'google' namespace. Do not include tests,
+# benchmarks, etc.
+packages = [
+    package for package in setuptools.find_packages() if package.startswith("google")
+]
+
+# Determine which namespaces are needed.
+namespaces = ["google"]
+if "google.cloud" in packages:
+    namespaces.append("google.cloud")
+
+
+setuptools.setup(
+    name=name,
+    version=version,
+    description=description,
+    long_description=readme,
+    author="Google LLC",
+    author_email="googleapis-packages@google.com",
+    license="Apache 2.0",
+    url="https://github.com/GoogleCloudPlatform/google-cloud-python",
+    classifiers=[
+        release_status,
+        "Intended Audience :: Developers",
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: Apache Software License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+    ],
+    platforms="Posix; MacOS X; Windows",
+    packages=packages,
+    namespace_packages=namespaces,
+    install_requires=dependencies,
+    extras_require=extras,
+    python_requires=">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*",
+    include_package_data=True,
+    zip_safe=False,
+)
diff --git a/websecurityscanner/synth.metadata b/websecurityscanner/synth.metadata
new file mode 100644
index 000000000000..b39c7e874de8
--- /dev/null
+++ b/websecurityscanner/synth.metadata
@@ -0,0 +1,49 @@
+{
+  "updateTime": "2019-08-06T12:52:30.431818Z",
+  "sources": [
+    {
+      "generator": {
+        "name": "artman",
+        "version": "0.32.1",
+        "dockerImage": "googleapis/artman@sha256:a684d40ba9a4e15946f5f2ca6b4bd9fe301192f522e9de4fff622118775f309b"
+      }
+    },
+    {
+      "git": {
+        "name": "googleapis",
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "e699b0cba64ffddfae39633417180f1f65875896",
+        "internalRef": "261759677"
+      }
+    },
+    {
+      "template": {
+        "name": "python_library",
+        "origin": "synthtool.gcp",
+        "version": "2019.5.2"
+      }
+    }
+  ],
+  "destinations": [
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "websecurityscanner",
+        "apiVersion": "v1alpha",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/websecurityscanner/artman_websecurityscanner_v1alpha.yaml"
+      }
+    },
+    {
+      "client": {
+        "source": "googleapis",
+        "apiName": "websecurityscanner",
+        "apiVersion": "v1beta",
+        "language": "python",
+        "generator": "gapic",
+        "config": "google/cloud/websecurityscanner/artman_websecurityscanner_v1beta.yaml"
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/websecurityscanner/synth.py b/websecurityscanner/synth.py
new file mode 100644
index 000000000000..32cd47f86efc
--- /dev/null
+++ b/websecurityscanner/synth.py
@@ -0,0 +1,52 @@
+# 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.
+
+"""This script is used to synthesize generated parts of this library."""
+import synthtool as s
+from synthtool import gcp
+
+gapic = gcp.GAPICGenerator()
+common = gcp.CommonTemplates()
+
+
+# ----------------------------------------------------------------------------
+# Generate websecurityscanner GAPIC layer
+# ----------------------------------------------------------------------------
+versions = ["v1alpha", "v1beta"]
+
+for version in versions:
+	library = gapic.py_library(
+	    "websecurityscanner",
+	    version,
+	    config_path=f"/google/cloud/websecurityscanner"
+	    f"/artman_websecurityscanner_{version}.yaml",
+	    artman_output_name=f"websecurityscanner-{version}",
+	    include_protos=True,
+	)
+
+	s.move(library / f"google/cloud/websecurityscanner_{version}/proto")
+	s.move(library / f"google/cloud/websecurityscanner_{version}/gapic")
+	s.move(library / f"google/cloud/websecurityscanner_{version}/*.py")
+	s.move(library / f"docs/gapic/{version}")
+	s.move(library / f"tests/unit/gapic/{version}")
+
+s.move(library / "google/cloud/websecurityscanner.py")
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(unit_cov_level=97, cov_level=100)
+s.move(templated_files)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)
diff --git a/websecurityscanner/tests/unit/gapic/v1alpha/test_web_security_scanner_client_v1alpha.py b/websecurityscanner/tests/unit/gapic/v1alpha/test_web_security_scanner_client_v1alpha.py
new file mode 100644
index 000000000000..4c966f886b5c
--- /dev/null
+++ b/websecurityscanner/tests/unit/gapic/v1alpha/test_web_security_scanner_client_v1alpha.py
@@ -0,0 +1,677 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import websecurityscanner_v1alpha
+from google.cloud.websecurityscanner_v1alpha.proto import crawled_url_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import finding_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import scan_config_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import scan_run_pb2
+from google.cloud.websecurityscanner_v1alpha.proto import web_security_scanner_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestWebSecurityScannerClient(object):
+    def test_create_scan_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        max_qps = 844445913
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "max_qps": max_qps,
+        }
+        expected_response = scan_config_pb2.ScanConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        scan_config = {}
+
+        response = client.create_scan_config(parent, scan_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.CreateScanConfigRequest(
+            parent=parent, scan_config=scan_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        scan_config = {}
+
+        with pytest.raises(CustomException):
+            client.create_scan_config(parent, scan_config)
+
+    def test_delete_scan_config(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        client.delete_scan_config(name)
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.DeleteScanConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.delete_scan_config(name)
+
+    def test_get_scan_config(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        max_qps = 844445913
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "max_qps": max_qps,
+        }
+        expected_response = scan_config_pb2.ScanConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        response = client.get_scan_config(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.GetScanConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.get_scan_config(name)
+
+    def test_list_scan_configs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        scan_configs_element = {}
+        scan_configs = [scan_configs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "scan_configs": scan_configs,
+        }
+        expected_response = web_security_scanner_pb2.ListScanConfigsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_scan_configs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.scan_configs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListScanConfigsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_scan_configs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_scan_configs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_scan_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        max_qps = 844445913
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "max_qps": max_qps,
+        }
+        expected_response = scan_config_pb2.ScanConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        scan_config = {}
+        update_mask = {}
+
+        response = client.update_scan_config(scan_config, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.UpdateScanConfigRequest(
+            scan_config=scan_config, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        scan_config = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_scan_config(scan_config, update_mask)
+
+    def test_start_scan_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        urls_crawled_count = 1749797253
+        urls_tested_count = 1498664068
+        has_vulnerabilities = False
+        progress_percent = 2137894861
+        expected_response = {
+            "name": name_2,
+            "urls_crawled_count": urls_crawled_count,
+            "urls_tested_count": urls_tested_count,
+            "has_vulnerabilities": has_vulnerabilities,
+            "progress_percent": progress_percent,
+        }
+        expected_response = scan_run_pb2.ScanRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        response = client.start_scan_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.StartScanRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_start_scan_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.start_scan_run(name)
+
+    def test_get_scan_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        urls_crawled_count = 1749797253
+        urls_tested_count = 1498664068
+        has_vulnerabilities = False
+        progress_percent = 2137894861
+        expected_response = {
+            "name": name_2,
+            "urls_crawled_count": urls_crawled_count,
+            "urls_tested_count": urls_tested_count,
+            "has_vulnerabilities": has_vulnerabilities,
+            "progress_percent": progress_percent,
+        }
+        expected_response = scan_run_pb2.ScanRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        response = client.get_scan_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.GetScanRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_scan_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        with pytest.raises(CustomException):
+            client.get_scan_run(name)
+
+    def test_list_scan_runs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        scan_runs_element = {}
+        scan_runs = [scan_runs_element]
+        expected_response = {"next_page_token": next_page_token, "scan_runs": scan_runs}
+        expected_response = web_security_scanner_pb2.ListScanRunsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        paged_list_response = client.list_scan_runs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.scan_runs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListScanRunsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_scan_runs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        paged_list_response = client.list_scan_runs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_stop_scan_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        urls_crawled_count = 1749797253
+        urls_tested_count = 1498664068
+        has_vulnerabilities = False
+        progress_percent = 2137894861
+        expected_response = {
+            "name": name_2,
+            "urls_crawled_count": urls_crawled_count,
+            "urls_tested_count": urls_tested_count,
+            "has_vulnerabilities": has_vulnerabilities,
+            "progress_percent": progress_percent,
+        }
+        expected_response = scan_run_pb2.ScanRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        response = client.stop_scan_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.StopScanRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_stop_scan_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        with pytest.raises(CustomException):
+            client.stop_scan_run(name)
+
+    def test_list_crawled_urls(self):
+        # Setup Expected Response
+        next_page_token = ""
+        crawled_urls_element = {}
+        crawled_urls = [crawled_urls_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "crawled_urls": crawled_urls,
+        }
+        expected_response = web_security_scanner_pb2.ListCrawledUrlsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        paged_list_response = client.list_crawled_urls(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.crawled_urls[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListCrawledUrlsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_crawled_urls_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        paged_list_response = client.list_crawled_urls(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_finding(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        http_method = "httpMethod820747384"
+        fuzzed_url = "fuzzedUrl-2120677666"
+        body = "body3029410"
+        description = "description-1724546052"
+        reproduction_url = "reproductionUrl-244934180"
+        frame_url = "frameUrl545464221"
+        final_url = "finalUrl355601190"
+        tracking_id = "trackingId1878901667"
+        expected_response = {
+            "name": name_2,
+            "http_method": http_method,
+            "fuzzed_url": fuzzed_url,
+            "body": body,
+            "description": description,
+            "reproduction_url": reproduction_url,
+            "frame_url": frame_url,
+            "final_url": final_url,
+            "tracking_id": tracking_id,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.finding_path(
+            "[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]", "[FINDING]"
+        )
+
+        response = client.get_finding(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.GetFindingRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_finding_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.finding_path(
+            "[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]", "[FINDING]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_finding(name)
+
+    def test_list_findings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        findings_element = {}
+        findings = [findings_element]
+        expected_response = {"next_page_token": next_page_token, "findings": findings}
+        expected_response = web_security_scanner_pb2.ListFindingsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_findings(parent, filter_)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.findings[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListFindingsRequest(
+            parent=parent, filter=filter_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_findings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_findings(parent, filter_)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_finding_type_stats(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = web_security_scanner_pb2.ListFindingTypeStatsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        response = client.list_finding_type_stats(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListFindingTypeStatsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_finding_type_stats_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1alpha.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        with pytest.raises(CustomException):
+            client.list_finding_type_stats(parent)
diff --git a/websecurityscanner/tests/unit/gapic/v1beta/test_web_security_scanner_client_v1beta.py b/websecurityscanner/tests/unit/gapic/v1beta/test_web_security_scanner_client_v1beta.py
new file mode 100644
index 000000000000..cc22988d0844
--- /dev/null
+++ b/websecurityscanner/tests/unit/gapic/v1beta/test_web_security_scanner_client_v1beta.py
@@ -0,0 +1,679 @@
+# -*- coding: utf-8 -*-
+#
+# 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit tests."""
+
+import mock
+import pytest
+
+from google.cloud import websecurityscanner_v1beta
+from google.cloud.websecurityscanner_v1beta.proto import crawled_url_pb2
+from google.cloud.websecurityscanner_v1beta.proto import finding_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_config_pb2
+from google.cloud.websecurityscanner_v1beta.proto import scan_run_pb2
+from google.cloud.websecurityscanner_v1beta.proto import web_security_scanner_pb2
+from google.protobuf import empty_pb2
+from google.protobuf import field_mask_pb2
+
+
+class MultiCallableStub(object):
+    """Stub for the grpc.UnaryUnaryMultiCallable interface."""
+
+    def __init__(self, method, channel_stub):
+        self.method = method
+        self.channel_stub = channel_stub
+
+    def __call__(self, request, timeout=None, metadata=None, credentials=None):
+        self.channel_stub.requests.append((self.method, request))
+
+        response = None
+        if self.channel_stub.responses:
+            response = self.channel_stub.responses.pop()
+
+        if isinstance(response, Exception):
+            raise response
+
+        if response:
+            return response
+
+
+class ChannelStub(object):
+    """Stub for the grpc.Channel interface."""
+
+    def __init__(self, responses=[]):
+        self.responses = responses
+        self.requests = []
+
+    def unary_unary(self, method, request_serializer=None, response_deserializer=None):
+        return MultiCallableStub(method, self)
+
+
+class CustomException(Exception):
+    pass
+
+
+class TestWebSecurityScannerClient(object):
+    def test_create_scan_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        max_qps = 844445913
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "max_qps": max_qps,
+        }
+        expected_response = scan_config_pb2.ScanConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+        scan_config = {}
+
+        response = client.create_scan_config(parent, scan_config)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.CreateScanConfigRequest(
+            parent=parent, scan_config=scan_config
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_create_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+        scan_config = {}
+
+        with pytest.raises(CustomException):
+            client.create_scan_config(parent, scan_config)
+
+    def test_delete_scan_config(self):
+        channel = ChannelStub()
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        client.delete_scan_config(name)
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.DeleteScanConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_delete_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.delete_scan_config(name)
+
+    def test_get_scan_config(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        display_name = "displayName1615086568"
+        max_qps = 844445913
+        expected_response = {
+            "name": name_2,
+            "display_name": display_name,
+            "max_qps": max_qps,
+        }
+        expected_response = scan_config_pb2.ScanConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        response = client.get_scan_config(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.GetScanConfigRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.get_scan_config(name)
+
+    def test_list_scan_configs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        scan_configs_element = {}
+        scan_configs = [scan_configs_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "scan_configs": scan_configs,
+        }
+        expected_response = web_security_scanner_pb2.ListScanConfigsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_scan_configs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.scan_configs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListScanConfigsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_scan_configs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.project_path("[PROJECT]")
+
+        paged_list_response = client.list_scan_configs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_update_scan_config(self):
+        # Setup Expected Response
+        name = "name3373707"
+        display_name = "displayName1615086568"
+        max_qps = 844445913
+        expected_response = {
+            "name": name,
+            "display_name": display_name,
+            "max_qps": max_qps,
+        }
+        expected_response = scan_config_pb2.ScanConfig(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        scan_config = {}
+        update_mask = {}
+
+        response = client.update_scan_config(scan_config, update_mask)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.UpdateScanConfigRequest(
+            scan_config=scan_config, update_mask=update_mask
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_update_scan_config_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        scan_config = {}
+        update_mask = {}
+
+        with pytest.raises(CustomException):
+            client.update_scan_config(scan_config, update_mask)
+
+    def test_start_scan_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        urls_crawled_count = 1749797253
+        urls_tested_count = 1498664068
+        has_vulnerabilities = False
+        progress_percent = 2137894861
+        expected_response = {
+            "name": name_2,
+            "urls_crawled_count": urls_crawled_count,
+            "urls_tested_count": urls_tested_count,
+            "has_vulnerabilities": has_vulnerabilities,
+            "progress_percent": progress_percent,
+        }
+        expected_response = scan_run_pb2.ScanRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        response = client.start_scan_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.StartScanRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_start_scan_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        with pytest.raises(CustomException):
+            client.start_scan_run(name)
+
+    def test_get_scan_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        urls_crawled_count = 1749797253
+        urls_tested_count = 1498664068
+        has_vulnerabilities = False
+        progress_percent = 2137894861
+        expected_response = {
+            "name": name_2,
+            "urls_crawled_count": urls_crawled_count,
+            "urls_tested_count": urls_tested_count,
+            "has_vulnerabilities": has_vulnerabilities,
+            "progress_percent": progress_percent,
+        }
+        expected_response = scan_run_pb2.ScanRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        response = client.get_scan_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.GetScanRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_scan_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        with pytest.raises(CustomException):
+            client.get_scan_run(name)
+
+    def test_list_scan_runs(self):
+        # Setup Expected Response
+        next_page_token = ""
+        scan_runs_element = {}
+        scan_runs = [scan_runs_element]
+        expected_response = {"next_page_token": next_page_token, "scan_runs": scan_runs}
+        expected_response = web_security_scanner_pb2.ListScanRunsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        paged_list_response = client.list_scan_runs(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.scan_runs[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListScanRunsRequest(parent=parent)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_scan_runs_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_config_path("[PROJECT]", "[SCAN_CONFIG]")
+
+        paged_list_response = client.list_scan_runs(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_stop_scan_run(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        urls_crawled_count = 1749797253
+        urls_tested_count = 1498664068
+        has_vulnerabilities = False
+        progress_percent = 2137894861
+        expected_response = {
+            "name": name_2,
+            "urls_crawled_count": urls_crawled_count,
+            "urls_tested_count": urls_tested_count,
+            "has_vulnerabilities": has_vulnerabilities,
+            "progress_percent": progress_percent,
+        }
+        expected_response = scan_run_pb2.ScanRun(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        response = client.stop_scan_run(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.StopScanRunRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_stop_scan_run_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        with pytest.raises(CustomException):
+            client.stop_scan_run(name)
+
+    def test_list_crawled_urls(self):
+        # Setup Expected Response
+        next_page_token = ""
+        crawled_urls_element = {}
+        crawled_urls = [crawled_urls_element]
+        expected_response = {
+            "next_page_token": next_page_token,
+            "crawled_urls": crawled_urls,
+        }
+        expected_response = web_security_scanner_pb2.ListCrawledUrlsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        paged_list_response = client.list_crawled_urls(parent)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.crawled_urls[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListCrawledUrlsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_crawled_urls_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        paged_list_response = client.list_crawled_urls(parent)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_get_finding(self):
+        # Setup Expected Response
+        name_2 = "name2-1052831874"
+        finding_type = "findingType274496048"
+        http_method = "httpMethod820747384"
+        fuzzed_url = "fuzzedUrl-2120677666"
+        body = "body3029410"
+        description = "description-1724546052"
+        reproduction_url = "reproductionUrl-244934180"
+        frame_url = "frameUrl545464221"
+        final_url = "finalUrl355601190"
+        tracking_id = "trackingId1878901667"
+        expected_response = {
+            "name": name_2,
+            "finding_type": finding_type,
+            "http_method": http_method,
+            "fuzzed_url": fuzzed_url,
+            "body": body,
+            "description": description,
+            "reproduction_url": reproduction_url,
+            "frame_url": frame_url,
+            "final_url": final_url,
+            "tracking_id": tracking_id,
+        }
+        expected_response = finding_pb2.Finding(**expected_response)
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        name = client.finding_path(
+            "[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]", "[FINDING]"
+        )
+
+        response = client.get_finding(name)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.GetFindingRequest(name=name)
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_get_finding_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        name = client.finding_path(
+            "[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]", "[FINDING]"
+        )
+
+        with pytest.raises(CustomException):
+            client.get_finding(name)
+
+    def test_list_findings(self):
+        # Setup Expected Response
+        next_page_token = ""
+        findings_element = {}
+        findings = [findings_element]
+        expected_response = {"next_page_token": next_page_token, "findings": findings}
+        expected_response = web_security_scanner_pb2.ListFindingsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_findings(parent, filter_)
+        resources = list(paged_list_response)
+        assert len(resources) == 1
+
+        assert expected_response.findings[0] == resources[0]
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListFindingsRequest(
+            parent=parent, filter=filter_
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_findings_exception(self):
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+        filter_ = "filter-1274492040"
+
+        paged_list_response = client.list_findings(parent, filter_)
+        with pytest.raises(CustomException):
+            list(paged_list_response)
+
+    def test_list_finding_type_stats(self):
+        # Setup Expected Response
+        expected_response = {}
+        expected_response = web_security_scanner_pb2.ListFindingTypeStatsResponse(
+            **expected_response
+        )
+
+        # Mock the API response
+        channel = ChannelStub(responses=[expected_response])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup Request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        response = client.list_finding_type_stats(parent)
+        assert expected_response == response
+
+        assert len(channel.requests) == 1
+        expected_request = web_security_scanner_pb2.ListFindingTypeStatsRequest(
+            parent=parent
+        )
+        actual_request = channel.requests[0][1]
+        assert expected_request == actual_request
+
+    def test_list_finding_type_stats_exception(self):
+        # Mock the API response
+        channel = ChannelStub(responses=[CustomException()])
+        patch = mock.patch("google.api_core.grpc_helpers.create_channel")
+        with patch as create_channel:
+            create_channel.return_value = channel
+            client = websecurityscanner_v1beta.WebSecurityScannerClient()
+
+        # Setup request
+        parent = client.scan_run_path("[PROJECT]", "[SCAN_CONFIG]", "[SCAN_RUN]")
+
+        with pytest.raises(CustomException):
+            client.list_finding_type_stats(parent)